Cosminexus V11 BPM/ESB基盤 サービスプラットフォーム システム構築・運用ガイド

手引・操作書

3021-3-J45-80

前書き

対象製品

マニュアル「アプリケーションサーバ & BPM/ESB基盤 概説」の前書きの対象製品の説明を参照してください。

輸出時の注意

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

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

商標類

AIXは，世界の多くの国で登録されたInternational Business Machines Corporationの商標です。

Apache(R)，Apache Kafka(R)，およびKafka(R)は，Apache Software Foundationの米国およびその他の国における登録商標または商標です。

Eclipseは，Eclipse Foundation, Inc.の商標です。

IBMは，世界の多くの国で登録されたInternational Business Machines Corporationの商標です。

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

Microsoft，Excel，Windows，Windows Serverは，マイクロソフト 企業グループの商標です。

Oracle(R)，Java，MySQL及びNetSuiteは，Oracle，その子会社及び関連会社の米国及びその他の国における登録商標です。

UNIXは，The Open Groupの登録商標です。

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

Eclipseは，開発ツールプロバイダのオープンコミュニティであるEclipse Foundation, Inc.により構築された開発ツール統合のためのオープンプラットフォームです。

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

ランゲージパックの使用について

このマニュアルでは，Eclipse Babel Projectが提供するBABEL日本語ランゲージパックを適用したEclipseメニュー表記を使用しています。使用するランゲージパックのバージョンによっては，マニュアル内の表記と異なる場合があります。

発行

2026年 1月 3021-3-J45-80

著作権

All Rights Reserved. Copyright (C) 2020, 2026, Hitachi, Ltd.

変更内容

変更内容(3021-3-J45-80) uCosminexus Service Architect 11-70，uCosminexus Service Platform 11-70

追加・変更内容

変更個所

Service PlatformおよびService Architectから次の適用OSを削除した。

Windows 10 x64

Red Hat Enterprise Linux 8（AMD/Intel 64）

−

JDK 21はサービスプラットフォームで使用できない旨を記載した。

2.1.2(1)

Oracleの対応バージョンからOracle 11g〜18cを削除した。

2.1.6(2)，3.1.2(7)

FTPアダプタのファイル転送の性能向上のため，ログインセッション維持機能を追加した。

これに伴い，次の点を修正した。

性能解析トレースファイルの出力情報を追加した。

メッセージを追加した。

スレッド数の見積もりの計算式を修正した。

7.7.11(2)，付録F.20，付録I.2

FTPアダプタにRENAMEオペレーションを追加し，ファイルのリネームができるようにした。

これに伴い，性能解析トレースファイルの出力情報を追加した。

7.7.11(2)

JP1イベントの通知の有無に，追加メッセージを反映した。

付録F.1，付録F.6，付録F.15，付録F.20，付録F.27

XMLスキーマを利用したJSON-XML変換（拡張モード）ができるようにした。

これに伴い，次の点を修正した。

メッセージを追加した。

ファイルディスクリプタ数の見積もりの計算式を修正した。

付録F.1，付録F.6，付録I.1(1)

繰り返しアクティビティのリスト指定方式で，永続化するビジネスプロセスを指定できるようにした。

これに伴い，メッセージ一覧からKDEC20086を削除した。

付録F.2

スケジュール駆動受付で，イベント開始時刻を指定できるようにした。

これに伴い，メッセージを追加した。

付録F.15

Service Architectのインストール時に，JDKの種類に応じたeclipse.iniの編集が自動で実行されるようにした。

これに伴い，メッセージ一覧の節を追加した。

付録F.27

単なる誤字・脱字などはお断りなく訂正しました。

はじめに

このマニュアルをお読みになる際の前提情報については，マニュアル「アプリケーションサーバ & BPM/ESB基盤 概説」のはじめにの説明を参照してください。

1　SOAに基づいたシステム運用の概要

この章では，サービスプラットフォームでのシステム運用の概要，システム構成，および運用方針の設定方法について説明します。

1.1　SOAに基づいたシステム運用の手順

ここでは，サービスプラットフォームを利用したシステムの開発から実運用までの手順について説明します。

1.1.1　開発から実運用までの流れ

サービスプラットフォームを利用したシステムの開発から実運用までの流れを次の図に示します。

図1‒1　開発から実運用までの流れ

注※

これらの作業を開発環境で一括して実行することもできます。ただし，一括実行は，システム開発時，または単体テストから結合テスト時を対象としています。詳細については，マニュアル「サービスプラットフォーム開発ガイド 基本開発編」の「8.5　HCSCコンポーネントをHCSCサーバに配備して開始する処理の一括実行」を参照してください。

このマニュアルでは，図中の「運用環境」および「実行環境」で実施する作業の手順について説明しています。開発環境で実施する作業，およびテスト環境のために実施するインストールと簡易セットアップについては，マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」を参照してください。

図中の各作業の概要を次に説明します。

(1)　リポジトリのエクスポート

簡易セットアップを行ったあと，運用環境からリポジトリをエクスポートします。

運用環境からエクスポートしたリポジトリに対して，開発環境で作成したHCSCコンポーネント（サービスアダプタ，ビジネスプロセス，およびユーザ定義受付）や，HCSCコンポーネントをどのように配備するかを定義（配備定義）したシステム構成定義の受け渡しを行います。また，運用環境からは，リポジトリを介して実行環境のセットアップ情報（HCSCサーバの構成や，HCSCコンポーネントの配備情報など）を開発環境に渡します。

リポジトリのエクスポート方法の詳細については，「4.2　リポジトリのエクスポート」を参照してください。

(2)　リポジトリのインポート

開発環境でHCSCコンポーネント（サービスアダプタ，ビジネスプロセス，およびユーザ定義受付）の作成，パッケージング，および配備定義をしたリポジトリを，運用環境にインポートします。

リポジトリのインポート方法の詳細については，「4.3　リポジトリのインポート」を参照してください。

(3)　システムの起動（HCSCサーバの起動）

実行環境の起動・停止は，運用環境から実施します。

実行環境のHCSCサーバを起動・停止するには，運用環境の画面またはコマンドを利用します。

HCSCサーバを起動・停止する方法の詳細については，「5.3.4　HCSCサーバを起動する」を参照してください。

なお，HCSCサーバだけでなく，PRFやHTTP Serverなど，関連するシステムも起動します。

関連するシステムを起動・停止する方法の詳細については，「5.　システム運用」を参照してください。

画面およびコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」を参照してください。

(4)　HCSCコンポーネントの配備

運用環境にインポートしたHCSCコンポーネント（サービスアダプタ，ビジネスプロセス，およびユーザ定義受付）をHCSCサーバに配備します。HCSCコンポーネントの配備は運用環境のコマンドを利用します。

HCSCコンポーネントの配備方法の詳細については，「3.1.8　サービスアダプタを配備する」，「3.1.13　ビジネスプロセスを配備する」，および「3.1.14　ユーザ定義受付を配備する」を参照してください。

コマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」を参照してください。

(5)　HCSCコンポーネントの開始

配備したHCSCコンポーネント（サービスアダプタ，ビジネスプロセス，およびユーザ定義受付）を開始します。なお，サービスアダプタを開始する際には，サービスアダプタから実行するサービスも起動している必要があります。

HCSCコンポーネントを開始・停止するには，運用環境の画面またはコマンドを利用します。

HCSCコンポーネントの開始方法の詳細については，「5.3.7　サービスアダプタを開始する」，「5.3.8　ビジネスプロセスを開始する」，および「5.3.9　ユーザ定義受付を開始する」を参照してください。

画面およびコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」を参照してください。

(6)　リクエスト受付の開始

サービスリクエスタから要求を受け付けるリクエスト受付（標準受付）を開始します。

標準受付を開始・停止するには，運用環境の画面またはコマンドを利用します。

標準受付の開始方法の詳細については，「5.3.10　標準受付を開始する」を参照してください。

画面およびコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」を参照してください。

(7)　Service Platformのインストール

実行環境と運用環境を同一のマシンに構築する場合は，Service Platformをインストールします。異なるマシンに構築する場合は，実行環境と運用環境を構築するそれぞれのマシンにService Platformをインストールします。

Service Platformのインストール方法については，「2.1.2　Service Platformのインストール」を参照してください。

(8)　運用環境の構築

実行環境のHCSCサーバを運用管理する運用環境を構築します。ここでは，実行環境をEclipseの画面で操作するための設定や，運用環境の各種設定を行います。

設定の詳細については，「2.1.5　EclipseへのHCSC-Manager Plug-inの組み込み」および「2.4　運用環境に関する設定」を参照してください。

また，実行環境（HCSCサーバ）のセットアップに必要な定義を作成しておきます。

定義の作成方法の詳細については，「2.3　実行環境に関する設定」を参照してください。

(9)　実行環境の構築

HCSCサーバを動かすための実行環境を構築します。まず，実行環境をセットアップする前に，実行環境に必要なソフトウェアの設定をします。

設定の詳細については，「3.1.2　実行環境に必要なソフトウェアを設定する」を参照してください。

(10)　HCSCサーバのセットアップ

実行環境でサービス部品を呼び出すための基盤となるHCSCサーバをセットアップします（セットアップしたHCSCサーバは，必要に応じてアンセットアップできます）。

HCSCサーバのセットアップは，運用環境のコマンドを利用します。

HCSCサーバのセットアップ方法の詳細については，「3.1.3　HCSCサーバをセットアップする」を参照してください。

また，必要に応じて，HCSCサーバが動作するためのランタイム情報を定義します。

ランタイム情報の設定については，「3.1.4　HCSCサーバの定義情報を設定する」を参照してください。

コマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」を参照してください。

(11)　リポジトリのインポート

テスト環境で使用したリポジトリを，運用環境にインポートします。なお，必要に応じて，リポジトリ内のHCSCコンポーネント（サービスアダプタ，ビジネスプロセス，およびユーザ定義受付）の定義を修正してください。

テスト環境と本番環境で，データベースとReliable Messagingの使用有無の設定が異なる一部のケースについては，テスト環境で使用したリポジトリをそのまま運用環境にインポートできません。その場合，本番環境でセットアップしたHCSCサーバのシステム構成定義を取り込むために，本番環境（運用環境）からリポジトリをエクスポートし，開発環境にリポジトリをインポートする必要があります。詳細は，「1.3　テスト環境と本番環境との関係」を参照してください。

リポジトリのインポート方法の詳細については，「4.3　リポジトリのインポート」を参照してください。

なお，開発環境で作成したHCSCコンポーネントについて，接続先，流量制御，および通信タイムアウト値を変更する場合は，このタイミングで行います。

詳細は，「5.3.26　サービス部品の接続先を変更する」，「5.3.27　流量制御値を変更する」，および「5.3.28　サービス部品呼び出しの通信タイムアウト値を変更する」を参照してください。

(12)　システムの起動（HCSCサーバの起動）

実行環境での業務の開始・終了などに伴って，運用環境でHCSCサーバを起動したり停止したりします。

実行環境のHCSCサーバを起動・停止するには，運用環境の画面またはコマンドを利用します。

HCSCサーバを起動する方法の詳細については，「5.3.4　HCSCサーバを起動する」を参照してください。

なお，HCSCサーバだけでなく，PRFやHTTP Serverなど，関連するシステムも起動します。

関連するシステムを起動・停止する方法の詳細については，「5.　システム運用」を参照してください。

画面およびコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」を参照してください。

(13)　HCSCコンポーネントの配備

運用環境にインポートしたHCSCコンポーネント（サービスアダプタ，ビジネスプロセス，およびユーザ定義受付）をHCSCサーバに配備します。HCSCコンポーネントの配備は運用環境のコマンドを利用します。

HCSCコンポーネントの配備方法の詳細については，「3.1.8　サービスアダプタを配備する」，「3.1.13　ビジネスプロセスを配備する」，および「3.1.14　ユーザ定義受付を配備する」を参照してください。

コマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」を参照してください。

(14)　HCSCコンポーネントの開始

配備したHCSCコンポーネント（サービスアダプタ，ビジネスプロセス，およびユーザ定義受付）を開始します。なお，サービスアダプタを開始する際には，サービスアダプタから実行するサービスも起動している必要があります。HCSCコンポーネントを開始・停止するには，運用環境の画面またはコマンドを利用します。

HCSCコンポーネントの開始方法の詳細については，「5.3.7　サービスアダプタを開始する」，「5.3.8　ビジネスプロセスを開始する」，および「5.3.9　ユーザ定義受付を開始する」を参照してください。

画面およびコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」を参照してください。

(15)　リクエスト受付の開始

サービスリクエスタから要求を受け付けるリクエスト受付（標準受付）を開始します。

標準受付を開始・停止するには，運用環境の画面またはコマンドを利用します。

標準受付の開始方法の詳細については，「5.3.10　標準受付を開始する」を参照してください。

画面およびコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」を参照してください。

(16)　システムの監視・障害発生時の対応

実行環境での業務を開始したあとは，運用環境でシステムを監視します。障害が発生した場合には，障害の原因を特定し，対策します。

(a)　システムの監視

実行環境での業務を開始したあと，必要に応じて，運用環境からHCSCサーバやHCSCコンポーネントなどの状態を確認できます。

システムの状態の確認は，運用環境の画面またはコマンドを利用します。

システムの状態を確認する方法の詳細については，「5.　システム運用」を参照してください。

また，運用環境では，データベースに記録されているビジネスプロセスのプロセスインスタンスの実行履歴の中から，必要に応じて目的のプロセスインスタンスを特定して，その状態を確認したり，実行履歴を削除したり，プロセスインスタンスを再実行できます。

プロセスインスタンスの確認，実行履歴の削除および再実行は，運用環境の画面またはコマンドを利用します。

プロセスインスタンスの実行履歴の管理方法の詳細は，「6.　実行履歴の管理」を参照してください。

画面およびコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」を参照してください。

(b)　障害の対策

システムの運用中に障害が発生した場合，それぞれの環境から，ログファイルやトレースファイルを採取します。ログファイルやトレースファイルを取得し，障害の発生個所や原因を特定し，障害の対策を実施します。

なお，JP1と連携するシステムを構築した場合，サービスプラットフォームでは，発生した障害のメッセージをJP1イベントとしてJP1に通知します。これによって，出力するエラーメッセージを収集し，JP1の統合コンソールで集中的に監視できます。

また，JP1側で特定のJP1イベント（エラーメッセージ）の受信を契機として，自動的にコマンドを実行することができます。これによって，システム運用（障害の発生をシステム管理者へ通知する，回復のためのコマンドを実行するなど）を自動化できます。

障害時のログファイルやトレースファイルの取得，およびJP1イベントの詳細情報の確認については，「7.　障害対策」を参照してください。

1.2　システム全体と運用環境・実行環境の関係

サービスプラットフォームでは，開発環境，運用環境および実行環境が相互に関連してシステム全体を構成します。その中での運用環境および実行環境の位置づけについて説明します。

1.2.1　運用上の位置づけ

システム全体の運用での，運用環境と実行環境の位置づけを次の図に示します。

図1‒2　運用上の位置づけ

運用環境では，開発環境で作成したHCSCコンポーネント（サービスアダプタ，ビジネスプロセス，およびユーザ定義受付）をリポジトリから読み込み，実行環境に配備します。また，実行環境で利用するHCSCサーバをセットアップします。

運用を開始したあとは，システムの起動・停止・状態の監視をします。

実行環境では，サービスリクエスタで受け付けた要求電文に応じて，HCSCサーバを介してサービス部品およびビジネスプロセスを呼び出し，業務を実行します。

1.2.2　ネットワーク上の位置づけ

開発環境，運用環境および実行環境は，インターネットやイントラネットなどのネットワークを使って連結してシステムを構成します。

システム全体での運用環境および実行環境のネットワーク上の位置づけについて次の図に示します。なお，実行環境の構成は，運用の形態によって異なります。実行環境の構成については，「1.4　運用方針の決定」を参照してください。

図1‒3　システム全体での運用環境および実行環境のネットワーク上の位置づけ

運用環境と実行環境は同じマシンに構築することを推奨します。

なお，開発環境は別のネットワーク上に構築することができます。

実行環境でのサービス部品の実行状態などの情報は，Service Platformが稼働しているマシンに構築したデータベースへ蓄積されます。

また，Service Platformが稼働しているマシンとネットワークで接続できる別マシン上に，データベースを構築することもできます。この場合，Service Platformが稼働しているマシンと，データベースを構築したマシンはLAN回線などで接続します。

なお，Service Platformが稼働しているマシンで使用するデータベースは，次の構成をとることができます。

クラスタ構成にしない場合

Service Platformに対して1つのデータベースを作成してください。また，データベースのスキーマをService Platformごとに分割することで，複数のService Platformを1つのデータベースで使用できます。

クラスタ構成にする場合

クラスタに対して1つのデータベースを作成し，複数のService Platformでデータベースを共有してください。

1.2.3　運用環境と実行環境の構成

クラスタ構成にする場合に実現できる運用環境と実行環境の構成パターンを次に示します。

表1‒1　クラスタ利用時の運用環境と実行環境の構成

構成パターン

説明

データベース

運用・実行1対1構成

運用環境と実行環境を1対1にして配置します。

△※

運用集約構成

実行時に利用するサーバに，運用環境を集約します。

○

（凡例）

○：データベースを利用できます。

△：新規導入の場合だけデータベースを利用できます。

注※

バージョンが08-70より前の場合，データベースを利用できません。また，08-70以降にバージョンアップするときに，データベースを利用した運用・実行1対1構成には移行できません。

データベースを利用した運用・実行1対1構成を実現したい場合は，移行ではなく新規で運用・実行1対1構成を構築し，クラスタ内のすべてのHCSCサーバをアンセットアップする必要があります。その際，データベースに格納されているクラスタの共有テーブル（共有しているプロセスインスタンスや実行履歴などの情報）が削除されます。

運用・実行1対1構成の構成例を次の図に示します。

図1‒4　運用・実行1対1構成の構成例

運用集約構成の構成例を次の図に示します。

図1‒5　運用集約構成の構成例

1.3　テスト環境と本番環境との関係

サービスプラットフォームでは，まず，テスト環境を構築してテストやデバッグを実施します。テスト環境の構築には，HCSC簡易セットアップ機能を使用できます。

実際のシステム開発では，テスト環境のほかに本番で使用する環境を構築する必要があります。そのため，テスト環境で使用したリポジトリを，本番環境に移行する必要があります。

テスト環境で使用したリポジトリを本番環境へ移行するには，次の3つのケースがあります。

ケース1

テスト環境と本番環境で，データベースとReliable Messagingの使用有無を同じ設定で構築した場合

ケース2

テスト環境と本番環境で，データベースとReliable Messagingの使用有無を異なる設定で構築したが，テスト環境で使用したリポジトリをそのまま本番環境へ移行できる場合※

ケース3

テスト環境と本番環境で，データベースとReliable Messagingの使用有無を異なる設定で構築したため，テスト環境で使用したリポジトリを本番環境のリポジトリに作成し直す場合※

注※

テスト環境で使用したリポジトリをそのまま本番環境へ移行できるかどうかについては，「4.3　リポジトリのインポート」を参照してください。

それぞれのケースに対応する，データベースとReliable Messagingの使用有無の設定を次の表に示します。なお，データベースとReliable Messagingの使用有無による構成の形態については，「2.2　システム構成の形態，J2EEサーバの互換モード，およびSOAPモードの選択」を参照してください。

表1‒2　データベースとReliable Messagingの使用有無の設定に対応したケース

テスト環境の設定

本番環境の設定

データベースとReliable Messagingの両方を使用する

データベースを使用してReliable Messagingを使用しない

データベースとReliable Messagingの両方を使用しない

データベースとReliable Messagingの両方を使用する

ケース1※

ケース3

ケース3

データベースを使用してReliable Messagingを使用しない

ケース2

ケース1※

ケース3

データベースとReliable Messagingの両方を使用しない

ケース2

ケース2※

ケース1※

注※

テスト環境と本番環境の設定で，通常のユーザが該当する設定です。

それぞれのケースによる移行の概要を次に説明します。

1.3.1　ケース1：テスト環境と本番環境でデータベースとReliable Messagingの使用有無を同じ設定で構築した場合

次のようにテスト環境と本番環境で，データベースとReliable Messagingの使用有無を同じ設定で構築した場合，テスト環境で使用したリポジトリをそのまま本番環境へ移行できます。

テスト環境と本番環境で，データベースとReliable Messagingの両方を使用する場合

テスト環境と本番環境で，データベースとReliable Messagingの両方を使用しない場合

テスト環境と本番環境で，データベースを使用しReliable Messagingを使用しない場合

テスト環境と本番環境で，データベースとReliable Messagingの使用有無を同じ設定で構築した場合の移行の流れを次の図に示します。

図1‒6　データベースとReliable Messagingの使用有無を同じ設定で構築した場合の移行の流れ

具体的な移行手順については，「3.4.1　テスト環境と本番環境でデータベースとReliable Messagingの使用有無が同じ場合の移行手順」を参照してください。

1.3.2　ケース2：テスト環境と本番環境でデータベースとReliable Messagingの使用有無を異なる設定で構築した場合（リポジトリをそのまま移行できるとき）

テスト環境と本番環境で，データベースとReliable Messagingの使用有無を異なる設定で構築した場合でも，次のようなときは，テスト環境で使用したリポジトリをそのまま本番環境へ移行できます。

テスト環境では，データベースとReliable Messagingの両方を使用しないで，本番環境では，データベースとReliable Messagingの両方を使用する場合

テスト環境では，データベースとReliable Messagingの両方を使用しないで，本番環境では，データベースを使用しReliable Messagingを使用しない場合

テスト環境では，データベースを使用しReliable Messagingを使用しないで，本番環境では，データベースとReliable Messagingの両方を使用する場合

テスト環境と本番環境で，データベースとReliable Messagingの使用有無を異なる設定で構築した場合で，テスト環境で使用したリポジトリをそのまま本番環境へ移行できるときの移行の流れを次の図に示します。

図1‒7　データベースとReliable Messagingの使用有無を異なる設定で構築した場合の移行の流れ（リポジトリをそのまま移行できるとき）

具体的な移行手順については，「3.4.3　データベースとReliable Messagingの両方を使用しない環境から両方使用する環境に移行する場合の移行手順」および「3.4.5　データベースとReliable Messagingの両方を使用しない環境からデータベースを使用してReliable Messagingを使用しない環境に移行する場合の移行手順」を参照してください。

1.3.3　ケース3：テスト環境と本番環境でデータベースとReliable Messagingの使用有無を異なる設定で構築した場合（リポジトリを作成し直すとき）

テスト環境と本番環境で，データベースとReliable Messagingの使用有無を異なる設定で構築した場合で，次のようなときは，テスト環境で使用したリポジトリをそのまま本番環境へ移行できません。

テスト環境では，データベースとReliable Messagingの両方を使用して，本番環境では，データベースとReliable Messagingの両方を使用しない場合

テスト環境では，データベースとReliable Messagingの両方を使用して，本番環境では，データベースを使用してReliable Messagingを使用しない場合

テスト環境では，データベースを使用しReliable Messagingを使用しないで，本番環境では，データベースとReliable Messagingの両方を使用しない場合

この場合，テスト環境で設定したシステム構成定義を本番で使用するシステム構成定義に設定し直して，リポジトリを作成し直します。

テスト環境と本番環境で，データベースとReliable Messagingの使用有無を異なる設定で構築した場合で，テスト環境で使用したリポジトリを本番環境のリポジトリに作成し直すときの移行の流れを次の図に示します。

図1‒8　データベースとReliable Messagingの使用有無を異なる設定で構築した場合の移行の流れ（リポジトリを作成し直すとき）

具体的な移行手順については，「3.4.2　データベースとReliable Messagingの両方を使用する環境から両方使用しない環境に移行する場合の移行手順」および「3.4.4　データベースとReliable Messagingの両方を使用する環境からデータベースを使用してReliable Messagingを使用しない環境に移行する場合の移行手順」を参照してください。

1.4　運用方針の決定

実行環境（HCSCサーバ）の構築・セットアップに際して，実行環境をどのような構成にして運用するかを決定します。

実行環境の構成は，サービス部品の実行を要求するHCSCコンポーネントが配備されるHCSCサーバの数，および複数のHCSCサーバの関係によって異なります。業務の規模・内容や，用意できるハードウェアの制約，既存システムからの移行が容易かどうか，負荷分散による性能・信頼性をどの程度確保するかなどを考慮して，実行環境の構成と運用の方針を決定します。

サービスプラットフォームの実行環境では，HCSCサーバの数，および複数のHCSCサーバの関係によって，次のような構成・運用ができます。

単一のHCSCサーバによる運用

複数のHCSCサーバによる運用

複数のHCSCサーバでロードバランスクラスタを構成する運用

複数のHCSCサーバでHAクラスタを構成する運用

複数のHCSCサーバでN対1クラスタを構成する運用

複数のHCSCサーバによる運用，および複数のHCSCサーバでクラスタを構成する運用では，HCSCサーバのSOAPモードを一致させる必要があります。SOAPモードについては，「2.2.3　SOAPモードの選択」を参照してください。

HCSCサーバおよびクラスタのセットアップについては，「3.　システムのセットアップとアンセットアップ」を参照してください。

以降の項で，それぞれの構成と運用について説明します。

注意事項

NTPソフトウェア※を使用してシステム時刻補正をする場合は，次の点に注意してください。

時刻飛びが発生しないように，時刻のずれを徐々に補正するslewモードで実行してください。

一度に数十秒以上の大幅な時刻補正が必要な場合は，製品のプロセスを停止してから時刻補正を実行してください。

時刻補正によってシステム時刻を進めたり戻したりした場合，トランザクション，通信またはシステム監視などのタイムアウトが，想定より早くなったり遅くなったりすることがあります。また，ログや履歴の時系列の崩れや，システム内で採番している一意IDの重複などが発生することがあります。これらのことを考慮してシステム設計やタイムアウト設計をしてください。

注※

Windows Timeサービス，UNIX系プラットフォームのntpdコマンド，ntpdateコマンドなどのことを指します。

システム時刻補正の詳細については，使用しているOSのマニュアルを参照してください。

1.4.1　単一のHCSCサーバによる運用

1つのHCSCサーバでの構成を次の図に示します。

図1‒9　HCSCサーバの構成（単一の場合）

HCSCサーバが1つの場合，すべてのHCSCコンポーネントを1つのHCSCサーバに配備して運用します。すべてのサービス部品が，同じHCSCサーバから呼び出されます。

1.4.2　複数のHCSCサーバによる運用

サービスプラットフォームでは，実行環境に複数のHCSCサーバをセットアップして運用することができます。

複数のHCSCサーバでの構成を次の図に示します。

図1‒10　HCSCサーバの構成（複数の場合）

複数のHCSCサーバによる構成の場合，それぞれのサーバに異なるHCSCコンポーネントを配備して運用します。それぞれのHCSCサーバからはそれぞれ異なるサービス部品を呼び出します。HCSCコンポーネントで呼び出すサービス部品の業務別にHCSCサーバを分けて運用管理する場合などに利用できます。

1.4.3　複数のHCSCサーバでロードバランスクラスタを構成する運用

サービスプラットフォームでは，特定のHCSCサーバにサービス部品の実行要求が集中しないように，複数のHCSCサーバをクラスタリングし，汎用ロードバランサまたはCTMを使用して負荷を分散するシステムを構築できます。この構成をロードバランスクラスタ構成といいます。ここでは，汎用ロードバランサとCTMを合わせて，ロードバランサと表記します。

HCSCサーバをクラスタリングした場合の構成（ロードバランスクラスタ構成）を次の図に示します。

図1‒11　HCSCサーバの構成（ロードバランスクラスタ構成の場合）

ロードバランスクラスタ構成では，運用を停止しないで，ロードバランスクラスタを構成するHCSCサーバを追加，変更，および削除することができます。

ロードバランスクラスタ構成で使用するロードバランサは，標準の同期受付（Webサービス／SessionBean）へのサービス部品の実行要求だけ受け付けます。標準の非同期受付（MDB（WS-R）／MDB（DBキュー））へのサービス部品の実行要求は，受け付けることができません。なお，標準の同期受付（Webサービス）と標準の同期受付（SessionBean）のどちらにサービス部品の実行要求を送信するかによって，使用するロードバランサが異なります。使用するロードバランサについては，「2.5　HCSCサーバをロードバランスクラスタ構成にする場合の環境構築」を参照してください。

注意事項

ロードバランスクラスタ構成では，ロードバランスクラスタ経由の非同期実行要求（MDB（WS-R）／MDB（DBキュー））は受け付けることができませんが，個々のHCSCサーバへの直接の非同期実行要求（MDB（WS-R）／MDB（DBキュー））は受け付けることができます。その場合，サービス部品の実行要求を送信するサービスリクエスタの宛先を，必ずHCSCサーバに設定してください。

ロードバランスクラスタ構成に対して宛先を設定した場合，サービス部品の実行要求が正しく処理されないときがあります。このため，ロードバランサで標準の非同期受付（MDB（WS-R）／MDB（DBキュー））へのサービス部品の実行要求を受け付けないように設定してください。

1.4.4　複数のHCSCサーバでHAクラスタを構成する運用

サービスプラットフォームでは，実行環境にセットアップされた複数のHCSCサーバを，2つずつ組み合わせたコールドスタンバイ構成でクラスタリングし，実行系と待機系を1対1で運用するシステム（1:1系切り替えシステム）を構築できます。この構成をHAクラスタ構成といいます。

HCSCサーバをクラスタリングした場合の構成（HAクラスタ構成）を次の図に示します。

図1‒12　HCSCサーバの構成（HAクラスタ構成の場合）

HAクラスタを構成するには，クラスタソフトウェアが必要です。サービスプラットフォームでは次のクラスタソフトウェアを利用します。

Windowsの場合：Windows Server Failover Cluster

UNIXの場合：HAモニタ

クラスタリングされた1:1系切り替えシステムでは，実行系に何らかの障害が発生すると，クラスタソフトウェアがこれを検知して，自動的に待機している系に切り替えて業務を続行します。システムがより冗長な構成になり，一方の系で障害が発生してもサービス部品を継続して運用できるようになります。

なお，クラスタソフトには，障害を検知した場合に待機系HCSCサーバが自動的に起動されるよう次の設定をしておきます。

待機系HCSCサーバの起動

待機系HCSCサーバの標準受付の開始

注意事項

HAクラスタを構成する2つのHCSCサーバには，同じHCSCコンポーネントが配備されている必要があります。また，OSやユーザも実行系と待機系で同じにしておく必要があります。

HAクラスタ構成時に障害が発生した場合，共通フォルダとファイルアダプタが入出力するファイルを共有ディスクに格納していると，ビジネスプロセスの再実行ができます。ただし，FTP受付とHTTP受付については共通フォルダを使用できないため，ビジネスプロセスの再実行ができません。

1.4.5　複数のHCSCサーバでN対1クラスタを構成する運用

サービスプラットフォームでは，ロードバランスクラスタを構成するHCSCサーバをHAクラスタ相当のコールドスタンバイ構成にすることで，すべての待機系を1台のマシン上で構築できます。この構成をN対1クラスタ構成といいます。

HCSCサーバをクラスタリングした場合の構成（N対1クラスタ構成）を次の図に示します。

図1‒13　HCSCサーバの構成（N対1クラスタ構成の場合）

N対1クラスタ構成で使用するロードバランサで，サービス部品の実行要求を受け付けるかどうかを次の表に示します。

表1‒3　N対1クラスタ構成で使用するロードバランサでのサービス部品の実行要求の受け付け可否

標準受付

受け付け可否

標準の同期受付（Webサービス）

○

標準の同期受付（SessionBean）

○

標準の非同期受付（MDB（WS-R））

×

標準の非同期受付（MDB（DBキュー））

×

（凡例）

○：実行要求を受け付けます。

使用するロードバランサは，HCSCサーバをロードバランスクラスタ構成にする場合と同じです。詳細については，「2.5　HCSCサーバをロードバランスクラスタ構成にする場合の環境構築」を参照してください。

×：実行要求を受け付けません。

ただし，個々のHCSCサーバに対する直接の非同期実行要求は受け付けることができます。この場合，サービス部品の実行要求を送信するサービスリクエスタの宛先を，必ずHAクラスタ相当のHCSCサーバの組に設定してください。

ロードバランスクラスタ構成に対して宛先を設定した場合，サービス部品の実行要求が正しく処理されないことがあります。このため，ロードバランサで標準の非同期受付（MDB（WS-R）／MDB（DBキュー））へのサービス部品の実行要求を受け付けないように設定してください。

2　システムの構築

この章では，Service Platformなどのインストールやインストール後の設定方法について説明します。

2.1　インストールとアンインストール

2.1.1　インストールの流れ

インストールの流れを次の図に示します。

図2‒1　インストールの流れ

(1)　Service Platformのインストール

Service Platformのインストール方法については，「2.1.2　Service Platformのインストール」を参照してください。

なお，インストールしたService Platformのアンインストールについては，「2.1.7　アンインストール」を参照してください。

(2)　環境設定

環境設定としてリポジトリを設定します。

環境設定については，「2.1.3　環境設定」を参照してください。

(3)　Eclipseのインストール

運用環境で画面を利用する場合，Eclipseをインストールします。

Eclipseのインストール手順については，「2.1.4　Eclipseのインストール」を参照してください。

(4)　EclipseへのHCSC-Manager Plug-inの組み込み

運用環境で画面を利用する場合，EclipseにHCSC-Manager Plug-inを組み込みます。

EclipseへのHCSC-Manager Plug-inの組み込みについては，「2.1.5　EclipseへのHCSC-Manager Plug-inの組み込み」を参照してください。

(5)　Management Serverの設定

HCSC-Managerを使用するためのManagement Serverの設定を，HCSC-Managerの接続先となる実行環境で実施します。

Management Serverの設定については，「2.1.6　HCSC-Managerを使用するためのManagement Serverの設定」を参照してください。

(6)　実行環境に関する設定

HCSCサーバの構成などを設定します。実行環境に関する設定の詳細は，「2.3　実行環境に関する設定」を参照してください。

(7)　運用環境に関する設定

ユーザの権限などを設定します。運用環境に関する設定の詳細は，「2.4　運用環境に関する設定」を参照してください。

2.1.2　Service Platformのインストール

(1)　インストール方法

Service Platformのインストール手順については，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「2.2　アプリケーションサーバの構築」を参照してください。インストール上の注意事項については，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「付録I　インストールおよびアンインストールするときの注意事項」を参照してください。なお，インストール手順の製品名「Application Server」は，「Service Platform」と読み替えてください。

UNIXの場合，Service Platformに含まれる構成ソフトウェアを次に示します。

Component Container

Component Transaction Monitor

Developer's Kit for Java

Performance Tracer

Reliable Messaging

Service Coordinator

TPBroker

Web Services - Security

XML Processor

HTTP Server

Service Platform - Base

注意事項

Linux版サービスプラットフォームの11-70では，インストール時にJDK 11（形名：P-CC9W3Z-21X1）とJDK 17（形名：P-CC9W3Z-21B1）とJDK 21（形名：P-CC9W3Z-21C1）を選択できますが，JDK 21は使用できません。JDK 11またはJDK 17をインストールしてください。

Windows版サービスプラットフォームの11-70では，インストール時にJDK 21を選択できません。JDK 11（形名：P-CC293Z-2194）またはJDK 17（形名：P-CC293Z-21B4）だけインストールできます。

(2)　インストール後のディレクトリ構成

Service Platformを構成するソフトウェアのうち，Service Coordinatorのインストール後のディレクトリ構成を次の図に示します。Service Coordinator以外の構成ソフトウェアのインストール後のディレクトリ構成については，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「付録B　インストール後のディレクトリ構成」を参照してください。

図2‒2　インストール後のディレクトリ構成

2.1.3　環境設定

Service Platformをインストールしたマシン上で次の設定を行います。

リポジトリの設定

リポジトリの設定については，「4.1　リポジトリの概要」を参照してください。

2.1.4　Eclipseのインストール

運用環境で画面を利用する場合，Eclipseをインストールする必要があります。コマンドを利用する場合は，運用環境にEclipseをインストールする必要はありません。

Service Platformを利用している場合は，次の手順に従ってEclipseをインストールしてください。Service Architectを利用している場合は，Eclipseセットアップ機能を利用してEclipseをインストールしてください。Eclipseセットアップ機能については，マニュアル「サービスプラットフォームファーストステップガイド」の「3.3.2　Eclipseセットアップ機能を使用した開発環境の構築」を参照してください。

注意事項

アプリケーションサーバおよびサービスプラットフォームが提供するEclipseのプラグイン機能以外の，Eclipseに関するサポートはしていません。Eclipseの使用方法やEclipseが表示するエラーの対処方法については，ユーザで調査，対処してください。

(1)　インストール前の準備

Eclipseをインストールする前に，次の準備が必要です。

Service Platformのインストールを完了させてください。

次の2つのディレクトリを準備してください。

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

作業用ディレクトリ（Eclipseのダウンロード時に使用するディレクトリ）

(2)　インストール手順

インストール手順を次に示します。この手順ではインストールディレクトリを「C:¥Eclipse」，作業用ディレクトリを「C:¥Work」と表記します。

次のどちらかの方法でzipファイルを入手し，作業用ディレクトリに格納します。

Service Architectの添付品CD

Eclipseのダウンロードサイト

次のURLで示すダウンロードサイトから，「Eclipse IDE for Enterprise Java Developers」を選択してください。

http://www.eclipse.org/downloads/

次のzipファイルのどれかを選択してください（Windows x64（64ビット版）の場合）。

項番

使用するJDKのバージョン

Eclipseのバージョン

アーカイブファイル名

1

JDK 11を使用する場合

Eclipse IDE for Enterprise Java and Web Developers 2021-09（4.21）

eclipse-jee-2021-09-R-win32-x86_64.zip

2

Eclipse IDE for Enterprise Java and Web Developers 2021-12（4.22）

eclipse-jee-2021-12-R-win32-x86_64.zip

3

JDK 17を使用する場合

Eclipse IDE for Enterprise Java and Web Developers 2023-09（4.29）

eclipse-jee-2023-09-R-win32-x86_64.zip

コマンドプロンプトを起動し，カレントディレクトリを作業用ディレクトリへ移動します。

コマンドプロンプトの実行例

cd C:¥Work

さらに次のコマンドを実行して，zipファイルを解凍します。

"<Service Platformのインストールディレクトリ>¥jdk¥bin¥jar.exe" xvf <Eclipseのzipファイル名>

解凍したファイルをEclipseのインストールディレクトリへコピーします。

エクスプローラなどを使用し，C:¥Work¥eclipseの下にあるすべてのファイルとディレクトリをC:¥Eclipseへコピーします。

エクスプローラなどを使用し，作業用ディレクトリを削除します。

注：ダウンロードしたファイルも削除されるため，必要に応じて事前にバックアップを取ってください。

手順3.でコピーしたファイルの中から，eclipse.iniファイルをエディタで開き，次のオプションを削除します。

-vmオプション

plugins/org.eclipse.justj.openjdk.hotspot.jre.full.win32.x86_64_XX.X.X.v20XXXXXX-XXXX/jre/bin

「X」の部分はバージョンによって異なります。

eclipse.iniファイルに次の2つのオプションを追加します。

-vmオプション

<Service Platformのインストールディレクトリ>¥jdk¥bin¥javaw.exe

-vmargsオプション

JDK 11をインストールした環境の場合は次の内容を追加してください。

-Xbootclasspath/a:<Service Platformのインストールディレクトリ>¥jaxp¥lib¥csmjaxp.jar;<Service Platformのインストールディレクトリ>¥jaxp¥lib¥csmstax.jar

JDK 17をインストールした環境の場合は次の内容を追加してください。

"--add-opens java.base/java.lang=ALL-UNNAMED"

オプション追加後のeclipse.iniファイルの内容の例を次に示します。

JDK 11をインストールした環境の場合

-vm
C:¥Program Files¥Hitachi¥Cosminexus¥jdk¥bin¥javaw.exe
-startup
plugins/org.eclipse.equinox.launcher_1.6.300.v20210813-1054.jar
--launcher.library
plugins/org.eclipse.equinox.launcher.win32.win32.x86_64_1.2.300.v20210828-0802
-product
org.eclipse.epp.package.jee.product
-showsplash
org.eclipse.epp.package.common
--launcher.defaultAction
openFile
--launcher.defaultAction
openFile
--launcher.appendVmargs
-vmargs
-Dosgi.requiredJavaVersion=1.8
-Dosgi.instance.area.default=@user.home/eclipse-workspace
-XX:+UseG1GC
-XX:+UseStringDeduplication
--add-modules=ALL-SYSTEM
-Dosgi.requiredJavaVersion=1.8
-Dosgi.dataAreaRequiresExplicitInit=true
-Xms256m
-Xmx1024m
--add-modules=ALL-SYSTEM
-Xbootclasspath/a:C:¥Program Files¥Hitachi¥Cosminexus¥jaxp¥lib¥csmjaxp.jar;C:¥Program Files¥Hitachi¥Cosminexus¥jaxp¥lib¥csmstax.jar

JDK 17をインストールした環境の場合

-vm
C:¥Program Files¥Hitachi¥Cosminexus¥jdk¥bin¥javaw.exe
-startup
plugins/org.eclipse.equinox.launcher_1.6.500.v20230717-2134.jar
--launcher.library
plugins/org.eclipse.equinox.launcher.win32.win32.x86_64_1.2.700.v20221108-1024
-product
org.eclipse.epp.package.jee.product
-showsplash
org.eclipse.epp.package.common
--launcher.defaultAction
openFile
--launcher.defaultAction
openFile
--launcher.appendVmargs
-vmargs
-Dosgi.requiredJavaVersion=1.8
-Dosgi.instance.area.default=@user.home/eclipse-workspace
-XX:+UseG1GC
-XX:+UseStringDeduplication
--add-modules=ALL-SYSTEM
-Dosgi.requiredJavaVersion=1.8
-Dosgi.dataAreaRequiresExplicitInit=true
-Xms256m
-Xmx1024m
--add-modules=ALL-SYSTEM
"--add-opens java.base/java.lang=ALL-UNNAMED"

次のコマンドを実行して，Eclipseを起動します。

C:¥Eclipse¥eclipse.exe

Eclipseが起動することを確認してください。

これでEclipseのインストールは終了です。

2.1.5　EclipseへのHCSC-Manager Plug-inの組み込み

HCSC-Manager Plug-inをEclipseへ組み込みます。

HCSC-Manager Plug-inを組み込む手順を次に示します。

次に示すリンクファイルをコピーします。

コピー元のファイル

<サービスプラットフォームのインストールディレクトリ>¥common¥dropins¥com.cosminexus.common.plugin.link

<サービスプラットフォームのインストールディレクトリ>¥plugins¥dropins¥com.cosminexus.plugin.link

コピー先のディレクトリ

<Eclipseのインストールディレクトリ>¥dropins

Eclipseを再起動します。

Eclipseが起動すると組み込みは完了です。

HCSC-Manager Plug-inが正しく組み込まれたかどうかについては，メニューから［ヘルプ］−［Eclipse Platformについて］−［Installation Details］を選択して表示される，［Eclipse Platform Installation Details］ダイアログの［Installed Software］タブで確認できます。

サービスプラットフォームを再インストールしたときの注意事項

バージョンアップなどによってサービスプラットフォームを再インストールした場合，HCSC-Manager Plug-inの組み込みを解除したあとで，再度HCSC-Manager Plug-inを組み込む必要があります。

HCSC-Manager Plug-inの組み込みを解除する手順を次に示します。

次に示すリンクファイルを削除します。

<Eclipseのインストールディレクトリ>¥dropins¥com.cosminexus.common.plugin.link

<Eclipseのインストールディレクトリ>¥dropins¥com.cosminexus.plugin.link

Eclipseを再起動します。

2.1.6　HCSC-Managerを使用するためのManagement Serverの設定

HCSC-Managerを使用するための設定を，HCSC-Managerの接続先となる実行環境のマシンで実施します。設定手順を次に示します。

(1)　mserver.properties（Management Server環境設定ファイル）の設定

実行環境のmserver.properties（Management Server環境設定ファイル）に，プロパティを追加します。mserver.propertiesの格納先とmserver.propertiesに追加するプロパティを次に示します。

(a)　mserver.propertiesの格納先

<サービスプラットフォームのインストールディレクトリ>¥manager¥config¥mserver.properties

(b)　追加するプロパティ

com.cosminexus.mngsvr.management.enabled=true
com.cosminexus.mngsvr.management.connector.enabled=true
com.cosminexus.mngsvr.management.port=28099※1
ejbserver.naming.port=28900※2
ejbserver.server.edition.settingforce=
mngsvr.myhost.name=localhost

注※1

HCSC-Managerからの接続ポート番号を指定します。設定を省略した場合，デフォルトで28099が設定されます。

注※2

HCSC-Managerからの接続ポート番号を指定します。設定を省略した場合，デフォルトで28900が設定されます。

注意

Management Serverの起動前に必ず設定してください。設定する前にManagement Serverを起動した場合は，cscで始まるコマンドがエラーになる場合があります。

(2)　mserver.cfg（Management Server用オプション定義ファイル）の設定

実行環境のmserver.cfg（Management Server用オプション定義ファイル）に，プロパティを追加します。

mserver.cfgの格納先とmserver.cfgに追加するプロパティを次に示します。

(a)　mserver.cfgの格納先

<サービスプラットフォームのインストールディレクトリ>¥manager¥config¥mserver.cfg

(b)　追加するプロパティ

データベースでOracleを使用する場合

web.add.class.path=<Oracle JDBC Thin DriverのJARファイル名（フルパス）>※

注※

該当するJARファイルがOracle JDBC Thin Driver 21.16.0.0.0の場合の例を次に示します。

<ORACLE_HOME>/jdbc/lib/ojdbc11.jar

データベースでHiRDBを使用する場合

HiRDB/Single Server，HiRDB/Parallel ServerまたはHiRDB Serverをインストールしているとき

Windowsの場合

add.library.path=<HiRDBのインストールディレクトリ>¥CLIENT¥UTL

UNIXの場合

add.library.path=<HiRDBの運用ディレクトリ>/client/lib

HiRDB/Run Time，またはHiRDB/Developer's Kitをインストールしているとき

Windowsの場合

add.library.path=<HiRDBのインストールディレクトリ>¥utl

UNIXの場合

add.library.path=<HiRDBのインストールディレクトリ>/client/lib

JDBCドライバにHiRDB Type4 JDBC Driverを利用するとき

web.add.class.path=<HiRDB Type4 JDBC DriverのJARファイル名（フルパス）>※

注※

HiRDBのインストールディレクトリ下の「pdjdbc2.jar」が該当するJARファイルです。

(3)　adminagent.properties（運用管理エージェントプロパティファイル）の確認

(a)　adminagent.propertiesの格納先

<サービスプラットフォームのインストールディレクトリ>¥manager¥config¥adminagent.properties

(b)　確認するプロパティ

次に示すプロパティに「2」が設定されているか，プロパティが省略されていることを確認してください。

adminagent.j2ee.watch.level=2

(4)　運用管理エージェントの起動（起動済みの場合は再起動）

Management Server環境設定ファイルおよびManagement Server用オプション定義ファイルを設定したあとは，運用管理エージェントを起動する必要があります。すでに起動している場合は再起動してください。

運用管理エージェントの起動については，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「4.1.19　運用管理エージェントを起動する」を参照してください。

(5)　Management Serverの起動（起動済みの場合は再起動）

Management Server環境設定ファイルおよびManagement Server用オプション定義ファイルを設定したあとは，Management Serverを起動する必要があります。すでに起動している場合は再起動してください。

Management Serverの起動については，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「4.1.20　Management Serverを起動する」を参照してください。

(6)　MBeanの起動確認

<サービスプラットフォームのインストールディレクトリ>¥manager¥log¥message¥下の最新のmngmessage[n].logファイルにKEOS27010-Iメッセージが22個出力されることを確認します。

なお，KEOS27010-Iメッセージの可変値のファイル名には，次に示すどれかが出力されます。

50cscbp.xml

50cscmsg.xml

50cscmt.xml

注意事項

バージョン07-50以降では，「<サービスプラットフォームのインストールディレクトリ>¥CSC¥mbean-plugins」配下のファイルを，「<サービスプラットフォームのインストールディレクトリ>¥manager¥mbean-plugins」にコピーする作業は不要です。

次のファイルが存在する場合，ファイルを削除したあとに(3)〜(5)の手順を行ってください。

<サービスプラットフォームのインストールディレクトリ>¥manager¥mbean-plugins¥config¥50cscbp.xml

<サービスプラットフォームのインストールディレクトリ>¥manager¥mbean-plugins¥config¥50cscmsg.xml

<サービスプラットフォームのインストールディレクトリ>¥manager¥mbean-plugins¥lib¥cscbp_mbean.jar

<サービスプラットフォームのインストールディレクトリ>¥manager¥mbean-plugins¥lib¥cscmsg_mbean.jar

2.1.7　アンインストール

Service Platform，および構成ソフトウェアについて，アンインストールの対象とアンインストール方法を説明します。

(1)　アンインストールする前に

Service Platform，およびService Platformの構成ソフトウェアであるService Coordinatorをアンインストールする前に知っておかなければならない内容と，アンインストールする前に行う作業について説明します。

(a)　対象となるファイルおよびディレクトリ

通常インストーラで作成したファイル，ディレクトリだけが削除されます。削除対象のディレクトリ配下にファイルを作成した場合は，アンインストール時に削除されるため注意してください。

ただし，次の表に示すファイルはアンインストールしても削除されません。これらのファイルが配置されているディレクトリも削除されないで残ります。次の表に，<サービスプラットフォームのインストールディレクトリ>¥CSC下のファイルのうち，アンインストールで削除されないファイルを示します。

表2‒1　アンインストールで削除されない<サービスプラットフォームのインストールディレクトリ>¥CSC下のファイル

ファイルが削除されないディレクトリ

左記ディレクトリのうち削除されないファイル

config

adpfop

サブディレクトリtemplatesの配下を除くすべてのファイル

common

すべてのファイル

ftprecp

サブディレクトリtemplatesの配下を除くすべてのファイル

mail

manager

msg

cmdconf.bat（Windows版の場合）※1

cmdconf（UNIX版の場合）

services

すべてのファイル

custom-adapter

Command¥config

サブディレクトリtemplatesの配下を除くすべてのファイル

File¥config

FTP¥config

FTP¥log

すべてのファイル

gRPC¥config

サブディレクトリtemplatesの配下を除くすべてのファイル

HTTP¥config

サブディレクトリtemplatesの配下を除くすべてのファイル

Kafka¥config

サブディレクトリtemplatesの配下を除くすべてのファイル

MQ¥config

サブディレクトリtemplatesの配下を除くすべてのファイル

OA¥config

次のファイルを除くすべてのファイル

templatesの配下のファイル

adpoacmd.properties※2

wrappercode.properties※2

wrappertype.properties※2

OA¥log※2

すべてのファイル

SFTP¥config

サブディレクトリtemplatesの配下を除くすべてのファイル

TP1¥config

custom-reception

fileevent¥config

サブディレクトリtemplatesの配下を除くすべてのファイル

http¥config¥any-response

すべてのファイル

kafka¥config

サブディレクトリtemplatesの配下を除くすべてのファイル

schedule¥config

サブディレクトリtemplatesの配下を除くすべてのファイル

schedule¥config¥common

すべてのファイル

inbound-adapter

ftp¥config

次のファイルを除くすべてのファイル

サブディレクトリcommandの配下のファイル

サブディレクトリFTP_Inbound_Resource_Adapterのlog4j.xml

サブディレクトリFTP_Inbound_Resource_Adapterのserverstatus.properties

サブディレクトリtemplateの配下のファイル

ftp¥logs

すべてのファイル

lib

external

各種OSSのjarファイル

log

すべてのファイル

repository

すべてのファイル

spool

Command

すべてのファイル

fileevent

すべてのファイル

ftp

すべてのファイル

userlib

codetables

すべてのファイル

customfunc

すべてのファイル

注※1

Windows版の場合，Service Coordinator 01-50以前のバージョンから，Service Coordinator 01-60以降のバージョンに更新インストールでアップグレードしたあとにアンインストールすると，<サービスプラットフォームのインストールディレクトリ>¥CSC¥config¥msg¥cmdconf.batが削除されます。そのため，アンインストールしたあとで，再度インストールしてシステムを構築する場合は，cmdconf.batに設定した内容を再設定する必要があります。

なお，Service Coordinator 01-60以降のバージョンを新規インストールしたあとにアンインストールした場合は，<サービスプラットフォームのインストールディレクトリ>¥CSC¥config¥msg¥cmdconf.batは削除されません。

注※2

Windowsの場合だけ存在するディレクトリまたはファイルです。

また，上記の表にない次のディレクトリ配下のファイルについては，インストール後に製品によって作成されますが，アンインストール時に削除されます。

<サービスプラットフォームのインストールディレクトリ>¥CSC¥custom-adapter¥OA¥tmp

<サービスプラットフォームのインストールディレクトリ>¥CSC¥DB¥area

<サービスプラットフォームのインストールディレクトリ>¥CSC¥DB¥bats

<サービスプラットフォームのインストールディレクトリ>¥CSC¥monitor¥spool

<サービスプラットフォームのインストールディレクトリ>¥CSC¥spool¥manager

<サービスプラットフォームのインストールディレクトリ>¥CSC¥spool¥migration

<サービスプラットフォームのインストールディレクトリ>¥CSC¥spool¥msg

<サービスプラットフォームのインストールディレクトリ>¥CSC¥system¥msg

(b)　アンインストールする前に行う作業

Service Coordinatorをアンインストールする前に，次の作業を実施する必要があります。

システムのアンセットアップ

システムをアンセットアップします。システムをアンセットアップしないでアンインストールすると，データベースのテーブル，J2EEサーバのJ2EEアプリケーションおよびReliable Messagingのキューが削除されずに残ってしまいます。

システムのアンセットアップ方法については，「3.3　システムのアンセットアップ」を参照してください。

J2EEサーバおよびManagement Serverの停止

J2EEサーバおよびManagement Serverを停止します。

J2EEサーバの停止方法については，マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「11.10.7　J2EEサーバの停止」を参照してください。Management Serverの停止方法については，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「3.1.3　システムを停止する（GUI利用時）」を参照してください。

(2)　Service Platformのアンインストール

Service Platformのアンインストール手順については，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「3.3　システム環境のアンセットアップとApplication Serverのアンインストール」を参照してください。アンインストール上の注意事項については，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「付録I　インストールおよびアンインストールするときの注意事項」を参照してください。なお，アンインストール手順の製品名「Application Server」は，「Service Platform」と読み替えてください。

2.2　システム構成の形態，J2EEサーバの互換モード，およびSOAPモードの選択

サービスプラットフォームのシステムを開発する前に，システムで利用する機能に応じて，J2EEサーバの互換モードおよびSOAPモードなどを明確にする必要があります。

この節では，システムで利用する機能に応じて次の事項を選択します。

データベースとReliable Messagingの使用有無

J2EEサーバの互換モード

SOAPモード

2.2.1　データベースとReliable Messagingの使用有無

サービスプラットフォームのどの機能を使用し，どのような運用をしたいかによって，データベースとReliable Messagingの使用有無が異なります。使用する機能ごとに，データベースとReliable Messagingの使用有無を次の表に示します。

表2‒2　使用したい機能ごとのデータベースとReliable Messagingの使用有無

使用したい機能

データベース

Reliable Messaging

同期受付を使用したい

×

×

非同期受付（標準受付（MDB（WS-R）），標準受付（MDB（DBキュー）））を使用したい

×

×

同期サービスアダプタを使用したい

×

×

非同期サービスアダプタ（MDB（WS-R）アダプタ，MDB（DBキュー）アダプタ）を使用したい

○

○

ビジネスプロセスを使用したい

永続化するビジネスプロセスを使用したい

○

×

永続化しないビジネスプロセスを使用したい※1

×

×

プロセスインスタンスの実行履歴を管理したい※2

○

×

DBアダプタを使用したい

×※3

×

（凡例）

○：必須です。

×：必須ではありません。

注※1

永続化しないビジネスプロセスを使用する場合，開発環境で定義できるプロセスに制限があるため注意してください。詳細は，マニュアル「サービスプラットフォーム 解説」の「3.3　永続化するビジネスプロセスと永続化しないビジネスプロセス」を参照してください。

注※2

テーブル分割機能の使用有無，分割構成，使用するデータベースを検討する必要があります。検討事項については，「(1) テーブル分割機能の使用有無」を参照してください。

注※3

DBアダプタを使用する場合，HCSCサーバが稼働しているマシン上にデータベースは不要です。しかし，DBアダプタから接続するサービス稼働マシンでは，データベースが必要になります。

この表から，データベースとReliable Messagingの使用有無による構成形態は，次の3つのパターンがあることがわかります。

データベースとReliable Messagingの両方を使用する

データベースとReliable Messagingの両方を使用しない

データベースを使用してReliable Messagingを使用しない

それぞれパターンによって，システム構築時の実行環境に関する設定内容などが異なります。各パターンでの実行環境の設定内容については，「2.3　実行環境に関する設定」を参照してください。

なお，データベースとReliable Messagingの使用有無の設定は，HCSCサーバセットアップ定義ファイルで定義します。また，データベースを使用しない場合はデータベースの設定が不要で，Reliable Messagingを使用しない場合はReliable Messagingの設定が不要です。

注意事項

実行環境または運用環境でアクセスする次のディレクトリおよびファイルには，適切にアクセス権を付与してください。

サービスプラットフォームのインストールディレクトリ

コマンドの引数で指定するディレクトリおよびファイル

HCSCで使用する各種定義ファイルに指定するディレクトリおよびファイル

(1)　テーブル分割機能の使用有無

プロセスインスタンスの実行履歴を管理する場合，サービスプラットフォームでシステムを構築する前に，テーブル分割機能の使用有無と分割構成を明確にし，使用するデータベースを検討する必要があります。

ここでは，テーブル分割機能に関する検討事項を説明します。テーブル分割機能の詳細については，マニュアル「サービスプラットフォーム 解説」の「7.3　HiRDBと連携した実行履歴の管理」を参照してください。

(a)　テーブル分割機能の使用方法の検討

テーブル分割機能と，使用するデータベースの関係を次の表に示します。

表2‒3　テーブル分割機能と使用するデータベースの関係

テーブル分割機能の使用方法

HiRDB Server

その他のDBMS

HiRDB/Single Server

HiRDB/Parallel Server

日付データ（月）で分割する場合

○

○

×

日付データ（月）で分割し，さらに複数のサーバに分散して管理する場合

×

○※

×

テーブル分割機能を使用しない場合

○

○

○

（凡例）

○：実行できます。

×：実行できません。

注※

使用するにはHiRDB Advanced High Availabilityが必要です。

(b)　テーブルの分割構成の検討

テーブル分割機能を使用する場合は，次の点を基に1か月当たりのデータ量（見込み値）を検討し，分割構成を決めてください。

バックエンドサーバを何台使うか

何か月分のデータをまとめて扱うか

何か月単位で循環させるか（何か月分のデータをデータベースに残すか）

(c)　HCSCサーバのセットアップ

テーブル分割機能を利用する場合は，HCSCサーバセットアップ定義ファイルで次のように定義する必要があります。

db-tbl-split-key=MONTH
db-tbl-split-corcheck-use=ON
sql-scriptfilename=テーブル分割を定義したSQLスクリプトファイルのパス※

注※

クラスタ内で1台目のHCSCサーバをセットアップする際に必要な定義です。

1台目のHCSCサーバセットアップ時にテーブル分割機能の対象となるテーブル，インデクス，およびビュー表の作成が完了するため，2台目以降のHCSCサーバセットアップ時にはSQLスクリプトファイルの設定は必須ではありません。

SQLスクリプトファイルの詳細については，「付録D.2(2)　RDエリア名または表領域名の変更」を参照してください。

HCSCサーバセットアップ定義ファイルの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.4.3　HCSCサーバセットアップ定義ファイル」を参照してください。

2.2.2　J2EEサーバの互換モードの選択

(1)　J2EEサーバの互換モードの種類

J2EEサーバの互換モードには次の2種類があります。サービスプラットフォームでシステムを開発する前に，どちらで運用するか決定してください。

(a)　V9互換モード

Java EE 7以降の新機能に対応しないJ2EEサーバの構成です。V9以前からの互換性を重視する場合に選択してください。JDK 11をインストールした環境だけで選択できます。

なお，V9互換モードを選択した場合は，HTTPアダプタのリダイレクト機能は使用できません。

(b)　推奨モード

Java EE 7以降の新機能に対応するJ2EEサーバの構成です。新規にシステムを構築する場合はこちらを選択してください。JDK 11またはJDK 17をインストールした環境で選択できます。

なお，推奨モードを選択した場合は，SOAPモードのうちSOAP1.1モードは使用できません。

(2)　サポート機能の差異

サービスプラットフォームで使用できる機能は，J2EEサーバの互換モードによって一部異なります。使用可否が異なる機能を次の表に示します。

表2‒4　J2EEサーバの互換モードごとの機能の使用可否

分類

機能名

J2EEサーバの互換モード

V9互換モード

推奨モード

サービスアダプタ

DBアダプタのサポートDBMS

Amazon Aurora MySQL

Amazon Aurora PostgreSQL

×

○

HTTPアダプタのリダイレクト機能

×

○

HTTPアダプタの通信ログ

○

×

（凡例）

○：サポートしています。

×：サポートしていません。

2.2.3　SOAPモードの選択

サービスプラットフォームでシステムを開発する前に，使用するSOAPモードを選択します。

ここでは，SOAPモードの種類と各モードのサポート範囲について説明します。

注意事項

Service Architect 09-71からSOAPモードのデフォルトがSOAP1.1/1.2併用モードに変更になりました。

(1)　SOAPモードの種類

SOAPモードの種類と，対応するWebサービス標準仕様および実行環境を示します。

SOAP1.1モード

SOAP1.1に対応したシステムを開発する場合に選択します。JDK 11をインストールした環境だけで選択できます。

次の仕様を備えています。

WS-I Basic Profile1.0aに対応しています。

SOAPメッセージの送受信にSOAP通信基盤を使用します。

なお，J2EEサーバの互換モードが推奨モードの場合は，SOAP1.1モードを使用できません。

SOAP1.1/1.2併用モード

SOAP1.1またはSOAP1.2に対応したシステムを開発する場合に選択します。JDK 11またはJDK 17をインストールした環境で選択できます。

次の仕様を備えています。

WS-I Basic Profile1.1に対応しています。

WS-I Attachments Profile -Version 1.0で規定されたwsi:swaRef形式の添付ファイルに対応しています。

SOAPメッセージの送受信にJAX-WSエンジンを使用します。

(2)　SOAPモードのサポート範囲

受付およびサービスアダプタの機能とSOAPモードの対応を次の表に示します。

表2‒5　SOAPモードのサポート範囲（受付およびサービスアダプタの機能）

分類

機能名

SOAPモード

1.1

1.1/1.2併用

受付

標準受付（Webサービス（SOAP1.1））

○

○

標準受付（Webサービス（SOAP1.2））

×

○

標準受付（SessionBean）

○

○

標準受付（MDB（WS-R））

○

×

標準受付（MDB（DBキュー））

○

○

ユーザ定義受付

○

○

サービスアダプタ

SOAPアダプタ

○

○

SessionBeanアダプタ

○

×

MDB（WS-R）アダプタ

○

×

MDB（DBキュー）アダプタ

○

○

DBアダプタ

○

○

TP1アダプタ

○

○

ファイルアダプタ

○

○

Object Accessアダプタ

○

○

Message Queueアダプタ

○

○

FTPアダプタ

○

○

ファイル操作アダプタ

○

○

メールアダプタ

○

○

HTTPアダプタ

×

○

コマンドアダプタ

○

○

SFTPアダプタ

○

○

Kafkaアダプタ

○

○

gRPCアダプタ

○

○

汎用カスタムアダプタ

○

○

ビジネスプロセス

○

○

（凡例）

○：サポートしています。

×：サポートしていません。

WSDL定義のスタイルとSOAPモードの対応を次の表に示します。

表2‒6　SOAPモードのサポート範囲（WSDL定義のスタイル）

SOAPのバージョン

WSDL定義のスタイル

SOAPモード

1.1

1.1/1.2併用

SOAP1.1

rpc/literal

○

×

document/literal

○

○

SOAP1.2

rpc/literal

×

×

document/literal

×

○

（凡例）

○：サポートしています。

×：サポートしていません。

(3)　実行環境へのSOAPモードの設定

選択したSOAPモードに応じて，システムのセットアップ時にJ2EEサーバのコンテナ拡張ライブラリの設定が必要になります。J2EEサーバのコンテナ拡張ライブラリの設定については，「3.1.2(4)(e)　コンテナ拡張ライブラリの設定」を参照してください。

2.3　実行環境に関する設定

実行環境に関する設定には次の種類があります。設定内容はデータベースとReliable Messagingの使用有無によって異なります。

HCSCサーバ構成定義ファイルの設定

HCSCサーバセットアップ定義ファイルの設定

HCSCサーバランタイム定義ファイルの設定

ユーザ定義受付ランタイム定義ファイルの設定

データベースの設定

カスタムファンクションで使用するjarファイルの格納

J2EEサーバ用ユーザプロパティファイル（usrconf.properties）の設定

2.3.1　HCSCサーバ構成定義ファイルを設定する

HCSCサーバの構成定義時に必要な情報は，HCSCサーバ構成定義ファイルに定義します。

(1)　HCSCサーバ構成定義ファイルの作成

HCSCサーバの構成定義情報の設定は，XML形式のHCSCサーバ構成定義ファイルとして，次に示すディレクトリに格納されているサンプルファイルを利用して作成します。

<サービスプラットフォームのインストールディレクトリ>¥CSC¥config¥manager¥templates¥cscsvsetup.xml

定義したファイルは，HCSCサーバのセットアップ時に使用します。HCSCサーバのセットアップについては「3.1.3　HCSCサーバをセットアップする」を参照してください。

このファイルには，ユーザIDやパスワードなどの情報が含まれるため，アクセス権を設定して管理する必要があります。

(2)　設定できる要素

HCSCサーバ構成定義ファイルに設定できる要素を次の表に示します。

表2‒7　HCSCサーバ構成定義ファイルに設定できる要素

分類

使用するタグ名

要素

指定可否

データベースを使用してReliable Messagingを使用しない場合

データベースとReliable Messagingの両方を使用する場合

データベースとReliable Messagingの両方を使用しない場合

clusterの定義※1

name

クラスタ名

○

○

○

type※1

クラスタ種別（LBまたはHA）

○

○

○

managerの定義

name

Manager名

○

○

○

ip-address※2

ManagerのIPアドレス

○

○

○

port※2

Managerのリモート管理機能への外部接続ポート番号

○

○

○

id

Management Serverの管理ユーザID

○

○

○

password※1

Management Serverの管理ユーザパスワード

○

○

○

csc-serverの定義

name

HCSCサーバ名

○

○

○

id

HCSCサーバが使用するデータベースのユーザID

○

○

×

password

HCSCサーバが使用するデータベースのパスワード

○

○

×

j2ee-server-name

HCSCサーバが使用するJ2EEサーバ名

○

○

○

setup-properties

HCSCサーバセットアップ定義ファイル名

○

○

○

soap-receptionの定義※1

ip-address※1※2

WebサーバのIPアドレス

○

○

○

port※2

Webサーバのポート番号

○

○

○

protocol※2

プロトコル種別（httpまたはhttps）

○

○

○

jms-receptionの定義※1※3

ip-address※1※2

WebサーバのIPアドレス

×

○

×

port※2

Webサーバのポート番号

×

○

×

protocol※2

プロトコル種別（httpまたはhttps）

×

○

×

rm-service-context-root※2

Reliable Messagingのサービスコンテキストルート

×

○

×

jms-physical-receptionの定義※1※4

ip-address※1※2

WebサーバのIPアドレス

×

○

×

port※2

Webサーバのポート番号

×

○

×

protocol※2

プロトコル種別（httpまたはhttps）

×

○

×

rm-service-context-root※2

Reliable Messagingのサービスコンテキストルート

×

○

×

ejb-receptionの定義※1

ip-address※1※2

NameServerのIPアドレス

○

○

○

port※2

NameServerのポート番号

○

○

○

（凡例）

○：指定できます。

×：指定できません。

注※1

省略できます。

注※2

2回目以降設定を変えて再セットアップすると，値が上書きされます。

注※3

クラスタ種別が「HA」の場合に設定します。クラスタ種別が「LB」の場合は，設定しても無視されます。

注※4

クラスタ種別が「LB」の場合に設定します。クラスタ種別が「HA」の場合は，設定しても無視されます。

HCSCサーバ構成定義ファイルの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.4.2　HCSCサーバ構成定義ファイル」を参照してください。

2.3.2　HCSCサーバセットアップ定義ファイルを設定する

各HCSCサーバのセットアップ時に必要な情報は，HCSCサーバセットアップ定義ファイルに定義します。

(1)　HCSCサーバセットアップ定義ファイルの作成

HCSCサーバのセットアップ情報の設定は，J2SEのプロパティ形式のHCSCサーバセットアップ定義ファイルとして，次に示すディレクトリに格納されているサンプルファイルを利用して作成します。

<サービスプラットフォームのインストールディレクトリ>¥CSC¥config¥manager¥templates¥cscsvsetup.properties

(2)　設定できるプロパティ

HCSCサーバセットアップ定義ファイルに定義するプロパティを次に示します。

表2‒8　HCSCサーバセットアップ定義ファイルに定義するプロパティ

分類

プロパティ名

内容

指定可否

データベースを使用してReliable Messagingを使用しない場合

データベースとReliable Messagingの両方を使用する場合

データベースとReliable Messagingの両方を使用しない場合

セットアップ構成関連

db-use

データベースの使用有無

ONを設定，またはプロパティを省略

ONを設定，またはプロパティを省略

OFFを設定

rm-use

Reliable Messagingの使用有無

OFFを設定

ONを設定，またはプロパティを省略

OFFを設定

hcscserver-data-filepath

HCSCサーバのシステム管理情報の出力先

○

○

○

標準受付関連

request-ejb

標準の同期受付（SessionBean）の使用有無

○

○

○

request-soap

標準の同期受付（Webサービス）の使用有無

○

○

○

request-jms

標準の非同期受付（MDB（WS-R））の使用有無

OFFを設定

○

OFFを設定

request-jms.maxmessage

標準の非同期受付（MDB（WS-R））のキューの最大メッセージ数

×

○

×

request-dbq

標準の非同期受付（MDB（DBキュー））の使用有無

OFFを設定

○

OFFを設定

request-dbq.maxmessage

標準の非同期受付（MDB（DBキュー））のキューの最大メッセージ数

×

○

×

request-jms-rdarea

標準の非同期受付（MDB（WS-R））のRDエリア名

×

○

×

request-dbq-rdarea

標準の非同期受付（MDB（DBキュー））のRDエリア名

×

○

×

request-dbq-maxlen

標準の非同期受付（MDB（DBキュー））の最大メッセージ長

×

○

×

ユーザ定義受付関連

request-userdef-soap

SOAPユーザ定義受付の使用有無

○

○

○

J2EE関連

naming-service-hostname

ネーミングサービスのホスト名

○

○

○

naming-service-port

ネーミングサービスのポート番号

○

○

○

Reliable Messaging関連

rm-systemname

Reliable Messagingのシステム名

×

○

×

rm-displayname

Reliable Messagingの表示名

×

○

×

DBコネクタ関連

dbcon-xadisplayname

XATransaction用またはLocalTransaction用のDB Connectorの表示名

○

○

×

dbcon-nodisplayname

NoTransaction用DB Connectorの表示名

○

○

×

データベース関連

dbtype

使用するデータベース種別

○

○

×

jdbc-type

JDBCドライバ種別

○

○

×

jdbc-url

JDBC用データベースURL

○

○

×

jdbc-dbhostname

データベースのホスト名

○

○

×

jdbc-dbconnectinfo

データベースの接続情報

○

○

×

db-character-sets

データベース文字コード種別

○

○

×

db-tbl-split-key

日付データによるテーブルのレンジ分割機能の使用有無

○

○

×

db-tbl-split-corcheck-use

相関セットの重複チェック強化の有無

○

○

×

ビジネスプロセスの状態の互換性

bp-status-compatible

ビジネスプロセスの状態の互換性の使用有無

○

○

○

サービス呼出アクティビティの状態の互換性

bp-invoke-status-compatible

サービス呼出アクティビティの状態の互換性有無

○

○

○

データベースのRDエリア（表領域）情報

cscserverinfo-tbl-area

HCSC基本情報用テーブル領域

○

○

×

server-trans-tbl-area

連携HCSC用テーブル領域

○

○

×

location-tbl-area

ロケーション用テーブル領域

○

○

×

routing-tbl-area

ルーティング用テーブル領域

○

○

×

cv-tbl-area

データ変換用テーブル領域

○

○

×

exehistory-tbl-area

実行履歴情報テーブル領域

○

○

×

exehistory-idx-area

実行履歴情報テーブルのインデクスを格納する領域

○

○

×

process-tbl-area

ビジネスプロセス基盤用PROCESSテーブルを格納する領域

○

○

×

process-idx-area

ビジネスプロセス基盤用PROCESSテーブルのインデクスを格納する領域

○

○

×

activity-tbl-area

ビジネスプロセス基盤用ACTIVITYテーブルを格納する領域

○

○

×

activity-idx-area

ビジネスプロセス基盤用ACTIVITYテーブルのインデクスを格納する領域

○

○

×

link-tbl-area

ビジネスプロセス基盤用LINKテーブルを格納する領域

○

○

×

link-idx-area

ビジネスプロセス基盤用LINKテーブルのインデクスを格納する領域

○

○

×

correlationset-tbl-area

ビジネスプロセス基盤用CORRELATIONSETテーブルを格納する領域

○

○

×

correlationset-idx-area

ビジネスプロセス基盤用CORRELATIONSETテーブルのインデクスを格納する領域

○

○

×

string-variable-tbl-area

ビジネスプロセス基盤用STRING-VARIABLEテーブルを格納する領域

○

○

×

string-variable-idx-area

ビジネスプロセス基盤用STRING-VARIABLEテーブルのインデクスを格納する領域

○

○

×

numeric-variable-tbl-area

ビジネスプロセス基盤用NUMERIC-VARIABLEテーブルを格納する領域

○

○

×

numeric-variable-idx-area

ビジネスプロセス基盤用NUMERIC-VARIABLEテーブルのインデクスを格納する領域

○

○

×

boolean-variable-tbl-area

ビジネスプロセス基盤用BOOLEAN-VARIABLEテーブルを格納する領域

○

○

×

boolean-variable-idx-area

ビジネスプロセス基盤用BOOLEAN-VARIABLEテーブルのインデクスを格納する領域

○

○

×

message-variable-tbl-area

ビジネスプロセス基盤用MESSAGE-VARIABLEテーブルを格納する領域

○

○

×

message-variable-idx-area

ビジネスプロセス基盤用MESSAGE-VARIABLEテーブルのインデクスを格納する領域

○

○

×

message-variable-val-area

ビジネスプロセス基盤用MESSAGE-VARIABLEテーブルのVariableValue列を格納する領域

○

○

×

message-relation-tbl-area

ビジネスプロセス基盤用MESSAGE-RELATIONテーブルを格納する領域

○

○

×

message-relation-idx-area

ビジネスプロセス基盤用MESSAGE-RELATIONテーブルのインデクスを格納する領域

○

○

×

clusterinfo-tbl-area

クラスタ情報を格納する領域

○

○

×

haasyncadp-tbl-area

クラスタ内で配備された非同期アダプタサービスIDを格納する領域

○

○

×

sql-scriptfilename

SQLスクリプトファイルパス

○

○

×

アクティビティインスタンスの最大数の互換性

activitynumber-maximum-compatible

1つのプロセスインスタンスで生成できるアクティビティインスタンスの最大数の互換性の使用有無

○

○

○

XML解析

xmlanalyze-mode

XMLの解析モード

○

○

○

（凡例）

○：指定できます。

×：指定できません。

HCSCサーバセットアップ定義ファイルの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.4.3　HCSCサーバセットアップ定義ファイル」を参照してください。

2.3.3　HCSCサーバランタイム定義ファイルを設定する

HCSCサーバの起動時に必要なランタイム情報は，HCSCサーバランタイム定義ファイルに定義します。

(1)　HCSCサーバランタイム定義ファイルの作成

HCSCサーバのランタイム定義は，HCSCサーバランタイム定義ファイルとして，次に示すディレクトリに格納されているサンプルファイルを利用して作成します。このファイルは，J2SEのプロパティファイル形式で作成します。

<サービスプラットフォームのインストールディレクトリ>¥CSC¥config¥manager¥templates¥cscsvconfig.properties

このファイルはHCSCサーバの定義情報を設定するときに使用します。HCSCサーバの定義については「3.1.4　HCSCサーバの定義情報を設定する」を参照してください。

(2)　設定できるプロパティ

HCSCサーバランタイム定義ファイルに定義するプロパティを次に示します。

表2‒9　HCSCサーバランタイム定義ファイルに定義するプロパティ

分類

プロパティ名

内容

指定可否

データベースを使用してReliable Messagingを使用しない場合

データベースとReliable Messagingの両方を使用する場合

データベースとReliable Messagingの両方を使用しない場合

ログトレース

methodtrace-filepath

メソッドトレース・例外ログ出力先パス

○

○

○

methodtrace-filenum

メソッドトレースの最大面数

○

○

○

methodtrace-filesize

メソッドトレースファイル1面当たりの最大サイズ

○

○

○

methodtrace-level

メソッドトレースの出力レベル

○

○

○

requesttrace

リクエストトレースの採取の有無

○

○

○

requesttrace-filepath

リクエストトレース出力先パス

○

○

○

requesttrace-filenum

リクエストトレースの最大面数

○

○

○

requesttrace-filesize

リクエストトレースファイル1面当たりの最大サイズ

○

○

○

telegramtrace

ユーザ電文トレースの採取の有無

○

○

○

telegramtrace-filepath

ユーザ電文トレース出力先パス

○

○

○

telegramtrace-filenum

ユーザ電文トレースの最大面数

○

○

○

telegramtrace-filesize

ユーザ電文トレースファイル1面当たりの最大サイズ

○

○

○

telegramtrace-trigger

ユーザ電文トレースの出力契機

○

○

○

telegramtrace-component-type-filepath

ユーザ電文トレースのコンポーネント種別設定ファイルのパス

○

○

○

telegramtrace-component-id-filepath

ユーザ電文トレースのコンポーネントID設定ファイルのパス

○

○

○

telegramtrace-format

ユーザ電文トレースの出力形式

○

○

○

bpacttrace

ビジネスプロセスのアクティビティトレースの採取の有無

○

○

○

bpacttrace-filenum

ビジネスプロセスのアクティビティトレースの最大面数

○

○

○

bpacttrace-filesize

ビジネスプロセスのアクティビティトレースファイル1面当たりの最大サイズ

○

○

○

bpacttrace-extend-item

ビジネスプロセスのアクティビティトレースの追加出力項目

○

○

○

bptrace-level

ビジネスプロセス基盤のメソッドトレースの出力レベル

○

○

○

bptrace-filenum

ビジネスプロセス基盤のメソッドトレースの面数

○

○

○

bptrace-filesize

ビジネスプロセス基盤のメソッドトレースのサイズ

○

○

○

bpexptrace-filenum

ビジネスプロセス基盤の例外ログの面数

○

○

○

bpexptrace-filesize

ビジネスプロセス基盤の例外ログファイルのサイズ

○

○

○

cscexptrace-filenum

メッセージング基盤の例外ログの面数

○

○

○

cscexptrace-filesize

メッセージング基盤の例外ログファイルのサイズ

○

○

○

kafka-protocoltrace-enabled

Kafkaプロトコルトレースの採取有無

○

○

○

kafka-protocoltrace-level

Kafkaプロトコルトレースの出力レベル

○

○

○

kafka-protocoltrace-filenum

Kafkaプロトコルトレース面数

○

○

○

kafka-protocoltrace-filesize

Kafkaプロトコルトレースファイルサイズ

○

○

○

grpc-transporttrace-enabled

gRPC通信ログ機能を有効にするか

○

○

○

grpc-transporttrace-level

gRPC通信ログの出力レベル

○

○

○

grpc-transporttrace-filenum

gRPC通信ログの最大面数

○

○

○

grpc-transporttrace-filesize

gRPC通信ログの1面当たりのファイルサイズ

○

○

○

標準受付関連

request-ejb.instance.minimum

標準の同期受付（SessionBean）のインスタンス最小数

○

○

○

request-ejb.instance.maximum

標準の同期受付（SessionBean）のインスタンス最大数

○

○

○

request-ejb.ctm

CTM連携の使用有無

○

○

○

request-ejb.parallel.count

CTMがアプリケーションを呼び出すために用意するスレッド数

○

○

○

request-ejb.optional.name

標準の同期受付（SessionBean）の別名

○

○

○

request-soap.instance.minimum

標準の同期受付（Webサービス・SOAP1.1）の最小同時実行数

○

○

○

request-soap.instance.maximum

標準の同期受付（Webサービス・SOAP1.1）の最大同時実行数

○

○

○

request-soap.exclusive.threads

標準の同期受付（Webサービス・SOAP1.1）の占有スレッド数

○

○

○

request-soap.queue-size

標準の同期受付（Webサービス・SOAP1.1）の実行待ちキューのサイズ

○

○

○

request-soap1_2.instance.minimum

標準の同期受付（Webサービス・SOAP1.2）の最小同時実行数

○

○

○

request-soap1_2.instance.maximum

標準の同期受付（Webサービス・SOAP1.2）の最大同時実行数

○

○

○

request-soap1_2.exclusive.threads

標準の同期受付（Webサービス・SOAP1.2）の占有スレッド数

○

○

○

request-soap1_2.queue-size

標準の同期受付（Webサービス・SOAP1.2）の実行待ちキューのサイズ

○

○

○

request-jms.instance.maximum

標準の非同期受付（MDB（WS-R））のインスタンス最大数

×

○

×

request-jms.rollback-count

標準の非同期受付（MDB（WS-R））のロールバック警告メッセージ出力回数

×

○

×

receptionstop-monitor-timer

受付キュー監視のタイムアウト時間

×

○

×

csc-receptionstop-timeout

受付終了待ちの通信タイムアウト時間

○

○

○

サービスアダプタ関連

soapfault-targetnamespace-filepath

SOAP Faultをユーザ定義例外として扱うかどうか

○

○

○

soapfault-handling-mode

SOAP Faultを含む電文を受信したときのFault判別処理の動作モードの選択

○

○

○

oa-adapter-character-code

Object Accessアダプタがサービス部品と送受信する電文の文字コード

○

○

○

データ変換関連

formatdef-maxcache-num

フォーマット定義をキャッシュできる数

○

○

○

transformdef-maxcache-num

データ変換定義をキャッシュできる数

○

○

○

xmltelegram-maxcache-num

XML電文をキャッシュできる数

○

○

○

telegram-validation

電文フォーマットに対して，送受信する電文が適切かを検証するかどうか

○※

○※

○

xmltelegram-namespace-complement

XML電文内の属性値に指定された名前空間接頭辞に対応した名前空間宣言を補完するかどうか

○

○

○

telegram-undefined-character-code

バイナリデータの文字コード変換処理で，未定義の文字コードが検出された場合に処理を継続するかどうか

○

○

○

telegram-notfound-soapheader

ビジネスプロセスで定義したヘッダ割当変数に該当するデータが，送受信する電文に含まれない場合に処理を継続するかどうか

○

○

○

validation-activity

検証アクティビティで，メッセージ型変数（XML）を検証するかどうか

○

○

○

transform-binary-error-check

バイナリデータ変換時にエラーチェックをするかどうか

○

○

○

code-table-root-path

コード変換テーブル格納パスのルートパスの絶対パス

○

○

○

ビジネスプロセス関連

syserr-to-fault-convert

次に示すアクティビティでシステム例外が発生した場合に，汎用フォルトを発生させるかどうか

データ変換アクティビティ

代入アクティビティ

分岐アクティビティ

○

○

○

syserr-to-fault-convert-all-activity

汎用フォルトが発生するアクティビティのどれかでシステム例外が発生した場合に，汎用フォルトを発生させるかどうか

○

○

○

validate-fault-compatible

検証フォルトで送られるフォルト電文のフォーマットを09-00以前まで使用していたフォーマットとするかどうか

○

○

○

bp-reply-after-min-thread-pool-size

応答アクティビティ後のアクティビティを実行するために使用するスレッドの最小数

○

○

○

bp-reply-after-max-thread-pool-size

応答アクティビティ後のアクティビティを実行するために使用するスレッドの最大数

○

○

○

bp-reply-after-thread-pool-keep-alive

応答アクティビティ後のアクティビティを実行するために使用するスレッドの保持時間

○

○

○

service-emulate.enable

サービスエミュレーションの実行可否

○

○

○

service-emulate-def-filepath

エミュレート設定情報定義ファイルの絶対パス

○

○

○

bp-log-activity-definition-filepath

ログ出力アクティビティ定義ファイルの絶対パス

○

○

○

J2EE関連

j2ee-stopapp-timeout

J2EEアプリケーション停止時の監視時間

○

○

○

startcsc-timeout

J2EEサーバ起動時の監視時間

○

○

○

stopcsc-timeout

J2EEサーバ停止時の監視時間

○

○

○

コマンドの通信のタイムアウト時間の監視

csc-command-timeout

コマンドの通信タイムアウト時間

○

○

○

csc-precache-timeout

事前キャッシュ処理のためのビジネスプロセスへのEJB通信のタイムアウト

○

○

○

Cookie情報の引き継ぎ

cookie-parsing

Cookieを引き継ぐかどうか

○

○

○

フォルダ関連

work-folder

作業フォルダルートの絶対パス

○

○

○

common-folder-<共通フォルダ定義名>

共通フォルダの絶対パス

○

○

○

definition-file-base-path

実行環境の独自定義ファイルの格納先ディレクトリの絶対パス

○

○

○

DBアダプタ関連

dba-separate-transaction

ビジネスプロセスとは別にDBアダプタのトランザクションを開始するかどうか

○

○

○

コンポーネント共通UOC関連

common-uoc-prop-path

コンポーネント共通UOC用プロパティファイル格納フォルダ

○

○

○

HCSCサーバ関連

short-processid-servername

プロセスインスタンスの識別子で使用するHCSCサーバ名の識別子

○

○

○

short-processid

プロセスインスタンスの識別子を短縮するかどうか

○

○

○

インスタンスのプール

xml-pooled-instance-minimum

XML処理に使用するクラスのインスタンスプールの最小数

○

○

○

xml-pooled-instance-maximum

XML処理に使用するクラスのインスタンスプールの最大数

○

○

○

カスタム受付関連

request-id-separate-key

リクエストIDの分割キー変更

○

○

○

ファイルイベント連携関連

fileevent-reception.monitored-file.enabled

ファイル監視機能を有効にするかどうか

○

○

○

fileevent-reception.monitored-folder

監視フォルダのパス

○

○

○

fileevent-reception.monitor-interval

ファイル監視の間隔

○

○

○

fileevent-reception.monitor-starting.delay

ファイル監視の待ち時間

○

○

○

（凡例）

○：指定できます。

×：指定できません。

注※

07-60以降でtelegram-validationプロパティを「ON」にすると，電文フォーマットに対して送受信する電文が適切かどうかを検証します。次の場合は，今までサービス呼び出しに成功していた電文がサービスアダプタでエラーになることがあるため，注意してください。

07-50以前から07-60以降にバージョンアップしたあと，telegram-validationプロパティに「ON」を設定した場合

07-60以降でtelegram-validationプロパティを「OFF」から「ON」に設定し直した場合

07-50以前の場合，または07-60以降でtelegram-validationプロパティに「OFF」を設定した場合は，電文フォーマットに対して，送受信する電文が適切かどうかを検証しません。

HCSCサーバランタイム定義ファイルの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.5.6　HCSCサーバランタイム定義ファイル」を参照してください。

2.3.4　ユーザ定義受付ランタイム定義ファイルを設定する

SOAP受付の情報は，ユーザ定義受付ランタイム定義ファイルに設定します。

(1)　ユーザ定義受付ランタイム定義ファイルの作成

SOAP受付のランタイム定義は，ユーザ定義受付ランタイム定義ファイルとして，次に示すディレクトリに格納されているサンプルファイルを利用して作成します。このファイルは，J2SEのプロパティファイル形式で作成します。

<サービスプラットフォームのインストールディレクトリ>¥CSC¥config¥manager¥templates¥cscurcptnconfig.properties

ユーザ定義受付ランタイム定義ファイルを作成したあと，csccompoconfigコマンドで定義情報を設定します。SOAP受付の定義情報の設定については，「3.1.15　ユーザ定義受付の定義情報を設定する」を参照してください。

このファイルはSOAP受付を配備するときに使用します。SOAP受付を含むユーザ定義受付の配備については，「3.1.14　ユーザ定義受付を配備する」を参照してください。

(2)　設定できるプロパティ

ユーザ定義受付ランタイム定義ファイルに定義するプロパティを次に示します。

表2‒10　ユーザ定義受付ランタイム定義ファイルに定義するプロパティ

プロパティ名

内容

指定可否

データベースを使用してReliable Messagingを使用しない場合

データベースとReliable Messagingの両方を使用する場合

データベースとReliable Messagingの両方を使用しない場合

user-defined-reception-soap.threads.maximum

SOAP受付の最大同時実行数

○

○

○

user-defined-reception-soap.exclusive.threads

SOAP受付の占有スレッド数

○

○

○

user-defined-reception-soap.queue-size

SOAP受付の実行待ちキューのサイズ

○

○

○

（凡例）

○：指定できます。

ユーザ定義受付ランタイム定義ファイルの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.6.2　ユーザ定義受付ランタイム定義ファイル」を参照してください。

2.3.5　データベースのテーブル容量を見積もる

実行履歴の管理や実行環境の設定をする場合，あらかじめデータベースのテーブル容量を見積もる必要があります。データベースを使用しない場合は設定不要です。

(1)　プロセスインスタンスの実行履歴の管理に関するテーブル容量の見積もり

プロセスインスタンスの実行履歴の管理に関するデータベースのテーブルの一覧を次の表に示します。

表2‒11　プロセスインスタンスの実行履歴の管理に関するデータベースのテーブルの一覧

分類

テーブル名

説明

基本情報テーブル

CSCBP_<クラスタ名>_PROCESS

プロセスインスタンスの状態を格納します。

CSCBP_<クラスタ名>_ACTIVITY

アクティビティインスタンスの状態を格納します。

CSCBP_<クラスタ名>_LINK

リンクの状態を格納します。

CSCBP_<クラスタ名>_CORRELATIONSET

相関セットの値を格納します。

変数情報テーブル

CSCBP_<クラスタ名>_STR_VARIABLE

string型の変数値を格納します。

CSCBP_<クラスタ名>_NUM_VARIABLE

numeric型の変数値を格納します。

CSCBP_<クラスタ名>_BOOL_VARIABLE

boolean型の変数値を格納します。

CSCBP_<クラスタ名>_MSG_VARIABLE

メッセージ型の変数値（XML，non-XML，any）を格納します。

メッセージ履歴関連づけ情報テーブル

CSCBP_<クラスタ名>_MSG_RELATION

メッセージID，およびプロセスインスタンス識別子またはアクティビティインスタンス識別番号の関連づけ情報を格納します。

データベース設計時には，次に示す情報を基に，各種データベースのマニュアルを参考に容量を見積もります。

(a)　テーブルおよびインデクス定義

テーブルおよびインデクス定義の詳細については，「付録C.1　プロセスインスタンスの実行履歴の管理に関するテーブルの情報」を参照してください。

(b)　レコード数の概算式

レコード数の概算は，テーブルごとに次のように計算します。

CSCBP_<クラスタ名>_PROCESSテーブル

CSCBP_<クラスタ名>_ACTIVITYテーブル

アクティビティ数＝{ビジネスプロセス定義中のアクティビティ定義数

＋繰り返しアクティビティ中のアクティビティ定義数

×（繰り返しアクティビティのループ回数−1）}

×プロセス数

CSCBP_<クラスタ名>_LINKテーブル

リンク数＝{ビジネスプロセス定義中のリンク定義数＋繰り返しアクティビティ中のリンク定義数

　　　×（繰り返しアクティビティのループ回数−1）}

　　　×プロセス数

CSCBP_<クラスタ名>_CORRELATIONSETテーブル

CSCBP_<クラスタ名>_STR_VARIABLEテーブル

CSCBP_<クラスタ名>_NUM_VARIABLEテーブル

CSCBP_<クラスタ名>_BOOL_VARIABLEテーブル

CSCBP_<クラスタ名>_MSG_VARIABLEテーブル

CSCBP_<クラスタ名>_MSG_RELATIONテーブル

メッセージ送受信数＝受付アクティビティ定義数

　　　　　　　　　＋サービス呼出アクティビティ定義数

(c)　インデクスの各種概算式

インデクスの各種概算式は，インデクス定義，およびレコード数から導き出します。見積もり式については，使用しているデータベースのマニュアルを参照してください。

(2)　実行環境の設定に関するテーブル容量の見積もり

実行環境の設定に関するデータベースのテーブルの一覧を次の表に示します。

表2‒12　実行環境の設定に関するデータベースのテーブルの一覧

分類

テーブル名

説明

HCSC基本情報テーブル

CSCMSG_S<HCSCサーバ名>_CSC_PERSIST

HCSCサーバの状態を永続化します。

HCSC連携ディレクトリ情報テーブル

CSCMSG_C<クラスタ名>_CSC_CONNECT

このテーブルは使用しません。

ロケーションディレクトリ情報テーブル

CSCMSG_S<HCSCサーバ名>_LC_DIRECTORY

サービスアダプタ，ビジネスプロセス，およびサービスグループのロケーション情報を格納します。

CSCMSG_S<HCSCサーバ名>_LC_BPFORMAT

ビジネスプロセスのフォーマット情報を格納します。

ルーティングルールディレクトリ情報テーブル

CSCMSG_S<HCSCサーバ名>_RT_RULE

サービスのルーティングを行うルール情報を格納します。

データ変換定義ディレクトリ情報テーブル

CSCMSG_S<HCSCサーバ名>_CV_MAPPING

データ変換定義情報を格納します。

CSCMSG_S<HCSCサーバ名>_CV_FORMAT

データ変換を行う電文フォーマット定義情報を格納します。

クラスタ基本情報テーブル

CSCMSG_C<クラスタ名>_CLUSTER

セットアップされたHCSCサーバ名を格納します。

非同期アダプタサービスID管理テーブル

CSCMSG_C<クラスタ名>_HA_ASYNC_ADP

配備された非同期アダプタのサービスIDを格納します。

データベース設計時には，次に示す情報を基に，各種データベースのマニュアルを参考に容量を見積もります。

テーブルおよびインデクス定義

レコード数の概算式

インデクスの各種概算式

(a)　テーブルおよびインデクス定義

テーブルおよびインデクス定義の詳細については，「付録C.3　実行環境の設定に関するテーブルの情報」を参照してください。

(b)　レコード数の概算式

レコード数の概算は，テーブルごとに次のように計算します。

CSCMSG_S<HCSCサーバ名>_CSC_PERSISTテーブル

CSCMSG_C<クラスタ名>_CSC_CONNECTテーブル

CSCMSG_S<HCSCサーバ名>_LC_DIRECTORYテーブル

CSCMSG_S<HCSCサーバ名 >_LC_BPFORMATテーブル

CSCMSG_S<HCSCサーバ名>_RT_RULEテーブル

CSCMSG_S<HCSCサーバ名>_CV_MAPPINGテーブル

CSCMSG_S<HCSCサーバ名>_CV_FORMATテーブル

CSCMSG_C<クラスタ名>_CLUSTERテーブル

CSCMSG_C<クラスタ名>_HA_ASYNC_ADPテーブル

(c)　インデクスの各種概算式

インデクスの各種概算式は，インデクス定義，およびレコード数から導き出します。見積もり式については，使用しているデータベースのマニュアルを参照してください。

2.3.6　データベース（HiRDB）の排他要求数を見積もる

HCSCサーバが使用するデータベースがHiRDBの場合，実行履歴を削除する際の排他要求数を見積もる必要があります。データベースを使用しない場合は設定不要です。

この項では，実行履歴を削除する際の排他要求数の見積もり方法を説明します。なお，見積もった排他要求数は，HiRDBの定義ファイルに定義する必要があります。HiRDBの定義ファイルおよび定義ファイルに定義するオペランドについては，マニュアル「HiRDB システム定義」の排他資源数の見積もりに関する内容を参照してください。

(1)　プロセスインスタンスの実行履歴を削除（cscpideleteコマンド）する際の排他要求数の見積もり

プロセスインスタンスの実行履歴を削除（cscpideleteコマンド）する際の排他要求数の見積もりについて説明します。プロセスインスタンスの実行履歴をcscpideleteコマンドで削除する方法の詳細については，「6.1.4(2)　コマンドによる実行履歴の削除」を参照してください。

見積もり対象

見積もり対象のSQLは，操作系SQLの「DELETE（LOCK TABLEなし，およびインデクスキー値無排他方式の場合）」です。

「DELETE（LOCK TABLEなし，およびインデクスキー値無排他方式の場合）」については，マニュアル「HiRDB システム定義」の排他資源数の見積もりに関する内容を参照してください。

見積もり方法

排他要求数の見積もりでは，すべてのテーブルの排他資源数を計算します。排他資源数は，「表2-13　排他資源数の見積もりに使用する値（プロセスインスタンスの実行履歴をcscpideleteコマンドで削除する場合）」に示した値を使用して計算してください。

計算したら，排他資源数の中で最も大きい排他資源数に余裕値を加算して，排他要求数を見積もってください。

なお，見積もった排他要求数は，HiRDBの定義ファイルに定義します。

排他資源数の見積もり方法，および見積もった排他要求数の設定については，マニュアル「HiRDB システム定義」の排他資源数の見積もりに関する内容，および排他制御に関するオペランドの「pd_lck_pool_size」に関する内容を参照してください。

プロセスインスタンスの実行履歴を削除（cscpideleteコマンド）する際の，排他資源数の見積もりに使用する値を次の表に示します。

表2‒13　排他資源数の見積もりに使用する値（プロセスインスタンスの実行履歴をcscpideleteコマンドで削除する場合）

項番

項目

指定値

A

B

C

D

E

F

G

H

I

1

削除対象RDエリア数

2

2

3

2

2

2

2

4

2

2

削除行数

1

1つのビジネスプロセスに定義したアクティビティの数の最大値

1つのビジネスプロセスに定義したリンクの数の最大値

1つのビジネスプロセスに定義した相関セットの数の最大値

1つのビジネスプロセスに定義したグローバル変数のstring型変数の数の最大値

1つのビジネスプロセスに定義したグローバル変数のnumeric型変数の数の最大値

1つのビジネスプロセスに定義したグローバル変数のboolean型変数の数の最大値

1つのビジネスプロセスに定義したグローバル変数のメッセージ型変数の数の最大値

1つのビジネスプロセスに定義したアクティビティの数の最大値

3

分岐数

1

1

1

1

1

1

1

1

1

4

VARCHAR，NVARCHAR，MVARCHARの256バイト以上の列数

0

0

0

0

0

0

0

0

0

5

1ページに格納できないBINARY型の列数

0

0

0

0

0

0

1

0

0

6

削除したLOBデータ数

−

−

−

−

−

−

−

−

−

7

削除したLOBデータ格納セグメント数

−

−

−

−

−

−

−

−

−

8

データ型プラグインまたはインデクス型プラグイン

−

−

−

−

−

−

−

−

−

9

pd_inner_replica_controlオペランド（UNIX版HiRDBの場合）

−

−

−

−

−

−

−

−

−

10

ルーチン

−

−

−

−

−

−

−

−

−

11

前処理

「表2-14　前処理の排他要求数の見積もりに使用する値（プロセスインスタンスの実行履歴を削除する場合）」を参照してください。

（凡例）

A：CSCBP_<クラスタ名>_PROCESSテーブル

B：CSCBP_<クラスタ名>_ACTIVITYテーブル

C：CSCBP_<クラスタ名>_LINKテーブル

D：CSCBP_<クラスタ名>_CORRELATIONSETテーブル

E：CSCBP_<クラスタ名>_STR_VARIABLEテーブル

F：CSCBP_<クラスタ名>_NUM_VARIABLEテーブル

G：CSCBP_<クラスタ名>_BOOL_VARIABLEテーブル

H：CSCBP_<クラスタ名>_MSG_VARIABLEテーブル

I：CSCBP_<クラスタ名>_MSG_RELATIONテーブル

−：未定義，または未使用の項目です。

前処理の排他要求数の見積もりに使用する値を次の表に示します。前処理の排他要求数については，マニュアル「HiRDB システム定義」を参照してください。

表2‒14　前処理の排他要求数の見積もりに使用する値（プロセスインスタンスの実行履歴を削除する場合）

項番

項目

指定値

A

B

C

D

E

F

G

H

I

1

使用する表数

1

1

1

1

1

1

1

1

1

2

使用するビュー表数

0

1

1

0

1

1

1

1

1

3

列数

8

13

4

8

4

4

4

4

5

4

インデクス数

4

1

1

2

1

1

1

1

3

5

表分割数

−

−

−

−

−

−

−

−

−

6

インデクス分割数

−

−

−

−

−

−

−

−

−

7

ユーザ定義型，または関数の使用

−

−

−

−

−

−

−

−

−

8

最適化情報

−

−

−

−

−

−

−

−

−

9

ビュー表の使用

0

1

1

0

1

1

1

1

0

10

ビュー表を構成する列数

0

14

6

0

7

7

7

7

0

11

LOB列の定義

−

−

−

−

−

−

−

−

−

12

ユーザ定義型の列の定義

−

−

−

−

−

−

−

−

−

13

LOB属性

−

−

−

−

−

−

−

−

−

14

上位型

−

−

−

−

−

−

−

−

−

15

関数の使用

−

−

−

−

−

−

−

−

−

16

プラグインの使用

−

−

−

−

−

−

−

−

−

17

ルーチンの使用

−

−

−

−

−

−

−

−

−

（凡例）

A：CSCBP_<クラスタ名>_PROCESSテーブル

B：CSCBP_<クラスタ名>_ACTIVITYテーブル

C：CSCBP_<クラスタ名>_LINKテーブル

D：CSCBP_<クラスタ名>_CORRELATIONSETテーブル

E：CSCBP_<クラスタ名>_STR_VARIABLEテーブル

F：CSCBP_<クラスタ名>_NUM_VARIABLEテーブル

G：CSCBP_<クラスタ名>_BOOL_VARIABLEテーブル

H：CSCBP_<クラスタ名>_MSG_VARIABLEテーブル

I：CSCBP_<クラスタ名>_MSG_RELATIONテーブル

−：未定義，または未使用の項目です。

(2)　プロセスインスタンスの実行履歴を削除（RDエリア単位）する際の排他要求数の見積もり

プロセスインスタンスの実行履歴を削除（RDエリア単位）する際の排他要求数の見積もりについて説明します。プロセスインスタンスの実行履歴をRDエリア単位で削除する方法の詳細については，「6.1.4(3)　データベース作成ユティリティ（pdload）による実行履歴の削除」を参照してください。

見積もり対象

見積もり対象は，データベース作成ユティリティ（pdload）およびデータベース再編成ユティリティ（pdrorg）です。

データベース作成ユティリティ（pdload）およびデータベース再編成ユティリティ（pdrorg）については，マニュアル「HiRDB システム定義」の排他資源の見積もりに関する説明を参照してください。

見積もり方法

排他資源数は，「表2-15　排他資源数の見積もりに使用する値（プロセスインスタンスの実行履歴をRDエリア単位で削除する場合）」に示した値を使用して計算してください。

計算したら，排他資源数の中で最も大きい排他資源数に余裕値を加算して，排他要求数を見積もってください。

なお，見積もった排他要求数は，HiRDBの定義ファイルに定義します。

プロセスインスタンスの実行履歴を削除（RDエリア単位）する際の，排他資源数の見積もりに使用する値を次の表に示します。

表2‒15　排他資源数の見積もりに使用する値（プロセスインスタンスの実行履歴をRDエリア単位で削除する場合）

項番

項目

指定値

A

B

C

D

E

F

G

H

I

1

表の列数

9

14

5

9

5

5

5

5

6

2

表のインデクス数

4

1

1

2

1

1

1

1

3

3

表の格納RDエリア数

HCSCサーバをセットアップする際のSQLスクリプトファイルの内容に依存します。

4

表格納用RDエリアの使用中セグメント数

pddbstコマンドに-rオプションを指定して実行することで確認できます。pddbstコマンドの詳細については，マニュアル「HiRDB コマンドリファレンス」のデータベース状態解析ユティリティ（pddbst）の記述を参照してください。

5

インデクス格納RDエリアの使用セグメント数

6

LOB用RDエリアの使用セグメント数

−

−

−

−

−

−

−

−

−

7

使用する順序数生成子数

−

−

−

−

−

−

−

−

−

8

使用する順序数生成子格納RDエリアの数

−

−

−

−

−

−

−

−

−

（凡例）

A：CSCBP_<クラスタ名>_PROCESSテーブル

B：CSCBP_<クラスタ名>_ACTIVITYテーブル

C：CSCBP_<クラスタ名>_LINKテーブル

D：CSCBP_<クラスタ名>_CORRELATIONSETテーブル

E：CSCBP_<クラスタ名>_STR_VARIABLEテーブル

F：CSCBP_<クラスタ名>_NUM_VARIABLEテーブル

G：CSCBP_<クラスタ名>_BOOL_VARIABLEテーブル

H：CSCBP_<クラスタ名>_MSG_VARIABLEテーブル

I：CSCBP_<クラスタ名>_MSG_RELATIONテーブル

−：未定義，または未使用の項目です。

2.3.7　データベースの領域への配置を設計する

データベースのテーブル容量の見積もり後，各テーブルおよびインデクスをデータベースの領域（HiRDBの場合はRDエリア，Oracleの場合は表領域（テーブルスペース））にどう配置するかを設計する必要があります。データベースを使用しない場合は設定不要です。

データベースの領域は，HCSCサーバセットアップ定義ファイルのプロパティで配置を設定します。詳細については，「2.3.2(2)　設定できるプロパティ」の「表2-8　HCSCサーバセットアップ定義ファイルに定義するプロパティ」の行「データベースのRDエリア（表領域）情報」を参照してください。

注意事項

テーブルとインデクスのデータベースの領域は，次の内容も考慮して設計してください。

構築後の運用も踏まえたデータ量

業務システムとのバランス

2.3.8　カスタムファンクションで使用するjarファイルを格納する

開発環境で作成したデータ変換定義にカスタムファンクションが含まれる場合，カスタムファンクションで使用するjarファイルを実行環境に格納します。

jarファイルの格納先

<サービスプラットフォームのインストールディレクトリ>¥CSC¥userlib¥customfunc

なお，jarファイルの格納先は変更することもできます。格納先の変更方法については，「2.3.9(3)　カスタムファンクションで使用するjarファイルの格納先を変更する」を参照してください。

実行環境にjarファイルを格納したあとは，J2EEサーバを再起動してください。

2.3.9　J2EEサーバ用ユーザプロパティファイル（usrconf.properties）を設定する

この項では，J2EEサーバ用ユーザプロパティファイル（usrconf.properties）のうち，Service Platformで設定するシステムプロパティについて説明します。

J2EEサーバ用ユーザプロパティファイルの格納先は次のとおりです。

usrconf.propertiesの格納先

<サービスプラットフォームのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥usrconf.properties

ファイルの記述形式については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.3　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」を参照してください。

J2EEサーバ用ユーザプロパティファイルは，J2EEサーバの起動時に読み込まれます。編集したファイルを有効にするには，J2EEサーバを再起動してください。

(1)　コード変換テーブルのパスを設定する

文字コード変換UOCでコード変換のAPIを使用する場合，Code Converterで使用するコード変換テーブルのパスを設定する必要があります。

usrconf.propertiesへの記述形式

csc.dt.codetablepath=<コード変換テーブル格納パスディレクトリ>/table

設定方法については，マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」の「2.7.1　Code Converterによる拡張」のcsc.dt.codetablepathの記載個所を参照してください。

(2)　文字コード変換UOCのクラスを登録する

開発環境で作成した文字コード変換UOCを実行環境で使用するには，クラス名を完全修飾名で登録する必要があります。

usrconf.propertiesへの記述形式

csc.dt.ownCodeConverter.className=<文字コード変換UOCのクラス名>

設定方法については，マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」の「付録H.2　文字コード変換UOCを使用するための設定」を参照してください。

(3)　カスタムファンクションで使用するjarファイルの格納先を変更する

カスタムファンクションで使用するjarファイルの格納先を変更する場合，変更するファイルパスを設定します。デフォルトの格納先を次に示します。

jarファイルの格納先

<サービスプラットフォームのインストールディレクトリ>¥CSC¥userlib¥customfunc

jarファイルの格納先を変更したい場合の記述方法を次に示します。

usrconf.propertiesへの記述形式

csc.dt.customFuncDir=<変更先ディレクトリのパス>

注意事項

jarファイルの格納先としてサービスプラットフォームのインストールディレクトリ配下を指定すると，アンインストール時に削除されるおそれがあるため，インストールディレクトリ配下以外の場所を設定してください。

usrconf.propertiesへの記述例

カスタムファンクションで使用するjarファイルの格納先を「C:¥¥USER¥¥FUNC」に変更する場合の記述例を次に示します。

csc.dt.customFuncDir=C:¥¥USER¥¥FUNC

(4)　値置換えファンクションで使用する変換テーブルを登録する

開発環境で作成したデータ変換定義に値置換えファンクションが含まれる場合，値置換えファンクションで利用する変換テーブルを登録します。

変換テーブルの格納先と文字コードの情報を一組として記述します。複数の変換テーブルについて記述できます。

usrconf.propertiesに記述する内容と形式を次に示します。

　　　:
csc.dt.valueTable.<変換テーブルID>=<変換テーブルのファイルパス>
csc.dt.valueTableSize=<変換テーブルの合計ファイルサイズ>
csc.dt.encodeType.<変換テーブルID>=［MS932|UTF8|UTF16_BIG|UTF16_LITTLE］
　　　:

<変換テーブルID>

変換テーブルIDとして任意の名称を指定します。変換テーブルIDは，開発環境の値置換えダイアログで値置換えファンクションを定義する際，使用する変換テーブルの指定に使用します。

csc.dt.valueTable.<変換テーブルID>=<変換テーブルのファイルパス>

変換テーブルのファイルパスを絶対パスで指定します。

csc.dt.valueTableSize=<変換テーブルの合計ファイルサイズ><<10>>

変換テーブルの合計ファイルサイズ（単位：キロバイト）の上限値を正の整数で指定します。指定範囲は1〜2097151です。指定を省略した場合は，10が仮定されます。

上限値を超えるサイズの変換テーブルを読み込むと，KDEC40730-EをJ2EEサーバのログファイルに出力し，HCSCサーバの起動を中断します。

csc.dt.encodeType.<変換テーブルID>=［MS932|UTF8|UTF16_BIG|UTF16_LITTLE］

変換テーブルに使用している文字コードを指定します。

変換テーブルのファイルに関する注意事項

BOM付きのファイルは使用できません。

(5)　XMLパーサプール機能オプションを使用する

XMLパーサプール機能を使用する場合，必要に応じて初期割り当て数や最大プール数を指定します。

HCSCサーバでは，次に示すJavaのXMLパーサによってXMLを解析しています。

DOMパーサ（javax.xml.DocumentBuilderクラス）

SAXパーサ（org.xml.sax.XMLReaderクラス）

これらのXMLパーサのインスタンスは複数のスレッドで共有できないため，複数のスレッドで同時使用する場合は，スレッドごとにXMLパーサを生成しています。XMLパーサの生成処理は時間を要するため，解析ごとに生成すると性能が劣化します。

XMLパーサプール機能を使用すると，メモリ上に作成されたXMLパーサプールに生成したXMLパーサを保存しておくことができます。XMLパーサプールへ保存したXMLパーサは，システム全体で共有し，再利用できるため，処理の効率向上が図れます。

XMLパーサプール機能の各オプションについて次に説明します。

(a)　DOMパーサプール機能オプション

HCSCサーバで，XMLを解析する場合に使用するDOMパーサのプールオプションを次のように指定します。

表2‒16　DOMパーサプール機能オプション一覧

項番

キー名称

内容

デフォルト値

1

csc.dt.pool.DocumentBuilder.initialSize

DOMパーサプールを作成するときの初期割り当て数を0〜2,147,483,647の整数で指定します。

最初のDOMパーサ生成時に，初期割り当て数分をまとめて作成し，プールに格納します。これによって，以降の生成時間を削減できます。

最大プール数（csc.dt.pool.DocumentBuilder.maxSizeで指定）よりも大きな値を指定した場合，最大プール数で初期化されます。

負の整数または整数以外の文字列を指定した場合はデフォルト値で動作します。

0

2

csc.dt.pool.DocumentBuilder.maxSize

DOMパーサの最大プール数を0〜2,147,483,647の整数で指定します。ここで指定した最大プール数を超えてDOMパーサを使用する場合，他スレッドでの使用が終了するまで，待ち状態となります。

0以下の整数を指定した場合は，プール機能は無効となります。また，整数以外の文字列を指定した場合はデフォルト値で動作します。

64

初期割り当て数（csc.dt.pool.DocumentBuilder.initialSizeで指定）と最大プール数（csc.dt.pool.DocumentBuilder.maxSizeで指定）は，次の関係を満たすよう設定してください。

初期割り当て数 ≦ 最大プール数 ≦ リクエストの最大同時実行数

(b)　SAXパーサプール機能オプション

次の処理で，XMLを解析する場合に使用するSAXパーサのプールオプションを指定します。

ビジネスプロセスの検証アクティビティ処理

データ検証機能（HCSCサーバランタイム定義ファイルでtelegram-validationプロパティにONを指定）

SAXパーサのプールオプションを次に示します。

表2‒17　SAXパーサプール機能オプション一覧

項番

キー名称

内容

デフォルト値

1

csc.dt.pool.XMLReader.initialSize

SAXパーサプールを作成するときの初期割り当て数を0〜2,147,483,647の整数で指定します。

最初のSAXパーサ生成時に，初期割り当て数分をまとめて作成し，プールに格納します。これによって，以降の生成時間を削減できます。

最大プール数（csc.dt.pool.XMLReader.maxSizeで指定）よりも大きな値を指定した場合，最大プール数で初期化されます。

負の整数または整数以外の文字列を指定した場合はデフォルト値で動作します。

0

2

csc.dt.pool.XMLReader.maxSize

SAXパーサの最大プール数を0〜2,147,483,647の整数で指定します。ここで指定した最大プール数を超えてSAXパーサを使用する場合，他スレッドでの使用が終了するまで，待ち状態となります。

0以下の整数を指定した場合は，プール機能は無効となります。また，整数以外の文字列を指定した場合はデフォルト値で動作します。

64

初期割り当て数（csc.dt.pool.XMLReader.initialSizeで指定）と最大プール数（csc.dt.pool.XMLReader.maxSizeで指定）は，次の関係を満たすよう設定してください。

初期割り当て数 ≦ 最大プール数

・データ検証機能を使用する場合
　最大プール数 ≦ 各ビジネスプロセス・サービスアダプタの最大同時実行数（多重度）

・データ検証機能を使用しない場合
　最大プール数 ≦ 各ビジネスプロセスの検証アクティビティの最大同時実行数の総和

(6)　サイズノードの機能を拡張する

サイズノードの拡張機能を使用するかどうかを指定します。

データ変換のサイズノードは，バイナリフォーマット定義の要素（単純内容要素または複合内容要素）のサイズをその前に存在するノードで指定できる機能です。通常のサイズノードは，指定元である要素のサイズだけが対象となります（サイズノード自身のサイズは含まない）。サイズノードの拡張機能を使用すると，指定元である要素のほかに，サイズノード自身のサイズも加算されます。

サイズノードの拡張機能については，マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」の「付録M　サイズノードの機能拡張」を参照してください。

なお，拡張機能が有効なのは，次の条件を満たすサイズノードだけです。

サイズノード指定元要素が，サイズノード指定可能な単純内容要素または複合内容要素であること

サイズノードのサイズが固定長であること

このプロパティの指定は，HCSCサーバ上のすべてのバイナリフォーマット定義のサイズノードのデフォルト動作に対して有効となります。

usrconf.propertiesに記述する内容と形式を次に示します。プロパティ値の大文字/小文字は区別されません。

　　　　　　　　　:
csc.dt.sizeNode.includeSelfSize={true｜false}
　　　　　　　　　:

csc.dt.sizeNode.includeSelfSize={true｜false}

サイズノードの拡張機能を使用するかどうかを指定します。

true

サイズノードの拡張機能を使用します。

false

サイズノードの拡張機能を使用しません。

(7)　未定義コードを任意の文字へ置換する

バイナリデータとUnicode文字列との間で変換する場合，未定義の文字コードはデフォルトでは空白文字へ置換されますが，任意の文字へ置換することもできます。

任意の文字へ置換する場合は，事前に次に示す2つのファイル定義が必要です。

HCSCサーバランタイム定義ファイルに，telegram-undefined-character-code=REPLACE（未定義部分の文字コードをスペースに置換する）を定義する

HCSCサーバランタイム定義ファイルの定義方法については，マニュアル「サービスプラットフォーム リファレンス」の「6.5.6　HCSCサーバランタイム定義ファイル」を参照してください。

J2EEサーバ用ユーザプロパティファイル（usrconf.properties）に，置換する任意の文字を指定する

指定方法については，(a)以降を参照してください。

(a)　システムプロパティの指定形式

未定義コードを任意の文字へ置換する場合，J2EEサーバ用ユーザプロパティファイル（usrconf.properties）に次に示す形式でシステムプロパティを指定します。

　　　:
<プロパティキー>=<置換文字コード>
　　　:

注意事項

プロパティキーだけ指定して置換文字コードを指定しないと，データが壊れるおそれがあります。

<プロパティキー>

指定するシステムプロパティは，データの変換内容や，全角と半角のどちらに置換するか（置換種別）によって異なります。指定するシステムプロパティについては，変換内容に応じて次に示す個所を参照してください。

「(b) システムプロパティ（バイナリデータをUnicode文字列に変換する場合）」

「(c) システムプロパティ（Unicode文字列をバイナリデータに変換する場合）」

置換種別は，［フォーマット］ダイアログの［未定義コード置換時の処理］の選択（［全角・半角スペースに置換する］または［全角スペースに置換する］）と，文字コードのシフト状態（全角または半角）で決まります。

置換種別については，マニュアル「サービスプラットフォーム リファレンス」の「1.3.1　フォーマットダイアログ」の［未定義コード置換時の処理］の説明を参照してください。

<置換文字コード>

置換後の任意の文字を16進文字列の文字コードで指定します。

任意文字として指定できる文字

任意文字は全角・半角のどちらも指定できます。なお，置換種別の指定と異なる全角文字または半角文字へ置換する場合，シフトコードやエスケープシーケンスで全角・半角を区別している文字コードに関しては，置換文字コードにシフトコードまたはエスケープシーケンスを記述する必要があります。

また，任意文字を指定することで，次のような置換処理もできます。

未定義コードの削除（0バイトへの置換）

バイト数が異なる文字への置換

未定義文字，シフトコード，エスケープシーケンス，BOMなどの，特殊文字への置換

シフト状態（半角・全角）の切り替え

ただし，業務データに応じた設定をしてください。設定が適切でない場合，シフト状態の崩れやバイト数のずれが生じ，置換後のデータが壊れるおそれがあります。

置換文字コードの指定に関する注意事項

32文字以内の半角英数字（0〜9，a〜f，A〜F）で指定してください。16進数を意味する「0x」の部分は指定しないでください。

バイナリデータをUnicode文字列へ変換する場合，半角文字に置換する場合でも，2バイト単位で指定してください。1バイトで指定するとデータにずれが生じ，正しく置換されません。

32文字を超える文字数や，16進数でない値を指定した場合は，エラーになります。

置換文字コードにセパレータやエスケープ文字を指定した場合，置換時にエスケープ文字が直前に付加されるため，セパレータやエスケープ文字として解釈されなくなります。

未定義文字，シフトコード，エスケープシーケンス，BOMなどの特殊な文字を指定した場合や，バイト数がずれる場合は，データが壊れるおそれがあります。

設定例は，マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」の「付録O　バイナリデータの未定義コードを置換する文字の定義」を参照してください。

(b)　システムプロパティ（バイナリデータをUnicode文字列に変換する場合）

バイナリデータからUnicode文字列への変換時に検知される未定義コードを任意の文字へ置換するためには，該当するシステムプロパティに置換文字コードをUnicode big endianの16進数で指定します。

指定できるシステムプロパティを次の表に示します。システムプロパティは，入力バイナリデータの置換種別ごとに指定できます。

表2‒18　システムプロパティ一覧（バイナリデータをUnicode文字列に変換する場合）

項番

キー名称

置換種別

変換先のUnicode文字列の文字コード

1

csc.dt.undefined.replace.bin2xml

半角

Unicode big endian

2

csc.dt.undefined.replace.bin2xml.full

全角

(c)　システムプロパティ（Unicode文字列をバイナリデータに変換する場合）

Unicode文字列からバイナリデータへの変換時に検知される未定義コードを任意の文字へ置換するためには，該当するシステムプロパティに置換文字コードを16進数で指定します。

指定できるシステムプロパティを次の表に示します。システムプロパティは，変換先のバイナリデータの文字コードと置換種別ごとに指定できます。

表2‒19　システムプロパティ一覧（Unicode文字列をバイナリデータに変換する場合）

項番

キー名称

置換種別

変換先のバイナリデータの文字コード

1

csc.dt.undefined.replace.xml2utf16be

半角

UTF16 big endian

2

csc.dt.undefined.replace.xml2utf16be.full

全角

3

csc.dt.undefined.replace.xml2utf16le

半角

UTF16 little endian

4

csc.dt.undefined.replace.xml2utf16le.full

全角

5

csc.dt.undefined.replace.xml2utf8

半角

UTF8

6

csc.dt.undefined.replace.xml2utf8.full

全角

7

csc.dt.undefined.replace.xml2ms932

半角

MS932

8

csc.dt.undefined.replace.xml2ms932.full

全角

9

csc.dt.undefined.replace.xml2keisC

半角

KEIS＋EBCDIC

10

csc.dt.undefined.replace.xml2keisC.full

全角

11

csc.dt.undefined.replace.xml2keisK

半角

KEIS＋EBCDIK

12

csc.dt.undefined.replace.xml2keisK.full

全角

13

csc.dt.undefined.replace.xml2keis.full

全角

KEIS

14

csc.dt.undefined.replace.xml2ibmC.latin

半角

IBM＋EBCDIC(LATIN)

15

csc.dt.undefined.replace.xml2ibmC.latin.full

全角

16

csc.dt.undefined.replace.xml2ibmC.kana

半角

IBM＋EBCDIC(KANA)

17

csc.dt.undefined.replace.xml2ibmC.kana.full

全角

18

csc.dt.undefined.replace.xml2ibm.full

全角

IBM

19

csc.dt.undefined.replace.xml2jefC

半角

JEF＋EBCDIC

20

csc.dt.undefined.replace.xml2jefC.full

全角

21

csc.dt.undefined.replace.xml2jefK

半角

JEF＋EBCDIK

22

csc.dt.undefined.replace.xml2jefK.full

全角

23

csc.dt.undefined.replace.xml2jef.full

全角

JEF

24

csc.dt.undefined.replace.xml2jis

半角

JIS

25

csc.dt.undefined.replace.xml2jis.full

全角

26

csc.dt.undefined.replace.xml2euc

半角

EUC

27

csc.dt.undefined.replace.xml2euc.full

全角

28

csc.dt.undefined.replace.xml2euchj

半角

EUC_HJ

29

csc.dt.undefined.replace.xml2euchj.full

全角

(8)　データ変換APIの動作を指定する

データ変換APIの動作を指定できます。データ変換APIについては，マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」の「13.1　データ変換APIを使用したデータ変換」を参照してください。

データ変換APIで指定できるシステムプロパティを次に示します。

表2‒20　システムプロパティ一覧（データ変換API）

項番

キー名称

内容

デフォルト値

1

csc.dt.formatdef.maxcache.num.<グループ名>

バイナリフォーマット定義のキャッシュの上限数を1〜2,147,483,647の範囲で指定します。

キャッシュは再利用されるため，定義したバイナリフォーマット定義の数以上の値を指定してください。

2147483647

2

csc.dt.transformdef.maxcache.num.<グループ名>

データ変換定義のキャッシュの上限数を1〜2,147,483,647の範囲で指定します。

キャッシュは再利用されるため，定義したデータ変換の数以上の値を指定してください。

2147483647

3

csc.dt.telegram.undefined.characterCode.<グループ名>

バイナリデータの文字コード変換処理で未定義の文字コードが検出された場合に，次のどちらの対処とするか指定します。

ERROR

エラー

REPLACE

空白文字

ERROR

4

csc.dt.codeTable.rootPath.<グループ名>

コード変換ライブラリで使用するコード変換テーブル格納パスのルートパスを絶対パスで指定します。

ディレクトリ区切りには「/」または「¥¥」を使用してください。

存在しないディレクトリやファイルが指定された場合，インスタンスの生成に失敗します。

<サービスプラットフォームのインストールディレクトリ>¥¥CSC¥¥userlib¥¥codetables

5

csc.dt.debugtrace

デバッグ情報の出力有無を指定します。

ON：出力する

OFF：出力しない

OFF

6

csc.dt.debugtrace.filepath

csc.dt.debugtraceにONを指定した場合に，デバッグ情報の出力先パスを絶対パスで指定します。ディレクトリ区切りには「/」または「¥¥」を使用してください。

<J2EEサーバのログ出力ディレクトリ>¥¥CSC

ディレクトリが存在しない場合は作成されます。

7

csc.dt.debugtrace.filenum

csc.dt.debugtraceにONを指定した場合に，デバッグ情報ファイルの最大面数を1〜16の範囲で指定します。

4

8

csc.dt.debugtrace.filesize

csc.dt.debugtraceにONを指定した場合に，デバッグ情報ファイルの1面当たりの最大サイズを4,096〜2,147,483,647の範囲（単位：バイト）で指定します。

2097152

デバッグ情報の出力ファイル名には，データ変換APIのインスタンス（グループ）の名称が付加されます。デバッグ情報の出力ファイル名を次に示します。

cscdebug_<グループ名>_<面数>.log

2.4　運用環境に関する設定

運用環境に関する設定には，次のものがあります。

各種カスタマイズの設定

ユーザ情報の設定

HCSC-Managerコマンド共通項目の設定

運用環境の画面とコマンドで実施できる機能の差異については，「付録B　画面とコマンドで実施できる内容（運用環境）」を参照してください。

注意事項

1台のマシンに複数の運用環境を構築する場合は，運用環境の設定前にCSCMNG_HOME環境変数を設定する必要があります。CSCMNG_HOME環境変数については，「2.9.2(1)　CSCMNG_HOME環境変数の設定」を参照してください。

2.4.1　運用環境をカスタマイズする

運用環境では，次の内容をカスタマイズできます。

インポート先のリポジトリとなるディレクトリ

HCSC-Managerのログファイルの出力先ディレクトリ

ログファイルの大きさ

ログファイルの面数

HCSC-ManagerとManager間の接続時の読み込みタイムアウト値

プロセスインスタンス再実行で応答電文を受け取った場合に，応答電文を格納するディレクトリ

プロセスインスタンス再実行で応答電文を受け取った場合に，応答電文を格納するときの出力文字コード

カスタマイズに必要な情報は，HCSC-Manager定義ファイルに定義します。

(1)　HCSC-Manager定義ファイルの格納ディレクトリ

HCSC-Manager定義は，J2SE形式のプロパティ形式のHCSC-Manager定義ファイルとして，次に示すディレクトリに格納されています。

<サービスプラットフォームのインストールディレクトリ>¥CSC¥config¥manager¥cscmng.properties

(2)　HCSC-Manager定義ファイルに定義するプロパティ

HCSC-Manager定義ファイルに定義するプロパティを次に示します。

表2‒21　HCSC-Manager定義ファイルに定義するプロパティ

項番

分類

キー名称

内容

1

リポジトリ設定

cscmng.repository.root

リポジトリのルートディレクトリパス

2

ログファイルの設定

cscmng.log.dir

ログ出力先ディレクトリパス

3

cscmng.log.<チャネル名>.filesize

ログファイルサイズ

4

cscmng.log.<チャネル名>.filenum

ログファイル面数

5

Manager 設定

cscmng.manager.<マネージャ識別名>.timeout

タイムアウト値

6

プロセスインスタンス再実行設定

cscmng.pireexec.response.dir

応答電文格納ディレクトリパス

7

cscmng.pireexec.response.encoding

応答電文格納文字コード

8

HCSCサーバ運用設定

cscmng.server.<HCSCサーバ名>.system

HCSCシステムの管理下におく論理サーバ

9

リポジトリエクスポート

cscmng.repctl.export.dir

エクスポートファイルの出力先ディレクトリパス

10

環境バックアップ

cscmng.envbackup.dir

環境バックアップの出力先ディレクトリパス

11

cscmng.envbackup.dir.envrestore

リストア前の環境バックアップの出力先ディレクトリパス

12

cscmng.envbackup.dir.import

インポート前の環境バックアップの出力先ディレクトリパス

13

cscmng.envbackup.autoget

自動バックアップの仕様の有無

14

cscmng.envbackup.autoget.off

環境をリストアする際，またはリポジトリをインポートする際の環境バックアップの抑止

15

コマンド用スレッド設定

cscmng.precache.thread.maximum

cscprecacheコマンドで並列処理するスレッドの最大数

16

HTTP Server運用設定

cscmng.server.<HCSCサーバ名>.hws.svstop

HTTP Server停止時の動作

17

cscmng.server.<HCSCサーバ名>.hws.svstop.timeout

HTTP Server計画停止時のタイムアウト時間

HCSC-Manager定義ファイルの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.5.3　HCSC-Manager定義ファイル」を参照してください。

2.4.2　ユーザ情報を設定する

ユーザ情報はcscpasswdコマンドで設定します。HCSC-Managerの各種コマンドは，Management Server経由でHCSCサーバにアクセスします。また，HCSCサーバでは専用のデータベースにアクセスします。

図2‒3　ユーザ情報の設定

ユーザ情報を変更した場合，変更したユーザ情報はそれぞれ次のタイミングで反映されます。

画面には，次回ログイン時に反映されます。

コマンドには，cscpasswdコマンド正常終了後に実行されたコマンド起動時から反映されます。

(1)　HCSC-Managerにアクセスするユーザの変更

HCSC-Managerにアクセスする管理ユーザのユーザID，およびパスワードを変更できます。HCSC-Managerインストール直後は，次のように仮定されます。

ユーザID：admin

パスワード：admin

HCSC-ManagerにアクセスするユーザIDおよびパスワードは，必ずcscpasswdコマンドで変更してください。

注意事項

HCSC-Managerにアクセスする管理ユーザは，HCSC-Managerが管理しているすべての資源にアクセスできます。そのため，HCSC-ManagerにアクセスするユーザのID，パスワードは適切に管理してください。

この場合，コマンドを次のように入力します。

cscpasswd [-user <ログインユーザID>]
          [-pass <ログインパスワード>]
           -cscmnguser <変更後のユーザID>
           -cscmngpass <変更後のパスワード>

各コマンドで必要になるユーザID（-userオプション）とパスワード（-passオプション）は，HCSC-Managerコマンド共通定義ファイルに設定すればオプションの入力を省略できます。

cscpasswdコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscpasswd（ユーザの管理）」を参照してください。

(2)　Managerにアクセスするユーザの設定

HCSC-ManagerがManagement Serverにアクセスするための管理ユーザID，および管理ユーザパスワードを変更できます。変更は，HCSCサーバセットアップ後にします。なお，Management Server自体が管理している管理ユーザID，および管理ユーザパスワードは変更できません。

この場合，コマンドを次のように入力します。

cscpasswd [-user <ログインユーザID>]
          [-pass <ログインパスワード>]
           -mng <Manager名>
           -mnguser <変更後のユーザID>
           -mngpass <変更後のパスワード>

各コマンドで必要になるユーザID（-userオプション）とパスワード（-passオプション）は，HCSC-Managerコマンド共通定義ファイルに設定すればオプションの入力を省略できます。

cscpasswdコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscpasswd（ユーザの管理）」を参照してください。

(3)　HCSCサーバにアクセスするユーザの設定

HCSC-ManagerがHCSCサーバにアクセスするためにHCSCサーバが保持しているデータベースのユーザID，およびパスワードを変更できます。変更は，HCSCサーバセットアップ後にします。なお，データベース自体が管理しているユーザID，およびパスワードは変更できません。

この場合，コマンドを次のように入力します。

cscpasswd [-user <ログインユーザID>]
          [-pass <ログインパスワード>]
           -csc <HCSCサーバ名称>
           -cscuser <変更後のユーザID>
           -cscpass <変更後のパスワード>

各コマンドで必要になるユーザID（-userオプション）とパスワード（-passオプション）は，HCSC-Managerコマンド共通定義ファイルに設定すればオプションの入力を省略できます。

アクセスするデータベースのユーザIDおよびパスワードにダブルクォーテーション（"）を含む場合は，エスケープ記号でエスケープしてください。HCSCサーバ名がHCSCで，アクセスするデータベースのユーザIDを"user1"に，パスワードを"pass"に変更する場合の例を次に示します。

cscpasswd -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -cscuser ¥"user1¥" -cscpass ¥"pass¥"

cscpasswdコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscpasswd（ユーザの管理）」を参照してください。

2.4.3　HCSC-Managerコマンド共通項目を設定する

運用環境で使用する各コマンドの必須項目の省略値は，HCSC-Managerコマンドの共通定義に定義しておくと，コマンド入力時にそのオプションの入力を省略できます。

HCSC-Managerのコマンド共通の省略値として必要な情報は，HCSC-Managerコマンド共通定義ファイルに定義します。

(1)　HCSC-Managerコマンド共通定義ファイルの作成

HCSC-Managerコマンド共通定義は，J2SEのプロパティファイル形式のHCSC-Managerコマンド共通定義ファイルとして，次に示すディレクトリに格納されています。

<サービスプラットフォームのインストールディレクトリ>¥CSC¥config¥manager¥csccmd.properties

HCSC-Managerコマンド共通定義ファイルに省略値を設定・変更したあとで入力したコマンドから，設定した省略値が反映されます。HCSC-Managerコマンド共通定義ファイルと，コマンドのオプションとの両方に定義した場合は，コマンドのオプションが有効になります。

このファイルには，ユーザIDやパスワードなどの情報が含まれるため，アクセス権を設定して管理する必要があります。

(2)　設定できる内容

HCSC-Managerコマンド共通項目に設定できる値を次に示します。

コマンドのすべてに共通する引数のデフォルト値

パラメタ：csc.all.<コマンド引数名>=値

コマンド識別子に対応したコマンドのデフォルト引数

パラメタ：csc.<コマンド識別子>.<コマンド引数名>=値

HCSC-Managerコマンド共通定義ファイルの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.5.2　HCSC-Managerコマンド共通定義ファイル」を参照してください。

2.5　HCSCサーバをロードバランスクラスタ構成にする場合の環境構築

複数台のHCSCサーバを並列に並べることで，サービスリクエスタからのサービス部品の実行要求の一点集中によるJ2EEサーバの負荷を軽減することができます。これをロードバランスクラスタ機能といいます。

ロードバランスクラスタ機能を利用して負荷を分散する場合，汎用ロードバランサまたはCTMを使用します。ここでは，汎用ロードバランサとCTMを合わせて，ロードバランサと表記します。

標準の同期受付（Webサービス／SessionBean）へのサービス部品の実行要求の場合だけ，ロードバランサで負荷分散をすることができます。なお，標準の同期受付（Webサービス）と標準の同期受付（SessionBean）のどちらにサービス部品の実行要求を送信するかによって，使用するロードバランサは異なります。サービス部品の実行要求を送信する標準受付と使用するロードバランサを次の表に示します。

表2‒22　サービス部品の実行要求を送信する標準受付と使用するロードバランサ

標準受付

ロードバランサ

標準の同期受付（Webサービス）

汎用ロードバランサ（HTTPの負荷分散ができる負荷分散機）

標準の同期受付（SessionBean）

CTM※

注※

各HCSCサーバで，クラスタ内で共通する別名を設定する必要があります。

HCSCサーバをロードバランスクラスタ構成にする場合の環境構築およびセットアップの方法について，次に説明します。

2.5.1　ロードバランスクラスタ構成時の環境構築

汎用ロードバランサを使用したシステム構成を図2-4に，CTMを使用したシステム構成を図2-5に示します。

図2‒4　汎用ロードバランサを使用したシステム構成

図2‒5　CTMを使用したシステム構成

なお，バージョン08-70以降で新規にセットアップした場合は，HCSC-Managerの環境をそれぞれの実行環境に格納できます。これによって，運用環境のサーバ台数を省略できます。

注意事項

HCSCクラスタのGUI表示名は，システム内で一意にしてください。

サーバ障害時の別HCSCサーバからのビジネスプロセスの再実行について

別HCSCサーバからビジネスプロセスを再実行する場合，次に示す情報については共有ディスク装置に格納する必要があります。

作業フォルダ

共通フォルダ

ファイルアダプタで利用する入出力許可ファイル

次に示す情報についてはローカルディスク装置に格納します。ただし，各HCSCサーバで同じ値を設定する必要があります。

メールアダプタで利用するメール本文のテキストファイル，および添付ファイル

HCSCサーバの運用で利用する定義ファイル

HCSCコンポーネントで利用する定義ファイル

作業フォルダを使用するビジネスプロセスの再実行について

作業フォルダを使用するビジネスプロセスであり，かつ09-51より前のバージョンで実行したビジネスプロセスについては，別HCSCサーバからビジネスプロセスを再実行することはできません。

作業フォルダの代わりに共通フォルダを使用している場合，または09-51以降で実行している場合は，ビジネスプロセスを再実行することができます。しかし，次に示すコンポーネントを使用するビジネスプロセスについては，共通フォルダを使用することができないため，09-51より前のバージョンで実行したビジネスプロセスを再実行することはできません。

FTP受付

HTTP受付

実行環境，運用環境，DBサーバの構築方法を次に示します。

(1)　実行環境の構築

実行環境を構築するには，次の作業を実施します。

(a)　Service Platformのインストール

Service Platformのインストール方法については，「2.1.2　Service Platformのインストール」を参照してください。

(b)　Management Serverの設定

運用環境でHCSC-Managerを使用するためのManagement Serverの設定を，HCSC-Managerの接続先となる実行環境で実施します。

Management Serverの設定については，「2.1.6　HCSC-Managerを使用するためのManagement Serverの設定」を参照してください。

(c)　SOAPモードの設定

HCSCサーバをロードバランスクラスタ構成にする場合，構成する実行環境および運用環境で利用するSOAPモードを合わせる必要があります。異なるSOAPモードの環境は共存できません。

SOAPモードを設定するには，J2EEサーバのコンテナ拡張ライブラリの設定が必要になります。J2EEサーバのコンテナ拡張ライブラリの設定については，「3.1.2(4)(e)　コンテナ拡張ライブラリの設定」を参照してください。

(d)　HCSCサーバの構成などの設定

HCSCサーバの構成などの実行環境に関する設定を行います。設定する内容と設定方法については，「2.3　実行環境に関する設定」を参照してください。

なお，実行環境に関する設定でHCSCサーバ構成定義ファイル，HCSCサーバセットアップ定義ファイル，およびHCSCサーバランタイム定義ファイルを設定する場合には，次に示す内容に留意してください。

HCSCサーバ構成定義ファイルの設定時の注意事項

HCSCサーバ構成定義ファイルを設定する場合には，次に示す内容に留意してください。HCSCサーバ構成定義ファイルの設定方法については，「2.3.1　HCSCサーバ構成定義ファイルを設定する」を参照してください。HCSCサーバ構成定義ファイルに設定する内容の詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.4.2　HCSCサーバ構成定義ファイル」を参照してください。

クラスタ表示名

ロードバランスクラスタ内のすべてのHCSCサーバで同じ値を設定します。

クラスタ種別

「LB」を設定します。

Manager名

HCSC-ManagerでManager単位に一意になる識別名を設定します。

ManagerのIPアドレス

物理IPアドレスを設定します。

WebサーバのIPアドレス（同期サービス（Webサービス）呼び出しをする場合）

ロードバランスクラスタ内のすべてのHCSCサーバに，ロードバランサのIPアドレス値を設定します。

WebサーバのIPアドレス（非同期サービス（MDB（WS-R））呼び出しをする場合）

それぞれのHCSCサーバのIPアドレスを設定します。ロードバランスクラスタ構成の場合，jms-physical-receptionに設定してください。

NameServerのIPアドレス

ロードバランスクラスタ内のすべてのHCSCサーバで，グローバルCORBAネーミングServiceのIPアドレスを設定します。ただし，CTMを利用していない場合は，localhostを指定してください。

HCSCサーバ名

データベースを使用する環境を構築する場合，ロードバランスクラスタ内で一意になる識別名を設定します。

データベースとReliable Messagingの両方を使用しない環境を構築する場合は，HCSC-Manager内で一意になる識別名を設定してください。

HCSCサーバセットアップ定義ファイルの設定時の注意事項

HCSCサーバセットアップ定義ファイルを設定する場合には，次に示す内容に留意してください。HCSCサーバセットアップ定義ファイルの設定方法については，「2.3.2　HCSCサーバセットアップ定義ファイルを設定する」を参照してください。HCSCサーバセットアップ定義ファイルに設定する内容の詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.4.3　HCSCサーバセットアップ定義ファイル」を参照してください。

すべてのHCSCサーバで同じ値を設定するプロパティ

HCSCサーバセットアップ定義ファイルに設定するプロパティのうち，次の表に示すプロパティはロードバランスクラスタ内のすべてのHCSCサーバで同じ値を設定する必要があります。

表2‒23　ロードバランスクラスタ内のHCSCサーバで同じ値を設定するプロパティ

同じ値を指定するプロパティ

プロパティに設定する値

db-use

データベースの使用有無

rm-use

Reliable Messagingの使用有無

request-ejb

標準の同期受付（SessionBean）の使用有無

request-soap

標準の同期受付（Webサービス）の使用有無

request-jms

標準の非同期受付（MDB（WS-R））の使用有無

request-jms.maxmessage

標準の非同期受付（MDB（WS-R））のキューの最大メッセージ数

request-dbq

標準の非同期受付（MDB（DBキュー））の使用有無

request-dbq.maxmessage

標準の非同期受付（MDB（DBキュー））のキューの最大メッセージ数

request-jms-rdarea

標準の非同期受付（MDB（WS-R））のRDエリア名

request-dbq-rdarea

標準の非同期受付（MDB（DBキュー））のRDエリア名

request-dbq-maxlen

標準の非同期受付（MDB（DBキュー））の最大メッセージ長

request-userdef-soap

SOAP受付の使用有無

rm-displayname

Reliable Messagingの表示名

dbcon-xadisplayname※1

XATransactionまたはLocalTransaction用DB Connectorの表示名

dbcon-nodisplayname※1

NoTransaction用DB Connectorの表示名

dbtype

使用するデータベース種別

jdbc-type

JDBCドライバ種別

jdbc-url※2

JDBC用データベースURL

jdbc-dbhostname

データベースのホスト名

jdbc-dbconnectinfo

データベースの接続情報

db-character-sets

データベース文字コード種別

db-tbl-split-key

日付データによるテーブルのレンジ分割機能の使用有無

db-tbl-split-corcheck-use

相関セットの重複チェックの強化有無

activitynumber-maximum-compatible

アクティビティインスタンスの識別番号の上限値

注※1

DBコネクタの設定もロードバランスクラスタ内のすべてのHCSCサーバで同じにします。

注※2

指定するホスト名には，データベースを格納しているマシンを指定します。

HCSCサーバランタイム定義ファイルの設定時の注意事項

HCSCサーバランタイム定義ファイルを設定する場合，ロードバランスクラスタ内のすべてのHCSCサーバですべてのプロパティを同じ値に設定する必要があります。

また，CTMを使用する場合，次のプロパティを追加してください。

request-ejb.ctm=true

クラスタを構成するHCSCサーバでJ2EEサーバ名が異なる場合，次のプロパティを追加してください。

request-ejb.optional.name=<クラスタ内で共通の同期リクエスタサービス（SessionBean）の別名>

HCSCサーバランタイム定義ファイルの設定方法については，「2.3.3　HCSCサーバランタイム定義ファイルを設定する」を参照してください。

HCSCサーバランタイム定義ファイルに設定する内容の詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.5.6　HCSCサーバランタイム定義ファイル」を参照してください。

(2)　運用環境の構築

運用環境は，クラスタを構成するHCSCサーバのマシンに構築します。なお，運用環境と実行環境は1対1で配置することを推奨します。運用環境と実行環境の構成については，「1.2.3　運用環境と実行環境の構成」を参照してください。

運用環境を構築するには，次の作業を実施します。

環境設定

運用環境の環境設定としてリポジトリの設定と環境変数の設定を実施します。

環境設定については，「2.1.3　環境設定」を参照してください。

EclipseへのHCSC-Manager Plug-inの組み込み

EclipseにHCSC-Manager Plug-inを組み込みます。

EclipseへのHCSC-Manager Plug-inの組み込みについては，「2.1.5　EclipseへのHCSC-Manager Plug-inの組み込み」を参照してください。

ユーザ権限などの設定

ユーザ権限などの運用環境に関する設定を行います。設定する内容と設定方法については，「2.4　運用環境に関する設定」を参照してください。

(3)　DBサーバの構築

DBサーバは，ロードバランスクラスタを構成するHCSCサーバから独立して構築し，ロードバランスクラスタ内のHCSCサーバで共有します。

DBサーバとして利用するマシンに利用するデータベースをインストールしてください。インストール方法は，利用するデータベースのドキュメントを参照してください。

2.5.2　ロードバランスクラスタ構成時の実行環境のセットアップ

環境の構築後，ロードバランスクラスタを構成する実行環境をセットアップします。

ロードバランスクラスタ構成時の実行環境のセットアップの流れを次に示します。

図2‒6　ロードバランスクラスタ構成の場合のセットアップの流れ

図中の各工程について，次に説明します。

なお，ロードバランスクラスタ構成での運用については，「5.7.1　ロードバランスクラスタ構成での運用」を参照してください。

(1)　セットアップの準備

セットアップ前に，次の作業を行います。次の作業は，ロードバランスクラスタを構成するすべてのHCSCサーバで行います。

実行環境に必要なソフトウェアの設定

J2EEサーバのセットアップなどを行います。設定する内容と設定方法については，「3.1.2　実行環境に必要なソフトウェアを設定する」を参照してください。

また，Reliable Messagingのシステム名は，ロードバランスクラスタ内のそれぞれのHCSCサーバでユニークな名称に設定する必要があります。

CTMを使用する場合の設定

CTMを使用する場合，HCSCサーバランタイム定義ファイルでrequest-ejb.ctmにtrueを設定してください。

HCSCサーバランタイム定義ファイルの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.5.6　HCSCサーバランタイム定義ファイル」を参照してください。

サービスリクエスタへの送信制御

サービスリクエスタ用のネットワークを切断するなどして，HCSCサーバでサービス部品の実行要求を受け付けられない状態にします。

(2)　実行環境のセットアップ

実行環境のセットアップ手順を次に示します。

次の順序でプロセスを起動します。

起動順

起動するプロセス

起動方法

1

運用管理エージェント

マニュアル「アプリケーションサーバ システム構築・運用ガイド」を参照してください。

2

Management Server

3

PRF

4

スマートエージェント

5

CTMドメインマネジャ（CTMを使用する場合）

6

CORBAネーミングサービス（CORBAネーミングサービスを使用する場合）

7

CTMデーモン（CTMを使用する場合）

8

J2EEサーバ

9

HTTP Server（HTTP Serverを使用する場合）

「5.3.6　HTTP Serverを起動する」を参照してください。

HCSCサーバをセットアップします。

HCSCサーバのセットアップ方法については，「3.1.3　HCSCサーバをセットアップする」を参照してください。

HCSCサーバを起動します。

HCSCサーバの起動方法については，「5.3.4　HCSCサーバを起動する」を参照してください。

サービスアダプタとビジネスプロセスを配備します。

サービスアダプタとビジネスプロセスの配備方法については，「3.1.8　サービスアダプタを配備する」および「3.1.13　ビジネスプロセスを配備する」を参照してください。

サービスアダプタとビジネスプロセスを開始します。

サービスアダプタとビジネスプロセスの開始方法については，「5.3.7　サービスアダプタを開始する」および「5.3.8　ビジネスプロセスを開始する」を参照してください。

(3)　ロードバランサの設定

ロードバランスクラスタを構成しているすべてのHCSCサーバへサービス部品の実行要求を送信するように設定します。

CTMを使用する場合，すべてのHCSCサーバでCTMドメインマネジャ名およびスマートエージェントのポート番号を同じ値に設定する必要があります。

汎用ロードバランサの設定方法については，使用する汎用ロードバランサのドキュメントを参照してください。

(4)　標準受付の開始

すべてのHCSCサーバの標準受付を開始します。標準受付の開始方法については，「5.3.10　標準受付を開始する」を参照してください。

(5)　ロードバランサの接続

ロードバランサを接続し，使用できる状態にします。

CTMを使用する場合，この手順は不要です。

汎用ロードバランサの接続開始方法については，使用する汎用ロードバランサのドキュメントを参照してください。

2.6　HCSCサーバをHAクラスタ構成にする場合の環境構築

HAクラスタ構成では，2つのHCSCサーバを組み合わせたコールドスタンバイ構成でクラスタリングし，実行系と待機系を1対1で運用するシステム（1:1系切り替えシステム）を構成できます。HAクラスタを構成する場合，クラスタソフトウェアを利用します。サービスプラットフォームでは，次に示すクラスタソフトウェアを利用できます。

Windowsの場合

Windows Server Failover Cluster

UNIXの場合

HAモニタ

HCSCサーバをHAクラスタ構成にする場合の環境構築およびセットアップの方法について，次に説明します。

2.6.1　HAクラスタ構成時の環境構築

HCSCサーバをHAクラスタ構成にした場合のシステムの構成を次の図に示します。

図2‒7　HCSCサーバをHAクラスタ構成にした場合のシステムの構成

クラスタIPアドレスの設定方法については，利用するクラスタソフトウェアによって異なります。クラスタソフトウェアのマニュアルを参照ください。

バージョン08-70以降で新規にセットアップした場合は，HCSC-Managerの環境をそれぞれの実行環境に格納できます。これによって，運用環境のサーバ台数を省略できます。

注意事項

HCSCクラスタのGUI表示名は，システム内で一意にしてください。

共有ディスク装置の使用について

HCSCサーバをHAクラスタ構成にする場合，共有ディスク装置の使用については，ローカルトランザクションの場合とグローバルトランザクションの場合とで異なります。

ローカルトランザクションの場合

共有ディスク装置は不要です。HCSCサーバが引き継ぐ情報はデータベースで管理しているため，ローカルトランザクションでは，共有ディスク装置を使用しません。

グローバルトランザクションの場合

共有ディスク装置が必要になります。共有ディスク装置は，系切り替え時に，OTSのステータスなどのトランザクション情報を引き継ぐために使用します。

サーバ障害時の系切り替え処理後のビジネスプロセスの再実行について

待機系への系切り替え処理後にビジネスプロセスを再実行する場合，次に示す情報については共有ディスク装置に格納する必要があります。

作業フォルダ

共通フォルダ

ファイルアダプタが入出力するファイル

次に示す情報についてはローカルディスク装置に格納します。ただし，実行系と待機系で同じ値を設定する必要があります。

メールアダプタで利用するメール本文のテキストファイル，および添付ファイル

HCSCサーバの運用で利用する定義ファイル

HCSCコンポーネントで利用する定義ファイル

作業フォルダを使用するビジネスプロセスの再実行について

作業フォルダを使用するビジネスプロセスであり，かつ09-51より前のバージョンで実行したビジネスプロセスについては，待機系への系切り替え処理後にビジネスプロセスを再実行することはできません。

作業フォルダの代わりに共通フォルダを使用している場合，または09-51以降で実行している場合は，ビジネスプロセスを再実行することができます。しかし，次に示すコンポーネントを使用するビジネスプロセスについては，共通フォルダを使用することができないため，09-51より前のバージョンで実行したビジネスプロセスを再実行することはできません。

FTP受付

HTTP受付

実行環境（実行系・待機系），運用環境，DBサーバの構築方法を次に示します。

(1)　実行環境（実行系・待機系）の構築

実行環境を構築するには，実行系および待機系で次の作業を実施します。

(a)　Service Platformのインストール

Service Platformのインストール方法については，「2.1.2　Service Platformのインストール」を参照してください。

(b)　Management Serverの設定

運用環境でHCSC-Managerを使用するためのManagement Serverの設定を，HCSC-Managerの接続先となる実行環境で実施します。

Management Serverの設定については，「2.1.6　HCSC-Managerを使用するためのManagement Serverの設定」を参照してください。

(c)　SOAPモードの設定

HCSCサーバをHAクラスタ構成にする場合，構成する実行環境および運用環境で利用するSOAPモードを合わせる必要があります。異なるSOAPモードの環境は共存できません。

SOAPモードを設定するには，J2EEサーバのコンテナ拡張ライブラリの設定が必要になります。J2EEサーバのコンテナ拡張ライブラリの設定については，「3.1.2(4)(e)　コンテナ拡張ライブラリの設定」を参照してください。

(d)　HCSCサーバの構成などの設定

HCSCサーバの構成などの実行環境に関する設定を行います。設定する内容と設定方法については，「2.3　実行環境に関する設定」を参照してください。

なお，実行環境に関する設定でHCSCサーバ構成定義ファイル，HCSCサーバセットアップ定義ファイル，およびHCSCサーバランタイム定義ファイルを設定する場合には，次に示す内容に留意してください。これ以外のすべての機能は，実行系と待機系で同じ値を設定してください。

HCSCサーバ構成定義ファイルの設定時の注意事項

HCSCサーバ構成定義ファイルで設定するクラスタ種別には，「HA」を設定してください。

データベースを使用する場合は，HCSCサーバ名をユニークな名称にしてください。

また，非同期サービス（MDB（WS-R））呼び出しをする場合のWebサーバのIPアドレスは，jms-receptionに設定してください。

なお，HCSCサーバ構成定義ファイルに設定する値のうち，次に示す値は実行系と待機系で異なる値を設定する必要があります。

Manager名

ManagerのIPアドレス

ManagerのIPアドレスには，実行系・待機系それぞれの物理IPアドレスを指定します。また，運用環境と実行環境を同じマシンに構築する場合は，localhostを指定できます。

上記以外の要素には，実行系と待機系で同じ値を設定します。

次の定義には論理IPアドレスを設定します。

soap-receptionの定義のip-address

jms-receptionの定義のip-address

ejb-receptionの定義のip-address

HCSCサーバ構成定義ファイルの設定方法については，「2.3.1　HCSCサーバ構成定義ファイルを設定する」を参照してください。

HCSCサーバ構成定義ファイルに設定する内容の詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.4.2　HCSCサーバ構成定義ファイル」を参照してください。

HCSCサーバセットアップ定義ファイルの設定時の注意事項

HCSCサーバセットアップ定義ファイルを設定する場合には，次に示す内容に留意してください。

HCSCサーバセットアップ定義ファイルの設定方法については，「2.3.2　HCSCサーバセットアップ定義ファイルを設定する」を参照してください。

HCSCサーバセットアップ定義ファイルに設定する内容の詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.4.3　HCSCサーバセットアップ定義ファイル」を参照してください。

実行系と待機系で同じ値を設定するプロパティ

HCSCサーバセットアップ定義ファイルに設定するプロパティのうち，次の表に示すプロパティは実行系と待機系で同じ値を設定する必要があります。なお，naming-service-hostnameは設定する必要はありません。次の表に記載のないIPアドレスには，localhostまたは物理IPアドレスを設定してください。

表2‒24　実行系と待機系で同じ値を設定するプロパティ

同じ値を指定するプロパティ

プロパティに設定する値

db-use

データベースの使用有無

rm-use

Reliable Messagingの使用有無

request-ejb

標準の同期受付（SessionBean）の使用有無

request-soap

標準の同期受付（Webサービス）の使用有無

request-jms

標準の非同期受付（MDB（WS-R））の使用有無

request-jms.maxmessage

標準の非同期受付（MDB（WS-R））のキューの最大メッセージ数

request-dbq

標準の非同期受付（MDB（DBキュー））の使用有無

request-dbq.maxmessage

標準の非同期受付（MDB（DBキュー））のキューの最大メッセージ数

request-jms-rdarea

標準の非同期受付（MDB（WS-R））のRDエリア名

request-dbq-rdarea

標準の非同期受付（MDB（DBキュー））のRDエリア名

request-dbq-maxlen

標準の非同期受付（MDB（DBキュー））の最大メッセージ長

request-userdef-soap

SOAP受付の使用有無

rm-systemname

Reliable Messagingのシステム名

rm-displayname

Reliable Messagingの表示名

dbcon-xadisplayname※1

XATransactionまたはLocalTransaction用DB Connectorの表示名

dbcon-nodisplayname※1

NoTransaction用DB Connectorの表示名

dbtype

使用するデータベース種別

jdbc-type

JDBCドライバ種別

jdbc-url※2

JDBC用データベースURL

jdbc-dbhostname

データベースのホスト名

jdbc-dbconnectinfo

データベースの接続情報

db-character-sets

データベース文字コード種別

db-tbl-split-key

日付データによるテーブルのレンジ分割機能の使用有無

db-tbl-split-corcheck-use

相関セットの重複チェックの強化有無

activitynumber-maximum-compatible

アクティビティインスタンスの識別番号の上限値

注※1

DBコネクタの設定も実行系と待機系で同じにします。

注※2

指定するホスト名には，データベースを格納しているマシンを指定します。

HCSCサーバランタイム定義ファイルの設定時の注意事項

HCSCサーバランタイム定義ファイルを設定する場合，すべてのプロパティで実行系と待機系で同じ値を設定する必要があります。

HCSCサーバランタイム定義ファイルの設定方法については，「2.3.3　HCSCサーバランタイム定義ファイルを設定する」を参照してください。

HCSCサーバランタイム定義ファイルに設定する内容の詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.5.6　HCSCサーバランタイム定義ファイル」を参照してください。

クラスタを構成するHCSCサーバでJ2EEサーバ名が異なる場合，次のプロパティを追加してください。

request-ejb.optional.name=<クラスタ内で共通の同期リクエスタサービス（SessionBean）の別名>

(e)　クラスタソフトウェアのインストール

クラスタソフトウェアをインストールします。インストール方法は，利用するクラスタソフトウェアのドキュメントを参照してください。

(2)　運用環境の構築

運用環境は，クラスタを構成するHCSCサーバのマシンに構築します。なお，運用環境と実行環境は1対1で配置することを推奨します。運用環境と実行環境の構成については，「1.2.3　運用環境と実行環境の構成」を参照してください。

運用環境を構築するには，次の作業を実施します。

環境設定

運用環境の環境設定としてリポジトリの設定と環境変数の設定を実施します。

環境設定については，「2.1.3　環境設定」を参照してください。

EclipseへのHCSC-Manager Plug-inの組み込み

EclipseにHCSC-Manager Plug-inを組み込みます。

EclipseへのHCSC-Manager Plug-inの組み込みについては，「2.1.5　EclipseへのHCSC-Manager Plug-inの組み込み」を参照してください。

ユーザ権限などの設定

ユーザ権限などの運用環境に関する設定を行います。設定する内容と設定方法については，「2.4　運用環境に関する設定」を参照してください。

(3)　DBサーバの構築

DBサーバは，HAクラスタを構成するHCSCサーバから独立して構築し，実行系および待機系のHCSCサーバで共有します。

DBサーバとして利用するマシンに利用するデータベースをインストールしてください。インストール方法は，利用するデータベースのドキュメントを参照してください。

2.6.2　HAクラスタ構成時の実行環境のセットアップ

環境の構築後，HAクラスタを構成する実行環境をセットアップします。

HAクラスタ構成時の実行環境のセットアップの流れを次に示します。

図2‒8　HAクラスタ構成の場合のセットアップの流れ

図中の各工程について，次に説明します。

なお，HAクラスタ構成での運用については，「5.7.2　HAクラスタ構成での運用」を参照してください。

(1)　セットアップの準備

セットアップ前に，次の作業を行います。次の作業は，実行系および待機系でそれぞれ行います。

実行環境に必要なソフトウェアの設定

J2EEサーバのセットアップなどを行います。設定する内容と設定方法については，「3.1.2　実行環境に必要なソフトウェアを設定する」を参照してください。

なお，セットアップ時には，Reliable Messagingのシステム名を実行系と待機系で同じ名称に設定する必要があります。

また，グローバルトランザクションを利用する場合，J2EEサーバのクラスタIPアドレスでホストを固定する必要があります。ホストを固定する方法については，次の個所を参照してください。

アプリケーションサーバを対象にした1:1系切り替えシステムの設定

Windowsの場合

マニュアル「アプリケーションサーバ 機能解説 運用／監視／連携編」の「17.4.2　クラスタサーバの環境設定」

UNIXの場合

マニュアル「アプリケーションサーバ 機能解説 運用／監視／連携編」の「17.6.2　クラスタサーバの環境設定」

ローカルトランザクションを利用する場合，ホストの固定は不要です。ローカルホスト，または物理IPアドレスを設定してください。

サービスリクエスタへの送信制御

サービスリクエスタ用のネットワークを切断するなどして，実行系および待機系でサービス部品の実行要求を受け付けられない状態にします。

(2)　実行環境（待機系）のセットアップ

実行環境（待機系）のセットアップ手順を次に示します。

次の順序でプロセスを起動します。

起動順

起動するプロセス

起動方法

1

運用管理エージェント

マニュアル「アプリケーションサーバ システム構築・運用ガイド」を参照してください。

2

Management Server

3

PRF

4

J2EEサーバ

5

HTTP Server

「5.3.6　HTTP Serverを起動する」を参照してください。

HCSCサーバをセットアップします。

HCSCサーバのセットアップ方法については，「3.1.3　HCSCサーバをセットアップする」を参照してください。

HCSCサーバを起動します。

HCSCサーバの起動方法については，「5.3.4　HCSCサーバを起動する」を参照してください。

サービスアダプタとビジネスプロセスを配備します。

サービスアダプタとビジネスプロセスの配備方法については，「3.1.8　サービスアダプタを配備する」および「3.1.13　ビジネスプロセスを配備する」を参照してください。

サービスアダプタとビジネスプロセスを開始します。

サービスアダプタとビジネスプロセスの開始方法については，「5.3.7　サービスアダプタを開始する」および「5.3.8　ビジネスプロセスを開始する」を参照してください。

HCSCサーバを停止します。

サービスアダプタおよびビジネスプロセスを起動したままHCSCサーバを停止します。

HCSCサーバの停止方法については，「5.3.41　HCSCサーバを停止する」を参照してください。

Management Serverおよび運用管理エージェントを停止します。

Management Serverおよび運用管理エージェント（運用管理機能）の停止方法については，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「3.1.3　システムを停止する（GUI利用時）」を参照してください。

(3)　実行環境（実行系）のセットアップ

実行環境（実行系）のセットアップ手順を次に示します。

次の順序でプロセスを起動します。

起動順

起動するプロセス

起動方法

1

運用管理エージェント

マニュアル「アプリケーションサーバ システム構築・運用ガイド」を参照してください。

2

Management Server

3

PRF

4

J2EEサーバ

5

HTTP Server

「5.3.6　HTTP Serverを起動する」を参照してください。

HCSCサーバをセットアップします。

HCSCサーバのセットアップ方法については，「3.1.3　HCSCサーバをセットアップする」を参照してください。

なお，実行系のHCSCサーバをセットアップするときには，cscsvsetupコマンドの-clusterオプションに指定するクラスタ名を，待機系と同じ値にする必要があります。

cscsvsetupコマンドについては，マニュアル「サービスプラットフォーム リファレンス」の「cscsvsetup（HCSCサーバのセットアップ）」を参照してください。

HCSCサーバを起動します。

HCSCサーバの起動方法については，「5.3.4　HCSCサーバを起動する」を参照してください。

サービスアダプタとビジネスプロセスを配備します。

待機系に配備したサービスアダプタおよびビジネスプロセスと同じものを配備します。実行系と待機系の間では，配備されているサービスアダプタおよびビジネスプロセスに過不足がないようにします。

サービスアダプタとビジネスプロセスの配備方法については，「3.1.8　サービスアダプタを配備する」および「3.1.13　ビジネスプロセスを配備する」を参照してください。

サービスアダプタとビジネスプロセスを開始します。

待機系で開始したサービスアダプタおよびビジネスプロセスと同じものを開始します。実行系と待機系の間では，サービスアダプタおよびビジネスプロセスの状態に差異がないようにします。

サービスアダプタとビジネスプロセスの開始方法については，「5.3.7　サービスアダプタを開始する」および「5.3.8　ビジネスプロセスを開始する」を参照してください。

標準受付を開始します。

標準受付の開始方法については，「5.3.10　標準受付を開始する」を参照してください。

(4)　クラスタソフトウェアの設定

クラスタソフトウェアでは，実行系に障害が発生したときに待機系に切り替えるための設定を行います。

待機系に切り替えるときに次の操作を行うスクリプトを実行するように設定します。次に示す順に実行されるように設定してください。

なお，OSやHCSC-Managerのユーザなどは，実行系と合わせる必要があります。

待機系のプロセスの起動

次の順序でプロセスを起動するように設定します。

運用管理エージェント

Management Server

PRF

HTTP Server

待機系のHCSCサーバの起動※

待機系のHCSCサーバの標準受付の開始

注※

クラスタソフトウェアで待機系のHCSCサーバをcscutilコマンドで起動する場合，次のようにオプションを設定します。

-hostオプション

Management Serverを起動するホスト名（またはIPアドレス）とポート番号をコロン（:）で連結して指定します。ホスト名には「localhost」を指定します。ポート番号が「28099」の場合の指定例を次に示します。

-host localhost:28099

-mnguserオプション

Management Serverの管理ユーザのユーザIDを指定します。

-mngpassオプション

Management Serverの管理ユーザのパスワードを指定します。

2.7　ロードバランスクラスタ構成とHAクラスタ構成の組み合わせによる実行系マシンと待機系マシンがN対1構成の場合の環境構築

ロードバランスクラスタを構成するHCSCサーバをHAクラスタ相当のコールドスタンバイ構成にすることで，N台の実行系マシンに対して，すべての待機系を1台のマシン上で構築できます。この構成をN対1クラスタ構成といいます。

HAクラスタを構成する場合，クラスタソフトウェアを利用します。サービスプラットフォームでは，次に示すクラスタソフトウェアを利用できます。

Windowsの場合

Windows Server Failover Cluster

UNIXの場合

HAモニタ

HCSCサーバをN対1のクラスタ構成にする場合の環境構築およびセットアップの方法について，次に説明します。

2.7.1　N対1クラスタ構成時の環境構築

N対1クラスタ構成では，クラスタを構成するすべてのHCSCサーバについて，HCSCサーバ構成定義ファイルで設定するクラスタ種別に「HA」を設定してください。クラスタ種別が「LB」の場合，N対1クラスタ構成を構築できません。

なお，標準の非同期受付（MDB（WS-R）／MDB（DBキュー））を使用する場合は，HAクラスタ相当のHCSCサーバの組にリクエストを送信するように，リクエスタを設定する必要があります。

注意事項

HCSCクラスタのGUI表示名は，システム内で一意にしてください。

サーバ障害時の別HCSCサーバからのビジネスプロセスの再実行について

別HCSCサーバからビジネスプロセスを再実行する場合，次に示す情報については共有ディスク装置に格納する必要があります。

作業フォルダ

共通フォルダ

ファイルアダプタで利用する入出力許可ファイル

次に示す情報についてはローカルディスク装置に格納します。ただし，各HCSCサーバで同じ値を設定する必要があります。

メールアダプタで利用するメール本文のテキストファイル，および添付ファイル

HCSCサーバの運用で利用する定義ファイル

HCSCコンポーネントで利用する定義ファイル

作業フォルダを使用するビジネスプロセスの再実行について

作業フォルダを使用するビジネスプロセスであり，かつ09-51より前のバージョンで実行したビジネスプロセスについては，別HCSCサーバからビジネスプロセスを再実行することはできません。

作業フォルダの代わりに共通フォルダを使用している場合，または09-51以降で実行している場合は，ビジネスプロセスを再実行することができます。しかし，次に示すコンポーネントを使用するビジネスプロセスについては，共通フォルダを使用することができないため，09-51より前のバージョンで実行したビジネスプロセスを再実行することはできません。

FTP受付

HTTP受付

N対1クラスタ構成でHCSCサーバを運用するための環境構築手順を次に示します。

(1)　実行環境（実行系・待機系）の構築

実行環境を構築するには，実行系および待機系で次の作業を実施します。

(a)　Service Platformのインストール

それぞれのマシンにService Platformをインストールします。

Service Platformのインストール方法については，「2.1.2　Service Platformのインストール」を参照してください。

(b)　Management Serverの設定

運用環境でHCSC-Managerを使用するためのManagement Serverの設定を，HCSC-Managerの接続先となる実行環境で実施します。

Management Serverの設定については，「2.1.6　HCSC-Managerを使用するためのManagement Serverの設定」を参照してください。

(c)　SOAPモードの設定

HCSCサーバをN対1クラスタ構成にする場合，構成する実行環境および運用環境で利用するSOAPモードを合わせる必要があります。異なるSOAPモードの環境は共存できません。

SOAPモードを設定するには，J2EEサーバのコンテナ拡張ライブラリの設定が必要になります。J2EEサーバのコンテナ拡張ライブラリの設定については，「3.1.2(4)(e)　コンテナ拡張ライブラリの設定」を参照してください。

(d)　HCSCサーバの構成などの設定

構築するHCSCサーバの種類（実行系・待機系）に応じて，HCSCサーバの構成などの実行環境に関する設定を各マシンで実施します。設定内容および設定方法はロードバランスクラスタ構成やHAクラスタ構成の構築時と同じです。設定内容と設定方法については，「2.3　実行環境に関する設定」を参照してください。

実行系または待機系のHCSCサーバを構築する場合の構成例とHCSCサーバの構成などの設定手順について，次に示します。

●実行系のHCSCサーバを構築する場合

HAクラスタ構成（HCSCサーバ1・HCSCサーバ4）に，ロードバランスクラスタ相当のHCSCサーバ（HCSCサーバ2）を追加する場合の構築例を次の図に示します。

図2‒9　実行系のHCSCサーバの構築例（HCSCサーバ2を追加した例）

実行系のHCSCサーバを構築する場合の設定手順はロードバランスクラスタ構成の設定手順と基本的に同じですが，次の点に注意してください。

HCSCサーバ構成定義ファイルに設定するクラスタ種別は「HA」と指定してください。

HCSCサーバセットアップ定義ファイルに設定するRMシステム名は，クラスタ内の実行系HCSCサーバ間でユニークな名称を指定してください。重複するRMシステム名を設定すると，セットアップではエラーにはなりませんが，Reliable Messagingの起動時にデッドロックが発生します。

なお，ロードバランスクラスタ構成の設定手順については「2.5.1　ロードバランスクラスタ構成時の環境構築」のHCSCサーバ構成などの設定を参照してください。

●待機系のHCSCサーバを構築する場合

「実行系のHCSCサーバを構築する場合」の図に示す構成で，HCSCサーバ2の待機系であるHCSCサーバ5をマシン4で構築する場合の例を次の図に示します。

図2‒10　実行系のHCSCサーバの構築例（HCSCサーバをマシン4で構築した例）

待機系のHCSCサーバを構築する場合の設定手順はHAクラスタ構成の設定手順と基本的に同じですが，次の点に注意してください。

待機系のHCSCサーバを1台のマシンに構築するため，HCSCサーバ構成定義ファイルで設定するJ2EEサーバ名はマシン内でユニークな名称を指定してください。

HCSCサーバセットアップ定義ファイルで設定するRMシステム名は，ロードバランスクラスタ構成内の実行系HCSCサーバと同じ名称を指定してください。実行系と異なるRMシステム名を設定すると，セットアップではエラーにはなりませんが，Reliable Messagingを使用した処理が引き継げなくなります。

なお，HAクラスタ構成の構築手順については「2.6.1　HAクラスタ構成時の環境構築」のHCSCサーバ構成などの設定を参照してください。

実行環境に関する設定でHCSCサーバ構成定義ファイル，HCSCサーバセットアップ定義ファイル，およびHCSCサーバランタイム定義ファイルを設定する場合には，次に示す内容に留意してください。

HCSCサーバ構成定義ファイルの設定時の注意事項

セットアップ時に，HCSCサーバ構成定義ファイルに次に示す値を設定してください。

HCSCサーバ構成定義ファイルの設定方法については，「2.3.1　HCSCサーバ構成定義ファイルを設定する」を参照してください。

HCSCサーバ構成定義ファイルに設定する内容の詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.4.2　HCSCサーバ構成定義ファイル」を参照してください。

設定項目

設定する値

クラスタ表示名

クラスタ内で同一の値

クラスタ種別

クラスタ内で同一の値

manager名

システムで一意になる値

managerのIPアドレス

管理用物理IPアドレス

WebサーバのIPアドレス（同期サービス（Webサービス）呼び出しをする場合）

クラスタ内で同一の値

WebサーバのIPアドレス（非同期サービス（MDB（WS-R））呼び出しをする場合）

それぞれのHCSCサーバの受付IPアドレス

（実行系と待機系とで同一のIPアドレス（仮想IPアドレス）を指定）

NameServerのIPアドレス

クラスタ内で同一の値

HCSCサーバセットアップ定義ファイルの設定時の注意事項

HCSCサーバセットアップ定義ファイルを設定する場合には，次に示す内容に留意してください。HCSCサーバセットアップ定義ファイルの設定方法については，「2.3.2　HCSCサーバセットアップ定義ファイルを設定する」を参照してください。HCSCサーバセットアップ定義ファイルに設定する内容の詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.4.3　HCSCサーバセットアップ定義ファイル」を参照してください。

すべてのHCSCサーバで同じ値を設定するプロパティ

HCSCサーバセットアップ定義ファイルに設定するプロパティのうち，次の表に示すプロパティはN対1クラスタ内のすべてのHCSCサーバで同じ値を設定する必要があります。

表2‒25　N対1クラスタ内のHCSCサーバで同じ値を設定するプロパティ

同じ値を指定するプロパティ

プロパティに設定する値

request-ejb

標準の同期受付（SessionBean）の使用有無

request-soap

標準の同期受付（Webサービス）の使用有無

request-jms

標準の非同期受付（MDB（WS-R））の使用有無

request-jms.maxmessage

標準の非同期受付（MDB（WS-R））のキューの最大メッセージ数

request-dbq

標準の非同期受付（MDB（DBキュー））の使用有無

request-dbq.maxmessage

標準の非同期受付（MDB（DBキュー））のキューの最大メッセージ数

request-jms-rdarea

標準の非同期受付（MDB（WS-R））のRDエリア名

request-dbq-rdarea

標準の非同期受付（MDB（DBキュー））のRDエリア名

request-dbq-maxlen

標準の非同期受付（MDB（DBキュー））の最大メッセージ長

rm-displayname

Reliable Messagingの表示名

dbcon-xadisplayname※1

XATransactionまたはLocalTransaction用DB Connectorの表示名

dbcon-nodisplayname※1

NoTransaction用DB Connectorの表示名

dbtype

使用するデータベース種別

jdbc-type

JDBCドライバ種別

jdbc-url※2

JDBC用データベースURL

jdbc-dbhostname

データベースのホスト名

jdbc-dbconnectinfo

データベースの接続情報

db-character-sets

データベース文字コード種別

db-tbl-split-key

日付データによるテーブルのレンジ分割機能の使用有無

db-tbl-split-corcheck-use

相関セットの重複チェックの強化有無

注※1

DBコネクタの設定もロードバランスクラスタ内のすべてのHCSCサーバで同じにします。

注※2

指定するホスト名には，データベースを格納しているマシンを指定します。

HCSCサーバランタイム定義ファイルの設定時の注意事項

HCSCサーバランタイム定義ファイルを設定する場合，ロードバランスクラスタ内のすべてのHCSCサーバですべてのプロパティを同じ値に設定する必要があります。

また，CTMを使用する場合，次のプロパティを追加してください。

request-ejb.ctm=true

クラスタを構成するHCSCサーバでJ2EEサーバ名が異なる場合，次のプロパティを追加してください。

request-ejb.optional.name=<クラスタ内で共通の同期リクエスタサービス（SessionBean）の別名>

HCSCサーバランタイム定義ファイルの設定方法については，「2.3.3　HCSCサーバランタイム定義ファイルを設定する」を参照してください。

HCSCサーバランタイム定義ファイルに設定する内容の詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.5.6　HCSCサーバランタイム定義ファイル」を参照してください。

(e)　クラスタソフトウェアのインストール

クラスタソフトウェアをインストールします。インストール方法は，利用するクラスタソフトウェアのドキュメントを参照してください。

(2)　運用環境の構築

運用環境は，クラスタを構成するHCSCサーバのマシンに構築します。

運用環境と実行環境の構成については，マニュアル「サービスプラットフォーム 解説」の「1.5　クラスタ構成における運用環境の構成パターン」を参照してください。

運用環境を構築するには，次の作業を実施します。

環境設定

運用環境の環境設定としてリポジトリの設定と環境変数の設定を実施します。

環境設定については，「2.1.3　環境設定」を参照してください。

EclipseへのHCSC-Manager Plug-inの組み込み

EclipseにHCSC-Manager Plug-inを組み込みます。

EclipseへのHCSC-Manager Plug-inの組み込みについては，「2.1.5　EclipseへのHCSC-Manager Plug-inの組み込み」を参照してください。

ユーザ権限などの設定

ユーザ権限などの運用環境に関する設定を行います。設定する内容と設定方法については，「2.4　運用環境に関する設定」を参照してください。

(3)　DBサーバの構築

DBサーバは，クラスタを構成するHCSCサーバから独立して構築し，クラスタ内のHCSCサーバで共有します。

DBサーバとして利用するマシンに利用するデータベースをインストールしてください。インストール方法は，利用するデータベースのドキュメントを参照してください。

2.7.2　N対1クラスタ構成時の実行環境のセットアップ

環境の構築後，N対1クラスタを構成する実行環境をセットアップします。

N対1クラスタ構成時の実行環境のセットアップの流れを次に示します。

図2‒11　N対1クラスタ構成の場合のセットアップの流れ

図中の各工程について次に説明します。なお，N対1クラスタ構成での運用については，「5.7.2　HAクラスタ構成での運用」を参照してください。

(1)　セットアップの準備

セットアップ前に，次の作業を行います。次の作業は，実行系および待機系でそれぞれ行います。

実行環境に必要なソフトウェアの設定

J2EEサーバのセットアップなどを行います。設定する内容と設定方法については，「3.1.2　実行環境に必要なソフトウェアを設定する」を参照してください。

なお，セットアップ時には，クラスタの種類に応じてReliable Messagingのシステム名※を次のように設定してください。

HAクラスタ内の場合

実行系と待機系で同じ名称に設定してください。

ロードバランスクラスタ内の場合

それぞれのHCSCサーバでユニークな名称に設定してください。

注※

RMシステムごとに作成するキュー名を次に示します。

Queue.1.DisplayName= HCSC<クラスタ名>ACPT_RCVQ

Queue.1.QueueName= HCSC<クラスタ名>ACPT_RCVQ

Queue.2.DisplayName= HCSC<クラスタ名>ACPT_DBQ

Queue.2.QueueName= HCSC<クラスタ名>ACPT_DBQ

Queue.3.DisplayName= HCSC<クラスタ名>TRNS_RCVQ

Queue.3.QueueName= HCSC<クラスタ名>TRNS_RCVQ

サービスリクエスタへの送信制御

サービスリクエスタ用のネットワークを切断するなどして，実行系および待機系でサービス部品の実行要求を受け付けられない状態にします。

CTMを使用する場合の設定

CTMを使用する場合，HCSCサーバランタイム定義ファイルでrequest-ejb.ctmにtrueを設定してください。

HCSCサーバランタイム定義ファイルの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.5.6　HCSCサーバランタイム定義ファイル」を参照してください。

(2)　実行環境（待機系）のセットアップ

実行環境（待機系）のセットアップ手順については，「2.6.2(2)　実行環境（待機系）のセットアップ」を参照してください。

(3)　実行環境（実行系）のセットアップ

実行環境（実行系）のセットアップ手順については，「2.6.2(3)　実行環境（実行系）のセットアップ」を参照してください。

(4)　クラスタソフトウェアの設定

HAクラスタ構成の場合，クラスタソフトウェアを設定します。

クラスタソフトウェアの設定方法については，「2.6.2(4)　クラスタソフトウェアの設定」を参照してください。

(5)　ロードバランサの設定

ロードバランスクラスタを構成しているすべてのHCSCサーバへサービス部品の実行要求を送信するように設定します。

CTMを使用する場合，すべてのHCSCサーバでCTMドメインマネジャ名およびスマートエージェントのポート番号を同じ値に設定する必要があります。

汎用ロードバランサの設定方法については，使用する汎用ロードバランサのドキュメントを参照してください。

(6)　標準受付の開始

すべてのHCSCサーバの標準受付を開始します。標準受付の開始方法については，「5.3.10　標準受付を開始する」を参照してください。

(7)　ロードバランサの接続

ロードバランサを接続し，使用できる状態にします。CTMを使用する場合はこの手順は不要です。

汎用ロードバランサの接続開始方法については，使用する汎用ロードバランサのドキュメントを参照してください。

2.8　JP1連携機能を使用する場合の環境構築

JP1と連携することで，サービスプラットフォームで発生した障害を監視できます。障害を監視することでトラブルの発生を検知して，原因を究明し，対策することができます。

サービスプラットフォームでは，発生した障害のメッセージをJP1イベントとしてJP1に通知します。JP1イベントの詳細情報は，JP1の統合コンソールから確認します。確認方法については，「7.8.1　JP1連携機能を使用した障害の監視」を参照してください。

JP1と連携した障害監視の流れを次の図に示します。

図2‒12　JP1と連携した障害監視の流れ

JP1イベント発行の設定をします。

Smart Composerでどのようなエラーや障害情報をJP1イベントとして発行するかを設定します。設定方法については，「2.8.2　サービスプラットフォームのJP1イベント発行の設定」を参照してください。

サービスプラットフォームで障害が発生した場合，障害に関するメッセージがJP1イベントとしてJP1/Baseに発行されます。

JP1イベントはJP1統合運用管理サーバに通知されます。

JP1統合運用管理サーバに通知されたJP1イベントは，JP1/IM - Managerが収集します。

JP1/IMの自動アクション機能を使って運用管理者への通知を設定している場合は，障害が発生したことが運用管理者に通知されます。

統合コンソールからJP1イベントの詳細情報を確認します。

確認方法については，「7.8.1　JP1連携機能を使用した障害の監視」を参照してください。

注意事項

実行環境にHCSCサーバが1つまたは複数配備されている場合，次に示す環境を1台のホストに構築できます。

実行環境

運用環境

JP1統合運用管理サーバ

運用管理クライアント

ただし，複数のHCSCサーバが異なるホストに配備されている場合は，図2-12のように，それぞれ別のホストに構築してください。

2.8.1　JP1連携の設定の流れ

JP1連携機能を使用するためには，次の表に示すJP1の製品をインストールおよびセットアップする必要があります。

表2‒26　JP1連携機能を使用するために必要なJP1の製品

インストール先

JP1の製品

実行環境

JP1/Base

JP1統合運用管理サーバ

JP1/Base

JP1/IM - Manager

運用管理クライアント

JP1/IM - View※

注※

Windowsの場合だけインストールできます。Windows以外の場合，統合コンソールは表示できません。

JP1の製品のインストールおよびセットアップについては，マニュアル「JP1/Integrated Management - Manager 構築ガイド」，またはマニュアル「JP1/Integrated Management - Manager 運用ガイド」を参照してください。

JP1と連携するための設定の流れを次に示します。

実行環境で，次の設定をします。

サービスプラットフォームのJP1イベント発行の設定（2.8.2参照）

サービスプラットフォームで発生した障害のメッセージを，JP1イベントとして発行するための設定を行います。

JP1/Baseのイベントサーバ名の設定（2.8.3参照）

HAクラスタ構成の場合で，論理ホストのJP1/Baseのイベントサーバを使用してJP1イベントを発行するときだけ設定を行います。

JP1統合運用管理サーバで，次の作業をします。

JP1/Baseの構成定義の作成（2.8.4参照）

JP1統合運用管理サーバが管理するシステムの階層関係を定義します。

この定義を各ホストに配布すると，転送先の情報として識別されます。

2.8.2　サービスプラットフォームのJP1イベント発行の設定

サービスプラットフォームで発生した障害のメッセージをJP1イベントとして発行するためには，次の2つの設定をします。

Management Server用JP1イベントの設定

J2EEサーバ用JP1イベントの設定

それぞれの設定方法について説明します。

(1)　Management Server用JP1イベントの設定

Management Server環境設定ファイル（mserver.properties）に次のように設定します。この設定をすると，Management Serverから，障害に関するメッセージがJP1イベントとして，JP1/Baseに発行されます。

Management Server環境設定ファイルについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「8.2.6　mserver.properties（Management Server環境設定ファイル）」を参照してください。

com.cosminexus.mngsvr.jp1event.enabled=true
com.cosminexus.mngsvr.jp1event.warning=true
com.cosminexus.mngsvr.jp1event.emergency=true
com.cosminexus.mngsvr.jp1event.alert=true
com.cosminexus.mngsvr.jp1event.notice=true
com.cosminexus.mngsvr.jp1event.information=true
com.cosminexus.mngsvr.jp1event.error=true
com.cosminexus.mngsvr.jp1event.critical=true

設定した情報を有効にするために，Management Serverを再起動してください。

(2)　J2EEサーバ用JP1イベントの設定

簡易構築定義ファイルのJ2EEサーバのコンフィグレーションに次のようにパラメタを指定します。この指定をすると，J2EEサーバから障害に関するメッセージが，JP1イベントとしてJP1/Baseに発行されます。

簡易構築定義ファイルについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.3　簡易構築定義ファイル」を参照してください。

<configuration>
  <logical-server-type>j2ee-server</logical-server-type>
  <param>
    <param-name>ejbserver.manager.agent.JP1EventAgent.enabled</param-name>
    <param-value>true</param-value>
  </param>
  <param>
    <param-name>manager.jp1event.system.filtering.severity.emergency</param-name>
    <param-value>true</param-value>
  </param>
  <param>
    <param-name>manager.jp1event.system.filtering.severity.alert</param-name>
    <param-value>true</param-value>
  </param>
  <param>
    <param-name>manager.jp1event.system.filtering.severity.critical</param-name>
    <param-value>true</param-value>
  </param>
  <param>
    <param-name>manager.jp1event.system.filtering.severity.error</param-name>
    <param-value>true</param-value>
  </param>
  <param>
    <param-name>manager.jp1event.system.filtering.severity.warning</param-name>
    <param-value>true</param-value>
  </param>
  <param>
    <param-name>manager.jp1event.system.filtering.severity.notice</param-name>
    <param-value>true</param-value>
  </param>
  <param>
    <param-name>manager.jp1event.system.filtering.severity.information</param-name>
    <param-value>true</param-value>
  </param>
</configuration>

2.8.3　JP1/Baseのイベントサーバ名の設定

HAクラスタ構成の場合で，論理ホストのJP1/Baseのイベントサーバを使用してJP1イベントを発行するとき，次の2つの設定をします。

実行環境用イベントサーバ名の設定

J2EEサーバ用イベントサーバ名の設定

それぞれの設定方法について説明します。

(1)　Management Server用イベントサーバ名の設定

Management Server環境設定ファイル（mserver.properties）にJP1統合運用管理サーバの論理ホスト名または論理IPアドレスを設定します。

Management Server環境設定ファイルについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「8.2.6　mserver.properties（Management Server環境設定ファイル）」を参照してください。

mngsvr.jp1event.event_server_name=<論理ホスト名または論理IPアドレス>

設定した情報を有効にするために，Management Serverを再起動してください。

(2)　J2EEサーバ用イベントサーバ名の設定

簡易構築定義ファイルのJ2EEサーバのコンフィグレーションにJP1統合運用管理サーバの論理ホスト名または論理IPアドレスを指定します。

簡易構築定義ファイルについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.3　簡易構築定義ファイル」を参照してください。

<configuration>
  <logical-server-type>j2ee-server</logical-server-type>
  <param>
    <param-name>ex.properties.m</param-name>
    <param-value>.ejbserver.manager.jp1event.event_server_name=<論理ホスト名または論理IPアドレス></param-value>
  </param>
</configuration>

2.8.4　JP1/Baseの構成定義の作成

JP1/IMが管理するシステムの構成を，JP1/Baseの構成定義ファイルに定義します。

JP1/Baseの配布機能を利用して，作成した定義を各ホストのJP1/Baseに配布すると，定義情報を一括して管理できます。

なお，1台のホストで実行環境，運用環境，JP1統合運用管理サーバ，および運用管理クライアントを構成した場合，JP1/Baseの構成定義の作成は不要です。

JP1/Baseの構成定義の作成手順を次に示します。なお，JP1/IMを使用する場合の詳細については，マニュアル「JP1/Integrated Management - Manager 構築ガイド」またはマニュアル「JP1/Integrated Management - Manager 運用ガイド」の，システムの構成定義情報の設定に関する説明を参照してください。

JP1/Baseの構成定義ファイルを作成して，システムの構成を定義します。

構成定義ファイル（jbs_route.conf）は次の場所にインストールされています。

Windowsの場合

HAクラスタ構成で運用しているとき

<共有フォルダ>¥jp1base¥conf¥route¥jbs_route.conf

HAクラスタ構成で運用していないとき

<JP1/Baseのインストール先フォルダ>¥conf¥route¥jbs_route.conf

UNIXの場合

HAクラスタ構成で運用しているとき

<共有ディレクトリ>/jp1base/conf/route/jbs_route.conf

HAクラスタ構成で運用していないとき

/etc/opt/jp1base/conf/route/jbs_route.conf

構成定義ファイルの内容

［JP1統合運用管理サーバのホスト名］

J2EEサーバマシンのホスト名

jbsrt_distribコマンドを実行して，構成定義情報を配布します。

jbsrt_distribコマンドは次の場所に格納されています。

Windowsの場合

HAクラスタ構成で運用しているとき

<共有フォルダ>¥jp1base¥bin¥jbsrt_distrib.exe

HAクラスタ構成で運用していないとき

<JP1/Baseのインストール先フォルダ>¥bin¥jbsrt_distrib.exe

UNIXの場合

HAクラスタ構成で運用しているとき

<共有ディレクトリ>/jp1base/bin/jbsrt_distrib

HAクラスタ構成で運用していないとき

/etc/opt/jp1base/bin/jbsrt_distrib

注意

HAクラスタ構成で運用する場合は，-hオプションに論理サーバ名を指定する必要があります。

2.8.5　メッセージマッピングファイルの編集

メッセージマッピングファイルのファイル（JP1/IM連携用システムログメッセージマッピングファイル）は，J2EEサーバが検知した障害や通知を，メッセージごとにどの重大度のJP1イベントに変換するか定義したファイルです。メッセージマッピングファイルを編集して，JP1イベントとして発行するメッセージを制御するなど，JP1イベントをカスタマイズできます。なお，マッピング定義がなくJP1イベントの重大度を割り当てられないメッセージは，JP1イベントとして発行されません。

メッセージマッピングファイルのファイル名は「manager.jp1event.system.mapping.properties」です。マッピング関係を定めた標準的なメッセージマッピングファイルを提供しているので，必要に応じて，テキストエディタなどで編集してください。メッセージマッピングファイルの格納場所を次に示します。

Windowsの場合

<サービスプラットフォームのインストールディレクトリ>¥manager¥config

UNIXの場合

/opt/Cosminexus/manager/config

JP1/IM連携用システムログメッセージマッピングファイルについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「8.3　JP1/IM連携用システムログメッセージマッピングファイル」を参照してください。

2.9　1台のマシンに複数の運用・実行環境を構築する場合の環境構築

HCSC-Managerの環境は基本的に1台のマシンに1つですが，CSCMNG_HOME環境変数を設定することで，1台のマシンに2つ以上の環境を構築できます。

1台のマシンに複数の環境を構築した場合のシステム構成例，および構築の流れについて，次に説明します。

2.9.1　1台のマシンに複数の環境を構築する場合のシステム構成例

ここでは，開発環境を複数に分割する例と，クラスタ単位にHCSC-Managerの環境を分割する例を示します。

(1)　開発環境を複数に分割する

1台のマシンに複数のテスト環境を構築する方法として，次の2とおりがあります。

使用するテスト環境ごとにCSCMNG_HOME環境変数を割り当てる

cscsetupコマンドの追加構築可能環境セットアップ機能を使用する

CSCMNG_HOME環境変数を割り当てる方法で，開発用のマシンで複数の運用・実行環境を構築する例を次の図に示します。

図2‒13　開発用のマシンで複数の運用・実行環境を構築する例

ただし，環境ごとにCSCMNG_HOME環境変数を割り当てると，HCSC簡易セットアップ機能を使用できないため，HCSCサーバのセットアップから一つ一つ環境を構築していく必要があります。

また，CSCMNG_HOME環境変数を割り当てると，HCSC本番環境簡易セットアップ機能（cscsetupコマンド）も使用できません。HCSC本番環境簡易セットアップ機能を使用してセットアップしてある場合は，アンセットアップしてからCSCMNG_HOME環境変数を割り当てて，そのあとに，本番環境簡易セットアップ機能を使用しない方法でセットアップしてください。なお，HCSC本番環境簡易構築機能の追加構築可能環境セットアップ機能でセットアップしている場合は，アンセットアップを実施する必要はありません。

(2)　クラスタ単位にHCSC-Managerの環境を分割する

大規模構成で複数クラスタを扱う場合，リポジトリを分割することで，リポジトリが破壊されても，ほかのクラスタは影響を受けることなく運用できるなど，障害発生時の局所化ができます。

複数クラスタで運用する必要があり，かつ実行環境と運用環境を異なるマシンに構築する場合は，クラスタ単位に運用環境を分割することを推奨します。

クラスタ単位に運用環境を分割する例を次の図に示します。

図2‒14　クラスタ単位に運用環境を分割する例

2.9.2　1台のマシンに複数の環境を構築する流れ

1台のマシンに複数のHCSC-Manager環境を構築する場合の流れを次の図に示します。

図2‒15　1台のマシンに複数のHCSC-Manager環境を構築する場合の流れ

(1)　CSCMNG_HOME環境変数の設定

1台のマシンに複数のHCSC-Manager環境を構築する場合，構築する環境の数だけCSCMNG_HOME環境変数を設定する必要があります。

CSCMNG_HOME環境変数には任意フォルダの絶対パスを設定してください。設定したパスの下にある定義ファイルがHCSC-Managerによって参照されます。

ポイント

任意フォルダの絶対パスは，「c:¥cscmng」など用途がわかりやすい設定にすることを推奨します。

HCSC-Managerが参照するCSCMNG_HOME環境変数以下の定義ファイルを次の表に示します。

表2‒27　HCSC-Managerが参照するCSCMNG_HOME環境変数以下の定義ファイル

ディレクトリ名

説明

%CSCMNG_HOME%¥config

運用環境で使用するコンフィグファイル格納ディレクトリ

%CSCMNG_HOME%¥log

運用環境で使用するデフォルトログディレクトリ

%CSCMNG_HOME%¥repository

運用環境で使用するデフォルトリポジトリディレクトリ

%CSCMNG_HOME%¥spool

運用環境で使用する一時ディレクトリ

注意事項

同一のCSCMNG_HOME環境変数で複数のHCSC-Manager環境を構築する場合，CSCMNG_HOME環境変数を設定したあとに，CSCMNGのすべてのコマンドでCSCMNG_HOME環境変数を同一の値に設定した状態で実行してください。

設定が漏れにくいようにするため，ユーザ環境変数，コマンドプロンプトのショートカット，リソース設定用シェルスクリプトを作成することを推奨します。

次にCSCMNG_HOME環境変数の設定例を示します。

(a)　CSCMNG_HOME環境変数の設定例（Windowsの場合）

「c:¥cscmng」を設定する例を示します。

●ユーザ環境変数の設定例

「c:¥cscmng」を設定する例を次の図に示します。

環境変数を設定するダイアログを表示し，次のように入力します。

［OK］ボタンをクリックします。

CSCMNG_HOME環境変数が有効になります。

●コマンドプロンプトのショートカットの設定例

コマンドプロンプトのショートカットの設定手順を次に示します。

次の内容を記述したcscmng_env.batファイルを任意のディレクトリに作成します。

set CSCMNG_HOME=C:¥cscmng

コマンドプロンプトのショートカットを任意のディレクトリにコピーし，プロパティのリンク先を次のように変更します。

cmd.exe /K <手順1.で作成したcscmng_env.batファイルのフルパス>

(b)　CSCMNG_HOME環境変数の設定例（UNIXの場合）

「/home/user1/cscmng」を設定する例を示します。

●Bourneシェルの設定例

Bourneシェルで設定する例を次に示します。

次の内容を記述したcscmng.shファイルを任意のディレクトリに作成します。

export CSCMNG_HOME=/home/user1/cscmng

次に示す形式でシェルを実行します。

. cscmng.sh

シェルを実行すると，cscmng.shファイルを読み込み，CSCMNG_HOME環境変数が有効になります。

●Cシェルの設定例

Cシェルで設定する例を次に示します。

次の内容を記述したcscmng.cshファイルを任意のディレクトリに作成します。

setenv CSCMNG_HOME /home/user1/cscmng

次に示す形式でシェルを実行します。

source cscmng.csh

シェルを実行すると，cscmng.cshファイルを読み込み，CSCMNG_HOME環境変数が有効になります。

(2)　運用環境の設定

1台のマシンに複数の運用環境を構築する場合は，構築する環境の数だけ設定が必要です。運用環境の設定方法については，「2.4　運用環境に関する設定」を参照してください。

HCSC-Manager定義ファイルおよびHCSC-Managerコマンドの共通定義を初期値から変更する場合の注意事項を次に示します。

(a)　HCSC-Manager定義ファイルを初期値から変更する場合の注意事項

%CSCMNG_HOME%¥config¥managerディレクトリを作成し，次のプロパティファイルを%CSCMNG_HOME%¥config¥managerディレクトリ下にコピーしてから使用してください。

<サービスプラットフォームのインストールディレクトリ>¥CSC¥config¥manager¥templates¥cscmng.properties

HCSC-Manager定義ファイルは，<サービスプラットフォームのインストールディレクトリ>¥CSC¥config¥manager¥cscmng.propertiesではなく，%CSCMNG_HOME%¥config¥manager¥cscmng.propertiesとなります。

HCSC-Manager定義ファイルが有効にならない場合は，%CSCMNG_HOME%¥config¥manager¥cscmng.propertiesが存在しているか確認してください。ファイルが存在する場合は，正しく編集されていることを確認してください。

(b)　HCSC-Managerコマンドの共通定義を初期値から変更する場合の注意事項

%CSCMNG_HOME%¥config¥managerディレクトリを作成し，次のプロパティファイルを%CSCMNG_HOME%¥config¥managerディレクトリ下にコピーしてから使用してください。

<サービスプラットフォームのインストールディレクトリ>¥CSC¥config¥manager¥templates¥csccmd.properties

HCSC-Managerコマンドの共通定義ファイルは，<サービスプラットフォームのインストールディレクトリ>¥CSC¥config¥manager¥csccmd.propertiesではなく，%CSCMNG_HOME%¥config¥manager¥csccmd.propertiesになります。

HCSC-Managerコマンド共通定義ファイルが有効にならない場合は，%CSCMNG_HOME%¥config¥manager¥csccmd.propertiesが存在しているか確認してください。ファイルが存在する場合は，正しく編集されていることを確認してください。

(3)　HCSCサーバのセットアップ

HCSCサーバのセットアップについては，「3.1　システムのセットアップ」を参照してください。

なお，HCSCサーバを複数セットアップする場合は，同数のJ2EEサーバも事前に構築する必要があります。

(4)　GUIの起動

HCSCサーバをセットアップしたあと，EclipseのGUIを使用して運用する場合は，CSCMNG_HOME環境変数が有効になっている状態で，Eclipseを起動してください。例えば，コマンドプロンプトにCSCMNG_HOME環境変数を有効にしている場合は，コマンドプロンプトからeclipse.exeを起動してください。

3　システムのセットアップとアンセットアップ

この章では，システムのセットアップ，アンセットアップ，およびHCSCサーバの定義について説明します。また，テスト環境から本番環境へ移行する場合の手順について説明します。

3.1　システムのセットアップ

サービスプラットフォームを利用してシステムをセットアップする方法について説明します。

3.1.1　システムのセットアップの流れ

システムのセットアップの流れについて，次の図に示します。なお，本番環境の簡易セットアップ機能を利用してシステムをセットアップする場合は，「3.5　本番環境の簡易セットアップ」を参照してください。

図3‒1　システムのセットアップの流れ

注※

これらの作業を一括して実行することもできます。その場合，HCSCコンポーネントの配備の前にはHCSCコンポーネントのパッケージングおよび配備定義が，配備のあとにはHCSCコンポーネントの開始が実行されます。

ただし，一括実行は，システム開発時，または単体テストから結合テスト時を対象としています。詳細については，マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」の「8.5　HCSCコンポーネントをHCSCサーバに配備して開始する処理の一括実行」を参照してください。

図中の各工程について，以降の項で説明します。

注意事項

サービスアダプタの配備，ビジネスプロセスの配備，ユーザ定義受付の配備の前に，リポジトリをインポートして，リポジトリを最新の状態にしてください。

運用時の処理の流れや障害発生時の対策によっては，運用開始前に必要な設定があります。詳細については，マニュアル「サービスプラットフォーム 解説」の「2.7.1　TP1から非同期の標準受付を使ったHCSCサーバのサービス部品の呼び出し」，およびこのマニュアルの「7.　障害対策」を参照してください。

UNIXの場合でComponent Container管理者を変更しているときは，Service Coordinator管理者を同一にしてください。詳細については，「付録A　Service Coordinator管理者の変更方法（UNIXの場合）」を参照してください。

3.1.2　実行環境に必要なソフトウェアを設定する

実行環境をセットアップする前に，実行環境に必要なソフトウェアの設定が必要です。実行環境に必要なソフトウェアの設定は，データベースとReliable Messagingの使用有無によって，次のように設定内容が異なります。

データベースを使用してReliable Messagingを使用しない場合

実行環境に必要なソフトウェアの設定の流れと，参照先を次の図に示します。

図3‒2　実行環境に必要なソフトウェアの設定（データベースを使用してReliable Messagingを使用しない場合）

データベースとReliable Messagingの両方を使用する場合

実行環境に必要なソフトウェアの設定の流れと，参照先を次の図に示します。

図3‒3　実行環境に必要なソフトウェアの設定（データベースとReliable Messagingの両方を使用する場合）

データベースとReliable Messagingの両方を使用しない場合

実行環境に必要なソフトウェアの設定の流れと，参照先を次の図に示します。

図3‒4　実行環境に必要なソフトウェアの設定（データベースとReliable Messagingの両方を使用しない場合）

実行環境のセットアップ前に実施するソフトウェアの設定について，次に説明します。

(1)　データベースのサーバ側のセットアップ

データベースのセットアップとして，DBサーバおよびDBクライアントの両方をセットアップします。

(a)　DBサーバ側の設定（HiRDBの場合）

次の作業を実施します。

HiRDBサーバの文字コードの設定

文字コードにシフトJIS漢字コード，EUC日本語漢字コード，UTF-8，または単一バイト文字コードのどれかを設定してください。文字コードの変更方法は，マニュアル「HiRDB システム導入・設計ガイド」の文字コードの指定，または文字コードの選択に関する内容を参照してください。

注意事項

HCSCサーバをUNIXで稼働させる場合は，HCSCサーバとHiRDBサーバの文字コードを合わせる必要があります。

環境設定

HiRDBの環境設定についてはマニュアル「HiRDB システム導入・設計ガイド」を参照してください。

ユーザ権限の設定

最初に，接続するユーザの名称を決定します。そのあと，HiRDBに管理情報を格納するため，HiRDBに接続するユーザに権限を設定します。HiRDBでは，ユーザにCONNECT権限を設定することでユーザが作成されます。

設定する権限

CONNECT権限

HiRDBを利用するために必要な権限です。データベースに接続（CONNECT）できるようになります。CONNECT権限を持たないユーザがHiRDBを利用しようとするとエラーになります。

スキーマ定義権限

スキーマを定義するために必要な権限です。スキーマ定義権限を設定すると，スキーマ，表，ビュー表，インデクス，抽象データ型を定義できます。また，ストアドプロシジャやストアドファンクションを登録できます。

権限の設定方法

データベース定義ユティリティ（pddef），HiRDB SQL Executerを使用して権限を設定します。権限の設定方法の詳細については，マニュアル「HiRDB システム運用ガイド」を参照してください。データベース定義ユティリティの使用方法の詳細については，マニュアル「HiRDB コマンドリファレンス」を参照してください。

データベース定義ユティリティを使用して権限を設定する場合の手順を次に示します。

次の環境変数を設定します。

Windowsの場合

SET  PDHOST=<HiRDBサーバのホスト名またはIPアドレス>
SET  PDNAMEPORT=<HiRDBサーバのポート番号>
SET  PDUSER=<DBA権限を持つユーザ名>/<パスワード>

UNIX（Bourneシェル）の場合

export PDHOST=<HiRDBサーバのホスト名またはIPアドレス>
export PDNAMEPORT=<HiRDBサーバのポート番号>
export PDUSER=<DBA権限を持つユーザ名>/<パスワード>

次のコマンドでデータベース定義ユティリティ（pddef）を実行します。

pddef

次のSQLを実行します。

GRANT  CONNECT  TO  <ユーザ名>※  IDENTIFIED  BY  <パスワード>;
GRANT  SCHEMA  TO  <ユーザ名>※;

注※

権限を設定するユーザは，メッセージング基盤が使用する接続ユーザの名前です。HiRDBのクライアント環境変数グループに登録したPDUSER環境変数と同じ値になります。

PDUSER環境変数については，「表3-5　環境変数グループで設定する環境変数」を参照してください。

Windowsの場合は［Ctrl］キー＋［Z］キーを押したあと，［Enter］キーを押してデータベース定義ユティリティ（pddef）を終了します。

UNIXの場合は［Ctrl］キー＋［D］キーを押したあと，［Enter］キーを押してデータベース定義ユティリティ（pddef）を終了します。

スキーマの定義

HiRDBに管理情報を格納するため，スキーマを定義します。

スキーマの定義方法

データベース定義ユティリティ（pddef），HiRDB SQL Executerを使用してスキーマを定義します。スキーマを定義する方法の詳細については，マニュアル「HiRDB SQLリファレンス」を参照してください。データベース定義ユティリティの使用方法の詳細については，マニュアル「HiRDB コマンドリファレンス」を参照してください。

データベース定義ユティリティを使用してスキーマを定義する場合の手順を次に示します。

次の環境変数を設定します。

Windowsの場合

SET  PDHOST=<HiRDBサーバのホスト名またはIPアドレス>
SET  PDNAMEPORT=<HiRDBサーバのポート番号>
SET  PDUSER=<ユーザ名>※/<パスワード>

注※

指定するユーザ名は，権限を設定したユーザのユーザ名です。

UNIX（Bourneシェル）の場合

export PDHOST=<HiRDBサーバのホスト名またはIPアドレス>
export PDNAMEPORT=<HiRDBサーバのポート番号>
export PDUSER=<ユーザ名>※/<パスワード>

注※

指定するユーザ名は，権限を設定したユーザのユーザ名です。

次のコマンドでデータベース定義ユティリティ（pddef）を実行します。

pddef

次のSQLを実行します。

CREATE  SCHEMA;

Windowsの場合は［Ctrl］キー＋［Z］キーを押したあと，［Enter］キーを押してデータベース定義ユティリティ（pddef）を終了します。

UNIXの場合は［Ctrl］キー＋［D］キーを押したあと，［Enter］キーを押してデータベース定義ユティリティ（pddef）を終了します。

RDエリアの準備

メッセージング基盤の管理情報テーブルを格納するため，必要に応じてRDエリアを作成します。RDエリアの作成方法の詳細については，マニュアル「HiRDB システム運用ガイド」を参照してください。

pd_max_users（同時実行可能ユーザ数）の設定

HiRDBのシステム共通定義のオペランドpd_max_users（同時実行可能ユーザ数）には，実行環境が使用するDBコネクション数の最大値を設定してください。実行環境が使用するDBコネクション数の最大値については，「表3-4　実行環境が使用するDBコネクションの数」を参照してください。

pd_max_usersの詳細については，マニュアル「HiRDB システム定義」を参照してください。

(b)　DBサーバ側の設定（Oracleの場合）

次の作業を実施します。

環境設定

Oracleの環境設定方法の詳細については，Oracle Corporationが発行するドキュメントを参照してください。

接続ユーザの作成と権限の設定

Oracleに管理情報を格納するため，Oracleに接続ユーザを作成し，権限を設定する必要があります。

設定する権限

システム権限として，次の権限を設定します。

CREATE ANY INDEXシステム権限

CREATE SESSIONシステム権限

CREATE TABLEシステム権限

CREATE VIEWシステム権限

FORCE ANY TRANSACTIONシステム権限

オブジェクト権限として，次の権限を設定します。

SYS.DBA_PENDING_TRANSACTIONSのSELECT権限

SYS.DBMS_SYSTEMのEXECUTE権限

また，次のロールを設定します。

SELECT_CATALOG_ROLE

接続ユーザと権限の設定方法

Oracle Enterprise Managerコンソール，またはsqlplusを使用してユーザを作成し，権限を設定します。Oracle Enterprise Managerコンソールとsqlplusを使用した場合の設定例を次に示します。

Oracle Enterprise Managerコンソールを使用する場合の設定例

sysユーザでデータベースに接続します。

ナビゲータ・ツリーの［セキュリティ］−［ユーザ］を右クリックして，［作成］を選択します。

［一般］タブを開き，名前とパスワードを入力します。

［ロール］タブを開き，CONNECTロールを削除して，SELECT_CATALOG_ROLEを追加します。

［システム］タブを開き，システム権限を設定します。

［オブジェクト］タブを開き，［SYS］−［ビュー］−［DBA_PENDING_TRANSACTIONS］を選択して，SELECT権限を設定します。

［SYS］−［パッケージ］−［DBMS_SYSTEM］を選択して，EXECUTE権限を設定します。

［割当て制限］タブを開き，表領域の割り当て制限サイズを設定します。

［作成］ボタンをクリックします。

sqlplusを使用する場合の設定例

sysユーザでデータベースに接続します。

次のSQL文を発行します（QUOTA句の指定値は例です）。

CREATE USER <権限を付与するユーザ名> PROFILE "DEFAULT"
    IDENTIFIED BY <パスワード> DEFAULT TABLESPACE "USERS"
    TEMPORARY TABLESPACE "TEMP"
    QUOTA 10 M ON "USERS"
    ACCOUNT UNLOCK;
GRANT CREATE ANY INDEX TO <権限を付与するユーザ名>;
GRANT CREATE SESSION TO <権限を付与するユーザ名>;
GRANT CREATE TABLE TO <権限を付与するユーザ名>;
GRANT CREATE VIEW TO <権限を付与するユーザ名>;
GRANT FORCE ANY TRANSACTION TO <権限を付与するユーザ名>;
GRANT SELECT ON  "SYS"."DBA_PENDING_TRANSACTIONS"
TO <権限を付与するユーザ名>;
GRANT EXECUTE ON  "SYS"."DBMS_SYSTEM" TO <権限を付与するユーザ名>;
GRANT SELECT_CATALOG_ROLE TO <権限を付与するユーザ名>;

(2)　Management Serverのセットアップ

Management Serverをセットアップし，環境設定をします。詳細については，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「4.1.17　Management Serverを使用するために設定する情報」のManagement Serverの動作環境に関する説明を参照してください。また，HCSC-Managerを使用するための設定については，このマニュアルの「2.1.6　HCSC-Managerを使用するためのManagement Serverの設定」を参照してください。

なお，Management Serverと運用管理エージェントは，HCSCサーバを運用するための基盤となります。そのため，OSの起動と同時にManagement Serverと運用管理エージェントを自動起動するように設定してください。

設定方法については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「mngautorun（自動起動および自動再起動の設定／設定解除）」を参照してください。

作業フォルダまたは共通フォルダを利用する場合，Management Serverのメモリ使用量が増大する可能性があります。次の計算式をもとにメモリ使用量を拡張してください。

Javaヒープサイズ

↑Max( (200MB+A),256MB)↑

Ａ：cscfscls，cscfswlsコマンドで表示する最大ファイル数×5000バイト

メタスペースサイズ

128MB以上

(3)　PRFのセットアップ

PRFのセットアップは，Smart Composer機能，または運用管理ポータルを使用して実施してください。

Smart Composer機能を使用したPRFのセットアップについては，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「4.8　その他の機能を使用したシステムの構築」を参照してください。

また，運用管理ポータルを使用したPRFのセットアップについては，マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「3.　J2EEアプリケーションを実行するシステムの構築と削除」を参照してください。

(4)　J2EEサーバのセットアップ

次の作業を実施します。

(a)　J2EEサーバの構築

J2EEサーバは，Smart Composer機能または運用管理ポータルを使用して構築してください。また，J2EEサーバの互換モードが推奨モードかV9互換モードかによって，構築に必要な作業が異なります。構築に必要な作業を次に示します。

Smart Composer機能を使用して構築する場合

推奨モードの場合，簡易構築定義ファイルに次に示すパラメタを追加してください。

論理J2EEサーバのconfiguration要素に追加するパラメタ

<param>
    <param-name>manager.j2ee.compat</param-name>
    <param-value>none</param-value>
</param>

論理Webサーバのconfiguration要素に追加するパラメタ

<param>
    <param-name>manager.web.send_request_method</param-name>
    <param-value>reverseproxy</param-value>
</param>

V9互換モードの場合，簡易構築定義ファイルに次に示すパラメタを追加してください。

論理J2EEサーバのconfiguration要素に追加するパラメタ

<param>
    <param-name>manager.j2ee.compat</param-name>
    <param-value>V9</param-value>
</param>

論理Webサーバのconfiguration要素に追加するパラメタ

<param>
    <param-name>manager.web.send_request_method</param-name>
    <param-value>redirector</param-value>
</param>

サーバ管理コマンド（cjsetup）で構築する場合

推奨モードの場合，cjsetupコマンドに「-compat」オプションを付けないで実行してください。

V9互換モードの場合，cjsetupコマンドに次のように「-compat V9」オプションを付けて実行してください。

cjsetup <J2EEサーバ名> -compat V9

V9互換モードの指定方法については，マニュアル「アプリケーションサーバ 機能解説 互換編」の「3.　V9互換モードの使用方法」を参照してください。

Smart Composer機能を使用したJ2EEサーバの構築については，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「4.8　その他の機能を使用したシステムの構築」を参照してください。

また，運用管理ポータルを使用したJ2EEサーバの構築については，マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「3.　J2EEアプリケーションを実行するシステムの構築と削除」を参照してください。

注意事項

構築時には，論理サーバ名と実サーバ名を同一にしてください。異なる場合，HCSCサーバのセットアップに失敗するおそれがあります。

J2EEサーバ名は110バイト以内を推奨します。ローカルマシンにIPv6アドレスを使用している環境では，111バイト以上のJ2EEサーバ名を指定すると，プロセスインスタンスの生成でエラーが発生するおそれがあります。その場合は，HCSCサーバランタイム定義のshort-processidプロパティにONを指定してください。

(b)　J2EEサーバのシステム環境変数の設定

J2EEサーバのシステム環境変数の設定方法については，OSのドキュメントを参照してください。システムの環境変数の設定時の確認事項については，マニュアル「アプリケーションサーバシステム構築・運用ガイド」の「4.1.15　論理サーバの環境変数を設定するときの確認事項」を参照してください。

(c)　SOAP通信基盤およびJAX-WSエンジンの初期設定

選択したSOAPモードに応じて，次の初期設定が必要になります。

SOAP1.1モードを利用する場合：SOAP通信基盤

J2EEサーバの互換モードで推奨モードを選択した場合は，SOAP1.1モードは使用できません。

SOAP1.1/1.2併用モードを利用する場合：JAX-WSエンジン

それぞれの初期設定手順について説明します。

●SOAP1.1モードを利用する場合の初期設定

SOAP1.1モードを利用する場合，次の手順でSOAP通信基盤の初期設定をします。

Common Public License Version 1.0に基づいて配布されているWSDL4Jを利用するため，「wsdl4j.jar」ファイルを入手し，次のディレクトリにコピーします。

<サービスプラットフォームのインストールディレクトリ>¥c4web¥lib以下

サーバ定義ファイル（c4websv.cfg）を設定します。

HCSCサーバが動作するJ2EEサーバでのSOAP通信基盤のサーバ定義ファイルに指定する内容を次の表に示します。サーバ定義ファイルの作成については，マニュアル「アプリケーションサーバ SOAPアプリケーション開発の手引」の「10.2　サーバ定義ファイルの設定」を参照してください。

表3‒1　サーバ定義ファイルの設定項目（SOAP通信基盤）

設定項目

キー名称

設定値（デフォルト）

説明

多重参照

c4web.common.<識別子>.do_multirefs

false

ユーザ定義受付を使用する場合，このプロパティは指定できません。trueを指定した場合の動作は保証しません。

データ型定義

c4web.common.<識別子>.send_xsi_types

true

ユーザ定義受付を使用する場合，このプロパティは指定できません。falseを指定した場合の動作は保証しません。

文字参照形式オプション

c4web.common.<識別子>.character_reference

false

ユーザ定義受付を使用する場合，このプロパティは指定できません。trueを指定した場合の動作は保証しません。

SOAPヘッダの名前修飾チェックオプション

c4web.common.<識別子>.enable_soapheader_check

true

ユーザ定義受付を使用する場合，ユーザ定義受付でのSOAPヘッダの名前修飾チェックオプションは強制的にfalseとして動作します。

HTTPセッションの維持

c4web.application.<識別子>.app_maintainsession

false

ユーザ定義受付を使用する場合，このプロパティは指定できません。trueを指定した場合の動作は保証しません。

ポイント

HCSCサーバでの識別子とは，サーバ定義ファイル中から動作中のサーバの情報を取得するためのキーのことです。サーバに配備したSOAPアプリケーションのコンテキストルートから先頭の「/」を除いた名称を使用しています。このため，HCSC-Messagingでは次のようになります。

標準受付の識別子：クラスタ名

（例）クラスタ名が「cluster1」の場合

　　　標準受付の識別子：「cluster1」

ユーザ定義受付の識別子：ユーザ定義受付の受付ID

共通定義ファイル（c4webcom.cfg）を設定します。

HCSCサーバが動作するJ2EEサーバでのSOAP通信基盤の共通定義ファイルに指定する内容を次の表に示します。共通定義ファイルの作成については，マニュアル「アプリケーションサーバ SOAPアプリケーション開発の手引」の「10.4　共通定義ファイルの設定」を参照してください。

表3‒2　共通定義ファイルの設定項目（SOAP通信基盤）

設定項目

キー名称

設定値（デフォルト）

説明

トレースファイル出力の重要度

c4web.logger.log_level

WARN

このプロパティにDEBUGを指定しないでください。DEBUGを指定した場合は，ほかの値を指定したときに比べてより多くのメモリが消費され，スループットに影響が出ます。

●SOAP1.1/1.2併用モードを利用する場合の初期設定

SOAP1.1/1.2併用モードを利用する場合，次の手順でJAX-WSエンジンの初期設定をします。

共通定義ファイル（cjwconf.properties）を設定します。

HCSCサーバが動作するJ2EEサーバでのJAX-WSエンジンの共通定義ファイルに指定する内容を次の表に示します。共通定義ファイルの作成については，マニュアル「アプリケーションサーバ Webサービス開発ガイド」の「10.1.2　共通定義ファイルの設定項目」を参照してください。

表3‒3　共通定義ファイルの設定項目（JAX-WSエンジン）

設定項目

キー名称

設定値（デフォルト）

説明

HTTPセッションの維持の有無

javax.xml.ws.session.maintain

false

trueを指定した場合の動作は保証しません。

サーバ単位にプロキシの設定をします。

プロキシの設定方法については，マニュアル「アプリケーションサーバ Webサービス開発ガイド」の「10.10　プロキシサーバ経由の接続」を参照してください。

(d)　HCSCサーバをセットアップするための固有設定

プロパティファイルで次のように指定します。

J2EEサーバ用ユーザプロパティファイル（usrconf.properties）

プロパティ

指定内容

ejbserver.rmi.localinvocation.scope

「app」を指定します。

ejbserver.jndi.global.enabled

「false」を指定します。

「true」の場合，Component Containerのメッセージログに「KDJE47722-W」が出力されますが，Service Coordinatorは，Portable Global JNDI名を使用していない（使用できない）ため，アプリケーションの開始は続行されますので，問題ありません。

ejbserver.distributedtx.XATransaction.enabled

「true」または「false」を指定します。

HCSCサーバが複数のリソース（DBサーバなど）へアクセスするどうかを検討して，ライトトランザクション機能を無効にする場合は「true」，有効にする場合は「false」を指定します。

oracle.jdbc.autoCommitSpecCompliant

Oracle 12c以降のバージョンに接続する場合，「false」を指定します。

なお，ejbserver.DynamicStubLoading.Enabledには「true」を指定しないでください。

サーバ管理コマンド用システムプロパティファイル（usrconf.properties）

プロパティ

指定内容

ejbserver.cui.optionalname.enabled

「true」を指定します。

「false」の場合，クライアントからのリクエスト送信時にエラーが発生します。

(e)　コンテナ拡張ライブラリの設定

コンテナ拡張ライブラリとして，次の設定をします。コンテナ拡張ライブラリの設定方法については，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「19.　コンテナ拡張ライブラリ」を参照してください。

SOAP1.1モードを利用する場合

<Reliable Messagingのインストールディレクトリ>¥lib¥reliablemessaging-api.jar
<サービスプラットフォームのインストールディレクトリ>¥c4web¥lib¥hitsaaj.jar

cjjaxws.jarを無効にするため，cjjaxws.jarの行をコメントアウトするか削除してください。

SOAP1.1/1.2併用モードを利用する場合

<Reliable Messagingのインストールディレクトリ>¥lib¥reliablemessaging-api.jar
<サービスプラットフォームのインストールディレクトリ>¥jaxws¥lib¥cjjaxws.jar

hitsaaj.jarを無効にするため，hitsaaj.jarの行をコメントアウトするか削除してください。

このとき，「add.class.path=<jarのパス>」の形式で指定してください。

この定義は，運用管理ポータルからも設定できます。運用管理ポータルの「論理サーバの環境設定」にある論理J2EEサーバの［J2EEコンテナの設定］画面の拡張パラメタにクラスパスを指定します。ここでの設定値は，J2EEサーバ用オプション定義ファイル（usrconf.cfg）に反映されます。

J2EEサーバ用オプション定義ファイルについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.2　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。また，「論理サーバの環境設定」での設定については，マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「10.　論理サーバの環境設定」を参照してください。

(5)　Webサーバ（HTTPサーバ）のセットアップ

Webサーバ（HTTPサーバ）をセットアップするには次の2とおりの方法があります。

J2EEサーバに含まれるサーバを使用する方法

推奨モードの場合は，NIO HTTPサーバを使用します。

V9互換モードの場合は，インプロセスHTTPサーバを使用します。

HTTP Serverを使用する方法

これらの方法について次に説明します。

(a)　NIO HTTPサーバまたはインプロセスHTTPサーバを使用する方法

次の作業を実施します。

NIO HTTPサーバのセットアップ（推奨モードの場合）

NIO HTTPサーバを使用する場合のシステム構築の詳細については，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(Webコンテナ)」の「7.　NIO HTTPサーバ」を参照してください。

インプロセスHTTPサーバのセットアップ（V9互換モードの場合）

インプロセスHTTPサーバを使用する場合のシステム構築の詳細については，マニュアル「アプリケーションサーバ 機能解説 互換編」の「6.　インプロセスHTTPサーバ」を参照してください。

NIO HTTPサーバまたはインプロセスHTTPサーバのコネクションタイムアウト値の設定

サービスリクエスタ側にあるSOAP通信基盤でコネクションプーリング機能を使用している場合，サービスリクエスタ側のコネクション保持の時間と，HCSCサーバ稼働マシンでのコネクションタイムアウト値の整合性をとる必要があります。

コネクションタイムアウト値の設定手順を次に示します。

運用管理ポータルから，［論理サーバの環境設定］を選択します。

サーバビューから，［論理J2EEサーバ］−［J2EEサーバ］−［＜J2EEサーバ名＞］を選択します。

［HTTPサーバ］タブの［通信・スレッド制御］タブを選択します。

［通信・スレッド制御設定］画面が表示されます。

［Webクライアントとの接続設定］−［Persistentコネクション］−［タイムアウト］に，SOAP通信基盤（Web Services）の共通定義ファイルのc4web.common.connection_pool.timeoutプロパティの設定値以上の値を設定します。

c4web.common.connection_pool.timeoutプロパティを設定していない場合はデフォルト値の1800（単位：秒）で動作するため，その倍の値である3600をタイムアウト値に設定します。

なお，タイムアウト値に設定できる範囲は0〜3600です。そのため，c4web.common.connection_pool.timeoutプロパティの設定が1800よりも大きい場合は，0を設定してください。

(b)　HTTP Serverを使用する方法

次の作業を実施します。

HTTP Serverのセットアップ

セットアップ方法の詳細については，マニュアル「HTTP Server」を参照してください。

HTTP ServerとJ2EEサーバを連携する設定

J2EEサーバと連携するためには，簡易構築定義ファイルでWebサーバ連携のためのパラメタの設定が必要です。パラメタの詳細については，マニュアル「アプリケーションサーバリファレンス 定義編(サーバ定義)」の「4.10　論理Webサーバで指定できるパラメタ」を参照してください。

HTTP ServerのKeepAliveTimeout値の設定

サービスリクエスタ側にあるSOAP通信基盤でコネクションプーリング機能を使用している場合，サービスリクエスタ側のコネクション保持の時間と，HCSCサーバ稼働マシンのKeepAliveTimeout値の整合性をとる必要があります。

HTTP Serverの環境設定ファイルであるhttpsd.confのKeepAliveTimeoutに，SOAP通信基盤（Web Services）の共通定義ファイルのc4web.common.connection_pool.timeoutプロパティに指定した値の倍以上の値を設定します。例えば，c4web.common.connection_pool.timeoutプロパティを設定していない場合はデフォルト値の1800で動作するため，その倍の値である3600をKeepAliveTimeoutに設定します。

なお，指定できる値の範囲は0〜65535です。詳細は，マニュアル「アプリケーションサーバ SOAPアプリケーション開発の手引」の「7.4.2　コネクションプーリングに関する設定」を参照してください。

(6)　データベースのクライアント側のセットアップ

(a)　DBクライアント側の設定（HiRDBの場合）

実行環境のマシンで，次の作業を実施します。

環境変数の設定

Windowsの場合は，次の環境変数を設定します。

UNIXの場合は，HCSCサーバが稼働しているJ2EEサーバ起動時とManagement Server実行時の環境変数に，次の環境変数を設定します。

HCSCサーバが稼働しているJ2EEサーバ起動時の環境変数の設定方法は，マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「10.8.27　J2EEサーバの環境変数の設定」を参照してください。

Management Server実行時の環境変数の設定方法は，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「8.2.8　mserverenv.cfg（Management Server用環境変数定義ファイル）」を参照してください。

PDXAMODE

1を指定します。

ただし，ライトトランザクション機能を利用する場合はPDXAMODEの設定は必要ありません。

PDTXACANUM

サービスプラットフォームが使用するDBコネクション数の最大値を指定します。

ただし，ライトトランザクション機能を利用する場合はPDTXACANUMの設定は必要ありません。

DBコネクション数の最大値は，利用する実行環境に応じて見積もる必要があります。実行環境がDBコネクションを使用する契機と数を次の表に示します。

表3‒4　実行環境が使用するDBコネクションの数

DBコネクションの使用先

DBコネクションの使用の契機

DBコネクションの使用数

使用するコネクション

メッセージング基盤

起動時

1

HCSCサーバセットアップ定義ファイルのdbcon-nodisplaynameに指定したDBコネクタから取得する

コマンド実行時

1

[HCSCサーバ停止状態]

コマンド実行時にJDBCドライバを使用してコネクションを取得する

[HCSCサーバ起動状態]

HCSCサーバセットアップ定義ファイルのdbcon-nodisplaynameに指定したDBコネクタから取得する

ビジネスプロセス基盤

ビジネスプロセス実行要求受付時

ビジネスプロセスの同時実行数

HCSCサーバセットアップ定義ファイルのdbcon-xadisplaynameに指定したDBコネクタから取得する

DBアダプタ

サービス部品実行要求受付時

サービス部品の同時実行数

SQLオペレーション定義ファイルのデータベース参照名で参照されるDBコネクタから取得する

Reliable Messaging

マニュアル「Reliable Messaging」の「3.4.1　DBMSの設定（HiRDBを使用する場合）」を参照してください。

DBコネクション使用数の和が最大値となります。

PDLANGまたはLANG

HCSCサーバをUNIXで稼働させる場合，HiRDBサーバの文字コードに応じて，PDLANGかLANGのどちらかにHiRDBサーバと同じ文字コードを指定します。詳細は，マニュアル「HiRDB UAP開発ガイド」のPDLANGに関する内容を参照してください。

HCSCサーバをWindowsで稼働させる場合は，設定は不要です。

LC_CTYPE

HCSCサーバをUNIXで稼働させる場合，HiRDBサーバと同じ文字コードを指定します。

HCSCサーバをWindowsで稼働させる場合は，設定は不要です。

LD_LIBRARY_PATH

HCSCサーバをLinuxで稼働させる場合，下記のパスを追加します。

<HiRDB運用ディレクトリ>/client/lib

HiRDB/Single Server，HiRDB/Parallel ServerまたはHiRDB Serverインストール時に指定します。

<HiRDBのインストールディレクトリ>/client/lib

HiRDB/Run Time，またはHiRDB/Developer's Kitインストール時に指定します。

HCSCサーバをWindowsで稼働させる場合は，設定は不要です。

LIBPATH

HCSCサーバをAIXで稼働させる場合，下記のパスを追加します。

<HiRDBの運用ディレクトリ>/client/lib

HiRDB/Single Server，HiRDB/Parallel ServerまたはHiRDB Serverインストール時に指定します。

<HiRDBのインストールディレクトリ>/client/lib

HiRDB/Run Time，またはHiRDB/Developer's Kitインストール時に指定します。

HCSCサーバをWindowsで稼働させる場合は，設定は不要です。

環境変数グループの設定

環境変数グループを次の方法で登録します。

Windowsの場合

HiRDBのクライアント環境変数登録ツールで「システムグループ」を選択して，環境変数グループを登録します。この場合，DB Connectorのプロパティ定義では，ここで登録した環境変数グループ名を指定してください。

UNIXの場合

HiRDBのクライアント環境変数グループの設定ファイルに登録します。この場合，DB Connectorのプロパティ定義では，ここで登録した環境変数グループの設定ファイルのパスを指定してください。

環境変数グループを登録する方法の詳細については，マニュアル「HiRDB UAP開発ガイド」の環境変数のグループ登録に関する内容を参照してください。

DB Connectorのプロパティについては，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「4.2.2　DB Connectorのプロパティ定義」を参照してください。

環境変数グループで設定する環境変数を次の表に示します。

表3‒5　環境変数グループで設定する環境変数

環境変数名

設定する内容

PDHOST

データベースのホスト名またはIPアドレスを指定します。

PDUSER

データベースのユーザ名およびデータベースのパスワードを指定します。

PDNAMEPORT

データベースのポート番号を指定します。

PDSWAITTIME

Component Containerのトランザクションタイムアウトの値※よりも大きな値を指定します。

PDCWAITTIME

Component Containerのトランザクションタイムアウトの値※よりも大きな値を指定します。

PDSWATCHTIME

0を指定します。

注※

Component Containerのトランザクションタイムアウトの値は，J2EEサーバ用ユーザプロパティファイルで指定します。Component Containerのトランザクションタイムアウトの値については，マニュアル「アプリケーションサーバシステム設計ガイド」の「8.6.4　トランザクションタイムアウトを設定する」を参照してください。

(b)　DBクライアント側の設定（Oracleの場合）

Oracle JDBC Thin Driverをセットアップします。Oracle JDBC Thin Driverのセットアップについては，「3.1.2(7)(b)　Oracle JDBC Thin Driverのセットアップ」を参照してください。

(7)　JDBCドライバのセットアップ

使用するJDBCドライバは，利用条件を考慮して選択する必要があります。

使用するJDBCドライバの選択方法を次の表に示します。

表3‒6　使用するJDBCドライバ

利用するDBMS

使用するJDBCドライバ

JDBCドライバのパッケージ

HiRDB

HiRDB TYPE4 JDBC Driver

JP.co.Hitachi.soft.HiRDB.JDBC.HiRDBDriver

Oracle

Oracle JDBC Thin Driver

oracle.jdbc.OracleDriver

(a)　HiRDB Type4 JDBC Driverのセットアップ

HiRDB Type4 JDBC Driverのセットアップについては，マニュアル「HiRDB UAP開発ガイド」のHiRDB Type4 JDBC Driverに関する内容を参照してください。

なお，HCSCサーバを使用するために，次の設定をする必要があります。

<サービスプラットフォームのインストールディレクトリ>/manager/config/mserver.cfgファイルに，HiRDB Type4 JDBC DriverのJARファイル（pdjdbc2.jar）をクラスパスとして指定します。このとき，「web.add.class.path=<pdjdbc2.jarのパス>」の形式で指定してください。

例1（HiRDB/Run Timeの場合）

web.add.class.path=<HiRDB/Run Timeのインストールディレクトリ>/client/lib/pdjdbc2.jar

例2（HiRDB/Single Serverの場合）

web.add.class.path=<HiRDB/Single Serverのインストールディレクトリ>※/client/lib/pdjdbc2.jar

注※

<HiRDBのインストールディレクトリ>は，hirdb_sというディレクトリになります。

J2EEサーバ用オプション定義ファイル（usrconf.cfg）に，HiRDB Type4 JDBC DriverのJARファイル（pdjdbc2.jar）をクラスパスとして指定します。このとき，「add.class.path=<pdjdbc2.jarのパス>」の形式で指定してください。

例1（HiRDB/Run Timeの場合）

add.class.path=<HiRDB/Run Timeのインストールディレクトリ>/client/lib/pdjdbc2.jar

例2（HiRDB/Single Serverの場合）

add.class.path=<HiRDB/Single Serverのインストールディレクトリ>※/client/lib/pdjdbc2.jar

注※

<HiRDBのインストールディレクトリ>は，hirdb_sというディレクトリになります。

この定義は，運用管理ポータルからも設定できます。運用管理ポータルの「論理サーバの環境設定」にある論理J2EEサーバの［J2EEコンテナの設定］画面の拡張パラメタにクラスパスを指定します。ここでの設定値は，J2EEサーバ用オプション定義ファイル（usrconf.cfg）に反映されます。

J2EEサーバ用オプション定義ファイルについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.2　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。また，「論理サーバの環境設定」での設定については，マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「10.　論理サーバの環境設定」を参照してください。

HCSC-Messagingコマンド共通定義ファイルのHCSC_ADDCLASSPATHに，HiRDB Type4 JDBC DriverのJARファイル（pdjdbc2.jar）をクラスパスとして指定します。

HCSC-Messagingコマンド共通定義ファイルの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.5.4　HCSC-Messagingコマンド共通定義ファイル」を参照してください。

(b)　Oracle JDBC Thin Driverのセットアップ

Oracle JDBC Thin Driverのセットアップについては，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「4.1.7　データベース接続環境を設定する（Oracleの設定）」または，使用しているデータベースのマニュアルを参照してください。

なお，HCSCサーバを使用するために，次の設定をする必要があります。使用するOracleのバージョンによって，Oracle JDBC Thin Driverの種類が異なりますので，Oracle JDBC Thin DriverのJARファイルのクラスパスを指定する際は注意してください。

<サービスプラットフォームのインストールディレクトリ>/manager/config/mserver.cfgファイルに，Oracle JDBC Thin DriverのJARファイルをクラスパスとして指定します。このとき，「web.add.class.path=<Oracle JDBC Thin Driverのパス>」の形式で指定してください。

例（Oracle 21cの場合）

web.add.class.path=<ORACLE_HOME>/jdbc/lib/ojdbc11.jar

J2EEサーバ用オプション定義ファイル（usrconf.cfg）に，Oracle JDBC Thin DriverのJARファイルをクラスパスとして指定します。このとき，「add.class.path=<Oracle JDBC Thin Driverのパス>」の形式で指定してください。

例（Oracle 21cの場合）

add.class.path=<ORACLE_HOME>/jdbc/lib/ojdbc11.jar

この定義は，運用管理ポータルからも設定できます。運用管理ポータルの「論理サーバの環境設定」にある論理J2EEサーバの［J2EEコンテナの設定］画面の拡張パラメタにクラスパスを指定します。ここでの設定値は，J2EEサーバ用オプション定義ファイル（usrconf.cfg）に反映されます。

J2EEサーバ用オプション定義ファイルについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.2　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。また，「論理サーバの環境設定」での設定については，マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「10.　論理サーバの環境設定」を参照してください。

HCSC-Messagingコマンド共通定義ファイルのHCSC_ADDCLASSPATHに，Oracle JDBC Thin DriverのJARファイルをクラスパスとして指定します。

HCSC-Messagingコマンド共通定義ファイルの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.5.4　HCSC-Messagingコマンド共通定義ファイル」を参照してください。

(8)　DB Connectorのセットアップ（Reliable Messagingを使用する場合）

HCSCサーバは，データベースと接続するためにDB Connectorを利用します。処理のタイミングやテーブル種別に応じて，データベースアクセスをトランザクション管理する場合と管理しない場合があるため，トランザクションサポート種別がXATransactionまたはLocalTransactionのDB Connectorと，トランザクションサポート種別がNoTransactionであるDB Connectorの，2つのDB Connectorを準備する必要があります。

なお，トランザクションサポート種別がXATransactionまたはLocalTransactionのDB Connectorは，処理性能を向上させるため，Reliable Messagingと連携できるDB Connectorを利用します。

それぞれのDB Connectorの表示名は，HCSCサーバセットアップ定義ファイルの「dbcon-xadisplayname」と「dbcon-nodisplayname」に指定します。HCSCサーバセットアップ定義ファイルの詳細については，マニュアル「サービスプラットフォームリファレンス」の「6.4.3　HCSCサーバセットアップ定義ファイル」を参照してください。

(a)　DB Connectorのインポート

インポートするDB Connectorは，利用条件を考慮して選択する必要があります。インポートするRARファイルの選択方法を次の表に示します。

表3‒7　インポートするRARファイルの選択方法（Reliable Messagingを使用する場合）

HCSCサーバセットアップ定義ファイルのプロパティ

利用するデータベース

ライトトランザクション機能の利用の有無

利用する

利用しない

dbcon-xadisplayname

HiRDB

DBConnector_HiRDB_

Type4_CP_Cosminexus_RM.rar

DBConnector_HiRDB_Type4_

XA_Cosminexus_RM.rar

Oracle

DBConnector_Oracle_CP_

Cosminexus_RM.rar

DBConnector_Oracle_XA_

Cosminexus_RM.rar

dbcon-nodisplayname

HiRDB

DBConnector_HiRDB_Type4_CP.rar

Oracle

DBConnector_Oracle_CP.rar

DB Connectorのインポート方法については，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「4.2　データベースと接続するための設定」を参照してください。また，プロパティ定義については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1　Connector属性ファイル」を参照してください。

ライトトランザクションについては，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「3.14.5　ライトトランザクション」を参照してください。また，設定方法については，マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「10.8.6　トランザクションの設定」を参照してください。

また，DBアダプタを利用する場合は，DBアダプタが利用するDB Connectorをインポートします。インポートするRARファイルの選択方法を次の表に示します。

表3‒8　インポートするRARファイルの選択方法（DBアダプタを利用する場合）

利用するJDBCドライバ

利用するデータベース

ライトトランザクション機能の利用の有無

利用する

利用しない

HiRDB Type4 JDBC Driver

HiRDB

DBConnector_HiRDB_Type4_CP.rar

DBConnector_HiRDB_Type4_XA.rar

Oracle JDBC Thin Driver

Oracle

DBConnector_Oracle_CP.rar

DBConnector_Oracle_XA.rar

(b)　プロパティの定義

DB Connectorをインポートしたあと，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1　Connector属性ファイル」を参照して，プロパティを定義してください。ただし，次の表に示す内容をプロパティに設定する必要があります。

注意事項

Reliable Messagingと連携できるDB Connectorと，DBアダプタで利用するDB Connectorで，トランザクションサポート種別（<transaction-support>タグに指定する値）を同じにする必要があります。

また，<transaction-support>タグに指定する値は，ライトトランザクションを適用するか，グローバルトランザクションを適用するかで次のように異なります。

J2EEサーバにライトトランザクションを適用する場合

LocalTransaction

J2EEサーバにグローバルトランザクションを適用する場合

XATransaction

表3‒9　dbcon-xadisplaynameに設定するDB Connector属性ファイルの設定内容（Oracle）

設定項目

設定値

<display-name>タグ

DB Connector表示名

<config-property>タグに設定するdatabaseNameプロパティ

データベース名※1

<config-property>タグに設定するbufSizeプロパティ

システムで利用する最大の電文長よりも大きな値※2

<transaction-support>タグ

XATransaction※3

LocalTransaction※4

<connector-runtime>タグの<property>タグに設定するMaxPoolSizeプロパティ

ビジネスプロセスの最大同時実行数以上の値※5

注※1

使用するDB Connectorによって設定値が異なります。設定値については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1　Connector属性ファイル」を参照してください。また，データベースに接続するために必要な情報もあわせて設定してください。

注※2

使用するDB Connectorが次のDB Connectorで，LONGVARBINARY_AccessプロパティにREALを指定した場合に指定してください。

・DBConnector_DABJ_XA_Cosminexus_RM.rar

・DBConnector_DABJ_CP_Cosminexus_RM.rar

注※3

ライトトランザクション機能を利用しない場合に，次のDB Connectorに対して指定してください。

・DBConnector_DABJ_XA_Cosminexus_RM.rar

・DBConnector_Oracle_XA_Cosminexus_RM.rar

注※4

ライトトランザクション機能を利用する場合に，次のDB Connectorに対して指定してください。

・DBConnector_DABJ_CP_Cosminexus_RM.rar

・DBConnector_Oracle_CP_Cosminexus_RM.rar

注※5

他の機能でdbcon-xadisplaynameに設定したDB Connectorを使用する場合は，その機能の同時実行数を含めた値を指定してください。

表3‒10　dbcon-xadisplaynameに設定するDB Connector属性ファイルの設定内容（HiRDB Type4）

設定項目

設定値

<display-name>タグ

DB Connector表示名

<config-property>タグに設定するmaxBinarySizeプロパティ

システムで利用する最大の電文長よりも大きな値※1

<transaction-support>タグ

XATransaction※2

LocalTransaction※3

<connector-runtime>タグの<property>タグに設定するMaxPoolSizeプロパティ

ビジネスプロセスの最大同時実行数以上の値※4

注※1

LONGVARBINARY_AccessプロパティにREALを指定した場合に指定してください。また，必ず0以外の値を指定してください。

注※2

ライトトランザクション機能を利用しない場合に，次のDB Connectorに対して指定してください。

・DBConnector_HiRDB_Type4_XA_Cosminexus_RM.rar

注※3

ライトトランザクション機能を利用する場合に，次のDB Connectorに対して指定してください。

・DBConnector_HiRDB_Type4_CP_Cosminexus_RM.rar

注※4

他の機能でdbcon-xadisplaynameに設定したDB Connectorを使用する場合は，その機能の同時実行数を含めた値を指定してください。

注意

データベースに接続するために必要な情報を設定してください。設定値については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1　Connector属性ファイル」を参照してください。

表3‒11　dbcon-nodisplaynameに設定するDB Connector属性ファイルの設定内容（Oracle）

設定項目

設定値

<display-name>タグ

DB Connector表示名

<config-property>タグに設定するdatabaseNameプロパティ

データベース名※1

<config-property>タグに設定するbufSizeプロパティ

システムで利用する最大の電文長よりも大きな値※2

<transaction-support>タグ

NoTransaction※3

<connector-runtime>タグの<property>タグに設定するMaxPoolSizeプロパティ

1以上の値※4

注※1

使用するデータベースによって設定値が異なります。設定値については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1　Connector属性ファイル」を参照してください。また，データベースに接続するために必要な情報もあわせて設定してください。

注※2

使用するDB Connectorが次のDB Connectorで，LONGVARBINARY_AccessプロパティにREALを指定した場合に指定してください。

・DBConnector_DABJ_CP.rar

注※3

使用するDB Connectorが次のDB Connectorに対して指定してください。

・DBConnector_DABJ_CP.rar

・DBConnector_Oracle_CP.rar

注※4

他の機能でdbcon-nodisplaynameに設定したDB Connectorを使用する場合は，その機能の同時実行数を含めた値を指定してください。

表3‒12　dbcon-nodisplaynameに設定するDB Connector属性ファイルの設定内容（HiRDB Type4）

設定項目

設定値

<display-name>タグ

DB Connector表示名

<config-property>タグに設定するmaxBinarySizeプロパティ

システムで利用する最大の電文長よりも大きな値※1

<transaction-support>タグ

NoTransaction※2

<connector-runtime>タグの<property>タグに設定するMaxPoolSizeプロパティ

1以上の値※3

注※1

LONGVARBINARY_AccessプロパティにREALを指定した場合に指定してください。また，必ず0以外の値を指定してください。

注※2

使用するDB Connectorが次のDB Connectorに対して指定してください。

・DBConnector_HiRDB_Type4_CP.rar

注※3

他の機能でdbcon-nodisplaynameに設定したDB Connectorを使用する場合は，その機能の同時実行数を含めた値を指定してください。

注意

データベースに接続するために必要な情報を設定してください。設定値については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1　Connector属性ファイル」を参照してください。

表3‒13　DBアダプタを利用する場合に設定するConnector属性ファイルの設定内容

設定項目

設定値

<display-name>タグ

DB Connector表示名※1

<config-property>タグに設定するdatabaseNameプロパティ

データベース名※2

<transaction-support>タグ

XATransaction

LocalTransaction

<connector-runtime>タグの<property>タグに設定するMaxPoolSizeプロパティ

DBアダプタの最大同時実行数以上の値※3

注※1

この値は，DBアダプタのアプリケーション統合属性ファイルの<linked-to>タグにも設定します。アプリケーション統合属性ファイルについては，マニュアル「サービスプラットフォーム開発ガイド 受付・アダプタ定義編」の「3.3.5　DBアダプタを定義する」を参照してください。

注※2

使用するDB Connectorによって設定値が異なります。設定値については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1　Connector属性ファイル」を参照してください。

注※3

他の機能でDBアダプタに指定したDBコネクタを使用する場合，その機能の同時実行数を含めた値を指定してください。

(9)　Reliable Messagingのセットアップ

Reliable Messagingをセットアップします。作業の詳細については，マニュアル「Reliable Messaging」の「3.　システム構築」を参照してください。セットアップ作業のうちプロパティのカスタマイズについては，次に示す方法で実施します。

(a)　Reliable Messagingのコンフィグレーションプロパティの設定

設定するコンフィグレーションプロパティと指定する値を次の表に示します。なお，認証情報（UserおよびPassword）には，Reliable MessagingがHiRDBまたはOracleにアクセスするために利用する接続ユーザのユーザ名およびパスワードを指定してください。

表3‒14　設定するコンフィグレーションプロパティと指定する値

プロパティ名

設定内容

設定値

RMSystemName

システム名

連携するシステム全体で一意なシステム名を指定します。

RMLinkedDBConnectorName

連携するDB Connectorの表示名

連携するDB Connectorの表示名を指定します。

RMSHConnectFlag

共用キューを使用して複数システム間でのアプリケーション連携をする場合の受信用共用キューの有無

標準の非同期受付（MDB（DBキュー））を使用する場合，「true」を指定します。

標準の非同期受付（MDB（DBキュー））を使用しない場合，またはDBキューを使用できないデータベース（Oracle）を使用している場合「false」を指定します。

RMTRConnectFlag

キュー間転送の使用有無

「true」を指定します。

RMMaxDeliveryNum

配送回数の最大値

0以外（1〜512）を設定します（推奨値：10）。

RMDeadMessageQueueName

デッドメッセージキュー名

1〜20文字の識別子を設定します。

なお，必ずデッドメッセージキューを使用してください。

また，デッドメッセージキューはローカルキューとしてください。

(b)　注意事項

コンフィグレーションプロパティ「RMWaitRestoration」の値は変更しないでください。Reliable Messagingのデフォルト値「true」で動作します。

デッドメッセージキュー名「RMDeadMessageQueueName」に指定するデッドメッセージキューは，非同期の標準受付（MDB（WS-R），MDB（DBキュー））や非同期のサービスアダプタ（MDB（WS-R）アダプタ，MDB（DBキュー）アダプタ）を使用している場合に，配送回数が最大値に達してサービス部品が呼び出されなかったメッセージが移動される特別なキューです。

デッドメッセージキュー名を設定していない場合，およびデッドメッセージキューを作成していない場合，無限にサービス部品を呼び出す処理が再実行されるため，注意してください。

なお，デッドメッセージキューとして使用するキューは，Reliable Messagingの設定後，最初に開始したあとに作成してください。

データベースにOracleを使用する場合，非同期の標準受付（MDB（DBキュー）），および非同期のMDB（DBキュー）アダプタは使用できません。

(10)　TP1インバウンドアダプタのセットアップ

TP1/RPC受付を使用する場合は，TP1インバウンドアダプタをセットアップします。J2EEサーバがセットアップされていれば，任意のタイミングでセットアップできます。

TP1インバウンドアダプタのセットアップについては，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「4.12.2　リソースアダプタの設定」に関する説明を参照してください。なお，TP1インバウンドアダプタをセットアップするには，Connector属性定義ファイルを必ず設定してください。

(11)　Kafkaインバウンドアダプタのセットアップ

Kafka受付を使用する場合は，Kafkaインバウンドアダプタをセットアップします。Kafkaインバウンドアダプタをセットアップするには，HCSCサーバが起動している必要があります。HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

Kafkaインバウンドアダプタのセットアップの流れを次に示します。

図3‒5　Kafkaインバウンドアダプタのセットアップの流れ

(a)　Kafkaインバウンドアダプタのインポート

Kafkaインバウンドアダプタをインポートする場合の実行形式を次に示します。

<サービスプラットフォームのインストールディレクトリ>¥CC¥admin¥bin¥cjimportres <J2EEサーバ名> -type rar -f "<サービスプラットフォームのインストールディレクトリ>¥CSC¥inbound-adapter¥kafka¥rar¥kafka_inbound_adapter.rar"

cjimportresコマンドの詳細は，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「2.4　J2EEサーバで使用するリソース操作コマンド」を参照してください。

(b)　Kafkaインバウンドアダプタのデプロイ

Kafkaインバウンドアダプタをデプロイする場合の実行形式を次に示します。

<サービスプラットフォームのインストールディレクトリ>¥CC¥admin¥bin¥cjdeployrar <J2EEサーバ名> -resname Kafka_Inbound_Resource_Adapter

cjdeployrarコマンドの詳細は，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「2.4　J2EEサーバで使用するリソース操作コマンド」を参照してください。

(c)　Kafkaインバウンドアダプタの設定

Kafkaインバウンドアダプタを設定する手順，およびプロパティファイルの内容を次に示します。

参考

初期状態の設定のままでKafkaインバウンドアダプタを運用する場合，ここでの設定は省略できます。

設定手順

KafkaインバウンドアダプタのRARファイルから属性を取得して，属性ファイルを作成します。

KafkaインバウンドアダプタのRARファイルから属性ファイルを作成する場合の実行形式を次に示します。

<サービスプラットフォームのインストールディレクトリ>¥CC¥admin¥bin¥cjgetrarprop <J2EEサーバ名> -resname Kafka_Inbound_Resource_Adapter -c <属性ファイルのファイルパス>

cjgetrarpropコマンドの詳細は，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「2.4　J2EEサーバで使用するリソース操作コマンド」を参照してください。

属性ファイルを編集します。

属性ファイルの詳細は，「プロパティの内容」を参照してください。

定義項目を編集した属性ファイルに指定された値をKafkaインバウンドアダプタのRARファイルへ反映します。

属性ファイルをKafkaインバウンドアダプタへ反映する場合の実行形式を次に示します。

<サービスプラットフォームのインストールディレクトリ>¥CC¥admin¥bin¥cjsetrarprop <J2EEサーバ名> -resname Kafka_Inbound_Resource_Adapter -c <属性ファイルのファイルパス>

cjsetrarpropコマンドの詳細は，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「2.4　J2EEサーバで使用するリソース操作コマンド」を参照してください。

プロパティの内容

属性ファイルの定義

属性ファイルにある定義のタグを次に示します。

<hitachi-connector-property>
    <display-name>Kafka_Inbound_Resource_Adapter</display-name>
                    ：
    <resourceadapter>
        <config-property>
            <config-property-name>   ：定義の名称
            <config-property-type>   ：定義の型
            <config-property-value>  ：定義の値
        </config-property>
                    ：（以降，定義の数分，繰り返される）

    <resourceadapter-runtime>
        <property>
            <property-name>   ：定義の名称
            <property-type>   ：定義の型
            <property-value>  ：定義の値
        </property>
                    :（以降，定義の数分，繰り返される）

定義を編集する場合は，編集する「定義の名称」を検索して，対応する「定義の値」を書き替えます。編集できる項目については，「属性ファイルの定義項目」を参照してください。

属性ファイルを編集する際の注意事項を次に示します。

「定義項目」に示している定義項目の値だけを書き替えてください。ほかの項目や値を変更しないでください。

属性ファイルの内容はアプリケーション属性ファイル（cosminexus.xml）には記載しないでください。

属性ファイル内にある<display-name>タグのリソースアダプタの名称を変更しないでください。

ログ出力に関する設定で，各ログのログファイル1面当たりのファイルサイズ，およびログファイルのバックアップファイルの面数を変更した場合は，Kafkaインバウンドアダプタを起動する前に，ログファイルをバックアップしておいてください。

属性ファイルの定義個所

属性ファイルの定義個所を次の図に示します。

図3‒6　属性ファイルの内容および定義の設定個所

属性ファイルの定義項目

属性ファイルの定義項目のうち編集できる項目を次に示します。

ログ出力に関する設定

<resourceadapter>タグの<config-property>タグに設定します。

設定内容を次の表に示します。

表3‒15　属性ファイルの定義項目一覧（ログ出力に関する設定）

定義項目

定義の名称

定義の値（指定できる内容）

デフォルト値

メッセージログ

ログ出力レベル

server_message_logLevel

次のどちらかを指定してください。

info

通常の運用時に使用し，運用時に必要な情報を出力します。

debug

テストや障害が発生した場合の調査時に使用し，infoの情報に加えて，デバッグ用の情報を出力します。

info

ログファイル1面当たりのファイルサイズ

server_message_maxFileSize

1MB〜2048MB

（単位の文字列「MB」も指定）

10MB

ログファイルのバックアップファイルの面数

server_message_maxBackupIndex

1〜16

4

保守用ログ

ログ出力レベル

server_maintenance_logLevel

次のどれかを指定してください。

error

エラー発生時に出力します。

info

メッセージログの「ログ出力レベル」と同じです。

debug

メッセージログの「ログ出力レベル」と同じです。

error

ログファイル1面当たりのファイルサイズ

server_maintenance_maxFileSize

1MB〜2048MB

（単位の文字列「MB」も指定）

5MB

ログファイルのバックアップファイルの面数

server_maintenance_maxBackupIndex

1〜16

4

データトレース

出力有無

server_datatrace_enabled

次のどちらかを指定してください。

true

トレースを出力します。

false

トレースを出力しません。

false

出力契機

server_datatrace_trigger

次の値のどちらかを指定することも，両方指定することもできます。

normal

正常終了時に出力します。

error

例外時に出力します。

error

ログファイル1面当たりのファイルサイズ

server_datatrace_maxFileSize

1MB〜2048MB

（単位の文字列「MB」も指定）

10MB

ログファイルのバックアップファイルの面数

server_datatrace_maxBackupIndex

1〜16

4

スレッドプールに関する設定

<resourceadapter-runtime>タグの<property>タグに設定します。

設定内容を次の表に示します。

表3‒16　属性ファイルの定義項目一覧（スレッドプールに関する設定）

定義項目

定義の名称

値の範囲

デフォルト値

スレッドプールで同時に実行される最大スレッド数

MaxTPoolSize

1〜2147483647

設定値は次に示す値以上にしてください。

HCSCサーバ内のKafka受付のインスタンスプールの最大数の合計

10※

スレッドプールに存在する最小スレッド数

MinTPoolSize

0〜1024

10※

スレッドプールのスレッド解放までのタイムアウト値

TPoolKeepalive

1〜2147483647

（単位：秒）

300※

注※

デフォルト値は，アプリケーションサーバのデフォルト値です。

(12)　gRPCインバウンドアダプタのセットアップ

gRPC受付を使用する場合は，gRPCインバウンドアダプタをセットアップします。gRPCインバウンドアダプタをセットアップするには，HCSCサーバが起動している必要があります。HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

gRPCインバウンドアダプタのセットアップの流れを次に示します。

図3‒7　gRPCインバウンドアダプタのセットアップの流れ

(a)　gRPCインバウンドアダプタのインポート

gRPCインバウンドアダプタをインポートする場合の実行形式を次に示します。

<サービスプラットフォームのインストールディレクトリ>¥CC¥admin¥bin¥cjimportres <J2EEサーバ名> -type rar -f "<サービスプラットフォームのインストールディレクトリ>¥CSC¥inbound-adapter¥grpc¥rar¥grpc_inbound_adapter.rar"

cjimportresコマンドの詳細は，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「2.4　J2EEサーバで使用するリソース操作コマンド」を参照してください。

(b)　gRPCインバウンドアダプタのデプロイ

gRPCインバウンドアダプタをデプロイする場合の実行形式を次に示します。

<サービスプラットフォームのインストールディレクトリ>¥CC¥admin¥bin¥cjdeployrar <J2EEサーバ名> -resname gRPC_Inbound_Resource_Adapter

cjdeployrarコマンドの詳細は，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「2.4　J2EEサーバで使用するリソース操作コマンド」を参照してください。

(c)　gRPCインバウンドアダプタの設定

gRPCインバウンドアダプタでは，HTTP/2を使用してgRPC電文の送受信を実行します。HTTP/2の設定可能なパラメタは，gRPCインバウンドアダプタのRAR属性ファイルから設定できます。

gRPCインバウンドアダプタを設定する手順，およびプロパティファイルの内容を次に示します。

参考

初期状態の設定のままでgRPCインバウンドアダプタを運用する場合，ここでの設定は省略できます。

設定手順

gRPCインバウンドアダプタのRARファイルから属性を取得して，属性ファイルを作成します。

gRPCインバウンドアダプタのRARファイルから属性ファイルを作成する場合の実行形式を次に示します。

<サービスプラットフォームのインストールディレクトリ>¥CC¥admin¥bin¥cjgetrarprop <J2EEサーバ名> -resname gRPC_Inbound_Resource_Adapter -c <属性ファイルのファイルパス>

cjgetrarpropコマンドの詳細は，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「2.4　J2EEサーバで使用するリソース操作コマンド」を参照してください。

属性ファイルを編集します。

属性ファイルの詳細は，「プロパティの内容」を参照してください。

定義項目を編集した属性ファイルに指定された値をgRPCインバウンドアダプタのRARファイルへ反映します。

属性ファイルをgRPCインバウンドアダプタへ反映する場合の実行形式を次に示します。

<サービスプラットフォームのインストールディレクトリ>¥CC¥admin¥bin¥cjsetrarprop <J2EEサーバ名> -resname gRPC_Inbound_Resource_Adapter -c <属性ファイルのファイルパス>

cjsetrarpropコマンドの詳細は，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「2.4　J2EEサーバで使用するリソース操作コマンド」を参照してください。

プロパティの内容

属性ファイルの定義

属性ファイルにある定義のタグを次に示します。

<hitachi-connector-property>
    <display-name>gRPC_Inbound_Resource_Adapter</display-name>
                    ：
    <resourceadapter>
    <resourceadapter-class>com.cosminexus.csc.grpc.resourceadapter.GRPCInboundResourceAdapter</resourceadapter-class>
        <config-property>
            <config-property-name>   ：定義の名称
            <config-property-type>   ：定義の型
            <config-property-value>  ：定義の値
        </config-property>
                    ：（以降，定義の数分，繰り返される）

    <inbound-resourceadapter>
                    ：
    </inbound-resourceadapter>
  </resourceadapter>

</hitachi-connector-property>

定義を編集する場合は，編集する「定義の名称」を検索して，対応する「定義の値」を書き替えます。編集できる項目については，「属性ファイルの定義項目」を参照してください。

属性ファイルを編集する際の注意事項を次に示します。

「定義項目」に示している定義項目の値だけを書き替えてください。ほかの項目や値を変更しないでください。

属性ファイルの内容はアプリケーション属性ファイル（cosminexus.xml）には記載しないでください。

属性ファイル内にある<display-name>タグのリソースアダプタの名称を変更しないでください。

ログ出力に関する設定で，各ログのログファイル1面当たりのファイルサイズ，およびログファイルのバックアップファイルの面数を変更した場合は，gRPCインバウンドアダプタを起動する前に，ログファイルをバックアップしておいてください。

属性ファイルの定義個所

属性ファイルの定義個所を次の図に示します。

図3‒8　属性ファイルの内容および定義の設定個所

属性ファイルの定義項目

属性ファイルの定義項目のうち編集できる項目を次に示します。これらは<resourceadapter>タグの<config-property>タグに設定します。

列「定義の値（指定できる内容）」に該当しない値を設定した場合，gRPCインバウンドアダプタの起動でエラーとなります。

表3‒17　属性ファイルの定義項目一覧

定義項目

定義の名称

定義の値（指定できる内容）

デフォルト値

gRPCサーバ

gRPCサーバ機能で使用するネットワークインターフェースのアドレス

bindAddress

任意のIPアドレス※1

*

gRPCサーバ機能で使用するネットワークのポート番号

port

1〜65535

28500

gRPCサーバのシャットダウン要求からgRPCサーバのシャットダウン終了までの待機時間

serverShutdownTimeout

0〜8640000000

（単位：ミリ秒）

0を指定した場合，サービスの終了を待たないでシャットダウンされます。

60000

認証機能

証明書チェーンファイルの絶対パス

certChainFile

任意のパス

（なし）

秘密鍵ファイル（PKCS #8フォーマット）の絶対パス

privateKeyFile

任意のパス

（なし）

認証局証明書ファイルの絶対パス（独自の認証局を使用しクライアント認証を実施する場合に設定）

caCertFile

任意のパス

（なし）

クライアント認証の方法

clientAuth

次のどれかを指定してください。大文字・小文字は区別されません。

none

クライアント認証を実施しません。

optional

クライアント側から証明書が提示された場合に認証を実施します。

require

必ずクライアント認証を実施します。

none

フロー制御

フローコントロールウィンドウのサイズ

（指定すると自動フロー制御チューニング機能が無効になる）

flowControlWindow

1〜2147483647

（単位：バイト）

（なし）

初期フローコントロールウィンドウサイズ

（指定すると自動フロー制御チューニング機能が有効になる。flowControlWindowと同時に指定した場合，flowControlWindowの設定は無効になる。flowControlWindowとinitialFlowControlWindowのどちらも指定しなかった場合，initialFlowControlWindowのデフォルト値が適用される）

initialFlowControlWindow

1〜2147483647

（単位：バイト）

1048576

キープアライブ

PINGフレームの送信間隔

keepAliveTime

10000〜8640000000

（単位：ミリ秒）

7200000

PINGフレームの送信からAcknowledgeを受信するまでの待機時間

keepAliveTimeout

10〜9223372036854

（単位：ミリ秒）

20000

接続相手からのPINGコントロールフレーム受信の最小間隔

permitKeepAliveTime

0〜9223372036854

（単位：ミリ秒）

0を指定した場合，接続相手からのPINGコントロールフレーム受信の送信間隔制限がなくなります。

300000

クライアント側で未実行のgRPC要求が存在しない場合に，PINGフレームの送信を許可するか

permitKeepAliveWithoutCalls

次のどちらかを指定してください。大文字・小文字は区別されません。

true

許可します。

false

許可しません。

false

同時に作成できるストリーム数

接続相手が同時に作成できる最大ストリーム数

（上限値を設定すると最大ストリーム数は無制限となる）

maxConcurrentCallsPerConnection

1〜2147483647

2147483647

コネクション切断

コネクションの最大接続時間

（コネクション確立からこの最大接続時間が経過した場合，実行中のサービス終了をmaxConnectionAgeGraceで指定した猶予期間だけ待機し，その後コネクションが切断される。指定しなかった場合または8640000000を設定した場合は，接続時間は無制限となる）

maxConnectionAge

60000〜8640000000

（単位：ミリ秒）

8640000000

コネクションを切断するまでの猶予期間

（この猶予期間内は未完了のサービスの終了を待機し，猶予期間内に終了しなかったサービスは強制切断される。指定しなかった場合または8640000000を設定した場合は，猶予期間は無制限となる）

maxConnectionAgeGrace

0〜8640000000

（単位：ミリ秒）

0を指定した場合，サービスの終了を待たないでコネクションが強制切断されます。

8640000000

コネクションの最大アイドル時間

（コネクション上の最後のメッセージ交換から，この最大アイドル時間を経過したコネクションは，maxConnectionAgeGraceで指定した猶予期間を経たあと切断される。指定しなかった場合または8640000000を設定した場合は，最大アイドル時間は無制限となる）

maxConnectionIdle

60000〜8640000000

（単位：ミリ秒）

8640000000

HTTP/2 Rapid Reset Attack対策

secondsPerWindowで指定する測定期間（ウィンドウ）ごとに受信できるRESETフレームの最大数

（このパラメタで指定した値を超える数のRESETフレームをsecondsPerWindowで指定した測定期間内に受信した場合，コネクションをクローズする）

maxRstFramePerWindow

1〜2147483647

200

RESETフレームの測定期間（ウィンドウ）

（このパラメタで指定した期間内に受信したRESETフレーム数が，maxRstFramePerWindowで指定した最大数を超えた場合，コネクションをクローズする）

secondsPerWindow

1〜2147483647

（単位：秒）

30

メッセージサイズ

gRPC要求電文の最大サイズ

maxInboundMessageSize

1〜2147483647

（単位：バイト）

4194304

gRPC要求電文（メタデータ）の最大サイズ

maxInboundMetadataSize

1〜2147483647

（単位：バイト）

8192

流量制御

リクエストを処理するスレッドプールのスレッド数（gRPCクライアントの同時実行数）

（指定したスレッド数を超えるリクエストを受信した場合，実行待ちキューにリクエストが追加される。スレッドに空きが発生すると，キューからリクエストが取り出されて処理される）

threadPoolSize

1〜2147483647

10

ログ出力

メッセージログの出力レベル

messagelogLevel

次のどれかを指定してください。※2

0

10

20

10

メソッドトレースの出力レベル

methodtraceLevel

1〜5※3

3

メソッドトレースの面数

methodtraceFilenum

1〜16

4

メソッドトレースのサイズ

methodtraceFilesize

1〜2147483647

（単位：バイト）

10485760

例外ログのログファイルの面数

exceptionlogFilenum

1〜16

4

例外ログのログファイル1面当たりのファイルサイズ

exceptionlogFilesize

1〜2147483647

（単位：バイト）

10485760

データトレースの出力有無

datatraceEnable

次のどちらかを指定してください。大文字・小文字は区別されません。

true

トレースを出力します。

false

トレースを出力しません。

false

データトレースの面数

datatraceFilenum

1〜16

4

データトレースの1面当たりのファイルサイズ

datatraceFilesize

1〜2147483647

（単位：バイト）

10485760

注※1

gRPCサーバ機能がgRPCクライアントからの接続要求を受け付けるネットワークインターフェースのIPアドレスを次のどれかの形式で指定します。

IPアドレスの指定方法

受け付けられるTCP/IP接続

「*」の場合

実行環境のすべてのネットワークインターフェース上にあるIPv4とIPv6の両方の接続を許可します。

なお，実行環境がIPv6アドレスをサポートしない場合は，すべてのIPv4アドレスのTCP/IP接続を受け付けます。

「0.0.0.0」の場合

すべてのIPv4ネットワークインターフェース上のTCP/IP接続を受け付けます。

「::」の場合

すべてのIPv6ネットワークインターフェース上のTCP/IP接続を受け付けます。

IPv4にマップ済みのIPv6アドレスの場合

IPv4またはIPv6のどちらかの形式で，そのアドレスのTCP/IP接続を受け付けます。

IPv4またはIPv6アドレスの場合（「127.0.0.1」や「::1」など）

該当するネットワークインターフェース上のTCP/IP接続を受け付けます。

注※2

メッセージログの出力レベルと，出力される情報を次に示します。

情報種別

出力レベル

0

10

20

エラーメッセージ

（例外や障害の発生を通知）

○

○

○

警告メッセージ

（システムを運用する上で確認が必要なものを通知）

△

○

○

インフォメーションメッセージ

（gRPCインバウンドアダプタに関する操作の実行結果を通知。起動・停止に対する応答など）

△

△

○

（凡例）

　○：すべて出力されます。

　△：重要なメッセージだけ出力されます。

注※3

メソッドトレースの出力レベルと，出力される情報を次に示します。

情報種別

出力レベル

1

2

3

4

5

メソッド内のエラー情報

○

○

○

○

○

外部から呼び出されるメソッド情報と，ファイル入出力メソッドの開始・終了情報

×

○

○

○

○

ほかのコンポーネントから参照するpublicメソッドの開始・終了情報

×

×

○

○

○

ほかのコンポーネントから参照しない内部メソッド（public以外のメソッド）の開始・終了情報

×

×

×

○

○

デバッグ情報

×

×

×

×

○

（凡例）

　○：出力されます。

　×：出力されません。

(13)　Service Coordinator-Managerのセットアップ

必要に応じて，「2.4　運用環境に関する設定」を参照し，設定してください。

(14)　DB Connectorのセットアップ（Reliable Messagingを使用しない場合）

HCSCサーバは，データベースと接続するためにDB Connectorを利用します。処理のタイミングやテーブル種別に応じて，データベースアクセスをトランザクション管理する場合と管理しない場合があるため，トランザクションサポート種別がXATransactionまたはLocalTransactionのDB Connectorと，トランザクションサポート種別がNoTransactionであるDB Connectorの，2つのDB Connectorを準備する必要があります。

なお，トランザクションサポート種別がXATransactionまたはLocalTransactionのDB Connectorは，処理性能を向上させるため，Reliable Messagingと連携できるDB Connectorを利用します。

それぞれのDB Connectorの表示名は，HCSCサーバセットアップ定義ファイルの「dbcon-xadisplayname」と「dbcon-nodisplayname」に指定します。HCSCサーバセットアップ定義ファイルの詳細については，マニュアル「サービスプラットフォームリファレンス」の「6.4.3　HCSCサーバセットアップ定義ファイル」を参照してください。

(a)　DB Connectorのインポート

インポートするDB Connectorは，利用条件を考慮して選択する必要があります。インポートするRARファイルの選択方法を次の表に示します。

表3‒18　インポートするRARファイルの選択方法（データベースを使用してReliable Messagingを使用しない場合）

HCSCサーバセットアップ定義ファイルのプロパティ

利用するデータベース

インポートするRARファイル

dbcon-xadisplayname

HiRDB

ライトトランザクション機能を利用する場合

DBConnector_HiRDB_Type4_CP.rar

ライトトランザクション機能を利用しない場合

DBConnector_HiRDB_Type4_XA.rar

Oracle

ライトトランザクション機能を利用する場合

DBConnector_Oracle_CP.rar

ライトトランザクション機能を利用しない場合

DBConnector_Oracle_XA.rar

dbcon-nodisplayname

HiRDB

DBConnector_HiRDB_Type4_CP.rar

Oracle

DBConnector_Oracle_CP.rar

また，DBアダプタを利用する場合は，DBアダプタが利用するDB Connectorをインポートします。インポートするRARファイルの選択方法を次の表に示します。

表3‒19　インポートするRARファイルの選択方法（DBアダプタを利用する場合）

利用するJDBCドライバ

利用するデータベース

インポートするRARファイル

HiRDB Type4 JDBC Driver

HiRDB

ライトトランザクション機能を利用する場合

DBConnector_HiRDB_Type4_CP.rar

ライトトランザクション機能を利用しない場合

DBConnector_HiRDB_Type4_XA.rar

Oracle JDBC Thin Driver

Oracle

ライトトランザクション機能を利用する場合

DBConnector_Oracle_CP.rar

ライトトランザクション機能を利用しない場合

DBConnector_Oracle_XA.rar

DB Connectorのインポート方法については，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「4.2　データベースと接続するための設定」を参照してください。また，プロパティ定義については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1　Connector属性ファイル」を参照してください。

ライトトランザクション機能については，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「3.14.5　ライトトランザクション」を参照してください。また，設定方法については，マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「10.8.6　トランザクションの設定」を参照してください。

(b)　プロパティの定義

DB Connectorをインポートしたあと，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1　Connector属性ファイル」を参照して，プロパティを定義してください。ただし，次の表に示す内容をプロパティに設定する必要があります。

表3‒20　dbcon-xadisplaynameに設定するDB Connector属性ファイルの設定内容（Oracle）

設定項目

設定値

<display-name>タグ

DB Connector表示名

<config-property>タグに設定するdatabaseNameプロパティ

データベース名※1

<config-property>タグに設定するbufSizeプロパティ

システムで利用する最大の電文長よりも大きな値※2

<transaction-support>タグ

ライトトランザクション機能を利用しない場合

XATransaction※3

ライトトランザクション機能を利用する場合

LocalTransaction※4

<connector-runtime>タグの<property>タグに設定するMaxPoolSizeプロパティ

ビジネスプロセスの最大同時実行数以上の値※5

注※1

使用するDB Connectorによって設定値が異なります。設定値については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1　Connector属性ファイル」を参照してください。また，データベースに接続するために必要な情報もあわせて設定してください。

注※2

次のDB Connectorを使用し，LONGVARBINARY_AccessプロパティにREALを指定した場合に指定してください。

・DBConnector_DABJ_XA.rar

・DBConnector_DABJ_CP.rar

注※3

次のDB Connectorに対して指定してください。

・DBConnector_DABJ_XA.rar

・DBConnector_Oracle_XA.rar

注※4

次のDB Connectorに対して指定してください。

・DBConnector_DABJ_CP.rar

・DBConnector_Oracle_CP.rar

注※5

他の機能でdbcon-xadisplaynameに設定したDB Connectorを使用する場合は，その機能の同時実行数を含めた値を指定してください。

表3‒21　dbcon-xadisplaynameに設定するDB Connector属性ファイルの設定内容（HiRDB Type4）

設定項目

設定値

<display-name>タグ

DB Connector表示名

<config-property>タグに設定するmaxBinarySizeプロパティ

システムで利用する最大の電文長よりも大きな値※1

<transaction-support>タグ

ライトトランザクション機能を利用しない場合

XATransaction※2

ライトトランザクション機能を利用する場合

LocalTransaction※3

<connector-runtime>タグの<property>タグに設定するMaxPoolSizeプロパティ

ビジネスプロセスの最大同時実行数以上の値※4

注※1

LONGVARBINARY_AccessプロパティにREALを指定した場合に指定してください。また，必ず0以外の値を指定してください。

注※2

次のDB Connectorに対して指定してください。

・DBConnector_HiRDB_Type4_XA.rar

注※3

次のDB Connectorに対して指定してください。

・DBConnector_HiRDB_Type4_CP.rar

注※4

他の機能でdbcon-xadisplaynameに設定したDB Connectorを使用する場合は，その機能の同時実行数を含めた値を指定してください。

注意

データベースに接続するために必要な情報を設定してください。設定値については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1　Connector属性ファイル」を参照してください。

表3‒22　dbcon-nodisplaynameに設定するDB Connector属性ファイルの設定内容（Oracle）

設定項目

設定値

<display-name>タグ

DB Connector表示名

<config-property>タグに設定するdatabaseNameプロパティ

データベース名※1

<config-property>タグに設定するbufSizeプロパティ

システムで利用する最大の電文長よりも大きな値※2

<transaction-support>タグ

NoTransaction※3

<connector-runtime>タグの<property>タグに設定するMaxPoolSizeプロパティ

1以上の値※4

注※1

使用するデータベースによって設定値が異なります。設定値については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1　Connector属性ファイル」を参照してください。また，データベースに接続するために必要な情報もあわせて設定してください。

注※2

次のDB Connectorを使用し，LONGVARBINARY_AccessプロパティにREALを指定した場合に指定してください。

・DBConnector_DABJ_CP.rar

注※3

次のDB Connectorを使用する場合に指定してください。

・DBConnector_DABJ_CP.rar

・DBConnector_Oracle_CP.rar

注※4

他の機能でdbcon-nodisplaynameに設定したDB Connectorを使用する場合は，その機能の同時実行数を含めた値を指定してください。

表3‒23　dbcon-nodisplaynameに設定するDB Connector属性ファイルの設定内容（HiRDB Type4）

設定項目

設定値

<display-name>タグ

DB Connector表示名

<config-property>タグに設定するmaxBinarySizeプロパティ

システムで利用する最大の電文長よりも大きな値※1

<transaction-support>タグ

NoTransaction※2

<connector-runtime>タグの<property>タグに設定するMaxPoolSizeプロパティ

1以上の値※3

注※1

LONGVARBINARY_AccessプロパティにREALを指定した場合に指定してください。また，必ず0以外の値を指定してください。

注※2

次のDB Connectorを使用する場合に指定してください。

・DBConnector_HiRDB_Type4_CP.rar

注※3

他の機能でdbcon-nodisplaynameに設定したDB Connectorを使用する場合は，その機能の同時実行数を含めた値を指定してください。

注意

データベースに接続するために必要な情報を設定してください。設定値については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1　Connector属性ファイル」を参照してください。

表3‒24　DBアダプタを利用する場合に設定するConnector属性ファイルの設定内容

設定項目

設定値

<display-name>タグ

DB Connector表示名※1

<config-property>タグに設定するdatabaseNameプロパティ

データベース名※2

<transaction-support>タグ

XATransaction

LocalTransaction

<connector-runtime>タグの<property>タグに設定するMaxPoolSizeプロパティ

DBアダプタの最大同時実行数以上の値※3

注※1

この値は，DBアダプタのアプリケーション統合属性ファイルの<linked-to>タグにも設定します。アプリケーション統合属性ファイルについては，マニュアル「サービスプラットフォーム開発ガイド 受付・アダプタ定義編」の「3.3.5　DBアダプタを定義する」を参照してください。

注※2

使用するDB Connectorによって設定値が異なります。設定値については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1　Connector属性ファイル」を参照してください。

注※3

他の機能でDBアダプタに指定したDBコネクタを使用する場合，その機能の同時実行数を含めた値を指定してください。

3.1.3　HCSCサーバをセットアップする

サービスアダプタ，ビジネスプロセス，ユーザ定義受付をHCSCサーバに配備して実行環境をセットアップするには，まず，HCSCサーバをセットアップする必要があります。また，HCSCサーバをセットアップするときに，あわせてクラスタもセットアップできます。

HCSCサーバのセットアップの前提条件，およびセットアップ方法について次に説明します。

参考

HCSCサーバをセットアップしたあと，HCSCサーバを起動する前に，HCSCサーバの定義情報を設定することを推奨します。HCSCサーバの定義方法については，「3.1.4　HCSCサーバの定義情報を設定する」を参照してください。

(1)　前提条件

HCSCサーバをセットアップするには，次の条件を満たす必要があります。

HCSCサーバをセットアップする実行環境のマシン上で次のプロセスが起動していること

運用管理エージェント

Management Server

J2EEサーバ

PRF

HTTP Server

運用管理エージェント，Management Server，J2EEサーバ，PRFの起動方法については，マニュアル「アプリケーションサーバ システム構築・運用ガイド」を参照してください。HTTP Serverの起動方法については，「5.3.6　HTTP Serverを起動する」を参照してください。

HCSCサーバをセットアップする実行環境のマシンに，Reliable Messaging，DB ConnectorおよびDBクライアントがセットアップされ，起動していること

同一クラスタ内で，データベースおよびReliable Messagingの使用有無が一致していること

同一リポジトリ内で，すべてのHCSCサーバのSOAPモードが一致していること

同一クラスタ内で，J2EEサーバの互換モードが一致していること

JDKのバージョンが11または17であること。

インストールしたJDKのバージョンによって，セットアップできる環境および使用できる機能が異なります。差異がある項目とその内容を次に示します。

表3‒25　JDKのバージョンによる差異

項目

インストールしたJDKのバージョンによる差異

GC方式

GC方式のデフォルトは次のように異なります。

JDK 11をインストールした環境：SerialGC

JDK 17をインストールした環境：G1GC

GC方式のデフォルトは，構築する環境の論理プロセッサやメモリによっても変わります。詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「14.5　Application Serverで指定できるJava HotSpot VMのオプション」を参照してください。

GCに関する設定は，運用者がシステム要件に合わせてチューニングする必要があります。G1GCのチューニングオプションに関しては，マニュアル「アプリケーションサーバ システム設計ガイド」の「7.　JavaVMのメモリチューニング」を参照してください。

明示管理ヒープ機能

JDK 17をインストールした環境では，GC方式のデフォルトはG1GCとなるため，GC方式がG1GCの環境でSerialGCのチューニングオプションである明示管理ヒープ機能（-XX:%val%HitachiUseExplicitMemory）は設定できません。

設定した場合はセットアップ実行時にエラーが発生し，セットアップに失敗します。

J2EEサーバの互換モード

セットアップできる環境は次のように異なります。

JDK 11をインストールした環境：V9互換モードまたは推奨モードの環境

JDK 17をインストールした環境：推奨モードの環境

使用できるSOAPモード

使用できるSOAPモードは次のように異なります。

JDK 11をインストールした環境：SOAP1.1モードまたはSOAP1.1/SOAP1.2併用モード

JDK 17をインストールした環境：SOAP1.1/SOAP1.2併用モード

また，インストールしたJDKのバージョンによって，セットアップした環境で使用できる機能のサポート範囲が異なります。構築した環境の機能のサポート範囲については，「2.2.3　SOAPモードの選択」を参照してください。

HCSCサーバ構成定義ファイルおよびHCSCサーバセットアップ定義ファイルが作成されていること

HCSCサーバ構成定義ファイルの作成方法については，「2.3.1　HCSCサーバ構成定義ファイルを設定する」を，ファイルの内容の詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.4.2　HCSCサーバ構成定義ファイル」を参照してください。

HCSCサーバセットアップ定義ファイルの作成方法については，「2.3.2　HCSCサーバセットアップ定義ファイルを設定する」を，ファイルの内容の詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.4.3　HCSCサーバセットアップ定義ファイル」を参照してください。

セットアップするHCSCサーバとすでにセットアップされているHCSCサーバでクラスタを構成する場合，HCSCサーバ構成定義ファイルおよびHCSCサーバセットアップ定義ファイルで同じ設定にする必要のある項目が同じ設定になっていること

HCSCサーバ構成定義ファイルおよびHCSCサーバセットアップ定義ファイルで，クラスタを構成するHCSCサーバ間で同じ設定にする必要のある項目については，ロードバランスクラスタ構成の場合は「2.5.1(1)　実行環境の構築」を，HAクラスタ構成の場合は「2.6.1(1)　実行環境（実行系・待機系）の構築」を参照してください。

HCSCサーバをアンセットアップしたあとに再度セットアップする場合，J2EEサーバを再起動していること

注意事項

HCSCサーバをセットアップするJ2EEサーバに，非同期受付で使用する次のキュー名と同じ名称のキューが存在する場合，セットアップが失敗します。また，セットアップが失敗したあと，同じ名称のキューは削除されます。

単独構成およびロードバランスクラスタの場合

CSC<HCSCサーバ名>ACPT_RCVQ

CSC<HCSCサーバ名>ACPT_DBQ

HAクラスタの場合

CSC<クラスタ名>ACPT_RCVQ

CSC<クラスタ名>ACPT_DBQ

そのため，非同期受付で使用するこれらのキュー名のキューが存在しないことを確認してからセットアップを実施してください。

注意事項

HCSCサーバのセットアップ後は，usrconf.cfg（J2EEサーバ用オプション定義ファイル）のejb.public.directoryの設定値を変更できません。設定値を変更する場合は，HCSCサーバのセットアップ前に変更してください。

(2)　セットアップ方法

HCSCサーバをセットアップするには，運用環境でcscsvsetupコマンドを実行します。

cscsvsetupコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscsvsetup（HCSCサーバのセットアップ）」を参照してください。

セットアップする内容は，単独のHCSCサーバをセットアップするか，すでにセットアップされているHCSCサーバとクラスタを構成するようにセットアップするかによって異なります。

注意事項

コマンド実行時に通信障害やタイムアウトが発生した場合，実行環境側で処理が完結している可能性があります。そのため，HCSCサーバのセットアップ情報を取得し，取得した情報に従って，再度cscsvsetupコマンドを実行してください。HCSCサーバのセットアップ情報の取得方法については，「5.3.15　HCSCサーバのセットアップ情報を確認する」を参照してください。なお，HCSCサーバのセットアップ情報を取得する場合，cscutilコマンドに-hostオプションを使用する必要があります。cscutilコマンドの詳細については，マニュアル「サービスプラットフォームリファレンス」の「cscutil（各種操作）」を参照してください。

クラスタ名とHCSCサーバ名は大文字/小文字を区別しないため，一意な名前を設定してください。ただし，HCSCサーバセットアップ時に，クラスタ名を省略してセットアップすることはできます。

データベースを利用してセットアップする場合，運用環境のリポジトリが別であったとしても，複数のマシンで同時にcscsvsetupコマンド（HCSCサーバのセットアップ）やcscsvunsetupコマンド（HCSCサーバのアンセットアップ）を実行しないでください。

セットアップ後に，構築時のHCSCサーバ構成定義ファイルの情報を確認することはできません。必要に応じてHCSCサーバ構成定義ファイルのバックアップを取得してください。

(a)　単独のHCSCサーバをセットアップする場合

-clusterオプションに，クラスタ名を指定します。ただし，この段階では，単独のHCSCサーバであるため，クラスタの構成にはなりません。ほかのHCSCサーバをセットアップするときに，ここで指定したクラスタ名を指定してセットアップすることで，クラスタを構成できます。

cscsvsetup -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -cluster <クラスタ名> -propfile <HCSCサーバ構成定義ファイル名>

なお，クラスタ名を省略すると，-cscオプションに指定したHCSCサーバ名がクラスタ名として設定されます。

cscsvsetup -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -propfile <HCSCサーバ構成定義ファイル名>

(b)　セットアップ済みのHCSCサーバとクラスタを構成する場合

-clusterオプションには，HCSCサーバを追加するクラスタ名を指定します。

cscsvsetup -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -cluster <HCSCサーバを追加するクラスタ名> -propfile <HCSCサーバ構成定義ファイル名>

(3)　セットアップ情報の追加・変更

すでにセットアップしたHCSCサーバに対して，「(2) セットアップ方法」に示すセットアップを再実行すると，セットアップした情報を追加・変更できます。

HCSCサーバのセットアップ情報を追加・変更する場合，HCSCサーバ，サービスアダプタ，ビジネスプロセス，ユーザ定義受付がすべて停止している必要があります。

HCSCサーバ，サービスアダプタ，ビジネスプロセス，ユーザ定義受付の状態の確認方法については，それぞれ「5.3.16　HCSCサーバの情報を確認する」，「5.3.19　サービスアダプタの情報を確認する」，「5.3.20　ビジネスプロセスの情報を確認する」，「5.3.21　ユーザ定義受付の情報を確認する」を参照してください。

追加・変更できる情報を次に示します。

追加できる情報

標準受付の種別

同期（Webサービス／SessionBean），および非同期（MDB（WS-R）／MDB（DBキュー））の標準受付を追加してセットアップできます。すでにセットアップした標準受付の種別の情報を変更または削除する場合，アンセットアップしたあと，再度セットアップしてください。

変更できる情報

同期の標準受付（Webサービス）の位置情報

同期の標準受付（Webサービス）で使用するWebサーバの位置情報です。WebサーバのIPアドレス，ポート番号およびプロトコルを変更できます。

非同期（MDB（WS-R））の標準受付の位置情報

非同期（MDB（WS-R））の標準受付で使用するWebサーバの位置情報です。WebサーバのIPアドレス，ポート番号およびプロトコルを変更できます。

同期（SessionBean）の標準受付の位置情報

同期（SessionBean）の標準受付で使用するNameServerの位置情報です。NameServerのIPアドレスおよびポート番号を変更できます。

Manager位置情報

ManagerにアクセスするためのIPアドレスおよびポート番号を変更できます。

注意事項

上記の情報以外を追加または変更する場合，一度HCSCサーバをアンセットアップしてから，再度セットアップする必要があります。HCSCサーバをアンセットアップしないまま上記の情報以外の情報を追加・変更してセットアップを実施した場合，追加および変更は無視されます。

3.1.4　HCSCサーバの定義情報を設定する

HCSCサーバランタイム定義ファイルに定義したHCSCサーバの定義情報を設定するための前提条件，および設定方法について次に説明します。

(1)　前提条件

HCSCサーバが停止状態または起動状態であること

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

HCSCサーバランタイム定義ファイルが作成されていること

HCSCサーバランタイム定義ファイルの作成方法については，「2.3.3　HCSCサーバランタイム定義ファイルを設定する」を，ファイルの内容の詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.5.6　HCSCサーバランタイム定義ファイル」を参照してください。

(2)　設定方法

HCSCサーバランタイム定義ファイルに定義したHCSCサーバの定義情報を設定するには，運用環境でcscsvconfigコマンドを実行します。

cscsvconfigコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscsvconfig（HCSCサーバランタイムの定義）」を参照してください。

cscsvconfigコマンドの実行形式を次に示します。

クラスタ内のHCSCサーバに一括して定義を設定する場合

クラスタ名を指定して実行します。

-clusterオプションで指定したクラスタ内のHCSCサーバに，-propfileオプションで指定した定義ファイルの内容が設定されます。

cscsvconfig -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -operation set -propfile <HCSCサーバランタイム定義ファイル名>

指定したHCSCサーバに定義を設定する場合

HCSCサーバ名を指定して実行します。

-cscオプションで指定したHCSCサーバに，-propfileオプションで指定した定義ファイルの内容が設定されます。

cscsvconfig -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -operation set -propfile <HCSCサーバランタイム定義ファイル名>

注意事項

設定された定義情報は，HCSCサーバを再度起動したときに反映されます。なお，受付に関する定義情報は，受付の開始時に反映されます。

3.1.5　HCSCサーバの定義内容を確認する

HCSCサーバに設定されている定義内容の確認の前提条件，および確認方法について次に説明します。

(1)　前提条件

HCSCサーバが停止状態または起動状態である必要があります。

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

(2)　確認方法

HCSCサーバの定義内容を確認するには，運用環境でcscsvconfigコマンドを実行します。

cscsvconfigコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscsvconfig（HCSCサーバランタイムの定義）」を参照してください。

cscsvconfigコマンドの実行形式を次に示します。

cscsvconfig -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -operation get

HCSCサーバに設定されている定義内容は，標準出力に出力されます。出力された内容は，必要に応じてファイルにリダイレクトします。

3.1.6　サービス情報を変更する

開発環境ではサービスアダプタ開発時に，サービスアダプタの接続先情報，タイムアウト値などを設定します。運用環境では，これらの設定値をサービス情報として環境に適した値に変更できます。

また，変更したサービス情報はリポジトリには反映されません。変更したサービス情報は運用環境に保持され，サービスアダプタを実行環境に配備する際に反映されます。そのため，開発環境とは独立してサービス情報を管理できます。

なお，運用環境で設定したサービス情報は，サービス情報を削除しないかぎり有効です。開発環境でサービスアダプタの情報を変更しても，運用環境で設定したサービス情報を削除しないかぎり，サービスアダプタには運用環境で設定したサービス情報が反映されます。

それぞれの環境でのサービス情報の扱いを次の図に示します。

図3‒9　サービス情報を設定してからサービス情報を変更するまでの流れ

サービス情報を変更する前提条件，および変更方法について次に説明します。

(1)　前提条件

サービス情報を変更するには，次の条件を満たす必要があります。

リポジトリを共有していないこと

クラスタ内のすべてのHCSCサーバで，サービス情報を変更するサービスアダプタが未配備状態であること

(2)　変更方法

サービス情報を変更するには，運用環境でcscsvcctlコマンドを実行します。

cscsvcctlコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscsvcctl（サービス情報の管理）」を参照してください。

サービス情報を一括して変更するか，指定したサービス情報を個別に変更するかによって実行形式が異なります。

(a)　サービス情報を一括して変更する場合

サービス情報を一括して変更する手順を次に示します。

-getfileオプションにサービス情報を出力するファイル名（任意）を指定して実行します。

cscsvcctl -user <ログインユーザID> -pass <ログインパスワード> -getfile <サービス情報変更定義ファイル名>

取得したサービス情報変更定義ファイルに変更内容を定義します。

取得したサービス情報変更定義ファイル中で，プロキシサーバのユーザID/パスワード，ベーシック認証のユーザID/パスワード設定値は，次のように出力されます。

値が設定されているとき：The value has already been set.

値が設定されていないとき：空白

なお，プロキシサーバのユーザID/パスワード，ベーシック認証のユーザID/パスワードを変更しない場合は，-getfileオプションで取得したままの値を定義してください。また，ベーシック認証を使用する場合は，ベーシック認証に関するすべてのパラメタ（使用可否，ユーザ名，およびパスワード）を設定してください。

サービス情報変更定義ファイルの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.5.10　サービス情報変更定義ファイル」を参照してください。

-setfileオプションにサービス情報変更定義ファイルを指定して実行します。

cscsvcctl -user <ログインユーザID> -pass <ログインパスワード> -setfile <サービス情報変更定義ファイル名>

(b)　指定したサービス情報を個別に変更する場合

指定したサービス情報を個別に変更するには，-propsオプションに変更したいサービス情報を指定して実行します。

cscsvcctl -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -name <サービスアダプタのサービスID> -props <プロパティ>

なお，ベーシック認証を使用する場合は，サービス情報変更定義ファイルのベーシック認証に関するすべてのパラメタ（使用可否，ユーザ名，およびパスワード）を設定してください。

サービス情報変更定義ファイルの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.5.10　サービス情報変更定義ファイル」を参照してください。

(3)　サービス情報の削除

cscsvcctlコマンドで変更したサービス情報は，次の場合に削除されます。

削除するサービス情報の行頭に「#」を記述してコメント扱いにしたあと，cscsvcctlコマンドに-setfileオプションを指定して，サービス情報を上書きした場合

クラスタ内のすべてのHCSCサーバがアンセットアップされた場合

cscsvcctlコマンドでサービス情報を変更したサービスアダプタを開発環境で削除または非公開※にし，運用環境にインポートした場合

ただし，開発環境で削除したサービスアダプタと，サービスIDおよび種別が同じサービスアダプタをインポートした場合，サービス情報は削除されません。

注※

HCSCコンポーネントをHCSCサーバから削除（配備定義を削除）して，システム構成定義を更新することです。

3.1.7　サービス情報を確認する

サービス情報を確認する前提条件，および確認方法について次に説明します。

(1)　前提条件

リポジトリを共有していないこと

(2)　確認方法

変更したサービス情報を確認するには，運用環境でcscsvclsコマンドを実行します。

cscsvclsコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscsvcls（サービス情報の表示）」を参照してください。

現在有効になっているサービス情報を確認する場合，オプションを指定しないでcscsvclsコマンドを実行します。

cscsvcls -user <ログインユーザID> -pass <ログインパスワード>

変更したサービス情報および開発環境で設定したサービス情報を確認する場合，-detailオプションを指定してcscsvclsコマンドを実行します。

cscsvcls -user <ログインユーザID> -pass <ログインパスワード> -detail

なお，プロキシサーバのユーザID/パスワード，ベーシック認証のユーザID/パスワードが設定されていた場合，サービス情報を出力した際，設定値に「The value has already been set.」が表示されます。

3.1.8　サービスアダプタを配備する

サービスアダプタを実行環境に配備する場合の前提条件，および配備方法について説明します。

なお，HCSCコンポーネントをHCSCサーバに配備して開始する一連の処理を，開発環境で一括して実行することもできます。ただし，一括実行は，システム開発時，または単体テストから結合テスト時を対象としています。詳細については，マニュアル「サービスプラットフォーム開発ガイド 基本開発編」の「8.5　HCSCコンポーネントをHCSCサーバに配備して開始する処理の一括実行」を参照してください。

(1)　前提条件

サービスアダプタを配備するには，次の条件を満たす必要があります。

配備先の実行環境のHCSCサーバが起動状態であること

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

次の場合には，配備前にHCSCサーバを再起動していること

削除したMDB（WS-R）アダプタまたはMDB（DBキュー）アダプタのサービスIDと同じ名称のままで，配備するサービスアダプタのサービス部品の種類（MDB（WS-R）アダプタまたはMDB（DBキュー）アダプタ）を変更した場合

削除したMDB（WS-R）アダプタのサービスIDと同じ名称のままで，配備するサービスアダプタのキュー情報（JMSメッセージ種別，最大メッセージ数，および転送キュー作成先RDエリア）を変更した場合

削除したMDB（WS-R）アダプタまたはMDB（DBキュー）アダプタのサービスIDと，大文字／小文字だけが異なるサービスIDのサービスアダプタを配備する場合

HCSCサーバを再起動しないで配備すると，新たに配備したサービスアダプタで定義されている情報が無視されたり，正常に動作しなかったりする場合があります。

(2)　配備方法

サービスアダプタを配備するには，運用環境でcsccompodeployコマンドを実行します。

csccompodeployコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「csccompodeploy（HCSCコンポーネントの配備）」を参照してください。

すべてのサービスアダプタを一括して配備するか，指定したサービスアダプタだけを配備するかによって実行形式が異なります。

注意事項

サービスアダプタを配備するとき，配備済みのサービスアダプタおよびビジネスプロセスのサービスID，ならびにユーザ定義受付の受付IDと大文字/小文字だけが異なるサービスアダプタのサービスIDは使用しないでください。このような名称を使用するとサービスアダプタが配備できません。

(a)　すべてのサービスアダプタを一括して配備する場合

HCSCサーバまたはクラスタにすべてのサービスアダプタを一括して配備します。

サービスアダプタの配備先が単一のHCSCサーバか，クラスタを構成するすべてのHCSCサーバかによって実行形式が異なります。

単一のHCSCサーバにすべてのサービスアダプタを配備する場合

HCSCサーバ名と-allオプションを指定して実行します。

-cscオプションで指定したHCSCサーバに，配備されていないサービスアダプタがすべて配備されます（配備されていないビジネスプロセスおよびユーザ定義受付も同時にすべて配備されます）。

csccompodeploy -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -all

クラスタ内のすべてのHCSCサーバにすべてのサービスアダプタを配備する場合

クラスタ名と-allオプションを指定して実行します。

-clusterオプションで指定したクラスタ内のすべてのHCSCサーバに，配備されていないサービスアダプタがすべて配備されます（配備されていないビジネスプロセスおよびユーザ定義受付も同時にすべて配備されます）。

csccompodeploy -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -all

注意事項

-allオプションを指定して実行した結果，サービスアダプタ，ビジネスプロセス，およびユーザ定義受付の配備が失敗した場合，未配備のサービスアダプタ，ビジネスプロセスおよびユーザ定義受付が存在しても無視してコマンドを終了します。コマンドを実行したあとには，cscreplsコマンドを利用して配備の状況を確認します。

cscreplsコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscrepls（リポジトリ情報の表示）」を参照してください。

(b)　指定したサービスアダプタだけを配備する場合

HCSCサーバまたはクラスタに，指定したサービスアダプタだけを配備します。

サービスアダプタの配備先が単一のHCSCサーバか，クラスタを構成するすべてのHCSCサーバかによって実行形式が異なります。

指定したサービスアダプタを単一のHCSCサーバに配備する場合

HCSCサーバ名とサービスアダプタのサービスIDを指定して実行します。

-cscオプションで指定したHCSCサーバに，-nameオプションで指定したサービスアダプタが配備されます。

csccompodeploy -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -name <サービスアダプタのサービスID>

csccompodeployコマンドに指定するHCSCサーバ名およびサービスアダプタのサービスIDは，cscreplsコマンドで確認できます。cscreplsコマンドの詳細については，マニュアル「サービスプラットフォームリファレンス」の「cscrepls（リポジトリ情報の表示）」を参照してください。

指定したサービスアダプタをクラスタ内のすべてのHCSCサーバに配備する場合

クラスタ名とサービスアダプタのサービスIDを指定して実行します。

-clusterオプションで指定したクラスタ内のすべてのHCSCサーバに，指定したサービスアダプタが配備されます。

csccompodeploy -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -name <サービスアダプタのサービスID>

3.1.9　HCSCコンポーネントの定義ファイルを運用環境に取得する

次に示すHCSCコンポーネントの定義ファイルを運用環境に取得するには，csccmctlコマンドに-operation getオプションを指定して実行します。開発者がこれらのHCSCコンポーネントを開発および配備定義したあとで実行してください。

DBアダプタ

TP1アダプタ

ファイルアダプタ

Object Accessアダプタ

Message Queueアダプタ

FTPアダプタ

ファイル操作アダプタ

メールアダプタ

HTTPアダプタ

コマンドアダプタ

SFTPアダプタ

Kafkaアダプタ

gRPCアダプタ

汎用カスタムアダプタ

SOAP受付

TP1/RPC受付

FTP受付※

HTTP受付

Message Queue受付

ファイルイベント受付

Kafka受付

スケジュール駆動受付

gRPC受付

カスタム受付

注※

FTP受付の取得方法については，次に示す個所を参照してください。

「3.2.6　FTP受付定義ファイルを取得する」

なお，定義ファイルを取得しただけでは，定義ファイルを運用環境に設定したことになりません。定義ファイルを運用環境に設定するには，取得後にcsccmctlコマンドに-operation setオプションを指定して実行する必要があります。設定方法については，「3.1.10　HCSCコンポーネントの定義ファイルを運用環境に設定，更新する」を参照してください。

(1)　コマンドの使用例

定義ファイルを取得する場合のコマンドの使用例を次に示します。csccmctlコマンドの詳細は，マニュアル「サービスプラットフォーム リファレンス」の「csccmctl（定義ファイルの管理）」を参照してください。

例1

クラスタ名が「CLS1」，サービスIDが「ADP1」で，定義ファイル「csccustomadapter.properties」を「C:¥tmp」以下のディレクトリに取得する場合

csccmctl -cluster CLS1 -name ADP1 -targetfilename csccustomadapter.properties -basedir C:¥tmp -operation get

例2

クラスタ名が「CLS1」，サービスIDが「ADP1」で，TP1アダプタに設定する通信定義ファイル「adptp1_config.xml」を「C:¥tmp」以下のディレクトリに取得する場合

csccmctl -cluster CLS1 -name ADP1 -targetfilename adptp1_config.xml -basedir C:¥tmp -operation get

(2)　注意事項

指定したファイル名と同じ定義ファイルがディレクトリ内にすでに存在する場合，ディレクトリ内のファイルが上書きされます。

次の場合はコマンドが異常終了します。

-basedirオプションで指定したディレクトリがない場合

指定したファイル名と同名のディレクトリが存在する場合

ファイル書き込みに失敗した場合

3.1.10　HCSCコンポーネントの定義ファイルを運用環境に設定，更新する

運用環境に取得した定義ファイルは，csccmctlコマンドに-operation setオプションを指定して実行することで運用環境に設定します。すでに定義ファイルを設定している場合は，再度-operation setオプションを指定して実行することで設定内容が更新されます。

この項では，csccmctlコマンドの-operation setオプションで，次に示すHCSCコンポーネントの定義ファイルを設定，および更新する方法について説明します。なお，このオプションで設定した定義ファイルは，運用環境でだけ有効になります。

DBアダプタ

TP1アダプタ

ファイルアダプタ

Object Accessアダプタ

Message Queueアダプタ

FTPアダプタ

ファイル操作アダプタ

メールアダプタ

HTTPアダプタ

コマンドアダプタ

SFTPアダプタ

Kafkaアダプタ

gRPCアダプタ

汎用カスタムアダプタ

SOAP受付

TP1/RPC受付

FTP受付※

HTTP受付

Message Queue受付

ファイルイベント受付

Kafka受付

スケジュール駆動受付

gRPC受付

カスタム受付

注※

FTP受付の定義ファイルの設定方法については，次に示す個所を参照してください。

「3.2.7　FTP受付定義ファイルの定義情報を設定する」

(1)　コマンドの使用例

HCSCコンポーネントの定義ファイルを設定，および更新する場合のコマンドの使用例を次に示します。csccmctlコマンドの詳細は，マニュアル「サービスプラットフォームリファレンス」の「csccmctl（定義ファイルの管理）」を参照してください。

例1

クラスタ名が「CLS1」，サービスIDが「ADP1」で，「C:¥tmp」以下のディレクトリに配置されている定義ファイル「csccustomadapter.properties」を運用環境に設定，または更新する場合

csccmctl -cluster CLS1 -name ADP1 -targetfilename csccustomadapter.properties -basedir C:¥tmp -operation set

例2

クラスタ名が「CLS1」，サービスIDが「ADP1」で，「C:¥tmp」以下のディレクトリに配置されているTP1アダプタに設定する通信定義ファイル「adptp1_config.xml」を運用環境に設定，または更新する場合

csccmctl -cluster CLS1 -name ADP1 -targetfilename adptp1_config.xml -basedir C:¥tmp -operation set

なお，設定および更新した定義内容は次のどれかの場合に削除されます。

-operation resetオプションで定義ファイルを削除した場合

クラスタ内のすべてのHCSCサーバがアンセットアップされた場合

開発環境で定義ファイルを設定したHCSCコンポーネントを削除したり，別のHCSCコンポーネントに変更したリポジトリをインポートしたりした場合

(2)　注意事項

-operation setオプションは，HCSCコンポーネントの配備前に実行してください。

設定および更新した定義ファイルを持つHCSCコンポーネントをcsccompoundeployコマンドで削除して，同じサービスIDまたは受付IDで異なる種別のHCSCコンポーネントのリポジトリをインポートする場合，-operation resetオプションで対象のサービスIDまたは受付IDのHCSCコンポーネントが持つ定義ファイルを削除する必要があります。

<リポジトリルート>/manager/custom以下に[-cluster指定値]-[-name指定値]のディレクトリが存在しない場合，コマンド内部でディレクトリが作成されます。

次の場合はエラーになります。

-targetfilenameオプションに設定したファイルが存在しない場合

指定したファイルまでのディレクトリがない場合

-targetfilenameオプションに設定したファイルの読み込みに失敗した場合

運用環境に定義する内容に適さない定義が定義ファイルに含まれている場合

3.1.11　HCSCコンポーネントの定義ファイルを運用環境から削除する

次に示すHCSCコンポーネントの定義ファイルを削除するには，csccmctlコマンドに-operation resetオプションを指定して実行します。

DBアダプタ

TP1アダプタ

ファイルアダプタ

Object Accessアダプタ

Message Queueアダプタ

FTPアダプタ

ファイル操作アダプタ

メールアダプタ

HTTPアダプタ

コマンドアダプタ

SFTPアダプタ

Kafkaアダプタ

gRPCアダプタ

汎用カスタムアダプタ

SOAP受付

TP1/RPC受付

FTP受付

HTTP受付

Message Queue受付

ファイルイベント受付

Kafka受付

スケジュール駆動受付

gRPC受付

カスタム受付

(1)　コマンドの使用例

HCSCコンポーネントの定義ファイルを削除する場合のコマンドの使用例を次に示します。csccmctlコマンドの詳細は，マニュアル「サービスプラットフォーム リファレンス」の「csccmctl（定義ファイルの管理）」を参照してください。

例1：クラスタ名が「CLS1」，サービスIDが「ADP1」で，定義ファイル「csccustomadapter.properties」を運用環境から削除する場合

csccmctl -cluster CLS1 -name ADP1 -targetfilename csccustomadapter.properties -operation reset

例2：クラスタ名が「CLS1」，サービスIDが「ADP1」で，TP1アダプタに設定する通信構成定義ファイル「adptp1_config.xml」を運用環境から削除する場合

csccmctl -cluster CLS1 -name ADP1 -targetfilename adptp1_config.xml -operation reset

(a)　注意事項

-operation resetオプションは，HCSCコンポーネントの配備前に実行してください。

次の場合はエラーになります。

-targetfilenameオプションに設定したファイルが存在しない場合

-targetfilenameオプションに設定したファイルを削除できない場合

3.1.12　運用環境の定義ファイルの状態を確認する

cscsvclsコマンドを使用することで，変更後の定義ファイルを確認できます。

(1)　コマンドの使用例

変更後の定義ファイルを確認する場合のコマンドの使用例を次に示します。cscsvclsコマンドの詳細は，マニュアル「サービスプラットフォーム リファレンス」の「cscsvcls（サービス情報の表示）」を参照してください。

現在有効になっているサービス情報を確認する場合

-detailオプションを指定しないでcscsvclsコマンドを実行します。

cscsvcls -user <ログインユーザID> -pass <ログインパスワード>

変更したサービス情報および開発環境で設定したサービス情報を確認する場合

-detailオプションを指定してcscsvclsコマンドを実行します。

cscsvcls -user <ログインユーザID> -pass <ログインパスワード> -detail

なお，プロキシサーバのユーザIDおよびパスワード，ベーシック認証のユーザIDおよびパスワードが設定されていた場合，サービス情報を出力すると，設定値に「The value has already been set.」が表示されます。

3.1.13　ビジネスプロセスを配備する

ビジネスプロセスを実行環境に配備する場合の前提条件，および配備方法について次に説明します。

なお，HCSCコンポーネントをHCSCサーバに配備して開始する一連の処理を，開発環境で一括して実行することもできます。ただし，一括実行は，システム開発時，または単体テストから結合テスト時を対象としています。詳細については，マニュアル「サービスプラットフォーム開発ガイド 基本開発編」の「8.5　HCSCコンポーネントをHCSCサーバに配備して開始する処理の一括実行」を参照してください。

(1)　前提条件

ビジネスプロセスを配備するには，配備先の実行環境のHCSCサーバが起動状態である必要があります。

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

(2)　配備方法

ビジネスプロセスを配備するには，運用環境でcsccompodeployコマンドを実行します。

csccompodeployコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「csccompodeploy（HCSCコンポーネントの配備）」を参照してください。

すべてのビジネスプロセスを一括して配備するか，指定したビジネスプロセスだけを配備するかによって実行形式が異なります。

注意事項

ビジネスプロセスを配備するとき，配備済みのサービスアダプタおよびビジネスプロセスのサービスID，ならびにユーザ定義受付の受付IDと大文字/小文字だけが異なるビジネスプロセスのサービスIDは使用しないでください。このような名称を使用するとビジネスプロセスが配備できません。

(a)　すべてのビジネスプロセスを一括して配備する場合

HCSCサーバまたはクラスタにすべてのビジネスプロセスを一括して配備します。

ビジネスプロセスの配備先が単一のHCSCサーバか，クラスタを構成するすべてのHCSCサーバかによって実行形式が異なります。

単一のHCSCサーバにすべてのビジネスプロセスを配備する場合

HCSCサーバ名と-allオプションを指定して実行します。

-cscオプションで指定したHCSCサーバに，配備されていないビジネスプロセスがすべて配備されます（配備されていないサービスアダプタおよびユーザ定義受付も同時にすべて配備されます）。

csccompodeploy -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -all

クラスタ内のすべてのHCSCサーバにすべてのビジネスプロセスを配備する場合

クラスタ名と-allオプションを指定して実行します。

-clusterオプションで指定したクラスタ内のすべてのHCSCサーバに，配備されていないビジネスプロセスがすべて配備されます（配備されていないサービスアダプタおよびユーザ定義受付も同時にすべて配備されます）。

csccompodeploy -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -all

注意事項

-allオプションを指定して実行した結果，サービスアダプタ，ビジネスプロセスおよびユーザ定義受付の配備が失敗した場合，未配備のサービスアダプタ，ビジネスプロセスおよびユーザ定義受付が存在しても無視してコマンドを終了します。コマンドを実行したあとには，cscreplsコマンドを利用して配備の状況を確認します。

cscreplsコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscrepls（リポジトリ情報の表示）」を参照してください。

(b)　指定したビジネスプロセスだけを配備する場合

HCSCサーバまたはクラスタに，指定したビジネスプロセスだけを配備します。

ビジネスプロセスの配備先が単一のHCSCサーバか，クラスタを構成するすべてのHCSCサーバかによって実行形式が異なります。

指定したビジネスプロセスを単一のHCSCサーバに配備する場合

HCSCサーバ名とビジネスプロセスのサービスIDを指定して実行します。

-cscオプションで指定したHCSCサーバに，-nameオプションで指定したビジネスプロセスが配備されます。

csccompodeploy -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -name <ビジネスプロセスのサービスID>

csccompodeployコマンドに指定するHCSCサーバ名およびビジネスプロセスのサービスIDは，cscreplsコマンドで確認できます。cscreplsコマンドの詳細については，マニュアル「サービスプラットフォームリファレンス」の「cscrepls（リポジトリ情報の表示）」を参照してください。

指定したビジネスプロセスをクラスタ内のすべてのHCSCサーバに配備する場合

クラスタ名とビジネスプロセスのサービスIDを指定して実行します。

-clusterオプションで指定したクラスタ内のすべてのHCSCサーバに，指定したビジネスプロセスが配備されます。

csccompodeploy -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -name <ビジネスプロセスのサービスID>

3.1.14　ユーザ定義受付を配備する

ユーザ定義受付を実行環境に配備する場合の前提条件，および配備方法について次に説明します。

なお，HCSCコンポーネントをHCSCサーバに配備して開始する一連の処理を，開発環境で一括して実行することもできます。ただし，一括実行は，システム開発時，または単体テストから結合テスト時を対象としています。詳細については，マニュアル「サービスプラットフォーム開発ガイド 基本開発編」の「8.5　HCSCコンポーネントをHCSCサーバに配備して開始する処理の一括実行」を参照してください。

(1)　前提条件

ユーザ定義受付を配備するには，配備先の実行環境のHCSCサーバが起動状態である必要があります。

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

(2)　配備方法

ユーザ定義受付を配備するには，運用環境でcsccompodeployコマンドを実行します。

csccompodeployコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「csccompodeploy（HCSCコンポーネントの配備）」を参照してください。

すべてのユーザ定義受付を一括して配備するか，指定したユーザ定義受付だけを配備するかによって実行形式が異なります。

注意事項

ユーザ定義受付を配備するとき，配備済みのサービスアダプタおよびビジネスプロセスのサービスID，もしくはユーザ定義受付の受付IDと，大文字/小文字だけが異なるユーザ定義受付の受付IDは使用しないでください。このような名称を使用するとユーザ定義受付が配備できません。

(a)　すべてのユーザ定義受付を一括して配備する場合

HCSCサーバまたはクラスタにすべてのユーザ定義受付を一括して配備します。

ユーザ定義受付の配備先が単一のHCSCサーバか，クラスタを構成するすべてのHCSCサーバかによって実行形式が異なります。

単一のHCSCサーバにすべてのユーザ定義受付を配備する場合

HCSCサーバ名と-allオプションを指定して実行します。

-cscオプションで指定したHCSCサーバに，配備されていないユーザ定義受付がすべて配備されます（配備されていないサービスアダプタおよびビジネスプロセスも同時にすべて配備されます）。

csccompodeploy -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -all

クラスタ内のすべてのHCSCサーバにすべてのユーザ定義受付を配備する場合

クラスタ名と-allオプションを指定して実行します。

-clusterオプションで指定したクラスタ内のすべてのHCSCサーバに，配備されていないユーザ定義受付がすべて配備されます（配備されていないサービスアダプタおよびビジネスプロセスも同時にすべて配備されます）。

csccompodeploy -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -all

注意事項

-allオプションを指定して実行した結果，サービスアダプタ，ビジネスプロセスおよびユーザ定義受付の配備が失敗した場合，未配備のサービスアダプタ，ビジネスプロセスおよびユーザ定義受付が存在しても無視してコマンドを終了します。コマンドを実行したあとには，cscreplsコマンドを利用して配備の状況を確認します。

cscreplsコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscrepls（リポジトリ情報の表示）」を参照してください。

(b)　指定したユーザ定義受付だけを配備する場合

HCSCサーバまたはクラスタに，指定したユーザ定義受付だけを配備します。

ユーザ定義受付の配備先が単一のHCSCサーバか，クラスタを構成するすべてのHCSCサーバかによって実行形式が異なります。

指定したユーザ定義受付を単一のHCSCサーバに配備する場合

HCSCサーバ名とユーザ定義受付の受付IDを指定して実行します。

-cscオプションで指定したHCSCサーバに，-nameオプションで指定したユーザ定義受付が配備されます。

csccompodeploy -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -name <ユーザ定義受付の受付ID>

csccompodeployコマンドに指定するHCSCサーバ名およびユーザ定義受付の受付IDは，cscreplsコマンドで確認できます。cscreplsコマンドの詳細については，マニュアル「サービスプラットフォームリファレンス」の「cscrepls（リポジトリ情報の表示）」を参照してください。

指定したユーザ定義受付をクラスタ内のすべてのHCSCサーバに配備する場合

クラスタ名とユーザ定義受付の受付IDを指定して実行します。

-clusterオプションで指定したクラスタ内のすべてのHCSCサーバに，指定したユーザ定義受付が配備されます。

csccompodeploy -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -name <ユーザ定義受付の受付ID>

3.1.15　ユーザ定義受付の定義情報を設定する

ユーザ定義受付で定義情報を設定するための前提条件および設定方法について説明します。

(1)　前提条件

ユーザ定義受付の定義情報を設定するには，次のすべての条件を満たしている必要があります。

HCSCサーバが起動状態であること

ユーザ定義受付が配備状態であること

SOAP受付以外の場合，サービスが停止していること

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

(2)　設定方法

設定方法はSOAP受付とそれ以外のユーザ定義受付で次のように異なります。

(a)　SOAP受付の場合

ユーザ定義受付のうちSOAP受付では，次に示す定義情報を設定できます。

最大同時実行数

占有スレッド数

実行待ちキューのサイズ

注意事項

ユーザ定義受付，およびユーザ定義受付を利用するビジネスプロセスを削除した場合，ここで設定した定義情報は無効となります。削除後に，ユーザ定義受付およびユーザ定義受付を利用するビジネスプロセスを再配備する場合，必ずユーザ定義受付の定義情報を設定し直してください。

SOAP受付の定義情報を設定するには，まずユーザ定義受付ランタイム定義ファイルを作成します。ユーザ定義受付ランタイム定義ファイルのテンプレートファイルは，cscurcptnconfig.propertiesのファイル名で次のディレクトリに格納されています。

<サービスプラットフォームのインストールディレクトリ>¥CSC¥config¥manager¥templates¥cscurcptnconfig.properties

テンプレートファイルを任意の場所にコピーしたあと，定義情報を編集して，ユーザ定義受付ランタイム定義ファイルを作成します。ユーザ定義受付ランタイム定義ファイルの詳細については，マニュアル「サービスプラットフォームリファレンス」の「6.6.2　ユーザ定義受付ランタイム定義ファイル」を参照してください。

ユーザ定義受付ランタイム定義ファイルを作成したら，運用環境でcsccompoconfigコマンドを実行して定義情報を設定します。設定した定義情報は，HCSCコンポーネントを再開始したときに反映されます。csccompoconfigコマンドの詳細については，マニュアル「サービスプラットフォームリファレンス」の「csccompoconfig（HCSCコンポーネントの定義）」を参照してください。

HCSCサーバに配備されているSOAP受付に定義情報を設定するか，クラスタ内のHCSCサーバに配備されているSOAP受付に定義情報を設定するかによって実行形式が異なります。

HCSCサーバに配備されているSOAP受付に定義情報を設定する場合

HCSCサーバ名，およびSOAP受付の受付IDを指定して実行します。

指定したHCSCサーバ上のSOAP受付に，ユーザ定義受付ランタイム定義ファイルで指定した定義情報が設定されます。

csccompoconfig -user <ログインユーザID> -pass <ログインパスワード> -operation set -propfile <ユーザ定義受付ランタイム定義ファイル> -csc <HCSCサーバ名> -name <受付ID>

クラスタ内のHCSCサーバに配備されているSOAP受付に定義情報を設定する場合

クラスタ名，およびSOAP受付の受付IDを指定して実行します。

指定したクラスタに配備されているSOAP受付に，ユーザ定義受付ランタイム定義ファイルで指定した定義情報が設定されます。

csccompoconfig -user <ログインユーザID> -pass <ログインパスワード> -operation set -propfile <ユーザ定義受付ランタイム定義ファイル> -cluster <クラスタ名> -name <受付ID>

(b)　SOAP受付以外の場合

SOAP受付以外のユーザ定義受付を設定するには，アプリケーション統合属性ファイルの定義情報を設定します。設定するには，運用環境でcsccompoconfigコマンドを実行します。

アプリケーション統合属性ファイルの定義情報を設定する場合の実行形式を次に示します。

csccompoconfig -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -name <ユーザ定義受付の受付ID> -operation set -propfile <アプリケーション統合属性ファイル>

詳細は，マニュアル「サービスプラットフォーム リファレンス」の「csccompoconfig（HCSCコンポーネントの定義）」を参照してください。

3.1.16　ユーザ定義受付の定義情報を確認する

ユーザ定義受付の定義情報を確認する前提条件，および確認方法について次に説明します。

(1)　前提条件

ユーザ定義受付の定義情報を確認するには，HCSCサーバが起動状態である必要があります。

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

(2)　確認方法

設定したユーザ定義受付の定義情報を確認するには，運用環境で-operationオプションにgetを，-cscオプションにHCSCサーバ名を，-nameにユーザ定義受付の受付IDを指定して，csccompoconfigコマンドを実行します。

csccompoconfigコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「csccompoconfig（HCSCコンポーネントの定義）」を参照してください。

csccompoconfigコマンドの実行形式を次に示します。

csccompoconfig -user <ログインユーザID> -pass <ログインパスワード> -operation get -csc <HCSCサーバ名> -name <受付ID>

3.1.17　セットアップ後の内容を確認・変更する

HCSCサーバ，サービスアダプタ，ビジネスプロセスおよびユーザ定義受付のセットアップ後の内容を確認する方法については，次の個所を参照してください。

HCSCサーバのセットアップ情報を確認する場合

「5.3.15　HCSCサーバのセットアップ情報を確認する」および「5.3.16　HCSCサーバの情報を確認する」を参照してください。

サービスアダプタの配備情報を確認する場合

「5.3.19　サービスアダプタの情報を確認する」を参照してください。

ビジネスプロセスの配備情報を確認する場合

「5.3.20　ビジネスプロセスの情報を確認する」を参照してください。

ユーザ定義受付の配備情報を確認する場合

「5.3.21　ユーザ定義受付の情報を確認する」を参照してください。

セットアップ情報を確認した結果，すでにセットアップした内容を変更したい場合は，一度アンセットアップしてから再度セットアップします。アンセットアップの方法については，「3.3　システムのアンセットアップ」を参照してください。

注意事項

HCSCサーバのセットアップ情報を追加・変更する場合，アンセットアップしないで追加・変更できる内容があります。HCSCサーバの追加・変更セットアップの詳細については，「3.1.3(3)　セットアップ情報の追加・変更」を参照してください。

3.2　システムのセットアップ（FTP連携する場合）

FTP連携する場合のシステムのセットアップの流れ，および手順について説明します。

3.2.1　FTP連携システムのセットアップの流れ

FTP連携システムのセットアップの流れを次に示します。

図3‒10　FTP連携システムのセットアップの流れ

3.2.2　共通フォルダおよび作業フォルダを設定する

FTP連携システムを使用するには，HCSCサーバランタイム定義ファイルに共通フォルダおよび作業フォルダのパスを設定する必要があります。

HCSCサーバランタイム定義ファイルに設定するプロパティについては，マニュアル「サービスプラットフォーム リファレンス」の「6.5.6　HCSCサーバランタイム定義ファイル」を参照してください。

HCSCサーバランタイム定義ファイルをクラスタ内のHCSCサーバに設定する場合の実行形式を次に示します。

cscsvconfig -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -operation set -propfile <HCSCサーバランタイム定義ファイル名>

cscsvconfigコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscsvconfig（HCSCサーバランタイムの定義）」を参照してください。

3.2.3　FTPインバウンドアダプタをセットアップする

FTPインバウンドアダプタをセットアップするには，HCSCサーバが起動している必要があります。

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

FTPインバウンドアダプタのセットアップの流れを次に示します。

図3‒11　FTPインバウンドアダプタのセットアップの流れ

(1)　FTPインバウンドアダプタのインポート

FTPインバウンドアダプタをインポートする場合の実行形式を次に示します。

<サービスプラットフォームのインストールディレクトリ>¥CC¥admin¥bin¥cjimportres <J2EEサーバ名> -type rar -f "<サービスプラットフォームのインストールディレクトリ>¥CSC¥inbound-adapter¥ftp¥rar¥ftp_inbound_adapter.rar"

cjimportresコマンドの詳細は，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「2.4　J2EEサーバで使用するリソース操作コマンド」を参照してください。

(2)　FTPインバウンドアダプタのデプロイ

FTPインバウンドアダプタをデプロイする場合の実行形式を次に示します。

<サービスプラットフォームのインストールディレクトリ>¥CC¥admin¥bin¥cjdeployrar <J2EEサーバ名> -resname FTP_Inbound_Resource_Adapter

cjdeployrarコマンドの詳細は，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「2.4　J2EEサーバで使用するリソース操作コマンド」を参照してください。

(3)　FTPインバウンドアダプタの設定

FTPインバウンドアダプタを設定する手順，およびプロパティファイルの内容を次に示します。

参考

初期状態の設定のままでFTP連携システムを運用する場合，ここでの設定は省略できます。

(a)　設定手順

FTPインバウンドアダプタのRARファイルから属性を取得して，属性ファイルを作成します。

FTPインバウンドアダプタのRARファイルから属性ファイルを作成する場合の実行形式を次に示します。

<サービスプラットフォームのインストールディレクトリ>¥CC¥admin¥bin¥cjgetrarprop <J2EEサーバ名> -resname FTP_Inbound_Resource_Adapter -c <属性ファイルのファイルパス>

cjgetrarpropコマンドの詳細は，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「2.4　J2EEサーバで使用するリソース操作コマンド」を参照してください。

属性ファイルを編集します。

属性ファイルの詳細は，「(b)　プロパティの内容」を参照してください。

定義項目を編集した属性ファイルに指定された値を，FTPインバウンドアダプタのRARファイルへ反映します。

属性ファイルをFTPインバウンドアダプタへ反映する場合の実行形式を次に示します。

<サービスプラットフォームのインストールディレクトリ>¥CC¥admin¥bin¥cjsetrarprop <J2EEサーバ名> -resname FTP_Inbound_Resource_Adapter -c <属性ファイルのファイルパス>

cjsetrarpropコマンドの詳細は，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「2.4　J2EEサーバで使用するリソース操作コマンド」を参照してください。

(b)　プロパティの内容

属性ファイルの定義

属性ファイルにある定義のタグを次に示します。

<hitachi-connector-property>
    <display-name>FTP_Inbound_Resource_Adapter</display-name>
                    ：
    <resourceadapter>
        <config-property>
            <config-property-name>   ：定義の名称
            <config-property-type>   ：定義の型
            <config-property-value>  ：定義の値
        </config-property>
        <config-property>
            <config-property-name>   ：定義の名称
            <config-property-type>   ：定義の型
            <config-property-value>  ：定義の値
        </config-property>
                    ：
      （以降，定義の数分，繰り返される）
                    :

定義を編集する場合は，編集する「定義の名称」を検索して，対応する「定義の値」を書き替えます。編集できる項目については，「属性ファイルの定義項目」を参照してください。

属性ファイルを編集する際の注意事項を次に示します。

「定義項目」に示している定義項目の値だけを書き替えてください。ほかの項目や値を変更しないでください。

属性ファイルの内容を，アプリケーション属性ファイル（cosminexus.xml）には記載しないでください。

属性ファイル内にある<display-name>タグのリソースアダプタの名称を変更しないでください。

ログ出力に関する設定で，各ログのログファイル1面当たりのファイルサイズ，およびログファイルのバックアップファイルの面数を変更した場合は，FTPインバウンドアダプタを起動する前に，ログファイルをバックアップしておいてください。

属性ファイルの定義個所

属性ファイルの定義個所を次の図に示します。

図3‒12　属性ファイルの内容および定義の設定個所

属性ファイルの定義項目

属性ファイルの定義項目のうち編集できる項目を次に示します。

転送制御に関する設定

タイムアウトに関する設定

ログ出力に関する設定

FTPSに関する設定

FTPSに関する設定項目については，マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「付録H.3　セットアップ時の属性ファイルの定義項目（FTPインバウンドアダプタ）」を参照してください。

以降の表に設定内容を示します。

表3‒26　属性ファイルの定義項目一覧（転送制御に関する設定）

定義項目

定義の名称

値の範囲

デフォルト値

補足

最大同時接続数

server_maxLogins

1〜1024

10

−

文字セットUTF-8の使用

server_charset_UTF8

ONまたはOFF

ON

ON

文字コードにUTF-8を使用します。

OFF

文字コードにMS932を使用します。

なお，FTPコマンドで文字セットを指定した場合は，その設定が有効になります。

FTPレスポンスの終端文字の互換性

server_endOfLineCompatible

trueまたはfalse

false

（CRLFが標準の終端コードとなります）

true

FTPレスポンスの終端文字にOS依存の改行コード（Windowsの場合：CRLF，UNIXの場合：LF）を使用します。

false

FTPレスポンスの終端文字にCRLFを使用します。

ローカルIPアドレス

nioListener_localAddress

0.0.0.0〜255.255.255.255

0:0:0:0:0:0:0:0〜FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF

All available

（FTPインバウンドアダプタを実行するホストにIPアドレスが複数ある場合，すべてのIPアドレスでFTPクライアントからの要求を受け付けます）

−

ポート番号

nioListener_port

1〜65535

21

−

データコネクション確立時のローカルIPアドレス

nioListener_dataConnection_active_localAddress

0.0.0.0〜255.255.255.255

0:0:0:0:0:0:0:0〜FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF

Any available

（FTPインバウンドアダプタを実行するホストにIPアドレスが複数ある場合，同一セッション内で使用している制御コネクションと同じIPアドレスが割り当てられます）

PASVモードの場合はこのプロパティの設定にかかわらず，同一セッション内で使用している制御コネクションと同じIPアドレスがデータコネクションに割り当てられます。

データコネクション確立時のポート番号

nioListener_dataConnection_active_localPort

1〜65535

Any available

（FTPインバウンドアダプタを実行するホストで空いているポート番号が割り当てられます）

すでに使用されているポート番号は指定しないでください。指定した場合はデータコネクションの確立に失敗します。

Listenバックログ数

nioListener_listenBacklog

1〜2147483647

50

−

データコネクションのバッファサイズ

nioListener_dataConnection_socketBufferSize

1〜65536

16384

（単位：バイト）

（凡例）

−：特にありません。

表3‒27　属性ファイルの定義項目一覧（タイムアウトに関する設定）

定義項目

定義の名称

値の範囲

デフォルト値

補足

アイドルタイムアウト

nioListener_idleTimeout

0〜7200

300

0を指定した場合はタイムアウト監視をしません。

（単位：秒）

データコネクション接続のリトライ回数

nioListener_dataConnection_active_connectRetryCount

0〜50

5

0を指定した場合はリトライしません。

データコネクション接続の監視時間

nioListener_dataConnection_active_connectRetryInterval

0〜1800

10

0を指定した場合はタイムアウト監視をしません。

（単位：秒）

データ送信およびデータ受信のタイムアウト

nioListener_dataConnection_idleTimeout

0〜1800

10

0を指定した場合はタイムアウト監視をしません。

（単位：秒）

表3‒28　属性ファイルの定義項目一覧（ログ出力に関する設定）

分類

定義項目

定義の名称

値の範囲

デフォルト値

補足

メッセージログ

ログ出力レベル

server_message_logLevel

info，またはdebug

info

info

通常の運用時に使用し，運用時に必要な情報を出力します。

debug

テストや障害が発生した場合の調査時に使用し，infoの情報に加えて，デバッグ用の情報を出力します。

ログファイル1面当たりのファイルサイズ

server_message_maxFileSize

1MB〜2048MB

10MB

単位の文字列も指定してください。

（単位：MB）

ログファイルのバックアップファイルの面数

server_message_maxBackupIndex

1〜16

4

−

保守用ログ

ログ出力レベル

server_maintenance_logLevel

info，またはdebug

info

「info」および「debug」の意味は，メッセージログの「ログ出力レベル」と同じです。

ログファイル1面当たりのファイルサイズ

server_maintenance_maxFileSize

1MB〜2048MB

5MB

単位の文字列も指定してください。

（単位：MB）

ログファイルのバックアップファイルの面数

server_maintenance_maxBackupIndex

1〜16

4

−

プロトコルトレースログ

ログ出力レベル

server_protocol_logLevel

info，またはdebug

info

「info」および「debug」の意味は，メッセージログの「ログ出力レベル」と同じです。

ログファイル1面当たりのファイルサイズ

server_protocol_maxFileSize

1MB〜2048MB

20MB

単位の文字列も指定してください。

（単位：MB）

ログファイルのバックアップファイルの面数

server_protocol_maxBackupIndex

1〜16

4

−

転送履歴ログ

ログ出力レベル

server_history_logLevel

info，またはdebug

info

「info」および「debug」の意味は，メッセージログの「ログ出力レベル」と同じです。

ログファイル1面当たりのファイルサイズ

server_history_maxFileSize

1MB〜2048MB

12MB

単位の文字列も指定してください。

（単位：MB）

ログファイルのバックアップファイルの面数

server_history_maxBackupIndex

1

1

−

リソースアダプタ間共通ログ

ログ出力レベル

server_common_logLevel

info，またはdebug

info

「info」および「debug」の意味は，メッセージログの「ログ出力レベル」と同じです。

ログファイル1面当たりのファイルサイズ

server_common_maxFileSize

1MB〜2048MB

5MB

単位の文字列も指定してください。

（単位：MB）

ログファイルのバックアップファイルの面数

server_common_maxBackupIndex

1〜16

4

−

（凡例）

−：特にありません。

(4)　ユーザ情報の設定

ユーザ情報は，FTPインバウンドアダプタによって，ファイルとして管理されます。認証情報のファイルは，管理者権限を持っている管理者が運用コマンドを実行することによって，登録，更新，削除，および表示できます。

(a)　認証情報の運用コマンド

認証情報の運用コマンドを次の表に示します。

表3‒29　認証情報の運用コマンド

運用コマンド

内容

csmftpaddusr（FTPインバウンドアダプタのユーザの登録・更新コマンド）

ユーザを新規に登録します。また，すでに登録されているユーザのパスワードを更新します。

csmftpdelusr（FTPインバウンドアダプタのユーザの削除コマンド）

登録されているユーザの認証情報を削除します。

csmftplsusr（FTPインバウンドアダプタのユーザの表示コマンド）

登録されているユーザの認証情報を表示します。

運用コマンドの詳細は，マニュアル「サービスプラットフォーム リファレンス」の「5.　コマンド（運用環境・実行環境）」の説明を参照してください。

運用コマンドを実行するときの注意事項を次に示します。

FTPインバウンドアダプタが停止している状態で，運用コマンドを実行してください。

運用コマンドの実行中に，別の運用コマンドは実行できません。先に実行した運用コマンドが終了してから，別の運用コマンドを実行してください。

運用コマンドの実行形式を次に示します。

FTPインバウンドアダプタのユーザの登録・更新

FTPインバウンドアダプタのユーザを登録および更新する場合の実行形式を次に示します。

csmftpaddusr -usr <ユーザ名> -pass <ユーザのパスワード>

なお，ユーザ情報がユーザ情報指定ファイルに定義してある場合は，次のコマンドでユーザを登録および更新できます。

csmftpaddusr -userinfofile <ユーザ情報指定ファイルのパス>

詳細は，マニュアル「サービスプラットフォーム リファレンス」の「csmftpaddusr（FTPインバウンドアダプタのユーザの登録・更新）」を参照してください。

FTPインバウンドアダプタのユーザの削除

FTPインバウンドアダプタのユーザを削除する場合の実行形式を次に示します。

csmftpdelusr -usr <ユーザ名>

詳細は，マニュアル「サービスプラットフォーム リファレンス」の「csmftpdelusr（FTPインバウンドアダプタのユーザの削除）」を参照してください。

FTPインバウンドアダプタのユーザの表示

FTPインバウンドアダプタのユーザを表示する場合の実行形式を次に示します。

csmftplsusr

詳細は，マニュアル「サービスプラットフォーム リファレンス」の「csmftplsusr（FTPインバウンドアダプタのユーザの表示）」を参照してください。

(b)　認証情報へのアクセス制限

認証情報にアクセス制限をするには，運用者が運用開始前に，認証情報のファイルに対して，運用コマンドを実行する管理者だけに更新・参照のアクセス権を設定する必要があります。

なお，管理者にアクセス権を設定すると，認証情報のファイルの所有者は管理者となります。

3.2.4　FTP受付，FTPアダプタおよびファイル操作アダプタの定義ファイルを配置する

FTP受付，FTPアダプタおよびファイル操作アダプタの各種定義ファイルの格納先を次の表に示します。

表3‒30　FTP受付，FTPアダプタおよびファイル操作アダプタの各種定義ファイルの格納先

定義利用コンポーネント

定義ファイル名

格納先

FTP受付

FTP受付コンフィグファイル

<サービスプラットフォームのインストールディレクトリ>¥CSC¥config¥ftprecp¥<サービスID>.properties

FTP実行許可リスト定義ファイル

任意※1

リストコマンドオプション定義ファイル

任意※1

FTPコマンド許可リスト定義ファイル（FTP受付用）

任意※1

FTPアダプタ

FTPコマンド許可リスト定義ファイル（FTPアダプタ用）

任意※2

FTPアダプタ実行環境プロパティファイル

全HCSCサーバ共通の定義の場合

<サービスプラットフォームのインストールディレクトリ>¥CSC¥custom-adapter¥FTP¥config¥<サービスID>.properties

特定のHCSCサーバ用の定義の場合

<サービスプラットフォームのインストールディレクトリ>¥CSC¥custom-adapter¥FTP¥config¥<HCSCサーバ名>¥<サービスID>.properties

FTPアダプタアカウント定義ファイル

任意※2

ファイル操作アダプタ

ファイル操作アダプタ実行環境プロパティファイル

<サービスプラットフォームのインストールディレクトリ>¥CSC¥config¥adpfop¥<サービスID>.properties

注※1

FTP受付コンフィグファイルから参照されます。

注※2

FTPアダプタ実行環境プロパティファイルから参照されます。

3.2.5　リポジトリをインポートする

開発環境で作成したFTP受付を運用環境で使用する場合，ZIPファイル形式で保存されたリポジトリ情報をリポジトリにインポートします。

リポジトリ情報をリポジトリにインポートするには，cscrepctlコマンドを実行します。

リポジトリ情報をリポジトリにインポートする場合の実行形式を次に示します。

cscrepctl -user <ログインユーザID> -pass <ログインパスワード> -import <ファイル名>

詳細は，マニュアル「サービスプラットフォーム リファレンス」の「cscrepctl（インポート/エクスポート）」を参照してください。

3.2.6　FTP受付定義ファイルを取得する

開発環境で設定したFTP受付定義ファイルを取得するときの前提条件，および取得方法について説明します。

(1)　前提条件

FTP受付定義ファイルを取得するには，HCSCサーバが起動状態である必要があります。

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

(2)　取得方法

開発環境で設定したFTP受付定義ファイルを取得するには，運用環境でcsccmctlコマンドを実行します。

FTP受付定義ファイルを取得する場合の実行形式を次に示します。

csccmctl -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -name <FTP受付の受付ID> -targetfilename cscurecpftp.properties -basedir <cscurecpftp.propertiesが格納されたディレクトリのファイルパス> -operation get

詳細は，マニュアル「サービスプラットフォーム リファレンス」の「csccmctl（定義ファイルの管理）」を参照してください。

3.2.7　FTP受付定義ファイルの定義情報を設定する

取得したFTP受付定義ファイルの定義情報を運用環境に設定するときの前提条件，および設定方法について説明します。

(1)　前提条件

FTP受付定義ファイルの定義情報を設定するには，次の条件を満たしている必要があります。

HCSCサーバが起動状態であること

FTP受付定義ファイルの定義情報を設定するコマンドを実行する際は，HCSCコンポーネントの配備前であること

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

(2)　設定方法

FTP受付定義ファイルの定義情報を設定するには，運用環境でcsccmctlコマンドを実行します。

FTP受付定義ファイルの定義情報を設定する場合の実行形式を次に示します。

csccmctl -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -name <FTP受付の受付ID> -targetfilename cscurecpftp.properties -basedir <cscurecpftp.propertiesが格納されたディレクトリのファイルパス> -operation set

詳細は，マニュアル「サービスプラットフォーム リファレンス」の「csccmctl（定義ファイルの管理）」を参照してください。

3.2.8　HCSCコンポーネントを配備する

HCSCコンポーネントを実行環境に配備するときの前提条件，および配備方法について説明します。

(1)　前提条件

HCSCコンポーネントをセットアップ済みのHCSCサーバに配備するには，配備先の実行環境のHCSCサーバが起動状態である必要があります。

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

(2)　配備方法

HCSCコンポーネントをセットアップ済みのHCSCサーバに配備するには，運用環境でcsccompodeployコマンドを実行します。

HCSCコンポーネントを配備する場合の実行形式を次に示します。

csccompodeploy -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -all

詳細については，マニュアル「サービスプラットフォーム リファレンス」の「csccompodeploy（HCSCコンポーネントの配備）」を参照してください。

3.2.9　FTP受付のアプリケーション統合属性ファイルを取得する

FTP受付のアプリケーション統合属性ファイルを取得するときの前提条件，および取得方法について説明します。

(1)　前提条件

FTP受付のアプリケーション統合属性ファイルを取得するには，HCSCサーバが起動状態である必要があります。

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

(2)　取得方法

FTP受付のアプリケーション統合属性ファイルを取得するには，運用環境でcsccompoconfigコマンドを実行します。

FTP受付のアプリケーション統合属性ファイルを取得する場合の実行形式を次に示します。

csccompoconfig -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -name <FTP受付の受付ID> -operation get -csc <HCSCサーバ名>

詳細は，マニュアル「サービスプラットフォーム リファレンス」の「csccompoconfig（HCSCコンポーネントの定義）」を参照してください。

3.2.10　FTP受付のアプリケーション統合属性ファイルの定義情報を設定する

FTP受付のアプリケーション統合属性ファイルの定義情報を設定するための前提条件，および設定方法について説明します。

(1)　前提条件

FTP受付のアプリケーション統合属性ファイルの定義情報を設定するには，HCSCサーバが起動状態，かつFTP受付の状態が配備状態である必要があります。ただし，FTP受付が起動している場合はエラーとなります。

また，次の条件に当てはまる場合は，アプリケーション統合属性ファイルで設定した最大インスタンス数と，FTP受付コンフィグファイルに設定するFTP受付のタイムアウトの監視で利用する最大スレッド数を同じ値にする必要があります。

FTP受付にタイムアウト値を設定する

csccompoconfigコマンドで最大インスタンス数を変更する

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

(2)　設定方法

FTP受付のアプリケーション統合属性ファイルの定義情報を設定するには，運用環境でcsccompoconfigコマンドを実行します。

FTP受付のアプリケーション統合属性ファイルの定義情報を設定する場合の実行形式を次に示します。

csccompoconfig -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -name <FTP受付の受付ID> -operation set -propfile <アプリケーション統合属性ファイル>

詳細は，マニュアル「サービスプラットフォーム リファレンス」の「csccompoconfig（HCSCコンポーネントの定義）」を参照してください。

3.3　システムのアンセットアップ

サービスプラットフォームを利用して，すでにセットアップされているシステムをアンセットアップする方法について説明します。

3.3.1　サービスアダプタを削除する

実行環境に配備されているサービスアダプタを削除する場合の前提条件，および削除方法について次に説明します。

なお，HCSCコンポーネントを停止してHCSCサーバから削除する一連の処理を，開発環境で一括して実行することもできます。ただし，一括実行は，システム開発時，または単体テストから結合テスト時を対象としています。詳細については，マニュアル「サービスプラットフォーム開発ガイド 基本開発編」の「8.6　HCSCコンポーネントを停止してHCSCサーバから削除する処理の一括実行」を参照してください。

(1)　前提条件

サービスアダプタを削除するには，次の条件を満たす必要があります。

HCSCサーバが起動状態であること

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

サービスアダプタが停止状態であること

サービスアダプタの状態の確認方法については，「5.3.19　サービスアダプタの情報を確認する」を参照してください。

(2)　削除方法

サービスアダプタを削除するには，運用環境でcsccompoundeployコマンドを実行します。

csccompoundeployコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「csccompoundeploy（配備済みのHCSCコンポーネントの削除）」を参照してください。

すべてのサービスアダプタを一括して削除するか，指定したサービスアダプタだけを削除するかによって実行形式が異なります。

注意事項

サービスアダプタが削除できなかった場合，エラーになった原因を取り除いたあと，再度削除してください。

(a)　すべてのサービスアダプタを一括して削除する場合

HCSCサーバまたはクラスタのすべてのサービスアダプタを一括して削除します。

単一のHCSCサーバからサービスアダプタを削除するか，クラスタを構成するすべてのHCSCサーバからサービスアダプタを削除するかによって実行形式が異なります。

単一のHCSCサーバからすべてのサービスアダプタを削除する場合

HCSCサーバ名と-allオプションを指定して実行します。

-cscオプションで指定したHCSCサーバに配備されているサービスアダプタがすべて削除されます（削除されていないビジネスプロセスおよびユーザ定義受付も同時にすべて削除されます）。

csccompoundeploy -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -all

クラスタを構成するすべてのHCSCサーバからすべてのサービスアダプタを削除する場合

クラスタ名と-allオプションを指定して実行します。

-clusterオプションで指定したクラスタ内のすべてのHCSCサーバに配備されているサービスアダプタがすべて削除されます（削除されていないビジネスプロセスおよびユーザ定義受付も同時にすべて削除されます）。

csccompoundeploy -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -all

(b)　指定したサービスアダプタだけを削除する場合

HCSCサーバまたはクラスタに配備されているサービスアダプタのうち，指定したサービスアダプタだけを削除します。

単一のHCSCサーバからサービスアダプタを削除するか，クラスタを構成するすべてのHCSCサーバからサービスアダプタを削除するかによって実行形式が異なります。

単一のHCSCサーバから指定したサービスアダプタだけを削除する場合

HCSCサーバ名とサービスアダプタのサービスIDを指定して実行します。

-cscオプションで指定したHCSCサーバに配備されているサービスアダプタのうち，-nameオプションで指定したサービスアダプタが削除されます。

csccompoundeploy -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -name <サービスアダプタのサービスID>

クラスタを構成するすべてのHCSCサーバから指定したサービスアダプタだけを削除する場合

クラスタ名とサービスアダプタのサービスIDを指定して実行します。

-clusterオプションで指定したクラスタ内のすべてのHCSCサーバに配備されているサービスアダプタのうち，指定したサービスアダプタだけが削除されます。

csccompoundeploy -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -name <サービスアダプタのサービスID>

注意事項

仕掛かり中のリクエストがある場合，サービスアダプタは削除されません。

仕掛かり中のリクエストを破棄して，サービスアダプタを強制的に削除する場合，-forceオプションを指定してcsccompoundeployコマンドを実行します。

強制的に削除する場合の例を次に示します。

HCSCサーバ「HCSC」のすべてのサービスアダプタを強制的に削除する場合

csccompoundeploy -user admin -pass admin -csc HCSC -all -force

HCSCサーバ「HCSC」のサービスアダプタ「Adapter1」を強制的に削除する場合

csccompoundeploy -user admin -pass admin -csc HCSC -name Adapter1 -force

3.3.2　ビジネスプロセスを削除する

実行環境に配備されているビジネスプロセスを削除する場合の前提条件，および削除方法について次に説明します。

なお，HCSCコンポーネントを停止してHCSCサーバから削除する一連の処理を，開発環境で一括して実行することもできます。ただし，一括実行は，システム開発時，または単体テストから結合テスト時を対象としています。詳細については，マニュアル「サービスプラットフォーム開発ガイド 基本開発編」の「8.6　HCSCコンポーネントを停止してHCSCサーバから削除する処理の一括実行」を参照してください。

(1)　前提条件

ビジネスプロセスを削除するには，次の条件を満たす必要があります。

HCSCサーバが起動状態であること

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

ビジネスプロセスが停止状態であること

ビジネスプロセスの状態の確認方法については，「5.3.20　ビジネスプロセスの情報を確認する」を参照してください。

(2)　削除方法

ビジネスプロセスを削除するには，運用環境でcsccompoundeployコマンドを実行します。

csccompoundeployコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「csccompoundeploy（配備済みのHCSCコンポーネントの削除）」を参照してください。

すべてのビジネスプロセスを一括して削除するか，指定したビジネスプロセスだけを削除するかによって実行形式が異なります。

注意事項

ビジネスプロセスが削除できなかった場合，エラーになった原因を取り除いたあと，再度削除してください。

(a)　すべてのビジネスプロセスを一括して削除する場合

HCSCサーバまたはクラスタのすべてのビジネスプロセスを一括して削除します。

単一のHCSCサーバからビジネスプロセスを削除するか，クラスタを構成するすべてのHCSCサーバからビジネスプロセスを削除するかによって実行形式が異なります。

単一のHCSCサーバからすべてのビジネスプロセスを削除する場合

HCSCサーバ名と-allオプションを指定して実行します。

-cscオプションで指定したHCSCサーバ配備されているビジネスプロセスがすべて削除されます（削除されていないサービスアダプタおよびユーザ定義受付も同時にすべて削除されます）。

csccompoundeploy -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -all

クラスタを構成するすべてのHCSCサーバからすべてのビジネスプロセスを削除する場合

クラスタ名と-allオプションを指定して実行します。

-clusterオプションで指定したクラスタ内のすべてのHCSCサーバに配備されているビジネスプロセスがすべて削除されます（削除されていないサービスアダプタおよびユーザ定義受付も同時にすべて削除されます）。

csccompoundeploy -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -all

(b)　指定したビジネスプロセスだけを削除する場合

HCSCサーバまたはクラスタに配備されているビジネスプロセスのうち，指定したビジネスプロセスだけを削除します。

単一のHCSCサーバからビジネスプロセスを削除するか，クラスタを構成するすべてのHCSCサーバからビジネスプロセスを削除するかによって実行形式が異なります。

単一のHCSCサーバから指定したビジネスプロセスだけを削除する場合

HCSCサーバ名とビジネスプロセスのサービスIDを指定して実行します。

-cscオプションで指定したHCSCサーバに配備されているビジネスプロセスのうち，-nameオプションで指定したビジネスプロセスが削除されます。

csccompoundeploy -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -name <ビジネスプロセスのサービスID>

クラスタを構成するすべてのHCSCサーバから指定したビジネスプロセスだけを削除する場合

クラスタ名とビジネスプロセスのサービスIDを指定して実行します。

-clusterオプションで指定したクラスタ内のすべてのHCSCサーバに配備されているビジネスプロセスのうち，指定したビジネスプロセスだけが削除されます。

csccompoundeploy -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -name <ビジネスプロセスのサービスID>

3.3.3　ユーザ定義受付を削除する

実行環境に配備されているユーザ定義受付を削除する場合の前提条件，および削除方法について次に説明します。

なお，HCSCコンポーネントを停止してHCSCサーバから削除する一連の処理を，開発環境で一括して実行することもできます。ただし，一括実行は，システム開発時，または単体テストから結合テスト時を対象としています。詳細については，マニュアル「サービスプラットフォーム開発ガイド 基本開発編」の「8.6　HCSCコンポーネントを停止してHCSCサーバから削除する処理の一括実行」を参照してください。

(1)　前提条件

ユーザ定義受付を削除するには，次の条件を満たす必要があります。

HCSCサーバが起動状態であること

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

ユーザ定義受付が停止状態であること

ユーザ定義受付の状態の確認方法については，「5.3.21　ユーザ定義受付の情報を確認する」を参照してください。

(2)　削除方法

ユーザ定義受付を削除するには，運用環境でcsccompoundeployコマンドを実行します。

csccompoundeployコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「csccompoundeploy（配備済みのHCSCコンポーネントの削除）」を参照してください。

すべてのユーザ定義受付を一括して削除するか，指定したユーザ定義受付だけを削除するかによって実行形式が異なります。

注意事項

ユーザ定義受付が削除できなかった場合，エラーになった原因を取り除いたあと，再度削除してください。

(a)　すべてのユーザ定義受付を一括して削除する場合

HCSCサーバまたはクラスタのすべてのユーザ定義受付を一括して削除します。

単一のHCSCサーバからユーザ定義受付を削除するか，クラスタを構成するすべてのHCSCサーバからユーザ定義受付を削除するかによって実行形式が異なります。

単一のHCSCサーバからすべてのユーザ定義受付を削除する場合

HCSCサーバ名と-allオプションを指定して実行します。

-cscオプションで指定したHCSCサーバに配備されているユーザ定義受付がすべて削除されます（削除されていないサービスアダプタおよびビジネスプロセスも同時にすべて削除されます）。

csccompoundeploy -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -all

クラスタを構成するすべてのHCSCサーバからすべてのユーザ定義受付を削除する場合

クラスタ名と-allオプションを指定して実行します。

-clusterオプションで指定したクラスタ内のすべてのHCSCサーバに配備されているユーザ定義受付がすべて削除されます（削除されていないサービスアダプタおよびビジネスプロセスも同時にすべて削除されます）。

csccompoundeploy -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -all

(b)　指定したユーザ定義受付だけを削除する場合

HCSCサーバまたはクラスタに配備されているユーザ定義受付のうち，指定したユーザ定義受付だけを削除します。

単一のHCSCサーバからユーザ定義受付を削除するか，クラスタを構成するすべてのHCSCサーバからユーザ定義受付を削除するかによって実行形式が異なります。

単一のHCSCサーバから指定したユーザ定義受付だけを削除する場合

HCSCサーバ名とユーザ定義受付の受付IDを指定して実行します。

-cscオプションで指定したHCSCサーバに配備されているユーザ定義受付のうち，-nameオプションで指定したユーザ定義受付が削除されます。

csccompoundeploy -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -name <ユーザ定義受付の受付ID>

クラスタを構成するすべてのHCSCサーバから指定したユーザ定義受付だけを削除する場合

クラスタ名とユーザ定義受付の受付IDを指定して実行します。

-clusterオプションで指定したクラスタ内のすべてのHCSCサーバに配備されているユーザ定義受付のうち，指定したユーザ定義受付だけが削除されます。

csccompoundeploy -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -name <ユーザ定義受付の受付ID>

3.3.4　FTP連携システムをアンセットアップする

FTP連携システムを使用している場合の，FTP連携システムのアンセットアップ方法について説明します。

(1)　サービスアダプタを削除する

実行環境に配備されている，FTPアダプタおよびファイル操作アダプタを含むサービスアダプタの削除方法については，「3.3.1　サービスアダプタを削除する」を参照してください。

(2)　ビジネスプロセスを削除する

実行環境に配備されているビジネスプロセスの削除方法については，「3.3.2　ビジネスプロセスを削除する」を参照してください。

(3)　ユーザ定義受付を削除する

実行環境に配備されている，FTP受付を含むユーザ定義受付の削除方法については，「3.3.3　ユーザ定義受付を削除する」を参照してください。

(4)　FTPインバウンドアダプタを削除する

FTPインバウンドアダプタを削除する場合の前提条件，および削除方法について次に説明します。

(a)　前提条件

FTPインバウンドアダプタを削除するには，次の条件を満たす必要があります。

HCSCサーバが起動状態であること

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

FTPインバウンドアダプタが停止状態であること

FTPインバウンドアダプタの状態の確認方法については，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「4.5　リソースアダプタの一覧の参照」を参照してください。

(b)　削除方法

次の作業を実施します。

●FTPインバウンドアダプタの設定の解除

FTPインバウンドアダプタに登録されているすべてのユーザ情報（ユーザ名およびパスワード）を削除する場合の実行形式を次に示します。

<サービスプラットフォームのインストールディレクトリ>¥CSC¥bin¥csmftpdelusr -usr <ユーザ名>

コマンドの詳細は，マニュアル「サービスプラットフォーム リファレンス」の「csmftpdelusr（FTPインバウンドアダプタのユーザの削除）」を参照してください。

注意事項

環境変数（CSCFTP_CMD_LOG）に運用コマンド実行時のログ出力先ディレクトリを設定している場合は，設定を解除してください。

●FTPインバウンドアダプタのアンデプロイ

FTPインバウンドアダプタをアンデプロイする場合の実行形式を次に示します。

<サービスプラットフォームのインストールディレクトリ>¥CC¥admin¥bin¥cjundeployrar <J2EEサーバ名称> -resname <リソースアダプタ表示名>

cjundeployrarコマンドの詳細は，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「2.4　J2EEサーバで使用するリソース操作コマンド」を参照してください。

●FTPインバウンドアダプタの削除

FTPインバウンドアダプタを削除する場合の実行形式を次に示します。

<サービスプラットフォームのインストールディレクトリ>¥CC¥admin¥bin¥cjdeleteres <J2EEサーバ名称> -type rar -resname <表示名>

cjdeleteresコマンドの詳細は，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「2.4　J2EEサーバで使用するリソース操作コマンド」を参照してください。

3.3.5　KafkaインバウンドアダプタおよびgRPCインバウンドアダプタをアンセットアップする

KafkaインバウンドアダプタおよびgRPCインバウンドアダプタを削除する場合の前提条件，および削除方法について次に説明します。

(1)　前提条件

KafkaインバウンドアダプタおよびgRPCインバウンドアダプタを削除するには，次の条件を満たす必要があります。

HCSCサーバが起動状態であること

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

KafkaインバウンドアダプタおよびgRPCインバウンドアダプタが停止状態であること

インバウンドアダプタの状態の確認方法については，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「4.5　リソースアダプタの一覧の参照」を参照してください。

(2)　削除方法

次の作業を実施します。

●インバウンドアダプタのアンデプロイ

インバウンドアダプタをアンデプロイする場合の，コマンドの実行形式を次に示します。

<サービスプラットフォームのインストールディレクトリ>¥CC¥admin¥bin¥cjundeployrar <J2EEサーバ名称> -resname <リソースアダプタ表示名>

cjundeployrarコマンドの詳細は，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「2.4　J2EEサーバで使用するリソース操作コマンド」を参照してください。

●インバウンドアダプタの削除

インバウンドアダプタを削除する場合の，コマンドの実行形式を次に示します。

<サービスプラットフォームのインストールディレクトリ>¥CC¥admin¥bin¥cjdeleteres <J2EEサーバ名称> -type rar -resname <リソースアダプタ表示名>

cjdeleteresコマンドの詳細は，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「2.4　J2EEサーバで使用するリソース操作コマンド」を参照してください。

3.3.6　HCSCサーバをアンセットアップする

HCSCサーバをアンセットアップすると，セットアップされていた情報が解除されます。アンセットアップされたHCSCサーバが，ほかのHCSCサーバとクラスタを構成していた場合，クラスタから削除されます。

また，アンセットアップ時にアンセットアップ直前のリポジトリ情報がバックアップされます。バックアップされたリポジトリ情報は，必要に応じて開発環境にインポートできます。バックアップはrepository.zipのファイル名で次のディレクトリに格納されます。

<サービスプラットフォームのインストールディレクトリ>¥CSC¥spool¥manager¥unsetup_bk¥repository.zip

なお，HCSCサーバをアンセットアップした結果，リポジトリ内に構築されているHCSCサーバが存在しなくなった場合，サービス情報はすべて削除されます。

HCSCサーバのアンセットアップの前提条件，およびアンセットアップ方法について次に説明します。

(1)　前提条件

HCSCサーバをアンセットアップするには，次の条件を満たす必要があります。

アンセットアップするHCSCサーバが停止状態であること

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

サービスアダプタ，ビジネスプロセス，およびユーザ定義受付がすべて配備前状態であること

サービスアダプタ，ビジネスプロセス，およびユーザ定義受付の状態の確認方法については，「5.3.19　サービスアダプタの情報を確認する」，「5.3.20　ビジネスプロセスの情報を確認する」，および「5.3.21　ユーザ定義受付の情報を確認する」を参照してください。

バックアップファイル（<サービスプラットフォームのインストールディレクトリ>¥CSC¥spool¥manager¥unsetup_bk¥repository.zip）にアクセスしていないこと

バックアップファイルにアクセスしている場合，HCSCサーバのアンセットアップに失敗することがあります。

ほかのコマンドを同時に実行していないこと

(2)　アンセットアップ方法

HCSCサーバをアンセットアップするには，運用環境でcscsvunsetupコマンドを実行します。

参考

HCSC簡易セットアップ機能を利用してセットアップしたテスト環境は，HCSC簡易セットアップ機能を利用してアンセットアップしてください。HCSC簡易セットアップ機能のアンセットアップ方法については，マニュアル「サービスプラットフォーム開発ガイド 基本開発編」の「2.4.2　HCSC簡易セットアップ機能の実行」を参照してください。

cscsvunsetupコマンドの実行形式を次に示します。cscsvunsetupコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscsvunsetup（HCSCサーバのアンセットアップ）」を参照してください。

cscsvunsetup -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名>

注意事項

クラスタを構成するHCSCサーバのそれぞれの標準受付の種別が異なる場合，設定されている標準受付の種別が少ないHCSCサーバを先にアンセットアップしてください。

HCSCサーバがアンセットアップできなかった場合，エラーになった原因を取り除いたあと，再度アンセットアップしてください。

HCSCサーバをアンセットアップした結果，リポジトリ内に構築されているHCSCサーバが存在しなくなった場合，ビジネスプロセスおよびサービスアダプタと合わせてリポジトリ情報が削除されます。削除前のビジネスプロセスおよびサービスアダプタを継続して開発する場合は，バックアップファイル（repository.zip）をHCSC開発環境にインポートして開発を継続してください。

データベースを利用してアンセットアップする場合，運用環境のリポジトリが別であったとしても，複数のマシンで同時にcscsvsetupコマンド（HCSCサーバのセットアップ）やcscsvunsetupコマンド（HCSCサーバのアンセットアップ）を実行しないでください。

3.4　テスト環境から本番環境への移行手順

テスト環境から本番環境への移行手順を次に示します。

3.4.1　テスト環境と本番環境でデータベースとReliable Messagingの使用有無が同じ場合の移行手順

テスト環境と本番環境で，データベースとReliable Messagingの使用有無が同じ場合の移行手順を次に示します。移行の概要については，「1.3.1　ケース1：テスト環境と本番環境でデータベースとReliable Messagingの使用有無を同じ設定で構築した場合」を参照してください。

図3‒13　移行手順（テスト環境と本番環境でデータベースとReliable Messagingの使用有無が同じ場合）

テスト環境のHCSCサーバをセットアップし，システムの構成を定義します。

HCSC簡易セットアップ機能を使うことで，HCSCサーバのセットアップや，システムの構成が定義できます。

運用環境からリポジトリをエクスポートし，テスト環境で定義したシステム構成定義を開発環境にインポートします。

開発環境で，HCSCコンポーネントを作成します。

テスト環境で定義したシステム構成定義を基に，システム構成のどこに配備するかを定義し更新します（配備定義）。

開発環境で定義した配備定義を含むリポジトリをエクスポートし，運用環境にインポートします。

開発環境で定義した配備定義を基に，テスト環境にHCSCコンポーネントを配備します。

本番環境のHCSCサーバをセットアップし，システムの構成を定義します。

テスト環境と本番環境で，データベースとReliable Messagingの使用有無の設定を同じにします。

また，テスト環境と本番環境のSOAPモードを同じにしてください。

開発環境で定義した配備定義を含むリポジトリをエクスポートし，運用環境にインポートします。

標準インポートを使用すると，HCSCサーバ名やIPアドレスなどが異なる場合でも，テスト環境のリポジトリをそのまま本番環境へ移行できます。

開発環境で定義した配備定義を基に，本番環境にHCSCコンポーネントを配備します。

3.4.2　データベースとReliable Messagingの両方を使用する環境から両方使用しない環境に移行する場合の移行手順

テスト環境ではデータベースとReliable Messagingの両方を使用して，本番環境ではデータベースとReliable Messagingの両方を使用しない場合の移行手順を次に示します。移行の概要については，「1.3.3　ケース3：テスト環境と本番環境でデータベースとReliable Messagingの使用有無を異なる設定で構築した場合（リポジトリを作成し直すとき）」を参照してください。

図3‒14　移行手順（データベースとReliable Messagingの両方を使用する環境から両方使用しない環境に移行する場合）

テスト環境のHCSCサーバをセットアップし，システムの構成を定義します。

HCSC簡易セットアップ機能を使うことで，HCSCサーバのセットアップや，システムの構成が定義できます。HCSC簡易セットアップ機能を使用してHCSCサーバをセットアップする場合，DB/RMありモデルを選択します。

運用環境からリポジトリをエクスポートし，テスト環境で定義したシステム構成定義を開発環境にインポートします。

開発環境で，HCSCコンポーネントを作成します。

テスト環境で定義したシステム構成定義を基に，システム構成のどこに配備するかを定義し更新します（配備定義）。

このとき，配備定義の基になるシステム構成定義は，データベースとReliable Messagingの両方を使用する設定になっています。

開発環境で定義した配備定義を含むリポジトリをエクスポートし，運用環境にインポートします。

開発環境で定義した配備定義を基に，テスト環境にHCSCコンポーネントを配備します。

本番環境のHCSCサーバをセットアップし，システムの構成を定義します。

HCSCサーバセットアップ定義ファイルで，db-useプロパティに「OFF」を，rm-useプロパティに「OFF」を設定します。

また，テスト環境と本番環境のSOAPモードを同じにしてください。

テスト環境で定義したシステム構成定義およびサービス定義を開発環境にインポートします。

本番環境の運用環境からリポジトリをエクスポートし，本番環境で定義したシステム構成定義を開発環境にインポートします。

本番環境で定義したシステム構成定義を基に，システム構成のどこに配備するかを定義し更新します（配備定義）。

このとき，配備定義の基になるシステム構成定義は，データベースとReliable Messagingの両方を使用しない設定になっています。

なお，非同期受付，非同期サービスアダプタ，および永続化ビジネスプロセスを配備定義した場合は，エラーになります。

開発環境で定義した配備定義を含むリポジトリをエクスポートし，運用環境にインポートします。

テスト環境のリポジトリ（手順8.でインポートしたリポジトリ）に対して，本番環境用のシステム構成定義を設定したリポジトリ（手順9.でインポートしたリポジトリ）を，本番環境へ移行します。

開発環境で定義した配備定義を基に，本番環境にHCSCコンポーネントを配備します。

本番環境では，データベースとReliable Messagingの両方を使用しない構成で配備されます。

3.4.3　データベースとReliable Messagingの両方を使用しない環境から両方使用する環境に移行する場合の移行手順

テスト環境ではデータベースとReliable Messagingの両方を使用しないで，本番環境ではデータベースとReliable Messagingの両方をする場合の移行手順を次に示します。移行の概要については，「1.3.2　ケース2：テスト環境と本番環境でデータベースとReliable Messagingの使用有無を異なる設定で構築した場合（リポジトリをそのまま移行できるとき）」を参照してください。

図3‒15　移行手順（データベースとReliable Messagingの両方を使用しない環境から両方使用する環境に移行する場合）

テスト環境のHCSCサーバをセットアップし，システムの構成を定義します。

HCSC簡易セットアップ機能を使うことで，HCSCサーバのセットアップや，システムの構成が定義できます。HCSC簡易セットアップ機能を使用してHCSCサーバをセットアップする場合，DB/RMなしモデルを選択します。

運用環境からリポジトリをエクスポートし，テスト環境で定義したシステム構成定義を開発環境にインポートします。

開発環境で，HCSCコンポーネントを作成します。

テスト環境で定義したシステム構成定義を基に，システム構成のどこに配備するかを定義し更新します（配備定義）。

このとき，配備定義の基になるシステム構成定義は，データベースとReliable Messagingの両方を使用しない設定になっています。

開発環境で定義した配備定義を含むリポジトリをエクスポートし，運用環境にインポートします。

開発環境で定義した配備定義を基に，テスト環境にHCSCコンポーネントを配備します。

本番環境のHCSCサーバをセットアップし，システムの構成を定義します。

HCSCサーバセットアップ定義ファイルで，db-useプロパティに「ON」を，rm-useプロパティに「ON」を設定します。

また，テスト環境と本番環境のSOAPモードを同じにしてください。

開発環境で定義した配備定義を含むリポジトリをエクスポートし，運用環境にインポートします。

標準インポートを使用すると，HCSCサーバ名やIPアドレスなどが異なる場合でも，テスト環境のリポジトリをそのまま本番環境へ移行できます。

開発環境で定義した配備定義を基に，本番環境にHCSCコンポーネントを配備します。

本番環境では，手順7.で定義したシステム構成が優先されるため，データベースとReliable Messagingの両方を使用する構成で配備されます。

3.4.4　データベースとReliable Messagingの両方を使用する環境からデータベースを使用してReliable Messagingを使用しない環境に移行する場合の移行手順

テスト環境では，データベースとReliable Messagingの両方を使用して，本番環境では，データベースを使用してReliable Messagingを使用しない場合の移行手順を次に示します。移行の概要については，「1.3.3　ケース3：テスト環境と本番環境でデータベースとReliable Messagingの使用有無を異なる設定で構築した場合（リポジトリを作成し直すとき）」を参照してください。

図3‒16　移行手順（データベースとReliable Messagingの両方を使用する環境からデータベースを使用してReliable Messagingを使用しない環境に移行する場合）

テスト環境のHCSCサーバをセットアップし，システムの構成を定義します。

HCSC簡易セットアップ機能を使うことで，HCSCサーバのセットアップや，システムの構成が定義できます。HCSC簡易セットアップ機能を使用してHCSCサーバをセットアップする場合，DB/RMありモデルを選択します。実行履歴を使用しない場合，DB/RMなしモデルを選択することもできます。DB/RMなしモデルを選択する場合の移行手順については，「3.4.5　データベースとReliable Messagingの両方を使用しない環境からデータベースを使用してReliable Messagingを使用しない環境に移行する場合の移行手順」を参照してください。

運用環境からリポジトリをエクスポートし，テスト環境で定義したシステム構成定義を開発環境にインポートします。

開発環境で，HCSCコンポーネントを作成します。

テスト環境で定義したシステム構成定義を基に，システム構成のどこに配備するかを定義し更新します（配備定義）。

このとき，配備定義の基になるシステム構成定義は，データベースとReliable Messagingの両方を使用する設定になっています。

開発環境で定義した配備定義を含むリポジトリをエクスポートし，運用環境にインポートします。

開発環境で定義した配備定義を基に，テスト環境にHCSCコンポーネントを配備します。

本番環境のHCSCサーバをセットアップし，システムの構成を定義します。

HCSCサーバセットアップ定義ファイルで，db-useプロパティに「ON」を，rm-useプロパティに「OFF」を設定します。

また，テスト環境と本番環境のSOAPモードを同じにしてください。

テスト環境で定義したシステム構成定義およびサービス定義を開発環境にインポートします。

本番環境の運用環境からリポジトリをエクスポートし，本番環境で定義したシステム構成定義を開発環境にインポートします。

本番環境で定義したシステム構成定義を基に，システム構成のどこに配備するかを定義し更新します（配備定義）。

このとき，配備定義の基になるシステム構成定義は，データベースを使用してReliable Messagingを使用しない設定になっています。

なお，非同期受付，非同期サービスアダプタ，および永続化ビジネスプロセスを配備定義した場合は，エラーになります。

開発環境で定義した配備定義を含むリポジトリをエクスポートし，運用環境にインポートします。

テスト環境のリポジトリ（手順8.でインポートしたリポジトリ）に対して，本番環境用のシステム構成定義を設定したリポジトリ（手順9.でインポートしたリポジトリ）を，本番環境へ移行します。

開発環境で定義した配備定義を基に，本番環境にHCSCコンポーネントを配備します。

本番環境では，データベースを使用してReliable Messagingを使用しない構成で配備されます。

3.4.5　データベースとReliable Messagingの両方を使用しない環境からデータベースを使用してReliable Messagingを使用しない環境に移行する場合の移行手順

テスト環境では，データベースとReliable Messagingの両方を使用しないで，本番環境では，データベースを使用してReliable Messagingを使用しない場合の移行手順を次に示します。移行の概要については，「1.3.2　ケース2：テスト環境と本番環境でデータベースとReliable Messagingの使用有無を異なる設定で構築した場合（リポジトリをそのまま移行できるとき）」を参照してください。

図3‒17　移行手順（データベースとReliable Messagingの両方を使用しない環境からデータベースを使用してReliable Messagingを使用しない環境に移行する場合）

テスト環境のHCSCサーバをセットアップし，システムの構成を定義します。

HCSC簡易セットアップ機能を使うことで，HCSCサーバのセットアップや，システムの構成が定義できます。HCSC簡易セットアップ機能を使用してHCSCサーバをセットアップする場合，DB/RMなしモデルを選択します。

運用環境からリポジトリをエクスポートし，テスト環境で定義したシステム構成定義を開発環境にインポートします。

開発環境で，HCSCコンポーネントを作成します。

テスト環境で定義したシステム構成定義を基に，システム構成のどこに配備するかを定義し更新します（配備定義）。

このとき，配備定義の基になるシステム構成定義は，データベースとReliable Messagingの両方を使用しない設定になっています。

開発環境で定義した配備定義を含むリポジトリをエクスポートし，運用環境にインポートします。

開発環境で定義した配備定義を基に，テスト環境にHCSCコンポーネントを配備します。

本番環境のHCSCサーバをセットアップし，システムの構成を定義します。

HCSCサーバセットアップ定義ファイルで，db-useプロパティに「ON」を，rm-useプロパティに「OFF」を設定します。

また，テスト環境と本番環境のSOAPモードを同じにしてください。

開発環境で定義した配備定義を含むリポジトリをエクスポートし，運用環境にインポートします。

標準インポートを使用すると，HCSCサーバ名やIPアドレスなどが異なる場合でも，テスト環境のリポジトリをそのまま本番環境へ移行できます。

開発環境で定義した配備定義を基に，本番環境にHCSCコンポーネントを配備します。

本番環境では，手順7.で定義したシステム構成が優先されるため，データベースを使用してReliable Messagingを使用しない構成で配備されます。

3.4.6　データベースを使用してReliable Messagingを使用しない環境から両方使用しない環境に移行する場合の移行手順

テスト環境では，データベースを使用してReliable Messagingを使用しないで，本番環境では，データベースとReliable Messagingの両方を使用しない場合の移行手順を次に示します。移行の概要については，「1.3.3　ケース3：テスト環境と本番環境でデータベースとReliable Messagingの使用有無を異なる設定で構築した場合（リポジトリを作成し直すとき）」を参照してください。

図3‒18　移行手順（データベースを使用してReliable Messagingを使用しない環境から両方使用しない環境に移行する場合）

テスト環境のHCSCサーバをセットアップし，システムの構成を定義します。

HCSC簡易セットアップ機能を使うことで，HCSCサーバのセットアップや，システムの構成が定義できます。HCSC簡易セットアップ機能を使用してHCSCサーバをセットアップする場合，DBあり/RMなしモデルを選択します。

運用環境からリポジトリをエクスポートし，テスト環境で定義したシステム構成定義を開発環境にインポートします。

開発環境で，HCSCコンポーネントを作成します。

テスト環境で定義したシステム構成定義を基に，システム構成のどこに配備するかを定義し更新します（配備定義）。

このとき，配備定義の基になるシステム構成定義は，データベースを使用してReliable Messagingを使用しない設定になっています。

開発環境で定義した配備定義を含むリポジトリをエクスポートし，運用環境にインポートします。

開発環境で定義した配備定義を基に，テスト環境にHCSCコンポーネントを配備します。

本番環境のHCSCサーバをセットアップし，システムの構成を定義します。

HCSCサーバセットアップ定義ファイルで，db-useプロパティに「OFF」を，rm-useプロパティに「OFF」を設定します。

また，テスト環境と本番環境のSOAPモードを同じにしてください。

テスト環境で定義したシステム構成定義およびサービス定義を開発環境にインポートします。

本番環境の運用環境からリポジトリをエクスポートし，本番環境で定義したシステム構成定義を開発環境にインポートします。

本番環境で定義したシステム構成定義を基に，システム構成のどこに配備するかを定義し更新します（配備定義）。

このとき，配備定義の基になるシステム構成定義は，データベースとReliable Messagingの両方を使用しない設定になっています。

なお，非同期サービスアダプタ，および永続化ビジネスプロセスを配備定義した場合は，エラーになります。

開発環境で定義した配備定義を含むリポジトリをエクスポートし，運用環境にインポートします。

テスト環境のリポジトリ（手順8.でインポートしたリポジトリ）に対して，本番環境用のシステム構成定義を設定したリポジトリ（手順9.でインポートしたリポジトリ）を，本番環境へ移行します。

開発環境で定義した配備定義を基に，本番環境にHCSCコンポーネントを配備します。

本番環境では，データベースとReliable Messagingの両方を使用しない構成で配備されます。

3.4.7　データベースを使用してReliable Messagingを使用しない環境から両方使用する環境に移行する場合の移行手順

テスト環境では，データベースを使用してReliable Messagingを使用しないで，本番環境では，データベースとReliable Messagingの両方をする場合の移行手順を次に示します。移行の概要については，「1.3.2　ケース2：テスト環境と本番環境でデータベースとReliable Messagingの使用有無を異なる設定で構築した場合（リポジトリをそのまま移行できるとき）」を参照してください。

図3‒19　移行手順（データベースを使用してReliable Messagingを使用しない環境から両方使用する環境に移行する場合）

テスト環境のHCSCサーバをセットアップし，システムの構成を定義します。

HCSC簡易セットアップ機能を使うことで，HCSCサーバのセットアップや，システムの構成が定義できます。HCSC簡易セットアップ機能を使用してHCSCサーバをセットアップする場合，DBあり/RMなしモデルを選択します。

運用環境からリポジトリをエクスポートし，テスト環境で定義したシステム構成定義を開発環境にインポートします。

開発環境で，HCSCコンポーネントを作成します。

テスト環境で定義したシステム構成定義を基に，システム構成のどこに配備するかを定義し更新します（配備定義）。

このとき，配備定義の基になるシステム構成定義は，データベースを使用してReliable Messagingを使用しない設定になっています。

開発環境で定義した配備定義を含むリポジトリをエクスポートし，運用環境にインポートします。

開発環境で定義した配備定義を基に，テスト環境にHCSCコンポーネントを配備します。

本番環境のHCSCサーバをセットアップし，システムの構成を定義します。

HCSCサーバセットアップ定義ファイルで，db-useプロパティに「ON」を，rm-useプロパティに「ON」を設定します。

また，テスト環境と本番環境のSOAPモードを同じにしてください。

開発環境で定義した配備定義を含むリポジトリをエクスポートし，運用環境にインポートします。

標準インポートを使用すると，HCSCサーバ名やIPアドレスなどが異なる場合でも，テスト環境のリポジトリをそのまま本番環境へ移行できます。

開発環境で定義した配備定義を基に，本番環境にHCSCコンポーネントを配備します。

本番環境では，手順7.で定義したシステム構成が優先されるため，データベースとReliable Messagingの両方を使用する構成で配備されます。

3.5　本番環境の簡易セットアップ

HCSC本番環境簡易セットアップ機能を利用すると，次のことができます。

本番環境に必要なさまざまな情報を自動的に設定できます。

この機能で設定した情報は容易に変更できます。また，この機能を利用してセットアップした本番環境は自動的にアンセットアップできます。

本番環境の構築で必要となるさまざまなコマンドを意識することなく，一括で構築することができます。

また，この機能で設定した情報を有効にしたり変更したりする場合や，この機能を利用してセットアップした本番環境を容易にアンセットアップする場合も，コマンドを意識することなく実行できます。

HCSC本番環境簡易セットアップ機能のセットアップには次の種類があります。

単一セットアップ機能

本番環境を構築します。あとから追加セットアップ機能でサーバを追加することはできません。

追加構築可能環境セットアップ機能

本番環境を構築します。あとから追加セットアップ機能でサーバを追加できます。

追加セットアップ機能

構築済みの本番環境にサーバを追加します。追加構築可能環境セットアップ機能でセットアップした環境に対して使用できます。

ここでは，HCSC本番環境簡易セットアップ機能の概要と利用方法について説明します。

3.5.1　HCSC本番環境簡易セットアップ機能で構築できる環境

HCSC本番環境簡易セットアップ機能を利用して構築される本番環境の構成は，単一セットアップ機能を利用した場合と追加構築可能環境セットアップ機能を利用した場合とで異なります。それぞれの構成を次の図に示します。

次の図に示すプロセス以外のものは，HCSC本番環境簡易セットアップ機能を利用してセットアップできません。次の図に示すプロセス以外のものを本番環境で利用する場合は，HCSC本番環境簡易セットアップ機能を利用しない方法（以降，「通常の方法」と表記）でセットアップしてください。

図3‒20　構築される本番環境の構成（HCSC本番環境簡易セットアップ機能の単一セットアップ機能を利用した場合）

図3‒21　構築される本番環境の構成（HCSC本番環境簡易セットアップ機能の追加構築可能環境セットアップ機能を利用した場合）

HCSC本番環境簡易セットアップ機能を利用すると，これらの図に示す本番環境の各プロセスに，ユーザID，パスワード，ポート番号，ホスト名などの情報を自動的に設定できます。HCSC本番環境簡易セットアップ機能を利用した場合に本番環境に設定される情報の詳細については，「3.5.4　HCSC本番環境簡易セットアップ機能でセットアップした本番環境の運用」を参照してください。

なお，HCSC本番環境簡易セットアップ機能を利用して環境を構築する場合，次の点に注意してください。

HCSC本番環境簡易セットアップ機能では，リモートの実行環境を構築できません。

HCSC本番環境簡易セットアップ機能とHCSC簡易セットアップ機能（テスト環境の構築）は併用できません。すでにどちらかの機能を利用してセットアップした環境で，別のセットアップ機能を利用する場合は，セットアップ済みの環境をいったんアンセットアップして，そのあとに別のセットアップ機能を利用してセットアップしてください。

HCSC本番環境簡易セットアップ機能の単一セットアップ機能で構築した本番環境である場合は，セットアップできるHCSCサーバは1台だけです。2台目のHCSCサーバはセットアップしないでください。追加構築可能環境セットアップ機能で構築した本番環境である場合は，2台目以降のHCSCサーバも追加セットアップ機能によってセットアップできます。

HCSC本番環境簡易セットアップ機能を利用して構築する環境は，ほかのマシンから操作できません。ほかのマシンから運用操作する場合は，cscsvsetupコマンドを利用してセットアップしてください。cscsvsetupコマンドを利用したセットアップ方法については，「3.1.3　HCSCサーバをセットアップする」を参照してください。

HCSC本番環境簡易セットアップ機能を利用してセットアップまたはアンセットアップした場合，セットアップまたはアンセットアップが正常に終了していないとバージョンアップできません。

また，UNIXの場合は次の点にも注意してください。

更新インストール時にComponent Container管理者を変更する場合は，次のディレクトリ配下のファイル属性をComponent Container管理者と同じように変更してください。

リポジトリルート配下のディレクトリ

ログディレクトリ配下のディレクトリ

応答電文出力ディレクトリ配下のディレクトリ

システム管理情報ディレクトリ配下のディレクトリ

SQLスクリプトファイルのディレクトリ

SOAP Fault動作定義ファイルのディレクトリ

ユーザ電文トレースのディレクトリ

ファイル属性の変更方法については，「付録A　Service Coordinator管理者の変更方法（UNIXの場合）」を参照してください。

なお，ディレクトリおよびディレクトリ配下のファイルには，次のように権限を設定してください。

上記のディレクトリおよびディレクトリ配下のファイル

すべてのユーザに対して書き込み権限を付与してください。

上記のディレクトリの上位のディレクトリ

実行権限を付与してください。ただし，上記のディレクトリをデフォルトから変更していない場合，実行権限を付与する必要はありません。

root権限を持たないComponent Container管理者に変更する場合は，ポート番号を1024以上に指定してください。

3.5.2　HCSC本番環境簡易セットアップ機能を利用したシステムのセットアップの流れ

HCSC本番環境簡易セットアップ機能を利用したシステムのセットアップの流れについて，次の図に示します。

図3‒22　セットアップの流れ（HCSC本番環境簡易セットアップ機能を利用した場合）

注意事項

OSの起動と同時に，Management Serverおよび運用管理エージェントを自動起動するように設定する必要があります。

HCSC本番環境簡易セットアップ機能を利用してセットアップする場合の作業について次に説明します。

(1)　本番環境のセットアップ

HCSC本番環境簡易セットアップ機能を利用して本番環境をセットアップします。HCSC本番環境簡易セットアップ機能を利用して本番環境をセットアップするには，テンプレートファイルを使用して定義ファイルを作成する必要があります。

本番環境のセットアップについては，「3.5.3(1)　本番環境のセットアップ（単一セットアップ機能の場合）」を参照してください。追加構築可能環境セットアップ機能を使用する場合は，「3.5.3(2)　本番環境のセットアップ（追加構築可能環境セットアップ機能の場合）」を参照してください。

(2)　リポジトリのインポート

開発環境で作成したリポジトリを運用環境にインポートします。リポジトリのインポートについては，「4.3　リポジトリのインポート」を参照してください。

(3)　サービス情報の変更

HCSC本番環境簡易セットアップ機能を利用してセットアップしたサービス情報を変更します。

セットアップしたサービス情報の変更については，「3.5.3(3)　セットアップした情報の変更（単一セットアップ機能の場合）」を参照してください。追加構築可能環境セットアップ機能を使用する場合は，「3.5.3(4)　セットアップした情報の変更（追加構築可能環境セットアップ機能の場合）」を参照してください。

(4)　サービスアダプタ，ビジネスプロセス，およびユーザ定義受付の配備

サービスアダプタ，ビジネスプロセス，およびユーザ定義受付を実行環境に配備します。サービスアダプタ，ビジネスプロセス，およびユーザ定義受付の配備については，「3.1.8　サービスアダプタを配備する」，「3.1.13　ビジネスプロセスを配備する」，および「3.1.14　ユーザ定義受付を配備する」を参照してください。

(5)　ユーザ定義受付の定義情報の変更

HCSC本番環境簡易セットアップ機能を利用してセットアップしたユーザ定義受付の定義情報を変更します。

セットアップしたユーザ定義受付の定義情報の変更については，「3.5.3(3)　セットアップした情報の変更（単一セットアップ機能の場合）」を参照してください。追加構築可能環境セットアップ機能を使用する場合は，「3.5.3(4)　セットアップした情報の変更（追加構築可能環境セットアップ機能の場合）」を参照してください。

(6)　サーバの定義情報の変更

本番環境のセットアップ後に，任意のタイミングでサーバの定義情報を変更します。サーバの定義情報の変更については，「3.5.3(3)　セットアップした情報の変更（単一セットアップ機能の場合）」を参照してください。追加構築可能環境セットアップ機能を使用する場合は，「3.5.3(4)　セットアップした情報の変更（追加構築可能環境セットアップ機能の場合）」を参照してください。

3.5.3　HCSC本番環境簡易セットアップ機能の実行

HCSC本番環境簡易セットアップ機能を利用した本番環境のセットアップ，セットアップした情報の変更，およびアンセットアップの手順について説明します。

(1)　本番環境のセットアップ（単一セットアップ機能の場合）

HCSC本番環境簡易セットアップ機能のうち，単一セットアップ機能を利用して本番環境をセットアップする場合の前提条件，およびセットアップ手順について説明します。

(a)　前提条件

本番環境をセットアップするための前提条件を次に示します。

HCSC本番環境簡易セットアップ機能を利用するときのシステムの状態

HCSC本番環境簡易セットアップ機能のうち，単一セットアップ機能を利用して本番環境をセットアップする場合，システムが次のどれかの状態である必要があります。

サービスプラットフォームを新規にインストールした直後であること

HCSC本番環境簡易セットアップ機能を利用して本番環境を一度セットアップした場合，HCSC本番環境簡易セットアップ機能を利用してアンセットアップしていること

テスト環境の簡易セットアップ機能を利用してテスト環境を一度セットアップした場合，テスト環境の簡易セットアップ機能を利用してアンセットアップしていること

環境変数の設定

HCSC本番環境簡易セットアップ機能のうち，単一セットアップ機能を利用して本番環境をセットアップするには，環境変数を設定している必要があります。環境変数の詳細については，マニュアル「アプリケーションサーバシステム構築・運用ガイド」の「4.1.15　論理サーバの環境変数を設定するときの確認事項」を参照してください。

また，CSCMNG_HOME環境変数を設定しないでください。

(b)　セットアップ手順

HCSC本番環境簡易セットアップ機能のうち，単一セットアップ機能を利用して本番環境をセットアップするには，テンプレートファイルを使用して定義ファイルを作成する必要があります。本番環境のセットアップ手順を次に示します。

テンプレートファイルを任意のディレクトリ（準備環境）にコピーします。

コピーするテンプレートファイルとテンプレートファイルの格納場所については，「3.5.5　HCSC本番環境簡易セットアップで使用する定義ファイル」を参照してください。

テンプレートファイルを編集し，定義ファイルを作成します。

編集するテンプレートファイルについては，「3.5.5　HCSC本番環境簡易セットアップで使用する定義ファイル」を参照してください。

注意事項

HCSCサーバのセットアップ後は，usrconf.cfg（J2EEサーバ用オプション定義ファイル）のejb.public.directoryの設定値を変更できません。設定値を変更する場合は，本番環境のセットアップ前に定義ファイルを変更してください。

2.で作成した定義ファイルを準備環境から本番環境の任意のディレクトリにコピーします。

cscsetupコマンドを実行し，本番環境をセットアップします。

-setupオプションに定義ファイルの格納先ディレクトリを指定して実行します。

cscsetup -setup <定義ファイルの格納先ディレクトリ>

cscsetupコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscsetup（本番環境の簡易セットアップ）」を参照してください。

HTTP Server定義ファイルを変更します。

変更する定義ファイルについては，「3.5.5　HCSC本番環境簡易セットアップで使用する定義ファイル」を参照してください。

(2)　本番環境のセットアップ（追加構築可能環境セットアップ機能の場合）

HCSC本番環境簡易セットアップ機能のうち，追加構築可能環境セットアップ機能を利用して本番環境をセットアップする場合の前提条件，およびセットアップ手順について説明します。

(a)　前提条件

本番環境をセットアップするための前提条件を次に示します。

HCSC本番環境簡易セットアップ機能を利用するときのシステムの状態

HCSC本番環境簡易セットアップ機能のうち，追加構築可能環境セットアップ機能を利用して本番環境をセットアップする場合，システムが次のどれかの状態である必要があります。

サービスプラットフォームを新規にインストールした直後であること

追加構築可能環境セットアップ機能によって本番環境がセットアップされた状態であること

テスト環境の簡易セットアップ機能を利用してテスト環境を一度セットアップした場合，テスト環境の簡易セットアップ機能を利用してアンセットアップしていること

環境変数の設定

HCSC本番環境簡易セットアップ機能のうち，追加構築可能環境セットアップ機能を利用して本番環境をセットアップするには，環境変数を設定している必要があります。環境変数の詳細については，マニュアル「アプリケーションサーバシステム構築・運用ガイド」の「4.1.15　論理サーバの環境変数を設定するときの確認事項」を参照してください。

また，CSCMNG_HOME環境変数を設定しないでください。

(b)　セットアップ手順

HCSC本番環境簡易セットアップ機能のうち，追加構築可能環境セットアップ機能を利用して本番環境をセットアップするには，テンプレートファイルを使用して定義ファイルを作成する必要があります。本番環境のセットアップ手順を次に示します。

テンプレートファイルを任意のディレクトリ（準備環境）にコピーします。

コピーするテンプレートファイルとテンプレートファイルの格納場所については，「3.5.5　HCSC本番環境簡易セットアップで使用する定義ファイル」を参照してください。

テンプレートファイルを編集し，定義ファイルを作成します。

編集するテンプレートファイルについては，「3.5.5　HCSC本番環境簡易セットアップで使用する定義ファイル」を参照してください。

2.で作成した定義ファイルを準備環境から本番環境の任意のディレクトリにコピーします。

cscsetupコマンドを実行し，本番環境をセットアップします。

-setupオプションに定義ファイルの格納先ディレクトリを指定し，-hcscenvオプションにCSCMNG_HOMEディレクトリを指定して実行します。

cscsetup -setup <定義ファイルの格納先ディレクトリ> -hcscenv <CSCMNG_HOMEディレクトリ>

cscsetupコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscsetup（本番環境の簡易セットアップ）」を参照してください。

HTTP Server定義ファイルを変更します。

変更する定義ファイルについては，「3.5.5　HCSC本番環境簡易セットアップで使用する定義ファイル」を参照してください。

(c)　セットアップ手順（サーバの追加）

追加構築可能環境セットアップ機能を利用して本番環境をセットアップしたあと，追加セットアップ機能を使用してサーバを追加セットアップできます。なお，追加セットアップでは使用するテンプレートが異なるため注意してください。

追加セットアップの前に，次の条件を満たしていることを確認してください。

「(b) セットアップ手順」に示すセットアップ作業が完了していること

Management Serverおよび運用管理エージェントが起動していること

追加セットアップは，追加するサーバ（論理サーバまたはHCSCサーバ）の数だけ「(b) セットアップ手順」の1.〜5.の手順を繰り返します。

(d)　追加構築可能環境をセットアップする場合の注意事項

追加構築可能環境をセットアップする場合は，次の点に注意してください。

●1台目の追加構築可能環境のセットアップ

新規セットアップの場合

注意事項はありません。

再セットアップの場合

セットアップに失敗した論理サーバ/HCSCサーバを再セットアップする場合は，次の点に注意してください。

簡易構築定義ファイルに指定するサービスユニット名を変更できるのは，再セットアップの原因がサービスユニット名の重複エラーである場合だけです。それ以外で変更した場合，別の論理サーバ/HCSCサーバのセットアップとみなされます。

-hcscenvオプションに指定するCSCMNG_HOMEディレクトリを変更できるのは，使用中のCSCMNG_HOMEディレクトリを指定したことによるエラーが原因で再セットアップする場合だけです。それ以外で変更した場合の動作は保証しません。

●2台目以降の追加構築可能環境のセットアップ（追加セットアップ）

新規セットアップ・再セットアップ共通

簡易構築定義ファイルに指定するサービスユニット名と，-hcscenvオプションに指定するCSCMNG_HOMEディレクトリは，追加構築可能環境内で一意の値を指定してください。一意でない値を指定した場合の動作は保証しません。

HCSC-Manager定義ファイルにcscmng.repository.root（リポジトリのルートディレクトリパス）を指定する場合，追加構築可能環境ごとに一意の値を指定してください。一意でない値を指定した場合の動作は保証しません。

新規セットアップの場合

構築中（セットアップ途中またはアンセットアップ途中）の追加構築可能環境がある場合は，追加構築可能環境への論理サーバ/HCSCサーバの追加セットアップを実行しないでください。実行した場合の動作は保証しません。

再セットアップの場合

セットアップに失敗した論理サーバ/HCSCサーバを再セットアップする場合は，次の点に注意してください。

簡易構築定義ファイルに指定するサービスユニット名を変更できるのは，再セットアップの原因がサービスユニット名の重複エラーである場合だけです。それ以外で変更した場合，別の論理サーバ/HCSCサーバのセットアップとみなされます。

-hcscenvオプションに指定するCSCMNG_HOMEディレクトリを変更できるのは，使用中のCSCMNG_HOMEディレクトリを指定したことによるエラーが原因で再セットアップする場合だけです。それ以外で変更した場合の動作は保証しません。

(3)　セットアップした情報の変更（単一セットアップ機能の場合）

HCSC本番環境簡易セットアップ機能を利用してセットアップした情報は変更することができます。変更できる情報を次に示します。

サービス情報

ユーザ定義受付の定義情報

サーバの定義情報

HCSC本番環境簡易セットアップ機能のうち，単一セットアップ機能を利用してセットアップした情報を変更する場合の前提条件，および変更手順について説明します。

(a)　前提条件

HCSC本番環境簡易セットアップ機能のうち，単一セットアップ機能を利用してセットアップした情報を変更するための前提条件を次に示します。

HCSC本番環境簡易セットアップ機能のうち，単一セットアップ機能を利用してセットアップした本番環境であること。

すべての論理サーバが停止状態であること。

CSCMNG_HOME環境変数を設定していないこと。

また，変更する情報がサービス情報またはユーザ定義受付の定義情報の場合，次の条件を満たす必要があります。

サービス情報を変更する場合

開発環境からリポジトリをインポートしていること。

HCSCコンポーネントが未配備状態であること。

ユーザ定義受付の定義情報を変更する場合

HCSCコンポーネントが配備状態であること。

(b)　変更手順

HCSC本番環境簡易セットアップ機能のうち，単一セットアップ機能を利用してセットアップした情報を変更する手順を次に示します。

定義ファイルを変更します。

変更できる情報に対応する定義ファイルと変更方法を次に示します。

変更できる情報の種類

定義ファイル

変更方法

サービス情報

サービス情報変更定義ファイル（cscadpconfig.properties）

セットアップ時に準備環境で作成した定義ファイルを変更します。

ユーザ定義受付の定義情報

ユーザ定義受付ランタイム定義ファイル（cscurcptnconfig_id.properties）

サーバの定義情報

簡易構築定義ファイル（SOA.xml）

変更する定義ファイルの詳細については，「3.5.5　HCSC本番環境簡易セットアップで使用する定義ファイル」を参照してください。

1.で変更した定義ファイルを準備環境から本番環境の任意のディレクトリにコピーします。

定義ファイルが格納されているディレクトリをコピーしてください。

cscsetupコマンドを実行し，本番環境に設定した情報を変更します。

コマンドの実行形式を次に示します。

cscsetup -change <定義ファイルの格納先ディレクトリ>

cscsetupコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscsetup（本番環境の簡易セットアップ）」を参照してください。

(4)　セットアップした情報の変更（追加構築可能環境セットアップ機能の場合）

HCSC本番環境簡易セットアップ機能を利用してセットアップした情報は変更することができます。変更できる情報を次に示します。

サービス情報

ユーザ定義受付の定義情報

サーバの定義情報

HCSC本番環境簡易セットアップ機能のうち，追加構築可能環境セットアップ機能を利用してセットアップした情報を変更する場合の前提条件，および変更手順について説明します。

(a)　前提条件

HCSC本番環境簡易セットアップ機能のうち，追加構築可能環境セットアップ機能を利用してセットアップした情報を変更するための前提条件を次に示します。

HCSC本番環境簡易セットアップ機能のうち，追加構築可能環境セットアップ機能を利用してセットアップした本番環境であること。

すべての論理サーバが停止状態であること。

CSCMNG_HOME環境変数を設定していないこと。

また，変更する情報がサービス情報またはユーザ定義受付の定義情報の場合，次の条件を満たす必要があります。

サービス情報を変更する場合

開発環境からリポジトリをインポートしていること。

HCSCコンポーネントが未配備状態であること。

ユーザ定義受付の定義情報を変更する場合

HCSCコンポーネントが配備状態であること。

(b)　変更手順

HCSC本番環境簡易セットアップ機能のうち，追加構築可能環境セットアップ機能を利用してセットアップした情報を変更する手順を次に示します。

定義ファイルを変更します。

変更できる情報に対応する定義ファイルと変更方法を次に示します。

変更できる情報の種類

定義ファイル

変更方法

サービス情報

サービス情報変更定義ファイル（cscadpconfig.properties）

セットアップ時に準備環境で作成した定義ファイルを変更します。

ユーザ定義受付の定義情報

ユーザ定義受付ランタイム定義ファイル（cscurcptnconfig_id.properties）

サーバの定義情報

簡易構築定義ファイル（SOA.xml）

任意のディレクトリに簡易構築定義ファイルをcmx_export_modelコマンドで出力したあと，そのファイルを基に定義ファイルを変更します。

変更する定義ファイルの詳細については，「3.5.5　HCSC本番環境簡易セットアップで使用する定義ファイル」を参照してください。

cmx_export_modelコマンドの実行方法については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cmx_export_model（簡易構築定義ファイルの出力）」を参照してください。

1.で変更した定義ファイルを準備環境から本番環境の任意のディレクトリにコピーします。

定義ファイルが格納されているディレクトリをコピーしてください。

cscsetupコマンドを実行し，本番環境に設定した情報を変更します。

コマンドの実行形式を次に示します。

cscsetup -change <定義ファイルの格納先ディレクトリ> -unit <サービスユニット名>

cscsetupコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscsetup（本番環境の簡易セットアップ）」を参照してください。

(5)　本番環境のアンセットアップ（単一セットアップ機能で構築した環境の場合）

HCSC本番環境簡易セットアップ機能のうち，単一セットアップ機能を利用してセットアップした本番環境をアンセットアップする場合の前提条件，およびアンセットアップ方法について説明します。

注意事項

HCSC本番環境簡易セットアップ機能を利用してセットアップした本番環境をアンセットアップする場合，snapshotlog.conf，snapshotlog2.conf，c4websv.cfg，およびc4webcom.cfg以外のファイルは，インストール時の状態に戻ります。そのため，ユーザが手動で変更したファイルは，あらかじめバックアップを取ってからアンセットアップを実行してください。

(a)　前提条件

HCSC本番環境簡易セットアップ機能を利用してセットアップした本番環境をアンセットアップするための前提条件を次に示します。

HCSC本番環境簡易セットアップ機能のうち，単一セットアップ機能を利用してセットアップした直後の状態であること（HCSCコンポーネントが未配備状態であること）。

Management Server，および運用管理エージェントが起動していること。

CSCMNG_HOME環境変数を設定していないこと。

(b)　アンセットアップ方法

HCSC本番環境簡易セットアップ機能のうち，単一セットアップ機能を利用してセットアップした本番環境をアンセットアップするには，cscsetupコマンドに-unsetupオプションを指定して実行します。

cscsetup -unsetup

cscsetupコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscsetup（本番環境の簡易セットアップ）」を参照してください。

(6)　本番環境のアンセットアップ（追加構築可能環境セットアップ機能で構築した環境の場合）

HCSC本番環境簡易セットアップ機能のうち，追加構築可能環境セットアップ機能を利用してセットアップした本番環境をアンセットアップする場合の前提条件，およびアンセットアップ方法について説明します。

注意事項

HCSC本番環境簡易セットアップ機能を利用してセットアップした本番環境をアンセットアップする場合，snapshotlog.conf，snapshotlog2.conf，c4websv.cfg，およびc4webcom.cfg以外のファイルは，インストール時の状態に戻ります。そのため，ユーザが手動で変更したファイルは，あらかじめバックアップを取ってからアンセットアップを実行してください。

(a)　前提条件

HCSC本番環境簡易セットアップ機能のうち，追加構築可能環境セットアップ機能を利用してセットアップした本番環境をアンセットアップするための前提条件を次に示します。

追加構築可能環境セットアップ機能によるセットアップが完了し，HCSCコンポーネントが未配備状態であること。

Management Server，および運用管理エージェントが起動していること。

CSCMNG_HOME環境変数を設定していないこと。

(b)　アンセットアップ方法

HCSC本番環境簡易セットアップ機能のうち，追加構築可能環境セットアップ機能を利用してセットアップした本番環境をアンセットアップするには，cscsetupコマンドに-unsetupオプションを指定し，-deleteunitオプションにサービスユニット名を指定して実行します。アンセットアップするサーバの数だけコマンドを実行してください。

cscsetup -unsetup -deleteunit <サービスユニット名>

cscsetupコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscsetup（本番環境の簡易セットアップ）」を参照してください。

(c)　追加構築可能環境をアンセットアップする場合の注意事項

構築中の追加構築可能環境がある場合は，アンセットアップに関して次の点に注意してください。

構築中（セットアップ途中またはアンセットアップ途中）の追加構築可能環境以外の追加構築可能環境は，アンセットアップしないでください。アンセットアップした場合の動作は保証しません。

(7)　セットアップした本番環境を追加セットアップ・情報変更またはアンセットアップする場合の注意事項

セットアップした本番環境を追加セットアップ・情報変更またはアンセットアップする場合の注意事項について説明します。

(a)　HCSC本番環境簡易セットアップ機能を利用してセットアップした場合の注意事項

障害が発生した場合や急な問題に対応しなければならない場合に，HCSC本番環境簡易セットアップ機能を利用してセットアップした本番環境をほかの方法で追加セットアップ，情報変更またはアンセットアップすることがあります。これらの実行可否を次の表に示します。

表3‒31　本番環境簡易セットアップでセットアップした本番環境に対する実行可否

環境の種類

環境に対する実行可否

本番環境簡易セットアップの単一セットアップ機能でセットアップした環境

標準のセットアップ

追加セットアップ

×

アンセットアップ

×※

情報変更

△

HCSC簡易セットアップ

追加セットアップ

×

アンセットアップ

本番環境簡易セットアップ（単一セットアップ機能）

追加セットアップ

×

アンセットアップ

○

情報変更

○

本番環境簡易セットアップ（追加構築可能環境セットアップ機能）

追加セットアップ

×

アンセットアップ

情報変更

本番環境簡易セットアップの追加構築可能環境セットアップ機能でセットアップした環境

標準のセットアップ

追加セットアップ

×

アンセットアップ

×※

情報変更

△

HCSC簡易セットアップ

追加セットアップ

×

アンセットアップ

本番環境簡易セットアップ（単一セットアップ機能）

追加セットアップ

×

アンセットアップ

情報変更

本番環境簡易セットアップ（追加構築可能環境セットアップ機能）

追加セットアップ

○

アンセットアップ

情報変更

（凡例）

○：実行できます。

△：実行できますが，通常の方法で変更したあとに，変更した内容をセットアップ時に作成した定義ファイルに反映する必要があります。反映方法は以降の項目「HCSC本番環境簡易セットアップ機能を利用してセットアップした情報の変更」を参照してください。

×：実行できません。

注※

実行時のエラーは発生しませんが，HCSC本番環境簡易セットアップ機能を利用して再度アンセットアップする必要があります。アンセットアップ手順は以降の項目「HCSC本番環境簡易セットアップ機能を利用してセットアップした本番環境のアンセットアップ」を参照してください。

HCSC本番環境簡易セットアップ機能を利用してセットアップした情報の変更

HCSC本番環境簡易セットアップ機能を利用してセットアップした情報を通常の方法で変更した場合，変更した内容をセットアップ時に作成した定義ファイルに反映し，本番環境の定義情報を変更する必要があります。

なお，サービスプラットフォームに関する次の定義ファイルの情報は，変更する必要がありません。

HCSC-Manager定義ファイル（cscmng.properties）

HCSC-Managerコマンド共通定義ファイル（csccmd.properties）

HCSCサーバ構成定義ファイル（cscsvsetup.xml）

HCSCサーバセットアップ定義ファイル（cscsvsetup.properties）

HCSCサーバランタイム定義ファイル（cscsvconfig.properties）

ユーザ定義受付ランタイム定義ファイル（cscurcptnconfig_id.properties）

サービス情報変更定義ファイル（cscadpconfig.properties）

定義情報の変更方法については，「(3)　セットアップした情報の変更（単一セットアップ機能の場合）」または「(4)　セットアップした情報の変更（追加構築可能環境セットアップ機能の場合）」を参照してください。

HCSC本番環境簡易セットアップ機能を利用してセットアップした本番環境のアンセットアップ

HCSC本番環境簡易セットアップ機能を利用してセットアップした本番環境を通常の方法でアンセットアップした場合，次の手順でHCSC本番環境簡易セットアップ機能を利用して，アンセットアップし直す必要があります。

通常の方法でアンセットアップしたあと，通常の方法で再度セットアップし直し，HCSC本番環境簡易セットアップ機能を利用してセットアップしたときの状態に戻します。

HCSC本番環境簡易セットアップ機能を利用して，アンセットアップします。

(b)　HCSC本番環境簡易セットアップ機能を利用しないでセットアップした場合の注意事項

HCSC本番環境簡易セットアップ機能を利用しないでセットアップした本番環境は，HCSC本番環境簡易セットアップ機能を利用して追加セットアップ，変更およびアンセットアップできません。

3.5.4　HCSC本番環境簡易セットアップ機能でセットアップした本番環境の運用

HCSC本番環境簡易セットアップ機能を利用してセットアップした本番環境の運用方法，および運用に必要な情報について説明します。

(1)　本番環境の起動と停止

本番環境の起動および停止方法について，次の表に示します。

表3‒32　本番環境の起動および停止方法

起動・停止の対象

起動・停止方法

Management Server

運用管理エージェント

本番環境のマシンを起動すると，自動的に起動されます。また，本番環境のマシンを停止すると，自動的に停止されます。

Performance Tracer

J2EEサーバ

HCSCサーバ

コマンドプロンプトで次のコマンドを実行します。

起動する場合：

<サービスプラットフォームのインストールディレクトリ>¥CSC¥bin¥cscsvstart.bat -system

停止する場合：

<サービスプラットフォームのインストールディレクトリ>¥CSC¥bin¥cscsvstop.bat -system

Performance Tracer，およびJ2EEサーバの起動・停止方法および運用方法の詳細については，マニュアル「アプリケーションサーバ システム構築・運用ガイド」を参照してください。

HCSCサーバの起動・停止方法および運用方法の詳細については，「5.3.4　HCSCサーバを起動する」および「5.3.41　HCSCサーバを停止する」を参照してください。

(2)　本番環境の運用に必要な情報

HCSC本番環境簡易セットアップ機能を利用してセットアップすると，本番環境の運用に必要な情報が自動的に設定されます。このとき本番環境に設定される情報を次に説明します。なお，列「固定値」に値が記載されている項目については，HCSC本番環境簡易セットアップ機能では変更できません。

(a)　ユーザIDおよびパスワードの情報

HCSC本番環境簡易セットアップ機能でセットアップした本番環境には，次の表に示すユーザIDおよびパスワードが設定されます。

表3‒33　本番環境に設定されるユーザIDおよびパスワード

設定先

設定されるユーザIDおよびパスワード

固定値

説明

Management Server

管理ユーザID

admin

Management Serverにログインするための管理ユーザID

パスワード

admin

Management Serverにログインするためのパスワード

HCSC-Manager

HCSC-ManagerログインユーザID

admin

HCSC-ManagerにログインするためのユーザID

HCSC-Managerログインパスワード

admin

HCSC-Managerにログインするためのパスワード

(b)　ポート番号の情報

HCSC本番環境簡易セットアップ機能でセットアップした本番環境には，次の表に示すポート番号が設定されます。

表3‒34　単一セットアップ機能または追加構築可能環境セットアップ機能の利用時に本番環境に設定されるポート番号

設定先

設定されるポート番号

デフォルト値

説明

Management Server

HCSCサーバ運用ポート番号

28099

HCSC-ManagerからManagement Serverにアクセスする場合に使用するポート番号

論理サーバ運用ポート番号

28080

Smart Composerまたは運用管理ポータル画面からManagement Serverにアクセスする場合に使用するポート番号

終了要求受信ポート番号

28005

Management Serverが内部の管理用に利用するポート番号

内部通信ポート番号

28009

Management Serverが内部の管理用に利用するポート番号

インプロセスネーミングサービスポート番号

28900

Management Serverが内部の管理用に利用するポート番号

運用管理エージェント

エージェント接続ポート番号

20295

Management Serverから運用管理エージェントにアクセスする場合に使用する内部管理用のポート番号

J2EEサーバ

SessionBean受付ポート番号

900

Management ServerからHCSCサーバに，またはサービスリクエスタから標準受付（SessionBean）にアクセスする場合に使用するポート番号

稼働確認ポート番号

23152

HCSCサーバが内部の管理用に利用するポート番号

管理用サーバのポート番号

8080

HCSCサーバが内部の管理用に利用するポート番号

稼働情報取得時のリクエスト受付ポート番号

23550

HCSCサーバが内部の管理用に利用するポート番号

Webサーバ

リクエスト受付ポート番号

80

リクエストを受け付けるポート番号

(c)　名称の情報

HCSC本番環境簡易セットアップ機能でセットアップした本番環境には，次の表に示すホスト名やサーバ名などの情報が設定されます。表に示す以外の名称については，各テンプレートファイルに設定されている値を参照してください。

表3‒35　単一セットアップ機能または追加構築可能環境セットアップ機能の利用時に本番環境に設定される名称

設定先

設定される名称

固定値

説明

Management Server

ホスト名

localhost

Management Serverのホスト名

HCSC-Manager

Manager名

Manager

HCSC-ManagerがManagerを認識するためのHCSC-Manager独自の識別名

PRF

サーバ名

PRF

論理サーバまたはクラスタを識別するための名称

J2EEサーバ

サーバ名

J2EEServer

HCSCサーバをセットアップするJ2EEサーバの名称

クラスタ

クラスタ名

Cluster

クラスタの名称

HCSCサーバ

HCSCサーバ名

HCSC

HCSCサーバの名称

Webサーバ

サーバ名

WebServer

論理サーバまたはクラスタを識別するための名称

(d)　受付の情報

HCSC本番環境簡易セットアップ機能でセットアップした本番環境には，次の表に示す受付の情報が設定されます。

表3‒36　本番環境に設定される受付情報

受付の情報

固定値

標準の同期受付（SessionBean）

OFF

標準の同期受付（Webサービス）

ON

標準の非同期受付（MDB（WS-R））

OFF

標準の非同期受付（MDB（DBキュー））

OFF

ユーザ定義受付

ON

(e)　J2EEサーバの情報

HCSC本番環境簡易セットアップ機能でセットアップした本番環境には，次の表に示すJ2EEサーバの情報が設定されます。

表3‒37　本番環境に設定されるJ2EEサーバの情報

設定先

設定される情報

設定値

設定個所

J2EEサーバ

J2EEサーバの互換モード

V9互換モードの場合

V9

推奨モードの場合

none

SOA.xmlファイルのmanager.j2ee.compatパラメタ

(f)　Webサーバの情報

HCSC本番環境簡易セットアップ機能でセットアップした本番環境には，次の表に示すWebサーバの情報が設定されます。

表3‒38　本番環境に設定されるWebサーバの情報

設定先

設定される情報

設定値

設定個所

Webサーバ

WebサーバのJ2EEサーバとの連携方法

V9互換モードの場合

redirector

推奨モードの場合

reverseproxy

SOA.xmlファイルのmanager.web.send_request_methodパラメタ

(g)　起動時間の情報

HCSC本番環境簡易セットアップ機能でセットアップした本番環境には，次の表に示す起動時間（J2EEサーバの起動から動作確認開始までの時間）の情報が設定されます。

表3‒39　本番環境に設定される起動時間の情報

設定先

設定される情報

固定値

設定個所

運用管理エージェント

J2EEサーバの起動から動作確認開始までの時間

7

運用管理エージェントプロパティファイル（adminagent.properties）のadminagent.j2ee.watch.start_time

3.5.5　HCSC本番環境簡易セットアップで使用する定義ファイル

この項では，HCSC本番環境簡易セットアップで使用する定義ファイルについて説明します。(1)ではこの項での定義ファイルの記載形式について説明します。(2)以降では各定義ファイルを作成・変更するときに編集する項目，およびHCSC本番環境簡易セットアップでデフォルト値と異なる値が設定される項目について説明します。

HCSC本番環境簡易セットアップ機能を利用してセットアップする場合，一部の定義ファイルはテンプレートファイルを利用して作成できます。また，作成した定義ファイルを変更することで，セットアップした情報を変更できます。

HCSC本番環境簡易セットアップで使用する定義ファイルの種類と，テンプレートファイルの提供有無を次の表に示します。この項で説明されていない項目および定義ファイルの詳細については，表の「参照先マニュアル」および「参照個所」に示すマニュアル記載個所を参照してください。

表3‒40　HCSC本番環境簡易セットアップで使用する定義ファイルの種類とテンプレートファイルの提供有無

項番

定義ファイル名

セットアップ時の作成可否

変更可否

テンプレートファイルの有無※1

参照先マニュアル

参照個所

SOAP1.1モード

SOAP1.1/1.2併用モード

1

Manager設定ファイル（manager.cfg）

◎

−

あり

あり

アプリケーションサーバ リファレンス 定義編(サーバ定義)

8.2.9

2

運用管理エージェントプロパティファイル（adminagent.properties）

◎

−

あり

あり

8.2.1

3

Management Server環境設定ファイル（mserver.properties）

◎

−

あり

あり

8.2.6

4

クライアント共通設定プロパティファイル（cmxclient.properties）

◎

−

あり

あり

4.2.3

5

クライアント側共通定義ファイル（mngsvrutilcl.properties）

◎

−

あり

あり

8.2.16

6

snapshotログ一次送付対象定義ファイル（snapshotlog.conf）

○

−

なし

なし

10.2.1

7

snapshotログ二次送付対象定義ファイル（snapshotlog.2.conf）

○

−

なし

なし

10.2.1

8

サーバ定義ファイル（SOAP通信基盤）（c4websv.cfg）

◎

−

あり

なし

アプリケーションサーバ SOAPアプリケーション開発の手引

10.2

9

共通定義ファイル（SOAP通信基盤）（c4webcom.cfg）

◎

−

あり

なし

10.4

10

HCSC-Manager定義ファイル（cscmng.properties）

◎

−

あり

あり

サービスプラットフォーム リファレンス

6.5.3　HCSC-Manager定義ファイル

11

HCSC-Managerコマンド共通定義ファイル（csccmd.properties）

◎

−

あり

あり

6.5.2　HCSC-Managerコマンド共通定義ファイル

12

HCSCサーバ構成定義ファイル（cscsvsetup.xml）

◎

−

あり

あり

6.4.2　HCSCサーバ構成定義ファイル

13

HCSCサーバセットアップ定義ファイル（cscsvsetup.properties）

◎

−

あり

あり

6.4.3　HCSCサーバセットアップ定義ファイル

14

HCSCサーバランタイム定義ファイル（cscsvconfig.properties）

◎

−

あり

あり

6.5.6　HCSCサーバランタイム定義ファイル

15

ユーザ定義受付ランタイム定義ファイル（cscurcptnconfig_id.properties）

△

○※2

あり

あり

6.6.2　ユーザ定義受付ランタイム定義ファイル

16

サービス情報変更定義ファイル（cscadpconfig.properties）

△

○※2

あり

あり

6.5.10　サービス情報変更定義ファイル

17

簡易構築定義ファイル（SOA.xml）

◎

○※2

あり

あり

アプリケーションサーバ リファレンス 定義編(サーバ定義)

4.3

18

HTTP Server定義ファイル（httpsd.conf）

△

×

なし

なし

HTTP Server

特定個所に該当しません。

19

cscsetupコマンド定義ファイル（cscsetup.properties）

○

−

あり

あり

サービスプラットフォーム リファレンス

6.4.1　cscsetupコマンド定義ファイル

（凡例）

◎：必ず作成します。

○：必要に応じて作成および変更します。

△：作成する必要はありません。作成しても無視されます。

×：存在するとエラーになります。削除してください。

−：変更しないでください。

あり：テンプレートファイルを提供しています。

なし：テンプレートファイルを提供していません。

注※1

セットアップ方法によって，使用するテンプレートファイルの場所は次のように異なります。

単一セットアップ機能または追加構築可能環境セットアップ機能を使用する場合

<サービスプラットフォームのインストールディレクトリ>¥CSC¥config¥manager¥templates¥hsetup
　├esb　…SOAP1.1モードのテンプレートファイル
　├esb_1.1_1.2mode
　│　…SOAP1.1/1.2併用モードのテンプレートファイル（V9互換モードの場合）
　├esb_1.1_1.2mode_jdk17
　│　…SOAP1.1/1.2併用モードのテンプレートファイル（推奨モードの場合（JDK 17用））
　└esb_1.1_1.2mode_v11
　　　…SOAP1.1/1.2併用モードのテンプレートファイル（推奨モードの場合（JDK 11用））

追加セットアップ機能を使用する場合

<サービスプラットフォームのインストールディレクトリ>¥CSC¥config¥manager¥templates¥hsetup
　├esb_add　…SOAP1.1モードのテンプレートファイル
　├esb_1.1_1.2mode_add
　│　…SOAP1.1/1.2併用モードのテンプレートファイル（V9互換モードの場合）
　├esb_1.1_1.2mode_jdk17_add
　│　…SOAP1.1/1.2併用モードのテンプレートファイル（推奨モードの場合（JDK 17用））
　└esb_1.1_1.2mode_v11_add
　　　…SOAP1.1/1.2併用モードのテンプレートファイル（推奨モードの場合（JDK 11用））

注※2

変更する定義ファイルと変更する情報の対応を次に示します。

変更する情報

変更する定義ファイル

注意事項

サービス情報

サービス情報変更定義ファイル（cscadpconfig.properties）

定義ファイルのファイル名は変更しないでください。

ユーザ定義受付の定義情報

ユーザ定義受付ランタイム定義ファイル（cscurcptnconfig_id.properties）

（なし）

サーバの定義情報

簡易構築定義ファイル（SOA.xml）

定義ファイルのファイル名は変更しないでください。

構築済みの環境のSOAPモードを変更した場合の動作は保証しません。

(1)　定義ファイルの説明形式

この項での定義ファイルの説明形式を次に示します。

ファイル名

定義ファイルの名称を示します。

説明

定義ファイルの説明を示します。

ファイルの格納先

定義ファイルの格納先を示します。

編集する項目※

定義ファイルを作成・変更するときに編集する項目を示します。

デフォルト値と異なる値が設定される項目※

HCSC本番環境簡易セットアップを利用してセットアップした場合に，デフォルト値と異なる値が設定される項目を示します。

注※

これらの項目の表の内容を次に示します。

カテゴリ

定義ファイルの項目をカテゴリ分けしています。

項目名

定義ファイルを作成・変更するときに編集する項目，およびHCSC本番環境簡易セットアップでデフォルト値と異なる値が設定される項目の名称を示します。

<param-name>に指定する（または，指定されている）パラメタ

<param-name>タグに指定するパラメタ，または指定されているパラメタを示します。簡易構築定義ファイル（SOA.xml）にだけ該当します。

デフォルト値

定義ファイルのデフォルト値を示します。項目の値を省略した場合は，デフォルト値が仮定されます。

HCSC本番環境簡易セットアップで設定される値

HCSC本番環境簡易セットアップを利用してセットアップした場合に，定義ファイルに設定される値を示します。

説明

項目の説明を示します。

<param-value>に指定する内容

<param-value>タグに指定する内容を示します。簡易構築定義ファイル（SOA.xml）にだけ該当します。

(2)　Manager設定ファイル

ファイル名

manager.cfg

説明

Management Server，運用管理エージェント，それぞれで動作するコンポーネントやコマンドに共通な設定をします。

編集する項目

項目名

デフォルト値

HCSC本番環境簡易セットアップで設定される値

説明

com.cosminexus.manager.log.dir※

<Managerのインストールディレクトリ>¥log

−

Managerのログ出力ディレクトリを指定します。

（凡例）

−：ありません。

注※

セットアップ時に編集する項目です。

デフォルト値と異なる値が設定される項目

項目名

デフォルト値

HCSC本番環境簡易セットアップで設定される値

説明

com.cosminexus.manager.log.compatible

true

false

Managerのログの上位互換性を指定します。

(3)　運用管理エージェントプロパティファイル

ファイル名

adminagent.properties

説明

運用管理エージェント本体に関する設定をします。

編集する項目

項目名

デフォルト値

HCSC本番環境簡易セットアップで設定される値

説明

adminagent.adapter.port※

20295

20295

運用管理エージェントが使用するポート番号を指定します。簡易構築定義ファイル（SOA.xml）の<host>下の<agent-port>の値と合わせる必要があります。

adminagent.snapshotlog.log_dir※

<manager.cfgのcom.cosminexus.manager.log.dirで指定したディレクトリ>¥snapshot

−

snapshotログの出力先ディレクトリを文字列で指定します。

adminagent.j2ee.watch.interval

10

10

J2EEサーバの動作確認間隔を秒単位で指定します。

adminagent.hws.watch.interval

10

10

HTTP Serverの動作確認間隔を秒単位で指定します。

adminagent.j2ee.watch.retry_count

1

1

J2EEサーバの動作確認で，動作確認処理に失敗した場合にリトライする回数を指定します。

adminagent.hws.watch.retry_count

1

1

HTTP Serverサーバの動作確認で，動作確認処理に失敗した場合にリトライする回数を指定します。

adminagent.hws.watch.start_time

0

0

HTTP Serverの起動で，起動コマンドを実行してから動作確認を開始するまでの時間を秒単位で指定します。

adminagent.j2ee.watch.timeout

60

60

J2EEサーバの動作確認で，タイムアウトするまでの時間を秒単位で指定します。

adminagent.hws.watch.timeout

60

60

HTTP Serverの動作確認で，タイムアウトするまでの時間を秒単位で指定します。

（凡例）

−：ありません。

注※

セットアップ時に編集する項目です。

デフォルト値と異なる値が設定される項目

項目名

デフォルト値

HCSC本番環境簡易セットアップで設定される値

説明

adminagent.adapter.allowedHosts

−

localhost

サーバへのアクセスを許可するホスト名またはIPアドレスを指定します。

adminagent.adapter.bind_host

localhost

−

運用管理エージェントとの通信で使用するホスト名またはIPアドレスを指定します。

adminagent.hws.watch.method

HEAD

OPTIONS

adminagent.hws.watch.levelで2を指定したときのHTTP Serverの動作確認用HTTPメソッドを指定します。

adminagent.snapshotlog.num_snapshots

10

4

一次資料として収集する，論理サーバごとのsnapshotログファイル数を指定します。

adminagent.snapshotlog.listfile.2.num_snapshots

10

4

二次資料として収集する，論理サーバごとのsnapshotログファイル数を指定します。

adminagent.j2ee.process.console_log.enabled

false

true

J2EEサーバのコンソール出力情報をコンソールログに出力するかどうかを指定します。

adminagent.j2ee.watch.start_time

45

7

J2EEサーバの起動で，起動コマンドを実行してから動作確認を開始するまでの時間を秒単位で指定します。

（凡例）

−：ありません。

(4)　Management Server環境設定ファイル

ファイル名

mserver.properties

説明

Management Serverが使用するポート番号の設定や，障害検知時コマンドの動作を設定します。

編集する項目

カテゴリ

項目名

デフォルト値

HCSC本番環境簡易セットアップで設定される値

説明

Management Serverが使用するポート番号の設定

webserver.connector.ajp13.port※

−

28009

Management Server内部通信用ポート番号を指定します。

webserver.connector.http.port※

−

28080

Management Server接続HTTPポート番号を指定します。クライアント共通設定プロパティファイル（cmxclient.properties）のcmx.connect.hostの値と，クライアント側共通定義ファイル（mngsvrutilcl.properties）のmngsvrutil.connect.hostの値と合わせる必要があります。

webserver.shutdown.port※

−

28005

Management Server終了要求受信ポート番号を指定します。

ejbserver.naming.port※

28900

28900

Management Serverが内部の管理用に使用するポート番号を指定します。

webserver.connector.http.permitted.hosts※

未定義の場合：*

未設定の場合：localhost

*

Management Serverへのアクセスを許可するホストおよび運用管理エージェント稼働ホストのIPアドレスまたはホスト名を指定します。

障害検知時コマンドの動作の設定

com.cosminexus.mngsvr.management.port※

28099

28099

Management Serverリモート管理機能への外部接続ポート番号を指定します。

com.cosminexus.mngsvr.management.listen.port※

0

0

Management Serverリモート管理機能への外部接続時に作成する，クライアント接続用のポート番号を指定します。

HCSCの動作モードの設定

ejbserver.server.edition.settingforce

Smart

−

Management ServerをHCSC-Managerから利用するか否かを指定します。

Smart

Management ServerをHCSC-Managerから利用しない。

＜指定なし＞

Management ServerをHCSC-Managerから利用する。

Smartが設定されるとejbserver.naming.portの設定は無視されます。

（凡例）

−：ありません。

注※

セットアップ時に編集する項目です。

デフォルト値と異なる値が設定される項目

カテゴリ

項目名

デフォルト値

HCSC本番環境簡易セットアップで設定される値

説明

障害検知時コマンドの動作の設定

com.cosminexus.mngsvr.management.enabled

false

true

Management Serverリモート管理機能を有効にするかどうかを指定します。

com.cosminexus.mngsvr.management.connector.enabled

false

true

Management Serverリモート管理機能への外部接続を有効にするかどうかを指定します。

com.cosminexus.mngsvr.management.host

−

localhost

Management Serverリモート管理機能への外部接続のホスト固定を行う場合に，ホスト名，またはIPアドレスを指定します。

java.rmi.server.hostname

−

localhost

Management Serverリモート管理機能への外部接続のホスト固定を行う場合に，ホスト名，またはIPアドレスを指定します。

（凡例）

−：ありません。

(5)　クライアント共通設定プロパティファイル

ファイル名

cmxclient.properties

説明

Smart Composer機能で提供するコマンドの共通引数のデフォルト値を設定します。すべてのクライアントで共通のデフォルト値を設定する場合に使用します。

編集する項目

項目名

デフォルト値

HCSC本番環境簡易セットアップで設定される値

説明

cmx.apply_user※

−

SYSTEM,Administrator

このファイルを適用するクライアントのOSのユーザIDを指定します。

cmx.connect.host※

−

localhost:28080

共通引数の-mオプション省略時に仮定するホスト名，およびポート番号を指定します。Management Server環境設定ファイル（mserver.properties）のwebserver.connector.http.portの値と，クライアント側共通定義ファイル（mngsvrutilcl.properties）のmngsvrutil.connect.hostの値と合わせる必要があります。

（凡例）

−：ありません。

注※

セットアップ時に編集する項目です。

デフォルト値と異なる値が設定される項目

項目名

デフォルト値

HCSC本番環境簡易セットアップで設定される値

説明

cmx.connect.userid

−

admin

共通引数の-uオプション省略時に仮定するユーザIDを指定します。

cmx.connect.passwd

−

admin

共通引数の-pオプション省略時に仮定するパスワードを指定します。

cmx.verbose

false

true

共通引数の-verboseオプションをデフォルトにする場合はtrueを，-noverboseオプションをデフォルトにする場合はfalseを指定します。

cmx.websystem.name

−

SOA

次に示すコマンドの-sオプション省略時に，Webシステム名を設定します。

cmx_build_system

cmx_delete_system

cmx_list_model

cmx_list_status

cmx_resume_lb

cmx_start_target

cmx_stop_target

cmx_test_lb

（凡例）

−：ありません。

(6)　クライアント側共通定義ファイル

ファイル名

mngsvrutilcl.properties

説明

mngsvrutilコマンドのオプションのデフォルト値を共通定義として設定します。

編集する項目

項目名

デフォルト値

HCSC本番環境簡易セットアップで設定される値

説明

mngsvrutil.apply_user※

−

SYSTEM,Administrator

mngsvrutilコマンドまたはアダプタコマンドを実行する時のOSユーザで，クライアント側共通定義ファイルを適用するユーザを指定します。

mngsvrutil.connect.host※

−

localhost:28080

mngsvrutilコマンドの-mオプションに指定するManagement Serverのホスト名，およびポート番号を指定します。Management Server環境設定ファイル（mserver.properties）のwebserver.connector.http.portの値と，クライアント共通設定プロパティファイル（cmxclient.properties）のcmx.connect.hostの値と合わせる必要があります。

（凡例）

−：ありません。

注※

セットアップ時に編集する項目です。

デフォルト値と異なる値が設定される項目

項目名

デフォルト値

HCSC本番環境簡易セットアップで設定される値

説明

mngsvrutil.connect.password

−

admin

mngsvrutilコマンドの-pオプションに指定するパスワードを指定します。

mngsvrutil.connect.userid

−

admin

mngsvrutilコマンドの-uオプションに指定するユーザIDを指定します。

mngsvrutil.target_name

−

J2EEServer

mngsvrutilコマンドの-tオプションに指定する論理サーバ名またはホスト名を指定します。

（凡例）

−：ありません。

(7)　snapshotログ一次送付対象定義ファイル

ファイル名

snapshotlog.conf

説明

snapshotログとして収集する一次送付資料の対象ファイルを定義します。このファイルはテンプレートファイルを提供していません。

ファイルの格納先

<サービスプラットフォームのインストールディレクトリ>¥manager¥config

編集する項目

カテゴリ

項目名

デフォルト値

HCSC本番環境簡易セットアップで設定される値

説明

収集対象ディレクトリ

%val%※

−

−

HCSC-Managerのログファイルの出力先を指定します。

cscmng.propertiesのcscmng.log.dirをカスタマイズした場合，次の2つの値を追加してください。カスタマイズしていない場合，ログファイルの出力先がすでに指定されているため，追加する必要はありません。

cscmng.log.dirの定義値に「/.+」を追加した値

cscmng.log.dirの定義値に「/mmap/.+」を追加した値

（設定例）

cscmng.log.dirがD:/Home/log/Manager/HCSCManagerの場合

D:/Home/log/Manager/HCSCManager/.+

D:/Home/log/Manager/HCSCManager/mmap/.+

（凡例）

−：ありません。

注※

セットアップ時に編集する項目です。

デフォルト値と異なる値が設定される項目

なし

(8)　snapshotログ二次送付対象定義ファイル

ファイル名

snapshotlog.2.conf

説明

snapshotログとして収集する二次送付資料の対象ファイルを定義します。このファイルはテンプレートファイルを提供していません。

ファイルの格納先

<サービスプラットフォームのインストールディレクトリ>¥manager¥config

編集する項目

カテゴリ

項目名

デフォルト値

HCSC本番環境簡易セットアップで設定される値

説明

収集対象ディレクトリ

%val%※

−

−

HCSC-Managerのバックアップファイルの出力先を指定します。

cscmng.propertiesのcscmng.backup.dirをカスタマイズした場合，次の値を追加してください。カスタマイズしていない場合，バックアップファイルの出力先がすでに指定されているため，追加する必要はありません。

cscmng.backup.dirの定義値に「/.+」を追加した値

（設定例）

cscmng.backup.dirがD:/Home/log/Manager/HCSCManager/backupの場合

D:/Home/log/Manager/HCSCManager/backup/.+

%val%※

−

−

リポジトリの配置場所を指定します。

cscmng.propertiesのcscmng.repository.dirをカスタマイズした場合，次の3つの値を追加してください。カスタマイズしていない場合，リポジトリの配置場所がすでに指定されているため，追加する必要はありません。

cscmng.repository.dirの定義値に「/.+」を追加した値

cscmng.repository.dirの定義値に「/.+/.+」を追加した値

cscmng.repository.dirの定義値に「/.+/.+/.+」を追加した値

（設定例）

cscmng.repository.dirがD:/Home/work/Manager/HCSCManager/repositoryの場合

D:/Home/work/Manager/HCSCManager/repository/.+

D:/Home/work/Manager/HCSCManager/repository/.+/.+

D:/Home/work/Manager/HCSCManager/repository/.+/.+/.+

（凡例）

−：ありません。

注※

セットアップ時に編集する項目です。

デフォルト値と異なる値が設定される項目

なし

(9)　サーバ定義ファイル（SOAP通信基盤）

ファイル名

c4websv.cfg

説明

SOAP通信基盤のサーバ側の動作に必要となる情報を設定します。

編集する項目

なし

デフォルト値と異なる値が設定される項目

なし

(10)　共通定義ファイル（SOAP通信基盤）

ファイル名

c4webcom.cfg

説明

SOAP通信基盤のサーバおよびクライアント共通の動作に必要となる情報を設定します。

編集する項目

なし

デフォルト値と異なる値が設定される項目

カテゴリ

項目名

デフォルト値

HCSC本番環境簡易セットアップで設定される値

説明

ログ設定

c4web.logger.aplog_error_record

NONE

ALL

異常発生時のアプリケーションログ出力の指定をします。

(11)　HCSC-Manager定義ファイル

ファイル名

cscmng.properties

説明

HCSC-Managerの動作に必要となる情報を設定します。

(a)　単一セットアップの場合

単一セットアップの場合の項目について説明します。

編集する項目

カテゴリ

項目名

デフォルト値

HCSC本番環境簡易セットアップで設定される値

説明

リポジトリ設定

cscmng.repository.root※

<サービスプラットフォームのインストールディレクトリ>¥CSC¥repository

−

リポジトリのルートディレクトリを絶対パスで指定します。

ログ設定

cscmng.log.dir※

<サービスプラットフォームのインストールディレクトリ>¥CSC¥log¥manager

−

ログ出力先ディレクトリを絶対パスで指定します。

環境バックアップ

cscmng.envbackup.dir※

カレントディレクトリ

−

cscenvbackupコマンドで環境をバックアップする場合，環境バックアップファイルの出力先ディレクトリを指定します。

（凡例）

−：ありません。

注※

セットアップ時に編集する項目です。

デフォルト値と異なる値が設定される項目

カテゴリ

項目名

デフォルト値

HCSC本番環境簡易セットアップで設定される値

説明

HCSCサーバ運用設定

cscmng.server.HCSC.system

−

WebServer,PRF

HCSCシステムの管理下におく論理サーバを指定します。

（凡例）

−：ありません。

(b)　追加構築可能環境セットアップの場合

追加構築可能環境セットアップの場合の項目について説明します。

編集する項目

カテゴリ

項目名

デフォルト値

HCSC本番環境簡易セットアップで設定される値

説明

リポジトリ設定

cscmng.repository.root※

%CSCMNG_HOME%¥CSC¥repository

−

リポジトリのルートディレクトリを絶対パスで指定します。

ログ設定

cscmng.log.dir※

%CSCMNG_HOME%¥CSC¥log¥manager

−

ログ出力先ディレクトリを絶対パスで指定します。

環境バックアップ

cscmng.envbackup.dir※

カレントディレクトリ

−

cscenvbackupコマンドで環境をバックアップする場合，環境バックアップファイルの出力先ディレクトリを指定します。

（凡例）

−：ありません。

注※

セットアップ時に編集する項目です。

デフォルト値と異なる値が設定される項目

カテゴリ

項目名

デフォルト値

HCSC本番環境簡易セットアップで設定される値

説明

HCSCサーバ運用設定

cscmng.server.<HCSCサーバ名>.system

−

WebServer,PRF

HCSCシステムの管理下におく論理サーバを指定します。

（凡例）

−：ありません。

(c)　追加セットアップの場合

追加セットアップの場合の項目について説明します。

編集する項目

カテゴリ

項目名

デフォルト値

HCSC本番環境簡易セットアップで設定される値

説明

リポジトリ設定

cscmng.repository.root※

%CSCMNG_HOME%¥CSC¥repository

−

リポジトリのルートディレクトリを絶対パスで指定します。

ログ設定

cscmng.log.dir※

%CSCMNG_HOME%¥CSC¥log¥manager

−

ログ出力先ディレクトリを絶対パスで指定します。

環境バックアップ

cscmng.envbackup.dir※

カレントディレクトリ

−

cscenvbackupコマンドで環境をバックアップする場合，環境バックアップファイルの出力先ディレクトリを指定します。

（凡例）

−：ありません。

注※

セットアップ時に編集する項目です。

デフォルト値と異なる値が設定される項目

カテゴリ

項目名

デフォルト値

HCSC本番環境簡易セットアップで設定される値

説明

HCSCサーバ運用設定

cscmng.server.<HCSCサーバ名>.system

−

WebServer2,PRF2

HCSCシステムの管理下におく論理サーバを指定します。

環境バックアップ

cscmng.envbackup.dir.envrestore

%CSCMNG_HOME%¥spool¥manager

−

cscenvbackupコマンドで環境をバックアップする場合，環境バックアップファイルの出力先ディレクトリを指定します。

cscmng.envbackup.dir.import

%CSCMNG_HOME%¥spool¥manager

−

cscrepctlコマンドで-importオプションを指定してリポジトリをインポートする場合，インポート前の環境バックアップファイルの出力先ディレクトリを指定します。

（凡例）

−：ありません。

(12)　HCSC-Managerコマンド共通定義ファイル

ファイル名

csccmd.properties

説明

サービスプラットフォームで使用する各コマンドのオプションのデフォルト値を設定します。

(a)　単一セットアップの場合

単一セットアップの場合の項目について説明します。

編集する項目

なし

デフォルト値と異なる値が設定される項目

カテゴリ

項目名

デフォルト値

HCSC本番環境簡易セットアップで設定される値

説明

コマンド共通定義

csc.all.user

−

admin

すべてのコマンドに共通する引数のデフォルト値を指定します。

csc.all.pass

−

admin

csccompoconfig共通定義

csc.compoconfig.operation

−

get

コマンドのデフォルト引数を指定します。

csc.compoconfig.csc

−

HCSC

csccompodeploy共通定義

csc.compodeploy.csc

−

HCSC

csccompostart共通定義

csc.compostart.csc

−

HCSC

csccompostop共通定義

csc.compostop.csc

−

HCSC

csccompoundeploy共通定義

csc.compoundeploy.csc

−

HCSC

cscrcptnstart共通定義

csc.rcptnstart.csc

−

HCSC

cscrcptnstop共通定義

csc.rcptnstop.csc

−

HCSC

cscresinfo共通定義

csc.resinfo.csc

−

HCSC

cscstatus共通定義

csc.status.csc

−

HCSC

csc.status.type

−

system

cscsvconfig共通定義

csc.svconfig.operation

−

get

csc.svconfig.csc

−

HCSC

cscsvstart共通定義

csc.svstart.csc

−

HCSC

cscsvstop共通定義

csc.svstop.csc

−

HCSC

csc.svstop.force

−

未設定

（凡例）

−：ありません。

(b)　追加構築可能環境セットアップの場合

追加構築可能環境セットアップの場合の項目について説明します。

編集する項目

なし

デフォルト値と異なる値が設定される項目

カテゴリ

項目名

デフォルト値

HCSC本番環境簡易セットアップで設定される値

説明

コマンド共通定義

csc.all.user

−

admin

すべてのコマンドに共通する引数のデフォルト値を指定します。

csc.all.pass

−

admin

csccompoconfig共通定義

csc.compoconfig.operation

−

get

コマンドのデフォルト引数を指定します。

csc.compoconfig.csc

−

HCSC

csccompodeploy共通定義

csc.compodeploy.csc

−

HCSC

csccompostart共通定義

csc.compostart.csc

−

HCSC

csccompostop共通定義

csc.compostop.csc

−

HCSC

csccompoundeploy共通定義

csc.compoundeploy.csc

−

HCSC

cscrcptnstart共通定義

csc.rcptnstart.csc

−

HCSC

cscrcptnstop共通定義

csc.rcptnstop.csc

−

HCSC

cscresinfo共通定義

csc.resinfo.csc

−

HCSC

cscstatus共通定義

csc.status.csc

−

HCSC

csc.status.type

−

system

cscsvconfig共通定義

csc.svconfig.operation

−

get

csc.svconfig.csc

−

HCSC

cscsvstart共通定義

csc.svstart.csc

−

HCSC

cscsvstop共通定義

csc.svstop.csc

−

HCSC

csc.svstop.force

−

未設定

（凡例）

−：ありません。

(c)　追加セットアップの場合

追加セットアップの場合の項目について説明します。

編集する項目

カテゴリ

項目名

デフォルト値

HCSC本番環境簡易セットアップで設定される値

説明

csccompoconfig共通定義

csc.compoconfig.csc

−

HCSC2

コマンドのデフォルト引数を指定します。

コマンド識別子はコマンド名から「csc」を除いた値を指定してください。コマンド引数名はハイフン（-）を除いた値を指定してください。値がない場合は値の指定は不要です。

csccompodeploy共通定義

csc.compodeploy.csc

−

HCSC2

csccompostart共通定義

csc.compostart.csc

−

HCSC2

csccompostop共通定義

csc.compostop.csc

−

HCSC2

csccompoundeploy共通定義

csc.compoundeploy.csc

−

HCSC2

cscrcptnstart共通定義

csc.rcptnstart.csc

−

HCSC2

cscrcptnstop共通定義

csc.rcptnstop.csc

−

HCSC2

cscresinfo共通定義

csc.resinfo.csc

−

HCSC2

cscstatus共通定義

csc.status.csc

−

HCSC2

cscsvconfig共通定義

csc.svconfig.csc

−

HCSC2

cscsvstart共通定義

csc.svstart.csc

−

HCSC2

cscsvstop共通定義

csc.svstop.csc

−

HCSC2

（凡例）

−：ありません。

デフォルト値と異なる値が設定される項目

カテゴリ

項目名

デフォルト値

HCSC本番環境簡易セットアップで設定される値

説明

コマンド共通定義

csc.all.user

−

admin

すべてのコマンドに共通する引数のデフォルト値を指定します。

csc.all.pass

−

admin

csccompoconfig共通定義

csc.compoconfig.operation

−

get

コマンドのデフォルト引数を指定します。

csc.compoconfig.csc

−

HCSC2

csccompodeploy共通定義

csc.compodeploy.csc

−

HCSC2

csccompostart共通定義

csc.compostart.csc

−

HCSC2

csccompostop共通定義

csc.compostop.csc

−

HCSC2

csccompoundeploy共通定義

csc.compoundeploy.csc

−

HCSC2

cscrcptnstart共通定義

csc.rcptnstart.csc

−

HCSC2

cscrcptnstop共通定義

csc.rcptnstop.csc

−

HCSC2

cscresinfo共通定義

csc.resinfo.csc

−

HCSC2

cscstatus共通定義

csc.status.csc

−

HCSC2

csc.status.type

−

system

cscsvconfig共通定義

csc.svconfig.operation

−

get

csc.svconfig.csc

−

HCSC2

cscsvstart共通定義

csc.svstart.csc

−

HCSC2

cscsvstop共通定義

csc.svstop.csc

−

HCSC2

csc.svstop.force

−

未設定

（凡例）

−：ありません。

(13)　HCSCサーバ構成定義ファイル

ファイル名

cscsvsetup.xml

説明

HCSCサーバの構成情報を設定します。

(a)　単一セットアップの場合

単一セットアップの場合の項目について説明します。

編集する項目

カテゴリ

項目名

デフォルト値

HCSC本番環境簡易セットアップで設定される値

説明

managerの定義

<port>Managerのポート番号</port>※

28099

28099

Managerのリモート管理機能への接続ポート番号を指定します。Management Server環境設定ファイル（mserver.properties）のcom.cosminexus.mngsvr.management.portの値と合わせる必要があります。

注※

セットアップ時に編集する項目です。

デフォルト値と異なる値が設定される項目

カテゴリ

項目名

デフォルト値

HCSC本番環境簡易セットアップで設定される値

説明

clusterの定義

<name>クラスタ名</name>

−

Cluster

クラスタ名を指定します。

managerの定義

<name>Manager名</name>

−

Manager

HCSC-ManagerがManagerを認識するためのHCSC-Manager独自の識別名を指定します。

<ip-address>ManagerのIPアドレスまたはホスト名</ip-address>

−

localhost

Management Serverが起動しているIPアドレスまたはホスト名を指定します。

<id>Managerの管理ユーザID</id>

−

admin

Management Serverの管理ユーザIDを指定します。

<password>Management Serverの管理ユーザパスワード</password>

−

admin

Management Serverの管理ユーザパスワードを指定します。

csc-serverの定義

<name>HCSCサーバ名</name>

−

HCSC

HCSCサーバ名を指定します。

<j2ee-server-name>HCSCサーバをセットアップするJ2EEサーバ名</j2ee-server-name>

−

J2EEServer

HCSCサーバをセットアップするJ2EEサーバ名を指定します。

<setup-properties>HCSCサーバセットアップ定義ファイル名</setup-properties>

−

cscsvsetup.properties

HCSCサーバセットアップ定義ファイル名を相対パス，または絶対パスで指定します。

soap-receptionの定義

<ip-address>WebサーバのIPアドレスまたはホスト名</ip-address>

−

localhost

Webサーバが起動しているIPアドレスまたはホスト名を指定します。

<port>Webサーバのポート番号</port>

−

80

Webサーバの受付ポート番号を指定します。

<protocol>プロトコル種別</protocol>

−

http

Webサーバの受付プロトコルを指定します。

（凡例）

−：ありません。

(b)　追加構築可能環境セットアップの場合

追加構築可能環境セットアップの場合の項目について説明します。

編集する項目

カテゴリ

項目名

デフォルト値

HCSC本番環境簡易セットアップで設定される値

説明

managerの定義

<port>Managerのポート番号</port>※

28099

28099

Managerのリモート管理機能への接続ポート番号を指定します。Management Server環境設定ファイル（mserver.properties）のcom.cosminexus.mngsvr.management.portの値と合わせる必要があります。

注※

セットアップ時に編集する項目です。

デフォルト値と異なる値が設定される項目

カテゴリ

項目名

デフォルト値

HCSC本番環境簡易セットアップで設定される値

説明

clusterの定義

<name>クラスタ名</name>

−

Cluster

クラスタ名を指定します。

managerの定義

<name>Manager名</name>

−

Manager

HCSC-ManagerがManagerを認識するためのHCSC-Manager独自の識別名を指定します。

<ip-address>ManagerのIPアドレスまたはホスト名</ip-address>

−

localhost

Management Serverが起動しているIPアドレスまたはホスト名を指定します。

<id>Managerの管理ユーザID</id>

−

admin

Management Serverの管理ユーザIDを指定します。

<password>Management Serverの管理ユーザパスワード</password>

−

admin

Management Serverの管理ユーザパスワードを指定します。

csc-serverの定義

<name>HCSCサーバ名</name>

−

HCSC

HCSCサーバ名を指定します。

<j2ee-server-name>HCSCサーバをセットアップするJ2EEサーバ名</j2ee-server-name>

−

J2EEServer

HCSCサーバをセットアップするJ2EEサーバ名を指定します。

<setup-properties>HCSCサーバセットアップ定義ファイル名</setup-properties>

−

cscsvsetup.properties

HCSCサーバセットアップ定義ファイル名を相対パス，または絶対パスで指定します。

soap-receptionの定義

<ip-address>WebサーバのIPアドレスまたはホスト名</ip-address>

−

localhost

Webサーバが起動しているIPアドレスまたはホスト名を指定します。

<port>Webサーバのポート番号</port>

−

80

Webサーバの受付ポート番号を指定します。

<protocol>プロトコル種別</protocol>

−

http

Webサーバの受付プロトコルを指定します。

（凡例）

−：ありません。

(c)　追加セットアップの場合

追加セットアップの場合の項目について説明します。

編集する項目

カテゴリ

項目名

デフォルト値

HCSC本番環境簡易セットアップで設定される値

説明

managerの定義

<port>Managerのポート番号</port>※

28099

28099

Managerのリモート管理機能への接続ポート番号を指定します。Management Server環境設定ファイル（mserver.properties）のcom.cosminexus.mngsvr.management.portの値と合わせる必要があります。

注※

セットアップ時に編集する項目です。

デフォルト値と異なる値が設定される項目

カテゴリ

項目名

デフォルト値

HCSC本番環境簡易セットアップで設定される値

説明

clusterの定義

<name>クラスタ名</name>

−

Cluster2

クラスタ名を指定します。

csc-serverの定義

<name>HCSCサーバ名</name>

−

HCSC2

HCSCサーバ名を指定します。

<j2ee-server-name>HCSCサーバをセットアップするJ2EEサーバ名</j2ee-server-name>

−

J2EEServer2

HCSCサーバをセットアップするJ2EEサーバ名を指定します。

soap-receptionの定義

<port>Webサーバのポート番号</port>

−

1024

Webサーバの受付ポート番号を指定します。

（凡例）

−：ありません。

(14)　HCSCサーバセットアップ定義ファイル

ファイル名

cscsvsetup.properties

説明

HCSCサーバのセットアップ時に設定できる内容を設定します。

(a)　単一セットアップの場合

単一セットアップの場合の項目について説明します。

編集する項目

なし

デフォルト値と異なる値が設定される項目

カテゴリ

項目名

デフォルト値

HCSC本番環境簡易セットアップで設定される値

説明

セットアップ構成関連

db-use

ON

OFF

HCSCサーバでデータベースを使用するかどうかを指定します。

rm-use

ON

OFF

HCSCサーバでReliable Messagingを使用するかどうかを指定します。

標準受付関連

request-ejb

−

OFF

標準の同期受付（SessionBean）を使用するかどうかを指定します。

request-soap

−

ON

標準の同期受付（Webサービス）を使用するかどうかを指定します。

request-jms

−

OFF

標準の非同期受付（MDB（WS-R））を使用するかどうかを指定します。

request-dbq

−

OFF

標準の非同期受付（MDB（DBキュー））を使用するかどうかを指定します。

ユーザ定義受付関連

request-userdef-soap

OFF

ON

SOAP受付を使用するかどうかを指定します。

（凡例）

−：ありません。

(b)　追加セットアップの場合

追加セットアップの場合の項目について説明します。

編集する項目

なし

デフォルト値と異なる値が設定される項目

カテゴリ

項目名

デフォルト値

HCSC本番環境簡易セットアップで設定される値

説明

J2EE関連

naming-service-port

900

1025

ネーミングサービスのポート番号を指定します。Cosminexusでの設定値に依存します。このプロパティの指定を省略した場合，cscsvsetupコマンドによって自動的にポート番号が設定されます。

(15)　HCSCサーバランタイム定義ファイル

ファイル名

cscsvconfig.properties

説明

セットアップ後のHCSCサーバの定義情報をHCSC-Managerから設定します。

(a)　単一セットアップの場合

単一セットアップの場合の項目について説明します。

編集する項目

なし

デフォルト値と異なる値が設定される項目

カテゴリ

項目名

デフォルト値

HCSC本番環境簡易セットアップで設定される値

説明

データ変換

xmltelegram-namespace-complement

OFF

ON

HCSCサーバ内を流れるXML電文に対して，XML電文内の属性値に指定された名前空間接頭辞に対応した名前空間宣言を補完するかどうかを指定します。

(b)　追加セットアップの場合

追加セットアップの場合の項目について説明します。

編集する項目

なし

デフォルト値と異なる値が設定される項目

カテゴリ

項目名

デフォルト値

HCSC本番環境簡易セットアップで設定される値

説明

データ変換

xmltelegram-namespace-complement

OFF

ON

HCSCサーバ内を流れるXML電文に対して，XML電文内の属性値に指定された名前空間接頭辞に対応した名前空間宣言を補完するかどうかを指定します。

(16)　ユーザ定義受付ランタイム定義ファイル

ファイル名

cscurcptnconfig_id.properties

説明

SOAP受付の情報を設定します。

ユーザ定義受付ランタイム定義ファイルを使用する際は，ファイル名を「cscurcptnconfig_<受付ID>.properties」に変更して実行してください。受付IDが「rcp1」の場合は，ファイル名を「cscurcptnconfig_rcp1.properties」に変更して実行してください。なお，変更するSOAP受付が複数存在する場合は，SOAP受付単位に複数のファイルを作成してください。

編集する項目

項目名

デフォルト値

HCSC本番環境簡易セットアップで設定される値

説明

user-defined-reception-soap.threads.maximum※

10

20

SOAP受付の最大同時実行数を指定します。

user-defined-reception-soap.exclusive.threads※

0

0

SOAP受付の占有スレッド数を指定します。

user-defined-reception-soap.queue-size※

8192

10

SOAP受付の実行待ちキューのサイズを指定します。

注※

チューニング時に編集する項目です。

デフォルト値と異なる値が設定される項目

なし

(17)　サービス情報変更定義ファイル

ファイル名

cscadpconfig.properties

説明

サービスアダプタのサービス情報の変更を設定します。

編集する項目

カテゴリ

項目名

デフォルト値

HCSC本番環境簡易セットアップで設定される値

説明

SOAPアダプタのサービス情報

Cluster.<サービスID>.WebService.url※1

サービスアダプタ開発時の値

−

サービス部品の呼び出しに使用するURLを指定します。

Cluster.<サービスID>.WebService.c4web.application.socket_read_timeout※2

300

−

SOAP1.1モードで使用します。

サービスアダプタのソケットの読み込みタイムアウト値を秒単位で指定します。

Cluster.<サービスID>.WebService.com.cosminexus.csc.request.timeout※2

300

−

SOAP1.1/1.2併用モードで使用します。

サービスアダプタのソケットの読み込みタイムアウト値を秒単位で指定します。

（凡例）

−：ありません。

注※1

セットアップ時に編集する項目です。

注※2

チューニング時に編集する項目です。

デフォルト値と異なる値が設定される項目

なし

(18)　簡易構築定義ファイル

ファイル名

SOA.xml

説明

Webシステムを定義します。

(a)　単一セットアップと追加構築可能環境セットアップの場合

単一セットアップと追加構築可能環境セットアップの場合の項目について説明します。

編集する項目

カテゴリ

<param-name>に指定するパラメタ

デフォルト値

HCSC本番環境簡易セットアップで設定される値

<param-value>に指定する内容

サービスユニットの定義/HTTP Serverの定義/論理サーバ共通のコンフィグレーション定義

mstartup.force.watchtime

60

60

論理サーバの強制停止監視時間を秒単位で指定します。

mstartup.restartcnt

1

1

論理サーバの自動再起動回数を指定します。

mstartup.retrywait

60

60

論理サーバの自動再起動リトライ間隔を秒単位で指定します。

mstartup.start.watchtime

600

60

論理サーバの起動監視時間を秒単位で指定します。

mstartup.watchtime

60

60

論理サーバの停止監視時間を秒単位で指定します。

サービスユニットの定義/HTTP Serverの定義/HTTP Serverのコンフィグレーション定義/Webサーバ用定義

Listen※1

−

80

リクエストを受け付けるIPアドレス，およびポート番号を指定します。

ThreadsPerChild※2

50

50

サーバとして起動するスレッド数を指定します。この定義は，Windowsの場合だけ指定してください。

サービスユニットの定義/HTTP Serverの定義/HTTP Serverのコンフィグレーション定義/HTTP Server用リダイレクタ動作定義

JkLogFileDir※1

logs

−

ログファイルの出力先ディレクトリを指定します。

Windowsの場合，パス区切り文字として「¥」を使用してください。スラッシュ（/）は指定できないため注意してください。

UNIXの場合，絶対パスで指定してください。

JkTraceLogFileDir※1

logs

−

保守用トレースログファイルの出力先ディレクトリを指定します。

Windowsの場合，パス区切り文字として「¥」を使用してください。スラッシュ（/）は指定できないため注意してください。

UNIXの場合，絶対パスで指定してください。

サービスユニットの定義/HTTP Serverの定義/HTTP Serverのコンフィグレーション定義/ワーカ定義

worker.default.cachesize※2

64

40

リダイレクタで再利用するワーカとのコネクション数を指定します。この定義は，Windowsの場合だけ指定してください。

worker.default.port※1

−

8007

ワーカのポート番号を指定します。簡易構築定義ファイル（SOA.xml）のwebserver.connector.ajp13.portの値と合わせる必要があります。

worker.default.receive_timeout※2

3600

3600

通信タイムアウト値を秒単位で指定します。

サービスユニットの定義/HTTP Serverの定義/HTTP Serverのコンフィグレーション定義/HTTP Serverのログの出力定義

CustomDivideFileNum※1

8

8

分割したログファイルのファイル数を指定します。

HttpsdLogFileDir※1

logs

−

Webサーバの出力するログの出力先ディレクトリを指定します。Windowsの場合，パス区切り文字として「¥」を使用してください。スラッシュ（/）は指定できないため注意してください。

サービスユニットの定義/J2EEサーバの定義/論理サーバ共通のコンフィグレーション定義

mstartup.force.watchtime

60

60

論理サーバの強制停止監視時間を秒単位で指定します。

mstartup.restartcnt

1

1

論理サーバの自動再起動回数を指定します。

mstartup.retrywait

60

60

論理サーバの自動再起動リトライ間隔を秒単位で指定します。

mstartup.start.watchtime

600

600

論理サーバの起動監視時間を秒単位で指定します。

mstartup.watchtime

60

60

論理サーバの停止監視時間を秒単位で指定します。

user.env.variable

−

未設定

サーバ起動時の環境変数を指定します。

JAVACOREDIR=%val%※1

−

−

JavaVMのスレッドダンプの出力先を指定します。Windowsの場合，パス区切り文字として「¥」を使用してください。スラッシュ（/）は指定できないため注意してください。

サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/ユーザプロパティ/ejbserver.httpから始まるパラメタ

ejbserver.http.port※1

28008

8080

管理用サーバのポート番号を指定します。

サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/ユーザプロパティ/ejbserver.managementから始まるパラメタ

ejbserver.management.JVM.stats_monitor.FullGCCount.interval

600

600

フルガーベージコレクション回数の監視でのしきい値監視間隔を秒単位で指定します。

ejbserver.management.JVM.stats_monitor.FullGCCount.threshold

10

10

フルガーベージコレクション回数の監視でのしきい値となる回数を指定します。

ejbserver.management.statistics.interval

60

60

稼働情報収集間隔を秒単位で指定します。

ejbserver.management.stats_file.dir※1

<作業ディレクトリ>¥ejb¥<サーバ名>¥stats

−

稼働情報ファイルの出力先ディレクトリを指定します。Windowsの場合，パス区切り文字として「¥」を使用してください。スラッシュ（/）は指定できないため注意してください。

ejbserver.management.stats_file.num※1

7

8

稼働情報ファイルの面数を指定します。

サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/ユーザプロパティ/ejbserver.namingから始まるパラメタ

ejbserver.naming.port※1

900

900

J2EEサーバがネーミングサービスとして利用するCORBAネーミングサービスのポートを指定します。

サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/ユーザプロパティ/ejbserver.rmiから始まるパラメタ

ejbserver.rmi.naming.port※1

23152

23152

J2EEサーバが利用するRMIレジストリのポート番号を指定します。

ejbserver.rmi.remote.listener.port※1

23550

23550

JMXクライアント（運用管理エージェントなど）による稼働情報取得時のリクエスト受付ポートを指定します。

サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/ユーザプロパティ/ejbserver.watchから始まるパラメタ

ejbserver.watch.defaultRequestQueue.threshold

80

80

アラートメッセージを出力するしきい値を指定します。

サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/ユーザプロパティ/vbrokerから始まるパラメタ

vbroker.se.iiop_tp.scm.iiop_tp.listener.port※1

0

0

J2EEサーバ単位で設定する通信ポートを指定します。

サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/ユーザプロパティ/webserver.connectorから始まるパラメタ

webserver.connector.ajp13.max_threads※2

10

20

Webコンテナがリクエストを処理する同時実行数を指定します。

webserver.connector.ajp13.port※1

8007

8007

Webサーバとの通信に使用するポート番号を指定します。簡易構築定義ファイル（SOA.xml）のworker.default.portの値と合わせる必要があります。

サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/JavaVM起動オプション定義

-Xms%val%※2

1g（推奨モードの場合のみ）

1024m

Javaヒープの初期サイズを指定します。

-Xmx%val%※2

1g（推奨モードの場合のみ）

1024m

Javaヒープの最大サイズを指定します。

-XX:MetaspaceSize=%val%※2

128m

128m

Metaspace領域の初期サイズを指定します。

-XX:MaxMetaspaceSize=%val%※2

128m

128m

Metaspace領域の最大サイズを指定します。

ejb.public.directory※1

Windowsの場合

&{cosminexus.home}¥CC¥server¥public

UNIXの場合

&{cosminexus.home}/CC/server/public

−

J2EEサーバの作業ディレクトリを指定します。指定したディレクトリをJ2EEサーバの作業ディレクトリとしてJ2EEサーバを開始します。Windowsの場合，パス区切り文字として「¥」を使用してください。スラッシュ（/）は指定できないため注意してください。

ejb.server.log.directory※1

<作業ディレクトリ>¥ejb¥<サーバ名>¥logs

−

ログファイルの出力先ディレクトリを指定します。Windowsの場合，パス区切り文字として「¥」を使用してください。スラッシュ（/）は指定できないため注意してください。

サービスユニットの定義/PRFの定義/論理サーバ共通のコンフィグレーション定義

mstartup.force.watchtime

600

60

論理サーバの強制停止監視時間を秒単位で指定します。

mstartup.restartcnt

1

1

論理サーバの自動再起動回数を指定します。

mstartup.retrywait

0

0

論理サーバの自動再起動リトライ間隔を秒単位で指定します。

mstartup.start.watchtime

60

60

論理サーバの起動監視時間を秒単位で指定します。

mstartup.watchtime

600

600

論理サーバの停止監視時間を秒単位で指定します。

サービスユニットの定義/PRFの定義/PRFのコンフィグレーション定義

prfspool※1

&{cosminexus.home}/PRF/spool

−

PRFトレース出力ディレクトリを指定します。Windowsの場合，パス区切り文字として「¥」を使用してください。スラッシュ（/）は指定できないため注意してください。

ホストの定義

−

20295

20295

<host>下の<agent-port>※1※3に，運用管理エージェントのポート番号を指定します。運用管理エージェントプロパティファイル（adminagent.properties）のadminagent.adapter.portの値と合わせる必要があります。

（凡例）

−：ありません。

注※1

セットアップ時に編集する項目です。

注※2

チューニング時に編集する項目です。

注※3

<param-value>ではなく，表に記載されているタグに指定します。

デフォルト値と異なる値が設定される項目

カテゴリ

<param-name>に指定されているパラメタ

デフォルト値

HCSC本番環境簡易セットアップで設定される値

<param-value>に指定する内容

Webシステムの定義

−

−

SOA

<web-system>下の<name>※1に，Webシステムを識別するための名称を指定します。

物理ティアの定義

−

−

combined-tier

<tier>下の<tier-type>※1に，物理ティアの種類を指定します。

サービスユニットの定義

−

−

Unit

<unit>下の<name>※1に，サービスユニットを識別するための名称を指定します。

−

−

localhost

<unit>下の<host-ref>※1に，ホストの定義の<name-name>に指定したホスト名，構築済みのWebシステムで定義されているホスト名，または@myhostを指定します。

−

−

combined-tier

<unit>下の<hosts-for>※1に，<host-ref>で指定したホストが属する物理ティアの種類を指定します。

サービスユニットの定義/HTTP Serverの定義

−

cmx_<Webシステム名>_<サービスユニット名>_<種別>_<通番>

WebServer

<define-server>下の<logical-server-name>※1に，論理サーバまたはクラスタを識別するための名称を指定します。

−

−

web-server

<define-server>下の<logical-server-type>※1に，コンフィグレーションを定義する論理サーバの種類を指定します。

サービスユニットの定義/HTTP Serverの定義/HTTP Serverのコンフィグレーション定義/Webサーバ用定義

manager.web.send_request_method

reverseproxy

reverseproxy

推奨モード

redirector

V9互換モード

WebサーバのJ2EEサーバとの連携方法を指定します。

reverseproxyを指定した場合，リバースプロキシを使用します。

redirectorを指定した場合，リダイレクタを使用します。

ここで指定した互換モードと，連携するJ2EEサーバの互換モードが合致しない場合，リクエストをJ2EEサーバに転送できなくなり，リクエスト処理がエラーになります。連携するJ2EEサーバの互換モードに合わせて指定してください。

reverseproxyを指定し，かつSetByパラメタにitemを指定した場合，設定の配布時にマニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.10.4　リバースプロキシを設定するパラメタ」に記載のパラメタが有効になります。

サービスユニットの定義/HTTP Serverの定義/HTTP Serverのコンフィグレーション定義/HTTP Server用リダイレクタ動作定義

JkMount

/* [J2EEサーバ名]（combined-tierとhttp-tierの場合）

/* default

HTTP Serverへのリクエストで，どのURLパターンがWebコンテナに転送されるかを指定します。

J2EEサーバの互換モードがV9互換モードの場合だけ指定できます。

サービスユニットの定義/HTTP Serverの定義/HTTP Serverのコンフィグレーション定義/ワーカ定義

worker.default.type

−

ajp13

ワーカのタイプを指定します。J2EEサーバの互換モードがV9互換モードの場合だけ指定できます。

worker.default.host

−

localhost

ワーカのホスト名，またはIPアドレスを指定します。J2EEサーバの互換モードがV9互換モードの場合だけ指定できます。

worker.list

−

default

ワーカ名のリストを指定します。J2EEサーバの互換モードがV9互換モードの場合だけ指定できます。

サービスユニットの定義/HTTP Serverの定義/HTTP Serverのコンフィグレーション定義/HTTP Serverのログの出力定義

HttpsdRequestMethod

Div

Wrap

リクエストログの出力方式を指定します。

サービスユニットの定義/J2EEサーバの定義

−

cmx_<Webシステム名>_<サービスユニット名>_<種別>_<通番>

J2EEServer

<define-server>下の<logical-server-name>※1に，論理サーバまたはクラスタを識別するための名称を指定します。

−

−

j2ee-server

<define-server>下の<logical-server-type>※1に，コンフィグレーションを定義する論理サーバの種類を指定します。

サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/ユーザプロパティ/ejbserver.extから始まるパラメタ

ejbserver.ext.method_observation.interval

0

10

業務アプリケーション実行時間監視機能を使用するかどうかを指定します。また，動作中のリクエスト処理がタイムアウトしていないかを監視する時間間隔，タイムアウトしたリクエスト（メソッド）をキャンセルする時間間隔を秒単位で指定します。

サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/ユーザプロパティ/ejbserver.jndiから始まるパラメタ

ejbserver.jndi.global.enabled

true

false

アプリケーション開始時に，ネーミングサービスに対してPortable Global JNDI名でオブジェクトを登録するかどうかを指定します。

サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/ユーザプロパティ/ejbserver.managerから始まるパラメタ

ejbserver.manager.agent.MEventAgent.enabled

true

false

Managementイベント発行機能を有効にするかどうかを指定します。

サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/ユーザプロパティ/ejbserver.rmiから始まるパラメタ

ejbserver.rmi.naming.host

−

localhost

マルチホームドホスト環境で，J2EEサーバがサービスプロバイダとして使用するRMIレジストリのホスト名，またはIPアドレスを指定します。

サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/ユーザプロパティ/ejbserver.serverから始まるパラメタ

ejbserver.server.threaddump.filenum

256

4

J2EEサーバが障害を検知して自発的にスレッドダンプを出力する場合の，スレッドダンプのファイル数の上限を指定します。

サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/ユーザプロパティ/managerから始まるパラメタ

manager.j2ee.compat

none

none

推奨モード

V9

V9互換モード

J2EEサーバの互換モードを指定します。HCSCサーバが前提とする互換モードは，推奨モードとV9互換モードです。

設定後に値を変更する場合は，事前に「cjsetup -d」コマンドで，J2EEサーバの環境を削除します。

サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/ユーザプロパティ/webserver.connectorから始まるパラメタ

webserver.connector.ajp13.bind_host

−

localhost

Webサーバ連携で使用するIPアドレス，またはホスト名を指定します。

webserver.connector.nio_http.max_threads

100

20

J2EEサーバの互換モードが推奨モードで，かつSOAP1.1/1.2併用モードを選択した場合，NIO HTTPサーバの処理スレッド数の最大値を1〜2,147,483,647の整数で指定します。

webserver.connector.nio_http.min_threads

10

20

J2EEサーバの互換モードが推奨モードで，かつSOAP1.1/1.2併用モードを選択した場合，NIO HTTPサーバの処理スレッド数の最小値を1〜2,147,483,647の整数で指定します。※2

webserver.connector.nio_http.max_connections

1024

20

J2EEサーバの互換モードが推奨モードで，かつSOAP1.1/1.2併用モードを選択した場合，Webクライアントとの最大接続数を1〜2,147,483,647の整数で指定します。

なお，有効な最大値は，実行するプラットフォームに依存します。

webserver.connector.nio_http.max_servlet_execute_threads

100

20

J2EEサーバの互換モードが推奨モードで，かつSOAP1.1/1.2併用モードを選択した場合，WebコンテナがNIO HTTPサーバを介して同期サーブレットを実行する際の，Webコンテナ全体の最大同時実行スレッド数を1〜2,147,483,647の整数で指定します。※3

webserver.connector.nio_http.port

8008

8008

J2EEサーバの互換モードが推奨モードで，かつSOAP1.1/1.2併用モードを選択した場合，NIO HTTPサーバが使用するポート番号を1〜65,535の整数で指定します。

なお，すでにほかのアプリケーションで使用されているポート番号や，確保されていないポート番号は指定できません。これらを指定した場合は，メッセージを出力して，J2EEサーバが起動されません。

サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/JavaVM起動オプション定義

add.jvm.arg

-XX:%val%HitachiCommaVerboseGC

-（マイナス）

+

拡張verbosegc情報の出力形式を指定します。

add.jvm.arg

-XX:%val%HitachiUseExplicitMemory

+（プラス）

-

明示管理ヒープ機能を使用するかどうかを指定します。

JDK 11をインストールした環境で指定できます。JDK 17をインストールした環境では指定できません。

add.jvm.arg

-XX:MaxGCPauseMillis

200

−

G1GCのGCによるアプリケーション停止時間の目標時間を指定します（単位：ミリ秒）。

-XX:+UseG1GCを指定した場合に有効になります。

このオプションに0を指定した場合は，メッセージが標準出力に出力されJavaVMの起動に失敗します。

このオプションに100以下の値を指定する場合，ログファイルの非同期出力機能（-XX:+JavaLogAsynchronous）を使用することを推奨します。

add.jvm.arg

-XX:ParallelGCThreads

実行環境の論理CPU数が8以下の場合

CPU数

実行環境の論理CPU数が9以上の場合

「8＋(CPU数-8)×(5÷8)」（小数点以下は切り捨て）の値

−

G1GCのEvacuationを並列実行するスレッドの数を指定します。-XX:+UseG1GCを指定した場合に有効になります。なお，このオプションは，デフォルト値で使用することを推奨します。変更する場合は，実際にJavaVMを動作させて測定した値を基に，最適な値を算出してから変更してください。

JavaVM起動時に，このオプションに指定した数のEvacuation処理用のスレッドが作成され，処理が実行されます。

add.jvm.arg

-XX:ConcGCThreads

Max( (ParallelGCThreads + 2)/4 , 1)

−

G1GCのConcurrent Markingの処理を並列実行するスレッドの数を指定します。

-XX:+UseG1GCを指定したときに有効になります。なお，このオプションは，デフォルト値で使用することを推奨します。変更する場合は，実際にJavaVMを動作させて測定した値を基に，最適な値を算出してから変更してください。

JavaVM起動時に，このオプションに指定した数のConcurrent Marking処理用のスレッドが作成され，処理が実行されます。

サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/JavaVMシステムプロパティ

ejbserver.container.security.disabled

false

true

Enterprise Beanのアクセス制御機能を有効にするかどうかを指定します。

ejbserver.ctm.enabled

09-00以降のバージョンの場合

false

09-00より前のバージョンの場合

true

false

CTM機能を使用するかどうかを指定します。

ejbserver.rmi.stateless.unique_id.enabled

false

true

Stateless Session Beanのremoveメソッドの呼び出しに対して，呼び出しを不要とするかどうかを指定します。

サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/J2EEコンテナの拡張パラメタ

add.class.path

−

&lt;cosminexus.home&gt;¥c4web¥lib¥hitsaaj.jar

（SOAP1.1モードの場合）

通信基盤として，SOAP通信基盤を指定します。

&lt;cosminexus.home&gt;¥jaxws¥lib¥cjjaxws.jar

（SOAP1.1/1.2併用モードの場合）

通信基盤として，JAX-WSエンジンを指定します。

サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/SecurityManager

use.security

true

false

J2EEサーバの起動オプションにSecurityManagerを使用するかどうかを指定します。

サービスユニットの定義/PRFの定義

−

cmx_<Webシステム名>_<サービスユニット名>_<種別>_<通番>

PRF

<define-server>下の<logical-server-name>※1に，論理サーバまたはクラスタを識別するための名称を指定します。

−

−

performance-tracer

<define-server>下の<logical-server-type>※1に，コンフィグレーションを定義する論理サーバの種類を指定します。

サービスユニットの定義/PRFの定義/論理サーバ共通のコンフィグレーション定義

mstartup.no

0

0

一括起動時のサーバの起動順序を指定します。

サービスユニットの定義/PRFの定義/PRFのコンフィグレーション定義

PrfTraceLevel

STANDARD

00030000

パフォーマンストレーサのトレース取得レベルを指定します。

ホストの定義

−

−

localhost

<host>下の<host-name>※1に，ホストを識別するための名称またはIPアドレスを指定します。

−

<host-name>で指定した値

localhost

<host>下の<agent-host>※1に，運用管理エージェントのホスト名またはIPアドレスを指定します。

（凡例）

−：ありません。

注※1

<param-value>ではなく，表に記載されているタグに指定します。

注※2

指定値は，NIO HTTPサーバの処理スレッド数の最大値（webserver.connector.nio_http.max_threadsパラメタの指定値）以下である必要があります。これを超える値を指定するとメッセージKDJE39010-Wが出力され，処理スレッド数の最大値が最小値として設定されます。

なお，有効な最大値は，実行するプラットフォームに依存します。

注※3

指定値は，NIO HTTPサーバの処理スレッド数の最大値（webserver.connector.nio_http.max_threadsパラメタの指定値）以下である必要があります。これを超える値を指定するとメッセージKDJE39010-Wが出力され，処理スレッド数の最大値がWebコンテナ全体の最大同時実行スレッド数として設定されます。

なお，このパラメタで制御できる最大同時実行スレッド数には，同期サーブレット以外の実行スレッド（非同期サーブレットの実行スレッドや非同期I/O APIによるコールバックスレッドなど）は含みません。これらも含めたすべての処理スレッドの最大値は，webserver.connector.nio_http.max_threadsパラメタで指定します。

(b)　追加セットアップの場合

追加セットアップの場合の項目について説明します。

編集する項目

カテゴリ

<param-name>に指定するパラメタ

デフォルト値

HCSC本番環境簡易セットアップで設定される値

<param-value>に指定する内容

サービスユニットの定義/HTTP Serverの定義/論理サーバ共通のコンフィグレーション定義

mstartup.force.watchtime

60

60

論理サーバの強制停止監視時間を秒単位で指定します。

mstartup.restartcnt

1

1

論理サーバの自動再起動回数を指定します。

mstartup.retrywait

60

60

論理サーバの自動再起動リトライ間隔を秒単位で指定します。

mstartup.start.watchtime

600

60

論理サーバの起動監視時間を秒単位で指定します。

mstartup.watchtime

60

60

論理サーバの停止監視時間を秒単位で指定します。

サービスユニットの定義/HTTP Serverの定義/HTTP Serverのコンフィグレーション定義/Webサーバ用定義

Listen※1

−

1024

リクエストを受け付けるIPアドレス，およびポート番号を指定します。

ThreadsPerChild※2

50

50

サーバとして起動するスレッド数を指定します。この定義は，Windowsの場合だけ指定してください。

サービスユニットの定義/HTTP Serverの定義/HTTP Serverのコンフィグレーション定義/HTTP Server用リダイレクタ動作定義

JkLogFileDir※1

logs

−

ログファイルの出力先ディレクトリを指定します。Windowsの場合，パス区切り文字として「¥」を使用してください。スラッシュ（/）は指定できないため注意してください。

JkTraceLogFileDir※1

logs

−

保守用トレースログファイルの出力先ディレクトリを指定します。Windowsの場合，パス区切り文字として「¥」を使用してください。スラッシュ（/）は指定できないため注意してください。

サービスユニットの定義/HTTP Serverの定義/HTTP Serverのコンフィグレーション定義/ワーカ定義

worker.default.cachesize※2

64

40

リダイレクタで再利用するワーカとのコネクション数を指定します。この定義は，Windowsの場合だけ指定してください。

worker.default.port※1

−

8008

ワーカのポート番号を指定します。簡易構築定義ファイル（SOA.xml）のwebserver.connector.ajp13.portの値と合わせる必要があります。

worker.default.receive_timeout※2

3600

3600

通信タイムアウト値を秒単位で指定します。

サービスユニットの定義/HTTP Serverの定義/HTTP Serverのコンフィグレーション定義/HTTP Serverのログの出力定義

CustomDivideFileNum※1

8

8

分割したログファイルのファイル数を指定します。

HttpsdLogFileDir※1

logs

−

Webサーバの出力するログの出力先ディレクトリを指定します。Windowsの場合，パス区切り文字として「¥」を使用してください。スラッシュ（/）は指定できないため注意してください。

サービスユニットの定義/J2EEサーバの定義/論理サーバ共通のコンフィグレーション定義

mstartup.force.watchtime

60

60

論理サーバの強制停止監視時間を秒単位で指定します。

mstartup.restartcnt

1

1

論理サーバの自動再起動回数を指定します。

mstartup.retrywait

60

60

論理サーバの自動再起動リトライ間隔を秒単位で指定します。

mstartup.start.watchtime

600

600

論理サーバの起動監視時間を秒単位で指定します。

mstartup.watchtime

60

60

論理サーバの停止監視時間を秒単位で指定します。

user.env.variable

−

未設定

サーバ起動時の環境変数を指定します。

JAVACOREDIR=%val%※1

−

−

JavaVMのスレッドダンプの出力先を指定します。Windowsの場合，パス区切り文字として「¥」を使用してください。スラッシュ（/）は指定できないため注意してください。

サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/ユーザプロパティ/ejbserver.distributedtxから始まるパラメタ

ejbserver.distributedtx.recovery.port

20302

20303

1.4モードの場合に，グローバルトランザクションを使用するとき，トランザクションリカバリで使用する固定ポート番号を1〜65535の整数で指定します。無効な値を指定した場合や，指定したポートがすでに使用されていた場合には，起動が中断されます。なお，ライトトランザクションを有効として起動した場合は，このプロパティは無視されます。

サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/ユーザプロパティ/ejbserver.httpから始まるパラメタ

ejbserver.http.port※1

28008

8081

管理用サーバのポート番号を指定します。

サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/ユーザプロパティ/ejbserver.managementから始まるパラメタ

ejbserver.management.JVM.stats_monitor.FullGCCount.interval

600

600

フルガーベージコレクション回数の監視でのしきい値監視間隔を秒単位で指定します。

ejbserver.management.JVM.stats_monitor.FullGCCount.threshold

10

10

フルガーベージコレクション回数の監視でのしきい値となる回数を指定します。

ejbserver.management.statistics.interval

60

60

稼働情報収集間隔を秒単位で指定します。

ejbserver.management.stats_file.dir※1

<作業ディレクトリ>¥ejb¥<サーバ名>¥stats

−

稼働情報ファイルの出力先ディレクトリを指定します。Windowsの場合，パス区切り文字として「¥」を使用してください。スラッシュ（/）は指定できないため注意してください。

ejbserver.management.stats_file.num※1

7

8

稼働情報ファイルの面数を指定します。

サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/ユーザプロパティ/ejbserver.namingから始まるパラメタ

ejbserver.naming.port※1

900

1025

J2EEサーバがネーミングサービスとして利用するCORBAネーミングサービスのポートを指定します。

サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/ユーザプロパティ/ejbserver.rmiから始まるパラメタ

ejbserver.rmi.naming.port※1

23152

23153

J2EEサーバが利用するRMIレジストリのポート番号を指定します。

ejbserver.rmi.remote.listener.port※1

23550

23551

JMXクライアント（運用管理エージェントなど）による稼働情報取得時のリクエスト受付ポートを指定します。

サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/ユーザプロパティ/ejbserver.watchから始まるパラメタ

ejbserver.watch.defaultRequestQueue.threshold

80

80

アラートメッセージを出力するしきい値を指定します。

サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/ユーザプロパティ/vbrokerから始まるパラメタ

vbroker.se.iiop_tp.scm.iiop_tp.listener.port※1

0

1026

J2EEサーバ単位で設定する通信ポートを指定します。

サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/ユーザプロパティ/webserver.connectorから始まるパラメタ

webserver.connector.ajp13.max_threads※2

10

20

Webコンテナがリクエストを処理する同時実行数を指定します。

webserver.connector.ajp13.port※1

8007

8008

Webサーバとの通信に使用するポート番号を指定します。簡易構築定義ファイル（SOA.xml）のworker.default.portの値と合わせる必要があります。

サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/JavaVM起動オプション定義

-Xms%val%※2

1g（推奨モードの場合のみ）

1024m

Javaヒープの初期サイズを指定します。

-Xmx%val%※2

1g（推奨モードの場合のみ）

1024m

Javaヒープの最大サイズを指定します。

-XX:MetaspaceSize=%val%※2

128m

128m

Metaspace領域の初期サイズを指定します。

-XX:MaxMetaspaceSize=%val%※2

128m

128m

Metaspace領域の最大サイズを指定します。

ejb.public.directory※1

Windowsの場合

&{cosminexus.home}¥CC¥server¥public

UNIXの場合

&{cosminexus.home}/CC/server/public

−

J2EEサーバの作業ディレクトリを指定します。指定したディレクトリをJ2EEサーバの作業ディレクトリとしてJ2EEサーバを開始します。Windowsの場合，パス区切り文字として「¥」を使用してください。スラッシュ（/）は指定できないため注意してください。

ejb.server.log.directory※1

<作業ディレクトリ>¥ejb¥<サーバ名>¥logs

−

ログファイルの出力先ディレクトリを指定します。Windowsの場合，パス区切り文字として「¥」を使用してください。スラッシュ（/）は指定できないため注意してください。

サービスユニットの定義/PRFの定義/論理サーバ共通のコンフィグレーション定義

mstartup.force.watchtime

600

60

論理サーバの強制停止監視時間を秒単位で指定します。

mstartup.restartcnt

1

1

論理サーバの自動再起動回数を指定します。

mstartup.retrywait

0

0

論理サーバの自動再起動リトライ間隔を秒単位で指定します。

mstartup.start.watchtime

60

60

論理サーバの起動監視時間を秒単位で指定します。

mstartup.watchtime

600

600

論理サーバの停止監視時間を秒単位で指定します。

サービスユニットの定義/PRFの定義/PRFのコンフィグレーション定義

PRFID※1

PRF_ID

PRF_ID2

PRF識別子を指定します。

prfspool※1

&{cosminexus.home}/PRF/spool

−

PRFトレース出力ディレクトリを指定します。Windowsの場合，パス区切り文字として「¥」を使用してください。スラッシュ（/）は指定できないため注意してください。

ホストの定義

−

20295

20295

<host>下の<agent-port>※1※3に，運用管理エージェントのポート番号を指定します。運用管理エージェントプロパティファイル（adminagent.properties）のadminagent.adapter.portの値と合わせる必要があります。

（凡例）

−：ありません。

注※1

セットアップ時に編集する項目です。

注※2

チューニング時に編集する項目です。

注※3

<param-value>ではなく，表に記載されているタグに指定します。

デフォルト値と異なる値が設定される項目

カテゴリ

<param-name>に指定されているパラメタ

デフォルト値

HCSC本番環境簡易セットアップで設定される値

<param-value>に指定する内容

Webシステムの定義

−

−

SOA

<web-system>下の<name>※1に，Webシステムを識別するための名称を指定します。

物理ティアの定義

−

−

combined-tier

<tier>下の<tier-type>※1に，物理ティアの種類を指定します。

サービスユニットの定義

−

−

Unit2

<unit>下の<name>※1に，サービスユニットを識別するための名称を指定します。

−

−

localhost

<unit>下の<host-ref>※1に，ホストの定義の<name-name>に指定したホスト名，構築済みのWebシステムで定義されているホスト名，または@myhostを指定します。

−

−

combined-tier

<unit>下の<hosts-for>※1に，<host-ref>で指定したホストが属する物理ティアの種類を指定します。

サービスユニットの定義/HTTP Serverの定義

−

cmx_<Webシステム名>_<サービスユニット名>_<種別>_<通番>

WebServer2

<define-server>下の<logical-server-name>※1に，論理サーバまたはクラスタを識別するための名称を指定します。

−

−

web-server

<define-server>下の<logical-server-type>※1に，コンフィグレーションを定義する論理サーバの種類を指定します。

サービスユニットの定義/HTTP Serverの定義/HTTP Serverのコンフィグレーション定義/Webサーバ用定義

manager.web.send_request_method

reverseproxy

reverseproxy

推奨モード

redirector

V9互換モード

WebサーバのJ2EEサーバとの連携方法を指定します。

reverseproxyを指定した場合，リバースプロキシを使用します。

redirectorを指定した場合，リダイレクタを使用します。

ここで指定した互換モードと，連携するJ2EEサーバの互換モードが合致しない場合，リクエストをJ2EEサーバに転送できなくなり，リクエスト処理がエラーになります。連携するJ2EEサーバの互換モードに合わせて指定してください。

reverseproxyを指定し，かつSetByパラメタにitemを指定した場合，設定の配布時にマニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.10.4　リバースプロキシを設定するパラメタ」に記載のパラメタが有効になります。

サービスユニットの定義/HTTP Serverの定義/HTTP Serverのコンフィグレーション定義/HTTP Server用リダイレクタ動作定義

JkMount

/* [J2EEサーバ名]（combined-tierとhttp-tierの場合）

/* default

HTTP Serverへのリクエストで，どのURLパターンがWebコンテナに転送されるかを指定します。

J2EEサーバの互換モードがV9互換モードの場合だけ指定できます。

サービスユニットの定義/HTTP Serverの定義/HTTP Serverのコンフィグレーション定義/ワーカ定義

worker.default.type

−

ajp13

ワーカのタイプを指定します。J2EEサーバの互換モードがV9互換モードの場合だけ指定できます。

worker.default.host

−

localhost

ワーカのホスト名，またはIPアドレスを指定します。J2EEサーバの互換モードがV9互換モードの場合だけ指定できます。

worker.list

−

default

ワーカ名のリストを指定します。J2EEサーバの互換モードがV9互換モードの場合だけ指定できます。

サービスユニットの定義/HTTP Serverの定義/HTTP Serverのコンフィグレーション定義/HTTP Serverのログの出力定義

HttpsdRequestMethod

Div

Wrap

リクエストログの出力方式を指定します。

サービスユニットの定義/J2EEサーバの定義

−

cmx_<Webシステム名>_<サービスユニット名>_<種別>_<通番>

J2EEServer2

<define-server>下の<logical-server-name>※1に，論理サーバまたはクラスタを識別するための名称を指定します。

−

−

j2ee-server

<define-server>下の<logical-server-type>※1に，コンフィグレーションを定義する論理サーバの種類を指定します。

サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/ユーザプロパティ/ejbserver.extから始まるパラメタ

ejbserver.ext.method_observation.interval

0

10

業務アプリケーション実行時間監視機能を使用するかどうかを指定します。また，動作中のリクエスト処理がタイムアウトしていないかを監視する時間間隔，タイムアウトしたリクエスト（メソッド）をキャンセルする時間間隔を秒単位で指定します。

サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/ユーザプロパティ/ejbserver.jndiから始まるパラメタ

ejbserver.jndi.global.enabled

true

false

アプリケーション開始時に，ネーミングサービスに対してPortable Global JNDI名でオブジェクトを登録するかどうかを指定します。

サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/ユーザプロパティ/ejbserver.managerから始まるパラメタ

ejbserver.manager.agent.MEventAgent.enabled

true

false

Managementイベント発行機能を有効にするかどうかを指定します。

サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/ユーザプロパティ/ejbserver.rmiから始まるパラメタ

ejbserver.rmi.naming.host

−

localhost

マルチホームドホスト環境で，J2EEサーバがサービスプロバイダとして使用するRMIレジストリのホスト名，またはIPアドレスを指定します。

サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/ユーザプロパティ/ejbserver.serverから始まるパラメタ

ejbserver.server.threaddump.filenum

256

4

J2EEサーバが障害を検知して自発的にスレッドダンプを出力する場合の，スレッドダンプのファイル数の上限を指定します。

サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/ユーザプロパティ/managerから始まるパラメタ

manager.j2ee.compat

none

none

推奨モード

V9

V9互換モード

J2EEサーバの互換モードを指定します。HCSCサーバが前提とする互換モードは，推奨モードとV9互換モードです。

設定後に値を変更する場合は，事前に「cjsetup -d」コマンドで，J2EEサーバの環境を削除します。

サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/ユーザプロパティ/webserver.connectorから始まるパラメタ

webserver.connector.ajp13.bind_host

−

localhost

Webサーバ連携で使用するIPアドレス，またはホスト名を指定します。

webserver.connector.nio_http.max_threads

100

20

J2EEサーバの互換モードが推奨モードで，かつSOAP1.1/1.2併用モードを選択した場合，NIO HTTPサーバの処理スレッド数の最大値を1〜2,147,483,647の整数で指定します。

webserver.connector.nio_http.min_threads

10

20

J2EEサーバの互換モードが推奨モードで，かつSOAP1.1/1.2併用モードを選択した場合，NIO HTTPサーバの処理スレッド数の最小値を1〜2,147,483,647の整数で指定します。※2

webserver.connector.nio_http.max_connections

1024

20

J2EEサーバの互換モードが推奨モードで，かつSOAP1.1/1.2併用モードを選択した場合，Webクライアントとの最大接続数を1〜2,147,483,647の整数で指定します。

なお，有効な最大値は，実行するプラットフォームに依存します。

webserver.connector.nio_http.max_servlet_execute_threads

100

20

J2EEサーバの互換モードが推奨モードで，かつSOAP1.1/1.2併用モードを選択した場合，WebコンテナがNIO HTTPサーバを介して同期サーブレットを実行する際の，Webコンテナ全体の最大同時実行スレッド数を1〜2,147,483,647の整数で指定します。※3

webserver.connector.nio_http.port

8008

8009

J2EEサーバの互換モードが推奨モードで，かつSOAP1.1/1.2併用モードを選択した場合，NIO HTTPサーバが使用するポート番号を1〜65,535の整数で指定します。

なお，すでにほかのアプリケーションで使用されているポート番号や，確保されていないポート番号は指定できません。これらを指定した場合は，メッセージを出力して，J2EEサーバが起動されません。

サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/JavaVM起動オプション定義

add.jvm.arg

-XX:%val%HitachiCommaVerboseGC

-（マイナス）

+

拡張verbosegc情報の出力形式を指定します。

add.jvm.arg

-XX:%val%HitachiUseExplicitMemory

+（プラス）

-

明示管理ヒープ機能を使用するかどうかを指定します。

JDK 11をインストールした環境で指定できます。JDK 17をインストールした環境では指定できません。

add.jvm.arg

-XX:MaxGCPauseMillis

200

−

G1GCのGCによるアプリケーション停止時間の目標時間を指定します（単位：ミリ秒）。

-XX:+UseG1GCを指定した場合に有効になります。

このオプションに0を指定した場合は，メッセージが標準出力に出力されJavaVMの起動に失敗します。

このオプションに100以下の値を指定する場合，ログファイルの非同期出力機能（-XX:+JavaLogAsynchronous）を使用することを推奨します。

add.jvm.arg

-XX:ParallelGCThreads

実行環境の論理CPU数が8以下の場合

CPU数

実行環境の論理CPU数が9以上の場合

「8＋(CPU数-8)×(5÷8)」（小数点以下は切り捨て）の値

−

G1GCのEvacuationを並列実行するスレッドの数を指定します。-XX:+UseG1GCを指定した場合に有効になります。なお，このオプションは，デフォルト値で使用することを推奨します。変更する場合は，実際にJavaVMを動作させて測定した値を基に，最適な値を算出してから変更してください。

JavaVM起動時に，このオプションに指定した数のEvacuation処理用のスレッドが作成され，処理が実行されます。

add.jvm.arg

-XX:ConcGCThreads

Max( (ParallelGCThreads + 2)/4 , 1)

−

G1GCのConcurrent Markingの処理を並列実行するスレッドの数を指定します。

-XX:+UseG1GCを指定したときに有効になります。なお，このオプションは，デフォルト値で使用することを推奨します。変更する場合は，実際にJavaVMを動作させて測定した値を基に，最適な値を算出してから変更してください。

JavaVM起動時に，このオプションに指定した数のConcurrent Marking処理用のスレッドが作成され，処理が実行されます。

サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/JavaVMシステムプロパティ

ejbserver.container.security.disabled

false

true

Enterprise Beanのアクセス制御機能を有効にするかどうかを指定します。

ejbserver.ctm.enabled

09-00以降のバージョンの場合

false

09-00より前のバージョンの場合

true

false

CTM機能を使用するかどうかを指定します。

ejbserver.rmi.stateless.unique_id.enabled

false

true

Stateless Session Beanのremoveメソッドの呼び出しに対して，呼び出しを不要とするかどうかを指定します。

サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/J2EEコンテナの拡張パラメタ

add.class.path

−

&lt;cosminexus.home&gt;¥c4web¥lib¥hitsaaj.jar

（SOAP1.1モードの場合）

通信基盤として，SOAP通信基盤を指定します。

&lt;cosminexus.home&gt;¥jaxws¥lib¥cjjaxws.jar

（SOAP1.1/1.2併用モードの場合）

通信基盤として，JAX-WSエンジンを指定します。

サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/SecurityManager

use.security

true

false

J2EEサーバの起動オプションにSecurityManagerを使用するかどうかを指定します。

サービスユニットの定義/PRFの定義

−

cmx_<Webシステム名>_<サービスユニット名>_<種別>_<通番>

PRF2

<define-server>下の<logical-server-name>※1に，論理サーバまたはクラスタを識別するための名称を指定します。

−

−

performance-tracer

<define-server>下の<logical-server-type>※1に，コンフィグレーションを定義する論理サーバの種類を指定します。

サービスユニットの定義/PRFの定義/論理サーバ共通のコンフィグレーション定義

mstartup.no

0

0

一括起動時のサーバの起動順序を指定します。

サービスユニットの定義/PRFの定義/PRFのコンフィグレーション定義

PrfTraceLevel

STANDARD

00030000

パフォーマンストレーサのトレース取得レベルを指定します。

ホストの定義

−

−

localhost

<host>下の<host-name>※1に，ホストを識別するための名称またはIPアドレスを指定します。

−

<host-name>で指定した値

localhost

<host>下の<agent-host>※1に，運用管理エージェントのホスト名またはIPアドレスを指定します。

（凡例）

−：ありません。

注※1

<param-value>ではなく，表に記載されているタグに指定します。

注※2

指定値は，NIO HTTPサーバの処理スレッド数の最大値（webserver.connector.nio_http.max_threadsパラメタの指定値）以下である必要があります。これを超える値を指定するとメッセージKDJE39010-Wが出力され，処理スレッド数の最大値が最小値として設定されます。

なお，有効な最大値は，実行するプラットフォームに依存します。

注※3

指定値は，NIO HTTPサーバの処理スレッド数の最大値（webserver.connector.nio_http.max_threadsパラメタの指定値）以下である必要があります。これを超える値を指定するとメッセージKDJE39010-Wが出力され，処理スレッド数の最大値がWebコンテナ全体の最大同時実行スレッド数として設定されます。

なお，このパラメタで制御できる最大同時実行スレッド数には，同期サーブレット以外の実行スレッド（非同期サーブレットの実行スレッドや非同期I/O APIによるコールバックスレッドなど）は含みません。これらも含めたすべての処理スレッドの最大値は，webserver.connector.nio_http.max_threadsパラメタで指定します。

(19)　HTTP Server定義ファイル

ファイル名

httpsd.conf

説明

HTTP Serverの動作に必要となる情報を設定します。なお，HCSC本番環境簡易セットアップ機能でセットアップしたあと，HTTP Serverを起動する前に，必要に応じてファイルを直接変更してください。

ファイルの格納先

<サービスプラットフォームのインストールディレクトリ>¥httpsd¥servers¥HWS_WebServer¥conf

編集する項目

カテゴリ

項目名

デフォルト値

HCSC本番環境簡易セットアップで設定される値

説明

Webサーバへの接続を許可するホスト

<Location %val%>※

−

/

特定のURLで示す場所へのリクエストについて，ディレクティブを定義する場合に指定します。

Order %val%※

−

deny,allow

AllowディレクティブとDenyディレクティブの指定の評価の順序を指定します。

Deny from %val%※

−

all

Webサーバへアクセスできるクライアントを制限する場合に指定します。

Allow from %val%※

−

localhost

Webサーバへアクセスできるクライアントを制限する場合に指定します。

（凡例）

−：ありません。

注※

セットアップ時に編集する項目です。

デフォルト値と異なる値が設定される項目

なし

(20)　cscsetupコマンド定義ファイル

ファイル名

cscsetup.properties

説明

cscsetupコマンドの動作に必要となる情報を設定します。この定義ファイルは，UNIXの場合だけ有効になります。

編集する項目

項目名

デフォルト値

HCSC本番環境簡易セットアップで設定される値

説明

owner※1※2

スーパーユーザ

−

Component Container管理者で設定するオーナーを指定します。

group※1※2

スーパーユーザ

−

Component Container管理者で設定するグループを指定します。

（凡例）

−：ありません。

注※1

セットアップ時に編集する項目です。

注※2

ownerおよびgroupの値を指定しない場合は，次に示す情報でセットアップおよびアンセットアップを実行します。

表3‒41　ownerおよびgroupの値を指定しない場合の設定値

OS

ファイルオーナー

グループ名

Linux

root

root

AIX

root

system

4　リポジトリの管理

この章では，リポジトリの設定，エクスポートやインポート，およびリポジトリの情報の参照などについて説明します。

4.1　リポジトリの概要

リポジトリとは，開発環境と運用環境の間で共有する情報を格納するディレクトリのことをいいます。

運用環境で作成したシステム構成情報を開発環境で使用したり，開発環境で作成した定義情報を運用環境で使用したりします。

4.1.1　リポジトリの情報

リポジトリで共有する情報をリポジトリ情報といい，次のものがあります。

システム構成

生成したサービスアダプタやビジネスプロセス

マッピング定義

フォーマット定義

配備情報

ユーザ定義Javaクラスのソースファイル

ユーザ定義Javaクラスの前提ライブラリファイル

4.1.2　リポジトリとして使用するディレクトリ

リポジトリは，Service Platformをインストールすると，標準で次のディレクトリに設定されます。

<サービスプラットフォームのインストールディレクトリ>¥CSC¥repository

リポジトリとして設定するディレクトリは変更することもできます。変更する場合は，HCSC-Manager定義ファイルで変更します。変更方法については，「2.4.1　運用環境をカスタマイズする」を参照してください。

なお，1台のマシンに複数の運用・実行環境を構築（環境変数CSCMNG_HOMEを設定）している場合は，次のルートディレクトリにリポジトリが設定されます。

%CSCMNG_HOME%¥repository

開発環境と運用環境で情報を共有するためには，リポジトリの情報をZIPファイル形式で媒体にエクスポート（保存）し，そのZIPファイル形式で保存された情報を別環境のリポジトリにインポート（読み込み）します。リポジトリのインポートとエクスポートを次の図に示します。

図4‒1　リポジトリのエクスポートとインポート

このうち，運用環境のリポジトリ情報の保存については「4.2　リポジトリのエクスポート」を参照してください。運用環境へのリポジトリ情報の展開については「4.3　リポジトリのインポート」を参照してください。また，開発環境のリポジトリ情報の保存と，開発環境へのリポジトリ情報の展開については，マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」の「3.2　リポジトリの管理」を参照してください。

注意事項

バージョン07-60以降では，開発環境と運用環境で1つのリポジトリを共有できません。旧バージョンでリポジトリを共有していた場合，開発環境と運用環境で別々のリポジトリを用意して，移行してください。移行手順については，マニュアル「サービスプラットフォーム開発ガイド 基本開発編」の「付録A.3　旧バージョンで開発環境と運用環境のリポジトリを共有していた場合の移行手順」を参照してください。

4.1.3　リポジトリの排他

リポジトリの更新を伴う操作中は，リポジトリがロックされた状態になり，操作できない場合があります。ロックの種類には，排他ロックおよび共有ロックがあり，操作中は次の制限があります。

排他ロック中は，排他ロックまたは共有ロックになる操作はできません。

共有ロック中は，同時にほかの共有ロックになる操作ができます。

ロックの種類と対象になる操作を次の表に示します。

表4‒1　ロックの種類と対象になる操作

ロックの種類

対象となる操作

説明

排他ロック

更新系コマンドでの操作

次のコマンドが対象となります。

csccompodeployコマンド

csccompoundeployコマンド

cscpasswdコマンド

cscrepctlコマンド

cscsvcctlコマンド

cscsvsetupコマンド

cscsvunsetupコマンド

共有ロック

参照系コマンドでの操作

次のコマンドが対象となります。

cscpideleteコマンド

cscpireexecコマンド

cscpiselectコマンド

cscrepdiffコマンド

cscreplsコマンド

cscstatusコマンド

cscsvclsコマンド

cscsvconfigコマンド

cscutilコマンド

cscresinfoコマンド

運用環境の画面での操作

−

（凡例）

−：該当しません。

4.1.4　注意事項

異なるバージョンの開発環境で作成したリポジトリは使用することができません。

リポジトリとして使用するディレクトリ以下にはアクセスしないようにしてください。アクセスした場合は，各種コマンドが失敗することがあります。

4.2　リポジトリのエクスポート

運用環境で作成した情報を開発環境で使用する場合，cscrepctlコマンドを使用して，リポジトリ内の情報をZIPファイル形式でエクスポートします。作成したZIPファイルの内容は変更できません。

次のコマンドを入力します。

cscrepctl -user <ログインユーザID> -pass <ログインパスワード> -export <ファイル名>

cscrepctlコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscrepctl（インポート/エクスポート）」を参照してください。

4.3　リポジトリのインポート

開発環境で作成した内容を運用環境で使用する場合，cscrepctlコマンドを使用して，ZIPファイル形式で保存されたリポジトリ情報をリポジトリにインポートします。

4.3.1　インポート方法

次のコマンドを入力します。ここには必須のオプションだけを記載しています。

cscrepctl -user <ログインユーザID> -pass <ログインパスワード> -import <ファイル名>

インポートする場合は，リポジトリに設定したディレクトリ以下のディレクトリおよびファイルを参照していないことを必ず確認してから，cscrepctlコマンドを実行してください。

cscrepctlコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscrepctl（インポート/エクスポート）」を参照してください。

(1)　インポートの種類

インポートには，次の2つの方法があります。

標準インポート

通常は，標準インポートを使用します。現在の運用環境のHCSCサーバ構成情報に，ZIPファイル形式で保存されたリポジトリ情報をインポートします。インポート前のリポジトリの情報は破棄されます。

現在の運用環境のリポジトリ情報とインポートするリポジトリ情報で，HCSCサーバの構成情報が同じかどうかをチェックしたい場合は，cscrepctlコマンドに-checkオプションを指定します。

コンポーネントインポート

指定したリポジトリZIPファイルのHCSCコンポーネントを運用環境のリポジトリに追加したい場合に使用します。インポート前に存在しているHCSCコンポーネントは残されます。コンポーネントインポートを行う場合は，cscrepctlコマンドに-compoオプションを指定します。

コンポーネントインポートの詳細は，「4.6　コンポーネント単位でのリポジトリの追加，更新，および削除」を参照してください。

(2)　リポジトリ情報の展開方法

ZIPファイル形式で保存されたリポジトリ情報のうち，リポジトリへの展開内容は，次の2とおりから選択できます。

差分展開

追加・変更されたHCSCコンポーネントをインポート対象のZIPファイルから運用環境のリポジトリに展開します。変更されていないHCSCコンポーネントは，現在ある運用環境のリポジトリのHCSCコンポーネントをそのまま使用します。

全体展開

変更されていないHCSCコンポーネントを含め，インポート対象のZIPファイルをすべて運用環境のリポジトリに展開します。全体展開を行う場合，cscrepctlコマンドに-overwriteオプションを指定します。

(3)　インポート時の制限事項

次のどれかに該当する場合，リポジトリ情報はインポートできません。

HCSCサーバがセットアップされていない場合（標準インポートのとき）

現在の運用環境のリポジトリ情報と，インポートするリポジトリ情報で，HCSCサーバの構成が異なる場合

現在配備されているビジネスプロセスやサービスアダプタが，インポートするリポジトリ情報では削除されている場合

現在配備されているビジネスプロセスやサービスアダプタが，インポートするリポジトリ情報では情報が更新されている場合

現在の運用環境のリポジトリ情報と，インポートするリポジトリ情報で，データベースおよびReliable Messagingを使用するかどうかの設定が異なる場合※

現在の運用環境のリポジトリ情報と，インポートするリポジトリ情報のSOAPモードが異なる場合

3.および4.の場合は，該当するビジネスプロセスやサービスアダプタを実行環境から削除したあと，リポジトリをインポートしてください。

注※

現在の運用環境のリポジトリ情報と，インポートするリポジトリ情報で，データベースおよびReliable Messagingを使用するかの設定が異なる場合でも，一部の場合についてはインポートできます。インポートできる場合とできない場合の設定を次の表に示します。

表4‒2　インポートできる場合とできない場合の設定

インポートするリポジトリ情報での設定

現在の運用環境のリポジトリ情報での設定

データベースとReliable Messagingの両方を使用する

データベースを使用してReliable Messagingを使用しない

データベースとReliable Messagingの両方を使用しない

データベースとReliable Messagingの両方を使用する

○

×

×

データベースを使用してReliable Messagingを使用しない

○

○

×

データベースとReliable Messagingの両方を使用しない

○

○

○

（凡例）

○：インポートできます。

×：インポートできません。

4.3.2　インポート時の自動バックアップ

リポジトリをインポートする際に，インポート前のリポジトリ情報をZIPファイル形式で自動バックアップします。バックアップファイルは，cscimport.zipのファイル名で次のディレクトリに出力されます。

<サービスプラットフォームのインストールディレクトリ>¥CSC¥spool¥manager

なお，バックアップファイルの出力先ディレクトリは，HCSC-Manager定義ファイルのcscmng.envbackup.dirパラメタ，またはcscmng.envbackup.dir.importパラメタで変更できます。

また，自動バックアップをするかどうかは，HCSC-Manager定義ファイルのcscmng.envbackup.autogetパラメタ，またはcscmng.envbackup.autoget.offパラメタで設定できます。

HCSC-Manager定義ファイルの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.5.3　HCSC-Manager定義ファイル」を参照してください。

また，バックアップファイルから運用環境を復旧する方法については，「7.9.3(2)　運用環境の復旧」を参照してください。

4.3.3　バージョンアップ時のインポート

現在のリポジトリ情報よりも新しいバージョンのリポジトリ情報をインポートすると，インポート時にリポジトリが自動でバージョンアップされます。

なお，現在配備されているビジネスプロセスやサービスアダプタが，インポートするリポジトリ情報では削除されている場合，バージョンアップ時のインポートでエラーが発生します。エラーが発生した場合，現在のリポジトリを運用環境からエクスポートして，開発環境にインポートします。そのあと，開発環境でバージョンアップしたリポジトリを開発環境からエクスポートして，運用環境にインポートしてください。

バージョンアップの詳細については，「付録G　旧バージョンからの移行」を参照してください。

4.4　リポジトリの情報の参照

リポジトリ内の情報は，コマンドで確認できます。未配備のビジネスプロセスやサービスアダプタを配備するときに，複数のビジネスプロセスやサービスアダプタの配備に失敗した場合は後処理されないため，cscreplsコマンドを使用して配備状況を確認します。

また，cscreplsコマンドに-privateオプションを指定することで，非公開コンポーネントを表示できます。運用環境のリポジトリ内に非公開コンポーネントが存在すると，サービスIDなどが重複し，コンポーネントインポートを実施できない場合があります。コンポーネントインポート機能を利用する場合は，-privateオプションを使用して非公開コンポーネントを確認し，適宜対処してください。

コマンドの実行例を次に示します。

リポジトリ情報を表示する場合

cscrepls -user <ログインユーザID> -pass <ログインパスワード> -repfile <エクスポートされたリポジトリZIPファイル名>

リポジトリ情報に非公開コンポーネントも含めて表示する場合

cscrepls -user <ログインユーザID> -pass <ログインパスワード> -repfile <エクスポートされたリポジトリZIPファイル名> -private

cscreplsコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscrepls（リポジトリ情報の表示）」を参照してください。

4.5　リポジトリの差分情報の参照

現在の運用環境のリポジトリ情報と指定したリポジトリ情報の差分は，cscrepdiffコマンドで確認できます。追加，変更，および削除されたビジネスプロセスやサービスアダプタの情報が確認できます。

4.5.1　前提条件

リポジトリ情報の差分を表示するには，次の条件を満たす必要があります。

現在の運用環境のリポジトリ情報と，差分表示の対象となるリポジトリ情報が，単一のクラスタ構成になっていること

現在の運用環境のリポジトリ情報と，差分表示の対象となるリポジトリ情報で，データベースおよびReliable Messagingを使用するかどうかの設定が一致していること※

現在の運用環境のリポジトリ情報と，差分表示の対象となるリポジトリ情報で，SOAPモードが一致していること

注※　

現在の運用環境のリポジトリ情報と，差分表示の対象となるリポジトリ情報で，データベースおよびReliable Messagingを使用するかの設定が異なる場合でも，一部の場合についてはリポジトリ情報の差分を表示できます。リポジトリ情報の差分を表示できる場合とできない場合の設定を次の表に示します。

表4‒3　リポジトリ情報の差分を表示できる場合とできない場合の設定

現在の運用環境のリポジトリ情報での設定

差分表示の対象となるリポジトリ情報での設定

データベースとReliable Messagingの両方を使用する

データベースを使用してReliable Messagingを使用しない

データベースとReliable Messagingの両方を使用しない

データベースとReliable Messagingの両方を使用する

○

×

×

データベースを使用してReliable Messagingを使用しない

○

○

○

データベースとReliable Messagingの両方を使用しない

○

○

×

（凡例）

○：差分を表示できます。

×：差分を表示できません。

4.5.2　表示方法

cscrepdiffコマンドを実行して，リポジトリの差分情報を表示します。コマンドの実行形式を次に示します。

リポジトリ情報の差分を表示する場合（標準インポート時）

cscrepdiff -user <ログインユーザID> -pass <ログインパスワード> -repfile <リポジトリZIPファイル名>

リポジトリ情報をすべて表示する場合（標準インポート時）

cscrepdiff -user <ログインユーザID> -pass <ログインパスワード> -repfile <リポジトリZIPファイル名> -allinfo

リポジトリ情報の差分を表示する場合（コンポーネントインポート時）

cscrepdiff -user <ログインユーザID> -pass <ログインパスワード> -repfile <リポジトリZIPファイル名> -compo

リポジトリ情報をすべて表示する場合（コンポーネントインポート時）

cscrepdiff -user <ログインユーザID> -pass <ログインパスワード> -repfile <リポジトリZIPファイル名> -compo -allinfo

cscrepdiffコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscrepdiff（リポジトリ情報の差分の表示）」を参照してください。

4.5.3　差分の表示内容

標準インポートとコンポーネントインポートで，リポジトリ情報の差分の表示内容が異なります。それぞれの場合の表示内容を次の表に示します。

表4‒4　差分の表示内容（標準インポート時）

運用環境リポジトリ

リポジトリZIPファイル

HCSCコンポーネントあり

HCSCコンポーネントなし

変更あり

変更なし

HCSCコンポーネントあり

change

no change※

delete

HCSCコンポーネントなし

add

−

×

（凡例）

×：表示されません。

−：該当する状況が発生しないため，表示されません。

注※

-allinfoオプションを指定した場合にだけ表示されます。-allinfoオプションを指定しない場合は，表示されません。

表4‒5　差分の表示内容（コンポーネントインポート時）

運用環境リポジトリ

リポジトリZIPファイル

HCSCコンポーネントあり

HCSCコンポーネントなし※1

変更あり

変更なし

HCSCコンポーネントあり

change

no change※2

no change※2

HCSCコンポーネントなし

add

−

×

（凡例）

×：表示されません。

−：該当する状況が発生しないため，表示されません。

注※1

cscrepdiffコマンドの-nameオプションに指定したサービスIDのHCSCコンポーネントがリポジトリZIPファイルに存在しない場合は，エラーとなります。

注※2

-allinfoオプションを指定した場合にだけ表示されます。-allinfoオプションを指定しない場合は，表示されません。

差分の表示内容の例を次に示します。

インポート元とインポート先の状態

インポートするリポジトリZIPファイルの内容

ビジネスプロセス1（bp1）：変更あり

ビジネスプロセス2（bp2）：変更なし

ビジネスプロセス4（bp4）：インポート対象外

インポート対象の運用環境のリポジトリの内容

ビジネスプロセス1（bp1）

ビジネスプロセス2（bp2）

ビジネスプロセス3（bp3）

リポジトリ情報の差分を表示する場合（標準インポート時）

cscrepdiff -repfile repository.zip
KEOS52129-I cscrepdiff will now start.
Command Edit Time: YYYY/MM/DD hh:mm:ss.SSS

[BusinessProcess]
change:
< Cluster/bp1 YYYY/MM/DD hh:mm:ss
> Cluster/bp1 YYYY/MM/DD hh:mm:ss
delete:
< Cluster/bp3 YYYY/MM/DD hh:mm:ss
add:
> Cluster/bp4 YYYY/MM/DD hh:mm:ss
KEOS52130-I cscrepdiff ended normally.

リポジトリ情報をすべて表示する場合（標準インポート時）

cscrepdiff -repfile repository.zip -allinfo
KEOS52129-I cscrepdiff will now start.
Command Edit Time: YYYY/MM/DD hh:mm:ss.SSS

[Business Process]
no change:
 Cluster/bp2 YYYY/MM/DD hh:mm:ss
change:
< Cluster/bp1 YYYY/MM/DD hh:mm:ss
> Cluster/bp1 YYYY/MM/DD hh:mm:ss
delete:
< Cluster/bp3 YYYY/MM/DD hh:mm:ss
add:
> Cluster/bp4 YYYY/MM/DD hh:mm:ss
KEOS52130-I cscrepdiff ended normally.

リポジトリ情報の差分を表示する場合（コンポーネントインポート時）

cscrepdiff -repfile repository.zip -compo
KEOS52129-I cscrepdiff will now start.
Command Edit Time: YYYY/MM/DD hh:mm:ss.SSS

[BusinessProcess]
change:
< Cluster/bp1 YYYY/MM/DD hh:mm:ss
> Cluster/bp1 YYYY/MM/DD hh:mm:ss
add:
> Cluster/bp4 YYYY/MM/DD hh:mm:ss
KEOS52130-I cscrepdiff ended normally.

リポジトリ情報をすべて表示する場合（コンポーネントインポート時）

cscrepdiff -repfile repository.zip -compo -allinfo
KEOS52129-I cscrepdiff will now start.
Command Edit Time: YYYY/MM/DD hh:mm:ss.SSS

[BusinessProcess]
no change:
 Cluster/bp2 YYYY/MM/DD hh:mm:ss
 Cluster/bp3 YYYY/MM/DD hh:mm:ss
change:
< Cluster/bp1 YYYY/MM/DD hh:mm:ss
> Cluster/bp1 YYYY/MM/DD hh:mm:ss
add:
> Cluster/bp4 YYYY/MM/DD hh:mm:ss
KEOS52130-I cscrepdiff ended normally.

4.6　コンポーネント単位でのリポジトリの追加，更新，および削除

コンポーネントインポート機能を使うと，複数の開発環境で開発したリポジトリ内のHCSCコンポーネントは，運用環境のリポジトリにcscrepctlコマンドで集約できます。

インポート対象のリポジトリZIPファイルに存在しないHCSCコンポーネントは，標準のインポートでは運用環境のリポジトリから削除します。コンポーネントインポート機能を使用すると，運用環境のリポジトリから削除しないで，リポジトリZIPファイル内の特定のHCSCコンポーネントだけ追加・更新できます。

コンポーネントインポート機能で実行できる作業は次のとおりです。

作業名

作業内容

cscrepctlコマンドで指定するオプション

HCSCコンポーネントの追加

運用環境のリポジトリにあるHCSCコンポーネントを残したまま，新しいHCSCコンポーネントを追加できます。

-import

HCSCコンポーネントの更新

運用環境のリポジトリにあるHCSCコンポーネントを置き換えられます。

-import，-overwrite

HCSCコンポーネントの削除

運用環境のリポジトリにあるHCSCコンポーネントを削除できます。

-delete

4.6.1　コンポーネント単位のリポジトリの追加・更新

コンポーネント単位でリポジトリを追加（インポート）または更新するには，cscrepctlコマンドに-importオプションを指定して実行します。インポートの前にcscrepcheckコマンドを実行すると，指定したリポジトリZIPファイル内のHCSCコンポーネントを運用環境のリポジトリにインポートできるか検証できます。

(1)　インポート前のインポート可否の検証（cscrepcheckコマンド）

cscrepcheckコマンドは，運用環境のリポジトリのHCSCコンポーネントの情報と状態を確認し，次の内容を検証して検証結果を表示します。cscrepcheckコマンドについては，マニュアル「サービスプラットフォームリファレンス」の「cscrepcheck（インポート可否の検証）」を参照してください。

リポジトリZIPファイルをインポートできるか

リポジトリZIPファイル内のHCSCコンポーネントをコンポーネント単位でインポートできるか

cscrepcheckコマンドではリポジトリのインポートは実行されません。リポジトリをインポートするにはcscrepctlコマンドを実行してください。

(a)　インポート可否を検証できないケース

次の場合は，リポジトリ情報のインポート可否は検証できません。

現在の運用環境のリポジトリ情報と，検証対象となるリポジトリ情報が，単一のクラスタ構成になっていない場合

現在の運用環境のリポジトリ情報と，検証対象となるリポジトリ情報で，SOAPモードが異なる場合

データベースおよびReliable Messagingを使用するかどうかの設定が異なる場合

設定が異なる場合のインポートの検証可否を次の表に示します。

表4‒6　インポート可否の検証ができる場合とできない場合の設定

現在の運用環境のリポジトリ情報での設定

検証の対象となるリポジトリ情報での設定

データベースとReliable Messagingの両方を使用する

データベースを使用してReliable Messagingを使用しない

データベースとReliable Messagingの両方を使用しない

データベースとReliable Messagingの両方を使用する

○

○

○

データベースを使用してReliable Messagingを使用しない

×

○

○

データベースとReliable Messagingの両方を使用しない

×

×

○

（凡例）

○：インポート可否を検証できます。

×：インポート可否を検証できません。

(b)　インポート可否の検証の実行

cscrepcheckコマンドを実行して，指定したリポジトリのインポート可否を検証する例を次に示します。この例では，HCSC-ManagerのユーザIDとパスワードはHCSC-Managerコマンド共通定義ファイルに定義していることを前提としています。

コマンド実行例1

repository.zip全体のインポート可否を検証します。

cscrepcheck -repfile D:¥tmp¥repository.zip

コマンド実行例2

repository.zipのコンポーネント単位でのインポート可否を検証します。

cscrepcheck -repfile D:¥tmp¥repository.zip -compo

コマンド実行例3

repository.zip内のサービスID「1」のインポート可否を検証します。

cscrepcheck -repfile D:¥tmp¥repository.zip -compo -name 1

(c)　インポート可否の検証結果

cscrepcheckコマンドの実行によって表示される検証結果の例を次に示します。

インポートできる場合

検証開始・検証終了メッセージを表示して，コマンドが正常終了します。

KEOS52322-I cscrepcheck will now start.
Command Edit Time: YYYY/MM/DD hh:mm:ss.SSS
KEOS50237-I Verification of the repository to be imported will now be started.
KEOS50238-I Verification of the repository to be imported has ended successfully.
KEOS52323-I cscrepcheck ended normally.

インポートできない場合

検証開始メッセージを表示したあと，インポートできないすべてのHCSCコンポーネントとその理由を表示して，検証がエラーであることを示すメッセージKEOS50239-Eを出力します。その後，コマンドが正常終了します。

KEOS52322-I cscrepcheck will now start.
Command Edit Time: YYYY/MM/DD hh:mm:ss.SSS
KEOS50237-I Verification of the repository to be imported will now be started.
…
<HCSCコンポーネントごとのエラーメッセージを表示>
…
KEOS50239-E Verification of the repository to be imported has ended with errors.
KEOS52323-I cscrepcheck ended normally.

このほかのエラーが発生した場合は，エラーメッセージKEOS50239-Eを出力しないでコマンドが異常終了します。

(2)　コンポーネント単位でのリポジトリのインポート（cscrepctlコマンド）

cscrepctlコマンドで，リポジトリをコンポーネント単位でインポートする例を次に示します。この例では，HCSC-ManagerのユーザIDとパスワードはHCSC-Managerコマンド共通定義ファイルに定義していることを前提としています。

コマンド実行例1

repository.zipにあるサービスID「1」のHCSCコンポーネントだけを運用環境のリポジトリにインポートします。

cscrepctl -import repository.zip -compo -name 1

コマンド実行例2

次のように-nameオプションを指定しなかった場合は，repository.zipにあるすべてのHCSCコンポーネントを運用環境のリポジトリにインポートします。

cscrepctl -import repository.zip -compo

コマンド実行例3

repository.zipにあるHCSCコンポーネントのうち，HCSCコンポーネント指定ファイル「hcsccomponent.txt」※に指定されているHCSCコンポーネントを運用環境のリポジトリに一括でインポートします。

cscrepctl -import repository.zip -compo -namelist hcsccomponent.txt

注※

HCSCコンポーネント指定ファイルについては，マニュアル「サービスプラットフォーム リファレンス」の「6.5.5　HCSCコンポーネント指定ファイル」を参照してください。

cscrepctlコマンドについては，マニュアル「サービスプラットフォーム リファレンス」の「cscrepctl（インポート/エクスポート）」を参照してください。

4.6.2　コンポーネント単位のリポジトリの削除

コンポーネントインポート機能では，コンポーネント情報がリポジトリ内で重複しているとインポートに失敗するため，重複するHCSCコンポーネントを事前に削除する必要があります。

コンポーネント単位のリポジトリを削除するには，cscrepctlコマンドに-deleteオプションを指定して実行します。これによって，HCSCコンポーネントが公開されているかどうかに関係なく，運用環境から削除されます。

cscrepctlコマンドで，リポジトリをコンポーネント単位で削除する例を次に示します。この例では，HCSC-ManagerのユーザIDとパスワードはHCSC-Managerコマンド共通定義ファイルに定義していることを前提としています。

コマンド実行例1

cscrepctlコマンドを利用して，運用環境のリポジトリからサービスID「1」のHCSCコンポーネントを削除します。

cscrepctl -delete -name 1

コマンド実行例2

運用環境のリポジトリにあるHCSCコンポーネントのうち，HCSCコンポーネント指定ファイル「hcsccomponent.txt」※に指定されているHCSCコンポーネントを一括で削除します。

cscrepctl -delete -namelist hcsccomponent.txt

注※

HCSCコンポーネント指定ファイルについては，マニュアル「サービスプラットフォーム リファレンス」の「6.5.5　HCSCコンポーネント指定ファイル」を参照してください。

cscrepctlコマンドについては，マニュアル「サービスプラットフォーム リファレンス」の「cscrepctl（インポート/エクスポート）」を参照してください。

4.7　リポジトリを更新する

運用環境にリポジトリをインポートしたあとに，開発環境でHCSCコンポーネントの定義を変更した場合，次の手順でリポジトリを更新します。

リポジトリをエクスポートします。

編集後の定義を保存したリポジトリをエクスポートします。

リポジトリのエクスポートは開発環境で実行します。

詳細は，マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」の「3.2.2　リポジトリをエクスポートする」を参照してください。

cscrepdiffコマンドを実行してリポジトリ情報の差分を確認します。

この手順は任意です。cscrepdiffコマンドでHCSCコンポーネント指定ファイルを作成しておくと，リポジトリの更新が容易になります。

詳細は，マニュアル「サービスプラットフォーム リファレンス」の「cscrepdiff（リポジトリ情報の差分の表示）」を参照してください。

csccompostopコマンドを実行してHCSCコンポーネントを停止します。

詳細は，マニュアル「サービスプラットフォーム リファレンス」の「csccompostop（HCSCコンポーネントの停止）」を参照してください。

csccompoundeployコマンドを実行して配備済みのHCSCコンポーネントを削除します。

詳細は，マニュアル「サービスプラットフォーム リファレンス」の「csccompoundeploy（配備済みのHCSCコンポーネントの削除）」を参照してください。

csccmctlコマンドを実行して，定義ファイルを運用環境から削除します。

運用環境で設定した定義ファイルを引き続き使用する場合，この手順は不要です。

詳細は，「3.1.11　HCSCコンポーネントの定義ファイルを運用環境から削除する」を参照してください。

cscsvcctlコマンドを実行して，運用環境で変更したサービス情報を削除します。

運用環境で変更したサービス情報を引き続き使用する場合，この手順は不要です。

詳細は，「3.1.6　サービス情報を変更する」を参照してください。

リポジトリをインポートします。

開発環境でエクスポートしたリポジトリを運用環境にインポートします。

リポジトリのインポートの詳細は，「4.3　リポジトリのインポート」を参照してください。

5　システム運用

この章では，ログイン，ログアウト，およびHCSCサーバの運用について説明します。

5.1　HCSCサーバのオペレーションをするための準備

HCSCサーバの運用を開始するには，HCSC-Managerにログインする必要があります。ログインとログアウトの方法について，以降の項で説明します。

5.1.1　ログインする

HCSCサーバにログインする方法を次に示します。

(1)　画面の場合

運用環境の画面を利用してHCSCサーバにログインする手順を次に示します。

Eclipseを起動します。

メニューから［HCSC-Manager］−［ログイン］を選択します。

現在のパースペクティブがHCSC-Managerパースペクティブの場合（ツリービューが表示されている場合），ユーザIDとパスワードを入力するダイアログが表示されます。

現在のパースペクティブがHCSC-Managerパースペクティブではない場合（ツリービューが表示されていない場合），パースペクティブを切り替えるかどうかを確認するダイアログが表示されます。パースペクティブを切り替える場合は［はい］，切り替えない場合は［いいえ］を選択します。そのあと，ユーザIDとパスワードを入力するダイアログが表示されます。

ユーザIDとパスワードを指定して，［OK］ボタンをクリックします。

ログインが正常に終了すると，サーバとHCSCコンポーネントの構成，状態がツリービューに表示されます。

ユーザIDとパスワードはcscpasswdコマンドで設定，変更できます。ユーザIDとパスワードの設定，変更の詳細については，「2.4.2　ユーザ情報を設定する」を参照してください。また，cscpasswdコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscpasswd（ユーザの管理）」を参照してください。

(2)　コマンドの場合

あらかじめ，HCSC-Managerコマンド共通定義ファイルの次のパラメタに，ログインユーザ名およびログインパスワードを指定しておくと，HCSC-Managerのコマンド実行時にログインユーザID，ログインパスワードの指定が不要になります。

csc.all.user=HCSC-Managerログインユーザ名

csc.all.pass=HCSC-Managerログインパスワード

(3)　ログイン時の注意事項

リポジトリの更新を伴う次のコマンドの実行中は，これらのコマンドで使用するリポジトリが同じで排他されるため，画面またはコマンドでログインできません。コマンドの実行が終了してからログインしてください。

csccompodeploy（HCSCコンポーネントの配備）

csccompoundeploy（HCSCコンポーネントの削除）

cscenvrestore（HCSC-Manager環境のリストア）

cscpasswd（ユーザの管理）

cscrepctl（インポート/エクスポート）

cscsvcctl（サービス情報の管理）

cscsvsetup（HCSCサーバのセットアップ）

cscsvunsetup（HCSCサーバのアンセットアップ）

5.1.2　ログアウトする

HCSCサーバからログアウトする方法を次に示します。

(1)　画面の場合

運用環境の画面を利用してHCSCサーバからログアウトする手順を次に示します。

メニューから［HCSC-Manager］−［ログアウト］を選択します。

ログアウトを確認するダイアログが表示されます。

［OK］ボタンをクリックします。

ログアウトが正常に終了すると，画面は初期状態に戻ります。

(2)　コマンドの場合

HCSC-Managerのコマンドの終了時にログアウトできます。

5.2　システム運用時の注意事項

システム運用時の注意事項を次に示します。

Service Coordinatorは，Reliable Messagingのキューを作成して利用します。このキューをReliable Messagingのコマンドで操作すると，HCSCサーバの状態が不正になるため，キューを操作しないでください。

Service Coordinatorからネットワークドライブにアクセスできません。コマンドの引数や各種定義に，ネットワークドライブ上のパスを指定しないでください。

Windowsの場合，HCSCサーバの運用は，すべて「Administrators」グループに属するユーザで実行してください。

Windowsの場合，HCSC-Manager Plug-inのメニューの活性／非活性の状態がすぐに反映されないで，実行できないメニューが活性化していることがあります。適切な状態にするには，アクティブになっているビューとは別のビューを選択してください。

Windowsの場合，HCSC-Manager Plug-inを使用するときは，Eclipseメニューから［ウィンドウ］−［新規ウィンドウ］を実行しないでください。

Windowsの場合，ログイン以外のHCSC-Manager Plug-inの機能は，HCSC-Managerパースペクティブで使用することを推奨します。

HCSCサーバ運用時に警告メッセージKDCCE0605-Wが出力される場合がありますが，特に対処する必要はありません。

HCSCサーバ利用時は，RSA BSAFE SSL-Jを使用したSSL/TLS通信は利用できません。

旧バージョンのWSDLからスタブを生成していた場合は，新しいバージョンのWSDLを基に，スタブを再生成してください。

XML電文を送受信した際，電文の内容やシステム構成によっては，電文内の文字が文字参照または実体参照に変換される場合があります。文字参照および実体参照とは，「&#x61;」や「&lt;」などの表記方法です。文字参照および実体参照の詳細についてはXML 1.0のドキュメントの，文字参照と実体参照に関する説明を参照してください。

09-00でビジネスプロセスのトランザクションのコミットタイミングが変わりました。詳細については，マニュアル「サービスプラットフォーム 解説」の「3.4　ビジネスプロセスのトランザクション」を参照してください。

HCSCサーバでは，パーサ切り替え機能を使用できません。パーサ切り替え機能については，マニュアル「XML Processor ユーザーズガイド」の「3.7　パーサ切り替え機能」を参照してください。

この製品の08-00以降のバージョンでは，KDEC00001-EとKDEC60002-Eのメッセージテキストにルートアプリケーション情報が表示されます。

Service Coordinatorは，シンボリックリンクをサポートしていません。各種定義には，シンボリックリンクを含むパスを指定しないでください。

5.3　HCSCサーバのオペレーション運用

サービスプラットフォームの運用環境を利用して，セットアップ済みのシステムを運用する方法について説明します。

5.3.1　運用の流れ

次に示す場合の運用の流れについて説明します。

運用する前の準備

運用を開始する場合

運用中にシステムを操作する場合

運用を終了する場合

それぞれの場合に必要な操作の前提条件や手順については，以降の項で説明します。

(1)　運用する前の準備

運用する前に，次の作業を実施することを推奨します。

(a)　論理サーバの登録

論理サーバの操作（HCSCサーバとの一括起動・停止，および状態の参照）をできるようにするため，HCSC-Manager定義ファイルのパラメタを次のように変更します。

cscmng.server.<HCSCサーバ名>.system=論理サーバ名

(b)　リポジトリへのアクセスの制御

セキュリティを確保するため，リポジトリにアクセスしないようにします。

リポジトリのルートディレクトリを変更していない場合は，次のリポジトリにアクセスしないようにします。

<サービスプラットフォームのインストールディレクトリ>¥CSC¥repository

リポジトリのルートディレクトリを変更した場合は，変更後のリポジトリにアクセス制御を実施してください。

1台のマシンに複数の運用環境を構築（環境変数CSCMNG_HOMEを設定）している場合は，次のリポジトリにアクセス制御を実施してください。

%CSCMNG_HOME%¥repository

(c)　バックアップ

運用時の障害に備えて，運用環境の情報をバックアップします。バックアップした情報を，運用環境とは別のマシンで管理することによって，障害発生後，運用環境を復旧できます。バックアップはcscenvbackupコマンドを実行します。cscenvbackupコマンドの詳細については，マニュアル「サービスプラットフォームリファレンス」の「cscenvbackup（HCSC-Manager環境のバックアップ）」を参照してください。

(2)　運用を開始する場合

システムを起動して運用を開始するには，次の図に示す流れに従って作業を実施する必要があります。

図5‒1　運用を開始する場合の作業の流れ

注※1

これらの作業を一括して実行することもできます。なお，HCSCコンポーネントの開始前には，HCSCコンポーネントのパッケージング，配備定義，および配備が実行されます。

ただし，一括実行は，システム開発時，または単体テストから結合テスト時を対象としています。詳細については，マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」の「8.5　HCSCコンポーネントをHCSCサーバに配備して開始する処理の一括実行」を参照してください。

注※2

cscrcptnstartコマンドを使用して，同時に開始することもできます。

(3)　運用中にシステムを操作する場合

システムの運用中，必要に応じて次の操作を実施できます。

(a)　状態・情報の参照

必要に応じて，各状態・情報を参照できます。参照できる状態・情報は次のとおりです。参照方法については，「5.3.11　データベースの状態を確認する」以降の項で説明します。

データベースの状態

PRFの状態

HTTP Serverの状態（HTTP Serverを使用する場合）

Managerの状態

HCSCサーバのセットアップ情報

HCSCサーバの情報

サービスアダプタの情報

ビジネスプロセスの情報

ユーザ定義受付の情報

なお，次に示す実行環境の構成要素およびHCSCサーバの状態は，定期的に確認する必要があります。

データベースの起動状態

PRFの起動状態

HTTP Serverの起動状態（HTTP Serverを使用する場合）

Managerの起動状態

HCSCサーバの起動状態および開始状態

(b)　定義情報のキャッシュ

必要に応じてビジネスプロセスの定義情報をキャッシュできます。キャッシュ方法については，「5.3.22　ビジネスプロセスの定義情報をキャッシュする」の項で説明します。

(c)　定義や構成などの変更

必要に応じて，次の定義や構成などを変更できます。変更方法については，「5.3.23　HCSCサーバの定義を変更する」以降の項で説明します。

HCSCサーバの定義

ユーザ定義受付の定義情報

HCSCコンポーネントの構成

サービス部品の接続先

流量制御値

通信タイムアウト値

リソースアダプタのプロパティを変更する

(4)　運用を終了する場合

システムを停止して運用を終了するには，次の図に示す流れに従って作業を実施する必要があります。停止方法については，「5.3.35　標準受付を停止する」以降の項で説明します。

図5‒2　運用を終了する場合の作業の流れ

注※1

cscrcptnstopコマンドを使用して，同時に停止することもできます。

注※2

サービス部品の実行要求を受け付けないようにする場合に実施します。

注※3

これらの作業を一括して実行することもできます。なお，HCSCコンポーネントの停止後には，HCSCコンポーネントがHCSCサーバから削除されます。ただし，一括実行は，システム開発時，または単体テストから結合テスト時を対象としています。詳細については，マニュアル「サービスプラットフォーム開発ガイド 基本開発編」の「8.6　HCSCコンポーネントを停止してHCSCサーバから削除する処理の一括実行」を参照してください。

5.3.2　データベースを起動する

データベースの起動方法について次に説明します。

(1)　起動方法（HiRDBの場合）

HiRDBを起動するには，データベースサーバでpdstartコマンドを実行します。

pdstartコマンドの詳細については，マニュアル「HiRDB コマンドリファレンス」を参照してください。

(2)　起動方法（Oracleの場合）

Oracleを起動する方法については，Oracle Corporationが発行するドキュメントを参照してください。

5.3.3　PRFを起動する

PRFを起動するには，運用環境でcscsvstartコマンドを実行します。-logicalオプションにPRFの論理サーバ名を指定して実行します。

cscsvstartコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscsvstart（HCSCサーバの起動）」を参照してください。

cscsvstartコマンドの実行形式を次に示します。

cscsvstart -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -logical <PRFの論理サーバ名>

5.3.4　HCSCサーバを起動する

HCSCサーバの起動の前提条件と起動方法について次に説明します。

(1)　前提条件

HCSCサーバを起動するとき，HCSCサーバが起動できなかったり，サービスアダプタまたはビジネスプロセスが開始できなかったりすると，サービスアダプタ，ビジネスプロセス，または受付が停止状態になる場合があります。この場合，エラーになった原因を取り除いたあと，サービスアダプタ，ビジネスプロセス，または受付の開始操作をする必要があります。

サービスアダプタおよびビジネスプロセスの開始方法については，「5.3.7　サービスアダプタを開始する」，または「5.3.8　ビジネスプロセスを開始する」を参照してください。受付の開始方法については，「5.3.9　ユーザ定義受付を開始する」，および「5.3.10　標準受付を開始する」を参照してください。

(2)　起動方法

HCSCサーバを起動する方法を次に示します。

(a)　画面の場合

運用環境の画面を利用してHCSCサーバを起動する手順を次に示します。

ツリービュー上で，起動するHCSCサーバをダブルクリックします。

選択したHCSCサーバの情報がエディタエリアに表示されます。

エディタエリアで［稼働運用］タブを選択します。

稼働運用ページに，手順1で選択したHCSCサーバの稼働運用に関する情報が表示されます。

HCSCサーバの稼働運用ページの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「4.4　稼働運用ページ」を参照してください。

稼働運用ページに表示された内容を確認し，「HCSCサーバ」の［起動］ボタンをクリックします。

HCSCサーバの起動を確認するダイアログが表示されます。

ダイアログに表示された内容を確認し，［OK］ボタンをクリックします。

HCSCサーバの起動処理が開始されます。起動処理中のログはコンソールビューに出力されます。

［キャンセル］ボタンをクリックした場合は，起動処理を実行しないで稼働運用ページに戻ります。

HCSCサーバの起動処理が完了すると，実行結果を示すダイアログが表示されます。

実行結果を示すダイアログを確認します。

起動処理が成功した場合

［OK］ボタンをクリックして，稼働運用ページに戻ります。

稼働運用ページでは，HCSCサーバの稼働状態が「起動状態」になります。また，［起動］ボタンが非活性化し，［停止］ボタンが活性化します。

起動処理が失敗した場合

ダイアログにエラーの内容が表示されます。詳細情報に表示されるメッセージIDを参照して対処してください。

(b)　コマンドの場合

HCSCサーバを起動するには，運用環境でcscsvstartコマンドまたはcscutilコマンドを実行します。クラスタ内のHCSCサーバを一括して起動する場合，または論理サーバを起動する場合は，cscsvstartコマンドを実行します。

cscsvstartコマンドおよびcscutilコマンドは，次の場合に使用します。

cscsvstartコマンド

該当するリポジトリが存在する運用環境で，HCSCサーバを起動する場合。

cscutilコマンド

該当するリポジトリがなく，cscutilコマンドが使用できる環境（例えば，JP1で直接運用している実行環境）でHCSCサーバを起動する場合。

それぞれのコマンドの実行方法を次に説明します。

●cscsvstartコマンドの場合

運用環境でcscsvstartコマンドを実行します。

cscsvstartコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscsvstart（HCSCサーバの起動）」を参照してください。

cscsvstartコマンドの実行形式を次に示します。

クラスタ内のHCSCサーバを一括して起動する場合

クラスタ名を指定して実行します。-clusterオプションで指定したクラスタ内のすべてのHCSCサーバが一括して起動されます（論理サーバは起動されません）。

cscsvstart -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名>

クラスタ内のHCSCサーバの起動と同時に論理サーバを起動する場合は，-systemオプションを指定します。ただし，HCSC-Manager定義ファイルに論理サーバを登録している必要があります。論理サーバの登録の詳細については，「5.3.1(1)　運用する前の準備」を参照してください。

cscsvstart -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -system

また，HCSCサーバは起動しないで指定した論理サーバだけを起動する場合は，-logicalオプションを指定します。

cscsvstart -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -logical <論理サーバ名>

それぞれのHCSCサーバを1つずつ起動する場合

HCSCサーバ名を指定して実行します。-cscオプションで指定したHCSCサーバが起動されます（論理サーバは起動されません）。

cscsvstart -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名>

HCSCサーバの起動と同時に論理サーバを起動する場合は，-systemオプションを指定します。

cscsvstart -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -system

また，HCSCサーバは起動しないで指定した論理サーバだけを起動する場合は，-logicalオプションを指定します。

cscsvstart -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -logical <論理サーバ名>

●cscutilコマンドの場合

運用環境でcscutilコマンドを実行します。-targetオプションにserverを，また-operationオプションにstartを指定します。

cscutilコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscutil（各種操作）」を参照してください。

cscutilコマンドの実行形式は，プロパティ定義ファイルを使用するかどうかによって異なります。

プロパティ定義ファイルを使用しない場合

-propsオプションにHCSCサーバ名およびJ2EEサーバ名を指定します。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Manager名> -target server -operation start -props "CSCSrvName=<HCSCサーバ名>, J2EESrvName=<J2EEサーバ名>"

cscutilコマンドに指定するManager名，HCSCサーバ名およびJ2EEサーバ名は，cscreplsコマンドで確認できます。cscreplsコマンドの詳細については，マニュアル「サービスプラットフォームリファレンス」の「cscrepls（リポジトリ情報の表示）」を参照してください。

プロパティ定義ファイルを使用する場合

-propfileオプションにプロパティ定義ファイル名を指定します。プロパティ定義ファイルは，J2SEのプロパティファイル形式であらかじめ作成しておく必要があります。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Manager名> -target server -operation start -propfile <プロパティ定義ファイル名>

5.3.5　KafkaインバウンドアダプタおよびgRPCインバウンドアダプタを起動する

KafkaインバウンドアダプタおよびgRPCインバウンドアダプタを起動するときの前提条件，および起動方法について説明します。

(1)　前提条件

KafkaインバウンドアダプタおよびgRPCインバウンドアダプタを起動するには，HCSCサーバが起動状態である必要があります。

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

(2)　起動方法

KafkaインバウンドアダプタおよびgRPCインバウンドアダプタを起動するには，運用環境でcjstartrarコマンドを実行します。

インバウンドアダプタを起動する場合のコマンドの実行形式を次に示します。

<サービスプラットフォームのインストールディレクトリ>¥CC¥admin¥bin¥cjstartrar <J2EEサーバ名称> -resname <リソースアダプタ表示名>

cjstartrarコマンドの詳細は，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「2.4　J2EEサーバで使用するリソース操作コマンド」を参照してください。

5.3.6　HTTP Serverを起動する

HTTP Serverを起動するには，運用環境でcscsvstartコマンドを実行します。-logicalオプションにHTTP Serverの論理サーバ名を指定して実行します。

cscsvstartコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscsvstart（HCSCサーバの起動）」を参照してください。

cscsvstartコマンドの実行形式を次に示します。

cscsvstart -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -logical <HTTP Serverの論理サーバ名>

5.3.7　サービスアダプタを開始する

サービスアダプタの開始の前提条件と開始方法について次に説明します。

(1)　前提条件

サービスアダプタを開始するには，HCSCサーバが起動状態である必要があります。

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

(2)　開始方法

サービスアダプタを開始する方法を次に示します。

(a)　画面の場合

運用環境の画面を利用してサービスアダプタを開始する手順を次に示します。

ツリービュー上で，開始するサービスアダプタをダブルクリックします。

ダブルクリックしたサービスアダプタの情報がエディタエリアの稼働運用ページに表示されます。

サービスアダプタの稼働運用ページの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「4.4　稼働運用ページ」を参照してください。

稼働運用ページに表示された内容を確認し，［開始］ボタンをクリックします。

サービスアダプタの開始を確認するダイアログが表示されます。

ダイアログに表示された内容を確認し，［OK］ボタンをクリックします。

サービスアダプタの開始処理が開始されます。開始処理中のログはコンソールビューに出力されます。

［キャンセル］ボタンをクリックした場合は，開始処理を実行しないで稼働運用ページに戻ります。

サービスアダプタの開始処理が完了すると，実行結果を示すダイアログが表示されます。

実行結果を示すダイアログを確認します。

開始処理が成功した場合

［OK］ボタンをクリックして，稼働運用ページに戻ります。

稼働運用ページでは，サービスアダプタの状態が「開始状態」になります。また，［開始］ボタンが非活性化し，［停止］ボタンが活性化します。

開始処理が失敗した場合

ダイアログにエラーの内容が表示されます。詳細情報に表示されるメッセージIDを参照して対処してください。

(b)　コマンドの場合

サービスアダプタを開始するには，運用環境でcsccompostartコマンドまたはcscutilコマンドを実行します。

csccompostartコマンドおよびcscutilコマンドは，次の場合に使用します。

csccompostartコマンド

該当するリポジトリが存在する運用環境で，サービスアダプタを開始する場合。

cscutilコマンド

該当するリポジトリがなく，cscutilコマンドが使用できる環境（例えば，JP1で直接運用している実行環境）でサービスアダプタを開始する場合。

それぞれのコマンドの実行方法を次に説明します。

●csccompostartコマンドの場合

運用環境でcsccompostartコマンドを実行します。

csccompostartコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「csccompostart（HCSCコンポーネントの開始）」を参照してください。

csccompostartコマンドの実行形式を次に示します。

クラスタ内のすべてのHCSCサーバに配備されているサービスアダプタを一括して開始する場合（クラスタ単位）

クラスタ名と-allオプションを指定して実行します。

-clusterオプションで指定したクラスタ内のすべてのHCSCサーバに配備されているサービスアダプタが一括して開始されます（開始されていないビジネスプロセスおよびユーザ定義受付も同時にすべて開始されます）。

csccompostart -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -all

ビジネスプロセスおよびユーザ定義受付を開始しないでサービスアダプタだけを開始する場合は，サービスアダプタのサービスIDを指定します。

csccompostart -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -name <サービスアダプタのサービスID>

HCSCサーバに配備されているサービスアダプタを一括して開始する場合（HCSCサーバ単位）

HCSCサーバ名と-allオプションを指定して実行します。

-cscオプションで指定したHCSCサーバに配備されているサービスアダプタが開始されます（開始されていないビジネスプロセスおよびユーザ定義受付も同時にすべて開始されます）。

csccompostart -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -all

ビジネスプロセスおよびユーザ定義受付を開始しないでサービスアダプタだけを開始する場合は，サービスアダプタのサービスIDを指定します。

csccompostart -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -name <サービスアダプタのサービスID>

●cscutilコマンドの場合

運用環境でcscutilコマンドを実行します。-targetオプションにcompoを，また-operationオプションにstartを指定します。

cscutilコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscutil（各種操作）」を参照してください。

cscutilコマンドの実行形式は，プロパティ定義ファイルを使用するかどうかによって異なります。

プロパティ定義ファイルを使用しない場合

-propsオプションにサービスアダプタのサービスID，HCSCサーバ名，J2EEサーバ名および種別を指定します。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Manager名> -target compo -operation start -props "AdapterName=<サービスアダプタのサービスID>, CSCSrvName=<HCSCサーバ名>, J2EESrvName=<J2EEサーバ名>, ServiceKind=serviceAdapter"

cscutilコマンドに指定するManager名，サービスアダプタのサービスID，HCSCサーバ名およびJ2EEサーバ名は，cscreplsコマンドで確認できます。cscreplsコマンドの詳細については，マニュアル「サービスプラットフォームリファレンス」の「cscrepls（リポジトリ情報の表示）」を参照してください。

プロパティ定義ファイルを使用する場合

-propfileオプションにプロパティ定義ファイル名を指定します。プロパティ定義ファイルは，J2SEのプロパティファイル形式であらかじめ作成しておく必要があります。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Manager名> -target compo -operation start -propfile <プロパティ定義ファイル名>

5.3.8　ビジネスプロセスを開始する

ビジネスプロセスの開始の前提条件と開始方法について次に説明します。

(1)　前提条件

ビジネスプロセスを開始するには，HCSCサーバが起動状態である必要があります。

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

(2)　開始方法

ビジネスプロセスを開始する方法を次に示します。

(a)　画面の場合

運用環境の画面を利用してビジネスプロセスを開始する手順を次に示します。

ツリービュー上で，開始するビジネスプロセスをダブルクリックします。

ダブルクリックしたビジネスプロセスの情報がエディタエリアに表示されます。

エディタエリアで稼働運用ページを選択します。

手順1で選択したビジネスプロセスの稼働運用に関する情報が表示されます。

ビジネスプロセスの稼働運用ページの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「4.4　稼働運用ページ」を参照してください。

稼働運用ページに表示された内容を確認し，［開始］ボタンをクリックします。

ビジネスプロセスの開始を確認するダイアログが表示されます。

ダイアログに表示された内容を確認し，［OK］ボタンをクリックします。

ビジネスプロセスの開始処理が開始されます。開始処理中のログはコンソールビューに出力されます。

［キャンセル］ボタンをクリックした場合は，開始処理を実行しないで稼働運用ページに戻ります。

ビジネスプロセスの開始処理が完了すると，実行結果を示すダイアログが表示されます。

実行結果を示すダイアログを確認します。

開始処理が成功した場合

［OK］ボタンをクリックして，稼働運用ページに戻ります。

稼働運用ページでは，ビジネスプロセスの稼働状態が「開始状態」になります。また，［開始］ボタンが非活性化し，［停止］ボタンが活性化します。

開始処理が失敗した場合

ダイアログにエラーの内容が表示されます。詳細情報に表示されるメッセージIDを参照して対処してください。

(b)　コマンドの場合

ビジネスプロセスを開始するには，運用環境でcsccompostartコマンドまたはcscutilコマンドを実行します。

csccompostartコマンドおよびcscutilコマンドは，次の場合に使用します。

csccompostartコマンド

該当するリポジトリが存在する運用環境で，ビジネスプロセスを開始する場合。

cscutilコマンド

該当するリポジトリがなく，cscutilコマンドが使用できる環境（例えば，JP1で直接運用している実行環境）でビジネスプロセスを開始する場合。

それぞれのコマンドの実行方法を次に説明します。

●csccompostartコマンドの場合

運用環境でcsccompostartコマンドを実行します。

csccompostartコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「csccompostart（HCSCコンポーネントの開始）」を参照してください。

csccompostartコマンドの実行形式を次に示します。

クラスタ内のすべてのHCSCサーバに配備されているビジネスプロセスを一括して開始する場合（クラスタ単位）

クラスタ名と-allオプションを指定して実行します。

-clusterオプションで指定したクラスタ内のすべてのHCSCサーバに配備されているビジネスプロセスが一括して開始されます（開始されていないサービスアダプタおよびユーザ定義受付も同時にすべて開始されます）。

csccompostart -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -all

サービスアダプタおよびユーザ定義受付を開始しないでビジネスプロセスだけを開始する場合は，ビジネスプロセスのサービスIDを指定します。

csccompostart -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -name <ビジネスプロセスのサービスID>

HCSCサーバに配備されているビジネスプロセスを一括して開始する場合（HCSCサーバ単位）

HCSCサーバ名と-allオプションを指定して実行します。

-cscオプションで指定したHCSCサーバに配備されているビジネスプロセスが開始されます（開始されていないサービスアダプタおよびユーザ定義受付も同時にすべて開始されます）。

csccompostart -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -all

サービスアダプタおよびユーザ定義受付を開始しないでビジネスプロセスだけを開始する場合は，ビジネスプロセスのサービスIDを指定します。

csccompostart -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -name <ビジネスプロセスのサービスID>

●cscutilコマンドの場合

運用環境でcscutilコマンドを実行します。-targetオプションにcompoを，また-operationオプションにstartを指定します。

cscutilコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscutil（各種操作）」を参照してください。

cscutilコマンドの実行形式は，プロパティ定義ファイルを使用するかどうかによって異なります。

プロパティ定義ファイルを使用しない場合

-propsオプションにビジネスプロセスのサービスID，HCSCサーバ名，J2EEサーバ名および種別を指定します。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Manager名> -target compo -operation start -props "AdapterName=<ビジネスプロセスのサービスID>, CSCSrvName=<HCSCサーバ名>, J2EESrvName=<J2EEサーバ名>, ServiceKind=bp"

cscutilコマンドに指定するManager名，ビジネスプロセスのサービスID，HCSCサーバ名およびJ2EEサーバ名は，cscreplsコマンドで確認できます。cscreplsコマンドの詳細については，マニュアル「サービスプラットフォームリファレンス」の「cscrepls（リポジトリ情報の表示）」を参照してください。

プロパティ定義ファイルを使用する場合

-propfileオプションにプロパティ定義ファイル名を指定します。プロパティ定義ファイルは，J2SEのプロパティファイル形式であらかじめ作成しておく必要があります。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Manager名> -target compo -operation start -propfile <プロパティ定義ファイル名>

5.3.9　ユーザ定義受付を開始する

ユーザ定義受付を開始するための前提条件と，開始方法について次に説明します。

(1)　前提条件

ユーザ定義受付を開始するには，次の条件を満たしている必要があります。

HCSCサーバが起動状態であること。

ユーザ定義受付（呼出先固定）の場合，ユーザ定義受付（呼出先固定）が定義されているビジネスプロセスが開始状態であること。

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

(2)　開始方法

ユーザ定義受付を開始する方法を次に示します。

(a)　画面の場合

運用環境の画面を利用してユーザ定義受付を開始する手順を次に示します。

ツリービュー上で，開始するユーザ定義受付をダブルクリックします。

ダブルクリックしたユーザ定義受付の情報がエディタエリアの稼働運用ページに表示されます。

ユーザ定義受付の稼働運用ページの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「4.4　稼働運用ページ」を参照してください。

稼働運用ページに表示された内容を確認し，［開始］ボタンをクリックします。

ユーザ定義受付の開始を確認するダイアログが表示されます。

ダイアログに表示された内容を確認し，［OK］ボタンをクリックします。

ユーザ定義受付の開始処理が開始されます。開始処理中のログはコンソールビューに出力されます。

［キャンセル］ボタンをクリックした場合は，開始処理を実行しないで稼働運用ページに戻ります。

ユーザ定義受付の開始処理が完了すると，実行結果を示すダイアログが表示されます。

実行結果を示すダイアログを確認します。

開始処理が成功した場合

［OK］ボタンをクリックして，稼働運用ページに戻ります。

稼働運用ページでは，ユーザ定義受付の状態が「開始状態」になります。また，［開始］ボタンが非活性化し，［停止］ボタンが活性化します。

開始処理が失敗した場合

ダイアログにエラーの内容が表示されます。詳細情報に表示されるメッセージIDを参照して対処してください。

(b)　コマンドの場合

ユーザ定義受付を開始するには，運用環境でcscrcptnstartコマンドまたはcsccompostartコマンドを実行します。

cscrcptnstartコマンドおよびcsccompostartコマンドは，次の場合に使用します。

cscrcptnstartコマンド

受付を一括して開始する場合に使用します。

HCSCサーバに配備されているユーザ定義受付を一括して開始する場合に使用します。

クラスタ単位で一括して開始することもできます。なお，特定のユーザ定義受付だけを開始することはできません。

該当するリポジトリが存在する運用環境で，ユーザ定義受付を開始する場合に使用します。

csccompostartコマンド

サービスアダプタ，ビジネスプロセスおよびユーザ定義受付を一括して開始する場合に使用します。

ユーザ定義受付だけを一括で開始することはできません。

HCSCサーバに配備されている特定のユーザ定義受付を開始する場合に使用します。

クラスタ単位で特定のユーザ定義受付を開始することもできます。

該当するリポジトリが存在する運用環境で，ユーザ定義受付を開始する場合に使用します。

それぞれのコマンドの実行方法を次に説明します。

●cscrcptnstartコマンドの場合

運用環境でcscrcptnstartコマンドを実行します。

cscrcptnstartコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscrcptnstart（標準受付およびユーザ定義受付の開始）」を参照してください。

cscrcptnstartコマンドの実行形式を次に示します。

クラスタ内のすべてのHCSCサーバに配備されているユーザ定義受付を一括して開始する場合（クラスタ単位）

クラスタ名を指定して実行します。

-clusterオプションで指定したクラスタ内のすべてのHCSCサーバに配備されている受付が一括して開始されます（開始されていない標準受付も同時にすべて開始されます）。

cscrcptnstart -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名>

標準受付を開始しないでユーザ定義受付だけを開始する場合は，-userdefオプションを指定します。

cscrcptnstart -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -userdef

HCSCサーバに配備されているユーザ定義受付を一括して開始する場合（HCSCサーバ単位）

HCSCサーバ名を指定して実行します。

-cscオプションで指定したHCSCサーバに配備されている受付が開始されます（開始されていない標準受付も同時にすべて開始されます）。

cscrcptnstart -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名>

標準受付を開始しないでユーザ定義受付だけを開始する場合は，-userdefオプションを指定します。

cscrcptnstart -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -userdef

●csccompostartコマンドの場合

運用環境でcsccompostartコマンドを実行します。

csccompostartコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「csccompostart（HCSCコンポーネントの開始）」を参照してください。

csccompostartコマンドの実行形式を次に示します。

クラスタ内のすべてのHCSCサーバに配備されているユーザ定義受付を一括して開始する場合（クラスタ単位）

クラスタ名と-allオプションを指定して実行します。

-clusterオプションで指定したクラスタ内のすべてのHCSCサーバに配備されているユーザ定義受付が一括して開始されます（開始されていないサービスアダプタおよびビジネスプロセスも同時にすべて開始されます）。

csccompostart -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -all

HCSCサーバに配備されているユーザ定義受付を一括して開始する場合（HCSCサーバ単位）

HCSCサーバ名と-allオプションを指定して実行します。

-cscオプションで指定したHCSCサーバに配備されている，ユーザ定義受付が開始されます（開始されていないサービスアダプタおよびビジネスプロセスも同時にすべて開始されます）。

csccompostart -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -all

クラスタ内のすべてのHCSCサーバに配備されている特定のユーザ定義受付を開始する場合

クラスタ名とユーザ定義受付の受付IDを指定して実行します。

csccompostart -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -name <ユーザ定義受付の受付ID>

HCSCサーバに配備されている特定のユーザ定義受付を開始する場合

HCSCサーバ名とユーザ定義受付の受付IDを指定して実行します。

csccompostart -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -name <ユーザ定義受付の受付ID>

(3)　注意事項

SOAP受付を開始する際，初期化に失敗しても画面操作やコマンドによる開始は正常終了する場合があります。SOAP受付の初期化に失敗しているかどうかは，メッセージログにKDJW40002-Eが出力されているかどうかで確認してください。

5.3.10　標準受付を開始する

標準受付の開始の前提条件と開始方法について次に説明します。

(1)　前提条件

標準受付を開始するには，HCSCサーバが起動状態である必要があります。

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

(2)　開始方法

標準受付を開始する方法を次に示します。

注意事項

標準受付が開始できなかった場合，エラーになった原因を取り除いたあと，標準受付を強制停止してください。標準受付を停止状態にしたあとで，再度標準受付を開始して運用を再開してください。標準受付を強制停止する方法については，「5.3.35　標準受付を停止する」を参照してください。

(a)　画面の場合

運用環境の画面を利用して標準受付を開始する手順を次に示します。

ツリービュー上で，標準受付を開始するHCSCサーバをダブルクリックします。

ダブルクリックしたHCSCサーバの情報がエディタエリアに表示されます。

エディタエリアで［稼働運用］タブを選択します。

稼働運用ページに，手順1で選択したHCSCサーバの稼働運用に関する情報が表示されます。

HCSCサーバの稼働運用ページの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「4.4　稼働運用ページ」を参照してください。

稼働運用ページに表示された内容を確認し，「標準受付」の［開始］ボタンをクリックします。

標準受付の開始を確認するダイアログが表示されます。

ダイアログに表示された内容を確認し，［OK］ボタンをクリックします。

標準受付の開始処理が開始されます。開始処理中のログはコンソールビューに出力されます。

［キャンセル］ボタンをクリックした場合は，開始処理を実行しないで稼働運用ページに戻ります。

標準受付の開始処理が完了すると，実行結果を示すダイアログが表示されます。

実行結果を示すダイアログを確認します。

開始処理が成功した場合

［OK］ボタンをクリックして，稼働運用ページに戻ります。

稼働運用ページでは，標準受付の稼働状態が「開始状態」になります。また，［開始］ボタンが非活性化し，［通常停止］ボタンおよび［計画停止］ボタンが活性化します。

開始処理が失敗した場合

ダイアログにエラーの内容が表示されます。詳細情報に表示されるメッセージIDを参照して対処してください。

(b)　コマンドの場合

標準受付を開始するには，運用環境でcscrcptnstartコマンドまたはcscutilコマンドを実行します。

cscrcptnstartコマンドおよびcscutilコマンドは，次の場合に使用します。

cscrcptnstartコマンド

該当するリポジトリが存在する運用環境で，標準受付を開始する場合。

cscutilコマンド

該当するリポジトリがなく，cscutilコマンドが使用できる環境（例えば，JP1で直接運用している実行環境）で標準受付を開始する場合。

それぞれのコマンドの実行方法を次に説明します。

●cscrcptnstartコマンドの場合

運用環境でcscrcptnstartコマンドを実行します。

cscrcptnstartコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscrcptnstart（標準受付およびユーザ定義受付の開始）」を参照してください。

cscrcptnstartコマンドの実行形式を次に示します。

クラスタ内のすべてのHCSCサーバの標準受付を一括して開始する場合（クラスタ単位）

クラスタ名を指定して実行します。

-clusterオプションで指定したクラスタ内のすべてのHCSCサーバの標準受付が一括して開始されます（開始されていないユーザ定義受付も同時にすべて開始されます）。

cscrcptnstart -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名>

ユーザ定義受付を開始しないで標準受付だけを開始する場合は，-standardオプションを指定します。

cscrcptnstart -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -standard

HCSCサーバの標準受付を一括して開始する場合（HCSCサーバ単位）

HCSCサーバ名を指定して実行します。

-cscオプションで指定したHCSCサーバの標準受付が開始されます（開始されていないユーザ定義受付も同時にすべて開始されます）。

cscrcptnstart -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名>

ユーザ定義受付を開始しないで標準受付だけを開始する場合は，-standardオプションを指定します。

cscrcptnstart -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -standard

●cscutilコマンドの場合

運用環境でcscutilコマンドを実行します。-targetオプションにrequest_serviceを，また-operationオプションにstartを指定します。

cscutilコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscutil（各種操作）」を参照してください。

cscutilコマンドの実行形式は，プロパティ定義ファイルを使用するかどうかによって異なります。

プロパティ定義ファイルを使用しない場合

-propsオプションにHCSCサーバ名およびJ2EEサーバ名を指定します。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Manager名> -target request_service -operation start -props "CSCSrvName=<HCSCサーバ名>, J2EESrvName=<J2EEサーバ名>"

cscutilコマンドに指定するManager名，HCSCサーバ名およびJ2EEサーバ名は，cscreplsコマンドで確認できます。cscreplsコマンドの詳細については，マニュアル「サービスプラットフォームリファレンス」の「cscrepls（リポジトリ情報の表示）」を参照してください。

プロパティ定義ファイルを使用する場合

-propfileオプションにプロパティ定義ファイル名を指定します。プロパティ定義ファイルは，J2SEのプロパティファイル形式であらかじめ作成しておく必要があります。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Manager名> -target request_service -operation start -propfile <プロパティ定義ファイル名>

5.3.11　データベースの状態を確認する

データベースの状態を参照する方法について次に説明します。

(1)　参照方法（HiRDBの場合）

HiRDBの状態を参照するには，データベースサーバでpdlsコマンドを実行します。

pdlsコマンドの詳細については，マニュアル「HiRDB コマンドリファレンス」を参照してください。

(2)　参照方法（Oracleの場合）

Oracleの状態を参照する方法については，Oracle Corporationが発行するドキュメントを参照してください。

5.3.12　PRFの状態を確認する

PRFの状態を参照する前提条件と参照方法について次に説明します。

(1)　前提条件

PRFの状態を参照するには，HCSC-Manager定義ファイルにPRFが登録されている必要があります。詳細については，「5.3.1(1)　運用する前の準備」の論理サーバの登録についての内容を参照してください。

(2)　参照方法

PRFの状態を参照するには，運用環境でcscstatusコマンドを実行します。-typeオプションに「system」を指定して実行します。

cscstatusコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscstatus（状態表示）」を参照してください。

cscstatusコマンドの実行形式を次に示します。

cscstatus -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -type system

5.3.13　HTTP Serverの状態を確認する

HTTP Serverの状態を参照する方法について次に説明します。

(1)　前提条件

HTTP Serverの状態を参照するには，HCSC-Manager定義ファイルにHTTP Serverが登録されている必要があります。詳細については，「5.3.1(1)　運用する前の準備」の論理サーバの登録についての内容を参照してください。

(2)　参照方法

HTTP Serverの状態を参照するには，運用環境でcscstatusコマンドを実行します。-typeオプションに「system」を指定して実行します。

cscstatusコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscstatus（状態表示）」を参照してください。

cscstatusコマンドの実行形式を次に示します。

cscstatus -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -type system

5.3.14　Managerの状態を確認する

Managerの状態を参照する方法について次に説明します。

(1)　参照方法

Managerには，Management Serverと運用管理エージェントの2つのプロセスがあります。それぞれの状態を参照する方法を次に示します。

(a)　Management Serverの参照方法

Management Serverの状態を参照するには，J2EEサーバ稼働マシンでmngsvrutilコマンドを実行します。

mngsvrutilコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「mngsvrutil（Management Serverの運用管理コマンド）」を参照してください。

(b)　運用管理エージェントの参照方法

運用管理エージェントの状態を参照するには，J2EEサーバ稼働マシンでadminagentcheckコマンドを実行します。

adminagentcheckコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「adminagentcheck（運用管理エージェントの稼働確認）」を参照してください。

5.3.15　HCSCサーバのセットアップ情報を確認する

HCSCサーバのセットアップ情報を参照する前提条件と参照方法について次に説明します。

(1)　前提条件

HCSCサーバのセットアップ情報を参照するには，HCSCサーバが停止状態または起動状態である必要があります。

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

(2)　参照方法

HCSCサーバのセットアップ情報を参照するには，運用環境でcscutilコマンドを実行します。-targetオプションにserverを，また-operationオプションにget_setup_infoを指定します。cscutilコマンドを実行すると，HCSCサーバセットアップ定義ファイルの内容が表示されます。

HCSCサーバセットアップ定義ファイルの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.4.3　HCSCサーバセットアップ定義ファイル」を参照してください。

また，cscutilコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscutil（各種操作）」を参照してください。

cscutilコマンドの実行形式は，プロパティ定義ファイルを使用するかどうかによって異なります。

プロパティ定義ファイルを使用しない場合

-propsオプションにHCSCサーバ名を指定します。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Manager名> -target server -operation get_setup_info -props "CSCSrvName=<HCSCサーバ名>"

cscutilコマンドに指定するManager名およびHCSCサーバ名は，cscreplsコマンドで確認できます。cscreplsコマンドの詳細については，マニュアル「サービスプラットフォームリファレンス」の「cscrepls（リポジトリ情報の表示）」を参照してください。

プロパティ定義ファイルを使用する場合

-propfileオプションにプロパティ定義ファイル名を指定します。プロパティ定義ファイルは，J2SEのプロパティファイル形式であらかじめ作成しておく必要があります。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Manager名> -target server -operation get_setup_info -propfile <プロパティ定義ファイル名>

5.3.16　HCSCサーバの情報を確認する

HCSCサーバの情報は，画面とコマンドで参照できる情報が異なります。参照できる情報の詳細については，マニュアル「サービスプラットフォーム リファレンス」の該当する画面，コマンドの内容を参照してください。

HCSCサーバの情報を参照する前提条件と参照方法について次に説明します。

(1)　前提条件

HCSCサーバの情報を参照するには，HCSCサーバが構築後である必要があります。

(2)　参照方法

HCSCサーバの情報を参照する方法を次に示します。

(a)　画面の場合

ツリービュー上で，情報を参照するHCSCサーバをダブルクリックします。ダブルクリックしたHCSCサーバの情報は，エディタエリアに表示されます。エディタエリアの基本情報ページおよび稼働運用ページを表示して，HCSCサーバの情報を確認できます。

HCSCサーバの基本情報ページの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「4.2　基本情報ページ」を参照してください。HCSCサーバの稼働運用ページの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「4.4　稼働運用ページ」を参照してください。

なお，HCSCサーバの稼働状態については，ツリービューに表示されるアイコンで確認することもできます。表示されるアイコンの詳細については，マニュアル「サービスプラットフォームリファレンス」の「4.1　画面構成（運用環境）」を参照してください。

(b)　コマンドの場合

HCSCサーバの情報を参照するには，cscstatusコマンドまたはcscutilコマンドを実行します。

cscstatusコマンドおよびcscutilコマンドは運用環境から実行できます。各コマンドは，次の場合に使用します。

cscstatusコマンド

HCSCサーバの動的情報（稼働状況）を参照する場合に使用します。

cscutilコマンド

HCSCサーバの静的情報（HCSCサーバセットアップ定義ファイル，またはHCSCサーバランタイム定義ファイルで設定した定義情報）を参照する場合に使用します。

実際の動作に反映されている情報が定義情報として出力されます。ユーザが設定した情報は，HCSCサーバの起動時，または受付の開始時に反映されます。

次のどちらかの場合には，前回HCSCサーバを起動したとき，または受付を開始したときに設定した情報が出力されます。

HCSCサーバの起動中に定義情報を設定し，そのあとHCSCサーバを再起動しない場合

受付の開始中に定義情報を設定し，そのあと受付を再開始しない場合

それぞれのコマンドの実行方法を次に説明します。

●cscstatusコマンドの場合

運用環境でcscstatusコマンドを実行します。

cscstatusコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscstatus（状態表示）」を参照してください。

cscstatusコマンドの実行形式を次に示します。

すべてのHCSCサーバの情報を参照する場合

オプションを指定しないで実行します。

cscstatus -user <ログインユーザID> -pass <ログインパスワード>

特定のHCSCサーバの論理サーバの情報を参照する場合

-cscオプションと-typeオプションを指定して実行します。-typeオプションには「system」を指定します。

cscstatus -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -type system

特定のHCSCサーバの受付の情報を参照する場合

-cscオプションと-typeオプションを指定して実行します。-typeオプションには「reception」を指定します。

cscstatus -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -type reception

特定のHCSCサーバのHCSCコンポーネントの情報を参照する場合

-cscオプションと-typeオプションを指定して実行します。-typeオプションには「compo」を指定します。

cscstatus -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -type compo

●cscutilコマンドの場合

運用環境でcscutilコマンドを実行します。-targetオプションにserverを，また-operationオプションにget_infoを指定します。

cscutilコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscutil（各種操作）」を参照してください。

cscutilコマンドの実行形式は，プロパティ定義ファイルを使用するかどうかによって異なります。

プロパティ定義ファイルを使用しない場合

-propsオプションにHCSCサーバ名を指定します。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Manager名> -target server -operation get_info -props "CSCSrvName=<HCSCサーバ名>"

cscutilコマンドに指定するManager名およびHCSCサーバ名は，cscreplsコマンドで確認できます。cscreplsコマンドの詳細については，マニュアル「サービスプラットフォームリファレンス」の「cscrepls（リポジトリ情報の表示）」を参照してください。

プロパティ定義ファイルを使用する場合

-propfileオプションにプロパティ定義ファイル名を指定します。プロパティ定義ファイルは，J2SEのプロパティファイル形式であらかじめ作成しておく必要があります。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Manager名> -target server -operation get_info -propfile <プロパティ定義ファイル名>

コマンド実行時の出力情報

コマンド実行時の出力情報と意味を次の表に示します。なお，次の表に示す出力情報以外の出力情報はトラブルシューティング用の保守情報です。

表5‒1　HCSCサーバの情報を参照するコマンドの出力情報

出力される項目

出力される内容

server-status

HCSCサーバの状態が出力されます。

active（起動状態）

inactive（停止状態）※

starting（起動処理中）

stopping（停止処理中）

request-service-status

標準受付の状態が出力されます。なお，HCSCサーバが停止している場合は，表示されません。

active（開始状態）

inactive（停止状態）

starting（開始処理中）

startfailed（開始失敗状態）

stopping（停止処理中）

stopfailed（停止失敗状態）

注※

HCSCサーバの状態の取得に要した時間が，HCSCサーバランタイム定義ファイルのcsc-command-timeoutで設定したコマンドタイムアウト時間以上となった場合にも，inactiveで出力されます。

5.3.17　KafkaインバウンドアダプタおよびgRPCインバウンドアダプタの情報を確認する

KafkaインバウンドアダプタおよびgRPCインバウンドアダプタの情報を確認するときの前提条件，および確認方法について説明します。

(1)　前提条件

KafkaインバウンドアダプタおよびgRPCインバウンドアダプタの情報を確認するには，HCSCサーバが起動状態である必要があります。

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

(2)　開始方法

KafkaインバウンドアダプタおよびgRPCインバウンドアダプタの情報を確認するには，運用環境でcjlistrarコマンドを実行します。

インバウンドアダプタの情報を確認する場合の実行形式を次に示します。

<サービスプラットフォームのインストールディレクトリ>¥CC¥admin¥bin¥cjlistrar <J2EEサーバ名称>

cjstartrarコマンドの詳細は，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「2.4　J2EEサーバで使用するリソース操作コマンド」を参照してください。

Kafkaインバウンドアダプタの実行結果の例を次に示します。

KDJE37400-I Connecting to <J2EEサーバ名称>...
running  Kafka_Inbound_Resource_Adapter
KDJE37508-I All RARs have been listed successfully. (number = [1])

「running」は，Kafkaインバウンドアダプタが起動していることを示しています。停止している場合は「stopped」と出力されます。

5.3.18　HCSCサーバのリソース稼働情報を確認する

HCSCサーバのリソース稼働情報に関する情報は，画面とコマンドで参照できます。画面とコマンドで参照できる情報は同じです。参照できる情報の詳細については，マニュアル「サービスプラットフォーム リファレンス」の該当する画面，コマンドの内容を参照してください。

リソースの稼働情報を確認することで，リソースが正常な範囲内で使用されているかをチェックできます。また，受付およびHCSCコンポーネントを停止する前に，これらを安全に停止できるかどうかをチェックできます。

稼働情報は，実行環境からデフォルト値では60秒ごとにHCSCサーバに通知されます。稼働情報がHCSCサーバに通知されると，画面およびコマンドで表示される情報が更新されます。稼働情報がHCSCサーバに通知される間隔を変更したい場合は，次に示すマニュアルを参照してください。

運用環境ポータルから変更する場合

マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「10.8.20　稼働情報監視の設定（J2EEサーバ）」を参照してください。

Smart Composer機能を使って変更する場合

マニュアル「アプリケーションサーバ 機能解説 運用／監視／連携編」の「3.3　稼働情報ファイルの出力機能」と「3.4　イベントの発行機能」を参照してください。

なお，リソース稼働情報は，統計情報として参照できます。リソース稼働情報の統計情報の参照方法については，「付録E　HCSCサーバのリソース稼働情報の統計情報」を参照してください。

HCSCサーバのリソース稼働情報を確認する際の前提条件と参照方法について次に説明します。

(1)　前提条件

HCSCサーバのリソース稼働情報を確認するには，HCSCサーバがセットアップ済みである必要があります。

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

(2)　参照方法

HCSCサーバのリソース稼働情報を確認する方法を次に示します。

(a)　画面の場合

ツリービュー上で，リソース稼働情報を確認するHCSCサーバをダブルクリックします。ダブルクリックしたHCSCサーバの情報は，エディタエリアに表示されます。エディタエリアで［稼働確認］タブを選択します。HCSCサーバのリソース稼働情報に関する情報が表示されます。

HCSCサーバの稼働確認ページの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「4.5　稼働確認ページ」を参照してください。

(b)　コマンドの場合

HCSCサーバのリソース稼働情報を確認するには，運用環境でcscresinfoコマンドを実行します。

cscresinfoコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscresinfo（リソース稼働情報の表示）」を参照してください。

5.3.19　サービスアダプタの情報を確認する

サービスアダプタに関する情報は，画面とコマンドで参照できる情報が異なります。参照できる情報の詳細については，マニュアル「サービスプラットフォーム リファレンス」の該当する画面，コマンドの内容を参照してください。

サービスアダプタの情報を参照するための前提条件と参照方法について次に説明します。

(1)　前提条件

サービスアダプタの情報を参照するには，HCSCサーバが起動状態である必要があります。

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

(2)　参照方法

サービスアダプタの情報を参照する方法を次に示します。

(a)　画面の場合

ツリービュー上で，サービスアダプタをダブルクリックします。ダブルクリックしたサービスアダプタの情報は，エディタエリアに表示されます。エディタエリアの稼働運用ページで，サービスアダプタの情報が参照できます。

サービスアダプタの稼働運用ページの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「4.4　稼働運用ページ」を参照してください。

なお，サービスアダプタの稼働状態については，ツリービューに表示されるアイコンで確認することもできます。表示されるアイコンの詳細については，マニュアル「サービスプラットフォームリファレンス」の「4.1　画面構成（運用環境）」を参照してください。

(b)　コマンドの場合

サービスアダプタの情報を参照するには，cscstatusコマンドまたはcscutilコマンドを実行します。

cscstatusコマンドおよびcscutilコマンドは運用環境から実行できます。各コマンドは，次の場合に使用します。

cscstatusコマンド

サービスアダプタの動的情報（稼働状況），サービスアダプタのサービスID，および更新時間を参照する場合に使用します。

cscutilコマンド

サービスアダプタの静的情報（定義情報）を参照する場合に使用します。

それぞれのコマンドの実行方法を次に説明します。

●cscstatusコマンドの場合

運用環境でcscstatusコマンドを実行します。-cscオプションと-typeオプションを指定して実行します。-typeオプションには「compo」を指定します。

cscstatusコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscstatus（状態表示）」を参照してください。

cscstatusコマンドの実行形式を次に示します。

cscstatus -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -type compo

●cscutilコマンドの場合

運用環境でcscutilコマンドを実行します。-targetオプションにcompoを，また-operationオプションにget_adapter_infoを指定します。

cscutilコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscutil（各種操作）」を参照してください。

cscutilコマンドの実行形式は，プロパティ定義ファイルを使用するかどうかによって異なります。

プロパティ定義ファイルを使用しない場合

-propsオプションにHCSCサーバ名およびサービスアダプタのサービスIDを指定します。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Manager名> -target compo -operation get_adapter_info -props "CSCSrvName=<HCSCサーバ名>, AdapterName=<サービスアダプタのサービスID>"

cscutilコマンドに指定するManager名，HCSCサーバ名およびサービスアダプタのサービスIDは，cscreplsコマンドで確認できます。cscreplsコマンドの詳細については，マニュアル「サービスプラットフォームリファレンス」の「cscrepls（リポジトリ情報の表示）」を参照してください。

プロパティ定義ファイルを使用する場合

-propfileオプションにプロパティ定義ファイル名を指定します。プロパティ定義ファイルは，J2SEのプロパティファイル形式であらかじめ作成しておく必要があります。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Manager名> -target compo -operation get_adapter_info -propfile <プロパティ定義ファイル名>

注意事項

配備されていないサービスアダプタの情報を取得した場合，nullという文字列が表示されます。

サービスアダプタのサービスIDを指定しないでcscutilコマンドを実行すると，HCSCサーバが管理しているすべてのサービスアダプタの情報が出力されます。

コマンド実行時の出力情報

コマンド実行時の出力情報と意味を次の表に示します。なお，次の表に示す出力情報以外の出力情報はトラブルシューティング用の保守情報です。

表5‒2　サービスアダプタの情報を参照するコマンドの出力情報

出力される項目

出力される内容

serviceName.<通番>

サービス部品名が出力されます。

adapterName.<通番>

アダプタ識別名が出力されます。

cscServerName.<通番>

HCSCサーバ名が出力されます。

ownerClusterName.<通番>

クラスタ名が出力されます。

serviceKind.<通番>

HCSCコンポーネントの種別が出力されます。

サービスアダプタの場合，「ServiceAdapter」が出力されます。

serviceProtocolKind.<通番>

サービス部品のプロトコルが出力されます。

WebService（同期サービス（Webサービス）呼び出し）

SessionBean（同期サービス（SessionBean）呼び出し）

MDB_WSR（非同期サービス（MDB（WS-R））呼び出し）

MDB_DBQ（非同期サービス（MDB（DBキュー））呼び出し）

Custom（上記以外のサービスアダプタ）

serviceStatus.<通番>

サービスアダプタの状態が出力されます。

active（開始状態）

inactive（停止状態）

starting（開始処理中）

startfailed（開始失敗）

stopping（停止処理中）

stopfailed（停止失敗）

deleting（削除処理中）

null（未配備状態）

entryTime.<通番>

サービスアダプタを配備した時刻が出力されます。

adapterQueueName.<通番>

キュー名称が表示されます。

サービスアダプタの種別がMDB（WS-R）またはMDB（DBキュー）の場合にだけ出力されます。

modifiedTime.<通番>

サービスアダプタが更新された時刻（1970年1月1日00:00:00からの通算ミリ秒）が出力されます。

lcVersion.<通番>

ロケーションのバージョン番号が出力されます。

lcRevision.<通番>

ロケーションのリビジョン番号が出力されます。

5.3.20　ビジネスプロセスの情報を確認する

ビジネスプロセスに関する情報は，画面とコマンドで参照できる情報が異なります。参照できる情報の詳細については，マニュアル「サービスプラットフォーム リファレンス」の該当する画面，コマンドの内容を参照してください。

ビジネスプロセスの情報を参照するための前提条件と参照方法について次に説明します。

(1)　前提条件

ビジネスプロセスの情報を参照するには，HCSCサーバが起動状態である必要があります。

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

(2)　参照方法

ビジネスプロセスの情報を参照する方法を次に示します。

(a)　画面の場合

ツリービュー上で，ビジネスプロセスをダブルクリックします。ダブルクリックしたビジネスプロセスの情報は，エディタエリアに表示されます。エディタエリアの稼働運用ページで，ビジネスプロセスの情報が参照できます。

ビジネスプロセスの稼働運用ページの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「4.4　稼働運用ページ」を参照してください。

なお，ビジネスプロセスの稼働状態については，ツリービューに表示されるアイコンで確認することもできます。表示されるアイコンの詳細については，マニュアル「サービスプラットフォームリファレンス」の「4.1　画面構成（運用環境）」を参照してください。

(b)　コマンドの場合

ビジネスプロセスの情報を参照するには，運用環境からcscstatusコマンドまたはcscutilコマンドを実行します。各コマンドは，次の場合に使用します。

cscstatusコマンド

ビジネスプロセスの動的情報（稼働状況），ビジネスプロセスのサービスID，および更新時間を参照する場合に使用します。

cscutilコマンド

ビジネスプロセスの静的情報（定義情報）を参照する場合に使用します。

それぞれのコマンドの実行方法を次に説明します。

●cscstatusコマンドの場合

運用環境でcscstatusコマンドを実行します。-cscオプションと-typeオプションを指定して実行します。-typeオプションには「compo」を指定します。

cscstatusコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscstatus（状態表示）」を参照してください。

cscstatusコマンドの実行形式を次に示します。

cscstatus -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -type compo

●cscutilコマンドの場合

運用環境でcscutilコマンドを実行します。-targetオプションにcompoを，また-operationオプションにget_bp_infoを指定します。

cscutilコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscutil（各種操作）」を参照してください。

cscutilコマンドの実行形式は，プロパティ定義ファイルを使用するかどうかによって異なります。

プロパティ定義ファイルを使用しない場合

-propsオプションにHCSCサーバ名およびビジネスプロセスのサービスIDを指定します。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Manager名> -target compo -operation get_bp_info -props "CSCSrvName=<HCSCサーバ名>, AdapterName=<ビジネスプロセスのサービスID>"

cscutilコマンドに指定するManager名，HCSCサーバ名およびビジネスプロセスのサービスIDは，cscreplsコマンドで確認できます。cscreplsコマンドの詳細については，マニュアル「サービスプラットフォームリファレンス」の「cscrepls（リポジトリ情報の表示）」を参照してください。

プロパティ定義ファイルを使用する場合

-propfileオプションにプロパティ定義ファイル名を指定します。プロパティ定義ファイルは，J2SEのプロパティファイル形式であらかじめ作成しておく必要があります。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Manager名> -target compo -operation get_bp_info -propfile <プロパティ定義ファイル名>

注意事項

配備されていないビジネスプロセスの情報を取得した場合，nullという文字列が表示されます。

ビジネスプロセスのサービスIDを指定しないでcscutilコマンドを実行すると，HCSCサーバが管理しているすべてのビジネスプロセスの情報が出力されます。

コマンド実行時の出力情報

コマンド実行時の出力情報と意味を次の表に示します。なお，次の表に示す出力情報以外の出力情報はトラブルシューティング用の保守情報です。

表5‒3　ビジネスプロセスの情報を参照するコマンドの出力情報

出力される項目

出力される内容

serviceName.<通番>

サービス部品名が出力されます。

adapterName.<通番>

ビジネスプロセスのサービスIDが出力されます。

cscServerName.<通番>

HCSCサーバ名が出力されます。

ownerClusterName.<通番>

クラスタ名が出力されます。

serviceKind.<通番>

HCSCコンポーネントの種別が出力されます。

ビジネスプロセスの場合「BusinessProcess」が出力されます。

serviceStatus.<通番>

ビジネスプロセスの状態が出力されます。

active（開始状態）

inactive（停止状態）

starting（開始処理中）

startfailed（開始失敗）

stopping（停止処理中）

stopfailed（停止失敗）

deleting（削除処理中）

null（未配備状態）

modifiedTime.<通番>

ビジネスプロセスが更新された時刻（1970年1月1日00:00:00からの通算ミリ秒）が出力されます。

entryTime.<通番>

ビジネスプロセスを配備した時刻が出力されます。

lcVersion.<通番>

ロケーションのバージョン番号が出力されます。

lcRevision.<通番>

ロケーションのリビジョン番号が出力されます。

5.3.21　ユーザ定義受付の情報を確認する

ユーザ定義受付の情報を参照するための前提条件と，参照方法について次に説明します。

(1)　前提条件

ユーザ定義受付の情報を参照するには，HCSCサーバが起動状態である必要があります。

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

(2)　参照方法

ユーザ定義受付の情報を参照するには，運用環境からcscstatusコマンドまたはcscutilコマンドを実行します。各コマンドは，次の場合に使用します。

cscstatusコマンド

ユーザ定義受付の動的情報（稼働状況），受付ID，および更新時間を参照する場合に使用します。

cscutilコマンド

ユーザ定義受付の静的情報（ユーザ定義受付ランタイム定義ファイルで設定した定義情報）を参照する場合に使用します。

実際の動作に反映されている情報が定義情報として出力されます。ユーザが設定した情報は，HCSCサーバの起動時，または標準受付もしくはユーザ定義受付の開始時に反映されます。

次のどちらかの場合には，前回HCSCサーバを起動したとき，または標準受付もしくはユーザ定義受付を開始したときに設定した情報が出力されます。

HCSCサーバの起動中に定義情報を設定し，そのあとHCSCサーバを再起動しない場合

標準受付またはユーザ定義受付の開始中に定義情報を設定し，そのあと標準受付またはユーザ定義受付を再開始しない場合

それぞれのコマンドの実行方法を次に説明します。

●cscstatusコマンドの場合

運用環境でcscstatusコマンドを実行します。-cscオプションと-typeオプションを指定して実行します。-typeオプションには「compo」を指定します。

cscstatusコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscstatus（状態表示）」を参照してください。

cscstatusコマンドの実行形式を次に示します。

cscstatus -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -type compo

●cscutilコマンドの場合

運用環境でcscutilコマンドを実行します。-targetオプションにcompo_urecpを，また-operationオプションにget_infoを指定します。

cscutilコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscutil（各種操作）」を参照してください。

cscutilコマンドの実行形式は，プロパティ定義ファイルを使用するかどうかによって異なります。

プロパティ定義ファイルを使用しない場合

-propsオプションにHCSCサーバ名を指定します。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Manager名> -target compo_urecp -operation get_info -props "CSCSrvName=<HCSCサーバ名>"

cscutilコマンドに指定するManager名およびHCSCサーバ名は，cscreplsコマンドで確認できます。cscreplsコマンドの詳細については，マニュアル「サービスプラットフォームリファレンス」の「cscrepls（リポジトリ情報の表示）」を参照してください。

プロパティ定義ファイルを使用する場合

-propfileオプションにプロパティ定義ファイル名を指定します。プロパティ定義ファイルは，J2SEのプロパティファイル形式であらかじめ作成しておく必要があります。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Manager名> -target compo_urecp -operation get_info -propfile <プロパティ定義ファイル名>

注意事項

配備されていないユーザ定義受付の情報を取得した場合，nullという文字列が表示されます。

ユーザ定義受付の受付IDを指定しないでcscutilコマンドを実行すると，HCSCサーバが管理しているすべてのユーザ定義受付の情報が出力されます。

コマンド実行時の出力情報

コマンド実行時の出力情報と意味を次の表に示します。なお，次の表に示す出力情報以外の出力情報はトラブルシューティング用の保守情報です。

表5‒4　ユーザ定義受付の情報を参照するコマンドの出力情報

出力される項目

出力される内容

receptionName.<通番>

ユーザ定義受付の受付名が出力されます。

receptionID.<通番>

ユーザ定義受付の受付IDが出力されます。

cscServerName.<通番>

HCSCサーバ名が出力されます。

ownerClusterName.<通番>

クラスタ名が出力されます。

serviceName.<通番>

ユーザ定義受付に関連するサービス名が出力されます。

receptionKind.<通番>

ユーザ定義受付を利用している受付（HCSCコンポーネント）の種類が出力されます。

bp（ビジネスプロセス）

receptionProtocolKind.<通番>

ユーザ定義受付のプロトコルが出力されます。

WebService（同期サービス（Webサービス）呼び出し）

receptionStatus.<通番>

ユーザ定義受付の状態が出力されます。

active（開始状態）

inactive（停止状態）

starting（開始処理中）

startfailed（開始失敗）

stopping（停止処理中）

stopfailed（停止失敗）

deleting（削除処理中）

entryTime.<通番>

ユーザ定義受付が定義された時刻がYYYY/MM/DD hh:mm:ss.SSS形式で出力されます。

YYYY：西暦

MM：月

DD：日

hh：時

mm：分

ss：秒

SSS：ミリ秒

modifiedTime.<通番>

ユーザ定義受付が更新された時刻（1970年1月1日00:00:00からの通算ミリ秒）が出力されます。

lcVersion.<通番>

ロケーションバージョン番号が出力されます。

lcRevision.<通番>

ロケーションリビジョン番号が出力されます。

runtime.user-defined-reception-soap.threads.maximum.<通番>

ユーザ定義受付の最大同時実行数が出力されます。ユーザ定義受付ランタイム定義ファイルで最大同時実行数を設定していない場合は，デフォルト値（10）が出力されます。

runtime.user-defined-reception-soap.exclusive.threads.<通番>

ユーザ定義受付の占有スレッド数が出力されます。ユーザ定義受付ランタイム定義ファイルで占有スレッド数を設定していない場合は，デフォルト値（0）が出力されます。

runtime.user-defined-reception-soap.queue-size.<通番>

ユーザ定義受付の実行待ちキューサイズが出力されます。ユーザ定義受付ランタイム定義ファイルで実行待ちキューサイズを設定していない場合は，デフォルト値（8192）が出力されます。

5.3.22　ビジネスプロセスの定義情報をキャッシュする

ビジネスプロセスのフォーマット定義およびデータ変換定義の定義情報のキャッシュについて次に説明します。

(1)　前提条件

ビジネスプロセスをキャッシュするには，HCSCサーバが起動状態である必要があります。

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

(2)　キャッシュ方法

ビジネスプロセスのフォーマット定義およびデータ変換定義の定義情報をキャッシュするには，運用環境でcscprecacheコマンドを実行します。このコマンドを実行しないとリクエスト処理時まで定義情報が解析されないため，実行することを推奨します。

cscprecacheコマンドで実行できる処理を次に示します。

HCSCサーバ上で起動しているビジネスプロセスに対する解析要求の一括送信

特定のビジネスプロセスへの解析要求の送信

複数のビジネスプロセスに対して解析要求を送信する場合，コマンド内でスレッドを生成して，並列処理が実行されます。

cscprecacheコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscprecache（フォーマット定義およびデータ変換定義の事前キャッシュ）」を参照してください。

cscprecacheコマンドの実行形式を次に示します。

HCSCサーバ上で起動しているビジネスプロセスに対して，解析要求を一括送信する場合

cscprecache -csc <HCSCサーバ名>

特定のビジネスプロセスに対して，解析要求を送信する場合

cscprecache -csc <HCSCサーバ名> -name <サービスID>

cscprecacheコマンドの実行結果は，コマンド実行後に解析要求を送信したかどうかによって，次の表のように異なります。

表5‒5　cscprecacheコマンドの実行結果

コマンドの実行後の動作

cscprecacheコマンドの実行結果

解析要求を送信しないでコマンド実行結果を返した場合

指定したHCSCサーバが起動していない場合

解析要求を送信しないで異常終了します。

-nameオプションを指定しなかった場合

起動しているビジネスプロセスが存在しない場合，コマンドは正常終了します。

-nameオプションを指定した場合

-nameオプションで指定したビジネスプロセスが起動していない場合，コマンドは異常終了します。

また，ビジネスプロセスでないコンポーネントを指定した場合，コマンドは異常終了します。

解析要求を送信してからコマンド実行結果を返した場合

1つのビジネスプロセスの実行結果が返ってくるたびに，標準出力または標準エラー出力に実行結果が出力されます。

すべての実行結果が返ってきたあと，解析処理にエラーがある場合は，コマンドは異常終了します。すべての解析処理およびキャッシュに成功した場合は，コマンドは正常終了します。

キャッシュ済みのビジネスプロセスに対してコマンドを実行した場合，解析処理をしないで正常終了します。

なお，保存されたキャッシュは，ビジネスプロセスが停止すると削除されます。

5.3.23　HCSCサーバの定義を変更する

HCSCサーバの定義情報を変更する場合，HCSCサーバの定義情報を設定する場合と同じ方法で行います。HCSCサーバの定義情報を設定する方法の詳細については，「3.1.4　HCSCサーバの定義情報を設定する」を参照してください。

5.3.24　ユーザ定義受付の定義情報を変更する

ユーザ定義受付の定義情報を変更するための前提条件と変更方法について次に説明します。

(1)　前提条件

ユーザ定義受付の定義情報を変更するには，HCSCサーバが起動状態である必要があります。

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

(2)　変更方法

ユーザ定義受付の定義情報を変更する手順を次に示します。

ユーザ定義受付の定義情報を確認します。

運用環境から確認する場合はcscutilコマンドを実行します。

ユーザ定義受付の定義情報の確認方法については，「3.1.16　ユーザ定義受付の定義情報を確認する」を参照してください。

ユーザ定義受付を停止します。

ユーザ定義受付の停止方法については，「5.3.36　ユーザ定義受付を停止する」を参照してください。

ユーザ定義受付の定義情報を取得します。

csccompoconfigコマンドの-operationオプションにgetを指定して，ユーザ定義受付の定義情報を取得します。

csccompoconfigコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「csccompoconfig（HCSCコンポーネントの定義）」を参照してください。

注意事項

HTTP受付またはファイルイベント受付の場合，csccompoconfigコマンドの実行に関して次の制限があります。

アプリケーション統合属性ファイルの設定（-operation setオプションで指定）はできません。実行した場合の動作は保証できません。

アプリケーション統合属性ファイルの取得（-operation getオプションで指定）はできません。

取得したユーザ定義受付の定義情報を変更します。

ユーザ定義受付ランタイム定義ファイルのパラメタの値を変更し，ユーザ定義受付の定義情報を変更します。

ユーザ定義受付ランタイム定義ファイルの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.6.2　ユーザ定義受付ランタイム定義ファイル」を参照してください。

ユーザ定義受付の定義情報を設定します。

ユーザ定義受付の定義情報の設定方法については，「3.1.15　ユーザ定義受付の定義情報を設定する」を参照してください。

ユーザ定義受付の定義情報を確認します。

ユーザ定義受付の定義情報の確認方法については，「3.1.16　ユーザ定義受付の定義情報を確認する」を参照してください。

ユーザ定義受付を開始します。

ユーザ定義受付の開始方法については，「5.3.9　ユーザ定義受付を開始する」を参照してください。

ユーザ定義受付の情報を確認します。

運用環境から確認する場合はcscutilコマンドを実行します。

ユーザ定義受付の情報の確認方法については，「5.3.21　ユーザ定義受付の情報を確認する」を参照してください。

5.3.25　HCSCコンポーネントの構成を変更する

開発環境でHCSCコンポーネントの定義を変更した場合，リポジトリを利用して変更した定義を運用環境に受け渡します。運用環境では，開発環境で変更した定義情報に従って，HCSCコンポーネントの構成を変更します。

HCSCコンポーネントの構成を変更する前提条件と変更方法について次に説明します。

(1)　前提条件

HCSCコンポーネントの構成を変更するには，次の条件を満たす必要があります。

HCSCサーバが起動状態であること

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

Management Serverが起動状態であること

Management Serverの状態の確認方法については，「5.3.14　Managerの状態を確認する」を参照してください。

運用管理エージェントが起動状態であること

運用管理エージェントの状態の確認方法については，「5.3.14　Managerの状態を確認する」を参照してください。

データベースが起動状態であること

データベースの状態の確認方法については，「5.3.11　データベースの状態を確認する」を参照してください。

(2)　変更方法

HCSCコンポーネントの構成を変更する手順を次に示します。リポジトリを更新する方法については，「4.7　リポジトリを更新する」と合わせてご確認ください。

リポジトリ情報の差分を確認します。

リポジトリ情報の差分の確認方法については，「4.5　リポジトリの差分情報の参照」を参照してください。

HCSCコンポーネントを停止します。

csccompostopコマンドに-clusterオプションを指定して，クラスタ内のすべてのHCSCサーバに配備されているHCSCコンポーネントを一括して停止します。

HCSCコンポーネントの停止方法については，「5.3.36　ユーザ定義受付を停止する」，「5.3.37　サービスアダプタを停止する」，および「5.3.38　ビジネスプロセスを停止する」を参照してください。

HCSCコンポーネントを削除します。

csccompoundeployコマンドに-clusterオプションを指定して，クラスタ内のすべてのHCSCサーバに配備されているHCSCコンポーネントを一括して削除します。

HCSCコンポーネントの削除方法については，「3.3.1　サービスアダプタを削除する」，「3.3.2　ビジネスプロセスを削除する」，および「3.3.3　ユーザ定義受付を削除する」を参照してください。

リポジトリをインポートします。

リポジトリのインポート方法については，「4.3　リポジトリのインポート」を参照してください。

HCSCコンポーネントを配備します。

csccompodeployコマンドに-clusterオプションを指定して，クラスタ内のすべてのHCSCサーバに，配備されていないHCSCコンポーネントを一括して配備します。

HCSCコンポーネントの配備方法については，「3.1.8　サービスアダプタを配備する」，「3.1.13　ビジネスプロセスを配備する」，および「3.1.14　ユーザ定義受付を配備する」を参照してください。

HCSCコンポーネントを開始します。

csccompostartコマンドに-clusterオプションを指定して，クラスタ内のすべてのHCSCサーバに配備されているHCSCコンポーネントを一括して開始します。

HCSCコンポーネントの開始方法については，「5.3.7　サービスアダプタを開始する」，「5.3.8　ビジネスプロセスを開始する」，および「5.3.9　ユーザ定義受付を開始する」を参照してください。

(3)　複数のHCSCコンポーネントを追加，更新，削除する方法

複数のHCSCコンポーネントを追加，更新，削除する手順を説明します。

最初に，対象となるHCSCコンポーネントの一覧を次の手順で作成します。

新しいリポジトリをバージョンアップします。

cscrepupdate -inputfile <zipファイル名> -outputfile <出力先のzipファイル名>

現在のリポジトリと新しいリポジトリの変更情報を取得します。

対象となるHCSCコンポーネントの一覧を次のどちらかの方法で作成します。

cscrepdiffコマンドに-compoオプションを指定して，HCSCコンポーネント指定ファイルを出力する。

cscrepdiff -repfile <リポジトリzipファイル名> -compo -listfile <出力先のHCSCコンポーネント指定ファイル名>

手動でHCSCコンポーネント指定ファイルを作成する。

作成したHCSCコンポーネント指定ファイルを-namelistオプションに指定して，複数のHCSCコンポーネントを追加，更新，削除する手順を次に示します。

(a)　複数のHCSCコンポーネントを追加する場合

複数のHCSCコンポーネントを追加する手順を次に示します。分散開発のHCSCコンポーネントを追加する場合などに使用します。

リポジトリをインポートします。

cscrepctl -import <リポジトリzipファイル名> -compo -namelist <HCSCコンポーネント指定ファイル名>

HCSCコンポーネントをデプロイします。

csccompodeploy -namelist <HCSCコンポーネント指定ファイル名>

HCSCコンポーネントを開始します。

csccompostart -namelist <HCSCコンポーネント指定ファイル名>

(b)　複数のHCSCコンポーネントを更新する場合

複数のHCSCコンポーネントを更新する手順を次に示します。分散開発のHCSCコンポーネントを更新する場合などに使用します。

HCSCコンポーネントを停止します。

csccompostop -namelist <HCSCコンポーネント指定ファイル名>

HCSCコンポーネントをアンデプロイします。

csccompoundeploy -namelist <HCSCコンポーネント指定ファイル名>

リポジトリをインポートします。

cscrepctl -import <リポジトリzipファイル名> -compo -namelist <HCSCコンポーネント指定ファイル名>

サービス情報を変更します。この手順は任意で実施してください。

cscsvcctl -setfile <サービス情報変更定義ファイル名>

HCSCコンポーネントをデプロイします。

csccompodeploy -namelist <HCSCコンポーネント指定ファイル名>

HCSCコンポーネントを開始します。

csccompostart -namelist <HCSCコンポーネント指定ファイル名>

(c)　複数のHCSCコンポーネントを削除する場合

複数のHCSCコンポーネントを削除する手順を次に示します。

HCSCコンポーネントを停止します。

csccompostop -namelist <HCSCコンポーネント指定ファイル名>

HCSCコンポーネントをアンデプロイします。

csccompoundeploy -namelist <HCSCコンポーネント指定ファイル名>

リポジトリからコンポーネント情報を削除します。この手順は任意で実施してください。

cscrepctl -delete -namelist <HCSCコンポーネント指定ファイル名>

(d)　複数のHCSCコンポーネントを追加，更新，削除する場合

複数のHCSCコンポーネントを追加，更新，削除を同時に実行する手順を次に示します。HCSCコンポーネントを総入れ替えする場合などに使用します。

HCSCコンポーネントを停止します（HCSCコンポーネントの更新，削除）。

csccompostop -namelist <HCSCコンポーネント指定ファイル名>

HCSCコンポーネントをアンデプロイします（HCSCコンポーネントの更新，削除）。

csccompoundeploy -namelist <HCSCコンポーネント指定ファイル名>

リポジトリを通常インポートします。

cscrepctl -import <リポジトリzipファイル名>

サービス情報を変更します。この手順は任意で実施してください。

cscsvcctl -setfile <サービス情報変更定義ファイル名>

HCSCコンポーネントをデプロイします（HCSCコンポーネントの更新，追加）。

csccompodeploy -namelist <HCSCコンポーネント指定ファイル名>

HCSCコンポーネントを開始します（HCSCコンポーネントの更新，追加）。

csccompostart -namelist <HCSCコンポーネント指定ファイル名>

5.3.26　サービス部品の接続先を変更する

運用環境では，サービスアダプタの接続先情報を変更できます。

サービス部品の接続先を変更する前提条件と変更方法について次に説明します。

(1)　前提条件

サービス部品の接続先を変更するには，HCSCサーバが起動状態である必要があります。

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

(2)　変更方法

サービス部品の接続先を変更する手順を次に示します。

サービスアダプタを停止します。

csccompostopコマンドに-clusterオプションを指定して，クラスタ内のすべてのHCSCサーバに配備されているサービスアダプタを一括して停止します。

サービスアダプタの停止方法については，「5.3.37　サービスアダプタを停止する」を参照してください。

サービスアダプタを削除します。

csccompoundeployコマンドに-clusterオプションを指定して，クラスタ内のすべてのHCSCサーバに配備されているサービスアダプタを一括して削除します。

サービスアダプタの削除方法については，「3.3.1　サービスアダプタを削除する」を参照してください。

サービス情報を取得および更新し，サービスの接続先を変更します。

サービス情報の取得および更新方法については，「3.1.6　サービス情報を変更する」を参照してください。

なお，サービス部品の接続先を変更する場合，サービス情報の更新で，サービス情報変更定義ファイルの次のパラメタの値を変更してください。サービス情報変更定義ファイルの詳細については，マニュアル「サービスプラットフォームリファレンス」の「6.5.10　サービス情報変更定義ファイル」を参照してください。

SOAPアダプタの場合

<クラスタ名>.<サービスID>.WebService.url=サービス部品の呼び出しに使用するURL

SessionBeanアダプタの場合

<クラスタ名>.<サービスID>.SessionBean.url=サービス部品の呼び出しに使用するURL
<クラスタ名>.<サービスID>.SessionBean.lookupName=ルックアップ名

MDB（WS-R）アダプタの場合

<クラスタ名>.<サービスID>.MDB_WSR.url=サービスアダプタのメッセージ送信先URL
<クラスタ名>.<サービスID>.MDB_WSR.queue_name=サービス部品に関連づけられているキュー名

MDB（DBキュー）アダプタの場合

<クラスタ名>.<サービスID>.MDB_DBQ.queue_name=サービス部品に関連づけられているキュー名

サービスアダプタを配備します。

csccompodeployコマンドに-clusterオプションを指定して，クラスタ内のすべてのHCSCサーバに，サービスアダプタを一括して配備します。

サービスアダプタの配備方法については，「3.1.8　サービスアダプタを配備する」を参照してください。

サービスアダプタを開始します。

csccompostartコマンドに-clusterオプションを指定して，クラスタ内のすべてのHCSCサーバに配備されているサービスアダプタを一括して開始します。

サービスアダプタの開始方法については，「5.3.7　サービスアダプタを開始する」を参照してください。

5.3.27　流量制御値を変更する

運用環境では，標準受付（同期受付（Webサービス））およびユーザ定義受付の流量制御値を変更できます。

標準受付（同期受付（Webサービス））およびユーザ定義受付の流量制御値を変更する前提条件と変更方法について次に説明します。

(1)　前提条件

標準受付（同期受付（Webサービス））およびユーザ定義受付の流量制御値を変更するには，次の条件を満たす必要があります。

Management Serverが起動状態であること

Management Serverの状態の確認方法については，「5.3.14　Managerの状態を確認する」を参照してください。

運用管理エージェントが起動状態であること

運用管理エージェントの状態の確認方法については，「5.3.14　Managerの状態を確認する」を参照してください。

(2)　変更方法

標準受付（同期受付（Webサービス））およびユーザ定義受付の流量制御値を変更する手順を次に示します。

(a)　標準受付（同期受付（Webサービス））の流量制御値を変更する場合

標準受付（同期受付（Webサービス））の流量制御値を変更する手順を次に示します。

HCSCサーバランタイム定義ファイルを更新し，流量制御値を変更します。

流量制御値を変更する場合，HCSCサーバランタイム定義ファイルの次のプロパティの値を変更してください。HCSCサーバランタイム定義ファイルの詳細については，マニュアル「サービスプラットフォームリファレンス」の「6.5.6　HCSCサーバランタイム定義ファイル」を参照してください。

SOAP1.1の場合

request-soap.instance.maximum=標準の同期受付（Webサービス・SOAP1.1）の最大同時実行数
request-soap.exclusive.threads=標準の同期受付（Webサービス・SOAP1.1）の占有スレッド数
request-soap.queue-size=標準の同期受付（Webサービス・SOAP1.1）の実行待ちキューのサイズ

SOAP1.2の場合

request-soap1_2.instance.maximum=標準の同期受付（Webサービス・SOAP1.2）の最大同時実行数
request-soap1_2.exclusive.threads=標準の同期受付（Webサービス・SOAP1.2）の占有スレッド数
request-soap1_2.queue-size=標準の同期受付（Webサービス・SOAP1.2）の実行待ちキューのサイズ

HCSCサーバランタイム定義ファイルを設定します。

HCSCサーバランタイム定義ファイルの設定方法については，「3.1.4　HCSCサーバの定義情報を設定する」を参照してください。

注意事項

設定した情報は，標準受付の開始時に反映されます。

(b)　ユーザ定義受付の流量制御値を変更する場合

ユーザ定義受付の流量制御値の変更は，ユーザ定義受付の定義情報の変更と同じです。ユーザ定義受付の定義情報の変更方法については，「5.3.24　ユーザ定義受付の定義情報を変更する」を参照してください。

なお，流量制御値を変更する場合，ユーザ定義受付ランタイム定義ファイルの次のパラメタの値を変更してください。ユーザ定義受付ランタイム定義ファイルの詳細については，マニュアル「サービスプラットフォームリファレンス」の「6.6.2　ユーザ定義受付ランタイム定義ファイル」を参照してください。

user-defined-reception-soap.threads.maximum=最大同時実行数
user-defined-reception-soap.exclusive.threads=占有スレッド数
user-defined-reception-soap.queue-size=実行待ちキューサイズ

注意事項

設定した情報は，ユーザ定義受付の開始時に反映されます。

5.3.28　サービス部品呼び出しの通信タイムアウト値を変更する

運用環境では，SOAPアダプタ，およびSessionBeanアダプタのサービス部品呼び出しの通信タイムアウト値を変更できます。

SOAPアダプタ，およびSessionBeanアダプタのサービス部品呼び出しの通信タイムアウト値を変更する前提条件と変更方法について次に説明します。

(1)　前提条件

SOAPアダプタ，およびSessionBeanアダプタのサービス部品呼び出しの通信タイムアウト値を変更するには，HCSCサーバが起動状態である必要があります。

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

(2)　変更方法

通信タイムアウト値を変更する手順を次に示します。

サービスアダプタを停止します。

csccompostopコマンドに-clusterオプションを指定して，クラスタ内のすべてのHCSCサーバに配備されているサービスアダプタを一括して停止します。

サービスアダプタの停止方法については，「5.3.37　サービスアダプタを停止する」を参照してください。

サービスアダプタを削除します。

csccompoundeployコマンドに-clusterオプションを指定して，クラスタ内のすべてのHCSCサーバに配備されているサービスアダプタを一括して削除します。

サービスアダプタの削除方法については，「3.3.1　サービスアダプタを削除する」を参照してください。

サービス情報を取得および更新し，サービス呼び出しの通信タイムアウト値を変更します。

サービス情報の取得および更新方法については，「3.1.6　サービス情報を変更する」を参照してください。

なお，サービス部品呼び出しの通信タイムアウト値を変更する場合，サービス情報の更新で，サービス情報変更定義ファイルの次のパラメタの値を変更してください。サービス情報変更定義ファイルの詳細については，マニュアル「サービスプラットフォームリファレンス」の「6.5.10　サービス情報変更定義ファイル」を参照してください。

SOAPアダプタ（SOAP1.1モード）の場合

<クラスタ名>.<サービスID>.WebService.c4web.application.socket_read_timeout=読み込みタイムアウト値
<クラスタ名>.<サービスID>.WebService.c4web.application.socket_connect_timeout=接続タイムアウト値
<クラスタ名>.<サービスID>.WebService.c4web.application.socket_write_timeout=書き込みタイムアウト値

SOAPアダプタ（SOAP1.1/1.2併用モード）の場合

<クラスタ名>.<サービスID>.WebService.com.cosminexus.csc.request.timeout=読み込みタイムアウト値
<クラスタ名>.<サービスID>.WebService.com.cosminexus.csc.connect.timeout=接続タイムアウト値

SessionBeanアダプタの場合

<クラスタ名>.<サービスID>.SessionBean.c4web.application.ejb_timeout=呼び出しタイムアウト値

サービスアダプタを配備します。

csccompodeployコマンドに-clusterオプションを指定して，クラスタ内のすべてのHCSCサーバに，サービスアダプタを一括して配備します。

サービスアダプタの配備方法については，「3.1.8　サービスアダプタを配備する」を参照してください。

サービスアダプタを開始します。

csccompostartコマンドに-clusterオプションを指定して，クラスタ内のすべてのHCSCサーバに配備されているサービスアダプタを一括して開始します。

サービスアダプタの開始方法については，「5.3.7　サービスアダプタを開始する」を参照してください。

5.3.29　リソースアダプタのプロパティを変更する

HCSCサーバが利用しているリソースアダプタのプロパティを変更する前提条件と変更方法について次に説明します。

(1)　前提条件

リソースアダプタのプロパティを変更するには，次の条件を満たす必要があります。

Management Serverが起動状態であること

Management Serverの状態の確認方法については，「5.3.14(1)(a)　Management Serverの参照方法」を参照してください。

運用管理エージェントが起動状態であること

運用管理エージェントの状態の確認方法については，「5.3.14(1)(b)　運用管理エージェントの参照方法」を参照してください。

(2)　変更方法

リソースアダプタのプロパティを変更する手順を次に示します。手順に登場するConnector属性ファイルの取得方法や設定方法については，マニュアル「アプリケーションサーバアプリケーション設定操作ガイド」の「4.3.2　リソースアダプタのプロパティ定義（Connector 1.0の場合）」または「4.3.3　リソースアダプタのプロパティ定義（Connector 1.5の場合）」を参照してください。

HCSCサーバを論理サーバと同時に一括停止します。

HCSCサーバが起動状態である場合は，cscsvstopコマンドに-systemオプションを指定して，HCSCサーバを論理サーバと同時に一括して停止します。

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

HCSCサーバと論理サーバの停止方法については，「5.3.41　HCSCサーバを停止する」を参照してください。

cscsvstopコマンドの実行形式を次に示します。

cscsvstop -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -system

J2EEアプリケーションを起動しないでJ2EEサーバを起動します。

cscsvstartコマンドに-logicalオプションを指定して，J2EEアプリケーションを起動しないでJ2EEサーバを起動します。

J2EEサーバだけを起動する方法については，「5.3.4　HCSCサーバを起動する」を参照してください。

cscsvstartコマンドの実行形式を次に示します。

cscsvstart -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -logical <J2EEサーバ名>

リソースアダプタを停止します。

cjstoprarコマンドを実行して，HCSCサーバが利用しているリソースアダプタを停止します。

リソースアダプタを停止する方法については，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「4.3.7　J2EEリソースアダプタの停止」を参照してください。

cjstoprarコマンドの実行形式を次に示します。

cjstoprar <J2EEサーバ名> ［-nameserver <プロバイダURL>］-resname <リソースアダプタの表示名>

注意事項

DB Connector for Reliable Messagingを停止する場合は，Reliable Messagingが停止している必要があります。

リソースアダプタのConnector属性ファイルを取得します。

必要な場合は，cjgetrarpropコマンドを実行して，HCSCサーバが利用しているリソースアダプタのConnector属性ファイルを取得します。

cjgetrarpropコマンドの実行形式を次に示します。

cjgetrarprop <サーバ名称> ［-nameserver <プロバイダURL>］ -resname <リソースアダプタの表示名> -c <Connector属性ファイルパス>

リソースアダプタのConnector属性ファイルを編集します。

HCSCサーバが利用しているリソースアダプタのConnector属性ファイルの設定値については，「3.1.2　実行環境に必要なソフトウェアを設定する」を参照してください。

リソースアダプタにConnector属性ファイルの値を設定します。

cjsetrarpropコマンドを実行して，HCSCサーバが利用しているリソースアダプタにConnector属性ファイルの値を反映します。

cjsetrarpropコマンドの実行形式を次に示します。

cjsetrarprop <サーバ名称> ［-nameserver <プロバイダURL>］ -resname <リソースアダプタの表示名> -c <Connector属性ファイルパス>

リソースアダプタの接続テストをします。

cjtestresコマンドを実行して，リソースアダプタに設定した情報が正しいかどうか，接続テストによって検証します。

リソースアダプタの接続テストについては，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「4.3.5　J2EEリソースアダプタの接続テスト」を参照してください。

cjtestresコマンドの実行形式を次に示します。

cjtestres ［<サーバ名称>］ ［-nameserver <プロバイダURL>］ -type rar -resname <リソースアダプタの表示名>

注意事項

Reliable Messagingの接続テストをする場合は，DB Connector for Reliable Messagingが開始している必要があります。また，DB Connector for Reliable Messagingの接続テストをする場合は，Reliable Messagingが開始している必要があります。

リソースアダプタを開始します。

cjstartrarコマンドを実行して，HCSCサーバが利用しているリソースアダプタを開始します。

リソースアダプタを開始する方法については，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「4.3.6　J2EEリソースアダプタの開始」を参照してください。

cjstartrarコマンドの実行形式を次に示します。

cjstartrar ［<サーバ名称>］ ［-nameserver <プロバイダURL>］ -resname <リソースアダプタの表示名>

注意事項

Reliable Messagingを開始する場合は，DB Connector for Reliable Messagingが開始している必要があります。

J2EEサーバを停止します。

cscsvstopコマンドに-logicalオプションを指定して，J2EEサーバを停止します。

J2EEサーバを停止する方法については，「5.3.41　HCSCサーバを停止する」を参照してください。

cscsvstopコマンドの実行形式を次に示します。

cscsvstop -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -logical <J2EEサーバ名>

HCSCサーバを論理サーバと同時に一括起動します。

cscsvstartコマンドに-systemオプションを指定して，HCSCサーバを論理サーバと同時に一括して起動します。

HCSCサーバと論理サーバの起動方法については，「5.3.4　HCSCサーバを起動する」を参照してください。

cscsvstartコマンドの実行形式を次に示します。

cscsvstart -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -system

5.3.30　HCSCコンポーネントの定義情報を変更する

運用中に次に示すHCSCコンポーネントの定義情報を変更するときの前提条件，および開始方法について説明します。

SOAP受付

TP1/RPC受付

FTP受付

HTTP受付

Message Queue受付

ファイルイベント受付

Kafka受付

スケジュール駆動受付

gRPC受付

カスタム受付

DBアダプタ

TP1アダプタ

ファイルアダプタ

Object Accessアダプタ

Message Queueアダプタ

FTPアダプタ

ファイル操作アダプタ

メールアダプタ

HTTPアダプタ

コマンドアダプタ

SFTPアダプタ

Kafkaアダプタ

gRPCアダプタ

汎用カスタムアダプタ

(1)　前提条件

HCSCコンポーネントの定義情報を変更するには，次の条件を満たしている必要があります。

HCSCサーバが起動状態であること

変更するHCSCコンポーネントと関連する受付が停止状態で，かつ変更対象のHCSCコンポーネントが停止状態であること

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

(2)　変更方法

HCSCコンポーネントの定義情報は，次の手順で変更します。

定義を変更するHCSCコンポーネントをアンデプロイします。

アンデプロイする場合の実行形式を次に示します。

csccompoundeploy -cluster <クラスタ名> -user <ログインユーザID> -pass <ログインパスワード> -name <サービスIDまたは受付ID>

詳細は，マニュアル「サービスプラットフォーム リファレンス」の「csccompoundeploy（配備済みのHCSCコンポーネントの削除）」を参照してください。

定義ファイルを取得します。

定義ファイルを取得する場合の実行形式を次に示します。

csccmctl -cluster <クラスタ名> -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -name <サービスIDまたは受付ID> -operation get -targetfilename <定義ファイル名> -basedir <定義ファイルを格納するディレクトリのファイルパス>

詳細は，マニュアル「サービスプラットフォーム リファレンス」の「csccmctl（定義ファイルの管理）」を参照してください。

定義ファイルの内容を変更します。

定義ファイルを設定します。

定義ファイルを設定する場合の実行形式を次に示します。

csccmctl -cluster <クラスタ名> -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -name <サービスIDまたは受付ID> -operation set -targetfilename <定義ファイル名> -basedir <定義ファイルが格納されたディレクトリのファイルパス>

詳細は，マニュアル「サービスプラットフォーム リファレンス」の「csccmctl（定義ファイルの管理）」を参照してください。

定義を設定したHCSCコンポーネントをデプロイします。

デプロイする場合の実行形式を次に示します。

csccompodeploy -cluster <クラスタ名> -user <ログインユーザID> -pass <ログインパスワード> -name <サービスIDまたは受付ID>

詳細は，マニュアル「サービスプラットフォーム リファレンス」の「csccompodeploy（HCSCコンポーネントの配備）」を参照してください。

5.3.31　作業フォルダを参照する

作業フォルダのフォルダ一覧を参照するには，運用環境でcscfswlsコマンドを実行します。

作業フォルダを削除する前の状態を取得する場合と，作業フォルダを削除したあとの状態を取得する場合の実行形式を次に示します。

作業フォルダを削除する前の状態を取得する場合

cscfswls -user <ログインユーザID> -pass <ログインパスワード> -all -csc <HCSCサーバ名> <作業フォルダ削除前の一覧結果のファイルパス>

作業フォルダを削除したあとの状態を取得する場合

cscfswls -user <ログインユーザID> -pass <ログインパスワード> -all -csc <HCSCサーバ名> <作業フォルダ削除後の一覧結果のファイルパス>

詳細は，マニュアル「サービスプラットフォーム リファレンス」の「cscfswls（作業フォルダの参照）」を参照してください。

5.3.32　作業フォルダを削除する

作業フォルダを削除するときの前提条件，および削除方法について説明します。

(1)　前提条件

作業フォルダを削除するには，すべてのビジネスプロセスが削除対象の作業フォルダにアクセスしていない必要があります。

(2)　削除方法

作業フォルダを削除するには，運用環境でcscfswrmコマンドを実行します。

作業フォルダを削除する場合の実行形式を次に示します。

cscfswrm -user <ログインユーザID> -pass <ログインパスワード> -d 0 -all -csc <HCSCサーバ名>

詳細は，マニュアル「サービスプラットフォーム リファレンス」の「cscfswrm（作業フォルダの削除）」を参照してください。

5.3.33　共通フォルダの情報を参照する

共通フォルダ内のファイル一覧を参照するには，運用環境でcscfsclsコマンドを実行します。

共通フォルダを削除する前の状態を取得する場合と，共通フォルダを削除したあとの状態を取得する場合の実行形式を次に示します。

共通フォルダを削除する前に取得する場合

cscfscls -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -folder <共通フォルダ定義名> -csc <HCSCサーバ名> <共通フォルダ内のファイル削除前の一覧結果のファイルパス>

共通フォルダを削除したあとに取得する場合

cscfscls -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -folder <共通フォルダ定義名> -csc <HCSCサーバ名> <共通フォルダ内のファイル削除後の一覧結果のファイルパス>

詳細は，マニュアル「サービスプラットフォーム リファレンス」の「cscfscls（共通フォルダの参照）」を参照してください。

5.3.34　共通フォルダ内のファイルを削除する

共通フォルダ内のファイルを削除するときの前提条件，および削除方法について説明します。

(1)　前提条件

共通フォルダ内のファイルを削除するには，すべてのビジネスプロセスが削除対象のファイルにアクセスしていない必要があります。

(2)　削除方法

共通フォルダ内のファイルを削除するには，運用環境でcscfscrmコマンドを実行します。

共通フォルダ内のファイルを削除する場合の実行形式を次に示します。

cscfscrm -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -folder <共通フォルダ定義名> -d 0 -csc <HCSCサーバ名>

詳細は，マニュアル「サービスプラットフォーム リファレンス」の「cscfscrm（共通フォルダの削除）」を参照してください。

5.3.35　標準受付を停止する

標準受付の停止方法には，通常停止，計画停止および強制停止があります。

通常停止

同期受付の場合

仕掛かり中の実行要求を処理したあと，標準受付を停止します。

非同期受付の場合

サービスリクエスタからの実行要求を受け付けない状態にして，仕掛かり中の実行要求を処理したあとに，標準受付を停止します。キュー内には，受け付けた実行要求が処理されないで残ります。

通常停止したあと，標準受付を再度開始すると，キュー内に残っていた実行要求から処理が開始されます。

通常停止したあとにHCSCサーバをアンセットアップした場合，キュー内に残っている実行要求は破棄されます。

計画停止

標準受付を停止したあとにHCSCサーバをアンセットアップする場合に利用する停止方法です。計画停止を実行すると，次のように標準受付が停止されます。

同期受付の場合

仕掛かり中の実行要求を処理したあと，標準受付を停止します。

非同期受付の場合

サービスリクエスタからの実行要求を受け付けない状態にして，キュー内に残っている実行要求をすべて処理したあとに，標準受付を停止します。

強制停止

コマンドでだけ実行できます。ほかのコマンドの実行中や標準受付の停止失敗中でも強制的に停止できます。

標準受付の停止の前提条件と停止方法について次に説明します。

(1)　前提条件

標準受付を停止するには，次の条件を満たす必要があります。

HCSCサーバが起動状態であること

標準受付が開始状態であること

HCSCサーバおよび標準受付の状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

(2)　停止方法

標準受付を停止する方法を次に示します。

注意事項

標準受付が停止できなかった場合，エラーになった原因を取り除いたあと，標準受付を強制停止してください。標準受付を停止状態にしたあとで，再度標準受付を開始して運用を再開してください。標準受付を開始する方法については，「5.3.10　標準受付を開始する」を参照してください。

(a)　画面の場合

運用環境の画面を利用して標準受付を停止する手順を次に示します。

ツリービュー上で，標準受付を停止するHCSCサーバをダブルクリックします。

ダブルクリックしたHCSCサーバの情報がエディタエリアに表示されます。

エディタエリアで［稼働運用］タブを選択します。

稼働運用ページに，手順1で選択したHCSCサーバの稼働運用に関する情報が表示されます。

HCSCサーバの稼働運用ページの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「4.4　稼働運用ページ」を参照してください。

稼働運用ページに表示された内容を確認し，「標準受付」の［通常停止］ボタンまたは［計画停止］ボタンをクリックします。

標準受付の停止を確認するダイアログが表示されます。

ダイアログに表示された内容を確認し，［OK］ボタンをクリックします。

標準受付の停止処理が開始されます。停止処理中のログはコンソールビューに出力されます。

［キャンセル］ボタンをクリックした場合は，停止処理を実行しないで稼働運用ページに戻ります。

標準受付の停止処理が完了すると，実行結果を示すダイアログが表示されます。

実行結果を示すダイアログを確認します。

停止処理が成功した場合

［OK］ボタンをクリックして，稼働運用ページに戻ります。

稼働運用ページでは，標準受付の稼働状態が「停止状態」になります。また，［通常停止］ボタンおよび［計画停止］ボタンが非活性化し，［開始］ボタンが活性化します。

停止処理が失敗した場合

ダイアログにエラーの内容が表示されます。詳細情報に表示されるメッセージIDを参照して対処してください。

(b)　コマンドの場合

標準受付を停止するには，運用環境でcscrcptnstopコマンドまたはcscutilコマンドを実行します。

cscrcptnstopコマンドおよびcscutilコマンドは，次の場合に使用します。

cscrcptnstopコマンド

該当するリポジトリが存在する運用環境で，標準受付を停止する場合。

cscutilコマンド

該当するリポジトリがなく，cscutilコマンドが使用できる環境（例えば，JP1で直接運用している実行環境）で標準受付を停止する場合。

それぞれのコマンドの実行方法を次に説明します。

●cscrcptnstopコマンドの場合

運用環境でcscrcptnstopコマンドを実行します。

cscrcptnstopコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscrcptnstop（標準受付およびユーザ定義受付の停止）」を参照してください。

cscrcptnstopコマンドの実行形式を次に示します。

クラスタ内のすべてのHCSCサーバの標準受付を一括して停止する場合（クラスタ単位）

クラスタ名を指定して実行します。

-clusterオプションで指定したクラスタ内のすべてのHCSCサーバの標準受付が一括して停止されます（停止されていないユーザ定義受付も同時にすべて停止されます）。

cscrcptnstop -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名>

ユーザ定義受付を停止しないで標準受付だけを停止する場合は，-standardオプションを指定します。

cscrcptnstop -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -standard

HCSCサーバの標準受付を一括して停止する場合（HCSCサーバ単位）

HCSCサーバ名を指定して実行します。

-cscオプションで指定したHCSCサーバの標準受付が停止されます（停止されていないユーザ定義受付も同時にすべて停止されます）。

cscrcptnstop -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名>

ユーザ定義受付を停止しないで標準受付だけを停止する場合は，-standardオプションを指定します。

cscrcptnstop -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -standard

●cscutilコマンドの場合

運用環境でcscutilコマンドを実行します。-targetオプションにrequest_serviceを，また-operationオプションにstopを指定します。

cscutilコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscutil（各種操作）」を参照してください。

cscutilコマンドの実行形式は，プロパティ定義ファイルを使用するかどうかによって異なります。

プロパティ定義ファイルを使用しない場合

-propsオプションにHCSCサーバ名，J2EEサーバ名および停止フラグを指定します。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Manager名> -target request_service -operation stop -props "CSCSrvName=<HCSCサーバ名>, J2EESrvName=<J2EEサーバ名>, ForceFlag=<停止フラグ>"

cscutilコマンドに指定するManager名，HCSCサーバ名およびJ2EEサーバ名は，cscreplsコマンドで確認できます。cscreplsコマンドの詳細については，マニュアル「サービスプラットフォームリファレンス」の「cscrepls（リポジトリ情報の表示）」を参照してください。

また，停止フラグには，通常停止，計画停止または強制停止のどれを実行するか指定します。停止フラグには，次のどれかを指定してください。

通常停止：NORMAL_OPTION

計画停止：WAIT_OPTION

強制停止：FORCE_OPTION

プロパティ定義ファイルを使用する場合

-propfileオプションにプロパティ定義ファイル名を指定します。プロパティ定義ファイルは，J2SEのプロパティファイル形式であらかじめ作成しておく必要があります。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Manager名> -target request_service -operation stop -propfile <プロパティ定義ファイル名>

5.3.36　ユーザ定義受付を停止する

ユーザ定義受付の停止の前提条件と停止方法について次に説明します。

(1)　前提条件

ユーザ定義受付を停止するには，次の条件を満たす必要があります。

HCSCサーバが起動状態であること

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

ユーザ定義受付が開始状態であること

ユーザ定義受付の確認方法については，「5.3.21　ユーザ定義受付の情報を確認する」を参照してください。

(2)　停止方法

ユーザ定義受付を停止するには，運用環境でcscrcptnstopコマンドまたはcsccompostopコマンドを実行します。

cscrcptnstopコマンドおよびcsccompostopコマンドは，次の場合に使用します。

cscrcptnstopコマンド

受付を一括して停止する場合に使用します。

HCSCサーバに配備されているユーザ定義受付を一括して停止する場合に使用します。

クラスタ単位で一括して停止することもできます。なお，特定のユーザ定義受付だけを停止することはできません。

該当するリポジトリが存在する運用環境で，ユーザ定義受付を停止する場合に使用します。

csccompostopコマンド

サービスアダプタ，ビジネスプロセスおよびユーザ定義受付を一括して停止する場合に使用します。

ユーザ定義受付だけを一括で停止することはできません。

HCSCサーバに配備されている特定のユーザ定義受付を停止する場合に使用します。

クラスタ単位で特定のユーザ定義受付を停止することもできます。

該当するリポジトリが存在する運用環境で，ユーザ定義受付を停止する場合に使用します。

それぞれのコマンドの実行方法を次に説明します。

●cscrcptnstopコマンドの場合

運用環境でcscrcptnstopコマンドを実行します。

cscrcptnstopコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscrcptnstop（標準受付およびユーザ定義受付の停止）」を参照してください。

cscrcptnstopコマンドの実行形式を次に示します。

クラスタ内のすべてのHCSCサーバに配備されている受付を一括して停止する場合（クラスタ単位）

クラスタ名を指定して実行します。

-clusterオプションで指定したクラスタ内のすべてのHCSCサーバに配備されている受付が一括して停止されます（停止されていない標準受付も同時にすべて停止されます）。

cscrcptnstop -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名>

標準受付を停止しないでユーザ定義受付だけを停止する場合は，-userdefオプションを指定します。

cscrcptnstop -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -userdef

HCSCサーバに配備されている受付を一括して停止する場合（HCSCサーバ単位）

HCSCサーバ名を指定して実行します。

-cscオプションで指定したHCSCサーバに配備されている受付が停止されます（停止されていない標準受付も同時にすべて停止されます）。

cscrcptnstop -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名>

標準受付を停止しないでユーザ定義受付だけを停止する場合は，-userdefオプションを指定します。

cscrcptnstop -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -userdef

●csccompostopコマンドの場合

運用環境でcsccompostopコマンドを実行します。

csccompostopコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「csccompostop（HCSCコンポーネントの停止）」を参照してください。

csccompostopコマンドの実行形式を次に示します。

クラスタ内のすべてのHCSCサーバに配備されているユーザ定義受付を一括して停止する場合（クラスタ単位）

クラスタ名と-allオプションを指定して実行します。

-clusterオプションで指定したクラスタ内のすべてのHCSCサーバに配備されているユーザ定義受付が一括して停止されます（停止されていないサービスアダプタおよびビジネスプロセスも同時にすべて停止されます）。

csccompostop -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -all

HCSCサーバに配備されているユーザ定義受付を一括して停止する場合（HCSCサーバ単位）

HCSCサーバ名と-allオプションを指定して実行します。

-cscオプションで指定したHCSCサーバに配備されているユーザ定義受付が停止されます（停止されていないサービスアダプタおよびビジネスプロセスも同時にすべて停止されます）。

csccompostop -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -all

クラスタ内のすべてのHCSCサーバに配備されている特定のユーザ定義受付を停止する場合

クラスタ名とユーザ定義受付の受付IDを指定して実行します。

csccompostop -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -name <ユーザ定義受付の受付ID>

HCSCサーバに配備されている特定のユーザ定義受付を停止する場合

HCSCサーバ名とユーザ定義受付の受付IDを指定して実行します。

csccompostop -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -name <ユーザ定義受付の受付ID>

5.3.37　サービスアダプタを停止する

サービスアダプタの停止の前提条件と停止方法について説明します。

注意事項

サービスアダプタは，デプロイ，アンデプロイ，キャッシュの登録を繰り返すと，不要なキャッシュが増加します。サービスアダプタのキャッシュは，csccompostopコマンド（HCSCコンポーネントの停止）では削除されません。不要なキャッシュを削除するには，cscsvstopコマンドを実行してHCSCサーバを停止してください。その後，デプロイを再実行してください。

(1)　前提条件

サービスアダプタを停止するには，次の条件を満たす必要があります。

HCSCサーバが起動状態であること

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

サービスアダプタが開始状態であること

サービスアダプタの状態の確認方法については，「5.3.19　サービスアダプタの情報を確認する」を参照してください。

(2)　停止方法

サービスアダプタを停止する方法を次に示します。

(a)　画面の場合

運用環境の画面を利用してサービスアダプタを停止する手順を次に示します。

ツリービュー上で，停止するサービスアダプタをダブルクリックします。

ダブルクリックしたサービスアダプタの情報がエディタエリアの稼働運用ページに表示されます。

サービスアダプタの稼働運用ページの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「4.4　稼働運用ページ」を参照してください。

稼働運用ページに表示された内容を確認し，［停止］ボタンをクリックします。

サービスアダプタの停止を確認するダイアログが表示されます。

ダイアログに表示された内容を確認し，［OK］ボタンをクリックします。

サービスアダプタの停止処理が開始されます。停止処理中のログはコンソールビューに出力されます。

［キャンセル］ボタンをクリックした場合は，停止処理を実行しないで稼働運用ページに戻ります。

サービスアダプタの停止処理が完了すると，実行結果を示すダイアログが表示されます。

実行結果を示すダイアログを確認します。

停止処理が成功した場合

［OK］ボタンをクリックして，稼働運用ページに戻ります。

稼働運用ページでは，サービスアダプタの状態が「停止状態」になります。また，［停止］ボタンが非活性化し，［開始］ボタンが活性化します。

停止処理が失敗した場合

ダイアログにエラーの内容が表示されます。詳細情報に表示されるメッセージIDを参照して対処してください。

(b)　コマンドの場合

サービスアダプタを停止するには，運用環境でcsccompostopコマンドまたはcscutilコマンドを実行します。

csccompostopコマンドおよびcscutilコマンドは，次の場合に使用します。

csccompostopコマンド

該当するリポジトリが存在する運用環境で，サービスアダプタを停止する場合。

cscutilコマンド

該当するリポジトリがなく，cscutilコマンドが使用できる環境（例えば，JP1で直接運用している実行環境）でサービスアダプタを停止する場合。

それぞれのコマンドの実行方法を次に説明します。

●csccompostopコマンドの場合

運用環境でcsccompostopコマンドを実行します。

csccompostopコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「csccompostop（HCSCコンポーネントの停止）」を参照してください。

csccompostopコマンドの実行形式を次に示します。

クラスタ内のすべてのHCSCサーバに配備されているサービスアダプタを一括して停止する場合（クラスタ単位）

クラスタ名と-allオプションを指定して実行します。

-clusterオプションで指定したクラスタ内のすべてのHCSCサーバに配備されているサービスアダプタが一括して停止されます（停止されていないビジネスプロセスおよびユーザ定義受付も同時にすべて停止されます）。

csccompostop -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -all

ビジネスプロセスおよびユーザ定義受付を停止しないでユーザ定義受付だけを停止する場合は，サービスアダプタのサービスIDを指定します。

csccompostop -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -name <サービスアダプタのサービスID>

HCSCサーバに配備されているサービスアダプタを一括して停止する場合（HCSCサーバ単位）

HCSCサーバ名と-allオプションを指定して実行します。

-cscオプションで指定したHCSCサーバに配備されているサービスアダプタが停止されます（停止されていないビジネスプロセスおよびユーザ定義受付も同時にすべて停止されます）。

csccompostop -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -all

ビジネスプロセスおよびユーザ定義受付を停止しないでサービスアダプタだけを停止する場合は，サービスアダプタのサービスIDを指定します。

csccompostop -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -name <サービスアダプタのサービスID>

●cscutilコマンドの場合

運用環境でcscutilコマンドを実行します。-targetオプションにcompoを，また-operationオプションにstopを指定します。

cscutilコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscutil（各種操作）」を参照してください。

cscutilコマンドの実行形式は，プロパティ定義ファイルを使用するかどうかによって異なります。

プロパティ定義ファイルを使用しない場合

-propsオプションにサービスアダプタのサービスID，HCSCサーバ名およびJ2EEサーバ名を指定します。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Manager名> -target compo -operation stop -props "AdapterName=<サービスアダプタのサービスID>, CSCSrvName=<HCSCサーバ名>, J2EESrvName=<J2EEサーバ名>"

cscutilコマンドに指定するManager名，サービスアダプタのサービスID，HCSCサーバ名およびJ2EEサーバ名は，cscreplsコマンドで確認できます。cscreplsコマンドの詳細については，マニュアル「サービスプラットフォームリファレンス」の「cscrepls（リポジトリ情報の表示）」を参照してください。

プロパティ定義ファイルを使用する場合

-propfileオプションにプロパティ定義ファイル名を指定します。プロパティ定義ファイルは，J2SEのプロパティファイル形式であらかじめ作成しておく必要があります。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Manager名> -target compo -operation stop -propfile <プロパティ定義ファイル名>

5.3.38　ビジネスプロセスを停止する

ビジネスプロセスの停止の前提条件と停止方法について次に説明します。

(1)　前提条件

ビジネスプロセスを停止するには，次の条件を満たす必要があります。

HCSCサーバが起動状態であること

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

ビジネスプロセスが開始状態であること

ビジネスプロセスの状態の確認方法については，「5.3.20　ビジネスプロセスの情報を確認する」を参照してください。

(2)　停止方法

ビジネスプロセスを停止する方法を次に示します。

(a)　画面の場合

運用環境の画面を利用してビジネスプロセスを停止する手順を次に示します。

ツリービュー上で，停止するビジネスプロセスをダブルクリックします。

ダブルクリックしたビジネスプロセスの情報がエディタエリアに表示されます。

エディタエリアで稼働運用ページを選択します。

手順1で選択したビジネスプロセスの稼働運用に関する情報が表示されます。

ビジネスプロセスの稼働運用ページの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「4.4　稼働運用ページ」を参照してください。

稼働運用ページに表示された内容を確認し，［停止］ボタンをクリックします。

ビジネスプロセスの停止を確認するダイアログが表示されます。

ダイアログに表示された内容を確認し，［OK］ボタンをクリックします。

ビジネスプロセスの停止処理が開始されます。停止処理中のログはコンソールビューに出力されます。

［キャンセル］ボタンをクリックした場合は，停止処理を実行しないで稼働運用ページに戻ります。

ビジネスプロセスの停止処理が完了すると，実行結果を示すダイアログが表示されます。

実行結果を示すダイアログを確認します。

停止処理が成功した場合

［OK］ボタンをクリックして，稼働運用ページに戻ります。

稼働運用ページでは，ビジネスプロセスの稼働状態が「停止状態」になります。また，［停止］ボタンが非活性化し，［開始］ボタンが活性化します。

停止処理が失敗した場合

ダイアログにエラーの内容が表示されます。詳細情報に表示されるメッセージIDを参照して対処してください。

(b)　コマンドの場合

ビジネスプロセスを停止するには，運用環境でcsccompostopコマンドまたはcscutilコマンドを実行します。

csccompostopコマンドおよびcscutilコマンドは，次の場合に使用します。

csccompostopコマンド

該当するリポジトリが存在する運用環境で，ビジネスプロセスを停止する場合。

cscutilコマンド

該当するリポジトリがなく，cscutilコマンドが使用できる環境（例えば，JP1で直接運用している実行環境）でビジネスプロセスを停止する場合。

それぞれのコマンドの実行方法を次に説明します。

●csccompostopコマンドの場合

運用環境でcsccompostopコマンドを実行します。

csccompostopコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「csccompostop（HCSCコンポーネントの停止）」を参照してください。

csccompostopコマンドの実行形式を次に示します。

クラスタ内のすべてのHCSCサーバに配備されているビジネスプロセスを一括して停止する場合（クラスタ単位）

クラスタ名と-allオプションを指定して実行します。

-clusterオプションで指定したクラスタ内のすべてのHCSCサーバに配備されているビジネスプロセスが一括して停止されます（停止されていないサービスアダプタおよびユーザ定義受付も同時にすべて停止されます）。

csccompostop -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -all

サービスアダプタおよびユーザ定義受付を停止しないでビジネスプロセスだけを停止する場合は，ビジネスプロセスのサービスIDを指定します。

csccompostop -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -name <ビジネスプロセスのサービスID>

HCSCサーバに配備されているビジネスプロセスを一括して停止する場合（HCSCサーバ単位）

HCSCサーバ名と-allオプションを指定して実行します。

-cscオプションで指定したHCSCサーバに配備されているビジネスプロセスが停止されます（停止されていないサービスアダプタおよびユーザ定義受付も同時にすべて停止されます）。

csccompostop -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -all

サービスアダプタおよびユーザ定義受付を停止しないでビジネスプロセスだけを停止する場合は，ビジネスプロセスのサービスIDを指定します。

csccompostop -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -name <ビジネスプロセスのサービスID>

●cscutilコマンドの場合

運用環境でcscutilコマンドを実行します。-targetオプションにcompoを，また-operationオプションにstopを指定します。

cscutilコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscutil（各種操作）」を参照してください。

cscutilコマンドの実行形式は，プロパティ定義ファイルを使用するかどうかによって異なります。

プロパティ定義ファイルを使用しない場合

-propsオプションにビジネスプロセスのサービスID，HCSCサーバ名およびJ2EEサーバ名を指定します。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Manager名> -target compo -operation stop -props "AdapterName=<ビジネスプロセスのサービスID>, CSCSrvName=<HCSCサーバ名>, J2EESrvName=<J2EEサーバ名>"

cscutilコマンドに指定するManager名，ビジネスプロセスのサービスID，HCSCサーバ名およびJ2EEサーバ名は，cscreplsコマンドで確認できます。cscreplsコマンドの詳細については，マニュアル「サービスプラットフォームリファレンス」の「cscrepls（リポジトリ情報の表示）」を参照してください。

プロパティ定義ファイルを使用する場合

-propfileオプションにプロパティ定義ファイル名を指定します。プロパティ定義ファイルは，J2SEのプロパティファイル形式であらかじめ作成しておく必要があります。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Manager名> -target compo -operation stop -propfile <プロパティ定義ファイル名>

5.3.39　HTTP Serverを停止する

HTTP Serverの停止方法には，通常停止と計画停止があります。

通常停止

リクエスト処理の実行中に停止処理が行われた場合，リクエスト処理の終了を待たないでHTTP Serverを停止します。リクエスト処理の終了を待たないでHTTP Serverを停止するため，処理中のリクエストの処理は保証されません。

計画停止

リクエスト処理の実行中に停止処理が行われた場合，リクエスト処理の終了を待ってからHTTP Serverを停止します。リクエスト処理の終了を待ってからHTTP Serverを停止するため，処理中のリクエストの処理は保証されます。

デフォルトは計画停止が設定されています。設定を変更したい場合は，HCSC-Manager定義ファイルのcscmng.server.<HCSCサーバ名>.hws.svstopパラメタで設定します。また，計画停止の場合は，HTTP Server計画停止時のタイムアウト値も設定できます。タイムアウト値は，HCSC-Manager定義ファイルのcscmng.server.<HCSCサーバ名>.hws.svstop.timeoutパラメタで設定します。

HCSC-Manager定義ファイルの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.5.3　HCSC-Manager定義ファイル」を参照してください。

(1)　停止方法

HTTP Serverを停止するには，運用環境でcscsvstopコマンドを実行します。-logicalオプションにHTTP Serverの論理サーバ名を指定して実行します。

cscsvstopコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscsvstop（HCSCサーバの停止）」を参照してください。

cscsvstopコマンドの実行形式を次に示します。

cscsvstop -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -logical <HTTP Serverの論理サーバ名>

5.3.40　KafkaインバウンドアダプタおよびgRPCインバウンドアダプタを停止する

KafkaインバウンドアダプタおよびgRPCインバウンドアダプタを停止するときの前提条件，および停止方法について説明します。

(1)　前提条件

KafkaインバウンドアダプタおよびgRPCインバウンドアダプタを停止するには，次の条件を満たす必要があります。

HCSCサーバが起動状態であること

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

KafkaインバウンドアダプタおよびgRPCインバウンドアダプタが開始状態であること

インバウンドアダプタの状態の確認方法については，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「4.5　リソースアダプタの一覧の参照」を参照してください。

Kafka受付およびgRPC受付が停止状態であること

Kafkaインバウンドアダプタを参照しているKafka受付が起動していると，Kafkaインバウンドアダプタを停止できません。gRPCインバウンドアダプタも同様です。

事前にKafka受付およびgRPC受付を停止してください。

(2)　停止方法

インバウンドアダプタを停止する場合の実行形式を次に示します。

<サービスプラットフォームのインストールディレクトリ>¥CC¥admin¥bin¥cjstoprar <J2EEサーバ名称> -resname <リソースアダプタ表示名>

cjstoprarコマンドの詳細は，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「2.4　J2EEサーバで使用するリソース操作コマンド」を参照してください。

5.3.41　HCSCサーバを停止する

HCSCサーバの停止の前提条件と停止方法について次に説明します。

(1)　前提条件

HCSCサーバを停止するには，受付が停止状態である必要があります。

標準受付の状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。ユーザ定義受付の状態の確認方法については，「5.3.21　ユーザ定義受付の情報を確認する」を参照してください。

なお，コマンドを利用してHCSCサーバを停止する場合，強制停止を実行できます。強制停止を実行すると，受付が起動していてもHCSCサーバを停止できます。

(2)　停止方法

HCSCサーバを停止する方法を次に示します。

(a)　画面の場合

運用環境の画面を利用してHCSCサーバを停止する手順を次に示します。

ツリービュー上で，停止するHCSCサーバをダブルクリックします。

選択したHCSCサーバの情報がエディタエリアに表示されます。

エディタエリアで［稼働運用］タブを選択します。

稼働運用ページに，手順1で選択したHCSCサーバの稼働運用に関する情報が表示されます。

HCSCサーバの稼働運用ページの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「4.4　稼働運用ページ」を参照してください。

稼働運用ページに表示された内容を確認し，「HCSCサーバ」の［停止］ボタンをクリックします。

HCSCサーバの停止を確認するダイアログが表示されます。

ダイアログに表示された内容を確認し，［OK］ボタンをクリックします。

HCSCサーバの停止処理が開始されます。停止処理中のログはコンソールビューに出力されます。

［キャンセル］ボタンをクリックした場合は，停止処理を実行しないで稼働運用ページに戻ります。

HCSCサーバの停止処理が完了すると，実行結果を示すダイアログが表示されます。

実行結果を示すダイアログを確認します。

停止処理が成功した場合

［OK］ボタンをクリックして，稼働運用ページに戻ります。

稼働運用ページでは，HCSCサーバの稼働状態が「停止状態」になります。また，［停止］ボタンが非活性化し，［起動］ボタンが活性化します。

停止処理が失敗した場合

ダイアログにエラーの内容が表示されます。詳細情報に表示されるメッセージIDを参照して対処してください。

(b)　コマンドの場合

HCSCサーバを停止するには，運用環境でcscsvstopコマンドまたはcscutilコマンドを実行します。クラスタ内のHCSCサーバを一括して停止する場合，または論理サーバを停止する場合は，cscsvstopコマンドを実行します。

cscsvstopコマンドおよびcscutilコマンドは，次の場合に使用します。

cscsvstopコマンド

該当するリポジトリが存在する運用環境で，HCSCサーバを停止する場合。

cscutilコマンド

該当するリポジトリがなく，cscutilコマンドが使用できる環境（例えば，JP1で直接運用している実行環境）でHCSCサーバを停止する場合。

それぞれのコマンドの実行方法を次に説明します。

●cscsvstopコマンドの場合

運用環境でcscsvstopコマンドを実行します。

cscsvstopコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscsvstop（HCSCサーバの停止）」を参照してください。

cscsvstopコマンドの実行形式を次に示します。

クラスタ内のHCSCサーバを一括して停止する場合

クラスタ名を指定して実行します。

cscsvstop -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名>

クラスタ内のHCSCサーバの停止と同時に論理サーバを停止する場合は，-systemオプションを指定します。ただし，HCSC-Manager定義ファイルに論理サーバを登録している必要があります。論理サーバの登録の詳細については，「5.3.1(1)　運用する前の準備」を参照してください。

cscsvstop -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -system

また，HCSCサーバは停止しないで指定した論理サーバだけを停止する場合は，-logicalオプションを指定します。

cscsvstop -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -logical <論理サーバ名>

なお，-systemオプションまたは-logicalオプションを指定して，論理サーバのうちHTTP Serverを停止する場合，HTTP Serverの停止方法には，通常停止と計画停止があります。HTTP Serverの停止方法の詳細については，「5.3.39　HTTP Serverを停止する」を参照してください。

それぞれのHCSCサーバを個別に停止する場合

HCSCサーバ名を指定して実行します。

cscsvstop -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名>

HCSCサーバの停止と同時に論理サーバを停止する場合は，-systemオプションを指定します。

cscsvstop -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -system

また，HCSCサーバは停止しないで指定した論理サーバだけを停止する場合は，-logicalオプションを指定します。

cscsvstop -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -logical <論理サーバ名>

なお，-systemオプションまたは-logicalオプションを指定して，論理サーバのうちHTTP Serverを停止する場合，HTTP Serverの停止方法には，通常停止と計画停止があります。HTTP Serverの停止方法の詳細については，「5.3.39　HTTP Serverを停止する」を参照してください。

●cscutilコマンドの場合

運用環境でcscutilコマンドを実行します。-targetオプションにserverを，また-operationオプションにstopを指定します。

cscutilコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscutil（各種操作）」を参照してください。

cscutilコマンドの実行形式は，プロパティ定義ファイルを使用するかどうかによって異なります。

プロパティ定義ファイルを使用しない場合

-propsオプションにHCSCサーバ名，J2EEサーバ名および停止フラグを指定します。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Manager名> -target server -operation stop -props "CSCSrvName=<HCSCサーバ名>, J2EESrvName=<J2EEサーバ名>, ForceFlag=<停止フラグ>"

cscutilコマンドに指定するManager名，HCSCサーバ名およびJ2EEサーバ名は，cscreplsコマンドで確認できます。cscreplsコマンドの詳細については，マニュアル「サービスプラットフォームリファレンス」の「cscrepls（リポジトリ情報の表示）」を参照してください。

また，停止フラグには，通常停止または強制停止のどちらを実行するか指定します。停止フラグには，次のどちらかを指定してください。

通常停止：false

強制停止：true

プロパティ定義ファイルを使用する場合

-propfileオプションにプロパティ定義ファイル名を指定します。プロパティ定義ファイルは，J2SEのプロパティファイル形式であらかじめ作成しておく必要があります。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Manager名> -target server -operation stop -propfile <プロパティ定義ファイル名>

5.3.42　PRFを停止する

PRFを停止するには，運用環境でcscsvstopコマンドを実行します。-logicalオプションにPRFの論理サーバ名を指定して実行します。

cscsvstopコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscsvstop（HCSCサーバの停止）」を参照してください。

cscsvstopコマンドの実行形式を次に示します。

cscsvstop -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -logical <PRFの論理サーバ名>

5.3.43　データベースを停止する

データベースの停止方法について次に説明します。

(1)　停止方法（HiRDBの場合）

HiRDBを停止するには，データベースサーバでpdstopコマンドを実行します。

pdstopコマンドの詳細については，マニュアル「HiRDB コマンドリファレンス」を参照してください。

(2)　停止方法（Oracleの場合）

Oracleを停止する方法については，Oracle Corporationが発行するドキュメントを参照してください。

5.4　HCSCサーバのオペレーション運用（FTP連携する場合）

FTP連携システムの運用の流れ，および運用に必要な手順について説明します。

5.4.1　FTP連携システムの運用の流れ

FTP連携システムの運用について，開始する場合と停止する場合に分けて説明します。

(1)　FTP連携システムの運用を開始する場合

FTP連携システムの運用を開始する場合の流れを，次に示します。

図5‒3　FTP連携システムの運用を開始する場合の流れ

(2)　FTP連携システムの運用を停止する場合

FTP連携システムの運用を停止する場合の流れを，次に示します。

図5‒4　FTP連携システムの運用を停止する場合の流れ

5.4.2　HCSCサーバを起動する

HCSCサーバの起動方法については，「5.3.4　HCSCサーバを起動する」を参照してください。

5.4.3　FTPインバウンドアダプタを起動する

FTPインバウンドアダプタを起動するときの前提条件，および起動方法について説明します。

(1)　前提条件

FTPインバウンドアダプタを起動するには，HCSCサーバが起動状態である必要があります。

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

(2)　起動方法

FTPインバウンドアダプタを起動するには，運用環境でcjstartrarコマンドを実行します。

FTPインバウンドアダプタを起動する場合の実行形式を次に示します。

<サービスプラットフォームのインストールディレクトリ>¥CC¥admin¥bin¥cjstartrar <J2EEサーバ名称> -resname <リソースアダプタ表示名>

cjstartrarコマンドの詳細は，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「2.4　J2EEサーバで使用するリソース操作コマンド」を参照してください。

5.4.4　HCSCコンポーネントを起動する

実行環境に配備済みの次のHCSCコンポーネントを起動するときの前提条件，および起動方法について説明します。

FTPアダプタ

ファイル操作アダプタ

ビジネスプロセス

(1)　前提条件

HCSCコンポーネントを起動するには，HCSCサーバが起動状態である必要があります。

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

(2)　起動方法

HCSCコンポーネントを起動するには，運用環境でcsccompostartコマンドを実行します。

FTPアダプタの起動

FTPアダプタを起動する場合の実行形式を次に示します。

csccompostart -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -name <FTPアダプタのサービスID>

ファイル操作アダプタの起動

ファイル操作アダプタを起動する場合の実行形式を次に示します。

csccompostart -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -name <ファイル操作アダプタのサービスID>

ビジネスプロセスの起動

ビジネスプロセスを起動する場合の実行形式を次に示します。

csccompostart -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -name <ビジネスプロセスのサービスID>

詳細は，マニュアル「サービスプラットフォーム リファレンス」の「csccompostart（HCSCコンポーネントの開始）」を参照してください。

5.4.5　標準受付を開始する

標準受付を開始する方法については，「5.3.10　標準受付を開始する」を参照してください。

5.4.6　FTP受付を開始する

FTP受付を開始するときの前提条件，および開始方法について説明します。

(1)　前提条件

FTP受付を開始するには，次の条件を満たしている必要があります。

HCSCサーバが起動状態であること

FTP受付が定義されているビジネスプロセスが開始状態であること

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

(2)　開始方法

FTP受付を開始するには，運用環境でcsccompostartコマンドを実行します。

FTP受付を開始する場合の実行形式を次に示します。

csccompostart -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -name <FTP受付の受付ID>

詳細は，マニュアル「サービスプラットフォーム リファレンス」の「csccompostart（HCSCコンポーネントの開始）」を参照してください。

5.4.7　HCSCサーバの情報を確認する

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

5.4.8　FTPインバウンドアダプタの情報を確認する

FTPインバウンドアダプタの情報を確認するときの前提条件，および確認方法について説明します。

(1)　前提条件

FTPインバウンドアダプタの情報を確認するには，HCSCサーバが起動状態である必要があります。

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

(2)　開始方法

FTPインバウンドアダプタの情報を確認するには，運用環境でcjlistrarコマンドを実行します。

FTPインバウンドアダプタの情報を確認する場合の実行形式を次に示します。

<サービスプラットフォームのインストールディレクトリ>¥CC¥admin¥bin¥cjlistrar <J2EEサーバ名称>

cjstartrarコマンドの詳細は，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「2.4　J2EEサーバで使用するリソース操作コマンド」を参照してください。

実行結果の例を次に示します。

KDJE37400-I Connecting to <J2EEサーバ名称>...
running  FTP_Inbound_Resource_Adapter
KDJE37508-I All RARs have been listed successfully. (number = [1])

「running」は，FTPインバウンドアダプタが起動していることを示しています。停止している場合は「stopped」と出力されます。

5.4.9　HCSCコンポーネントの情報を確認する

実行環境に配備済みの次のHCSCコンポーネントの情報を確認する方法について説明します。

FTPアダプタ

ファイル操作アダプタ

ビジネスプロセス

FTP受付

HCSCコンポーネントの情報を確認するには，cscstatus（状態表示）コマンドまたはcscutil（各種操作）コマンドを実行します。

cscstatusコマンドおよびcscutilコマンドは運用環境から実行できます。

コマンドごとに確認方法を説明します。

(1)　cscstatusコマンドで情報を確認する場合

cscstatusコマンドで情報を確認する場合，-cscオプションと-typeオプションを指定して実行します。-typeオプションには「compo」を指定します。

HCSCコンポーネントの情報を確認する場合の実行形式を次に示します。

cscstatus -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -type compo

詳細は，マニュアル「サービスプラットフォーム リファレンス」の「cscstatus（状態表示）」を参照してください。

(2)　cscutilコマンドで情報を確認する場合

cscutilコマンドで情報を確認する場合，-targetオプションにcompoを，また-operationオプションにget_bp_infoを指定して実行します。

cscutilコマンドの実行形式は，プロパティ定義ファイルを使用するかどうかによって異なります。

(a)　プロパティ定義ファイルを使用しない場合

-propsオプションにHCSCサーバ名およびビジネスプロセスのサービスIDを指定します。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Manager名> -target compo -operation get_bp_info -props "CSCSrvName=<HCSCサーバ名>, AdapterName=<ビジネスプロセスのサービスID>"

詳細は，マニュアル「サービスプラットフォーム リファレンス」の「cscutil（各種操作）」を参照してください。

参考

cscutilコマンドに指定するManager名，HCSCサーバ名およびビジネスプロセスのサービスIDは，cscreplsコマンドで確認できます。詳細は，マニュアル「サービスプラットフォームリファレンス」の「cscrepls（リポジトリ情報の表示）」を参照してください。

(b)　プロパティ定義ファイルを使用する場合

-propfileオプションにプロパティ定義ファイル名を指定します。プロパティ定義ファイルは，J2SEのプロパティファイル形式であらかじめ作成しておく必要があります。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Manager名> -target compo -operation get_bp_info -propfile <プロパティ定義ファイル名>

詳細は，マニュアル「サービスプラットフォーム リファレンス」の「cscutil（各種操作）」を参照してください。

注意事項

配備されていないビジネスプロセスの情報を取得した場合，nullという文字列が表示されます。

ビジネスプロセスのサービスIDを指定しないでcscutilコマンドを実行すると，HCSCサーバが管理しているすべてのビジネスプロセスの情報が出力されます。

5.4.10　HCSCサーバの定義情報を変更する

HCSCサーバの定義情報を変更する場合，HCSCサーバの定義情報を設定する場合と同じ方法で行います。HCSCサーバの定義情報を設定する方法については，「3.1.4　HCSCサーバの定義情報を設定する」を参照してください。

5.4.11　FTPインバウンドアダプタの定義情報を変更する

運用中にFTPインバウンドアダプタの属性定義を変更するときの前提条件，および変更方法について説明します。

(1)　前提条件

FTPインバウンドアダプタの属性定義を変更するには，次の条件を満たしている必要があります。

HCSCサーバが起動状態であること

FTP受付が停止状態で，かつFTPインバウンドアダプタが停止状態であること

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

(2)　変更方法

FTPインバウンドアダプタの定義情報を変更するには，FTPインバウンドアダプタのRARファイルから属性を取得して，属性ファイルを作成したあと，その属性ファイルを編集して定義を反映させます。

FTPインバウンドアダプタの定義情報を変更する手順を次に示します。

FTPインバウンドアダプタのRARファイルから属性を取得して，属性ファイルを作成します。

FTPインバウンドアダプタのRARファイルから属性ファイルを作成する場合の実行形式を次に示します。

<サービスプラットフォームのインストールディレクトリ>¥CC¥admin¥bin¥cjgetrarprop <J2EEサーバ名> -resname FTP_Inbound_Resource_Adapter -c <属性ファイルのファイルパス>

cjgetrarpropコマンドの詳細は，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「2.4　J2EEサーバで使用するリソース操作コマンド」を参照してください。

属性ファイルを編集します。

属性ファイルの定義項目については，「3.2.3(3)(b)　プロパティの内容」を参照してください。

次のコマンドを実行して，FTPインバウンドアダプタの属性定義を反映します。

<サービスプラットフォームのインストールディレクトリ>¥CC¥admin¥bin¥cjsetrarprop <J2EEサーバ名称> -resname <リソースアダプタ表示名> -c <属性ファイルパス>

cjsetrarpropコマンドの詳細は，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「2.4　J2EEサーバで使用するリソース操作コマンド」を参照してください。

5.4.12　FTPインバウンドアダプタのユーザ情報を確認・変更する

運用中にFTPインバウンドアダプタのユーザ情報を確認する方法および変更する方法について説明します。

(1)　FTPインバウンドアダプタのユーザ情報を確認する

FTPインバウンドアダプタのユーザ情報を確認する場合の前提条件，および確認方法について説明します。

(a)　前提条件

FTPインバウンドアダプタのユーザ情報を確認するには，次の条件を満たしている必要があります。

HCSCサーバが起動状態であること

FTP受付が停止状態で，かつFTPインバウンドアダプタが停止状態であること

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

(b)　確認方法

FTPインバウンドアダプタのユーザ定義情報を確認する場合の実行形式を次に示します。

csmftplsusr

詳細は，マニュアル「サービスプラットフォーム リファレンス」の「csmftplsusr（FTPインバウンドアダプタのユーザの表示）」を参照してください。

(2)　FTPインバウンドアダプタのユーザ情報を変更する

FTPインバウンドアダプタのユーザ情報を確認する場合の前提条件，および確認方法について説明します。

(a)　前提条件

FTPインバウンドアダプタのユーザ情報を確認するには，次の条件を満たしている必要があります。

HCSCサーバが起動状態であること

FTP受付が停止状態で，かつFTPインバウンドアダプタが停止状態であること

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

(b)　変更方法

FTPインバウンドアダプタのユーザ定義情報を変更する場合の実行形式を次に示します。

ユーザを追加する場合

csmftpaddusr -usr <ユーザ名> -pass <ユーザのパスワード>

なお，ユーザ情報の変更にユーザ情報指定ファイルを使用する場合は，次のコマンドで変更できます。

csmftpaddusr -userinfofile <ユーザ情報指定ファイルのパス>

ユーザを削除する場合

csmftpdelusr -usr <ユーザ名>

詳細は，マニュアル「サービスプラットフォーム リファレンス」の「csmftpaddusr（FTPインバウンドアダプタのユーザの登録・更新）」および「csmftpdelusr（FTPインバウンドアダプタのユーザの削除）」を参照してください。

注意事項

複数のユーザを追加または削除する場合は，ユーザの数だけコマンドを実行してください。

FTPインバウンドアダプタのユーザのパスワードを変更する場合，いったんパスワードを変更するユーザを削除したあと，変更したパスワードを設定したユーザを追加してください。

5.4.13　FTPアダプタの定義情報を変更する

運用中に次に示すFTPアダプタの定義情報を変更する方法について説明します。

FTPアダプタ実行環境プロパティファイル

FTP実行許可リストファイル

(1)　前提条件

FTPアダプタの定義情報を確認するには，次の条件を満たしている必要があります。

HCSCサーバが起動状態であること

FTP受付が停止状態で，かつFTPアダプタが停止状態であること

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

(2)　変更方法

(a)　FTPアダプタ実行環境プロパティファイルを変更する場合

FTPアダプタ実行環境プロパティファイルの変更は，直接定義ファイルを編集します。

FTPアダプタ実行環境プロパティファイルの格納先は次のとおりです。

全HCSCサーバ共通の定義の場合

<サービスプラットフォームのインストールディレクトリ>¥CSC¥custom-adapter¥FTP¥config¥<サービスID>.properties

特定のHCSCサーバ用の定義の場合

サブディレクトリ<HCSCサーバ名>を作成して格納してください。Windowsの場合，HCSCサーバ名の大文字・小文字は区別されます。

<サービスプラットフォームのインストールディレクトリ>¥CSC¥custom-adapter¥FTP¥config¥<HCSCサーバ名>¥<サービスID>.properties

(b)　FTP実行許可リストファイルを変更する場合

FTP実行許可リストファイルの変更は，直接定義ファイルを編集します。

5.4.14　FTPアダプタのユーザ情報を確認および変更する

運用中にFTPアダプタのユーザ情報を確認および変更する方法について説明します。

FTPアダプタのユーザ情報はFTPアダプタアカウント定義ファイルで管理します。

FTPアダプタアカウント定義ファイルを次のどちらの方法で管理しているかによって，ユーザ情報を確認および変更する方法が異なります。

ユーザ任意の単位に任意のパスのアカウント定義ファイルで管理する

この方法で管理する場合は，実行環境プロパティファイルのftpadp.account-inf-filepathプロパティの設定が必要です。

FTPアダプタ単位に製品固定パスのアカウント定義ファイルで管理する

この方法で管理する場合は，実行環境プロパティファイルのftpadp.account-inf-filepathプロパティの設定は不要です。

(1)　FTPアダプタのユーザ情報を確認する

FTPアダプタのユーザ情報を確認するには，運用環境でcsaftpuserlsコマンドを実行します。

FTPアダプタのユーザ情報を確認する場合の実行形式を次に示します。

●ユーザ任意の単位に任意のパスのアカウント定義ファイルで管理する場合

csaftpuserls -f <FTPアダプタアカウント定義ファイルのパス>

●FTPアダプタ単位に製品固定パスのアカウント定義ファイルで管理する場合

csaftpuserls -name <FTPアダプタのサービスID>

詳細は，マニュアル「サービスプラットフォーム リファレンス」の「csaftpuserls（FTPアダプタのユーザの表示）」を参照してください。

(2)　FTPアダプタのユーザ情報を変更する

FTPアダプタのユーザ情報を変更するときの前提条件，および変更方法について説明します。

(a)　前提条件

FTPアダプタのユーザ情報を変更するには，次の条件を満たしている必要があります。

FTP受付が停止状態であること

FTPアダプタが停止状態であること

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

(b)　変更方法

FTPアダプタのユーザ情報を変更するには，運用環境でcsaftpuseraddコマンドを実行します。なお，FTPアダプタの要求電文にも課金情報が設定されている場合，csaftpuseraddコマンドで変更した課金情報は無視されてFTPアダプタの要求電文の設定が有効になります。

FTPアダプタのユーザを追加する場合，ユーザを削除する場合，およびユーザのパスワードを変更する場合の実行形式を次に示します。

●ユーザ任意の単位に任意のパスのアカウント定義ファイルで管理する場合

(i) ユーザを追加する場合の実行形式

csaftpuseradd -user <ユーザ名> -pass <ユーザのパスワード> -f <FTPアダプタアカウント定義ファイルのパス>

複数のユーザを追加する場合は，ユーザの数だけコマンドを実行してください。なお，ユーザ情報の登録にユーザ情報指定ファイルを使用する場合は，次のコマンドでユーザを追加できます。

csaftpuseradd -userinfofile <ユーザ情報指定ファイルのパス> -f <FTPアダプタアカウント定義ファイルのパス>

課金情報を設定したユーザを登録する場合の実行形式を次に示します。

csaftpuseradd -user <ユーザ名> -pass <ユーザのパスワード> -account <課金情報> -f <FTPアダプタアカウント定義ファイルのパス>

なお，ユーザ情報と課金情報の登録にユーザ情報指定ファイルを使用する場合は，次のコマンドでユーザを登録できます。

csaftpuseradd -userinfofile <ユーザ情報指定ファイルのパス> -f <FTPアダプタアカウント定義ファイルのパス>

(ii) ユーザを削除する場合の実行形式

csaftpuserdel -user <ユーザ名> -f <FTPアダプタアカウント定義ファイルのパス>

複数のユーザを削除する場合は，ユーザの数だけコマンドを実行してください。

(iii) ユーザのパスワードを変更する場合の実行形式

csaftpuseradd -user <ユーザ名> -pass <ユーザのパスワード> -r -f <FTPアダプタアカウント定義ファイルのパス>

複数のユーザのパスワードを変更する場合は，ユーザの数だけコマンドを実行してください。なお，ユーザ情報の変更にユーザ情報指定ファイルを使用する場合は，次のコマンドでパスワードを変更できます。

csaftpuseradd -userinfofile <ユーザ情報指定ファイルのパス> -r -f <FTPアダプタアカウント定義ファイルのパス>

ユーザに課金情報を追加する場合と，ユーザに設定された課金情報を削除する場合の実行形式を次に示します。

ユーザに課金情報を追加する場合の実行形式

csaftpuseradd -user <ユーザ名> -pass <ユーザのパスワード> -account <課金情報> -r -f <FTPアダプタアカウント定義ファイルのパス>

なお，ユーザ情報と課金情報の登録にユーザ情報指定ファイルを使用する場合は，次のコマンドで課金情報を追加できます。

csaftpuseradd -userinfofile <ユーザ情報指定ファイルのパス> -r -f <FTPアダプタアカウント定義ファイルのパス>

ユーザに設定された課金情報を削除する場合の実行形式

csaftpuseradd -user <ユーザ名> -pass <ユーザのパスワード> -r -f <FTPアダプタアカウント定義ファイルのパス>

●FTPアダプタ単位に製品固定パスのアカウント定義ファイルで管理する場合

(i) ユーザを追加する場合の実行形式

csaftpuseradd -user <ユーザ名> -pass <ユーザのパスワード> -name <FTPアダプタのサービスID>

複数のユーザを追加する場合は，ユーザの数だけコマンドを実行してください。なお，ユーザ情報の登録にユーザ情報指定ファイルを使用する場合は，次のコマンドでユーザを追加できます。

csaftpuseradd -userinfofile <ユーザ情報指定ファイルのパス> -name <FTPアダプタのサービスID>

課金情報を設定したユーザを登録する場合の実行形式を次に示します。

csaftpuseradd -user <ユーザ名> -pass <ユーザのパスワード> -account <課金情報> -name <FTPアダプタのサービスID>

なお，ユーザ情報と課金情報の登録にユーザ情報指定ファイルを使用する場合は，次のコマンドでユーザを登録できます。

csaftpuseradd -userinfofile <ユーザ情報指定ファイルのパス> -name <FTPアダプタのサービスID>

(ii) ユーザを削除する場合の実行形式

csaftpuserdel -user <ユーザ名> -name <FTPアダプタのサービスID>

複数のユーザを削除する場合は，ユーザの数だけコマンドを実行してください。

(iii) ユーザのパスワードを変更する場合の実行形式

csaftpuseradd -user <ユーザ名> -pass <ユーザのパスワード> -r -name <FTPアダプタのサービスID>

複数のユーザのパスワードを変更する場合は，ユーザの数だけコマンドを実行してください。なお，ユーザ情報の変更にユーザ情報指定ファイルを使用する場合は，次のコマンドでパスワードを変更できます。

csaftpuseradd -userinfofile <ユーザ情報指定ファイルのパス> -r -name <FTPアダプタのサービスID>

課金情報が登録されているユーザに対してパスワードを変更するコマンドを実行すると，課金情報が削除されます。課金情報が登録されているユーザの場合は次の実行形式で変更します。

ユーザのパスワードを変更または課金情報を変更する場合の実行形式

csaftpuseradd -user <ユーザ名> -pass <ユーザのパスワード> -r -account <課金情報> -name <FTPアダプタのサービスID>

なお，課金情報の削除にユーザ情報指定ファイルを使用する場合は，次のコマンドで課金情報を削除できます。

csaftpuseradd -userinfofile <ユーザ情報指定ファイルのパス> -r -name <FTPアダプタのサービスID>

詳細は，マニュアル「サービスプラットフォーム リファレンス」の「csaftpuseradd（FTPアダプタのユーザの登録・更新）」または「csaftpuserdel（FTPアダプタのユーザの削除）」を参照してください。

5.4.15　ファイル操作アダプタの定義情報を変更する

運用中に次に示すファイル操作アダプタの定義情報を変更するときの前提条件，および開始方法について説明します。

ファイル操作アダプタ定義ファイルを変更する場合

ファイル操作アダプタ実行環境プロパティファイルを変更する場合

(1)　前提条件

ファイル操作アダプタの定義情報を変更するには，次の条件を満たしている必要があります。

HCSCサーバが起動状態であること

FTP受付が停止状態で，かつファイル操作アダプタが停止状態であること

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

(2)　変更方法

ファイル操作アダプタの定義情報の変更方法を説明します。

(a)　ファイル操作アダプタ定義ファイルを変更する場合

ファイル操作アダプタ定義ファイルは，次の手順で変更します。

定義を変更するファイル操作アダプタをアンデプロイします。

ファイル操作アダプタをアンデプロイする場合の実行形式を次に示します。

csccompoundeploy -cluster <クラスタ名> -user <ログインユーザID> -pass <ログインパスワード> -name <サービスID>

詳細は，マニュアル「サービスプラットフォーム リファレンス」の「csccompoundeploy（配備済みのHCSCコンポーネントの削除）」を参照してください。

ファイル操作アダプタ定義ファイルを変更します。

ファイル操作アダプタ定義ファイルを変更する場合の実行形式を次に示します。

csccmctl -cluster <クラスタ名> -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -name <サービスID> -operation set -targetfilename cscFileOperation.properties -basedir <cscFileOperation.propertiesが格納されたディレクトリのファイルパス>

詳細は，マニュアル「サービスプラットフォーム リファレンス」の「csccmctl（定義ファイルの管理）」を参照してください。

定義を変更したファイル操作アダプタをデプロイします。

ファイル操作アダプタ定義ファイルをデプロイする場合の実行形式を次に示します。

csccompodeploy -cluster <クラスタ名> -user <ログインユーザID> -pass <ログインパスワード> -name <サービスID>

詳細は，マニュアル「サービスプラットフォーム リファレンス」の「csccompodeploy（HCSCコンポーネントの配備）」を参照してください。

(b)　ファイル操作アダプタ実行環境プロパティファイルを変更する場合

ファイル操作アダプタ実行環境プロパティファイルの変更は，直接ファイルを編集します。

ファイル操作アダプタ実行環境プロパティファイルの格納先は次のとおりです。

<サービスプラットフォームのインストールディレクトリ>¥CSC¥config¥adpfop¥<サービスID>.properties

5.4.16　FTP受付の定義情報を変更する

運用中に次に示すFTP受付の定義情報を変更するときの前提条件，および開始方法について説明します。

FTP受付定義ファイル

FTP受付コンフィグファイル

FTP実行許可リストファイル，FTPコマンド許可リスト定義ファイル（FTP受付用），またはリストコマンドオプション定義ファイル

(1)　前提条件

FTP受付の定義情報を変更するには，次の条件を満たしている必要があります。

HCSCサーバが起動状態であること

FTP受付が停止状態であること

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

(2)　変更方法

FTP受付の定義情報の変更方法を説明します。

(a)　FTP受付定義ファイルを変更する場合

FTP受付定義ファイルは，次の手順で変更します。

定義ファイルを変更するFTP受付をアンデプロイします。

FTP受付をアンデプロイする場合の実行形式を次に示します。

csccompoundeploy -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -name <サービスID>

詳細は，マニュアル「サービスプラットフォーム リファレンス」の「csccompoundeploy（配備済みのHCSCコンポーネントの削除）」を参照してください。

FTP受付定義ファイルを変更します。

FTP受付定義ファイルを変更する場合の実行形式を次に示します。

csccmctl -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -name <サービスID> -operation set -targetfilename cscurecpftp.properties -basedir <cscurecpftp.propertiesが格納されたディレクトリのファイルパス>

詳細は，マニュアル「サービスプラットフォーム リファレンス」の「csccmctl（定義ファイルの管理）」を参照してください。

定義ファイルを変更したFTP受付をデプロイします。

FTP受付をデプロイする場合の実行形式を次に示します。

csccompodeploy -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -name <サービスID>

詳細は，マニュアル「サービスプラットフォーム リファレンス」の「csccompodeploy（HCSCコンポーネントの配備）」を参照してください。

(b)　FTP受付コンフィグファイルを変更する場合

FTP受付コンフィグファイルの変更は，直接ファイルを編集します。

FTP受付コンフィグファイルの格納先は次のとおりです。

<サービスプラットフォームのインストールディレクトリ>¥CSC¥config¥ftprecp¥<サービスID>.properties

(c)　FTP実行許可リストファイル，FTPコマンド許可リスト定義ファイル（FTP受付用），またはリストコマンドオプション定義ファイルを変更する場合

FTP実行許可リストファイル，FTPコマンド許可リスト定義ファイル（FTP受付用），およびリストコマンドオプション定義ファイルを変更するには，直接ファイルを編集します。

FTP実行許可リストファイル，FTPコマンド許可リスト定義ファイル（FTP受付用），およびリストコマンドオプション定義ファイルは，FTP受付コンフィグファイルで指定したパスに格納されています。

5.4.17　リポジトリを更新する

リポジトリを更新する方法については，「4.7　リポジトリを更新する」を参照してください。

5.4.18　転送履歴を取得する

転送履歴を取得するには，運用環境でcsmftplshistoryコマンドを実行します。csmftplshistoryコマンドは，管理者権限を持っているユーザだけが実行できます。

転送履歴を取得する場合の実行形式を次に示します。

csmftplshistory <J2EEサーバ名>

csmftplshistoryコマンドにはほかにもオプションを指定できます。詳細は，マニュアル「サービスプラットフォーム リファレンス」の「csmftplshistory（転送履歴の表示）」を参照してください。

なお，転送履歴は，転送履歴ログとしてファイルに出力されます。転送履歴ログファイルの格納先やログファイル名については，「7.7.11(1)(d)　転送履歴ログ（FTPインバウンドアダプタ）」を参照してください。

5.4.19　作業フォルダを参照する

作業フォルダのフォルダ一覧を参照するには，運用環境でcscfswlsコマンドを実行します。

作業フォルダを削除する前の状態を取得する場合と，作業フォルダを削除したあとの状態を取得する場合の実行形式を次に示します。

作業フォルダを削除する前の状態を取得する場合

cscfswls -user <ログインユーザID> -pass <ログインパスワード> -all -csc <HCSCサーバ名> <作業フォルダ削除前の一覧結果のファイルパス>

作業フォルダを削除したあとの状態を取得する場合

cscfswls -user <ログインユーザID> -pass <ログインパスワード> -all -csc <HCSCサーバ名> <作業フォルダ削除後の一覧結果のファイルパス>

詳細は，マニュアル「サービスプラットフォーム リファレンス」の「cscfswls（作業フォルダの参照）」を参照してください。

5.4.20　作業フォルダを削除する

作業フォルダを削除するときの前提条件，および削除方法について説明します。

(1)　前提条件

作業フォルダを削除するには，作業フォルダを管理する受付，およびその受付から呼び出されるビジネスプロセスが停止している必要があります。

(2)　削除方法

作業フォルダを削除するには，運用環境でcscfswrmコマンドを実行します。

作業フォルダを削除する場合の実行形式を次に示します。

cscfswrm -user <ログインユーザID> -pass <ログインパスワード> -d 0 -all -csc <HCSCサーバ名>

詳細は，マニュアル「サービスプラットフォーム リファレンス」の「cscfswrm（作業フォルダの削除）」を参照してください。

5.4.21　共通フォルダの情報を参照する

共通フォルダ内のファイル一覧を参照するには，運用環境でcscfsclsコマンドを実行します。

共通フォルダを削除する前の状態を取得する場合と，共通フォルダを削除したあとの状態を取得する場合の実行形式を次に示します。

(1)　共通フォルダを削除する前に取得する場合

cscfscls -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -folder <共通フォルダ定義名> -csc <HCSCサーバ名> <共通フォルダ内のファイル削除前の一覧結果のファイルパス>

(2)　共通フォルダを削除したあとに取得する場合

cscfscls -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -folder <共通フォルダ定義名> -csc <HCSCサーバ名> <共通フォルダ内のファイル削除後の一覧結果のファイルパス>

詳細は，マニュアル「サービスプラットフォーム リファレンス」の「cscfscls（共通フォルダの参照）」を参照してください。

5.4.22　共通フォルダ内のファイルを削除する

共通フォルダ内のファイルを削除するときの前提条件，および削除方法について説明します。

(1)　前提条件

ファイルを削除したあとに削除するファイルを参照するビジネスプロセスを実行した場合に失敗することがあります。

(2)　削除方法

共通フォルダ内のファイルを削除するには，運用環境でcscfscrmコマンドを実行します。

共通フォルダ内のファイルを削除する場合の実行形式を次に示します。

cscfscrm -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -folder <共通フォルダ定義名> -d 0 -csc <HCSCサーバ名>

詳細は，マニュアル「サービスプラットフォーム リファレンス」の「cscfscrm（共通フォルダの削除）」を参照してください。

5.4.23　FTP受付を停止する

FTP受付を停止するには，運用環境でcsccompostopコマンドを実行します。

FTP受付を停止する場合の実行形式を次に示します。

csccompostop -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -name <FTP受付の受付ID>

csccompostopコマンドの詳細は，マニュアル「サービスプラットフォーム リファレンス」の「csccompostop（HCSCコンポーネントの停止）」を参照してください。

5.4.24　標準受付を停止する

標準受付を停止する方法については，「5.3.35　標準受付を停止する」を参照してください。

5.4.25　HCSCコンポーネントを停止する

実行環境に配備済みの次のHCSCコンポーネントを停止するときの前提条件，および開始方法について説明します。

FTPアダプタ

ファイル操作アダプタ

ビジネスプロセス

(1)　前提条件

HCSCコンポーネントを停止するには，HCSCサーバが起動状態である必要があります。

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

(2)　停止方法

HCSCコンポーネントを停止するには，運用環境でcsccompostopコマンドを実行します。

HCSCコンポーネントを停止する場合の実行形式を次に示します。

csccompostop -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -all

詳細は，マニュアル「サービスプラットフォーム リファレンス」の「csccompostop（HCSCコンポーネントの停止）」を参照してください。

5.4.26　FTPインバウンドアダプタを停止する

FTPインバウンドアダプタを停止するときの前提条件，および停止方法について説明します。

(1)　前提条件

FTPインバウンドアダプタを停止するには，次の条件を満たす必要があります。

HCSCサーバが起動状態であること

HCSCサーバの状態の確認方法については，「5.3.16　HCSCサーバの情報を確認する」を参照してください。

FTPインバウンドアダプタが開始状態であること

FTPインバウンドアダプタの状態の確認方法については，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「4.5　リソースアダプタの一覧の参照」を参照してください。

(2)　停止方法

FTPインバウンドアダプタを停止する場合の実行形式を次に示します。

<サービスプラットフォームのインストールディレクトリ>¥CC¥admin¥bin¥cjstoprar <J2EEサーバ名称> -resname <リソースアダプタ表示名>

cjstoprarコマンドの詳細は，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「2.4　J2EEサーバで使用するリソース操作コマンド」を参照してください。

5.4.27　HCSCサーバを停止する

HCSCサーバの停止方法については，「5.3.41　HCSCサーバを停止する」を参照してください。

5.5　メール連携する場合に追加するオペレーション運用

メールアダプタを利用する場合に必要となる運用方法について説明します。

5.5.1　ユーザ情報の管理

ここでは，メールアダプタからメールサーバに接続するときの認証に必要なユーザ情報（ユーザ名およびパスワード）を管理する方法について説明しています。

ユーザ情報の管理には次の種類があります。

ユーザ情報の追加および更新

ユーザの削除

ユーザの表示

(1)　ユーザ情報を追加および更新する

運用環境でcsmmailaddusrコマンドを実行することで，ユーザ情報をメールアダプタアカウント定義ファイルに登録できます。また，csmmailaddusrコマンドで，すでに登録されているユーザのパスワードを変更することができます。

ユーザ情報を追加および更新する場合のコマンドの実行例を次に示します。

ユーザ情報を追加する場合

csmmailaddusr -user <ログインユーザ名> -pass <ユーザのログインパスワード> -f <メールアダプタアカウント定義ファイルのパス>

複数のユーザを追加する場合は，ユーザの数だけコマンドを実行してください。なお，ユーザ情報の登録にユーザ情報指定ファイルを使用する場合は，次のコマンドでユーザを追加できます。

csmmailaddusr -userinfofile <ユーザ情報指定ファイルのパス> -f <メールアダプタアカウント定義ファイルのパス>

ユーザのパスワードを変更する場合

csmmailaddusr -user <ログインユーザ名> -pass <変更後のユーザのログインパスワード> -r -f <メールアダプタアカウント定義ファイルのパス>

なお，パスワードの変更にがユーザ情報指定ファイルを使用する場合は，次のコマンドでパスワードを変更できます。

csmmailaddusr -userinfofile <ユーザ情報指定ファイルのパス> -r -f <メールアダプタアカウント定義ファイルのパス>

csmmailaddusrコマンドの詳細は，マニュアル「サービスプラットフォーム リファレンス」の「csmmailaddusr（メールアダプタユーザ情報の登録・更新）」を参照してください。

(2)　ユーザ情報を削除する

運用環境でcsmmaildelusrコマンドを実行することで，メールアダプタのユーザ情報をメールアダプタアカウント定義ファイルから削除できます。

ユーザ情報を削除する場合のコマンドの実行例を次に示します。

csmmaildelusr -user <ログインユーザ名> -f <メールアダプタアカウント定義ファイルのパス>

複数のユーザ情報を削除する場合は，ユーザの数だけコマンドを実行してください。

csmmaildelusrコマンドの詳細は，マニュアル「サービスプラットフォーム リファレンス」の「csmmaildelusr（メールアダプタユーザ情報の削除）」を参照してください。

(3)　ユーザ情報を表示する

運用環境でcsmmaillsusrコマンドを実行することで，メールアダプタアカウント定義ファイルに登録されたメールアダプタのユーザ情報を参照できます。

ユーザ情報を表示する場合のコマンドの実行例を次に示します。

csmmaillsusr -f <メールアダプタアカウント定義ファイルのパス>

csmmaillsusrコマンドの詳細は，マニュアル「サービスプラットフォーム リファレンス」の「csmmaillsusr（メールアダプタユーザ情報の表示）」を参照してください。

5.5.2　メールアダプタの開始と停止

メールアダプタを開始および停止する方法には次の2とおりがあります。

サービスプラットフォームの運用環境の画面を利用しての開始と停止

サービスプラットフォームのコマンドによる開始と停止

開始方法の詳細については「5.3.7　サービスアダプタを開始する」を参照してください。停止方法の詳細については「5.3.37　サービスアダプタを停止する」を参照してください。

5.5.3　メールアダプタのパフォーマンスチューニング

メールアダプタの運用中に，パフォーマンスチューニングのための設定が必要な場合，メールアダプタ実行環境プロパティファイルで各種設定を変更できます。

メールアダプタ実行環境プロパティファイルについては，マニュアル「サービスプラットフォーム リファレンス」の「6.13.3　メールアダプタ実行環境プロパティファイル」を参照してください。設定できる項目を次の表に示します。

表5‒6　　パフォーマンスチューニングのための設定項目

項目

キー名称

設定値の範囲

単位

メール本文のサイズ

mailadp.mail.body.size

1〜2,048,000

バイト

1つの添付ファイルの最大サイズ

mailadp.attach.file.size

0〜5,242,880

バイト

添付ファイルの数

mailadp.max.attach.count.per.mail

0〜100

個

メールアダプタの運用中にメールアダプタ実行環境プロパティファイルの設定を変更する手順を次に示します。

標準受付を停止します。

詳細は「5.3.35　標準受付を停止する」を参照してください。

ユーザ定義受付（SOAP受付，FTP受付などの標準受付以外の受付）を停止します。

詳細は「5.3.36　ユーザ定義受付を停止する」を参照してください。

メールアダプタを停止します。

メールアダプタの停止方法については，「5.5.2　メールアダプタの開始と停止」を参照してください。

メールアダプタ実行環境プロパティファイルをテキストエディタなどで開いて，設定値を変更します。

メールアダプタ実行環境プロパティファイルの格納先は，「<サービスプラットフォームのインストールディレクトリ>¥CSC¥config¥mail」です。

メールアダプタを開始します。

メールアダプタの開始方法については，「5.5.2　メールアダプタの開始と停止」を参照してください。

ユーザ定義受付（SOAP受付やFTP受付など，標準受付以外の受付）を開始します。

詳細は「5.3.9　ユーザ定義受付を開始する」を参照してください。

標準受付を開始します。

詳細は「5.3.10　標準受付を開始する」を参照してください。

5.6　JSON-XML変換機能を利用する場合のオペレーション運用

JSON-XML変換を実施するには，次の手順で設定する必要があります。

変換対象のHCSCコンポーネントの配備

定義情報の確認および設定

JSON-XML変換を実施できるHCSCコンポーネントは次のとおりです。

HTTP受付

Kafka受付

HTTPアダプタ

Kafkaアダプタ

以降に，これらの手順について説明します。

5.6.1　変換対象のHCSCコンポーネントの配備

変換対象のHCSCコンポーネントを実行環境に配備します。

HTTP受付またはKafka受付を実行環境に配備する場合の手順については，「3.1.14　ユーザ定義受付を配備する」を参照してください。

HTTPアダプタまたはKafkaアダプタを実行環境に配備する場合の手順については，「3.1.8　サービスアダプタを配備する」を参照してください。

5.6.2　定義情報の確認および設定

HCSCコンポーネントおよびJSON-XML変換の定義情報を運用環境へ設定するには，csccmctlコマンド（-operation setオプション）に定義ファイルを指定して実行します。

また，csccmctlコマンド（operation getオプション）で定義ファイルを取得して，定義情報の内容を確認することもできます。

csccmctlコマンドの実行方法については，マニュアル「サービスプラットフォーム リファレンス」の「csccmctl（定義ファイルの管理）」を参照してください。

定義ファイルの種類と説明個所を次に示します。

分類

定義ファイル

定義内容

説明個所

HTTP受付

HTTP受付定義ファイル

HTTP受付の動作を設定

マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「2.5.3　HTTP受付の定義ファイルを作成する」

Kafka受付

Kafka受付定義ファイル

Kafka受付の動作を設定

マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「2.8.3　Kafka受付の定義ファイルを作成する」

HTTPアダプタ

HTTPアダプタ定義ファイル

HTTPアダプタの動作を設定

マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「3.3.13　HTTPアダプタを定義する」のHTTPアダプタの定義ファイルの作成および編集に関する説明

Kafkaアダプタ

Kafkaアダプタ定義ファイル

Kafkaアダプタの動作を設定

マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「3.3.16　Kafkaアダプタを定義する」のKafkaアダプタの定義ファイルの作成および編集に関する説明

JSON-XML変換

JSON-XML変換定義ファイル

JSON-XML変換の動作を変更

マニュアル「サービスプラットフォーム リファレンス」の「3.18.1　JSON-XML変換定義ファイル」

5.7　クラスタ構成時の運用

クラスタ構成時の運用方法について，ロードバランスクラスタ構成の場合とHAクラスタ構成の場合とに分けて説明します。

5.7.1　ロードバランスクラスタ構成での運用

ロードバランスクラスタ構成での運用の開始および終了について説明します。また，運用中にロードバランスクラスタを構成するHCSCサーバを追加，変更，および削除する方法についても説明します。

(1)　運用の開始

環境構築とセットアップが終了したあと，ロードバランスクラスタ構成のシステムの運用を開始できます。運用を開始するには，次の作業を実施します。

実行環境の構成要素の状態の確認

ロードバランスクラスタ構成のシステムの運用を開始するには，すべてのロードバランスクラスタ内で，次に示す実行環境の構成要素が開始状態である必要があります。

運用管理エージェント

Management Server

PRF

スマートエージェント

CTM（CTMを使用する場合）※1

J2EEサーバ※2

HCSCサーバ※3

HTTP Server（HTTP Serverを使用する場合）

注※1

CTMドメインマネジャおよびCTMデーモンも開始状態である必要があります。

注※2

Reliable Messagingなどのアプリケーションの状態を一致させておく必要があります。なお，Reliable Messagingのシステム名は，ロードバランスクラスタ内のそれぞれのHCSCサーバでユニーク名称を指定する必要があります。

注※3

配備されているサービスアダプタとビジネスプロセス，および標準受付の状態を一致させておく必要があります。

サービスリクエスタへの送信制御

セットアップ時に，サービスリクエスタ用のネットワークを切断するなどして，サービス部品の実行要求を受け付けられない状態にしたサービスリクエスタを，ネットワークを接続するなどして，サービス部品の実行要求を受け付けられる状態にします。

(2)　運用の終了

ロードバランスクラスタ構成のシステムの運用を終了する場合，次の作業を実施します。

サービスリクエスタへの送信制御

サービスリクエスタ用のネットワークを切断するなどして，HCSCサーバでサービス部品の実行要求を受け付けられない状態にします。その際，現在処理中の実行要求がないことを確認してください。

実行環境の構成要素の停止

次の順序で，すべてのロードバランスクラスタ内の実行環境の構成要素を停止します。

HTTP Server（HTTP Serverを使用する場合）

HCSCサーバ

J2EEサーバ

CTM（CTMを使用する場合）

スマートエージェント

PRF

Management Server

運用管理エージェント

(3)　ロードバランスクラスタへのHCSCサーバの追加・削除

運用を停止しないで，ロードバランスクラスタを構成するHCSCサーバを追加および削除できます。汎用ロードバランサの場合は，動的にIPアドレスを追加および削除する機能があるときだけ，運用を停止しないで，HCSCサーバを追加および削除できます。ロードバランスクラスタを構成するHCSCサーバを追加および削除する方法を次に示します。

(a)　HCSCサーバの追加

追加するHCSCサーバの実行環境をセットアップします。

実行環境のセットアップ方法については，「2.5.2(2)　実行環境のセットアップ」を参照してください。

また，HCSCサーバ構成定義ファイルおよびHCSCサーバセットアップ定義ファイルを設定する場合，次の値をロードバランスクラスタ内のすべてのHCSCサーバで同じ設定にしてください。

HCSCサーバ構成定義ファイル

クラスタ表示名

クラスタ種別

呼び出し種別

HCSCサーバセットアップ定義ファイル

rm-systemnameプロパティおよびnaming-service-hostnameプロパティ以外のすべてのプロパティ

なお，rm-systemnameプロパティには，ロードバランスクラスタ内のそれぞれのHCSCサーバでユニークなReliable Messagingシステム名を指定してください。naming-service-hostnameプロパティには，それぞれのHCSCサーバをセットアップしたJ2EEサーバに設定されているネーミングサービスのホスト名称を指定してください。

HCSCサーバを起動します。

HCSCサーバの起動方法については，「5.3.4　HCSCサーバを起動する」を参照してください。

サービスアダプタを配備します。

サービスアダプタの配備方法については，「3.1.8　サービスアダプタを配備する」を参照してください。

ビジネスプロセスを配備します。

ビジネスプロセスの配備方法については，「3.1.13　ビジネスプロセスを配備する」を参照してください。

サービスアダプタを開始します。

サービスアダプタの開始方法については，「5.3.7　サービスアダプタを開始する」を参照してください。

ビジネスプロセスを開始します。

ビジネスプロセスの開始方法については，「5.3.8　ビジネスプロセスを開始する」を参照してください。

標準受付を開始します。

標準受付の開始方法については，「5.3.10　標準受付を開始する」を参照してください。

ロードバランサを設定します。

追加するHCSCサーバに，動的にサービス部品の実行要求を送信するように設定します。

CTMを使用する場合，すべてのHCSCサーバでCTMドメインマネジャ名およびスマートエージェントのポート番号を同じ値に設定する必要があります。

汎用ロードバランサの設定方法については，使用する汎用ロードバランサのドキュメントを参照してください。

注意事項

CTMを使用する場合，追加するHCSCサーバの標準受付を開始した段階で，HCSCサーバにサービス部品の実行要求を振り分けます。

(b)　HCSCサーバの削除

ロードバランサを設定します。

削除するHCSCサーバにサービス部品の実行要求を送信しないように設定します。その際，現在処理中の実行要求がすべて完了していることを確認してください。

CTMを使用する場合，対象となるJ2EEサーバにサービス部品の実行要求を送信するキューを閉塞します。CTMを使用する場合のキューの閉塞については，マニュアル「アプリケーションサーバ機能解説 拡張編」の「3.7.4　スケジュールキューの閉塞制御」を参照してください。

汎用ロードバランサの設定方法については，使用する汎用ロードバランサのドキュメントを参照してください。

標準受付を停止します。

標準受付の停止方法については，「5.3.35　標準受付を停止する」を参照してください。

ビジネスプロセスを停止します。

ビジネスプロセスの停止方法については，「5.3.38　ビジネスプロセスを停止する」を参照してください。

サービスアダプタを停止します。

サービスアダプタの停止方法については，「5.3.37　サービスアダプタを停止する」を参照してください。

ビジネスプロセスを削除します。

ビジネスプロセスの削除方法については，「3.3.2　ビジネスプロセスを削除する」を参照してください。

サービスアダプタを削除します。

サービスアダプタの削除方法については，「3.3.1　サービスアダプタを削除する」を参照してください。

削除するHCSCサーバを停止します。

HCSCサーバの停止方法については，「5.3.41　HCSCサーバを停止する」を参照してください。

HCSCサーバを削除します。

HCSCサーバの削除方法については，「3.3.6　HCSCサーバをアンセットアップする」を参照してください。

(4)　ロードバランスクラスタへのサービスアダプタの追加・削除

HCSCサーバに配備済みのサービスアダプタを停止しないで，新たなサービスアダプタを追加および削除できます。サービスアダプタを追加および削除する手順を次に示します。

(a)　サービスアダプタの追加

ロードバランスクラスタを構成するすべてのHCSCサーバに，追加するサービスアダプタを配備します。

サービスアダプタの配備方法については，「3.1.8　サービスアダプタを配備する」を参照してください。

追加したサービスアダプタを開始します。

サービスアダプタの開始方法については，「5.3.7　サービスアダプタを開始する」を参照してください。

追加したサービスアダプタを呼び出すように設定します。

注意事項

ロードバランスクラスタを構成するすべてのHCSCサーバに，サービスアダプタを配備し開始してから，追加したサービスアダプタを呼び出すように設定してください。

(b)　サービスアダプタの削除

削除するサービスアダプタを呼び出さないように設定します。

削除するサービスアダプタを停止します。

サービスアダプタの停止方法については，「5.3.37　サービスアダプタを停止する」を参照してください。

ロードバランスクラスタを構成するすべてのHCSCサーバからサービスアダプタを削除します。

サービスアダプタの削除方法については，「3.3.1　サービスアダプタを削除する」を参照してください。

注意事項

削除するサービスアダプタを呼び出さないように設定してから，サービスアダプタを削除してください。

(5)　ロードバランスクラスタへのビジネスプロセスの追加・削除

すでにHCSCサーバに配備済みのビジネスプロセスを停止しないで，新たなビジネスプロセスを追加および削除できます。ビジネスプロセスを追加および削除する手順を次に示します。

(a)　ビジネスプロセスの追加

ロードバランスクラスタを構成するすべてのHCSCサーバに，追加するビジネスプロセスを配備します。

ビジネスプロセスの配備方法については，「3.1.13　ビジネスプロセスを配備する」を参照してください。

追加したビジネスプロセスを開始します。

ビジネスプロセスの開始方法については，「5.3.8　ビジネスプロセスを開始する」を参照してください。

追加したビジネスプロセスを呼び出すように設定します。

注意事項

ロードバランスクラスタを構成するすべてのHCSCサーバに，ビジネスプロセスを配備し開始してから，追加したビジネスプロセスを呼び出すように設定してください。

(b)　ビジネスプロセスの削除

削除するビジネスプロセスを呼び出さないように設定します。

削除するビジネスプロセスを停止します。

ビジネスプロセスの停止方法については，「5.3.38　ビジネスプロセスを停止する」を参照してください。

ロードバランスクラスタを構成するすべてのHCSCサーバからビジネスプロセスを削除します。

ビジネスプロセスの削除方法については，「3.3.2　ビジネスプロセスを削除する」を参照してください。

注意事項

削除するビジネスプロセスを呼び出さないように設定してから，ビジネスプロセスを削除してください。

(6)　ロードバランスクラスタ構成でのサービスアダプタの変更

HCSCサーバに配備済みのサービスアダプタを停止しないで，サービスアダプタを変更できます。サービスアダプタを変更する手順を次に示します。

変更するサービスアダプタを呼び出さないように設定します。

変更するサービスアダプタを停止します。

サービスアダプタの停止方法については，「5.3.37　サービスアダプタを停止する」を参照してください。

ロードバランスクラスタを構成するすべてのHCSCサーバから変更するサービスアダプタを削除します。

サービスアダプタの削除方法については，「3.3.1　サービスアダプタを削除する」を参照してください。

変更したサービスアダプタの情報が保存されたリポジトリをインポートします。

インポートの方法については，「4.3　リポジトリのインポート」を参照してください。

ロードバランスクラスタを構成するすべてのHCSCサーバに，変更したサービスアダプタを配備します。

サービスアダプタの配備方法については，「3.1.8　サービスアダプタを配備する」を参照してください。

変更したサービスアダプタを開始します。

サービスアダプタの開始方法については，「5.3.7　サービスアダプタを開始する」を参照してください。

変更したサービスアダプタを呼び出すように設定します。

注意事項

変更するサービスアダプタを呼び出さないように設定してから，サービスアダプタを変更してください。

(7)　ロードバランスクラスタ構成でのビジネスプロセスの変更

すでにHCSCサーバに配備済みのビジネスプロセスを停止しないで，ビジネスプロセスを変更できます。ビジネスプロセスを変更する方法を次に示します。

変更するビジネスプロセスを呼び出さないように設定します。

変更するビジネスプロセスを停止します。

ビジネスプロセスの停止方法については，「5.3.38　ビジネスプロセスを停止する」を参照してください。

ロードバランスクラスタを構成するすべてのHCSCサーバから変更するビジネスプロセスを削除します。

ビジネスプロセスの削除方法については，「3.3.2　ビジネスプロセスを削除する」を参照してください。

変更したビジネスプロセスの情報が保存されたリポジトリをインポートします。

リポジトリのインポート方法については，「4.3　リポジトリのインポート」を参照してください。

ロードバランスクラスタを構成するすべてのHCSCサーバにビジネスプロセスを配備します。

ビジネスプロセスの配備方法については，「3.1.13　ビジネスプロセスを配備する」を参照してください。

変更したビジネスプロセスを開始します。

ビジネスプロセスの開始方法については，「5.3.8　ビジネスプロセスを開始する」を参照してください。

変更したビジネスプロセスを呼び出すように設定します。

注意事項

変更するビジネスプロセスを呼び出さないように設定してから，ビジネスプロセスを変更してください。

(8)　障害に備えたHCSCサーバの準備

ロードバランスクラスタを構成しているHCSCサーバの障害に備え，ロードバランスクラスタに余裕をもった台数のHCSCサーバを準備することを推奨します。詳細については，「7.9.2(1)　ロードバランスクラスタ構成での障害と復旧」を参照してください。

5.7.2　HAクラスタ構成での運用

HAクラスタ構成での運用の開始と，運用中に実行系で障害が発生した場合の系の切り替え，および復旧の方法について説明します。

環境構築とセットアップが終了したあと，HAクラスタ構成のシステムの運用を開始できます。運用を開始するには次の手順を実施してください。

実行系・待機系の構成要素の状態の確認

HAクラスタ構成のシステムの運用を開始するには，実行系・待機系の構成要素が次の表に示す状態である必要があります。

表5‒7　HAクラスタ構成の運用時の構成要素の状態

構成要素

状態

実行系

待機系

運用管理エージェント

○

−

Management Server

○

−

PRF

○

−

J2EEサーバ

○

−

HCSCサーバ

○

−

HTTP Server

○

−

（凡例）

○：起動しています。

−：停止しています。

サービスリクエスタ用のネットワークの接続

セットアップ時に切断したサービスリクエスタ用のネットワークを接続します。

サービスリクエスタ用のネットワークを接続すると，実行系のHCSCサーバでサービス部品の実行要求が受け付けられる状態になります。

サービスリクエスタへの送信制御

セットアップ時にサービス部品の実行要求を受け付けられない状態にしたサービスリクエスタを，ネットワークを接続するなどして，サービス部品の実行要求を受け付けられる状態にします。

5.7.3　N対1クラスタ構成での運用

N対1クラスタ構成での運用の開始および終了について説明します。また，運用中にN対1クラスタを構成するHCSCサーバを追加，変更，および削除する方法についても説明します。

(1)　運用の開始

環境構築とセットアップが終了したあと，N対1クラスタ構成のシステムの運用を開始できます。運用を開始するには，次の作業を実施します。

実行系・待機系の構成要素の状態の確認

N対1クラスタ構成のすべてのロードバランスクラスタ内で，HAクラスタ相当の実行系・待機系の構成要素が次の表に示す状態である必要があります。

表5‒8　HAクラスタ相当の構成要素の状態

構成要素

状態

実行系

待機系

運用管理エージェント

○

−

Management Server

○

−

PRF

○

−

スマートエージェント

○

−

CTM（CTMを使用する場合）

○※1

−

J2EEサーバ

○※2

−

HCSCサーバ

○※3

−

HTTP Server

○

−

（凡例）

○：起動しています。

−：停止しています。

注※1

CTMドメインマネジャおよびCTMデーモンも開始状態である必要があります。

注※2

Reliable Messagingなどのアプリケーションの状態を一致させておく必要があります。なお，Reliable Messagingのシステム名は，ロードバランスクラスタ相当のそれぞれのHCSCサーバでユニークな名称を指定する必要があります。

注※3

配備されているサービスアダプタとビジネスプロセス，および標準受付の状態を一致させておく必要があります。

サービスリクエスタへの送信制御

セットアップ時に，サービス部品の実行要求を受け付けられない状態にしたサービスリクエスタを，ネットワークを接続するなどして，サービス部品の実行要求を受け付けられる状態にします。

(2)　運用の終了

N対1クラスタ構成のシステムの運用を終了する方法は，ロードバランスクラスタ構成の場合と同様です。ロードバランスクラスタ構成の運用の終了方法については，「5.7.1(2)　運用の終了」を参照してください。

(3)　N対1クラスタへのHCSCサーバの追加・削除

運用を停止しないで，N対1クラスタを構成するHCSCサーバを追加および削除できます。ロードバランスクラスタ構成で使用するロードバランサが汎用ロードバランサの場合，動的にIPアドレスを追加および削除する機能があるときだけ，運用を停止しないでHCSCサーバを追加および削除できます。

N対1クラスタを構成するHCSCサーバを追加および削除する方法を次に示します。

(a)　HCSCサーバの追加

N対1クラスタ構成で追加するHCSCサーバの実行環境をセットアップします。

ロードバランスクラスタ相当の実行環境のセットアップ方法については，「2.5.2(2)　実行環境のセットアップ」を参照してください。

HAクラスタ相当の実行環境のセットアップ方法については，「2.6.2(2)　実行環境（待機系）のセットアップ」および「2.6.2(3)　実行環境（実行系）のセットアップ」を参照してください。

HCSCサーバを起動します。

HCSCサーバの起動方法については，「5.3.4　HCSCサーバを起動する」を参照してください。

サービスアダプタを配備します。

サービスアダプタの配備方法については，「3.1.8　サービスアダプタを配備する」を参照してください。

ビジネスプロセスを配備します。

ビジネスプロセスの配備方法については，「3.1.13　ビジネスプロセスを配備する」を参照してください。

サービスアダプタを開始します。

サービスアダプタの開始方法については，「5.3.7　サービスアダプタを開始する」を参照してください。

ビジネスプロセスを開始します。

ビジネスプロセスの開始方法については，「5.3.8　ビジネスプロセスを開始する」を参照してください。

標準受付を開始します。

標準受付の開始方法については，「5.3.10　標準受付を開始する」を参照してください。

ロードバランサを設定します。

追加するHCSCサーバに，動的にサービス部品の実行要求を送信するように設定します。

CTMを使用する場合，すべてのHCSCサーバでCTMドメインマネジャ名およびスマートエージェントのポート番号を同じ値に設定する必要があります。

汎用ロードバランサの設定方法については，使用する汎用ロードバランサのドキュメントを参照してください。

注意事項

CTMを使用する場合，追加するHCSCサーバの標準受付を開始した段階で，HCSCサーバにサービス部品の実行要求を振り分けます。

(b)　HCSCサーバの削除

ロードバランサを設定します。

削除するHCSCサーバにサービス部品の実行要求を送信しないように設定します。その際，現在処理中の実行要求がすべて完了していることを確認してください。

CTMを使用する場合，対象となるJ2EEサーバにサービス部品の実行要求を送信するキューを閉塞します。CTMを使用する場合のキューの閉塞については，マニュアル「アプリケーションサーバ機能解説 拡張編」の「3.7.4　スケジュールキューの閉塞制御」を参照してください。

汎用ロードバランサの設定方法については，使用する汎用ロードバランサのドキュメントを参照してください。

標準受付を停止します。

標準受付の停止方法については，「5.3.35　標準受付を停止する」を参照してください。

ビジネスプロセスを停止します。

ビジネスプロセスの停止方法については，「5.3.38　ビジネスプロセスを停止する」を参照してください。

サービスアダプタを停止します。

サービスアダプタの停止方法については，「5.3.37　サービスアダプタを停止する」を参照してください。

ビジネスプロセスを削除します。

ビジネスプロセスの削除方法については，「3.3.2　ビジネスプロセスを削除する」を参照してください。

サービスアダプタを削除します。

サービスアダプタの削除方法については，「3.3.1　サービスアダプタを削除する」を参照してください。

削除するHCSCサーバを停止します。

HCSCサーバの停止方法については，「5.3.41　HCSCサーバを停止する」を参照してください。

HCSCサーバを削除します。

HCSCサーバの削除方法については，「3.3.6　HCSCサーバをアンセットアップする」を参照してください。

(4)　HCSCサーバへのサービスアダプタおよびビジネスプロセスの追加・削除・変更

N対1クラスタを構成するHCSCサーバへのサービスアダプタおよびビジネスプロセスの追加，削除，および変更方法について説明します。

なお，クラスタを構成するすべてのHCSCサーバに対してサービスアダプタおよびビジネスプロセスを追加，削除，または変更する場合，HAクラスタ構成の組ごとに順番に実施してください。

(a)　サービスアダプタの追加・削除

すでにHCSCサーバに配備済みのサービスアダプタを停止しないで，新たなサービスアダプタを追加および削除する方法については，「5.7.1(4)　ロードバランスクラスタへのサービスアダプタの追加・削除」を参照してください。

(b)　ビジネスプロセスの追加・削除

すでにHCSCサーバに配備済みのビジネスプロセスを停止しないで，新たなビジネスプロセスを追加および削除する方法については，「5.7.1(5)　ロードバランスクラスタへのビジネスプロセスの追加・削除」を参照してください。

(c)　サービスアダプタの変更

すでにHCSCサーバに配備済みのサービスアダプタを停止しないで，サービスアダプタを変更する方法については，「5.7.1(6)　ロードバランスクラスタ構成でのサービスアダプタの変更」を参照してください。

(d)　ビジネスプロセスの変更

すでにHCSCサーバに配備済みのビジネスプロセスを停止しないで，ビジネスプロセスを変更する方法については，「5.7.1(7)　ロードバランスクラスタ構成でのビジネスプロセスの変更」を参照してください。

(5)　障害に備えたHCSCサーバの準備

ロードバランスクラスタを構成しているHCSCサーバの障害に備え，ロードバランスクラスタに余裕を持った台数のHCSCサーバを準備することを推奨します。詳細については，「7.9.2(1)　ロードバランスクラスタ構成での障害と復旧」を参照してください。

5.7.4　クラスタ構成時の注意事項

HAクラスタ構成およびN対1クラスタ構成での運用中は，サービスアダプタおよびビジネスプロセスを起動または停止する場合や，標準受付を停止する場合，次の点に注意してください。

サービスアダプタおよびビジネスプロセスを起動・停止する場合

サービスアダプタおよびビジネスプロセスの起動・停止は次の手順で実施してください。

サービスリクエスタ用のネットワークを切断するなどして，実行系と待機系でサービス部品の実行要求を受け付けられない状態にしてください。

実行系と待機系の両方で，同じサービスアダプタおよびビジネスプロセスの起動または停止をしてください。

なお，HAクラスタ構成で系の切り替えが発生した場合，サービスアダプタおよびビジネスプロセスの状態は引き継がれません。そのため，稼働中の実行系で，あるサービスアダプタを停止し，その状態で系の切り替えが発生すると，実行系と待機系でサービスアダプタおよびビジネスプロセスの状態が不整合になります。

標準受付を停止する場合

サービスリクエスタ用のネットワークから切断するなどして，標準受付の状態に関係なく実行要求を受け付けられない状態にしてから，標準受付を停止してください。

なお，HAクラスタ構成で系の切り替えが発生した場合，待機系では標準受付が起動されます。そのため，実行要求を一時的に受け付けないようにするために稼働中の実行系で標準受付を停止し，その状態で系の切り替えが発生すると，待機系で実行要求を受け付けてしまう場合があります。

また，HAクラスタ構成およびN対1クラスタ構成での運用中に，サービスプラットフォームの運用画面を起動したままHAクラスタに切り替えた場合，運用画面上に表示されている各種ステータスを正しく反映できません。

ロードバランスクラスタ構成およびN対1クラスタ構成での運用中に別HCSCサーバからビジネスプロセスを再実行する場合や，HAクラスタ構成で待機系への系切り替え処理後にビジネスプロセスを再実行する場合，各情報は次の場所へ格納してください。

情報の種類

情報の格納先

作業フォルダ

共有ディスク装置

共通フォルダ

ファイルアダプタで使用する入出力許可ファイル

メールアダプタで利用するメール本文のテキストファイル，および添付ファイル

ローカルディスク装置※

HCSCサーバの運用で利用する定義ファイル

HCSCコンポーネントで利用する定義ファイル

注※

ロードバランスクラスタ構成およびN対1クラスタ構成の場合は各HCSCサーバで，HAクラスタ構成の場合は実行系と待機系で，同じ値を設定してください。

5.8　環境構築後のIPアドレスまたはホスト名を変更する場合の運用

環境構築後のデータベース，運用環境，およびコンポーネントのIPアドレスまたはホスト名を変更する場合の運用手順について説明します。

5.8.1　データベース稼働マシンのIPアドレスまたはホスト名を変更する場合

データベース稼働マシンのIPアドレスまたはホスト名を変更する場合，データベースの種類に応じて(1)または(2)の作業を実施してください。

(1)　HCSCサーバがセットアップされた状態で，HCSCサーバが使用するデータベース稼働マシンのIPアドレスまたはホスト名を変更する場合

HCSCサーバが利用するデータベース稼働マシンのIPアドレスまたはホスト名を変更する場合は，次に示す定義ファイルの定義項目を確認してください。HCSCサーバセットアップ定義ファイルのプロパティの定義方法については，マニュアル「サービスプラットフォームリファレンス」の「6.4.3　HCSCサーバセットアップ定義ファイル」を参照してください。

表5‒9　IPアドレスまたはホスト名の変更時に確認する定義項目

定義ファイル名

定義項目

HCSCサーバセットアップ定義ファイル

Oracleの場合

jdbc-url

Oracle以外の場合

jdbc-dbhostname

DB Connectorの定義ファイル

HiRDBの場合

DBHostName

HiRDB以外の場合

serverName

定義項目に定義された内容によって，IPアドレスまたはホスト名の変更方法は次のように異なります。

表5‒10　IPアドレスまたはホスト名の変更方法

定義項目の定義内容

変更方法

IPアドレスの変更

ホスト名の変更

localhost

マシンのIPアドレス・ホスト名のどちらを変更する場合も，定義ファイルの設定内容の変更は不要です。

ホスト名

ホスト名を変更しないでマシンのIPアドレスを変更する場合，定義ファイルの設定内容の変更は不要です。運用管理エージェント，Management Server，HCSCサーバを再起動することで，変更できます。

マシンのホスト名は変更できません。ホスト名を変更する場合は，HCSCサーバを再セットアップしてください。

IPアドレス

マシンのIPアドレスは変更できません。IPアドレスを変更する場合は，HCSCサーバを再セットアップしてください。

−

（凡例）

−：該当しません。

次の図に，IPアドレスまたはホスト名を変更する場合の例を示します。

図5‒5　HCSCサーバが使用するデータベース稼働マシンのIPアドレスまたはホスト名の変更（HCSCサーバのセットアップ時）

(2)　DBアダプタが接続するデータベースのIPアドレスまたはホスト名を変更する場合

DBアダプタが接続するデータベースのIPアドレスまたはホスト名を変更する場合は，次に示す定義ファイルの定義項目を確認してください。

表5‒11　IPアドレスまたはホスト名の変更時に確認する定義項目

定義ファイル名

定義項目

DB Connectorの定義ファイル

HiRDBの場合

DBHostName

HiRDB以外の場合

serverName

定義項目に定義された内容によって，IPアドレスまたはホスト名の変更方法は次のように異なります。

表5‒12　IPアドレスまたはホスト名の変更方法

定義項目の定義内容

変更方法

IPアドレスの変更

ホスト名の変更

localhost

マシンのIPアドレス・ホスト名のどちらを変更する場合も，定義ファイルの設定内容の変更は不要です。

ホスト名

マシンのIPアドレス・ホスト名のどちらを変更する場合も，次の手順で変更できます。

定義ファイルの定義内容（IPアドレスまたはホスト名）を変更する

定義ファイルをcjsetrarpropコマンドでDB Connectorへ反映する

HCSCサーバを再起動する

IPアドレス

マシンのIPアドレスを変更する場合，次の手順を実施する必要があります。

定義ファイルの定義内容（IPアドレス）を変更する

定義ファイルをcjsetrarpropコマンドでDB Connectorへ反映する

HCSCサーバを再起動する

−

（凡例）

−：該当しません。

次の図に，IPアドレスまたはホスト名を変更する場合の例を示します。

図5‒6　DBアダプタが接続するデータベースのIPアドレスまたはホスト名の変更

5.8.2　標準受付（同期受付（Webサービス））および標準受付（非同期受付（MDB（WS-R））のWebサーバのIPアドレスまたはホスト名を変更する場合）

標準受付（同期受付（Webサービス））および標準受付（非同期受付（MDB（WS-R））のWebサーバのIPアドレスまたはホスト名を変更する場合は，次に示す定義ファイルの定義項目を確認してください。HCSCサーバ構成定義ファイルのプロパティの定義方法については，マニュアル「サービスプラットフォームリファレンス」の「6.4.2　HCSCサーバ構成定義ファイル」を参照してください。

表5‒13　IPアドレスまたはホスト名の変更時に確認する定義項目

定義ファイル名

定義項目

HCSCサーバ構成定義ファイル

WebサーバのIPアドレスまたはホスト名

定義項目に定義された内容によって，IPアドレスまたはホスト名の変更方法は次のように異なります。

表5‒14　IPアドレスまたはホスト名の変更方法

定義項目の定義内容

変更方法

IPアドレスの変更

ホスト名の変更

localhost

マシンのIPアドレス・ホスト名のどちらを変更する場合も，定義ファイルの設定内容の変更は不要です。

ホスト名

マシンのIPアドレスを変更する場合，hostsファイルまたはDNSを変更したあと，全プロセスを再起動することで変更できます。

マシンのホスト名を変更する場合，HCSCサーバ構成定義ファイルの定義内容を変更し，cscsvsetupコマンド（HCSCサーバのセットアップ）を再度実行※してください。

IPアドレス

マシンのIPアドレスを変更する場合，HCSCサーバ構成定義ファイルの定義内容を変更し，cscsvsetupコマンド（HCSCサーバのセットアップ）を再度実行※してください。

−

（凡例）

−：該当しません。

注※

cscsvsetupコマンド（HCSCサーバのセットアップ）は，HCSCサーバ，サービスアダプタ，ビジネスプロセス，およびユーザ定義受付がすべて停止した状態で実行してください。

注意事項

IPアドレスまたはホスト名を変更したあと，運用環境からリポジトリをエクスポートして開発環境にインポートすると，開発環境の画面は次の表示内容が変更されます。

サービスアダプタ定義画面

サービス部品制御情報のアドレスに表示されるIPアドレスまたはホスト名

HCSCコンポーネント情報表示画面

ホスト名またはIPアドレスと，［WSDL取得］ボタンをクリックした際に出力されるWSDLのエンドポイントURLのホスト名またはIPアドレス部分

次の図に，標準受付（同期受付（Webサービス））および標準受付（非同期受付（MDB（WS-R））のWebサーバのIPアドレスまたはホスト名を変更する場合の例を示します。

図5‒7　標準受付（同期受付（Webサービス））および標準受付（非同期受付（MDB（WS-R））のWebサーバのIPアドレスまたはホスト名の変更

5.9　運用コマンド実行時にFullGCを抑止する運用

次に示す運用環境のコマンドでは，-nogcオプションを指定して実行すると，内部的に実行されるFullGCを抑止できます。

csccompoundeployコマンド

csccompostartコマンド

csccompostopコマンド

cscrcptnstartコマンド

cscrcptnstopコマンド

FullGCの抑止方法について，オンラインの停止中とオンライン中とに分けて次に説明します。

5.9.1　オンラインを停止してHCSCコンポーネントを入れ替える場合

各種停止コマンドおよびビジネスプロセス・サービスアダプタの開始コマンドを実行する場合は，FullGCの発生を抑止することをお勧めします。

オンラインを停止してHCSCコンポーネントを入れ替える場合，次の手順例のように各運用コマンドで-nogcオプションを指定すると，FullGCの発生回数を抑止できます。

受付停止

cscrcptnstop -csc <HCSCサーバ名> -nogc

ビジネスプロセス・サービスアダプタの停止

csccompostop -csc <HCSCサーバ名> -name <サービスID> -nogc

ビジネスプロセス・サービスアダプタの削除

csccompoundeploy -csc <HCSCサーバ名> -name <サービスID> -nogc

リポジトリインポート

cscrepctl -import <リポジトリZIP>

ビジネスプロセス・サービスアダプタの配備

csccompodeploy -csc <HCSCサーバ名> -all

ビジネスプロセス・サービスアダプタの開始

csccompostart -csc <HCSCサーバ名> -all -nogc

受付開始

cscrcptnstart -csc <HCSCサーバ名> -nogc

このコマンドで-nogcオプションを指定しなかった場合，次の時点でそれぞれ1回ずつFullGCが発生します。これ以外の場合はFullGCは発生しません。

HCSCサーバセットアップ直後の標準受付開始時

csccompodeployコマンド実行直後のユーザ受付開始時

FullGCの明示的発行（任意）

javagc -p <J2EEサーバのプロセスID>

この操作で示すオンライン開始前のFullGCの発行は必須ではありませんが，FullGCを明示的に発行したい場合はjavagcコマンドを利用してください。javagcコマンドの詳細については，マニュアル「アプリケーションサーバリファレンス コマンド編」の「10.　JavaVMで使用するコマンド」を参照してください。

この例では手順1.〜3.，手順6.〜7.でFullGCの発生を抑止しているため，手順全体ではFullGCの発生は手順8.の1回だけです。

5.9.2　オンライン中にHCSCコンポーネントを入れ替える場合

FullGCの発生中は業務が停止するため，FullGCの発生を抑止することを推奨します。

オンライン中にHCSCコンポーネントを入れ替える場合，次の手順例のように各運用コマンドで-nogcオプションを指定すると，FullGCの発生回数を抑止できます。

ビジネスプロセス・サービスアダプタの停止

csccompostop -csc <HCSCサーバ名> -name <サービスID> -nogc

ビジネスプロセス・サービスアダプタの削除

csccompoundeploy -csc <HCSCサーバ名> -name <サービスID> -nogc

リポジトリインポート

cscrepctl -import <リポジトリZIP> -compo

ビジネスプロセス・サービスアダプタの配備

csccompodeploy -csc <HCSCサーバ名> -name <サービスID>

ビジネスプロセス・サービスアダプタの開始

csccompostart -csc <HCSCサーバ名> -name <サービスID> -nogc

この例では手順1.〜2.，手順5.でFullGCの発生を抑止しているため，手順全体ではFullGCは一度も発生しません。

5.10　独自定義ファイルの運用

独自定義ファイルとは，HCSCコンポーネントが独自に定義する，環境非依存でポータブルな定義をするファイルの総称です。

この節では，独自定義ファイルの種類と設定方法について説明します。

5.10.1　独自定義ファイルの種類

HCSCコンポーネントの独自定義ファイルの種類を次の表に示します。列「独自定義ファイル設定機能を使用する場合」に記載されている実行環境の独自定義ファイル設定機能については，「5.10.3　実行環境の独自定義ファイル設定機能を使用した独自定義ファイルの定義手順」を参照してください。

表5‒15　独自定義ファイルの種類

分類

ファイルの種類

独自定義ファイル設定機能を使用する場合

ファイル名

読み込み時期※

ユーザ定義受付

SOAP受付

SOAP受付定義ファイル

cscurecpsoap.properties

受付の起動時

TP1/RPC受付

TP1/RPC受付定義ファイル

cscurecptp1rpc.properties

デプロイ時と受付の起動時

FTP受付

FTP受付定義ファイル

cscurecpftp.properties

デプロイ時と受付の起動時

HTTP受付

HTTP受付定義ファイル

cscurecphttp.properties

デプロイ時と受付の起動時

HTTP受付サービス選択定義ファイル

cscurecphttp_selection.properties

受付の起動時

HTTPレスポンスヘッダ定義ファイル

HTTP受付定義ファイルのhttprecp.response.header.filenameに指定したファイル名

受付の起動時

JSON-XML変換定義ファイル

csc_json_converter.properties

受付の起動時

HTTP受付ルーティング定義ファイル

cscurecphttp_routing.xml

受付の起動時

Message Queue受付

Message Queue受付定義ファイル

cscurecpmq.properties

デプロイ時

ファイルイベント受付

ファイルイベント受付定義ファイル

cscurecpfileevent.properties

デプロイ時と受付の起動時

Kafka受付

Kafka受付定義ファイル

cscurecpkafka.properties

デプロイ時と受付の起動時

JSON-XML変換定義ファイル

csc_json_converter.properties

受付の起動時

gRPC受付

gRPC受付定義ファイル

cscurecpgrpc.properties

デプロイ時と受付の起動時

スケジュール駆動受付

スケジュール駆動受付定義ファイル

cscurecpschedule.properties

デプロイ時と受付の起動時

カスタム受付

カスタム受付ユーザファイル

ユーザ任意のファイル名

受付の起動時

サービスアダプタ

SOAPアダプタ

クライアント定義ファイル

使用できません。

−

DBアダプタ

アプリケーション統合属性ファイル

cscadapter_property.xml

デプロイ時

SQLオペレーション定義ファイル

csa_sql_<任意の名称>.xml

アダプタの起動時

TP1アダプタ

TP1アダプタ環境定義ファイル

customadapter_properties.xml

TP1アダプタ通信構成定義ファイル

TP1アダプタ環境定義ファイルの<entry key="adptp1_deffile">要素に指定したTP1アダプタの通信構成定義ファイル名

Object Accessアダプタ

TPBroker環境定義ファイル

adpoa_tpb.properties

Object Accessアダプタ通信構成定義ファイル

adpoa_com.xml

Message Queueアダプタ

Message Queueアダプタ環境定義ファイル

customadapter_properties.xml

Message Queueアダプタ通信構成定義ファイル

Message Queueアダプタ環境定義ファイルの<entry key="adpmq_deffile">要素に指定したファイル名

アプリケーション統合属性ファイル

cscadapter_property.xml

ファイル操作アダプタ

ファイル操作アダプタ定義ファイル

cscFileOperation.properties

文字コード変換UOC用独自定義ファイル

csc_owncodeconvert_in.properties

csc_owncodeconvert_out.properties

−

ファイル操作アダプタ定義ファイルの次に示すプロパティで指定したファイル名

csc.adapter.fileOperation.transform.all.inFormat

csc.adapter.fileOperation.transform.all.outFormat

csc.adapter.fileOperation.transform.all.styleSheet

csc.adapter.fileOperation.transform.data.inFormat

csc.adapter.fileOperation.transform.data.outFormat

csc.adapter.fileOperation.transform.data.styleSheet

csc.adapter.fileOperation.transform.header.inFormat

csc.adapter.fileOperation.transform.header.outFormat

csc.adapter.fileOperation.transform.header.styleSheet

csc.adapter.fileOperation.transform.trailer.inFormat

csc.adapter.fileOperation.transform.trailer.outFormat

csc.adapter.fileOperation.transform.trailer.styleSheet

csc.adapter.fileOperation.transform.outputTemplateXmlFile

HTTPアダプタ

HTTPアダプタ定義ファイル

cscadphttp.properties

JSON-XML変換定義ファイル

csc_json_converter.properties

Kafkaアダプタ

Kafkaアダプタ定義ファイル

adpkafka.properties

JSON-XML変換定義ファイル

csc_json_converter.properties

gRPCアダプタ

gRPCアダプタ独自定義ファイル

cscadpgrpc.properties

汎用カスタムアダプタ

プロトコルコンバータ用独自定義ファイル

ユーザ任意のファイル名

カスタムアダプタ開発フレームワーク動作定義ファイル

framework_properties.xml

カスタムアダプタプロパティファイル

customadapter_properties.xml

カスタムアダプタ用アプリケーション統合属性ファイル

cscadapter_property.xml

カスタムアダプタ定義ファイル

使用できません。

−

ユーザ定義受付/サービスアダプタ共通

文字コード変換UOC用独自定義ファイル

csc_owncodeconvert.properties

受付またはアダプタの起動時

（凡例）

−：該当なし

注※

独自定義ファイルの読み込みに失敗した場合は，原因に応じて次のように実行されます。

所定のディレクトリ下に独自定義ファイルが配置されていない場合

ほかの方法で定義した独自定義ファイルが使用されます。独自定義ファイルは次の優先順で使用されます。

csccmctlコマンド（-operation setオプション指定）で運用環境に設定した独自定義ファイル

開発環境の画面で定義した独自定義ファイル（アーカイブファイル（EAR/JAR）内の独自定義ファイル）

独自定義ファイルの存在確認中にエラーが発生した場合（独自定義ファイルのディレクトリにアクセス権がないなど）

ほかの方法で定義した独自定義ファイルが使用されます。独自定義ファイルは次の優先順で使用されます。

csccmctlコマンド（-operation setオプション指定）で運用環境に設定した独自定義ファイル

開発環境の画面で定義した独自定義ファイル（アーカイブファイル（EAR/JAR）内の独自定義ファイル）

また，KDEC05215-W（SQLオペレーション定義ファイルの場合はKDEC60006-W）が出力されます。

独自定義ファイルの読み込み時にエラーが発生した場合（独自定義ファイルにアクセス権がないなど）

KDEC05214-E（SQLオペレーション定義ファイルの場合はKDEC60005-E）が出力され，処理を終了します。

デプロイ時のエラーメッセージは統合メッセージログに出力されます。ユーザ定義受付またはサービスアダプタの起動時のエラーメッセージはメッセージログに出力されます。

5.10.2　独自定義ファイルの設定方法

独自定義ファイルの設定方法の種類と，それぞれの変更・削除方法を次の表に示します。複数の設定方法で同類の独自定義ファイルが設定された場合は，列「優先度」がより高い設定方法のファイルが優先されます。

優先度

設定方法

設定方法の詳細

変更・削除方法

高

実行環境の独自定義ファイル設定機能で設定

所定のディレクトリに独自定義ファイルを配置します。配置したファイルは，デプロイ時または起動時に読み込まれます。

設定方法については，「5.10.3　実行環境の独自定義ファイル設定機能を使用した独自定義ファイルの定義手順」を参照してください。

所定のディレクトリの独自定義ファイルを変更・削除することで反映されます。※

低

開発環境の画面で設定

次に示す画面で独自定義ファイルを設定します。

ユーザ定義受付の場合

「ユーザ受付定義（詳細）」画面の項目［独自定義ファイル］で設定します。設定方法については，マニュアル「サービスプラットフォーム リファレンス」の「1.2.5　ユーザ定義受付定義画面」を参照してください。

サービスアダプタの場合

「サービスアダプタ定義（詳細）」画面の項目［独自定義ファイル］で設定します。設定方法については，マニュアル「サービスプラットフォーム リファレンス」の「1.2.2　サービスアダプタ定義画面」を参照してください。

左記画面で変更・削除します。

注※

実行環境の独自定義ファイル設定機能を使用しているHCSCコンポーネントに対してcsccompoconfigコマンド（-operation set）を実行しないでください。実行した場合の動作は保証しません。

実行環境では独自定義ファイルに関して，独自定義ファイル設定機能と，コマンド（csccmctlコマンドまたはcsccompoconfigコマンド）が使用できます。これらの差異を次の表に示します。どちらを利用するかはこの表を参考にしてください。

項目

実行環境の独自定義ファイル設定機能

csccmctlコマンドまたはcsccompoconfigコマンド

独自定義ファイルが正常に配置・設定されたことを確認する方法

次のどちらかのメッセージが出力されれば，コンポーネント配備または起動時に実行環境に配置した独自定義ファイルが読み込まれていることを確認できます。

KDEC05213-I

KDEC60004-I

csccmctlコマンドまたはcsccompoconfigコマンドに-operation getオプションを指定して実行すれば，正しく設定されたか確認できます。

エクスポートしたリポジトリの内容に関する注意点

実行環境への独自定義ファイルの配置後にエクスポートしたリポジトリには，実行環境に配置した独自定義ファイルは含まれません。

独自定義ファイルの設定後にエクスポートしたリポジトリには，独自定義ファイルの設定内容は反映されません。

運用時の注意点

この機能の実行対象となるHCSCコンポーネントの配備後は，実行環境の独自定義ファイルの追加・更新・削除および格納場所の変更はしないでください。

この機能の実行対象となるHCSCコンポーネントを削除したあと，サービスIDまたは受付IDが同じで種別が異なるHCSCコンポーネントのリポジトリをインポートする場合は，削除したHCSCコンポーネントの独自定義ファイルを事前に実行環境から削除してください。

削除されたHCSCコンポーネントの設定値は，csccompoconfigコマンドで変更・取得できません。

csccmctlコマンドで設定または変更した独自定義ファイルを持つHCSCコンポーネントをcsccompoundeployコマンドで削除したあと，サービスIDまたは受付IDが同じで種別が異なるHCSCコンポーネントのリポジトリをインポートする場合は，削除したHCSCコンポーネントの独自定義ファイルを事前に削除してください。削除は，csccmctlコマンドに-operation resetオプションを指定して実行します。

5.10.3　実行環境の独自定義ファイル設定機能を使用した独自定義ファイルの定義手順

実行環境の独自定義ファイル設定機能は，所定のディレクトリ下に独自定義ファイルを配置すると，特定のタイミングで読み込まれる機能です。配置された独自定義ファイルは，読み込まれる前に更新・削除することもできます。

この機能を使用する場合，独自定義ファイルのファイル名と，読み込まれるタイミングは，独自定義ファイルの種類によって異なります。詳細については，「5.10.1　独自定義ファイルの種類」を参照してください。

ここでは，実行環境の独自定義ファイル設定機能を使う場合の，独自定義ファイルの格納先ディレクトリと，独自定義ファイルの設定手順を説明します。

(1)　独自定義ファイルの格納先ディレクトリ

(a)　デフォルト状態の独自定義ファイルの格納先ディレクトリ

デフォルト状態の，独自定義ファイルの格納先ディレクトリを次に示します。

<サービスプラットフォームのインストールディレクトリ>¥CSC¥config
　└services
　　└<HCSCサーバ名>
　　　└<受付ID>または<サービスID>

ディレクトリ「services」より下位のディレクトリは，ユーザが必要に応じて作成できます。ディレクトリには，HCSCサーバの管理者（Service Coordinator管理者）のアクセス権限を設定してください。

ディレクトリの作成方法を次に示します。

<HCSCサーバ名>

ディレクトリ名には，対象となるHCSCサーバの名前を定義します。

このディレクトリには，HCSCサーバごとの独自定義ファイルを格納します。

<受付ID>または<サービスID>

ディレクトリ名には，対象となるHCSCコンポーネントの名前を定義します。ユーザ定義受付の受付ID，またはサービスアダプタのサービスIDです。※

このディレクトリには，サービスIDまたは受付IDごとの独自定義ファイルを格納します。

注※

Windowsの場合，ディレクトリ名およびファイル名は大文字と小文字が区別されません。そのため，同じHCSCサーバ内で大文字・小文字だけが異なるIDが複数定義されている場合，この機能で使用するときの動作は保証しません。

(b)　格納先ディレクトリの変更方法

独自定義ファイルの格納先ディレクトリは，HCSCサーバランタイム定義ファイルのdefinition-file-base-pathプロパティで変更できます。変更するための前提条件と手順を次に示します。

前提条件

独自定義ファイルの格納先ディレクトリを変更するには，次の条件を満たす必要があります。

HCSCサーバが停止状態または起動状態であること

対象となるHCSCコンポーネントが配備前であること

手順

HCSCサーバランタイム定義ファイルのdefinition-file-base-pathプロパティで，変更後のディレクトリを定義します。

HCSCサーバランタイム定義ファイルの定義方法については，マニュアル「サービスプラットフォーム リファレンス」の「6.5.6　HCSCサーバランタイム定義ファイル」を参照してください。

cscsvconfigコマンドに，HCSCサーバランタイム定義ファイルに定義したHCSCサーバの定義情報を指定して，実行します。

definition-file-base-pathプロパティで指定した独自定義ファイル格納ディレクトリ配下に，ディレクトリを作成します。ディレクトリ名はHCSCサーバ名としてください。

3.で作成したディレクトリ配下に，ディレクトリを作成します。ディレクトリ名は，受付IDまたはサービスIDとしてください。

4.で作成したディレクトリ配下に，独自定義ファイルを配置します。

HCSCサーバを再起動します。

HCSCサーバランタイム定義ファイルの定義情報が反映されます。

対象のHCSCコンポーネントを配備および起動します。

注意事項

対象となるHCSCコンポーネントの配備後に，実行環境の独自定義ファイルの格納先を変更しないでください。変更した場合の動作は保証しません。

(2)　独自定義ファイルの新規設定手順

独自定義ファイルを新規設定するための前提条件と手順を次に示します。

前提条件

対象となるHCSCコンポーネントが配備前であること。

手順

独自定義ファイル格納ディレクトリ配下に，ディレクトリを作成します。ディレクトリ名はHCSCサーバ名としてください。

独自定義ファイル格納ディレクトリについては，「(1)　独自定義ファイルの格納先ディレクトリ」を参照してください。

1.で作成したディレクトリ配下に，ディレクトリを作成します。ディレクトリ名は，受付IDまたはサービスIDとしてください。

2.で作成したディレクトリ配下に，独自定義ファイルを配置します。

配置するファイルの名称は，HCSCコンポーネントごとに決められています。ファイル名は「5.10.1　独自定義ファイルの種類」を参照してください。

対象のHCSCコンポーネントを配備および起動します。

HCSCコンポーネントの配備中は，対応する独自定義ファイルを変更しないてください。

ディレクトリ配下に独自定義ファイルが格納されていない場合は，開発環境でパッケージングしたアーカイブファイル（EAR/JAR）内の独自定義ファイルが読み込まれます。

(3)　独自定義ファイルの更新・削除手順

実行環境に配置した独自定義ファイルをディレクトリ配下で更新または削除する場合の前提条件と手順を示します。

前提条件

対象となるコンポーネントが配備前であること。

手順

対象のHCSCコンポーネントのディレクトリ配下にある独自定義ファイルを更新または削除します。

対象のHCSCコンポーネントを配備および起動します。

HCSCコンポーネントの配備中は，対応する独自定義ファイルを変更しないてください。

注意事項

対象となるHCSCコンポーネントの配備後に，実行環境の独自定義ファイルの追加・更新・削除はしないでください。実施した場合の動作は保証しません。

独自定義ファイル設定機能の実行対象となるHCSCコンポーネントを削除したあと，サービスIDまたは受付IDが同じで種別が異なるHCSCコンポーネントのリポジトリをインポートする場合は，削除したHCSCコンポーネントの独自定義ファイルを事前に実行環境から削除してください。

実行環境への独自定義ファイルの配置後にエクスポートしたリポジトリには，実行環境に配置した独自定義ファイルは含まれません。

csccompoconfigコマンドでの更新はしないでください。実行した場合の動作は保証しません。

6　実行履歴の管理

この章では，システム運用時のプロセスインスタンスの実行履歴の管理方法について説明します。

6.1　プロセスインスタンスの実行履歴の管理

ビジネスプロセスのプロセスインスタンスの実行状況は，履歴としてデータベースに記録できます。これを永続化といいます。プロセスインスタンスの実行履歴は，データベースを利用する場合だけ管理できます。

永続化すると，プロセスインスタンスの実行履歴の中から目的のプロセスインスタンスを特定して，状態の確認，実行履歴の削除，再実行ができるようになり，次のような場合に使用できます。

エラー発生時の問い合わせ対応

サービスリクエスタからの要求に応じて，特定のプロセスインスタンスの状態を確認して，必要に応じてプロセスインスタンスの実行履歴を削除したり，プロセスインスタンスを再実行したりできます。

ビジネスプロセスのテスト支援

ビジネスプロセス開発時にテスト実行したプロセスインスタンスの状態を確認して，ビジネスプロセスを改善できます。また，必要に応じてプロセスインスタンスの実行履歴を削除したり，プロセスインスタンスを再実行したりできます。

どのアクティビティがビジネスプロセスのどこの個所に該当するのかを確認するためには，あらかじめビジネスプロセスの開発者から，ビジネスプロセスのアクティビティ遷移図（ビジネスプロセス開発時の画面）を用意する必要があります。

6.1.1　プロセスインスタンスの実行履歴を利用する

実行履歴の利用方法を次に示します。

(1)　エラー発生時の問い合わせ対応での実行履歴の利用

エラー発生時の問い合わせに対応する場合は，プロセスインスタンスの実行履歴を次の手順で利用します。

BP実行ログのエラーメッセージなどで，原因を特定し，解消します。

プロセスインスタンスの状態を確認します。

相関セットが存在し特定できる場合

サービスリクエスタの送信した要求電文の相関セットを検索条件にして，プロセスインスタンスを検索します。相関セットを検索条件にすると，一意に識別できます。

相関セットがわからない場合

プロセスインスタンスを開始した日時を要求電文から取得して検索，または目的のプロセスインスタンスの状態（実行中など）から検索します。

検索結果からプロセスインスタンスの相関セット，変数，またはアクティビティの詳細情報を取得して，目的のプロセスインスタンスを特定します。

相関セットから検索した場合は，検索結果として表示される開始日時からもプロセスインスタンスを特定できます。

プロセスインスタンスの状態に応じて，次の作業をします。

状態が実行中，またはエラー発生の場合

プロセスインスタンスを再実行するか，またはプロセスインスタンスの実行履歴を削除します。削除後，サービスリクエスタに要求電文の再送信を依頼します。

プロセスインスタンスの情報がない（検索結果がない）場合

サービスリクエスタに要求電文の再送信を依頼します。

(2)　ビジネスプロセスのテスト支援での実行履歴の利用

ビジネスプロセスの開発時にテスト実行したプロセスインスタンスは，状態を確認してビジネスプロセスの改善に利用することもできます。ビジネスプロセスのテスト支援に使用したい場合は，プロセスインスタンスの実行履歴を次の手順で利用します。

永続化されているビジネスプロセスのプロセスインスタンスの実行履歴を，相関セット，または日時や状態などを条件として検索し，対象を絞り込みます。

検索結果からプロセスインスタンスの相関セット，変数，またはアクティビティの詳細情報を取得して，目的のプロセスインスタンスを特定します。

プロセスインスタンスの状態に応じて，次の作業をします。

実行したプロセスインスタンスの状態の把握

実行中状態，またはエラー発生状態のプロセスインスタンスの再実行

不要なプロセスインスタンスの削除

以降の項で，プロセスインスタンスの検索，情報や状態の参照，実行履歴の削除，およびプロセスインスタンスの再実行の方法について説明します。

(3)　画面を使用する場合の履歴管理ページの表示手順

プロセスインスタンスの実行履歴は，画面やコマンドを使って管理できます。

画面を使用してプロセスインスタンスの実行履歴を管理する場合は，履歴管理ページから確認できます。履歴管理ページの表示手順を次に示します。

ツリービューから，プロセスインスタンスの実行履歴を確認する対象となるビジネスプロセスを選択します。

エディタエリアで，［履歴管理］タブを選択します。

エディタエリアに履歴管理ページが表示されます。

6.1.2　プロセスインスタンスの実行履歴を検索する

プロセスインスタンスの実行履歴は，画面，コマンドおよびSQLで検索できます。SQLの場合はRDエリア名で検索します。

プロセスインスタンスの実行履歴に関して，画面とコマンドで指定できる検索条件を次に示します。

検索条件

画面での検索

（履歴管理ページ）

コマンドでの検索

（cscpiselectコマンド）

参照先

プロセスインスタンスの開始日時

○

○

「(2)　開始日時を条件として検索する」

「(6)　開始日時と状態を組み合わせて検索する」

プロセスインスタンスの状態

（「実行中」，「完了」，「エラー発生」，「フォルト終了」，または「途中終了」を指定して検索）

○

○

「(3)　状態を条件として検索する」

「(6)　開始日時と状態を組み合わせて検索する」

アクティビティインスタンスの状態

×

○

−

相関セット情報

（プロセスインスタンスを一意に特定する相関セットを指定して検索）

○

○

「(4)　相関セットを条件として検索する」

プロセスインスタンスの識別子

○

○

「(5)　プロセスインスタンス識別子を条件として検索する」

プロセス概要情報（相関セットを使用した検索，相関セットを使用しない検索）

×

○

−

アクティビティ情報

×

○

−

リンク情報

×

○

−

変数情報（string変数情報，numeric変数情報，boolean変数情報，message変数情報）

×

○

−

メッセージ関連情報

×

○

−

実行履歴情報テーブル中の全実行履歴の情報

×

○

−

検索結果の行数

×

○

−

ビジネスプロセス定義名

×

○

「(1)　ビジネスプロセス定義名を条件として検索する」

実行したHCSCサーバ名

×

○

「(7)　実行したHCSCサーバ名を条件として検索する」

（凡例）

○：検索できます。

×：検索できません。

履歴管理ページについては，マニュアル「サービスプラットフォーム リファレンス」の「4.6　履歴管理ページ」を参照してください。

また，コマンドの検索結果はCSVファイルへ出力できます。詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscpiselect（プロセスインスタンスの検索）」を参照してください。

以降で，プロセスインスタンスの実行履歴の検索について，検索例を基に説明します。

(1)　ビジネスプロセス定義名を条件として検索する

(a)　画面による実行履歴の検索

画面上にはプロセスインスタンスの実行履歴をビジネスプロセス定義名で検索する項目はないため，すべての実行履歴を表示し，その中から該当するビジネスプロセス定義名を探します。手順を次に示します。

［日時・状態検索］タブをクリックします。

プロセスインスタンスの開始日時の［指定なし］ラジオボタンを選択します。

プロセスインスタンスの状態（実行中，完了，エラー発生，フォルト終了，または途中終了）について，すべてのチェックボックスをチェックします。

ソート条件で，検索結果のソート方法を選択します。

［検索］ボタンをクリックします。

検索結果フィールドに表示されたすべての実行履歴の中から，該当するビジネスプロセス定義名を［ビジネスプロセス定義名］欄で探します。

(b)　コマンドによる実行履歴の検索

プロセスインスタンスの実行履歴をビジネスプロセス定義名で検索する手順を次に示します。

アクセスするHCSCサーバを決定します。

次のコマンドを実行して検索します。

where句を直接指定する場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -where <where句>※ -table process -orderby <ソート条件>

注※

列名ProcessDefinitionNameに対してのSQL条件を指定します。

where句が記載されたファイルを使用する場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -wherefile <where句が記載されたファイル名>※ -table process -orderby <ソート条件> -encoding <エンコーディング名>

注※

列名ProcessDefinitionNameに対してのSQL条件を指定します。

ビジネスプロセス定義名を直接指定する場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -processname <ビジネスプロセス定義名> -table process -orderby <ソート条件>

（例）次の条件でコマンドを入力して，プロセスインスタンスの実行履歴を検索します。

ビジネスプロセス定義名：Helloビジネスプロセス

アクセスするHCSCサーバ：HCSC

ソート条件：開始時刻の昇順

コマンド

-wherefileオプションを指定した場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -wherefile sql_where.txt -table process -orderby "StartTime ASC"

sql_where.txtの内容

ProcessDefinitionName = 'Helloビジネスプロセス'

-processnameオプションを指定した場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -processname Helloビジネスプロセス -table process -orderby "StartTime ASC"

出力結果

cscpiselectコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscpiselect（プロセスインスタンスの検索）」を参照してください。

(2)　開始日時を条件として検索する

(a)　画面による実行履歴の検索

プロセスインスタンスの実行履歴を開始日時で検索する手順を次に示します。

［日時・状態検索］タブをクリックします。

プロセスインスタンスの開始日時の［指定あり］ラジオボタンを選択します。

開始日時の検索範囲について，年を西暦で入力し，月日時分秒をドロップダウンリストから選択します。

検索結果のソート条件に該当するラジオボタンを選択します。

［検索］ボタンをクリックします。

検索結果フィールドに検索結果が表示されます。

(b)　コマンドによる実行履歴の検索

プロセスインスタンスの実行履歴を開始日時で検索する手順を次に示します。

注意事項

検索する場合に指定する開始日時は，コマンドに指定するオプションによって使用する時法が異なります。

-whereオプションまたは-wherefileオプションのwhere句が記載されたファイルに指定する場合：グリニッジ標準時間（GMT）

-dateオプションで指定する場合：デフォルトタイムゾーン

アクセスするHCSCサーバを決定します。

次のコマンドを実行して検索します。

where句を直接指定する場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -where <where句>※ -table process -orderby <ソート条件>

注※

列名StartTimeに対してのSQL条件を指定します。

where句が記載されたファイルを使用する場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -wherefile <where句が記載されたファイル名>※ -table process -orderby <ソート条件> -encoding <エンコーディング名>

注※

列名StartTimeに対してのSQL条件を指定します。

開始日時範囲を直接指定する場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -date <照会開始日時>※,<照会終了日時> -table process -orderby <ソート条件>

注※

照会開始日時は省略できます。

（例）次の条件でコマンドを入力して，プロセスインスタンスの実行履歴を検索します。

ビジネスプロセス定義名：Helloビジネスプロセス

開始日時範囲：2011/12/28 14:59:59以前（グリニッジ標準時間）

アクセスするHCSCサーバ：HCSC

ソート条件：開始時刻の昇順

コマンド

-wherefileオプションを指定した場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -wherefile sql_where.txt -table process -orderby "StartTime ASC"

sql_where.txtの内容

ProcessDefinitionName = 'Helloビジネスプロセス' AND StartTime <= '2011-12-28 14:59:59'

-dateオプションを指定した場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -processname Helloビジネスプロセス -date ,20111228235959※ -table process -orderby "StartTime ASC"

注※

-dateオプションのデフォルトタイムゾーンは，日本時間を使用しています。

出力結果

（例）次の条件でコマンドを入力して，プロセスインスタンスの実行履歴を検索します。

ビジネスプロセス定義名：Helloビジネスプロセス

開始日時範囲：2011/12/28 10:00:00〜2011/12/29 14:59:59（グリニッジ標準時間）

アクセスするHCSCサーバ：HCSC

ソート条件：開始時刻の昇順

コマンド

-wherefileオプションを指定した場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -wherefile sql_where.txt -table process -orderby "StartTime ASC"

sql_where.txtの内容

ProcessDefinitionName = 'Helloビジネスプロセス' AND StartTime BETWEEN '2011-12-28 10:00:00' AND '2011-12-29 14:59:59'

-dateオプションを指定した場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -processname Helloビジネスプロセス -date 20111228190000※,20111228235959※ -table process -orderby "StartTime ASC"

注※

-dateオプションのデフォルトタイムゾーンは，日本時間を使用しています。

出力結果

cscpiselectコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscpiselect（プロセスインスタンスの検索）」を参照してください。

(3)　状態を条件として検索する

(a)　画面による実行履歴の検索

プロセスインスタンスの実行履歴を状態で検索する手順を次に示します。

［日時・状態検索］タブをクリックします。

検索するプロセスインスタンスの状態（実行中，完了，エラー発生，フォルト終了，または途中終了）に該当するチェックボックスをチェックします。

複数チェックした場合は，条件のどれかに一致する状態が検索されます。

検索結果のソート条件に該当するラジオボタンを選択します。

［検索］ボタンをクリックします。

検索結果フィールドに検索結果が表示されます。

(b)　コマンドによる実行履歴の検索

プロセスインスタンスの実行履歴を状態で検索する手順を次に示します。

アクセスするHCSCサーバを決定します。

次のコマンドを実行して検索します。

where句を直接指定する場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -where <where句>※ -table process -orderby <ソート条件>

注※

列名Stateに対してのSQL条件を指定します。

where句が記載されたファイルを使用する場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -wherefile <where句が記載されたファイル名>※ -table process -orderby <ソート条件> -encoding <エンコーディング名>

注※

列名Stateに対してのSQL条件を指定します。

状態を直接指定する場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -status {executing｜completed｜faulted｜error｜exited｜executingwait｜completedwait｜all}※ -table process -orderby <ソート条件>

注※

どれか1つを指定します。

（例）次の条件でコマンドを入力して，プロセスインスタンスの実行履歴を検索します。

ビジネスプロセス定義名：Helloビジネスプロセス

プロセスインスタンスの状態：エラー発生

アクセスするHCSCサーバ：HCSC

ソート条件：開始時刻の昇順

コマンド

-wherefileオプションを指定した場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -wherefile sql_where.txt -table process -orderby "StartTime ASC"

sql_where.txtの内容

ProcessDefinitionName = 'Helloビジネスプロセス' AND State = 'Error'

-statusオプションを指定した場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -processname Helloビジネスプロセス -status error -table process -orderby "StartTime ASC"

出力結果

cscpiselectコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscpiselect（プロセスインスタンスの検索）」を参照してください。

(4)　相関セットを条件として検索する

(a)　画面による実行履歴の検索

プロセスインスタンスの実行履歴を相関セットで検索する手順を次に示します。

［相関セット検索］タブをクリックします。

相関セット定義名，および相関セット値を入力します。必ず両方の内容を入力します。

［検索］ボタンをクリックします。

検索結果フィールドに検索結果が表示されます。

相関セット値の指定方法

相関セットは，電文に含まれる1つの部分または複数の部分を連結することによって構成できます。相関セットを永続化する場合，指定した1つの部分または複数の部分を相関セット値として扱います。相関セット値は，次の規則に従って構成されます。

部分が1つの場合

部分の値そのままです。

複数の部分がある場合

部分の値を「>」で連結します。

（例）

相関セット定義名「ABC」に，2つの部分X，Yがあり，それぞれの値が「100」，「300」である場合，相関セット値は「100>300」になります。

部分の値に「@」がある場合

@を2つ連続します。

（例）

相関セット定義名「ABC」に，部分Xがあり，その値が「@200」である場合，相関セット値は「@@200」になります。

部分の値に「>」がある場合

「@G」に置換します。

（例）

相関セット定義名「ABC」に，部分Xがあり，その値が「30>」である場合，相関セット値は「30@G」になります。

(b)　コマンドによる実行履歴の検索

プロセスインスタンスの実行履歴を相関セットで検索する手順を次に示します。

アクセスするHCSCサーバを決定します。

次のコマンドを実行して検索します。

where句を直接指定する場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -where <where句>※ -table process_set

注※

相関セット定義名で検索する場合は，列名CorrelationSetNameに対してSQL条件を指定します。相関セット値で検索する場合は，列名CorrelationSetValueに対してSQL条件を指定します。

where句が記載されたファイルを使用する場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -wherefile <where句が記載されたファイル名>※ -table process_set -encoding <エンコーディング名>

注※

相関セット定義名で検索する場合は，列名CorrelationSetNameに対してSQL条件を指定します。相関セット値で検索する場合は，列名CorrelationSetValueに対してSQL条件を指定します。

（例）次の条件でコマンドを入力して，プロセスインスタンスの実行履歴を検索します。

ビジネスプロセス定義名：商品手配

相関セット定義名：set

相関セット値：HDD対応プラズマテレビ ６０型

アクセスするHCSCサーバ：HCSC

ソート条件：開始時刻の昇順

コマンド

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -wherefile sql_where.txt -table process_set -orderby "StartTime ASC"

sql_where.txtの内容

C.ProcessDefinitionName = '商品手配' AND C.CorrelationSetName = 'set' AND C.CorrelationSetValue = 'HDD対応プラズマテレビ ６０型'

出力結果

（例）次の条件でコマンドを入力して，プロセスインスタンスの実行履歴を検索します。

ビジネスプロセス定義名：商品手配

相関セット定義名：set2

相関セット値：HDD対応プラズマテレビ ６０型>1（プロパティがHDD対応プラズマテレビ ６０型と1）

アクセスするHCSCサーバ：HCSC

ソート条件：開始時刻の昇順

コマンド

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -wherefile sql_where.txt -table process_set -orderby "StartTime ASC"

sql_where.txtの内容

C.ProcessDefinitionName = '商品手配' AND C.CorrelationSetName = 'set2' AND C.CorrelationSetValue = 'HDD対応プラズマテレビ ６０型>1'

出力結果

cscpiselectコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscpiselect（プロセスインスタンスの検索）」を参照してください。

(5)　プロセスインスタンス識別子を条件として検索する

(a)　画面による実行履歴の検索

プロセスインスタンスの実行履歴をプロセスインスタンス識別子で検索する手順を次に示します。

［識別子検索］タブをクリックします。

プロセスインスタンス識別子を入力します。

コマンドやログなどから取得したプロセスインスタンス識別子を入力してください。

［検索］ボタンをクリックします。

検索結果フィールドに検索結果が表示されます。

(b)　コマンドによる実行履歴の検索

プロセスインスタンスの実行履歴をプロセスインスタンス識別子で検索する手順を次に示します。

アクセスするHCSCサーバを決定します。

次のコマンドを実行して検索します。

where句を直接指定する場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -where <where句>※ -table process -orderby <ソート条件>

注※

列名ProcessIDに対してのSQL条件を指定します。

where句が記載されたファイルを使用する場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -wherefile <where句が記載されたファイル名>※ -table process -orderby <ソート条件> -encoding <エンコーディング名>

注※

列名ProcessIDに対してのSQL条件を指定します。

（例）次の条件でコマンドを入力して，プロセスインスタンスの実行履歴を検索します。

ビジネスプロセス定義名：Helloビジネスプロセス

プロセスインスタンス識別子：J2EEServer_010210084218_Helloビジネスプロセス_1237946140968_3843192274_138

アクセスするHCSCサーバ：HCSC

ソート条件：開始時刻の昇順

コマンド

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -wherefile sql_where.txt -table process -orderby "StartTime ASC"

sql_where.txtの内容

ProcessDefinitionName = 'Helloビジネスプロセス' AND ProcessID = 'J2EEServer_192168116131_Helloビジネスプロセス_1325125384512_4896451771_139'

出力結果

cscpiselectコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscpiselect（プロセスインスタンスの検索）」を参照してください。

(6)　開始日時と状態を組み合わせて検索する

(a)　画面による実行履歴の検索

開始日時と状態を組み合わせて，検索条件として指定できます。

プロセスインスタンスの実行履歴を，開始日時と状態の組み合わせで検索する手順を次に示します。

［日時・状態検索］タブをクリックします。

プロセスインスタンスの開始日時の［指定あり］ラジオボタンを選択します。

開始日時の検索範囲について，年を西暦で入力し，月日時分秒をドロップダウンリストから選択します。

検索するプロセスインスタンスの状態（実行中，完了，エラー発生，フォルト終了，または途中終了）に該当するチェックボックスをチェックします。

複数チェックした場合は，条件のどれかに一致する状態が検索されます。

検索結果のソート条件に該当するラジオボタンを選択します。

［検索］ボタンをクリックします。

検索結果フィールドに検索結果が表示されます。

(b)　コマンドによる実行履歴の検索

プロセスインスタンスの実行履歴を，開始日時と状態の組み合わせで検索する手順を次に示します。

注意事項

検索する場合に指定する開始日時は，コマンドに指定するオプションによって使用する時法が異なります。

-whereオプションまたは-wherefileオプションのwhere句が記載されたファイルに指定する場合：グリニッジ標準時間（GMT）

-dateオプションで指定する場合：デフォルトタイムゾーン

アクセスするHCSCサーバを決定します。

次のコマンドを実行して検索します。

where句を直接指定する場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -where <where句>※ -table process -orderby <ソート条件>

注※

列名StartTimeおよびStateに対してのSQL条件を指定します。

where句が記載されたファイルを使用する場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -wherefile <where句が記載されたファイル名>※ -table process -orderby <ソート条件> -encoding <エンコーディング名>

注※

列名StartTimeおよびStateに対してのSQL条件を指定します。

開始日時範囲および状態を直接指定する場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -date <照会開始日時>※1,<照会終了日時> -status {executing｜completed｜faulted｜error｜exited｜executingwait｜completedwait｜all}※2 -table process -orderby <ソート条件>

注※1

照会開始日時は省略できます。

注※2

どれか1つを指定します。

（例）次の条件でコマンドを入力して，プロセスインスタンスの実行履歴を検索します。

ビジネスプロセス定義名：Helloビジネスプロセス

開始日時範囲：2011/12/27 15:00:00〜2011/12/28 10:51:00（グリニッジ標準時間）

状態：エラー発生

アクセスするHCSCサーバ：HCSC

ソート条件：開始時刻の昇順

コマンド

-wherefileオプションを指定した場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -wherefile sql_where.txt -table process -orderby "StartTime ASC"

sql_where.txtの内容

ProcessDefinitionName = 'Helloビジネスプロセス' AND StartTime BETWEEN '2011-12-27 15:00:00' AND '2011-12-28 10:51:00' AND State = 'Error'

-dateオプションおよび-statusオプションを指定した場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -processname Helloビジネスプロセス -date 20111228000000※,20111228195100※ -status error -table process -orderby "StartTime ASC"

注※

-dateオプションのデフォルトタイムゾーンは，日本時間を使用しています。

出力結果

cscpiselectコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscpiselect（プロセスインスタンスの検索）」を参照してください。

(7)　実行したHCSCサーバ名を条件として検索する

プロセスインスタンスの実行履歴を実行したHCSCサーバ名で検索する手順を，次に示します。

アクセスするHCSCサーバを決定します。

次のコマンドを実行して検索します。

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -table process -targetcsc <検索対象とするHCSCサーバ名>

（例）次の条件でコマンドを入力して，プロセスインスタンスの実行履歴を検索します。

アクセスするHCSCサーバ：CSCSrv1

実行したHCSCサーバ：CSCSrv2

コマンド

cscpiselect -csc CSCSrv1 -table process -targetcsc CSCSrv2

cscpiselectコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscpiselect（プロセスインスタンスの検索）」を参照してください。

(8)　プロセスインスタンスの実行履歴を全件検索する

プロセスインスタンスの実行履歴を全件検索する手順を次に示します。なお，プロセスインスタンスの実行履歴の全件検索は，コマンドでだけ実行できます。

アクセスするHCSCサーバを決定します。

次のコマンドを実行して検索します。

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -table process

（例）次の条件でコマンドを入力して，プロセスインスタンスの実行履歴を検索します。

アクセスするHCSCサーバ：HCSC

コマンド

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -table process

出力結果

cscpiselectコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscpiselect（プロセスインスタンスの検索）」を参照してください。

(9)　RDエリア名を条件として検索する

SQLのSELECT文で「IN ('<RDエリア名>')」を指定すると，RDエリア単位で検索できます。RDエリア単位の削除が正しく実行されたかなど，RDエリア単位にデータを確認したい場合に使用します。

（例）CSCBP_<クラスタ名>_PROCESSテーブルのRDエリア（RDA11とRDA21とRDA31）に，データが何件格納されているかを検索します。

SELECT count(*) FROM CSCBP_<クラスタ名>_PROCESS IN ('RDA11,RDA21,RDA31') WITHOUT LOCK NOWAIT;

(10)　全実行履歴のCSVファイルへの出力

過去の履歴として，定期的にプロセスインスタンスの実行履歴を検索し，HCSCサーバ単位に全情報をCSVファイルに出力することで，保守資料としても使用できます。プロセスインスタンスの全実行履歴のCSVファイルへの出力は，コマンドでだけ実行できます。

プロセスインスタンスの実行履歴をCSVファイルへ出力する手順を次に示します。

アクセスするHCSCサーバを決定します。

次のコマンドを実行して検索します。

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -detail -table {process｜activity｜link｜set｜string｜numeric｜boolean｜message｜relation}※

注※

どれか1つを指定します。

（例）次の条件でコマンドを入力して，プロセスインスタンスの実行履歴を一括してCSVファイルへ出力します。

HCSCサーバ単位で全情報をCSVファイルに退避。

アクセスするHCSCサーバ：HCSC

コマンド

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -detail -table process > yyyymmdd_process.csv
cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -detail -table activity > yyyymmdd_activity.csv
cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -detail -table link > yyyymmdd_link.csv
cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -detail -table set > yyyymmdd_set.csv
cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -detail -table string > yyyymmdd_string.csv
cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -detail -table numeric > yyyymmdd_numeric.csv
cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -detail -table boolean > yyyymmdd_boolean.csv
cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -detail -table message > yyyymmdd_message.csv
cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -detail -table relation > yyyymmdd_relation.csv

cscpiselectコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscpiselect（プロセスインスタンスの検索）」を参照してください。

(11)　画面による検索結果を参照する

検索の結果は，検索結果フィールドに，総件数および一覧が表示されます。一覧は，一度に20件まで表示されます。

また，検索時との時間差によって，検索の結果，総件数と表示対象件数が異なる場合があります。例えば，総件数が13件で，表示対象件数が60件の場合などです。この場合は，表示対象の件数が20件を超えても，［次へ］ボタンが非活性の状態になり，21件目以降を表示できなくなるため，再検索をする必要があります。

また，検索結果一覧の［前へ］，［次へ］ボタンをクリックしたあとに，プロセスインスタンスの件数などが変化している場合があります。例えば，総件数が45件で，表示対象件数が21〜40件を表示中に，［次へ］ボタンをクリックすると，総件数が10件になっている場合などです。この場合は，1〜10件が表示されます。

6.1.3　プロセスインスタンスの実行履歴の詳細情報を取得する

次に示すように目的に応じて，プロセスインスタンスの実行履歴の詳細情報を取得します。

相関セットの値からプロセスインスタンスを特定する場合

各プロセスインスタンスを一意に特定する相関セットの情報である，相関セット定義名および相関セット値の一覧を取得します。

変数値からプロセスインスタンスを特定する場合

各プロセスインスタンスが持つグローバル変数の情報である，変数定義名および変数値の一覧を取得します。

プロセスインスタンスの実行状況を確認する場合

プロセスインスタンスについて，ビジネスプロセス内に定義された各アクティビティの情報を取得します。

(1)　相関セットの詳細情報の取得

(a)　画面による実行履歴の詳細情報の取得

プロセスインスタンスの実行履歴の詳細情報（相関セット情報）を取得する手順を次に示します。

プロセスインスタンスを検索します。

検索結果一覧から情報を取得するプロセスインスタンスの実行履歴を選択します。

［相関セット情報］ボタンをクリックします。

詳細情報フィールドに詳細情報が表示されます。

(b)　コマンドによる実行履歴の詳細情報の取得

プロセスインスタンスの実行履歴の詳細情報（相関セット情報）を取得する手順を次に示します。

アクセスするHCSCサーバを決定します。

次のコマンドを実行して検索します。

where句を直接指定する場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -where <where句>※ -table set

注※

情報取得対象のプロセスインスタンスの条件を指定します。

where句が記載されたファイルを使用する場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -wherefile <where句が記載されたファイル名>※ -table set -encoding <エンコーディング名>

注※

情報取得対象のプロセスインスタンスの条件を指定します。

実行したHCSCサーバ名称を条件に検索する場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -table set -targetcsc <検索対象とするHCSCサーバ名>

（例）次の条件でコマンドを入力して，相関セット情報を取得します。

取得対象のプロセスID：J2EEServer_010209010042_XXXPurchaseRegisterService_1142479241203_760331597_2115

アクセスするHCSCサーバ：HCSC

コマンド

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -wherefile sql_where.txt -table set

sql_where.txtの内容

ProcessID = 'J2EEServer_010209010042_XXXPurchaseRegisterService_1142479241203_760331597_2115'

出力結果

cscpiselectコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscpiselect（プロセスインスタンスの検索）」を参照してください。

(2)　変数の詳細情報の取得

(a)　画面による実行履歴の詳細情報の取得

プロセスインスタンスの実行履歴の詳細情報（変数情報）を取得する手順を次に示します。

プロセスインスタンスを検索します。

検索結果一覧から情報を取得するプロセスインスタンスの実行履歴を選択します。

［変数情報］ボタンをクリックします。

詳細情報フィールドに詳細情報が表示されます。

変数型がStringまたはMessageの場合，該当する変数を選択して［変数値表示］ボタンをクリックします。

次の図に示すように，別ウィンドウに変数値の詳細情報が表示されます。

図6‒1　変数情報の詳細表示画面

(b)　コマンドによる実行履歴の詳細情報の取得

プロセスインスタンスの実行履歴の詳細情報（変数情報）を取得する手順を次に示します。

アクセスするHCSCサーバを決定します。

次のコマンドを実行して検索します。

where句を直接指定する場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -where <where句>※1 -table {string｜numeric｜boolean｜message}※2

注※1

情報取得対象のプロセスインスタンスの条件を指定します。

注※2

どれか1つを指定します。

where句が記載されたファイルを使用する場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -wherefile <where句が記載されたファイル名>※1 -table {string｜numeric｜boolean｜message}※2 -encoding <エンコーディング名>

注※1

情報取得対象のプロセスインスタンスの条件を指定します。

注※2

どれか1つを指定します。

実行したHCSCサーバ名称を条件に検索する場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -table {string｜numeric｜boolean｜message} -targetcsc <検索対象とするHCSCサーバ名>

変数情報は，変数ごとに別テーブルになっているため，変数の型が不明な場合は，すべてのテーブルを検索してください。

（例）次の条件でコマンドを入力して，変数情報を取得します。

取得対象のプロセスID：J2EEServer_010210084218_商品手配_1237948143515_3919056788_140

アクセスするHCSCサーバ：HCSC

コマンド

string変数情報を表示する場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -wherefile sql_where.txt -table string

numeric変数情報を表示する場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -wherefile sql_where.txt -table numeric

boolean変数情報を表示する場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -wherefile sql_where.txt -table boolean

message変数情報を表示する場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -wherefile sql_where.txt -table message

sql_where.txtの内容

ProcessID = 'J2EEServer_010210084218_商品手配_1237948143515_3919056788_140'

出力結果

string変数情報の場合

numeric変数情報の場合

boolean変数情報の場合

message変数情報の場合

cscpiselectコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscpiselect（プロセスインスタンスの検索）」を参照してください。

(3)　アクティビティの詳細情報の取得

注意事項

ビジネスプロセスの定義でデータ変換アクティビティを定義した場合，実行履歴のアクティビティ種別は代入アクティビティとして出力します。

(a)　画面による実行履歴の詳細情報の取得

プロセスインスタンスの実行履歴の詳細情報（アクティビティ情報）を取得する手順を次に示します。

プロセスインスタンスを検索します。

検索結果一覧から情報を取得するプロセスインスタンスの実行履歴を選択します。

［アクティビティ情報］ボタンをクリックします。

詳細情報フィールドに詳細情報が表示されます。

(b)　コマンドによる実行履歴の詳細情報の取得

プロセスIDを指定して，プロセスインスタンスの実行履歴の詳細情報（アクティビティ情報）を取得する手順を次に示します。

アクセスするHCSCサーバを決定します。

次のコマンドを実行して検索します。

where句を直接指定する場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -where <where句>※ -table activity

注※

情報取得対象のプロセスインスタンスの条件を指定します。

where句が記載されたファイルを使用する場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -wherefile <where句が記載されたファイル名>※ -table activity -encoding <エンコーディング名>

注※

情報取得対象のプロセスインスタンスの条件を指定します。

実行したHCSCサーバ名称を条件に検索する場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -table activity -targetcsc <検索対象とするHCSCサーバ名>

（例）次の条件でコマンドを入力して，アクティビティ情報を取得します。

取得対象のプロセスID：

J2EEServer_010210084218_商品手配_1237856438531_3676477500_139

アクセスするHCSCサーバ：

HCSC

コマンド

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -wherefile sql_where.txt -table activity

sql_where.txtの内容

ProcessID = 'J2EEServer_010210084218_商品手配_1237856438531_3676477500_139'

出力結果

cscpiselectコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscpiselect（プロセスインスタンスの検索）」を参照してください。

6.1.4　プロセスインスタンスの実行履歴を削除する

リクエストを再送信する場合，またはテスト実行したプロセスインスタンスを削除する場合など，不要になったプロセスインスタンスの実行履歴を，1件ずつ削除できます。

また，プロセスインスタンスの実行履歴は，日々追加されていくため，定期的に情報を削除しないとデータベースの容量が圧迫されます。そこで，定期的に，管理者はデータベース上の実行履歴情報テーブルから，プロセスインスタンスの実行履歴を削除する必要があります。日常運用では通常，バッチ化して，実行履歴を一括削除できます。

プロセスインスタンスの実行履歴の削除は，画面による方法，コマンドによる方法およびデータベース作成ユティリティ（pdload）による方法があります。

(1)　画面による実行履歴の削除

(a)　1件ずつ削除する場合

画面上でプロセスインスタンスの実行履歴を1件ずつ削除する手順を次に示します。

プロセスインスタンスを検索します。

検索結果一覧から，削除したいプロセスインスタンスの実行履歴を選択します。

［履歴削除］ボタンをクリックします。

プロセスインスタンス実行履歴削除の実行確認ダイアログが表示されます。

「実行中」のプロセスインスタンスを含む場合は，実行中のプロセスインスタンスの実行履歴を削除するかどうかを確認するダイアログが表示されます。

［OK］ボタンをクリックします。

プロセスインスタンスの実行履歴が削除され，プロセスインスタンスの実行履歴削除の実行結果ダイアログが表示されます。

［OK］ボタンをクリックします。

検索結果一覧が更新されます。

(b)　一括して削除する場合

画面によってプロセスインスタンスの実行履歴を一括削除する手順を次に示します。

プロセスインスタンスを検索します。

検索結果一覧から，削除したいプロセスインスタンスの実行履歴を選択します。

［Ctrl］キーまたは［Shift］キーを使用して，複数のプロセスインスタンスを選択します。

［履歴削除］ボタンをクリックします。

プロセスインスタンス実行履歴削除の実行確認ダイアログが表示されます。

「実行中」のプロセスインスタンスを含む場合は，実行中のプロセスインスタンスの実行履歴を削除するかどうかを確認するダイアログが表示されます。

［OK］ボタンをクリックします。

プロセスインスタンスの実行履歴が削除され，プロセスインスタンスの実行履歴削除の実行結果ダイアログが表示されます。

［OK］ボタンをクリックします。

検索結果一覧が更新されます。

注意事項

一括削除に失敗した場合，選択したプロセスインスタンスはまったく削除されません。

(2)　コマンドによる実行履歴の削除

cscpideleteコマンドを使った実行履歴の削除について説明します。cscpideleteコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscpidelete（プロセスインスタンスの実行履歴の削除）」を参照してください。

(a)　1件ずつ削除する場合

コマンドによってプロセスインスタンスの実行履歴を1件ずつ削除する手順を次に示します。

アクセスするHCSCサーバを決定します。

cscpiselectコマンドで，削除したいプロセスインスタンスを検索します。

検索結果から，削除対象のプロセスインスタンスのプロセスIDを特定します。

次のコマンドを実行して削除します。

where句を直接指定する場合

cscpidelete -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -where <where句>※

注※

削除対象のプロセスインスタンスの削除条件を指定します。

where句が記載されたファイルを使用する場合

cscpidelete -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -wherefile <where句が記載されたファイル名>※

注※

削除対象のプロセスインスタンスの削除条件を指定します。

IDのリストが記載されたファイルを指定する場合

cscpidelete -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -idlist <IDのリストが記載されたファイル名>

（例）次の条件でコマンドを入力して，プロセスインスタンスの実行履歴を削除します。

削除対象のプロセスID：J2EEServer_010209010042_XXXPurchaseRegisterService_1142479241203_760331597_2115

アクセスするHCSCサーバ：HCSC

コマンド

-wherefileオプションを指定した場合

cscpidelete -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -wherefile delete_where.txt

delete_where.txtの内容

ProcessID = 'J2EEServer_010209010042_XXXPurchaseRegisterService_1142479241203_760331597_2115'

-idlistオプションを指定した場合

cscpidelete -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -idlist delete_id_list.txt

delete_id_list.txtの内容

J2EEServer_010209010042_XXXPurchaseRegisterService_1142479241203_760331597_2115

(b)　プロセスインスタンスのビジネスプロセス定義名を指定して一括削除する場合

コマンドによってプロセスインスタンスのビジネスプロセス定義名を指定し，実行履歴を一括削除する手順を次に示します。

アクセスするHCSCサーバを決定します。

次のコマンドを実行して削除します。

where句を直接指定する場合

cscpidelete -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -where <where句>※

注※

列名ProcessDefinitionNameに対してのSQL条件を指定します。

where句が記載されたファイルを使用する場合

cscpidelete -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -wherefile <where句が記載されたファイル名>※

注※

列名ProcessDefinitionNameに対してのSQL条件を指定します。

ビジネスプロセス定義名を直接指定する場合

cscpidelete -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -processname <ビジネスプロセス定義名>

（例）次の条件でコマンドを入力して，プロセスインスタンスの実行履歴を一括削除します。

ビジネスプロセス定義名：Helloビジネスプロセス

アクセスするHCSCサーバ：HCSC

コマンド

-wherefileオプションを指定した場合

cscpidelete -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -wherefile delete_where.txt

delete_where.txtの内容

ProcessDefinitionName=' Helloビジネスプロセス '

-processnameオプションを指定した場合

cscpidelete -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -processname Helloビジネスプロセス

(c)　プロセスインスタンスの開始日時を指定して一括削除する場合

コマンドによってプロセスインスタンスの開始日時を指定し，実行履歴を一括削除する手順を次に示します。

注意事項

削除する場合に指定する開始日時は，コマンドに指定するオプションによって使用する時法が異なります。

-whereオプションまたは-wherefileオプションのwhere句が記載されたファイルに指定する場合：グリニッジ標準時間（GMT）

-dateオプションで指定する場合：デフォルトタイムゾーン

アクセスするHCSCサーバを決定します。

次のコマンドを実行して削除します。

where句を直接指定する場合

cscpidelete -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -where <where句>※

注※

列名StartTimeに対してのSQL条件を指定します。

where句の記載されたファイルを使用する場合

cscpidelete -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -wherefile <where句が記載されたファイル名>※

注※

列名StartTimeに対してのSQL条件を指定します。

開始日時範囲を直接指定する場合

cscpidelete -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -date <照会開始日時>※,<照会終了日時>

注※

照会開始日時は省略できます。

（例）次の条件でコマンドを入力して，プロセスインスタンスの実行履歴を一括削除します。

開始日時範囲：2008/10/09 14:59:59以前（グリニッジ標準時間）

アクセスするHCSCサーバ：HCSC

コマンド

-wherefileオプションを指定した場合

cscpidelete -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -wherefile delete_where.txt

delete_where.txtの内容

StartTime <= '2008-10-09 14:59:59'

-dateオプションを指定した場合

cscpidelete -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -date ,20081009235959※

注※

-dateオプションのデフォルトタイムゾーンは，日本時間を使用しています。

（例）次の条件でコマンドを入力して，プロセスインスタンスの実行履歴を一括削除します。

開始日時範囲：2008/10/08 15:00:00〜2008/10/09 14:59:59（グリニッジ標準時間）

アクセスするHCSCサーバ：HCSC

コマンド

-wherefileオプションを指定した場合

cscpidelete -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -wherefile delete_where.txt

delete_where.txtの内容

StartTime BETWEEN '2008-10-08 15:00:00' AND '2008-10-09 14:59:59'

-dateオプションを指定した場合

cscpidelete -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -date 20081009000000※,20081009235959※

注※

-dateオプションのデフォルトタイムゾーンは，日本時間を使用しています。

(d)　プロセスインスタンスの状態を指定して一括削除する場合

コマンドによってプロセスインスタンスの状態を指定し，実行履歴を一括削除する手順を次に示します。

アクセスするHCSCサーバを決定します。

次のコマンドを実行して削除します。

where句を直接指定する場合

cscpidelete -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -where <where句>※

注※

列名Stateに対してのSQL条件を指定します。

where句が記載されたファイルを使用する場合

cscpidelete -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -wherefile <where句が記載されたファイル名>※

注※

列名Stateに対してのSQL条件を指定します。

状態を直接指定する場合

cscpidelete -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -status {executing｜completed｜faulted｜error｜exited｜all}※

注※

どれか1つを指定します。

（例）次の条件でコマンドを入力して，プロセスインスタンスの実行履歴を一括削除します。

プロセスインスタンスの状態：実行中

アクセスするHCSCサーバ：HCSC

コマンド

-wherefileオプションを指定した場合

cscpidelete -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -wherefile delete_where.txt

delete_where.txtの内容

State='Executing'

注

State='Completed'以外の条件を指定すると，完了したプロセスインスタンス以外の削除条件で削除されるため，注意が必要です。

-statusオプションを指定した場合

cscpidelete -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -status executing

(e)　プロセスインスタンスのビジネスプロセス定義名，開始日時，および状態を組み合わせて一括削除する場合

コマンドによってプロセスインスタンスのビジネスプロセス定義名，開始日時，および状態を組み合わせて指定し，一括削除する手順を次に示します。

注意事項

削除する場合に指定する開始日時は，コマンドに指定するオプションによって使用する時法が異なります。

-whereオプションまたは-wherefileオプションのwhere句が記載されたファイルに指定する場合：グリニッジ標準時間（GMT）

-dateオプションで指定する場合：デフォルトタイムゾーン

アクセスするHCSCサーバを決定します。

次のコマンドを実行して削除します。

where句を直接指定する場合

cscpidelete -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -where <where句>※

注※

列名ProcessDefinitionName，StartTime，およびStateに対してのSQL条件を指定します。

where句が記載されたファイルを使用する場合

cscpidelete -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -wherefile <where句が記載されたファイル名>※

注※

列名ProcessDefinitionName，StartTime，およびStateに対してのSQL条件を指定します。

ビジネスプロセス定義名，開始日時範囲，および状態を直接指定する場合

cscpidelete -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -processname <ビジネスプロセス定義名> -date <照会開始日時>※1,<照会終了日時> -status {executing｜completed｜faulted｜error｜exited｜all}※2

注※1

照会開始日時は省略できます。

注※2

どれか1つを指定します。

（例）次の条件でコマンドを入力して，プロセスインスタンスの実行履歴を一括削除します。

ビジネスプロセス定義名：Helloビジネスプロセス

開始日時範囲：2008/10/09 14:59:59以前（グリニッジ標準時間）

プロセスインスタンスの状態：実行中

アクセスするHCSCサーバ：HCSC

コマンド

-wherefileオプションを指定した場合

cscpidelete -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -wherefile delete_where.txt

delete_where.txtの内容

ProcessDefinitionName=' Helloビジネスプロセス ' AND StartTime <= '2008-10-09 14:59:59' AND State='Executing'

-processnameオプション，-dateオプション，および-statusオプションを指定した場合

cscpidelete -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -processname Helloビジネスプロセス -date ,20081009235959※ -status executing

注※

-dateオプションのデフォルトタイムゾーンは，日本時間を使用しています。

(f)　すべてのプロセスインスタンスの実行履歴を一括削除する場合

コマンドによってすべてのプロセスインスタンスの実行履歴を一括削除する手順を次に示します。

アクセスするHCSCサーバを決定します。

次のコマンドを実行して削除します。

cscpidelete -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -force

（例）次の条件でコマンドを入力して，すべてのプロセスインスタンスの実行履歴を一括削除します。

アクセスするHCSCサーバ：HCSC

コマンド

cscpidelete -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -force

(g)　削除処理時間を指定して一括削除する場合

削除したいプロセスインスタンスの実行履歴の量が膨大になると，すべての削除処理の完了までに長時間を要するおそれがあります。削除処理がリクエスト処理に影響を与えないよう，一括削除の処理時間を限定することもできます。

削除処理を中断するまでの経過時間は，cscpideleteコマンドの-canceltimerオプションに秒単位で指定できます。これによって，コミット後に指定された時間を超過すると削除処理を中断でき，その後の削除処理が実行されないようになります。

（例）

次の例では，2005年3月31日までに蓄積されたデータを600秒でできるかぎり削除します。

cscpidelete -csc CSCSrv1 -date ,20050331235959 -canceltimer 600

cscpideleteコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscpidelete（プロセスインスタンスの実行履歴の削除）」を参照してください。

(3)　データベース作成ユティリティ（pdload）による実行履歴の削除

テーブル分割機能を利用する環境では，ビジネスプロセスの実行履歴をHiRDBの機能を利用してRDエリア（月）単位で削除できます。テーブル分割機能を利用する場合，RDエリアの循環割り当てを実行するため，日々追加される実行履歴を定期的に削除する必要があります。

ただし，RDエリア単位の実行履歴の削除を利用した場合，「Executing（実行中）」や「Error（エラー）」状態のデータも削除されます。事前に，削除したくないデータが含まれていないかを次の方法で確認してください。

確認方法の例

SELECT count(*) FROM CSCBP_<クラスタ名>_PROCESS IN ('<削除対象のRDエリア名1>,<削除対象のRDエリア名2>,…') WHERE State IN ('Executing','Error') WITHOUT LOCK NOWAIT

削除したくないデータは事前に退避してください。実行履歴の退避手順と削除手順を次に示します。

(a)　実行履歴の退避手順

データを退避する際の前提条件を次に示します。

すべてのHCSCサーバの受付が停止状態であることを確認してください。

仕掛かり中のリクエストがないことを確認してください。

Service Coordinatorのコマンドは実行しないでください。

退避処理はメモリ上（Javaプログラム）で実行してください。

データの退避手順を次に示します。

JDBCドライバを使ってデータベース（HiRDB）に接続します。

接続時には次の点に注意してください。

接続時のユーザプロパティのLONGVARBINARY_ACCESSは，LOCATORにすることを推奨します。

LONGVARBINARY_ACCESSにREALを設定する場合は，HiRDB_for_Java_MAXBINARYSIZEに適切な上限値を設定してください。

HiRDB_for_Java_MAXBINARYSIZEを設定しなかった場合，CSCBP_<クラスタ名>_MSG_VARIABLEテーブルのVariableValueのデータの取得に2,147,483,639バイトのメモリを確保しようとするため，java.lang.OutOfMemoryErrorが発生するおそれがあります。

また，HiRDB_for_Java_MAXBINARYSIZEの設定値がCSCBP_<クラスタ名>_MSG_VARIABLEテーブルのVariableValueに格納されているデータの最大長よりも小さい場合，超過したデータが切り捨てられ，システムが正常に動作しなくなるおそれがあります。

自動コミットは無効にすることを推奨します。

無効にしなかった場合，退避処理中に障害が発生すると，システムが正常に動作しなくなるおそれがあります。

退避対象のプロセスインスタンスを特定します。

削除対象のRDエリアに格納されている，状態（State）が「Executing」または「Error」のプロセスインスタンスを退避させる場合，次に示すSQLを発行して，退避対象のプロセスインスタンス識別子の一覧を取得してください。

SELECT ProcessID FROM CSCBP_<クラスタ名>_PROCESS
        IN ('<削除対象のRDエリア名1>,<削除対象のRDエリア名2>,…')
        WHERE State IN ('Executing', 'Error')
       WITHOUT LOCK NOWAIT;

退避対象のプロセスインスタンスの格納先を変更します。

手順2.で取得したプロセスインスタンス識別子をキーとして，次に示すすべてのテーブルの格納先を変更してください。

CSCBP_<クラスタ名>_PROCESS

CSCBP_<クラスタ名>_ACTIVITY

CSCBP_<クラスタ名>_LINK

CSCBP_<クラスタ名>_CORRELATIONSET

CSCBP_<クラスタ名>_STR_VARIABLE

CSCBP_<クラスタ名>_NUM_VARIABLE

CSCBP_<クラスタ名>_BOOL_VARIABLE

CSCBP_<クラスタ名>_MSG_VARIABLE

CSCBP_<クラスタ名>_MSG_RELATION

格納先の変更手順を次に示します。取得したプロセスインスタンス識別子が複数ある場合は，手順(i)〜(iii)を複数回実行してください。

(i)対象のプロセスインスタンス識別子の全データを取得します。

次のSQLを発行し，退避対象の全データを取得してください。

SELECT * FROM CSCBP_<クラスタ名>_PROCESS
    IN ('<削除対象のRDエリア名1>,<削除対象のRDエリア名2>,…')
WHERE ProcessID = <プロセスインスタンス識別子> WITHOUT LOCK NOWAIT;

SELECT * FROM CSCBP_<クラスタ名>_ACTIVITY
    IN ('<削除対象のRDエリア名1>,<削除対象のRDエリア名2>,…')
WHERE ProcessID = <プロセスインスタンス識別子> WITHOUT LOCK NOWAIT;

SELECT * FROM CSCBP_<クラスタ名>_LINK
    IN ('<削除対象のRDエリア名1>,<削除対象のRDエリア名2>,…')
WHERE ProcessID = <プロセスインスタンス識別子> WITHOUT LOCK NOWAIT;

SELECT * FROM CSCBP_<クラスタ名>_CORRELATIONSET
    IN ('<削除対象のRDエリア名1>,<削除対象のRDエリア名2>,…')
WHERE ProcessID = <プロセスインスタンス識別子> WITHOUT LOCK NOWAIT;

SELECT * FROM CSCBP_<クラスタ名>_STR_VARIABLE
    IN ('<削除対象のRDエリア名1>,<削除対象のRDエリア名2>,…')
WHERE ProcessID = <プロセスインスタンス識別子> WITHOUT LOCK NOWAIT;

SELECT * FROM CSCBP_<クラスタ名>_NUM_VARIABLE
    IN ('<削除対象のRDエリア名1>,<削除対象のRDエリア名2>,…')
WHERE ProcessID = <プロセスインスタンス識別子> WITHOUT LOCK NOWAIT;

SELECT * FROM CSCBP_<クラスタ名>_BOOL_VARIABLE
    IN ('<削除対象のRDエリア名1>,<削除対象のRDエリア名2>,…')
WHERE ProcessID = <プロセスインスタンス識別子> WITHOUT LOCK NOWAIT;

SELECT * FROM CSCBP_<クラスタ名>_MSG_VARIABLE
    IN ('<削除対象のRDエリア名1>,<削除対象のRDエリア名2>,…')
WHERE ProcessID = <プロセスインスタンス識別子> WITHOUT LOCK NOWAIT;

SELECT * FROM CSCBP_<クラスタ名>_MSG_RELATION
    IN ('<削除対象のRDエリア名1>,<削除対象のRDエリア名2>,…')
WHERE ProcessID = <プロセスインスタンス識別子> WITHOUT LOCK NOWAIT;

(ii)SplitKey列の値を更新し，テーブルに再登録します。

SplitKey列の値を次回の削除対象のRDエリアに割り当てられるよう変更（例えば，RDエリアの分割が1か月単位で，今回の削除対象が12月（'12'）の場合は，1月（'01'）へ変更）し，INSERT文を発行します。

そのためには，取得したすべてのデータに対して次のSQLを発行し，退避対象のデータが別のRDエリアに割り当てられるよう再登録する必要があります。手順(i)のSELECT文で取得したレコードの数だけINSERT文を発行してください。

INSERT INTO CSCBP_<クラスタ名>_PROCESS
(ProcessID,ProcessDefinitionName,ProcessDefinitionVersion,State,ChangeCount,
StartTime,EndTime,CSCServerName,SplitKey)
VALUES (<(i)で取得したSplitKey列以外のデータ>, '01');

INSERT INTO CSCBP_<クラスタ名>_ACTIVITY
(ProcessID,ActivityNumber,ActivityDefinitionName,ActivityKind,ParentNumber,
ScopeNumber,RepeatNumber,State,FirstChildNumber,LastChildNumber,StartTime,EndTime,
WaitTime,SplitKey)
VALUES (<(i)で取得したSplitKey列以外のデータ>, '01');

INSERT INTO CSCBP_<クラスタ名>_LINK
(ProcessID,LinkDefinitionName,RepeatNumber,State,SplitKey)
VALUES (<(i)で取得したSplitKey列以外のデータ>, '01');

INSERT INTO CSCBP_<クラスタ名>_CORRELATIONSET
(ProcessID,ProcessDefinitionName,ProcessDefinitionVersion,ScopeDefinitionName,
ScopeNumber,CorrelationSetName,CorrelationSetValue,State,SplitKey)
VALUES (<(i)で取得したSplitKey列以外のデータ>, '01');

INSERT INTO CSCBP_<クラスタ名>_STR_VARIABLE
(ProcessID,ScopeNumber,VariableName,VariableValue,SplitKey)
VALUES (<(i)で取得したSplitKey列以外のデータ>, '01');

INSERT INTO CSCBP_<クラスタ名>_NUM_VARIABLE
(ProcessID,ScopeNumber,VariableName,VariableValue,SplitKey)
VALUES (<(i)で取得したSplitKey列以外のデータ>, '01');

INSERT INTO CSCBP_<クラスタ名>_BOOL_VARIABLE
(ProcessID,ScopeNumber,VariableName,VariableValue,SplitKey)
VALUES (<(i)で取得したSplitKey列以外のデータ>, '01');

INSERT INTO CSCBP_<クラスタ名>_MSG_VARIABLE
(ProcessID,ScopeNumber,VariableName,VariableValue,SplitKey)
VALUES (<(i)で取得したSplitKey列以外のデータ>, '01');

INSERT INTO CSCBP_<クラスタ名>_MSG_RELATION
(MessageID,ProcessID,ActivityNumber,SendOrReceive,
AsynchronousMessagingID,SplitKey)
VALUES (<(i)で取得したSplitKey列以外のデータ>, '01');

注

1〜9月へ更新する場合，「01」のように前に0を付けてください。

SplitKey列以外の値は変更しないでください。

同じプロセスインスタンス識別子のSplitKey列の値は一致させてください。

なお，退避したプロセスインスタンスを再実行したり，相関セットを指定した後続処理を呼び出したりした場合，新しくデータベースに格納されるデータのSplitKey列の値は，「プロセスインスタンスが開始された月(GMT)」ではなく，この手順でINSERTしたSplitKeyの値と同じ値になります。

(iii)トランザクションをコミットします。

自動コミットが無効のまま大量の処理を実行すると，資源不足が発生するおそれがあります。定期的（例えば，プロセスインスタンス識別子100件単位）にトランザクションのコミットを発行して，資源を解放してください。

コネクションを破棄します。

(b)　実行履歴の削除手順

RDエリア単位の削除手順を次に示します。

削除対象のデータが格納されたRDエリアを閉塞させます。

データ用RDエリアとインデクス用RDエリアの両方に対して，次のコマンドを実行してください。

pdhold -r <RDエリア名>

RDエリアに格納されている削除対象のデータをアンロードします。

この手順は任意です。RDエリアに格納されているデータをバックアップしたい場合に実施してください。

アンロードは次の形式でテーブルごとに実行してください。

pdrorg -k unld -t <テーブル名>※1 -r <データ用RDエリア名> <制御情報ファイル名>※2

注※1

テーブル名には次の名称を指定してください。

CSCBP_<クラスタ名>_PROCESS

CSCBP_<クラスタ名>_ACTIVITY

CSCBP_<クラスタ名>_LINK

CSCBP_<クラスタ名>_CORRELATIONSET

CSCBP_<クラスタ名>_STR_VARIABLE

CSCBP_<クラスタ名>_NUM_VARIABLE

CSCBP_<クラスタ名>_BOOL_VARIABLE

CSCBP_<クラスタ名>_MSG_VARIABLE

CSCBP_<クラスタ名>_MSG_RELATION

注※2

指定する制御情報ファイルには次の内容を記述してください。

HiRDB/Single Serverの場合

unload <各テーブルのデータをアンロードするファイルのパス>

HiRDB/Parallel Serverの場合

unload <バックエンドサーバ名>:<各テーブルのデータをアンロードするファイルのパス>

なお，pdrorgでアンロードしたデータをテーブルに格納し直す方法については，マニュアル「HiRDB Version 10 コマンドリファレンス（Windows(R)用）」または「HiRDB Version 10 コマンドリファレンス（UNIX(R)用）」の，pdrorg出力バイナリ形式ファイルの記述を参照してください。

RDエリアに格納された既存のデータを削除して，0件のデータをロードします。

ロード方法は次のとおりです。インデクスの情報もデータの内容に合わせてロードされます。出力されたエラー情報ファイルの内容を参照し，エラーが発生していないことを確認してください。

pdload -d CSCBP_<クラスタ名>_PROCESS <制御情報ファイル名>
pdload -d CSCBP_<クラスタ名>_ACTIVITY <制御情報ファイル名>
pdload -d CSCBP_<クラスタ名>_LINK <制御情報ファイル名>
pdload -d CSCBP_<クラスタ名>_CORRELATIONSET <制御情報ファイル名>
pdload -d CSCBP_<クラスタ名>_STR_VARIABLE <制御情報ファイル名>
pdload -d CSCBP_<クラスタ名>_NUM_VARIABLE <制御情報ファイル名>
pdload -d CSCBP_<クラスタ名>_BOOL_VARIABLE <制御情報ファイル名>
pdload -d CSCBP_<クラスタ名>_MSG_VARIABLE <制御情報ファイル名>
pdload -d CSCBP_<クラスタ名>_MSG_RELATION <制御情報ファイル名>

指定する制御情報ファイルには次の内容を記述してください。<データファイルのパス>に指定する，データが0件（中身が空）のファイルを事前に用意してください。

HiRDB/Single Serverの場合

source <データ用RDエリア名> <データファイルのパス>

HiRDB/Parallel Serverの場合

source <データ用RDエリア名> <バックエンドサーバ名>:<データファイルのパス>

RDエリアの閉塞を解除します。

次のコマンドを実行し，手順1.で実施したRDエリアの閉塞を解除してください。

pdrels -r <RDエリア名>

この手順によってRDエリア単位の削除が正しく実行されたかどうかは，次に示すSQLを発行することで確認できます。

SELECT count(*) FROM CSCBP_<クラスタ名>_PROCESS IN ('<削除対象のRDエリア名1>,<削除対象のRDエリア名2>,…') WITHOUT LOCK NOWAIT;

6.1.5　プロセスインスタンスを再実行する

ビジネスプロセス実行中に，実行基盤のあるマシンが停止したり，サービス部品の呼び出しに失敗したりなど，障害が発生し中断したプロセスインスタンスを1件ずつ再実行できます。

また，複数のプロセスインスタンスを一括再実行することもできます。プロセスインスタンスの実行履歴の一括再実行は，コマンドでだけ実行できます。

なお，サービスリクエスタから，ビジネスプロセスの再実行を要求して，ビジネスプロセスを再実行することもできます。

プロセスインスタンスを再実行できる条件，およびサービスリクエスタによるビジネスプロセスの再実行については，マニュアル「サービスプラットフォーム 解説」の「3.5　ビジネスプロセスの再実行」を参照してください。

注意事項

画面やコマンドで実行履歴を検索してから再実行するまでの間に生じる時間差によって，検索結果に表示されたプロセスインスタンス実行履歴の状態と，実際のプロセスインスタンス実行履歴の状態が異なることがあります。この場合，「完了」または「フォルト終了」状態のプロセスインスタンスに対して再実行をしても，実際には再実行は失敗し実施されません。そのため，できる限り最新の情報を取得して再実行を実施してください。

(1)　画面によるプロセスインスタンスの再実行

(a)　1件ずつ再実行する場合

画面によってプロセスインスタンスを1件ずつ再実行する手順を次に示します。

プロセスインスタンスを検索します。

検索結果一覧に検索結果が表示されます。

検索結果一覧から，状態が「実行中」または「エラー発生」であるプロセスインスタンスを選択して，［アクティビティ情報］ボタンをクリックします。

詳細情報一覧にアクティビティ情報が表示されます。

詳細情報一覧から，プロセスインスタンスを再実行できる条件に該当するアクティビティが含まれていることを確認します。

プロセスインスタンスを再実行できる条件を次の表に示します。

表6‒1　プロセスインスタンスを再実行できる条件

アクティビティ種別

アクティビティインスタンスの状態

サービス呼出

実行中

エラー発生

待機

実行中

スコープ

実行中（待ち受け）

エラー発生

完了（待ち受け）

応答

完了（待ち受け）

［再実行］ボタンをクリックします。

プロセスインスタンス再実行の実行確認ダイアログが表示されます。

［OK］ボタンをクリックします。

プロセスインスタンスが再実行され，プロセスインスタンス再実行の実行結果ダイアログが表示されます。

［OK］ボタンをクリックします。

検索結果一覧が更新されます。再実行に失敗した場合も，一覧は更新されます。

(b)　注意事項

HCSCサーバで処理中のプロセスインスタンスに対しては，再実行しないでください。再実行する場合は，HCSCサーバからの応答やメッセージログでエラーの内容を確認し，エラーの原因を取り除いてから，プロセスインスタンスを再実行してください。

(2)　コマンドによるプロセスインスタンスの再実行

(a)　1件ずつ再実行する場合

コマンドによってプロセスインスタンスを1件ずつ再実行する手順を次に示します。

アクセスするHCSCサーバを決定します。

cscpiselectコマンドで，次のアクティビティを含むプロセスインスタンスを検索します。

状態が「実行中」または「エラー発生」のサービス呼出アクティビティ

状態が「実行中」の待機アクティビティ

状態が「実行中（待ち受け）」，「エラー発生」または「完了（待ち受け）」のスコープアクティビティ

状態が「完了（待ち受け）」の応答アクティビティ

再実行対象のプロセスインスタンスのプロセスID，およびビジネスプロセス定義名を特定します。

次のコマンドを実行して再実行します。

cscpireexec -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> ｛-processid <プロセスID>｜-processidfile <プロセスIDファイル名>｝※ ｛-processnamefile <ビジネスプロセス定義ファイル名>｜-processname <ビジネスプロセス定義名>｝※

注※

どちらか1つを指定します。

（例）次の条件でコマンドを入力して，プロセスインスタンスを再実行します。

再実行対象のプロセスID：J2EEServer_010210084218_Helloビジネスプロセス_1237946140968_3843192274_138

ビジネスプロセス定義名：Helloビジネスプロセス

アクセスするHCSCサーバ：HCSC

コマンド

cscpireexec -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -processidfile process_id.txt -processname Helloビジネスプロセス

process_id.txtの内容

J2EEServer_010210084218_Helloビジネスプロセス_1237946140968_3843192274_138

出力結果

cscpireexecコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscpireexec（プロセスインスタンスの再実行）」を参照してください。

(b)　ビジネスプロセス定義名を指定して一括再実行する場合

ビジネスプロセス定義名を指定して，プロセスインスタンスを一括再実行する手順を次に示します。

アクセスするHCSCサーバを決定します。

再実行対象のプロセスインスタンスのビジネスプロセス定義名を特定します。

次のコマンドを実行して再実行します。

cscpireexec -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> ｛-processname <ビジネスプロセス定義名>｜-processnamefile <ビジネスプロセス定義ファイル名>｝※

注※

どちらか1つを指定します。

（例）次の条件でコマンドを入力して，プロセスインスタンスを一括して再実行します。

ビジネスプロセス定義名：Helloビジネスプロセス

アクセスするHCSCサーバ：HCSC

コマンド

cscpireexec -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -processname Helloビジネスプロセス

cscpireexecコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscpireexec（プロセスインスタンスの再実行）」を参照してください。

(c)　再実行の対象となるすべてのプロセスインスタンスを一括再実行する場合

再実行の対象となるすべてのプロセスインスタンスを一括再実行する手順を次に示します。

アクセスするHCSCサーバを決定します。

次のコマンドを実行して再実行します。

cscpireexec -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -all

（例）次の条件でコマンドを入力して，再実行の対象となるすべてのプロセスインスタンスを一括して再実行します。

アクセスするHCSCサーバ：HCSC

コマンド

cscpireexec -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -all

cscpireexecコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscpireexec（プロセスインスタンスの再実行）」を参照してください。

(d)　HCSCサーバを指定してプロセスインスタンスを一括再実行する場合

再実行の対象となるHCSCサーバを指定して，対象となるプロセスインスタンスを一括再実行する手順を次に示します。

アクセスするHCSCサーバを決定します。

次のコマンドを実行して再実行します。

cscpireexec -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -all -targetcsc <再実行対象となるHCSCサーバの名称> [-status <再実行の条件となるアクティビティの状態>]

（例1）次の条件でコマンドを入力して，対象となるプロセスインスタンスを一括して再実行します。

アクセスするHCSCサーバ：HCSC1

再実行の対象となるHCSCサーバ：HCSC2

コマンド

cscpireexec -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC1 -all -targetcsc HCSC2

cscpireexecコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscpireexec（プロセスインスタンスの再実行）」を参照してください。

（例2）次の条件でコマンドを入力して，対象となるプロセスインスタンスを一括して再実行します。

アクセスするHCSCサーバ：HCSC1

再実行の対象となるHCSCサーバ：HCSC2

再実行の対象となる状態：「実行中」，「実行中（待ち受け）」，「完了（待ち受け）」

コマンド

cscpireexec -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC1 -all -targetcsc HCSC2 -status executing,executingwait,completedwait

(e)　注意事項

HCSCサーバで処理中のプロセスインスタンスに対しては，再実行しないでください。再実行する場合は，HCSCサーバからの応答やメッセージログでエラーの内容を確認し，エラーの原因を取り除いてから，プロセスインスタンスを再実行してください。

再実行の対象となるプロセスインスタンスが存在しない場合は，コマンドは異常終了します。

(3)　プロセスインスタンス再実行時の応答電文の出力

プロセスインスタンスを再実行した結果，成功した場合もSOAPフォルトの発生で失敗した場合も，プロセスインスタンスから応答電文を受け取ることがあります。このような場合，HCSC-Manager定義ファイルに次に示す内容を設定して，応答電文をファイルに出力できます。

cscmng.pireexec.response.dir=応答電文格納ディレクトリ
cscmng.pireexec.response.encoding=応答電文格納文字コード

HCSC-Manager定義ファイルの作成については，「2.4.1(1)　HCSC-Manager定義ファイルの格納ディレクトリ」を，HCSC-Manager定義ファイルの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.5.3　HCSC-Manager定義ファイル」を参照してください。

なお，プロセスIDは長い文字列（最大240文字）になる可能性があります。応答電文出力ディレクトリに深いディレクトリ階層を設定すると，ファイルを生成できない場合があるため注意してください。再実行しても，応答電文ファイルが生成されない場合はメッセージが出力されます。

(4)　SOAPフォルトの発生時の情報

プロセスインスタンスの再実行がSOAPフォルトの発生で失敗した場合，プロセスインスタンスから受け取るSOAPフォルト情報の種類と取り扱いを次に示します。

フォルトコード：エラーメッセージに表示されます。

フォルト文字列：エラーメッセージに表示されます。

フォルト生成者：エラーメッセージに表示されます。

フォルト詳細：再実行成功時の応答電文と同様に，応答電文格納用ディレクトリにファイル出力されます。ただし，出力エンコードはUTF-8だけとなります。

6.2　実行履歴情報テーブルの管理

プロセスインスタンスの実行履歴は日々増大していくため，管理者はバックアップを取得したり，実行履歴情報テーブルのレコードを削除したりして管理する必要があります。

6.2.1　実行履歴情報テーブルのバックアップを取得する

(1)　HiRDBを使ったバックアップの取得

HiRDBのデータベース複写ユティリティ（pdcopy）を使用して，定期的に実行履歴情報テーブルのバックアップを取得できます。また，データベース回復ユティリティ（pdrstr）を使用してデータベースを回復できます。HiRDBのデータベース複写ユティリティ（pdcopy）を使用したデータベースのバックアップと回復について，次の図に示します。

図6‒2　HiRDBを使ったデータベースのバックアップと回復

HiRDBを使ってバックアップを取得する場合は，HiRDBのデータベース複写ユティリティ（pdcopy）の-Mオプションでバックアップ取得モードを選択します。HCSCサーバが稼働中か停止中かで，選択するモードが異なります。

HCSCサーバ稼働中

更新可能モード（s）を選択します。

更新可能モードを選択すると，バックアップ取得中に，バックアップ対象RDエリアを参照および更新できます。

バックアップ取得時点には，バックアップ取得時点以降の任意の同期点へ回復できます。データベースを回復するには，バックアップおよびバックアップ取得直前のシンクポイントからのシステムログが必要です。

HCSCサーバ停止中（メンテナンス中など）

参照可能モード（r），または参照・更新不可能モード（x）を選択します。

参照可能モードを選択すると，バックアップ取得中に，バックアップ対象RDエリアを参照だけできますが，更新はできません。

参照・更新不可能モードを選択すると，バックアップ取得中に，バックアップ対象RDエリアの参照も更新もできません。バックアップを取得する前に，対象RDエリアをHiRDBのpdhold -cコマンドで閉塞かつクローズ状態にする必要があります。

これらのモードで取得したバックアップを使用すれば，データベースをバックアップ取得時点に回復できます。また，システムログを使用すれば，バックアップ取得時点以降の任意の同期点に回復できます。

HiRDBのデータベース複写ユティリティ（pdcopy），データベース回復ユティリティ（pdrstr），およびバックアップ取得モードについては，マニュアル「HiRDB 解説」を参照してください。

(2)　Oracleを使ったバックアップの取得

OracleのRecovery Manager（RMAN）機能を使用して，定期的に実行履歴情報テーブルのバックアップを取得できます。前回のバックアップからの差分をバックアップできます。詳細については，製品が提供するマニュアルを参照してください。

6.2.2　実行履歴情報テーブルのバックアップ取得の運用

プロセスインスタンスが実行されるたびに実行履歴は増え，データベースの容量は圧迫されます。HCSCサーバ稼働中に実行履歴情報テーブルのバックアップを取得する場合，バックアップ取得後も，実行履歴情報テーブル中のレコードは残ります。

そのため，テーブルのバックアップの取得，実行履歴の削除，およびデータベースのテーブルの再編成を定期的に実施することによって，ディスク容量の枯渇，およびデータベースの増大に対処できます。手順を次に示します。

HiRDBのデータベース複写ユティリティ（pdcopy）を利用して，実行テーブルの差分バックアップを取得します。

プロセスインスタンスの実行履歴をcscpideleteコマンドで削除します。

HiRDBのデータベース再編成ユティリティ（pdrorg）を利用して，データベースのテーブルを再編成します。

実行履歴の追加や削除を繰り返すと，データの格納効率が悪くなり性能が低下します。これを防ぐために，定期的にpdrorgコマンド（データベース再編成ユティリティ）で表を再編成してください。なお，実行履歴情報テーブルにはインデクスが定義されているため，インデクスも再作成する必要があります。

HiRDBの表の再編成に関する詳細については，マニュアル「HiRDB システム運用ガイド」を，pdrorgコマンドの詳細については，マニュアル「HiRDB コマンドリファレンス」を参照してください。

定期的にバックアップ，および削除する間隔は，ユーザ業務の内容によって異なるため，運用管理者が対処する必要があります。

実行履歴情報テーブルのバックアップとレコード削除の運用例を次の図に示します。

図6‒3　実行履歴情報テーブルのバックアップとレコード削除の運用例

説明

実行履歴情報テーブルのバックアップを取得します（1回目のバックアップ）。

2回目のバックアップでは，1回目のバックアップ以降との差分のバックアップを取得します。

実行履歴の検索コマンドで，削除対象となる，ある日時以前の履歴またはある状態のプロセスインスタンスの実行履歴を検索します（例では，過去50日より古いレコードを検索します）。

バックアップ取得後，実行履歴削除コマンドで古いレコードを削除します（例では，過去50日より古いレコードを削除します）。

テーブルを再編成します。

3回目のバックアップでは，2回目のバックアップ以降との差分のバックアップを取得します。

実行履歴の検索コマンドで，削除対象となる，ある日時以前の履歴またはある状態のプロセスインスタンスの実行履歴を検索します（例では，過去50日より古いレコードを検索します）。

バックアップ取得後，実行履歴削除コマンドで古いレコードを削除します（例では，過去50日より古いレコードを削除します）。

テーブルを再編成します。

4回目のバックアップでは，3回目のバックアップ以降との差分のバックアップを取得します。

実行履歴の検索コマンドで，削除対象となる，ある日時以前の履歴やある状態のプロセスインスタンスを検索します（例では，過去50日より古いレコードを検索します）。

バックアップ取得後，実行履歴削除コマンドで古いレコードを削除します（例では，過去50日より古いレコードを削除します）。

7　障害対策

この章では，システム構築や運用時に発生する障害に対して取得できる情報の種類，および障害の対処方法などについて説明します。

なお，UNIX環境の場合は，ディレクトリ表記中の"¥"を"/"に読み換えてください。

7.1　障害対策の流れ

障害対策に必要な情報を障害発生時に出力させるためには，事前設定が必要な場合があります。詳細については，「7.3　障害情報の取得」を参照してください。

構築中または運用中に障害が発生し環境構築に失敗した場合，次の図に示す手順で障害要因を特定してください。

図7‒1　障害対策の流れ

各手順の説明を次に説明します。

現象の確認

障害解析のために，どのような環境でどのような現象が発生したのか状況を確認します。

確認する項目については，「7.2　障害の種類と障害情報」を参照してください。

障害情報の収集

障害を調査するために取得している障害情報（ログやトレースなど）のうち，必要な障害情報（一次資料および二次資料）を収集します。

一次資料：障害を調査する上で一次判別のために使用

二次資料：一次判別で判明した障害の内容に応じて使用する障害情報

必要な資料については，「7.2　障害の種類と障害情報」を参照してください。

また，障害情報の取得方法については，「7.3　障害情報の取得」を参照してください。障害情報の種類によって，必ず取得されるものと，取得の設定が必要なものとがあるため注意してください。

障害発生個所の特定

収集した障害情報の内容を確認して障害を調査し，障害発生個所を特定します。

エラーメッセージや例外の出力元がサービスリクエスタやサービス部品などのユーザプログラムである場合は，システム開発者に確認し，障害要因の特定および回復をする必要があります。

それ以外の場合は，障害発生時に実行していた操作で次のように分類します。

オペレーション（コマンド操作や運用環境の画面からの操作）実行時の障害

「7.6　オペレーション実行時の障害対策」を参照してください。

サービス部品呼び出し要求時の障害

「7.7　サービス部品呼び出し要求時の障害対策」を参照してください。

HCSCサーバおよびHCSC-Managerが出力するログおよびトレースの見方（出力形式）については，「7.4　出力された障害情報の確認方法」を参照してください。それ以外の前提製品が出力する障害情報については，各製品のマニュアルを参照してください。

障害要因の特定

障害発生個所や障害発生時の操作によって，障害が発生した要因（原因）を特定します。

障害情報の再収集

障害要因を特定できない場合，システム管理者または保守員への連絡に必要な保守情報を収集します。詳細については「7.2　障害の種類と障害情報」を参照してください。

システム管理者または保守員に連絡

システム管理者または保守員に連絡し，一次資料および保守資料を送付します。また，発生した障害などの状況に応じて二次資料を送付します。

回復

障害が発生した要因（原因）を取り除き，正常な動作となるよう回復させて，運用を再開します。

7.2　障害の種類と障害情報

ここでは，障害発生時の状況調査のために必要な資料の種類を示します。

障害を調査するときに必要な情報

取得が必要な資料は，発生した障害の種別によって異なります。ここでは，サービスプラットフォームで想定される障害の種別と，それに応じて取得が必要な資料の一覧を示します。

システム管理者または保守員に連絡するときに必要な情報

障害の内容によっては，システム管理者または保守員に連絡する必要があります。保守員とは，ご購入契約に基づくお問い合わせ窓口のことです。

保守員に連絡するときは，障害を調査するときに必要な情報のほかに，資料の取得が必要になる場合があります。

7.2.1　障害を調査するときに必要な情報

(1)　現象の確認

障害が発生した場合，最初にどのような環境でどのような現象が発生したのか状況を確認，整理します。障害発生時に確認する項目を次の表に示します。

表7‒1　障害発生時に確認する項目

項番

確認する項目

障害を検知したマシン

HCSCサーバ稼働マシン

運用環境稼働マシン

サービスリクエスタ稼働マシン

サービス部品稼働マシン

データベース稼働マシン

1

基本事項

障害の発生時期

いつ（いつから）障害が発生したのかを確認してください。

2

障害発生の直前に実行した操作

どのような操作をしたときに障害が発生したのかを確認してください。

システムのセットアップまたはアンセットアップ時の障害対策については「7.5　システムのセットアップまたはアンセットアップ時の障害対策」を参照してください。

3

障害を検知したマシン

どのマシンで障害を検知したのかを確認してください。

HCSCサーバ稼働マシン

運用環境稼働マシン

サービスリクエスタ稼働マシン

サービス部品稼働マシン

データベース稼働マシン

4

障害内容

どのような現象が発生したのかを具体的に挙げてください。

HCSCサーバ障害発生後の回復方法については「7.9　HCSCサーバ障害発生後の回復方法」を参照してください。

5

動作環境

Service Platformのバージョン

○

−

−

−

−

6

J2EEサーバ製品名とバージョン

−

−

○

○

−

7

データベース製品名とバージョン

−

−

−

−

○

8

OSの種類とバージョン

○

○

○

○

○

9

プロセッサ数

○

○

○

○

○

10

メモリ

○

○

○

○

○

11

仮想メモリ

○

○

○

○

○

12

Javaバージョン

○

○

○

○

○

13

パッチの適用状況

○

○

○

○

○

14

再現性

再現性

再現性があるかどうかを確認してください。

15

発生頻度

再現性がある場合，どのくらいの頻度で障害が発生するかを確認してください。

16

構成変更

発生時の変更有無

該当する障害が発生するようになる前に，コーディングや環境などを変更したかどうかを確認してください。

17

変更個所の内容

変更した場合，変更内容を具体的に挙げてください。

（凡例）

○：確認が必要です。

−：確認は不要です。

(2)　収集が必要な障害情報

サービスプラットフォームで障害を調査するには，障害種別に応じて次の表に示す情報が必要です。

注意事項

障害情報の取得には，事前に設定が必要な場合があるため注意してください。障害情報の取得の詳細については「7.3　障害情報の取得」を参照してください。また，取得した障害情報が出力される場所については，「7.3　障害情報の取得」および「7.4　出力された障害情報の確認方法」を参照してください。

なお，障害情報の取得を設定していない情報については，障害調査や問い合わせには不要ですが，障害調査の状況に応じて取得が必要になることがあります。

表7‒2　障害調査のために取得している情報

項番

取得する情報

障害種別

ユーザプログラムがエラーメッセージや例外を出力している場合

サービス部品呼び出し要求時の障害の場合

（7.7節）

オペレーション（コマンド操作や運用環境の画面からの操作）実行時の障害の場合

（7.6節）

1

サービスプラットフォームの資料

メッセージログ

○

○

○

2

リクエストトレース

○

○

−

3

性能解析トレース

−

△

−

4

ユーザ電文トレース

△

△

−

5

定義情報

HCSCサーバ構成定義ファイル

−

○

○

6

HCSCサーバセットアップ定義ファイル

−

○

○

7

HCSCサーバランタイム定義ファイル

−

○

○

8

HCSC-Manager定義ファイル

−

○

○

9

HCSC-Managerコマンド共通定義ファイル

−

○

○

10

HCSC-Messagingコマンド共通定義ファイル

−

○

○

11

サービス情報変更定義ファイル

−

△

△

12

ユーザ定義受付ランタイム定義ファイル

−

△

△

13

SOAP Fault動作定義ファイル

−

△

△

14

クライアント定義ファイル

−

△

△

15

J2EEサーバの資料

J2EEサーバ※，リダイレクタ，サーバ管理コマンドのログ

○

○

△

16

運用管理エージェント，運用監視エージェント，Management Serverのログ（統合ログ）

○

△

○

17

DB Connectorのログ（リソースアダプタの稼働ログ）

○

○

○

18

EJBクライアントアプリケーションのログ

○

○

−

19

ユーザログ

○

△

−

20

定義情報

Component Containerの設定ファイル

△

○

○

21

Managerの設定ファイル

△

○

○

22

dbcon-xadisplaynameに設定したDB Connectorの属性情報

△

○

△

23

dbcon-nodisplaynameに設定したDB Connectorの属性情報

△

△

○

24

Reliable Messagingの資料

開始停止メッセージログ

−

△

○

25

J2EEサーバ※のメッセージログ

△

○

○

26

メソッドトレース

△

○

○

27

回線トレース

△

○

○

28

定義情報

Reliable Messagingコンフィグレーションプロパティの設定情報

△

○

○

29

SOAP通信基盤の資料

トレース

△

○

−

30

アプリケーションログ

△

○

−

31

定義情報

共通定義ファイル（SOAP通信基盤）

△

○

−

32

サーバ定義ファイル（SOAP通信基盤）

△

○

−

33

JAX-WSエンジンの資料

トレース

△

○

−

34

アプリケーションログ

△

○

−

35

定義情報

共通定義ファイル（JAX-WSエンジン）

△

○

−

36

HTTP Serverのログおよびトレース

○

△

−

37

データベースの障害情報

HiRDBを使用している場合

HiRDBのログ（HiRDBの定義情報を含む）

−

△

△

38

HiRDBクライアントのログおよびトレース

−

△

△

39

HiRDB Type4 JDBC DriverのExceptionログおよびトレース

−

△

△

40

Oracleを使用している場合

Oracleのログ

−

△

△

41

Oracle JDBC Thin Driverのログ

−

△

△

42

JavaVMの障害情報

JavaVM出力メッセージログ

−

△

△

43

JavaVMのスレッドダンプ

−

△

△

44

JavaVMのGCのログ

−

△

△

（凡例）

○：一次資料です。障害調査の一次判別に使用する資料です。

△：二次資料です。一次判別の結果に応じて必要となる資料です。

−：不要です。

注※

J2EEサーバが出力するログのディレクトリのデフォルトは，<サービスプラットフォームのインストールディレクトリ>¥CC¥server¥public¥ejb¥<J2EEサーバ名>¥logsです。以降，「J2EEサーバのログ出力ディレクトリ」と表記します。

なお，J2EEサーバが出力するログのディレクトリは，usrconf.cfg（J2EEサーバ用オプション定義ファイル）のejb.server.log.directoryキーで変更できます。

7.2.2　システム管理者または保守員に連絡するときに必要な情報

障害発生時で次に示す場合は，システム管理者または保守員に連絡する必要があります。

出力されたエラーメッセージの対処に「保守員に連絡してください。」とある場合

調査しても障害の要因がわからない場合

エラーメッセージの内容や書かれている対処方法に従って対処しても解決できない場合

システム管理者または保守員に連絡するために必要な情報は，「7.2.1　障害を調査するときに必要な情報」で示す情報以外に，障害の種別ごとに表7-3に示す情報が必要です。障害情報の取得を設定していない情報については，障害調査や問い合わせのときに必要ではありませんが，障害調査の状況に応じて取得が必要になることがあります。システム管理者または保守員に連絡するために必要な情報は，障害の発生個所によって異なります。

J2EEサーバが出力するログのディレクトリのデフォルトは，<サービスプラットフォームのインストールディレクトリ>¥CC¥server¥public¥ejb¥<J2EEサーバ名>¥logsです。以降，「J2EEサーバのログ出力ディレクトリ」と表記します。

なお，J2EEサーバが出力するログのディレクトリは，usrconf.cfg（J2EEサーバ用オプション定義ファイル）のejb.server.log.directoryキーで変更できます。

表7‒3　システム管理者または保守員に連絡するために必要な情報

項番

取得する情報

障害種別

ユーザプログラムがエラーメッセージや例外を出力している場合

サービス部品呼び出し要求時の障害の場合

（7.7節）

オペレーション（コマンド操作や運用環境の画面からの操作）実行時の障害の場合

（7.6節）

1

サービスプラットフォームの資料

例外ログ

○

○

○

2

メンテナンスログ

−

−

○

3

インストールログ

−

−

○

4

メソッドトレース

○

○

○

5

保守情報

HCSCサーバリポジトリ情報

−

○

○

6

HCSC-Managerの保守情報

○

○

○

7

HCSCサーバ保持情報

○

○

○

8

J2EEサーバの資料

保守用ログ※1

○

○

○

9

SOAP通信基盤の資料

保守用ログ※2

○

○

○

10

JAX-WSエンジンの資料

保守用ログ※3

○

○

○

11

JavaVMの障害情報

メモリダンプ

○

○

○

（凡例）

○：必要です。

−：不要です。

注※1

J2EEサーバの保守用ログについては，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」を参照してください。

注※2

SOAP通信基盤の保守用ログは，<J2EEサーバのログ出力ディレクトリ>¥WS¥maintenanceに出力されます。このほか，マニュアル「アプリケーションサーバ SOAPアプリケーション開発の手引」の「14.2　障害発生時に取得する資料」を参照して，ログ以外の障害発生時に取得する情報を取得してください。

注※3

JAX-WSエンジンの保守用ログは，<製品の作業ディレクトリ>¥ejb¥<サーバ名称>¥log¥CJW¥maintenanceに出力されます。このほか，マニュアル「アプリケーションサーバ Webサービス開発ガイド」の「39.2　障害発生時に取得する資料」を参照して，ログ以外の障害発生時に取得する情報を取得してください。

7.3　障害情報の取得

障害情報の取得方法について，事前に設定・変更できる事項も含めて説明します。また，障害情報の一部であるログとトレースのファイル出力に関しても説明します。

7.3.1　ログファイルとトレースファイルの出力方式と注意事項

障害情報のうちログファイルやトレースファイルは，ローテーション方式やファイル切り替え方式に基づいて出力されます。サービスプラットフォームが出力するログやトレースで利用できる方式は次のように異なります。

ログの種類

ローテーション方式

出力先ファイルの切り替え方式

ラップアラウンドモード

シフトモード

ファイルサイズで切り替え

ファイルサイズまたは時刻で切り替え

メッセージログ

HCSC-Managerのログ

◎

×

◎

×

統合メッセージログ

◎

○

◎

○

J2EEサーバの稼働ログ

◎

○

◎

○

リクエストトレース

◎

○

◎

○

性能解析トレース

−

−

−

−

ユーザ電文トレース

◎

○

◎

○

アクティビティトレース

◎

×

◎

×

保守用ログ（例外ログなど）

◎

○

◎

○

ユーザ認証情報管理コマンドのメッセージログ

◎

×

◎

×

アカウント情報管理コマンドのメッセージログ

◎

×

◎

×

（凡例）

◎：利用できます（デフォルト）。

○：利用できます。

×：利用できません。

−：該当しません。

次に，ローテーション方式と出力先ファイルの切り替えの概要について説明します。詳細については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「3.2.1　設定できる内容」を参照してください。

(1)　出力ファイルのローテーション方式

ローテーション方式の種類を次に示します。

ローテーション方式

説明

ラップアラウンドモード（デフォルト）

ファイル名にファイルの面数が付加されます。

（例）ログファイル名が「hntrN.log」，ファイル面数が「2」の場合

ログファイル名：「hntr1.log」，「hntr2.log」

シフトモード

ファイル名は固定で，バックアップファイル名にファイルの面数が付加されます。

（例）ログファイル名が「hntr.log」，ファイル面数が「2」の場合

ログファイル名：「hntr.log」（固定）

ログファイルのバックアップファイル名：「hntr1.log」，「hntr2.log」

(2)　出力先ファイルの切り替え方式

ログファイルやトレースファイルは，出力するファイルを一定の基準で切り替えられます。切り替え方式には次の2種類があります。

ファイルサイズで切り替える方法

ファイルサイズが規定値に達したら，出力先ファイルを切り替えます。

ファイルサイズまたは時刻で切り替える方法

次のどちらかを満たしたら，出力先ファイルを切り替えます。

指定時刻に達した

指定したファイルサイズに達した

トレースファイルは適切なファイルサイズになるよう見積もる必要があります。トレースファイルの総ファイルサイズは，次に示す情報を基に算出してください。

1日当たりに受信する電文の件数（単位：件）

トレース情報を保存する期間（単位：日）

算出した総ファイルサイズを基に，1ファイル当たりのトレースファイルサイズやトレース面数を見積もってください。

トレースファイルサイズやトレース面数はHCSCサーバランタイム定義ファイルで設定します。HCSCサーバランタイム定義ファイルの詳細については，マニュアル「サービスプラットフォームリファレンス」の「6.5.6　HCSCサーバランタイム定義ファイル」を参照してください。

(3)　ログおよびトレース取得時の注意事項（全般的な注意事項）

性能解析トレース以外のすべてのログやトレースでは，次に示す注意事項があります。

ファイルの編集はできません。

テキストビューワやエディタに，ロックするオプションがある場合は，使用できません。ファイルをロックした場合，トレースが出力されなくなる可能性があります。

ファイルのアクセス権限は変更できません。

手動でアクセス権限を設定する必要がある場合には，適切なアクセス権限を設定してください。適切なアクセス権限が与えられていない場合，トレースを出力できなくなります。

ファイルの更新時刻は変更できません。

ファイルの更新時刻を変更した場合，出力先ファイルが変わる可能性があります。

トレース出力中に，ファイルを名称変更したり，削除したりしないでください。

管理ファイルの情報を基に出力先ファイルを決められますが，管理ファイルがない場合，および管理ファイルが破壊されている場合には，ファイルの更新時刻を基に判定されます。ファイルの名称変更，または削除は，すべてのトレース出力プロセスを停止してから実行してください。

(4)　ログおよびトレース取得時の注意事項（HCSC-Managerのログに関する注意事項）

メッセージ末尾の改行コードは，プラットフォームに関係なく「CR+LF」になります。

例外ログ，およびメンテナンスログの場合は，さらに次に示す注意事項があります。

ファイルサイズ/面数の変更を有効にするためには，ファイルの削除が必要です。ファイルを削除する場合には，トレース出力プロセスを停止してください。対象のファイルは，HCSC-Manager定義ファイルのプロパティcscmng.log.dirに指定したディレクトリ以下のファイルです。

出力したトレースファイルは，最初のEOF文字（0x1A）が現れるまでが有効なデータです。EOF文字以降のデータについては，一切保証されません。最初のEOF文字以降にもEOF文字が現れる可能性があるため，注意が必要です。

トレースを出力してもファイルの更新時刻の更新は保証されません。ファイルの更新時刻を基に，トレースが出力されたかどうかを判定できません。トレース出力終了時にはファイルの更新時刻が更新されます。

7.3.2　障害情報の取得方法（サービスプラットフォーム）

サービスプラットフォームが出力するメッセージログ，トレース，および各種情報の取得方法について説明します。また，事前に必要な設定についても説明します。出力された障害情報の確認方法については，「7.4　出力された障害情報の確認方法」を参照してください。

(1)　メッセージログの取得方法

メッセージログは必ず出力されます。なお，メッセージログを出力するファイルのサイズや面数は，必要に応じて変更できます。

出力されたメッセージログの確認方法については，「7.4.1　メッセージログ」を参照してください。

(a)　HCSC-Managerのログ

HCSC-Manager定義ファイルで次のパラメタを指定します。

cscmng.log.message.filesize=メッセージログファイルサイズ

cscmng.log.message.filenum=メッセージログファイル面数

HCSC-Manager定義ファイルの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.5.3　HCSC-Manager定義ファイル」を参照してください。

(b)　統合メッセージログ

統合メッセージログは，manager.cfg（Managerログ設定ファイル）でファイルのサイズ，面数などを指定します。manager.cfgの詳細については，マニュアル「アプリケーションサーバリファレンス 定義編(サーバ定義)」の「8.2.9　manager.cfg（Manager設定ファイル）」を参照してください。

(c)　J2EEサーバの稼働ログ

J2EEサーバの稼働ログは次のように指定します。

ファイルの出力先

HCSCサーバが動作するJ2EEサーバのusrconf.cfg（J2EEサーバ用オプション定義ファイル）のejb.server.log.directoryキーで指定します。デフォルトの出力先は次のとおりです。

<サービスプラットフォームのインストールディレクトリ>¥CC¥server¥public¥ejb¥<J2EEサーバ名>¥logs

usrconf.cfgの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.2　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。

ファイルのサイズ，面数など

HCSCサーバが動作するJ2EEサーバのusrconf.properties（J2EEサーバ用ユーザプロパティファイル）で指定します。

usrconf.propertiesの詳細については，次に示すマニュアルを参照してください。

推奨モードの場合

マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.3　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」

V9互換モードの場合

マニュアル「アプリケーションサーバ 機能解説 互換編」の「10.1.1　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」

(2)　リクエストトレースの取得方法

リクエストトレースを取得する際には，HCSCサーバランタイム定義ファイルの次のプロパティで採取の有無を指定します。

また，出力先パスやファイルのサイズ，およびファイル面数を変更できます。

requesttrace=リクエストトレースの採取の有無（ONを指定します）

requesttrace-filepath=リクエストトレースの出力先パス

requesttrace-filesize=リクエストトレースファイルサイズ

requesttrace-filenum=リクエストトレース面数

出力されたリクエストトレースの確認方法については，「7.4.2　リクエストトレース」を参照してください。また，トレースファイルのローテーション方式などの設定については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」を参照してください。

(3)　性能解析トレースの取得方法

性能解析トレースファイルの取得方法および出力先は，アプリケーションサーバおよびサービスプラットフォーム全体で共通です。出力された性能解析トレースの確認方法については，「7.4.3　性能解析トレース」を参照してください。また，性能解析トレースファイルの取得方法および出力先については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.3　Management Serverを利用した性能解析トレースファイルの収集」を参照してください。

(4)　ユーザ電文トレースの取得方法

ユーザ電文トレースを取得する際には，HCSCサーバランタイム定義ファイルの次のプロパティで採取の有無を指定します。また，出力先パス，ファイルのサイズ，ファイル面数なども変更できます。

telegramtrace=ユーザ電文トレースの採取の有無（ONを指定します）

telegramtrace-filepath=ユーザ電文トレース出力先パス

telegramtrace-filesize=ユーザ電文トレースファイルサイズ

telegramtrace-filenum=ユーザ電文トレース面数

telegramtrace-trigger=ユーザ電文トレースの出力契機

telegramtrace-format＝ユーザ電文トレースの出力形式

さらに，次のプロパティで，正常処理時にユーザ電文トレースを出力するHCSCコンポーネントを指定できます。

telegramtrace-component-type-filepath=ユーザ電文トレースのコンポーネント種別設定ファイルのパス

telegramtrace-component-id-filepath=ユーザ電文トレースのコンポーネントID設定ファイルのパス

出力されたユーザ電文トレースの確認方法については，「7.4.4　ユーザ電文トレース」を参照してください。また，トレースファイルのローテーション方式などの設定については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」を参照してください。

(5)　アクティビティトレースの取得方法

開発環境でアクティビティトレースを出力する場合は，HCSCサーバランタイム定義ファイルの次のプロパティにONを指定します。

bpacttrace=アクティビティトレースの採取の有無（ONを指定します）

また，次のプロパティで，ファイル面数およびファイルサイズの変更や，出力項目の追加を設定できます。

bpacttrace-filenum=ビジネスプロセスのアクティビティトレース面数

bpacttrace-filesize=ビジネスプロセスのアクティビティトレースファイルサイズ

bpacttrace-extend-item={NONE｜PROCESSINSTANCEID}

出力されたアクティビティトレースの確認方法については，「7.4.5　アクティビティトレース」を参照してください。

(6)　デバッグ情報の取得方法

次の機能では，ユーザ電文トレースにデバッグ情報を取得できます。

データ変換API

HCSCサーバで動作するデータ変換

csctransformコマンド

cscbinaryparseコマンド

デバッグ情報の取得方法は，機能ごとに次のように異なります。

(a)　データ変換APIの実行時に出力されるデバッグ情報

データ変換APIの実行時に出力されるデバッグ情報を取得するには，usrconf.properties（J2EEサーバ用ユーザプロパティファイル）の次に示すシステムプロパティを設定してください。これらのシステムプロパティの設定方法については，「2.3.9(8)　データ変換APIの動作を指定する」を参照してください。

csc.dt.debugtrace=デバッグ情報の出力有無（ONを指定します）

csc.dt.debugtrace.filepath=デバッグ情報の出力先パス

csc.dt.debugtrace.filenum=デバッグ情報ファイルの最大面数

csc.dt.debugtrace.filesize=デバッグ情報ファイルの1面当たりの最大サイズ

これによって，csc.dt.debugtrace.filepathプロパティで設定したパスにデバッグ情報が出力されます。ファイルは次のように，データ変換APIのインスタンス（グループ）ごとに異なるファイル名で出力されます。シフトモードの場合はファイル名に<面数>は入りません。

cscdebug_<グループ名>_<面数>.log

それ以外のファイルのローテーション方式や切り替え時刻などの設定方法については，次に示すマニュアルを参照してください。

推奨モードの場合

マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.3　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」，

V9互換モードの場合

マニュアル「アプリケーションサーバ 機能解説 互換編」の「10.1.1　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」

(b)　HCSCサーバでのデータ変換時に出力されるデバッグ情報

HCSCサーバでのデータ変換時に出力されるデバッグ情報を取得するには，HCSCサーバランタイム定義ファイルの次のプロパティで，採取の有無を指定します。

telegramtrace=ユーザ電文トレースの採取の有無（デバッグ情報の採取もONを指定します）

また，次のプロパティで，出力先パス，ファイルのサイズ，ファイル面数および出力契機を指定します。

telegramtrace-filepath=ユーザ電文トレース出力先パス

telegramtrace-filesize=ユーザ電文トレースファイルサイズ

telegramtrace-filenum=ユーザ電文トレース面数

telegramtrace-trigger=ユーザ電文トレースの出力契機（デバッグ情報の出力を示すDTERRを指定します）

telegramtrace-triggerプロパティには複数の値をコンマで区切って指定できるため，ユーザ電文トレースの出力契機と，デバッグ情報の出力契機を同時に指定できます。

デバッグ情報のファイル名を次に示します。シフトモードの場合はファイル名に<面数>は入りません。

csctelegram_<HCSCサーバ名>_<面数>.log

出力されたデバッグ情報の確認方法については，「7.4.6　デバッグ情報」を参照してください。また，トレースファイルのローテーション方式などの設定については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」を参照してください。

(c)　データ変換単体テストコマンドの実行時に出力されるデバッグ情報

データ変換単体テストコマンド（csctransformコマンド，cscbinaryparseコマンド，およびcscgenbinaryコマンド）の実行時に出力されるデバッグ情報を取得するには，各コマンドの実行時（またはコマンドプロパティファイル）で指定します。詳細については次に示す記載個所を参照してください。

項目

記載個所

csctransformコマンド

マニュアル「サービスプラットフォーム リファレンス」の「csctransform（データ変換のテスト）」

データ変換コマンドプロパティファイル（csctransformコマンドのコマンドプロパティファイル）

マニュアル「サービスプラットフォーム リファレンス」の「3.19.1　データ変換コマンドプロパティファイル」

cscbinaryparseコマンド

マニュアル「サービスプラットフォーム リファレンス」の「cscbinaryparse（DOMとバイナリデータの相互変換）」

バイナリパースコマンドプロパティファイル（cscbinaryparseコマンドのコマンドプロパティファイル）

マニュアル「サービスプラットフォーム リファレンス」の「3.19.5　バイナリパースコマンドプロパティファイル」

cscgenbinaryコマンド

マニュアル「サービスプラットフォーム リファレンス」の「cscgenbinary（バイナリフォーマット定義ファイルからバイナリ電文の生成）」

バイナリ電文生成コマンドプロパティファイル（cscgenbinaryコマンドのコマンドプロパティファイル）

マニュアル「サービスプラットフォーム リファレンス」の「3.19.3　バイナリ電文生成コマンドプロパティファイル」

デバッグ情報のファイル名を次に示します。

cscdebug_dtcommand_<面数>.log

出力ファイルの最大面数は16，1面当たりの最大サイズは2147483647バイトです。面数の最大値，最大サイズ，ローテーション方式は変更できません。

(7)　定義情報の取得方法

障害の調査に，サービスプラットフォームに設定した定義が必要になる場合があります。定義の詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.　定義ファイル（運用環境・実行環境）」を参照してください。

(8)　保守情報の取得方法

システム管理者または保守員に連絡するときに必要な保守情報の取得方法を説明します。出力された保守用ログおよびトレースの確認方法については，「7.4.7　保守用ログおよびトレース」を参照してください。

(a)　例外ログ

例外ログは必ず出力されます。なお，出力されるファイルのサイズ，および面数は，変更できます。

例外ログの種類については，「7.4.7(1)　例外ログ」を参照してください。

(b)　メンテナンスログ

メンテナンスログは必ず出力されます。メンテナンスログは，出力されるファイルのサイズ，および面数を変更できます。

HCSC-Manager定義ファイルの次のパラメタを指定します。

cscmng.log.maintenance.filesize=メンテナンスログファイルサイズ

cscmng.log.maintenance.filenum=メンテナンスログファイル面数

HCSC-Manager定義ファイルの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.5.3　HCSC-Manager定義ファイル」を参照してください。また，ログファイルのローテーション方式などの設定については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」を参照してください。

(c)　インストールログ

必ず出力されます。

(d)　メソッドトレース

メソッドトレースは必ず出力されます。メソッドトレースは，出力される出力先やファイルのサイズ，面数，および出力レベルを決める必要があります。HCSCサーバランタイム定義ファイルの次のプロパティを指定します。

HCSCサーバランタイム定義ファイルの次のプロパティを指定します。

methodtrace-filepath=メソッドトレース・例外ログの出力先パス

methodtrace-filesize=メソッドトレースファイルサイズ

methodtrace-filenum=メソッドトレースファイル面数

methodtrace-level=メソッドトレースの出力レベル

HCSCサーバランタイム定義ファイルの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.5.6　HCSCサーバランタイム定義ファイル」を参照してください。また，トレースファイルのローテーション方式などの設定については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」を参照してください。

(e)　保守情報

障害を調査するために必要となる保守情報を次の表に示します。

表7‒4　保守情報

保守情報

対象データの出力先

HCSCサーバリポジトリ情報

<サービスプラットフォームのインストールディレクトリ>¥CSC¥repository配下のすべてのファイルおよびディレクトリ※1

HCSC-Managerの保守情報

<サービスプラットフォームのインストールディレクトリ>¥CSC¥config¥manager配下のすべてのファイルおよびディレクトリ

HCSCサーバ保持情報

<サービスプラットフォームのインストールディレクトリ>¥CSC¥spool配下のすべてのファイルおよびディレクトリ

<サービスプラットフォームのインストールディレクトリ>¥CSC¥system配下のすべてのファイルおよびディレクトリ

HCSCサーバセットアップ定義ファイルのhcscserver-data-filepathプロパティで指定したフォルダ配下の，すべてのファイルおよびディレクトリ※2

注※1

1台のマシンに複数の運用・実行環境を構築（環境変数CSCMNG_HOMEを設定）している場合は，%CSCMNG_HOME%¥repository配下のすべてのファイルおよびディレクトリになります。

注※2

データベースを使用しない構成でHCSCサーバをセットアップした場合に必要となります。

hcscserver-data-filepathプロパティを指定しなかった場合は，<サービスプラットフォームのインストールディレクトリ>¥CSC¥spool¥msg¥配下のすべてのファイルおよびディレクトリになります。

(9)　ユーザ認証情報管理コマンドのメッセージログの取得方法

次に示すユーザ認証情報管理コマンドを実行すると，ユーザ認証情報管理コマンドのメッセージログに実行時の情報（通知・エラーなど）がメッセージとして出力されます。

csakeyaddコマンド（公開鍵認証の秘密鍵情報の登録・更新）

csakeydelコマンド（公開鍵認証の秘密鍵情報の削除）

csakeylsコマンド（公開鍵認証の秘密鍵情報の表示）

csauseraddコマンド（パスワード認証のユーザ情報の登録・更新）

csauserdelコマンド（パスワード認証のユーザ情報の削除）

csauserlsコマンド（パスワード認証のユーザ情報の表示）

このメッセージログを参照することで，過去に実行したコマンドの障害情報や稼働情報を確認できます。

ユーザ認証情報管理コマンドのメッセージログは，ユーザ認証情報管理コマンド定義ファイルで，ファイルのサイズや面数などを指定します。

authinfo.command.messagelog.filesize=メッセージログファイルサイズ

authinfo.command.messagelog.filenum=メッセージログファイル面数

出力されたユーザ認証情報管理コマンドのメッセージログの確認方法については，「7.4.8　ユーザ認証情報管理コマンドのメッセージログ」を参照してください。ユーザ認証情報管理コマンド定義ファイルの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.20.1　ユーザ認証情報管理コマンド定義ファイル」を参照してください。

(10)　アカウント情報管理コマンドのメッセージログの取得方法

次に示すアカウント情報管理コマンドを実行すると，アカウント情報管理コマンドのメッセージログに実行時の情報（通知・エラーなど）がメッセージとして出力されます。

csahttpuseraddコマンド（HTTPアダプタで使用するアカウント情報の登録・更新）

csahttpuserdelコマンド（HTTPアダプタで使用するアカウント情報の削除）

csahttpuserlsコマンド（HTTPアダプタで使用するアカウント情報の表示）

このメッセージログを参照することで，過去に実行したコマンドの障害情報や稼働情報を確認できます。

アカウント情報管理コマンドのメッセージログは，アカウント情報管理コマンド定義ファイルで，出力先ディレクトリ，ファイルのサイズおよび面数を指定します。

authinfo.command.messagelog.filepath=メッセージログファイルの出力先ディレクトリの絶対パス

authinfo.command.messagelog.filesize=メッセージログファイルサイズ

authinfo.command.messagelog.filenum=メッセージログファイル面数

出力されたアカウント情報管理コマンドのメッセージログの確認方法については，「7.4.9　アカウント情報管理コマンドのメッセージログ」を参照してください。アカウント情報管理コマンド定義ファイルの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.20.2　アカウント情報管理コマンド定義ファイル」を参照してください。

7.3.3　障害情報の取得方法（サービスプラットフォーム以外の前提製品）

サービスプラットフォーム以外の主な前提製品が出力する障害情報について，取得方法の概略を説明します。障害情報の詳細や，ログファイルおよびトレースファイルの見積もりについては，各製品のマニュアルを参照してください。

(1)　J2EEサーバが出力する障害情報の取得方法

J2EEサーバが出力するログのディレクトリのデフォルトは，<サービスプラットフォームのインストールディレクトリ>¥CC¥server¥public¥ejb¥<J2EEサーバ名>¥logsです。以降，「J2EEサーバのログ出力ディレクトリ」と表記します。なお，J2EEサーバが出力するログのディレクトリは，usrconf.cfg（J2EEサーバ用オプション定義ファイル）のejb.server.log.directoryキーで変更できます。

(a)　障害情報の種類と取得方法

障害が発生した際，サービスプラットフォームが出力するログやトレースで障害要因の特定が困難な場合は，次に示すJ2EEサーバが出力する障害情報が必要になります。

J2EEサーバ，リダイレクタ，サーバ管理コマンドのログ

運用管理エージェント，運用監視エージェント，Management Serverのログ

DB Connectorのログ

EJBクライアントアプリケーションのログ

ユーザログ

保守用ログ

J2EEサーバが出力する障害情報は，次のコマンドを使って一括して取得できます（手動で取得できます）。なお，一括して取得した場合，サービスプラットフォームが出力するログやトレースと一部重複する情報もあります。障害情報の取得方法の詳細については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」を参照してください。

snapshotlogコマンド

snapshotlogコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「snapshotlog（snapshotログの収集）」を参照してください。

mngsvrutilコマンド（サブコマンドにcollect snapshotを指定）

mngsvrutilコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「mngsvrutil（Management Serverの運用管理コマンド）」を参照してください。

これらのコマンドを実行すると，次のディレクトリ下の情報を取得します。

<サービスプラットフォームのインストールディレクトリ>¥CC¥server¥public¥ejb¥*¥logs¥csc

<サービスプラットフォームのインストールディレクトリ>¥CC¥server¥public¥ejb¥*¥logs¥csc¥maintenance

<サービスプラットフォームのインストールディレクトリ>¥CSC¥config¥manager

<サービスプラットフォームのインストールディレクトリ>¥CSC¥config¥msg

<サービスプラットフォームのインストールディレクトリ>¥CSC¥log¥manager

<サービスプラットフォームのインストールディレクトリ>¥CSC¥repository

<サービスプラットフォームのインストールディレクトリ>¥CSC¥spool

<サービスプラットフォームのインストールディレクトリ>¥CSC¥system¥msg

なお，取得する情報はsnapshotログ収集対象定義ファイルで指定します。必要に応じてsnapshotログ収集対象定義ファイルを変更し，取得する情報を変更してください。snapshotログ収集対象定義ファイルの詳細については，マニュアル「アプリケーションサーバリファレンス 定義編(サーバ定義)」の「10.2.1　snapshotログ収集対象定義ファイル」を参照してください。

(b)　運用開始前の準備

コマンドを使って一括取得する場合，取得する障害情報の種類（Path）をあらかじめ定義しておく必要があります。メールなどで早急に送付する一次送付資料と，別途送付する二次送付資料のそれぞれを指定します。詳細は，マニュアル「アプリケーションサーバ機能解説 保守／移行編」の「2.4　取得が必要な資料の種類」を参照してください。

(c)　障害調査に必要な定義ファイル

障害を調査するために，J2EEサーバに設定した定義が必要になる場合があります。サービスプラットフォーム以外の定義ファイルを次の表に示します。

表7‒5　サービスプラットフォーム以外の定義ファイル

定義ファイル

説明

Component Containerの設定ファイル※1

<サービスプラットフォームのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<J2EEサーバ名>¥ディレクトリ配下のすべてのファイルおよびディレクトリ

Managerの設定ファイル※1

<サービスプラットフォームのインストールディレクトリ>¥manager¥config¥ディレクトリ配下のすべてのファイルおよびディレクトリ

dbcon-xadisplaynameに設定したDB Connectorの属性情報※2

「3.1.2(8)　DB Connectorのセットアップ（Reliable Messagingを使用する場合）」で設定した定義ファイル

dbcon-nodisplaynameに設定したDB Connectorの属性情報※2

注※1

定義の詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」を参照してください。

注※2

定義の詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1　Connector属性ファイル」を参照してください。

(2)　Reliable Messagingが出力する障害情報の取得方法

次に示す受付やサービスアダプタを使用している場合は，Reliable Messagingが出力する障害情報を取得することで障害要因の特定ができます。

非同期（MDB（WS-R））の標準受付

非同期（MDB（DBキュー））の標準受付

MDB（WS-R）アダプタ

MDB（DBキュー）アダプタ

Reliable Messagingが出力する障害情報の取得方法の詳細については，マニュアル「Reliable Messaging」の「9.1　障害時の出力情報概要」を参照してください。

(a)　Reliable Messagingが出力するメッセージ

Reliable Messagingが出力するメッセージは，次のログに出力されます。ログには，開始停止メッセージログとJ2EEサーバのメッセージログの2種類があります。Reliable Messagingが出力するメッセージを次の表に示します。

表7‒6　Reliable Messagingが出力するメッセージの出力先となるログ

ログの種類

出力内容

ディレクトリおよびファイル名

開始停止メッセージログ

開始や停止についての情報，およびユーザが指定したプロパティの値

ディレクトリ

<J2EEサーバのログ出力ディレクトリ>¥connectors¥

ファイル名

<Reliable Messagingの表示名><面番号>.log

J2EEサーバのメッセージログ

Reliable Messagingの開始，停止および動作中の情報

ディレクトリ

<J2EEサーバのログ出力ディレクトリ>

ファイル名

サービスプラットフォームが出力するメッセージログと同一のファイルに出力されます。

(b)　HCSCサーバとReliable Messagingのトレースとの関係

HCSCサーバとReliable Messagingのトレースとの関係は，ローカルキューや転送キューを使用する場合と，共用キューを使用する場合とで異なります。

ローカルキューや転送キューを使用する場合

Reliable Messagingのトレースには，メソッドトレースと回線トレースの2種類があります。メソッドトレースは，エラー情報（例外発生原因）およびメソッドの入口情報，出口情報，デバッグ情報を出力します。回線トレースは，キュー間転送でやり取りされる電文の情報を出力します。ローカルキューや転送キューを使用する場合のトレース取得ポイントを次の図に示します。

図7‒2　ローカルキューや転送キューを使用する場合のトレース取得ポイント

トレース取得ポイントとファイル名の関係を次の表に示します。表の「図中の番号」は，「図7-2　ローカルキューや転送キューを使用する場合のトレース取得ポイント」中の番号と対応しています。

表7‒7　トレース取得ポイントとファイル名の関係

図中の番号

取得ポイント

トレース

種類

出力マシン

出力先

ファイル名

1

サービスリクエスタから転送キューに要求を出すとき

メソッドトレース

サービスリクエスタ稼働マシン側

<J2EEサーバのログ出力ディレクトリ>¥RM¥maintenance

mtd_<サービスリクエスタ側Reliable Messagingのディスプレイ名>_<数字>.log

2

サービスリクエスタ側の転送キューからHCSCサーバ側のローカルキューに転送するとき

回線トレース

lin_<サービスリクエスタ側Reliable Messagingのディスプレイ名>_<数字>.log

3

サービスリクエスタ側の転送キューからHCSCサーバ側のローカルキューへの転送を受け取るとき，またはHCSCサーバ側の転送キューからサービス部品側のローカルキューに転送するとき

回線トレース

HCSCサーバ稼働マシン側

<J2EEサーバのログ出力ディレクトリ>¥RM¥maintenance

lin_<HCSCサーバ側Reliable Messagingのディスプレイ名>_<数字>.log

4

HCSCサーバがローカルキューからメッセージを取り出すとき，またはサービスアダプタから転送キューに要求を出すとき

メソッドトレース

mtd_<HCSCサーバ側Reliable Messagingのディスプレイ名>_<数字>.log

5

HCSCサーバ側の転送キューからサービス部品側のローカルキューへの転送を受け取るとき

回線トレース

サービス部品稼働マシン側

<J2EEサーバのログ出力ディレクトリ>¥RM¥maintenance

lin_<サービス部品側Reliable Messagingのディスプレイ名>_<数字>.log

6

サービス部品がローカルキューからメッセージを取り出すとき

メソッドトレース

mtd_<サービス部品側Reliable Messagingのディスプレイ名>_<数字>.log

共用キューを使用する場合

Reliable Messagingのトレースには，メソッドトレースと共用キューイベントトレースの2種類があります。メソッドトレースは，エラー情報（例外発生原因）およびメソッドの入口情報，出口情報，デバッグ情報を出力します。共用キューイベントトレースは，共用キューにメッセージが格納されたことを表すイベントの情報を出力します。共用キューを使用する場合のトレース取得ポイントを次の図に示します。

図7‒3　共用キューを使用する場合のトレース取得ポイント

トレース取得ポイントとファイル名の関係を次の表に示します。表の「図中の番号」は，「図7-3　共用キューを使用する場合のトレース取得ポイント」中の番号と対応しています。

表7‒8　トレース取得ポイントとファイル名の関係

図中の番号

取得ポイント

トレース

種類

出力マシン

出力先

ファイル名

1

サービスリクエスタ側からHCSCサーバ側の受信用共用キューへメッセージが格納されたとき，またはHCSCサーバのサービスアダプタから送信用共用キューへメッセージが格納されたとき

共用キューイベントトレース

HCSCサーバ稼働マシン側

<J2EEサーバのログ出力ディレクトリ>¥RM¥maintenance

shq_<HCSCサーバ側Reliable Messagingのディスプレイ名>_<数字>.log

2

HCSCサーバがローカルキューからメッセージを取り出すとき，またはサービスアダプタから転送キューに要求を出すとき

メソッドトレース

mtd_<HCSCサーバ側Reliable Messagingのディスプレイ名>_<数字>.log

(c)　運用開始前の準備

メソッドトレースや回線トレースの出力レベルを変更して，出力する情報の種類を変更する場合は，HCSCサーバ起動前のReliable Messagingの設定で変更する必要があります。Reliable MessagingのコンフィグレーションプロパティのRMMethodTraceLevelおよびRMLineTraceLevelで変更します。

(d)　障害調査に必要な定義ファイル

障害を調査するためにReliable Messagingのコンフィグレーションプロパティに対して設定している情報が必要になる場合があります。障害調査に必要なReliable Messagingの定義ファイルを次の表に示します。定義ファイルの詳細については，マニュアル「Reliable Messaging」の「6.　コンフィグレーションプロパティ」を参照してください。

表7‒9　障害調査に必要なReliable Messagingの定義ファイル

定義ファイル

説明

Reliable Messagingコンフィグレーションプロパティの設定情報

「3.1.2(9)　Reliable Messagingのセットアップ」で設定した定義ファイル

(3)　SOAP通信基盤またはJAX-WSエンジンが出力する障害情報の取得方法

同期の標準受付（Webサービス），またはSOAPアダプタを使用している場合は，SOAP通信基盤またはJAX-WSエンジンが出力する障害情報を取得することで障害要因を特定できます。また，サービスリクエスタからHCSCサーバを呼び出すときのSOAPメッセージや，HCSCサーバのサービスアダプタからサービス部品を呼び出すときのSOAPメッセージの電文形式を確認することで，送受信するユーザ電文に誤りがある場合の障害要因を特定できます。

SOAP通信基盤が出力する障害情報の取得方法の詳細については，マニュアル「アプリケーションサーバ SOAPアプリケーション開発の手引」の「14.　障害対策」を参照してください。

JAX-WSエンジンが出力する障害情報の取得方法の詳細については，マニュアル「アプリケーションサーバ Webサービス開発ガイド」の「39.　障害対策」を参照してください。

(a)　HCSCサーバとSOAPのトレースやアプリケーションログの関係

HCSCサーバの構成で，取得ポイントとSOAPのトレースやアプリケーションログのファイル名との関係を説明します。Webサービスの受付からSOAPアダプタを呼び出す場合と，Webサービス以外の受付からSOAPアダプタを呼び出す場合とで異なります。

同期の標準受付（Webサービス）またはSOAP受付からSOAPアダプタを呼び出す場合

同期の標準受付（Webサービス）からSOAPアダプタを呼び出す場合や，SOAP受付からSOAPアダプタを呼び出す場合は，次のような名称でSOAPのトレースやアプリケーションログが出力されます。途中にビジネスプロセスを経由している場合も同様の名称で出力されます。SOAPトレースやアプリケーションログの取得ポイントを次の図に示します。

図7‒4　SOAPトレースやアプリケーションログの取得ポイント（Webサービスの受付からSOAPアダプタを呼び出す場合）

トレース取得ポイントとファイル名の関係を次の表に示します。表の「図中の番号」は，上の図の番号と対応しています。

表7‒10　トレース取得ポイントとファイル名の関係（Webサービスの受付からSOAPアダプタを呼び出す場合）

図中の番号

取得ポイント

ファイル名

トレース※1

アプリケーションログ※1

1※2

サービスリクエスタから要求を出したとき（送信），およびサービスリクエスタへ応答が返ってきたとき（受信）のSOAP通信のトレース

SOAP通信基盤を使用している場合

「<プリフィックス>-j2ee-<J2EEサーバ名>-<数字>.log」

<プリフィックス>※3はサービスリクエスタ側のクライアント定義ファイルで設定。

JAX-WSエンジンを使用している場合

「cjwmessage<数字>.log」

SOAP通信基盤を使用している場合

「<プリフィックス>-j2ee-<J2EEサーバ名>-aplog-<数字>.log」

<プリフィックス>※3はサービスリクエスタ側のクライアント定義ファイルで設定。

JAX-WSエンジンを使用している場合

「cjwtransport<数字>.log」

2

サービスリクエスタから要求をHCSCサーバのリクエスト受付で受け取ったとき（受信），およびHCSCサーバから応答を返したとき（送信）のSOAP通信のトレース

同期の標準受付（Webサービス）の場合

「<クラスタ名>-j2ee-<J2EEサーバ名>-<数字>.log」

SOAP受付の場合

「<受付ID>-j2ee-<J2EEサーバ名>-<数字>.log」

同期の標準受付（Webサービス）の場合

「<クラスタ名>-j2ee-<J2EEサーバ名>-aplog-<数字>.log」

SOAP受付の場合

「<受付ID>-j2ee-<J2EEサーバ名>-aplog-<数字>.log」

3

HCSCサーバのサービスアダプタから要求を出したとき（送信），およびサービスアダプタへ応答が返ってきたとき（受信）のSOAP通信のトレース

図中の番号2と同じトレースファイルに出力します。

図中の番号2と同じアプリケーションログファイルに出力します。

4※2

HCSCサーバのサービスアダプタからの要求をサービス部品側で受け取ったとき（受信），およびサービス部品側から応答を返したとき（送信）のSOAP通信のトレース

SOAP通信基盤を使用している場合

「<プリフィックス>-j2ee-<J2EEサーバ名>-<数字>.log」

<プリフィックス>※3はサービス部品側のサーバ定義ファイルで設定。

JAX-WSエンジンを使用している場合

「cjwmessage<数字>.log」

SOAP通信基盤を使用している場合

「<プリフィックス>-j2ee-<J2EEサーバ名>-aplog-<数字>.log」

<プリフィックス>※3はサービス部品側のサーバ定義ファイルで設定。

JAX-WSエンジンを使用している場合

「cjwmessage<数字>.log」

注※1

トレースおよびアプリケーションログの出力先は，使用している通信基盤によって次のように異なります。

SOAP通信基盤を使用している場合

　各稼働マシン上の <J2EEサーバのログ出力ディレクトリ>¥WS

JAX-WSエンジンを使用している場合

　各稼働マシン上の <J2EEサーバのログ出力ディレクトリ>¥CJW

注※2

サービスリクエスタ稼働マシン側またはサービス部品稼働マシンで，サービスプラットフォームが提供しているSOAP通信基盤またはJAX-WSエンジンを使用している場合に取得できます。

注※3

サーバ定義ファイル（c4websv.cfg）またはクライアント定義ファイル（c4webcl.properties）で，トレースファイルやアプリケーションログのプリフィックス（c4web.logger.<識別子>.log_file_prefix）に設定した名称です。

Webサービス以外の受付からSOAPアダプタを呼び出す場合

同期の標準受付（Webサービス）やSOAP受付以外のリクエスト受付からSOAPアダプタを呼び出す場合は，次のような名称でSOAPトレースやアプリケーションログが出力されます。SOAPトレースやアプリケーションログの取得ポイントを次の図に示します。

図7‒5　SOAPトレースやアプリケーションログの取得ポイント（Webサービス以外の受付からSOAPアダプタを呼び出す場合）

トレース取得ポイントとファイル名の関係を次の表に示します。表の「図中の番号」は，上の図の番号と対応しています。

表7‒11　トレース取得ポイントとファイル名の関係（Webサービス以外の受付からSOAPアダプタを呼び出す場合）

図中の番号

取得ポイント

ファイル名

トレース※1

アプリケーションログ※1

1

HCSCサーバのサービスアダプタから要求を出したとき（送信），およびサービスアダプタへ応答が返ってきたとき（受信）のSOAP通信のトレース

「<サービスID>-j2ee-<J2EEサーバ名>-<数字>.log」※3

「<サービスID>-j2ee-<J2EEサーバ名>-aplog-<数字>.log」※3

2※2

HCSCサーバのサービスアダプタからの要求をサービス部品側で受け取ったとき（受信），およびサービス部品側から応答を返したとき（送信）のSOAP通信のトレース

SOAP通信基盤を使用している場合

「<プリフィックス>-j2ee-<J2EEサーバ名>-<数字>.log」

<プリフィックス>※4はサービス部品側のサーバ定義ファイルで設定。

JAX-WSエンジンを使用している場合

「cjwmessage<数字>.log」

SOAP通信基盤を使用している場合

「<プリフィックス>-j2ee-<J2EEサーバ名>-aplog-<数字>.log」

<プリフィックス>※4はサービス部品側のサーバ定義ファイルで設定。

JAX-WSエンジンを使用している場合

「cjwtransport<数字>.log」

注※1

トレースおよびアプリケーションログの出力先は，使用している通信基盤によって次のように異なります。

SOAP通信基盤を使用している場合

　各稼働マシン上の <J2EEサーバのログ出力ディレクトリ>¥WS

JAX-WSエンジンを使用している場合

　各稼働マシン上の <J2EEサーバのログ出力ディレクトリ>¥CJW

注※2

サービス部品稼働マシンでサービスプラットフォームが提供しているSOAP通信基盤またはJAX-WSエンジンを使用している場合に取得できます。

注※3

サービスアダプタ定義画面で設定したクライアント定義ファイルに，トレースファイルやアプリケーションログのプリフィックスを指定していても，その値は有効になりません。一意なプリフィックスとしてサービスIDが割り当てられます。

注※4

サーバ定義ファイル（c4websv.cfg）で，トレースファイルやアプリケーションログのプリフィックス（c4web.logger.<識別子>.log_file_prefix）に設定した名称です。

(b)　運用開始前の準備

SOAPメッセージのログを取得すると，サービスリクエスタからHCSCサーバを呼び出すときのSOAPメッセージや，HCSCサーバのサービスアダプタからサービス部品を呼び出すときのSOAPメッセージについて，電文形式を確認できます。これによって，送受信するユーザ電文に誤りがある場合の障害要因を特定できます。

ログの出力に関しては，HCSCサーバが稼働するマシンで，次に示す共通定義ファイルに設定します。

SOAP通信基盤の場合：c4webcom.cfg

JAX-WSエンジンの場合：cjwconf.properties

HCSCサーバが稼働するマシンの共通定義ファイルへの設定を次の表に示します。

表7‒12　HCSCサーバが稼働するマシンの共通定義ファイルへの設定

設定項目

キー名称

設定値

（デフォルト）

説明

アプリケーションログ出力の重要度

c4web.logger.aplog_level

WARN

SOAPメッセージのログを採取する（SOAPメッセージの電文形式を確認する）場合，INFOを指定してください。HCSCサーバ起動前にあらかじめ設定する必要があります。

SOAP通信基盤を利用する場合の共通定義ファイルの作成については，マニュアル「アプリケーションサーバ SOAPアプリケーション開発の手引」の「10.4　共通定義ファイルの設定」を参照してください。

JAX-WSエンジンを利用する場合の共通定義ファイルの作成については，マニュアル「アプリケーションサーバ Webサービス開発ガイド」の「10.1.2　共通定義ファイルの設定項目」を参照してください。

(c)　障害調査に必要な定義ファイル

障害を調査するためにSOAP通信基盤およびJAX-WSエンジンの設定情報が必要になる場合があります。SOAP通信基盤の定義ファイルを次の表に示します。

表7‒13　SOAP通信基盤の定義ファイル

定義ファイル

説明

ファイルの格納場所

ファイル名

サーバ定義ファイル

HCSCサーバ稼働マシンのリクエスト受付でのSOAP通信の動作を制御します

HCSCサーバ稼働マシンの次のフォルダ

Windowsの場合

<サービスプラットフォームのインストールディレクトリ>¥c4web¥conf

その他のOSの場合

/opt/Cosminexus/c4web/conf

c4websv.cfg

共通定義ファイル

HCSCサーバ稼働マシンのリクエスト受付およびサービスアダプタに共通のSOAP通信の動作を制御します

HCSCサーバ稼働マシンの次のフォルダ

Windowsの場合

<サービスプラットフォームのインストールディレクトリ>¥c4web¥conf

その他のOSの場合

/opt/Cosminexus/c4web/conf

c4webcom.cfg

SOAP通信基盤を利用する場合のサーバ定義ファイルの詳細については，マニュアル「アプリケーションサーバ SOAPアプリケーション開発の手引」の「10.2　サーバ定義ファイルの設定」を参照してください。SOAP通信基盤を利用する場合の共通定義ファイルの詳細については，マニュアル「アプリケーションサーバ SOAPアプリケーション開発の手引」の「10.4　共通定義ファイルの設定」を参照してください。

JAX-WSエンジンの定義ファイルを次の表に示します。

表7‒14　JAX-WSエンジンの定義ファイル

定義ファイル

説明

ファイルの格納場所

ファイル名

共通定義ファイル

HCSCサーバ稼働マシンのリクエスト受付およびサービスアダプタに共通のSOAP通信の動作を制御します

HCSCサーバ稼働マシンの次のフォルダ

Windowsの場合

<サービスプラットフォームのインストールディレクトリ>¥jaxws¥conf

その他のOSの場合

/opt/Cosminexus/jaxws/conf

cjwconf.properties

JAX-WSエンジンを利用する場合の定義ファイルの詳細については，マニュアル「アプリケーションサーバ Webサービス開発ガイド」の「10.1　動作定義ファイル」を参照してください。

(4)　HTTP Serverが出力する障害情報の取得方法

HTTP Serverを使用して運用する場合，HTTP Serverが出力する障害情報が必要な場合があります。HTTP Serverが出力する障害情報の取得方法の詳細は，マニュアル「HTTP Server」を参照してください。

(5)　データベースが出力する障害情報の取得方法

障害の要因がデータベースにある場合，データベースの障害情報を確認することで，障害要因を特定できます。データベースの障害情報には，サーバ側とクライアント側の情報があります。HCSCサーバ稼働マシンのデータベース（クライアント側）とデータベース（サーバ側）の関係を次の図に示します。

図7‒6　HCSCサーバ稼働マシンのデータベース（クライアント側）とデータベース（サーバ側）の関係

表7‒15　データベースのサーバ側とクライアント側の障害情報

使用しているデータベース

サーバ/クライアント

障害情報

HiRDBを使用している場合

サーバ側の障害情報

HiRDBのログ

%PDDIR%¥SPOOL 配下のファイルすべて

サーバ側の障害情報（定義情報）

HiRDBの定義情報

%PDCONFPATH% 配下のファイルすべて

クライアント側の障害情報

HiRDBクライアントのSQLトレースファイルおよびエラーログファイル

環境変数PDCLTPATHで指定したディレクトリ

（環境変数PDCLTPATHを省略した場合は，次のディレクトリに出力されます。

%PDDIR%¥spool¥hubspool¥外部サーバ名¥）

HiRDBクライアントのSQLトレース環境変数PDSQLTRACEで指定したファイルサイズ

（環境変数PDCLTPATHを省略した場合は，SQLトレースは出力されません）

HiRDB Type4 JDBC DriverのExceptionトレースログ※

環境変数PDJDBFILEDIRで指定したディレクトリ

（環境変数PDJDBFILEDIRを省略した場合は，次のディレクトリに出力されます。

<サービスプラットフォームのインストールディレクトリ>¥CC¥server¥public¥ejb¥<J2EEサーバ名>¥<J2EEサーバ名>excX.trc）

Oracleを使用している場合

サーバ側の障害情報

Oracleのログ

クライアント側の障害情報

Oracle JDBC Thin Driverのログ

注※

HiRDB Type4 JDBC Driverの場合，OSの環境変数やHiRDB.iniに記載しても有効になりません。使用するDB Connectorの属性定義「EnvironmentVariables」に，次に示すようにセミコロンでつないで指定してください。

（例）　PDSQLTRACE=0;PDCLTPATH=c:¥tmp

HiRDBを使用する場合は，マニュアル「HiRDB システム運用ガイド」を参照してください。Oracleを使用する場合は，Oracle Corporationが発行するドキュメントを参照してください。

(6)　JavaVMの情報の取得方法

(a)　JavaVM出力メッセージログ

JavaVMでクラッシュが発生した場合，JavaVMはデバッグ情報を標準出力とエラーリポートファイルに出力します。詳細については，マニュアル「アプリケーションサーバ機能解説 保守／移行編」の「4.11　JavaVM出力メッセージログ（標準出力またはエラーリポートファイル）」を参照してください。エラーリポートファイルの出力先および出力ファイル名は次のとおりです。

Windowsの場合

<サービスプラットフォームのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<J2EEサーバ名>¥hs_err_pid<サーバプロセスのプロセスID>.log

UNIXの場合

<サービスプラットフォームのインストールディレクトリ>/CC/server/usrconf/ejb/<J2EEサーバ名>/hs_err_pid<サーバプロセスのプロセスID>.log

(b)　JavaVMのスレッドダンプ

JavaVMの稼働情報やスレッドのスタック状態が出力されます。詳細については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「4.7　JavaVMのスレッドダンプ」を参照してください。出力先は次のとおりです。

Windowsの場合

<サービスプラットフォームのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<J2EEサーバ名>¥javacore*.txt

UNIXの場合

<サービスプラットフォームのインストールディレクトリ>/CC/server/usrconf/ejb/<J2EEサーバ名>/javacore*.txt

(c)　JavaVMのGCログ

JavaVMのGCの活動状態が出力されます。詳細については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「4.8　JavaVMのGCログ」を参照してください。

(d)　メモリダンプ

システムで障害が発生したときに，システム管理者または保守員が障害を解析するために使用します。詳細については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「4.9　メモリダンプ」を参照してください。

7.4　出力された障害情報の確認方法

運用時に障害が発生した場合は，障害対策に必要な情報がログやトレースとしてファイルに出力されます。

ここでは，サービスプラットフォームで出力されたログやトレースの確認方法について説明します。ログやトレースの取得方法については，「7.3.2　障害情報の取得方法（サービスプラットフォーム）」を参照してください。

7.4.1　メッセージログ

HCSCサーバを操作するときのインフォメーション情報や障害時のエラー情報，および稼働中のHCSCサーバのインフォメーション情報や障害時のエラー情報をメッセージログとして取得します。これによって，障害の発生を検知したり，障害要因を解析したりできます。

サービスプラットフォームのメッセージログには，次の種類があります。

HCSC-Managerのログ

統合メッセージログ

J2EEサーバの稼働ログ

参考

これらのメッセージログ以外に，コマンド実行時に出力されるメッセージログ（コマンドメッセージログ）もあります。ユーザ認証情報管理コマンドの実行時に出力されるメッセージログについては，「7.4.8　ユーザ認証情報管理コマンドのメッセージログ」を参照してください。アカウント情報管理コマンドの実行時に出力されるメッセージログについては，「7.4.9　アカウント情報管理コマンドのメッセージログ」を参照してください。

メッセージログは必ず出力されます。各ログファイルの出力方法の変更については，「7.3.2(1)　メッセージログの取得方法」を参照してください。また，メッセージログに出力されるメッセージの内容の詳細については，マニュアル「サービスプラットフォーム メッセージ」を参照してください。

(1)　HCSC-Managerのログ

HCSC-Managerが出力するメッセージが取得されます。ログの出力先とログファイル名を次の表に示します。

表7‒16　HCSC-Managerのログ

項目

内容

出力先パス

HCSC-Manager定義ファイルのcscmng.log.dirパラメタで指定したパス

ログファイル名

message<面数>.log

(2)　統合メッセージログ

運用管理エージェント，運用監視エージェント，およびManagement Serverなどが出力するメッセージが取得されます。ログの出力先とログファイル名を次の表に示します。

表7‒17　統合メッセージログ

項目

内容

出力先パス

統合メッセージログの出力先に指定されたパス

デフォルトの出力先：

<サービスプラットフォームのインストールディレクトリ>¥manager¥log¥message

ログファイル名

mngmessage<面数>.log

(3)　J2EEサーバの稼働ログ

稼働しているJ2EEサーバが出力するメッセージが取得されます。J2EEサーバ上で稼働しているHCSCサーバが出力するメッセージもこのログに出力します。ログの出力先とログファイル名を次の表に示します。

表7‒18　J2EEサーバの稼働ログ

項目

内容

出力先パス

J2EEサーバの稼働ログの出力先に指定されたパス

デフォルトの出力先：

<サービスプラットフォームのインストールディレクトリ>¥CC¥server¥public¥ejb¥<J2EEサーバ名>¥logs

ログファイル名

ラップアラウンドモードの場合

cjmessage<面数>.log

シフトモードの場合

cjmessage.log

7.4.2　リクエストトレース

HCSCサーバのメッセージング基盤では，次の内容をリクエストトレースとして取得できます。リクエストトレースは，リクエストの障害要因の解析に使用します。

リクエスト受付で受け付けたサービス部品呼び出し要求または応答の結果

ビジネスプロセスを呼び出した時の要求または応答の結果

サービスアダプタからサービス部品を呼び出したときの要求または応答の結果

ここでは，取得されたリクエストトレースの確認方法について説明します。リクエストトレースの取得方法については，「7.3.2(2)　リクエストトレースの取得方法」を参照してください。

(1)　リクエストトレースの出力先

リクエストトレースの出力先を次に示します。

HCSCサーバランタイム定義ファイルのrequesttrace-filepathプロパティで指定したパス

なお，指定したパスが存在しない場合，またはパスが誤っていた場合は，省略値の出力先にトレースが出力されます。

リクエストトレースのトレースファイル名を次の表に示します。

表7‒19　リクエストトレースのトレースファイル名

トレースファイルの出力モード

トレースファイル名

ラップアラウンドモードの場合

cscmsgreq_<HCSCサーバ名>_<面数>.log

シフトモードの場合

cscmsgreq_<HCSCサーバ名>_.log

(2)　リクエストトレースの出力形式と出力される内容

(a)　出力形式

リクエストトレースの出力形式を次の図に示します。

図7‒7　リクエストトレースの出力形式

(b)　出力される内容

リクエストトレースに出力される内容を次の表に示します。

表7‒20　リクエストトレースに出力される内容

項目

内容

番号

トレースレコードの出力通番が表示されます。

日付

トレースレコードの取得日付（yyyy/mm/dd形式）が出力されます。

時刻

トレースレコードの取得時刻（hh:mm:ss.SSS形式）が，ローカル時刻でミリ秒単位に出力されます。

製品ID

製品を特定するための識別子として，メッセージング基盤を示す「CSCMSG」が出力されます。

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID

表示されません。

メッセージ共通ID

リクエスト識別情報（親ID）が出力されます。

サービスリクエストID

リクエスト識別情報（子ID）が出力されます。

取得ポイント識別情報

取得位置

トレースの取得ポイント情報（取得位置）が出力されます。

RCP：標準受付

URCP：ユーザ定義受付

SVSND：サーバ間転送（送信）

SVRCV：サーバ間転送（受信）

BPRCP：ビジネスプロセスリクエスト受付

BPREQ：ビジネスプロセス呼び出し

SVC：サービス部品呼び出し（サービスアダプタ内）

SVCGP：サービスグループ呼び出し

プロトコル種別

トレースの取得ポイント情報（プロトコル種別）が出力されます。ただし，取得位置がBPRCP，BPREQ，またはSVCGPの場合は，表示されません。

SOAP：Webサービス

EJB：SessionBean

WSR：MDB（WS-R）

DBQ：MDB（DBキュー）

CUSTM：上記以外のプロトコル

詳細位置

トレースの取得ポイント情報（詳細位置）が出力されます。

IN：受付

OUT：応答

CAL：呼び出し（他コンポーネント）

RET：応答受信（他コンポーネント）

WRN：例外

名称

トレースの取得ポイント情報（名称）が出力されます。ただし，取得位置がRCP，URCP，BPREQ，またはSVRCVの場合は表示されません。

サーバ名

サービスアダプタのサービスID

ビジネスプロセスのサービスID

サービスグループ名

アダプタ種別

トレースの取得ポイント情報（アダプタ種別）が出力されます。ただし，取得位置がRCP，URCP，BPRCP，SVCGP，SVSND，またはSVRCVの場合は表示されません。

SVA：サービスアダプタ

BP：ビジネスプロセス

結果

応答結果種別が出力されます。ただし，詳細位置がINまたはCALの場合は，表示されません。

正常終了：NORMAL

異常終了：ERROR

付加情報

応答結果の付加情報が出力されます。

CRLF

レコード終端符号が出力されます。

(3)　リクエストトレースの取得ポイント

リクエストトレースの出力契機には次の種類があり，それぞれで取得ポイントが異なります。

単体サービス実行時

ビジネスプロセスサービス実行時

稼働状態確認実行時

(a)　単体サービス実行時

単体サービス実行時のリクエストトレースのトレース取得ポイントを次の図に示します。

図7‒8　リクエストトレースの取得ポイント（単体サービス実行時）

トレース取得ポイントを次の表に示します。表の「図中の番号」は，「図7-8　リクエストトレースの取得ポイント（単体サービス実行時）」中の番号と対応しています。

表7‒21　リクエストトレース取得ポイント（単体サービス実行時）

図中の番号

トレース取得ポイント

1

標準受付（Webサービス）の入口

2

標準受付（Webサービス）の出口

1

標準受付（SessionBean）の入口

2

標準受付（SessionBean）の出口

1

標準受付（MDB（WS-R））の入口

2

標準受付（MDB（WS-R））の出口

1

標準受付（MDB（DBキュー））の入口

2

標準受付（MDB（DBキュー））の出口

3

SOAPアダプタのサービス部品呼び出し口

4

SOAPアダプタのサービス部品応答受信口

3

SessionBeanアダプタのサービス部品呼び出し口

4

SessionBeanアダプタのサービス部品応答受信口

3

MDB（WS-R）アダプタのサービス部品呼び出し口

4

MDB（WS-R）アダプタのサービス部品応答受信口

3

MDB（DBキュー）アダプタのサービス部品呼び出し口

4

MDB（DBキュー）アダプタのサービス部品応答受信口

3

上記以外のサービスアダプタ（CUSTOM）のサービス部品呼び出し口

4

上記以外のサービスアダプタ（CUSTOM）のサービス部品応答受信口

(b)　ビジネスプロセスサービス実行時

ビジネスプロセスサービス実行時のリクエストトレースのトレース取得ポイントを次の図に示します。

図7‒9　リクエストトレースの取得ポイント（ビジネスプロセスサービス実行時）

トレース取得ポイントを次の表に示します。表の「図中の番号」は，「図7-9　リクエストトレースの取得ポイント（ビジネスプロセスサービス実行時）」中の番号と対応しています。

表7‒22　リクエストトレース取得ポイント（ビジネスプロセスサービス実行時）

図中の番号

トレース取得ポイント

1

標準受付（Webサービス）の入口

2

標準受付（Webサービス）の出口

1

標準受付（SessionBean）の入口

2

標準受付（SessionBean）の出口

1

標準受付（MDB（WS-R））の入口

2

標準受付（MDB（WS-R））の出口

1

標準受付（MDB（DBキュー））の入口

2

標準受付（MDB（DBキュー））の出口

1

ユーザ定義受付の入口

2

ユーザ定義受付の出口

7

SOAPアダプタのサービス部品呼び出し口

8

SOAPアダプタのサービス部品応答受信口

7

SessionBeanアダプタのサービス部品呼び出し口

8

SessionBeanアダプタのサービス部品応答受信口

7

MDB（WS-R）アダプタのサービス部品呼び出し口

8

MDB（WS-R）アダプタのサービス部品応答受信口

7

MDB（DBキュー）アダプタのサービス部品呼び出し口

8

MDB（DBキュー）アダプタのサービス部品応答受信口

7

上記以外のサービスアダプタ（CUSTOM）のサービス部品呼び出し口

8

上記以外のサービスアダプタ（CUSTOM）のサービス部品応答受信口

3

ビジネスプロセスサービスの呼び出し口

4

ビジネスプロセスサービスの応答受信口

5

ビジネスプロセス受付の入口

6

ビジネスプロセス受付の出口

(c)　稼働状態確認実行時

稼働状態確認実行時のリクエストトレースのトレース取得ポイントを次の図に示します。

図7‒10　リクエストトレースの取得ポイント（稼働状態確認実行時）

トレース取得ポイントを次の表に示します。表の「図中の番号」は，「図7-10　リクエストトレースの取得ポイント（稼働状態確認実行時）」中の番号と対応しています。

表7‒23　リクエストトレース取得ポイント（稼働状態確認実行時）

図中の番号

トレース取得ポイント

1

標準受付（Webサービス）の入口

2

標準受付（Webサービス）の出口

1

SOAP受付の入口

2

SOAP受付の出口

7.4.3　性能解析トレース

性能解析トレース（PRFトレース）は，サービスプラットフォームシステムの性能解析をするためのトレース情報です。それをCSV形式で編集出力したテキストファイルが性能解析トレースファイルです。

性能解析トレースには，J2EEアプリケーションを含めた，システム全体の性能ボトルネックを解析するための情報が出力されます。システムの性能ネックや性能トラブルシュートに使用します。性能解析トレース機能については，マニュアル「アプリケーションサーバ機能解説 保守／移行編」の「7.　性能解析トレースを使用した性能解析」を参照してください。

ここでは，取得された性能解析トレースの確認方法について説明します。性能解析トレースの取得方法については，「7.3.2(3)　性能解析トレースの取得方法」およびマニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.3　Management Serverを利用した性能解析トレースファイルの収集」を参照してください。

(1)　性能解析トレースの出力先

性能解析トレースの出力先については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.3　Management Serverを利用した性能解析トレースファイルの収集」を参照してください。

(2)　性能解析トレースファイルの出力形式と出力される内容

(a)　出力形式

性能解析トレースファイルに出力される形式は，J2EEサーバの性能解析トレースと同様です。性能解析トレースファイルの詳細については，マニュアル「アプリケーションサーバ機能解説 保守／移行編」の「7.3　Management Serverを利用した性能解析トレースファイルの収集」を参照してください。

(b)　出力される内容

HCSCサーバ（メッセージング基盤）の場合

性能解析トレースファイルに出力される内容を次の表に示します。

表7‒24　性能解析トレースファイルに出力される内容（メッセージング基盤）

項目

内容

イベントID

取得ポイントのイベントIDが出力されます。

詳細については，「7.4.3(3)(a)　HCSCサーバ（メッセージング基盤）の場合」のそれぞれの性能解析トレース取得ポイントの表を参照してください。

リターンコード

取得ポイント種別が出力されます。

0：正常終了

1：異常終了

インターフェース名

クラス名が出力されます。

オペレーション名

メソッド名が出力されます。

オプション情報

メッセージ共通ID

リクエスト識別情報（親ID）が出力されます。

サービスリクエストID

リクエスト識別情報（子ID）が出力されます。

付加情報

出力元固有の付加情報が出力されます。

HCSCサーバ（ビジネスプロセス基盤）の場合

性能解析トレースファイルに出力される内容を次の表に示します。

表7‒25　性能解析トレースファイルに出力される内容（ビジネスプロセス基盤）

項目

内容

イベントID

取得ポイントのイベントIDが出力されます。

詳細については，「7.4.3(3)(b)　HCSCサーバ（ビジネスプロセス基盤）の場合」の性能解析トレース取得ポイントの表を参照してください。

リターンコード

取得ポイント種別が出力されます。

0：正常終了

1：異常終了

インターフェース名

次の名称のどれかが出力されます。

ビジネスプロセス定義名

Javaクラス名

Data Transform

サービス名

詳細については，「7.4.3(3)(b)　HCSCサーバ（ビジネスプロセス基盤）の場合」の性能解析トレース取得ポイントの表を参照してください。

オペレーション名

出力されません。

オプション情報

オプション情報が出力されます。

詳細については，「7.4.3(3)(b)　HCSCサーバ（ビジネスプロセス基盤）の場合」の性能解析トレース取得ポイントの表を参照してください。

HCSCサーバ（DBアダプタ）の場合

性能解析トレースファイルに出力される内容を次の表に示します。

表7‒26　性能解析トレースファイルに出力される内容（DBアダプタ）

項目

内容

イベントID

取得ポイントのイベントIDが出力されます。

詳細については，「7.4.3(3)(c)　HCSCサーバ（DBアダプタ）の場合」の性能解析トレース取得ポイントの表を参照してください。

リターンコード

取得ポイント種別が出力されます。

0：正常終了

1：異常終了

インターフェース名

クラス名が出力されます。

パッケージ名は表示されません。

オペレーション名

メソッド名が出力されます。

オプション情報

メッセージ共通ID

リクエスト識別情報（親ID）が出力されます。

情報を設定していない場合はnullになります。

サービスリクエストID

リクエスト識別情報（子ID）が出力されます。

情報を設定していない場合はnullになります。

付加情報

個別情報が出力されます。

HCSCサーバ（データ変換基盤）の場合

性能解析トレースファイルに出力される内容を次の表に示します。

表7‒27　性能解析トレースファイルに出力される内容（データ変換基盤）

項目

内容

イベントID

取得ポイントのイベントIDが出力されます。

詳細については，「7.4.3(3)(d)　HCSCサーバ（データ変換基盤）の場合」の性能解析トレース取得ポイントの表を参照してください。

リターンコード

取得ポイント種別が出力されます。

0：正常終了

1：異常終了

インターフェース名

クラス名が出力されます。

オペレーション名

メソッド名が出力されます。

オプション情報

メッセージ共通ID

リクエスト識別情報（親ID）が出力されます。

サービスリクエストID

リクエスト識別情報（子ID）が出力されます。

付加情報

出力元固有の付加情報が出力されます。

HCSCサーバ（コンポーネント共通UOC）の場合

性能解析トレースファイルに出力される内容を次の表に示します。

表7‒28　性能解析トレースファイルに出力される内容（コンポーネント共通UOC）

項目

内容

イベントID

取得ポイントのイベントIDが出力されます。

詳細については，「7.4.3(3)(e)　HCSCサーバ（コンポーネント共通UOC）の場合」の性能解析トレース取得ポイントの表を参照してください。

リターンコード

取得ポイント種別が出力されます。

0：正常終了

1：異常終了

インターフェース名

UOCクラスのクラス名が出力されます。

オペレーション名

UOCクラスのメソッド名が出力されます。

オプション情報

メッセージ共通ID

リクエスト識別情報（親ID）が出力されます。

サービスリクエストID

リクエスト識別情報（子ID）が出力されます。

付加情報

オプション情報が出力されます。

詳細は，「7.4.3(3)(e)　HCSCサーバ（コンポーネント共通UOC）の場合」を参照してください。

(3)　性能解析トレースの取得ポイント

(a)　HCSCサーバ（メッセージング基盤）の場合

性能解析トレースファイルの出力契機には次の種類があり，それぞれで取得ポイントが異なります。

単体サービス実行時（JSON-XML変換をしない場合）

単体サービス実行時（JSON-XML変換をする場合）

ビジネスプロセスサービス実行時

データベースアクセス実行時

ファイルアクセス実行時

ユーザ定義受付（カスタム受付）使用時※

注※

ユーザ定義受付（カスタム受付）使用時の取得ポイントについては，マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「付録A.8　障害情報の取得（カスタム受付）」を参照してください。

それぞれの取得ポイントを次に示します。

単体サービス実行時（JSON-XML変換をしない場合）

単体サービス実行時の性能解析トレースのトレース取得ポイントを次の図に示します。

図7‒11　性能解析トレースの取得ポイント（単体サービス実行時（JSON-XML変換をしない場合））

イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。表の「図中の番号」は，上記の図中の番号と対応しています。

表7‒29　性能解析トレース取得ポイント（単体サービス実行時（JSON-XML変換をしない場合））

イベントID

図中の番号

トレース取得ポイント

レベル

0x9800

1

標準受付（Webサービス）の入口

A

0x9801

2

標準受付（Webサービス）の出口

A

0x9802

1

標準受付（SessionBean）の入口

A

0x9803

2

標準受付（SessionBean）の出口

A

0x9804

1

標準受付（MDB（WS-R））の入口

A

0x9805

2

標準受付（MDB（WS-R））の出口

A

0x9806

1

標準受付（MDB（DBキュー））の入口

A

0x9807

2

標準受付（MDB（DBキュー））の出口

A

0x9810

3

SOAPアダプタのサービス部品呼び出し口

A

0x9811

4

SOAPアダプタのサービス部品応答受信口

A

0x9812

3

SessionBeanアダプタのサービス部品呼び出し口

A

0x9813

4

SessionBeanアダプタのサービス部品応答受信口

A

0x9814

3

MDB（WS-R）アダプタのサービス部品呼び出し口

A

0x9815

4

MDB（WS-R）アダプタのサービス部品応答受信口

A

0x9816

3

MDB（DBキュー）アダプタのサービス部品呼び出し口

A

0x9817

4

MDB（DBキュー）アダプタのサービス部品応答受信口

A

0x9818

3

上記以外のサービスアダプタ（CUSTOM）のサービス部品呼び出し口

A

0x9819

4

上記以外のサービスアダプタ（CUSTOM）のサービス部品応答受信口

A

（凡例）

A：「標準」であることを示します。

単体サービス実行時（JSON-XML変換をする場合）

単体サービス実行時の性能解析トレースのトレース取得ポイントを次の図に示します。

図7‒12　性能解析トレースの取得ポイント（単体サービス実行時（JSON-XML変換をする場合））

イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。表の「図中の番号」は，上記の図中の番号と対応しています。

表7‒30　性能解析トレース取得ポイント（単体サービス実行時（JSON-XML変換をする場合））

イベントID

図中の番号

トレース取得ポイント

レベル

0x9800

1

標準受付（Webサービス）の入口

A

0x9801

2

標準受付（Webサービス）の出口

A

0x9802

1

標準受付（SessionBean）の入口

A

0x9803

2

標準受付（SessionBean）の出口

A

0x9804

1

標準受付（MDB（WS-R））の入口

A

0x9805

2

標準受付（MDB（WS-R））の出口

A

0x9806

1

標準受付（MDB（DBキュー））の入口

A

0x9807

2

標準受付（MDB（DBキュー））の出口

A

0x9810

3

SOAPアダプタのサービス部品呼び出し口

A

0x9811

4

SOAPアダプタのサービス部品応答受信口

A

0x9812

3

SessionBeanアダプタのサービス部品呼び出し口

A

0x9813

4

SessionBeanアダプタのサービス部品応答受信口

A

0x9814

3

MDB（WS-R）アダプタのサービス部品呼び出し口

A

0x9815

4

MDB（WS-R）アダプタのサービス部品応答受信口

A

0x9816

3

MDB（DBキュー）アダプタのサービス部品呼び出し口

A

0x9817

4

MDB（DBキュー）アダプタのサービス部品応答受信口

A

0x9818

3

上記以外のサービスアダプタ（CUSTOM）のサービス部品呼び出し口

A

0x9819

4

上記以外のサービスアダプタ（CUSTOM）のサービス部品応答受信口

A

0x982a

5※

カスタムアダプタ開発フレームワークのJSON-XML変換（要求電文）の呼び出し口

B

0x982b

6※

カスタムアダプタ開発フレームワークのJSON-XML変換（要求電文）の応答受信口

B

0x982c

7※

カスタムアダプタ開発フレームワークのJSON-XML変換（応答電文）の呼び出し口

B

0x982d

8※

カスタムアダプタ開発フレームワークのJSON-XML変換（応答電文）の応答受信口

B

（凡例）

A：「標準」であることを示します。

B：「詳細」であることを示します。

注※

カスタムアダプタ開発フレームワークでJSON-XML変換をする場合のトレース取得ポイントを示します。

ビジネスプロセスサービス実行時

ビジネスプロセスサービス実行時の性能解析トレースのトレース取得ポイントを次の図に示します。

図7‒13　性能解析トレースの取得ポイント（ビジネスプロセスサービス実行時）

イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。表の「図中の番号」は，「図7-13　性能解析トレースの取得ポイント（ビジネスプロセスサービス実行時）」中の番号と対応しています。

表7‒31　性能解析トレース取得ポイント（ビジネスプロセスサービス実行時）

イベントID

図中の番号

トレース取得ポイント

レベル

0x9800

1

標準受付（Webサービス）の入口

A

0x9801

2

標準受付（Webサービス）の出口

A

0x9802

1

標準受付（SessionBean）の入口

A

0x9803

2

標準受付（SessionBean）の出口

A

0x9804

1

標準受付（MDB（WS-R））の入口

A

0x9805

2

標準受付（MDB（WS-R））の出口

A

0x9806

1

標準受付（MDB（DBキュー））の入口

A

0x9807

2

標準受付（MDB（DBキュー））の出口

A

0x9808

1

SOAP受付の入口

A

0x9809

2

SOAP受付の出口

A

0x9810

7

SOAPアダプタのサービス部品呼び出し口

A

0x9811

8

SOAPアダプタのサービス部品応答受信口

A

0x9812

7

SessionBeanアダプタのサービス部品呼び出し口

A

0x9813

8

SessionBeanアダプタのサービス部品応答受信口

A

0x9814

7

MDB（WS-R）アダプタのサービス部品呼び出し口

A

0x9815

8

MDB（WS-R）アダプタのサービス部品応答受信口

A

0x9816

7

MDB（DBキュー）アダプタのサービス部品呼び出し口

A

0x9817

8

MDB（DBキュー）アダプタのサービス部品応答受信口

A

0x9818

7

上記以外のサービスアダプタ（CUSTOM）のサービス部品呼び出し口

A

0x9819

8

上記以外のサービスアダプタ（CUSTOM）のサービス部品応答受信口

A

0x9840

3

ビジネスプロセスサービスの呼び出し口

A

0x9841

4

ビジネスプロセスサービスの応答受信口

A

0x9842

5

ビジネスプロセス受付の入口

A

0x9843

6

ビジネスプロセス受付の出口

A

（凡例）

A：「標準」であることを示します。

データベースアクセス実行時

HCSCサーバが，コマンドを採取時にデータベースにアクセスするときの性能解析トレースの取得ポイントを次の図に示します。

図7‒14　性能解析トレースの取得ポイント（データベースアクセス実行時）

イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。表の「図中の番号」は，「図7-14　性能解析トレースの取得ポイント（データベースアクセス実行時）」中の番号と対応しています。

表7‒32　性能解析トレース取得ポイント（データベースアクセス実行時）

イベントID

図中の番号

トレース取得ポイント

レベル

0x9850

1

DBコネクタ呼び出し口

A

0x9851

2

DBコネクタ応答受信口

A

0x9852

3

DBコネクタ実行履歴呼び出し口

B

0x9853

4

DBコネクタ実行履歴応答受信口

B

（凡例）

A：「標準」であることを示します。

B：「詳細」であることを示します。

ファイルアクセス実行時

データベースを使用しない構成でHCSCサーバをセットアップした場合，コマンド処理時に，データベースの代わりにファイルにアクセスします。このファイルアクセスするときの性能解析トレースを取得します。ファイルアクセスでの取得ポイントを次の図に示します。

図7‒15　性能解析トレースの取得ポイント（ファイルアクセス実行時）

イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。表の「図中の番号」は，「図7-15　性能解析トレースの取得ポイント（ファイルアクセス実行時）」中の番号と対応しています。

表7‒33　性能解析トレース取得ポイント（ファイルアクセス実行時）

イベントID

図中の番号

トレース取得ポイント

レベル

0x9854

1

ファイルアクセス呼び出し口（ファイルオープン前）

B

0x9855

2

ファイルアクセス応答受信口（ファイルクローズ後）

B

（凡例）

B：「詳細」であることを示します。

(b)　HCSCサーバ（ビジネスプロセス基盤）の場合

性能解析のトレース取得ポイントを次の図に示します。

図7‒16　性能解析トレースのトレース取得ポイント（ビジネスプロセス基盤）

イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。また，イベントIDごとにインターフェース名とオプション情報の出力内容を示します。表の「図中の番号」は上の図の番号と対応しています。

表7‒34　性能解析トレース取得ポイント（ビジネスプロセス基盤）

イベントID

図中の番号

トレース取得ポイント

レベル

インターフェース名

オプション情報

0x9900

1

メッセージング基盤からのビジネスプロセス実行要求呼び出し

A

ビジネスプロセス定義名

メッセージ共通ID

0x9901

2

メッセージング基盤へのビジネスプロセス実行要求応答

A

ビジネスプロセス定義名

メッセージ共通ID

フォルト名（異常時）

0x9902

3

メッセージング基盤からの応答アクティビティ後呼び出し

A

ビジネスプロセス定義名

メッセージ共通ID

0x9903

4

メッセージング基盤からの応答アクティビティ後呼び出しへの応答

A

ビジネスプロセス定義名

メッセージ共通ID

フォルト名（異常時）

0x9904

5

メッセージング基盤からの再実行要求呼び出し

A

ビジネスプロセス定義名

メッセージ共通ID

0x9905

6

メッセージング基盤からの再実行要求呼び出しへの応答

A

ビジネスプロセス定義名

メッセージ共通ID

フォルト名（異常時）

0x9906

7

ユーザ作成のJavaクラス呼び出し

A

Javaクラス名

なし

0x9907

8

ユーザ作成のJavaクラスからの応答

A

Javaクラス名

フォルト名（異常時）

0x9908

9

データ変換要求呼び出し

A

"Data Transform"

なし

0x9909

10

データ変換要求からの応答

A

"Data Transform"

フォルト名（異常時）

0x990A

11

TimerServiceからの待機アクティビティ後呼び出し

A

ビジネスプロセス定義名

メッセージ共通ID

0x990B

12

TimerServiceからの待機アクティビティ後呼び出しへの応答

A

ビジネスプロセス定義名

メッセージ共通ID

フォルト名（異常時）

0x990C

13

TimerService登録時

A

ビジネスプロセス定義名

メッセージ共通ID

待機解除時間

0x990D

14

TimerServiceタイムアウト時

A

ビジネスプロセス定義名

メッセージ共通ID

0x9910

15

メッセージング基盤へのサービス部品要求呼び出し

A

サービス名

メッセージ共通ID

親スレッドのハッシュコード（並列実行時）

0x9911

16

メッセージング基盤からのサービス部品要求応答

A

サービス名

メッセージ共通ID

親スレッドのハッシュコード（並列実行時）

フォルト名（異常時）

0x9912

17

メッセージング基盤から非同期EJBへの応答アクティビティ後呼び出し

A

ビジネスプロセス定義名

メッセージ共通ID

プロセスインスタンス識別子

0x9913

18

非同期EJBからメッセージング基盤への応答アクティビティ後呼び出しの応答

A

ビジネスプロセス定義名

メッセージ共通ID

プロセスインスタンス識別子

（凡例）

A：「標準」であることを示します。

注

表に含まれないイベントID（0x9A00〜0x9AFF）は，データ変換基盤から発行されたものです。

(c)　HCSCサーバ（DBアダプタ）の場合

起動時とサービス部品実行時で，性能解析トレースのトレース取得ポイントが異なります。

起動時

起動時の性能解析トレースのトレース取得ポイントを次の図に示します。

図7‒17　性能解析トレースのトレース取得ポイント（DBアダプタ起動時）

イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。表の「図中の番号」は，「図7-17　性能解析トレースのトレース取得ポイント（DBアダプタ起動時）」中の番号と対応しています。

表7‒35　性能解析トレース取得ポイント（DBアダプタ起動時）

イベントID

図中の番号

トレース取得ポイント

レベル

0x9B60

1

データソース検索直前

B

0x9B61

2

データソース検索直後

B

0x9B62

B

（凡例）

B：「詳細」であることを示します。

サービス部品実行時

サービス部品実行時の性能解析トレースのトレース取得ポイントを次の図に示します。

図7‒18　性能解析トレースのトレース取得ポイント（DBアダプタサービス実行時）

イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。表の「図中の番号」は，「図7-18　性能解析トレースのトレース取得ポイント（DBアダプタサービス実行時）」中の番号と対応しています。

表7‒36　性能解析トレース取得ポイント（DBアダプタサービス実行時）

イベントID

図中の番号

トレース取得ポイント

レベル

0x9B00

1

メッセージング基盤からのサービス部品要求呼び出し直後

A

0x9B01

14

メッセージング基盤からのサービス部品要求応答直前

A

0x9B02

A

0x9B20

2※1※2，12※1※2

データ変換要求呼び出し直前

A

0x9B21

3※1※2，13※1※2

データ変換要求応答直後

A

0x9B22

A

0x9B23

15※2※3

データ複製要求呼び出し直前

A

0x9B24

16※2※3

データ複製要求応答直後

A

0x9B25

A

0x9B63

4

データベース接続要求呼び出し直前

B

0x9B64

5

データベース接続要求応答直後

B

0x9B65

B

0x9B66

6

SQL要求呼び出し直前

A

0x9B67

7

SQL要求応答直後

A

0x9B68

A

0x9B69

6

SQL要求呼び出し直前

A

0x9B6A

7

SQL要求応答直後

A

0x9B6B

A

0x9B6C

6

SQL要求呼び出し直前

A

0x9B6D

7

SQL要求応答直後

A

0x9B6E

A

0x9B6F

17

DBアダプタからのSELECT文の実行時（ResultSet.next()の初回出力時だけ）

A

0x9B70

18

A

0x9B71

A

0x9B40

8

SQL（SELECT）実行結果格納処理直前

A

0x9B41

11

SQL（SELECT）実行結果格納処理直後

A

0x9B42

A

0x9B43

9

SQL（SELECT）実行結果取得処理直前

B

0x9B44

10

SQL（SELECT）実行結果取得処理直後

B

0x9B45

B

（凡例）

A：「標準」であることを示します。

B：「詳細」であることを示します。

注

表に含まれないイベントID（0x9A00〜0x9AFF）は，データ変換基盤から発行されたものです。

注※1

標準電文の種別がXML電文のデータ変換定義がある場合のトレース取得ポイントを示します。

注※2

標準電文の種別がバイナリ電文のデータ変換定義がある場合のトレース取得ポイントを示します。

注※3

データ変換定義がない場合のトレース取得ポイントを示します。

(d)　HCSCサーバ（データ変換基盤）の場合

イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。

表7‒37　性能解析トレース取得ポイント（データ変換基盤）

イベントID

トレース取得ポイント

レベル

0x9A07

XMLから値を取得する直前

A

0x9A08

XMLから値を取得した直後

A

0x9A0C

XMLに値を設定する直前

A

0x9A0D

XMLに値を設定した直後

A

0x9A11

XMLからノードを取得する直前

A

0x9A12

XMLからノードを取得した直後

A

0x9A16

XMLにノードを設定する直前

A

0x9A17

XMLにノードを設定した直後

A

0x9A43

データ変換直前

A※

0x9A44

データ変換直後

A※

0x9A52

データ変換テンプレート生成直前

A

0x9A53

データ変換テンプレート生成直後

A

0x9A65

XMLスキーマインスタンス生成直前

A

0x9A66

XMLスキーマインスタンス生成直後

A

0x9A6A

XMLスキーマインスタンス生成直前

A

0x9A6B

XMLスキーマインスタンス生成直後

A

0x9A77

XMLデータ解析直前

A

0x9A78

XMLデータ解析直後

A

0x9A7A

XMLスキーマ検証直前

A

0x9A7B

XMLスキーマ検証直後

A

0x9A7C

XMLスキーマ検証直前

A

0x9A7D

XMLスキーマ検証直後

A

0x9A80

XMLデータ解析直前

A

0x9A81

XMLデータ解析直後

A

0x9A82

データ変換直前

A

0x9A83

データ変換直後

A

0x9A84

XMLデータ解析直前

A

0x9A85

XMLデータ解析直後

A

0x9A88

XMLスキーマインスタンス生成直前

A

0x9A89

XMLスキーマインスタンス生成直後

A

0x9A8D

XMLスキーマインスタンス生成直前

A

0x9A8E

XMLスキーマインスタンス生成直後

A

0x9A8F

変換ファンクションjar呼出前

A

0x9A90

変換ファンクションjar呼出後

A

（凡例）

A：「標準」であることを示します。

注※

ファイル操作アダプタからの呼び出しの場合，性能解析トレース取得レベルは「詳細」とします。

(e)　HCSCサーバ（コンポーネント共通UOC）の場合

コンポーネント共通UOC機能を使用した場合の性能解析トレースは，UOCクラス呼び出し直前と呼び出し直後に出力されます。コンポーネント共通UOC使用時の性能解析トレースのトレース取得ポイントを次の図に示します。

図7‒19　性能解析トレースの取得ポイント（コンポーネント共通UOC使用時）

イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。表の「図中の番号」は，「図7-19　性能解析トレースの取得ポイント（コンポーネント共通UOC使用時）」中の番号と対応しています。

表7‒38　性能解析トレース取得ポイント（コンポーネント共通UOC使用時）

イベントID

図中の番号

トレース取得ポイント

レベル

0x986C

1

コンポーネント共通UOC呼び出し口

A

0x986D

2

コンポーネント共通UOC応答受信口

A

（凡例）

A：「標準」であることを示します。

オプション情報の出力形式は次のとおりです。

<リクエスト識別情報（親ID）> <リクエスト識別情報（子ID）> Component type=<コンポーネントタイプ（サービスアダプタまたは受付）>, Component kind=<種別>, Component ID=<サービスアダプタのサービスIDまたは受付ID※>, OP=<サービスオペレーション名>

異常終了の場合は，オプション情報は次の形式で出力されます。

<リクエスト識別情報（親ID）> <リクエスト識別情報（子ID）> Component type=<コンポーネント種別（アダプタ種別または受付種別）>, Component ID=<サービスアダプタのサービスIDまたは受付ID※>, OP=<サービスオペレーション名>, Exception=<例外クラス名>

注※

標準受付を使用した場合，次の固定値が設定されます。

コンポーネント

受付ID

標準受付（Webサービス）

（SOAP1.1，SOAP1.1/1.2併用モード共通）

StandardReception_SOAP

標準受付（SessionBean）

StandardReception_EJB

標準受付（MDB（WS-R））

StandardReception_WSR

標準受付（MDB（DBキュー））

StandardReception_DBQ

7.4.4　ユーザ電文トレース

HCSCサーバのメッセージング基盤では，次の内容をユーザ電文トレースとして取得できます。

リクエスト受付で受け付けたサービス部品呼び出し要求または応答の電文

ビジネスプロセスを呼び出したときの要求または応答の電文

サービスアダプタからサービス部品を呼び出したときの要求または応答の電文

データ変換を実行したときの変換前または変換後の電文

また，正常処理時のユーザ電文トレースでは，特定のHCSCコンポーネントの情報だけを出力できます。詳細については，「(2) ユーザ電文トレースの出力対象となるHCSCコンポーネントの指定」を参照してください。

注意事項

ユーザ電文トレースは電文の内容をファイルに出力します。そのため，情報漏洩などのセキュリティ上の問題が発生しないよう，取り扱いに注意してください。

ユーザ電文トレースファイルが電文の内容を出力する際は，出力先の環境に設定された文字コード（J2SEのfile.encodingプロパティで設定された文字コード）を使用します。

ユーザ電文トレースに出力される内容は，次の3つの部分で構成されます。

ユーザ電文トレース開始

ユーザ電文トレースデータ

ユーザ電文トレース終了

それぞれの内容を次に示します。

この項では，取得されたユーザ電文トレースの確認方法について説明します。ユーザ電文トレースの取得方法については，「7.3.2(4)　ユーザ電文トレースの取得方法」を参照してください。

(1)　ユーザ電文トレースの出力先

ユーザ電文トレースの出力先を次に示します。

HCSCサーバランタイム定義ファイルのtelegramtrace-filepathプロパティで指定したパス

なお，指定したパスが存在しない場合，またはパスが誤っていた場合は，省略値の出力先にトレースが出力されます。

ユーザ電文トレースのトレースファイル名を次の表に示します。

表7‒39　ユーザ電文トレースのトレースファイル名

トレースファイルの出力モード

トレースファイル名

ラップアラウンドモードの場合

csctelegram_<HCSCサーバ名>_<面数>.log

シフトモードの場合

csctelegram_<HCSCサーバ名>_.log

面数および1面当たりの最大サイズについては，「7.3.2(4)　ユーザ電文トレースの取得方法」を参照してください。

(2)　ユーザ電文トレースの出力対象となるHCSCコンポーネントの指定

正常処理時のユーザ電文トレースを出力する場合は，出力対象となるHCSCコンポーネントをHCSCサーバランタイム定義ファイルの次に示すプロパティで指定できます。

telegramtrace-component-type-filepath（HCSCコンポーネントの種別で指定）

telegramtrace-component-id-filepath（HCSCコンポーネントのIDで指定）

HCSCサーバランタイム定義ファイルの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.5.6　HCSCサーバランタイム定義ファイル」を参照してください。

(3)　ユーザ電文トレース開始の出力形式と出力される内容

(a)　出力形式

ユーザ電文トレース開始の出力形式を次の図に示します。

図7‒20　ユーザ電文トレース開始の出力形式

(b)　出力される内容

ユーザ電文トレース開始に出力される内容を次の表に示します。

表7‒40　ユーザ電文トレース開始に出力される内容

項目

内容

番号

トレースレコードの出力通番が表示されます。

日付

トレースレコードの取得日付（yyyy/mm/dd形式）が出力されます。

時刻

トレースレコードの取得時刻（hh:mm:ss.SSS形式）が，ローカル時刻でミリ秒単位に出力されます。

製品ID

製品を特定するための識別子が出力されます。

CSCMSG：メッセージング基盤

CSCBP：ビジネスプロセス

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID

表示されません。

電文トレース開始取得ポイント識別情報

電文トレース開始

ユーザ電文トレース開始を示す文字列「telegramtrace started」が出力されます。

取得位置

トレースの取得ポイント情報（取得位置）が出力されます。

RCP：標準受付

URCP：ユーザ定義受付

BPRCP：ビジネスプロセスリクエスト受付

BPREQ：ビジネスプロセス呼び出し

SVC：サービス部品呼び出し（サービスアダプタ内）

CNVST：サービスアダプタのデータ変換

BPCNV：ビジネスプロセスのデータ変換アクティビティ

BPASG：ビジネスプロセスの代入アクティビティ

BPJAV：ビジネスプロセスのJava呼出アクティビティ

BPSVC：ビジネスプロセスのサービス呼出アクティビティ

BPVLD：ビジネスプロセスの検証アクティビティ

BPFLT：ビジネスプロセスのフォルト送出アクティビティ

BPRPL：ビジネスプロセスの応答アクティビティ

BPWHL：ビジネスプロセスの繰り返しアクティビティ

BPSWT：ビジネスプロセスの分岐アクティビティ

BPLNK：ビジネスプロセスのリンクコネクション

BPLOG：ビジネスプロセスのログ出力アクティビティ

プロトコル種別

トレースの取得ポイント情報（プロトコル種別）が出力されます。

SOAP：Webサービス

EJB：SessionBean

WSR：MDB（WS-R）

DBQ：MDB（DBキュー）

CUSTM：上記以外のプロトコル

空白：取得位置が次の場合

・BPRCPまたはBPREQ

・ビジネスプロセス

詳細位置

トレースの取得ポイント情報（詳細位置）が出力されます。

IN：受付

OUT：応答

ERR：エラー検出後

CAL：呼び出し（ビジネスプロセスやサービス呼び出し）

RET：応答受信（ビジネスプロセスやサービス呼び出しの応答）

RQB：サービスアダプタの要求時のデータ変換前

RSA：サービスアダプタの応答時のデータ変換後

CVB：ビジネスプロセスのデータ変換アクティビティ前

CVA：ビジネスプロセスのデータ変換アクティビティ後

ASB：ビジネスプロセスの代入アクティビティ前

ASA：ビジネスプロセスの代入アクティビティ後

RQA：ユーザ定義受付の要求時のデータ変換後

RSB：ユーザ定義受付の応答時のデータ変換前

メッセージ共通ID

リクエスト識別情報（親ID）が出力されます。

付加情報

次の付加情報が出力されます。

(a) リクエスト受付およびサービスアダプタの場合

サービスリクエストID

サービス名（Service Name）

クライアント相関ID（Client ID）

PRFルートアプリケーション情報（RootApInfo）

(b) ビジネスプロセスの場合

プロセスインスタンスID

ビジネスプロセス名（Process Definition Name）

アクティビティ名（Activity Definition Name）

変数定義名（Variable Name）

PRFルートアプリケーション情報（RootApInfo）

(c) リクエスト受付のフォルト電文の場合

サービスリクエストID

サービス名（Service Name）

クライアント相関ID（Client ID）

PRFルートアプリケーション情報（RootApInfo）

フォルト名（Fault Name）

(d) ビジネスプロセスのフォルト電文の場合

プロセスインスタンスID

ビジネスプロセス名（Process Definition Name）

アクティビティ名（Activity Definition Name）

PRFルートアプリケーション情報（RootApInfo）

フォルト名（Fault Name）

CRLF

レコード終端符号が出力されます。

(4)　ユーザ電文トレースデータの出力形式と出力される内容

ユーザ電文トレースデータの出力形式は，HCSCサーバランタイム定義ファイルのtelegramtrace-formatプロパティの指定によって異なります。

(a)　出力形式（telegramtrace-format=FIXEDを指定した場合）

HCSCサーバランタイム定義ファイルにtelegramtrace-format=FIXEDを指定した場合のユーザ電文トレースデータの出力形式を次の図に示します。

図7‒21　ユーザ電文トレースデータの出力形式（telegramtrace-format=FIXEDを指定した場合）

(b)　出力される内容（telegramtrace-format=FIXEDを指定した場合）

HCSCサーバランタイム定義ファイルにtelegramtrace-format=FIXEDを指定した場合のユーザ電文トレースデータに出力される内容を次の表に示します。

表7‒41　ユーザ電文トレースデータに出力される内容（telegramtrace-format=FIXEDを指定した場合）

項目

内容

番号

トレースレコードの出力通番が表示されます。

日付

トレースレコードの取得日付（yyyy/mm/dd形式）が出力されます。

時刻

トレースレコードの取得時刻（hh:mm:ss.SSS形式）が，ローカル時刻でミリ秒単位に出力されます。

製品ID

製品を特定するための識別子が出力されます。

CSCMSG：メッセージング基盤

CSCBP：ビジネスプロセス

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID

表示されません。

電文トレースデータ情報

出力位置（16進数形式）

ユーザ電文の先頭からのオフセット値（16進数形式）が出力されます。

データ（16進数形式）

ユーザ電文の内容（16進数形式）が出力されます。

データ（ASCII形式）

ユーザ電文の内容（ASCII形式）が出力されます。

0x20〜0x7Eの範囲の場合にASCII文字が出力されます。

0x00〜0x1F，0x7F〜0xFFの範囲の場合は，ピリオド（.）が出力されます。

CRLF

レコード終端符号が出力されます。

注

SOAPメッセージの場合，ユーザ電文トレースデータにはユーザ電文に含まれる次の情報が出力されます。

・soap:Header要素を含む複数の子要素

・soap:Body要素の1つの子要素

なお，soap:Header要素が存在しない場合は，soap:Body要素の子要素だけが情報として出力されます。

(c)　出力形式（telegramtrace-format=READABLEを指定した場合）

HCSCサーバランタイム定義ファイルにtelegramtrace-format=READABLEを指定した場合，16進数形式データとUTF-8形式データはそれぞれ別の行に出力されます。それぞれの出力形式を次の図に示します。

図7‒22　ユーザ電文トレースデータの出力形式（telegramtrace-format=READABLEを指定した場合）（16進数形式データ）

図7‒23　ユーザ電文トレースデータの出力形式（telegramtrace-format=READABLEを指定した場合）（UTF-8形式データ）

(d)　出力される内容（telegramtrace-format=READABLEを指定した場合）

HCSCサーバランタイム定義ファイルにtelegramtrace-format=READABLEを指定した場合，16進数形式データとUTF-8形式データの出力内容が異なります。それぞれの出力形式を次の表に示します。

表7‒42　ユーザ電文トレースデータに出力される内容（telegramtrace-format=READABLEを指定した場合）（16進数形式データ）

項目

内容

番号

トレースレコードの出力通番が表示されます。

日付

トレースレコードの取得日付（yyyy/mm/dd形式）が出力されます。

時刻

トレースレコードの取得時刻（hh:mm:ss.SSS形式）が，ローカル時刻でミリ秒単位に出力されます。

製品ID

製品を特定するための識別子が出力されます。

CSCMSG：メッセージング基盤

CSCBP：ビジネスプロセス

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID

表示されません。

電文トレースデータ情報

出力位置（16進数形式）

ユーザ電文の先頭からのオフセット値が16進数形式で出力されます。

データ（16進数形式）

ユーザ電文の内容が16進数形式で出力されます。

CRLF

レコード終端符号が出力されます。

注

SOAPメッセージの場合，ユーザ電文トレースデータにはユーザ電文に含まれる次の情報が出力されます。

・soap:Header要素を含む複数の子要素

・soap:Body要素の1つの子要素

soap:Header要素が存在しない場合は，soap:Body要素の子要素だけが情報として出力されます。

表7‒43　ユーザ電文トレースデータに出力される内容（telegramtrace-format=READABLEを指定した場合）（UTF-8形式データ）

項目

内容

番号

トレースレコードの出力通番が表示されます。

日付

トレースレコードの取得日付（yyyy/mm/dd形式）が出力されます。

時刻

トレースレコードの取得時刻（hh:mm:ss.SSS形式）が，ローカル時刻でミリ秒単位に出力されます。

製品ID

製品を特定するための識別子が出力されます。

CSCMSG：メッセージング基盤

CSCBP：ビジネスプロセス

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID

表示されません。

電文トレースデータ情報

データ（UTF-8形式）

ユーザ電文をUTF-8形式で出力します。

0x20〜0x7Eの範囲にある文字は，ASCII文字として出力します。

次の範囲にある文字は，ピリオド（.）を出力します。

0x00〜0x08

0x0B〜0x0C

0x0E〜0x1F

0x7F

0x09の場合は，水平タブを出力します。

改行コード（0x0aまたは0x0d）は出力しません。

0xFE〜0xFFの範囲にある文字は，クエスチョンマーク（?）を出力します。

マルチバイト文字として正しく記述されている場合は，マルチバイト文字を出力します※。

CRLF

レコード終端符号が出力されます。

注1

SOAPメッセージの場合，ユーザ電文トレースデータにはユーザ電文に含まれる次の情報が出力されます。

・soap:Header要素を含む複数の子要素

・soap:Body要素の1つの子要素

なお，soap:Header要素が存在しない場合は，soap:Body要素の子要素だけが情報として出力されます。

注2

ユーザ電文トレースの1行の長さは最大4,185バイトです。それを超えた分は次の行に出力されます。4,185バイト目のデータがマルチバイト文字の場合，マルチバイト文字は次の行に出力されます。

注※

マルチバイト文字の文字コードの割り当て範囲を次の表に示します。

表7‒44　UTF-8のマルチバイト文字の割り当て範囲

区分

文字コードの範囲（16進数）

2バイト文字の開始バイト

0xC0〜0xDF

3バイト文字の開始バイト

0xE0〜0xEF

4バイト文字の開始バイト

0xF0〜0xF7

5バイト文字の開始バイト

0xF8〜0xFB

6バイト文字の開始バイト

0xFC〜0xFD

マルチバイト文字の2バイト目以降

0x80〜0xBF

なお，この範囲内でも出力するデータの並びが文字セットにとって不当な場合や，出力するデータの並びが正当でも有効な文字に対応付けできない場合は，クエスチョンマーク（?）を出力します。

(5)　ユーザ電文トレース終了の出力形式と出力される内容

(a)　出力形式

ユーザ電文トレース終了の出力形式を次の図に示します。

図7‒24　ユーザ電文トレース終了の出力形式

(b)　出力される内容

ユーザ電文トレース終了に出力される内容を次の表に示します。

表7‒45　ユーザ電文トレース終了に出力される内容

項目

内容

番号

トレースレコードの出力通番が表示されます。

日付

トレースレコードの取得日付（yyyy/mm/dd形式）が出力されます。

時刻

トレースレコードの取得時刻（hh:mm:ss.SSS形式）が，ローカル時刻でミリ秒単位に出力されます。

製品ID

製品を特定するための識別子が出力されます。

CSCMSG：メッセージング基盤

CSCBP：ビジネスプロセス

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID

表示されません。

電文トレース終了取得ポイント識別情報

電文トレース終了

ユーザ電文トレース終了を示す文字列「telegramtrace ended」が出力されます。

取得位置

トレースの取得ポイント情報（取得位置）が出力されます。

RCP：標準受付

URCP：ユーザ定義受付

BPRCP：ビジネスプロセスリクエスト受付

BPREQ：ビジネスプロセス呼び出し

SVC：サービス部品呼び出し（サービスアダプタ内）

CNVST：サービスアダプタのデータ変換

BPCNV：ビジネスプロセスのデータ変換アクティビティ

BPASG：ビジネスプロセスの代入アクティビティ

BPJAV：ビジネスプロセスのJava呼出アクティビティ

BPSVC：ビジネスプロセスのサービス呼出アクティビティ

BPVLD：ビジネスプロセスの検証アクティビティ

BPFLT：ビジネスプロセスのフォルト送出アクティビティ

BPRPL：ビジネスプロセスの応答アクティビティ

BPWHL：ビジネスプロセスの繰り返しアクティビティ

BPSWT：ビジネスプロセスの分岐アクティビティ

BPLNK：ビジネスプロセスのリンクコネクション

BPLOG：ビジネスプロセスのログ出力アクティビティ

プロトコル種別

トレースの取得ポイント情報（プロトコル種別）が出力されます。

SOAP：Webサービス

EJB：SessionBean

WSR：MDB（WS-R）

DBQ：MDB（DBキュー）

CUSTM：上記以外のプロトコル

空白：取得位置が次の場合

・BPRCPまたはBPREQ

・ビジネスプロセス

詳細位置

トレースの取得ポイント情報（詳細位置）が出力されます。

IN：受付

OUT：応答

ERR：エラー検出後

CAL：呼び出し（ビジネスプロセスやサービス呼び出し）

RET：応答受信（ビジネスプロセスやサービス呼び出しの応答）

RQB：サービスアダプタの要求時のデータ変換前

RSA：サービスアダプタの応答時のデータ変換後

CVB：ビジネスプロセスのデータ変換アクティビティ前

CVA：ビジネスプロセスのデータ変換アクティビティ後

ASB：ビジネスプロセスの代入アクティビティ前

ASA：ビジネスプロセスの代入アクティビティ後

メッセージ共通ID

リクエスト識別情報（親ID）が出力されます。

付加情報

付加情報として，ユーザ電文の長さ（10進数形式）が出力されます。なお，ユーザ電文がない場合は「0」または「null」が出力されます。

CRLF

レコード終端符号が出力されます。

(6)　ユーザ電文トレースの出力契機

ユーザ電文トレースの出力契機は，HCSCサーバランタイム定義ファイルのtelegramtrace-triggerプロパティで指定します。telegramtrace-triggerプロパティで指定できる出力契機と，電文との組み合わせを次の表に示します。デフォルトは「NORMAL」です。

表7‒46　telegramtrace-triggerプロパティで指定できる出力契機と電文との組み合わせ

プロパティの設定値

タイミング

電文の種類

要求電文

応答電文

フォルト電文

NORMAL

正常処理時

○

○

×

システム例外検出時

×

×

×

フォルト検出時（catchなし）

×

×

×

フォルト検出時（catchあり）

×

×

×

SYSERR

正常処理時

×

×

×

システム例外検出時

○

×

×

フォルト検出時（catchなし）

○

×

×

フォルト検出時（catchあり）

×

×

×

FAULT

正常処理時

×

×

×

システム例外検出時

×

×

×

フォルト検出時（catchなし）

○

×

○

フォルト検出時（catchあり）

○

×

○

（凡例）

○：出力されます。

×：出力されません。

(7)　ユーザ電文トレースの取得ポイント

ユーザ電文トレースの出力契機に応じて，次のように取得ポイントが異なります。

NORMAL（単体サービス実行時（データ変換がない場合））

NORMAL（単体サービス実行時（データ変換がある場合））

NORMAL（ビジネスプロセス呼び出し実行時）

NORMAL（ビジネスプロセスサービス実行時）

NORMAL（ユーザが指定したHCSCコンポーネントの正常終了時）

SYSERR（システム例外検出時）

FAULT（フォルト検出時）

(a)　NORMAL（単体サービス実行時（データ変換がない場合））

単体サービス実行時（データ変換がない場合）のユーザ電文トレースのトレース取得ポイントを次の図に示します。

図7‒25　ユーザ電文トレースの取得ポイント（単体サービス実行時（データ変換がない場合））

トレース取得ポイントを次の表に示します。表の「図中の番号」は，「図7-25　ユーザ電文トレースの取得ポイント（単体サービス実行時（データ変換がない場合））」中の番号と対応しています。

表7‒47　ユーザ電文トレース取得ポイント（単体サービス実行時（データ変換がない場合））

図中の番号

トレース取得ポイント

1

標準受付（Webサービス）の入口

2

標準受付（Webサービス）の出口

1

標準受付（SessionBean）の入口

2

標準受付（SessionBean）の出口

1

標準受付（MDB（WS-R））の入口

2

標準受付（MDB（WS-R））の出口

1

標準受付（MDB（DBキュー））の入口

2

標準受付（MDB（DBキュー））の出口

3

SOAPアダプタのサービス部品呼び出し口

4

SOAPアダプタのサービス部品応答受信口

3

SessionBeanアダプタのサービス部品呼び出し口

4

SessionBeanアダプタのサービス部品応答受信口

3

MDB（WS-R）アダプタのサービス部品呼び出し口

4

MDB（WS-R）アダプタのサービス部品応答受信口

3

MDB（DBキュー）アダプタのサービス部品呼び出し口

4

MDB（DBキュー）アダプタのサービス部品応答受信口

3

上記以外のサービスアダプタ（CUSTOM）のサービス部品呼び出し口

4

上記以外のサービスアダプタ（CUSTOM）のサービス部品応答受信口

(b)　NORMAL（単体サービス実行時（データ変換がある場合））

単体サービス実行時（データ変換がある場合）のユーザ電文トレースのトレース取得ポイントを次の図に示します。

図7‒26　ユーザ電文トレースの取得ポイント（単体サービス実行時（データ変換がある場合））

トレース取得ポイントを次の表に示します。表の「図中の番号」は，「図7-26　ユーザ電文トレースの取得ポイント（単体サービス実行時（データ変換がある場合））」中の番号と対応しています。

表7‒48　ユーザ電文トレース取得ポイント（単体サービス実行時（データ変換がある場合））

図中の番号

トレース取得ポイント

1

標準受付（Webサービス）の入口

2

標準受付（Webサービス）の出口

1

標準受付（SessionBean）の入口

2

標準受付（SessionBean）の出口

1

標準受付（MDB（WS-R））の入口

2

標準受付（MDB（WS-R））の出口

1

標準受付（MDB（DBキュー））の入口

2

標準受付（MDB（DBキュー））の出口

3

SOAPアダプタの標準電文定義時のデータ変換前

4

SOAPアダプタの標準電文定義時のデータ変換後

3

SessionBeanアダプタの標準電文定義時のデータ変換前

4

SessionBeanアダプタの標準電文定義時のデータ変換後

3

MDB（WS-R）アダプタの標準電文定義時のデータ変換前

4

MDB（WS-R）アダプタの標準電文定義時のデータ変換後

3

MDB（DBキュー）アダプタの標準電文定義時のデータ変換前

4

MDB（DBキュー）アダプタの標準電文定義時のデータ変換後

3

上記以外のサービスアダプタ（CUSTOM）の標準電文定義時のデータ変換前

4

上記以外のサービスアダプタ（CUSTOM）の標準電文定義時のデータ変換後

5

SOAPアダプタのサービス部品呼び出し口

6

SOAPアダプタのサービス部品応答受信口

5

SessionBeanアダプタのサービス部品呼び出し口

6

SessionBeanアダプタのサービス部品応答受信口

5

MDB（WS-R）アダプタのサービス部品呼び出し口

6

MDB（WS-R）アダプタのサービス部品応答受信口

5

MDB（DBキュー）アダプタのサービス部品呼び出し口

6

MDB（DBキュー）アダプタのサービス部品応答受信口

5

上記以外のサービスアダプタ（CUSTOM）のサービス部品呼び出し口

6

上記以外のサービスアダプタ（CUSTOM）のサービス部品応答受信口

(c)　NORMAL（ビジネスプロセス呼び出し実行時）

ビジネスプロセス呼び出し実行時のユーザ電文トレースのトレース取得ポイントを次の図に示します。

図7‒27　ユーザ電文トレースの取得ポイント（ビジネスプロセス呼び出し実行時）

トレース取得ポイントを次の表に示します。表の「図中の番号」は，「図7-27　ユーザ電文トレースの取得ポイント（ビジネスプロセス呼び出し実行時）」中の番号と対応しています。

表7‒49　ユーザ電文トレース取得ポイント（ビジネスプロセス呼び出し実行時）

図中の番号

トレース取得ポイント

1

標準受付（Webサービス）の入口

2

標準受付（Webサービス）の出口

1

標準受付（SessionBean）の入口

2

標準受付（SessionBean）の出口

1

標準受付（MDB（WS-R））の入口

2

標準受付（MDB（WS-R））の出口

1

標準受付（MDB（DBキュー））の入口

2

標準受付（MDB（DBキュー））の出口

1

ユーザ定義受付の入口

2

ユーザ定義受付の出口

3

ビジネスプロセスサービスの呼び出し口

4

ビジネスプロセスサービスの応答受信口

(d)　NORMAL（ビジネスプロセスサービス実行時）

ビジネスプロセスサービス実行時のユーザ電文トレースのトレース取得ポイントを次の図に示します。

図7‒28　ユーザ電文トレースの取得ポイント（ビジネスプロセスサービス実行時）

トレース取得ポイントを次の表に示します。表の「図中の番号」は，「図7-28　ユーザ電文トレースの取得ポイント（ビジネスプロセスサービス実行時）」中の番号と対応しています。

表7‒50　ユーザ電文トレース取得ポイント（ビジネスプロセスサービス実行時）

図中の番号

トレース取得ポイント

1

標準受付（Webサービス）の入口

2

標準受付（Webサービス）の出口

1

標準受付（SessionBean）の入口

2

標準受付（SessionBean）の出口

1

標準受付（MDB（WS-R））の入口

2

標準受付（MDB（WS-R））の出口

1

標準受付（MDB（DBキュー））の入口

2

標準受付（MDB（DBキュー））の出口

1

ユーザ定義受付の入口

2

ユーザ定義受付の出口

7

SOAPアダプタのサービス部品呼び出し口

8

SOAPアダプタのサービス部品応答受信口

7

SessionBeanアダプタのサービス部品呼び出し口

8

SessionBeanアダプタのサービス部品応答受信口

7

MDB（WS-R）アダプタのサービス部品呼び出し口

8

MDB（WS-R）アダプタのサービス部品応答受信口

7

MDB（DBキュー）アダプタのサービス部品呼び出し口

8

MDB（DBキュー）アダプタのサービス部品応答受信口

7

上記以外のサービスアダプタ（CUSTOM）のサービス部品呼び出し口

8

上記以外のサービスアダプタ（CUSTOM）のサービス部品応答受信口

3

ビジネスプロセスサービスの呼び出し口

4

ビジネスプロセスサービスの応答受信口

5

ビジネスプロセス受付の入口

6

ビジネスプロセス受付の出口

9

データ変換アクティビティの変換元※1

10

データ変換アクティビティの変換先

11

代入アクティビティのコピー元※2，※3

12

代入アクティビティのコピー先

注※1

変換元変数が複数定義されている場合は，定義された個数分ユーザ電文トレースが出力されます。

注※2

電文でない場合（文字列，数値，真偽値）は，変数の文字列表現をUTF-8でエンコードしたバイナリデータがユーザ電文として出力されます。

注※3

コピー元に式（XPath）を指定した場合，またはコピー元に定数を指定した場合は，ユーザ電文トレースが出力されません。

(e)　NORMAL（ユーザが指定したHCSCコンポーネントの正常終了時）

ユーザ電文トレースに出力するHCSCコンポーネントを指定した場合の，トレース取得ポイントを次の図に示します。メッセージ配送制御およびビジネスプロセス内では出力されません。

出力対象とするHCSCコンポーネントは，HCSCサーバランタイム定義ファイルのtelegramtrace-component-type-filepathプロパティまたはtelegramtrace-component-id-filepathプロパティで設定します。

図7‒29　ユーザ電文トレースの取得ポイント（ユーザが指定したHCSCコンポーネントの正常終了時）

トレース取得ポイントを次の表に示します。表の「図中の番号」は，「図7-29　ユーザ電文トレースの取得ポイント（ユーザが指定したHCSCコンポーネントの正常終了時）」中の番号と対応しています。

表7‒51　ユーザ電文トレース取得ポイント（ユーザが指定したHCSCコンポーネントの正常終了時）

図中の番号

トレース取得ポイント

1

標準受付（Webサービス）の入口

2

標準受付（Webサービス）の出口

1

標準受付（SessionBean）の入口

2

標準受付（SessionBean）の出口

1

標準受付（MDB（WS-R））の入口

2

標準受付（MDB（WS-R））の出口

1

標準受付（MDB（DBキュー））の入口

2

標準受付（MDB（DBキュー））の出口

1

ユーザ定義受付の入口

2

ユーザ定義受付の出口

3

データ変換（要求電文）の応答受信口

4

データ変換（応答電文）の呼び出し口

5

カスタム受付フレームワークのJSON-XML変換（要求電文）の呼び出し口

6

カスタム受付フレームワークのJSON-XML変換（応答電文）の応答受信口

7

SOAPアダプタのサービス部品呼び出し口

8

SOAPアダプタのサービス部品応答受信口

7

SessionBeanアダプタのサービス部品呼び出し口

8

SessionBeanアダプタのサービス部品応答受信口

7

MDB（WS-R）アダプタのサービス部品呼び出し口

8

MDB（WS-R）アダプタのサービス部品応答受信口

7

MDB（DBキュー）アダプタのサービス部品呼び出し口

8

MDB（DBキュー）アダプタのサービス部品応答受信口

7

上記以外のサービスアダプタ（CUSTOM）のサービス部品呼び出し口

8

上記以外のサービスアダプタ（CUSTOM）のサービス部品応答受信口

9

データ変換（要求電文）の呼び出し口

10

データ変換（応答電文）の応答受信口

11

カスタムアダプタ開発フレームワークのJSON-XML変換の呼び出し口

12

カスタムアダプタ開発フレームワークのJSON-XML変換の応答受信口

(f)　SYSERR（システム例外検出時）

システム例外（OutOfMemoryErrorなどのシステムエラーは含まない）を検出した場合のユーザ電文トレースのトレース取得ポイントを次の図に示します。

図7‒30　ユーザ電文トレースの取得ポイント（システム例外検出時）

トレース取得ポイントについて次の表に示します。表の取得位置番号は，上の図の番号と対応しています。なお，待機アクティビティ，分岐アクティビティ，繰り返しアクティビティ，リンクコネクションでは出力されません。

表7‒52　ユーザ電文トレース取得ポイント（システム例外検出時）

図中の番号

出力ポイント

出力電文

ユーザ電文トレース開始の詳細

取得ポイント

プロトコル種別

詳細位置

1

リクエスト受付（サービス呼出時）

リクエスタ側電文

RCP/URCP

SOAP/EJB/

WSR/DBQ/

CUSTM

ERR

2

Java呼出アクティビティ

Javaプログラムを呼ぶ際の引数※1，※2

BPJAV

−

3

サービス呼出アクティビティ

サービスを呼ぶ際の要求電文

BPSVC

4

データ変換アクティビティ

変換元変数※2

BPCNV

5

代入アクティビティ

コピー元変数※3

BPASG

6

検証アクティビティ

検証する変数※2

BPVLD

7

応答アクティビティ

リクエスタへの応答電文

BPRPL

8

フォルト送出アクティビティ

フォルト送出する変数

BPFLT

9

ログ出力アクティビティ

埋め込み要素に指定した変数※4

BPLOG

（凡例）

−：該当しません。

注※1

電文でない場合（文字列，数値，真偽値）は，変数の文字列表現をUTF-8でエンコードしたバイナリデータがユーザ電文として出力されます。

注※2

変数が複数定義されている場合は，定義された数だけユーザ電文トレースが出力されます。

注※3

次の場合にはユーザ電文トレースが出力されません。

・コピー元に式（XPath）を指定した場合

・コピー元に定数を指定した場合

注※4

埋め込み要素に変数を指定した場合だけユーザ電文トレースが出力されます。式（XPath）を指定した場合は出力されません。

(g)　FAULT（フォルト検出時）

フォルトを検出した場合のユーザ電文トレースのトレース取得ポイントを次の図に示します。

図7‒31　ユーザ電文トレースの取得ポイント（フォルト検出時）

トレース取得ポイントについて次の表に示します。表の取得位置番号は，上の図の番号と対応しています。

表7‒53　ユーザ電文トレース取得ポイント（フォルト検出時）

図中の番号

出力ポイント

出力電文

ユーザ電文トレース開始の詳細

取得ポイント

プロトコル種別

詳細位置

1

リクエスト受付（サービス呼出時）

要求電文

RCP/URCP

SOAP/EJB/

WSR/DBQ

ERR

フォルト電文

−

2

Java呼出アクティビティ

Javaプログラムを呼ぶ際の引数※1，※2

BPJAV

フォルト電文

3

サービス呼出アクティビティ

サービスを呼ぶ際の要求電文

BPSVC

フォルト電文

4

検証アクティビティ

検証する変数※2

BPVLD

フォルト電文

5

フォルト送出アクティビティ

フォルト送出する変数※3

BPFLT

フォルト電文※4

6

データ変換アクティビティ

変換元変数※2

BPCNV

フォルト電文

7

代入アクティビティ

コピー元変数※5

BPASG

フォルト電文

8

分岐アクティビティ

フォルト電文

BPSWT

9

繰り返しアクティビティ

フォルト電文

BPWHL

10

リンクコネクション

フォルト電文

BPLNK

11

ログ出力アクティビティ

埋め込み要素に指定した変数※6

BPLOG

フォルト電文

（凡例）

−：該当しません。

注

要求電文や割当変数は，取得できる場合だけ出力します。

注※1

電文でない場合（文字列，数値，真偽値）は，変数の文字列表現をUTF-8でエンコードしたバイナリデータがユーザ電文として出力されます。

注※2

変数が複数定義されている場合は，定義された数だけユーザ電文トレースが出力されます。

注※3

変数の情報とフォルト電文が一致するため，フォルト電文は出力されません。

注※4

システム例外が発生し汎用フォルトを出力する場合は，変数の情報とフォルト電文を出力します。

注※5

コピー元変数が複数定義されている状態でフォルト例外が発生した場合，例外の発生原因となったコピー元変数をログに出力します。また，次の場合はユーザ電文トレースが出力されません。

・コピー元に式（XPath）を指定した場合

・コピー元に定数を指定した場合

注※6

埋め込み要素が複数定義されている状態でフォルト例外が発生した場合，例外の発生原因となった埋め込み要素がログに出力されます。また，例外の発生原因となった埋め込み要素が式（XPath）の場合は，ユーザ電文トレースが出力されません。

7.4.5　アクティビティトレース

開発環境ではアクティビティトレースを出力できます。アクティビティトレースには，アクティビティの処理経路を出力できます。

アクティビティトレースの出力対象とタイミングを次に示します。

出力対象のビジネスプロセス

すべてのビジネスプロセスがアクティビティトレースの対象になります。特定のビジネスプロセスだけを出力対象に指定することはできません。

出力対象のアクティビティ

次に示すアクティビティを除くすべてのアクティビティが出力対象になります。

分岐終了アクティビティ

並列処理終了アクティビティ

アクティビティトレースの出力のタイミング

アクティビティが呼び出された時点で，アクティビティトレースを出力します。

この項では，アクティビティトレースの出力先や出力される内容，および利用方法の例について説明します。アクティビティトレースの取得方法については，「7.3.2(5)　アクティビティトレースの取得方法」を参照してください。

(1)　アクティビティトレースの出力先

アクティビティトレースの出力先とファイル名を次の表に示します。

表7‒54　アクティビティトレースの出力先とトレースファイル名

トレースの出力先パス

トレースファイル名

<J2EEサーバのログ出力ディレクトリ>¥csc

cscbp_activity_trc_<HCSCサーバ名>_<面数>.log

<J2EEサーバのログ出力ディレクトリ>は，usrconf.cfg（J2EEサーバ用オプション定義ファイル）のejb.server.log.directoryキーで変更できます。usrconf.cfgの詳細は，マニュアル「アプリケーションサーバリファレンス 定義編(サーバ定義)」の「2.2.2　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。

トレースファイル名の面数，ファイルサイズ，および出力する項目はHCSCサーバランタイム定義ファイルの次のプロパティで変更できます。

bpacttrace-filenum=ビジネスプロセスのアクティビティトレース面数

bpacttrace-filesize=ビジネスプロセスのアクティビティトレースファイルサイズ

bpacttrace-extend-item=追加出力項目

アクティビティトレースのプロパティについては，マニュアル「サービスプラットフォーム リファレンス」の「6.5.6　HCSCサーバランタイム定義ファイル」を参照してください。

(2)　アクティビティトレースの出力形式と出力される内容

(a)　出力形式

アクティビティトレースの出力形式を次の図に示します。

図7‒32　アクティビティトレースの出力形式

(b)　出力される内容

アクティビティトレースに出力される内容を次の表に示します。

表7‒55　アクティビティトレースに出力される内容

項目

内容

番号

アクティビティトレースの出力通番が表示されます。

日付

アクティビティトレースの取得日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

アクティビティトレースの取得時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

ローカル時刻でミリ秒単位の時刻を示します。

製品ID

製品を特定するための識別子として，「CSCBP」が表示されます。

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID

空白

ビジネスプロセス名

開発環境で設定したビジネスプロセス名が出力されます。

サービスID

開発環境で設定したビジネスプロセスのサービスIDが出力されます。

アクティビティ名

アクティビティ名が出力されます。

プロセスインスタンスID

プロセスインスタンスIDが出力されます。

HCSCサーバランタイム定義ファイルのbpacttrace-extend-itemプロパティに，PROCESSINSTANCEIDが指定されている場合に出力されます。

詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.5.6　HCSCサーバランタイム定義ファイル」を参照してください。

CRLF

レコードの終端符号が出力されます。

(3)　アクティビティトレースの出力例

アクティビティトレースの出力例を次に示します。

この例では，「在庫引当結果チェック」後に右側のフローに遷移しています。

(4)　アクティビティトレースの利用方法の例

アクティビティトレース内には複数のビジネスプロセスのトレースが出力されます。ここでは，アクティビティトレース内から一意のリクエストを特定する方法について説明します。

応答後にアクティビティを定義しない場合

リクエストで一意な情報はtid（スレッドを識別するためのID）です。アクティビティトレースに出力されているtidを基に，リクエストを対応付けます。

応答後にアクティビティを定義する場合

リクエストで一意な情報はプロセスインスタンスIDです。アクティビティトレースに出力されているプロセスインスタンスIDを基にリクエストを対応付けます。

アクティビティトレースにプロセスインスタンスIDを出力するには，HCSCサーバランタイム定義ファイルのbpacttrace-extend-itemプロパティにPROCESSINSTANCEIDを指定します。詳細については，マニュアル「サービスプラットフォームリファレンス」の「6.5.6　HCSCサーバランタイム定義ファイル」を参照してください。

7.4.6　デバッグ情報

デバッグ情報を出力できる機能を次の表に示します。また，各機能の出力形式の指定可否もあわせて示します。

デバッグ情報を出力できる機能

出力形式の指定可否

ユーザ電文トレース機能

○

データ変換API

×

データ変換単体テストコマンド

　csctransformコマンド

　cscbinaryparseコマンド

　cscgenbinaryコマンド

（凡例）

○：HCSCサーバランタイム定義ファイルのtelegramtrace-formatプロパティで，16進数形式データとASCII形式データの出力行を分けるかどうかを指定できます。

×：出力形式は指定できません。16進数形式データとASCII形式データは同じ行に出力されます。

デバッグ情報の取得を設定した場合，ユーザ電文トレースで出力されるデバッグ情報は次の3つの部分で構成されます。

ユーザ電文トレース（デバッグ情報）開始

ユーザ電文トレース（デバッグ情報）データ

ユーザ電文トレース（デバッグ情報）終了

デバッグ情報の出力形式を次に示します。

この項は，取得されたユーザ電文トレース（デバッグ情報）の確認方法について説明します。デバッグ情報の取得方法については，「7.3.2(6)　デバッグ情報の取得方法」を参照してください。

注意事項

デバッグ情報は電文の内容をファイルに出力します。そのため，情報漏洩などのセキュリティ上の問題が発生しないよう，取り扱いに注意してください。

(1)　ユーザ電文トレース（デバッグ情報）の出力先

ユーザ電文トレース（デバッグ情報）の出力先を次に示します。

(a)　データ変換APIの実行時に出力されるデバッグ情報

ユーザ電文トレース（デバッグ情報）は，usrconf.properties（J2EEサーバ用ユーザプロパティファイル）のcsc.dt.debugtrace.filepathプロパティで指定されたパスへ出力されます。ファイル名を次に示します。

ラップアラウンドモードの場合

cscdebug_<グループ名>_<面数>.log

シフトモードの場合

cscdebug_<グループ名>_.log

<グループ名>には，データ変換APIのインスタンス（グループ）の名称が付加されます。

<面数>には，usrconf.properties（J2EEサーバ用ユーザプロパティファイル）で設定した面数が付加されます。

(b)　HCSCサーバでのデータ変換時に出力されるデバッグ情報

ユーザ電文トレース（デバッグ情報）は，HCSCサーバランタイム定義ファイルのtelegramtrace-filepathプロパティで指定されたパスへ出力されます。なお，指定したパスが存在しない場合，またはパスが誤っていた場合は，省略値の出力先にトレースが出力されます。

ファイル名を次に示します。

ラップアラウンドモードの場合

csctelegram_<HCSCサーバ名>_<面数>.log

シフトモードの場合

csctelegram_<HCSCサーバ名>_.log

<面数>には，HCSCサーバランタイム定義ファイルで設定した面数が付加されます。

(c)　データ変換単体テストコマンドの実行時に出力されるデバッグ情報

ユーザ電文トレース（デバッグ情報）は，データ変換単体テストコマンド（csctransformコマンド，cscbinaryparseコマンド，およびcscgenbinaryコマンド）で指定されたパスへ出力されます。ファイル名を次に示します。

cscdebug_dtcommand_<面数>.log

<面数>には面数が付加されます。面数の最大は16，1面当たりの最大サイズは2147483647バイトです。面数の最大値，最大サイズ，ローテーション方式は変更できません。

(2)　ユーザ電文トレース（デバッグ情報）開始の出力形式と出力される内容

(a)　出力形式

ユーザ電文トレース（デバッグ情報）開始の出力形式を次の図に示します。

図7‒33　ユーザ電文トレース（デバッグ情報）開始の出力形式

(b)　出力される内容

ユーザ電文トレース（デバッグ情報）開始に出力される内容を次の表に示します。

表7‒56　ユーザ電文トレース（デバッグ情報）開始に出力される内容

項目

内容

番号

トレースレコードの出力通番が表示されます。

日付

トレースレコードの取得日付（yyyy/mm/dd形式）が出力されます。

時刻

トレースレコードの取得時刻（hh:mm:ss.SSS形式）が，ローカル時刻でミリ秒単位に出力されます。

製品ID

製品を特定するための識別子が出力されます。

CSCDT：CSCデータ変換

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID

表示されません。

電文トレース開始取得ポイント識別情報

電文トレース開始

ユーザ電文トレース開始を示す文字列「debugtrace started」が出力されます。

取得位置

トレースの取得ポイント情報（取得位置）が出力されます。

DT：データ変換処理

プロトコル種別

表示されません。

詳細位置

トレースの取得ポイント情報（詳細位置）が出力されます。

RED：バイナリデータの読込処理

WRT：バイナリデータの生成処理

メッセージ共通ID

表示されません。

付加情報

次の付加情報が出力されます。

(a) バイナリデータの場合

データ種別（Binary）

入力データ全体のサイズ

エラー時の読込位置（オフセット）

ルートアプリケーション情報※1

(b) DOMの場合

データ種別（DOM）

エラー発生時に処理していたノードの絶対パス※2

ルートアプリケーション情報※1

CRLF

レコード終端符号が出力されます。

注※1

csctransformコマンドおよびcscbinaryparseコマンドのデバッグ情報には出力されません。

注※2

同名の要素が複数存在する場合は，パスの該当部分には要素の出現位置を1から始まる添字で次のように出力します。

　例）ノード名[要素の出現位置]

なお，バイナリデータ読み込み処理完了後にバイナリデータが残っていた場合は，Nodeタグは出力されません。

(3)　ユーザ電文トレース（デバッグ情報）データの出力形式と出力される内容

データ変換基盤では，エラー発生までに処理した電文の情報をデバッグ情報としてユーザ電文トレースに出力できます。

デバッグ情報で出力される内容を次に示します。

表7‒57　デバッグ情報で出力される内容

出力タイミング

出力されるデバッグ情報

用途

バイナリデータの読込時（バイナリデータ→DOMの変換）

読み込みが完了したバイナリデータ，およびDOMの情報

処理中のデータに不正なデータが存在した場合，内容を確認できます。

入力データ全体のサイズ

入力データの不正な個所を特定できます。

入力データに対する現在の読み込み位置（エラーが発生した際の読み込み位置）

エラー発生時に処理していたノードの絶対パス

ルートアプリケーション情報

同じルートアプリケーション情報をメッセージログから引き当てることで，エラー原因のメッセージ出力個所を特定できます。

バイナリデータの生成時（DOM→バイナリデータの変換）

エラーが起きたノードまでのDOMの情報

処理中のデータに不正なデータが存在した場合，内容を確認できます。

エラー発生時に処理していたノードの絶対パス

入力データの不正な個所を特定できます。

ルートアプリケーション情報

同じルートアプリケーション情報をメッセージログから引き当てることで，エラー原因のメッセージ出力個所を特定できます。

なお，デバッグ情報に出力されたノードがエラーの原因とは限らないため，前後のノードの情報と，それに対応するバイナリデータも参照してください。

(a)　出力形式（telegramtrace-format=FIXEDを指定した場合）

HCSCサーバランタイム定義ファイルにtelegramtrace-format=FIXEDを指定した場合のユーザ電文トレース（デバッグ情報）データの出力形式を次の図に示します。

図7‒34　ユーザ電文トレース（デバッグ情報）データの出力形式（telegramtrace-format=FIXEDを指定した場合）

(b)　出力される内容（telegramtrace-format=FIXEDを指定した場合）

HCSCサーバランタイム定義ファイルにtelegramtrace-format=FIXEDを指定した場合のユーザ電文トレース（デバッグ情報）データに出力される内容を次の表に示します。なお，デバッグ情報がない場合（バイナリ，DOMのデータ長が0またはnullの場合）は，トレースデータを出力しません。

表7‒58　ユーザ電文トレース（デバッグ情報）データに出力される内容（telegramtrace-format=FIXEDを指定した場合）

項目

内容

番号

トレースレコードの出力通番が表示されます。

日付

トレースレコードの取得日付（yyyy/mm/dd形式）が出力されます。

時刻

トレースレコードの取得時刻（hh:mm:ss.SSS形式）が，ローカル時刻でミリ秒単位に出力されます。

製品ID

製品を特定するための識別子が出力されます。

CSCDT：CSCデータ変換

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID

表示されません。

電文トレースデータ情報

出力位置（16進数形式）

ユーザ電文の先頭からのオフセット値（16進数形式）が出力されます。

データ（16進数形式）

ユーザ電文（バイナリデータまたはDOM）の内容が16進数形式で出力されます。

データ（ASCII形式）

ユーザ電文（バイナリデータまたはDOM）の内容がASCII形式で出力されます。

0x00〜0x1F，0x7F〜0xFFの範囲の場合はASCII文字，それ以外の場合はピリオド（.）が出力されます。

CRLF

レコード終端符号が出力されます。

(c)　出力形式（telegramtrace-format=READABLEを指定した場合）

HCSCサーバランタイム定義ファイルにtelegramtrace-format=READABLEを指定した場合，16進数形式データとUTF-8形式データはそれぞれ別の行に出力されます。それぞれの出力形式を次の図に示します。

図7‒35　ユーザ電文トレース（デバッグ情報）データの出力形式（telegramtrace-format=READABLEを指定した場合）（16進数形式データ）

図7‒36　ユーザ電文トレース（デバッグ情報）データの出力形式（telegramtrace-format=READABLEを指定した場合）（UTF-8形式データ）

(d)　出力される内容（telegramtrace-format=READABLEを指定した場合）

HCSCサーバランタイム定義ファイルにtelegramtrace-format=READABLEを指定した場合，16進数形式データとUTF-8形式データの出力内容が異なります。それぞれの出力形式を次の表に示します。

表7‒59　ユーザ電文トレース（デバッグ情報）データに出力される内容（telegramtrace-format=READABLEを指定した場合）（16進数形式データ）

項目

内容

番号

トレースレコードの出力通番が表示されます。

日付

トレースレコードの取得日付（yyyy/mm/dd形式）が出力されます。

時刻

トレースレコードの取得時刻（hh:mm:ss.SSS形式）が，ローカル時刻でミリ秒単位に出力されます。

製品ID

製品を特定するための識別子が出力されます。

CSCDT：CSCデータ変換

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID

表示されません。

電文トレースデータ情報

出力位置（16進数形式）

ユーザ電文の先頭からのオフセット値（16進数形式）が出力されます。

データ（16進数形式）

ユーザ電文（バイナリデータまたはDOM）の内容が16進数形式で出力されます。

CRLF

レコード終端符号が出力されます。

表7‒60　ユーザ電文トレースデータに出力される内容（telegramtrace-format=READABLEを指定した場合）（UTF-8形式データ）

項目

内容

番号

トレースレコードの出力通番が表示されます。

日付

トレースレコードの取得日付（yyyy/mm/dd形式）が出力されます。

時刻

トレースレコードの取得時刻（hh:mm:ss.SSS形式）が，ローカル時刻でミリ秒単位に出力されます。

製品ID

製品を特定するための識別子が出力されます。

CSCDT：CSCデータ変換

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID

表示されません。

電文トレースデータ情報

データ（UTF-8形式）

ユーザ電文（バイナリデータまたはDOM）の内容をUTF-8形式で出力します。

0x20〜0x7Eの範囲にある文字は，ASCII文字として出力します。

次の範囲にある文字は，ピリオド（.）を出力します。

0x00〜0x08

0x0B〜0x0C

0x0E〜0x1F

0x7F

0x09の場合は，水平タブを出力します。

改行コード（0x0aまたは0x0d）は出力しません。

0xFE〜0xFFの範囲にある文字は，クエスチョンマーク（?）を出力します。

マルチバイト文字として正しく記述されている場合は，マルチバイト文字を出力します※。

CRLF

レコード終端符号が出力されます。

注

ユーザ電文トレースの1行の長さは最大4,185バイトです。それを超えた分は次の行に出力されます。4,185バイト目のデータがマルチバイト文字の場合，マルチバイト文字は次の行に出力されます。

注※

マルチバイト文字の文字コードの割り当て範囲を次の表に示します。

表7‒61　UTF-8のマルチバイト文字の割り当て範囲

区分

文字コードの範囲（16進数）

2バイト文字の開始バイト

0xC0〜0xDF

3バイト文字の開始バイト

0xE0〜0xEF

4バイト文字の開始バイト

0xF0〜0xF7

5バイト文字の開始バイト

0xF8〜0xFB

6バイト文字の開始バイト

0xFC〜0xFD

マルチバイト文字の2バイト目以降

0x80〜0xBF

なお，この範囲内でも出力するデータの並びが文字セットにとって不当な場合や，出力するデータの並びが正当でも有効な文字に対応付けできない場合は，クエスチョンマーク（?）を出力します。

(4)　ユーザ電文トレース（デバッグ情報）終了の出力形式と出力される内容

(a)　出力形式

ユーザ電文トレース（デバッグ情報）終了の出力形式を次の図に示します。

図7‒37　ユーザ電文トレース（デバッグ情報）終了の出力形式

付加情報のデータ長の上限は目安です。上限値を超えても切り捨てられないで出力されます。

(b)　出力される内容

ユーザ電文トレース（デバッグ情報）終了に出力される内容を次の表に示します。

表7‒62　ユーザ電文トレース（デバッグ情報）終了に出力される内容

項目

内容

番号

トレースレコードの出力通番が表示されます。

日付

トレースレコードの取得日付（yyyy/mm/dd形式）が出力されます。

時刻

トレースレコードの取得時刻（hh:mm:ss.SSS形式）が，ローカル時刻でミリ秒単位に出力されます。

製品ID

製品を特定するための識別子が出力されます。

CSCDT：データ変換基盤

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID

表示されません。

電文トレース終了取得ポイント識別情報

電文トレース終了

ユーザ電文トレース終了を示す文字列「debugtrace ended」が出力されます。

取得位置

トレースの取得ポイント情報（取得位置）が出力されます。

DT：データ変換処理

プロトコル種別

表示されません。

詳細位置

トレースの取得ポイント情報（詳細位置）が出力されます。

RED：バイナリデータの読込処理

WRT：バイナリデータの生成処理

メッセージ共通ID

表示されません。

付加情報

付加情報として，ユーザ電文の長さが10進数形式で出力されます。ユーザ電文がない場合は「null」，0バイトの場合は「0」が出力されます。

CRLF

レコード終端符号が出力されます。

(5)　ユーザ電文トレース（デバッグ情報）の出力契機

デバッグ情報の出力契機は，機能ごとに次のように異なります。

(a)　データ変換APIの実行時に出力されるデバッグ情報

データ変換APIでのバイナリデータの変換処理中にエラーが発生した場合，デバッグ情報が出力されます。

(b)　HCSCサーバでのデータ変換時に出力されるデバッグ情報

HCSCサーバのデータ変換時のデバッグ情報を出力する場合（HCSCサーバランタイム定義ファイルのtelegramtrace-triggerプロパティに「DTERR」を指定した場合），デバッグ情報は次のタイミングで出力されます。

表7‒63　ユーザ電文トレース（デバッグ情報）の出力契機と出力内容

タイミング

出力されるデバッグ情報

バイナリデータの読込処理（バイナリからDOMへの変換）時

エラー発生までに処理した電文（バイナリ，DOM）の情報

バイナリデータの生成処理（DOMからバイナリへの変換）時

エラー発生までに処理した電文（DOM）の情報

(c)　データ変換単体テストコマンドの実行時に出力されるデバッグ情報

データ変換単体テストコマンド（csctransformコマンド，cscbinaryparseコマンド，およびcscgenbinaryコマンド）の実行時にエラーが発生した場合，デバッグ情報が出力されます。

(6)　ユーザ電文トレース（デバッグ情報）の取得ポイント

ユーザ電文トレース（デバッグ情報）のデバッグ情報を出力する場合の取得ポイントを説明します。

バイナリデータのデータ変換処理の解析エラー発生時に関して，ユーザ電文トレース（デバッグ情報）のトレース取得ポイントを次の図に示します。

図7‒38　ユーザ電文トレース（デバッグ情報）の取得ポイント（バイナリデータのデータ変換処理の解析エラー発生時）

トレース取得ポイントを次の表に示します。表の「図中の番号」は，上の図の中の番号と対応しています。

表7‒64　ユーザ電文トレース（デバッグ情報）取得ポイント（バイナリデータのデータ変換処理の解析エラー発生時）

図中の番号

トレース取得ポイント

1

バイナリデータの読込処理のエラー発生個所

2

バイナリデータの生成処理のエラー発生個所

(7)　詳細情報メッセージの出力

バイナリデータ変換処理でエラーが発生した場合，デバッグ情報の出力可否に関係なく，詳細情報メッセージ（KDEC40312-I，KDEC40313-I）がメッセージログに出力されます。

詳細情報メッセージには次に示す情報が出力されるため，入力データの不正な個所の特定に利用できます。

エラー発生時に処理していたノードの絶対パス

エラー発生時の入力データの読み込み位置

入力データの全体サイズ

保守情報

また，詳細情報メッセージの出力個所の前後には，エラーの原因を示す例外メッセージが出力されているため，あわせて確認してください。

7.4.7　保守用ログおよびトレース

障害調査に必要な情報として，保守用のログおよびトレースなどを採取します。

(1)　例外ログ

HCSCサーバの障害時の内部エラー情報やビジネスプロセスの障害情報などは，例外ログとして取得します。例外ログは，保守員が障害解析用に使用します。サービスプラットフォームの例外ログとして出力される内容と出力先を次の表に示します。

表7‒65　例外ログの出力内容と出力先

例外ログの種類

出力される内容

例外ログファイルの出力先パス

ログファイル名

HCSC-Managerの例外ログ

HCSC-Manager内部の例外情報を取得します。

HCSC-Manager定義ファイル※1のcscmng.log.dirパラメタで指定したパス

exception<面数>.log※1

J2EEサーバの障害発生時の例外情報

HCSCサーバで障害が発生したときの内部の例外情報を取得します。

J2EEサーバの例外ログ（障害発生時の例外情報）の出力先※2に指定されたパス

ラップアラウンドモードの場合

cjexception<面数>.log※1

シフトモードの場合

cjexception.log

HCSCサーバの例外ログ

次の場所で発生した例外情報（スタックトレース）を取得します。

カスタム受付フレームワーク，カスタムアダプタ開発フレームワークのEJB呼び出し部分

カスタム受付フレームワーク，カスタムアダプタ開発フレームワークを使用する受付およびサービスアダプタ

HCSCサーバ（標準受付，SOAP受付，メッセージ配送制御，SOAPアダプタ，SessionBeanアダプタ，MDB（WS-R）アダプタ，MDB（DBキュー）アダプタなど）

HCSCサーバランタイム定義ファイル※3のmethodtrace-filepathプロパティで指定したパス

ラップアラウンドモードの場合

cscmsgexp_<HCSCサーバ名>_<面数>.log※3

シフトモードの場合

cscmsgexp_<HCSCサーバ名>_.log

DBアダプタの例外ログ

DBアダプタで障害が発生した場合にスタックトレースを取得します。

HCSCサーバランタイム定義ファイル※3のmethodtrace-filepathプロパティで指定したパス

ラップアラウンドモードの場合

cscdbaexp_<HCSCサーバ名>_<面数>.log※3

シフトモードの場合

cscdbaexp_<HCSCサーバ名>_.log

TP1アダプタの例外ログ

TP1アダプタで障害が発生した場合にスタックトレースを取得します。

<J2EEサーバのログ出力ディレクトリ>¥CSCADP¥TP1ADP¥maintenance¥<サービスID>

ラップアラウンドモードの場合

exception<面数>.log※4

シフトモードの場合

exception.log

Object Accessアダプタの例外ログ

Object Accessアダプタで障害が発生した場合にスタックトレースを取得します。

<J2EEサーバのログ出力ディレクトリ>¥CSCADP¥OAADP¥maintenance¥<サービスID>

ラップアラウンドモードの場合

exception<面数>.log※5

シフトモードの場合

exception.log

Message Queueアダプタの例外ログ

Message Queueアダプタで障害が発生した場合にスタックトレースを取得します。

<J2EEサーバのログ出力ディレクトリ>¥CSCADP¥MQADP¥maintenance¥<サービスID>

ラップアラウンドモードの場合

exception<面数>.log※6

シフトモードの場合

exception.log

FTPアダプタの例外ログ

FTPアダプタで障害が発生した場合にスタックトレースを取得します。

FTPアダプタ実行環境プロパティファイルで指定したパス※7

ラップアラウンドモードの場合

cscftpadpexp_<HCSCサーバ名>_<面数>.log※7

シフトモードの場合

cscftpadpexp_<HCSCサーバ名>_.log

ファイル操作アダプタの例外ログ

ファイル操作アダプタで障害が発生した場合にスタックトレースを取得します。

<J2EEサーバのログ出力ディレクトリ>¥CSCADP¥ADPFOP¥maintenance¥<サービスID>

ラップアラウンドモードの場合

cscadpfopexp_<HCSCサーバ名>_<面数>.log※8

シフトモードの場合

cscadpfopexp_<HCSCサーバ名>_.log

メールアダプタの例外ログ

メールアダプタで障害が発生した場合にスタックトレースを取得します。

メールアダプタ実行環境プロパティファイルで指定したパス※9

ラップアラウンドモードの場合

cscmailadpexp_<HCSCサーバ名>_<面数>.log※9

シフトモードの場合

cscmailadpexp_<HCSCサーバ名>_.log

HTTPアダプタの例外ログ

HTTPアダプタで障害が発生した場合にスタックトレースを取得します。

<HTTPアダプタ実行環境プロパティファイルのadphttp.config.trace.pathプロパティ※10で指定したパス>¥CSCADP¥ADPHTTP¥maintenance¥<サービスID>

ラップアラウンドモードの場合

cscadphttpexp_<HCSCサーバ名>_<面数>.log※10

シフトモードの場合

cscadphttpexp_<HCSCサーバ名>_.log

コマンドアダプタの例外ログ

コマンドアダプタで障害が発生した場合にスタックトレースを取得します。

<J2EEサーバのログ出力ディレクトリ>¥CSCADP¥ADPCMD¥maintenance¥<サービスID>

ラップアラウンドモードの場合

cscadpcmdexp_<HCSCサーバ名>_<面数>.log※11

シフトモードの場合

cscadpcmdexp_<HCSCサーバ名>_.log

SFTPアダプタの例外ログ

SFTPアダプタで障害が発生した場合にスタックトレースを取得します。

<J2EEサーバのログ出力ディレクトリ>¥CSCADP¥SFTPADP¥maintenance¥<サービスID>

ラップアラウンドモードの場合

cscsftpadpexp_<HCSCサーバ名>_<面数>.log※12

シフトモードの場合

cscsftpadpexp_<HCSCサーバ名>_.log

Kafkaアダプタの例外ログ

Kafkaアダプタで障害が発生した場合にスタックトレースを取得します。

<J2EEサーバのログ出力ディレクトリ>¥CSCADP¥KAFKAADP¥maintenance¥<サービスID>

ラップアラウンドモードの場合

csckafkaadpexp_<HCSCサーバ名>_<面数>.log※13

シフトモードの場合

csckafkaadpexp_<HCSCサーバ名>_.log

gRPCアダプタの例外ログ

gRPCアダプタで障害が発生した場合にスタックトレースを取得します。

<J2EEサーバのログ出力ディレクトリ>¥CSCADP¥GRPCADP¥maintenance¥<サービスID>

ラップアラウンドモードの場合

cscadpgrpcexp_<HCSCサーバ名>_<面数>.log※14

シフトモードの場合

cscadpgrpcexp_<HCSCサーバ名>_.log

ビジネスプロセスの例外ログ

ビジネスプロセスで障害が発生した場合にスタックトレースを取得します。

HCSCサーバランタイム定義ファイル※3のmethodtrace-filepathプロパティで指定したパス

ラップアラウンドモードの場合

cscbpexp_<HCSCサーバ名>_<面数>.log※3

シフトモードの場合

cscbpexp_<HCSCサーバ名>_.log

ビジネスプロセス実行コマンド（csmexecutebpコマンド）の実行時に例外が発生した場合にスタックトレースを取得します。

ビジネスプロセス実行コマンド定義ファイルのexceptionlog-filepathプロパティで指定したパス※15

ラップアラウンドモードの場合

csmexecutebp_exp_<面数>.log※15

シフトモードの場合

csmexecutebp_exp_.log

注※1

HCSC-Manager定義ファイルで次のパラメタを指定します。

　cscmng.log.exception.filesize=例外ログファイルサイズ

　cscmng.log.exception.filenum=例外ログファイル面数

　cscmng.log.dir=例外ログ出力先ディレクトリパス

HCSC-Manager定義ファイルの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.5.3　HCSC-Manager定義ファイル」を参照してください。

注※2

J2EEサーバの例外ログ（障害発生時の例外情報）の出力先は，usrconf.cfg（J2EEサーバ用オプション定義ファイル）で指定します。デフォルトの出力先は，<サービスプラットフォームのインストールディレクトリ>¥CC¥server¥public¥ejb¥<J2EEサーバ名>¥logsです。

usrconf.cfgの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.2　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。

例外ログのファイルのサイズや面数などは，usrconf.properties（J2EEサーバ用ユーザプロパティファイル）で指定します。usrconf.propertiesの詳細については，推奨モードの場合はマニュアル「アプリケーションサーバリファレンス 定義編(サーバ定義)」の「2.2.3　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」を参照してください。V9互換モードの場合はマニュアル「アプリケーションサーバ 機能解説 互換編」の「10.1.1　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」を参照してください。

また，ログファイルのローテーション方式などの設定については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」を参照してください。

注※3

HCSCサーバランタイム定義ファイルでの出力先パスと面数の指定については，マニュアル「サービスプラットフォーム リファレンス」の「6.5.6　HCSCサーバランタイム定義ファイル」を参照してください。

注※4

TP1アダプタ実行環境プロパティファイルでの面数の指定については，マニュアル「サービスプラットフォーム リファレンス」の「6.7.1　TP1アダプタ実行環境プロパティファイル」を参照してください。

注※5

Object Accessアダプタ実行環境プロパティファイルでの面数の指定については，マニュアル「サービスプラットフォーム リファレンス」の「6.11.1　Object Accessアダプタ実行環境プロパティファイル」を参照してください。

注※6

Message Queueアダプタ実行環境プロパティファイルでの面数の指定については，マニュアル「サービスプラットフォーム リファレンス」の「6.12.1　Message Queueアダプタ実行環境プロパティファイル」を参照してください。

注※7

例外ログファイルは保守用ログと同じディレクトリに出力されます。FTPアダプタ実行環境プロパティファイルでの出力先パスと面数の指定については，マニュアル「サービスプラットフォームリファレンス」の「6.8.3　FTPアダプタ実行環境プロパティファイル」を参照してください。

注※8

例外ログファイルは保守用ログと同じディレクトリに出力されます。ファイル操作アダプタ実行環境プロパティファイルでの面数の指定については，マニュアル「サービスプラットフォームリファレンス」の「6.8.8　ファイル操作アダプタ実行環境プロパティファイル」を参照してください。

注※9

例外ログファイルはメンテナンスログと同じディレクトリに出力されます。メールアダプタ実行環境プロパティファイルでの出力先パスと面数の指定については，マニュアル「サービスプラットフォームリファレンス」の「6.13.3　メールアダプタ実行環境プロパティファイル」を参照してください。

注※10

例外ログファイルはメンテナンスログと同じディレクトリに出力されます。HTTPアダプタ実行環境プロパティファイルでの出力先パスと面数の指定については，マニュアル「サービスプラットフォームリファレンス」の「6.14.2　HTTPアダプタ実行環境プロパティファイル」を参照してください。

注※11

例外ログファイルはメンテナンスログと同じディレクトリに出力されます。コマンドアダプタ実行環境プロパティファイルでの面数の指定については，マニュアル「サービスプラットフォームリファレンス」の「6.15.3　コマンドアダプタ実行環境プロパティファイル」を参照してください。

注※12

例外ログファイルは保守用ログと同じディレクトリに出力されます。SFTPアダプタ実行環境プロパティファイルでの面数の指定については，マニュアル「サービスプラットフォームリファレンス」の「6.16.1　SFTPアダプタ実行環境プロパティファイル」を参照してください。

注※13

例外ログファイルは保守用ログと同じディレクトリに出力されます。Kafkaアダプタ実行環境プロパティファイルでの面数の指定については，マニュアル「サービスプラットフォームリファレンス」の「6.17.1　Kafkaアダプタ実行環境プロパティファイル」を参照してください。

注※14

例外ログファイルは保守用ログと同じディレクトリに出力されます。gRPCアダプタ実行環境プロパティファイルでの面数の指定については，マニュアル「サービスプラットフォームリファレンス」の「6.19.1　gRPCアダプタ実行環境プロパティファイル」を参照してください。

注※15

ビジネスプロセス実行コマンド定義ファイルでの出力先パスと面数の指定については，マニュアル「サービスプラットフォーム リファレンス」の「3.21.1　ビジネスプロセス実行コマンド定義ファイル」を参照してください。

(2)　メンテナンスログ

HCSC-Manager内部の保守情報をメンテナンスログとして取得できます。HCSC-Managerと外部要素（Manager，HCSC管理MBean，リポジトリ）との通信トレース，電文ログとしても使用されます。保守員が障害解析用に使用します。

メンテナンスログとして出力される内容と出力先を次の表に示します。

表7‒66　メンテナンスログの出力内容と出力先

出力される内容

メンテナンスログファイルの出力先パス

ログファイル名

HCSC-Manager内部の保守情報を取得します。

HCSC-Manager定義ファイルのcscmng.log.dirパラメタで指定したパス

maintenance<面数>.log

(3)　メソッドトレース

HCSCサーバで障害が発生し，原因の究明が困難な場合に，必要な情報をメソッドトレースとして取得できます。保守員が障害解析のために使用します。

メソッドトレースとして出力される内容と出力先を次の表に示します。

表7‒67　メソッドトレースの出力内容と出力先

メソッドトレースの種類

出力される内容

メソッドトレースの出力先パス

トレースファイル名

HCSCサーバ（メッセージング基盤）のメソッドトレース

HCSCサーバ（メッセージング基盤）内部の保守情報を取得します。

HCSCサーバランタイム定義ファイルのmethodtrace-filepathプロパティで指定したパス。

指定したパスが存在しない場合，またはパスが誤っていた場合は，省略値の出力先にトレースが出力されます。

ラップアラウンドモードの場合

cscmsgmtd_<HCSCサーバ名>_<面数>.log

シフトモードの場合

cscmsgmtd_<HCSCサーバ名>_.log

HCSCサーバ（ビジネスプロセス基盤）のメソッドトレース

HCSCサーバ（ビジネスプロセス基盤）内部の保守情報を取得します。

ビジネスプロセス基盤には，ビジネスプロセス実行時のトレースとプロセスインスタンス関連のコマンド実行時のトレースがあります。このマニュアルでは，ビジネスプロセス実行時のトレースについて説明します。

プロセスインスタンス関連のコマンド実行時のトレースはManagement Serverで出力されるトレースと同様です。詳細については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」を参照してください。

ラップアラウンドモードの場合

cscbpmtd_<HCSCサーバ名>_<面数>.log

シフトモードの場合

cscbpmtd_<HCSCサーバ名>_.log

HCSCサーバ（DBアダプタ）のメソッドトレース

HCSCサーバ（DBアダプタ）内部の保守情報を取得します。

ラップアラウンドモードの場合

cscdbamtd_<HCSCサーバ名>_<面数>.log

シフトモードの場合

cscdbamtd_<HCSCサーバ名>_.log

HCSCサーバのDBアダプタ以外のメソッドトレース

各サービスアダプタの内部の保守情報を取得します。

「7.7　サービス部品呼び出し要求時の障害対策」の各サービスアダプタの説明を参照してください。

7.4.8　ユーザ認証情報管理コマンドのメッセージログ

次に示すユーザ認証情報管理コマンドを実行すると，ユーザ認証情報管理コマンドのメッセージログに実行時の情報（通知・エラーなど）がメッセージとして出力されます。

csakeyaddコマンド（公開鍵認証の秘密鍵情報の登録・更新）

csakeydelコマンド（公開鍵認証の秘密鍵情報の削除）

csakeylsコマンド（公開鍵認証の秘密鍵情報の表示）

csauseraddコマンド（パスワード認証のユーザ情報の登録・更新）

csauserdelコマンド（パスワード認証のユーザ情報の削除）

csauserlsコマンド（パスワード認証のユーザ情報の表示）

ユーザ認証情報管理コマンドのメッセージログを参照することで，過去に実行したコマンドの障害情報や稼働情報を確認できます。

ここでは，出力されたユーザ認証情報管理コマンドのメッセージログの確認方法について説明します。

(1)　ユーザ認証情報管理コマンドのメッセージログの出力先

ユーザ認証情報管理コマンドのメッセージログの出力先およびログファイル名を次に示します。

<ユーザ認証情報管理コマンド定義ファイルのauthinfo.command.messagelog.filepathプロパティで指定したパス>¥message<面数>.log

ログファイルの情報は，ユーザ認証情報管理コマンド定義ファイルの次に示すプロパティで設定できます。

authinfo.command.messagelog.filenum（ログファイルの面数）

authinfo.command.messagelog.filesize（ログファイルのサイズ）

(2)　ユーザ認証情報管理コマンドのメッセージログの出力形式

ユーザ認証情報管理コマンドのメッセージログの出力形式を次の図に示します。

図7‒39　ユーザ認証情報管理コマンドのメッセージログの出力形式

(3)　ユーザ認証情報管理コマンドのメッセージログの出力内容

ユーザ認証情報管理コマンドのメッセージログに出力される内容を次の表に示します。

表7‒68　ユーザ認証情報管理コマンドのメッセージログに出力される内容

項目

内容

番号

コマンドのメッセージログの出力通番が表示されます。

日付

コマンドのメッセージログの取得日付がyyyy/mm/ddの形式で出力されます。

時刻

コマンドのメッセージログの取得時刻がhh:mm:ss.SSSの形式で出力されます。

製品ID

製品を特定するための識別子として，SFTPアダプタを示す「CSCMSG」が出力されます。

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

メッセージID

メッセージIDが「KDECnnnnn-X」の形式で出力されます。

メッセージテキスト

メッセージの内容が出力されます。

CRLF

レコードの終端符号が出力されます。

7.4.9　アカウント情報管理コマンドのメッセージログ

次に示すアカウント情報管理コマンドを実行すると，アカウント情報管理コマンドのメッセージログに実行時の情報（通知・エラーなど）がメッセージとして出力されます。

csahttpuseraddコマンド（HTTPアダプタで使用するアカウント情報の登録・更新）

csahttpuserdelコマンド（HTTPアダプタで使用するアカウント情報の削除）

csahttpuserlsコマンド（HTTPアダプタで使用するアカウント情報の表示）

アカウント情報管理コマンドのメッセージログを参照することで，過去に実行したコマンドの障害情報や稼働情報を確認できます。

ここでは，出力されたアカウント情報管理コマンドのメッセージログの確認方法について説明します。

(1)　アカウント情報管理コマンドのメッセージログの出力先

アカウント情報管理コマンドのメッセージログの出力先およびログファイル名を次に示します。

<アカウント情報管理コマンド定義ファイルのauthinfo.command.messagelog.filepathプロパティで指定したパス>¥adphttpcommand<面数>.log

ログファイルの情報は，アカウント情報管理コマンド定義ファイルの次に示すプロパティで設定できます。

authinfo.command.messagelog.filenum（ログファイルの面数）

authinfo.command.messagelog.filesize（ログファイルのサイズ）

(2)　アカウント情報管理コマンドのメッセージログの出力形式

アカウント情報管理コマンドのメッセージログの出力形式を次の図に示します。

図7‒40　アカウント情報管理コマンドのメッセージログの出力形式

(3)　アカウント情報管理コマンドのメッセージログの出力内容

アカウント情報管理コマンドのメッセージログに出力される内容を次の表に示します。

表7‒69　アカウント情報管理コマンドのメッセージログに出力される内容

項目

内容

番号

コマンドのメッセージログの出力通番が表示されます。

日付

コマンドのメッセージログの取得日付がyyyy/mm/ddの形式で出力されます。

時刻

コマンドのメッセージログの取得時刻がhh:mm:ss.SSSの形式で出力されます。

製品ID

製品を特定するための識別子として，HTTPアダプタを示す「ADPHTTP」が出力されます。

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

メッセージID

メッセージIDが「KDECnnnnn-X」の形式で出力されます。

メッセージテキスト

メッセージの内容が出力されます。

CRLF

レコードの終端符号が出力されます。

7.5　システムのセットアップまたはアンセットアップ時の障害対策

7.5.1　実行環境でのソフトウェア設定時の障害の調査

環境設定中など，システム操作時に障害が発生した場合の調査方法を説明します。ログの詳細については，「7.3　障害情報の取得」を参照してください。

(1)　データベースの操作中にエラーが発生した場合

HiRDBの場合，HiRDBのログ（pdlog(n)）に出力されているエラーメッセージを調査します。

Oracleの場合は，Oracle Corporationが発行するドキュメントを参照してください。

(2)　Managerの操作中にエラーが発生した場合

Management ServerやManagement Server-Administration Agentの起動に失敗するなどの障害が発生した場合，サービスプラットフォームが出力する障害情報（運用管理エージェント，運用監視エージェント，Management Serverのログ）に出力されているエラーメッセージを調査します。

(3)　Component Container（J2EEサーバ，またはComponent Container）の操作中にエラーが発生した場合

J2EEサーバの操作をしている場合は，J2EEサーバが出力する障害情報（J2EEサーバ，リダイレクタ，サーバ管理コマンドのログ）に出力されているエラーメッセージを調査します。

(4)　Reliable Messagingの操作中にエラーが発生した場合

まず，メッセージログに出力されているエラーメッセージを調査します。また，Reliable Messagingの開始停止メッセージログ，メソッドトレースを調査します。

メッセージの中に「HRM-xxxxx」という障害コードが出力されている場合は，マニュアル「Reliable Messaging」の「7.9　障害コードの詳細」を参照して，対処してください。

なお，障害調査のために次の情報が必要になる場合もあります。これらの設定内容を再度確認して調査し，対処します。

Reliable Messagingがコンフィグレーションプロパティに対して設定している情報

Reliable Messagingに関連づけているDB Connectorに設定している情報

(5)　DB Connectorの操作中にエラーが発生した場合

まず，メッセージログに出力されているエラーメッセージを調査します。また，障害が発生したDB Connector（リソースアダプタ）の稼働ログを参照して調査します。

障害を調査するためにDB Connectorに設定している情報が必要になる場合があります。これらの設定内容を再度確認して調査し，対処します。

7.5.2　セットアップまたはアンセットアップ時の障害の調査

(1)　ログの見方および障害の切り分け方法

セットアップまたはアンセットアップの実行中に障害が発生した場合の，障害の調査手順について次の図に示します。

図7‒41　障害の調査手順（セットアップまたはアンセットアップ時）

この図が示す調査の流れを次に説明します。

セットアップまたはアンセットアップでエラーが発生した場合，コマンドの応答でコンソールに出力されるメッセージを最初に確認します。

また，KEOSで始まるメッセージ（HCSC-Managerに関するメッセージ）の詳細情報として，別のメッセージIDが出力されているか確認します。出力例を次に示します。

詳細情報としてKDECで始まるメッセージIDが含まれている場合

マニュアル「サービスプラットフォーム メッセージ」を確認して，対処します。

詳細情報としてKDEC以外で始まるメッセージIDが含まれている場合

各メッセージに対応したマニュアルを参照して対処します（例えば，KDJEメッセージが含まれている場合は，マニュアル「アプリケーションサーバ メッセージ(監査者用)」を参照します）。

要因が特定できない場合は，取得しているメッセージログを参照します。

セットアップまたはアンセットアップ実行時に参照する障害情報は，次のメッセージログです。詳細については，「7.4.1　メッセージログ」を参照してください。

HCSC-Managerのログ

統合メッセージログ

障害が発生した原因は，コマンド実行以前の環境設定や，システムの状態に起因することもあるため，コマンド応答のメッセージを出力している個所の前後を確認し，ほかにエラーメッセージが出ていないか確認して対策します。

なお，メッセージログの内容を確認するときに，コンソールに出力されたメッセージが重複して出力されていることもあるため，適宜実行時間を確認します。

(2)　代表的な障害とその対処方法

セットアップまたはアンセットアップ時の代表的な障害と，その対処方法について次の表に示します。

表7‒70　代表的な障害とその対処方法（セットアップまたはアンセットアップ時の障害調査）

手順（流れ）

代表的な障害

考えられる要因

対策

実行環境に必要なソフトウェアの設定時

データベースのサーバ側のセットアップ時

権限の設定ができない

データベース定義ユティリティ（pddef），HiRDB SQL Executerのパスが設定されていません。

データベース定義ユティリティ（pddef），HiRDB SQL Executerのパスを設定します。

Managerのセットアップ時

Management Serverが起動しない

mserver.propertiesの書式が誤っています。

mserver.propertiesを見直します。

詳細は「3.1.2　実行環境に必要なソフトウェアを設定する」を参照してください。

mserver.cfgの書式が誤っています。

mserver.cfgを見直します。

Management Serverと運用管理エージェントが自動起動しない

Management Serverと運用管理エージェントを自動起動するように設定されていません。

Management Serverと運用管理エージェントを自動起動するように設定します。

運用管理エージェントが起動しない

adminagent.cfgの書式が誤っています。

adminagent.cfgを見直します。

MBeanの起動確認で，KEOS27010-Iメッセージが出力されない

<サービスプラットフォームのインストールディレクトリ>¥manager¥mbean-plugins配下に，定義ファイルおよびjarが存在しません。

<サービスプラットフォームのインストールディレクトリ>¥CSC¥mbean-plugins配下のファイルを，<サービスプラットフォームのインストールディレクトリ>¥manager¥mbean-pluginsにコピーします。

詳細は「3.1.2　実行環境に必要なソフトウェアを設定する」を参照してください。

PRFのセットアップ時

−

−

−

J2EEサーバのセットアップ時

J2EEサーバが起動しない

J2EEサーバのシステム環境変数が正しく設定されていません。

J2EEサーバのシステム環境変数を見直します。

HTTP Serverのセットアップ時

−

−

−

データベースのクライアント側のセットアップ時

−

−

−

JDBCドライバのセットアップ時

−

−

−

DB Connectorのセットアップ時

DB Connectorのcjstartrarやcjtestres実行時にエラーが発生する

データベース関連の問題です。

HiRDB未起動

HiRDBのコネクション不足

HiRDBのホスト名やIPアドレス，ポート番号の誤り

HiRDBのユーザ名やパスワードの誤り

HiRDBが起動しているかどうか確認します。

HiRDBのコネクション不足の場合は，次のどちらかを実施します。

(1) %PDDIR%¥CONF¥pdsysのpd_max_usersを50程度に変更します。

(2) DB Connectorの定義やReliable MessagingのコンフィグレーションプロパティのMinPoolSizeを小さくします。

DB Connectorの定義を参照し，ホスト名やIPアドレス，ポート番号に誤りがないか確認します。

HiRDBのユーザ名やパスワードの誤りがないか確認します。

UNIX/Linux環境で，DB Connectorに対してcjstartrarやcjtestres実行時にエラーが発生する

KDJE37360-E

KDJE48516-E（例外名と例外の詳細メッセージで，javax.resource.ResourceException: KDJE50018-Eを出力）

Linuxの場合はLD_LIBRARY_PATH，AIXの場合はLIBPATHに次のパスが設定されていません。

(1) HiRDBクライアント製品のパス

/opt/HiRDB/client/lib

(2) HiRDBサーバ製品のパス

$PDDIR/client/lib

Linuxの場合はLD_LIBRARY_PATH，AIXの場合はLIBPATHに左記のパスを設定します。

(1)と(2)はHiRDBに接続するときに，ソフトウェアのインストール状況に応じて，どちらか一方を設定します。

詳細は「3.1.2　実行環境に必要なソフトウェアを設定する」を参照してください。

Reliable Messagingのセットアップ時

DB Connectorのcjstartrarやcjtestres実行時にエラーが発生する

データベース関連の問題です。

HiRDB未起動

HiRDBのコネクション不足

HiRDBのホスト名やIPアドレス，ポート番号の誤り

HiRDBのユーザ名やパスワードの誤り

HiRDBが起動しているかどうか確認します。

HiRDBのコネクション不足の場合は，次のどちらかを実施します。

(1) %PDDIR%¥CONF¥pdsysのpd_max_usersを50程度に変更します。

(2) DB Connectorの定義やReliable MessagingのコンフィグレーションプロパティのMinPoolSizeを小さくします。

DB Connectorの定義を参照し，ホスト名やIPアドレス，ポート番号，ユーザ名やパスワードに誤りがないか確認します。

詳細は「3.1.2　実行環境に必要なソフトウェアを設定する」を参照してください。

Reliable Messagingの起動，またはJ2EEサーバの起動時に，KDJE48213-Wが出力される

Reliable Messagingのコンフィグレーションプロパティに指定しているキュー定義ファイルの記述が誤っています。

サービスプラットフォームの07-50以降のバージョンを利用している場合，Reliable MessagingのコンフィグレーションプロパティのQueueConfigFileNameは指定不要です。

Service Coordinator-Managerのセットアップ時

−

−

−

HCSCサーバのセットアップ時

HCSCサーバのセットアップ時に次のエラーが発生する

KEOS27105-E

Management Serverが起動していません。

Management Serverが起動しているか確認します。

また，Management Serverが自動起動になっているか確認します。

HCSCサーバのセットアップ時に次のエラーが発生する

KEOS50007-E（詳細コードでKDEC10011-Eを出力）

KEOS27040-E

運用管理エージェントが起動していません。

運用管理エージェントが起動しているか確認します。

また，運用管理エージェントが自動起動になっているか確認します。

起動している場合，Management Serverの設定ファイルの内容を確認し，Management Serverを再起動します。

HCSCサーバのセットアップ時に次のエラーが発生する

KEOS50007-E（詳細コードでKDEC05001-EおよびKFPA11723-Eを出力）

HiRDBがダウンしています。

HiRDBサーバを起動します。起動できない場合は，マニュアル「HiRDB メッセージ」を参照して対処します。

HCSCサーバのセットアップ時に次のエラーが発生する

KEOS50007-E（詳細コードでKDEC05012-Eを出力）

HiRDB Type4 JDBC DriverまたはOracle JDBC Thin Driverの設定が漏れています。

次の3つのファイルに，ドライバのjarファイルのクラスパスを設定します。

(1) Management Server用オプション定義ファイル（mserver.cfg）で，web.add.class.pathを設定します。

(2) J2EEサーバ用オプション定義ファイル（usrconf.cfg）で，add.class.pathを設定します。

(3) HCSC-Messagingコマンド共通定義ファイル（cmdconf.batまたはcmdconf）で，HCSC_ADDCLASSPATHを設定します。

HCSCサーバのセットアップ時に次のエラーが発生する

KEOS50007-E（詳細コードでKDEC10013-Eを出力）

リソースアダプタのReliable Messagingが起動していません。

Reliable Messagingを起動します。

HCSCサーバのセットアップ時に次のエラーが発生する

KEOS50007-E（詳細コードでKDEC10010-Eを出力）

J2EEサーバが起動していません。

環境を見直します。※1

HCSCサーバのセットアップ時に次のエラーが発生する

KEOS50004-E（詳細コードでKEOS27105-Eを出力）

運用管理エージェントが正常に動作していません。

または，作成したJ2EEサーバがManagerの管理下にありません。

環境を見直します。※1

その結果，該当する原因がない場合，作成したJ2EEサーバがManagerの管理下にいないことが考えられます。その場合はManagerで管理できるように設定します。※2

また，読み込んだJ2EEサーバの設定が正しく設定されているか一とおり確認して，設定が変わっている個所は元に戻します。その後，画面内の［適用］ボタンをクリックします。すべての見直しが完了したあとに，画面右上の［設定情報の配布］をクリックして，設定を有効にします。

なお，ManagerでJ2EEサーバを管理する場合は，論理パフォーマンストレーサの設定が必要になります。また，「基本設定」タブの次に示す設定は，読み込み後は必ず「しない」（使用しない）になります。そのため，必要に応じて変更してください。

運用監視エージェントの設定

Managementイベント発行機能の設定

起動オプションの設定

HCSCサーバの定義情報の設定時

−

−

−

HCSCサーバの起動時

HCSCサーバ起動に失敗する

ログの中に「KDJE37356-E The communication timeout occurred.」が含まれている

DB Connectorの属性のmaxBinarySizeとLONGVARBINARY_AccessSizeが，共に0になっています。

次のどちらか（または両方）のとおり変更します。

DBConnectorの属性のmaxBinarySizeに0以外（例：64000）を設定します。

LONGVARBINARY_AccessSizeに0以外（例：64）を設定します。

KEOS50007-Eが発生してコマンドが失敗する

HCSC稼働マシンのメッセージログに次のどちらかのメッセージが出力される

KDJE50012-E

KFDJ02005-E

HCSCサーバセットアップ定義ファイルのdbcon-nodisplaynameに指定したDB Connectorが，<transaction-support>にNoTransaction以外を定義したDB Connectorです。

2つのDB Connectorを準備していない場合は，DB Connectorを2つセットアップします。

DB Connectorの属性ファイルを取得し，<transaction-support>にNoTransactionを指定し，設定します。

HCSCサーバセットアップ定義ファイルに正しくDB Connectorが設定されていることを確認して，再度HCSCサーバをセットアップします。

詳細は「3.1.2　実行環境に必要なソフトウェアを設定する」を参照してください。

サービスアダプタ/ビジネスプロセス/ユーザ定義受付の配備時

KEOS50007-Eが発生してコマンドが失敗する

HCSC稼働マシンのメッセージログに次のどちらかのメッセージが出力される

KDJE50012-E

KFDJ02005-E

HCSCサーバセットアップ定義ファイルのdbcon-nodisplaynameに指定したDB Connectorが，<transaction-support>にNoTransaction以外を定義したDB Connectorです。

2つのDB Connectorを準備していない場合は，DB Connectorを2つセットアップします。

DB Connectorの属性ファイルを取得し，<transaction-support>にNoTransactionを指定し，設定します。

HCSCサーバセットアップ定義ファイルに正しくDB Connectorが設定されていることを確認して，再度HCSCサーバをセットアップします。

詳細は「3.1.2　実行環境に必要なソフトウェアを設定する」を参照してください。

ユーザ定義受付の定義情報の設定時

−

−

−

（凡例）

−：該当しません。

注※1

次の観点で見直します。

該当J2EEサーバの稼働ホストで，運用管理エージェントが起動しているか。

起動している運用管理エージェントのポート番号と，構成定義でホストに定義した運用管理エージェントのポート番号は一致しているか。

構成定義で定義したホストと通信できるか。

運用管理エージェントのプロパティで，アクセスしているManagement Serverの稼働ホストは接続が許可されているか。

Management Serverと運用管理エージェントの製品のバージョンが一致しているか。

Management Serverと運用管理エージェントの製品のエディションが異なる場合，接続できるエディション関係か。

Managerのリモート管理機能が指定の「ホスト名（またはIPアドレス）:ポート番号」で起動されているか。

注※2

次の手順で，作成したJ2EEサーバがManagerで管理できるように設定します。

運用管理ポータルの「論理サーバの環境設定」で「論理J2EEサーバ」配下にあるJ2EEサーバ名を選択し，設定画面を表示させます。

表示したメニューのタブ「読み込み」をクリックします。「サーバの設定読み込み」画面が表示されます。

「接続先ホストから設定を読み込みます」を選択し，「読み込み」ボタンをクリックします。

画面右上の「運用管理ポータル」をクリックします。いったんトップページに戻ります。

「論理サーバの起動/停止」をクリックします。起動させるJ2EEサーバが起動できるか確認します。

7.5.3　HCSCサーバのセットアップおよびアンセットアップ時の回復方法

HCSCサーバのセットアップに失敗後，再セットアップができない，またはHCSCサーバのアンセットアップを繰り返してもアンセットアップが完了しない場合は，次のように対処してください。

手順

次のコマンドを実行して，リポジトリ情報を削除します。

cscsvunsetup -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -ignore

リポジトリ情報を削除後，アプリケーションの削除が必要な場合は，手順2.〜手順5.を実行してください。アプリケーションの削除が不要な場合は，手順5.を実行してください。

次のコマンドを実行して，削除の対象となるHCSCのアプリケーションの名称を確認します。

cscapputil -user <ログインユーザID> -pass <ログインパスワード> -host <IPアドレス>:<port番号> -mnguser <管理ユーザID> -mngpass <管理ユーザパスワード> -j2ee <J2EEサーバ名> -operation list

削除の対象となるHCSCサーバのアプリケーションを次に示します。これらのアプリケーションはリソースをクラスタ内で共有しないため，すべて削除してください。

CSCMessaging

CSCMsgSyncServiceDelivery

CSCMsgSyncServiceDeliveryWS

CSCMsgAsyncServiceDelivery

CSCMsgAsyncServiceDeliveryDBQ

cscmsg_async

次のコマンドを実行して，削除の対象となるHCSCのアプリケーションを停止します。

cscapputil -user <ログインユーザID> -pass <ログインパスワード> -host <IPアドレス>:<port番号> -mnguser <管理ユーザID> -mngpass <管理ユーザパスワード> -j2ee <J2EEサーバ名> -app <アプリケーション名> -operation stop

次のコマンドを実行して，HCSCのアプリケーションを削除します。

cscapputil -user <ログインユーザID> -pass <ログインパスワード> -host <IPアドレス>:<port番号> -mnguser <管理ユーザID> -mngpass <管理ユーザパスワード> -j2ee <J2EEサーバ名> -app <アプリケーション名> -operation delete

削除できないリソース（データベーステーブル，インデクス，またはビュー表）がある場合，次に示す表を参考に削除します。

ただし，クラスタ内で共有するリソースについては，クラスタ内で最後のHCSCサーバをアンセットアップする場合にだけ削除してください。

また，各リソースがすでに削除されている場合，または作成されていない場合もあるため，存在しない場合は削除する必要はありません。

表7‒71　 HCSCサーバが使用するリソース

項番

項目

リソース名

種別

共有

1

データベーステーブル，インデクス，ビュー表

CSCMSG_S<HCSCサーバ名>_CSC_PERSIST

T

×

2

CSCMSG_C<クラスタ名>_CSC_CONNECT

T

○

3

CSCMSG_S<HCSCサーバ名>_LC_DIRECTORY

T

×

4

CSCMSG_S<HCSCサーバ名>_LC_BPFORMAT

T

×

5

CSCMSG_S<HCSCサーバ名>_RT_RULE

T

×

6

CSCMSG_S<HCSCサーバ名>_CV_MAPPING

T

×

7

CSCMSG_S<HCSCサーバ名>_CV_FORMAT

T

×

8

CSCMSG_C<クラスタ名>_EXECHISTORY※1

T

○

9

CSCMSG_C<クラスタ名>_EXECHISTORY_I※1

I

○

10

CSCMSG_C<クラスタ名>_CLUSTER※2

T

○

11

CSCMSG_C<クラスタ名>_HA_ASYNC_ADP※2

T

○

12

CSCBP_<クラスタ名>_PROCESS

T

○

13

CSCBP_<クラスタ名>_PROCESS_IDX1

I

○

14

CSCBP_<クラスタ名>_PROCESS_IDX2

I

○

15

CSCBP_<クラスタ名>_PROCESS_IDX3

I

○

16

CSCBP_<クラスタ名>_PROCESS_IDX4

I

○

17

CSCBP_<クラスタ名>_ACTIVITY

T

○

18

CSCBP_<クラスタ名>_ACTIVITY_IDX

I

○

19

CSCBP_<クラスタ名>_LINK

T

○

20

CSCBP_<クラスタ名>_LINK_IDX

I

○

21

CSCBP_<クラスタ名>_CORRELATIONSET

T

○

22

CSCBP_<クラスタ名>_CORREL_IDX1

I

○

23

CSCBP_<クラスタ名>_CORREL_IDX2

I

○

24

CSCBP_<クラスタ名>_STR_VARIABLE

T

○

25

CSCBP_<クラスタ名>_STR_VAR_IDX

I

○

26

CSCBP_<クラスタ名>_NUM_VARIABLE

T

○

27

CSCBP_<クラスタ名>_NUM_VAR_IDX

I

○

28

CSCBP_<クラスタ名>_BOOL_VARIABLE

T

○

29

CSCBP_<クラスタ名>_BOOL_VAR_IDX

I

○

30

CSCBP_<クラスタ名>_MSG_VARIABLE

T

○

31

CSCBP_<クラスタ名>_MSG_VAR_IDX

I

○

32

CSCBP_<クラスタ名>_MSG_RELATION

T

○

33

CSCBP_<クラスタ名>_MSG_REL_IDX1

I

○

34

CSCBP_<クラスタ名>_MSG_REL_IDX2

I

○

35

CSCBP_<クラスタ名>_MSG_REL_IDX3

I

○

36

CSCBP_<クラスタ名>_V_ACTIVITY

V

○

37

CSCBP_<クラスタ名>_V_LINK

V

○

38

CSCBP_<クラスタ名>_V_STR_VARIABLE

V

○

39

CSCBP_<クラスタ名>_V_NUM_VARIABLE

V

○

40

CSCBP_<クラスタ名>_V_BOOL_VARIABLE

V

○

41

CSCBP_<クラスタ名>_V_MSG_VARIABLE

V

○

42

リクエスト受付キュー（クラスタ種別がLBの場合）

CSC<HCSCサーバ名>ACPT_RCVQ

Q

×

43

CSC<HCSCサーバ名>ACPT_DBQ

Q

×

44

リクエスト受付キュー（クラスタ種別がHAの場合）

CSC<クラスタ名>ACPT_RCVQ

Q

○

45

CSC<クラスタ名>ACPT_DBQ

Q

○

46

HCSCサーバ一時ファイル

ServerProperties_<HCSCサーバ名>

F

×

47

ServerSetup_<HCSCサーバ名>

F

×

48

ReceptionProperties_dbq_<HCSCサーバ名>

F

×

49

ReceptionProperties_ejb_<HCSCサーバ名>

F

×

50

ReceptionProperties_jms_<HCSCサーバ名>

F

×

51

ReceptionProperties_soap_<HCSCサーバ名>

F

×

52

UserReceptionProperties_<HCSCサーバ名>_<受付ID>

F

×

53

ServerProperties_<HCSCサーバ名>.old

F

×

54

ServerSetup_<HCSCサーバ名>.old

F

×

55

ReceptionProperties_dbq_<HCSCサーバ名>.old

F

×

56

ReceptionProperties_ejb_<HCSCサーバ名>.old

F

×

57

ReceptionProperties_jms_<HCSCサーバ名>.old

F

×

58

ReceptionProperties_soap_<HCSCサーバ名>.old

F

×

59

UserReceptionProperties_<HCSCサーバ名>_<受付ID>.old

F

×

60

ServerPropertiesAct_<HCSCサーバ名>

F

×

61

ReceptionPropertiesAct_dbq_<HCSCサーバ名>

F

×

62

ReceptionPropertiesAct_ejb_<HCSCサーバ名>

F

×

63

ReceptionPropertiesAct_jms_<HCSCサーバ名>

F

×

64

ReceptionPropertiesAct_soap_<HCSCサーバ名>

F

×

65

UserReceptionPropertiesAct_<HCSCサーバ名>_<受付ID>

F

×

66

ServerPropertiesAct_<HCSCサーバ名>.old

F

×

67

ReceptionPropertiesAct_dbq_<HCSCサーバ名>.old

F

×

68

ReceptionPropertiesAct_ejb_<HCSCサーバ名>.old

F

×

69

ReceptionPropertiesAct_jms_<HCSCサーバ名>.old

F

×

70

ReceptionPropertiesAct_soap_<HCSCサーバ名>.old

F

×

71

UserReceptionPropertiesAct_<HCSCサーバ名>_<受付ID>.old

F

×

72

_cscmsg_cnfrqdbq_<HCSCサーバ名>.xml

F

×

73

_cscmsg_cnfrqejb_<HCSCサーバ名>.xml

F

×

74

_cscmsg_cnfrqjms_<HCSCサーバ名>.xml

F

×

75

_cscmsg_cnfrqsoap_<HCSCサーバ名>.xml

F

×

76

_cscmsg_cnfrqsorp_<HCSCサーバ名>.xml

F

×

77

_cscmsg_cnfrq_<HCSCサーバ名>_<受付ID>.xml

F

×

78

inf¥<HCSCサーバ名>

F2

×

79

inf¥lock<HCSCサーバ名>

F2

×

（凡例）

列「種別」の意味を次に示します。

I：インデクスであることを示します。※3

T：データベーステーブルであることを示します。※3

V：ビュー表であることを示します。※3

Q：Reliable Messagingのキューであることを示します。※4

F：HCSCサーバ一時ファイルであることを示します。※5

F2：HCSCサーバのシステム管理情報を保存する出力先のディレクトリやファイルであることを示します。※6

列「共有」の意味を次に示します。

○：リソースをクラスタ内で共有することを示します。

×：リソースをクラスタ内で共有しないことを示します。

注※1

このテーブルの使用は推奨しません。代替としてユーザ電文トレース機能を使用してください。

注※2

次に示すSQL文を実行して，該当テーブルに設定されている情報の一覧を取得します。

SELECT * FROM CSCMSG_C<クラスタ名>_CLUSTER;

取得した一覧に，セットアップ（またはアンセットアップ）に失敗したHCSCサーバ以外の情報が含まれない場合

次に示すSQLを発行して該当テーブルを削除します。

DROP TABLE CSCMSG_C<クラスタ名>_CLUSTER;
DROP TABLE CSCMSG_C<クラスタ名>_HA_ASYNC_ADP;

取得した一覧に，セットアップ（またはアンセットアップ）に失敗したHCSCサーバ以外の情報が含まれる場合

次に示すSQL文を実行してレコードを削除します。

DELETE FROM CSCMSG_C<クラスタ名>_CLUSTER
WHERE CSC_SERVER_NAME='<セットアップまたはアンセットアップに失敗したHCSCサーバ名>';
COMMIT;

注※3

データベーステーブル，インデクスおよびビュー表はSQL命令（DROP）を実行して削除してください。

注※4

Reliable Messagingのキューは，hrmstopコマンドを実行して管理状態へ移行したあと，hrmdelqueコマンドを実行して削除してください。コマンドの詳細は，マニュアル「Reliable Messaging」の「8.3.8　hrmdelque（キューの削除）」を参照してください。

注※5

HCSCサーバ一時ファイルは，「<サービスプラットフォームのインストールディレクトリ>¥CSC¥system¥msg」にあるファイルを削除してください。

注※6

HCSCサーバセットアップ定義ファイルのhcscserver-data-filepathプロパティに指定したディレクトリにあるリソースを削除してください。hcscserver-data-filepathプロパティにディレクトリを指定していない場合は，hcscserver-data-filepathプロパティのデフォルトのディレクトリにあるリソースを削除してください。

注意事項

J2EEサーバ上のHCSCサーバを削除する場合には，cscapputilコマンドを使用します。J2EEサーバのコマンドでは削除できません。

cscapputilコマンドは，障害を回復する場合にだけ使用してください。通常運用時や構築時には，このコマンドを使用しないでください。

cscapputilコマンドで，アプリケーションを削除した場合，サービスプラットフォームのシステムを破壊するおそれがあります。そのため，十分に注意して運用してください。

7.5.4　HCSCコンポーネントの配備および削除時の回復方法

(1)　回復手順

サービスアダプタ，ビジネスプロセスおよびユーザ定義受付の配備に失敗後，再配備ができない場合や，サービスアダプタ，ビジネスプロセスおよびユーザ定義受付の削除を繰り返しても削除が完了しない場合は，次の手順で対処してください。

csccompoundeployコマンドに-ignoreオプションを指定して実行し，リポジトリ情報を削除します。

csccompoundeploy -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -name <サービスIDまたは受付ID> -ignore

その後，アプリケーションの削除が必要かどうかに応じて，次に示す手順に進んでください。

アプリケーションの削除が必要な場合：手順2.〜手順5.を実行してください。

アプリケーションの削除が不要な場合：手順5.を実行してください。

次のコマンドを実行して，削除の対象となるHCSCのアプリケーションの名称を確認します。

cscapputil -user <ログインユーザID> -pass <ログインパスワード> -mng <Manager名称> -j2ee <J2EEサーバ名> -operation list

削除の対象となるHCSCのアプリケーションを次に示します。これらのアプリケーションはリソースをクラスタ内で共有しないため，すべて削除してください。

表7‒72　削除の対象となるHCSCのアプリケーション（HCSCコンポーネントの配備および削除の障害時）

項目

アプリケーション名

HCSCコンポーネント（サービスアダプタおよびビジネスプロセス）のアプリケーション

<サービスID>

HCSCコンポーネント（ユーザ定義受付）のアプリケーション

<受付ID>

次のコマンドを実行して，削除の対象となるHCSCコンポーネントを停止します。

cscapputil -user <ログインユーザID> -pass <ログインパスワード> -mng <Manager名称> -j2ee <J2EEサーバ名> -app <アプリケーション名> -operation stop

次のコマンドを実行して，HCSCコンポーネントを削除します。

cscapputil -user <ログインユーザID> -pass <ログインパスワード> -mng <Manager名称> -j2ee <J2EEサーバ名> -app <アプリケーション名> -operation delete

削除できないリソース（キュー）がある場合，「(2)　HCSCサーバが使用するリソース」を参考に削除します。

ただし，クラスタ内で共有するリソースについては，クラスタ内で最後のサービスアダプタまたはビジネスプロセスを削除する場合にだけ削除してください。

削除できないリソース（データベーステーブルの情報）がある場合，次の手順を参考に削除します。

次のSQL文を実行して，残っている不要なリソース（データベーステーブルの情報）を削除します。

DELETE FROM CSCMSG_C<クラスタ名>_HA_ASYNC_ADP
       WHERE CSC_SERVER_NAME='<HCSCサーバ名>'
         AND ADAPTER_ID='<配備または削除に失敗した非同期サービスアダプタのサービスID>';

COMMIT;

なお，次の条件をすべて満たしていない場合は，リソース（データベーステーブルの情報）の削除をしないでください。

クラスタ種別に「HA」を指定してHCSCサーバをセットアップした。

クラスタ内で同一サービスIDの非同期サービスアダプタが配備されていない。

HCSCサーバを再起動します。

(2)　HCSCサーバが使用するリソース

HCSCサーバ（サービスアダプタ，ビジネスプロセス）が使用するリソースを次の表に示します。

表7‒73　HCSCサーバ（サービスアダプタ，ビジネスプロセス）が使用するリソース

項番

項目

リソース名

種別

共有

1

データベーステーブル

CSCMSG_S<HCSCサーバ名>_LC_DIRECTORYテーブルのSERVICE_NAMEの列に，次のどれかが格納された行

削除対象のサービスアダプタのサービス名

削除対象のビジネスプロセス名

削除対象のユーザ定義受付は次の形式

:Reception_<削除対象のユーザ定義受付の受付ID>:<削除対象のユーザ定義受付の受付名>

T

×

2

サービスアダプタのキュー

CSC_<クラスタ名><サービスID>

Q

○

3

MDB（WS-R）アダプタのキュー宛先

CSC<サービスID>

U

○

4

HCSCサーバ一時ファイル

UserReceptionProperties_<HCSCサーバ名>_<受付ID>

F

×

5

UserReceptionProperties_<HCSCサーバ名>_<受付ID>.old

F

×

6

UserReceptionPropertiesAct_<HCSCサーバ名>_<受付ID>.old

F

×

7

_cscmsg_cnfrq_<HCSCサーバ名>_<受付ID>.xml

F

×

8

IAdapterName※1

F2

×

9

IServiceKind※1

F2

×

10

IServiceName※1

F2

×

11

R<数字>※2

F2

×

12

IServiceName※1

F3

×

13

R<数字>※2

F3

×

（凡例）

○：リソースをクラスタ内で共有することを示します。

×：リソースをクラスタ内で共有しないことを示します。

「種別」列：それぞれ次の内容を示します。

T：データベーステーブルであることを示します。

データベーステーブルの行は，SQL命令のDELETEを実行して1行ずつ削除してください。

Q：Reliable Messagingのキューであることを示します。

Reliable Messagingのキューは，hrmstopコマンドを実行して管理状態へ移行したあと，hrmdelqueコマンドを実行して削除してください。コマンドの詳細は，マニュアル「Reliable Messaging」の「8.3.26　hrmstop（管理状態への移行）」を参照してください。

U：Reliable Messagingの転送キューに設定する宛先であることを示します。

Reliable Messagingの転送キューに設定する宛先は，hrmstopコマンドを実行して管理状態へ移行したあと，hrmdeladdrコマンドを実行して削除してください。コマンドの詳細は，マニュアル「Reliable Messaging」の「8.3.6　hrmdeladdr（あて先削除）」を参照してください。

F：HCSCサーバ一時ファイルであることを示します。

ファイルを削除したい場合は，「<サービスプラットフォームのインストールディレクトリ>¥CSC¥system¥msg」にあるファイルを削除してください。

F2：HCSCサーバ一時ファイルであることを示します。

ファイルを削除したい場合は，HCSCサーバセットアップ定義ファイルのhcscserver-data-filepathプロパティを指定していれば，「<hcscserver-data-filepathで指定したディレクトリ>¥inf¥<HCSCサーバ名>¥LC_DIRECTORY」ディレクトリにあるリソース（ファイル）を削除してください。hcscserver-data-filepathプロパティにディレクトリを指定していない場合は，「<hcscserver-data-filepathのデフォルトのディレクトリ>¥inf¥<HCSCサーバ名>¥LC_DIRECTORY」ディレクトリにあるリソース（ファイル）を削除してください。

F3：HCSCサーバ一時ファイルであることを示します。

ファイルを削除したい場合は，HCSCサーバセットアップ定義ファイルのhcscserver-data-filepathプロパティを指定していれば，「<hcscserver-data-filepathで指定したディレクトリ>¥inf¥<HCSCサーバ名>¥LC_BPFORMAT」ディレクトリにあるリソース（ファイル）を削除してください。hcscserver-data-filepathプロパティにディレクトリを指定していない場合は，「<hcscserver-data-filepathのデフォルトのディレクトリ>¥inf¥<HCSCサーバ名>¥LC_BPFORMAT」ディレクトリにあるリソース（ファイル）を削除してください。

注※1

ファイル自体は削除しないで，ファイル内容だけ削除してください。

注※2

ファイル内のSERVICE_NAMEの行に，次のどれかが格納されたファイルです。

削除対象のサービスアダプタのサービス名

削除対象のビジネスプロセス名

削除対象のユーザ定義受付は次の形式

:Reception_<削除対象のユーザ定義受付の受付ID>:<削除対象のユーザ定義受付の受付名>

注意事項

J2EEサーバ上のHCSCコンポーネントを削除する場合には，cscapputilコマンドを使用します。J2EEサーバのコマンドでは削除できません。

cscapputilコマンドは，障害を回復する場合にだけ使用してください。通常運用時や構築時には，このコマンドを使用しないでください。

cscapputilコマンドで，アプリケーションを削除した場合，サービスプラットフォームのシステムを破壊するおそれがあります。そのため，十分に注意して運用してください。

7.6　オペレーション実行時の障害対策

コマンド実行時，運用環境の画面操作時，およびファイルの入出力時に発生した障害について，対策を示します。

7.6.1　コマンド操作や運用環境の画面操作での障害調査

障害が発生した場合，コンソールまたは運用環境の画面に表示されるメッセージを確認して障害を調査します。運用環境の画面が操作できなくなった場合は，画面が正常な状態になるよう対処します。

(1)　ログの見方および障害の切り分け方法

コマンド操作や運用環境の画面操作時に障害が発生した場合の，障害の調査手順について次の図に示します。

図7‒42　障害の調査手順（コマンド操作や運用環境の画面操作での障害調査）

この図が示す調査の流れを次に説明します。

コマンド操作や運用環境の画面操作でエラーが発生した場合，コマンドの応答でコンソールに出力されるメッセージを最初に確認します。

また，メッセージの中に詳細情報として別のメッセージが出力されているか確認します。出力例を次に示します。

KDECで始まるメッセージやKEOSで始まるメッセージ（HCSC-Managerに関するメッセージ）の詳細情報として，KDECで始まるメッセージが含まれている場合

マニュアル「サービスプラットフォーム メッセージ」を確認して，対処します。

KEOSで始まるメッセージ（HCSC-Managerに関するメッセージ）の詳細情報として，KDEC以外で始まるメッセージが含まれている場合

各メッセージに対応したマニュアルを参照して対処します（例えば，KDJEメッセージが含まれている場合は，マニュアル「アプリケーションサーバ メッセージ(監査者用)」を参照します）。

要因が特定できない場合は，取得しているメッセージログを参照します。セットアップまたはアンセットアップ実行時に参照する障害情報は，次のメッセージログです。詳細については，「7.4.1　メッセージログ」を参照してください。

HCSC-Managerのログ

統合メッセージログ

J2EEサーバの稼働ログ

障害が発生した原因は，コマンド実行以前の環境設定や，システムの状態に起因することもあるため，コマンド応答のメッセージを出力している個所の前後を確認し，ほかにエラーメッセージが出ていないか確認して対策します。

なお，メッセージログの内容を確認するとき，コンソールに出力されたメッセージが重複して出力されていることもありますので，適宜実行時間を確認してください。

(2)　代表的な障害とその対処方法

コマンド操作での代表的な障害と，その対処方法について次の表に示します。

表7‒74　代表的な障害とその対処方法（コマンド操作や運用環境の画面操作での障害調査）

操作

代表的な障害

考えられる要因

対策

参照先マニュアル

Type4ドライバ利用時のcsmコマンド実行

HCSCサーバが未起動状態でcsmコマンドを実行すると次のエラーが発生する

KDEC10410-E（KDEC10044-E）

KDEC10044-Eの詳細で，（error code = KDEC05012-E, error message = Database access initialization, before HCSC server startup, failed because loading of the JDBC driver failed. （JDBC name = JP.co.Hitachi.soft.HiRDB.JDBC.HiRDBDriver））を出力

次のどれかのディレクトリの設定漏れです。

Windowsの場合

<サービスプラットフォームのインストールディレクトリ>¥CSC¥config¥msg¥cmdconf.bat

UNIX/Linuxの場合

<サービスプラットフォームのインストールディレクトリ>/CSC/config/msg/cmdconf

または

CSC/config/msg/cmdconf

cmdconf（cmdconf.bat）のHCSC_ADDCLASSPATHにHiRDB Type4 JDBC Driverのjarファイル（pdjdbc2.jar）のパスを指定します。

マニュアル「サービスプラットフォーム リファレンス」の「6.5.4　HCSC-Messagingコマンド共通定義ファイル」

Oracle利用時のcsmコマンド実行

HCSCサーバが未起動状態でcsmコマンドを実行すると次のエラーが発生する

KDEC10410-E（KDEC10044-E）

KDEC10044-Eの詳細で，（error code = KDEC05012-E, error message = Database access initialization, before HCSC server startup, failed because loading of the JDBC driver failed. （JDBC name = oracle.jdbc.OracleDriver））を出力

cmdconf（cmdconf.bat）のHCSC_ADDCLASSPATHにOracle JDBC Thin Driverのjarファイルの絶対パスを指定します。

HCSCサーバが未起動の状態でcsmコマンド実行

HCSCサーバが未起動状態でcsmコマンドを実行すると次のエラーが発生する

KDEC10410-E（KDEC10044-E）

KDEC10044-Eの詳細で，（error code = KDEC05001-E, error message = An attempt to open a connection to the database has failed. （reason = KFPA11724-E Environment definition error, variable=PDUSER, reason=NO VALUE[PrdbConnection.PrdbConnection], SQL state = R0000, error code = -724））を出力

csmコマンドのオプションでデータベースのユーザ名とパスワードを指定していません。

csmコマンドのオプションでデータベースのユーザ名とパスワードを指定します。

HCSCサーバオフライン時は，データベースのユーザ名とパスワードを必ず指定します。

マニュアル「サービスプラットフォーム リファレンス」の「5.　コマンド（運用環境・実行環境）」

csmコマンド実行

csmコマンドが失敗し，データベース（HiRDB）のログおよびトレースでKFPA11912-Eメッセージ（排他制御のための作業領域が不足）が発生している

排他制御のための作業領域が不足しています。

HiRDBのシステム定義の次のオペランドの指定値を増やして，HiRDBを再起動します。

pd_max_access_tables

pd_lck_pool_size

pd_fes_lck_pool_size

マニュアル「HiRDB システム定義」

(3)　運用環境の画面が操作できなくなった場合の対処方法

運用環境の画面が操作できなくなった場合の対処方法について次に示します。

(a)　画面からの操作を失敗してボタンをクリックできなくなった場合

次の手順で対処します。

ダイアログまたは画面コンソールに出力されたエラーの原因を調査して対処します。

次のどちらかの操作をします。

［HCSC-Manager］メニューから［最新の情報に更新］を実行

エディタを閉じて再度表示

手順1.，2.の操作で復旧しない場合は，次のどちらかの操作をします。

エラーとなった操作をコマンドで実行

失敗した操作と対となる操作（開始で失敗した場合は停止）をコマンドで実行

(b)　Eclipse画面が「応答なし」になった場合

次の手順で対処します。

Eclipse画面の［閉じる］ボタンをクリックして，強制的に画面を閉じます。

ボタンで閉じられない場合は，［タスクマネージャ］の［アプリケーション］タグからEclipseのタスクを終了します。

エラーの原因を調査して対処します。

Eclipse画面を起動し，HCSC-Managerにログイン後，エラーとなった操作を再実行します。

注意事項

上記に示す対処をした場合，運用環境と同一のEclipseで編集中の内容も失われます。運用環境の画面を操作する場合は，Eclipseで編集中の内容を，あらかじめ保存または終了してください。

7.6.2　ファイルの入出力に失敗した場合の回復方法

ファイルの入出力に失敗した場合，コマンド操作時にエラーメッセージKEOS50133-Eが出力されることがあります。KEOS50133-Eが一度出力されると，それ以降コマンド操作時にKEOS50133-Eが出力されるようになり，コマンドを実行できません。

KEOS50133-Eが出力された場合の対策方法を次に示します。

メッセージログを参照してファイルの入出力に失敗した原因を調査し，エラーとなった原因を取り除きます。

次の内容を調査し，エラーとなった原因を取り除いてください。

リポジトリルート以下で不当にアクセスしているプロセスが存在しないか

アクセス権が適切に割り当てられているか

ディスクがいっぱいになっていないか

バックアップファイルから，環境を復旧します。

KEOS50133-Eのメッセージに出力されるバックアップの種別から，バックアップファイルの出力先ディレクトリを特定します。

バックアップファイルは，次のディレクトリに出力されます。

<サービスプラットフォームのインストールディレクトリ>¥CSC¥spool¥manager¥backup¥<種別>

なお，エラー発生時の状態に応じて復旧方法が異なります。エラー発生時の状態に応じた復旧方法を次の表に示します。

表7‒75　エラー発生時の状態に応じた復旧方法

項番

種別※1

バックアップファイル名

エラー発生時の状態

復旧方法

復旧後の状態

1

import

crt_mngenv.zip

バックアップ中

crt_mngenv.zipを削除します。

エラーが発生したコマンドの実行前

2

mngenv.zip

ファイルの入出力中

mngenv.zip※2を任意のディレクトリに移動し，mngenv.zipが格納されていたディレクトリを空にします。

次のコマンドを実行します。

cscenvrestore -user <ユーザID> -pass <パスワード> -restorefile <1.で移動したファイル名>

エラーが発生したコマンドの実行前

3

del_mngenv.zip

ファイルの入出力後（バックアップファイルの削除中）

del_mngenv.zipを削除します。

エラーが発生したコマンドの完了後

4

repository

crt_rep.zip

バックアップ中

crt_rep.zipを削除します。

エラーが発生したコマンドの実行前

5

rep.zip

ファイルの入出力中

次の2つのディレクトリ※3以下のファイルを削除して，ディレクトリを空にします。

<リポジトリルート>¥hirep¥configs¥*

<リポジトリルート>¥manager¥*

次のコマンドを実行します。

cd <リポジトリルート>

"<サービスプラットフォームのインストールディレクトリ>¥jdk¥bin¥jar" xvf "<サービスプラットフォームのインストールディレクトリ>¥CSC¥spool¥manager¥backup¥repository¥rep.zip"

rep.zipを削除して，rep.zipが格納されていた次のディレクトリを空にします。

<サービスプラットフォームのインストールディレクトリ>¥CSC¥spool¥manager¥backup¥repository¥*

cscreplsコマンドを実行して，正常に終了することを確認します。

エラーが発生したコマンドの実行前

6

del_rep.zip

ファイルの入出力後（バックアップファイルの削除中）

del_rep.zipを削除します。

エラーが発生したコマンドの完了後

注※1

バックアップファイルの出力先ディレクトリに示す種別に対応しています。

注※2

mngenv.zipは，cscenvbackupコマンドでバックアップしたファイルです。

注※3

rep.zipは，2つのディレクトリ（<リポジトリルート>¥hirep¥configs¥*と<リポジトリルート>¥manager¥*）以下のファイルを圧縮したファイルです。

7.7　サービス部品呼び出し要求時の障害対策

サービスリクエスタからサービス部品を呼び出すときに障害が発生すると，サービスリクエスタにエラーがリターンします。ここでは，エラーが発生した個所からサービスリクエスタまでどのように伝わるか，また検知したエラーの要因をどのように切り分けるかについて説明します。

なお，開発環境の定義は，運用環境を通じて実行環境で動作しますが，ここでは運用環境の説明は省略しています。

7.7.1　Webサービス（SOAP通信）実行時の障害対策

SOAP通信の場合，サービスリクエスタからサービス部品を呼び出すときに障害が発生すると，サービスリクエスタにエラーがリターンします。

(1)　SOAP通信でのエラーの伝わり方

エラーの伝わり方は，サービスリクエスタから標準受付とユーザ定義受付のどちらを使用してサービス部品を呼び出すかで異なります。それぞれのエラーの伝わり方を説明します。

(a)　標準受付の場合

エラーの伝わり方は，エラーの種類やビジネスプロセスの有無によって異なります。

サービス部品からユーザ定義例外のエラーがリターンした場合（ビジネスプロセスを使用しないとき）

サービス部品からユーザ定義例外のエラーがリターンした場合でビジネスプロセスを使用しないときのSOAP通信でのエラーの伝わり方を次の図に示します。

図7‒43　サービス部品からユーザ定義例外のエラーがリターンした場合（ビジネスプロセスを使用しないとき）のSOAP通信でのエラーの伝わり方

サービス部品側の通信基盤にサービスプラットフォームが提供しているSOAP通信基盤またはJAX-WSエンジンを使用している場合で，サービス部品で例外をスローするコーディングをしているとき，サービス部品のWSDLにはユーザ定義例外がSOAPフォルトで定義されます。サービス部品でユーザ定義例外が発生すると，SOAPフォルトの内容が標準受付からサービスリクエスタに応答されます。

サービスリクエスタが使用するWSDLはサービスプラットフォームが提供するWSDLで，このWSDLにはCSCMsgServerFaultException※がSOAPフォルトとして定義されています。サービスリクエスタは，HCSCサーバがリターンするSOAPフォルトをCSCMsgServerFaultException※オブジェクトでキャッチできます。キャッチした例外オブジェクトのgetterを使用することで，サービス部品側で発生した例外名やフォルト情報（エラーの詳細）を取得できます。CSCMsgServerFaultException※の詳細については，マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」の「9.3.8　エラー情報を取得する」を参照してください。

注※

SOAP1.2の場合は，CSCMsgServerFault12Exceptionとなります。

サービス部品からユーザ定義例外以外のエラーがリターンした場合（ビジネスプロセスを使用しないとき）

サービス部品からユーザ定義例外以外のエラーがリターンした場合でビジネスプロセスを使用しないときのSOAP通信でのエラーの伝わり方を次の図に示します。

図7‒44　サービス部品からユーザ定義例外以外のエラーがリターンした場合（ビジネスプロセスを使用しないとき）のSOAP通信でのエラーの伝わり方

サービス部品側の通信基盤にサービスプラットフォームが提供しているSOAP通信基盤またはJAX-WSエンジンを使用している場合で，サービス部品でWSDLに定義していない想定外の例外（システム例外）が発生したときは，RuntimeExceptionとしてSOAPメッセージが伝わります。また，サービス部品側の通信基盤にJAX-WSエンジンを使用している場合や，サービスプラットフォームが提供しているSOAP通信基盤を使用していない場合は，WSDLにSOAPフォルトを定義していてもHCSCサーバ内では例外として扱われます。

サービスアダプタからサービス部品を呼び出したときに発生したシステム例外は，サービスアダプタでフォルト電文に変換することもできます。システム例外をフォルト電文に変換する方法については，「7.11　サービスアダプタでの例外発生時の運用」を参照してください。

サービスリクエスタが使用するWSDLはサービスプラットフォームが提供するWSDLで，このWSDLにはCSCMsgServerFaultException※がSOAPフォルトとして定義されています。サービスリクエスタは，HCSCサーバがリターンするSOAPフォルトをCSCMsgServerFaultException※オブジェクトでキャッチできます。キャッチした例外オブジェクトのgetterを使用することで，発生したフォルト情報（エラーの詳細）を取得できます。CSCMsgServerFaultException※の詳細については，マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」の「9.3.8　エラー情報を取得する」を参照してください。

なお，サービス部品が応答したSOAPフォルトをHCSCサーバ内で例外ではなくSOAPフォルトのまま伝えたい場合は，SOAP Fault動作定義ファイルで定義します。SOAP Fault動作定義ファイルの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.6.1　SOAP Fault動作定義ファイル」を参照してください。

注※

SOAP1.2の場合は，CSCMsgServerFault12Exceptionとなります。

HCSCサーバからエラーがリターンした場合（ビジネスプロセスを使用しないとき）

HCSCサーバからエラーがリターンした場合でビジネスプロセスを使用しないときのSOAP通信でのエラーの伝わり方を次の図に示します。

図7‒45　HCSCサーバからエラーがリターンした場合（ビジネスプロセスを使用しないとき）のSOAP通信でのエラーの伝わり方

図中の各エラーには，次に示すケースが該当します。

エラー1：要求パラメタ不正，指定文字コード不正，各種フォーマット不正など

エラー2：宛先（ロケーション）が見つからない，サービスアダプタが停止しているなど

エラー3：データ変換に失敗したなど

エラー4：宛先不正，サービス部品が停止，通信障害など

HCSCサーバで図中のエラー1〜エラー3のどれかを検知した場合，発生したエラーの例外をサービスリクエスタにリターンします。

図中のエラー4を検知した場合，発生したエラーの例外をサービスリクエスタにそのままリターンするか，サービスアダプタでエラーの例外をフォルト電文に変換するか選択できます。例外発生時に取得するエラーの選択方法については，「7.11　サービスアダプタでの例外発生時の運用」を参照してください。

サービスリクエスタは，HCSCサーバがリターンするSOAPフォルトをCSCMsgServerFaultException※オブジェクトでキャッチできます。キャッチした例外オブジェクトのgetterを使用することで，発生したフォルト情報（エラーの詳細）を取得できます。CSCMsgServerFaultException※の詳細については，マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」の「9.3.8　エラー情報を取得する」を参照してください。

注※

SOAP1.2の場合は，CSCMsgServerFault12Exceptionとなります。

サービス部品からユーザ定義例外のエラーがリターンした場合（ビジネスプロセスを使用するとき）

サービス部品からユーザ定義例外のエラーがリターンした場合でビジネスプロセスを使用するときのSOAP通信でのエラーの伝わり方を次の図に示します。

図7‒46　サービス部品からユーザ定義例外のエラーがリターンした場合（ビジネスプロセスを使用するとき）のSOAP通信でのエラーの伝わり方

サービス部品側の通信基盤にサービスプラットフォームが提供しているSOAP通信基盤またはJAX-WSエンジンを使用している場合で，サービス部品で例外をスローするコーディングをしているとき，サービス部品のWSDLにはユーザ定義例外がSOAPフォルトで定義されます。サービス部品でユーザ定義例外が発生すると，そのエラーは，一度ビジネスプロセスでキャッチできます。

サービスリクエスタは，HCSCサーバがリターンするSOAPフォルトをCSCMsgServerFaultException※オブジェクトでキャッチできます。キャッチした例外オブジェクトのgetterを使用することで，発生した例外名やフォルト情報（エラーの詳細）を取得できます。ビジネスプロセスでフォルト名を定義することで，サービスリクエスタで発生した例外が切り分けやすくなります。CSCMsgServerFaultException※の詳細については，マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」の「9.3.8　エラー情報を取得する」を参照してください。

注※

SOAP1.2の場合は，CSCMsgServerFault12Exceptionとなります。

サービス部品からユーザ定義例外以外のエラーがリターンした場合（ビジネスプロセスを使用するとき）

サービス部品からユーザ定義例外以外のエラーがリターンした場合でビジネスプロセスを使用するときのSOAP通信でのエラーの伝わり方を次の図に示します。

図7‒47　サービス部品からユーザ定義例外以外のエラーがリターンした場合（ビジネスプロセスを使用するとき）のSOAP通信でのエラーの伝わり方

サービス部品側の通信基盤にサービスプラットフォームが提供しているSOAP通信基盤またはJAX-WSエンジンを使用している場合で，サービス部品でWSDLに定義していない想定外の例外（システム例外）が発生したときは，RuntimeExceptionとしてSOAPメッセージが伝わります。また，サービス部品側の通信基盤にJAX-WSエンジンを使用している場合や，サービスプラットフォームが提供しているSOAP通信基盤を使用していない場合は，WSDLにSOAPフォルトを定義していてもHCSCサーバ内では例外として扱われます。

サービスアダプタからサービス部品を呼び出したときに発生したシステム例外は，サービスアダプタでフォルト電文に変換することもできます。

例外をフォルト電文に変換しない場合，ビジネスプロセスでは例外として処理して，標準受付にスローします。例外をフォルト電文に変換した場合，フォルトとしてビジネスプロセスでキャッチできます。システム例外をフォルト電文に変換する方法については，「7.11　サービスアダプタでの例外発生時の運用」を参照してください。

サービスリクエスタは，HCSCサーバがリターンするSOAPフォルトをCSCMsgServerFaultException※オブジェクトでキャッチできます。キャッチした例外オブジェクトのgetterを使用することで，発生したフォルト情報（エラーの詳細）を取得できます。CSCMsgServerFaultException※の詳細については，マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」の「9.3.8　エラー情報を取得する」を参照してください。

なお，サービス部品が応答したSOAPフォルトをHCSCサーバ内で例外ではなくSOAPフォルトのまま伝えたい場合は，SOAP Fault動作定義ファイルで定義します。SOAP Fault動作定義ファイルの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.6.1　SOAP Fault動作定義ファイル」を参照してください。

注※

SOAP1.2の場合は，CSCMsgServerFault12Exceptionとなります。

HCSCサーバからエラーがリターンした場合（ビジネスプロセスを使用するとき）

HCSCサーバからエラーがリターンした場合でビジネスプロセスを使用するときのSOAP通信でのエラーの伝わり方を次の図に示します。

図7‒48　HCSCサーバからエラーがリターンした場合（ビジネスプロセスを使用するとき）のSOAP通信でのエラーの伝わり方

図中の各エラーには，次に示すケースが該当します。

エラー1：要求パラメタ不正，指定文字コード不正，各種フォーマット不正など

エラー2：宛先（ロケーション）が見つからない，サービスアダプタが停止しているなど

エラー3：データ変換に失敗したなど

エラー4：宛先不正，サービス部品が停止，通信障害など

エラー5：ビジネスプロセス処理上での例外エラーなど

HCSCサーバで図中のエラー1〜エラー3およびエラー5のどれかを検知した場合，発生したエラーの例外をサービスリクエスタにリターンします。図中のエラー4を検知した場合，発生したエラーの例外をサービスリクエスタにそのままリターンするか，サービスアダプタでエラーの例外をフォルト電文に変換するか選択できます。例外発生時に取得するエラーの選択方法については，「7.11　サービスアダプタでの例外発生時の運用」を参照してください。

サービスリクエスタは，HCSCサーバがリターンするSOAPフォルトをCSCMsgServerFaultException※オブジェクトでキャッチできます。キャッチした例外オブジェクトのgetterを使用することで，発生したフォルト情報（エラーの詳細）を取得できます。CSCMsgServerFaultException※の詳細については，マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」の「9.3.8　エラー情報を取得する」を参照してください。

注※

SOAP1.2の場合は，CSCMsgServerFault12Exceptionとなります。

サービスリクエスタでエラーを検知した場合

サービスリクエスタでエラーを検知した場合のSOAP通信でのエラーの伝わり方を次の図に示します。

図7‒49　サービスリクエスタでエラーを検知した場合のSOAP通信でのエラーの伝わり方（標準受付の場合）

サービスリクエスタからHCSCサーバを呼び出せなかった場合や，サービス部品の呼び出しは完了したが何らかの原因でHCSCサーバからサービスリクエスタへの応答が返らなかった場合などは，サービスリクエスタ側（クライアント側）のSOAP通信基盤またはJAX-WSエンジンがエラーをリターンします。

サービスリクエスタ側の通信基盤にサービスプラットフォームが提供しているSOAP通信基盤を使用している場合は，C4Faultオブジェクトで例外をキャッチできます。キャッチした例外オブジェクトのgetterを使用することで，発生したフォルト情報（エラーの詳細）を取得できます。C4Faultの詳細については，マニュアル「アプリケーションサーバ SOAPアプリケーション開発の手引」の「13.2　C4Faultクラス（SOAP Fault情報の保持）」を参照してください。

なお，サービスリクエスタ側の通信基盤にJAX-WSエンジンを使用している場合は，SOAPFaultExceptionオブジェクトで例外をキャッチできます。また，サービスプラットフォームが提供しているSOAP通信基盤を使用していない場合は，それぞれの通信基盤の実装に依存します。

(b)　ユーザ定義受付の場合

エラーの伝わり方は，エラーの種類やビジネスプロセスの有無によって異なります。

サービス部品からユーザ定義例外のエラーがリターンした場合（ビジネスプロセスを使用するとき）

サービス部品からユーザ定義例外のエラーがリターンした場合でビジネスプロセスを使用するときのSOAP通信でのエラーの伝わり方を次の図に示します。

図7‒50　サービス部品からユーザ定義例外のエラーがリターンした場合（ビジネスプロセスを使用するとき）のSOAP通信でのエラーの伝わり方

サービス部品側の通信基盤にサービスプラットフォームが提供しているSOAP通信基盤またはJAX-WSエンジンを使用している場合で，サービス部品で例外をスローするコーディングをしている場合，サービス部品のWSDLにはユーザ定義例外が定義されます。サービス部品でユーザ定義例外が発生すると，そのエラーは，一度ビジネスプロセスでキャッチできます。

サービスリクエスタは，ユーザ定義受付に定義したWSDLを使用しますが，ビジネスプロセスから応答するフォルトをWSDLに定義することで，サービスリクエスタでもユーザ定義例外のSOAPフォルトとしてキャッチできます。これによって，サービスリクエスタでもサービス部品がリターンするSOAPフォルトと同じ名称および形式でキャッチすることができます。

キャッチした例外オブジェクトを解析するための情報は，サービス部品側のプログラムで作成する必要があります。なお，ビジネスプロセスでフォルト名を定義することで，サービスリクエスタで発生した例外が切り分けやすくなります。

SOAP受付に要求を出すサービスリクエスタでエラー情報を取得する方法については，マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」の「9.7.6　エラー情報を取得する」を参照してください。

サービス部品からユーザ定義例外以外のエラーがリターンした場合（ビジネスプロセスを使用するとき）

サービス部品からユーザ定義例外以外のエラーがリターンした場合でビジネスプロセスを使用するときのSOAP通信でのエラーの伝わり方を次の図に示します。

図7‒51　サービス部品からユーザ定義例外以外のエラーがリターンした場合（ビジネスプロセスを使用するとき）のSOAP通信でのエラーの伝わり方

サービス部品側の通信基盤にサービスプラットフォームが提供しているSOAP通信基盤を使用している場合で，サービス部品でWSDLに定義していない想定外の例外（システム例外）が発生したときは，RuntimeExceptionとしてSOAPメッセージが伝わります。また，サービス部品側の通信基盤にJAX-WSエンジンを使用している場合や，サービスプラットフォームが提供しているSOAP通信基盤を使用していない場合は，WSDLにSOAPフォルトを定義していてもHCSCサーバ内では例外として扱われます。

サービスアダプタからサービス部品を呼び出したときに発生したシステム例外は，サービスアダプタでフォルト電文に変換することもできます。

例外をフォルト電文に変換しない場合，ビジネスプロセスでは例外として処理して，ユーザ定義受付にスローします。例外をフォルト電文に変換した場合，フォルトとしてビジネスプロセスでキャッチできます。システム例外をフォルト電文に変換する方法については，「7.11　サービスアダプタでの例外発生時の運用」を参照してください。

HCSCサーバはCSCMsgServerFaultExceptionのSOAPフォルトでサービスリクエスタにリターンしますが，サービスリクエスタが使用するWSDLはユーザ定義受付に定義したWSDLで，このWSDLにはCSCMsgServerFaultExceptionが定義されていません。そのため，サービスリクエスタ側の通信基盤にサービスプラットフォームが提供しているSOAP通信基盤を使用している場合は，C4Faultオブジェクトで例外をキャッチします。キャッチした例外オブジェクトのgetterを使用することで，発生したフォルト情報（エラーの詳細）を取得できます。C4Faultの詳細については，マニュアル「アプリケーションサーバ SOAPアプリケーション開発の手引」の「13.2　C4Faultクラス（SOAP Fault情報の保持）」を参照してください。

なお，サービスリクエスタ側の通信基盤にJAX-WSエンジンを使用している場合は，SOAPFaultExceptionオブジェクトで例外をキャッチできます。また，サービスプラットフォームが提供しているSOAP通信基盤を使用していない場合は，それぞれの通信基盤の実装に依存します。

サービス部品が応答したSOAPフォルトをHCSCサーバ内で例外ではなくSOAPフォルトのままで伝え，ビジネスプロセスでフォルトをキャッチしたい場合は，SOAP Fault動作定義ファイルで定義します。SOAP Fault動作定義ファイルの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.6.1　SOAP Fault動作定義ファイル」を参照してください。

HCSCサーバからエラーがリターンした場合（ビジネスプロセスを使用するとき）

HCSCサーバからエラーがリターンした場合でビジネスプロセスを使用するときのSOAP通信でのエラーの伝わり方を次の図に示します。

図7‒52　HCSCサーバからエラーがリターンした場合（ビジネスプロセスを使用するとき）のSOAP通信でのエラーの伝わり方

図中の各エラーには，次に示すケースが該当します。

エラー1：指定文字コード不正，各種フォーマット不正など

エラー2：宛先（ロケーション）が見つからない，サービスアダプタが停止しているなど

エラー3：データ変換に失敗したなど

エラー4：宛先不正，サービス部品が停止，通信障害など

エラー5：ビジネスプロセス処理上での例外エラーなど

HCSCサーバで図中のエラー1〜エラー3およびエラー5のどれかを検知した場合，発生したエラーの例外をサービスリクエスタにリターンします。図中のエラー4を検知した場合，発生したエラーの例外をサービスリクエスタにそのままリターンするか，サービスアダプタでエラーの例外をフォルト電文に変換するか選択できます。例外発生時に取得するエラーの選択方法については，「7.11　サービスアダプタでの例外発生時の運用」を参照してください。

HCSCサーバはCSCMsgServerFaultExceptionのSOAPフォルトでサービスリクエスタにリターンしますが，サービスリクエスタが使用するWSDLはユーザ定義受付に定義したWSDLで，このWSDLにはCSCMsgServerFaultExceptionが定義されていません。そのため，サービスリクエスタ側の通信基盤にサービスプラットフォームが提供しているSOAP通信基盤を使用している場合は，C4Faultオブジェクトで例外をキャッチします。キャッチした例外オブジェクトのgetterを使用することで，発生したフォルト情報（エラーの詳細）を取得できます。C4Faultの詳細については，マニュアル「アプリケーションサーバ SOAPアプリケーション開発の手引」の「13.2　C4Faultクラス（SOAP Fault情報の保持）」を参照してください。

なお，サービスリクエスタ側の通信基盤にJAX-WSエンジンを使用している場合は，SOAPFaultExceptionオブジェクトで例外をキャッチできます。また，サービスプラットフォームが提供しているSOAP通信基盤を使用していない場合は，それぞれの通信基盤の実装に依存します。

サービスリクエスタでエラーを検知した場合

サービスリクエスタでエラーを検知した場合のSOAP通信でのエラーの伝わり方を次の図に示します。

図7‒53　サービスリクエスタでエラーを検知した場合のSOAP通信でのエラーの伝わり方（ユーザ定義受付の場合）

宛先不正，HCSCサーバが停止，通信障害などで，サービスリクエスタからHCSCサーバを呼び出せなかった場合や，サービス部品の呼び出しは完了したが何らかの原因でHCSCサーバからサービスリクエスタへの応答が返らなかった場合などでは，サービスリクエスタ側（クライアント側）のSOAP通信基盤またはJAX-WSエンジンがエラーをリターンします。

サービスリクエスタ側の通信基盤にサービスプラットフォームが提供しているSOAP通信基盤を使用している場合は，C4Faultオブジェクトで例外をキャッチできます。キャッチした例外オブジェクトのgetterを使用することで，発生したフォルト情報（エラーの詳細）を取得できます。C4Faultの詳細については，マニュアル「アプリケーションサーバ SOAPアプリケーション開発の手引」の「13.2　C4Faultクラス（SOAP Fault情報の保持）」を参照してください。

なお，サービスリクエスタ側の通信基盤にJAX-WSエンジンを使用している場合は，SOAPFaultExceptionオブジェクトで例外をキャッチできます。また，サービスプラットフォームが提供しているSOAP通信基盤を使用していない場合は，それぞれの通信基盤の実装に依存します。

(2)　問題発生個所の切り分け方

標準受付の場合とユーザ定義受付の場合とで問題発生個所の切り分け方が異なります。なお，SOAPによる通信ができない場合の問題発生個所の切り分けについては，マニュアル「アプリケーションサーバ SOAPアプリケーション開発の手引」の「14.3　問題発生個所の切り分け」を参照してください。

(a)　標準受付の場合

サービスリクエスタから標準受付（Webサービス）を使用してサービス部品を呼び出した場合の問題発生個所の切り分け方について次の図に示します。

図7‒54　問題発生個所の切り分け方（サービスリクエスタから標準受付（Webサービス）を使用してサービス部品を呼び出した場合）

(i)サービス部品に障害の要因がある場合（サービス部品で定義したユーザ定義例外の場合）

サービス部品に障害の要因があるおそれがあります。次のメソッドを使用してサービス部品が返したSOAP Faultの内容を取得できます。

<SOAP1.1の場合>

getCscmsgFaultCode：FaultCode情報を取得します。

getCscmsgFaultString：FaultString情報を取得します。

getCscmsgFaultActor：FaultActor情報を取得します。

getCscmsgFaultDetail：FaultDetail情報を取得します。

<SOAP1.2の場合>

getCscmsgFaultCode：Code情報を取得します。

getCscmsgFaultReason：Reason情報を取得します。

getCscmsgFaultRole：Role情報を取得します。

getCscmsgFaultNode：Node情報を取得します。

getCscmsgFaultDetail：Detail情報を取得します。

要因は，次の観点で調査してください。

サービスリクエスタから要求したユーザ電文

サービス部品稼働マシン

サービス部品のプログラム

サービス部品の呼び出しを再送するかどうかは，HCSCサーバを介したサービスリクエスタとサービス部品間（エンドツーエンド）の取り決めとなります。

(ii)ビジネスプロセスに障害の要因がある場合（ビジネスプロセスで定義したフォルトの場合）

ビジネスプロセスで実行したアクティビティの処理に障害の要因があるおそれがあります（サービス呼出アクティビティの場合，呼び出したサービス部品に障害の要因があるおそれがあります）。

次のメソッドを使用してビジネスプロセスまたはサービス部品が返したSOAP Faultの内容を取得できます。

<SOAP1.1の場合>

getCscmsgFaultCode：FaultCode情報を取得します。

getCscmsgFaultString：FaultString情報を取得します。

getCscmsgFaultActor：FaultActor情報を取得します。

getCscmsgFaultDetail：FaultDetail情報を取得します。

<SOAP1.2の場合>

getCscmsgFaultCode：Code情報を取得します。

getCscmsgFaultReason：Reason情報を取得します。

getCscmsgFaultRole：Role情報を取得します。

getCscmsgFaultNode：Node情報を取得します。

getCscmsgFaultDetail ：Detail情報を取得します。

要因は，次の観点で調査してください。

サービスリクエスタから要求したユーザ電文

サービス部品稼働マシン

サービス部品のプログラム

ビジネスプロセスの定義内容

サービス部品の呼び出しを再送するかどうかは，HCSCサーバを介したサービスリクエスタとサービス部品間（エンドツーエンド）の取り決めとなります。

また，ビジネスプロセスをどのようなプロセスに設計したかによって，再送（ビジネスプロセスの再実行）をするかどうかサービスリクエスタを含むシステム設計する必要があります。

(iii)HCSCサーバでエラーを検知した場合（例外名が設定されていない場合）

次のメソッドを使用してエラーの内容を取得できます。取得したエラーコードおよびエラーメッセージの対策に従って対処します。また，サービスプラットフォームが出力するメッセージログも参照して，調査します。

getErrorMessage：HCSCサーバ内で検知したエラーのエラーメッセージを取得します。

getErrorCode：HCSCサーバ内で検知したエラーのエラーコードを取得します。

要因は，次の観点で調査してください。

サービスリクエスタから要求した引数の内容

HCSCサーバの設定または状態

サービスアダプタの定義内容査

ビジネスプロセスの定義内容

サービスリクエスタから要求したユーザ電文

サービス部品稼働マシン

サービス部品のプログラム

ネットワークの状態

また，次に示す処理が常に実行されているかを確認することで，問題発生個所を絞り込めます。

サービスアダプタ（クライアント）からSOAPメッセージが正しく出力されているか。

SOAPメッセージはサービス部品稼働マシン（サーバ）のSOAP通信基盤またはJAX-WSエンジンに届いているか。

サービス部品稼働マシン（サーバ）のサービス部品でメッセージが処理できているか。

サービス部品稼働マシン（サーバ）のサービス部品からの返信用SOAPメッセージは正しく出力されているか。

サービス部品稼働マシン（サーバ）のサービス部品からの返信用SOAPメッセージはサービスアダプタ（クライアント）のSOAP通信基盤またはJAX-WSエンジンに届いているか。

確認するときはSOAP通信基盤またはJAX-WSエンジンが出力する障害情報を参照します。障害情報の取得方法については，「7.3.3(3)　SOAP通信基盤またはJAX-WSエンジンが出力する障害情報の取得方法」を参照してください。

SOAP通信基盤が出力する障害情報の形式については，マニュアル「アプリケーションサーバ SOAPアプリケーション開発の手引」の「14.　障害対策」を参照してください。JAX-WSエンジンが出力する障害情報の形式については，マニュアル「アプリケーションサーバ Webサービス開発ガイド」の「39.　障害対策」を参照してください。

なお，SOAP通信基盤またはJAX-WSエンジンが出力するアプリケーションログを取得することで，サービスアダプタとサービス部品間で送受信している電文データを確認できます。

サービス部品の呼び出しを再送するかどうかは，エラーの内容によって異なります。

一時的な障害の場合は，再送を試みることで成功することがありますが，次に示すエラーの場合は，再送を試みてもエラーとなります。

サービスリクエスタから要求した引数の内容が誤っている場合

HCSCサーバの設定に誤りがある場合

サービスアダプタやビジネスプロセスの定義に誤りがある場合

サービスリクエスタから要求したユーザ電文に誤りがある場合など

(iv)通信基盤でエラーを検知した場合（C4Faultの場合）

SOAP通信基盤が提供するC4Faultからエラーの内容を取得できます。取得したエラーコードおよびエラーメッセージの対策に従って対処します。

C4Faultの詳細については，マニュアル「アプリケーションサーバ SOAPアプリケーション開発の手引」の「13.2　C4Faultクラス（SOAP Fault情報の保持）」を参照してください。

要因は，次の観点で調査してください。

サービスリクエスタで使用しているWSDL

サービスリクエスタ稼働マシンのSOAP通信基盤の設定または状態

HCSCサーバの設定または状態

ネットワークの状態

また，次に示す処理が常に実行されているかを確認することで，問題発生個所を絞り込めます。

サービスリクエスタ（クライアント）からSOAPメッセージが正しく出力されているか。

SOAPメッセージはHCSCサーバ稼働マシン（サーバ）のSOAP通信基盤に届いているか。

HCSCサーバ稼働マシン（サーバ）のサービス部品からの返信用SOAPメッセージは正しく出力されているか。

HCSCサーバ稼働マシン（サーバ）のサービス部品からの返信用SOAPメッセージはサービスリクエスタ（クライアント）のSOAP通信基盤に届いているか。

確認するときはSOAP通信基盤が出力する障害情報を参照します。障害情報の取得方法については，「7.3.3(3)　SOAP通信基盤またはJAX-WSエンジンが出力する障害情報の取得方法」を参照してください。

SOAP通信基盤が出力する障害情報の形式については，マニュアル「アプリケーションサーバ SOAPアプリケーション開発の手引」の「14.　障害対策」を参照してください。

なお，SOAP通信基盤が出力するアプリケーションログを取得することで，サービスリクエスタとHCSCサーバ間で送受信している電文データを確認できます。

サービス部品の呼び出しを再送するかどうかは，エラーの内容によって異なります。一時的な障害の場合は，再送を試みることで成功することがありますが，次に示すエラーの場合は，再送を試みてもエラーとなります。

サービスリクエスタで使用しているWSDLが誤っている場合

サービスリクエスタ稼働マシンのSOAP通信基盤の設定に誤りがある場合

HCSCサーバの設定に誤りがある場合

(b)　ユーザ定義受付の場合

サービスリクエスタからSOAP受付を使用してサービス部品を呼び出した場合の問題発生個所の切り分け方について次の図に示します。

図7‒55　問題発生個所の切り分け方（サービスリクエスタからSOAP受付を使用してサービス部品を呼び出した場合）

(i)サービス部品に障害の要因がある場合（サービス部品で定義したユーザ定義例外の場合）

サービス部品に障害の要因があるおそれがあります。エラーの情報は，サービス部品で定義した内容になります（キャッチした例外オブジェクトの解析するための情報は，サービス部品側のプログラムで作成する必要があります）。

要因は，次の観点で調査してください。

サービスリクエスタから要求したユーザ電文

サービス部品稼働マシン

サービス部品のプログラム

サービス部品の呼び出しを再送するかどうかは，HCSCサーバを介したサービスリクエスタとサービス部品間（エンドツーエンド）の取り決めとなります。

(ii)ビジネスプロセスに障害の要因がある場合（ビジネスプロセスで定義したフォルトの場合）

ビジネスプロセスで実行したアクティビティの処理に障害の要因があるおそれがあります（サービス呼出アクティビティの場合，呼び出したサービス部品に障害の要因があるおそれがあります）。

エラーの情報は，ビジネスプロセスで定義したフォルトの内容になります（キャッチした例外オブジェクトを解析するための情報は，ビジネスプロセスを定義するときに設定しておく必要があります）。

要因は，次の観点で調査してください。

サービスリクエスタから要求したユーザ電文

サービス部品稼働マシン

サービス部品のプログラム

ビジネスプロセスの定義内容

サービス部品の呼び出しを再送するかどうかは，HCSCサーバを介したサービスリクエスタとサービス部品間（エンドツーエンド）の取り決めとなります。

また，ビジネスプロセスの設計内容によっても，再送（ビジネスプロセスの再実行）するかどうかシステム設計する必要があります。

(iii)HCSCサーバでエラーを検知した場合（CSCMsgServerFaultExceptionの場合）

SOAP通信基盤が提供するC4Faultからエラーの内容を取得できます。取得したエラーコードおよびエラーメッセージの対策に従って対処します。サービスリクエスタでC4Faultからエラー情報を取得するときの実装方法については，マニュアル「サービスプラットフォーム開発ガイド 基本開発編」の「9.7.6　エラー情報を取得する」を参照してください。C4Faultの詳細については，マニュアル「アプリケーションサーバ SOAPアプリケーション開発の手引」の「13.2　C4Faultクラス（SOAP Fault情報の保持）」を参照してください。また，サービスプラットフォームが出力するメッセージログも参照して，調査します。

要因は，次の観点で調査してください。

サービスリクエスタから要求した引数の内容

HCSCサーバの設定または状態

サービスアダプタの定義内容

ビジネスプロセスの定義内容

サービスリクエスタから要求したユーザ電文

サービス部品稼働マシン

サービス部品のプログラム

ネットワークの状態

また，次に示す処理が常に実行されているかを確認することで，問題発生個所を絞り込めます。

サービスアダプタ（クライアント）からSOAPメッセージが正しく出力されているか。

SOAPメッセージはサービス部品稼働マシン（サーバ）のSOAP通信基盤に届いているか。

サービス部品稼働マシン（サーバ）のサービス部品でメッセージが処理できているか。

サービス部品稼働マシン（サーバ）のサービス部品からの返信用SOAPメッセージは正しく出力されているか。

サービス部品稼働マシン（サーバ）のサービス部品からの返信用SOAPメッセージはサービスアダプタ（クライアント）のSOAP通信基盤に届いているか。

確認するときはSOAP通信基盤が出力する障害情報を参照します。障害情報の取得方法については，「7.3.3(3)　SOAP通信基盤またはJAX-WSエンジンが出力する障害情報の取得方法」を参照してください。

SOAP通信基盤が出力する障害情報の形式については，マニュアル「アプリケーションサーバ SOAPアプリケーション開発の手引」の「14.　障害対策」を参照してください。

なお，SOAP通信基盤が出力するアプリケーションログを取得することで，サービスアダプタとサービス部品間で送受信している電文データを確認できます。

サービス部品の呼び出しを再送するかどうかは，エラーの内容によって異なります。一時的な障害の場合は，再送を試みることで成功することがありますが，次に示すエラーの場合は，再送を試みてもエラーとなります。

サービスリクエスタから要求した引数の内容が誤っている場合

HCSCサーバの設定に誤りがある場合

サービスアダプタやビジネスプロセスの定義に誤りがある場合

サービスリクエスタから要求したユーザ電文に誤りがある場合など

(iv)通信基盤でエラーを検知した場合（(i)〜(iii)以外の場合）

SOAP通信基盤が提供するC4Faultからエラーの内容を取得できます。取得したエラーコードおよびエラーメッセージの対策に従って対処してください。

サービスリクエスタでC4Faultからエラー情報を取得するときの実装方法については，マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」の「9.7.6　エラー情報を取得する」を参照してください。C4Faultの詳細については，マニュアル「アプリケーションサーバ SOAPアプリケーション開発の手引」の「13.2　C4Faultクラス（SOAP Fault情報の保持）」を参照してください。また，サービスプラットフォームが出力するメッセージログも参照して，調査します。

要因は，次の観点で調査してください。

サービスリクエスタで使用しているWSDL

サービスリクエスタ稼働マシンのSOAP通信基盤の設定または状態

HCSCサーバの設定または状態

ネットワークの状態

また，次に示す処理が常に実行されているかを確認することで，問題発生個所を絞り込めます。

サービスリクエスタ（クライアント）からSOAPメッセージが正しく出力されているか。

SOAPメッセージはHCSCサーバ稼働マシン（サーバ）のSOAP通信基盤に届いているか。

HCSCサーバ稼働マシン（サーバ）のサービス部品からの返信用SOAPメッセージは正しく出力されているか。

HCSCサーバ稼働マシン（サーバ）のサービス部品からの返信用SOAPメッセージはサービスリクエスタ（クライアント）のSOAP通信基盤に届いているか。

確認するときはSOAP通信基盤が出力する障害情報を参照します。障害情報の取得方法については，「7.3.3(3)　SOAP通信基盤またはJAX-WSエンジンが出力する障害情報の取得方法」を参照してください。

SOAP通信基盤が出力する障害情報の形式については，マニュアル「アプリケーションサーバ SOAPアプリケーション開発の手引」の「14.　障害対策」を参照してください。

なお，SOAP通信基盤が出力するアプリケーションログを取得することで，サービスリクエスタとHCSCサーバ間で送受信している電文データを確認できます。

サービス部品の呼び出しを再送するかどうかは，エラーの内容によって異なります。一時的な障害の場合は，再送を試みることで成功することがありますが，次に示すエラーの場合は，再送を試みてもエラーとなります。

サービスリクエスタで使用しているWSDLが誤っている場合

サービスリクエスタ稼働マシンのSOAP通信基盤の設定に誤りがある場合

HCSCサーバの設定に誤りがある場合など

(3)　HCSCサーバから応答するSOAP Faultの内容

HCSCサーバから応答するSOAPメッセージについて，SOAP Faultの要素と，エラー時に設定される情報の対応を示します。

(a)　SOAP1.1の場合

SOAP1.1を利用している場合のSOAP Faultの要素と，エラー時に設定される情報の対応を次の表に示します。

エラーのケースの番号は「7.7.1(2)　問題発生個所の切り分け方」で示す番号に相当します。

表7‒76　HCSCサーバから応答するSOAP Faultの内容（SOAP1.1の場合）

HCSCサーバから応答するSOAP Fault

エラーのケース

SOAP Fault要素

SOAP Fault名称

フォルト名

標準受付の(i)，(ii)の場合

標準受付の(iii)，ユーザ定義受付の(iii)の場合

faultcode

Faultコード

−

SOAP通信基盤およびJAX-WSエンジンに依存する値です。

SOAP通信基盤では，message partのメッセージ型属性が参照するQCNameを出力します。

JAX-WSエンジンでは，違反コードを出力します。

faultstring

Fault文字列

−

エラーメッセージを出力します。

faultactor

Fault生成者

−

SOAP通信基盤およびJAX-WSエンジンに依存する値です。

SOAP通信基盤，JAX-WSエンジンともに値はありません。

detail

Fault詳細

errorMessage

次に示すエラーの内容です。

HCSCサーバ内で検知したエラー

サービス部品，ビジネスプロセス，およびサービスアダプタ※からのエラー

errorCode

次に示す例外の内容に対応するエラーコードです。

HCSCサーバ内で検知したエラー

サービス部品，ビジネスプロセス，およびサービスアダプタ※からのエラー

processInstanceID

ビジネスプロセスのインスタンスIDの情報です。ビジネスプロセスでエラーが発生した場合に値が設定されます。

cscmsgFaultCode

サービス部品（Webサービス），ビジネスプロセス，またはサービスアダプタ※からのFaultCode情報です。

値はありません。

cscmsgFaultString

サービス部品（Webサービス），ビジネスプロセス，またはサービスアダプタ※からのFaultString情報です。

値はありません。

cscmsgFaultActor

サービス部品（Webサービス），ビジネスプロセス，またはサービスアダプタ※からのFaultActor情報です。

値はありません。

cscmsgFaultDetail

サービス部品（Webサービス），ビジネスプロセス，またはサービスアダプタ※からのDetail情報です。

値はありません。

faultName

サービス部品（WebサービスまたはSessionBean）またはビジネスプロセスからのフォルト名（例外名）情報です。次の場合に値が設定されます。

サービス部品（WebサービスまたはSessionBean）からのユーザ定義例外のSOAP Faultの場合

ビジネスプロセスからのフォルトの場合

値はありません。

（凡例）

−：該当しません。

注1

ユーザ定義受付の(i)，(ii)の場合は，ユーザ定義例外のSOAP Faultとなります。

注2

標準受付の(iv)，またはユーザ定義受付の(iv)の場合は，サービスリクエスタ側のSOAP通信基盤またはJAX-WSエンジンからエラー通知します。

注※

次に示すサービスアダプタは対象外です。

・SOAPアダプタ

・SessionBeanアダプタ

・MDB（WS-R）アダプタ

・MDB（DBキュー）アダプタ

(b)　SOAP1.2の場合

SOAP1.2を利用している場合のSOAP Faultの要素と，エラー時に設定される情報の対応を次の表に示します。

エラーのケースの番号は「7.7.1(2)　問題発生個所の切り分け方」で示す番号に相当します。

表7‒77　HCSCサーバから応答するSOAP Faultの内容（SOAP1.2の場合）

HCSCサーバから応答するSOAP Fault

エラーのケース

SOAP Fault要素

SOAP Fault名称

フォルト名

標準受付の(i)，(ii)の場合

標準受付の(iii)，ユーザ定義受付の(iii)の場合

Code

Faultコード

−

違反コードを出力します。

Reason

Fault理由

−

エラーメッセージを出力します。

Role

Fault生成者

−

値はありません。

Node

Faultノード

−

値はありません。

Detail

Fault詳細

errorMessage

次に示すエラーの内容です。

HCSCサーバ内で検知したエラー

サービス部品，ビジネスプロセス，およびサービスアダプタ※からのエラー

errorCode

次に示す例外の内容に対応するエラーコードです。

HCSCサーバ内で検知したエラー

サービス部品，ビジネスプロセス，およびサービスアダプタ※からのエラー

processInstanceID

ビジネスプロセスのインスタンスIDの情報です。ビジネスプロセスでエラーが発生した場合に値が設定されます。

cscmsgFaultCode

サービス部品（Webサービス），ビジネスプロセス，またはサービスアダプタ※からのCode情報です。

値はありません。

cscmsgFaultReason

サービス部品（Webサービス），ビジネスプロセス，またはサービスアダプタ※からのReason情報です。

値はありません。

cscmsgFaultRole

サービス部品（Webサービス），ビジネスプロセス，またはサービスアダプタ※からのRole情報です。

値はありません。

cscmsgFaultNode

サービス部品（Webサービス），ビジネスプロセス，またはサービスアダプタ※からのNode情報です。

値はありません。

cscmsgFaultDetail

サービス部品（Webサービス），ビジネスプロセス，またはサービスアダプタ※からのDetail情報です。

値はありません。

faultName

サービス部品（WebサービスまたはSessionBean）またはビジネスプロセスからのフォルト名（例外名）情報です。次の場合に値が設定されます。

サービス部品（WebサービスまたはSessionBean）からのユーザ定義例外のSOAP Faultの場合

ビジネスプロセスからのフォルトの場合

値はありません。

（凡例）

−：該当しません。

注1

ユーザ定義受付の(i)，(ii)の場合は，ユーザ定義例外のSOAP Faultとなります。

注2

標準受付の(iv)，またはユーザ定義受付の(iv)の場合は，サービスリクエスタ側のJAX-WSエンジンからエラー通知します。

注※

次に示すサービスアダプタは対象外です。

・SOAPアダプタ

・SessionBeanアダプタ

・MDB（WS-R）アダプタ

・MDB（DBキュー）アダプタ

(4)　そのほかの障害要因の特定方法（サービス部品呼び出し要求の実行履歴の追跡）

ビジネスプロセスを使用する場合には，サービスリクエスタへ応答した例外およびエラーメッセージから問題発生個所を切り分ける方法のほかに，次のどちらかでサービス部品呼び出し要求の実行履歴を追跡し，問題発生個所を特定する方法があります。

サービスリクエスタから指定したクライアント相関IDからたどる方法

ユーザ電文に指定したビジネスプロセスの相関セットからたどる方法

ここでは，サービス部品呼び出し要求の実行履歴を追跡する手順について説明します。サービス部品呼び出し要求の実行履歴の追跡を次の図に示します。

図7‒56　サービス部品呼び出し要求の実行履歴の追跡（Webサービスの場合）

実行履歴の追跡の基本的な流れは次のようになります。

要求時に，受付ごとに次の指定をします。

標準受付の場合

要求時のパラメタにクライアント相関IDを指定，または要求電文に相関セットを指定します。

ユーザ定義受付の場合

要求電文に相関セットを指定します。

エラーが発生したときのメッセージ共通IDを取得することで，障害が発生したビジネスプロセスのインスタンスを特定します。

データベースに出力されているプロセスインスタンスの実行履歴を検索し，メッセージ共通IDと対応したビジネスプロセスのプロセスIDを取得します。

プロセスIDを使ってアクティビティの状態を知ることができ，それによってどこの処理で止まっているのかや，どこまで処理が進んでいるのかがわかります。

メッセージ共通IDを使って，ユーザ電文トレースからユーザ電文を取得します。

電文の内容を確認でき，障害調査の原因究明に役立ちます。

サービス部品呼び出し要求の実行履歴を追跡するには，主に次の2つの方法があります。

サービスリクエスタから指定したクライアント相関IDからたどる方法

ユーザ電文に指定したビジネスプロセスの相関セットからたどる方法

(a)　サービスリクエスタから指定したクライアント相関IDからたどる方法

サービスリクエスタから指定したクライアント相関IDからたどる手順を次に示します。

クライアント相関IDを調査します。

クライアント相関IDは，サービス部品呼び出しを要求するサービスリクエスタ側のプログラムで，要求時（呼び出し時）に設定する情報です。サービスリクエスタからの要求電文と，HCSCサーバで管理しているログおよびトレースとを対応づけるために使用します。そのため，HCSCサーバに送信した要求ごとに異なるIDを指定することを推奨します（サービスリクエスタ作成時に指定が必要です）。

サービス部品呼び出し要求の実行履歴を追跡する場合，サービスリクエスタ側の要求者からシステム管理者に障害調査を依頼するとき，クライアント相関IDを伝え，システム管理者はその情報を基に実行履歴を追跡します。

サービスリクエスタでのクライアント相関IDを指定するコーディングの例を次に示します。ここでは，標準受付（Webサービス）を呼び出すときの引数に，クライアント相関ID（"ClientID0001"）を設定しています。

クライアント相関IDを基にリクエストトレースを調査し，エラーが発生したときのメッセージ共通IDを取得します。メッセージ共通IDによって，障害が発生したビジネスプロセスのインスタンスを特定できます。

なお，クライアント相関IDは重複しているおそれがあります。そのため，適宜実行時刻やビジネスプロセス名（サービス名）を取得しておくことで，該当個所を特定します。

リクエストトレースの例を次に示します。リクエストトレースの"message"列にクライアント相関IDやビジネスプロセス名（サービス名）があり，先頭にメッセージ共通IDが出力されています。

取得したメッセージ共通IDを基に，プロセスインスタンスの実行履歴を参照してビジネスプロセスのプロセスIDを取得します。プロセスIDを取得するには，プロセスインスタンスの検索（cscpiselect）コマンドを使用します。

cscpiselectコマンドでは，開始日時とビジネスプロセス名（サービス名）を条件に，プロセスインスタンスの実行履歴を検索します。

また，-tableオプションに"relation"を指定し，検索条件（where句）にSQL条件を指定して，該当するメッセージ関連情報を表示します。

cscpiselectコマンドの使い方については「6.1.2　プロセスインスタンスの実行履歴を検索する」を，コマンドの文法については，マニュアル「サービスプラットフォーム リファレンス」の「cscpiselect（プロセスインスタンスの検索）」を参照してください。

取得したプロセスIDを基に，プロセスインスタンスの実行履歴を参照して，ビジネスプロセスのアクティビティとその状態を取得します。アクティビティの情報を取得するには，プロセスインスタンスの検索（cscpiselect）コマンドを使用します。

cscpiselectコマンドでは，開始日時とビジネスプロセス名（サービス名）を条件に，プロセスインスタンスの実行履歴を検索します。

また，-tableオプションに"activity"を指定し，検索条件（where句）にSQL条件を指定して，該当するアクティビティ情報を表示します。

状態が"Executing"となっている個所が現在実行中のアクティビティです。状態を確認することで，どのアクティビティで止まっているかがわかります。

cscpiselectコマンドの使い方については「6.1.2　プロセスインスタンスの実行履歴を検索する」を，コマンドの文法については，マニュアル「サービスプラットフォーム リファレンス」の「cscpiselect（プロセスインスタンスの検索）」を参照してください。

ユーザ電文トレースを採取する設定をしている場合，ユーザ電文の内容を確認できます。

ユーザ電文トレースでは，メッセージ共通IDを基にユーザ電文を検索します（クライアント相関IDや日時からも検索できます）。ユーザ電文トレースの出力先や出力内容については，「7.4.4　ユーザ電文トレース」を参照してください。

ユーザ電文トレースの採取は，HCSCサーバランタイム定義ファイルで設定します。詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.5.6　HCSCサーバランタイム定義ファイル」を参照してください。

(b)　ユーザ電文に指定したビジネスプロセスの相関セットからたどる方法

ユーザ電文に指定したビジネスプロセスの相関セットからたどる手順を次に示します。

相関セットを調査します。

相関セットは，サービス部品呼び出しを要求するサービスリクエスタ側のプログラムで，要求時のユーザ電文に設定する情報です。サービスリクエスタからHCSCサーバを介してサービス部品に送信する要求電文を一意に識別するために利用する文字列です。

HCSCサーバからの応答は，相関セットを含んだ応答電文をサービスリクエスタに返信します。その結果，サービスリクエスタは受信した応答電文が，どの要求電文に対する応答であるのかを一意に識別できます。

相関セットを使用するには，開発環境でのビジネスプロセス定義時に定義する必要があります。詳細については，マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」の「5.5.2　相関セットの定義」を参照してください。

サービス部品呼び出し要求の実行履歴を追跡する場合，サービスリクエスタ側の要求者からシステム管理者に障害調査を依頼するときに，相関セットと要求したビジネスプロセス名（サービス名）を伝え，システム管理者はその情報を基に実行履歴を追跡します。

注意事項

サービスリクエスタ利用者が相関セットの値をとらえていない場合は，HCSCサーバにインポートしたリポジトリを開発環境で参照して，該当のビジネスプロセスの相関セットを調査する必要があります。相関セットの調査方法は次のとおりです。

ビジネスプロセス定義画面の［変数・相関セット］アイコンをダブルクリックします。

変数・相関セット一覧ダイアログが表示されます。

変数・相関セット一覧ダイアログの「表示」ボタンをクリックします。

変数の表示ダイアログが表示されます。

ユーザ電文と変数表示ダイアログのXMLスキーマを突き合わせて，相関セットへのパスを取得します。

変数・相関セット一覧ダイアログを使って，パス名から変数名や部分名を取得し，変数・相関セット一覧ダイアログから同じ変数名や部分名を持つ相関セットを探して相関セット名を取得します。

取得した相関セットを基に，プロセスインスタンスの実行履歴を参照して，ビジネスプロセスのプロセスIDを取得します。プロセスIDを取得するには，プロセスインスタンスの検索（cscpiselect）コマンドを使用します。

cscpiselectコマンドでは，相関セットを条件としてプロセスインスタンスの実行履歴を検索します。

また，-tableオプションに"process_set"を指定し，検索条件（where句）にSQL条件を指定し，該当するプロセス概要情報を表示します。

cscpiselectコマンドの使い方については「6.1.2　プロセスインスタンスの実行履歴を検索する」を，コマンドの文法については，マニュアル「サービスプラットフォーム リファレンス」の「cscpiselect（プロセスインスタンスの検索）」を参照してください。

取得したプロセスIDを基に，プロセスインスタンスの実行履歴を参照して，ビジネスプロセスのアクティビティとその状態を取得します。アクティビティの情報を取得するには，プロセスインスタンスの検索（cscpiselect）コマンドを使用します。

cscpiselectコマンドでは，開始日時とビジネスプロセス名（サービス名）を条件としてプロセスインスタンスの実行履歴を検索します。

また，-tableオプションに"activity"を指定し，検索条件に該当するアクティビティ情報を表示します。

状態が"Executing"となっている個所が現在実行中のアクティビティです。状態を確認することで，どのアクティビティで止まっているかがわかります。

cscpiselectコマンドの使い方については「6.1.2　プロセスインスタンスの実行履歴を検索する」を，コマンドの文法については，マニュアル「サービスプラットフォーム リファレンス」の「cscpiselect（プロセスインスタンスの検索）」を参照してください。

(5)　SOAP1.2のWebサービスを使用する際の注意事項

SOAP1.1のSOAP FaultとSOAP1.2のSOAP Faultでは形式に違いがあります。そのため，SOAP1.2のWebサービスがエラー応答を返したときに，リクエスト受付がEJBやSOAP1.1だと情報が欠落します。

SOAP1.2のWebサービスが返すすべてのSOAP Fault情報を確認するには，次に示す手段のどれかが必要になります。

SOAP1.2のリクエスト受付を使用し，サービスリクエスタを実装する。

ユーザ電文トレースで確認する（HCSCサーバランタイム定義でtelegramtrace=ONとtelegramtrace-trigger=FAULTの指定が必要）。

HCSCサーバのメッセージログを確認する（Detail情報を除いたFault情報が出力される）。

7.7.2　SessionBean実行時の障害対策

(1)　SessionBeanでの通信でのエラーの伝わり方

サービスリクエスタから標準受付を使用してサービス部品を呼び出す場合のエラーの伝わり方を説明します。エラーの伝わり方は，エラーの種類やビジネスプロセスの有無によって異なります。

サービス部品からユーザ定義例外のエラーがリターンした場合（ビジネスプロセスを使用しないとき）

サービス部品からユーザ定義例外のエラーがリターンした場合でビジネスプロセスを使用しないときのSessionBeanでの通信でのエラーの伝わり方を次の図に示します。

図7‒57　サービス部品からユーザ定義例外のエラーがリターンした場合（ビジネスプロセスを使用しないとき）のSessionBeanでの通信でのエラーの伝わり方

サービス部品で発生した例外は，そのまま例外としてHCSCサーバに伝わります。例外をキャッチしたHCSCサーバはサービスリクエスタに対してCSCMsgServerExceptionをスローします。キャッチした例外オブジェクトのgetterを使用することで，発生した例外名や例外の内容（エラーの詳細）を取得できます。CSCMsgServerExceptionの詳細については，マニュアル「サービスプラットフォーム開発ガイド 基本開発編」の「9.4.7　エラー情報を取得する」を参照してください。

サービス部品からユーザ定義例外以外のエラーがリターンした場合（ビジネスプロセスを使用しないとき）

サービス部品からユーザ定義例外以外のエラーがリターンした場合でビジネスプロセスを使用しないときのSessionBeanでの通信でのエラーの伝わり方を次の図に示します。

図7‒58　サービス部品からユーザ定義例外以外のエラーがリターンした場合（ビジネスプロセスを使用しないとき）のSessionBeanでの通信でのエラーの伝わり方

サービス部品で想定外の例外が発生した場合，RuntimeException（システム例外）としてHCSCサーバに伝わります。

サービスアダプタからサービス部品を呼び出したときに発生したシステム例外は，サービスアダプタでフォルト電文に変換することもできます。システム例外をフォルト電文に変換する方法については，「7.11　サービスアダプタでの例外発生時の運用」を参照してください。

例外をキャッチしたHCSCサーバはサービスリクエスタに対してCSCMsgServerExceptionをスローします。キャッチした例外オブジェクトのgetterを使用することで，発生した例外の内容（エラーの詳細）を取得できます。CSCMsgServerExceptionの詳細については，マニュアル「サービスプラットフォーム開発ガイド 基本開発編」の「9.4.7　エラー情報を取得する」を参照してください。

HCSCサーバからエラーがリターンした場合（ビジネスプロセスを使用しないとき）

HCSCサーバからエラーがリターンした場合でビジネスプロセスを使用しないときのSessionBeanでの通信でのエラーの伝わり方を次の図に示します。

図7‒59　HCSCサーバからエラーがリターンした場合（ビジネスプロセスを使用しないとき）のSessionBeanでの通信でのエラーの伝わり方

図中の各エラーには，次に示すケースが該当します。

エラー1：要求パラメタ不正など

エラー2：宛先（ロケーション）が見つからない，サービスアダプタが停止しているなど

エラー3：データ変換に失敗したなど

エラー4：宛先不正，サービス部品が停止，通信障害など

HCSCサーバで図中のエラー1〜エラー3のどれかを検知した場合，発生したエラーの情報をCSCMsgServerExceptionでサービスリクエスタにスローします。図中のエラー4を検知した場合，発生したエラーの例外をサービスリクエスタにそのままスローするか，サービスアダプタでエラーの例外をフォルト電文に変換するか選択できます。例外発生時に取得するエラーの選択方法については，「7.11　サービスアダプタでの例外発生時の運用」を参照してください。

サービスリクエスタは，キャッチした例外オブジェクトのgetterを使用することで，発生した例外の内容（エラーの詳細）を取得できます。CSCMsgServerExceptionの詳細については，マニュアル「サービスプラットフォーム開発ガイド 基本開発編」の「9.4.7　エラー情報を取得する」を参照してください。

サービス部品からユーザ定義例外のエラーがリターンした場合（ビジネスプロセスを使用するとき）

サービス部品からユーザ定義例外のエラーがリターンした場合でビジネスプロセスを使用するときのSessionBeanでの通信でのエラーの伝わり方を次の図に示します。

図7‒60　サービス部品からユーザ定義例外のエラーがリターンした場合（ビジネスプロセスを使用するとき）のSessionBeanでの通信でのエラーの伝わり方

サービス部品でユーザ定義例外が発生すると，ビジネスプロセスはエラーを次の順に処理します。

エラーを一度，ビジネスプロセスでキャッチします。

ビジネスプロセスで，サービス部品が失敗したことを示す例外に変換し，例外を伝えます。

サービスリクエスタに対してCSCMsgServerExceptionをスローします。

キャッチした例外オブジェクトのgetterを使用することで，発生した例外の内容（エラーの詳細）を取得できます。CSCMsgServerExceptionの詳細については，マニュアル「サービスプラットフォーム開発ガイド 基本開発編」の「9.4.7　エラー情報を取得する」を参照してください。

サービス部品からユーザ定義例外以外のエラーがリターンした場合（ビジネスプロセスを使用するとき）

サービス部品からユーザ定義例外以外のエラーがリターンした場合でビジネスプロセスを使用するときのSessionBeanでの通信でのエラーの伝わり方を次の図に示します。

図7‒61　サービス部品からユーザ定義例外以外のエラーがリターンした場合（ビジネスプロセスを使用するとき）のSessionBeanでの通信でのエラーの伝わり方

サービス部品で想定外の例外が発生した場合，発生した例外をサービスリクエスタにそのままリターンするか，サービスアダプタで例外をフォルト電文に変換するか選択できます。例外をフォルト電文に変換する方法については，「7.11　サービスアダプタでの例外発生時の運用」を参照してください。

例外をフォルト電文に変換しない場合，ビジネスプロセスはエラーを次の順に処理します。

エラーを一度，ビジネスプロセスでキャッチします。

ビジネスプロセスで，サービス部品が失敗したことを示す例外に変換し，例外を伝えます。

例外をフォルト電文に変換した場合，フォルトとしてビジネスプロセスでキャッチできます。

サービスリクエスタに対してCSCMsgServerExceptionをスローします。

キャッチした例外オブジェクトのgetterを使用することで，発生した例外の内容（エラーの詳細）を取得できます。CSCMsgServerExceptionの詳細については，マニュアル「サービスプラットフォーム開発ガイド 基本開発編」の「9.4.7　エラー情報を取得する」を参照してください。

HCSCサーバからエラーがリターンした場合（ビジネスプロセスを使用するとき）

HCSCサーバからエラーがリターンした場合でビジネスプロセスを使用するときのSessionBeanでの通信でのエラーの伝わり方を次の図に示します。

図7‒62　HCSCサーバからエラーがリターンした場合（ビジネスプロセスを使用するとき）のSessionBeanでの通信でのエラーの伝わり方

図中の各エラーには，次に示すケースが該当します。

エラー1：要求パラメタ不正など

エラー2：宛先（ロケーション）が見つからない，サービスアダプタが停止しているなど

エラー3：データ変換に失敗したなど

エラー4：宛先不正，サービス部品が停止，通信障害など

エラー5：ビジネスプロセス処理上での例外エラーなど

HCSCサーバで図中のエラー1〜エラー3およびエラー5のどれかを検知した場合，発生したエラーの情報をCSCMsgServerExceptionでサービスリクエスタにスローします。

図中のエラー4を検知した場合，発生したエラーの例外をサービスリクエスタにそのままスローするか，サービスアダプタでエラーの例外をフォルト電文に変換するか選択できます。例外発生時に取得するエラーの選択方法については，「7.11　サービスアダプタでの例外発生時の運用」を参照してください。

サービスリクエスタは，キャッチした例外オブジェクトのgetterを使用することで，発生した例外の内容（エラーの詳細）を取得できます。CSCMsgServerExceptionの詳細については，マニュアル「サービスプラットフォーム開発ガイド 基本開発編」の「9.4.7　エラー情報を取得する」を参照してください。

サービスリクエスタでエラーを検知した場合

サービスリクエスタでエラーを検知した場合のSessionBeanでの通信でのエラーの伝わり方を次の図に示します。

図7‒63　サービスリクエスタでエラーを検知した場合のSessionBeanでの通信でのエラーの伝わり方

サービスリクエスタからHCSCサーバを呼び出せなかった場合や，サービス部品の呼び出しは完了したが何らかの原因でHCSCサーバからサービスリクエスタへの応答が返らなかった場合などは，サービスリクエスタ側（クライアント側）のスタブ（J2EEコンテナ）がエラーをリターンします。サービスリクエスタはRuntimeExceptionで例外をキャッチできます。キャッチした例外オブジェクトのgetterを使用することで，発生したフォルト情報（エラーの詳細）を取得できます。

(2)　問題発生個所の切り分け方

サービスリクエスタから標準受付（SessionBean）を使用してサービス部品を呼び出した場合の問題発生個所の切り分け方について説明します。問題発生個所の切り分け方を次の図に示します。

図7‒64　問題発生個所の切り分け方（サービスリクエスタから標準受付（SessionBean）を使用してサービス部品を呼び出した場合）

(i)サービス部品に障害の要因がある場合（サービス部品で定義したユーザ定義例外の場合）

サービス部品に障害の要因があるおそれがあります。次のメソッドを使用してサービス部品が返した例外の内容を取得できます。

getErrorMessage：サービス部品からの例外の内容を取得します。

getErrorCode：サービス部品からの例外の内容に対応するエラーコードを取得します。

要因は，次の観点で調査してください。

サービスリクエスタから要求したユーザ電文

サービス部品稼働マシン

サービス部品のプログラム

サービス部品の呼び出しを再送するかどうかは，HCSCサーバを介したサービスリクエスタとサービス部品間（エンドツーエンド）の取り決めとなります。

(ii)ビジネスプロセスに障害の要因がある場合（ビジネスプロセスで定義したフォルトの場合）

ビジネスプロセスで実行したアクティビティの処理に障害の要因があるおそれがあります（サービス呼出アクティビティの場合，呼び出したサービス部品に障害の要因があるおそれがあります）。次のメソッドを使用してビジネスプロセスが返したフォルトの内容を取得できます。

getErrorMessage：ビジネスプロセスからの例外の内容を取得します。

getErrorCode：ビジネスプロセスからの例外の内容に対応するエラーコードを取得します。

getCscmsgFaultCode：FaultCode情報を取得します。

getCscmsgFaultString：FaultString情報を取得します。

getCscmsgFaultActor：FaultActor情報を取得します。

getCscmsgFaultDetail：FaultDetail情報を取得します。

要因は，次の観点で調査してください。

サービスリクエスタから要求したユーザ電文

サービス部品稼働マシン

サービス部品のプログラム

ビジネスプロセスの定義内容

サービス部品の呼び出しを再送するかどうかは，HCSCサーバを介したサービスリクエスタとサービス部品間（エンドツーエンド）の取り決めとなります。

また，ビジネスプロセスの設計内容によっても，再送（ビジネスプロセスの再実行）するかどうかシステム設計する必要があります。

(iii)HCSCサーバでエラーを検知した場合（例外名が設定されていない場合）

次のメソッドを使用してエラーの内容を取得できます。取得したエラーコードおよびエラーメッセージの対策に従って対処します。

getErrorMessage：HCSCサーバ内で検知したエラーのエラーメッセージを取得します。

getErrorCode：HCSCサーバ内で検知したエラーのエラーコードを取得します。

また，サービスプラットフォームが出力するメッセージログも参照して，調査します。

要因は，次の観点で調査してください。

サービスリクエスタから要求した引数の内容

HCSCサーバの設定または状態

サービスアダプタの定義内容

ビジネスプロセスの定義内容

サービスリクエスタから要求したユーザ電文

サービス部品稼働マシン

サービス部品のプログラム

ネットワークの状態

サービス部品呼び出しを再送するかどうかは，エラーの内容によって異なります。一時的な障害の場合は，再送を試みることで成功することがありますが，次に示すエラーの場合は，再送を試みてもエラーとなります。

サービスリクエスタから要求した引数の内容が誤っている場合

HCSCサーバの設定に誤りがある場合

サービスアダプタやビジネスプロセスの定義に誤りがある場合

サービスリクエスタから要求したユーザ電文に誤りがある場合など

(iv)通信基盤でエラーを検知した場合（RuntimeExceptionの場合）

RuntimeExceptionからエラーの内容を取得できます。取得した例外のエラー情報を基に対処してください。

要因は，次の観点で調査してください。

サービスリクエスタで使用しているスタブ

サービスリクエスタ稼働マシンのJ2EEコンテナの設定または状態

HCSCサーバの設定または状態

ネットワークの状態

サービス部品の呼び出しを再送するかどうかは，エラーの内容によって異なります。一時的な障害の場合は，再送を試みることで成功することがありますが，次に示すエラーの場合は，再送を試みてもエラーとなります。

サービスリクエスタで使用しているスタブが誤っている場合

サービスリクエスタ稼働マシンのJ2EEコンテナの設定に誤りがある場合

HCSCサーバの設定に誤りがある場合

(3)　HCSCサーバから応答する例外の内容

HCSCサーバから応答するSOAP Fault（SOAPメッセージ）について，どの要素に何の情報が設定されるかを示します。HCSCサーバから応答する例外の内容を次の表に示します。エラーのケースの番号は「7.7.2(2)　問題発生個所の切り分け方」で示す番号に相当します。

表7‒78　HCSCサーバから応答する例外の内容

HCSCサーバから応答するCSCMsgServerExceptionのフォルト名

エラーのケース

(ii)の場合

(i)，(iii)の場合

errorMessage

次に示すエラーの内容です。

HCSCサーバ内で検知したエラー

サービス部品，ビジネスプロセス，およびサービスアダプタ※からのエラー

errorCode

次に示す例外の内容に対応するエラーコードです。

HCSCサーバ内で検知したエラー

サービス部品，ビジネスプロセス，およびサービスアダプタ※からのエラー

processInstanceID

ビジネスプロセスのインスタンスIDの情報です。ビジネスプロセスでエラーが発生した場合に値が設定されます。

cscmsgFaultCode

サービス部品（Webサービス），ビジネスプロセス，またはサービスアダプタ※からのFaultCode情報です。

値はありません。

cscmsgFaultString

サービス部品（Webサービス），ビジネスプロセス，またはサービスアダプタ※からのFaultString情報です。

値はありません。

cscmsgFaultActor

サービス部品（Webサービス），ビジネスプロセス，またはサービスアダプタ※からのFaultActor情報です。

値はありません。

cscmsgFaultDetail

サービス部品（Webサービス），ビジネスプロセス，またはサービスアダプタ※からのDetail情報です。

値はありません。

faultName

サービス部品（WebサービスまたはSessionBean）またはビジネスプロセスからのフォルト名（例外名）情報です。次の場合に値が設定されます。

サービス部品（WebサービスまたはSessionBean）からのユーザ定義例外のSOAP Faultの場合

ビジネスプロセスからのフォルトの場合

値はありません。

注1

(iv)の場合は，サービスリクエスタ側のスタブ（J2EEコンテナ）からRuntimeExceptionをスローします。

注2

標準受付（SessionBean）からSOAPアダプタのサービス部品を呼び出した場合，(ii)の場合と同様にFault情報が設定されます。

注※

次に示すサービスアダプタは対象外です。

・SOAPアダプタ

・SessionBeanアダプタ

・MDB（WS-R）アダプタ

・MDB（DBキュー）アダプタ

(4)　そのほかの障害要因の特定方法（サービス部品呼び出し要求の実行履歴の追跡）

サービスリクエスタへ応答した例外およびエラーメッセージから問題発生個所を切り分ける方法のほかに，サービスリクエスタ側で設定したクライアント相関IDや，ビジネスプロセスの相関セットを基に問題発生個所を特定する方法があります。サービス部品呼び出し要求の実行履歴の追跡を次の図に示します。

図7‒65　サービス部品呼び出し要求の実行履歴の追跡（SessionBeanの場合）

特定方法やビジネスプロセスを使用する場合の手順については，Webサービス（SOAP通信）の場合の手順と同様です。詳細については，「7.7.1　Webサービス（SOAP通信）実行時の障害対策」を参照してください。

ここでは，SessionBeanの場合にだけ該当する手順について説明します。

(a)　サービスリクエスタから指定したクライアント相関IDからたどる方法

サービスリクエスタから指定したクライアント相関IDからたどる手順を次に示します。

クライアント相関IDを調査します。

メッセージ共通IDを取得します。

ビジネスプロセスのプロセスIDを取得します。

アクティビティの状態を取得します。

ユーザ電文を確認します。

詳細については，「7.7.1　Webサービス（SOAP通信）実行時の障害対策」を参照してください。

性能解析トレースを使ってさらに調査し，問題が発生した個所をより細かく特定できます。また，性能解析トレースのスレッドIDをたどることで，サービス部品稼働マシンのログとの対応を次のように確認できます。

メッセージ共通IDと一致する文字列を含む行を検索します。

HCSCサーバのリクエスト受付の入口で「ASCII」列に出力されているため，そこが最初に検索されます。

検索で一致した行のスレッドIDを確認して，そのスレッドIDをたどってエラー発生個所を調査します。

RMI-IIOP呼び出しによってスレッドIDが変化しますが，「Root AP CommonNo」列によってつながりがわかります。

「Rc（リターンコード）」列の値が0以外の個所がエラー個所です。エラー個所が見つかったらその前後の処理内容を確認して原因を調査します。

さらに調べたい場合は，J2EEサーバが出力する障害情報のログを使って，エラー発生個所のスレッドIDをたどります。

性能解析トレースの例を次に示します。

図7‒66　性能解析トレースの例

「図7-66　性能解析トレースの例」の図中の番号は次の内容を示します。

(1)メッセージ共通IDと一致する文字列を含む行です。共通のIDが与えられているためつながりがわかります。

(2)RMI呼び出しで複数のスレッドにわたるため，番号が変化しています。

(3)検索で一致したスレッド番号です。

(4)スレッド番号（項番3）のスレッドIDです。

(5)標準受付（SessionBean）の入口です。

(6)ビジネスプロセスの呼び出し口です。

(7)メッセージング基盤からのビジネスプロセス実行要求呼び出しです。

(8)データ変換要求の呼び出しです。

(9)データ変換要求からの応答です。

(10)メッセージング基盤へのビジネスプロセスからのサービス部品要求の呼び出しです。

(11)ビジネスプロセス受付の入口です。

(12)SessionBeanアダプタのサービス部品呼び出し口です。

(13)HCSCサーバ稼働マシンからサービス部品稼働マシンの呼び出しです。

(14)EJBコンテナリクエスト直後です。

(15)EJBコンテナレスポンス直前です。

(16)エラーが発生しています。

この例では，「図7-66　性能解析トレースの例」で示した(13)で，サービス部品のRMIを呼び出し，そのあとEJBコンテナがリクエストを受信した直後にエラーが発生していることがわかります（性能解析トレースの採取レベルは「通常」と「詳細」の2つありますが，「図7-66　性能解析トレースの例」は「通常」で採取した場合のトレースです）。

サービス部品稼働マシンがApplication Serverを使用している場合は，エラーが起きた個所のスレッドIDとサービス部品稼働マシン側の障害情報を突き合わせることで，さらに調査できます。

なお，性能解析トレースのスレッドIDは10進数ですが，J2EEサーバが出力する障害情報は16進数表現なので，個別にスレッドIDを16進数に直す必要があるため注意してください。

サービスアダプタからのサービス部品呼び出しについては，SessionBeanの呼び出しによってスレッドIDが変化しますが，Root AP CommonNo列によってつながりがわかります。性能解析トレースファイルの利用方法の詳細については，次に示すマニュアルを参照してください。

推奨モードの場合

マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.7　性能解析トレースファイルを使用した処理性能の解析作業」

V9互換モードの場合

マニュアル「アプリケーションサーバ 機能解説 互換編」の「14.3　性能解析トレースファイルの出力情報（性能解析トレースの場合）」

(b)　ユーザ電文に指定したビジネスプロセスの相関セットからたどる方法

ユーザ電文に指定したビジネスプロセスの相関セットからたどる手順を次に示します。

相関セットを調査します。

ビジネスプロセスのプロセスIDを取得します。

アクティビティの状態を取得します。

詳細については，「7.7.1　Webサービス（SOAP通信）実行時の障害対策」を参照してください。

7.7.3　MDB（WS-R）実行時の障害対策

(1)　MDB（WS-R）でのエラーの伝わり方

MDB（WS-R）でのサービス部品呼び出しでは，サービスリクエスタとHCSCサーバの間，HCSCサーバとサービス部品の間でエラーは伝わりません。検知できる障害の種類と，ログおよびトレースの出力先を説明します。

サービス部品でユーザ定義例外のエラーが発生した場合

サービス部品でユーザ定義例外のエラーが発生した場合のMDB（WS-R）でのエラーの伝わり方を次の図に示します。

図7‒67　サービス部品でユーザ定義例外のエラーが発生した場合のMDB（WS-R）でのエラーの伝わり方

サービス部品で発生した例外は，サービス部品稼働マシン上のReliable Messagingでエラー処理します。サービス部品稼働マシン上のReliable Messagingはローカルキューからメッセージの取り出しに失敗したことを示すメッセージをサービス部品稼働マシン上のログに出力します。

なお，ユーザ定義例外（アプリケーション例外）の場合，ロールバックして再度サービス部品でメッセージを取り出すかどうかは，サービス部品稼働マシン側のReliable Messagingの設定やサービス部品プログラムの作成に依存します。

サービス部品稼働マシン上のメッセージの取り出しでロールバックして，ロールバックの回数（メッセージの配送回数）が最大値に達した場合や，メッセージが有効期限に達した場合，そのメッセージはデッドメッセージキューに移動します。ただし，次の場合はメッセージが削除されます。

デッドメッセージキューの設定をしていない場合

配送回数に無制限の設定をしている場合

デッドメッセージキューのメッセージ数が超過した場合

データベースに障害が発生した場合

Reliable Messagingの詳細については，マニュアル「Reliable Messaging」を参照してください。

サービス部品でユーザ定義例外以外のエラーが発生した場合

サービス部品でユーザ定義例外以外のエラーが発生した場合のMDB（WS-R）でのエラーの伝わり方を次の図に示します。

図7‒68　サービス部品でユーザ定義例外以外のエラーが発生した場合のMDB（WS-R）でのエラーの伝わり方

サービス部品で発生した例外は，サービス部品稼働マシン上のReliable Messagingでエラー処理します。Reliable Messagingはローカルキューからメッセージの取り出しに失敗したことを示すメッセージをサービス部品稼働マシン上のログに出力します。

なお，システム例外の場合，サービス部品側でロールバックして，再度サービス部品でメッセージの取り出しを試みます。

サービス部品稼働マシン上のメッセージの取り出しでロールバックして，ロールバックの回数（メッセージの配送回数）が最大値に達した場合や，メッセージが有効期限に達した場合，そのメッセージはデッドメッセージキューに移動します。ただし，次の場合はメッセージが削除されます。

デッドメッセージキューの設定をしていない場合

配送回数に無制限の設定をしている場合

デッドメッセージキューのメッセージ数が超過した場合

データベースに障害が発生した場合

Reliable Messagingの詳細については，マニュアル「Reliable Messaging」を参照してください。

HCSCサーバ稼働マシンからサービス部品稼働マシンへの転送でエラーが発生した場合

HCSCサーバ稼働マシンからサービス部品稼働マシンへの転送でエラーが発生した場合のMDB（WS-R）でのエラーの伝わり方を次の図に示します。

図7‒69　HCSCサーバ稼働マシンからサービス部品稼働マシンへの転送でエラーが発生した場合のMDB（WS-R）でのエラーの伝わり方

HCSCサーバ稼働マシンからサービス部品稼働マシンへのメッセージの転送に失敗した場合，HCSCサーバ側のReliable Messagingでエラー処理をします。Reliable Messagingはメッセージの転送に失敗したことを示すメッセージをHCSCサーバ稼働マシン上のログに出力します。

なお，メッセージの転送でエラーを検知した場合，HCSCサーバ側でロールバックして再度転送を試みます。

HCSCサーバ稼働マシンからの転送でロールバックして，ロールバックの回数（メッセージの配送回数）が最大値に達した場合や，配送回数に無制限の設定をしている場合，そのメッセージはデッドメッセージキューに移動します。デッドメッセージキュー名を設定していない場合やデッドメッセージキューを作成していない場合は，無限にサービス部品を呼び出す処理が再実行されるため，必ずデッドメッセージキュー名やデッドメッセージキューを設定してください。

Reliable Messagingのセットアップについては，「3.1.2　実行環境に必要なソフトウェアを設定する」を参照してください。Reliable Messagingのキュー間転送の障害時の動作の詳細については，マニュアル「Reliable Messaging」の「2.4.7　キュー間転送の障害時の動作」を参照してください。

HCSCサーバからエラーが発生した場合

HCSCサーバからエラーが発生した場合のMDB（WS-R）でのエラーの伝わり方を次の図に示します。

図7‒70　HCSCサーバからエラーが発生した場合のMDB（WS-R）でのエラーの伝わり方

図中の各エラーには，次に示すケースが該当します。

エラー1：要求パラメタ不正など

エラー2：宛先（ロケーション）が見つからない，サービスアダプタが停止しているなど

エラー3：データ変換に失敗したなど

エラー4：メッセージ送信失敗など

HCSCサーバで図中のエラー1〜エラー3のどれかを検知した場合，HCSCサーバ稼働マシン上のReliable Messagingでエラー処理します。図中のエラー4を検知した場合，発生したエラーの例外を標準受付にそのままスローするか，サービスアダプタでエラーの例外をフォルト電文に変換するか選択できます。例外発生時に取得するエラーの選択方法については，「7.11　サービスアダプタでの例外発生時の運用」を参照してください。

発生したエラーのメッセージをメッセージログに出力します。また，Reliable Messagingはローカルキューからメッセージの取り出しに失敗したことを示すメッセージをHCSCサーバ稼働マシン上のログに出力します。

なお，HCSCサーバでエラーを検知した場合，HCSCサーバ側でロールバックをして，再度サービス部品でメッセージの取り出し（サービス部品呼び出し）を試みます。HCSCサーバ稼働マシン上のメッセージの取り出しでロールバックして，ロールバックの回数（メッセージの配送回数）が最大値に達した場合，そのメッセージはデッドメッセージキューに移動します。デッドメッセージキュー名を設定していない場合やデッドメッセージキューを作成していない場合は，無限にサービス部品を呼び出す処理が再実行されるため，必ずデッドメッセージキュー名やデッドメッセージキューを設定してください。

Reliable Messagingのセットアップについては，「3.1.2　実行環境に必要なソフトウェアを設定する」を参照してください。

Reliable Messagingの詳細については，マニュアル「Reliable Messaging」を参照してください。

サービスリクエスタ稼働マシンからHCSCサーバ稼働マシンへの転送でエラーが発生した場合

サービスリクエスタ稼働マシンからHCSCサーバ稼働マシンへの転送でエラーが発生した場合のMDB（WS-R）でのエラーの伝わり方を次の図に示します。

図7‒71　サービスリクエスタ稼働マシンからHCSCサーバ稼働マシンへの転送でエラーが発生した場合のMDB（WS-R）でのエラーの伝わり方

サービスリクエスタ稼働マシンからHCSCサーバ稼働マシンへのメッセージの転送に失敗した場合，サービスリクエスタ側のReliable Messagingでエラー処理します。Reliable Messagingはメッセージの転送に失敗したことを示すメッセージをサービスリクエスタ稼働マシン上のログに出力します。

なお，メッセージの転送でエラーを検知した場合，サービスリクエスタ側でロールバックして，再度転送を試みます。

サービスリクエスタ稼働マシンからの転送でロールバックして，ロールバックの回数（メッセージの配送回数）が最大値に達した場合や，メッセージが有効期限に達した場合，そのメッセージはデッドメッセージキューに移動します。ただし，次の場合は，メッセージは削除されます。

デッドメッセージキューの設定をしていない場合

配送回数に無制限の設定をしている場合

デッドメッセージキューのメッセージ数が超過した場合

データベースに障害が発生した場合

Reliable Messagingのキュー間転送の障害時の動作の詳細については，マニュアル「Reliable Messaging」の「2.4.7　キュー間転送の障害時の動作」を参照してください。

サービスリクエスタでエラーを検知した場合

サービスリクエスタでエラーを検知した場合のMDB（WS-R）でのエラーの伝わり方を次の図に示します。

図7‒72　サービスリクエスタでエラーを検知した場合のMDB（WS-R）でのエラーの伝わり方

サービスリクエスタから転送キューへメッセージの送信ができなかった場合，サービスリクエスタへ例外（JMSException）がスローされます。サービスリクエスタは，例外をキャッチし，キャッチした例外オブジェクトのgetterを使用することで，発生したエラーの詳細を取得できます。サービスリクエスタ稼働マシンからのメッセージ送信失敗の場合は，デッドメッセージキューに移動しません。Reliable MessagingおよびJMSの詳細については，マニュアル「Reliable Messaging」を参照してください。

同期のサービス部品を呼び出してユーザ定義例外のエラーが発生した場合

同期のサービス部品を呼び出してユーザ定義例外のエラーが発生した場合のMDB（WS-R）でのエラーの伝わり方を次の図に示します。

図7‒73　同期のサービス部品を呼び出してユーザ定義例外のエラーが発生した場合のMDB（WS-R）でのエラーの伝わり方

非同期（MDB（WS-R））の標準受付に対してサービス部品を呼び出すときに応答用のキューを指定して，非同期（MDB（WS-R））の標準受付から同期のSOAPアダプタのサービス部品を呼び出します。このとき，サービス部品側でユーザ定義例外が発生すると，エラー情報のメッセージが応答用のキュー（転送キュー）に送信されます。

転送キューの送信先をサービスリクエスタ側のローカルキューに指定しておくと，そこからメッセージを取り出すことで，エラーの内容を取得できます。

応答用のキュー（転送キュー）はあらかじめ作成して準備しておく必要がありますが，応答用のキューの設定をしていない場合や，応答用のキューのメッセージ数が超過し，応答用のキューへの送信が失敗した場合，HCSCサーバ内で処理がロールバックし，標準受付のローカルキューからメッセージが再送されます（サービス部品側の処理（トランザクション）はロールバックしません）。

ロールバックの回数（メッセージの配送回数）が最大値に達した場合，そのメッセージはデッドメッセージキューに移動します。デッドメッセージキュー名を設定していない場合，およびデッドメッセージキューを作成していない場合，無限にサービス部品を呼び出す処理が再実行されるため，必ずデッドメッセージキュー名やデッドメッセージキューを設定してください。

(2)　問題発生個所の切り分け方

サービスリクエスタから標準受付（MDB（WS-R））を使用して，サービス部品を呼び出した場合の問題発生個所の切り分け方について説明します。切り分け方を次の図に示します。

図7‒74　問題発生個所の切り分け方（サービス部品を呼び出した場合）

(i)サービス部品稼働マシンでのエラーの場合

サービス部品稼働マシン側のReliable Messagingが出力する障害情報を参照して，障害を調査します。サービス部品のプログラムでエラー情報を出力している場合は，J2EEサーバのユーザログを参照します。

要因は，次の観点で調査してください。

サービスリクエスタから要求したユーザ電文

サービス部品稼働マシン

サービス部品稼働マシンのReliable Messagingの設定

サービス部品のプログラム

(ii)HCSCサーバ稼働マシンでのエラーの場合

HCSCサーバ稼働マシン側のメッセージログ，またはHCSCサーバ稼働マシン側のReliable Messagingが出力する障害情報を参照して，障害を調査します。

要因は，次の観点で調査してください。

サービスリクエスタから要求した引数の内容

HCSCサーバの設定または状態

HCSCサーバのReliable Messagingの設定

サービスアダプタの定義内容

ビジネスプロセスの定義内容

サービスリクエスタから要求したユーザ電文

ネットワークの状態

(iii)サービスリクエスタ稼働マシンでのエラーの場合

サービスリクエスタがキャッチした例外からエラーの内容を取得できます。取得した例外のエラー情報を基に対処します。または，サービスリクエスタ稼働マシン側のReliable Messagingが出力する障害情報を参照して，障害を調査します。

要因は，次の観点で調査してください。

サービスリクエスタ稼働マシンのJ2EEコンテナの設定または状態

サービスリクエスタ稼働マシンのReliable Messagingの設定

ネットワークの状態

(3)　そのほかの障害要因の特定方法（サービス部品呼び出し要求の実行履歴の追跡）

サービスリクエスタから指定した情報や，HCSCサーバからの情報を基に，サービス部品呼び出しの処理がどこまで進んだか実行履歴を追跡できます。ここでは，実行履歴を追跡するために必要な情報（ID）について説明します。

(a)　クライアント相関ID

クライアント相関IDは，サービス部品呼び出しを要求するサービスリクエスタ側のプログラムで，要求時に設定する情報です。サービスリクエスタからの要求電文と，HCSCサーバで管理しているログおよびトレースとを対応づけるために使用します。そのため，HCSCサーバに送信した要求ごとに異なるIDを指定することを推奨します。IDはサービスリクエスタ開発時に指定します。クライアント相関IDが引き継がれる範囲を次の図に示します。

図7‒75　クライアント相関IDが引き継がれる範囲（MDB（WS-R）実行時）

(b)　メッセージ共通ID

HCSCサーバが付与するIDです。HCSCサーバ内のログやトレースを識別するために使用します。メッセージ共通IDが引き継がれる範囲を次の図に示します。

図7‒76　メッセージ共通IDが引き継がれる範囲（MDB（WS-R）実行時）

(c)　JMSMessageID

Reliable Messagingが付与するIDです。HCSCサーバ内のログやトレースに出力します。JMSMessageIDが引き継がれる範囲を次の図に示します。

図7‒77　JMSMessageIDが引き継がれる範囲（MDB（WS-R）実行時）

(d)　JMSCorrelationIDおよびユーザ固有のJMSプロパティ

サービス部品の呼び出し要求時に，サービスリクエスタにJMSCorrelationIDおよびユーザ固有のJMSプロパティを設定すると，その値がサービス部品側のキューまで引き継がれます。サービス部品側のプログラムで取得することで，メッセージを一意に関連づけられます。JMSCorrelationIDおよびユーザ固有のJMSプロパティが引き継がれる範囲を次の図に示します。

図7‒78　JMSCorrelationIDおよびユーザ固有のJMSプロパティが引き継がれる範囲（MDB（WS-R）実行時）

(e)　スレッドID

J2EEコンテナによって処理するスレッドごとに与えられるIDです。スレッドIDが引き継がれる範囲を次の図に示します。

図7‒79　スレッドIDが引き継がれる範囲（MDB（WS-R）実行時）

7.7.4　MDB（DBキュー）実行時の障害対策

(1)　MDB（DBキュー）でのエラーの伝わり方

MDB（DBキュー）でのサービス部品呼び出しでは，サービスリクエスタとHCSCサーバの間，HCSCサーバとサービス部品の間でエラーは伝わりません。検知できる障害の種類と，ログおよびトレースの出力先を次に説明します。

なお，非同期の標準受付（MDB（DBキュー））からMDB（DBキュー）アダプタへのサービス部品呼び出しはできません。そのため，サービス部品側がDBキューの場合，またはサービスリクエスタ側がDBキューの場合とに分けて説明します。

(a)　DBキューがサービス部品側にある場合

サービス部品でエラーが発生した場合

サービス部品で発生したエラーは，HCSCサーバおよびサービスリクエスタへエラー情報として伝わりません。エラーの情報はサービス部品稼働マシン側に出力されます。サービス部品でエラーが発生した場合のエラーの伝わり方を次の図に示します。

図7‒80　サービス部品でエラーが発生した場合のエラーの伝わり方

(b)　DBキューがサービスリクエスタ側にある場合

HCSCサーバからエラーが発生した場合

HCSCサーバからエラーが発生した場合のエラーの伝わり方を次の図に示します。

図7‒81　HCSCサーバからエラーが発生した場合のエラーの伝わり方

図中の各エラーには，次に示すケースが該当します。

エラー1：要求パラメタ不正など

エラー2：宛先（ロケーション）が見つからない，サービスアダプタが停止しているなど

エラー3：データ変換に失敗したなど

エラー4：メッセージ送信失敗など

HCSCサーバで図中のエラー1〜エラー3のどれかを検知した場合，HCSCサーバ稼働マシン上のReliable Messagingにエラーを伝えます。

図中のエラー4を検知した場合，HCSCサーバ稼働マシン上のReliable Messagingにエラーを伝えるか，サービスアダプタでエラーの例外をフォルト電文に変換するか選択できます。例外発生時に取得するエラーの選択方法については，「7.11　サービスアダプタでの例外発生時の運用」を参照してください。

発生したエラーのメッセージをメッセージログに出力します。また，Reliable Messagingは，ローカルキューからメッセージの取り出しに失敗したことを示すメッセージをHCSCサーバ稼働マシン上のログに出力します。

なお，HCSCサーバでエラーを検知した場合，HCSCサーバ側でロールバックして再度サービス部品でメッセージの取り出し（サービス部品呼び出し）を試みます。

HCSCサーバ稼働マシン上のメッセージの取り出しでロールバックして，ロールバックの回数（メッセージの配送回数）が最大値に達した場合，そのメッセージはデッドメッセージキューに移動します。デッドメッセージキュー名を設定していない場合，およびデッドメッセージキューを作成していない場合は，無限にメッセージの取り出しとトランザクションのロールバック処理が再実行されるため，必ずデッドメッセージキュー名やデッドメッセージキューを設定してください。なお，処理の再実行がHCSCサーバランタイム定義ファイルのrequest-jms.rollback-countプロパティに指定した回数を超えた場合，警告メッセージ（KDEC00049-W）が出力されます。

Reliable Messagingのセットアップについては，「3.1.2　実行環境に必要なソフトウェアを設定する」を参照してください。Reliable Messagingの詳細については，マニュアル「Reliable Messaging」を参照してください。

サービスリクエスタでエラーを検知した場合

サービスリクエスタでエラーを検知した場合のエラーの伝わり方を次の図に示します。

図7‒82　サービスリクエスタでエラーを検知した場合のエラーの伝わり方

サービスリクエスタがDBキューにメッセージをキューイングしたときに発生したエラーは，サービスリクエスタ稼働マシン側に出力されます。

同期のサービス部品を呼び出してユーザ定義例外のエラーが発生した場合

同期のサービス部品を呼び出してユーザ定義例外のエラーが発生した場合のエラーの伝わり方を次の図に示します。

図7‒83　同期のサービス部品を呼び出してユーザ定義例外のエラーが発生した場合のエラーの伝わり方

非同期（MDB（DBキュー））の標準受付に対してサービス部品を呼び出すときに応答用のキューを指定して，非同期（MDB（DBキュー））の標準受付から同期のSOAPアダプタのサービス部品を呼び出します。このとき，サービス部品側でユーザ定義例外が発生すると，エラー情報のメッセージが応答用のキュー（送信用共用キュー）に送信されます。送信用共用キューの送信先をサービスリクエスタ側のDBキューに指定しておくと，そこからメッセージを取り出すことで，エラーの内容を取得できます。

応答用のキュー（送信用共用キュー）はあらかじめ作成して準備しておく必要があります。応答用のキューの設定をしていない場合や，応答用のキューのメッセージ数が超過し，応答用のキューへの送信が失敗した場合，HCSCサーバ内で処理がロールバックして，標準受付の受信用共用キューからメッセージが再送されます（ただし，サービス部品側の処理（トランザクション）はロールバックしません）。さらに，ロールバックの回数（メッセージの配送回数）が最大値に達したメッセージはデッドメッセージキューに移動するため，事前に必ずデッドメッセージキュー名の設定とデッドメッセージキューの作成を実施してください。デッドメッセージキュー名を設定していない場合，およびデッドメッセージキューを作成していない場合は，無限にサービス部品を呼び出す処理が再実行されます。

(2)　問題発生個所の切り分け方

サービスリクエスタから標準受付（MDB（DBキュー））を使用して，サービス部品を呼び出した場合の問題発生個所の切り分け方について説明します。問題発生個所の切り分けの流れを次の図に示します。

図7‒84　問題発生個所の切り分けの流れ（サービスリクエスタから標準受付（MDB（DBキュー））を使用して，サービス部品を呼び出した場合）

(i)サービス部品稼働マシンでのエラーの場合

サービス部品稼働マシン側に出力する障害情報から，障害を調査します。

要因は，次の観点で調査してください。

サービスリクエスタから要求したユーザ電文

サービス部品稼働マシンの状態

サービス部品稼働マシンの設定

サービス部品のプログラム

(ii)HCSCサーバ稼働マシンでのエラーの場合

HCSCサーバ稼働マシン側のメッセージログ，またはHCSCサーバ稼働マシン側のReliable Messagingが出力する障害情報を参照して，障害を調査します。

要因は，次の観点で調査してください。

サービスリクエスタから要求したバイナリデータの内容

サービスリクエスタから要求したバイナリデータの形式

HCSCサーバの設定または状態

HCSCサーバのReliable Messagingの設定

サービスアダプタの定義内容

ビジネスプロセスの定義内容

サービスリクエスタから要求したユーザ電文

ネットワークの状態

(iii)サービスリクエスタ稼働マシンでのエラーの場合

サービスリクエスタ稼働マシン側に出力する障害情報から，障害を調査します。

要因は，次の観点で調査してください。

サービスリクエスタから要求したユーザ電文

サービスリクエスタ稼働マシンの状態

サービスリクエスタ稼働マシンの設定

サービスリクエスタのプログラム

(3)　そのほかの障害要因の特定方法（サービス部品呼び出し要求の実行履歴の追跡）

サービスリクエスタから指定した情報や，HCSCサーバからの情報を基に，サービス部品呼び出しの処理がどこまで進んだか実行履歴を追跡できます。ここでは，実行履歴を追跡するために必要な情報（ID）について説明します。

(a)　クライアント相関ID

クライアント相関IDは，サービス部品呼び出し要求を行うサービスリクエスタ側のプログラムで，要求時に設定する情報です。サービスリクエスタからの要求電文と，HCSCサーバで管理しているログおよびトレースとを対応づけるために使用します。そのため，HCSCサーバに送信した要求ごとに異なるIDを指定することを推奨します（サービスリクエスタ作成時に指定が必要です）。クライアント相関IDが引き継がれる範囲を次の図に示します。

図7‒85　クライアント相関IDが引き継がれる範囲（MDB（DBキュー）実行時）

(b)　メッセージ共通ID

HCSCサーバが付与するIDです。HCSCサーバ内のログやトレースを識別するために使用します。メッセージ共通IDが引き継がれる範囲を次の図に示します。

図7‒86　メッセージ共通IDが引き継がれる範囲（MDB（DBキュー）実行時）

(c)　JMSMessageID

Reliable Messagingが付与するIDです。HCSCサーバ内のログやトレースに出力します。JMSMessageIDが引き継がれる範囲を次の図に示します。

図7‒87　JMSMessageIDが引き継がれる範囲（MDB（DBキュー）実行時）

注　JMSCorrelationIDやユーザ固有のプロパティなどの情報は引き継がれません。

(d)　スレッドID

J2EEコンテナによって処理するスレッドごとに与えられるIDです。スレッドIDが引き継がれる範囲を次の図に示します。

図7‒88　スレッドIDが引き継がれる範囲（MDB（DBキュー）実行時）

注

サービス部品側のプログラムと関連づける場合は，ユーザ電文に関連づけのための情報を埋め込む必要があります。

7.7.5　TP1/RPC受付実行時の障害対策

この項では，TP1/RPC受付実行時に発生する障害に対して取得できる情報の種類，および障害の対処方法などについて説明します。

(1)　TP1/RPC受付実行時に発生したエラーの伝わり方

エラーの伝わり方は，エラーの種類によって異なります。

ここでは，次の場合についてエラーの伝わり方を説明します。

サービス部品からユーザ定義例外のエラーがリターンした場合（ビジネスプロセスを使用するとき）

サービス部品からユーザ定義例外以外のエラーがリターンした場合（ビジネスプロセスを使用するとき）

HCSCサーバからエラーがリターンした場合（ビジネスプロセスを使用するとき）

TP1インバウンドアダプタでエラーを検知した場合

(a)　サービス部品からユーザ定義例外のエラーがリターンした場合（ビジネスプロセスを使用するとき）

フォルト処理で障害情報をサービス電文にデータ変換しない場合

サービス部品からユーザ定義例外のエラーがリターンした場合（ビジネスプロセスを使用するとき）のTP1/RPC受付でのエラーの伝わり方（フォルト処理なし）を次の図に示します。

図7‒89　サービス部品からユーザ定義例外のエラーがリターンした場合（ビジネスプロセスを使用するとき）のTP1/RPC受付でのエラーの伝わり方（フォルト処理なし）

サービス部品で発生した例外は，CSCMsgServerExceptionとしてTP1/RPC受付に伝わります。その例外をキャッチしたTP1/RPC受付は，実行時例外をTP1インバウンドアダプタに再スローします。その後，TP1インバウンドアダプタ経由で，サービスリクエスタには，サービス要求のリターン値としてDCRPCER_SYSERR_AT_SERVER(-316)が返ります。

フォルト処理で障害情報をサービス電文にデータ変換する場合

サービス部品からユーザ定義例外のエラーがリターンした場合（ビジネスプロセスを使用するとき）のTP1/RPC受付でのエラーの伝わり方（フォルト処理あり）を次の図に示します。

図7‒90　サービス部品からユーザ定義例外のエラーがリターンした場合（ビジネスプロセスを使用するとき）のTP1/RPC受付でのエラーの伝わり方（フォルト処理あり）

サービス部品で発生した例外は，そのまま例外としてビジネスプロセスのフォルト処理に伝わります。その後，ビジネスプロセスのフォルト処理でその障害情報を応答電文にデータ変換し，障害情報を含んだ応答電文として，以降の処理に返します。この場合，メッセージ配送制御を経由して，TP1/RPC受付に応答電文が返ります。TP1/RPC受付は，通常の応答電文と同様，その応答電文をTP1インバウンドアダプタに返します。サービスリクエスタには，通常の処理と同様，サービス要求の引数に，応答電文が設定されて返ります。

(b)　サービス部品からユーザ定義例外以外のエラーがリターンした場合（ビジネスプロセスを使用するとき）

フォルト処理で障害情報をサービス電文にデータ変換しない場合

サービス部品からユーザ定義例外以外のエラーがリターンした場合（ビジネスプロセスを使用するとき）のTP1/RPC受付でのエラーの伝わり方（フォルト処理なし）を次の図に示します。

図7‒91　サービス部品からユーザ定義例外以外のエラーがリターンした場合（ビジネスプロセスを使用するとき）のTP1/RPC受付でのエラーの伝わり方（フォルト処理なし）

サービス部品で想定外の例外が発生した場合，RuntimeException（システム例外）としてTP1/RPC受付に伝わります。その例外をキャッチしたTP1/RPC受付は，キャッチしたRuntimeException（システム例外）を，そのままTP1インバウンドアダプタに再スローします。その後，TP1インバウンドアダプタ経由で，サービスリクエスタには，サービス要求のリターン値としてDCRPCER_SYSERR_AT_SERVER(-316)が返ります。

フォルト処理で障害情報をサービス電文にデータ変換する場合

サービス部品からユーザ定義例外以外のエラーがリターンした場合（ビジネスプロセスを使用するとき）のTP1/RPC受付でのエラーの伝わり方（フォルト処理あり）を次の図に示します。

図7‒92　サービス部品からユーザ定義例外以外のエラーがリターンした場合（ビジネスプロセスを使用するとき）のTP1/RPC受付でのエラーの伝わり方（フォルト処理あり）

サービス部品で発生した例外は，そのまま例外としてビジネスプロセスのフォルト処理に伝わります。その後，ビジネスプロセスのフォルト処理でその障害情報を応答電文にデータ変換し，障害情報を含んだ応答電文として，以降の処理に返します。この場合，メッセージ配送制御を経由して，TP1/RPC受付に応答電文が返ります。TP1/RPC受付は，通常の応答電文と同様，その応答電文をTP1インバウンドアダプタに返します。サービスリクエスタには，通常の処理と同様，サービス要求の引数に，応答電文が設定されて返ります。

(c)　HCSCサーバからエラーがリターンした場合（ビジネスプロセスを使用するとき）

HCSCサーバからエラーがリターンした場合（ビジネスプロセスを使用するとき）のTP1/RPC受付でのエラーの伝わり方を次の図に示します。

図7‒93　HCSCサーバからエラーがリターンした場合（ビジネスプロセスを使用するとき）のTP1/RPC受付でのエラーの伝わり方

図中の各エラーには，次に示すケースが該当します。

エラー1：要求パラメタ不正など

エラー2：宛先（ロケーション）が見つからない，サービスアダプタが停止しているなど

エラー3：データ変換に失敗したなど

エラー4：宛先不正，サービス部品が停止，通信障害など

エラー5：ビジネスプロセス処理上での例外エラーなど

HCSCサーバで図中のエラー1〜エラー5のどれかを検知した場合，発生したエラーの情報をCSCMsgServerExceptionで，TP1/RPC受付にスローします。その例外をキャッチしたTP1/RPC受付は，実行時例外をTP1インバウンドアダプタに再スローします。その後，TP1インバウンドアダプタ経由で，サービスリクエスタには，サービス要求のリターン値としてDCRPCER_SYSERR_AT_SERVER(-316)が返ります。

(d)　TP1インバウンドアダプタでエラーを検知した場合

TP1インバウンドアダプタでエラーを検知した場合のTP1/RPC受付でのエラーの伝わり方を次の図に示します。

図7‒94　TP1インバウンドアダプタでエラーを検知した場合のTP1/RPC受付でのエラーの伝わり方

TP1インバウンドアダプタでエラーが発生した場合，サービスリクエスタには，サービス要求のリターン値として0以外の値が返ります。

詳細は，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「4.17　TP1インバウンドアダプタで発生するRPCエラー応答」を参照してください。

(2)　障害情報の取得（TP1/RPC受付）

運用時に障害が発生した場合，障害対策に必要な情報は，ログファイルにログとして出力され，トレースファイルにトレースとして出力されます。

ここでは，メッセージログおよび各種トレースの取得方法について説明します。

(a)　メッセージログ（TP1/RPC受付）

メッセージログは，次に示すログに出力されます。

HCSC-Managerのログ

統合メッセージログ

J2EEサーバの稼働ログ

メッセージログの取得方法および出力先については，「7.4.1　メッセージログ」を参照してください。また，メッセージログの詳細は，マニュアル「サービスプラットフォーム メッセージ」の「2.　メッセージ一覧」を参照してください。

(b)　リクエストトレース（TP1/RPC受付）

リクエストトレースは，リクエストの障害要因の解析に使用します。

リクエストトレースの詳細は，マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「付録A.8　障害情報の取得（カスタム受付）」のリクエストトレース（カスタム受付）に関する説明を参照してください。

(c)　性能解析トレース（TP1/RPC受付）

性能解析トレース（PRFトレース）は，サービスプラットフォームシステムの性能解析をするためのトレース情報で，それをCSV形式で編集出力したテキストファイルが性能解析トレースファイルです。性能解析トレースは，J2EEアプリケーションを含めた，システム全体の性能ボトルネックを解析するための情報が出力されます。システムの性能ネックや性能トラブルシュートに使用します。性能解析トレース機能については，マニュアル「アプリケーションサーバ機能解説 保守／移行編」の「7.　性能解析トレースを使用した性能解析」を参照してください。

性能解析トレースの取得ポイント

性能解析トレースの取得ポイントを次の図に示します。

図7‒95　性能解析トレースの取得ポイント（TP1/RPC受付）

イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。なお，次の表の「図中の番号」は，図中の番号と対応しています。

表7‒79　性能解析トレースの取得ポイント（TP1/RPC受付）

イベントID

図中の番号

トレース取得ポイント

レベル

0x9860

1

カスタム受付フレームワークの入口

A

0x9861

2

カスタム受付フレームワークの出口

A

0x9862

3

データ変換（要求電文）の呼び出し口

B

0x9863

4

データ変換（要求電文）の応答受信口

B

0x9864

5

メッセージ配送制御の呼び出し口

A

0x9865

6

メッセージ配送制御の応答受信口

A

0x9866

7

データ変換（応答電文）の呼び出し口

B

0x9867

8

データ変換（応答電文）の応答受信口

B

0x9868

9

カスタム受付の入口

A

0x9869

10

カスタム受付の出口

A

0x986A

11

カスタム受付フレームワークの呼び出し口

B

0x986B

12

カスタム受付フレームワークの応答受信口

B

（凡例）

A：標準であることを示します。

B：詳細であることを示します。

性能解析トレースファイルの出力形式と出力内容

出力形式

性能解析トレースファイルに出力される形式は，J2EEサーバの性能解析トレースと同様です。性能解析トレースファイルの詳細は，マニュアル「アプリケーションサーバ 機能解説保守／移行編」の「7.　性能解析トレースを使用した性能解析」を参照してください。

出力内容

性能解析トレースファイルの出力内容を次の表に示します。

表7‒80　性能解析トレースファイルに出力される内容

項目

内容

イベントID

各取得ポイントのイベントIDが出力されます。

リターンコード

取得ポイント種別が出力されます。

0：正常終了

1：異常終了

インターフェース名

クラス名が出力されます。

オペレーション名

メソッド名が出力されます。

オプション情報

次のオプション情報が出力されます。

受付名

受付ID

クライアント相関ID

サービス名

サービスオペレーション名

例外名※

注※

障害が発生したときだけ出力されます。

性能解析トレースの取得方法と出力先

性能解析トレースファイルの取得方法および出力先は，アプリケーションサーバおよびサービスプラットフォーム全体で共通です。取得方法および出力先については，マニュアル「アプリケーションサーバ機能解説 保守／移行編」の「7.　性能解析トレースを使用した性能解析」を参照してください。

(d)　ユーザ電文トレース（TP1/RPC受付）

ユーザ電文トレースは，電文の状態を確認するために使用します。

次の内容をユーザ電文トレースとして取得できます。

TP1インバウンドアダプタ経由で受け付けたサービス部品呼び出し要求または応答の電文

ビジネスプロセスを呼び出したときの要求または応答の電文

サービスアダプタからサービス部品を呼び出したときの要求または応答の電文

データ変換を実行したときの変換前または変換後の電文

ユーザ電文トレースの詳細は，マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「付録A.8　障害情報の取得（カスタム受付）」を参照してください。

(3)　問題発生個所の切り分け方

ここでは，サービスリクエスタからTP1/RPC受付を使用してサービス部品を呼び出した場合の問題発生個所の切り分け方について説明します。

問題発生個所の切り分け方を次の図に示します。

図7‒96　問題発生個所の切り分け方

図中の(a)〜(d)について，調査する内容を次に示します。

(a)　サービス部品に障害の要因がある場合

サービス部品に障害の要因がある場合，実行環境のメッセージログを参照し，サービス部品が返した例外の内容を確認します。

要因は，次の観点で調査してください。

サービスリクエスタから要求したユーザ電文

サービス部品稼働マシン

サービス部品のプログラム

サービス部品呼び出し要求を再送するかどうかは，HCSCサーバを介したサービスリクエスタとサービス部品間（エンドツーエンド）の取り決めとなります。

(b)　ビジネスプロセスに障害の要因がある場合

ビジネスプロセスで実行したアクティビティの処理に障害の要因があるおそれがあります（サービス呼出アクティビティの場合，呼び出したサービス部品に障害の要因があるおそれがあります）。この場合，実行環境のメッセージログを参照し，ビジネスプロセスが返したフォルトの内容を確認します。

要因は，次の観点で調査してください。

サービスリクエスタから要求したユーザ電文

サービス部品稼働マシン

サービス部品のプログラム

ビジネスプロセスの定義内容

サービス部品呼び出し要求を再送するかどうかは，HCSCサーバを介したサービスリクエスタとサービス部品間（エンドツーエンド）の取り決めとなります。

また，ビジネスプロセスの設計内容によっても，再送（ビジネスプロセスの再実行）するかどうかを決めておく必要があります。

(c)　HCSCサーバでエラーを検知した場合

実行環境のメッセージログを参照し，エラーの内容を確認します。確認したエラーコードおよびエラーメッセージの対策に従って対処します。

要因は，次の観点で調査してください。

HCSCサーバの設定または状態

サービスアダプタの定義内容

ビジネスプロセスの定義内容

サービスリクエスタから要求したユーザ電文

サービス部品稼働マシン

サービス部品のプログラム

ネットワークの状態

サービス部品呼び出し要求を再送するかどうかは，エラーの内容によって異なります。一時的な障害の場合は，再送を試みることで成功することがありますが，次に示すエラーの場合は，再送を試みてもエラーとなります。

HCSCサーバの設定に誤りがある場合

サービスアダプタやビジネスプロセスの定義に誤りがある場合

サービスリクエスタから要求したユーザ電文に誤りがある場合

(d)　TP1インバウンドアダプタでエラーを検知した場合

TP1インバウンドアダプタの障害対策に従って，エラーの内容を調査します。詳細は，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「4.17　TP1インバウンドアダプタで発生するRPCエラー応答」を参照してください。

(4)　そのほかの障害要因の特定方法（実行履歴の追跡）

サービスリクエスタから指定した情報や，HCSCサーバからの情報を基に，サービス部品呼び出しの処理がどこまで進んでいるかを実行履歴から追跡できます。

ここでは，実行履歴を追跡するために必要な次の情報について説明します。

ルートアプリケーション情報

クライアント相関ID

メッセージ共通ID

(a)　ルートアプリケーション情報

ルートアプリケーション情報は，一連の処理の先頭になるプロセス（サービスリクエスタ）で取得した情報で，性能解析トレースに出力されます。

ルートアプリケーション情報が引き継がれる範囲を次の図に示します。

図7‒97　ルートアプリケーション情報が引き継がれる範囲

(b)　クライアント相関ID

クライアント相関IDは，TP1/RPC受付がサービス部品呼び出し要求ごとに付与するIDです。サービスリクエスタからの要求電文と，HCSCサーバで管理しているログおよびトレースと対応づけるために使用します。

クライアント相関IDが引き継がれる範囲を次の図に示します。

図7‒98　クライアント相関IDが引き継がれる範囲

(c)　メッセージ共通ID

メッセージ共通IDは，HCSCサーバがサービス部品呼び出し要求ごとに付与するIDです。HCSCサーバ内のログおよびトレースを識別するために使用します。

メッセージ共通IDが引き継がれる範囲を次の図に示します。

図7‒99　メッセージ共通IDが引き継がれる範囲

7.7.6　TP1アダプタ実行時の障害対策

TP1アダプタの実行時に発生した障害の対策方法について説明します。

TP1アダプタの実行時に障害が発生した場合，障害対策に必要な情報が出力されます。なお，TP1アダプタが使用するTP1/Client/Jのトレース情報は，TP1/Client/Jのトレースファイルへ出力されます。

(1)　障害発生時にHCSCサーバに通知する情報

サービスリクエスタからTP1アダプタへの要求中にTP1アダプタで障害が発生した場合，通信形態に応じてTP1アダプタのエラー情報または例外をHCSCサーバへ通知します。

通信形態による障害情報の通知について次に示します。

表7‒81　通信形態による障害情報の通知

通信形態

HCSCサーバへ通知する情報

RPC通信

同期応答型

エラー情報※

system例外などの予期しない障害が発生した場合，例外を通知します。

非応答型

例外

TCP/IP通信

同期応答型

エラー情報※

非応答型

例外

注※

エラー情報の詳細は，「7.7.6(3)　TP1アダプタの障害情報」を参照してください。

障害が発生した場合に，サービスリクエスタで発生する事象についての詳細は，マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」の「9.　サービスリクエスタの作成」を参照してください。

(2)　ビジネスプロセスを利用したエラー情報の参照

ビジネスプロセスで使用しているTP1アダプタから，TP1アダプタで発生した障害情報（エラー情報）が通知された場合に，faultDetail要素のXMLドキュメントをビジネスプロセス定義から参照できるよう設定できます。そのためには，事前にfaultDetail要素への要素の追加と，TP1アダプタ環境定義ファイルへの拡張オプションの指定が必要です。

(a)　faultDetail要素への要素の追加

エラー情報をビジネスプロセス定義から参照するためには，faultDetail要素のXMLドキュメントに，障害発生時のエラーメッセージのIDおよびメッセージ本文を格納する要素を次の図のように追加します。これによって，ビジネスプロセス上でメッセージごとのエラー処理が定義できるようになります。

図7‒100　faultDetail要素への障害発生時のエラーメッセージのIDおよびメッセージ本文を格納する要素の追加

faultDetail要素での要素の追加については，「7.7.6(3)　TP1アダプタの障害情報」を参照してください。

(b)　TP1アダプタ環境定義ファイルへの拡張オプションの指定

ビジネスプロセスを利用してエラー情報を参照する場合，TP1アダプタ環境定義ファイルに拡張オプションを指定する必要があります。編集手順については，マニュアル「サービスプラットフォーム開発ガイド 受付・アダプタ定義編」の「3.3.6　TP1アダプタを定義する」の定義の詳細に関する説明を参照してください。拡張オプションについては，マニュアル「サービスプラットフォーム リファレンス」の「3.4.2　TP1アダプタ環境定義ファイル」を参照してください。

(c)　エラーの発生原因の調査

エラーの発生原因は，エラー情報に含まれるmessageId要素とfactor要素の値の組み合わせから判別できます。messageId要素およびfactor要素の値の組み合わせと，エラーの発生原因の対応を次の表に示します。

表7‒82　messageId要素およびfactor要素の値の組み合わせとエラーの発生原因の対応

messageId要素

factor要素

発生原因（TP1/Client/Jのメソッド）

KDEE11007-E

other

openConnectionメソッドで例外が発生

KDEE11025-E

other

rpcCallメソッドで例外が発生

KDEE11015-E

internal

openConnectionメソッドで例外が発生

other

rpcCallメソッドで例外が発生

(3)　TP1アダプタの障害情報

TP1アダプタは，障害情報にエラー情報を使用して障害通知をします。エラー情報の各設定値を次の表に示します。

表7‒83　TP1アダプタが設定するエラー情報

要素名

型

設定値

説明

faultCode

String

Client

送られてきたメッセージの構成に異常があるなど，クライアント側のエラーです。

Server

通信エラーなど，サーバ側のエラーです。

faultString

String

<TP1アダプタが出力するメッセージのメッセージテキスト>

詳細は，マニュアル「サービスプラットフォーム メッセージ」の「2.16　KDEE10000〜KDEE13999のメッセージ」を参照してください。

faultActor

String

<サービスアダプタ名>

エラー情報を通知したサービスアダプタ名です。

faultDetail

Document（XML）

「(a)　TP1アダプタのfaultDetailの内容」参照

「(a)　TP1アダプタのfaultDetailの内容」を参照してください。

(a)　TP1アダプタのfaultDetailの内容

faultDetailは次に示す形式で記述されています。

拡張障害情報を出力する場合

<?xml version="1.0" encoding="UTF-8"?>
<detail>
　　<content>・・・</content>
　　<factor>・・・</factor>
</detail>

拡張障害情報を出力しない場合

<?xml version="1.0" encoding="UTF-8"?>
<detail>
　　<content>・・・</content>
　　<factor>・・・</factor>
　　<messageId>・・・</messageId>
　　<message>・・・</message>
</detail>

faultDetailの内容を共通要素とオプション要素に分けて次に示します。

表7‒84　faultDetailの内容（共通要素）

content要素の設定値

factor要素の設定値※

説明

対策

ResourceDeficiencyFault

（リソース不足）

internal

コネクションリソースが足りません。

RPC通信用の資源が不足しています。必要に応じて同時に処理できるRPC要求の最大数を増やしたあと，再度TP1アダプタを開始してください。

RpcErrorFault

（通信失敗）

other

接続先システムのエラーによって，RPC通信が失敗しました。

接続先システムの状態を確認してください。

internal

TP1アダプタ内部のエラーによって，RPC通信が失敗しました。

TP1アダプタの出力メッセージを確認して対策してください。

unexpected

予期しないエラーによって，RPC通信が失敗しました。

TP1アダプタ管理者に連絡してください。

TcpipErrorFault

（メッセージ送受信失敗）

other

接続先システムのエラーによって，TCP/IP通信を利用したメッセージ送受信が失敗しました。

接続先システムの状態を確認してください。

internal

TP1アダプタ内部のエラーによって，TCP/IP通信を利用したメッセージ送受信が失敗しました。

TP1アダプタの出力メッセージを確認して対策してください。

unexpected

予期しないエラーによって，TCP/IP通信を利用したメッセージ送受信が失敗しました。

TP1アダプタ管理者に連絡してください。

AdapterFault

（内部障害）

internal

TP1アダプタ内部でエラーが発生しました。

TP1アダプタの出力メッセージを確認して対策してください。

DataErrorFault

（電文不正）

internal

電文のフォーマット不正によって，通信が失敗しました。

正しい電文フォーマットに修正したあと，再度要求してください。

（凡例）

internal：TP1アダプタの内部検出によるエラーです。

other：接続先システム状態の不正によるエラーです。

unexpected：予期しないエラーです。

注※

RPC通信時またはTCP/IP通信時の障害では，TP1/Client/Jが提供する例外に対応して，factor要素（原因）が異なります。TP1/Client/Jが提供する例外についての詳細は，「(7)　TP1/Client/Jの例外に対するfactor要素の対応表」を参照してください。

表7‒85　faultDetailの内容（オプション要素）

要素

説明

messageId

TP1アダプタが出力するエラーメッセージのメッセージIDです。

message

TP1アダプタが出力するエラーメッセージのメッセージテキストです。

(4)　TP1アダプタのログ・トレースの種類

TP1アダプタで障害が発生した場合，障害対策に必要な情報がメッセージまたはトレースに出力されます。TP1アダプタで取得できるログおよびトレースの種類を次に示します。

表7‒86　ログ・トレースの種類（TP1アダプタの場合）

ログ・トレース

出力情報

説明

メッセージログ

TP1アダプタで発生した各種情報が，メッセージとして出力されます。

稼働情報（起動・停止・障害など）をメッセージとして確認できます。なお，メッセージログの出力先はアプリケーションサーバ全体で共通のため，システムの稼働状況を一括して確認できます。

メソッドトレース

TP1アダプタの内部メソッドの開始時と終了時に，次の情報が出力されます。

日付

時刻

実行スレッド名

内部メソッド名（TP1/Client/J提供のメソッドを含む）

指定した引数の情報

内部メソッド発行の時刻やシーケンスを確認できます。

データトレース

TP1アダプタが提供するメソッドの入出力のデータ情報が出力されます。

日付

時刻

実行スレッド名

内部メソッド名（TP1/Client/J提供のメソッドを含む）

発生した例外

指定した引数の情報

入出力データの内容

送受信データ内容および引数の情報を取得することで，データ（内部データ）の正当性を確認できます。

例外ログ

TP1アダプタが提供するメソッドで発生した例外情報（スタックトレース）が出力されます。

日付

時刻

発生した例外

例外が発生した時刻，メソッドを確認できます。

ログまたはトレースを出力する場合の注意事項については，「7.3.1(3)　ログおよびトレース取得時の注意事項（全般的な注意事項）」を参照してください。

(a)　メッセージログ

メッセージログに，TP1アダプタの開始・停止時のインフォメーション系メッセージや，RPC通信障害などのエラーメッセージが出力されます。

メッセージログの出力内容や出力先については，「7.4.1　メッセージログ」を参照してください。また，メッセージログの出力レベルを変更する方法については，マニュアル「サービスプラットフォーム リファレンス」の「6.7.1　TP1アダプタ実行環境プロパティファイル」のmessage.levelプロパティを参照してください。

(b)　メソッドトレース

メソッドトレースは，内部メソッド発行の時刻やシーケンスを確認できます。保守員が障害解析のために使用します。

出力先

TP1アダプタのメソッドトレースは，次に示すディレクトリに出力されます。

<J2EEサーバのログ出力ディレクトリ>¥CSCADP¥TP1ADP¥maintenance¥<サービスID>

<J2EEサーバのログ出力ディレクトリ>は，HCSCサーバが動作するJ2EEサーバ用オプション定義ファイル（usrconf.cfg）のejb.server.log.directoryキーで指定します。

メソッドトレースのトレースファイル名を次の表に示します。

表7‒87　メソッドトレースのトレースファイル名（TP1アダプタ）

トレースファイルの出力モード

トレースファイル名

ラップアラウンドモードの場合

mtdtrace<面数>.log

シフトモードの場合

mtdtrace.log

ファイル面数

出力ファイルの面数のデフォルトは8面です。ファイル面数はTP1アダプタ実行環境プロパティファイルのtrace.filenumキーで変更できます。

TP1アダプタ実行環境プロパティファイルについては，マニュアル「サービスプラットフォーム リファレンス」の「6.7.1　TP1アダプタ実行環境プロパティファイル」を参照してください。変更方法の詳細は，マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「3.3.6　TP1アダプタを定義する」のTP1アダプタ実行環境プロパティファイルの作成に関する説明を参照してください。

ファイルサイズ

出力ファイルサイズのデフォルトは2MBです。出力ファイルサイズは，TP1アダプタ実行環境プロパティファイルのtrace.filesizeキーで変更できます。

TP1アダプタ実行環境プロパティファイルについては，マニュアル「サービスプラットフォーム リファレンス」の「6.7.1　TP1アダプタ実行環境プロパティファイル」を参照してください。変更方法の詳細は，マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「3.3.6　TP1アダプタを定義する」のTP1アダプタ実行環境プロパティファイルの作成に関する説明を参照してください。

出力形式

メソッドトレースの出力形式を次の図に示します。

図7‒101　メソッドトレースの出力形式

出力される内容

メソッドトレースに出力される内容を次の表に示します。

表7‒88　メソッドトレースに出力される項目（TP1アダプタ）

項目

内容

番号

メソッドトレースの出力通番が表示されます。

日付

メソッドトレースの取得日付がyyyy/mm/ddの形式で出力されます。

時刻

メソッドトレースの取得時刻がhh:mm:ss.SSSの形式で出力されます。

ローカル時刻でミリ秒単位の時刻を示します。

製品ID

製品を特定するための識別子として，TP1アダプタを示す「ADPTP1」と，バージョン情報が表示されます。

バージョン情報の形式は次のとおりです。

正規版製品：VV-RR

修正版製品：VV-RR-SS

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID

空白

種別

トレース取得ポイントの種別が出力されます。

BGN：メソッドの開始

END：メソッドの終了

CAL：メソッドの呼び出し

RET：メソッドの戻り

ERR：メソッドの例外

クラス名

トレースを取得するクラス名が出力されます。

30文字未満の場合は左詰めされ，足りない文字はスペースで補われます。

メソッド名

トレースを取得するメソッド名

25文字未満の場合は左詰めされ，足りない文字はスペースで補われます。

入出力情報

トレースを取得するメソッドの入出力情報（引数や戻り値の値など）が出力されます。

CRLF

レコード終端符号が出力されます。

(c)　データトレース

データトレースは，送受信データ内容を取得することで，データ（内部データ）の正当性を確認できます。

出力先

データトレースは，次に示すディレクトリに出力されます。

<J2EEサーバのログ出力ディレクトリ>¥CSCADP¥TP1ADP¥maintenance¥<サービスID>

<J2EEサーバのログ出力ディレクトリ>は，HCSCサーバが動作するJ2EEサーバ用オプション定義ファイル（usrconf.cfg）のejb.server.log.directoryキーで指定します。

データトレースのトレースファイル名を次の表に示します。

表7‒89　データトレースのトレースファイル名（TP1アダプタ）

トレースファイルの出力モード

トレースファイル名

ラップアラウンドモードの場合

dattrace<面数>.log

シフトモードの場合

dattrace.log

ファイル面数

出力ファイルの面数のデフォルトは8面です。ファイル面数はTP1アダプタ実行環境プロパティファイルのdatatracefile.numで変更できます。

TP1アダプタ実行環境プロパティファイルについては，マニュアル「サービスプラットフォーム リファレンス」の「6.7.1　TP1アダプタ実行環境プロパティファイル」を参照してください。変更方法の詳細は，マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「3.3.6　TP1アダプタを定義する」のTP1アダプタ実行環境プロパティファイルの作成に関する説明を参照してください。

ファイルサイズ

出力ファイルサイズのデフォルトは2MBです。出力ファイルサイズは，TP1アダプタ実行環境プロパティファイルのdatatracefile.sizeで変更できます。

TP1アダプタ実行環境プロパティファイルについては，マニュアル「サービスプラットフォーム リファレンス」の「6.7.1　TP1アダプタ実行環境プロパティファイル」を参照してください。変更方法の詳細は，マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「3.3.6　TP1アダプタを定義する」のTP1アダプタ実行環境プロパティファイルの作成に関する説明を参照してください。

出力形式

データトレースの出力形式を次の図に示します。

図7‒102　データトレースの出力形式（TP1アダプタ）

出力される内容

データトレースに出力される内容を次の表に示します。

表7‒90　データトレースに出力される項目（TP1アダプタ）

項目

内容

番号

データトレースの出力通番が表示されます。

日付

データトレースの取得日付がyyyy/mm/ddの形式で出力されます。

時刻

データトレースの取得時刻がhh:mm:ss.SSSの形式で出力されます。

ローカル時刻でミリ秒単位の時刻を示します。

製品ID

製品を特定するための識別子として，TP1アダプタを示す「TP1ADP」と，バージョン情報が表示されます。

バージョン情報の形式は次のとおりです。

正規版製品：VV-RR

修正版製品：VV-RR-SS

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID

空白

種別

データの入出力種別が出力されます。

REQ：要求電文

RSP：応答電文

FLT：Fault電文

スペース：継続データ

形式

データの形式が出力されます。

XML：XML形式

BINARY：バイナリ形式

ANY：任意形式

6文字未満の場合は左詰めされ，足りない文字はスペースで補われます。

電文情報

送受信電文情報が出力されます。

形式が「XML」の場合

送受信データは取得されません。

形式が「BINARY」または「ANY」の場合

16進ダンプ形式で，1レコード（128バイト分）が4バイトごとにスペースで区切って出力されます。

種別がFault電文の場合

Fault情報の各要素に設定した内容を「要素名=設定値」の形式で出力します。各要素は「,（コンマ）」で区切って出力します。ただし，拡張障害情報（messageId，message）は除きます。

CRLF

レコード終端符号が出力されます。

(d)　例外ログ

例外ログには例外情報が出力されます。例外ログの概要については，「7.4.7(1)　例外ログ」を参照してください。

出力先

例外ログの出力先を次に示します。

<J2EEサーバのログ出力ディレクトリ>¥CSCADP¥TP1ADP¥maintenance¥<サービスID>

<J2EEサーバのログ出力ディレクトリ>の出力先は，HCSCサーバが動作するJ2EEサーバ用オプション定義ファイル（usrconf.cfg）のejb.server.log.directoryキーで指定します。

例外ログのログファイル名を次の表に示します。

表7‒91　例外ログのログファイル名（TP1アダプタ）

ログファイルの出力モード

ログファイル名

ラップアラウンドモードの場合

exception<面数>.log

シフトモードの場合

exception.log

ファイル面数

出力ファイルの面数のデフォルトは8面です。面数はTP1アダプタ実行環境プロパティファイルのtrace.filenumキーで変更できます。

TP1アダプタ実行環境プロパティファイルについては，マニュアル「サービスプラットフォーム リファレンス」の「6.7.1　TP1アダプタ実行環境プロパティファイル」を参照してください。変更方法の詳細については，マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「3.3.6　TP1アダプタを定義する」のTP1アダプタ実行環境プロパティファイルの作成に関する説明を参照してください。

ファイルサイズ

出力ファイルサイズのデフォルトは2MBです。ファイルサイズはTP1アダプタ実行環境プロパティファイルのtrace.filesizeキーで変更できます。

TP1アダプタ実行環境プロパティファイルについては，マニュアル「サービスプラットフォーム リファレンス」の「6.7.1　TP1アダプタ実行環境プロパティファイル」を参照してください。変更方法の詳細は，マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「3.3.6　TP1アダプタを定義する」のTP1アダプタ実行環境プロパティファイルの作成に関する説明を参照してください。

出力形式

例外ログに出力される形式を次に示します。

図7‒103　例外ログに出力される形式

出力される内容

例外ログに出力される内容を次の表に示します。

表7‒92　例外ログに出力される項目（TP1アダプタ）

項目

内容

番号

例外ログの出力通番が表示されます。

日付

例外ログの取得日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

例外ログの取得時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

ローカル時刻でミリ秒単位の時刻を示します。

製品ID

製品を特定するための識別子として，TP1アダプタを示す「ADPTP1」が表示されます。

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID

空白

スタックトレース情報

スタックトレース情報が出力されます。

CRLF

レコード終端符号が出力されます。

(5)　TP1/Client/Jのトレース情報の採取

TP1/Client/Jのトラブルシュート機能では次のトレースを取得できます。トラブルシュートを容易にするために，トレース情報の取得をお勧めします。トレース情報の詳細は，マニュアル「サービスプラットフォーム解説」の「付録A.3　TP1/Client/Jの障害対策」を参照してください。

UAPトレース

データトレース

エラートレース

メモリトレース

メソッドトレース

デバッグトレース

性能解析トレース

性能検証用トレース

障害発生時は，トレース情報を基に原因を調査してください。なお，障害発生時にトレースを取得していない場合は，トレースを取得するように設定したあと，障害が発生した現象を再現してトレース情報を取得してください。

(6)　TP1/Client/Jの適切な応答監視時間の設定

TP1/Client/JのRPC通信を使用したシステムでは，障害の発生をリアルタイムに検出できません。障害検出は時間監視のタイムアウト時となります。それを考慮して，応答監視時間には最適な値を設定してください。応答監視時間は，TP1アダプタ通信構成定義ファイルのwatch_time要素で設定します。

常設コネクションを確立する場合，RAPサーバへのコネクション確立中にRAPサーバ側でシステムダウンなどの障害が発生すると，TP1アダプタではコネクションの解放を検知できないため，通信実行時に異常終了となります。この場合，TP1アダプタからの障害通知は，応答監視時間の満了後になります。

(7)　TP1/Client/Jの例外に対するfactor要素の対応表

RPC通信時またはTCP/IP通信時にTP1/Client/Jが提供する例外について，factor要素（要因）をメソッドごとに次に示します。このときのcontent要素はすべて「RpcErrorFault」となります。

(a)　コネクション確立処理（openConnectionメソッド）

表7‒93　コネクション確立失敗時のfactor要素対応表

例外

説明

対応するfactor要素

ErrIOErrException

何らかの入出力例外が発生しました。

internal

ErrHostUndefException

rapリスナーのホスト名がTP1/Client/J環境定義のdchostオペランドに指定されていません。

internal

ErrTimedOutException

rapリスナーとのコネクション確立中にタイムアウトが発生しました。

other

ErrNetDownException

rapリスナーとの通信でネットワーク障害が発生したか，通信先のTP1/Server Baseが稼働していません。

other

ErrNoBufsException

rapリスナーおよびrapサーバでメモリ不足が発生しました。

other

ErrNotUpException

rapリスナーおよびrapサーバが稼働していません。

other

ErrSyserrException

システムエラーが発生しました。

internal

ErrProtoException

メソッドの発行順序に誤りがあります。コネクションを確立している間に再度openConnectionメソッドが呼び出されました。

unexpected

ErrInvalidPortException

rapリスナーのポート番号がTP1/Client/J環境定義のdcrapportオペランドに指定されていません。

unexpected

（凡例）

internal：TP1アダプタの内部検出によるエラーです。

other：接続先システム状態の不正によるエラーです。

unexpected：予期しないエラーです。

(b)　応答監視時間の設定（setdcwatchtimメソッド）

表7‒94　応答監視時間設定失敗時のfactor要素対応表

例外

説明

対応するfactor要素

ErrInvalidArgsException

引数の指定に誤りがあります。この場合，詳細メッセージに誤った引数名が設定されます。

unexpected

（凡例）

unexpected：予期しないエラーです。

(c)　RPC通信要求（rpcCallメソッド・rpcCallToメソッド）

表7‒95　RPC通信失敗時のfactor要素対応表

例外

説明

対応するfactor要素

ErrInvalidArgsException

引数の指定に誤りがあります。この場合，詳細メッセージに誤った引数名が設定されます。

unexpected

ErrProtoException

メソッドの発行順序に誤りがあります。openConnectionメソッドが呼び出されていません。

unexpected

ErrNoBufsException

メモリ不足が発生しました。

internal

ErrNetDownException

ネットワーク障害が発生したか，通信先のTP1/Server Baseが稼働していません。

other

ErrTimedOutException

rpcCallメソッドの処理でタイムアウトが発生したか，サービス要求先SPPが処理を完了する前に異常終了しました。

other

rpcCallToメソッドの処理でタイムアウトが発生しました。または，サービス要求先SPPが処理を完了する前に異常終了しました。

ErrMessageTooBigException

in_len引数に指定した入力パラメタ長が最大値を超えています。

internal

ErrReplyTooBigException

サーバから返された応答の長さが，CUPで用意した領域（out_data引数の指定値）の長さを超えています。

other

ErrNoSuchServiceGroupException

group引数に指定したサービスグループ名は定義されていません。

internal

ErrNoSuchServiceException

service引数に指定したサービス名は定義されていません。

internal

ErrServiceClosedException

service引数に指定したサービス名が存在するサービスグループは閉塞されています。

other

ErrServiceTerminatingException

service引数に指定したサービスは終了処理中です。

other

ErrServiceNotUpException

サービス要求したSPPが稼働していないか，サービス要求したSPPが処理を完了する前に異常終了しました。この例外はTP1/Client/J環境定義にdcwatchtim=0を指定（応答を無限に待つ）した場合に返されます。

other

ErrNotUpException

指定したサービスが存在するノードのTP1/Server Baseが稼働していません。この場合，異常終了，停止中，終了処理中，およびネットワーク障害の発生が考えられます。

other

ErrSyserrAtServerException

指定したサービスでシステムエラーが発生しました。

other

ErrSyserrException

システムエラーが発生しました。

internal

ErrNoBufsAtServerException

指定したサービスでメモリ不足が発生しました。

other

ErrInvalidReplyException

サービス関数が返した応答の長さが1からDCRPC_MAX_MESSAGE_SIZEで指定した値までの範囲にありません。

other

ErrInitializingException

サービス要求したノードにあるTP1/Server Baseは開始処理中です。

other

ErrTrnchkException

ノード間負荷バランス機能を使用している環境で，複数のSPPのトランザクション属性が一致していません。または，負荷を分散する先のノードにあるTP1/Server Baseのバージョンが，TP1/Client/Jのバージョンよりも古いため，ノード間負荷バランス機能を実行できません。この例外は，ノード間負荷バランス機能を使用しているSPPにサービス要求した場合にだけ返されます。

internal

ErrServerBusyException

サービス要求先のソケット受信型サーバが，サービス要求を受信できません。

other

ErrSecchkException

サービス要求先のSPPは，セキュリティ機能で保護されています。rpcCall・rpcCallToメソッドを呼び出したCUPには，SPPへのアクセス権限がありません。

other

ErrServiceTerminatedException

サービス要求したSPPが，処理を完了する前に異常終了しました。この例外はrapリスナーサービス定義のrpc_extend_functionオペランドに00000001を指定した場合にだけ返されます。rpc_extend_functionオペランドに00000000を指定，またはオペランドを省略した場合は，ErrTimedOutExceptionまたはErrServiceNotUpExceptionが返されます。

other

ErrIOErrException

何らかの入出力例外が発生しました。rapサーバが問い合わせ間隔の時間監視でタイムアウトし，コネクションを切断したことも考えられます。

internal

ErrTestmodeException

テストモードのSPPに対してサービス要求を行いました。

other

ErrConnfreeException

rapサーバとの常設コネクションが切断されました。または，TP1/Webとの擬似セッションが切断されました。

other

ErrHostUndefException

rpcCallメソッドの場合

通信先となるTP1/Server Baseのホスト名がTP1/Client/J環境定義のdchostオペランドに指定されていないか，または指定に誤りがあります。

rpcCallToメソッドの場合

TP1アダプタ通信構成定義ファイルのstatic_host要素で，通信先となるTP1/Server Baseのホスト名の指定に誤りがあります。

internal

ErrInvalidPortException

rpcCallメソッドの場合

次の要因が考えられます。

リモートAPI機能を使用したRPCを行う場合，TP1/Client/J環境定義のdcrapportオペランドが指定されていません。

スケジューラダイレクト機能を使用したRPCを行う場合，TP1/Client/J環境定義のdcscdportオペランドが指定されていません。

rpcCallToメソッドの場合

TP1アダプタ通信構成定義ファイルのstatic_port要素で，通信先となるTP1/Server Baseのポート番号の指定に誤りがあります。

internal

（凡例）

internal：TP1アダプタの内部検出によるエラーです。

other：接続先システム状態の不正によるエラーです。

unexpected：予期しないエラーです。

(d)　メッセージ送受信（cltAssemSendメソッド・cltAssemReceiveメソッド）

表7‒96　メッセージ送受信失敗時のfactor要素対応表

例外

説明

対応するfactor要素

ErrConnRefusedException

MHPのホスト名およびポートに対するソケットの接続の試行中にエラーが発生しました。

internal

ErrInvalidMessageException

cltAssemReceiveメソッドがこの例外を返した場合

受信メッセージのメッセージ長が0x00000005-0x7FFFFFFFにありません。

セグメント情報が不正です。

cltAssemSendメソッドがこの例外を返した場合

応答受信時に受信したメッセージのメッセージ長が0x0000000B-0x7FFFFFFFか，またはセグメント情報が不正です。

other

ErrCollisionMessageException

送受信メッセージの衝突が発生しました。

other

ErrBufferOverflowException

cltAssemReceiveメソッドに指定した受信バッファの長さを超えるメッセージを受信したため，受信バッファオーバーフローが発生しました。

other

ErrTimedOutException

サービス要求時にタイムアウトが発生しました。

other

ErrInvalidArgsException

引数の指定に誤りがあります。

internal

ErrProtoException

メソッドの発行順序に誤りがあります。またはTP1/Client/J環境定義ファイルのdcsndrcvtypeオペランドの指定に誤りがあります。

internal

ErrNetDownException

サービス要求時に通信障害が発生しました。または，MHPサーバが起動されていないおそれがあります。

other

ErrSyserrException

システムエラーが発生しました。

internal

ErrHostUndefException

TP1/Client/J環境定義ファイルのdcsndhostオペランドの指定が不正です。

internal

ErrInvalidPortException

TP1/Client/J環境定義ファイルのポート番号の指定が不正です。

internal

ErrConnfreeException

MHPサーバとのコネクションが切断されました。

other

（凡例）

internal：TP1アダプタの内部検出によるエラーです。

other：接続先システム状態の不正によるエラーです。

(e)　コネクション解放処理（closeConnectionメソッド）

リモートAPI接続の非常設コネクションで，コネクション解放処理が次の表に示す要因で失敗した場合，障害情報が出力されます。それ以外の接続方式の場合は障害情報は出力されません。

表7‒97　コネクション解放処理失敗時のfactor要素対応表

例外

説明

対応するfactor要素

ErrIOErrException

何らかの入出力例外が発生しました。

other

ErrNetDownException

rapリスナーとの通信でネットワーク障害が発生しました。

other

ErrProtoException

メソッドの発行順序に誤りがあります。すでにコネクションが切断されている間に再度closeConnectionメソッドが呼び出されました。

other

ErrSyserrException

システムエラーが発生しました。

other

ErrTimedOutException

TP1/Webとの擬似セッション切断中，またはrapリスナーやrapサーバとのコネクション切断中に，タイムアウトが発生しました。

other

（凡例）

other：接続先システム状態の不正によるエラーです。

7.7.7　ファイルアダプタ実行時の障害対策

ファイルアダプタで障害が発生した場合，障害対策に必要な情報がログファイルおよびトレースファイルに出力されます。ファイルアダプタで取得できるログおよびトレースの種類を次に示します。

表7‒98　ログ・トレースの種類（ファイルアダプタの場合）

ログ・トレース

出力情報

説明

メッセージログ

ファイルアダプタで発生した各種情報が，メッセージとして出力されます。

稼働情報（起動・停止・障害など）をメッセージとして確認できます。なお，メッセージログの出力先は，アプリケーションサーバおよびサービスプラットフォーム全体で共通なので，システムの稼働状況を一括して確認できます。

メソッドトレース

ファイルアダプタの内部メソッドの開始時と終了時に，次の情報が出力されます。

日付

時刻

実行クラス名

内部メソッド名

発生した例外

指定した引数の情報

内部メソッドの発行時刻およびシーケンスを確認できます。

性能解析トレース（PRFトレース）

アプリケーションサーバおよびサービスプラットフォーム全体の性能解析トレース取得ポイントで，次の情報が出力されます。

日付

時刻

リクエスト情報

トレース取得元情報

ファイルアダプタの性能解析トレース取得ポイントでは，ファイルアダプタ固有の情報が出力されます。

サービスリクエスタから要求を受け付けて，実行結果を返却するまでの一連の処理で出力される性能解析情報を基に，サービスプラットフォームシステムの性能を検証できます。

ログまたはトレースを出力する場合の注意事項については，「7.3.1(3)　ログおよびトレース取得時の注意事項（全般的な注意事項）」を参照してください。

ファイルアダプタのログおよびトレースは，アプリケーションサーバのトラブルシューティングの機能を使用して取得できます。取得方法を次に示します。

運用管理コマンド（mngsvrutil）を使用する。

詳細は，マニュアル「アプリケーションサーバ リファレンス コマンド編」を参照してください。

運用管理ポータルを使用する。

詳細は，マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」を参照してください。

snapshotlogコマンドを使用する。

詳細は，マニュアル「アプリケーションサーバ リファレンス コマンド編」を参照してください。

cprfコマンドを使用する（性能解析トレースだけ）。

詳細は，マニュアル「アプリケーションサーバ リファレンス コマンド編」を参照してください。

また，HCSCサーバのトレースを取得すると，アプリケーションサーバシステム全体のトラブルシュートが容易になります。HCSCサーバで取得できるトレースの情報を次の表に示します。詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の障害情報の取得に関する内容を参照してください。

表7‒99　HCSCサーバで取得できるトレースの情報

トレース機能

説明

リクエストトレース

メッセージング基盤での，標準受付，ビジネスプロセス受付，またはサーバ間転送受付で受け付けたリクエストのビジネスプロセスやサービスアダプタの呼び出し先やその結果を把握するための情報が取得できます。

メソッドトレース

HCSCサーバが提供するメソッドトレース情報が取得できます。

性能解析トレース

J2EEアプリケーションを含めたアプリケーションサーバおよびサービスプラットフォームシステム全体の性能ボトルネックを解析するための情報が取得できます。

(1)　障害処理

ファイルアダプタで障害が発生した場合，停止処理中の障害を除いてHCSCサーバに対して例外が通知されます。

(a)　開始処理の失敗

ファイルアダプタの開始処理が失敗した場合，HCSCサーバに例外が通知され処理が終了します。開始処理失敗の要因としては，ファイルアダプタ実行環境プロパティファイルの解析失敗などが考えられます。

図7‒104　開始処理の失敗

(b)　ファイル制御処理の失敗

ファイルアダプタのファイル制御処理の失敗が検知された場合，HCSCサーバに例外が通知され処理が終了します。

図7‒105　ファイル制御処理の失敗

(c)　停止処理の失敗

ファイルアダプタの停止処理の失敗が検知された場合，処理が終了するまで停止処理が継続されます。HCSCサーバに対しては，例外は通知されません。ただし，予期しない障害が発生した場合は，例外が通知されることがあります。

(2)　メッセージログ

サービスの起動・停止などのインフォメーション情報および障害時のエラー情報をメッセージログとして取得し，障害の発生を検知したり，障害要因を解析したりできます。

(a)　出力先

メッセージログの出力先を次に示します。

J2EEサーバ稼働ログの出力先に指定されたパス

J2EEサーバ稼働ログの出力先は，HCSCサーバが動作するJ2EEサーバ用オプション定義ファイル（usrconf.cfg）のejb.server.log.directoryキーで指定します。詳細は，マニュアル「アプリケーションサーバリファレンス 定義編(サーバ定義)」の「2.2.2　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」，および「2.2.3　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」を参照してください。

メッセージログのログファイル名を次の表に示します。

表7‒100　メッセージログのログファイル名

ログファイルの出力モード

ログファイル名

ラップアラウンドモードの場合

cjmessage<面数>.log※

シフトモードの場合

cjmessage.log※

注※

ログファイルはアプリケーションサーバおよびサービスプラットフォーム全体で共通です。HCSCサーバ上にあるすべての製品の運用情報および障害情報のメッセージログが出力されます。

(b)　ファイル面数

出力ファイル面数は，HCSCサーバが動作するJ2EEサーバ用ユーザプロパティファイル（usrconf.properties）のejbserver.logger.channels.define.<チャネル名>.filenumキーで指定します。詳細については，次に示すマニュアルを参照してください。

推奨モードの場合

マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.3　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」

V9互換モードの場合

マニュアル「アプリケーションサーバ 機能解説 互換編」の「10.1.1　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」

(c)　ファイルサイズ

出力ファイルサイズは，HCSCサーバが動作するJ2EEサーバ用ユーザプロパティファイル（usrconf.properties）のejbserver.logger.channels.define.<チャネル名>.filesizeキーで指定します。詳細については，次に示すマニュアルを参照してください。

推奨モードの場合

マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.3　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」

V9互換モードの場合

マニュアル「アプリケーションサーバ 機能解説 互換編」の「10.1.1　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」

(3)　メソッドトレース

内部メソッド発行の時刻やシーケンスを確認できます。保守員が障害解析のために使用します。

(a)　出力先

メソッドトレースの出力先を次に示します。

<J2EEサーバ稼働ログの出力先に指定されたパス>¥CSCADP¥FFADP¥maintenance¥<サービスアダプタ名>

J2EEサーバ稼働ログの出力先は，HCSCサーバが動作するJ2EEサーバ用オプション定義ファイル（usrconf.cfg）のejb.server.log.directoryキーで指定します。詳細は，マニュアル「アプリケーションサーバリファレンス 定義編(サーバ定義)」の「2.2.2　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。

メソッドトレースのトレースファイル名を次の表に示します。

表7‒101　メソッドトレースのトレースファイル名

トレースファイルの出力モード

トレースファイル名

ラップアラウンドモードの場合

mtdtrace<面数>.log

シフトモードの場合

mtdtrace.log

(b)　ファイル面数

出力ファイル面数のデフォルトは4面です。出力ファイル面数は，ファイルアダプタ実行環境プロパティファイルのmethodtracefile.numキーで変更できます。変更方法の詳細は，マニュアル「サービスプラットフォーム開発ガイド 受付・アダプタ定義編」の「3.3.7　ファイルアダプタを定義する」のファイルアダプタ実行環境プロパティファイルの作成に関する説明を参照してください。

(c)　ファイルサイズ

出力ファイルサイズのデフォルトは4MBです。出力ファイルサイズは，ファイルアダプタ実行環境プロパティファイルのmethodtracefile.sizeキーで変更できます。変更方法の詳細は，マニュアル「サービスプラットフォーム開発ガイド 受付・アダプタ定義編」の「3.3.7　ファイルアダプタを定義する」のファイルアダプタ実行環境プロパティファイルの作成に関する説明を参照してください。

(4)　性能解析トレース（PRFトレース）

サービスリクエスタから要求を受け付けて，実行結果を返却するまでの一連の処理で出力される性能解析情報を基に，アプリケーションサーバおよびサービスプラットフォームシステムの性能を検証できます。ファイルアダプタの性能解析トレース取得ポイントでは，ファイルアダプタ固有の情報が出力されます。保守員が性能ボトルネックの解析のために使用します。

(a)　出力先

性能解析トレースの出力先およびトレースファイル名を次の表に示します。

表7‒102　性能解析トレースの出力先およびトレースファイル名

トレースの出力先パス

トレースファイル名

<環境変数PRFSPOOLの設定ディレクトリ>¥utt¥prf¥<PRF識別子>¥dcopltrc※

prf_<n>

（凡例）

n：001からファイル面数の最大値までの整数が入ります。

注※

性能解析トレースの出力先は，アプリケーションサーバおよびサービスプラットフォーム全体で共通です。詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.3　Management Serverを利用した性能解析トレースファイルの収集」を参照してください。

(b)　ファイル面数

出力ファイル面数のデフォルトは4面です。出力ファイル面数は，運用管理ポータルまたはcprfコマンドで変更できます。運用管理ポータルの詳細はマニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」を，cprfコマンドの詳細はマニュアル「アプリケーションサーバ リファレンス コマンド編」を参照してください。

(c)　ファイルサイズ

運用管理ポータルでファイルサイズを設定した場合,ファイルサイズのデフォルトは32MBです。cprfコマンドでファイルサイズを設定した場合，ファイルサイズのデフォルトは8MBです。ファイルサイズは，運用管理ポータルまたはcprfコマンドで変更できます。運用管理ポータルの詳細はマニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」を，cprfコマンドの詳細はマニュアル「アプリケーションサーバ リファレンス コマンド編」を参照してください。

(d)　出力形式

性能解析トレースに出力される形式は，J2EEサーバの性能解析トレースと同様です。詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.3　Management Serverを利用した性能解析トレースファイルの収集」を参照してください。

(e)　性能解析トレースの取得ポイント

ファイルアダプタの性能解析トレース取得ポイントでは，ファイルアダプタ固有の情報が出力されます。

●概要

ファイルアダプタの性能解析トレース取得ポイントを次の図に示します。

図7‒106　性能解析トレース取得ポイント（ファイルアダプタ）

性能解析トレースの取得ポイントには，ポイント固有のイベントIDが割り当てられます。ファイルアダプタで出力されるトレースのイベントIDは0xA000〜0xA0FFです。イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。表の「図中の番号」は，「図7-106　性能解析トレース取得ポイント（ファイルアダプタ）」中の番号と対応しています。

表7‒103　性能解析トレース取得ポイント（ファイルアダプタ）

イベントID

図中の番号

トレース取得ポイント

レベル※1

0xA000

1

リクエスト受付時

詳細

0xA002

2

ファイル操作処理呼び出し時

標準

0xA003

3

ファイル操作処理完了時※2

標準

0xA001

4

レスポンス送信時

詳細

注※1

性能解析トレースのレベルの変更方法については，「トレース取得レベルの変更」，マニュアル「アプリケーションサーバ リファレンス コマンド編」，およびマニュアル「アプリケーションサーバ 機能解説 保守／移行編」を参照してください。デフォルトは標準です。

注※2

ファイル操作処理中に例外が発生した場合も，トレース取得ポイントはファイル操作処理完了時と同様です。

●トレース取得レベルの変更

PRFトレース取得レベルを変更する場合，cprflevelコマンドの-PrfChangeLevelオプションに4バイトの16進数（8桁）の値を2つ指定します。それぞれの16進数の値には，インデックス番号（インデックス1，インデックス2）が割り当てられています。トレース情報を取得する場合の指定個所を次の表に示します。

表7‒104　トレース取得レベルの指定個所

インデックス

桁番号

上位レイヤ

下位レイヤ

インデックス1

1桁目

リダイレクタ

Webコンテナ

2桁目

EJBコンテナ

JNDI

3桁目

JTA

JCAコンテナ

4桁目

DB Connector

RMI

5桁目

Web Services - Base

TP1 Connector，TP1/Client/J

6桁目

TP1/Message Queue - Access

Reliable Messaging

7桁目

OTS

−

8桁目

CTM

−

インデックス2

1桁目

HCSCサーバ

標準出力/標準エラー出力/ユーザログ

2桁目

DI

−

3桁目※

−

ファイルアダプタ

（凡例）

−：該当しません。

注※

ファイルアダプタのトレース取得レベルを変更する場合，インデックス2の3桁目の下位レイヤの値を変更します。変更する場合の指定値を次の表に示します。

表7‒105　ファイルアダプタのトレース取得レベルの指定値

指定値※

トレース取得レベル

0

標準

1

詳細

注※

-PrfChangeLevelオプションに指定する際は，16進数に変換します。

cprflevelコマンドの詳細は，マニュアル「アプリケーションサーバ リファレンス コマンド編」を参照してください。

7.7.8　Object Accessアダプタ実行時の障害対策

Object Accessアダプタで障害が発生した場合，障害対策に必要な情報がメッセージまたはトレースに出力されます。Object Accessアダプタで取得できるログおよびトレースの種類を次に示します。

表7‒106　ログ・トレースの種類（Object Accessアダプタの場合）

ログ・トレース

出力情報

説明

メッセージログ

Object Accessアダプタで発生した各種情報が，メッセージとして出力されます。

稼働情報（起動・停止・障害など）をメッセージとして確認できます。なお，メッセージログの出力先はアプリケーションサーバ全体で共通のため，システムの稼働状況を一括して確認できます。

メソッドトレース

Object Accessアダプタの内部メソッドの開始時と終了時に，次の情報が出力されます。

日付

時刻

実行クラス名

内部メソッド名

発生した例外

指定した引数の情報

内部メソッド発行の時刻やシーケンスを確認できます。

データトレース

送受信データ内容が出力されます。

データ（内部データ）の正当性を確認できます。

性能解析トレース

アプリケーションサーバ全体の性能解析トレース取得ポイントで，次の情報が出力されます。

日付

時刻

リクエスト情報

トレース取得元情報

サービスリクエスタから要求を受け付けて，実行結果を返却するまでの一連の処理で出力される性能解析情報を基に，サービスプラットフォームシステムの性能を検証できます。

例外ログ

発生した例外情報（スタックトレース）を出力します。

例外情報を確認できます。

ログまたはトレースを出力する場合の注意事項については，「7.3.1(3)　ログおよびトレース取得時の注意事項（全般的な注意事項）」を参照してください。

Object Accessアダプタのログおよびトレースは，アプリケーションサーバのトラブルシューティングの機能を使用して取得できます。取得方法を次に示します。

運用管理コマンド（mngsvrutil）を使用する。

詳細は，マニュアル「アプリケーションサーバ リファレンス コマンド編」を参照してください。

運用管理ポータルを使用する。

詳細は，マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」を参照してください。

snapshotlogコマンドを使用する。

詳細は，マニュアル「アプリケーションサーバ リファレンス コマンド編」を参照してください。

cprfコマンドを使用する（性能解析トレースだけ）。

詳細は，マニュアル「アプリケーションサーバ リファレンス コマンド編」を参照してください。

また，HCSCサーバやTPBrokerのトレースを取得すると，アプリケーションサーバ全体のトラブルシュートが容易になります。HCSCサーバとTPBrokerで取得できるトレースの情報を次に示します。詳細はマニュアル「アプリケーションサーバ 機能解説 保守／移行編」の障害情報の取得に関する内容を参照してください。

表7‒107　HCSCサーバで取得できるトレースの情報

トレース機能

説明

リクエストトレース

メッセージング基盤での，標準受付，ビジネスプロセス受付，またはサーバ間転送受付で受け付けたリクエストのビジネスプロセスやサービスアダプタの呼び出し先やその結果を把握するための情報が取得できます。

メソッドトレース

HCSCサーバが提供するメソッドトレース情報が取得できます。

性能解析トレース

J2EEアプリケーションを含めたサービスプラットフォームシステム全体の性能ボトルネックを解析するための情報が取得できます。

表7‒108　TPBroker提供トレース

トレース機能

説明

通信トレース

ORBの通信トレースです。

モジュールトレース

ORBのモジュールトレースです。

TPBroker提供トレースは，障害調査のため取得することを推奨します。

(1)　メッセージログ

メッセージログのJ2EEサーバの稼働ログに，Object Accessアダプタで発生した各種情報がメッセージとして出力されます。

メッセージログの出力内容や出力先については，「7.4.1　メッセージログ」を参照してください。

(2)　メソッドトレース

メソッドトレースは，内部メソッド発行の時刻やシーケンスを確認できます。保守員が障害解析のために使用します。

(a)　出力先

Object Accessアダプタのメソッドトレースは，次に示すディレクトリに出力されます。

<J2EEサーバのログ出力ディレクトリ>¥CSCADP¥OAADP¥maintenance¥<サービスID>

<J2EEサーバのログ出力ディレクトリ>は，HCSCサーバが動作するJ2EEサーバ用オプション定義ファイル（usrconf.cfg）のejb.server.log.directoryキーで指定します。

メソッドトレースのトレースファイル名を次の表に示します。

表7‒109　メソッドトレースのトレースファイル名（Object Accessアダプタ）

トレースファイルの出力モード

トレースファイル名

ラップアラウンドモードの場合

mtdtrace<面数>.log

シフトモードの場合

mtdtrace.log

(b)　ファイル面数

出力ファイルの面数のデフォルトは4面です。ファイル面数はObject Accessアダプタ実行環境プロパティファイルのmethodtracefile.numキーで変更できます。

Object Accessアダプタ実行環境プロパティファイルについては，マニュアル「サービスプラットフォーム リファレンス」の「6.11.1　Object Accessアダプタ実行環境プロパティファイル」を参照してください。変更方法の詳細は，マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「3.3.8　Object Accessアダプタを定義する」のObject Accessアダプタ実行環境プロパティファイルの作成に関する説明を参照してください。

(c)　ファイルサイズ

出力ファイルサイズのデフォルトは4MBです。出力ファイルサイズは，Object Accessアダプタ実行環境プロパティファイルのmethodtracefile.sizeキーで変更できます。

Object Accessアダプタ実行環境プロパティファイルについては，マニュアル「サービスプラットフォーム リファレンス」の「6.11.1　Object Accessアダプタ実行環境プロパティファイル」を参照してください。変更方法の詳細は，マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「3.3.8　Object Accessアダプタを定義する」のObject Accessアダプタ実行環境プロパティファイルの作成に関する説明を参照してください。

(d)　出力形式

メソッドトレースの出力形式を次の図に示します。

図7‒107　メソッドトレースの出力形式

(e)　出力される内容

メソッドトレースに出力される内容を次の表に示します。

表7‒110　メソッドトレースに出力される項目（Object Accessアダプタ）

項目

内容

番号

メソッドトレースの出力通番が表示されます。

日付

メソッドトレースの取得日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

メソッドトレースの取得時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

ローカル時刻でミリ秒単位の時刻を示します。

製品ID

製品を特定するための識別子として，Object Accessアダプタを示す「ADPOA」と，バージョン情報が表示されます。

バージョン情報の形式は次のとおりです。

正規版製品：VV-RR

修正版製品：VV-RR-SS

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID

空白

種別

トレース取得ポイントの種別が出力されます。

BGN：メソッドの開始

END：メソッドの終了

CAL：メソッドの呼び出し

RET：メソッドの戻り

THR：例外のthrow

CTH：例外のcatch

クラス名

トレースを取得するクラス名が出力されます。

30文字未満の場合は左詰めされ，足りない文字はスペースで補われます。

メソッド名

トレースを取得するメソッド名

25文字未満の場合は左詰めされ，足りない文字はスペースで補われます。

RootAP情報

性能解析トレースに出力されるRootAPの情報であるIPアドレス・プロセスID・通信番号を「/」（スラッシュ）で区切った文字列が出力されます。

入出力情報

トレースを取得するメソッドの入出力情報（引数や戻り値の値など）が出力されます。

CRLF

レコード終端符号が出力されます。

(3)　データトレース

データトレースは，送受信データ内容を取得することで，データ（内部データ）の正当性を確認できます。

(a)　出力先

データトレースは，次に示すディレクトリに出力されます。

<J2EEサーバのログ出力ディレクトリ>¥CSCADP¥OAADP¥maintenance¥<サービスID>

<J2EEサーバのログ出力ディレクトリ>は，HCSCサーバが動作するJ2EEサーバ用オプション定義ファイル（usrconf.cfg）のejb.server.log.directoryキーで指定します。

データトレースのトレースファイル名を次の表に示します。

表7‒111　データトレースのトレースファイル名（Object Accessアダプタ）

トレースファイルの出力モード

トレースファイル名

ラップアラウンドモードの場合

dattrace<面数>.log

シフトモードの場合

dattrace.log

(b)　ファイル面数

出力ファイルの面数のデフォルトは4面です。ファイル面数はObject Accessアダプタ実行環境プロパティファイルのdatatracefile.numで変更できます。

Object Accessアダプタ実行環境プロパティファイルについては，マニュアル「サービスプラットフォーム リファレンス」の「6.11.1　Object Accessアダプタ実行環境プロパティファイル」を参照してください。変更方法の詳細は，マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「3.3.8　Object Accessアダプタを定義する」のObject Accessアダプタ実行環境プロパティファイルの作成に関する説明を参照してください。

(c)　ファイルサイズ

出力ファイルサイズのデフォルトは4MBです。出力ファイルサイズは，Object Accessアダプタ実行環境プロパティファイルのdatatracefile.sizeで変更できます。

Object Accessアダプタ実行環境プロパティファイルについては，マニュアル「サービスプラットフォーム リファレンス」の「6.11.1　Object Accessアダプタ実行環境プロパティファイル」を参照してください。変更方法の詳細は，マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「3.3.8　Object Accessアダプタを定義する」のObject Accessアダプタ実行環境プロパティファイルの作成に関する説明を参照してください。

(d)　出力形式

データトレースの出力形式を次の図に示します。

図7‒108　データトレースの出力形式（Object Accessアダプタ）

(e)　出力される内容

データトレースに出力される内容を次の表に示します。

表7‒112　データトレースに出力される項目（Object Accessアダプタ）

項目

内容

番号

データトレースの出力通番が表示されます。

日付

データトレースの取得日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

データトレースの取得時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

ローカル時刻でミリ秒単位の時刻を示します。

製品ID

製品を特定するための識別子として，Object Accessアダプタを示す「ADPOA」と，バージョン情報が表示されます。

バージョン情報の形式は次のとおりです。

正規版製品：VV-RR

修正版製品：VV-RR-SS

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID

空白

種別

データの入出力種別が出力されます。

REQ：要求電文

RSP：応答電文

FLT：Fault電文

スペース：継続データ

形式

データの形式が出力されます。

XML：XML形式

BINARY：バイナリ形式

6文字未満の場合は左詰めされ，足りない文字はスペースで補われます。

RootAP情報

性能解析トレースに出力されるRootAPの情報であるIPアドレス・プロセスID・通信番号を「/（スラッシュ）」で区切った文字列が出力されます。

電文情報

送受信電文情報が出力されます。

形式が「XML」の場合

XMLのテキストが出力されます。

形式が「BINARY」の場合

送受信データは取得されません。

種別が「FLT」の場合

Fault情報の各要素に設定した内容を「要素名=設定値」の形式で出力します。各要素は「,（コンマ）」で区切って出力します。

CRLF

レコード終端符号が出力されます。

(4)　性能解析トレース

Object Accessアダプタの性能解析トレースは，サービスリクエスタから要求を受け付けて，実行結果を返却するまでの一連の処理で出力される性能解析情報を基に，サービスプラットフォームシステムの性能を検証できます。

(a)　出力形式

性能解析トレースファイルの出力形式は，J2EEサーバの性能解析トレースと同様です。詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.3　Management Serverを利用した性能解析トレースファイルの収集」を参照してください。

(b)　出力される内容

性能解析トレースファイルに出力される内容を次の表に示します。

表7‒113　性能解析トレースファイルに出力される内容（Object Accessアダプタ）

項目

内容

イベントID

取得ポイントのイベントIDが出力されます。

取得ポイントの詳細は，「(c)　性能解析トレースの取得ポイント」を参照してください。

リターンコード

取得ポイント種別が出力されます。

0：正常終了

1：異常終了

インターフェース名

クラス名が出力されます。

オペレーション名

メソッド名が出力されます。

オプション情報

保守情報が出力されます。取得ポイントによっては出力されないこともあります。

(c)　性能解析トレースの取得ポイント

Object Accessアダプタが取得している性能解析トレースの取得ポイントを次に示します。

図7‒109　性能解析トレースの取得ポイント（Object Accessアダプタ）

イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。表の「図中の番号」は，「図7-109　性能解析トレースの取得ポイント（Object Accessアダプタ）」中の番号と対応しています。

表7‒114　性能解析トレース取得ポイント（Object Accessアダプタ）

イベントID

図中の番号

トレース取得ポイント

レベル※1

0x9F21

1

要求電文変換処理前

B

0x9F22

2

要求電文変換処理後

B

0x9F01

3

TPBroker接続処理前

A

0x9F02

4

TPBroker接続処理後※2

A

0x9F03

5

サービス要求処理前

B

0x9F04

6

サービス要求処理後

A

0x9F23

7

応答電文変換処理前

B

0x9F24

8

応答電文変換処理後

B

（凡例）

A：「標準」であることを示します。

B：「詳細」であることを示します。

注※1

性能解析トレースのレベルの変更方法については，「(d)　性能解析トレースの取得レベルの変更」を参照してください。

注※2

TPBroker接続処理で例外が発生した場合だけ取得します。例外発生以降のトレースは取得されません。

(d)　性能解析トレースの取得レベルの変更

Object Accessアダプタが取得している性能解析トレースの取得レベルは，任意のタイミングで変更できます。性能解析トレースの取得レベルの変更方法の詳細については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」を参照してください。

性能解析トレース取得レベルは，cprflevelコマンドの-PrfChangeLevelオプションに，4バイトの16進数（8桁）で指定します。cprflevelコマンドの指定方法については，マニュアル「アプリケーションサーバリファレンス コマンド編」の「cprflevel（PRFトレース取得レベルの表示と変更）」を参照してください。

それぞれの桁には，機能レイヤが2つずつ割り当てられています。16進数を2進数にした場合の上位2ビットに割り当てられている機能レイヤを上位レイヤ，下位2ビットに割り当てられている機能レイヤを下位レイヤといいます。Object Accessアダプタでは，3桁目の上位レイヤを使用します。

図7‒110　性能解析トレース機能レイヤ

Object Accessアダプタの取得レベルの設定値を次に示します。

表7‒115　性能解析トレース取得レベルの設定値

インデックス

設定桁

指定値

説明

インデックス2

3桁目

0

標準の性能解析トレースを取得します。

4

詳細の性能解析トレースを取得します。

3桁目の下位レイヤを合わせて設定する場合は，設定値に3桁目の下位レイヤの設定値を加算して設定してください。

(5)　例外ログ

例外ログには例外情報が出力されます。例外ログの概要については，「7.4.7(1)　例外ログ」を参照してください。

(a)　出力先

例外ログの出力先を次に示します。

<J2EEサーバのログ出力ディレクトリ>¥CSCADP¥OAADP¥maintenance¥<サービスID>

<J2EEサーバのログ出力ディレクトリ>は，HCSCサーバが動作するJ2EEサーバ用オプション定義ファイル（usrconf.cfg）のejb.server.log.directoryキーで指定します。

例外ログのログファイル名を次の表に示します。

表7‒116　例外ログのログファイル名（Object Accessアダプタ）

ログファイルの出力モード

ログファイル名

ラップアラウンドモードの場合

exception<面数>.log

シフトモードの場合

exception.log

(b)　ファイル面数

出力ファイルの面数のデフォルトは4面です。面数はObject Accessアダプタ実行環境プロパティファイルのexptracefile.numキーで変更できます。

Object Accessアダプタ実行環境プロパティファイルについては，マニュアル「サービスプラットフォーム リファレンス」の「6.11.1　Object Accessアダプタ実行環境プロパティファイル」を参照してください。変更方法の詳細については，マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「3.3.8　Object Accessアダプタを定義する」のObject Accessアダプタ実行環境プロパティファイルの作成に関する説明を参照してください。

(c)　ファイルサイズ

出力ファイルサイズのデフォルトは4MBです。出力ファイルサイズは，Object Accessアダプタ実行環境プロパティファイルのexptracefile.sizeキーで変更できます。

Object Accessアダプタ実行環境プロパティファイルについては，マニュアル「サービスプラットフォーム リファレンス」の「6.11.1　Object Accessアダプタ実行環境プロパティファイル」を参照してください。変更方法の詳細は，マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「3.3.8　Object Accessアダプタを定義する」のObject Accessアダプタ実行環境プロパティファイルの作成に関する説明を参照してください。

(d)　出力形式

例外ログの出力形式を次の図に示します。

図7‒111　例外ログの出力形式

(e)　出力される内容

例外ログに出力される内容を次の表に示します。

表7‒117　例外ログに出力される項目（Object Accessアダプタ）

項目

内容

番号

例外ログの出力通番が表示されます。

日付

例外ログの取得日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

例外ログの取得時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

ローカル時刻でミリ秒単位の時刻を示します。

製品ID

製品を特定するための識別子として，Object Accessアダプタを示す「ADPOA」が表示されます。

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID

空白

スタックトレース情報

スタックトレース情報が出力されます。

CRLF

レコード終端符号が出力されます。

(6)　Object Accessアダプタの障害情報

Object Accessアダプタは，障害情報にエラー情報を使用して障害を通知します。エラー情報の各設定値を次に示します。

表7‒118　Object Accessアダプタが設定するエラー情報

要素名

型

設定値

説明

faultCode

String

Server

通信エラーなど，サーバ側のエラーです。

faultString

String

<Object Accessアダプタが出力するメッセージのメッセージテキスト>

詳細は，マニュアル「サービスプラットフォーム メッセージ」の「2.17　KDEF20000〜KDEF30999のメッセージ」を参照してください。

faultActor

String

<サービスID>

エラー情報を通知したサービスIDです。

faultDetail

Document（XML）

IDLユーザ例外の形式のXML（DOM）

IDLに記載されたユーザ例外のデータ形式に沿って発生した例外情報が格納されたXML電文です。

7.7.9　Message Queue受付実行時の障害対策

Message Queue受付では，障害情報として性能解析トレースを出力します。

ここでは，Message Queue受付実行時に発生したエラーの伝わり方と，性能解析トレースについて説明します。

(1)　Message Queue受付実行時に発生したエラーの伝わり方

JMSプロバイダ（IBM MQ）からMessage Queue受付を使用してビジネスプロセスを呼び出す場合のエラーの伝わり方を説明します。

カスタム受付フレームワークがエラーをリターンした場合のエラーの伝わり方を次の図に示します。

参考

サービス部品またはサービスアダプタからフォルトが返された場合，通信モデルが非同期の受付に対してビジネスプロセスからフォルトを返すことができないため，例外で返されます。そのため，エラーの伝わり方は次の図に示す流れと同じになります。

図7‒112　カスタム受付フレームワークがエラーをリターンした場合のエラーの伝わり方（Message Queue受付の場合）

図中に示したエラー1〜エラー5の要因を次に示します。

エラー1：要求パラメタ不正など

エラー2：宛先（ロケーション）が見つからない，サービスアダプタが停止しているなど

エラー3：データ変換の失敗など

エラー4：宛先不正，サービス部品が停止，通信障害など

エラー5：ビジネスプロセス処理上での例外エラーなど

エラー1〜エラー5のどれかが発生した場合，例外をキャッチしたカスタム受付フレームワークはMessage Queue受付の受付処理に対して，CSCMsgServerExceptionをスローします。CSCMsgServerExceptionの詳細は，マニュアル「サービスプラットフォーム開発ガイド 受付・アダプタ定義編」の「付録A.3　カスタム受付フレームワークのAPI」を参照してください。

Message Queue受付の受付処理では，キャッチした例外を基に例外ログを出力し，EJBContext#setRollbackOnlyを実行したあと，MQリソースアダプタに正常応答します。

MQリソースアダプタでは，JMSプロバイダ（IBM MQ）のキューマネージャに対して正常応答をそのまま渡します。

JMSプロバイダ（IBM MQ）のキューマネージャは，トランザクションをロールバックし，メッセージをキューの先頭に戻します。

注意事項

ロールバック回数制限値などの設定によって，ロールバック回数が多くなった場合は，メッセージはデッドレターキューへ移動されます。ロールバック回数制限値の詳細は，マニュアル「サービスプラットフォーム解説」の「2.10.1　Message Queue受付を使用したサービス部品の呼び出し」の，メッセージのロールバック回数の設定に関する記述を参照してください。

(2)　障害情報の取得（Message Queue受付）

運用時に障害が発生した場合，障害対策に必要な情報は，ログファイルにログとして出力され，トレースファイルにトレースとして出力されます。

ここでは，メッセージログおよび各種トレースの取得方法について説明します。

(a)　メッセージログ（Message Queue受付）

メッセージログのJ2EEサーバの稼働ログに，Message Queue受付で発生した各種情報がメッセージとして出力されます。

メッセージログの出力内容や出力先については，「7.4.1　メッセージログ」を参照してください。

(b)　リクエストトレース（Message Queue受付）

リクエストトレースは，リクエストの障害要因の解析に使用します。

リクエストトレースの出力は，Message Queue受付からではなく，カスタム受付フレームワークからになります。

リクエストトレースの詳細は，マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「付録A.8　障害情報の取得（カスタム受付）」のリクエストトレース（カスタム受付）に関する説明を参照してください。

(c)　性能解析トレース（Message Queue受付）

Message Queue受付での性能解析トレース（PRFトレース）について説明します。

●性能解析トレースの出力形式

性能解析トレースファイルに出力される形式は，J2EEサーバの性能解析トレースと同様です。詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.　性能解析トレースを使用した性能解析」を参照してください。

●出力される内容

性能解析トレースファイルに出力される内容を次の表に示します。

表7‒119　性能解析トレースファイルに出力される内容（Message Queue受付）

項目

内容

イベントID

取得ポイントのイベントIDが出力されます。

取得ポイントの詳細は，項目「性能解析トレースの取得ポイント」を参照してください。

リターンコード

取得ポイント種別が出力されます。

0：正常終了

1：異常終了

インターフェース名

クラス名が出力されます。

オペレーション名

メソッド名が出力されます。

オプション情報

次のオプション情報が出力されます。

JMSメッセージID

受付名

受付ID

サービス名

サービスオペレーション名

例外名（障害発生時だけ）

●性能解析トレースの取得ポイント

性能解析トレースの取得ポイントを次の図に示します。

図7‒113　性能解析トレースの取得ポイント（Message Queue受付）

イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。表の「図中の番号」は，上の図の番号と対応しています。

表7‒120　性能解析トレースの取得ポイント（Message Queue受付の場合）

イベントID

図中の番号

トレース取得ポイント

レベル

0x98A0

1

Message Queue受付の入口

A

0x98A1

2

Message Queue受付の出口

A

0x98A2

3

カスタム受付フレームワークの呼び出し口

B

0x98A3

4

カスタム受付フレームワークの応答受信口

B

0x9860

5

カスタム受付フレームワークの入口

A

0x9861

6

カスタム受付フレームワークの出口

A

0x9864

7

HCSCメッセージ配送制御の呼び出し口

A

0x9865

8

HCSCメッセージ配送制御の応答受信口

A

（凡例）

A：「標準」であることを示します。

B：「詳細」であることを示します。

●性能解析トレースの取得方法と出力先

性能解析トレースを取得するには設定が必要です。設定の詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.　性能解析トレースを使用した性能解析」を参照してください。

(d)　ユーザ電文トレース（Message Queue受付）

ユーザ電文トレースは，電文の状態を確認するために使用します。

ユーザ電文トレースの出力は，Message Queue受付からではなく，カスタム受付フレームワークからになります。

ユーザ電文トレースの詳細は，マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「付録A.8　障害情報の取得（カスタム受付）」のリクエストトレース（カスタム受付）に関する説明を参照してください。

(3)　Message Queue受付処理中のJ2EEサーバダウン時の対策

Message Queue受付の処理中にJ2EEサーバがダウンした場合，IBM MQの仕様でメッセージは即時ロールバックされません。その場合，IBM MQサーバを再起動してください。

7.7.10　Message Queueアダプタ実行時の障害対策

Message Queueアダプタでは，システムの性能を検証したり，障害原因を解析したりするための情報が，ログファイルまたはトレースファイルに出力されます。Message Queueアダプタで出力されるログおよびトレースの種類を次の表に示します。

表7‒121　ログ・トレースの種類（Message Queueアダプタの場合）

ログ・トレース

出力情報

説明

メッセージログ

Message Queueアダプタで発生した各種情報が，メッセージとして出力されます。

稼働情報（起動・停止・障害など）をメッセージとして確認できます。なお，メッセージログの出力先は，アプリケーションサーバ全体で共通なので，システムの稼働状況を一括して確認できます。

メソッドトレース

Message Queueアダプタの内部メソッドの開始時と終了時に，次の情報が出力されます。

日付

時刻

実行クラス名

内部メソッド名

指定した引数の情報

内部メソッドの発行時刻およびシーケンスを確認できます。

データトレース

Message Queueアダプタとリソースアダプタとの送受信メッセージとFault応答情報のDetail情報など，次の情報が出力されます。

日付

時刻

メッセージの入出力種別

メッセージの内容

メッセージの内容および引数の情報を取得することで，メッセージの正当性を確認することができます。

性能解析トレース

アプリケーションサーバ全体の性能解析トレース取得ポイントで，次の情報が出力されます。

日付

時刻

リクエスト情報

トレース取得元情報

Message Queueアダプタの性能解析トレース取得ポイントでは，Message Queueアダプタ固有の情報が出力されます。

サービスリクエスタから要求を受け付けて，実行結果を返却するまでの一連の処理で出力される性能解析情報を基に，アプリケーションサーバシステムの性能を検証できます。

例外ログ

Message Queueアダプタが提供するメソッドで発生した例外情報が出力されます。

日付

時刻

発生した例外情報（スタックトレース）

例外が発生した時刻やメソッドを確認できます。

ログまたはトレースを出力する場合の注意事項については，「7.3.1(3)　ログおよびトレース取得時の注意事項（全般的な注意事項）」を参照してください。

Message Queueアダプタのトラブルシュート機能では，コンソールにメッセージを出力します。障害発生時は，メッセージの情報を基に原因を調査してください。原因が判明しない場合は，Message Queueアダプタの定義およびメッセージログなどの資料を採取して管理者に連絡してください。

Message Queueアダプタのログおよびトレースは，アプリケーションサーバのトラブルシューティングの機能を使用して取得できます。取得方法を次に示します。

Management Serverの運用管理コマンド（mngsvrutil）を使用する。

詳細は，マニュアル「アプリケーションサーバ リファレンス コマンド編」を参照してください。

運用管理ポータルを使用する。

詳細は，マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」を参照してください。

snapshotlogコマンドを使用する。

詳細は，マニュアル「アプリケーションサーバ リファレンス コマンド編」を参照してください。

(1)　メッセージログ

メッセージログのJ2EEサーバの稼働ログに，Message Queueアダプタで発生した各種情報がメッセージとして出力されます。

メッセージログの出力内容や出力先については，「7.4.1　メッセージログ」を参照してください。

(2)　メソッドトレース

内部メソッド発行の時刻やシーケンスを確認できます。保守員が障害解析のために使用します。

(a)　出力先

Message Queueアダプタのメソッドトレースの出力先を次に示します。

<J2EEサーバのログ出力ディレクトリ>¥CSCADP¥MQADP¥maintenance¥<サービスID>

<J2EEサーバのログ出力ディレクトリ>は，HCSCサーバが動作するJ2EEサーバ用オプション定義ファイル（usrconf.cfg）のejb.server.log.directoryキーで指定します。詳細は，マニュアル「アプリケーションサーバリファレンス 定義編(サーバ定義)」の「2.2.2　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。

メソッドトレースのトレースファイル名を次に示します。

表7‒122　メソッドトレースのトレースファイル名（Message Queueアダプタ）

トレースファイルの出力モード

トレースファイル名

ラップアラウンドモードの場合

mtdtrace<面数>.log

シフトモードの場合

mtdtrace.log

(b)　ファイル面数

出力ファイルの面数のデフォルトは4面です。面数はMessage Queueアダプタ実行環境プロパティファイルのmethodtracefile.numキーで変更できます。

Message Queueアダプタ実行環境プロパティファイルについては，マニュアル「サービスプラットフォーム リファレンス」の「6.12.1　Message Queueアダプタ実行環境プロパティファイル」を参照してください。変更方法の詳細については，マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「3.3.9　Message Queueアダプタを定義する」のMessage Queueアダプタ実行環境プロパティファイルの作成に関する説明を参照してください。

(c)　ファイルサイズ

出力ファイルサイズのデフォルトは4MBです。ファイルサイズはMessage Queueアダプタ実行環境プロパティファイルのmethodtracefile.sizeキーで変更できます。

Message Queueアダプタ実行環境プロパティファイルについては，マニュアル「サービスプラットフォーム リファレンス」の「6.12.1　Message Queueアダプタ実行環境プロパティファイル」を参照してください。変更方法の詳細は，マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「3.3.9　Message Queueアダプタを定義する」のMessage Queueアダプタ実行環境プロパティファイルの作成に関する説明を参照してください。

(d)　出力形式

メソッドトレースの出力形式を次の図に示します。

図7‒114　メソッドトレースの出力形式

(e)　出力される内容

メソッドトレースに出力される内容を次の表に示します。

表7‒123　メソッドトレースに出力される項目（Message Queueアダプタ）

項目

内容

番号

メソッドトレースの出力通番が表示されます。

日付

メソッドトレースの取得日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

メソッドトレースの取得時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

ローカル時刻でミリ秒単位の時刻を示します。

製品ID

製品を特定するための識別子として，Message Queueアダプタを示す「ADPMQ」が表示されます。

バージョン情報の形式は次のとおりです。

正規版製品：VV-RR

修正版製品：VV-RR-SS

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID

空白

種別

トレース取得ポイントの種別が出力されます。

BGN：メソッドの開始

END：メソッドの終了

CAL：メソッドの呼び出し

RET：メソッドの戻り

THR：例外のthrow

CTH：例外のcatch

クラス名

トレースを取得するクラス名が出力されます。

30文字未満の場合は左詰めされ，足りない文字はスペースで補われます。

メソッド名

トレースを取得するメソッド名

25文字未満の場合は左詰めされ，足りない文字はスペースで補われます。

RootAP情報

性能解析トレースに出力されるRootAPの情報であるIPアドレス・プロセスID・通信番号を「/（スラッシュ）」で区切った文字列が出力されます。

入出力情報

トレースを取得するメソッドの入出力情報（引数や戻り値の値など）が出力されます。

CRLF

レコード終端符号が出力されます。

(3)　データトレース

データトレースでは，Message Queueアダプタが送受信するメッセージ内容や入出力時刻を確認できます。データトレースは，ユーザがユーザデータの回復に使用するほか，保守員が障害解析のために使用します。

(a)　出力先

データトレースには送受信するユーザメッセージが出力されます。このため，データトレースにはセキュリティが確保された出力先を指定してください。

データトレースの出力先を次に示します。

<J2EEサーバのログ出力ディレクトリ>¥CSCADP¥MQADP¥maintenance¥<サービスID>

<J2EEサーバのログ出力ディレクトリ>は，HCSCサーバが動作するJ2EEサーバ用オプション定義ファイル（usrconf.cfg）のejb.server.log.directoryキーで指定します。詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」を参照してください。

データトレースのトレースファイル名を次に示します。

表7‒124　データトレースのトレースファイル名（Message Queueアダプタ）

トレースファイルの出力モード

トレースファイル名

ラップアラウンドモードの場合

dattrace<面数>.log

シフトモードの場合

dattrace.log

(b)　ファイル面数

出力ファイルの面数のデフォルトは4面です。面数はMessage Queueアダプタ実行環境プロパティファイルのdatatracefile.numキーで変更できます。

Message Queueアダプタ実行環境プロパティファイルについては，マニュアル「サービスプラットフォーム リファレンス」の「6.12.1　Message Queueアダプタ実行環境プロパティファイル」を参照してください。変更方法の詳細については，マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「3.3.9　Message Queueアダプタを定義する」のMessage Queueアダプタ実行環境プロパティファイルの作成に関する説明を参照してください。

(c)　ファイルサイズ

出力ファイルサイズのデフォルトは1MBです。出力ファイルサイズは，Message Queueアダプタ実行環境プロパティファイルのdatatracefile.sizeキーで変更できます。

Message Queueアダプタ実行環境プロパティファイルについては，マニュアル「サービスプラットフォーム リファレンス」の「6.12.1　Message Queueアダプタ実行環境プロパティファイル」を参照してください。変更方法の詳細は，マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「3.3.9　Message Queueアダプタを定義する」のMessage Queueアダプタ実行環境プロパティファイルの作成に関する説明を参照してください。

(d)　出力形式

データトレースの出力形式を次に示します。

図7‒115　データトレースの出力形式（Message Queueアダプタ）

(e)　出力される内容

データトレースに出力される内容を次の表に示します。

表7‒125　データトレースに出力される項目（Message Queueアダプタ）

項目

内容

番号

データトレースの出力通番が表示されます。

日付

データトレースの取得日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

データトレースの取得時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

ローカル時刻でミリ秒単位の時刻を示します。

製品ID

製品を特定するための識別子として，Message Queueアダプタを示す「ADPMQ」と，バージョン情報が表示されます。

バージョン情報の形式は次のとおりです。

正規版製品：VV-RR

修正版製品：VV-RR-SS

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID

空白

種別

データの入出力種別が出力されます。

REQ：要求電文

RSP：応答電文

FLT：Fault電文

INF：JMSヘッダ情報

ERR：送受信に失敗した要求/応答電文

スペース：継続データ

形式

データの形式が出力されます。

XML：XML形式

BINARY：バイナリ形式

6文字未満の場合は左詰めされ，足りない文字はスペースで補われます。

種別が「INF」の場合，スペース6文字が出力されます。

RootAP情報

性能解析トレースに出力されるRootAPの情報であるIPアドレス・プロセスID・通信番号を「/（スラッシュ）」で区切った文字列が出力されます。

電文情報

送受信電文情報が出力されます。

形式が「XML」の場合

XMLのテキストが出力されます。

形式が「BINARY」の場合

16進ダンプ形式が出力されます。

種別が「FLT」の場合

Fault情報の各要素に設定した内容を「要素名=設定値」の形式で出力します。各要素は「,（コンマ）」で区切って出力します。

種別が「INF」の場合

JMSヘッダ情報が出力されます。

CRLF

レコード終端符号が出力されます。

(f)　データトレースの取得ポイント

Message Queueアダプタのデータトレース取得ポイントでは，送受信する入出力メッセージやFault応答情報が出力されます。

図7‒116　データトレースの取得ポイント（正常完了）

図7‒117　データトレースの取得ポイント（Fault応答送信時）

図7‒118　データトレースの取得ポイント（メッセージ送信失敗）

図7‒119　データトレースの取得ポイント（メッセージ変換失敗）

(4)　性能解析トレース（PRFトレース）

サービスリクエスタから要求を受け付けて，実行結果を返却するまでの一連の処理で出力される性能解析情報を基に，アプリケーションサーバシステムの性能を検証できます。Message Queueアダプタの性能解析トレース取得ポイントでは，Message Queueアダプタ固有の情報が出力されます。情報は，保守員が性能ボトルネックの解析のために使用します。

(a)　出力先

性能解析トレースの出力先およびトレースファイル名を次に示します。

表7‒126　性能解析トレースの出力先およびトレースファイル名

トレースの出力先パス

トレースファイル名

<環境変数PRFSPOOLの設定ディレクトリ>¥utt¥prf¥<PRF識別子>¥dcopltrc※

prf_<n>

（凡例）

n：001からファイル面数の最大値までの整数が入ります。

注※

性能解析トレースの出力先は，アプリケーションサーバ全体で共通です。詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.3　Management Serverを利用した性能解析トレースファイルの収集」を参照してください。

(b)　ファイル面数

出力ファイル面数のデフォルトは4面です。出力ファイル面数は，運用管理ポータルまたはcprfstartコマンドで変更できます。運用管理ポータルの詳細は，マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」を参照してください。cprfstartコマンドの詳細はマニュアル「アプリケーションサーバ リファレンス コマンド編」を参照してください。

(c)　ファイルサイズ

性能解析トレース（PRFトレース）のファイルサイズのデフォルトは次のとおりです。

運用管理ポータルでファイルサイズを設定した場合：32MB

cprfstartコマンドでファイルサイズを設定した場合：8MB

ファイルサイズは，運用管理ポータルまたはcprfstartコマンドで変更できます。運用管理ポータルの詳細は，マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」を参照してください。cprfstartコマンドの詳細は，マニュアル「アプリケーションサーバ リファレンス コマンド編」を参照してください。

(d)　出力形式

性能解析トレースに出力される形式は，アプリケーションサーバの性能解析トレースと同様です。詳細については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.3　Management Serverを利用した性能解析トレースファイルの収集」を参照してください。

(e)　性能解析トレースの取得ポイント

Message Queueアダプタの性能解析トレース取得ポイントでは，Message Queueアダプタ固有の情報が出力されます。

Message Queueアダプタの性能解析トレース取得ポイントを次に示します。

図7‒120　性能解析トレースの取得ポイント（Message Queueアダプタ）

性能解析トレースの取得ポイントには，ポイント固有のイベントIDが割り当てられます。Message Queueアダプタで出力されるトレースのイベントIDは0xA200〜0xA2FFです。

イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。表の「図中の番号」は，上の図の番号と対応しています。

表7‒127　性能解析トレースの取得ポイント（Message Queueアダプタ）

イベントID

図中の番号

トレース取得ポイント

レベル

0xA200

1

リクエスト受付時

B

0xA202

2

メッセージ送信時

A

0xA203

3

メッセージ送信完了時

A

0xA204

4

メッセージ受信時

A

0xA205

5

メッセージ受信完了時

A

0xA201

6

レスポンス送信時

B

（凡例）

A：「標準」であることを示します。

B：「詳細」であることを示します。

PRFトレースの取得レベルを変更する場合，cprflevelコマンドの-PrfChangeLevelオプションに，4バイトの16進数（8桁）の値を2つ指定します。それぞれの16進数の値には，インデックス番号（インデックス1，インデックス2）が割り当てられています。cprflevelコマンドの指定方法については，マニュアル「アプリケーションサーバリファレンス コマンド編」の「cprflevel（PRFトレース取得レベルの表示と変更）」を参照してください。

性能解析トレースレベルの変更方法の詳細については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」を参照してください。デフォルトは「標準」です。

(5)　例外ログ

例外ログには例外情報が出力されます。例外ログの概要については，「7.4.7(1)　例外ログ」を参照してください。

(a)　出力先

例外ログの出力先を次に示します。

<J2EEサーバのログ出力ディレクトリ>¥CSCADP¥MQADP¥maintenance¥<サービスID>

<J2EEサーバのログ出力ディレクトリ>は，HCSCサーバが動作するJ2EEサーバ用オプション定義ファイル（usrconf.cfg）のejb.server.log.directoryキーで指定します。例外ログのログファイル名を次の表に示します。

表7‒128　例外ログのログファイル名（Message Queueアダプタ）

ログファイルの出力モード

ログファイル名

ラップアラウンドモードの場合

exception<面数>.log

シフトモードの場合

exception.log

(b)　ファイル面数

出力ファイルの面数のデフォルトは4面です。面数はMessage Queueアダプタ実行環境プロパティファイルのexptracefile.numキーで変更できます。

Message Queueアダプタ実行環境プロパティファイルについては，マニュアル「サービスプラットフォーム リファレンス」の「6.12.1　Message Queueアダプタ実行環境プロパティファイル」を参照してください。変更方法の詳細については，マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「3.3.9　Message Queueアダプタを定義する」のMessage Queueアダプタ実行環境プロパティファイルの作成に関する説明を参照してください。

(c)　ファイルサイズ

出力ファイルサイズのデフォルトは4MBです。ファイルサイズはMessage Queueアダプタ実行環境プロパティファイルのexptracefile.sizeキーで変更できます。

Message Queueアダプタ実行環境プロパティファイルについては，マニュアル「サービスプラットフォーム リファレンス」の「6.12.1　Message Queueアダプタ実行環境プロパティファイル」を参照してください。変更方法の詳細は，マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「3.3.9　Message Queueアダプタを定義する」のMessage Queueアダプタ実行環境プロパティファイルの作成に関する説明を参照してください。

(d)　出力形式

例外ログに出力される形式を次に示します。

図7‒121　例外ログに出力される形式

(e)　出力される内容

例外ログに出力される内容を次の表に示します。

表7‒129　例外ログに出力される項目（Message Queueアダプタ）

項目

内容

番号

例外ログの出力通番が表示されます。

日付

例外ログの取得日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

例外ログの取得時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

ローカル時刻でミリ秒単位の時刻を示します。

製品ID

製品を特定するための識別子として，Message Queueアダプタを示す「ADPMQ」が表示されます。

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID

空白

スタックトレース情報

スタックトレース情報が出力されます。

CRLF

レコード終端符号が出力されます。

(6)　Message Queueアダプタの障害情報

Message Queueアダプタは次の場合にエラー情報を使用して障害を通知します。

メッセージ受信要求に対してメッセージ受信応答監視時間のタイムアウトが発生した場合

ブラウズ・メッセージ受信要求に対してメッセージが受信キューに存在しなかった場合

エラー情報の各設定値を次の表に示します。

表7‒130　Message Queueアダプタが設定するエラー情報

要素名

型

設定値

説明

faultCode

String

Server

通信エラーなど，サーバ側のエラーです。

faultString

String

<Message Queueアダプタが出力するメッセージのメッセージテキスト>

詳細は，マニュアル「サービスプラットフォーム メッセージ」の「2.19　KDEH20000〜KDEH30999のメッセージ」を参照してください。

faultActor

String

<サービスアダプタ名>

エラー情報を通知したサービスアダプタ名です。

faultDetail

Document(XML)

Code:1

Message:"timeout"

メッセージ受信監視時間のタイムアウト発生，または受信するメッセージが存在しません。

(7)　Message Queueアダプタを設定する前の注意事項

Message Queueアダプタを設定する前の注意事項を次に示します。システムを運用する上で問題にならないか確認してください。問題がある場合は要因を取り除いてください。

Message Queueアダプタはビジネスプロセスからの要求ごとにコネクション解放処理を実行しますが，実際にはリソースアダプタのコネクションプール機能によって一定時間（デフォルトでは5分），リソースアダプタとIBM MQ間のコネクションは切断されません。

Connector属性ファイルの指定（デフォルトは切断しない）に依存します。

Message Queueアダプタのコネクション解放に失敗した場合，コネクション解放状態にはなりますが，接続先のJMSプロバイダシステムではコネクションの解放を検知していない場合があります。そのため，コネクション状態の不整合が発生し，その次の通信処理が失敗するおそれがあります。その場合，接続先JMSプロバイダシステムでコネクション確立状態を一度初期化してください。

Message Queueアダプタ運用中に障害が発生して正常に停止処理が実行されなかった場合，接続先JMSプロバイダシステムでコネクションの解放を検知していない場合があります。その場合は，接続先JMSプロバイダシステムでコネクション確立状態を一度初期化してください。

要求電文は1バイト以上を指定してください。長さ0バイトの要求電文を指定するとエラーになります。

Message Queueアダプタが送受信できるXML形式のユーザデータは，XML Processorの仕様に従います。詳細については，マニュアル「XML Processor ユーザーズガイド」のXML Processorのサポート範囲に関する内容を参照してください。

リソースアダプタで提供されるトランザクションサポートレベルは「LocalTransaction」または「XATransaction」を指定してください。ただし，「LocalTransaction」はビジネスプロセスでステータスの永続化をしない場合だけ指定できます。「NoTransaction」は指定できません。

「LocalTransaction」および「XATransaction」指定は，JTA（Java Transaction API）と関連を持つため，JTAのユーザ指定に影響されます。例えば，JTAのメッセージ受信監視時間がMessage Queueアダプタ通信構成定義ファイルのメッセージ受信応答監視時間（receive_timeout）より短い場合，JTAメッセージ受信監視時間でタイムアウトします。

(8)　エラー発生時の対処方法

メッセージ送信，メッセージ受信，ブラウズ・メッセージ受信またはメッセージ送受信要求が失敗した場合の対処方法を説明します。

メッセージ送信，メッセージ受信，ブラウズ・メッセージ受信またはメッセージ送受信要求が失敗した場合は，ビジネスプロセスを再実行する方法や失敗した途中から継続実行する方法などがあります。運用形態に合わせて対処方法を選択してください。

なお，ビジネスプロセスを再実行する場合は，送信キューおよび受信キューの状態および相手システム側の状態を含めて失敗した要求発行前の状態に戻してから対処してください。

(a)　メッセージ送信が失敗した場合の対処方法

メッセージ送信要求が失敗した場合は，メッセージログを確認し，メッセージKDEH30111-Eが出力されているか確認してください。その結果によって，要因と対処は次のように異なります。

確認結果

要因

対処

KDEH30111-Eが出力されている場合

メッセージ送信が失敗しています。

KDEH30111-Eメッセージの直前に出力されているメッセージを参照し，問題要因を取り除いて，メッセージ送信要求を再度実行してください。

メッセージ送信失敗のユーザデータを確認する場合は，データトレースを参照してください。

KDEH30111-Eが出力されていない場合

メッセージ送信が成功しているケースがあります。

送信キューにメッセージが格納されていることを確認してください。

(b)　メッセージ受信またはブラウズ・メッセージ受信が失敗した場合の対処方法

メッセージ受信またはブラウズ・メッセージ受信要求が失敗した場合は，メッセージログを確認し，メッセージKDEH30113-Eが出力されているか確認してください。その結果によって，要因と対処は次のように異なります。

確認結果

要因

対処

KDEH30113-Eが出力されている場合

メッセージは受信キューから取り出されています。

データトレースを参照してメッセージを取得し，受信キューに受信したメッセージが存在しないことを確認してください。

ブラウズ・メッセージ受信要求の場合，受信キューの確認は必要ありません。

KDEH30113-Eが出力されていない状態で，かつKDEHメッセージが出力されていない場合

メッセージは受信キューから取り出されています。

データトレースを参照してメッセージを取得し，受信キューに受信したメッセージが存在しないことを確認してください。

ブラウズ・メッセージ受信要求の場合，受信キューの確認は必要ありません。この場合，データトレースレベルを20にする必要があります。

KDEH30113-Eが出力されていない場合

メッセージ受信に失敗しています。

KDEH30111-Eが出力されていることを確認してください。

KDEH30111-Eメッセージの直前に出力されているメッセージを参照し，メッセージ受信失敗要因を取り除いてメッセージ受信要求を再度実行してください。

KDEH30103-Wが出力されている場合

受信キューにメッセージが存在しません。

運用形態に合わせて，メッセージ受信要求を再度実行してください。

(c)　メッセージ送受信が失敗した場合の対処方法

メッセージ送受信要求が失敗した場合は，メッセージ送信失敗とメッセージ受信失敗とで，要因と対処は次のように異なります。

メッセージ送信が失敗した場合

メッセージ送信要求が失敗した場合は，メッセージログを確認し，メッセージKDEH30111-Eが出力されているか確認してください。その結果によって，要因と対処は次のように異なります。

確認結果

要因

対処

KDEH30111-Eが出力されていて，かつ通信種別がsendの場合

メッセージ送信が失敗しています。

KDEH30111-Eメッセージの直前に出力されているメッセージを参照し，問題要因を取り除いて，メッセージ送信要求を再度実行してください。

メッセージ送信失敗のユーザデータを確認する場合は，データトレースを参照してください。

メッセージ受信が失敗した場合

メッセージ受信要求が失敗した場合は，メッセージログを確認し，メッセージKDEH30113-Eが出力されているか確認してください。その結果によって，要因と対処は次のように異なります。

確認結果

要因

対処

KDEH30113-Eが出力されている場合

メッセージ送信は成功し，メッセージは受信キューから取り出されています。

データトレースを参照して受信メッセージを取得し，受信キューに受信したメッセージが存在しないことを確認してください。

KDEH30113-Eが出力されていない状態で，かつKDEHメッセージが出力されていない場合

メッセージ送信は成功し，メッセージは受信キューから取り出されています。

データトレースを参照して受信メッセージを取得し，受信キューに受信したメッセージが存在しないことを確認してください。

この場合，データトレースレベルを20にする必要があります。

KDEH30113-Eが出力されていない場合

メッセージ送信は成功していますが，メッセージ受信に失敗しています。

KDEH30111-Eが出力され，通信種別がreceiveであることを確認してください。

メッセージ受信失敗要因を取り除いて，運用形態に合わせ再度メッセージ送受信要求を実行するか，メッセージ受信要求を実行してください。

KDEH30103-Wが出力されている場合

受信キューにメッセージが存在しません。メッセージ送信は成功しています。

運用形態に合わせて，メッセージ受信要求を再度実行してください。

7.7.11　FTP連携システムでの障害対策

この項では，FTP連携の運用時に発生する障害に対して取得できる情報の種類について説明します。

(1)　障害情報の取得（FTPインバウンドアダプタ）

FTPインバウンドアダプタに関する障害情報には次の種類があります。

メッセージログ※

保守用ログ※

プロトコルトレース※

転送履歴ログ※

リソースアダプタ間共通ログ※

運用コマンド実行時の保守用ログ

性能解析トレース

ここでは，これらの障害情報について説明します。

注※

これらのログについて，ファイル転送，またはFTPインバウンドアダプタの起動・停止を1回実行するときに必要なログファイルのサイズを次の表に示します。この表の値を参考にして，環境に応じて必要なログファイルサイズを算出してください。

表7‒131　必要なログファイルサイズ

ログの種類

1回のファイル転送に必要なログファイルサイズ

1回の起動・停止に必要なログファイルサイズ

メッセージログ

1.0KB

1.5KB

保守用ログ

0.5KB

0.5KB

プロトコルトレース

2.0KB

0.0KB

転送履歴ログ

0.5KB

0.0KB

リソースアダプタ間共通ログ

0.5KB

1.5KB

なお，FTPインバウンドアダプタでは，このマニュアルで説明する障害情報のほかに，FTPインバウンドアダプタが動作するJ2EEサーバおよびJavaVMが出力する資料があります。J2EEサーバおよびJavaVMが出力する資料については，マニュアル「アプリケーションサーバ機能解説 保守／移行編」の「4.　トラブルシューティングで必要な資料の出力先と出力方法」を参照してください。

(a)　メッセージログ（FTPインバウンドアダプタ）

メッセージログには，FTPインバウンドアダプタのエラー情報，および稼働情報を示すメッセージが出力されます。ここでは，FTPインバウンドアダプタでのメッセージログについて説明します。

●メッセージログの出力形式

メッセージログの出力形式を次に示します。

<日付> <時刻> <pid> <tid> <転送ID> <メッセージID> <メッセージテキスト>

●出力される内容

メッセージログに出力される内容を次の表に示します。

表7‒132　メッセージログに出力される内容（FTPインバウンドアダプタ）

項目

内容

日付

メッセージログの取得日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

メッセージログの取得時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

転送ID

転送IDが出力されます。

メッセージID

メッセージIDが出力されます。

メッセージテキスト

メッセージの内容が出力されます。

●メッセージログの出力先

<J2EEサーバのログ出力ディレクトリ>¥csc¥inbound-adapter¥ftp¥FTP_Inbound_Resource_Adapter

<J2EEサーバのログ出力ディレクトリ>は，usrconf.cfg（J2EEサーバ用オプション定義ファイル）のejb.server.log.directoryキーで変更できます。デフォルトは，<サービスプラットフォームのインストールディレクトリ>¥ejb¥<サーバ名称>¥logsです。usrconf.cfgの詳細は，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.2　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。

メッセージログのログファイル名を次の表に示します。

表7‒133　メッセージログのログファイル名（FTPインバウンドアダプタ）

ファイルの種類

ログファイル名

現用ファイル

message.log

バックアップファイル※

message<面数>.log

注※

現用ファイルのサイズが1面当たりのファイルサイズを超えた場合，バックアップファイルにリネームされます。

バックアップファイル名には，バックアップファイルの面数が含まれます。新しいログファイルの方が大きい番号となります。一度作成されたログファイルは削除されません。なお，ファイルの改行コードは「LF」です。

メッセージログの出力レベル，ファイルのサイズ，およびファイル面数は，RARファイルの属性を設定するConnector属性ファイルで変更できます。プロパティを次に示します。

server_message_logLevel=メッセージログの出力レベル

server_message_maxFileSize=メッセージログのファイルサイズ

server_message_maxBackupIndex=バックアップファイルの面数

設定手順については，「3.2.3(3)　FTPインバウンドアダプタの設定」を参照してください。

(b)　保守用ログ（FTPインバウンドアダプタ）

保守用ログには，FTPインバウンドアダプタでのエラー発生時のログが出力されます。このログは，保守員に連絡するときに必要です。ここでは，FTPインバウンドアダプタでの保守用ログについて説明します。

●保守用ログの出力形式

保守用ログの出力形式を次に示します。

<日付> <時刻> <pid> <tid> <保守情報>

●出力される内容

保守用ログに出力される内容を次の表に示します。

表7‒134　保守用ログに出力される内容（FTPインバウンドアダプタ）

項目

内容

日付

保守用ログの取得日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

保守用ログの取得時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

pid

プロセスを識別するためのIDが出力されます。OSが管理するプロセスIDとは異なります。

tid

スレッドを識別するためのIDが出力されます。OSが管理するスレッドIDとは異なります。

保守情報

システム管理者または保守員に連絡するときに必要な保守情報が出力されます。

●保守用ログの出力先

<J2EEサーバのログ出力ディレクトリ>¥csc¥inbound-adapter¥ftp¥FTP_Inbound_Resource_Adapter

<J2EEサーバのログ出力ディレクトリ>は，usrconf.cfg（J2EEサーバ用オプション定義ファイル）のejb.server.log.directoryキーで変更できます。デフォルトは，<サービスプラットフォームのインストールディレクトリ>¥ejb¥<サーバ名称>¥logsです。usrconf.cfgの詳細は，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.2　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。

保守用ログのログファイル名を次の表に示します。

表7‒135　保守用ログのログファイル名（FTPインバウンドアダプタ）

ファイルの種類

ログファイル名

現用ファイル

maintenance.log

バックアップファイル※

maintenance<面数>.log

注※

現用ファイルのサイズが1面当たりのファイルサイズを超えた場合，バックアップファイルにリネームされます。

バックアップファイル名には，バックアップファイルの面数が含まれます。新しいログファイルの方が大きい番号となります。一度作成されたログファイルは削除されません。なお，ファイルの改行コードは「LF」です。

保守用ログの出力レベル，ファイルのサイズ，およびファイル面数は，RARファイルの属性を設定するConnector属性ファイルで変更できます。プロパティを次に示します。

server_maintenance_logLevel=保守用ログの出力レベル

server_maintenance_maxFileSize=保守用ログのファイルサイズ

server_maintenance_maxBackupIndex=バックアップファイルの面数

設定手順については，「3.2.3(3)　FTPインバウンドアダプタの設定」を参照してください。

(c)　FTPプロトコルトレース（FTPインバウンドアダプタ）

FTPプロトコルトレースでは，FTPクライアントと送受信を行ったFTPプロトコルメッセージのトレースが出力されます。ここでは，FTPインバウンドアダプタでのFTPプロトコルトレースについて説明します。

●FTPプロトコルトレースの出力形式

FTPプロトコルトレースの出力形式を次に示します。

<日付> <時刻> <pid> <tid> <転送ID> <送受信方向> <プロトコルメッセージ>

●出力される内容

FTPプロトコルトレースに出力される内容を次の表に示します。

表7‒136　FTPプロトコルトレースに出力される内容（FTPインバウンドアダプタ）

項目

内容

日付

プロトコルメッセージの送受信日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

プロトコルメッセージの送受信時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

転送ID※

転送IDが出力されます。ただし，最初のコネクション接続時のトレースには出力されません。

送受信方向

プロトコルメッセージの送受信方向が出力されます。

--->：FTPクライアントから受信した場合

<---：FTPクライアントへ送信した場合

プロトコルメッセージ

プロトコルメッセージの内容が出力されます。

PASSコマンドの引数であるパスワードの文字列がFTPプロトコルトレースに出力される場合，パスワードの文字列の代わりに「*****」が表示されます。

注※

転送IDが出力されているレコードから，該当する処理スレッド（tid）がわかります。tidを検索することで，転送処理に対する一連のFTPプロトコルトレースを参照できます。

●FTPプロトコルトレースの出力先

<J2EEサーバのログ出力ディレクトリ>¥csc¥inbound-adapter¥ftp¥FTP_Inbound_Resource_Adapter

<J2EEサーバのログ出力ディレクトリ>は，usrconf.cfg（J2EEサーバ用オプション定義ファイル）のejb.server.log.directoryキーで変更できます。デフォルトは，<サービスプラットフォームのインストールディレクトリ>¥ejb¥<サーバ名称>¥logsです。usrconf.cfgの詳細は，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.2　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。

FTPプロトコルトレースのトレースファイル名を次の表に示します。

表7‒137　FTPプロトコルトレースのファイル名（FTPインバウンドアダプタ）

ファイルの種類

トレースファイル名

現用ファイル

protocol.log

バックアップファイル※

protocol<面数>.log

注※

現用ファイルのサイズが1面当たりのファイルサイズを超えた場合，バックアップファイルにリネームされます。

バックアップファイル名には，バックアップファイルの面数が含まれます。新しいログファイルの方が大きい番号となります。一度作成されたログファイルは削除されません。なお，ファイルの改行コードは「LF」です。

FTPプロトコルトレースの出力レベル，ファイルのサイズ，およびファイル面数は，RARファイルの属性を設定するConnector属性ファイルで変更できます。プロパティを次に示します。

server_protocol_logLevel=FTPプロトコルトレースの出力レベル

server_protocol_maxFileSize=FTPプロトコルトレースのファイルサイズ

server_protocol_maxBackupIndex=バックアップファイルの面数

設定手順については，「3.2.3(3)　FTPインバウンドアダプタの設定」を参照してください。

●FTPプロトコルトレースの出力例

RETRコマンドを実行して，サーバからファイルを取得する場合のFTPプロトコルトレースの出力例を次に示します。

2010/10/29 21:50:15.346    <pid>    <tid>                     ---> connection from 10.209.12.244
2010/10/29 21:50:15.346    <pid>    <tid> <転送ID>            ---> OPENED
2010/10/29 21:50:15.346    <pid>    <tid> <転送ID>            <--- 220 Service ready for new user.
2010/10/29 21:50:15.346    <pid>    <tid> <転送ID>            ---> USER admin
2010/10/29 21:50:15.346    <pid>    <tid> <転送ID>            <--- 331 User name okay, need password for admin.
2010/10/29 21:50:15.346    <pid>    <tid> <転送ID>            ---> PASS *****
2010/10/29 21:50:15.346    <pid>    <tid> <転送ID>            <--- 230 User logged in, proceed.
2010/10/29 21:50:15.346    <pid>    <tid> <転送ID>            ---> TYPE A
2010/10/29 21:50:15.346    <pid>    <tid> <転送ID>            <--- 200 Command TYPE okay.
2010/10/29 21:50:15.346    <pid>    <tid> <転送ID>            ---> PORT 10,209,12,244,17,28
2010/10/29 21:50:15.346    <pid>    <tid> <転送ID>            <--- 200 Command PORT okay.
2010/10/29 21:50:15.346    <pid>    <tid> <転送ID>            ---> RETR /sample1/hoge.txt
2010/10/29 21:50:15.361    <pid>    <tid> <転送ID>            <--- 150 Opening ASCII mode data connection for /sample1/hoge.txt.
2010/10/29 21:50:15.533    <pid>    <tid> <転送ID>            <--- 226 Transfer Complete.
2010/10/29 21:50:15.533    <pid>    <tid> <転送ID>            ---> QUIT
2010/10/29 21:50:15.533    <pid>    <tid> <転送ID>            <--- 221 Goodbye.
2010/10/29 21:50:15.533    <pid>    <tid> <転送ID>            ---> CLOSED

(d)　転送履歴ログ（FTPインバウンドアダプタ）

転送履歴ログには，FTP連携システムでの転送履歴が次の個所に出力されます。

<J2EEサーバのログ出力ディレクトリ>¥csc¥inbound-adapter¥ftp¥FTP_Inbound_Resource_Adapter

<J2EEサーバのログ出力ディレクトリ>は，usrconf.cfg（J2EEサーバ用オプション定義ファイル）のejb.server.log.directoryキーで変更できます。デフォルトは，<サービスプラットフォームのインストールディレクトリ>¥ejb¥<サーバ名称>¥logsです。usrconf.cfgの詳細は，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.2　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。

転送履歴ログのログファイル名を次の表に示します。

表7‒138　転送履歴ログのファイル名（FTPインバウンドアダプタ）

ファイルの種類

ログファイル名

現用ファイル

history.log

バックアップファイル※

history<面数>.log

注※

現用ファイルのサイズが1面当たりのファイルサイズを超えた場合，バックアップファイルにリネームされます。

バックアップファイル名には，バックアップファイルの面数が含まれます。新しいログファイルの方が大きい番号となります。一度作成されたログファイルは削除されません。なお，ファイルの改行コードは「LF」です。

転送履歴ログの出力レベル，ファイルのサイズ，およびファイル面数は，RARファイルの属性を設定するConnector属性ファイルで変更できます。プロパティを次に示します。

server_history_logLevel=転送履歴ログの出力レベル

server_history_maxFileSize=転送履歴ログのファイルサイズ

server_history_maxBackupIndex=バックアップファイルの面数

設定手順については，「3.2.3(3)　FTPインバウンドアダプタの設定」を参照してください。

(e)　リソースアダプタ間共通ログ（FTPインバウンドアダプタ）

リソースアダプタ間共通ログには，FTPインバウンドアダプタの起動を開始してからリソースアダプタ名称が決まるまでの処理，ネットワーク制御やログ出力などの処理に関する情報が出力されます。ここでは，FTPインバウンドアダプタでのリソースアダプタ間共通ログについて説明します。

●リソースアダプタ間共通ログの出力形式と出力される内容

リソースアダプタ間共通ログは，メッセージと保守情報として出力されます。

出力形式

リソースアダプタ間共通ログの出力形式を次に示します。

メッセージの場合

<日付> <時刻> <pid> <tid> <転送ID> <メッセージID> <メッセージテキスト>

保守情報の場合

<日付> <時刻> <pid> <tid> <保守情報>

出力される内容

リソースアダプタ間共通ログに出力される内容を次の表に示します。

メッセージの場合

表7‒139　リソースアダプタ間共通ログに出力される内容（FTPインバウンドアダプタ）（メッセージの場合）

項目

内容

日付

リソースアダプタ間共通ログの取得日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

リソースアダプタ間共通ログの取得時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

転送ID

転送IDが出力されます。

メッセージID

メッセージIDが出力されます。

メッセージテキスト

メッセージの内容が出力されます。

保守情報の場合

表7‒140　リソースアダプタ間共通ログに出力される内容（FTPインバウンドアダプタ）（保守情報の場合）

項目

内容

日付

リソースアダプタ間共通ログの取得日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

リソースアダプタ間共通ログの取得時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

保守情報

システム管理者または保守員に連絡するときに必要な保守情報が出力されます。

●リソースアダプタ間共通ログの出力先

<J2EEサーバのログ出力ディレクトリ>¥csc¥inbound-adapter¥ftp¥common

<J2EEサーバのログ出力ディレクトリ>は，usrconf.cfg（J2EEサーバ用オプション定義ファイル）のejb.server.log.directoryキーで変更できます。デフォルトは，<サービスプラットフォームのインストールディレクトリ>¥ejb¥<サーバ名称>¥logsです。usrconf.cfgの詳細は，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.2　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。

リソースアダプタ間共通ログのログファイル名を次の表に示します。

表7‒141　リソースアダプタ間共通ログのファイル名（FTPインバウンドアダプタ）

ファイルの種類

ログファイル名

現用ファイル

ftpd.log

バックアップファイル※

ftpd<面数>.log

注※

現用ファイルのサイズが1面当たりのファイルサイズを超えた場合，バックアップファイルにリネームされます。

バックアップファイル名には，バックアップファイルの面数が含まれます。新しいログファイルの方が大きい番号となります。一度作成されたログファイルは削除されません。なお，ファイルの改行コードは「LF」です。

リソースアダプタ間共通ログの出力レベル，ファイルのサイズ，およびファイル面数は，RARファイルの属性を設定するConnector属性ファイルで変更できます。プロパティを次に示します。

server_common_logLevel=リソースアダプタ間共通ログの出力レベル

server_common_maxFileSize=リソースアダプタ間共通ログのファイルサイズ

server_common_maxBackupIndex=バックアップファイルの面数

設定手順については，「3.2.3(3)　FTPインバウンドアダプタの設定」を参照してください。

(f)　運用コマンド実行時の保守用ログ（FTPインバウンドアダプタ）

運用コマンド実行時の保守用ログには，運用コマンドでのエラー発生時のログが出力されます。このログは，保守員に連絡するときに必要です。

●運用コマンド実行時の保守用ログの出力先

<サービスプラットフォームのインストールディレクトリ>¥CSC¥inbound-adapter¥ftp¥logs¥FTP_Inbound_Resource_Adapter

運用コマンド実行時のログの出力先を変更する場合は，環境変数（CSCFTP_CMD_LOG）に，変更後の出力先ディレクトリをフルパスで指定します。指定したパスが存在しない場合は，運用コマンド実行時にディレクトリが作成されます。環境変数が設定されていない場合，または環境変数の値として空文字を指定した場合，デフォルトの出力先に出力されます。

環境変数CSCFTP_CMD_LOGを指定した場合のログの出力先

<環境変数CSCFTP_CMD_LOGの指定値>¥logs¥FTP_Inbound_Resource_Adapter

環境変数（CSCFTP_CMD_LOG）に指定できるパスは，次の条件を満たしている必要があります。

「//」，「/./」，または「/../」を含まないこと

半角英数字，半角スペース，ファイルセパレータ（「¥」または「/」），および「:」を使用していること

パスの長さが128バイト（半角文字で128文字）以内であること

なお，Linuxの場合，ディレクトリのパスにスペースを含むときは，パスをダブルクォーテーション（"）で囲む必要があります。

●運用コマンド実行時の保守用ログのログファイル名

運用コマンド実行時の保守用ログのログファイル名を次の表に示します。なお，これらの保守用ログの最大ファイルサイズと最大ファイル面数は次の値に固定されていて，変更はできません。

表7‒142　運用コマンド実行時の保守用ログのファイル名（FTPインバウンドアダプタ）

ファイルの種類

ログファイル名

最大ファイルサイズ

最大ファイル面数

メッセージログ

現用ファイル

message.log

バックアップファイル※

message<面数>.log

5MB

7

メンテナンスログ

現用ファイル

maintenance.log

バックアップファイル※

maintenance<面数>.log

共通ログ

現用ファイル

ftpd.log

バックアップファイル※

ftpd<面数>.log

注※

現用ファイルのサイズが1面当たりのファイルサイズを超えた場合，バックアップファイルにリネームされます。

バックアップファイル名には，バックアップファイルの面数が含まれます。新しいログファイルの方が大きい番号となります。一度作成されたログファイルは削除されません。なお，ファイルの改行コードは「LF」です。

(g)　性能解析トレース（FTPインバウンドアダプタ）

FTPインバウンドアダプタでの性能解析トレースについて説明します。

●性能解析トレースの出力形式

性能解析トレースファイルに出力される形式は，J2EEサーバの性能解析トレースと同様です。詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.3　Management Serverを利用した性能解析トレースファイルの収集」を参照してください。

●出力される内容

性能解析トレースファイルに出力される内容を次の表に示します。

表7‒143　性能解析トレースファイルに出力される内容（FTPインバウンドアダプタ）

項目

内容

イベントID

取得ポイントのイベントIDが出力されます。

取得ポイントの詳細は，項目「性能解析トレースの取得ポイント」を参照してください。

リターンコード

取得ポイント種別が出力されます。

0：正常終了

1：異常終了

インターフェース名

クラス名が出力されます。

オペレーション名

メソッド名が出力されます。

オプション情報

保守情報が出力されます。取得ポイントによっては出力されないこともあります。

●性能解析トレースの取得ポイント

性能解析トレースの取得ポイントを次の図に示します。

図7‒122　性能解析トレースの取得ポイント（FTPインバウンドアダプタ）

イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。表の「図中の番号」は上の図の番号と対応しています。

表7‒144　性能解析トレースの取得ポイント（FTPインバウンドアダプタ）

イベントID

図中の番号

トレース取得ポイント

レベル

0x9950

1

FTPクライアントから新規にリクエストを受信した個所

A

0x9951

2

FTPクライアントからの一連のリクエストが完了し，セッションを完了する個所

A

0x9952

3

転送リクエストを受信し，FTP受付への振り分けを依頼する個所の前

A

0x9953

4

転送リクエストを受信し，FTP受付への振り分けを依頼する個所のあと

A

0x9954

5

FTP受付で実行される転送処理の個所の前

A

0x9956

FTP受付で実行されるリストデータ転送処理の個所の前

A

0x9955

6

FTP受付で実行される転送処理の個所のあと

A

0x9957

FTP受付で実行されるリストデータ転送処理の個所のあと

A

（凡例）

A：「標準」であることを示します。

●性能解析トレースの取得方法と出力先

性能解析トレースを取得するには設定が必要です。設定の詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.　性能解析トレースを使用した性能解析」を参照してください。

(2)　障害情報の取得（FTPアダプタ）

FTPアダプタに関する障害情報には次の種類があります。

メッセージログ

保守用ログ

性能解析トレース

FTPプロトコルトレース

例外ログ

FTPコマンドメッセージログ

ここでは，これらの障害情報について説明します。

(a)　メッセージログ（FTPアダプタ）

メッセージログについては，「7.4.1　メッセージログ」を参照してください。

(b)　保守用ログ（FTPアダプタ）

FTPアダプタでの保守用ログについて説明します。

●保守用ログの出力形式

保守用ログの出力形式を次の図に示します。

図7‒123　保守用ログの出力形式（FTPアダプタ）

●出力される内容

保守用ログに出力される内容を次の表に示します。

表7‒145　保守用ログに出力される内容（FTPアダプタ）

項目

内容

番号

保守用ログの出力通番が表示されます。

日付

保守用ログの取得日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

保守用ログの取得時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

製品ID

製品を特定するための識別子として，FTPアダプタを示す「FTPADP」が出力されます。また，バージョン情報が出力されます。

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID，種別

表示されません。

出力種別

保守用ログの取得ポイント情報（取得位置）が出力されます。

BGN：メソッドの開始

END：メソッドの終了

CAL：メソッドの呼び出し

RET：メソッドの戻り

THR：例外のスロー

CTH：例外のキャッチ

クラス名

保守用ログを取得するクラス名が出力されます。

メソッド名

保守用ログを取得するメソッド名が出力されます。

入出力情報

保守用ログを取得するメソッドの入出力情報（引数の値，戻り値，例外名など）が出力されます。

CRLF

レコードの終端符号が出力されます。

●保守用ログの出力先

<FTPアダプタ実行環境プロパティファイルのftpadp.methodtrace.filepathプロパティで指定したパス>¥<サービスID>

保守用ログのログファイル名を次の表に示します。

表7‒146　保守用ログのファイル名（FTPアダプタ）

ログファイルの出力モード

ログファイル名

ラップアラウンドモードの場合

cscftpadpmtd_<HCSCサーバ名>_<面数>.log

シフトモードの場合

cscftpadpmtd_<HCSCサーバ名>_.log

なお，ログファイルの面数は，FTPアダプタ実行環境プロパティファイルのftpadp.methodtrace.filenumプロパティで指定します。ログファイルのサイズは，FTPアダプタ実行環境プロパティファイルのftpadp.methodtrace.filesizeプロパティで指定します。

FTPアダプタ実行環境プロパティファイルの詳細は，マニュアル「サービスプラットフォーム リファレンス」の「6.8.3　FTPアダプタ実行環境プロパティファイル」を参照してください。

(c)　性能解析トレース（FTPアダプタ）

FTPアダプタでの性能解析トレースについて説明します。

●性能解析トレースの出力形式

性能解析トレースファイルに出力される形式は，J2EEサーバの性能解析トレースと同様です。詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.3　Management Serverを利用した性能解析トレースファイルの収集」を参照してください。

●出力される内容

性能解析トレースファイルに出力される内容を次の表に示します。

表7‒147　性能解析トレースファイルに出力される内容（FTPアダプタ）

項目

内容

イベントID

取得ポイントのイベントIDが出力されます。

取得ポイントの詳細は，項目「性能解析トレースの取得ポイント」を参照してください。

リターンコード

取得ポイント種別が出力されます。

0：正常終了

1：異常終了

インターフェース名

クラス名が出力されます。

オペレーション名

メソッド名が出力されます。

オプション情報

サービスID

HCSCコンポーネントのサービスIDが出力されます。

オペレーション

次のどれかが出力されます。

PUT

MPUT

GET

MGET

GETINFO

LOGIN

LOGOUT

RENAME

FTPコマンド名

STOR，APPE，RETR，LIST，NLST，TYPE，RNFR，RNTOなどが出力されます。

転送ファイル名またはパス

FTPコマンド名がSTORまたはAPPEの場合は，ローカルファイル名が出力されます。

FTPコマンド名がRETRの場合は，リモートファイル名が出力されます。

FTPコマンド名がLIST，NLST，RNFR，またはRNTOの場合は，リモートパスが出力されます。

転送サイズ

転送ファイルのサイズまたはリストデータのサイズがバイト単位で出力されます。

任意時刻からのナノ秒

java.lang.SystemクラスのnanoTimeメソッドの戻り値が出力されます。

例外クラス名

例外が発生したクラス名が出力されます。

●性能解析トレースの取得ポイント

性能解析トレースの取得ポイントを次の図に示します。

図7‒124　性能解析トレースの取得ポイント（FTPアダプタ）

イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。表の「図中の番号」は上の図の番号と対応しています。

表7‒148　性能解析トレースの取得ポイント（FTPアダプタ）

イベントID

図中の番号

トレース取得ポイント

レベル

0xAB00

1

リクエスト受付時

B

0xAB02

2

転送またはリスト以外のFTPコマンド実行時

A

0xAB03

3

転送またはリスト以外のFTPコマンドリプライ時

A

0xAB04

4

転送コマンド，リストコマンド，またはファイルのリネームコマンド（STOR，APPE，RETR，LIST，NLST，RNFR，またはRNTO）実行時

A

0xAB05

5

転送コマンド，リストコマンド，またはファイルのリネームコマンド（STOR，APPE，RETR，LIST，NLST，RNFR，またはRNTO）リプライ時

A

0xAB01

6

レスポンス送信時

B

（凡例）

A：「標準」であることを示します。

B：「詳細」であることを示します。

●性能解析トレースの取得方法と出力先

性能解析トレースを取得するには設定が必要です。設定の詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.　性能解析トレースを使用した性能解析」を参照してください。

(d)　FTPプロトコルトレース（FTPアダプタ）

FTPアダプタでのFTPプロトコルトレースについて説明します。

●FTPプロトコルトレースの出力形式

FTPプロトコルトレースの出力形式を次の図に示します。

図7‒125　FTPプロトコルトレースの出力形式（FTPアダプタ）

●出力される内容

FTPプロトコルトレースに出力される内容を次の表に示します。

表7‒149　FTPプロトコルトレースに出力される内容（FTPアダプタ）

項目

内容

番号

FTPプロトコルトレースの出力通番が出力されます。

日付

FTPプロトコルトレースの取得日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

FTPプロトコルトレースの取得時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

製品ID

製品を特定するための識別子として，FTPアダプタを示す「FTPADP」が出力されます。また，バージョン情報が出力されます。

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID

出力されません。

種別

FTPプロトコルトレースの種別が出力されます。

CMD：コマンド実行

REP：応答行

リクエストID

受付で作成されたリクエストIDが出力されます。次の場合は「****」が出力されます。

リクエストIDが存在しない場合（共通フォルダ使用の場合）

RENAMEオペレーションを使用する場合

IPv4でリクエストIDが作成された場合は最大49桁で出力され，リクエストIDの右側に足りない分の半角スペースが設定されます。

トレース情報

種別がCMDの場合，FTPコマンド名が出力されます。

種別がREPの場合，コマンドメッセージが出力されます。

CRLF

レコードの終端符号が出力されます。

●FTPプロトコルトレースの出力先

<J2EEサーバのログ出力ディレクトリ>¥CSCADP¥FTPADP¥<サービスID>

FTPプロトコルトレースのトレースファイル名を次の表に示します。

表7‒150　FTPプロトコルトレースのトレースファイル名（FTPアダプタ）

トレースファイルの出力モード

トレースファイル名

ラップアラウンドモードの場合

ftpprotocoltrace_<面数>.log

シフトモードの場合

ftpprotocoltrace_.log

<J2EEサーバのログ出力ディレクトリ>は，HCSCサーバが動作するJ2EEサーバ用オプション定義ファイル（usrconf.cfg）のejb.server.log.directoryキーで指定します。usrconf.cfgの詳細は，マニュアル「アプリケーションサーバリファレンス 定義編(サーバ定義)」の「2.2.2　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。

なお，ログファイルの面数は，FTPアダプタ実行環境プロパティファイルのftpadp.ftpprotocoltrace.filenumプロパティで指定します。ログファイルのサイズは，FTPアダプタ実行環境プロパティファイルのftpadp.ftpprotocoltrace.filesizeプロパティで指定します。

詳細は，マニュアル「サービスプラットフォーム リファレンス」の「6.8.3　FTPアダプタ実行環境プロパティファイル」を参照してください。

●FTPプロトコルトレースの出力例

FTPアダプタでのFTPプロトコルトレースの出力例を次に示します。

CMD RCP01---0102000300000420100602144121012000/HCSC Connected to 10.208.180.254.
REP RCP01---0102000300000420100602144121012000/HCSC 220 (vsFTPd 2.0.1)
CMD RCP01---0102000300000420100602144121012000/HCSC USER user1
REP RCP01---0102000300000420100602144121012000/HCSC 331 Please specify the password.
CMD RCP01---0102000300000420100602144121012000/HCSC PASS ********
REP RCP01---0102000300000420100602144121012000/HCSC 230 Login successful.
CMD RCP01---0102000300000420100602144121012000/HCSC TYPE I
REP RCP01---0102000300000420100602144121012000/HCSC 200 Switching to Binary mode.
CMD RCP01---0102000300000420100602144121012000/HCSC PORT 10,210,182,27,8,173
REP RCP01---0102000300000420100602144121012000/HCSC 200 PORT command successful. Consider using PASV.
CMD RCP01---0102000300000420100602144121012000/HCSC STOR test.txt
REP RCP01---0102000300000420100602144121012000/HCSC 150 Ok to send data.
REP RCP01---0102000300000420100602144121012000/HCSC 226 File receive OK.
CMD RCP01---0102000300000420100602144121012000/HCSC QUIT
REP RCP01---0102000300000420100602144121012000/HCSC 221 Goodbye.

(e)　例外ログ（FTPアダプタ）

トレースの開始以降に発生した例外情報（スタックトレース）を例外ログとして別のファイルに出力します。例外ログでは，出力ファイルのパスと出力レベルは設定しないで，出力ファイルのサイズと面数を設定します。また，例外ログファイルは保守用ログと同じディレクトリに出力されます。

FTPアダプタの例外ログについて説明します。

●例外ログの出力形式

例外ログの出力形式を次の図に示します。

図7‒126　例外ログの出力形式（FTPアダプタ）

●出力される内容

例外ログに出力される内容を次の表に示します。

表7‒151　例外ログに出力される内容（FTPアダプタ）

項目

内容

番号

例外ログの出力通番が表示されます。

日付

例外ログの取得日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

例外ログの取得時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

製品ID

製品を特定するための識別子として，FTPアダプタを示す「FTPADP」が出力されます。

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID

空白

スタックトレース情報

スタックトレース情報が出力されます。

CRLF

レコードの終端符号が出力されます。

●例外ログの出力先

例外ログの出力先を次に示します。保守用ログと同じパスです。

<FTPアダプタ実行環境プロパティファイルのftpadp.methodtrace.filepathプロパティで指定したパス>¥<サービスID>

例外ログのログファイル名を次の表に示します。

表7‒152　例外ログのログファイル名（FTPアダプタ）

ログファイルの出力モード

ログファイル名

ラップアラウンドモードの場合

cscftpadpexp_<HCSCサーバ名>_<面数>.log

シフトモードの場合

cscftpadpexp_<HCSCサーバ名>_.log

なお，ログファイルの面数は，FTPアダプタ実行環境プロパティファイルのftpadp.exptrace.filenumプロパティで指定します。ログファイルのサイズは，FTPアダプタ実行環境プロパティファイルのftpadp.exptrace.filesizeプロパティで指定します。

FTPアダプタ実行環境プロパティファイルの詳細は，マニュアル「サービスプラットフォーム リファレンス」の「6.8.3　FTPアダプタ実行環境プロパティファイル」を参照してください。

(f)　FTPコマンドメッセージログ（FTPアダプタ）

FTPアダプタでのFTPコマンドメッセージログについて説明します。

FTPアダプタでのcscpasswdコマンドの開始時，停止時のインフォメーション情報や，コマンド実行中に障害などが発生した場合のエラーメッセージは，ログファイルとしてFTPコマンドメッセージログに出力されます。FTPコマンドメッセージログを参照することで，過去に実行したコマンドの障害情報や稼働情報を確認できます。

●FTPコマンドメッセージログの出力形式

FTPコマンドメッセージログの出力形式を次の図に示します。

図7‒127　FTPコマンドメッセージログの出力形式（FTPアダプタ）

●出力される内容

FTPコマンドメッセージログに出力される内容を次の表に示します。

表7‒153　FTPコマンドメッセージログに出力される内容（FTPアダプタ）

項目

内容

番号

コマンドメッセージログの出力通番が表示されます。

日付

コマンドメッセージログの取得日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

コマンドメッセージログの取得時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

製品ID

製品を特定するための識別子として，FTPアダプタを示す「FTPADP」の後ろに，実行したコマンドの名前を示す「add」，「del」または「ls」が出力されます。

FTPADP:add

FTPADP:del

FTPADP:ls

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

メッセージID

メッセージIDが「KDEKnnnnn-X」の形式で出力されます。

メッセージテキスト

メッセージの内容が出力されます。

CRLF

レコードの終端符号が出力されます。

●FTPコマンドメッセージログの出力先

FTPコマンドメッセージログの出力先およびログファイル名を次に示します。

<FTPアダプタコマンド定義ファイルのftpadp.command.messagelog.filepathキーに指定されたパス>¥message<面数>.log

なお，ログファイルの面数は，FTPアダプタコマンド定義ファイルのftpadp.command.messagelog.filenumキーで指定します。ログファイルのサイズは，FTPアダプタコマンド定義ファイルのftpadp.command.messagelog.filesizeキーで指定します。

(3)　障害情報の取得（ファイル操作アダプタ）

ファイル操作アダプタに関する障害情報には次の種類があります。

メッセージログ

保守用ログ

性能解析トレース

例外ログ

ここでは，これらの障害情報について説明します。

(a)　メッセージログ（ファイル操作アダプタ）

ファイル操作アダプタでのメッセージログについて説明します。

●メッセージログの出力形式

メッセージログの出力形式を次の図に示します。

図7‒128　メッセージログの出力形式（ファイル操作アダプタ）

●出力される内容

メッセージログに出力される内容を次の表に示します。

表7‒154　メッセージログに出力される内容（ファイル操作アダプタ）

項目

内容

番号

メッセージログの出力通番が表示されます。

日付

メッセージログの取得日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

メッセージログの取得時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

製品ID

製品を特定するための識別子として，Component Containerを示す「HEJB」が出力されます。

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

メッセージID

メッセージIDが「KDECnnnnn-X」の形式で出力されます。

メッセージテキスト

メッセージの内容が出力されます。

CRLF

レコードの終端符号が出力されます。

●メッセージログの出力先

J2EEサーバの稼働ログの出力先に指定されたパスに出力されます。

J2EEサーバの稼働ログの出力先は，usrconf.cfg（J2EEサーバ用オプション定義ファイル）のejb.server.log.directoryキーで指定します。デフォルトの出力先は，<サービスプラットフォームのインストールディレクトリ>¥CC¥server¥public¥ejb¥<J2EEサーバ名>¥logsです。usrconf.cfgの詳細は，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.2　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。

メッセージログのログファイル名を次の表に示します。

表7‒155　メッセージログのログファイル名（ファイル操作アダプタ）

ログファイルの出力モード

ログファイル名

ラップアラウンドモードの場合

cjmessage<面数>.log

シフトモードの場合

cjmessage.log

なお，ログファイルの面数は，HCSCサーバが動作するJ2EEサーバ用ユーザプロパティファイル（usrconf.properties）のejbserver.logger.channels.define.<チャネル名>.filenumキーで指定します。ログファイルのサイズは，HCSCサーバが動作するJ2EEサーバ用ユーザプロパティファイル（usrconf.properties）のejbserver.logger.channels.define.<チャネル名>.filesizeキーで指定します。

(b)　保守用ログ（ファイル操作アダプタ）

ファイル操作アダプタでの保守用ログについて説明します。

●保守用ログの出力形式

保守用ログの出力形式を次の図に示します。

図7‒129　保守用ログの出力形式（ファイル操作アダプタ）

●出力される内容

保守用ログに出力される内容を次の表に示します。

表7‒156　保守用ログに出力される内容（ファイル操作アダプタ）

項目

内容

番号

保守用ログの出力通番が表示されます。

日付

保守用ログの取得日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

保守用ログの取得時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

製品ID

製品を特定するための識別子として，ファイル操作アダプタを示す「FOPADP」が出力されます。また，バージョン情報が出力されます。

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID，種別

表示されません。

出力種別

保守用ログの取得ポイント情報（取得位置）が出力されます。

BGN：メソッドの開始

END：メソッドの終了

CAL：メソッドの呼び出し

RET：メソッドの戻り

THR：例外のスロー

CTH：例外のキャッチ

クラス名

保守用ログを取得するクラス名が出力されます。

メソッド名

保守用ログを取得するメソッド名が出力されます。

入出力情報※

保守用ログを取得するメソッドの入出力情報（引数の値，戻り値，例外名など）が出力されます。

CRLF

レコードの終端符号が出力されます。

注※

ファイル変換オペレーションの開始時

次のフォーマットで出力します。

<入力ファイルのパス> , file type = <入力ファイル形式> , file size = <入力ファイルサイズ>

各項目の意味を次に示します。

追加する情報

説明

<入力ファイルのパス>

入力ファイルの絶対パス

<入力ファイル形式>

バイナリ形式の場合：non-xml

XML形式の場合：xml

<入力ファイルサイズ>

バイト単位で出力

ファイル変換オペレーションの出力完了時

次のフォーマットで出力します。

<出力ファイルのパス> , file type = <出力ファイル形式> , file size = <出力ファイルサイズ> , record count = <入力レコード数>

各項目の意味を次に示します。

追加する情報

説明

<出力ファイルのパス>

出力ファイルの絶対パス

<出力ファイル形式>

バイナリ形式の場合：non-xml

XML形式の場合：xml

<出力ファイルサイズ>

バイト単位で出力

<入力レコード数>

分割処理方式の場合：入力したレコード数を出力

一括処理方式の場合：常に「-1」を出力

●保守用ログの出力先

<J2EEサーバのログ出力ディレクトリ>¥CSCADP¥ADPFOP¥maintenance¥<ファイル操作アダプタのサービスID>

保守用ログのログファイル名を次の表に示します。

表7‒157　保守用ログのログファイル名（ファイル操作アダプタ）

ログファイルの出力モード

ログファイル名

ラップアラウンドモードの場合

cscadpfopmnt_<HCSCサーバ名>_<面数>.log

シフトモードの場合

cscadpfopmnt_<HCSCサーバ名>_.log

なお，ログファイルの面数は，HCSCサーバランタイム定義ファイルのmethodtrace-filenumプロパティで指定します。ログファイルのサイズは，HCSCサーバランタイム定義ファイルのmethodtrace-filesizeプロパティで指定します。

HCSCサーバランタイム定義ファイルの詳細は，マニュアル「サービスプラットフォーム リファレンス」の「6.5.6　HCSCサーバランタイム定義ファイル」を参照してください。

(c)　性能解析トレース（ファイル操作アダプタ）

ファイル操作アダプタでの性能解析トレースについて説明します。

●性能解析トレースの出力形式

性能解析トレースファイルに出力される形式は，J2EEサーバの性能解析トレースと同様です。詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.3　Management Serverを利用した性能解析トレースファイルの収集」を参照してください。

●出力される内容

性能解析トレースファイルに出力される内容を次の表に示します。

表7‒158　性能解析トレースファイルに出力される内容（ファイル操作アダプタ）

項目

内容

イベントID

取得ポイントのイベントIDが出力されます。

取得ポイントの詳細は，項目「性能解析トレースの取得ポイント」を参照してください。

リターンコード

取得ポイント種別が出力されます。

0：正常終了

1：異常終了

インターフェース名

クラス名が出力されます。

オペレーション名

メソッド名が出力されます。

付加情報

データ（16進数形式）

取得ポイントごとに異なる情報（16進数形式）が出力されます。512文字を超えた場合は超えた分が切り捨てられます。

データ（ASCII形式）※

データ（16進数形式）の内容がASCII形式で出力されます。512文字を超えた場合は超えた分が切り捨てられます。

注※

データ（ASCII形式）の出力形式例を次に示します。

Service ID=<サービスID>, Operation Name=<サービスオペレーション名>, Time=<任意時刻からのナノ秒>, Exception=<例外クラス名>

●性能解析トレースの取得ポイント

性能解析トレースの取得ポイントを次の図に示します。

図7‒130　性能解析トレースの取得ポイント（ファイル操作アダプタ）

イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。表の「図中の番号」は上の図の番号と対応しています。

表7‒159　性能解析トレースの取得ポイント（ファイル操作アダプタ）

イベントID

図中の番号

トレース取得ポイント

レベル

0x9B80

1

ファイル操作アダプタの入口

A

0x9B81

2

ファイル操作アダプタの出口

A

0x9B82

3

ファイル操作アダプタのオペレーションの呼び出し口

A

0x9B83

4

ファイル操作アダプタのオペレーション結果の受け取り口

A

（凡例）

A：「標準」であることを示します。

●性能解析トレースの取得方法と出力先

性能解析トレースを取得するには設定が必要です。設定の詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.　性能解析トレースを使用した性能解析」を参照してください。

(d)　例外ログ（ファイル操作アダプタ）

例外ログには例外情報が出力されます。例外ログの概要については，「7.4.7(1)　例外ログ」を参照してください。なお，例外ログの出力内容は保守用ログと同じです。

●出力先

例外ログの出力先を次に示します。

<J2EEサーバのログ出力ディレクトリ>¥CSCADP¥ADPFOP¥maintenance¥<ファイル操作アダプタのサービスID>

例外ログのログファイル名を次の表に示します。

表7‒160　例外ログのログファイル名（ファイル操作アダプタ）

ログファイルの出力モード

ログファイル名

ラップアラウンドモードの場合

cscadpfopexp_<HCSCサーバ名>_<面数>.log

シフトモードの場合

cscadpfopexp_<HCSCサーバ名>_.log

●ファイル面数

出力ファイルの面数のデフォルトは8面です。面数はファイル操作アダプタ実行環境プロパティファイルのexptrace-filenumキーで変更できます。ログファイルのサイズは，ファイル操作アダプタ実行環境プロパティファイルのexptrace-filesizeプロパティで指定します。

ファイル操作アダプタ実行環境プロパティファイルについては，マニュアル「サービスプラットフォーム リファレンス」の「6.8.8　ファイル操作アダプタ実行環境プロパティファイル」を参照してください。

(4)　障害情報の取得（FTP受付）

FTP受付では，障害情報として性能解析トレースを出力します。

ここでは，FTP受付実行時に発生したエラーの伝わり方と，性能解析トレースについて説明します。

(a)　FTP受付実行時に発生したエラーの伝わり方

FTPクライアントからFTP受付を使用してビジネスプロセスを呼び出す場合のエラーの伝わり方を説明します。エラーの伝わり方は，エラーの種類によって異なります。

エラーを示す応答電文がFTP受付に返された場合

エラーを示す応答電文がFTP受付に返された場合のエラーの伝わり方を次の図に示します。

図7‒131　エラーを示す応答電文がFTP受付に返された場合のエラーの伝わり方

サービスアダプタから返されたフォルト電文は，ビジネスプロセスのフォルト処理に伝わります。ビジネスプロセスのフォルト処理で，エラー情報を，エラーを示す応答電文（応答電文の<success>タグにfalseを設定した応答電文）に変換し，FTP受付に返します。このとき，エラーを示す応答電文は，メッセージ配送基盤およびカスタム受付フレームワークを経由してFTP受付に返されます。

FTP受付では，応答電文に設定されているメッセージテキストをそのままの形でFTPインバウンドアダプタに返します。FTPインバウンドアダプタでは，受け取ったメッセージテキストをFTPの転送コマンドまたはリストコマンドのレスポンスとしてFTPクライアントへ応答します。

カスタム受付フレームワークがエラーをリターンした場合

カスタム受付フレームワークがエラーをリターンした場合のエラーの伝わり方を次の図に示します。なお，ビジネスプロセスから呼び出したサービスアダプタからフォルト電文が返され，このフォルトに該当するフォルト処理がビジネスプロセスに定義されていない場合も，次の図に示す流れと同じです。

図7‒132　カスタム受付フレームワークがエラーをリターンした場合のエラーの伝わり方

図中に示したエラー1〜エラー5の要因を次に示します。

エラー1：要求パラメタ不正など

エラー2：宛先（ロケーション）が見つからない，サービスアダプタが停止しているなど

エラー3：データ変換の失敗など

エラー4：宛先不正，サービス部品が停止，通信障害など

エラー5：ビジネスプロセス処理上での例外エラーなど

エラー1〜エラー5のどれかが発生した場合，例外をキャッチしたカスタム受付フレームワークはFTP受付の受付処理に対して，CSCMsgServerExceptionをスローします。

FTP受付の受付処理では，キャッチした例外を基にKDEC00384-EまたはKDEC00385-Eのメッセージテキストを生成し，FTPインバウンドアダプタに応答します。FTPインバウンドアダプタでは，受け取ったメッセージテキストを，FTPの転送コマンドまたはリストコマンドのレスポンスとしてFTPクライアントに応答します。

CSCMsgServerExceptionの詳細は，マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「付録A.3　カスタム受付フレームワークのAPI」を参照してください。

FTP受付がエラーを検知した場合

FTP受付がエラーを検知した場合のエラーの伝わり方を次の図に示します。

図7‒133　FTP受付がエラーを検知した場合のエラーの伝わり方

図中に示したエラー1〜エラー2の要因を次に示します。

エラー1：作業フォルダの作成失敗など

エラー2：FTPインバウンドアダプタでのファイルデータまたはリストデータ転送中に障害発生など

FTP受付では，検知した障害を基にKDEC00386-E〜KDEC00410-Wのメッセージテキストを生成し，FTPインバウンドアダプタに応答します。FTPインバウンドアダプタでは，受け取ったメッセージテキストを，FTPの転送コマンドまたはリストコマンドのレスポンスとしてFTPクライアントに応答します。

(b)　性能解析トレース（FTP受付）

FTP受付での性能解析トレースについて説明します。

●性能解析トレースの出力形式

性能解析トレースファイルに出力される形式は，J2EEサーバの性能解析トレースと同様です。詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.3　Management Serverを利用した性能解析トレースファイルの収集」を参照してください。

●出力される内容

性能解析トレースファイルに出力される内容を次の表に示します。

表7‒161　性能解析トレースファイルに出力される内容（FTP受付）

項目

内容

イベントID

取得ポイントのイベントIDが出力されます。

取得ポイントの詳細は，項目「性能解析トレースの取得ポイント」を参照してください。

リターンコード

取得ポイント種別が出力されます。

0：正常終了

1：異常終了

インターフェース名

クラス名が出力されます。

オペレーション名

メソッド名が出力されます。

オプション情報

メッセージ共通ID

リクエスト識別情報（親ID）が出力されます。未設定の場合，nullが出力されます。

サービスリクエストID

リクエスト識別情報（子ID）が出力されます。未設定の場合，nullが出力されます。

付加情報

次のオプション情報が出力されます。

受付名

受付ID

リクエストID

サービス名

サービスオペレーション名

例外名（障害発生時だけ）

●性能解析トレースの取得ポイント

性能解析トレースの取得ポイントを次の図に示します。

図7‒134　性能解析トレースの取得ポイント（FTP受付）

イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。表の「図中の番号」は上の図の番号と対応しています。

表7‒162　性能解析トレースの取得ポイント（FTP受付）

イベントID

図中の番号

トレース取得ポイント

レベル

0x9870

1

カスタム受付の入口

A

0x9871

2

カスタム受付の出口

A

0x9872

3

カスタム受付フレームワークの呼び出し口

B

0x9873

4

カスタム受付フレームワークの応答受信口

B

0x9874

5

PUTオペレーションの場合

ビジネスプロセスの呼び出し後，作業ディレクトリの削除前

GETオペレーションの場合

FTPクライアントへのファイルデータ転送後，作業ディレクトリの削除前

GETINFOオペレーションの場合

FTPクライアントへのリストデータ転送後，作業ディレクトリの削除前

A

0x9860

6

カスタム受付フレームワークの入口

A

0x9861

7

カスタム受付フレームワークの出口

A

0x9864

8

HCSCメッセージ配送制御の呼び出し口

A

0x9865

9

HCSCメッセージ配送制御の応答受信口

A

（凡例）

A：「標準」であることを示します。

B：「詳細」であることを示します。

●性能解析トレースの取得方法と出力先

性能解析トレースを取得するには設定が必要です。設定の詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.　性能解析トレースを使用した性能解析」を参照してください。

7.7.12　ファイルイベント連携システムでの障害対策

この項では，ファイルイベント連携の運用時で発生した障害に対して，取得できる情報の種類を説明します。ファイルイベント連携に関する障害情報には次の種類があります。

snapshotログ

メッセージログ

メソッドトレース

性能解析トレース

ファイルイベントトレース

これらの障害情報について説明します。

(1)　snapshotログ

mngsvrutilコマンドやsnapshotlogコマンドでの採取対象にファイルイベント受付を追加するには，snapshotログ収集対象定義ファイルの修正が必要な場合があります。

サービスプラットフォームのほかの受付と同じレベルのログを収集するには，次に示す内容をそれぞれのファイルに追記してください。すでに記述されている場合は修正不要です。

(a)　snapshotlog.conf

${cosminexus.home}/CSC/custom-reception/fileevent/config/.+
${cosminexus.home}/CSC/custom-reception/fileevent/config/common/.+

(b)　snapshotlog2.conf

${cosminexus.home}/CC/server/public/ejb/.+/logs/csc/rcp/fileevent/.+/fileeventtrace_.*¥.log
&{ejb.public.directory}/ejb/.+/logs/csc/rcp/fileevent/.+/fileeventtrace_.*¥.log
&{ejb.server.log.directory}/csc/rcp/fileevent/.+/fileeventtrace_.*¥.log

(c)　snapshotlog.param.conf

${cosminexus.home}/CSC/custom-reception/fileevent/config/.+
${cosminexus.home}/CSC/custom-reception/fileevent/config/common/.+

(2)　メッセージログ

ファイルイベント連携機能の運用時に障害が発生すると，メッセージがメッセージログへ出力されます。ファイルイベント受付のメッセージログは，サービスプラットフォームが出力するメッセージログのうち，J2EEサーバの稼働ログを出力します。

ファイルイベント連携機能で出力されるエラーには次のものがあります。

HCSCサーバの起動時にファイル監視機能の開始で例外が発生した場合，メッセージログにエラーメッセージ（KDEC00459-E）が出力されます。この時，HCSCサーバの起動コマンドはエラー終了します。

HCSCサーバランタイム定義ファイルのfileevent-reception.monitored-file.enabledプロパティの値がfalseの場合，ファイルイベント受付の起動が失敗します。この時，メッセージログにエラーメッセージ（KDEC00455-E）が出力されます。

ファイルイベント受付定義ファイルで指定された共通フォルダ定義名が，HCSCサーバランタイム定義ファイルで定義されていない場合，ファイルイベント受付の起動が失敗します。この時，メッセージログにエラーメッセージ（KDEC00458-E）が出力されます。

出力されたメッセージの内容については，マニュアル「サービスプラットフォーム メッセージ」の「2.1　KDEC00001〜KDEC19999のメッセージ」を参照してください。メッセージログの出力内容や出力先については，「7.4.1(3)　J2EEサーバの稼働ログ」を参照してください。

(a)　ファイルイベント受付にフォルト応答電文が返された場合

ファイルイベント受付にフォルト応答電文が返された場合のエラーの伝わり方については，マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「付録A.7　カスタム受付でのエラーの伝わり方」の，サービス部品からユーザ定義例外のエラーがリターンした場合に関する説明を参照してください。

この場合は，出力されたメッセージに従って対処したあと，監視対象のファイルに応じて次のように対処してください。

監視対象のファイル

対処

更新完了通知ファイル

取得対象ファイルが残っている場合

ファイル転送・データ連携ソフトウェアで，更新完了通知ファイルを再作成してください。

取得対象ファイルが残っていない場合

ファイル転送・データ連携ソフトウェアで，取得対象ファイルの転送から再実行してください。

取得対象ファイル

次の手順で対処してください。

リネーム後の取得対象ファイルが残っているか確認してください。

ファイルが残っている場合は，該当するファイルの処理が終了していることをファイルイベントトレースで確認してから削除してください。

ファイル転送・データ連携ソフトウェアで，取得対象ファイルを再作成してください。

(b)　カスタム受付フレームワークがエラーをリターンした場合

カスタム受付フレームワークがエラーをリターンした場合のエラーの伝わり方については，マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「付録A.7　カスタム受付でのエラーの伝わり方」のHCSCサーバからエラーがリターンした場合に関する説明を参照してください。

この場合は，出力されたメッセージに従って対処したあと，次のように対処してください。

エラー発生個所

条件

監視対象のファイル

更新完了通知ファイル

取得対象ファイル

ファイルイベント受付・HCSCメッセージ配送制御

なし

ファイル転送・データ連携ソフトウェアで，監視対象のファイル（更新完了通知ファイルまたは取得対象ファイル）を再作成してください。

上記以外

次に示す条件を満たしている場合

ビジネスプロセスの実行履歴を取得している

プロセスインスタンスが再実行可能である

プロセスインスタンスを再実行してください。

ただし，再実行時に取得対象ファイルを使用する場合で，かつ取得対象ファイルが残っていない場合は，ファイル転送・データ連携ソフトウェアで取得対象ファイルの転送から再実行してください。

プロセスインスタンスを再実行してください。

上記の条件を満たしていない場合

ファイル転送・データ連携ソフトウェアで，次の作業を実施してください。

取得対象ファイルが残っている場合

更新完了通知ファイルを再作成してください。

取得対象ファイルが残っていない場合

取得対象ファイルの転送から再実行してください。

ファイル転送・データ連携ソフトウェアで，取得対象ファイルの転送から再実行してください。

(c)　ファイルイベント受付がエラーを検知した場合

ファイルイベント受付が検知するエラーには次の種類があります。

取得対象ファイルが存在しない

ロックファイルの作成失敗

ロックファイルのロック取得失敗

ロックファイルのロック解放失敗

監視対象のファイルのリネーム失敗（更新完了通知ファイルまたは取得対象ファイル）

エラーを検知した場合は，ファイルイベントトレースに取得ポイント「IN」のトレースが出力されているか確認してください。出力の有無に応じて，大まかな発生個所と対処を次に示す表から推測できます。

表7‒163　障害発生個所と対処

取得ポイント「IN」のトレースの出力有無

障害発生個所

対処

出力されている

ビジネスプロセスの呼び出し後

メッセージログに出力されたエラーメッセージを確認し，対策が必要か判断してください。

出力されていない

ビジネスプロセスの呼び出し前

メッセージログに出力されるメッセージに従って対策したあと，次のように対処してください。

監視対象のファイルがリネームされている場合

ファイル転送・データ連携ソフトウェアで，監視対象のファイルを再作成※してください。これによって，次回のファイル監視時に検知され，ファイルイベント受付が呼び出されます。

監視対象のファイルがリネームされていない場合

次のファイル監視で検知されるため，対処は不要です。

注※

取得対象ファイルの場合は，再作成する前にファイルを削除する必要があります。該当するファイルに関する処理が終了しているかをファイルイベントトレースで確認し，処理が終了している場合はファイルを削除してください。

(3)　メソッドトレース

ファイルイベント連携のメソッドトレースは，サービスプラットフォームが出力するメソッドトレースの仕様に従います。

メソッドトレースの出力内容および出力先については，「7.4.7(3)　メソッドトレース」の「HCSCサーバ（メッセージング基盤）のメソッドトレース」を参照してください。

(4)　性能解析トレース

ファイルイベント連携機能の性能解析トレースは，性能ボトルネックを解析するための情報が出力されます。ファイルイベント連携機能の性能解析トレースで確認できることを次に示します。

ファイル監視機能の処理

ファイルイベント受付機能の処理

なお，性能解析トレースを取得するには設定が必要です。設定の詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.　性能解析トレースを使用した性能解析」を参照してください。

(a)　出力形式

性能解析トレースファイルに出力される形式は，J2EEサーバの性能解析トレースと同様です。詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.3　Management Serverを利用した性能解析トレースファイルの収集」を参照してください。

(b)　出力される内容

性能解析トレースファイルに出力される内容を次の表に示します。

表7‒164　性能解析トレースファイルに出力される内容（ファイルイベント連携）

項目

内容

イベントID

取得ポイントのイベントIDが出力されます。

取得ポイントの詳細は，「(c)　性能解析トレースの取得ポイント」を参照してください。

リターンコード

取得ポイント種別が出力されます。

0：正常終了

1：異常終了

インターフェース名

クラス名が出力されます。

オペレーション名

メソッド名が出力されます。

オプション情報※

メッセージ共通ID

リクエスト識別情報（親ID）が出力されます。未設定である場合，nullが出力されます。

サービスリクエストID

リクエスト識別情報（子ID）が出力されます。未設定である場合，nullが出力されます。

付加情報

次の付加情報が出力されます。

受付名

受付ID

クライアント相関ID

サービス名

サービスオペレーション名

例外名（障害発生時だけ出力）

注※

オプション情報は最大で256バイトです。「(c)　性能解析トレースの取得ポイント」の図の取得ポイントの1.と2.では出力されません。

(c)　性能解析トレースの取得ポイント

ファイルイベント連携の性能解析トレースの取得ポイントには次に示す種類があります。

ファイルイベント受付の処理時に取得

ファイル監視処理の開始・終了時に取得

それぞれの取得ポイントを次に示します。

ファイルイベント受付の処理時

図7‒135　性能解析トレースの取得ポイント（ファイルイベント連携）

イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。表の「図中の番号」は，図中の番号と対応しています。

表7‒165　性能解析トレース取得ポイント（ファイルイベント連携）

イベントID

図中の番号

トレース取得ポイント

レベル※

0x98B0

1

カスタム受付の入口

A

0x98B1

2

カスタム受付の出口

A

0x98B2

3

カスタム受付フレームワークの呼び出し口

B

0x98B3

4

カスタム受付フレームワークの応答受信口

B

0x9860

5

カスタム受付フレームワークの入口

A

0x9861

6

カスタム受付フレームワークの出口

A

0x9864

7

メッセージ配送制御の呼び出し口

A

0x9865

8

メッセージ配送制御の応答受信口

A

（凡例）

A：「標準」であることを示します。

B：「詳細」であることを示します。

注※

性能解析トレースレベルの変更方法の詳細については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」を参照してください。

ファイル監視処理の開始・終了時

図7‒136　性能解析トレースの取得ポイント（ファイルイベント連携）

イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。表の「図中の番号」は，図中の番号と対応しています。

表7‒166　性能解析トレース取得ポイント（ファイルイベント連携）

イベントID

図中の番号

トレース取得ポイント

レベル

0x98B4

9

ファイル監視処理の開始

A

0x98B5

10

ファイル監視処理の終了

A

（凡例）

A：「標準」であることを示します。

(5)　ファイルイベントトレース

ファイルイベントトレースは，ファイルイベント受付の起動時に初期化されます。ファイルイベントトレースの初期化処理に失敗した場合は，メッセージログに警告メッセージ（KDEC00457-W）が出力され，ファイルイベント受付の起動処理は続行されます。初期化に失敗したファイルイベント受付では，ファイルイベントトレースを取得することはできません。

(a)　出力先

ファイルイベントトレースの出力先を次に示します。

<J2EEサーバのログ出力ディレクトリ>¥csc¥rcp¥fileevent¥<受付ID>

<J2EEサーバのログ出力ディレクトリ>は，HCSCサーバが動作するJ2EEサーバ用オプション定義ファイル（usrconf.cfg）のejb.server.log.directoryキーで指定します。ファイルイベントトレースのファイル名を次の表に示します。

表7‒167　ファイルイベントトレースのファイル名

トレースファイルの出力モード

トレースファイル名

ラップアラウンドモードの場合

fileeventtrace_<面数>.log

シフトモードの場合

fileeventtrace_.log

(b)　ファイル面数

出力ファイルの面数のデフォルトは8面です。面数はファイルイベント受付コンフィグファイルのurecp-fileevent.trace.filenumキーで変更できます。

ファイルイベント受付コンフィグファイルについては，マニュアル「サービスプラットフォーム リファレンス」の「6.9.1　ファイルイベント受付コンフィグファイル」を参照してください。

(c)　ファイルサイズ

出力ファイルサイズのデフォルトは2MBです。ファイルサイズはファイルイベント受付コンフィグファイルのurecp-fileevent.trace.filesizeキーで変更できます。

ファイルイベント受付コンフィグファイルについては，マニュアル「サービスプラットフォーム リファレンス」の「6.9.1　ファイルイベント受付コンフィグファイル」を参照してください。

(d)　出力形式

ファイルイベントトレースの出力形式を次に示します。

図7‒137　ファイルイベントトレースの出力形式

(e)　出力される内容

ファイルイベントトレースに出力される内容を次の表に示します。

表7‒168　ファイルイベントトレースに出力される内容（ファイルイベント連携）

項目

内容

番号

ファイルイベントトレースの出力通番が表示されます。

日付

ファイルイベントトレースの取得日付がyyyy/mm/ddの形式で出力されます。

時刻

ファイルイベントトレースの取得時刻がhh:mm:ss.SSSの形式で出力されます。

製品ID

製品を特定するための識別子として「CSCMSG」が出力されます。

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID

空白

受付ID

リクエスト処理を行ったファイルイベント受付の受付ID

取得ポイント

取得ポイント情報として次に示す情報が出力されます。

IN：ファイルイベント受付入口

OUT：ファイルイベント受付出口（応答電文のsuccess要素値がtrueの場合）

FAULT：エラー（応答電文のsuccess要素値がfalseの場合）

ERROR：エラー（ファイルイベント受付呼び出し先からのエラーリターン，またはファイルイベント受付内でのエラー）

RootAP情報

ルートアプリケーション情報

付加情報

取得ポイント情報が「IN」の場合

ファイルの作成を検知したファイル名と，取得対象ファイルのファイルサイズが出力されます。

取得ポイント情報が「IN」でない場合

応答電文のmessage要素に値が格納されている場合は要素値が出力されます。

例外が返ってきた場合は，例外から取得したエラーメッセージが出力されます。

CRLF

レコードの終端符号が出力されます。

(f)　ファイルイベントトレースの取得ポイント

ファイルイベントトレースの取得ポイントを次に示します。

図7‒138　ファイルイベントトレースの取得ポイント

ファイルイベントトレースの取得ポイントと，および取得ポイント情報を次の表に示します。表の「図中の番号」は，上の図の番号と対応しています。

表7‒169　ファイルイベントトレースの取得ポイント

図中の番号

トレース取得ポイント

取得ポイント情報

1

ファイルイベント受付の入口

IN

2

ファイルイベント受付の出口

OUT

FAULT

ERROR

7.7.13　メールアダプタ実行時の障害対策

メールアダプタでは，システムの性能を検証したり，障害の原因を解析したりするための情報が，ログファイルまたはトレースファイルに出力されます。メールアダプタで出力されるログおよびトレースの種類を次の表に示します。

表7‒170　ログ・トレースの種類（メールアダプタの場合）

ログ・トレース

出力情報

説明

メッセージログ

メールアダプタで発生した各種情報が，メッセージとして出力されます。

稼働情報（起動・停止・障害など）をメッセージとして確認できます。なお，メッセージログの出力先は，アプリケーションサーバおよびサービスプラットフォーム全体で共通のため，システムの稼働状況を一括して確認できます。

メンテナンスログ

メールアダプタ内部の保守情報として，次の情報が出力されます。

日付

時刻

実行クラス名

内部メソッド名

発生した例外

指定した引数の情報

内部メソッドの発行時刻およびシーケンスを確認できます。

性能解析トレース

サービスプラットフォームシステム全体の性能解析トレース取得ポイントで，次の情報が出力されます。

日付

時刻

リクエスト情報

トレース取得元情報

メールアダプタの性能解析トレース取得ポイントでは，メールアダプタ固有の情報が出力されます。

サービスリクエスタから要求を受け付けて，実行結果を返却するまでの一連の処理で出力される性能解析情報を基に，サービスプラットフォームシステムの性能を検証できます。

例外ログ

メールアダプタで発生した例外情報（スタックトレース）が出力されます。

メールアダプタの例外情報を確認できます。障害要因の解析に利用できます。

コマンドメッセージログ

メールアダプタのコマンド実行時に発生した各種情報が出力されます。

メールアダプタのコマンドの開始時，停止時，およびコマンド実行中にエラーが発生した場合の情報をメッセージとして確認できます。

このうち，メッセージログ，メンテナンスログ，および性能解析トレースに出力されるメール情報を次の表に示します。

表7‒171　ログおよびトレースに出力されるメール情報

分類

項目

メッセージログ

メンテナンスログ

性能解析トレース

出力レベル3以下

出力レベル4

出力レベル5

サーバ情報

メールサーバのホスト名

○

○

○

○

○

メールサーバのポート番号

○

○

○

○

○

電子メールアドレス

TO

×

×

○

○

×

CC

×

×

○

○

×

BCC

×

×

○

○

×

FROM

×

×

○

○

×

ファイルパス

メール本文のパス

○

○

○

○

○

添付ファイルのパス

○

○

○

○

○

メールアダプタアカウント定義ファイルのパス

○

○

○

○

○

メールヘッダ定義ファイルのパス

○

○

○

○

○

メールのフォーマット

−

○

○

○

○

○

メールの内容

件名

×

×

×

×

×

メール本文

×

×

×

×

×

添付ファイル

×

×

×

×

×

エンコード

−

○

○

○

○

○

認証情報

認証形式

○

○

○

○

○

ユーザ名

○

○

○

○

○

パスワード

○※

○※

○※

○※

○※

メッセージID

−

○

○

○

○

○

（凡例）

○：出力されます。

×：出力されません。

−：該当する項目はありません。

注※

8桁のアスタリスク（*）が出力されます。

このほかに，アプリケーションサーバのJavaMailで出力されるエラーメッセージおよびトレースもトラブルシュート時に必要になります。アプリケーションサーバが出力する障害情報の取得方法などについては，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」を参照してください。

ログおよびトレースの取得方法や出力内容などについて，次に示します。

(1)　メッセージログ

(a)　出力形式

メッセージログの出力形式を次の図に示します。

図7‒139　メッセージログの出力形式（メールアダプタ）

(b)　出力される内容

メッセージログに出力される内容を次の表に示します。

表7‒172　メッセージログに出力される内容（メールアダプタ）

項目

内容

番号

メッセージログの出力通番が表示されます。

日付

メッセージログの取得日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

メッセージログの取得時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

製品ID

製品を特定するための識別子として，Component Containerを示す「HEJB」が出力されます。

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

メッセージID

メッセージIDが「KDECnnnnn-X」の形式で出力されます。

メッセージテキスト

メッセージの内容が出力されます。

CRLF

レコードの終端符号が出力されます。

(c)　出力先

メッセージログの出力先を次に示します。

J2EEサーバの稼働ログの出力先に指定されたパス

J2EEサーバの稼働ログの出力先は，usrconf.cfg（J2EEサーバ用オプション定義ファイル）のejb.server.log.directoryキーで指定します。デフォルトの出力先は，<サービスプラットフォームのインストールディレクトリ>¥CC¥server¥public¥ejb¥<J2EEサーバ名>¥logsです。usrconf.cfgの詳細は，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.2　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。

メッセージログのログファイル名を次の表に示します。

表7‒173　メッセージログのログファイル名（メールアダプタ）

ログファイルの出力モード

ログファイル名

ラップアラウンドモードの場合

cjmessage<面数>.log

シフトモードの場合

cjmessage.log

なお，ログファイルの面数は，HCSCサーバが動作するJ2EEサーバ用オプション定義ファイル（usrconf.cfg）のejbserver.logger.channels.define.<チャネル名>.filenumキーで指定します。ログファイルのサイズは，HCSCサーバが動作するJ2EEサーバ用オプション定義ファイル（usrconf.cfg）のejbserver.logger.channels.define.<チャネル名>.filesizeキーで指定します。

(2)　メンテナンスログ

(a)　出力形式

メンテナンスログの出力形式を次の図に示します。

図7‒140　メンテナンスログの出力形式（メールアダプタ）

(b)　出力される内容

メンテナンスログに出力される内容を次の表に示します。

表7‒174　メンテナンスログに出力される内容（メールアダプタ）

項目

内容

番号

メンテナンスログの出力通番が表示されます。

日付

メンテナンスログの取得日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

メンテナンスログの取得時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

製品ID

製品を特定するための識別子として，メールアダプタを示す「MAILADP」が出力されます。また，バージョン情報が出力されます。

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID，種別

表示されません。

出力種別

メンテナンスログの取得ポイント情報（取得位置）が出力されます。

BGN：メソッドの開始

END：メソッドの終了

CAL：メソッドの呼び出し

RET：メソッドの戻り

THR：例外のスロー

CTH：例外のキャッチ

クラス名

メンテナンスログを取得するクラス名が出力されます。

メソッド名

メンテナンスログを取得するメソッド名が出力されます。

入出力情報

メンテナンスログを取得するメソッドの入出力情報が出力されます。

CRLF

レコードの終端符号が出力されます。

(c)　出力先

メンテナンスログの出力先を次に示します。このディレクトリに例外ログも出力されます。

メールアダプタ実行環境プロパティファイルのmailadp.methodtrace.filepathキーで指定したパス

メンテナンスログのログファイル名を次の表に示します。

表7‒175　メンテナンスログのログファイル名（メールアダプタ）

ログファイルの出力モード

ログファイル名

ラップアラウンドモードの場合

cscmailadpmtd_<HCSCサーバ名>_<面数>.log

シフトモードの場合

cscmailadpmtd_<HCSCサーバ名>_.log

なお，ログファイルの面数は，メールアダプタ実行環境プロパティファイルのmailadp.methodtrace.filenumキーで指定します。ログファイルのサイズは，メールアダプタ実行環境プロパティファイルのmailadp.methodtrace.filesizeキーで指定します。

メールアダプタ実行環境プロパティファイルの詳細は，マニュアル「サービスプラットフォーム リファレンス」の「6.13.3　メールアダプタ実行環境プロパティファイル」を参照してください。

(3)　性能解析トレース

性能解析トレースを取得するには設定が必要です。設定の詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.　性能解析トレースを使用した性能解析」を参照してください。

(a)　出力形式

性能解析トレースファイルに出力される形式は，J2EEサーバの性能解析トレースと同様です。詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.3　Management Serverを利用した性能解析トレースファイルの収集」を参照してください。

(b)　出力される内容

性能解析トレースファイルに出力される内容を次の表に示します。

表7‒176　性能解析トレースファイルに出力される内容（メールアダプタ）

項目

内容

イベントID

取得ポイントのイベントIDが出力されます。

取得ポイントの詳細は，「(c)　性能解析トレースの取得ポイント」を参照してください。

リターンコード

取得ポイント種別が出力されます。

0：正常終了

1：異常終了

インターフェース名

クラス名が出力されます。

オペレーション名

メソッド名が出力されます。

オプション情報

サービスID

HCSCコンポーネントのサービスIDが出力されます。

オペレーション

SENDが出力されます。

メール送信（メールサーバとの接続およびメール送信を含む）

接続先メールサーバのホスト名，ポート番号，日付，メッセージIDなどが出力されます。

例外クラス名

例外が発生したクラス名が出力されます。

(c)　性能解析トレースの取得ポイント

性能解析トレースの取得ポイントを次の図に示します。

図7‒141　性能解析トレースの取得ポイント（メールアダプタ）

イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。表の「図中の番号」は上の図の番号と対応しています。

表7‒177　　性能解析トレースの取得ポイント（メールアダプタ）

イベントID

図中の番号

トレース取得ポイント

レベル

0x9B90

1

リクエスト受付時

B

0x9B92

2

メール送信時（メールサーバとの接続も含む）

A

0x9B93

3

メール送信応答時（メールサーバとの接続も含む）

A

0x9B91

4

レスポンス送信時

B

（凡例）

A：「標準」であることを示します。

B：「詳細」であることを示します。

(4)　例外ログ

例外ログは，メンテナンスログと同じタイミングで開始・終了し，例外情報（スタックトレース）を採取してファイルに出力します。例外ログファイルの出力先はメールアダプタのメンテナンスログと同じディレクトリであるため，個別には変更できません。

(a)　出力形式

例外ログの出力形式を次の図に示します。

図7‒142　例外ログの出力形式（メールアダプタ）

(b)　出力される内容

例外ログに出力される内容を次の表に示します。

項目

内容

番号

例外ログの出力通番が表示されます。

日付

例外ログの取得日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

例外ログの取得時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

製品ID

製品を特定するための識別子として，メールアダプタを示す「MAILADP」が出力されます。

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID

空白

スタックトレース情報

スタックトレース情報が出力されます。

CRLF

レコードの終端符号が出力されます。

(c)　出力先

例外ログの出力先を次に示します。メンテナンスログと同じパスです。

<メールアダプタ実行環境プロパティファイルのmailadp.methodtrace.filepathプロパティで指定したパス>¥<サービスID>

例外ログのログファイル名を次の表に示します。

表7‒178　例外ログのログファイル名（メールアダプタ）

ログファイルの出力モード

ログファイル名

ラップアラウンドモードの場合

cscmailadpexp_<HCSCサーバ名>_<面数>.log

シフトモードの場合

cscmailadpexp_<HCSCサーバ名>_.log

なお，ログファイルの面数は，メールアダプタ実行環境プロパティファイルのmailadp.exptrace.filenumプロパティで指定します。ログファイルのサイズは，メールアダプタ実行環境プロパティファイルのmailadp.exptrace.filesizeプロパティで指定します。

メールアダプタ実行環境プロパティファイルの詳細は，マニュアル「サービスプラットフォーム リファレンス」の「6.13.3　メールアダプタ実行環境プロパティファイル」を参照してください。

(5)　コマンドメッセージログ

(a)　出力形式

コマンドメッセージログの出力形式を次の図に示します。

図7‒143　コマンドメッセージログの出力形式（メールアダプタ）

(b)　出力される内容

コマンドメッセージログに出力される内容を次の表に示します。

表7‒179　コマンドメッセージログに出力される内容（メールアダプタ）

項目

内容

番号

コマンドメッセージログの出力通番が表示されます。

日付

コマンドメッセージログの取得日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

コマンドメッセージログの取得時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

製品ID

製品を特定するための識別子として，メールアダプタを示す「MAILADP」の後ろに，実行したコマンドの名前を示す「add」，「del」または「ls」が出力されます。

MAILADP:add

MAILADP:del

MAILADP:ls

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

メッセージID

メッセージIDが「KDECnnnnn-X」の形式で出力されます。

メッセージテキスト

メッセージの内容が出力されます。

CRLF

レコードの終端符号が出力されます。

(c)　出力先

コマンドメッセージログの出力先およびログファイル名を次に示します。

<メールアダプタコマンド定義ファイルのmailadp.command.messagelog.filepathキーに指定されたパス>¥adpmailcommand<面数>.log

なお，ログファイルの面数は，メールアダプタコマンド定義ファイルのmailadp.command.messagelog.filenumキーで指定します。ログファイルのサイズは，メールアダプタコマンド定義ファイルのmailadp.command.messagelog.filesizeキーで指定します。

7.7.14　HTTP受付実行時の障害対策

HTTP受付の運用中に出力される障害情報の種類について説明します。HTTP受付に関する障害情報には次の種類があります。

メッセージログ

HTTP受付の起動・停止時のインフォメーション情報や転送エラーなどのエラー情報がログファイルに出力されます。

メソッドトレース

保守情報がトレースファイルに出力されます。

性能解析トレース

サービスプラットフォームシステムの性能解析を実行するためのトレース情報が出力されます。

ここでは，HTTP受付の実行時にサービスプラットフォームが出力するログおよびトレースの取得方法，出力形式，出力先などについて説明します。

(1)　メッセージログ

HTTP受付のメッセージログは，サービスプラットフォームが出力するメッセージログのうち，J2EEサーバの稼働ログを出力します。

メッセージログの出力内容については，マニュアル「サービスプラットフォーム メッセージ」の「2.6　KDEC80400〜KDEC80499のメッセージ」を参照してください。

メッセージログの出力内容や出力先については，「7.4.1　メッセージログ」を参照してください。

(2)　メソッドトレース

HTTP受付のメソッドトレースは，サービスプラットフォームが出力するメソッドトレースの仕様に従います。

メソッドトレースの出力内容および出力先については，「7.4.7(3)　メソッドトレース」の「HCSCサーバ（メッセージング基盤）のメソッドトレース」を参照してください。

(3)　性能解析トレース

HTTP受付での性能解析トレースについて説明します。性能解析トレース（PRFトレース機能）は，Performance Tracerを使用して，サービスリクエスタからの要求受付からサービス実行結果が返却されるまでの逐次プロセスの任意の時点で，性能分析情報を出力します。これによって，システム全体の性能を検証できます。

なお，性能解析トレースを取得するには設定が必要です。設定の詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.　性能解析トレースを使用した性能解析」を参照してください。

(a)　出力形式

性能解析トレースファイルに出力される形式は，アプリケーションサーバの性能解析トレースと同様です。詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.3　Management Serverを利用した性能解析トレースファイルの収集」を参照してください。

(b)　出力される内容

性能解析トレースファイルに出力される内容を次の表に示します。

表7‒180　性能解析トレースファイルに出力される内容（HTTP受付）

項目

内容

イベントID

取得ポイントのイベントIDが出力されます。

取得ポイントの詳細は，「(c)　性能解析トレースの取得ポイント」を参照してください。

リターンコード

取得ポイント種別が出力されます。

0：正常終了

1：異常終了

インターフェース名

クラス名が出力されます。

オペレーション名

メソッド名が出力されます。

オプション情報

次のオプション情報だけが出力されます。

受付名

受付ID

リクエストID

サービス名

サービスオペレーション名

例外名※

注※

エラーが発生したときにだけ出力されます。

(c)　性能解析トレースの取得ポイント

性能解析トレースの取得ポイントを次の図に示します。

図7‒144　性能解析トレースの取得ポイント（HTTP受付）

イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。表の「図中の番号」は，図中の番号と対応しています。

表7‒181　性能解析トレースの取得ポイント（HTTP受付）

イベントID

図中の番号

トレース取得ポイント

レベル

0x9880

1

HTTP受付の入口

A

0x9882

2

カスタム受付フレームワークの呼び出し口

A

0x9883

3

カスタム受付フレームワークの応答受信口

A

0x9881

4

HTTP受付の出口

A

0x9884

5

作業フォルダ削除前※

A

（凡例）

A：「標準」であることを示します。

注※

HTTPレスポンスでHTTPクライアントにファイルをダウンロードする場合は，HTTPクライアントにデータを送信したあとになります。

7.7.15　HTTPアダプタ実行時の障害対策

HTTPアダプタでは，システムの性能を検証したり，障害の原因を解析したりするための情報が，ログファイルまたはトレースファイルに出力されます。HTTPアダプタで出力されるログおよびトレースの種類を次の表に示します。

表7‒182　ログ・トレースの種類（HTTPアダプタの場合）

ログ・トレース

出力情報

説明

メッセージログ

HTTPアダプタで発生した各種情報が，メッセージとして出力されます。

稼働情報（起動・停止・障害など）をメッセージとして確認できます。なお，メッセージログの出力先は，アプリケーションサーバおよびサービスプラットフォーム全体で共通のため，システムの稼働状況を一括して確認できます。

メンテナンスログ

HTTPアダプタ内部の保守情報として，次の情報が出力されます。

日付

時刻

実行クラス名

内部メソッド名

発生した例外

指定した引数の情報

内部メソッドの発行時刻およびシーケンスを確認できます。

性能解析トレース

サービスプラットフォームシステム全体の性能解析トレース取得ポイントで，次の情報が出力されます。

日付

時刻

リクエスト情報

トレース取得元情報

HTTPアダプタの性能解析トレース取得ポイントでは，HTTPアダプタ固有の情報が出力されます。

サービスリクエスタから要求を受け付けて，実行結果を返却するまでの一連の処理で出力される性能解析情報を基に，サービスプラットフォームシステムの性能を検証できます。

例外ログ

HTTPアダプタで発生した例外情報（スタックトレース）が出力されます。

HTTPアダプタの例外情報を確認できます。障害要因の解析に利用できます。

通信ログ

HTTP通信で送受信したメッセージが出力されます。

障害調査時などで，送受信した内容を確認するために使用します。

ユーザ認証情報管理コマンドのメッセージログ

ユーザ認証情報管理コマンドの実行時の情報（通知・エラーなど）が，メッセージとして出力されます。

ユーザ認証情報管理コマンドの実行時の情報（通知・エラーなど）をメッセージとして確認できます。なお，ユーザ認証情報管理コマンドのメッセージログの出力先は，サービスプラットフォーム全体で共通のため，過去に実行したコマンドの障害情報や稼働情報を把握できます。

ログおよびトレースの取得方法や出力内容などの詳細は，以降の記述を参照してください。

(1)　メッセージログ

HTTPアダプタのメッセージログは，サービスプラットフォームが出力するメッセージログのうち，J2EEサーバの稼働ログを出力します。

メッセージログに出力されるメッセージの内容については，マニュアル「サービスプラットフォーム メッセージ」の「2.8　KDEC81000〜KDEC81499のメッセージ」を参照してください。

メッセージログの出力内容や出力先については，「7.4.1　メッセージログ」を参照してください。

(2)　メンテナンスログ

(a)　出力形式

メンテナンスログの出力形式を次の図に示します。

図7‒145　メンテナンスログの出力形式（HTTPアダプタ）

(b)　出力される内容

メンテナンスログに出力される内容を次の表に示します。

表7‒183　メンテナンスログに出力される内容（HTTPアダプタ）

項目

内容

番号

メンテナンスログの出力通番が表示されます。

日付

メンテナンスログの取得日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

メンテナンスログの取得時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

製品ID

製品を特定するための識別子として，HTTPアダプタを示す「ADPHTTP」と，バージョン情報が出力されます。

バージョン情報の形式は次のとおりです。

正規版製品：VV-RR

修正版製品：VV-RR-SS

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

メッセージID 種別

表示されません。

出力種別

メンテナンスログの取得ポイント情報（取得位置）が出力されます。

BGN：メソッドの開始

END：メソッドの終了

CAL：メソッドの呼び出し

RET：メソッドの戻り

THR：例外のスロー

CTH：例外のキャッチ

クラス名

メンテナンスログを取得するクラス名が出力されます。

メソッド名

メンテナンスログを取得するメソッド名が出力されます。

入出力情報

メンテナンスログを取得するメソッドの入出力情報またはスタックトレースが出力されます。

CRLF

レコードの終端符号が出力されます。

(c)　出力先

メンテナンスログの出力先を次に示します。

<adphttp.config.trace.pathプロパティ※で指定したパス>¥CSCADP¥ADPHTTP¥maintenance¥<サービスID>

注※

adphttp.config.trace.pathプロパティは，HTTPアダプタ実行環境プロパティファイルまたはHTTPアダプタ実行環境共通プロパティファイルで指定します。

メンテナンスログのログファイル名を次の表に示します。

表7‒184　メンテナンスログのログファイル名（HTTPアダプタ）

ログファイルの出力モード

ログファイル名

ラップアラウンドモードの場合

cscadphttpmnt_<HCSCサーバ名>_<面数>.log

シフトモードの場合

cscadphttpmnt_<HCSCサーバ名>_.log

なお，ログファイルの面数はHTTPアダプタ実行環境プロパティファイルまたはHTTPアダプタ実行環境共通プロパティファイルのadphttp.config.methodtrace.filenumプロパティ，ログファイルのサイズはadphttp.config.methodtrace.filesizeプロパティで指定します。

HTTPアダプタ実行環境プロパティファイルの詳細は，マニュアル「サービスプラットフォーム リファレンス」の「6.14.2　HTTPアダプタ実行環境プロパティファイル」を参照してください。HTTPアダプタ実行環境共通プロパティファイルについては，マニュアル「サービスプラットフォーム リファレンス」の「6.14.3　HTTPアダプタ実行環境共通プロパティファイル」を参照してください。

(3)　性能解析トレース

性能解析トレースを取得するには設定が必要です。設定の詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.　性能解析トレースを使用した性能解析」を参照してください。

(a)　出力形式

性能解析トレースファイルに出力される形式は，J2EEサーバの性能解析トレースと同様です。詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.3　Management Serverを利用した性能解析トレースファイルの収集」を参照してください。

(b)　出力される内容

性能解析トレースファイルに出力される内容を次の表に示します。

表7‒185　性能解析トレースファイルに出力される内容（HTTPアダプタ）

項目

内容

イベントID

取得ポイントのイベントIDが出力されます。

取得ポイントの詳細は，「(c)　性能解析トレースの取得ポイント」を参照してください。

リターンコード

取得ポイント種別が出力されます。

0：正常終了

1：異常終了

インターフェース名

クラス名が出力されます。

オペレーション名

メソッド名が出力されます。

オプション情報

サービスID

HCSCコンポーネントのサービスIDが出力されます。

オペレーション

HTTPアダプタに定義されたオペレーション名が出力されます。

リクエストID※1

要求電文（ヘッダ）に指定したリクエストIDが出力されます。

任意時刻からのナノ秒

java.lang.SystemクラスのnanoTimeメソッドの戻り値が出力されます。

例外クラス名

例外が発生したクラス名が出力されます。

転送サイズ※2※3

受信したデータサイズが出力されます（単位：バイト）。

HTTPメソッド※4

呼び出したHTTPリクエストのHTTPメソッドが出力されます。

URI※4※5

リクエスト送信時のURIが出力されます。

注※1

要求電文（ヘッダ）で指定しなかった場合や，値の取得前にエラーが発生した場合は出力されません。

注※2

イベントIDが0x9894の場合は，HTTPレスポンスヘッダから取得した値がそのまま出力されます。HTTPレスポンスヘッダから値が取得できなかった場合や値が不正な形式の場合などは，0以下の数値になる場合があります。エラーなどで値を取得できない場合は出力されません。

注※3

イベントIDが0x9893の場合は，HTTPアダプタが受信した値が出力されます。エラーなどで値を取得できない場合は出力されません。

注※4

要求電文（ヘッダ），HTTPアダプタ実行環境プロパティファイル，およびHTTPアダプタ実行環境共通プロパティファイルに指定がない場合や，値の取得前にエラーが発生した場合は出力されません。

注※5

要求電文（ヘッダ），HTTPアダプタ実行環境プロパティファイル，およびHTTPアダプタ実行環境共通プロパティファイルに指定した，スキーム・オーソリティ（ユーザ情報を除く）とパス部分だけが出力されます。

(c)　性能解析トレースの取得ポイント

性能解析トレースの取得ポイントを次の図に示します。

図7‒146　性能解析トレースの取得ポイント（HTTPアダプタ）

イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。表の「図中の番号」は，図中の番号と対応しています。

表7‒186　　性能解析トレースの取得ポイント（HTTPアダプタ）

イベントID

図中の番号

トレース取得ポイント

レベル

0x9890

1

リクエスト受付時

A

0x9891

2

レスポンス送信時

A

0x9892

3

HTTPリクエスト送信時

A

0x9893

4

HTTPレスポンス受信完了時

A

0x9894

5

HTTPレスポンスヘッダ受信時

A

（凡例）

A：「標準」であることを示します。

(4)　例外ログ

例外ログは，メンテナンスログと同じタイミングで開始・終了し，例外情報（スタックトレース）を採取してファイルに出力します。例外ログファイルの出力先はHTTPアダプタのメンテナンスログと同じディレクトリであるため，個別には変更できません。

(a)　出力形式

例外ログの出力形式を次の図に示します。

図7‒147　例外ログの出力形式（HTTPアダプタ）

(b)　出力される内容

例外ログに出力される内容を次の表に示します。

項目

内容

番号

例外ログの出力通番が表示されます。

日付

例外ログの取得日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

例外ログの取得時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

製品ID

製品を特定するための識別子として，HTTPアダプタを示す「ADPHTTP」と，バージョン情報が出力されます。

バージョン情報の形式は次のとおりです。

正規版製品：VV-RR

修正版製品：VV-RR-SS

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID

空白

スタックトレース情報

スタックトレース情報が出力されます。

CRLF

レコードの終端符号が出力されます。

(c)　出力先

例外ログの出力先を次に示します。メンテナンスログと同じパスです。

<adphttp.config.trace.pathプロパティ※で指定したパス>¥CSCADP¥ADPHTTP¥maintenance¥<サービスID>

注※

adphttp.config.trace.pathプロパティは，HTTPアダプタ実行環境プロパティファイルまたはHTTPアダプタ実行環境共通プロパティファイルで指定します。

例外ログのログファイル名を次の表に示します。

表7‒187　例外ログのログファイル名（HTTPアダプタ）

ログファイルの出力モード

ログファイル名

ラップアラウンドモードの場合

cscadphttpexp_<HCSCサーバ名>_<面数>.log

シフトモードの場合

cscadphttpexp_<HCSCサーバ名>_.log

なお，ログファイルの面数はHTTPアダプタ実行環境プロパティファイルのadphttp.config.exptrace.filenumプロパティで，ログファイルのサイズはadphttp.config.exptrace.filesizeプロパティで指定します。なお，これらのプロパティはHTTPアダプタ実行環境共通プロパティファイルでも指定できます。

HTTPアダプタ実行環境プロパティファイルについては，マニュアル「サービスプラットフォーム リファレンス」の「6.14.2　HTTPアダプタ実行環境プロパティファイル」を参照してください。HTTPアダプタ実行環境共通プロパティファイルについては，マニュアル「サービスプラットフォーム リファレンス」の「6.14.3　HTTPアダプタ実行環境共通プロパティファイル」を参照してください。

(5)　通信ログ

HTTPアダプタでは，アプリケーションサーバのJAX-RS機能を利用してHTTP通信を処理しています。V9互換モードでは，HTTP通信で送受信されたデータは，JAX-RS機能によって通信ログとして出力されます。

通信ログの出力レベル，面数，最大サイズ，および文字エンコーディングは，アプリケーションサーバの共通定義ファイルで設定できます。通信ログの設定については，マニュアル「アプリケーションサーバ Webサービス開発ガイド」の「13.1.2　共通定義ファイルの設定項目」を参照してください。

(6)　ユーザ認証情報管理コマンドのメッセージログ

ユーザ認証情報管理コマンドを実行した場合，実行時の情報（通知・エラーなど）を出力します。

出力されるメッセージの内容については，マニュアル「サービスプラットフォーム メッセージ」の「2.8　KDEC81000〜KDEC81499のメッセージ」を参照してください。

メッセージログの出力内容や出力先については，「7.4.8　ユーザ認証情報管理コマンドのメッセージログ」を参照してください。

7.7.16　HTTP連携でのJSON-XML変換機能使用時の障害対策

HTTP受付とHTTPアダプタでJSON-XML変換機能を使用する際にサービスプラットフォームが出力する障害情報には，次の種類があります。

メッセージログ

性能解析トレース

ユーザ電文トレース

これらのログおよびトレースについて，取得方法，出力形式，出力先などを説明します。

(1)　メッセージログ

HTTP受付とHTTPアダプタのJSON-XML変換機能の運用時に出力されるメッセージログを出力します。

メッセージログの出力内容については，マニュアル「サービスプラットフォーム メッセージ」の「2.1　KDEC00001〜KDEC19999のメッセージ」を参照してください。

メッセージログの出力内容や出力先については，「7.4.1　メッセージログ」を参照してください。

(2)　性能解析トレース

性能解析トレースを取得するには設定が必要です。設定の詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.3　Management Serverを利用した性能解析トレースファイルの収集」を参照してください。

(a)　出力形式

性能解析トレースファイルに出力される形式は，J2EEサーバの性能解析トレースと同様です。詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.3　Management Serverを利用した性能解析トレースファイルの収集」を参照してください。

(b)　出力される内容

性能解析トレースファイルに出力される内容は，次に示す個所を参照してください。

HTTP受付の場合

「7.7.14(3) 性能解析トレース」

HTTPアダプタの場合

「7.7.15(3) 性能解析トレース」

(c)　性能解析トレースの取得ポイント

性能解析トレースの取得ポイントは，HTTP受付とHTTPアダプタの場合とで，次のように異なります。

HTTP受付の場合

HTTP受付の場合の性能解析トレースの取得ポイントを次の図に示します。

図7‒148　性能解析トレースの取得ポイント（HTTP連携でのJSON-XML変換機能（HTTP受付））

イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。表の「図中の番号」は，図中の番号と対応しています。

表7‒188　　性能解析トレースの取得ポイント（HTTP連携でのJSON-XML変換機能（HTTP受付））

イベントID

図中の番号

トレース取得ポイント

レベル

0x9860

1

カスタム受付フレームワークの入口

A

0x9861

2

カスタム受付フレームワークの出口

A

0x9862

3

データ変換（要求電文）の呼び出し口

B

0x9863

4

データ変換（要求電文）の応答受信口

B

0x9864

5

HCSCメッセージ配送制御の呼び出し口

A

0x9865

6

HCSCメッセージ配送制御の応答受信口

A

0x9866

7

データ変換（応答電文）の呼び出し口

B

0x9867

8

データ変換（応答電文）の応答受信口

B

0x986E

9

カスタム受付フレームワークのJSON-XML変換（要求電文）の呼び出し口※1

B

0x986F

10

カスタム受付フレームワークのJSON-XML変換（応答電文）の応答受信口※2

B

0x9880

11

HTTP受付の入口

A

0x9881

12

HTTP受付の出口

A

0x9882

13

カスタム受付フレームワークの呼び出し口

A

0x9883

14

カスタム受付フレームワークの応答受信口

A

（凡例）

A：「標準」であることを示します。

B：「詳細」であることを示します。

注※1

リクエスト処理時にJSON-XML変換を実行する場合だけ出力します。

注※2

レスポンス処理時にJSON-XML変換を実行する場合だけ出力します。

HTTPアダプタの場合

HTTPアダプタの場合の性能解析トレースの取得ポイントを次の図に示します。

図7‒149　性能解析トレースの取得ポイント（HTTP連携でのJSON-XML変換機能（HTTPアダプタ））

イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。表の「図中の番号」は，図中の番号と対応しています。

表7‒189　　性能解析トレースの取得ポイント（HTTP連携でのJSON-XML変換機能（HTTPアダプタ））

イベントID

図中の番号

トレース取得ポイント

レベル

0x9818

1

サービスアダプタ（CUSTOM）のサービス部品呼び出し口

A

0x9819

2

サービスアダプタ（CUSTOM）のサービス部品応答受信口

A

0x982A

3

カスタムアダプタ開発フレームワークのJSON-XML変換（要求電文）の呼び出し口※1

B

0x982B

4

カスタムアダプタ開発フレームワークのJSON-XML変換（要求電文）の応答受信口※1

B

0x982C

5

カスタムアダプタ開発フレームワークのJSON-XML変換（応答電文）の呼び出し口※2

B

0x982D

6

カスタムアダプタ開発フレームワークのJSON-XML変換（応答電文）の応答受信口※2

B

0x9890

7

HTTPアダプタの入口

A

0x9891

8

HTTPアダプタの出口

A

0x9892

9

HTTP要求送信時

A

0x9893

10

HTTPレスポンス完全受信時

A

0x9894

11

HTTPレスポンスヘッダ受信時

A

（凡例）

A：「標準」であることを示します。

B：「詳細」であることを示します。

注※1

リクエスト処理時にJSON-XML変換を実行する場合だけ出力します。

注※2

レスポンス処理時にJSON-XML変換を実行する場合だけ出力します。

性能解析トレースの取得レベルの変更

詳細レベルの性能解析トレースを取得する場合は，cprflevelコマンドで性能解析トレースの取得レベルを変更し，HCSCサーバを再起動してください。変更対象の取得レベルは，インデックス2の1けた目の上位レイヤ（HCSCサーバ）の取得レベルです。

cprflevel -PrfChangeLevel ,0x40000000

cprflevelコマンドの詳細は，マニュアル「アプリケーションサーバ リファレンス コマンド編」を参照してください。

(3)　ユーザ電文トレース

HTTP受付とHTTPアダプタでJSON-XML変換機能を使用した場合に出力されるユーザ電文トレースについて説明します。

(a)　ユーザ電文トレースの取得ポイント

HTTP受付の場合

HTTP受付のJSON-XML変換機能では，ユーザ電文トレースの出力契機がNORMALの場合，トレース取得ポイントとして次の個所が追加されます。

リクエスト処理時のJSON-XML変換前（図中の番号5）

レスポンス処理時のJSON-XML変換後（図中の番号6）

HTTP受付のユーザ電文トレースの取得ポイントを次の図に示します。

図7‒150　ユーザ電文トレースの取得ポイント（HTTP連携でのJSON-XML変換機能（HTTP受付））

トレース取得ポイント，出力電文の種類，および詳細位置を次の表に示します。表の「図中の番号」は，図中の番号と対応しています。

表7‒190　　ユーザ電文トレースの取得ポイント（HTTP連携でのJSON-XML変換機能（HTTP受付））

図中の番号

トレース取得ポイント

出力電文

ユーザ電文トレース開始の詳細

取得ポイント

プロトコル種別

詳細位置

1

カスタム受付フレームワークの入口

リクエスタ側電文

URCP

CUSTM

IN

2

カスタム受付フレームワークの出口

リクエスタ側電文

URCP

CUSTM

OUT

3

データ変換（要求電文）の応答受信口※1

データ変換後の要求電文

URCP

CUSTM

RQA

4

データ変換（要求電文）の呼び出し口※2

データ変換後の応答電文

URCP

CUSTM

RSB

5

カスタム受付フレームワークのJSON-XML変換（要求電文）の呼び出し口※3

JSON-XML変換前の要求電文

URCP

CUSTM

JCB

6

カスタム受付フレームワークのJSON-XML変換（応答電文）の応答受信口※4

JSON-XML変換前の応答電文

URCP

CUSTM

JCA

（凡例）

取得ポイント，プロトコル種別，詳細位置の出力内容の意味を次に示します。

URCP：ユーザ定義受付

CUSTM：カスタム受付

IN：カスタム受付フレームワークの入口

OUT：カスタム受付フレームワークの出口

RQA：データ変換（要求電文）の応答口

RSB：データ変換（応答電文）の呼び出し口

JCB：カスタム受付フレームワークのJSON-XML変換（要求電文）の呼び出し口

JCA：カスタム受付フレームワークのJSON-XML変換（応答電文）の応答口

注※1

リクエスト処理時にデータ変換を実行する場合だけ出力します。

注※2

レスポンス処理時にデータ変換を実行する場合だけ出力します。

注※3

リクエスト処理時にJSON-XML変換を実行する場合だけ出力します。

注※4

レスポンス処理時にJSON-XML変換を実行する場合だけ出力します。

HTTPアダプタの場合

HTTPアダプタのJSON-XML変換機能では，ユーザ電文トレースの出力契機がNORMALの場合，トレース取得ポイントとして次の個所が追加されます。

リクエスト処理時のJSON-XML変換の前（図中の番号5）

レスポンス処理時のJSON-XML変換の後（図中の番号6）

HTTPアダプタのユーザ電文トレースの取得ポイントを次の図に示します。

図7‒151　ユーザ電文トレースの取得ポイント（HTTP連携でのJSON-XML変換機能（HTTPアダプタ））

トレース取得ポイント，出力電文の種類，および詳細位置を次の表に示します。表の「図中の番号」は，図中の番号と対応しています。

表7‒191　　ユーザ電文トレースの取得ポイント（HTTP連携でのJSON-XML変換機能（HTTPアダプタ））

図中の番号

トレース取得ポイント

出力電文

ユーザ電文トレース開始の詳細

取得ポイント

プロトコル種別

詳細位置

1

サービスアダプタ呼び出し前

サービス部品電文

SVC

CUSTM

CAL

2

サービスアダプタ応答後

サービス部品電文

SVC

CUSTM

RET

3

データ変換（要求電文）の呼び出し口※1

データ変換前の要求電文

CNVST

CUSTM

RQB

4

データ変換（応答電文）の応答受信口※2

データ変換後の応答電文

CNVST

CUSTM

RSA

5

カスタムアダプタ開発フレームワークのJSON-XML変換の呼び出し口※3

JSON-XML変換前の要求電文

CNVJS

CUSTM

JCB

6

カスタムアダプタ開発フレームワークのJSON-XML変換の応答受信口※4

JSON-XML変換前の応答電文

CNVJS

CUSTM

JCA

（凡例）

取得ポイント，プロトコル種別，詳細位置の出力内容の意味を次に示します。

SVC：サービス部品呼び出し（サービスアダプタ内）

CNVST：サービスアダプタのデータ変換

CNVJS：JSON-XML変換（カスタムアダプタ開発フレームワークのJSON-XML間の変換時）

CUSTM：カスタムアダプタ

CAL：呼び出し（ビジネスプロセスやサービス呼び出し）

RET：応答受信（ビジネスプロセスやサービス呼び出しの応答）

RQB：サービスアダプタの要求時のデータ変換前

RSA：サービスアダプタの応答時のデータ変換後

JCB：カスタムアダプタ開発フレームワークのJSON-XML変換前

JCA：カスタムアダプタ開発フレームワークのJSON-XML変換後

注※1

リクエスト処理時にデータ変換を実行する場合だけ出力します。

注※2

レスポンス処理時にデータ変換を実行する場合だけ出力します。

注※3

リクエスト処理時にJSON-XML変換を実行する場合だけ出力します。

注※4

レスポンス処理時にJSON-XML変換を実行する場合だけ出力します。

7.7.17　コマンドアダプタ実行時の障害対策

コマンドアダプタでは，システムの性能を検証したり，障害の原因を解析したりするための情報が，ログファイルまたはトレースファイルに出力されます。コマンドアダプタで出力されるログおよびトレースの種類を次の表に示します。

表7‒192　ログ・トレースの種類（コマンドアダプタの場合）

ログ・トレース

出力情報

説明

メッセージログ

コマンドアダプタで発生した各種情報が，メッセージとして出力されます。

稼働情報（起動・停止・障害など）をメッセージとして確認できます。なお，メッセージログの出力先は，アプリケーションサーバおよびサービスプラットフォーム全体で共通のため，システムの稼働状況を一括して確認できます。

メンテナンスログ

コマンドアダプタ内部の保守情報として，次の情報が出力されます。

日付

時刻

実行クラス名

内部メソッド名

発生した例外

指定した引数の情報

内部メソッドの発行時刻およびシーケンスを確認できます。

性能解析トレース

サービスプラットフォームシステム全体の性能解析トレース取得ポイントで，次の情報が出力されます。

日付

時刻

リクエスト情報

トレース取得元情報

コマンドアダプタの性能解析トレース取得ポイントでは，コマンドアダプタ固有の情報が出力されます。

サービスリクエスタから要求を受け付けて，実行結果を返却するまでの一連の処理で出力される性能解析情報を基に，サービスプラットフォームシステムの性能を検証できます。

例外ログ

コマンドアダプタで発生した例外情報（スタックトレース）が出力されます。

コマンドアダプタの例外情報を確認できます。障害要因の解析に利用できます。

(1)　snapshotログ

mngsvrutilコマンドやsnapshotlogコマンドでの採取対象にコマンドアダプタを追加するには，snapshotログ収集対象定義ファイルの修正が必要な場合があります。

サービスプラットフォームが提供するほかのサービスアダプタと同じレベルの収集設定とする場合には，次に示す内容をそれぞれのファイルに追記してください。すでに記述されている場合は修正不要です。

(a)　snapshotlog.conf

${cosminexus.home}/CC/server/public/ejb/.+/logs/CSCADP/ADPCMD/maintenance/.+/cscadpcmdexp_.*¥.log
&{ejb.public.directory}/ejb/.+/logs/CSCADP/ADPCMD/maintenance/.+/cscadpcmdexp_.*¥.log
&{ejb.server.log.directory}/CSCADP/ADPCMD/maintenance/.+/cscadpcmdexp_.*¥.log
${cosminexus.home}/CSC/custom-adapter/Command/config/.+
${cosminexus.home}/CSC/custom-adapter/Command/config/.+/.+

(b)　snapshotlog2.conf

${cosminexus.home}/CC/server/public/ejb/.+/logs/CSCADP/ADPCMD/maintenance/.+/cscadpcmdmnt_.*¥.log
&{ejb.public.directory}/ejb/.+/logs/CSCADP/ADPCMD/maintenance/.+/cscadpcmdmnt_.*¥.log
&{ejb.server.log.directory}/CSCADP/ADPCMD/maintenance/.+/cscadpcmdmnt_.*¥.log

(c)　snapshotlog.param.conf

${cosminexus.home}/CSC/custom-adapter/Command/config/.+
${cosminexus.home}/CSC/custom-adapter/Command/config/.+/.+

(2)　メッセージログ

メッセージログのJ2EEサーバの稼働ログに，コマンドアダプタで発生した各種情報がメッセージとして出力されます。

メッセージログの出力内容や出力先については，「7.4.1　メッセージログ」を参照してください。

(a)　出力レベル設定

コマンドアダプタが出力するメッセージのうち，どのレベルまでメッセージログに出力するかを設定できます。メッセージの情報種別と，設定値との対応を次に示します。

表7‒193　メッセージの情報種別と出力レベルとの対応関係

情報種別

出力レベル

0

10

20

エラーメッセージ

例外や障害の発生時

○

○

○

警告メッセージ

システムを運用する上で確認する必要があるもの

△

○

○

インフォメーションメッセージ

コマンドアダプタの状態変更（起動・停止）

イベント通知（外部コマンドの起動・終了）

△

△

○

（凡例）

○：すべて出力されます。

△：重要なメッセージだけ出力されます。

出力レベルは，コマンドアダプタ実行環境プロパティファイルで設定できます。プロパティキーを次の表に示します。

表7‒194　メッセージログの出力レベル設定

設定

キー

デフォルト値

指定可能値

メッセージログの出力レベル

adpcmd.log.messagelog.level

10

0

10

20

(b)　出力先

メッセージログの出力先を次に示します。

J2EEサーバ稼働ログの出力先に指定されたパス

J2EEサーバ稼働ログの出力先は，HCSCサーバが動作するJ2EEサーバ用オプション定義ファイル（usrconf.cfg）のejb.server.log.directoryキーで指定します。詳細は，マニュアル「アプリケーションサーバリファレンス 定義編(サーバ定義)」の「2.2.2　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」，および「2.2.3　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」を参照してください。

メッセージログのログファイル名を次の表に示します。

表7‒195　メッセージログのログファイル名

ログファイルの出力モード

ログファイル名

ラップアラウンドモードの場合

cjmessage<面数>.log※

シフトモードの場合

cjmessage.log※

注※

ログファイルはアプリケーションサーバおよびサービスプラットフォーム全体で共通です。HCSCサーバ上にあるすべての製品の運用情報および障害情報のメッセージログが出力されます。

(c)　ファイル面数

出力ファイル面数は，HCSCサーバが動作するJ2EEサーバ用ユーザプロパティファイル（usrconf.properties）のejbserver.logger.channels.define.<チャネル名>.filenumキーで指定します。詳細については，次に示すマニュアルを参照してください。

推奨モードの場合

マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.3　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」

V9互換モードの場合

マニュアル「アプリケーションサーバ 機能解説 互換編」の「10.1.1　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」

(d)　ファイルサイズ

出力ファイルサイズは，HCSCサーバが動作するJ2EEサーバ用ユーザプロパティファイル（usrconf.properties）のejbserver.logger.channels.define.<チャネル名>.filesizeキーで指定します。詳細については，次に示すマニュアルを参照してください。

推奨モードの場合

マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.3　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」

V9互換モードの場合

マニュアル「アプリケーションサーバ 機能解説 互換編」の「10.1.1　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」

(3)　メンテナンスログ

コマンドアダプタの内部メソッド発行の時刻やシーケンスを確認できます。保守員が障害解析のために使用します。

(a)　出力レベル設定

どのレベルまでメンテナンスログに出力するかを設定できます。出力する情報種別と，設定値との対応を次の表に示します。

表7‒196　メンテナンスログの出力情報種別と出力レベルとの対応関係

情報種別

出力レベル

1

2

3

4

5

エラー情報，例外発生原因

○

○

○

○

○

主要外部モジュールのインターフェース情報

カスタムアダプタフレームワーク関連

×

○

○

○

○

外部モジュールのインターフェース情報

外部コマンドプロセス関連

×

×

○

○

○

主要なコンポーネント内インターフェース情報

×

×

×

○

○

デバッグ情報

×

×

×

×

○

（凡例）

○：出力されます。

×：出力されません。

出力レベルは，コマンドアダプタ実行環境プロパティファイルで設定できます。プロパティキーを次の表に示します。

表7‒197　メンテナンスログの出力レベル設定

設定

キー

デフォルト値

指定可能値

メンテナンスログの出力レベル

adpcmd.log.methodtrace.level

3

1

2

3

4

5

(b)　出力形式

メンテナンスログの出力形式を次の図に示します。

図7‒152　メンテナンスログの出力形式（コマンドアダプタ）

(c)　出力される内容

メンテナンスログに出力される内容を次の表に示します。

表7‒198　メンテナンスログに出力される内容（コマンドアダプタ）

項目

内容

番号

メンテナンスログの出力通番が表示されます。

日付

メンテナンスログの取得日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

メンテナンスログの取得時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

製品ID

製品を特定するための識別子として，コマンドアダプタを示す「ADPCMD」と，バージョン情報が出力されます。

バージョン情報の形式は次のとおりです。

正規版製品：VV-RR

修正版製品：VV-RR-SS

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID，種別

表示されません。

出力種別

メンテナンスログの取得ポイント情報（取得位置）が出力されます。

BGN：メソッドの開始

END：メソッドの終了

CAL：メソッドの呼び出し

RET：メソッドの戻り

THR：例外のスロー

CTH：例外のキャッチ

クラス名

メンテナンスログを取得するクラス名が出力されます。

メソッド名

メンテナンスログを取得するメソッド名が出力されます。

入出力情報

メンテナンスログを取得するメソッドの入出力情報またはスタックトレースが出力されます。

CRLF

レコードの終端符号が出力されます。

(d)　出力先

メンテナンスログの出力先を次に示します。

<J2EEサーバのログ出力ディレクトリ>/CSCADP/ADPCMD/maintenance/<サービスID>

メンテナンスログのログファイル名を次の表に示します。

表7‒199　メンテナンスログのログファイル名（コマンドアダプタ）

ログファイルの出力モード

ログファイル名

ラップアラウンドモードの場合

cscadpcmdmnt_<HCSCサーバ名>_<面数>.log

シフトモードの場合

cscadpcmdmnt_<HCSCサーバ名>_.log

なお，ログファイルの面数はコマンドアダプタ実行環境プロパティファイル，またはコマンドアダプタ実行環境共通プロパティファイルのadpcmd.log.methodtrace.filenumプロパティ，ログファイルのサイズはadpcmd.log.methodtrace.filesizeプロパティで指定します。

コマンドアダプタ実行環境プロパティファイルの詳細は，マニュアル「サービスプラットフォーム リファレンス」の「6.15.3　コマンドアダプタ実行環境プロパティファイル」を参照してください。コマンドアダプタ実行環境共通プロパティファイルについては，マニュアル「サービスプラットフォーム リファレンス」の「6.15.4　コマンドアダプタ実行環境共通プロパティファイル」を参照してください。

(4)　性能解析トレース（PRFトレース）

サービスリクエスタから要求を受け付けて，実行結果を返却するまでの一連の処理で出力される性能解析情報を基に，アプリケーションサーバおよびサービスプラットフォームシステムの性能を検証できます。コマンドアダプタの性能解析トレース取得ポイントでは，コマンドアダプタ固有の情報が出力されます。保守員が性能ボトルネックの解析のために使用します。

(a)　出力形式

性能解析トレースファイルに出力される形式は，J2EEサーバの性能解析トレースと同様です。詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.3　Management Serverを利用した性能解析トレースファイルの収集」を参照してください。

(b)　出力先

性能解析トレースの出力先およびトレースファイル名を次の表に示します。

表7‒200　性能解析トレースの出力先およびトレースファイル名

トレースの出力先パス

トレースファイル名

<環境変数PRFSPOOLの設定ディレクトリ>¥utt¥prf¥<PRF識別子>¥dcopltrc※

prf_<n>

（凡例）

n：001からファイル面数の最大値までの整数が入ります。

注※

性能解析トレースの出力先は，アプリケーションサーバおよびサービスプラットフォーム全体で共通です。詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.3　Management Serverを利用した性能解析トレースファイルの収集」を参照してください。

(c)　ファイル面数

出力ファイル面数のデフォルトは4面です。出力ファイル面数は，運用管理ポータルまたはcprfコマンドで変更できます。運用管理ポータルの詳細はマニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」を，cprfコマンドの詳細はマニュアル「アプリケーションサーバ リファレンス コマンド編」を参照してください。

(d)　ファイルサイズ

運用管理ポータルでファイルサイズを設定した場合,ファイルサイズのデフォルトは32MBです。cprfコマンドでファイルサイズを設定した場合，ファイルサイズのデフォルトは8MBです。ファイルサイズは，運用管理ポータルまたはcprfコマンドで変更できます。運用管理ポータルの詳細はマニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」を，cprfコマンドの詳細はマニュアル「アプリケーションサーバ リファレンス コマンド編」を参照してください。

(e)　性能解析トレースの取得ポイント

性能解析トレースの取得ポイントを次の図に示します。

図7‒153　性能解析トレースの取得ポイント（コマンドアダプタ）

イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。表の「図中の番号」は，図中の番号と対応しています。

表7‒201　性能解析トレース取得ポイント（コマンドアダプタ）

イベントID

図中の番号

トレース取得ポイント

レベル※1

0xab06

1

リクエスト受付時

標準

0xab08

2

外部コマンド起動時

標準

0xab09

3

外部コマンドプロセス完了時※2

標準

0xab07

4

レスポンス送信時

標準

注※1

性能解析トレースのレベルの変更方法については，「トレース取得レベルの変更」，マニュアル「アプリケーションサーバ リファレンス コマンド編」，およびマニュアル「アプリケーションサーバ 機能解説 保守／移行編」を参照してください。デフォルトは標準です。

注※2

外部コマンドの処理中にタイムアウトが発生した場合も，トレース取得ポイントは外部コマンドプロセス完了時と同様です。

(5)　例外ログ

例外ログは，メンテナンスログと同じタイミングで開始・終了し，例外情報（スタックトレース）を採取してファイルに出力します。例外ログファイルの出力先はコマンドアダプタのメンテナンスログと同じディレクトリであるため，個別には変更できません。

(a)　出力形式

例外ログに出力される形式を次に示します。

図7‒154　例外ログの出力形式（コマンドアダプタ）

(b)　出力される内容

例外ログに出力される内容を次の表に示します。

項目

内容

番号

例外ログの出力通番が表示されます。

日付

例外ログの取得日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

例外ログの取得時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

製品ID

製品を特定するための識別子として，コマンドアダプタを示す「ADPCMD」が出力されます。

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID

空白

スタックトレース情報

スタックトレース情報が出力されます。

CRLF

レコードの終端符号が出力されます。

(c)　出力先

例外ログの出力先を次に示します。

<J2EEサーバのログ出力ディレクトリ>/CSCADP/ADPCMD/maintenance/<サービスID>

例外ログのログファイル名を次の表に示します。

表7‒202　例外ログのログファイル名（コマンドアダプタ）

ログファイルの出力モード

ログファイル名

ラップアラウンドモードの場合

cscadpcmdexp_<HCSCサーバ名>_<面数>.log

シフトモードの場合

cscadpcmdexp_<HCSCサーバ名>_.log

なお，ログファイルの面数はコマンドアダプタ実行環境プロパティファイル，またはコマンドアダプタ実行環境共通プロパティファイルのadpcmd.log.exptrace.filenumプロパティで，ログファイルのサイズはadpcmd.log.exptrace.filesizeプロパティで指定します。なお，これらのプロパティはコマンドアダプタ実行環境共通プロパティファイルでも指定できます。

コマンドアダプタ実行環境プロパティファイルについては，マニュアル「サービスプラットフォーム リファレンス」の「6.15.3　コマンドアダプタ実行環境プロパティファイル」を参照してください。コマンドアダプタ実行環境共通プロパティファイルについては，マニュアル「サービスプラットフォーム リファレンス」の「6.15.4　コマンドアダプタ実行環境共通プロパティファイル」を参照してください。

(6)　外部コマンドプロセスの標準エラー出力ログ

外部コマンドプロセスの標準エラー出力への出力内容を，ログファイルで確認できます。

(a)　出力可否の設定

コマンドアダプタごとに，標準エラー出力ログ機能の有効または無効を設定できます。コマンドアダプタ実行環境プロパティファイルのプロパティキーを次の表に示します。

表7‒203　標準エラー出力ログの有効または無効の設定

設定

キー

デフォルト値

指定可能値

標準エラー出力ログの有効または無効の設定

adpcmd.log.stderr.enable

true

true

false

標準エラー出力ログを有効にするには，trueを設定します。

(b)　標準エラー出力の文字コード

コマンドアダプタごとに，標準エラー出力の内容を読み込む際の文字コードを設定できます。コマンドアダプタ実行環境プロパティファイルのプロパティキーを次の表に示します。

表7‒204　標準エラー出力の文字コードの設定

設定

キー

デフォルト値

指定可能値

標準エラー出力の文字コードの設定

adpcmd.log.stderr.charset

UTF-8

UTF-8

MS932

EUC-JP

(c)　出力形式

標準エラー出力ログの出力形式を次の図に示します。

図7‒155　標準エラー出力ログの出力形式

(d)　出力される内容

標準エラー出力ログに出力される内容を次の表に示します。

表7‒205　標準エラー出力ログに出力される内容（コマンドアダプタ）

項目

内容

番号

標準エラー出力ログの出力通番が表示されます。

日付

標準エラー出力ログの取得日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

標準エラー出力ログの取得時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

製品ID

製品を特定するための識別子として，コマンドアダプタを示す「ADPCMD」と，バージョン情報が出力されます。

バージョン情報の形式は次のとおりです。

正規版製品：VV-RR

修正版製品：VV-RR-SS

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのID※が出力されます。

ID

標準エラー出力の内容の場合：空白

外部コマンド起動直後：KDEC81622-Iメッセージ

標準エラー出力

標準エラー出力の内容の場合：

LF（0x0a）を検出したとき，LFの1バイト前までを文字列に変換して出力します。

ただし，1バイト前がCR（0x0d）だったとき，CRは出力しません。

1024バイトまでLFを検出しないまま，1024バイトを超過したとき， 1024バイトまでを文字列に変換して出力します。

外部コマンドプロセスが終了したとき，未出力データを文字列に変換して出力します。

外部コマンド起動直後メッセージの場合：メッセージとパラメタを出力します。

CRLF

レコードの終端符号が出力されます。

注※

スレッドIDはほかのログと一致しません。

(e)　出力先

外部コマンドプロセスの標準エラー出力ログの出力先を次に示します。

<J2EEサーバのログ出力ディレクトリ>/CSCADP/ADPCMD/maintenance/<サービスID>

標準エラー出力ログのログファイル名を次の表に示します。

表7‒206　標準エラー出力ログのログファイル名（コマンドアダプタ）

ログファイルの出力モード

ログファイル名

ラップアラウンドモードの場合

cscadpcmdstderr_<HCSCサーバ名>_<面数>.log

シフトモードの場合

cscadpcmdstderr_<HCSCサーバ名>_.log

なお，ログファイルの面数はコマンドアダプタ実行環境プロパティファイル，またはコマンドアダプタ実行環境共通プロパティファイルのadpcmd.log.exptrace.filenumプロパティで，ログファイルのサイズはadpcmd.log.exptrace.filesizeプロパティで指定します。なお，これらのプロパティはコマンドアダプタ実行環境共通プロパティファイルでも指定できます。

(7)　外部コマンドプロセス起動後に例外が発生した場合の対処

外部コマンドの起動から，タイムアウト待ちの間でJavaの例外が内部で発生した場合，外部コマンドプロセスの強制終了を試みます。

強制終了に成功した場合，メッセージログに警告メッセージ（KDEC81559-W）が出力されます。

強制終了に失敗した場合，メッセージログにエラーメッセージ（KDEC81560-E）が出力されます。この場合，外部コマンドプロセスの状態については，システム運用者が確認する必要があります。

(8)　スレッドの解放

コマンドアダプタでは，1リクエストに対して最大3つのスレッドを生成します。

生成するスレッドとスレッド数を次の表に示します。

表7‒207　生成するスレッドとスレッド数

スレッドの用途

生成スレッド数

外部コマンド実行中に必要なスレッド

2

強制終了用スレッド※1

プロセスタイムアウト発生時※2

1

外部コマンドプロセス起動後の例外発生時

1

注※1

生成スレッドは，1リクエストに対して最大1つです。

注※2

タイムアウト発生時の外部コマンドプロセス強制終了が有効のときだけ生成されます。

条件によってはコマンドアダプタ応答後にスレッドが残留します。そのためJ2EEサーバのリソースが枯渇しないように，適切に対処する必要があります。

発生するメッセージと対処方法を次の表に示します。

表7‒208　発生メッセージと残留スレッドへの対処

発生メッセージと条件

残留スレッド数

対処方法

KDEC81553-Eが発生，

かつタイムアウト発生時の外部コマンドプロセス強制終了可否が無効のとき

2

必要に応じて起動したプロセスを停止してください。

KDEC81561-Eが発生

2

コマンドプロセスからのサブプロセスをバックグラウンドで起動することは禁止事項です。コマンドアダプタから指定するコマンドの処理を見直してください。

バックグラウンドで実行されているサブプロセスを外部から終了させてください。

KDEC81557-Eが発生

1

起動したプロセスの状態を確認してください。また，必要に応じて起動したプロセスを停止してください。

KDEC81560-Eが発生

1

起動したプロセスの状態を確認してください。また，必要に応じて起動したプロセスを停止してください。

注意事項

コマンドアダプタで指定した外部コマンドプロセスから，サブプロセスをバックグラウンドで起動することは禁止事項です。サブプロセスをバックグラウンドで起動した場合，メッセージの出力の有無に関係なくスレッドが残留するおそれがあります。

(9)　ファイルディスクリプタの解放

コマンドアダプタでは，1リクエストに対して最大3つのファイルディスクリプタを消費します。また，コマンドアダプタ応答後も，外部コマンドプロセスが終了しないかぎりファイルディスクリプタは解放されません。必要に応じて起動したプロセスを停止してください。

ファイルディスクリプタ数の見積もり方法については，「付録I.1　ファイルディスクリプタ数の見積もり」を参照してください。

7.7.18　SFTPアダプタ実行時の障害対策

SFTPアダプタに関する障害情報には次の種類があります。

メッセージログ

保守用ログ

性能解析トレース

SFTPプロトコルトレース

例外ログ

ユーザ認証情報管理コマンドのメッセージログ

これらの障害情報について説明します。

(1)　メッセージログ

メッセージログのJ2EEサーバの稼働ログに，SFTPアダプタで発生した各種情報がメッセージとして出力されます。

メッセージログの出力内容や出力先については，「7.4.1　メッセージログ」を参照してください。

(2)　保守用ログ

SFTPアダプタでの保守用ログについて説明します。

●保守用ログの出力形式

保守用ログの出力形式を次の図に示します。

図7‒156　保守用ログの出力形式（SFTPアダプタ）

●出力される内容

保守用ログに出力される内容を次の表に示します。

表7‒209　保守用ログに出力される内容（SFTPアダプタ）

項目

内容

番号

保守用ログの出力通番が表示されます。

日付

保守用ログの取得日付がyyyy/mm/ddの形式で出力されます。

時刻

保守用ログの取得時刻がhh:mm:ss.SSSの形式で出力されます。

製品ID

製品を特定するための識別子として，SFTPアダプタを示す「SFTPADP」が出力されます。また，バージョン情報が出力されます。

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID，種別

表示されません。

出力種別

保守用ログの取得ポイント情報（取得位置）が出力されます。

BGN：メソッドの開始

END：メソッドの終了

CAL：メソッドの呼び出し

RET：メソッドの戻り

THR：例外のスロー

CTH：例外のキャッチ

DBG：デバッグ情報

クラス名

保守用ログを取得するクラス名が出力されます。

メソッド名

保守用ログを取得するメソッド名が出力されます。

入出力情報

保守用ログを取得するメソッドの入出力情報（引数の値，戻り値，例外名など）が出力されます。

CRLF

レコードの終端符号が出力されます。

●保守用ログの出力先

<J2EEサーバのログ出力ディレクトリ>¥CSCADP¥SFTPADP¥maintenance¥<サービスID>

保守用ログのログファイル名を次の表に示します。

表7‒210　保守用ログのファイル名（SFTPアダプタ）

ログファイルの出力モード

ログファイル名

ラップアラウンドモードの場合

cscsftpadpmtd_<HCSCサーバ名>_<面数>.log

シフトモードの場合

cscsftpadpmtd_<HCSCサーバ名>_.log

なお，ログファイルの面数は，SFTPアダプタ実行環境プロパティファイルのsftpadp.methodtrace.filenumプロパティで指定します。ログファイルのサイズは，SFTPアダプタ実行環境プロパティファイルのsftpadp.methodtrace.filesizeプロパティで指定します。

SFTPアダプタ実行環境プロパティファイルの詳細は，マニュアル「サービスプラットフォーム リファレンス」の「6.16.1　SFTPアダプタ実行環境プロパティファイル」を参照してください。

(3)　性能解析トレース

性能解析トレースを取得するには設定が必要です。設定の詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.　性能解析トレースを使用した性能解析」を参照してください。

(a)　性能解析トレースの出力形式

性能解析トレースファイルに出力される形式は，J2EEサーバの性能解析トレースと同様です。詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.3　Management Serverを利用した性能解析トレースファイルの収集」を参照してください。

(b)　出力される内容

性能解析トレースファイルに出力される内容を次の表に示します。

表7‒211　性能解析トレースファイルに出力される内容（SFTPアダプタ）

項目

内容

イベントID

取得ポイントのイベントIDが出力されます。

取得ポイントの詳細は，項目「(c) 性能解析トレースの取得ポイント」を参照してください。

リターンコード

取得ポイント種別が出力されます。

0：正常終了

1：異常終了

インターフェース名

クラス名が出力されます。

オペレーション名

メソッド名が出力されます。

オプション情報

サービスID

HCSCコンポーネントのサービスIDが出力されます。

オペレーション

次のどれかが出力されます。

PUT

GET

GETINFO

SFTPコマンド名

cd，get，lsなどが出力されます。

転送ファイル名またはパス

PUTオペレーションの場合は，ローカルファイル名が出力されます。

GETオペレーションの場合は，リモートファイル名が出力されます。

GETINFOオペレーションの場合は，リモートパスが出力されます。

転送サイズ

転送ファイルのサイズがバイト単位で出力されます。

転送前後コマンドやGETINFOオペレーションの場合は出力されません。

任意時刻からのナノ秒

java.lang.SystemクラスのnanoTimeメソッドの戻り値が出力されます。

例外クラス名

例外が発生したクラス名が出力されます。

(c)　性能解析トレースの取得ポイント

性能解析トレースの取得ポイントを次の図に示します。

図7‒157　性能解析トレースの取得ポイント（SFTPアダプタ）

イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。表の「図中の番号」は上の図の番号と対応しています。

表7‒212　性能解析トレースの取得ポイント（SFTPアダプタ）

イベントID

図中の番号

トレース取得ポイント

レベル

0xAB0A

1

リクエスト受付時

B

0xAB0C

2

SFTPコマンド（転送コマンド・リストコマンド以外）の実行時

A

0xAB0D

3

SFTPコマンド（転送コマンド・リストコマンド以外）のリプライ時

A

0xAB0E

4

転送コマンドまたはリストコマンド実行時

A

0xAB0F

5

転送コマンドまたはリストコマンドリプライ時

A

0xAB0B

6

レスポンス送信時

B

（凡例）

A：「標準」であることを示します。

B：「詳細」であることを示します。

(4)　SFTPプロトコルトレース

SFTPプロトコルトレースは，SFTPアダプタとSFTPサーバ間のSFTP通信のトレースであり，必ず出力されます。次に示す処理の内容を出力します。

SFTPサーバとの接続

転送前コマンド

転送コマンド

転送後コマンド

SFTPサーバとの接続の切断

SFTPプロトコルトレースについて説明します。

(a)　出力形式

SFTPプロトコルトレースの出力形式を次の図に示します。

図7‒158　SFTPプロトコルトレースの出力形式

(b)　出力される内容

SFTPプロトコルトレースに出力される内容を次の表に示します。

表7‒213　SFTPプロトコルトレースに出力される内容

項目

内容

番号

SFTPプロトコルトレースの出力通番が出力されます。

日付

SFTPプロトコルトレースの取得日付がyyyy/mm/ddの形式で出力されます。

時刻

SFTPプロトコルトレースの取得時刻がhh:mm:ss.SSSの形式で出力されます。

製品ID

製品を特定するための識別子として，SFTPアダプタを示す「SFTPADP」が出力されます。

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID

出力されません。

種別

SFTPプロトコルトレースの種別が出力されます。

CON：接続または切断

CMD：コマンド実行

REP：応答行

EXP：エラー応答行（異常終了時だけ）

リクエストID

受付で作成されたリクエストIDが出力されます。共通フォルダを使用している場合は，リクエストIDが存在しないため「****」が出力されます。

IPv4でリクエストIDが作成された場合は，最大49桁で出力され，リクエストIDの右側には不足分の半角スペースが設定されます。

トレース情報

SFTPプロトコルトレース情報として，次に示す内容が出力されます。

種別がCONの場合

接続時：Connected to <接続先> Port <ポート番号>

切断時：Disconnected to <接続先> Port <ポート番号>

種別がCMDの場合

SFTPコマンドおよび引数

種別がREPの場合

<コマンド名> command successful

種別がEXPの場合

エラーメッセージ

CRLF

レコードの終端符号が出力されます。

(c)　出力先

SFTPプロトコルトレースの出力先を次に示します。

<J2EEサーバのログ出力ディレクトリ>¥CSCADP¥SFTPADP¥<サービスID>

SFTPプロトコルトレースのトレースファイル名を次の表に示します。

表7‒214　SFTPプロトコルトレースのトレースファイル名

トレースファイルの出力モード

トレースファイル名

ラップアラウンドモードの場合

sftpprotocoltrace_<面数>.log

シフトモードの場合

sftpprotocoltrace_.log

<J2EEサーバのログ出力ディレクトリ>は，HCSCサーバが動作するJ2EEサーバ用オプション定義ファイル（usrconf.cfg）のejb.server.log.directoryキーで指定します。usrconf.cfgの詳細は，マニュアル「アプリケーションサーバリファレンス 定義編(サーバ定義)」の「2.2.2　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。

なお，ログファイルの面数は，SFTPアダプタ実行環境プロパティファイルのsftpadp.sftpprotocoltrace.filenumプロパティで指定します。ログファイルのサイズは，SFTPアダプタ実行環境プロパティファイルのsftpadp.sftpprotocoltrace.filesizeプロパティで指定します。

詳細は，マニュアル「サービスプラットフォーム リファレンス」の「6.16.1　SFTPアダプタ実行環境プロパティファイル」を参照してください。

(5)　例外ログ

トレースの開始以降に発生した例外情報（スタックトレース）を例外ログとして別のファイルに出力します。例外ログでは，出力ファイルのパスと出力レベルは設定しないで，出力ファイルのサイズと面数を設定します。また，例外ログファイルは保守用ログと同じディレクトリに出力されます。

SFTPアダプタの例外ログについて説明します。

(a)　出力形式

例外ログの出力形式を次の図に示します。

図7‒159　例外ログの出力形式

(b)　出力される内容

例外ログに出力される内容を次の表に示します。

表7‒215　例外ログに出力される内容（SFTPアダプタ）

項目

内容

番号

例外ログの出力通番が表示されます。

日付

例外ログの取得日付がyyyy/mm/ddの形式で出力されます。

時刻

例外ログの取得時刻がhh:mm:ss.SSSの形式で出力されます。

製品ID

製品を特定するための識別子として，SFTPアダプタを示す「SFTPADP」が出力されます。

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID

空白

スタックトレース情報

スタックトレース情報が出力されます。

CRLF

レコードの終端符号が出力されます。

(c)　出力先

例外ログの出力先を次に示します。保守用ログと同じパスです。

<J2EEサーバのログ出力ディレクトリ>¥CSCADP¥SFTPADP¥maintenance¥<サービスID>

例外ログのログファイル名を次の表に示します。

表7‒216　例外ログのログファイル名

ログファイルの出力モード

ログファイル名

ラップアラウンドモードの場合

cscsftpadpexp_<HCSCサーバ名>_<面数>.log

シフトモードの場合

cscsftpadpexp_<HCSCサーバ名>_.log

なお，ログファイルの面数は，SFTPアダプタ実行環境プロパティファイルのsftpadp.exptrace.filenumプロパティで指定します。ログファイルのサイズは，SFTPアダプタ実行環境プロパティファイルのsftpadp.exptrace.filesizeプロパティで指定します。

SFTPアダプタ実行環境プロパティファイルの詳細は，マニュアル「サービスプラットフォーム リファレンス」の「6.16.1　SFTPアダプタ実行環境プロパティファイル」を参照してください。

(6)　ユーザ認証情報管理コマンドのメッセージログ

ユーザ認証情報管理コマンドの実行時の情報（通知・エラーなど）が，メッセージとしてユーザ認証情報管理コマンドのメッセージログに出力されます。このログを参照することで，過去に実行したコマンドの障害情報や稼働情報を確認できます。

ユーザ認証情報管理コマンドのメッセージログについては，「7.4.8　ユーザ認証情報管理コマンドのメッセージログ」を参照してください。

7.7.19　Kafka受付実行時の障害対策

この項では，KafkaインバウンドアダプタおよびKafka受付の運用時に発生する障害に対して取得できる情報の種類について説明します。

(1)　障害情報の取得（Kafkaインバウンドアダプタ）

Kafkaインバウンドアダプタに関する障害情報には次の種類があります。

メッセージログ

保守用ログ

データトレース

性能解析トレース

Kafkaプロトコルトレース

ここでは，これらの障害情報について説明します。

なお，Kafkaインバウンドアダプタでは，このマニュアルで説明する障害情報のほかに，Kafkaインバウンドアダプタが動作するJ2EEサーバおよびJavaVMが出力する資料があります。J2EEサーバおよびJavaVMが出力する資料については，マニュアル「アプリケーションサーバ機能解説 保守／移行編」の「4.　トラブルシューティングで必要な資料の出力先と出力方法」を参照してください。

(a)　メッセージログ（Kafkaインバウンドアダプタ）

メッセージログには，Kafkaインバウンドアダプタのエラー情報，および稼働情報を示すメッセージが出力されます。ここでは，Kafkaインバウンドアダプタでのメッセージログについて説明します。

●メッセージログの出力形式

メッセージログの出力形式を次に示します。

<日付> <時刻> <pid> <tid> <メッセージID> <メッセージテキスト>

●出力される内容

メッセージログに出力される内容を次の表に示します。

表7‒217　メッセージログに出力される内容（Kafkaインバウンドアダプタ）

項目

内容

日付

メッセージログの取得日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

メッセージログの取得時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

pid

プロセスを識別するためのIDが出力されます。OSが管理するプロセスIDとは異なります。

tid

スレッドを識別するためのIDが出力されます。OSが管理するスレッドIDとは異なります。

メッセージID

メッセージIDが出力されます。

メッセージテキスト

メッセージの内容が出力されます。

●メッセージログの出力先

<J2EEサーバのログ出力ディレクトリ>¥csc¥inbound-adapter¥kafka¥Kafka_Inbound_Resource_Adapter

<J2EEサーバのログ出力ディレクトリ>は，usrconf.cfg（J2EEサーバ用オプション定義ファイル）のejb.server.log.directoryキーで変更できます。デフォルトは，<サービスプラットフォームのインストールディレクトリ>¥ejb¥<サーバ名称>¥logsです。usrconf.cfgの詳細は，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.2　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。

メッセージログのログファイル名を次の表に示します。

表7‒218　メッセージログのログファイル名（Kafkaインバウンドアダプタ）

ファイルの種類

ログファイル名

現用ファイル

message.log

バックアップファイル※

message.log.<面数>

注※

現用ファイルのサイズが1面当たりのファイルサイズを超えた場合，バックアップファイルにリネームされます。

新しいログファイルの方が大きい番号となります。一度作成されたログファイルは削除されません。なお，ファイルの改行コードは「LF」です。

メッセージログの出力レベル，ファイルのサイズ，およびファイル面数は，RARファイルの属性を設定するConnector属性ファイルで変更できます。プロパティを次に示します。

server_message_logLevel=メッセージログの出力レベル

server_message_maxFileSize=メッセージログのファイルサイズ

server_message_maxBackupIndex=バックアップファイルの面数

設定手順については，「3.1.2(11)　Kafkaインバウンドアダプタのセットアップ」を参照してください。

(b)　保守用ログ（Kafkaインバウンドアダプタ）

保守用ログには，Kafkaインバウンドアダプタでのエラー発生時のログが出力されます。このログは，保守員に連絡するときに必要です。ここでは，Kafkaインバウンドアダプタでの保守用ログについて説明します。

●保守用ログの出力形式

保守用ログの出力形式を次に示します。

<日付> <時刻> <pid> <tid> <保守情報>

●出力される内容

保守用ログに出力される内容を次の表に示します。

表7‒219　保守用ログに出力される内容（Kafkaインバウンドアダプタ）

項目

内容

日付

保守用ログの取得日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

保守用ログの取得時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

pid

プロセスを識別するためのIDが出力されます。OSが管理するプロセスIDとは異なります。

tid

スレッドを識別するためのIDが出力されます。OSが管理するスレッドIDとは異なります。

保守情報

システム管理者または保守員に連絡するときに必要な保守情報が出力されます。

●保守用ログの出力先

<J2EEサーバのログ出力ディレクトリ>¥csc¥inbound-adapter¥kafka¥Kafka_Inbound_Resource_Adapter

<J2EEサーバのログ出力ディレクトリ>は，usrconf.cfg（J2EEサーバ用オプション定義ファイル）のejb.server.log.directoryキーで変更できます。デフォルトは，<サービスプラットフォームのインストールディレクトリ>¥ejb¥<サーバ名称>¥logsです。usrconf.cfgの詳細は，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.2　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。

保守用ログのログファイル名を次の表に示します。

表7‒220　保守用ログのログファイル名（Kafkaインバウンドアダプタ）

ファイルの種類

ログファイル名

現用ファイル

maintenance.log

バックアップファイル※

maintenance.log.<面数>

注※

現用ファイルのサイズが1面当たりのファイルサイズを超えた場合，バックアップファイルにリネームされます。

新しいログファイルの方が大きい番号となります。一度作成されたログファイルは削除されません。なお，ファイルの改行コードは「LF」です。

保守用ログの出力レベル，ファイルのサイズ，およびファイル面数は，RARファイルの属性を設定するConnector属性ファイルで変更できます。プロパティを次に示します。

server_maintenance_logLevel=保守用ログの出力レベル

server_maintenance_maxFileSize=保守用ログのファイルサイズ

server_maintenance_maxBackupIndex=バックアップファイルの面数

設定手順については，「3.1.2(11)　Kafkaインバウンドアダプタのセットアップ」を参照してください。

(c)　データトレース（Kafkaインバウンドアダプタ）

データトレースは，送受信データ内容を取得することで，データ（内部データ）の正当性を確認できます。

●データトレースの出力形式

データトレースの出力形式を次に示します。

<日付> <時刻> <pid> <tid> <出力種別> <取得ポイント> <レコード情報>

●出力される内容

データトレースに出力される内容を次の表に示します。

表7‒221　データトレースに出力される項目（Kafkaインバウンドアダプタ）

項目

内容

日付

データトレースの取得日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

データトレースの取得時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

ローカル時刻でミリ秒単位の時刻を示します。

pid

プロセスを識別するためのIDが出力されます。OSが管理するプロセスIDとは異なります。

tid

スレッドを識別するためのIDが出力されます。OSが管理するスレッドIDとは異なります。

出力種別

トレースの出力種別※1が出力されます。

NORMAL：正常終了

ERROR：異常終了

取得ポイント

トレースの取得ポイントが出力されます。

AMR：メッセージ受信後

AMP：メッセージ処理後

CPE：Consumerの処理でエラーが発生した場合（コミット失敗など）

レコード情報

レコード情報※2が出力されます。

注※1

属性ファイルのserver_datatrace_triggerに「normal,error」のように複数の値を列挙した場合，出力種別「NORMAL」と「ERROR」のトレースが両方出力されます。これらは出力される条件が異なるため，重複する情報が出力されることはありません。

複数の出力種別「normal,error」を指定した場合の出力例を次に示します。

2021/09/22 08:47:27.953  06519EE0  184CF7CF  NORMAL  AMR  [レコード情報]
2021/09/22 08:47:28.822  06519EE0  184CF7CF  NORMAL  AMR  [レコード情報]
2021/09/22 08:47:29.157  06519EE0  184CF7CF  NORMAL  AMR  [レコード情報]
2021/09/22 08:47:30.307  06519EE0  184CF7CF  ERROR   AMP  [レコード情報]
2021/09/22 08:47:45.988  06519EE0  2805C96B  NORMAL  AMR  [レコード情報]
2021/09/22 08:47:50.263  06519EE0  0067238B  NORMAL  AMR  [レコード情報]

注※2

レコード情報の出力形式を次に示します。

ConsumerRecord(topic = [1], partition = [2], leaderEpoch = [3], offset = [4], CreateTime = [5], serialized key size = [6], serialized value size = [7], headers =[8]RecordHeaders(headers = [RecordHeader(key = [8-1], value = [8-2]),…(ヘッダの数だけくり返し出力する)], isReadOnly = [8-3]), key = [9], value = [10]), ConsumerInfo(Consumer Group = [11], Consumer ID = [12], Reception ID = [13])

出力形式の[ ]の各項目について次に説明します。

項番

項目

説明

[1]

トピック

このレコードが受信されるトピック

[2]

パーティション

対応するKafkaパーティション内のこのレコードの位置

[3]

リーダーエポック

レコードのリーダーエポック

取得できない場合はnullとなります。

[4]

オフセット

このレコードの受信元のパーティション

[5]

タイムスタンプ

レコードのタイムスタンプ

次の形式で出力します。タイムスタンプ種別はApache Kafkaによって設定されます。

「タイムスタンプ種別=レコードのタイムスタンプ」

タイムスタンプが設定されていない場合は，「NoTimestampType=-1」と出力されます。

[6]

キーのサイズ

シリアル化された非圧縮キーのサイズ（単位：バイト）

値がnullの場合は「-1」と出力されます。

[7]

値のサイズ

シリアル化された非圧縮の値のサイズ（単位：バイト）

値がnullの場合は「-1」と出力されます。

[8]

レコードのヘッダ

ヘッダ情報

[8-1]

ヘッダのキー

ヘッダのキー

[8-2]

ヘッダの値

値を16進数表記の文字列に変換したものを出力します。

[8-3]

ヘッダが読み取り専用か

読み取り専用の場合：true

読み取り専用でない場合：false

[9]

レコードのキー

レコードのキー

値がnullの場合は「-1」と出力されます。

[10]

レコードの値

レコードの値

値がnullの場合は「-1」と出力されます。

値がバイト配列の形式の場合は，値を16進数表記の文字列に変換したものを出力します。

[11]

Consumerグループ

Consumerグループ名

[12]

Consumer ID

ConsumerのID

[13]

受付ID

Kafka受付の受付ID

レコード情報の出力例を次に示します。

ConsumerRecord(topic = topic-1, partition = 0, leaderEpoch = 0, offset = 81, CreateTime = 1631607555074, serialized key size = 4, serialized value size = 15, headers = RecordHeaders(headers = [RecordHeader(key = header1, value = 636363), RecordHeader(key = header2, value = 646464), RecordHeader(key = header3, value = 656565)], isReadOnly = false), key = key1, value = value1), ConsumerInfo(Consumer Group = Group1, Consumer ID = consumer-test1-1-ade8920c-cbce-4821-b711-cfedc4b19362, Reception ID = rcp1)

●データトレースの出力先

データトレースは，次に示すディレクトリに出力されます。

<J2EEサーバのログ出力ディレクトリ>¥csc¥inbound-adapter¥kafka¥Kafka_Inbound_Resource_Adapter

<J2EEサーバのログ出力ディレクトリ>は，usrconf.cfg（J2EEサーバ用オプション定義ファイル）のejb.server.log.directoryキーで変更できます。デフォルトは，<サービスプラットフォームのインストールディレクトリ>¥ejb¥<サーバ名称>¥logsです。usrconf.cfgの詳細は，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.2　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。

データトレースのトレースファイル名を次の表に示します。

表7‒222　データトレースのトレースファイル名（Kafkaインバウンドアダプタ）

トレースファイルの出力モード

トレースファイル名

現用ファイル

dattrace.log

バックアップファイル※

dattrace.log.<面数>

注※

現用ファイルのサイズが1面当たりのファイルサイズを超えた場合，バックアップファイルにリネームされます。

新しいログファイルの方が大きい番号となります。一度作成されたログファイルは削除されません。なお，ファイルの改行コードは「LF」です。

データトレースの出力レベル，ファイルのサイズ，およびファイル面数は，RARファイルの属性を設定するConnector属性ファイルで変更できます。プロパティを次に示します。

server_datatrace_enabled=データトレースの出力有無

server_datatrace_trigger=データトレースの出力契機

server_datatrace_maxFileSize=データトレースのファイルサイズ

server_datatrace_maxBackupIndex=バックアップファイルの面数

設定手順については，「3.1.2(11)　Kafkaインバウンドアダプタのセットアップ」を参照してください。

(d)　性能解析トレース（Kafkaインバウンドアダプタ）

Kafkaインバウンドアダプタでの性能解析トレースについて説明します。

●性能解析トレースの出力形式

性能解析トレースファイルに出力される形式は，J2EEサーバの性能解析トレースと同様です。詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.3　Management Serverを利用した性能解析トレースファイルの収集」を参照してください。

●出力される内容

性能解析トレースファイルに出力される内容を次の表に示します。

表7‒223　性能解析トレースファイルに出力される内容（Kafkaインバウンドアダプタ）

項目

内容

イベントID

取得ポイントのイベントIDが出力されます。

取得ポイントの詳細は，項目「●性能解析トレースの取得ポイント」を参照してください。

リターンコード

取得ポイント種別が出力されます。

0：正常終了

1：異常終了

インターフェース名

クラス名が出力されます。

オペレーション名

メソッド名が出力されます。

オプション情報

次の情報が出力されます。

Consumerグループ名

Consumer ID（取得できない場合は空文字）

受付ID

例外情報（障害発生時だけ）

●性能解析トレースの取得ポイント

性能解析トレースの取得ポイントを次の図に示します。

図7‒160　性能解析トレースの取得ポイント（Kafkaインバウンドアダプタ）

イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。表の「図中の番号」は上の図の番号と対応しています。

表7‒224　性能解析トレースの取得ポイント（Kafkaインバウンドアダプタ）

イベントID

図中の番号

トレース取得ポイント

レベル

0x98C0

1

ポーリング実行前

A

0x98C1

2

ポーリング完了後

A

0x98C2

3

Kafka受付の呼び出し前

A

0x98C3

4

Kafka受付の呼び出し完了後

A

0x98C4

5

コミット実行前

A

0x98C5

6

コミット完了後

A

0x98C6

7

Work内の処理（「メッセージ受信機能」「Kafka受付呼び出し機能」）実行前

A

0x98C7

8

Work内の処理（「メッセージ受信機能」「Kafka受付呼び出し機能」）実行後

A

（凡例）

A：「標準」であることを示します。

●性能解析トレースの取得方法と出力先

性能解析トレースを取得するには設定が必要です。設定の詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.　性能解析トレースを使用した性能解析」を参照してください。

(e)　Kafkaプロトコルトレース（Kafkaインバウンドアダプタ）

Kafkaプロトコルトレースには，Brokerへの接続処理やリクエスト内容などを出力します。

KafkaプロトコルトレースはKafkaアダプタと共通で使用します。Kafkaプロトコルトレースについては「7.7.20(6)　Kafkaプロトコルトレース（Kafkaアダプタ・Kafkaインバウンドアダプタ共通）」を参照してください。

(f)　Kafkaインバウンドアダプタの障害情報（Kafkaインバウンドアダプタ）

Kafkaインバウンドアダプタで発生する障害の種類と，障害発生時の動作を説明します。

基本的には，ログに出力されたメッセージに基づいた処理を実行することで回復できますが，それ以外の対策が必要な場合もあります。該当する事象については，「●ログに出力されたメッセージ以外の対策が必要な場合」を参照してください。

Consumerに関する障害

Consumerに関する障害の種類を次に示します。なお，パーティションの割り当てとサブスクライブに関する障害はありません。

データのポーリング

Brokerとの認証に失敗した場合に発生する障害です。データのポーリングで発生するおそれのある障害と，障害発生時の動作を次の表に示します。

障害の種類

発生条件

障害発生時の動作

認証に関する障害

証明書の誤りなど，Brokerとの認証に失敗した場合。

エラーメッセージ「KDEC07716-E」を出力して処理を中断する。

認可に関する障害

アクセス可否を設定しているが，ポーリング処理に必要なアクセス権限がない場合。

エラーメッセージ「KDEC07717-E」を出力して処理を中断する。

その他の障害

主に，セッションタイムアウトが発生した場合。

エラーメッセージ「KDEC07720-E」を出力して処理を中断する。

オフセットのコミット

オフセットのコミットで発生するおそれのある障害と，障害発生時の動作を次の表に示します。

障害の種類

発生条件

障害発生時の動作

コミット処理の失敗に関する障害

Consumerがグループから除外された場合や，Consumerに割り当てられなくなったパーティションにコミットしようとした場合。

エラーメッセージ「KDEC07721-E」を出力して処理を中断する。

認証に関する障害

証明書の誤りなど，Brokerとの認証に失敗した場合。

エラーメッセージ「KDEC07716-E」を出力して処理を中断する。

認可に関する障害

アクセス可否を設定しているが，ポーリング処理に必要なアクセス権限がない場合。

エラーメッセージ「KDEC07717-E」を出力して処理を中断する。

タイムアウトに関する障害

何らかの原因で，タイムアウト期間内にコミット処理が完了しない場合。

エラーメッセージ「KDEC07722-E」を出力して処理を中断する。

その他の障害

主に，コミット時にトピックが削除された場合。

エラーメッセージ「KDEC07723-E」を出力して処理を中断する。

タイムアウトに関する障害

タイムアウトが発生した処理ごとに動作が異なります。詳細については，マニュアル「サービスプラットフォーム 解説」の「2.12.4　Kafkaインバウンドアダプタのタイムアウト監視」のタイムアウト発生後の動作を参照してください。

Kafka受付呼び出しに関する障害

Kafka受付呼び出しで発生するおそれのある障害と，障害発生時の動作を次の表に示します。

障害の種類

発生条件

障害発生時の動作

Kafka受付の呼び出しに関する障害

Kafka受付から例外が返却された場合。

エラーメッセージ「KDEC07741-E」を出力して処理を中断する。

メッセージ処理が失敗したことを示す情報がKafka受付から返された場合。

「KDEC07743-W」を出力して処理を続行する。

リトライ回数の上限内に処理が成功しなかった場合。

エラーメッセージ「KDEC07744-E」を出力して処理を中断する。

リソースアダプタの開始に関する障害

リソースアダプタの開始処理で発生するおそれのある障害と，障害発生時の動作を次の表に示します。

エラー原因

発生条件

障害発生時の動作

アプリケーションサーバ

リソースアダプタ

リソースアダプタの開始に失敗

プロパティに範囲外の値が設定された場合。

メッセージ「KDJE48590-E」を出力する。

プロパティごとにKDEC07709-E（プロパティ値の範囲が不正である）メッセージを出力する。

KDEC07701-E（リソースアダプタの開始に失敗した。詳細：プロパティ値に不正な値が設定されたものがあった）を出力し，リソースアダプタの開始に失敗する。

定義ファイルの作成で予期しない例外が発生

リソースアダプタの起動時に，内部で使用する定義ファイル（log4j.xml）の作成で予期しない例外が発生した場合。

KDEC07701-E（リソースアダプタの開始に失敗した。詳細：定義ファイルの作成で例外が発生した）を出力し，リソースアダプタの開始に失敗する。

定義ファイルのバックアップ作成で例外が発生

リソースアダプタの起動時に，内部で使用する定義ファイル（log4j.xml）のバックアップ作成で予期しない例外が発生した場合。

KDEC07701-E（リソースアダプタの開始に失敗した。詳細：定義ファイルのバックアップ作成で例外が発生した）を出力し，リソースアダプタの開始に失敗する。

ログに出力されたメッセージ以外の対策が必要な場合

ログに出力されたメッセージのほかに，Kafkaインバウンドアダプタで扱うメッセージ（ここではKafkaメッセージと表記します）の問題で対策が必要な場合があります。ここでは現象ごとに確認方法と対策方法を示します。

Kafkaメッセージの処理でエラーが発生している場合

Kafkaメッセージの処理でエラーが発生した場合は，次に示す手順で回復してください。

1. データトレースを参照して，Kafkaメッセージの作成に必要な情報を確認する。

2. Kafkaメッセージを作成し，再送する。

不正なKafkaメッセージを受信している場合

不正なKafkaメッセージを受信すると，Kafka受付やビジネスプロセス内の処理がエラーとなることがあります。

この現象に該当するかの確認と回復処理の手順を次に示します。

1. データトレースを参照して，不正なKafkaメッセージを受信していないか確認する。

2. 不正なKafkaメッセージを受信している場合は，Consumerグループ内のConsumerに対応するKafka受付を停止させ，Consumerを停止する。

3. Apache Kafkaのkafka-consumer-groups.shコマンドを実行し，受信するKafkaメッセージのオフセットを不正なKafkaメッセージのオフセットの次のオフセットに変更する。

kafka-consumer-groups.shコマンドについては，Apache Kafkaの公式ドキュメントを参照してください。

Consumerが停止し，Kafkaメッセージが受信されない場合

Consumerは続行不可能になると停止し，Consumerグループから除外されます。

この現象に該当するかの確認と回復処理の手順を次に示します。回復処理が実行されるまで，Kafkaメッセージは受信されません。

1. ログに出力されたメッセージの「Consumerグループ名」「Consumerのインスタンス識別子」から，該当するConsumerを確認する。

2. Apache Kafkaのkafka-consumer-groups.shコマンドを実行し，該当するConsumerがグループから除外されていることを確認する。

3. アプリケーションを再起動する。

kafka-consumer-groups.shコマンドについては，Apache Kafkaの公式ドキュメントを参照してください。

Consumerは起動しているがKafkaメッセージが受信されない場合

Consumerが起動していてもKafkaメッセージが受信されない場合は，フェッチ対象のデータが存在しないために，空のレコードセットが返却されているおそれがあります。

考えられるエラー原因と対策方法を次に示します。対策方法に示すプロパティとコマンドについては，Apache Kafkaの公式ドキュメントを参照してください。

エラー原因

対策方法

Brokerと接続できていない

zookeeper-shell.shコマンドを実行してサーバ一覧を取得し，Kafka受付定義ファイルのconsumer.bootstrap.serversプロパティに指定したサーバが起動しているか確認してください。

トピックが存在しない

kafka-topics.shコマンドを実行してトピック一覧を取得し，該当するトピックが存在するか確認してください。

トピックにデータが送信されていない

送信側の問題のため，Consumer側では対策できません。

(2)　障害情報の取得（Kafka受付）

Kafka受付では，障害情報として性能解析トレースを出力します。

ここでは，Kafka受付の実行時に発生したエラーの伝わり方と，性能解析トレースについて説明します。

(a)　Kafka受付実行時に発生したエラーの伝わり方

KafkaクライアントからKafka受付を使用してビジネスプロセスを呼び出す場合のエラーの伝わり方を説明します。エラーの伝わり方は，エラーの種類によって異なります。

Kafka受付がエラーを検知した場合

Kafka受付がエラーを検知した場合のエラーの伝わり方を次の図に示します。

図7‒161　Kafka受付がエラーを検知した場合のエラーの伝わり方

Kafka受付は検知した障害を基にエラーメッセージを生成し，メッセージログに出力します。Kafkaインバウンドアダプタには例外をスローしません。

カスタム受付フレームワークがエラーをリターンした場合

カスタム受付フレームワークがエラーをリターンした場合のエラーの伝わり方を次の図に示します。Kafka受付の受付処理では，キャッチした例外を基にエラーメッセージを生成し，メッセージに出力します。Kafkaインバウンドアダプタには例外をスローしません。

図7‒162　カスタム受付フレームワークがエラーをリターンした場合のエラーの伝わり方

図中に示したエラー1〜エラー5の要因を次に示します。

エラー1：要求パラメタ不正など

エラー2：宛先（ロケーション）が見つからない，サービスアダプタが停止しているなど

エラー3：データ変換の失敗など

エラー4：宛先不正，サービス部品が停止，通信障害など

エラー5：ビジネスプロセス処理上での例外エラーなど

エラー1〜エラー5のどれかが発生した場合，例外をキャッチしたカスタム受付フレームワークはKafka受付の受付処理に対して，CSCMsgServerExceptionをスローします。

CSCMsgServerExceptionの詳細は，マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「付録A.3　カスタム受付フレームワークのAPI」を参照してください。

(b)　メッセージログ（Kafka受付）

メッセージログのJ2EEサーバの稼働ログに，Kafka受付で発生した各種情報がメッセージとして出力されます。

メッセージログの出力内容や出力先については，「7.4.1　メッセージログ」を参照してください。

(c)　性能解析トレース（Kafka受付）

Kafka受付の性能解析トレースについて説明します。

●性能解析トレースの出力形式

性能解析トレースファイルに出力される形式は，J2EEサーバの性能解析トレースと同様です。詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.3　Management Serverを利用した性能解析トレースファイルの収集」を参照してください。

●出力される内容

性能解析トレースファイルに出力される内容を次の表に示します。

表7‒225　性能解析トレースファイルに出力される内容（Kafka受付）

項目

内容

イベントID

取得ポイントのイベントIDが出力されます。

取得ポイントの詳細は，項目「●性能解析トレースの取得ポイント」を参照してください。

リターンコード

取得ポイント種別が出力されます。

0：正常終了

1：異常終了

インターフェース名

クラス名が出力されます。

オペレーション名

メソッド名が出力されます。

オプション情報※

メッセージ共通ID

リクエスト識別情報（親ID）が出力されます。未設定の場合，nullが出力されます。

サービスリクエストID

リクエスト識別情報（子ID）が出力されます。未設定の場合，nullが出力されます。

付加情報

次のオプション情報が出力されます。

受付名

受付ID

クライアント相関ID

サービス名

サービスオペレーション名

例外名（障害発生時だけ）

注※

オプション情報は最大256バイトです。

●性能解析トレースの取得ポイント

性能解析トレースの取得ポイントを次の図に示します。

図7‒163　性能解析トレースの取得ポイント（Kafka受付）

イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。表の「図中の番号」は上の図の番号と対応しています。

表7‒226　性能解析トレースの取得ポイント（Kafka受付）

イベントID

図中の番号

トレース取得ポイント

レベル

0x98D0

1

カスタム受付の入口

A

0x98D1

2

カスタム受付の出口

A

0x98D2

3

カスタム受付フレームワークの呼び出し口

B

0x98D3

4

カスタム受付フレームワークの応答受信口

B

0x9860

5

カスタム受付フレームワークの入口

A

0x9861

6

カスタム受付フレームワークの出口

A

0x9864

7

HCSCメッセージ配送制御の呼び出し口

A

0x9865

8

HCSCメッセージ配送制御の応答受信口

A

（凡例）

A：「標準」であることを示します。

B：「詳細」であることを示します。

●性能解析トレースの取得方法と出力先

性能解析トレースを取得するには設定が必要です。設定の詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.　性能解析トレースを使用した性能解析」を参照してください。

7.7.20　Kafkaアダプタ実行時の障害対策

この項では，Kafkaアダプタの運用時に発生する障害に対して取得できる情報の種類について説明します。

Kafkaアダプタに関する障害情報には次の種類があります。

メッセージログ

メソッドトレース

データトレース

性能解析トレース（PRFトレース）

例外ログ

Kafkaプロトコルトレース

ここでは，これらの障害情報について説明します。

(1)　メッセージログ（Kafkaアダプタ）

メッセージログのJ2EEサーバの稼働ログに，Kafkaアダプタで発生した各種情報がメッセージとして出力されます。

メッセージログについては，「7.4.1　メッセージログ」を参照してください。

(2)　メソッドトレース（Kafkaアダプタ）

メソッドトレースは，内部メソッド発行の時刻やシーケンスを確認できます。保守員が障害解析のために使用します。

(a)　出力形式

メソッドトレースの出力形式を次の図に示します。

図7‒164　メソッドトレースの出力形式

(b)　出力される内容

メソッドトレースに出力される内容を次の表に示します。

表7‒227　メソッドトレースに出力される項目（Kafkaアダプタ）

項目

内容

番号

メソッドトレースの出力通番が表示されます。

日付

メソッドトレースの取得日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

メソッドトレースの取得時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

ローカル時刻でミリ秒単位の時刻を示します。

製品ID

製品を特定するための識別子として，Kafkaアダプタを示す「ADPKAFKA」が表示されます。

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID

空白

種別

トレース取得ポイントの種別が出力されます。

BGN：メソッドの開始

END：メソッドの終了

CAL：メソッドの呼び出し

RET：メソッドの戻り

THR：例外のthrow

CTH：例外のcatch

クラス名

トレースを取得するクラス名が出力されます。

30文字未満の場合は左詰めされ，足りない文字はスペースで補われます。

メソッド名

トレースを取得するメソッド名が出力されます。

30文字未満の場合は左詰めされ，足りない文字はスペースで補われます。

入出力情報

トレースを取得するメソッドの入出力情報（引数や戻り値の値など）が出力されます。

CRLF

レコード終端符号が出力されます。

(c)　出力先

Kafkaアダプタのメソッドトレースの出力先を次に示します。

<J2EEサーバのログ出力ディレクトリ>¥CSCADP¥KAFKAADP¥maintenance¥<サービスID>

<J2EEサーバのログ出力ディレクトリ>は，HCSCサーバが動作するJ2EEサーバ用オプション定義ファイル（usrconf.cfg）のejb.server.log.directoryキーで指定します。詳細は，マニュアル「アプリケーションサーバリファレンス 定義編(サーバ定義)」の「2.2.2　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。

メソッドトレースのトレースファイル名を次に示します。

表7‒228　メソッドトレースのトレースファイル名（Kafkaアダプタ）

トレースファイルの出力モード

トレースファイル名

ラップアラウンドモードの場合

csckafkaadpmtd_<HCSCサーバ名>_<面数>.log

シフトモードの場合

csckafkaadpmtd_<HCSCサーバ名>_.log

メソッドトレースのローテーションは，次のどちらかの条件に合致した際に実行されます。

指定したローテーション時刻に達したとき

ローテーション時刻の指定方法は，Application Serverの設定に従います。詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.3　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」を参照してください。

指定したファイルサイズに達したとき

トレースファイルの面数は，Kafkaアダプタ実行環境プロパティファイルのmethodtracefile.numキーで変更できます。トレースファイルのサイズは，Kafkaアダプタ実行環境プロパティファイルのmethodtracefile.sizeキーで変更できます。Kafkaアダプタ実行環境プロパティファイルについては，マニュアル「サービスプラットフォームリファレンス」の「6.17.1　Kafkaアダプタ実行環境プロパティファイル」を参照してください。

変更方法の詳細については，マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「3.3.16　Kafkaアダプタを定義する」のKafkaアダプタ実行環境プロパティファイルの作成に関する説明を参照してください。

(3)　データトレース（Kafkaアダプタ）

データトレースは，送信メッセージの情報を取得できます。メッセージの正当性の確認や，障害対策に利用できます。

(a)　出力形式

データトレースの出力形式を次に示します。

図7‒165　データトレースの出力形式（Kafkaアダプタ）

(b)　出力される内容

データトレースに出力される内容を次の表に示します。

表7‒229　データトレースに出力される項目（Kafkaアダプタ）

項目

内容

番号

データトレースの出力通番が表示されます。

日付

データトレースの取得日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

データトレースの取得時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

ローカル時刻でミリ秒単位の時刻を示します。

製品ID

製品を特定するための識別子として，Kafkaアダプタを示す「ADPKAFKA」と，バージョン情報が表示されます。

バージョン情報の形式は次のとおりです。

正規版製品：VV-RR

修正版製品：VV-RR-SS

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID

空白

RootAP情報

性能解析トレースに出力されるRootAPの情報であるIPアドレス・プロセスID・通信番号を「/（スラッシュ）」で区切った文字列が出力されます。

取得ポイント

トレースの取得ポイント情報（取得位置）が出力されます。

MSC：メッセージ送信完了後

MSF：メッセージ送信に失敗した後

メッセージ情報

メッセージ情報※が出力されます。

CRLF

レコード終端符号が出力されます。

注※

メッセージ情報の出力形式を次に示します。

topic = [1], partition = [2], offset = [3], Timestamp = [4], serialized key size = [5], serialized value size = [6], headers = [7] RecordHeaders(headers = [RecordHeader(key = [7-1], value = [7-2]),…(ヘッダの数だけくり返し出力する)], isReadOnly = [7-3]), key = [8], value = [9], Service ID = [10]

この出力形式の各項番に対応する項目を次に説明します。設定できない項目には「****」と出力されます。

項番

項目

説明

[1]

トピック

このメッセージの送信先トピック

[2]

パーティション

このメッセージの送信先パーティション

[3]

オフセット

対応するパーティション内のこのメッセージの位置

[4]

タイムスタンプ

メッセージのタイムスタンプ

[5]

キーのサイズ

シリアル化された非圧縮キーのサイズ（単位：バイト）

[6]

値のサイズ

シリアル化された非圧縮の値のサイズ（単位：バイト）

[7]

メッセージのヘッダ

ヘッダ情報

[7-1]

ヘッダのキー

ヘッダのキー

[7-2]

ヘッダの値

ヘッダの値をhexBinary形式でエンコードして出力します。

[7-3]

ヘッダが読み取り専用か

読み取り専用の場合：true

読み取り専用でない場合：false

[8]

メッセージのキー

メッセージのキー

値がバイト配列の形式の場合は，hexBinary形式でエンコードした結果を出力します。

[9]

メッセージの値

メッセージの値

値がバイト配列の形式の場合は，hexBinary形式でエンコードした結果を出力します。

[10]

サービスID

KafkaアダプタのサービスID

メッセージ情報の出力例を次に示します。

topic = topic-1, partition = 0, offset = 81, Timestamp = 1631607555074, serialized key size = 4, serialized value size = 15, headers = RecordHeaders(headers = [RecordHeader(key = header1, value = 77FA4), RecordHeader(key = header2, value = 76F5E), RecordHeader(key = header3, value = 147A6)], isReadOnly = false), key = key1, value = value1, Service ID = srv1

(c)　出力先

データトレースの出力先を次に示します。

<J2EEサーバのログ出力ディレクトリ>¥CSCADP¥KAFKAADP¥maintenance¥<サービスID>

<J2EEサーバのログ出力ディレクトリ>は，usrconf.cfg（J2EEサーバ用オプション定義ファイル）のejb.server.log.directoryキーで変更できます。usrconf.cfgの詳細は，マニュアル「アプリケーションサーバリファレンス 定義編(サーバ定義)」の「2.2.2　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。

データトレースのトレースファイル名を次に示します。

表7‒230　データトレースのトレースファイル名（Kafkaアダプタ）

トレースファイルの出力モード

トレースファイル名

ラップアラウンドモードの場合

dattrace<面数>.log

シフトモードの場合

dattrace.log

データトレースのローテーションは，次のどちらかの条件に合致した際に実行されます。

指定したローテーション時刻に達したとき

ローテーション時刻の指定方法は，Application Serverの設定に従います。詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.3　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」を参照してください。

指定したファイルサイズに達したとき

トレースファイルの面数は，Kafkaアダプタ実行環境プロパティファイルのdatatracefile.numキーで変更できます。トレースファイルのサイズは，Kafkaアダプタ実行環境プロパティファイルのdatatracefile.sizeキーで変更できます。

Kafkaアダプタ実行環境プロパティファイルについては，マニュアル「サービスプラットフォーム リファレンス」の「6.17.1　Kafkaアダプタ実行環境プロパティファイル」を参照してください。変更方法の詳細については，マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「3.3.16　Kafkaアダプタを定義する」のKafkaアダプタ実行環境プロパティファイルの作成に関する説明を参照してください。

(4)　性能解析トレース（PRFトレース）（Kafkaアダプタ）

サービスリクエスタから要求を受け付けて，実行結果を返却するまでの一連の処理で出力される性能解析情報を基に，アプリケーションサーバシステムの性能を検証できます。Kafkaアダプタの性能解析トレース取得ポイントでは，Kafkaアダプタ固有の情報が出力されます。情報は，保守員が性能ボトルネックの解析のために使用します。

(a)　出力先

性能解析トレースの出力先およびトレースファイル名を次に示します。

表7‒231　性能解析トレースの出力先およびトレースファイル名

トレースの出力先パス

トレースファイル名

<環境変数PRFSPOOLの設定ディレクトリ>¥utt¥prf¥<PRF識別子>¥dcopltrc※

prf_<n>

（凡例）

n：001からファイル面数の最大値までの整数が入ります。

注※

性能解析トレースの出力先は，アプリケーションサーバ全体で共通です。詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.3　Management Serverを利用した性能解析トレースファイルの収集」を参照してください。

(b)　ファイル面数

出力ファイル面数のデフォルトは4面です。出力ファイル面数は，運用管理ポータルまたはcprfstartコマンドで変更できます。運用管理ポータルの詳細は，マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」を参照してください。cprfstartコマンドの詳細はマニュアル「アプリケーションサーバ リファレンス コマンド編」を参照してください。

(c)　ファイルサイズ

性能解析トレース（PRFトレース）のファイルサイズのデフォルトは次のとおりです。

運用管理ポータルでファイルサイズを設定した場合：32MB

cprfstartコマンドでファイルサイズを設定した場合：8MB

ファイルサイズは，運用管理ポータルまたはcprfstartコマンドで変更できます。運用管理ポータルの詳細は，マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」を参照してください。cprfstartコマンドの詳細は，マニュアル「アプリケーションサーバ リファレンス コマンド編」を参照してください。

(d)　出力形式

性能解析トレースに出力される形式は，アプリケーションサーバの性能解析トレースと同様です。詳細については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.3　Management Serverを利用した性能解析トレースファイルの収集」を参照してください。

(e)　性能解析トレースの取得ポイント

Kafkaアダプタの性能解析トレース取得ポイントでは，Kafkaアダプタ固有の情報が出力されます。

Kafkaアダプタの性能解析トレース取得ポイントを次に示します。

図7‒166　性能解析トレースの取得ポイント（Kafkaアダプタ）

性能解析トレースの取得ポイントには，ポイント固有のイベントIDが割り当てられます。Kafkaアダプタで出力されるトレースのイベントIDは0xab10〜0xab13です。

イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。表の「図中の番号」は，上の図の番号と対応しています。

表7‒232　性能解析トレースの取得ポイント（Kafkaアダプタ）

イベントID

図中の番号

トレース取得ポイント

レベル

0xab10

1

リクエスト受付時

B

0xab11

2

メッセージ送信処理呼び出し時

A

0xab12

3

メッセージ送信処理完了時

A

0xab13

4

レスポンス送信時

B

（凡例）

A：「標準」であることを示します。

B：「詳細」であることを示します。

PRFトレースの取得レベルを変更する場合，cprflevelコマンドの-PrfChangeLevelオプションに，32ビットの16進数（8桁）の値を2つ指定します。それぞれの16進数の値には，インデックス番号（インデックス1，インデックス2）が割り当てられています。KafkaアダプタのPRFトレースの取得レベルは，インデックス2の7桁目に指定してください。

cprflevelコマンドの指定方法については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cprflevel（PRFトレース取得レベルの表示と変更）」を参照してください。性能解析トレースレベルの変更方法の詳細については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」を参照してください。デフォルトは「標準」です。

(5)　例外ログ（Kafkaアダプタ）

トレースの開始以降に発生した例外情報（スタックトレース）を例外ログとして別のファイルに出力します。例外ログでは，出力ファイルのパスと出力レベルは設定しないで，出力ファイルのサイズと面数を設定します。

Kafkaアダプタの例外ログについて説明します。

(a)　例外ログの出力形式

例外ログの出力形式を次の図に示します。

図7‒167　例外ログの出力形式（Kafkaアダプタ）

(b)　出力される内容

例外ログに出力される内容を次の表に示します。

表7‒233　例外ログに出力される内容（Kafkaアダプタ）

項目

内容

番号

例外ログの出力通番が表示されます。

日付

例外ログの取得日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

例外ログの取得時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

ローカル時刻でミリ秒単位の時刻を示します。

製品ID

製品を特定するための識別子として，Kafkaアダプタを示す「ADPKAFKA」が出力されます。

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID

空白

スタックトレース情報

スタックトレース情報が出力されます。

CRLF

レコードの終端符号が出力されます。

(c)　出力先

例外ログの出力先を次に示します。

<J2EEサーバのログ出力ディレクトリ>¥CSCADP¥KAFKAADP¥maintenance¥<サービスID>

<J2EEサーバのログ出力ディレクトリ>は，usrconf.cfg（J2EEサーバ用オプション定義ファイル）のejb.server.log.directoryキーで変更できます。usrconf.cfgの詳細は，マニュアル「アプリケーションサーバリファレンス 定義編(サーバ定義)」の「2.2.2　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。

例外ログのログファイル名を次の表に示します。

表7‒234　例外ログのログファイル名（Kafkaアダプタ）

ログファイルの出力モード

ログファイル名

ラップアラウンドモードの場合

csckafkaadpexp_<HCSCサーバ名>_<面数>.log

シフトモードの場合

csckafkaadpexp_<HCSCサーバ名>_.log

例外ログのローテーションは，次のどちらかの条件に合致した際に実行されます。

指定したローテーション時刻に達したとき

ローテーション時刻の指定方法は，Application Serverの設定に従います。詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.3　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」を参照してください。

指定したファイルサイズに達したとき

ログファイルの面数は，Kafkaアダプタ実行環境プロパティファイルのexptracefile.numプロパティで指定します。ログファイルのサイズは，Kafkaアダプタ実行環境プロパティファイルのexptracefile.sizeプロパティで指定します。

Kafkaアダプタ実行環境プロパティファイルの詳細は，マニュアル「サービスプラットフォーム リファレンス」の「6.17.1　Kafkaアダプタ実行環境プロパティファイル」を参照してください。

(6)　Kafkaプロトコルトレース（Kafkaアダプタ・Kafkaインバウンドアダプタ共通）

Kafkaプロトコルトレースには，Brokerへの接続処理やリクエスト内容などを出力します。KafkaプロトコルトレースはKafkaインバウンドアダプタと共通で使用します。

(a)　出力形式

Kafkaプロトコルトレースの出力形式を次の図に示します。

(b)　出力される内容

Kafkaプロトコルトレースに出力される内容を次の表に示します。

表7‒235　Kafkaプロトコルトレースに出力される項目（Kafkaアダプタ・Kafkaインバウンドアダプタ共通）

項目

内容

日付

Kafkaプロトコルトレースの取得日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

Kafkaプロトコルトレースの取得時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

ローカル時刻でミリ秒単位の時刻を示します。

pid

プロセスを識別するためのIDが出力されます。OSが管理するプロセスIDとは異なります。

tid

スレッドを識別するためのIDが出力されます。OSが管理するスレッドIDとは異なります。

クラス名

クラス名が出力されます。

メソッド名

メソッド名が出力されます。

kafka-clients内のログ出力内容

kafka-clients内のログ内容が出力されます。

CRLF

レコードの終端符号が出力されます。

(c)　出力先

Kafkaプロトコルトレースの出力先を次に示します。

<J2EEサーバのログ出力ディレクトリ>¥csc¥maintenance¥kafka¥

<J2EEサーバのログ出力ディレクトリ>は，HCSCサーバが動作するJ2EEサーバ用オプション定義ファイル（usrconf.cfg）のejb.server.log.directoryキーで指定します。詳細は，マニュアル「アプリケーションサーバリファレンス 定義編(サーバ定義)」の「2.2.2　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。

Kafkaプロトコルトレースのトレースファイル名を次に示します。

表7‒236　Kafkaプロトコルトレースのトレースファイル名（Kafkaアダプタ・Kafkaインバウンドアダプタ共通）

ファイルの種類

トレースファイル名

現用ファイル

kafkaprotocoltrace.log

バックアップファイル※

kafkaprotocoltrace.log.<面数>

注※

現用ファイルのサイズが1面当たりのファイルサイズを超えた場合，バックアップファイルにリネームされます。

新しいログファイルの方が大きい番号となります。一度作成されたログファイルは削除されません。なお，ファイルの改行コードは「LF」です。

Kafkaプロトコルトレースの採取有無，出力レベル，ファイルサイズ，およびファイル面数は，HCSCサーバランタイム定義ファイルの次に示すプロパティで変更できます。

kafka-protocoltrace-enabled=Kafkaプロトコルトレースの採取有無

kafka-protocoltrace-level=Kafkaプロトコルトレースの出力レベル

kafka-protocoltrace-filenum=Kafkaプロトコルトレース面数

kafka-protocoltrace-filesize=Kafkaプロトコルトレースファイルサイズ

HCSCサーバランタイム定義ファイルについては，マニュアル「サービスプラットフォーム リファレンス」の「6.5.6　HCSCサーバランタイム定義ファイル」を参照してください。

7.7.21　スケジュール駆動受付実行時の障害対策

この項では，スケジュール駆動受付の運用時に発生する障害に対して取得できる情報の種類について説明します。

スケジュール駆動受付に関する障害情報には次の種類があります。

メッセージログ

メソッドトレース

性能解析トレース

例外ログ

イベント履歴ログ

これらの障害情報について説明します。

(1)　スケジュール駆動受付実行時に発生したエラーの伝わり方

スケジュール駆動受付のエラーの伝わり方は，エラーの種類によって異なります。

ここでは，次の場合についてエラーの伝わり方を説明します。

カスタム受付フレームワークがエラーをリターンした場合

スケジュール駆動受付がエラーを検知した場合

(a)　カスタム受付フレームワークがエラーをリターンした場合

カスタム受付フレームワークがエラーをリターンした場合のエラーの伝わり方を次の図に示します。

図7‒168　カスタム受付フレームワークがエラーをリターンした場合のエラーの伝わり方（スケジュール駆動受付の場合）

図中に示したエラー1〜エラー5の要因を次に示します。

エラー1：要求パラメタ不正など

エラー2：宛先（ロケーション）が見つからない，サービスアダプタが停止しているなど

エラー3：データ変換の失敗など

エラー4：宛先不正，サービス部品が停止，通信障害など

エラー5：ビジネスプロセス処理上での例外エラーなど

エラー1〜エラー5のどれかが発生した場合，例外をキャッチしたカスタム受付フレームワークはスケジュール駆動受付の受付処理に対して，CSCMsgServerExceptionをスローします。スケジュール駆動受付の受付処理は，キャッチした例外を基にエラーメッセージを作成し，メッセージログに出力します。

CSCMsgServerExceptionの詳細は，マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「付録A.3　カスタム受付フレームワークのAPI」を参照してください。

(b)　スケジュール駆動受付がエラーを検知した場合

スケジュール駆動受付がエラーを検知した場合のエラーの伝わり方を次の図に示します。

図7‒169　スケジュール駆動受付がエラーを検知した場合のエラーの伝わり方

スケジュール駆動受付は検知した障害を基にエラーメッセージを生成し，メッセージログに出力します。

(2)　メッセージログ

メッセージログのJ2EEサーバの稼働ログに，スケジュール駆動受付で発生した各種情報がメッセージとして出力されます。

メッセージログの出力内容や出力先については，「7.4.1　メッセージログ」を参照してください。

(3)　メソッドトレース

スケジュール駆動受付のメソッドトレースは，サービスプラットフォームが出力するメソッドトレースの仕様に従います。

メソッドトレースの出力内容および出力先については，「7.4.7(3)　メソッドトレース」の「HCSCサーバ（メッセージング基盤）のメソッドトレース」を参照してください。

(4)　性能解析トレース

スケジュール駆動受付の性能解析トレースについて説明します。

(a)　出力形式

性能解析トレースファイルに出力される形式は，J2EEサーバの性能解析トレースと同様です。詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.　性能解析トレースを使用した性能解析」を参照してください。

(b)　出力される内容

性能解析トレースファイルに出力される内容を次の表に示します。

表7‒237　性能解析トレースファイルに出力される内容（スケジュール駆動受付）

項目

内容

イベントID

取得ポイントのイベントIDが出力されます。

取得ポイントの詳細は，「(c)　性能解析トレースの取得ポイント」を参照してください。

リターンコード

取得ポイント種別が出力されます。

0：正常終了

1：異常終了

インターフェース名

クラス名が出力されます。

オペレーション名

メソッド名が出力されます。

オプション情報※

メッセージ共通ID

リクエスト識別情報（親ID）が出力されます。

情報を設定していない場合はnullになります。

サービスリクエストID

リクエスト識別情報（子ID）が出力されます。

情報を設定していない場合はnullになります。

付加情報

次のオプション情報が出力されます。

受付名

受付ID

クライアント相関ID

サービス名

サービスオペレーション名

例外名（障害発生時だけ）

注※

オプション情報は最大で256バイトです。

(c)　性能解析トレースの取得ポイント

性能解析トレースの取得ポイントを次の図に示します。

図7‒170　性能解析トレースの取得ポイント（スケジュール駆動受付）

イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。表の「図中の番号」は上の図の番号と対応しています。

表7‒238　性能解析トレースの取得ポイント（スケジュール駆動受付）

イベントID

図中の番号

トレース取得ポイント

レベル

0x98F0

1

カスタム受付の入口

A

0x98F1

2

カスタム受付の出口

A

0x98F2

3

カスタム受付フレームワークの呼び出し口

B

0x98F3

4

カスタム受付フレームワークの応答受信口

B

0x9860

5

カスタム受付フレームワークの入口

A

0x9861

6

カスタム受付フレームワークの出口

A

0x9864

7

HCSCメッセージ配送制御の呼び出し口

A

0x9865

8

HCSCメッセージ配送制御の応答受信口

A

（凡例）

A：「標準」であることを示します。

B：「詳細」であることを示します。

(d)　性能解析トレースの取得方法と出力先

性能解析トレースを取得するには設定が必要です。設定の詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.　性能解析トレースを使用した性能解析」を参照してください。

(5)　例外ログ

例外ログには例外情報が出力されます。例外ログの概要については，「7.4.7(1)　例外ログ」の「HCSCサーバの例外ログ」を参照してください。

(6)　イベント履歴ログ

スケジュール駆動受付では，イベントの履歴をイベント履歴ログとして出力します。イベント履歴ログによって，イベント発生時に実行されたタスクが完了したことや，タスクの実行が省略されたことを確認できます。

イベント履歴ログはスケジュール駆動受付ごとに出力されます。イベント履歴ログはデフォルトで出力されますが，出力しないよう設定することもできます。

なお，待機しているタスクがある状態でタスクの実行が抑止された場合は，待機しているタスクに関するイベント履歴ログは出力されません。

以降でスケジュール駆動受付のイベント履歴ログについて説明します。

(a)　出力形式

スケジュール駆動受付の出力形式を次に示します。

図7‒171　スケジュール駆動受付の出力形式

(b)　出力される内容

イベント履歴ログに出力される内容を次の表に示します。

表7‒239　イベント履歴ログに出力される内容

項目

内容

番号

トレースレコードの出力通番が表示されます。

日付

トレースレコードの取得日付（yyyy/mm/dd形式）が出力されます。

時刻

トレースレコードの取得時刻（hh:mm:ss.SSS形式）が，ローカル時刻でミリ秒単位に出力されます。

製品ID

製品を特定するための識別子として，スケジュール駆動受付を示す「RCPSCD」が出力されます。

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID

表示されません。

受付ID

受付IDが出力されます。

取得ポイント

取得ポイント情報として次に示す情報が出力されます。

OCCUR：イベント発生※1

CALL：タスク処理の開始

RET：タスク処理の終了※2

ERROR：エラー※3

OMIT：タスクの実行を省略※4

RootAP情報

ルートアプリケーション情報

付加情報

次に示す時刻が「yyyy/MM/dd HH:mm:ss.SSS」形式のローカル時刻で出力されます。出力される時刻は，取得ポイント情報によって異なります※5。

event occurrence time = <イベントの発生時刻>

task processing start time = <タスク処理の開始時刻>

task processing end time = <タスク処理の終了時刻>

number of tasks waiting to be executed = <実行を待機しているタスクの数>

時刻を複数出力する場合は「,（コンマ）」で区切られます。

CRLF

レコード終端符号が出力されます。

注※1

イベント発生時に出力されます。ただし，タスクの実行を抑止する条件に一致する場合は出力されません。

逐次処理のタスクの実行抑止はタスクの呼び出し機能で設定します。設定方法については，マニュアル「サービスプラットフォーム 解説」の「3.6.3　スケジュール駆動受付でのタスクの呼び出し機能」を参照してください。

注※2

次の両方の条件に当てはまる場合に出力されます。

スケジュール駆動受付内の処理が正常応答した

スケジュール駆動受付の呼び出し先から正常応答が返された

タイマ監視機能のタイムアウト発生時に条件が当てはまる場合を含みます。

注※3

次のどちらかの条件に当てはまる場合に出力されます。

ビジネスプロセスからエラー応答が返却された

スケジュール駆動受付内でエラーが発生した

タイマ監視機能のタイムアウト発生時に条件が当てはまる場合を含みます。

注※4

次のどれかの条件に当てはまる場合に出力されます。

イベント発生時に実行中のタスクがあり，かつ，新たにタスクを生成しない設定になっている場合

実行を待機できるタスクの最大数を超えて登録されようとした場合

タスクが実行できない場合

詳細については，マニュアル「サービスプラットフォーム 解説」の「3.6　ビジネスプロセスのスケジュール設定」を参照してください。

注※5

付加情報で出力される時刻を取得ポイント情報ごとに次の表に示します。

取得ポイント情報

付加情報の出力時刻

イベントの発生時刻

タスク処理の開始時刻

タスク処理の終了時刻

実行を待機しているタスクの数

OCCUR

〇

×

×

〇

（イベント発生時に実行を待機しているタスクの数を出力）

CALL

〇

〇

×

×

RET

〇

〇

〇

×

ERROR

〇

〇

〇

×

OMIT

〇

×

×

×

（凡例）

〇：時刻が出力される

×：時刻が出力されない

(c)　取得ポイント

イベント履歴ログの取得ポイントを次の図に示します。

図7‒172　イベント履歴ログの取得ポイント

図中の番号の説明を次の表に示します。

表7‒240　イベント履歴ログの取得ポイント

図中の番号

トレース取得ポイント

取得ポイント情報

1

イベント発生時

OCCUR

スケジュール機能のイベント処理

OMIT

2

タスク呼び出し機能のタスク呼び出し処理

OMIT

3

タスク処理の開始

CALL

4

タスク処理の終了

RET

ERROR

(d)　出力先

イベント履歴ログの出力先を次に示します。

<J2EEサーバのログ出力ディレクトリ>/csc/rcp/schedule/<受付ID>

<J2EEサーバのログ出力ディレクトリ>は，HCSCサーバが動作するJ2EEサーバ用オプション定義ファイル（usrconf.cfg）のejb.server.log.directoryキーで指定します。J2EEサーバ用オプション定義ファイルについては，マニュアル「アプリケーションサーバリファレンス 定義編(サーバ定義)」の「2.2.2　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。

イベント履歴ログのログファイル名を次の表に示します。

表7‒241　イベント履歴ログのログファイル名

ログファイルの出力モード

ログファイル名

ラップアラウンドモードの場合

eventhistory_<面数>.log

シフトモードの場合

eventhistory_.log

イベント履歴ログのローテーションは，次のどちらかの条件に合致した際に実行されます。

指定したローテーション時刻に達したとき

ローテーション時刻の指定方法は，Application Serverの設定に従います。詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.3　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」を参照してください。

指定したファイルサイズに達したとき

イベント履歴ログの設定は，次に示すファイルで変更できます。

設定内容

変更する項目

マニュアル参照先

トレースの出力有無

スケジュール駆動受付コンフィグファイルのurecp-scd.eventhistory.log.enabledプロパティ

マニュアル「サービスプラットフォーム リファレンス」の「6.18.1　スケジュール駆動受付コンフィグファイル」

ファイルサイズ

スケジュール駆動受付コンフィグファイルのurecp-scd.eventhistory.log.filesizeプロパティ

ファイル面数

スケジュール駆動受付コンフィグファイルのurecp-scd.eventhistory.log.filenumプロパティ

ファイル出力先

J2EEサーバ用オプション定義ファイル（usrconf.cfg）のejb.server.log.directory

マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.2　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」

(e)　イベント履歴ログに関する注意事項

イベント履歴ログの初期化や停止に失敗した場合は，次のように動作します。

スケジュール駆動受付の起動時に，イベント履歴ログのロガー初期化に失敗した場合，メッセージログにワーニングメッセージ（KDEC84252-W）を出力して起動処理を継続します。デフォルトの出力先へログ出力できなかった場合は，該当するスケジュール駆動受付はイベント履歴ログを取得しないで運用を継続します。

スケジュール駆動受付の停止時に，イベント履歴ログのロガーの停止に失敗した場合，メッセージログにワーニングメッセージ（KDEC84253-W）を出力して停止処理を継続します。

(7)　スケジュール駆動受付の障害情報

(a)　スケジュール駆動受付で発生する障害の種類

スケジュール駆動受付で発生する障害の種類と，障害発生時の動作を次の表に示します。

障害の発生時期

障害発生時の動作

障害の主な原因

スケジュール駆動受付のデプロイ時

デプロイに失敗。

スケジュール駆動受付定義ファイルの設定値が誤っている。

スケジュール駆動受付の起動時

スケジュール駆動受付の起動に失敗。

メッセージKDEC84254-Eが出力され，スケジュールは実行されない。ただし，スケジュール駆動受付の起動処理は続行される。

次のどちらかの定義ファイルの設定値に誤りがあり，定義ファイルの解析に失敗。

スケジュール駆動受付定義ファイル

スケジュール駆動受付コンフィグファイル

スケジュールの実行時※

発生する時期によって次のように分類されます。

ビジネスプロセスの処理時に発生する障害

「(b)　ビジネスプロセスの処理時に発生する障害」を参照してください。

スケジュール駆動受付の処理時に発生する障害

「(c)　スケジュール駆動受付の処理時に発生する障害」を参照してください。

スケジュール駆動受付の停止時

（予期しない例外を除いて，発生する障害はない）

スケジュール駆動受付のアンデプロイ時

（予期しない例外を除いて，発生する障害はない）

注※

スケジュール駆動受付で発生した障害を基に，エラーが発生したイベントを特定する方法については，「(d)　スケジュール駆動受付で発生した障害の調査方法」を参照してください。

なお，逐次処理のタスクは，エラーの連続回数が規定値に達すると実行抑止するようタスクの呼び出し機能で設定できます。設定方法については，マニュアル「サービスプラットフォーム解説」の「3.6.3　スケジュール駆動受付でのタスクの呼び出し機能」を参照してください。

(b)　ビジネスプロセスの処理時に発生する障害

ビジネスプロセスの処理時に発生する障害は，スケジュール駆動受付が例外を受け取った場合，メッセージログに次のエラーメッセージが出力されます。この場合，タスク処理が失敗したとみなされますが，スケジュールの実行は続行します。

スケジュール駆動受付がランタイム例外やエラー（システム例外）を受け取った場合

メッセージログにエラーメッセージKDEC84202-Eが出力されます。

上記以外の例外（業務例外）を受け取った場合

メッセージログにエラーメッセージKDEC84200-Eが出力されます。

実行を待機できるタスク数が最大数に達した場合，タスク情報はタスク情報管理機能に登録されなくなり，現在発生しているイベントに関するタスクは実行されなくなりますが，スケジュールの実行は継続します。なお，この現象がスケジュール駆動受付の起動後に初めて発生した場合は，メッセージログにメッセージKDEC84204-Wが出力されます。

(c)　スケジュール駆動受付の処理時に発生する障害

スケジュール駆動受付の処理時に発生する障害の内容を次に示します。

作業フォルダの作成に失敗した場合

メッセージログにエラーメッセージが出力され，タスク処理が失敗したとみなされます。スケジュールの実行は続行されます。

作業フォルダの作成に失敗するケースと原因を次に示します。

作業フォルダの作成に失敗するケース

出力されるメッセージ

想定される原因

作業フォルダのルートフォルダが存在しない

KDEC84205-E

HCSCサーバ起動後に，ユーザが作業フォルダのルートフォルダを削除した

作業フォルダの作成に失敗

KDEC84206-E

ディスクフル

作業フォルダの削除に失敗した場合

メッセージログに警告メッセージKDEC84207-Wが出力されます。タスク処理とスケジュールの実行は続行します。

スケジュール機能が異常停止した場合

エラーメッセージKDEC84212-Eが出力されます。スケジュールは実行されません。

(d)　スケジュール駆動受付で発生した障害の調査方法

スケジュール駆動受付で発生した障害から，エラーが発生したイベントの情報を調査できるケースを次に示します。

ケース

出力されるメッセージ

エラーが発生したイベントの情報を調査する方法

ビジネスプロセスからエラーが返却された場合

KDEC84200-E

メッセージの「RootApInfo = 」の後ろに出力されているルートアプリケーション情報の値を確認し，イベント履歴ログで調査※します。

タスク処理の監視時間内にビジネスプロセスの処理が完了しなかった場合

KDEC84210-W

タスクの実行が省略された場合

KDEC84208-WまたはKDEC84209-W

メッセージに出力されている，イベント発生時刻の値を確認します。

注※

ルートアプリケーション情報の値を基に，イベント履歴ログの出力個所を調査します。出力個所では次の項目からイベントの情報を確認できます。

event occurrence time=（イベント発生時刻）

task processing start time=（タスクの実行開始時刻）

task processing end time=（タスクの実行終了時刻）

例1：メッセージKDEC84200-Eが出力された場合

イベント履歴ログに，ルートアプリケーション情報の値「xxx.xxx.xxx.xxx/19112/0x0000000000000781」が出力された個所を調査した結果を例として次に示します。

0000 2024/09/05 09:47:20.709     RCPSCD           BF8DCCE9 736CEB0C                       rcp3     CALL  xxx.xxx.xxx.xxx/19112/0x0000000000000781       event occurrence time = 2024/09/05 09:47:20.709,task processing start time = 2024/09/05 09:47:20.720
0001 2024/09/05 09:47:20.745     RCPSCD           BF8DCCE9 736CEB0C                       rcp3     ERROR xxx.xxx.xxx.xxx/19112/0x0000000000000781       event occurrence time = 2024/09/05 09:47:20.709,task processing start time = 2024/09/05 09:47:20.720,task processing end time = 2024/09/05 09:47:20.745
　　　：

この例では，イベントの発生時刻は「2024/09/05 09:47:20.709」であることを確認できます。

例2：メッセージKDEC84210-Wが出力された場合

イベント履歴ログに，ルートアプリケーション情報の値「xxx.xxx.xxx.xxx/19112/0x0000000000000b7b」が出力された個所を調査した結果を例として次に示します。

0000 2024/09/06 10:23:42.780     RCPSCD           BF8DCCE9 56A78753                       rcp3     CALL  xxx.xxx.xxx.xxx/19112/0x0000000000000b7b       event occurrence time = 2024/09/06 10:23:42.780,task processing start time = 2024/09/06 10:23:42.790
0001 2024/09/06 10:24:12.842     RCPSCD           BF8DCCE9 56A78753                       rcp3     RET   xxx.xxx.xxx.xxx/19112/0x0000000000000b7b       event occurrence time = 2024/09/06 10:23:42.780,task processing start time = 2024/09/06 10:23:42.790,task processing end time = 2024/09/06 10:24:12.842
　　　：

この例では，タスクの実行開始時刻は「2024/09/06 10:23:42.790」，実行終了時刻は「2024/09/06 10:24:12.842」であることを確認できます。

ただし，イベント履歴ログだけではビジネスプロセス内のどの処理で時間が掛かっているか確認できないため，性能解析トレースを確認してシステムの性能解析を実行する必要があります。性能解析トレースの調査時にも，メッセージ「KDEC84210-W」に出力されたルートアプリケーション情報の値を使用します。

性能解析トレースでシステムの性能解析を実行する方法については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.　性能解析トレースを使用した性能解析」を参照してください。

7.7.22　gRPC受付実行時の障害対策

この項では，gRPCインバウンドアダプタおよびgRPC受付の運用時に発生する障害に対して取得できる情報の種類について説明します。

(1)　障害情報の取得（gRPCインバウンドアダプタ）

gRPCインバウンドアダプタに関する障害情報には次の種類があります。

メッセージログ

メソッドトレース

データトレース

性能解析トレース

例外ログ

gRPC通信ログ

ここでは，これらの障害情報について説明します。

なお，gRPCインバウンドアダプタでは，このマニュアルで説明する障害情報のほかに，gRPCインバウンドアダプタが動作するJ2EEサーバおよびJavaVMが出力する資料があります。J2EEサーバおよびJavaVMが出力する資料については，マニュアル「アプリケーションサーバ機能解説 保守／移行編」の「4.　トラブルシューティングで必要な資料の出力先と出力方法」を参照してください。

(a)　メッセージログ（gRPCインバウンドアダプタ）

メッセージログのJ2EEサーバの稼働ログに，gRPCインバウンドアダプタで発生した各種情報がメッセージとして出力されます。

ここでは，メッセージログの出力形式と，出力される内容について説明します。メッセージログの出力先については，「7.4.1　メッセージログ」を参照してください。

●メッセージログの出力形式

メッセージログの出力形式を次に示します。

<番号> <日付> <時刻> <製品ID> <pid> <tid> <メッセージID> <メッセージテキスト>

●メッセージログの出力内容

メッセージログに出力される内容を次の表に示します。

表7‒242　メッセージログに出力される内容（gRPCインバウンドアダプタ）

項目

内容

番号

メッセージログの出力通番が表示されます。

日付

メッセージログの取得日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

メッセージログの取得時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

製品ID

製品を特定するための識別子が出力されます。

CSCGRI：gRPCインバウンドアダプタ

pid

プロセスを識別するためのIDが出力されます。OSが管理するプロセスIDとは異なります。

tid

スレッドを識別するためのIDが出力されます。OSが管理するスレッドIDとは異なります。

メッセージID

メッセージIDが出力されます。

メッセージテキスト

メッセージの内容が出力されます。

●メッセージログの出力レベル

メッセージログの出力レベルは，Connector属性ファイルのmessagelogLevelで変更できます。出力レベルの設定方法については，「3.1.2(12)　gRPCインバウンドアダプタのセットアップ」を参照してください。

(b)　メソッドトレース（gRPCインバウンドアダプタ）

メソッドトレースは，二次情報としてgRPCインバウンドアダプタが独自に取得します。保守員が障害解析のために使用します。

メソッドトレースの出力に失敗した場合は次のように動作します。

トレースの初期化に失敗した場合，メソッドトレースは出力されないで，開始処理に失敗します。

運用中にメソッドトレースの出力に障害が発生した場合，それ以降のメソッドトレースの取得は中止されますが，処理は続行されます。

以降にgRPCインバウンドアダプタのメソッドトレースについて説明します。

●メソッドトレースの出力形式

メソッドトレースの出力形式を次に示します。

●出力される内容

メソッドトレースに出力される内容を次の表に示します。

表7‒243　メソッドトレースに出力される項目（gRPCインバウンドアダプタ）

項目

内容

番号

メソッドトレースの出力通番が表示されます。

日付

メソッドトレースの取得日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

メソッドトレースの取得時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

ローカル時刻でミリ秒単位の時刻を示します。

製品ID

製品を特定するための識別子が出力されます。

CSCGRI：gRPCインバウンドアダプタ

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID

空白

種別

トレース取得ポイントの種別が出力されます。

BGN：メソッドの開始

END：メソッドの終了

CAL：メソッドの呼び出し

RET：メソッドの戻り

THR：例外のthrow

CTH：例外のcatch

クラス名

トレースを取得するクラス名が出力されます。

30文字未満の場合は左詰めされ，足りない文字はスペースで補われます。

メソッド名

トレースを取得するメソッド名が出力されます。

30文字未満の場合は左詰めされ，足りない文字はスペースで補われます。

入出力情報

トレースを取得するメソッドの入出力情報（引数や戻り値の値など）が出力されます。

CRLF

レコード終端符号が出力されます。

●メソッドトレースの出力先

gRPCインバウンドアダプタのメソッドトレースの出力先を次に示します。

<J2EEサーバのログ出力ディレクトリ>¥csc¥inbound-adapter¥grpc¥gRPC_Inbound_Resource_Adapter(リソースアダプタ名)

<J2EEサーバのログ出力ディレクトリ>は，HCSCサーバが動作するJ2EEサーバ用オプション定義ファイル（usrconf.cfg）のejb.server.log.directoryキーで指定します。詳細は，マニュアル「アプリケーションサーバリファレンス 定義編(サーバ定義)」の「2.2.2　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。

メソッドトレースのトレースファイル名を次に示します。

表7‒244　メソッドトレースのトレースファイル名（gRPCインバウンドアダプタ）

トレースファイルの出力モード

トレースファイル名

ラップアラウンドモードの場合

methodtrace_<HCSCサーバ名>_<面数>.log

シフトモードの場合

methodtrace_<HCSCサーバ名>_.log

メソッドトレースのローテーションは，次のどちらかの条件に合致した際に実行されます。

指定したローテーション時刻に達したとき

ローテーション時刻の指定方法は，Application Serverの設定に従います。詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.3　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」を参照してください。

指定したファイルサイズに達したとき

また，メソッドトレースの出力レベル，ファイルサイズ，およびファイル面数は，RARファイルの属性を設定するConnector属性ファイルで変更できます。プロパティを次に示します。

メソッドトレースの出力レベル：methodtraceLevel

メソッドトレースのファイルサイズ：methodtraceFilesize

バックアップファイルの面数：methodtraceFilenum

設定手順については，「3.1.2(12)　gRPCインバウンドアダプタのセットアップ」を参照してください。

(c)　データトレース（gRPCインバウンドアダプタ）

データトレースは，二次情報としてgRPCインバウンドアダプタが独自に取得します。送受信データ内容を取得することで，データ（内部データ）の正当性を確認できます。デフォルトではデータトレースは出力されません。

データトレースの出力に失敗した場合は次のように動作します。

トレースの初期化に失敗した場合，データトレースは出力されないで，開始処理に失敗します。

運用中にデータトレースの出力に障害が発生した場合，それ以降のデータトレースの取得は中止されますが，処理は続行されます。

以降にgRPCインバウンドアダプタのデータトレースについて説明します。

●データトレースの出力形式

データトレースの出力形式を次に示します。

<番号> <日付> <時刻> <製品ID> <pid> <tid> <メッセージID種別> <出力種別> <メッセージ情報> <CRLF>

●出力される内容

データトレースに出力される内容を次の表に示します。

表7‒245　データトレースに出力される項目（gRPCインバウンドアダプタ）

項目

内容

番号

データトレースの出力通番が表示されます。

日付

データトレースの取得日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

データトレースの取得時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

ローカル時刻でミリ秒単位の時刻を示します。

製品ID

製品を特定するための識別子が出力されます。

CSCGRI：gRPCインバウンドアダプタ

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

メッセージID種別

空白

出力種別

トレースの取得ポイントの種別が出力されます。

REQ：要求電文※1

RSP：応答電文※1

FLT：応答フォルト電文

メッセージ情報

メッセージ情報※2が出力されます。

CRLF

レコードの終端符号が出力されます。

注※1

取得される内容を次に示します。

要求電文

gRPCクライアントから受信したデータが取得されます。

応答電文

gRPCクライアントへ送信するデータが取得されます。

注※2

メッセージ内のフィールド「フィールド名:フィールド値」が「,（コンマ）」で区切って出力されます。バイナリデータの場合は，Base64変換された文字列が出力されます。

メッセージ情報の出力例を次に示します。

field1:1,field2:abc,field3:1.25

フィールド値が配列の場合，各々の配列要素が「,（コンマ）」で区切られ，「[ ]（角括弧）」で囲まれて出力されます。

field:[1,2,3,4]

フィールド値がメッセージ型の場合，「{ }（波括弧）」で囲まれて出力されます。

field:{subfield1:1,subfield2:2}

フィールド値内の「,[]{}:（コンマ，角括弧，波括弧，コロン）」は，連続2文字にエスケープされます。

例えば，fieldの値が「Taro, Yamada [Student] {male:}」の場合は，次のように出力されます。

field:Taro,, Yamada [[Student]] {{male::}}

●データトレースの出力先

データトレースの出力先を次に示します。

<J2EEサーバのログ出力ディレクトリ>¥csc¥inbound-adapter¥grpc¥gRPC_Inbound_Resource_Adapter

<J2EEサーバのログ出力ディレクトリ>は，usrconf.cfg（J2EEサーバ用オプション定義ファイル）のejb.server.log.directoryキーで変更できます。デフォルトは，<サービスプラットフォームのインストールディレクトリ>¥ejb¥<サーバ名称>¥logsです。usrconf.cfgの詳細は，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.2　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。

データトレースのトレースファイル名を次の表に示します。

表7‒246　データトレースのトレースファイル名（gRPCインバウンドアダプタ）

トレースファイルの出力モード

トレースファイル名

ラップアラウンドモードの場合

datatrace_<HCSCサーバ名>_<面数>.log

シフトモードの場合

datatrace_<HCSCサーバ名>_.log

データトレースのローテーションは，次のどちらかの条件に合致した際に実行されます。

指定したローテーション時刻に達したとき

ローテーション時刻の指定方法は，Application Serverの設定に従います。詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.3　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」を参照してください。

指定したファイルサイズに達したとき

また，データトレースの出力有無，ファイルサイズ，およびファイル面数は，RARファイルの属性を設定するConnector属性ファイルで変更できます。プロパティを次に示します。

データトレースの出力有無：datatraceEnable

データトレースのファイルサイズ：datatraceFilesize

データトレースの面数：datatraceFilenum

設定手順については，「3.1.2(12)　gRPCインバウンドアダプタのセットアップ」を参照してください。

(d)　性能解析トレース（gRPCインバウンドアダプタ）

gRPCインバウンドアダプタの性能解析トレースについて説明します。

●性能解析トレースの出力形式

性能解析トレースファイルに出力される形式は，J2EEサーバの性能解析トレースと同様です。詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.3　Management Serverを利用した性能解析トレースファイルの収集」を参照してください。

●出力される内容

性能解析トレースファイルに出力される内容を次の表に示します。

表7‒247　性能解析トレースファイルに出力される内容（gRPCインバウンドアダプタ）

項目

ヘッダ

内容

イベントID

Event

取得ポイントのイベントIDが出力されます。

取得ポイントの詳細は，項目「●性能解析トレースの取得ポイント」を参照してください。

リターンコード

Rc

取得ポイント種別が出力されます。

0：正常終了

1：異常終了

インターフェース名

INT

クラス名が出力されます。

オペレーション名

OPR

メソッド名が出力されます。

オプション情報

OPT

取得ポイントごとに異なる情報を16進表記で出力します。

ASCII

OPTの内容を文字列の形で出力します。

●性能解析トレースの取得ポイント

性能解析トレースの取得ポイントを次の図に示します。

図7‒173　性能解析トレースの取得ポイント（gRPCインバウンドアダプタ）

イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。表の「図中の番号」は上の図の番号と対応しています。

表7‒248　性能解析トレースの取得ポイント（gRPCインバウンドアダプタ）

イベントID

図中の番号

トレース取得ポイント

レベル

0x98e0

1

gRPCクライアントからのデータ受信

A

0x98e1

2

gRPCクライアントからのデータ受信後

A

0x98e2

3

MDB呼び出し前

A

0x98e3

4

MDB呼び出し完了後

A

0x98e4

5

gRPCクライアントへのデータ送信前

A

0x98e5

6

gRPCクライアントへのデータ送信

A

（凡例）

A：「標準」であることを示します。

●性能解析トレースの取得方法と出力先

性能解析トレースを取得するには設定が必要です。設定の詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.　性能解析トレースを使用した性能解析」を参照してください。

(e)　例外ログ（gRPCインバウンドアダプタ）

例外ログは，gRPCインバウンドアダプタ内で障害が発生した場合に出力する，スタックトレースのログファイルです。例外を出力するログのため，出力レベルに依存しません。

例外ログの出力に失敗した場合は次のように動作します。

ログの初期化に失敗した場合，例外ログは出力されないで，開始処理に失敗します。

運用中に例外ログの出力に障害が発生した場合，それ以降の例外ログの取得は中止されますが，処理は続行されます。

以降にgRPCインバウンドアダプタの例外ログについて説明します。

●例外ログの出力形式と出力内容

例外ログの出力形式を次の図に示します。

図7‒174　例外ログの出力形式（gRPCインバウンドアダプタ）

図中の項目ごとに，例外ログに出力される内容を次の表に示します。

表7‒249　例外ログに出力される内容（gRPCインバウンドアダプタ）

項目

内容

番号

例外ログの出力通番が表示されます。

日付

例外ログの取得日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

例外ログの取得時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

ローカル時刻でミリ秒単位の時刻を示します。

製品ID

製品を特定するための識別子が出力されます。

CSCGRI：gRPCインバウンドアダプタ

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID

空白

スタックトレース情報

スタックトレース情報が出力されます。

CRLF

レコードの終端符号が出力されます。

●例外ログの出力先

例外ログの出力先を次に示します。

<J2EEサーバのログ出力ディレクトリ>¥csc¥inbound-adapter¥grpc¥gRPC_Inbound_Resource_Adapter(リソースアダプタ名)

<J2EEサーバのログ出力ディレクトリ>は，usrconf.cfg（J2EEサーバ用オプション定義ファイル）のejb.server.log.directoryキーで変更できます。usrconf.cfgの詳細は，マニュアル「アプリケーションサーバリファレンス 定義編(サーバ定義)」の「2.2.2　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。

例外ログのログファイル名を次の表に示します。

表7‒250　例外ログのログファイル名（gRPCインバウンドアダプタ）

ログファイルの出力モード

ログファイル名

ラップアラウンドモードの場合

exception_<HCSCサーバ名>_<面数>.log

シフトモードの場合

exception_<HCSCサーバ名>_.log

例外ログのローテーションは，次のどちらかの条件に合致した際に実行されます。

指定したローテーション時刻に達したとき

ローテーション時刻の指定方法は，Application Serverの設定に従います。詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.3　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」を参照してください。

指定したファイルサイズに達したとき

また，例外ログのファイルサイズおよびファイル面数は，RARファイルの属性を設定するConnector属性ファイルで変更できます。プロパティを次に示します。

ログファイルのサイズ：exceptionlogFilesize

ログファイルの面数：exceptionlogFilenum

gRPCインバウンドアダプタの属性ファイルの指定については，「3.1.2(12)　gRPCインバウンドアダプタのセットアップ」を参照してください。

(f)　gRPC通信ログ（gRPCアダプタ・gRPCインバウンドアダプタ共通）

gRPC通信ログには，gRPC（OSS）ライブラリが出力するログメッセージを出力します。

gRPC通信ログはgRPCアダプタと共通で使用します。gRPC通信ログについては「7.7.23(6)　gRPC通信ログ（gRPCアダプタ・gRPCインバウンドアダプタ共通）」を参照してください。

(g)　gRPCインバウンドアダプタの障害情報（gRPCインバウンドアダプタ）

gRPCインバウンドアダプタで発生する障害の種類と，障害発生時の動作を説明します。

OSSサーバ実装の起動失敗

指定したポートの使用中に，サーバ動作環境のリソースが不足したなどの要因が考えられます。

この場合，検出した例外を例外ログに出力すると共に，メッセージログにメッセージKDEC07801-Eを出力して，gRPCサーバ開始処理を中断します。

結果的に運用機能の開始処理は失敗し，例外（ResourceAdapterInternalException）をスローします。

OSSサーバ実装のシャットダウン遅延

gRPC受付処理が実行中などによって，指定された時間内にシャットダウン処理が完了しなかったと考えられます。

gRPCインバウンドアダプタの属性ファイルのserverShutdownTimeoutで設定された待機時間を過ぎた場合，メッセージログにメッセージKDEC07811-Wを出力して，OSSサーバ実装のシャットダウンを無期限に待機します。

通信障害

gRPCクライアントが応答電文の送信前に終了したなどの要因が考えられます。

この場合，検出した例外を例外ログに出力すると共に，メッセージログにメッセージKDEC07841-Eを出力して，gRPCリクエストの処理を中断します。

通信障害の発生後も，それ以降の処理は正常に実行されます。

gRPC受付連携情報不正

次に示す要因によって，誤った情報が運用機能のエンドポイントアクティベーション時に渡されたと考えられます。

ディスクリプタセットファイル不正

ディスクリプタセットファイル内に指定メソッドが存在しない　など

この場合，検出した例外を例外ログに出力すると共に，メッセージログにメッセージKDEC07821-Eを出力して，NotSupportedExceptionをスローします。

なお，該当するエンドポイントアクティベーションは失敗します。

(2)　障害情報の取得（gRPC受付）

gRPC受付では，障害情報として性能解析トレースを出力します。

ここでは，gRPC受付の実行時に発生したエラーの伝わり方と，性能解析トレースについて説明します。

(a)　gRPC受付実行時に発生したエラーの伝わり方

gRPCクライアントからgRPC受付を使用してビジネスプロセスを呼び出す場合のエラーの伝わり方を説明します。エラーの伝わり方は，エラーの種類によって異なります。

gRPC受付がエラーを検知した場合

gRPC受付がエラーを検知した場合のエラーの伝わり方を次の図に示します。

図7‒175　gRPC受付がエラーを検知した場合のエラーの伝わり方

エラーの伝わる流れを次に示します。

gRPC受付は検知した障害を基に，障害情報を含むメッセージを生成してgRPCインバウンドアダプタに返却します。gRPCインバウンドアダプタには例外をスローしません。

gRPCインバウンドアダプタは，クライアントにエラー応答（応答データに設定されているステータスコード，エラー情報など）を返却します。

カスタム受付フレームワークがエラーをリターンした場合

カスタム受付フレームワークがエラーをリターンした場合のエラーの伝わり方を次の図に示します。gRPC受付の受付処理では，キャッチした例外を基にエラーメッセージを生成し，gRPCインバウンドアダプタに返却します。gRPCインバウンドアダプタには例外をスローしません。

図7‒176　カスタム受付フレームワークがエラーをリターンした場合のエラーの伝わり方

図中に示したエラー1〜エラー5の要因を次に示します。

エラー1：要求パラメタ不正など

エラー2：宛先（ロケーション）が見つからない，サービスアダプタが停止しているなど

エラー3：データ変換の失敗など

エラー4：宛先不正，サービス部品が停止，通信障害など

エラー5：ビジネスプロセス処理上での例外エラーなど

エラー1〜エラー5のどれかが発生した場合，例外をキャッチしたカスタム受付フレームワークはgRPC受付の受付処理に対して，CSCMsgServerExceptionをスローします。

CSCMsgServerExceptionの詳細は，マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「付録A.3　カスタム受付フレームワークのAPI」を参照してください。

gRPC受付にエラーを示す応答電文が返された場合

gRPC受付にエラーを示す応答電文が返された場合のエラーの伝わり方を次の図に示します。

図7‒177　gRPC受付にエラーを示す応答電文が返された場合のエラーの伝わり方

エラーの伝わる流れを次に示します。

サービスアダプタから返されたフォルト電文が，ビジネスプロセスのフォルト処理に伝わります。

ビジネスプロセスのフォルト処理で，障害情報をフォルト電文にデータ変換し，エラーを示す応答電文を応答します。

メッセージ配送基盤およびカスタム受付フレームワークを経由して，gRPC受付にエラーを示す応答電文が返ります。

gRPC受付は，応答電文から応答データ（障害情報を含むメッセージ）を作成して，gRPCインバウンドアダプタに返します。

gRPCインバウンドアダプタは，クライアントにエラー応答（応答データに設定されているステータスコード，エラー情報など）を返却します。

(b)　メッセージログ（gRPC受付）

メッセージログのJ2EEサーバの稼働ログに，gRPC受付で発生した各種情報がメッセージとして出力されます。

メッセージログの出力内容や出力先については，「7.4.1　メッセージログ」を参照してください。

(c)　性能解析トレース（gRPC受付）

gRPC受付の性能解析トレースについて説明します。

●性能解析トレースの出力形式

性能解析トレースファイルに出力される形式は，J2EEサーバの性能解析トレースと同様です。詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.3　Management Serverを利用した性能解析トレースファイルの収集」を参照してください。

●出力される内容

性能解析トレースファイルに出力される内容を次の表に示します。

表7‒251　性能解析トレースファイルに出力される内容（gRPC受付）

項目

内容

イベントID

取得ポイントのイベントIDが出力されます。

取得ポイントの詳細は，項目「●性能解析トレースの取得ポイント」を参照してください。

リターンコード

取得ポイント種別が出力されます。

0：正常終了

1：異常終了

インターフェース名

クラス名が出力されます。

オペレーション名

メソッド名が出力されます。

オプション情報※

メッセージ共通ID

リクエスト識別情報（親ID）が出力されます。未設定の場合，nullが出力されます。

サービスリクエストID

リクエスト識別情報（子ID）が出力されます。未設定の場合，nullが出力されます。

付加情報

次のオプション情報が出力されます。

受付名

受付ID

クライアント相関ID

サービス名

サービスオペレーション名

例外名（障害発生時だけ）

注※

オプション情報は最大256バイトです。「●性能解析トレースの取得ポイント」の図の取得ポイントの1.と2.では出力されません。

●性能解析トレースの取得ポイント

性能解析トレースの取得ポイントを次の図に示します。

図7‒178　性能解析トレースの取得ポイント（gRPC受付）

イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。表の「図中の番号」は上の図の番号と対応しています。

表7‒252　性能解析トレースの取得ポイント（gRPC受付）

イベントID

図中の番号

トレース取得ポイント

レベル

0x98D4

1

カスタム受付の入口

A

0x98D5

2

カスタム受付の出口

A

0x98D6

3

カスタム受付フレームワークの呼び出し口

B

0x98D7

4

カスタム受付フレームワークの応答受信口

B

0x9860

5

カスタム受付フレームワークの入口

A

0x9861

6

カスタム受付フレームワークの出口

A

0x9864

7

HCSCメッセージ配送制御の呼び出し口

A

0x9865

8

HCSCメッセージ配送制御の応答受信口

A

（凡例）

A：「標準」であることを示します。

B：「詳細」であることを示します。

●性能解析トレースの取得方法と出力先

性能解析トレースを取得するには設定が必要です。設定の詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.　性能解析トレースを使用した性能解析」を参照してください。

7.7.23　gRPCアダプタ実行時の障害対策

この項では，gRPCアダプタの運用時に発生する障害に対して取得できる情報の種類について説明します。

gRPCアダプタに関する障害情報には次の種類があります。

メッセージログ

メソッドトレース

データトレース

性能解析トレース

例外ログ

gRPC通信ログ

ここでは，これらの障害情報について説明します。

(1)　メッセージログ（gRPCアダプタ）

メッセージログのJ2EEサーバの稼働ログに，gRPCアダプタで発生した各種情報がメッセージとして出力されます。

メッセージログについては，「7.4.1　メッセージログ」を参照してください。

メッセージログの出力レベルは，gRPCアダプタ実行環境プロパティファイルのadpgrpc.config.messagelog.levelプロパティで変更できます。gRPCアダプタ実行環境プロパティファイルについては，マニュアル「サービスプラットフォームリファレンス」の「6.19.1　gRPCアダプタ実行環境プロパティファイル」を参照してください。

(2)　メソッドトレース（gRPCアダプタ）

メソッドトレースは，二次情報としてgRPCアダプタが独自に取得します。保守員が障害解析のために使用します。

メソッドトレースの出力に失敗した場合は次のように動作します。

トレースの初期化に失敗した場合，メソッドトレースは出力されませんが，gRPCアダプタの開始処理は続行されます。

運用中にメソッドトレースの出力に障害が発生した場合，それ以降のメソッドトレースの取得は中止されますが，処理は続行されます。

以降にgRPCアダプタのメソッドトレースについて説明します。

(a)　出力形式

メソッドトレースの出力形式を次の図に示します。

図7‒179　メソッドトレースの出力形式

(b)　出力される内容

メソッドトレースに出力される内容を次の表に示します。

表7‒253　メソッドトレースに出力される項目（gRPCアダプタ）

項目

内容

番号

メソッドトレースの出力通番が表示されます。

日付

メソッドトレースの取得日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

メソッドトレースの取得時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

ローカル時刻でミリ秒単位の時刻を示します。

製品ID

製品を特定するための識別子として，gRPCアダプタを示す「ADPGRPC」が表示されます。

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID

空白

種別

トレース取得ポイントの種別が出力されます。

BGN：メソッドの開始

END：メソッドの終了

CAL：メソッドの呼び出し

RET：メソッドの戻り

THR：例外のthrow

CTH：例外のcatch

DBG：デバッグ情報

クラス名

トレースを取得するクラス名が出力されます。

30文字未満の場合は左詰めされ，足りない文字はスペースで補われます。

メソッド名

トレースを取得するメソッド名が出力されます。

30文字未満の場合は左詰めされ，足りない文字はスペースで補われます。

入出力情報

トレースを取得するメソッドの入出力情報（引数や戻り値の値，例外発生時は例外名など），またはスタックトレースが出力されます。

CRLF

レコード終端符号が出力されます。

(c)　出力先

gRPCアダプタのメソッドトレースの出力先を次に示します。

<J2EEサーバのログ出力ディレクトリ>¥CSCADP¥GRPCADP¥maintenance¥<サービスID>

<J2EEサーバのログ出力ディレクトリ>は，HCSCサーバが動作するJ2EEサーバ用オプション定義ファイル（usrconf.cfg）のejb.server.log.directoryキーで指定します。詳細は，マニュアル「アプリケーションサーバリファレンス 定義編(サーバ定義)」の「2.2.2　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。

メソッドトレースのトレースファイル名を次に示します。

表7‒254　メソッドトレースのトレースファイル名（gRPCアダプタ）

トレースファイルの出力モード

トレースファイル名

ラップアラウンドモードの場合

cscadpgrpcmnt_<HCSCサーバ名>_<面数>.log

シフトモードの場合

cscadpgrpcmnt_<HCSCサーバ名>_.log

メソッドトレースのローテーションは，次のどちらかの条件に合致した際に実行されます。

指定したローテーション時刻に達したとき

ローテーション時刻の指定方法は，Application Serverの設定に従います。詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.3　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」を参照してください。

指定したファイルサイズに達したとき

また，メソッドトレースの出力情報は，gRPCアダプタ実行環境プロパティファイルの次に示すプロパティで変更できます。gRPCアダプタ実行環境プロパティファイルについては，マニュアル「サービスプラットフォームリファレンス」の「6.19.1　gRPCアダプタ実行環境プロパティファイル」を参照してください。

adpgrpc.config.methodtrace.level=出力レベル

adpgrpc.config.methodtrace.filenum=ファイル面数

adpgrpc.config.methodtrace.filesize=ファイルサイズ

変更方法の詳細については，マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「3.3.17　gRPCアダプタを定義する」のgRPCアダプタ実行環境プロパティファイルの作成に関する説明を参照してください。

(3)　データトレース（gRPCアダプタ）

データトレースは，二次情報としてgRPCアダプタが独自に取得します。メッセージの正当性の確認や，障害対策に利用できます。デフォルトではデータトレースは出力されません。

データトレースの出力に失敗した場合は次のように動作します。

トレースの初期化に失敗した場合，データトレースは出力されませんが，gRPCアダプタの開始処理は続行されます。

運用中にデータトレースの出力に障害が発生した場合，それ以降のデータトレースの取得は中止されますが，処理は続行されます。

以降にgRPCアダプタのデータトレースについて説明します。

(a)　出力形式

データトレースの出力形式を次に示します。

図7‒180　データトレースの出力形式（gRPCアダプタ）

(b)　出力される内容

データトレースに出力される内容を次の表に示します。

表7‒255　データトレースに出力される項目（gRPCアダプタ）

項目

内容

番号

データトレースの出力通番が表示されます。

日付

データトレースの取得日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

データトレースの取得時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

ローカル時刻でミリ秒単位の時刻を示します。

製品ID

製品を特定するための識別子として，gRPCアダプタを示す「ADPGRPC」が表示されます。

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID

空白

オペレーション名

リクエストで呼び出されたオペレーション名が出力されます。

出力種別

トレースの取得ポイントの種別が出力されます。

CAL：gRPCサービスへ送信するメッセージ※1

RET：gRPCサービスから返却されたメッセージ※1

メッセージ情報

メッセージ情報※2が出力されます。

CRLF

レコード終端符号が出力されます。

注※1

取得される内容を次に示します。

gRPCサービスへ送信するメッセージ

gRPCサービスへ送信する要求メッセージ（gRPCクライアントへのデータ送信前のオブジェクト）が取得されます。

gRPCサービスから返却されたメッセージ

gRPCサービスから返却された応答メッセージ（gRPCクライアントから受信したオブジェクト）が取得されます。

注※2

メッセージ内のフィールド「フィールド名:フィールド値」が「,（コンマ）」で区切って出力されます。バイナリデータを出力する場合は，Base64変換した文字列が出力されます。

メッセージ情報の出力例を次に示します。

field1:1,field2:abc,field3:1.25

フィールド値が配列の場合，各々の配列要素が「,（コンマ）」で区切られ，「[ ]（角括弧）」で囲まれて出力されます。

field:[1,2,3,4]

フィールド値がメッセージ型の場合，「{ }（波括弧）」で囲まれて出力されます。

field:{subfield1:1,subfield2:2}

フィールド値内の「,[]{}:（コンマ，角括弧，波括弧，コロン）」は，連続2文字にエスケープされます。

例えば，fieldの値が「Taro, Yamada [Student] {male:}」の場合は，次のように出力されます。

field:Taro,, Yamada [[Student]] {{male:}}

(c)　出力先

データトレースの出力先を次に示します。

<J2EEサーバのログ出力ディレクトリ>¥CSCADP¥GRPCADP¥maintenance¥<サービスID>

<J2EEサーバのログ出力ディレクトリ>は，usrconf.cfg（J2EEサーバ用オプション定義ファイル）のejb.server.log.directoryキーで変更できます。usrconf.cfgの詳細は，マニュアル「アプリケーションサーバリファレンス 定義編(サーバ定義)」の「2.2.2　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。

データトレースのトレースファイル名を次に示します。

表7‒256　データトレースのトレースファイル名（gRPCアダプタ）

トレースファイルの出力モード

トレースファイル名

ラップアラウンドモードの場合

dattrace_<面数>.log

シフトモードの場合

dattrace_.log

データトレースのローテーションは，次のどちらかの条件に合致した際に実行されます。

指定したローテーション時刻に達したとき

ローテーション時刻の指定方法は，Application Serverの設定に従います。詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.3　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」を参照してください。

指定したファイルサイズに達したとき

また，データトレースの出力情報は，gRPCアダプタ実行環境プロパティファイルの次に示すプロパティで変更できます。gRPCアダプタ実行環境プロパティファイルについては，マニュアル「サービスプラットフォームリファレンス」の「6.19.1　gRPCアダプタ実行環境プロパティファイル」を参照してください。

adpgrpc.config.datatrace.enabled=出力有無

adpgrpc.config.datatrace.filenum=ファイル面数

adpgrpc.config.datatrace.filesize=ファイルサイズ

変更方法の詳細については，マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「3.3.17　gRPCアダプタを定義する」のgRPCアダプタ実行環境プロパティファイルの作成に関する説明を参照してください。

(4)　性能解析トレース（gRPCアダプタ）

性能解析トレースを取得するには設定が必要です。設定の詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.　性能解析トレースを使用した性能解析」を参照してください。

(a)　性能解析トレースの出力形式

性能解析トレースファイルに出力される形式は，J2EEサーバの性能解析トレースと同様です。詳細は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.3　Management Serverを利用した性能解析トレースファイルの収集」を参照してください。

(b)　出力される内容

性能解析トレースファイルに出力される内容を次の表に示します。

表7‒257　性能解析トレースファイルに出力される内容（gRPCアダプタ）

項目

ヘッダ

内容

イベントID

Event

取得ポイントのイベントIDが出力されます。

取得ポイントの詳細は，項目「(c) 性能解析トレースの取得ポイント」を参照してください。

リターンコード

Rc

取得ポイント種別が出力されます。

0：正常終了

1：異常終了

インターフェース名

INT

クラス名が出力されます。

オペレーション名

OPR

メソッド名が出力されます。

オプション情報

OPT

取得ポイントごとに異なる情報を16進表記で出力します。

ASCII

OPTの内容を文字列の形で出力します。

(c)　性能解析トレースの取得ポイント

性能解析トレースの取得ポイントを次の図に示します。

図7‒181　性能解析トレースの取得ポイント（gRPCアダプタ）

イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。表の「図中の番号」は上の図の番号と対応しています。

表7‒258　性能解析トレースの取得ポイント（gRPCアダプタ）

イベントID

図中の番号

トレース取得ポイント

レベル

0xAB14

1

gRPCアダプタの入口

B

0xAB15

2

gRPCアダプタの出口

B

0xAB16

3

メッセージ送信時

A

0xAB17

4

メッセージ受信時

A

（凡例）

A：「標準」であることを示します。

B：「詳細」であることを示します。

(5)　例外ログ（gRPCアダプタ）

トレースの開始以降に発生した例外情報（スタックトレース）を例外ログとして別のファイルに出力します。例外ログでは，出力ファイルのパスと出力レベルは設定しないで，出力ファイルのサイズと面数を設定します。

例外ログの出力に失敗した場合は次のように動作します。

ログの初期化に失敗した場合，例外ログは出力されませんが，gRPCアダプタの開始処理は続行されます。

運用中に例外ログの出力に障害が発生した場合，それ以降の例外ログの取得は中止されますが，処理は続行されます。

gRPCアダプタの例外ログについて説明します。

(a)　例外ログの出力形式

例外ログの出力形式を次の図に示します。

図7‒182　例外ログの出力形式（gRPCアダプタ）

(b)　出力される内容

例外ログに出力される内容を次の表に示します。

表7‒259　例外ログに出力される内容（gRPCアダプタ）

項目

内容

番号

例外ログの出力通番が表示されます。

日付

例外ログの取得日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

例外ログの取得時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

ローカル時刻でミリ秒単位の時刻を示します。

製品ID

製品を特定するための識別子として，gRPCアダプタを示す「ADPGRPC」が表示されます。

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID

空白

スタックトレース情報

スタックトレース情報が出力されます。

CRLF

レコードの終端符号が出力されます。

(c)　出力先

例外ログの出力先を次に示します。

<J2EEサーバのログ出力ディレクトリ>¥CSCADP¥GRPCADP¥maintenance¥<サービスID>

<J2EEサーバのログ出力ディレクトリ>は，usrconf.cfg（J2EEサーバ用オプション定義ファイル）のejb.server.log.directoryキーで変更できます。usrconf.cfgの詳細は，マニュアル「アプリケーションサーバリファレンス 定義編(サーバ定義)」の「2.2.2　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。

例外ログのログファイル名を次の表に示します。

表7‒260　例外ログのログファイル名（gRPCアダプタ）

ログファイルの出力モード

ログファイル名

ラップアラウンドモードの場合

cscadpgrpcexp_<HCSCサーバ名>_<面数>.log

シフトモードの場合

cscadpgrpcexp_<HCSCサーバ名>_.log

例外ログのローテーションは，次のどちらかの条件に合致した際に実行されます。

指定したローテーション時刻に達したとき

ローテーション時刻の指定方法は，Application Serverの設定に従います。詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.3　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」を参照してください。

指定したファイルサイズに達したとき

また，ログファイルの面数は，gRPCアダプタ実行環境プロパティファイルのadpgrpc.config.exptrace.filenumプロパティで指定します。ログファイルのサイズは，gRPCアダプタ実行環境プロパティファイルのadpgrpc.config.exptrace.filesizeプロパティで指定します。

gRPCアダプタ実行環境プロパティファイルの詳細は，マニュアル「サービスプラットフォーム リファレンス」の「6.19.1　gRPCアダプタ実行環境プロパティファイル」を参照してください。

(6)　gRPC通信ログ（gRPCアダプタ・gRPCインバウンドアダプタ共通）

gRPC通信ログには，gRPC（OSS）ライブラリが出力するログメッセージを出力します。gRPC通信ログはgRPCインバウンドアダプタと共通で使用します。

gRPC通信ログ機能の初期化に失敗した場合は，メッセージログにKDEC06512-Eメッセージを出力し，gRPC（OSS）ライブラリログは出力しないで処理を続行します。

gRPC（OSS）ライブラリログの出力障害が発生した場合は，出力処理を中止して処理を続行します。

(a)　出力形式

gRPC通信ログの出力形式を次の図に示します。

(b)　出力される内容

gRPC通信ログに出力される内容を次の表に示します。

表7‒261　gRPC通信ログに出力される項目（gRPCアダプタ・gRPCインバウンドアダプタ共通）

項目

内容

番号

gRPC通信ログの出力通番が表示されます。

日付

gRPC通信ログの取得日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

gRPC通信ログの取得時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

ローカル時刻でミリ秒単位の時刻を示します。

製品ID

製品を特定するための識別子として，gRPC通信ログを示す「GRPCCMN」が表示されます。

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID

空白

種別

トレース取得ポイントの種別が出力されます。

THR：例外のthrow

DBG：デバッグ情報

クラス名

gRPC通信ログを取得するクラス名が出力されます。

30文字未満の場合は左詰めされ，足りない文字はスペースで補われます。

メソッド名

gRPC通信ログを取得するメソッド名が出力されます。

30文字未満の場合は左詰めされ，足りない文字はスペースで補われます。

入出力情報

gRPC（OSS）ライブラリが出力するログ内容が出力されます。

CRLF

レコード終端符号が出力されます。

(c)　出力先

gRPC通信ログの出力先を次に示します。

<J2EEサーバのログ出力ディレクトリ>¥CSC¥maintenance¥grpccmn

<J2EEサーバのログ出力ディレクトリ>は，HCSCサーバが動作するJ2EEサーバ用オプション定義ファイル（usrconf.cfg）のejb.server.log.directoryキーで指定します。詳細は，マニュアル「アプリケーションサーバリファレンス 定義編(サーバ定義)」の「2.2.2　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。

gRPC通信ログのログファイル名を次に示します。

表7‒262　gRPC通信ログのログファイル名（gRPCアダプタ・gRPCインバウンドアダプタ共通）

gRPC通信ログの出力モード

ログファイル名

ラップアラウンドモードの場合

grpccmn_<HCSCサーバ名>_<面数>.log

シフトモードの場合

grpccmn_<HCSCサーバ名>_.log

gRPC通信ログのローテーションは，次のどちらかの条件に合致した際に実行されます。

指定したローテーション時刻に達したとき

ローテーション時刻の指定方法は，Application Serverの設定に従います。詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.3　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」を参照してください。

指定したファイルサイズに達したとき

gRPC通信ログの採取有無，出力レベル，ファイルサイズ，およびファイル面数は，HCSCサーバランタイム定義ファイルの次に示すプロパティで変更できます。

grpc-transporttrace-enabled=gRPC通信ログの採取有無

grpc-transporttrace-level=gRPC通信ログの出力レベル

grpc-transporttrace-filenum=gRPC通信ログの最大面数

grpc-transporttrace-filesize=gRPC通信ログの1面当たりの最大サイズ

HCSCサーバランタイム定義ファイルについては，マニュアル「サービスプラットフォーム リファレンス」の「6.5.6　HCSCサーバランタイム定義ファイル」を参照してください。

7.7.24　ユーザ電文に誤りがある場合の障害対策

(1)　ユーザ電文に誤りがある場合のエラー

標準受付からサービスアダプタのサービス部品を直接呼び出す場合，サービス部品側で要求するユーザ電文（XML文書）をサービスリクエスタで作成する必要があります。そのため，サービスリクエスタで作成するXMLに誤りがあると，正しくサービス部品を呼び出せません。SOAP通信でのSOAPメッセージとユーザ電文の関係を次の図に示します。

図7‒183　SOAP通信でのSOAPメッセージとユーザ電文の関係

ユーザ電文に誤りがある（フォーマット定義の形式と異なる電文を実行した）場合，サービスアダプタのプロトコルの違いによって，エラーの内容が異なります。

また，電文の形式によっては，サービスアダプタでエラーとならないでサービス部品で例外になったり，サービス部品でエラーにならないで想定していない応答が返ったりすることがあります。

(a)　Webサービス（SOAP通信）実行時にユーザ電文不正でエラーになる場合

SOAPアダプタから呼び出せるサービス部品の仕様は，マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」の「2.6.1　Webサービスを利用したサービス部品の適用範囲」で示す適用範囲を満たしている必要があります。適用範囲以外のサービス部品の場合，動作の保障ができません。

(b)　SessionBean実行時にユーザ電文不正でエラーになる場合

SessionBeanアダプタから呼び出せるサービス部品の仕様は，マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」の「2.6.2　SessionBeanを利用したサービス部品の適用範囲」で示す適用範囲を満たしている必要があります。適用範囲以外のサービス部品の場合，動作の保障ができません。

(c)　MDB（WS-R/DBキュー）実行時にユーザ電文不正でエラーになる場合

サービスリクエスタから要求したユーザ電文に誤りがある場合，MDB（WS-R/DBキュー）のサービスアダプタではエラーになりません。開発環境で定義するときにスキーマを定義しますが，通常，このスキーマで定義した形式でないユーザ電文でも，非同期キューに送信されます。サービス部品側でユーザ電文を受け取って検証するよう作成している場合は，サービス部品側でエラーを検知します。

(2)　サービスアダプタでの電文の検証方法

サービスアダプタに指定したフォーマット定義（XMLスキーマ）とユーザ電文（XML文書）が，XMLスキーマの仕様に従い，妥当かどうか検証できます。

サービスアダプタでの電文の検証機能を使用するには，HCSCサーバランタイム定義ファイルのtelegram-validationプロパティで設定します。HCSCサーバランタイム定義ファイルの詳細については，マニュアル「サービスプラットフォームリファレンス」の「6.5.6　HCSCサーバランタイム定義ファイル」を参照してください。

注意事項

定義したフォーマット定義に対して妥当でない電文であるにもかかわらず，サービス部品呼び出しに成功していた電文の場合，電文の検証機能を使用することで，この機能によって妥当な形式でないと判断されると，サービスアダプタでエラーとなります。

電文の検証機能は，HCSCサーバ全体の次の表に示すサービスアダプタで有効となります。サービスアダプタごとには設定できません。また，サービス部品を呼び出す要求電文，または応答電文に対して有効となります。

表7‒263　電文の検証機能が有効になるサービスアダプタ

アダプタ種別

方向

データ変換定義のパターン

検証するフォーマット定義

電文種類

検証機能の有効

SOAPアダプタ，

SessionBeanアダプタ，

MDB（WS-R）アダプタ，

MDB（DBキュー）アダプタ

要求

データ変換なし

サービス部品電文

XML

○

バイナリ

×※1

標準−サービス部品でデータ変換

標準電文

XML

○

バイナリ

×※1

サービス部品電文

XML

○

バイナリ

×※1

応答

データ変換なし

サービス部品電文

XML

○

バイナリ

×※1

サービス部品−標準でデータ変換

標準電文

XML

○

バイナリ

×※1

サービス部品電文

XML

○

バイナリ

×※1

フォルト

データ変換なし

×

XML

×

DBアダプタ

要求

データ変換なし

サービス部品電文

XML

×※2

標準−サービス部品でデータ変換

標準電文

XML

×

バイナリ

×

サービス部品電文

XML

×※2

応答

データ変換なし

サービス部品電文

XML

×※2

サービス部品−標準でデータ変換

標準電文

XML

×

バイナリ

×

サービス部品電文

XML

×※2

TP1アダプタ

要求

データ変換なし

サービス部品電文

バイナリ

×※1

標準−サービス部品でデータ変換

標準電文

XML

○

バイナリ

×※1

サービス部品電文

バイナリ

×※1

応答

データ変換なし

サービス部品電文

バイナリ

×※1

サービス部品−標準でデータ変換

標準電文

XML

○

バイナリ

×※1

サービス部品電文

バイナリ

×※1

ファイルアダプタ

要求

データ変換なし

サービス部品電文

XML

○

バイナリ

×※1

標準−サービス部品でデータ変換

標準電文

XML

○

バイナリ

×※1

サービス部品電文

XML

○

バイナリ

×※1

応答

データ変換なし

サービス部品電文

XML

○

バイナリ

×※1

サービス部品−標準でデータ変換

標準電文

XML

○

バイナリ

×※1

サービス部品電文

XML

○

バイナリ

×※1

Object Accessアダプタ

要求

データ変換なし

サービス部品電文

XML

○

標準−サービス部品でデータ変換

標準電文

XML

○

バイナリ

×※1

サービス部品電文

XML

○

応答

データ変換なし

サービス部品電文

XML

○

サービス部品−標準でデータ変換

標準電文

XML

○

バイナリ

×※1

サービス部品電文

XML

○

（凡例）

○：検証機能が有効になります。

×：検証機能が無効になります。

要求：サービスアダプタからサービス部品へ向かうことを示します。

応答：サービス部品からサービスアダプタへ向かうことを示します。

フォルト：エラー時にサービス部品からサービスアダプタへ向かうことを示します。

注※1

バイナリ電文のサービス部品呼び出し時は，設定したフォーマット定義を基にDOMに変換（パース処理）しています。そのため，バイナリ電文でフォーマット定義に対して妥当でない電文を送付した場合，例外が発生し，次のメッセージが表示されます。

KDEC05504-E An attempt to specify format definition settings has failed. (information1 = 保守情報, information2 = 保守情報)

フォーマット定義の設定に失敗しました。

注※2

DBアダプタは，telegram-validationプロパティ以外の機能で，電文形式を検証します。例えば，サービスアダプタで，要求時に，「リクエスタ（バイナリ）−標準（XML）−サービス部品（バイナリ）」の変換をした場合，要求電文に対して次の流れで変換と検証をします。

要求電文をリクエスタのフォーマット定義に対して検証します（バイナリ電文の機能がOFFの場合も同様です）。

手順1.で検証した結果が妥当であった場合，リクエスタの電文の形式から標準電文の形式に変換します。

変換後の電文を標準電文のフォーマット定義に対して検証します。

手順3.で検証した結果が妥当であった場合，標準電文の形式からサービス部品電文の形式に変換します。

変換後の電文をサービス部品電文のフォーマット定義に対して検証します（バイナリ電文の機能がOFFの場合も同様です）。

手順5.で検証した結果が妥当であった場合，サービス部品を呼び出します。

(3)　ユーザ電文トレースの取得による調査

ユーザ電文トレースを取得することによって，設計したとおりの電文が流れているか，リクエスタ側やサービス側，ビジネスプロセスのアクティビティやデータ変換などの各ポイントを調査できます。

ユーザ電文トレースを取得するには，HCSCサーバランタイム定義ファイルの次のプロパティで設定します。

telegramtraceプロパティ

telegramtrace-filepathプロパティ

telegramtrace-filesizeプロパティ

telegramtrace-filenumプロパティ

telegramtrace-triggerプロパティ

また，次のプロパティを設定し，正常処理時にユーザ電文トレースを出力するHCSCコンポーネントを指定して出力することで，リクエスタまたはサービスに送受信する電文を確認できます。

telegramtrace-component-type-filepathプロパティ

telegramtrace-component-id-filepathプロパティ

HCSCサーバランタイム定義ファイルの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.5.6　HCSCサーバランタイム定義ファイル」を参照してください。

ユーザ電文トレースの詳細については，「7.4.4　ユーザ電文トレース」または「7.4.6　デバッグ情報」を参照してください。

注意事項

ユーザ電文の内容をファイルに出力するため，セキュリティ上の問題（情報漏洩の懸念など）が発生します。したがって，出力したユーザ電文トレースファイルの取り扱いに注意してください。

01-60以前の「<サービスプラットフォームのインストールディレクトリ>¥CSC¥lib¥cscdba.ear」を使用して作成したDBアダプタでは，取得位置SVC，および取得位置CNVSTのユーザ電文トレースは取得できません。

7.7.25　システム全体の障害での障害調査

サービスリクエスタからのサービス部品呼び出し要求やコマンド要求に対し，応答が返ってこない場合などについて，調査手順を示します。

(1)　プロセスハングアップ

サービスリクエスタからのサービス部品呼び出し要求や，コマンド要求の応答が返ってこない場合，HCSCサーバ（J2EEサーバ）のプロセスがハングアップしているおそれがあります。プロセスハングアップ時の調査の流れについて説明します。

(a)　サービスリクエスタからのサービス部品呼び出し要求の場合

サービスリクエスタからのサービス部品呼び出し要求の場合の，プロセスハングアップ時の調査手順を次に示します。

サービス部品呼び出し要求の処理がどこまで完了していて，どこでハングアップしているかを調査します。サービス部品呼び出し処理の実行履歴の追跡は，プロトコルごとに異なります。

各プロトコルでの要求実行時の障害対策については，「7.7.1　Webサービス（SOAP通信）実行時の障害対策」，「7.7.2　SessionBean実行時の障害対策」，「7.7.3　MDB（WS-R）実行時の障害対策」，および「7.7.4　MDB（DBキュー）実行時の障害対策」を参照してください。

サービス部品呼び出し要求がどこまで処理されているか調査した結果を参考に，サービスリクエスタ稼働マシン，HCSCサーバ稼働マシン，サービス部品稼働マシン，およびデータベース稼働マシンについて，該当プロセスのCPU利用率をそれぞれ調査します。

CPU利用率が100%に近い状態の場合，無限ループや再起呼び出しに陥っているおそれがあります。

CPU利用率が0%に近い状態の場合，バックプロセスからの応答が返ってこないケースや，デッドロックなどのおそれがあります。

サービスプラットフォームの「J2EEサーバ，リダイレクタ，サーバ管理コマンドのログ」を確認して，不正なエラーが出ていないかどうかを調査します。

性能解析トレースを取得し，解析します。処理に時間が掛かっている個所を特定することで，ハングアップが起きている個所を特定できます。

スレッドダンプを複数回取得して，時系列で観察し，それぞれのスレッドダンプでtidの同じスレッドのスタックトレースを比較調査します。

(b)　コマンド要求の場合

コマンド要求の場合の，プロセスハングアップ時の調査手順を次に示します。

コマンド要求の場合，運用環境稼働マシン，HCSCサーバ稼働マシン，およびデータベース稼働マシンについて，該当プロセスのCPU利用率をそれぞれ調査します。

CPU利用率が100%に近い状態の場合，無限ループや再起呼び出しに陥っているおそれがあります。

CPU利用率が0%に近い状態の場合，バックプロセスからの応答が返ってこないケースや，デッドロックなどのおそれがあります。

サービスプラットフォームの「J2EEサーバ，リダイレクタ，サーバ管理コマンドのログ」，および「運用管理エージェント，運用監視エージェント，Management Serverのログ」を確認して，不正なエラーが出ていないかどうかを調査します。

スレッドダンプを複数回取得して，時系列で観察し，それぞれのスレッドダンプでtidの同じスレッドのスタックトレースを比較調査します。

(2)　プロセススローダウン

サービスリクエスタからのサービス部品呼び出し要求のスループットやレスポンスタイムがスローダウンしてきた場合，性能解析トレースで実行時間の長い個所を割り出します。

性能解析トレースを取得，解析し，処理に時間が掛かっている個所を特定することで，スローダウンが起きている個所を特定できます。

(3)　タイムアウト

サービスリクエスタからのサービス部品呼び出し要求や，コマンド要求の応答でタイムアウトが発生した場合の流れについて説明します。

(a)　サービスリクエスタからのサービス部品呼び出し要求の場合

サービスリクエスタからのサービス部品呼び出し要求の場合の，タイムアウト時の調査手順を次に示します。

タイムアウトが発生した場合，エラーメッセージが出力されるので，これを調査します。

タイムアウトのエラーメッセージのほかにエラーメッセージが出ていないかどうか，サービスプラットフォームのJ2EEサーバが出力する障害情報を確認して調査します。

サービス部品呼び出し要求処理がどこまで完了していて，どこでハングアップしているかを調査します。サービス部品呼び出し処理の実行履歴の追跡は，プロトコルごとに異なります。

各プロトコルでの要求実行時の障害対策については「7.7.1　Webサービス（SOAP通信）実行時の障害対策」，「7.7.2　SessionBean実行時の障害対策」，「7.7.3　MDB（WS-R）実行時の障害対策」，および「7.7.4　MDB（DBキュー）実行時の障害対策」を参照してください。

リクエストトレースまたは性能解析トレースを調査します。

サービス部品呼び出し要求がどこまで行われているか調査した結果を参考に，処理に時間が掛かっている個所を特定することで，タイムアウトが発生した原因を究明できます。

(b)　コマンド要求の場合

コマンド要求の場合の，タイムアウト時の調査手順を次に示します。

タイムアウトが発生した場合，エラーメッセージが出力されるので，これを調査します。

タイムアウトのエラーメッセージのほかにエラーメッセージが出ていないか調査します。

サービスプラットフォームの次に示すログを確認して，不正なエラーが出ていないか調査します。

J2EEサーバ，リダイレクタ，サーバ管理コマンドのログ

運用管理エージェント，運用監視エージェント，Management Serverのログ

7.7.26　ビジネスプロセス実行時の障害対策

ビジネスプロセス実行時には，次の図に示す障害が発生する場合があります。

図7‒184　ビジネスプロセス実行時の障害

また，ビジネスプロセス実行コマンド（csmexecutebpコマンド）の実行時にも障害が発生する場合があります。

これらの障害時の対処方法について説明します。

(1)　非同期の受付アクティビティでの失敗

サービスリクエスタから非同期の受付アクティビティに対して電文を送信したときにエラーが発生した場合，HCSCサーバでは電文を受け付けていない状態となります。この場合の対処手順を次に示します。

エラーの要因を取り除きます。

サービスリクエスタから，同一の電文を再送信します。

(2)　同期の受付アクティビティでの失敗

サービスリクエスタから同期の受付アクティビティに対して電文を送信したときに，エラーになった場合の対処手順を次に示します。

メッセージログに出力されているエラーメッセージを参照します。

エラーの原因を取り除きます（エラーの種類によっては必要です）。

サービスリクエスタから電文を再送信します。

(3)　同期の受付アクティビティへ送信した際のタイムアウト

サービスリクエスタから同期の受付アクティビティに対して電文を送信したときに，タイムアウトが発生した場合の対処方法を次に示します。

対処方法

サービスリクエスタから送信した電文が実行できているかどうか不明なため，メッセージログにエラーメッセージが出力されているかどうかを確認します。

エラーメッセージが出力されている場合

エラーメッセージが出力されている場合は，エラーメッセージに対応した対処を実施します。

エラーメッセージが出力されていない場合

該当電文の相関セットから，プロセスインスタンスの状態をcscpiselectコマンドで確認します。

プロセスインスタンスの状態が実行中のままの場合は，次のどちらかを実施します。

・プロセスインスタンスをcscpireexecコマンドで再実行します。

・プロセスインスタンスの実行履歴をcscpideleteコマンドで削除して，サービスリクエスタから同一電文を再送信します。

プロセスインスタンスの状態を取得できない場合は，該当電文の受信が失敗しているため，サービスリクエスタから同一の電文を再送信します。

(4)　サービス呼び出し時のエラー（例外）

ビジネスプロセスのサービス呼出アクティビティでサービス呼び出しを実行した場合，次のようなエラーが発生すると，プロセスインスタンスの実行が停止します。

サービス呼出アクティビティから呼び出すサービスアダプタが未起動状態

サービス呼出アクティビティから呼び出すサービスアダプタが未配備状態

サービス呼出アクティビティから呼び出すサービスアダプタでのデータ変換処理の失敗

同期のサービス部品呼び出し処理でのエラー（サービス部品の宛先不正，サービス部品の停止によるHTTPエラー，通信タイムアウト，通信障害など）

ビジネスプロセスの互換性の使用有無がOFFの場合，非同期のサービス部品呼び出し処理でのエラー（キューの宛先不正，キューへの送信処理の失敗など）

DBアダプタを使用してDBアクセスを行う処理でのエラー（DBアクセスエラー，SQLエラー，DB Connectorの設定不正など）

SOAPのサービス部品呼び出し処理で，Webサービスから応答したフォルト電文が，HCSCサーバでフォルトとして扱うための条件を満たしていない

サービス部品から返されたフォルト電文がフォルトとして扱われる条件については，マニュアル「サービスプラットフォーム 解説」の「4.3.5　SOAP Fault動作定義ファイルによるフォルトのキャッチ」を参照してください。

なお，該当するサービス呼出アクティビティの状態は，ビジネスプロセスの互換性の使用有無（HCSCサーバセットアップ定義のbp-status-compatible）がOFFの場合は，エラー状態または実行中状態のままとなり，ONの場合は実行中状態のままとなります。

エラーが発生した場合の対処手順を次に示します。

障害情報に従って，サービスアダプタ，サービス部品などのエラー原因を取り除きます。

cscpireexecコマンドでプロセスインスタンスを再実行して，サービス部品を再呼び出しします。このとき，サービス部品に対して同一メッセージの2回目の呼び出しが行われるため，サービス部品側で重複チェックを実施して2回目の呼び出しを矛盾なく処理できる必要があります。

(5)　サービス呼び出し時のサービス部品からのフォルト

HCSCサーバがサービス部品に対して同期呼び出しを実行したときに，サービス部品がフォルト電文を応答した場合の対処方法を次に示します。

対処方法

フォルトコネクションを定義している場合

定義したフォルトコネクションに従って，処理が実行されます。

フォルトコネクションを定義していない場合

プロセスインスタンスがフォルト終了状態となり，プロセスインスタンスの実行が停止します。サービス部品がフォルトを応答しないような電文を再送信します。

注意事項

サービス呼び出し時のサービス部品から返されたSOAP Faultがフォルトの場合は，cscpireexecコマンドではプロセスインスタンスを再実行できません。これは，定義したフォルトコネクションに従ってビジネスプロセスの処理を実行したり，プロセスインスタンスの実行が停止したりするため，ビジネスプロセスの状態が中断した状態のままとはならないからです。

(6)　ビジネスプロセス実行コマンドの実行時のエラー

ビジネスプロセス実行コマンド（csmexecutebpコマンド）の実行時に発生した例外のログ出力と，障害情報について説明します。

(a)　例外ログ

ビジネスプロセス実行コマンドの実行時に発生した例外は，例外ログに出力されます。例外ログの出力形式，出力内容，出力情報の変更について説明します。

例外ログの出力形式と出力内容

例外ログの出力形式を次の図に示します。

図7‒185　例外ログの出力形式（ビジネスプロセス実行コマンド）

図中の項目ごとに，例外ログに出力される内容を次の表に示します。

表7‒264　例外ログに出力される内容（ビジネスプロセス実行コマンド）

項目

内容

番号

例外ログの出力通番が表示されます。

日付

例外ログの取得日付がyyyy/mm/ddの形式で出力されます。

yyyy：西暦年

mm：月

dd：日

時刻

例外ログの取得時刻がhh:mm:ss.SSSの形式で出力されます。

hh：時

mm：分

ss：秒

SSS：ミリ秒

ローカル時刻でミリ秒単位の時刻を示します。

製品ID

製品を特定するための識別子として，ビジネスプロセス実行コマンドを示す「csmexecutebp」が表示されます。

pid

プロセスを識別するためのIDが出力されます。

tid

スレッドを識別するためのIDが出力されます。

ID

空白

スタックトレース情報

スタックトレース情報が出力されます。

CRLF

レコード終端符号が出力されます。

例外ログの出力先

例外ログの出力先を次に示します。

<サービスプラットフォームのインストールディレクトリ>¥CSC¥log¥msg¥csmexecutebp

例外ログのログファイル名を次の表に示します。

表7‒265　例外ログのログファイル名（ビジネスプロセス実行コマンド）

ログファイルの出力モード

ログファイル名

ラップアラウンドモードの場合

csmexecutebp_exp_<面数>.log

シフトモードの場合

csmexecutebp_exp_.log

例外ログのローテーションは，次のどちらかの条件に合致した際に実行されます。

指定したローテーション時刻に達したとき

ローテーション時刻の指定方法は，Application Serverの設定に従います。詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.3　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」を参照してください。

指定したファイルサイズに達したとき

また，例外ログの出力先，ファイルサイズおよびファイル面数は，次に示すビジネスプロセス実行コマンド定義ファイルのプロパティで変更できます。これらのプロパティについては，マニュアル「サービスプラットフォームリファレンス」の「3.21.1　ビジネスプロセス実行コマンド定義ファイル」を参照してください。

exceptionlog-filepath=例外ログの出力先パス

exceptionlog-filesize=例外ログの1ファイル当たりの上限サイズ

exceptionlog-filenum=例外ログの最大面数

例外ログの初期化処理に関する注意事項

例外ログのロガー初期化に失敗した場合，メッセージログに警告メッセージKDEC11407-Wが出力されてコマンド処理を継続します。この場合，ビジネスプロセス実行コマンドの処理では例外ログは出力されません。

(b)　障害発生時の動作

ビジネスプロセス実行コマンドで発生する障害の原因と対処を説明します。

コマンドおよび定義ファイルに必須オプションが指定されていない場合

次のどちらかに該当する場合は，必須オプションが指定されていません。エラーメッセージKDEC11405-Eをコンソールに出力して，コマンドが異常終了します。

コマンドの-processnameオプションも，ビジネスプロセス実行コマンド定義ファイルのprocess-nameプロパティも指定されていない

コマンドの-operationオプションも，ビジネスプロセス実行コマンド定義ファイルのbp-operation-nameプロパティも指定されていない

コマンド引数に指定したオプション値が不正な場合

エラーメッセージKDEC11406-Eをコンソールに出力して，コマンドが異常終了します。主なエラー原因を次に示します。

-telegramオプションに指定したファイルが存在しない

-fオプションに指定したファイルが存在しない

-processnameオプションの指定値が空文字

-operationオプションの指定値が空文字

ビジネスプロセス実行コマンド定義ファイルに指定した値が不正である場合

エラーメッセージKDEC11408-Eをコンソールに出力して，コマンドが異常終了します。

標準の同期受付（Webサービス）の呼び出しに失敗した場合

エラーメッセージKDEC11409-Eをコンソールに出力して，コマンドが異常終了します。

標準の同期受付（Webサービス）に渡すパラメタの値が不正な場合

エラーメッセージKDEC11410-Eをコンソールに出力して，コマンドが異常終了します。

また，メッセージログには，エラー原因に応じて次に示すメッセージが出力されます。

パラメタの値が指定可能な文字数を超えている場合：KDEC00012-E

パラメタの値に使用できない文字が含まれている場合：KDEC00010-E

これらのメッセージに出力されるパラメタ名と，コマンドで指定したパラメタとの関連を次に示します。

メッセージ引数に出力されるパラメタ名

ビジネスプロセス実行コマンドのパラメタ

cscServiceName

ビジネスプロセス名

cscServiceOperationName

ビジネスプロセスのオペレーション名

cscCorrelationID

クライアント相関ID

例えば，メッセージログに出力されたメッセージがKDEC00012-Eで，メッセージ引数に出力されたパラメタ名が「cscServiceName」の場合，ビジネスプロセス実行コマンドに設定した「ビジネスプロセス名」の値が，指定可能な文字数を超えていることを示しています。

HCSCサーバ内で障害が発生した場合

エラーメッセージKDEC11410-Eをコンソールに出力して，コマンドが異常終了します。

7.7.27　データ変換実行時の障害対策

ここでは，データ変換実行中に発生する代表的な障害とその対処方法について説明します。代表的な障害とその対処方法を次の表に示します。

表7‒266　代表的な障害とその対処方法（データ変換実行時の障害調査）

操作

代表的な障害

考えられる要因

対策

参照先マニュアル

XML電文のデータ変換の実行

XML電文のデータ変換を実行した際に，KDEC40463-Eが出力され，データ変換に失敗する

XML電文の名前空間が間違っている（XMLのタグ名に付与されているプリフィックスと名前空間の宣言が間違っているなど）おそれがあります。

XML電文の名前空間を見直します。正しいXML電文に修正して，再度サービス呼び出しを実行します。

サービスプラットフォーム 開発ガイド 基本開発編

サービスプラットフォーム 開発ガイド 受付・アダプタ定義編

なお，バイナリデータ変換処理中にエラーが発生した場合には，要因を特定するためのデバッグ情報をユーザ電文トレースに出力できます。デバッグ情報の記述個所を次に示します。

デバッグ情報の出力先や出力内容については，「7.4.6　デバッグ情報」を参照してください。

デバッグ情報の取得方法については，「7.3.2(6)　デバッグ情報の取得方法」を参照してください。

7.8　障害の監視・通知（JP1連携機能）

JP1の機能を利用した，障害の監視・通知について記述します。

7.8.1　JP1連携機能を使用した障害の監視

(1)　JP1によるメッセージの監視

サービスプラットフォームでは，発生した障害のメッセージをJP1イベントとしてJP1に通知します。これによって，出力するエラーメッセージを収集し，JP1の統合コンソールで集中的に監視できます。

また，JP1側で特定のJP1イベント（エラーメッセージ）の受信を契機として，自動的にコマンドを実行して，障害の発生をシステム管理者へ通知する運用や，回復のためにコマンドを実行するなど，システム運用を自動化できます。

JP1の統合コンソールで監視するための設定については，「2.8　JP1連携機能を使用する場合の環境構築」を参照してください。メッセージマッピングファイル（JP1/IM連携用システムログメッセージマッピングファイル）については，マニュアル「アプリケーションサーバ リファレンス定義編(サーバ定義)」の「8.3　JP1/IM連携用システムログメッセージマッピングファイル」を参照してください。

(2)　JP1イベントの確認方法

JP1イベントの詳細情報は，JP1の統合コンソールから確認します。統合コンソールで詳細を表示したいJP1イベントをダブルクリックするか，右クリックから［イベント詳細表示］を選択すると，JP1イベントの詳細情報が表示されます。

統合コンソールとJP1イベントの詳細情報の表示例を次の図に示します。

図7‒186　統合コンソールとJP1イベントの詳細情報の表示例

統合コンソールの表示方法については，マニュアル「JP1/Integrated Management - Manager 構築ガイド」，またはマニュアル「JP1/Integrated Management - Manager 運用ガイド」を参照してください。

(3)　JP1での監視を推奨するプロセス

JP1での監視を推奨するプロセスを次の表に示します。

表7‒267　JP1での監視を推奨するプロセス

監視推奨プロセス

プロセス名

Windowsの場合

UNIXの場合

Management Server

mngsvr.exe

cjstartsv※

運用管理エージェント

adminagentsv.exe

adminagent

注※

コマンドライン名（ps -ef相当）で監視します。実行例を次に示します。

　/opt/Cosminexus/CC/server/bin/cjstartsv cosmi_m

「cosmi_m」はデフォルトのサーバ名です。「cosmi_m」以外のサーバ名に変更している場合は，監視するコマンドライン名も変更する必要があります。

また，データベースを使用している場合は，使用しているデータベースのプロセスもJP1の監視推奨プロセスとなります。それらのプロセス名については，各データベースのマニュアルを参照してください。

JP1によるプロセス監視については，マニュアル「サービスプラットフォーム 解説」の「7.1.2　JP1によるプロセス監視」を参照してください。

7.8.2　サービスプラットフォームから通知するJP1イベントの詳細情報

ここでは，JP1イベントの詳細情報のうち，サービスプラットフォーム特有の値について説明します。

(1)　イベントID

発行アプリケーションプログラムや事象の内容を表す値です。重大度によって，次の表に示す値が表示されます。

表7‒268　重大度とイベントID

重大度

イベントID

Error

0x00012093

Warning

0x00012094

Information

0x00012096

(2)　重大度

JP1イベントの緊急性を表します。緊急性の高い順に，次の値が表示されます。

Error：エラー

Warning：警告

Information：情報

(3)　オブジェクトID

「<論理サーバ名>：<J2EEアプリケーション名>」が表示されます。

論理サーバ名

サービスプラットフォーム構築時に設定したJ2EEサーバ名が表示されます。

J2EEアプリケーション名

メッセージ発行元のJ2EEアプリケーション名が特定できた場合，J2EEアプリケーション名が表示されます。

J2EEアプリケーション名から，サービスプラットフォームの障害発生個所が特定できます。J2EEアプリケーション名とサービスプラットフォームの障害発生個所を次の表に示します。

表7‒269　J2EEアプリケーション名とサービスプラットフォームの障害発生個所

J2EEアプリケーション名

障害発生個所

CSCMessaging

実行環境（運用制御）

CSCMsgAsyncServiceDelivery

実行環境（標準の非同期受付（MDB（WS-R）））

CSCMsgAsyncServiceDeliveryDBQ

実行環境（標準の非同期受付（MDB（DBキュー）））

CSCMsgSyncServiceDelivery

実行環境（標準の同期受付（SessionBean））

CSCMsgSyncServiceDeliveryWS

実行環境（標準の同期受付（Webサービス・SOAP1.1））または実行環境（標準の同期受付（Webサービス・SOAP1.2））

cscmsg_async

実行環境（ビジネスプロセスの非同期EJB）

サービスID

該当するビジネスプロセスまたはサービスアダプタ

(4)　メッセージID

JP1イベントとして発行されたサービスプラットフォームのメッセージIDが表示されます。該当するメッセージIDについては，「付録F　JP1イベント通知をするメッセージ」を参照してください。

7.8.3　監視するログファイルの設定

JP1/Baseのログファイルトラップを使用して監視できる，サービスプラットフォームのログファイルについて説明します。JP1/Baseのログファイルトラップでは，サービスプラットフォームのログファイルに出力される情報をJP1イベントに変換します。

JP1/Baseのログファイルトラップを使用して監視できる，アプリケーションサーバのログファイルについては，マニュアル「アプリケーションサーバ 機能解説 運用／監視／連携編」の「13.4.3　監視するログファイルの設定」の表「JP1/Baseで監視できるログファイルとファイルの内容」を参照してください。

JP1/Baseのログファイルトラップの設定については，マニュアル「JP1/Base 運用ガイド」を参照してください。

サービスプラットフォームが出力するログのうち，JP1イベントに変換できるログファイルと，そのファイルの内容を次の表に示します。

表7‒270　JP1/Baseで監視できるログファイルとファイルの内容

ログ出力先およびログファイル名※1

ファイル形式※2

改行コード

説明

備考

HCSC-Managerログ出力先（HCSC-Manager定義ファイルのcscmng.log.dirプロパティの定義値）>/message[n].log

HTRACE

全ファイル既出タイプ

CR＋LF

HCSC-Managerログ

−

<ejb.server.log.directory>/csc/inbound-adapter/ftp/FTP_Inbound_Resource_Adapter/message[n].log

WRAP2

新規出現タイプ

LF

FTPインバウンドアダプタのメッセージログ

FTPインバウンドアダプタを使用する場合だけ監視が必要です。

<ejb.server.log.directory>/csc/inbound-adapter/kafka/Kafka_Inbound_Resource_Adapter/message[n].log

WRAP2

新規出現タイプ

LF

Kafkaインバウンドアダプタのメッセージログ

Kafkaインバウンドアダプタを使用する場合だけ監視が必要です。

（凡例）−：なし

注※1

ログファイル名の[n]の部分には，面の番号（1から各ログの最大面数まで）が付きます。

注※2

読み込むログファイルのレコード形式です。

WRAP2：ラップラウンドファイル（ラップラウンドするとき，データを削除して再び先頭からデータを書き込むファイル）

HTRACE：マルチプロセス対応トレースファイル（複数のプロセスが一組のトレースファイルを共有し，メモリマップドファイルを使用した固定サイズのファイル）。ログファイルへの書き込み方法はWRAP1（ラップラウンドファイル：ラップラウンドして，再び先頭からデータを上書きするファイル）と同じです。

新規出現タイプ：ログファイルが通番に従い出現します。通番は[1]から始まり，順に[2]，[3]…とファイルが作成されます。なお，一度出現すれば，ファイル自体は削除されません。

全ファイル既出タイプ：定義したログファイル面数分のファイルがすべて作成されているタイプです。

7.9　HCSCサーバ障害発生後の回復方法

7.9.1　HCSCサーバのシステム運用ができなくなった場合の回復方法

HCSCサーバで障害が発生し，システムの運用ができない場合は，次のように対処してください。

(1)　復旧に必要な情報

HCSCサーバの復旧に必要な情報を次に示します。

運用環境のリポジトリ情報

障害発生時の運用環境のリポジトリ情報です。

HCSCサーバ構成定義ファイル

HCSCサーバのセットアップ時に，cscsvsetupコマンドの-propfileオプションで設定した情報です。

HCSCサーバセットアップ定義ファイル

HCSCサーバのセットアップ時に，前提となる情報です。

HCSCサーバランタイム定義ファイル

cscsvconfigコマンドの-propfileオプションで設定した情報です。

(2)　復旧手順

cscrepctlコマンドを実行して，リポジトリをエクスポートし，現在のリポジトリ情報をバックアップします。

cscrepctl -user <ログインユーザID> -pass <ログインパスワード> -export <ファイル名>

cscsvunsetupコマンドを実行して，障害が発生したHCSCサーバをアンセットアップします。

cscsvunsetup -user <ログインユーザID> -pass <ログインパスワード> -csc <アンセットアップするHCSCサーバ名>

cscsvunsetupコマンドを実行してエラーが発生する場合は，手順3.を実施してください。エラーが発生しない場合は，手順4.を実施してください。

障害の内容に応じてコマンドを実行します。

HCSCサーバのあるマシンとの間で通信障害が発生する場合

cscsvunsetupコマンドを実行して，障害が発生したHCSCサーバをアンセットアップします。

cscsvunsetup -user <ログインユーザID> -pass <ログインパスワード> -csc <アンセットアップするHCSCサーバ名> -ignore

リポジトリまたはシステム構成定義でバージョン不一致が発生する場合

リポジトリルート配下を手動で削除してください。

不要なリソースが残っているかどうかを確認し，不要なリソースが残っている場合は手動で削除します。

不要なリソースの確認については，「7.5.3　HCSCサーバのセットアップおよびアンセットアップ時の回復方法」を参照してください。

cscsvsetupコマンドを実行して，HCSCサーバをセットアップします。

cscsvsetupコマンドの-propfileオプションには，障害が発生したHCSCサーバで設定したHCSCサーバ構成定義ファイルを指定してください。

cscsvsetup -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -cluster <クラスタ名> -propfile <HCSCサーバ構成定義ファイル名>

cscrepctlコマンドを実行して，手順1でバックアップしたリポジトリ情報をインポートします。

cscrepctl -user <ログインユーザID> -pass <ログインパスワード> -import <ファイル名>

必要に応じてcsccompodeployコマンドを実行して，ビジネスプロセスやサービスアダプタを配備します。

ビジネスプロセスを配備する場合

csccompodeploy -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -name <ビジネスプロセスのサービスID>

サービスアダプタを配備する場合

csccompodeploy -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -name <サービスアダプタのサービスID>

7.9.2　クラスタ構成時の回復方法

クラスタ構成時に障害が発生した場合の対処方法について，ロードバランスクラスタ構成の場合とHAクラスタ構成の場合とに分けて説明します。

(1)　ロードバランスクラスタ構成での障害と復旧

ロードバランスクラスタを構成しているHCSCサーバの障害に備え，ロードバランスクラスタに余裕を持ったHCSCサーバの台数を準備することで，障害が発生してもロードバランスクラスタで稼働しているHCSCサーバの負荷を一定に保つことができます。

注意事項

標準の非同期受付（MDB（WS-R）／MDB（DBキュー））の受付キューは，HCSCサーバごとに用意します。したがって，ロードバランスクラスタ構成で障害が発生した場合，標準の非同期受付（MDB（WS-R）／MDB（DBキュー））の受付キューに滞留している電文は送信できません。

(a)　障害が発生したHCSCサーバの切り離し

ロードバランスクラスタを構成しているHCSCサーバで障害が発生した場合，障害が発生したHCSCサーバをロードバランスクラスタから切り離します。切り離したあと，HCSCサーバの障害を取り除いて，サービス部品の実行要求を受け付けられる状態にします。障害を取り除いたHCSCサーバをロードバランスクラスタ内で稼働させることで復旧します。

(b)　障害が発生したHCSCサーバの復旧

障害が発生したHCSCサーバの切り離しと復旧手順について次に示します。

障害が発生した場合，障害が発生したHCSCサーバにサービス部品の実行要求を送信しないよう，ロードバランサを設定します。

ロードバランサを設定することで，HCSCサーバへのサービス部品の実行要求を制御します。設定方法は，各ロードバランサの仕様によって異なります。

CTMを使用している場合，キューを閉塞します。

キューの閉塞方法については，マニュアル「アプリケーションサーバ 機能解説 拡張編」の「3.7.4　スケジュールキューの閉塞制御」を参照してください。

障害が発生したHCSCサーバから障害を取り除き，サービス部品の実行要求を受け付けられる状態にします。

CTMを使用している場合，キューの閉塞を解除します。

キューの閉塞を解除する方法については，マニュアル「アプリケーションサーバ 機能解説 運用／監視／連携編」の「5.4.2　システムごとに実行できるサービスの閉塞方法およびJ2EEアプリケーションの停止方法」を参照してください。

障害を取り除いたHCSCサーバにサービス部品の実行要求を送信するよう，ロードバランサを設定します。

設定方法は，各ロードバランサの仕様によって異なります。

(2)　HAクラスタ構成での障害と復旧

実行系に障害が発生した場合，クラスタソフトウェアによって，処理は待機系に切り替えられます。待機系への切り替え後，実行系の障害を取り除いて，実行系での運用を再開させます。

注意事項

実行系に障害が発生し，待機系に運用が切り替わった場合，実行系の障害を取り除いて，実行系での運用に戻す必要があります。待機系をそのまま実行系として利用し，障害が発生した系の障害を取り除いて待機系として利用することはできません。

(a)　系の切り替え

実行系に障害が発生し，クラスタソフトで待機系に処理が切り替わるときの動作を次の図に示します。

図7‒187　障害発生時の待機系への切り替え（HAクラスタ）

(b)　実行系の復旧

実行系に障害が発生し，待機系に運用が切り替わった場合，実行系の障害を取り除いて，実行系での運用に戻す必要があります。

実行系の障害を取り除いて，運用を実行系に戻す手順について次に示します。

実行系および待機系をサービスリクエスタ用のネットワークから切断するなどして，サービスリクエスタからの実行要求を受け付けない状態にします。

待機系の受付（標準受付およびユーザ定義受付）を停止します。

標準受付の停止方法については，「5.3.35　標準受付を停止する」を参照してください。

ユーザ定義受付の停止方法については，「5.3.36　ユーザ定義受付を停止する」を参照してください。

待機系のHCSCサーバを停止します。

HCSCサーバの停止方法については，「5.3.41　HCSCサーバを停止する」を参照してください。

実行系のHCSCサーバの障害を回復します。

障害情報の採取方法および障害の回復方法については，「7.　障害対策」を参照してください。

実行系のHCSCサーバを起動します。

HCSCサーバの起動方法については，「5.3.4　HCSCサーバを起動する」を参照してください。

実行系の受付（標準受付およびユーザ定義受付）を開始します。

標準受付の開始方法については，「5.3.10　標準受付を開始する」を参照してください。

ユーザ定義受付の開始方法については，「5.3.9　ユーザ定義受付を開始する」を参照してください。

実行系および待機系をサービスリクエスタ用のネットワークに接続するなどして，実行系でサービスリクエスタからの実行要求を受け付けられる状態にして運用を再開します。

7.9.3　運用環境のバックアップと復旧

運用環境に発生した障害を復旧する場合や，システムの規模の拡大に伴う運用マシンの移行などで環境を移行する場合に，環境の復旧に必要なファイルをバックアップできます。

(1)　運用環境のバックアップ

次に示すcscenvbackupコマンドを実行して，運用環境の復旧に必要な最新のファイルをバックアップします。

cscenvbackup -user <ログインユーザID> -pass <ログインパスワード> -backupdir  <バックアップファイル出力先ディレクトリ>

HCSC-Manager定義ファイルに，バックアップファイル出力先ディレクトリを指定している場合は，次に示すcscenvbackupコマンドを実行します。

cscenvbackup -user <ログインユーザID> -pass <ログインパスワード>

参考

運用環境バックアップファイルは，自動バックアップの場合にも取得できます。自動バックアップ時に取得される運用環境バックアップファイルは，次のディレクトリに格納されます。

HCSC-Manager定義ファイル（cscmng.properties）に指定した環境バックアップファイルの出力先

<サービスプラットフォームのインストールディレクトリ>¥CSC¥spool¥manager（HCSC-Manager定義ファイル（cscmng.properties）に出力先の指定がない場合）

取得した運用環境バックアップファイルは，次のコマンドを実行して，バックアップファイル内のリポジトリ情報を確認できます。

cscrepls -user <ログインユーザID> -pass <ログインパスワード> -envbackfile <運用環境バックアップファイル名>

(2)　運用環境の復旧

運用環境は，cscenvrestoreコマンドを使用して，運用環境バックアップファイルから復旧できます。

参考

cscenvrestoreコマンドによる復旧は，運用環境を実行環境と異なるマシンに構築している場合などに適しています。

注意事項

cscenvrestoreコマンドで復旧できるのは運用環境だけです。実行環境はこのコマンドでは復旧できません。実行環境を復旧するには，次に示す項の手順に従い，環境のリポジトリ情報やリソースを取り除いてから，実行環境を再構築してください。

7.5.3　HCSCサーバのセットアップおよびアンセットアップ時の回復方法

7.5.4　HCSCコンポーネントの配備および削除時の回復方法

(a)　ディスク障害から復旧する場合の手順

手順を次に示します。

Service Platformをインストールしたマシンを用意します。必要に応じてソフトウェアをインストールします。

取得済みの運用環境バックアップファイルを復旧するマシンが認識できるところに格納します。

cscreplsコマンドを実行して，運用環境バックアップファイルの復旧する環境を確認します。

cscrepls -user <ログインユーザID> -pass <ログインパスワード> -envbackfile <運用環境バックアップファイル名>

cscenvrestoreコマンドを実行して，運用環境バックアップファイルを使用し，環境を復旧します。

cscenvrestore -user <ログインユーザID> -pass <ログインパスワード> -restorefile <運用環境のバックアップファイル名>

(b)　運用マシンを移行する場合の手順

手順を次に示します。

必要に応じて，cscenvbackupコマンドで復旧前の運用環境のバックアップファイルを取得します。

cscenvrestoreコマンドで運用環境を復旧させた場合，復旧前の運用環境は破棄されます。環境バックアップファイルは，自動バックアップ時と復旧直前とで内容が異なる場合があります。

Service Platformをインストールしたマシンを用意します。

取得済みの運用環境バックアップファイルを，移行後のマシンが認識できるところに格納します。

cscreplsコマンドを実行して，運用環境バックアップファイルの復旧する環境を確認します。

cscrepls -user <ログインユーザID> -pass <ログインパスワード> -envbackfile <運用環境バックアップファイル名>

cscenvrestoreコマンドを実行して，運用環境バックアップファイルを使用し，環境を復旧します。

cscenvrestore -user <ログインユーザID> -pass <ログインパスワード> -restorefile <運用環境のバックアップファイル名>

注意事項

cscenvbackupコマンドまたはcscrepctlコマンド（-importオプション）を実行して取得した環境バックアップには，HCSC-Manager定義ファイル（cscmng.properties）が格納されています。しかし，cscenvrestoreコマンドで運用環境を復旧したときには，復旧先のHCSC-Manager定義ファイルを有効とし，環境バックアップに含まれるHCSC-Manager定義ファイルは，別名（cscmng_backup.properties）で復旧します。cscmng_backup.propertiesは，参考資料として活用してください。また，不要であれば，削除しても問題ありません。

(c)　復旧時の自動バックアップ

cscenvrestoreコマンドを使用して，運用環境バックアップファイルから復旧する場合，復旧前の環境を自動でバックアップします。誤った運用環境バックアップファイルから環境を復旧してしまった場合に，この復旧時の自動バックアップファイルを使用することで，復旧前の環境に戻すことができます。

復旧時のバックアップファイルは，cscenvrestore_1.zipのファイル名で次のディレクトリに出力されます。

<サービスプラットフォームのインストールディレクトリ>¥csc¥spool¥manager

なお，バックアップファイルの出力先ディレクトリは，HCSC-Manager定義ファイルのcscmng.envbackup.dirパラメタ，またはcscmng.envbackup.dir.envrestoreパラメタで変更できます。出力先ディレクトリに古いバックアップファイルが存在している場合は，復旧が成功したあとに，古いバックアップファイルが削除されます。

また，復旧時に自動バックアップをするかどうかは，HCSC-Manager定義ファイルのcscmng.envbackup.autogetパラメタ，またはcscmng.envbackup.autoget.offパラメタで設定できます。

HCSC-Manager定義ファイルの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.5.3　HCSC-Manager定義ファイル」を参照してください。

7.9.4　デッドロックが発生した場合の回復方法

HCSCサーバ上のプロセスでデッドロックが発生した場合，次の方法でHCSCサーバを回復します。

(1)　HCSCサーバへのサービス部品呼び出し要求が応答しなくなった場合

HCSCサーバへのサービス部品呼び出し要求が応答しなくなった場合の調査手順を次に示します。

cjlistthreadコマンドを使用してスレッド情報を確認します。

cjstopthreadコマンドを使用して，不正なスレッドを削除します。

スレッドを削除できない場合はcscsvstopコマンドの-forceオプションを指定してHCSCサーバを強制停止してください。

HCSC-Managerの運用環境画面からは操作できないため，注意してください。

HCSCサーバを強制停止して停止が完了したら，cscsvstartコマンドを使用してHCSCサーバを再起動します。

cjstopthreadコマンドの使い方の詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjstopthread（スレッドの削除）」を参照してください。

cjlistthreadコマンドの使い方の詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjlistthread（スレッド情報の表示）」を参照してください。

スレッドの状態など，実行状態の確認方法については，マニュアル「アプリケーションサーバ 機能解説 運用／監視／連携編」の「5.3.11　J2EEアプリケーションの実行状態の確認」を参照してください。

cscsvstopコマンドの使い方の詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscsvstop（HCSCサーバの停止）」を参照してください。

cscsvstartコマンドの使い方の詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscsvstart（HCSCサーバの起動）」を参照してください。

(2)　HCSCコンポーネントや標準受付を停止できなくなった場合

HCSCコンポーネントや標準受付を停止できなくなった場合の調査手順を次に示します。

スレッドを削除できない場合は，cscsvstopコマンドの-forceオプションを指定してHCSCサーバを強制停止します。

HCSC-Managerの運用環境画面からは操作できないため注意してください。

HCSCサーバを強制停止して停止が完了したら，cscsvstartコマンドを使用してHCSCサーバを再起動します。

cscstatusコマンドを使用して，HCSCコンポーネントや標準受付の状態を確認します。

停止失敗状態（stopfailed）になっている場合は，HCSCコンポーネントの場合はcsccompostopコマンドを入力してHCSCコンポーネントの停止を試みてください。標準受付の場合は，cscrcptnstopコマンドに-stopfg forceを指定して強制停止を試みてください。

状態が停止状態（inactive）になれば，それぞれの起動コマンドを入力することで復旧します。

各コマンドの使い方の詳細については，マニュアル「サービスプラットフォーム リファレンス」の「5.　コマンド（運用環境・実行環境）」の該当するコマンドを参照してください。

7.10　メッセージトラッキングを利用した障害解析

サービスプラットフォームでは障害の発生に備えて，障害対策に必要な情報をログやトレースに取得しています。ここではログやトレースのうち，性能解析トレースファイルを利用して障害を解析する，メッセージトラッキングについて説明します。メッセージトラッキングは，障害が発生した個所を特定し，障害の切り分けや障害の調査を補助する障害解析ツールです。

なお，性能解析トレースファイルの詳細については，「7.4.3　性能解析トレース」を参照してください。

7.10.1　メッセージトラッキング機能の適用例

メッセージトラッキングは，障害発生時の性能解析トレースファイルがあれば，Service Architect，Service Platformがインストールされているマシンならどこでも利用できます。そのため，障害発生時の性能解析トレースファイルがあれば，障害が発生したHCSCサーバ稼働マシンだけでなく，障害が発生したHCSCサーバとは別のリモート環境でも障害を解析できます。

メッセージトラッキングの適用例を次に示します。

(1)　サービス部品への接続で障害が発生した場合

サービス部品への接続で障害が発生した場合，性能解析トレースファイルを解析して，障害個所の特定および障害原因の切り分けをします。サービス部品への接続で障害が発生した場合の障害解析の流れを次の図に示します。

図7‒188　サービス部品への接続で障害が発生した場合の障害解析の流れ

障害が発生したHCSCサーバ稼働マシンにアクセスし，性能解析トレースファイルを取得します。

J2EEサーバ稼働ログの障害情報を確認し，ログに出力されているエラーメッセージから次の情報を取得します。

障害発生時刻

ルートアプリケーション情報

メッセージ共通ID

「RootApInfo = 」に続いて出力されている文字列がルートアプリケーション情報です。ルートアプリケーション情報は，「IPアドレス/プロセスID/通信番号」の形式で出力されます。

J2EEサーバ稼働ログの出力例を次に示します。

メッセージトラッキングを起動します。

障害発生時刻で読み込む性能解析トレースファイルを絞り込んで，メッセージトラッキングを起動します。メッセージトラッキングの起動については，「7.10.2　メッセージトラッキングの起動」を参照してください。

ルートアプリケーション情報に一致する性能解析トレースを表示して障害を解析します。

ルートアプリケーション情報に一致する性能解析トレースの表示については，「7.10.3　性能解析トレースの表示」を参照してください。

(2)　システム全体の障害を調査する場合

プロセスのハングアップ，スローダウン，タイムアウトなどによってリクエストに遅延が発生した場合，性能解析トレースファイルのルートアプリケーション情報から，遅延しているリクエストの情報を確認します。遅延しているリクエストの情報から，障害個所を特定し，システム全体の障害を調査します。システム全体の障害を調査する場合の障害解析の流れを次の図に示します。

図7‒189　システム全体の障害を調査する場合の障害解析の流れ

障害が発生したHCSCサーバ稼働マシンにアクセスし，性能解析トレースファイルを取得します。

メッセージトラッキングを起動します。

メッセージトラッキングの起動については，「7.10.2　メッセージトラッキングの起動」を参照してください。

性能解析トレースファイルのルートアプリケーション情報一覧を表示して，遅延しているリクエストの情報を確認します。

性能解析トレースファイルのルートアプリケーション情報一覧の表示については，「7.10.4　ルートアプリケーション情報の一覧表示」を参照してください。

3.で確認したルートアプリケーション情報に一致する性能解析トレースを表示し，遅延個所を特定します。

(3)　送信したリクエストの状況を確認する場合

送信したリクエストが返ってこない場合や，リクエストがどこまで進んだのかを確認したい場合，リクエスト送信時刻で解析対象の性能解析トレースを絞り込んで，送信したリクエストの状況を確認します。

送信したリクエストの状況を確認する場合の障害解析の流れを次の図に示します。

図7‒190　送信したリクエストを確認する場合の障害解析の流れ

障害が発生したHCSCサーバ稼働マシンにアクセスし，性能解析トレースファイルを取得します。

メッセージトラッキングを起動します。

メッセージトラッキングの起動については，「7.10.2　メッセージトラッキングの起動」を参照してください。

リクエスト送信時刻で解析対象の性能解析トレースを絞り込みます。

解析対象の性能解析トレースの絞り込みについては，「7.10.5　性能解析トレースの絞り込み」を参照してください。

絞り込んだ性能解析トレースを解析して，送信したリクエストの状況を確認します。

7.10.2　メッセージトラッキングの起動

メッセージトラッキングの前提条件と起動方法について説明します。

(1)　前提条件

メッセージトラッキングを使用するには，事前に性能解析トレースファイルを取得しておいてください。性能解析トレースファイルの取得方法については，マニュアル「アプリケーションサーバ機能解説 保守／移行編」の「7.　性能解析トレースを使用した性能解析」を参照してください。

(2)　起動方法

メッセージトラッキングは，cscmsgtkコマンドで起動します。

cscmsgtkコマンドを実行すると，性能解析トレースファイルが読み込まれ，メッセージトラッキングが起動されます。メッセージトラッキングが起動されると，メッセージトラッキング専用の対話型のプロンプト（以降，メッセージトラッキングプロンプトと呼びます）が表示されます。メッセージトラッキングプロンプトでコマンドを実行し，障害を解析します。

cscmsgtkコマンドおよびメッセージトラッキングプロンプトで実行するコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscmsgtk（メッセージトラッキング機能の起動）」を参照してください。

なお，メッセージトラッキングの起動時に読み込んだ性能解析トレースファイルのサイズやマシン性能によっては，起動に数分掛かることがあります。

メッセージトラッキングの起動には，通常起動と範囲指定起動があり，それぞれの起動で読み込む性能解析トレースファイルの範囲が異なります。通常起動と範囲指定起動を次に説明します。

(a)　通常起動

通常起動は，すべての性能解析トレースを読み込みます。

通常起動で起動する場合のcscmsgtkコマンドの実行形式を次に示します。

cscmsgtk -prf <性能解析トレースファイル名>

なお，通常起動は一度にすべての性能解析トレースを読み込むため，ファイルサイズに注意してください。一度に読み込めるファイルサイズの目安は約140メガバイトです。「KEOS52044-E A memory shortage occurred.」が発生した場合は，範囲指定起動で起動し，読み込むファイルサイズを調整してください。

(b)　範囲指定起動

範囲指定起動は，範囲を指定して読み込む性能解析トレースを絞り込みます。

範囲指定起動で起動する場合のcscmsgtkコマンドの実行形式を次に示します。

cscmsgtk -prf <性能解析トレースファイル名> -date <読み込み開始日時>,<読み込み終了日時>

範囲指定起動で起動した場合，読み込んだ範囲が次のように出力されます。

<読み込み開始日時> - <読み込み終了日時>
cscmsgtk>

なお，読み込み開始日時，および読み込み終了日時は，yyyy/MM/dd hh:mm:ss.SSSの形式（yyyy：西暦年，MM：月，dd：日，hh：時，mm：分，ss：秒，SSS：ミリ秒）で表示されます。

7.10.3　性能解析トレースの表示

J2EEサーバの稼働ログ，ルートアプリケーション情報の一覧表示などで取得したルートアプリケーション情報から，ルートアプリケーション情報に一致する性能解析トレースを表示します。ルートアプリケーション情報の一覧表示については，「7.10.4　ルートアプリケーション情報の一覧表示」を参照してください。

(1)　ルートアプリケーション情報に一致する性能解析トレースの表示

メッセージトラッキングプロンプトに，ルートアプリケーション情報を入力します。入力すると，メッセージトラッキングの起動時に読み込んだ性能解析トレースの中から，入力したルートアプリケーション情報に一致する性能解析トレースの情報が時系列に出力されます。出力された性能解析トレースの情報から，応答に時間が掛かっている個所やリターンコードがエラーになっているトレースを確認できます。

(a)　入力形式

メッセージトラッキングプロンプトでprfコマンドを実行します。prfコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscmsgtk（メッセージトラッキング機能の起動）」にある障害解析コマンドを参照してください。

prfコマンドの実行形式を次に示します。

prf <ルートアプリケーション情報のIPアドレス>/<ルートアプリケーション情報のプロセスID>/<ルートアプリケーション情報の通信番号>

(b)　出力形式

出力形式を次に示します。

1

2

3

4

5

yyyy/MM/dd hh:mm:ss.SSS

No. interval(msec) event rc thread(hashcode) interface operation

通番 +前回出力時からの経過時間 イベントID リターンコード スレッドID インターフェース名 オペレーション情報

　　　　　　機能レイヤ: トレース取得ポイント(対応するイベントID)

遅延レベル

3〜5行目は性能解析トレースの数分出力されます。

なお，出力モードを詳細出力モードにした場合，サービスプラットフォーム以外で取得した性能解析トレースも出力されます。出力モードについては，マニュアル「サービスプラットフォームリファレンス」の「cscmsgtk（メッセージトラッキング機能の起動）」にある出力モード切り替えコマンドを参照してください。

1行目：出力開始日時

性能解析トレースの出力を開始した日時が「yyyy/MM/dd hh:mm:ss.SSS」の形式で出力されます。

yyyy：西暦年

MM：月

dd：日

hh：時

mm：分

ss：秒

SSS：ミリ秒

2行目：カラム

性能解析トレースに対応するカラムが出力されます。出力形式と同じ内容が出力されます。

3行目：性能解析トレースの内容

カラムに対応する性能解析トレースの内容が出力されます。

表示項目

対応するカラム

説明

通番

No.

通番を示します。

前回出力時からの経過時間

interval(msec)

性能解析トレースの1つ前の出力時からの経過時間（ミリ秒）を示します。半角数字6桁（約16分）まで出力されます。それ以上の時間が経過した場合は，「999999」が出力されます。

イベントID

event

トレース取得ポイントを示すイベントIDを示します。

リターンコード

rc

リターンコード（16進数）を示します。次のどちらかが出力されます。

0：正常

0以外：異常

スレッドID

thread(hashcode)

トレース情報を取得したプロセス内スレッドのスレッドID，およびスレッドのハッシュ値を示します。

スレッドID

「0x」を付加した小文字の16進数です。

ハッシュ値

「0x」を付加した小文字の16進数です。10桁未満の場合は，10桁に桁合わせをします。10桁以上の場合は，すべての値が出力されます。

なお，16進数の変換で失敗した場合は，「????????(????????)」が出力されます。

また，CTMおよびリダイレクタで取得したトレース情報の場合は，スレッドのハッシュ値が出力されないことがあります。その場合は，スレッドIDだけが出力されます。

インターフェース名

interface

取得ポイントごとのインターフェース名を示します。

オペレーション情報

operation

取得ポイントに関連するオペレーション情報を示します。

4行目：性能解析トレースのポイント名

性能解析トレースのポイント名が出力されます。なお，サービスプラットフォームのトレースポイント以外で取得した性能解析トレースの場合は，「−」が出力されます。

表示項目

説明

機能レイヤ

性能解析トレースを出力する機能の層を示します。次のどれかが出力されます。

HCSC（MSG）：メッセージング基盤

HCSC（BP）：ビジネスプロセス基盤

HCSC（DT）：データ変換基盤

HCSC（FTR）：FTP受付

HCSC（HTR）：HTTP受付

HCSC（MQR）：Message Queue受付

HCSC（FER）：ファイルイベント受付

HCSC（KAR）：Kafka受付

HCSC（SDR）：スケジュール駆動受付

HCSC（GRR）：gRPC受付

HCSC（DBA）：DBアダプタ

HCSC（FFA）：ファイルアダプタ

HCSC（OAA）：Object Accessアダプタ

HCSC（MQA）：Message Queueアダプタ

HCSC（FTP）：FTPアダプタ

HCSC（FTI）：FTPインバウンドアダプタ

HCSC（FOA）：ファイル操作アダプタ

HCSC（MA）：メールアダプタ

HCSC（HTA）：HTTPアダプタ

HCSC（CMDA）：コマンドアダプタ

HCSC（SFTP）：SFTPアダプタ

HCSC（KAA）：Kafkaアダプタ

HCSC（KAI）：Kafkaインバウンドアダプタ

HCSC（GRA）：gRPCアダプタ

HCSC（GRI）：gRPCインバウンドアダプタ

トレース取得ポイント

各機能レイヤで性能解析トレースを出力するポイントを示します。

対応するイベントID

取得ポイントに対応するイベントIDを示します。起点（入口）で取得されたトレースの場合は「-<対応するイベントID>」が，終点（出口）で取得されたトレースの場合は「<対応するイベントID>-」が出力されます。存在しない場合は出力されません。

5行目：遅延レベル

トレース間の遅延レベルが出力されます。

表示項目

説明

行なし

経過ミリ秒が1秒未満の遅延レベルを示します。

@@ (1sec-10sec)

経過ミリ秒が1秒以上の遅延レベルを示します。

@@ @@ (10sec-100sec)

経過ミリ秒が10秒以上の遅延レベルを示します。

@@ @@ @@ (100sec more...)

経過ミリ秒が100秒以上の遅延レベルを示します。

(c)　出力例

出力例を次に示します。

出力例の場合，トレース通番117とトレース通番121の間で遅延が発生し，トレース通番121でリターンコードがエラーになっています。

(2)　性能解析トレースの詳細情報表示

「7.10.3(1)　ルートアプリケーション情報に一致する性能解析トレースの表示」で表示したリターンコードや遅延レベルから，詳細情報を確認したい性能解析トレースを特定し，その性能解析トレースの通番を取得します。ルートアプリケーション情報に続けて，取得した通番を入力すると，その性能解析トレースの詳細情報が出力されます。メッセージ共通ID，リクエストID，サービス部品名などが出力され，障害解析の有益な情報を得られます。

(a)　入力形式

メッセージトラッキングプロンプトでprfコマンドを実行します。性能解析トレースの詳細情報を表示するには，ルートアプリケーション情報に続けて通番を指定します。prfコマンドの詳細については，マニュアル「サービスプラットフォームリファレンス」の「cscmsgtk（メッセージトラッキング機能の起動）」にある障害解析コマンドを参照してください。

prfコマンドの実行形式を次に示します。

prf <ルートアプリケーション情報のIPアドレス>/<ルートアプリケーション情報のプロセスID>/<ルートアプリケーション情報の通信番号> 通番

(b)　出力形式

性能解析トレースのASCIIカラムに出力されている内容が出力されます。ASCIIカラムに設定されていない場合は，何も出力されません。

(c)　出力例

出力例を次に示します。

トレース通番117の詳細情報を出力した場合

トレース通番121の詳細情報を出力した場合

7.10.4　ルートアプリケーション情報の一覧表示

読み込んだ性能解析トレースファイルのルートアプリケーション情報一覧を性能解析トレースの出力開始順に表示します。表示件数，表示する内容および順番を指定できます。

(1)　入力形式

メッセージトラッキングプロンプトでlsコマンドを実行します。lsコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscmsgtk（メッセージトラッキング機能の起動）」にある一覧表示コマンドを参照してください。

表示件数を指定する場合

指定した件数のルートアプリケーション情報が表示されます。出力順はオプション指定によって異なりますが，新しい情報から指定した件数分を表示します。

実行形式を次に示します。

ls <表示する件数>

エラーが発生したルートアプリケーション情報を表示する場合

-eオプションを指定して実行します。エラーが発生したルートアプリケーション情報だけが表示されます。

実行形式を次に示します。

ls -e

エラーの発生している個所がサービスプラットフォームのトレースポイント以外の場合，「7.10.3　性能解析トレースの表示」の方法でトレースを表示しても，エラー個所のトレースは表示されません。そのため，サービスプラットフォーム以外で発生したエラーを確認したい場合は，出力モードを詳細出力モードにして，すべての性能解析トレースを出力してください。出力モードについては，マニュアル「サービスプラットフォームリファレンス」の「cscmsgtk（メッセージトラッキング機能の起動）」にある出力モード切り替えコマンドを参照してください。

経過時間の昇順にルートアプリケーション情報を表示する場合

-tオプションを指定して実行します。ルートアプリケーション情報が示す一連の性能解析トレースで，最初に出力されたトレースから最後に出力されたトレースまでの経過時間の昇順にルートアプリケーション情報が表示されます。

実行形式を次に示します。

ls -t

(2)　出力形式

出力形式を次に示します。

1

2

startDate startTime RootAPInfo processingTime(msec)

先頭トレース出力日 先頭トレース出力時間 ルートアプリケーション情報 経過時間

2行目はルートアプリケーション情報分出力されます。

1行目：カラム

性能解析トレースに対応するカラムが出力されます。出力形式と同じ内容が出力されます。

2行目：ルートアプリケーション情報の内容

カラムに対応するルートアプリケーション情報の内容が出力されます。

表示項目

対応するカラム

説明

先頭トレース出力日

startDate

最初に性能解析トレースが出力された日を示します。

先頭トレース出力時間

startTime

最初に性能解析トレースが出力された時間を示します。

ルートアプリケーション情報

RootAPInfo

ルートアプリケーション情報を示します。

経過時間

processingTime(msec)

ルートアプリケーション情報が示す一連の性能解析トレースで，最初に出力されたトレースから最後に出力されたトレースまでの経過時間（ミリ秒）を示します。

(3)　出力例

出力例を次に示します。

表示件数を指定する場合

cscmsgtk>ls 3
startDate startTime RootAPInfo processingTime(msec)
2008/06/09 10:02:20.000 10.209.10.85/5624/0x0000000000000585 547
2008/06/09 10:08:13.000 10.209.10.85/5624/0x0000000000000586 28156
2008/06/09 10:27:33.000 10.209.10.85/5624/0x000000000000058f 21687

表示件数に「3」を指定すると，性能解析トレース出力開始日時の新しい方から3件が，出力開始日時の昇順に表示されます。

エラーが発生したルートアプリケーション情報を表示する場合

cscmsgtk>ls -e
startDate startTime RootAPInfo processingTime(msec)
2008/06/09 15:00:27.000 10.209.10.85/5624/0x000000000000052b 20093
2008/06/09 15:11:48.000 10.209.10.85/5624/0x0000000000000559 2231
2008/06/09 15:25:11.000 10.209.10.85/5624/0x000000000000058f 8140
                      ：

経過時間が長いルートアプリケーション情報を表示する場合

cscmsgtk>ls -t
startDate startTime RootAPInfo processingTime(msec)
2008/06/09 10:01:59.000 10.209.10.85/5624/0x000000000000037d 3766
2008/06/09 10:27:48.000 10.209.10.85/5624/0x000000000000058f 21687
2008/06/09 10:08:27.000 10.209.10.85/5624/0x0000000000000586 28156
                      ：

7.10.5　性能解析トレースの絞り込み

メッセージトラッキングプロンプトに日時を指定すると，指定した日時に実行していた処理のトレースだけに，解析対象となるトレースを絞り込むことができます。

性能解析トレースの絞り込みで解析対象となるトレースを次の図に示します。

図7‒191　性能解析トレースの絞り込みで解析対象となるトレース

注※

通常起動，範囲指定起動のどちらで起動した場合でも性能解析トレースを絞り込むことができます。メッセージトラッキングの起動については，「7.10.2　メッセージトラッキングの起動」を参照してください。

性能解析トレースを絞り込むには，メッセージトラッキングプロンプトでfocusコマンドを実行します。focusコマンドの詳細については，マニュアル「サービスプラットフォームリファレンス」の「cscmsgtk（メッセージトラッキング機能の起動）」にある解析対象絞り込みコマンドを参照してください。

注意事項

解析対象が存在しない日時を指定した場合は，警告メッセージが表示されます。その場合は，絞り込み日時を省略してfocusコマンドで実行し，解析対象を起動時の状態に戻してください。

7.10.6　性能解析トレースの取得ポイントの表示

性能解析トレースの取得ポイントを表示します。イベントIDを指定してトレース取得ポイントを表示する場合と，サービスプラットフォームのすべてのトレース取得ポイントを表示する場合があります。

(1)　入力形式

メッセージトラッキングプロンプトでidコマンドを実行します。idコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「cscmsgtk（メッセージトラッキング機能の起動）」にあるトレース取得ポイント表示コマンドを参照してください。

イベントIDを指定してトレース取得ポイントを表示する場合

指定したイベントIDのトレース取得ポイントが表示されます。

実行形式を次に示します。

id <イベントID>

サービスプラットフォーム以外のイベントID，または存在しないイベントIDを指定した場合はエラーになります。

サービスプラットフォームのすべてのトレース取得ポイントを表示する場合

サービスプラットフォームのすべてのトレース取得ポイントが表示されます。

実行形式を次に示します。

id list

(2)　出力形式

出力形式を次に示します。

イベントIDを指定してトレース取得ポイントを表示した場合

機能レイヤ：トレース取得ポイント(対応するイベントID)

サービスプラットフォームのすべてのトレース取得ポイントを表示した場合

イベントID=機能レイヤ：トレース取得ポイント(対応するイベントID)

トレース取得ポイントの数分出力されます。

表示項目を次に説明します。

表示項目

説明

イベントID

トレース取得ポイントを示すイベントIDを示します。

機能レイヤ

性能解析トレースを出力する機能の層を示します。次のどれかが出力されます。

HCSC（MSG）：メッセージング基盤

HCSC（BP）：ビジネスプロセス基盤

HCSC（DT）：データ変換基盤

HCSC（FTR）：FTP受付

HCSC（HTR）：HTTP受付

HCSC（MQR）：Message Queue受付

HCSC（FER）：ファイルイベント受付

HCSC（KAR）：Kafka受付

HCSC（SDR）：スケジュール駆動受付

HCSC（GRR）：gRPC受付

HCSC（DBA）：DBアダプタ

HCSC（FFA）：ファイルアダプタ

HCSC（OAA）：Object Accessアダプタ

HCSC（MQA）：Message Queueアダプタ

HCSC（FTP）：FTPアダプタ

HCSC（FTI）：FTPインバウンドアダプタ

HCSC（FOA）：ファイル操作アダプタ

HCSC（MA）：メールアダプタ

HCSC（HTA）：HTTPアダプタ

HCSC（CMDA）：コマンドアダプタ

HCSC（SFTP）：SFTPアダプタ

HCSC（KAA）:Kafkaアダプタ

HCSC（KAI）：Kafkaインバウンドアダプタ

HCSC（GRA）：gRPCアダプタ

HCSC（GRI）：gRPCインバウンドアダプタ

トレース取得ポイント

各機能レイヤで性能解析トレースを出力するポイントを示します。

対応するイベントID

取得ポイントに対応するイベントIDを示します。起点（入口）で取得されたトレースの場合は「-<対応するイベントID>」が，終点（出口）で取得されたトレースの場合は「<対応するイベントID>-」が出力されます。存在しない場合は出力されません。

(3)　出力例

出力例を次に示します。

イベントIDを指定してトレース取得ポイントを表示した場合

サービスプラットフォームのすべてのトレース取得ポイントを表示した場合

7.11　サービスアダプタでの例外発生時の運用

サービスアダプタからサービス部品（Webサービス）を呼び出したときに発生したエラーの例外を，そのままスローするか，サービスアダプタでフォルト電文に変換するか選択できます。

例外をそのままスローする場合とフォルト電文に変換する場合の処理の違いについては，マニュアル「サービスプラットフォーム 解説」の「4.8　例外発生時にサービスアダプタが取得するエラーの選択」を参照してください。

7.11.1　例外をフォルト電文へ変換する場合の設定

エラーの例外をフォルト電文へ変換するかしないかは，サービスアダプタ定義画面でアダプタを定義するときに設定します。サービスアダプタの定義方法については，マニュアル「サービスプラットフォーム開発ガイド 受付・アダプタ定義編」の「3.　サービスアダプタの定義」を，サービスアダプタ定義画面の詳細は，マニュアル「サービスプラットフォーム リファレンス」の「1.2.2　サービスアダプタ定義画面」を参照してください。

7.11.2　フォルト電文を定義するスキーマファイル

エラーの例外をフォルト電文に変換する設定にした場合に，フォルト電文を定義するスキーマファイルについて説明します。

(1)　ファイルの格納先

フォルト電文を定義するスキーマファイルの格納先を次に示します。

<サービスプラットフォームのインストールディレクトリ>¥CSC¥system¥msg¥cscfault.xsd

(2)　形式

<?xml version="1.0" encoding="UTF-8"?>
<!--
DO NOT EDIT THIS FILE.
-->
<xs:schema elementFormDefault="qualified" targetNamespace="http://www.msg.csc.soft.Hitachi.co.jp/cscfault" xmlns:cscft="http://www.msg.csc.soft.Hitachi.co.jp/cscfault" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:element name="fault">
    <xs:complexType>
      <xs:sequence>
        <xs:element name="exception-name" type="xs:string" />
        <xs:element name="exception-message" type="xs:string" />
        <xs:element name="stacktrace" type="xs:string" minOccurs="0" />
        <xs:element name="details" type="xs:string" minOccurs="0" />
        <xs:element name="other" type="xs:anyType" minOccurs="0" />
      </xs:sequence>
    </xs:complexType>
  </xs:element>
</xs:schema>

(3)　注意事項

スキーマファイルを編集しないでください。ファイルを編集した場合，フォルト電文に変換する設定が有効になりません。

7.12　汎用フォルトを利用した障害解析

汎用フォルトを利用して，ビジネスプロセス上の障害発生個所や障害原因を特定できます。

汎用フォルト電文の送出条件については，マニュアル「サービスプラットフォーム 解説」の「4.7　システム例外をフォルトに変換する汎用フォルト」を参照してください。

7.12.1　汎用フォルト電文を定義するスキーマファイル

汎用フォルト電文のスキーマファイルについて説明します。主に次の内容を定義します。

例外情報

ビジネスプロセス上のどのアクティビティでフォルトが発生したかを特定するための情報

ルートアプリケーション情報

メッセージログ内に出力されるメッセージKDEC20087-Wには，ルートアプリケーション情報が出力されるため，それを基に障害発生個所を特定できます。

(1)　ファイルの格納先

汎用フォルト電文を定義するスキーマファイルの格納先を次に示します。

<サービスプラットフォームのインストールディレクトリ>CSC¥schema¥fault¥generic_fault.xsd

(2)　形式

<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema elementFormDefault="qualified" targetNamespace="http://www.msg.csc.soft.Hitachi.co.jp/cscGenericFault" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <xsd:element name="fault">
    <xsd:complexType>
      <xsd:sequence>
        <xsd:element name="exception-name"       type="xsd:string"/>
        <xsd:element name="exception-message"    type="xsd:string"/>
        <xsd:element name="scope-name"           type="xsd:string"/>
        <xsd:element name="activity-name"        type="xsd:string"/>
        <xsd:element name="activity-type"        type="xsd:string"/>
        <xsd:element name="process-instance-id"  type="xsd:string"/>
        <xsd:element name="root-ap-info"         type="xsd:string"/>
        <xsd:element name="extensions" minOccurs="0">
          <xsd:complexType>
            <xsd:sequence>
              <xsd:element name="extension" maxOccurs="unbounded">
                <xsd:complexType>
                  <xsd:simpleContent>
                    <xsd:extension base="xsd:string">
                      <xsd:attribute name="name" type="xsd:string" use="optional"/>
                    </xsd:extension>
                  </xsd:simpleContent>
                </xsd:complexType>
              </xsd:element>
            </xsd:sequence>
          </xsd:complexType>
        </xsd:element>
      </xsd:sequence>
    </xsd:complexType>
  </xsd:element>
</xsd:schema>

汎用フォルト電文の設定内容を次に示します。

タグ

説明

exception-name

例外名を設定します。Exception.getClass().getName()の値を設定します。

exception-message

例外情報を設定します。Exception.toString()によって返された文字列をセミコロンでつないで設定します。

scope-name

汎用フォルトが発生したアクティビティが所属するスコープ名を設定します。

リンクの場合は，フォルト例外を検知したリンクが所属するスコープ名を設定します。

activity-name

汎用フォルトが発生したアクティビティ名を設定します。

リンクの場合は，フォルト例外を検知したリンク名を設定します。

activity-type

汎用フォルトが発生したアクティビティの型名を設定します。

Java呼出アクティビティ：java

データ変換アクティビティ：convert

代入アクティビティ：assign

フォルト送出アクティビティ：throw

検証アクティビティ：validate

ログ出力アクティビティ：log

繰り返しアクティビティ：while

分岐アクティビティ：switch

リンクコネクション：link

process-instance-id

プロセスインスタンス識別子を設定します。

root-ap-info

ルートアプリケーション情報を設定します。

extensions※

各アクティビティに特化した情報を出力するための拡張用領域です。

注※

extensionsタグのextension要素のフォーマットを次に示します。

<extensions>
  <extension name="（拡張属性名）">（拡張情報の内容）</extension>
</extensions>

extension要素内の可変項目には次の内容を設定します。

アクティビティの種類

（拡張属性名）

（拡張情報の内容）

代入アクティビティ

assign-number

システム例外が発生した時点のコピー元・コピー先の番号（11-10以降の環境で，汎用フォルト電文の拡張領域の出力内容として出力）

検証アクティビティ

variable-name

検証エラーまたはシステム例外が発生した変数の変数名

ログ出力アクティビティ

variable-name

システム例外が発生した変数の変数名（XPathで参照する変数が不正または未初期化の場合には出力されない）

繰り返しアクティビティ

repetition-number

システム例外が発生した時点の繰り返し回数

分岐アクティビティ

priority-number

システム例外が発生した時点の分岐条件の番号（11-10以降の環境で，汎用フォルト電文の拡張領域の出力内容として出力）

7.12.2　ユーザ電文トレースを出力するための設定

汎用フォルト電文をユーザ電文トレースに出力するためには，HCSCサーバランタイム定義ファイルの設定値を次の下線部のように変更する必要があります。

指定例

telegramtrace=ON
telegramtrace-trigger=SYSERR, FAULT
telegramtrace-filesize=<ユーザ電文トレースファイルサイズ（単位：バイト）>
telegramtrace-filenum=<ユーザ電文トレース面数>
telegramtrace-filepath=<ユーザ電文トレース出力先パス>

設定の詳細については，マニュアル「サービスプラットフォーム リファレンス」の「6.5.6　HCSCサーバランタイム定義ファイル」を参照してください。

7.13　OutOfMemoryError発生時の運用

この節では，OutOfMemoryErrorの発生を抑止する方法や，OutOfMemoryError発生時の影響などについて説明します。

7.13.1　業務への影響を抑止する機能

JavaVMのヒープサイズの上限を超えるなどの原因でメモリ不足が発生すると，「java.lang.OutOfMemoryError」のメッセージが表示されることがあります。OutOfMemoryErrorが発生しても業務への影響を少なくするには，次に示す機能を設定してください。

OutOfMemory発生時強制終了機能

OutOfMemoryErrorが発生した場合に，J2EEサーバを強制終了するための機能です。この機能を設定すると，J2EEサーバを強制終了してすぐ自動再起動し，正常に稼働できる状態にするため，OutOfMemoryErrorが発生した業務以外の業務への影響を抑えられます。

OutOfMemoryハンドリング機能

OutOfMemory発生時強制終了機能を使用している場合でも，J2EEサーバの実行を継続するための機能です。この機能を設定すると，メモリ不足が発生した業務だけが中止されるため，OutOfMemoryErrorが発生した業務以外の業務は継続されます。

注意事項

OutOfMemoryハンドリング機能を設定している場合でも，次に示すコンポーネントを利用した業務の実行中にOutOfMemoryErrorが発生すると，J2EEサーバがシステムダウンしてすべてのプロセスが中断されます。メモリ不足が発生した業務だけを中止することはできないため，注意が必要です。

標準受付（MDB（WS-R））

標準受付（MDB（DBキュー））

MDB（WS-R）アダプタ

MDB（DBキュー）アダプタ

非同期のビジネスプロセス

7.13.2　UOC実行時の注意事項

UOCの実行時に確保されたリソースは，処理終了後も解放されません。そのため，システム全体の負荷が高くなると，Javaヒープ不足などによってOutOfMemoryErrorが発生する場合があります。

次に示す機能はUOCを利用するため，実行するとOutOfMemoryErrorが発生するおそれがあります。OutOfMemoryErrorの発生に備えて，UOCの作成時にはリソースを適切に解放する処理や，ロールバックなどのエラー処理を実装しておく必要があります。

Java呼出アクティビティ

ユーザ定義ファンクション

文字コード変換UOC

コンポーネント共通UOC

カスタム受付

汎用カスタムアダプタ

付録

付録A　Service Coordinator管理者の変更方法（UNIXの場合）

UNIXの場合に，cjenvsetup（Component Container管理者のセットアップ）コマンドを使用してComponent Container管理者を変更したときは，Service Coordinator管理者を変更する必要があります。

Service Coordinator管理者の変更は，次の操作をしたあとに実施してください。

Component Container管理者の変更（cjenvsetupコマンド）

Service Coordinatorのインストール

実行環境のバージョンアップ（cscenvupdateコマンド）

HCSCサーバのセットアップ（cscsvsetupコマンド）

Service Coordinator管理者の変更方法と注意事項について次に説明します。なお，ここでは，管理者のオーナーをuser1，グループをgroup1として説明します。

付録A.1　変更方法

(1)　/opt/Cosminexus/CSCディレクトリ配下のファイル属性の変更

/opt/Cosminexus/CSCディレクトリ配下のファイル属性を，管理者のオーナー，グループに変更します。

（例）

chown -R user1 /opt/Cosminexus/CSC

chgrp -R group1 /opt/Cosminexus/CSC

(2)　リポジトリルート配下のファイル属性の変更

/opt/Cosminexus/CSC/config/manager/cscmng.propertiesを参照し，次のように変更します。

リポジトリルート（cscmng.repository.root）に/opt/Cosminexus/CSC/repository以外のディレクトリを設定している場合

リポジトリルート配下のファイル属性を，管理者のオーナー，グループに変更します。

（例）リポジトリルートが/home/user1/repisotiryのとき

chown -R user1 /home/user1/repisotiry

chgrp -R group1 /home/user1/repisotiry

(3)　ログディレクトリ配下のファイル属性の変更

/opt/Cosminexus/CSC/config/manager/cscmng.propertiesを参照し，次のように変更します。

ログディレクトリ（cscmng.log.dir）に/opt/Cosminexus/CSC/log/manager以外のディレクトリを設定している場合

ログディレクトリ配下のファイル属性を，管理者のオーナー，グループに変更します。

（例）ログディレクトリが/home/user1/logのとき

chown -R user1 /home/user1/log

chgrp -R group1 /home/user1/log

(4)　応答電文出力ディレクトリ配下のファイル属性の変更

/opt/Cosminexus/CSC/config/manager/cscmng.propertiesを参照し，次のように変更します。

応答電文出力ディレクトリ（cscmng.pireexec.response.dir）に値を設定している場合

応答電文出力ディレクトリ配下のファイル属性を，管理者のオーナー，グループに変更します。

（例）応答電文出力ディレクトリに/home/user1/responseを設定しているとき

chown -R user1 /home/user1/response

chgrp -R group1 /home/user1/response

(5)　システム管理情報ディレクトリ配下のファイル属性の変更

cscutilコマンドでHCSCサーバのセットアップ情報を参照し，次のように変更します。

hcscserver-data-filepathプロパティを指定している場合

システム管理情報ディレクトリ配下のファイル属性を，管理者のオーナー，グループに変更します。

（例）システム管理情報ディレクトリに/home/user1/cscsysを設定しているとき

chown -R user1 /home/user1/cscsys

chgrp -R group1 /home/user1/cscsys

(6)　SQLスクリプトファイルのファイル属性の変更

cscutilコマンドでHCSCサーバのセットアップ情報を参照し，次のように変更します。

sql-scriptfilenameプロパティを指定している場合

SQLスクリプトファイルのファイル属性を，管理者のオーナー，グループに変更します。

（例）SQLスクリプトファイルに/home/user1/sqlsetupを設定しているとき

chown user1 /home/user1/sqlsetup

chgrp group1 /home/user1/sqlsetup

(7)　SOAP Fault動作定義ファイルのファイル属性の変更

cscsvconfig -operation getコマンドでHCSCサーバのランタイム情報を参照し，次のように変更します。

soapfault-targetnamespace-filepathプロパティを指定している場合

SOAP Fault動作定義ファイルのファイル属性を，管理者のオーナー，グループに変更します。

（例）SOAP Fault動作定義ファイルに/home/user1/soapfaultnameを設定しているとき

chown user1 /home/user1/soapfaultname

chgrp group1 /home/user1/soapfaultname

(8)　ユーザ電文トレースのファイル属性の変更

cscsvconfig -operation getコマンドでHCSCサーバのランタイム情報を参照し，次のように変更します。

telegramtrace-filepathプロパティを指定している場合

ユーザ電文トレース出力先ディレクトリ配下のファイル属性を，管理者のオーナー，グループに変更します。

（例）ユーザ電文トレース出力先パスに/home/user1/telegramtracefileを設定しているとき

chown -R user1 /home/user1/telegramtracefile

chgrp -R group1 /home/user1/telegramtracefile

(9)　メソッドトレース出力先ディレクトリ配下のファイル属性の変更

cscsvconfig -operation getコマンドでHCSCサーバのランタイム情報を参照し，次のように変更します。

methodtrace-filepathプロパティを指定している場合

メソッドトレース出力先ディレクトリ配下のファイル属性を，管理者のオーナー，グループに変更します。

（例）メソッドトレース出力先パスに/home/user1/methodtracefileを設定しているとき

chown -R user1 /home/user1/methodtracefile

chgrp -R group1 /home/user1/methodtracefile

(10)　リクエストトレース出力先ディレクトリ配下のファイル属性の変更

cscsvconfig -operation getコマンドでHCSCサーバのランタイム情報を参照し，次のように変更します。

requesttrace-filepathプロパティを指定している場合

リクエストトレース出力先ディレクトリ配下のファイル属性を，管理者のオーナー，グループに変更します。

（例）リクエストトレース出力先パスに/home/user1/requesttracefileを設定しているとき

chown -R user1 /home/user1/requesttracefile

chgrp -R group1 /home/user1/requesttracefile

(11)　作業フォルダのルート配下のファイル属性の変更

cscsvconfig -operation getコマンドでHCSCサーバのランタイム情報を参照し，次のように変更します。

work-folderプロパティを指定している場合

作業フォルダのルート配下のファイル属性を，管理者のオーナー，グループに変更します。

（例）作業フォルダルートの絶対パスに/home/user1/workfolderを設定しているとき

chown -R user1 /home/user1/workfolder

chgrp -R group1 /home/user1/workfolder

(12)　共通フォルダ配下のファイル属性の変更

cscsvconfig -operation getコマンドでHCSCサーバのランタイム情報を参照し，次のように変更します。

common-folder-<共通フォルダ定義名>プロパティを指定している場合

共通フォルダ定義名で定義した共通フォルダ配下のファイル属性を，管理者のオーナー，グループに変更します。

（例）共通フォルダの絶対パスに/home/user1/commonfolderを設定しているとき

chown -R user1 /home/user1/commonfolder

chgrp -R group1 /home/user1/commonfolder

(13)　環境変数CSCMNG_HOMEに設定したディレクトリ配下のファイル属性の変更

1台のマシンに複数の環境を構築（環境変数CSCMNG_HOMEを設定）している場合，CSCMNG_HOMEに設定したディレクトリ配下のファイル属性を，管理者のオーナー，グループに変更します。

（例）環境変数CSCMNG_HOMEに/home/user1/cscmng1を設定しているとき

chown -R user1 /home/user1/cscmng1

chgrp -R group1 /home/user1/cscmng1

(14)　環境変数CSCFTP_CMD_LOGに設定したディレクトリ配下のファイル属性の変更

運用コマンド実行時のログの出力先を設定（環境変数CSCFTP_CMD_LOGを設定）している場合，CSCFTP_CMD_LOGに設定したディレクトリ配下のファイル属性を，管理者のオーナー，グループに変更します。

（例）環境変数CSCFTP_CMD_LOGに/home/user1/ftpcmdlog1を設定しているとき

chown -R user1 /home/user1/ftpcmdlog1

chgrp -R group1 /home/user1/ftpcmdlog1

(15)　HCSCランタイム定義のcommon-uoc-prop-pathに設定したディレクトリ配下のファイル属性の変更

コンポーネント共通UOCのプロパティファイル格納ディレクトリを設定（HCSCランタイム定義のcommon-uoc-prop-pathを設定）している場合，common-uoc-prop-pathに設定したディレクトリ配下のファイル属性を，管理者のオーナー，グループに変更します。

(16)　コンポーネント共通UOCで使用するクラスを含むjarファイルの属性の変更

コンポーネント共通UOCで読み込むクラスを含むjarファイルのファイル属性を，管理者のオーナー，グループに変更します。

付録A.2　注意事項

Service Coordinator管理者は，Component Container管理者と同一にしてください。

リポジトリルート（cscmng.repository.root），ログディレクトリ（cscmng.log.dir），応答電文出力ディレクトリ（cscmng.pireexec.response.dir）に指定したディレクトリ配下に，ファイルを生成しないでください。また，すでにファイルが存在しているディレクトリ（/opt，/usrなど）を設定しないでください。

管理者の変更は，Component Container，Manager，およびService Coordinator提供コマンドが起動している状態で実施しないでください。実施した場合の動作は保証しません。

異なる管理者でコマンドを実行した場合や不正な環境でコマンドを実行した場合，次のメッセージが出力されることがあります。

Because the user <コマンド実行ユーザ名> and file owner of /opt/Cosminexus/CSC <ディレクトリオーナーユーザ名> is different, the command cannot be executed.

Cannot get owner name of /opt/Cosminexus/CSC

Cannot get user name(failed:/usr/bin/id -un)

Cannot get owner id(failed:/usr/bin/id <ディレクトリオーナーユーザ名> -u)

Cannot get user id(failed:/usr/bin/id -u)

付録B　画面とコマンドで実施できる内容（運用環境）

サービスプラットフォームでは，システム構築およびシステム運用時に，コマンドと画面で実施できる内容が異なります。運用環境のコマンドで実施できる機能に対し，画面で実施できるかを次の表に示します。

表B‒1　画面とコマンドで実施できる内容（運用環境）

分類

内容

画面

コマンド

コマンド名

機能分類

対象

管理系

ユーザ

ログイン情報の変更

×

○

cscpasswd

リポジトリ

リポジトリのインポート

×

○

cscrepctl

リポジトリのエクスポート

×

○

cscrepctl

リポジトリ情報の表示

×

○

cscrepls

リポジトリの差分情報の管理

×

○

cscrepdiff

サービス情報

情報の表示

×

○

cscsvcls

情報の管理

×

○

cscsvcctl

ユーザ定義受付またはサービスアダプタの定義情報の取得・設定・削除

×

○

csccmctl

環境情報

環境のバックアップ

×

○

cscenvbackup

環境のリストア

×

○

cscenvrestore

構築系

HCSCサーバ

HCSCサーバのセットアップ

×

○

cscsvsetup

HCSCサーバのアンセットアップ

×

○

cscsvunsetup

HCSCコンポーネント

HCSCコンポーネントの配備

×

○

csccompodeploy

HCSCコンポーネントの削除

×

○

csccompoundeploy

簡易セットアップ

本番環境の簡易セットアップ

×

○

cscsetup

運用系

HCSCサーバ

HCSCサーバの起動

○

○

cscsvstart

HCSCサーバの停止

○

○

cscsvstop

HCSCサーバのランタイム定義情報の設定・取得

○

○

cscsvconfig

HCSCサーバの稼働状態の確認

○

○

cscstatus

HCSCサーバのセットアップ情報の確認

×

○

cscutil

HCSCサーバのランタイム情報の確認

×

○

cscutil

HCSCサーバのリソースの稼働情報の表示

○

○

cscresinfo

標準受付，またはユーザ定義受付

標準受付またはユーザ定義受付の開始

○

○

cscrcptnstart

標準受付またはユーザ定義受付の停止

○

○

cscrcptnstop

標準受付またはユーザ定義受付の稼働状態の確認

○

○

cscstatus

HCSCコンポーネント

HCSCコンポーネントの開始

○

○

csccompostart

HCSCコンポーネントの停止

○

○

csccompostop

フォーマット定義およびデータ変換定義の事前キャッシュ

×

○

cscprecache

HCSCコンポーネントのランタイム情報の確認

○

○

csccompoconfig

HCSCコンポーネントの稼働状態の確認

○

○

cscstatus

プロセスインスタンス

プロセスインスタンスの実行履歴の検索

○

○

cscpiselect

プロセスインスタンスの実行履歴の相関セット情報の取得

○

○

cscpiselect

プロセスインスタンスの実行履歴の変数情報の取得

○

○

cscpiselect

プロセスインスタンスの実行履歴のアクティビティ情報の取得

○

○

cscpiselect

プロセスインスタンスの実行履歴の削除

○

○

cscpidelete

プロセスインスタンスの実行履歴の一括削除

○

○

cscpidelete

プロセスインスタンスの再実行

○

○

cscpireexec

プロセスインスタンスの一括再実行

○

○

cscpireexec

アプリケーション

アプリケーションの操作

×

○

cscapputil

ツール

HCSCサーバ

HCSCサーバのバージョンアップ

×

○

cscenvupdate

メッセージトラッキング

メッセージトラッキングの起動

×

○

cscmsgtk

リポジトリ

リポジトリのアップデート

×

○

cscrepupdate

（凡例）

○：実施できます。

×：実施できません。

付録C　データベースのテーブルの情報

付録C.1　プロセスインスタンスの実行履歴の管理に関するテーブルの情報

(1)　テーブルの情報

HCSCクラスタごとに，次に示すテーブルが必要です。

基本情報テーブル

変数情報テーブル

メッセージ履歴関連づけ情報テーブル

(a)　基本情報テーブル

ビジネスプロセスが実行する上で基本的な要素（インスタンス）の情報が格納されます。

●CSCBP_<クラスタ名>_PROCESSテーブル

CSCBP_<クラスタ名>_PROCESSテーブルの内容を次に示します。

項番

列名

説明

HiRDB型

ORACLE型

インデクスの有無

NULL値

更新

省略値

1

ProcessID

プロセスインスタンスの識別子

MVARCHAR(240)

VARCHAR2(240)

あり

不可

不可

不可

2

ProcessDefinitionName

BP定義名

MVARCHAR(64)

VARCHAR2(64)

あり

不可

不可

不可

3

ProcessDefinitionVersion

BP定義バージョン

SMALLINT

NUMBER(5)

なし

不可

不可

不可

4

State

プロセスインスタンスの状態

VARCHAR(20)

VARCHAR2(20)

あり

不可

可

不可

5

ChangeCount※1

データの更新回数

INTEGER※2

NUMBER(10) ※3

なし

不可

可

不可

6

StartTime

プロセスインスタンスの開始時刻（GMT）

TIMESTAMP(0)

TIMESTAMP(0)

あり

可

可

NULL

7

EndTime

プロセスインスタンスの終了時刻（GMT）

TIMESTAMP(0)

TIMESTAMP(0)

あり

可

可

NULL

8

CSCServerName

最後に実行したHCSCサーバ名

VARCHAR(8)

VARCHAR2(8)

あり

可

可

NULL

9

SplitKey※4

分割キー（GMT）

CHAR(2)

CHAR(2)

あり

不可

不可

不可

注※1

実行時に内部管理用に使用される項目のため，値を意識する必要はありません。

注※2

08-10以前のバージョンの場合，「SMALLINT」になります。

また，08-10以前のバージョンから更新インストールした場合，領域は変更されないため，「SMALLINT」になります。

注※3

08-10以前のバージョンの場合，「NUMBER(5)」になります。

また，08-10以前のバージョンから更新インストールした場合，領域は変更されないため，「NUMBER(5)」になります。

注※4

HCSCサーバセットアップ定義ファイルのdb-tbl-split-keyに「NONE」以外を指定してセットアップした場合，SQLスクリプトファイルに含まれる列です。db-tbl-split-keyについては，マニュアル「サービスプラットフォームリファレンス」の「6.4.3　HCSCサーバセットアップ定義ファイル」を参照してください。

●CSCBP_<クラスタ名>_ACTIVITYテーブル

CSCBP_<クラスタ名>_ACTIVITYテーブルの内容を次に示します。

項番

列名

説明

HiRDB型

ORACLE型

インデクス

NULL

更新

省略値

1

ProcessID

プロセスインスタンスの識別子

MVARCHAR(240)

VARCHAR2(240)

あり

不可

不可

不可

2

ActivityNumber

アクティビティインスタンスの識別番号。プロセスインスタンス内で一意。

INTEGER※2

NUMBER(10) ※3

あり

不可

不可

不可

3

ActivityDefinitionName

アクティビティ定義名

MVARCHAR(64)

VARCHAR2(64)

なし

不可

不可

不可

4

ActivityKind

アクティビティの種別

VARCHAR(16)

VARCHAR2(16)

なし

不可

不可

不可

5

ParentNumber※1

親アクティビティインスタンスの識別番号

INTEGER※2

NUMBER(10) ※3

なし

不可

不可

不可

6

ScopeNumber

所属するスコープインスタンスの識別番号

INTEGER※2

NUMBER(10) ※3

なし

不可

不可

不可

7

RepeatNumber※1

所属する繰り返し処理の識別番号

INTEGER※2

NUMBER(10) ※3

なし

不可

不可

不可

8

State

アクティビティインスタンスの状態

VARCHAR(20)

VARCHAR2(20)

なし

不可

可

不可

9

FirstChildNumber※1

子アクティビティインスタンスの最小の識別番号

INTEGER※2

NUMBER(10) ※3

なし

不可

可

不可

10

LastChildNumber※1

子アクティビティインスタンスの最大の識別番号

INTEGER※2

NUMBER(10) ※3

なし

不可

可

不可

11

StartTime

アクティビティの開始時刻（GMT）

TIMESTAMP(0)

TIMESTAMP(0)

なし

可

可

NULL

12

EndTime

アクティビティの終了時刻（GMT）

TIMESTAMP(0)

TIMESTAMP(0)

なし

可

可

NULL

13

WaitTime

アクティビティの待機解除時刻（GMT）

TIMESTAMP(0)

TIMESTAMP(0)

なし

可

可

NULL

14

SplitKey※4

分割キー（GMT）

CHAR(2)

CHAR(2)

あり

不可

不可

不可

注※1

実行時に内部管理用に使用される項目のため，値を意識する必要はありません。

注※2

08-10以前のバージョンの場合，「SMALLINT」になります。

また，08-10以前のバージョンから更新インストールした場合，領域は変更されないため，「SMALLINT」になります。

注※3

08-10以前のバージョンの場合，「NUMBER(5)」になります。

また，08-10以前のバージョンから更新インストールした場合，領域は変更されないため，「NUMBER(5)」になります。

注※4

HCSCサーバセットアップ定義ファイルのdb-tbl-split-keyに「NONE」以外を指定してセットアップした場合，SQLスクリプトファイルに含まれる列です。db-tbl-split-keyについては，マニュアル「サービスプラットフォームリファレンス」の「6.4.3　HCSCサーバセットアップ定義ファイル」を参照してください。

●CSCBP_<クラスタ名>_LINKテーブル

CSCBP_<クラスタ名>_LINKテーブルの内容を次に示します。

項番

列名

説明

HiRDB型

ORACLE型

インデクス

NULL

更新

省略値

1

ProcessID

プロセスインスタンスの識別子

MVARCHAR(240)

VARCHAR2(240)

あり

不可

不可

不可

2

LinkDefinitionName

リンク定義名

MVARCHAR(64)

VARCHAR2(64)

あり

不可

不可

不可

3

RepeatNumber※1

所属する繰り返し処理の識別番号

INTEGER※2

NUMBER(10) ※3

あり

不可

不可

不可

4

State

リンクの状態（真偽値）

CHAR(1)

CHAR(1)

なし

不可

不可

不可

5

SplitKey※4

分割キー（GMT）

CHAR(2)

CHAR(2)

あり

不可

不可

不可

注※1

実行時に内部管理用に使用される項目のため，値を意識する必要はありません。

注※2

08-10以前のバージョンの場合，「SMALLINT」になります。

また，08-10以前のバージョンから更新インストールした場合，領域は変更されないため，「SMALLINT」になります。

注※3

08-10以前のバージョンの場合，「NUMBER(5)」になります。

また，08-10以前のバージョンから更新インストールした場合，領域は変更されないため，「NUMBER(5)」になります。

注※4

HCSCサーバセットアップ定義ファイルのdb-tbl-split-keyに「NONE」以外を指定してセットアップした場合，SQLスクリプトファイルに含まれる列です。db-tbl-split-keyについては，マニュアル「サービスプラットフォームリファレンス」の「6.4.3　HCSCサーバセットアップ定義ファイル」を参照してください。

●CSCBP_<クラスタ名>_CORRELATIONSETテーブル

CSCBP_<クラスタ名>_CORRELATIONSETテーブルの内容を次に示します。

項番

列名

説明

HiRDB型

ORACLE型

インデクス

NULL

更新

省略値

1

ProcessID

プロセスインスタンスの識別子

MVARCHAR(240)

VARCHAR2(240)

あり

不可

不可

不可

2

ProcessDefinitionName

BP定義名

MVARCHAR(64)

VARCHAR2(64)

あり

不可

不可

不可

3

ProcessDefinitionVersion

BP定義バージョン

SMALLINT

NUMBER(5)

なし

不可

不可

不可

4

ScopeDefinitionName

スコープ定義名

MVARCHAR(64)

VARCHAR2(64)

あり

不可

不可

不可

5

ScopeNumber

スコープインスタンスの識別番号

INTEGER※1

NUMBER(10) ※2

あり

不可

不可

不可

6

CorrelationSetName

相関セット定義名

MVARCHAR(64)

VARCHAR2(64)

あり

不可

不可

不可

7

CorrelationSetValue

相関セット値。文字列化および連結されて格納されます。

MVARCHAR(512)

VARCHAR2(512)

あり

不可

不可

不可

8

State

相関セットの有効性（真偽値）

CHAR(1)

CHAR(1)

なし

不可

可

不可

9

SplitKey※3

分割キー（GMT）

CHAR(2)

CHAR(2)

あり

不可

不可

不可

注※1

08-10以前のバージョンの場合，「SMALLINT」になります。

また，08-10以前のバージョンから更新インストールした場合，領域は変更されないため，「SMALLINT」になります。

注※2

08-10以前のバージョンの場合，「NUMBER(5)」になります。

また，08-10以前のバージョンから更新インストールした場合，領域は変更されないため，「NUMBER(5)」になります。

注※3

HCSCサーバセットアップ定義ファイルのdb-tbl-split-keyに「NONE」以外を指定してセットアップした場合，SQLスクリプトファイルに含まれる列です。db-tbl-split-keyについては，マニュアル「サービスプラットフォームリファレンス」の「6.4.3　HCSCサーバセットアップ定義ファイル」を参照してください。

(b)　変数情報テーブル

ユーザが定義した変数について，ビジネスプロセスが実行していく過程での変数の値が格納されます。

●CSCBP_<クラスタ名>_STR_VARIABLEテーブル

CSCBP_<クラスタ名>_STR_VARIABLEテーブルの内容を次に示します。

項番

列名

説明

HiRDB型

ORACLE型

インデクス

NULL値

更新

省略値

1

ProcessID

プロセスインスタンスの識別子

MVARCHAR(240)

VARCHAR2(240)

あり

不可

不可

不可

2

ScopeNumber

スコープインスタンスの識別番号

INTEGER※1

NUMBER(10) ※2

あり

不可

不可

不可

3

VariableName

変数定義名

MVARCHAR(64)

VARCHAR2(64)

あり

不可

不可

不可

4

VariableValue

変数値

MVARCHAR(4000)

VARCHAR2(4000)

なし

可※3

可

不可

5

SplitKey※4

分割キー（GMT）

CHAR(2)

CHAR(2)

あり

不可

不可

不可

注※1

08-10以前のバージョンの場合，「SMALLINT」になります。

また，08-10以前のバージョンから更新インストールした場合，領域は変更されないため，「SMALLINT」になります。

注※2

08-10以前のバージョンの場合，「NUMBER(5)」になります。

また，08-10以前のバージョンから更新インストールした場合，領域は変更されないため，「NUMBER(5)」になります。

注※3

HiRDBの場合はNOT NULL制約を指定できますが，Oracleの場合はNOT NULL制約を指定できません。

注※4

HCSCサーバセットアップ定義ファイルのdb-tbl-split-keyに「NONE」以外を指定してセットアップした場合，SQLスクリプトファイルに含まれる列です。db-tbl-split-keyについては，マニュアル「サービスプラットフォームリファレンス」の「6.4.3　HCSCサーバセットアップ定義ファイル」を参照してください。

●CSCBP_<クラスタ名>_NUM_VARIABLEテーブル

CSCBP_<クラスタ名>_NUM_VARIABLEテーブルの内容を次に示します。

項番

列名

説明

HiRDB型

ORACLE型

インデクス

NULL

更新

省略値

1

ProcessID

プロセスインスタンスの識別子

MVARCHAR(240)

VARCHAR2(240)

あり

不可

不可

不可

2

ScopeNumber

スコープインスタンスの識別番号

INTEGER※1

NUMBER(10) ※2

あり

不可

不可

不可

3

VariableName

変数定義名

MVARCHAR(64)

VARCHAR2(64)

あり

不可

不可

不可

4

VariableValue

変数値

DOUBLE PRECISION

NUMBER

なし

不可

可

不可

5

SplitKey※3

分割キー（GMT）

CHAR(2)

CHAR(2)

あり

不可

不可

不可

注※1

08-10以前のバージョンの場合，「SMALLINT」になります。

また，08-10以前のバージョンから更新インストールした場合，領域は変更されないため，「SMALLINT」になります。

注※2

08-10以前のバージョンの場合，「NUMBER(5)」になります。

また，08-10以前のバージョンから更新インストールした場合，領域は変更されないため，「NUMBER(5)」になります。

注※3

HCSCサーバセットアップ定義ファイルのdb-tbl-split-keyに「NONE」以外を指定してセットアップした場合，SQLスクリプトファイルに含まれる列です。db-tbl-split-keyについては，マニュアル「サービスプラットフォームリファレンス」の「6.4.3　HCSCサーバセットアップ定義ファイル」を参照してください。

●CSCBP_<クラスタ名>_BOOL_VARIABLEテーブル

CSCBP_<クラスタ名>_BOOL_VARIABLEテーブルの内容を次に示します。

項番

列名

説明

HiRDB型

ORACLE型

インデクス

NULL

更新

省略値

1

ProcessID

プロセスインスタンスの識別子

MVARCHAR(240)

VARCHAR2(240)

あり

不可

不可

不可

2

ScopeNumber

スコープインスタンスの識別番号

INTEGER※1

NUMBER(10) ※2

あり

不可

不可

不可

3

VariableName

変数定義名

MVARCHAR(64)

VARCHAR2(64)

あり

不可

不可

不可

4

VariableValue

変数値

CHAR(1)

CHAR(1)

なし

不可

可

不可

5

SplitKey※3

分割キー（GMT）

CHAR(2)

CHAR(2)

あり

不可

不可

不可

注※1

08-10以前のバージョンの場合，「SMALLINT」になります。

また，08-10以前のバージョンから更新インストールした場合，領域は変更されないため，「SMALLINT」になります。

注※2

08-10以前のバージョンの場合，「NUMBER(5)」になります。

また，08-10以前のバージョンから更新インストールした場合，領域は変更されないため，「NUMBER(5)」になります。

注※3

HCSCサーバセットアップ定義ファイルのdb-tbl-split-keyに「NONE」以外を指定してセットアップした場合，SQLスクリプトファイルに含まれる列です。db-tbl-split-keyについては，マニュアル「サービスプラットフォームリファレンス」の「6.4.3　HCSCサーバセットアップ定義ファイル」を参照してください。

●CSCBP_<クラスタ名>_MSG_VARIABLEテーブル

CSCBP_<クラスタ名>_MSG_VARIABLEテーブルの内容を次に示します。

項番

列名

説明

HiRDB型

ORACLE型

インデクス

NULL

更新

省略値

1

ProcessID

プロセスインスタンスの識別子

MVARCHAR(240)

VARCHAR2(240)

あり

不可

不可

不可

2

ScopeNumber

スコープインスタンスの識別番号

INTEGER※1

NUMBER(10) ※2

あり

不可

不可

不可

3

VariableName

変数定義名

MVARCHAR(64)

VARCHAR2(64)

あり

不可

不可

不可

4

VariableValue

変数値

BINARY(2147483639)

BLOB

なし

可※3

可

不可

5

SplitKey※4

分割キー（GMT）

CHAR(2)

CHAR(2)

あり

不可

不可

不可

注※1

08-10以前のバージョンの場合，「SMALLINT」になります。

また，08-10以前のバージョンから更新インストールした場合，領域は変更されないため，「SMALLINT」になります。

注※2

08-10以前のバージョンの場合，「NUMBER(5)」になります。

また，08-10以前のバージョンから更新インストールした場合，領域は変更されないため，「NUMBER(5)」になります。

注※3

HiRDBの場合はNOT NULL制約を指定できますが，Oracleの場合はNOT NULL制約を指定できません。

注※4

HCSCサーバセットアップ定義ファイルのdb-tbl-split-keyに「NONE」以外を指定してセットアップした場合，SQLスクリプトファイルに含まれる列です。db-tbl-split-keyについては，マニュアル「サービスプラットフォームリファレンス」の「6.4.3　HCSCサーバセットアップ定義ファイル」を参照してください。

(c)　メッセージ履歴関連づけ情報テーブル

メッセージ履歴との関連づけデータが格納されます。

●CSCBP_<クラスタ名>_MSG_RELATIONテーブル

CSCBP_<クラスタ名>_MSG_RELATIONテーブルの内容を次に示します。

項番

列名

説明

HiRDB型

ORACLE型

インデクス

NULL

更新

省略値

1

MessageID※1

メッセージ共通ID

VARCHAR(75)

VARCHAR2(75)

あり

不可

不可

不可

2

ProcessID※1

プロセスインスタンスの識別子

MVARCHAR(240)

VARCHAR2(240)

あり

不可

不可

不可

3

ActivityNumber※1

アクティビティインスタンスの識別番号

INTEGER※2

NUMBER(10) ※3

あり

不可

不可

不可

4

SendOrReceive※1

メッセージの送受信フラグ

CHAR(1)

CHAR(1)

あり

不可

不可

不可

5

AsynchronousMessagingID※1

Reliable Messagingを使用した非同期メッセージでのID

VARCHAR(255)

VARCHAR2(255)

あり

可

不可

NULL

6

SplitKey※4

分割キー（GMT）

CHAR(2)

CHAR(2)

あり

不可

不可

不可

注※1

実行時に内部管理用に使用される項目のため，値を意識する必要はありません。

注※2

08-10以前のバージョンの場合，「SMALLINT」になります。

また，08-10以前のバージョンから更新インストールした場合，領域は変更されないため，「SMALLINT」になります。

注※3

08-10以前のバージョンの場合，「NUMBER(5)」になります。

また，08-10以前のバージョンから更新インストールした場合，領域は変更されないため，「NUMBER(5)」になります。

注※4

HCSCサーバセットアップ定義ファイルのdb-tbl-split-keyに「NONE」以外を指定してセットアップした場合，SQLスクリプトファイルに含まれる列です。db-tbl-split-keyについては，マニュアル「サービスプラットフォームリファレンス」の「6.4.3　HCSCサーバセットアップ定義ファイル」を参照してください。

(2)　ステータスの情報

テーブルに格納する値の意味と実際の値（文字列）を説明します。

(a)　HCSCクラスタ名

英数字8文字以内を指定します。

(b)　プロセスインスタンスの識別子

プロセスインスタンスを一意に識別する識別子です。

(c)　プロセスインスタンスの状態

項番

名称

説明

データベース上の値

1

未実行

プロセスインスタンスが未実行で，今後実行される可能性のある状態を示します。

Unexecution

2

実行中

プロセスインスタンスが実行中の状態を示します。

Executing

3

エラー発生

サービス呼出アクティビティまたはスコープアクティビティで例外が発生し，プロセスインスタンスがエラーで中断した状態を示します。

Error

4

完了

プロセスのグローバルスコープが完了して，プロセスインスタンスが完了した状態を示します。

Completed

5

フォルト終了

フォルトが発生し，グローバルスコープでもキャッチできないで，プロセスインスタンスがフォルト終了した状態を示します。

Faulted

6

途中終了

途中終了アクティビティによって，プロセスインスタンスが途中終了した状態を示します。

Exited

7

強制終了

終了アクティビティで，プロセスインスタンスが強制終了した状態を示します。

Terminated

(d)　アクティビティの種別

項番

名称

説明

データベース上の値

1

receive

受付アクティビティを示します。

RECEIVE

2

reply

応答アクティビティを示します。

REPLY

3

invoke

サービス呼出アクティビティを示します。

INVOKE

4

assign

代入アクティビティを示します。

ASSIGN

5

scope

スコープアクティビティを示します。

SCOPE

6

sequence

アクティビティを定義した順番に実行することを示します。

SEQUENCE

7

flow

並列処理アクティビティを示します。

FLOW

8

switch

分岐アクティビティを示します。

SWITCH

9

while

繰り返しアクティビティを示します。

WHILE

10

java

Java呼出アクティビティを示します。

JAVA

11

wait

待機アクティビティを示します。

WAIT

12

empty

無操作アクティビティを示します。

EMPTY

13

throw

フォルト送出アクティビティを示します。

THROW

14

validate

検証アクティビティを示します。

VALIDATE

15

compensate

補償アクティビティを示します。

COMPENSATE

16

log

ログ出力アクティビティを示します。

LOG

17

exit

途中終了アクティビティを示します。

EXIT

(e)　アクティビティインスタンスの状態

項番

名称

説明

データベース上の値

1

未実行

アクティビティのインスタンスが未実行で，今後実行される可能性のある状態を示します。

Unexecution

2

未省略

アクティビティのインスタンスが未実行で，今後実行が省略される状態を示します。

Unomission

3

実行中

アクティビティインスタンスが実行中の状態を示します。

Executing

4

実行中（待ち受け）

ロールバックが実行され，スコープアクティビティインスタンスが再実行可能な状態を示します。

Executingwait

5

待ち受け

受付アクティビティのインスタンスが受け付け可能になっている状態を示します。

Awaiting

6

フォルト中

スコープアクティビティのインスタンスがフォルト処理でキャッチしたアクティビティを実行している状態を示します。

Faulting

7

エラー発生

サービス呼出アクティビティまたはスコープアクティビティの処理で例外（エラー）が発生し，アクティビティのインスタンスが中断した状態を示します。

Error

8

補償中

サービス呼出アクティビティまたはスコープアクティビティのインスタンスがcompensationHandler配下に定義したアクティビティを実行している状態を示します。

Compensating

9

完了

アクティビティのインスタンスが正常に実行され終了した状態を示します。

Completed

10

完了（待ち受け）

スコープアクティビティまたは応答アクティビティのインスタンスが正常に実行され終了した状態で，再実行可能な状態を示します。

Completedwait

11

キャンセル

フォルトが発生しアクティビティのインスタンスの実行がキャンセルされた状態を示します。

Canceled

12

フォルト終了

アクティビティのインスタンスの実行中にフォルトが発生して終了した状態を示します。

Faulted

13

実行省略

アクティビティのインスタンスの実行が省略され終了した状態を示します。

Omitted

14

補償完了

サービス呼出アクティビティまたはスコープアクティビティのインスタンスのcompensationHandler配下に定義したアクティビティが正常に実行され終了した状態を示します。

Compensated

(f)　リンクの状態

項番

名称

説明

データベース上の値

1

真

true活性の状態を示します。

1

2

偽

false活性の状態を示します。

0

(g)　相関セットの状態

項番

名称

説明

データベース上の値

1

有効

有効状態を示します。

1

2

無効

無効状態を示します。

0

(h)　真偽値型変数の変数値

項番

名称

説明

データベース上の値

1

真

真（true）値を示します。

1

2

偽

偽（false）値を示します。

0

(i)　メッセージの送受信フラグ

項番

名称

説明

データベース上の値

1

receive受信

該当メッセージを受付アクティビティで受信したことを示すフラグです。

R

2

invoke送信

該当メッセージをサービス呼出アクティビティで送信したことを示すフラグです。

O

(j)　所属する繰り返し処理の識別番号（RepeatNumber）

親アクティビティ定義が繰り返し処理の場合，自アクティビティインスタンスの識別番号を設定します。

親アクティビティ定義が繰り返し処理でない場合，親アクティビティインスタンスの繰り返し処理の識別番号を設定します。

(k)　子アクティビティインスタンスの最小識別番号・最大識別番号（FirstChildNumber/LastChildNumber）

初期値は，自アクティビティのインスタンスの識別番号を示します。

子アクティビティインスタンスの生成時に，それらの識別番号の最小値または最大値を設定します。

(3)　インデクスの情報

それぞれのテーブルに付与するインデクスの情報について，次に示します。

CSCBP_<クラスタ名>_PROCESSテーブルのインデクス

項番

インデクス名

UNIQUE属性

インデクス中の順位

カラム名

1

CSCBP_<クラスタ名>_PROCESS_IDX1

あり

1

ProcessID

2

SplitKey※

2

CSCBP_<クラスタ名>_PROCESS_IDX2

なし

1

ProcessDefinitionName

2

State

3

StartTime

3

CSCBP_<クラスタ名>_PROCESS_IDX3

なし

1

ProcessDefinitionName

2

State

3

EndTime

4

CSCBP_<クラスタ名>_PROCESS_IDX4

なし

1

CSCServerName

2

ProcessDefinitionName

3

State

注※

日付データによるレンジ分割をする（HCSCサーバセットアップ定義ファイルのdb-tbl-split-keyに「NONE」以外を指定してセットアップする）場合に，SQLスクリプトファイルに含まれる列です。db-tbl-split-keyについては，マニュアル「サービスプラットフォームリファレンス」の「6.4.3　HCSCサーバセットアップ定義ファイル」を参照してください。

CSCBP_<クラスタ名>_ACTIVITYテーブルのインデクス

項番

インデクス名

UNIQUE属性

インデクス中の順位

カラム名

1

CSCBP_<クラスタ名>_ACTIVITY_IDX

あり

1

ProcessID

2

ActivityNumber

3

SplitKey※

注※

日付データによるレンジ分割をする（HCSCサーバセットアップ定義ファイルのdb-tbl-split-keyに「NONE」以外を指定してセットアップする）場合に，SQLスクリプトファイルに含まれる列です。db-tbl-split-keyについては，マニュアル「サービスプラットフォームリファレンス」の「6.4.3　HCSCサーバセットアップ定義ファイル」を参照してください。

CSCBP_<クラスタ名>_LINKテーブルのインデクス

項番

インデクス名

UNIQUE属性

インデクス中の順位

カラム名

1

CSCBP_<クラスタ名>_LINK_IDX

あり

1

ProcessID

2

LinkDefinitionName

3

RepeatNumber

4

SplitKey※

注※

日付データによるレンジ分割をする（HCSCサーバセットアップ定義ファイルのdb-tbl-split-keyに「NONE」以外を指定してセットアップする）場合に，SQLスクリプトファイルに含まれる列です。db-tbl-split-keyについては，マニュアル「サービスプラットフォームリファレンス」の「6.4.3　HCSCサーバセットアップ定義ファイル」を参照してください。

CSCBP_<クラスタ名>_CORRELATIONSETテーブルのインデクス

項番

インデクス名

UNIQUE属性

インデクス中の順位

カラム名

1

CSCBP_<クラスタ名>_CORREL_IDX1

あり

1

ProcessID

2

ScopeNumber

3

CorrelationSetName

4

SplitKey※2

2

CSCBP_<クラスタ名>_CORREL_IDX2

あり

1

ProcessDefinitionName

2

ScopeDefinitionName

3

CorrelationSetName

4

CorrelationSetValue

5

ProcessID※1

6

SplitKey※2

注※1

ProcessIDによるハッシュ分割をする場合に，SQLスクリプトファイルに含まれる列です。

注※2

日付データによるレンジ分割をする（HCSCサーバセットアップ定義ファイルのdb-tbl-split-keyに「NONE」以外を指定してセットアップする）場合に，SQLスクリプトファイルに含まれる列です。db-tbl-split-keyについては，マニュアル「サービスプラットフォームリファレンス」の「6.4.3　HCSCサーバセットアップ定義ファイル」を参照してください。

CSCBP_<クラスタ名>_STR_VARIABLEテーブルのインデクス

項番

インデクス名

UNIQUE属性

インデクス中の順位

カラム名

1

CSCBP_<クラスタ名>_STR_VAR_IDX

あり

1

ProcessID

2

ScopeNumber

3

VariableName

4

SplitKey※

注※

日付データによるレンジ分割をする（HCSCサーバセットアップ定義ファイルのdb-tbl-split-keyに「NONE」以外を指定してセットアップする）場合に，SQLスクリプトファイルに含まれる列です。db-tbl-split-keyについては，マニュアル「サービスプラットフォームリファレンス」の「6.4.3　HCSCサーバセットアップ定義ファイル」を参照してください。

CSCBP_<クラスタ名>_NUM_VARIABLEテーブルのインデクス

項番

インデクス名

UNIQUE属性

インデクス中の順位

カラム名

1

CSCBP_<クラスタ名>_NUM_VAR_IDX

あり

1

ProcessID

2

ScopeNumber

3

VariableName

4

SplitKey※

注※

日付データによるレンジ分割をする（HCSCサーバセットアップ定義ファイルのdb-tbl-split-keyに「NONE」以外を指定してセットアップする）場合に，SQLスクリプトファイルに含まれる列です。db-tbl-split-keyについては，マニュアル「サービスプラットフォームリファレンス」の「6.4.3　HCSCサーバセットアップ定義ファイル」を参照してください。

CSCBP_<クラスタ名>_BOOL_VARIABLEテーブルのインデクス

項番

インデクス名

UNIQUE属性

インデクス中の順位

カラム名

1

CSCBP_<クラスタ名>_BOOL_VAR_IDX

あり

1

ProcessID

2

ScopeNumber

3

VariableName

4

SplitKey※

注※

日付データによるレンジ分割をする（HCSCサーバセットアップ定義ファイルのdb-tbl-split-keyに「NONE」以外を指定してセットアップする）場合に，SQLスクリプトファイルに含まれる列です。db-tbl-split-keyについては，マニュアル「サービスプラットフォームリファレンス」の「6.4.3　HCSCサーバセットアップ定義ファイル」を参照してください。

CSCBP_<クラスタ名>_MSG_VARIABLEテーブルのインデクス

項番

インデクス名

UNIQUE属性

インデクス中の順位

カラム名

1

CSCBP_<クラスタ名>_MSG_VAR_IDX

あり

1

ProcessID

2

ScopeNumber

3

VariableName

4

SplitKey※

注※

日付データによるレンジ分割をする（HCSCサーバセットアップ定義ファイルのdb-tbl-split-keyに「NONE」以外を指定してセットアップする）場合に，SQLスクリプトファイルに含まれる列です。db-tbl-split-keyについては，マニュアル「サービスプラットフォームリファレンス」の「6.4.3　HCSCサーバセットアップ定義ファイル」を参照してください。

CSCBP_<クラスタ名>_MSG_RELATIONテーブルのインデクス

項番

インデクス名

UNIQUE属性

インデクス中の順位

カラム名

1

CSCBP_<クラスタ名>_MSG_REL_IDX1

なし

1

MessageID

2

CSCBP_<クラスタ名>_MSG_REL_IDX2

あり

1

ProcessID

2

ActivityNumber

3

SendOrReceive

4

SplitKey※

3

CSCBP_<クラスタ名>_MSG_REL_IDX3

なし

1

AsynchronousMessagingID

注※

日付データによるレンジ分割をする（HCSCサーバセットアップ定義ファイルのdb-tbl-split-keyに「NONE」以外を指定してセットアップする）場合に，SQLスクリプトファイルに含まれる列です。db-tbl-split-keyについては，マニュアル「サービスプラットフォームリファレンス」の「6.4.3　HCSCサーバセットアップ定義ファイル」を参照してください。

(4)　ビュー表の情報

ビュー表の情報を次に示します。

CSCBP_<クラスタ名>_V_ACTIVITYビュー表

項番

列名

参照先テーブル

参照先カラム

1

ProcessID

ACTIVITY

ProcessID

2

ActivityNumber

ACTIVITY

ActivityNumber

3

ProcessDefinitionName

PROCESS

ProcessDefinitionName

4

ProcessDefinitionVersion

PROCESS

ProcessDefinitionVersion

5

ActivityDefinitionName

ACTIVITY

ActivityDefinitionName

6

ActivityKind

ACTIVITY

ActivityKind

7

ParentNumber※1

ACTIVITY

ParentNumber

8

ScopeNumber

ACTIVITY

ScopeNumber

9

RepeatNumber※1

ACTIVITY

RepeatNumber

10

State

ACTIVITY

State

11

FirstChildNumber※1

ACTIVITY

FirstChildNumber

12

LastChildNumber※1

ACTIVITY

LastChildNumber

13

StartTime

ACTIVITY

StartTime

14

EndTime

ACTIVITY

EndTime

15

WaitTime

ACTIVITY

WaitTime

16

CSCServerName

PROCESS

CSCServerName

17

SplitKey※2

PROCESS

SplitKey

注※1

実行時に内部管理用に使用される項目のため，値を意識する必要はありません。

注※2

cscpiselectコマンドの-tableオプションにactivityを指定し，-whereまたは-wherefileオプションにSplitKey列を指定する場合だけビューに含まれる列です。

CSCBP_<クラスタ名>_V_LINKビュー表

項番

列名

参照先テーブル

参照先カラム

1

ProcessID

LINK

ProcessID

2

ProcessDefinitionName

PROCESS

ProcessDefinitionName

3

ProcessDefinitionVersion

PROCESS

ProcessDefinitionVersion

4

LinkDefinitionName

LINK

LinkDefinitionName

5

RepeatNumber※1

LINK

RepeatNumber

6

State

LINK

State

7

SplitKey※2

PROCESS

SplitKey

注※1

実行時に内部管理用に使用される項目のため，値を意識する必要はありません。

注※2

cscpiselectコマンドの-tableオプションにlinkを指定し，-whereまたは-wherefileオプションにSplitKey列を指定する場合だけビューに含まれる列です。

CSCBP_<クラスタ名>_V_STR_VARIABLEビュー表

項番

列名

参照先テーブル

参照先カラム

1

ProcessID

STR_VARIABLE

ProcessID

2

ProcessDefinitionName

PROCESS

ProcessDefinitionName

3

ProcessDefinitionVersion

PROCESS

ProcessDefinitionVersion

4

ScopeDefinitionName

ACTIVITY

ActivityDefinitionName

5

ScopeNumber

STR_VARIABLE

ScopeNumber

6

VariableName

STR_VARIABLE

VariableName

7

VariableValue

STR_VARIABLE

VariableValue

8

SplitKey※

PROCESS

SplitKey

注※

cscpiselectコマンドの-tableオプションにstringを指定し，-whereまたは-wherefileオプションにSplitKey列を指定する場合だけビューに含まれる列です。

CSCBP_<クラスタ名>_V_NUM_VARIABLEビュー表

項番

列名

参照先テーブル

参照先カラム

1

ProcessID

NUM_VARIABLE

ProcessID

2

ProcessDefinitionName

PROCESS

ProcessDefinitionName

3

ProcessDefinitionVersion

PROCESS

ProcessDefinitionVersion

4

ScopeDefinitionName

ACTIVITY

ActivityDefinitionName

5

ScopeNumber

NUM_VARIABLE

ScopeNumber

6

VariableName

NUM_VARIABLE

VariableName

7

VariableValue

NUM_VARIABLE

VariableValue

8

SplitKey※

PROCESS

SplitKey

注※

cscpiselectコマンドの-tableオプションにnumericを指定し，-whereまたは-wherefileオプションにSplitKey列を指定する場合だけビューに含まれる列です。

CSCBP_<クラスタ名>_V_BOOL_VARIABLEビュー表

項番

列名

参照先テーブル

参照先カラム

1

ProcessID

BOOL_VARIABLE

ProcessID

2

ProcessDefinitionName

PROCESS

ProcessDefinitionName

3

ProcessDefinitionVersion

PROCESS

ProcessDefinitionVersion

4

ScopeDefinitionName

ACTIVITY

ActivityDefinitionName

5

ScopeNumber

BOOL_VARIABLE

ScopeNumber

6

VariableName

BOOL_VARIABLE

VariableName

7

VariableValue

BOOL_VARIABLE

VariableValue

8

SplitKey※

PROCESS

SplitKey

注※

cscpiselectコマンドの-tableオプションにbooleanを指定し，-whereまたは-wherefileオプションにSplitKey列を指定する場合だけビューに含まれる列です。

CSCBP_<クラスタ名>_V_MSG_VARIABLEビュー表

項番

列名

参照先テーブル

参照先カラム

1

ProcessID

MSG_VARIABLE

ProcessID

2

ProcessDefinitionName

PROCESS

ProcessDefinitionName

3

ProcessDefinitionVersion

PROCESS

ProcessDefinitionVersion

4

ScopeDefinitionName

ACTIVITY

ActivityDefinitionName

5

ScopeNumber

MSG_VARIABLE

ScopeNumber

6

VariableName

MSG_VARIABLE

VariableName

7

VariableValue

MSG_VARIABLE

VariableValue

8

SplitKey※

PROCESS

SplitKey

注※

cscpiselectコマンドの-tableオプションにmessageを指定し，-whereまたは-wherefileオプションにSplitKey列を指定する場合だけビューに含まれる列です。

付録C.2　電文の実行履歴の管理に関するテーブルの情報

電文履歴の管理には，ここに示すテーブルの使用は推奨しません。代替としてユーザ電文トレース機能を使用してください。

(1)　テーブルの情報

電文履歴の管理にテーブルを使用する場合，次に示すテーブルがクラスタごとに必要です。

実行履歴情報テーブル

(a)　実行履歴情報テーブル

●CSCMSG_C<クラスタ名>_EXECHISTORYテーブル

CSCMSG_C<クラスタ名>_EXECHISTORYテーブルの内容を次に示します。

項番

列名

説明

HiRDB型

ORACLE型

インデクスの有無

NULL値

UNIQUE属性

1

MESSAGE_ID

メッセージごとに付与するUNIQUEな識別子

CSC＋HCSCサーバ名＋現在時刻（ミリ秒）＋通番

VARCHAR(75)

VARCHAR2(75)

あり

可

なし

2

MESSAGE_ID_CSC_MSG

HCSCサーバ内のメッセージング基盤のメッセージを識別するためのUNIQUEな識別子

MSG＋HCSCサーバ名＋受付種別＋現在時刻（ミリ秒）＋通番

VARCHAR(84)

VARCHAR2(84)

なし

可

なし

3

REQUEST_CSC_SERVER_NAME

要求を受け付けたHCSCサーバ名

VARCHAR(8)

VARCHAR2(8)

なし

可

なし

4

HISTORY_KIND_DIRECTION

実行履歴採取方向

Service Request Direction/Service Response Direction/Service Error/Service Fault

VARCHAR(26)

VARCHAR2(26)

なし

可

なし

5

TIME_STAMP

実行履歴を採取した時刻（ミリ秒単位）タイムスタンプ

TIMESTAMP(4)

NUMBER(20,0)

なし

可

なし

6

REQUEST_SYNCHRONOUS_KIND

リクエスト側のプロトコルWebService/SessionBean/MDB_WSR/MDB_DBQ

VARCHAR(16)

VARCHAR2(16)

なし

可

なし

7

SERVICE_REQUEST_TYPE

サービスリクエスタの種類

ClientProgram（クライアントプログラム）

BusinessProcess（ビジネスプロセス）

VARCHAR(24)

VARCHAR2(24)

なし

可

なし

8

REQUEST_USER_TEL_TYPE

要求ユーザ電文の種類を示す種別

XML/BINARY/ANY

VARCHAR(8)

VARCHAR2(8)

なし

可

なし

9

RESPONSE_USER_TEL_TYPE

応答ユーザ電文の種類を示す種別

XML/BINARY/ANY

VARCHAR(8)

VARCHAR2(8)

なし

可

なし

10

SERVICE_NAME

リクエスタからの入力サービス名（リクエスト要求先サービス部品）

MVARCHAR(64)

NVARCHAR2(64)

なし

可

なし

11

CLIENT_ID

クライアントプログラムが指定したメッセージを識別するための相関識別子

VARCHAR(255)

VARCHAR2(255)

あり

可

なし

12

SERVICE_OPERATION_NAME

同期（Webサービス）の場合に必要なサービス部品のオペレーション

WSDLのOperation <wsdl:operation>

MVARCHAR(255)

NVARCHAR2(255)

なし

可

なし

13

REPLY_TO_QUEUE_NAME

非同期（MDB（WS-R），MDB（DBキュー））の場合の応答を受け取るためのキューの名称

VARCHAR(30)

VARCHAR2(30)

なし

可

なし

14

ADAPTER_NAME

サービスアダプタまたはビジネスプロセスのサービスID

VARCHAR(8)

VARCHAR2(8)

なし

可

なし

15

ADAPTER_SERVICE_NAME

サービス名

サービスアダプタのサービス名

ビジネスプロセスのサービス名

サービスグループ名

MVARCHAR(64)

NVARCHAR2(64)

なし

可

なし

16

ADAPTER_CLUSTER_NAME

サービスアダプタが属するクラスタの情報

VARCHAR(8)

VARCHAR2(8)

なし

可

なし

17

ADAPTER_KIND

サービスアダプタ側のサービス部品の種類

ServiceAdapter/BusinessProcess/ServiceGroup

VARCHAR(32)

VARCHAR2(32)

なし

可

なし

18

ADAPTER_SYNCHRONOUS_KIND

アダプタ先のサービス部品のプロトコル

WebService/SessionBean/MDB_WSR/MDB_DBQ/Custom

VARCHAR(16)

VARCHAR2(16)

なし

可

なし

19

INTERLOCK_CSC_PROTOCOL

連携HCSCサーバへ転送する際のプロトコル

WebService/SessionBean/MDB_WSR

VARCHAR(32)

VARCHAR2(32)

なし

可

なし

20

MESSAGE_ID_CSC_BP_ACTIVITY

ビジネスプロセスのアクティビティ番号（ビジネスプロセスアクティビティインスタンスを識別するための番号）

値なし：-1

INTEGER※1

NUMBER(10,0) ※2

なし

可

なし

21

MESSAGE_ID_CSC_BP_PROCESS

ビジネスプロセスのプロセスID

MVARCHAR(240)

NVARCHAR2(240)

なし

可

なし

22

CSC_BP_REQUEST_TYPE

ビジネスプロセス用要求タイプ

REPLY_AFTER：reply後の継続実行要求

RECOVER：プロセス再実行の要求

WAIT_AFTER：wait後処理の実行要求

VARCHAR(32)

VARCHAR2(32)

なし

可

なし

23

JMS_HEADER_JMS_MESSAGE_ID

JMSヘッダ

JMSMessageID

VARCHAR(255)

VARCHAR2(255)

なし

可

なし

24

JMS_HEADER_JMS_CORRELATION_ID

JMSヘッダ

JMSCorrelationID

VARCHAR(255)

VARCHAR2(255)

なし

可

なし

25

ROUTE_HISTORY

経路履歴として通過した情報

（<HCSCサーバ名>または<サービスID>を「->」でつないだ文字列で表示）

VARCHAR(255)

VARCHAR2(255)

なし

可

なし

26

ERROR_CODE

サービス部品，ビジネスプロセス，またはサービスアダプタからのエラー（Fault）情報

MVARCHAR(4000)

NVARCHAR2(1333)

なし

可

なし

27

USER_TEL_ORG_BINARY

ユーザ電文本体

BINARY(2147483639)

LONG RAW

なし

可

なし

28

OPTION1

予備1

BINARY(2000)

RAW(2000)

なし

可

なし

29

OPTION2

予備2

BINARY(2000)

RAW(2000)

なし

可

なし

30

OPTION3

予備3

BINARY(2000)

RAW(2000)

なし

可

なし

注※1

08-10以前のバージョンの場合，「SMALLINT」になります。

また，08-10以前のバージョンから更新インストールした場合，領域は変更されないため，「SMALLINT」になります。

注※2

08-10以前のバージョンの場合，「NUMBER(5,0)」になります。

また，08-10以前のバージョンから更新インストールした場合，領域は変更されないため，「NUMBER(5,0)」になります。

(2)　インデクスの情報

テーブルに付与するインデクスの情報について，次に示します。

CSCMSG_C<クラスタ名>_EXECHISTORYテーブルのインデクス

項番

インデクス名

UNIQUE属性

インデクス中の順位

カラム名

1

CSCMSG_<individualname>_EXECHISTORY_I

なし

1

MESSAGE_ID

2

2

CLIENT_ID

注

自HCSCサーバでのメッセージの実行履歴情報が蓄積されます。また，サービス部品呼び出しの数だけレコード数が増加します。

付録C.3　実行環境の設定に関するテーブルの情報

(1)　テーブルの情報

HCSCサーバまたはクラスタごとに，次に示すテーブルが必要です。

HCSC基本情報テーブル

HCSC連携ディレクトリ情報テーブル

ロケーションディレクトリ情報テーブル

ルーティングルールディレクトリ情報テーブル

データ変換定義ディレクトリ情報テーブル

クラスタ基本情報管理テーブル

非同期アダプタサービスID管理テーブル

(a)　HCSC基本情報テーブル

●CSCMSG_S<HCSCサーバ名>_CSC_PERSISTテーブル

CSCMSG_S<HCSCサーバ名>_CSC_PERSISTテーブルの内容を次に示します。

項番

列名

説明

HiRDB型

ORACLE型

インデクスの有無

NULL値

UNIQUE属性

1

CSC_SERVER_NAME

自HCSCサーバの名称

VARCHAR(8)

VARCHAR2(8)

なし

不可

なし

2

CSC_SERVER_STATUS

HCSCサーバ本体の状態（未使用）

1：開始処理中

2：開始

3：開始失敗

4：停止

5：停止処理中

6：停止失敗

INTEGER

NUMBER(10,0)

なし

不可

なし

3

CSC_REQUEST_STATUS

同期受付の状態

1：開始処理中

2：開始

3：開始失敗

4：停止

5：停止処理中

6：停止失敗

INTEGER

NUMBER(10,0)

なし

不可

なし

4

CSC_CONNECT_STATUS

連携受付の状態

1：開始処理中

2：開始

3：開始失敗

4：停止

5：停止処理中

6：停止失敗

INTEGER

NUMBER(10,0)

なし

不可

なし

5

CSC_TABLE_VERSION

HCSC全体のテーブルバージョン番号

INTEGER

NUMBER(10,0)

なし

不可

なし

6

CSC_TABLE_REVISION

HCSC全体のテーブルリビジョン番号

INTEGER

NUMBER(10,0)

なし

不可

なし

7

OPTION1

予備1

BINARY(2000)

RAW(2000)

なし

可

なし

8

OPTION2

予備2

BINARY(2000)

RAW(2000)

なし

可

なし

9

OPTION3

予備3

BINARY(2000)

RAW(2000)

なし

可

なし

注

デフォルトでは，INDEXを使用しません。

(b)　HCSC連携ディレクトリ情報テーブル

●CSCMSG_C<クラスタ名>_CSC_CONNECTテーブル

CSCMSG_C<クラスタ名>_CSC_CONNECTテーブルの内容を次に示します。

項番

列名

説明

HiRDB型

ORACLE型

インデクスの有無

NULL値

UNIQUE属性

1

CONNECT_CLUSTER_NAME※

連携先クラスタ名

VARCHAR(8)

VARCHAR2(8)

なし

不可

あり

2

CONNECT_VERSION

要求元のHCSCサーババージョン番号

INTEGER

NUMBER(10,0)

なし

不可

なし

3

CONNECT_REVISION

要求元のHCSCサーバリビジョン番号

INTEGER

NUMBER(10,0)

なし

不可

なし

4

CONNECT_ID

要求元のHCSCサーバでの連携開始時のタイムスタンプ

TIMESTAMP(4)

NUMBER(20,0)

なし

不可

なし

5

CONNECT_STATUS

HCSCサーバとの連携状態

1：OFFLINE（未連携状態）

2：ONLINE（連携中状態）

INTEGER

NUMBER(10,0)

なし

不可

なし

6

CONNECT_OPTION

同期種別（同期インターフェースについて，次のどちらで連携するか）

SOAP

EJB

VARCHAR(16)

VARCHAR2(16)

なし

可

なし

7

CONNECT_WEB_URL

SOAP転送用WebサービスのURL

VARCHAR(2086)

VARCHAR2(2086)

なし

可

なし

8

CONNECT_WEB_USER_ID

SOAP転送用ユーザID

VARCHAR(256)

VARCHAR2(256)

なし

可

なし

9

CONNECT_WEB_PASSWORD

SOAP転送用パスワード

VARCHAR(256)

VARCHAR2(256)

なし

可

なし

10

CONNECT_J2EE_NAME

転送用のEJB呼び出しで使用するJ2EEサーバ名称

VARCHAR(255)

VARCHAR2(255)

なし

可

なし

11

CONNECT_NAMING_HOST

転送用のEJB呼び出しで使用するネーミングサービスのホスト名称

VARCHAR(255)

VARCHAR2(255)

なし

可

なし

12

CONNECT_NAMING_PORT

転送用のEJB呼び出しで使用するネーミングサービスのポート番号

VARCHAR(5)

VARCHAR2(5)

なし

可

なし

13

OPTION1

予備1

BINARY(2000)

RAW(2000)

なし

可

なし

14

OPTION2

予備2

BINARY(2000)

RAW(2000)

なし

可

なし

15

OPTION3

予備3

BINARY(2000)

RAW(2000)

なし

可

なし

注※

CONNECT_CLUSTER_NAMEは，UNIQUE CLUSTER KEYで定義します（自動的にインデクスが作成されます）。

(c)　ロケーションディレクトリ情報テーブル

●CSCMSG_S<HCSCサーバ名>_LC_DIRECTORYテーブル

CSCMSG_S<HCSCサーバ名>_LC_DIRECTORYテーブルの内容を次に示します。

項番

列名

説明

HiRDB型

ORACLE型

インデクスの有無

NULL値

UNIQUE属性

1

SERVICE_NAME※

サービス名（リクエスト要求先サービス部品）

サービスアダプタのサービス名

ビジネスプロセスのサービス名

サービスグループ名

MVARCHAR(64)

NVARCHAR2(64)

なし

不可

あり

2

ADAPTER_NAME

サービスアダプタのサービスID，またはビジネスプロセスのサービスID

VARCHAR(8)

VARCHAR2(8)

なし

可

なし

3

SERVICE_KIND

サービス部品の種別

単体サービス部品

ビジネスプロセス

サービスグループ

ユーザ定義受付

INTEGER

NUMBER(10,0)

なし

不可

なし

4

SERVICE_PROTOCOL_KIND

サービスアダプタの種類

1：MDB_WSR（非同期）

2：MDB_DBQ（非同期）

3：SessionBean（同期）

4：WebService（同期）

5：Custom（上記1〜4以外）

INTEGER

NUMBER(10,0)

なし

不可

なし

5

SERVICE_STATUS

HCSCコンポーネントまたはサービスグループの状態

1：起動状態 ACTIVE

2：停止状態 INACTIVE

3：停止失敗状態 STOP_FAILED

4：停止処理中 STOPPING

5：起動失敗状態 START_FAILED

6：起動処理中 STARTING

7：削除処理中 DELETING

INTEGER

NUMBER(10,0)

なし

不可

なし

6

ADAPTER_ENTRY_TIME

アダプタ定義追加時間

TIMESTAMP(4)

NUMBER(20,0)

なし

不可

なし

7

LC_VERSION

ロケーションディレクトリバージョン番号

INTEGER

NUMBER(10,0)

なし

不可

なし

8

LC_REVISION

ロケーションディレクトリリビジョン番号

INTEGER

NUMBER(10,0)

なし

不可

なし

9

ADAPTER_LOCAL_CALL

アダプタ定義ファイルのパラメタ（local-call）の指定値

INTEGER

NUMBER(10,0)

なし

不可

なし

10

ADAPTER_MODIFIED_TIME

サービスアダプタまたはビジネスプロセスの更新時刻

TIMESTAMP(4)

NUMBER(20,0)

なし

不可

なし

11

OPTION1

ユーザ指定インターフェースの受付関連情報

BINARY(2000)

RAW(2000)

なし

可

なし

12

OPTION2

予備2

BINARY(2000)

RAW(2000)

なし

可

なし

13

OPTION3

予備3

BINARY(2000)

RAW(2000)

なし

可

なし

注※

SERVICE_NAMEは，UNIQUE CLUSTER KEYで定義します（自動的にインデクスが作成されます）。

●CSCMSG_S<HCSCサーバ名>_LC_BPFORMATテーブル

CSCMSG_S<HCSCサーバ名>_LC_BPFORMATテーブルの内容を次に示します。

項番

列名

説明

HiRDB型

ORACLE型

インデクスの有無

NULL値

UNIQUE属性

1

SERVICE_NAME

サービス名（リクエスト要求先サービス部品）

ビジネスプロセスのサービス名

MVARCHAR(64)

NVARCHAR2(64)

なし

不可

なし

2

OPERATION_NAME

サービス定義ファイルのオペレーション名

MVARCHAR(255)

NVARCHAR2(255)

なし

不可

なし

3

REQ_FORMAT_ID

サービス定義ファイルの要求フォーマットID

VARCHAR(1024)

VARCHAR2(1024)

なし

可

なし

4

RES_FORMAT_ID

サービス定義ファイルの応答フォーマットID

VARCHAR(1024)

VARCHAR2(1024)

なし

可

なし

5

OPTION1

予備1

BINARY(2000)

RAW(2000)

なし

可

なし

6

OPTION2

予備2

BINARY(2000)

RAW(2000)

なし

可

なし

7

OPTION3

予備3

BINARY(2000)

RAW(2000)

なし

可

なし

注

デフォルトでは，INDEXを使用しません。

(d)　ルーティングルールディレクトリ情報テーブル

●CSCMSG_S<HCSCサーバ名>_RT_RULEテーブル

CSCMSG_S<HCSCサーバ名>_RT_RULEテーブルの内容を次に示します。

項番

列名

説明

HiRDB型

ORACLE型

インデクスの有無

NULL値

UNIQUE属性

1

SERVICE_GROUP_NAME※

サービスグループ名

MVARCHAR(64)

NVARCHAR2(64)

なし

不可

あり

2

RULES

ルーティング定義のXMLのバイト列

BINARY(2147483639)

LONG RAW

なし

可

なし

3

OPTION1

予備1

BINARY(2000)

RAW(2000)

なし

可

なし

4

OPTION2

予備2

BINARY(2000)

RAW(2000)

なし

可

なし

5

OPTION3

予備3

BINARY(2000)

RAW(2000)

なし

可

なし

注※

SERVICE_GROUP_NAMEは，UNIQUE CLUSTER KEYで定義します（自動的にインデクスが作成されます）。

(e)　データ変換定義ディレクトリ情報テーブル

●CSCMSG_S<HCSCサーバ名>_CV_MAPPINGテーブル

CSCMSG_S<HCSCサーバ名>_CV_MAPPINGテーブルの内容を次に示します。

項番

列名

説明

HiRDB型

ORACLE型

インデクスの有無

NULL値

UNIQUE属性

1

BEF_FORMAT_ID

電文フォーマットID（変換元用）

VARCHAR(1024)

VARCHAR2(1024)

なし

可

なし

2

AFT_FORMAT_ID

電文フォーマットID（変換先用）

VARCHAR(1024)

VARCHAR2(1024)

なし

可

なし

3

ENTRY_TIME

データ変換定義追加時刻

TIMESTAMP(4)

NUMBER(20,0)

なし

可

なし

4

ROOT_FILE

ルートかルートでないかを判定するためのフラグ

0：false

1：true

INTEGER

NUMBER(10,0)

なし

可

なし

5

DEFINITION_NAME

データ変換定義ファイル名称

MVARCHAR(255)

NVARCHAR2(255)

なし

可

なし

6

TRANSFORM_DEFINITION

データ変換定義

BINARY(2147483639)

LONG RAW

なし

可

なし

7

OPTION1

予備1

BINARY(2000)

RAW(2000)

なし

可

なし

8

OPTION2

予備2

BINARY(2000)

RAW(2000)

なし

可

なし

9

OPTION3

予備3

BINARY(2000)

RAW(2000)

なし

可

なし

注

デフォルトでは，INDEXを使用しません。

●CSCMSG_S<HCSCサーバ名>_CV_FORMATテーブル

CSCMSG_S<HCSCサーバ名>_CV_FORMATテーブルの内容を次に示します。

項番

列名

説明

HiRDB型

ORACLE型

インデクスの有無

NULL値

UNIQUE属性

1

FORMAT_ID

電文フォーマットID

変換元用

変換先用

VARCHAR(1024)

VARCHAR2(1024)

なし

可

なし

2

FORMAT_TYPE

電文フォーマットの種別

1：XML

2：BINARY

INTEGER

NUMBER(10,0)

なし

可

なし

3

ENTRY_TIME

電文フォーマット定義追加時刻

TIMESTAMP(4)

NUMBER(20,0)

なし

可

なし

4

ROOT_FILE

ルートかルートでないかを判定するためのフラグ

0：false

1：true

INTEGER

NUMBER(10,0)

なし

可

なし

5

DEFINITION_NAME

フォーマット定義ファイル名称

MVARCHAR(255)

NVARCHAR2(255)

なし

可

なし

6

FORMAT_DEFINITION

電文フォーマット定義（データ定義）

BINARY(2147483639)

LONG RAW

なし

可

なし

7

OPTION1

予備1

BINARY(2000)

RAW(2000)

なし

可

なし

8

OPTION2

予備2

BINARY(2000)

RAW(2000)

なし

可

なし

9

OPTION3

予備3

BINARY(2000)

RAW(2000)

なし

可

なし

注

デフォルトでは，INDEXを使用しません。

(f)　クラスタ基本情報管理テーブル

●CSCMSG_C<クラスタ名>_CLUSTERテーブル

CSCMSG_C<クラスタ名>_CLUSTERテーブルの内容を次に示します。

項番

列名

説明

HiRDB型

ORACLE型

インデクスの有無

NULL値

UNIQUE属性

1

CSC_SERVER_NAME※1

セットアップされたHCSCサーバ名称

VARCHAR(8)

VARCHAR2(8)

なし

不可

なし

2

CLUSTER_TYPE

セットアップされたHCSCサーバのクラスタ種別

VARCHAR(2)

VARCHAR2(2)

なし

不可

なし

3

J2EE_NAME

HCSCサーバをセットアップしたJ2EEサーバ名

VARCHAR(255)

VARCHAR2(255)

なし

不可

なし

4

SOAP_RCP

標準受付（Webサービス）がセットアップされているかどうか

0：セットアップされていない

1：セットアップされている

INTEGER

NUMBER(1)

なし

不可

なし

5

EJB_RCP

標準受付（SessionBean）がセットアップされているかどうか

0：セットアップされていない

1：セットアップされている

INTEGER

NUMBER(1)

なし

不可

なし

6

WSR_RCP

標準受付（MDB（WS-R））がセットアップされているかどうか

0：セットアップされていない

1：セットアップされている

INTEGER

NUMBER(1)

なし

不可

なし

7

DBQ_RCP

標準受付（MDB（DBキュー））がセットアップされているかどうか

0：セットアップされていない

1：セットアップされている

INTEGER

NUMBER(1)

なし

不可

なし

8

RM_SYSNAME

HCSCサーバをセットアップしたときに設定したRMシステム名

設定していない場合は""が設定される

VARCHAR(3)

VARCHAR2(3)

なし

なし

なし

9

CLUSTER_PROPS

拡張用カラム

「キー名=値」の形式で情報を保持する※2

VARCHAR(4000)

VARCHAR2(4000)

なし

なし

なし

注

デフォルトでは，INDEXを使用しません。

注※1

このテーブルのPRIMARY KEYです。

注※2

CLUSTER_PROPSに格納される可能性のある情報は次のとおりです。

キー名

キーの説明

キーの値の説明

db-tbl-split-key

レンジ分割に使うキーの種類

NONE

レンジ分割を使わない。

MONTH

「月」を分割キーに使う。

db-tbl-split-corcheck-use

相関セットの重複チェックを強化するかどうか

ON

相関セットの重複チェックを強化する。

OFF

相関セットの重複チェックを強化しない。

(g)　非同期アダプタサービスID管理テーブル

●CSCMSG_C<クラスタ名>_HA_ASYNC_ADPテーブル

CSCMSG_C<クラスタ名>_HA_ASYNC_ADPテーブルの内容を次に示します。

項番

列名

説明

HiRDB型

ORACLE型

インデクスの有無

NULL値

UNIQUE属性

1

CSC_SERVER_NAME※

コンポーネントが配備されるHCSCサーバ名

VARCHAR(8)

VARCHAR2(8)

なし

不可

なし

2

ADAPTER_ID※

サービスアダプタのサービスID

VARCHAR(8)

VARCHAR2(8)

なし

不可

なし

注

デフォルトでは，INDEXを使用しません。

注※

このテーブルのPRIMARY KEYです。

付録C.4　ユーザ独自の表またはインデクスを作成する場合の注意事項

HCSCと同じデータベース上にユーザ独自の表やインデクスを作成する場合は，「"CSC"＋半角英字＋アンダーバー」（例えば「CSCMSG_」や「CSCBP_」）で始まる名称を使用しないでください。使用した場合，次バージョン以降でHCSCが使用する名称と重複してしまうおそれがあります。

付録D　SQLスクリプトファイルの設定

次に示す場合に，SQLスクリプトファイルを使用して，メッセージング基盤やビジネスプロセス基盤で使用するテーブルをカスタマイズします。

RDエリア，または表領域（テーブルスペース）をより細かく設定する場合

HCSCサーバセットアップ定義ファイルでは定型的な格納領域しか設定できないため，より詳細な格納領域を設定するにはSQLスクリプトファイルを使用する必要があります。

次に具体例を示します。

ロケーションディレクトリ情報テーブルやデータ変換ディレクトリ情報テーブルは複数のテーブルの総称ですが，location-tbl-areaプロパティまたはcv-tbl-areaプロパティを使用しても，複数のテーブルに対して1つのRDエリア，または表領域（テーブルスペース）しか設定できません。

PRIMARY KEYまたはCLUSTER KEYに対して，RDエリアまたは表領域（テーブルスペース）は設定できません。

1つのテーブルに対して，1つのRDエリアまたは表領域（テーブルスペース）しか設定できません（分割定義ができない）。

検索時の性能を向上させる場合

この場合は，運用に応じて，よく使う機能についてインデクスが指定されていない列にインデクスを設定します。例えば，実行履歴情報の表示の際にキーとなる情報にインデクスを設定するなどができます。

付録D.1　SQLスクリプトファイルの種類と格納先

SQLスクリプトファイルは，次に示すディレクトリに格納されているサンプルファイルを利用して作成します。

<サービスプラットフォームのインストールディレクトリ>¥CSC¥sql

ディレクトリ内には次に示すファイルがあり，データベースのタイプや用途に応じて使用するファイルが異なります。

表D‒1　SQLスクリプトファイルの種類

データベースのタイプ

分類

ファイル名

説明

HiRDB

テーブル作成用

CreateTables_HiRDB.sql

スタンドアロンのHCSCサーバのセットアップ，またはクラスタ構成の1台目HCSCサーバのセットアップに使用します。

CreateTables_HiRDB_for_Matrix.sql

スタンドアロンのHCSCサーバのセットアップまたはクラスタ構成の1台目HCSCサーバのセットアップで，HiRDBのマトリクス分割を利用する場合に使用します。

CreateTables_HiRDB_for_Range.sql

HiRDBのレンジ分割を利用する場合，スタンドアロンのHCSCサーバのセットアップまたはクラスタ構成の1台目HCSCサーバのセットアップに使用します。

CreateCSCIndividualTables_HiRDB.sql

クラスタ構成の2台目HCSCサーバのセットアップに使用します。

テーブル削除用

DeleteTables_HiRDB.sql

スタンドアロンのHCSCサーバのアンセットアップ，またはクラスタ構成の1台目HCSCサーバのアンセットアップに使用します。

DeleteCSCIndividualTables_HiRDB.sql

クラスタ構成の2台目HCSCサーバのアンセットアップに使用します。

Oracle

テーブル作成用

CreateTables_Oracle.sql

スタンドアロンのHCSCサーバのセットアップ，またはクラスタ構成の1台目HCSCサーバのセットアップに使用します。

CreateCSCIndividualTables_Oracle.sql

クラスタ構成の2台目HCSCサーバのセットアップに使用します。

テーブル削除用

DeleteTables_Oracle.sql

スタンドアロンのHCSCサーバのアンセットアップ，またはクラスタ構成の1台目HCSCサーバのアンセットアップに使用します。

DeleteCSCIndividualTables_Oracle.sql

クラスタ構成の2台目HCSCサーバのアンセットアップに使用します。

付録D.2　SQLスクリプトファイルの設定方法

SQLスクリプトファイルを設定する場合，テーブル名，およびRDエリア名または表領域名を変更します。

(1)　テーブル名の変更

SQLスクリプトファイル内にある各テーブルの，次の個所を変更します。

<individualname>：クラスタ名，またはHCSCサーバ名

テーブルごとの変更規則を次の表に示します。

表D‒2　テーブル名の変更規則

置換前のテーブル名またはインデクス名

置換方法

例

CSCMSG_<individualname>_CSC_CONNECT

CSCMSG_<individualname>_EXECHISTORY※

CSCMSG_<individualname>_EXECHISTORY_I※

CSCMSG_<individualname>_CLUSTER

CSCMSG_<individualname>_HA_ASYNC_ADP

C<クラスタ名>

クラスタ名が「Cluster」の場合

CSCMSG_CCluster_CSC_CONNECT

CSCMSG_<individualname>_CSC_PERSIST

CSCMSG_<individualname>_LC_DIRECTORY

CSCMSG_<individualname>_LC_BPFORMAT

CSCMSG_<individualname>_RT_RULE

CSCMSG_<individualname>_CV_MAPPING

CSCMSG_<individualname>_CV_FORMAT

S<HCSCサーバ名>

HCSCサーバ名が「HCSC」の場合

CSCMSG_SHCSC_CSC_PERSIST

CSCBP_<individualname>_PROCESS

CSCBP_<individualname>_ACTIVITY

CSCBP_<individualname>_LINK

CSCBP_<individualname>_CORRELATIONSET

CSCBP_<individualname>_STR_VARIABLE

CSCBP_<individualname>_NUM_VARIABLE

CSCBP_<individualname>_BOOL_VARIABLE

CSCBP_<individualname>_MSG_VARIABLE

CSCBP_<individualname>_MSG_RELATION

CSCBP_<individualname>_PROCESS_IDX1

CSCBP_<individualname>_PROCESS_IDX2

CSCBP_<individualname>_PROCESS_IDX3

CSCBP_<individualname>_PROCESS_IDX4

CSCBP_<individualname>_ACTIVITY_IDX

CSCBP_<individualname>_LINK_IDX

CSCBP_<individualname>_CORREL_IDX1

CSCBP_<individualname>_CORREL_IDX2

CSCBP_<individualname>_STR_VAR_IDX

CSCBP_<individualname>_NUM_VAR_IDX

CSCBP_<individualname>_BOOL_VAR_IDX

CSCBP_<individualname>_MSG_VAR_IDX

CSCBP_<individualname>_MSG_REL_IDX1

CSCBP_<individualname>_MSG_REL_IDX2

CSCBP_<individualname>_MSG_REL_IDX3

CSCBP_<individualname>_V_ACTIVITY

CSCBP_<individualname>_V_LINK

CSCBP_<individualname>_V_STR_VARIABLE

CSCBP_<individualname>_V_NUM_VARIABLE

CSCBP_<individualname>_V_BOOL_VARIABLE

CSCBP_<individualname>_V_MSG_VARIABLE

<クラスタ名>

クラスタ名が「Cluster」の場合

CSCBP_Cluster_PROCESS

注※

このテーブルの使用は推奨しません。代替としてユーザ電文トレース機能を使用してください。

(2)　RDエリア名または表領域名の変更

データベースごとに次に示すように変更します。

(a)　HiRDBの場合

SQLスクリプトファイル内の各テーブルの次の個所を書き換えます。RDエリアを指定しない場合は，「IN <RDDATA>」または「IN <RDINDX>」を削除します。

IN <RDDATA>：各テーブルを格納するRDエリア名を指定します。

IN <RDINDX>：各インデクスを格納するRDエリア名を指定します。

また，SQLスクリプトファイル「CreateTables_HiRDB_for_Range.sql」または「CreateTables_HiRDB_for_Matrix.sql」を使用する場合は，次に示す個所も書き換えてください。

<RDDATAn>：n月（n：01〜12）のデータを格納するRDエリアを指定します。

<RDINDXn>：n月（n：01〜12）のインデクスを格納するRDエリアを指定します。

RDエリアの指定を1〜12月に分けることで，1年（12か月）単位でRDエリアを循環的に割り当てられます。また，同じRDエリアを複数の月で指定することで，必要となるRDエリアを節約できます。

（例1）

SQLスクリプトファイル「CreateTables_HiRDB_for_Range.sql」で次の内容を定義する例を示します。

　扱うデータの単位：1か月

　循環割り当て期間：3か月単位

テーブルの定義例

IN
  ((RDDATA1)'01', /* 1月のデータを格納するRDエリア */
   (RDDATA2)'02', /* 2月のデータを格納するRDエリア */
   (RDDATA3)'03', /* 3月のデータを格納するRDエリア */
   (RDDATA1)'04', /* 4月のデータを格納するRDエリア */
   (RDDATA2)'05', /* 5月のデータを格納するRDエリア */
   (RDDATA3)'06', /* 6月のデータを格納するRDエリア */
   (RDDATA1)'07', /* 7月のデータを格納するRDエリア */
   (RDDATA2)'08', /* 8月のデータを格納するRDエリア */
   (RDDATA3)'09', /* 9月のデータを格納するRDエリア */
   (RDDATA1)'10', /* 10月のデータを格納するRDエリア */
   (RDDATA2)'11', /* 11月のデータを格納するRDエリア */
   (RDDATA3));    /* 12月のデータを格納するRDエリア */

インデクスの定義例

IN
  ((RDINDEX1), /* 1月のインデクスを格納するRDエリア */
   (RDINDEX2), /* 2月のインデクスを格納するRDエリア */
   (RDINDEX3), /* 3月のインデクスを格納するRDエリア */
   (RDINDEX1), /* 4月のインデクスを格納するRDエリア */
   (RDINDEX2), /* 5月のインデクスを格納するRDエリア */
   (RDINDEX3), /* 6月のインデクスを格納するRDエリア */
   (RDINDEX1), /* 7月のインデクスを格納するRDエリア */
   (RDINDEX2), /* 8月のインデクスを格納するRDエリア */
   (RDINDEX3), /* 9月のインデクスを格納するRDエリア */
   (RDINDEX1), /* 10月のインデクスを格納するRDエリア */
   (RDINDEX2), /* 11月のインデクスを格納するRDエリア */
   (RDINDEX3));/* 12月のインデクスを格納するRDエリア */

（例2）

SQLスクリプトファイル「CreateTables_HiRDB_for_Matrix.sql」で次の内容を定義する例を示します。

　扱うデータの単位：1か月

　循環割り当て期間：3か月単位

　バックエンドサーバ：3台

テーブルの定義例

IN
  ((BES1RDDATA1,BES2RDDATA1,BES3RDDATA1), /* 1月のデータを格納するRDエリア */
   (BES1RDDATA2,BES2RDDATA2,BES3RDDATA2), /* 2月のデータを格納するRDエリア */
   (BES1RDDATA3,BES2RDDATA3,BES3RDDATA3), /* 3月のデータを格納するRDエリア */
   (BES1RDDATA1,BES2RDDATA1,BES3RDDATA1), /* 4月のデータを格納するRDエリア */
   (BES1RDDATA2,BES2RDDATA2,BES3RDDATA2), /* 5月のデータを格納するRDエリア */
   (BES1RDDATA3,BES2RDDATA3,BES3RDDATA3), /* 6月のデータを格納するRDエリア */
   (BES1RDDATA1,BES2RDDATA1,BES3RDDATA1), /* 7月のデータを格納するRDエリア */
   (BES1RDDATA2,BES2RDDATA2,BES3RDDATA2), /* 8月のデータを格納するRDエリア */
   (BES1RDDATA3,BES2RDDATA3,BES3RDDATA3), /* 9月のデータを格納するRDエリア */
   (BES1RDDATA1,BES2RDDATA1,BES3RDDATA1), /* 10月のデータを格納するRDエリア */
   (BES1RDDATA2,BES2RDDATA2,BES3RDDATA2), /* 11月のデータを格納するRDエリア */
   (BES1RDDATA3,BES2RDDATA3,BES3RDDATA3));/* 12月のデータを格納するRDエリア */

インデクスの定義例

IN
  ((BES1RDINDEX1,BES2RDINDEX1,BES3RDINDEX1), /* 1月のインデクスを格納するRDエリア */
   (BES1RDINDEX2,BES2RDINDEX2,BES3RDINDEX2), /* 2月のインデクスを格納するRDエリア */
   (BES1RDINDEX3,BES2RDINDEX3,BES3RDINDEX3), /* 3月のインデクスを格納するRDエリア */
   (BES1RDINDEX1,BES2RDINDEX1,BES3RDINDEX1), /* 4月のインデクスを格納するRDエリア */
   (BES1RDINDEX2,BES2RDINDEX2,BES3RDINDEX2), /* 5月のインデクスを格納するRDエリア */
   (BES1RDINDEX3,BES2RDINDEX3,BES3RDINDEX3), /* 6月のインデクスを格納するRDエリア */
   (BES1RDINDEX1,BES2RDINDEX1,BES3RDINDEX1), /* 7月のインデクスを格納するRDエリア */
   (BES1RDINDEX2,BES2RDINDEX2,BES3RDINDEX2), /* 8月のインデクスを格納するRDエリア */
   (BES1RDINDEX3,BES2RDINDEX3,BES3RDINDEX3), /* 9月のインデクスを格納するRDエリア */
   (BES1RDINDEX1,BES2RDINDEX1,BES3RDINDEX1), /* 10月のインデクスを格納するRDエリア */
   (BES1RDINDEX2,BES2RDINDEX2,BES3RDINDEX2), /* 11月のインデクスを格納するRDエリア */
   (BES1RDINDEX3,BES2RDINDEX3,BES3RDINDEX3));/* 12月のインデクスを格納するRDエリア */

なお，テーブル分割機能（レンジ分割またはマトリクス分割）を使用し，さらにcscpiselectコマンドの-whereオプションまたは-wherefileオプションでSplitKeyを探索条件として指定する場合，SQLスクリプトファイルのCREATE VIEWを変更する必要があります。コマンドとビュー表の関係については，マニュアル「サービスプラットフォーム リファレンス」の「cscpiselect（プロセスインスタンスの検索）」を参照してください。cscpiselectコマンドの探索条件にSplitKeyを指定しない場合は，処理性能に影響を及ぼさないよう，CREATE VIEWを変更しないことをお勧めします。

（例3）

CSCBP_<individualname>_V_ACTIVITYビュー表の定義例を次に示します。

CREATE VIEW CSCBP_<individualname>_V_ACTIVITY
(
    ProcessID,
    ActivityNumber,
    ProcessDefinitionName,
    ProcessDefinitionVersion,
    ActivityDefinitionName,
    ActivityKind,
    ParentNumber,
    ScopeNumber,
    RepeatNumber,
    State,
    FirstChildNumber,
    LastChildNumber,
    StartTime,
    EndTime,
    WaitTime,
    CSCServerName,
    SplitKey                                      …… ※1
) AS SELECT a.ProcessID,
            a.ActivityNumber,
            p.ProcessDefinitionName,
            p.ProcessDefinitionVersion,
            a.ActivityDefinitionName,
            a.ActivityKind,
            a.ParentNumber,
            a.ScopeNumber,
            a.RepeatNumber,
            a.State,
            a.FirstChildNumber,
            a.LastChildNumber,
            a.StartTime,
            a.EndTime,
            a.WaitTime,
            p.CSCServerName,
            p.SplitKey                             …… ※2
     FROM CSCBP_<individualname>_ACTIVITY a, CSCBP_<individualname>_PROCESS p
     WHERE a.ProcessID = p.ProcessID;

注※1

「付録C.1(4)　ビュー表の情報」の内容に従って，構成列の最後にSplitKey列を追加してください。

注※2

「付録C.1(4)　ビュー表の情報」の内容に従って，参照先テーブルのカラム名を設定してください。

(b)　Oracleの場合

SQLスクリプトファイル内にある，各テーブル，またはインデクスの次の個所を書き換えます。表領域を指定しない場合は，「TABLESPACE <EXAMPLE>」を削除します。

TABLESPACE <EXAMPLE>

使用する表領域（テーブルスペース），またはmessage変数テーブル内のmessage変数の値（BLOB）を格納する表領域を指定します。

付録D.3　SQLスクリプトファイル設定時の注意事項

SQLスクリプトファイル設定時の注意事項を次に示します。ここに示す注意事項に反した場合，動作は保証されません。

次に示すように，各テーブルの列名，データ型，および制約キーは変更できません。また，列の順番は入れ替えられません。

（例）

列名：CSC_SERVER_NAME，CSC_SERVER_STATUS　など

データ型：VARCHAR2(8)，NUMBER(10,0)　など

制約キー：NOT NULL指定，UNIQUE指定　など

テーブル，およびインデクス作成の順番は変更できません。

テンプレートで定義されているインデクス，ビュー表，テーブルは削除できません。削除した場合または<individualname>の置換方法を誤った場合，HCSCサーバのセットアップ時にエラーになります。

横分割機能を利用する場合だけビュー表に列を追加できます。なお，追加する列の定義内容は，「付録C.1　プロセスインスタンスの実行履歴の管理に関するテーブルの情報」と合わせてください。

「/*」から「*/」までの範囲は注釈と見なされ，SQLを発行する際には削除されます。

単純注釈（「--」で始まる注釈）は使用できません。使用すると，正しく動作しないおそれがあります。

引用符（「”」または「’」）は使用できません。使用すると，正しく動作しないおそれがあります。

付録E　HCSCサーバのリソース稼働情報の統計情報

HCSCサーバのリソース稼働情報は，統計情報として参照できます。統計情報を参照するには，サービスプラットフォームで出力している稼働情報ファイルを利用します。

稼働情報ファイルとは，J2EEサーバ，およびバッチサーバ内の稼働情報が定期的に出力されるファイルです。このファイルに，HCSCサーバのリソース稼働情報も記録されています。稼働情報ファイルの詳細については，マニュアル「アプリケーションサーバ機能解説 運用／監視／連携編」の「3.3　稼働情報ファイルの出力機能」を参照してください。

付録E.1　稼働情報ファイルの出力

(1)　稼働情報ファイルの出力先

稼働情報ファイルは，デフォルトの設定の場合，次のフォルダに作成されます。

Windowsの場合

<作業ディレクトリ>※¥ejb¥<J2EEサーバ名称>¥stats

<作業ディレクトリ>のデフォルト値

<サービスプラットフォームのインストールディレクトリ>¥CC¥server¥public

UNIXの場合

<作業ディレクトリ>※/ejb/<J2EEサーバ名称>/stats

<作業ディレクトリ>のデフォルト値

/opt/Cosminexus/CC/server/public

注※

<作業ディレクトリ>は，次のどちらかの方法で確認できます。

運用環境ポータルから確認する場合

［J2EEコンテナの設定］画面で確認します。詳細については，マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「10.8.2　J2EEコンテナの設定」を参照してください。

簡易構築定義ファイルから確認する場合

簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に指定されている，ejb.public.directoryパラメタで確認します。詳細については，マニュアル「アプリケーションサーバリファレンス 定義編(サーバ定義)」の「4.3　簡易構築定義ファイル」を参照してください。

(2)　HCSCサーバの各リソースの稼働情報ファイル

HCSCサーバの各リソースの稼働情報ファイル，ヘッダファイル，およびObjectNameの識別値を次の表に示します。

表E‒1　HCSCサーバの各リソースの稼働情報ファイル

リソース名

稼働情報ファイル

ヘッダファイル

ObjectNameの識別値※

JavaVM

HJVMStats_<YYYYMMDDhhmm><TZ>.csv

HJVMStats.txt

−

DBコネクション

HJCAConnectionPoolStats_<YYYYMMDDhhmm><TZ>.csv

HJCAConnectionPoolStats.txt

J2EEServer=<J2EEサーバ名>

ResourceAdapter=<リソースアダプタ表示名>

標準受付（Webサービス・SOAP1.1）

HWebModuleStats_<YYYYMMDDhhmm><TZ>.csv

HWebModuleStats.txt

SOAP1.1モードの場合

J2EEApplication=CSCMsgSyncServiceDeliveryWS

name=CSCMsgSyncServiceDeliveryWS

SOAP1.1/1.2併用モードの場合

J2EEApplication=CSCMsgSyncServiceDeliveryWS

name=CSCMsgSyncServiceDeliverySOAP11

標準受付（Webサービス・SOAP1.2）

HWebModuleStats_<YYYYMMDDhhmm><TZ>.csv

HWebModuleStats.txt

J2EEApplication=CSCMsgSyncServiceDeliveryWS

name=CSCMsgSyncServiceDeliverySOAP12

ユーザ定義受付

HWebModuleStats_<YYYYMMDDhhmm><TZ>.csv

HWebModuleStats.txt

J2EEApplication=<ユーザ定義受付の受付ID>

サービスアダプタ

HStatelessSessionBeanStats_<YYYYMMDDhhmm><TZ>.csv

HStatelessSessionBeanStats.txt

J2EEApplication=<サービスID>

ビジネスプロセス

HStatelessSessionBeanStats_<YYYYMMDDhhmm><TZ>.csv

HStatelessSessionBeanStats.txt

J2EEApplication=<サービスID>

name=CSCBPMessageReceiverEJB

（凡例）

−：識別値はありません。

注※

識別値が2つある場合は，2つで一意の値になります。

(3)　稼働情報ファイルの出力有無

稼働情報ファイルはデフォルトでは出力されるよう設定されています。

稼働情報ファイルの出力先ディレクトリや，稼働情報ファイルを出力するかどうかの設定を変更したい場合は，次に示すマニュアルを参照してください。

運用環境ポータルから変更する場合

マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「10.8.20　稼働情報監視の設定（J2EEサーバ）」を参照してください。

Smart Composer機能を使って変更する場合

マニュアル「アプリケーションサーバ 機能解説 運用／監視／連携編」の「3.3　稼働情報ファイルの出力機能」と「3.4　イベントの発行機能」を参照してください。

付録E.2　統計情報の参照手順

統計情報の参照手順を次に示します。

統計情報を参照したいリソースを次の中から決定します。

JavaVM

DBコネクション

標準受付（Webサービス）

ユーザ定義受付

サービスアダプタ

ビジネスプロセス

参照したいリソースに対応する稼働情報ファイルとヘッダファイルを，稼働情報ファイルの出力先から任意のディレクトリにコピーします。

稼働情報ファイルの出力先と，各リソースの稼働情報ファイルとヘッダファイルについては，「付録E.1　稼働情報ファイルの出力」を参照してください。

手順2でコピーした稼働情報ファイルとヘッダファイルを1つのファイルに編集し，Excelなどのアプリケーションプログラムで参照します。

ObjectNameの識別値から，統計情報を参照したいリソースを探します。

Excelを使用する場合，1つに編集したファイルのヘッダにフィルタを設定し，ObjectNameの識別値から統計情報を参照したいリソースを選択します。

ObjectNameの識別値とリソースの対応については，「付録E.1　稼働情報ファイルの出力」を参照してください。

手順4で探したリソースの稼働情報の種類を特定します。

リソースの稼働情報の種類は，ヘッダファイルの項目名から特定します。リソースの稼働情報の種類と，ヘッダファイルの項目名の対応については，「付録E.3　リソースの稼働情報の種類」を参照してください。

付録E.3　リソースの稼働情報の種類

リソースの稼働情報の種類は，リソースによって異なります。リソースの稼働情報の種類と，ヘッダファイルの項目名の対応を次の表に示します。

表E‒2　リソースの稼働情報の種類とヘッダファイルの項目名の対応

リソース名

リソースの稼働情報の種類

ヘッダファイルの項目名

JavaVM

ヒープサイズ

上限値

HeapSize.UpperBound

最大値

HeapSize.HighWaterMark

DBコネクション

コネクション数

上限値

PoolSize.UpperBound

最大値

PoolSize.HighWaterMark

標準受付（Webサービス・SOAP1.1）

標準受付（Webサービス・SOAP1.2）

ユーザ定義受付

キュー滞留数

上限値

WaitingRequestCount.UpperBound

最大値

WaitingRequestCount.HighWaterMark

実行数

上限値

ActiveThreadCount.UpperBound

最大値

ActiveThreadCount.HighWaterMark

サービスアダプタ

ビジネスプロセス

実行数

上限値

ActivePooledInstanceCount.UpperBound

最大値

ActivePooledInstanceCount.HighWaterMark

付録F　JP1イベント通知をするメッセージ

JP1連携機能を使用した場合，サービスプラットフォームで発生した障害のメッセージをJP1イベントとしてJP1に通知します。JP1イベント通知の有無は，メッセージマッピングファイルの編集で自由に変更できます。メッセージマッピングファイルの編集については，「2.8.5　メッセージマッピングファイルの編集」を参照してください。

サービスプラットフォームで出力されるメッセージのIDと，初期値で設定されているJP1イベント通知の有無について，メッセージID順に次に示します。

付録F.1　KDEC00001〜KDEC19999のメッセージ（メッセージング基盤に関するメッセージ）

メッセージID

JP1イベント通知の有無

KDEC00001

○

KDEC00002

○

KDEC00003

○

KDEC00005

△

KDEC00010

△

KDEC00011

△

KDEC00012

△

KDEC00013

△

KDEC00014

△

KDEC00016

△

KDEC00018

△

KDEC00019

△

KDEC00020

△

KDEC00021

△

KDEC00022

△

KDEC00023

△

KDEC00024

△

KDEC00025

△

KDEC00026

△

KDEC00027

△

KDEC00028

△

KDEC00029

△

KDEC00030

△

KDEC00031

△

KDEC00032

△

KDEC00033

△

KDEC00034

△

KDEC00035

△

KDEC00036

△

KDEC00037

○

KDEC00038

○

KDEC00039

△

KDEC00040

△

KDEC00041

△

KDEC00042

△

KDEC00043

△

KDEC00044

△

KDEC00045

△

KDEC00046

△

KDEC00047

×

KDEC00048

×

KDEC00049

△

KDEC00050

○

KDEC00051

○

KDEC00052

○

KDEC00053

○

KDEC00054

○

KDEC00055

○

KDEC00056

○

KDEC00057

○

KDEC00058

○

KDEC00059

○

KDEC00060

○

KDEC00061

○

KDEC00062

○

KDEC00063

○

KDEC00064

○

KDEC00065

△

KDEC00351

×

KDEC00361

○

KDEC00362

○

KDEC00363

○

KDEC00364

○

KDEC00365

○

KDEC00366

○

KDEC00371

×

KDEC00372

×

KDEC00381

×

KDEC00382

○

KDEC00383

○

KDEC00384

○

KDEC00385

○

KDEC00386

○

KDEC00387

○

KDEC00388

×

KDEC00391

○

KDEC00392

○

KDEC00393

○

KDEC00394

○

KDEC00395

○

KDEC00396

○

KDEC00397

○

KDEC00398

×

KDEC00399

○

KDEC00400

○

KDEC00401

○

KDEC00402

○

KDEC00403

○

KDEC00404

×

KDEC00405

×

KDEC00406

○

KDEC00407

○

KDEC00408

×

KDEC00409

×

KDEC00410

×

KDEC00411

○

KDEC00412

○

KDEC00413

○

KDEC00414

×

KDEC00415

○

KDEC00421

×

KDEC00423

○

KDEC00424

○

KDEC00425

○

KDEC00426

○

KDEC00441

○

KDEC00442

○

KDEC00443

○

KDEC00444

○

KDEC00445

△

KDEC00446

○

KDEC00447

×

KDEC00448

○

KDEC00449

○

KDEC00450

○

KDEC00451

○

KDEC00452

○

KDEC00453

×

KDEC00454

△

KDEC00455

○

KDEC00456

○

KDEC00457

△

KDEC00458

○

KDEC00459

○

KDEC00460

○

KDEC00461

△

KDEC00462

○

KDEC00463

○

KDEC00464

○

KDEC00465

○

KDEC00466

×

KDEC00501

△

KDEC00502

△

KDEC00503

△

KDEC00504

△

KDEC00505

△

KDEC00506

△

KDEC00508

△

KDEC00509

×

KDEC00510

×

KDEC00511

×

KDEC00512

△

KDEC00513

△

KDEC00514

△

KDEC00515

△

KDEC00516

△

KDEC00517

△

KDEC00518

△

KDEC00519

△

KDEC00520

△

KDEC00521

△

KDEC00522

△

KDEC00523

△

KDEC00524

△

KDEC00525

△

KDEC00526

△

KDEC00527

△

KDEC00528

△

KDEC01001

△

KDEC01002

△

KDEC01003

△

KDEC01004

△

KDEC01005

△

KDEC01006

△

KDEC01007

△

KDEC01008

△

KDEC01009

△

KDEC01011

△

KDEC01012

×

KDEC01013

△

KDEC01015

△

KDEC01016

△

KDEC01017

△

KDEC01018

△

KDEC01019

△

KDEC01020

△

KDEC01021

△

KDEC01022

△

KDEC01023

△

KDEC01024

△

KDEC01025

△

KDEC01026

△

KDEC01501

△

KDEC01502

△

KDEC01503

△

KDEC01504

△

KDEC01505

△

KDEC01506

△

KDEC01507

△

KDEC01508

△

KDEC01509

△

KDEC01510

△

KDEC01511

△

KDEC01512

△

KDEC01513

△

KDEC01514

△

KDEC01515

△

KDEC01516

△

KDEC01517

△

KDEC01518

△

KDEC01519

△

KDEC01520

△

KDEC01521

△

KDEC01522

△

KDEC02001

△

KDEC02002

△

KDEC02003

△

KDEC02004

△

KDEC02005

△

KDEC02501

○

KDEC02502

○

KDEC02503

○

KDEC02504

○

KDEC02511

△

KDEC02512

△

KDEC02513

△

KDEC02514

△

KDEC02515

△

KDEC02516

△

KDEC02517

△

KDEC02518

△

KDEC02519

△

KDEC02520

△

KDEC02521

△

KDEC02523

△

KDEC02524

△

KDEC02525

△

KDEC02526

○

KDEC02527

○

KDEC02528

○

KDEC03001

△

KDEC03002

△

KDEC03003

△

KDEC03005

△

KDEC03006

△

KDEC03007

△

KDEC03011

△

KDEC03012

△

KDEC03013

△

KDEC03014

△

KDEC03015

△

KDEC03016

△

KDEC03017

△

KDEC03018

△

KDEC03019

△

KDEC03020

△

KDEC03021

△

KDEC03022

△

KDEC03023

△

KDEC03024

△

KDEC03025

△

KDEC03026

△

KDEC03027

△

KDEC03028

△

KDEC03029

△

KDEC03030

△

KDEC03031

△

KDEC03032

△

KDEC03033

△

KDEC03034

△

KDEC03035

△

KDEC03036

△

KDEC03037

△

KDEC04501

○

KDEC04502

○

KDEC04503

○

KDEC04504

○

KDEC04505

○

KDEC04506

○

KDEC04510

○

KDEC04511

○

KDEC04512

○

KDEC04513

○

KDEC04514

○

KDEC04515

○

KDEC04516

○

KDEC04517

○

KDEC04518

○

KDEC04519

○

KDEC04520

△

KDEC04601

×

KDEC04602

×

KDEC04603

×

KDEC04604

×

KDEC04605

×

KDEC04609

○

KDEC04611

△

KDEC04612

○

KDEC05001

△

KDEC05002

△

KDEC05003

△

KDEC05004

△

KDEC05005

△

KDEC05006

△

KDEC05008

△

KDEC05009

△

KDEC05010

△

KDEC05011

△

KDEC05012

△

KDEC05013

△

KDEC05014

△

KDEC05015

×

KDEC05016

×

KDEC05101

△

KDEC05102

△

KDEC05103

△

KDEC05104

△

KDEC05105

△

KDEC05106

△

KDEC05107

△

KDEC05108

△

KDEC05201

△

KDEC05202

△

KDEC05203

△

KDEC05204

△

KDEC05205

△

KDEC05206

△

KDEC05207

△

KDEC05208

△

KDEC05209

△

KDEC05210

△

KDEC05211

△

KDEC05212

△

KDEC05213

×

KDEC05214

○

KDEC05215

△

KDEC05301

×

KDEC05302

×

KDEC05303

×

KDEC05304

×

KDEC05305

×

KDEC05306

×

KDEC05307

×

KDEC05308

×

KDEC05309

×

KDEC05310

×

KDEC05311

×

KDEC05312

×

KDEC05313

×

KDEC05314

×

KDEC05315

×

KDEC05316

×

KDEC05317

×

KDEC05501

△

KDEC05502

△

KDEC05503

△

KDEC05504

△

KDEC05505

△

KDEC05506

△

KDEC06001

△

KDEC06002

△

KDEC06003

△

KDEC06004

△

KDEC06005

△

KDEC06006

△

KDEC06007

△

KDEC06008

△

KDEC06009

△

KDEC06010

△

KDEC06011

△

KDEC06012

△

KDEC06013

△

KDEC06014

△

KDEC06501

△

KDEC06502

△

KDEC06504

△

KDEC06505

△

KDEC06506

△

KDEC06507

△

KDEC06509

△

KDEC06510

△

KDEC06511

△

KDEC06512

△

KDEC06513

△

KDEC06601

△

KDEC06602

△

KDEC06603

△

KDEC06604

△

KDEC06605

△

KDEC06606

△

KDEC06607

△

KDEC06608

△

KDEC06609

△

KDEC06610

△

KDEC06611

△

KDEC06612

△

KDEC06613

△

KDEC06614

△

KDEC07001

○

KDEC07002

○

KDEC07003

○

KDEC07004

×

KDEC07005

×

KDEC07006

○

KDEC07007

○

KDEC07008

○

KDEC07501

×

KDEC07506

×

KDEC07507

×

KDEC07508

×

KDEC07509

×

KDEC07510

×

KDEC07511

×

KDEC07512

×

KDEC07513

×

KDEC07514

×

KDEC07515

×

KDEC07516

×

KDEC07517

×

KDEC07520

×

KDEC07521

×

KDEC07522

×

KDEC07523

×

KDEC07524

×

KDEC07525

×

KDEC07526

×

KDEC07527

×

KDEC07528

×

KDEC07529

×

KDEC07530

×

KDEC07531

×

KDEC07532

×

KDEC07533

×

KDEC07539

×

KDEC07540

×

KDEC07541

×

KDEC07542

×

KDEC07543

×

KDEC07544

×

KDEC07545

×

KDEC07546

×

KDEC07548

×

KDEC07549

×

KDEC07550

×

KDEC07551

×

KDEC07552

×

KDEC07553

×

KDEC07554

×

KDEC07555

×

KDEC07556

×

KDEC07557

×

KDEC07558

×

KDEC07559

×

KDEC07560

×

KDEC07563

×

KDEC07564

×

KDEC07565

×

KDEC07566

×

KDEC07567

×

KDEC07568

×

KDEC07569

×

KDEC07570

×

KDEC07571

×

KDEC07572

×

KDEC07573

×

KDEC07574

×

KDEC07575

×

KDEC07576

×

KDEC07577

×

KDEC07578

×

KDEC07579

×

KDEC07580

×

KDEC07581

×

KDEC07585

×

KDEC07586

×

KDEC07587

×

KDEC07588

×

KDEC07589

×

KDEC07590

×

KDEC07591

×

KDEC07592

×

KDEC07593

×

KDEC07594

×

KDEC07595

×

KDEC07596

×

KDEC07608

×

KDEC07609

×

KDEC07610

×

KDEC07611

×

KDEC07612

×

KDEC07613

×

KDEC07614

×

KDEC07615

×

KDEC07701

×

KDEC07702

×

KDEC07703

×

KDEC07704

×

KDEC07705

×

KDEC07706

×

KDEC07707

×

KDEC07708

×

KDEC07709

×

KDEC07710

×

KDEC07716

×

KDEC07717

×

KDEC07720

×

KDEC07721

×

KDEC07722

×

KDEC07723

×

KDEC07724

×

KDEC07741

×

KDEC07743

×

KDEC07744

×

KDEC07750

×

KDEC07801

×

KDEC07802

×

KDEC07803

×

KDEC07811

×

KDEC07812

×

KDEC07821

×

KDEC07822

×

KDEC07823

×

KDEC07832

×

KDEC07834

×

KDEC07841

×

KDEC07842

×

KDEC07844

×

KDEC07846

×

KDEC07848

×

KDEC07849

×

KDEC07850

×

KDEC07899

×

KDEC10001

×

KDEC10002

×

KDEC10003

×

KDEC10004

×

KDEC10005

×

KDEC10006

×

KDEC10007

×

KDEC10008

×

KDEC10009

×

KDEC10010

×

KDEC10011

×

KDEC10012

×

KDEC10013

×

KDEC10014

×

KDEC10015

×

KDEC10016

×

KDEC10017

×

KDEC10020

×

KDEC10021

×

KDEC10022

×

KDEC10023

×

KDEC10024

×

KDEC10025

×

KDEC10026

×

KDEC10027

×

KDEC10028

×

KDEC10029

×

KDEC10030

×

KDEC10031

×

KDEC10033

×

KDEC10034

×

KDEC10035

×

KDEC10036

×

KDEC10037

×

KDEC10038

×

KDEC10039

×

KDEC10040

×

KDEC10041

×

KDEC10042

×

KDEC10043

×

KDEC10044

×

KDEC10045

×

KDEC10046

×

KDEC10047

×

KDEC10048

×

KDEC10049

×

KDEC10050

×

KDEC10051

×

KDEC10052

×

KDEC10053

×

KDEC10054

×

KDEC10055

×

KDEC10056

×

KDEC10057

×

KDEC10058

×

KDEC10059

×

KDEC10060

×

KDEC10061

×

KDEC10062

×

KDEC10063

×

KDEC10064

×

KDEC10065

×

KDEC10066

×

KDEC10067

×

KDEC10068

×

KDEC10069

×

KDEC10070

×

KDEC10071

×

KDEC10072

×

KDEC10073

×

KDEC10074

×

KDEC10075

×

KDEC10076

×

KDEC10077

×

KDEC10078

×

KDEC10079

×

KDEC10080

×

KDEC10081

×

KDEC10082

×

KDEC10083

×

KDEC10084

×

KDEC10085

×

KDEC10086

×

KDEC10087

×

KDEC10088

×

KDEC10089

×

KDEC10090

×

KDEC10091

×

KDEC10092

×

KDEC10093

×

KDEC10094

×

KDEC10095

×

KDEC10096

×

KDEC10097

×

KDEC10098

×

KDEC10099

×

KDEC10100

×

KDEC10101

×

KDEC10102

×

KDEC10105

×

KDEC10106

×

KDEC10400

×

KDEC10401

×

KDEC10403

×

KDEC10407

×

KDEC10408

×

KDEC10409

×

KDEC10410

×

KDEC10411

×

KDEC10501

×

KDEC10502

×

KDEC11001

×

KDEC11002

×

KDEC11003

×

KDEC11101

○

KDEC11201

○

KDEC11202

○

KDEC11301

△

KDEC11302

△

KDEC11303

△

KDEC11304

△

KDEC11305

△

KDEC11306

△

KDEC11307

△

KDEC11308

△

KDEC11309

△

KDEC11310

△

KDEC11311

△

KDEC11312

△

KDEC11313

△

KDEC11314

△

KDEC11315

△

KDEC11316

○

KDEC11317

○

KDEC11318

○

KDEC11319

○

KDEC11320

○

KDEC11321

○

KDEC11322

○

KDEC11323

○

KDEC11324

○

KDEC11325

○

KDEC11326

○

KDEC11327

○

KDEC11328

○

KDEC11329

△

KDEC11330

△

KDEC11331

△

KDEC11332

△

KDEC11333

△

KDEC11334

△

KDEC11335

△

KDEC11336

△

KDEC11337

△

KDEC11338

△

KDEC11339

△

KDEC11340

△

KDEC11341

△

KDEC11342

△

KDEC11343

△

KDEC11344

○

KDEC11345

○

KDEC11346

○

KDEC11347

○

KDEC11348

○

KDEC11349

○

KDEC11350

○

KDEC11351

○

KDEC11352

○

KDEC11353

○

KDEC11354

○

KDEC11355

○

KDEC11356

○

KDEC11357

×

KDEC11358

×

KDEC11359

×

KDEC11360

×

KDEC11361

×

KDEC11362

×

KDEC11363

×

KDEC11364

×

KDEC11365

×

KDEC11366

×

KDEC11367

×

KDEC11368

×

KDEC11369

×

KDEC11401

×

KDEC11402

×

KDEC11403

×

KDEC11404

×

KDEC11405

×

KDEC11406

×

KDEC11407

×

KDEC11408

×

KDEC11409

×

KDEC11410

×

KDEC11411

×

KDEC11412

×

KDEC11413

×

KDEC19901

○

KDEC19902

○

KDEC19903

○

（凡例）

○：通知します。

△：コメント付きで定義されています。通知したい場合は，コメントをはずしてください。

×：通知しません。

付録F.2　KDEC20000〜KDEC39999のメッセージ（ビジネスプロセス基盤に関するメッセージ）

メッセージID

JP1イベント通知の有無

KDEC20000

○

KDEC20001

○

KDEC20002

△

KDEC20003

△

KDEC20004

○

KDEC20005

○

KDEC20006

×

KDEC20007

△

KDEC20008

△

KDEC20009

○

KDEC20010

○

KDEC20012

○

KDEC20013

×

KDEC20014

○

KDEC20015

○

KDEC20016

△

KDEC20017

△

KDEC20018

△

KDEC20023

×

KDEC20024

△

KDEC20025

△

KDEC20026

△

KDEC20027

○

KDEC20028

△

KDEC20029

○

KDEC20030

△

KDEC20031

△

KDEC20032

△

KDEC20033

○

KDEC20034

△

KDEC20035

○

KDEC20036

×

KDEC20037

△

KDEC20038

×

KDEC20039

△

KDEC20040

△

KDEC20041

△

KDEC20042

△

KDEC20043

△

KDEC20044

△

KDEC20045

△

KDEC20046

○

KDEC20047

○

KDEC20048

○

KDEC20049

○

KDEC20051

△

KDEC20052

△

KDEC20053

△

KDEC20054

△

KDEC20055

△

KDEC20056

△

KDEC20057

△

KDEC20058

○

KDEC20059

○

KDEC20060

△

KDEC20061

△

KDEC20062

△

KDEC20063

△

KDEC20065

△

KDEC20066

△

KDEC20067

△

KDEC20068

○

KDEC20069

×

KDEC20070

○

KDEC20071

△

KDEC20072

△

KDEC20073

△

KDEC20074

△

KDEC20075

△

KDEC20076

△

KDEC20077

△

KDEC20078

×

KDEC20079

○

KDEC20080

○

KDEC20081

△

KDEC20082

△

KDEC20083

△

KDEC20084

△

KDEC20085

×

KDEC20087

×

KDEC20088

○

KDEC20090

×

KDEC20091

△

KDEC20092

×

KDEC20093

○

KDEC20094

○

KDEC20095

○

KDEC20096

○

KDEC20097

×

KDEC20098

△

KDEC30000

×

KDEC30001

×

KDEC30002

×

KDEC30003

×

KDEC30004

×

KDEC30005

×

KDEC30006

×

KDEC30007

×

KDEC30008

×

KDEC35000

×

KDEC35001

×

KDEC35002

×

KDEC35003

×

KDEC35004

×

KDEC35005

×

KDEC35006

×

KDEC35007

×

KDEC35008

×

KDEC35009

×

KDEC35011

×

KDEC35012

×

KDEC35013

×

KDEC35014

×

KDEC35015

△

KDEC35016

△

KDEC36000

×

KDEC36001

×

KDEC36002

×

KDEC36004

×

KDEC36005

×

（凡例）

○：通知します。

△：コメント付きで定義されています。通知したい場合は，コメントをはずしてください。

×：通知しません。

付録F.3　KDEC40000〜KDEC59999のメッセージ（データ変換基盤に関するメッセージ）

KDEC40000〜KDEC59999のメッセージはすべてJP1イベント通知をします。

付録F.4　KDEC60000〜KDEC79999のメッセージ（DBアダプタに関するメッセージ）

メッセージID

JP1イベント通知の有無

KDEC60000

○

KDEC60001

○

KDEC60002

△

KDEC60003

△

KDEC60004

×

KDEC60005

○

KDEC60006

△

KDEC62000

△

KDEC62001

△

KDEC63000

○

KDEC63001

○

KDEC63002

○

KDEC63003

△

KDEC64000

○

KDEC64001

○

KDEC64002

○

KDEC64003

○

KDEC64004

○

KDEC64005

○

KDEC64006

○

KDEC64007

○

KDEC64008

○

KDEC64009

○

KDEC64010

○

KDEC64011

○

KDEC64012

○

KDEC66000

○

KDEC66001

△

KDEC66002

○

KDEC66003

○

KDEC66004

○

KDEC66005

○

KDEC66006

○

KDEC66007

○

KDEC68000

×

KDEC68001

×

KDEC68002

×

KDEC68003

×

KDEC68004

×

KDEC68005

×

KDEC68006

×

KDEC68007

×

KDEC68008

×

KDEC68009

×

KDEC68010

×

KDEC68011

×

KDEC68020

×

KDEC68021

×

KDEC68022

×

KDEC68023

×

KDEC68024

×

KDEC68025

×

KDEC68026

×

KDEC68027

×

KDEC68028

×

KDEC68029

×

KDEC68030

×

KDEC68031

×

KDEC68032

×

KDEC68099

×

KDEC70002

○

KDEC70003

△

KDEC70004

△

KDEC70005

△

KDEC70006

△

KDEC79000

○

（凡例）

○：通知します。

△：コメント付きで定義されています。通知したい場合は，コメントをはずしてください。

×：通知しません。

付録F.5　KDEC80000〜KDEC80399のメッセージ（ファイル操作アダプタに関するメッセージ）

メッセージID

JP1イベント通知の有無

KDEC80000

○

KDEC80001

○

KDEC80002

○

KDEC80003

○

KDEC80004

○

KDEC80005

○

KDEC80006

○

KDEC80007

○

KDEC80008

○

KDEC80009

○

KDEC80010

○

KDEC80011

○

KDEC80012

○

KDEC80013

○

KDEC80014

○

KDEC80015

×

KDEC80016

×

KDEC80017

×

KDEC80018

○

KDEC80019

○

KDEC80020

○

KDEC80021

○

KDEC80022

○

KDEC80023

○

KDEC80024

×

KDEC80025

×

KDEC80026

×

KDEC80027

○

KDEC80028

○

KDEC80029

○

KDEC80030

×

KDEC80031

○

KDEC80032

○

KDEC80033

○

KDEC80034

○

KDEC80035

○

KDEC80036

×

KDEC80037

○

KDEC80038

○

KDEC80039

○

KDEC80040

×

KDEC80041

○

KDEC80043

○

KDEC80044

○

KDEC80045

×

KDEC80046

○

KDEC80047

○

KDEC80049

○

KDEC80050

○

KDEC80051

○

KDEC80052

○

KDEC80053

○

KDEC80054

○

KDEC80055

○

KDEC80056

○

KDEC80057

○

KDEC80058

○

KDEC80059

○

KDEC80060

○

KDEC80061

○

KDEC80062

○

KDEC80081

○

KDEC80082

×

KDEC80084

○

KDEC80085

×

KDEC80086

○

KDEC80087

○

KDEC80088

×

KDEC80090

○

KDEC80091

×

KDEC80101

○

KDEC80102

○

KDEC80103

×

KDEC80104

○

KDEC80105

○

KDEC80106

○

KDEC80107

○

KDEC80121

○

KDEC80122

○

KDEC80123

○

KDEC80125

○

KDEC80126

○

KDEC80127

○

KDEC80128

○

KDEC80129

○

KDEC80130

×

KDEC80131

×

KDEC80150

○

KDEC80151

○

KDEC80160

○

KDEC80161

○

KDEC80162

○

KDEC80170

○

KDEC80171

○

KDEC80172

○

KDEC80173

○

KDEC80180

○

KDEC80181

○

KDEC80182

○

KDEC80183

×

KDEC80201

○

KDEC80202

○

KDEC80205

○

（凡例）

○：通知します。

×：通知しません。

付録F.6　KDEC80400〜KDEC80499のメッセージ（HTTP受付に関するメッセージ）

メッセージID

JP1イベント通知の有無

KDEC80421

○

KDEC80422

○

KDEC80423

○

KDEC80424

○

KDEC80425

×

KDEC80426

×

KDEC80427

○

KDEC80428

○

KDEC80429

○

KDEC80430

×

KDEC80431

○

KDEC80432

×

KDEC80435

○

KDEC80436

○

KDEC80438

○

KDEC80439

○

KDEC80440

○

KDEC80441

○

KDEC80442

○

KDEC80443

○

KDEC80444

○

KDEC80445

○

KDEC80450

○

KDEC80452

○

KDEC80453

○

KDEC80454

○

KDEC80455

○

KDEC80456

○

KDEC80457

○

KDEC80458

○

KDEC80459

×

KDEC80460

○

KDEC80461

○

KDEC80462

○

KDEC80463

○

KDEC80464

○

KDEC80465

○

KDEC80466

○

KDEC80467

○

KDEC80468

○

KDEC80469

○

（凡例）

○：通知します。

×：通知しません。

付録F.7　KDEC80500〜KDEC80999のメッセージ（メールアダプタに関するメッセージ）

メッセージID

JP1イベント通知の有無

KDEC80500

×

KDEC80501

○

KDEC80502

○

KDEC80522

○

KDEC80523

○

KDEC80524

×

KDEC80525

○

KDEC80535

○

KDEC80536

○

KDEC80537

○

KDEC80540

×

KDEC80544

○

KDEC80545

○

KDEC80546

○

KDEC80548

○

KDEC80621

○

KDEC80622

○

KDEC80623

×

KDEC80624

×

KDEC80625

○

KDEC80626

×

KDEC80627

×

KDEC80628

○

KDEC80651

×

KDEC80672

×

KDEC80673

×

KDEC80701

○

KDEC80702

○

KDEC80703

○

KDEC80704

○

KDEC80705

○

KDEC80706

○

KDEC80707

○

KDEC80708

○

KDEC80709

○

KDEC80710

○

KDEC80711

○

KDEC80712

○

KDEC80720

○

KDEC80721

○

KDEC80726

×

KDEC80730

×

KDEC80731

○

KDEC80733

○

KDEC80734

○

KDEC80735

○

KDEC80736

○

KDEC80801

○

KDEC80802

○

KDEC80806

×

KDEC80807

×

KDEC80809

○

KDEC80810

○

KDEC80812

○

KDEC80813

○

KDEC80814

○

KDEC80815

○

KDEC80816

○

KDEC80817

○

KDEC80851

×

KDEC80852

×

KDEC80853

×

KDEC80854

×

KDEC80855

×

KDEC80856

×

KDEC80857

×

KDEC80858

×

KDEC80859

×

KDEC80860

×

KDEC80861

×

KDEC80862

×

KDEC80863

○

KDEC80864

○

KDEC80865

×

KDEC80866

○

KDEC80867

○

KDEC80868

○

KDEC80869

○

KDEC80870

○

KDEC80871

○

KDEC80873

○

KDEC80874

○

KDEC80875

○

KDEC80876

○

KDEC80877

○

KDEC80878

×

KDEC80879

○

KDEC80882

○

KDEC80883

○

KDEC80884

×

KDEC80886

×

KDEC80887

×

KDEC80888

×

KDEC80889

×

KDEC80890

○

KDEC80891

○

KDEC80892

○

KDEC80893

○

KDEC80902

×

（凡例）

○：通知します。

×：通知しません。

付録F.8　KDEC81000〜KDEC81499のメッセージ（HTTPアダプタに関するメッセージ）

メッセージID

JP1イベント通知の有無

KDEC81000

○

KDEC81001

○

KDEC81002

○

KDEC81003

○

KDEC81004

○

KDEC81005

○

KDEC81006

○

KDEC81007

○

KDEC81008

○

KDEC81009

○

KDEC81010

○

KDEC81011

○

KDEC81012

○

KDEC81051

○

KDEC81052

○

KDEC81053

○

KDEC81054

○

KDEC81055

○

KDEC81056

△

KDEC81057

○

KDEC81058

○

KDEC81059

○

KDEC81060

○

KDEC81061

○

KDEC81062

○

KDEC81063

○

KDEC81064

△

KDEC81065

△

KDEC81066

○

KDEC81069

○

KDEC81070

○

KDEC81071

△

KDEC81072

○

KDEC81100

○

KDEC81101

○

KDEC81102

○

KDEC81103

△

KDEC81104

△

KDEC81105

○

KDEC81106

○

KDEC81200

×

KDEC81201

×

KDEC81202

×

KDEC81203

×

KDEC81204

×

KDEC81205

×

KDEC81206

×

KDEC81207

×

KDEC81208

×

KDEC81209

×

KDEC81210

×

KDEC81211

×

KDEC81212

×

KDEC81213

×

KDEC81214

×

KDEC81215

×

KDEC81216

×

KDEC81217

×

KDEC81218

×

KDEC81219

×

KDEC81220

×

KDEC81221

×

KDEC81222

×

KDEC81223

×

KDEC81224

×

KDEC81225

×

KDEC81226

×

KDEC81227

×

KDEC81228

×

KDEC81229

×

KDEC81230

×

KDEC81231

×

KDEC81232

×

KDEC81233

×

KDEC81234

×

KDEC81235

×

KDEC81236

×

KDEC81237

×

KDEC81238

×

KDEC81239

×

KDEC81240

×

KDEC81241

×

KDEC81242

×

KDEC81243

×

KDEC81244

×

KDEC81245

×

KDEC81246

×

KDEC81247

×

KDEC81248

×

KDEC81249

×

KDEC81250

×

KDEC81251

×

KDEC81252

×

KDEC81401

○

KDEC81402

○

KDEC81403

△

KDEC81404

○

KDEC81450

×

KDEC81451

×

KDEC81452

×

KDEC81453

×

KDEC81454

△

KDEC81499

○

（凡例）

○：通知します。

△：コメント付きで定義されています。通知したい場合は，コメントをはずしてください。

×：通知しません。

付録F.9　KDEC81500〜KDEC81799のメッセージのメッセージ（コマンドアダプタに関するメッセージ）

メッセージID

JP1イベント通知の有無

KDEC81500

○

KDEC81510

○

KDEC81511

○

KDEC81512

○

KDEC81513

○

KDEC81514

○

KDEC81530

○

KDEC81531

○

KDEC81532

○

KDEC81533

○

KDEC81550

×

KDEC81551

×

KDEC81552

○

KDEC81553

○

KDEC81554

○

KDEC81555

○

KDEC81556

△

KDEC81557

○

KDEC81558

○

KDEC81559

△

KDEC81560

○

KDEC81561

○

KDEC81570

○

KDEC81571

○

KDEC81572

○

KDEC81573

△

KDEC81574

△

KDEC81575

○

KDEC81576

○

KDEC81600

○

KDEC81601

△

KDEC81602

△

KDEC81603

○

KDEC81620

×

KDEC81621

×

KDEC81622

×

KDEC81799

○

（凡例）

○：通知します。

△：コメント付きで定義されています。通知したい場合は，コメントをはずしてください。

×：通知しません。

付録F.10　KDEC82000〜KDEC82399のメッセージ（SFTPアダプタに関するメッセージ）

メッセージID

JP1イベント通知の有無

KDEC82000

×

KDEC82001

○

KDEC82002

○

KDEC82003

○

KDEC82005

○

KDEC82006

×

KDEC82007

○

KDEC82008

○

KDEC82009

○

KDEC82010

○

KDEC82011

○

KDEC82050

○

KDEC82080

×

KDEC82081

×

KDEC82082

×

KDEC82100

○

KDEC82101

○

KDEC82102

○

KDEC82103

○

KDEC82104

○

KDEC82105

○

KDEC82106

○

KDEC82107

○

KDEC82108

○

KDEC82109

○

KDEC82200

○

KDEC82201

○

KDEC82202

○

KDEC82203

○

KDEC82204

○

KDEC82205

○

KDEC82206

○

KDEC82207

○

KDEC82208

×

KDEC82209

○

KDEC82211

○

KDEC82212

○

KDEC82213

○

KDEC82216

×

KDEC82217

○

KDEC82218

○

KDEC82219

○

KDEC82220

○

KDEC82221

○

KDEC82223

×

KDEC82224

○

KDEC82225

○

KDEC82226

○

KDEC82227

○

KDEC82228

○

KDEC82229

×

（凡例）

○：通知します。

×：通知しません。

付録F.11　KDEC82500〜KDEC82999のメッセージ（Kafkaアダプタに関するメッセージ）

メッセージID

JP1イベント通知の有無

KDEC82500

×

KDEC82501

○

KDEC82502

○

KDEC82503

×

KDEC82504

×

KDEC82505

○

KDEC82506

○

KDEC82508

×

KDEC82511

×

KDEC82514

○

KDEC82516

○

KDEC82517

○

KDEC82530

×

KDEC82531

×

KDEC82532

×

KDEC82540

○

KDEC82541

○

KDEC82542

○

KDEC82543

○

KDEC82544

○

KDEC82545

○

KDEC82546

○

KDEC82547

○

KDEC82548

○

KDEC82549

○

KDEC82550

○

KDEC82551

○

KDEC82553

×

KDEC82554

○

KDEC82555

○

KDEC82559

○

（凡例）

○：通知します。

×：通知しません。

付録F.12　KDEC83000〜KDEC83099のメッセージ（Kafka受付に関するメッセージ）

メッセージID

JP1イベント通知の有無

KDEC83002

○

KDEC83003

○

KDEC83004

○

KDEC83005

○

KDEC83006

○

KDEC83007

○

（凡例）

○：通知します。

付録F.13　KDEC83100〜KDEC83199のメッセージ（gRPC受付に関するメッセージ）

メッセージID

JP1イベント通知の有無

KDEC83100

○

KDEC83101

○

KDEC83102

○

KDEC83103

○

KDEC83104

○

KDEC83105

○

KDEC83106

○

KDEC83107

×

KDEC83108

×

KDEC83109

○

（凡例）

○：通知します。

×：通知しません。

付録F.14　KDEC84000〜KDEC84199のメッセージ（gRPCアダプタに関するメッセージ）

メッセージID

JP1イベント通知の有無

KDEC84000

○

KDEC84001

○

KDEC84002

○

KDEC84003

○

KDEC84004

○

KDEC84005

○

KDEC84006

○

KDEC84007

○

KDEC84020

○

KDEC84031

○

KDEC84032

○

KDEC84033

○

KDEC84034

○

KDEC84035

○

KDEC84036

○

KDEC84050

△

KDEC84051

△

KDEC84052

△

KDEC84060

○

KDEC84061

○

KDEC84062

×

KDEC84063

×

KDEC84064

○

KDEC84065

×

KDEC84066

○

KDEC84080

○

（凡例）

○：通知します。

△：コメント付きで定義されています。通知したい場合は，コメントをはずしてください。

×：通知しません。

付録F.15　KDEC84200〜KDEC84299のメッセージ（スケジュール駆動受付に関するメッセージ）

メッセージID

JP1イベント通知の有無

KDEC84200

○

KDEC84201

○

KDEC84202

○

KDEC84203

○

KDEC84204

△

KDEC84205

○

KDEC84206

○

KDEC84207

△

KDEC84208

△

KDEC84209

△

KDEC84210

△

KDEC84211

○

KDEC84212

○

KDEC84250

×

KDEC84251

○

KDEC84252

△

KDEC84253

△

KDEC84254

○

KDEC84255

○

KDEC84256

×

KDEC84257

×

（凡例）

○：通知します。

△：コメント付きで定義されています。通知したい場合は，コメントをはずしてください。

×：通知しません。

付録F.16　KDEE10000〜KDEE13999のメッセージ（TP1アダプタに関するメッセージ）

メッセージID

JP1イベント通知の有無

KDEE10000

×

KDEE10001

○

KDEE10002

○

KDEE10003

○

KDEE10004

○

KDEE10005

○

KDEE10006

○

KDEE10007

○

KDEE10008

○

KDEE10009

○

KDEE10010

○

KDEE10011

○

KDEE10013

○

KDEE10014

○

KDEE10015

○

KDEE10016

○

KDEE10500

×

KDEE10501

△

KDEE10502

△

KDEE10503

△

KDEE10504

△

KDEE11000

○

KDEE11001

○

KDEE11002

○

KDEE11003

○

KDEE11004

○

KDEE11005

○

KDEE11006

○

KDEE11007

○

KDEE11008

○

KDEE11009

○

KDEE11010

○

KDEE11011

○

KDEE11012

○

KDEE11013

○

KDEE11014

○

KDEE11015

○

KDEE11016

○

KDEE11017

○

KDEE11018

○

KDEE11019

○

KDEE11020

△

KDEE11021

○

KDEE11022

○

KDEE11023

○

KDEE11024

○

KDEE11025

○

KDEE11026

○

KDEE11027

○

KDEE11028

○

KDEE11029

○

KDEE11030

○

KDEE11031

○

KDEE11032

○

KDEE11033

○

KDEE11034

○

KDEE11035

○

KDEE11036

○

KDEE11037

○

KDEE11038

○

KDEE11039

○

KDEE11040

○

KDEE11041

○

KDEE11042

○

KDEE11043

○

KDEE11044

○

KDEE11045

○

KDEE11046

○

KDEE11047

×

KDEE11048

×

KDEE11049

○

KDEE12000

×

KDEE12001

×

KDEE12002

○

KDEE12003

○

KDEE12004

○

KDEE12005

○

KDEE12006

○

KDEE12007

○

KDEE12008

○

KDEE12009

○

KDEE12010

○

KDEE12011

△

KDEE12012

△

KDEE12014

△

KDEE12015

△

KDEE12016

○

KDEE12017

○

KDEE12018

○

KDEE12019

○

KDEE12020

○

KDEE12021

△

KDEE12022

△

KDEE13000

○

KDEE13001

○

KDEE13002

△

KDEE13003

△

KDEE13004

△

KDEE13005

△

KDEE13006

△

KDEE13007

△

KDEE13008

△

KDEE13009

△

KDEE13010

△

KDEE13011

△

KDEE13012

△

（凡例）

○：通知します。

△：コメント付きで定義されています。通知したい場合は，コメントをはずしてください。

×：通知しません。

付録F.17　KDEF20000〜KDEF30999のメッセージ（Object Accessアダプタに関するメッセージ）

KDEF20000〜KDEF30999のメッセージはすべてJP1イベント通知をしません。

付録F.18　KDEG20000〜KDEG30999のメッセージ（ファイルアダプタに関するメッセージ）

KDEG20000〜KDEG30999のメッセージはすべてJP1イベント通知をしません。

付録F.19　KDEH20000〜KDEH30999のメッセージ（Message Queueアダプタに関するメッセージ）

KDEH20000〜KDEH30999のメッセージはすべてJP1イベント通知をしません。

付録F.20　KDEK20000〜KDEK30999のメッセージ（FTPアダプタに関するメッセージ）

メッセージID

JP1イベント通知の有無

KDEK20000

×

KDEK20001

○

KDEK20002

○

KDEK20201

○

KDEK20202

○

KDEK20203

○

KDEK20204

×

KDEK20205

○

KDEK20206

○

KDEK20208

○

KDEK20209

○

KDEK20210

○

KDEK20211

×

KDEK20212

○

KDEK20213

○

KDEK20215

○

KDEK20900

○

KDEK20901

○

KDEK20902

×

KDEK20903

×

KDEK20904

○

KDEK20905

×

KDEK20907

○

KDEK20908

×

KDEK20909

×

KDEK20910

○

KDEK21000

×

KDEK21001

×

KDEK21900

×

KDEK21901

×

KDEK30000

○

KDEK30001

○

KDEK30202

○

KDEK30203

○

KDEK30204

○

KDEK30205

○

KDEK30206

○

KDEK30207

○

KDEK30400

○

KDEK30401

○

KDEK30402

○

KDEK30403

○

KDEK30404

○

KDEK30405

○

KDEK30406

○

KDEK30407

○

KDEK30408

×

KDEK30409

○

KDEK30410

×

KDEK30411

○

KDEK30412

○

KDEK30413

○

KDEK30414

○

KDEK30415

○

KDEK30416

○

KDEK30417

○

KDEK30418

○

KDEK30419

○

KDEK30420

○

KDEK30421

×

KDEK30422

○

KDEK30423

○

KDEK30424

○

KDEK30425

○

KDEK30426

○

KDEK30427

○

KDEK30428

○

KDEK30432

○

KDEK30433

○

KDEK30434

○

KDEK30435

×

KDEK30436

○

KDEK30437

×

KDEK30438

×

KDEK30439

×

KDEK30440

×

KDEK30501

×

KDEK30502

×

KDEK30503

×

KDEK30511

×

KDEK30512

×

KDEK30513

×

KDEK30514

×

KDEK30515

×

KDEK30516

×

KDEK30531

×

KDEK30532

×

KDEK30533

×

KDEK30541

×

KDEK30542

×

KDEK30543

×

KDEK30551

×

KDEK30552

×

KDEK30553

×

KDEK30554

×

KDEK30555

×

KDEK30557

×

KDEK30558

×

KDEK30559

×

KDEK30571

×

KDEK30572

×

KDEK30573

×

KDEK30601

×

KDEK30602

×

KDEK30603

×

KDEK30604

×

KDEK30605

×

KDEK30606

×

KDEK30607

×

KDEK30608

×

KDEK30609

×

KDEK30901

×

（凡例）

○：通知します。

×：通知しません。

付録F.21　KECK31794〜KECK31799のメッセージ（SOAPモードの設定に関するメッセージ）

KECK31794〜KECK31799のメッセージはすべてJP1イベント通知をしません。

付録F.22　KECK72001〜KECK74999，KECT01001〜KECT91999のメッセージ（バイナリフォーマット定義，データ変換，およびメッセージダイアログに関するメッセージ）

KECK72001〜KECK74999，KECT01001〜KECT91999のメッセージはすべてJP1イベント通知をしません。

付録F.23　KECT92001〜KECT92999のメッセージ（データ変換単体テストコマンドに関するメッセージ）

KECT92001〜KECT92999のメッセージはすべてJP1イベント通知をしません。

付録F.24　KECT93001〜KECT93999のメッセージ（JSON変換ツールに関するメッセージ）

KECT93001〜KECT93999のメッセージはすべてJP1イベント通知をしません。

付録F.25　KECT94001〜KECT94999のメッセージ（OpenAPI仕様書変換ツールに関するメッセージ）

KECT94001〜KECT94999のメッセージはすべてJP1イベント通知をしません。

付録F.26　KECT95001〜KECT95999のメッセージ（proto-XMLスキーマ変換時に出力されるメッセージ）

KECT95001〜KECT95999のメッセージはすべてJP1イベント通知をしません。

付録F.27　KECT96001〜KECT96999のメッセージ（Service Architect用Eclipseセットアップ時に出力されるメッセージ）

KECT96001〜KECT96999のメッセージはすべてJP1イベント通知をしません。

付録F.28　KEOS50000〜KEOS59999のメッセージ（HCSC-Managerに関するメッセージ）

KEOS50000〜KEOS59999のメッセージはすべてJP1イベント通知をしません。

付録G　旧バージョンからの移行

旧バージョンのサービスプラットフォームで構築した開発環境，運用環境および実行環境を11-70にバージョンアップできます。その際，旧バージョンで使用していたリポジトリ情報（HCSCコンポーネントや配備定義など）をバージョンアップ後も使用する場合，リポジトリの情報をバージョンアップ後にも使用できる形式に移行してからバージョンアップします。

このマニュアルでは，バージョンアップ前に使用していたリポジトリ情報をそのまま使用して，バージョンアップ後も運用する場合のバージョンアップ方法について説明します。リポジトリの移行方法には，開発環境で移行する方法と，運用環境で移行する方法があります。運用環境で移行する場合のバージョンアップ方法については，「付録H　運用環境でリポジトリを旧バージョンから移行する方法」を参照してください。

旧バージョンで使用していたリポジトリ情報をバージョンアップ前後に開発環境で変更し，変更したリポジトリ情報を使用して運用する場合のバージョンアップ方法については，マニュアル「サービスプラットフォーム開発ガイド 基本開発編」の「付録A　旧バージョンからの移行」を参照してください。

注意事項

バージョンアップ後は，開発環境，運用環境および実行環境のバージョンを統一してください。

付録G.1　移行の対象となるバージョン

リポジトリ情報の移行の対象となる旧バージョンを次に示します。これらのバージョンのリポジトリ情報を移行して，各環境を11-70にバージョンアップできます。

Service Architect　07-10

Service Platform　07-10

Service Architect　07-20

Service Platform　07-20

Service Architect　07-50

Service Platform　07-50

Service Architect　07-60

Service Platform　07-60

Service Architect　08-00

Service Platform　08-00

Service Architect　08-10

Service Platform　08-10

Service Architect　08-50

Service Platform　08-50

Service Architect　08-51

Service Platform　08-51

Service Architect　08-53

Service Platform　08-53

Service Architect　08-70

Service Platform　08-70

Service Architect　09-00

Service Platform　09-00

Service Architect　09-50

Service Platform　09-50

Service Architect　09-51

Service Platform　09-51

Service Architect　09-60

Service Platform　09-60

Service Architect　09-70

Service Platform　09-70

Service Architect　09-71

Service Platform　09-71

Service Architect　09-87

Service Platform　09-87

Service Architect　11-00

Service Platform　11-00

Service Architect　11-10

Service Platform　11-10

Service Architect　11-20

Service Platform　11-20

Service Architect　11-30

Service Platform　11-30

Service Architect　11-40

Service Platform　11-40

Service Architect　11-50

Service Platform　11-50

Service Architect　11-60

Service Platform　11-60

なお，07-50より前のバージョンから11-70に移行する場合と，07-50以降のバージョンから11-70に移行する場合とで，次のように移行方法が異なります。

07-50より前のバージョンから11-70に移行する場合

旧バージョンをアンインストールして，11-70を新規にインストールします。移行手順の詳細については，「付録G.2　新規にインストールする場合の移行手順」を参照してください。

07-50以降のバージョンから11-70に移行する場合

次の3つの移行方法があります。

旧バージョンをアンインストールして，11-70を新規にインストールします。HCSC簡易セットアップ機能を利用してセットアップした場合は，この方法をお勧めします。移行手順の詳細については，「付録G.2　新規にインストールする場合の移行手順」を参照してください。

11-70を更新インストールします。移行手順の詳細については，「付録G.3　更新インストールする場合の移行手順」を参照してください。

システムを全面停止しないで，11-70を更新インストールします（ローリングアップデート）。ロードバランスクラスタ構成で運用している場合は，この方法を実施します。移行手順の詳細については，「付録G.4　ローリングアップデートの場合の移行手順」を参照してください。

製品の各バージョンに対応するリポジトリのバージョンを次に示します。

表G‒1　製品バージョンに対応するリポジトリのバージョン

製品のバージョン

リポジトリのバージョン

07-50

1.0

07-60

1.1

08-00

1.1

08-10

1.2

08-50

1.3

08-51

1.4

08-53

1.5

08-70

1.6

09-00

1.7

09-50

1.8

09-51

1.9

09-60

1.9

09-70

1.9

09-71

2.0

09-87

2.1

11-00

2.2

11-10

2.3

11-20

2.4

11-30

2.5

11-40

2.6

11-50

2.7

11-60

2.8

11-70

2.9

付録G.2　新規にインストールする場合の移行手順

次の図に示す「(1)　リポジトリのエクスポート（運用環境）」〜「(10)　HCSCコンポーネントの配備（運用環境）」の手順に従って，サービスプラットフォームを旧バージョンから11-70へ移行してください。

図G‒1　新規にインストールする場合の移行手順

図G-1の「(1)　リポジトリのエクスポート（運用環境）」〜「(10)　HCSCコンポーネントの配備（運用環境）」の手順の詳細を次に示します。

なお，手順内で使用するコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「5.　コマンド（運用環境・実行環境）」を参照してください。また，開発環境で実施する作業の詳細については，マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」を参照してください。

注意事項

バージョン07-60以降では，開発環境と運用環境で同じリポジトリを共有できません。旧バージョンでリポジトリを共有していた場合，開発環境と運用環境で別々のリポジトリを用意して，移行してください。移行手順については，マニュアル「サービスプラットフォーム開発ガイド 基本開発編」の「付録A.3　旧バージョンで開発環境と運用環境のリポジトリを共有していた場合の移行手順」を参照してください。

(1)　リポジトリのエクスポート（運用環境）

バージョンアップ前の運用環境のリポジトリをエクスポートして，いったん退避します。複数のリポジトリを使用している場合，必要なリポジトリをすべてエクスポートして，退避します。

cscrepctlコマンド（-exportオプション）を運用環境で実行して，バージョンアップ前のリポジトリをエクスポートしてください。

リポジトリのエクスポート方法の詳細については，「4.2　リポジトリのエクスポート」を参照してください。

(2)　HCSCコンポーネントの削除（運用環境）

実行環境のHCSCサーバに配備されているHCSCコンポーネントをすべて削除します。バージョンアップする実行環境のすべてのHCSCサーバに配備されているHCSCコンポーネントをすべて削除します。

csccompoundeployコマンドを運用環境で実行して，HCSCサーバに配備されているHCSCコンポーネントを削除してください。

csccompoundeploy -csc <HCSCサーバ名> -type {adapter｜bp} -name <サービスアダプタのサービスID>

(3)　HCSCサーバのアンセットアップ（運用環境）

バージョンアップする実行環境のすべてのHCSCサーバをアンセットアップします。

cscsvunsetupコマンドを運用環境で実行して，すべてのHCSCサーバをアンセットアップしてください。HCSC簡易セットアップ機能を利用してセットアップしたテスト環境は，HCSC簡易セットアップ機能を利用してアンセットアップしてください。

HCSCサーバのアンセットアップ方法については，「3.3.6　HCSCサーバをアンセットアップする」を参照してください。

なお，アンセットアップしないでバージョンアップしてしまった場合，07-50より前のバージョンから11-70に移行するときは，手動でHCSCサーバを削除してください。07-50以降のバージョンから11-70に移行するときは，手動でHCSCサーバを削除する必要はありません。

(4)　各環境のアンインストール

開発環境，運用環境，実行環境で旧バージョンのサービスプラットフォームをアンインストールします。サービスプラットフォームのインストールディレクトリ以下のディレクトリ情報を退避したあとに，旧バージョンのサービスプラットフォームをアンインストールすることをお勧めします。

(a)　アンインストールする場合の注意

J2EEサーバ，Management Server，PRFなど実行環境の構成要素を停止してからアンインストールしてください。

組み込みデータベースを使用している場合，組み込みデータベースを停止してからアンインストールしてください。

(b)　07-50より前のバージョンから移行する場合の注意

必ずすべてのHCSCサーバをアンセットアップしてからバージョンアップしてください。

実行環境をバージョンアップする場合，cscreplsコマンドを使ってHCSCサーバ情報が残っていないことを確認してから実施してください。HCSCサーバ情報が残っていたら，必ずHCSCサーバをアンセットアップしてからバージョンアップしてください。HCSCサーバ情報が残っていてもバージョンアップは実行できますが，正しくバージョンアップされないので注意してください。

HCSCサーバをアンセットアップしたあとに，リポジトリルート配下を削除してください。

(c)　09-00より前のバージョンから移行する場合の注意

09-00以降では次の製品はサービスプラットフォームに同梱されます。次の製品がインストールされている場合は，アンインストールすることをお勧めします。

Service Adapter for Flat Files

Service Adapter Architect for Flat Files

Service Adapter for FTP

Service Adapter Architect for FTP

Service Adapter for Message Queue

Service Adapter Architect for Message Queue

Service Adapter for Object Access

Service Adapter Architect for Object Access

Service Adapter for TP1

Service Adapter Architect for TP1

コード変換 - Development Kit

コード変換 - Server Runtime

コード変換 - Runtime

TP1/Client/J

(d)　開発環境をバージョンアップする場合の注意

開発環境では，バージョンアップ前にHCSCTEプロジェクトをいったん削除し，バージョンアップ後に新しく作成し直してください。

(5)　各環境のインストール

開発環境，運用環境，実行環境で11-70のサービスプラットフォームをインストールしてバージョンアップします。

(6)　HCSCサーバの構築（運用環境）

前回作成したHCSCサーバと同一の環境を構築し，定義します。前回作成した次のファイルを基に，HCSCサーバを構築して定義してください。

HCSCサーバ構成定義ファイル

HCSCサーバセットアップ定義ファイル

HCSCサーバランタイム定義ファイル

ユーザ定義受付ランタイム定義ファイル

テスト環境の場合は，HCSC簡易セットアップ機能を利用してセットアップしてください。

(7)　リポジトリのインポート（開発環境）

「(1)　リポジトリのエクスポート（運用環境）」でエクスポートしたリポジトリ情報を開発環境にインポートします。

旧バージョンのリポジトリをインポートすると，パッケージングおよび配備定義が自動で実施され，リポジトリ情報が今バージョンに引き継がれます。なお，パッケージングおよび配備定義が自動で実施されるのは，旧バージョンでパッケージングおよび配備定義したサービスアダプタ，ビジネスプロセスおよびユーザ定義受付だけです。

(a)　07-50より前のバージョンから移行する場合の注意

SessionBeanアダプタのユーザ定義クラスに次のファイル名が設定されているときは，警告メッセージが表示されます。

csmsvcadpdef.jar

cscmsg_adpejb.jar

警告メッセージが表示された場合，サービスアダプタ定義画面で，上記のユーザ定義クラスを削除し，ファイル名を変更してから，再度設定してください。

(b)　07-60以降のバージョンから移行する場合の注意

07-60以降のバージョンから移行する場合，実行環境に配備するサービスアダプタおよびユーザ定義受付は，開発環境にインポートして再度パッケージングしてください。サービスアダプタを再度パッケージングしないと，メッセージKDEC03007-Eが出力されないことがあります。また，ユーザ定義受付を再度パッケージングしないと，メッセージKDEC00001-Eで不正な埋字が出力されることがあります。パッケージングの方法については，マニュアル「サービスプラットフォーム開発ガイド 基本開発編」の「8.2　パッケージング」を参照してください。

(c)　08-10より前のバージョンから移行する場合の注意

データ変換定義で，sequence要素またはchoice要素下に，出現回数が1回に固定されている次の要素（コンポジタ）を定義している場合，ノードの表示が変更されるため，マッピング定義ファイルで使用しているXML Schemaが変更されている旨のエラーメッセージが表示されます。

sequence

choice

エラーメッセージが表示された場合は，再度マッピング定義を起動し，変更を反映させてください。

(d)　09-50より前のバージョンから移行する場合の注意

データ変換定義で次に示すスキーマを定義している場合，名前空間が変更されるため，マッピング定義ファイルで使用しているXML Schemaが変更されている旨のエラーメッセージが表示されます。

インポート先で対象名前空間（targetNamespace）を定義しているスキーマを変換元ノードに指定している。

1.の名前空間が，importまたはinclude先を含むすべての名前空間宣言（xmlns[:prefix]）で定義されていない。

エラーメッセージが表示された場合は，マッピング定義を再起動し，変更を反映させてください。

インスタンスのプールの最小値・最大値にはデフォルト値が適用されるため，HCSCサーバランタイム定義ファイルのプロパティでxml-pooled-instance-minimumプロパティまたはxml-pooled-instance-maximumプロパティを指定している場合は，性能に影響が生じるおそれがあります。そのため，次に示すusrconf.properties（J2EEサーバ用ユーザプロパティファイル）のプロパティと指定値を合わせてください。

内容

HCSCサーバランタイム定義ファイルのプロパティ※1

usrconf.properties（J2EEサーバ用ユーザプロパティファイル）のプロパティ※2

最小値

xml-pooled-instance-minimum

csc.dt.pool.DocumentBuilder.initialSize

最大値

xml-pooled-instance-maximum

csc.dt.pool.DocumentBuilder.maxSize

注※1

HCSCサーバランタイム定義ファイルについては，マニュアル「サービスプラットフォーム リファレンス」の「6.5.6　HCSCサーバランタイム定義ファイル」を参照してください。

注※2

これらのプロパティの指定方法については，「2.3.9(5)　XMLパーサプール機能オプションを使用する」を参照してください。

(e)　09-70より前のバージョンから移行する場合の注意

データ変換定義で次に示すスキーマを定義している場合，名前空間が変更されるため，マッピング定義ファイルで使用しているXML Schemaが変更されている旨のエラーメッセージが表示されます。

1つの名前空間URIに対して，複数の異なる名前空間接頭辞を指定している。

エラーメッセージが表示された場合は，マッピング定義を再起動し，変更を反映させてください。

(f)　メモリについての注意

旧バージョンのリポジトリをインポートするときは，メモリを多く必要とします。そのため，次の手順でメモリサイズが十分かどうかを確認し，メモリが不足している場合は，メモリサイズを増やしてからリポジトリをインポートしてください。

Eclipseのメニューから，［ウィンドウ］−［設定］を選択します。

ダイアログ左側のツリービューから，［一般］を選択します。

ダイアログ右側の［ヒープ・ステータスを表示］チェックボックスにチェックします。

Eclipseのウィンドウの右下のゴミ箱アイコンを選択し，ガーベッジ・コレクターを実行します。

ゴミ箱アイコンの左に表示されているヒープ・サイズを確認します。

未使用のヒープ・サイズが不足している場合，eclipse.iniを編集し，メモリサイズ（-Xmxの値）を大きくします。eclipse.iniの編集については，マニュアル「アプリケーションサーバアプリケーション開発ガイド」の「2.4.3　Eclipse環境のセットアップ」を参照してください。

(g)　クライアント定義ファイルについての注意

開発環境でSOAPアダプタを定義した場合，クライアント定義ファイル（c4webcl.properties）の「c4web.logger.log_file_prefix」の値は，自動的にサービスIDに変更されます。必要に応じて，移行前のクライアント定義ファイルを削除してください。詳細については，マニュアル「サービスプラットフォーム開発ガイド 受付・アダプタ定義編」の「3.3.1　SOAPアダプタを定義する」を参照してください。

(8)　リポジトリのエクスポート（開発環境）

「(7)　リポジトリのインポート（開発環境）」でインポートしたリポジトリをエクスポートします。

(9)　リポジトリのインポート（運用環境）

「(8)　リポジトリのエクスポート（開発環境）」でエクスポートしたリポジトリをインポートします。なお，旧バージョンのリポジトリはインポートできません。

cscrepctlコマンド（-importオプション）を運用環境で実行してください。

リポジトリのインポート方法の詳細については，「4.3　リポジトリのインポート」を参照してください。

(10)　HCSCコンポーネントの配備（運用環境）

「(9)　リポジトリのインポート（運用環境）」でインポートしたリポジトリ情報に含まれるHCSCコンポーネントをHCSCサーバに配備します。「(1)　リポジトリのエクスポート（運用環境）」でリポジトリをエクスポートしたときと同じ環境となるように配備します。

csccompodeployコマンド（-allオプション）を運用環境で実行してください。

HCSCコンポーネントの配備方法の詳細については，「3.1.8　サービスアダプタを配備する」および「3.1.13　ビジネスプロセスを配備する」を参照してください。

HCSCコンポーネントの配備後は，バージョンアップ前と同様にHCSCコンポーネントを操作できます。

なお，旧バージョンで使用していたリポジトリ情報をバージョンアップ前後に開発環境で変更し，変更したリポジトリ情報を使用して運用する場合のバージョンアップ方法については，マニュアル「サービスプラットフォーム開発ガイド 基本開発編」の「付録A.3　旧バージョンで開発環境と運用環境のリポジトリを共有していた場合の移行手順」を参照してください。

付録G.3　更新インストールする場合の移行手順

更新インストールで移行できるのは，バージョンが07-50以降のときだけです。07-50より前のバージョンを移行する場合は，11-70を新規にインストールして移行してください。

次の図に示す「(1)　リポジトリのエクスポート（運用環境）」〜「(10)　実行環境のバージョンアップ（運用環境）」の手順に従って，サービスプラットフォームを07-50以降のバージョンから11-70へ移行してください。

図G‒2　更新インストールする場合の移行手順

図G-2の「(1)　リポジトリのエクスポート（運用環境）」〜「(10)　実行環境のバージョンアップ（運用環境）」の手順の詳細を次に示します。

なお，手順内で使用するコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「5.　コマンド（運用環境・実行環境）」を参照してください。また，開発環境で実施する作業の詳細については，マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」を参照してください。

注意事項

バージョン07-60以降では，開発環境と運用環境で同じリポジトリを共有できません。旧バージョンでリポジトリを共有していた場合，開発環境と運用環境で別々のリポジトリを用意して，移行してください。移行手順については，マニュアル「サービスプラットフォーム開発ガイド 基本開発編」の「付録A.3　旧バージョンで開発環境と運用環境のリポジトリを共有していた場合の移行手順」を参照してください。

HCSCコンポーネントが開始状態でHCSCサーバを停止して，実行環境のバージョンアップを実施した場合，次回のHCSCサーバの起動時には，HCSCコンポーネントが停止した状態となります。そのため，実行環境のバージョンアップ後のHCSCサーバ起動後は，HCSCコンポーネントを開始する必要があります。

UNIX環境でService Coordinator管理者をroot以外に変更している場合は，更新インストール実施後に次に示すディレクトリ配下のファイル属性をService Coordinator管理者のオーナーおよびグループに変更してください。

　/opt/Cosminexus/CSC

(1)　リポジトリのエクスポート（運用環境）

バージョンアップ前の運用環境のリポジトリをエクスポートして，いったん退避します。複数のリポジトリを使用している場合，必要なリポジトリをすべてエクスポートして，退避します。

cscrepctlコマンド（-exportオプション）を運用環境で実行して，バージョンアップ前のリポジトリをエクスポートしてください。

リポジトリのエクスポート方法の詳細については，「4.2　リポジトリのエクスポート」を参照してください。

(2)　各環境の更新インストール

開発環境，運用環境，実行環境で11-70のサービスプラットフォームを更新インストールしてバージョンアップします。HCSC簡易セットアップ機能を利用してセットアップしたテスト環境の場合は，更新インストールの前にHCSC簡易セットアップ機能を利用してアンセットアップを実行し，更新インストール後に再セットアップしてください。

各環境を更新インストールするときの前提条件を次に示します。

前提条件

HCSCサーバがセットアップ済みであること

サービスプラットフォームおよびReliable Messagingが停止していること

組み込みデータベースを使用している場合，組み込みデータベースを停止していること

HCSCサーバ，J2EEサーバ，およびHCSCコンポーネントが停止していること

注意

更新インストールする場合の注意

J2EEサーバ，Management Server，PRFなど実行環境の構成要素を停止してから更新インストールしてください。

組み込みデータベースを使用している場合，組み込みデータベースを停止してから更新インストールしてください。

開発環境をバージョンアップする場合の注意

開発環境では，バージョンアップ前にHCSCTEプロジェクトをいったん削除し，バージョンアップ後に新しく作成し直してください。

バージョン11-70より前のバージョンから移行する場合，次に示すディレクトリ配下の情報を必要に応じて退避してから更新インストールしてください。

<サービスプラットフォームのインストールディレクトリ>¥CSCTE¥Samples

なお，更新インストールでは次のファイルを除いて上書きされます。

<サービスプラットフォームのインストールディレクトリ>¥CSC¥config¥manager¥csccmd.properties

<サービスプラットフォームのインストールディレクトリ>¥CSC¥config¥manager¥cscmng.properties

<サービスプラットフォームのインストールディレクトリ>¥CSC¥config¥msg¥cmdconf.bat

<サービスプラットフォームのインストールディレクトリ>¥CSC¥inbound-adapter¥ftp¥config¥command¥log4j.xml

<サービスプラットフォームのインストールディレクトリ>¥CSC¥inbound-adapter¥ftp¥config¥FTP_Inbound_Resource_Adapter¥serverstatus.properties

<サービスプラットフォームのインストールディレクトリ>¥CSC¥inbound-adapter¥ftp¥config¥FTP_Inbound_Resource_Adapter¥users.properties

<サービスプラットフォームのインストールディレクトリ>¥CSC¥system¥manager¥setup¥input.properties

(3)　J2EEサーバのクラスパスの変更

09-00より前のバージョンから移行する場合，J2EEサーバ用オプション定義ファイル（usrconf.cfg）に次に示す定義があれば削除してください。定義の変更はSmart Composer機能または運用管理ポータルの使用をお勧めします。

add.class.path=<TP1アダプタのインストールディレクトリ>¥lib¥adptp1rt.jar

add.class.path=<ファイルアダプタのインストールディレクトリ>¥lib¥adpffrt.jar

add.class.path=<Object Accessアダプタのインストールディレクトリ>¥lib¥adpoart.jar

add.class.path=<Object Accessアダプタのインストールディレクトリ>¥usrlib¥adpoaow.jar

add.class.path=<Message Queueアダプタのインストールディレクトリ>¥lib¥adpmqrt.jar

add.class.path=<FTPアダプタのインストールディレクトリ>¥lib¥adpftprt.jar

add.class.path=<FTPアダプタのインストールディレクトリ>¥lib¥ftp_common.jar

add.class.path=<コード変換ライブラリのインストールディレクトリ>¥java¥codeconv.jar

add.class.path=<TP1/Client/Jのインストールディレクトリ>¥LIB¥TP1Client.jar

(4)　旧オプションアダプタの定義ファイルの移行

09-00より前で使用していたオプションアダプタを移行する場合，次の作業を実施してください。

(a)　TP1アダプタの定義ファイルの移行

TP1アダプタ実行環境プロパティファイルをコピーします。コピー対象のファイルと，コピー先のディレクトリを次に示します。

コピー対象：<TP1アダプタのインストールディレクトリ>¥config¥*.properties

コピー先：<サービスプラットフォームのインストールディレクトリ>¥CSC¥custom-adapter¥TP1¥config¥

(b)　ファイルアダプタの定義ファイルの移行

ファイルアダプタ実行環境プロパティファイルをコピーします。コピー対象のファイルと，コピー先のディレクトリを次に示します。

コピー対象：<ファイルアダプタのインストールディレクトリ>¥config¥*.properties

コピー先：<サービスプラットフォームのインストールディレクトリ>¥CSC¥custom-adapter¥File¥config¥

(c)　Object Accessアダプタの定義ファイルの移行

Object Accessアダプタ実行環境プロパティファイルをコピーします。コピー対象のファイルと，コピー先のディレクトリを次に示します。

コピー対象：<Object Accessアダプタのインストールディレクトリ>¥config¥*.properties

コピー先：<サービスプラットフォームのインストールディレクトリ>¥CSC¥custom-adapter¥OA¥config¥

(d)　Message Queueアダプタの定義ファイルの移行

Message Queueアダプタ実行環境プロパティファイルをコピーします。コピー対象のファイルと，コピー先のディレクトリを次に示します。

コピー対象：<Message Queueアダプタのインストールディレクトリ>¥config¥*.properties

コピー先：<サービスプラットフォームのインストールディレクトリ>¥CSC¥custom-adapter¥MQ¥config¥

(e)　FTPアダプタの定義ファイルの移行

FTPアダプタコマンド定義ファイルとFTPアダプタ実行環境プロパティファイルをコピーします。コピー対象のファイルと，コピー先のディレクトリを次に示します。

コピー対象：<FTPアダプタのインストールディレクトリ>¥config¥*.properties

コピー先：<サービスプラットフォームのインストールディレクトリ>¥CSC¥custom-adapter¥FTP¥config¥

(5)　製品のアンインストール

09-00より前のバージョンから移行する場合，次の製品をアンインストールします。これらは09-00以降でサービスプラットフォームに同梱されるため，アンインストールすることをお勧めします。

Service Adapter for Flat Files

Service Adapter Architect for Flat Files

Service Adapter for FTP

Service Adapter Architect for FTP

Service Adapter for Message Queue

Service Adapter Architect for Message Queue

Service Adapter for Object Access

Service Adapter Architect for Object Access

Service Adapter for TP1

Service Adapter Architect for TP1

コード変換 - Development Kit

コード変換 - Server Runtime

コード変換 - Runtime

TP1/Client/J

(6)　リポジトリのインポート（開発環境）

「(1)　リポジトリのエクスポート（運用環境）」でエクスポートしたリポジトリ情報を開発環境にインポートします。旧バージョンのリポジトリをインポートすると，パッケージングおよび配備定義が自動で実施され，リポジトリ情報が今バージョンに引き継がれます。なお，パッケージングおよび配備定義が自動で実施されるのは，旧バージョンでパッケージングおよび配備定義したサービスアダプタ，ビジネスプロセスおよびユーザ定義受付だけです。

(a)　07-60以降のバージョンから移行する場合の注意

07-60以降のバージョンから移行する場合，実行環境に配備するサービスアダプタおよびユーザ定義受付は，開発環境にインポートして再度パッケージングしてください。サービスアダプタを再度パッケージングしないと，メッセージKDEC03007-Eが出力されないことがあります。また，ユーザ定義受付を再度パッケージングしないと，メッセージKDEC00001-Eで不正な埋字が出力されることがあります。パッケージングの方法については，マニュアル「サービスプラットフォーム開発ガイド 基本開発編」の「8.2　パッケージング」を参照してください。

(b)　08-10より前のバージョンから移行する場合の注意

データ変換定義で，sequence要素またはchoice要素下に，出現回数が1回に固定されている次の要素（コンポジタ）を定義している場合，ノードの表示が変更されるため，マッピング定義ファイルで使用しているXML Schemaが変更されている旨のエラーメッセージが表示されます。

sequence

choice

エラーメッセージが表示された場合は，再度マッピング定義を起動し，変更を反映させてください。

(c)　09-50より前のバージョンから移行する場合の注意

データ変換定義で次に示すスキーマを定義している場合，名前空間が変更されるため，マッピング定義ファイルで使用しているXML Schemaが変更されている旨のエラーメッセージが表示されます。

インポート先で対象名前空間（targetNamespace）を定義しているスキーマを変換元ノードに指定している。

1.の名前空間が，importまたはinclude先を含むすべての名前空間宣言（xmlns[:prefix]）で定義されていない。

エラーメッセージが表示された場合は，マッピング定義を再起動し，変更を反映させてください。

インスタンスのプールの最小値・最大値にはデフォルト値が適用されるため，HCSCサーバランタイム定義ファイルのプロパティでxml-pooled-instance-minimumプロパティまたはxml-pooled-instance-maximumプロパティを指定している場合は，性能に影響が生じるおそれがあります。そのため，次に示すusrconf.properties（J2EEサーバ用ユーザプロパティファイル）のプロパティと指定値を合わせてください。

内容

HCSCサーバランタイム定義ファイルのプロパティ※1

usrconf.properties（J2EEサーバ用ユーザプロパティファイル）のプロパティ※2

最小値

xml-pooled-instance-minimum

csc.dt.pool.DocumentBuilder.initialSize

最大値

xml-pooled-instance-maximum

csc.dt.pool.DocumentBuilder.maxSize

注※1

HCSCサーバランタイム定義ファイルについては，マニュアル「サービスプラットフォーム リファレンス」の「6.5.6　HCSCサーバランタイム定義ファイル」を参照してください。

注※2

これらのプロパティの指定方法については，「2.3.9(5)　XMLパーサプール機能オプションを使用する」を参照してください。

(d)　09-70より前のバージョンから移行する場合の注意

データ変換定義で次に示すスキーマを定義している場合，名前空間が変更されるため，マッピング定義ファイルで使用しているXML Schemaが変更されている旨のエラーメッセージが表示されます。

1つの名前空間URIに対して，複数の異なる名前空間接頭辞を指定している。

エラーメッセージが表示された場合は，マッピング定義を再起動し，変更を反映させてください。

(e)　メモリについての注意

旧バージョンのリポジトリをインポートするときは，メモリを多く必要とします。そのため，次の手順でメモリサイズが十分かどうかを確認し，メモリが不足している場合は，メモリサイズを増やしてからリポジトリをインポートしてください。

Eclipseのメニューから，［ウィンドウ］−［設定］を選択します。

ダイアログ左側のツリービューから，［一般］を選択します。

ダイアログ右側の［ヒープ・ステータスを表示］チェックボックスにチェックします。

Eclipseのウィンドウの右下のゴミ箱アイコンを選択し，ガーベッジ・コレクターを実行します。

ゴミ箱アイコンの左に表示されているヒープ・サイズを確認します。

未使用のヒープ・サイズが不足している場合，eclipse.iniを編集し，メモリサイズ（-Xmxの値）を大きくします。eclipse.iniの編集については，マニュアル「アプリケーションサーバアプリケーション開発ガイド」の「2.4.3　Eclipse環境のセットアップ」を参照してください。

(7)　リポジトリのエクスポート（開発環境）

「(6)　リポジトリのインポート（開発環境）」でインポートしたリポジトリをエクスポートします。

(8)　リポジトリのインポート（運用環境）

「(7)　リポジトリのエクスポート（開発環境）」でエクスポートしたリポジトリをインポートします。なお，旧バージョンのリポジトリはインポートできません。

cscrepctlコマンド（-importオプション）を運用環境で実行してください。

リポジトリのインポート方法の詳細については，「4.3　リポジトリのインポート」を参照してください。

(9)　サービスプラットフォームおよびReliable Messagingの移行（実行環境）

次の手順でサービスプラットフォームおよびReliable Messagingを移行してください。09-00より前のバージョンから移行する場合は，次の作業も必要です。

移行コマンド（mngenvupdateコマンド）の実行

mserver.properties（Management Server環境設定ファイル）へのプロパティの追加

次のプロパティを追加してください。追加しないでManagement Serverを起動すると，cscで始まるコマンドがエラーになる場合があります。プロパティの追加方法については，「2.1.6(1)　mserver.properties（Management Server環境設定ファイル）の設定」を参照してください。

ejbserver.naming.port
ejbserver.server.edition.settingforce

サービスプラットフォームの移行方法の詳細については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「10.　旧バージョンのアプリケーションサーバからの移行（J2EEサーバモードの場合）」を参照してください。

(10)　実行環境のバージョンアップ（運用環境）

運用環境から実行環境のバージョンアップを実施します。

(a)　前提条件

実行環境をバージョンアップするには，次の条件を満たしている必要があります。

Management Serverが起動していること

データベースを使用している（HCSCサーバセットアップ定義ファイルにdb-use=ONを指定）場合，データベースが起動していること

リポジトリのバージョンがインストールバージョンと一致していること

リポジトリのバージョンがインストールバージョンと一致していない場合は，開発環境でバージョンアップしてから，運用環境に「cscrepctl -import <リポジトリZIP>」でリポジトリを更新してください。

FTPインバウンドアダプタを使用する場合，cjrarupdateコマンド※でのリソースアダプタのバージョンアップが完了していること

注※

cjrarupdateコマンドには次のオプションを指定してください。

　-typeオプション：「rar」

　-fオプション：「<サービスプラットフォームのインストールディレクトリ>¥CSC¥inbound-adapter¥ftp¥rar¥ftp_inbound_adapter.rar」

cjrarupdateコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjrarupdate（リソースアダプタのバージョンアップ）」を参照してください。

なお，09-50以前のバージョンからFTPインバウンドアダプタをバージョンアップすると，FTPレスポンスに使用されるデフォルトの終端文字がOS依存の改行コードからCRLFに変更されます。終端文字をOS依存の改行コードに戻したい場合は，cjgetrarpropコマンドでFTPインバウンドアダプタのRARファイルから属性ファイルを取得したあと，定義を変更し，cjsetrarpropコマンドで属性ファイルを設定してください。属性ファイルの設定については，「3.2.3(3)　FTPインバウンドアダプタの設定」を参照してください。

KafkaインバウンドアダプタまたはgRPCインバウンドアダプタを使用している場合，リソースアダプタのバージョンアップが完了していること

リソースアダプタのバージョンアップは次の手順で実施してください。cjrarupdateコマンドは使用できません。

KafkaインバウンドアダプタおよびgRPCインバウンドアダプタの属性ファイルを取得する

属性ファイルの定義項目を設定している場合は，セットアップで各項目の再設定が必要になります。必ずインバウンドアダプタのアンセットアップ前に属性ファイルを取得してください。

KafkaインバウンドアダプタおよびgRPCインバウンドアダプタをアンセットアップする

インバウンドアダプタのアンセットアップの詳細については，「3.3.5　KafkaインバウンドアダプタおよびgRPCインバウンドアダプタをアンセットアップする」を参照してください。

KafkaインバウンドアダプタおよびgRPCインバウンドアダプタをセットアップする

インバウンドアダプタのセットアップの詳細については，「3.1.2(11)　Kafkaインバウンドアダプタのセットアップ」または「3.1.2(12)　gRPCインバウンドアダプタのセットアップ」を参照してください。

gRPCプロトコルを利用した接続機能を利用する場合，gRPCライブラリ（OSS）をインストールする

gRPCプロトコルを利用した接続機能を利用する場合は，マニュアル「サービスプラットフォーム 解説」の「2.13.1　gRPCプロトコルを利用したシステム」を参照して，「(1)　gRPCプロトコルを利用した接続に必要なOSS」から更新が必要なOSSがないか確認してください。更新が必要なOSSがある場合，「(2)　gRPCライブラリ（OSS）のインストール」に従ってインストールしてください。

前提条件を満たしていない場合，上記の順番で起動，停止，およびバージョンアップを実施してください。

(b)　バージョンアップ方法

cscenvupdateコマンドを実行して，リポジトリとHCSCサーバをバージョンアップします。

cscenvupdate -csc <バージョンアップするHCSCサーバ名>

なお，旧バージョンで使用していたリポジトリ情報を開発環境でバージョンアップ前後に変更し，そのリポジトリ情報を使用して運用する場合のバージョンアップ方法については，マニュアル「サービスプラットフォーム開発ガイド 基本開発編」の「付録A　旧バージョンからの移行」を参照してください。

注意事項

旧バージョンでHTTP受付を使用していた場合で，アプリケーション統合属性ファイルで次に示す要素以外を編集しているときは，その部分については移行後のアプリケーション統合属性ファイルに反映されません。

//hitachi-application-all-property/ejb-jar/hitachi-ejb-jar-property/display-name[.='cscmsg_urecp_custom']/../../hitachi-session-bean-property/display-name[.='CSCMsgCustomServiceDelivery']/../session-runtime/stateless/pooled-instance/minimum

//hitachi-application-all-property/ejb-jar/hitachi-ejb-jar-property/display-name[.='cscmsg_urecp_custom']/../../hitachi-session-bean-property/display-name[.='CSCMsgCustomServiceDelivery']/../session-runtime/stateless/pooled-instance/maximum

//hitachi-application-all-property/ejb-jar/hitachi-ejb-jar-property/display-name[.='cscmsg_urecp_custom']/../../hitachi-session-bean-property/display-name[.='CSCMsgCustomServiceDelivery']/../ejb-transaction-timeout/method/method-name[.='*']/../../transaction-timeout

そのため，必要に応じてcsccompoconfigコマンドでアプリケーション統合属性ファイルを取得して内容を編集したあと，設定を反映してください。

csccompoconfigコマンドの使用方法については，マニュアル「サービスプラットフォーム リファレンス」の「csccompoconfig（HCSCコンポーネントの定義）」を参照してください。

アプリケーション統合属性ファイル（cosminexus.xml）で編集できる要素については，マニュアル「サービスプラットフォーム 開発ガイド 受付・アダプタ定義編」の「付録A.6　カスタム受付のチューニング」を参照してください。

(c)　09-71より前のバージョンから移行する場合の注意

HCSCサーバランタイム定義ファイルの次に示すプロパティの初期値が変更されているため，メモリ使用量が増えるおそれがあります。HCSCサーバランタイム定義ファイルについては，マニュアル「サービスプラットフォームリファレンス」の「6.5.6　HCSCサーバランタイム定義ファイル」を参照してください。

formatdef-maxcache-num

transformdef-maxcache-num

(d)　11-10より前のバージョンから移行する場合の注意

11-10からJ2EEサーバの互換モードで推奨モードが使用できますが，新規構築でない環境ではV9互換モードが引き継がれます。推奨モードは使用できません。

(e)　11-60より前のバージョンから移行する場合の注意

11-60より前のバージョンから移行する場合の注意点を次に示します。

11-60以降でJDK 17を使用する場合

11-60でサポートされたJDK 17を使用する場合，JDK 11がインストールされた環境から更新インストールはできません。

11-10以降からバージョンアップした場合

11-10以降でサポートされたJ2EEサーバの互換モードは，V9互換モード・推奨モードのどちらも使用できます。11-10以降からのバージョンアップの場合，11-10以降で構築した互換モードが引き継がれます。

付録G.4　ローリングアップデートの場合の移行手順

ローリングアップデートとは，システムを全面停止しないで，更新インストールで移行する方法です。更新インストールの移行手順は，「付録G.3　更新インストールする場合の移行手順」に記載しています。

ローリングアップデートで移行できるのは，バージョンが07-50以降のときだけです。07-50より前のバージョンを移行する場合は，11-70を新規にインストールして移行してください。移行時の注意事項については，「(15)　ローリングアップデートで移行する場合の注意事項」を参照してください。

また，ローリングアップデートで移行する場合，2台以上のHCSCサーバでロードバランスクラスタを構成している必要があります。

次の図に示す「(1)　リポジトリのエクスポート（運用環境）」〜「(13)　リクエストの送信制御の解除（ロードバランサ）」の手順に従って，サービスプラットフォームを07-50以降のバージョンから11-70へ移行してください。

図G‒3　ローリングアップデートの場合の移行手順

図G-3の「(1)　リポジトリのエクスポート（運用環境）」〜「(13)　リクエストの送信制御の解除（ロードバランサ）」の手順の詳細を次に示します。2台目以降のHCSCサーバに対しては，「(14)　2台目以降のHCSCサーバ（実行環境）に対しての作業」の手順も実行してください。

なお，手順内で使用するコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「5.　コマンド（運用環境・実行環境）」を参照してください。また，開発環境で実施する作業の詳細については，マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」を参照してください。

注意事項

バージョン07-60以降では，開発環境と運用環境で同じリポジトリを共有できません。旧バージョンでリポジトリを共有していた場合，開発環境と運用環境で別々のリポジトリを用意して，移行してください。移行手順については，マニュアル「サービスプラットフォーム開発ガイド 基本開発編」の「付録A.3　旧バージョンで開発環境と運用環境のリポジトリを共有していた場合の移行手順」を参照してください。

ローリングアップデートでの移行が完了するまで，旧バージョンのシステムに対して，次の操作はできません。

・cscsvsetupコマンドで，新規にHCSCサーバをセットアップする

・csccompodeployコマンドで，新規にHCSCコンポーネントを配備する

(1)　リポジトリのエクスポート（運用環境）

バージョンアップ前の運用環境のリポジトリをエクスポートして，いったん退避します。複数のリポジトリを使用している場合は，すべてのリポジトリをエクスポートして退避します。

cscrepctlコマンド（-exportオプション）を運用環境で実行して，バージョンアップ前のリポジトリをエクスポートしてください。

リポジトリのエクスポート方法の詳細については，「4.2　リポジトリのエクスポート」を参照してください。

(2)　開発環境および運用環境のインストール

開発環境および運用環境で，11-70のサービスプラットフォームをインストールしてバージョンアップします。

開発環境は，新規インストールまたは更新インストールのどちらかの方法でインストールします。運用環境は更新インストールでインストールします。

新規にインストールする場合

「付録G.2　新規にインストールする場合の移行手順」の「(2)　HCSCコンポーネントの削除（運用環境）」〜「(6)　HCSCサーバの構築（運用環境）」の作業を実施します。

更新インストールする場合

「付録G.3　更新インストールする場合の移行手順」の「(2)　各環境の更新インストール」〜「(5)　製品のアンインストール」の作業を実施します。

開発環境および運用環境をインストールするときの前提条件を次に示します。

前提条件

HCSCサーバがセットアップ済みであること

サービスプラットフォームおよびReliable Messagingが停止していること

組み込みデータベースを使用している場合，組み込みデータベースを停止していること

HCSCサーバ，J2EEサーバ，およびHCSCコンポーネントが停止していること

注意

更新インストールをする場合，次の点に注意してください。

インストールする環境で，J2EEサーバ，Management Server，PRFなどのサービスプラットフォーム実行環境が稼働中の場合は，すべていったん停止してから更新インストールしてください。

組み込みデータベースを使用しているときは，組み込みデータベースを停止してから更新インストールしてください。

(3)　J2EEサーバのクラスパスの変更（開発環境）

09-00より前のバージョンから移行する場合，J2EEサーバ用オプション定義ファイル（usrconf.cfg）に次に示す定義があれば削除してください。定義の変更はSmart Composer機能または運用管理ポータルの使用をお勧めします。

add.class.path=<TP1アダプタのインストールディレクトリ>¥lib¥adptp1rt.jar

add.class.path=<ファイルアダプタのインストールディレクトリ>¥lib¥adpffrt.jar

add.class.path=<Object Accessアダプタのインストールディレクトリ>¥lib¥adpoart.jar

add.class.path=<Object Accessアダプタのインストールディレクトリ>¥usrlib¥adpoaow.jar

add.class.path=<Message Queueアダプタのインストールディレクトリ>¥lib¥adpmqrt.jar

add.class.path=<FTPアダプタのインストールディレクトリ>¥lib¥adpftprt.jar

add.class.path=<FTPアダプタのインストールディレクトリ>¥lib¥ftp_common.jar

add.class.path=<コード変換ライブラリのインストールディレクトリ>¥java¥codeconv.jar

add.class.path=<TP1/Client/Jのインストールディレクトリ>¥LIB¥TP1Client.jar

(4)　旧オプションアダプタの定義ファイルの移行（開発環境）

09-00より前で使用していたオプションアダプタを移行する場合，次の作業を実施してください。

(a)　TP1アダプタの定義ファイルの移行

TP1アダプタ実行環境プロパティファイルをコピーします。コピー対象のファイルと，コピー先のディレクトリを次に示します。

コピー対象：<TP1アダプタのインストールディレクトリ>¥config¥*.properties

コピー先：<サービスプラットフォームのインストールディレクトリ>¥CSC¥custom-adapter¥TP1¥config¥

(b)　ファイルアダプタの定義ファイルの移行

ファイルアダプタ実行環境プロパティファイルをコピーします。コピー対象のファイルと，コピー先のディレクトリを次に示します。

コピー対象：<ファイルアダプタのインストールディレクトリ>¥config¥*.properties

コピー先：<サービスプラットフォームのインストールディレクトリ>¥CSC¥custom-adapter¥File¥config¥

(c)　Object Accessアダプタの定義ファイルの移行

Object Accessアダプタ実行環境プロパティファイルをコピーします。コピー対象のファイルと，コピー先のディレクトリを次に示します。

コピー対象：<Object Accessアダプタのインストールディレクトリ>¥config¥*.properties

コピー先：<サービスプラットフォームのインストールディレクトリ>¥CSC¥custom-adapter¥OA¥config¥

(d)　Message Queueアダプタの定義ファイルの移行

Message Queueアダプタ実行環境プロパティファイルをコピーします。コピー対象のファイルと，コピー先のディレクトリを次に示します。

コピー対象：<Message Queueアダプタのインストールディレクトリ>¥config¥*.properties

コピー先：<サービスプラットフォームのインストールディレクトリ>¥CSC¥custom-adapter¥MQ¥config¥

(e)　FTPアダプタの定義ファイルの移行

FTPアダプタコマンド定義ファイルとFTPアダプタ実行環境プロパティファイルをコピーします。コピー対象のファイルと，コピー先のディレクトリを次に示します。

コピー対象：<FTPアダプタのインストールディレクトリ>¥config¥*.properties

コピー先：<サービスプラットフォームのインストールディレクトリ>¥CSC¥custom-adapter¥FTP¥config¥

(5)　製品のアンインストール

09-00より前のバージョンから移行する場合，次の製品をアンインストールします。これらは09-00以降でサービスプラットフォームに同梱されるため，アンインストールすることをお勧めします。

Service Adapter for Flat Files

Service Adapter Architect for Flat Files

Service Adapter for FTP

Service Adapter Architect for FTP

Service Adapter for Message Queue

Service Adapter Architect for Message Queue

Service Adapter for Object Access

Service Adapter Architect for Object Access

Service Adapter for TP1

Service Adapter Architect for TP1

コード変換 - Development Kit

コード変換 - Server Runtime

コード変換 - Runtime

TP1/Client/J

(6)　リポジトリのインポート・エクスポート（開発環境・運用環境）

「(1)　リポジトリのエクスポート（運用環境）」でエクスポートしたリポジトリ情報を開発環境にインポートします。インポートによって，古いバージョンで作成したリポジトリ情報が今バージョンに引き継がれます。そのあと，開発環境のリポジトリ情報を運用環境にインポートし，運用環境にもリポジトリ情報を引き継ぎます。

リポジトリのインポート・エクスポートで実施する作業は，「(2)　開発環境および運用環境のインストール」で開発環境をインストールした方法によって次のように異なります。

新規にインストールした場合

「付録G.2　新規にインストールする場合の移行手順」の「(7)　リポジトリのインポート（開発環境）」〜「(9)　リポジトリのインポート（運用環境）」の作業を実施します。

更新インストールした場合

「付録G.3　更新インストールする場合の移行手順」の「(6)　リポジトリのインポート（開発環境）」〜「(8)　リポジトリのインポート（運用環境）」の作業を実施します。

(7)　リクエストの送信制御（ロードバランサ）

バージョンアップするHCSCサーバに対してリクエストを送信しないように，ロードバランサを設定します。その際，仕掛かり中のリクエストがないことを確認してください。なお，設定方法は各ロードバランサの仕様によって異なります。

(8)　実行環境のインストール

実行環境で，11-70のサービスプラットフォームをインストールしてバージョンアップします。

実行環境は，新規インストールまたは更新インストールのどちらかの方法でインストールします。

新規にインストールする場合

「付録G.2　新規にインストールする場合の移行手順」の「(2)　HCSCコンポーネントの削除（運用環境）」〜「(6)　HCSCサーバの構築（運用環境）」の作業を実施します。

更新インストールする場合

「付録G.3　更新インストールする場合の移行手順」の「(2)　各環境の更新インストール」〜「(5)　製品のアンインストール」の作業を実施します。

(9)　サービスプラットフォームおよびReliable Messagingの移行（実行環境）

次の手順でサービスプラットフォームおよびReliable Messagingを移行してください。09-00より前のバージョンから移行する場合は，次の作業も必要です。

移行コマンド（mngenvupdateコマンド）の実行

mserver.properties（Management Server環境設定ファイル）へのプロパティの追加

次のプロパティを追加してください。追加しないでManagement Serverを起動すると，cscで始まるコマンドがエラーになる場合があります。プロパティの追加方法については，「2.1.6(1)　mserver.properties（Management Server環境設定ファイル）の設定」を参照してください。

ejbserver.naming.port
ejbserver.server.edition.settingforce

サービスプラットフォームの移行方法の詳細については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「10.　旧バージョンのアプリケーションサーバからの移行（J2EEサーバモードの場合）」を参照してください。

(10)　実行環境のバージョンアップ（運用環境）

運用環境から実行環境のバージョンアップを実施します。

(a)　前提条件

実行環境をバージョンアップするには，次の条件を満たしている必要があります。

Management Serverが起動していること

組み込みデータベースを使用している場合，組み込みデータベースが起動していること

リポジトリのバージョンがインストールバージョンと一致していること

リポジトリのバージョンがインストールバージョンと一致していない場合は，開発環境でバージョンアップしてから，運用環境に「cscrepctl -import <リポジトリZIP>」でリポジトリを更新してください。

前提条件を満たしていない場合，上記の順番で起動，停止，およびバージョンアップを実施してください。

(b)　バージョンアップ方法

cscenvupdateコマンドを実行して，リポジトリとHCSCサーバをバージョンアップします。

cscenvupdate -csc <バージョンアップするHCSCサーバ名>

(11)　HCSCサーバの起動（運用環境）

バージョンアップしたHCSCサーバを起動します。

(12)　HCSCコンポーネントの開始（運用環境）

「(10)　実行環境のバージョンアップ（運用環境）」で起動したHCSCサーバに配備されているHCSCコンポーネントを開始します。

(13)　リクエストの送信制御の解除（ロードバランサ）

バージョンアップしたHCSCサーバに対してリクエストを送信するように，ロードバランサを設定します。なお，設定方法は各ロードバランサの仕様によって異なります。

(14)　2台目以降のHCSCサーバ（実行環境）に対しての作業

ロードバランスクラスタを構成しているすべてのHCSCサーバに対して，「(7)　リクエストの送信制御（ロードバランサ）」〜「(13)　リクエストの送信制御の解除（ロードバランサ）」の作業を実施します。

なお，旧バージョンで使用していたリポジトリ情報を開発環境でバージョンアップ前後に変更し，そのリポジトリ情報を使用して運用する場合のバージョンアップ方法については，マニュアル「サービスプラットフォーム開発ガイド 基本開発編」の「付録A　旧バージョンからの移行」を参照してください。

(15)　ローリングアップデートで移行する場合の注意事項

(a)　08-70以前にローリングアップデートする場合

次の条件がすべて該当すると，cscenvupdateコマンドの実行時に異常終了することがあります。

データベースおよびReliable Messagingがある構成でセットアップしている場合で，データベースにはHiRDBを使用している。

ビジネスプロセスを使用している。

クラスタ内で最初のアップデートである。

08-70以前からのローリングアップデートである。

この場合に，正常に運用する方法および運用例を次に示します。

運用方法

稼働しているすべてのHCSCサーバに対して，次に示す1.〜4.の操作を実行してください。

実行履歴参照コマンドおよび運用操作をするGUIを停止する。

HCSCサーバにリクエストを送信しないようにする。

HCSCサーバの受付（標準受付およびユーザ定義受付）を停止する。

すべてのリソースアダプタのプールを破棄する（cjclearpoolコマンドを利用）。

この操作を実行した状態で，バージョンアップしたHCSCサーバに対してcscenvupdateコマンドを実行してください。2台目以降のアップデートは，1.〜4.の手順を実行する必要はありません。また，1回目のcscenvupdateコマンドの正常終了を確認したあとに，1.〜3.の手順で停止した各機能は，2台目以降の操作タイミングとは無関係に再開可能となります。

運用例

次に示す構成およびバージョンアップを想定します。

3台のクラスタ構成（HCSCサーバA，HCSCサーバB，HCSCサーバC）で運用している。

HCSCサーバBおよびHCSCサーバCが稼働中に，HCSCサーバAに対してcscenvupdateコマンドを実行する。

この場合に，正常に運用する方法を次に示します。

実行履歴参照コマンドおよび運用操作をするGUIを停止する。

HCSCサーバBおよびHCSCサーバCにリクエストを送信しないようにする。

HCSCサーバB，HCSCサーバCの受付（標準受付およびユーザ定義受付）を停止する。

cjclearpoolコマンドを利用して，HCSCサーバBおよびHCSCサーバCのすべてのリソースアダプタのプールを破棄する。

HCSCサーバAに対してcscenvupdateコマンドを実行する。

(b)　09-00以降にローリングアップデートする場合

次の条件がすべて該当すると，cscenvupdateコマンドの実行時に異常終了することがあります。

データベースおよびReliable Messagingがある構成でセットアップしている。

ビジネスプロセスを使用している。

クラスタ内で最初のアップデートである。

この場合，オンラインを停止させてから「付録H.4　ローリングアップデートで運用環境のリポジトリを移行する手順」に示す手順でローリングアップデートしてください。

付録G.5　移行後の設定（07-50より前のバージョンから移行する場合）

07-50より前のバージョンから移行する場合，サービスプラットフォームを移行したあとの，実行環境に必要なソフトウェアの設定としてReliable Messagingをセットアップする方法について説明します。

バージョン07-50以降，Reliable Messagingをセットアップするときにキュー定義ファイルの作成は不要になりました。そのため，移行後にReliable Messagingをセットアップするときも，キュー定義ファイルを作成する必要はありません。ただし，07-50より前のバージョンから移行する場合は，移行前のバージョンと同じようにキュー定義ファイルを作成してReliable Messagingをセットアップすることもできます。

Reliable Messagingをセットアップする方法の詳細については，マニュアル「Reliable Messaging」の「3.　システム構築」を参照してください。セットアップ作業のうち，キュー定義ファイルの作成とプロパティのカスタマイズについては，次に示す方法で実施します。

(1)　キュー定義ファイルの作成

キュー定義ファイルは，次に示すディレクトリに格納されているキュー定義ファイルのサンプルを利用して（クラスタ名を書き加えて）作成します。

<サービスプラットフォームのインストールディレクトリ>¥CSC¥samples¥qconf.txt

キュー定義ファイルのサンプルを次に示します。

###########################################################
# Cosminexus Reliable Messaging JMS Queue Configuration
# All Rights Reserved. Copyright (C) 2006, Hitachi, Ltd.
###########################################################
QueueImplClass=jp.co.Hitachi.soft.reliablemessaging.ra.jms.QueueImpl
Queue.1.DisplayName= CSC<HCSCServer_Name>ACPT_RCVQ
Queue.1.QueueName= CSC<HCSCServer_Name>ACPT_RCVQ
Queue.2.DisplayName= CSC<HCSCServer_Name>ACPT_DBQ
Queue.2.QueueName= CSC<HCSCServer_Name>ACPT_DBQ

上記のキュー定義ファイルを任意の場所にコピーし，ファイルをテキストエディタで開いて，ファイル中の<HCSCServer_Name>の部分を次のように置き換えてファイルを保存します。

クラスタを構成しないHCSCサーバ，またはロードバランスクラスタを構成するHCSCサーバの場合

<HCSCServer_Name>：HCSCサーバ名

HAクラスタを構成するHCSCサーバの場合

<HCSCServer_Name>：クラスタ名

(2)　Reliable Messagingのコンフィグレーションプロパティの設定

「3.1.2(9)　Reliable Messagingのセットアップ」に記載されているプロパティに加えて，次のプロパティを設定します。

プロパティ名

設定内容

設定値

QueueConfigFileName

キュー定義ファイルの場所

作成したキュー定義ファイルのファイルパスを指定します。

付録H　運用環境でリポジトリを旧バージョンから移行する方法

ここでは，開発環境を利用しないで，運用環境だけでリポジトリを11-70にバージョンアップする方法について説明します。

開発環境を利用してリポジトリをバージョンアップする方法については，「付録G　旧バージョンからの移行」を参照してください。また，旧バージョンで使用していたリポジトリ情報をバージョンアップ前後に開発環境で変更し，変更したリポジトリ情報を使用して運用する場合のバージョンアップ方法については，マニュアル「サービスプラットフォーム開発ガイド 基本開発編」の「付録A　旧バージョンからの移行」を参照してください。

付録H.1　移行の対象となるバージョン

バージョンが08-00以降の場合は，運用環境のリポジトリだけを11-70に移行できます。移行対象となる製品の各バージョンに対応するリポジトリのバージョンを次に示します。

表H‒1　製品バージョンに対応するリポジトリのバージョン

製品のバージョン

リポジトリのバージョン

08-00

1.1

08-10

1.2

08-50

1.3

08-51

1.4

08-53

1.5

08-70

1.6

09-00

1.7

09-50

1.8

09-51

1.9

09-60

1.9

09-70

1.9

09-71

2.0

09-87

2.1

11-00

2.2

11-10

2.3

11-20

2.4

11-30

2.5

11-40

2.6

11-50

2.7

11-60

2.8

11-70

2.9

08-00より前のバージョンからリポジトリを11-70に移行したい場合は，開発環境を利用してリポジトリをバージョンアップする必要があります。開発環境を利用してリポジトリをバージョンアップする方法については，「付録G　旧バージョンからの移行」を参照してください。

付録H.2　新規にインストールして運用環境のリポジトリを移行する手順

次の図に示す「(1)　リポジトリのエクスポート（運用環境）」〜「(9)　HCSCコンポーネントの配備（運用環境）」の手順に従って，サービスプラットフォームを旧バージョンから11-70へ移行してください。

図H‒1　新規にインストールする場合の移行手順（運用環境だけを移行する場合）

図H-1の「(1)　リポジトリのエクスポート（運用環境）」〜「(9)　HCSCコンポーネントの配備（運用環境）」の手順の詳細を次に示します。

なお，手順内で使用するコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「5.　コマンド（運用環境・実行環境）」を参照してください。

(1)　リポジトリのエクスポート（運用環境）

バージョンアップ前の運用環境のリポジトリをエクスポートして，いったん退避します。複数のリポジトリを使用している場合，必要なリポジトリをすべてエクスポートして，退避します。

cscrepctlコマンド（-exportオプション）を運用環境で実行して，バージョンアップ前のリポジトリをエクスポートしてください。

リポジトリのエクスポート方法の詳細については，「4.2　リポジトリのエクスポート」を参照してください。

(2)　HCSCコンポーネントの削除（運用環境）

実行環境のHCSCサーバに配備されているHCSCコンポーネントをすべて削除します。バージョンアップする実行環境のすべてのHCSCサーバに配備されているHCSCコンポーネントをすべて削除します。

csccompoundeployコマンドを運用環境で実行して，HCSCサーバに配備されているHCSCコンポーネントを削除してください。

csccompoundeploy -csc <HCSCサーバ名> -type {adapter｜bp} -name <サービスアダプタのサービスID>

(3)　HCSCサーバのアンセットアップ

バージョンアップする実行環境のすべてのHCSCサーバをアンセットアップします。

cscsvunsetupコマンドを運用環境で実行して，すべてのHCSCサーバをアンセットアップしてください。HCSC簡易セットアップ機能を利用してセットアップしたテスト環境は，HCSC簡易セットアップ機能を利用してアンセットアップしてください。

HCSCサーバのアンセットアップ方法については，「3.3.6　HCSCサーバをアンセットアップする」を参照してください。

(4)　各環境のアンインストール

運用環境および実行環境で旧バージョンのサービスプラットフォームをアンインストールします。サービスプラットフォームのインストールディレクトリ以下のディレクトリ情報を退避したあとに，旧バージョンのサービスプラットフォームをアンインストールすることをお勧めします。

注意

アンインストールする場合，次の点に注意してください。

J2EEサーバ，Management Server，PRFなど実行環境の構成要素を停止してからアンインストールしてください。

組み込みデータベースを使用している場合，組み込みデータベースを停止してからアンインストールしてください。

09-00より前のバージョンから移行する場合の注意

09-00以降では次の製品はサービスプラットフォームに同梱されます。次の製品がインストールされている場合は，アンインストールすることをお勧めします。

Service Adapter for Flat Files

Service Adapter Architect for Flat Files

Service Adapter for FTP

Service Adapter Architect for FTP

Service Adapter for Message Queue

Service Adapter Architect for Message Queue

Service Adapter for Object Access

Service Adapter Architect for Object Access

Service Adapter for TP1

Service Adapter Architect for TP1

コード変換 - Development Kit

コード変換 - Server Runtime

コード変換 - Runtime

TP1/Client/J

(5)　各環境のインストール

運用環境および実行環境で11-70のサービスプラットフォームをインストールしてバージョンアップします。

(6)　HCSCサーバの構築（運用環境）

前回作成したHCSCサーバと同一の環境を構築し，定義します。前回作成した次のファイルを基に，HCSCサーバを構築して定義してください。

HCSCサーバ構成定義ファイル

HCSCサーバセットアップ定義ファイル

HCSCサーバランタイム定義ファイル

ユーザ定義受付ランタイム定義ファイル

テスト環境の場合は，HCSC簡易セットアップ機能を利用してセットアップしてください。

(7)　リポジトリのアップデート

旧バージョンで作成したビジネスプロセスやサービスアダプタを使用する場合は，cscrepupdateコマンドを使用して，旧バージョンで作成されたリポジトリをアップデートします。

cscrepupdate -inputfile <アップデート前のリポジトリZIPファイル名> -outputfile <アップデート後のリポジトリZIPファイル名>

(8)　リポジトリのインポート（運用環境）

「(7)　リポジトリのアップデート」でアップデートしたリポジトリをインポートします。なお，旧バージョンのリポジトリはインポートできません。

cscrepctlコマンド（-importオプション）を運用環境で実行してください。

リポジトリのインポート方法の詳細については，「4.3　リポジトリのインポート」を参照してください。

(9)　HCSCコンポーネントの配備（運用環境）

「(8)　リポジトリのインポート（運用環境）」でインポートしたリポジトリ情報に含まれるHCSCコンポーネントをHCSCサーバに配備します。「(1)　リポジトリのエクスポート（運用環境）」でリポジトリをエクスポートしたときと同じ環境となるように配備します。

csccompodeployコマンド（-allオプション）を運用環境で実行してください。

HCSCコンポーネントの配備方法の詳細については，「3.1.8　サービスアダプタを配備する」および「3.1.13　ビジネスプロセスを配備する」を参照してください。

HCSCコンポーネントの配備後は，バージョンアップ前と同様にHCSCコンポーネントを操作できます。

付録H.3　更新インストールして運用環境のリポジトリを移行する手順

次の図に示す「(1)　各環境の更新インストール」〜「(6)　実行環境のバージョンアップ（運用環境）」の手順に従って，サービスプラットフォームを旧バージョンから11-70へ移行してください。

図H‒2　更新インストールする場合の移行手順（運用環境だけを移行する場合）

図H-2の「(1)　各環境の更新インストール」〜「(6)　実行環境のバージョンアップ（運用環境）」の手順の詳細を次に示します。

なお，手順内で使用するコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「5.　コマンド（運用環境・実行環境）」を参照してください。

(1)　各環境の更新インストール

運用環境および実行環境で11-70のサービスプラットフォームを更新インストールしてバージョンアップします。HCSC簡易セットアップ機能を利用してセットアップしたテスト環境の場合は，更新インストールする前に，HCSC簡易セットアップ機能を利用してアンセットアップを実行し，更新インストール後に再セットアップしてください。

各環境を更新インストールするときの前提条件を次に示します。

前提条件

HCSCサーバがセットアップ済みであること

サービスプラットフォームおよびReliable Messagingが停止していること

組み込みデータベースを使用している場合，組み込みデータベースを停止していること

HCSCサーバ，J2EEサーバ，およびHCSCコンポーネントが停止していること

注意

更新インストールする場合，次の点に注意してください。

J2EEサーバ，Management Server，PRFなど実行環境の構成要素を停止してから更新インストールしてください。

組み込みデータベースを使用している場合，組み込みデータベースを停止してから更新インストールしてください。

なお，更新インストールでは次のファイルを除いて上書きされます。

<サービスプラットフォームのインストールディレクトリ>¥CSC¥config¥manager¥csccmd.properties

<サービスプラットフォームのインストールディレクトリ>¥CSC¥config¥manager¥cscmng.properties

<サービスプラットフォームのインストールディレクトリ>¥CSC¥config¥msg¥cmdconf.bat

<サービスプラットフォームのインストールディレクトリ>¥CSC¥inbound-adapter¥ftp¥config¥command¥log4j.xml

<サービスプラットフォームのインストールディレクトリ>¥CSC¥inbound-adapter¥ftp¥config¥FTP_Inbound_Resource_Adapter¥serverstatus.properties

<サービスプラットフォームのインストールディレクトリ>¥CSC¥inbound-adapter¥ftp¥config¥FTP_Inbound_Resource_Adapter¥users.properties

<サービスプラットフォームのインストールディレクトリ>¥CSC¥system¥manager¥setup¥input.properties

(2)　J2EEサーバのクラスパスの変更

09-00より前のバージョンから移行する場合，J2EEサーバ用オプション定義ファイル（usrconf.cfg）に次に示す定義があれば削除してください。定義の変更はSmart Composer機能または運用管理ポータルの使用をお勧めします。

add.class.path=<TP1アダプタのインストールディレクトリ>¥lib¥adptp1rt.jar

add.class.path=<ファイルアダプタのインストールディレクトリ>¥lib¥adpffrt.jar

add.class.path=<Object Accessアダプタのインストールディレクトリ>¥lib¥adpoart.jar

add.class.path=<Object Accessアダプタのインストールディレクトリ>¥usrlib¥adpoaow.jar

add.class.path=<Message Queueアダプタのインストールディレクトリ>¥lib¥adpmqrt.jar

add.class.path=<FTPアダプタのインストールディレクトリ>¥lib¥adpftprt.jar

add.class.path=<FTPアダプタのインストールディレクトリ>¥lib¥ftp_common.jar

add.class.path=<コード変換ライブラリのインストールディレクトリ>¥java¥codeconv.jar

add.class.path=<TP1/Client/Jのインストールディレクトリ>¥LIB¥TP1Client.jar

(3)　旧オプションアダプタの定義ファイルの移行

09-00より前で使用していたオプションアダプタを移行する場合，次の作業を実施してください。

(a)　TP1アダプタの定義ファイルの移行

TP1アダプタ実行環境プロパティファイルをコピーします。コピー対象のファイルと，コピー先のディレクトリを次に示します。

コピー対象：<TP1アダプタのインストールディレクトリ>¥config¥*.properties

コピー先：<サービスプラットフォームのインストールディレクトリ>¥CSC¥custom-adapter¥TP1¥config¥

(b)　ファイルアダプタの定義ファイルの移行

ファイルアダプタ実行環境プロパティファイルをコピーします。コピー対象のファイルと，コピー先のディレクトリを次に示します。

コピー対象：<ファイルアダプタのインストールディレクトリ>¥config¥*.properties

コピー先：<サービスプラットフォームのインストールディレクトリ>¥CSC¥custom-adapter¥File¥config¥

(c)　Object Accessアダプタの定義ファイルの移行

Object Accessアダプタ実行環境プロパティファイルをコピーします。コピー対象のファイルと，コピー先のディレクトリを次に示します。

コピー対象：<Object Accessアダプタのインストールディレクトリ>¥config¥*.properties

コピー先：<サービスプラットフォームのインストールディレクトリ>¥CSC¥custom-adapter¥OA¥config¥

(d)　Message Queueアダプタの定義ファイルの移行

Message Queueアダプタ実行環境プロパティファイルをコピーします。コピー対象のファイルと，コピー先のディレクトリを次に示します。

コピー対象：<Message Queueアダプタのインストールディレクトリ>¥config¥*.properties

コピー先：<サービスプラットフォームのインストールディレクトリ>¥CSC¥custom-adapter¥MQ¥config¥

(e)　FTPアダプタの定義ファイルの移行

FTPアダプタコマンド定義ファイルとFTPアダプタ実行環境プロパティファイルをコピーします。コピー対象のファイルと，コピー先のディレクトリを次に示します。

コピー対象：<FTPアダプタのインストールディレクトリ>¥config¥*.properties

コピー先：<サービスプラットフォームのインストールディレクトリ>¥CSC¥custom-adapter¥FTP¥config¥

(4)　製品のアンインストール

09-00より前のバージョンから移行する場合，次の製品をアンインストールします。これらは09-00以降でサービスプラットフォームに同梱されるため，アンインストールすることをお勧めします。

Service Adapter for Flat Files

Service Adapter Architect for Flat Files

Service Adapter for FTP

Service Adapter Architect for FTP

Service Adapter for Message Queue

Service Adapter Architect for Message Queue

Service Adapter for Object Access

Service Adapter Architect for Object Access

Service Adapter for TP1

Service Adapter Architect for TP1

コード変換 - Development Kit

コード変換 - Server Runtime

コード変換 - Runtime

TP1/Client/J

(5)　サービスプラットフォームおよびReliable Messagingの移行（実行環境）

次の手順でサービスプラットフォームおよびReliable Messagingを移行してください。09-00より前のバージョンから移行する場合は，次の作業も必要です。

移行コマンド（mngenvupdateコマンド）の実行

mserver.properties（Management Server環境設定ファイル）へのプロパティの追加

次のプロパティを追加してください。追加しないでManagement Serverを起動すると，cscで始まるコマンドがエラーになる場合があります。プロパティの追加方法については，「2.1.6(1)　mserver.properties（Management Server環境設定ファイル）の設定」を参照してください。

ejbserver.naming.port
ejbserver.server.edition.settingforce

サービスプラットフォームの移行方法の詳細については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「10.　旧バージョンのアプリケーションサーバからの移行（J2EEサーバモードの場合）」を参照してください。

(6)　実行環境のバージョンアップ（運用環境）

運用環境から実行環境のバージョンアップを実施します。

(a)　前提条件

実行環境をバージョンアップするには，次の条件を満たしている必要があります。

Management Serverが起動していること

組み込みデータベースを使用している場合，組み込みデータベースが起動していること

リポジトリのバージョンがインストールバージョンより古いか，一致していること

リポジトリのバージョンがインストールバージョンより古い場合，リポジトリのバージョンが08-00以降であること

FTPインバウンドアダプタを使用する場合，cjrarupdateコマンド※でのリソースアダプタのバージョンアップが完了していること

注※

cjrarupdateコマンドには次のオプションを指定してください。

　-typeオプション：「rar」

　-fオプション：「<サービスプラットフォームのインストールディレクトリ>¥CSC¥inbound-adapter¥ftp¥rar¥ftp_inbound_adapter.rar」

cjrarupdateコマンドの詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjrarupdate（リソースアダプタのバージョンアップ）」を参照してください。

なお，09-50以前のバージョンからFTPインバウンドアダプタをバージョンアップすると，FTPレスポンスに使用されるデフォルトの終端文字がOS依存の改行コードからCRLFに変更されます。終端文字をOS依存の改行コードに戻したい場合は，cjgetrarpropコマンドでFTPインバウンドアダプタのRARファイルから属性ファイルを取得したあと，定義を変更し，cjsetrarpropコマンドで属性ファイルを設定してください。属性ファイルの設定については，「3.2.3(3) FTPインバウンドアダプタの設定」を参照してください。

KafkaインバウンドアダプタまたはgRPCインバウンドアダプタを使用している場合，リソースアダプタのバージョンアップが完了していること

リソースアダプタのバージョンアップは次の手順で実施してください。cjrarupdateコマンドは使用できません。

KafkaインバウンドアダプタおよびgRPCインバウンドアダプタの属性ファイルを取得する

属性ファイルの定義項目を設定している場合は，セットアップで各項目の再設定が必要になります。必ずインバウンドアダプタのアンセットアップ前に属性ファイルを取得してください。

KafkaインバウンドアダプタおよびgRPCインバウンドアダプタをアンセットアップする

インバウンドアダプタのアンセットアップの詳細については，「3.3.5　KafkaインバウンドアダプタおよびgRPCインバウンドアダプタをアンセットアップする」を参照してください。

KafkaインバウンドアダプタおよびgRPCインバウンドアダプタをセットアップする

インバウンドアダプタのセットアップの詳細については，「3.1.2(11)　Kafkaインバウンドアダプタのセットアップ」または「3.1.2(12)　gRPCインバウンドアダプタのセットアップ」を参照してください。

gRPCプロトコルを利用した接続機能を利用する場合，gRPCライブラリ（OSS）をインストールする

gRPCプロトコルを利用した接続機能を利用する場合は，マニュアル「サービスプラットフォーム 解説」の「2.13.1　gRPCプロトコルを利用したシステム」を参照して，「(1)　gRPCプロトコルを利用した接続に必要なOSS」から更新が必要なOSSがないか確認してください。更新が必要なOSSがある場合，「(2)　gRPCライブラリ（OSS）のインストール」に従ってインストールしてください。

前提条件を満たしていない場合，上記の順番で起動，停止，およびバージョンアップを実施してください。

(b)　バージョンアップ方法

cscenvupdateコマンドを実行して，リポジトリとHCSCサーバをバージョンアップします。

cscenvupdate -csc <バージョンアップするHCSCサーバ名>

なお，旧バージョンで使用していたリポジトリ情報を開発環境でバージョンアップ前後に変更し，そのリポジトリ情報を使用して運用する場合のバージョンアップ方法については，マニュアル「サービスプラットフォーム開発ガイド 基本開発編」の「付録A　旧バージョンからの移行」を参照してください。

注意事項

HCSCコンポーネントが開始状態でHCSCサーバを停止して，実行環境のバージョンアップを実施した場合，次回のHCSCサーバの起動時には，HCSCコンポーネントが停止した状態となります。そのため，HCSCサーバ起動後にHCSCコンポーネントを開始する必要があります。

付録H.4　ローリングアップデートで運用環境のリポジトリを移行する手順

ローリングアップデートとは，システムを全面停止しないで，更新インストールで移行する方法です。

ローリングアップデートで移行する場合，2台以上のHCSCサーバでロードバランスクラスタを構成している必要があります。

次の図に示す「(1)　リポジトリのエクスポート（運用環境）」〜「(13)　リクエストの送信制御の解除（ロードバランサ）」の手順に従って，サービスプラットフォームを旧バージョンから11-70へ移行してください。

図H‒3　ローリングアップデートの場合の移行手順（運用環境だけを移行する場合）

図H-3の「(1)　リポジトリのエクスポート（運用環境）」〜「(13)　リクエストの送信制御の解除（ロードバランサ）」の手順の詳細と，2台目以降のHCSCサーバ（実行環境）に対して実施する作業を次に示します。

なお，手順内で使用するコマンドの詳細については，マニュアル「サービスプラットフォーム リファレンス」の「5.　コマンド（運用環境・実行環境）」を参照してください。

注意事項

ローリングアップデートでの移行が完了するまで，旧バージョンのシステムに対して，次の操作はできません。

cscsvsetupコマンドで，新規にHCSCサーバをセットアップする

csccompodeployコマンドで，新規にHCSCコンポーネントを配備する

(1)　リポジトリのエクスポート（運用環境）

バージョンアップ前の運用環境のリポジトリをエクスポートして，いったん退避します。複数のリポジトリを使用している場合は，すべてのリポジトリをエクスポートして退避します。

cscrepctlコマンド（-exportオプション）を運用環境で実行して，バージョンアップ前のリポジトリをエクスポートしてください。

リポジトリのエクスポート方法の詳細については，「4.2　リポジトリのエクスポート」を参照してください。

(2)　運用環境のインストール

運用環境で11-70のサービスプラットフォームをインストールしてバージョンアップします。運用環境は，新規インストールまたは更新インストールでインストールします。

新規にインストールする場合

「付録H.2　新規にインストールして運用環境のリポジトリを移行する手順」の「(2)　HCSCコンポーネントの削除（運用環境）」〜「(5)　各環境のインストール」の作業を実施します。

更新インストールする場合

「付録H.3　更新インストールして運用環境のリポジトリを移行する手順」の「(1)　各環境の更新インストール」の作業を実施します。

注意

更新インストールする場合，インストールする環境で，J2EEサーバ，Management Server，PRFなどのサービスプラットフォーム実行環境が稼働中の場合は，すべていったん停止してから更新インストールしてください。

インストールするときの前提条件を次に示します。

前提条件

HCSCサーバがセットアップ済みであること

サービスプラットフォームおよびReliable Messagingが停止していること

組み込みデータベースを使用している場合，組み込みデータベースを停止していること

HCSCサーバ，J2EEサーバ，およびHCSCコンポーネントが停止していること

(3)　製品のアンインストール（運用環境）

09-00より前のバージョンから移行する場合，次の製品をアンインストールします。これらは09-00以降でサービスプラットフォームに同梱されるため，アンインストールすることをお勧めします。

Service Adapter for Flat Files

Service Adapter Architect for Flat Files

Service Adapter for FTP

Service Adapter Architect for FTP

Service Adapter for Message Queue

Service Adapter Architect for Message Queue

Service Adapter for Object Access

Service Adapter Architect for Object Access

Service Adapter for TP1

Service Adapter Architect for TP1

コード変換 - Development Kit

コード変換 - Server Runtime

コード変換 - Runtime

TP1/Client/J

(4)　リクエストの送信制御（ロードバランサ）

バージョンアップするHCSCサーバに対してリクエストを送信しないように，ロードバランサを設定します。その際，仕掛かり中のリクエストがないことを確認してください。なお，設定方法は各ロードバランサの仕様によって異なります。

(5)　実行環境のインストール（実行環境）

実行環境で，11-70のサービスプラットフォームをインストールしてバージョンアップします。

実行環境は，新規インストールまたは更新インストールのどちらかの方法でインストールします。

新規にインストールする場合

「付録H.2　新規にインストールして運用環境のリポジトリを移行する手順」の「(2)　HCSCコンポーネントの削除（運用環境）」〜「(6)　HCSCサーバの構築（運用環境）」の作業を実施します。

更新インストールする場合

「付録H.3　更新インストールして運用環境のリポジトリを移行する手順」の「(1)　各環境の更新インストール」の作業を実施します。

(6)　J2EEサーバのクラスパスの変更（実行環境）

09-00より前のバージョンから移行する場合，J2EEサーバ用オプション定義ファイル（usrconf.cfg）に次に示す定義があれば削除してください。定義の変更はSmart Composer機能または運用管理ポータルの使用をお勧めします。

add.class.path=<TP1アダプタのインストールディレクトリ>¥lib¥adptp1rt.jar

add.class.path=<ファイルアダプタのインストールディレクトリ>¥lib¥adpffrt.jar

add.class.path=<Object Accessアダプタのインストールディレクトリ>¥lib¥adpoart.jar

add.class.path=<Object Accessアダプタのインストールディレクトリ>¥usrlib¥adpoaow.jar

add.class.path=<Message Queueアダプタのインストールディレクトリ>¥lib¥adpmqrt.jar

add.class.path=<FTPアダプタのインストールディレクトリ>¥lib¥adpftprt.jar

add.class.path=<FTPアダプタのインストールディレクトリ>¥lib¥ftp_common.jar

add.class.path=<コード変換ライブラリのインストールディレクトリ>¥java¥codeconv.jar

add.class.path=<TP1/Client/Jのインストールディレクトリ>¥LIB¥TP1Client.jar

(7)　旧オプションアダプタの定義ファイルの移行（実行環境）

09-00より前で使用していたオプションアダプタを移行する場合，次の作業を実施してください。

(a)　TP1アダプタの定義ファイルの移行

TP1アダプタ実行環境プロパティファイルをコピーします。コピー対象のファイルと，コピー先のディレクトリを次に示します。

コピー対象：<TP1アダプタのインストールディレクトリ>¥config¥*.properties

コピー先：<サービスプラットフォームのインストールディレクトリ>¥CSC¥custom-adapter¥TP1¥config¥

(b)　ファイルアダプタの定義ファイルの移行

ファイルアダプタ実行環境プロパティファイルをコピーします。コピー対象のファイルと，コピー先のディレクトリを次に示します。

コピー対象：<ファイルアダプタのインストールディレクトリ>¥config¥*.properties

コピー先：<サービスプラットフォームのインストールディレクトリ>¥CSC¥custom-adapter¥File¥config¥

(c)　Object Accessアダプタの定義ファイルの移行

Object Accessアダプタ実行環境プロパティファイルをコピーします。コピー対象のファイルと，コピー先のディレクトリを次に示します。

コピー対象：<Object Accessアダプタのインストールディレクトリ>¥config¥*.properties

コピー先：<サービスプラットフォームのインストールディレクトリ>¥CSC¥custom-adapter¥OA¥config¥

(d)　Message Queueアダプタの定義ファイルの移行

Message Queueアダプタ実行環境プロパティファイルをコピーします。コピー対象のファイルと，コピー先のディレクトリを次に示します。

コピー対象：<Message Queueアダプタのインストールディレクトリ>¥config¥*.properties

コピー先：<サービスプラットフォームのインストールディレクトリ>¥CSC¥custom-adapter¥MQ¥config¥

(e)　FTPアダプタの定義ファイルの移行

FTPアダプタコマンド定義ファイルとFTPアダプタ実行環境プロパティファイルをコピーします。コピー対象のファイルと，コピー先のディレクトリを次に示します。

コピー対象：<FTPアダプタのインストールディレクトリ>¥config¥*.properties

コピー先：<サービスプラットフォームのインストールディレクトリ>¥CSC¥custom-adapter¥FTP¥config¥

(8)　製品のアンインストール（実行環境）

09-00より前のバージョンから移行する場合，次の製品をアンインストールします。これらは09-00以降でサービスプラットフォームに同梱されるため，アンインストールすることをお勧めします。

Service Adapter for Flat Files

Service Adapter Architect for Flat Files

Service Adapter for FTP

Service Adapter Architect for FTP

Service Adapter for Message Queue

Service Adapter Architect for Message Queue

Service Adapter for Object Access

Service Adapter Architect for Object Access

Service Adapter for TP1

Service Adapter Architect for TP1

コード変換 - Development Kit

コード変換 - Server Runtime

コード変換 - Runtime

TP1/Client/J

(9)　サービスプラットフォームおよびReliable Messagingの移行（実行環境）

次の手順でサービスプラットフォームおよびReliable Messagingを移行してください。09-00より前のバージョンから移行する場合は，次の作業も必要です。

移行コマンド（mngenvupdateコマンド）の実行

mserver.properties（Management Server環境設定ファイル）へのプロパティの追加

次のプロパティを追加してください。追加しないでManagement Serverを起動すると，cscで始まるコマンドがエラーになる場合があります。プロパティの追加方法については，「2.1.6(1)　mserver.properties（Management Server環境設定ファイル）の設定」を参照してください。

ejbserver.naming.port
ejbserver.server.edition.settingforce

サービスプラットフォームの移行方法の詳細については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「10.　旧バージョンのアプリケーションサーバからの移行（J2EEサーバモードの場合）」を参照してください。

(10)　実行環境のバージョンアップ（運用環境）

運用環境から実行環境のバージョンアップを実施します。

(a)　前提条件

実行環境をバージョンアップするには，次の条件を満たしている必要があります。

Management Serverが起動していること

組み込みデータベースを使用している場合，組み込みデータベースが起動していること

リポジトリのバージョンがインストールバージョンより古いか，一致していること

リポジトリのバージョンがインストールバージョンより古い場合，リポジトリのバージョンが08-00以降であること

前提条件を満たしていない場合，上記の順番で起動，停止，およびバージョンアップを実施してください。

(b)　バージョンアップ方法

cscenvupdateコマンドを実行して，リポジトリとHCSCサーバをバージョンアップします。

cscenvupdate -csc <バージョンアップするHCSCサーバ名>

(11)　HCSCサーバの起動（運用環境）

バージョンアップしたHCSCサーバを起動します。

(12)　HCSCコンポーネントの開始（運用環境）

「(10)　実行環境のバージョンアップ（運用環境）」で起動したHCSCサーバに配備されているHCSCコンポーネントを開始します。

(13)　リクエストの送信制御の解除（ロードバランサ）

バージョンアップしたHCSCサーバに対してリクエストを送信するように，ロードバランサを設定します。なお，設定方法は各ロードバランサの仕様によって異なります。

(14)　2台目以降のHCSCサーバ（実行環境）に対しての作業

ロードバランスクラスタを構成しているすべてのHCSCサーバに対して，「(4)　リクエストの送信制御（ロードバランサ）」〜「(13)　リクエストの送信制御の解除（ロードバランサ）」の作業を実施します。

なお，旧バージョンで使用していたリポジトリ情報を開発環境でバージョンアップ前後に変更し，そのリポジトリ情報を使用して運用する場合のバージョンアップ方法については，マニュアル「サービスプラットフォーム開発ガイド 基本開発編」の「付録A　旧バージョンからの移行」を参照してください。

(15)　ローリングアップデートで移行する場合の注意事項

ローリングアップデートで移行する場合の注意事項は，開発環境，運用環境および実行環境のバージョンアップ時と同じです。ローリングアップデートで移行する場合の注意事項については，「付録G.4(15)　ローリングアップデートで移行する場合の注意事項」を参照してください。

付録H.5　移行後の設定

移行後の設定は，開発環境，運用環境および実行環境のバージョンアップ時と同じです。移行したあとの注意事項については，「付録G.5　移行後の設定（07-50より前のバージョンから移行する場合）」を参照してください。

付録I　リソースの見積もり

付録I.1　ファイルディスクリプタ数の見積もり

(1)　ファイルディスクリプタ数の計算式

HCSCサーバを利用したシステムで使用するファイルディスクリプタ数は，次に示す計算式で最大値を見積もります。

ファイルディスクリプタ数の最大値= （A＋A'＋B＋C）×1.25

計算式の各項目の説明を次に示します。

A：HCSCサーバ（J2EEサーバ）が使用するファイルディスクリプタ数

Aは次の式で算出します。

J2EEサーバのファイルディスクリプタ数※＋49

注※

J2EEサーバが使用するファイルディスクリプタ数は，マニュアル「アプリケーションサーバ システム設計ガイド」の「5.2.1　J2EEサーバが使用するリソースの見積もり」に記載されているファイルディスクリプタ数の計算式（以降，「J2EEサーバの計算式」と記載）を参照して見積もってください。なお，計算式に必要な情報は，「(2) ファイルディスクリプタ数の計算式に使用する値」の表の列「計算式（項目A）でJ2EEサーバの計算式に使用する値」の値を参照してください。

A'：Σ（HCSCサーバ（J2EEサーバ）の設定内容に依存して増加するファイルディスクリプタ数）

A'は次の式で算出します。

a＋b＋c＋d＋e＋f

a〜fの詳細を次に示します。

a：HCSCサーバで出力するログの種類（電文トレース，リクエストトレース，アクティビティトレース）×2

b：カスタムファンクションを使う場合，使用するjarファイル数

c：値置換えファンクションを使う場合，使用するcsvファイル数

d：Kafka関連のHCSCコンポーネント（Kafkaインバウンドアダプタ，Kafka受付，またはKafkaアダプタ）を使う場合だけ「1」を加算

e：gRPC関連のHCSCコンポーネント（gRPCインバウンドアダプタ，gRPC受付，またはgRPCアダプタ）を使う場合だけ「35」を加算

f：拡張モードのJSON-XML変換機能を使う場合だけ「5」を加算

B：Σ（HCSCコンポーネントが起動だけに使用するファイルディスクリプタ数）

Bには「(2) ファイルディスクリプタ数の計算式に使用する値」を参照して，使用するHCSCコンポーネントの列「計算式（項目B）」の値を割り当ててください。

Bの値は，J2EEサーバの計算式のEとHを含める値を合わせたものに相当します。J2EEサーバまたはHCSCサーバのファイルディスクリプタ数を見積もる際に使用してください。

C：Σ（HCSCコンポーネントがリクエストで使用するファイルディスクリプタ数）

Cには「(2) ファイルディスクリプタ数の計算式に使用する値」を参照して，使用するHCSCコンポーネントの列「計算式（項目C）」の値を割り当ててください。

(2)　ファイルディスクリプタ数の計算式に使用する値

(1)の計算式の各項目に適用する値は，HCSCコンポーネントの種類によって異なります。計算式の各項目で使用する値を次の表に示します。

表I‒1　各HCSCコンポーネントが使用するファイルディスクリプタ数

HCSCコンポーネントの種類

計算式（項目A）でJ2EEサーバの計算式に使用する値

計算式（項目B）

計算式（項目C）

ビジネスプロセス

−

4＋(3×ビジネスプロセス数)＋N

N：

ログ出力アクティビティを使用する場合，次の式で求めた値を設定する。

1＋ログ出力アクティビティ定義ファイルに定義したログ出力識別子の数＋ログ出力アクティビティ定義ファイルに定義したメッセージ定義ファイルの数

サービスエミュレーション機能を使用しない場合：

0

サービスエミュレーション機能を使用する場合：

エミュレーション対象のサービスアダプタの最大同時実行数の合計×3

標準受付

SOAP

J2EEサーバの計算式C：

HCSCサーバランタイム定義ファイルの次に示すプロパティの指定値を合計して割り当ててください。

request-soap.instance.maximumプロパティ

request-soap1_2.instance.maximumプロパティ

3

0

EJB

J2EEサーバの計算式B：

HCSCサーバランタイム定義ファイルのrequest-ejb.instance.maximumプロパティの指定値を割り当ててください。

1

0

ユーザ定義受付

SOAP受付

J2EEサーバの計算式C：

ユーザ定義受付ランタイム定義ファイルのuser-defined-reception-soap.threads.maximumプロパティの指定値を割り当ててください。

1×受付数

全受付の次の算出結果の合計値。

添付ファイル数×最大同時実行数

最大同時実行数：

ユーザ定義受付ランタイム定義ファイルのuser-defined-reception-soap.threads.maximumプロパティの指定値

TP1/RPC受付

J2EEサーバの計算式D：

式の「各MDB（サービス）のMessage-driven Bean属性ファイルの<pooled-instance><maximum>に指定した値」には，TP1/RPC受付定義ファイルのurecp-tp1rpc.pooled-instance.maximumプロパティの合計値を割り当ててください。

6×受付数

0

FTP受付

−

3×受付数

全受付の，FTP受付定義ファイルのurecp-ftp.pooled-instance.maximumプロパティの指定値の合計値。

HTTP受付

J2EEサーバの計算式C：

HTTP受付定義ファイルのurecp-http.pooled-instance.maximumプロパティの指定値を割り当ててください。

HTTP受付のエラー応答カスタマイズ機能を使用しない場合

4×受付数

HTTP受付のエラー応答カスタマイズ機能を使用する場合

5×受付数

全受付の以下算出結果の合計値。

（受信ファイル数＋送信ファイル数）×インスタンス最大数×n

インスタンス最大数：

HTTP受付定義ファイルのurecp-http.pooled-instance.maximumプロパティの指定値

n：

HTTP受付のエラー応答カスタマイズ機能で，レスポンスヘッダとレスポンスボディの両方を返却させる場合は，nに「2」を割り当てる

どちらか一方を返却させる場合はnに「1」を割り当てる

Message Queue受付

−

4×受付数

0

MQリソースアダプタのファイルディスクリプタ数計算で，各サービスのプールインスタンス数が必要な場合は，Message Queue受付定義ファイルのpooled-instance.maximumプロパティの指定値を割り当ててください。

ファイルイベント受付

−

8×受付数

全受付の以下算出結果の合計値。

更新完了通知ファイルを監視する場合

2（更新完了通知ファイル＋排他管理）×最大スレッド数

取得対象ファイルを監視する場合

2（取得対象ファイル＋排他管理）×最大スレッド数

最大スレッド数：

ファイルイベント受付定義ファイルのurecp-fileevent.thread-pool.maximumプロパティの指定値

Kafka受付

−

3×受付数

0

スケジュール駆動受付

−

8×受付数

0

gRPC受付

−

3×受付数

0

カスタム受付

（ユーザ定義部分は含まない）

−

2×受付数

0

サービスアダプタ

SOAPアダプタ

−

3×アダプタ数

全アダプタの以下算出結果の合計値。

（添付ファイル数＋1）×各アダプタの最大インスタンス数

SessionBeanアダプタ

−

4×アダプタ数

各アダプタの最大インスタンス数の合計値。

DBアダプタ

−

6×アダプタ数

0

TP1アダプタ

−

TP1アダプタ実行環境プロパティファイルをHCSCサーバごとに設定しない場合

10×アダプタ数＋TP1アダプタ通信構成定義ファイルの<con_pool_num>の指定値×2

TP1アダプタ実行環境プロパティファイルをHCSCサーバごとに設定する場合

11×アダプタ数＋TP1アダプタ通信構成定義ファイルの<con_pool_num>の指定値×2

全アダプタの最大インスタンス数の合計値。

ファイルアダプタ

−

6×アダプタ数

全アダプタの最大インスタンス数の合計値。

Message Queueアダプタ

−

10×アダプタ数

次のプロパティの指定値の中で最も小さい値。

全アダプタの最大インスタンス数の合計

MQリソースアダプタのアプリケーション統合属性ファイルの//hitachi-connector-property/resourceadapter/property[./property-name=' MaxTPoolSize'] ../property-value

MQリソースアダプタのアプリケーション統合属性ファイルの//hitachi-connector-property/resourceadapter/config-property[./config-property-name='maxConnections'] ../config-property-value

FTPアダプタ

−

(13＋n)×アダプタ数

nには，HCSCサーバごとにFTPアダプタ実行環境プロパティファイルとFTPアダプタ実行環境共通プロパティファイルの両方を設定する場合，2を割り当てる。

どちらか一方を設定する場合，1を割り当てる。

3×全アダプタの最大インスタンス数の合計値。

ファイル操作アダプタ

−

8×アダプタ数

2×全アダプタの最大インスタンス数の合計値。

メールアダプタ

−

メールアダプタ実行環境プロパティファイルをHCSCサーバごとに設定しない場合

10×アダプタ数

メールアダプタ実行環境プロパティファイルをHCSCサーバごとに設定する場合

11×アダプタ数

添付ファイルおよび本文に挿入するテキストファイルを使用する場合

（添付ファイル数＋本文ファイル数）×全アダプタの最大インスタンス数の合計値。

上記以外の場合

0

HTTPアダプタ

−

(9＋1※1＋1※2＋n※3)×アダプタ数

注※1：

OAuth 2.0を使う場合

注※2：

ベーシック認証をする場合

注※3：

HCSCサーバごとに，HTTPアダプタ実行環境プロパティファイルまたはHTTPアダプタ実行環境共通プロパティファイルのどちらかを設定する場合：1

HCSCサーバごとに，HTTPアダプタ実行環境プロパティファイルとHTTPアダプタ実行環境共通プロパティファイルの両方を設定する場合：2

全アダプタの以下算出結果の合計値。

（送信添付ファイル数＋受信添付ファイル数＋1）×各アダプタの最大インスタンス数

OAuth 2.0を使う場合は，この合計値に秘密鍵ファイル数を加算する。

コマンドアダプタ

（ユーザ定義部分は含まない）

−

(13＋n)×アダプタ数

nには，HCSCサーバごとにコマンドアダプタ実行環境プロパティファイルとコマンドアダプタ実行環境共通プロパティファイルの両方を設定する場合，2を割り当てる。

どちらか一方を設定する場合，1を割り当てる。

0

SFTPアダプタ

−

(11＋n＋m)×アダプタ数

n：

パスワード認証と公開鍵認証のどちらかを設定する場合は1，パスワード認証と公開鍵認証の両方を設定する場合は2を割り当てる

m：

HCSCサーバごとに，SFTPアダプタ実行環境プロパティファイルまたはSFTPアダプタ実行環境共通プロパティファイルのどちらかを設定する場合：1

HCSCサーバごとに，SFTPアダプタ実行環境プロパティファイルとSFTPアダプタ実行環境共通プロパティファイルの両方を設定する場合：2

ホスト認証を実施する場合

3×全アダプタの最大インスタンス数の合計

公開鍵認証を実施する場合

2×全アダプタの最大インスタンス数の合計＋秘密鍵ファイル数

Kafkaアダプタ

−

(11＋n＋m)×アダプタ数

n：

クライアント認証とサーバ認証のどちらかを使用する場合は1，クライアント認証とサーバ認証の両方を使用する場合は2を割り当てる

m：

HCSCサーバごとに，Kafkaアダプタ実行環境プロパティファイルまたはKafkaアダプタ実行環境共通プロパティファイルのどちらかを設定する場合：1

HCSCサーバごとに，Kafkaアダプタ実行環境プロパティファイルとKafkaアダプタ実行環境共通プロパティファイルの両方を設定する場合：2

0

gRPCアダプタ

−

(11＋n＋m)×アダプタ数

n：

サーバ認証を使用する場合は1，双方向認証を使用する場合は3を割り当てる

m：

HCSCサーバごとに，gRPCアダプタ実行環境プロパティファイルまたはgRPCアダプタ実行環境共通プロパティファイルのどちらかを設定する場合：1

HCSCサーバごとに，gRPCアダプタ実行環境プロパティファイルとgRPCアダプタ実行環境共通プロパティファイルの両方を設定する場合：2

0

汎用カスタムアダプタ

（ユーザ定義部分は含まない）

−

2×アダプタ数

0

リソースアダプタ

FTPインバウンドアダプタ

−

26

2×最大同時接続数

最大同時接続数：

FTPインバウンドアダプタの属性ファイルのserver_maxLoginsの指定値

TP1インバウンドアダプタ

J2EEサーバの計算式Dで見積もってください。

Kafkaインバウンドアダプタ

−

5

0

gRPCインバウンドアダプタ

−

8＋n

n：

サーバ認証を使用する場合は1，クライアント認証を使用する場合は3を割り当てる

0

（凡例）

−：該当なし

付録I.2　スレッド数の見積もり

HCSCサーバを利用したシステムで使用するスレッド数は，次に示す計算式で最大値を見積もります。

スレッド数の最大値= J2EEサーバのスレッド数＋HCSCサーバのスレッド数

計算式の各項目の説明を次に示します。

J2EEサーバのスレッド数

次の式で算出します。

76＋A＋B＋C＋D＋E＋F＋G＋H＋I＋J＋K＋L＋M＋N＋O＋P＋Q＋R＋S

これらの計算式の各項目については，マニュアル「アプリケーションサーバ システム設計ガイド」の「5.2.1　J2EEサーバが使用するリソースの見積もり」に記載されているスレッド数の記述を参照してください。

HCSCサーバのスレッド数

次の式で算出します。

　12＋a＋b＋c＋d＋e＋f

各項目の説明を次に示します。

a：MDBのスレッド数

使用する受付に応じて，次の計算結果を割り当ててください。

・Message Queue受付またはgRPC受付を使用する場合
　Σ（各受付の独自定義ファイルのpooled-instance.maximumの設定値）
・Kafka受付を使用する場合
　受付数

b：SessionBeanのスレッド数

標準受付（EJB）を使用する場合，次の計算結果を割り当ててください。

クライアント数×2＋HCSCサーバランタイム定義ファイルのrequest-ejb.instance.maximumプロパティの設定値＋1

c：Webアプリケーション数

使用する受付のWebアプリケーション数を次の表で確認し，合計を割り当ててください。

受付

Webアプリケーション数

標準受付（SOAP1.1モード）

1

標準受付（SOAP1.1/1.2併用モード）

2

ユーザ定義受付（SOAP受付）

受付数

ユーザ定義受付（HTTP受付）

受付数

d：TP1連携で使用するスレッド数

TP1受付を使用する場合だけ，次の計算結果を割り当ててください。

TP1インバウンドアダプタのスレッド数
（4＋TP1インバウンドアダプタのrpc_max_thread_countプロパティに設定したスレッド数
＋TP1インバウンドアダプタのtrn_max_thread_countプロパティに設定したスレッド数
＋TP1受付数
＋TP1インバウンドアダプタのMaxTPoolSizeプロパティの設定値）

e：非同期SessionBeanで使用するスレッド数

使用するHCSCサーバの機能の計算式を次の表で確認し，合計を割り当ててください。

HCSCサーバの機能

計算式

ビジネスプロセスの応答後実行

HCSCサーバセットアップ定義ファイルにrm-use＝OFFを設定している場合，または非永続のビジネスプロセスで応答後実行を使用する場合，次の計算結果

2＋HCSCサーバランタイム定義ファイルのbp-reply-after-max-thread-pool-sizeプロパティの設定値

待機アクティビティ

usrconf.propertiesのejbserver.ejb.timerservice.maxCallbackThreadsの設定値

標準受付（WSR）

HCSCサーバセットアップ定義ファイルにrequest-jms＝ONを設定している場合，Cosminexus_Reliable_MessagingのConnector属性ファイルのMaxPoolSizeの設定値

標準受付（DBQ）

HCSCサーバセットアップ定義ファイルにrequest-dbq=ONを設定している場合，Cosminexus_Reliable_MessagingのConnector属性ファイルのMaxPoolSizeの設定値

f：独自にスレッドを使用するHCSCサーバの機能のスレッド数

使用するHCSCコンポーネントの計算式を次の表で確認し，合計を割り当ててください。

HCSCコンポーネント

計算式

FTP連携

FTPインバウンドアダプタを使用する場合，次の計算結果

3＋Connector属性ファイルのMaxTPoolSizeの設定値×2

ファイルイベント受付

1＋受付数×2＋Σ（各受付の独自定義ファイルのurecp-fileevent.thread-pool.maximumの設定値）

FTP受付

FTP受付コンフィグファイルのurecp-ftp.request-timeoutプロパティに1以上の値を設定した場合，次の計算結果

受付数＋Σ（各受付のFTP受付コンフィグファイルのurecp-ftp.timer-thread.maximumプロパティの設定値）

スケジュール駆動受付

受付数＋Σ（各受付のスケジュール駆動受付定義ファイルのurecp-scd.task.processing-max.parallel.countプロパティの設定値×2）

スケジュール駆動受付コンフィグファイルのプロパティurecp-scd.request-timeoutに1以上の値を設定した場合，次の計算結果を追加する。

Σ（各受付のスケジュール駆動受付定義ファイルのurecp-scd.task.processing-max.parallel.countプロパティの設定値）

Object Accessアダプタ

TPBroker環境定義ファイルにvbroker.ce.iiop.ccm.htc.readerPerConnection=trueを指定する場合

アダプタ数×5

TPBroker環境定義ファイルにvbroker.ce.iiop.ccm.htc.readerPerConnection=trueを指定しない場合

アダプタ数×4

FTPアダプタ

Σ（各アダプタの同時実行数＋アダプタ数※）

注※

FTPアダプタ実行環境プロパティファイルの定義にftpadp.session.keep=TRUEを指定する場合に加算する。

コマンドアダプタ

Σ（各アダプタの同時実行数×3）

SFTPアダプタ

Σ（各アダプタの同時実行数）

Kafkaアダプタ

Σ（各アダプタの同時実行数）

Kafkaインバウンドアダプタ

1＋Connector属性ファイルのMaxTPoolSizeの設定値×2

gRPCアダプタ

アダプタ数＋Σ（各アダプタの同時実行数）

gRPCインバウンドアダプタ

1＋gRPC受付数＋Connector属性ファイルのthreadPoolSizeの設定値

付録J　旧バージョンからの仕様変更

旧バージョンからの仕様変更について説明します。

付録J.1　サービスプラットフォーム 09-71からの仕様変更

サービスプラットフォーム 09-71からの仕様変更を次の表に示します。なお，仕様変更の表の「仕様変更の項目」の項番は，「付録J.9　旧バージョンからの仕様変更の一覧」の説明の項番と対応しています。

(1)　ログの出力先に関する仕様変更

サービスプラットフォーム 09-71から移行する場合で，ログの出力先に関する仕様変更を次の表に示します。

分類

仕様変更の項目

全体

(1) ログの出力先に関する仕様変更

付録J.2　サービスプラットフォーム 09-87からの仕様変更

サービスプラットフォーム 09-87からの仕様変更を次の表に示します。なお，仕様変更の表の「仕様変更の項目」の項番は，「付録J.9　旧バージョンからの仕様変更の一覧」の説明の項番と対応しています。

(1)　ユーザ定義受付に関する仕様変更

サービスプラットフォーム 09-87から移行する場合で，ユーザ定義受付に関する仕様変更を次の表に示します。

分類

仕様変更の項目

全体

(2) ユーザ定義受付に関する仕様変更

(2)　サービスアダプタ定義画面に関する仕様変更

サービスプラットフォーム 09-87から移行する場合で，サービスアダプタ定義画面に関する仕様変更を次の表に示します。

分類

仕様変更の項目

全体

(3) サービスアダプタ定義画面の基本画面に関する仕様変更

(3)　メッセージテキストKEOS52272-Iに関する仕様変更

サービスプラットフォーム 09-87から移行する場合で，メッセージテキストKEOS52272-Iに関する仕様変更を次の表に示します。

分類

仕様変更の項目

全体

(4) メッセージテキストKEOS52272-Iに関する仕様変更

付録J.3　サービスプラットフォーム 11-00からの仕様変更

サービスプラットフォーム 11-00からの仕様変更を次の表に示します。なお，仕様変更の表の「仕様変更の項目」の項番は，「付録J.9　旧バージョンからの仕様変更の一覧」の説明の項番と対応しています。

(1)　TP1アダプタの障害対策に関する仕様変更

サービスプラットフォーム 11-00から移行する場合で，TP1アダプタに関する仕様変更を次の表に示します。

分類

仕様変更の項目

全体

(5) TP1アダプタの障害対策に関する仕様変更

(2)　非推奨とする機能に関する仕様変更

サービスプラットフォーム 11-00から移行する場合で，非推奨とする機能に関する仕様変更を次の表に示します。

分類

仕様変更の項目

全体

(6) 非推奨とする機能に関する仕様変更

付録J.4　サービスプラットフォーム 11-10からの仕様変更

サービスプラットフォーム 11-10からの仕様変更を次の表に示します。なお，仕様変更の表の「仕様変更の項目」の項番は，「付録J.9　旧バージョンからの仕様変更の一覧」の説明の項番と対応しています。

(1)　カスタム受付のリクエスト処理に関する仕様変更

サービスプラットフォーム 11-10から移行する場合で，カスタム受付のリクエスト処理に関する仕様変更を次の表に示します。

分類

仕様変更の項目

全体

(7) カスタム受付のリクエスト処理に関する仕様変更

(2)　HCSCサーバの起動時間に関する仕様変更

サービスプラットフォーム 11-10から移行する場合で，HCSCサーバの起動時間に関する仕様変更を次の表に示します。

分類

仕様変更の項目

全体

(8) HCSCサーバの起動時間に関する仕様変更

付録J.5　サービスプラットフォーム 11-20からの仕様変更

サービスプラットフォーム 11-20からの仕様変更を次の表に示します。なお，仕様変更の表の「仕様変更の項目」の項番は，「付録J.9　旧バージョンからの仕様変更の一覧」の説明の項番と対応しています。

(1)　ファイルアダプタの入力最大ファイルサイズの上限値変更に関する仕様変更

サービスプラットフォーム 11-20から移行する場合で，ファイルアダプタの入力最大ファイルサイズの上限値変更に関する仕様変更を次の表に示します。

分類

仕様変更の項目

全体

(9) ファイルアダプタの入力最大ファイルサイズの上限値変更に関する仕様変更

(2)　TP1アダプタ通信構成定義ファイルのRPC接続設定に関する仕様変更

サービスプラットフォーム 11-20から移行する場合で，TP1アダプタ通信構成定義ファイルの設定が不正な場合のRPC接続設定に関する仕様変更を次の表に示します。

分類

仕様変更の項目

全体

(10) TP1アダプタ通信構成定義ファイルのRPC接続設定に関する仕様変更

付録J.6　サービスプラットフォーム 11-30からの仕様変更

サービスプラットフォーム 11-30からの仕様変更を次の表に示します。なお，仕様変更の表の「仕様変更の項目」の項番は，「付録J.9　旧バージョンからの仕様変更の一覧」の説明の項番と対応しています。

(1)　ビジネスプロセスのデバッグ機能に関する仕様変更

サービスプラットフォーム 11-30から移行する場合で，ビジネスプロセスのデバッグ機能に関する仕様変更を次の表に示します。

分類

仕様変更の項目

全体

(11) ビジネスプロセスのデバッグ機能に関する仕様変更

(2)　ヘッダ要求電文の/http-header-request/http-part/files/file要素に関する仕様変更

サービスプラットフォーム 11-30から移行する場合で，ヘッダ要求電文の/http-header-request/http-part/files/file要素に関する仕様変更を次の表に示します。

分類

仕様変更の項目

全体

(12) ヘッダ要求電文の/http-header-request/http-part/files/file要素に関する仕様変更

(3)　HTTPアダプタ実行環境プロパティファイルの<追番>に関する仕様変更

サービスプラットフォーム 11-30から移行する場合で，HTTPアダプタ実行環境プロパティファイルの<追番>に関する仕様変更を次の表に示します。

分類

仕様変更の項目

全体

(13) HTTPアダプタ実行環境プロパティファイルの<追番>に関する仕様変更

付録J.7　サービスプラットフォーム 11-40からの仕様変更

サービスプラットフォーム 11-40からの仕様変更を次の表に示します。なお，仕様変更の表の「仕様変更の項目」の項番は，「付録J.9　旧バージョンからの仕様変更の一覧」の説明の項番と対応しています。

(1)　SFTPアダプタとSFTPサーバ間の通信に関する仕様変更

サービスプラットフォーム 11-40から移行する場合で，SFTPアダプタとSFTPサーバ間の通信に関する仕様変更を次の表に示します。

分類

仕様変更の項目

全体

(14) SFTPアダプタとSFTPサーバ間の通信に関する仕様変更

付録J.8　サービスプラットフォーム 11-50からの仕様変更

サービスプラットフォーム 11-50からの仕様変更を次の表に示します。なお，仕様変更の表の「仕様変更の項目」の項番は，「付録J.9　旧バージョンからの仕様変更の一覧」の説明の項番と対応しています。

(1)　データ変換アクティビティに関する仕様変更

サービスプラットフォーム 11-50から移行する場合で，データ変換アクティビティに関する仕様変更を次の表に示します。

分類

仕様変更の項目

全体

(15) データ変換アクティビティに関する仕様変更

付録J.9　旧バージョンからの仕様変更の一覧

09-71からサービスプラットフォーム 11-60までの仕様変更を示します。

(1)　ログの出力先に関する仕様変更

変更内容

次に示すHCSCコンポーネントのログ出力先が変更されました。

表J‒1　ログ出力先の変更

分類

変更の概要

参照個所

TP1アダプタ

次に示すログの出力先を変更した。

例外ログ

メソッドトレース

データトレース

7.4.7，

7.7.6

Object Accessアダプタ

次に示すログの出力先を変更した。

例外ログ

メソッドトレース

データトレース

7.4.7，

7.7.8

Message Queueアダプタ

次に示すログの出力先を変更した。

例外ログ

メソッドトレース

データトレース

7.4.7，

7.7.10

FTPインバウンドアダプタ

次に示すログの出力先を変更した。

メッセージログ

保守用ログ

FTPプロトコルトレース

転送履歴ログ

リソースアダプタ間共通ログ

7.7.11

FTPアダプタ

次に示すログの出力先を変更した。

FTPプロトコルトレース

7.7.11

互換性を重視したシステムへ移行する場合に必要な作業

表「ログ出力先の変更」に示すログの出力先として，移行前に有効になっていたログ出力先を指定してください。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

項目「互換性を重視したシステムへ移行する場合に必要な作業」に示す作業を実施しないと，表「ログ出力先の変更」に示すログ出力先が変更されます。

(2)　ユーザ定義受付に関する仕様変更

変更内容

任意のビジネスプロセスを呼び出せるユーザ定義受付を追加しました。それにあわせて，09-87までのユーザ定義受付の呼称を変更しました。

これによって，ユーザ定義受付の呼称は次のようになります。

ユーザ定義受付（呼出先固定）　…09-87までのユーザ定義受付

ユーザ定義受付（呼出先選択）　…11-00で追加

製品およびマニュアルでは，この2つの総称として「ユーザ定義受付」を使用しています。

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

既存の業務アプリケーションの動作に影響はありません。

(3)　サービスアダプタ定義画面の基本画面に関する仕様変更

変更内容

サービスアダプタ定義画面の基本画面から，項目「フォーマットID」を削除しました。フォーマットIDは，サービスアダプタ定義画面の保存時に自動的に一意なIDが採番されるようになります。

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

なし。

(4)　メッセージテキストKEOS52272-Iに関する仕様変更

変更内容

メッセージKEOS52272-Iに，セットアップしたSOAPモード（SOAP1.1モード，またはSOAP1.1/1.2併用モード）を出力するようにしました。

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

なし。

(5)　TP1アダプタの障害対策に関する仕様変更

変更内容

TP1アダプタのトレースファイルへTP1/Client/Jのデータトレースを出力しないように変更しました。

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

TP1アダプタ実行環境プロパティファイルとTP1アダプタ通信構成定義ファイルに，次に示す定義がある場合に影響があります。

TP1アダプタ実行環境プロパティファイル

trace.level=20

TP1アダプタ通信構成定義ファイル

<connect_mode>の要素の値にRAPを指定

<active_mode>の要素を省略，または要素の値にSTANDを指定

移行する場合に必要な条件

マニュアル「サービスプラットフォーム 解説」の「付録A.3　TP1/Client/Jの障害対策」を参照し，TP1/Client/Jのトラブルシュート機能を使用して，TP1/Client/Jのデータトレースを取得してください。

(6)　非推奨とする機能に関する仕様変更

変更内容

使用頻度の低い機能を非推奨としました。非推奨にする機能と代替機能を次に示します。

(a)　電文履歴の管理機能

非推奨とする機能

代替機能

csmlshistoryコマンド

csmdeletehistoryコマンド

cscutilコマンドのhistoryオプション

SQLスクリプトファイル内の次に示すテーブル

CSCMSG_<individualname>_EXECHISTORY

CSCMSG_<individualname>_EXECHISTORY_I

ユーザ電文トレース機能

（凡例）

<individualname>：クラスタ名またはHCSCサーバ名

(b)　HCSCサーバの状態表示

非推奨とする機能

代替機能

csmlsstateコマンド

cscstatusコマンド

cscsvconfigコマンド

(c)　HCSCサーバのロケーション情報表示機能

非推奨とする機能

代替機能

csmlslocationコマンド

csmlsreceptionコマンド

cscstatusコマンド

cscreplsコマンド

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

なし。

(7)　カスタム受付のリクエスト処理に関する仕様変更

変更内容

HTTP受付とカスタム受付フレームワークで，ユーザ電文がnullまたは空文字の場合に，ビジネスプロセスで変数初期化エラーが発生しないように変更しました。

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

HTTP受付でボディ電文を指定しないでリクエスト処理を実行する場合

カスタム受付フレームワークのAPIを利用したユーザ定義受付を利用してリクエスト処理を実行する場合

(8)　HCSCサーバの起動時間に関する仕様変更

変更内容

J2EEサーバの起動時間を45秒から7秒に変更することで，HCSCサーバの起動時間を短縮しました。

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

なし。

(9)　ファイルアダプタの入力最大ファイルサイズの上限値変更に関する仕様変更

変更内容

ファイルアダプタが読み込むファイルの，ファイルサイズの最大値を64MBから500MBに変更しました。

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

なし。

(10)　TP1アダプタ通信構成定義ファイルのRPC接続設定に関する仕様変更

変更内容

TP1アダプタ通信構成定義ファイルの設定が不正な状態でTP1アダプタを起動した場合のエラーメッセージを追加しました。

旧バージョンで出力されていたKDEE12006-Eのエラー（TP1アダプタ通信構成定義ファイルの検証エラー）は，次の表に示す定義内容を満たした場合，対応するエラーメッセージに置き換わって出力されます。

メッセージID

エラーとなる定義内容

KDEE10015-E

<service_group>を省略

<connect_mode>の要素の値にSTAND，RAP，STATICのどれかを指定

KDEE10016-E

<operation>を省略

<connect_mode>の要素の値にSTAND，RAP，STATICのどれかを指定

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

TP1アダプタ通信構成定義ファイルに，次に示す定義がある場合に影響があります。

TP1アダプタ通信構成定義ファイル

<service_group>または<operation>を省略

<connect_mode>の要素の値にSTAND，RAP，STATICのどれかを指定

(11)　ビジネスプロセスのデバッグ機能に関する仕様変更

変更内容

ビジネスプロセスのデバッグ実行時に，次のメッセージをメッセージログに出力しないように変更しました。

初期化されていない変数の値を読み取ろうとした場合に出力されるメッセージ（KDEC20052-E）

初期化されていない相関セットの値を読み取ろうとした場合に出力されるメッセージ（KDEC20065-E）

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

なし。

(12)　ヘッダ要求電文の/http-header-request/http-part/files/file要素に関する仕様変更

変更内容

/http-header-request/http-part/files/file要素が複数回出現した場合の動作を次のように変更しました。

仕様変更前

最初に出現した要素の値を有効とする。

仕様変更後

すべてのfile要素が解析される。ただし，最初に出現した要素の値をファイルデータとして使用する。

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

なし。

(13)　HTTPアダプタ実行環境プロパティファイルの<追番>に関する仕様変更

変更内容

HTTPアダプタ実行環境プロパティファイルの次に示すプロパティに対し，<追番>に関する仕様を変更しました。

adphttp.request.part.file.<追番>.input-folder-name

adphttp.request.part.file.<追番>.local-file-name

仕様変更前

<追番>が1以外のプロパティが指定されている場合，<追番>が適切であっても無視する。

仕様変更後

<追番>が1以外のプロパティも解析される。

リクエスト時には，<追番>が1のプロパティがファイルデータとして使用される。

<追番>が1以外で定義が不正なプロパティがある場合，HTTPアダプタの起動時にエラーになる。

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

なし。

(14)　SFTPアダプタとSFTPサーバ間の通信に関する仕様変更

(a)　鍵交換方式

変更内容

次に示す鍵交換方式が使用できなくなりました。

diffie-hellman-group14-sha1

diffie-hellman-group-exchange-sha1

diffie-hellman-group1-sha1

これに伴い，SFTPアダプタ実行環境プロパティファイルのsftpadp.kex-exchange.algorithmプロパティのデフォルト値を変更しました。

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

なし。

(b)　共通鍵暗号方式

変更内容

次に示す共通鍵暗号方式が使用できなくなりました。

aes128-cbc

3des-cbc

blowfish-cbc

aes192-cbc

aes256-cbc

これに伴い，SFTPアダプタ実行環境プロパティファイルのsftpadp.common-key.cryptosystem.c2sプロパティおよびsftpadp.common-key.cryptosystem.s2cプロパティのデフォルト値を変更しました。

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

なし。

(c)　メッセージ認証コード方式

変更内容

次に示すメッセージ認証コード方式が使用できなくなりました。

hmac-md5

hmac-sha1-96

hmac-md5-96

これに伴い，SFTPアダプタ実行環境プロパティファイルのsftpadp.message-authentication-code.c2sプロパティおよびsftpadp.message-authentication-code.s2cプロパティのデフォルト値を変更しました。

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

なし。

(d)　ホスト認証方式

変更内容

次に示すホスト認証方式が使用できなくなりました。

ssh-rsa

ssh-dss

これに伴い，SFTPアダプタ実行環境プロパティファイルのsftpadp.host-key.algorithmプロパティのデフォルト値を変更しました。

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

なし。

(e)　公開鍵・秘密鍵の種類

変更内容

公開鍵・秘密鍵の種類「DSA」の鍵が使用できなくなりました。

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

なし。

(f)　厳密な鍵交換（strict key exchange）機能

変更内容

厳密な鍵交換（strict key exchange）機能の動作を次のように変更しました。

仕様変更前

厳密な鍵交換（strict key exchange）機能は使用できません。

仕様変更後

厳密な鍵交換（strict key exchange）機能をデフォルトで使用します。

互換性を重視したシステムへ移行する場合に必要な作業

SFTPアダプタ実行環境プロパティファイルのsftpadp.strict.key.exchange.enabledプロパティに「false」を設定してください。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

デフォルトの動作として，厳密な鍵交換（strict key exchange）機能が使用されます。

(g)　署名アルゴリズム

変更内容

公開鍵認証で許可する署名アルゴリズムの動作を次のように変更しました。

仕様変更前

公開鍵認証で許可する署名アルゴリズムは設定できません。

仕様変更後

公開鍵認証で許可する署名アルゴリズムをデフォルトで設定します。

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

デフォルトの動作として，公開鍵認証で許可する署名アルゴリズムが設定されます。

(15)　データ変換アクティビティに関する仕様変更

(a)　［データ変換アクティビティ］ダイアログ

変更内容

［データ変換アクティビティ］ダイアログの画面項目を次のように変更しました。

仕様変更前

画面項目「データ変換定義」に，データ変換定義のファイル名を入力するテキストボックスがあります。

仕様変更後

画面項目「データ変換定義」に，データ変換定義のファイル名を入力するテキストボックスがありません。

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

なし。

(b)　データ変換アクティビティのプロパティービュー

変更内容

データ変換アクティビティのプロパティービューの表示項目を次のように変更しました。

仕様変更前

データ変換アクティビティのプロパティービューに，項目「データ変換定義」があります。

仕様変更後

データ変換アクティビティのプロパティービューに，項目「データ変換定義」がありません。

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

なし。

(c)　設計情報の出力機能で出力されるデータ変換アクティビティの情報

変更内容

設計情報の出力機能で出力されるデータ変換アクティビティの情報を次のように変更しました。

仕様変更前

設計情報の出力機能で出力されるデータ変換アクティビティの情報に，データ変換定義の項目があります。

仕様変更後

設計情報の出力機能で出力されるデータ変換アクティビティの情報に，データ変換定義の項目がありません。

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

なし。

(d)　サービス定義XMLのデータ変換アクティビティ<datatrans-activity>の<transform-definition-file-name>

変更内容

サービス定義XMLのデータ変換アクティビティ<datatrans-activity>の<transform-definition-file-name>の仕様を次のように変更しました。

仕様変更前

<transform-definition-file-name>の仕様は次のとおりです。

データ変換定義のファイル名を指定します。デフォルト値は，activity-nameの指定値です。

指定可能値：XMLで使用可能な一文字以上の文字列

仕様変更後

<transform-definition-file-name>の仕様は次のとおりです。

旧バージョンで使用していた互換性維持用の要素です。

11-50以前では，データ変換定義のファイル名を指定します。

11-60以降では，指定なし，または空要素<transform-definition-file-name></transform-definition-file-name>を指定します。エクスポート時は，空要素<transform-definition-file-name></transform-definition-file-name>が出力されます。

指定可能値：空要素，またはXMLで使用可能な1文字以上の文字列

互換性を重視したシステムへ移行する場合に必要な作業

作業はありません。

推奨機能を使用したシステムへ移行する場合に必要な作業

作業はありません。

影響を受けるもの

なし。

付録K　用語解説

マニュアルで使用する用語について

マニュアル「アプリケーションサーバ & BPM/ESB基盤 用語解説」を参照してください。

索引

数字

1台のマシンに複数の運用・実行環境を構築する場合の環境構築[1]

A

adminagent.properties[1]

C

CSCMNG_HOME環境変数の設定[1]

cscsetupコマンド定義ファイル[1]

D

DB Connectorのインポート[1]

DB Connectorのセットアップ〔Reliable Messagingを使用しない場合〕[1]

DB Connectorのセットアップ〔Reliable Messagingを使用する場合〕[1]

E

Eclipseのインストール[1]

F

faultDetailの内容（オプション要素）[1]

faultDetailの内容（共通要素）[1]

FTPアダプタの定義情報を変更する[1]

FTPアダプタのユーザ情報を確認および変更する[1]

FTPインバウンドアダプタの情報を確認する[1]

FTPインバウンドアダプタの設定の解除[1]

FTPインバウンドアダプタの定義情報を変更する[1]

FTPインバウンドアダプタのユーザ情報を確認・変更する[1]

FTPインバウンドアダプタを起動する[1]

FTPインバウンドアダプタをセットアップする[1]

FTPインバウンドアダプタを停止する[1]

FTP受付，FTPアダプタおよびファイル操作アダプタの定義ファイルを配置する[1]

FTP受付実行時に発生したエラーの伝わり方[1]

FTP受付定義ファイルの定義情報を設定する[1]

FTP受付定義ファイルを取得する[1]

FTP受付のアプリケーション統合属性ファイルの定義情報を設定する[1]

FTP受付のアプリケーション統合属性ファイルを取得する[1]

FTP受付の定義情報を変更する[1]

FTP受付を開始する[1]

FTP受付を停止する[1]

FTPコマンドメッセージログ（FTPアダプタ）[1]

FTPプロトコルトレース（FTPアダプタ）[1]

FTPプロトコルトレース（FTPインバウンドアダプタ）[1]

FTP連携システムの運用の流れ[1]

FTP連携システムのセットアップの流れ[1]

FTP連携システムをアンセットアップする[1]

FTP連携する場合のシステムのセットアップ[1]

G

gRPCインバウンドアダプタの障害情報（gRPCインバウンドアダプタ）[1]

gRPCインバウンドアダプタのセットアップ[1]

gRPC受付実行時に発生したエラーの伝わり方[1]

gRPC通信ログ（gRPCアダプタ・gRPCインバウンドアダプタ共通）[1]、[2]

H

HAクラスタ構成〔HCSCサーバの構成〕[1]

HAクラスタ構成〔環境構築〕[1]

HAクラスタ構成時の環境構築[1]

HAクラスタ構成時の実行環境のセットアップ[1]

HAクラスタ構成での運用[1]

HAクラスタを構成する運用[1]

HAモニタ〔環境構築〕[1]、[2]

HCSCコンポーネントの更新[1]

HCSCコンポーネントの構成を変更する[1]

HCSCコンポーネントの削除[1]

HCSCコンポーネントの情報を確認する[1]

HCSCコンポーネントの追加[1]

HCSCコンポーネントの定義情報を変更する[1]

HCSCコンポーネントの定義ファイルを運用環境から削除する[1]

HCSCコンポーネントの定義ファイルを運用環境に取得する[1]

HCSCコンポーネントの定義ファイルを運用環境に設定，更新する[1]

HCSCコンポーネントを起動する[1]

HCSCコンポーネントを停止する[1]

HCSCコンポーネントを配備する[1]

HCSCサーバが使用するリソース[1]

HCSCサーバからエラーがリターンした場合（ビジネスプロセスを使用するとき）[1]

HCSCサーバ構成定義ファイル[1]

HCSCサーバ構成定義ファイルの作成[1]

HCSCサーバ構成定義ファイルを設定する[1]

HCSCサーバセットアップ定義ファイル[1]

HCSCサーバセットアップ定義ファイルの作成[1]

HCSCサーバセットアップ定義ファイルを設定する[1]

HCSCサーバでエラーを検知した場合[1]

HCSCサーバにアクセスするユーザの設定[1]

HCSCサーバによる運用〔単一〕[1]

HCSCサーバによる運用〔複数〕[1]

HCSCサーバのオペレーション運用[1]

HCSCサーバのオペレーション運用（FTP連携する場合）[1]

HCSCサーバのオペレーションをするための準備[1]

HCSCサーバの各リソースの稼働情報ファイル[1]

HCSCサーバの構成（HAクラスタ構成の場合）[1]

HCSCサーバの構成（N対1クラスタ構成の場合）[1]

HCSCサーバの構成（単一の場合）[1]

HCSCサーバの構成（複数の場合）[1]

HCSCサーバの構成（ロードバランスクラスタ構成の場合）[1]

HCSCサーバの情報を確認する[1]、[2]

HCSCサーバのセットアップ情報を確認する[1]

HCSCサーバの定義情報を設定する[1]

HCSCサーバの定義情報を変更する[1]

HCSCサーバの定義内容を確認する[1]

HCSCサーバの定義を変更する[1]

HCSCサーバのリソース稼働情報の統計情報[1]

HCSCサーバのリソース稼働情報を確認する[1]

HCSCサーバへのサービスアダプタおよびビジネスプロセスの追加・削除・変更[1]

HCSCサーバランタイム定義ファイル[1]

HCSCサーバランタイム定義ファイルの作成[1]

HCSCサーバランタイム定義ファイルを設定する[1]

HCSCサーバをアンセットアップする[1]

HCSCサーバを起動する[1]、[2]

HCSCサーバをセットアップする[1]

HCSCサーバを停止する[1]、[2]

HCSC本番環境簡易セットアップ機能で構築できる環境[1]

HCSC本番環境簡易セットアップ機能でセットアップした本番環境の運用[1]

HCSC本番環境簡易セットアップ機能の実行[1]

HCSC本番環境簡易セットアップ機能を利用したシステムのセットアップの流れ[1]

HCSC本番環境簡易セットアップで使用する定義ファイル[1]

HCSC-Manager Plug-inの組み込み[1]

HCSC-Managerコマンド共通項目を設定する[1]

HCSC-Managerコマンド共通定義ファイル[1]

HCSC-Managerコマンド共通定義ファイルの作成[1]

HCSC-Manager定義ファイル[1]

HCSC-Manager定義ファイルの格納ディレクトリ[1]

HCSC-Managerにアクセスするユーザの変更[1]

HCSC-Managerのログ[1]

HiRDB Type4 JDBC Driverのセットアップ[1]

HiRDBサーバの文字コードの設定[1]

HTTP Server定義ファイル[1]

HTTP Serverの状態を確認する[1]

HTTP Serverを起動する[1]

HTTP Serverを使用する方法[1]

HTTP Serverを停止する[1]

HTTP連携でのJSON-XML変換機能使用時の障害対策[1]

J

J2EEサーバの稼働ログ[1]

J2EEサーバの互換モード[1]

J2EEサーバのセットアップ[1]

J2EEサーバ用ユーザプロパティファイル（usrconf.properties）を設定する[1]

JAX-WSエンジンの初期設定[1]

JDBCドライバのセットアップ[1]

JP1/Baseのイベントサーバ名の設定[1]

JP1/Baseの構成定義の作成[1]

JP1イベント通知をするメッセージ[1]

JP1イベントの詳細情報〔サービスプラットフォームから通知する〕[1]

JP1イベント発行の設定[1]

JP1と連携した障害監視の流れ[1]

JP1連携機能を使用した障害の監視[1]

JP1連携機能を使用する場合の環境構築[1]

JP1連携の設定[1]

JSON-XML変換機能を利用する場合のオペレーション運用[1]

K

KafkaインバウンドアダプタおよびgRPCインバウンドアダプタの情報を確認する[1]

KafkaインバウンドアダプタおよびgRPCインバウンドアダプタをアンセットアップする[1]

KafkaインバウンドアダプタおよびgRPCインバウンドアダプタを起動する[1]

KafkaインバウンドアダプタおよびgRPCインバウンドアダプタを停止する[1]

Kafkaインバウンドアダプタの障害情報（Kafkaインバウンドアダプタ）[1]

Kafkaインバウンドアダプタのセットアップ[1]

Kafka受付実行時に発生したエラーの伝わり方[1]

Kafkaプロトコルトレース（Kafkaアダプタ・Kafkaインバウンドアダプタ共通）[1]

Kafkaプロトコルトレース（Kafkaインバウンドアダプタ）[1]

L

LANG[1]

LC_CTYPE（環境変数の設定）[1]

LD_LIBRARY_PATH（環境変数の設定）[1]

LIBPATH（環境変数の設定）[1]

M

Management Server環境設定ファイル[1]、[2]

Management Serverの起動[1]

Management Serverの参照方法[1]

Management Serverの設定[1]

Management Serverのセットアップ[1]

Management Server用オプション定義ファイル[1]

Manager[1]

Manager設定ファイル[1]

Managerにアクセスするユーザの設定[1]

Managerの状態を確認する[1]

MBeanの起動確認[1]

Message Queueアダプタが設定するエラー情報[1]

Message Queue受付実行時に発生したエラーの伝わり方[1]

mserver.cfg[1]

mserver.properties[1]

N

NIO HTTPサーバ[1]

N対1クラスタ構成[1]

N対1クラスタ構成〔HCSCサーバの構成〕[1]

N対1クラスタ構成時の環境構築[1]

N対1クラスタ構成時の実行環境のセットアップ[1]

N対1クラスタ構成での運用[1]

N対1クラスタへのHCSCサーバの追加・削除[1]

N対1クラスタを構成する運用[1]

O

Oracle JDBC Thin Driverのセットアップ[1]

OutOfMemoryError発生時の運用[1]

P

pd_max_users（同時実行可能ユーザ数）の設定[1]

PDLANG（環境変数の設定）[1]

PDTXACANUM（環境変数の設定）[1]

PDXAMODE（環境変数の設定）[1]

PRFの状態を確認する[1]

PRFのセットアップ[1]

PRFを起動する[1]

PRFを停止する[1]

R

RARファイルの選択方法（DBアダプタを利用する場合）[1]

RDエリアの準備[1]

Reliable Messagingのセットアップ[1]

RPC通信失敗時のfactor要素対応表[1]

S

Service Coordinator管理者の変更方法（UNIXの場合）[1]

Service Coordinator-Managerのセットアップ[1]

Service Platformのアンインストール[1]

Service Platformのインストール[1]

snapshotログ一次送付対象定義ファイル[1]

snapshotログ二次送付対象定義ファイル[1]

SOAP1.1/1.2併用モード[1]

SOAP1.1/1.2併用モードを利用する場合の初期設定[1]

SOAP1.1モード[1]

SOAP1.1モードを利用する場合の初期設定[1]

SOAP通信基盤の初期設定[1]

SOAPモード[1]、[2]

SOAPモードのサポート範囲[1]

SOAPモードの種類[1]

SOAPモードの設定[1]

SOAに基づいたシステム運用の概要[1]

SQLスクリプトファイル設定時の注意事項[1]

SQLスクリプトファイルの種類と格納先[1]

SQLスクリプトファイルの設定[1]

SQLスクリプトファイルの設定方法[1]

T

TP1/Client/Jの適切な応答監視時間の設定[1]

TP1/Client/Jのトレース情報の採取[1]

TP1/Client/Jの例外に対するfactor要素の対応表[1]

TP1/RPC受付実行時に発生したエラーの伝わり方[1]

TP1アダプタが設定するエラー情報[1]

TP1アダプタの障害情報[1]

TP1アダプタのログ・トレースの種類[1]

TP1インバウンドアダプタでエラーを検知した場合[1]、[2]

TP1インバウンドアダプタのセットアップ[1]

U

UOC実行時の注意事項[1]

usrconf.properties[1]、[2]

V

V9互換モード[1]

W

Webサーバ（HTTPサーバ）のセットアップ[1]

Windows Server Failover Cluster〔HAクラスタ構成の場合の環境構築〕[1]

Windows Server Failover Cluster〔N対1構成の場合の環境構築〕[1]

X

XMLパーサプール機能[1]

あ

アカウント情報管理コマンドのメッセージログ[1]

アカウント情報管理コマンドのメッセージログの取得方法[1]

アクティビティトレース[1]

アクティビティトレース〔障害対策〕[1]

アクティビティトレースの出力形式と出力される内容[1]

アクティビティトレースの出力先[1]

アクティビティトレースの出力例[1]

アクティビティトレースの利用方法の例[1]

値置換えファンクションで使用する変換テーブルを登録する[1]

アンインストール[1]

い

移行後の設定[1]

移行後の設定（07-50より前のバージョンから移行する場合）[1]

移行手順〔データベースを使用してReliable Messagingを使用しない環境から両方使用する環境に移行する場合の移行手順〕[1]

移行手順〔データベースとReliable Messagingの両方を使用しない環境からデータベースを使用してReliable Messagingを使用しない環境に移行する場合〕[1]

移行手順〔データベースとReliable Messagingの両方を使用しない環境から両方使用する環境に移行する場合〕[1]

移行手順〔データベースとReliable Messagingの両方を使用する環境からデータベースを使用してReliable Messagingを使用しない環境に移行する場合〕[1]

移行手順〔データベースとReliable Messagingの両方を使用する環境から両方使用しない環境に移行する場合〕[1]

移行手順〔データベースを使用してReliable Messagingを使用しない環境から両方使用しない環境に移行する場合の移行手順〕[1]

移行手順〔テスト環境と本番環境でデータベースとReliable Messagingの使用有無が同じ場合〕[1]

移行の対象となるバージョン[1]、[2]

一次資料[1]

イベント履歴ログ[1]

インストールの流れ[1]

インストール方法[1]

インデクスの各種概算式[1]

インプロセスHTTPサーバ[1]

インポート可否の検証[1]

インポート時の自動バックアップ[1]

う

運用環境でリポジトリを旧バージョンから移行する方法[1]

運用環境と実行環境の構成[1]

運用環境に関する設定[1]

運用環境の構築[1]

運用環境の定義ファイルの状態を確認する[1]

運用環境のバックアップ[1]

運用環境の復旧[1]

運用環境をカスタマイズする[1]

運用管理エージェントの起動[1]

運用管理エージェントの参照方法[1]

運用管理エージェントプロパティファイル[1]、[2]

運用コマンド実行時にFullGCを抑止する運用[1]

運用コマンド実行時の保守用ログ（FTPインバウンドアダプタ）[1]

運用集約構成[1]

運用の流れ[1]

運用方針の決定[1]

運用・実行1対1構成[1]

え

永続化〔プロセスインスタンスの実行履歴〕[1]

お

応答監視時間設定失敗時のfactor要素対応表[1]

オペレーション運用〔メール連携する場合〕[1]

オンライン中にHCSCコンポーネントを入れ替える場合[1]

オンラインを停止してHCSCコンポーネントを入れ替える場合[1]

か

開始〔メールアダプタ〕[1]

開発から実運用までの流れ[1]

回復方法〔HCSCコンポーネントの配備および削除時〕[1]

回復方法〔HCSCサーバ障害発生後〕[1]

回復方法〔HCSCサーバのシステム運用ができなくなった場合〕[1]

回復方法〔HCSCサーバのセットアップおよびアンセットアップ時〕[1]

回復方法〔クラスタ構成時〕[1]

回復方法〔デッドロックが発生した場合〕[1]

回復方法〔ファイルの入出力に失敗した場合〕[1]

カスタムファンクションで使用するjarファイルの格納先を変更する[1]

カスタムファンクションで使用するjarファイルを格納する[1]

稼働情報ファイルの出力[1]

画面とコマンドで実施できる内容（運用環境）[1]

簡易構築定義ファイル[1]

簡易セットアップ[1]

環境構築後のIPアドレスを変更する場合の運用[1]

環境構築後のホスト名を変更する場合の運用[1]

環境設定[1]

監視するログファイルの設定[1]

き

旧バージョンからの移行[1]、[2]

旧バージョンからの仕様変更[1]

共通定義ファイル（SOAP通信基盤）[1]

共通定義ファイルの設定項目（JAX-WSエンジン）[1]

共通定義ファイルの設定項目（SOAP通信基盤）[1]

共通フォルダおよび作業フォルダを設定する[1]

共通フォルダ内のファイルを削除する[1]、[2]

共通フォルダの情報を参照する[1]、[2]

業務への影響を抑止する機能[1]

共有ロック[1]、[2]

く

クライアント側共通定義ファイル[1]

クライアント共通設定プロパティファイル[1]

クライアント相関ID[1]

クラスタ構成時の運用[1]

クラスタ構成時の注意事項[1]

クラスタソフトウェアの設定〔HAクラスタ構成時〕[1]

クラスタソフトウェアの設定〔N対1クラスタ構成時〕[1]

け

検索する〔プロセスインスタンスの実行履歴〕[1]

こ

更新インストールして運用環境のリポジトリを移行する手順[1]

更新インストールする場合の移行手順[1]

構築する流れ〔1台のマシンに複数のHCSC-Manager環境を構築する場合〕[1]

コネクション解放処理失敗時のfactor要素対応表[1]

コネクション確立失敗時のfactor要素対応表[1]

コマンドで実施できる内容（運用環境）[1]

コンテナ拡張ライブラリの設定[1]

コンポーネントインポート[1]

コンポーネントインポート機能[1]

コンポーネント共通UOC機能[1]

コンポーネント単位でのリポジトリの更新[1]

コンポーネント単位でのリポジトリの削除[1]

コンポーネント単位でのリポジトリの追加[1]

さ

サーバ定義ファイル（SOAP通信基盤）[1]

サーバ定義ファイルの設定項目（SOAP通信基盤）[1]

サービスアダプタだけを削除する[1]

サービスアダプタだけを配備する[1]

サービスアダプタでの例外発生時の運用[1]

サービスアダプタの情報を確認する[1]

サービスアダプタを一括して削除する[1]

サービスアダプタを一括して配備する[1]

サービスアダプタを開始する[1]

サービスアダプタを削除する[1]、[2]

サービスアダプタを停止する[1]

サービスアダプタを配備する[1]

サービス情報[1]

サービス情報の削除[1]

サービス情報変更定義ファイル[1]

サービス情報を一括して変更する[1]

サービス情報を確認する[1]

サービス情報を個別に変更する[1]

サービス情報を変更する[1]

サービス部品からユーザ定義例外以外のエラーがリターンした場合（ビジネスプロセスを使用するとき）[1]

サービス部品からユーザ定義例外のエラーがリターンした場合（ビジネスプロセスを使用するとき）[1]

サービス部品に障害の要因がある場合[1]

サービス部品の接続先を変更する[1]

作業フォルダを削除する[1]、[2]

作業フォルダを参照する[1]、[2]

差分展開（リポジトリ情報）[1]

し

システム運用[1]

システム運用時の注意事項[1]

システム管理者または保守員に連絡するときに必要な情報[1]

システム構成の形態[1]

システム構成例〔1台のマシンに複数の環境を構築する場合〕[1]

システム全体と運用環境・実行環境の関係[1]

システムのアンセットアップ[1]

システムの起動（HCSCサーバの起動）[1]

システムの構築[1]

システムのセットアップの流れ[1]

実行環境（実行系）のセットアップ〔HAクラスタ構成時〕[1]

実行環境（実行系）のセットアップ〔N対1クラスタ構成時〕[1]

実行環境（待機系）のセットアップ〔HAクラスタ構成時〕[1]

実行環境（待機系）のセットアップ〔N対1クラスタ構成時〕[1]

実行環境に関する設定[1]

実行環境に必要なソフトウェアを設定する[1]

実行環境の構築[1]

実行環境の設定[1]

実行環境の設定に関するテーブルの情報[1]

実行環境の独自定義ファイル設定機能を使用した独自定義ファイルの定義手順[1]

実行履歴情報テーブルの管理[1]

実行履歴情報テーブルのバックアップ取得の運用[1]

実行履歴情報テーブルのバックアップを取得する[1]

実行履歴の管理[1]

指定したビジネスプロセスだけを削除する[1]

指定したビジネスプロセスだけを配備する[1]

シフトモード〔ローテーション方式〕[1]

出力された障害情報の確認方法[1]

使用有無〔データベースとReliable Messaging〕[1]

障害解析〔メッセージトラッキング〕[1]

障害情報の取得[1]

障害情報の取得（FTPアダプタ）[1]

障害情報の取得（FTPインバウンドアダプタ）[1]

障害情報の取得（FTP受付）[1]

障害情報の取得（gRPCインバウンドアダプタ）[1]

障害情報の取得（gRPC受付）[1]

障害情報の取得（Kafkaインバウンドアダプタ）[1]

障害情報の取得（Kafka受付）[1]

障害情報の取得（Message Queue）[1]

障害情報の取得（TP1/RPC受付）[1]

障害情報の取得（ファイル操作アダプタ）[1]

障害情報の取得方法（サービスプラットフォーム）[1]

障害情報の取得方法（サービスプラットフォーム以外の前提製品）[1]

障害対策[1]

障害対策の流れ[1]

障害対策〔FTP連携時〕[1]

障害対策〔gRPCアダプタ実行時〕[1]

障害対策〔gRPC受付実行時〕[1]

障害対策〔HTTPアダプタ実行時〕[1]

障害対策〔HTTP受付実行時〕[1]

障害対策〔HTTP連携でのJSON-XML変換機能使用時〕[1]

障害対策〔Kafkaアダプタ実行時〕[1]

障害対策〔Kafka受付実行時〕[1]

障害対策〔MDB（DBキュー）実行時〕[1]

障害対策〔MDB（WS-R）実行時〕[1]

障害対策〔Message Queueアダプタ実行時〕[1]

障害対策〔Message Queue受付実行時〕[1]

障害対策〔Object Accessアダプタ実行時〕[1]

障害対策〔SessionBean実行時〕[1]

障害対策〔SFTPアダプタ実行時〕[1]

障害対策〔TP1/RPC受付実行時〕[1]

障害対策〔TP1アダプタ実行時〕[1]

障害対策〔Webサービス（SOAP通信）実行時〕[1]

障害対策〔オペレーション実行時〕[1]

障害対策〔コマンドアダプタ実行時〕[1]

障害対策〔サービス部品呼び出し要求時〕[1]

障害対策〔システムのセットアップまたはアンセットアップ時〕[1]

障害対策〔スケジュール駆動受付実行時〕[1]

障害対策〔データ変換実行時〕[1]

障害対策〔ビジネスプロセス実行時〕[1]

障害対策〔ファイルアダプタ実行時〕[1]

障害対策〔ファイルイベント連携時〕[1]

障害対策〔メールアダプタ実行時〕[1]

障害対策〔ユーザ電文に誤りがある場合〕[1]

障害調査〔コマンド操作や運用環境の画面操作〕[1]

障害調査〔システム全体〕[1]

障害調査〔実行環境に必要なソフトウェアの設定〕[1]

障害調査〔セットアップまたはアンセットアップ時〕[1]

障害の監視・通知（JP1連携機能）[1]

障害発生時にHCSCサーバに通知する情報[1]

障害を調査するときに必要な情報[1]

新規にインストールして運用環境のリポジトリを移行する手順[1]

新規にインストールする場合の移行手順[1]

す

推奨モード[1]

スキーマの定義[1]

スケジュール駆動受付の障害情報[1]

スレッド数の見積もり[1]

せ

性能解析トレース[1]、[2]

性能解析トレース（FTPアダプタ）[1]

性能解析トレース（FTPインバウンドアダプタ）[1]

性能解析トレース（FTP受付）[1]

性能解析トレース（gRPCアダプタ）[1]

性能解析トレース（gRPCインバウンドアダプタ）[1]

性能解析トレース（gRPC受付）[1]

性能解析トレース（Kafkaインバウンドアダプタ）[1]

性能解析トレース（Kafka受付）[1]

性能解析トレース（Message Queue受付）[1]

性能解析トレース（PRFトレース）[1]

性能解析トレース（PRFトレース）（Kafkaアダプタ）[1]

性能解析トレース（TP1/RPC受付）[1]

性能解析トレース（ファイル操作アダプタ）[1]

性能解析トレースの絞り込み[1]

性能解析トレースの取得ポイント[1]、[2]

性能解析トレースの取得ポイントの表示[1]

性能解析トレースの表示[1]

性能解析トレースファイルの出力形式と出力される内容[1]

セットアップ[1]

セットアップ（FTP連携する場合）[1]

セットアップ後の内容を確認・変更する[1]

セットアップした情報の変更（単一セットアップ機能の場合）[1]

セットアップした情報の変更（追加構築可能環境セットアップ機能の場合）[1]

セットアップ情報の追加・変更[1]

セットアップの準備〔HAクラスタ構成時〕[1]

セットアップの準備〔N対1クラスタ構成時〕[1]

全体展開（リポジトリ情報）[1]

そ

そのほかの障害要因の特定方法（実行履歴の追跡）[1]

ち

注意事項〔システム運用時〕[1]

つ

通信形態による障害情報の通知[1]

通信タイムアウト値を変更する[1]

て

定義情報の確認および設定[1]

停止〔メールアダプタ〕[1]

ディレクトリ構成[1]

データトレース（gRPCアダプタ）[1]

データトレース（gRPCインバウンドアダプタ）[1]

データトレース（Kafkaアダプタ）[1]

データトレース（Kafkaインバウンドアダプタ）[1]

データベース（HiRDB）の排他要求数を見積もる[1]

データベース稼働マシンのIPアドレスを変更する場合[1]

データベース稼働マシンのホスト名を変更する場合[1]

データベースのクライアント側のセットアップ[1]

データベースのサーバ側のセットアップ[1]

データベースの状態を確認する[1]

データベースのセットアップ[1]

データベースのテーブルの情報[1]

データベースのテーブル容量を見積もる[1]

データベースの領域への配置を設計する[1]

データベースを起動する[1]

データベースを停止する[1]

テーブルおよびインデクス定義[1]

テーブル分割機能[1]

テーブル容量の見積もり〔実行環境の設定〕[1]

テーブル容量の見積もり〔プロセスインスタンスの実行履歴の管理〕[1]

テスト環境から本番環境への移行手順[1]

テスト環境と本番環境との関係[1]

デッドロックが発生した場合[1]

デバッグ情報[1]

デバッグ情報〔障害対策〕[1]

転送履歴ログ（FTPインバウンドアダプタ）[1]

転送履歴を取得する[1]

電文の実行履歴の管理に関するテーブルの情報[1]

と

統計情報の参照手順[1]

統合メッセージログ[1]

独自定義ファイル[1]

独自定義ファイルの運用[1]

独自定義ファイルの種類[1]

独自定義ファイルの設定方法[1]

トレース〔保守用〕[1]

に

二次資料[1]

は

バージョンアップ時のインポート[1]

排他ロック[1]、[2]

バックアップ[1]

バックアップ〔運用環境〕[1]

パフォーマンスチューニング〔メールアダプタ〕[1]

汎用フォルト電文を定義するスキーマファイル[1]

汎用フォルトを利用した障害解析[1]

ひ

ビジネスプロセスに障害の要因がある場合[1]

ビジネスプロセスの情報を確認する[1]

ビジネスプロセスの定義情報をキャッシュする[1]

ビジネスプロセスを一括して削除する[1]

ビジネスプロセスを一括して配備する[1]

ビジネスプロセスを開始する[1]

ビジネスプロセスを削除する[1]、[2]

ビジネスプロセスを停止する[1]

ビジネスプロセスを配備する[1]

ビジネスプロセスを利用したエラー情報の参照[1]

標準インポート[1]

標準受付（同期受付（Webサービス））および標準受付（非同期受付（MDB（WS-R））のWebサーバのIPアドレスまたはホスト名を変更する場合）[1]

標準受付の開始〔N対1クラスタ構成時〕[1]

標準受付を開始する[1]、[2]

標準受付を停止する[1]、[2]

ふ

ファイル操作アダプタの定義情報を変更する[1]

ファイルディスクリプタ数の見積もり[1]

フォルト電文を定義するスキーマファイル[1]

復旧〔運用環境〕[1]

プロセスインスタンスの実行履歴の管理[1]

プロセスインスタンスの実行履歴の管理に関するテーブルの情報[1]

プロセスインスタンスの実行履歴の詳細情報を取得する[1]

プロセスインスタンスの実行履歴を検索する[1]

プロセスインスタンスの実行履歴を削除する[1]

プロセスインスタンスの実行履歴を利用する[1]

プロセスインスタンスを再実行する[1]

プロパティ〔HCSCサーバセットアップ定義ファイル〕[1]

プロパティ〔HCSCサーバランタイム定義ファイル〕[1]

プロパティ〔ユーザ定義受付ランタイム定義ファイル〕[1]

へ

変換対象のHCSCコンポーネントの配備[1]

ほ

保守員に連絡するときに必要な情報[1]

保守情報の取得方法[1]

保守用ログ（FTPアダプタ）[1]

保守用ログ（FTPインバウンドアダプタ）[1]

保守用ログ（Kafkaインバウンドアダプタ）[1]

保守用ログ（ファイル操作アダプタ）[1]

本番環境のアンセットアップ（単一セットアップ機能で構築した環境の場合）[1]

本番環境のアンセットアップ（追加構築可能環境セットアップ機能で構築した環境の場合）[1]

本番環境の起動と停止[1]

本番環境のセットアップ（単一セットアップ機能の場合）[1]

本番環境のセットアップ（追加構築可能環境セットアップ機能の場合）[1]

め

メソッドトレース[1]

メソッドトレース（gRPCアダプタ）[1]

メソッドトレース（gRPCインバウンドアダプタ）[1]

メソッドトレース（Kafkaアダプタ）[1]

メソッドトレース〔障害対策〕[1]、[2]

メッセージ共通ID[1]

メッセージトラッキング[1]

メッセージトラッキング機能の適用例[1]

メッセージトラッキングの起動[1]

メッセージトラッキングプロンプト[1]

メッセージマッピングファイルの編集[1]

メッセージログ[1]、[2]、[3]

メッセージログ（FTPアダプタ）[1]

メッセージログ（FTPインバウンドアダプタ）[1]

メッセージログ（gRPCアダプタ）[1]

メッセージログ（gRPCインバウンドアダプタ）[1]

メッセージログ（gRPC受付）[1]

メッセージログ（Kafkaアダプタ）[1]

メッセージログ（Kafkaインバウンドアダプタ）[1]

メッセージログ（Kafka受付）[1]

メッセージログ（Message Queue受付）[1]

メッセージログ（TP1/RPC受付）[1]

メッセージログ（ファイル操作アダプタ）[1]

メンテナンスログ〔障害情報の取得〕[1]

メンテナンスログ〔障害情報の種類〕[1]

も

問題発生個所の切り分け方[1]

ゆ

ユーザ情報の管理[1]

ユーザ情報の設定[1]

ユーザ情報を設定する[1]

ユーザ定義受付だけを配備する[1]

ユーザ定義受付の情報を確認する[1]

ユーザ定義受付の定義情報を確認する[1]

ユーザ定義受付の定義情報を設定する[1]

ユーザ定義受付の定義情報を変更する[1]

ユーザ定義受付ランタイム定義ファイル[1]

ユーザ定義受付ランタイム定義ファイルの作成[1]

ユーザ定義受付ランタイム定義ファイルを設定する[1]

ユーザ定義受付を一括して配備する[1]

ユーザ定義受付を開始する[1]

ユーザ定義受付を削除する[1]、[2]

ユーザ定義受付を停止する[1]

ユーザ定義受付を配備する[1]

ユーザ電文トレース[1]、[2]

ユーザ電文トレース（Message Queue受付）[1]

ユーザ電文トレース（TP1/RPC受付）[1]

ユーザ電文トレースの出力契機[1]

ユーザ電文トレースの出力対象となるHCSCコンポーネントの指定[1]

ユーザ電文トレースの取得ポイント[1]

ユーザ電文トレースを出力するための設定[1]

ユーザ電文トレース〔障害対策〕[1]

ユーザ認証情報管理コマンドのメッセージログ[1]

ユーザ認証情報管理コマンドのメッセージログの取得方法[1]

よ

要素〔HCSCサーバ構成定義ファイル〕[1]

ら

ラップアラウンドモード〔ローテーション方式〕[1]

り

リクエストトレース[1]

リクエストトレース（Message Queue受付）[1]

リクエストトレース（TP1/RPC受付）[1]

リクエストトレースの取得ポイント[1]

リクエストトレース〔障害対策〕[1]

リソースアダプタ間共通ログ（FTPインバウンドアダプタ）[1]

リソースアダプタのプロパティを変更する[1]

リソースの稼働情報の種類[1]

リソースの見積もり[1]

リポジトリとして使用するディレクトリ[1]

リポジトリのインポート[1]

リポジトリのエクスポート[1]

リポジトリの概要[1]

リポジトリの管理[1]

リポジトリの更新〔コンポーネント単位〕[1]

リポジトリの削除〔コンポーネント単位〕[1]

リポジトリの差分情報の参照[1]

リポジトリの情報[1]

リポジトリの情報の参照[1]

リポジトリの追加〔コンポーネント単位〕[1]

リポジトリの排他[1]

リポジトリへのアクセスの制御[1]

リポジトリをインポートする[1]

リポジトリを更新する[1]、[2]

流量制御値を変更する[1]

る

ルートアプリケーション情報[1]

ルートアプリケーション情報の一覧表示[1]

れ

例外ログ（FTPアダプタ）[1]

例外ログ（gRPCアダプタ）[1]

例外ログ（gRPCインバウンドアダプタ））[1]

例外ログ（Kafkaアダプタ）[1]

例外ログ〔障害情報の取得〕[1]

例外ログ〔障害情報の種類〕[1]

例外をフォルト電文へ変換する場合の設定[1]

ろ

ローテーション方式〔ログファイル，トレースファイル〕[1]

ロードバランサの接続〔N対1クラスタ構成時〕[1]

ロードバランサの設定〔HAクラスタ構成時〕[1]

ロードバランサの設定〔N対1クラスタ構成時〕[1]

ロードバランスクラスタ機能[1]

ロードバランスクラスタ構成〔HCSCサーバの構成〕[1]

ロードバランスクラスタ構成〔環境構築〕[1]

ロードバランスクラスタ構成時の環境構築[1]

ロードバランスクラスタ構成時の実行環境のセットアップ[1]

ロードバランスクラスタ構成での運用[1]

ロードバランスクラスタ構成でのサービスアダプタの変更[1]

ロードバランスクラスタ構成でのビジネスプロセスの変更[1]

ロードバランスクラスタ構成とHAクラスタ構成の組み合わせによる実行系マシンと待機系マシンがN対1構成の場合の環境構築[1]

ロードバランスクラスタへのHCSCサーバの追加・削除[1]

ロードバランスクラスタへのサービスアダプタの追加・削除[1]

ロードバランスクラスタへのビジネスプロセスの追加・削除[1]

ロードバランスクラスタを構成する運用[1]

ローリングアップデート[1]、[2]

ローリングアップデートで運用環境のリポジトリを移行する手順[1]

ローリングアップデートの場合の移行手順[1]

ログアウトする[1]

ログイン時の注意事項[1]

ログインする[1]

ログおよびトレース取得時の注意事項（HCSC-Managerのログに関する注意事項）[1]

ログおよびトレース取得時の注意事項（全般的な注意事項）[1]

ログファイルとトレースファイルの出力方式と注意事項[1]

ログ〔保守用〕[1]

論理サーバの登録[1]