Cosminexus ビジネスプロセス管理/エンタープライズサービスバス V8

サービスプラットフォーム システム構築・運用ガイド

手引・操作書

3020-3-U53-80

目　　次

前書き

変更内容

はじめに

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

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

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

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

1.4　運用方針の決定

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

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

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

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

2.　システムの構築

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

2.1.1　インストールの流れ

2.1.2　uCosminexus Service Platformのインストール

2.1.3　uCosminexus OperatorおよびuCosminexus Operator for Service Platformのインストール

2.1.4　環境設定

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

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

2.1.7　アンインストール

2.2　構成の形態およびSOAPモードの選択

2.2.1　データベースとCosminexus RMの使用有無

2.2.2　使用するSOAPモード

2.3　実行環境に関する設定

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

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

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

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

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

2.3.6　データベース（HiRDB）の排他要求数を見積もる

2.3.7　データベースの領域への配置

2.3.8　変換テーブルを登録する

2.3.9　データ変換で使用するjarファイルを格納する

2.3.10　データベースとCosminexus RMの両方を使用しない場合の実行環境に関する設定

2.3.11　データベースを使用してCosminexus RMを使用しない場合の実行環境に関する設定

2.4　運用環境に関する設定

2.4.1　カスタマイズする

2.4.2　ユーザ権限を設定する

2.4.3　HCSC-Managerコマンド共通項目を設定する

2.5　HCSCサーバをロードバランスクラスタ構成にする場合の環境構築

2.5.1　ロードバランスクラスタ構成時の環境構築

2.5.2　ロードバランスクラスタ構成時の実行環境のセットアップ

2.6　HCSCサーバをHAクラスタ構成にする場合の環境構築

2.6.1　HAクラスタ構成時の環境構築

2.6.2　HAクラスタ構成時の実行環境のセットアップ

2.7　JP1連携機能を使用する場合の環境構築

2.7.1　JP1連携の設定の流れ

2.7.2　Cosminexus サービスプラットフォームのJP1イベント発行の設定

2.7.3　JP1/Baseのイベントサーバ名の設定

2.7.4　JP1/Baseの構成定義の作成

2.7.5　メッセージマッピングファイルの編集

2.8　1台のマシンに複数の運用・実行環境を構築する場合の環境構築

2.8.1　1台のマシンに複数の環境を構築する場合のシステム構成例

2.8.2　1台のマシンに複数の環境を構築する流れ

3.　システムのセットアップとアンセットアップ

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

3.1.1　システムのセットアップの流れ

3.1.2　実行環境に必要なソフトウェアの設定

3.1.3　HCSCサーバをセットアップする

3.1.4　HCSCサーバの定義情報を設定する

3.1.5　HCSCサーバの定義内容を確認する

3.1.6　サービス情報を変更する

3.1.7　サービス情報を確認する

3.1.8　サービスアダプタを配備する

3.1.9　カスタムアダプタの定義ファイルを運用環境に取得する

3.1.10　カスタムアダプタの定義ファイルを運用環境に設定，更新する

3.1.11　カスタムアダプタの定義ファイルを運用環境から削除する

3.1.12　運用環境の定義ファイルの状態を確認する

3.1.13　ビジネスプロセスを配備する

3.1.14　ユーザ定義受付を配備する

3.1.15　ユーザ定義受付の定義情報を設定する

3.1.16　ユーザ定義受付の定義情報を確認する

3.1.17　セットアップ後の内容を確認・変更する

3.1.18　データベースとCosminexus RMの両方を使用しない場合のシステムのセットアップ

3.1.19　データベースを使用してCosminexus RMを使用しない場合のシステムのセットアップ

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

3.2.1　サービスアダプタを削除する

3.2.2　ビジネスプロセスを削除する

3.2.3　ユーザ定義受付を削除する

3.2.4　HCSCサーバをアンセットアップする

3.3　テスト環境から本番環境への移行手順

3.3.1　テスト環境と本番環境でデータベースとCosminexus RMの使用有無が同じ場合の移行手順

3.3.2　データベースとCosminexus RMの両方を使用する環境から両方使用しない環境に移行する場合の移行手順

3.3.3　データベースとCosminexus RMの両方を使用しない環境から両方使用する環境に移行する場合の移行手順

3.3.4　データベースとCosminexus RMの両方を使用する環境からデータベースを使用してCosminexus RMを使用しない環境に移行する場合の移行手順

3.3.5　データベースとCosminexus RMの両方を使用しない環境からデータベースを使用してCosminexus RMを使用しない環境に移行する場合の移行手順

3.4　本番環境の簡易セットアップ

3.4.1　HCSC本番環境簡易セットアップ機能で構築できる環境

3.4.2　HCSC本番環境簡易セットアップ機能を利用したシステムのセットアップの流れ

3.4.3　HCSC本番環境簡易セットアップ機能の実行

3.4.4　HCSC本番環境簡易セットアップ機能でセットアップした本番環境の運用

3.4.5　HCSC本番環境簡易セットアップで使用する定義ファイル

4.　リポジトリの管理

4.1　リポジトリの概要

4.2　リポジトリのエクスポート

4.3　リポジトリのインポート

4.4　リポジトリの情報の参照

4.5　リポジトリの差分情報の参照

4.6　コンポーネント単位でのリポジトリの追加，更新，および削除

4.6.1　コンポーネントインポート機能の前提条件

4.6.2　コンポーネント単位のリポジトリの追加・更新

4.6.3　コンポーネント単位のリポジトリの削除

5.　システム運用

5.1　HCSCサーバのオペレーションをするための準備

5.1.1　ログインする

5.1.2　ログアウトする

5.2　HCSCサーバのオペレーション運用

5.2.1　運用の流れ

5.2.2　データベースを起動する

5.2.3　PRFを起動する

5.2.4　HCSCサーバを起動する

5.2.5　Hitachi Web Serverを起動する

5.2.6　サービスアダプタを開始する

5.2.7　ビジネスプロセスを開始する

5.2.8　ユーザ定義受付を開始する

5.2.9　標準受付を開始する

5.2.10　データベースの状態を確認する

5.2.11　PRFの状態を確認する

5.2.12　Hitachi Web Serverの状態を確認する

5.2.13　Cosminexus Managerの状態を確認する

5.2.14　HCSCサーバのセットアップ情報を確認する

5.2.15　HCSCサーバの情報を確認する

5.2.16　HCSCサーバのリソース稼働情報を確認する

5.2.17　サービスアダプタの情報を確認する

5.2.18　ビジネスプロセスの情報を確認する

5.2.19　ユーザ定義受付の情報を確認する

5.2.20　HCSCサーバの定義を変更する

5.2.21　ユーザ定義受付の定義情報を変更する

5.2.22　HCSCコンポーネントの構成を変更する

5.2.23　サービス部品の接続先を変更する

5.2.24　流量制御値を変更する

5.2.25　サービス部品呼び出しの通信タイムアウト値を変更する

5.2.26　標準受付を停止する

5.2.27　ユーザ定義受付を停止する

5.2.28　サービスアダプタを停止する

5.2.29　ビジネスプロセスを停止する

5.2.30　Hitachi Web Serverを停止する

5.2.31　HCSCサーバを停止する

5.2.32　PRFを停止する

5.2.33　データベースを停止する

5.3　クラスタ構成時の運用

5.3.1　ロードバランスクラスタ構成での運用

5.3.2　HAクラスタ構成での運用

5.4　環境構築後のIPアドレスまたはホスト名を変更する場合の運用

5.4.1　データベース稼働マシンのIPアドレスまたはホスト名を変更する場合

5.4.2　運用環境と実行環境が異なるマシンに構築された状態で，運用環境マシンのIPアドレスまたはホスト名を変更する場合

5.4.3　標準受付（同期受付（Webサービス））および標準受付（非同期受付（MDB（WS-R））のWebサーバのIPアドレスまたはホスト名を変更する場合

6.　実行履歴の管理

6.1　プロセスインスタンスの実行履歴の管理

6.1.1　プロセスインスタンスの実行履歴を利用する

6.1.2　プロセスインスタンスの実行履歴を検索する

6.1.3　プロセスインスタンスの実行履歴の詳細情報を取得する

6.1.4　プロセスインスタンスの実行履歴を削除する

6.1.5　プロセスインスタンスを再実行する

6.2　電文の実行履歴の管理

6.2.1　電文の実行履歴の概要

6.2.2　データベースに取得する電文の実行履歴を設定する

6.2.3　電文の実行履歴を利用する

6.2.4　電文の実行履歴を表示する

6.2.5　電文の実行履歴を削除する

6.3　実行履歴情報テーブルの管理

6.3.1　実行履歴情報テーブルのバックアップを取得する

6.3.2　実行履歴情報テーブルのバックアップ取得の運用

7.　障害対策

7.1　障害対策の流れ

7.2　障害調査のために必要な情報

7.2.1　障害を調査するときに必要な情報

7.2.2　システム管理者または保守員に連絡するときに必要な情報

7.3　障害情報の取得

7.3.1　Cosminexus サービスプラットフォームが出力するログやトレースの取得方法

7.3.2　Cosminexus サービスプラットフォーム以外の前提製品が出力する障害情報の取得方法

7.3.3　トレースファイルの見積もり

7.3.4　ログおよびトレース取得時の注意事項

7.4　障害情報の種類

7.4.1　メッセージログ

7.4.2　リクエストトレース

7.4.3　性能解析トレース

7.4.4　ユーザ電文トレース

7.4.5　保守用ログおよびトレース

7.5　システムのセットアップまたはアンセットアップ時の障害対策

7.5.1　実行環境に必要なソフトウェアの設定での障害調査

7.5.2　セットアップまたはアンセットアップ時の障害調査

7.5.3　HCSCサーバのセットアップおよびアンセットアップ時の回復方法

7.5.4　HCSCコンポーネントの配備および削除時の回復方法

7.6　オペレーション実行時の障害対策

7.6.1　コマンド操作や運用環境の画面操作での障害調査

7.6.2　ファイルの入出力に失敗した場合の回復方法

7.7　サービス部品呼び出し要求時の障害対策

7.7.1　Webサービス（SOAP通信）実行時の障害対策

7.7.2　SessionBean実行時の障害対策

7.7.3　MDB（WS-R）実行時の障害対策

7.7.4　MDB（DBキュー）実行時の障害対策

7.7.5　ユーザ電文に誤りがある場合の障害対策

7.7.6　システム全体の障害での障害調査

7.7.7　ビジネスプロセス実行時の障害対策

7.7.8　データ変換実行時の障害対策

7.8　障害発生時の自動運用

7.8.1　JP1連携機能を使用した障害の監視

7.8.2　Cosminexus サービスプラットフォームから通知するJP1イベントの詳細情報

7.9　HCSCサーバ障害発生後の回復方法

7.9.1　HCSCサーバのシステム運用ができなくなった場合の回復方法

7.9.2　クラスタ構成時の回復方法

7.9.3　運用環境のバックアップと復旧

7.9.4　デッドロックが発生した場合の回復方法

7.10　メッセージトラッキングを利用した障害解析

7.10.1　メッセージトラッキング機能の適用例

7.10.2　メッセージトラッキングの起動

7.10.3　性能解析トレースの表示

7.10.4　ルートアプリケーション情報の一覧表示

7.10.5　性能解析トレースの絞り込み

7.10.6　性能解析トレースの取得ポイントの表示

7.11　例外発生時に取得するエラーの選択

7.11.1　例外をそのままスローする場合とフォルト電文に変換する場合の処理の違い

7.11.2　例外をフォルト電文へ変換する場合の設定

7.11.3　フォルト電文を定義するスキーマファイル

7.12　OutOfMemoryError発生時の運用

7.12.1　業務への影響を抑止する機能

7.12.2　UOC実行時の注意事項

付録

付録A　Cosminexus Service Coordinator管理者の変更方法

付録A.1　変更方法

付録A.2　注意事項

付録B　画面とコマンドで実施できる内容

付録C　データベースのテーブルの情報

付録C.1　プロセスインスタンスの実行履歴の管理に関するテーブルの情報

付録C.2　電文の実行履歴の管理に関するテーブルの情報

付録C.3　実行環境の設定に関するテーブルの情報

付録D　SQLスクリプトファイルの設定

付録E　HCSCサーバのリソース稼働情報の統計情報

付録E.1　稼働情報ファイルの出力

付録E.2　統計情報の参照方法

付録E.3　HCSCサーバのリソースに対応する情報

付録E.4　リソースの稼働情報の種類

付録F　JP1イベント通知をするメッセージ

付録G　旧バージョンからの移行

付録G.1　移行の対象となるバージョン

付録G.2　新規にインストールする場合の移行手順

付録G.3　上書きインストールする場合の移行手順

付録G.4　ローリングアップデートの場合の移行手順

付録G.5　移行したあとの注意事項

付録H　運用環境でリポジトリを旧バージョンから移行する方法

付録H.1　移行の対象となるバージョン

付録H.2　新規にインストールして運用環境のリポジトリを移行する手順

付録H.3　上書きインストールして運用環境のリポジトリを移行する手順

付録H.4　ローリングアップデートで運用環境のレポジトリを移行する手順

付録H.5　移行したあとの注意事項

付録I　このマニュアルの参考情報

付録I.1　関連マニュアル

付録I.2　このマニュアルでの表記

付録I.3　英略語

付録I.4　KB（キロバイト）などの単位表記について

付録J　用語解説

索引

[他社商品名称に関する表示]

All Rights Reserved. Copyright (C) 2008, 2011, Hitachi, Ltd.

前書き

■ 対象製品

●適用OS：Windows Server 2003，Windows Server 2003 R2，Windows XP，Windows Vista，Windows 7 x86，Windows 7 x64※¹

P-2443-7T84　 uCosminexus Service Architect　 08-70

●適用OS：Windows Server 2003，Windows Server 2003 R2，Windows Server 2003（x64）※¹，Windows Server 2003 R2（x64）※¹，Windows Server 2008 x86，Windows Server 2008 x64※¹，Windows Server 2008 R2

P-2443-7S84　 uCosminexus Service Platform　 08-70

●適用OS：Windows Server 2003（x64），Windows Server 2003 R2（x64），Windows Server 2008 x64，Windows Server 2008 R2

P-2943-7S84　 uCosminexus Service Platform　 08-70※2

●適用OS：HP-UX 11i V2（IPF），HP-UX 11i V3（IPF）

P-1J43-7S81　 uCosminexus Service Platform　 08-70※2

●適用OS：AIX V7.1，AIX V6.1，AIX 5L V5.3

P-1M43-7S81　 uCosminexus Service Platform　 08-70※2

●適用OS：Red Hat Enterprise Linux AS 4（x86），Red Hat Enterprise Linux ES 4（x86），Red Hat Enterprise Linux AS 4（AMD64 & Intel EM64T），Red Hat Enterprise Linux ES 4（AMD64 & Intel EM64T），Red Hat Enterprise Linux 5 Advanced Platform（x86），Red Hat Enterprise Linux 5（x86），Red Hat Enterprise Linux 5 Advanced Platform（AMD/Intel 64），Red Hat Enterprise Linux 5（AMD/Intel 64），Red Hat Enterprise Linux Server 6（32-bit x86），Red Hat Enterprise Linux Server 6（64-bit x86_64）

P-9S43-7S81　 uCosminexus Service Platform　 08-70※2

●適用OS：Red Hat Enterprise Linux AS 4（IPF），Red Hat Enterprise Linux 5 Advanced Platform（Intel Itanium），Red Hat Enterprise Linux 5（Intel Itanium）

P-9V43-7S81　 uCosminexus Service Platform　 08-70※2

●適用OS：Windows Server 2003，Windows Server 2003 R2，Windows XP，Windows Vista，Windows 7 x86，Windows 7 x64※¹

P-2443-CL14　 uCosminexus Service Adapter Architect for FTP　 01-10

●適用OS：Windows Server 2003，Windows Server 2003（x64）※¹，Windows Server 2003 R2，Windows Server 2003 R2（x64）※¹，Windows Server 2008 x86，Windows Server 2008 x64※¹，Windows Server 2008 R2，HP-UX 11i V2（IPF），HP-UX 11i V3（IPF），AIX V7.1，AIX V6.1，AIX 5L V5.3，Red Hat Enterprise Linux AS 4（x86），Red Hat Enterprise Linux ES 4（x86），Red Hat Enterprise Linux AS 4（AMD64 & Intel EM64T），Red Hat Enterprise Linux ES 4（AMD64 & Intel EM64T），Red Hat Enterprise Linux 5 Advanced Platform（x86），Red Hat Enterprise Linux 5（x86），Red Hat Enterprise Linux 5 Advanced Platform（AMD/Intel 64），Red Hat Enterprise Linux 5（AMD/Intel 64），Red Hat Enterprise Linux Server 6（32-bit x86），Red Hat Enterprise Linux Server 6（64-bit x86_64）

P-2443-CK14　 uCosminexus Service Adapter for FTP　 01-10

注※1　WOW64（Windows On Windows 64）環境だけで使用できます。
注※2　製品のサポート時期をご確認ください。
これらのプログラムプロダクトのほかにもこのマニュアルをご利用になれる場合があります。詳細は「リリースノート」でご確認ください。
本製品では日立トレース共通ライブラリをインストールします。

■ 輸出時の注意

本製品を輸出される場合には，外国為替および外国貿易法ならびに米国の輸出管理関連法規などの規制をご確認の上，必要な手続きをお取りください。
なお，ご不明な場合は，弊社担当営業にお問い合わせください。

■ 商標類

AIXは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
AIX 5Lは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
AMDは，Advanced Micro Devices, Inc.の商標です。
Borlandのブランド名および製品名はすべて，米国Borland Software Corporationの米国およびその他の国における商標または登録商標です。
CORBAは，Object Management Groupが提唱する分散処理環境アーキテクチャの名称です。
HP-UXは，Hewlett-Packard Companyのオペレーティングシステムの名称です。
IIOPは，OMG仕様によるORB(Object Request Broker)間通信のネットワークプロトコルの名称です。
Itaniumは，アメリカ合衆国およびその他の国におけるIntel Corporationの商標です。
iWayおよびiWay Softwareは，Information Builders, Inc.の米国およびその他の国における登録商標です。
J2EEは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Javaは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
JDBCは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
JDKは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Linuxは，Linus Torvalds氏の日本およびその他の国における登録商標または商標です。
Microsoftは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Microsoft Office Excelは，米国 Microsoft Corporation の商品名称です。
MyEclipseは，米国Genuitec社の商品名称です。
ORACLEは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Oracle及びOracle 10gは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Oracle及びOracle9iは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Oracle及びOracle Database 11gは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Red Hatは，米国およびその他の国でRed Hat, Inc. の登録商標もしくは商標です。
SOAP（Simple Object Access Protocol）は，分散ネットワーク環境においてXMLベースの情報を交換するための通信プロトコルの名称です。
UNIXは，The Open Groupの米国ならびに他の国における登録商標です。
W3Cは，World Wide Web Consortiumの商標（多数の国において登録された）です。
WebSphereは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
Windowsは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Serverは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Vistaは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Eclipseは，開発ツールプロバイダのオープンコミュニティであるEclipse Foundation, Inc.により構築された開発ツール統合のためのオープンプラットフォームです。
This product includes software developed by the Apache Software Foundation (http://www.apache.org/).

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

Microsoft Corporationのガイドラインに従って画面写真を使用しています。

■ マイクロソフト製品の表記について

このマニュアルでは，マイクロソフト製品の名称を次のように表記しています。

表記 | 製品名
Excel | Microsoft(R) Office Excel
Microsoft Cluster Service | Microsoft(R) Cluster Service
Windows | Windows 7 | Windows 7 x86 | Microsoft(R) Windows(R) 7 Enterprise(32ビット版)
Microsoft(R) Windows(R) 7 Professional(32ビット版)
Microsoft(R) Windows(R) 7 Ultimate(32ビット版)
Windows 7 x64 | Microsoft(R) Windows(R) 7 Enterprise(64ビット版)
Microsoft(R) Windows(R) 7 Professional(64ビット版)
Microsoft(R) Windows(R) 7 Ultimate(64ビット版)
Windows Server 2003 | Windows Server 2003 Enterprise Edition | Microsoft(R) Windows Server(R) 2003, Enterprise Edition Operating System（x86）
Windows Server 2003 Standard Edition | Microsoft(R) Windows Server(R) 2003, Standard Edition Operating System（x86）
Windows Server 2003 R2 | Windows Server 2003 R2 Enterprise Edition | Microsoft(R) Windows Server(R) 2003 R2, Enterprise Edition Operating System（x86）
Windows Server 2003 R2 Standard Edition | Microsoft(R) Windows Server(R) 2003 R2, Standard Edition Operating System（x86）
Windows Server 2003（x64） | Windows Server 2003 Enterprise x64 Edition | Microsoft(R) Windows Server(R) 2003, Enterprise x64 Edition Operating System
Windows Server 2003 Standard x64 Edition | Microsoft(R) Windows Server(R) 2003, Standard x64 Edition Operating System
Windows Server 2003 R2（x64） | Windows Server 2003 R2 Enterprise x64 Edition | Microsoft(R) Windows Server(R) 2003 R2, Enterprise x64 Edition Operating System
Windows Server 2003 R2 Standard x64 Edition | Microsoft(R) Windows Server(R) 2003 R2, Standard x64 Edition Operating System
Windows Server 2008 x86 | Microsoft(R) Windows Server(R) 2008 Enterprise 32-bit
Microsoft(R) Windows Server(R) 2008 Standard 32-bit
Windows Server 2008 x64 | Microsoft(R) Windows Server(R) 2008 Enterprise x64 Edition
Microsoft(R) Windows Server(R) 2008 Standard x64 Edition
Windows Server 2008 R2 | Microsoft(R) Windows Server(R) 2008 R2 Enterprise
Microsoft(R) Windows Server(R) 2008 R2 Standard
Windows Vista | Windows Vista Business | Microsoft(R) Windows Vista(R) Business
Windows Vista Enterprise | Microsoft(R) Windows Vista(R) Enterprise
Windows Vista Ultimate | Microsoft(R) Windows Vista(R) Ultimate
Windows XP | Microsoft(R) Windows(R) XP Professional Operating System

■ 発行

2011年 8月 3020-3-U53-80

■ 著作権

All Rights Reserved. Copyright (C) 2008, 2011, Hitachi, Ltd.

変更内容

変更内容（3020-3-U53-80）uCosminexus Service Architect 08-70，uCosminexus Service Platform 08-70，uCosminexus Service Adapter Architect for FTP 01-10，uCosminexus Service Adapter for FTP 01-10

追加・変更内容
変更個所

Cosminexus サービスプラットフォームを構成するソフトウェア製品ごとの前提OSに，次のOSを追加した。

AIX V7.1

Red Hat Enterprise Linux Server 6（32-bit x86）

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

－

データベースを利用する環境の場合に，運用環境と実行環境を1対1で構成できるようにした。
1.2(3)，2.3.2(2)，2.3.5(3)，2.3.5(3)(b)，2.3.10(2)，2.3.11(2)，7.5.3，7.5.4，付録C.3(1)，付録C.3(1)(f)，付録C.3(1)(g)，付録D(2)(a)

Cosminexus Service Coordinatorのインストール後のディレクトリ構成に，ディレクトリを追加した。
2.1.2(3)

Eclipse Classic 3.6.1に対応したことに伴い，記述を変更した。
2.1.3(2)，2.1.5

Cosminexus サービスプラットフォームの前提となるデータベースから，次のデータベースを削除した。

HiRDB Version 7

Oracle9i

Oracle 10g R1

2.1.6(2)(b)，3.1.2(1)(b)，3.1.2(7)，3.1.2(7)(c)，3.1.2(8)(a)，3.1.19(2)(a)，付録D(1)

Oracle 11gのJDBCドライバのファイル名はJDKのバージョンごとに異なるため，記述を変更した。
2.1.6(2)(b)，3.1.2(7)(c)

アンインストール時に削除されないディレクトリを追加した。
2.1.7(1)(a)

HCSCサーバランタイム定義ファイルに定義するプロパティを追加した。
2.3.3(2)，2.3.10(3)，2.3.11(3)

バイナリ型変数およびany型変数の追加に伴い，電文種別の記述を修正した。
2.3.5(1)，付録C.2(1)(a)

実行環境にHCSC-Managerを配置できるようになったことに伴い，記述を修正した。
2.5.1，2.5.1(2)，2.6.1，2.6.1(2)

リポジトリをコンポーネント単位でインポートする機能を追加した。
4.3，4.4，4.5，4.6

IPアドレスおよびホスト名を変更した場合についての注意事項を追加した。
5.4，5.4.1，5.4.2，5.4.3

JP1での監視を推奨するプロセスについて記述を追加した。
7.8.1(3)

OutOfMemoryError発生時の注意事項を追加した。
7.12

運用環境のリポジトリをアップデートする機能を追加した。
付録B，付録H

検証アクティビティ（validate属性）の追加に伴い，記述を追加した。
付録C.1(2)(d)

次のメッセージについて，JP1イベントの通知の有無を追加した。
KDEC00047，KDEC00048，KDEC00411～KDEC00413，KDEC03026～KDEC03028，KDEC05015，KDEC05016，KDEC07501，KDEC07587～KDEC07596，KDEC10092～KDEC10098，KDEC20083，KDEK30425～KDEK30428，KDEK30430，KDEK30432～KDEK30435，KDEK30601～KDEK30609
付録F(1)，付録F(2)，付録F(6)

次のメッセージについて，JP1イベントの通知の有無を削除した。
KDEC00389
付録F(1)

旧バージョンからの移行方法をバージョン08-70の情報に変更した。また，上書きインストール時に上書きされないファイルを追加した。
付録G，付録G.3(2)

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

はじめに

このマニュアルは，Cosminexusが提供する機能を利用して，SOAに対応したサービス統合環境（サービスプラットフォーム）を運用する方法について説明しています。

Cosminexus サービスプラットフォームでは，次に示すプログラムプロダクトを使用してシステムを運用します。

uCosminexus Service Architect

uCosminexus Service Platform

uCosminexus Service Adapter Architect for FTP

uCosminexus Service Adapter for FTP

また，オペレーティングシステム（OS）の種類によって，機能が異なる場合があります。OSごとの違いがある場合の表記方法については，「適用OSの違いによる機能相違点の表記」を参照してください。

対象読者

Cosminexus サービスプラットフォームを利用してSOAに対応したシステムを運用するシステム管理者を対象としています。

対象読者の前提知識として必要な知識を次に示します。

SOAに関する基本的な知識

J2EEに関する基本的な知識

リレーショナルデータベースおよびデータベース操作言語（SQL）に関する基本的な知識

XMLに関する基本的な知識

なお，JP1との連携機能を使用する場合は，次の内容を理解していることが必要です。

JP1の統合管理，ジョブ管理，ネットワーク管理，およびアベイラビリティ管理に関する基本的な知識

また，このマニュアルの前提である，マニュアル「Cosminexus サービスプラットフォーム 概説」を必ずお読みください。

適用OSの違いによる機能相違点の表記

このマニュアルは，適用OSがWindows，AIX，HP-UXおよびLinux(R)の製品に対応するため，OSの種類によって，機能が異なる場合があります。OSごとの違いがある場合は，次に示す表記を使用して，それぞれの説明にOS名を明記しています。

表記 | 意味
Windowsの場合 | Windowsに該当する表記です。
AIXの場合 | AIXに該当する表記です。
HP-UXの場合 | HP-UXに該当する表記です。
Linuxの場合 | Linuxに該当する表記です。
UNIXの場合 | UNIX（AIX，HP-UXおよびLinux）に該当する表記です。

パスの表記について

このマニュアルでは，原則としてWindowsのパスの区切り（「¥」）を使用しています。UNIXの場合は，「¥」を「/」に置き換えてお読みください。

このマニュアルで使用している記号

注意

間違いやすい点，および間違うとトラブルが発生するような項目について説明しています。

ポイント

その説明の要点について説明しています。

参考

補足的な情報を説明しています。

文法の説明で使用している記号

このマニュアルの文法の説明で使用している記号を次に示します。

記　号
意　味

　｜
横に並べられた複数の項目に対する項目間の区切りを示し，「または」を意味します。
（例）　A｜B　AまたはBを指定することを示します。

{ 　 }
この記号で囲まれている複数の項目のうちから一つを選択することを示します。項目が横に並べられ，記号｜で区切られている場合は，そのうちの一つを選択します。
（例）　｛A｜B｜C｝　A，BまたはCのどれかを指定することを示します。

［　］
この記号で囲まれている項目は省略してもよいことを示します。
（例）　［A］　「何も指定しない」か「Aを指定する」ことを示します。

<　>
この記号で囲まれている項目は，該当する要素を指定することを示します。
（例）　<プロパティ>　プロパティを記述します。

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

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

＜この章の構成＞

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

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

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

1.4　運用方針の決定

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

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

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

注※

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

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

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

＜この節の構成＞

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

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

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

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

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

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

(7)　uCosminexus Service PlatformまたはuCosminexus OperatorとuCosminexus Operator for Service Platformのインストール

(8)　運用環境の構築

(9)　実行環境の構築

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

HCSCコンポーネントの配備は，運用環境のコマンドを利用します。なお，DBアダプタの配備方法は，サービスアダプタの配備方法と同じです。

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

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

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

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

HCSCコンポーネントを開始・停止するには，運用環境の画面またはコマンドを利用します。なお，DBアダプタの開始方法は，サービスアダプタの開始方法と同じです。

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

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

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

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

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

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

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

(7)　uCosminexus Service PlatformまたはuCosminexus OperatorとuCosminexus Operator for Service Platformのインストール

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

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

uCosminexus OperatorとuCosminexus Operator Service Platformのインストール方法については，「2.1.3　uCosminexus OperatorおよびuCosminexus Operator for 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サーバの定義情報を設定する」を参照してください。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

HCSCコンポーネントの配備は，運用環境のコマンドを利用します。なお，DBアダプタの配備方法は，サービスアダプタの配備方法と同じです。

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

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

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

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

HCSCコンポーネントを開始・停止するには，運用環境の画面またはコマンドを利用します。なお，DBアダプタの開始・停止方法は，サービスアダプタの開始・停止方法と同じです。

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

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

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

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

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

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

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

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

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

(a)　システムの監視

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

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

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

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

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

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

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

(b)　障害の対策

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

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

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

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

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

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

＜この節の構成＞

(1)　運用上の位置づけ

(2)　ネットワーク上の位置づけ

(3)　運用環境と実行環境の構成

(1)　運用上の位置づけ

システム全体の運用の中で，運用環境および実行環境がどのように位置づけられるのかについて，次の図に示します。

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

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

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

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

(2)　ネットワーク上の位置づけ

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

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

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

運用環境と実行環境は分けて構築することを推奨します。運用環境と実行環境を分けて構築する場合は，図1-3のように，運用環境を構築するマシンとして別途Windowsのマシンを用意し，uCosminexus OperatorをインストールしたあとにuCosminexus Operator for Service Platformをインストールする必要があります。運用環境と実行環境を同じマシンに構築する場合は，uCosminexus OperatorとuCosminexus Operator for Service Platformのインストールは不要です。

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

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

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

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

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

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

クラスタ構成にする場合

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

(3)　運用環境と実行環境の構成

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

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

構成パターン | 説明 | データベース
運用PC設置構成 | 実行環境とは異なる環境に，運用環境を配置します。 | ○
運用・実行1対1構成 | 運用環境と実行環境を1対1にして配置します。 | △※
運用集約構成 | 実行時に利用するサーバに，運用環境を集約します。 | ○

（凡例）

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

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

注※

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

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

運用PC設置構成の構成例を次の図に示します。

図1-4　運用PC設置構成の構成例

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

図1-5　運用・実行1対1構成の構成例

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

図1-6　運用集約構成の構成例

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

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

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

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

ケース1

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

ケース2

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

ケース3

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

注※

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

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

表1-2　データベースとCosminexus RMの使用有無の設定に対応したケース

テスト環境の設定 | 本番環境の設定
データベースとCosminexus RMの両方を使用する | データベースを使用してCosminexus RMを使用しない | データベースとCosminexus RMの両方を使用しない
データベースとCosminexus RMの両方を使用する | ケース1※ | ケース3 | ケース3
データベースを使用してCosminexus RMを使用しない | ケース2 | ケース1※ | ケース3
データベースとCosminexus RMの両方を使用しない | ケース2 | ケース2※ | ケース1※

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

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

＜この節の構成＞

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

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

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

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

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

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

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

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

注※

この構成のテスト環境は，HCSC簡易セットアップ機能では構築できません。

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

図1-7　データベースとCosminexus RMの使用有無を同じ設定で構築した場合の移行の流れ

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

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

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

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

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

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

注※

この構成のテスト環境は，HCSC簡易セットアップ機能では構築できません。

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

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

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

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

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

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

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

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

注※

この構成のテスト環境は，HCSC簡易セットアップ機能では構築できません。

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

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

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

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

1.4　運用方針の決定

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

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

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

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

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

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

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

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

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

注意

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

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

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

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

注※

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

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

＜この節の構成＞

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

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

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

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

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

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

図1-10　HCSCサーバの構成（単一の場合）

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

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

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

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

図1-11　HCSCサーバの構成（複数の場合）

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

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

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

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

図1-12　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クラスタを構成する運用

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

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

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

HAクラスタを構成するには，クラスタソフトウェアが必要です。Cosminexus サービスプラットフォームでは，クラスタソフトウェアとして，Windowsの場合はMicrosoft Cluster Serviceを，UNIXの場合はHAモニタを利用します。

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

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

待機系HCSCサーバの起動

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

注意

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

2.　システムの構築

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

＜この章の構成＞

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

2.2　構成の形態およびSOAPモードの選択

2.3　実行環境に関する設定

2.4　運用環境に関する設定

2.5　HCSCサーバをロードバランスクラスタ構成にする場合の環境構築

2.6　HCSCサーバをHAクラスタ構成にする場合の環境構築

2.7　JP1連携機能を使用する場合の環境構築

2.8　1台のマシンに複数の運用・実行環境を構築する場合の環境構築

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

＜この節の構成＞

2.1.1　インストールの流れ

2.1.2　uCosminexus Service Platformのインストール

2.1.3　uCosminexus OperatorおよびuCosminexus Operator for Service Platformのインストール

2.1.4　環境設定

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

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

2.1.7　アンインストール

2.1.1　インストールの流れ

インストールの流れを次の図に示します。実行環境と運用環境を同じマシンに構築する場合と，異なるマシンに構築する場合で，インストールおよび設定の作業の流れが異なります。

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

＜この項の構成＞

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

(2)　uCosminexus OperatorおよびuCosminexus Operator for Service Platformのインストール

(3)　環境設定

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

(5)　Management Serverの設定

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

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

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

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

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

(2)　uCosminexus OperatorおよびuCosminexus Operator for Service Platformのインストール

uCosminexus OperatorおよびuCosminexus Operator for Service Platformのインストール方法については，「2.1.3　uCosminexus OperatorおよびuCosminexus Operator for Service Platformのインストール」を参照してください。

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

(3)　環境設定

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

uCosminexus OperatorおよびuCosminexus Operator for Service Platformをインストールしたマシンでは，環境設定として環境変数を設定します。

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

(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　uCosminexus Service Platformのインストール

uCosminexus Service Platformは，日立総合インストーラからインストールします。日立総合インストーラの指示に従ってインストールしてください。

次に，Windowsの場合とUNIXの場合のインストール方法についてそれぞれ説明します。

注意

次のドキュメントを参照し，各構成ソフトウェアのインストール上の注意事項を確認してからインストールしてください。

リリースノート

マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「7.2.1　インストール方法」

＜この項の構成＞

(1)　Windowsの場合のインストール方法

(2)　UNIXの場合のインストール方法

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

(4)　インストール後の作業

(1)　Windowsの場合のインストール方法

新規インストール，上書きインストール，アップグレードインストールの場合のインストール方法についてそれぞれ説明します。なお，インストール作業はAdministrator権限が設定されたユーザが実施してください。

(a)　新規インストールの場合

uCosminexus Service Platformをインストールします。インストール種別を選択する画面では「標準」を選択してください。

(b)　上書きインストールの場合

uCosminexus Service Platformをインストールします。インストール種別を選択する画面では「変更」を選択して，そのあと，プログラムを選択する画面で上書きインストールをする構成ソフトウェアを選択してください。

(c)　アップグレードインストールの場合

uCosminexus Service Platformをインストールします。インストール種別を選択する画面では「変更」を選択して，そのあと，プログラムを選択する画面でアップグレードインストールをする構成ソフトウェアを選択してください。

注意

バージョン07-00から，それ以降のバージョンへのアップグレードインストールには対応していません。

(2)　UNIXの場合のインストール方法

UNIXの場合のインストール方法について説明します。なお，インストール作業はroot権限が設定されたユーザが実施してください。

uCosminexus Service Platformに含まれるすべての構成ソフトウェアをインストールします。uCosminexus Service Platformに含まれる構成ソフトウェアを次に示します。

Cosminexus Component Container

Cosminexus Component Transaction Monitor

Cosminexus DABroker Library

Cosminexus Developer's Kit for JavaTM

Cosminexus Performance Tracer

Cosminexus Reliable Messaging

Cosminexus Service Coordinator

Cosminexus TPBroker

Cosminexus Web Services - Security

Cosminexus XML Processor

Hitachi Web Server

uCosminexus Service Platform - Base

なお，上記の構成ソフトウェアがすでにインストールされている場合は，インストール済みの構成ソフトウェアのバージョンが古いものだけをインストールしてください。

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

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

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

(4)　インストール後の作業

Windowsの場合，uCosminexus Service Platformのインストールが終了したら，マシンを再起動します。

2.1.3　uCosminexus OperatorおよびuCosminexus Operator for Service Platformのインストール

uCosminexus Operatorは，日立総合インストーラからインストールします。日立総合インストーラの指示に従ってインストールしてください。uCosminexus Operator for Service Platformは，uCosminexus Operatorをインストールしたあとに，提供されているCD-ROMからインストールします。

なお，インストール作業はAdministrator権限が設定されたユーザが実施してください。

次に，新規インストールの場合と上書きインストールの場合の方法についてそれぞれ説明します。

＜この項の構成＞

(1)　新規インストールの場合

(2)　上書きインストールの場合

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

(1)　新規インストールの場合

新規インストールの手順を次に示します。

uCosminexus Operatorをインストールします。
日立総合インストーラからインストールします。インストール種別を選択する画面では「標準」を選択してください。
インストールが終了したら，マシンを再起動します。

uCosminexus Operator for Service Platformをインストールします。
提供されているCD-ROMからCSCディレクトリとpluginsディレクトリをCosminexusインストールディレクトリ直下にコピーします。

注意

uCosminexus Operatorがインストール済みのため，uCosminexus Operator for Service Platformをインストールするときにはpluginsディレクトリが存在します。pluginsディレクトリは上書きコピーをしてください。

コピー後のディレクトリ構成は，次のようになります。

<Cosminexusインストールディレクトリ>
 ├common
 ├CSC
 ├jaxp
 ├jdk
 └plugins

(2)　上書きインストールの場合

上書きインストールの手順を次に示します。なお，HCSCサーバがセットアップされた状態で上書きインストールする場合は，リポジトリのエクスポートおよびインポートをする必要があります。詳細については，「付録G.3　上書きインストールする場合の移行手順」を参照してください。

次の手順でインストールします。

uCosminexus Operatorをインストールします。
日立総合インストーラからインストールします。インストール種別を選択する画面では「変更」を選択して，そのあと，プログラムを選択する画面ですべての構成ソフトウェアを選択してください。
インストールが終了したら，マシンを再起動します。

必要に応じて定義ファイルのバックアップを取得します。
次のファイルをカスタマイズしている場合は，uCosminexus Operator for Service Platformをインストールする前に，バックアップを取得します。

<Cosminexusインストールディレクトリ>¥CSC¥config¥manager¥cscmng.properties

<Cosminexusインストールディレクトリ>¥CSC¥config¥manager¥csccmd.properties

uCosminexus Operator for Service Platformをインストールします。
Cosminexusインストールディレクトリ直下に，提供されているCD-ROMからCSCディレクトリとpluginsディレクトリを上書きコピーします。

バックアップファイルをリストアします。
操作2.でバックアップしたファイルを次のファイルに上書きコピーをします。

<Cosminexusインストールディレクトリ>¥CSC¥config¥manager¥cscmng.properties

<Cosminexusインストールディレクトリ>¥CSC¥config¥manager¥csccmd.properties

uCosminexus OperatorおよびuCosminexus Operator for Service Platformをインストールしたあとに，運用環境で画面（GUI）を利用するには，次のソフトウェアのインストールおよびセットアップが必要です。

Eclipse Classic 3.6.1

なお，Eclipseのインストールについては，Eclipseのドキュメントを参照してください。

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

uCosminexus OperatorおよびuCosminexus Operator for Service Platformのインストール後のディレクトリ構成は，uCosminexus Service Platformを構成するソフトウェアのうち，Cosminexus Service Coordinatorのインストール後のディレクトリ構成と同じです。詳細については，「2.1.2(3) インストール後のディレクトリ構成」を参照してください。

2.1.4　環境設定

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

リポジトリの設定

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

環境変数の設定（uCosminexus Operator for Service Platformをインストールしたマシンの場合）

uCosminexus Operator for Service Platformをインストールしたマシンでは，次の環境変数を設定します。

表2-1　uCosminexus Operator for Service Platformを利用する場合に設定する環境変数

環境変数名
設定値

PATH
<Cosminexusのインストールディレクトリ>¥jdk¥bin

TZ
「JST-9」など

HCSC_HNTRLIB
HNTRLib2のインストールパス※

（例）

C:¥Program Files¥HITACHI¥HNTRLib2

注※　デフォルトインストール先は次のとおりです。

%ProgramFiles%¥HITACHI¥HNTRLib2

デフォルトインストール先にインストールされていない場合は，次に示すレジストリエントリに格納されているインストールパスの値を確認してください。

キー

HKEY_LOCAL_MACHINE¥SOFTWARE¥HITACHI¥HNTRLib2¥<バージョン情報>¥PathName

値の名前

Path00

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

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

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

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

コピー元のファイル

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

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

コピー先のディレクトリ

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

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

Cosminexusを再インストールしたときの注意事項

バージョンアップなどによってCosminexusを再インストールした場合，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環境設定ファイル）の設定

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

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

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

(5)　MBeanの起動確認

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

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

(a)　mserver.propertiesの格納先

<Cosminexusのインストールディレクトリ>¥manager¥config¥mserver.properties

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

com.cosminexus.mngsvr.management.enabled=true
com.cosminexus.mngsvr.management.connector.enabled=true
com.cosminexus.mngsvr.management.port=28099※

注※

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

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

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

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

(a)　mserver.cfgの格納先

<Cosminexusのインストールディレクトリ>¥manager¥config¥mserver.cfg

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

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

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

注※　該当するJARファイルを次に示します。

Oracleのバージョン | 該当するJARファイル
Oracle 10g | <Oracle Clientのインストールディレクトリ>/jdbc/lib/ojdbc14.jar
Oracle 11g（JDK5） | <Oracle Clientのインストールディレクトリ>/jdbc/lib/ojdbc5.jar
Oracle 11g（JDK6） | <Oracle Clientのインストールディレクトリ>/jdbc/lib/ojdbc6.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)　運用管理エージェントの起動（起動済みの場合は再起動）

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

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

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

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

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

(5)　MBeanの起動確認

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

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

50cscbp.xml

50cscmsg.xml

50cscmt.xml

注意

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

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

<Cosminexusのインストールディレクトリ>¥manager¥mbean-plugins¥config¥50cscbp.xml

<Cosminexusのインストールディレクトリ>¥manager¥mbean-plugins¥config¥50cscmsg.xml

<Cosminexusのインストールディレクトリ>¥manager¥mbean-plugins¥lib¥cscbp_mbean.jar

<Cosminexusのインストールディレクトリ>¥manager¥mbean-plugins¥lib¥cscmsg_mbean.jar

2.1.7　アンインストール

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

＜この項の構成＞

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

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

(3)　uCosminexus OperatorおよびuCosminexus Operator for Service Platformのアンインストール

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

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

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

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

ただし，次のディレクトリ下にファイルが存在する場合，ディレクトリは削除されません。

<Cosminexusインストールディレクトリ>¥CSC¥config¥adpfop
<Cosminexusインストールディレクトリ>¥CSC¥config¥adpfop¥templatesの配下は削除されます。

<Cosminexusインストールディレクトリ>¥CSC¥config¥ftprecp
<Cosminexusインストールディレクトリ>¥CSC¥config¥ftprecp¥templatesの配下は削除されます。

<Cosminexusインストールディレクトリ>¥CSC¥config¥manager
<Cosminexusインストールディレクトリ>¥CSC¥config¥manager¥templatesの配下は削除されます。

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

<Cosminexusインストールディレクトリ>¥CSC¥custom-adapter

<Cosminexusインストールディレクトリ>¥CSC¥inbound-adapter¥ftp¥config
<Cosminexusインストールディレクトリ>¥CSC¥inbound-adapter¥ftp¥config¥commandの配下，<Cosminexusインストールディレクトリ>¥CSC¥inbound-adapter¥ftp¥config¥templateの配下，FTP_Inbound_Resource_Adapter¥log4j.xml，およびFTP_Inbound_Resource_Adapter¥serverstatus.propertiesは削除されます。

<Cosminexusインストールディレクトリ>¥CSC¥inbound-adapter¥ftp¥logs

<Cosminexusインストールディレクトリ>¥CSC¥log

<Cosminexusインストールディレクトリ>¥CSC¥repository

<Cosminexusインストールディレクトリ>¥CSC¥spool¥ftp

<Cosminexusインストールディレクトリ>¥CSC¥userlib¥customfunc

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

<Cosminexusインストールディレクトリ>¥CSC¥DB¥area

<Cosminexusインストールディレクトリ>¥CSC¥DB¥bats

<Cosminexusインストールディレクトリ>¥CSC¥spool¥manager

<Cosminexusインストールディレクトリ>¥CSC¥spool¥migration

<Cosminexusインストールディレクトリ>¥CSC¥spool¥msg

<Cosminexusインストールディレクトリ>¥CSC¥system¥msg

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

Cosminexus Service Coordinatorをアンインストールする前に，次の作業を実施する必要があります。uCosminexus OperatorおよびuCosminexus Operator for Service Platformをアンインストールする場合，この作業を実施する必要はありません。

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

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

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

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

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

J2EEサーバの停止方法については，マニュアル「Cosminexus アプリケーションサーバ 運用管理ポータル操作ガイド」の「11.11.7　J2EEサーバの停止」を参照してください。Management Serverの停止方法については，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「7.7.2　Management Serverの起動／停止と設定」を参照してください。

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

uCosminexus Service Platformのアンインストール方法を説明します。

(a)　Windowsの場合のアンインストール方法

Windowsの場合のアンインストール方法について説明します。

uCosminexus Service Platformの構成ソフトウェアをすべてアンインストールする場合と，構成ソフトウェアを単体でアンインストールする場合の手順を次に示します。

●構成ソフトウェアをすべてアンインストールする場合

次のどちらかの方法でアンインストールしてください。

方法1

Windowsの［スタート］メニューから，［コントロールパネル］の［プログラムの追加と削除］を選択します。
［プログラムの追加と削除］ダイアログが表示されます。

［現在インストールされているプログラム］のリストからCosminexusの製品名を選択し，［変更と削除］ボタンをクリックします。
アンインストール種別を確認するダイアログが表示されます。

［はい］ボタンをクリックします。
アンインストールするプログラムの確認画面が表示されます。

アンインストールするプログラムを確認し，［次へ］ボタンをクリックします。
アンインストールが開始され，プログラムが削除されます。

方法2

Windowsの［スタート］メニューから，［すべてのプログラム］－［Cosminexus］－［uCosminexus Service Platformアンインストール］を選択します。
アンインストール種別を確認するダイアログが表示されます。

［はい］ボタンをクリックします。
アンインストールするプログラムの確認画面が表示されます。

アンインストールするプログラムを確認し，［次へ］ボタンをクリックします。
アンインストールが開始され，プログラムが削除されます。

●構成ソフトウェアを単体でアンインストールする場合

次のどちらかの方法でアンインストールしてください。

方法1

Windowsの［スタート］メニューから，［コントロールパネル］の［プログラムの追加と削除］を選択します。
［プログラムの追加と削除］ダイアログが表示されます。

［現在インストールされているプログラム］のリストからCosminexusの製品名を選択し，［変更と削除］ボタンをクリックします。
アンインストール種別を確認するダイアログが表示されます。

［いいえ］ボタンをクリックします。
プログラムを選択する画面が表示されます。

アンインストールしたいプログラムのチェックボックスをチェックし，［次へ］ボタンをクリックします。
アンインストールするプログラムの確認画面が表示されます。

アンインストールするプログラムを確認し，［次へ］ボタンをクリックします。
アンインストールが開始され，プログラムが削除されます。

方法2

Windowsの［スタート］メニューから，［すべてのプログラム］－［Cosminexus］－［uCosminexus Service Platformアンインストール］を選択します。
アンインストール種別を確認するダイアログが表示されます。

［いいえ］ボタンをクリックします。
プログラムを選択する画面が表示されます。

アンインストールしたいプログラムのチェックボックスをチェックし，［次へ］ボタンをクリックします。
アンインストールするプログラムの確認画面が表示されます。

アンインストールするプログラムを確認し，［次へ］ボタンをクリックします。
アンインストールが開始され，プログラムが削除されます。

(b)　UNIXの場合のアンインストール方法

UNIXの場合のアンインストール方法について説明します。

uCosminexus Service Platformのアンインストールは，日立PPインストーラを使用します。アンインストールにはroot権限が必要です。

アンインストール時の注意事項などについては，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「7.2.2　アンインストール方法」を参照してください。

(3)　uCosminexus OperatorおよびuCosminexus Operator for Service Platformのアンインストール

uCosminexus OperatorおよびuCosminexus Operator for Service Platformのアンインストール方法を説明します。

(a)　uCosminexus Operatorのアンインストール

uCosminexus Operatorのアンインストール方法を説明します。

方法

Windowsの［スタート］メニューから，［すべてのプログラム］－［Cosminexus］－［uCosminexus Operatorアンインストール］を選択します。
アンインストール種別を確認するダイアログが表示されます。

［はい］ボタンをクリックします。
アンインストールするプログラムの確認画面が表示されます。

アンインストールするプログラムを確認し，［次へ］ボタンをクリックします。
アンインストールが開始され，プログラムが削除されます。

(b)　uCosminexus Operator for Service Platformのアンインストール

uCosminexus Operator for Service Platformのアンインストールは，対象のディレクトリを直接削除します。

次に示すインストールディレクトリ下のCSCディレクトリおよびpluginsディレクトリを削除すると，アンインストールできます。

<Cosminexusインストールディレクトリ>
 ├common
 ├CSC
 ├jaxp
 ├jdk
 └plugins

参考

uCosminexus Operatorをアンインストールしないで，uCosminexus Operator for Service Platformだけをアンインストールすることもできます。

uCosminexus Operator for Service Platformだけをアンインストールする場合は，<Cosminexusインストールディレクトリ>下のCSCディレクトリを削除し，pluginsディレクトリ内を「cscmng」で検索し，次のファイルを削除してください。

com.cosminexus.plugin.cscmng_<バージョン>

com.cosminexus.plugin.cscmng.core_<バージョン>.jar

com.cosminexus.plugin.cscmng_<バージョン>.jar

2.2　構成の形態およびSOAPモードの選択

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

ここでは，システムで利用する機能と，データベース／Cosminexus RMの使用有無について説明します。また，使用するSOAPモードと対応するWebサービスの標準仕様について説明します。

＜この節の構成＞

2.2.1　データベースとCosminexus RMの使用有無

2.2.2　使用するSOAPモード

2.2.1　データベースとCosminexus RMの使用有無

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

表2-2　使用したい機能ごとのデータベースとCosminexus RMの使用有無

使用したい機能 | データベース | Cosminexus RM
同期受付を使用したい | × | ×
非同期受付を使用したい | ○ | ○
同期サービスアダプタを使用したい | × | ×
非同期サービスアダプタを使用したい | ○ | ○
ビジネスプロセスを使用したい | 永続化するビジネスプロセスを使用したい | ○ | ○
永続化しないビジネスプロセスを使用したい※1 | × | ×
プロセスインスタンスの実行履歴を管理したい | ○ | ○
電文の実行履歴を管理したい | ○ | ×
DBアダプタを使用したい | ×※2 | ×

（凡例）

○：必須です。

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

注※1

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

注※2

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

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

データベースとCosminexus RMの両方を使用する

データベースとCosminexus RMの両方を使用しない

データベースを使用してCosminexus RMを使用しない

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

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

注意

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

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

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

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

2.2.2　使用するSOAPモード

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

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

＜この項の構成＞

(1)　SOAPモードの種類

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

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

(1)　SOAPモードの種類

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

SOAP1.1モード
SOAP1.1に対応したシステムを開発する場合に選択します。SOAP1.1モードはWS-I Basic Profile1.0aに対応しています。
SOAP1.1モードでは，SOAPメッセージの送受信にSOAP通信基盤を使用します。

SOAP1.1/1.2併用モード
SOAP1.1またはSOAP1.2に対応したシステムを開発する場合に選択します。SOAP1.1/1.2併用モードはWS-I Basic Profile1.1に対応しています。
SOAP1.1/1.2併用モードでは，SOAPメッセージの送受信にJAX-WSエンジンを使用します。

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

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

表2-3　SOAPモードのサポート範囲（サービスアダプタ／受付の機能）

分類 | 機能名 | SOAPモード
1.1 | 1.1/1.2併用
サービスアダプタ | Webサービスアダプタ | ○ | ○
Session Beanアダプタ | ○ | ×
MDB（WS-R）アダプタ | ○ | ×
MDB（DBキュー）アダプタ | ○ | ○
カスタムアダプタ | ○ | ○
ビジネスプロセス | ○ | ○
受付 | 標準受付（Webサービス（SOAP1.1）） | ○ | ○
標準受付（Webサービス（SOAP1.2）） | × | ○
標準受付（EJB） | ○ | ○
MDB（WS-R）受付 | ○ | ×
MDB（DBキュー）受付 | ○ | ○
ユーザ定義受付 | ○ | ○

（凡例）

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

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

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

表2-4　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　実行環境に関する設定

実行環境に関する設定には，次のものがあります。

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

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

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

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

データベースの設定

変換テーブルの登録

実行環境に関する設定は，データベースとCosminexus RMの使用有無によって設定内容が異なります。実行環境に関する設定内容については，それぞれ次の個所を参照してください。

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

「2.3.1　HCSCサーバ構成定義ファイルを設定する」～「2.3.8　変換テーブルを登録する」

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

「2.3.10　データベースとCosminexus RMの両方を使用しない場合の実行環境に関する設定」

データベースを使用してCosminexus RMを使用しない

「2.3.11　データベースを使用してCosminexus RMを使用しない場合の実行環境に関する設定」

＜この節の構成＞

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

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

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

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

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

2.3.6　データベース（HiRDB）の排他要求数を見積もる

2.3.7　データベースの領域への配置

2.3.8　変換テーブルを登録する

2.3.9　データ変換で使用するjarファイルを格納する

2.3.10　データベースとCosminexus RMの両方を使用しない場合の実行環境に関する設定

2.3.11　データベースを使用してCosminexus RMを使用しない場合の実行環境に関する設定

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

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

＜この項の構成＞

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

(2)　設定できる要素

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

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

<Cosminexusのインストールディレクトリ>¥CSC¥config¥manager¥templates¥cscsvsetup.xml

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

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

(2)　設定できる要素

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

表2-5　HCSCサーバ構成定義ファイルに設定できる要素（データベースとCosminexus RMの両方を使用する場合）

項番 | 分類 | 使用するタグ名 | 要素
1 | clusterの定義※1 | name | クラスタ名
2 | type※1 | クラスタ種別（LBまたはHA）
3 | cosminexus-managerの定義 | name | Cosminexus Manager名
4 | ip-address※2 | Cosminexus ManagerのIPアドレス
5 | port※2 | Cosminexus Managerのリモート管理機能への外部接続ポート番号
6 | id | Management Serverの管理ユーザID
7 | password※1 | Management Serverの管理ユーザパスワード
8 | csc-serverの定義 | name | HCSCサーバ名
9 | id | HCSCサーバが使用するデータベースのユーザID
10 | password | HCSCサーバが使用するデータベースのパスワード
11 | j2ee-server-name | HCSCサーバが使用するJ2EEサーバ名
12 | setup-properties | HCSCサーバセットアップ定義ファイル名
13 | soap-receptionの定義※1 | ip-address※1※2 | WebサーバのIPアドレス
14 | port※2 | Webサーバのポート番号
15 | protocol※2 | プロトコル種別（httpまたはhttps）
16 | jms-receptionの定義※1※3 | ip-address※1※2 | WebサーバのIPアドレス
17 | port※2 | Webサーバのポート番号
18 | protocol※2 | プロトコル種別（httpまたはhttps）
19 | rm-service-context-root※2 | RMのサービスコンテキストルート
20 | rm-service-name※1※2 | RMのサービス名
21 | jms-physical-receptionの定義※1※4 | ip-address※1※2 | WebサーバのIPアドレス
22 | port※2 | Webサーバのポート番号
23 | protocol※2 | プロトコル種別（httpまたはhttps）
24 | rm-service-context-root※2 | RMのサービスコンテキストルート
25 | rm-service-name※1※2 | RMのサービス名
26 | ejb-receptionの定義※1 | ip-address※1※2 | NameServerのIPアドレス
27 | port※2 | NameServerのポート番号

注※1　省略できます。

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

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

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

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

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

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

＜この項の構成＞

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

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

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

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

<Cosminexusのインストールディレクトリ>¥CSC¥config¥manager¥templates¥cscsvsetup.properties

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

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

表2-6　HCSCサーバセットアップ定義ファイルに定義するプロパティ（データベースとCosminexus RMの両方を使用する場合）

項番 | 分類 | プロパティ名 | 内容
1 | セットアップ構成関連 | db-use※ | データベースの使用有無
2 | rm-use※ | Cosminexus RMの使用有無
3 | hcscserver-data-filepath | HCSCサーバのシステム管理情報の出力先
4 | 標準受付関連 | request-ejb | 標準の同期受付（SessionBean）の使用有無
5 | request-soap | 標準の同期受付（Webサービス）の使用有無
6 | request-jms | 標準の非同期受付（MDB（WS-R））の使用有無
7 | request-jms.maxmessage | 標準の非同期受付（MDB（WS-R））のキューの最大メッセージ数
8 | request-dbq | 標準の非同期受付（MDB（DBキュー））の使用有無
9 | request-dbq.maxmessage | 標準の非同期受付（MDB（DBキュー））のキューの最大メッセージ数
10 | request-jms-rdarea | 標準の非同期受付（MDB（WS-R））のRDエリア名
11 | request-dbq-rdarea | 標準の非同期受付（MDB（DBキュー））のRDエリア名
12 | request-dbq-maxlen | 標準の非同期受付（MDB（DBキュー））の最大メッセージ長
13 | ユーザ定義受付関連 | request-userdef-soap | ユーザ定義受付の使用有無
14 | J2EE関連 | naming-service-hostname | ネーミングサービスのホスト名
15 | naming-service-port | ネーミングサービスのポート番号
16 | Cosminexus RM関連 | rm-systemname | Cosminexus RMのシステム名
17 | rm-displayname | Cosminexus RMの表示名
18 | DBコネクタ関連 | dbcon-xadisplayname | XATransaction用またはLocalTransaction用のDB Connectorの表示名
19 | dbcon-nodisplayname | NoTransaction用DB Connectorの表示名
20 | データベース関連 | dbtype | 使用するデータベース種別
21 | jdbc-type | JDBCドライバ種別
22 | jdbc-url | JDBC用データベースURL
23 | jdbc-dbhostname | データベースのホスト名
24 | jdbc-dbconnectinfo | データベースの接続情報
25 | db-character-sets | データベース文字コード種別
26 | ビジネスプロセスの状態の互換性 | bp-status-compatible | ビジネスプロセスの状態の互換性の使用有無
27 | データベースのRDエリア（表領域）情報 | cscserverinfo-tbl-area | HCSC基本情報用テーブル領域
28 | location-tbl-area | ロケーション用テーブル領域
29 | routing-tbl-area | ルーティング用テーブル領域
30 | cv-tbl-area | データ変換用テーブル領域
31 | exehistory-tbl-area | 実行履歴情報テーブル領域
32 | exehistory-idx-area | 実行履歴情報テーブルのインデクスを格納する領域
33 | process-tbl-area | ビジネスプロセス基盤用PROCESSテーブルを格納する領域
34 | process-idx-area | ビジネスプロセス基盤用PROCESSテーブルのインデクスを格納する領域
35 | activity-tbl-area | ビジネスプロセス基盤用ACTIVITYテーブルを格納する領域
36 | activity-idx-area | ビジネスプロセス基盤用ACTIVITYテーブルのインデクスを格納する領域
37 | link-tbl-area | ビジネスプロセス基盤用LINKテーブルを格納する領域
38 | link-idx-area | ビジネスプロセス基盤用LINKテーブルのインデクスを格納する領域
39 | correlationset-tbl-area | ビジネスプロセス基盤用CORRELATIONSETテーブルを格納する領域
40 | correlationset-idx-area | ビジネスプロセス基盤用CORRELATIONSETテーブルのインデクスを格納する領域
41 | string-variable-tbl-area | ビジネスプロセス基盤用STRING-VARIABLEテーブルを格納する領域
42 | string-variable-idx-area | ビジネスプロセス基盤用STRING-VARIABLEテーブルのインデクスを格納する領域
43 | numeric-variable-tbl-area | ビジネスプロセス基盤用NUMERIC-VARIABLEテーブルを格納する領域
44 | numeric-variable-idx-area | ビジネスプロセス基盤用NUMERIC-VARIABLEテーブルのインデクスを格納する領域
45 | boolean-variable-tbl-area | ビジネスプロセス基盤用BOOLEAN-VARIABLEテーブルを格納する領域
46 | boolean-variable-idx-area | ビジネスプロセス基盤用BOOLEAN-VARIABLEテーブルのインデクスを格納する領域
47 | message-variable-tbl-area | ビジネスプロセス基盤用MESSAGE-VARIABLEテーブルを格納する領域
48 | message-variable-idx-area | ビジネスプロセス基盤用MESSAGE-VARIABLEテーブルのインデクスを格納する領域
49 | message-variable-val-area | ビジネスプロセス基盤用MESSAGE-VARIABLEテーブルのVariableValue列を格納する領域
50 | message-relation-tbl-area | ビジネスプロセス基盤用MESSAGE-RELATIONテーブルを格納する領域
51 | message-relation-idx-area | ビジネスプロセス基盤用MESSAGE-RELATIONテーブルのインデクスを格納する領域
52 | clusterinfo-tbl-area | クラスタ情報を格納する領域
53 | haasyncadp-tbl-area | クラスタ内で配備された非同期アダプタサービスIDを格納する領域
54 | sql-scriptfilename | SQLスクリプトファイルパス
55 | アクティビティインスタンスの最大数の互換性 | activitynumber-maximum-compatible | 一つのプロセスインスタンスで生成できるアクティビティインスタンスの最大数の互換性の使用有無

注※　「ON」を設定する，またはプロパティを省略します。

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

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

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

＜この項の構成＞

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

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

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

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

<Cosminexusのインストールディレクトリ>¥CSC¥config¥manager¥templates¥cscsvconfig.properties

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

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

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

表2-7　HCSCサーバランタイム定義ファイルに定義するプロパティ（データベースとCosminexus RMの両方を使用する場合）

項番 | 分類 | プロパティ名 | 内容
1 | 実行履歴管理 | historyrecord | 実行履歴採取の有無
2 | historyrecord-data | 実行履歴電文データ（ユーザ電文）採取の有無
3 | historyrecord-binarylength | 実行履歴採取電文データ（ユーザ電文）の長さ
4 | ログトレース | methodtrace-filepath | メソッドトレース出力先パス
5 | requesttrace-filepath | リクエストトレース出力先パス
6 | telegramtrace-filepath | ユーザ電文トレース出力先パス
7 | methodtrace-filenum | メソッドトレースの最大面数
8 | requesttrace-filenum | リクエストトレースの最大面数
9 | telegramtrace-filenum | ユーザ電文トレースの最大面数
10 | methodtrace-filesize | メソッドトレースファイル1面当たりの最大サイズ
11 | requesttrace-filesize | リクエストトレースファイル1面当たりの最大サイズ
12 | telegramtrace-filesize | ユーザ電文トレースファイル1面当たりの最大サイズ
13 | methodtrace-level | メソッドトレースの出力レベル
14 | requesttrace | リクエストトレースの採取の有無
15 | telegramtrace | ユーザ電文トレースの採取の有無
16 | bptrace-level | ビジネスプロセス基盤のメソッドトレースの出力レベル
17 | bptrace-filenum | ビジネスプロセス基盤のメソッドトレースの面数
18 | bptrace-filesize | ビジネスプロセス基盤のメソッドトレースのサイズ
19 | データベース情報 | dab-bufsize | DABrokerからの受信データのバッファ長
20 | jdbc-bufsize | JDBCで取り扱うバッファ長
21 | jdbc-longvarbinary | データベースのアクセス方法
22 | jdbc-longvarbinary-access-size | HiRDBに一度に要求するデータの長さ
23 | jdbc-maxbinarysize | 取得するデータの最大長
24 | jdbc-longvarbinary-truncerror | エラーの指定
25 | 標準受付関連 | request-ejb.instance.minimum | 標準の同期受付（SessionBean）のインスタンス最小数
26 | request-ejb.instance.maximum | 標準の同期受付（SessionBean）のインスタンス最大数
27 | request-ejb.ctm | CTM連携の使用有無
28 | request-ejb.parallel.count | CTMがアプリケーションを呼び出すために用意するスレッド数
29 | request-ejb.optional.name | 標準の同期受付（SessionBean）の別名
30 | request-soap.instance.minimum | 標準の同期受付（Webサービス・SOAP1.1）の最小同時実行数
31 | request-soap.instance.maximum | 標準の同期受付（Webサービス・SOAP1.1）の最大同時実行数
32 | request-soap.exclusive.threads | 標準の同期受付（Webサービス・SOAP1.1）の占有スレッド数
33 | request-soap.queue-size | 標準の同期受付（Webサービス・SOAP1.1）の実行待ちキューのサイズ
34 | request-soap1_2.instance.minimum | 標準の同期受付（Webサービス・SOAP1.2）の最小同時実行数
35 | request-soap1_2.instance.maximum | 標準の同期受付（Webサービス・SOAP1.2）の最大同時実行数
36 | request-soap1_2.exclusive.threads | 標準の同期受付（Webサービス・SOAP1.2）の占有スレッド数
37 | request-soap1_2.queue-size | 標準の同期受付（Webサービス・SOAP1.2）の実行待ちキューのサイズ
38 | request-jms.instance.maximum | 標準の非同期受付（MDB（WS-R））のインスタンス最大数
39 | receptionstop-monitor-timer | 標準受付，HCSCサーバ転送用受付サービス停止処理のタイムアウト時間
40 | サービスアダプタ関連 | soapfault-targetnamespace-filepath | SOAP Faultをユーザ定義例外として扱うかどうか
41 | データ変換関連 | formatdef-maxcache-num | フォーマット定義をキャッシュできる数
42 | transformdef-maxcache-num | データ変換定義をキャッシュできる数
43 | xmltelegram-maxcache-num | XML電文をキャッシュできる数
44 | telegram-validation | 電文フォーマットに対して，送受信する電文が適切かを検証するかどうか※
45 | xmltelegram-namespace-complement | XML電文内の属性値に指定された名前空間接頭辞に対応した名前空間宣言を補完するかどうか
46 | telegram-undefined-character-code | バイナリデータの文字コード変換処理で，未定義の文字コードが検出された場合に処理を継続するかどうか
47 | telegram-notfound-soapheader | 受付定義ファイル，サービスアダプタ定義ファイル，またはビジネスプロセス定義ファイルに対して，送受信する電文に指定されたSOAPヘッダが存在しない場合に処理を継続するかどうか
48 | validation-activity | 検証アクティビティで，メッセージ型変数（XML）を検証するかどうか
49 | J2EE関連 | j2ee-stopapp-timeout | J2EEアプリケーション停止時のタイムアウト
50 | startcsc-timeout | J2EEサーバ起動タイムアウト
51 | stopcsc-timeout | J2EEサーバ停止タイムアウト
52 | コマンドの通信のタイムアウト時間の監視 | csc-command-timeout | コマンドタイムアウト
53 | Cookie情報の引き継ぎ | cookie-parsing | Cookieを引き継ぐかどうか
54 | フォルダ関連 | work-folder | 作業フォルダルートの絶対パス
55 | common-folder-<共通フォルダ定義名> | 共通フォルダの絶対パス
56 | DBアダプタ関連 | dba-separate-transaction | ビジネスプロセスとは別にDBアダプタのトランザクションを開始するかどうか

注※

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

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

ユーザ定義受付（Webサービス）の情報は，ユーザ定義受付ランタイム定義ファイルに設定します。

＜この項の構成＞

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

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

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

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

<Cosminexusのインストールディレクトリ>¥CSC¥config¥manager¥templates¥cscurcptnconfig.properties

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

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

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

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

表2-8　ユーザ定義受付ランタイム定義ファイルに定義するプロパティ（データベースとCosminexus RMの両方を使用する場合）

項番 | 分類 | プロパティ名 | 内容
1 | ユーザ定義受付 | user-defined-reception-soap.threads.maximum | ユーザ定義受付の最大同時実行数
2 | user-defined-reception-soap.exclusive.threads | ユーザ定義受付の占有スレッド数
3 | user-defined-reception-soap.queue-size | ユーザ定義受付の実行待ちキューのサイズ

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

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

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

＜この項の構成＞

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

(2)　電文の実行履歴の管理に関するテーブル容量の見積もり

(3)　実行環境の設定に関するテーブル容量の見積もり

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

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

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

分類 | テーブル名 | 説明
基本情報テーブル | 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_<クラスタ名>_CORRELATION-SETテーブル

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

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

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

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

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

メッセージ送受信数＝receiveアクティビティ定義数

＋応答アクティビティ定義数

＋非同期呼び出しアクティビティ定義数

＋同期アクティビティ定義数×2

(c)　インデクスの各種概算式

インデクスの各種概算式は，インデクス定義，およびレコード数から導き出します。見積もり式については，使用しているデータベースのマニュアルを参照してください。

(2)　電文の実行履歴の管理に関するテーブル容量の見積もり

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

表2-10　電文の実行履歴の管理に関するデータベースのテーブルの一覧

分類 | テーブル名 | 説明
実行履歴情報テーブル | CSCMSG_C<クラスタ名>_EXECHISTORY | 電文の実行履歴情報を格納します。

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

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

レコード数の概算式

インデクスの各種概算式

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

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

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

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

CSCMSG_C<クラスタ名>_EXECHISTORYテーブル

(c)　インデクスの各種概算式

インデクスの各種概算式は，インデクス定義，およびレコード数から導き出します。見積もり式については，使用しているデータベースのマニュアルを参照してください。

(3)　実行環境の設定に関するテーブル容量の見積もり

実行環境の設定に関するデータベースのテーブルの一覧を次の表に示します。

表2-11　実行環境の設定に関するデータベースのテーブルの一覧

分類 | テーブル名 | 説明
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の場合，実行履歴を削除する際の排他要求数を見積もる必要があります。実行履歴の削除には，次の二つがあります。

プロセスインスタンスの実行履歴の削除
プロセスインスタンスの実行履歴を削除する方法の詳細については，「6.1.4 プロセスインスタンスの実行履歴を削除する」を参照してください。

電文の実行履歴の削除
電文の実行履歴を削除する方法の詳細については，「6.2.5 電文の実行履歴を削除する」を参照してください。

実行履歴を削除する際の排他要求数を見積もる方法について，次に説明します。なお，見積もった排他要求数は，HiRDBの定義ファイルに定義する必要があります。HiRDBの定義ファイルおよび定義ファイルに定義するオペランドについては，マニュアル「HiRDB システム定義」の排他資源数の見積もりに関する内容を参照してください。

＜この項の構成＞

(1)　プロセスインスタンスの実行履歴を削除する際の排他要求数の見積もり

(2)　電文の実行履歴を削除する際の排他要求数の見積もり

(1)　プロセスインスタンスの実行履歴を削除する際の排他要求数の見積もり

見積もる対象となるSQLは，操作系SQLの「DELETE（LOCK TABLEなし，およびインデクスキー値無排他方式の場合）」です。「DELETE（LOCK TABLEなし，およびインデクスキー値無排他方式の場合）」については，マニュアル「HiRDB システム定義」の排他資源数の見積もりに関する内容を参照してください。

排他要求数の見積もりでは，すべてのテーブルの排他資源数を計算します。排他資源数は，表2-12に示した値を使用して計算してください。計算したら，排他資源数の中で最も大きい排他資源数に余裕値を加算して，排他要求数を見積もります。なお，見積もった排他要求数は，HiRDBの定義ファイルに定義します。

排他資源数の見積もり方法，および見積もった排他要求数の設定については，マニュアル「HiRDB システム定義」の排他資源数の見積もりに関する内容，および排他制御に関するオペランドの「pd_lck_pool_size」に関する内容を参照してください。

プロセスインスタンスの実行履歴を削除する際の排他資源数の見積もりに使用する値を次の表に示します。

表2-12　排他資源数の見積もりに使用する値（プロセスインスタンスの実行履歴を削除する場合）

項番 | 項目 | 指定値
A | B | C | D | E | F | G | H | I
1 | 削除対象RDエリア数 | 2 | 2 | 3 | 2 | 2 | 2 | 2 | 4 | 2
2 | 削除行数 | 1 | 一つのビジネスプロセスに定義したアクティビティの数の最大値 | 一つのビジネスプロセスに定義したリンクの数の最大値 | 一つのビジネスプロセスに定義した相関セットの数の最大値 | 一つのビジネスプロセスに定義したグローバル変数のstring型変数の数の最大値 | 一つのビジネスプロセスに定義したグローバル変数のnumeric型変数の数の最大値 | 一つのビジネスプロセスに定義したグローバル変数のboolean型変数の数の最大値 | 一つのビジネスプロセスに定義したグローバル変数のメッセージ型変数の数の最大値 | 一つのビジネスプロセスに定義したアクティビティの数の最大値の2倍
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-13を参照してください。

（凡例）

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-13　前処理の排他要求数の見積もりに使用する値（プロセスインスタンスの実行履歴を削除する場合）

項番 | 項目 | 指定値
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 | 列数 | 7 | 12 | 4 | 8 | 4 | 4 | 4 | 4 | 5
4 | インデクス数 | 3 | 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)　電文の実行履歴を削除する際の排他要求数の見積もり

見積もる対象となるSQLは，操作系SQLの「DELETE（LOCK TABLEなし，およびインデクスキー値無排他方式の場合）」です。「DELETE（LOCK TABLEなし，およびインデクスキー値無排他方式の場合）」については，マニュアル「HiRDB システム定義」の排他資源数の見積もりに関する内容を参照してください。

排他要求数の見積もりでは，表2-14に示した値を使用して，排他資源数を計算します。計算したら，排他資源数に余裕値を加算して，排他要求数を見積もります。なお，見積もった排他要求数は，HiRDBの定義ファイルに定義します。

排他資源数の見積もり方法，および見積もった排他要求数の設定については，マニュアル「HiRDB システム定義」の排他資源数の見積もりに関する内容，および排他制御のオペランドの「pd_lck_pool_size」の説明を参照してください。

電文の実行履歴を削除する際の排他要求数の見積もりに使用する値を次の表に示します。

表2-14　排他資源数の見積もりに使用する値（電文の実行履歴を削除する場合）

項番
項目
指定値

1
削除対象RDエリア数
次のテーブルおよびインデクスが作成されているRDエリアの数

テーブル

CSCMSG_C<クラスタ名>_EXECHISTORYテーブル

インデクス

CSCMSG_<individualname>_EXECHISTORY_I

2
削除行数
csmdeletehistoryコマンドで削除する際の削除対象件数※1

3
VARCHAR，NVARCHAR，MVARCHARの256バイト以上の列数
1

4
分岐数
1

5
1ページに格納できないBINARY型の列数
1※2

6
削除したLOBデータ数
0

7
削除したLOBデータ格納セグメント数
0

8
データ型プラグインまたはインデクス型プラグイン
－

9
pd_inner_replica_controlオペランド（UNIX版HiRDBの場合）
－※3

10
ルーチン
－

11
前処理
表2-15を参照してください。

（凡例）

－：未定義，または未使用の項目です。

注※1

csmlshistoryコマンドの-kオプションにcountを指定すると，指定した条件を満たす履歴情報の件数を調べることができます。自動運用によって，定期的に実行履歴を削除したい場合は，csmlshistoryコマンドの-kオプションにcountを指定して出力される実行履歴の数を見積もって，削除行数を計算してください。csmlshistoryコマンドについては，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「csmlshistory（電文の実行履歴情報の表示）」を参照してください。

注※2

ページ長を2,000バイト以下に設定した，データベースのRDエリアを作成した場合，「4」として計算してください。

注※3

pd_inner_replica_controlオペランドを指定した場合，見積もった排他要求数に削除対象RDエリア数として「1」を加算してください。pd_inner_replica_controlオペランドを指定した場合の詳細については，マニュアル「HiRDB システム定義」の排他資源数の見積もりに関する内容を参照してください。

前処理の排他要求数の見積もりに使用する値を次の表に示します。前処理の排他要求数については，マニュアル「HiRDB システム定義」を参照してください。

表2-15　前処理の排他要求数の見積もりに使用する値（電文の実行履歴を削除する場合）

項番 | 項目 | 指定値
1 | 使用する表数 | 1
2 | 使用するビュー表数 | 0
3 | 列数 | 30
4 | インデクス数 | 2
5 | 表分割数 | －
6 | インデクス分割数 | －
7 | ユーザ定義型の使用，または関数の使用 | －
8 | 最適化情報 | －
9 | ビュー表の使用 | －
10 | ビュー表を構成する列数 | －
11 | LOB列の定義 | －
12 | ユーザ定義型の列の定義 | －
13 | LOB属性 | －
14 | 上位型 | －
15 | 関数の使用 | －
16 | プラグインの使用 | －
17 | ルーチンの使用 | －

（凡例）

－：未定義，または未使用の項目です。

2.3.7　データベースの領域への配置

データベースのテーブル容量の見積もり後，各テーブルおよびインデクスをデータベースの領域（HiRDBの場合はRDエリア，Oracleの場合は表領域（テーブルスペース））にどう配置するかを設計する必要があります。

データベースの領域は，HCSCサーバセットアップ定義ファイルのプロパティで配置を設定します。詳細については，「表2-6　HCSCサーバセットアップ定義ファイルに定義するプロパティ（データベースとCosminexus RMの両方を使用する場合）」の「データベースのRDエリア（表領域）情報」を参照してください。

注意

テーブルとインデクスのデータベースの領域は，次の内容も考慮して設計してください。

構築後の運用も踏まえたデータ量

業務システムとのバランス

2.3.8　変換テーブルを登録する

開発環境で作成したデータ変換定義に値置換えファンクションが含まれる場合，値置換えファンクションで利用する変換テーブルを，システムプロパティファイル（usrconf.properties）に登録します。

usrconf.propertiesの格納先

<Cosminexusのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥usrconf.properties

usrconf.propertiesへの登録方法

usrconf.propertiesに，変換テーブルID，変換テーブルのファイルパス，変換テーブルの合計ファイルサイズ，および使用する文字コードを記述します。格納先と文字コードの情報を一組として記述します。複数の変換テーブルについて記述できます。

usrconf.propertiesに記述する内容と形式を次に示します。

　　　:
csc.dt.valueTable.<変換テーブルID>=<変換テーブルのファイルパス>
csc.dt.valueTableSize=<変換テーブルの合計ファイルサイズ>
csc.dt.encodeType.<変換テーブルID>=［MS932|UTF8|UTF16_BIG|UTF16_LITTLE］
　　　:

<変換テーブルID>

変換テーブルIDとして任意の名称を指定します。変換テーブルIDは，開発環境の値置換えダイアログで値置換えファンクションを定義する際，使用する変換テーブルの指定に使用します。

<変換テーブルのファイルパス>

変換テーブルのファイルパスを絶対パスで指定します。

<変換テーブルの合計ファイルサイズ><<10>>

変換テーブルの合計ファイルサイズ（単位：キロバイト）を指定します。合計ファイルサイズには，正の整数を指定します。指定範囲は，1～2097151です。指定を省略した場合は，10が仮定されます。

［MS932|UTF8|UTF16_BIG|UTF16_LITTLE］

変換テーブルに使用している文字コードを指定します。

2.3.9　データ変換で使用するjarファイルを格納する

開発環境で作成したデータ変換定義にカスタムファンクションが含まれる場合，カスタムファンクションで使用するjarファイルを実行環境に格納します。

jarファイルの格納先

<Cosminexusのインストールディレクトリ>¥CSC¥userlib¥customfunc

なお，実行環境にjarファイルを格納したあとは，J2EEサーバを再起動してください。

カスタムファンクションで使用するjarファイルの格納先を変更したい場合は，システムプロパティファイル（usrconf.properties）にファイルパスを設定します。

usrconf.propertiesの格納先

<Cosminexusのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥usrconf.properties

usrconf.propertiesへの記述形式

csc.dt.customFuncDir=<変更先ディレクトリのパス>

usrconf.propertiesへの記述例

カスタムファンクションで使用するjarファイルの格納先を「C:¥¥USER¥¥FUNC」に変更する場合の記述例を次に示します。

csc.dt.customFuncDir=C:¥¥USER¥¥FUNC

usrconf.propertiesにファイルパスを設定する場合の注意事項

カスタムファンクションで使用するjarファイルの格納先にCosminexusのインストールディレクトリ配下を指定すると，アンインストール時に削除されるおそれがあります。そのため，カスタムファンクションで使用するjarファイルの格納先を変更する場合は，Cosminexusのインストールディレクトリ配下以外の場所に設定してください。

2.3.10　データベースとCosminexus RMの両方を使用しない場合の実行環境に関する設定

データベースとCosminexus RMの両方を使用しない場合，実行環境に関する設定内容が，データベースとCosminexus RMの両方を使用する場合と異なります。

ここでは，データベースとCosminexus RMの両方を使用しない場合に設定する次の内容について，データベースとCosminexus RMの両方を使用する場合との違いを説明します。

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

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

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

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

変換テーブルの登録

＜この項の構成＞

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

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

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

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

(5)　変換テーブルの登録

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

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

なお，HCSCサーバ構成定義ファイルの作成方法については，「2.3.1(1) HCSCサーバ構成定義ファイルの作成」を参照してください。

表2-16　HCSCサーバ構成定義ファイルに設定できる要素（データベースとCosminexus RMの両方を使用しない場合）

項番 | 分類 | 使用するタグ名 | 要素 | 指定可否
1 | clusterの定義※1 | name | クラスタ名 | ○
2 | type※1 | クラスタ種別（LBまたはHA） | ○
3 | cosminexus-managerの定義 | name | Cosminexus Manager名 | ○
4 | ip-address※2 | Cosminexus ManagerのIPアドレス | ○
5 | port※2 | Cosminexus Managerのリモート管理機能への外部接続ポート番号 | ○
6 | id | Management Serverの管理ユーザID | ○
7 | password※1 | Management Serverの管理ユーザパスワード | ○
8 | csc-serverの定義 | name | HCSCサーバ名 | ○
9 | id | HCSCサーバが使用するデータベースのユーザID | ×
10 | password | HCSCサーバが使用するデータベースのパスワード | ×
11 | j2ee-server-name | HCSCサーバが使用するJ2EEサーバ名 | ○
12 | setup-properties | HCSCサーバセットアップ定義ファイル名 | ○
13 | soap-receptionの定義※1 | ip-address※1※2 | WebサーバのIPアドレス | ○
14 | port※2 | Webサーバのポート番号 | ○
15 | protocol※2 | プロトコル種別（httpまたはhttps） | ○
16 | jms-receptionの定義※1※3 | ip-address※1※2 | WebサーバのIPアドレス | ×
17 | port※2 | Webサーバのポート番号 | ×
18 | protocol※2 | プロトコル種別（httpまたはhttps） | ×
19 | rm-service-context-root※2 | RMのサービスコンテキストルート | ×
20 | rm-service-name※1※2 | RMのサービス名 | ×
21 | jms-physical-receptionの定義※1※4 | ip-address※1※2 | WebサーバのIPアドレス | ×
22 | port※2 | Webサーバのポート番号 | ×
23 | protocol※2 | プロトコル種別（httpまたはhttps） | ×
24 | rm-service-context-root※2 | RMのサービスコンテキストルート | ×
25 | rm-service-name※1※2 | RMのサービス名 | ×
26 | ejb-receptionの定義※1 | ip-address※1※2 | NameServerのIPアドレス | ○
27 | port※2 | NameServerのポート番号 | ○

（凡例）

○：指定できます。

×：指定できません。

注※1　省略できます。

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

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

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

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

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

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

なお，HCSCサーバセットアップ定義ファイルの作成方法については，「2.3.2(1) HCSCサーバセットアップ定義ファイルの作成」を参照してください。

表2-17　HCSCサーバセットアップ定義ファイルに定義するプロパティ（データベースとCosminexus RMの両方を使用しない場合）

項番 | 分類 | プロパティ名 | 内容 | 指定可否
1 | セットアップ構成関連 | db-use※ | データベースの使用有無 | ○
2 | rm-use※ | Cosminexus RMの使用有無 | ○
3 | hcscserver-data-filepath | HCSCサーバのシステム管理情報の出力先 | ○
4 | 標準受付関連 | request-ejb | 標準の同期受付（SessionBean）の使用有無 | ○
5 | request-soap | 標準の同期受付（Webサービス）の使用有無 | ○
6 | request-jms※ | 標準の非同期受付（MDB（WS-R））の使用有無 | ○
7 | request-jms.maxmessage | 標準の非同期受付（MDB（WS-R））のキューの最大メッセージ数 | ×
8 | request-dbq※ | 標準の非同期受付（MDB（DBキュー））の使用有無 | ○
9 | request-dbq.maxmessage | 標準の非同期受付（MDB（DBキュー））のキューの最大メッセージ数 | ×
10 | request-jms-rdarea | 標準の非同期受付（MDB（WS-R））のRDエリア名 | ×
11 | request-dbq-rdarea | 標準の非同期受付（MDB（DBキュー））のRDエリア名 | ×
12 | request-dbq-maxlen | 標準の非同期受付（MDB（DBキュー））の最大メッセージ長 | ×
13 | ユーザ定義受付関連 | request-userdef-soap | ユーザ定義受付の使用有無 | ○
14 | J2EE関連 | naming-service-hostname | ネーミングサービスのホスト名 | ○
15 | naming-service-port | ネーミングサービスのポート番号 | ○
16 | Cosminexus RM関連 | rm-systemname | Cosminexus RMのシステム名 | ×
17 | rm-displayname | Cosminexus RMの表示名 | ×
18 | DBコネクタ関連 | dbcon-xadisplayname | XATransaction用またはLocalTransaction用のDB Connectorの表示名 | ×
19 | dbcon-nodisplayname | NoTransaction用DB Connectorの表示名 | ×
20 | データベース関連 | dbtype | 使用するデータベース種別 | ×
21 | jdbc-type | JDBCドライバ種別 | ×
22 | jdbc-url | JDBC用データベースURL | ×
23 | jdbc-dbhostname | データベースのホスト名 | ×
24 | jdbc-dbconnectinfo | データベースの接続情報 | ×
25 | db-character-sets | データベース文字コード種別 | ×
26 | ビジネスプロセスの状態の互換性 | bp-status-compatible | ビジネスプロセスの状態の互換性の使用有無 | ○
27 | データベースのRDエリア（表領域）情報 | cscserverinfo-tbl-area | HCSC基本情報用テーブル領域 | ×
28 | location-tbl-area | ロケーション用テーブル領域 | ×
29 | routing-tbl-area | ルーティング用テーブル領域 | ×
30 | cv-tbl-area | データ変換用テーブル領域 | ×
31 | exehistory-tbl-area | 実行履歴情報テーブル領域 | ×
32 | exehistory-idx-area | 実行履歴情報テーブルのインデクスを格納する領域 | ×
33 | process-tbl-area | ビジネスプロセス基盤用PROCESSテーブルを格納する領域 | ×
34 | process-idx-area | ビジネスプロセス基盤用PROCESSテーブルのインデクスを格納する領域 | ×
35 | activity-tbl-area | ビジネスプロセス基盤用ACTIVITYテーブルを格納する領域 | ×
36 | activity-idx-area | ビジネスプロセス基盤用ACTIVITYテーブルのインデクスを格納する領域 | ×
37 | link-tbl-area | ビジネスプロセス基盤用LINKテーブルを格納する領域 | ×
38 | link-idx-area | ビジネスプロセス基盤用LINKテーブルのインデクスを格納する領域 | ×
39 | correlationset-tbl-area | ビジネスプロセス基盤用CORRELATIONSETテーブルを格納する領域 | ×
40 | correlationset-idx-area | ビジネスプロセス基盤用CORRELATIONSETテーブルのインデクスを格納する領域 | ×
41 | string-variable-tbl-area | ビジネスプロセス基盤用STRING-VARIABLEテーブルを格納する領域 | ×
42 | string-variable-idx-area | ビジネスプロセス基盤用STRING-VARIABLEテーブルのインデクスを格納する領域 | ×
43 | numeric-variable-tbl-area | ビジネスプロセス基盤用NUMERIC-VARIABLEテーブルを格納する領域 | ×
44 | numeric-variable-idx-area | ビジネスプロセス基盤用NUMERIC-VARIABLEテーブルのインデクスを格納する領域 | ×
45 | boolean-variable-tbl-area | ビジネスプロセス基盤用BOOLEAN-VARIABLEテーブルを格納する領域 | ×
46 | boolean-variable-idx-area | ビジネスプロセス基盤用BOOLEAN-VARIABLEテーブルのインデクスを格納する領域 | ×
47 | message-variable-tbl-area | ビジネスプロセス基盤用MESSAGE-VARIABLEテーブルを格納する領域 | ×
48 | message-variable-idx-area | ビジネスプロセス基盤用MESSAGE-VARIABLEテーブルのインデクスを格納する領域 | ×
49 | message-variable-val-area | ビジネスプロセス基盤用MESSAGE-VARIABLEテーブルのVariableValue列を格納する領域 | ×
50 | message-relation-tbl-area | ビジネスプロセス基盤用MESSAGE-RELATIONテーブルを格納する領域 | ×
51 | message-relation-idx-area | ビジネスプロセス基盤用MESSAGE-RELATIONテーブルのインデクスを格納する領域 | ×
52 | clusterinfo-tbl-area | クラスタ情報を格納する領域 | ×
53 | haasyncadp-tbl-area | クラスタ内で配備された非同期アダプタサービスIDを格納する領域 | ×
54 | sql-scriptfilename | SQLスクリプトファイルパス | ×
55 | アクティビティインスタンスの最大数の互換性 | activitynumber-maximum-compatible | 一つのプロセスインスタンスで生成できるアクティビティインスタンスの最大数の互換性の使用有無 | ○

（凡例）

○：指定できます。

×：指定できません。

注※　「OFF」を設定します。

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

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

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

なお，HCSCサーバランタイム定義ファイルの作成方法については，「2.3.3(1) HCSCサーバランタイム定義ファイルの作成」を参照してください。

表2-18　HCSCサーバランタイム定義ファイルに定義するプロパティ（データベースとCosminexus RMの両方を使用しない場合）

項番 | 分類 | プロパティ名 | 内容 | 指定可否
1 | 実行履歴管理 | historyrecord | 実行履歴採取の有無 | ×
2 | historyrecord-data | 実行履歴電文データ（ユーザ電文）採取の有無 | ×
3 | historyrecord-binarylength | 実行履歴採取電文データ（ユーザ電文）の長さ | ×
4 | ログトレース | methodtrace-filepath | メソッドトレース出力先パス | ○
5 | requesttrace-filepath | リクエストトレース出力先パス | ○
6 | telegramtrace-filepath | ユーザ電文トレース出力先パス | ○
7 | methodtrace-filenum | メソッドトレースの最大面数 | ○
8 | requesttrace-filenum | リクエストトレースの最大面数 | ○
9 | telegramtrace-filenum | ユーザ電文トレースの最大面数 | ○
10 | methodtrace-filesize | メソッドトレースファイル1面当たりの最大サイズ | ○
11 | requesttrace-filesize | リクエストトレースファイル1面当たりの最大サイズ | ○
12 | telegramtrace-filesize | ユーザ電文トレースファイル1面当たりの最大サイズ | ○
13 | methodtrace-level | メソッドトレースの出力レベル | ○
14 | requesttrace | リクエストトレースの採取の有無 | ○
15 | telegramtrace | ユーザ電文トレースの採取の有無 | ○
16 | bptrace-level | ビジネスプロセス基盤のメソッドトレースの出力レベル | ○
17 | bptrace-filenum | ビジネスプロセス基盤のメソッドトレースの面数 | ○
18 | bptrace-filesize | ビジネスプロセス基盤のメソッドトレースのサイズ | ○
19 | データベース情報 | dab-bufsize | DABrokerからの受信データのバッファ長 | ×
20 | jdbc-bufsize | JDBCで取り扱うバッファ長 | ×
21 | jdbc-longvarbinary | データベースのアクセス方法 | ×
22 | jdbc-longvarbinary-access-size | HiRDBに一度に要求するデータの長さ | ×
23 | jdbc-maxbinarysize | 取得するデータの最大長 | ×
24 | jdbc-longvarbinary-truncerror | エラーの指定 | ×
25 | 標準受付関連 | request-ejb.instance.minimum | 標準の同期受付（SessionBean）のインスタンス最小数 | ○
26 | request-ejb.instance.maximum | 標準の同期受付（SessionBean）のインスタンス最大数 | ○
27 | request-ejb.ctm | CTM連携の使用有無 | ○
28 | request-ejb.parallel.count | CTMがアプリケーションを呼び出すために用意するスレッド数 | ○
29 | request-ejb.optional.name | 標準の同期受付（SessionBean）の別名 | ○
30 | request-soap.instance.minimum | 標準の同期受付（Webサービス・SOAP1.1）の最小同時実行数 | ○
31 | request-soap.instance.maximum | 標準の同期受付（Webサービス・SOAP1.1）の最大同時実行数 | ○
32 | request-soap.exclusive.threads | 標準の同期受付（Webサービス・SOAP1.1）の占有スレッド数 | ○
33 | request-soap.queue-size | 標準の同期受付（Webサービス・SOAP1.1）の実行待ちキューのサイズ | ○
34 | request-soap1_2.instance.minimum | 標準の同期受付（Webサービス・SOAP1.2）の最小同時実行数 | ○
35 | request-soap1_2.instance.maximum | 標準の同期受付（Webサービス・SOAP1.2）の最大同時実行数 | ○
36 | request-soap1_2.exclusive.threads | 標準の同期受付（Webサービス・SOAP1.2）の占有スレッド数 | ○
37 | request-soap1_2.queue-size | 標準の同期受付（Webサービス・SOAP1.2）の実行待ちキューのサイズ | ○
38 | request-jms.instance.maximum | 標準の非同期受付（MDB（WS-R））のインスタンス最大数 | ×
39 | receptionstop-monitor-timer | 標準受付，HCSCサーバ転送用受付サービス停止処理のタイムアウト時間 | ×
40 | サービスアダプタ関連 | soapfault-targetnamespace-filepath | SOAP Faultをユーザ定義例外として扱うかどうか | ○
41 | データ変換関連 | formatdef-maxcache-num | フォーマット定義をキャッシュできる数 | ○
42 | transformdef-maxcache-num | データ変換定義をキャッシュできる数 | ○
43 | xmltelegram-maxcache-num | XML電文をキャッシュできる数 | ○
44 | telegram-validation | 電文フォーマットに対して，送受信する電文が適切かを検証するかどうか | ○
45 | xmltelegram-namespace-complement | XML電文内の属性値に指定された名前空間接頭辞に対応した名前空間宣言を補完するかどうか | ○
46 | telegram-undefined-character-code | バイナリデータの文字コード変換処理で，未定義の文字コードが検出された場合に処理を継続するかどうか | ○
47 | telegram-notfound-soapheader | 受付定義ファイル，サービスアダプタ定義ファイル，またはビジネスプロセス定義ファイルに対して，送受信する電文に指定されたSOAPヘッダが存在しない場合に処理を継続するかどうか | ○
48 | validation-activity | 検証アクティビティで，メッセージ型変数（XML）を検証するかどうか | ○
49 | J2EE関連 | j2ee-stopapp-timeout | J2EEアプリケーション停止時のタイムアウト時間 | ○
50 | startcsc-timeout | J2EEサーバ起動時のタイムアウト時間 | ○
51 | stopcsc-timeout | J2EEサーバ停止時のタイムアウト時間 | ○
52 | コマンドの通信のタイムアウト時間の監視 | csc-command-timeout | コマンドの通信タイムアウト時間 | ○
53 | Cookie情報の引き継ぎ | cookie-parsing | Cookie情報を引き継ぐかどうか | ○
54 | フォルダ関連 | work-folder | 作業フォルダルートの絶対パス | ○
55 | common-folder-<共通フォルダ定義名> | 共通フォルダの絶対パス | ○
56 | DBアダプタ関連 | dba-separate-transaction | ビジネスプロセスとは別にDBアダプタのトランザクションを開始するかどうか | ○

（凡例）

○：指定できます。

×：指定できません。

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

注意

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

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

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

なお，ユーザ定義受付ランタイム定義ファイルの作成方法については，「2.3.4(1) ユーザ定義受付ランタイム定義ファイルの作成」を参照してください。

表2-19　ユーザ定義受付ランタイム定義ファイルに定義するプロパティ（データベースとCosminexus RMの両方を使用しない場合）

項番 | 分類 | プロパティ名 | 内容 | 指定可否
1 | ユーザ定義受付 | user-defined-reception-soap.threads.maximum | ユーザ定義受付の最大同時実行数 | ○
2 | user-defined-reception-soap.exclusive.threads | ユーザ定義受付の占有スレッド数 | ○
3 | user-defined-reception-soap.queue-size | ユーザ定義受付の実行待ちキューのサイズ | ○

（凡例）

○：指定できます。

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

(5)　変換テーブルの登録

開発環境で作成したデータ変換定義に値置換えファンクションが含まれる場合，値置換えファンクションで利用する変換テーブルを，システムプロパティファイル（usrconf.properties）に登録します。詳細については「2.3.8　変換テーブルを登録する」を参照してください。

2.3.11　データベースを使用してCosminexus RMを使用しない場合の実行環境に関する設定

データベースを使用してCosminexus RMを使用しない場合，実行環境に関する設定内容が，データベースとCosminexus RMの両方を使用する場合と異なります。

ここでは，データベースを使用してCosminexus RMを使用しない場合に設定する次の内容について，データベースとCosminexus RMの両方を使用する場合との違いを説明します。

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

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

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

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

データベースのテーブル容量の見積もり

データベースの領域への配置

変換テーブルの登録

＜この項の構成＞

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

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

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

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

(5)　データベースのテーブル容量の見積もり

(6)　データベースの領域への配置

(7)　変換テーブルの登録

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

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

なお，HCSCサーバ構成定義ファイルの作成方法については，「2.3.1(1) HCSCサーバ構成定義ファイルの作成」を参照してください。

表2-20　HCSCサーバ構成定義ファイルに設定できる要素（データベースを使用してCosminexus RMを使用しない場合）

項番 | 分類 | 使用するタグ名 | 要素 | 指定可否
1 | clusterの定義※1 | name | クラスタ名 | ○
2 | type※1 | クラスタ種別（LBまたはHA） | ○
3 | cosminexus-managerの定義 | name | Cosminexus Manager名 | ○
4 | ip-address※2 | Cosminexus ManagerのIPアドレス | ○
5 | port※2 | Cosminexus Managerのリモート管理機能への外部接続ポート番号 | ○
6 | id | Management Serverの管理ユーザID | ○
7 | password※1 | Management Serverの管理ユーザパスワード | ○
8 | csc-serverの定義 | name | HCSCサーバ名 | ○
9 | id | HCSCサーバが使用するデータベースのユーザID | ○
10 | password | HCSCサーバが使用するデータベースのパスワード | ○
11 | j2ee-server-name | HCSCサーバが使用するJ2EEサーバ名 | ○
12 | setup-properties | HCSCサーバセットアップ定義ファイル名 | ○
13 | soap-receptionの定義※1 | ip-address※1※2 | WebサーバのIPアドレス | ○
14 | port※2 | Webサーバのポート番号 | ○
15 | protocol※2 | プロトコル種別（httpまたはhttps） | ○
16 | jms-receptionの定義※1※3 | ip-address※1※2 | WebサーバのIPアドレス | ×
17 | port※2 | Webサーバのポート番号 | ×
18 | protocol※2 | プロトコル種別（httpまたはhttps） | ×
19 | rm-service-context-root※2 | RMのサービスコンテキストルート | ×
20 | rm-service-name※1※2 | RMのサービス名 | ×
21 | jms-physical-receptionの定義※1※4 | ip-address※1※2 | WebサーバのIPアドレス | ×
22 | port※2 | Webサーバのポート番号 | ×
23 | protocol※2 | プロトコル種別（httpまたはhttps） | ×
24 | rm-service-context-root※2 | RMのサービスコンテキストルート | ×
25 | rm-service-name※1※2 | RMのサービス名 | ×
26 | ejb-receptionの定義※1 | ip-address※1※2 | NameServerのIPアドレス | ○
27 | port※2 | NameServerのポート番号 | ○

（凡例）

○：指定できます。

×：指定できません。

注※1　省略できます。

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

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

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

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

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

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

なお，HCSCサーバセットアップ定義ファイルの作成方法については，「2.3.2(1) HCSCサーバセットアップ定義ファイルの作成」を参照してください。

表2-21　HCSCサーバセットアップ定義ファイルに定義するプロパティ（データベースを使用してCosminexus RMを使用しない場合）

項番 | 分類 | プロパティ名 | 内容 | 指定可否
1 | セットアップ構成関連 | db-use※1 | データベースの使用有無 | ○
2 | rm-use※2 | Cosminexus RMの使用有無 | ○
3 | hcscserver-data-filepath | HCSCサーバのシステム管理情報の出力先 | ○
4 | 標準受付関連 | request-ejb | 標準の同期受付（SessionBean）の使用有無 | ○
5 | request-soap | 標準の同期受付（Webサービス）の使用有無 | ○
6 | request-jms※2 | 標準の非同期受付（MDB（WS-R））の使用有無 | ○
7 | request-jms.maxmessage | 標準の非同期受付（MDB（WS-R））のキューの最大メッセージ数 | ×
8 | request-dbq※2 | 標準の非同期受付（MDB（DBキュー））の使用有無 | ○
9 | request-dbq.maxmessage | 標準の非同期受付（MDB（DBキュー））のキューの最大メッセージ数 | ×
10 | request-jms-rdarea | 標準の非同期受付（MDB（WS-R））のRDエリア名 | ×
11 | request-dbq-rdarea | 標準の非同期受付（MDB（DBキュー））のRDエリア名 | ×
12 | request-dbq-maxlen | 標準の非同期受付（MDB（DBキュー））の最大メッセージ長 | ×
13 | ユーザ定義受付関連 | request-userdef-soap | ユーザ定義受付の使用有無 | ○
14 | J2EE関連 | naming-service-hostname | ネーミングサービスのホスト名 | ○
15 | naming-service-port | ネーミングサービスのポート番号 | ○
16 | Cosminexus RM関連 | rm-systemname | Cosminexus RMのシステム名 | ×
17 | rm-displayname | Cosminexus RMの表示名 | ×
18 | DBコネクタ関連 | dbcon-xadisplayname | XATransaction用またはLocalTransaction用のDB Connectorの表示名 | ○
19 | dbcon-nodisplayname | NoTransaction用DB Connectorの表示名 | ○
20 | データベース関連 | dbtype | 使用するデータベース種別 | ○
21 | jdbc-type | JDBCドライバ種別 | ○
22 | jdbc-url | JDBC用データベースURL | ○
23 | jdbc-dbhostname | データベースのホスト名 | ○
24 | jdbc-dbconnectinfo | データベースの接続情報 | ○
25 | db-character-sets | データベース文字コード種別 | ○
26 | ビジネスプロセスの状態の互換性 | bp-status-compatible | ビジネスプロセスの状態の互換性の使用有無 | ○
27 | データベースのRDエリア（表領域）情報 | cscserverinfo-tbl-area | HCSC基本情報用テーブル領域 | ○
28 | location-tbl-area | ロケーション用テーブル領域 | ○
29 | routing-tbl-area | ルーティング用テーブル領域 | ○
30 | cv-tbl-area | データ変換用テーブル領域 | ○
31 | exehistory-tbl-area | 実行履歴情報テーブル領域 | ○
32 | exehistory-idx-area | 実行履歴情報テーブルのインデクスを格納する領域 | ○
33 | process-tbl-area | ビジネスプロセス基盤用PROCESSテーブルを格納する領域 | ○
34 | process-idx-area | ビジネスプロセス基盤用PROCESSテーブルのインデクスを格納する領域 | ○
35 | activity-tbl-area | ビジネスプロセス基盤用ACTIVITYテーブルを格納する領域 | ○
36 | activity-idx-area | ビジネスプロセス基盤用ACTIVITYテーブルのインデクスを格納する領域 | ○
37 | link-tbl-area | ビジネスプロセス基盤用LINKテーブルを格納する領域 | ○
38 | link-idx-area | ビジネスプロセス基盤用LINKテーブルのインデクスを格納する領域 | ○
39 | correlationset-tbl-area | ビジネスプロセス基盤用CORRELATIONSETテーブルを格納する領域 | ○
40 | correlationset-idx-area | ビジネスプロセス基盤用CORRELATIONSETテーブルのインデクスを格納する領域 | ○
41 | string-variable-tbl-area | ビジネスプロセス基盤用STRING-VARIABLEテーブルを格納する領域 | ○
42 | string-variable-idx-area | ビジネスプロセス基盤用STRING-VARIABLEテーブルのインデクスを格納する領域 | ○
43 | numeric-variable-tbl-area | ビジネスプロセス基盤用NUMERIC-VARIABLEテーブルを格納する領域 | ○
44 | numeric-variable-idx-area | ビジネスプロセス基盤用NUMERIC-VARIABLEテーブルのインデクスを格納する領域 | ○
45 | boolean-variable-tbl-area | ビジネスプロセス基盤用BOOLEAN-VARIABLEテーブルを格納する領域 | ○
46 | boolean-variable-idx-area | ビジネスプロセス基盤用BOOLEAN-VARIABLEテーブルのインデクスを格納する領域 | ○
47 | message-variable-tbl-area | ビジネスプロセス基盤用MESSAGE-VARIABLEテーブルを格納する領域 | ○
48 | message-variable-idx-area | ビジネスプロセス基盤用MESSAGE-VARIABLEテーブルのインデクスを格納する領域 | ○
49 | message-variable-val-area | ビジネスプロセス基盤用MESSAGE-VARIABLEテーブルのVariableValue列を格納する領域 | ○
50 | message-relation-tbl-area | ビジネスプロセス基盤用MESSAGE-RELATIONテーブルを格納する領域 | ○
51 | message-relation-idx-area | ビジネスプロセス基盤用MESSAGE-RELATIONテーブルのインデクスを格納する領域 | ○
52 | clusterinfo-tbl-area | クラスタ情報を格納する領域 | ○
53 | haasyncadp-tbl-area | クラスタ内で配備された非同期アダプタサービスIDを格納する領域 | ○
54 | sql-scriptfilename | SQLスクリプトファイルパス | ○
55 | アクティビティインスタンスの最大数の互換性 | activitynumber-maximum-compatible | 一つのプロセスインスタンスで生成できるアクティビティインスタンスの最大数の互換性の使用有無 | ○

（凡例）

○：指定できます。

×：指定できません。

注※1　「ON」を設定する，またはプロパティを省略します。

注※2　「OFF」を設定します。

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

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

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

なお，HCSCサーバランタイム定義ファイルの作成方法については，「2.3.3(1) HCSCサーバランタイム定義ファイルの作成」を参照してください。

表2-22　HCSCサーバランタイム定義ファイルに定義するプロパティ（データベースを使用してCosminexus RMを使用しない場合）

項番 | 分類 | プロパティ名 | 内容 | 指定可否
1 | 実行履歴管理 | historyrecord | 実行履歴採取の有無 | ○
2 | historyrecord-data | 実行履歴電文データ（ユーザ電文）採取の有無 | ○
3 | historyrecord-binarylength | 実行履歴採取電文データ（ユーザ電文）の長さ | ○
4 | ログトレース | methodtrace-filepath | メソッドトレース出力先パス | ○
5 | requesttrace-filepath | リクエストトレース出力先パス | ○
6 | telegramtrace-filepath | ユーザ電文トレース出力先パス | ○
7 | methodtrace-filenum | メソッドトレースの最大面数 | ○
8 | requesttrace-filenum | リクエストトレースの最大面数 | ○
9 | telegramtrace-filenum | ユーザ電文トレースの最大面数 | ○
10 | methodtrace-filesize | メソッドトレースファイル1面当たりの最大サイズ | ○
11 | requesttrace-filesize | リクエストトレースファイル1面当たりの最大サイズ | ○
12 | telegramtrace-filesize | ユーザ電文トレースファイル1面当たりの最大サイズ | ○
13 | methodtrace-level | メソッドトレースの出力レベル | ○
14 | requesttrace | リクエストトレースの採取の有無 | ○
15 | telegramtrace | ユーザ電文トレースの採取の有無 | ○
16 | bptrace-level | ビジネスプロセス基盤のメソッドトレースの出力レベル | ○
17 | bptrace-filenum | ビジネスプロセス基盤のメソッドトレースの面数 | ○
18 | bptrace-filesize | ビジネスプロセス基盤のメソッドトレースのサイズ | ○
19 | データベース情報 | dab-bufsize | DABrokerからの受信データのバッファ長 | ○
20 | jdbc-bufsize | JDBCで取り扱うバッファ長 | ○
21 | jdbc-longvarbinary | データベースのアクセス方法 | ○
22 | jdbc-longvarbinary-access-size | HiRDBに一度に要求するデータの長さ | ○
23 | jdbc-maxbinarysize | 取得するデータの最大長 | ○
24 | jdbc-longvarbinary-truncerror | エラーの指定 | ○
25 | 標準受付関連 | request-ejb.instance.minimum | 標準の同期受付（SessionBean）のインスタンス最小数 | ○
26 | request-ejb.instance.maximum | 標準の同期受付（SessionBean）のインスタンス最大数 | ○
27 | request-ejb.ctm | CTM連携の使用有無 | ○
28 | request-ejb.parallel.count | CTMがアプリケーションを呼び出すために用意するスレッド数 | ○
29 | request-ejb.optional.name | 標準の同期受付（SessionBean）の別名 | ○
30 | request-soap.instance.minimum | 標準の同期受付（Webサービス・SOAP1.1）の最小同時実行数 | ○
31 | request-soap.instance.maximum | 標準の同期受付（Webサービス・SOAP1.1）の最大同時実行数 | ○
32 | request-soap.exclusive.threads | 標準の同期受付（Webサービス・SOAP1.1）の占有スレッド数 | ○
33 | request-soap.queue-size | 標準の同期受付（Webサービス・SOAP1.1）の実行待ちキューのサイズ | ○
34 | request-soap1_2.instance.minimum | 標準の同期受付（Webサービス・SOAP1.2）の最小同時実行数 | ○
35 | request-soap1_2.instance.maximum | 標準の同期受付（Webサービス・SOAP1.2）の最大同時実行数 | ○
36 | request-soap1_2.exclusive.threads | 標準の同期受付（Webサービス・SOAP1.2）の占有スレッド数 | ○
37 | request-soap1_2.queue-size | 標準の同期受付（Webサービス・SOAP1.2）の実行待ちキューのサイズ | ○
38 | request-jms.instance.maximum | 標準の非同期受付（MDB（WS-R））のインスタンス最大数 | ×
39 | receptionstop-monitor-timer | 標準受付，HCSCサーバ転送用受付けサービス停止処理のタイムアウト時間 | ×
40 | サービスアダプタ関連 | soapfault-targetnamespace-filepath | SOAP Faultをユーザ定義例外として扱うかどうか | ○
41 | データ変換関連 | formatdef-maxcache-num | フォーマット定義をキャッシュできる数 | ○
42 | transformdef-maxcache-num | データ変換定義をキャッシュできる数 | ○
43 | xmltelegram-maxcache-num | XML電文をキャッシュできる数 | ○
44 | telegram-validation | 電文フォーマットに対して，送受信する電文が適切かを検証するかどうか※ | ○
45 | xmltelegram-namespace-complement | XML電文内の属性値に指定された名前空間接頭辞に対応した名前空間宣言を補完するかどうか | ○
46 | telegram-undefined-character-code | バイナリデータの文字コード変換処理で，未定義の文字コードが検出された場合に処理を継続するかどうか | ○
47 | telegram-notfound-soapheader | 受付定義ファイル，サービスアダプタ定義ファイル，またはビジネスプロセス定義ファイルに対して，送受信する電文に指定されたSOAPヘッダが存在しない場合に処理を継続するかどうか | ○
48 | validation-activity | 検証アクティビティで，メッセージ型変数（XML）を検証するかどうか | ○
49 | J2EE関連 | j2ee-stopapp-timeout | J2EEアプリケーション停止時のタイムアウト | ○
50 | startcsc-timeout | J2EEサーバ起動タイムアウト | ○
51 | stopcsc-timeout | J2EEサーバ停止タイムアウト | ○
52 | コマンドの通信のタイムアウト時間の監視 | csc-command-timeout | コマンドタイムアウト | ○
53 | Cookie情報の引き継ぎ | cookie-parsing | Cookie情報を引き継ぐかどうか | ○
54 | フォルダ関連 | work-folder | 作業フォルダルートの絶対パス | ○
55 | common-folder-<共通フォルダ定義名> | 共通フォルダの絶対パス | ○
56 | DBアダプタ関連 | dba-separate-transaction | ビジネスプロセスとは別にDBアダプタのトランザクションを開始するかどうか | ○

（凡例）

○：指定できます。

×：指定できません。

注※

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

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

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

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

なお，ユーザ定義受付ランタイム定義ファイルの作成方法については，「2.3.4(1) ユーザ定義受付ランタイム定義ファイルの作成」を参照してください。

表2-23　ユーザ定義受付ランタイム定義ファイルに定義するプロパティ（データベースを使用してCosminexus RMを使用しない場合）

項番 | 分類 | プロパティ名 | 内容 | 指定可否
1 | ユーザ定義受付 | user-defined-reception-soap.threads.maximum | ユーザ定義受付の最大同時実行数 | ○
2 | user-defined-reception-soap.exclusive.threads | ユーザ定義受付の占有スレッド数 | ○
3 | user-defined-reception-soap.queue-size | ユーザ定義受付の実行待ちキューのサイズ | ○

（凡例）

○：指定できます。

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

(5)　データベースのテーブル容量の見積もり

実行履歴の管理や実行環境の設定をする場合，あらかじめデータベースのテーブル容量を見積もる必要があります。詳細については「2.3.5　データベースのテーブル容量を見積もる」を参照してください。

(6)　データベースの領域への配置

データベースのテーブル容量の見積もり後，各テーブルおよびインデクスをデータベースの領域（HiRDBの場合はRDエリア，Oracleの場合は表領域（テーブルスペース））にどう配置するかを設計する必要があります。詳細については「2.3.7　データベースの領域への配置」を参照してください。

(7)　変換テーブルの登録

開発環境で作成したデータ変換定義に値置換えファンクションが含まれる場合，値置換えファンクションで利用する変換テーブルを，システムプロパティファイル（usrconf.properties）に登録します。詳細については「2.3.8　変換テーブルを登録する」を参照してください。

2.4　運用環境に関する設定

運用環境に関する設定には，次のものがあります。

各種カスタマイズの設定

ユーザ権限の設定

HCSC-Managerコマンド共通項目の設定

注意

1台のマシンに複数の運用環境を構築する場合は，運用環境に関する設定をする前にCSCMNG_HOME環境変数を設定する必要があります。

＜この節の構成＞

2.4.1　カスタマイズする

2.4.2　ユーザ権限を設定する

2.4.3　HCSC-Managerコマンド共通項目を設定する

2.4.1　カスタマイズする

運用環境では，次の内容をカスタマイズできます。

インポート先のリポジトリとなるディレクトリ

HCSC-Managerのログファイルの出力先ディレクトリ

ログファイルの大きさ

ログファイルの面数

HCSC-ManagerとCosminexus Manager間の接続時の読み込みタイムアウト値

プロセスインスタンス再実行で応答電文を受け取った場合に，応答電文を格納するディレクトリ

プロセスインスタンス再実行で応答電文を受け取った場合に，応答電文を格納するときの出力文字コード

カスタマイズに必要な情報は，HCSC-Manager定義ファイルに定義します。

＜この項の構成＞

(1)　HCSC-Manager定義ファイルの作成

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

(1)　HCSC-Manager定義ファイルの作成

HCSC-Manager定義は，J2SE形式のプロパティ形式のHCSC-Manager定義ファイルとして，次に示すディレクトリに格納されています。

<Cosminexusのインストールディレクトリ>¥CSC¥config¥manager¥cscmng.properties

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

HCSC-Manager定義ファイルに定義するプロパティを次に示します。

表2-24　HCSC-Manager定義ファイルに定義するプロパティ

項番 | 分類 | キー名称 | 内容
1 | リポジトリ設定 | cscmng.repository.root | リポジトリのルートディレクトリパス
2 | ログファイルの設定 | cscmng.log.dir | ログ出力先ディレクトリパス
3 | cscmng.log.<チャネル名>.filesize | ログファイルサイズ
4 | cscmng.log.<チャネル名>.filenum | ログファイル面数
5 | Cosminexus 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 | Hitachi Web Server運用設定 | cscmng.server.<HCSCサーバ名>.hws.svstop | Hitachi Web Server停止時の動作
16 | cscmng.server.<HCSCサーバ名>.hws.svstop.timeout | Hitachi Web Server計画停止時のタイムアウト時間

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

2.4.2　ユーザ権限を設定する

HCSC-Managerの各種コマンドは，Management Server経由でHCSCサーバにアクセスします。また，HCSCサーバでは専用のデータベースにアクセスします。

図2-3　ユーザ情報の設定

変更したユーザ情報は画面の場合は次回ログイン時に反映されます。コマンドの場合は，ユーザ管理コマンド正常終了後に実行されたコマンド起動から反映されます。

＜この項の構成＞

(1)　HCSC-Managerにアクセスするユーザの変更

(2)　Cosminexus Managerにアクセスするユーザの設定

(3)　HCSCサーバにアクセスするユーザの設定

(1)　HCSC-Managerにアクセスするユーザの変更

HCSC-Managerにアクセスする管理ユーザのユーザID，およびパスワードを変更できます。HCSC-Managerインストール直後は，次のように仮定されます。HCSC-ManagerにアクセスするユーザID，およびパスワードは必ずcscpasswdコマンドで変更してください。

ユーザID：admin

パスワード：admin

注意

HCSC-ManagerはHCSC-Managerにアクセスする管理ユーザでHCSC-Managerが管理している資源にすべてアクセスできます。そのため，HCSC-ManagerにアクセスするユーザのID，パスワードは適切に管理してください。

次のコマンドを入力します。

cscpasswd [-user <ログインユーザID>]
         [-pass <ログインパスワード>]
          -cscmnguser <変更するユーザID>
          -cscmngpass <変更するパスワード>

各コマンドで必要になるユーザID（-userオプション）とパスワード（-passオプション）はHCSC-Managerコマンド共通定義ファイルに設定すれば，オプションの入力を省略できます。

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

(2)　Cosminexus Managerにアクセスするユーザの設定

HCSC-ManagerがManagement Serverにアクセスするための管理ユーザID，および管理ユーザパスワードを変更できます。変更は，HCSCサーバセットアップ後にします。なお，Management Server自体が管理している管理ユーザID，および管理ユーザパスワードは変更できません。

次のコマンドを入力します。

cscpasswd [-user <ログインユーザID>]
         [-pass <ログインパスワード>]
          -mng <Cosminexus Manager名>
          -mnguser <変更するユーザID>
          -mngpass <変更するパスワード>

各コマンドで必要になるユーザID（-userオプション）とパスワード（-passオプション）はHCSC-Managerコマンド共通定義ファイルに設定すれば，オプションの入力を省略できます。

cscpasswdコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「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コマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscpasswd（ユーザの管理）」を参照してください。

2.4.3　HCSC-Managerコマンド共通項目を設定する

運用環境で使用する各コマンドの必須項目の省略値を，HCSC-Managerコマンドの共通定義に定義しておくと，コマンド入力時にそのオプションの入力を省略できます。

HCSC-Managerのコマンド共通の省略値として必要な情報は，HCSC-Managerコマンド共通定義ファイルに定義します。

＜この項の構成＞

(1)　HCSC-Managerコマンド共通定義ファイルの作成

(2)　設定できる内容

(1)　HCSC-Managerコマンド共通定義ファイルの作成

HCSC-Managerコマンド共通定義は，J2SEのプロパティファイル形式のHCSC-Managerコマンド共通定義ファイルとして，次に示すディレクトリに格納されています。

<Cosminexusのインストールディレクトリ>¥CSC¥config¥manager¥csccmd.properties

HCSC-Managerコマンド共通定義ファイルに省略値を設定，変更したあとに入力したコマンドから，設定した省略値が反映されます。HCSC-Managerコマンド共通定義ファイルと，コマンドのオプションとの両方に定義した場合は，コマンドのオプションが有効になります。

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

(2)　設定できる内容

HCSC-Managerコマンド共通項目に設定できる値を次に示します。

コマンドのすべてに共通する引数のデフォルト値
パラメタ：csc.all.<コマンド引数名>=値

コマンド識別子に対応したコマンドのデフォルト引数
パラメタ：csc.<コマンド識別子>.<コマンド引数名>=値

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

2.5　HCSCサーバをロードバランスクラスタ構成にする場合の環境構築

複数台のHCSCサーバを並列に並べることで，サービスリクエスタからのサービス部品の実行要求の一点集中によるJ2EEサーバの負荷を軽減することができます。これをロードバランスクラスタ機能といいます。

ロードバランスクラスタ機能を利用して負荷を分散する場合，汎用ロードバランサまたはCTMを使用します。ここでは，汎用ロードバランサとCTMを合わせて，ロードバランサと表記します。

標準の同期受付（Webサービス／SessionBean）へのサービス部品の実行要求の場合だけ，ロードバランサで負荷分散をすることができます。なお，標準の同期受付（Webサービス）と標準の同期受付（SessionBean）のどちらにサービス部品の実行要求を送信するかによって，使用するロードバランサは異なります。サービス部品の実行要求を送信する標準受付と使用するロードバランサを次の表に示します。

表2-25　サービス部品の実行要求を送信する標準受付と使用するロードバランサ

標準受付 | ロードバランサ
標準の同期受付（Webサービス） | 汎用ロードバランサ（HTTPの負荷分散ができる負荷分散機）
標準の同期受付（SessionBean） | CTM

HCSCサーバをロードバランスクラスタ構成にする場合の環境構築およびセットアップの方法について，次に説明します。

＜この節の構成＞

2.5.1　ロードバランスクラスタ構成時の環境構築

2.5.2　ロードバランスクラスタ構成時の実行環境のセットアップ

2.5.1　ロードバランスクラスタ構成時の環境構築

HCSCサーバをロードバランスクラスタ構成にする場合，実行環境，運用環境，DBサーバがそれぞれ別のマシン上にある構成となります。

汎用ロードバランサを使用したシステム構成を図2-4に，CTMを使用したシステム構成を図2-5に示します。

図2-4　汎用ロードバランサを使用したシステム構成

図2-5　CTMを使用したシステム構成

なお，バージョン08-70以降で新規にセットアップした場合は，HCSC-Managerの環境をそれぞれの実行環境に格納できます。これによって，運用環境のサーバ台数を省略できます。

実行環境，運用環境，DBサーバの構築方法を次に示します。

＜この項の構成＞

(1)　実行環境の構築

(2)　運用環境の構築

(3)　DBサーバの構築

(1)　実行環境の構築

実行環境を構築するには，次の作業を実施します。

(a)　uCosminexus Service Platformのインストール

uCosminexus Service Platformのインストール方法については，「2.1.2　uCosminexus 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サーバ構成定義ファイルに設定する内容の詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「HCSCサーバ構成定義ファイル」を参照してください。

クラスタ表示名
ロードバランスクラスタ内のすべてのHCSCサーバで同じ値を設定します。

クラスタ種別
「LB」を設定します。

Cosminexus manager名
HCSC-ManagerでCosminexus Manager単位に一意になる識別名を設定します。

Cosminexus managerのIPアドレス
物理IPアドレスを設定します。

HCSCサーバが使用するJ2EEサーバ名
ロードバランスクラスタ内のすべてのHCSCサーバで同じ値を設定します。

WebサーバのIPアドレス（同期サービス（Webサービス）呼び出しをする場合）
ロードバランスクラスタ内のすべてのHCSCサーバに，ロードバランサのIPアドレス値を設定します。

WebサーバのIPアドレス（非同期サービス（MDB（WS-R））呼び出しをする場合）
それぞれのHCSCサーバのIPアドレスを設定します。ロードバランスクラスタ構成の場合，jms-physical-receptionに設定してください。

NameServerのIPアドレス
ロードバランスクラスタ内のすべてのHCSCサーバで，グローバルCORBAネーミングServiceのIPアドレスを設定します。ただし，CTMを利用していない場合は，localhostを指定してください。

HCSCサーバ名
DB/RMを使用する環境を構築する場合，ロードバランスクラスタ内で一意になる識別名を設定します。DB/RMを使用しない環境を構築する場合は，HCSC-Manager内で一意になる識別名を設定してください。

HCSCサーバセットアップ定義ファイルの設定時の注意事項

HCSCサーバセットアップ定義ファイルを設定する場合には，次に示す内容に留意してください。

HCSCサーバセットアップ定義ファイルの設定方法については，「2.3.2　HCSCサーバセットアップ定義ファイルを設定する」を参照してください。

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

同じ値を設定するプロパティ

HCSCサーバセットアップ定義ファイルに設定するプロパティのうち，次の表に示すプロパティはロードバランスクラスタ内のすべてのHCSCサーバで同じ値を設定する必要があります。

表2-26　ロードバランスクラスタ内のHCSCサーバで同じ値を設定するプロパティ

同じ値を指定するプロパティ | プロパティに設定する値
db-use | データベースの使用有無
rm-use | Cosminexus RMの使用有無
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 | Cosminexus RMの表示名
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 | データベース文字コード種別
request-userdef-soap | ユーザ定義受付の使用有無

注※1　DBコネクタの設定もロードバランスクラスタ内のすべてのHCSCサーバで同じにします。

注※2　指定するホスト名には，データベースを格納しているマシンを指定します。

HCSCサーバランタイム定義ファイルの設定時の注意事項

HCSCサーバランタイム定義ファイルを設定する場合，ロードバランスクラスタ内のすべてのHCSCサーバですべてのプロパティを同じ値に設定する必要があります。

また，CTMを使用する場合，次のプロパティを追加してください。

request-ejb.ctm=true

HCSCサーバランタイム定義ファイルの設定方法については，「2.3.3　HCSCサーバランタイム定義ファイルを設定する」を参照してください。

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

(2)　運用環境の構築

運用環境は，クラスタを構成するHCSCサーバから独立して構築します。そのため，運用環境として利用するマシンには，uCosminexus OperatorおよびuCosminexus Operator for Service Platformをインストールして環境を構築します。

なお，バージョン08-70以降で新規にセットアップすれば，一つのマシンに運用環境と実行環境を配置できます。その結果，運用環境用のマシンが不要になります。

運用環境を構築するには，次の作業を実施します。

uCosminexus OperatorおよびuCosminexus Operator for Service Platformのインストール

uCosminexus OperatorおよびuCosminexus Operator for Service Platformのインストール方法については，「2.1.3　uCosminexus OperatorおよびuCosminexus Operator for Service Platformのインストール」を参照してください。

環境設定

運用環境の環境設定としてリポジトリの設定と環境変数の設定を実施します。

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

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

uCosminexus OperatorおよびuCosminexus Operator for Service Platformをインストールしたマシン上で，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.3.1　ロードバランスクラスタ構成での運用」を参照してください。

＜この項の構成＞

(1)　セットアップの準備

(2)　実行環境のセットアップ

(3)　ロードバランサの設定

(4)　標準受付の開始

(5)　ロードバランサの接続

(1)　セットアップの準備

セットアップ前に，次の作業を行います。次の作業は，ロードバランスクラスタを構成するすべてのHCSCサーバで行います。

実行環境に必要なソフトウェアの設定

J2EEサーバのセットアップなどを行います。設定する内容と設定方法については，「3.1.2　実行環境に必要なソフトウェアの設定」を参照してください。

なお，セットアップ時には，J2EEサーバ名をロードバランスクラスタ内のすべてのHCSCサーバで同じ名称に設定する必要があります。

また，Cosminexus RMのシステム名は，ロードバランスクラスタ内のそれぞれのHCSCサーバでユニークな名称に設定する必要があります。

CTMを使用する場合の設定

CTMを使用する場合，HCSCサーバランタイム定義ファイルでrequest-ejb.ctmにtrueを設定してください。

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

サービスリクエスタへの送信制御

サービスリクエスタ用のネットワークを切断するなどして，HCSCサーバでサービス部品の実行要求を受け付けられない状態にします。

(2)　実行環境のセットアップ

実行環境のセットアップ手順を次に示します。

次の順序でプロセスを起動します。

運用管理エージェント

Management Server

PRF

スマートエージェント

CTMドメインマネジャ（CTMを使用する場合）

CORBAネーミングサービス（CORBAネーミングサービスを使用する場合）

CTMデーモン（CTMを使用する場合）

J2EEサーバ

Hitachi Web Server（Hitachi Web Serverを使用する場合）

運用管理エージェント，Management Server，PRF，スマートエージェント，CTMドメインマネジャ，CORBAネーミングサービス，CTMデーモン，およびJ2EEサーバの起動方法については，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」を，Hitachi Web Serverの起動方法については，マニュアル「Hitachi Web Server」をそれぞれ参照してください。

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

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

サービスアダプタとビジネスプロセスを配備します。
サービスアダプタとビジネスプロセスの配備方法については，「3.1.8　サービスアダプタを配備する」および「3.1.13　ビジネスプロセスを配備する」を参照してください。

サービスアダプタとビジネスプロセスを開始します。
サービスアダプタとビジネスプロセスの開始方法については，「5.2.6　サービスアダプタを開始する」および「5.2.7　ビジネスプロセスを開始する」を参照してください。

(3)　ロードバランサの設定

ロードバランスクラスタを構成しているすべてのHCSCサーバへサービス部品の実行要求を送信するように設定します。

CTMを使用する場合，すべてのHCSCサーバでCTMドメインマネジャ名およびスマートエージェントのポート番号を同じ値に設定する必要があります。

汎用ロードバランサの設定方法については，使用する汎用ロードバランサのドキュメントを参照してください。

(4)　標準受付の開始

すべてのHCSCサーバの標準受付を開始します。標準受付の開始方法については，「5.2.9　標準受付を開始する」を参照してください。

(5)　ロードバランサの接続

ロードバランサを接続し，使用できる状態にします。

CTMを使用する場合，この手順は不要です。

汎用ロードバランサの接続開始方法については，使用する汎用ロードバランサのドキュメントを参照してください。

2.6　HCSCサーバをHAクラスタ構成にする場合の環境構築

HAクラスタ構成では，二つのHCSCサーバを組み合わせてクラスタを構成できます。HAクラスタを構成する場合，クラスタソフトウェアを利用します。Cosminexus サービスプラットフォームでは，次に示すクラスタソフトウェアを利用できます。

Windowsの場合
Microsoft Cluster Service

UNIXの場合
HAモニタ

HCSCサーバをHAクラスタ構成にする場合の環境構築およびセットアップの方法について，次に説明します。

＜この節の構成＞

2.6.1　HAクラスタ構成時の環境構築

2.6.2　HAクラスタ構成時の実行環境のセットアップ

2.6.1　HAクラスタ構成時の環境構築

HCSCサーバをHAクラスタ構成にする場合，実行環境（実行系・待機系），運用環境，DBサーバがそれぞれ別のマシン上にある構成となります。

HCSCサーバをHAクラスタ構成にした場合のシステムの構成を次の図に示します。

図2-7　HCSCサーバをHAクラスタ構成にした場合のシステムの構成

バージョン08-70以降で新規にセットアップした場合は，HCSC-Managerの環境をそれぞれの実行環境に格納できます。これによって，運用環境のサーバ台数を省略できます。

実行環境（実行系・待機系），運用環境，DBサーバの構築方法を次に示します。

＜この項の構成＞

(1)　実行環境（実行系・待機系）の構築

(2)　運用環境の構築

(3)　DBサーバの構築

(1)　実行環境（実行系・待機系）の構築

実行環境を構築するには，実行系および待機系で次の作業を実施します。

(a)　uCosminexus Service Platformのインストール

uCosminexus Service Platformのインストール方法については，「2.1.2　uCosminexus 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サーバ構成定義ファイルに設定する値のうち，次に示す値は実行系と待機系で異なる値を設定する必要があります。

Cosminexus manager名

Cosminexus managerのIPアドレス
Cosminexus managerのIPアドレスには，実行系・待機系それぞれの物理IPアドレスを指定します。

上記以外の要素には，実行系と待機系で同じ値を設定します。

HCSCサーバ構成定義ファイルの設定方法については，「2.3.1　HCSCサーバ構成定義ファイルを設定する」を参照してください。

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

HCSCサーバセットアップ定義ファイルの設定時の注意事項

HCSCサーバセットアップ定義ファイルを設定する場合には，次に示す内容に留意してください。

HCSCサーバセットアップ定義ファイルの設定方法については，「2.3.2　HCSCサーバセットアップ定義ファイルを設定する」を参照してください。

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

同じ値を設定するプロパティ

HCSCサーバセットアップ定義ファイルに設定するプロパティのうち，次の表に示すプロパティは実行系と待機系で同じ値を設定する必要があります。

表2-27　実行系と待機系で同じ値を設定するプロパティ

同じ値を指定するプロパティ | プロパティに設定する値
db-use | データベースの使用有無
rm-use | Cosminexus RMの使用有無
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-systemname※1 | Cosminexus RMのシステム名
rm-displayname | Cosminexus RMの表示名
dbcon-xadisplayname※2 | XATransactionまたはLocalTransaction用DB Connectorの表示名
dbcon-nodisplayname※2 | NoTransaction用DB Connectorの表示名
dbtype | 使用するデータベース種別
jdbc-type | JDBCドライバ種別
jdbc-url※3 | JDBC用データベースURL
jdbc-dbhostname | データベースのホスト名
jdbc-dbconnectinfo | データベースの接続情報
db-character-sets | データベース文字コード種別
request-userdef-soap | ユーザ定義受付の使用有無

注※1　実行系と待機系で同じCosminexus RMシステム名を指定します。

注※2　DBコネクタの設定も実行系と待機系で同じにします。

注※3　指定するホスト名には，データベースを格納しているマシンを指定します。

HCSCサーバランタイム定義ファイルの設定時の注意事項

HCSCサーバランタイム定義ファイルを設定する場合，すべてのプロパティで実行系と待機系で同じ値を設定する必要があります。

HCSCサーバランタイム定義ファイルの設定方法については，「2.3.3　HCSCサーバランタイム定義ファイルを設定する」を参照してください。

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

(e)　クラスタソフトウェアのインストール

クラスタソフトウェアをインストールします。インストール方法は，利用するクラスタソフトウェアのドキュメントを参照してください。

(2)　運用環境の構築

運用環境は，クラスタを構成するHCSCサーバから独立して構築します。そのため，運用環境として利用するマシンには，uCosminexus OperatorおよびuCosminexus Operator for Service Platformをインストールして環境を構築します。

なお，バージョン08-70以降で新規にセットアップすれば，一つのマシンに運用環境と実行環境を配置できます。その結果，運用環境用のマシンが不要になります。

運用環境を構築するには，次の作業を実施します。

uCosminexus OperatorおよびuCosminexus Operator for Service Platformのインストール

uCosminexus OperatorおよびuCosminexus Operator for Service Platformのインストール方法については，「2.1.3　uCosminexus OperatorおよびuCosminexus Operator for Service Platformのインストール」を参照してください。

環境設定

運用環境の環境設定としてリポジトリの設定と環境変数の設定を実施します。

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

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

uCosminexus OperatorおよびuCosminexus Operator for Service Platformをインストールしたマシン上で，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.3.2　HAクラスタ構成での運用」を参照してください。

＜この項の構成＞

(1)　セットアップの準備

(2)　実行環境（待機系）のセットアップ

(3)　実行環境（実行系）のセットアップ

(4)　クラスタソフトウェアの設定

(1)　セットアップの準備

セットアップ前に，次の作業を行います。次の作業は，実行系および待機系でそれぞれ行います。

実行環境に必要なソフトウェアの設定

J2EEサーバのセットアップなどを行います。設定する内容と設定方法については，「3.1.2　実行環境に必要なソフトウェアの設定」を参照してください。

なお，セットアップ時には，次の名称を実行系と待機系で同じ名称に設定する必要があります。

J2EEサーバ名

Cosminexus RMのシステム名

サービスリクエスタへの送信制御

サービスリクエスタ用のネットワークを切断するなどして，実行系および待機系でサービス部品の実行要求を受け付けられない状態にします。

(2)　実行環境（待機系）のセットアップ

実行環境（待機系）のセットアップ手順を次に示します。

次の順序でプロセスを起動します。

運用管理エージェント

Management Server

PRF

J2EEサーバ

Hitachi Web Server

運用管理エージェント，Management Server，PRF，J2EEサーバの起動方法については，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」を，Hitachi Web Serverの起動方法については，マニュアル「Hitachi Web Server」をそれぞれ参照してください。

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

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

サービスアダプタとビジネスプロセスを配備します。
サービスアダプタとビジネスプロセスの配備方法については，「3.1.8　サービスアダプタを配備する」および「3.1.13　ビジネスプロセスを配備する」を参照してください。

サービスアダプタとビジネスプロセスを開始します。
サービスアダプタとビジネスプロセスの開始方法については，「5.2.6　サービスアダプタを開始する」および「5.2.7　ビジネスプロセスを開始する」を参照してください。

HCSCサーバを停止します。
サービスアダプタおよびビジネスプロセスを起動したままHCSCサーバを停止します。
HCSCサーバの停止方法については，「5.2.31　HCSCサーバを停止する」を参照してください。

Management Serverおよび運用管理エージェントを停止します。
運用管理エージェントの停止方法については，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「7.7.1　運用管理エージェントの起動／停止と設定」を参照してください。Management Serverの停止方法については，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「7.7.2　Management Serverの起動／停止と設定」を参照してください。

(3)　実行環境（実行系）のセットアップ

実行環境（実行系）のセットアップ手順を次に示します。

次の順序でプロセスを起動します。

運用管理エージェント

Management Server

PRF

J2EEサーバ

Hitachi Web Server

運用管理エージェント，Management Server，PRF，J2EEサーバの起動方法については，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」を，Hitachi Web Serverの起動方法については，マニュアル「Hitachi Web Server」をそれぞれ参照してください。

HCSCサーバをセットアップします。
HCSCサーバのセットアップ方法については，「3.1.3　HCSCサーバをセットアップする」を参照してください。
なお，実行系のHCSCサーバをセットアップするときには，cscsvsetupコマンドの-clusterオプションに指定するクラスタ名を，待機系と同じ値にする必要があります。
cscsvsetupコマンドについては，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscsvsetup（HCSCサーバのセットアップ）」を参照してください。

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

サービスアダプタとビジネスプロセスを配備します。
待機系に配備したサービスアダプタおよびビジネスプロセスと同じものを配備します。実行系と待機系の間では，配備されているサービスアダプタおよびビジネスプロセスに過不足がないようにします。
サービスアダプタとビジネスプロセスの配備方法については，「3.1.8　サービスアダプタを配備する」および「3.1.13　ビジネスプロセスを配備する」を参照してください。

サービスアダプタとビジネスプロセスを開始します。
待機系で開始したサービスアダプタおよびビジネスプロセスと同じものを開始します。実行系と待機系の間では，サービスアダプタおよびビジネスプロセスの状態に差異がないようにします。
サービスアダプタとビジネスプロセスの開始方法については，「5.2.6　サービスアダプタを開始する」および「5.2.7　ビジネスプロセスを開始する」を参照してください。

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

(4)　クラスタソフトウェアの設定

クラスタソフトウェアでは，実行系に障害が発生したときに待機系に切り替えるための設定を行います。

待機系に切り替えるときに次の操作を行うスクリプトを実行するように設定します。次に示す順に実行されるように設定してください。

なお，OSやHCSC-Managerのユーザなどは，実行系と合わせる必要があります。

待機系のプロセスの起動
次の順序でプロセスを起動するように設定します。

運用管理エージェント

Management Server

PRF

Hitachi Web Server

待機系のHCSCサーバの起動※

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

注※

クラスタソフトウェアで待機系のHCSCサーバをcscutilコマンドで起動する場合，次のようにオプションを設定します。

-hostオプション

Management Serverを起動するホスト名（またはIPアドレス）とポート番号をコロン（:）で連結して指定します。ホスト名には「localhost」を指定します。ポート番号が「28099」の場合の指定例を次に示します。

-host localhost:28099

-mnguserオプション

Management Serverの管理ユーザのユーザIDを指定します。

-mngpassオプション

Management Serverの管理ユーザのパスワードを指定します。

2.7　JP1連携機能を使用する場合の環境構築

JP1と連携することで，Cosminexus サービスプラットフォームで発生した障害を監視できます。障害を監視することでトラブルの発生を検知して，原因を究明し，対策することができます。

Cosminexus サービスプラットフォームでは，発生した障害のメッセージをJP1イベントとしてJP1に通知します。JP1イベントの詳細情報は，JP1の統合コンソールから確認します。確認方法については，「7.8.1　JP1連携機能を使用した障害の監視」を参照してください。

JP1と連携した障害監視の流れを次の図に示します。

図2-9　JP1と連携した障害監視の流れ

JP1イベント発行の設定をします。
Smart Composerでどのようなエラーや障害情報をJP1イベントとして発行するかを設定します。設定方法については，「2.7.2　Cosminexus サービスプラットフォームのJP1イベント発行の設定」を参照してください。

Cosminexus サービスプラットフォームで障害が発生した場合，障害に関するメッセージがJP1イベントとしてJP1/Baseに発行されます。

JP1イベントはJP1統合運用管理サーバに通知されます。

JP1統合運用管理サーバに通知されたJP1イベントは，JP1/IM - Managerが収集します。
JP1/IMの自動アクション機能を使って運用管理者への通知を設定している場合は，障害が発生したことが運用管理者に通知されます。

統合コンソールからJP1イベントの詳細情報を確認します。
確認方法については，「7.8.1　JP1連携機能を使用した障害の監視」を参照してください。

注意

実行環境に配備されているHCSCサーバが1台の場合，実行環境，運用環境，JP1統合運用管理サーバ，および運用管理クライアントを1台のホストに構築できます。また，1台のホストに複数のHCSCサーバが配備されている場合も，実行環境，運用環境，JP1統合運用管理サーバ，および運用管理クライアントを1台のホストに構築できます。ただし，複数のHCSCサーバが異なるホストに配備されている場合は，図2-9のように，それぞれ別のホストに構築してください。

＜この節の構成＞

2.7.1　JP1連携の設定の流れ

2.7.2　Cosminexus サービスプラットフォームのJP1イベント発行の設定

2.7.3　JP1/Baseのイベントサーバ名の設定

2.7.4　JP1/Baseの構成定義の作成

2.7.5　メッセージマッピングファイルの編集

2.7.1　JP1連携の設定の流れ

JP1連携機能を使用するためには，次の表に示すJP1の製品をインストールおよびセットアップする必要があります。

表2-28　JP1連携機能を使用するために必要なJP1の製品

インストール先
JP1の製品

実行環境
JP1/Base

JP1統合運用管理サーバ

JP1/Base

JP1/IM - Manager

運用管理クライアント
JP1/IM - View※

注※

Windowsの場合だけインストールできます。Windows以外の場合，統合コンソールは表示できません。

JP1の製品のインストールおよびセットアップについては，次に示すマニュアルを参照してください。

JP1/Integrated Management - Manager　Version 9を使用する場合
マニュアル「JP1/Integrated Management - Manager 構築ガイド」，またはマニュアル「JP1/Integrated Management - Manager 運用ガイド」

JP1/Integrated Management - Manager　Version 8を使用する場合
マニュアル「JP1/Integrated Management - Manager システム構築・運用ガイド」

JP1と連携するための設定の流れを次に示します。

実行環境で，次の設定をします。

Cosminexus サービスプラットフォームのJP1イベント発行の設定（2.7.2参照）
Cosminexus サービスプラットフォームで発生した障害のメッセージを，JP1イベントとして発行するための設定を行います。

JP1/Baseのイベントサーバ名の設定（2.7.3参照）
HAクラスタ構成の場合で，論理ホストのJP1/Baseのイベントサーバを使用してJP1イベントを発行するときだけ設定を行います。

JP1統合運用管理サーバで，次の作業をします。

JP1/Baseの構成定義の作成（2.7.4参照）
JP1統合運用管理サーバが管理するシステムの階層関係を定義します。
この定義を各ホストに配布すると，転送先の情報として識別されます。

2.7.2　Cosminexus サービスプラットフォームのJP1イベント発行の設定

Cosminexus サービスプラットフォームで発生した障害のメッセージをJP1イベントとして発行するためには，次の二つの設定をします。

Cosminexus Management Server用JP1イベントの設定

J2EEサーバ用JP1イベントの設定

それぞれの設定方法について説明します。

＜この項の構成＞

(1)　Cosminexus Management Server用JP1イベントの設定

(2)　J2EEサーバ用JP1イベントの設定

(1)　Cosminexus Management Server用JP1イベントの設定

Management Server環境設定ファイル（mserver.properties）に次のように設定します。この設定をすると，Cosminexus Management Serverから，障害に関するメッセージがJP1イベントとして，JP1/Baseに発行されます。

Management Server環境設定ファイルについては，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「10.7　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に発行されます。

簡易構築定義ファイルについては，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.6　簡易構築定義ファイル」を参照してください。

<configuration>
 <logical-server-type>j2ee-server</logical-server-type>
 <param>
   <param-name>ejbserver.manager.jp1event.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.7.3　JP1/Baseのイベントサーバ名の設定

HAクラスタ構成の場合で，論理ホストのJP1/Baseのイベントサーバを使用してJP1イベントを発行するとき，次の二つの設定をします。

実行環境用イベントサーバ名の設定

J2EEサーバ用イベントサーバ名の設定

それぞれの設定方法について説明します。

＜この項の構成＞

(1)　Cosminexus Management Server用イベントサーバ名の設定

(2)　J2EEサーバ用イベントサーバ名の設定

(1)　Cosminexus Management Server用イベントサーバ名の設定

Management Server環境設定ファイル（mserver.properties）にJP1統合運用管理サーバの論理ホスト名または論理IPアドレスを設定します。

Management Server環境設定ファイルについては，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「10.7　mserver.properties（Management Server環境設定ファイル）」を参照してください。

mngsvr.jp1event.event_server_name=<論理ホスト名または論理IPアドレス>

設定した情報を有効にするために，Management Serverを再起動してください。

(2)　J2EEサーバ用イベントサーバ名の設定

簡易構築定義ファイルのJ2EEサーバのコンフィグレーションにJP1統合運用管理サーバの論理ホスト名または論理IPアドレスを指定します。

簡易構築定義ファイルについては，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.6　簡易構築定義ファイル」を参照してください。

<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.7.4　JP1/Baseの構成定義の作成

JP1/IMが管理するシステムの構成を，JP1/Baseの構成定義ファイルに定義します。

JP1/Baseの配布機能を利用して，作成した定義を各ホストのJP1/Baseに配布すると，定義情報を一括して管理できます。

なお，1台のホストで実行環境，運用環境，JP1統合運用管理サーバ，および運用管理クライアントを構成した場合，JP1/Baseの構成定義の作成は不要です。

JP1/Baseの構成定義の作成手順を次に示します。なお，詳細については，次に示すマニュアルのシステムの構成定義情報の設定に関する説明を参照してください。

JP1/Integrated Management - Manager　Version 9を使用する場合
マニュアル「JP1/Integrated Management - Manager 構築ガイド」，またはマニュアル「JP1/Integrated Management - Manager 運用ガイド」

JP1/Integrated Management - Manager　Version 8を使用する場合
マニュアル「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.7.5　メッセージマッピングファイルの編集

メッセージマッピングファイルのファイル（JP1/IM連携用システムログメッセージマッピングファイル）は，J2EEサーバが検知した障害や通知を，メッセージごとにどの重大度のJP1イベントに変換するか定義したファイルです。メッセージマッピングファイルを編集して，JP1イベントとして発行するメッセージを制御するなど，JP1イベントをカスタマイズできます。なお，マッピング定義がなくJP1イベントの重大度を割り当てられないメッセージは，JP1イベントとして発行されません。

メッセージマッピングファイルのファイル名は「manager.jp1event.system.mapping.properties」です。マッピング関係を定めた標準的なメッセージマッピングファイルを提供しているので，必要に応じて，テキストエディタなどで編集してください。メッセージマッピングファイルの格納場所を次に示します。

Windowsの場合

<Cosminexusのインストールディレクトリ>¥manager¥config

UNIXの場合

/opt/Cosminexus/manager/config

JP1/IM連携用システムログメッセージマッピングファイルについては，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「10.19　JP1/IM連携用システムログメッセージマッピングファイル」を参照してください。

2.8　1台のマシンに複数の運用・実行環境を構築する場合の環境構築

HCSC-Managerの環境は基本的に1台のマシンに一つですが，CSCMNG_HOME環境変数を設定することで，1台のマシンに二つ以上の環境を構築できます。

1台のマシンに複数の環境を構築した場合のシステム構成例，および構築の流れについて，次に説明します。

＜この節の構成＞

2.8.1　1台のマシンに複数の環境を構築する場合のシステム構成例

2.8.2　1台のマシンに複数の環境を構築する流れ

2.8.1　1台のマシンに複数の環境を構築する場合のシステム構成例

ここでは，開発環境を複数に分割する例と，クラスタ単位にHCSC-Managerの環境を分割する例を示します。

＜この項の構成＞

(1)　開発環境を複数に分割する

(2)　クラスタ単位にHCSC-Managerの環境を分割する

(1)　開発環境を複数に分割する

使用するテスト環境ごとにCSCMNG_HOME環境変数を割り当てることで，1台のマシンに複数のテスト環境を構築することができます。ただし，環境ごとにCSCMNG_HOME環境変数を割り当てると，HCSC簡易セットアップ機能（csceasysetupコマンド）を使用できないため，HCSCサーバのセットアップから一つ一つ環境を構築していく必要があります。また，CSCMNG_HOME環境変数を割り当てると，HCSC本番環境簡易セットアップ機能（cscsetupコマンド）も使用できません。なお，HCSC本番環境簡易セットアップ機能を使用してセットアップしている場合は，アンセットアップしてからCSCMNG_HOME環境変数を割り当てて，そのあとに，本番環境簡易セットアップ機能を使用しない方法でセットアップしてください。

開発用のマシンで複数の運用・実行環境を構築する例を次の図に示します。

図2-10　開発用のマシンで複数の運用・実行環境を構築する例

(2)　クラスタ単位にHCSC-Managerの環境を分割する

大規模構成で複数クラスタを扱う場合，リポジトリを分割することで，リポジトリが破壊されても，ほかのクラスタは影響を受けることなく運用できるなど，障害発生時の局所化ができます。

複数クラスタで運用する必要があり，かつ実行環境と運用環境を異なるマシンに構築する場合は，クラスタ単位に運用環境を分割することを推奨します。

クラスタ単位に運用環境を分割する例を次の図に示します。

図2-11　クラスタ単位に運用環境を分割する例

2.8.2　1台のマシンに複数の環境を構築する流れ

1台のマシンに複数のHCSC-Manager環境を構築する場合の流れを次の図に示します。

図2-12　1台のマシンに複数のHCSC-Manager環境を構築する場合の流れ

＜この項の構成＞

(1)　CSCMNG_HOME環境変数の設定

(2)　運用環境の設定

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

(4)　GUIの起動

(1)　CSCMNG_HOME環境変数の設定

1台のマシンに複数のHCSC-Manager環境を構築する場合，構築する環境の数だけCSCMNG_HOME環境変数を設定する必要があります。

CSCMNG_HOME環境変数に任意フォルダの絶対パスを設定してください。パスを設定することで，HCSC-ManagerがCSCMNG_HOME環境変数以下の定義ファイルを参照します。

HCSC-Managerが参照するCSCMNG_HOME環境変数以下の定義ファイルを次の表に示します。

表2-29　HCSC-Managerが参照するCSCMNG_HOME環境変数以下の定義ファイル

ディレクトリ名 | 説明
%CSCMNG_HOME%¥config | 運用環境で使用するコンフィグファイル格納ディレクトリ
%CSCMNG_HOME%¥log | 運用環境で使用するデフォルトログディレクトリ
%CSCMNG_HOME%¥repository | 運用環境で使用するデフォルトリポジトリディレクトリ
%CSCMNG_HOME%¥spool | 運用環境で使用する一時ディレクトリ

ポイント

任意フォルダの絶対パスは，「c:¥cscmng」など用途がわかりやすい設定にすることを推奨します。

注意

同一の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ディレクトリ下にコピーしてから使用してください。

<Cosminexusのインストールディレクトリ>¥CSC¥config¥manager¥templates¥cscmng.properties

HCSC-Manager定義ファイルは，<Cosminexusのインストールディレクトリ>¥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ディレクトリ下にコピーしてから使用してください。

<Cosminexusのインストールディレクトリ>¥CSC¥config¥manager¥templates¥csccmd.properties

HCSC-Managerコマンドの共通定義ファイルは，<Cosminexusのインストールディレクトリ>¥CSC¥config ¥manager¥csccmd.propertiesではなく，%CSCMNG_HOME%¥config¥manager¥csccmd.propertiesになります。

HCSC-Managerコマンド共通定義ファイルが有効にならない場合は，%CSCMNG_HOME%¥config¥manager¥csccmd.propertiesが存在しているか確認してください。ファイルが存在する場合は，正しく編集されていることを確認してください。

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

HCSCサーバのセットアップについては，「3.1　システムのセットアップ」を参照してください。

(4)　GUIの起動

HCSCサーバをセットアップしたあと，EclipseのGUIを使用して運用する場合は，CSCMNG_HOME環境変数が有効になっている状態で，Eclipseを起動してください。例えば，コマンドプロンプトにCSCMNG_HOME環境変数を有効にしている場合は，コマンドプロンプトからeclipse.exeを起動してください。

3.　システムのセットアップとアンセットアップ

この章では，システムのセットアップ，アンセットアップ，およびHCSCサーバの定義について説明します。また，テスト環境から本番環境へ移行する場合の手順について説明します。

＜この章の構成＞

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

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

3.3　テスト環境から本番環境への移行手順

3.4　本番環境の簡易セットアップ

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

Cosminexus サービスプラットフォームを利用して，システムをセットアップする方法について説明します。

＜この節の構成＞

3.1.1　システムのセットアップの流れ

3.1.2　実行環境に必要なソフトウェアの設定

3.1.3　HCSCサーバをセットアップする

3.1.4　HCSCサーバの定義情報を設定する

3.1.5　HCSCサーバの定義内容を確認する

3.1.6　サービス情報を変更する

3.1.7　サービス情報を確認する

3.1.8　サービスアダプタを配備する

3.1.9　カスタムアダプタの定義ファイルを運用環境に取得する

3.1.10　カスタムアダプタの定義ファイルを運用環境に設定，更新する

3.1.11　カスタムアダプタの定義ファイルを運用環境から削除する

3.1.12　運用環境の定義ファイルの状態を確認する

3.1.13　ビジネスプロセスを配備する

3.1.14　ユーザ定義受付を配備する

3.1.15　ユーザ定義受付の定義情報を設定する

3.1.16　ユーザ定義受付の定義情報を確認する

3.1.17　セットアップ後の内容を確認・変更する

3.1.18　データベースとCosminexus RMの両方を使用しない場合のシステムのセットアップ

3.1.19　データベースを使用してCosminexus RMを使用しない場合のシステムのセットアップ

3.1.1　システムのセットアップの流れ

システムのセットアップの流れについて，次の図に示します。なお，本番環境の簡易セットアップ機能を利用してシステムをセットアップする場合は，「3.4　本番環境の簡易セットアップ」を参照してください。

図3-1　システムのセットアップの流れ

注※

これらの作業を一括して実行することもできます。なお，HCSCコンポーネントの配備の前には，HCSCコンポーネントのパッケージングおよび配備定義が，配備のあとにはHCSCコンポーネントの開始が実行されます。ただし，一括実行は，システム開発時，または単体テストから結合テスト時を対象としています。詳細については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「9.5　HCSCコンポーネントをHCSCサーバに配備して開始する処理の一括実行」を参照してください。

図中の各工程について，以降の項で説明します。

注意

サービスアダプタの配備，ビジネスプロセスの配備，およびユーザ定義受付の配備の前に，リポジトリをインポートして，リポジトリを最新の状態にしてください。

運用時の処理の流れや障害発生時の対策によっては，運用開始前に必要な設定があります。詳細については，マニュアル「Cosminexus サービスプラットフォーム 機能解説」の「3.2.1　TP1から同期の標準受付を使ったHCSCサーバのサービス部品の呼び出し」，マニュアル「Cosminexus サービスプラットフォーム 機能解説」の「3.2.2　TP1から非同期の標準受付を使ったHCSCサーバのサービス部品の呼び出し」，およびこのマニュアルの「7.　障害対策」を参照してください。

UNIXの場合でCosminexus Component Container管理者を変更しているときは，Cosminexus Service Coordinator管理者を同一にしてください。詳細については，「付録A　Cosminexus Service Coordinator管理者の変更方法」を参照してください。

3.1.2　実行環境に必要なソフトウェアの設定

実行環境をセットアップする前に，実行環境に必要なソフトウェアの設定が必要です。実行環境に必要なソフトウェアの設定は，データベースとCosminexus RMの使用有無によって設定内容が異なります。ここでは，データベースとCosminexus RMの両方を使用する場合の設定について説明します。データベースとCosminexus RMの両方を使用しない場合，またはデータベースを使用してCosminexus RMを使用しない場合の設定については，次の個所を参照してください。

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

「3.1.18　データベースとCosminexus RMの両方を使用しない場合のシステムのセットアップ」

データベースを使用してCosminexus RMを使用しない

「3.1.19　データベースを使用してCosminexus RMを使用しない場合のシステムのセットアップ」

データベースとCosminexus RMの両方を使用する場合の，実行環境に必要なソフトウェアの設定の流れについて，次の図に示します。

図3-2　実行環境に必要なソフトウェアの設定（データベースとCosminexus RMの両方を使用する場合）

実行環境のセットアップ前に実施するソフトウェアの設定について，次に説明します。

＜この項の構成＞

(1)　データベースのサーバ側のセットアップ

(2)　Management Serverのセットアップ

(3)　PRFのセットアップ

(4)　J2EEサーバのセットアップ

(5)　Webサーバ（HTTPサーバ）のセットアップ

(6)　データベースのクライアント側のセットアップ

(7)　JDBCドライバのセットアップ

(8)　DB Connectorのセットアップ

(9)　Cosminexus Reliable Messagingのセットアップ

(10)　TP1インバウンドアダプタのセットアップ

(11)　Cosminexus Service Coordinator-Managerのセットアップ

(12)　uCosminexus 日立コード変換 - Server RuntimeまたはuCosminexus 日立コード変換 - Runtimeのセットアップ

(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），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），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をセットアップし，環境設定をします。詳細については，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「7.6　Management Serverのセットアップと環境設定」を参照してください。また，HCSC-Managerを使用するための設定については，「2.1.6　HCSC-Managerを使用するためのManagement Serverの設定」を参照してください。

なお，Management Serverと運用管理エージェントは，HCSCサーバを運用するための基盤となります。そのため，OSの起動と同時にManagement Serverと運用管理エージェントを自動起動するように設定してください。

(3)　PRFのセットアップ

次の作業を実施します。

PRFの設定

PRFの設定方法については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 保守／移行／互換編」を参照してください。

(4)　J2EEサーバのセットアップ

次の作業を実施します。

(a)　J2EEサーバの構築

J2EEサーバの構築は，Smart Composer機能，または運用管理ポータル機能を使用して実施してください。

Smart Composer機能を使用したJ2EEサーバの構築については，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「8.　J2EEアプリケーションを実行するシステムの構築」を参照してください。

また，運用管理ポータル機能を使用したJ2EEサーバの構築については，マニュアル「Cosminexus アプリケーションサーバ 運用管理ポータル操作ガイド」の「3.　J2EEアプリケーションを実行するシステムの構築と削除」を参照してください。

注意

構築時には，論理サーバ名と実サーバ名を同一にしてください。異なる場合，HCSCサーバのセットアップに失敗するおそれがあります。

(b)　J2EEサーバのシステム環境変数の設定

J2EEサーバのシステム環境変数の設定方法については，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「7.3　環境変数の設定」を参照してください。

(c)　SOAP通信基盤およびJAX-WSエンジンの初期設定

SOAP1.1モードを利用する場合，SOAP通信基盤の初期設定が必要になります。SOAP1.1/1.2併用モードを利用する場合は，JAX-WSエンジンの初期設定が必要になります。それぞれの場合の初期設定手順について説明します。

SOAP1.1モードを利用する場合の初期設定

SOAP1.1モードを利用する場合，次の手順でSOAP通信基盤の初期設定をします。

Common Public License Version 1.0に基づいて配布されているWSDL4Jを利用するため，「wsdl4j.jar」ファイルを入手し，次のディレクトリにコピーします。

<Cosminexusのインストールディレクトリ>¥c4web¥lib以下

サーバ定義ファイル（c4websv.cfg）を設定します。
HCSCサーバが動作するJ2EEサーバでのSOAP通信基盤のサーバ定義ファイルに指定する内容を次の表に示します。サーバ定義ファイルの作成については，マニュアル「Cosminexus アプリケーションサーバ 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では次のようになります。

標準受付の識別子：クラスタ名

ユーザ定義受付の識別子：ユーザ定義受付の受付ID

（例）クラスタ名称が「cluster1」の場合

標準受付の識別子：「cluster1」

共通定義ファイル（c4webcom.cfg）を設定します。
HCSCサーバが動作するJ2EEサーバでのSOAP通信基盤の共通定義ファイルに指定する内容を次の表に示します。共通定義ファイルの作成については，マニュアル「Cosminexus アプリケーションサーバ 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エンジンの共通定義ファイルに指定する内容を次の表に示します。共通定義ファイルの作成については，マニュアル「Cosminexus アプリケーションサーバ Webサービス開発の手引」の「10.1.2　共通定義ファイルの設定項目」を参照してください。

表3-3　共通定義ファイルの設定項目（JAX-WSエンジン）

設定項目 | キー名称 | 設定値（デフォルト） | 説明
HTTPセッションの維持の有無 | javax.xml.ws.session.maintain | false | trueを指定した場合の動作は保証しません。

サーバ単位にプロキシの設定をします。
プロキシの設定方法については，マニュアル「Cosminexus アプリケーションサーバ Webサービス開発の手引」の「10.10　プロキシサーバ経由の接続」を参照してください。

(d)　HCSCサーバをセットアップするための固有設定

J2EEサーバ用のユーザプロパティファイル（usrconf.properties）で，ejbserver.rmi.localinvocation.scopeに「app」を指定します。

J2EEサーバ用のユーザプロパティファイル（usrconf.properties）で，ejbserver.server.j2ee.featureに「1.4」を指定します。

(e)　コンテナ拡張ライブラリの設定

コンテナ拡張ライブラリとして，次の設定をします。

コンテナ拡張ライブラリの設定方法については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「13.　コンテナ拡張ライブラリ」を参照してください。

SOAP1.1モードを利用する場合

<Cosminexus RMのインストールディレクトリ>¥lib¥reliablemessaging-api.jar
<Cosminexusのインストールディレクトリ>¥c4web¥lib¥hitsaaj.jar

cjjaxws.jarを無効にするため，cjjaxws.jarの行をコメントアウトするか削除してください。

SOAP1.1/1.2併用モードを利用する場合

<Cosminexus RMのインストールディレクトリ>¥lib¥reliablemessaging-api.jar
<Cosminexusのインストールディレクトリ>¥jaxws¥lib¥cjjaxws.jar

hitsaaj.jarを無効にするため，hitsaaj.jarの行をコメントアウトするか削除してください。

このとき，「add.class.path=<jarのパス>」の形式で指定してください。

この定義は，運用管理ポータルからも設定できます。運用管理ポータルの「論理サーバの環境設定」にある論理J2EEサーバの［J2EEコンテナの設定］画面の拡張パラメタにクラスパスを指定します。ここでの設定値は，J2EEサーバのユーザ定義ファイル（usrconf.cfg）に反映されます。

J2EEサーバ用オプション定義ファイルについては，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.3　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。また，「論理サーバの環境設定」での設定については，マニュアル「Cosminexus アプリケーションサーバ 運用管理ポータル操作ガイド」の「10.　論理サーバの環境設定」を参照してください。

(5)　Webサーバ（HTTPサーバ）のセットアップ

Webサーバ（HTTPサーバ）をセットアップするには，CosminexusのJ2EEサーバに含まれるインプロセスHTTPサーバを使用する方法と，Hitachi Web Serverを使用する方法の二つがあります。

(a)　インプロセスHTTPサーバを使用する方法

次の作業を実施します。

インプロセスHTTPサーバのセットアップ

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

インプロセスHTTPサーバのコネクションタイムアウト値の設定

サービスリクエスタ側にあるSOAP通信基盤でコネクションプーリング機能を使用している場合，サービスリクエスタ側のコネクション保持の時間と，HCSCサーバ稼働マシンでのコネクションタイムアウト値の整合性をとる必要があります。

コネクションタイムアウト値の設定手順を次に示します。

運用管理ポータルから，［論理サーバの環境設定］を選択します。

サーバビューから，［論理J2EEサーバ］－［J2EEサーバ］－［＜J2EEサーバ名＞］を選択します。

［HTTPサーバ］タブの［通信・スレッド制御］タブを選択します。

［通信・スレッド制御設定］画面が表示されます。

［Webクライアントとの接続設定］－［Persistentコネクション］－［タイムアウト］に，SOAP通信基盤（Cosminexus Web Services）の共通定義ファイルのc4web.common.connection_pool.timeoutプロパティに指定した値以上の値を設定します。
例えば，c4web.common.connection_pool.timeoutプロパティのデフォルト値1800（単位：秒）の倍の値である3600をタイムアウト値に設定します。c4web.common.connection_pool.timeoutプロパティを設定していない場合は，1800がデフォルト値として動作します。なお，タイムアウト値に指定できる範囲は0～3600です。そのため，c4web.common.connection_pool.timeoutプロパティの設定が1800よりも大きい場合は，0を設定してください。

(b)　Hitachi Web Serverを使用する方法

次の作業を実施します。

Hitachi Web Serverのセットアップ

セットアップ方法の詳細については，マニュアル「Hitachi Web Server」を参照してください。

Hitachi Web ServerとJ2EEサーバを連携する設定

J2EEサーバと連携するためには，簡易構築定義ファイルでWebサーバ連携のためのパラメタの設定が必要です。パラメタの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.13　論理Webサーバで指定できるパラメタ」を参照してください。

Hitachi Web ServerのKeepAliveTimeout値の設定

サービスリクエスタ側にあるSOAP通信基盤でコネクションプーリング機能を使用している場合，サービスリクエスタ側のコネクション保持の時間と，HCSCサーバ稼働マシンのKeepAliveTimeout値の整合性をとる必要があります。

Hitachi Web Serverの環境設定ファイルであるhttpsd.confのKeepAliveTimeoutに，SOAP通信基盤（Cosminexus Web Services）の共通定義ファイルのc4web.common.connection_pool.timeoutプロパティに指定した値の倍以上の値を設定します。

例えば，c4web.common.connection_pool.timeoutプロパティのデフォルト値1800の倍の値である3600をKeepAliveTimeoutに設定します。c4web.common.connection_pool.timeoutプロパティを設定していない場合は，1800がデフォルト値として動作します。なお，指定できる値の範囲は0～65535です。詳細は，マニュアル「Cosminexus アプリケーションサーバ SOAPアプリケーション開発の手引」の「7.4.2　コネクションプーリングに関する設定」を参照してください。

(6)　データベースのクライアント側のセットアップ

(a)　DBクライアント側の設定（HiRDBの場合）

実行環境のマシンで，次の作業を実施します。

環境変数の設定

Windowsの場合は，次の環境変数を設定します。

UNIXの場合は，HCSCサーバが稼働しているJ2EEサーバ起動時とManagement Server実行時の環境変数に，次の環境変数を設定します。

HCSCサーバが稼働しているJ2EEサーバ起動時の環境変数の設定方法は，マニュアル「Cosminexus アプリケーションサーバ 運用管理ポータル操作ガイド」の「10.9.24　J2EEサーバの環境変数の設定」を参照してください。

Management Server実行時の環境変数の設定方法は，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「10.9　mserverenv.cfg（Management Server用環境変数定義ファイル）」を参照してください。

PDXAMODE

1を指定します。

ただし，ライトトランザクション機能を利用する場合はPDXAMODEの設定は必要ありません。

PDTXACANUM

Cosminexus サービスプラットフォームが使用するDBコネクション数の最大値を指定します。

ただし，ライトトランザクション機能を利用する場合はPDTXACANUMの設定は必要ありません。

DBコネクション数の最大値は，利用する実行環境に応じて見積もる必要があります。実行環境がDBコネクションを使用する契機と数を次の表に示します。

表3-4　実行環境が使用するDBコネクションの数

DBコネクションの使用先 | DBコネクションの使用の契機 | DBコネクションの使用数
メッセージング基盤 | 起動時 | 1
コマンド実行時 | 1
サービス部品実行要求受付時 | サービス部品の同時実行数
電文の実行履歴の取得時 | サービス部品の同時実行数
ビジネスプロセス基盤 | ビジネスプロセス実行要求受付時 | ビジネスプロセスの同時実行数
DBアダプタ | サービス部品実行要求受付時 | サービス部品の同時実行数
Cosminexus RM | マニュアル「Cosminexus 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またはHP-UX（IPF）で稼働させる場合，下記のパスを追加します。

<Cosminexus DABroker Library運用ディレクトリ>/lib

<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で稼働させる場合，下記のパスを追加します。

<Cosminexus DABroker Library運用ディレクトリ>/lib

<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のプロパティについては，マニュアル「Cosminexus アプリケーションサーバ アプリケーション設定操作ガイド」の「4.2.2　DB Connectorのプロパティ定義」を参照してください。

環境変数グループで設定する環境変数を次の表に示します。

表3-5　環境変数グループで設定する環境変数

環境変数名 | 設定する内容
PDHOST | データベースのホスト名またはIPアドレスを指定します。
PDUSER | データベースのユーザ名およびデータベースのパスワードを指定します。
PDNAMEPORT | データベースのポート番号を指定します。
PDSWAITTIME | Cosminexus Component Containerのトランザクションタイムアウトの値※よりも大きな値を指定します。
PDCWAITTIME | Cosminexus Component Containerのトランザクションタイムアウトの値※よりも大きな値を指定します。
PDSWATCHTIME | 0を指定します。

注※

Cosminexus Component Containerのトランザクションタイムアウトの値は，J2EEサーバ用ユーザプロパティファイルで指定します。Cosminexus Component Containerのトランザクションタイムアウトの値については，マニュアル「Cosminexus アプリケーションサーバ システム設計ガイド」の「8.6.4　トランザクションタイムアウトを設定する」を参照してください。

(b)　DBクライアント側の設定（Oracleの場合）

Oracle JDBC Thin Driverをセットアップします。Oracle JDBC Thin Driverのセットアップについては，「3.1.2(7)(c) Oracle JDBC Thin Driverのセットアップ」を参照してください。

(7)　JDBCドライバのセットアップ

使用するJDBCドライバは，利用条件を考慮して選択する必要があります。

使用するJDBCドライバの選択方法を次の表に示します。

表3-6　使用するJDBCドライバ

利用するDBMS
使用するJDBCドライバ
JDBCドライバのパッケージ

HiRDB（Version 8）※1
Cosminexus DABroker Library
JP.co.Hitachi.soft.DBPSV_Driver.JdbcDbpsvDriver

HiRDB（Version 8またはVersion 9）※2
HiRDB TYPE4 JDBC Driver
JP.co.Hitachi.soft.HiRDB.JDBC.HiRDBDriver

Oracle
Oracle JDBC Thin Driver

oracle.jdbc.driver.OracleDriver

oracle.jdbc.OracleDriver※3

注※1　Cosminexus DABroker Library用のDB Connectorを利用する場合

注※2　HiRDB Type4 JDBC Driver用のDB Connectorを利用する場合

注※3　HCSCサーバセットアップ定義ファイルのdbtypeプロパティにORACLE11Gを指定する場合

(a)　Cosminexus DABroker Libraryのセットアップおよび環境設定

次の作業を実施します。

ただし，HiRDB Type4 JDBC DriverまたはOracle JDBC Thin Driverを使用する場合は，Cosminexus DABroker Libraryのセットアップおよび環境設定は必要ありません。

Windowsの場合

Cosminexus DABroker Libraryのセットアップとして，次の作業を実施してください。

バッファサイズの設定

Cosminexus DABroker Libraryの環境設定の［リモートアクセス設定］タブで，［BLOB/LONG/CLOB型データ受取バッファサイズ］に，DB ConnectorのbufSizeプロパティに設定する値よりも大きい値を設定します。

bufSizeプロパティの設定については，「3.1.2(8) DB Connectorのセットアップ」を参照してください。

漢字コードセットの設定

Cosminexus DABroker Libraryの環境設定の［リモートアクセス設定］タブで，使用するデータベースの文字コードに合わせて［漢字コードセット］を設定します。

データベースの言語モードについては，HiRDBの場合はマニュアル「HiRDB システム導入・設計ガイド」を，Oracleの場合はOracle Corporationが発行するドキュメントを参照してください。

使用するORACLEのバージョンの設定

Cosminexus DABroker Libraryの環境設定の［共通設定］タブで，［使用するORACLEのバージョン］にOracleのバージョンを設定します。

UNIXの場合

Cosminexus DABroker Libraryをセットアップします。Cosminexus DABroker Libraryのセットアップ方法の詳細は，マニュアル「Cosminexus アプリケーションサーバ 機能解説 保守／移行／互換編」の「11.2.2　Cosminexus DABroker Libraryのインストールおよび動作環境の設定（UNIXの場合）」を参照してください。Cosminexus DABroker Library動作環境定義ファイルに指定する設定項目で，特に設定が必要な項目を次に示します。

DABORACLE_TYPE

Oracleを使用する場合に，使用するOracleのバージョンを指定します。

DABHIRDBA_BLOBBUFSIZEおよびDABORADBA_LONGBUFSIZE

DB ConnectorのbufSizeプロパティに設定する値よりも大きな値を設定します。

bufSizeプロパティの設定については，「3.1.2(8) DB Connectorのセットアップ」を参照してください。

DAB_LANG

使用するデータベースの文字コードを設定します。

(b)　HiRDB Type4 JDBC Driverのセットアップ

HiRDB Type4 JDBC Driverのセットアップについては，マニュアル「HiRDB UAP開発ガイド」のHiRDB Type4 JDBC Driverに関する内容を参照してください。

なお，HCSCサーバを使用するために，次の設定をする必要があります。

<Cosminexusインストールディレクトリ>/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サーバ用オプション定義ファイルについては，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.3　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。また，「論理サーバの環境設定」での設定については，マニュアル「Cosminexus アプリケーションサーバ 運用管理ポータル操作ガイド」の「10.　論理サーバの環境設定」を参照してください。

運用管理ポータルの「論理サーバの環境設定」にある論理J2EEサーバの［J2EEコンテナの設定］画面の拡張パラメタに，HiRDB Type4 JDBC DriverのJARファイル（pdjdbc2.jar）をクラスパスとして指定します。このとき，「add.class.path=<pdjdbc2.jarのパス>」の形式で指定してください。
ここでの設定値は，J2EEサーバのユーザ定義ファイル（usrconf.cfg）に反映されます。
「論理サーバの環境設定」での設定については，マニュアル「Cosminexus アプリケーションサーバ 運用管理ポータル操作ガイド」の「10.　論理サーバの環境設定」を参照してください。

例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というディレクトリになります。

HCSC-Messagingコマンド共通定義ファイルのHCSC_ADDCLASSPATHに，HiRDB Type4 JDBC DriverのJARファイル（pdjdbc2.jar）をクラスパスとして指定します。
HCSC-Messagingコマンド共通定義ファイルの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「HCSC-Messagingコマンド共通定義ファイル」を参照してください。

(c)　Oracle JDBC Thin Driverのセットアップ

Oracle JDBC Thin Driverのセットアップについては，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「7.5.2　Oracleの設定（Oracle JDBC Thin Driverの場合）」または，使用しているデータベースのマニュアルを参照してください。

なお，HCSCサーバを使用するために，次の設定をする必要があります。使用するOracleのバージョンによって，Oracle JDBC Thin Driverの種類が異なりますので，Oracle JDBC Thin DriverのJARファイルのクラスパスを指定する際は注意してください。

<Cosminexusインストールディレクトリ>/manager/config/mserver.cfgファイルに，Oracle JDBC Thin DriverのJARファイルをクラスパスとして指定します。このとき，「web.add.class.path=<Oracle JDBC Thin Driverのパス>」の形式で指定してください。

例1（Oracle 10gの場合）

web.add.class.path=<Oracle Clientのインストールディレクトリ>/jdbc/lib/ojdbc14.jar

例2（Oracle 11g（JDK5）の場合）

web.add.class.path=<Oracle Clientのインストールディレクトリ>/jdbc/lib/ojdbc5.jar

例3（Oracle 11g（JDK6）の場合）

web.add.class.path=<Oracle Clientのインストールディレクトリ>/jdbc/lib/ojdbc6.jar

J2EEサーバ用オプション定義ファイル（usrconf.cfg）に，Oracle JDBC Thin DriverのJARファイルをクラスパスとして指定します。このとき，「add.class.path=<Oracle JDBC Thin Driverのパス>」の形式で指定してください。

例1（Oracle 10gの場合）

add.class.path=<Oracle Clientのインストールディレクトリ>/jdbc/lib/ojdbc14.jar

例2（Oracle 11g（JDK5）の場合）

add.class.path=<Oracle Clientのインストールディレクトリ>/jdbc/lib/ojdbc5.jar

例3（Oracle 11g（JDK6）の場合）

add.class.path=<Oracle Clientのインストールディレクトリ>/jdbc/lib/ojdbc6.jar

この定義は，運用管理ポータルからも設定できます。運用管理ポータルの「論理サーバの環境設定」にある論理J2EEサーバの［J2EEコンテナの設定］画面の拡張パラメタにクラスパスを指定します。ここでの設定値は，J2EEサーバのユーザ定義ファイル（usrconf.cfg）に反映されます。
J2EEサーバ用オプション定義ファイルについては，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.3　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。また，「論理サーバの環境設定」での設定については，マニュアル「Cosminexus アプリケーションサーバ 運用管理ポータル操作ガイド」の「10.　論理サーバの環境設定」を参照してください。

運用管理ポータルの「論理サーバの環境設定」にある論理J2EEサーバの［J2EEコンテナの設定］画面の拡張パラメタに，Oracle JDBC Thin DriverのJARファイルをクラスパスとして指定します。このとき，「add.class.path=<Oracle JDBC Thin Driverのパス>」の形式で指定してください。
ここでの設定値は，J2EEサーバのユーザ定義ファイル（usrconf.cfg）に反映されます。
「論理サーバの環境設定」での設定については，マニュアル「Cosminexus アプリケーションサーバ 運用管理ポータル操作ガイド」の「10.　論理サーバの環境設定」を参照してください。

例1（Oracle 10gの場合）

add.class.path=<Oracle Clientのインストールディレクトリ>/jdbc/lib/ojdbc14.jar

例2（Oracle 11g（JDK5）の場合）

add.class.path=<Oracle Clientのインストールディレクトリ>/jdbc/lib/ojdbc5.jar

例3（Oracle 11g（JDK6）の場合）

add.class.path=<Oracle Clientのインストールディレクトリ>/jdbc/lib/ojdbc6.jar

HCSC-Messagingコマンド共通定義ファイルのHCSC_ADDCLASSPATHに，Oracle JDBC Thin DriverのJARファイルをクラスパスとして指定します。
HCSC-Messagingコマンド共通定義ファイルの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「HCSC-Messagingコマンド共通定義ファイル」を参照してください。

(8)　DB Connectorのセットアップ

HCSCサーバは，データベースと接続するためにDB Connectorを利用します。処理のタイミングやテーブル種別に応じて，データベースアクセスをトランザクション管理する場合と管理しない場合があるため，トランザクションサポート種別がXATransactionまたはLocalTransactionのDB Connectorと，トランザクションサポート種別がNoTransactionであるDB Connectorの，二つのDB Connectorを準備する必要があります。

なお，トランザクションサポート種別がXATransactionまたはLocalTransactionのDB Connectorは，処理性能を向上させるため，Cosminexus RMと連携できるDB Connectorを利用します。

それぞれのDB Connectorの表示名は，HCSCサーバセットアップ定義ファイルの「dbcon-xadisplayname」と「dbcon-nodisplayname」に指定します。HCSCサーバセットアップ定義ファイルの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「HCSCサーバセットアップ定義ファイル」を参照してください。

(a)　DB Connectorのインポート

インポートするDB Connectorは，利用条件を考慮して選択する必要があります。インポートするRARファイルの選択方法を次の表に示します。

表3-7　インポートするRARファイルの選択方法（Cosminexus RMを使用する場合）

HCSCサーバセットアップ定義ファイルのプロパティ
利用するデータベース
ライトトランザクション機能の利用の有無

利用する
利用しない

dbcon-xadisplayname
HiRDB（Version 8）※1
DBConnector_DABJ_CP_
Cosminexus_RM.rar
DBConnector_DABJ_XA_
Cosminexus_RM.rar

HiRDB（Version 8またはVersion 9）※2
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（Version 8）※1
DBConnector_DABJ_CP.rar

HiRDB（Version 8またはVersion 9）※2
DBConnector_HiRDB_Type4_CP.rar

Oracle
DBConnector_Oracle_CP.rar

注※1　JDBCドライバにCosminexus DABroker Libraryを利用する場合です。

注※2　JDBCドライバにHiRDB Type4 JDBC Driverを利用する場合です。

DB Connectorのインポート方法については，マニュアル「Cosminexus アプリケーションサーバ アプリケーション設定操作ガイド」の「4.2　データベースと接続するための設定」を参照してください。また，プロパティ定義については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1　Connector属性ファイル」を参照してください。

ライトトランザクションについては，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「3.14.5　ライトトランザクション」を参照してください。また，設定方法については，マニュアル「Cosminexus アプリケーションサーバ 運用管理ポータル操作ガイド」の「10.9.7　トランザクションの設定」を参照してください。

また，DBアダプタを利用する場合は，DBアダプタが利用するDB Connectorをインポートします。インポートするRARファイルの選択方法を次の表に示します。

表3-8　インポートするRARファイルの選択方法（DBアダプタを利用する場合）

利用するJDBCドライバ
利用するデータベース
ライトトランザクション機能の利用の有無

利用する
利用しない

Cosminexus DABroker Library
HiRDB（Version 8）
DBConnector_DABJ_CP.rar
DBConnector_DABJ_XA.rar

Oracle

HiRDB Type4 JDBC Driver
HiRDB（Version 8またはVersion 9）
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をインポートしたあと，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1　Connector属性ファイル」を参照して，プロパティを定義してください。ただし，次の表に示す内容をプロパティに設定する必要があります。

表3-9　dbcon-xadisplaynameに設定するDB Connector属性ファイルの設定内容（DABroker/Oracle）

設定項目 | 設定値
<display-name>タグ | DB Connector表示名
<config-property>タグに設定するdatabaseNameプロパティ | データベース名※1
<config-property>タグに設定するbufSizeプロパティ | システムで利用する最大の電文長よりも大きな値※2
<transaction-support>タグ | XATransaction※3
LocalTransaction※4

注※1

使用するDB Connectorによって設定値が異なります。設定値については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「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

表3-10　dbcon-xadisplaynameに設定するDB Connector属性ファイルの設定内容（HiRDB Type4）

設定項目 | 設定値
<display-name>タグ | DB Connector表示名
<config-property>タグに設定するmaxBinarySizeプロパティ | システムで利用する最大の電文長よりも大きな値※1
<transaction-support>タグ | XATransaction※2
LocalTransaction※3

注※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

注意

データベースに接続するために必要な情報を設定してください。設定値については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1　Connector属性ファイル」を参照してください。

表3-11　dbcon-nodisplaynameに設定するDB Connector属性ファイルの設定内容（DABroker/Oracle）

設定項目 | 設定値
<display-name>タグ | DB Connector表示名
<config-property>タグに設定するdatabaseNameプロパティ | データベース名※1
<config-property>タグに設定するbufSizeプロパティ | システムで利用する最大の電文長よりも大きな値※2
<transaction-support>タグ | NoTransaction※3

注※1

使用するデータベースによって設定値が異なります。設定値については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「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

表3-12　dbcon-nodisplaynameに設定するDB Connector属性ファイルの設定内容（HiRDB Type4）

設定項目 | 設定値
<display-name>タグ | DB Connector表示名
<config-property>タグに設定するmaxBinarySizeプロパティ | システムで利用する最大の電文長よりも大きな値※1
<transaction-support>タグ | NoTransaction※2

注※1

LONGVARBINARY_AccessプロパティにREALを指定した場合に指定してください。また，必ず0以外の値を指定してください。

注※2

使用するDB Connectorが次のDB Connectorに対して指定してください。

・DBConnector_HiRDB_Type4_CP.rar

注意

データベースに接続するために必要な情報を設定してください。設定値については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1　Connector属性ファイル」を参照してください。

表3-13　DBアダプタを利用する場合に設定するConnector属性ファイルの設定内容

設定項目 | 設定値
<display-name>タグ | DB Connector表示名※1
<config-property>タグに設定するdatabaseNameプロパティ | データベース名※2
<transaction-support>タグ | XATransaction
LocalTransaction

注※1

この値は，DBアダプタのアプリケーション統合属性ファイルの<linked-to>タグにも設定します。アプリケーション統合属性ファイルについては，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「5.3.5　DBアダプタを定義する」を参照してください。

注※2

使用するDB Connectorによって設定値が異なります。設定値については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1　Connector属性ファイル」を参照してください。

(9)　Cosminexus Reliable Messagingのセットアップ

Cosminexus Reliable Messagingをセットアップします。作業の詳細については，マニュアル「Cosminexus Reliable Messaging」の「3.　システム構築」を参照してください。セットアップ作業のうちプロパティのカスタマイズについては，次に示す方法で実施します。

Cosminexus Reliable Messagingのコンフィグレーションプロパティの設定

設定するコンフィグレーションプロパティと指定する値を次の表に示します。なお，認証情報（UserおよびPassword）には，Cosminexus RMが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文字の識別子を設定します。
なお，必ずデッドメッセージキューを使用してください。
また，デッドメッセージキューはローカルキューとしてください。

注意事項

コンフィグレーションプロパティRMWaitRestorationの値は変更しないでください。Cosminexus RMのデフォルト値「true」で動作します。

デッドメッセージキュー名「RMDeadMessageQueueName」に指定するデッドメッセージキューは，非同期の標準受付や非同期のサービスアダプタを使用している場合に，配送回数が最大値に達してサービス部品が呼び出されなかったメッセージが移動される特別なキューです。
デッドメッセージキュー名を設定していない場合，およびデッドメッセージキューを作成していない場合，無限にサービス部品を呼び出す処理が再実行されるため，注意してください。
なお，デッドメッセージキューとして使用するキューは，Cosminexus RMの設定後，最初に開始したあとに作成してください。

データベースにOracleを使用する場合，非同期受付キュー（MDB（DBキュー）），および非同期のサービスアダプタ（MDB（DBキュー））は使用できません。

(10)　TP1インバウンドアダプタのセットアップ

TP1/RPC受付を使用する場合は，TP1インバウンドアダプタをセットアップします。J2EEサーバがセットアップされていれば，任意のタイミングでセットアップできます。

TP1インバウンドアダプタのセットアップについては，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「4.11.2　リソースアダプタの設定」に関する説明を参照してください。なお，TP1インバウンドアダプタをセットアップするには，Connector属性定義ファイルを必ず設定してください。

(11)　Cosminexus Service Coordinator-Managerのセットアップ

必要に応じて，「2.4　運用環境に関する設定」を参照し，設定してください。

(12)　uCosminexus 日立コード変換 - Server RuntimeまたはuCosminexus 日立コード変換 - Runtimeのセットアップ

実行環境でバイナリデータを扱う場合，およびデータ変換の値置換えファンクションを利用する場合，実行環境のOSがWindowsのときはuCosminexus 日立コード変換 - Server Runtimeを，UNIXのときはuCosminexus 日立コード変換 - Runtimeをセットアップします。

(a)　インストール

uCosminexus 日立コード変換 - Server Runtime，またはuCosminexus 日立コード変換 - Runtimeをインストールします。

インストール方法の詳細は，uCosminexus 日立コード変換 - Server RuntimeまたはuCosminexus 日立コード変換 - Runtimeに添付されているドキュメントを参照してください。

(b)　環境設定

環境設定として，次の作業を実施します。

クラスパスの追加

オプション定義ファイル（usrconf.cfg）およびJ2EEサーバ用オプション定義ファイル（usrconf.cfg）に次の定義を追加します。

add.class.path=<コード変換ライブラリのjarファイルのパス>

例えば，実行環境のOSがWindowsの場合で，uCosminexus 日立コード変換 - Server Runtimeを「C:¥Program Files¥HITACHI¥CodeConvJ」にインストールしたときには，次のように定義を追加します。

add.class.path= C:¥Program Files¥HITACHI¥CodeConvJ¥Java¥codeconv.jar

このとき，「add.class.path=<codeconv.jarのパス>」の形式で指定してください。

この定義は，運用管理ポータルからも設定できます。運用管理ポータルの「論理サーバの環境設定」にある論理J2EEサーバの［J2EEコンテナの設定］画面の拡張パラメタにクラスパスを指定します。ここでの設定値は，J2EEサーバのユーザ定義ファイル（usrconf.cfg）に反映されます。

J2EEサーバ用オプション定義ファイルについては，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.3　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。また，「論理サーバの環境設定」での設定については，マニュアル「Cosminexus アプリケーションサーバ 運用管理ポータル操作ガイド」の「10.　論理サーバの環境設定」を参照してください。

変換テーブル（ユーザマッピングファイル）の格納パスの追加

システムプロパティファイル（usrconf.properties）に次の定義を追加します。

csc.dt.codetablepath=<変換テーブルの格納ディレクトリパス>

例えば，実行環境のOSがWindowsの場合で，uCosminexus 日立コード変換 - Server Runtimeを「C:¥Program Files¥HITACHI¥CodeConvJ」にインストールした場合，次のように定義を追加します。

csc.dt.codetablepath=C¥:¥¥Program Files¥¥HITACHI¥¥CodeConvJ¥¥Table

ユーザマッピングファイル（外字ファイル）の格納

開発環境のuCosminexus 日立コード変換 - Development Kitで作成したユーザマッピングファイルを，システムプロパティファイル（usrconf.properties）に追加したパス（csc.dt.codetablepathに指定したパス）に格納します。

uCosminexus 日立コード変換 - Development Kitでのユーザマッピングファイルの作成については，uCosminexus 日立コード変換 - Development Kitに添付されているドキュメント，およびマニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「2.1.4　uCosminexus 日立コード変換 - Development Kitのセットアップ」を参照してください。

3.1.3　HCSCサーバをセットアップする

サービスアダプタ，ビジネスプロセス，ユーザ定義受付をHCSCサーバに配備して，実行環境をセットアップするには，まず，HCSCサーバをセットアップする必要があります。また，HCSCサーバをセットアップするときに，あわせてクラスタもセットアップできます。

HCSCサーバのセットアップの前提条件，およびセットアップ方法について次に説明します。

参考

HCSCサーバをセットアップしたあと，HCSCサーバを起動する前に，HCSCサーバの定義情報を設定することを推奨します。HCSCサーバの定義方法については，「3.1.4　HCSCサーバの定義情報を設定する」を参照してください。

＜この項の構成＞

(1)　前提条件

(2)　セットアップ方法

(3)　セットアップ情報の追加・変更

(1)　前提条件

HCSCサーバをセットアップするには，次の条件を満たす必要があります。

HCSCサーバをセットアップする実行環境のマシン上で次のプロセスが起動していること

運用管理エージェント

Management Server

J2EEサーバ

PRF

Hitachi Web Server

運用管理エージェント，Management Server，J2EEサーバ，PRFの起動方法については，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」を，Hitachi Web Serverの起動方法については，マニュアル「Hitachi Web Server」をそれぞれ参照してください。

HCSCサーバをセットアップする実行環境のマシンに，Cosminexus Reliable Messaging，DB ConnectorおよびDBクライアントがセットアップされ，起動していること

同一クラスタ内で，データベースおよびCosminexus RMの使用有無が一致していること

同一リポジトリ内で，すべてのHCSCサーバのSOAPモードが一致していること

HCSCサーバ構成定義ファイルおよびHCSCサーバセットアップ定義ファイルが作成されていること
HCSCサーバ構成定義ファイルの作成方法については，「2.3.1　HCSCサーバ構成定義ファイルを設定する」を，ファイルの内容の詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「HCSCサーバ構成定義ファイル」を参照してください。
HCSCサーバセットアップ定義ファイルの作成方法については，「2.3.2　HCSCサーバセットアップ定義ファイルを設定する」を，ファイルの内容の詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「HCSCサーバセットアップ定義ファイル」を参照してください。

セットアップするHCSCサーバとすでにセットアップされているHCSCサーバでクラスタを構成する場合，HCSCサーバ構成定義ファイルおよびHCSCサーバセットアップ定義ファイルで同じ設定にする必要のある項目が同じ設定になっていること
HCSCサーバ構成定義ファイルおよびHCSCサーバセットアップ定義ファイルで，クラスタを構成するHCSCサーバ間で同じ設定にする必要のある項目については，ロードバランスクラスタ構成の場合は「2.5.1(1) 実行環境の構築」を，HAクラスタ構成の場合は「2.6.1(1) 実行環境（実行系・待機系）の構築」を参照してください。

HCSCサーバをアンセットアップしたあとに再度セットアップする場合，J2EEサーバを再起動していること

(2)　セットアップ方法

HCSCサーバをセットアップするには，運用環境でcscsvsetupコマンドを実行します。

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

セットアップする内容は，単独のHCSCサーバをセットアップするか，すでにセットアップされているHCSCサーバとクラスタを構成するようにセットアップするかによって異なります。

注意

コマンド実行時に通信障害やタイムアウトが発生した場合，実行環境側で処理が完結している可能性があります。そのため，HCSCサーバのセットアップ情報を取得し，取得した情報に従って，再度cscsvsetupコマンドを実行してください。HCSCサーバのセットアップ情報の取得方法については，「5.2.14　HCSCサーバのセットアップ情報を確認する」を参照してください。なお，HCSCサーバのセットアップ情報を取得する場合，cscutilコマンドに-hostオプションを使用する必要があります。cscutilコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscutil（各種操作）」を参照してください。

クラスタ名とHCSCサーバ名は大文字/小文字を区別しないため，一意な名前を設定してください。ただし，HCSCサーバセットアップ時に，クラスタ名を省略してセットアップすることはできます。

データベースを利用してセットアップする場合，運用環境のリポジトリが別であったとしても，複数のマシンで同時にcscsvsetupコマンド（HCSCサーバのセットアップ）やcscsvunsetupコマンド（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)　セットアップ情報の追加・変更

(2)で示したセットアップを，すでにセットアップしたHCSCサーバに対して再度実施すると，セットアップした情報を追加・変更できます。

HCSCサーバのセットアップ情報の追加・変更を行う場合，HCSCサーバ，サービスアダプタ，ビジネスプロセス，およびユーザ定義受付がすべて停止している必要があります。

HCSCサーバ，サービスアダプタ，ビジネスプロセス，ユーザ定義受付の状態の確認方法については，それぞれ「5.2.15　HCSCサーバの情報を確認する」，「5.2.17　サービスアダプタの情報を確認する」，「5.2.18　ビジネスプロセスの情報を確認する」，「5.2.19　ユーザ定義受付の情報を確認する」を参照してください。

追加・変更できる情報を次に示します。

追加できる情報

標準受付の種別
同期（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アドレスおよびポート番号を変更できます。

Cosminexus Manager位置情報
Cosminexus ManagerにアクセスするためのIPアドレスおよびポート番号を変更できます。

注意

上記の情報以外を追加または変更する場合，一度HCSCサーバをアンセットアップしてから，再度セットアップする必要があります。HCSCサーバをアンセットアップしないまま上記の情報以外の情報を追加・変更してセットアップを実施した場合，追加および変更は無視されます。

3.1.4　HCSCサーバの定義情報を設定する

HCSCサーバの定義情報の設定の前提条件，および設定方法について次に説明します。

＜この項の構成＞

(1)　前提条件

(2)　設定方法

(1)　前提条件

HCSCサーバが停止状態または起動状態であること
HCSCサーバの状態の確認方法については，「5.2.15　HCSCサーバの情報を確認する」を参照してください。

HCSCサーバランタイム定義ファイルが作成されていること
HCSCサーバランタイム定義ファイルの作成方法については，「2.3.3　HCSCサーバランタイム定義ファイルを設定する」を，ファイルの内容の詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「HCSCサーバランタイム定義ファイル」を参照してください。

(2)　設定方法

HCSCサーバの定義情報を設定するには，運用環境でcscsvconfigコマンドを実行します。

cscsvconfigコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「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)　前提条件

(2)　確認方法

(1)　前提条件

HCSCサーバが停止状態または起動状態である必要があります。

HCSCサーバの状態の確認方法については，「5.2.15　HCSCサーバの情報を確認する」を参照してください。

(2)　確認方法

HCSCサーバの定義内容を確認するには，運用環境でcscsvconfigコマンドを実行します。

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

cscsvconfigコマンドの実行形式を次に示します。

cscsvconfig -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -operation get

HCSCサーバに設定されている定義内容は，標準出力に出力されます。出力された内容は，必要に応じてファイルにリダイレクトします。

3.1.6　サービス情報を変更する

開発環境ではサービスアダプタ開発時に，サービスアダプタの接続先情報，タイムアウト値などを設定します。運用環境では，これらの設定値をサービス情報として環境に適した値に変更できます。

また，変更したサービス情報は，リポジトリには反映されません。変更したサービス情報は，運用環境に保持され，サービスアダプタを実行環境に配備するときに反映されます。そのため，開発環境とは独立して，サービス情報を管理できます。

なお，運用環境で設定したサービス情報は，サービス情報を削除しないかぎり有効です。開発環境でサービスアダプタの情報を変更しても，運用環境で設定したサービス情報を削除しないかぎり，サービスアダプタには運用環境で設定したサービス情報が反映されます。

それぞれの環境でのサービス情報の扱いを次の図に示します。

図3-3　サービス情報を設定してからサービス情報を変更するまでの流れ

サービス情報を変更する前提条件，および変更方法について次に説明します。

＜この項の構成＞

(1)　前提条件

(2)　変更方法

(3)　サービス情報の削除

(1)　前提条件

サービス情報を変更するには，次の条件を満たす必要があります。

リポジトリを共有していないこと

クラスタ内のすべてのHCSCサーバで，サービス情報を変更するサービスアダプタが未配備状態であること

(2)　変更方法

サービス情報を変更するには，運用環境でcscsvcctlコマンドを実行します。

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

サービス情報を一括して変更するか，指定したサービス情報を個別に変更するかによって実行形式が異なります。

(a)　サービス情報を一括して変更する場合

サービス情報を一括して変更する手順を次に示します。

-getfileオプションにサービス情報を出力するファイル名（任意）を指定して実行します。

cscsvcctl -user <ログインユーザID> -pass <ログインパスワード> -getfile <サービス情報変更定義ファイル名>

取得したサービス情報変更定義ファイルに変更内容を定義します。
取得したサービス情報変更定義ファイル中で，プロキシサーバのユーザID/パスワード，ベーシック認証のユーザID/パスワード設定値は，次のように出力されます。

値が設定されているとき：The value has already been set.

値が設定されていないとき：空白

なお，プロキシサーバのユーザID/パスワード，ベーシック認証のユーザID/パスワードを変更しない場合は，-getfileオプションで取得したままの値を定義してください。また，ベーシック認証を使用する場合は，ベーシック認証に関するすべてのパラメタ（使用可否，ユーザ名，およびパスワード）を設定してください。
サービス情報変更定義ファイルの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「サービス情報変更定義ファイル」を参照してください。

-setfileオプションにサービス情報変更定義ファイルを指定して実行します。

cscsvcctl -user <ログインユーザID> -pass <ログインパスワード> -setfile <サービス情報変更定義ファイル名>

(b)　指定したサービス情報を個別に変更する場合

指定したサービス情報を個別に変更するには，-propsオプションに変更したいサービス情報を指定して実行します。

cscsvcctl -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -name <サービスアダプタのサービスID> -props <プロパティ>

なお，ベーシック認証を使用する場合は，サービス情報変更定義ファイルのベーシック認証に関するすべてのパラメタ（使用可否，ユーザ名，およびパスワード）を設定してください。

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

(3)　サービス情報の削除

cscsvcctlコマンドで変更したサービス情報は，次の場合に削除されます。

削除するサービス情報の行頭に「#」を記述してコメント扱いにしたあと，cscsvcctlコマンドに-setfileオプションを指定して，サービス情報を上書きした場合

クラスタ内のすべてのHCSCサーバがアンセットアップされた場合

cscsvcctlコマンドでサービス情報を変更したサービスアダプタを，開発環境で削除または非公開※にし，運用環境にインポートした場合
ただし，開発環境で削除したサービスアダプタと，サービスIDおよび種別が同じサービスアダプタをインポートした場合，サービス情報は削除されません。

注※　HCSCコンポーネントをHCSCサーバから削除（配備定義を削除）して，システム構成定義を更新することです。

3.1.7　サービス情報を確認する

サービス情報を確認する前提条件，および確認方法について次に説明します。

＜この項の構成＞

(1)　前提条件

(2)　確認方法

(1)　前提条件

リポジトリを共有していないこと

(2)　確認方法

変更したサービス情報を確認するには，運用環境でcscsvclsコマンドを実行します。

cscsvclsコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「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サーバに配備して開始する一連の処理を，開発環境で一括して実行することもできます。ただし，一括実行は，システム開発時，または単体テストから結合テスト時を対象としています。詳細については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「9.5　HCSCコンポーネントをHCSCサーバに配備して開始する処理の一括実行」を参照してください。

＜この項の構成＞

(1)　前提条件

(2)　配備方法

(1)　前提条件

サービスアダプタを配備するには，次の条件を満たす必要があります。

配備先の実行環境のHCSCサーバが起動状態であること
HCSCサーバの状態の確認方法については，「5.2.15　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コマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「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コマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscrepls（リポジトリ情報の表示）」を参照してください。

(b)　指定したサービスアダプタだけを配備する場合

HCSCサーバまたはクラスタに，指定したサービスアダプタだけを配備します。

サービスアダプタの配備先が単一のHCSCサーバか，クラスタを構成するすべてのHCSCサーバかによって実行形式が異なります。

指定したサービスアダプタを単一のHCSCサーバに配備する場合

HCSCサーバ名とサービスアダプタのサービスIDを指定して実行します。

-cscオプションで指定したHCSCサーバに，-nameオプションで指定したサービスアダプタが配備されます。

csccompodeploy -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -name <サービスアダプタのサービスID>

csccompodeployコマンドに指定するHCSCサーバ名およびサービスアダプタのサービスIDは，cscreplsコマンドで確認できます。cscreplsコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscrepls（リポジトリ情報の表示）」を参照してください。

指定したサービスアダプタをクラスタ内のすべてのHCSCサーバに配備する場合

クラスタ名とサービスアダプタのサービスIDを指定して実行します。

-clusterオプションで指定したクラスタ内のすべてのHCSCサーバに，指定したサービスアダプタが配備されます。

csccompodeploy -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -name <サービスアダプタのサービスID>

3.1.9　カスタムアダプタの定義ファイルを運用環境に取得する

-operation getオプションでカスタムアダプタの定義ファイルを運用環境に取得する方法について次に説明します。

このオプションは，開発者がカスタムアダプタを開発，および配備定義したあとで，運用者が定義ファイルを運用環境に取得するときに使用します。

なお，定義ファイルを取得した時点では，定義ファイルを運用環境に設定したことになりません。定義ファイルを運用環境に設定するには，取得後に-operation setオプションを使用する必要があります。

＜この項の構成＞

(1)　コマンドの使用例

(2)　注意事項

(1)　コマンドの使用例

定義ファイルを取得する場合のコマンドの使用例を次に示します。csccmctlコマンドの詳細は，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「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　カスタムアダプタの定義ファイルを運用環境に設定，更新する

運用環境に取得した定義ファイルは，-operation setオプションで運用環境に設定します。すでに定義ファイルを設定している場合は，再度-operation setオプションを実行することで設定内容が更新されます。

-operation setオプションでカスタムアダプタの定義ファイルを設定，および更新する方法について次に説明します。

なお，このオプションで設定した定義ファイルは，運用環境でだけ有効になります。

＜この項の構成＞

(1)　コマンドの使用例

(2)　注意事項

(1)　コマンドの使用例

カスタムアダプタの定義ファイルを設定，および更新する場合のコマンドの使用例を次に示します。csccmctlコマンドの詳細は，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「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サーバがアンセットアップされた場合

開発環境で定義ファイルを設定したカスタムアダプタを削除したり，別のコンポーネントに変更したリポジトリをインポートしたりした場合

(2)　注意事項

-operation setオプションは，コンポーネントの配備前に実行してください。

設定および更新した定義ファイルを持つカスタムアダプタをcsccompoundeployコマンドで削除して，同じサービスIDで異なる種別のカスタムアダプタのリポジトリをインポートする場合，-operation resetオプションで対象のサービスIDのカスタムアダプタが持つ定義ファイルを削除する必要があります。

<リポジトリルート>/manager/custom以下に[-cluster指定値]-[-name指定値]のディレクトリが存在しない場合，コマンド内部でディレクトリが作成されます。

次の場合はエラーになります。

-targetfilenameオプションに設定したファイルが存在しない場合

指定したファイルまでのディレクトリがない場合

-targetfilenameオプションに設定したファイルの読み込みに失敗した場合

運用環境に定義する内容に適さない定義が定義ファイルに含まれている場合

3.1.11　カスタムアダプタの定義ファイルを運用環境から削除する

-operation resetオプションでカスタムアダプタの定義ファイルを削除する方法について次に説明します。

＜この項の構成＞

(1)　コマンドの使用例

(2)　注意事項

(1)　コマンドの使用例

カスタムアダプタの定義ファイルを削除する場合のコマンドの使用例を次に示します。csccmctlコマンドの詳細は，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「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

(2)　注意事項

-operation resetオプションは，コンポーネントの配備前に実行してください。

次の場合はエラーになります。

-targetfilenameオプションに設定したファイルが存在しない場合

-targetfilenameオプションに設定したファイルを削除できない場合

3.1.12　運用環境の定義ファイルの状態を確認する

cscsvclsコマンドを使用することで，変更後の定義ファイルを確認できます。

＜この項の構成＞

(1)　コマンドの使用例

(1)　コマンドの使用例

変更後の定義ファイルを確認する場合のコマンドの使用例を次に示します。cscsvclsコマンドの詳細は，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「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サーバに配備して開始する一連の処理を，開発環境で一括して実行することもできます。ただし，一括実行は，システム開発時，または単体テストから結合テスト時を対象としています。詳細については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「9.5　HCSCコンポーネントをHCSCサーバに配備して開始する処理の一括実行」を参照してください。

＜この項の構成＞

(1)　前提条件

(2)　配備方法

(1)　前提条件

ビジネスプロセスを配備するには，配備先の実行環境のHCSCサーバが起動状態である必要があります。

HCSCサーバの状態の確認方法については，「5.2.15　HCSCサーバの情報を確認する」を参照してください。

(2)　配備方法

ビジネスプロセスを配備するには，運用環境でcsccompodeployコマンドを実行します。

csccompodeployコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「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コマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscrepls（リポジトリ情報の表示）」を参照してください。

(b)　指定したビジネスプロセスだけを配備する場合

HCSCサーバまたはクラスタに，指定したビジネスプロセスだけを配備します。

ビジネスプロセスの配備先が単一のHCSCサーバか，クラスタを構成するすべてのHCSCサーバかによって実行形式が異なります。

指定したビジネスプロセスを単一のHCSCサーバに配備する場合

HCSCサーバ名とビジネスプロセスのサービスIDを指定して実行します。

-cscオプションで指定したHCSCサーバに，-nameオプションで指定したビジネスプロセスが配備されます。

csccompodeploy -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -name <ビジネスプロセスのサービスID>

csccompodeployコマンドに指定するHCSCサーバ名およびビジネスプロセスのサービスIDは，cscreplsコマンドで確認できます。cscreplsコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscrepls（リポジトリ情報の表示）」を参照してください。

指定したビジネスプロセスをクラスタ内のすべてのHCSCサーバに配備する場合

クラスタ名とビジネスプロセスのサービスIDを指定して実行します。

-clusterオプションで指定したクラスタ内のすべてのHCSCサーバに，指定したビジネスプロセスが配備されます。

csccompodeploy -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -name <ビジネスプロセスのサービスID>

3.1.14　ユーザ定義受付を配備する

ユーザ定義受付を実行環境に配備する場合の前提条件，および配備方法について次に説明します。

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

＜この項の構成＞

(1)　前提条件

(2)　配備方法

(1)　前提条件

ユーザ定義受付を配備するには，配備先の実行環境のHCSCサーバが起動状態である必要があります。

HCSCサーバの状態の確認方法については，「5.2.15　HCSCサーバの情報を確認する」を参照してください。

(2)　配備方法

ユーザ定義受付を配備するには，運用環境でcsccompodeployコマンドを実行します。

csccompodeployコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「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コマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscrepls（リポジトリ情報の表示）」を参照してください。

(b)　指定したユーザ定義受付だけを配備する場合

HCSCサーバまたはクラスタに，指定したユーザ定義受付だけを配備します。

ユーザ定義受付の配備先が単一のHCSCサーバか，クラスタを構成するすべてのHCSCサーバかによって実行形式が異なります。

指定したユーザ定義受付を単一のHCSCサーバに配備する場合

HCSCサーバ名とユーザ定義受付の受付IDを指定して実行します。

-cscオプションで指定したHCSCサーバに，-nameオプションで指定したユーザ定義受付が配備されます。

csccompodeploy -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -name <ユーザ定義受付の受付ID>

csccompodeployコマンドに指定するHCSCサーバ名およびユーザ定義受付の受付IDは，cscreplsコマンドで確認できます。cscreplsコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscrepls（リポジトリ情報の表示）」を参照してください。

指定したユーザ定義受付をクラスタ内のすべてのHCSCサーバに配備する場合

クラスタ名とユーザ定義受付の受付IDを指定して実行します。

-clusterオプションで指定したクラスタ内のすべてのHCSCサーバに，指定したユーザ定義受付が配備されます。

csccompodeploy -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -name <ユーザ定義受付の受付ID>

3.1.15　ユーザ定義受付の定義情報を設定する

次に示すユーザ定義受付の定義情報を設定します。

最大同時実行数

占有スレッド数

実行待ちキューのサイズ

ユーザ定義受付の定義情報を設定する前提条件，および設定方法について次に説明します。

注意

ユーザ定義受付およびユーザ定義受付を利用するビジネスプロセスを削除した場合，ここで設定した定義情報は無効となります。削除後に，ユーザ定義受付およびユーザ定義受付を利用するビジネスプロセスを再配備する場合，必ずユーザ定義受付の定義情報を設定し直してください。

＜この項の構成＞

(1)　前提条件

(2)　設定方法

(1)　前提条件

ユーザ定義受付の定義情報を設定するには，HCSCサーバが起動状態である必要があります。

HCSCサーバの状態の確認方法については，「5.2.15　HCSCサーバの情報を確認する」を参照してください。

(2)　設定方法

ユーザ定義受付の定義情報を設定するには，まずユーザ定義受付ランタイム定義ファイルを作成します。ユーザ定義受付ランタイム定義ファイルのテンプレートファイルは，cscurcptnconfig.propertiesのファイル名で次のディレクトリに格納されています。

<Cosminexusのインストールディレクトリ>¥CSC¥config¥manager¥templates¥cscurcptnconfig.properties

テンプレートファイルを任意の場所にコピーしたあと，定義情報を編集して，ユーザ定義受付ランタイム定義ファイルを作成します。ユーザ定義受付ランタイム定義ファイルの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「ユーザ定義受付ランタイム定義ファイル」を参照してください。

ユーザ定義受付ランタイム定義ファイルを作成したら，運用環境でcsccompoconfigコマンドを実行して定義情報を設定します。設定した定義情報は，HCSCコンポーネントを再開始したときに反映されます。csccompoconfigコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「csccompoconfig（HCSCコンポーネントの定義）」を参照してください。

HCSCサーバに配備されているユーザ定義受付に定義情報を設定するか，クラスタ内のHCSCサーバに配備されているユーザ定義受付に定義情報を設定するかによって実行形式が異なります。

HCSCサーバに配備されているユーザ定義受付に定義情報を設定する場合

HCSCサーバ名，およびユーザ定義受付の受付IDを指定して実行します。

指定したHCSCサーバ上のユーザ定義受付に，ユーザ定義受付ランタイム定義ファイルで指定した定義情報が設定されます。

csccompoconfig -user <ログインユーザID> -pass <ログインパスワード> -operation set -propfile <ユーザ定義受付ランタイム定義ファイル> -csc <HCSCサーバ名> -name <受付ID>

クラスタ内のHCSCサーバに配備されているユーザ定義受付に定義情報を設定する場合

クラスタ名，およびユーザ定義受付の受付IDを指定して実行します。

指定したクラスタに配備されているユーザ定義受付に，ユーザ定義受付ランタイム定義ファイルで指定した定義情報が設定されます。

csccompoconfig -user <ログインユーザID> -pass <ログインパスワード> -operation set -propfile <ユーザ定義受付ランタイム定義ファイル> -cluster <クラスタ名> -name <受付ID>

3.1.16　ユーザ定義受付の定義情報を確認する

ユーザ定義受付の定義情報を確認する前提条件，および確認方法について次に説明します。

＜この項の構成＞

(1)　前提条件

(2)　確認方法

(1)　前提条件

ユーザ定義受付の定義情報を確認するには，HCSCサーバが起動状態である必要があります。

HCSCサーバの状態の確認方法については，「5.2.15　HCSCサーバの情報を確認する」を参照してください。

(2)　確認方法

設定したユーザ定義受付の定義情報を確認するには，運用環境で-operationオプションにgetを，-cscオプションにHCSCサーバ名を，-nameにユーザ定義受付の受付IDを指定して，csccompoconfigコマンドを実行します。

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

csccompoconfigコマンドの実行形式を次に示します。

csccompoconfig -user <ログインユーザID> -pass <ログインパスワード> -operation get -csc <HCSCサーバ名> -name <受付ID>

3.1.17　セットアップ後の内容を確認・変更する

HCSCサーバ，サービスアダプタ，ビジネスプロセス，およびユーザ定義受付のセットアップ後の内容を確認する方法については，次の個所を参照してください。

HCSCサーバのセットアップ情報を確認する場合

「5.2.14　HCSCサーバのセットアップ情報を確認する」および「5.2.15　HCSCサーバの情報を確認する」を参照してください。

サービスアダプタの配備情報を確認する場合

「5.2.17　サービスアダプタの情報を確認する」を参照してください。

ビジネスプロセスの配備情報を確認する場合

「5.2.18　ビジネスプロセスの情報を確認する」を参照してください。

ユーザ定義受付の配備情報を確認する場合

「5.2.19　ユーザ定義受付の情報を確認する」を参照してください。

セットアップ情報を確認した結果，すでにセットアップした内容を変更したい場合は，一度アンセットアップしてから再度セットアップします。アンセットアップの方法については，「3.2　システムのアンセットアップ」を参照してください。

注意

HCSCサーバのセットアップ情報を追加・変更する場合，アンセットアップしないで追加・変更できる内容があります。HCSCサーバの追加・変更セットアップの詳細については，「3.1.3(3) セットアップ情報の追加・変更」を参照してください。

3.1.18　データベースとCosminexus RMの両方を使用しない場合のシステムのセットアップ

データベースとCosminexus RMの両方を使用しない場合，実行環境に必要なソフトウェアの設定が，データベースとCosminexus RMの両方を使用する場合と異なります。実行環境に必要なソフトウェアの設定以外は，データベースとCosminexus RMの両方を使用する場合のセットアップと同じです。

＜この項の構成＞

(1)　実行環境に必要なソフトウェアの設定

(1)　実行環境に必要なソフトウェアの設定

データベースとCosminexus RMの両方を使用しない場合の，実行環境に必要なソフトウェアの設定の流れについて，次の図に示します。それぞれの設定方法の詳細については，図の参照先に示す個所を参照してください。

図3-4　実行環境に必要なソフトウェアの設定（データベースとCosminexus RMの両方を使用しない場合）

図中の参照先を示します。

実行環境に必要なソフトウェアの設定 | 参照先マニュアル | 参照個所
Management Serverのセットアップ | このマニュアル | 3.1.2(2)
PRFのセットアップ | 3.1.2(3)
J2EEサーバのセットアップ | 3.1.2(4)
Webサーバ（HTTPサーバ）のセットアップ | 3.1.2(5)
Cosminexus Service Coordinator-Managerのセットアップ | 3.1.2(11)
uCosminexus 日立コード変換 - Server Runtime または uCosminexus 日立コード変換 - Runtimeのセットアップ | 3.1.2(12)

3.1.19　データベースを使用してCosminexus RMを使用しない場合のシステムのセットアップ

データベースを使用してCosminexus RMを使用しない場合，実行環境に必要なソフトウェアの設定が，データベースとCosminexus RMの両方を使用する場合と異なります。実行環境に必要なソフトウェアの設定以外は，データベースとCosminexus RMの両方を使用する場合のセットアップと同じです。

＜この項の構成＞

(1)　実行環境に必要なソフトウェアの設定

(2)　DB Connectorのセットアップ

(1)　実行環境に必要なソフトウェアの設定

データベースを使用してCosminexus RMを使用しない場合の，実行環境に必要なソフトウェアの設定の流れについて，次の図に示します。それぞれの設定方法の詳細については，図の参照先に示す個所を参照してください。

図3-5　実行環境に必要なソフトウェアの設定（データベースを使用してCosminexus RMを使用しない場合）

図中の参照先を示します。

実行環境に必要なソフトウェアの設定 | 参照先マニュアル | 参照個所
データベースのサーバ側のセットアップ | このマニュアル | 3.1.2(1)
Management Serverのセットアップ | 3.1.2(2)
PRFのセットアップ | 3.1.2(3)
J2EEサーバのセットアップ | 3.1.2(4)
Webサーバ（HTTPサーバ）のセットアップ | 3.1.2(5)
データベースのクライアント側のセットアップ | 3.1.2(6)
JDBCドライバのセットアップ | 3.1.2(7)
DB Connectorのセットアップ | 3.1.19(2)
Cosminexus Service Coordinator-Managerのセットアップ | 3.1.2(11)
uCosminexus 日立コード変換 - Server Runtime または uCosminexus 日立コード変換 - Runtimeのセットアップ | 3.1.2(12)

(2)　DB Connectorのセットアップ

HCSCサーバは，データベースと接続するためにDB Connectorを利用します。処理のタイミングやテーブル種別に応じて，データベースアクセスをトランザクション管理する場合と管理しない場合があるため，トランザクションサポート種別がXATransactionまたはLocalTransactionのDB Connectorと，トランザクションサポート種別がNoTransactionであるDB Connectorの，二つのDB Connectorを準備する必要があります。

なお，トランザクションサポート種別がXATransactionまたはLocalTransactionのDB Connectorは，処理性能を向上させるため，Cosminexus RMと連携できるDB Connectorを利用します。

それぞれのDB Connectorの表示名は，HCSCサーバセットアップ定義ファイルの「dbcon-xadisplayname」と「dbcon-nodisplayname」に指定します。HCSCサーバセットアップ定義ファイルの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「HCSCサーバセットアップ定義ファイル」を参照してください。

(a)　DB Connectorのインポート

インポートするDB Connectorは，利用条件を考慮して選択する必要があります。インポートするRARファイルの選択方法を次の表に示します。

表3-15　インポートするRARファイルの選択方法（Cosminexus RMを使用しない場合）

HCSCサーバセットアップ定義ファイルのプロパティ | 利用するデータベース | ライトトランザクション機能の利用の有無
利用する | 利用しない
dbcon-xadisplayname | HiRDB（Version 8）※1 | DBConnector_DABJ_CP.rar | DBConnector_DABJ_XA.rar
HiRDB（Version 8またはVersion 9）※2 | DBConnector_HiRDB_Type4_CP.rar | DBConnector_HiRDB_Type4_XA.rar
Oracle | DBConnector_Oracle_CP.rar | DBConnector_Oracle_XA.rar
dbcon-nodisplayname | HiRDB（Version 8）※1 | DBConnector_DABJ_CP.rar
HiRDB（Version 8またはVersion 9）※2 | DBConnector_HiRDB_Type4_CP.rar
Oracle | DBConnector_Oracle_CP.rar

注※1　JDBCドライバにCosminexus DABroker Libraryを利用する場合です。

注※2　JDBCドライバにHiRDB Type4 JDBC Driverを利用する場合です。

DB Connectorのインポート方法については，マニュアル「Cosminexus アプリケーションサーバ アプリケーション設定操作ガイド」の「4.2　データベースと接続するための設定」を参照してください。また，プロパティ定義については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1　Connector属性ファイル」を参照してください。

ライトトランザクションについては，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「3.14.5　ライトトランザクション」を参照してください。また，設定方法については，マニュアル「Cosminexus アプリケーションサーバ 運用管理ポータル操作ガイド」の「10.9.7　トランザクションの設定」を参照してください。

また，DBアダプタを利用する場合は，DBアダプタが利用するDB Connectorをインポートします。インポートするRARファイルの選択方法を次の表に示します。

表3-16　インポートするRARファイルの選択方法（DBアダプタを利用する場合）

利用するJDBCドライバ
利用するデータベース
ライトトランザクション機能の利用の有無

利用する
利用しない

Cosminexus DABroker Library
HiRDB（Version 8）
DBConnector_DABJ_CP.rar
DBConnector_DABJ_XA.rar

Oracle

HiRDB Type4 JDBC Driver
HiRDB（Version 8またはVersion 9）
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をインポートしたあと，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1　Connector属性ファイル」を参照して，プロパティを定義してください。ただし，次の表に示す内容をプロパティに設定する必要があります。

表3-17　dbcon-xadisplaynameに設定するDB Connector属性ファイルの設定内容（DABroker/Oracle）

設定項目 | 設定値
<display-name>タグ | DB Connector表示名
<config-property>タグに設定するdatabaseNameプロパティ | データベース名※1
<config-property>タグに設定するbufSizeプロパティ | システムで利用する最大の電文長よりも大きな値※2
<transaction-support>タグ | XATransaction※3
LocalTransaction※4

注※1

使用するDB Connectorによって設定値が異なります。設定値については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1　Connector属性ファイル」を参照してください。また，データベースに接続するために必要な情報もあわせて設定してください。

注※2

使用するDB Connectorが次の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

表3-18　dbcon-xadisplaynameに設定するDB Connector属性ファイルの設定内容（HiRDB Type4）

設定項目 | 設定値
<display-name>タグ | DB Connector表示名
<config-property>タグに設定するmaxBinarySizeプロパティ | システムで利用する最大の電文長よりも大きな値※1
<transaction-support>タグ | XATransaction※2
LocalTransaction※3

注※1

LONGVARBINARY_AccessプロパティにREALを指定した場合に指定してください。また，必ず0以外の値を指定してください。

注※2

ライトトランザクション機能を利用しない場合に，次のDB Connectorに対して指定してください。

・DBConnector_HiRDB_Type4_XA.rar

注※3

ライトトランザクション機能を利用する場合に，次のDB Connectorに対して指定してください。

・DBConnector_HiRDB_Type4_CP.rar

注意

データベースに接続するために必要な情報を設定してください。設定値については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1　Connector属性ファイル」を参照してください。

表3-19　dbcon-nodisplaynameに設定するDB Connector属性ファイルの設定内容（DABroker/Oracle）

設定項目 | 設定値
<display-name>タグ | DB Connector表示名
<config-property>タグに設定するdatabaseNameプロパティ | データベース名※1
<config-property>タグに設定するbufSizeプロパティ | システムで利用する最大の電文長よりも大きな値※2
<transaction-support>タグ | NoTransaction※3

注※1

使用するデータベースによって設定値が異なります。設定値については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「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

表3-20　dbcon-nodisplaynameに設定するDB Connector属性ファイルの設定内容（HiRDB Type4）

設定項目 | 設定値
<display-name>タグ | DB Connector表示名
<config-property>タグに設定するmaxBinarySizeプロパティ | システムで利用する最大の電文長よりも大きな値※1
<transaction-support>タグ | NoTransaction※2

注※1

LONGVARBINARY_AccessプロパティにREALを指定した場合に指定してください。また，必ず0以外の値を指定してください。

注※2

使用するDB Connectorが次のDB Connectorに対して指定してください。

・DBConnector_HiRDB_Type4_CP.rar

注意

データベースに接続するために必要な情報を設定してください。設定値については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1　Connector属性ファイル」を参照してください。

表3-21　DBアダプタを利用する場合に設定するConnector属性ファイルの設定内容

設定項目 | 設定値
<display-name>タグ | DB Connector表示名※1
<config-property>タグに設定するdatabaseNameプロパティ | データベース名※2
<transaction-support>タグ | XATransaction
LocalTransaction

注※1

この値は，DBアダプタのアプリケーション統合属性ファイルの<linked-to>タグにも設定します。アプリケーション統合属性ファイルについては，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「5.3.5　DBアダプタを定義する」を参照してください。

注※2

使用するDB Connectorによって設定値が異なります。設定値については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1　Connector属性ファイル」を参照してください。

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

Cosminexus サービスプラットフォームを利用して，すでにセットアップされているシステムをアンセットアップする方法について説明します。

＜この節の構成＞

3.2.1　サービスアダプタを削除する

3.2.2　ビジネスプロセスを削除する

3.2.3　ユーザ定義受付を削除する

3.2.4　HCSCサーバをアンセットアップする

3.2.1　サービスアダプタを削除する

実行環境に配備されているサービスアダプタを削除する場合の前提条件，および削除方法について次に説明します。

なお，HCSCコンポーネントを停止してHCSCサーバから削除する一連の処理を，開発環境で一括して実行することもできます。ただし，一括実行は，システム開発時，または単体テストから結合テスト時を対象としています。詳細については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「9.6　HCSCコンポーネントを停止してHCSCサーバから削除する処理の一括実行」を参照してください。

＜この項の構成＞

(1)　前提条件

(2)　削除方法

(1)　前提条件

サービスアダプタを削除するには，次の条件を満たす必要があります。

HCSCサーバが起動状態であること
HCSCサーバの状態の確認方法については，「5.2.15　HCSCサーバの情報を確認する」を参照してください。

サービスアダプタが停止状態であること
サービスアダプタの状態の確認方法については，「5.2.17　サービスアダプタの情報を確認する」を参照してください。

(2)　削除方法

サービスアダプタを削除するには，運用環境でcsccompoundeployコマンドを実行します。

csccompoundeployコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「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.2.2　ビジネスプロセスを削除する

実行環境に配備されているビジネスプロセスを削除する場合の前提条件，および削除方法について次に説明します。

なお，HCSCコンポーネントを停止してHCSCサーバから削除する一連の処理を，開発環境で一括して実行することもできます。ただし，一括実行は，システム開発時，または単体テストから結合テスト時を対象としています。詳細については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「9.6　HCSCコンポーネントを停止してHCSCサーバから削除する処理の一括実行」を参照してください。

＜この項の構成＞

(1)　前提条件

(2)　削除方法

(1)　前提条件

ビジネスプロセスを削除するには，次の条件を満たす必要があります。

HCSCサーバが起動状態であること
HCSCサーバの状態の確認方法については，「5.2.15　HCSCサーバの情報を確認する」を参照してください。

ビジネスプロセスが停止状態であること
ビジネスプロセスの状態の確認方法については，「5.2.18　ビジネスプロセスの情報を確認する」を参照してください。

(2)　削除方法

ビジネスプロセスを削除するには，運用環境でcsccompoundeployコマンドを実行します。

csccompoundeployコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「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.2.3　ユーザ定義受付を削除する

実行環境に配備されているユーザ定義受付を削除する場合の前提条件，および削除方法について次に説明します。

なお，HCSCコンポーネントを停止してHCSCサーバから削除する一連の処理を，開発環境で一括して実行することもできます。ただし，一括実行は，システム開発時，または単体テストから結合テスト時を対象としています。詳細については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「9.6　HCSCコンポーネントを停止してHCSCサーバから削除する処理の一括実行」を参照してください。

＜この項の構成＞

(1)　前提条件

(2)　削除方法

(1)　前提条件

ユーザ定義受付を削除するには，次の条件を満たす必要があります。

HCSCサーバが起動状態であること
HCSCサーバの状態の確認方法については，「5.2.15　HCSCサーバの情報を確認する」を参照してください。

ユーザ定義受付が停止状態であること
ユーザ定義受付の状態の確認方法については，「5.2.19　ユーザ定義受付の情報を確認する」を参照してください。

(2)　削除方法

ユーザ定義受付を削除するには，運用環境でcsccompoundeployコマンドを実行します。

csccompoundeployコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「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.2.4　HCSCサーバをアンセットアップする

HCSCサーバをアンセットアップすると，セットアップされていた情報が解除されます。アンセットアップされたHCSCサーバが，ほかのHCSCサーバとクラスタを構成していた場合，クラスタから削除されます。

また，アンセットアップ時にアンセットアップ直前のリポジトリ情報がバックアップされます。バックアップされたリポジトリ情報は，必要に応じて開発環境にインポートできます。バックアップはrepository.zipのファイル名で次のディレクトリに格納されます。

<Cosminexusインストールディレクトリ>¥CSC¥spool¥manager¥unsetup_bk¥repository.zip

なお，HCSCサーバをアンセットアップした結果，リポジトリ内に構築されているHCSCサーバが存在しなくなった場合，サービス情報はすべて削除されます。

HCSCサーバのアンセットアップの前提条件，およびアンセットアップ方法について次に説明します。

＜この項の構成＞

(1)　前提条件

(2)　アンセットアップ方法

(1)　前提条件

HCSCサーバをアンセットアップするには，次の条件を満たす必要があります。

アンセットアップするHCSCサーバが停止状態であること
HCSCサーバの状態の確認方法については，「5.2.15　HCSCサーバの情報を確認する」を参照してください。

サービスアダプタ，ビジネスプロセス，およびユーザ定義受付がすべて配備前状態であること
サービスアダプタ，ビジネスプロセス，およびユーザ定義受付の状態の確認方法については，「5.2.17　サービスアダプタの情報を確認する」，「5.2.18　ビジネスプロセスの情報を確認する」，および「5.2.19　ユーザ定義受付の情報を確認する」を参照してください。

バックアップファイル（<Cosminexusインストールディレクトリ>¥CSC¥spool¥manager¥unsetup_bk¥repository.zip）にアクセスしていないこと
バックアップファイルにアクセスしている場合，HCSCサーバのアンセットアップに失敗することがあります。

ほかのコマンドを同時に実行していないこと

(2)　アンセットアップ方法

HCSCサーバをアンセットアップするには，運用環境でcscsvunsetupコマンドを実行します。

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

cscsvunsetupコマンドの実行形式を次に示します。

cscsvunsetup -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名>

注意

クラスタを構成するHCSCサーバのそれぞれの標準受付の種別が異なる場合，設定されている標準受付の種別が少ないHCSCサーバを先にアンセットアップしてください。

HCSCサーバがアンセットアップできなかった場合，エラーになった原因を取り除いたあと，再度アンセットアップしてください。

HCSCサーバをアンセットアップした結果，リポジトリ内に構築されているHCSCサーバが存在しなくなった場合，ビジネスプロセスおよびサービスアダプタと合わせてリポジトリ情報が削除されます。削除前のビジネスプロセスおよびサービスアダプタを継続して開発する場合は，バックアップファイル（repository.zip）をHCSC開発環境にインポートして開発を継続してください。

データベースを利用してアンセットアップする場合，運用環境のリポジトリが別であったとしても，複数のマシンで同時にcscsvsetupコマンド（HCSCサーバのセットアップ）やcscsvunsetupコマンド（HCSCサーバのアンセットアップ）を実行しないでください。

3.3　テスト環境から本番環境への移行手順

テスト環境から本番環境への移行手順を次に示します。

＜この節の構成＞

3.3.1　テスト環境と本番環境でデータベースとCosminexus RMの使用有無が同じ場合の移行手順

3.3.2　データベースとCosminexus RMの両方を使用する環境から両方使用しない環境に移行する場合の移行手順

3.3.3　データベースとCosminexus RMの両方を使用しない環境から両方使用する環境に移行する場合の移行手順

3.3.4　データベースとCosminexus RMの両方を使用する環境からデータベースを使用してCosminexus RMを使用しない環境に移行する場合の移行手順

3.3.5　データベースとCosminexus RMの両方を使用しない環境からデータベースを使用してCosminexus RMを使用しない環境に移行する場合の移行手順

3.3.1　テスト環境と本番環境でデータベースとCosminexus RMの使用有無が同じ場合の移行手順

テスト環境と本番環境で，データベースとCosminexus RMの使用有無が同じ場合の移行手順を次に示します。移行の概要については，「1.3(1) ケース1：テスト環境と本番環境でデータベースとCosminexus RMの使用有無を同じ設定で構築した場合」を参照してください。

図3-6　移行手順（テスト環境と本番環境でデータベースとCosminexus RMの使用有無が同じ場合）

テスト環境のHCSCサーバをセットアップし，システムの構成を定義します。
HCSC簡易セットアップ機能を使うことで，HCSCサーバのセットアップや，システムの構成が定義できます。ただし，データベースを使用してCosminexus RMを使用しない構成を構築する場合，HCSC簡易セットアップ機能は使用できません。

運用環境からリポジトリをエクスポートし，テスト環境で定義したシステム構成定義を開発環境にインポートします。

開発環境で，HCSCコンポーネントを作成します。

テスト環境で定義したシステム構成定義を基に，システム構成のどこに配備するかを定義し更新します（配備定義）。

開発環境で定義した配備定義を含むリポジトリをエクスポートし，運用環境にインポートします。

開発環境で定義した配備定義を基に，テスト環境にHCSCコンポーネントを配備します。

本番環境のHCSCサーバをセットアップし，システムの構成を定義します。
テスト環境と本番環境で，データベースとCosminexus RMの使用有無の設定を同じにします。
また，テスト環境と本番環境のSOAPモードを同じにしてください。

開発環境で定義した配備定義を含むリポジトリをエクスポートし，運用環境にインポートします。
標準インポートを使用すると，HCSCサーバ名やIPアドレスなどが異なる場合でも，テスト環境のリポジトリをそのまま本番環境へ移行できます。

開発環境で定義した配備定義を基に，本番環境にHCSCコンポーネントを配備します。

3.3.2　データベースとCosminexus RMの両方を使用する環境から両方使用しない環境に移行する場合の移行手順

テスト環境では，データベースとCosminexus RMの両方を使用して，本番環境では，データベースとCosminexus RMの両方を使用しない場合の移行手順を次に示します。移行の概要については，「1.3(3) ケース3：テスト環境と本番環境でデータベースとCosminexus RMの使用有無を異なる設定で構築した場合（リポジトリを作成し直すとき）」を参照してください。

図3-7　移行手順（データベースとCosminexus RMの両方を使用する環境から両方使用しない環境に移行する場合）

テスト環境のHCSCサーバをセットアップし，システムの構成を定義します。
HCSC簡易セットアップ機能を使うことで，HCSCサーバのセットアップや，システムの構成が定義できます。HCSC簡易セットアップ機能を使用してHCSCサーバをセットアップする場合，標準モデルを選択します。

運用環境からリポジトリをエクスポートし，テスト環境で定義したシステム構成定義を開発環境にインポートします。

開発環境で，HCSCコンポーネントを作成します。

テスト環境で定義したシステム構成定義を基に，システム構成のどこに配備するかを定義し更新します（配備定義）。
このとき，配備定義の基になるシステム構成定義は，データベースとCosminexus RMの両方を使用する設定になっています。

開発環境で定義した配備定義を含むリポジトリをエクスポートし，運用環境にインポートします。

開発環境で定義した配備定義を基に，テスト環境にHCSCコンポーネントを配備します。

本番環境のHCSCサーバをセットアップし，システムの構成を定義します。
HCSCサーバセットアップ定義ファイルで，db-useプロパティに「OFF」を，rm-useプロパティに「OFF」を設定します。
また，テスト環境と本番環境のSOAPモードを同じにしてください。

テスト環境で定義したシステム構成定義およびサービス定義を開発環境にインポートします。

本番環境の運用環境からリポジトリをエクスポートし，本番環境で定義したシステム構成定義を開発環境にインポートします。

本番環境で定義したシステム構成定義を基に，システム構成のどこに配備するかを定義し更新します（配備定義）。
このとき，配備定義の基になるシステム構成定義は，データベースとCosminexus RMの両方を使用しない設定になっています。
なお，非同期受付，非同期サービスアダプタ，および永続化ビジネスプロセスを配備定義した場合は，エラーになります。

開発環境で定義した配備定義を含むリポジトリをエクスポートし，運用環境にインポートします。
テスト環境のリポジトリ（手順8.でインポートしたリポジトリ）に対して，本番環境用のシステム構成定義を設定したリポジトリ（手順9.でインポートしたリポジトリ）を，本番環境へ移行します。

開発環境で定義した配備定義を基に，本番環境にHCSCコンポーネントを配備します。
本番環境では，データベースとCosminexus RMの両方を使用しない構成で配備されます。

3.3.3　データベースとCosminexus RMの両方を使用しない環境から両方使用する環境に移行する場合の移行手順

テスト環境では，データベースとCosminexus RMの両方を使用しないで，本番環境では，データベースとCosminexus RMの両方をする場合の移行手順を次に示します。移行の概要については，「1.3(2) ケース2：テスト環境と本番環境でデータベースとCosminexus RMの使用有無を異なる設定で構築した場合（リポジトリをそのまま移行できるとき）」を参照してください。

図3-8　移行手順（データベースとCosminexus RMの両方を使用しない環境から両方使用する環境に移行する場合）

テスト環境のHCSCサーバをセットアップし，システムの構成を定義します。
HCSC簡易セットアップ機能を使うことで，HCSCサーバのセットアップや，システムの構成が定義できます。HCSC簡易セットアップ機能を使用してHCSCサーバをセットアップする場合，ESBモデルを選択します。

運用環境からリポジトリをエクスポートし，テスト環境で定義したシステム構成定義を開発環境にインポートします。

開発環境で，HCSCコンポーネントを作成します。

テスト環境で定義したシステム構成定義を基に，システム構成のどこに配備するかを定義し更新します（配備定義）。
このとき，配備定義の基になるシステム構成定義は，データベースとCosminexus RMの両方を使用しない設定になっています。

開発環境で定義した配備定義を含むリポジトリをエクスポートし，運用環境にインポートします。

開発環境で定義した配備定義を基に，テスト環境にHCSCコンポーネントを配備します。

本番環境のHCSCサーバをセットアップし，システムの構成を定義します。
HCSCサーバセットアップ定義ファイルで，db-useプロパティに「ON」を，rm-useプロパティに「ON」を設定します。
また，テスト環境と本番環境のSOAPモードを同じにしてください。

開発環境で定義した配備定義を含むリポジトリをエクスポートし，運用環境にインポートします。
標準インポートを使用すると，HCSCサーバ名やIPアドレスなどが異なる場合でも，テスト環境のリポジトリをそのまま本番環境へ移行できます。

開発環境で定義した配備定義を基に，本番環境にHCSCコンポーネントを配備します。
本番環境では，手順7.で定義したシステム構成が優先されるため，データベースとCosminexus RMの両方を使用する構成で配備されます。

3.3.4　データベースとCosminexus RMの両方を使用する環境からデータベースを使用してCosminexus RMを使用しない環境に移行する場合の移行手順

テスト環境では，データベースとCosminexus RMの両方を使用して，本番環境では，データベースを使用してCosminexus RMを使用しない場合の移行手順を次に示します。移行の概要については，「1.3(3) ケース3：テスト環境と本番環境でデータベースとCosminexus RMの使用有無を異なる設定で構築した場合（リポジトリを作成し直すとき）」を参照してください。

図3-9　移行手順（データベースとCosminexus RMの両方を使用する環境からデータベースを使用してCosminexus RMを使用しない環境に移行する場合）

テスト環境のHCSCサーバをセットアップし，システムの構成を定義します。
HCSC簡易セットアップ機能を使うことで，HCSCサーバのセットアップや，システムの構成が定義できます。HCSC簡易セットアップ機能を使用してHCSCサーバをセットアップする場合，標準モデルを選択します。実行履歴を使用しない場合，ESBモデルを選択することもできます。ESBモデルを選択する場合の移行手順については，「3.3.5　データベースとCosminexus RMの両方を使用しない環境からデータベースを使用してCosminexus RMを使用しない環境に移行する場合の移行手順」を参照してください。

運用環境からリポジトリをエクスポートし，テスト環境で定義したシステム構成定義を開発環境にインポートします。

開発環境で，HCSCコンポーネントを作成します。

テスト環境で定義したシステム構成定義を基に，システム構成のどこに配備するかを定義し更新します（配備定義）。
このとき，配備定義の基になるシステム構成定義は，データベースとCosminexus RMの両方を使用する設定になっています。

開発環境で定義した配備定義を含むリポジトリをエクスポートし，運用環境にインポートします。

開発環境で定義した配備定義を基に，テスト環境にHCSCコンポーネントを配備します。

本番環境のHCSCサーバをセットアップし，システムの構成を定義します。
HCSCサーバセットアップ定義ファイルで，db-useプロパティに「ON」を，rm-useプロパティに「OFF」を設定します。
また，テスト環境と本番環境のSOAPモードを同じにしてください。

テスト環境で定義したシステム構成定義およびサービス定義を開発環境にインポートします。

本番環境の運用環境からリポジトリをエクスポートし，本番環境で定義したシステム構成定義を開発環境にインポートします。

本番環境で定義したシステム構成定義を基に，システム構成のどこに配備するかを定義し更新します（配備定義）。
このとき，配備定義の基になるシステム構成定義は，データベースを使用してCosminexus RMを使用しない設定になっています。
なお，非同期受付，非同期サービスアダプタ，および永続化ビジネスプロセスを配備定義した場合は，エラーになります。

開発環境で定義した配備定義を含むリポジトリをエクスポートし，運用環境にインポートします。
テスト環境のリポジトリ（手順8.でインポートしたリポジトリ）に対して，本番環境用のシステム構成定義を設定したリポジトリ（手順9.でインポートしたリポジトリ）を，本番環境へ移行します。

開発環境で定義した配備定義を基に，本番環境にHCSCコンポーネントを配備します。
本番環境では，データベースを使用してCosminexus RMを使用しない構成で配備されます。

3.3.5　データベースとCosminexus RMの両方を使用しない環境からデータベースを使用してCosminexus RMを使用しない環境に移行する場合の移行手順

テスト環境では，データベースとCosminexus RMの両方を使用しないで，本番環境では，データベースを使用してCosminexus RMを使用しない場合の移行手順を次に示します。移行の概要については，「1.3(2) ケース2：テスト環境と本番環境でデータベースとCosminexus RMの使用有無を異なる設定で構築した場合（リポジトリをそのまま移行できるとき）」を参照してください。

図3-10　移行手順（データベースとCosminexus RMの両方を使用しない環境からデータベースを使用してCosminexus RMを使用しない環境に移行する場合）

テスト環境のHCSCサーバをセットアップし，システムの構成を定義します。
HCSC簡易セットアップ機能を使うことで，HCSCサーバのセットアップや，システムの構成が定義できます。HCSC簡易セットアップ機能を使用してHCSCサーバをセットアップする場合，ESBモデルを選択します。

運用環境からリポジトリをエクスポートし，テスト環境で定義したシステム構成定義を開発環境にインポートします。

開発環境で，HCSCコンポーネントを作成します。

テスト環境で定義したシステム構成定義を基に，システム構成のどこに配備するかを定義し更新します（配備定義）。
このとき，配備定義の基になるシステム構成定義は，データベースとCosminexus RMの両方を使用しない設定になっています。

開発環境で定義した配備定義を含むリポジトリをエクスポートし，運用環境にインポートします。

開発環境で定義した配備定義を基に，テスト環境にHCSCコンポーネントを配備します。

本番環境のHCSCサーバをセットアップし，システムの構成を定義します。
HCSCサーバセットアップ定義ファイルで，db-useプロパティに「ON」を，rm-useプロパティに「OFF」を設定します。
また，テスト環境と本番環境のSOAPモードを同じにしてください。

開発環境で定義した配備定義を含むリポジトリをエクスポートし，運用環境にインポートします。
標準インポートを使用すると，HCSCサーバ名やIPアドレスなどが異なる場合でも，テスト環境のリポジトリをそのまま本番環境へ移行できます。

開発環境で定義した配備定義を基に，本番環境にHCSCコンポーネントを配備します。
本番環境では，手順7.で定義したシステム構成が優先されるため，データベースを使用してCosminexus RMを使用しない構成で配備されます。

3.4　本番環境の簡易セットアップ

HCSC本番環境簡易セットアップ機能を利用すると，本番環境に必要なさまざまな情報を自動的に設定できます。また，HCSC本番環境簡易セットアップ機能で設定した情報を容易に変更したり，HCSC本番環境簡易セットアップ機能を利用してセットアップした本番環境を自動的にアンセットアップしたりできます。

HCSC本番環境簡易セットアップ機能を利用すると，本番環境の構築で必要となるさまざまなコマンドを意識することなく，一括で構築することができます。また，HCSC本番環境簡易セットアップ機能で設定した情報を有効にしたり変更したりする場合や，HCSC本番環境簡易セットアップ機能を利用してセットアップした本番環境を容易にアンセットアップする場合も，コマンドを意識することなく実行できます。

ここでは，HCSC本番環境簡易セットアップ機能の概要と利用方法について説明します。

＜この節の構成＞

3.4.1　HCSC本番環境簡易セットアップ機能で構築できる環境

3.4.2　HCSC本番環境簡易セットアップ機能を利用したシステムのセットアップの流れ

3.4.3　HCSC本番環境簡易セットアップ機能の実行

3.4.4　HCSC本番環境簡易セットアップ機能でセットアップした本番環境の運用

3.4.5　HCSC本番環境簡易セットアップで使用する定義ファイル

3.4.1　HCSC本番環境簡易セットアップ機能で構築できる環境

HCSC本番環境簡易セットアップ機能で構築できる環境機能を利用して構築される本番環境は，次の図のような構成になります。次の図に示すプロセス以外のものは，HCSC本番環境簡易セットアップ機能を利用してセットアップできません。次の図に示すプロセス以外のものを本番環境で利用する場合は，HCSC本番環境簡易セットアップ機能を利用しない方法（以降，通常の方法）でセットアップしてください。

図3-11　HCSC本番環境簡易セットアップ機能を利用して構築される本番環境の構成

HCSC本番環境簡易セットアップ機能を利用すると，図3-11に示す本番環境の各プロセスに，ユーザID，パスワード，ポート番号，ホスト名などの情報を自動的に設定できます。HCSC本番環境簡易セットアップ機能を利用した場合に本番環境に設定される情報の詳細については，「3.4.4　HCSC本番環境簡易セットアップ機能でセットアップした本番環境の運用」を参照してください。

なお，HCSC本番環境簡易セットアップ機能を利用して環境を構築する場合，次の点に注意してください。

HCSC本番環境簡易セットアップ機能では，リモートの実行環境を構築できません。

HCSC本番環境簡易セットアップ機能とHCSC簡易セットアップ機能（テスト環境の構築）は併用できません。すでにどちらかの機能を利用してセットアップした環境で，別のセットアップ機能を利用する場合は，セットアップ済みの環境をいったんアンセットアップして，そのあとに別のセットアップ機能を利用してセットアップしてください。

HCSC本番環境簡易セットアップ機能を利用して構築した環境にセットアップできるHCSCサーバは1台だけです。2台目のHCSCサーバはセットアップしないでください。

HCSC本番環境簡易セットアップ機能を利用して構築する環境は，ほかのマシンから操作できません。ほかのマシンから運用操作する場合は，cscsvsetupコマンドを利用してセットアップしてください。cscsvsetupコマンドを利用したセットアップ方法については，「3.1.3　HCSCサーバをセットアップする」を参照してください。

HCSC本番環境簡易セットアップ機能を利用してセットアップまたはアンセットアップした場合，セットアップまたはアンセットアップが正常に終了していないとバージョンアップできません。

また，UNIXの場合は次の点にも注意してください。

上書きインストール時にCosminexus Component Container管理者を変更する場合は，次のディレクトリ配下のファイル属性をCosminexus Component Container管理者と同じように変更してください。

リポジトリルート配下のディレクトリ

ログディレクトリ配下のディレクトリ

応答電文出力ディレクトリ配下のディレクトリ

システム管理情報ディレクトリ配下のディレクトリ

SQLスクリプトファイルのディレクトリ

SOAP Fault動作定義ファイルのディレクトリ

ユーザ電文トレースのディレクトリ

ファイル属性の変更方法については，「付録A　Cosminexus Service Coordinator管理者の変更方法」を参照してください。
なお，ディレクトリおよびディレクトリ配下のファイルには，次のように権限を設定してください。

上記のディレクトリおよびディレクトリ配下のファイル

すべてのユーザに対して書き込み権限を付与してください。

上記のディレクトリの上位のディレクトリ

実行権限を付与してください。ただし，上記のディレクトリをデフォルトから変更していない場合，実行権限を付与する必要はありません。

root権限を持たないCosminexus Component Container管理者に変更する場合は，ポート番号を1024以上に指定してください。

3.4.2　HCSC本番環境簡易セットアップ機能を利用したシステムのセットアップの流れ

HCSC本番環境簡易セットアップ機能を利用したシステムのセットアップの流れについて，次の図に示します。

図3-12　セットアップの流れ（HCSC本番環境簡易セットアップ機能を利用した場合）

注意

OSの起動と同時に，Management Serverおよび運用管理エージェントを自動起動するように設定する必要があります。

HCSC本番環境簡易セットアップ機能を利用してセットアップする場合の作業について次に説明します。

＜この項の構成＞

(1)　本番環境のセットアップ

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

(3)　サービス情報の変更

(4)　サービスアダプタ，ビジネスプロセス，およびユーザ定義受付の配備

(5)　ユーザ定義受付の定義情報の変更

(6)　サーバの定義情報の変更

(1)　本番環境のセットアップ

HCSC本番環境簡易セットアップ機能を利用して本番環境をセットアップします。HCSC本番環境簡易セットアップ機能を利用して本番環境をセットアップするには，テンプレートファイルを使用して定義ファイルを作成する必要があります。本番環境のセットアップについては，「3.4.3(1) 本番環境のセットアップ」を参照してください。

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

開発環境で作成したリポジトリを運用環境にインポートします。リポジトリのインポートについては，「4.3　リポジトリのインポート」を参照してください。

(3)　サービス情報の変更

HCSC本番環境簡易セットアップ機能を利用してセットアップしたサービス情報を変更します。セットアップしたサービス情報の変更については，「3.4.3(2) セットアップした情報の変更」を参照してください。

(4)　サービスアダプタ，ビジネスプロセス，およびユーザ定義受付の配備

サービスアダプタ，ビジネスプロセス，およびユーザ定義受付を実行環境に配備します。サービスアダプタ，ビジネスプロセス，およびユーザ定義受付の配備については，「3.1.8　サービスアダプタを配備する」，「3.1.13　ビジネスプロセスを配備する」，および「3.1.14　ユーザ定義受付を配備する」を参照してください。

(5)　ユーザ定義受付の定義情報の変更

HCSC本番環境簡易セットアップ機能を利用してセットアップしたユーザ定義受付の定義情報を変更します。セットアップしたユーザ定義受付の定義情報の変更については，「3.4.3(2) セットアップした情報の変更」を参照してください。

(6)　サーバの定義情報の変更

本番環境のセットアップ後に，任意のタイミングでサーバの定義情報を変更します。サーバの定義情報の変更については，「3.4.3(2) セットアップした情報の変更」を参照してください。

3.4.3　HCSC本番環境簡易セットアップ機能の実行

HCSC本番環境簡易セットアップ機能を利用した本番環境のセットアップ，セットアップした情報の変更，およびアンセットアップの方法について説明します。

＜この項の構成＞

(1)　本番環境のセットアップ

(2)　セットアップした情報の変更

(3)　本番環境のアンセットアップ

(4)　セットアップした本番環境の情報を変更またはアンセットアップする場合の注意事項

(1)　本番環境のセットアップ

HCSC本番環境簡易セットアップ機能を利用して本番環境をセットアップする場合の前提条件，およびセットアップ方法について説明します。

(a)　前提条件

本番環境をセットアップするための前提条件を次に示します。

HCSC本番環境簡易セットアップ機能を利用するときのシステムの状態

HCSC本番環境簡易セットアップ機能を利用して本番環境をセットアップする場合，システムが次のどれかの状態である必要があります。

Cosminexusを新規にインストールした直後であること

HCSC本番環境簡易セットアップ機能を利用して本番環境を一度セットアップした場合，HCSC本番環境簡易セットアップ機能を利用してアンセットアップしていること

テスト環境の簡易セットアップ機能を利用してテスト環境を一度セットアップした場合，テスト環境の簡易セットアップ機能を利用してアンセットアップしていること

環境変数の設定

HCSC本番環境簡易セットアップ機能を利用して本番環境をセットアップするには，環境変数を設定している必要があります。環境変数の詳細については，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「7.3.2　環境変数の詳細」を参照してください。

(b)　セットアップ方法

HCSC本番環境簡易セットアップ機能を利用して本番環境をセットアップするには，テンプレートファイルを使用して定義ファイルを作成する必要があります。本番環境のセットアップ方法を次に示します。

テンプレートファイルを任意のディレクトリ（準備環境）にコピーします。
コピーするテンプレートファイルとテンプレートファイルの格納場所については，「3.4.5　HCSC本番環境簡易セットアップで使用する定義ファイル」を参照してください。

テンプレートファイルを編集し，定義ファイルを作成します。
編集するテンプレートファイルについては，「3.4.5　HCSC本番環境簡易セットアップで使用する定義ファイル」を参照してください。

2.で作成した定義ファイルを準備環境から本番環境の任意のディレクトリにコピーします。

cscsetupコマンドを実行し，本番環境をセットアップします。
-setupオプションに定義ファイルの格納先ディレクトリを指定して実行します。

cscsetup -setup <定義ファイルの格納先ディレクトリ>

cscsetupコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscsetup（本番環境の簡易セットアップ）」を参照してください。

Hitachi Web Server定義ファイルを変更します。
変更する定義ファイルについては，「3.4.5　HCSC本番環境簡易セットアップで使用する定義ファイル」を参照してください。

(2)　セットアップした情報の変更

HCSC本番環境簡易セットアップ機能を利用してセットアップした情報は変更することができます。変更できる情報を次に示します。

サービス情報

ユーザ定義受付の定義情報

サーバの定義情報

HCSC本番環境簡易セットアップ機能を利用してセットアップした情報を変更する場合の前提条件，および変更方法について説明します。

(a)　前提条件

HCSC本番環境簡易セットアップ機能を利用してセットアップした情報を変更するための前提条件を次に示します。

HCSC本番環境簡易セットアップ機能を利用してセットアップした本番環境であること。

すべての論理サーバが停止状態であること。

また，変更する情報がサービス情報またはユーザ定義受付の定義情報の場合，次の条件を満たす必要があります。

サービス情報を変更する場合

開発環境からリポジトリをインポートしていること。

HCSCコンポーネントが未配備状態であること。

ユーザ定義受付の定義情報を変更する場合

HCSCコンポーネントが配備状態であること。

(b)　変更方法

HCSC本番環境簡易セットアップ機能を利用してセットアップした情報を変更する方法を次に示します。

セットアップ時に準備環境で作成した定義ファイルに変更する情報を反映し，定義ファイルを変更します。
変更する定義ファイルは，変更する情報によって次のように異なります。

サービス情報：サービス情報変更定義ファイル（cscadpconfig.properties）

ユーザ定義受付の定義情報：ユーザ定義受付ランタイム定義ファイル（cscurcptnconfig_id.properties）

サーバの定義情報：簡易構築定義ファイル（SOA.xml）

変更する定義ファイルの詳細については，「3.4.5　HCSC本番環境簡易セットアップで使用する定義ファイル」を参照してください。

1.で変更した定義ファイルを準備環境から本番環境の任意のディレクトリにコピーします。
定義ファイルが格納されているディレクトリをコピーしてください。

cscsetupコマンドを実行し，本番環境に設定した情報を変更します。
-changeオプションに定義ファイルの格納先ディレクトリを指定して実行します。

cscsetup -change <定義ファイルの格納先ディレクトリ>

cscsetupコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscsetup（本番環境の簡易セットアップ）」を参照してください。

(3)　本番環境のアンセットアップ

HCSC本番環境簡易セットアップ機能を利用してセットアップした本番環境をアンセットアップする場合の前提条件，およびアンセットアップ方法について説明します。

注意

HCSC本番環境簡易セットアップ機能を利用してセットアップした本番環境をアンセットアップする場合，snapshotlog.conf，snapshotlog2.conf，c4websv.cfg，およびc4webcom.cfg以外のファイルは，インストール時の状態に戻ります。そのため，ユーザが手動で変更したファイルは，あらかじめバックアップを取ってからアンセットアップを実行してください。

(a)　前提条件

HCSC本番環境簡易セットアップ機能を利用してセットアップした本番環境をアンセットアップするための前提条件を次に示します。

HCSC本番環境簡易セットアップ機能を利用してセットアップした直後の状態であること（HCSCコンポーネントが未配備状態であること）。

Management Server，および運用管理エージェントが起動していること。

(b)　アンセットアップ方法

HCSC本番環境簡易セットアップ機能を利用してセットアップした本番環境をアンセットアップするには，cscsetupコマンドに-unsetupオプションを指定して実行します。

cscsetup -unsetup

cscsetupコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscsetup（本番環境の簡易セットアップ）」を参照してください。

(4)　セットアップした本番環境の情報を変更またはアンセットアップする場合の注意事項

セットアップした本番環境の情報を変更またはアンセットアップする場合の注意事項について説明します。

(a)　HCSC本番環境簡易セットアップ機能を利用してセットアップした場合の注意事項

障害が発生した場合や急な問題に対応しなければならない場合に，HCSC本番環境簡易セットアップ機能を利用してセットアップした本番環境を，通常の方法で変更またはアンセットアップすることがあります。HCSC本番環境簡易セットアップ機能を利用してセットアップした情報の変更およびアンセットアップについて，通常の方法との関係を次に説明します。

HCSC本番環境簡易セットアップ機能を利用してセットアップした情報の変更

HCSC本番環境簡易セットアップ機能を利用してセットアップした情報の変更を次の図に示します。

図3-13　HCSC本番環境簡易セットアップ機能を利用してセットアップした情報の変更

HCSC本番環境簡易セットアップ機能を利用してセットアップした情報を通常の方法で変更した場合，変更した内容をセットアップ時に作成した定義ファイルに反映し，本番環境の定義情報を変更する必要があります。ただし，Cosminexus サービスプラットフォームに関する次の定義ファイルの情報は，変更する必要がありません。

HCSC-Manager定義ファイル（cscmng.properties）

HCSC-Managerコマンド共通定義ファイル（csccmd.properties）

HCSCサーバ構成定義ファイル（cscsvsetup.xml）

HCSCサーバセットアップ定義ファイル（cscsvsetup.properties）

サーバランタイム定義ファイル（cscsvconfig.properties）

ユーザ定義受付ランタイム定義ファイル（cscurcptnconfig_id.properties）

サービス情報変更定義ファイル（cscadpconfig.properties）

定義情報の変更方法については，「(2) セットアップした情報の変更」を参照してください。

HCSC本番環境簡易セットアップ機能を利用してセットアップした本番環境のアンセットアップ

HCSC本番環境簡易セットアップ機能を利用してセットアップした本番環境のアンセットアップを次の図に示します。

図3-14　HCSC本番環境簡易セットアップ機能を利用してセットアップした本番環境のアンセットアップ

HCSC本番環境簡易セットアップ機能を利用してセットアップした本番環境を通常の方法でアンセットアップした場合，次のようにHCSC本番環境簡易セットアップ機能を利用して再度アンセットアップし直す必要があります。

通常の方法でアンセットアップしたあと，通常の方法で再度セットアップし直し，HCSC本番環境簡易セットアップ機能を利用してセットアップしたときの状態に戻します。

HCSC本番環境簡易セットアップ機能を利用して，アンセットアップします。

(b)　HCSC本番環境簡易セットアップ機能を利用しないでセットアップした場合の注意事項

HCSC本番環境簡易セットアップ機能を利用しないでセットアップした本番環境は，HCSC本番環境簡易セットアップ機能を利用して変更およびアンセットアップできません。

3.4.4　HCSC本番環境簡易セットアップ機能でセットアップした本番環境の運用

HCSC本番環境簡易セットアップ機能を利用してセットアップした本番環境の運用方法，および運用に必要な情報について説明します。

＜この項の構成＞

(1)　本番環境の起動と停止

(2)　本番環境の運用に必要な情報

(1)　本番環境の起動と停止

本番環境の起動および停止方法について，次の表に示します。

表3-22　本番環境の起動および停止方法

起動・停止の対象
起動・停止方法

Management Server

運用管理エージェント

本番環境のマシンを起動すると，自動的に起動されます。また，本番環境のマシンを停止すると，自動的に停止されます。

Cosminexus Performance Tracer

J2EEサーバ

HCSCサーバ

コマンドプロンプトで次のコマンドを実行します。
起動する場合：

<Cosminexusのインストールディレクトリ>¥CSC¥bin¥cscsvstart.bat -system

停止する場合：

<Cosminexusインストールディレクトリ>¥CSC¥bin¥cscsvstop.bat -system

Cosminexus Performance Tracer，およびJ2EEサーバの起動・停止方法および運用方法の詳細については，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」を参照してください。
HCSCサーバの起動・停止方法および運用方法の詳細については，「5.2.4　HCSCサーバを起動する」および「5.2.31　HCSCサーバを停止する」を参照してください。

(2)　本番環境の運用に必要な情報

HCSC本番環境簡易セットアップ機能を利用してセットアップすると，本番環境の運用に必要な情報が自動的に設定されます。HCSC本番環境簡易セットアップ機能を利用してセットアップした本番環境に設定される情報を次に説明します。なお，固定値が記載されている項目については，HCSC本番環境簡易セットアップ機能では変更できません。

(a)　ユーザIDおよびパスワードの情報

HCSC本番環境簡易セットアップ機能でセットアップした本番環境に設定されるユーザIDおよびパスワードの情報を次の表に示します。

表3-23　本番環境に設定されるユーザ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-24　本番環境に設定されるポート番号

設定先 | 設定されるポート番号 | デフォルト値 | 説明
Management Server | HCSCサーバ運用ポート番号 | 28099 | HCSC-ManagerからManagement Serverにアクセスする場合に使用するポート番号
論理サーバ運用ポート番号 | 28080 | Smart Composerまたは運用管理ポータル画面からManagement Serverにアクセスする場合に使用するポート番号
終了要求受信ポート番号 | 28005 | Management Serverが内部の管理用に利用するポート番号
内部通信ポート番号 | 28009 | Management Serverが内部の管理用に利用するポート番号
運用管理エージェント | エージェント接続ポート番号 | 20295 | Management Serverから運用管理エージェントにアクセスする場合に使用する内部管理用のポート番号
J2EEサーバ | SessionBean受付ポート番号 | 900 | Management ServerからHCSCサーバに，またはサービスリクエスタから標準受付（SessionBean）にアクセスする場合に使用するポート番号
稼働確認ポート番号 | 23152 | HCSCサーバが内部の管理用に利用するポート番号
簡易Webサーバポート番号 | 8080 | HCSCサーバが内部の管理用に利用するポート番号
Webサーバ | リクエスト受付ポート番号 | 80 | リクエストを受け付けるポート番号

(c)　名称の情報

HCSC本番環境簡易セットアップ機能でセットアップした本番環境に設定されるホスト名やサーバ名などの情報を次の表に示します。表に示す以外の名称については，各テンプレートファイルに設定されている値を参照してください。

表3-25　本番環境に設定される名称

設定先 | 設定される名称 | 固定値 | 説明
Management Server | ホスト名 | localhost | Management Serverのホスト名
HCSC-Manager | Cosminexus Manager名 | Manager | HCSC-ManagerがCosminexus Managerを認識するためのHCSC-Manager独自の識別名
PRF | サーバ名 | PRF | 論理サーバまたはクラスタを識別するための名称
J2EEサーバ | サーバ名 | J2EEServer | HCSCサーバをセットアップするJ2EEサーバの名称
クラスタ | クラスタ名 | Cluster | クラスタの名称
HCSCサーバ | HCSCサーバ名 | HCSC | HCSCサーバの名称
Webサーバ | サーバ名 | WebServer | 論理サーバまたはクラスタを識別するための名称

(d)　受付の情報

HCSC本番環境簡易セットアップ機能でセットアップした本番環境に設定される受付の情報を次の表に示します。

表3-26　本番環境に設定される受付情報

受付の情報 | 固定値
標準の同期受付（SessionBean） | OFF
標準の同期受付（Webサービス） | ON
標準の非同期受付（MDB（WS-R）） | OFF
標準の非同期受付（MDB（DBキュー）） | OFF
ユーザ定義受付 | ON

3.4.5　HCSC本番環境簡易セットアップで使用する定義ファイル

HCSC本番環境簡易セットアップ機能を利用してセットアップする場合，テンプレートファイルを利用して定義ファイルを作成します。また，セットアップした情報を変更する場合，作成した定義ファイルを変更します。なお，テンプレートファイルは次のディレクトリに格納されています。

<Cosminexusのインストールディレクトリ>¥CSC¥config¥manager¥templates¥hsetup¥esb

HCSC本番環境簡易セットアップで使用する定義ファイルとテンプレートファイルの提供有無を次の表に示します。なお，この項では，定義ファイルを作成・変更するときに編集する項目，およびHCSC本番環境簡易セットアップでデフォルト値と異なる値が設定される項目について説明します。ここで説明する以外の項目および定義ファイルの詳細については，表の参照先に示すマニュアルを参照してください。

表3-27　HCSC本番環境簡易セットアップで使用する定義ファイルとテンプレートファイルの提供有無

項番 | ファイル名 | セットアップ時 | 変更時※ | テンプレートファイル | 参照先マニュアル | 参照個所
1 | Manager設定ファイル（manager.cfg） | ◎ | － | あり | Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義) | 10.10
2 | 運用管理エージェントプロパティファイル（adminagent.properties） | ◎ | － | あり | 10.2
3 | Management Server環境設定ファイル（mserver.properties） | ◎ | － | あり | 10.7
4 | クライアント共通設定プロパティファイル（cmxclient.properties） | ◎ | － | あり | 4.4
5 | クライアント側共通定義ファイル（mngsvrutilcl.properties） | ◎ | － | あり | 10.17
6 | snapshotログ一次送付対象定義ファイル（snapshotlog.conf） | ○ | － | なし | 12.2
7 | snapshotログ二次送付対象定義ファイル（snapshotlog.2.conf） | ○ | － | なし | 12.2
8 | サーバ定義ファイル（SOAP通信基盤）（c4websv.cfg） | ◎ | － | あり | Cosminexus アプリケーションサーバ SOAPアプリケーション開発の手引 | 10.2
9 | 共通定義ファイル（SOAP通信基盤）（c4webcom.cfg） | ◎ | － | あり | 10.4
10 | HCSC-Manager定義ファイル（cscmng.properties） | ◎ | － | あり | Cosminexus サービスプラットフォーム リファレンス | HCSC-Manager定義ファイル
11 | HCSC-Managerコマンド共通定義ファイル（csccmd.properties） | ◎ | － | あり | HCSC-Managerコマンド共通定義ファイル
12 | HCSCサーバ構成定義ファイル（cscsvsetup.xml） | ◎ | － | あり | HCSCサーバ構成定義ファイル
13 | HCSCサーバセットアップ定義ファイル（cscsvsetup.properties） | ◎ | － | あり | HCSCサーバセットアップ定義ファイル
14 | HCSCサーバランタイム定義ファイル（cscsvconfig.properties） | ◎ | － | あり | HCSCサーバランタイム定義ファイル
15 | ユーザ定義受付ランタイム定義ファイル（cscurcptnconfig_id.properties） | △ | ○ | あり | ユーザ定義受付ランタイム定義ファイル
16 | サービス情報変更定義ファイル（cscadpconfig.properties） | △ | ○ | あり | サービス情報変更定義ファイル
17 | 簡易構築定義ファイル（SOA.xml） | ◎ | ○ | あり | Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義) | 4.6
18 | Hitachi Web Server定義ファイル（httpsd.conf） | △ | × | なし | Hitachi Web Server | 特定個所に該当しません。
19 | cscsetupコマンド定義ファイル（cscsetup.properties） | ○ | － | あり | Cosminexus サービスプラットフォーム リファレンス | cscsetupコマンド定義ファイル

（凡例）

◎：必ず作成します。

○：必要に応じて作成および変更します。

△：作成する必要はありません。作成しても無視されます。

×：存在するとエラーになります。削除してください。

－：変更しないでください。

あり：テンプレートファイルを提供しています。

なし：テンプレートファイルを提供していません。

注※

変更する定義ファイルは，変更する情報によって次のように異なります。

・サービス情報：サービス情報変更定義ファイル（cscadpconfig.properties）

・ユーザ定義受付の定義情報：ユーザ定義受付ランタイム定義ファイル（cscurcptnconfig_id.properties）

・サーバの定義情報：簡易構築定義ファイル（SOA.xml）

注意

ユーザ定義受付ランタイム定義ファイル（cscurcptnconfig_id.properties）を除いて，定義ファイルのファイル名は変更しないでください。

＜この項の構成＞

(1)　定義ファイルの形式

(2)　Manager設定ファイル

(3)　運用管理エージェントプロパティファイル

(4)　Management Server環境設定ファイル

(5)　クライアント共通設定プロパティファイル

(6)　クライアント側共通定義ファイル

(7)　snapshotログ一次送付対象定義ファイル

(8)　snapshotログ二次送付対象定義ファイル

(9)　サーバ定義ファイル（SOAP通信基盤）

(10)　共通定義ファイル（SOAP通信基盤）

(11)　HCSC-Manager定義ファイル

(12)　HCSC-Managerコマンド共通定義ファイル

(13)　HCSCサーバ構成定義ファイル

(14)　HCSCサーバセットアップ定義ファイル

(15)　HCSCサーバランタイム定義ファイル

(16)　ユーザ定義受付ランタイム定義ファイル

(17)　サービス情報変更定義ファイル

(18)　簡易構築定義ファイル

(19)　Hitachi Web Server定義ファイル

(20)　cscsetupコマンド定義ファイル

(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 | Hitachi Web Serverの動作確認間隔を秒単位で指定します。
adminagent.j2ee.watch.retry_count | 1 | 1 | J2EEサーバの動作確認で，動作確認処理に失敗した場合にリトライする回数を指定します。
adminagent.hws.watch.retry_count | 1 | 1 | Hitachi Web Serverサーバの動作確認で，動作確認処理に失敗した場合にリトライする回数を指定します。
adminagent.j2ee.watch.start_time | 45 | 45 | J2EEサーバの起動で，起動コマンドを実行してから動作確認を開始するまでの時間を秒単位で指定します。
adminagent.hws.watch.start_time | 0 | 0 | Hitachi Web Serverの起動で，起動コマンドを実行してから動作確認を開始するまでの時間を秒単位で指定します。
adminagent.j2ee.watch.timeout | 60 | 60 | J2EEサーバの動作確認で，タイムアウトするまでの時間を秒単位で指定します。
adminagent.hws.watch.timeout | 60 | 60 | Hitachi Web Serverの動作確認で，タイムアウトするまでの時間を秒単位で指定します。

（凡例）　－：ありません。

注※　セットアップ時に編集する項目です。

デフォルト値と異なる値が設定される項目

項目名 | デフォルト値 | HCSC本番環境簡易セットアップで設定される値 | 説明
adminagent.adapter.allowedHosts | － | localhost | サーバへのアクセスを許可するホスト名またはIPアドレスを指定します。
adminagent.adapter.bind_host | localhost | － | 運用管理エージェントとの通信で使用するホスト名またはIPアドレスを指定します。
adminagent.hws.watch.method | HEAD | OPTIONS | adminagent.hws.watch.levelで2を指定したときのHitachi Web 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サーバのコンソール出力情報をコンソールログに出力するかどうかを指定します。

（凡例）　－：ありません。

(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終了要求受信ポート番号を指定します。

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本番環境簡易セットアップで設定される値 | 説明
障害検知時コマンドの動作の設定 | 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_define_application

cmx_define_resource

cmx_delete_serverref

cmx_delete_system

cmx_deploy_application

cmx_deploy_resource

cmx_list_model

cmx_list_status

cmx_resume_lb

cmx_start_application

cmx_s

（凡例）　－：ありません。

(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ログとして収集する一次送付資料の対象ファイルを定義します。このファイルはテンプレートファイルを提供していません。

ファイルの格納先

<Cosminexusのインストールディレクトリ>¥manager¥config

編集する項目

カテゴリ
項目名
デフォルト値
HCSC本番環境簡易セットアップで設定される値
説明

収集対象ディレクトリ
%val%※
－
－
HCSC-Managerのログファイルの出力先を指定します。
cscmng.propertiesのcscmng.log.dirをカスタマイズした場合，次の二つの値を追加してください。カスタマイズしていない場合，ログファイルの出力先がすでに指定されているため，追加する必要はありません。

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ログとして収集する二次送付資料の対象ファイルを定義します。このファイルはテンプレートファイルを提供していません。

ファイルの格納先

<Cosminexusのインストールディレクトリ>¥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をカスタマイズした場合，次の三つの値を追加してください。カスタマイズしていない場合，リポジトリの配置場所がすでに指定されているため，追加する必要はありません。

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の動作に必要となる情報を設定します。

編集する項目

カテゴリ | 項目名 | デフォルト値 | HCSC本番環境簡易セットアップで設定される値 | 説明
リポジトリ設定 | cscmng.repository.root※ | <Cosminexusのインストールディレクトリ>¥CSC¥repository | － | リポジトリのルートディレクトリを絶対パスで指定します。
ログ設定 | cscmng.log.dir※ | <Cosminexusのインストールディレクトリ>¥CSC¥log¥manager | － | ログ出力先ディレクトリを絶対パスで指定します。
環境バックアップ | cscmng.envbackup.dir※ | カレントディレクトリ | － | cscenvbackupコマンドで環境をバックアップする場合，環境バックアップファイルの出力先ディレクトリを指定します。

（凡例）　－：ありません。

注※　セットアップ時に編集する項目です。

デフォルト値と異なる値が設定される項目

カテゴリ | 項目名 | デフォルト値 | HCSC本番環境簡易セットアップで設定される値 | 説明
HCSCサーバ運用設定 | cscmng.server.HCSC.system | － | WebServer,PRF | HCSCシステムの管理下におく論理サーバを指定します。

（凡例）　－：ありません。

(12)　HCSC-Managerコマンド共通定義ファイル

ファイル名

csccmd.properties

説明

Cosminexus サービスプラットフォームで使用する各コマンドのオプションのデフォルト値を設定します。

編集する項目

なし

デフォルト値と異なる値が設定される項目

カテゴリ | 項目名 | デフォルト値 | 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 | － | 未設定

（凡例）　－：ありません。

(13)　HCSCサーバ構成定義ファイル

ファイル名

cscsvsetup.xml

説明

HCSCサーバの構成情報を設定します。

編集する項目

カテゴリ | 項目名 | デフォルト値 | HCSC本番環境簡易セットアップで設定される値 | 説明
cosminexus-managerの定義 | <port>Cosminexus-managerのポート番号</port>※ | 28099 | 28099 | Cosminexus Managerのリモート管理機能への接続ポート番号を指定します。Management Server環境設定ファイル（mserver.properties）のcom.cosminexus.mngsvr.management.portの値と合わせる必要があります。

注※　セットアップ時に編集する項目です。

デフォルト値と異なる値が設定される項目

カテゴリ | 項目名 | デフォルト値 | HCSC本番環境簡易セットアップで設定される値 | 説明
clusterの定義 | <name>クラスタ名</name> | － | Cluster | クラスタ名を指定します。
cosminexus-managerの定義 | <name>Cosminexus-manager名</name> | － | Manager | HCSC-ManagerがCosminexus Managerを認識するためのHCSC-Manager独自の識別名を指定します。
<ip-address>Cosminexus-managerのIPアドレス</ip-address> | － | localhost | Cosminexus Management Serverが起動しているIPアドレスを指定します。
<id>Cosminexus-managerの管理ユーザID</id> | － | admin | Cosminexus Management Serverの管理ユーザIDを指定します。
<password>Cosminexus Management Serverの管理ユーザパスワード</password> | － | admin | Cosminexus 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サーバの受付プロトコルを指定します。

（凡例）　－：ありません。

(14)　HCSCサーバセットアップ定義ファイル

ファイル名

cscsvsetup.properties

説明

HCSCサーバのセットアップ時に設定できる内容を設定します。

編集する項目

なし

デフォルト値と異なる値が設定される項目

カテゴリ | 項目名 | デフォルト値 | HCSC本番環境簡易セットアップで設定される値 | 説明
セットアップ構成関連 | db-use | － | OFF | HCSCサーバでデータベースを使用するかどうかを指定します。
rm-use | － | OFF | HCSCサーバでCosminexus RMを使用するかどうかを指定します。
標準受付関連 | request-ejb | － | OFF | 標準の同期受付（SessionBean）を使用するかどうかを指定します。
request-soap | － | ON | 標準の同期受付（Webサービス）を使用するかどうかを指定します。
request-jms | － | OFF | 標準の非同期受付（MDB（WS-R））を使用するかどうかを指定します。
request-dbq | － | OFF | 標準の非同期受付（MDB（DBキュー））を使用するかどうかを指定します。
ユーザ定義受付関連 | request-userdef-soap | － | ON | ユーザ定義受付を使用するかどうかを指定します。

（凡例）　－：ありません。

(15)　HCSCサーバランタイム定義ファイル

ファイル名

cscsvconfig.properties

説明

セットアップ後のHCSCサーバの定義情報をHCSC-Managerから設定します。

編集する項目

なし

デフォルト値と異なる値が設定される項目

カテゴリ | 項目名 | デフォルト値 | HCSC本番環境簡易セットアップで設定される値 | 説明
データ変換 | xmltelegram-namespace-complement | － | ON | HCSCサーバ内を流れるXML電文に対して，XML電文内の属性値に指定された名前空間接頭辞に対応した名前空間宣言を補完するかどうかを指定します。

（凡例）　－：ありません。

(16)　ユーザ定義受付ランタイム定義ファイル

ファイル名

cscurcptnconfig_id.properties

説明

ユーザ定義受付（Webサービス）の情報を設定します。

ユーザ定義受付ランタイム定義ファイルを使用する際は，ファイル名を「cscurcptnconfig_<受付ID>.properties」に変更して実行してください。受付IDが「rcp1」の場合は，ファイル名を「cscurcptnconfig_rcp1.properties」に変更して実行してください。なお，変更するユーザ定義受付が複数存在する場合は，ユーザ定義受付単位に複数のファイルを作成してください。

編集する項目

項目名 | デフォルト値 | HCSC本番環境簡易セットアップで設定される値 | 説明
user-defined-reception-soap.threads.maximum※ | 10 | 20 | ユーザ定義受付の最大同時実行数を指定します。
user-defined-reception-soap.exclusive.threads※ | 0 | 0 | ユーザ定義受付の占有スレッド数を指定します。
user-defined-reception-soap.queue-size※ | 8192 | 10 | ユーザ定義受付の実行待ちキューのサイズを指定します。

注※　チューニング時に編集する項目です。

デフォルト値と異なる値が設定される項目

なし

(17)　サービス情報変更定義ファイル

ファイル名

cscadpconfig.properties

説明

サービスアダプタのサービス情報の変更を設定します。

編集する項目

カテゴリ | 項目名 | デフォルト値 | HCSC本番環境簡易セットアップで設定される値 | 説明
Webサービス用サービスアダプタのサービス情報 | Cluster.<サービスID>.WebService.url※1 | サービスアダプタ開発時の値 | － | サービス部品の呼び出しに使用するURLを指定します。
Cluster.<サービスID>.WebService.c4web.application.socket_read_timeout※2 | 300 | － | サービスアダプタのソケットの読み込みタイムアウト値を秒単位で指定します。

（凡例）　－：ありません。

注※1　セットアップ時に編集する項目です。

注※2　チューニング時に編集する項目です。

デフォルト値と異なる値が設定される項目

なし

(18)　簡易構築定義ファイル

ファイル名

SOA.xml

説明

Webシステムを定義します。

編集する項目

カテゴリ | <param-name>に指定するパラメタ | デフォルト値 | HCSC本番環境簡易セットアップで設定される値 | <param-value>に指定する内容
サービスユニットの定義/Hitachi Web Serverの定義/論理サーバ共通のコンフィグレーション定義 | mstartup.force.watchtime | 60 | 60 | 論理サーバの強制停止監視時間を秒単位で指定します。
mstartup.restartcnt | 1 | 1 | 論理サーバの自動再起動回数を指定します。
mstartup.retrywait | 60 | 60 | 論理サーバの自動再起動リトライ間隔を秒単位でを指定します。
mstartup.start.watchtime | 60 | 60 | 論理サーバの起動監視時間を秒単位でを指定します。
mstartup.watchtime | 60 | 60 | 論理サーバの停止監視時間を秒単位でを指定します。
サービスユニットの定義/Hitachi Web Serverの定義/Hitachi Web Serverのコンフィグレーション定義/Webサーバ用定義 | Listen※1 | － | 80 | リクエストを受け付けるIPアドレス，およびポート番号を指定します。
ThreadsPerChild※2 | 40 | 50 | サーバとして起動するスレッド数を指定します。この定義は，Windowsの場合だけ指定してください。
サービスユニットの定義/Hitachi Web Serverの定義/Hitachi Web Serverのコンフィグレーション定義/Hitachi Web Server用リダイレクタ動作定義 | JkLogFileDir※1 | logs | － | ログファイルの出力先ディレクトリを指定します。Windowsの場合，パス区切り文字として「¥」を使用してください。スラッシュ（/）は指定できないため注意してください。
JkTraceLogFileDir※1 | logs | － | 保守用トレースログファイルの出力先ディレクトリを指定します。Windowsの場合，パス区切り文字として「¥」を使用してください。スラッシュ（/）は指定できないため注意してください。
サービスユニットの定義/Hitachi Web Serverの定義/Hitachi Web 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 | 通信タイムアウト値を秒単位で指定します。
サービスユニットの定義/Hitachi Web Serverの定義/Hitachi Web Serverのコンフィグレーション定義/Hitachi Web Serverのログの出力定義 | CustomDivideFileNum※1 | 8 | 8 | 分割したログファイルのファイル数を指定します。
HttpsdLogFileDir※1 | logs | － | Webサーバの出力するログの出力先ディレクトリを指定します。Windowsの場合，パス区切り文字として「¥」を使用してください。スラッシュ（/）は指定できないため注意してください。
サービスユニットの定義/J2EEサーバの定義/論理サーバ共通のコンフィグレーション定義 | mstartup.force.watchtime | － | 60 | 論理サーバの強制停止監視時間を秒単位で指定します。
mstartup.restartcnt | － | 1 | 論理サーバの自動再起動回数を指定します。
mstartup.retrywait | － | 60 | 論理サーバの自動再起動リトライ間隔を秒単位で指定します。
mstartup.start.watchtime | － | 600 | 論理サーバの起動監視時間を秒単位で指定します。
mstartup.watchtime | － | 60 | 論理サーバの停止監視時間を秒単位で指定します。
user.env.variable | － | 未設定 | サーバ起動時の環境変数を指定します。
JAVACOREDIR=%val%※1 | － | － | JavaVMのスレッドダンプの出力先を指定します。Windowsの場合，パス区切り文字として「¥」を使用してください。スラッシュ（/）は指定できないため注意してください。
サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/ユーザプロパティ/ejbserver.httpから始まるパラメタ | ejbserver.http.port※1 | 8080 | 8080 | 簡易Webサーバのポート番号を指定します。
サービスユニットの定義/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 | <Cosminexusの作業ディレクトリ>¥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 | 0 | 0 | JMXクライアント（運用管理エージェント，JP1/Performance Management - Agent Option for uCosminexus Application Serverなど）による稼働情報取得時のリクエスト受付ポートを指定します。
サービスユニットの定義/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 | 256m | 1024m | Javaヒープの初期サイズを指定します。
-Xmx%val%※2 | 512m | 1024m | Javaヒープの最大サイズを指定します。
XX:PermSize=%val%※2 | 128m | 128m | Permanent領域の初期サイズを指定します。
XX:MaxPermSize=%val%※2 | 128m | 128m | Permanent領域の最大サイズを指定します。
ejb.public.directory※1 | <Cosminexusの作業ディレクトリ>¥ejb¥<サーバ名>¥logs | － | J2EEサーバの作業ディレクトリを指定します。指定したディレクトリをJ2EEサーバの作業ディレクトリとしてJ2EEサーバを開始します。Windowsの場合，パス区切り文字として「¥」を使用してください。スラッシュ（/）は指定できないため注意してください。
ejb.server.log.directory※1 | <Cosminexus作業ディレクトリ>¥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に，Cosminexus運用管理エージェントのポート番号を指定します。運用管理エージェントプロパティファイル（adminagent.properties）のadminagent.adapter.portの値と合わせる必要があります。

（凡例）　－：ありません。

注※1　セットアップ時に編集する項目です。

注※2　チューニング時に編集する項目です。

注※3　<param-value>ではなく，表に記載されているタグに指定します。

デフォルト値と異なる値が設定される項目

カテゴリ | <param-name>に指定されているパラメタ | デフォルト値 | HCSC本番環境簡易セットアップで設定される値 | <param-value>に指定する内容
Webシステムの定義 | － | － | SOA | <web-system>下の<name>※に，Webシステムを識別するための名称を指定します。
物理ティアの定義 | － | － | combined-tier | <tier>下の<tier-type>※に，物理ティアの種類を指定します。
サービスユニットの定義 | － | － | Unit | <unit>下の<name>※に，サービスユニットを識別するための名称を指定します。
－ | － | localhost | <unit>下の<host-ref>※に，ホストの定義の<name-name>に指定したホスト名，構築済みのWebシステムで定義されているホスト名，または@myhostを指定します。
－ | － | combined-tier | <unit>下の<hosts-for>※に，<host-ref>で指定したホストが属する物理ティアの種類を指定します。
サービスユニットの定義/Hitachi Web Serverの定義 | － | cmx_<Webシステム名>_<サービスユニット名>_<種別>_<通番> | WebServer | <define-server>下の<logical-server-name>※に，論理サーバまたはクラスタを識別するための名称を指定します。
－ | － | web-server | <define-server>下の<logical-server-type>※に，コンフィグレーションを定義する論理サーバの種類を指定します。
サービスユニットの定義/Hitachi Web Serverの定義/Hitachi Web Serverのコンフィグレーション定義/Webサーバ用定義 | KeepAliveTimeout | 15 | 3 | KeepAlive接続時の要求待ち時間を秒単位で指定します。
サービスユニットの定義/Hitachi Web Serverの定義/Hitachi Web Serverのコンフィグレーション定義/Hitachi Web Server用リダイレクタ動作定義 | JkMount | /* [J2EEサーバ名]（combined-tierとhttp-tierの場合） | /* default | Hitachi Web Serverへのリクエストで，どのURLパターンがWebコンテナサーバに転送されるかを指定します。
サービスユニットの定義/Hitachi Web Serverの定義/Hitachi Web Serverのコンフィグレーション定義/ワーカ定義 | worker.default.type | － | ajp13 | ワーカのタイプを指定します。
worker.default.host | － | localhost | ワーカのホスト名，またはIPアドレスを指定します。
worker.list | － | default | ワーカ名のリストを指定します。
サービスユニットの定義/Hitachi Web Serverの定義/Hitachi Web Serverのコンフィグレーション定義/Hitachi Web Serverのログの出力定義 | HttpsdErrorMethod | Div | Wrap | エラーログの出力方式を指定します。
HttpsdRequestMethod | Div | Wrap | リクエストログの出力方式を指定します。
サービスユニットの定義/J2EEサーバの定義 | － | cmx_<Webシステム名>_<サービスユニット名>_<種別>_<通番> | J2EEServer | <define-server>下の<logical-server-name>※に，論理サーバまたはクラスタを識別するための名称を指定します。
－ | － | j2ee-server | <define-server>下の<logical-server-type>※に，コンフィグレーションを定義する論理サーバの種類を指定します。
サービスユニットの定義/J2EEサーバの定義/論理サーバ共通のコンフィグレーション定義 | mstartup.no | － | 80 | 一括起動時のサーバの起動順序を整数で指定します。
サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/ユーザプロパティ/ejbserver.extから始まるパラメタ | ejbserver.ext.method_observation.interval | － | 10 | 業務アプリケーション実行時間監視機能を使用するかどうかを指定します。また，動作中のリクエスト処理がタイムアウトしていないかを監視する時間間隔，タイムアウトしたリクエスト（メソッド）をキャンセルする時間間隔を秒単位で指定します。
サービスユニットの定義/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サーバのコンフィグレーション定義/ユーザプロパティ/vbrokerから始まるパラメタ | vbroker.se.iiop_tp.host | － | localhost | 任意の値を指定して，J2EEサーバ単位でEJBコンテナのIPアドレスを固定します。
サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/ユーザプロパティ/webserver.connectorから始まるパラメタ | webserver.connector.ajp13.bind_host | － | localhost | Webサーバ連携で使用するIPアドレス，またはホスト名を指定します。
サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/JavaVMオプション定義 | add.jvm.arg | － | + | -XX:%val%HitachiCommaVerboseGCに，拡張verbosegc情報の出力形式を指定します。
－ | + | -XX:%val%HitachiUseExplicitMemoryに，明示管理ヒープ機能の使用するかどうかを指定します。
サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/JavaVMシステムプロパティ | ejbserver.container.security.disabled | false | true | Enterprise Beanのアクセス制御機能を有効にするかどうかを指定します。
ejbserver.ctm.enabled | 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 | 通信基盤として，SOAP通信基盤を指定します。
サービスユニットの定義/J2EEサーバの定義/J2EEサーバのコンフィグレーション定義/SecurityManager | use.security | true | false | J2EEサーバの起動オプションにSecurityManagerを使用するかどうかを指定します。
サービスユニットの定義/PRFの定義 | － | cmx_<Webシステム名>_<サービスユニット名>_<種別>_<通番> | PRF | <define-server>下の<logical-server-name>※に，論理サーバまたはクラスタを識別するための名称を指定します。
－ | － | performance-tracer | <define-server>下の<logical-server-type>※に，コンフィグレーションを定義する論理サーバの種類を指定します。
サービスユニットの定義/PRFの定義/論理サーバ共通のコンフィグレーション定義 | mstartup.no | 0 | 0 | 一括起動時のサーバの起動順序を指定します。
サービスユニットの定義/PRFの定義/PRFのコンフィグレーション定義 | PrfTraceLevel | STANDARD | 00030000 | パフォーマンストレーサのトレース取得レベルを指定します。
ホストの定義 | － | － | localhost | <host>下の<host-name>※に，ホストを識別するための名称またはIPアドレスを指定します。
－ | <host-name>で指定した値 | localhost | <host>下の<agent-host>※に，Cosminexus運用管理エージェントのホスト名またはIPアドレスを指定します。

（凡例）　－：ありません。

注※　<param-value>ではなく，表に記載されているタグに指定します。

(19)　Hitachi Web Server定義ファイル

ファイル名

httpsd.conf

説明

Hitachi Web Serverの動作に必要となる情報を設定します。なお，HCSC本番環境簡易セットアップ機能でセットアップしたあと，Hitachi Web Serverを起動する前に，必要に応じてファイルを直接変更してください。

ファイルの格納先

<Cosminexusのインストールディレクトリ>¥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 | スーパーユーザ | － | Cosminexus Component Container管理者で設定するオーナーを指定します。
group※1※2 | スーパーユーザ | － | Cosminexus Component Container管理者で設定するグループを指定します。

（凡例）　－：ありません。

注※1　セットアップ時に編集する項目です。

注※2　ownerおよびgroupの値を指定しない場合は，次に示す情報でセットアップおよびアンセットアップを実行します。

表3-28　ownerおよびgroupの値を指定しない場合の設定値

OS | ファイルオーナー | グループ名
Linux | root | root
HP-UX | root | sys
AIX | root | system

4.　リポジトリの管理

この章では，リポジトリの設定，エクスポートやインポート，およびリポジトリの情報の参照などについて説明します。

＜この章の構成＞

4.1　リポジトリの概要

4.2　リポジトリのエクスポート

4.3　リポジトリのインポート

4.4　リポジトリの情報の参照

4.5　リポジトリの差分情報の参照

4.6　コンポーネント単位でのリポジトリの追加，更新，および削除

4.1　リポジトリの概要

リポジトリとは，開発環境と運用環境の間で共有する情報を格納するディレクトリのことをいいます。

運用環境で作成したシステム構成情報を開発環境で使用したり，開発環境で作成した定義情報を運用環境で使用したりします。

＜この節の構成＞

(1)　リポジトリの情報

(2)　リポジトリとして使用するディレクトリ

(3)　リポジトリの排他

(4)　注意事項

(1)　リポジトリの情報

リポジトリで共有する情報をリポジトリ情報といい，次のものがあります。

システム構成

生成したアダプタやビジネスプロセス

マッピング定義

フォーマット定義

配備情報

(2)　リポジトリとして使用するディレクトリ

リポジトリは，uCosminexus Service Platformをインストールすると，標準で次のディレクトリに設定されます。

<Cosminexusのインストールディレクトリ>¥CSC¥repository

リポジトリとして設定するディレクトリを変更することもできます。変更する場合は，HCSC-Manager定義ファイルで変更します。リポジトリとして設定するディレクトリの変更については，「2.4.1　カスタマイズする」を参照してください。

1台のマシンに複数の運用・実行環境を構築（環境変数CSCMNG_HOMEを設定）している場合は，次のルートディレクトリにリポジトリが設定されます。

%CSCMNG_HOME%¥repository

開発環境と運用環境で情報を共有するためには，媒体を経由して，リポジトリの情報をZIPファイル形式で媒体にエクスポート（保存）したり，そのZIPファイル形式で保存された情報をリポジトリにインポート（読み込み）したりします。リポジトリのインポートとエクスポートを次の図に示します。

図4-1　リポジトリのエクスポートとインポート

リポジトリの情報の保存については，「4.2　リポジトリのエクスポート」を，リポジトリの情報の展開については，「4.3　リポジトリのインポート」を参照してください。

注意

バージョン07-60以降では，開発環境と運用環境で同じリポジトリを共有できません。旧バージョンでリポジトリを共有していた場合，開発環境と運用環境で別々のリポジトリを用意して，移行してください。移行手順については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「付録A.3　旧バージョンで開発環境と運用環境のリポジトリを共有していた場合の移行手順」を参照してください。

(3)　リポジトリの排他

リポジトリの更新を伴う操作中は，リポジトリがロックされた状態になり，操作できない場合があります。ロックには，排他ロック，および共有ロックがあり，ロックの種類によって，実行できる操作が異なります。

排他ロック中は，排他ロックまたは共有ロックになる操作はできません。

共有ロック中は，同時にほかの共有ロックになる操作ができます。

ロックの種類と対象になる操作を次の表に示します。

表4-1　ロックの種類と対象になる操作

ロックの種類
対象となる操作
説明

排他ロック
更新系コマンドでの操作
次のコマンドが対象となります。

csccompodeployコマンド

csccompoundeployコマンド

cscpasswdコマンド

cscrepctlコマンド

cscsvcctlコマンド

cscsvsetupコマンド

cscsvunsetupコマンド

共有ロック
参照系コマンドでの操作
次のコマンドが対象となります。

cscpideleteコマンド

cscpireexecコマンド

cscpiselectコマンド

cscrepdiffコマンド

cscreplsコマンド

cscstatusコマンド

cscsvclsコマンド

cscsvconfigコマンド

cscutilコマンド

cscresinfoコマンド

運用環境の画面での操作
－

（凡例）

－：該当しません。

(4)　注意事項

異なるバージョンの開発環境で作成したリポジトリは使用することができません。

リポジトリとして使用するディレクトリ以下にはアクセスしないようにしてください。アクセスした場合は，各種コマンドが失敗することがあります。

4.2　リポジトリのエクスポート

運用環境で作成した情報を，開発環境で使用する場合，cscrepctlコマンドを使用して，リポジトリ内の情報をZIPファイル形式でエクスポートします。作成したZIPファイルの内容は変更できません。

次のコマンドを入力します。

cscrepctl -user <ログインユーザID> -pass <ログインパスワード> -export <ファイル名>

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

4.3　リポジトリのインポート

開発環境で作成した内容を，運用環境で使用する場合，cscrepctlコマンドを使用して，ZIPファイル形式で保存されたリポジトリ情報をリポジトリにインポートします。

＜この節の構成＞

(1)　インポート方法

(2)　インポート時の自動バックアップ

(3)　バージョンアップ時のインポート

(1)　インポート方法

次のコマンドを入力します。

cscrepctl -user <ログインユーザID> -pass <ログインパスワード> -import <ファイル名>

インポートには，次の二つの方法があります。

標準インポート

通常は，標準インポートを使用します。現在の運用環境のHCSCサーバ構成情報に，別のリポジトリのHCSCコンポーネントをインポートします。インポート前に存在しているHCSCコンポーネントは破棄されます。

現在の運用環境のリポジトリ情報とインポートするリポジトリ情報で，HCSCサーバの構成情報が同じかどうかをチェックしたい場合は，cscrepctlコマンドに-checkオプションを指定します。

コンポーネントインポート

指定したリポジトリZIPファイルのHCSCコンポーネントを運用環境のリポジトリに追加したい場合に使用します。インポート前に存在しているHCSCコンポーネントは残されます。コンポーネントインポートを行う場合は，cscrepctlコマンドに-compoオプションを指定します。

コンポーネントインポートの詳細は，「4.6　コンポーネント単位でのリポジトリの追加，更新，および削除」を参照してください。

また，ZIPファイル形式で保存されたリポジトリ情報をリポジトリに展開するには，次の二つの方法があります。

差分展開

変更されたHCSCコンポーネントだけを運用環境のリポジトリに展開します。変更されていないHCSCコンポーネントは，運用環境のリポジトリに展開されないで，現在ある運用環境のリポジトリのHCSCコンポーネントがそのまま残ります。

全体展開

変更されていないHCSCコンポーネントを含め，インポート対象のZIPファイルをすべて運用環境のリポジトリに展開します。全体展開を行う場合，cscrepctlコマンドに-overwriteオプションを指定します。

なお，次の場合はインポートできません。

HCSCサーバがセットアップされていない場合（標準インポートのとき）

現在の運用環境のリポジトリ情報と，インポートするリポジトリ情報で，HCSCサーバの構成が異なる場合

現在配備されているビジネスプロセスやアダプタが，インポートするリポジトリ情報では削除されている場合

現在配備されているビジネスプロセスやアダプタが，インポートするリポジトリ情報では情報が更新されている場合

現在の運用環境のリポジトリ情報と，インポートするリポジトリ情報で，データベースおよびCosminexus RMを使用するかどうかの設定が異なる場合※

現在の運用環境のリポジトリ情報と，インポートするリポジトリ情報のSOAPモードが異なる場合

3.および4.の場合は，該当するビジネスプロセスやアダプタを実行環境から削除したあと，リポジトリをインポートしてください。

インポートする場合は，必ずリポジトリに設定したディレクトリ以下のディレクトリおよびファイルを参照していないことを確認してから，cscrepctlコマンドを実行してください。

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

注※

現在の運用環境のリポジトリ情報と，インポートするリポジトリ情報で，データベースおよびCosminexus RMを使用するかの設定が異なる場合でも，一部の場合についてはインポートできます。インポートできる場合とできない場合の設定を次の表に示します。

表4-2　インポートできる場合とできない場合の設定

現在の運用環境のリポジトリ情報での設定 | インポートするリポジトリ情報での設定
データベースとCosminexus RMの両方を使用する | データベースを使用してCosminexus RMを使用しない | データベースとCosminexus RMの両方を使用しない
データベースとCosminexus RMの両方を使用する | ○ | × | ×
データベースを使用してCosminexus RMを使用しない | ○ | ○ | ×
データベースとCosminexus RMの両方を使用しない | ○ | ○ | ○

（凡例）

○：インポートできます。

×：インポートできません。

(2)　インポート時の自動バックアップ

リポジトリをインポートする際に，インポート前のリポジトリ情報をZIPファイル形式で自動バックアップします。バックアップファイルは，cscimport.zipのファイル名で次のディレクトリに出力されます。

<Cosminexusインストールディレクトリ>¥CSC¥spool¥manager

なお，バックアップファイルの出力先ディレクトリは，HCSC-Manager定義ファイルのcscmng.envbackup.dirパラメタ，またはcscmng.envbackup.dir.importパラメタで変更できます。

また，自動バックアップをするかどうかは，HCSC-Manager定義ファイルのcscmng.envbackup.autogetパラメタ，またはcscmng.envbackup.autoget.offパラメタで設定できます。

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

また，バックアップファイルから運用環境を復旧する方法については，「7.9.3(2) 運用環境の復旧」を参照してください。

(3)　バージョンアップ時のインポート

現在のリポジトリ情報よりも新しいバージョンのリポジトリ情報をインポートすると，インポート時にリポジトリが自動でバージョンアップされます。

なお，現在配備されているビジネスプロセスやアダプタが，インポートするリポジトリ情報では削除されている場合，バージョンアップ時のインポートでエラーが発生します。エラーが発生した場合，現在のリポジトリを運用環境からエクスポートして，開発環境にインポートします。そのあと，開発環境でバージョンアップしたリポジトリを開発環境からエクスポートして，運用環境にインポートしてください。

バージョンアップの詳細については，「付録G　旧バージョンからの移行」を参照してください。

4.4　リポジトリの情報の参照

リポジトリ内の情報は，コマンドで確認できます。未配備のビジネスプロセスやアダプタを配備するときに，複数のビジネスプロセスやアダプタの配備に失敗した場合は後処理されないため，cscreplsコマンドを使用して配備状況を確認します。

また，cscreplsコマンドに-privateオプションを指定することで，非公開コンポーネントを表示できます。運用環境のリポジトリ内に非公開コンポーネントが存在すると，サービスIDなどが重複し，コンポーネントインポートを実施できない場合があります。コンポーネントインポート機能を利用する場合は，-privateオプションを使用して非公開コンポーネントを確認し，適宜対処してください。

コマンドの実行例を次に示します。

リポジトリ情報を表示する場合

cscrepls -user <ログインユーザID> -pass <ログインパスワード> -repfile <エクスポートされたリポジトリZIPファイル名>

リポジトリ情報に非公開コンポーネントも含めて表示する場合

cscrepls -user <ログインユーザID> -pass <ログインパスワード> -repfile <エクスポートされたリポジトリZIPファイル名> -private

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

4.5　リポジトリの差分情報の参照

現在の運用環境のリポジトリ情報と指定したリポジトリ情報の差分は，cscrepdiffコマンドで確認できます。追加，変更，および削除されたビジネスプロセスやアダプタの情報が確認できます。

＜この節の構成＞

(1)　前提条件

(2)　表示方法

(3)　差分の表示内容

(1)　前提条件

リポジトリ情報の差分を表示するには，次の条件を満たす必要があります。

現在の運用環境のリポジトリ情報と，差分表示の対象となるリポジトリ情報が，単一のクラスタ構成になっていること

現在の運用環境のリポジトリ情報と，差分表示の対象となるリポジトリ情報で，データベースおよびCosminexus RMを使用するかどうかの設定が一致していること※

現在の運用環境のリポジトリ情報と，差分表示の対象となるリポジトリ情報で，SOAPモードが一致していること

注※　

現在の運用環境のリポジトリ情報と，差分表示の対象となるリポジトリ情報で，データベースおよびCosminexus RMを使用するかの設定が異なる場合でも，一部の場合についてはリポジトリ情報の差分を表示できます。リポジトリ情報の差分を表示できる場合とできない場合の設定を次の表に示します。

表4-3　リポジトリ情報の差分を表示できる場合とできない場合の設定

現在の運用環境のリポジトリ情報での設定 | 差分表示の対象となるリポジトリ情報での設定
データベースとCosminexus RMの両方を使用する | データベースを使用してCosminexus RMを使用しない | データベースとCosminexus RMの両方を使用しない
データベースとCosminexus RMの両方を使用する | ○ | × | ×
データベースを使用してCosminexus RMを使用しない | ○ | ○ | ○
データベースとCosminexus RMの両方を使用しない | ○ | ○ | ×

（凡例）

○：差分を表示できます。

×：差分を表示できません。

(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コマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscrepdiff（リポジトリ情報の差分の表示）」を参照してください。

(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コンポーネントを運用環境のリポジトリに集約する機能です。

インポート対象のリポジトリZIPファイルに存在しないHCSCコンポーネントについて，標準のインポートでは運用環境のリポジトリから削除します。コンポーネントインポート機能を使用すると，運用環境のリポジトリから削除しないで，リポジトリZIPファイル内の特定のHCSCコンポーネントだけ追加・更新できます。

コンポーネントインポート機能で実行できる作業は次のとおりです。

作業名 | 作業内容 | cscrepctlコマンドで指定するオプション
HCSCコンポーネントの追加 | 運用環境のリポジトリにあるHCSCコンポーネントを残したまま，新しいHCSCコンポーネントを追加できます。 | -import
HCSCコンポーネントの更新 | 運用環境のリポジトリにあるHCSCコンポーネントを置き換えられます。 | -import，-overwrite
HCSCコンポーネントの削除 | 運用環境のリポジトリにあるHCSCコンポーネントを削除できます。 | -delete

＜この節の構成＞

4.6.1　コンポーネントインポート機能の前提条件

4.6.2　コンポーネント単位のリポジトリの追加・更新

4.6.3　コンポーネント単位のリポジトリの削除

4.6.1　コンポーネントインポート機能の前提条件

コンポーネントインポート機能の実行可否は，次の表のように条件に応じて異なります。

表4-6　コンポーネントインポート機能の実行可否

項番
条件
追加
更新
削除

1
リポジトリのバージョンが同一の場合
○
○
－

2
リポジトリ内にクラスタが一つの場合
○
○
○

3
次のどれかの情報が一致するHCSCコンポーネントが存在しない場合

サービスID

サービス名

受付ID

○
－
－

4
コンテキストルートが一致するHCSCコンポーネントが存在しない場合
○
○
－

5
次に示す情報がすべて一致するHCSCコンポーネントが存在する場合

サービスID

サービス名

コンポーネント種別

サービスアダプタのアダプタ種別

－
○
－

6
運用環境にインポートするHCSCコンポーネントが開発環境でサービスを公開している場合
○
○
－

7
対象HCSCコンポーネントが配備済み状態でない場合
－
○
○

（凡例）

追加：リポジトリの追加（cscrepctlコマンドに-importオプションを指定）

更新：リポジトリの更新（cscrepctlコマンドに-import，-overwriteオプションを指定）

削除：リポジトリの削除（cscrepctlコマンドに-deleteオプションを指定）

○：実行できます。

－：実行できません。

4.6.2　コンポーネント単位のリポジトリの追加・更新

コンポーネント単位でリポジトリを追加（インポート）または更新するには，cscrepctlコマンドに-importオプションを指定して実行します。インポートの前にcscrepcheckコマンドを実行すると，指定したリポジトリZIPファイル内のHCSCコンポーネントを運用環境のリポジトリにインポートできるか検証できます。

＜この項の構成＞

(1)　インポート前のインポート可否の検証（cscrepcheckコマンド）

(2)　コンポーネント単位でのリポジトリのインポート（cscrepctlコマンド）

(1)　インポート前のインポート可否の検証（cscrepcheckコマンド）

cscrepcheckコマンドは，運用環境のリポジトリのHCSCコンポーネントの情報と状態を確認し，次の内容を検証して検証結果を表示します。cscrepcheckコマンドについては，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscrepcheck（インポート可否の検証）」を参照してください。

リポジトリZIPファイルをインポートできるか

リポジトリZIPファイル内のHCSCコンポーネントをコンポーネント単位でインポートできるか

cscrepcheckコマンドではリポジトリのインポートは実行されません。リポジトリをインポートするにはcscrepctlコマンドを実行してください。

(a)　インポート可否を検証できないケース

次の場合は，リポジトリ情報のインポート可否は検証できません。

現在の運用環境のリポジトリ情報と，検証対象となるリポジトリ情報が，単一のクラスタ構成になっていない場合

現在の運用環境のリポジトリ情報と，検証対象となるリポジトリ情報で，SOAPモードが異なる場合

データベースおよびCosminexus RMを使用するかどうかの設定が異なる場合
設定が異なる場合のインポートの検証可否を次の表に示します。

表4-7　インポート可否の検証ができる場合とできない場合の設定

現在の運用環境のリポジトリ情報での設定 | 検証の対象となるリポジトリ情報での設定
データベースとCosminexus RMの両方を使用する | データベースを使用してCosminexus RMを使用しない | データベースとCosminexus RMの両方を使用しない
データベースとCosminexus RMの両方を使用する | ○ | ○ | ○
データベースを使用してCosminexus RMを使用しない | × | ○ | ○
データベースとCosminexus RMの両方を使用しない | × | × | ○

（凡例）

○：インポート可否を検証できます。

×：インポート可否を検証できません。

(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コマンド共通定義ファイルに定義していることを前提としています。

コマンド実行例
repository.zipにあるサービスID「1」のHCSCコンポーネントだけを運用環境のリポジトリにインポートします。

cscrepctl -import repository.zip -compo -name 1

次のように-nameオプションを指定しなかった場合は，repository.zipにあるすべてのHCSCコンポーネントを運用環境のリポジトリにインポートします。

cscrepctl -import repository.zip -compo

cscrepctlコマンドについては，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscrepctl（インポート/エクスポート）」を参照してください。

4.6.3　コンポーネント単位のリポジトリの削除

コンポーネントインポートでは，コンポーネント情報がリポジトリ内で重複しているとインポートに失敗するため，事前に重複するHCSCコンポーネントを削除する必要があります。

コンポーネント単位のリポジトリを削除するには，cscrepctlコマンドに-deleteオプションを指定して実行します。これによって，HCSCコンポーネントが公開されているかどうかに関係なく，運用環境から削除されます。

コマンド実行例
cscrepctlコマンドを利用して，運用環境のリポジトリからサービスID「1」のHCSCコンポーネントを削除する例を次に示します。この例では，HCSC-ManagerのユーザIDとパスワードは，HCSC-Managerコマンド共通定義ファイルを使用していると仮定します。

cscrepctl -delete -name 1

cscrepctlコマンドについては，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscrepctl（インポート/エクスポート）」を参照してください。

5.　システム運用

この章では，ログイン，ログアウト，およびHCSCサーバの運用について説明します。

＜この章の構成＞

5.1　HCSCサーバのオペレーションをするための準備

5.2　HCSCサーバのオペレーション運用

5.3　クラスタ構成時の運用

5.4　環境構築後のIPアドレスまたはホスト名を変更する場合の運用

5.1　HCSCサーバのオペレーションをするための準備

HCSCサーバの運用を開始するには，HCSC-Managerにログインする必要があります。ログインとログアウトの方法について，以降の項で説明します。

＜この節の構成＞

5.1.1　ログインする

5.1.2　ログアウトする

5.1.1　ログインする

HCSCサーバにログインする方法を次に示します。

＜この項の構成＞

(1)　画面の場合

(2)　コマンドの場合

(3)　ログイン時の注意事項

(1)　画面の場合

運用環境の画面を利用してHCSCサーバにログインする手順を次に示します。

Eclipseを起動します。

メニューから［HCSC-Manager］－［ログイン］を選択します。
現在のパースペクティブがHCSC-Managerパースペクティブの場合（ツリービューが表示されている場合），ユーザIDとパスワードを入力するダイアログが表示されます。
現在のパースペクティブがHCSC-Managerパースペクティブではない場合（ツリービューが表示されていない場合），パースペクティブを切り替えるかどうかを確認するダイアログが表示されます。パースペクティブを切り替える場合は［はい］，切り替えない場合は［いいえ］を選択します。そのあと，ユーザIDとパスワードを入力するダイアログが表示されます。

ユーザIDとパスワードを指定して，［OK］ボタンをクリックします。
ログインが正常に終了すると，サーバとHCSCコンポーネントの構成，状態がツリービューに表示されます。
ユーザIDとパスワードはcscpasswdコマンドで設定，変更できます。ユーザIDとパスワードの設定，変更の詳細については，「2.4.2　ユーザ権限を設定する」を参照してください。また，cscpasswdコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「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)　画面の場合

(2)　コマンドの場合

(1)　画面の場合

運用環境の画面を利用してHCSCサーバからログアウトする手順を次に示します。

メニューから［HCSC-Manager］－［ログアウト］を選択します。
ログアウトを確認するダイアログが表示されます。

［OK］ボタンをクリックします。
ログアウトが正常に終了すると，画面は初期状態に戻ります。

(2)　コマンドの場合

HCSC-Managerのコマンドの終了時にログアウトできます。

5.2　HCSCサーバのオペレーション運用

Cosminexus サービスプラットフォームの運用環境を利用して，セットアップ済みのシステムを運用する方法について説明します。

＜この節の構成＞

5.2.1　運用の流れ

5.2.2　データベースを起動する

5.2.3　PRFを起動する

5.2.4　HCSCサーバを起動する

5.2.5　Hitachi Web Serverを起動する

5.2.6　サービスアダプタを開始する

5.2.7　ビジネスプロセスを開始する

5.2.8　ユーザ定義受付を開始する

5.2.9　標準受付を開始する

5.2.10　データベースの状態を確認する

5.2.11　PRFの状態を確認する

5.2.12　Hitachi Web Serverの状態を確認する

5.2.13　Cosminexus Managerの状態を確認する

5.2.14　HCSCサーバのセットアップ情報を確認する

5.2.15　HCSCサーバの情報を確認する

5.2.16　HCSCサーバのリソース稼働情報を確認する

5.2.17　サービスアダプタの情報を確認する

5.2.18　ビジネスプロセスの情報を確認する

5.2.19　ユーザ定義受付の情報を確認する

5.2.20　HCSCサーバの定義を変更する

5.2.21　ユーザ定義受付の定義情報を変更する

5.2.22　HCSCコンポーネントの構成を変更する

5.2.23　サービス部品の接続先を変更する

5.2.24　流量制御値を変更する

5.2.25　サービス部品呼び出しの通信タイムアウト値を変更する

5.2.26　標準受付を停止する

5.2.27　ユーザ定義受付を停止する

5.2.28　サービスアダプタを停止する

5.2.29　ビジネスプロセスを停止する

5.2.30　Hitachi Web Serverを停止する

5.2.31　HCSCサーバを停止する

5.2.32　PRFを停止する

5.2.33　データベースを停止する

5.2.1　運用の流れ

次に示す場合の運用の流れについて説明します。

運用する前の準備

運用を開始する場合

運用中にシステムを操作する場合

運用を終了する場合

それぞれの場合に必要な操作の前提条件や手順については，以降の項で説明します。

＜この項の構成＞

(1)　運用する前の準備

(2)　運用を開始する場合

(3)　運用中にシステムを操作する場合

(4)　運用を終了する場合

(1)　運用する前の準備

運用する前に，次の作業を実施することを推奨します。

論理サーバの登録

論理サーバの操作（HCSCサーバとの一括起動・停止，および状態の参照）をできるようにするため，HCSC-Manager定義ファイルのパラメタを次のように変更します。

cscmng.server.<HCSCサーバ名>.system=論理サーバ名

リポジトリへのアクセスの制御

セキュリティを確保するため，リポジトリにアクセスしないようにします。

リポジトリのルートディレクトリを変更していない場合は，次のリポジトリにアクセスしないようにします。

<Cosminexusインストールディレクトリ>¥CSC¥repository

リポジトリのルートディレクトリを変更した場合は，変更後のリポジトリにアクセス制御を実施してください。

1台のマシンに複数の運用環境を構築（環境変数CSCMNG_HOMEを設定）している場合は，次のリポジトリにアクセス制御を実施してください。

%CSCMNG_HOME%¥repository

バックアップ

運用時の障害に備えて，運用環境の情報をバックアップします。バックアップした情報を，運用環境とは別のマシンで管理することによって，障害発生後，運用環境を復旧できます。バックアップはcscenvbackupコマンドを実行します。cscenvbackupコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscenvbackup（HCSC-Manager環境のバックアップ）」を参照してください。

(2)　運用を開始する場合

システムを起動して運用を開始するには，次の図に示す流れに従って作業を実施する必要があります。

図5-1　運用を開始する場合の作業の流れ

注※1

これらの作業を一括して実行することもできます。なお，HCSCコンポーネントの開始前には，HCSCコンポーネントのパッケージング，配備定義，および配備が実行されます。ただし，一括実行は，システム開発時，または単体テストから結合テスト時を対象としています。詳細については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「9.5　HCSCコンポーネントをHCSCサーバに配備して開始する処理の一括実行」を参照してください。

注※2

cscrcptnstartコマンドを使用して，同時に開始することもできます。

(3)　運用中にシステムを操作する場合

システムの運用中，必要に応じて次の操作を実施できます。

状態・情報の参照

必要に応じて，各状態・情報を参照できます。参照できる状態・情報は次のとおりです。参照方法については，以降の項で説明します。

データベースの状態

PRFの状態

Hitachi Web Serverの状態（Hitachi Web Serverを使用する場合）

Cosminexus Managerの状態

HCSCサーバのセットアップ情報

HCSCサーバの情報

サービスアダプタの情報

ビジネスプロセスの情報

ユーザ定義受付の情報

なお，次に示す実行環境の構成要素およびHCSCサーバの状態は，定期的に確認する必要があります。

データベースの起動状態

PRFの起動状態

Hitachi Web Serverの起動状態（Hitachi Web Serverを使用する場合）

Cosminexus Managerの起動状態

HCSCサーバの起動状態および開始状態

定義や構成などの変更

必要に応じて，次の定義や構成などを変更できます。変更方法については，以降の項で説明します。

HCSCサーバの定義

ユーザ定義受付の定義情報

HCSCコンポーネントの構成

サービス部品の接続先

流量制御値

通信タイムアウト値

(4)　運用を終了する場合

システムを停止して運用を終了するには，次の図に示す流れに従って作業を実施する必要があります。停止方法については，以降の項で説明します。

図5-2　運用を終了する場合の作業の流れ

注※1

cscrcptnstopコマンドを使用して，同時に停止することもできます。

注※2

サービス部品の実行要求を受け付けないようにする場合に実施します。

注※3

これらの作業を一括して実行することもできます。なお，HCSCコンポーネントの停止後には，HCSCコンポーネントがHCSCサーバから削除されます。ただし，一括実行は，システム開発時，または単体テストから結合テスト時を対象としています。詳細については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「9.6　HCSCコンポーネントを停止してHCSCサーバから削除する処理の一括実行」を参照してください。

5.2.2　データベースを起動する

データベースの起動方法について次に説明します。

＜この項の構成＞

(1)　起動方法

(1)　起動方法

データベースを起動する方法を次に示します。

(a)　HiRDBの場合

HiRDBを起動するには，データベースサーバでpdstartコマンドを実行します。

pdstartコマンドの詳細については，マニュアル「HiRDB コマンドリファレンス」を参照してください。

(b)　Oracle の場合

Oracleを起動する方法については，Oracle Corporationが発行するドキュメントを参照してください。

5.2.3　PRFを起動する

PRFを起動するには，運用環境でcscsvstartコマンドを実行します。-logicalオプションにPRFの論理サーバ名を指定して実行します。

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

cscsvstartコマンドの実行形式を次に示します。

cscsvstart -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -logical <PRFの論理サーバ名>

5.2.4　HCSCサーバを起動する

HCSCサーバの起動の前提条件と起動方法について次に説明します。

＜この項の構成＞

(1)　起動方法

(1)　起動方法

HCSCサーバを起動する方法を次に示します。

注意

HCSCサーバを起動するとき，HCSCサーバが起動できなかったり，サービスアダプタおよびビジネスプロセスが開始できなかったりすると，サービスアダプタおよびビジネスプロセスの状態，ならびにユーザ定義受付および標準受付の状態が停止状態になる場合があります。この場合，エラーになった原因を取り除いたあと，サービスアダプタおよびビジネスプロセスの開始操作，ならびにユーザ定義受付および標準受付の開始操作を行う必要があります。

サービスアダプタおよびビジネスプロセスの開始方法については，「5.2.6　サービスアダプタを開始する」，または「5.2.7　ビジネスプロセスを開始する」を，ユーザ定義受付および標準受付の開始方法については，「5.2.8　ユーザ定義受付を開始する」，および「5.2.9　標準受付を開始する」を参照してください。

(a)　画面の場合

運用環境の画面を利用してHCSCサーバを起動する手順を次に示します。

ツリービュー上で，起動するHCSCサーバをダブルクリックします。
選択したHCSCサーバの情報がエディタエリアに表示されます。

エディタエリアで［稼働運用］タブを選択します。
稼働運用ページに，手順1で選択したHCSCサーバの稼働運用に関する情報が表示されます。
HCSCサーバの稼働運用ページの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「3.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コマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscsvstart（HCSCサーバの起動）」を参照してください。

cscsvstartコマンドの実行形式を次に示します。

クラスタ内のHCSCサーバを一括して起動する場合

クラスタ名を指定して実行します。-clusterオプションで指定したクラスタ内のすべてのHCSCサーバが一括して起動されます（論理サーバは起動されません）。

cscsvstart -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名>

クラスタ内のHCSCサーバの起動と同時に論理サーバを起動する場合は，-systemオプションを指定します。ただし，HCSC-Manager定義ファイルに論理サーバを登録している必要があります。論理サーバの登録の詳細については，「5.2.1(1) 運用する前の準備」を参照してください。

cscsvstart -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -system

また，HCSCサーバは起動しないで指定した論理サーバだけを起動する場合は，-logicalオプションを指定します。

cscsvstart -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -logical <論理サーバ名>

それぞれのHCSCサーバを一つずつ起動する場合

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コマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscutil（各種操作）」を参照してください。

cscutilコマンドの実行形式は，プロパティ定義ファイルを使用するかどうかによって異なります。

プロパティ定義ファイルを使用しない場合

-propsオプションにHCSCサーバ名およびJ2EEサーバ名を指定します。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Cosminexus Manager名> -target server -operation start -props "CSCSrvName=<HCSCサーバ名>, J2EESrvName=<J2EEサーバ名>"

cscutilコマンドに指定するCosminexus Manager名，HCSCサーバ名およびJ2EEサーバ名は，cscreplsコマンドで確認できます。cscreplsコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscrepls（リポジトリ情報の表示）」を参照してください。

プロパティ定義ファイルを使用する場合

-propfileオプションにプロパティ定義ファイル名を指定します。プロパティ定義ファイルは，J2SEのプロパティファイル形式であらかじめ作成しておく必要があります。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Cosminexus Manager名> -target server -operation start -propfile <プロパティ定義ファイル名>

5.2.5　Hitachi Web Serverを起動する

Hitachi Web Serverを起動するには，運用環境でcscsvstartコマンドを実行します。-logicalオプションにHitachi Web Serverの論理サーバ名を指定して実行します。

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

cscsvstartコマンドの実行形式を次に示します。

cscsvstart -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -logical <Hitachi Web Serverの論理サーバ名>

5.2.6　サービスアダプタを開始する

サービスアダプタの開始の前提条件と開始方法について次に説明します。

＜この項の構成＞

(1)　前提条件

(2)　開始方法

(1)　前提条件

サービスアダプタを開始するには，HCSCサーバが起動状態である必要があります。

HCSCサーバの状態の確認方法については，「5.2.15　HCSCサーバの情報を確認する」を参照してください。

(2)　開始方法

サービスアダプタを開始する方法を次に示します。

(a)　画面の場合

運用環境の画面を利用してサービスアダプタを開始する手順を次に示します。

ツリービュー上で，開始するサービスアダプタをダブルクリックします。
ダブルクリックしたサービスアダプタの情報がエディタエリアの稼働運用ページに表示されます。
サービスアダプタの稼働運用ページの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「3.4　稼働運用ページ」を参照してください。

稼働運用ページに表示された内容を確認し，［開始］ボタンをクリックします。
サービスアダプタの開始を確認するダイアログが表示されます。

ダイアログに表示された内容を確認し，［OK］ボタンをクリックします。
サービスアダプタの開始処理が開始されます。開始処理中のログはコンソールビューに出力されます。
［キャンセル］ボタンをクリックした場合は，開始処理を実行しないで稼働運用ページに戻ります。
サービスアダプタの開始処理が完了すると，実行結果を示すダイアログが表示されます。

実行結果を示すダイアログを確認します。

開始処理が成功した場合

［OK］ボタンをクリックして，稼働運用ページに戻ります。

稼働運用ページでは，サービスアダプタの状態が「開始状態」になります。また，［開始］ボタンが非活性化し，［停止］ボタンが活性化します。

開始処理が失敗した場合

ダイアログにエラーの内容が表示されます。詳細情報に表示されるメッセージIDを参照して対処してください。

(b)　コマンドの場合

サービスアダプタを開始するには，運用環境でcsccompostartコマンドまたはcscutilコマンドを実行します。

csccompostartコマンドおよびcscutilコマンドは，次の場合に使用します。

csccompostartコマンド
該当するリポジトリが存在する運用環境で，サービスアダプタを開始する場合。

cscutilコマンド
該当するリポジトリがなく，cscutilが使用できる環境（例えば，JP1で直接運用している実行環境）でサービスアダプタを開始する場合。

csccompostartコマンドの場合

運用環境でcsccompostartコマンドを実行します。

csccompostartコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「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コマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscutil（各種操作）」を参照してください。

cscutilコマンドの実行形式は，プロパティ定義ファイルを使用するかどうかによって異なります。

プロパティ定義ファイルを使用しない場合

-propsオプションにサービスアダプタのサービスID，HCSCサーバ名，J2EEサーバ名および種別を指定します。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Cosminexus Manager名> -target compo -operation start -props "AdapterName=<サービスアダプタのサービスID>, CSCSrvName=<HCSCサーバ名>, J2EESrvName=<J2EEサーバ名>, ServiceKind=serviceAdapter"

cscutilコマンドに指定するCosminexus Manager名，サービスアダプタのサービスID，HCSCサーバ名およびJ2EEサーバ名は，cscreplsコマンドで確認できます。cscreplsコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscrepls（リポジトリ情報の表示）」を参照してください。

プロパティ定義ファイルを使用する場合

-propfileオプションにプロパティ定義ファイル名を指定します。プロパティ定義ファイルは，J2SEのプロパティファイル形式であらかじめ作成しておく必要があります。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Cosminexus Manager名> -target compo -operation start -propfile <プロパティ定義ファイル名>

5.2.7　ビジネスプロセスを開始する

ビジネスプロセスの開始の前提条件と開始方法について次に説明します。

＜この項の構成＞

(1)　前提条件

(2)　開始方法

(1)　前提条件

ビジネスプロセスを開始するには，HCSCサーバが起動状態である必要があります。

HCSCサーバの状態の確認方法については，「5.2.15　HCSCサーバの情報を確認する」を参照してください。

(2)　開始方法

ビジネスプロセスを開始する方法を次に示します。

(a)　画面の場合

運用環境の画面を利用してビジネスプロセスを開始する手順を次に示します。

ツリービュー上で，開始するビジネスプロセスをダブルクリックします。
ダブルクリックしたビジネスプロセスの情報がエディタエリアに表示されます。

エディタエリアで稼働運用ページを選択します。
手順1で選択したビジネスプロセスの稼働運用に関する情報が表示されます。
ビジネスプロセスの稼働運用ページの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「3.4　稼働運用ページ」を参照してください。

稼働運用ページに表示された内容を確認し，［開始］ボタンをクリックします。
ビジネスプロセスの開始を確認するダイアログが表示されます。

ダイアログに表示された内容を確認し，［OK］ボタンをクリックします。
ビジネスプロセスの開始処理が開始されます。開始処理中のログはコンソールビューに出力されます。
［キャンセル］ボタンをクリックした場合は，開始処理を実行しないで稼働運用ページに戻ります。
ビジネスプロセスの開始処理が完了すると，実行結果を示すダイアログが表示されます。

実行結果を示すダイアログを確認します。

開始処理が成功した場合

［OK］ボタンをクリックして，稼働運用ページに戻ります。

稼働運用ページでは，ビジネスプロセスの稼働状態が「開始状態」になります。また，［開始］ボタンが非活性化し，［停止］ボタンが活性化します。

開始処理が失敗した場合

ダイアログにエラーの内容が表示されます。詳細情報に表示されるメッセージIDを参照して対処してください。

(b)　コマンドの場合

ビジネスプロセスを開始するには，運用環境でcsccompostartコマンドまたはcscutilコマンドを実行します。

csccompostartコマンドおよびcscutilコマンドは，次の場合に使用します。

csccompostartコマンド
該当するリポジトリが存在する運用環境で，ビジネスプロセスを開始する場合。

cscutilコマンド
該当するリポジトリがなく，cscutilが使用できる環境（例えば，JP1で直接運用している実行環境）でビジネスプロセスを開始する場合。

csccompostartコマンドの場合

運用環境でcsccompostartコマンドを実行します。

csccompostartコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「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コマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscutil（各種操作）」を参照してください。

cscutilコマンドの実行形式は，プロパティ定義ファイルを使用するかどうかによって異なります。

プロパティ定義ファイルを使用しない場合

-propsオプションにビジネスプロセスのサービスID，HCSCサーバ名，J2EEサーバ名および種別を指定します。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Cosminexus Manager名> -target compo -operation start -props "AdapterName=<ビジネスプロセスのサービスID>, CSCSrvName=<HCSCサーバ名>, J2EESrvName=<J2EEサーバ名>, ServiceKind=bp"

cscutilコマンドに指定するCosminexus Manager名，ビジネスプロセスのサービスID，HCSCサーバ名およびJ2EEサーバ名は，cscreplsコマンドで確認できます。cscreplsコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscrepls（リポジトリ情報の表示）」を参照してください。

プロパティ定義ファイルを使用する場合

-propfileオプションにプロパティ定義ファイル名を指定します。プロパティ定義ファイルは，J2SEのプロパティファイル形式であらかじめ作成しておく必要があります。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Cosminexus Manager名> -target compo -operation start -propfile <プロパティ定義ファイル名>

5.2.8　ユーザ定義受付を開始する

ユーザ定義受付の開始の前提条件と開始方法について次に説明します。

＜この項の構成＞

(1)　前提条件

(2)　開始方法

(1)　前提条件

ユーザ定義受付を開始するには，次の条件を満たしている必要があります。

HCSCサーバが起動状態であること。

ユーザ定義受付が定義されているビジネスプロセスが開始状態であること。

HCSCサーバの状態の確認方法については，「5.2.15　HCSCサーバの情報を確認する」を参照してください。

(2)　開始方法

ユーザ定義受付を開始する方法を次に示します。

(a)　画面の場合

運用環境の画面を利用してユーザ定義受付を開始する手順を次に示します。

ツリービュー上で，開始するユーザ定義受付をダブルクリックします。
ダブルクリックしたユーザ定義受付の情報がエディタエリアの稼働運用ページに表示されます。
ユーザ定義受付の稼働運用ページの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「3.4　稼働運用ページ」を参照してください。

稼働運用ページに表示された内容を確認し，［開始］ボタンをクリックします。
ユーザ定義受付の開始を確認するダイアログが表示されます。

ダイアログに表示された内容を確認し，［OK］ボタンをクリックします。
ユーザ定義受付の開始処理が開始されます。開始処理中のログはコンソールビューに出力されます。
［キャンセル］ボタンをクリックした場合は，開始処理を実行しないで稼働運用ページに戻ります。
ユーザ定義受付の開始処理が完了すると，実行結果を示すダイアログが表示されます。

実行結果を示すダイアログを確認します。

開始処理が成功した場合

［OK］ボタンをクリックして，稼働運用ページに戻ります。

稼働運用ページでは，ユーザ定義受付の状態が「開始状態」になります。また，［開始］ボタンが非活性化し，［停止］ボタンが活性化します。

開始処理が失敗した場合

ダイアログにエラーの内容が表示されます。詳細情報に表示されるメッセージIDを参照して対処してください。

(b)　コマンドの場合

ユーザ定義受付を開始するには，運用環境でcscrcptnstartコマンド，csccompostartコマンド，またはcscutilコマンドを実行します。

cscrcptnstartコマンド，csccompostartコマンド，およびcscutilコマンドは，次の場合に使用します。

cscrcptnstartコマンド

ユーザ定義受付および標準受付を一括して開始する場合に使用します。

HCSCサーバに配備されているユーザ定義受付を一括して開始する場合に使用します。
クラスタ単位で一括して開始することもできます。なお，特定のユーザ定義受付だけを開始することはできません。

該当するリポジトリが存在する運用環境で，ユーザ定義受付を開始する場合に使用します。

csccompostartコマンド

サービスアダプタ，ビジネスプロセス，およびユーザ定義受付を一括して開始する場合に使用します。
ユーザ定義受付だけを一括で開始することはできません。

HCSCサーバに配備されている特定のユーザ定義受付を開始する場合に使用します。
クラスタ単位で特定のユーザ定義受付を開始することもできます。

該当するリポジトリが存在する運用環境で，ユーザ定義受付を開始する場合に使用します。

cscutilコマンド
該当するリポジトリがなく，cscutilが使用できる環境（例えば，JP1で直接運用している実行環境）でユーザ定義受付を開始する場合に使用します。

cscrcptnstartコマンドの場合

運用環境でcscrcptnstartコマンドを実行します。

cscrcptnstartコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「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コマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「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>

cscutilコマンドの場合

運用環境でcscutilコマンドを実行します。-targetオプションにcompo_urecpを，また-operationオプションにstartを指定します。

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

cscutilコマンドの実行形式は，プロパティ定義ファイルを使用するかどうかによって異なります。

プロパティ定義ファイルを使用しない場合

-propsオプションにHCSCサーバ名およびJ2EEサーバ名を指定します。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Cosminexus Manager名> -target compo_urecp -operation start -props "CSCSrvName=<HCSCサーバ名>, J2EESrvName=<J2EEサーバ名>"

cscutilコマンドに指定するCosminexus Manager名，HCSCサーバ名およびJ2EEサーバ名は，cscreplsコマンドで確認できます。cscreplsコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscrepls（リポジトリ情報の表示）」を参照してください。

プロパティ定義ファイルを使用する場合

-propfileオプションにプロパティ定義ファイル名を指定します。プロパティ定義ファイルは，J2SEのプロパティファイル形式であらかじめ作成しておく必要があります。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Cosminexus Manager名> -target compo_urecp -operation start -propfile <プロパティ定義ファイル名>

5.2.9　標準受付を開始する

標準受付の開始の前提条件と開始方法について次に説明します。

＜この項の構成＞

(1)　前提条件

(2)　開始方法

(1)　前提条件

標準受付を開始するには，HCSCサーバが起動状態である必要があります。

HCSCサーバの状態の確認方法については，「5.2.15　HCSCサーバの情報を確認する」を参照してください。

(2)　開始方法

標準受付を開始する方法を次に示します。

注意

標準受付が開始できなかった場合，エラーになった原因を取り除いたあと，標準受付を強制停止してください。標準受付を停止状態にしたあとで，再度標準受付を開始して運用を再開してください。標準受付を強制停止する方法については，「5.2.26　標準受付を停止する」を参照してください。

(a)　画面の場合

運用環境の画面を利用して標準受付を開始する手順を次に示します。

ツリービュー上で，標準受付を開始するHCSCサーバをダブルクリックします。
ダブルクリックしたHCSCサーバの情報がエディタエリアに表示されます。

エディタエリアで［稼働運用］タブを選択します。
稼働運用ページに，手順1で選択したHCSCサーバの稼働運用に関する情報が表示されます。
HCSCサーバの稼働運用ページの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「3.4　稼働運用ページ」を参照してください。

稼働運用ページに表示された内容を確認し，「標準受付」の［開始］ボタンをクリックします。
標準受付の開始を確認するダイアログが表示されます。

ダイアログに表示された内容を確認し，［OK］ボタンをクリックします。
標準受付の開始処理が開始されます。開始処理中のログはコンソールビューに出力されます。
［キャンセル］ボタンをクリックした場合は，開始処理を実行しないで稼働運用ページに戻ります。
標準受付の開始処理が完了すると，実行結果を示すダイアログが表示されます。

実行結果を示すダイアログを確認します。

開始処理が成功した場合

［OK］ボタンをクリックして，稼働運用ページに戻ります。

稼働運用ページでは，標準受付の稼働状態が「開始状態」になります。また，［開始］ボタンが非活性化し，［通常停止］ボタンおよび［計画停止］ボタンが活性化します。

開始処理が失敗した場合

ダイアログにエラーの内容が表示されます。詳細情報に表示されるメッセージIDを参照して対処してください。

(b)　コマンドの場合

標準受付を開始するには，運用環境でcscrcptnstartコマンドまたはcscutilコマンドを実行します。

cscrcptnstartコマンドおよびcscutilコマンドは，次の場合に使用します。

cscrcptnstartコマンド
該当するリポジトリが存在する運用環境で，標準受付を開始する場合。

cscutilコマンド
該当するリポジトリがなく，cscutilが使用できる環境（例えば，JP1で直接運用している実行環境）で標準受付を開始する場合。

cscrcptnstartコマンドの場合

運用環境でcscrcptnstartコマンドを実行します。

cscrcptnstartコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「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コマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscutil（各種操作）」を参照してください。

cscutilコマンドの実行形式は，プロパティ定義ファイルを使用するかどうかによって異なります。

プロパティ定義ファイルを使用しない場合

-propsオプションにHCSCサーバ名およびJ2EEサーバ名を指定します。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Cosminexus Manager名> -target request_service -operation start -props "CSCSrvName=<HCSCサーバ名>, J2EESrvName=<J2EEサーバ名>"

cscutilコマンドに指定するCosminexus Manager名，HCSCサーバ名およびJ2EEサーバ名は，cscreplsコマンドで確認できます。cscreplsコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscrepls（リポジトリ情報の表示）」を参照してください。

プロパティ定義ファイルを使用する場合

-propfileオプションにプロパティ定義ファイル名を指定します。プロパティ定義ファイルは，J2SEのプロパティファイル形式であらかじめ作成しておく必要があります。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Cosminexus Manager名> -target request_service -operation start -propfile <プロパティ定義ファイル名>

5.2.10　データベースの状態を確認する

データベースの状態を参照する方法について次に説明します。

＜この項の構成＞

(1)　参照方法

(1)　参照方法

データベースの状態を参照する方法を次に示します。

(a)　HiRDBの場合

HiRDBの状態を参照するには，データベースサーバでpdlsコマンドを実行します。

pdlsコマンドの詳細については，マニュアル「HiRDB コマンドリファレンス」を参照してください。

(b)　Oracle の場合

Oracleの状態を参照する方法については，Oracle Corporationが発行するドキュメントを参照してください。

5.2.11　PRFの状態を確認する

PRFの状態を参照する前提条件と参照方法について次に説明します。

＜この項の構成＞

(1)　前提条件

(2)　参照方法

(1)　前提条件

PRFの状態を参照するには，HCSC-Manager定義ファイルにPRFが登録されている必要があります。詳細については，「5.2.1(1) 運用する前の準備」の論理サーバの登録についての内容を参照してください。

(2)　参照方法

PRFの状態を参照するには，運用環境でcscstatusコマンドを実行します。-typeオプションに「system」を指定して実行します。

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

cscstatusコマンドの実行形式を次に示します。

cscstatus -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -type system

5.2.12　Hitachi Web Serverの状態を確認する

Hitachi Web Serverの状態を参照する前提条件と参照方法について次に説明します。

＜この項の構成＞

(1)　前提条件

(2)　参照方法

(1)　前提条件

Hitachi Web Serverの状態を参照するには，HCSC-Manager定義ファイルにHitachi Web Serverが登録されている必要があります。詳細については，「5.2.1(1) 運用する前の準備」の論理サーバの登録についての内容を参照してください。

(2)　参照方法

Hitachi Web Serverの状態を参照するには，運用環境でcscstatusコマンドを実行します。-typeオプションに「system」を指定して実行します。

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

cscstatusコマンドの実行形式を次に示します。

cscstatus -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -type system

5.2.13　Cosminexus Managerの状態を確認する

Cosminexus Managerには，Management Serverと運用管理エージェントの二つのプロセスがあります。それぞれの状態を参照する方法について次に説明します。

＜この項の構成＞

(1)　参照方法

(1)　参照方法

(a)　Management Serverの参照方法

Management Serverの状態を参照するには，J2EEサーバ稼働マシンでmngsvrutilコマンドを実行します。

mngsvrutilコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「mngsvrutil（Management Serverの運用管理コマンド）」を参照してください。

(b)　運用管理エージェントの参照方法

運用管理エージェントの状態を参照するには，J2EEサーバ稼働マシンでadminagentcheckコマンドを実行します。

adminagentcheckコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「adminagentcheck（運用管理エージェントの稼働確認）」を参照してください。

5.2.14　HCSCサーバのセットアップ情報を確認する

HCSCサーバのセットアップ情報を参照する前提条件と参照方法について次に説明します。

＜この項の構成＞

(1)　前提条件

(2)　参照方法

(1)　前提条件

HCSCサーバのセットアップ情報を参照するには，HCSCサーバが停止状態または起動状態である必要があります。

HCSCサーバの状態の確認方法については，「5.2.15　HCSCサーバの情報を確認する」を参照してください。

(2)　参照方法

HCSCサーバのセットアップ情報を参照するには，運用環境でcscutilコマンドを実行します。-targetオプションにserverを，また-operationオプションにget_setup_infoを指定します。cscutilコマンドを実行すると，HCSCサーバセットアップ定義ファイルの内容が表示されます。

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

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

cscutilコマンドの実行形式は，プロパティ定義ファイルを使用するかどうかによって異なります。

プロパティ定義ファイルを使用しない場合

-propsオプションにHCSCサーバ名を指定します。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Cosminexus Manager名> -target server -operation get_setup_info -props "CSCSrvName=<HCSCサーバ名>"

cscutilコマンドに指定するCosminexus Manager名およびHCSCサーバ名は，cscreplsコマンドで確認できます。cscreplsコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscrepls（リポジトリ情報の表示）」を参照してください。

プロパティ定義ファイルを使用する場合

-propfileオプションにプロパティ定義ファイル名を指定します。プロパティ定義ファイルは，J2SEのプロパティファイル形式であらかじめ作成しておく必要があります。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Cosminexus Manager名> -target server -operation get_setup_info -propfile <プロパティ定義ファイル名>

5.2.15　HCSCサーバの情報を確認する

HCSCサーバの情報は，画面とコマンドで参照できる情報が異なります。参照できる情報の詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の該当する画面，コマンドの内容を参照してください。

HCSCサーバの情報を参照する前提条件と参照方法について次に説明します。

＜この項の構成＞

(1)　前提条件

(2)　参照方法

(1)　前提条件

HCSCサーバの情報を参照するには，HCSCサーバが構築後である必要があります。

(2)　参照方法

HCSCサーバの情報を参照する方法を次に示します。

(a)　画面の場合

ツリービュー上で，情報を参照するHCSCサーバをダブルクリックします。ダブルクリックしたHCSCサーバの情報は，エディタエリアに表示されます。エディタエリアの基本情報ページおよび稼働運用ページを表示して，HCSCサーバの情報を確認できます。

HCSCサーバの基本情報ページの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「3.2　基本情報ページ」を参照してください。HCSCサーバの稼働運用ページの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「3.4　稼働運用ページ」を参照してください。

なお，HCSCサーバの稼働状態については，ツリービューに表示されるアイコンで確認することもできます。表示されるアイコンの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「3.1　画面構成（運用環境）」を参照してください。

(b)　コマンドの場合

HCSCサーバの情報を参照するには，cscstatusコマンド，csmlsstateコマンド，またはcscutilコマンドを実行します。

cscstatusコマンドおよびcscutilコマンドは運用環境から，csmlsstateコマンドは実行環境から実行できます。各コマンドは，次の場合に使用します。

cscstatusコマンド
HCSCサーバの動的情報（稼働状況）を参照する場合に使用します。

csmlsstateコマンド
HCSCサーバの動的情報（稼働状況），および静的情報（HCSCサーバランタイム定義ファイルで設定した定義情報）を参照する場合に使用します。
ユーザが設定した情報，または実際の動作に反映されている情報が定義情報として出力されます。ユーザが設定した情報は，HCSCサーバの起動時，または標準受付もしくはユーザ定義受付の開始時に実際の動作に反映されます。
次のどちらかの場合には，実際の動作に反映されていない定義情報が出力されます。

HCSCサーバの起動中に定義情報を設定し，そのあとHCSCサーバを再起動しない場合

標準受付またはユーザ定義受付の開始中に定義情報を設定し，そのあと標準受付またはユーザ定義受付を再開始しない場合

cscutilコマンド
HCSCサーバの静的情報（HCSCサーバセットアップ定義ファイル，またはHCSCサーバランタイム定義ファイルで設定した定義情報）を参照する場合に使用します。
実際の動作に反映されている情報が定義情報として出力されます。ユーザが設定した情報は，HCSCサーバの起動時，または標準受付もしくはユーザ定義受付の開始時に反映されます。
次のどちらかの場合には，前回HCSCサーバを起動したとき，または標準受付もしくはユーザ定義受付を開始したときに設定した情報が出力されます。

HCSCサーバの起動中に定義情報を設定し，そのあとHCSCサーバを再起動しない場合

標準受付またはユーザ定義受付の開始中に定義情報を設定し，そのあと標準受付またはユーザ定義受付を再開始しない場合

cscstatusコマンドの場合

運用環境でcscstatusコマンドを実行します。

cscstatusコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「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

csmlsstateコマンドの場合

実行環境でcsmlsstateコマンドを実行します。情報を参照するHCSCサーバの名称を指定して実行します。

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

csmlsstateコマンドの実行形式を次に示します。

ユーザが設定した情報を参照する場合

情報を参照するHCSCサーバの名称と-dオプションを指定して実行します。-dオプションには「prop」を指定します。

csmlsstate <HCSCサーバ名> -d prop

実際の動作に反映されている情報を参照する場合

情報を参照するHCSCサーバの名称と-dオプションを指定して実行します。-dオプションには「runtime」を指定します。

csmlsstate <HCSCサーバ名> -d runtime

cscutilコマンドの場合

運用環境でcscutilコマンドを実行します。-targetオプションにserverを，また-operationオプションにget_infoを指定します。

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

cscutilコマンドの実行形式は，プロパティ定義ファイルを使用するかどうかによって異なります。

プロパティ定義ファイルを使用しない場合

-propsオプションにHCSCサーバ名を指定します。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Cosminexus Manager名> -target server -operation get_info -props "CSCSrvName=<HCSCサーバ名>"

cscutilコマンドに指定するCosminexus Manager名およびHCSCサーバ名は，cscreplsコマンドで確認できます。cscreplsコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscrepls（リポジトリ情報の表示）」を参照してください。

プロパティ定義ファイルを使用する場合

-propfileオプションにプロパティ定義ファイル名を指定します。プロパティ定義ファイルは，J2SEのプロパティファイル形式であらかじめ作成しておく必要があります。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Cosminexus 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（停止失敗状態）

5.2.16　HCSCサーバのリソース稼働情報を確認する

HCSCサーバのリソース稼働情報に関する情報は，画面とコマンドで参照できます。画面とコマンドで参照できる情報は同じです。参照できる情報の詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の該当する画面，コマンドの内容を参照してください。

リソースの稼働情報を確認することで，リソースが正常な範囲内で使用されているかをチェックできます。また，標準受付，ユーザ定義受付，およびHCSCコンポーネントを停止する前に，これらを安全に停止できるかどうかをチェックできます。

稼働情報は，実行環境からデフォルト値では60秒ごとにHCSCサーバに通知されます。稼働情報がHCSCサーバに通知されると，画面およびコマンドで表示される情報が更新されます。稼働情報がHCSCサーバに通知される間隔を変更したい場合は，次に示すマニュアルを参照してください。

運用環境ポータルから変更する場合

マニュアル「Cosminexus アプリケーションサーバ 運用管理ポータル操作ガイド」の「10.9.17　稼働情報監視の設定（J2EEサーバ）」を参照してください。

Smart Composer機能を使って変更する場合

マニュアル「Cosminexus アプリケーションサーバ 機能解説 運用／監視／連携編」の「3.3　稼働情報ファイルの出力機能」と「3.4　イベントの発行機能」を参照してください。

なお，リソース稼働情報は，統計情報として参照できます。リソース稼働情報の統計情報の参照方法については，「付録E　HCSCサーバのリソース稼働情報の統計情報」を参照してください。

HCSCサーバのリソース稼働情報を確認する際の前提条件と参照方法について次に説明します。

＜この項の構成＞

(1)　前提条件

(2)　参照方法

(1)　前提条件

HCSCサーバのリソース稼働情報を確認するには，HCSCサーバがセットアップ済みである必要があります。

HCSCサーバの状態の確認方法については，「5.2.15　HCSCサーバの情報を確認する」を参照してください。

(2)　参照方法

HCSCサーバのリソース稼働情報を確認する方法を次に示します。

(a)　画面の場合

ツリービュー上で，リソース稼働情報を確認するHCSCサーバをダブルクリックします。ダブルクリックしたHCSCサーバの情報は，エディタエリアに表示されます。エディタエリアで［稼働確認］タブを選択します。HCSCサーバのリソース稼働情報に関する情報が表示されます。

HCSCサーバの稼働確認ページの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「3.5　稼働確認ページ」を参照してください。

(b)　コマンドの場合

HCSCサーバのリソース稼働情報を確認するには，運用環境でcscresinfoコマンドを実行します。

cscresinfoコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscresinfo（リソース稼働情報の表示）」を参照してください。

5.2.17　サービスアダプタの情報を確認する

サービスアダプタに関する情報は，画面とコマンドで参照できる情報が異なります。参照できる情報の詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の該当する画面，コマンドの内容を参照してください。

サービスアダプタの情報を参照するための前提条件と参照方法について次に説明します。

＜この項の構成＞

(1)　前提条件

(2)　参照方法

(1)　前提条件

サービスアダプタの情報を参照するには，HCSCサーバが起動状態である必要があります。

HCSCサーバの状態の確認方法については，「5.2.15　HCSCサーバの情報を確認する」を参照してください。

(2)　参照方法

サービスアダプタの情報を参照する方法を次に示します。

(a)　画面の場合

ツリービュー上で，サービスアダプタをダブルクリックします。ダブルクリックしたサービスアダプタの情報は，エディタエリアに表示されます。エディタエリアの稼働運用ページで，サービスアダプタの情報が参照できます。

サービスアダプタの稼働運用ページの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「3.4　稼働運用ページ」を参照してください。

なお，サービスアダプタの稼働状態については，ツリービューに表示されるアイコンで確認することもできます。表示されるアイコンの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「3.1　画面構成（運用環境）」を参照してください。

(b)　コマンドの場合

サービスアダプタの情報を参照するには，cscstatusコマンド，csmlslocationコマンド，またはcscutilコマンドを実行します。

cscstatusコマンドおよびcscutilコマンドは運用環境から，csmlslocationコマンドは実行環境から実行できます。各コマンドは，次の場合に使用します。

cscstatusコマンド
サービスアダプタの動的情報（稼働状況），サービスアダプタのサービスID，および更新時間を参照する場合に使用します。

csmlslocationコマンド
サービスアダプタの動的情報（稼働状況），および静的情報（定義情報）を参照する場合に使用します。

cscutilコマンド
サービスアダプタの静的情報（定義情報）を参照する場合に使用します。

cscstatusコマンドの場合

運用環境でcscstatusコマンドを実行します。-cscオプションと-typeオプションを指定して実行します。-typeオプションには「compo」を指定します。

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

cscstatusコマンドの実行形式を次に示します。

cscstatus -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -type compo

csmlslocationコマンドの場合

実行環境でcsmlslocationコマンドを実行します。情報を参照するサービスアダプタが配備されているHCSCサーバの名称と，-kオプションにadpを指定して実行します。

csmlslocationコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「csmlslocation（サービスアダプタまたはビジネスプロセスの情報の表示）」を参照してください。

csmlslocationコマンドの実行形式を次に示します。

csmlslocation <HCSCサーバ名> -k adp

なお，-kオプションの代わりに-allオプションを指定すると，HCSCサーバに登録されているすべてのHCSCコンポーネント（およびサービスグループ）の情報を参照できます。

cscutilコマンドの場合

運用環境でcscutilコマンドを実行します。-targetオプションにcompoを，また-operationオプションにget_adapter_infoを指定します。

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

cscutilコマンドの実行形式は，プロパティ定義ファイルを使用するかどうかによって異なります。

プロパティ定義ファイルを使用しない場合

-propsオプションにHCSCサーバ名およびサービスアダプタのサービスIDを指定します。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Cosminexus Manager名> -target compo -operation get_adapter_info -props "CSCSrvName=<HCSCサーバ名>, AdapterName=<サービスアダプタのサービスID>"

cscutilコマンドに指定するCosminexus Manager名，HCSCサーバ名およびサービスアダプタのサービスIDは，cscreplsコマンドで確認できます。cscreplsコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscrepls（リポジトリ情報の表示）」を参照してください。

プロパティ定義ファイルを使用する場合

-propfileオプションにプロパティ定義ファイル名を指定します。プロパティ定義ファイルは，J2SEのプロパティファイル形式であらかじめ作成しておく必要があります。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Cosminexus 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.<通番>※
キュー名称が表示されます。

modifiedTime.<通番>
サービスアダプタが更新された時刻（1970年1月1日00:00:00からの通算ミリ秒）が出力されます。

lcVersion.<通番>
ロケーションのバージョン番号が出力されます。

lcRevision.<通番>
ロケーションのリビジョン番号が出力されます。

注※　サービスアダプタの種別がMDB（WS-R）またはMDB（DBキュー）の場合にだけ出力されます。

5.2.18　ビジネスプロセスの情報を確認する

ビジネスプロセスに関する情報は，画面とコマンドで参照できる情報が異なります。参照できる情報の詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の該当する画面，コマンドの内容を参照してください。

ビジネスプロセスの情報を参照するための前提条件と参照方法について次に説明します。

＜この項の構成＞

(1)　前提条件

(2)　参照方法

(1)　前提条件

ビジネスプロセスの情報を参照するには，HCSCサーバが起動状態である必要があります。

HCSCサーバの状態の確認方法については，「5.2.15　HCSCサーバの情報を確認する」を参照してください。

(2)　参照方法

ビジネスプロセスの情報を参照する方法を次に示します。

(a)　画面の場合

ツリービュー上で，ビジネスプロセスをダブルクリックします。ダブルクリックしたビジネスプロセスの情報は，エディタエリアに表示されます。エディタエリアの稼働運用ページで，ビジネスプロセスの情報が参照できます。

ビジネスプロセスの稼働運用ページの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「3.4　稼働運用ページ」を参照してください。

なお，ビジネスプロセスの稼働状態については，ツリービューに表示されるアイコンで確認することもできます。表示されるアイコンの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「3.1　画面構成（運用環境）」を参照してください。

(b)　コマンドの場合

ビジネスプロセスの情報を参照するには，cscstatusコマンド，csmlslocationコマンド，またはcscutilコマンドを実行します。

cscstatusコマンドおよびcscutilコマンドは運用環境から，csmlslocationコマンドは実行環境から実行できます。各コマンドは，次の場合に使用します。

cscstatusコマンド
ビジネスプロセスの動的情報（稼働状況），ビジネスプロセスのサービスID，および更新時間を参照する場合に使用します。

csmlslocationコマンド
ビジネスプロセスの動的情報（稼働状況），および静的情報（定義情報）を参照する場合に使用します。

cscutilコマンド
ビジネスプロセスの静的情報（定義情報）を参照する場合に使用します。

cscstatusコマンドの場合

運用環境でcscstatusコマンドを実行します。-cscオプションと-typeオプションを指定して実行します。-typeオプションには「compo」を指定します。

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

cscstatusコマンドの実行形式を次に示します。

cscstatus -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -type compo

csmlslocationコマンドの場合

実行環境でcsmlslocationコマンドを実行します。情報を参照するビジネスプロセスが配備されているHCSCサーバの名称と，-kオプションにbpを指定して実行します。

csmlslocationコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「csmlslocation（サービスアダプタまたはビジネスプロセスの情報の表示）」を参照してください。

csmlslocationコマンドの実行形式を次に示します。

csmlslocation <HCSCサーバ名> -k bp

なお，-kオプションの代わりに-allオプションを指定すると，HCSCサーバに登録されているすべてのHCSCコンポーネント（およびサービスグループ）の情報を参照できます。

cscutilコマンドの場合

運用環境でcscutilコマンドを実行します。-targetオプションにcompoを，また-operationオプションにget_bp_infoを指定します。

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

cscutilコマンドの実行形式は，プロパティ定義ファイルを使用するかどうかによって異なります。

プロパティ定義ファイルを使用しない場合

-propsオプションにHCSCサーバ名およびビジネスプロセスのサービスIDを指定します。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Cosminexus Manager名> -target compo -operation get_bp_info -props "CSCSrvName=<HCSCサーバ名>, AdapterName=<ビジネスプロセスのサービスID>"

cscutilコマンドに指定するCosminexus Manager名，HCSCサーバ名およびビジネスプロセスのサービスIDは，cscreplsコマンドで確認できます。cscreplsコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscrepls（リポジトリ情報の表示）」を参照してください。

プロパティ定義ファイルを使用する場合

-propfileオプションにプロパティ定義ファイル名を指定します。プロパティ定義ファイルは，J2SEのプロパティファイル形式であらかじめ作成しておく必要があります。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Cosminexus 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.2.19　ユーザ定義受付の情報を確認する

ユーザ定義受付の情報を参照する前提条件と参照方法について次に説明します。

＜この項の構成＞

(1)　前提条件

(2)　参照方法

(1)　前提条件

ユーザ定義受付の情報を参照するには，HCSCサーバが起動状態である必要があります。

HCSCサーバの状態の確認方法については，「5.2.15　HCSCサーバの情報を確認する」を参照してください。

(2)　参照方法

ユーザ定義受付の情報を参照するには，cscstatusコマンド，csmlsreceptionコマンド，またはcscutilコマンドを実行します。

cscstatusコマンドおよびcscutilコマンドは運用環境から，csmlsreceptionコマンドは実行環境から実行できます。各コマンドは，次の場合に使用します。

cscstatusコマンド
ユーザ定義受付の動的情報（稼働状況），ユーザ定義受付の受付ID，および更新時間を参照する場合に使用します。

csmlsreceptionコマンド
ユーザ定義受付の動的情報（稼働状況），および静的情報（ユーザ定義受付ランタイム定義ファイルで設定した定義情報）を参照する場合に使用します。
ユーザが設定した情報，および実際の動作に反映されている情報が定義情報として出力されます。ユーザが設定した情報は，HCSCサーバの起動時，または標準受付もしくはユーザ定義受付の開始時に実際の動作に反映されます。
次のどちらかの場合には，実際の動作に反映されていない定義情報が出力されます。

HCSCサーバの起動中に定義情報を設定し，そのあとHCSCサーバを再起動しない場合

標準受付またはユーザ定義受付の開始中に定義情報を設定し，そのあと標準受付またはユーザ定義受付を再開始しない場合

cscutilコマンド
ユーザ定義受付の静的情報（ユーザ定義受付ランタイム定義ファイルで設定した定義情報）を参照する場合に使用します。
実際の動作に反映されている情報が定義情報として出力されます。ユーザが設定した情報は，HCSCサーバの起動時，または標準受付もしくはユーザ定義受付の開始時に反映されます。
次のどちらかの場合には，前回HCSCサーバを起動したとき，または標準受付もしくはユーザ定義受付を開始したときに設定した情報が出力されます。

HCSCサーバの起動中に定義情報を設定し，そのあとHCSCサーバを再起動しない場合

標準受付またはユーザ定義受付の開始中に定義情報を設定し，そのあと標準受付またはユーザ定義受付を再開始しない場合

cscstatusコマンドの場合

運用環境でcscstatusコマンドを実行します。-cscオプションと-typeオプションを指定して実行します。-typeオプションには「compo」を指定します。

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

cscstatusコマンドの実行形式を次に示します。

cscstatus -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -type compo

csmlsreceptionコマンドの場合

実行環境でcsmlsreceptionコマンドを実行します。

csmlsreceptionコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「csmlsreception（ユーザ定義受付の情報の表示）」を参照してください。

csmlsreceptionコマンドの実行形式を次に示します。

すべてのユーザ定義受付の情報を参照する場合

HCSCサーバ名と-allオプションを指定して実行します。

csmlsreception <HCSCサーバ名> -all

特定のユーザ定義受付の情報を参照する場合

HCSCサーバ名と-iオプションを指定して実行します。-iオプションにはユーザ定義受付の受付IDを指定します。

csmlsreception <HCSCサーバ名> -i <ユーザ定義受付の受付ID>

ユーザ定義受付に関連するサービス（ビジネスプロセス）の情報を参照する場合

HCSCサーバ名と-sオプションを指定して実行します。-sオプションには関連するサービス名（ビジネスプロセスのサービス名）を指定します。

csmlsreception <HCSCサーバ名> -s <関連するサービス名>

cscutilコマンドの場合

運用環境でcscutilコマンドを実行します。-targetオプションにcompo_urecpを，また-operationオプションにget_infoを指定します。

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

cscutilコマンドの実行形式は，プロパティ定義ファイルを使用するかどうかによって異なります。

プロパティ定義ファイルを使用しない場合

-propsオプションにHCSCサーバ名を指定します。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Cosminexus Manager名> -target compo_urecp -operation get_info -props "CSCSrvName=<HCSCサーバ名>"

cscutilコマンドに指定するCosminexus Manager名およびHCSCサーバ名は，cscreplsコマンドで確認できます。cscreplsコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscrepls（リポジトリ情報の表示）」を参照してください。

プロパティ定義ファイルを使用する場合

-propfileオプションにプロパティ定義ファイル名を指定します。プロパティ定義ファイルは，J2SEのプロパティファイル形式であらかじめ作成しておく必要があります。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Cosminexus 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.2.20　HCSCサーバの定義を変更する

HCSCサーバの定義情報を変更する場合，HCSCサーバの定義情報を設定する場合と同じ方法で行います。HCSCサーバの定義情報を設定する方法の詳細については，「3.1.4　HCSCサーバの定義情報を設定する」を参照してください。

5.2.21　ユーザ定義受付の定義情報を変更する

ユーザ定義受付の定義情報を変更する前提条件と変更方法について次に説明します。

＜この項の構成＞

(1)　前提条件

(2)　変更方法

(1)　前提条件

ユーザ定義受付の定義情報を変更するには，HCSCサーバが起動状態である必要があります。

HCSCサーバの状態の確認方法については，「5.2.15　HCSCサーバの情報を確認する」を参照してください。

(2)　変更方法

ユーザ定義受付の定義情報を変更する手順を次に示します。

ユーザ定義受付の定義情報を確認します。
運用環境から確認する場合はcscutilコマンドを，実行環境から確認する場合はcsmlsreceptionコマンドを実行します。
ユーザ定義受付の定義情報の確認方法については，「3.1.16　ユーザ定義受付の定義情報を確認する」を参照してください。

ユーザ定義受付を停止します。
ユーザ定義受付の停止方法については，「5.2.27　ユーザ定義受付を停止する」を参照してください。

ユーザ定義受付の定義情報を取得します。
csccompoconfigコマンドの-operationオプションにgetを指定して，ユーザ定義受付の定義情報を取得します。
csccompoconfigコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「csccompoconfig（HCSCコンポーネントの定義）」を参照してください。

取得したユーザ定義受付の定義情報を変更します。
ユーザ定義受付ランタイム定義ファイルのパラメタの値を変更し，ユーザ定義受付の定義情報を変更します。
ユーザ定義受付ランタイム定義ファイルの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「ユーザ定義受付ランタイム定義ファイル」を参照してください。

ユーザ定義受付の定義情報を設定します。
ユーザ定義受付の定義情報の設定方法については，「3.1.15　ユーザ定義受付の定義情報を設定する」を参照してください。

ユーザ定義受付の定義情報を確認します。
ユーザ定義受付の定義情報の確認方法については，「3.1.16　ユーザ定義受付の定義情報を確認する」を参照してください。

ユーザ定義受付を開始します。
ユーザ定義受付の開始方法については，「5.2.8　ユーザ定義受付を開始する」を参照してください。

ユーザ定義受付の情報を確認します。
運用環境から確認する場合はcscutilコマンドを，実行環境から確認する場合はcsmlsreceptionコマンドを実行します。
ユーザ定義受付の情報の確認方法については，「5.2.19　ユーザ定義受付の情報を確認する」を参照してください。

5.2.22　HCSCコンポーネントの構成を変更する

開発環境でHCSCコンポーネントの定義を変更した場合，リポジトリを利用して変更した定義を運用環境に受け渡します。運用環境では，開発環境で変更した定義情報に従って，HCSCコンポーネントの構成を変更します。

HCSCコンポーネントの構成を変更する前提条件と変更方法について次に説明します。

＜この項の構成＞

(1)　前提条件

(2)　変更方法

(1)　前提条件

HCSCコンポーネントの構成を変更するには，次の条件を満たす必要があります。

HCSCサーバが起動状態であること
HCSCサーバの状態の確認方法については，「5.2.15　HCSCサーバの情報を確認する」を参照してください。

Management Serverが起動状態であること
Management Serverの状態の確認方法については，「5.2.13　Cosminexus Managerの状態を確認する」を参照してください。

運用管理エージェントが起動状態であること
運用管理エージェントの状態の確認方法については，「5.2.13　Cosminexus Managerの状態を確認する」を参照してください。

データベースが起動状態であること
データベースの状態の確認方法については，「5.2.10　データベースの状態を確認する」を参照してください。

(2)　変更方法

HCSCコンポーネントの構成を変更する手順を次に示します。

リポジトリ情報の差分を確認します。
リポジトリ情報の差分の確認方法については，「4.5　リポジトリの差分情報の参照」を参照してください。

HCSCコンポーネントを停止します。
csccompostopコマンドに-clusterオプションを指定して，クラスタ内のすべてのHCSCサーバに配備されているHCSCコンポーネントを一括して停止します。
HCSCコンポーネントの停止方法については，「5.2.27　ユーザ定義受付を停止する」，「5.2.28　サービスアダプタを停止する」，および「5.2.29　ビジネスプロセスを停止する」を参照してください。

HCSCコンポーネントを削除します。
csccompoundeployコマンドに-clusterオプションを指定して，クラスタ内のすべてのHCSCサーバに配備されているHCSCコンポーネントを一括して削除します。
HCSCコンポーネントの削除方法については，「3.2.1　サービスアダプタを削除する」，「3.2.2　ビジネスプロセスを削除する」，および「3.2.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.2.6　サービスアダプタを開始する」，「5.2.7　ビジネスプロセスを開始する」，および「5.2.8　ユーザ定義受付を開始する」を参照してください。

5.2.23　サービス部品の接続先を変更する

運用環境では，サービスアダプタの接続先情報を変更できます。

サービス部品の接続先を変更する前提条件と変更方法について次に説明します。

＜この項の構成＞

(1)　前提条件

(2)　変更方法

(1)　前提条件

サービス部品の接続先を変更するには，次の条件を満たす必要があります。

HCSCサーバが起動状態であること
HCSCサーバの状態の確認方法については，「5.2.15　HCSCサーバの情報を確認する」を参照してください。

(2)　変更方法

サービス部品の接続先を変更する手順を次に示します。

サービスアダプタを停止します。
csccompostopコマンドに-clusterオプションを指定して，クラスタ内のすべてのHCSCサーバに配備されているサービスアダプタを一括して停止します。
サービスアダプタの停止方法については，「5.2.28　サービスアダプタを停止する」を参照してください。

サービスアダプタを削除します。
csccompoundeployコマンドに-clusterオプションを指定して，クラスタ内のすべてのHCSCサーバに配備されているサービスアダプタを一括して削除します。
サービスアダプタの削除方法については，「3.2.1　サービスアダプタを削除する」を参照してください。

サービス情報を取得および更新し，サービスの接続先を変更します。
サービス情報の取得および更新方法については，「3.1.6　サービス情報を変更する」を参照してください。
なお，サービス部品の接続先を変更する場合，サービス情報の更新で，サービス情報変更定義ファイルの次のパラメタの値を変更してください。サービス情報変更定義ファイルの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「サービス情報変更定義ファイル」を参照してください。

Webサービス用サービスアダプタの場合

<クラスタ名>.<サービス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.2.6　サービスアダプタを開始する」を参照してください。

5.2.24　流量制御値を変更する

運用環境では，標準受付（同期受付（Webサービス））およびユーザ定義受付の流量制御値を変更できます。

標準受付（同期受付（Webサービス））およびユーザ定義受付の流量制御値を変更する前提条件と変更方法について次に説明します。

＜この項の構成＞

(1)　前提条件

(2)　変更方法

(1)　前提条件

標準受付（同期受付（Webサービス））およびユーザ定義受付の流量制御値を変更するには，次の条件を満たす必要があります。

Management Serverが起動状態であること
Management Serverの状態の確認方法については，「5.2.13　Cosminexus Managerの状態を確認する」を参照してください。

運用管理エージェントが起動状態であること
運用管理エージェントの状態の確認方法については，「5.2.13　Cosminexus Managerの状態を確認する」を参照してください。

(2)　変更方法

標準受付（同期受付（Webサービス））およびユーザ定義受付の流量制御値を変更する手順を次に示します。

(a)　標準受付（同期受付（Webサービス））の流量制御値を変更する場合

標準受付（同期受付（Webサービス））の流量制御値を変更する手順を次に示します。

HCSCサーバランタイム定義ファイルを更新し，流量制御値を変更します。
流量制御値を変更する場合，HCSCサーバランタイム定義ファイルの次のプロパティの値を変更してください。HCSCサーバランタイム定義ファイルの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「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.2.21　ユーザ定義受付の定義情報を変更する」を参照してください。

なお，流量制御値を変更する場合，ユーザ定義受付ランタイム定義ファイルの次のパラメタの値を変更してください。ユーザ定義受付ランタイム定義ファイルの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「ユーザ定義受付ランタイム定義ファイル」を参照してください。

user-defined-reception-soap.threads.maximum=最大同時実行数
user-defined-reception-soap.exclusive.threads=占有スレッド数
user-defined-reception-soap.queue-size=実行待ちキューサイズ

注意

設定した情報は，ユーザ定義受付の開始時に反映されます。

5.2.25　サービス部品呼び出しの通信タイムアウト値を変更する

運用環境では，Webサービス用のサービスアダプタ，およびSessionBean用のサービスアダプタのサービス部品呼び出しの通信タイムアウト値を変更できます。

Webサービス用のサービスアダプタ，およびSessionBean用のサービスアダプタのサービス部品呼び出しの通信タイムアウト値を変更する前提条件と変更方法について次に説明します。

＜この項の構成＞

(1)　前提条件

(2)　変更方法

(1)　前提条件

Webサービス用のサービスアダプタ，およびSessionBean用のサービスアダプタのサービス部品呼び出しの通信タイムアウト値を変更するには，次の条件を満たす必要があります。

HCSCサーバが起動状態であること
HCSCサーバの状態の確認方法については，「5.2.15　HCSCサーバの情報を確認する」を参照してください。

(2)　変更方法

Webサービス用のサービスアダプタ，およびSessionBean用のサービスアダプタのサービス部品呼び出しの通信タイムアウト値を変更する手順を次に示します。

サービスアダプタを停止します。
csccompostopコマンドに-clusterオプションを指定して，クラスタ内のすべてのHCSCサーバに配備されているサービスアダプタを一括して停止します。
サービスアダプタの停止方法については，「5.2.28　サービスアダプタを停止する」を参照してください。

サービスアダプタを削除します。
csccompoundeployコマンドに-clusterオプションを指定して，クラスタ内のすべてのHCSCサーバに配備されているサービスアダプタを一括して削除します。
サービスアダプタの削除方法については，「3.2.1　サービスアダプタを削除する」を参照してください。

サービス情報を取得および更新し，サービス呼び出しの通信タイムアウト値を変更します。
サービス情報の取得および更新方法については，「3.1.6　サービス情報を変更する」を参照してください。
なお，サービス部品呼び出しの通信タイムアウト値を変更する場合，サービス情報の更新で，サービス情報変更定義ファイルの次のパラメタの値を変更してください。サービス情報変更定義ファイルの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「サービス情報変更定義ファイル」を参照してください。

Webサービス用サービスアダプタ（SOAP1.1モード）の場合

<クラスタ名>.<サービスID>.WebService.c4web.application.socket_read_timeout=読み込みタイムアウト値
<クラスタ名>.<サービスID>.WebService.c4web.application.socket_connect_timeout=接続タイムアウト値
<クラスタ名>.<サービスID>.WebService.c4web.application.socket_write_timeout=書き込みタイムアウト値

Webサービス用サービスアダプタ（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.2.6　サービスアダプタを開始する」を参照してください。

5.2.26　標準受付を停止する

標準受付の停止方法には，通常停止，計画停止および強制停止があります。

通常停止

同期受付の場合

仕掛かり中の実行要求を処理したあと，標準受付を停止します。

非同期受付の場合

サービスリクエスタからの実行要求を受け付けない状態にして，仕掛かり中の実行要求を処理したあとに，標準受付を停止します。キュー内には，受け付けた実行要求が処理されないで残ります。

通常停止したあと，標準受付を再度開始すると，キュー内に残っていた実行要求から処理が開始されます。

通常停止したあとにHCSCサーバをアンセットアップした場合，キュー内に残っている実行要求は破棄されます。

計画停止

標準受付を停止したあとにHCSCサーバをアンセットアップする場合に利用する停止方法です。計画停止を実行すると，次のように標準受付が停止されます。

同期受付の場合

仕掛かり中の実行要求を処理したあと，標準受付を停止します。

非同期受付の場合

サービスリクエスタからの実行要求を受け付けない状態にして，キュー内に残っている実行要求をすべて処理したあとに，標準受付を停止します。

強制停止

コマンドでだけ実行できます。ほかのコマンドの実行中や標準受付の停止失敗中でも強制的に停止できます。

標準受付の停止の前提条件と停止方法について次に説明します。

＜この項の構成＞

(1)　前提条件

(2)　停止方法

(1)　前提条件

標準受付を停止するには，次の条件を満たす必要があります。

HCSCサーバが起動状態であること

標準受付が開始状態であること

HCSCサーバおよび標準受付の状態の確認方法については，「5.2.15　HCSCサーバの情報を確認する」を参照してください。

(2)　停止方法

標準受付を停止する方法を次に示します。

注意

標準受付が停止できなかった場合，エラーになった原因を取り除いたあと，標準受付を強制停止してください。標準受付を停止状態にしたあとで，再度標準受付を開始して運用を再開してください。標準受付を開始する方法については，「5.2.9　標準受付を開始する」を参照してください。

(a)　画面の場合

運用環境の画面を利用して標準受付を停止する手順を次に示します。

ツリービュー上で，標準受付を停止するHCSCサーバをダブルクリックします。
ダブルクリックしたHCSCサーバの情報がエディタエリアに表示されます。

エディタエリアで［稼働運用］タブを選択します。
稼働運用ページに，手順1で選択したHCSCサーバの稼働運用に関する情報が表示されます。
HCSCサーバの稼働運用ページの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「3.4　稼働運用ページ」を参照してください。

稼働運用ページに表示された内容を確認し，「標準受付」の［通常停止］ボタンまたは［計画停止］ボタンをクリックします。
標準受付の停止を確認するダイアログが表示されます。

ダイアログに表示された内容を確認し，［OK］ボタンをクリックします。
標準受付の停止処理が開始されます。停止処理中のログはコンソールビューに出力されます。
［キャンセル］ボタンをクリックした場合は，停止処理を実行しないで稼働運用ページに戻ります。
標準受付の停止処理が完了すると，実行結果を示すダイアログが表示されます。

実行結果を示すダイアログを確認します。

停止処理が成功した場合

［OK］ボタンをクリックして，稼働運用ページに戻ります。

稼働運用ページでは，標準受付の稼働状態が「停止状態」になります。また，［通常停止］ボタンおよび［計画停止］ボタンが非活性化し，［開始］ボタンが活性化します。

停止処理が失敗した場合

ダイアログにエラーの内容が表示されます。詳細情報に表示されるメッセージIDを参照して対処してください。

(b)　コマンドの場合

標準受付を停止するには，運用環境でcscrcptnstopコマンドまたはcscutilコマンドを実行します。

cscrcptnstopコマンドおよびcscutilコマンドは，次の場合に使用します。

cscrcptnstopコマンド
該当するリポジトリが存在する運用環境で，標準受付を停止する場合。

cscutilコマンド
該当するリポジトリがなく，cscutilが使用できる環境（例えば，JP1で直接運用している実行環境）で標準受付を停止する場合。

cscrcptnstopコマンドの場合

運用環境でcscrcptnstopコマンドを実行します。

cscrcptnstopコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「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コマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscutil（各種操作）」を参照してください。

cscutilコマンドの実行形式は，プロパティ定義ファイルを使用するかどうかによって異なります。

プロパティ定義ファイルを使用しない場合

-propsオプションにHCSCサーバ名，J2EEサーバ名および停止フラグを指定します。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Cosminexus Manager名> -target request_service -operation stop -props "CSCSrvName=<HCSCサーバ名>, J2EESrvName=<J2EEサーバ名>, ForceFlag=<停止フラグ>"

cscutilコマンドに指定するCosminexus Manager名，HCSCサーバ名およびJ2EEサーバ名は，cscreplsコマンドで確認できます。cscreplsコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscrepls（リポジトリ情報の表示）」を参照してください。

また，停止フラグには，通常停止，計画停止または強制停止のどれを実行するか指定します。停止フラグには，次のどれかを指定してください。

通常停止：NORMAL_OPTION

計画停止：WAIT_OPTION

強制停止：FORCE_OPTION

プロパティ定義ファイルを使用する場合

-propfileオプションにプロパティ定義ファイル名を指定します。プロパティ定義ファイルは，J2SEのプロパティファイル形式であらかじめ作成しておく必要があります。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Cosminexus Manager名> -target request_service -operation stop -propfile <プロパティ定義ファイル名>

5.2.27　ユーザ定義受付を停止する

ユーザ定義受付の停止の前提条件と停止方法について次に説明します。

＜この項の構成＞

(1)　前提条件

(2)　停止方法

(1)　前提条件

ユーザ定義受付を停止するには，次の条件を満たす必要があります。

HCSCサーバが起動状態であること
HCSCサーバの状態の確認方法については，「5.2.15　HCSCサーバの情報を確認する」を参照してください。

ユーザ定義受付が開始状態であること
ユーザ定義受付の確認方法については，「5.2.19　ユーザ定義受付の情報を確認する」を参照してください。

(2)　停止方法

ユーザ定義受付を停止するには，運用環境でcscrcptnstopコマンド，csccompostopコマンド，またはcscutilコマンドを実行します。

cscrcptnstopコマンド，csccompostopコマンド，およびcscutilコマンドは，次の場合に使用します。

cscrcptnstopコマンド

ユーザ定義受付および標準受付を一括して停止する場合に使用します。

HCSCサーバに配備されているユーザ定義受付を一括して停止する場合に使用します。

クラスタ単位で一括して停止することもできます。なお，特定のユーザ定義受付だけを停止することはできません。

該当するリポジトリが存在する運用環境で，ユーザ定義受付を停止する場合に使用します。

csccompostopコマンド

サービスアダプタ，ビジネスプロセス，およびユーザ定義受付を一括して停止する場合に使用します。

ユーザ定義受付だけを一括で停止することはできません。

HCSCサーバに配備されている特定のユーザ定義受付を停止する場合に使用します。

クラスタ単位で特定のユーザ定義受付を停止することもできます。

該当するリポジトリが存在する運用環境で，ユーザ定義受付を停止する場合に使用します。

cscutilコマンド
該当するリポジトリがなく，cscutilが使用できる環境（例えば，JP1で直接運用している実行環境）でユーザ定義受付を停止する場合に使用します。

cscrcptnstopコマンドの場合

運用環境でcscrcptnstopコマンドを実行します。

cscrcptnstopコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「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コマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「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>

cscutilコマンドの場合

運用環境でcscutilコマンドを実行します。-targetオプションにcompo_urecpを，また-operationオプションにstopを指定します。

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

cscutilコマンドの実行形式は，プロパティ定義ファイルを使用するかどうかによって異なります。

プロパティ定義ファイルを使用しない場合

-propsオプションにHCSCサーバ名およびJ2EEサーバ名を指定します。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Cosminexus Manager名> -target compo_urecp -operation stop -props "CSCSrvName=<HCSCサーバ名>, J2EESrvName=<J2EEサーバ名>"

cscutilコマンドに指定するCosminexus Manager名，HCSCサーバ名およびJ2EEサーバ名は，cscreplsコマンドで確認できます。cscreplsコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscrepls（リポジトリ情報の表示）」を参照してください。

プロパティ定義ファイルを使用する場合

-propfileオプションにプロパティ定義ファイル名を指定します。プロパティ定義ファイルは，J2SEのプロパティファイル形式であらかじめ作成しておく必要があります。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Cosminexus Manager名> -target compo_urecp -operation stop -propfile <プロパティ定義ファイル名>

5.2.28　サービスアダプタを停止する

サービスアダプタの停止の前提条件と停止方法について次に説明します。

＜この項の構成＞

(1)　前提条件

(2)　停止方法

(1)　前提条件

サービスアダプタを停止するには，次の条件を満たす必要があります。

HCSCサーバが起動状態であること
HCSCサーバの状態の確認方法については，「5.2.15　HCSCサーバの情報を確認する」を参照してください。

サービスアダプタが開始状態であること
サービスアダプタの状態の確認方法については，「5.2.17　サービスアダプタの情報を確認する」を参照してください。

(2)　停止方法

サービスアダプタを停止する方法を次に示します。

(a)　画面の場合

運用環境の画面を利用してサービスアダプタを停止する手順を次に示します。

ツリービュー上で，停止するサービスアダプタをダブルクリックします。
ダブルクリックしたサービスアダプタの情報がエディタエリアの稼働運用ページに表示されます。
サービスアダプタの稼働運用ページの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「3.4　稼働運用ページ」を参照してください。

稼働運用ページに表示された内容を確認し，［停止］ボタンをクリックします。
サービスアダプタの停止を確認するダイアログが表示されます。

ダイアログに表示された内容を確認し，［OK］ボタンをクリックします。
サービスアダプタの停止処理が開始されます。停止処理中のログはコンソールビューに出力されます。
［キャンセル］ボタンをクリックした場合は，停止処理を実行しないで稼働運用ページに戻ります。
サービスアダプタの停止処理が完了すると，実行結果を示すダイアログが表示されます。

実行結果を示すダイアログを確認します。

停止処理が成功した場合

［OK］ボタンをクリックして，稼働運用ページに戻ります。

稼働運用ページでは，サービスアダプタの状態が「停止状態」になります。また，［停止］ボタンが非活性化し，［開始］ボタンが活性化します。

停止処理が失敗した場合

ダイアログにエラーの内容が表示されます。詳細情報に表示されるメッセージIDを参照して対処してください。

(b)　コマンドの場合

サービスアダプタを停止するには，運用環境でcsccompostopコマンドまたはcscutilコマンドを実行します。

csccompostopコマンドおよびcscutilコマンドは，次の場合に使用します。

csccompostopコマンド
該当するリポジトリが存在する運用環境で，サービスアダプタを停止する場合。

cscutilコマンド
該当するリポジトリがなく，cscutilが使用できる環境（例えば，JP1で直接運用している実行環境）でサービスアダプタを停止する場合。

csccompostopコマンドの場合

運用環境でcsccompostopコマンドを実行します。

csccompostopコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「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コマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscutil（各種操作）」を参照してください。

cscutilコマンドの実行形式は，プロパティ定義ファイルを使用するかどうかによって異なります。

プロパティ定義ファイルを使用しない場合

-propsオプションにサービスアダプタのサービスID，HCSCサーバ名およびJ2EEサーバ名を指定します。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Cosminexus Manager名> -target compo -operation stop -props "AdapterName=<サービスアダプタのサービスID>, CSCSrvName=<HCSCサーバ名>, J2EESrvName=<J2EEサーバ名>"

cscutilコマンドに指定するCosminexus Manager名，サービスアダプタのサービスID，HCSCサーバ名およびJ2EEサーバ名は，cscreplsコマンドで確認できます。cscreplsコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscrepls（リポジトリ情報の表示）」を参照してください。

プロパティ定義ファイルを使用する場合

-propfileオプションにプロパティ定義ファイル名を指定します。プロパティ定義ファイルは，J2SEのプロパティファイル形式であらかじめ作成しておく必要があります。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Cosminexus Manager名> -target compo -operation stop -propfile <プロパティ定義ファイル名>

5.2.29　ビジネスプロセスを停止する

ビジネスプロセスの停止の前提条件と停止方法について次に説明します。

＜この項の構成＞

(1)　前提条件

(2)　停止方法

(1)　前提条件

ビジネスプロセスを停止するには，次の条件を満たす必要があります。

HCSCサーバが起動状態であること
HCSCサーバの状態の確認方法については，「5.2.15　HCSCサーバの情報を確認する」を参照してください。

ビジネスプロセスが開始状態であること
ビジネスプロセスの状態の確認方法については，「5.2.18　ビジネスプロセスの情報を確認する」を参照してください。

(2)　停止方法

ビジネスプロセスを停止する方法を次に示します。

(a)　画面の場合

運用環境の画面を利用してビジネスプロセスを停止する手順を次に示します。

ツリービュー上で，停止するビジネスプロセスをダブルクリックします。
ダブルクリックしたビジネスプロセスの情報がエディタエリアに表示されます。

エディタエリアで稼働運用ページを選択します。
手順1で選択したビジネスプロセスの稼働運用に関する情報が表示されます。
ビジネスプロセスの稼働運用ページの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「3.4　稼働運用ページ」を参照してください。

稼働運用ページに表示された内容を確認し，［停止］ボタンをクリックします。
ビジネスプロセスの停止を確認するダイアログが表示されます。

ダイアログに表示された内容を確認し，［OK］ボタンをクリックします。
ビジネスプロセスの停止処理が開始されます。停止処理中のログはコンソールビューに出力されます。
［キャンセル］ボタンをクリックした場合は，停止処理を実行しないで稼働運用ページに戻ります。
ビジネスプロセスの停止処理が完了すると，実行結果を示すダイアログが表示されます。

実行結果を示すダイアログを確認します。

停止処理が成功した場合

［OK］ボタンをクリックして，稼働運用ページに戻ります。

稼働運用ページでは，ビジネスプロセスの稼働状態が「停止状態」になります。また，［停止］ボタンが非活性化し，［開始］ボタンが活性化します。

停止処理が失敗した場合

ダイアログにエラーの内容が表示されます。詳細情報に表示されるメッセージIDを参照して対処してください。

(b)　コマンドの場合

ビジネスプロセスを停止するには，運用環境でcsccompostopコマンドまたはcscutilコマンドを実行します。

csccompostopコマンドおよびcscutilコマンドは，次の場合に使用します。

csccompostopコマンド
該当するリポジトリが存在する運用環境で，ビジネスプロセスを停止する場合。

cscutilコマンド
該当するリポジトリがなく，cscutilが使用できる環境（例えば，JP1で直接運用している実行環境）でビジネスプロセスを停止する場合。

csccompostopコマンドの場合

運用環境でcsccompostopコマンドを実行します。

csccompostopコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「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コマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscutil（各種操作）」を参照してください。

cscutilコマンドの実行形式は，プロパティ定義ファイルを使用するかどうかによって異なります。

プロパティ定義ファイルを使用しない場合

-propsオプションにビジネスプロセスのサービスID，HCSCサーバ名およびJ2EEサーバ名を指定します。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Cosminexus Manager名> -target compo -operation stop -props "AdapterName=<ビジネスプロセスのサービスID>, CSCSrvName=<HCSCサーバ名>, J2EESrvName=<J2EEサーバ名>"

cscutilコマンドに指定するCosminexus Manager名，ビジネスプロセスのサービスID，HCSCサーバ名およびJ2EEサーバ名は，cscreplsコマンドで確認できます。cscreplsコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscrepls（リポジトリ情報の表示）」を参照してください。

プロパティ定義ファイルを使用する場合

-propfileオプションにプロパティ定義ファイル名を指定します。プロパティ定義ファイルは，J2SEのプロパティファイル形式であらかじめ作成しておく必要があります。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Cosminexus Manager名> -target compo -operation stop -propfile <プロパティ定義ファイル名>

5.2.30　Hitachi Web Serverを停止する

Hitachi Web Serverの停止方法には，通常停止と計画停止があります。

通常停止

リクエスト処理の実行中に停止処理が行われた場合，リクエスト処理の終了を待たないでHitachi Web Serverを停止します。リクエスト処理の終了を待たないでHitachi Web Serverを停止するため，処理中のリクエストの処理は保証されません。

計画停止

リクエスト処理の実行中に停止処理が行われた場合，リクエスト処理の終了を待ってからHitachi Web Serverを停止します。リクエスト処理の終了を待ってからHitachi Web Serverを停止するため，処理中のリクエストの処理は保証されます。

デフォルトは計画停止が設定されています。設定を変更したい場合は，HCSC-Manager定義ファイルのcscmng.server.<HCSCサーバ名>.hws.svstopパラメタで設定します。また，計画停止の場合は，Hitachi Web Server計画停止時のタイムアウト値も設定できます。タイムアウト値は，HCSC-Manager定義ファイルのcscmng.server.<HCSCサーバ名>.hws.svstop.timeoutパラメタで設定します。

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

＜この項の構成＞

(1)　停止方法

(1)　停止方法

運用環境でcscsvstopコマンドを実行します。-logicalオプションにHitachi Web Serverの論理サーバ名を指定して実行します。

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

cscsvstopコマンドの実行形式を次に示します。

cscsvstop -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -logical <Hitachi Web Serverの論理サーバ名>

5.2.31　HCSCサーバを停止する

HCSCサーバの停止の前提条件と停止方法について次に説明します。

＜この項の構成＞

(1)　前提条件

(2)　停止方法

(1)　前提条件

HCSCサーバを停止するには，ユーザ定義受付および標準受付が停止状態である必要があります。

標準受付の状態の確認方法については，「5.2.15　HCSCサーバの情報を確認する」を，ユーザ定義受付の状態の確認方法については，「5.2.19　ユーザ定義受付の情報を確認する」を参照してください。

なお，コマンドを利用してHCSCサーバを停止する場合，強制停止を実行できます。強制停止を実行すると，ほかのコマンドの実行中や，内部エラーが発生した場合でも強制的にHCSCサーバを停止できます。また，ユーザ定義受付および標準受付が起動していてもHCSCサーバを停止できます。

(2)　停止方法

HCSCサーバを停止する方法を次に示します。

(a)　画面の場合

運用環境の画面を利用してHCSCサーバを停止する手順を次に示します。

ツリービュー上で，停止するHCSCサーバをダブルクリックします。
選択したHCSCサーバの情報がエディタエリアに表示されます。

エディタエリアで［稼働運用］タブを選択します。
稼働運用ページに，手順1で選択したHCSCサーバの稼働運用に関する情報が表示されます。
HCSCサーバの稼働運用ページの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「3.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コマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscsvstop（HCSCサーバの停止）」を参照してください。

cscsvstopコマンドの実行形式を次に示します。

クラスタ内のHCSCサーバを一括して停止する場合

クラスタ名を指定して実行します。

cscsvstop -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名>

クラスタ内のHCSCサーバの停止と同時に論理サーバを停止する場合は，-systemオプションを指定します。ただし，HCSC-Manager定義ファイルに論理サーバを登録している必要があります。論理サーバの登録の詳細については，「5.2.1(1) 運用する前の準備」を参照してください。

cscsvstop -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -system

また，HCSCサーバは停止しないで指定した論理サーバだけを停止する場合は，-logicalオプションを指定します。

cscsvstop -user <ログインユーザID> -pass <ログインパスワード> -cluster <クラスタ名> -logical <論理サーバ名>

なお，-systemオプションまたは-logicalオプションを指定して，論理サーバのうちHitachi Web Serverを停止する場合，Hitachi Web Serverの停止方法には，通常停止と計画停止があります。Hitachi Web Serverの停止方法の詳細については，「5.2.30　Hitachi Web 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オプションを指定して，論理サーバのうちHitachi Web Serverを停止する場合，Hitachi Web Serverの停止方法には，通常停止と計画停止があります。Hitachi Web Serverの停止方法の詳細については，「5.2.30　Hitachi Web Serverを停止する」を参照してください。

cscutilコマンドの場合

運用環境でcscutilコマンドを実行します。-targetオプションにserverを，また-operationオプションにstopを指定します。

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

cscutilコマンドの実行形式は，プロパティ定義ファイルを使用するかどうかによって異なります。

プロパティ定義ファイルを使用しない場合

-propsオプションにHCSCサーバ名，J2EEサーバ名および停止フラグを指定します。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Cosminexus Manager名> -target server -operation stop -props "CSCSrvName=<HCSCサーバ名>, J2EESrvName=<J2EEサーバ名>, ForceFlag=<停止フラグ>"

cscutilコマンドに指定するCosminexus Manager名，HCSCサーバ名およびJ2EEサーバ名は，cscreplsコマンドで確認できます。cscreplsコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscrepls（リポジトリ情報の表示）」を参照してください。

また，停止フラグには，通常停止または強制停止のどちらを実行するか指定します。停止フラグには，次のどちらかを指定してください。

通常停止：false

強制停止：true

プロパティ定義ファイルを使用する場合

-propfileオプションにプロパティ定義ファイル名を指定します。プロパティ定義ファイルは，J2SEのプロパティファイル形式であらかじめ作成しておく必要があります。

cscutil -user <ログインユーザID> -pass <ログインパスワード> -mng <Cosminexus Manager名> -target server -operation stop -propfile <プロパティ定義ファイル名>

5.2.32　PRFを停止する

PRFを停止するには，運用環境でcscsvstopコマンドを実行します。-logicalオプションにPRFの論理サーバ名を指定して実行します。

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

cscsvstopコマンドの実行形式を次に示します。

cscsvstop -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -logical <PRFの論理サーバ名>

5.2.33　データベースを停止する

データベースの停止方法について次に説明します。

＜この項の構成＞

(1)　停止方法

(1)　停止方法

データベースを停止する方法を次に示します。

(a)　HiRDBの場合

HiRDBを停止するには，データベースサーバでpdstopコマンドを実行します。

pdstopコマンドの詳細については，マニュアル「HiRDB コマンドリファレンス」を参照してください。

(b)　Oracle の場合

Oracleを停止する方法については，Oracle Corporationが発行するドキュメントを参照してください。

5.3　クラスタ構成時の運用

クラスタ構成時の運用方法について，ロードバランスクラスタ構成の場合とHAクラスタ構成の場合とに分けて説明します。

＜この節の構成＞

5.3.1　ロードバランスクラスタ構成での運用

5.3.2　HAクラスタ構成での運用

5.3.1　ロードバランスクラスタ構成での運用

ロードバランスクラスタ構成での運用の開始および終了について説明します。また，運用中にロードバランスクラスタを構成するHCSCサーバを追加，変更，および削除する方法についても説明します。

＜この項の構成＞

(1)　運用の開始

(2)　運用の終了

(3)　ロードバランスクラスタへのHCSCサーバの追加・削除

(4)　ロードバランスクラスタへのサービスアダプタの追加・削除

(5)　ロードバランスクラスタへのビジネスプロセスの追加・削除

(6)　ロードバランスクラスタ構成でのサービスアダプタの変更

(7)　ロードバランスクラスタ構成でのビジネスプロセスの変更

(8)　障害に備えたHCSCサーバの準備

(1)　運用の開始

環境構築とセットアップが終了したあと，ロードバランスクラスタ構成のシステムの運用を開始できます。運用を開始するには，次の作業を実施します。

実行環境の構成要素の状態の確認
ロードバランスクラスタ構成のシステムの運用を開始するには，すべてのロードバランスクラスタ内で，次に示す実行環境の構成要素が開始状態である必要があります。

運用管理エージェント

Management Server

PRF

スマートエージェント

CTM（CTMを使用する場合）※1

J2EEサーバ※2

HCSCサーバ※3

Hitachi Web Server（Hitachi Web Serverを使用する場合）

注※1

CTMドメインマネジャおよびCTMデーモンも開始状態である必要があります。

注※2

Cosminexus RMなどのアプリケーションの状態を一致させておく必要があります。なお，Cosminexus RMのシステム名は，ロードバランスクラスタ内のそれぞれのHCSCサーバでユニーク名称を指定する必要があります。

注※3

配備されているサービスアダプタとビジネスプロセス，および標準受付の状態を一致させておく必要があります。

サービスリクエスタへの送信制御
セットアップ時に，サービスリクエスタ用のネットワークを切断するなどして，サービス部品の実行要求を受け付けられない状態にしたサービスリクエスタを，ネットワークを接続するなどして，サービス部品の実行要求を受け付けられる状態にします。

(2)　運用の終了

ロードバランスクラスタ構成のシステムの運用を終了する場合，次の作業を実施します。

サービスリクエスタへの送信制御
サービスリクエスタ用のネットワークを切断するなどして，HCSCサーバでサービス部品の実行要求を受け付けられない状態にします。その際，現在処理中の実行要求がないことを確認してください。

実行環境の構成要素の停止
次の順序で，すべてのロードバランスクラスタ内の実行環境の構成要素を停止します。

Hitachi Web Server（Hitachi Web 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サーバが使用するJ2EEサーバ名

呼び出し種別

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

rm-systemnameプロパティおよびnaming-service-hostnameプロパティ以外のすべてのプロパティ
なお，rm-systemnameプロパティには，ロードバランスクラスタ内のそれぞれのHCSCサーバでユニークなCosminexus RMシステム名を指定してください。naming-service-hostnameプロパティには，それぞれのHCSCサーバをセットアップしたJ2EEサーバに設定されているネーミングサービスのホスト名称を指定してください。

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

サービスアダプタを配備します。
サービスアダプタの配備方法については，「3.1.8　サービスアダプタを配備する」を参照してください。

ビジネスプロセスを配備します。
ビジネスプロセスの配備方法については，「3.1.13　ビジネスプロセスを配備する」を参照してください。

サービスアダプタを開始します。
サービスアダプタの開始方法については，「5.2.6　サービスアダプタを開始する」を参照してください。

ビジネスプロセスを開始します。
ビジネスプロセスの開始方法については，「5.2.7　ビジネスプロセスを開始する」を参照してください。

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

ロードバランサを設定します。
追加するHCSCサーバに，動的にサービス部品の実行要求を送信するように設定します。
CTMを使用する場合，すべてのHCSCサーバでCTMドメインマネジャ名およびスマートエージェントのポート番号を同じ値に設定する必要があります。
汎用ロードバランサの設定方法については，使用する汎用ロードバランサのドキュメントを参照してください。

注意

CTMを使用する場合，追加するHCSCサーバの標準受付を開始した段階で，HCSCサーバにサービス部品の実行要求を振り分けます。

(b)　HCSCサーバの削除

ロードバランサを設定します。
削除するHCSCサーバにサービス部品の実行要求を送信しないように設定します。その際，現在処理中の実行要求がすべて完了していることを確認してください。
CTMを使用する場合，対象となるJ2EEサーバにサービス部品の実行要求を送信するキューを閉塞します。CTMを使用する場合のキューの閉塞については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 拡張編」の「3.7.4　スケジュールキューの閉塞制御」を参照してください。
汎用ロードバランサの設定方法については，使用する汎用ロードバランサのドキュメントを参照してください。

標準受付を停止します。
標準受付の停止方法については，「5.2.26　標準受付を停止する」を参照してください。

ビジネスプロセスを停止します。
ビジネスプロセスの停止方法については，「5.2.29　ビジネスプロセスを停止する」を参照してください。

サービスアダプタを停止します。
サービスアダプタの停止方法については，「5.2.28　サービスアダプタを停止する」を参照してください。

ビジネスプロセスを削除します。
ビジネスプロセスの削除方法については，「3.2.2　ビジネスプロセスを削除する」を参照してください。

サービスアダプタを削除します。
サービスアダプタの削除方法については，「3.2.1　サービスアダプタを削除する」を参照してください。

削除するHCSCサーバを停止します。
HCSCサーバの停止方法については，「5.2.31　HCSCサーバを停止する」を参照してください。

HCSCサーバを削除します。
HCSCサーバの削除方法については，「3.2.4　HCSCサーバをアンセットアップする」を参照してください。

(4)　ロードバランスクラスタへのサービスアダプタの追加・削除

すでにHCSCサーバに配備済みのサービスアダプタを停止しないで，新たなサービスアダプタを追加および削除できます。サービスアダプタを追加および削除する方法を次に示します。

(a)　サービスアダプタの追加

ロードバランスクラスタを構成するすべてのHCSCサーバに，追加するサービスアダプタを配備します。
サービスアダプタの配備方法については，「3.1.8　サービスアダプタを配備する」を参照してください。

追加したサービスアダプタを開始します。
サービスアダプタの開始方法については，「5.2.6　サービスアダプタを開始する」を参照してください。

追加したサービスアダプタを呼び出すように設定します。

注意

ロードバランスクラスタを構成するすべてのHCSCサーバに，サービスアダプタを配備し開始してから，追加したサービスアダプタを呼び出すように設定してください。

(b)　サービスアダプタの削除

削除するサービスアダプタを呼び出さないように設定します。

削除するサービスアダプタを停止します。
サービスアダプタの停止方法については，「5.2.28　サービスアダプタを停止する」を参照してください。

ロードバランスクラスタを構成するすべてのHCSCサーバからサービスアダプタを削除します。
サービスアダプタの削除方法については，「3.2.1　サービスアダプタを削除する」を参照してください。

注意

削除するサービスアダプタを呼び出さないように設定してから，サービスアダプタを削除してください。

(5)　ロードバランスクラスタへのビジネスプロセスの追加・削除

すでにHCSCサーバに配備済みのビジネスプロセスを停止しないで，新たなビジネスプロセスを追加および削除できます。ビジネスプロセスを追加および削除する方法を次に示します。

(a)　ビジネスプロセスの追加

ロードバランスクラスタを構成するすべてのHCSCサーバに，追加するビジネスプロセスを配備します。
ビジネスプロセスの配備方法については，「3.1.13　ビジネスプロセスを配備する」を参照してください。

追加したビジネスプロセスを開始します。
ビジネスプロセスの開始方法については，「5.2.7　ビジネスプロセスを開始する」を参照してください。

追加したビジネスプロセスを呼び出すように設定します。

注意

ロードバランスクラスタを構成するすべてのHCSCサーバに，ビジネスプロセスを配備し開始してから，追加したビジネスプロセスを呼び出すように設定してください。

(b)　ビジネスプロセスの削除

削除するビジネスプロセスを呼び出さないように設定します。

削除するビジネスプロセスを停止します。
ビジネスプロセスの停止方法については，「5.2.29　ビジネスプロセスを停止する」を参照してください。

ロードバランスクラスタを構成するすべてのHCSCサーバからビジネスプロセスを削除します。
ビジネスプロセスの削除方法については，「3.2.2　ビジネスプロセスを削除する」を参照してください。

注意

削除するビジネスプロセスを呼び出さないように設定してから，ビジネスプロセスを削除してください。

(6)　ロードバランスクラスタ構成でのサービスアダプタの変更

すでにHCSCサーバに配備済みのサービスアダプタを停止しないで，サービスアダプタを変更できます。サービスアダプタを変更する方法を次に示します。

変更するサービスアダプタを呼び出さないように設定します。

変更するサービスアダプタを停止します。
サービスアダプタの停止方法については，「5.2.28　サービスアダプタを停止する」を参照してください。

ロードバランスクラスタを構成するすべてのHCSCサーバから変更するサービスアダプタを削除します。
サービスアダプタの削除方法については，「3.2.1　サービスアダプタを削除する」を参照してください。

変更したサービスアダプタの情報が保存されたリポジトリをインポートします。
インポートの方法については，「4.3　リポジトリのインポート」を参照してください。

ロードバランスクラスタを構成するすべてのHCSCサーバに，変更したサービスアダプタを配備します。
サービスアダプタの配備方法については，「3.1.8　サービスアダプタを配備する」を参照してください。

変更したサービスアダプタを開始します。
サービスアダプタの開始方法については，「5.2.6　サービスアダプタを開始する」を参照してください。

変更したサービスアダプタを呼び出すように設定します。

注意

変更するサービスアダプタを呼び出さないように設定してから，サービスアダプタを変更してください。

(7)　ロードバランスクラスタ構成でのビジネスプロセスの変更

すでにHCSCサーバに配備済みのビジネスプロセスを停止しないで，ビジネスプロセスを変更できます。ビジネスプロセスを変更する方法を次に示します。

変更するビジネスプロセスを呼び出さないように設定します。

変更するビジネスプロセスを停止します。
ビジネスプロセスの停止方法については，「5.2.29　ビジネスプロセスを停止する」を参照してください。

ロードバランスクラスタを構成するすべてのHCSCサーバから変更するビジネスプロセスを削除します。
ビジネスプロセスの削除方法については，「3.2.2　ビジネスプロセスを削除する」を参照してください。

変更したビジネスプロセスの情報が保存されたリポジトリをインポートします。
リポジトリのインポート方法については，「4.3　リポジトリのインポート」を参照してください。

ロードバランスクラスタを構成するすべてのHCSCサーバにビジネスプロセスを配備します。
ビジネスプロセスの配備方法については，「3.1.13　ビジネスプロセスを配備する」を参照してください。

変更したビジネスプロセスを開始します。
ビジネスプロセスの開始方法については，「5.2.7　ビジネスプロセスを開始する」を参照してください。

変更したビジネスプロセスを呼び出すように設定します。

注意

変更するビジネスプロセスを呼び出さないように設定してから，ビジネスプロセスを変更してください。

(8)　障害に備えたHCSCサーバの準備

ロードバランスクラスタを構成しているHCSCサーバの障害に備え，ロードバランスクラスタに余裕をもった台数のHCSCサーバを準備することを推奨します。詳細については，「7.9.2(1) ロードバランスクラスタ構成での障害と復旧」を参照してください。

5.3.2　HAクラスタ構成での運用

HAクラスタ構成での運用の開始と，運用中に実行系で障害が発生した場合の系の切り替え，および復旧の方法について説明します。

＜この項の構成＞

(1)　運用の開始

(1)　運用の開始

環境構築とセットアップが終了したあと，HAクラスタ構成のシステムの運用を開始できます。運用を開始するには，次の作業を実施します。

実行系・待機系の構成要素の状態の確認
HAクラスタ構成のシステムの運用を開始するには，実行系・待機系の構成要素が次の表に示す状態である必要があります。

表5-5　HAクラスタ構成の運用時の構成要素の状態

構成要素 | 状態
実行系 | 待機系
運用管理エージェント | ○ | －
Management Server | ○ | －
PRF | ○ | －
J2EEサーバ | ○ | －
HCSCサーバ | ○ | －
Hitachi Web Server | ○ | －

（凡例）

○：起動しています。

－：停止しています。

サービスリクエスタ用のネットワークの接続
セットアップ時に切断したサービスリクエスタ用のネットワークを接続します。
サービスリクエスタ用のネットワークを接続すると，実行系のHCSCサーバでサービス部品の実行要求が受け付けられる状態になります。

サービスリクエスタへの送信制御
セットアップ時にサービス部品の実行要求を受け付けられない状態にしたサービスリクエスタを，ネットワークを接続するなどして，サービス部品の実行要求を受け付けられる状態にします。

注意

HAクラスタ構成での運用中は，サービスアダプタおよびビジネスプロセスを起動または停止しないでください。また，標準受付を停止しないでください。

サービスアダプタおよびビジネスプロセスの起動・停止について

サービスアダプタおよびビジネスプロセスを起動または停止する場合，サービスリクエスタ用のネットワークを切断するなどして，実行系と待機系でサービス部品の実行要求を受け付けられない状態にします。そのあと，実行系と待機系の両方で，同じサービスアダプタおよびビジネスプロセスの起動または停止をしてください。

HAクラスタ構成で系の切り替えが発生した場合，サービスアダプタおよびビジネスプロセスの状態は引き継がれません。そのため，稼働中の実行系で，あるサービスアダプタを停止し，その状態で系の切り替えが発生すると，実行系と待機系でサービスアダプタおよびビジネスプロセスの状態が不整合になります。

標準受付の停止について

標準受付を停止する場合，サービスリクエスタ用のネットワークから切断するなどして，標準受付の状態に関係なく実行要求を受け付けられない状態にしてから，標準受付を停止してください。

HAクラスタ構成で系の切り替えが発生した場合，待機系では標準受付が起動されます。そのため，実行要求を一時的に受け付けないようにするために稼働中の実行系で標準受付を停止し，その状態で系の切り替えが発生すると，待機系で実行要求を受け付けてしまう場合があります。

画面の表示について

Cosminexus サービスプラットフォームの運用画面を起動したまま，HAクラスタに切り替えた場合，運用画面上に表示されている各種ステータスを正しく反映できません。

5.4　環境構築後のIPアドレスまたはホスト名を変更する場合の運用

環境構築後のデータベース，運用環境，およびコンポーネントのIPアドレスまたはホスト名を変更する場合の運用手順について説明します。

＜この節の構成＞

5.4.1　データベース稼働マシンのIPアドレスまたはホスト名を変更する場合

5.4.2　運用環境と実行環境が異なるマシンに構築された状態で，運用環境マシンのIPアドレスまたはホスト名を変更する場合

5.4.3　標準受付（同期受付（Webサービス））および標準受付（非同期受付（MDB（WS-R））のWebサーバのIPアドレスまたはホスト名を変更する場合

5.4.1　データベース稼働マシンのIPアドレスまたはホスト名を変更する場合

データベース稼働マシンのIPアドレスまたはホスト名を変更する場合，データベースの種類に応じて(1)または(2)の作業を実施してください。

＜この項の構成＞

(1)　HCSCサーバがセットアップされた状態で，HCSCサーバが使用するデータベース稼働マシンのIPアドレスまたはホスト名を変更する場合

(2)　DBアダプタが接続するデータベースのIPアドレスまたはホスト名を変更する場合

(1)　HCSCサーバがセットアップされた状態で，HCSCサーバが使用するデータベース稼働マシンのIPアドレスまたはホスト名を変更する場合

HCSCサーバが利用するデータベース稼働マシンのIPアドレスまたはホスト名を変更する場合は，次に示す定義ファイルの定義項目を確認してください。HCSCサーバセットアップ定義ファイルのプロパティの定義方法については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「HCSCサーバセットアップ定義ファイル」を参照してください。

表5-6　IPアドレスまたはホスト名の変更時に確認する定義項目

定義ファイル名
定義項目

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

Oracleの場合
jdbc-url

Oracle以外の場合
jdbc-dbhostname

DB Connectorの定義ファイル

HiRDBの場合
DBHostName

HiRDB以外の場合
serverName

定義項目に定義された内容によって，IPアドレスまたはホスト名の変更方法は次のように異なります。

表5-7　IPアドレスまたはホスト名の変更方法

定義項目の定義内容 | 変更方法
IPアドレスの変更 | ホスト名の変更
localhost | マシンのIPアドレス・ホスト名のどちらを変更する場合も，定義ファイルの設定内容の変更は不要です。
ホスト名 | ホスト名を変更しないでマシンのIPアドレスを変更する場合，定義ファイルの設定内容の変更は不要です。運用管理エージェント，Management Server，HCSCサーバを再起動することで，変更できます。 | マシンのホスト名は変更できません。ホスト名を変更する場合は，HCSCサーバを再セットアップしてください。
IPアドレス | マシンのIPアドレスは変更できません。IPアドレスを変更する場合は，HCSCサーバを再セットアップしてください。 | －

（凡例）

－：該当しません。

次の図に，IPアドレスまたはホスト名を変更する場合の例を示します。

図5-3　HCSCサーバが使用するデータベース稼働マシンのIPアドレスまたはホスト名の変更（HCSCサーバのセットアップ時）

(2)　DBアダプタが接続するデータベースのIPアドレスまたはホスト名を変更する場合

DBアダプタが接続するデータベースのIPアドレスまたはホスト名を変更する場合は，次に示す定義ファイルの定義項目を確認してください。

表5-8　IPアドレスまたはホスト名の変更時に確認する定義項目

定義ファイル名
定義項目

DB Connectorの定義ファイル

HiRDBの場合
DBHostName

HiRDB以外の場合
serverName

定義項目に定義された内容によって，IPアドレスまたはホスト名の変更方法は次のように異なります。

表5-9　IPアドレスまたはホスト名の変更方法

定義項目の定義内容
変更方法

IPアドレスの変更
ホスト名の変更

localhost
マシンのIPアドレス・ホスト名のどちらを変更する場合も，定義ファイルの設定内容の変更は不要です。

ホスト名
マシンのIPアドレス・ホスト名のどちらを変更する場合も，次の手順で変更できます。

定義ファイルの定義内容（IPアドレスまたはホスト名）を変更する

定義ファイルをcjsetrarpropコマンドでDB Connectorへ反映する

HCSCサーバを再起動する

IPアドレス
マシンのIPアドレスを変更する場合，次の手順を実施する必要があります。

定義ファイルの定義内容（IPアドレス）を変更する

定義ファイルをcjsetrarpropコマンドでDB Connectorへ反映する

HCSCサーバを再起動する

－

（凡例）

－：該当しません。

次の図に，IPアドレスまたはホスト名を変更する場合の例を示します。

図5-4　DBアダプタが接続するデータベースのIPアドレスまたはホスト名の変更

5.4.2　運用環境と実行環境が異なるマシンに構築された状態で，運用環境マシンのIPアドレスまたはホスト名を変更する場合

運用環境と実行環境を異なるマシンに構築してある状態で，運用環境マシンのIPアドレスまたはホスト名を変更する場合，運用環境のIPアドレスやホスト名に関する情報は保持していないため，定義を変更しなくても変更できます。ただし，Eclipseの運用環境画面から操作している場合は，Eclipseを再起動してください。

次の図に，運用環境と実行環境が異なるマシンに構築された状態で，運用環境マシンのIPアドレスまたはホスト名を変更する場合の例を示します。

図5-5　運用環境と実行環境が異なるマシンに構築された状態の，運用環境マシンのIPアドレスまたはホスト名の変更

5.4.3　標準受付（同期受付（Webサービス））および標準受付（非同期受付（MDB（WS-R））のWebサーバのIPアドレスまたはホスト名を変更する場合

標準受付（同期受付（Webサービス））および標準受付（非同期受付（MDB（WS-R））のWebサーバのIPアドレスまたはホスト名を変更する場合は，次に示す定義ファイルの定義項目を確認してください。HCSCサーバ構成定義ファイルのプロパティの定義方法については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「HCSCサーバ構成定義ファイル」を参照してください。

表5-10　IPアドレスまたはホスト名の変更時に確認する定義項目

定義ファイル名 | 定義項目
HCSCサーバ構成定義ファイル | WebサーバのIPアドレスまたはホスト名

定義項目に定義された内容によって，IPアドレスまたはホスト名の変更方法は次のように異なります。

表5-11　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-6　標準受付（同期受付（Webサービス））および標準受付（非同期受付（MDB（WS-R））のWebサーバのIPアドレスまたはホスト名の変更

6.　実行履歴の管理

この章では，システム運用時のプロセスインスタンスの実行履歴や電文の実行履歴の管理方法について説明します。

＜この章の構成＞

6.1　プロセスインスタンスの実行履歴の管理

6.2　電文の実行履歴の管理

6.3　実行履歴情報テーブルの管理

6.1　プロセスインスタンスの実行履歴の管理

ビジネスプロセスのプロセスインスタンスの実行状況を履歴として，データベースに記録できます。これを永続化といいます。永続化すると，プロセスインスタンスの実行履歴の中から目的のプロセスインスタンスを特定して，その状態を確認したり，実行履歴を削除したり，プロセスインスタンスを再実行できます。次のような場合に使用できます。

ビジネスプロセステスト支援の場合
ビジネスプロセス開発時にテスト実行したプロセスインスタンスの状態を確認して，ビジネスプロセスを改善できます。また，必要に応じてプロセスインスタンスの実行履歴を削除したり，プロセスインスタンスを再実行したりできます。

エラー発生時の問い合わせ対応の場合
サービスリクエスタからの要求に応じて，特定のプロセスインスタンスの状態を確認して，必要に応じてプロセスインスタンスの実行履歴を削除したり，プロセスインスタンスを再実行したりできます。

どのアクティビティがビジネスプロセスのどこの個所に該当するのかを確認するためには，あらかじめビジネスプロセスの開発者から，ビジネスプロセスのアクティビティ遷移図（ビジネスプロセス開発時の画面）を用意する必要があります。

プロセスインスタンスの実行履歴は，データベースおよびCosminexus RMを利用する場合だけ管理できます。

＜この節の構成＞

6.1.1　プロセスインスタンスの実行履歴を利用する

6.1.2　プロセスインスタンスの実行履歴を検索する

6.1.3　プロセスインスタンスの実行履歴の詳細情報を取得する

6.1.4　プロセスインスタンスの実行履歴を削除する

6.1.5　プロセスインスタンスを再実行する

6.1.1　プロセスインスタンスの実行履歴を利用する

＜この項の構成＞

(1)　実行履歴の利用

(2)　画面を使用する場合の履歴管理ページの表示

(1)　実行履歴の利用

(a)　エラー発生時の問い合わせ対応の場合

エラー発生時の問い合わせに対応する場合は，プロセスインスタンスの実行履歴を，次のように利用します。

BP実行ログのエラーメッセージなどで，原因を特定し，解消します。

プロセスインスタンスの状態を確認します。

相関セットが存在しわかる場合

サービスリクエスタの送信した要求電文の相関セットを検索条件にして，プロセスインスタンスを検索します。相関セットを検索条件にすると，一意に識別できます。

相関セットがわからない場合

プロセスインスタンスを開始した日時を要求電文から取得して検索，または目的のプロセスインスタンスの状態（実行中など）から検索します。

検索結果からプロセスインスタンスの相関セット，変数，またはアクティビティの詳細情報を取得して，目的のプロセスインスタンスを特定します。
相関セットから検索した場合は，検索結果として表示される開始日時からもプロセスインスタンスを特定できます。

状態に応じて，次の作業をします。

状態が実行中，またはエラー発生の場合

プロセスインスタンスを再実行するか，またはプロセスインスタンスの実行履歴を削除します。削除後，サービスリクエスタに要求電文の再送信を依頼します。

プロセスインスタンスの情報がない（検索結果がない）場合

サービスリクエスタに要求電文の再送信を依頼します。

(b)　ビジネスプロセステスト支援の場合

エラー発生時の問い合わせに対応する場合は，プロセスインスタンスの実行履歴を，次のように利用します。

永続化されているビジネスプロセスのプロセスインスタンスの実行履歴を，相関セット，または日時や状態を条件として検索し，対象を絞り込みます。

検索結果からプロセスインスタンスの相関セット，変数，またはアクティビティの詳細情報を取得して，目的のプロセスインスタンスを特定します。

状態に応じて，次の作業をします。

実行したプロセスインスタンスの状態の把握

実行中状態，またはエラー発生状態のプロセスインスタンスの再実行

不要なプロセスインスタンスの削除

以降の項で，プロセスインスタンスの検索，情報や状態の参照，実行履歴の削除，およびプロセスインスタンスの再実行の方法について説明します。

(2)　画面を使用する場合の履歴管理ページの表示

プロセスインスタンスの実行履歴は，画面やコマンドを使って管理できます。

画面を使用してプロセスインスタンスの実行履歴を管理する場合は，履歴管理ページから確認できます。履歴管理ページの表示方法を次に示します。

ツリービューから，プロセスインスタンスの実行履歴を確認する対象となるビジネスプロセスを選択します。

エディタエリアで，［履歴管理］タブを選択します。
エディタエリアに履歴管理ページが表示されます。

6.1.2　プロセスインスタンスの実行履歴を検索する

プロセスインスタンスの実行履歴は，画面およびコマンドで検索できます。それぞれ条件を指定して，プロセスインスタンスの実行履歴を検索できます。画面およびコマンドで検索できる範囲が異なります。

画面による実行履歴の検索

次に示す条件で検索できます。

開始日時による検索
プロセスインスタンスの開始日時を指定して検索します。

状態による検索
プロセスインスタンスの状態（「実行中」，「完了」，「エラー発生」，または「フォルト終了」）を指定して検索します。

相関セットによる検索
プロセスインスタンスを一意に特定する相関セットを指定して検索します。

識別子による検索
プロセスインスタンス識別子を指定して検索します。

コマンドによる実行履歴の検索

次に示す条件で検索できます。

プロセス概要情報（相関セットを使用した検索，相関セットを使用しない検索）

アクティビティ情報

リンク情報

相関セット情報

変数情報（string変数情報，numeric変数情報，boolean変数情報，message変数情報）

メッセージ関連情報

実行履歴情報テーブル中の全実行履歴の情報

検索結果の行数

ビジネスプロセス定義名

プロセスインスタンスの開始日時

プロセスインスタンスの状態

＜この項の構成＞

(1)　ビジネスプロセス定義名を条件としてプロセスインスタンスの実行履歴を検索する

(2)　開始日時を条件としてプロセスインスタンスの実行履歴を検索する

(3)　状態を条件としてプロセスインスタンスの実行履歴を検索する

(4)　相関セットを条件としてプロセスインスタンスの実行履歴を検索する

(5)　プロセスインスタンス識別子を条件としてプロセスインスタンスの実行履歴を検索する

(6)　開始日時と状態を組み合わせて検索する

(7)　プロセスインスタンスの実行履歴を全件検索する

(8)　全実行履歴のCSVファイルへの出力

(9)　画面による検索結果を参照する

(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コマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「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ビジネスプロセス

開始日時範囲：2009/03/25 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 <= '2009-03-25 14:59:59'

-dateオプションを指定した場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -processname Helloビジネスプロセス -date ,20090325235959※ -table process -orderby "StartTime ASC"

注※　-dateオプションのデフォルトタイムゾーンは，日本時間を使用しています。

出力結果

（例）次の条件で，コマンドを入力して，プロセスインスタンスの実行履歴を検索します。

ビジネスプロセス定義名：Helloビジネスプロセス

開始日時範囲：2009/03/24 00:33:38～2009/03/24 00:33:58（グリニッジ標準時間）

アクセスする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 '2009-03-24 00:33:38' AND '2009-03-24 00:33:58'

-dateオプションを指定した場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -processname Helloビジネスプロセス -date 20090324093338※,20090324093358※ -table process -orderby "StartTime ASC"

注※　-dateオプションのデフォルトタイムゾーンは，日本時間を使用しています。

出力結果

cscpiselectコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「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｜all}※ -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ビジネスプロセス' AND State = 'Error'

-statusオプションを指定した場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -processname Helloビジネスプロセス -status error -table process -orderby "StartTime ASC"

出力結果

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

(4)　相関セットを条件としてプロセスインスタンスの実行履歴を検索する

(a)　画面による実行履歴の検索

プロセスインスタンスの実行履歴を相関セットで検索する手順を次に示します。

［相関セット検索］タブをクリックします。

相関セット定義名，および相関セット値を入力します。必ず両方の内容を入力します。

［検索］ボタンをクリックします。
検索結果フィールドに検索結果が表示されます。

相関セット値の指定方法

相関セットは，電文に含まれる一つの部分または複数の部分を連結することによって構成できます。相関セットを永続化する場合，指定した一つの部分または複数の部分を相関セット値として扱います。相関セット値は，次の規則に従って構成されます。

部分が一つの場合
部分の値そのままです。

複数の部分がある場合
部分の値を「>」で連結します。

（例）

相関セット定義名「ABC」に，二つの部分X，Yがあり，それぞれの値が「100」，「300」である場合，相関セット値は「100>300」になります。

部分の値に「@」がある場合
@を二つ連続します。

（例）

相関セット定義名「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コマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「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_010210084218_Helloビジネスプロセス_1237946140968_3843192274_138'

出力結果

cscpiselectコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「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｜all}※2 -table process -orderby <ソート条件>

注※1　照会開始日時は省略できます。

注※2　どれか一つを指定します。

（例）次の条件で，コマンドを入力して，プロセスインスタンスの実行履歴を検索します。

ビジネスプロセス定義名：Helloビジネスプロセス

開始日時範囲：2009/03/24 15:00:00～2009/03/25 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 '2009-03-24 15:00:00' AND '2009-03-25 14:59:59' AND State = 'Error'

-dateオプションおよび-statusオプションを指定した場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -processname Helloビジネスプロセス -date 20090325000000※,20090325235959※ -status error -table process -orderby "StartTime ASC"

注※　-dateオプションのデフォルトタイムゾーンは，日本時間を使用しています。

出力結果

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

(7)　プロセスインスタンスの実行履歴を全件検索する

プロセスインスタンスの実行履歴を全件検索する手順を次に示します。なお，プロセスインスタンスの実行履歴の全件検索は，コマンドでだけ実行できます。

アクセスするHCSCサーバを決定します。

次のコマンドを実行して検索します。

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -table process

（例）次の条件で，コマンドを入力して，プロセスインスタンスの実行履歴を検索します。

アクセスするHCSCサーバ：HCSC

コマンド

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -table process

出力結果

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

(8)　全実行履歴のCSVファイルへの出力

過去の履歴として，定期的にプロセスインスタンスの実行履歴を検索し，HCSCサーバ単位に全情報をCSVファイルに出力することで，保守資料としても使用できます。プロセスインスタンスの全実行履歴のCSVファイルへの出力は，コマンドでだけ実行できます。

プロセスインスタンスの実行履歴をCSVファイルへ出力する手順を次に示します。

アクセスするHCSCサーバを決定します。

次のコマンドを実行して検索します。

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -detail -table {process｜activity｜link｜set｜string｜numeric｜boolean｜message｜relation}※

注※　どれか一つを指定します。

（例）次の条件で，コマンドを入力して，プロセスインスタンスの実行履歴を一括して再実行します。

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コマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscpiselect（プロセスインスタンスの検索）」を参照してください。

(9)　画面による検索結果を参照する

検索の結果は，検索結果フィールドに，総件数および一覧が表示されます。一覧は，一度に20件まで表示されます。

また，検索時との時間差によって，検索の結果，総件数と表示対象件数が異なる場合があります。例えば，総件数が13件で，表示対象件数が60件の場合などです。この場合は，表示対象の件数が20件を超えても，［次へ］ボタンが非活性の状態になり，21件目以降を表示できなくなるため，再検索をする必要があります。

また，検索結果一覧の［前へ］，［次へ］ボタンをクリックしたあとに，プロセスインスタンスの件数などが変化している場合があります。例えば，総件数が45件で，表示対象件数が21～40件を表示中に，［次へ］ボタンをクリックすると，総件数が10件になっている場合などです。この場合は，1～10件が表示されます。

6.1.3　プロセスインスタンスの実行履歴の詳細情報を取得する

次に示すように目的に応じて，プロセスインスタンスの実行履歴の詳細情報を取得します。

相関セットの値からプロセスインスタンスを特定する場合
各プロセスインスタンスを一意に特定する相関セットの情報である，相関セット定義名および相関セット値の一覧を取得します。

変数値からプロセスインスタンスを特定する場合
各プロセスインスタンスが持つグローバル変数の情報である，変数定義名および変数値の一覧を取得します。

プロセスインスタンスの実行状況を確認する場合
プロセスインスタンスについて，ビジネスプロセス内に定義された各アクティビティの情報を取得します。

＜この項の構成＞

(1)　相関セットの詳細情報の取得

(2)　変数の詳細情報の取得

(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 <エンコーディング名>

注※　情報取得対象のプロセスインスタンスの条件を指定します。

（例）次の条件で，コマンドを入力して，相関セット情報を取得します。

取得対象のプロセス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コマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「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　どれか一つを指定します。

where句が記載されたファイルを使用する場合

cscpiselect -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -wherefile <where句が記載されたファイル名>※1 -table {string｜numeric｜boolean｜message}※2 -encoding <エンコーディング名>

注※1　情報取得対象のプロセスインスタンスの条件を指定します。

注※2　どれか一つを指定します。

変数情報は，変数ごとに別テーブルになっているため，変数の型が不明な場合は，すべてのテーブルを検索してください。

（例）次の条件で，コマンドを入力して，変数情報を取得します。

取得対象のプロセス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コマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「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 <エンコーディング名>

注※　情報取得対象のプロセスインスタンスの条件を指定します。

（例）次の条件で，コマンドを入力して，アクティビティ情報を取得します。

取得対象のプロセス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コマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscpiselect（プロセスインスタンスの検索）」を参照してください。

6.1.4　プロセスインスタンスの実行履歴を削除する

リクエストを再送信する場合，またはテスト実行したプロセスインスタンスを削除する場合など，不要になったプロセスインスタンスの実行履歴を，1件ずつ削除できます。

また，プロセスインスタンスの実行履歴は，日々追加されていくため，定期的に情報を削除しないとデータベースの容量が圧迫されます。そこで，定期的に，管理者はデータベース上の実行履歴情報テーブルから，プロセスインスタンスの実行履歴を削除する必要があります。日常運用では通常，バッチ化して，実行履歴を一括削除できます。

プロセスインスタンスの実行履歴の削除は，画面による方法とコマンドによる方法があります。

＜この項の構成＞

(1)　画面による実行履歴の削除

(2)　コマンドによる実行履歴の削除

(1)　画面による実行履歴の削除

(a)　1件ずつ削除する場合

画面によってプロセスインスタンスの実行履歴を1件ずつ削除する手順を次に示します。

プロセスインスタンスを検索します。

検索結果一覧から，削除したいプロセスインスタンスの実行履歴を選択します。

［履歴削除］ボタンをクリックします。
プロセスインスタンス実行履歴削除の実行確認ダイアログが表示されます。
「実行中」のプロセスインスタンスを含む場合は，実行中のプロセスインスタンスの実行履歴を削除するかどうかを確認するダイアログが表示されます。

［OK］ボタンをクリックします。
プロセスインスタンスの実行履歴が削除され，プロセスインスタンスの実行履歴削除の実行結果ダイアログが表示されます。

［OK］ボタンをクリックします。
検索結果一覧が更新されます。

(b)　一括して削除する場合

画面によってプロセスインスタンスの実行履歴を一括削除する手順を次に示します。

プロセスインスタンスを検索します。

検索結果一覧から，削除したいプロセスインスタンスの実行履歴を選択します。
［Ctrl］キーまたは［Shift］キーを使用して，複数のプロセスインスタンスを選択します。

［履歴削除］ボタンをクリックします。
プロセスインスタンス実行履歴削除の実行確認ダイアログが表示されます。
「実行中」のプロセスインスタンスを含む場合は，実行中のプロセスインスタンスの実行履歴を削除するかどうかを確認するダイアログが表示されます。

［OK］ボタンをクリックします。
プロセスインスタンスの実行履歴が削除され，プロセスインスタンスの実行履歴削除の実行結果ダイアログが表示されます。

［OK］ボタンをクリックします。
検索結果一覧が更新されます。

注意

一括削除に失敗した場合，選択したプロセスインスタンスはまったく削除されません。

(2)　コマンドによる実行履歴の削除

(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

cscpideleteコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscpidelete（プロセスインスタンスの実行履歴の削除）」を参照してください。

(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ビジネスプロセス

cscpideleteコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscpidelete（プロセスインスタンスの実行履歴の削除）」を参照してください。

(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オプションのデフォルトタイムゾーンは，日本時間を使用しています。

cscpideleteコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscpidelete（プロセスインスタンスの実行履歴の削除）」を参照してください。

(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｜all}※

注※　どれか一つを指定します。

（例）次の条件で，コマンドを入力して，プロセスインスタンスの実行履歴を一括削除します。

プロセスインスタンスの状態：実行中

アクセスする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

cscpideleteコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscpidelete（プロセスインスタンスの実行履歴の削除）」を参照してください。

(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｜all}※2

注※1　照会開始日時は省略できます。

注※2　どれか一つを指定します。

（例）次の条件で，コマンドを入力して，プロセスインスタンスの実行履歴を一括削除します。

ビジネスプロセス定義名：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オプションのデフォルトタイムゾーンは，日本時間を使用しています。

cscpideleteコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscpidelete（プロセスインスタンスの実行履歴の削除）」を参照してください。

(f)　すべてのプロセスインスタンスの実行履歴を一括削除する場合

コマンドによってすべてのプロセスインスタンスの実行履歴を一括削除する手順を次に示します。

アクセスするHCSCサーバを決定します。

次のコマンドを実行して削除します。

cscpidelete -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -force

（例）次の条件で，コマンドを入力して，すべてのプロセスインスタンスの実行履歴を一括削除します。

アクセスするHCSCサーバ：HCSC

コマンド

cscpidelete -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -force

cscpideleteコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscpidelete（プロセスインスタンスの実行履歴の削除）」を参照してください。

6.1.5　プロセスインスタンスを再実行する

ビジネスプロセス実行中に，実行基盤のあるマシンが停止したり，サービス部品の呼び出しに失敗したりなど障害が発生し中断したプロセスインスタンスを，1件ずつ再実行できます。

また，複数のプロセスインスタンスが同一のビジネスプロセス定義名である場合，複数のプロセスインスタンスを一括再実行できます。プロセスインスタンスの実行履歴の一括再実行は，コマンドでだけ実行できます。

なお，サービスリクエスタから，ビジネスプロセスの再実行を要求して，ビジネスプロセスを再実行することもできます。サービスリクエスタによるビジネスプロセスの再実行については，マニュアル「Cosminexus サービスプラットフォーム 機能解説」の「4.5　ビジネスプロセスの再実行」を参照してください。

＜この項の構成＞

(1)　画面によるプロセスインスタンスの再実行

(2)　コマンドによるプロセスインスタンスの再実行

(3)　再実行のタイミング

(4)　プロセスインスタンス再実行時の応答電文の出力

(5)　SOAPフォルトの発生時の情報

(1)　画面によるプロセスインスタンスの再実行

(a)　1件ずつ再実行する場合

画面によってプロセスインスタンスを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 <ビジネスプロセス定義名>｝※

注※　どちらか一つを指定します。

（例）次の条件で，コマンドを入力して，プロセスインスタンスを再実行します。

再実行対象のプロセス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コマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscpireexec（プロセスインスタンスの再実行）」を参照してください。

(b)　ビジネスプロセス定義名を指定して一括再実行する場合

ビジネスプロセス定義名を指定して，プロセスインスタンスを一括再実行する手順を次に示します。

アクセスするHCSCサーバを決定します。

再実行対象のプロセスインスタンスのビジネスプロセス定義名を特定します。

次のコマンドを実行して再実行します。

cscpireexec -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> ｛-processname <ビジネスプロセス定義名>｜-processnamefile <ビジネスプロセス定義ファイル名>｝※

注※　どちらか一つを指定します。

（例）次の条件で，コマンドを入力して，プロセスインスタンスを一括して再実行します。

ビジネスプロセス定義名：Helloビジネスプロセス

アクセスするHCSCサーバ：HCSC

コマンド

cscpireexec -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -processname Helloビジネスプロセス

cscpireexecコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscpireexec（プロセスインスタンスの再実行）」を参照してください。

(c)　再実行の対象となるすべてのプロセスインスタンスを一括再実行する場合

再実行の対象となるすべてのプロセスインスタンスを一括再実行する手順を次に示します。

アクセスするHCSCサーバを決定します。

次のコマンドを実行して再実行します。

cscpireexec -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -all

（例）次の条件で，コマンドを入力して，再実行の対象となるすべてのプロセスインスタンスを一括して再実行します。

アクセスするHCSCサーバ：HCSC

コマンド

cscpireexec -user <ログインユーザID> -pass <ログインパスワード> -csc HCSC -all

cscpireexecコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscpireexec（プロセスインスタンスの再実行）」を参照してください。

(d)　注意事項

HCSCサーバで処理中のプロセスインスタンスに対しては，再実行しないでください。再実行する場合は，HCSCサーバからの応答やメッセージログでエラーの内容を確認し，エラーの原因を取り除いてから，プロセスインスタンスを再実行してください。

(3)　再実行のタイミング

画面やコマンドで実行履歴を検索してから再実行するまでの間に生じる時間差によって，検索結果に表示されたプロセスインスタンス実行履歴の状態と，実際のプロセスインスタンス実行履歴の状態が異なることがあります。この場合，「完了」，または「フォルト終了」状態のプロセスインスタンスに対して，再実行をしても，実際には，再実行は失敗し実施されません。そのため，できる限り最新の情報を取得して再実行を実施します。

(4)　プロセスインスタンス再実行時の応答電文の出力

プロセスインスタンスを再実行した結果，成功した場合もSOAPフォルトの発生で失敗した場合も，プロセスインスタンスから応答電文を受け取ることがあります。このような場合，HCSC-Manager定義ファイルに次に示す内容を設定して，応答電文をファイルに出力できます。

cscmng.pireexec.response.dir=応答電文格納ディレクトリ
cscmng.pireexec.response.encoding=応答電文格納文字コード

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

なお，プロセスIDは長い文字列（最大240文字）になる可能性があります。応答電文出力ディレクトリに深いディレクトリ階層を設定すると，ファイルを生成できない場合があるため注意してください。再実行しても，応答電文ファイルが生成されない場合はメッセージが出力されます。

(5)　SOAPフォルトの発生時の情報

プロセスインスタンスの再実行がSOAPフォルトの発生で失敗した場合，プロセスインスタンスから受け取るSOAPフォルト情報の種類と取り扱いを次に示します。

フォルトコード：エラーメッセージに表示されます。

フォルト文字列：エラーメッセージに表示されます。

フォルト生成者：エラーメッセージに表示されます。

フォルト詳細：再実行成功時の応答電文と同様に，応答電文格納用ディレクトリにファイル出力されます。ただし，出力エンコードはUTF-8だけとなります。

6.2　電文の実行履歴の管理

電文の実行状況を履歴として，データベースに記録できます。これを永続化といいます。永続化できるのは，データベースを使用する場合だけです。永続化すると，コマンドで実行履歴の情報を表示でき，その情報からサービス部品の呼び出し頻度などの情報の把握，電文の配送経路や配送状態の確認，およびビジネスプロセスの各アクティビティのサービス部品の内容を確認できます。また，不要になった実行履歴は削除できます。

ここでは，電文の実行履歴の設定や利用方法について説明します。

＜この節の構成＞

6.2.1　電文の実行履歴の概要

6.2.2　データベースに取得する電文の実行履歴を設定する

6.2.3　電文の実行履歴を利用する

6.2.4　電文の実行履歴を表示する

6.2.5　電文の実行履歴を削除する

6.2.1　電文の実行履歴の概要

電文の実行履歴は次の表に示すタイミングで採取します。

表6-1　電文の実行履歴採取のタイミング

採取タイミング | 説明 | 送信方向種別
サービス部品呼び出し要求時 | サービスアダプタまたはビジネスプロセスを実行する前 | Service Request Direction
サービス部品呼び出し応答時※ | 標準受付またはユーザ定義受付で，サービス部品呼び出しの結果を返すとき | Service Response Direction
サービス部品呼び出し応答のエラー※ | サービス部品またはビジネスプロセスから返ってきたユーザ定義例外（フォルト）を返すとき | Service Fault
サービス部品呼び出しエラー※ | サービス部品からのユーザ定義例外以外の例外や，ビジネスプロセスまたはHCSCサーバ内でエラーを検知した際，例外情報を返すとき | Service Error

注※　非同期のサービス部品を呼び出した場合は，応答電文はないため，非同期のサービス部品を呼び出すプログラムの処理が完了（リターン）するタイミングになります。

サービスアダプタを直接呼び出す場合と，ビジネスプロセスを呼び出す場合のそれぞれについて，電文の実行履歴を採取するタイミングを説明します。

＜この項の構成＞

(1)　サービスアダプタを直接呼び出す場合の電文の実行履歴を採取するタイミング

(2)　ビジネスプロセスを呼び出す場合の電文の実行履歴を採取するタイミング

(1)　サービスアダプタを直接呼び出す場合の電文の実行履歴を採取するタイミング

サービスアダプタを直接呼び出す場合は，エラーの有無やエラーの種類によって，電文の実行履歴を採取するタイミングが異なります。

(a)　正常応答する場合

サービスアダプタを直接呼び出して正常応答する場合の，電文の実行履歴を採取するタイミングを次の図に示します。

図6-2　電文の実行履歴を採取するタイミング（サービスアダプタを直接呼び出して正常応答する場合）

次に示す番号は，図6-2の図中の番号に対応しています。

(1) サービスアダプタを呼び出す前に，電文の実行履歴を採取します。

(2) 標準受付またはユーザ定義受付で，サービスリクエスタにサービス部品呼び出しの結果を返すときに電文の実行履歴を採取します。

(b)　サービス部品呼び出し応答がエラーになる場合

サービスアダプタを直接呼び出してサービス部品呼び出し応答がエラーになる場合の，電文の実行履歴を採取するタイミングを次の図に示します。

図6-3　電文の実行履歴を採取するタイミング（サービスアダプタを直接呼び出してサービス部品呼び出し応答がエラーになる場合）

次に示す番号は，図6-3の図中の番号に対応しています。

(1) サービスアダプタを呼び出す前に，電文の実行履歴を採取します。

このとき出力される要求電文種別は，リクエスト時の電文フォーマット定義ファイルの指定に依存します。また，(1)の時点ではサービスアダプタに要求が到達していない（応答結果が存在しない）ため，応答電文種別には「null」が出力されます。

(2) サービス部品からユーザ定義例外（フォルト）が返ってきた場合は，標準受付またはユーザ定義受付で，サービスリクエスタにサービス部品呼び出し応答の結果としてユーザ定義例外（フォルト）の情報を返すときに，実行履歴（サービス部品呼び出し応答エラー）を採取します。

エラーの伝わり方についての詳細は，「7.7　サービス部品呼び出し要求時の障害対策」を参照してください。

(c)　サービス部品呼び出しエラーの場合

サービスアダプタを直接呼び出してエラーになる場合の，電文の実行履歴を採取するタイミングを次の図に示します。

図6-4　電文の実行履歴を採取するタイミング（サービスアダプタを直接呼び出してエラーになる場合）

次に示す番号は，図6-4の図中の番号に対応しています。

サービスアダプタやサービス部品でエラーが発生した場合

(1) サービスアダプタを実行する前に，電文の実行履歴を採取します。

(2) サービスアダプタやサービス部品でエラーが発生した場合は，標準受付またはユーザ定義受付で，サービスリクエスタにサービス部品呼び出し応答の結果として例外（エラー）の情報を返すときに，実行履歴（サービス部品呼び出しエラー）を採取します。

HCSCサーバ内でエラーを検知した場合

(3) 標準受付またはユーザ定義受付で，サービスリクエスタにサービス部品呼び出し応答の結果として例外（エラー）の情報を返すときに，実行履歴（サービス部品呼び出しエラー）を採取します。

サービスアダプタが呼び出される前に，サービスアダプタが起動していないなどの理由で，HCSCサーバ内でエラーを検知した場合は，サービスアダプタを実行する前に，電文の実行履歴を採取しません。

エラーの伝わり方についての詳細は，「7.7　サービス部品呼び出し要求時の障害対策」を参照してください。

(2)　ビジネスプロセスを呼び出す場合の電文の実行履歴を採取するタイミング

ビジネスプロセスを呼び出す場合は，エラーの有無やエラーの種類によって，電文の実行履歴を採取するタイミングが異なります。

(a)　正常応答する場合

ビジネスプロセスを呼び出して正常応答する場合の，電文の実行履歴を採取するタイミングを次の図に示します。

図6-5　電文の実行履歴を採取するタイミング（ビジネスプロセスを呼び出して正常応答する場合）

次に示す番号は，図6-5の図中の番号に対応しています。

(1) ビジネスプロセスを実行する前に，電文の実行履歴を採取します。

(2) サービスアダプタを実行する前に電文の実行履歴を採取します。ビジネスプロセスに定義したサービス呼出アクティビティからサービス部品を呼び出すたびに実行履歴を採取します。

(3) ビジネスプロセスへ応答を返すときに，電文の実行履歴を採取します。

(4) 標準受付やユーザ定義受付で，サービスリクエスタにビジネスプロセスからの応答を返すときに電文の実行履歴を採取します。

(b)　ビジネスプロセスでフォルトエラーになる場合

ビジネスプロセスを呼び出して，ビジネスプロセスでフォルト（ユーザ定義例外）が発生してエラーになる場合の，電文の実行履歴を採取するタイミングを次の図に示します。

図6-6　電文の実行履歴を採取するタイミング（ビジネスプロセスを呼び出してビジネスプロセスでフォルトエラーになる場合）

次に示す番号は，図6-6の図中の番号に対応しています。

(1) ビジネスプロセスを実行する前に，電文の実行履歴を採取します。

(2) ビジネスプロセスに定義したサービス呼出アクティビティからサービスアダプタを実行する前に，電文の実行履歴を採取します。

(3) サービス部品からの応答は正常なため，ビジネスプロセスへサービス部品呼び出し結果を返すときに，電文の実行履歴を採取します。

(4) サービス部品呼び出し結果の応答電文の内容から，ビジネスプロセスでフォルトと判断されると，標準受付またはユーザ定義受付で，サービスリクエスタに応答を返すときに，実行履歴（エラー（フォルト））を採取します。

(c)　サービス部品でフォルトエラーになる場合

ビジネスプロセスを呼び出して，サービス部品でフォルト（ユーザ定義例外）が発生してエラーになる場合の，電文の実行履歴を採取するタイミングを次の図に示します。

図6-7　電文の実行履歴を採取するタイミング（ビジネスプロセスを呼び出してサービス部品でフォルトエラーになる場合）

次に示す番号は，図6-7の図中の番号に対応しています。

(1) ビジネスプロセスを実行する前に，電文の実行履歴を採取します。

(2) ビジネスプロセスに定義したサービス呼出アクティビティでサービス部品を呼び出し，サービスアダプタを実行する前に，電文の実行履歴を採取します。

(3) サービス部品からユーザ定義例外（フォルト）が返ってくるため，ビジネスプロセスへ応答を返すときに，実行履歴（サービス部品呼び出し応答エラー）を採取します。

(4) サービス部品呼び出し結果の応答電文自体が，ビジネスプロセスでフォルトと判断されると，標準受付またはユーザ定義受付で，サービスリクエスタにサービス部品呼び出し結果を返すときに，実行履歴（エラー（フォルト））を採取します。

エラーの伝わり方についての詳細は，「7.7　サービス部品呼び出し要求時の障害対策」を参照してください。

(d)　ビジネスプロセスからのサービス部品呼び出しエラーの場合

ビジネスプロセスを呼び出して，ビジネスプロセスからサービス部品呼び出しエラーになる場合の，電文の実行履歴を採取するタイミングを次の図に示します。

図6-8　電文の実行履歴を採取するタイミング（ビジネスプロセスを呼び出してビジネスプロセスからサービス部品呼び出しエラーになる場合）

次に示す番号は，図6-8の図中の番号に対応しています。

サービスアダプタやサービス部品にエラーが発生した場合

(1) ビジネスプロセスを実行する前に，電文の実行履歴を採取します。

(2) ビジネスプロセスに定義したサービス呼出アクティビティでサービス部品を呼び出し，サービスアダプタを実行する前に，電文の実行履歴を採取します。

(3) サービスアダプタやサービス部品でエラーが発生し，ビジネスプロセスへ応答を返すときに，実行履歴（サービス部品呼び出しエラー）を採取します。

(4) 標準受付やユーザ定義受付で，サービスリクエスタにサービス部品呼び出し応答の結果として例外（エラーの情報）を返すときに，実行履歴（サービス部品呼び出しエラー）を採取します。

サービスアダプタが呼び出される前に，サービスアダプタが起動していないなどの理由で，HCSCサーバ内でエラーを検知した場合は，(1)のタイミングでは実行履歴を採取しないで，(4)のタイミングでだけ採取します。

ビジネスプロセスにエラーが発生した場合

(5) ビジネスプロセスを実行する前に，電文の実行履歴を採取します。

(6) ビジネスプロセスでエラーが発生して応答がエラーとなるため，標準受付またはユーザ定義受付で，サービスリクエスタにサービス部品呼び出し結果として，例外（エラー）の情報を返すときに，電文の実行履歴（サービス部品呼び出しエラー）を採取します。

エラーの伝わり方についての詳細については，「7.7　サービス部品呼び出し要求時の障害対策」を参照してください。

6.2.2　データベースに取得する電文の実行履歴を設定する

電文の実行履歴を確認するには，電文の実行履歴としてデータベースに取得する情報を設定します。電文の実行履歴としてデータベースに取得する情報と設定方法を次に説明します。

＜この項の構成＞

(1)　電文データ以外の情報を取得する場合

(2)　電文データを含むすべての情報を取得する場合

(1)　電文データ以外の情報を取得する場合

(a)　取得する情報

電文データ（ユーザ電文）以外の情報をデータベースに取得します。電文データ以外の情報には，基本情報と基本情報以外の情報があります。取得する情報の詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「csmlshistory（電文の実行履歴情報の表示）」を参照してください。それぞれの情報を次に示します。

基本情報

EntryCount：エントリ番号

TimeStamp：実行履歴採取時刻

ClusterName：サービス部品を呼び出したHCSCサーバのクラスタ名

HistoryDirection：実行履歴採取方向

HCSCCommonID：メッセージ共通ID

ServiceRequestID：サービスリクエストID

RequestServiceName：サービスリクエスタからの入力サービス部品名

ServiceName：呼び出し先のサービス部品名

ErrorCode：エラー情報

Version：実行履歴情報コンテナのバージョン番号

Revision：実行履歴情報コンテナのリビジョン番号

基本情報以外の情報

HCSCServerName：受付HCSCサーバ名

ClientID：クライアント相関ID

JMSMessageID：JMSメッセージID

JMSCorrelationID：JMS相関識別子

RequestType：サービスリクエスタ種別

RequestProtocolKind：リクエストのプロトコル種別

ServiceKind：サービス部品の種別

AdapterName：サービスアダプタまたはビジネスプロセスのサービスID

ServiceProtocolKind：サービスアダプタの種類

ServiceOperationName：サービス部品のオペレーション名

ConnectProtocolKind：連携プロトコル種別

RequestUserTelegramType：ユーザ電文の種別

ResponseUserTelegramType：ユーザへの応答電文の種別

BPActivity：ビジネスプロセス用アクティビティ番号

BPProcessID：ビジネスプロセス用プロセス

BPRequestType：ビジネスプロセス用要求タイプ

ReplyToQueueName：応答用のキュー名

RouteHistory：経路履歴情報

(b)　設定方法

基本情報および基本情報以外の情報のどちら場合も，HCSCサーバランタイム定義ファイルに次のプロパティを指定して，実行履歴を取得します。

historyrecord=ON

データベースを使用する構成でHCSCサーバをセットアップしている場合にだけ，ONを指定できます。

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

(2)　電文データを含むすべての情報を取得する場合

(a)　取得する情報

すべての情報（基本情報，基本情報以外の情報，電文データ（ユーザ電文））をデータベースに取得します。「6.2.2(1)(a) 取得する情報」で示した情報のほかに，次の情報を取得します。

UserTelegram：ユーザ電文

ユーザ電文は，長さを指定して必要な分だけデータベースに取得することもできます。取得する情報の詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「csmlshistory（電文の実行履歴情報の表示）」を参照してください。

(b)　設定方法

実行履歴の取得の有無を設定する場合
HCSCサーバランタイム定義ファイルに次のプロパティを指定して，実行履歴の取得有無を設定します。

historyrecord=ON
historyrecord-data=ON

電文データ（ユーザ電文）の長さを設定する場合
電文データ（ユーザ電文）の長さを設定して取得する場合は，実行履歴の取得有無のほかに，HCSCサーバランタイム定義ファイルの次のプロパティに，取得する電文データの長さを指定します。

historyrecord-binarylength=<電文データの長さ>

すべての電文データ（ユーザ電文）を取得する場合
上限を決めないで，すべての電文データ（ユーザ電文）を取得する場合は，次のように指定します。

historyrecord-binarylength=FULL

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

6.2.3　電文の実行履歴を利用する

電文の実行履歴は，次のように利用できます。

サービス部品の呼び出し頻度などの情報を把握する場合
電文の実行履歴を確認して，どのサービス部品がどのくらいの頻度で呼び出されているのか，どのサービス部品がいつ呼び出されているのかなどの統計を調べることができます。
csmlshistoryコマンドを利用して電文の実行履歴を確認できます。

電文の配送経路や配送状態を確認する場合
電文の実行履歴の中から目的の電文を特定して，電文の配送経路や配送状態を確認できます。
csmlshistoryコマンドを利用して電文の実行履歴を確認できます。目的の電文がほかのHCSCサーバに送信されている場合は，送信先のHCSCサーバの電文の実行履歴から，配送経路や配送状態を確認します。

ビジネスプロセスの各アクティビティのサービス部品の内容を確認する場合
ビジネスプロセスで定義されているアクティビティのサービス部品の内容（サービス部品の呼び出し先，要求に対するユーザ電文の内容など）を確認できます。アクティビティのサービス部品の内容を確認することで，どのアクティビティまで処理が進んでいるのか，どのアクティビティでエラーになっているのかを調べることができます。
csmlshistoryコマンドを利用して確認できます。ただし，アクティビティのサービス部品の内容を確認するためには，アクティビティが定義されているビジネスプロセスが，どのHCSCサーバに配備されているかをあらかじめ把握しておく必要があります。なお，配備されているHCSCサーバが停止している場合でも，電文の実行履歴を確認できます。

＜この項の構成＞

(1)　サービス部品の呼び出し頻度などの情報を把握する場合

(2)　電文の配送経路や配送状態を確認する場合

(3)　ビジネスプロセスの各アクティビティのサービス部品の内容を確認する場合

(1)　サービス部品の呼び出し頻度などの情報を把握する場合

サービス部品の呼び出し頻度などの情報を把握する場合は，電文の実行履歴を次のように利用します。

csmlshistoryコマンドに条件を指定して，電文の実行履歴を検索します。
次に示す条件を一つ以上指定します。

開始日時および終了日時
一定期間の電文を確認する場合に指定します。

クライアント相関ID
サービスリクエスタでクライアント相関IDを指定している場合に指定できます。

サービスリクエスタで受け付けた入力サービス名

呼び出し先のサービス名

JMSメッセージID（JMSヘッダのJMSMessageIDの値）
非同期のサービス部品の呼び出しの場合に指定できます。

JMS相関識別子（JMSヘッダのJMSCorrelationIDの値）
非同期のサービス部品の呼び出しの場合に指定できます。

メッセージ共通ID

サービスリクエストID

検索結果から電文の詳細情報を確認します。
ServiceNameで呼び出し先のサービス名を，TimeStampで電文の実行履歴をデータベースに取得した時刻を確認します。検索結果の詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「csmlshistory（電文の実行履歴情報の表示）」の表示形式を参照してください。

(2)　電文の配送経路や配送状態を確認する場合

電文の配送経路や配送状態を確認する場合は，電文の実行履歴を次のように利用します。

目的の電文を特定するために，csmlshistoryコマンドに条件を指定して，電文の実行履歴を検索します。
次に示す条件を一つ以上指定します。

開始日時および終了日時
一定期間の電文を確認する場合に指定します。

クライアント相関ID
サービスリクエスタでクライアント相関IDを指定している場合に指定できます。

サービスリクエスタで受け付けた入力サービス名

呼び出し先のサービス名

JMSメッセージID（JMSヘッダのJMSMessageIDの値）
非同期のサービス部品の呼び出しの場合に指定できます。

JMS相関識別子（JMSヘッダのJMSCorrelationIDの値）
非同期のサービス部品の呼び出しの場合に指定できます。

検索結果から電文の詳細情報を確認して，目的の電文を特定します。
目的の電文が特定できない場合は，検索条件や表示する情報を変更して，再検索します。表示する情報を変更して再検索する方法については，「6.2.4　電文の実行履歴を表示する」を参照してください。

目的の電文の配送経路や配送状態を確認するために，csmlshistoryコマンドを利用して，ほかのHCSCサーバの電文の実行履歴を検索します。
次に示す条件を一つ以上指定して，電文の実行履歴を検索します。

メッセージ共通ID

サービスリクエストID

検索結果から電文の詳細情報を確認します。
検索結果のRouteHistoryで配送経路を，ErrorCodeでエラー情報を確認します。
検索結果の詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「csmlshistory（電文の実行履歴情報の表示）」の表示形式を参照してください。

(3)　ビジネスプロセスの各アクティビティのサービス部品の内容を確認する場合

ビジネスプロセスの各アクティビティのサービス部品の内容（サービス部品の呼び出し先，要求に対するユーザ電文の内容など）を確認したい場合は，電文の実行履歴を次のように利用します。

アクティビティが定義されているビジネスプロセスが，どのHCSCサーバに配備されているか確認します。

csmlshistoryコマンドに条件を指定して，電文の実行履歴を検索します。
次に示す条件を一つ以上指定します。

検索条件

開始日時および終了日時
一定期間の電文を確認する場合に指定します。

クライアント相関ID
サービスリクエスタでクライアント相関IDを指定している場合に指定できます。

サービスリクエスタで受け付けた入力サービス名

呼び出し先のサービス名

JMSメッセージID（JMSヘッダのJMSMessageIDの値）
非同期のサービス部品の呼び出しの場合に指定できます。

JMS相関識別子（JMSヘッダのJMSCorrelationIDの値）
非同期のサービス部品の呼び出しの場合に指定できます。

メッセージ共通ID

サービスリクエストID

表示項目

検索結果には基本情報以外の情報も表示されるように設定します。設定方法については，「6.2.4　電文の実行履歴を表示する」を参照してください。

検索結果から次の項目を確認して，目的のビジネスプロセスのアクティビティを特定します。

HistoryDirection：実行履歴採取方向
実行履歴採取方向には，送信方向（ServiceRequestDirection）と応答方向（ServiceResponseDirection）があります。

目的のビジネスプロセスのアクティビティのサービス部品の内容を確認します。

検索結果の詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「csmlshistory（電文の実行履歴情報の表示）」の表示形式を参照してください。

6.2.4　電文の実行履歴を表示する

データベースに取得した電文の実行履歴を表示して，電文の実行履歴を確認します。電文の実行履歴で表示できる情報には，次の四つがあります。

基本情報

電文データ以外のすべての情報

電文データを含むすべての情報

履歴情報の件数

基本情報，電文データ以外のすべての情報，および電文データを含むすべての情報については，「6.2.2　データベースに取得する電文の実行履歴を設定する」を参照してください。

＜この項の構成＞

(1)　基本情報だけを表示する

(2)　電文データ以外のすべての情報を表示する

(3)　電文データを含むすべての情報を表示する

(4)　履歴情報の件数を表示する

(1)　基本情報だけを表示する

基本情報だけを表示する手順を次に示します。

実行履歴の情報を表示するHCSCサーバを決定します。

csmlshistoryコマンドを実行して検索します。
-dオプションには「nml」を，-kオプションには「list」を指定します。

csmlshistory <HCSCサーバ名> -c <クライアント相関ID>※1 -m <メッセージ共通ID>※1 -i <サービスリクエストID>※1 -t <照会開始日時>,<照会終了日時>※1 -rs <サービスリクエスタからの入力サービス名>※1 -s <サービス名>※1 -jm <JMSメッセージID>※1 -jc <JMS相関識別子>※1 -l {new｜all}※2 -d nml -r <表示レコード数> -k list -u <DBユーザID>※3 -p <DBパスワード>※3

注※1

一つ以上指定します。

注※2

どちらか一つを指定します。

注※3

HCSCサーバが停止している場合で，データベースの設定で認証が必要なときだけ指定します。

（例）次の条件で，コマンドを入力して，電文の実行履歴を検索します。

HCSCサーバ名：HCSC

照会開始日時：2006/08/29 08:00:00

照会終了日時：2006/08/29 12:00:00

-lオプション：all（該当するすべての実行履歴情報を表示します）

-dオプション：nml（基本情報だけを表示します）

-kオプション：指定なし（-kオプションに「list」が仮定され，履歴情報の内容を表示します）

コマンド

csmlshistory HCSC -t 20060829080000,20060829120000 -l all -d nml

出力結果

(2)　電文データ以外のすべての情報を表示する

電文データ以外のすべての情報を表示する手順を次に示します。

実行履歴の情報を表示するHCSCサーバを決定します。

csmlshistoryコマンドを実行して検索します。
-dオプションには「ext」を，-kオプションには「list」を指定します。

csmlshistory <HCSCサーバ名> -c <クライアント相関ID>※1 -m <メッセージ共通ID>※1 -i <サービスリクエストID>※1 -t <照会開始日時>,<照会終了日時>※1 -rs <サービスリクエスタからの入力サービス名>※1 -s <サービス名>※1 -jm <JMSメッセージID>※1 -jc <JMS相関識別子>※1 -l {new｜all}※2 -d ext -r <表示レコード数> -k list -u <DBユーザID>※3 -p <DBパスワード>※3

注※1

一つ以上指定します。

注※2

どちらか一つを指定します。

注※3

HCSCサーバが停止している場合で，データベースの設定で認証が必要なときだけ指定します。

（例）次の条件で，コマンドを入力して，電文の実行履歴を検索します。

HCSCサーバ名：HCSC

照会開始日時：2006/08/29 08:00:00

照会終了日時：2006/08/29 12:00:00

-lオプション：all（該当するすべての実行履歴情報を表示します）

-dオプション：ext（電文データ以外のすべての情報を表示します）

-kオプション：指定なし（-kオプションに「list」が仮定され，履歴情報の内容を表示します）

コマンド

csmlshistory HCSC -t 20060829080000,20060829120000 -l all -d ext

出力結果

(3)　電文データを含むすべての情報を表示する

電文データを含むすべての情報を表示する手順を次に示します。

実行履歴の情報を表示するHCSCサーバを決定します。

csmlshistoryコマンドを実行して検索します。
-dオプションには「msg」を，-kオプションには「list」を指定します。

csmlshistory <HCSCサーバ名> -c <クライアント相関ID>※1 -m <メッセージ共通ID>※1 -i <サービスリクエストID>※1 -t <照会開始日時>,<照会終了日時>※1 -rs <サービスリクエスタからの入力サービス名>※1 -s <サービス名>※1 -jm <JMSメッセージID>※1 -jc <JMS相関識別子>※1 -l {new｜all}※2 -d msg -ul <電文データ長> -r <表示レコード数> -k list -u <DBユーザID>※3 -p <DBパスワード>※3

注※1

一つ以上指定します。

注※2

どちらか一つを指定します。

注※3

HCSCサーバが停止している場合で，データベースの設定で認証が必要なときだけ指定します。

注意

HCSCサーバランタイム定義ファイルで「historyrecord-data=OFF」を指定した場合は，電文データの実行履歴をデータベースに取得しません。電文データを表示する場合は，「historyrecord-data=ON」を指定してください。

（例）次の条件で，コマンドを入力して，電文の実行履歴を検索します。

HCSCサーバ名：HCSC

照会開始日時：2006/08/29 08:00:00

照会終了日時：2006/08/29 12:00:00

-lオプション：all（該当するすべての実行履歴情報を表示します）

-dオプション：msg（電文データを含むすべての情報を表示します）

-kオプション：指定なし（-kオプションに「list」が仮定され，履歴情報の内容を表示します）

コマンド

csmlshistory HCSC -t 20060829080000,20060829120000 -l all -d msg

出力結果

(4)　履歴情報の件数を表示する

指定した検索条件を満たす履歴情報の件数を表示する手順を次に示します。

実行履歴の情報を表示するHCSCサーバを決定します。

csmlshistoryコマンドを実行して検索します。
-kオプションには，「count」を指定します。

csmlshistory <HCSCサーバ名> -c <クライアント相関ID>※1 -m <メッセージ共通ID>※1 -i <サービスリクエストID>※1 -t <照会開始日時>,<照会終了日時>※1 -rs <サービスリクエスタからの入力サービス名>※1 -s <サービス名>※1 -jm <JMSメッセージID>※1 -jc <JMS相関識別子>※1 -l {new｜all}※2 -k count -u <DBユーザID>※3 -p <DBパスワード>※3

注※1

一つ以上指定します。

注※2

どちらか一つを指定します。

注※3

HCSCサーバが停止している場合で，データベースの設定で認証が必要なときだけ指定します。

（例）次の条件で，コマンドを入力して，電文の実行履歴を検索します。

HCSCサーバ名：HCSC

照会開始日時：2006/08/29 08:00:00

照会終了日時：2006/08/29 12:00:00

-lオプション：all（該当するすべての実行履歴情報を表示します）

-kオプション：count（履歴情報の件数（エントリ数）を表示します）

コマンド

csmlshistory HCSC -t 20060829080000,20060829120000 -l all -k count

出力結果

6.2.5　電文の実行履歴を削除する

電文の実行履歴は，日々追加されていくため，定期的に情報を削除しないとデータベースの容量が圧迫されます。そこで，定期的に，管理者はデータベース上の実行履歴情報テーブルから，電文の実行履歴を削除する必要があります。

電文の実行履歴は，電文を送信したHCSCサーバをあらかじめ把握してから，csmdeletehistoryコマンドで削除できます。csmdeletehistoryコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「csmdeletehistory（電文の実行履歴情報テーブルのレコードの削除）」を参照してください。

＜この項の構成＞

(1)　日時を条件として実行履歴を削除する

(2)　日数を条件として実行履歴を削除する

(3)　メッセージ共通IDを条件として実行履歴を削除する

(4)　クライアント相関IDを条件として実行履歴を削除する

(5)　サービスアダプタまたはビジネスプロセスのサービスIDを条件として実行履歴を削除する

(6)　すべての実行履歴を削除する

(1)　日時を条件として実行履歴を削除する

次のコマンドを実行します。

csmdeletehistory <HCSCサーバ名> -t <削除開始日時> -u <DBユーザID>※ -p <DBパスワード>※

注※

HCSCサーバが停止している場合で，データベースの設定で認証が必要なときだけ指定します。

(2)　日数を条件として実行履歴を削除する

次のコマンドを実行します。

csmdeletehistory <HCSCサーバ名> -d <日数> -u <DBユーザID>※ -p <DBパスワード>※

注※

HCSCサーバが停止している場合で，データベースの設定で認証が必要なときだけ指定します。

(3)　メッセージ共通IDを条件として実行履歴を削除する

次のコマンドを実行します。

csmdeletehistory <HCSCサーバ名> -t <削除開始日時>※1 -d <日数>※1 -m <メッセージ共通ID> -u <DBユーザID>※2 -p <DBパスワード>※2

注※1

どちらか一方を指定します。

注※2

HCSCサーバが停止している場合で，データベースの設定で認証が必要なときだけ指定します。

(4)　クライアント相関IDを条件として実行履歴を削除する

次のコマンドを実行します。

csmdeletehistory <HCSCサーバ名> -t <削除開始日時>※1 -d <日数>※1 -c <クライアント相関ID> -u <DBユーザID>※2 -p <DBパスワード>※2

注※1

どちらか一方を指定します。

注※2

HCSCサーバが停止している場合で，データベースの設定で認証が必要なときだけ指定します。

(5)　サービスアダプタまたはビジネスプロセスのサービスIDを条件として実行履歴を削除する

次のコマンドを実行します。

csmdeletehistory <HCSCサーバ名> -t <削除開始日時>※1 -d <日数>※1 -a <サービスアダプタまたはビジネスプロセスのサービスID> -u <DBユーザID>※2 -p <DBパスワード>※2

注※1

どちらか一方を指定します。

注※2

HCSCサーバが停止している場合で，データベースの設定で認証が必要なときだけ指定します。

(6)　すべての実行履歴を削除する

次のコマンドを実行します。-dオプションには「0」を指定します。

csmdeletehistory <HCSCサーバ名> -d 0 -u <DBユーザID>※ -p <DBパスワード>※

注※

HCSCサーバが停止している場合で，データベースの設定で認証が必要なときだけ指定します。

6.3　実行履歴情報テーブルの管理

プロセスインスタンスや電文の実行履歴は，日々増大していくため，管理者はバックアップを取得したり，実行履歴情報テーブルのレコードを削除したりして管理する必要があります。

＜この節の構成＞

6.3.1　実行履歴情報テーブルのバックアップを取得する

6.3.2　実行履歴情報テーブルのバックアップ取得の運用

6.3.1　実行履歴情報テーブルのバックアップを取得する

＜この項の構成＞

(1)　HiRDBを使ったバックアップの取得

(2)　Oracleを使ったバックアップの取得

(1)　HiRDBを使ったバックアップの取得

HiRDBのデータベース複写ユティリティ（pdcopy）を使用して，定期的に実行履歴情報テーブルのバックアップを取得できます。また，データベース回復ユティリティ（pdrstr）を使用してデータベースを回復できます。HiRDBのデータベース複写ユティリティ（pdcopy）を使用したデータベースのバックアップと回復について，次の図に示します。

図6-9　HiRDBを使ったデータベースのバックアップと回復

HiRDBを使ってバックアップを取得する場合は，HiRDBのデータベース複写ユティリティ（pdcopy）の-Ｍオプションでバックアップ取得モードを選択します。HCSCサーバが稼働中か停止中かで，選択するモードが異なります。

HCSCサーバ稼働中
更新可能モード（s）を選択します。
更新可能モードを選択すると，バックアップ取得中に，バックアップ対象RDエリアを参照および更新できます。
バックアップ取得時点には，バックアップ取得時点以降の任意の同期点へ回復できます。データベースを回復するには，バックアップおよびバックアップ取得直前のシンクポイントからのシステムログが必要です。

HCSCサーバ停止中（メンテナンス中など）
参照可能モード（r），または参照・更新不可能モード（x）を選択します。
参照可能モードを選択すると，バックアップ取得中に，バックアップ対象RDエリアを参照だけできますが，更新はできません。
参照・更新不可能モードを選択すると，バックアップ取得中に，バックアップ対象RDエリアの参照も更新もできません。バックアップを取得する前に，対象RDエリアをHiRDBのpdhold -cコマンドで閉塞かつクローズ状態にする必要があります。
これらのモードで取得したバックアップを使用すれば，データベースをバックアップ取得時点に回復できます。また，システムログを使用すれば，バックアップ取得時点以降の任意の同期点に回復できます。

HiRDBのデータベース複写ユティリティ（pdcopy），データベース回復ユティリティ（pdrstr），およびバックアップ取得モードについては，マニュアル「HiRDB 解説」を参照してください。

(2)　Oracleを使ったバックアップの取得

OracleのRecovery Manager（RMAN）機能を使用して，定期的に実行履歴情報テーブルのバックアップを取得できます。前回のバックアップからの差分をバックアップできます。詳細については，製品が提供するマニュアルを参照してください。

6.3.2　実行履歴情報テーブルのバックアップ取得の運用

プロセスインスタンスや電文が実行されるたびに実行履歴は増え，データベースの容量は圧迫されます。HCSCサーバ稼働中に実行履歴情報テーブルのバックアップを取得する場合，バックアップ取得後も，実行履歴情報テーブル中のレコードは残ります。

そのため，テーブルのバックアップの取得，実行履歴の削除，およびデータベースのテーブルの再編成を定期的に実施することによって，ディスク容量の枯渇，およびデータベースの増大に対処できます。手順を次に示します。

HiRDBのデータベース複写ユティリティ（pdcopy）を利用して，実行テーブルの差分バックアップを取得します。

実行履歴を削除します。

プロセスインスタンスの実行履歴を削除する場合

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

電文の実行履歴を削除する場合

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

HiRDBのデータベース再編成ユティリティ（pdrorg）を利用して，データベースのテーブルを再編成します。
実行履歴の追加や削除を繰り返すと，データの格納効率が悪くなり性能が低下します。これを防ぐために，定期的にpdrorgコマンド（データベース再編成ユティリティ）で表を再編成してください。なお，実行履歴情報テーブルにはインデクスが定義されているため，インデクスも再作成する必要があります。
HiRDBの表の再編成に関する詳細については，マニュアル「HiRDB システム運用ガイド」を，pdrorgコマンドの詳細については，マニュアル「HiRDB コマンドリファレンス」を参照してください。

定期的にバックアップ，および削除する間隔は，ユーザ業務の内容によって異なるため，運用管理者が対処する必要があります。

実行履歴情報テーブルのバックアップとレコード削除の運用例を次の図に示します。

図6-10　実行履歴情報テーブルのバックアップとレコード削除の運用例

説明

実行履歴情報テーブルのバックアップを取得します（１回目のバックアップ）。

２回目のバックアップでは，１回目のバックアップ以降との差分のバックアップを取得します。

実行履歴の検索コマンドで，削除対象となる，ある日時以前の履歴またはある状態のプロセスインスタンスや電文の実行履歴を検索します（例では，過去50日より古いレコードを検索します）。

バックアップ取得後，実行履歴削除コマンドで古いレコードを削除します（例では，過去50日より古いレコードを削除します）。

テーブルを再編成します。

3回目のバックアップでは，2回目のバックアップ以降との差分のバックアップを取得します。

実行履歴の検索コマンドで，削除対象となる，ある日時以前の履歴またはある状態のプロセスインスタンスや電文の実行履歴を検索します（例では，過去50日より古いレコードを検索します）。

バックアップ取得後，実行履歴削除コマンドで古いレコードを削除します（例では，過去50日より古いレコードを削除します）。

テーブルを再編成します。

4回目のバックアップでは，3回目のバックアップ以降との差分のバックアップを取得します。

実行履歴の検索コマンドで，削除対象となる，ある日時以前の履歴やある状態のプロセスインスタンスや電文を検索します（例では，過去50日より古いレコードを検索します）。

バックアップ取得後，実行履歴削除コマンドで古いレコードを削除します（例では，過去50日より古いレコードを削除します）。

7.　障害対策

この章では，システム構築や運用時に発生する障害に対して取得できる情報の種類，および障害の対処方法などについて説明します。

なお，UNIX環境の場合は，ディレクトリ表記中の"¥"を"/"に読み換えてください。

＜この章の構成＞

7.1　障害対策の流れ

7.2　障害調査のために必要な情報

7.3　障害情報の取得

7.4　障害情報の種類

7.5　システムのセットアップまたはアンセットアップ時の障害対策

7.6　オペレーション実行時の障害対策

7.7　サービス部品呼び出し要求時の障害対策

7.8　障害発生時の自動運用

7.9　HCSCサーバ障害発生後の回復方法

7.10　メッセージトラッキングを利用した障害解析

7.11　例外発生時に取得するエラーの選択

7.12　OutOfMemoryError発生時の運用

7.1　障害対策の流れ

構築中または運用中に障害が発生し環境構築に失敗した場合，次の図に示す手順で障害要因を特定してください。

図7-1　障害対策の流れ

各手順の説明を次に説明します。

(a)　現象の確認

障害解析のために，どのような環境でどのような現象が発生したのか状況を確認します。

確認する項目については，「7.2　障害調査のために必要な情報」を参照してください。

(b)　障害情報の収集

障害を調査するために取得している障害情報（ログやトレースなど）のうち，必要な障害情報（一次資料および二次資料）を集めます。一次資料は障害を調査する上で一次判別のために使用し，二次資料は一次判別で判明した障害の内容に応じて使用する障害情報です。

必要な資料については，「7.2　障害調査のために必要な情報」を参照してください。また，障害情報の取得方法については，「7.3　障害情報の取得」を参照してください。障害情報の種類によって，必ず取得されるものと，取得の設定が必要なものとがあるため注意してください。

(c)　障害発生個所の特定

収集した障害情報の内容を確認して障害を調査し，障害発生個所を特定します。障害調査の結果，サービスリクエスタやサービス部品などのユーザプログラムがエラーメッセージや例外を出力している場合は，システム開発者に確認し，障害要因の特定および回復をする必要があります。

それ以外の場合，最初に，サービス部品呼び出し要求時の障害であるか，オペレーション（コマンド操作や運用環境の画面からの操作）実行時の障害であるか，行った操作を基に要因を切り分けます。

HCSCサーバ，およびHCSC-Managerが出力するログおよびトレースの見方（出力形式）については，「7.4　障害情報の種類」を参照してください。それ以外の前提製品が出力する障害情報については，各製品のマニュアルを参照してください。

(d)　障害要因の特定

障害発生個所や障害発生時の操作によって，障害が発生した要因（原因）を特定します。

(e)　障害情報の再収集

障害要因を特定できない場合，システム管理者または保守員への連絡に必要な保守情報を収集します。詳細については「7.2　障害調査のために必要な情報」を参照してください。

(f)　システム管理者または保守員に連絡

システム管理者または保守員に連絡し，一次資料および保守資料を送付します。また，発生した障害などの状況に応じて二次資料を送付します。

(g)　回復

障害が発生した要因（原因）を取り除き，正常な動作となるよう回復させて，運用を再開します。

7.2　障害調査のために必要な情報

ここでは，障害発生時の状況調査のために必要な資料の種類を示します。

障害を調査するときに必要な情報
取得が必要な資料は，発生した障害の種別によって異なります。ここでは，Cosminexus サービスプラットフォームで想定される障害の種別と，それに応じて取得が必要な資料の一覧を示します。

システム管理者または保守員に連絡するときに必要な情報
障害の内容によっては，システム管理者または保守員に連絡する必要があります。保守員とは，ご購入契約に基づくお問い合わせ窓口のことです。
保守員に連絡するときは，障害を調査するときに必要な情報のほかに，資料の取得が必要になる場合があります。

＜この節の構成＞

7.2.1　障害を調査するときに必要な情報

7.2.2　システム管理者または保守員に連絡するときに必要な情報

7.2.1　障害を調査するときに必要な情報

＜この項の構成＞

(1)　現象の確認

(2)　収集する障害情報

(1)　現象の確認

障害が発生した場合，最初にどのような環境でどのような現象が発生したのか状況を確認，整理します。障害発生時に確認する項目を次の表に示します。

表7-1　障害発生時に確認する項目

項番
確認する項目
障害を検知したマシン

HCSCサーバ稼働マシン
運用環境稼働マシン
サービスリクエスタ稼働マシン
サービス部品稼働マシン
データベース稼働マシン

1
基本事項
障害の発生時期
いつ（いつから）障害が発生したのかを確認してください。

2
障害発生の直前に実行した操作
どのような操作をしたときに障害が発生したのかを確認してください。

3
障害を検知したマシン
どのマシンで障害を検知したのかを確認してください。

HCSCサーバ稼働マシン

運用環境稼働マシン

サービスリクエスタ稼働マシン

サービス部品稼働マシン

データベース稼働マシン

4
障害内容
どのような現象が発生したのかを，具体的に挙げてください。

5
動作環境
uCosminexus Service Platformのバージョン
○
－
－
－
－

6
uCosminexus Service PlatformまたはuCosminexus OperatorとuCosminexus Operator for Service Platformのバージョン
－
○
－
－
－

7
J2EEサーバ製品名とバージョン
－
－
○
○
－

8
データベース製品名とバージョン
－
－
－
－
○

9
OSの種類とバージョン
○
○
○
○
○

10
プロセッサ数
○
○
○
○
○

11
メモリ
○
○
○
○
○

12
仮想メモリ
○
○
○
○
○

13
Javaバージョン
○
○
○
○
○

14
パッチの適用状況
○
○
○
○
○

15
再現性
再現性
再現性があるかどうかを確認してください。

16
発生頻度
再現性がある場合，どのくらいの頻度で障害が発生するかを確認してください。

17
構成変更
発生時の変更有無
該当する障害が発生するようになる前に，コーディングや環境などを変更したかどうかを確認してください。

18
変更個所の内容
変更した場合，変更内容を具体的に挙げてください。

（凡例）

○：確認が必要。

－：確認は不要。

(2)　収集する障害情報

Cosminexus サービスプラットフォームのシステムでは，調査に必要な資料として，障害の種別ごとに表7-2に示す情報が必要です。

なお，障害情報を取得するためには，あらかじめ設定が必要なものがあるため注意してください。障害情報の取得の詳細については「7.3　障害情報の取得」を参照してください。また，取得した障害情報が出力される場所については，「7.3　障害情報の取得」および「7.4　障害情報の種類」を参照してください。

障害情報の取得を設定していない情報については，障害調査や問い合わせのときに必要となる情報ではありませんが，障害調査の状況に応じて取得が必要になることがあります。障害調査に必要な情報は，障害の発生個所によって異なります。

Cosminexusが出力するログのディレクトリのデフォルトは，<Cosminexusのインストールディレクトリ>¥CC¥server¥public¥ejb¥<J2EEサーバ名>¥logsです。以降，「Cosminexusログ出力ディレクトリ」と表記します。

なお，Cosminexusが出力するログのディレクトリは，usrconf.cfg（J2EEサーバ用オプション定義ファイル）のejb.server.log.directoryキーで変更できます。

表7-2　障害調査のために取得している情報

項番 | 取得する情報 | 障害種別
ユーザプログラムがエラーメッセージや例外を出力している場合 | サービス部品呼び出し要求時の障害の場合 | オペレーション（コマンド操作や運用環境の画面からの操作）実行時の障害の場合
1 | Cosminexus サービスプラットフォームの資料 | メッセージログ | ○ | ○ | ○
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 | Cosminexusの資料 | J2EEサーバ，リダイレクタ，サーバ管理コマンドのログ | ○ | ○ | △
16 | 運用管理エージェント，運用監視エージェント，Management Serverのログ（統合ログ） | ○ | △ | ○
17 | Cosminexus DABroker Libraryのログ | △ | △ | △
18 | DB Connectorのログ（リソースアダプタの稼働ログ） | ○ | ○ | ○
19 | EJBクライアントアプリケーションのログ | ○ | ○ | －
20 | ユーザログ | ○ | △ | －
21 | 定義情報 | Cosminexus Component Containerの設定ファイル | △ | ○ | ○
22 | Cosminexus Managerの設定ファイル | △ | ○ | ○
23 | dbcon-xadisplaynameに設定したDB Connectorの属性情報 | △ | ○ | △
24 | dbcon-nodisplaynameに設定したDB Connectorの属性情報 | △ | △ | ○
25 | Cosminexus RMの資料 | 開始停止メッセージログ | － | △ | ○
26 | Cosminexus用メッセージログ | △ | ○ | ○
27 | メソッドトレース | △ | ○ | ○
28 | 回線トレース | △ | ○ | ○
29 | 定義情報 | Cosminexus RMコンフィグレーションプロパティの設定情報 | △ | ○ | ○
30 | SOAP通信基盤の資料 | トレース | △ | ○ | －
31 | アプリケーションログ | △ | ○ | －
32 | 定義情報 | 共通定義ファイル（SOAP通信基盤） | △ | ○ | －
33 | サーバ定義ファイル（SOAP通信基盤） | △ | ○ | －
34 | JAX-WSエンジンの資料 | トレース | △ | ○ | －
35 | アプリケーションログ | △ | ○ | －
36 | 定義情報 | 共通定義ファイル（JAX-WSエンジン） | △ | ○ | －
37 | Hitachi Web Serverのログおよびトレース | ○ | △ | －
38 | データベースの障害情報 | HiRDBを使用している場合 | HiRDBのログ（HiRDBの定義情報を含む） | － | △ | △
39 | HiRDBクライアントのログおよびトレース | － | △ | △
40 | HiRDB Type4 JDBCドライバのExceptionログおよびトレース | － | △ | △
41 | Oracleを使用している場合 | Oracleのログ | － | △ | △
42 | Oracle JDBC Thin Driverのログ | － | △ | △
43 | JavaVMの障害情報 | JavaVM出力メッセージログ | － | △ | △
44 | JavaVMのスレッドダンプ | － | △ | △
45 | JavaVMのガーベージコレクションのログ | － | △ | △

（凡例）

○：一次資料

△：二次資料

－：不要

7.2.2　システム管理者または保守員に連絡するときに必要な情報

障害発生時で次に示す場合は，システム管理者または保守員に連絡する必要があります。

出力されたエラーメッセージの対処に「保守員に連絡してください。」とある場合

調査しても障害の要因がわからない場合

エラーメッセージの内容や書かれている対処方法に従って対処しても解決できない場合

システム管理者または保守員に連絡するために必要な情報は，「7.2.1　障害を調査するときに必要な情報」で示す情報以外に，障害の種別ごとに表7-3に示す情報が必要です。障害情報の取得を設定していない情報については，障害調査や問い合わせのときに必要ではありませんが，障害調査の状況に応じて取得が必要になることがあります。システム管理者または保守員に連絡するために必要な情報は，障害の発生個所によって異なります。

Cosminexusが出力するログのディレクトリのデフォルトは，<Cosminexusインストールディレクトリ>¥CC¥server¥public¥ejb¥<J2EEサーバ名>¥logsです。以降，「Cosminexusログ出力ディレクトリ」と表記します。

なお，Cosminexusが出力するログのディレクトリは，usrconf.cfg（J2EEサーバ用オプション定義ファイル）のejb.server.log.directoryキーで変更できます。

表7-3　システム管理者または保守員に連絡するために必要な情報

項番 | 取得する情報 | 障害種別
ユーザプログラムがエラーメッセージや例外を出力している場合 | サービス部品呼び出し要求時の障害の場合 | オペレーション（コマンド操作や運用環境の画面からの操作）実行時の障害の場合
1 | Cosminexus サービスプラットフォームの資料 | 例外ログ | ○ | ○ | ○
2 | メンテナンスログ | － | － | ○
3 | インストールログ | － | － | ○
4 | メソッドトレース | ○ | ○ | ○
5 | 保守情報 | HCSCサーバリポジトリ情報 | － | ○ | ○
6 | HCSC-Managerの保守情報 | ○ | ○ | ○
7 | HCSCサーバ保持情報 | ○ | ○ | ○
8 | Cosminexusの資料 | 保守用ログ※1 | ○ | ○ | ○
9 | SOAP通信基盤の資料 | 保守用ログ※2 | ○ | ○ | ○
10 | JAX-WSエンジンの資料 | 保守用ログ※3 | ○ | ○ | ○
11 | JavaVMの障害情報 | メモリダンプ | ○ | ○ | ○

（凡例）

○：必要

－：不要

注※1　Cosminexusの保守用ログについては，マニュアル「Cosminexus アプリケーションサーバ 機能解説 保守／移行／互換編」を参照してください。

注※2　SOAP通信基盤の保守用ログは，<Cosminexusログ出力ディレクトリ>¥WS¥maintenanceに出力されます。このほか，マニュアル「Cosminexus アプリケーションサーバ SOAPアプリケーション開発の手引」の「14.2　障害発生時に取得する資料」を参照して，ログ以外の障害発生時に取得する情報を取得してください。

注※3　JAX-WSエンジンの保守用ログは，<Cosminexus作業ディレクトリ>¥ejb¥<サーバ名称>¥log¥CJW¥maintenanceに出力されます。このほか，マニュアル「Cosminexus アプリケーションサーバ Webサービス開発の手引」の「29.2　障害発生時に取得する資料」を参照して，ログ以外の障害発生時に取得する情報を取得してください。

7.3　障害情報の取得

＜この節の構成＞

7.3.1　Cosminexus サービスプラットフォームが出力するログやトレースの取得方法

7.3.2　Cosminexus サービスプラットフォーム以外の前提製品が出力する障害情報の取得方法

7.3.3　トレースファイルの見積もり

7.3.4　ログおよびトレース取得時の注意事項

7.3.1　Cosminexus サービスプラットフォームが出力するログやトレースの取得方法

Cosminexus サービスプラットフォームが出力するメッセージログ，トレース，および各種情報の取得方法について説明します。Cosminexus サービスプラットフォームが出力する障害情報の種類については，「7.4　障害情報の種類」を参照してください。

＜この項の構成＞

(1)　メッセージログの取得方法

(2)　リクエストトレースの取得方法

(3)　性能解析トレースの取得方法

(4)　ユーザ電文トレースの取得方法

(5)　そのほかの定義情報の取得方法

(6)　保守情報の取得方法

(1)　メッセージログの取得方法

メッセージログは必ず出力されます。

なお，メッセージログを出力するファイルのサイズ，および面数は，必要に応じて変更できます。メッセージログの詳細については，「7.4.1　メッセージログ」を参照してください。

(a)　HCSC-Managerのログ

HCSC-Manager定義ファイルで次のパラメタを指定します。

cscmng.log.message.filesize＝メッセージログファイルサイズ

cscmng.log.message.filenum＝メッセージログファイル面数

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

(b)　Cosminexusの統合メッセージログ

統合メッセージログは，manager.cfg（Managerログ設定ファイル）でファイルのサイズ，および面数を指定します。manager.cfgの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「10.10　manager.cfg（Manager設定ファイル）」を参照してください。

(c)　CosminexusのJ2EEサーバの稼働ログ

J2EEサーバの稼働ログは，usrconf.properties（J2EEサーバ用ユーザプロパティファイル）でファイルのサイズ，および面数を指定します。usrconf.propertiesの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.4　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」を参照してください。

(2)　リクエストトレースの取得方法

リクエストトレースを取得する際には，HCSCサーバランタイム定義ファイルの次のプロパティで採取の有無を指定します。

また，出力先パスやファイルのサイズ，およびファイル面数を変更できます。

requesttrace＝リクエストトレースの採取の有無（ONを指定します）

requesttrace-filepath＝リクエストトレースの出力先パス

requesttrace-filesize＝リクエストトレースファイルサイズ

requesttrace-filenum＝リクエストトレース面数

リクエストトレースの詳細については，「7.4.2　リクエストトレース」を参照してください。

(3)　性能解析トレースの取得方法

性能解析トレースファイルの取得方法および出力先は，Cosminexus全体で共通です。性能解析トレースの詳細については，「7.4.3　性能解析トレース」を参照してください。また，性能解析トレースファイルの取得方法および出力先については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 保守／移行／互換編」の「6.3　性能解析トレースファイル」を参照してください。

(4)　ユーザ電文トレースの取得方法

ユーザ電文トレースを取得する際には，HCSCサーバランタイム定義ファイルの次のプロパティで採取の有無を指定します。

telegramtrace＝ユーザ電文トレースの採取の有無（ONを指定します）

また，次のプロパティで，出力先パスやファイルのサイズ，およびファイル面数を変更できます。

telegramtrace-filepath＝ユーザ電文トレース出力先パス

telegramtrace-filesize＝ユーザ電文トレースファイルサイズ

telegramtrace-filenum＝ユーザ電文トレース面数

ユーザ電文トレースの詳細については，「7.4.4　ユーザ電文トレース」を参照してください。

(5)　そのほかの定義情報の取得方法

障害を調査するためにCosminexus サービスプラットフォームに設定した定義が必要になる場合があります。Cosminexus サービスプラットフォームの定義ファイルを次の表に示します。定義の詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「5.　定義ファイル」を参照してください。

表7-4　Cosminexus サービスプラットフォームの定義ファイル

定義ファイル | 説明
HCSCサーバ構成定義ファイル | HCSCサーバの環境作成で，HCSCサーバのセットアップコマンドに指定したファイル
HCSCサーバセットアップ定義ファイル
HCSCサーバランタイム定義ファイル | HCSCサーバランタイムの定義コマンドに指定したファイル
HCSC-Manager定義ファイル | <Cosminexusインストールディレクトリ>¥CSC¥config¥manager¥cscmng.propertiesに指定したファイル
HCSC-Managerコマンド共通定義ファイル | <Cosminexusインストールディレクトリ>¥CSC¥config¥manager¥csccmd.propertiesに指定したファイル
HCSC-Messagingコマンド共通定義ファイル | <Cosminexusインストールディレクトリ>¥CSC¥config¥msg¥cmdconf.batに指定したファイル
サービス情報変更定義ファイル | サービス情報の管理コマンドの-getfileパラメタに指定したファイル
ユーザ定義受付ランタイム定義ファイル | HCSCコンポーネントの定義コマンドの-propfileパラメタに指定したファイル
SOAP Fault動作定義ファイル | ランタイム定義ファイルのsoapfault-targetnamespace-filepathプロパティに指定したファイル
クライアント定義ファイル | サービスアダプタ（Webサービス）とサービスアダプタ（SessionBean）の開発時に指定したファイル

(6)　保守情報の取得方法

システム管理者または保守員に連絡するときに必要な保守情報の取得方法を説明します。保守用ログおよびトレースについては，「7.4.5　保守用ログおよびトレース」を参照してください。

(a)　例外ログ

例外ログは必ず出力されます。なお，出力されるファイルのサイズ，および面数は，変更できます。

HCSC-Managerの例外ログ
HCSC-Manager定義ファイルで次のパラメタを指定します。

cscmng.log.exception.filesize＝例外ログファイルサイズ

cscmng.log.exception.filenum＝例外ログファイル面数

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

Cosminexusの障害発生時の例外情報
J2EEサーバの例外ログは，usrconf.properties（J2EEサーバ用ユーザプロパティファイル）でファイルのサイズ，および面数を指定します。usrconf.propertiesの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.4　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」を参照してください。

(b)　メンテナンスログ

メンテナンスログは必ず出力されます。メンテナンスログは，出力されるファイルのサイズ，および面数を変更できます。

HCSC-Manager定義ファイルの次のパラメタを指定します。

cscmng.log.maintenance.filesize＝メンテナンスログファイルサイズ

cscmng.log.maintenance.filenum＝メンテナンスログファイル面数

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

(c)　インストールログ

必ず出力されます。

(d)　メソッドトレース

メソッドトレースは必ず出力されます。メソッドトレースは，出力される出力先やファイルのサイズ，面数，および出力レベルを決める必要があります。HCSCサーバランタイム定義ファイルの次のプロパティを指定します。

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

methodtrace-filepath＝メソッドトレースの出力先パス

methodtrace-filesize＝メソッドトレースファイルサイズ

methodtrace-filenum＝メソッドトレースファイル面数

methodtrace-level＝メソッドトレースの出力レベル

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

(e)　保守情報

障害を調査するために必要となる保守情報を次の表に示します。

表7-5　保守情報

保守情報 | 対象データの出力先
HCSCサーバリポジトリ情報 | <Cosminexusインストールディレクトリ>¥CSC¥repository配下のすべてのファイルおよびディレクトリ※1
HCSC-Managerの保守情報 | <Cosminexusインストールディレクトリ>¥CSC¥config¥manager配下のすべてのファイルおよびディレクトリ
HCSCサーバ保持情報 | <Cosminexusインストールディレクトリ>¥CSC¥spool配下のすべてのファイルおよびディレクトリ
<Cosminexusインストールディレクトリ>¥CSC¥system配下のすべてのファイルおよびディレクトリ
HCSCサーバセットアップ定義ファイルのhcscserver-data-filepathプロパティで指定したフォルダ配下のすべてのファイルおよびディレクトリ（hcscserver-data-filepathプロパティを指定しなかった場合は，<Cosminexusインストールディレクトリ>¥CSC¥spool¥msg¥配下のすべてのファイルおよびディレクトリ）※2

注※1　1台のマシンに複数の運用・実行環境を構築（環境変数CSCMNG_HOMEを設定）している場合は，%CSCMNG_HOME%¥repository配下のすべてのファイルおよびディレクトリになります。

注※2　データベースを使用しない構成でHCSCサーバをセットアップした場合に必要となります。

7.3.2　Cosminexus サービスプラットフォーム以外の前提製品が出力する障害情報の取得方法

主な前提製品の取得方法の概略を説明します。Cosminexus サービスプラットフォーム以外の前提製品が出力する障害情報の詳細については，各製品のマニュアルを参照してください。

Cosminexus サービスプラットフォーム以外の前提製品が出力する障害情報のうち，Cosminexusが出力するログのディレクトリのデフォルトは，<Cosminexusインストールディレクトリ>¥CC¥server¥public¥ejb¥<J2EEサーバ名>¥logsです。以降，「Cosminexusログ出力ディレクトリ」と表記します。なお，Cosminexusが出力するログのディレクトリは，usrconf.cfg（J2EEサーバ用オプション定義ファイル）のejb.server.log.directoryキーで変更できます。

＜この項の構成＞

(1)　Cosminexusが出力する障害情報の取得方法

(2)　Cosminexus RMが出力する障害情報の取得方法

(3)　SOAP通信基盤またはJAX-WSエンジンが出力する障害情報の取得方法

(4)　Hitachi Web Serverが出力する障害情報の取得方法

(5)　データベースが出力する障害情報の取得方法

(6)　JavaVMの情報の取得方法

(1)　Cosminexusが出力する障害情報の取得方法

(a)　ログ

障害が発生した際，Cosminexus サービスプラットフォームが出力するログやトレースで障害要因の特定が困難な場合は，次に示すCosminexusが出力する障害情報が必要になります。

J2EEサーバ，リダイレクタ，サーバ管理コマンドのログ

運用管理エージェント，運用監視エージェント，Management Serverのログ

Cosminexus DABroker Libraryのログ

DB Connectorのログ

EJBクライアントアプリケーションのログ

ユーザログ

保守用ログ

Cosminexusが出力する障害情報は，次のコマンドを使って一括して取得できます（手動で取得できます）。なお，一括して取得した場合，Cosminexus サービスプラットフォームが出力するログやトレースと一部重複する情報もあります。

snapshotlogコマンド

mngsvrutilコマンド（サブコマンドにcollect snapshotを指定）

snapshotlogコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「snapshotlog（snapshotログの収集）」を参照してください。mngsvrutilコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「mngsvrutil（Management Serverの運用管理コマンド）」を参照してください。また，Cosminexusが出力する障害情報の取得方法の詳細については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 保守／移行／互換編」を参照してください。

これらのコマンドを実行すると，次のディレクトリ下の情報を取得します。

<Cosminexusインストールディレクトリ>¥CC¥server¥public¥ejb¥*¥logs¥csc

<Cosminexusインストールディレクトリ>¥CC¥server¥public¥ejb¥*¥logs¥csc¥maintenance

<Cosminexusインストールディレクトリ>¥CSC¥config¥manager

<Cosminexusインストールディレクトリ>¥CSC¥config¥msg

<Cosminexusインストールディレクトリ>¥CSC¥log¥manager

<Cosminexusインストールディレクトリ>¥CSC¥repository

<Cosminexusインストールディレクトリ>¥CSC¥spool

<Cosminexusインストールディレクトリ>¥CSC¥system¥msg

なお，取得する情報はsnapshotログ収集対象定義ファイルで指定します。必要に応じてsnapshotログ収集対象定義ファイルを変更し，取得する情報を変更してください。snapshotログ収集対象定義ファイルの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「12.2　snapshotログ収集対象定義ファイル」を参照してください。

(b)　運用開始前に準備が必要なCosminexusの障害情報

コマンドを使って一括取得する場合，取得する障害情報の種類（Path）をあらかじめ定義しておく必要があります。メールなどで早急に送付する一次送付資料と，別途送付する二次送付資料のそれぞれを指定します。詳細は，マニュアル「Cosminexus アプリケーションサーバ 機能解説 保守／移行／互換編」の「2.4　取得が必要な資料の種類」を参照してください。

(c)　障害調査のために必要な設定情報

障害を調査するためにCosminexusに設定した定義が必要になる場合があります。Cosminexus サービスプラットフォーム以外の定義ファイルを次の表に示します。

表7-6　Cosminexus サービスプラットフォーム以外の定義ファイル

定義ファイル | 説明
Cosminexus Component Containerの設定ファイル※1 | <Cosminexusインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<J2EEサーバ名>¥ディレクトリ配下のすべてのファイルおよびディレクトリ
Cosminexus Managerの設定ファイル※1 | <Cosminexusインストールディレクトリ>¥manager¥config¥ディレクトリ配下のすべてのファイルおよびディレクトリ
dbcon-xadisplaynameに設定したDB Connectorの属性情報※2 | 「3.1.2(8)　DB Connectorのセットアップ」で設定した定義ファイル
dbcon-nodisplaynameに設定したDB Connectorの属性情報※2

注※1

定義の詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」を参照してください。

注※2

定義の詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1　Connector属性ファイル」を参照してください。

(2)　Cosminexus RMが出力する障害情報の取得方法

次に示す受付やサービスアダプタを使用している場合は，Cosminexus RMが出力する障害情報を取得することで障害要因の特定ができます。

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

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

サービスアダプタ（MDB（WS-R））

サービスアダプタ（MDB（DBキュー））

Cosminexus RMが出力する障害情報の取得方法の詳細については，マニュアル「Cosminexus Reliable Messaging」の「9.1　障害時の出力情報」を参照してください。

(a)　Cosminexus RMが出力するメッセージ

Cosminexus RMが出力するメッセージは，次のログに出力されます。ログには，開始停止メッセージログとCosminexus用メッセージログの2種類があります。Cosminexus RMが出力するメッセージを次の表に示します。

表7-7　Cosminexus RMが出力するメッセージ

定義ファイル
説明
ファイル名

開始停止メッセージログ
開始や停止についての情報，およびユーザが指定したプロパティの値。
<Cosminexusログ出力ディレクトリ>¥connectors¥
<Cosminexus RMの表示名><面番号>.log

Cosminexus用メッセージログ
Cosminexus RMの開始，停止および動作中の情報。
<Cosminexusログ出力ディレクトリ>
メッセージログは，Cosminexus サービスプラットフォームが出力するメッセージログと同一のファイルに出力されます。

(b)　HCSCサーバとCosminexus RMのトレースとの関係

HCSCサーバとCosminexus RMのトレースとの関係は，ローカルキューや転送キューを使用する場合と，共用キューを使用する場合とで異なります。

ローカルキューや転送キューを使用する場合
Cosminexus RMのトレースには，メソッドトレースと回線トレースの2種類があります。メソッドトレースは，エラー情報（例外発生原因）およびメソッドの入口情報，出口情報，デバッグ情報を出力します。回線トレースは，キュー間転送でやり取りされる電文の情報を出力します。ローカルキューや転送キューを使用する場合のトレース取得ポイントを次の図に示します。

図7-2　ローカルキューや転送キューを使用する場合のトレース取得ポイント

トレース取得ポイントとファイル名の関係を次の表に示します。表の「図中の番号」は，図7-2中の番号と対応しています。

表7-8　トレース取得ポイントとファイル名の関係

図中の番号 | 取得ポイント | トレース
種類 | 出力マシン | 出力先 | ファイル名
1 | サービスリクエスタから転送キューに要求を出すとき | メソッドトレース | サービスリクエスタ稼働マシン側 | <Cosminexusログ出力ディレクトリ>¥RM¥maintenance | mtd_<サービスリクエスタ側Cosminexus RMのディスプレイ名>_<数字>.log
2 | サービスリクエスタ側の転送キューからHCSCサーバ側のローカルキューに転送するとき | 回線トレース | <Cosminexusログ出力ディレクトリ>¥RM¥maintenance | lin_<サービスリクエスタ側Cosminexus RMのディスプレイ名>_<数字>.log
3 | サービスリクエスタ側の転送キューからHCSCサーバ側のローカルキューへの転送を受け取るとき，またはHCSCサーバ側の転送キューからサービス部品側のローカルキューに転送するとき | 回線トレース | HCSCサーバ稼働マシン側 | <Cosminexusログ出力ディレクトリ>¥RM¥maintenance | lin_<HCSCサーバ側Cosminexus RMのディスプレイ名>_<数字>.log
4 | HCSCサーバがローカルキューからメッセージを取り出すとき，またはサービスアダプタから転送キューに要求を出すとき | メソッドトレース | <Cosminexusログ出力ディレクトリ>¥RM¥maintenance | mtd_<HCSCサーバ側Cosminexus RMのディスプレイ名>_<数字>.log
5 | HCSCサーバ側の転送キューからサービス部品側のローカルキューへの転送を受け取るとき | 回線トレース | サービス部品稼働マシン側 | <Cosminexusログ出力ディレクトリ>¥RM¥maintenance | lin_<サービス部品側Cosminexus RMのディスプレイ名>_<数字>.log
6 | サービス部品がローカルキューからメッセージを取り出すとき | メソッドトレース | <Cosminexusログ出力ディレクトリ>¥RM¥maintenance | mtd_<サービス部品側Cosminexus RMのディスプレイ名>_<数字>.log

共用キューを使用する場合
Cosminexus RMのトレースには，メソッドトレースと共用キューイベントトレースの2種類があります。メソッドトレースは，エラー情報（例外発生原因）およびメソッドの入口情報，出口情報，デバッグ情報を出力します。共用キューイベントトレースは，共用キューにメッセージが格納されたことを表すイベントの情報を出力します。共用キューを使用する場合のトレース取得ポイントを次の図に示します。

図7-3　共用キューを使用する場合のトレース取得ポイント

トレース取得ポイントとファイル名の関係を次の表に示します。表の「図中の番号」は，図7-3中の番号と対応しています。

表7-9　トレース取得ポイントとファイル名の関係

図中の番号 | 取得ポイント | トレース
種類 | 出力マシン | 出力先 | ファイル名
1 | サービスリクエスタ側からHCSCサーバ側の受信用共用キューへメッセージが格納されたとき，またはHCSCサーバのサービスアダプタから送信用共用キューへメッセージが格納されたとき | 共用キューイベントトレース | HCSCサーバ稼働マシン側 | <Cosminexusログ出力ディレクトリ>¥RM¥maintenance | shq_<HCSCサーバ側Cosminexus RMのディスプレイ名>_<数字>.log
2 | HCSCサーバがローカルキューからメッセージを取り出すとき，またはサービスアダプタから転送キューに要求を出すとき | メソッドトレース | <Cosminexusログ出力ディレクトリ>¥RM¥maintenance | mtd_<HCSCサーバ側Cosminexus RMのディスプレイ名>_<数字>.log

(c)　運用開始前に準備が必要なRMのトレース

メソッドトレースや回線トレースの出力レベルを変更して，出力する情報の種類を変更する場合は，HCSCサーバ起動前のCosminexus RMの設定で変更する必要があります。Cosminexus RMのコンフィグレーションプロパティのRMMethodTraceLevelおよびRMLineTraceLevelで変更します。

(d)　障害調査のために必要な設定情報

障害を調査するためにCosminexus RMのコンフィグレーションプロパティに対して設定している情報が必要になる場合があります。障害調査に必要なCosminexus RMの定義ファイルを次の表に示します。定義ファイルの詳細については，マニュアル「Cosminexus Reliable Messaging」の「6.　コンフィグレーションプロパティ」を参照してください。

表7-10　障害調査に必要なCosminexus RMの定義ファイル

定義ファイル | 説明
Cosminexus RMコンフィグレーションプロパティの設定情報 | 「3.1.2(9) Cosminexus Reliable Messagingのセットアップ」で設定した定義ファイル

(3)　SOAP通信基盤またはJAX-WSエンジンが出力する障害情報の取得方法

同期（Webサービス）の標準受付，またはサービスアダプタ（Webサービス）を使用している場合は，SOAP通信基盤またはJAX-WSエンジンが出力する障害情報を取得することで障害要因を特定できます。また，サービスリクエスタからHCSCサーバを呼び出すときのSOAPメッセージや，HCSCサーバのサービスアダプタからサービス部品を呼び出すときのSOAPメッセージの電文形式を確認することで，送受信するユーザ電文に誤りがある場合の障害要因を特定できます。

SOAP通信基盤が出力する障害情報の取得方法の詳細については，マニュアル「Cosminexus アプリケーションサーバ SOAPアプリケーション開発の手引」の「14.　障害対策」を参照してください。

JAX-WSエンジンが出力する障害情報の取得方法の詳細については，マニュアル「Cosminexus アプリケーションサーバ Webサービス開発の手引」の「29.　障害対策」を参照してください。

(a)　HCSCサーバとSOAPのトレースやアプリケーションログの関係

HCSCサーバの構成で，取得ポイントとSOAPのトレースやアプリケーションログのファイル名との関係を説明します。Webサービスの受付からサービスアダプタ（Webサービス）を呼び出す場合と，Webサービス以外の受付からサービスアダプタ（Webサービス）を呼び出す場合とで異なります。

同期（Webサービス）の標準受付またはユーザ定義受付（Webサービス）からサービスアダプタ（Webサービス）を呼び出す場合
同期（Webサービス）の標準受付からサービスアダプタ（Webサービス）を呼び出す場合や，ユーザ定義受付（Webサービス）からサービスアダプタ（Webサービス）を呼び出す場合は，次のような名称でSOAPのトレースやアプリケーションログが出力されます。途中にビジネスプロセスを経由している場合も同様の名称で出力されます。SOAPトレースやアプリケーションログの取得ポイントを次の図に示します。

図7-4　SOAPトレースやアプリケーションログの取得ポイント（Webサービスの受付からサービスアダプタ（Webサービス）を呼び出す場合）

トレース取得ポイントとファイル名の関係を次の表に示します。表の「図中の番号」は，図7-4中の番号と対応しています。

表7-11　トレース取得ポイントとファイル名の関係（Webサービスの受付からサービスアダプタ（Webサービス）を呼び出す場合）

図中の番号
取得ポイント
ファイル名

トレース※1
アプリケーションログ※1

1※2
サービスリクエスタから要求を出したとき（送信），およびサービスリクエスタへ応答が返ってきたとき（受信）のSOAP通信のトレース

SOAP通信基盤を使用している場合

サービスリクエスタ側のクライアント定義ファイルで設定※3した名称。

「<上記名称>-j2ee-<J2EEサーバ名>-<数字>.log」

JAX-WSエンジンを使用している場合

「cjwmessage<数字>.log」

SOAP通信基盤を使用している場合

サービスリクエスタ側のクライアント定義ファイル※3で設定した名称。

「<上記名称>-j2ee-<J2EEサーバ名>-aplog-<数字>.log」

JAX-WSエンジンを使用している場合

「cjwtransport<数字>.log」

2
サービスリクエスタから要求をHCSCサーバのリクエスト受付で受け取ったとき（受信），およびHCSCサーバから応答を返したとき（送信）のSOAP通信のトレース

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

「<クラスタ名>-j2ee-<J2EEサーバ名>-<数字>.log」

ユーザ定義受付（Webサービス）の場合

「<受付ID>-j2ee-<J2EEサーバ名>-<数字>.log」

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

「<クラスタ名>-j2ee-<J2EEサーバ名>-aplog-<数字>.log」

ユーザ定義受付（Webサービス）の場合

「<受付ID>-j2ee-<J2EEサーバ名>-aplog-<数字>.log」

3
HCSCサーバのサービスアダプタから要求を出したとき（送信），およびサービスアダプタへ応答が返ってきたとき（受信）のSOAP通信のトレース
図中の番号2と同じトレースファイルに出力します。
図中の番号2と同じアプリケーションログファイルに出力します。

4※2
HCSCサーバのサービスアダプタからの要求をサービス部品側で受け取ったとき（受信），およびサービス部品側から応答を返したとき（送信）のSOAP通信のトレース

SOAP通信基盤を使用している場合

サービス部品側のサーバ定義ファイルで設定※3した名称。

「<上記名称>-j2ee-<J2EEサーバ名>-<数字>.log」

JAX-WSエンジンを使用している場合

「cjwmessage<数字>.log」

SOAP通信基盤を使用している場合

サービス部品側のサーバ定義ファイルで設定※3した名称。

「<上記名称>-j2ee-<J2EEサーバ名>-aplog-<数字>.log」

JAX-WSエンジンを使用している場合

「cjwmessage<数字>.log」

注※1

トレースおよびアプリケーションログの出力先は，使用している通信基盤によって次のように異なります。

SOAP通信基盤を使用している場合

　各稼働マシン上の <Cosminexusログ出力ディレクトリ>¥WS

JAX-WSエンジンを使用している場合

　各稼働マシン上の <Cosminexusログ出力ディレクトリ>¥CJW

注※2

サービスリクエスタ側稼働マシン，またはサービス部品稼働マシンでCosminexusが提供しているSOAP通信基盤またはJAX-WSエンジンを使用している場合に取得できます。

注※3

サーバ定義ファイル（c4websv.cfg），またはクライアント定義ファイル（c4webcl.properties）でトレースファイルやアプリケーションログのプレフィクス（c4web.logger.<識別子>.log_file_prefix）に設定した名称です。

Webサービス以外の受付からサービスアダプタ（Webサービス）を呼び出す場合
同期（Webサービス）の標準受付やユーザ定義受付（Webサービス）以外のリクエスト受付からサービスアダプタ（Webサービス）を呼び出す場合は，次のような名称でSOAPトレースやアプリケーションログが出力されます。SOAPトレースやアプリケーションログの取得ポイントを次の図に示します。

図7-5　SOAPトレースやアプリケーションログの取得ポイント（Webサービス以外の受付からサービスアダプタ（Webサービス）を呼び出す場合）

トレース取得ポイントとファイル名の関係を次の表に示します。表の「図中の番号」は，図7-5中の番号と対応しています。

表7-12　トレース取得ポイントとファイル名の関係（Webサービス以外の受付からサービスアダプタ（Webサービス）を呼び出す場合）

図中の番号
取得ポイント
ファイル名

トレース※1
アプリケーションログ※1

1
HCSCサーバのサービスアダプタから要求を出したとき（送信），およびサービスアダプタへ応答が返ってきたとき（受信）のSOAP通信のトレース
「<サービスID>-j2ee-<J2EEサーバ名>-<数字>.log」※3
「<サービスID>-j2ee-<J2EEサーバ名>-aplog-<数字>.log」※3

2※2
HCSCサーバのサービスアダプタからの要求をサービス部品側で受け取ったとき（受信），およびサービス部品側から応答を返したとき（送信）のSOAP通信のトレース

SOAP通信基盤を使用している場合

サービス部品側のサーバ定義ファイルで設定※3した名称。

「<上記名称>-j2ee-<J2EEサーバ名>-<数字>.log」

JAX-WSエンジンを使用している場合

「cjwmessage<数字>.log」

SOAP通信基盤を使用している場合

サービス部品側のサーバ定義ファイルで設定※4した名称。

「<上記名称>-j2ee-<J2EEサーバ名>-aplog-<数字>.log」

JAX-WSエンジンを使用している場合

「cjwtransport<数字>.log」

注※1

トレースおよびアプリケーションログの出力先は，使用している通信基盤によって次のように異なります。

SOAP通信基盤を使用している場合

　各稼働マシン上の <Cosminexusログ出力ディレクトリ>¥WS

JAX-WSエンジンを使用している場合

　各稼働マシン上の <Cosminexusログ出力ディレクトリ>¥CJW

注※2

サービス部品稼働マシンでCosminexusが提供しているSOAP通信基盤またはJAX-WSエンジンを使用している場合に取得できます。

注※3

サービスアダプタ定義画面で設定したクライアント定義ファイルにトレースファイル，アプリケーションログのプレフィクスを指定していても，その値は有効になりません。サービスIDが一意なプレフィクスとして割り当てられます。

注※4

サーバ定義ファイル（c4websv.cfg）でトレースファイルやアプリケーションログのプレフィクス（c4web.logger.<識別子>.log_file_prefix）に設定した名称です。

(b)　運用開始前に準備が必要なSOAPのトレースやアプリケーションログ

SOAPメッセージのログを取得する場合，サービスリクエスタからHCSCサーバを呼び出すときのSOAPメッセージや，HCSCサーバのサービスアダプタからサービス部品を呼び出すときのSOAPメッセージの電文形式を確認することで，送受信するユーザ電文に誤りがある場合の障害要因を特定できます。HCSCサーバが稼働するマシンの共通定義ファイル（SOAP通信基盤の場合はc4webcom.cfg，JAX-WSエンジンの場合はcjwconf.properties）に設定します。HCSCサーバが稼働するマシンの共通定義ファイルへの設定を次の表に示します。

表7-13　HCSCサーバが稼働するマシンの共通定義ファイルへの設定

設定項目
キー名称
設定値
（デフォルト）
説明

アプリケーションログ出力の重要度
c4web.logger.aplog_level
WARN
SOAPメッセージのログを採取する（SOAPメッセージの電文形式を確認する）場合，INFOを指定してください。HCSCサーバ起動前にあらかじめ設定する必要があります。

SOAP通信基盤を利用する場合の共通定義ファイルの作成については，マニュアル「Cosminexus アプリケーションサーバ SOAPアプリケーション開発の手引」の「10.4　共通定義ファイルの設定」を参照してください。

JAX-WSエンジンを利用する場合の共通定義ファイルの作成については，マニュアル「Cosminexus アプリケーションサーバ Webサービス開発の手引」の「10.1.2　共通定義ファイルの設定項目」を参照してください。

(c)　障害調査のために必要な設定情報

障害を調査するためにSOAP通信基盤およびJAX-WSエンジンの設定情報が必要になる場合があります。SOAP通信基盤の定義ファイルを次の表に示します。

表7-14　SOAP通信基盤の定義ファイル

定義ファイル
説明
ファイルの格納場所
ファイル名

サーバ定義ファイル
HCSCサーバ稼働マシンのリクエスト受付でのSOAP通信の動作を制御します
HCSCサーバ稼働マシンの次のフォルダ

Windowsの場合

<Cosminexusインストールディレクトリ>¥c4web¥conf

その他のOSの場合

/opt/Cosminexus/c4web/conf

c4websv.cfg

共通定義ファイル
HCSCサーバ稼働マシンのリクエスト受付およびサービスアダプタに共通のSOAP通信の動作を制御します
HCSCサーバ稼働マシンの次のフォルダ

Windowsの場合

<Cosminexusインストールディレクトリ>¥c4web¥conf

その他のOSの場合

/opt/Cosminexus/c4web/conf

c4webcom.cfg

SOAP通信基盤を利用する場合のサーバ定義ファイルの詳細については，マニュアル「Cosminexus アプリケーションサーバ SOAPアプリケーション開発の手引」の「10.2　サーバ定義ファイルの設定」を参照してください。SOAP通信基盤を利用する場合の共通定義ファイルの詳細については，マニュアル「Cosminexus アプリケーションサーバ SOAPアプリケーション開発の手引」の「10.4　共通定義ファイルの設定」を参照してください。

JAX-WSエンジンの定義ファイルを次の表に示します。

表7-15　JAX-WSエンジンの定義ファイル

定義ファイル
説明
ファイルの格納場所
ファイル名

共通定義ファイル
HCSCサーバ稼働マシンのリクエスト受付およびサービスアダプタに共通のSOAP通信の動作を制御します
HCSCサーバ稼働マシンの次のフォルダ

Windowsの場合

<Cosminexusのインストールフォルダ>¥jaxws¥conf

その他のOSの場合

/opt/Cosminexus/jaxws/conf

cjwconf.properties

JAX-WSエンジンを利用する場合の定義ファイルの詳細については，マニュアル「Cosminexus アプリケーションサーバ Webサービス開発の手引」の「10.1　動作定義ファイル」を参照してください。

(4)　Hitachi Web Serverが出力する障害情報の取得方法

Hitachi Web Serverを使用して運用する場合，Hitachi Web Serverが出力する障害情報が必要な場合があります。Hitachi Web Serverが出力する障害情報の取得方法の詳細は，マニュアル「Hitachi Web Server」を参照してください。

(5)　データベースが出力する障害情報の取得方法

障害の要因がデータベースにある場合，データベースの障害情報を確認することで，障害要因を特定できます。データベースの障害情報には，サーバ側とクライアント側の情報があります。HCSCサーバ稼働マシンのデータベース（クライアント側）とデータベース（サーバ側）の関係を次の図に示します。

図7-6　HCSCサーバ稼働マシンのデータベース（クライアント側）とデータベース（サーバ側）の関係

表7-16　データベースのサーバ側とクライアント側の障害情報

使用しているデータベース
サーバ/クライアント
障害情報
備考

HiRDBを使用している場合
サーバ側の障害情報

HiRDBのログ

%PDDIR%¥SPOOL 配下のファイルすべて

－

サーバ側の障害情報（定義情報）

HiRDBの定義情報

%PDCONFPATH% 配下のファイルすべて

－

クライアント側の障害情報

HiRDBクライアントのSQLトレースファイルおよびエラーログファイル
環境変数PDCLTPATHで指定したディレクトリ（環境変数PDCLTPATHを省略した場合は，次のディレクトリに出力されます。
%PDDIR%¥spool¥hubspool¥外部サーバ名¥）

HiRDBクライアントのSQLトレース環境変数PDSQLTRACEで指定したファイルサイズ（環境変数PDCLTPATHを省略した場合は，SQLトレースは出力されません）

HiRDB Type4 JDBCドライバのExceptionトレースログ
環境変数PDJDBFILEDIRで指定したディレクトリ（環境変数PDJDBFILEDIRを省略した場合は，次のディレクトリに出力されます。
<Cosminexusインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<J2EEサーバ名>¥<J2EEサーバ名>excX.trc）

HiRDB Type4 JDBCドライバの場合，OSの環境変数やHiRDB.iniに記載しても有効になりません。使用するDB Connectorの属性定義EnvironmentVariablesに次に示すようにセミコロンでつないで指定してください。
（例）

PDSQLTRACE=0;PDCLTPATH=c:¥tmp

Exceptionトレースログについては，DABrokerを使用している場合は取得されません。

Oracleを使用している場合
サーバ側の障害情報
Oracleのログ
－

クライアント側の障害情報
Oracle JDBC Thin Driverのログ
－

（凡例）

－：該当しません。

HiRDBを使用する場合は，マニュアル「HiRDB システム運用ガイド」を参照してください。Oracleを使用する場合は，Oracle Corporationが発行するドキュメントを参照してください。

(6)　JavaVMの情報の取得方法

(a)　JavaVM出力メッセージログ

JavaVMでクラッシュが発生した場合，JavaVMはデバッグ情報を標準出力とエラーリポートファイルに出力します。詳細については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 保守／移行／互換編」の「4.11　JavaVM出力メッセージログ（標準出力またはエラーリポートファイル）」を参照してください。エラーリポートファイルの出力先および出力ファイル名は次のとおりです。

Windowsの場合

<Cosminexusインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<J2EEサーバ名>¥hs_err_pid<サーバプロセスのプロセスID>.log

UNIXの場合

<Cosminexusインストールディレクトリ>/CC/server/usrconf/ejb/<J2EEサーバ名>/hs_err_pid<サーバプロセスのプロセスID>.log

(b)　JavaVMのスレッドダンプ

JavaVMの稼働情報やスレッドのスタック状態が出力されます。詳細については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 保守／移行／互換編」の「4.7　JavaVMのスレッドダンプ」を参照してください。出力先は次のとおりです。

Windowsの場合

<Cosminexusインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<J2EEサーバ名>¥javacore*.txt

UNIXの場合

<Cosminexusインストールディレクトリ>/CC/server/usrconf/ejb/<J2EEサーバ名>/javacore*.txt

(c)　JavaVMのガーベージコレクションログ

JavaVMのガーベージコレクションの活動状態が出力されます。詳細については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 保守／移行／互換編」の「4.8　JavaVMのガーベージコレクションログ」を参照してください。

(d)　メモリダンプ

システムで障害が発生したときに，システム管理者または保守員が障害を解析するために使用します。詳細については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 保守／移行／互換編」の「4.9　メモリダンプ」を参照してください。

7.3.3　トレースファイルの見積もり

トレースファイルは，次に示すような電文の件数，およびトレースを保管する日数を基に，総ファイルサイズを算出します。

1日当たりに受信する電文（単位：件）

トレース情報を保存する期間（単位：日）

算出した総ファイルサイズから，トレースファイルサイズやトレース面数を見積もります。トレースファイルサイズやトレース面数はHCSCサーバランタイム定義ファイルで設定します。HCSCサーバランタイム定義ファイルの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「HCSCサーバランタイム定義ファイル」を参照してください。なお，関連する前提製品の各マニュアルを参照して，見積もりをしてください。

7.3.4　ログおよびトレース取得時の注意事項

性能解析トレース以外のすべてのログ，トレースでは，次に示す禁止事項および注意事項があります。

＜この項の構成＞

(1)　注意事項

(2)　HCSC-Managerのログにおける注意事項

(1)　注意事項

ファイルの編集はできません。

テキストビューワやエディタに，ロックするオプションがある場合は，使用できません。ファイルをロックした場合，トレースが出力されなくなる可能性があります。

ファイルのアクセス権限は変更できません。
手動でアクセス権限を設定する必要がある場合には，適切なアクセス権限を設定してください。適切なアクセス権限が与えられていない場合，トレースを出力できなくなります。

ファイルの更新時刻は変更できません。
ファイルの更新時刻を変更した場合，出力先ファイルが変わる可能性があります。

トレース出力中に，ファイルを名称変更したり，削除したりしないでください。
管理ファイルの情報を基に出力先ファイルを決められますが，管理ファイルがない場合，および管理ファイルが破壊されている場合には，ファイルの更新時刻を基に判定されます。ファイルの名称変更，または削除は，すべてのトレース出力プロセスを停止してから実行してください。

(2)　HCSC-Managerのログにおける注意事項

メッセージ末尾の改行コードは，プラットフォームに関係なく「CR+LF」になります。

例外ログ，およびメンテナンスログの場合は，さらに次に示す注意事項があります。

ファイルサイズ/面数/モードオプションの変更を有効にするためには，ファイルの削除が必要な場合があります。ファイルを削除する場合には，トレース出力プロセスを停止してください。

出力したトレースファイルは，最初のEOF文字（0x1A）が現れるまでが有効なデータです。EOF文字以降のデータについては，一切保証されません。最初のEOF文字以降にもEOF文字が現れる可能性があるため，注意が必要です。

トレースを出力してもファイルの更新時刻の更新は保証されません。ファイルの更新時刻を基に，トレースが出力されたかどうかを判定できません。トレース出力終了時にはファイルの更新時刻が更新されます。

7.4　障害情報の種類

運用時に障害が発生した場合は，障害対策に必要な情報が，ログとしてログファイルに出力されたり，トレースとしてトレースファイルに出力されたりします。ここではHCSCサーバやHCSC-ManagerなどのCosminexus サービスプラットフォームが出力するログやトレースの種類について説明します。

＜この節の構成＞

7.4.1　メッセージログ

7.4.2　リクエストトレース

7.4.3　性能解析トレース

7.4.4　ユーザ電文トレース

7.4.5　保守用ログおよびトレース

7.4.1　メッセージログ

HCSCサーバを操作するときのインフォメーション情報や障害時のエラー情報，および稼働中のHCSCサーバのインフォメーション情報や障害時のエラー情報をメッセージログとして取得します。これによって，障害の発生を検知したり，障害要因を解析したりできます。

Cosminexus サービスプラットフォームのメッセージログは，次に示すログに出力されます。

HCSC-Managerのログ

Cosminexusの統合メッセージログ

CosminexusのJ2EEサーバの稼働ログ

＜この項の構成＞

(1)　メッセージログで出力される内容

(2)　メッセージログの取得方法

(3)　メッセージログの出力先

(1)　メッセージログで出力される内容

次に示すメッセージを出力します。メッセージログの内容の詳細については，マニュアル「Cosminexus サービスプラットフォーム メッセージ」を参照してください。

(a)　HCSC-Managerのログ

HCSC-Managerが出力するメッセージを取得します。

(b)　Cosminexusの統合メッセージログ

運用管理エージェント，運用監視エージェント，およびManagement Serverなどが出力するメッセージ取得します。

(c)　CosminexusのJ2EEサーバの稼働ログ

稼働しているJ2EEサーバが出力するメッセージ取得します。J2EEサーバ上で稼働しているHCSCサーバが出力するメッセージもこのログに出力します。

(2)　メッセージログの取得方法

メッセージログは必ず出力されます。詳細については，「7.3.1　Cosminexus サービスプラットフォームが出力するログやトレースの取得方法」を参照してください。

(3)　メッセージログの出力先

メッセージログの出力先およびログファイル名を次の表に示します。

表7-17　メッセージログの出力先およびファイル名

メッセージログファイルの出力先パス | ログファイル名
HCSC-Manager定義ファイルのcscmng.log.dirパラメタで指定したパス※1 | message<面数>.log
Cosminexusの統合メッセージログの出力先に指定されたパス※2 | mngmessage<面数>.log
CosminexusのJ2EEサーバの稼働ログの出力先に指定されたパス※3 | cjmessage<面数>.log

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

注※2　Cosminexusの統合メッセージログの出力先は，manager.cfg（Managerログ設定ファイル）で指定します。デフォルト値は，次に示すとおりです。

<Cosminexusインストールディレクトリ>¥manager¥log

manager.cfgの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「10.10　manager.cfg（Manager設定ファイル）」を参照してください。

注※3　CosminexusのJ2EEサーバの稼働ログの出力先は，usrconf.cfg（J2EEサーバ用オプション定義ファイル）のejb.server.log.directoryキーで指定します。デフォルトの出力先は，<Cosminexusのインストールディレクトリ>¥CC¥server¥public¥ejb¥<J2EEサーバ名>¥logsです。usrconf.cfgの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.3　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。

7.4.2　リクエストトレース

HCSCサーバのメッセージング基盤では，次の内容をリクエストトレースとして取得できます。

リクエスト受付で受け付けたサービス部品呼び出し要求または応答の結果

ビジネスプロセスを呼び出した時の要求または応答の結果

サービスアダプタからサービス部品を呼び出したときの要求または応答の結果

リクエストトレースは，リクエストの障害要因の解析に使用します。

＜この項の構成＞

(1)　リクエストトレースの出力形式と出力される内容

(2)　リクエストトレースの取得ポイント

(3)　リクエストトレースの取得方法

(4)　リクエストトレースの出力先

(1)　リクエストトレースの出力形式と出力される内容

(a)　出力形式

リクエストトレースの出力形式を次の図に示します。

図7-7　リクエストトレースの出力形式

(b)　出力される内容

リクエストトレースに出力される内容を次の表に示します。

表7-18　リクエストトレースに出力される内容

項目
内容

番号
トレースレコードの出力通番が表示されます。

日付
トレースレコードの取得日付（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：カスタムアダプタ，ユーザ定義受付（カスタム受付），ユーザ定義受付（TP1/RPC受付）

詳細位置
トレースの取得ポイント情報（詳細位置）が出力されます。

IN：受付

OUT：応答

CAL：呼び出し（他コンポーネント）

RET：応答受信（他コンポーネント）

WRN：例外

名称
トレースの取得ポイント情報（名称）が出力されます。ただし，取得位置がRCP，URCP，BPREQ，またはSVRCVの場合は表示されません。

サーバ名

サービスアダプタのサービスID

ビジネスプロセスのサービスID

サービスグループ名

アダプタ種別
トレースの取得ポイント情報（アダプタ種別）が出力されます。ただし，取得位置がRCP，URCP，BPRCP，SVCGP，SVSND，またはSVRCVの場合は表示されません。

SVA：サービスアダプタ

BP ：ビジネスプロセス

結果
応答結果種別が出力されます。ただし，詳細位置がINまたはCALの場合は，表示されません。

正常終了：NORMAL

異常終了：ERROR

付加情報
応答結果の付加情報が出力されます。

CRLF
レコード終端符号が出力されます。

(2)　リクエストトレースの取得ポイント

リクエストトレースの取得ポイントには，次に示す場合があり，それぞれで取得ポイントが異なります。

単体サービス実行時

ビジネスプロセスサービス実行時

稼働状態確認実行時

(a)　単体サービス実行時

単体サービス実行時のリクエストトレースのトレース取得ポイントを次の図に示します。

図7-8　リクエストトレースの取得ポイント（単体サービス実行時）

トレース取得ポイントを次の表に示します。表の「図中の番号」は，図7-8中の番号と対応しています。

表7-19　リクエストトレース取得ポイント（単体サービス実行時）

図中の番号 | トレース取得ポイント
1 | 標準受付（Webサービス）の入口
2 | 標準受付（Webサービス）の出口
1 | 標準受付（SessionBean）の入口
2 | 標準受付（SessionBean）の出口
1 | 標準受付（MDB（WS-R））の入口
2 | 標準受付（MDB（WS-R））の出口
1 | 標準受付（MDB（DBキュー））の入口
2 | 標準受付（MDB（DBキュー））の出口
3 | サービスアダプタ（Webサービス）のサービス部品呼び出し口
4 | サービスアダプタ（Webサービス）のサービス部品応答受信口
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-20　リクエストトレース取得ポイント（ビジネスプロセスサービス実行時）

図中の番号 | トレース取得ポイント
1 | 標準受付（Webサービス）の入口
2 | 標準受付（Webサービス）の出口
1 | 標準受付（SessionBean）の入口
2 | 標準受付（SessionBean）の出口
1 | 標準受付（MDB（WS-R））の入口
2 | 標準受付（MDB（WS-R））の出口
1 | 標準受付（MDB（DBキュー））の入口
2 | 標準受付（MDB（DBキュー））の出口
7 | サービスアダプタ（Webサービス）のサービス部品呼び出し口
8 | サービスアダプタ（Webサービス）のサービス部品応答受信口
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-21　リクエストトレース取得ポイント（稼働状態確認実行時）

図中の番号 | トレース取得ポイント
1 | 標準受付（Webサービス）の入口
2 | 標準受付（Webサービス）の出口

(3)　リクエストトレースの取得方法

リクエストトレースを取得するには設定が必要です。詳細については「7.3.1 Cosminexus サービスプラットフォームが出力するログやトレースの取得方法」を参照してください。

(4)　リクエストトレースの出力先

リクエストトレースの出力先およびトレースファイル名を次の表に示します。

表7-22　リクエストトレースの出力先およびファイル名

トレースファイルの出力先パス | トレースファイル名
HCSCサーバランタイム定義ファイルのrequesttrace-filepathプロパティで指定したパス | cscmsgreq_<HCSCサーバ名>_<面数>.log

なお，指定したパスが存在しない場合，またはパスが誤っていた場合は，省略値の出力先にトレースが出力されます。

7.4.3　性能解析トレース

性能解析トレース（PRFトレース）は，Cosminexusシステムの性能解析をするためのトレース情報で，それをCSV形式で編集出力したテキストファイルが性能解析トレースファイルです。性能解析トレースは，J2EEアプリケーションを含めた，システム全体の性能ボトルネックを解析するための情報が出力されます。システムの性能ネックや性能トラブルシュートに使用します。性能解析トレース機能については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 保守／移行／互換編」の「6.　性能解析トレースを使用したシステムの性能解析」を参照してください。

＜この項の構成＞

(1)　性能解析トレースファイルの出力形式と出力される内容

(2)　性能解析トレースの取得ポイント

(3)　性能解析トレースの取得方法と出力先

(1)　性能解析トレースファイルの出力形式と出力される内容

(a)　出力形式

性能解析トレースファイルに出力される形式は，Cosminexusの性能解析トレースと同様です。性能解析トレースファイルの詳細については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 保守／移行／互換編」の「6.3　性能解析トレースファイル」を参照してください。

(b)　出力される内容

HCSCサーバ（メッセージング基盤）の場合

性能解析トレースファイルに出力される内容を次の表に示します。

表7-23　性能解析トレースファイルに出力される内容（メッセージング基盤）

項目
内容

イベントID
取得ポイントのイベントIDが出力されます。
詳細については，次の個所を参照してください。

「表7-27　性能解析トレース取得ポイント（単体サービス実行時）」

「表7-28　性能解析トレース取得ポイント（ビジネスプロセスサービス実行時）」

「表7-29　性能解析トレース取得ポイント（データベースアクセス実行時）」

リターンコード
取得ポイント種別が出力されます。

0：正常終了

1：異常終了

インターフェース名
クラス名が出力されます。

オペレーション名
メソッド名が出力されます。

オプション情報
メッセージ共通ID
リクエスト識別情報（親ID）が出力されます。

サービスリクエストID
リクエスト識別情報（子ID）が出力されます。

付加情報
出力元固有の付加情報が出力されます。

HCSCサーバ（ビジネスプロセス基盤）の場合

性能解析トレースファイルに出力される内容を次の表に示します。

表7-24　性能解析トレースファイルに出力される内容（ビジネスプロセス基盤）

項目
内容

イベントID
取得ポイントのイベントIDが出力されます。
詳細は，「表7-31　性能解析トレース取得ポイント（ビジネスプロセス基盤）」を参照してください。

リターンコード
取得ポイント種別が出力されます。

0：正常終了

1：異常終了

インターフェース名
次の名称のどれかが出力されます。

ビジネスプロセス定義名

Javaクラス名

Data Transform

サービス名

詳細は，「表7-31　性能解析トレース取得ポイント（ビジネスプロセス基盤）」を参照してください。

オペレーション名
出力されません。

オプション情報
オプション情報が出力されます。
詳細は，「表7-31　性能解析トレース取得ポイント（ビジネスプロセス基盤）」を参照してください。

HCSCサーバ（DBアダプタ）の場合

性能解析トレースファイルに出力される内容を次の表に示します。

表7-25　性能解析トレースファイルに出力される内容（DBアダプタ）

項目
内容

イベントID
取得ポイントのイベントIDが出力されます。
詳細については，次の個所を参照してください。

「表7-32　性能解析トレース取得ポイント（DBアダプタ起動時）」

「表7-33　性能解析トレース取得ポイント（DBアダプタサービス実行時）」

リターンコード
取得ポイント種別が出力されます。

0：正常終了

1：異常終了

インターフェース名
クラス名が出力されます。
パッケージ名は表示されません。

オペレーション名
メソッド名が出力されます。

オプション情報
メッセージ共通ID
リクエスト識別情報（親ID）が出力されます。
情報を設定していない場合はnullになります。

サービスリクエストID
リクエスト識別情報（子ID）が出力されます。
情報を設定していない場合はnullになります。

付加情報
個別情報が出力されます。

HCSCサーバ（データ変換基盤）の場合

性能解析トレースファイルに出力される内容を次の表に示します。

表7-26　性能解析トレースファイルに出力される内容（データ変換基盤）

項目
内容

イベントID
取得ポイントのイベントIDが出力されます。
詳細については，次の個所を参照してください。

「表7-34　性能解析トレース取得ポイント（データ変換基盤）」

リターンコード
取得ポイント種別が出力されます。

0：正常終了

1：異常終了

インターフェース名
クラス名が出力されます。

オペレーション名
メソッド名が出力されます。

オプション情報
メッセージ共通ID
リクエスト識別情報（親ID）が出力されます。

サービスリクエストID
リクエスト識別情報（子ID）が出力されます。

付加情報
出力元固有の付加情報が出力されます。

(2)　性能解析トレースの取得ポイント

(a)　HCSCサーバ（メッセージング基盤）の場合

性能解析トレースファイルのトレース取得ポイントは，次に示す場合があり，それぞれで取得ポイントが異なります。

単体サービス実行時

ビジネスプロセスサービス実行時

データベースアクセス実行時

ファイルアクセス実行時

単体サービス実行時

単体サービス実行時性能解析トレースのトレース取得ポイントを次の図に示します。

図7-11　性能解析トレースの取得ポイント（単体サービス実行時）

イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。表の「図中の番号」は，図7-11中の番号と対応しています。

表7-27　性能解析トレース取得ポイント（単体サービス実行時）

イベント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 | サービスアダプタ（Webサービス）のサービス部品呼び出し口 | A
0x9811 | 4 | サービスアダプタ（Webサービス）のサービス部品応答受信口 | 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：標準

ビジネスプロセスサービス実行時

ビジネスプロセスサービス実行時の性能解析トレースのトレース取得ポイントを次の図に示します。

図7-12　性能解析トレースの取得ポイント（ビジネスプロセスサービス実行時）

イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。表の「図中の番号」は，図7-12中の番号と対応しています。

表7-28　性能解析トレース取得ポイント（ビジネスプロセスサービス実行時）

イベント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 | ユーザ定義受付（Webサービス）の入口 | A
0x9809 | 2 | ユーザ定義受付（Webサービス）の出口 | A
0x9810 | 7 | サービスアダプタ（Webサービス）のサービス部品呼び出し口 | A
0x9811 | 8 | サービスアダプタ（Webサービス）のサービス部品応答受信口 | 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-13　性能解析トレースの取得ポイント（データベースアクセス実行時）

イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。表の「図中の番号」は，図7-13中の番号と対応しています。

表7-29　性能解析トレース取得ポイント（データベースアクセス実行時）

イベントID | 図中の番号 | トレース取得ポイント | レベル
0x9850 | 1 | DBコネクタ呼び出し口 | A
0x9851 | 2 | DBコネクタ応答受信口 | A
0x9852 | 3 | DBコネクタ実行履歴呼び出し口 | B
0x9853 | 4 | DBコネクタ実行履歴応答受信口 | B

（凡例）

A：標準

B：詳細

ファイルアクセス実行時

データベースを使用しない構成でHCSCサーバをセットアップした場合，コマンド処理時に，データベースの代わりにファイルにアクセスします。このファイルアクセスするときの性能解析トレースを取得します。ファイルアクセスでの取得ポイントを次の図に示します。

図7-14　性能解析トレースの取得ポイント（ファイルアクセス実行時）

イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。表の「図中の番号」は，図7-14中の番号と対応しています。

表7-30　性能解析トレース取得ポイント（ファイルアクセス実行時）

イベントID | 図中の番号 | トレース取得ポイント | レベル
0x9854 | 1 | ファイルアクセス呼び出し口（ファイルオープン前） | B
0x9855 | 2 | ファイルアクセス応答受信口（ファイルクローズ後） | B

（凡例）

B：詳細

(b)　HCSCサーバ（ビジネスプロセス基盤）の場合

性能解析のトレース取得ポイントを次の図に示します。

図7-15　性能解析トレースのトレース取得ポイント（ビジネスプロセス基盤）

イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。表の「図中の番号」は，図7-15中の番号と対応しています。

表7-31　性能解析トレース取得ポイント（ビジネスプロセス基盤）

イベント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

親スレッドのハッシュコード（並列実行時）

フォルト名（異常時）

（凡例）

A：標準

注　表に含まれないイベントID（0x9A00～0x9AFF）は，データ変換基盤から発行されたものです。

(c)　HCSCサーバ（DBアダプタ）の場合

起動時とサービス部品実行時で，性能解析トレースのトレース取得ポイントが異なります。

起動時

起動時の性能解析トレースのトレース取得ポイントを次の図に示します。

図7-16　性能解析トレースのトレース取得ポイント（DBアダプタ起動時）

イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。表の「図中の番号」は，図7-16中の番号と対応しています。

表7-32　性能解析トレース取得ポイント（DBアダプタ起動時）

イベントID | 図中の番号 | トレース取得ポイント | レベル
0x9B60 | 1 | データソース検索直前 | B
0x9B61 | 2 | データソース検索直後 | B
0x9B62 | B

（凡例）

B：詳細

サービス部品実行時

サービス部品実行時の性能解析トレースのトレース取得ポイントを次の図に示します。

図7-17　性能解析トレースのトレース取得ポイント（DBアダプタサービス実行時）

イベントID，トレース取得ポイント，および性能解析トレース取得レベルを次の表に示します。表の「図中の番号」は，図7-17中の番号と対応しています。

表7-33　性能解析トレース取得ポイント（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
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-34　性能解析トレース取得ポイント（データ変換基盤）

イベント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
0x9A6A | XMLスキーマインスタンス生成直前 | A
0x9A6B | XMLスキーマインスタンス生成直後 | A
0x9A8D | XMLスキーマインスタンス生成直前 | A
0x9A8E | 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
0x9A84 | XMLデータ解析直前 | A
0x9A85 | XMLデータ解析直後 | A
0x9A82 | データ変換直前 | A
0x9A83 | データ変換直後 | A

（凡例）

A：標準

注※

ファイル操作アダプタからの呼び出しの場合，性能解析トレース取得レベルは「詳細」とします。

(3)　性能解析トレースの取得方法と出力先

性能解析トレースを取得するには設定が必要です。詳細については，「7.3.1　Cosminexus サービスプラットフォームが出力するログやトレースの取得方法」およびマニュアル「Cosminexus アプリケーションサーバ 機能解説 保守／移行／互換編」の「6.3　性能解析トレースファイル」を参照してください。

7.4.4　ユーザ電文トレース

HCSCサーバのメッセージング基盤では，次の内容をユーザ電文トレースとして取得できます。

リクエスト受付で受け付けたサービス部品呼び出し要求または応答の電文

ビジネスプロセスを呼び出したときの要求または応答の電文

サービスアダプタからサービス部品を呼び出したときの要求または応答の電文

データ変換を実行したときの変換前または変換後の電文

ユーザ電文トレースに出力される内容は，次の三つの部分で構成されます。

ユーザ電文トレース開始

ユーザ電文トレースデータ

ユーザ電文トレース終了

それぞれの内容を次に示します。

＜この項の構成＞

(1)　ユーザ電文トレース開始の出力形式と出力される内容

(2)　ユーザ電文トレースデータの出力形式と出力される内容

(3)　ユーザ電文トレース終了の出力形式と出力される内容

(4)　ユーザ電文トレースの取得ポイント

(5)　ユーザ電文トレースの取得方法

(6)　ユーザ電文トレースの出力先

(1)　ユーザ電文トレース開始の出力形式と出力される内容

(a)　出力形式

ユーザ電文トレース開始の出力形式を次の図に示します。

図7-18　ユーザ電文トレース開始の出力形式

(b)　出力される内容

ユーザ電文トレース開始に出力される内容を次の表に示します。

表7-35　ユーザ電文トレース開始に出力される内容

項目
内容

番号
トレースレコードの出力通番が表示されます。

日付
トレースレコードの取得日付（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：ビジネスプロセスの代入アクティビティ

プロトコル種別
トレースの取得ポイント情報（プロトコル種別）が出力されます。

SOAP：Webサービス

EJB：SessionBean

WSR：MDB（WS-R）

DBQ：MDB（DBキュー）

CUSTM：カスタムアダプタ

空白：取得位置が次の場合
・BPRCPまたはBPREQ
・BPCNVまたはBPASG

詳細位置
トレースの取得ポイント情報（詳細位置）が出力されます。

IN：受付

OUT：応答

CAL：呼び出し(ビジネスプロセスやサービス呼び出し)

RET：応答受信(ビジネスプロセスやサービス呼び出しの応答)

RQB：サービスアダプタにおける要求時のデータ変換前

RSA：サービスアダプタにおける応答時のデータ変換後

CVB：ビジネスプロセスにおけるデータ変換アクティビティ前

CVA：ビジネスプロセスにおけるデータ変換アクティビティ後

ASB：ビジネスプロセスにおける代入アクティビティ前

ASA：ビジネスプロセスにおける代入アクティビティ後

メッセージ共通ID
リクエスト識別情報（親ID）が出力されます。

付加情報
次の付加情報が出力されます。

(a) リクエスト受付およびサービスアダプタの場合

サービスリクエストID

サービス名（Service Name）

クライアント相関ID（Client ID）

(b) ビジネスプロセスの場合

プロセスインスタンスID

ビジネスプロセス名（Process Definition Name）

アクティビティ名（Activity Definition Name）

変数定義名（Variable Name）

CRLF
レコード終端符号が出力されます。

(2)　ユーザ電文トレースデータの出力形式と出力される内容

(a)　出力形式

ユーザ電文トレースデータの出力形式を次の図に示します。

図7-19　ユーザ電文トレースデータの出力形式

(b)　出力される内容

ユーザ電文トレースデータに出力される内容を次の表に示します。

表7-36　ユーザ電文トレースデータに出力される内容

項目
内容

番号
トレースレコードの出力通番が表示されます。

日付
トレースレコードの取得日付（yyyy/mm/dd形式）が出力されます。

時刻
トレースレコードの取得時刻（hh:mm:ss.sss形式）が，ローカル時刻でミリ秒単位に出力されます。

製品ID
製品を特定するための識別子が出力されます。

CSCMSG：メッセージング基盤

CSCBP：ビジネスプロセス

pid
プロセスを識別するためのIDが出力されます。

tid
スレッドを識別するためのIDが出力されます。

ID
表示されません。

電文トレースデータ情報
出力位置（16進数形式）
ユーザ電文の先頭からのオフセット値（16進数形式）が出力されます。

データ（16進数形式）
ユーザ電文の内容（16進数形式）が出力されます。

データ（ASCII形式）
ユーザ電文の内容（ASCII形式）が出力されます。
0x20～0x7Eの範囲の場合にASCII文字が出力されます。
範囲外の場合は，ピリオド（.）が出力されます。

CRLF
レコード終端符号が出力されます。

注

SOAPメッセージの場合，ユーザ電文トレースデータにはユーザ電文に含まれる次の情報が出力されます。

soap:Header要素を含む複数の子要素

soap:Body要素の一つの子要素

なお，soap:Header要素が存在しない場合は，soap:Body要素の子要素だけが情報として出力されます。

(3)　ユーザ電文トレース終了の出力形式と出力される内容

(a)　出力形式

ユーザ電文トレース終了の出力形式を次の図に示します。

図7-20　ユーザ電文トレース終了の出力形式

(b)　出力される内容

ユーザ電文トレース終了に出力される内容を次の表に示します。

表7-37　ユーザ電文トレース終了に出力される内容

項目
内容

番号
トレースレコードの出力通番が表示されます。

日付
トレースレコードの取得日付（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：ビジネスプロセスの代入アクティビティ

プロトコル種別
トレースの取得ポイント情報（プロトコル種別）が出力されます。

SOAP：Webサービス

EJB：SessionBean

WSR：MDB（WS-R）

DBQ：MDB（DBキュー）

CUSTM：カスタムアダプタ

空白：取得位置が次の場合
・BPRCPまたはBPREQ
・BPCNVまたはBPASG

詳細位置
トレースの取得ポイント情報（詳細位置）が出力されます。

IN：受付

OUT：応答

CAL：呼び出し(ビジネスプロセスやサービス呼び出し)

RET：応答受信(ビジネスプロセスやサービス呼び出しの応答)

RQB：サービスアダプタにおける要求時のデータ変換前

RSA：サービスアダプタにおける応答時のデータ変換後

CVB：ビジネスプロセスにおけるデータ変換アクティビティ前

CVA：ビジネスプロセスにおけるデータ変換アクティビティ後

ASB：ビジネスプロセスにおける代入アクティビティ前

ASA：ビジネスプロセスにおける代入アクティビティ後

メッセージ共通ID
リクエスト識別情報（親ID）が出力されます。

付加情報
付加情報として，ユーザ電文の長さ（10進数形式）が出力されます。なお，ユーザ電文がない場合は「0」または「null」が出力されます。

CRLF
レコード終端符号が出力されます。

(4)　ユーザ電文トレースの取得ポイント

ユーザ電文トレースの取得ポイントには，次に示す場合があり，それぞれで取得ポイントが異なります。

単体サービス実行時（データ変換がない場合）

単体サービス実行時（データ変換がある場合）

ビジネスプロセス呼び出し実行時

ビジネスプロセスサービス実行時

(a)　単体サービス実行時（データ変換がない場合）

単体サービス実行時（データ変換がない場合）のユーザ電文トレースのトレース取得ポイントを次の図に示します。

図7-21　ユーザ電文トレースの取得ポイント（単体サービス実行時（データ変換がない場合））

トレース取得ポイントを次の表に示します。表の「図中の番号」は，図7-21中の番号と対応しています。

表7-38　ユーザ電文トレース取得ポイント（単体サービス実行時（データ変換がない場合））

図中の番号 | トレース取得ポイント
1 | 標準受付（Webサービス）の入口
2 | 標準受付（Webサービス）の出口
1 | 標準受付（SessionBean）の入口
2 | 標準受付（SessionBean）の出口
1 | 標準受付（MDB（WS-R））の入口
2 | 標準受付（MDB（WS-R））の出口
1 | 標準受付（MDB（DBキュー））の入口
2 | 標準受付（MDB（DBキュー））の出口
3 | サービスアダプタ（Webサービス）のサービス部品呼び出し口
4 | サービスアダプタ（Webサービス）のサービス部品応答受信口
3 | サービスアダプタ（SessionBean）のサービス部品呼び出し口
4 | サービスアダプタ（SessionBean）のサービス部品応答受信口
3 | サービスアダプタ（MDB（WS-R））のサービス部品呼び出し口
4 | サービスアダプタ（MDB（WS-R））のサービス部品応答受信口
3 | サービスアダプタ（MDB（DBキュー））のサービス部品呼び出し口
4 | サービスアダプタ（MDB（DBキュー））のサービス部品応答受信口
3 | サービスアダプタ（CUSTOM）のサービス部品呼び出し口
4 | サービスアダプタ（CUSTOM）のサービス部品応答受信口

(b)　単体サービス実行時（データ変換がある場合）

単体サービス実行時（データ変換がある場合）のユーザ電文トレースのトレース取得ポイントを次の図に示します。

図7-22　ユーザ電文トレースの取得ポイント（単体サービス実行時（データ変換がある場合））

トレース取得ポイントを次の表に示します。表の「図中の番号」は，図7-22中の番号と対応しています。

表7-39　ユーザ電文トレース取得ポイント（単体サービス実行時（データ変換がある場合））

図中の番号 | トレース取得ポイント
1 | 標準受付（Webサービス）の入口
2 | 標準受付（Webサービス）の出口
1 | 標準受付（SessionBean）の入口
2 | 標準受付（SessionBean）の出口
1 | 標準受付（MDB（WS-R））の入口
2 | 標準受付（MDB（WS-R））の出口
1 | 標準受付（MDB（DBキュー））の入口
2 | 標準受付（MDB（DBキュー））の出口
3 | サービスアダプタ（Webサービス）の標準電文定義時のデータ変換前
4 | サービスアダプタ（Webサービス）の標準電文定義時のデータ変換後
3 | サービスアダプタ（SessionBean）の標準電文定義時のデータ変換前
4 | サービスアダプタ（SessionBean）の標準電文定義時のデータ変換後
3 | サービスアダプタ（MDB（WS-R））の標準電文定義時のデータ変換前
4 | サービスアダプタ（MDB（WS-R））の標準電文定義時のデータ変換後
3 | サービスアダプタ（MDB（DBキュー））の標準電文定義時のデータ変換前
4 | サービスアダプタ（MDB（DBキュー））の標準電文定義時のデータ変換後
3 | サービスアダプタ（CUSTOM）の標準電文定義時のデータ変換前
4 | サービスアダプタ（CUSTOM）の標準電文定義時のデータ変換後
5 | サービスアダプタ（Webサービス）のサービス部品呼び出し口
6 | サービスアダプタ（Webサービス）のサービス部品応答受信口
5 | サービスアダプタ（SessionBean）のサービス部品呼び出し口
6 | サービスアダプタ（SessionBean）のサービス部品応答受信口
5 | サービスアダプタ（MDB（WS-R））のサービス部品呼び出し口
6 | サービスアダプタ（MDB（WS-R））のサービス部品応答受信口
5 | サービスアダプタ（MDB（DBキュー））のサービス部品呼び出し口
6 | サービスアダプタ（MDB（DBキュー））のサービス部品応答受信口
5 | サービスアダプタ（CUSTOM）のサービス部品呼び出し口
6 | サービスアダプタ（CUSTOM）のサービス部品応答受信口

(c)　ビジネスプロセス呼び出し実行時

ビジネスプロセス呼び出し実行時のユーザ電文トレースのトレース取得ポイントを次の図に示します。

図7-23　ユーザ電文トレースの取得ポイント（ビジネスプロセス呼び出し実行時）

トレース取得ポイントを次の表に示します。表の「図中の番号」は，図7-23中の番号と対応しています。

表7-40　ユーザ電文トレース取得ポイント（ビジネスプロセス呼び出し実行時）

図中の番号 | トレース取得ポイント
1 | 標準受付（Webサービス）の入口
2 | 標準受付（Webサービス）の出口
1 | 標準受付（SessionBean）の入口
2 | 標準受付（SessionBean）の出口
1 | 標準受付（MDB（WS-R））の入口
2 | 標準受付（MDB（WS-R））の出口
1 | 標準受付（MDB（DBキュー））の入口
2 | 標準受付（MDB（DBキュー））の出口
3 | ビジネスプロセスサービスの呼び出し口
4 | ビジネスプロセスサービスの応答受信口

(d)　ビジネスプロセスサービス実行時

ビジネスプロセスサービス実行時のユーザ電文トレースのトレース取得ポイントを次の図に示します。

図7-24　ユーザ電文トレースの取得ポイント（ビジネスプロセスサービス実行時）

トレース取得ポイントを次の表に示します。表の「図中の番号」は，図7-24中の番号と対応しています。

表7-41　ユーザ電文トレース取得ポイント（ビジネスプロセスサービス実行時）

図中の番号 | トレース取得ポイント
1 | 標準受付（Webサービス）の入口
2 | 標準受付（Webサービス）の出口
1 | 標準受付（SessionBean）の入口
2 | 標準受付（SessionBean）の出口
1 | 標準受付（MDB（WS-R））の入口
2 | 標準受付（MDB（WS-R））の出口
1 | 標準受付（MDB（DBキュー））の入口
2 | 標準受付（MDB（DBキュー））の出口
7 | サービスアダプタ（Webサービス）のサービス部品呼び出し口
8 | サービスアダプタ（Webサービス）のサービス部品応答受信口
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）を指定した場合，またはコピー元に定数を指定した場合は，ユーザ電文トレースが出力されません。

(5)　ユーザ電文トレースの取得方法

ユーザ電文トレースを取得するには設定が必要です。詳細については「7.3.1 Cosminexus サービスプラットフォームが出力するログやトレースの取得方法」を参照してください。

(6)　ユーザ電文トレースの出力先

ユーザ電文トレースの出力先およびトレースファイル名を次の表に示します。

表7-42　ユーザ電文トレースの出力先およびファイル名

トレースファイルの出力先パス | トレースファイル名
HCSCサーバランタイム定義ファイルのtelegramtrace-filepathプロパティで指定したパス | csctelegram_<HCSCサーバ名>_<面数>.log

なお，指定したパスが存在しない場合，またはパスが誤っていた場合は，省略値の出力先にトレースが出力されます。

7.4.5　保守用ログおよびトレース

障害調査に必要な情報として，保守用のログおよびトレースを採取します。

＜この項の構成＞

(1)　例外ログ

(2)　メンテナンスログ

(3)　メソッドトレース

(1)　例外ログ

HCSCサーバを操作するときの障害時の内部エラー情報，およびHCSCサーバの障害時の内部エラー情報を例外ログとして取得します。例外ログは，保守員が障害解析用に使用します。Cosminexus サービスプラットフォームの例外ログは，HCSC-Managerのログ，およびCosminexusのJ2EEサーバの障害発生時の例外情報に出力されます。

(a)　例外ログで出力される内容

HCSC-Managerの例外ログ
HCSC-Manager内部の例外情報を取得します。

Cosminexusの障害発生時の例外情報
HCSCサーバで障害が発生したときの内部の例外情報を取得します。

(b)　例外ログの出力先

例外ログの出力先およびログファイル名を次の表に示します。

表7-43　例外ログの出力先およびファイル名

例外ログファイルの出力先パス | ログファイル名
HCSC-Manager定義ファイルのcscmng.log.dirパラメタで指定したパス | exeception<面数>.log
CosminexusのJ2EEサーバの例外ログ（障害発生時の例外情報）の出力先に指定されたパス | cjexception<面数>.log

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

CosminexusのJ2EEサーバの例外ログ（障害発生時の例外情報）の出力先は，usrconf.cfg（J2EEサーバ用オプション定義ファイル）で指定します。デフォルトの出力先は，<Cosminexusのインストールディレクトリ>¥CC¥server¥public¥ejb¥<J2EEサーバ名>¥logsです。

usrconf.cfgの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.3　usrconf.cfg（J2EEサーバ用オプション定義ファイル）」を参照してください。

(2)　メンテナンスログ

HCSC-Manager内部の保守情報をメンテナンスログとして取得できます。HCSC-Managerと外部要素（Cosminexus Manager，HCSC管理MBean，リポジトリ）との通信トレース，電文ログとしても使用されます。保守員が障害解析用に使用します。

(a)　メンテナンスログで出力される内容

HCSC-Manager内部の保守情報を取得します。

(b)　メンテナンスログの出力先

メンテナンスログの出力先およびログファイル名を次の表に示します。

表7-44　メンテナンスログの出力先およびファイル名

メンテナンスログファイルの出力先パス | ログファイル名
HCSC-Manager定義ファイルのcscmng.log.dirパラメタで指定したパス | maintenance<面数>.log

(3)　メソッドトレース

HCSCサーバで障害が発生し，原因の究明が困難な場合に，必要な情報をメソッドトレースとして取得できます。保守員が障害解析のために使用します。

(a)　メソッドトレースで出力される内容

HCSCサーバ（メッセージング基盤）の場合
HCSCサーバ（メッセージング基盤）内部の保守情報を取得します。

HCSCサーバ（ビジネスプロセス基盤）の場合
HCSCサーバ（ビジネスプロセス基盤）内部の保守情報を取得します。
ビジネスプロセス基盤には，ビジネスプロセス実行時のトレースとプロセスインスタンス関連のコマンド実行時のトレースがあります。ここでは，ビジネスプロセス実行時のトレースについて説明します。
プロセスインスタンス関連のコマンド実行時のトレースはManagement Serverで出力されるトレースと同様です。詳細については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 保守／移行／互換編」を参照してください。

HCSCサーバ（DBアダプタ）の場合
HCSCサーバ（DBアダプタ）内部の保守情報を取得します。

(b)　メソッドトレースの出力先

メソッドトレースの出力先およびトレースファイル名を次の表に示します。メッセージング基盤，ビジネスプロセス基盤，およびDBアダプタで共通の設定です。

表7-45　メソッドトレースファイルの出力先およびファイル名

トレースファイルの出力先パス | トレースファイル名
HCSCサーバランタイム定義ファイルのmethodtrace-filepathプロパティで指定したパス | cscmsgmtd_<HCSCサーバ名>_<面数>.log
cscbpmtd_<HCSCサーバ名>_<面数>.log
cscdbamtd_<HCSCサーバ名>_<面数>.log

なお，指定したパスが存在しない場合，またはパスが誤っていた場合は，省略値の出力先にトレースが出力されます。

7.5　システムのセットアップまたはアンセットアップ時の障害対策

＜この節の構成＞

7.5.1　実行環境に必要なソフトウェアの設定での障害調査

7.5.2　セットアップまたはアンセットアップ時の障害調査

7.5.3　HCSCサーバのセットアップおよびアンセットアップ時の回復方法

7.5.4　HCSCコンポーネントの配備および削除時の回復方法

7.5.1　実行環境に必要なソフトウェアの設定での障害調査

セットアップなどの環境設定をするなどシステム操作をしているときに障害が発生した場合の調査方法を説明します。ログの詳細については，「7.3　障害情報の取得」を参照してください。

＜この項の構成＞

(1)　データベースの操作中にエラーが発生した場合

(2)　Cosminexus Managerの操作中にエラーが発生した場合

(3)　Cosminexus Component Container（J2EEサーバ，またはCosminexus Component Container）の操作中にエラーが発生した場合

(4)　Cosminexus RMの操作中にエラーが発生した場合

(5)　DB Connectorの操作中にエラーが発生した場合

(1)　データベースの操作中にエラーが発生した場合

HiRDBの場合，HiRDBのログ（pdlog(n)）に出力されているエラーメッセージを調査します。Oracleの場合は，Oracle Corporationが発行するドキュメントを参照してください。

(2)　Cosminexus Managerの操作中にエラーが発生した場合

Cosminexus Management ServerやCosminexus Management Server-Administration Agentの起動に失敗するなどの障害が発生した場合，Cosminexusが出力する障害情報（運用管理エージェント，運用監視エージェント，Management Serverのログ）に出力されているエラーメッセージを調査します。

(3)　Cosminexus Component Container（J2EEサーバ，またはCosminexus Component Container）の操作中にエラーが発生した場合

J2EEサーバの操作をしている場合は，Cosminexusが出力する障害情報（J2EEサーバ，リダイレクタ，サーバ管理コマンドのログ）に出力されているエラーメッセージを調査します。

(4)　Cosminexus RMの操作中にエラーが発生した場合

まず，メッセージログに出力されているエラーメッセージを調査します。また，Cosminexus RMの開始停止メッセージログ，メソッドトレースを調査します。

メッセージの中に「HRM-xxxxx」という障害コードが出力されている場合は，マニュアル「Cosminexus Reliable Messaging」の「7.9　障害コードの詳細」を参照して，対処してください。

障害を調査するためにCosminexus RMがコンフィグレーションプロパティに対して設定している情報が必要になる場合があります。また，Cosminexus RMに関連づけているDB Connectorに設定している情報が必要になる場合もあります。これらの設定内容を再度確認して調査し，対処します。

(5)　DB Connectorの操作中にエラーが発生した場合

まず，メッセージログに出力されているエラーメッセージを調査します。また，障害が発生したDB Connector（リソースアダプタ）の稼働ログを参照して調査します。

障害を調査するためにDB Connectorに設定している情報が必要になる場合があります。これらの設定内容を再度確認して調査し，対処します。

7.5.2　セットアップまたはアンセットアップ時の障害調査

＜この項の構成＞

(1)　ログの見方および障害の切り分け方法

(2)　代表的な障害とその対処方法

(1)　ログの見方および障害の切り分け方法

セットアップまたはアンセットアップを実行しているときに，障害が発生したときの障害の調査手順について次の図に示します。

図7-25　障害の調査手順（セットアップまたはアンセットアップ時）

セットアップまたはアンセットアップでエラーが発生した場合，最初にコマンドの応答でコンソールに出力されるメッセージを確認します。

KEOSで始まるメッセージ（HCSC-Managerに関するメッセージ）の詳細情報としてKDECで始まるメッセージが含まれている場合，マニュアル「Cosminexus サービスプラットフォーム メッセージ」を確認して，対処します。

KEOSで始まるメッセージ（HCSC-Managerに関するメッセージ）の詳細情報として，KDEC以外で始まるメッセージが含まれている場合，各メッセージに対応したマニュアルを参照して対処します（例えば，KDJEメッセージが含まれている場合は，マニュアル「Cosminexus アプリケーションサーバ メッセージ 2」を参照します）。具体例を次に示します。

コマンド応答のメッセージ

エラーメッセージの中に，詳細情報として別のメッセージが出力されます。

要因が特定できない場合は，取得しているメッセージログを参照します。セットアップまたはアンセットアップ実行時に参照する障害情報は，次のメッセージログです。詳細については，「7.4.1　メッセージログ」を参照してください。

HCSC-Managerのログ

Cosminexusの統合メッセージログ

障害が発生した原因は，コマンド実行以前の環境設定やシステムの状態でエラーとなることもあるため，コマンド応答のメッセージを出力している個所の前後を確認し，ほかにエラーメッセージが出ていないか確認して対策します。

なお，メッセージログの内容を確認するときに，コンソールに出力されたメッセージが重複して出力されていることもあるため，適宜実行時間を確認します。

(2)　代表的な障害とその対処方法

ここでは，セットアップまたはアンセットアップ実行での代表的な障害とその対処方法について説明します。代表的な障害とその対処方法を次の表に示します。

表7-46　代表的な障害とその対処方法（セットアップまたはアンセットアップ時の障害調査）

手順（流れ）
代表的な障害
考えられる要因
対策
参照先

実行環境に必要なソフトウェアの設定
データベースのサーバ側のセットアップ
権限の設定ができない
データベース定義ユティリティ（pddef），SQL Executerのパスが設定されていません。
データベース定義ユティリティ（pddef），SQL Executerのパスを設定します。
－

Cosminexus Managerのセットアップ
Management Serverが起動しない
mserver.propertiesの書式が誤っています。
mserver.propertiesを見直します。
3.1.2※1

mserver.cfgの書式が誤っています。
mserver.cfgを見直します。

Management Serverと運用管理エージェントが自動起動しない
Management Serverと運用管理エージェントを自動起動するように設定されていません。
Management Serverと運用管理エージェントを自動起動するように設定します。

運用管理エージェントが起動しない
adminagent.cfgの書式が誤っています。
adminagent.cfgを見直します。
－

MBeanの起動確認で，KEOS27010-Iメッセージが出力されない
Cosminexusインストールディレクトリ>¥manager¥mbean-plugins配下に，定義ファイルおよびjarが存在しません。
<Cosminexusインストールディレクトリ>¥CSC¥mbean-plugins配下のファイルを，<Cosminexusインストールディレクトリ>¥manager¥mbean-pluginsにコピーします。
3.1.2※1

PRFのセットアップ
－
－
－
－

J2EEサーバのセットアップ
J2EEサーバが起動しない
J2EEサーバのシステム環境変数が正しく設定されていません。
J2EEサーバのシステム環境変数を見直します。
－

Hitachi Web 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の定義やCosminexus RMのコンフィグレーションプロパティの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) DABrokerのパス
/opt/DABroker/lib
(2) HiRDBクライアント製品のパス
/opt/HiRDB/client/lib
(3) HiRDBサーバ製品のパス
$PDDIR/client/lib
Linuxの場合はLD_LIBRARY_PATH，AIXの場合はLIBPATHに左記のパスを設定します。
なお，(1)はDABroker経由で接続する場合に必要です。
(2)と(3)はHiRDBに接続するときに，ソフトウェアのインストール状況に応じて，どちらか一方を設定します。
3.1.2※1

Cosminexus RMのセットアップ
DB Connectorのcjstartrarやcjtestres実行時にエラーが発生する
データベース関連の問題です。

HiRDB未起動

HiRDBのコネクション不足

HiRDBのホスト名やIPアドレス，ポート番号の誤り

HiRDBのユーザ名やパスワードの誤り。

HiRDBが起動しているかどうか確認します。

HiRDBのコネクション不足の場合は，次のどちらかを実施します。
(1) %PDDIR%¥CONF¥pdsysのpd_max_usersを50程度に変更します。
(2) DB Connectorの定義やCosmiRMのコンフィグレーションプロパティのMinPoolSizeを小さくします。

DB Connectorの定義を参照し，ホスト名やIPアドレス，ポート番号，ユーザ名やパスワードに誤りがないか確認します。

3.1.2※1

Cosminexus RMの起動，またはJ2EEサーバの起動時に，KDJE48213-Wが出力される
Cosminexus RMのコンフィグレーションプロパティに指定しているキュー定義ファイルの記述が誤っています。
Cosminexus サービスプラットフォームの07-50以降のバージョンを利用している場合，Cosminexus RMのコンフィグレーションプロパティのQueueConfigFileNameは指定不要です。
－

Cosminexus Service Coordinator-Managerのセットアップ
－
－
－
－

uCosminexus 日立コード変換 - Server RuntimeまたはuCosminexus 日立コード変換 - Runtimeのセットアップ
－
－
－
－

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の設定が漏れています。
次の三つのファイルに，ドライバの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）
リソースアダプタのCosminexus RMが起動していません。
Cosminexus RMを起動します。
－

HCSCサーバのセットアップ時に次のエラーが発生する
KEOS50007-E（詳細コードでKDEC10010-E）
J2EEサーバが起動していません。
見直します。※2
－

HCSCサーバのセットアップ時に次のエラーが発生する
KEOS50004-E（詳細コードでKEOS27105-E）
運用管理エージェントが正常に動作していません。
または，作成したJ2EEサーバが，Cosminexus Managerの管理下にありません。
見直します。※2
見直し内容に該当しない場合，作成したJ2EEサーバが，Cosminexus Managerの管理下にいないことがあります。
Cosminexus Managerで管理できるように設定します。※3
読み込んできたJ2EEサーバの設定については，一とおり正しく設定されているか確認して，設定が変わっている個所は，元の設定に変更します。その後，画面内の「適用」ボタンをクリックします。すべての見直しが完了したあとに，画面右上の「設定情報の配布」をクリックして，設定を有効にします。
なお，Cosminexus 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です。
二つのDB Connectorを準備していない場合は，DB Connectorを二つセットアップします。
DB Connectorの属性ファイルを取得し，<transaction-support>にNoTransactionを指定し，設定します。
HCSCサーバセットアップ定義ファイルに正しくDB Connectorが設定されていることを確認して，再度HCSCサーバをセットアップします。
3.1.2※1

サービスアダプタ/ビジネスプロセス/ユーザ定義受付の配備
KEOS50007-Eが発生してコマンドが失敗。HCSC稼働マシンのメッセージログに次のメッセージが出力される
KDJE50012-EまたはKFDJ02005-E
HCSCサーバセットアップ定義ファイルのdbcon-nodisplaynameに指定したDB Connectorが，<transaction-support>にNoTransaction以外を定義したDB Connectorです。
二つのDB Connectorを準備していない場合は，DB Connectorを二つセットアップします。
DB Connectorの属性ファイルを取得し，<transaction-support>にNoTransactionを指定し，設定します。
HCSCサーバセットアップ定義ファイルに正しくDB Connectorが設定されていることを確認して，再度HCSCサーバをセットアップします。
3.1.2※1

ユーザ定義受付の定義情報を設定
－
－
－
－

（凡例）

－：該当しません。

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

注※2　次の観点で見直します。

・該当J2EEサーバの稼働ホストで，運用管理エージェントが起動しているか。

・起動している運用管理エージェントのポート番号と，構成定義でホストに定義した運用管理エージェントのポート番号は一致しているか。

・構成定義で定義したホストと通信できるか。

・運用管理エージェントのプロパティで，アクセスしているCosminexus Management Serverの稼働ホストは接続が許可されているか。

・Management Serverと運用管理エージェントのCosminexusのバージョンが一致しているか。

・Management Serverと運用管理エージェントのCosminexusのエディションが異なる場合，接続できるエディション関係か。

・Managerのリモート管理機能が指定の「ホスト名（またはIPアドレス）:ポート番号」で起動されているか。

注※3　次の手順で，作成したJ2EEサーバがCosminexus Managerで管理できるように設定します。

1. 運用管理ポータルの「論理サーバの環境設定」で「論理J2EEサーバ」配下にあるJ2EEサーバ名を選択し，設定画面を表示させます。

2. 表示したメニューのタブ「読み込み」をクリックします。「サーバの設定読み込み」画面が表示されます。

3. 「接続先ホストから設定を読み込みます」を選択し，「読み込み」ボタンをクリックします。

4. 画面右上の「運用管理ポータル」をクリックします。いったんトップページに戻ります。

5. 「論理サーバの起動/停止」をクリックします。起動させる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のアプリケーションを次に示します。

表7-47　削除の対象となるHCSCのアプリケーション（HCSCサーバのセットアップおよびアンセットアップの障害時）

項目 | アプリケーション名 | 共有
HCSCサーバアプリケーション | CSCMessaging | ×
CSCMsgSyncServiceDelivery | ×
CSCMsgSyncServiceDeliveryWS | ×
CSCMsgAsyncServiceDelivery | ×
CSCMsgAsyncServiceDeliveryDBQ | ×

（凡例）

×：リソースをクラスタ内で共有しないことを示します。

次のコマンドを実行して，削除の対象となる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-48　 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 | T | ○
9 | CSCMSG_C<クラスタ名>_EXECHISTORY_I | I | ○
10 | CSCMSG_C<クラスタ名>_CLUSTER※1 | T | ○
11 | CSCMSG_C<クラスタ名>_HA_ASYNC_ADP※1 | T | ○
12 | CSCBP_<クラスタ名>_PROCESS | T | ○
13 | CSCBP_<クラスタ名>_PROCESS_IDX1 | I | ○
14 | CSCBP_<クラスタ名>_PROCESS_IDX2 | I | ○
15 | CSCBP_<クラスタ名>_PROCESS_IDX3 | I | ○
16 | CSCBP_<クラスタ名>_ACTIVITY | T | ○
17 | CSCBP_<クラスタ名>_ACTIVITY_IDX | I | ○
18 | CSCBP_<クラスタ名>_LINK | T | ○
19 | CSCBP_<クラスタ名>_LINK_IDX | I | ○
20 | CSCBP_<クラスタ名>_CORRELATIONSET | T | ○
21 | CSCBP_<クラスタ名>_CORREL_IDX1 | I | ○
22 | CSCBP_<クラスタ名>_CORREL_IDX2 | I | ○
23 | CSCBP_<クラスタ名>_STR_VARIABLE | T | ○
24 | CSCBP_<クラスタ名>_STR_VAR_IDX | I | ○
25 | CSCBP_<クラスタ名>_NUM_VARIABLE | T | ○
26 | CSCBP_<クラスタ名>_NUM_VAR_IDX | I | ○
27 | CSCBP_<クラスタ名>_BOOL_VARIABLE | T | ○
28 | CSCBP_<クラスタ名>_BOOL_VAR_IDX | I | ○
29 | CSCBP_<クラスタ名>_MSG_VARIABLE | T | ○
30 | CSCBP_<クラスタ名>_MSG_VAR_IDX | I | ○
31 | CSCBP_<クラスタ名>_MSG_RELATION | T | ○
32 | CSCBP_<クラスタ名>_MSG_REL_IDX1 | I | ○
33 | CSCBP_<クラスタ名>_MSG_REL_IDX2 | I | ○
34 | CSCBP_<クラスタ名>_MSG_REL_IDX3 | I | ○
35 | CSCBP_<クラスタ名>_V_ACTIVITY | V | ○
36 | CSCBP_<クラスタ名>_V_LINK | V | ○
37 | CSCBP_<クラスタ名>_V_STR_VARIABLE | V | ○
38 | CSCBP_<クラスタ名>_V_NUM_VARIABLE | V | ○
39 | CSCBP_<クラスタ名>_V_BOOL_VARIABLE | V | ○
40 | CSCBP_<クラスタ名>_V_MSG_VARIABLE | V | ○
41 | リクエスト受付キュー | クラスタ種別がLBの場合 | CSC<HCSCサーバ名>ACPT_RCVQ | Q | ×
42 | CSC<HCSCサーバ名>ACPT_DBQ | Q | ×
43 | クラスタ種別がHAの場合 | CSC<クラスタ名>ACPT_RCVQ | Q | ○
44 | CSC<クラスタ名>ACPT_DBQ | Q | ○
45 | HCSCサーバ一時ファイル | ServerProperties_<HCSCサーバ名> | F | ×
46 | ServerSetup_<HCSCサーバ名> | F | ×
47 | ReceptionProperties_dbq_<HCSCサーバ名> | F | ×
48 | ReceptionProperties_ejb_<HCSCサーバ名> | F | ×
49 | ReceptionProperties_jms_<HCSCサーバ名> | F | ×
50 | ReceptionProperties_soap_<HCSCサーバ名> | F | ×
51 | UserReceptionProperties_<HCSCサーバ名>_<受付ID> | F | ×
52 | ServerProperties_<HCSCサーバ名>.old | F | ×
53 | ServerSetup_<HCSCサーバ名>.old | F | ×
54 | ReceptionProperties_dbq_<HCSCサーバ名>.old | F | ×
55 | ReceptionProperties_ejb_<HCSCサーバ名>.old | F | ×
56 | ReceptionProperties_jms_<HCSCサーバ名>.old | F | ×
57 | ReceptionProperties_soap_<HCSCサーバ名>.old | F | ×
58 | UserReceptionProperties_<HCSCサーバ名>_<受付ID>.old | F | ×
59 | ServerPropertiesAct_<HCSCサーバ名> | F | ×
60 | ReceptionPropertiesAct_dbq_<HCSCサーバ名> | F | ×
61 | ReceptionPropertiesAct_ejb_<HCSCサーバ名> | F | ×
62 | ReceptionPropertiesAct_jms_<HCSCサーバ名> | F | ×
63 | ReceptionPropertiesAct_soap_<HCSCサーバ名> | F | ×
64 | UserReceptionPropertiesAct_<HCSCサーバ名>_<受付ID> | F | ×
65 | ServerPropertiesAct_<HCSCサーバ名>.old | F | ×
66 | ReceptionPropertiesAct_dbq_<HCSCサーバ名>.old | F | ×
67 | ReceptionPropertiesAct_ejb_<HCSCサーバ名>.old | F | ×
68 | ReceptionPropertiesAct_jms_<HCSCサーバ名>.old | F | ×
69 | ReceptionPropertiesAct_soap_<HCSCサーバ名>.old | F | ×
70 | UserReceptionPropertiesAct_<HCSCサーバ名>_<受付ID>.old | F | ×
71 | _cscmsg_cnfrqdbq_<HCSCサーバ名>.xml | F | ×
72 | _cscmsg_cnfrqejb_<HCSCサーバ名>.xml | F | ×
73 | _cscmsg_cnfrqjms_<HCSCサーバ名>.xml | F | ×
74 | _cscmsg_cnfrqsoap_<HCSCサーバ名>.xml | F | ×
75 | _cscmsg_cnfrqsorp_<HCSCサーバ名>.xml | F | ×
76 | _cscmsg_cnfrq_<HCSCサーバ名>_<受付ID>.xml | F | ×
77 | inf | F2 | ×

（凡例）

I：インデクスであることを示します。※2

T：データベーステーブルであることを示します。※2

V：ビュー表であることを示します。※2

Q：Cosminexus RMのキューであることを示します。※3

F：HCSCサーバ一時ファイルであることを示します。※4

F2：HCSCサーバのシステム管理情報を保存する出力先のディレクトリであることを示します。※5

○：リソースをクラスタ内で共有することを示します。

×：リソースをクラスタ内で共有しないことを示します。

注※1

次に示す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;

注※2

データベーステーブル，インデクスおよびビュー表はSQL命令（DROP）を実行して削除してください。

注※3

Cosminexus RMのキューは，hrmstopコマンドを実行して管理状態へ移行したあと，hrmdelqueコマンドを実行して削除してください。コマンドの詳細は，マニュアル「Cosminexus Reliable Messaging」の「8.3.8　hrmdelque（キューの削除）」を参照してください。

注※4

HCSCサーバ一時ファイルは，「<Cosminexusインストールディレクトリ>¥CSC¥system¥msg」にあるファイルを削除してください。

注※5

HCSCサーバセットアップ定義ファイルのhcscserver-data-filepathプロパティに指定したディレクトリにあるリソースを削除してください。hcscserver-data-filepathプロパティにディレクトリを指定していない場合は，hcscserver-data-filepathプロパティのデフォルトのディレクトリにあるリソースを削除してください。

注意

J2EEサーバ上のHCSCサーバを削除する場合には，cscapputilコマンドを使用します。CosminexusのJ2EEサーバのコマンドでは削除できません。

cscapputilコマンドは，障害を回復する場合にだけ使用してください。通常運用時や構築時には，このコマンドを使用しないでください。

cscapputilコマンドで，アプリケーションを削除した場合，サービスプラットフォームのシステムを破壊するおそれがあります。そのため，十分に注意して運用してください。

7.5.4　HCSCコンポーネントの配備および削除時の回復方法

サービスアダプタ，ビジネスプロセス，およびユーザ定義受付の配備に失敗後，再配備ができない，またはサービスアダプタ，ビジネスプロセス，およびユーザ定義受付の削除を繰り返しても削除が完了しない場合は，次のように対処してください。

csccompoundeployコマンドに-ignoreオプションを指定して実行し，リポジトリ情報を削除します。

csccompoundeploy -user <ログインユーザID> -pass <ログインパスワード> -csc <HCSCサーバ名> -name <サービスIDまたは受付ID> -ignore

リポジトリ情報を削除後に，アプリケーションの削除が必要な場合は，手順2.～手順5.を実行してください。アプリケーションの削除が不要な場合は，手順5.を実行してください。

次のコマンドを実行して，削除の対象となるHCSCのアプリケーションの名称を確認します。

cscapputil -user <ログインユーザID> -pass <ログインパスワード> -mng <Cosminexus Manager名称> -j2ee <J2EEサーバ名> -operation list

削除の対象となるHCSCのアプリケーションを次に示します。

表7-49　削除の対象となるHCSCのアプリケーション（HCSCコンポーネントの配備および削除の障害時）

項目 | アプリケーション名 | 共有
HCSCコンポーネント（サービスアダプタおよびビジネスプロセス）のアプリケーション | <サービスID> | ×
HCSCコンポーネント（ユーザ定義受付）のアプリケーション | <受付ID> | ×

（凡例）

×：リソースをクラスタ内で共有しないことを示します。

次のコマンドを実行して，削除の対象となるHCSCコンポーネントを停止します。

cscapputil -user <ログインユーザID> -pass <ログインパスワード> -mng <Cosminexus Manager名称> -j2ee <J2EEサーバ名> -app <アプリケーション名> -operation stop

次のコマンドを実行して，HCSCコンポーネントを削除します。

cscapputil -user <ログインユーザID> -pass <ログインパスワード> -mng <Cosminexus Manager名称> -j2ee <J2EEサーバ名> -app <アプリケーション名> -operation delete

削除できないリソース（キュー）がある場合，表7-48を参考に削除します。
ただし，クラスタ内で共有するリソースについては，クラスタ内で最後のサービスアダプタまたはビジネスプロセスを削除する場合にだけ削除してください。

削除できないリソース（データベーステーブルの情報）がある場合，次の手順を参考に削除します。
なお，次の条件をすべて満たしていない場合は，リソース（データベーステーブルの情報）の削除をしないでください。

クラスタ種別に「HA」を指定してHCSCサーバをセットアップした。

クラスタ内で同一サービスIDの非同期アダプタが配備されていない。

次のSQL文を実行して，残っている不要なリソース（データベーステーブルの情報）を削除します。

DELETE FROM CSCMSG_C<クラスタ名>_HA_ASYNC_ADP
      WHERE CSC_SERVER_NAME='<HCSCサーバ名>'
        AND ADAPTER_NAME='<配備または削除に失敗した非同期アダプタのサービスID>';

COMMIT;

HCSCサーバを再起動します。

表7-50　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
F2
×

9
IServiceKind
F2
×

10
IServiceName
F2
×

11
R<数字>※1
F2
×

（凡例）

T：データベーステーブルであることを示します。※2

Q：Cosminexus RMのキューであることを示します。※3

U：Cosminexus RMの転送キューに設定するあて先であることを示します。※4

F：HCSCサーバ一時ファイルであることを示します。※5

F2：HCSCサーバ一時ファイルであることを示します。※6

○：リソースをクラスタ内で共有することを示します。

×：リソースをクラスタ内で共有しないことを示します。

注※1

ファイル内のSERVICE_NAMEの行に，次のどれかが格納されたファイルです。

削除対象のサービスアダプタのサービス名

削除対象のビジネスプロセス名

削除対象のユーザ定義受付は次の形式
:Reception_<削除対象のユーザ定義受付の受付ID>:<削除対象のユーザ定義受付の受付名>

注※2

データベーステーブルの行は，SQL命令のDELETEを実行して一行ずつ削除してください。

注※3

Cosminexus RMのキューは，hrmstopコマンドを実行して管理状態へ移行したあと，hrmdelqueコマンドを実行して削除してください。コマンドの詳細は，マニュアル「Cosminexus Reliable Messaging」の「8.3.26　hrmstop（管理状態への移行）」を参照してください。

注※4

Cosminexus RMの転送キューに設定するあて先は，hrmstopコマンドを実行して管理状態へ移行したあと，hrmdeladdrコマンドを実行して削除してください。コマンドの詳細は，マニュアル「Cosminexus Reliable Messaging」の「8.3.6　hrmdeladdr（あて先削除）」を参照してください。

注※5

ファイルを削除したい場合は，「<Cosminexusインストールディレクトリ>CSC¥system¥msg」にあるファイルを削除してください。

注※6

ファイルを削除したい場合は，HCSCサーバセットアップ定義ファイルのhcscserver-data-filepathプロパティに指定した，「<hcscserver-data-filepathで指定したディレクトリ>¥inf¥LC_DIRECTORY」ディレクトリにあるリソース（ファイル）を削除してください。hcscserver-data-filepathプロパティにディレクトリを指定していない場合は，「<hcscserver-data-filepathのデフォルトのディレクトリ>¥inf¥LC_DIRECTORY」ディレクトリにあるリソース（ファイル）を削除してください。

注意

J2EEサーバ上のHCSCコンポーネントを削除する場合には，cscapputilコマンドを使用します。CosminexusのJ2EEサーバのコマンドでは削除できません。

cscapputilコマンドは，障害を回復する場合にだけ使用してください。通常運用時や構築時には，このコマンドを使用しないでください。

cscapputilコマンドで，アプリケーションを削除した場合，サービスプラットフォームのシステムを破壊するおそれがあります。そのため，十分に注意して運用してください。

7.6　オペレーション実行時の障害対策

＜この節の構成＞

7.6.1　コマンド操作や運用環境の画面操作での障害調査

7.6.2　ファイルの入出力に失敗した場合の回復方法

7.6.1　コマンド操作や運用環境の画面操作での障害調査

障害が発生した場合，コンソールまたは運用環境の画面に表示されるメッセージを確認して障害を調査します。運用環境の画面が操作できなくなった場合は，画面が正常な状態になるよう対処します。

＜この項の構成＞

(1)　ログの見方および障害の切り分け方法

(2)　代表的な障害とその対処方法

(3)　運用環境の画面が操作できなくなった場合の対処方法

(1)　ログの見方および障害の切り分け方法

コマンド操作や運用環境の画面操作をしているときに，障害が発生したときの障害の調査手順について次の図に示します。

図7-26　障害の調査手順（コマンド操作や運用環境の画面操作での障害調査）

コマンド操作や運用環境の画面操作でエラーが発生した場合，最初にコマンドの応答でコンソールに出力されるメッセージを確認します。

KDECで始まるメッセージの場合や，KEOSで始まるメッセージ（HCSC-Managerに関するメッセージ）の詳細情報としてKDECで始まるメッセージが含まれている場合，マニュアル「Cosminexus サービスプラットフォーム メッセージ」を確認して，対処します。

KEOSで始まるメッセージ（HCSC-Managerに関するメッセージ）の詳細情報として，KDEC以外で始まるメッセージが含まれている場合，各メッセージに対応したマニュアルを参照して対処します（例えば，KDJEメッセージが含まれている場合は，マニュアル「Cosminexus アプリケーションサーバ メッセージ 2」を参照します）。具体例を次に示します。

コマンド応答のメッセージの例

エラーメッセージ中に詳細情報のエラーメッセージが含まれる形式で出力されます。

要因が特定できない場合は，取得しているメッセージログを参照します。セットアップまたはアンセットアップ実行時に参照する障害情報は，次のメッセージログです。詳細については，「7.4.1　メッセージログ」を参照してください。

HCSC-Managerのログ

Cosminexusの統合メッセージログ

CosminexusのJ2EEサーバ稼働ログ

障害が発生した原因は，コマンド実行以前の環境設定やシステムの状態でエラーとなることもあるため，コマンド応答のメッセージを出力している個所の前後を確認し，ほかにエラーメッセージが出ていないかを確認して，対策します。

なお，メッセージログの内容を確認するとき，コンソールに出力されたメッセージが重複して出力されていることもありますので，適宜実行時間を確認してください。

(2)　代表的な障害とその対処方法

ここでは，コマンド操作での代表的な障害とその対処方法について説明します。代表的な障害とその対処方法を次の表に示します。

表7-51　代表的な障害とその対処方法（コマンド操作や運用環境の画面操作での障害調査）

操作
代表的な障害
考えられる要因
対策
参照先マニュアル
参照個所

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））
次のどれかのディレクトリの設定漏れです。
<Cosminexusインストールディレクトリ>¥CSC¥config¥msg¥cmdconf.bat
<Cosminexusインストールディレクトリ>/CSC/config/msg/cmdconf
<Cosminexusインストールディレクトリ>CSC/config/msg/cmdconf
cmdconf（cmdconf.bat）のHCSC_ADDCLASSPATHにHiRDB Type4 JDBCドライバのjarファイル（pdjdbc2.jar）のパスを指定します。
Cosminexus サービスプラットフォーム リファレンス
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.driver.OracleDriver））
次のどれかのディレクトリの設定漏れです。
<Cosminexusインストールディレクトリ>¥CSC¥config¥msg¥cmdconf.bat
<Cosminexusインストールディレクトリ>/CSC/config/msg/cmdconf
<Cosminexusインストールディレクトリ>CSC/config/msg/cmdconf
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サーバオフライン時は，データベースのユーザ名とパスワードを必ず指定します。
4章

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またはMyEclipseのタスクを終了します。

エラーの原因を調査して対処します。

Eclipse画面を起動し，HCSC-Managerにログイン後，エラーとなった操作を再実行します。

注意

上記に示す対処をした場合，運用環境と同一のEclipseで編集中の内容も失われます。運用環境の画面を操作する場合は，Eclipseで編集中の内容を，あらかじめ保存または終了してください。

7.6.2　ファイルの入出力に失敗した場合の回復方法

ファイルの入出力に失敗した場合，コマンド操作時にエラーメッセージKEOS50133-Eが出力されることがあります。KEOS50133-Eが一度出力されると，それ以降コマンド操作時にKEOS50133-Eが出力されるようになり，コマンドを実行できません。

KEOS50133-Eが出力された場合の対策方法を次に示します。

メッセージログを参照してファイルの入出力に失敗した原因を調査し，エラーとなった原因を取り除きます。
次の内容を調査し，エラーとなった原因を取り除いてください。

リポジトリルート以下で不当にアクセスしているプロセスが存在しないか

アクセス権が適切に割り当てられているか

ディスクがいっぱいになっていないか

バックアップファイルから，環境を復旧します。
KEOS50133-Eのメッセージに出力されるバックアップの種別から，バックアップファイルの出力先ディレクトリを特定します。
バックアップファイルは，次のディレクトリに出力されます。

<Cosminexusのインストールディレクトリ>¥CSC¥spool¥manager¥backup¥<種別>

なお，エラー発生時の状態に応じて復旧方法が異なります。エラー発生時の状態に応じた復旧方法を次の表に示します。

表7-52　エラー発生時の状態に応じた復旧方法

項番
種別※1
バックアップファイル名
エラー発生時の状態
復旧後の状態
復旧方法

1
import
crt_mngenv.zip
バックアップ中
エラーが発生したコマンドの実行前
crt_mngenv.zipを削除します。

2
import
mngenv.zip
ファイルの入出力中
エラーが発生したコマンドの実行前

mngenv.zip※2を任意のディレクトリに移動し，mngenv.zipが格納されていたディレクトリを空にします。

次のコマンドを実行します。
cscenvrestore -user <ユーザID> -pass <パスワード> -restorefile <１.で移動したファイル名>

3
import
del_mngenv.zip
ファイルの入出力後（バックアップファイルの削除中）
エラーが発生したコマンドの完了後
del_mngenv.zipを削除します。

4
repository
crt_rep.zip
バックアップ中
エラーが発生したコマンドの実行前
crt_rep.zipを削除します。

5
repository
rep.zip
ファイルの入出力中
エラーが発生したコマンドの実行前

次の二つのディレクトリ※3以下のファイルを削除して，ディレクトリを空にします。
<リポジトリルート>¥hirep¥configs¥*
<リポジトリルート>¥manager¥*

次のコマンドを実行します。
cd <リポジトリルート>
"<Cosminexusのインストールディレクトリ>¥jdk¥bin¥jar" xvf "<Cosminexusのインストールディレクトリ>¥CSC¥spool¥manager¥backup¥repository¥rep.zip"

rep.zipを削除して，rep.zipが格納されていた次のディレクトリを空にします。
<Cosminexusのインストールディレクトリ>¥CSC¥spool¥manager¥backup¥repository¥*

cscreplsコマンドを実行して，正常に終了することを確認します。

6
repository
del_rep.zip
ファイルの入出力後（バックアップファイルの削除中）
エラーが発生したコマンドの完了後
del_rep.zipを削除します。

注※1

バックアップファイルの出力先ディレクトリに示す種別に対応しています。

注※2

mngenv.zipは，cscenvbackupコマンドでバックアップしたファイルです。

注※3

rep.zipは，二つのディレクトリ（<リポジトリルート>¥hirep¥configs¥*と<リポジトリルート>¥manager¥*）以下のファイルを圧縮したファイルです。

7.7　サービス部品呼び出し要求時の障害対策

サービスリクエスタからサービス部品を呼び出すときに障害が発生すると，サービスリクエスタにエラーがリターンします。ここでは，エラーが発生した個所からサービスリクエスタまでどのように伝わるか，また検知したエラーの要因をどのように切り分けるかについて説明します。なお，開発環境の定義は，運用環境を通じて実行環境で動作しますが，ここでは運用環境の説明は省略しています。

＜この節の構成＞

7.7.1　Webサービス（SOAP通信）実行時の障害対策

7.7.2　SessionBean実行時の障害対策

7.7.3　MDB（WS-R）実行時の障害対策

7.7.4　MDB（DBキュー）実行時の障害対策

7.7.5　ユーザ電文に誤りがある場合の障害対策

7.7.6　システム全体の障害での障害調査

7.7.7　ビジネスプロセス実行時の障害対策

7.7.8　データ変換実行時の障害対策

7.7.1　Webサービス（SOAP通信）実行時の障害対策

SOAP通信の場合，サービスリクエスタからサービス部品を呼び出すときに，障害が発生すると，サービスリクエスタにエラーがリターンします。

＜この項の構成＞

(1)　SOAP通信でのエラーの伝わり方

(2)　問題発生個所の切り分け方

(3)　HCSCサーバから応答するSOAP Faultの内容

(4)　そのほかの障害要因の特定方法（サービス部品呼び出し要求の実行履歴の追跡）

(5)　SOAP1.2のWebサービスを使用する際の注意事項

(1)　SOAP通信でのエラーの伝わり方

サービスリクエスタから標準受付を使用してサービス部品を呼び出す場合と，サービスリクエスタからユーザ定義受付を使用してサービス部品を呼び出す場合とで，エラーの伝わり方が異なります。それぞれのエラーの伝わり方を説明します。

(a)　標準受付の場合

エラーの伝わり方は，エラーの種類やビジネスプロセスの有無によって異なります。

サービス部品からユーザ定義例外のエラーがリターンした場合（ビジネスプロセスを使用しないとき）

サービス部品からユーザ定義例外のエラーがリターンした場合でビジネスプロセスを使用しないときのSOAP通信でのエラーの伝わり方を次の図に示します。

図7-27　サービス部品からユーザ定義例外のエラーがリターンした場合（ビジネスプロセスを使用しないとき）のSOAP通信でのエラーの伝わり方

サービス部品側の通信基盤にCosminexusが提供しているSOAP通信基盤またはJAX-WSエンジンを使用している場合で，サービス部品で例外をスローするコーディングをしているとき，サービス部品のWSDLにはユーザ定義例外がSOAPフォルトで定義されます。サービス部品でユーザ定義例外が発生すると，SOAPフォルトの内容が標準受付からサービスリクエスタに応答されます。

サービスリクエスタが使用するWSDLはCosminexus サービスプラットフォームが提供するWSDLで，このWSDLにはCSCMsgServerFaultException※がSOAPフォルトとして定義されています。サービスリクエスタは，HCSCサーバがリターンするSOAPフォルトをCSCMsgServerFaultException※オブジェクトでキャッチできます。キャッチした例外オブジェクトのgetterを使用することで，サービス部品側で発生した例外名やフォルト情報（エラーの詳細）を取得できます。CSCMsgServerFaultException※の詳細については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「10.3.8　エラー情報を取得する」を参照してください。

注※

SOAP1.2の場合は，CSCMsgServerFault12Exceptionとなります。

サービス部品からユーザ定義例外以外のエラーがリターンした場合（ビジネスプロセスを使用しないとき）

サービス部品からユーザ定義例外以外のエラーがリターンした場合でビジネスプロセスを使用しないときのSOAP通信でのエラーの伝わり方を次の図に示します。

図7-28　サービス部品からユーザ定義例外以外のエラーがリターンした場合（ビジネスプロセスを使用しないとき）のSOAP通信でのエラーの伝わり方

サービス部品側の通信基盤にCosminexusが提供しているSOAP通信基盤またはJAX-WSエンジンを使用している場合で，サービス部品でWSDLに定義していない想定外の例外（システム例外）が発生したときは，RuntimeExceptionとしてSOAPメッセージが伝わります。また，サービス部品側の通信基盤にJAX-WSエンジンを使用している場合や，Cosminexusが提供しているSOAP通信基盤を使用していない場合は，WSDLにSOAPフォルトを定義していてもHCSCサーバ内では例外として扱われます。

サービスアダプタからサービス部品を呼び出したときに発生したシステム例外は，サービスアダプタでフォルト電文に変換することもできます。システム例外をフォルト電文に変換する方法については，「7.11　例外発生時に取得するエラーの選択」を参照してください。

サービスリクエスタが使用するWSDLはCosminexus サービスプラットフォームが提供するWSDLで，このWSDLにはCSCMsgServerFaultException※がSOAPフォルトとして定義されています。サービスリクエスタは，HCSCサーバがリターンするSOAPフォルトをCSCMsgServerFaultException※オブジェクトでキャッチできます。キャッチした例外オブジェクトのgetterを使用することで，発生したフォルト情報（エラーの詳細）を取得できます。CSCMsgServerFaultException※の詳細については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「10.3.8　エラー情報を取得する」を参照してください。

なお，サービス部品が応答したSOAPフォルトをHCSCサーバ内で例外ではなくSOAPフォルトのまま伝えたい場合は，SOAP Fault動作定義ファイルで定義します。SOAP Fault動作定義ファイルの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「SOAP Fault動作定義ファイル」を参照してください。

注※

SOAP1.2の場合は，CSCMsgServerFault12Exceptionとなります。

HCSCサーバからエラーがリターンした場合（ビジネスプロセスを使用しないとき）

HCSCサーバからエラーがリターンした場合でビジネスプロセスを使用しないときのSOAP通信でのエラーの伝わり方を次の図に示します。

図7-29　HCSCサーバからエラーがリターンした場合（ビジネスプロセスを使用しないとき）のSOAP通信でのエラーの伝わり方

図中の各エラーには，次に示すケースが該当します。

エラー1：要求パラメタ不正，指定文字コード不正，各種フォーマット不正など

エラー2：あて先（ロケーション）が見つからない，アダプタが停止しているなど

エラー3：データ変換に失敗したなど

エラー4：あて先不正，サービス部品が停止，通信障害など

HCSCサーバで図中のエラー1～エラー3のどれかを検知した場合，発生したエラーの例外をサービスリクエスタにリターンします。図中のエラー4を検知した場合，発生したエラーの例外をサービスリクエスタにそのままリターンするか，サービスアダプタでエラーの例外をフォルト電文に変換するか選択できます。例外発生時に取得するエラーの選択方法については，「7.11　例外発生時に取得するエラーの選択」を参照してください。

サービスリクエスタは，HCSCサーバがリターンするSOAPフォルトをCSCMsgServerFaultException※オブジェクトでキャッチできます。キャッチした例外オブジェクトのgetterを使用することで，発生したフォルト情報（エラーの詳細）を取得できます。CSCMsgServerFaultException※の詳細については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「10.3.8　エラー情報を取得する」を参照してください。

注※

SOAP1.2の場合は，CSCMsgServerFault12Exceptionとなります。

サービス部品からユーザ定義例外のエラーがリターンした場合（ビジネスプロセスを使用するとき）

サービス部品からユーザ定義例外のエラーがリターンした場合でビジネスプロセスを使用するときのSOAP通信でのエラーの伝わり方を次の図に示します。

図7-30　サービス部品からユーザ定義例外のエラーがリターンした場合（ビジネスプロセスを使用するとき）のSOAP通信でのエラーの伝わり方

サービス部品側の通信基盤にCosminexusが提供しているSOAP通信基盤またはJAX-WSエンジンを使用している場合で，サービス部品で例外をスローするコーディングをしているとき，サービス部品のWSDLにはユーザ定義例外がSOAPフォルトで定義されます。サービス部品でユーザ定義例外が発生すると，そのエラーは，一度ビジネスプロセスでキャッチできます。

サービスリクエスタは，HCSCサーバがリターンするSOAPフォルトをCSCMsgServerFaultException※オブジェクトでキャッチできます。キャッチした例外オブジェクトのgetterを使用することで，発生した例外名やフォルト情報（エラーの詳細）を取得できます。ビジネスプロセスでフォルト名を定義することで，サービスリクエスタで発生した例外が切り分けやすくなります。CSCMsgServerFaultException※の詳細については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「10.3.8　エラー情報を取得する」を参照してください。

注※

SOAP1.2の場合は，CSCMsgServerFault12Exceptionとなります。

サービス部品からユーザ定義例外以外のエラーがリターンした場合（ビジネスプロセスを使用するとき）

サービス部品からユーザ定義例外以外のエラーがリターンした場合でビジネスプロセスを使用するときのSOAP通信でのエラーの伝わり方を次の図に示します。

図7-31　サービス部品からユーザ定義例外以外のエラーがリターンした場合（ビジネスプロセスを使用するとき）のSOAP通信でのエラーの伝わり方

サービス部品側の通信基盤にCosminexusが提供しているSOAP通信基盤またはJAX-WSエンジンを使用している場合で，サービス部品でWSDLに定義していない想定外の例外（システム例外）が発生したときは，RuntimeExceptionとしてSOAPメッセージが伝わります。また，サービス部品側の通信基盤にJAX-WSエンジンを使用している場合や，Cosminexusが提供しているSOAP通信基盤を使用していない場合は，WSDLにSOAPフォルトを定義していてもHCSCサーバ内では例外として扱われます。

サービスアダプタからサービス部品を呼び出したときに発生したシステム例外は，サービスアダプタでフォルト電文に変換することもできます。

例外をフォルト電文に変換しない場合，ビジネスプロセスでは例外として処理して，標準受付にスローします。例外をフォルト電文に変換した場合，フォルトとしてビジネスプロセスでキャッチできます。システム例外をフォルト電文に変換する方法については，「7.11　例外発生時に取得するエラーの選択」を参照してください。

サービスリクエスタは，HCSCサーバがリターンするSOAPフォルトをCSCMsgServerFaultException※オブジェクトでキャッチできます。キャッチした例外オブジェクトのgetterを使用することで，発生したフォルト情報（エラーの詳細）を取得できます。CSCMsgServerFaultException※の詳細については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「10.3.8　エラー情報を取得する」を参照してください。

なお，サービス部品が応答したSOAPフォルトをHCSCサーバ内で例外ではなくSOAPフォルトのまま伝えたい場合は，SOAP Fault動作定義ファイルで定義します。SOAP Fault動作定義ファイルの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「SOAP Fault動作定義ファイル」を参照してください。

注※

SOAP1.2の場合は，CSCMsgServerFault12Exceptionとなります。

HCSCサーバからエラーがリターンした場合（ビジネスプロセスを使用するとき）

HCSCサーバからエラーがリターンした場合でビジネスプロセスを使用するときのSOAP通信でのエラーの伝わり方を次の図に示します。

図7-32　HCSCサーバからエラーがリターンした場合（ビジネスプロセスを使用するとき）のSOAP通信でのエラーの伝わり方

図中の各エラーには，次に示すケースが該当します。

エラー1：要求パラメタ不正，指定文字コード不正，各種フォーマット不正など

エラー2：あて先（ロケーション）が見つからない，アダプタが停止しているなど

エラー3：データ変換に失敗したなど

エラー4：あて先不正，サービス部品が停止，通信障害など

エラー5：ビジネスプロセス処理上での例外エラーなど

HCSCサーバで図中のエラー1～エラー3およびエラー5のどれかを検知した場合，発生したエラーの例外をサービスリクエスタにリターンします。図中のエラー4を検知した場合，発生したエラーの例外をサービスリクエスタにそのままリターンするか，サービスアダプタでエラーの例外をフォルト電文に変換するか選択できます。例外発生時に取得するエラーの選択方法については，「7.11　例外発生時に取得するエラーの選択」を参照してください。

サービスリクエスタは，HCSCサーバがリターンするSOAPフォルトをCSCMsgServerFaultException※オブジェクトでキャッチできます。キャッチした例外オブジェクトのgetterを使用することで，発生したフォルト情報（エラーの詳細）を取得できます。CSCMsgServerFaultException※の詳細については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「10.3.8　エラー情報を取得する」を参照してください。

注※

SOAP1.2の場合は，CSCMsgServerFault12Exceptionとなります。

サービスリクエスタでエラーを検知した場合

サービスリクエスタでエラーを検知した場合のSOAP通信でのエラーの伝わり方を次の図に示します。

図7-33　サービスリクエスタでエラーを検知した場合のSOAP通信でのエラーの伝わり方（標準受付の場合）

サービスリクエスタからHCSCサーバを呼び出せなかった場合や，サービス部品の呼び出しは完了したが何らかの原因でHCSCサーバからサービスリクエスタへの応答が返らなかった場合などは，サービスリクエスタ側（クライアント側）のSOAP通信基盤またはJAX-WSエンジンがエラーをリターンします。

サービスリクエスタ側の通信基盤にCosminexusが提供しているSOAP通信基盤を使用している場合は，C4Faultオブジェクトで例外をキャッチできます。キャッチした例外オブジェクトのgetterを使用することで，発生したフォルト情報（エラーの詳細）を取得できます。C4Faultの詳細については，マニュアル「Cosminexus アプリケーションサーバ SOAPアプリケーション開発の手引」の「13.3　C4Faultクラス（SOAP Fault情報の保持）」を参照してください。

なお，サービスリクエスタ側の通信基盤にJAX-WSエンジンを使用している場合は，SOAPFaultExceptionオブジェクトで例外をキャッチできます。また，Cosminexusが提供しているSOAP通信基盤を使用していない場合は，それぞれの通信基盤の実装に依存します。

(b)　ユーザ定義受付の場合

エラーの伝わり方は，エラーの種類やビジネスプロセスの有無によって異なります。

サービス部品からユーザ定義例外のエラーがリターンした場合（ビジネスプロセスを使用するとき）

サービス部品からユーザ定義例外のエラーがリターンした場合でビジネスプロセスを使用するときのSOAP通信でのエラーの伝わり方を次の図に示します。

図7-34　サービス部品からユーザ定義例外のエラーがリターンした場合（ビジネスプロセスを使用するとき）のSOAP通信でのエラーの伝わり方

サービス部品側の通信基盤にCosminexusが提供しているSOAP通信基盤またはJAX-WSエンジンを使用している場合で，サービス部品で例外をスローするコーディングをしている場合，サービス部品のWSDLにはユーザ定義例外が定義されます。サービス部品でユーザ定義例外が発生すると，そのエラーは，一度ビジネスプロセスでキャッチできます。

サービスリクエスタは，ユーザ定義受付に定義したWSDLを使用しますが，ビジネスプロセスから応答するフォルトをWSDLに定義することで，サービスリクエスタでもユーザ定義例外のSOAPフォルトとしてキャッチできます。これによって，サービスリクエスタでもサービス部品がリターンするSOAPフォルトと同じ名称および形式でキャッチすることができます。

キャッチした例外オブジェクトを解析するための情報は，サービス部品側のプログラムで作成する必要があります。なお，ビジネスプロセスでフォルト名を定義することで，サービスリクエスタで発生した例外が切り分けやすくなります。

ユーザ定義受付（Webサービス）に要求を出すサービスリクエスタでエラー情報を取得する方法については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「10.7.6　エラー情報を取得する」を参照してください。

サービス部品からユーザ定義例外以外のエラーがリターンした場合（ビジネスプロセスを使用するとき）

サービス部品からユーザ定義例外以外のエラーがリターンした場合でビジネスプロセスを使用するときのSOAP通信でのエラーの伝わり方を次の図に示します。

図7-35　サービス部品からユーザ定義例外以外のエラーがリターンした場合（ビジネスプロセスを使用するとき）のSOAP通信でのエラーの伝わり方

サービス部品側の通信基盤にCosminexusが提供しているSOAP通信基盤を使用している場合で，サービス部品でWSDLに定義していない想定外の例外（システム例外）が発生したときは，RuntimeExceptionとしてSOAPメッセージが伝わります。また，サービス部品側の通信基盤にJAX-WSエンジンを使用している場合や， Cosminexusが提供しているSOAP通信基盤を使用していない場合は，WSDLにSOAPフォルトを定義していてもHCSCサーバ内では例外として扱われます。

サービスアダプタからサービス部品を呼び出したときに発生したシステム例外は，サービスアダプタでフォルト電文に変換することもできます。

例外をフォルト電文に変換しない場合，ビジネスプロセスでは例外として処理して，ユーザ定義受付にスローします。例外をフォルト電文に変換した場合，フォルトとしてビジネスプロセスでキャッチできます。システム例外をフォルト電文に変換する方法については，「7.11　例外発生時に取得するエラーの選択」を参照してください。

HCSCサーバはCSCMsgServerFaultExceptionのSOAPフォルトでサービスリクエスタにリターンしますが，サービスリクエスタが使用するWSDLはユーザ定義受付に定義したWSDLで，このWSDLにはCSCMsgServerFaultExceptionが定義されていません。そのため，サービスリクエスタ側の通信基盤にCosminexusが提供しているSOAP通信基盤を使用している場合は，C4Faultオブジェクトで例外をキャッチします。キャッチした例外オブジェクトのgetterを使用することで，発生したフォルト情報（エラーの詳細）を取得できます。C4Faultの詳細については，マニュアル「Cosminexus アプリケーションサーバ SOAPアプリケーション開発の手引」の「13.3　C4Faultクラス（SOAP Fault情報の保持）」を参照してください。

なお，サービスリクエスタ側の通信基盤にJAX-WSエンジンを使用している場合は，SOAPFaultExceptionオブジェクトで例外をキャッチできます。また，Cosminexusが提供しているSOAP通信基盤を使用していない場合は，それぞれの通信基盤の実装に依存します。

サービス部品が応答したSOAPフォルトをHCSCサーバ内で例外ではなくSOAPフォルトのままで伝え，ビジネスプロセスでフォルトをキャッチしたい場合は，SOAP Fault動作定義ファイルで定義します。SOAP Fault動作定義ファイルの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「SOAP Fault動作定義ファイル」を参照してください。

HCSCサーバからエラーがリターンした場合（ビジネスプロセスを使用するとき）

HCSCサーバからエラーがリターンした場合でビジネスプロセスを使用するときのSOAP通信でのエラーの伝わり方を次の図に示します。

図7-36　HCSCサーバからエラーがリターンした場合（ビジネスプロセスを使用するとき）のSOAP通信でのエラーの伝わり方

図中の各エラーには，次に示すケースが該当します。

エラー1：指定文字コード不正，各種フォーマット不正など

エラー2：あて先（ロケーション）が見つからない，アダプタが停止しているなど

エラー3：データ変換に失敗したなど

エラー4：あて先不正，サービス部品が停止，通信障害など

エラー5：ビジネスプロセス処理上での例外エラーなど

HCSCサーバで図中のエラー1～エラー3およびエラー5のどれかを検知した場合，発生したエラーの例外をサービスリクエスタにリターンします。図中のエラー4を検知した場合，発生したエラーの例外をサービスリクエスタにそのままリターンするか，サービスアダプタでエラーの例外をフォルト電文に変換するか選択できます。例外発生時に取得するエラーの選択方法については，「7.11　例外発生時に取得するエラーの選択」を参照してください。

HCSCサーバはCSCMsgServerFaultExceptionのSOAPフォルトでサービスリクエスタにリターンしますが，サービスリクエスタが使用するWSDLはユーザ定義受付に定義したWSDLで，このWSDLにはCSCMsgServerFaultExceptionが定義されていません。そのため，サービスリクエスタ側の通信基盤にCosminexusが提供しているSOAP通信基盤を使用している場合は，C4Faultオブジェクトで例外をキャッチします。キャッチした例外オブジェクトのgetterを使用することで，発生したフォルト情報（エラーの詳細）を取得できます。C4Faultの詳細については，マニュアル「Cosminexus アプリケーションサーバ SOAPアプリケーション開発の手引」の「13.3　C4Faultクラス（SOAP Fault情報の保持）」を参照してください。

なお，サービスリクエスタ側の通信基盤にJAX-WSエンジンを使用している場合は，SOAPFaultExceptionオブジェクトで例外をキャッチできます。また，Cosminexusが提供しているSOAP通信基盤を使用していない場合は，それぞれの通信基盤の実装に依存します。

サービスリクエスタでエラーを検知した場合

サービスリクエスタでエラーを検知した場合のSOAP通信でのエラーの伝わり方を次の図に示します。

図7-37　サービスリクエスタでエラーを検知した場合のSOAP通信でのエラーの伝わり方（ユーザ定義受付の場合）

あて先不正，HCSCサーバが停止，通信障害などで，サービスリクエスタからHCSCサーバを呼び出せなかった場合や，サービス部品の呼び出しは完了したが何らかの原因でHCSCサーバからサービスリクエスタへの応答が返らなかった場合などでは，サービスリクエスタ側（クライアント側）のSOAP通信基盤またはJAX-WSエンジンがエラーをリターンします。

サービスリクエスタ側の通信基盤にCosminexusが提供しているSOAP通信基盤を使用している場合は，C4Faultオブジェクトで例外をキャッチできます。キャッチした例外オブジェクトのgetterを使用することで，発生したフォルト情報（エラーの詳細）を取得できます。C4Faultの詳細については，マニュアル「Cosminexus アプリケーションサーバ SOAPアプリケーション開発の手引」の「13.3　C4Faultクラス（SOAP Fault情報の保持）」を参照してください。

なお，サービスリクエスタ側の通信基盤にJAX-WSエンジンを使用している場合は，SOAPFaultExceptionオブジェクトで例外をキャッチできます。また，Cosminexusが提供しているSOAP通信基盤を使用していない場合は，それぞれの通信基盤の実装に依存します。

(2)　問題発生個所の切り分け方

標準受付の場合とユーザ定義受付の場合とで問題発生個所の切り分け方が異なります。なお，SOAPによる通信ができない場合の問題発生個所の切り分けについては，マニュアル「Cosminexus アプリケーションサーバ SOAPアプリケーション開発の手引」の「14.3　問題発生個所の切り分け」を参照してください。

(a)　標準受付の場合

サービスリクエスタから標準受付（Webサービス）を使用してサービス部品を呼び出した場合の問題発生個所の切り分け方について次の図に示します。

図7-38　問題発生個所の切り分け方（サービスリクエスタから標準受付（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サーバ内で検知したエラーのエラーコードを取得します。

また，Cosminexus サービスプラットフォームが出力するメッセージログも参照して，調査します。

要因は，次の観点で調査してください。

サービスリクエスタから要求した引数の内容

HCSCサーバの設定または状態

サービスアダプタの定義内容査

ビジネスプロセスの定義内容

サービスリクエスタから要求したユーザ電文

サービス部品稼働マシン

サービス部品のプログラム

ネットワークの状態

次に示す処理が常に実行されているかを確認することで，問題発生個所を絞り込めます。

1. サービスアダプタ（クライアント）からSOAPメッセージが正しく出力されているか。

2. SOAPメッセージはサービス部品稼働マシン（サーバ）のSOAP通信基盤またはJAX-WSエンジンに届いているか。

3. サービス部品稼働マシン（サーバ）のサービス部品でメッセージが処理できているか。

4. サービス部品稼働マシン（サーバ）のサービス部品からの返信用SOAPメッセージは正しく出力されているか。

5. サービス部品稼働マシン（サーバ）のサービス部品からの返信用SOAPメッセージはサービスアダプタ（クライアント）のSOAP通信基盤またはJAX-WSエンジンに届いているか。

確認するときはSOAP通信基盤またはJAX-WSエンジンが出力する障害情報を参照します。障害情報の取得方法については，「7.3.2(3) SOAP通信基盤またはJAX-WSエンジンが出力する障害情報の取得方法」を参照してください。

SOAP通信基盤が出力する障害情報の形式については，マニュアル「Cosminexus アプリケーションサーバ SOAPアプリケーション開発の手引」の「14.　障害対策」を参照してください。JAX-WSエンジンが出力する障害情報の形式については，マニュアル「Cosminexus アプリケーションサーバ Webサービス開発の手引」の「29.　障害対策」を参照してください。

なお，SOAP通信基盤またはJAX-WSエンジンが出力するアプリケーションログを取得することで，サービスアダプタとサービス部品間で送受信している電文データを確認できます。

サービス部品の呼び出しを再送するかどうかは，エラーの内容によって異なります。

一時的な障害の場合は，再送を試みることで成功することがありますが，次に示すエラーの場合は，再送を試みてもエラーとなります。

サービスリクエスタから要求した引数の内容が誤っている場合

HCSCサーバの設定に誤りがある場合

サービスアダプタやビジネスプロセスの定義に誤りがある場合

サービスリクエスタから要求したユーザ電文に誤りがある場合など

(iv)通信基盤でエラーを検知した場合（C4Faultの場合）

SOAP通信基盤が提供するC4Faultからエラーの内容を取得できます。取得したエラーコードおよびエラーメッセージの対策に従って対処します。

C4Faultの詳細については，マニュアル「Cosminexus アプリケーションサーバ SOAPアプリケーション開発の手引」の「13.3　C4Faultクラス（SOAP Fault情報の保持）」を参照してください。

要因は，次の観点で調査してください。

サービスリクエスタで使用しているWSDL

サービスリクエスタ稼働マシンのSOAP通信基盤の設定または状態

HCSCサーバの設定または状態

ネットワークの状態

次に示す処理が常に実行されているかを確認することで，問題発生個所を絞り込めます。

1. サービスリクエスタ（クライアント）からSOAPメッセージが正しく出力されているか。

2. SOAPメッセージはHCSCサーバ稼働マシン（サーバ）のSOAP通信基盤に届いているか。

3. HCSCサーバ稼働マシン（サーバ）のサービス部品からの返信用SOAPメッセージは正しく出力されているか。

4. HCSCサーバ稼働マシン（サーバ）のサービス部品からの返信用SOAPメッセージはサービスリクエスタ（クライアント）のSOAP通信基盤に届いているか。

確認するときはSOAP通信基盤が出力する障害情報を参照します。障害情報の取得方法については，「7.3.2(3) SOAP通信基盤またはJAX-WSエンジンが出力する障害情報の取得方法」を参照してください。

SOAP通信基盤が出力する障害情報の形式については，マニュアル「Cosminexus アプリケーションサーバ SOAPアプリケーション開発の手引」の「14.　障害対策」を参照してください。

なお，SOAP通信基盤が出力するアプリケーションログを取得することで，サービスリクエスタとHCSCサーバ間で送受信している電文データを確認できます。

サービス部品の呼び出しを再送するかどうかは，エラーの内容によって異なります。一時的な障害の場合は，再送を試みることで成功することがありますが，次に示すエラーの場合は，再送を試みてもエラーとなります。

サービスリクエスタで使用しているWSDLが誤っている場合

サービスリクエスタ稼働マシンのSOAP通信基盤の設定に誤りがある場合

HCSCサーバの設定に誤りがある場合

(b)　ユーザ定義受付の場合

サービスリクエスタからユーザ定義受付（Webサービス）を使用してサービス部品呼び出した場合の問題発生個所の切り分け方について次の図に示します。

図7-39　問題発生個所の切り分け方（サービスリクエスタからユーザ定義受付（Webサービス）を使用してサービス部品呼び出した場合）

(i)サービス部品に障害の要因がある場合（サービス部品で定義したユーザ定義例外の場合）

サービス部品に障害の要因があるおそれがあります。エラーの情報は，サービス部品で定義した内容になります（キャッチした例外オブジェクトの解析するための情報は，サービス部品側のプログラムで作成する必要があります）。

要因は，次の観点で調査してください。

サービスリクエスタから要求したユーザ電文

サービス部品稼働マシン

サービス部品のプログラム

サービス部品の呼び出しを再送するかどうかは，HCSCサーバを介したサービスリクエスタとサービス部品間（エンドツーエンド）の取り決めとなります。

(ii)ビジネスプロセスに障害の要因がある場合（ビジネスプロセスで定義したフォルトの場合）

ビジネスプロセスで実行したアクティビティの処理に障害の要因があるおそれがあります（サービス呼出アクティビティの場合，呼び出したサービス部品に障害の要因があるおそれがあります）。

エラーの情報は，ビジネスプロセスで定義したフォルトの内容になります（キャッチした例外オブジェクトを解析するための情報は，ビジネスプロセスを定義するときに設定しておく必要があります）。

要因は，次の観点で調査してください。

サービスリクエスタから要求したユーザ電文

サービス部品稼働マシン

サービス部品のプログラム

ビジネスプロセスの定義内容

サービス部品の呼び出しを再送するかどうかは，HCSCサーバを介したサービスリクエスタとサービス部品間（エンドツーエンド）の取り決めとなります。

また，ビジネスプロセスの設計内容によっても，再送（ビジネスプロセスの再実行）するかどうかシステム設計する必要があります。

(iii)HCSCサーバでエラーを検知した場合（CSCMsgServerFaultExceptionの場合）

SOAP通信基盤が提供するC4Faultからエラーの内容を取得できます。取得したエラーコードおよびエラーメッセージの対策に従って対処します。サービスリクエスタでC4Faultからエラー情報を取得するときの実装方法については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「10.7.6　エラー情報を取得する」を参照してください。C4Faultの詳細については，マニュアル「Cosminexus アプリケーションサーバ SOAPアプリケーション開発の手引」の「13.3　C4Faultクラス（SOAP Fault情報の保持）」を参照してください。また，Cosminexus サービスプラットフォームが出力するメッセージログも参照して，調査します。

要因は，次の観点で調査してください。

サービスリクエスタから要求した引数の内容

HCSCサーバの設定または状態

サービスアダプタの定義内容

ビジネスプロセスの定義内容

サービスリクエスタから要求したユーザ電文

サービス部品稼働マシン

サービス部品のプログラム

ネットワークの状態

次に示す処理が常に実行されているかを確認することで，問題発生個所を絞り込めます。

1. サービスアダプタ（クライアント）からSOAPメッセージが正しく出力されているか。

2. SOAPメッセージはサービス部品稼働マシン（サーバ）のSOAP通信基盤に届いているか。

3. サービス部品稼働マシン（サーバ）のサービス部品でメッセージが処理できているか。

4. サービス部品稼働マシン（サーバ）のサービス部品からの返信用SOAPメッセージは正しく出力されているか。

5. サービス部品稼働マシン（サーバ）のサービス部品からの返信用SOAPメッセージはサービスアダプタ（クライアント）のSOAP通信基盤に届いているか。

確認するときはSOAP通信基盤が出力する障害情報を参照します。障害情報の取得方法については，「7.3.2(3) SOAP通信基盤またはJAX-WSエンジンが出力する障害情報の取得方法」を参照してください。

SOAP通信基盤が出力する障害情報の形式については，マニュアル「Cosminexus アプリケーションサーバ SOAPアプリケーション開発の手引」の「14.　障害対策」を参照してください。

なお，SOAP通信基盤が出力するアプリケーションログを取得することで，サービスアダプタとサービス部品間で送受信している電文データを確認できます。

サービス部品の呼び出しを再送するかどうかは，エラーの内容によって異なります。一時的な障害の場合は，再送を試みることで成功することがありますが，次に示すエラーの場合は，再送を試みてもエラーとなります。

サービスリクエスタから要求した引数の内容が誤っている場合

HCSCサーバの設定に誤りがある場合

サービスアダプタやビジネスプロセスの定義に誤りがある場合

サービスリクエスタから要求したユーザ電文に誤りがある場合など

(iv)通信基盤でエラーを検知した場合（(i)～(iii)以外の場合）

SOAP通信基盤が提供するC4Faultからエラーの内容を取得できます。取得したエラーコードおよびエラーメッセージの対策に従って対処してください。

サービスリクエスタでC4Faultからエラー情報を取得するときの実装方法については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「10.7.6　エラー情報を取得する」を参照してください。C4Faultの詳細については，マニュアル「Cosminexus アプリケーションサーバ SOAPアプリケーション開発の手引」の「13.3　C4Faultクラス（SOAP Fault情報の保持）」を参照してください。また，Cosminexus サービスプラットフォームが出力するメッセージログも参照して，調査します。

要因は，次の観点で調査してください。

サービスリクエスタで使用しているWSDL

サービスリクエスタ稼働マシンのSOAP通信基盤の設定または状態

HCSCサーバの設定または状態

ネットワークの状態

次に示す処理が常に実行されているかを確認することで，問題発生個所を絞り込めます。

1. サービスリクエスタ（クライアント）からSOAPメッセージが正しく出力されているか。

2. SOAPメッセージはHCSCサーバ稼働マシン（サーバ）のSOAP通信基盤に届いているか。

3. HCSCサーバ稼働マシン（サーバ）のサービス部品からの返信用SOAPメッセージは正しく出力されているか。

4. HCSCサーバ稼働マシン（サーバ）のサービス部品からの返信用SOAPメッセージはサービスリクエスタ（クライアント）のSOAP通信基盤に届いているか。

確認するときはSOAP通信基盤が出力する障害情報を参照します。障害情報の取得方法については，「7.3.2(3) SOAP通信基盤またはJAX-WSエンジンが出力する障害情報の取得方法」を参照してください。

SOAP通信基盤が出力する障害情報の形式については，マニュアル「Cosminexus アプリケーションサーバ 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-53　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エンジンからエラー通知します。

(b)　SOAP1.2の場合

SOAP1.2を利用している場合のSOAP Faultの要素と，エラー時に設定される情報の対応を次の表に示します。

エラーのケースの番号は「7.7.1(2) 問題発生個所の切り分け方」で示す番号に相当します。

表7-54　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エンジンからエラー通知します。

(4)　そのほかの障害要因の特定方法（サービス部品呼び出し要求の実行履歴の追跡）

ビジネスプロセスを使用する場合には，サービスリクエスタへ応答した例外およびエラーメッセージから問題発生個所を切り分ける方法のほかに，サービスリクエスタ側で設定したクライアント相関IDや，ビジネスプロセスの相関セットを基に問題発生個所を特定する方法があります。ここでは，ビジネスプロセスを使用する場合に，クライアント相関IDや，ビジネスプロセスの相関セットを基にしてサービス部品呼び出し要求の実行履歴を追跡する手順について説明します。サービス部品呼び出し要求の実行履歴の追跡を次の図に示します。

図7-40　サービス部品呼び出し要求の実行履歴の追跡（Webサービスの場合）

実行履歴の追跡の基本的な流れは次のようになります。

要求時に，受付ごとに次の指定をします。

標準受付の場合
要求時のパラメタにクライアント相関IDを指定，または要求電文に相関セットを指定します。

ユーザ定義受付の場合
要求電文に相関セットを指定します。

エラーが発生したときのメッセージ共通IDを取得することで，障害が発生したビジネスプロセスのインスタンスを特定します。

データベースに出力されているプロセスインスタンスの実行履歴を検索し，メッセージ共通IDと対応したビジネスプロセスのプロセスIDを取得します。
プロセスIDを使ってアクティビティの状態を知ることができ，それによってどこの処理で止まっているのかや，どこまで処理が進んでいるのかがわかります。

メッセージ共通IDを使って，電文の実行履歴からユーザ電文を取得します。
電文の内容を確認でき，障害調査の原因究明に役立ちます。

サービス部品呼び出し要求の実行履歴を追跡するには，主に次の二つの方法があります。

(a)サービスリクエスタから指定したクライアント相関IDからたどる方法

(b)ユーザ電文に指定したビジネスプロセスの相関セットからたどる方法

(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　プロセスインスタンスの実行履歴を検索する」を，コマンドの文法については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscpiselect（プロセスインスタンスの検索）」を参照してください。

取得したプロセスIDを基に，プロセスインスタンスの実行履歴を参照して，ビジネスプロセスのアクティビティとその状態を取得します。アクティビティの情報を取得するには，プロセスインスタンスの検索（cscpiselect）コマンドを使用します。
cscpiselectコマンドでは，開始日時とビジネスプロセス名（サービス名）を条件に，プロセスインスタンスの実行履歴を検索します。
また，-tableオプションに"activity"を指定し，検索条件（where句）にSQL条件を指定して，該当するアクティビティ情報を表示します。
状態が"Executing"となっている個所が現在実行中のアクティビティです。状態を確認することで，どのアクティビティで止まっているかがわかります。

cscpiselectコマンドの使い方については「6.1.2　プロセスインスタンスの実行履歴を検索する」を，コマンドの文法については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscpiselect（プロセスインスタンスの検索）」を参照してください。

電文の実行履歴を採取する設定をし，さらに電文の実行履歴の電文データ（ユーザ電文）を採取する設定をしている場合，ユーザ電文の内容を確認できます。
実行履歴の採取については，HCSCサーバランタイム定義で設定します。詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「HCSCサーバランタイム定義ファイル」を参照してください。
電文の実行履歴を取得するには，電文の実行履歴情報の表示（csmlshistory）コマンドを使用します。
csmlshistoryコマンドでは，メッセージ共通IDを条件として電文の実行履歴を検索します（クライアント相関IDや日時から検索することもできます）。
csmlshistoryコマンドの使い方については「6.2.3　電文の実行履歴を利用する」を，コマンドの文法についてはマニュアル「Cosminexus サービスプラットフォーム リファレンス」の「csmlshistory（電文の実行履歴情報の表示）」を参照してください。

(b)　ユーザ電文に指定したビジネスプロセスの相関セットからたどる方法

ユーザ電文に指定したビジネスプロセスの相関セットからたどる手順を次に示します。

相関セットを調査します。
相関セットは，サービス部品呼び出しを要求するサービスリクエスタ側のプログラムで，要求時のユーザ電文に設定する情報です。サービスリクエスタからHCSCサーバを介してサービス部品に送信する要求電文を一意に識別するために利用する文字列です。
HCSCサーバからの応答は，相関セットを含んだ応答電文をサービスリクエスタに返信します。その結果，サービスリクエスタは受信した応答電文が，どの要求電文に対する応答であるのかを一意に識別できます。
相関セットを使用するには，開発環境でのビジネスプロセス定義時に定義する必要があります。詳細については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「6.5.2　相関セットの定義」を参照してください。

サービス部品呼び出し要求の実行履歴を追跡する場合，サービスリクエスタ側の要求者からシステム管理者に障害調査を依頼するときに，相関セットと要求したビジネスプロセス名（サービス名）を伝え，システム管理者はその情報を基に実行履歴を追跡します。
サービスリクエスタ利用者が相関セットの値をとらえていない場合は，HCSCサーバにインポートしたリポジトリを開発環境で参照して，該当のビジネスプロセスの相関セットを調査する必要があります。相関セットの調査方法は次のとおりです。
1. ビジネスプロセス定義画面の［変数・相関セット］アイコンをダブルクリックします。
　変数・相関セット一覧ダイアログが表示されます。
2. 変数・相関セット一覧ダイアログの「表示」ボタンをクリックします。
　変数の表示ダイアログが表示されます。
3. ユーザ電文と変数表示ダイアログのXMLスキーマを突き合わせて，相関セットへのパスを取得します。
4. 変数・相関セット一覧ダイアログを使って，パス名から変数名や部分名を取得し，変数・相関セット一覧ダイアログから同じ変数名や部分名を持つ相関セットを探して相関セット名を取得します。

取得した相関セットを基に，プロセスインスタンスの実行履歴を参照して，ビジネスプロセスのプロセスIDを取得します。プロセスIDを取得するには，プロセスインスタンスの検索（cscpiselect）コマンドを使用します。
cscpiselectコマンドでは，相関セットを条件としてプロセスインスタンスの実行履歴を検索します。
また，-tableオプションに"process_set"を指定し，検索条件（where句）にSQL条件を指定し，該当するプロセス概要情報を表示します。

cscpiselectコマンドの使い方については「6.1.2　プロセスインスタンスの実行履歴を検索する」を，コマンドの文法については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscpiselect（プロセスインスタンスの検索）」を参照してください。

取得したプロセスIDを基に，プロセスインスタンスの実行履歴を参照して，ビジネスプロセスのアクティビティとその状態を取得します。アクティビティの情報を取得するには，プロセスインスタンスの検索（cscpiselect）コマンドを使用します。
cscpiselectコマンドでは，開始日時とビジネスプロセス名（サービス名）を条件としてプロセスインスタンスの実行履歴を検索します。
また，-tableオプションに"activity"を指定し，検索条件に該当するアクティビティ情報を表示します。
状態が"Executing"となっている個所が現在実行中のアクティビティです。状態を確認することで，どのアクティビティで止まっているかがわかります。

cscpiselectコマンドの使い方については「6.1.2　プロセスインスタンスの実行履歴を検索する」を，コマンドの文法については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「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のリクエスト受付を使用し，サービスリクエスタを実装する。

DBで保持されている情報をcsmlshistoryコマンドで確認する。

HCSCサーバのメッセージログを確認する（Detail情報を除いたFault情報が出力される）。

7.7.2　SessionBean実行時の障害対策

＜この項の構成＞

(1)　SessionBeanでの通信でのエラーの伝わり方

(2)　問題発生個所の切り分け方

(3)　HCSCサーバから応答する例外の内容

(4)　そのほかの障害要因の特定方法（サービス部品呼び出し要求の実行履歴の追跡）

(1)　SessionBeanでの通信でのエラーの伝わり方

サービスリクエスタから標準受付を使用してサービス部品を呼び出す場合のエラーの伝わり方を説明します。エラーの伝わり方は，エラーの種類やビジネスプロセスの有無によって異なります。

サービス部品からユーザ定義例外のエラーがリターンした場合（ビジネスプロセスを使用しないとき）

サービス部品からユーザ定義例外のエラーがリターンした場合でビジネスプロセスを使用しないときのSessionBeanでの通信でのエラーの伝わり方を次の図に示します。

図7-41　サービス部品からユーザ定義例外のエラーがリターンした場合（ビジネスプロセスを使用しないとき）のSessionBeanでの通信でのエラーの伝わり方

サービス部品で発生した例外は，そのまま例外としてHCSCサーバに伝わります。例外をキャッチしたHCSCサーバはサービスリクエスタに対してCSCMsgServerExceptionをスローします。キャッチした例外オブジェクトのgetterを使用することで，発生した例外名や例外の内容（エラーの詳細）を取得できます。CSCMsgServerExceptionの詳細については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「10.4.7　エラー情報を取得する」を参照してください。

サービス部品からユーザ定義例外以外のエラーがリターンした場合（ビジネスプロセスを使用しないとき）

サービス部品からユーザ定義例外以外のエラーがリターンした場合でビジネスプロセスを使用しないときのSessionBeanでの通信でのエラーの伝わり方を次の図に示します。

図7-42　サービス部品からユーザ定義例外以外のエラーがリターンした場合（ビジネスプロセスを使用しないとき）のSessionBeanでの通信でのエラーの伝わり方

サービス部品で想定外の例外が発生した場合，RuntimeException（システム例外）としてHCSCサーバに伝わります。

サービスアダプタからサービス部品を呼び出したときに発生したシステム例外は，サービスアダプタでフォルト電文に変換することもできます。システム例外をフォルト電文に変換する方法については，「7.11　例外発生時に取得するエラーの選択」を参照してください。

例外をキャッチしたHCSCサーバはサービスリクエスタに対してCSCMsgServerExceptionをスローします。キャッチした例外オブジェクトのgetterを使用することで，発生した例外の内容（エラーの詳細）を取得できます。CSCMsgServerExceptionの詳細については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「10.4.7　エラー情報を取得する」を参照してください。

HCSCサーバからエラーがリターンした場合（ビジネスプロセスを使用しないとき）

HCSCサーバからエラーがリターンした場合でビジネスプロセスを使用しないときのSessionBeanでの通信でのエラーの伝わり方を次の図に示します。

図7-43　HCSCサーバからエラーがリターンした場合（ビジネスプロセスを使用しないとき）のSessionBeanでの通信でのエラーの伝わり方

図中の各エラーには，次に示すケースが該当します。

エラー1：要求パラメタ不正など

エラー2：あて先（ロケーション）が見つからない，アダプタが停止しているなど

エラー3：データ変換に失敗したなど

エラー4：あて先不正，サービス部品が停止，通信障害など

HCSCサーバで図中のエラー1～エラー3のどれかを検知した場合，発生したエラーの情報をCSCMsgServerExceptionでサービスリクエスタにスローします。図中のエラー4を検知した場合，発生したエラーの例外をサービスリクエスタにそのままスローするか，サービスアダプタでエラーの例外をフォルト電文に変換するか選択できます。例外発生時に取得するエラーの選択方法については，「7.11　例外発生時に取得するエラーの選択」を参照してください。

サービスリクエスタは，キャッチした例外オブジェクトのgetterを使用することで，発生した例外の内容（エラーの詳細）を取得できます。CSCMsgServerExceptionの詳細については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「10.4.7　エラー情報を取得する」を参照してください。

サービス部品からユーザ定義例外のエラーがリターンした場合（ビジネスプロセスを使用するとき）

サービス部品からユーザ定義例外のエラーがリターンした場合でビジネスプロセスを使用するときのSessionBeanでの通信でのエラーの伝わり方を次の図に示します。

図7-44　サービス部品からユーザ定義例外のエラーがリターンした場合（ビジネスプロセスを使用するとき）のSessionBeanでの通信でのエラーの伝わり方

サービス部品でユーザ定義例外が発生すると，そのエラーは，一度ビジネスプロセスでキャッチします。ビジネスプロセスでサービス部品が失敗したことを示す例外に変換し，例外を伝えます。その後，サービスリクエスタに対してCSCMsgServerExceptionをスローします。キャッチした例外オブジェクトのgetterを使用することで，発生した例外の内容（エラーの詳細）を取得できます。CSCMsgServerExceptionの詳細については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「10.4.7　エラー情報を取得する」を参照してください。

サービス部品からユーザ定義例外以外のエラーがリターンした場合（ビジネスプロセスを使用するとき）

サービス部品からユーザ定義例外以外のエラーがリターンした場合でビジネスプロセスを使用するときのSessionBeanでの通信でのエラーの伝わり方を次の図に示します。

図7-45　サービス部品からユーザ定義例外以外のエラーがリターンした場合（ビジネスプロセスを使用するとき）のSessionBeanでの通信でのエラーの伝わり方

サービス部品で想定外の例外が発生した場合，発生した例外をサービスリクエスタにそのままリターンするか，サービスアダプタで例外をフォルト電文に変換するか選択できます。例外をフォルト電文に変換する方法については，「7.11　例外発生時に取得するエラーの選択」を参照してください。

例外をフォルト電文に変換しない場合，そのエラーは一度ビジネスプロセスでキャッチします。ビジネスプロセスでサービス部品が失敗したことを示す例外に変換し，例外を伝えます。その後，サービスリクエスタに対してCSCMsgServerExceptionをスローします。

例外をフォルト電文に変換した場合，フォルトとしてビジネスプロセスでキャッチできます。

キャッチした例外オブジェクトのgetterを使用することで，発生した例外の内容（エラーの詳細）を取得できます。CSCMsgServerExceptionの詳細については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「10.4.7　エラー情報を取得する」を参照してください。

HCSCサーバからエラーがリターンした場合（ビジネスプロセスを使用するとき）

HCSCサーバからエラーがリターンした場合でビジネスプロセスを使用するときのSessionBeanでの通信でのエラーの伝わり方を次の図に示します。

図7-46　HCSCサーバからエラーがリターンした場合（ビジネスプロセスを使用するとき）のSessionBeanでの通信でのエラーの伝わり方

図中の各エラーには，次に示すケースが該当します。

エラー1：要求パラメタ不正など

エラー2：あて先（ロケーション）が見つからない，アダプタが停止しているなど

エラー3：データ変換に失敗したなど

エラー4：あて先不正，サービス部品が停止，通信障害など

エラー5：ビジネスプロセス処理上での例外エラーなど

HCSCサーバで図中のエラー1～エラー3およびエラー5のどれかを検知した場合，発生したエラーの情報をCSCMsgServerExceptionでサービスリクエスタにスローします。図中のエラー4を検知した場合，発生したエラーの例外をサービスリクエスタにそのままスローするか，サービスアダプタでエラーの例外をフォルト電文に変換するか選択できます。例外発生時に取得するエラーの選択方法については，「7.11　例外発生時に取得するエラーの選択」を参照してください。

サービスリクエスタは，キャッチした例外オブジェクトのgetterを使用することで，発生した例外の内容（エラーの詳細）を取得できます。CSCMsgServerExceptionの詳細については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「10.4.7　エラー情報を取得する」を参照してください。

サービスリクエスタでエラーを検知した場合

サービスリクエスタでエラーを検知した場合のSessionBeanでの通信でのエラーの伝わり方を次の図に示します。

図7-47　サービスリクエスタでエラーを検知した場合のSessionBeanでの通信でのエラーの伝わり方

サービスリクエスタからHCSCサーバを呼び出せなかった場合や，サービス部品の呼び出しは完了したが何らかの原因でHCSCサーバからサービスリクエスタへの応答が返らなかった場合などは，サービスリクエスタ側（クライアント側）のスタブ（J2EEコンテナ）がエラーをリターンします。サービスリクエスタはRuntimeExceptionで例外をキャッチできます。キャッチした例外オブジェクトのgetterを使用することで，発生したフォルト情報（エラーの詳細）を取得できます。

(2)　問題発生個所の切り分け方

サービスリクエスタから標準受付（SessionBean）を使用してサービス部品を呼び出した場合の問題発生個所の切り分け方について説明します。問題発生個所の切り分け方を次の図に示します。

図7-48　問題発生個所の切り分け方（サービスリクエスタから標準受付（SessionBean）を使用してサービス部品を呼び出した場合）

(i)サービス部品に障害の要因がある場合（サービス部品で定義したユーザ定義例外の場合）

サービス部品に障害の要因があるおそれがあります。次のメソッドを使用してサービス部品が返した例外の内容を取得できます。

getErrorMessage：サービス部品からの例外の内容を取得します。

getErrorCode：サービス部品からの例外の内容に対応するエラーコードを取得します。

要因は，次の観点で調査してください。

サービスリクエスタから要求したユーザ電文

サービス部品稼働マシン

サービス部品のプログラム

サービス部品の呼び出しを再送するかどうかは，HCSCサーバを介したサービスリクエスタとサービス部品間（エンドツーエンド）の取り決めとなります。

(ii)ビジネスプロセスに障害の要因がある場合（ビジネスプロセスで定義したフォルトの場合）

ビジネスプロセスで実行したアクティビティの処理に障害の要因があるおそれがあります（サービス呼出アクティビティの場合，呼び出したサービス部品に障害の要因があるおそれがあります）。次のメソッドを使用してビジネスプロセスが返したフォルトの内容を取得できます。

getErrorMessage：ビジネスプロセスからの例外の内容を取得します。

getErrorCode：ビジネスプロセスからの例外の内容に対応するエラーコードを取得します。

getCscmsgFaultCode：FaultCode情報を取得します。

getCscmsgFaultString：FaultString情報を取得します。

getCscmsgFaultActor：FaultActor情報を取得します。

getCscmsgFaultDetail：FaultDetail情報を取得します。

要因は，次の観点で調査してください。

サービスリクエスタから要求したユーザ電文

サービス部品稼働マシン

サービス部品のプログラム

ビジネスプロセスの定義内容

サービス部品の呼び出しを再送するかどうかは，HCSCサーバを介したサービスリクエスタとサービス部品間（エンドツーエンド）の取り決めとなります。

また，ビジネスプロセスの設計内容によっても，再送（ビジネスプロセスの再実行）するかどうかシステム設計する必要があります。

(iii)HCSCサーバでエラーを検知した場合（例外名が設定されていない場合）

次のメソッドを使用してエラーの内容を取得できます。取得したエラーコードおよびエラーメッセージの対策に従って対処します。

getErrorMessage：HCSCサーバ内で検知したエラーのエラーメッセージを取得します。

getErrorCode：HCSCサーバ内で検知したエラーのエラーコードを取得します。

また，Cosminexus サービスプラットフォームが出力するメッセージログも参照して，調査します。

要因は，次の観点で調査してください。

サービスリクエスタから要求した引数の内容

HCSCサーバの設定または状態

サービスアダプタの定義内容

ビジネスプロセスの定義内容

サービスリクエスタから要求したユーザ電文

サービス部品稼働マシン

サービス部品のプログラム

ネットワークの状態

サービス部品呼び出しを再送するかどうかは，エラーの内容によって異なります。一時的な障害の場合は，再送を試みることで成功することがありますが，次に示すエラーの場合は，再送を試みてもエラーとなります。

サービスリクエスタから要求した引数の内容が誤っている場合

HCSCサーバの設定に誤りがある場合

サービスアダプタやビジネスプロセスの定義に誤りがある場合

サービスリクエスタから要求したユーザ電文に誤りがある場合など

(iv)通信基盤でエラーを検知した場合（RuntimeExceptionの場合）

RuntimeExceptionからエラーの内容を取得できます。取得した例外のエラー情報を基に対処してください。

要因は，次の観点で調査してください。

サービスリクエスタで使用しているスタブ

サービスリクエスタ稼働マシンのJ2EEコンテナの設定または状態

HCSCサーバの設定または状態

ネットワークの状態

サービス部品の呼び出しを再送するかどうかは，エラーの内容によって異なります。一時的な障害の場合は，再送を試みることで成功することがありますが，次に示すエラーの場合は，再送を試みてもエラーとなります。

サービスリクエスタで使用しているスタブが誤っている場合

サービスリクエスタ稼働マシンのJ2EEコンテナの設定に誤りがある場合

HCSCサーバの設定に誤りがある場合

(3)　HCSCサーバから応答する例外の内容

HCSCサーバから応答するSOAP Fault（SOAPメッセージ）について，どの要素に何の情報が設定されるかを示します。HCSCサーバから応答する例外の内容を次の表に示します。エラーのケースの番号は「7.7.2(2) 問題発生個所の切り分け方」で示す番号に相当します。

表7-55　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）からサービスアダプタ（Webサービス）のサービス部品を呼び出した場合，(ii)の場合と同様にFault情報が設定されます。

(4)　そのほかの障害要因の特定方法（サービス部品呼び出し要求の実行履歴の追跡）

サービスリクエスタへ応答した例外およびエラーメッセージから問題発生個所を切り分ける方法のほかに，サービスリクエスタ側で設定したクライアント相関IDや，ビジネスプロセスの相関セットを基に問題発生個所を特定する方法があります。サービス部品呼び出し要求の実行履歴の追跡を次の図に示します。

図7-49　サービス部品呼び出し要求の実行履歴の追跡（SessionBeanの場合）

特定方法やビジネスプロセスを使用する場合の手順については，Webサービス（SOAP通信）の場合の手順と同様です。詳細については，「7.7.1　Webサービス（SOAP通信）実行時の障害対策」を参照してください。

ここでは，SessionBeanの場合にだけ該当する手順について説明します。

(a)　サービスリクエスタから指定したクライアント相関IDからたどる方法

サービスリクエスタから指定したクライアント相関IDからたどる手順を次に示します。

クライアント相関IDを調査します。

メッセージ共通IDを取得します。

ビジネスプロセスのプロセスIDを取得します。

アクティビティの状態を取得します。

ユーザ電文を確認します。
詳細については，「7.7.1　Webサービス（SOAP通信）実行時の障害対策」を参照してください。

性能解析トレースを使ってさらに調査し，問題が発生した個所をより細かく特定できます。また，性能解析トレースのスレッドIDをたどることで，サービス部品稼働マシンのログとの対応を確認できます。次のように確認します。
1. メッセージ共通IDと一致する文字列を含む行を検索します。
　HCSCサーバのリクエスト受付の入口で「ASCII」列に出力されているため，そこが最初に検索されます。
2. 検索で一致した行のスレッドIDを確認して，そのスレッドIDをたどってエラー発生個所を調査します。
　RMI-IIOP呼び出しによってスレッドIDが変化しますが，「Root AP CommonNo」列によってつながりがわかります。
3. 「Rc（リターンコード）」列の値が0以外の個所がエラー個所です。
4. エラー個所が見つかったらその前後の処理内容を確認して原因を調査します。
5. さらに調べたい場合は，Cosminexusが出力する障害情報であるJ2EEサーバ，リダイレクタ，サーバ管理コマンドのログを使って，エラー発生個所のスレッドIDをたどります。

図7-50　性能解析トレースの例

図7-50の図中の番号は次の内容を示します。
(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-50で示した(13)で，サービス部品のRMIを呼び出し，そのあとEJBコンテナがリクエストを受信した直後にエラーが発生していることがわかります（性能解析トレースの採取レベルは「通常」と「詳細」の二つありますが，図7-50は「通常」で採取した場合のトレースです）。

サービス部品稼働マシンがCosminexus Application Serverを使用している場合は，エラーが起きた個所のスレッドIDとサービス部品稼働マシン側の障害情報を突き合わせることで，さらに調査できます。
なお，性能解析トレースのスレッドIDは10進数ですが，Cosminexusが出力する障害情報は16進数表現なので，個別にスレッドIDを16進数に直す必要があるため注意してください。
サービスアダプタからのサービス部品呼び出しについては，SessionBeanの呼び出しによってスレッドIDが変化しますが，Root AP CommonNo列によってつながりがわかります。性能解析トレースファイルの利用方法の詳細については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 保守／移行／互換編」の「6.6.1　処理性能の解析作業の概要」を参照してください。

(b)　ユーザ電文に指定したビジネスプロセスの相関セットからたどる方法

ユーザ電文に指定したビジネスプロセスの相関セットからたどる手順を次に示します。

相関セットを調査します。

ビジネスプロセスのプロセスIDを取得します。

アクティビティの状態を取得します。

詳細については，「7.7.1　Webサービス（SOAP通信）実行時の障害対策」を参照してください。

7.7.3　MDB（WS-R）実行時の障害対策

＜この項の構成＞

(1)　MDB（WS-R）でのエラーの伝わり方

(2)　問題発生個所の切り分け方

(3)　そのほかの障害要因の特定方法（サービス部品呼び出し要求の実行履歴の追跡）

(1)　MDB（WS-R）でのエラーの伝わり方

MDB（WS-R）でのサービス部品呼び出しでは，サービスリクエスタとHCSCサーバの間，HCSCサーバとサービス部品の間でエラーは伝わりません。検知できる障害の種類と，ログおよびトレースの出力先を説明します。

サービス部品でユーザ定義例外のエラーが発生した場合

サービス部品でユーザ定義例外のエラーが発生した場合のMDB（WS-R）でのエラーの伝わり方を次の図に示します。

図7-51　サービス部品でユーザ定義例外のエラーが発生した場合のMDB（WS-R）でのエラーの伝わり方

サービス部品で発生した例外は，サービス部品稼働マシン上のCosminexus RMでエラー処理します。サービス部品稼働マシン上のCosminexus RMはローカルキューからメッセージの取り出しに失敗したことを示すメッセージをサービス部品稼働マシン上のログに出力します。

なお，ユーザ定義例外（アプリケーション例外）の場合，ロールバックして再度サービス部品でメッセージを取り出すかどうかは，サービス部品稼働マシン側のCosminexus RMの設定やサービス部品プログラムの作成に依存します。

サービス部品稼働マシン上のメッセージの取り出しでロールバックして，ロールバックの回数（メッセージの配送回数）が最大値に達した場合や，メッセージが有効期限に達した場合，そのメッセージはデッドメッセージキューに移動します。ただし，次の場合はメッセージが削除されます。

デッドメッセージキューの設定をしていない場合

配送回数に無制限の設定をしている場合

デッドメッセージキューのメッセージ数が超過した場合

データベースに障害が発生した場合

Cosminexus RMの詳細については，マニュアル「Cosminexus Reliable Messaging」を参照してください。

サービス部品でユーザ定義例外以外のエラーが発生した場合

サービス部品でユーザ定義例外以外のエラーが発生した場合のMDB（WS-R）でのエラーの伝わり方を次の図に示します。

図7-52　サービス部品でユーザ定義例外以外のエラーが発生した場合のMDB（WS-R）でのエラーの伝わり方

サービス部品で発生した例外は，サービス部品稼働マシン上のCosminexus RMでエラー処理します。Cosminexus RMはローカルキューからメッセージの取り出しに失敗したことを示すメッセージをサービス部品稼働マシン上のログに出力します。

なお，システム例外の場合，サービス部品側でロールバックして，再度サービス部品でメッセージの取り出しを試みます。

サービス部品稼働マシン上のメッセージの取り出しでロールバックして，ロールバックの回数（メッセージの配送回数）が最大値に達した場合や，メッセージが有効期限に達した場合，そのメッセージはデッドメッセージキューに移動します。ただし，次の場合はメッセージが削除されます。

デッドメッセージキューの設定をしていない場合

配送回数に無制限の設定をしている場合

デッドメッセージキューのメッセージ数が超過した場合

データベースに障害が発生した場合

Cosminexus RMの詳細については，マニュアル「Cosminexus Reliable Messaging」を参照してください。

HCSCサーバ稼働マシンからサービス部品稼働マシンへの転送でエラーが発生した場合

HCSCサーバ稼働マシンからサービス部品稼働マシンへの転送でエラーが発生した場合のMDB（WS-R）でのエラーの伝わり方を次の図に示します。

図7-53　HCSCサーバ稼働マシンからサービス部品稼働マシンへの転送でエラーが発生した場合のMDB（WS-R）でのエラーの伝わり方

HCSCサーバ稼働マシンからサービス部品稼働マシンへのメッセージの転送に失敗した場合，HCSCサーバ側のCosminexus RMでエラー処理をします。Cosminexus RMはメッセージの転送に失敗したことを示すメッセージをHCSCサーバ稼働マシン上のログに出力します。

なお，メッセージの転送でエラーを検知した場合，HCSCサーバ側でロールバックして再度転送を試みます。

HCSCサーバ稼働マシンからの転送でロールバックして，ロールバックの回数（メッセージの配送回数）が最大値に達した場合や，配送回数に無制限の設定をしている場合，そのメッセージはデッドメッセージキューに移動します。デッドメッセージキュー名を設定していない場合やデッドメッセージキューを作成していない場合は，無限にサービス部品を呼び出す処理が再実行されるため，必ずデッドメッセージキュー名やデッドメッセージキューを設定してください。

Cosminexus RMのセットアップについては，「3.1.2　実行環境に必要なソフトウェアの設定」を参照してください。Cosminexus RMのキュー間転送の障害時の動作の詳細については，マニュアル「Cosminexus Reliable Messaging」の「2.4.7　キュー間転送の障害時の動作」を参照してください。

HCSCサーバからエラーが発生した場合

HCSCサーバからエラーが発生した場合のMDB（WS-R）でのエラーの伝わり方を次の図に示します。

図7-54　HCSCサーバからエラーが発生した場合のMDB（WS-R）でのエラーの伝わり方

図中の各エラーには，次に示すケースが該当します。

エラー1：要求パラメタ不正など

エラー2：あて先（ロケーション）が見つからない，アダプタが停止しているなど

エラー3：データ変換に失敗したなど

エラー4：メッセージ送信失敗など

HCSCサーバで図中のエラー1～エラー3のどれかを検知した場合，HCSCサーバ稼働マシン上のCosminexus RMでエラー処理します。図中のエラー4を検知した場合，発生したエラーの例外を標準受付にそのままスローするか，サービスアダプタでエラーの例外をフォルト電文に変換するか選択できます。例外発生時に取得するエラーの選択方法については，「7.11　例外発生時に取得するエラーの選択」を参照してください。

発生したエラーのメッセージをメッセージログに出力します。また，Cosminexus RMはローカルキューからメッセージの取り出しに失敗したことを示すメッセージをHCSCサーバ稼働マシン上のログに出力します。

なお，HCSCサーバでエラーを検知した場合，HCSCサーバ側でロールバックをして，再度サービス部品でメッセージの取り出し（サービス部品呼び出し）を試みます。HCSCサーバ稼働マシン上のメッセージの取り出しでロールバックして，ロールバックの回数（メッセージの配送回数）が最大値に達した場合，そのメッセージはデッドメッセージキューに移動します。デッドメッセージキュー名を設定していない場合やデッドメッセージキューを作成していない場合は，無限にサービス部品を呼び出す処理が再実行されるため，必ずデッドメッセージキュー名やデッドメッセージキューを設定してください。

Cosminexus RMのセットアップについては，「3.1.2　実行環境に必要なソフトウェアの設定」を参照してください。

Cosminexus RMの詳細については，マニュアル「Cosminexus Reliable Messaging」を参照してください。

サービスリクエスタ稼働マシンからHCSCサーバ稼働マシンへの転送でエラーが発生した場合

サービスリクエスタ稼働マシンからHCSCサーバ稼働マシンへの転送でエラーが発生した場合のMDB（WS-R）でのエラーの伝わり方を次の図に示します。

図7-55　サービスリクエスタ稼働マシンからHCSCサーバ稼働マシンへの転送でエラーが発生した場合のMDB（WS-R）でのエラーの伝わり方

サービスリクエスタ稼働マシンからHCSCサーバ稼働マシンへのメッセージの転送に失敗した場合，サービスリクエスタ側のCosminexus RMでエラー処理します。Cosminexus RMはメッセージの転送に失敗したことを示すメッセージをサービスリクエスタ稼働マシン上のログに出力します。

なお，メッセージの転送でエラーを検知した場合，サービスリクエスタ側でロールバックして，再度転送を試みます。

サービスリクエスタ稼働マシンからの転送でロールバックして，ロールバックの回数（メッセージの配送回数）が最大値に達した場合や，メッセージが有効期限に達した場合，そのメッセージはデッドメッセージキューに移動します。ただし，次の場合は，メッセージは削除されます。

デッドメッセージキューの設定をしていない場合

配送回数に無制限の設定をしている場合

デッドメッセージキューのメッセージ数が超過した場合

データベースに障害が発生した場合

Cosminexus RMのキュー間転送の障害時の動作の詳細については，マニュアル「Cosminexus Reliable Messaging」の「2.4.7　キュー間転送の障害時の動作」を参照してください。

サービスリクエスタでエラーを検知した場合

サービスリクエスタでエラーを検知した場合のMDB（WS-R）でのエラーの伝わり方を次の図に示します。

図7-56　サービスリクエスタでエラーを検知した場合のMDB（WS-R）でのエラーの伝わり方

サービスリクエスタから転送キューへメッセージの送信ができなかった場合，サービスリクエスタへ例外（JMSException）がスローされます。サービスリクエスタは，例外をキャッチし，キャッチした例外オブジェクトのgetterを使用することで，発生したエラーの詳細を取得できます。サービスリクエスタ稼働マシンからのメッセージ送信失敗の場合は，デッドメッセージキューに移動しません。Cosminexus RMおよびJMSの詳細については，マニュアル「Cosminexus Reliable Messaging」を参照してください。

同期のサービス部品を呼び出してユーザ定義例外のエラーが発生した場合

同期のサービス部品を呼び出してユーザ定義例外のエラーが発生した場合のMDB（WS-R）でのエラーの伝わり方を次の図に示します。

図7-57　同期のサービス部品を呼び出してユーザ定義例外のエラーが発生した場合のMDB（WS-R）でのエラーの伝わり方

非同期（MDB（WS-R））の標準受付に対してサービス部品を呼び出すときに応答用のキューを指定して，非同期（MDB（WS-R））の標準受付から同期のサービスアダプタ（Webサービス）のサービス部品を呼び出します。このとき，サービス部品側でユーザ定義例外が発生すると，エラー情報のメッセージが応答用のキュー（転送キュー）に送信されます。

転送キューの送信先をサービスリクエスタ側のローカルキューに指定しておくと，そこからメッセージを取り出すことで，エラーの内容を取得できます。

応答用のキュー（転送キュー）はあらかじめ作成して準備しておく必要がありますが，応答用のキューの設定をしていない場合や，応答用のキューのメッセージ数が超過し，応答用のキューへの送信が失敗した場合，HCSCサーバ内で処理がロールバックし，標準受付のローカルキューからメッセージが再送されます（サービス部品側の処理（トランザクション）はロールバックしません）。

ロールバックの回数（メッセージの配送回数）が最大値に達した場合，そのメッセージはデッドメッセージキューに移動します。デッドメッセージキュー名を設定していない場合，およびデッドメッセージキューを作成していない場合，無限にサービス部品を呼び出す処理が再実行されるため，必ずデッドメッセージキュー名やデッドメッセージキューを設定してください。

(2)　問題発生個所の切り分け方

サービスリクエスタから標準受付（MDB（WS-R））を使用して，サービス部品を呼び出した場合の問題発生個所の切り分け方について説明します。切り分け方を次の図に示します。

図7-58　問題発生個所の切り分け方（サービス部品を呼び出した場合）

(i)サービス部品稼働マシンでのエラーの場合

サービス部品稼働マシン側のCosminexus RMが出力する障害情報を参照して，障害を調査します。サービス部品のプログラムでエラー情報を出力している場合は，Cosminexusのユーザログを参照します。

要因は，次の観点で調査してください。

サービスリクエスタから要求したユーザ電文

サービス部品稼働マシン

サービス部品稼働マシンのCosminexus RMの設定

サービス部品のプログラム

(ii)HCSCサーバ稼働マシンでのエラーの場合

HCSCサーバ稼働マシン側のメッセージログ，またはHCSCサーバ稼働マシン側のCosminexus RMが出力する障害情報を参照して，障害を調査します。

要因は，次の観点で調査してください。

サービスリクエスタから要求した引数の内容

HCSCサーバの設定または状態

HCSCサーバのCosminexus RMの設定

サービスアダプタの定義内容

ビジネスプロセスの定義内容

サービスリクエスタから要求したユーザ電文

ネットワークの状態

(iii)サービスリクエスタ稼働マシンでのエラーの場合

サービスリクエスタがキャッチした例外からエラーの内容を取得できます。取得した例外のエラー情報を基に対処します。または，サービスリクエスタ稼働マシン側のCosminexus RMが出力する障害情報を参照して，障害を調査します。

要因は，次の観点で調査してください。

サービスリクエスタ稼働マシンのJ2EEコンテナの設定または状態

サービスリクエスタ稼働マシンのCosminexus RMの設定

ネットワークの状態

(3)　そのほかの障害要因の特定方法（サービス部品呼び出し要求の実行履歴の追跡）

サービスリクエスタから指定した情報や，HCSCサーバからの情報を基に，サービス部品呼び出しの処理がどこまで進んだか実行履歴を追跡できます。ここでは，実行履歴を追跡するために必要な情報（ID）について説明します。

(a)　クライアント相関ID

クライアント相関IDは，サービス部品呼び出しを要求するサービスリクエスタ側のプログラムで，要求時に設定する情報です。サービスリクエスタからの要求電文と，HCSCサーバで管理している実行履歴やログおよびトレースとを対応づけるために使用します。そのため，HCSCサーバに送信した要求ごとに異なるIDを指定することを推奨します。IDはサービスリクエスタ開発時に指定します。クライアント相関IDが引き継がれる範囲を次の図に示します。

図7-59　クライアント相関IDが引き継がれる範囲（MDB（WS-R）実行時）

(b)　メッセージ共通ID

HCSCサーバが付与するIDです。HCSCサーバ内のログやトレース，電文の実行履歴情報を識別するために使用します。メッセージ共通IDが引き継がれる範囲を次の図に示します。

図7-60　メッセージ共通IDが引き継がれる範囲（MDB（WS-R）実行時）

(c)　JMSMessageID

Cosminexus RMが付与するIDです。HCSCサーバ内のログやトレース，電文の実行履歴に出力します。JMSMessageIDが引き継がれる範囲を次の図に示します。

図7-61　JMSMessageIDが引き継がれる範囲（MDB（WS-R）実行時）

(d)　JMSCorrelationIDおよびユーザ固有のJMSプロパティ

サービス部品の呼び出し要求時に，サービスリクエスタにJMSCorrelationIDおよびユーザ固有のJMSプロパティを設定すると，その値がサービス部品側のキューまで引き継がれます。サービス部品側のプログラムで取得することで，メッセージを一意に関連づけられます。JMSCorrelationIDおよびユーザ固有のJMSプロパティが引き継がれる範囲を次の図に示します。

図7-62　JMSCorrelationIDおよびユーザ固有のJMSプロパティが引き継がれる範囲（MDB（WS-R）実行時）

(e)　スレッドID

J2EEコンテナによって処理するスレッドごとに与えられるIDです。スレッドIDが引き継がれる範囲を次の図に示します。

図7-63　スレッドIDが引き継がれる範囲（MDB（WS-R）実行時）

7.7.4　MDB（DBキュー）実行時の障害対策

＜この項の構成＞

(1)　MDB（DBキュー）でのエラーの伝わり方

(2)　問題発生個所の切り分け方

(3)　そのほかの障害要因の特定方法（サービス部品呼び出し要求の実行履歴の追跡）

(1)　MDB（DBキュー）でのエラーの伝わり方

MDB（DBキュー）でのサービス部品呼び出しでは，サービスリクエスタとHCSCサーバの間，HCSCサーバとサービス部品の間でエラーは伝わりません。検知できる障害の種類と，ログおよびトレースの出力先を次に説明します。

なお，非同期の標準受付（MDB（DBキュー））からサービスアダプタ（MDB（DBキュー））へのサービス部品呼び出しはできません。そのため，サービス部品側がDBキューの場合，またはサービスリクエスタ側がDBキューの場合とに分けて説明します。

(a)　DBキューがサービス部品側にある場合

サービス部品でエラーが発生した場合

サービス部品で発生したエラーは，HCSCサーバおよびサービスリクエスタへエラー情報として伝わりません。エラーの情報はサービス部品稼働マシン側に出力されます。サービス部品でエラーが発生した場合のエラーの伝わり方を次の図に示します。

図7-64　サービス部品でエラーが発生した場合のエラーの伝わり方

(b)　DBキューがサービスリクエスタ側にある場合

HCSCサーバからエラーが発生した場合

HCSCサーバからエラーが発生した場合のエラーの伝わり方を次の図に示します。

図7-65　HCSCサーバからエラーが発生した場合のエラーの伝わり方

図中の各エラーには，次に示すケースが該当します。

エラー1：要求パラメタ不正など

エラー2：あて先（ロケーション）が見つからない，アダプタが停止しているなど

エラー3：データ変換に失敗したなど

エラー4：メッセージ送信失敗など

HCSCサーバで図中のエラー1～エラー3のどれかを検知した場合，HCSCサーバ稼働マシン上のCosminexus RMにエラーを伝えます。図中のエラー4を検知した場合，HCSCサーバ稼働マシン上のCosminexus RMにエラーを伝えるか，サービスアダプタでエラーの例外をフォルト電文に変換するか選択できます。例外発生時に取得するエラーの選択方法については，「7.11　例外発生時に取得するエラーの選択」を参照してください。

発生したエラーのメッセージをメッセージログに出力します。また，Cosminexus RMは，ローカルキューからメッセージの取り出しに失敗したことを示すメッセージをHCSCサーバ稼働マシン上のログに出力します。

なお，HCSCサーバでエラーを検知した場合，HCSCサーバ側でロールバックして再度サービス部品でメッセージの取り出し（サービス部品呼び出し）を試みます。

HCSCサーバ稼働マシン上のメッセージの取り出しでロールバックして，ロールバックの回数（メッセージの配送回数）が最大値に達した場合，そのメッセージはデッドメッセージキューに移動します。デッドメッセージキュー名を設定していない場合，およびデッドメッセージキューを作成していない場合は，無限にサービス部品を呼び出す処理が再実行されるため，必ずデッドメッセージキュー名やデッドメッセージキューを設定してください。

Cosminexus RMのセットアップについては，「3.1.2　実行環境に必要なソフトウェアの設定」を参照してください。Cosminexus RMの詳細については，マニュアル「Cosminexus Reliable Messaging」を参照してください。

サービスリクエスタでエラーを検知した場合

サービスリクエスタでエラーを検知した場合のエラーの伝わり方を次の図に示します。

図7-66　サービスリクエスタでエラーを検知した場合のエラーの伝わり方

サービスリクエスタがDBキューにメッセージをキューイングしたときに発生したエラーは，サービスリクエスタ稼働マシン側に出力されます。

同期のサービス部品を呼び出してユーザ定義例外のエラーが発生した場合

同期のサービス部品を呼び出してユーザ定義例外のエラーが発生した場合のエラーの伝わり方を次の図に示します。

図7-67　同期のサービス部品を呼び出してユーザ定義例外のエラーが発生した場合のエラーの伝わり方

非同期（MDB（DBキュー））の標準受付に対してサービス部品を呼び出すときに応答用のキューを指定して，非同期（MDB（DBキュー））の標準受付から同期のサービスアダプタ（Webサービス）のサービス部品を呼び出します。このとき，サービス部品側でユーザ定義例外が発生すると，エラー情報のメッセージが応答用のキュー（送信用共用キュー）に送信されます。送信用共用キューの送信先をサービスリクエスタ側のDBキューに指定しておくと，そこからメッセージを取り出すことで，エラーの内容を取得できます。

応答用のキュー（送信用共用キュー）はあらかじめ作成して準備しておく必要がありますが，応答用のキューの設定をしていない場合や，応答用のキューのメッセージ数が超過し，応答用のキューへの送信が失敗した場合，HCSCサーバ内で処理がロールバックして，標準受付の受信用共用キューからメッセージが再送されます（ただし，サービス部品側の処理（トランザクション）はロールバックしません）。ロールバックの回数（メッセージの配送回数）が最大値に達した場合，そのメッセージはデッドメッセージキューに移動します。デッドメッセージキュー名を設定していない場合，およびデッドメッセージキューを作成していない場合は，無限にサービス部品を呼び出す処理が再実行されるため，必ずデッドメッセージキュー名やデッドメッセージキュー設定してください。

(2)　問題発生個所の切り分け方

サービスリクエスタから標準受付（MDB（DBキュー））を使用して，サービス部品を呼び出した場合の問題発生個所の切り分け方について説明します。問題発生個所の切り分けの流れを次の図に示します。

図7-68　問題発生個所の切り分けの流れ（サービスリクエスタから標準受付（MDB（DBキュー））を使用して，サービス部品を呼び出した場合）

(i)サービス部品稼働マシンでのエラーの場合

サービス部品稼働マシン側に出力する障害情報から，障害を調査します。

要因は，次の観点で調査してください。

サービスリクエスタから要求したユーザ電文

サービス部品稼働マシンの状態

サービス部品稼働マシンの設定

サービス部品のプログラム

(ii)HCSCサーバ稼働マシンでのエラーの場合

HCSCサーバ稼働マシン側のメッセージログ，またはHCSCサーバ稼働マシン側のCosminexus RMが出力する障害情報を参照して，障害を調査します。

要因は，次の観点で調査してください。

サービスリクエスタから要求したバイナリデータの内容

サービスリクエスタから要求したバイナリデータの形式

HCSCサーバの設定または状態

HCSCサーバのCosminexus RMの設定

サービスアダプタの定義内容

ビジネスプロセスの定義内容

サービスリクエスタから要求したユーザ電文

ネットワークの状態

(iii)サービスリクエスタ稼働マシンでのエラーの場合

サービスリクエスタ稼働マシン側に出力する障害情報から，障害を調査します。

要因は，次の観点で調査してください。

サービスリクエスタから要求したユーザ電文

サービスリクエスタ稼働マシンの状態

サービスリクエスタ稼働マシンの設定

サービスリクエスタのプログラム

(3)　そのほかの障害要因の特定方法（サービス部品呼び出し要求の実行履歴の追跡）

サービスリクエスタから指定した情報や，HCSCサーバからの情報を基に，サービス部品呼び出しの処理がどこまで進んだか実行履歴を追跡できます。ここでは，実行履歴を追跡するために必要な情報（ID）について説明します。

(a)　クライアント相関ID

クライアント相関IDは，サービス部品呼び出し要求を行うサービスリクエスタ側のプログラムで，要求時に設定する情報です。サービスリクエスタからの要求電文と，HCSCサーバで管理している実行履歴やログおよびトレースとを対応づけるために使用します。そのため，HCSCサーバに送信した要求ごとに異なるIDを指定することを推奨します（サービスリクエスタ作成時に指定が必要です）。クライアント相関IDが引き継がれる範囲を次の図に示します。

図7-69　クライアント相関IDが引き継がれる範囲（MDB（DBキュー）実行時）

(b)　メッセージ共通ID

HCSCサーバが付与するIDです。HCSCサーバ内のログやトレース，電文の実行履歴情報を識別するために使用します。メッセージ共通IDが引き継がれる範囲を次の図に示します。

図7-70　メッセージ共通IDが引き継がれる範囲（MDB（DBキュー）実行時）

(c)　JMSMessageID

Cosminexus RMが付与するIDです。HCSCサーバ内のログやトレース，電文の実行履歴に出力します。JMSMessageIDが引き継がれる範囲を次の図に示します。

図7-71　JMSMessageIDが引き継がれる範囲（MDB（DBキュー）実行時）

注　JMSCorrelationIDやユーザ固有のプロパティなどの情報は引き継がれません。

(d)　スレッドID

J2EEコンテナによって処理するスレッドごとに与えられるIDです。スレッドIDが引き継がれる範囲を次の図に示します。

図7-72　スレッドIDが引き継がれる範囲（MDB（DBキュー）実行時）

注　サービス部品側のプログラムと関連づける場合は，ユーザ電文に関連づけのための情報を埋め込む必要があります。

7.7.5　ユーザ電文に誤りがある場合の障害対策

＜この項の構成＞

(1)　ユーザ電文に誤りがある場合のエラー

(2)　サービスアダプタでの電文の検証方法

(3)　ユーザ電文トレースの取得による調査

(1)　ユーザ電文に誤りがある場合のエラー

標準受付からサービスアダプタのサービス部品を直接呼び出す場合，サービス部品側で要求するユーザ電文（XML文書）をサービスリクエスタで作成する必要があります。そのため，サービスリクエスタで作成するXMLに誤りがあると，正しくサービス部品を呼び出せません。SOAP通信でのSOAPメッセージとユーザ電文の関係を次の図に示します。

図7-73　SOAP通信でのSOAPメッセージとユーザ電文の関係

ユーザ電文に誤りがある（フォーマット定義の形式と異なる電文を実行した）場合，サービスアダプタのプロトコルの違いによって，エラーの内容が異なります。

また，電文の形式によっては，サービスアダプタでエラーとならないでサービス部品で例外になったり，サービス部品でエラーにならないで想定していない応答が返ったりすることがあります。

(a)　Webサービス（SOAP通信）実行時にユーザ電文不正でエラーになる場合

サービスアダプタ（Webサービス）から呼び出せるサービス部品の仕様は，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「2.6.1　Webサービスを利用したサービス部品の適用範囲」で示す適用範囲を満たしている必要があります。適用範囲以外のサービス部品の場合，動作の保障ができません。

(b)　SessionBean実行時にユーザ電文不正でエラーになる場合

サービスアダプタ（SessionBean）から呼び出せるサービス部品の仕様は，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「2.6.2　SessionBeanを利用したサービス部品の適用範囲」で示す適用範囲を満たしている必要があります。適用範囲以外のサービス部品の場合，動作の保障ができません。

(c)　MDB（WS-R/DBキュー）実行時にユーザ電文不正でエラーになる場合

サービスリクエスタから要求したユーザ電文に誤りがある場合，MDB（WS-R/DBキュー）のサービスアダプタではエラーになりません。開発環境で定義するときにスキーマを定義しますが，通常，このスキーマで定義した形式でないユーザ電文でも，非同期キューに送信されます。サービス部品側でユーザ電文を受け取って検証するよう作成している場合は，サービス部品側でエラーを検知します。

(2)　サービスアダプタでの電文の検証方法

サービスアダプタに指定したフォーマット定義（XMLスキーマ）とユーザ電文（XML文書）が，XMLスキーマの仕様に従い，妥当かどうか検証できます。

サービスアダプタでの電文の検証機能を使用するには，HCSCサーバランタイム定義ファイルのtelegram-validationプロパティで設定します。HCSCサーバランタイム定義ファイルの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「HCSCサーバランタイム定義ファイル」を参照してください。

注意

定義したフォーマット定義に対して妥当でない電文であるにもかかわらず，サービス部品呼び出しに成功していた電文の場合，電文の検証機能を使用することで，この機能によって妥当な形式でないと判断されると，サービスアダプタでエラーとなります。

電文の検証機能は，HCSCサーバ全体の次の表に示すアダプタで有効となります。サービスアダプタごとには設定できません。また，サービス部品を呼び出す要求電文，または応答電文に対して有効となります。

表7-56　電文の検証機能が有効になるアダプタ

アダプタ種別 | プロトコル種類 | 方向 | データ変換定義のパターン | 検証するフォーマット定義 | 電文種類 | 検証機能の有効
サービスアダプタ | Webサービス，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
Object Accessアダプタ | 要求 | データ変換なし | サービス部品電文 | XML | ○
標準－サービス部品でデータ変換 | 標準電文 | XML | ○
バイナリ | ×※1
サービス部品電文 | XML | ○
応答 | データ変換なし | サービス部品電文 | XML | ○
サービス部品－標準でデータ変換 | 標準電文 | XML | ○
バイナリ | ×※1
サービス部品電文 | XML | ○
ファイルアダプタ | 要求 | データ変換なし | サービス部品電文 | XML | ○
バイナリ | ×※1
標準－サービス部品でデータ変換 | 標準電文 | XML | ○
バイナリ | ×※1
サービス部品電文 | XML | ○
バイナリ | ×※1
応答 | データ変換なし | サービス部品電文 | XML | ○
バイナリ | ×※1
サービス部品－標準でデータ変換 | 標準電文 | XML | ○
バイナリ | ×※1
サービス部品電文 | XML | ○
バイナリ | ×※1
iWayアダプタ | 要求 | データ変換なし | サービス部品電文 | XML | ×
応答 | データ変換なし | サービス部品電文 | XML | ×

（凡例）

○：検証機能が有効になります。

×：検証機能が無効になります。

要求：サービスアダプタからサービス部品へ向かうことを示します。

応答：サービス部品からサービスアダプタへ向かうことを示します。

フォルト：エラー時にサービス部品からサービスアダプタへ向かうことを示します。

注※1　バイナリ電文のサービス部品呼び出し時は，設定したフォーマット定義を基にDOMに変換（パース処理）しています。そのため，バイナリ電文でフォーマット定義に対して妥当でない電文を送付した場合，例外が発生し，次のメッセージが表示されます。

KDEC05504-E An attempt to specify format definition settings has failed. (information1 = 保守情報, information2 = 保守情報)

フォーマット定義の設定に失敗しました。

注※2　DBアダプタは，telegram-validationプロパティ以外の機能で，電文形式を検証します。例えば，サービスアダプタで，要求時に，「リクエスタ（バイナリ）－標準（XML）－サービス部品（バイナリ）」の変換をした場合，要求電文に対して次の流れで変換と検証をします。

要求電文をリクエスタのフォーマット定義に対して検証します（バイナリ電文の機能がOFFの場合も同様です）。

1.が妥当であった場合，リクエスタの電文の形式から標準電文の形式に変換します。

変換後の電文を標準電文のフォーマット定義に対して検証します。

2.が妥当であった場合，標準電文の形式からサービス部品電文の形式に変換します。

変換後の電文をサービス部品電文のフォーマット定義に対して検証します（バイナリ電文の機能がOFFの場合も同様です）。

4.が妥当であった場合，サービス部品を呼び出します。

(3)　ユーザ電文トレースの取得による調査

ユーザ電文トレースを取得することによって，設計したとおりの電文が流れているか，リクエスタ側やサービス側，ビジネスプロセスのアクティビティやデータ変換などの各ポイントを調査できます。

ユーザ電文トレースを取得するには，HCSCサーバランタイム定義ファイルのtelegramtraceプロパティ，telegramtrace-filepathプロパティ，telegramtrace-filesizeプロパティ，およびtelegramtrace-filenumプロパティで設定します。HCSCサーバランタイム定義ファイルの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「HCSCサーバランタイム定義ファイル」を参照してください。

ユーザ電文トレースの詳細については，「7.4.4　ユーザ電文トレース」を参照してください。

注意

ユーザ電文の内容をファイルに出力するため，セキュリティ上の問題（情報漏洩の懸念など）が発生します。したがって，本番運用を含む通常の運用では取得しないでください。

01-60以前の「<Cosminexusのインストールディレクトリ>¥CSC¥lib¥cscdba.ear」を使用して作成したDBアダプタでは，取得位置SVC，および取得位置CNVSTのユーザ電文トレースは取得できません。

次に示すアダプタ製品では，取得位置SVCの電文トレースは出力されません。
・uCosminexus Service Adapter Architect for TP1 01-00
・uCosminexus Service Adapter for TP1 01-00
・uCosminexus Service Adapter Architect for Flat Files 01-00
・uCosminexus Service Adapter for Flat Files 01-00
・uCosminexus Service Adapter Architect for Object Access 01-00
・uCosminexus Service Adapter for Object Access 01-00
・uCosminexus Service Adapter Architect for Message Queue 01-00
・uCosminexus Service Adapter for Message Queue 01-00

7.7.6　システム全体の障害での障害調査

＜この項の構成＞

(1)　プロセスハングアップ

(2)　プロセススローダウン

(3)　タイムアウト

(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%に近い状態の場合，バックプロセスからの応答が返ってこないケースや，デッドロックなどのおそれがあります。

Cosminexus サービスプラットフォームのメッセージログや，Cosminexusの「J2EEサーバ，リダイレクタ，サーバ管理コマンドのログ」を確認して，不正なエラーが出ていないかどうかを調査します。

性能解析トレースを取得し，解析します。処理に時間が掛かっている個所を特定することで，ハングアップが起きている個所を特定できます。

スレッドダンプを複数回取得して，時系列で観察し，それぞれのスレッドダンプでtidの同じスレッドのスタックトレースを比較調査します。

(b)　コマンド要求の場合

コマンド要求の場合の，プロセスハングアップ時の調査手順を次に示します。

コマンド要求の場合，運用環境稼働マシン，HCSCサーバ稼働マシン，およびデータベース稼働マシンについて，該当プロセスのCPU利用率をそれぞれ調査します。
CPU利用率が100%に近い状態の場合，無限ループや再起呼び出しに陥っているおそれがあります。
CPU利用率が0%に近い状態の場合，バックプロセスからの応答が返ってこないケースや，デッドロックなどのおそれがあります。

Cosminexus サービスプラットフォームのメッセージログや，Cosminexusの「J2EEサーバ，リダイレクタ，サーバ管理コマンドのログ」，および「運用管理エージェント，運用監視エージェント，Management Serverのログ」を確認して，不正なエラーが出ていないかどうかを調査します。

スレッドダンプを複数回取得して，時系列で観察し，それぞれのスレッドダンプでtidの同じスレッドのスタックトレースを比較調査します。

(2)　プロセススローダウン

サービスリクエスタからのサービス部品呼び出し要求のスループットやレスポンスタイムがスローダウンしてきた場合の調査の流れについて説明します。

性能解析トレースで，実行時間の長い個所を割り出します。
性能解析トレースを取得，解析し，処理に時間が掛かっている個所を特定することで，スローダウンが起きている個所を特定できます。

(3)　タイムアウト

サービスリクエスタからのサービス部品呼び出し要求や，コマンド要求の応答でタイムアウトが発生した場合の流れについて説明します。

(a)　サービスリクエスタからのサービス部品呼び出し要求の場合

サービスリクエスタからのサービス部品呼び出し要求の場合の，タイムアウト時の調査手順を次に示します。

タイムアウトが発生した場合，エラーメッセージが出力されるので，これを調査します。

タイムアウトのエラーメッセージのほかにエラーメッセージが出ていないかどうか，Cosminexus サービスプラットフォームのメッセージログや，Cosminexusの「J2EEサーバ，リダイレクタ，サーバ管理コマンドのログ」を確認して調査します。

サービス部品呼び出し要求処理がどこまで完了していて，どこでハングアップしているかを調査します。サービス部品呼び出し処理の実行履歴の追跡は，プロトコルごとに異なります。
各プロトコルでの要求実行時の障害対策については「7.7.1　Webサービス（SOAP通信）実行時の障害対策」，「7.7.2　SessionBean実行時の障害対策」，「7.7.3　MDB（WS-R）実行時の障害対策」，および「7.7.4　MDB（DBキュー）実行時の障害対策」を参照してください。

リクエストトレースまたは性能解析トレースを調査します。
サービス部品呼び出し要求がどこまで行われているか調査した結果を参考に，処理に時間が掛かっている個所を特定することで，タイムアウトが発生した原因を究明できます。

(b)　コマンド要求の場合

コマンド要求の場合の，タイムアウト時の調査手順を次に示します。

タイムアウトが発生した場合，エラーメッセージが出力されるので，これを調査します。

タイムアウトのエラーメッセージのほかにエラーメッセージが出ていないかどうか，Cosminexus サービスプラットフォームのメッセージログや，Cosminexusの「J2EEサーバ，リダイレクタ，サーバ管理コマンドのログ」，および「運用管理エージェント，運用監視エージェント，Management Serverのログ」を確認して，不正なエラーが出ていないかどうか調査します。

7.7.7　ビジネスプロセス実行時の障害対策

ビジネスプロセス実行時には，次の図に示す障害が発生する場合があります。これらの障害時の対処方法について説明します。

図7-74　ビジネスプロセス実行時の障害

＜この項の構成＞

(1)　非同期の受付アクティビティでの失敗

(2)　同期の受付アクティビティでの失敗

(3)　同期の受付アクティビティへ送信した際のタイムアウト

(4)　サービス呼び出し時のエラー（例外）

(5)　サービス呼出時のサービス部品からのフォルト

(1)　非同期の受付アクティビティでの失敗

サービスリクエスタから非同期の受付アクティビティに対して電文を送信したときにエラーが発生した場合，HCSCサーバでは電文を受け付けていない状態となります。この場合の対処方法を次に示します。

対処方法

エラーの要因を取り除きます。

サービスリクエスタから，同一の電文を再送信します。

(2)　同期の受付アクティビティでの失敗

サービスリクエスタから同期の受付アクティビティに対して電文を送信したときに，エラーになった場合の対処方法を次に示します。

対処方法

メッセージログに出力されているエラーメッセージを参照します。

エラーの原因を取り除きます（エラーの種類によっては必要です）。

サービスリクエスタから電文を再送信します。

(3)　同期の受付アクティビティへ送信した際のタイムアウト

サービスリクエスタから同期の受付アクティビティに対して電文を送信したときに，タイムアウトが発生した場合の対処方法を次に示します。

対処方法

サービスリクエスタから送信した電文が実行できているかどうか不明なため，メッセージログにエラーメッセージが出力されているかどうかを確認します。

エラーメッセージが出力されている場合

エラーメッセージが出力されている場合は，エラーメッセージに対応した対処を実施します。

エラーメッセージが出力されていない場合

該当電文の相関セットから，プロセスインスタンスの状態をcscpiselectコマンドで確認します。

プロセスインスタンスの状態が実行中のままの場合は，次のどちらかを実施します。
・プロセスインスタンスをcscpireexecコマンドで再実行します。
・プロセスインスタンスの実行履歴をcscpideleteコマンドで削除して，サービスリクエスタから同一電文を再送信します。
プロセスインスタンスの状態を取得できない場合は，該当電文の受信が失敗しているため，サービスリクエスタから同一の電文を再送信します。

(4)　サービス呼び出し時のエラー（例外）

ビジネスプロセスのサービス呼出アクティビティでサービス呼び出しを実行した場合，次に示すようなエラーが発生したときは，プロセスインスタンスの実行が停止します。

プロセスインスタンスの実行が停止するエラー

サービス呼出アクティビティから呼び出すサービスアダプタが未起動状態

サービス呼出アクティビティから呼び出すサービスアダプタが未配備状態

サービス呼出アクティビティから呼び出すサービスアダプタでのデータ変換処理の失敗

同期のサービス部品呼び出し処理でのエラー（サービス部品の宛先不正，サービス部品の停止によるHTTPエラー，通信タイムアウト，通信障害など）

ビジネスプロセスの互換性の使用有無がOFFの場合，非同期のサービス部品呼び出し処理でのエラー（キューの宛先不正，キューへの送信処理の失敗など）

DBアダプタを使用してDBアクセスを行う処理でのエラー（DBアクセスエラー，SQLエラー，DB Connectorの設定不正など）

SOAPのサービス部品呼び出し処理で，Webサービスから応答したフォルト電文が，HCSCサーバでフォルトとして扱うための条件を満たしていない
サービス部品から返されたフォルト電文がフォルトとして扱われる条件については，マニュアル「Cosminexus サービスプラットフォーム 機能解説」の「5.3　SOAP Fault動作定義ファイルによるフォルトのキャッチ」を参照してください。

なお，該当するサービス呼出アクティビティの状態は，ビジネスプロセスの互換性の使用有無（HCSCサーバセットアップ定義のbp-status-compatible）がOFFの場合は，エラー状態または実行中状態のままとなり，ONの場合は実行中状態のままとなります。

エラーが発生した場合の対処方法を次に示します。

対処方法

障害情報に従って，サービスアダプタ，サービス部品などのエラー原因を取り除きます。

cscpireexecコマンドでプロセスインスタンスを再実行して，サービス部品を再呼び出しします。このとき，サービス部品に対して同一メッセージの2回目の呼び出しが行われるため，サービス部品側で重複チェックを実施して2回目の呼び出しを矛盾なく処理できる必要があります。

(5)　サービス呼出時のサービス部品からのフォルト

HCSCサーバがサービス部品に対して同期呼び出しを実行したときに，サービス部品がフォルト電文を応答した場合の対処方法を次に示します。

対処方法

フォルトコネクションを定義している場合

定義したフォルトコネクションに従って，処理が実行されます。

フォルトコネクションを定義していない場合

プロセスインスタンスがフォルト終了状態となり，プロセスインスタンスの実行が停止します。サービス部品がフォルトを応答しないような電文を再送信します。

注意

サービス呼び出し時のサービス部品から返されたSOAP Faultがフォルトの場合は，cscpireexecコマンドではプロセスインスタンスを再実行できません。

これは，定義したフォルトコネクションに従ってビジネスプロセスの処理を実行したり，プロセスインスタンスの実行が停止したりするため，ビジネスプロセスの状態が中断した状態のままとはならないからです。

7.7.8　データ変換実行時の障害対策

ここでは，データ変換実行中に発生する代表的な障害とその対処方法について説明します。代表的な障害とその対処方法を次の表に示します。

表7-57　代表的な障害とその対処方法（データ変換実行時の障害調査）

操作 | 代表的な障害 | 考えられる要因 | 対策 | 参照先マニュアル | 参照個所
XML電文のデータ変換の実行 | XML電文のデータ変換を実行した際に，KDEC40463-Eが出力され，データ変換に失敗する | XML電文の名前空間が間違っている（XMLのタグ名に付与されているプレフィクスと名前空間の宣言が間違っているなど）可能性があります。 | XML電文の名前空間を見直します。正しいXML電文に修正して，再度サービス呼び出しを実行します。 | Cosminexus サービスプラットフォーム 開発ガイド | 4章

7.8　障害発生時の自動運用

障害発生時に自動運用できるようにするための機能について記述します。

＜この節の構成＞

7.8.1　JP1連携機能を使用した障害の監視

7.8.2　Cosminexus サービスプラットフォームから通知するJP1イベントの詳細情報

7.8.1　JP1連携機能を使用した障害の監視

＜この項の構成＞

(1)　JP1によるメッセージの監視

(2)　JP1イベントの確認方法

(3)　JP1での監視を推奨するプロセス

(1)　JP1によるメッセージの監視

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

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

JP1の統合コンソールで監視するための設定については，「2.7　JP1連携機能を使用する場合の環境構築」を参照してください。メッセージマッピングファイル（JP1/IM連携用システムログメッセージマッピングファイル）については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「10.19　JP1/IM連携用システムログメッセージマッピングファイル」を参照してください。

(2)　JP1イベントの確認方法

JP1イベントの詳細情報は，JP1の統合コンソールから確認します。統合コンソールで詳細を表示したいJP1イベントを，ダブルクリックまたは右クリックから［イベント詳細表示］を選択すると，JP1イベントの詳細情報が表示されます。統合コンソールの表示方法については，次に示すマニュアルを参照してください。

JP1/Integrated Management - Manager　Version 9を使用する場合
マニュアル「JP1/Integrated Management - Manager 構築ガイド」，またはマニュアル「JP1/Integrated Management - Manager 運用ガイド」

JP1/Integrated Management - Manager　Version 8を使用する場合
マニュアル「JP1/Integrated Management - Manager システム構築・運用ガイド」

統合コンソールとJP1イベントの詳細情報の表示例を次の図に示します。

図7-75　統合コンソールとJP1イベントの詳細情報の表示例

(3)　JP1での監視を推奨するプロセス

JP1での監視を推奨するプロセスを次の表に示します。

表7-58　JP1での監視を推奨するプロセス

監視推奨プロセス | プロセス名
Windowsの場合 | UNIXの場合
Management Server | cjstartweb.exe | cjstartweb
運用管理エージェント | adminagent.exe | adminagent

また，データベースを使用している場合は，使用しているデータベースのプロセスもJP1の監視推奨プロセスとなります。それらのプロセス名については，各データベースのマニュアルを参照してください。

JP1によるプロセス監視については，マニュアル「Cosminexus サービスプラットフォーム 機能解説」の「8.1.2　JP1によるプロセス監視」を参照してください。

7.8.2　Cosminexus サービスプラットフォームから通知するJP1イベントの詳細情報

ここでは，JP1イベントの詳細情報のうち，Cosminexus サービスプラットフォーム特有の値について説明します。

＜この項の構成＞

(1)　イベントID

(2)　重大度

(3)　オブジェクトID

(4)　メッセージID

(1)　イベントID

発行アプリケーションプログラムや事象の内容を表す値です。重大度によって，次の表に示す値が表示されます。

表7-59　重大度とイベントID

重大度 | イベントID
Error | 0x00012093
Warning | 0x00012094
Information | 0x00012096

(2)　重大度

JP1イベントの緊急性を表します。緊急性の高い順に，次の値が表示されます。

Error：エラー

Warning：警告

Information：情報

(3)　オブジェクトID

「<論理サーバ名>：<J2EEアプリケーション名>」が表示されます。

論理サーバ名

Cosminexus サービスプラットフォーム構築時に設定したJ2EEサーバ名が表示されます。

J2EEアプリケーション名

メッセージ発行元のJ2EEアプリケーション名が特定できた場合，J2EEアプリケーション名が表示されます。J2EEアプリケーション名から，Cosminexus サービスプラットフォームの障害発生個所が特定できます。J2EEアプリケーション名とCosminexus サービスプラットフォームの障害発生個所を次の表に示します。

表7-60　J2EEアプリケーション名とCosminexus サービスプラットフォームの障害発生個所

J2EEアプリケーション名 | 障害発生個所
CSCMessaging | 実行環境（運用制御）
CSCMsgAsyncServiceDelivery | 実行環境（標準の非同期受付（MDB（WS-R）））
CSCMsgAsyncServiceDeliveryDBQ | 実行環境（標準の非同期受付（MDB（DBキュー）））
CSCMsgSyncServiceDelivery | 実行環境（標準の同期受付（SessionBean））
CSCMsgSyncServiceDeliveryWS | 実行環境（標準の同期受付（Webサービス・SOAP1.1））または実行環境（標準の同期受付（Webサービス・SOAP1.2））
サービスID | 該当するビジネスプロセスまたはサービスアダプタ

(4)　メッセージID

JP1イベントとして発行されたCosminexus サービスプラットフォームのメッセージIDが表示されます。KDECから始まるメッセージIDが表示されます。

7.9　HCSCサーバ障害発生後の回復方法

＜この節の構成＞

7.9.1　HCSCサーバのシステム運用ができなくなった場合の回復方法

7.9.2　クラスタ構成時の回復方法

7.9.3　運用環境のバックアップと復旧

7.9.4　デッドロックが発生した場合の回復方法

7.9.1　HCSCサーバのシステム運用ができなくなった場合の回復方法

HCSCサーバで障害が発生し，システムの運用ができない場合は，次のように対処してください。

＜この項の構成＞

(1)　復旧に必要な情報

(2)　復旧手順

(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)　ロードバランスクラスタ構成での障害と復旧

(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を使用している場合，キューを閉塞します。
キューの閉塞方法については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 拡張編」の「3.7.4　スケジュールキューの閉塞制御」を参照してください。

障害が発生したHCSCサーバから障害を取り除き，サービス部品の実行要求を受け付けられる状態にします。

CTMを使用している場合，キューの閉塞を解除します。
キューの閉塞を解除する方法については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 運用／監視／連携編」の「5.4.2　システムごとに実行できるサービスの閉塞方法およびJ2EEアプリケーションの停止方法」を参照してください。

障害を取り除いたHCSCサーバにサービス部品の実行要求を送信するよう，ロードバランサを設定します。
設定方法は，各ロードバランサの仕様によって異なります。

(2)　HAクラスタ構成での障害と復旧

実行系に障害が発生した場合，クラスタソフトウェアによって，処理は待機系に切り替えられます。待機系への切り替え後，実行系の障害を取り除いて，実行系での運用を再開させます。

注意

実行系に障害が発生し，待機系に運用が切り替わった場合，実行系の障害を取り除いて，実行系での運用に戻す必要があります。待機系をそのまま実行系として利用し，障害が発生した系の障害を取り除いて待機系として利用することはできません。

(a)　系の切り替え

実行系に障害が発生し，クラスタソフトで待機系に処理が切り替わるときの動作を次の図に示します。

図7-76　障害発生時の待機系への切り替え（HAクラスタ）

(b)　実行系の復旧

実行系に障害が発生し，待機系に運用が切り替わった場合，実行系の障害を取り除いて，実行系での運用に戻す必要があります。

実行系の障害を取り除いて，運用を実行系に戻す手順について次に示します。

実行系および待機系をサービスリクエスタ用のネットワークから切断するなどして，サービスリクエスタからの実行要求を受け付けない状態にします。

待機系の標準受付およびユーザ定義受付を停止します。
標準受付の停止方法については，「5.2.26　標準受付を停止する」を参照してください。
ユーザ定義受付の停止方法については，「5.2.27　ユーザ定義受付を停止する」を参照してください。

待機系のHCSCサーバを停止します。
HCSCサーバの停止方法については，「5.2.31　HCSCサーバを停止する」を参照してください。

実行系のHCSCサーバの障害を回復します。
障害情報の採取方法および障害の回復方法については，「7.　障害対策」を参照してください。

実行系のHCSCサーバを起動します。
HCSCサーバの起動方法については，「5.2.4　HCSCサーバを起動する」を参照してください。

実行系の標準受付およびユーザ定義受付を開始します。
標準受付の開始方法については，「5.2.9　標準受付を開始する」を参照してください。
ユーザ定義受付の開始方法については，「5.2.8　ユーザ定義受付を開始する」を参照してください。

実行系および待機系をサービスリクエスタ用のネットワークに接続するなどして，実行系でサービスリクエスタからの実行要求を受け付けられる状態にして運用を再開します。

7.9.3　運用環境のバックアップと復旧

運用環境に発生した障害を復旧する場合や，システムの規模の拡大に伴う運用マシンの移行などで環境を移行する場合に，環境の復旧に必要なファイルをバックアップできます。

＜この項の構成＞

(1)　運用環境のバックアップ

(2)　運用環境の復旧

(1)　運用環境のバックアップ

次に示すcscenvbackupコマンドを実行して，運用環境の復旧に必要な最新のファイルをバックアップします。

cscenvbackup -user <ログインユーザID> -pass <ログインパスワード> -backupdir  <バックアップファイル出力先ディレクトリ>

HCSC-Manager定義ファイルに，バックアップファイル出力先ディレクトリを指定している場合は，次に示すcscenvbackupコマンドを実行します。

cscenvbackup -user <ログインユーザID> -pass <ログインパスワード>

参考

運用環境バックアップファイルは，自動バックアップの場合にも取得できます。自動バックアップ時に取得される運用環境バックアップファイルは，次のところにあります。

HCSC-Manager定義ファイル（cscmng.properties）に指定した環境バックアップファイルの出力先

<Cosminexusインストールディレクトリ>¥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)　ディスク障害から復旧する場合の手順

手順を次に示します。

uCosminexus Service Platformをインストールしたマシンを用意します。必要に応じてソフトウェアをインストールします。

取得済みの運用環境バックアップファイルを復旧するマシンが認識できるところに格納します。

cscreplsコマンドを実行して，運用環境バックアップファイルの復旧する環境を確認します。

cscrepls -user <ログインユーザID> -pass <ログインパスワード> -envbackfile <運用環境バックアップファイル名>

cscenvrestoreコマンドを実行して，運用環境バックアップファイルを使用し，環境を復旧します。

cscenvrestore -user <ログインユーザID> -pass <ログインパスワード> -restorefile <運用環境のバックアップファイル名>

(b)　運用マシンを移行する場合の手順

手順を次に示します。

必要に応じて，cscenvbackupコマンドで復旧前の運用環境のバックアップファイルを取得します。
cscenvrestoreコマンドで運用環境を復旧させた場合，復旧前の運用環境は破棄されます。環境バックアップファイルは，自動バックアップ時と復旧直前とで内容が異なる場合があります。

uCosminexus 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のファイル名で次のディレクトリに出力されます。

<Cosminexusインストールディレクトリ>¥csc¥spool¥manager

なお，バックアップファイルの出力先ディレクトリは，HCSC-Manager定義ファイルのcscmng.envbackup.dirパラメタ，またはcscmng.envbackup.dir.envrestoreパラメタで変更できます。出力先ディレクトリに古いバックアップファイルが存在している場合は，復旧が成功したあとに，古いバックアップファイルが削除されます。

また，復旧時に自動バックアップをするかどうかは，HCSC-Manager定義ファイルのcscmng.envbackup.autogetパラメタ，またはcscmng.envbackup.autoget.offパラメタで設定できます。

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

7.9.4　デッドロックが発生した場合の回復方法

HCSCサーバ上のプロセスでデッドロックが発生した場合，次の方法でHCSCサーバを回復します。

＜この項の構成＞

(1)　HCSCサーバへのサービス部品呼び出し要求が応答しなくなった場合

(2)　HCSCコンポーネントや標準受付を停止できなくなった場合

(1)　HCSCサーバへのサービス部品呼び出し要求が応答しなくなった場合

HCSCサーバへのサービス部品呼び出し要求が応答しなくなった場合の調査手順を次に示します。

cjlistthreadコマンドを使用してスレッド情報を確認します。

cjstopthreadコマンドを使用して，不正なスレッドを削除します。

スレッドを削除できない場合はcscsvstopコマンドの-forceオプションを指定してHCSCサーバを強制停止してください。
HCSC-Managerの運用環境画面からは操作できないため，注意してください。

HCSCサーバを強制停止して停止が完了したら，cscsvstartコマンドを使用してHCSCサーバを再起動します。

cjstopthreadコマンドの使い方の詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjstopthread（スレッドの削除）」を参照してください。cjlistthreadコマンドの使い方の詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjlistthread（スレッド情報の表示）」を参照してください。スレッドの状態など，実行状態の確認方法については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 運用／監視／連携編」の「5.3.11　J2EEアプリケーションの実行状態の確認」を参照してください。cscsvstopコマンドの使い方の詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscsvstop（HCSCサーバの停止）」を参照してください。cscsvstartコマンドの使い方の詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscsvstart（HCSCサーバの起動）」を参照してください。

(2)　HCSCコンポーネントや標準受付を停止できなくなった場合

HCSCコンポーネントや標準受付を停止できなくなった場合の調査手順を次に示します。

スレッドを削除できない場合は，cscsvstopコマンドの-forceオプションを指定してHCSCサーバを強制停止します。
HCSC-Managerの運用環境画面からは操作できないため注意してください。

HCSCサーバを強制停止して停止が完了したら，cscsvstartコマンドを使用してHCSCサーバを再起動します。

csmlslocationコマンドやcscstatusコマンドを使用して，HCSCコンポーネントや標準受付の状態を確認します。
停止失敗状態（stopfailed）になっている場合は，HCSCコンポーネントの場合はcsccompostopコマンドを入力してHCSCコンポーネントの停止を試みてください。標準受付の場合は，cscrcptnstopコマンドに-stopfg forceを指定して強制停止を試みてください。
状態が停止状態（inactive）になれば，それぞれの起動コマンドを入力することで復旧します。

各コマンドの使い方の詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「4.　コマンド（運用環境・実行環境）」の該当するコマンドを参照してください。

7.10　メッセージトラッキングを利用した障害解析

Cosminexus サービスプラットフォームでは障害の発生に備えて，障害対策に必要な情報をログやトレースに取得しています。ここではログやトレースのうち，性能解析トレースファイルを利用して障害を解析する，メッセージトラッキングについて説明します。メッセージトラッキングは，障害が発生した個所を特定し，障害の切り分けや障害の調査を補助する障害解析ツールです。

なお，性能解析トレースファイルの詳細については，「7.4.3　性能解析トレース」を参照してください。

＜この節の構成＞

7.10.1　メッセージトラッキング機能の適用例

7.10.2　メッセージトラッキングの起動

7.10.3　性能解析トレースの表示

7.10.4　ルートアプリケーション情報の一覧表示

7.10.5　性能解析トレースの絞り込み

7.10.6　性能解析トレースの取得ポイントの表示

7.10.1　メッセージトラッキング機能の適用例

メッセージトラッキングは，障害発生時の性能解析トレースファイルがあれば，uCosminexus Service Architect，uCosminexus Service Platform，またはuCosminexus Operator for Service Platformがインストールされているマシンならどこでも利用できます。そのため，障害発生時の性能解析トレースファイルがあれば，障害が発生したHCSCサーバ稼働マシンだけでなく，障害が発生したHCSCサーバとは別のリモート環境でも障害を解析できます。

メッセージトラッキングの適用例を次に示します。

＜この項の構成＞

(1)　サービス部品への接続で障害が発生した場合

(2)　システム全体の障害を調査する場合

(3)　送信したリクエストの状況を確認する場合

(1)　サービス部品への接続で障害が発生した場合

サービス部品への接続で障害が発生した場合，性能解析トレースファイルを解析して，障害個所の特定および障害原因の切り分けをします。サービス部品への接続で障害が発生した場合の障害解析の流れを次の図に示します。

図7-77　サービス部品への接続で障害が発生した場合の障害解析の流れ

障害が発生したHCSCサーバ稼働マシンにアクセスし，性能解析トレースファイルを取得します。

CosminexusのJ2EEサーバ稼働ログの障害情報を確認し，ログに出力されているエラーメッセージから次の情報を取得します。

障害発生時刻

ルートアプリケーション情報

メッセージ共通ID

「RootApInfo = 」に続いて出力されている文字列がルートアプリケーション情報です。ルートアプリケーション情報は，「IPアドレス/プロセスID/通信番号」の形式で出力されます。
CosminexusのJ2EEサーバ稼働ログの出力例を次に示します。

メッセージトラッキングを起動します。
障害発生時刻で読み込む性能解析トレースファイルを絞り込んで，メッセージトラッキングを起動します。メッセージトラッキングの起動については，「7.10.2　メッセージトラッキングの起動」を参照してください。

ルートアプリケーション情報に一致する性能解析トレースを表示して障害を解析します。
ルートアプリケーション情報に一致する性能解析トレースの表示については，「7.10.3　性能解析トレースの表示」を参照してください。

(2)　システム全体の障害を調査する場合

プロセスのハングアップ，スローダウン，タイムアウトなどによってリクエストに遅延が発生した場合，性能解析トレースファイルのルートアプリケーション情報から，遅延しているリクエストの情報を確認します。遅延しているリクエストの情報から，障害個所を特定し，システム全体の障害を調査します。システム全体の障害を調査する場合の障害解析の流れを次の図に示します。

図7-78　システム全体の障害を調査する場合の障害解析の流れ

障害が発生したHCSCサーバ稼働マシンにアクセスし，性能解析トレースファイルを取得します。

メッセージトラッキングを起動します。
メッセージトラッキングの起動については，「7.10.2　メッセージトラッキングの起動」を参照してください。

性能解析トレースファイルのルートアプリケーション情報一覧を表示して，遅延しているリクエストの情報を確認します。
性能解析トレースファイルのルートアプリケーション情報一覧の表示については，「7.10.4　ルートアプリケーション情報の一覧表示」を参照してください。

3.で確認したルートアプリケーション情報に一致する性能解析トレースを表示し，遅延個所を特定します。

(3)　送信したリクエストの状況を確認する場合

送信したリクエストが返ってこない場合，またはリクエストがどこまで進んだのかを確認したい場合，リクエスト送信時刻で解析対象の性能解析トレースを絞り込んで，送信したリクエストの状況を確認します。送信したリクエストの状況を確認する場合の障害解析の流れを次の図に示します。

図7-79　送信したリクエストを確認する場合の障害解析の流れ

障害が発生したHCSCサーバ稼働マシンにアクセスし，性能解析トレースファイルを取得します。

メッセージトラッキングを起動します。
メッセージトラッキングの起動については，「7.10.2　メッセージトラッキングの起動」を参照してください。

リクエスト送信時刻で解析対象の性能解析トレースを絞り込みます。
解析対象の性能解析トレースの絞り込みについては，「7.10.5　性能解析トレースの絞り込み」を参照してください。

絞り込んだ性能解析トレースを解析して，送信したリクエストの状況を確認します。

7.10.2　メッセージトラッキングの起動

メッセージトラッキングの前提条件と起動方法について説明します。

＜この項の構成＞

(1)　前提条件

(2)　起動方法

(1)　前提条件

メッセージトラッキングを使用するには，事前に性能解析トレースファイルを取得しておいてください。性能解析トレースファイルの取得方法については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 保守／移行／互換編」の「6.　性能解析トレースを使用したシステムの性能解析」を参照してください。

(2)　起動方法

メッセージトラッキングは，cscmsgtkコマンドで起動します。

cscmsgtkコマンドを実行すると，性能解析トレースファイルが読み込まれ，メッセージトラッキングが起動されます。メッセージトラッキングが起動されると，メッセージトラッキング専用の対話型のプロンプト（以降，メッセージトラッキングプロンプトと呼びます）が表示されます。メッセージトラッキングプロンプトでコマンドを実行し，障害を解析します。

cscmsgtkコマンドおよびメッセージトラッキングプロンプトで実行するコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「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　性能解析トレースの表示

CosminexusのJ2EEサーバ稼働ログ，ルートアプリケーション情報の一覧表示などで取得したルートアプリケーション情報から，ルートアプリケーション情報に一致する性能解析トレースを表示します。ルートアプリケーション情報の一覧表示については，「7.10.4　ルートアプリケーション情報の一覧表示」を参照してください。

＜この項の構成＞

(1)　ルートアプリケーション情報に一致する性能解析トレースの表示

(2)　性能解析トレースの詳細情報表示

(1)　ルートアプリケーション情報に一致する性能解析トレースの表示

メッセージトラッキングプロンプトに，ルートアプリケーション情報を入力します。入力すると，メッセージトラッキングの起動時に読み込んだ性能解析トレースの中から，入力したルートアプリケーション情報に一致する性能解析トレースの情報が時系列に出力されます。出力された性能解析トレースの情報から，応答に時間が掛かっている個所やリターンコードがエラーになっているトレースを確認できます。

(a)　入力形式

メッセージトラッキングプロンプトでprfコマンドを実行します。prfコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「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行目は性能解析トレースの数分出力されます。

なお，出力モードを詳細出力モードにした場合，Cosminexus サービスプラットフォーム以外で取得した性能解析トレースも出力されます。出力モードについては，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscmsgtk（メッセージトラッキング機能の起動）」にある出力モード切り替えコマンドを参照してください。

1行目：出力開始日時

性能解析トレースの出力を開始した日時が「yyyy/MM/dd hh:mm:ss.SSS」の形式で出力されます。

yyyy：西暦

MM：月

dd：日

hh：時

mm：分

ss：秒

SSS：ミリ秒

2行目：カラム

性能解析トレースに対応するカラムが出力されます。出力形式と同じ内容が出力されます。

3行目：性能解析トレースの内容

カラムに対応する性能解析トレースの内容が出力されます。

表示項目
対応するカラム
説明

通番
No.
通番を示します。

一つ前に出力されたトレースからの経過時間
interval(msec)
一つ前に出力された性能解析トレースからの経過時間（ミリ秒）を示します。半角数字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行目：性能解析トレースのポイント名

性能解析トレースのポイント名が出力されます。なお，Cosminexus サービスプラットフォームのトレースポイント以外で取得した性能解析トレースの場合は，「－」が出力されます。

表示項目
説明

機能レイヤ
性能解析トレースを出力する機能の層を示します。次のどれかが出力されます。

HCSC（MSG）：メッセージング基盤

HCSC（BP）：ビジネスプロセス基盤

HCSC（DT）：データ変換基盤

HCSC（DBA）：DBアダプタ

HCSC（FFA）：ファイルアダプタ

HCSC（MQA）：Message Queueアダプタ

HCSC（OAA）：Object Accessアダプタ

HCSC（FTP）：FTPアダプタ

HCSC（FOA）：ファイル操作アダプタ

HCSC（FTR）：FTP受付

HCSC（FTI）：FTPインバウンドアダプタ

トレース取得ポイント
各機能レイヤで性能解析トレースを出力するポイントを示します。

対応するイベント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コマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscmsgtk（メッセージトラッキング機能の起動）」にある障害解析コマンドを参照してください。

prfコマンドの実行形式を次に示します。

prf <ルートアプリケーション情報のIPアドレス>/<ルートアプリケーション情報のプロセスID>/<ルートアプリケーション情報の通信番号> 通番

(b)　出力形式

性能解析トレースのASCIIカラムに出力されている内容が出力されます。ASCIIカラムに設定されていない場合は，何も出力されません。

(c)　出力例

出力例を次に示します。

トレース通番117の詳細情報を出力した場合

トレース通番121の詳細情報を出力した場合

7.10.4　ルートアプリケーション情報の一覧表示

読み込んだ性能解析トレースファイルのルートアプリケーション情報一覧を性能解析トレースの出力開始順に表示します。表示件数，表示する内容および順番を指定できます。

＜この項の構成＞

(1)　入力形式

(2)　出力形式

(3)　出力例

(1)　入力形式

メッセージトラッキングプロンプトでlsコマンドを実行します。lsコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscmsgtk（メッセージトラッキング機能の起動）」にある一覧表示コマンドを参照してください。

表示件数を指定する場合

指定した件数のルートアプリケーション情報が表示されます。出力順はオプション指定によって異なりますが，新しい情報から指定した件数分を表示します。

実行形式を次に示します。

ls <表示する件数>

エラーが発生したルートアプリケーション情報を表示する場合

-eオプションを指定して実行します。エラーが発生したルートアプリケーション情報だけが表示されます。

実行形式を次に示します。

ls -e

エラーの発生している個所がCosminexus サービスプラットフォームのトレースポイント以外の場合，「7.10.3　性能解析トレースの表示」の方法でトレースを表示しても，エラー個所のトレースは表示されません。そのため，Cosminexus サービスプラットフォーム以外で発生したエラーを確認したい場合は，出力モードを詳細出力モードにして，すべての性能解析トレースを出力してください。出力モードについては，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「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-80　性能解析トレースの絞り込みで解析対象となるトレース

注※

通常起動，範囲指定起動のどちらで起動した場合でも性能解析トレースを絞り込むことができます。メッセージトラッキングの起動については，「7.10.2　メッセージトラッキングの起動」を参照してください。

性能解析トレースを絞り込むには，メッセージトラッキングプロンプトでfocusコマンドを実行します。focusコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscmsgtk（メッセージトラッキング機能の起動）」にある解析対象絞り込みコマンドを参照してください。

注意

解析対象が存在しない日時を指定した場合は，警告メッセージが表示されます。その場合は，絞り込み日時を省略してfocusコマンドで実行し，解析対象を起動時の状態に戻してください。

7.10.6　性能解析トレースの取得ポイントの表示

性能解析トレースの取得ポイントを表示します。イベントIDを指定してトレース取得ポイントを表示する場合と，Cosminexus サービスプラットフォームのすべてのトレース取得ポイントを表示する場合があります。

＜この項の構成＞

(1)　入力形式

(2)　出力形式

(1)　入力形式

メッセージトラッキングプロンプトでidコマンドを実行します。idコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「cscmsgtk（メッセージトラッキング機能の起動）」にあるトレース取得ポイント表示コマンドを参照してください。

イベントIDを指定してトレース取得ポイントを表示する場合

指定したイベントIDのトレース取得ポイントが表示されます。

実行形式を次に示します。

id <イベントID>

Cosminexus サービスプラットフォーム以外のイベントID，または存在しないイベントIDを指定した場合はエラーになります。

Cosminexus サービスプラットフォームのすべてのトレース取得ポイントを表示する場合

Cosminexus サービスプラットフォームのすべてのトレース取得ポイントが表示されます。

実行形式を次に示します。

id list

(2)　出力形式

出力形式を次に示します。

イベントIDを指定してトレース取得ポイントを表示した場合

機能レイヤ：トレース取得ポイント(対応するイベントID)

Cosminexus サービスプラットフォームのすべてのトレース取得ポイントを表示した場合

イベントID=機能レイヤ：トレース取得ポイント(対応するイベントID)

トレース取得ポイントの数分出力されます。

表示項目を次に説明します。

表示項目
説明

イベントID
トレース取得ポイントを示すイベントIDを示します。

機能レイヤ
性能解析トレースを出力する機能の層を示します。次のどれかが出力されます。

HCSC（MSG）：メッセージング基盤

HCSC（BP）：ビジネスプロセス基盤

HCSC（DT）：データ変換基盤

HCSC（DBA）：DBアダプタ

HCSC（FFA）：ファイルアダプタ

HCSC（MQA）：Message Queueアダプタ

HCSC（OAA）：Object Accessアダプタ

HCSC（FTP）：FTPアダプタ

HCSC（FOA）：ファイル操作アダプタ

HCSC（FTR）：FTP受付

HCSC（FTI）：FTPインバウンドアダプタ

トレース取得ポイント
各機能レイヤで性能解析トレースを出力するポイントを示します。

対応するイベントID
取得ポイントに対応するイベントIDを示します。起点（入口）で取得されたトレースの場合は「-<対応するイベントID>」が，終点（出口）で取得されたトレースの場合は「<対応するイベントID>-」が出力されます。存在しない場合は出力されません。

(a)　出力例

出力例を次に示します。

イベントIDを指定してトレース取得ポイントを表示した場合

Cosminexus サービスプラットフォームのすべてのトレース取得ポイントを表示した場合

7.11　例外発生時に取得するエラーの選択

サービスアダプタからサービス部品（Webサービス）を呼び出したときに発生したエラーの例外を，そのままスローするか，サービスアダプタでフォルト電文に変換するか選択できます。

＜この節の構成＞

7.11.1　例外をそのままスローする場合とフォルト電文に変換する場合の処理の違い

7.11.2　例外をフォルト電文へ変換する場合の設定

7.11.3　フォルト電文を定義するスキーマファイル

7.11.1　例外をそのままスローする場合とフォルト電文に変換する場合の処理の違い

エラーの例外をサービスアダプタでフォルト電文に変換すると，ビジネスプロセスでエラーとしてキャッチできます。

例外をそのままスローする場合とフォルト電文に変換する場合の処理の違いを次に示します。

図7-81　例外をそのままスローする場合とフォルト電文に変換する場合の処理の違い

なお，サービスアダプタで変換されたフォルト電文をビジネスプロセスでキャッチする場合，フォルト処理を行うアクティビティの配置が必要です。フォルト処理の定義については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「6.4.3　フォルト処理を定義する」を参照してください。

7.11.2　例外をフォルト電文へ変換する場合の設定

エラーの例外をフォルト電文へ変換するかしないかは，サービスアダプタ定義画面でアダプタを定義するときに設定します。アダプタの定義方法については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「5.　アダプタの定義」を，サービスアダプタ定義画面の詳細は，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「1.2.2　サービスアダプタ定義画面」を参照してください。

7.11.3　フォルト電文を定義するスキーマファイル

エラーの例外をフォルト電文に変換する設定にした場合に，フォルト電文を定義するスキーマファイルについて説明します。

＜この項の構成＞

(1)　ファイルの格納先

(2)　形式

(3)　注意事項

(1)　ファイルの格納先

フォルト電文を定義するスキーマファイルの格納先を次に示します。

<Cosminexusのインストールディレクトリ>¥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　OutOfMemoryError発生時の運用

この節では，OutOfMemoryErrorの発生を抑止する方法や，OutOfMemoryError発生時の影響などについて説明します。

＜この節の構成＞

7.12.1　業務への影響を抑止する機能

7.12.2　UOC実行時の注意事項

7.12.1　業務への影響を抑止する機能

JavaVMのヒープサイズの上限を超えるなどの原因でメモリ不足が発生すると，「java.lang.OutOfMemoryError」のメッセージが表示されることがあります。OutOfMemoryErrorが発生しても業務への影響を少なくするには，次に示す機能を設定してください。

OutOfMemory発生時強制終了機能
OutOfMemoryErrorが発生した場合に，J2EEサーバを強制終了するための機能です。この機能を設定すると，J2EEサーバを強制終了してすぐ自動再起動し，正常に稼働できる状態にするため，OutOfMemoryErrorが発生した業務以外の業務への影響を抑えられます。

OutOfMemoryハンドリング機能
OutOfMemory発生時強制終了機能を使用している場合でも，J2EEサーバの実行を継続するための機能です。この機能を設定すると，メモリ不足が発生した業務だけが中止されるため，OutOfMemoryErrorが発生した業務以外の業務は継続されます。

注意

OutOfMemoryハンドリング機能を設定している場合でも，次に示すコンポーネントを利用した業務の実行中にOutOfMemoryErrorが発生すると，J2EEサーバがシステムダウンしてすべてのプロセスが中断されます。メモリ不足が発生した業務だけを中止することはできないため，注意が必要です。

標準受付（MDB(WSR)）

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

標準アダプタ（MDB(WSR)）

標準アダプタ（MDB(DBキュー)）

非同期のビジネスプロセス

7.12.2　UOC実行時の注意事項

UOCの実行時に確保されたリソースは，処理終了後も解放されません。そのため，システム全体の負荷が高くなると，Javaヒープ不足などによってOutOfMemoryErrorが発生する場合があります。

次に示す機能はUOCを利用するため，実行するとOutOfMemoryErrorが発生するおそれがあります。OutOfMemoryErrorの発生に備えて，UOCの作成時にはリソースを適切に解放する処理や，ロールバックなどのエラー処理を実装しておく必要があります。

javaアクティビティ

ユーザ定義ファンクション

文字コード変換UOC

カスタムアダプタ

カスタム受付

付録

＜この付録の構成＞

付録A　Cosminexus Service Coordinator管理者の変更方法

付録B　画面とコマンドで実施できる内容

付録C　データベースのテーブルの情報

付録D　SQLスクリプトファイルの設定

付録E　HCSCサーバのリソース稼働情報の統計情報

付録F　JP1イベント通知をするメッセージ

付録G　旧バージョンからの移行

付録H　運用環境でリポジトリを旧バージョンから移行する方法

付録I　このマニュアルの参考情報

付録J　用語解説

付録A　Cosminexus Service Coordinator管理者の変更方法

UNIXの場合に，cjenvsetup（Cosminexus Component Container管理者のセットアップ）コマンドを使用してCosminexus Component Container管理者を変更したときは，Cosminexus Service Coordinator管理者を変更する必要があります。

Cosminexus Service Coordinator管理者の変更は，次の操作をしたあとに実施してください。

Cosminexus Component Container管理者の変更（cjenvsetupコマンド）

Cosminexus Service Coordinatorのインストール

実行環境のバージョンアップ（cscenvupdateコマンド）

HCSCサーバのセットアップ（cscsvsetupコマンド）

Cosminexus Service Coordinator管理者の変更方法と注意事項について次に説明します。なお，ここでは，管理者のオーナーをuser1，グループをgroup1として説明します。

＜この節の構成＞

付録A.1　変更方法

付録A.2　注意事項

付録A.1　変更方法

＜この項の構成＞

(1)　/opt/Cosminexus/CSCディレクトリ配下のファイル属性の変更

(2)　リポジトリルート配下のファイル属性の変更

(3)　ログディレクトリ配下のファイル属性の変更

(4)　応答電文出力ディレクトリ配下のファイル属性の変更

(5)　システム管理情報ディレクトリ配下のファイル属性の変更

(6)　SQLスクリプトファイルのファイル属性の変更

(7)　SOAP Fault動作定義ファイルのファイル属性の変更

(8)　ユーザ電文トレースのファイル属性の変更

(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動作定義ファイルのファイル属性の変更

csmlsstateコマンドでHCSCサーバのランタイム情報を参照し，次のように変更します。

soapfault-targetnamespace-filepathプロパティを指定している場合

SOAP Fault動作定義ファイルのファイル属性を，管理者のオーナー，グループに変更します。

（例）SOAP Fault動作定義ファイルに/home/user1/soapfaultnameを設定しているとき

chown user1 /home/user1/soapfaultname

chgrp group1 /home/user1/soapfaultname

(8)　ユーザ電文トレースのファイル属性の変更

csmlsstateコマンドでHCSCサーバのランタイム情報を参照し，次のように変更します。

telegramtrace-filepathプロパティを指定している場合

ユーザ電文トレースのファイル属性を，管理者のオーナー，グループに変更します。

（例）ユーザ電文トレース出力先パスに/home/user1/telegramtracefileを設定しているとき

chown user1 /home/user1/telegramtracefile

chgrp group1 /home/user1/telegramtracefile

付録A.2　注意事項

Cosminexus Service Coordinator管理者は，Cosminexus Component Container管理者と同一にしてください。

リポジトリルート（cscmng.repository.root），ログディレクトリ（cscmng.log.dir），応答電文出力ディレクトリ（cscmng.pireexec.response.dir）に指定したディレクトリ配下に，ファイルを生成しないでください。また，すでにファイルが存在しているディレクトリ（/opt，/usrなど）を設定しないでください。

管理者の変更は，Cosminexus Component Container，Cosminexus Manager，およびCosminexus 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　画面とコマンドで実施できる内容

Cosminexus サービスプラットフォームでは，システム構築およびシステム運用時に，コマンドと画面で実施できる内容が異なります。画面とコマンドで実施できる内容を次の表に示します。

表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
csmlsstate

HCSCサーバのリソースの稼働情報の表示
×
○
cscresinfo

標準受付，またはユーザ定義受付
標準受付またはユーザ定義受付の開始
○
○
cscrcptnstart

標準受付またはユーザ定義受付の停止
○
○
cscrcptnstop

標準受付またはユーザ定義受付の稼働状態の確認
○
○
cscstatus

HCSCコンポーネント
HCSCコンポーネントの開始
○
○
csccompostart

HCSCコンポーネントの停止
○
○
csccompostop

HCSCコンポーネントのランタイム情報の確認
○
○
csccompoconfig

HCSCコンポーネントの稼働状態の確認
○
○
cscstatus

プロセスインスタンス
プロセスインスタンスの実行履歴の検索
○
○
cscpiselect

プロセスインスタンスの実行履歴の相関セット情報の取得
○
○
cscpiselect

プロセスインスタンスの実行履歴の変数情報の取得
○
○
cscpiselect

プロセスインスタンスの実行履歴のアクティビティ情報の取得
○
○
cscpiselect

プロセスインスタンスの実行履歴の削除
○
○
cscpidelete

プロセスインスタンスの実行履歴の一括削除
○
○
cscpidelete

プロセスインスタンスの再実行
○
○
cscpireexec

プロセスインスタンスの一括再実行
○
○
cscpireexec

アプリケーション
アプリケーションの操作
×
○
cscapputil

ツール
HCSCサーバ
HCSCサーバのバージョンアップ
×
○
cscenvupdate

メッセージトラッキング
メッセージトラッキングの起動
×
○
cscmsgtk

リポジトリ
リポジトリのアップデート
×
○
cscrepupdate

実行環境
実行履歴管理
電文
電文の実行履歴の表示
×
○
csmlshistory

電文の実行履歴の削除
×
○
csmdeletehistory

情報表示
配備したサービスアダプタまたはビジネスプロセスの情報表示
×
○
csmlslocation

配備したユーザ定義受付の情報表示
×
○
csmlsreception

HCSCサーバの状態および設定情報の一覧表示
×
○
csmlsstate

（凡例）

○：実施できます。

×：実施できません。

付録C　データベースのテーブルの情報

＜この節の構成＞

付録C.1　プロセスインスタンスの実行履歴の管理に関するテーブルの情報

付録C.2　電文の実行履歴の管理に関するテーブルの情報

付録C.3　実行環境の設定に関するテーブルの情報

付録C.1　プロセスインスタンスの実行履歴の管理に関するテーブルの情報

＜この項の構成＞

(1)　テーブルの情報

(2)　ステータスの情報

(3)　インデクスの情報

(4)　ビュー表の情報

(1)　テーブルの情報

HCSCクラスタごとに，次に示すテーブルが必要です。

基本情報テーブル

変数情報テーブル

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

(a)　基本情報テーブル

ビジネスプロセスが実行する上で基本的な要素（インスタンス）の情報が格納されます。

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

注※1　実行時に内部管理用に使用される項目のため，値を意識する必要はありません。

注※2　08-10以前のバージョンの場合，「SMALLINT」になります。

また，08-10以前のバージョンから上書きインストールした場合，領域は変更されないため，「SMALLINT」になります。

注※3　08-10以前のバージョンの場合，「NUMBER(5)」になります。

また，08-10以前のバージョンから上書きインストールした場合，領域は変更されないため，「NUMBER(5)」になります。

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

注※1　実行時に内部管理用に使用される項目のため，値を意識する必要はありません。

注※2　08-10以前のバージョンの場合，「SMALLINT」になります。

また，08-10以前のバージョンから上書きインストールした場合，領域は変更されないため，「SMALLINT」になります。

注※3　08-10以前のバージョンの場合，「NUMBER(5)」になります。

また，08-10以前のバージョンから上書きインストールした場合，領域は変更されないため，「NUMBER(5)」になります。

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) | なし | 不可 | 不可 | 不可

注※1　実行時に内部管理用に使用される項目のため，値を意識する必要はありません。

注※2　08-10以前のバージョンの場合，「SMALLINT」になります。

また，08-10以前のバージョンから上書きインストールした場合，領域は変更されないため，「SMALLINT」になります。

注※3　08-10以前のバージョンの場合，「NUMBER(5)」になります。

また，08-10以前のバージョンから上書きインストールした場合，領域は変更されないため，「NUMBER(5)」になります。

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) | なし | 不可 | 可 | 不可

注※1　08-10以前のバージョンの場合，「SMALLINT」になります。

また，08-10以前のバージョンから上書きインストールした場合，領域は変更されないため，「SMALLINT」になります。

注※2　08-10以前のバージョンの場合，「NUMBER(5)」になります。

また，08-10以前のバージョンから上書きインストールした場合，領域は変更されないため，「NUMBER(5)」になります。

(b)　変数情報テーブル

ユーザが定義した変数について，ビジネスプロセスが実行していく過程での変数の値が格納されます。

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 | 可 | 不可

注※1　08-10以前のバージョンの場合，「SMALLINT」になります。

また，08-10以前のバージョンから上書きインストールした場合，領域は変更されないため，「SMALLINT」になります。

注※2　08-10以前のバージョンの場合，「NUMBER(5)」になります。

また，08-10以前のバージョンから上書きインストールした場合，領域は変更されないため，「NUMBER(5)」になります。

注※3　HiRDBの場合はNULL値を指定できませんが，Oracleの場合はNULL値を指定できます。

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 | なし | 不可 | 可 | 不可

注※1　08-10以前のバージョンの場合，「SMALLINT」になります。

また，08-10以前のバージョンから上書きインストールした場合，領域は変更されないため，「SMALLINT」になります。

注※2　08-10以前のバージョンの場合，「NUMBER(5)」になります。

また，08-10以前のバージョンから上書きインストールした場合，領域は変更されないため，「NUMBER(5)」になります。

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) | なし | 不可 | 可 | 不可

注※1　08-10以前のバージョンの場合，「SMALLINT」になります。

また，08-10以前のバージョンから上書きインストールした場合，領域は変更されないため，「SMALLINT」になります。

注※2　08-10以前のバージョンの場合，「NUMBER(5)」になります。

また，08-10以前のバージョンから上書きインストールした場合，領域は変更されないため，「NUMBER(5)」になります。

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 | 可 | 不可

注※1　08-10以前のバージョンの場合，「SMALLINT」になります。

また，08-10以前のバージョンから上書きインストールした場合，領域は変更されないため，「SMALLINT」になります。

注※2　08-10以前のバージョンの場合，「NUMBER(5)」になります。

また，08-10以前のバージョンから上書きインストールした場合，領域は変更されないため，「NUMBER(5)」になります。

注※3　HiRDBの場合はNULL値を指定できませんが，Oracleの場合はNULL値を指定できます。

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

メッセージ履歴との関連づけデータが格納されます。

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 | 非同期メッセージングでのID | VARCHAR(255) | VARCHAR2(255) | あり | 可 | 不可 | NULL

注※1　実行時に内部管理用に使用される項目のため，値を意識する必要はありません。

注※2　08-10以前のバージョンの場合，「SMALLINT」になります。

また，08-10以前のバージョンから上書きインストールした場合，領域は変更されないため，「SMALLINT」になります。

注※3　08-10以前のバージョンの場合，「NUMBER(5)」になります。

また，08-10以前のバージョンから上書きインストールした場合，領域は変更されないため，「NUMBER(5)」になります。

(2)　ステータスの情報

テーブルに格納する値の意味と実際の値（文字列）を説明します。

(a)　HCSCクラスタ名

英数字8文字以内を指定します。

(b)　プロセスインスタンスの識別子

プロセスインスタンスを一意に識別する識別子です。

(c)　プロセスインスタンスの状態

項番 | 名称 | 説明 | データベース上の値
1 | 未実行 | プロセスインスタンスが未実行で，今後実行される可能性のある状態を示します。 | Unexecution
2 | 実行中 | プロセスインスタンスが実行中の状態を示します。 | Executing
3 | エラー発生 | サービス呼出アクティビティで例外が発生し，プロセスインスタンスがエラーで中断した状態を示します。 | Error
4 | 完了 | プロセスのグローバルスコープが完了して，プロセスインスタンスが完了した状態を示します。 | Completed
5 | フォルト終了 | フォルトが発生し，グローバルスコープでもキャッチできないで，プロセスインスタンスがフォルト終了した状態を示します。 | Faulted
6 | 強制終了 | 終了アクティビティで，プロセスインスタンスが強制終了した状態を示します。 | 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

(e)　アクティビティインスタンスの状態

項番 | 名称 | 説明 | データベース上の値
1 | 未実行 | アクティビティのインスタンスが未実行で，今後実行される可能性のある状態を示します。 | Unexecution
2 | 未省略 | アクティビティのインスタンスが未実行で，今後実行が省略される状態を示します。 | Unomission
3 | 実行中 | アクティビティインスタンスが実行中の状態を示します。 | Executing
4 | 待ち受け | 受付アクティビティのインスタンスが受け付け可能になっている状態を示します。 | Awaiting
5 | フォルト中 | スコープアクティビティのインスタンスがフォルト処理でキャッチしたアクティビティを実行している状態を示します。 | Faulting
6 | エラー発生 | サービス呼出アクティビティで例外が発生し，プロセスインスタンスがエラーで中断した状態を示します。 | Error
7 | 完了 | アクティビティのインスタンスが正常に実行され終了した状態を示します。 | Completed
8 | キャンセル | フォルトが発生しアクティビティのインスタンスの実行がキャンセルされた状態を示します。 | Canceled
9 | フォルト終了 | アクティビティのインスタンスの実行中にフォルトが発生して終了した状態を示します。 | Faulted
10 | 実行省略 | アクティビティのインスタンスの実行が省略され終了した状態を示します。 | Omitted

(f)　リンクの状態

項番 | 名称 | 説明 | データベース上の値
1 | 真 | true活性の状態を示します。 | 1
2 | 偽 | false活性の状態を示します。 | 0

(g)　相関セットの状態

項番 | 名称 | 説明 | データベース上の値
1 | 有効 | 有効状態を示します。 | 1
2 | 無効 | 無効状態を示します。 | 0

(h)　真偽値型変数の変数値

項番 | 名称 | 説明 | データベース上の値
1 | 真 | 真（true）値を示します。 | 1
2 | 偽 | 偽（false）値を示します。 | 0

(i)　メッセージの送受信フラグ

項番 | 名称 | 説明 | データベース上の値
1 | reply送信 | 該当メッセージを応答アクティビティで送信したことを示すフラグです。 | S
2 | receive受信 | 該当メッセージを受付アクティビティで受信したことを示すフラグです。 | R
3 | invoke送信 | 該当メッセージをサービス呼出アクティビティで送信したことを示すフラグです。 | O
4 | Invoke受信 | 該当メッセージをサービス呼出アクティビティで受信したことを示すフラグです。 | 'I'

(j)　所属する繰り返し処理の識別番号（RepeatNumber）

親アクティビティ定義が繰り返し処理の場合，自アクティビティインスタンスの識別番号を設定します。

親アクティビティ定義が繰り返し処理でない場合，親アクティビティインスタンスの繰り返し処理の識別番号を設定します。

(k)　子アクティビティインスタンスの最小識別番号・最大識別番号（FirstChildNumber/LastChildNumber）

初期値は，自アクティビティのインスタンスの識別番号を示します。

子アクティビティインスタンスの生成時に，それらの識別番号の最小値または最大値を設定します。

(3)　インデクスの情報

それぞれのテーブルに付与するインデクスの情報について，次に示します。

CSCBP_<クラスタ名>_PROCESSテーブルのインデクス

項番 | インデクス名 | UNIQUE属性 | インデクス中の順位 | カラム名
1 | CSCBP_<クラスタ名>_PROCESS_IDX1 | あり | 1 | ProcessID
2 | CSCBP_<クラスタ名>_PROCESS_IDX2 | なし | 1 | ProcessDefinitionName
2 | State
3 | StartTime
3 | CSCBP_<クラスタ名>_PROCESS_IDX3 | なし | 1 | ProcessDefinitionName
2 | State
3 | EndTime

CSCBP_<クラスタ名>_ACTIVITYテーブルのインデクス

項番 | インデクス名 | UNIQUE属性 | インデクス中の順位 | カラム名
1 | CSCBP_<クラスタ名>_ACTIVITY_IDX | あり | 1 | ProcessID
2 | ActivityNumber

CSCBP_<クラスタ名>_LINKテーブルのインデクス

項番 | インデクス名 | UNIQUE属性 | インデクス中の順位 | カラム名
1 | CSCBP_<クラスタ名>_LINK_IDX | あり | 1 | ProcessID
2 | LinkDefinitionName
3 | RepeatNumber

CSCBP_<クラスタ名>_CORRELATIONSETテーブルのインデクス

項番 | インデクス名 | UNIQUE属性 | インデクス中の順位 | カラム名
1 | CSCBP_<クラスタ名>_CORREL_IDX1 | あり | 1 | ProcessID
2 | ScopeNumber
3 | CorrelationSetName
2 | CSCBP_<クラスタ名>_CORREL_IDX2 | あり | 1 | ProcessDefinitionName
2 | ScopeDefinitionName
3 | CorrelationSetName
4 | CorrelationSetValue

CSCBP_<クラスタ名>_STR_VARIABLEテーブルのインデクス

項番 | インデクス名 | UNIQUE属性 | インデクス中の順位 | カラム名
1 | CSCBP_<クラスタ名>_STR_VAR_IDX | あり | 1 | ProcessID
2 | ScopeNumber
3 | VariableName

CSCBP_<クラスタ名>_NUM_VARIABLEテーブルのインデクス

項番 | インデクス名 | UNIQUE属性 | インデクス中の順位 | カラム名
1 | CSCBP_<クラスタ名>_NUM_VAR_IDX | あり | 1 | ProcessID
2 | ScopeNumber
3 | VariableName

CSCBP_<クラスタ名>_BOOL_VARIABLEテーブルのインデクス

項番 | インデクス名 | UNIQUE属性 | インデクス中の順位 | カラム名
1 | CSCBP_<クラスタ名>_BOOL_VAR_IDX | あり | 1 | ProcessID
2 | ScopeNumber
3 | VariableName

CSCBP_<クラスタ名>_MSG_VARIABLEテーブルのインデクス

項番 | インデクス名 | UNIQUE属性 | インデクス中の順位 | カラム名
1 | CSCBP_<クラスタ名>_MSG_VAR_IDX | あり | 1 | ProcessID
2 | ScopeNumber
3 | VariableName

CSCBP_<クラスタ名>_MSG_RELATIONテーブルのインデクス

項番 | インデクス名 | UNIQUE属性 | インデクス中の順位 | カラム名
1 | CSCBP_<クラスタ名>_MSG_REL_IDX1 | なし | 1 | MessageID
2 | CSCBP_<クラスタ名>_MSG_REL_IDX2 | あり | 1 | ProcessID
2 | ActivityNumber
3 | SendOrReceive
3 | CSCBP_<クラスタ名>_MSG_REL_IDX3 | なし | 1 | AsynchronousMessagingID

(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※ | ACTIVITY | ParentNumber
8 | ScopeNumber | ACTIVITY | ScopeNumber
9 | RepeatNumber※ | ACTIVITY | RepeatNumber
10 | State | ACTIVITY | State
11 | FirstChildNumber※ | ACTIVITY | FirstChildNumber
12 | LastChildNumber※ | ACTIVITY | LastChildNumber
13 | StartTime | ACTIVITY | StartTime
14 | EndTime | ACTIVITY | EndTime
15 | WaitTime | ACTIVITY | WaitTime

注※　実行時に内部管理用に使用される項目のため，値を意識する必要はありません。

CSCBP_<クラスタ名>_V_LINKビュー表

項番 | 列名 | 参照先テーブル | 参照先カラム
1 | ProcessID | LINK | ProcessID
2 | ProcessDefinitionName | PROCESS | ProcessDefinitionName
3 | ProcessDefinitionVersion | PROCESS | ProcessDefinitionVersion
4 | LinkDefinitionName | LINK | LinkDefinitionName
5 | RepeatNumber※ | LINK | RepeatNumber
6 | State | LINK | State

注※　実行時に内部管理用に使用される項目のため，値を意識する必要はありません。

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

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

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

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

付録C.2　電文の実行履歴の管理に関するテーブルの情報

＜この項の構成＞

(1)　テーブルの情報

(2)　インデクスの情報

(1)　テーブルの情報

クラスタごとに，次に示すテーブルが必要です。

実行履歴情報テーブル

(a)　実行履歴情報テーブル

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)　テーブルの情報

(1)　テーブルの情報

HCSCサーバまたはクラスタごとに，次に示すテーブルが必要です。

HCSC基本情報テーブル

HCSC連携ディレクトリ情報テーブル

ロケーションディレクトリ情報テーブル

ルーティングルールディレクトリ情報テーブル

データ変換定義ディレクトリ情報テーブル

クラスタ基本情報管理テーブル

非同期アダプタサービスID管理テーブル

(a)　HCSC基本情報テーブル

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テーブル

項番
列名
説明
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テーブル

項番
列名
説明
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

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テーブル

項番
列名
説明
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テーブル

項番 | 列名 | 説明 | 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テーブル

項番
列名
説明
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テーブル

項番
列名
説明
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テーブル

項番
列名
説明
HiRDB型
ORACLE型
インデクスの有無
NULL値
UNIQUE属性

1
CSC_SERVER_NAME※
セットアップされた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
標準受付SOAPがセットアップされているかどうか

0：セットアップされていない

1：セットアップされている

INTEGER
NUMBER(1)
なし
不可
なし

5
EJB_RCP
標準受付EJBがセットアップされているかどうか

0：セットアップされていない

1：セットアップされている

INTEGER
NUMBER(1)
なし
不可
なし

6
WSR_RCP
標準受付WS-Rがセットアップされているかどうか

0：セットアップされていない

1：セットアップされている

INTEGER
NUMBER(1)
なし
不可
なし

7
DBQ_RCP
標準受付DBQがセットアップされているかどうか

0：セットアップされていない

1：セットアップされている

INTEGER
NUMBER(1)
なし
不可
なし

8
RM_SYSNAME
HCSCサーバをセットアップしたときに設定したRMシステム名
設定していない場合は""が設定される
VARCHAR(3)
VARCHAR2(3)
なし
なし
なし

注　デフォルトでは，INDEXを使用しません。

注※　このテーブルのPRIMARY KEYです。

(g)　非同期アダプタサービスID管理テーブル

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です。

付録D　SQLスクリプトファイルの設定

次に示す場合に，SQLスクリプトファイルを使用して，メッセージング基盤やビジネスプロセス基盤で使用するテーブルをカスタマイズします。

細分化された複数のテーブルごとに，RDエリア，または表領域（テーブルスペース）を分けて，データベースを構築する場合
一つのテーブルに複数のテーブルがある（ルーティングルールディレクトリ情報テーブル，またはデータ変換定義ディレクトリ情報テーブルなど）場合，HCSCサーバのセットアップ定義ファイルでは，一つのRDエリア，または表領域（テーブルスペース）しか設定できません。

検索時の性能を向上させる場合
この場合は，運用に応じて，よく使う機能についてインデクスが指定されていない列にインデクスを設定します。例えば，実行履歴情報の表示の際にキーとなる情報にインデクスを設定するなどができます。

＜この節の構成＞

(1)　SQLスクリプトファイルの種類と格納先

(2)　SQLスクリプトファイルの設定方法

(3)　SQLスクリプトファイル設定時の注意事項

(1)　SQLスクリプトファイルの種類と格納先

SQLスクリプトファイルは，次に示すディレクトリに格納されているサンプルファイルを利用して作成します。

<Cosminexusのインストールディレクトリ>¥CSC¥sql

ディレクトリ内には次に示すファイルがあり，データベースのタイプや用途に応じて使用するファイルが異なります。

表D-1　SQLスクリプトファイルの種類

データベースのタイプ
分類
ファイル名
説明

HiRDB
テーブル作成用
CreateTables_HiRDB.sql
スタンドアロンのHCSCサーバのセットアップ，またはクラスタ構成の1台目HCSCサーバのセットアップに使用します。

CreateCSCIndividualTables_HiRDB.sql
クラスタ構成の2台目HCSCサーバのセットアップに使用します。

テーブル削除用
DeleteTables_HiRDB.sql
スタンドアロンのHCSCサーバのアンセットアップ，またはクラスタ構成の1台目HCSCサーバのアンセットアップに使用します。

DeleteCSCIndividualTables_HiRDB.sql
クラスタ構成の2台目HCSCサーバのアンセットアップに使用します。

Oracle 10g
/Oracle 11g
テーブル作成用
CreateTables_Oracle.sql
スタンドアロンのHCSCサーバのセットアップ，またはクラスタ構成の1台目HCSCサーバのセットアップに使用します。

CreateCSCIndividualTables_Oracle.sql
クラスタ構成の2台目HCSCサーバのセットアップに使用します。

テーブル削除用
DeleteTables_Oracle.sql
スタンドアロンのHCSCサーバのアンセットアップ，またはクラスタ構成の1台目HCSCサーバのアンセットアップに使用します。

DeleteCSCIndividualTables_Oracle.sql
クラスタ構成の2台目HCSCサーバのアンセットアップに使用します。

(2)　SQLスクリプトファイルの設定方法

SQLスクリプトファイルを設定する場合，テーブル名，およびRDエリア名または表領域名を変更します。

(a)　テーブル名の変更

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_CONNECT

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>_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

(b)　RDエリア名または表領域名の変更

データベースごとに次に示すように変更します。

HiRDBの場合
SQLスクリプトファイル内にある，各テーブルの次の個所を書き換えます。RDエリアを指定しない場合は，「IN <RDDATA>」または「IN <RDINDX>」を削除します。

IN <RDDATA>：各テーブルを格納するRDエリア名を指定します。

IN <RDINDX>：各インデクスを格納するRDエリア名を指定します。

Oracleの場合
SQLスクリプトファイル内にある，各テーブル，またはインデクスの次の個所を書き換えます。表領域を指定しない場合は，「TABLESPACE <EXAMPLE>」削除します。

TABLESPACE <EXAMPLE>
使用する表領域（テーブルスペース），またはmessage変数テーブル内のmessage変数の値（BLOB）を格納する表領域を指定します。

(3)　SQLスクリプトファイル設定時の注意事項

(a)次に示すように，各テーブルの列名，データ型，および制約キーは変更できません。また，列の順番は入れ替えられません。

（例）

　列名：CSC_SERVER_NAME，CSC_SERVER_STATUS　など

　データ型：VARCHAR2(8)，NUMBER(10,0)　など

　制約キー：NOT NULL指定，UNIQUE指定　など

(b)テーブル，およびインデクス作成の順番は変更できません。

(c)テンプレートで定義されているインデクスは削除できません。インデクスやインデクスとして定義されている列名を削除すると，動作しないおそれがあります。

付録E　HCSCサーバのリソース稼働情報の統計情報

HCSCサーバのリソース稼働情報は，統計情報として参照できます。統計情報を参照するには，Cosminexusのアプリケーションサーバで出力している稼働情報ファイルを利用します。稼働情報ファイルとは，J2EEサーバとSFOサーバ内の稼働情報が，定期的に出力されるファイルです。このファイルに，HCSCサーバのリソース稼働情報も記録されています。

稼働情報ファイルの詳細については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 運用／監視／連携編」の「3.3　稼働情報ファイルの出力機能」を参照してください。

＜この節の構成＞

付録E.1　稼働情報ファイルの出力

付録E.2　統計情報の参照方法

付録E.3　HCSCサーバのリソースに対応する情報

付録E.4　リソースの稼働情報の種類

付録E.1　稼働情報ファイルの出力

稼働情報ファイルは，デフォルトの設定の場合，次のフォルダに作成されます。

Windowsの場合

<作業ディレクトリ>※¥ejb¥<J2EEサーバ名称>¥stats

UNIXの場合

<作業ディレクトリ>※/ejb/<J2EEサーバ名称>/stats

注※

<作業ディレクトリ>は，次のどちらかの方法で確認できます。

運用環境ポータルから確認する場合

［J2EEコンテナの設定］画面で確認します。詳細については，マニュアル「Cosminexus アプリケーションサーバ 運用管理ポータル操作ガイド」の「10.9.2　J2EEコンテナの設定」を参照してください。

簡易構築定義ファイルから確認する場合

簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に指定されている，ejb.public.directoryパラメタで確認します。詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.6　簡易構築定義ファイル」を参照してください。

なお，<作業ディレクトリ>のデフォルト値は，Windowsの場合，「<Cosminexusのインストールディレクトリ>¥CC¥server¥public」，UNIXの場合，「/opt/Cosminexus/CC/server/public」に設定されています。

また，稼働情報ファイルは，デフォルトの設定の場合，出力するに設定されています。

稼働情報ファイルの出力先ディレクトリや，稼働情報ファイルを出力するかどうかの設定を変更したい場合は，次に示すマニュアルを参照してください。

運用環境ポータルから変更する場合

マニュアル「Cosminexus アプリケーションサーバ 運用管理ポータル操作ガイド」の「10.9.17　稼働情報監視の設定（J2EEサーバ）」を参照してください。

Smart Composer機能を使って変更する場合

マニュアル「Cosminexus アプリケーションサーバ 機能解説 運用／監視／連携編」の「3.3　稼働情報ファイルの出力機能」と「3.4　イベントの発行機能」を参照してください。

付録E.2　統計情報の参照方法

統計情報の参照方法を次に示します。

統計情報を参照したいリソース（JavaVM，DBコネクション，標準受付（Webサービス），ユーザ定義受付，サービスアダプタ，およびビジネスプロセス）を決定します。

手順1で決めたリソースに対応する稼働情報ファイルとヘッダファイルを，稼働情報ファイルの出力先から任意のディレクトリにコピーします。
リソースに対応する稼働情報ファイルとヘッダファイルについては，「付録E.3　HCSCサーバのリソースに対応する情報」を参照してください。また，稼働情報ファイルの出力先については，「付録E.1　稼働情報ファイルの出力」を参照してください。

手順2でコピーした稼働情報ファイルとヘッダファイルを一つのファイルに編集し，Excelなどのアプリケーションプログラムで参照します。

ObjectNameの識別値から，統計情報を参照したいリソースを探します。
Excelを使用する場合，一つに編集したファイルのヘッダにフィルタを設定し，ObjectNameの識別値から統計情報を参照したいリソースを選択します。
ObjectNameの識別値とリソースの対応については，「付録E.3　HCSCサーバのリソースに対応する情報」を参照してください。

手順4で探したリソースの稼働情報の種類を特定します。
リソースの稼働情報の種類は，ヘッダファイルの項目名から特定します。リソースの稼働情報の種類と，ヘッダファイルの項目名の対応については，「付録E.4　リソースの稼働情報の種類」を参照してください。

付録E.3　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

（凡例）　－：識別値はありません。

注※　識別値が二つある場合は，二つで一意の値になります。

付録E.4　リソースの稼働情報の種類

リソースの稼働情報の種類は，リソースによって異なります。リソースの稼働情報の種類と，ヘッダファイルの項目名の対応を次の表に示します。

表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連携機能を使用した場合，Cosminexus サービスプラットフォームで発生した障害のメッセージをJP1イベントとしてJP1に通知します。メッセージマッピングファイルを編集して，JP1イベント通知の有無を自由に変更できます。Cosminexus サービスプラットフォームで出力されるメッセージと初期値で設定されているJP1イベント通知の有無を次の表に示します。

＜この節の構成＞

(1)　KDEC00001～KDEC19999のメッセージ（メッセージング基盤に関するメッセージ）

(2)　KDEC20000～KDEC39999のメッセージ（ビジネスプロセス基盤に関するメッセージ）

(3)　KDEC40000～KDEC59999のメッセージ（データ変換基盤に関するメッセージ）

(4)　KDEC60000～KDEC79999のメッセージ（DBアダプタに関するメッセージ）

(5)　KDEC80000～KDEC80499のメッセージ（ファイル操作アダプタに関するメッセージ）

(6)　KDEK20000～KDEK30999のメッセージ（FTPアダプタに関するメッセージ）

(7)　KEOS50000～KEOS59999のメッセージ（HCSC-Managerに関するメッセージ）

(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 | ×
KDEC00351 | ×
KDEC00361 | ○
KDEC00362 | ○
KDEC00363 | ○
KDEC00364 | ○
KDEC00365 | ○
KDEC00366 | ○
KDEC00371 | ×
KDEC00372 | ×
KDEC00381 | ×
KDEC00382 | ○
KDEC00383 | ○
KDEC00384 | ○
KDEC00385 | ○
KDEC00386 | ○
KDEC00387 | ○
KDEC00388 | ×
KDEC00390 | ○
KDEC00391 | ○
KDEC00392 | ○
KDEC00393 | ○
KDEC00394 | ○
KDEC00395 | ○
KDEC00396 | ○
KDEC00397 | ○
KDEC00398 | ×
KDEC00399 | ○
KDEC00400 | ○
KDEC00401 | ○
KDEC00402 | ○
KDEC00403 | ○
KDEC00404 | ×
KDEC00405 | ×
KDEC00406 | ○
KDEC00407 | ○
KDEC00408 | ×
KDEC00409 | ×
KDEC00410 | ×
KDEC00411 | ○
KDEC00412 | ○
KDEC00413 | ○
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 | ○
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 | ○
KDEC03001 | ○
KDEC03002 | ○
KDEC03003 | ○
KDEC03005 | ○
KDEC03006 | ○
KDEC03007 | ○
KDEC03011 | ○
KDEC03012 | ○
KDEC03013 | ○
KDEC03014 | ○
KDEC03015 | ○
KDEC03016 | ○
KDEC03017 | ○
KDEC03018 | ○
KDEC03019 | ○
KDEC03020 | ○
KDEC03021 | ○
KDEC03022 | ○
KDEC03023 | ○
KDEC03024 | ○
KDEC03025 | ○
KDEC03026 | ○
KDEC03027 | ○
KDEC03028 | ○
KDEC04501 | ○
KDEC04502 | ○
KDEC04503 | ○
KDEC04504 | ○
KDEC04505 | ○
KDEC04506 | ○
KDEC04510 | ○
KDEC04511 | ○
KDEC04512 | ○
KDEC04513 | ○
KDEC04514 | ○
KDEC04515 | ○
KDEC04516 | ○
KDEC04517 | ○
KDEC04518 | ○
KDEC04519 | ○
KDEC04520 | ○
KDEC04601 | ×
KDEC04602 | ×
KDEC04603 | ×
KDEC04604 | ×
KDEC04605 | ×
KDEC04609 | ○
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 | ○
KDEC05301 | ×
KDEC05302 | ×
KDEC05303 | ×
KDEC05304 | ×
KDEC05305 | ×
KDEC05306 | ×
KDEC05307 | ×
KDEC05308 | ×
KDEC05309 | ×
KDEC05310 | ×
KDEC05311 | ×
KDEC05312 | ×
KDEC05313 | ×
KDEC05314 | ×
KDEC05315 | ×
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 | ○
KDEC07001 | ○
KDEC07002 | ○
KDEC07003 | ○
KDEC07004 | ×
KDEC07005 | ×
KDEC07006 | ○
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 | ×
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 | ×
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 | ×
KDEC10400 | ×
KDEC10401 | ×
KDEC10403 | ×
KDEC10407 | ×
KDEC10408 | ×
KDEC10409 | ×
KDEC10410 | ×
KDEC10411 | ×
KDEC10501 | ×
KDEC10502 | ×
KDEC19901 | ○
KDEC19902 | ○
KDEC19903 | ○

（凡例）

○：通知します。

×：通知しません。

(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 | ×
KDEC20064 | ×
KDEC20065 | ×
KDEC20066 | ×
KDEC20067 | ×
KDEC20068 | ○
KDEC20069 | ×
KDEC20070 | ○
KDEC20071 | ×
KDEC20072 | ×
KDEC20073 | ×
KDEC20074 | ×
KDEC20075 | ×
KDEC20076 | ×
KDEC20077 | ×
KDEC20078 | ×
KDEC20079 | ○
KDEC20080 | ○
KDEC20081 | ○
KDEC20082 | ○
KDEC20083 | ○
KDEC30000 | ×
KDEC30001 | ×
KDEC30002 | ×
KDEC30003 | ×
KDEC30004 | ×
KDEC30005 | ×
KDEC30006 | ×
KDEC30007 | ×
KDEC30008 | ×
KDEC35000 | ×
KDEC35001 | ×
KDEC35002 | ×
KDEC35003 | ×
KDEC35004 | ×
KDEC35005 | ×
KDEC35006 | ×
KDEC35007 | ×
KDEC35008 | ×
KDEC35009 | ×
KDEC35011 | ×
KDEC35012 | ×
KDEC35013 | ×
KDEC35014 | ×

（凡例）

○：通知します。

×：通知しません。

(3)　KDEC40000～KDEC59999のメッセージ（データ変換基盤に関するメッセージ）

KDEC40000～KDEC59999のメッセージはすべてJP1イベント通知をします。

(4)　KDEC60000～KDEC79999のメッセージ（DBアダプタに関するメッセージ）

メッセージID | JP1イベント通知の有無
KDEC60000 | ○
KDEC60001 | ○
KDEC60002 | ×
KDEC60003 | ×
KDEC62000 | ○
KDEC62001 | ○
KDEC63000 | ×
KDEC63001 | ×
KDEC63002 | ○
KDEC64000 | ○
KDEC64001 | ○
KDEC64002 | ○
KDEC64003 | ○
KDEC64004 | ○
KDEC64005 | ○
KDEC64006 | ○
KDEC64007 | ○
KDEC64008 | ○
KDEC64009 | ○
KDEC64010 | ○
KDEC64011 | ○
KDEC64012 | ○
KDEC66000 | ○
KDEC66001 | ×
KDEC66002 | ○
KDEC66003 | ○
KDEC66004 | ○
KDEC66005 | ○
KDEC66006 | ○
KDEC66007 | ○
KDEC70002 | ○
KDEC70003 | ×
KDEC70004 | ×
KDEC79000 | ○

（凡例）

○：通知します。

×：通知しません。

(5)　KDEC80000～KDEC80499のメッセージ（ファイル操作アダプタに関するメッセージ）

メッセージ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 | ○
KDEC80043 | ○
KDEC80044 | ○
KDEC80045 | ×
KDEC80046 | ○
KDEC80047 | ○
KDEC80049 | ○
KDEC80050 | ○
KDEC80051 | ○
KDEC80052 | ○
KDEC80053 | ○
KDEC80061 | ○
KDEC80062 | ○
KDEC80081 | ○
KDEC80082 | ×
KDEC80083 | ○
KDEC80084 | ○
KDEC80085 | ×

（凡例）

○：通知します。

×：通知しません。

(6)　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 | ○
KDEK21000 | ×
KDEK21001 | ×
KDEK21900 | ×
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 | ○
KDEK30430 | ○
KDEK30432 | ○
KDEK30433 | ○
KDEK30434 | ○
KDEK30435 | ×
KDEK30501 | ×
KDEK30502 | ×
KDEK30503 | ×
KDEK30511 | ×
KDEK30512 | ×
KDEK30513 | ×
KDEK30514 | ×
KDEK30515 | ×
KDEK30516 | ×
KDEK30531 | ×
KDEK30532 | ×
KDEK30533 | ×
KDEK30541 | ×
KDEK30542 | ×
KDEK30543 | ×
KDEK30551 | ×
KDEK30552 | ×
KDEK30554 | ×
KDEK30555 | ×
KDEK30557 | ×
KDEK30558 | ×
KDEK30559 | ×
KDEK30571 | ×
KDEK30572 | ×
KDEK30573 | ×
KDEK30601 | ×
KDEK30602 | ×
KDEK30603 | ×
KDEK30604 | ×
KDEK30605 | ×
KDEK30606 | ×
KDEK30607 | ×
KDEK30608 | ×
KDEK30609 | ×
KDEK30901 | ×

（凡例）

○：通知します。

×：通知しません。

(7)　KEOS50000～KEOS59999のメッセージ（HCSC-Managerに関するメッセージ）

KEOS50000～KEOS59999のメッセージはすべてJP1イベント通知をしません。

付録G　旧バージョンからの移行

旧バージョンのCosminexus サービスプラットフォームで構築した開発環境，運用環境および実行環境を08-70にバージョンアップできます。その際，旧バージョンで使用していたリポジトリ情報（HCSCコンポーネントや配備定義など）をバージョンアップ後も使用する場合，リポジトリの情報をバージョンアップ後にも使用できる形式に移行してからバージョンアップします。

このマニュアルでは，バージョンアップ前に使用していたリポジトリ情報をそのまま使用して，バージョンアップ後も運用する場合のバージョンアップ方法について説明します。リポジトリの移行方法には，開発環境で移行する方法と，運用環境で移行する方法があります。運用環境で移行する場合のバージョンアップ方法については，「付録H　運用環境でリポジトリを旧バージョンから移行する方法」を参照してください。

旧バージョンで使用していたリポジトリ情報をバージョンアップ前後に開発環境で変更し，変更したリポジトリ情報を使用して運用する場合のバージョンアップ方法については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「付録A　旧バージョンからの移行」を参照してください。

注意

バージョンアップ後は，開発環境，運用環境および実行環境のバージョンを統一してください。

＜この節の構成＞

付録G.1　移行の対象となるバージョン

付録G.2　新規にインストールする場合の移行手順

付録G.3　上書きインストールする場合の移行手順

付録G.4　ローリングアップデートの場合の移行手順

付録G.5　移行したあとの注意事項

付録G.1　移行の対象となるバージョン

リポジトリ情報の移行の対象となる旧バージョンを次に示します。これらのバージョンのリポジトリ情報を移行して，各環境を08-70にバージョンアップできます。

uCosminexus Service Architect　07-10

uCosminexus Service Platform　07-10

uCosminexus Service Architect　07-20

uCosminexus Service Platform　07-20

uCosminexus Service Architect　07-50

uCosminexus Service Platform　07-50

uCosminexus Service Architect　07-60

uCosminexus Service Platform　07-60

uCosminexus Service Architect　08-00

uCosminexus Service Platform　08-00

uCosminexus Service Architect　08-10

uCosminexus Service Platform　08-10

uCosminexus Service Architect　08-50

uCosminexus Service Platform　08-50

uCosminexus Service Architect　08-51

uCosminexus Service Platform　08-51

uCosminexus Service Architect　08-53

uCosminexus Service Platform　08-53

なお，07-50より前のバージョンから08-70に移行する場合と，07-50以降のバージョンから08-70に移行する場合とで，次のように移行方法が異なります。

07-50より前のバージョンから08-70に移行する場合

旧バージョンをアンインストールして，08-70を新規にインストールします。移行手順の詳細については，「付録G.2　新規にインストールする場合の移行手順」を参照してください。

07-50以降のバージョンから08-70に移行する場合

次の三つの移行方法があります。

旧バージョンをアンインストールして，08-70を新規にインストールします。HCSC簡易セットアップ機能を利用してセットアップした場合は，この方法をお勧めします。移行手順の詳細については，「付録G.2　新規にインストールする場合の移行手順」を参照してください。

08-70を上書きインストールします。移行手順の詳細については，「付録G.3　上書きインストールする場合の移行手順」を参照してください。

システムを全面停止しないで，08-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

付録G.2　新規にインストールする場合の移行手順

次の図に示す(1)～(10)の手順に従って，Cosminexus サービスプラットフォームを旧バージョンから08-70へ移行してください。

図G-1　新規にインストールする場合の移行手順

図G-1の(1)～(10)の手順の詳細を次に示します。

なお，手順内で使用するコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「4.　コマンド（運用環境・実行環境）」を参照してください。また，開発環境で実施する作業の詳細については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」を参照してください。

注意

バージョン07-60以降では，開発環境と運用環境で同じリポジトリを共有できません。旧バージョンでリポジトリを共有していた場合，開発環境と運用環境で別々のリポジトリを用意して，移行してください。移行手順については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「付録A.3　旧バージョンで開発環境と運用環境のリポジトリを共有していた場合の移行手順」を参照してください。

＜この項の構成＞

(1)　リポジトリのエクスポート（運用環境）

(2)　HCSCコンポーネントの削除（運用環境）

(3)　HCSCサーバのアンセットアップ（運用環境）

(4)　各環境のアンインストール

(5)　各環境のインストール

(6)　HCSCサーバの構築（運用環境）

(7)　リポジトリのインポート（開発環境）

(8)　リポジトリのエクスポート（開発環境）

(9)　リポジトリのインポート（運用環境）

(10)　HCSCコンポーネントの配備（運用環境）

(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サーバのアンセットアップ方法については，「3.2.4　HCSCサーバをアンセットアップする」を参照してください。

なお，アンセットアップしないでバージョンアップしてしまった場合，07-50より前のバージョンから08-70に移行するときは，手動でHCSCサーバを削除してください。07-50以降のバージョンから08-70に移行するときは，手動でHCSCサーバを削除する必要はありません。

(4)　各環境のアンインストール

開発環境，運用環境，実行環境で旧バージョンのCosminexus サービスプラットフォームをアンインストールします。Cosminexus以下のディレクトリ情報を退避したあとに，旧バージョンのCosminexus サービスプラットフォームをアンインストールすることをお勧めします。

注意

アンインストールする場合の注意

J2EEサーバ，Management Server，PRFなど実行環境の構成要素を停止してからアンインストールしてください。

組み込みデータベースを使用している場合，組み込みデータベースを停止してからアンインストールしてください。

07-50より前のバージョンから移行する場合の注意

必ずすべてのHCSCサーバをアンセットアップしてからバージョンアップしてください。

実行環境をバージョンアップする場合，cscreplsコマンドを使ってHCSCサーバ情報が残っていないことを確認してから実施してください。HCSCサーバ情報が残っていたら，必ずHCSCサーバをアンセットアップしてからバージョンアップしてください。HCSCサーバ情報が残っていてもバージョンアップは実行できますが，正しくバージョンアップされないので注意してください。

HCSCサーバをアンセットアップしたあとに，リポジトリルート配下を削除してください。

開発環境をバージョンアップする場合の注意

開発環境では，バージョンアップ前にHCSCTEプロジェクトをいったん削除し，バージョンアップ後に新しく作成し直してください。

(5)　各環境のインストール

開発環境，運用環境，実行環境で08-70のCosminexus サービスプラットフォームをインストールしてバージョンアップします。

(6)　HCSCサーバの構築（運用環境）

前回作成したHCSCサーバと同一の環境を構築し，定義します。前回作成した次のファイルを基に，HCSCサーバを構築し，定義します。

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

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

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

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

(7)　リポジトリのインポート（開発環境）

(1)でエクスポートしたリポジトリ情報を開発環境にインポートします。インポートするときは，Eclipseのメニューの［プロジェクト］－［自動的にビルド］をオフにしてから，リポジトリをインポートしてください。リポジトリのインポート終了後は，オンに戻してください。

旧バージョンのリポジトリをインポートすると，パッケージングおよび配備定義が自動で実施され，リポジトリ情報が今バージョンに引き継がれます。なお，パッケージングおよび配備定義が自動で実施されるのは，旧バージョンでパッケージングおよび配備定義したサービスアダプタ，ビジネスプロセス，およびユーザ定義受付だけです。

注意

07-50より前のバージョンから移行する場合の注意

サービスアダプタ（SessionBean）のユーザ定義クラスに次のファイル名が設定されているときは，警告メッセージが表示されます。

csmsvcadpdef.jar

cscmsg_adpejb.jar

警告メッセージが表示された場合，サービスアダプタ定義画面で，上記のユーザ定義クラスを削除し，ファイル名を変更してから，再度設定してください。

07-60以降のバージョンから移行する場合の注意

07-60以降のバージョンから移行する場合，実行環境に配備するサービスアダプタおよびユーザ定義受付は，開発環境にインポートして再度パッケージングしてください。サービスアダプタを再度パッケージングしないと，メッセージKDEC03007-Eが出力されないことがあります。また，ユーザ定義受付を再度パッケージングしないと，メッセージKDEC00001-Eで不正な埋字が出力されることがあります。パッケージングの方法については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「9.2　パッケージング」を参照してください。

08-10より前のバージョンから移行する場合の注意

データ変換定義で，sequence要素またはchoice要素下に，出現回数が1回に固定されている次の要素（コンポジタ）を定義している場合，ノードの表示が変更されるため，マッピング定義ファイルで使用しているXML Schemaが変更されている旨のエラーメッセージが表示されます。

sequence

choice

エラーメッセージが表示された場合は，再度マッピング定義を起動し，変更を反映させてください。

メモリについての注意

旧バージョンのリポジトリをインポートするときは，メモリを多く必要とします。そのため，次の手順でメモリサイズが十分かどうかを確認し，メモリが不足している場合は，メモリサイズを増やしてからリポジトリをインポートしてください。

Eclipseのメニューから，［MyEclipse］－［ユーティリティー］－［ガーベッジ・コレクションの実行］を選択します。

［メモリー使用量(MB)］ダイアログの［ガーベッジ・コレクション後］に表示されている，「最大許容メモリー・サイズ」および「メモリー使用量」を確認します。

次の条件に当てはまる場合，eclipse.iniを編集し，推奨値に従ってメモリサイズ（-Xmxの値）を大きくします。条件に当てはまらない場合，対処は不要です。eclipse.iniの編集については，マニュアル「Cosminexus アプリケーションサーバ アプリケーション開発ガイド」の「11.2　前提環境の準備」を参照してください。
条件：「メモリー使用量」+定義済みサービス数×3 ＞ 「最大許容メモリー・サイズ」
推奨値：変更後の「-Xmx」の値 = 定義済みサービス数×3 +変更前の「-Xmx」の値

クライアント定義ファイルについての注意

開発環境でサービスアダプタ（Webサービス）を定義した場合，クライアント定義ファイル（c4webcl.properties）の「c4web.logger.log_file_prefix」の値は，自動的にサービスIDに変更されます。必要に応じて，移行前のクライアント定義ファイルを削除してください。詳細については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「5.3.1　サービスアダプタ（Webサービス）を定義する」を参照してください。

(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コンポーネントを操作できます。

なお，旧バージョンで使用していたリポジトリ情報をバージョンアップ前後に開発環境で変更し，変更したリポジトリ情報を使用して運用する場合のバージョンアップ方法については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「付録A.3　旧バージョンで開発環境と運用環境のリポジトリを共有していた場合の移行手順」を参照してください。

付録G.3　上書きインストールする場合の移行手順

上書きインストールで移行できるのは，バージョンが07-50以降のときだけです。07-50より前のバージョンを移行する場合は，08-70を新規にインストールして移行してください。

次の図に示す(1)～(6)の手順に従って，Cosminexus サービスプラットフォームを07-50以降のバージョンから08-70へ移行してください。

図G-2　上書きインストールする場合の移行手順

図G-2の(1)～(6)の手順の詳細を次に示します。

なお，手順内で使用するコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「4.　コマンド（運用環境・実行環境）」を参照してください。また，開発環境で実施する作業の詳細については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」を参照してください。

注意

バージョン07-60以降では，開発環境と運用環境で同じリポジトリを共有できません。旧バージョンでリポジトリを共有していた場合，開発環境と運用環境で別々のリポジトリを用意して，移行してください。移行手順については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「付録A.3　旧バージョンで開発環境と運用環境のリポジトリを共有していた場合の移行手順」を参照してください。

HCSCコンポーネントが開始状態でHCSCサーバを停止して，実行環境のバージョンアップを実施した場合，次回のHCSCサーバの起動時には，HCSCコンポーネントが停止した状態となります。そのため，実行環境のバージョンアップ後のHCSCサーバ起動後は，HCSCコンポーネントを開始する必要があります。

＜この項の構成＞

(1)　リポジトリのエクスポート（運用環境）

(2)　各環境の上書きインストール

(3)　リポジトリのインポート（開発環境）

(4)　リポジトリのエクスポート（開発環境）

(5)　リポジトリのインポート（運用環境）

(6)　実行環境のバージョンアップ（運用環境）

(1)　リポジトリのエクスポート（運用環境）

バージョンアップ前の運用環境のリポジトリをエクスポートして，いったん退避します。複数のリポジトリを使用している場合，必要なリポジトリをすべてエクスポートして，退避します。

cscrepctlコマンド（-exportオプション）を運用環境で実行して，バージョンアップ前のリポジトリをエクスポートしてください。

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

(2)　各環境の上書きインストール

開発環境，運用環境，実行環境で08-70のCosminexus サービスプラットフォームを上書きインストールしてバージョンアップします。

各環境を上書きインストールするときの前提条件を次に示します。

前提条件

HCSCサーバがセットアップ済みであること

Cosminexus アプリケーションサーバおよびCosminexus RMが停止していること

組み込みデータベースを使用している場合，組み込みデータベースを停止していること

HCSCサーバ，J2EEサーバ，およびHCSCコンポーネントが停止していること

注意

アンインストールする場合の注意

J2EEサーバ，Management Server，PRFなど実行環境の構成要素を停止してから上書きインストールしてください。

組み込みデータベースを使用している場合，組み込みデータベースを停止してから上書きインストールしてください。

開発環境をバージョンアップする場合の注意

開発環境では，バージョンアップ前にHCSCTEプロジェクトをいったん削除し，バージョンアップ後に新しく作成し直してください。

なお，上書きインストールでは次のファイルを除いて上書きされます。

<Cosminexusインストールディレクトリ>¥CSC¥config¥manager¥csccmd.properties

<Cosminexusインストールディレクトリ>¥CSC¥config¥manager¥cscmng.properties

<Cosminexusインストールディレクトリ>¥CSC¥config¥msg¥cmdconf.bat

<Cosminexusインストールディレクトリ>¥CSC¥inbound-adapter¥ftp¥config¥command¥log4j.xml

<Cosminexusインストールディレクトリ>¥CSC¥inbound-adapter¥ftp¥config¥FTP_Inbound_Resource_Adapter¥serverstatus.properties

<Cosminexusインストールディレクトリ>¥CSC¥inbound-adapter¥ftp¥config¥FTP_Inbound_Resource_Adapter¥users.properties

<Cosminexusインストールディレクトリ>¥CSC¥system¥manager¥setup¥input.properties

(3)　リポジトリのインポート（開発環境）

(1)でエクスポートしたリポジトリ情報を開発環境にインポートします。旧バージョンのリポジトリをインポートすると，パッケージングおよび配備定義が自動で実施され，リポジトリ情報が今バージョンに引き継がれます。なお，パッケージングおよび配備定義が自動で実施されるのは，旧バージョンでパッケージングおよび配備定義したサービスアダプタ，ビジネスプロセス，およびユーザ定義受付だけです。

注意

07-60以降のバージョンから移行する場合の注意

07-60以降のバージョンから移行する場合，実行環境に配備するサービスアダプタおよびユーザ定義受付は，開発環境にインポートして再度パッケージングしてください。サービスアダプタを再度パッケージングしないと，メッセージKDEC03007-Eが出力されないことがあります。また，ユーザ定義受付を再度パッケージングしないと，メッセージKDEC00001-Eで不正な埋字が出力されることがあります。パッケージングの方法については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「9.2　パッケージング」を参照してください。

08-10より前のバージョンから移行する場合の注意

データ変換定義で，sequence要素またはchoice要素下に，出現回数が1回に固定されている次の要素（コンポジタ）を定義している場合，ノードの表示が変更されるため，マッピング定義ファイルで使用しているXML Schemaが変更されている旨のエラーメッセージが表示されます。

sequence

choice

エラーメッセージが表示された場合は，再度マッピング定義を起動し，変更を反映させてください。

メモリについての注意

旧バージョンのリポジトリをインポートするときは，メモリを多く必要とします。そのため，次の手順でメモリサイズが十分かどうかを確認し，メモリが不足している場合は，メモリサイズを増やしてからリポジトリをインポートしてください。

Eclipseのメニューから，［MyEclipse］－［ユーティリティー］－［ガーベッジ・コレクションの実行］を選択します。

［メモリー使用量(MB)］ダイアログの［ガーベッジ・コレクション後］に表示されている，「最大許容メモリー・サイズ」および「メモリー使用量」を確認します。

次の条件に当てはまる場合，eclipse.iniを編集し，推奨値に従ってメモリサイズ（-Xmxの値）を大きくします。条件に当てはまらない場合，対処は不要です。eclipse.iniの編集については，マニュアル「Cosminexus アプリケーションサーバ アプリケーション開発ガイド」の「11.2　前提環境の準備」を参照してください。
条件：「メモリー使用量」+定義済みサービス数×3 ＞ 「最大許容メモリー・サイズ」
推奨値：変更後の「-Xmx」の値 = 定義済みサービス数×3+変更前の「-Xmx」の値

(4)　リポジトリのエクスポート（開発環境）

(3)でインポートしたリポジトリをエクスポートします。

(5)　リポジトリのインポート（運用環境）

(4)でエクスポートしたリポジトリをインポートします。なお，旧バージョンのリポジトリはインポートできません。

cscrepctlコマンド（-importオプション）を運用環境で実行してください。

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

(6)　実行環境のバージョンアップ（運用環境）

運用環境から実行環境のバージョンアップを実施します。

(a)　前提条件

実行環境をバージョンアップするには，次の条件を満たしている必要があります。

Management Serverが起動していること

組み込みデータベースを使用している場合，組み込みデータベースが起動していること

Cosminexus アプリケーションサーバおよびCosminexus RMの移行が完了していること
Cosminexus アプリケーションサーバの移行方法については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 保守／移行／互換編」の「12.　旧バージョンのアプリケーションサーバからの移行」を参照してください。Cosminexus RMの移行方法については，マニュアル「Cosminexus Reliable Messaging」の「付録H　旧バージョンからの移行」を参照してください。

リポジトリのバージョンがインストールバージョンと一致していること
リポジトリのバージョンがインストールバージョンと一致していない場合は，開発環境でバージョンアップしてから，運用環境に「cscrepctl -import <リポジトリZIP>」でリポジトリを更新してください。

FTPインバウンドアダプタを使用する場合，cjrarupdateコマンド※でのリソースアダプタのバージョンアップが完了していること

注※

cjrarupdateコマンドには次のオプションを指定してください。

　-typeオプション：「rar」

　-fオプション：「<Cosminexusインストールディレクトリ>¥CSC¥inbound-adapter¥ftp¥rar¥ftp_inbound_adapter.rar」

cjrarupdateコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjrarupdate（リソースアダプタのバージョンアップ）」を参照してください。

なお，FTPインバウンドアダプタをバージョンアップできるのは，移行後のバージョンが08-70以降の場合だけです。

前提条件を満たしていない場合，上記の順番で起動，停止，およびバージョンアップを実施してください。

(b)　バージョンアップ方法

cscenvupdateコマンドを運用環境で実行します。次に示す手順で実行してください。

次に示すアダプタがリポジトリに定義されている場合は，各アダプタに対応するプロトコルコンバータのJARファイルを格納します。

FTPアダプタ

Message Queueアダプタ

Object Accessアダプタ

ファイルアダプタ

TP1アダプタ

JARファイルの格納先フォルダは次のとおりです。
<Cosminexusのインストールディレクトリ>¥CSC¥custom-adapter

cscenvupdateコマンドを実行して，リポジトリとHCSCサーバをバージョンアップします。

cscenvupdate -csc <バージョンアップするHCSCサーバ名>

なお，旧バージョンで使用していたリポジトリ情報を開発環境でバージョンアップ前後に変更し，そのリポジトリ情報を使用して運用する場合のバージョンアップ方法については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「付録A　旧バージョンからの移行」を参照してください。

付録G.4　ローリングアップデートの場合の移行手順

ローリングアップデートとは，システムを全面停止しないで，上書きインストールで移行する方法です。

ローリングアップデートで移行できるのは，バージョンが07-50以降のときだけです。07-50より前のバージョンを移行する場合は，08-70を新規にインストールして移行してください。

また，ローリングアップデートで移行する場合，2台以上のHCSCサーバでロードバランスクラスタを構成している必要があります。

次の図に示す(1)～(9)の手順に従って，Cosminexus サービスプラットフォームを07-50以降のバージョンから08-70へ移行してください。

図G-3　ローリングアップデートの場合の移行手順

図G-3の(1)～(9)の手順の詳細を次に示します。

なお，手順内で使用するコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「4.　コマンド（運用環境・実行環境）」を参照してください。また，開発環境で実施する作業の詳細については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」を参照してください。

注意

バージョン07-60以降では，開発環境と運用環境で同じリポジトリを共有できません。旧バージョンでリポジトリを共有していた場合，開発環境と運用環境で別々のリポジトリを用意して，移行してください。移行手順については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「付録A.3　旧バージョンで開発環境と運用環境のリポジトリを共有していた場合の移行手順」を参照してください。

ローリングアップデートでの移行が完了するまで，旧バージョンのシステムに対して，次の操作はできません。
・cscsvsetupコマンドで，新規にHCSCサーバをセットアップする
・csccompodeployコマンドで，新規にHCSCコンポーネントを配備する

＜この項の構成＞

(1)　リポジトリのエクスポート（運用環境）

(2)　開発環境および運用環境のインストール

(3)　リポジトリのインポート・エクスポート（開発環境・運用環境）

(4)　リクエストの送信制御（ロードバランサ）

(5)　実行環境のインストール

(6)　実行環境のバージョンアップ（運用環境）

(7)　HCSCサーバの起動（運用環境）

(8)　HCSCコンポーネントの開始（運用環境）

(9)　リクエストの送信制御の解除（ロードバランサ）

(10)　2台目以降のHCSCサーバ（実行環境）に対しての作業

(11)　ローリングアップデートで移行する場合の注意事項

(1)　リポジトリのエクスポート（運用環境）

バージョンアップ前の運用環境のリポジトリをエクスポートして，いったん退避します。複数のリポジトリを使用している場合は，すべてのリポジトリをエクスポートして退避します。

cscrepctlコマンド（-exportオプション）を運用環境で実行して，バージョンアップ前のリポジトリをエクスポートしてください。

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

(2)　開発環境および運用環境のインストール

開発環境および運用環境で，08-70のCosminexus サービスプラットフォームをインストールしてバージョンアップします。

開発環境は，新規インストールまたは上書きインストールのどちらかの方法でインストールします。運用環境は，上書きインストールでインストールします。

新規にインストールする場合

「付録G.2　新規にインストールする場合の移行手順」の(2)～(6)の作業を実施します。

上書きインストールする場合

「付録G.3　上書きインストールする場合の移行手順」の(2)の作業を実施します。

開発環境および運用環境をインストールするときの前提条件を次に示します。

前提条件

HCSCサーバがセットアップ済みであること

Cosminexus アプリケーションサーバおよびCosminexus RMが停止していること

組み込みデータベースを使用している場合，組み込みデータベースを停止していること

HCSCサーバ，J2EEサーバ，およびHCSCコンポーネントが停止していること

注意

上書きインストールをする場合，次の点に注意してください。

インストールする環境で，J2EEサーバ，Management Server，PRFなどのCosminexus実行環境が稼働中の場合は，すべていったん停止してから上書きインストールしてください。

組み込みデータベースを使用しているときは，組み込みデータベースを停止してから上書きインストールしてください。

(3)　リポジトリのインポート・エクスポート（開発環境・運用環境）

(1)でエクスポートしたリポジトリ情報を開発環境にインポートします。インポートによって，古いバージョンで作成したリポジトリ情報が今バージョンに引き継がれます。そのあと，開発環境のリポジトリ情報を運用環境にインポートし，運用環境にもリポジトリ情報を引き継ぎます。

リポジトリのインポート・エクスポートで実施する作業は，(2)で開発環境をインストールした方法によって次のように異なります。

新規にインストールした場合

「付録G.2　新規にインストールする場合の移行手順」の(7)～(9)の作業を実施します。

上書きインストールした場合

「付録G.3　上書きインストールする場合の移行手順」の(3)～(5)の作業を実施します。

(4)　リクエストの送信制御（ロードバランサ）

バージョンアップするHCSCサーバに対してリクエストを送信しないように，ロードバランサを設定します。その際，仕掛かり中のリクエストがないことを確認してください。なお，設定方法は各ロードバランサの仕様によって異なります。

(5)　実行環境のインストール

実行環境で，08-70のCosminexus サービスプラットフォームをインストールしてバージョンアップします。

実行環境は，新規インストールまたは上書きインストールのどちらかの方法でインストールします。

新規にインストールする場合

「付録G.2　新規にインストールする場合の移行手順」の(2)～(6)の作業を実施します。

上書きインストールする場合

「付録G.3　上書きインストールする場合の移行手順」の(2)の作業を実施します。

(6)　実行環境のバージョンアップ（運用環境）

運用環境から実行環境のバージョンアップを実施します。

(a)　前提条件

実行環境をバージョンアップするには，次の条件を満たしている必要があります。

Management Serverが起動していること

組み込みデータベースを使用している場合，組み込みデータベースが起動していること

Cosminexus アプリケーションサーバおよびCosminexus RMの移行が完了していること
Cosminexus アプリケーションサーバの移行方法については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 保守／移行／互換編」の「12.　旧バージョンのアプリケーションサーバからの移行」を参照してください。Cosminexus RMの移行方法については，マニュアル「Cosminexus Reliable Messaging」の「付録H　旧バージョンからの移行」を参照してください。

リポジトリのバージョンがインストールバージョンと一致していること
リポジトリのバージョンがインストールバージョンと一致していない場合は，開発環境でバージョンアップしてから，運用環境に「cscrepctl -import <リポジトリZIP>」でリポジトリを更新してください。

前提条件を満たしていない場合，上記の順番で起動，停止，およびバージョンアップを実施してください。

(b)　バージョンアップ方法

cscenvupdateコマンドを運用環境で実行します。次に示す手順で実行してください。

次に示すアダプタがリポジトリに定義されている場合は，各アダプタに対応するプロトコルコンバータのJARファイルを格納します。

FTPアダプタ

Message Queueアダプタ

Object Accessアダプタ

ファイルアダプタ

TP1アダプタ

JARファイルの格納先フォルダは次のとおりです。
<Cosminexusのインストールディレクトリ>¥CSC¥custom-adapter

cscenvupdateコマンドを実行して，リポジトリとHCSCサーバをバージョンアップします。

cscenvupdate -csc <バージョンアップするHCSCサーバ名>

(7)　HCSCサーバの起動（運用環境）

バージョンアップしたHCSCサーバを起動します。

(8)　HCSCコンポーネントの開始（運用環境）

(7)で起動したHCSCサーバに配備されているHCSCコンポーネントを開始します。

(9)　リクエストの送信制御の解除（ロードバランサ）

バージョンアップしたHCSCサーバに対してリクエストを送信するように，ロードバランサを設定します。なお，設定方法は各ロードバランサの仕様によって異なります。

(10)　2台目以降のHCSCサーバ（実行環境）に対しての作業

ロードバランスクラスタを構成しているすべてのHCSCサーバに対して，(4)～(9)の作業を実施します。

なお，旧バージョンで使用していたリポジトリ情報を開発環境でバージョンアップ前後に変更し，そのリポジトリ情報を使用して運用する場合のバージョンアップ方法については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「付録A　旧バージョンからの移行」を参照してください。

(11)　ローリングアップデートで移行する場合の注意事項

ローリングアップデートを実行する場合，次の条件がすべて該当すると，cscenvupdateコマンドの実行時に異常終了することがあります。

データベースおよびCosminexus RMがある構成でセットアップしている場合で，データベースにはHiRDBを使用している。

ビジネスプロセスを使用している。

クラスタ内で最初のアップデートである。

この場合に，正常に運用する方法および運用例を次に示します。

(a)　運用方法

稼働しているすべてのHCSCサーバに対して，次に示す1.～4.の操作を実行してください。

実行履歴参照コマンドおよび運用操作をするGUIを停止する。

HCSCサーバにリクエストを送信しないようにする。

HCSCサーバの標準受付，およびユーザ定義受付を停止する。

すべてのリソースアダプタのプールを破棄する（cjclearpoolコマンドを利用）。

この操作を実行した状態で，バージョンアップしたHCSCサーバに対してcscenvupdateコマンドを実行してください。2台目以降のアップデートは，1.～4.の手順を実行する必要はありません。また，1回目のcscenvupdateコマンドの正常終了を確認したあとに，1.～3.の手順で停止した各機能は，2台目以降の操作タイミングとは無関係に再開可能となります。

(b)　運用例

次に示す構成およびバージョンアップを想定します。

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コマンドを実行する。

付録G.5　移行したあとの注意事項

Cosminexus サービスプラットフォームを移行したあとの注意事項を次に説明します。

＜この項の構成＞

(1)　キュー定義ファイルを作成したCosminexus RMのセットアップ

(1)　キュー定義ファイルを作成したCosminexus RMのセットアップ

Cosminexus サービスプラットフォームを移行したあとに，実行環境に必要なソフトウェアの設定としてCosminexus RMをセットアップします。

バージョン07-50以降，Cosminexus RMをセットアップするときにキュー定義ファイルの作成は不要になりました。そのため，移行後にCosminexus RMをセットアップするときも，キュー定義ファイルを作成する必要はありません。ただし，07-50より前のバージョンから移行する場合は，移行前のバージョンと同じようにキュー定義ファイルを作成してCosminexus RMをセットアップすることもできます。

Cosminexus RMをセットアップする方法の詳細については，マニュアル「Cosminexus Reliable Messaging」の「3.　システム構築」を参照してください。セットアップ作業のうち，キュー定義ファイルの作成とプロパティのカスタマイズについては，次に示す方法で実施します。

(a)　キュー定義ファイルの作成

キュー定義ファイルは，次に示すディレクトリに格納されているキュー定義ファイルのサンプルを利用して（クラスタ名を書き加えて）作成します。

<Cosminexusのインストールディレクトリ>¥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>：クラスタ名

(b)　Cosminexus RMのコンフィグレーションプロパティの設定

「3.1.2(9) Cosminexus Reliable Messagingのセットアップ」に記載されているプロパティに加えて，次のプロパティを設定します。

プロパティ名 | 設定内容 | 設定値
QueueConfigFileName | キュー定義ファイルの場所 | 作成したキュー定義ファイルのファイルパスを指定します。

付録H　運用環境でリポジトリを旧バージョンから移行する方法

ここでは，開発環境を利用しないで，運用環境だけでリポジトリを08-70にバージョンアップする方法について説明します。

開発環境を利用してリポジトリをバージョンアップする方法については，「付録G　旧バージョンからの移行」を参照してください。また，旧バージョンで使用していたリポジトリ情報をバージョンアップ前後に開発環境で変更し，変更したリポジトリ情報を使用して運用する場合のバージョンアップ方法については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「付録A　旧バージョンからの移行」を参照してください。

＜この節の構成＞

付録H.1　移行の対象となるバージョン

付録H.2　新規にインストールして運用環境のリポジトリを移行する手順

付録H.3　上書きインストールして運用環境のリポジトリを移行する手順

付録H.4　ローリングアップデートで運用環境のレポジトリを移行する手順

付録H.5　移行したあとの注意事項

付録H.1　移行の対象となるバージョン

バージョンが08-00以降の場合は，運用環境のリポジトリだけを08-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

08-00より前のバージョンから08-70に移行したい場合は，開発環境を利用してリポジトリをバージョンアップする必要があります。開発環境を利用してリポジトリをバージョンアップする方法については，「付録G　旧バージョンからの移行」を参照してください。

付録H.2　新規にインストールして運用環境のリポジトリを移行する手順

次の図に示す(1)～(9)の手順に従って，Cosminexus サービスプラットフォームを旧バージョンから08-70へ移行してください。

図H-1　新規にインストールする場合の移行手順（運用環境だけを移行する場合）

図H-1の(1)～(9)の手順の詳細を次に示します。

なお，手順内で使用するコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「4.　コマンド（運用環境・実行環境）」を参照してください。

＜この項の構成＞

(1)　リポジトリのエクスポート（運用環境）

(2)　HCSCコンポーネントの削除（運用環境）

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

(4)　各環境のアンインストール

(5)　各環境のインストール

(6)　HCSCサーバの構築（運用環境）

(7)　リポジトリのアップデート

(8)　リポジトリのインポート（運用環境）

(9)　HCSCコンポーネントの配備（運用環境）

(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サーバのアンセットアップ方法については，「3.2.4　HCSCサーバをアンセットアップする」を参照してください。

(4)　各環境のアンインストール

運用環境および実行環境で旧バージョンのCosminexus サービスプラットフォームをアンインストールします。Cosminexus以下のディレクトリ情報を退避したあとに，旧バージョンのCosminexus サービスプラットフォームをアンインストールすることをお勧めします。

注意

アンインストールする場合，次の点に注意してください。

J2EEサーバ，Management Server，PRFなど実行環境の構成要素を停止してからアンインストールしてください。

組み込みデータベースを使用している場合，組み込みデータベースを停止してからアンインストールしてください。

(5)　各環境のインストール

運用環境および実行環境で08-70のCosminexus サービスプラットフォームをインストールしてバージョンアップします。

(6)　HCSCサーバの構築（運用環境）

前回作成したHCSCサーバと同一の環境を構築し，定義します。前回作成した次のファイルを基に，HCSCサーバを構築し，定義します。

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

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

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

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

(7)　リポジトリのアップデート

旧バージョンで作成したビジネスプロセスやアダプタを使用する場合は，cscrepupdateコマンドを使用して，旧バージョンで作成されたリポジトリをアップデートします。

次の手順でcscrepupdateコマンドを実行してください。

次に示すアダプタがリポジトリに定義されている場合は，各アダプタに対応するプロトコルコンバータのJARファイルを格納します。

FTPアダプタ

Message Queueアダプタ

Object Accessアダプタ

ファイルアダプタ

TP1アダプタ

JARファイルの格納先フォルダは次のとおりです。
<Cosminexusのインストールディレクトリ>¥CSC¥custom-adapter

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)～(2)の手順に従って，Cosminexus サービスプラットフォームを旧バージョンから08-70へ移行してください。

図H-2　上書きインストールする場合の移行手順（運用環境だけを移行する場合）

図H-2の(1)～(2)の手順の詳細を次に示します。

なお，手順内で使用するコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「4.　コマンド（運用環境・実行環境）」を参照してください。

＜この項の構成＞

(1)　各環境の上書きインストール

(2)　実行環境のバージョンアップ（運用環境）

(1)　各環境の上書きインストール

運用環境および実行環境で08-70のCosminexus サービスプラットフォームを上書きインストールしてバージョンアップします。

各環境を上書きインストールするときの前提条件を次に示します。

前提条件

HCSCサーバがセットアップ済みであること

Cosminexus アプリケーションサーバおよびCosminexus RMが停止していること

組み込みデータベースを使用している場合，組み込みデータベースを停止していること

HCSCサーバ，J2EEサーバ，およびHCSCコンポーネントが停止していること

注意

上書きインストールする場合，次の点に注意してください。

J2EEサーバ，Management Server，PRFなど実行環境の構成要素を停止してから上書きインストールしてください。

組み込みデータベースを使用している場合，組み込みデータベースを停止してから上書きインストールしてください。

なお，上書きインストールでは次のファイルを除いて上書きされます。

<Cosminexusインストールディレクトリ>¥CSC¥config¥manager¥csccmd.properties

<Cosminexusインストールディレクトリ>¥CSC¥config¥manager¥cscmng.properties

<Cosminexusインストールディレクトリ>¥CSC¥config¥msg¥cmdconf.bat

<Cosminexusインストールディレクトリ>¥CSC¥inbound-adapter¥ftp¥config¥command¥log4j.xml

<Cosminexusインストールディレクトリ>¥CSC¥inbound-adapter¥ftp¥config¥FTP_Inbound_Resource_Adapter¥serverstatus.properties

<Cosminexusインストールディレクトリ>¥CSC¥inbound-adapter¥ftp¥config¥FTP_Inbound_Resource_Adapter¥users.properties

<Cosminexusインストールディレクトリ>¥CSC¥system¥manager¥setup¥input.properties

(2)　実行環境のバージョンアップ（運用環境）

運用環境から実行環境のバージョンアップを実施します。

(a)　前提条件

実行環境をバージョンアップするには，次の条件を満たしている必要があります。

Management Serverが起動していること

組み込みデータベースを使用している場合，組み込みデータベースが起動していること

Cosminexus アプリケーションサーバおよびCosminexus RMの移行が完了していること
Cosminexus アプリケーションサーバの移行方法については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 保守／移行／互換編」の「12.　旧バージョンのアプリケーションサーバからの移行」を参照してください。Cosminexus RMの移行方法については，マニュアル「Cosminexus Reliable Messaging」の「付録H　旧バージョンからの移行」を参照してください。

リポジトリのバージョンがインストールバージョンより古いか，一致していること

リポジトリのバージョンがインストールバージョンより古い場合，リポジトリのバージョンが08-00以降であること

FTPインバウンドアダプタを使用する場合，cjrarupdateコマンド※でのリソースアダプタのバージョンアップが完了していること

注※

cjrarupdateコマンドには次のオプションを指定してください。

　-typeオプション：「rar」

　-fオプション：「<Cosminexusインストールディレクトリ>¥CSC¥inbound-adapter¥ftp¥rar¥ftp_inbound_adapter.rar」

cjrarupdateコマンドの詳細については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjrarupdate（リソースアダプタのバージョンアップ）」を参照してください。

前提条件を満たしていない場合，上記の順番で起動，停止，およびバージョンアップを実施してください。

(b)　バージョンアップ方法

cscenvupdateコマンドを運用環境で実行します。次に示す手順で実行してください。

次に示すアダプタがリポジトリに定義されている場合は，各アダプタに対応するプロトコルコンバータのJARファイルを格納します。

FTPアダプタ

Message Queueアダプタ

Object Accessアダプタ

ファイルアダプタ

TP1アダプタ

JARファイルの格納先フォルダは次のとおりです。
<Cosminexusのインストールディレクトリ>¥CSC¥custom-adapter

cscenvupdateコマンドを実行して，リポジトリとHCSCサーバをバージョンアップします。

cscenvupdate -csc <バージョンアップするHCSCサーバ名>

なお，旧バージョンで使用していたリポジトリ情報を開発環境でバージョンアップ前後に変更し，そのリポジトリ情報を使用して運用する場合のバージョンアップ方法については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「付録A　旧バージョンからの移行」を参照してください。

注意

HCSCコンポーネントが開始状態でHCSCサーバを停止して，実行環境のバージョンアップを実施した場合，次回のHCSCサーバの起動時には，HCSCコンポーネントが停止した状態となります。そのため，HCSCサーバ起動後にHCSCコンポーネントを開始する必要があります。

付録H.4　ローリングアップデートで運用環境のレポジトリを移行する手順

ローリングアップデートとは，システムを全面停止しないで，上書きインストールで移行する方法です。

ローリングアップデートで移行する場合，2台以上のHCSCサーバでロードバランスクラスタを構成している必要があります。

次の図に示す(1)～(8)の手順に従って，Cosminexus サービスプラットフォームを旧バージョンから08-70へ移行してください。

図H-3　ローリングアップデートの場合の移行手順（運用環境だけを移行する場合）

図H-3の(1)～(8)の手順の詳細と，2台目以降のHCSCサーバ（実行環境）に対して実施する作業を次に示します。

なお，手順内で使用するコマンドの詳細については，マニュアル「Cosminexus サービスプラットフォーム リファレンス」の「4.　コマンド（運用環境・実行環境）」を参照してください。

注意

ローリングアップデートでの移行が完了するまで，旧バージョンのシステムに対して，次の操作はできません。

cscsvsetupコマンドで，新規にHCSCサーバをセットアップする

csccompodeployコマンドで，新規にHCSCコンポーネントを配備する

＜この項の構成＞

(1)　リポジトリのエクスポート（運用環境）

(2)　運用環境のインストール

(3)　リクエストの送信制御（ロードバランサ）

(4)　実行環境のインストール

(5)　実行環境のバージョンアップ（運用環境）

(6)　HCSCサーバの起動（運用環境）

(7)　HCSCコンポーネントの開始（運用環境）

(8)　リクエストの送信制御の解除（ロードバランサ）

(9)　2台目以降のHCSCサーバ（実行環境）に対しての作業

(10)　ローリングアップデートで移行する場合の注意事項

(1)　リポジトリのエクスポート（運用環境）

バージョンアップ前の運用環境のリポジトリをエクスポートして，いったん退避します。複数のリポジトリを使用している場合は，すべてのリポジトリをエクスポートして退避します。

cscrepctlコマンド（-exportオプション）を運用環境で実行して，バージョンアップ前のリポジトリをエクスポートしてください。

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

(2)　運用環境のインストール

運用環境で08-70のCosminexus サービスプラットフォームをインストールしてバージョンアップします。運用環境は，新規インストールまたは上書きインストールでインストールします。

新規にインストールする場合

「付録H.2　新規にインストールして運用環境のリポジトリを移行する手順」の(2)～(5)の作業を実施します。

上書きインストールする場合

「付録H.3　上書きインストールして運用環境のリポジトリを移行する手順」の(1)の作業を実施します。

注意

上書きインストールする場合，インストールする環境で，J2EEサーバ，Management Server，PRFなどのCosminexus実行環境が稼働中の場合は，すべていったん停止してから上書きインストールしてください。

インストールするときの前提条件を次に示します。

前提条件

HCSCサーバがセットアップ済みであること

Cosminexus アプリケーションサーバおよびCosminexus RMが停止していること

組み込みデータベースを使用している場合，組み込みデータベースを停止していること

HCSCサーバ，J2EEサーバ，およびHCSCコンポーネントが停止していること

(3)　リクエストの送信制御（ロードバランサ）

バージョンアップするHCSCサーバに対してリクエストを送信しないように，ロードバランサを設定します。その際，仕掛かり中のリクエストがないことを確認してください。なお，設定方法は各ロードバランサの仕様によって異なります。

(4)　実行環境のインストール

実行環境で，08-70のCosminexus サービスプラットフォームをインストールしてバージョンアップします。

実行環境は，新規インストールまたは上書きインストールのどちらかの方法でインストールします。

新規にインストールする場合

「付録H.2　新規にインストールして運用環境のリポジトリを移行する手順」の(2)～(6)の作業を実施します。

上書きインストールする場合

「付録H.3　上書きインストールして運用環境のリポジトリを移行する手順」の(1)の作業を実施します。

(5)　実行環境のバージョンアップ（運用環境）

運用環境から実行環境のバージョンアップを実施します。

(a)　前提条件

実行環境をバージョンアップするには，次の条件を満たしている必要があります。

Management Serverが起動していること

組み込みデータベースを使用している場合，組み込みデータベースが起動していること

Cosminexus アプリケーションサーバおよびCosminexus RMの移行が完了していること
Cosminexus アプリケーションサーバの移行方法については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 保守／移行／互換編」の「12.　旧バージョンのアプリケーションサーバからの移行」を参照してください。Cosminexus RMの移行方法については，マニュアル「Cosminexus Reliable Messaging」の「付録H　旧バージョンからの移行」を参照してください。

リポジトリのバージョンがインストールバージョンより古いか，一致していること

リポジトリのバージョンがインストールバージョンより古い場合，リポジトリのバージョンが08-00以降であること

前提条件を満たしていない場合，上記の順番で起動，停止，およびバージョンアップを実施してください。

(b)　バージョンアップ方法

cscenvupdateコマンドを運用環境で実行します。次に示す手順で実行してください。

次に示すアダプタがリポジトリに定義されている場合は，各アダプタに対応するプロトコルコンバータのJARファイルを格納します。

FTPアダプタ

Message Queueアダプタ

Object Accessアダプタ

ファイルアダプタ

TP1アダプタ

JARファイルの格納先フォルダは次のとおりです。
<Cosminexusのインストールディレクトリ>¥CSC¥custom-adapter

cscenvupdateコマンドを実行して，リポジトリとHCSCサーバをバージョンアップします。

cscenvupdate -csc <バージョンアップするHCSCサーバ名>

(6)　HCSCサーバの起動（運用環境）

バージョンアップしたHCSCサーバを起動します。

(7)　HCSCコンポーネントの開始（運用環境）

(6)で起動したHCSCサーバに配備されているHCSCコンポーネントを開始します。

(8)　リクエストの送信制御の解除（ロードバランサ）

バージョンアップしたHCSCサーバに対してリクエストを送信するように，ロードバランサを設定します。なお，設定方法は各ロードバランサの仕様によって異なります。

(9)　2台目以降のHCSCサーバ（実行環境）に対しての作業

ロードバランスクラスタを構成しているすべてのHCSCサーバに対して，(3)～(8)の作業を実施します。

なお，旧バージョンで使用していたリポジトリ情報を開発環境でバージョンアップ前後に変更し，そのリポジトリ情報を使用して運用する場合のバージョンアップ方法については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「付録A　旧バージョンからの移行」を参照してください。

(10)　ローリングアップデートで移行する場合の注意事項

ローリングアップデートで移行する場合の注意事項は，開発環境，運用環境および実行環境のバージョンアップ時と同じです。ローリングアップデートで移行する場合の注意事項については，「付録G.4(11)　ローリングアップデートで移行する場合の注意事項」を参照してください。

付録H.5　移行したあとの注意事項

移行したあとの注意事項は，開発環境，運用環境および実行環境のバージョンアップ時と同じです。移行したあとの注意事項については，「付録G.5　移行したあとの注意事項」を参照してください。

付録I　このマニュアルの参考情報

このマニュアルを読むに当たっての参考情報を示します。

＜この節の構成＞

付録I.1　関連マニュアル

付録I.2　このマニュアルでの表記

付録I.3　英略語

付録I.4　KB（キロバイト）などの単位表記について

付録I.1　関連マニュアル

このマニュアルの関連マニュアルを，次の図に示します。必要に応じてお読みください。

図I-1　このマニュアルの関連マニュアル

また，図に示したマニュアル以外で，このマニュアルと関連するマニュアルを次に示します。必要に応じてお読みください。

Cosminexus アプリケーションサーバ関連

Cosminexus アプリケーションサーバ V8 概説（3020-3-U01）

Cosminexus アプリケーションサーバ V8 ファーストステップガイド（3020-3-U02）

Cosminexus アプリケーションサーバ V8 システム設計ガイド（3020-3-U03）

Cosminexus アプリケーションサーバ V8 システム構築・運用ガイド（3020-3-U04）

Cosminexus アプリケーションサーバ V8 機能解説 基本・開発編(Webコンテナ)（3020-3-U05）

Cosminexus アプリケーションサーバ V8 機能解説 基本・開発編(EJBコンテナ)（3020-3-U06）

Cosminexus アプリケーションサーバ V8 機能解説 基本・開発編(コンテナ共通機能)（3020-3-U07）

Cosminexus アプリケーションサーバ V8 機能解説 拡張編（3020-3-U08）

Cosminexus アプリケーションサーバ V8 機能解説 運用／監視／連携編（3020-3-U09）

Cosminexus アプリケーションサーバ V8 機能解説 保守／移行／互換編（3020-3-U10）

Cosminexus アプリケーションサーバ V8 アプリケーション設定操作ガイド（3020-3-U12）

Cosminexus アプリケーションサーバ V8 運用管理ポータル操作ガイド（3020-3-U13）

Cosminexus アプリケーションサーバ V8 リファレンス コマンド編（3020-3-U14）

Cosminexus アプリケーションサーバ V8 リファレンス 定義編(サーバ定義)（3020-3-U15）

Cosminexus アプリケーションサーバ V8 リファレンス 定義編(アプリケーション／リソース定義)（3020-3-U16）

Hitachi Web Server（3020-3-U17）

Cosminexus アプリケーションサーバ V8 仮想化システム構築・運用ガイド（3020-3-U18）

TPBroker Version 5 トランザクショナル分散オブジェクト基盤 TPBroker ユーザーズガイド（3020-3-U19）

TPBroker Version 5 トランザクショナル分散オブジェクト基盤 TPBroker 運用ガイド（3020-3-U20）

Cosminexus アプリケーションサーバ V8 Cosminexus Reliable Messaging（3020-3-U21）

Cosminexus アプリケーションサーバ V8 アプリケーション開発ガイド（3020-3-U25）

Cosminexus アプリケーションサーバ V8 リファレンス API編（3020-3-U26）

Cosminexus アプリケーションサーバ V8 Cosminexus XML Processor ユーザーズガイド（3020-3-U27）

VisiBroker Version 5 Borland(R) Enterprise Server VisiBroker(R) デベロッパーズガイド（3020-3-U28）

VisiBroker Version 5 Borland(R) Enterprise Server VisiBroker(R) プログラマーズリファレンス（3020-3-U29）

Cosminexus アプリケーションサーバ V8 SOAPアプリケーション開発の手引（3020-3-U30）

Cosminexus アプリケーションサーバ V8 Webサービス開発の手引（3020-3-U31）

Cosminexus アプリケーションサーバ V8 Webサービスセキュリティ 使用の手引（3020-3-U32）

Cosminexus アプリケーションサーバ V8 Cosminexus XML Security - Core ユーザーズガイド（3020-3-U33）

Cosminexus アプリケーションサーバ V8 メッセージ 1 KDAL-KDCGおよびHitachi Web Server編（3020-3-U41）

Cosminexus アプリケーションサーバ V8 メッセージ 2 KDJE-KDJW編（3020-3-U42）

Cosminexus アプリケーションサーバ V8 メッセージ 3 KECX-KEDT／KEOS02000-29999／KEUC-KFRM編（3020-3-U43）

Cosminexus アプリケーションサーバ V8 メッセージ 4 監査ログ編（3020-3-U44）

Cosminexus ビジネスプロセス管理/エンタープライズサービスバス V8 サービスプラットフォーム TP1アダプタ　ユーザーズガイド（3020-3-U58）

HiRDB関連

HiRDB Version 8 解説（Windows(R)用）（3020-6-351）

HiRDB Version 8 解説（UNIX(R)用）（3000-6-351）

HiRDB Version 9 解説（Windows(R)用）（3020-6-451）

HiRDB Version 9 解説（UNIX(R)用）（3000-6-451）

HiRDB Version 8 システム導入・設計ガイド（Windows(R)用）（3020-6-352）

HiRDB Version 8 システム導入・設計ガイド（UNIX(R)用）（3000-6-352）

HiRDB Version 9 システム導入・設計ガイド（Windows(R)用）（3020-6-452）

HiRDB Version 9 システム導入・設計ガイド（UNIX(R)用）（3000-6-452）

HiRDB Version 8 システム定義（Windows(R)用）（3020-6-353）

HiRDB Version 8 システム定義（UNIX(R)用）（3000-6-353）

HiRDB Version 9 システム定義（Windows(R)用）（3020-6-453）

HiRDB Version 9 システム定義（UNIX(R)用）（3000-6-453）

HiRDB Version 8 システム運用ガイド（Windows(R)用）（3020-6-354）

HiRDB Version 8 システム運用ガイド（UNIX(R)用）（3000-6-354）

HiRDB Version 9 システム運用ガイド（Windows(R)用）（3020-6-454）

HiRDB Version 9 システム運用ガイド（UNIX(R)用）（3000-6-454）

HiRDB Version 8 コマンドリファレンス（Windows(R)用）（3020-6-355）

HiRDB Version 8 コマンドリファレンス（UNIX(R)用）（3000-6-355）

HiRDB Version 9 コマンドリファレンス（Windows(R)用）（3020-6-455）

HiRDB Version 9 コマンドリファレンス（UNIX(R)用）（3000-6-455）

HiRDB Version 8 UAP開発ガイド（3020-6-356）

HiRDB Version 9 UAP開発ガイド（3020-6-456）

HiRDB Version 8 SQLリファレンス（3020-6-357）

HiRDB Version 9 SQLリファレンス（3020-6-457）

HiRDB Version 8 メッセージ（3020-6-358）

HiRDB Version 9 メッセージ（3020-6-458）

その他

JP1 Version 8 JP1/Integrated Management - Manager　システム構築・運用ガイド（3020-3-K01）

JP1 Version 9 JP1/Integrated Management - Manager　構築ガイド（3020-3-R77）

JP1 Version 9 JP1/Integrated Management - Manager　運用ガイド（3020-3-R78）

なお，このマニュアルでは，次のマニュアルについて，対象OSおよびバージョン番号を省略して表記しています。マニュアルの正式名称とこのマニュアルでの表記を次の表に示します。

正式名称 | このマニュアルでの表記
Cosminexus ビジネスプロセス管理/エンタープライズサービスバス V8 サービスプラットフォーム 概説 | Cosminexus サービスプラットフォーム 概説
Cosminexus ビジネスプロセス管理/エンタープライズサービスバス V8 サービスプラットフォーム 開発ガイド | Cosminexus サービスプラットフォーム 開発ガイド
Cosminexus ビジネスプロセス管理/エンタープライズサービスバス V8 サービスプラットフォーム 機能解説 | Cosminexus サービスプラットフォーム 機能解説
Cosminexus ビジネスプロセス管理/エンタープライズサービスバス V8 サービスプラットフォーム リファレンス | Cosminexus サービスプラットフォーム リファレンス
Cosminexus ビジネスプロセス管理/エンタープライズサービスバス V8 サービスプラットフォーム メッセージ | Cosminexus サービスプラットフォーム メッセージ
Cosminexus アプリケーションサーバ V8 システム設計ガイド | Cosminexus アプリケーションサーバ システム設計ガイド
Cosminexus アプリケーションサーバ V8 システム構築・運用ガイド | Cosminexus アプリケーションサーバ システム構築・運用ガイド
Cosminexus アプリケーションサーバ V8機能解説 基本・開発編(コンテナ共通機能) | Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)
Cosminexus アプリケーションサーバ V8 機能解説 拡張編 | Cosminexus アプリケーションサーバ 機能解説 拡張編
Cosminexus アプリケーションサーバ V8 機能解説 運用／監視／連携編 | Cosminexus アプリケーションサーバ 機能解説 運用／監視／連携編
Cosminexus アプリケーションサーバ V8 機能解説 保守／移行／互換編 | Cosminexus アプリケーションサーバ 機能解説 保守／移行／互換編
Cosminexus アプリケーションサーバ V8 アプリケーション設定操作ガイド | Cosminexus アプリケーションサーバ アプリケーション設定操作ガイド
Cosminexus アプリケーションサーバ V8 運用管理ポータル操作ガイド | Cosminexus アプリケーションサーバ 運用管理ポータル操作ガイド
Cosminexus アプリケーションサーバ V8 リファレンス コマンド編 | Cosminexus アプリケーションサーバ リファレンス コマンド編
Cosminexus アプリケーションサーバ V8 リファレンス 定義編(サーバ定義) | Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)
Cosminexus アプリケーションサーバ V8 リファレンス 定義編(アプリケーション／リソース定義) | Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)
Cosminexus アプリケーションサーバ V8 Cosminexus Reliable Messaging | Cosminexus Reliable Messaging
Cosminexus アプリケーションサーバ V8 アプリケーション開発ガイド | Cosminexus アプリケーションサーバ アプリケーション開発ガイド
Cosminexus アプリケーションサーバ V8 SOAPアプリケーション開発の手引 | Cosminexus アプリケーションサーバ SOAPアプリケーション開発の手引
Cosminexus アプリケーションサーバ V8 Webサービス開発の手引 | Cosminexus アプリケーションサーバ Webサービス開発の手引
Cosminexus アプリケーションサーバ V8 メッセージ 1 KDAL-KDCGおよびHitachi Web Server編 | Cosminexus アプリケーションサーバ メッセージ 1
Cosminexus アプリケーションサーバ V8 メッセージ 2 KDJE-KDJW編 | Cosminexus アプリケーションサーバ メッセージ 2
HiRDB Version 9 解説（Windows(R)用） | HiRDB 解説
HiRDB Version 9 解説（UNIX(R)用）
HiRDB Version 8 解説（Windows(R)用）
HiRDB Version 8 解説（UNIX(R)用）
HiRDB Version 9 システム導入・設計ガイド（Windows(R)用） | HiRDB システム導入・設計ガイド
HiRDB Version 9 システム導入・設計ガイド（UNIX(R)用）
HiRDB Version 8 システム導入・設計ガイド（Windows(R)用）
HiRDB Version 8 システム導入・設計ガイド（UNIX(R)用）
HiRDB Version 9 システム定義（Windows(R)用） | HiRDB システム定義
HiRDB Version 9 システム定義（UNIX(R)用）
HiRDB Version 8 システム定義（Windows(R)用）
HiRDB Version 8 システム定義（UNIX(R)用）
HiRDB Version 9 システム運用ガイド（Windows(R)用） | HiRDB システム運用ガイド
HiRDB Version 9 システム運用ガイド（UNIX(R)用）
HiRDB Version 8 システム運用ガイド（Windows(R)用）
HiRDB Version 8 システム運用ガイド（UNIX(R)用）
HiRDB Version 9 コマンドリファレンス（Windows(R)用） | HiRDB コマンドリファレンス
HiRDB Version 9 コマンドリファレンス（UNIX(R)用）
HiRDB Version 8 コマンドリファレンス（Windows(R)用）
HiRDB Version 8 コマンドリファレンス（UNIX(R)用）
HiRDB Version 9 UAP開発ガイド | HiRDB UAP開発ガイド
HiRDB Version 8 UAP開発ガイド
HiRDB Version 9 SQLリファレンス | HiRDB SQLリファレンス
HiRDB Version 8 SQLリファレンス
HiRDB Version 9 メッセージ | HiRDB メッセージ
HiRDB Version 8 メッセージ
JP1 Version 8 JP1/Integrated Management - Manager システム構築・運用ガイド | JP1/Integrated Management - Manager システム構築・運用ガイド
JP1 Version 9 JP1/Integrated Management - Manager　構築ガイド | JP1/Integrated Management - Manager 構築ガイド
JP1 Version 9 JP1/Integrated Management - Manager　運用ガイド | JP1/Integrated Management - Manager 運用ガイド

付録I.2　このマニュアルでの表記

＜この項の構成＞

(1)　製品名

(2)　Cosminexusの機能名

(3)　Java関連用語

(1)　製品名

このマニュアルで使用する表記と，対応する製品名を次に示します。

表記 | 製品名
Eclipse | Eclipse Classic 3.6.1
HiRDBまたはHiRDBサーバ | HiRDB/Parallel Server | HiRDB/Parallel Server Version 8
HiRDB/Single Server | HiRDB/Single Server Version 8
HiRDB Embedded Serverまたは組み込みデータベース | HiRDB Embedded Server Version 8
HiRDB Server | HiRDB Server Version 9
IPF | Itanium(R) Processor Family
JP1 | JP1関連製品
JP1/IM | JP1/IM - Manager | JP1/Integrated Management - Manager
JP1/IM - View | JP1/Integrated Management - View
Oracle | Oracle 10g | Oracle 10g R2
Oracle 11g | Oracle Database 11g
TP1/EE | TP1/Server Base Enterprise Option
UNIX | AIX | AIX 5L V5.3
AIX V6.1
AIX V7.1
HP-UX | HP-UX 11i V2（IPF）
HP-UX 11i V3（IPF）
Linux（IPF） | Red Hat Enterprise Linux(R) AS 4（IPF）
Red Hat Enterprise Linux(R) 5（Intel Itanium(R)）
Red Hat Enterprise Linux(R) 5 Advanced Platform（Intel Itanium(R)）
LinuxまたはLinux（x86／AMD64 & Intel EM64T） | Red Hat Enterprise Linux(R) AS 4（x86）
Red Hat Enterprise Linux(R) 5 Advanced Platform（x86）
Red Hat Enterprise Linux(R) ES 4（x86）
Red Hat Enterprise Linux(R) 5（x86）
Red Hat Enterprise Linux(R) AS 4（AMD64 & Intel EM64T）
Red Hat Enterprise Linux(R) 5 Advanced Platform（AMD/Intel 64）
Red Hat Enterprise Linux(R) ES 4（AMD64 & Intel EM64T）
Red Hat Enterprise Linux(R) 5（AMD/Intel 64）
Red Hat Enterprise Linux(R) Server 6（32-bit x86）
Red Hat Enterprise Linux(R) Server 6（64-bit x86_64）

(2)　Cosminexusの機能名

このマニュアルで使用する表記と，対応するCosminexusの機能名を次に示します。

表記 | Cosminexusの機能名
Cosminexus RM | Cosminexus Reliable Messaging
CTM | Cosminexus Component Transaction Monitor
HCSC | Hitachi Cosminexus Service Coordinator
HCSC-Business Process，ビジネスプロセス基盤，またはBP基盤 | Hitachi Cosminexus Service Coordinator - Business Process
HCSC-Data Transformまたはデータ変換基盤 | Hitachi Cosminexus Service Coordinator - Data Transform
HCSC-DB AdapterまたはDBアダプタ | Hitachi Cosminexus Service Coordinator - Database Adapter
HCSC-ManagerまたはHCSC-MNG | Hitachi Cosminexus Service Coordinator - Manager
HCSC-Messaging，HCSC-MSG，またはメッセージング基盤 | Hitachi Cosminexus Service Coordinator - Messaging
Management Server | Cosminexus Management Server
MyEclipse | MyEclipse for Cosminexus
PRF | Cosminexus Performance Tracer
TPBroker | Cosminexus TPBroker

(3)　Java関連用語

このマニュアルで使用する表記と，対応するJava関連用語を次に示します。

表記 | Java関連用語
Connector 1.5 | J2EETM Connector Architecture 1.5
EAR | Enterprise ARchive
EJBまたはEnterprise JavaBeans | Enterprise JavaBeans
J2EE | J2EETM
JavaTM 2 Platform, Enterprise Edition
J2SE | JavaTM 2 Platform, Standard Edition
JAR | JavaTM Archive
Java | JavaTM
JDBC | JavaTM Database Connectivity
JDK | JDKTM
JavaTM Development Kit
JMS | JavaTM Message Service
JNDI | Java Naming and Directory InterfaceTM

付録I.3　英略語

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

英略語 | 英字での表記
API | Application Programming Interface
ASCII | American Standard Code for Information Interchange
BMT | Bean Managed Transaction
BP | Business Process
BPEL | Business Process Execution Language
CMT | Container Managed Transaction
CORBA | Common Object Request Broker Architecture
CSV | Comma Separated Value
DB | Database
DBMS | Database Management System
DOM | Document Object Model
DTD | Document Type Definition
GMT | Greenwich Mean Time
GUI | Graphical User Interface
HTML | Hyper Text Markup Language
HTTP | Hyper Text Transfer Protocol
HTTPS | Hyper Text Transfer Protocol Security
IIOP | Internet Inter-Orb Protocol
JIS | Japanese Industrial Standards
LAN | Local Area Network
MBean | Managed Bean
MDB | Message-Driven Bean
NTP | Network Time Protocol
OS | Operating System
RDB | Relational Database
RMI | Remote Method Invocation
SOA | Service Oriented Architecture
SOAP | Simple Object Access Protocol
TSV | Tab Separated Values
UOC | User Own Coding
URL | Uniform Resource Locator
UTF | UCS Transformation Format
VM | Virtual Machine
W3C | World Wide Web Consortium
WS-R | Web Services Reliability
WSDL | Web Service Description Language
XML | Extensible Markup Language
XPath | XML Path Language

付録I.4　KB（キロバイト）などの単位表記について

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

付録J　用語解説

（英字）

Cosminexus Manager

Cosminexus アプリケーションサーバのシステムの運用管理機能です。Management Serverおよび運用管理エージェントの総称です。

CTM（Cosminexus Component Transaction Monitor）

構成ソフトウェアの一つです。サービス部品の実行要求が集中しないようにスケジューリングをするための機能です。

DB Connector

データベースに接続するためのリソースアダプタです。

DBアダプタ

データベースの操作をサービス部品として利用する場合に，操作するデータベースや実行するSQLを定義したHCSCコンポーネントです。

DBキュー

データベースを介してシステム間で連携する，TP1/EE（TP1/Server Base Enterprise Option）の機能です。DBキュー機能を使用すると，データベースをキューとして，TP1/EEとJ2EEとの間で，非同期型のメッセージ送受信ができます。

EAR（Enterprise ARchive）ファイル

J2EEアプリケーションを構成する複数のファイルをEARファイル形式でパッケージ化したものです。

Cosminexus サービスプラットフォームでは，HCSCコンポーネントをパッケージングして，EARファイルを作成します。

Eclipse

Eclipseプロジェクト（eclipse.org）が提供するオープンソースの統合開発環境です。ソースコードの編集支援機能やデバッグ機能など，アプリケーションの開発効率を向上させる各種機能を備えています。

Cosminexus サービスプラットフォームでは，Eclipseに必要な機能をプラグインして利用します。

EJB（Enterprise JavaBeans）

業務ロジックをプログラムとして記述したビジネスロジック，および永続的データを格納するオブジェクトであるエンティティをJavaコンポーネント化したものです。Oracle CorporationからEJB仕様が公開されています。

FTPアダプタ

Cosminexus サービスプラットフォームとFTPサーバとの間でファイルの送受信をするために利用するアダプタです。

FTPインバウンドアダプタ

FTP連携で使用するリソースアダプタです。Connector 1.5仕様に準拠しています。

FTP受付

FTPインバウンドアダプタを経由してFTPクライアントからの実行要求を受け付ける機能（インターフェース）です。

ファイル操作アダプタやFTPアダプタと連携することで，Cosminexus サービスプラットフォーム上でFTPクライアントとFTPサーバの間のファイル転送ができるようになります。

FTPクライアント

FTPを使用してファイルの送受信を行うクライアント用ソフトウェアです。

FTPサーバ

FTPクライアントからの要求によってファイルを送受信するサーバ用ソフトウェアです。

FTP連携

Cosminexus サービスプラットフォーム上でFTPクライアントとFTPサーバの間のファイル転送を実現するための機能です。

HCSC（Hitachi Cosminexus Service Coordinator）

uCosminexus Service Platformを構成する構成ソフトウェアの一つです。Cosminexus サービスプラットフォームでSOAを適用したシステムを構築，運用するための機能として，ビジネスプロセス実行機能，データ変換機能，DBアダプタ機能，実行環境の運用管理機能，およびメッセージング制御機能を提供しています。

HCSC-Business Process（ビジネスプロセス基盤）

ビジネスプロセスの定義に従って，適切なサービス部品を呼び出すための機能です。

HCSC-Data Transform（データ変換基盤）

データ変換定義に従って，要求電文・応答電文の電文フォーマットを変換する機能です。

HCSC-DB Adapter（DBアダプタ）

DBアダプタの定義に従って適切なサービス部品（データベースの操作）を呼び出す機能です。

HCSC-Manager

Cosminexus サービスプラットフォームの運用環境で利用する運用管理機能です。

HCSCサーバのセットアップ機能，HCSCコンポーネントの配備機能，プロセスインスタンスの実行履歴管理機能などが含まれます。

HCSC-Managerコマンド共通定義ファイル（csccmd.properties）

運用環境で使用するコマンドの必須項目の省略値を定義するファイルです。J2SEのプロパティ形式のファイルとして作成します。

このファイルに省略値を定義しておくと，コマンド入力時に該当するオプションの入力を省略できます。

HCSC-Manager定義ファイル（cscmng.properties）

運用環境のカスタマイズに必要な情報を定義するファイルです。J2SEのプロパティ形式のファイルとして作成します。

リポジトリのインポート先となるディレクトリや，ログファイルの大きさ・面数などを定義できます。

HCSC-Messaging（メッセージング基盤）

サービスアダプタの定義に従って適切なサービス部品を呼び出す機能です。

HCSCコンポーネント

開発環境で作成するサービスアダプタ，DBアダプタ，ビジネスプロセス，およびユーザ定義受付の総称です。

HCSCサーバ

実行環境でサービス部品の実行を管理するサーバ機能です。メッセージング基盤，ビジネスプロセス基盤，データ変換基盤など，実行環境に必要な機能が含まれます。また，標準受付，ユーザ定義受付などのリクエスト受付機能や，サービスアダプタ（Webサービス，SessionBean，MDB（WS-R），MDB（DBキュー），DBアダプタ）の各種アダプタ機能も含まれます。

HCSCサーバ構成定義ファイル（cscsvsetup.xml）

HCSCサーバの構成を定義するファイルです。XML形式のファイルとして作成します。

HCSCサーバ，クラスタ，Cosminexus Managerなどの情報を定義できます。

HCSCサーバセットアップ定義ファイル（cscsvsetup.properties）

HCSCサーバのセットアップに必要な情報を定義するファイルです。J2SEのプロパティ形式のファイルとして作成します。

HCSCサーバに設定するクラスタ名や使用できる標準受付の種類などを定義できます。

HCSCサーバランタイム定義ファイル（cscsvconfig.properties）

HCSCサーバの起動時に必要なランタイム情報を定義するファイルです。J2SEのプロパティ形式のファイルとして作成します。

実行履歴を採取するかどうかや，トレースファイルのレベル・出力先などを定義できます。

HTTP

インターネットで，WWWサーバとWWWクライアントの間でHTML文書を送受信するための通信プロトコルです。

iWayアダプタ

Cosminexus サービスプラットフォームの実行環境から他社ERPパッケージのサービス部品を呼び出す場合に利用するアダプタです。

J2EEサーバ

アプリケーションを実行するためのサーバ基盤であるJ2EEコンテナを生成，実行する環境です。Cosminexus サービスプラットフォームは，J2EEサーバとしてCosminexus Component Containerを使用します。

JAX-WSエンジン

Cosminexusが提供するWebサービスの通信基盤です。SOAP1.1仕様およびSOAP1.2仕様に対応しています。

JDBC（Java Database Connectivity）

Javaのプログラムでデータベースを利用するためのAPIです。

JavaSoftが1996年前半に仕様を公開しました。Javaプログラムから，JDBC APIを経由して「JDBCドライバ」を呼び出し，ドライバがデータベース・サーバへの接続機能を提供します。

JP1

日立の統合システム運用管理ソフトウェアの総称です。

MBean（Managed Bean）

管理対象となるリソースを表すJavaオブジェクトです。JMX仕様に基づいて実装されます。マネージャに対するリソースのインターフェースとして機能し，リソースに関する情報や操作をマネージャに提供します。

Message Queueアダプタ

Cosminexus サービスプラットフォームの実行環境から既存のメッセージキュー（IBM WebSphere MQシステム）に対してメッセージの送受信をする場合に利用するアダプタです。

MyEclipse

Javaアプリケーションの開発環境です。MyEclipseには，Eclipseでアプリケーションを開発するときに使用するプラグインがまとめられています。MyEclipseを使用すると，アプリケーションの作成，J2EEサーバへのアプリケーションのデプロイ，J2EEサーバの起動・停止，データベースの操作などができます。

Cosminexusでは，構成ソフトウェアとして，MyEclipseの日本語版環境であるMyEclipse for Cosminexusを提供しています。

Object Accessアダプタ

Cosminexus サービスプラットフォームの実行環境から既存のTPBrokerシステム（Object Wrapperシステム）のサービス部品を呼び出す場合に利用するアダプタです。

RMI-IIOP

JavaRMIとJavaIDLを統合したAPIです。

SessionBean

セッション単位での処理を行う機能がある，EJBで規定されているBeanの一つです。

SOAP（Simple Object Access Protocol）

ネットワーク上のサービス部品を呼び出す際のメッセージを規定したものです。HTTPとXMLがベースとなっています。

SOAP1.1/1.2併用モード

利用するWebサービスの標準仕様および通信基盤を表すモードです。SOAP1.1仕様およびSOAP1.2仕様に対応したサービス部品／サービスリクエスタを利用するときに指定します。SOAP1.1/1.2併用モードでは，通信基盤としてCosminexusが提供するJAX-WSエンジンを利用します。

SOAP1.1モード

利用するWebサービスの標準仕様および通信基盤を表すモードです。SOAP1.1仕様に対応したサービス部品／サービスリクエスタを利用するときに指定します。SOAP1.1モードでは，通信基盤としてCosminexusが提供するSOAP通信基盤を利用します。

SOAP通信基盤

Cosminexusが提供するWebサービス（SOAPアプリケーション）の通信基盤です。SOAP1.1仕様に対応しています。

TP1/RPC受付

既存のOpenTP1システム内にあるサービスリクエスタからのサービス部品呼び出し要求を受け付けるための機能（インターフェース）です。

TP1アダプタ

Cosminexus サービスプラットフォームの実行環境から既存のOpenTP1システム内にあるサービス部品を呼び出す場合に利用するアダプタです。

TP1インバウンドアダプタ

TP1インバウンド連携機能で使用するリソースアダプタです。Connector 1.5仕様に準拠しています。

TP1連携システム

OpenTP1システム内にあるサービスリクエスタおよびサービス部品と接続するためのシステム構成です。

uCosminexus Service Architect

Cosminexus サービスプラットフォームの開発環境を構築・運用するための製品です。

uCosminexus Service Platform

Cosminexus サービスプラットフォームの実行環境・運用環境を構築・運用するための製品です。

W3C（World Wide Web Consortium）

XMLやDOMを含むWeb関連技術の標準化を推進する非営利団体です。

Webサービス

インターネット上に分散するアプリケーションが提供するサービスを，クライアントにAPIとして提供するサービス部品です。

WS-R（Web Services Reliability）

標準化団体OASISで標準化された，インターネット向けのオープンな非同期通信プロトコルです。

WSDL（Web Service Description Language）

Webサービスを記述するための言語仕様です。XMLがベースとなっています。

XMLスキーマ

W3C勧告で定められた仕様で，XML文書内の論理的なデータ構造を規定するための仕組みです。

（ア行）

アダプタ

サービスリクエスタからの要求電文を受け取り，アダプタ内で定義されているサービス部品へ要求電文を送信して，サービス部品を呼び出すアプリケーションです。

アダプタには，標準で使用するサービスアダプタ（標準アダプタ）と，ユーザが必要に応じて使用するカスタムアダプタ（DBアダプタ，TP1アダプタなど）があります。サービスアダプタは，Webサービス，SessionBean，MDB（WS-R），およびMDB（DBキュー）のサービス部品を呼び出すアダプタです。カスタムアダプタは，それ以外のサービス部品を呼び出すアダプタです。

受付処理

サービス部品の呼び出し要求を受け付けたり，電文を転送したりする処理を記述したAPIです。ユーザが作成した受付処理をカスタム受付フレームワーク上で動作させることで，任意のプロトコルに対応した受付を開発できます。

運用環境

開発環境で作成したEARファイルをリポジトリから読み込み，実行環境に配備する環境です。また，実行環境で利用するHCSCサーバをセットアップします。実行環境での業務の運用を開始したあとは，システムの起動・停止，および状態を監視します。

永続化

ビジネスプロセスのプロセスインスタンスの実行状況を履歴として，データベースに記録することです。

応答電文

サービス部品の実行結果を返すための電文です。応答電文には，サービス部品からHCSCサーバに送信される電文と，HCSCサーバからサービスリクエスタに送信される電文があります。

（カ行）

開発環境

実行環境でサービス部品を呼び出すために必要なHCSCコンポーネントを作成したり，作成したHCSCコンポーネントをHCSCサーバおよびクラスタにどのように配備するか定義（配備定義）したりする環境です。

カスタムアダプタ

呼び出すサービス部品の種類が，Webサービス，SessionBean，MDB（WS-R），MDB（DBキュー）以外のアダプタです。

カスタム受付

サービスリクエスタからの実行要求を受け付けるための機能（インターフェース）です。ユーザが作成した受付処理をカスタム受付フレームワーク上で動作させることで，任意のプロトコルからの実行要求を受け付けることができます。

カスタム受付フレームワーク

カスタム受付を作成するためにCosminexus サービスプラットフォームで提供している開発用フレームワークです。

共通フォルダ

FTP連携で，複数のビジネスプロセスからアクセスできるファイルを格納するためにHCSCサーバに作成する任意のフォルダです。

クラスタ

ある共通の機能を提供するサーバの集合です。

Cosminexus サービスプラットフォームでは，複数のHCSCサーバでクラスタを構成するロードバランスクラスタと，二つのHCSCサーバで実行系と待機系を構成するHAクラスタがあります。

（サ行）

サービス

業務と一対一に対応し，業務に必要な機能を再利用できるソフトウェア部品のことです。SOAでは，サービスを組み合わせて業務システムを構築します。これによって，業務の変化に対して，システムを迅速に変更できます。

サービスアダプタ

どのサービス部品を実行するかを定義したHCSCコンポーネントです。呼び出すサービス部品の種類（Webサービス，SessionBean，MDB（WS-R），MDB（DBキュー））ごとに定義する内容は異なります。

サービス部品

サービスアダプタおよびDBアダプタから実行できる業務処理のことです。Webサービス，SessionBean，MDB（WS-R），MDB（DBキュー），およびデータベースの操作をサービス部品として利用できます。

サービスリクエスタ

HCSCサーバへサービス部品の実行要求（要求電文）を送信するアプリケーションです。HCSCサーバの標準受付が同期標準受付（Webサービス／SessionBean）か，非同期標準受付（MDB（WS-R）／MDB（DBキュー））か，またはユーザ定義受付（Webサービス）かによって，作成するサービスリクエスタの形式が異なります。

標準受付にサービス部品の実行を要求するサービスリクエスタを作成するときは，HCSCサーバに送信される要求電文の電文フォーマットを，標準電文に合わせる必要があります。

ユーザ定義受付にサービス部品の実行を要求するサービスリクエスタを作成するときは，サービス部品またはビジネスプロセスに定義した電文フォーマット（WSDL）に合わせることができます。

作業フォルダ

FTP連携で，FTPクライアントやFTPサーバなどから受信したファイルを扱うためにHCSCサーバに作成されるフォルダです。

システム構成定義

HCSCサーバおよびクラスタのセットアップ情報と，HCSCコンポーネントをHCSCサーバおよびクラスタにどのように配備するかの情報が含まれる定義情報です。

HCSCサーバおよびクラスタのセットアップ情報は，運用環境で更新されます。開発環境では，HCSCサーバおよびクラスタにHCSCコンポーネントをどのように配備するかの情報を定義します。

実行環境

サービスリクエスタで受け付けた実行要求に応じて，HCSCサーバを介して適切なサービス部品を呼び出し，業務を実行する環境です。

実行履歴

ビジネスプロセスのプロセスインスタンスの実行履歴と電文の実行履歴とがあります。ビジネスプロセスの実行状況や応答状況を確認したり，サービス部品の情報や電文の配送経路や配送状態を確認したりできます。

実行履歴情報テーブル

ビジネスプロセスや電文のプロセスインスタンスおよび電文の実行履歴を管理するテーブルです。

性能解析トレース

Cosminexusシステムの性能解析をするためのトレース情報です。

相関セット

サービスリクエスタから送信された要求電文を一意に識別するために利用する文字列です。HCSCサーバには，サービスリクエスタから相関セットを含む要求電文が送信されます。サービス部品のHCSCサーバは，相関セットを含んだ応答電文をサービスリクエスタに返信します。その結果，サービスリクエスタは受信した応答電文が，どの要求電文に対する応答であるのかを一意に識別できます。

（タ行）

データ変換

標準電文とサービス部品電文の電文フォーマットが異なる場合に，データ変換定義に従って，標準電文をサービス部品電文の電文フォーマットに変換することです。

データ変換定義

標準電文とサービス部品電文の電文フォーマットの相違を解消するためのデータ変換方法を定義したものです。標準電文とサービス部品電文の電文フォーマット定義ファイルの各要素をマッピングし，必要に応じてファンクションを設定して定義します。

電文フォーマット

要求電文および応答電文のデータ構造です。

サービスリクエスタからHCSCサーバに送信される要求電文の電文フォーマットは，標準電文の電文フォーマットに合わせる必要があります。標準電文とサービス部品に実行要求するための電文（サービス部品電文）の電文フォーマットが異なる場合は，データ変換定義を作成して，電文フォーマットの相違を解消します。

電文フォーマット定義ファイル

電文の構造（電文フォーマット）を定義したファイルです。XMLフォーマット定義ファイルとバイナリフォーマット定義ファイルとがあります。サービス部品の実行に利用する電文でXML形式のデータを扱う場合は，XMLフォーマット定義ファイルを，バイナリ形式（XML形式以外）のデータを扱う場合は，バイナリフォーマット定義ファイルを利用します。

（ハ行）

配備

HCSCコンポーネントを適切なHCSCサーバに配置することです。開発環境で作成したHCSCコンポーネントは，運用環境を利用して実行環境（HCSCサーバ）に配備します。

配備定義

開発環境で，HCSCコンポーネントをHCSCサーバおよびクラスタにどのように配備するか定義し，システム構成定義を更新することです。運用環境からHCSCコンポーネントを配備するときには，開発環境で配備定義したシステム構成定義の内容に従って配備します。

パッケージング

開発環境で作成したHCSCコンポーネントを，実行環境に配備できるようにEARファイルに組み立てることです。

ビジネスプロセス

複数のサービス部品の処理の順番や条件などを定義して，一連の業務の流れとして定義したものです。Cosminexus サービスプラットフォームの開発環境では，複数のアクティビティを画面上に配置し，コネクションで連結して定義します。

標準受付

サービスリクエスタからの要求電文を受け付けるための機能（インターフェース）です。HCSCサーバに含まれる機能です。標準受付を開始すると，サービスリクエスタからの要求電文を受け付けられる状態になります。

同期受付（Webサービス／SessionBean）および非同期受付（MDB（WS-R）／MDB（DBキュー））の要求を受け付けることができます。

標準電文（標準電文フォーマット）

Cosminexus サービスプラットフォームで提供する標準的な電文フォーマットです。

ファイルアダプタ

Cosminexus サービスプラットフォームの実行環境からHCSCサーバ上のローカルディスクに対して直接ファイルの入出力をする場合に利用するアダプタです。

ファイル操作アダプタ

ファイルのレイアウト変換，文字コード変換，複製，および削除をするためのアダプタです。

プロセスインスタンス

ビジネスプロセスで実行している業務の一つの実体です。ワークフローの案件に相当します。

（マ行）

メソッドトレース

障害が発生し，原因の究明が困難な場合に必要な情報です。

（ヤ行）

ユーザ定義受付

サービスリクエスタからの実行要求を受け付けるための機能（インターフェース）です。HCSCサーバに含まれる標準受付とは異なり，ユーザが任意のインターフェースを定義できます。定義したユーザ定義受付をHCSCサーバに配備して開始すると，サービスリクエスタからの要求電文を受け付けられる状態になります。

ユーザ電文

サービスリクエスタから送信される要求電文です。

要求電文

サービス部品の実行を要求するための電文です。要求電文には，サービスリクエスタからHCSCサーバに送信される電文とHCSCサーバ内のアダプタからサービス部品に送信される電文があります。

（ラ行）

リクエスト受付

標準受付およびユーザ定義受付の総称です。サービスリクエスタからの実行要求を受け付けるための機能（インターフェース）です。

リクエストトレース

メッセージング基盤での，標準受付，ビジネスプロセス受付，またはサーバ間転送受付で受け付けたリクエストのBPやサービスアダプタの呼び出し先やその結果を把握するための情報です。

リポジトリ

定義したHCSCコンポーネントやシステム構成定義を格納するディレクトリです。格納した情報は，リポジトリの管理機能（リポジトリのインポート／エクスポート機能）を利用して，開発環境と運用環境との間で受け渡します。

索引

[数字]
[Ｃ][Ｄ][Ｅ][Ｆ][Ｈ][Ｉ][Ｊ][Ｌ][Ｍ][Ｏ][Ｐ][Ｒ][Ｓ][Ｔ][Ｕ][Ｗ][Ｘ]
[ア行][カ行][サ行][タ行][ハ行][マ行][ヤ行][ラ行]

(数字)

1台のマシンに複数の運用・実行環境を構築する場合の環境構築

(英字)

(Ｃ)

Cosminexus DABroker Libraryのセットアップおよび環境設定

Cosminexus Manager

Cosminexus Manager〔用語解説〕

Cosminexus Managerにアクセスするユーザの設定

Cosminexus Managerの状態を確認する

Cosminexus Reliable Messagingのセットアップ

Cosminexus Service Coordinator-Managerのセットアップ

Cosminexus Service Coordinator管理者の変更方法

csccmd.properties〔用語解説〕

cscmng.properties〔用語解説〕

CSCMNG_HOME環境変数の設定

cscsetupコマンド定義ファイル

cscsvconfig.properties〔用語解説〕

cscsvsetup.properties〔用語解説〕

cscsvsetup.xml〔用語解説〕

CTM〔用語解説〕

(Ｄ)

DB Connector〔用語解説〕

DB Connectorのインポート

DB Connectorのセットアップ〔Cosminexus RMを使用しない場合〕

DB Connectorのセットアップ〔Cosminexus RMを使用する場合〕

DBアダプタ〔用語解説〕

DBキュー〔用語解説〕

(Ｅ)

EARファイル〔用語解説〕

Eclipse〔用語解説〕

EJB〔用語解説〕

(Ｆ)

FTPアダプタ〔用語解説〕

FTPインバウンドアダプタ〔用語解説〕

FTP受付〔用語解説〕

FTPクライアント〔用語解説〕

FTPサーバ〔用語解説〕

FTP連携〔用語解説〕

(Ｈ)

HAクラスタ構成〔HCSCサーバの構成〕

HAクラスタ構成〔環境構築〕

HAクラスタ構成時の環境構築

HAクラスタ構成時の実行環境のセットアップ

HAクラスタ構成での運用

HAモニタ〔環境構築〕

HCSC〔用語解説〕

HCSC-Business Process〔用語解説〕

HCSC-Data Transform〔用語解説〕

HCSC-DB Adapter〔用語解説〕

HCSC-Manager〔用語解説〕

HCSC-Manager Plug-inの組み込み

HCSC-Managerコマンド共通定義ファイル

HCSC-Managerコマンド共通定義ファイル〔用語解説〕

HCSC-Managerコマンド共通定義ファイルの作成

HCSC-Manager定義ファイル

HCSC-Manager定義ファイル〔用語解説〕

HCSC-Manager定義ファイルの作成

HCSC-Managerにアクセスするユーザの変更

HCSC-Managerのログ

HCSC-Messaging〔用語解説〕

HCSCコンポーネント〔用語解説〕

HCSCコンポーネントの更新

HCSCコンポーネントの構成を変更する

HCSCコンポーネントの削除

HCSCコンポーネントの追加

HCSCサーバ〔用語解説〕

HCSCサーバが使用するリソース

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

HCSCサーバ構成定義ファイル〔用語解説〕

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

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

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

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

HCSCサーバセットアップ定義ファイル〔用語解説〕

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

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

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

HCSCサーバにアクセスするユーザの設定

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

HCSCサーバの構成（単一の場合）

HCSCサーバの構成（複数の場合）

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

HCSCサーバの情報を確認する

HCSCサーバのセットアップ情報を確認する

HCSCサーバの定義情報を設定する

HCSCサーバの定義内容を確認する

HCSCサーバの定義を変更する

HCSCサーバのリソース稼働情報の統計情報

HCSCサーバのリソース稼働情報を確認する

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

HCSCサーバランタイム定義ファイル〔用語解説〕

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

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

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

HCSCサーバをアンセットアップする

HCSCサーバを起動する

HCSCサーバをセットアップする

HCSCサーバを停止する

HCSC本番環境簡易セットアップ機能で構築できる環境

HCSC本番環境簡易セットアップ機能でセットアップした本番環境の運用

HCSC本番環境簡易セットアップ機能の実行

HCSC本番環境簡易セットアップ機能を利用したシステムのセットアップの流れ

HCSC本番環境簡易セットアップで使用する定義ファイル

HiRDB Type4 JDBC Driverのセットアップ

HiRDBサーバの文字コードの設定

Hitachi Web Server定義ファイル

Hitachi Web Serverの状態を確認する

Hitachi Web Serverを起動する

Hitachi Web Serverを使用する方法

Hitachi Web Serverを停止する

HTTP〔用語解説〕

(Ｉ)

iWayアダプタ〔用語解説〕

(Ｊ)

J2EEサーバ〔用語解説〕

J2EEサーバの稼働ログ

J2EEサーバのセットアップ

JAX-WSエンジン〔用語解説〕

JAX-WSエンジンの初期設定

JDBC〔用語解説〕

JDBCドライバのセットアップ

JP1〔用語解説〕

JP1/Baseのイベントサーバ名の設定

JP1/Baseの構成定義の作成

JP1イベント通知をするメッセージ

JP1イベント発行の設定

JP1と連携した障害監視の流れ

JP1連携機能を使用する場合の環境構築

JP1連携の設定

(Ｌ)

LANG

LC_CTYPE

LD_LIBRARY_PATH

LIBPATH

(Ｍ)

Management Server環境設定ファイル

Management Server環境設定ファイル

Management Serverの起動

Management Serverの参照方法

Management Serverの設定

Management Serverのセットアップ

Management Server用オプション定義ファイル

Manager設定ファイル

MBean〔用語解説〕

MBeanの起動確認

Message Queueアダプタ〔用語解説〕

Microsoft Cluster Service

mserver.cfg

mserver.properties

MyEclipse〔用語解説〕

(Ｏ)

Object Accessアダプタ〔用語解説〕

Oracle JDBC Thin Driverのセットアップ

OutOfMemoryError発生時の運用

(Ｐ)

pd_max_users（同時実行可能ユーザ数）の設定

PDLANG

PDTXACANUM

PDXAMODE

PRFの状態を確認する

PRFのセットアップ

PRFを起動する

PRFを停止する

(Ｒ)

RARファイルの選択方法（Cosminexus RMを使用しない場合）

RARファイルの選択方法（DBアダプタを利用する場合）

RDエリアの準備

RMI-IIOP〔用語解説〕

(Ｓ)

SessionBean〔用語解説〕

snapshotログ一次送付対象定義ファイル

snapshotログ二次送付対象定義ファイル

SOAP〔用語解説〕

SOAP1.1/1.2併用モード

SOAP1.1/1.2併用モード〔用語解説〕

SOAP1.1/1.2併用モードを利用する場合の初期設定

SOAP1.1モード

SOAP1.1モード〔用語解説〕

SOAP1.1モードを利用する場合の初期設定

SOAP通信基盤〔用語解説〕

SOAP通信基盤の初期設定

SOAPモードのサポート範囲

SOAPモードの種類

SOAPモードの設定

SQLスクリプトファイル設定時の注意事項

SQLスクリプトファイルの種類と格納先

SQLスクリプトファイルの設定

SQLスクリプトファイルの設定方法

(Ｔ)

TP1/RPC受付〔用語解説〕

TP1アダプタ〔用語解説〕

TP1インバウンドアダプタ〔用語解説〕

TP1インバウンドアダプタのセットアップ

TP1連携システム〔用語解説〕

(Ｕ)

uCosminexus Operator for Service Platformのアンインストール

uCosminexus OperatorおよびuCosminexus Operator for Service Platformのインストール

uCosminexus Operatorのアンインストール

uCosminexus Service Architect〔用語解説〕

uCosminexus Service Platform〔用語解説〕

uCosminexus Service Platformのアンインストール

uCosminexus Service Platformのインストール

uCosminexus 日立コード変換 - Runtimeのセットアップ

uCosminexus 日立コード変換 - Server Runtimeのセットアップ

usrconf.properties

usrconf.properties

(Ｗ)

W3C〔用語解説〕

Webサーバ（HTTPサーバ）のセットアップ

Webサービス〔用語解説〕

WS-R〔用語解説〕

WSDL〔用語解説〕

(Ｘ)

XMLスキーマ〔用語解説〕

(ア行)

(あ)

アダプタ〔用語解説〕

アンインストール

(い)

移行したあとの注意事項

移行の対象となるバージョン

移行の対象となるバージョン

インストールの流れ

インデクスの各種概算式

インプロセスHTTPサーバを使用する方法

インポート時の自動バックアップ

(う)

受付処理〔用語解説〕

上書きインストールして運用環境のリポジトリを移行する手順

上書きインストールする場合の移行手順

運用・実行1対1構成

運用PC設置構成

運用環境〔用語解説〕

運用環境でリポジトリを旧バージョンから移行する方法

運用環境と実行環境が異なるマシンに構築された状態で，運用環境マシンのIPアドレスまたはホスト名を変更する場合

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

運用環境の定義ファイルの状態を確認する

運用環境のバックアップ

運用環境の復旧

運用管理エージェントの起動

運用管理エージェントの参照方法

運用管理エージェントプロパティファイル

運用集約構成

運用方針の決定

(え)

永続化〔電文の実行履歴〕

永続化〔プロセスインスタンスの実行履歴〕

永続化〔用語解説〕

(お)

応答電文〔用語解説〕

(カ行)

(か)

開発環境〔用語解説〕

カスタムアダプタ〔用語解説〕

カスタムアダプタの定義ファイルを運用環境から削除する

カスタムアダプタの定義ファイルを運用環境に取得する

カスタムアダプタの定義ファイルを運用環境に設定，更新する

カスタム受付〔用語解説〕

カスタム受付フレームワーク〔用語解説〕

稼働情報ファイルの出力

簡易構築定義ファイル

簡易セットアップ

環境構築後のIPアドレスを変更する場合の運用

環境構築後のホスト名を変更する場合の運用

環境変数の設定

(き)

基本情報

旧バージョンからの移行

旧バージョンからの移行

共通定義ファイル（SOAP通信基盤）

共通定義ファイルの設定項目（JAX-WSエンジン）

共通定義ファイルの設定項目（SOAP通信基盤）

共通フォルダ〔用語解説〕

共有ロック

共有ロック

(く)

クライアント側共通定義ファイル

クライアント共通設定プロパティファイル

クラスタ〔用語解説〕

クラスタ構成時の運用

クラスタソフトウェアの設定

(こ)

コンテナ拡張ライブラリの設定

コンポーネントインポート

コンポーネント単位でのリポジトリの更新

コンポーネント単位でのリポジトリの削除

コンポーネント単位でのリポジトリの追加

(サ行)

(さ)

サーバ定義ファイル（SOAP通信基盤）

サーバ定義ファイルの設定項目（SOAP通信基盤）

サービス〔用語解説〕

サービスアダプタ〔用語解説〕

サービスアダプタの情報を確認する

サービスアダプタを一括して削除する場合

サービスアダプタを一括して配備する

サービスアダプタを開始する

サービスアダプタを削除する

サービスアダプタを停止する

サービスアダプタを配備する

サービス情報

サービス情報の削除

サービス情報変更定義ファイル

サービス情報を一括して変更する

サービス情報を確認する

サービス情報を個別に変更する

サービス情報を変更する

サービス部品〔用語解説〕

サービス部品の接続先を変更する

サービスリクエスタ〔用語解説〕

作業フォルダ〔用語解説〕

差分展開

(し)

システム構成定義〔用語解説〕

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

システムのセットアップの流れ

実行環境〔用語解説〕

実行環境（実行系）のセットアップ

実行環境（待機系）のセットアップ

実行環境に必要なソフトウェアの設定

実行環境の設定

実行履歴〔用語解説〕

実行履歴情報テーブル〔用語解説〕

実行履歴情報テーブルの管理

実行履歴情報テーブルのバックアップ取得の運用

実行履歴情報テーブルのバックアップを取得する

指定したサービスアダプタだけを削除する

指定したサービスアダプタだけを配備する

指定したビジネスプロセスだけを削除する

指定したビジネスプロセスだけを配備する

指定したユーザ定義受付だけを削除する

指定したユーザ定義受付だけを配備する

障害を調査するときに必要な情報

新規にインストールして運用環境のリポジトリを移行する手順

新規にインストールする場合の移行手順

(す)

スキーマの定義

(せ)

性能解析トレース

性能解析トレース〔用語解説〕

性能解析トレースの絞り込み

性能解析トレースの取得ポイント

性能解析トレースの取得ポイントの表示

性能解析トレースの取得方法

性能解析トレースの表示

性能解析トレースファイルの出力形式と出力される内容

セットアップ後の内容を確認・変更する

セットアップした情報の変更〔HCSC本番環境簡易セットアップ機能を利用した場合〕

セットアップ情報の追加・変更

全体展開

(そ)

相関セット〔用語解説〕

(タ行)

(つ)

通信タイムアウト値を変更する

(て)

ディレクトリ構成

データベース稼働マシンのIPアドレスを変更する場合

データベース稼働マシンのホスト名を変更する場合

データベースのクライアント側のセットアップ

データベースのサーバ側のセットアップ

データベースの状態を確認する

データベースのセットアップ

データベースのテーブルの情報

データベースのテーブル容量の見積もり

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

データベースの領域への配置

データベースの領域への配置

データベースを起動する

データベースを停止する

データ変換〔用語解説〕

データ変換基盤〔用語解説〕

データ変換定義〔用語解説〕

データ変換で使用するjarファイルを格納する

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

テーブル容量の見積もり〔実行環境の設定〕

テーブル容量の見積もり〔電文の実行履歴の管理〕

テーブル容量の見積もり〔プロセスインスタンスの実行履歴の管理〕

テスト環境から本番環境への移行手順

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

電文の実行履歴採取のタイミング

電文の実行履歴の概要

電文の実行履歴の管理

電文の実行履歴を削除する

電文の実行履歴を表示する

電文フォーマット〔用語解説〕

電文フォーマット定義ファイル〔用語解説〕

(と)

統計情報の参照方法

統合メッセージログ

トレースファイルの見積もり

(ハ行)

(は)

バージョンアップ時のインポート

排他ロック

排他ロック

配備〔用語解説〕

配備定義〔用語解説〕

バックアップ

パッケージング〔用語解説〕

(ひ)

ビジネスプロセス〔用語解説〕

ビジネスプロセス基盤〔用語解説〕

ビジネスプロセスの情報を確認する

ビジネスプロセスを一括して削除する

ビジネスプロセスを一括して配備する

ビジネスプロセスを開始する

ビジネスプロセスを削除する

ビジネスプロセスを停止する

ビジネスプロセスを配備する

標準インポート

標準受付〔用語解説〕

標準受付（同期受付（Webサービス））および標準受付（非同期受付（MDB（WS-R））のWebサーバのIPアドレスまたはホスト名を変更する場合

標準受付を開始する

標準受付を停止する

標準電文〔用語解説〕

標準電文フォーマット〔用語解説〕

(ふ)

ファイルアダプタ〔用語解説〕

ファイル操作アダプタ〔用語解説〕

プロセスインスタンス〔用語解説〕

プロセスインスタンスの実行履歴の管理

プロセスインスタンスの実行履歴の詳細情報を取得する

プロセスインスタンスの実行履歴を検索する

プロセスインスタンスの実行履歴を削除する

プロセスインスタンスを再実行する

(へ)

変換テーブルの登録

変換テーブルの登録

変換テーブルを登録する

(ほ)

保守情報の取得方法

本番環境のアンセットアップ

本番環境の起動と停止

本番環境のセットアップ

(マ行)

(め)

メソッドトレース〔障害対策〕

メソッドトレース〔障害対策〕

メソッドトレース〔用語解説〕

メッセージトラッキング

メッセージトラッキング機能の適用例

メッセージトラッキングの起動

メッセージトラッキングプロンプト

メッセージマッピングファイルの編集

メッセージログ

メッセージログ

メッセージング基盤〔用語解説〕

メンテナンスログ〔障害情報の取得〕

メンテナンスログ〔障害情報の種類〕

(ヤ行)

(ゆ)

ユーザ情報の設定

ユーザ定義受付〔用語解説〕

ユーザ定義受付の情報を確認する

ユーザ定義受付の定義情報を確認する

ユーザ定義受付の定義情報を設定する

ユーザ定義受付の定義情報を変更する

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

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

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

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

ユーザ定義受付を一括して削除する

ユーザ定義受付を一括して配備する

ユーザ定義受付を開始する

ユーザ定義受付を削除する

ユーザ定義受付を停止する

ユーザ定義受付を配備する

ユーザ電文〔用語解説〕

ユーザ電文トレース〔障害対策〕

ユーザ電文トレースの取得ポイント

ユーザ電文トレースの取得方法

ユーザ電文トレースの取得方法

(よ)

要求電文〔用語解説〕

(ラ行)

(り)

リクエスト受付〔用語解説〕

リクエストトレース〔障害対策〕

リクエストトレース〔用語解説〕

リクエストトレースの取得ポイント

リクエストトレースの取得方法

リクエストトレースの取得方法

リソースに対応する情報

リソースの稼働情報の種類

リポジトリ〔用語解説〕

リポジトリとして使用するディレクトリ

リポジトリのインポート

リポジトリのエクスポート

リポジトリの概要

リポジトリの差分情報の参照

リポジトリの情報

リポジトリの情報の参照

リポジトリの排他

リポジトリへのアクセスの制御

流量制御値を変更する

(る)

ルートアプリケーション情報の一覧表示

(れ)

例外発生時に取得するエラーの選択

例外ログ〔障害情報の取得〕

例外ログ〔障害情報の種類〕

(ろ)

ロードバランサの設定

ロードバランスクラスタ機能

ロードバランスクラスタ構成〔HCSCサーバの構成〕

ロードバランスクラスタ構成〔環境構築〕

ロードバランスクラスタ構成時の環境構築

ロードバランスクラスタ構成時の実行環境のセットアップ

ロードバランスクラスタ構成での運用

ロードバランスクラスタ構成でのサービスアダプタの変更

ロードバランスクラスタ構成でのビジネスプロセスの変更

ロードバランスクラスタへのHCSCサーバの追加・削除

ロードバランスクラスタへのサービスアダプタの追加・削除

ロードバランスクラスタへのビジネスプロセスの追加・削除

ローリングアップデート

ローリングアップデート

ローリングアップデートで運用環境のレポジトリを移行する手順

ローリングアップデートの場合の移行手順

ログアウトする

ログイン時の注意事項

ログインする

ログおよびトレース取得時の注意事項

論理サーバの登録

■ 商標類

AIXは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
AIX 5Lは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
AMDは，Advanced Micro Devices, Inc.の商標です。
Borlandのブランド名および製品名はすべて，米国Borland Software Corporationの米国およびその他の国における商標または登録商標です。
CORBAは，Object Management Groupが提唱する分散処理環境アーキテクチャの名称です。
HP-UXは，Hewlett-Packard Companyのオペレーティングシステムの名称です。
IIOPは，OMG仕様によるORB(Object Request Broker)間通信のネットワークプロトコルの名称です。
Itaniumは，アメリカ合衆国およびその他の国におけるIntel Corporationの商標です。
iWayおよびiWay Softwareは，Information Builders, Inc.の米国およびその他の国における登録商標です。
J2EEは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Javaは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
JDBCは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
JDKは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Linuxは，Linus Torvalds氏の日本およびその他の国における登録商標または商標です。
Microsoftは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Microsoft Office Excelは，米国 Microsoft Corporation の商品名称です。
MyEclipseは，米国Genuitec社の商品名称です。
ORACLEは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Oracle及びOracle 10gは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Oracle及びOracle9iは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Oracle及びOracle Database 11gは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Red Hatは，米国およびその他の国でRed Hat, Inc. の登録商標もしくは商標です。
SOAP（Simple Object Access Protocol）は，分散ネットワーク環境においてXMLベースの情報を交換するための通信プロトコルの名称です。
UNIXは，The Open Groupの米国ならびに他の国における登録商標です。
W3Cは，World Wide Web Consortiumの商標（多数の国において登録された）です。
WebSphereは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
Windowsは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Serverは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Vistaは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Eclipseは，開発ツールプロバイダのオープンコミュニティであるEclipse Foundation, Inc.により構築された開発ツール統合のためのオープンプラットフォームです。
This product includes software developed by the Apache Software Foundation (http://www.apache.org/).