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

サービスプラットフォーム TP1アダプタ　ユーザーズガイド

解説・操作書

3020-3-U58

目　　次

前書き

はじめに

1.　概要

1.1　目的

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

1.3　構成

1.3.1　開発環境の構成

1.3.2　実行環境の構成

1.3.3　ネットワーク構成

2.　機能

2.1　RPC通信

2.1.1　RPCのサービス要求方式

2.1.2　RPCの通信形態

2.1.3　RPCの送受信バッファの生成

2.2　時間監視

2.3　障害情報の通知

2.3.1　HCSCサーバに通知する情報

2.3.2　ビジネスプロセスを利用したエラー情報の参照

2.4　ログ取得

3.　設定

3.1　設定前の準備

3.2　設定手順

3.3　TP1アダプタの環境定義ファイルの作成

3.3.1　ファイルの作成方法

3.3.2　定義の詳細

3.4　TP1アダプタの通信構成定義ファイルの作成

3.4.1　ファイルの作成方法

3.4.2　定義の詳細

3.5　TP1アダプタの追加・定義

3.6　データ変換（マッピング）の定義

3.7　TP1アダプタの設定項目の反映

3.8　実行環境プロパティファイルの作成

3.9　TP1/Client/J環境定義の設定

3.9.1　リモートAPI機能を使用する場合

3.9.2　ネームサービス機能を使用する場合

3.9.3　スケジューラダイレクト機能を使用する場合

3.9.4　通信先を指定した接続をする場合

3.10　J2EEサーバ用オプション定義ファイルの編集

4.　運用

4.1　TP1アダプタの開始と停止

5.　メッセージ

5.1　メッセージの種類と形式

5.1.1　メッセージの種類

5.1.2　メッセージの形式

5.2　メッセージ一覧

6.　トラブルシューティング

6.1　TP1アダプタでの障害情報

6.2　障害対策

6.2.1　TP1/Client/Jのトレース情報の採取

6.2.2　タイマ設定値の妥当性

付録

付録A　TP1/Client/Jの例外に対するfactor要素の対応表

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

付録B.1　インストール

付録B.2　移行方法

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

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

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

付録C.3　このマニュアルで使用している略語

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

付録D　用語解説

索引

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

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

前書き

■ 対象製品

●適用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-CT14　 uCosminexus Service Adapter for TP1　 01-20

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

P-2443-CU14　 uCosminexus Service Adapter Architect for TP1　 01-20

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

■ 輸出時の注意

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

■ 商標類

AIXは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
AIX 5Lは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
AMDは，Advanced Micro Devices, Inc.の商標です。
HP-UXは，Hewlett-Packard Companyのオペレーティングシステムの名称です。
iWayおよびiWay Softwareは，Information Builders, Inc.の米国およびその他の国における登録商標です。
Javaは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
JDKは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Linuxは，Linus Torvalds氏の日本およびその他の国における登録商標または商標です。
Microsoftは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
MyEclipseは，米国Genuitec社の商品名称です。
OMG，CORBA，IIOP，UML，Unified Modeling Language，MDA，Model Driven Architectureは，Object Management Group, Inc.の米国及びその他の国における登録商標または商標です。
Red Hatは，米国およびその他の国でRed Hat, Inc. の登録商標もしくは商標です。
SOAP（Simple Object Access Protocol）は，分散ネットワーク環境においてXMLベースの情報を交換するための通信プロトコルの名称です。
UNIXは，The Open Groupの米国ならびに他の国における登録商標です。
W3Cは，World Wide Web Consortiumの商標（多数の国において登録された）です。
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/).

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

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

表記 | 製品名
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-U58

■ 著作権

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

はじめに

このマニュアルは，Cosminexus サービスプラットフォーム　TP1アダプタの機能，アダプタの作成および運用について説明しています。TP1アダプタとは，Cosminexus サービスプラットフォーム（uCosminexus Service ArchitectおよびuCosminexus Service Platform）を適用したシステムで，OpenTP1システムまたはメインフレーム上のシステムへの接続を行うアダプタ製品です。

TP1アダプタでは，次に示すプログラムプロダクトを使用してシステムを開発，運用します。

uCosminexus Service Adapter for TP1

uCosminexus Service Adapter Architect for TP1

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

対象読者

Cosminexus サービスプラットフォーム　TP1アダプタを利用して，OpenTP1またはメインフレーム上で動作する業務処理をSOAでのサービスとして扱うシステムを構築するシステム開発者，およびそのシステムの運用管理者を対象としています。

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

SOAに関する基本的な知識

J2EEに関する基本的な知識

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

OpenTP1に関する基本的な知識

XMLに関する基本的な知識

また，次の内容を理解していることが必要です。

Cosminexusが提供する機能を利用して，SOAに対応したサービス統合環境（サービスプラットフォーム）を開発・運用する方法

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

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

パスの表記について

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

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

注意

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

参考

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

このマニュアルの画面や操作の説明で使用している記号

記　号 | 意　味
［　］ | ダイアログ名，メニュー項目名，およびボタン名に表示されている項目名に使用します。

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

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

記　号
意　味

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

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

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

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

…
記述が省略されていることを示します。
（例）　ABC…　ABCの後ろに記述があり，その記述が省略されていることを示します。

～

環境定義および通信構成定義の場合

この記号の前に示された要素の値が，記号～に続く＜　＞，((　))，<<　>>などの規則に従うことを示します。

実行環境プロパティの場合

この記号の前に示された項目が，記号～に続く＜　＞，((　))，<<　>>などの規則に従うことを示します。

＜　＞
項目を記述するときに従わなければならない構文要素を示します。構文要素については，「このマニュアルで使用している構文要素」を参照してください。

((　))
項目で指定できる値の範囲を示します。

<<　>>
項目を省略したときに，システムが仮定する標準値を示します。

このマニュアルで使用している構文要素

このマニュアルで使用している構文要素の種類と意味を次に示します。

種　類 | 定　義
＜英字＞ | A～Z　a～z
＜数字＞ | 0～9
＜英数字＞ | A～Z　a～z　0～9
＜記号＞ | !　"　#　$　%　&　'　(　)　+　,　_　・　.　/　:　;　<　=　>　@　[　]　^　－　｛　｝　?　タブ　空白
＜文字列＞ | 任意の文字の配列
＜識別子＞ | 先頭が英字の英数字の文字列

1.　概要

この章では，TP1アダプタの目的および機能の概要，開発から実運用までの流れ，ならびにTP1アダプタを利用するシステムの構成について説明します。

＜この章の構成＞

1.1　目的

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

1.3　構成

1.1　目的

TP1アダプタはOpenTP1またはメインフレーム（TMS-4V，DCCM3など）上で動作する既存のシステムを，Cosminexus サービスプラットフォーム上のサービスとして呼び出すためのカスタムアダプタです。

参考

アダプタとは，Cosminexus サービスプラットフォームから，各種のソフトウェア部品をサービスとして呼び出すためのインターフェースとなるコンポーネントです。

アダプタには，WebサービスなどのCosminexus サービスプラットフォーム標準で提供されるサービスアダプタと，TP1アダプタのようにオプションとして提供されるカスタムアダプタがあります。

TP1アダプタを使用したシステムの運用例を次の図に示します。

図1-1　TP1アダプタの運用例

図内の各処理について説明します。

サービスリクエスタからの要求によって，ビジネスプロセスが起動されます。

ビジネスプロセスからTP1アダプタを介して，OpenTP1上で動作する受注管理システムおよびメインフレーム上で動作する在庫管理システムがサービスとして呼び出されます。

サービスの呼び出し結果がサービスリクエスタに送信されます。

これによって，OpenTP1，メインフレームなどの既存システムのアプリケーションをCosminexus サービスプラットフォームのサービスとして実行できます。

Cosminexus サービスプラットフォーム環境で，TP1アダプタを使用する場合のシステムの構成例を次の図に示します。

図1-2　TP1アダプタを使用したシステムの構成例

OpenTP1の概要については，マニュアル「OpenTP1 Version 7 分散トランザクション処理機能　OpenTP1　解説」を参照してください。また，TMS-4V/SP/Serverについては，マニュアル「TMS-4V/SP/Server」を参照してください。

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

TP1アダプタは，Cosminexus サービスプラットフォームの開発環境で設定を行い，HCSCコンポーネントとして実行環境に配備することで利用できます。

TP1アダプタを利用するシステムの開発から実運用までの流れを次の図に示します。

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

注※

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

図中でTP1アダプタに特有の作業は，次のとおりです。

開発環境の構築

TP1アダプタを設定するために必要な環境を構築します。詳細は，「3.1　設定前の準備」およびマニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「2.　システムを開発する前に」を参照してください。

HCSCコンポーネントの作成

TP1アダプタは，HCSCコンポーネントであるサービスアダプタの一つとして作成します。詳細は，「3.　設定」を参照してください。

このマニュアルでは，TP1アダプタに特有の作業について説明します。アダプタ共通の作業については，次のマニュアルを参照してください。

マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」

マニュアル「Cosminexus サービスプラットフォーム システム構築・運用ガイド」

1.3　構成

TP1アダプタは，開発環境および実行環境に構築します。開発環境には「uCosminexus Service Adapter Architect for TP1」を，実行環境には「uCosminexus Service Adapter for TP1」をインストールして構築します。

ここでは，TP1アダプタの各環境について説明します。

なお，開発環境，運用環境および実行環境の関係については，マニュアル「Cosminexus サービスプラットフォーム 概説」の「5.2.1　ソフトウェア製品と各環境の関係」を参照してください。

＜この節の構成＞

1.3.1　開発環境の構成

1.3.2　実行環境の構成

1.3.3　ネットワーク構成

1.3.1　開発環境の構成

TP1アダプタの開発環境の構成を次の図に示します。

図1-4　開発環境の構成

開発環境を構成する項目について説明します。

uCosminexus Service Architect

SOAを適用したシステムに必要なサービスを呼び出すための定義，ビジネスプロセス，データ変換の定義などを開発するための製品です。uCosminexus Service Architectで開発した内容は，uCosminexus Service Platformを利用してセットアップします。

uCosminexus 日立コード変換 - Development Kit

Cosminexus サービスプラットフォームの開発環境で，文字コードを変換するためのマッピングファイルを作成する場合に利用します。XML形式以外のバイナリ形式のデータを扱うとき，またはデータ変換で値置換えファンクションを使用するときに必要です。

uCosminexus Service Adapter Architect for TP1

Cosminexus サービスプラットフォームの開発環境で，既存のOpenTP1やDCCM3システム内にあるサービスを呼び出すためのカスタムアダプタを作成する製品です。

1.3.2　実行環境の構成

TP1アダプタの実行環境の構成を次の図に示します。

図1-5　実行環境の構成

実行環境を構成する項目について説明します。

uCosminexus Service Platform

SOAを適用したシステムを運用するための製品です。また，uCosminexus Service Architectで開発した内容をセットアップしたり，開発で必要なシステム情報をuCosminexus Service Architect側に受け渡したりします。

uCosminexus 日立コード変換 - Server Runtime

Cosminexus サービスプラットフォームの実行環境で，文字コードを変換する場合に利用します。Windowsの場合で，XML形式以外のバイナリ形式のデータを扱うとき，またはデータ変換で値置換えファンクションを使用するときに必要です。

uCosminexus 日立コード変換 - Runtime

Cosminexus サービスプラットフォームの実行環境で，文字コードを変換する場合に利用します。UNIXの場合で，XML形式以外のバイナリ形式のデータを扱うとき，またはデータ変換で値置換えファンクションを使用するときに必要です。

uCosminexus TP1/Client/J

RPCを使用して，接続先システムのサービスを呼び出すための製品です。

uCosminexus Service Adapter for TP1

Cosminexus サービスプラットフォームの実行環境から既存のOpenTP1やDCCM3システム内にあるサービスを呼び出すためのカスタムアダプタです。

複数の接続先システムのサービスを呼び出す場合，一つのサービスグループに一つのTP1アダプタを配備して運用します。複数の接続先システムのサービスを呼び出す場合のアダプタ構成例を次の図に示します。

図1-6　複数の接続先システムのサービスを呼び出す場合のアダプタ構成例

1.3.3　ネットワーク構成

ネットワーク構成上でのTP1アダプタの位置づけを次の図に示します。

図1-7　アダプタ構成例

図のようにTP1アダプタは，uCosminexus Service Architectが稼働しているマシンで開発し，uCosminexus Service Platformが稼働しているマシン上に配置します。

2.　機能

この章では，TP1アダプタの機能について説明します。

＜この章の構成＞

2.1　RPC通信

2.2　時間監視

2.3　障害情報の通知

2.4　ログ取得

2.1　RPC通信

TP1アダプタは，RPC通信を使用して，Cosminexus サービスプラットフォームからOpenTP1のシステムを利用できます。

＜この節の構成＞

2.1.1　RPCのサービス要求方式

2.1.2　RPCの通信形態

2.1.3　RPCの送受信バッファの生成

2.1.1　RPCのサービス要求方式

TP1アダプタのRPC通信では，接続先システムによって，サポートするサービス要求方式が次のとおり異なります。

接続先システムがTP1/Server Baseの場合※1

リモートAPI機能

ネームサービス機能

スケジューラダイレクト機能

通信先を指定した接続

接続先システムがOpenTP1とRPC通信できるメインフレームシステム（TMS-4V，DCCM3など）の場合※2

リモートAPI機能

注※1

TP1/Server Baseとの接続では，TP1/Client/J環境定義でネームサービス機能およびスケジューラダイレクト機能を選択します。

注※2

メインフレームシステム（TMS-4V，DCCM3など）との接続では，端末識別子情報を付加した通信はできません。

なお，リモートAPI機能，ネームサービス機能，およびスケジューラダイレクト機能の詳細は，マニュアル「OpenTP1 Version 7 分散トランザクション処理機能　OpenTP1　クライアント使用の手引　TP1/Client/J編」を参照してください。

＜この項の構成＞

(1)　リモートAPI機能

(2)　ネームサービス機能

(3)　スケジューラダイレクト機能

(4)　通信先を指定した接続

(1)　リモートAPI機能

TP1アダプタと接続先システムの間にコネクションを確立します。そのあと，TP1アダプタが発行したAPIを接続先システムに転送して，接続先システム側のプロセスで実行できます。ただし，接続先システムがリモートAPI接続に対応している必要があります。

TP1アダプタでは，TP1アダプタの通信構成定義によって，次の設定ができます。

コネクションの確立方式の指定
確立するコネクションを次に示すどちらかから指定できます。

常設コネクション

非常設コネクション

コネクションの管理方式の指定
コネクションの管理方式を次に示すどちらかから指定できます。

オートコネクトモード

非オートコネクトモード

確立するコネクションによって，指定できる管理方式は次のとおり異なります。

常設コネクションを確立する場合
コネクションの確立を自動化するオートコネクトモード，または明示的に確立要求を行う非オートコネクトモードのどちらかから指定できます。
オートコネクトモードを指定した場合の処理の概要を図2-1，非オートコネクトモードを指定した場合の処理の概要を図2-2に示します。

非常設コネクションを確立する場合
コネクションの管理方式は指定できません。コネクションは，非オートコネクトモードで確立されます。
非常設コネクションを確立した場合の処理の概要を図2-3に示します。

なお，TP1アダプタの通信構成定義の詳細は，「3.4　TP1アダプタの通信構成定義ファイルの作成」を参照してください。

図2-1　常設コネクションを確立した場合の処理概要（オートコネクトモード）

サービスリクエスタからの要求をHCSCサーバで受け付ける。

HCSCサーバでTP1アダプタのメソッドを起動する。

TP1アダプタで最初のサービス実行時に常設コネクションを確立する。

RPC通信を行い，サービスを実行する。

RPC通信の結果（応答データ）をサービスリクエスタに応答する。

TP1アダプタの停止時に常設コネクションを解放する。

図2-2　常設コネクションを確立した場合の処理概要（非オートコネクトモード）

TP1アダプタを開始したときに，常設コネクションを確立する。

サービスリクエスタからの要求をHCSCサーバで受け付ける。

HCSCサーバでTP1アダプタのメソッドを起動する。

RPC通信を行い，サービスを実行する。

RPC通信の結果（応答データ）をサービスリクエスタに応答する。

TP1アダプタの停止時に常設コネクションを解放する。

図2-3　非常設コネクションを確立した場合の処理の概要（非オートコネクトモード）

サービスリクエスタからの要求をHCSCサーバで受け付ける。

HCSCサーバでTP1アダプタのメソッドを起動する。

接続先システム（RAPリスナー）にコネクションの確立要求を行う

RPC通信を行い，サービスを実行する。

確立したコネクションの解放要求を行う。

RPC通信の結果（応答データ）をサービスリクエスタに応答する。

コネクションの管理方式にオートコネクトモードを指定した場合，リモートAPI接続時のコネクション確立は，サービス要求を受け付けたときのRPC通信に先だって行われます。したがって，オートコネクトモードを指定した通信環境では，TP1アダプタ運用中に多数のサービス要求を一時期に受け付けた場合，サービス要求を受け付けた数だけコネクション確立処理を行います。

複数のコネクションが確立された場合の処理の概要を次の図に示します。

図2-4　複数のコネクションが確立された場合の処理の概要（オートコネクトモード）

(2)　ネームサービス機能

TP1アダプタは，接続先のOpenTP1システムに対して，サービス要求時にサービスグループ名およびサービス名を指定した上でサーバUAPにサービスを要求します。ネームサービスでサーバUAPがあるノードのネットワークアドレスとサービス名を管理しているため，ネットワーク上のどのノードにサーバUAPがあるかをTP1アダプタで意識する必要がありません。

ネームサービス機能を使用した場合の処理の概要を次の図に示します。

図2-5　ネームサービス機能を使用した場合の処理の概要

サービスリクエスタからの要求をHCSCサーバで受け付ける。

HCSCサーバでTP1アダプタのメソッドを起動する。

ネームサービスにサービスの所在を問い合わせる。

RPC通信を行い，サービスを実行する。

RPC通信の結果（応答データ）をサービスリクエスタに応答する。

(3)　スケジューラダイレクト機能

接続先OpenTP1システムのスケジューラデーモンを直接指定してサービスを要求します。

スケジューラダイレクト機能を使用した場合の処理の概要を次の図に示します。

図2-6　スケジューラダイレクト機能を使用した場合の処理の概要

サービスリクエスタからの要求をHCSCサーバで受け付ける。

HCSCサーバでTP1アダプタのメソッドを起動する。

RPC通信を行い，サービスを実行する。

RPC通信の結果（応答データ）をサービスリクエスタに応答する。

(4)　通信先を指定した接続

接続先OpenTP1システムのスケジューラデーモンを直接指定してサービスを要求します。スケジューラダイレクト機能との違いは，通信先のスケジューラデーモンが持つノードのSPPに異常が発生した場合も，ほかのスケジューラデーモンに転送しないという点です。

接続先OpenTP1システムのスケジューラデーモンを指定した場合の接続処理の概要を次の図に示します。

図2-7　通信先を指定した場合の接続処理の概要

サービスリクエスタからの要求をHCSCサーバで受け付ける。

HCSCサーバでTP1アダプタのメソッドを起動する。

通信先を指定したRPC通信を行い，サービスを実行する。

RPC通信の結果（応答データ）をサービスリクエスタに応答する。

2.1.2　RPCの通信形態

TP1アダプタでは，RPCの通信形態として次の通信形態をサポートします。

同期応答型RPC通信

非応答型RPC通信

RPCの通信形態は，TP1アダプタの設定でオペレーション情報の通信モデルで選択します。詳細は，「3.5　TP1アダプタの追加・定義」を参照してください。

＜この項の構成＞

(1)　同期応答型RPC通信

(2)　非応答型RPC通信

(1)　同期応答型RPC通信

TP1アダプタから接続先システムに問い合わせデータを送信して，問い合わせた応答データを受け取る通信形態です。TP1アダプタ側では，接続先システムからの応答を受け取るまでメソッドを終了しません。

同期応答型RPC通信をする場合の処理の概要を次の図に示します。

図2-8　同期応答型RPC通信をする場合の処理の概要

(2)　非応答型RPC通信

TP1アダプタから接続先システムに一方送信データを送信して，応答は受け取らない通信形態です。TP1アダプタ側では，データの送信が完了するとメソッドは終了します。

非応答型RPC通信をする場合の処理の概要を次の図に示します。

図2-9　非応答型RPC通信をする場合の処理の概要

2.1.3　RPCの送受信バッファの生成

TP1サービスプログラムとのRPC通信で使用する送信バッファと受信バッファは，TP1アダプタ起動時のインスタンス初期化処理で生成・保持することによって，運用中のバッファのメモリ確保失敗のリスクを排除しています。しかし，この送受信バッファはインスタンスごとに生成・保持されるため，TP1アダプタ起動時にバッファサイズ分のメモリ量が必要となります。

このため，多くのTP1アダプタを起動したり，バッファサイズの大きいTP1アダプタのインスタンスを複数生成したりすると，メモリ不足が原因でTP1アダプタを起動できないことがあります。

この場合，送受信バッファの生成方法をTP1アダプタ起動時のインスタンス初期化処理での生成・保持から，RPC通信処理時に動的に生成・解放する処理に変更するオプションを使用することで，TP1アダプタ起動時のメモリ不足を解消できます。

RPC通信処理時に動的に生成・解放するオプションの概要を次の図に示します。

図2-10　RPC通信処理時に動的に生成・解放するオプションの概要

RPC通信時に動的に送受信バッファを生成・解放するには，TP1アダプタの実行環境プロパティファイルのbuffer.keepプロパティで送受信バッファの生成オプションの定義を追加する必要があります。定義方法については「3.8　実行環境プロパティファイルの作成」を参照してください。

注意

RPC通信時に送受信バッファを生成する設定にした場合は，動的に生成される送受信バッファ分のメモリ量を考慮してメモリのリソース設計をするようにしてください。送受信バッファに必要なメモリ量の目安を次に示します。

送受信バッファサイズ（単位：バイト）＝同時に処理できるRPC要求の最大数※1×（送信バッファサイズ※2＋受信バッファサイズ※3）

注※1　通信構成定義ファイルの<con_pool_num>タグの値を示します。

注※2　通信構成定義ファイルの<send_buff_size>タグの値を示します。

注※3　通信構成定義ファイルの<recv_buff_size>タグの値を示します。

RPC通信時に送受信バッファの生成をする設定の有無によって，TP1アダプタの最大メモリ所要量が変わることはありません。また，複数のTP1アダプタを使用する場合は，各送受信バッファサイズを総和したメモリ量が，全体のバッファサイズとして必要になります。

2.2　時間監視

TP1アダプタから接続先システムへ問い合わせを送信してから，応答を受信するまでの経過時間を監視します。経過時間を監視することで，接続先システム上のアプリケーションがループ，停止，または回線障害になった場合に，サービスリクエスタが無限待ちになることを防止します。

TP1アダプタで適用する監視時間の値は，通信処理の状況や接続形態によって異なります。通信処理が開始中または停止中の場合と運用中の場合に分けて説明します。

指定した監視時間内に接続先システムからの応答がない場合，TP1アダプタからHCSCサーバへエラー情報または例外を通知します。

＜この節の構成＞

(1)　通信処理が開始中および停止中の場合

(2)　通信処理が運用中の場合

(1)　通信処理が開始中および停止中の場合

TP1/Client/J環境定義ファイルで指定する最大応答待ち時間の値（dcwatchtimオペランドの指定値）を監視時間の値として適用します。通信処理の状況によって，監視時間の値は，次の表に示すとおりに適用されます。

表2-1　通信処理の開始中および停止中に監視時間として適用される値

通信処理 | 接続形態
通信状況 | コネクション状況 | リモートAPI接続 | 通常RPC接続
常設コネクション | 非常設コネクション
オートコネクト | 非オートコネクト
開始中 | コネクション確立 | － | － | － | －
コネクション解放 | － | ○※ | － | －
停止中 | コネクション解放 | ○ | ○ | － | －

（凡例）

○：時間監視できます。

－：時間監視できません。

注※

通信障害が発生した場合に適用されます。

(2)　通信処理が運用中の場合

TP1アダプタの通信構成定義ファイルで指定したサービス要求のオペレーションに対する時間監視値（watch_time要素で指定）を監視時間の値として適用します。通信処理の状況によって，監視時間の値は，次の表に示すとおりに適用されます。

表2-2　通信処理の運用中に監視時間に適用される値

通信処理 | 接続形態
通信状況 | コネクション状況 | リモートAPI接続 | 通常RPC接続
常設コネクション | 非常設コネクション
オートコネクト | 非オートコネクト
運用中 | コネクション確立 | － | － | － | －
RPC通信 | ○ | ○ | ○ | ○
コネクション解放 | ○※ | ○※ | ○ | －

（凡例）

○：時間監視できます。

－：時間監視できません。

注※

通信障害が発生した場合に適用されます。

2.3　障害情報の通知

ここでは，RPCの通信形態による障害情報の通知について説明します。

＜この節の構成＞

2.3.1　HCSCサーバに通知する情報

2.3.2　ビジネスプロセスを利用したエラー情報の参照

2.3.1　HCSCサーバに通知する情報

サービスリクエスタからTP1アダプタへの要求中にTP1アダプタで障害が発生した場合，RPCの通信形態によってTP1アダプタのエラー情報，または例外をHCSCサーバへ通知します。

表2-3　通信形態による障害情報の通知

RPCの通信形態 | HCSCサーバへ通知する情報
同期応答型 | エラー情報※
非応答型 | 例外

注※

system例外などの予期しない障害が発生した場合，例外を通知します。

エラー情報の詳細は，「6.1　TP1アダプタでの障害情報」を参照してください。

障害が発生した場合に，サービスリクエスタで発生する事象についての詳細は，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「10.　サービスリクエスタの作成」を参照してください。

2.3.2　ビジネスプロセスを利用したエラー情報の参照

TP1アダプタで発生した障害情報（エラー情報）をビジネスプロセスで使用しているTP1アダプタから通知された場合は，faultDetail要素のXMLドキュメントをビジネスプロセス定義から参照できます。

faultDetail要素のXMLドキュメントに，障害発生時のエラーメッセージのIDおよびメッセージ本文を格納する要素を追加することで，ビジネスプロセス上でメッセージごとのエラー処理を定義できるようにします。

faultDetail要素での要素の追加については，「6.1　TP1アダプタでの障害情報」を参照してください。

faultDetail要素のXMLドキュメントに，障害発生時のエラーメッセージのIDおよびメッセージ本文を格納する要素を追加する場合の概要を次の図に示します。

図2-11　faultDetail要素に障害発生時のエラーメッセージのIDおよびメッセージ本文を格納する要素を追加する場合の概要

なお，ビジネスプロセスを利用してエラー情報を参照する場合，TP1アダプタの環境定義ファイルに拡張オプションを指定する必要があります。詳細については，「3.3.2　定義の詳細」を参照してください。

エラー情報（フォルトメッセージ）による判別方法

エラーの発生原因は，エラー情報に含まれているmessageId要素とfactor要素の値の組み合わせによって判別できます。

messageId要素およびfactor要素の値の組み合わせと，エラーの発生原因の対応を次の表に示します。

表2-4　messageId要素およびfactor要素の値の組み合わせとエラーの発生原因の対応

messageId要素 | factor要素 | 発生原因（TP1/Client/Jのメソッド）
KDEE11007-E | other | openConnectionメソッドで例外が発生
KDEE11025-E | other | rpcCallメソッドで例外が発生
KDEE11015-E | internal | openConnectionメソッドで例外が発生
other | rpcCallメソッドで例外が発生

2.4　ログ取得

TP1アダプタのインフォメーション情報や障害時のエラー情報をCosminexusのJ2EEサーバの稼働ログに取得することで，障害の発生を検知したり，障害要因を解析したりできます。

CosminexusのJ2EEサーバの稼働ログについての詳細は，マニュアル「Cosminexus サービスプラットフォーム システム構築・運用ガイド」の「7.　障害対策」を参照してください。

3.　設定

この章では，TP1アダプタの設定方法について説明します。

＜この章の構成＞

3.1　設定前の準備

3.2　設定手順

3.3　TP1アダプタの環境定義ファイルの作成

3.4　TP1アダプタの通信構成定義ファイルの作成

3.5　TP1アダプタの追加・定義

3.6　データ変換（マッピング）の定義

3.7　TP1アダプタの設定項目の反映

3.8　実行環境プロパティファイルの作成

3.9　TP1/Client/J環境定義の設定

3.10　J2EEサーバ用オプション定義ファイルの編集

3.1　設定前の準備

ここでは，TP1アダプタの設定を行う前に実施する作業について説明します。

＜この節の構成＞

(1)　開発環境を使用するためのセットアップ

(2)　前提条件

(1)　開発環境を使用するためのセットアップ

Cosminexus サービスプラットフォームの開発環境を使用するためのセットアップ手順を次に示します。

uCosminexus Service Architectをインストールします。
インストールの詳細は，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「2.1.2　インストール」を参照してください。

MyEclipse for Cosminexusをセットアップします。
セットアップの詳細は，マニュアル「Cosminexus アプリケーションサーバ アプリケーション開発ガイド」の「2.4　MyEclipseセットアップ機能を使用したセットアップ」を参照してください。

環境設定をします。
環境設定の詳細は，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「2.1.3　環境設定」を参照してください。

uCosminexus 日立コード変換 - Development Kitをセットアップします。
uCosminexus 日立コード変換 - Development Kitのセットアップの詳細は，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「2.1.4　uCosminexus 日立コード変換 - Development Kitのセットアップ」を参照してください。

TP1アダプタをインストールします。
TP1アダプタは，ユーザが任意のインストールディレクトリを作成し，提供媒体からディレクトリ構成をコピーすることでインストールします。開発環境のTP1アダプタのディレクトリ構成を次の表に示します。

表3-1　開発環境のTP1アダプタのディレクトリ構成

ディレクトリ名 | ファイル名 | 説明
config | － | 定義格納ディレクトリ
config¥templates | － | 定義テンプレート格納ディレクトリ
adptp1_config.xml | 通信構成定義ファイル
adptp1.properties | 実行環境プロパティファイル
customadapter_properties.xml | 環境定義ファイル
lib | － | ライブラリ格納ディレクトリ
adptp1_faultfmt.xsd | フォルト電文を規定する電文フォーマットのXMLスキーマファイル
adptp1ejb.ear | EJBパッケージファイル
adptp1pc.jar | プロトコルコンバータアーカイブファイル
adptp1rt.jar | 実行機能アーカイブファイル

（凡例）

－：該当しません。

なお，TP1アダプタのインストール手順は実行環境でも同様です。

(2)　前提条件

Cosminexus サービスプラットフォームの開発環境を使用するための前提条件を次に示します。

開発環境を利用するユーザ

開発環境を利用するユーザは，「Administrators」または「Power Users」グループに属している必要があります。

インストールおよびセットアップが必要なソフトウェア

開発環境を使用する前に，次のソフトウェアがインストールおよびセットアップされている必要があります。

MyEclipse for Cosminexus

WSDL4J 1.5.1

SOAP通信基盤の動作モード

Cosminexusが提供しているSOAP通信基盤の動作モードは，標準モードにする必要があります。次のコマンドを実行すると，動作モードを標準モードに設定できます。

＜Cosminexusインストールディレクトリ＞¥c4web¥bin¥setup_mode std

3.2　設定手順

ここでは，TP1アダプタの設定手順を説明します。TP1アダプタの環境作成手順を次の図に示します。

図3-1　TP1アダプタの環境作成手順

各工程での作業を次に示します。

＜この節の構成＞

(1)　電文フォーマットの作成

(2)　TP1アダプタの環境定義ファイルの作成

(3)　TP1アダプタの通信構成定義ファイルの作成

(4)　TP1アダプタの追加・定義

(5)　データ変換（マッピング）の定義

(6)　TP1アダプタの設定項目の反映

(7)　パッケージング

(8)　配備定義

(9)　運用環境リポジトリへの反映

(10)　サービスリクエスタの作成

(11)　実行環境プロパティファイルの作成

(12)　TP1/Client/J環境定義の設定

(13)　J2EEサーバ用オプション定義ファイルの編集

(1)　電文フォーマットの作成

サービスリクエスタ，TP1アダプタ，およびサービスの間でやり取りされる電文フォーマット（電文の形式）を定義します。電文フォーマットの作成については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「4.　電文フォーマットの作成」を参照してください。

(2)　TP1アダプタの環境定義ファイルの作成

TP1アダプタの環境を定義します。環境定義ファイルの作成については，「3.3　TP1アダプタの環境定義ファイルの作成」を参照してください。

(3)　TP1アダプタの通信構成定義ファイルの作成

TP1アダプタの通信構成を定義します。通信構成定義ファイルの作成については，「3.4　TP1アダプタの通信構成定義ファイルの作成」を参照してください。

(4)　TP1アダプタの追加・定義

［サービスアダプタ定義追加］ダイアログおよびサービスアダプタ定義画面を使用して，TP1アダプタの追加および定義を行います。TP1アダプタの追加および定義については，「3.5　TP1アダプタの追加・定義」を参照してください。

(5)　データ変換（マッピング）の定義

電文のやり取りでデータ変換が必要な場合は，データ変換を定義します。データ変換の定義については，「3.6　データ変換（マッピング）の定義」を参照してください。

(6)　TP1アダプタの設定項目の反映

Eclipseのメニューから［ファイル］－［保管］を選択し，定義内容を保存します。TP1アダプタの設定項目の反映については，「3.7　TP1アダプタの設定項目の反映」を参照してください。

(7)　パッケージング

開発環境で作成したHCSCコンポーネントを，実行環境に配備できるようにEARファイルに組み立てることをパッケージングといいます。パッケージングについては，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「9.　HCSCコンポーネントのパッケージングと配備定義」を参照してください。

(8)　配備定義

定義したアダプタをどのクラスタ（または単一のHCSCサーバ）に配備するか決めることを配備定義といいます。配備定義については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「9.　HCSCコンポーネントのパッケージングと配備定義」を参照してください。

(9)　運用環境リポジトリへの反映

開発環境で作成したTP1アダプタサービスおよびビジネスプロセスを運用環境へ反映します。運用環境へ反映するには，開発環境のリポジトリからTP1アダプタサービスおよびビジネスプロセスをエクスポートして任意のファイル名で保存したあと，運用環境でそのファイルをインポートします。

開発環境からリポジトリをエクスポートする方法については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「3.2.2　リポジトリをエクスポートする」を参照してください。

運用環境にリポジトリを反映する方法については，マニュアル「Cosminexus サービスプラットフォーム システム構築・運用ガイド」の「4.3　リポジトリのインポート」を参照してください。

(10)　サービスリクエスタの作成

サービスリクエスタとは，業務担当者からの要求を受け付けて，アダプタやビジネスプロセスなどの各HCSCコンポーネントにサービスの実行要求を送信するアプリケーションです。サービスリクエスタは，実行環境が提供するインターフェース情報を基に，開発環境で作成し，実行環境に配備して利用します。サービスリクエスタの作成方法およびエラー情報の取得方法については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「10.　サービスリクエスタの作成」を参照してください。

(11)　実行環境プロパティファイルの作成

実行環境でTP1アダプタが動作するために必要となる定義ファイルを作成します。実行環境プロパティファイルの作成については，「3.8　実行環境プロパティファイルの作成」を参照してください。

(12)　TP1/Client/J環境定義の設定

RPC通信のサービス要求方式に対応するTP1/Client/J環境定義を指定します。TP1/Client/J環境定義については，「3.9　TP1/Client/J環境定義の設定」を参照してください。

(13)　J2EEサーバ用オプション定義ファイルの編集

実行環境でTP1アダプタが動作するために，J2EEサーバへクラスパスを追加します。J2EEサーバ用オプション定義ファイルの編集については，「3.10　J2EEサーバ用オプション定義ファイルの編集」を参照してください。

3.3　TP1アダプタの環境定義ファイルの作成

ここでは，TP1アダプタの環境定義ファイルについて説明します。

＜この節の構成＞

3.3.1　ファイルの作成方法

3.3.2　定義の詳細

3.3.1　ファイルの作成方法

TP1アダプタの環境定義に必要な情報は，XML形式のTP1アダプタの環境定義ファイルに定義します。次に示すディレクトリに格納されているサンプルファイルを利用して作成します。

<TP1アダプタのインストールディレクトリ>¥config¥templates¥customadapter_properties.xml

TP1アダプタの環境定義ファイルは，customadapter_properties.xmlの名称で任意のディレクトリに保存してください。このファイルは，開発環境でパッケージングしたあと，実行環境にインポートすることで，実行環境に反映されます。内容を変更する場合は，開発環境で再度パッケージングして実行環境にインポートしてください。

3.3.2　定義の詳細

TP1アダプタの環境定義ファイルの記載形式を次に示します。

図3-2　TP1アダプタの環境定義ファイルの記載形式

定義内容を次に示します。

<?xml version="1.0" encoding="UTF-8"?>

XMLファイルであることを示すXML宣言です。

<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">

DTDサブセットを示す要素型定義宣言です。

<properties>

TP1アダプタの環境定義のルート要素です。

<entry key="adptp1_deffile">　～＜文字列＞

TP1アダプタの通信構成定義ファイル名を指定する要素です。この要素の値に実行環境での通信構成を定義したTP1アダプタの通信構成定義ファイル名を指定してください。

<entry key="adptp1_fault_message_enable">{ true | false }　～<<false>>

TP1アダプタのエラー情報の拡張オプション（拡張した要素の出力有無）を指定する要素です。

true
拡張した要素を出力します。

false
拡張した要素を出力しません。

3.4　TP1アダプタの通信構成定義ファイルの作成

ここでは，TP1アダプタの通信構成定義ファイルについて説明します。

＜この節の構成＞

3.4.1　ファイルの作成方法

3.4.2　定義の詳細

3.4.1　ファイルの作成方法

TP1アダプタの通信構成定義に必要な情報は，XML形式のTP1アダプタの通信構成定義ファイルに定義します。次に示すディレクトリに格納されているサンプルファイルを利用して作成します。

<TP1アダプタのインストールディレクトリ>¥config¥templates¥adptp1_config.xml

TP1アダプタの通信構成定義ファイルは，任意の名称で任意のディレクトリに保存してください。その後，TP1アダプタの環境定義ファイルで，通信構成定義ファイル名の要素に保存したファイル名を指定してください。このファイルは，開発環境でパッケージングしたあと，実行環境にインポートすることで，実行環境に反映されます。内容を変更する場合は，開発環境で再度パッケージングして実行環境にインポートしてください。

3.4.2　定義の詳細

TP1アダプタの通信構成定義ファイルの記載形式を次に示します。

図3-3　TP1アダプタの通信構成定義ファイルの記載形式

指定を省略する場合は，開始タグおよび終了タグを含めて省略してください。開始タグおよび終了タグの記述を残して要素の値だけを省略することはできません。

<active_mode>および<standcon_mode>を省略する場合の指定例を次に示します。

誤った指定例

：
<connect_mode>STAND</connect_mode>
<active_mode></active_mode>
<standcon_mode></standcon_mode>
<con_pool_num>64</con_pool_num>
：

正しい指定例

：
<connect_mode>STAND</connect_mode>
<con_pool_num>64</con_pool_num>
：

定義内容を次に示します。

<?xml version="1.0" encoding="UTF-8"?>

XMLファイルであることを示すXML宣言です。

<adaptertp1_properties>

TP1アダプタの通信構成定義のルート要素です。

<service_group>　～<識別子>((1－31文字))

サービスグループ名を指定する要素です。この要素の値に接続先システムのサービスグループ名を指定してください。

<operation>

オペレーション情報のルート要素です。この要素はオペレーションの数だけ定義できます。

<op_name>　～<英数字>((1－256文字))

オペレーション名を指定する要素です。この要素の値にサービスリクエスタからサービスを要求するときに指定するオペレーション名を指定してください。

<service>　～<識別子>((1－31文字))

サービス名を指定する要素です。この要素の値に接続先システムのサービスグループに登録されているサービス名を指定してください。

<watch_time>　～<数字>((0－65535))(単位：秒)<<180>>

応答監視時間を指定する要素です。この要素の値にTP1アダプタから通信先のOpenTP1システムに対してサービス要求を行ってから応答を受信するまでの監視時間の最大値を指定します。なお，0を指定した場合は，応答を受信するまで無限に待ちます。

この要素の指定値は，TP1アダプタへサービス要求を行なったときに発生するOpenTP1システムとの通信にだけ有効です。有効範囲の詳細は，表2-1および表2-2を参照してください。

<connect_mode>　～{STAND｜RAP｜STATIC}

接続方式を指定する要素です。この要素の値にOpenTP1システムと接続するときの接続方式を指定してください。通信先を指定した接続を指定する場合は，STATICを指定してください。

指定できる値および意味は次のとおりです。

STAND：通常RPC接続

RAP：リモートAPI接続

STATIC：通信先を指定したRPC接続

注意

この要素に「STATIC」を指定した場合は，active_mode要素およびstandcon_mode要素の設定が無効となります。

<active_mode>　～{STAND｜EACH}<<STAND>>

確立方式を指定する要素です。この要素の値にリモートAPI接続時に確立するコネクションの常設または非常設を指定してください。リモートAPI接続の場合だけ，この要素の指定値は有効になります。

指定できる値および意味は次のとおりです。

STAND：常設コネクション

EACH：非常設コネクション

<standcon_mode>　～{AUTO｜MANUAL}<<AUTO>>

常設コネクションの管理方法を指定する要素です。この要素の値にリモートAPI接続時に確立する常設コネクションの管理方法を指定してください。

リモートAPI接続で常設コネクションを確立する場合だけ，この要素の指定値は有効になります。

指定できる値は次のとおりです。

AUTO：オートコネクトモード

MANUAL：非オートコネクトモード

<static_host>　～<文字列>((1－255文字))

通信先を指定した接続をする場合の接続先のホスト名を指定する要素です。この要素の値に，接続先スケジュールサーバのホスト名を指定してください。

通信先を指定した接続をする場合だけ，この要素の指定値は有効となります。

<static_port>　～<符号なし整数>((0－65535))

通信先を指定した接続をする場合の接続先のポート番号を指定する要素です。この要素の値に，接続先スケジュールサーバのポート番号を指定してください。

通信先を指定した接続をする場合だけ，この要素の指定値は有効となります。

<con_pool_num>　～<数字>((1－1024))

接続先システムで同時に処理できるRPC要求の最大数を指定する要素です。この要素の値に接続先システムで同時に処理できるRPC要求の最大数を指定してください。この要素で指定する値とサービスアダプタ定義画面で指定する最大インスタンス数（TP1アダプタの最大インスタンス数）は同じ値を指定してください。

注意

TP1アダプタのサービス実行要求を受け付ける数（最大インスタンス数）がこの要素の指定値を超えた場合，RPC通信障害処理の失敗時と同様，サービス実行要求を受け付けたときにエラーになります。

<send_buff_size>　～<数字>((1－8388608))（単位：バイト）<<4096>>

送信バッファサイズを指定する要素です。この要素の値に接続先OpenTP1システムに要求する送信メッセージの最大長を指定してください。

<recv_buff_size>　～<数字>((1－8388608))（単位：バイト）<<4096>>

受信バッファサイズを指定する要素です。この要素の値に接続先OpenTP1システムから受信メッセージの最大長を指定してください。

3.5　TP1アダプタの追加・定義

ここでは，TP1アダプタを追加および定義する手順を説明します。

Eclipseのメニューから，［ウィンドウ］－［ビューの表示］－［その他］を選択します。
［ビューの表示］ダイアログが表示されます。

［HCSC-Definer］－［HCSCTEビュー］を選択し，［OK］ボタンをクリックします。
ツリービューにサービス定義一覧が表示されます。

ツリービューのサービス定義一覧で右クリックして「サービスアダプタ追加」を選択します。
［サービスアダプタ定義追加］ダイアログが表示されます。［サービスアダプタ定義追加］ダイアログの画面を次の図に示します。

図3-4　［サービスアダプタ定義追加］ダイアログ

サービス部品の種別のドロップダウンリストから「汎用カスタムアダプタ」を選択します。

［次へ］ボタンをクリックします。
［サービスアダプタ定義追加（汎用カスタムアダプタ）］ダイアログが表示されます。［サービスアダプタ定義追加（汎用カスタムアダプタ）］ダイアログを次の図に示します。

図3-5　［サービスアダプタ定義追加（汎用カスタムアダプタ）］ダイアログ

サービス名とEARファイルを入力します。
サービス名には，任意のサービス名を入力します。EARファイルには，「<開発環境のTP1アダプタのインストールディレクトリ>¥lib¥adptp1ejb.ear」を指定します。

［終了］ボタンをクリックします。
必要なファイルが作成され，リポジトリに保存されます。サービスアダプタ定義画面（基本）が表示されます。サービスアダプタ定義画面（基本）を次の図に示します。

図3-6　サービスアダプタ定義画面（基本）

サービス部品制御情報の［サービス名］および［サービスID］を必要に応じて編集します。

サービス部品制御情報の［追加］ボタンをクリックして，オペレーションを追加します。

オペレーション情報の［通信モデル］のドロップダウンリストから，「同期」または「非同期」を選択します。

要求電文について，手順12.から手順23.までを実施します。

次に示す操作をします。

標準電文のフォーマットを指定する場合

手順13.～16.を実施して，手順17.に進みます。

標準電文のフォーマットを指定しない場合

手順17.に進みます。

標準電文の［使う］チェックボックスをチェックします。

標準電文の［フォーマットID］を指定します。

標準電文の［...］ボタンをクリックして，［電文フォーマット］に標準電文のフォーマットを指定します。
指定できる電文フォーマットの形式については，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「2.6.5　XMLスキーマの適用範囲」を参照してください。

標準電文の［表示］ボタンをクリックします。
電文フォーマットがXML形式の場合，標準電文のフォーマットが表示されます。必要に応じて指定した標準電文のフォーマットを確認してください。

サービス部品電文の［フォーマットID］を指定します。

サービス部品電文の［...］ボタンをクリックして，［電文フォーマット］にサービス部品電文のフォーマットを指定します。

サービス部品電文の［表示］ボタンをクリックします。
電文フォーマットがXML形式の場合，サービス部品電文のフォーマットが表示されます。必要に応じて指定したサービス部品電文のフォーマットを確認してください。

次に示す操作をします。

標準電文の［使う］チェックボックスをチェックした場合

手順21.～23.を実施して，手順24.に進みます。

標準電文の［使う］チェックボックスをチェックしない場合

手順24.に進みます。

データ変換定義のファイル名を入力します。

［編集］ボタンをクリックします。
データ変換定義画面が表示されます。初めて定義する場合は，［ルート要素選択］ダイアログが表示されます。

標準電文とサービス電文の内容をマッピングします。

応答電文についても，手順12.から手順23.までを実施します。

サービスアダプタ定義（詳細）タブをクリックします。
サービスアダプタ定義（詳細）画面が表示されます。サービスアダプタ定義（詳細）画面を次の図に示します。

図3-7　サービスアダプタ定義（詳細）画面

カスタムアダプタ（EJB-JARファイル）の名称を確認します。

ユーティリティクラス（JARファイル）の［追加］ボタンをクリックして，次のユーティリティクラスを追加します。

adptp1pc.jar（プロトコルコンバータアーカイブファイル）

独自定義ファイルの［追加］ボタンをクリックして，次のファイルを追加します。

adptp1_config.xml（通信構成定義ファイル）

customadapter_properties.xml（環境定義ファイル）

定義内容を確認して，Eclipseのメニューから［ファイル］－［保管］を選択し，定義内容を保存します。

TP1アダプタを定義する場合の，サービスアダプタ定義画面（基本）での設定項目を次の表に示します。

表3-2　TP1アダプタのサービスアダプタ定義画面（基本）の設定項目

分類
項目
説明
TP1アダプタでの設定

サービス部品制御情報
－
TP1アダプタ新規作成時に指定したサービス部品についての情報が表示されます。
－

サービス名
［サービスアダプタ定義追加（汎用カスタムアダプタ）］ダイアログで指定したHCSCコンポーネントの名称が表示されます。
◎

サービスID
HCSCコンポーネントのIDが表示されます。※1
◎

サービス種別
サービス部品の種別として「汎用カスタムアダプタ」が表示されます。
×

アドレス
この項目は使用しません。
×

最大インスタンス数
サービス部品の最大インスタンス数が表示されます。
同時に処理できる接続先システムへのRPC要求数を指定します。ここで指定する値とTP1アダプタの通信構成定義のcon_pool_num要素は同じ値を指定してください。
◎

サービスクラス名
この項目は使用しません。
×

オペレーション
オペレーション名が表示されます。サービス部品が持つオペレーション名をドロップダウンリストから選択します。
◎

［追加］ボタン
オペレーションを追加する画面が表示されます。
－

［削除］ボタン
オペレーション欄で選択したオペレーションを削除します。
－

オペレーション情報
－
サービス部品のオペレーションについての情報が表示されます。
－

オペレーション名
サービス部品制御情報のオペレーション欄で選択したオペレーションの名称が表示されます。
×

通信モデル
サービス部品制御情報のオペレーション欄で選択したオペレーションの通信モデルを選択します。ドロップダウンリストから次に示す「同期」または「非同期」のどちらかを選択します。

同期
応答電文の情報が表示されます。

非同期
応答電文の情報は表示されません。非同期のままアダプタ定義を保存すると応答電文のすべての項目は消えます。

◎

要求電文
－
サービスリクエスタから送信される要求電文の情報が表示されます。
－

標準
使う（チェックボックス）
標準電文をサービス部品電文のフォーマットにデータ変換する場合にチェックします。
○

フォーマットID
サービスリクエスタから受け付けた標準電文のフォーマットIDを入力します。
△※2

電文フォーマット
サービスリクエスタから受け付けた標準電文のフォーマット名を入力します。
△※2

［...］ボタン
標準電文フォーマットのファイルを選択するダイアログが表示されます。
－

［表示］ボタン
電文フォーマットがXML形式の場合，標準電文のフォーマットが表示されます。
－

サービス部品
フォーマットID
サービス部品電文のフォーマット（TP1アダプタ用の電文フォーマット定義ファイル）IDを入力します。
◎

電文フォーマット
サービス部品電文のフォーマット（TP1アダプタ用の電文フォーマット定義ファイル）名を入力します。
◎

［...］ボタン
サービス部品電文のフォーマットファイル（TP1アダプタ用の電文フォーマット定義ファイル）を選択するダイアログが表示されます。
TP1アダプタでは，バイナリフォーマットの電文だけ使用できます。したがって，バイナリフォーマット定義ファイルを登録してください。
－

［表示］ボタン
電文フォーマットがXML形式の場合，サービス部品電文のフォーマット（TP1アダプタ用の電文フォーマット定義ファイル）が表示されます。
－

データ変換定義
標準電文からサービス部品電文へデータ変換するための定義ファイル名を入力します。
△※2

［編集］ボタン
データ変換定義画面が表示されます。データ変換定義欄で設定した定義ファイルの内容を編集できます。初めて定義する場合は，［ルート要素選択］ダイアログが表示されます。
－

［削除］ボタン
［編集］ボタンで設定したデータ変換定義を削除します。
－

応答電文
－
サービス部品から送信される応答電文の情報が表示されます。オペレーション情報の通信モデル欄で，「同期」を選択した場合だけ，設定できます。
－

標準
使う（チェックボックス）
サービス部品電文を標準電文のフォーマットにデータ変換する場合にチェックします。
○

フォーマットID
サービス部品から受け付けた標準電文のフォーマットIDを入力します。
△※3

電文フォーマット
サービス部品から受け付けた標準電文のフォーマット名を入力します。
△※3

［...］ボタン
標準電文フォーマットを選択するダイアログが表示されます。
－

［表示］ボタン
電文フォーマットがXML形式の場合，標準電文フォーマットが表示されます。
－

サービス部品
フォーマットID
サービス部品の電文フォーマット（TP1アダプタ用の電文フォーマット定義ファイル）IDを入力します。
◎

電文フォーマット
サービス部品の電文フォーマット（TP1アダプタ用の電文フォーマット定義ファイル）名を入力します。
◎

［...］ボタン
サービス部品電文のフォーマットファイル（TP1アダプタ用の電文フォーマット定義ファイル）を選択するダイアログが表示されます。
TP1アダプタでは，バイナリフォーマットの電文だけ使用できます。したがって，バイナリフォーマット定義ファイルを登録してください。
－

［表示］ボタン
電文フォーマットがXML形式の場合，サービス部品電文のフォーマット（TP1アダプタ用の電文フォーマット定義ファイル）が表示されます。
－

データ変換定義
サービス部品電文から標準電文へデータ変換するための定義ファイル名を入力します。
△※3

［編集］ボタン
データ変換定義画面が表示されます。データ変換定義欄で設定した定義ファイルの内容を編集できます。初めて定義する場合は，［ルート要素選択］ダイアログが表示されます。
－

［削除］ボタン
［編集］ボタンで設定したデータ変換定義を削除します。
－

フォルト電文
－
サービス部品のフォルト電文についての情報が表示されます。
－

［追加］ボタン
フォルト名を追加する画面が表示されます。
－

［削除］ボタン
［編集］ボタンで設定したフォルト名を削除します。
－

フォルト名
サービス部品のフォルト名が表示されます。
◎

電文フォーマット
サービス部品のフォルト電文フォーマット名が表示されます。
◎

［...］ボタン
フォルト電文フォーマットを指定するダイアログが表示されます。
フォルト電文を規定する電文フォーマットのXMLスキーマファイル（adptp1_faultfmt.xsd）を指定してください。
－

［表示］ボタン
フォルト電文フォーマットが表示されます。
－

（凡例）

◎：必ず設定します。

○：任意で設定します。

△：場合によっては必ず設定します。

×：表示されている内容を確認します。

－：該当しません。

注※1

TP1アダプタでは，サービスIDを基にトレースの出力パスが決められます。このため，サービスIDを編集する場合は，一度作成したことのあるTP1アダプタのサービスIDと同じサービスIDは指定しないでください。なお，サービスIDの大文字と小文字は区別されません。同じサービスIDを指定した場合は，トレースが過去に作成したトレース情報に出力されるため，障害発生時の原因究明が困難になる場合があります。

注※2

要求電文の［使う］（チェックボックス）にチェックした場合，必ず設定します。

注※3

応答電文の［使う］（チェックボックス）にチェックした場合，必ず設定します。

TP1アダプタを定義する場合の，サービスアダプタ定義（詳細）画面での設定項目を次の表に示します。

表3-3　TP1アダプタのサービスアダプタ定義（詳細）画面の設定項目

分類
項目
説明
TP1アダプタでの設定

カスタムアダプタ制御情報
カスタムアダプタ（EJB-JARファイル）
TP1アダプタ新規作成時に指定したサービス部品についての情報が表示されます。
×

ユーティリティクラス（JARファイル）
－
TP1アダプタのEJB-JARファイルの名称が表示されます。
◎

［追加］ボタン
ユーティリティクラスを追加するダイアログが表示されます。TP1アダプタでは，次のユーティリティクラスを追加します。

adptp1pc.jar（プロトコルコンバータアーカイブファイル）

－

［削除］ボタン
ユーティリティクラス欄で選択したファイルを削除します。
－

独自定義ファイル
－
TP1アダプタの環境定義ファイル，およびTP1アダプタの通信構成定義ファイルの名称が表示されます。
－

［追加］ボタン
独自定義ファイルを追加するダイアログが表示されます。
TP1アダプタでは，次の独自定義ファイルを追加します。

通信構成定義ファイル

環境定義ファイル

－

［削除］ボタン
独自定義ファイル欄で選択したファイルを削除します。
－

（凡例）

◎：必ず設定します。

×：表示されている内容を確認します。

－：該当しません。

参考

作成したTP1アダプタは，検証，編集，および削除できます。詳細は，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「5.　アダプタの定義」を参照してください。

3.6　データ変換（マッピング）の定義

変換元（マッピング元）の値を変換先（マッピング先）の値に対応づけることをマッピングといいます。ここでは，データ変換（マッピング）の定義方法について説明します。

データ変換定義画面で，変換元の電文フォーマット定義ファイルおよび変換先の電文フォーマット定義ファイルを設定して，データ変換を定義します。データ変換定義画面は，アダプタ定義画面またはビジネスプロセス定義画面のデータ変換アクティビティから表示します。データ変換定義画面の画面構成を次の図に示します。

図3-8　データ変換定義画面

データ変換定義画面では，変換元スキーマツリービューアおよび変換先スキーマツリービューアが表示され，それぞれの要素を対応づけることができます。各電文の変換元と変換先の関係は次に示すとおりです。

要求電文
変換元スキーマツリービューア：TP1アダプタ呼び出し元（標準電文）の電文フォーマット
変換先スキーマツリービューア：TP1アダプタ（サービス部品電文）の電文フォーマット

応答電文
変換元スキーマツリービューア：TP1アダプタ（サービス部品電文）の電文フォーマット
変換先スキーマツリービューア：TP1アダプタ呼び出し元（標準電文）の電文フォーマット

データ変換の詳細は，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「7.　データ変換の定義」を参照してください。

ファンクションを使用した値の加工

変換元ノードの値を加工して変換先ノードにマッピングする場合，ファンクションを使用します。ファンクションの詳細は，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「7.5　ファンクションを使用した値の加工」を参照してください。

文字コード

データ変換で使用できる文字コードの詳細は，マニュアル「Cosminexus サービスプラットフォーム 開発ガイド」の「7.　データ変換の定義」を参照してください。

3.7　TP1アダプタの設定項目の反映

TP1アダプタを選択した状態で，「保存」メニューを選択すると設定項目を保存できます。このときに保存されるファイルがEARファイルです。EARファイルは運用環境から利用できます。

3.8　実行環境プロパティファイルの作成

ここでは，実行環境プロパティファイルについて説明します。

＜この節の構成＞

(1)　ファイルの作成手順

(2)　定義方法

(3)　プロパティの説明

(1)　ファイルの作成手順

実行環境プロパティファイルは，サンプルファイルを利用して作成します。サンプルファイルの格納先を次に示します。

<TP1アダプタのインストールディレクトリ>¥config¥templates¥adptp1.properties

実行環境プロパティファイルの作成手順を次に示します。

サンプルファイルをコピーして，次のディレクトリに格納します。

<TP1アダプタのインストールディレクトリ>¥config

サンプルファイルの名称を<アダプタ名>.propertiesに変更します。

定義内容を編集して保存します。

実行環境プロパティファイルは，TP1アダプタを開始する際に実行環境に反映されます。実行環境プロパティファイルの内容を変更する場合は，TP1アダプタを停止してから作業を行います。TP1アダプタを再開始すると，変更内容が実行環境に反映されます。

(2)　定義方法

実行環境プロパティファイルは，TP1アダプタが実行環境で動作するときのTP1/Client/J環境定義ファイルを定義します。

実行環境プロパティは，Javaのプロパティファイル形式で指定します。定義ファイルの入力形式を次に示します。

<キー名称> = <値>

キー名称

定義するキー名称を指定します。キー名称は固定です。変更しないでください。

値

ユーザが任意の値を指定します。

実行環境プロパティファイルの内容を次に示します。

tp1client.config=TP1/Client/J環境定義ファイルのパス
［buffer.keep={ true | false }］

指定方法

同一のキーが存在する場合は後述のキーの値が反映されます。これは，java.util.Propertiesクラスの仕様です。

区切り文字である「=」はスペースまたはタブで代替できます。

「#」および「!」で始まる行はコメントとみなされます。

プロパティファイルに全角文字などを記述した場合は，Unicodeに変換してください。Unicodeへの変換には，Cosminexus付属のJDKコマンドnative2asciiを実行します。

(3)　プロパティの説明

実行環境プロパティファイルの各プロパティについて説明します。

tp1client.config=TP1/Client/J環境定義ファイルのパス　～<文字列>

TP1/Client/J環境定義ファイルのパスを記述します。パスのディレクトリ区切りは「¥」ではなく，「¥¥」を使用してください。

buffer.keep={ true | false }　～<<true>>

送受信バッファ生成のオプションを指定します。

true
TP1アダプタ起動時に送受信バッファを生成・保持します。

false
RPC通信時に送受信バッファを生成・解放します。

上記以外を指定した場合，警告メッセージ（KDEE12021-W）が出力されtrue指定時の動作となります。また，buffer.keepプロパティ自体を記述していない場合は，警告メッセージは出力されないでtrue指定時の動作となります。

注意

パスを指定する場合の注意事項

相対パス，親ディレクトリ表現（「..¥」「../」），およびカレントディレクトリ表現（「.¥」「./」）を含むパスは指定しないでください。

UNIXの場合，シンボリックリンクを含むパスは指定しないでください。

Windowsの場合，UNC形式，NTFSのストリーム名，および予約デバイス名を含むパスは指定しないでください。また，パスの大文字と小文字は区別されません。

3.9　TP1/Client/J環境定義の設定

ここでは，TP1/Client/J環境定義について説明します。

TP1アダプタのRPC通信で使用するサービス要求方式によって，TP1/Client/Jで指定する環境定義の値が異なります。必ず各サービス要求方式に対応するTP1/Client/J環境定義を指定してください。

ここで説明する以外のTP1/Client/J環境定義については，マニュアル「OpenTP1 Version 7 分散トランザクション処理機能 OpenTP1 クライアント使用の手引 TP1/Client/J編」を参照してください。

TP1/Client/J環境定義は，TP1アダプタを開始する際に実行環境に反映されます。TP1/Client/J環境定義の内容を変更する場合は，TP1アダプタを停止してから作業を行います。TP1アダプタを再開始すると，変更内容が実行環境に反映されます。

＜この節の構成＞

3.9.1　リモートAPI機能を使用する場合

3.9.2　ネームサービス機能を使用する場合

3.9.3　スケジューラダイレクト機能を使用する場合

3.9.4　通信先を指定した接続をする場合

3.9.1　リモートAPI機能を使用する場合

リモートAPI機能を使用する場合，RPC接続の確立方式および常設コネクションの管理方法によって，TP1/Client/Jで指定する環境定義の値が異なります。TP1アダプタの通信構成定義およびTP1/Client/J環境定義の対応を次の表に示します。

表3-4　TP1アダプタの通信構成定義およびTP1/Client/J環境定義の対応

TP1/Client/J環境定義 | TP1アダプタの通信構成定義
connect_mode：RAP
active_mode：STAND | active_mode：EACH
standcon_mode：MANUAL | standcon_mode：AUTO | standcon_mode要素は指定不要
dcnamuse | N（使用しない） | N（使用しない） | N（使用しない）
dcrapdirect | Y（使用する） | Y（使用する） | Y（使用する）
dcscddirect | N（使用しない） | N（使用しない） | N（使用しない）
dcrapautoconnect | N（使用しない） | Y（使用する） | N（使用しない）

（凡例）

：（コロン）は，要素および要素の指定値の対応を示します。例えば，「connect_mode：RAP」は，connect_mode要素にRAPを指定することを示します。

リモートAPI機能を使用する場合のTP1/Client/J環境定義を次の表に示します。

表3-5　リモートAPI機能使用時のTP1/Client/J環境定義

TP1/Client/J環境定義 | 指定値 | 説明
dcnamuse | N（使用しない） | ネームサービス機能の使用の有無を指定します。
dcrapdirect | Y（使用する） | リモートAPI機能の使用の有無を指定します。
dcscddirect | N（使用しない） | スケジューラダイレクト機能の使用の有無を指定します。
dchost | ホスト名，rapリスナーのポート番号 | rapリスナーが存在する接続先システムのホスト名およびrapリスナーのポート番号を指定します。dcrapportオペランドでrapリスナーのポート番号を指定している場合，ポート番号の指定は省略できます。
dcrapport | rapリスナーのポート番号 | rapリスナーのポート番号を指定します。dchostオペランドでポート番号を指定する場合，このオペランドの指定は省略できます。
dcrapautoconnect※ | Y｜N | rapサーバとの間の常設コネクションを自動的に確立させるかどうかを指定します。TP1アダプタの通信構成定義のstandcon_mode要素と指定値を対応させてください。

注※

dcrapautoconnectオペランドの指定による性能についてのメリットおよびデメリットを次の表に示します。

表3-6　dcrapautoconnectオペランドの指定によるメリットおよびデメリット

dcrapautoconnectオペランドの指定値 | メリット | デメリット
Y（オートコネクト） | 接続先システムからコネクションを解放されても，サービス要求実行時に再確立を行います。 | 初回のサービス要求実行時にコネクションの確立を行うため性能劣化のおそれがあります。
N（非オートコネクト） | TP1アダプタ開始時にすべてのコネクションの確立を行います。初回のサービス要求実行時に，コネクションの確立をする必要なく通信できます。 | 確立するコネクションの数が多いとTP1アダプタの開始処理に時間が掛かります。

3.9.2　ネームサービス機能を使用する場合

ネームサービス機能を使用する場合，TP1アダプタの通信構成定義のconnect_mode要素にSTANDを指定します。ネームサービス機能を使用する場合のTP1/Client/J環境定義を次の表に示します。

表3-7　ネームサービス機能使用時のTP1/Client/J環境定義

TP1/Client/J環境定義 | 指定値 | 説明
dcnamuse | Y（使用する） | ネームサービス機能の使用の有無を指定します。
dcrapdirect | N（使用しない） | リモートAPI機能の使用の有無を指定します。
dcscddirect | N（使用しない） | スケジューラダイレクト機能の使用の有無を指定します。
dchost | ホスト名，ネームサービスのポート番号 | ネームサービスが存在する接続先システムのホスト名およびネームサービスのポート番号を指定します。dcnamportオペランドでネームサービスのポート番号を指定している場合，ポート番号の指定は省略できます。
dcnamport | ネームサービスのポート番号 | ネームサービスのポート番号を指定します。dchostオペランドでポート番号を指定する場合，このオペランドの指定は省略できます。

3.9.3　スケジューラダイレクト機能を使用する場合

スケジューラダイレクト機能を使用する場合，TP1アダプタの通信構成定義のconnect_mode要素にSTANDを指定します。スケジューラダイレクト機能を使用する場合のTP1/Client/J環境定義を次の表に示します。

表3-8　スケジューラダイレクト機能使用時のTP1/Client/J環境定義

TP1/Client/J環境定義 | 指定値 | 説明
dcnamuse | N（使用しない） | ネームサービス機能の使用の有無を指定します。
dcrapdirect | N（使用しない） | リモートAPI機能の使用の有無を指定します。
dcscddirect | Y（使用する） | スケジューラダイレクト機能の使用の有無を指定します。
dchost | ホスト名，スケジューラダイレクトサービスのポート番号 | スケジューラダイレクトサービスが存在する接続先システムのホスト名およびスケジューラダイレクトサービスのポート番号を指定します。dcscdportオペランドでスケジューラダイレクトサービスのポート番号を指定している場合，ポート番号の指定は省略できます。
dcscdport | スケジューラダイレクトサービスのポート番号 | スケジューラダイレクトサービスのポート番号を指定します。dchostオペランドでポート番号を指定する場合，このオペランドの指定は省略できます。

3.9.4　通信先を指定した接続をする場合

TP1アダプタで通信相手と通信先を指定した接続をする場合，TP1アダプタの通信構成定義のconnect_mode要素にSTATICを指定します。通信先を指定した接続をする場合のTP1/Client/J環境定義を次の表に示します。

表3-9　通信先指定による接続時のTP1/Client/J環境定義

TP1/Client/J環境定義 | 指定値 | 説明
dcnamuse | N（使用しない） | ネームサービス機能の使用の有無を指定します。
dcrapdirect | N（使用しない） | リモートAPI機能の使用の有無を指定します。
dcscddirect | Y（使用する） | スケジューラダイレクト機能の使用の有無を指定します。

注意

次の表に示すオペランドの定義項目は使用されません。接続先のホスト名，ポート番号の情報は，TP1アダプタの通信構成定義のstatic_hostおよびstatic_port要素を使用します。また，dcrapautoconnectオペランドの定義は無効となります。

表3-10　通信先指定による接続時に使用されないTP1/Client/J環境定義

TP1/Client/J環境定義 | 指定値 | 説明
dchost | ホスト名，スケジューラダイレクトサービスのポート番号 | スケジューラダイレクトサービスが存在する接続先システムのホスト名，およびスケジューラダイレクトサービスのポート番号
dcscdport | スケジューラダイレクトサービスのポート番号 | スケジューラダイレクトサービスのポート番号

3.10　J2EEサーバ用オプション定義ファイルの編集

実行環境でTP1アダプタが動作するために，J2EEサーバのクラスパスにTP1アダプタの実行機能アーカイブファイルを追加します。J2EEサーバ用オプション定義ファイル（usrconf.cfg）を編集し，次の内容を記述してください。

add.class.path=<TP1アダプタのインストールディレクトリ>¥lib¥adptp1rt.jar

J2EEサーバ用オプション定義ファイル（usrconf.cfg）の詳細について次に説明します。

＜この節の構成＞

(1)　機能

(2)　ファイルの格納先

(3)　形式

(1)　機能

J2EEサーバを実行するJavaVMの起動オプションを指定します。

J2EEサーバの稼働中に，このファイルの内容を変更した場合，変更した内容は次にJ2EEサーバを起動したときに反映されます。

(2)　ファイルの格納先

ファイルの格納先を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥

UNIXの場合
/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/

(3)　形式

J2SEのプロパティファイル形式です。

次のようにキーを指定します。

<キー名称> = <値>

指定方法

改行までが値になります。

「#」で始まる行はコメントとみなされます。

値が存在しない行を定義した場合，その行は無視されます。

値の後ろには，空白やコメントなどの文字列は追加できません。追加した場合，不正な値と解釈されます。
（例）　<キー名称> = <値> #<コメント>

実行時の文字エンコーディングと異なる文字エンコーディングでは記述できません。

4.　運用

この章では，TP1アダプタの運用方法について説明します。

＜この章の構成＞

4.1　TP1アダプタの開始と停止

4.1　TP1アダプタの開始と停止

TP1アダプタの開始および停止の方法を次に示します。

Cosminexus サービスプラットフォームの運用環境の画面を利用しての開始と停止

Cosminexus サービスプラットフォームのコマンドによる開始と停止

TP1アダプタの開始方法の詳細は，マニュアル「Cosminexus サービスプラットフォーム システム構築・運用ガイド」の「5.2.6　サービスアダプタを開始する」を参照してください。

TP1アダプタの停止方法の詳細は，マニュアル「Cosminexus サービスプラットフォーム システム構築・運用ガイド」の「5.2.28　サービスアダプタを停止する」を参照してください。

5.　メッセージ

この章では，TP1アダプタで出力されるメッセージについて説明します。

＜この章の構成＞

5.1　メッセージの種類と形式

5.2　メッセージ一覧

5.1　メッセージの種類と形式

ここでは，このマニュアルでのメッセージの種類と記述形式について説明します。

＜この節の構成＞

5.1.1　メッセージの種類

5.1.2　メッセージの形式

5.1.1　メッセージの種類

TP1アダプタのメッセージには，次の種類があります。

表5-1　メッセージの種類

分類 | メッセージの種類
アダプタ運用制御に関するメッセージ | KDEE10000～10999のメッセージ
通信制御に関するメッセージ | KDEE11000～11999のメッセージ
定義解析に関するメッセージ | KDEE12000～12999のメッセージ
ログ出力に関するメッセージ | KDEE13000～13999のメッセージ

5.1.2　メッセージの形式

このマニュアルでのメッセージの記述形式を次に示します。

KDEEnnnnn-Y

メッセージテキスト

メッセージの説明

(S)

TP1アダプタの動作

(O)

ユーザの処置

対策

メッセージを出力させないための対策，またはユーザの処置に対する補足事項

なお，「(S)」，「(O)」および「対策」はメッセージによっては記述がありません。

KDEE

TP1アダプタのメッセージであることを表します。

nnnnn

メッセージを出力したプログラムで管理するメッセージ番号を表します。それぞれのメッセージには，5けたの固有の番号が付いています。

Y

メッセージのレベルを表します。メッセージのレベルは英字1文字で示します。

メッセージのレベルを示す文字とその意味を次に示します。

E（Error）

エラーレベルのトラブルが発生したことを通知するメッセージです。

このメッセージが出力されたときは，処理を中断します。

W（Warning）

警告レベルのトラブルが発生したことを通知するメッセージです。

メッセージが出力されたあとも処理を続行します。

I（Information）

システムの動作を通知するメッセージです。

メッセージが出力されたあとも処理を続行します。

メッセージテキスト

TP1アダプタが出力したメッセージテキストを示します。

メッセージの説明

メッセージテキストに対する補足説明を示します。

(S)

TP1アダプタの動作を示します。

(O)

ユーザの処置を示します。

対策

メッセージを出力させないための対策，またはユーザの処置に対する補足事項を示します。なお，「保守員に連絡してください」とは，購入時の契約に基づいて，システム管理者が弊社問い合わせ窓口へ連絡することを示します。

5.2　メッセージ一覧

KDEE10000-I

TP1-adapter (TP1アダプタのバージョン情報) has been started. Adapter name = アダプタ名

TP1アダプタが開始しました。

(S)

処理を続行します。

KDEE10001-E

An attempt to initialize the TP1-adapter failed. Adapter name = アダプタ名

TP1アダプタの初期化処理に失敗しました。

(S)

TP1アダプタの開始処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

このメッセージ以前に出力されているメッセージを参照して，原因を取り除いてください。

KDEE10002-E

Content of the TP1/Client/J configuration file is invalid. Adapter name = アダプタ名, Configuration file name = TP1/Client/J環境定義ファイル名, Exception information = 例外情報

TP1/Client/J環境定義ファイルの内容に誤りがあります。

(S)

TP1アダプタの開始処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

TP1/Client/J環境定義ファイルの内容を正しく修正して，再度TP1アダプタを開始してください。

KDEE10003-E

TP1/Client/J configuration file is not found. Adapter name = アダプタ名, Configuration file name = TP1/Client/J環境定義ファイル名, Exception information = 例外情報

TP1/Client/J環境定義ファイルが存在しません。

(S)

TP1アダプタの開始処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

TP1/Client/J環境定義ファイルを作成して，再度TP1アダプタを開始してください。

KDEE10004-E

Cannot access to the TP1/Client/J configuration file. Adapter name = アダプタ名, Configuration file name = TP1/Client/J環境定義ファイル名, Exception information = 例外情報

TP1/Client/J環境定義ファイルにアクセスできません。セキュリティマネージャがファイルの読み込みを許可していないおそれがあります。

(S)

TP1アダプタの開始処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

TP1/Client/Jが定義ファイルにアクセスできるように，適切なパーミッションをセキュリティポリシーファイルに記述する必要があります。マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.5　server.policy（J2EEサーバ用セキュリティポリシーファイル）」を参照して対処したあと，再度TP1アダプタを開始してください。

KDEE10005-E

Failed to open the connection. Adapter name = アダプタ名, Configuration file name = TP1/Client/J環境定義ファイル名, Exception information = 例外情報

接続先とのコネクションの確立に失敗しました。

(S)

TP1アダプタの開始処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

TP1/Client/Jの例外情報を参照して，原因を取り除いてください。

KDEE10006-E

The host name specified in the TP1/Client/J configuration file is invalid. Adapter name = アダプタ名, Configuration file name = TP1/Client/J環境定義ファイル名, Exception information = 例外情報

TP1/Client/J環境定義ファイルのdchostオペランドの指定が不正です。

(S)

TP1アダプタの開始処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

TP1/Client/J環境定義ファイルのdchostオペランドを正しく指定して，再度TP1アダプタを開始してください。

KDEE10007-E

The port number specified in the TP1/Client/J configuration file is invalid. Adapter name = アダプタ名, Configuration file name = TP1/Client/J環境定義ファイル名, Exception information = 例外情報

TP1/Client/J環境定義ファイルのポート番号の指定が不正です。

(S)

TP1アダプタの開始処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

TP1/Client/J環境定義ファイルのdcrapportオペランドを正しく指定して，再度TP1アダプタを開始してください。

KDEE10008-E

Cannot allocate the rap listener server resource. Adapter name = アダプタ名, Configuration file name = TP1/Client/J環境定義ファイル名, Exception information = 例外情報

RAPリスナーまたはRAPサーバで，メモリまたは管理テーブルのリソース不足が発生しました。

(S)

TP1アダプタの開始処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

RAPリスナーサーバが動作しているホストのメモリを確認してください。メモリ不足が発生している場合は，メモリを増やしたあと，再実行してください。

KDEE10009-E

Communication error occurred. Adapter name = アダプタ名, Configuration file name = TP1/Client/J環境定義ファイル名, Exception information = 例外情報

通信障害が発生したか，RAPサーバが起動されていないおそれがあります。

(S)

TP1アダプタの開始処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

通信障害の場合は，例外情報を参照して対処したあと，再度TP1アダプタを開始してください。

リモートAPI機能を使用する場合は，RAPサーバが正常に起動されているか確認してください。RAPサーバが起動されていないときは，起動したあとで再度TP1アダプタを開始してください。

KDEE10010-E

Internal error occurred in TP1/Client/J. Adapter name = アダプタ名, Method name = TP1/Client/Jのメソッド名, Exception information = 例外情報

TP1/Client/Jで内部エラーが発生しました。例外情報の意味は，次のとおりです。

メソッド名 | 例外情報 | 意味
rpcOpen | ErrIOErrException | 何らかの入出力例外が発生しました。
ErrProtoException | メソッドの発行順序に誤りがあります。
ErrSyserrException | システムエラーが発生しました。
setRpcextend | ErrInvalidArgsException | 引数の指定に誤りがあります。
openConnection | ErrIOErrException | 何らかの入出力例外が発生しました。
ErrSyserrException | システムエラーが発生しました。
ErrProtoException | メソッドの発行順序に誤りがあります。
ErrInvalidArgsException | 引数の指定に誤りがあります。

(S)

TP1アダプタの開始処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

ログ・トレースを採取し，保守員に連絡してください。

KDEE10011-E

Internal error occurred. Adapter name = アダプタ名, Method name = 内部メソッド名, Exception information = 例外情報

TP1アダプタで内部エラーが発生しました。

(S)

処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

ログ・トレースを採取し，保守員に連絡してください。

KDEE10013-E

Mismatching environment in the TP1-adapter to TP1/Client/J. Adapter name = アダプタ名, TP1/Client/J configuration file name = TP1/Client/J環境定義ファイル名, TP1-adapter(TP1アダプタの通信構成定義の要素名 = 要素の値), TP1/Client/J(不整合となったTP1/Client/J環境定義のオペランド = オペランドの値)

TP1アダプタの通信構成定義とTP1/Client/J環境定義の指定値に不整合があります。

(S)

TP1アダプタの開始処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

メッセージに表示されたTP1/Client/J環境定義ファイルのオペランド，およびオペランドの値を正しく指定して，再度TP1アダプタを開始してください。

KDEE10014-E

The watch time specified in the TP1/Client/J configuration file is invalid. Adapter name = アダプタ名, Configuration file name = TP1/Client/J環境定義ファイル名, Value = 監視時間指定値

TP1/Client/J環境定義ファイルのdcwatchtimオペランドの指定が不正です。

(S)

TP1アダプタの開始処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

TP1/Client/J環境定義ファイルのdcwatchtimオペランドを正しく指定して，再度TP1アダプタを開始してください。

KDEE10500-I

TP1-adapter has been terminated. Adapter name = アダプタ名

TP1アダプタが停止しました。

(S)

処理を続行します。

KDEE10501-W

An error occurred in finish the TP1-adapter. Adapter name = アダプタ名

TP1アダプタの停止処理中にエラーが発生しました。

(S)

TP1アダプタの停止処理を続行します。

(O)

Cosminexus管理者に連絡してください。

対策

このメッセージ以前に出力されているメッセージを参照してください。

KDEE10502-W

Failed to close the connection. Adapter name = アダプタ名, Configuration file name = TP1/Client/J環境定義ファイル名, Exception information = 例外情報

接続先とのコネクションのクローズに失敗しました。

(S)

TP1アダプタの停止処理を続行します。

(O)

Cosminexus管理者に連絡してください。

対策

TP1/Client/Jの例外情報を参照して，原因を取り除いてください。

KDEE10503-W

Internal error occurred in TP1/Client/J. Adapter name = アダプタ名, Method name = TP1/Client/Jのメソッド名, Exception information = 例外情報

TP1/Client/Jで内部エラーが発生しました。例外情報の意味は次のとおりです。

メソッド名 | 例外情報 | 意味
rpcClose | ErrIOErrException | 何らかの入出力例外が発生しました。
ErrSyserrException | システムエラーが発生しました。
ErrNetDownException | ネットワーク障害が発生しました。
closeConnection | ErrIOErrException | 何らかの入出力例外が発生しました。
ErrSyserrException | システムエラーが発生しました。
ErrNetDownException | ネットワーク障害が発生しました。

(S)

TP1アダプタの停止処理を続行します。

(O)

Cosminexus管理者に連絡してください。

対策

ログ・トレースを採取し，保守員に連絡してください。

KDEE10504-W

Internal error occurred. Adapter name = アダプタ名, Method name = 内部メソッド名, Exception information = 例外情報

TP1アダプタで内部エラーが発生しました。

(S)

TP1アダプタの停止処理を続行します。

(O)

Cosminexus管理者に連絡してください。

対策

ログ・トレースを採取し，保守員に連絡してください。

KDEE11000-E

Unsupported operation. Adapter name = アダプタ名, Operation name = オペレーション名

未サポートのオペレーションが指定されました。

(S)

処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

TP1アダプタが対応しているオペレーションを指定して，再度サービス呼び出し要求を実行してください。

KDEE11001-E

Unsupported telegram. Adapter name = アダプタ名, MsgType = 電文種別, TelType = 電文形式

未サポートの電文形式が指定されました。

電文種別として，次に示すどちらかが表示されます。

REQUEST：要求電文

RESPONSE：応答電文

電文形式として，次に示すどちらかが表示されます。

XML：XML電文

UNKNOWN：判断不能

(S)

処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

TP1アダプタが対応している電文形式（バイナリ電文または任意形式電文）を指定して，再度サービス呼び出し要求を実行してください。

KDEE11002-E

The operation of the telegram failed. Adapter name = アダプタ名, Operation name = オペレーション名, Cause = 原因コード, Exception information = 詳細情報

電文の操作に失敗しました。原因コードの内容は，次のとおりです。

原因コード | 内容 | 詳細情報
01 | データコンテナからの電文取得に失敗しました。 | データコンテナ操作の例外情報を参照してください。
02 | データコンテナへの電文設定に失敗しました。 | データコンテナ操作の例外情報を参照してください。

(S)

処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

ログ・トレースを採取して，保守員に連絡してください。

KDEE11003-E

Failed to open the connection. Service group name = サービスグループ名, Service name = サービス名, Adapter name = アダプタ名 Operation name = オペレーション名, Configuration file name = TP1/Client/J環境定義ファイル名, Exception information = 例外情報

接続先とのコネクションの確立に失敗しました。

(S)

処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

TP1/Client/Jの例外情報を参照して，原因を取り除いてください。

KDEE11004-E

The host name specified in the TP1/Client/J configuration file is invalid. Service group name = サービスグループ名, Service name = サービス名, Adapter name = アダプタ名, Operation name = オペレーション名, Configuration file name = TP1/Client/J環境定義ファイル名, Exception information = 例外情報

TP1/Client/J環境定義ファイルのdchostオペランドの指定が不正です。

(S)

処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

TP1/Client/J環境定義ファイルのdchostオペランドを正しく指定して，再度TP1アダプタを開始してください。

KDEE11005-E

The port number specified in the TP1/Client/J configuration file is invalid. Service group name = サービスグループ名, Service name = サービス名, Adapter name = アダプタ名, Operation name = オペレーション名, Configuration file name = TP1/Client/J環境定義ファイル名, Exception information = 例外情報

TP1/Client/J環境定義ファイルのポート番号の指定が不正です。

(S)

処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

TP1/Client/J環境定義ファイルのdcrapportオペランドを正しく指定して，再度TP1アダプタを開始してください。

KDEE11006-E

Cannot allocate the rap listener server resource. Service group name = サービスグループ名, Service name = サービス名, Adapter name = アダプタ名, Operation name = オペレーション名, Configuration file name = TP1/Client/J環境定義ファイル名, Exception information = 例外情報

RAPリスナーまたはRAPサーバで，メモリまたは管理テーブルのリソース不足が発生しました。

(S)

処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

RAPリスナーサーバが動作しているホストのメモリを確認してください。メモリ不足が発生している場合は，メモリを増やしたあと，再実行してください。

KDEE11007-E

Communication error occurred. Service group name = サービスグループ名, Service name = サービス名, Adapter name = アダプタ名, Operation name = オペレーション名, Configuration file name = TP1/Client/J環境定義ファイル名, Exception information = 例外情報

コネクション確立時に通信障害が発生しました。または，RAPサーバが起動されていないおそれがあります。

(S)

処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

通信障害の場合は，例外情報を参照して対処したあと，再度TP1アダプタを開始してください。

リモートAPI機能を使用する場合は，RAPサーバが正常に起動されているか確認してください。RAPサーバが起動されていないときは，起動したあとで再実行してください。

KDEE11008-E

rpcCall timed out. Service group name = サービスグループ名, Service name = サービス名, Adapter name = アダプタ名, Operation name = オペレーション名, Configuration file name = TP1アダプタの通信構成定義ファイル名, Exception information = 例外情報

サービス要求時にタイムアウトが発生しました。

(S)

処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

TP1アダプタの通信構成定義のwatch_time要素の指定値を確認し，対処した上で再実行してください。

KDEE11009-E

Input message length exceeded maximum length. Service group name = サービスグループ名, Service name = サービス名, Adapter name = アダプタ名, Operation name = オペレーション名, Configuration file name = TP1/Client/J環境定義ファイル名, Exception information = 例外情報

要求データの長さが最大値を超えています。

(S)

処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

要求データ長を送信可能な最大長以下にしたあと，再実行してください。

KDEE11010-E

Reply message length exceeded output buffer length. Service group name = サービスグループ名, Service name = サービス名, Adapter name = アダプタ名, Operation name = オペレーション名, Configuration file name = TP1アダプタの通信構成定義ファイル名, Exception information = 例外情報

受信バッファサイズの最大長を超えています。

(S)

処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

相手システムからの応答データサイズを確認してください。

応答データサイズがバッファサイズ以下の場合，TP1アダプタの通信構成定義ファイルに指定した受信バッファサイズが不足しています。正しい受信バッファサイズ（TP1アダプタの通信構成定義のrecv_buff_size要素で指定）を指定して，開発環境で再度TP1アダプタをパッケージングしてください。

KDEE11011-E

Specified service group name is not found. Service group name = サービスグループ名, Service name = サービス名, Adapter name = アダプタ名, Operation name = オペレーション名, Configuration file name = TP1アダプタの通信構成定義ファイル名, Exception information = 例外情報

指定されたサービスグループは存在しません。

(S)

処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

正しいサービスグループ名（TP1アダプタの通信構成定義のservice_group要素で指定）を指定して，開発環境で再度TP1アダプタをパッケージングしてください。

KDEE11012-E

Specified service name is not found. Service group name = サービスグループ名, Service name = サービス名, Adapter name = アダプタ名, Operation name = オペレーション名, Configuration file name = TP1アダプタの通信構成定義ファイル名, Exception information = 例外情報

指定されたサービスは存在しません。

(S)

処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

正しいサービス名（TP1アダプタの通信構成定義のservice要素で指定）を指定して，開発環境で再度TP1アダプタをパッケージングしてください。

KDEE11013-E

Specified service group is closed. Service group name = サービスグループ名, Service name = サービス名, Adapter name = アダプタ名, Operation name = オペレーション名, Configuration file name = TP1/Client/J環境定義ファイル名, Exception information = 例外情報

指定されたサービスグループは閉塞されています。

(S)

処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

サービスグループの状態を確認し，サービスグループが閉塞されていない状態で再実行してください。

KDEE11014-E

Specified service is not running. Service group name = サービスグループ名, Service name = サービス名, Adapter name = アダプタ名, Operation name = オペレーション名, Configuration file name = TP1/Client/J環境定義ファイル名, Exception information = 例外情報

指定されたサービスが起動されていません。サービスが停止処理中であるか，またはOpenTP1が起動されていないおそれがあります。

(S)

処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

サービスが正常に起動されていることを確認して，再実行してください。

KDEE11015-E

No memory in specified service. Service group name = サービスグループ名, Service name = サービス名, Adapter name = アダプタ名, Operation name = オペレーション名, Configuration file name = TP1/Client/J環境定義ファイル名, Exception information = 例外情報

指定されたサービスの実行時に，メモリ不足が発生しました。

(S)

処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

サービスが起動されているホストのメモリを確認し，メモリを増やしたあと再実行してください。

KDEE11016-E

Reply message length is invalid. Service group name = サービスグループ名, Service name = サービス名, Adapter name = アダプタ名, Operation name = オペレーション名, Configuration file name = TP1/Client/J環境定義ファイル名, Exception information = 例外情報

応答データの長さが0であるか，または最大長を超えています。

(S)

処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

サービスの応答データを確認して，再実行してください。

KDEE11017-E

No access permission to requesting SPP. Service group name = サービスグループ名, Service name = サービス名, Adapter name = アダプタ名, Operation name = オペレーション名, Configuration file name = TP1/Client/J環境定義ファイル名, Exception information = 例外情報

サービス要求先のSPPがセキュリティ機能で保護されているため，このSPPを呼び出すアクセス権がありません。

(S)

処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

サービス要求先のSPPに対するアクセス権を確認して，再実行してください。

KDEE11018-E

Target SPP is in the test mode. Service group name = サービスグループ名, Service name = サービス名, Adapter name = アダプタ名, Operation name = オペレーション名, Configuration file name = TP1/Client/J環境定義ファイル名, Exception information = 例外情報

テストモードのSPPに対してサービス要求を行いました。

(S)

処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

サービス要求先のSPPの動作モードを確認して，再実行してください。

KDEE11019-E

Connection was closed. Service group name = サービスグループ名, Service name = サービス名, Adapter name = アダプタ名, Operation name = オペレーション名, Configuration file name = TP1/Client/J環境定義ファイル名, Exception information = 例外情報

RAPサーバとのコネクションが切断されました（TP1ClientクラスのrpcCallまたはrpcCallToメソッド呼び出しで，例外が発生しました）。

(S)

処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

例外情報について，マニュアル「OpenTP1 Version 7 分散トランザクション処理機能 OpenTP1 クライアント使用の手引 TP1/Client/J編」を参照して対処したあと，再実行してください。

KDEE11020-W

Failed to close the connection. Service group name = サービスグループ名, Service name = サービス名, Adapter name = アダプタ名, Operation name = オペレーション名, Configuration file name = TP1/Client/J環境定義ファイル名, Exception information = 例外情報

接続先とのコネクションの解放に失敗しました。

(S)

処理を続行します。

(O)

Cosminexus管理者に連絡してください。

対策

TP1/Client/Jの例外情報を参照して，原因を取り除いてください。

KDEE11021-E

Internal error occurred in TP1/Client/J. Service group name = サービスグループ名, Service name = サービス名, Adapter name = アダプタ名, Operation name = オペレーション名, Method name = TP1/Client/Jメソッド名, Exception information = 例外情報

TP1/Client/Jで内部エラーが発生しました。例外情報の意味は，次のとおりです。

メソッド名 | 例外情報 | 意味
rpcOpen | ErrIOErrException | 何らかの入出力例外が発生しました。
ErrProtoException | メソッドの発行順序に誤りがあります。
ErrSyserrException | システムエラーが発生しました。
setRpcextend | ErrInvalidArgsException | 引数の指定に誤りがあります。
openConnection | ErrIOErrException | 何らかの入出力例外が発生しました。
ErrSyserrException | システムエラーが発生しました。
ErrProtoException | メソッドの発行順序に誤りがあります。
ErrInvalidArgsException | 引数の指定に誤りがあります。
setWatchtim | ErrInvalidArgsException | 引数の指定に誤りがあります。
rpcCallまたはrpcCallTo | ErrInvalidArgsException | 引数の指定に誤りがあります。
ErrProtoException | メソッドの発行順序に誤りがあります。
ErrSyserrAtServerException | 指定したサービスでシステムエラーが発生しました。
ErrSyserrException | システムエラーが発生しました。
ErrTrnchkException | ノード負荷バランスで機能使用時，複数SPPのトランザクション属性が一致していません。
ErrServerBusyException | ソケット受信型サーバが要求を受信できません。
ErrServiceTerminatedException | サービス要求したSPPが異常終了しました。
ErrIOErrException | 何らかの入出力例外が発生しました。
rpcClose | ErrIOErrException | 何らかの入出力例外が発生しました。
ErrSyserrException | システムエラーが発生しました。
ErrNetDownException | ネットワーク障害が発生しました。
closeConnection | ErrIOErrException | 何らかの入出力例外が発生しました。
ErrSyserrException | システムエラーが発生しました。
ErrProtoException | メソッドの発行順序に誤りがあります。
ErrNetDownException | ネットワーク障害が発生しました。

(S)

処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

ログ・トレースを採取し，保守員に連絡してください。

KDEE11022-E

Internal error occurred. Adapter name = アダプタ名, Method name = 内部メソッド名, Exception information = 例外情報

TP1アダプタで内部エラーが発生しました。

(S)

処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

ログ・トレースを採取し，保守員に連絡してください。

KDEE11023-E

A shortfall of Connection resource. Service group name = サービスグループ名, Service name = サービス名, Adapter name = アダプタ名, Operation name = オペレーション名, Configuration file name = TP1アダプタの通信構成定義ファイル名

TP1アダプタの通信構成定義のcon_pool_num要素の指定値よりサービス要求数が多いため，コネクションリソースに空きがありません。

(S)

処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

サービス利用負荷が低い時に再実行してください。必要に応じてTP1アダプタの通信構成定義のcon_pool_num要素の指定値を修正したあと，再度TP1アダプタをパッケージングしてください。

KDEE11024-E

Input message length exceeded maximum length. Service group name = サービスグループ名, Service name = サービス名, Adapter name = アダプタ名, Operation name = オペレーション名, Configuration file name = TP1アダプタの通信構成定義ファイル名

送信バッファサイズが最大長を超えています。

(S)

処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

送信バッファサイズ（TP1アダプタの通信構成定義のsend_buff_size要素で指定）を最大長以下に変更して，再実行してください。

KDEE11025-E

A communication error occurred during a service request. (service group name = サービスグループ名, service name = サービス名, adapter name = アダプタ名, operation name = オペレーション名, configuration file name = TP1/Client/J環境定義ファイル名, exception information = 例外情報)

サービス要求時に通信障害が発生しました。または，RAPサーバが起動されていないおそれがあります。

(S)

処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

通信障害の場合は，例外情報を参照して対処したあとで再実行してください。

リモートAPI機能を使用している場合は，RAPサーバが正常に起動されているかどうかを確認してください。RAPサーバが起動されていない場合は，起動したあとで再実行してください。

KDEE11026-E

The host name specified in the TP1-adapter configuration file is invalid. (service group name = サービスグループ名, service name = サービス名, adapter name = アダプタ名, operation name = オペレーション名, configuration file name = TP1アダプタの通信構成定義ファイル名, exception information =例外情報)

TP1アダプタの通信構成定義ファイルのstatic_host要素の指定が不正です。

(S)

処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

開発環境でTP1アダプタの通信構成定義ファイルのstatic_host要素を正しく指定して，再度TP1アダプタをパッケージングしてください。

KDEE11027-E

The port number specified in the TP1-adapter configuration file is invalid. (service group name = サービスグループ名, service name = サービス名, adapter name = アダプタ名, operation name = オペレーション名, configuration file name = TP1アダプタの通信構成定義ファイル名, exception information =例外情報)

TP1アダプタの通信構成定義ファイルのstatic_port要素の指定が不正です。

(S)

処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

開発環境でTP1アダプタの通信構成定義ファイルのstatic_port要素を正しく指定して，再度TP1アダプタをパッケージングしてください。

KDEE11028-E

A timeout error occurred during a service request. (service group name = サービスグループ名, service name = サービス名, adapter name = アダプタ名, operation name = オペレーション名, configuration file name = TP1アダプタの通信構成定義ファイル名, exception information =例外情報)

サービス要求時にタイムアウトが発生しました。

(S)

処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

要求データ長を送信可能な最大長以下になるように対策して，再実行してください。

KDEE12000-I

TP1-adapter configuration analysis has been started. Adapter name = アダプタ名, Configuration file name = TP1アダプタの通信構成定義ファイル名

TP1アダプタの定義解析処理が開始しました。

(S)

処理を続行します。

KDEE12001-I

TP1-adapter configuration analysis has been normal finished. Adapter name = アダプタ名, Configuration file name = TP1アダプタの通信構成定義ファイル名

TP1アダプタの定義解析処理が正常終了しました。

(S)

処理を続行します。

KDEE12002-E

Verification error occurred in TP1-adapter configuration file. Adapter name = アダプタ名, Configuration file name = TP1アダプタの通信構成定義ファイル名

TP1アダプタの通信構成定義ファイルの解析でエラーが発生しました。

(S)

TP1アダプタの開始処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

このメッセージ以前に出力されているメッセージを参照して，原因を取り除いてください。

KDEE12003-E

TP1-adapter configuration file is not found. Adapter name = アダプタ名, Configuration file name = TP1アダプタの通信構成定義ファイル名

TP1アダプタの通信構成定義ファイルが存在しません。

(S)

TP1アダプタの開始処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

開発環境でTP1アダプタの通信構成定義ファイルを作成したあと，再度TP1アダプタをパッケージングしてください。

KDEE12004-E

XMLSchema file is not found. Adapter name = アダプタ名, XMLSchema file name = TP1アダプタの通信構成定義用XMLスキーマファイル名

TP1アダプタの通信構成定義解析用のXMLスキーマファイルが存在しません。

(S)

TP1アダプタの開始処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

実行環境でTP1アダプタの通信構成定義解析用のXMLスキーマファイルが削除されたか，TP1アダプタがインストールされていないおそれがあります。TP1アダプタのインストールディレクトリを確認してください。

KDEE12005-E

Operation name is already defined. Adapter name = アダプタ名, Configuration file name = TP1アダプタの通信構成定義ファイル名, Operation name = オペレーション名, Line number = 重複したオペレーション名を指定した行番号

オペレーション名はすでに定義されています。

(S)

TP1アダプタの開始処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

開発環境でオペレーション名（TP1アダプタの通信構成定義のop_name要素で指定）を修正したあと，再度TP1アダプタをパッケージングしてください。

KDEE12006-E

Verification error occurred in TP1-adapter configuration file. Adapter name = アダプタ名, Configuration file name = TP1アダプタの通信構成定義ファイル名, Line number = エラーが発生した行番号, Exception information = Cosminexus XML ProcessorメッセージIDおよびメッセージテキスト

TP1アダプタの通信構成定義ファイルの検証でエラーが発生しました。

(S)

TP1アダプタの開始処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

マニュアル「Cosminexus アプリケーションサーバ メッセージ 3」の「2.　KECX（Cosminexus XML Processorが出力するメッセージ）」を参照して，出力されたCosminexus XML ProcessorメッセージIDの記述内容を確認してください。そのあと，TP1アダプタの通信構成定義ファイルを修正して，再度TP1アダプタをパッケージングしてください。

KDEE12007-E

Internal error occurred. Adapter name = アダプタ名, Method name = 内部メソッド名, Exception information = 例外情報

TP1アダプタで内部エラーが発生しました。

(S)

TP1アダプタの開始処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

ログ・トレースを採取し，保守員に連絡してください。

KDEE12008-E

TP1-adapter properties file is not found. Adapter name = アダプタ名, Properties file name = TP1アダプタの実行環境プロパティファイル名, Exception information = 保守情報

TP1アダプタの実行環境プロパティファイルが存在しません。

(S)

処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

実行環境プロパティファイルを作成して，再度TP1アダプタを開始してください。

KDEE12009-E

Cannot access to the TP1-adapter properties file. Adapter name = アダプタ名, Properties file name = TP1アダプタの実行環境プロパティファイル名, Exception information = 保守情報

TP1アダプタの実行環境プロパティファイルにアクセスできません。セキュリティマネージャがファイルの読み込みを許可していないおそれがあります。

(S)

TP1アダプタの開始処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

TP1アダプタの実行環境プロパティファイルにアクセスできるように，適切なパーミッションをセキュリティポリシーファイルに記述する必要があります。対策後，再度TP1アダプタを開始してください。

KDEE12010-E

The TP1/Client/J configuration file path specified in the TP1-adapter properties file is invalid. Adapter name = アダプタ名, Properties file name = TP1アダプタの実行環境プロパティファイル名, Value = TP1アダプタの実行環境プロパティファイルで指定したtp1client.configプロパティの指定値

TP1アダプタの実行環境プロパティファイルのTP1/Client/J環境定義ファイルパス（tp1client.configプロパティ）の指定が不正です。

(S)

TP1アダプタの開始処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

実行環境プロパティファイルのtp1client.configプロパティを正しく指定して，再度TP1アダプタを開始してください。

KDEE12011-W

The message output level specified in the TP1-adapter properties file is invalid. Adapter name = アダプタ名, Properties file name = TP1アダプタの実行環境プロパティファイル名, Value = TP1アダプタの実行環境プロパティファイルで指定したmessage.levelプロパティの指定値

TP1アダプタの実行環境プロパティファイルのメッセージログ出力レベル（message.levelプロパティ）の指定が不正です。

(S)

メッセージログ出力レベルをデフォルト値に設定して処理を続行します。

(O)

Cosminexus管理者に連絡してください。

対策

必要に応じて実行環境プロパティファイルのmessage.levelプロパティを正しく指定して，再度TP1アダプタを開始してください。

KDEE12012-W

The trace output level specified in the TP1-adapter properties file is invalid. Adapter name = アダプタ名, Properties file name = TP1アダプタの実行環境プロパティファイル名, Value = TP1アダプタの実行環境プロパティファイルで指定したtrace.levelプロパティの指定値

TP1アダプタの実行環境プロパティファイルのトレースログ出力レベル（trace.levelプロパティ）の指定が不正です。

(S)

トレースログ出力レベルをデフォルト値に設定して処理を続行します。

(O)

Cosminexus管理者に連絡してください。

対策

必要に応じて実行環境プロパティファイルのtrace.levelプロパティを正しく指定して，再度TP1アダプタを開始してください。

KDEE12013-W

The trace file path specified in the TP1-adapter properties file is invalid. Adapter name = アダプタ名, Properties file name = TP1アダプタの実行環境プロパティファイル名, Value = TP1アダプタの実行環境プロパティファイルで指定したtrace.filepathプロパティの指定値

TP1アダプタの実行環境プロパティファイルのトレースファイルパス（trace.filepathプロパティ）の指定が不正です。

(S)

トレースファイルパスをデフォルト値に設定して処理を続行します。

(O)

Cosminexus管理者に連絡してください。

対策

必要に応じて実行環境プロパティファイルのtrace.filepathプロパティを正しく指定して，再度TP1アダプタを開始してください。

KDEE12014-W

The trace file size specified in the TP1-adapter properties file is invalid. Adapter name = アダプタ名, Properties file name = TP1アダプタの実行環境プロパティファイル名, Value = TP1アダプタの実行環境プロパティファイルで指定したtrace.filesizeプロパティの指定値

TP1アダプタの実行環境プロパティファイルのトレースファイルサイズ（trace.filesizeプロパティ）の指定が不正です。

(S)

トレースファイルサイズをデフォルト値に設定して処理を続行します。

(O)

Cosminexus管理者に連絡してください。

対策

必要に応じて実行環境プロパティファイルのtrace.filesizeプロパティを正しく指定して，再度TP1アダプタを開始してください。

KDEE12015-W

The trace file number specified in the TP1-adapter properties file is invalid. Adapter name = アダプタ名, Properties file name = TP1アダプタの実行環境プロパティファイル名, Value = TP1アダプタの実行環境プロパティファイルで指定したtrace.filenumプロパティの指定値

TP1アダプタの実行環境プロパティファイルのトレースファイル面数（trace.filenumプロパティ）の指定が不正です。

(S)

トレースファイル面数をデフォルト値に設定して処理を続行します。

(O)

Cosminexus管理者に連絡してください。

対策

必要に応じて実行環境プロパティファイルのtrace.filenumプロパティを正しく指定して，再度TP1アダプタを開始してください。

KDEE12016-E

Read of the TP1-adapter properties failed. Adapter name = アダプタ名, Properties file = TP1アダプタの実行環境プロパティファイル名, Exception information = 保守情報

TP1アダプタの実行環境プロパティファイルの読み込みに失敗しました。

(S)

TP1アダプタの開始処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

ログ・トレースを採取して，保守員に連絡してください。

KDEE12017-E

TP1-adapter configuration file path key("adptp1_deffile") is not found in the TP1-adapter environment file. Adapter name = アダプタ名, Environment file name = TP1アダプタの環境定義ファイル名

TP1アダプタの環境定義ファイル内にTP1アダプタの通信構成定義ファイルを指定する要素（adptp1_deffile）が見つかりません。

(S)

TP1アダプタの開始処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

開発環境でTP1アダプタの環境定義ファイルを修正したあと，再度TP1アダプタをパッケージングしてください。

KDEE12018-E

The specifications of one or more extension fault information option elements in a TP1 adapter environment definition file are invalid. (adapter name = アダプタ名, uCosminexus Service Adapter for TP1 environment definition file name = TP1アダプタの環境定義ファイル名)

TP1アダプタの環境定義ファイル内のエラー情報の拡張オプション（adptp1_fault_message_enable）要素の指定が不正です。

(S)

TP1アダプタの開始処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

開発環境でTP1アダプタの環境定義ファイルを修正したあと，再度TP1アダプタをパッケージングしてください。

KDEE12019-E

A host name element was not found in the TP1-adapter configuration file. (adapter name = アダプタ名, configuration file name = TP1アダプタの通信構成定義ファイル名)

TP1アダプタの通信構成定義ファイルで，static_host要素が見つかりません。

(S)

TP1アダプタの開始処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

開発環境でTP1アダプタの通信構成定義ファイルのstatic_host要素を正しく指定して，再度TP1アダプタをパッケージングしてください。

KDEE12020-E

A port number element was not found in the TP1-adapter configuration file. (adapter name = アダプタ名, configuration file name = TP1アダプタの通信構成定義ファイル名)

TP1アダプタの通信構成定義ファイルで，static_port要素が見つかりません。

(S)

TP1アダプタの開始処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

開発環境でTP1アダプタの通信構成定義ファイルのstatic_port要素を正しく指定して，再度TP1アダプタをパッケージングしてください。

KDEE12021-W

The memory allocation method (buffer.keep) specified in the TP1-adapter execution environment properties file is invalid. (adapter name = アダプタ名, properties file name = TP1アダプタの実行環境プロパティファイル名, value = buffer.keepプロパティの指定値)

TP1アダプタ実行環境プロパティファイル内のbuffer.keepプロパティの指定が不正です。

(S)

buffer.keep = trueを設定して処理を続行します。

(O)

Cosminexus管理者に連絡してください。

対策

必要に応じて実行環境プロパティファイルのbuffer.keepプロパティを正しく指定して，再度TP1アダプタを開始してください。

KDEE13000-E

The message-text file was not found.

メッセージテキストファイルが見つかりません。

(S)

TP1アダプタの開始処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

ログ・トレースを採取して，保守員に連絡してください。

KDEE13001-E

The message-level file was not found.

メッセージレベル定義ファイルが見つかりません。

(S)

TP1アダプタの開始処理を中止します。

(O)

Cosminexus管理者に連絡してください。

対策

ログ・トレースを採取して，保守員に連絡してください。

KDEE13002-W

Initialization of the method trace failed. Adapter name = アダプタ名 Method name = エラー発生メソッド名, Error information = 原因情報

メソッドトレースの初期化に失敗しました。

(S)

デフォルトの出力先にトレース出力し，処理を継続します。

(O)

Cosminexus管理者に連絡してください。

対策

障害要因が運用上の問題であった場合は再実行してください。

障害となった要因が運用上の問題ではない場合は，ログ・トレースを採取して，保守員に連絡してください。

KDEE13003-W

The method trace is unavailable because the default method trace output path could not be obtained. Adapter name = アダプタ名, Method name = エラー発生メソッド名, Error information = 原因情報

デフォルトのメソッドトレース出力先を得られなかったため，メソッドトレースが出力できません。

(S)

メソッドトレースを出力しない状態で処理を継続します。

(O)

Cosminexus管理者に連絡してください。

対策

ログ・トレースを採取して，保守員に連絡してください。

KDEE13004-W

Closing the method trace failed. Adapter name = アダプタ名, Method name = エラー発生メソッド名, Error information = 原因情報

メソッドトレースの終了処理に失敗しました。

(S)

終了処理を継続します。

(O)

Cosminexus管理者に連絡してください。

対策

障害要因が運用上の問題でないか確認してください。

障害となった要因が運用上の問題ではない場合は，ログ・トレースを採取して，保守員に連絡してください。

KDEE13005-W

An error occurred during output of method trace file. Adapter name = アダプタ名, Method name = エラー発生メソッド名, Error information = 原因情報

メソッドトレースの出力処理で障害が発生しました。

(S)

メソッドトレースの取得を中止し，処理を続行します。

(O)

Cosminexus管理者に連絡してください。

対策

障害要因が運用上の問題でないか確認してください。

障害となった要因が運用上の問題ではない場合は，ログ・トレースを採取して，保守員に連絡してください。

KDEE13006-W

Initialization of the data trace failed. Adapter name = アダプタ名, Method name = エラー発生メソッド名, Error information = 原因情報

データトレースの初期化に失敗しました。

(S)

デフォルトの出力先にトレース出力し，処理を継続します。

(O)

Cosminexus管理者に連絡してください。

対策

障害要因が運用上の問題であった場合は，再実行してください。

障害となった要因が運用上の問題ではない場合は，ログ・トレースを採取して，保守員に連絡してください。

KDEE13007-W

The data trace is unavailable because the default data trace output path could not be obtained. Adapter name = アダプタ名, Method name = エラー発生メソッド名, Error information = 原因情報

デフォルトのデータトレース出力先を得られなかったため，データトレースが出力できません。

(S)

データトレースを出力しない状態で処理を継続します。

(O)

Cosminexus管理者に連絡してください。

対策

ログ・トレースを採取して，保守員に連絡してください。

KDEE13008-W

Closing the data trace failed. Adapter name = アダプタ名, Method name = エラー発生メソッド名, Error information = 原因情報

データトレースの終了処理に失敗しました。

(S)

終了処理を継続します。

(O)

Cosminexus管理者に連絡してください。

対策

障害要因が運用上の問題でないか確認してください。

障害となった要因が運用上の問題ではない場合は，ログ・トレースを採取して，保守員に連絡してください。

KDEE13009-W

An error occurred during output of data trace file. Adapter name = アダプタ名, Method name = エラー発生メソッド名, Error information = 原因情報

データトレースの出力処理で障害が発生しました。

(S)

データトレースの取得を中止し，処理を続行します。

(O)

Cosminexus管理者に連絡してください。

対策

障害要因が運用上の問題でないか確認してください。

障害となった要因が運用上の問題ではない場合は，ログ・トレースを採取して，保守員に連絡してください。

6.　トラブルシューティング

TP1アダプタを運用しているときに発生する障害情報，および障害対策について説明します。

＜この章の構成＞

6.1　TP1アダプタでの障害情報

6.2　障害対策

6.1　TP1アダプタでの障害情報

TP1アダプタは，障害情報にエラー情報を使用して障害通知をします。エラー情報の各設定値を次の表に示します。

表6-1　TP1アダプタが設定するエラー情報

要素名 | 型 | 設定値 | 説明
faultCode | String | Client | 送られてきたメッセージの構成に異常があるなど，クライアント側のエラーです。
Server | 通信エラーなど，サーバ側のエラーです。
faultString | String | <TP1アダプタが出力するメッセージのメッセージテキスト> | 詳細は，「5.　メッセージ」を参照してください。
faultActor | String | <アダプタ名> | エラー情報を通知したアダプタ名です。
faultDetail※ | Document（XML） | 表6-2参照 | 表6-2を参照してください。

注※

faultDetailは次に示す形式で記述されています。

拡張障害情報を出力する場合

<?xml version="1.0" encoding="UTF-8"?>
<detail>
　　<content>・・・</content>
　　<factor>・・・</factor>
</detail>

拡張障害情報を出力しない場合

<?xml version="1.0" encoding="UTF-8"?>
<detail>
　　<content>・・・</content>
　　<factor>・・・</factor>
　　<messageId>・・・</messageId>
　　<message>・・・</message>
</detail>

faultDetailの各設定値は，次に示すとおりです。

表6-2　faultDetailの内容（共通要素）

content要素
設定値
factor要素
設定値
説明
対策

ResourceDeficiencyFault
（リソース不足）
internal
コネクションリソースが足りません。
RPC通信用の資源が不足しています。必要に応じて同時に処理できるRPC要求の最大数を増やしたあと，再度TP1アダプタを開始してください。

RpcErrorFault
（通信失敗）
other
接続先システムのエラーによって，RPC通信が失敗しました。
接続先システムの状態を確認してください。

internal
TP1アダプタ内部のエラーによって，RPC通信が失敗しました。
TP1アダプタの出力メッセージを確認して対策してください。

unexpected
予期しないエラーによって，RPC通信が失敗しました。
TP1アダプタ管理者に連絡してください。

AdapterFault
（内部障害）
internal
TP1アダプタ内部でエラーが発生しました。
TP1アダプタの出力メッセージを確認して対策してください。

DataErrorFault
（電文不正）
internal
電文のフォーマット不正によって，通信が失敗しました。
正しい電文フォーマットに修正したあと，再度要求してください。

（凡例）

internal：TP1アダプタの内部検出によるエラーです。

other：接続先システム状態の不正によるエラーです。

unexpected：予期しないエラーです。

表6-3　faultDetailの内容（オプション要素）

要素 | 説明
messageId | TP1アダプタが出力するエラーメッセージのメッセージIDです。
message | TP1アダプタが出力するエラーメッセージのメッセージテキストです。

RPC通信時の障害では，TP1/Client/Jが提供する例外に対応して，factor要素（原因）が異なります。TP1/Client/Jが提供する例外についての詳細は，「付録A　TP1/Client/Jの例外に対するfactor要素の対応表」を参照してください。

6.2　障害対策

＜この節の構成＞

6.2.1　TP1/Client/Jのトレース情報の採取

6.2.2　タイマ設定値の妥当性

6.2.1　TP1/Client/Jのトレース情報の採取

TP1/Client/Jは，トラブルシュート機能として，次のトレースを取得できます。

UAPトレース

データトレース

エラートレース

メモリトレース

メソッドトレース

デバッグトレース

性能解析トレース

性能検証用トレース

トラブルシュートを容易にするために，トレース情報の取得をお勧めします。障害発生時は，トレース情報を基に原因を調査してください。なお，障害発生時にトレースを取得していない場合は，トレースを取得するように設定したあと，障害が発生した現象を再現してトレース情報を取得してください。

トレース情報の詳細は，マニュアル「OpenTP1 Version 7 分散トランザクション処理機能 OpenTP1 クライアント使用の手引 TP1/Client/J編」の障害対策に関する内容を参照してください。

6.2.2　タイマ設定値の妥当性

TP1/Client/JのRPC通信を使用したシステムでは，障害の発生をリアルタイムに検出できません。したがって，障害検出の契機は時間監視のタイムアウト時です。時間監視値には，TP1アダプタの通信構成定義のwatch_time要素で最適な値を設定してください。

常設コネクションを確立する場合，RAPサーバへのコネクション確立中にRAPサーバ側でシステムダウンなどの障害があったときは，TP1アダプタではコネクションの解放を検知できません。このため，通信実行時に異常終了となります。この場合，TP1アダプタは，TP1アダプタの通信構成定義のwatch_time要素で指定した応答待ち時間を満了するまで待ったあとに障害通知します。

付録

＜この付録の構成＞

付録A　TP1/Client/Jの例外に対するfactor要素の対応表

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

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

付録D　用語解説

付録A　TP1/Client/Jの例外に対するfactor要素の対応表

RPC通信時に，TP1/Client/Jが提供する例外についてのfactor要素（要因）を次に示します。

コネクション確立処理（openConnectionメソッド）

表A-1　コネクション確立失敗時のfactor要素対応表

例外 | 説明 | 対応factor要素
ErrIOErrException | 何らかの入出力例外が発生しました。 | internal
ErrHostUndefException | rapリスナーのホスト名がTP1/Client/J環境定義のdchostオペランドに指定されていません。 | internal
ErrTimedOutException | rapリスナーとのコネクション確立中にタイムアウトが発生しました。 | other
ErrNetDownException | rapリスナーとの通信でネットワーク障害が発生したか，通信先のTP1/Server Baseが稼働していません。 | other
ErrNoBufsException | rapリスナーおよびrapサーバでメモリ不足が発生しました。 | other
ErrNotUpException | rapリスナーおよびrapサーバが稼働していません。 | other
ErrSyserrException | システムエラーが発生しました。 | internal
ErrProtoException | メソッドの発行順序に誤りがあります。コネクションを確立している間に再度openConnectionメソッドが呼び出されました。 | unexpected
ErrInvalidArgsException | 引数の指定に誤りがあります。 | unexpected

（凡例）

internal：TP1アダプタの内部検出によるエラーです。

other：接続先システム状態の不正によるエラーです。

unexpected：予期しないエラーです。

応答監視時間の設定（setdcwatchtimメソッド）

表A-2　応答監視時間設定失敗時のfactor要素対応表

例外 | 説明 | 対応factor要素
ErrInvalidArgsException | 引数の指定に誤りがあります。この場合，詳細メッセージに誤った引数名が設定されます。 | unexpected

（凡例）

unexpected：予期しないエラーです。

RPC通信要求（rpcCallメソッド）

表A-3　RPC通信失敗時のfactor要素対応表

例外
説明
対応factor要素

ErrInvalidArgsException
引数の指定に誤りがあります。この場合，詳細メッセージに誤った引数名が設定されます。
unexpected

ErrProtoException
メソッドの発行順序に誤りがあります。openConnectionメソッドが呼び出されていません。
unexpected

ErrNoBufsException
メモリ不足が発生しました。
internal

ErrNetDownException
ネットワーク障害が発生したか，通信先のTP1/Server Baseが稼働していません。
other

ErrTimedOutException
このメソッドの処理でタイムアウトが発生したか，サービス要求先SPPが処理を完了する前に異常終了しました。
other

ErrMessageTooBigException
in_len引数に指定した入力パラメタ長が最大値を超えています。
internal

ErrReplyTooBigException
サーバから返された応答の長さが，CUPで用意した領域（out_data引数の指定値）の長さを超えています。
other

ErrNoSuchServiceGroupException
group引数に指定したサービスグループ名は定義されていません。
internal

ErrNoSuchServiceException
service引数に指定したサービス名は定義されていません。
internal

ErrServiceClosedException
service引数に指定したサービス名が存在するサービスグループは閉塞されています。
other

ErrServiceTerminatingException
service引数に指定したサービスは終了処理中です。
other

ErrServiceNotUpException
サービス要求したSPPが稼働していないか，サービス要求したSPPが処理を完了する前に異常終了しました。この例外はTP1/Client/J環境定義にdcwatchtim=0を指定（応答を無限に待つ）した場合に返されます。
other

ErrNotUpException
指定したサービスが存在するノードのTP1/Server Baseが稼働していません。この場合，異常終了，停止中，終了処理中，およびネットワーク障害の発生が考えられます。
other

ErrSyserrAtServerException
指定したサービスでシステムエラーが発生しました。
other

ErrSyserrException
システムエラーが発生しました。
internal

ErrNoBufsAtServerException
指定したサービスでメモリ不足が発生しました。
other

ErrInvalidReplyException
サービス関数が返した応答の長さが1からDCRPC_MAX_MESSAGE_SIZEで指定した値までの範囲にありません。
other

ErrInitializingException
サービス要求したノードにあるTP1/Server Baseは開始処理中です。
other

ErrTrnchkException
ノード間負荷バランス機能を使用している環境で，複数のSPPのトランザクション属性が一致していません。または，負荷を分散する先のノードにあるTP1/Server Baseのバージョンが，TP1/Client/Jのバージョンよりも古いため，ノード間負荷バランス機能を実行できません。この例外は，ノード間負荷バランス機能を使用しているSPPにサービス要求した場合にだけ返されます。
internal

ErrServerBusyException
サービス要求先のソケット受信型サーバが，サービス要求を受信できません。
other

ErrSecchkException
サービス要求先のSPPは，セキュリティ機能で保護されています。rpcCallメソッドを呼び出したCUPには，SPPへのアクセス権限がありません。
other

ErrServiceTerminatedException
サービス要求したSPPが，処理を完了する前に異常終了しました。この例外はrapリスナーサービス定義のrpc_extend_functionオペランドに00000001を指定した場合にだけ返されます。rpc_extend_functionオペランドに00000000を指定，またはオペランドを省略した場合は，ErrTimedOutExceptionまたはErrServiceNotUpExceptionが返されます。
other

ErrIOErrException
何らかの入出力例外が発生しました。rapサーバが問い合わせ間隔の時間監視でタイムアウトし，コネクションを切断したことも考えられます。
internal

ErrTestmodeException
テストモードのSPPに対してサービス要求を行いました。
other

ErrConnfreeException
rapサーバとの常設コネクションが切断されました。または，TP1/Webとの擬似セションが切断されました。
other

ErrHostUndefException

rpcCallメソッドの場合

通信先となるTP1/Server Baseのホスト名がTP1/Client/J環境定義のdchostオペランドに指定されていないか，または指定に誤りがあります。

rpcCallToメソッドの場合

TP1アダプタ通信構成定義ファイルのstatic_host要素で，通信先となるTP1/Server Baseのホスト名の指定に誤りがあります。

internal

ErrInvalidPortException

rpcCallの場合

次の要因が考えられます。

リモートAPI機能を使用したRPCを行う場合，TP1/Client/J環境定義のdcrapportオペランドが指定されていません。

スケジューラダイレクト機能を使用したRPCを行う場合，TP1/Client/J環境定義のdcscdportオペランドが指定されていません。

rpcCallToの場合

TP1アダプタ通信構成定義ファイルのstatic_port要素で，通信先となるTP1/Server Baseのポート番号の指定に誤りがあります。

internal

（凡例）

internal：TP1アダプタの内部検出によるエラーです。

other：接続先システム状態の不正によるエラーです。

unexpected：予期しないエラーです。

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

TP1アダプタをバージョンアップする場合の，旧バージョンからの移行方法について説明します。

＜この節の構成＞

付録B.1　インストール

付録B.2　移行方法

付録B.1　インストール

旧バージョンのTP1アダプタに，上書きインストールする手順を次に示します。

TP1アダプタが登録されているHCSCサーバを停止します。

既存のインストールディレクトリをバックアップします。

新バージョンのTP1アダプタを上書きインストールします。

注意

インストールディレクトリを変更した場合は，TP1アダプタのadptp1rt.jarファイルへのクラスパスを変更する必要があります。変更方法については，「3.10　J2EEサーバ用オプション定義ファイルの編集」を参照してください。

付録B.2　移行方法

運用中のTP1アダプタをバージョンアップするには，カスタムアダプタの構成内容を入れ替えます。バージョンアップ時の移行方法を次に示します。

＜この項の構成＞

(1)　移行手順

(2)　サービスアダプタ定義（詳細）画面

(1)　移行手順

最初に，開発環境でTP1アダプタを用いたカスタムアダプタ定義を変更して，再パッケージングとリポジトリのエクスポートを行います。

次に，運用環境でリポジトリのインポートを行い，変更したカスタムアダプタを実行環境に再配布します。J2EEサーバは再起動してください。

TP1アダプタのバージョンアップ時の移行手順を次の図に示します。

図B-1　バージョンアップ時の移行手順

(2)　サービスアダプタ定義（詳細）画面

サービスアダプタ定義（詳細）画面を次の図に示します。

図B-2　サービスアダプタ定義（詳細）画面

サービスアダプタ定義（詳細）画面で，ユーティリティクラスに定義されているadptp1pc.jarを削除して，新しいadptp1pc.jarを登録する手順について説明します。

ユーティリティクラス（JARファイル）のadptp1pc.jarを選択して，［削除］ボタンをクリックします。

ユーティリティクラスの［追加］ボタンをクリックして，［ファイル選択］ダイアログで新しいバージョンのadptp1pc.jarを選択します。

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

このマニュアルを読むに当たっての参考情報を示します。

＜この節の構成＞

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

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

付録C.3　このマニュアルで使用している略語

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

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

このマニュアルに関連するマニュアルを次に示します。

Cosminexus アプリケーションサーバ V8 リファレンス 定義編(サーバ定義)（3020-3-U15）

Cosminexusのシステムを構築・運用するとき，またはアプリケーションを開発するときに，使用するファイルの形式について説明しています。

Cosminexus アプリケーションサーバ V8 アプリケーション開発ガイド（3020-3-U25）

構築したCosminexusのシステムで動作させる，アプリケーションの開発方法について説明しています。

Cosminexus アプリケーションサーバ V8 Cosminexus XML Processor　ユーザーズガイド（3020-3-U27）

Cosminexus XML Processorが提供するXMLパーサ・XSLTトランスフォーマ・JAXBの機能，作成方法，および使用方法について説明しています。

Cosminexus アプリケーションサーバ V8　メッセージ 3 KECX-KEDT／KEOS02000-29999／KEUC-KFRM編（3020-3-U43）

Cosminexus アプリケーションサーバで出力されるメッセージのうち，KECXからKEDTまでのメッセージ，KEOS02000からKEOS29999までのメッセージ，およびKEUCからKFRMまでのメッセージについて説明しています。

Cosminexus ビジネスプロセス管理/エンタープライズサービスバス V8 サービスプラットフォーム 概説（3020-3-U51）

Cosminexus サービスプラットフォームでSOAを適用したシステムを実現するための機能，および開発，運用の概要について説明しています。

Cosminexus ビジネスプロセス管理/エンタープライズサービスバス V8 サービスプラットフォーム 開発ガイド（3020-3-U52）

Cosminexus サービスプラットフォームを利用したシステムの開発について説明しています。

Cosminexus ビジネスプロセス管理/エンタープライズサービスバス V8 サービスプラットフォーム システム構築・運用ガイド（3020-3-U53）

Cosminexus サービスプラットフォームの機能，運用環境・実行環境の構築方法，および運用方法について説明しています。

また，上記のCosminexusのマニュアル以外で，このマニュアルと関連するマニュアルを次に示します。必要に応じてお読みください。

OpenTP1 Version 7 分散トランザクション処理機能　OpenTP1　解説（3000-3-D50）

OpenTP1 Version 7 分散トランザクション処理機能　OpenTP1　クライアント使用の手引　TP1/Client/J編（3000-3-D59）

TMS-4V/SP/Server（3000-3-167）

なお，このマニュアルでは，次のマニュアルについて，対象OSおよびバージョン番号を省略して表記しています。マニュアルの正式名称とこのマニュアルでの表記を次の表に示します。

正式名称 | このマニュアルでの表記
Cosminexus ビジネスプロセス管理/エンタープライズサービスバス V8 サービスプラットフォーム 概説 | Cosminexus サービスプラットフォーム 概説
Cosminexus ビジネスプロセス管理/エンタープライズサービスバス V8 サービスプラットフォーム 開発ガイド | Cosminexus サービスプラットフォーム 開発ガイド
Cosminexus ビジネスプロセス管理/エンタープライズサービスバス V8 サービスプラットフォーム システム構築・運用ガイド | Cosminexus サービスプラットフォーム システム構築・運用ガイド
Cosminexus アプリケーションサーバ V8 リファレンス 定義編(サーバ定義) | Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)
Cosminexus アプリケーションサーバ V8 アプリケーション開発ガイド | Cosminexus アプリケーションサーバ アプリケーション開発ガイド
Cosminexus アプリケーションサーバ V8 メッセージ 3 KECX-KEDT／KEOS02000-29999／KEUC-KFRM編 | Cosminexus アプリケーションサーバ メッセージ 3

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

このマニュアルで使用している表記と，対応する製品名を次に示します。

表記 | 製品名
DCCM3 | VOS1 DCCM3
VOS3 XDM/DCCM3
Eclipse | Eclipse Classic 3.6.1
TMS-4V/SP | Transaction Management System-4V/System Product
TMS-4V/SP/Server | Transaction Management System-4V/System Product/Server
TP1/Client/J | uCosminexus TP1/Client/J
TP1/Web | uCosminexus TP1/Web
TP1アダプタ | uCosminexus Service Adapter for TP1
uCosminexus Service Adapter Architect for TP1
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または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）

このマニュアルで使用している表記と，対応するCosminexusの機能名を次に示します。

表記 | Cosminexusの機能名
HCSC | Cosminexus Service Coordinator
HCSC-Data Transformまたはデータ変換基盤 | Cosminexus Service Coordinator - Data Transform
HCSC-DB AdapterまたはDBアダプタ連携基盤 | Cosminexus Service Coordinator - Database Adapter
HCSC-Messaging，HCSC-MSG，またはメッセージング基盤 | Cosminexus Service Coordinator - Messaging
HCSCTE | Cosminexus Service Coordinator Tools for Eclipse
MyEclipse | MyEclipse for Cosminexus

このマニュアルで使用している表記と，対応するJava関連用語を次に示します。

表記 | Java関連用語
EAR | Enterprise ARchive
EJBまたはEnterprise JavaBeans | Enterprise JavaBeansTM
J2EE | JavaTM 2 Platform, Enterprise Edition
J2SE | JavaTM 2 Platform, Standard Edition
Java | JavaTM

付録C.3　このマニュアルで使用している略語

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

英略語 | 英字での表記
API | Application Programming Interface
DB | Database
MDB | Message-Driven Bean
OS | Operating System
RPC | Remote Procedure Call
SOA | Service Oriented Architecture
SOAP | Simple Object Access Protocol
SPP | Service Providing Program
SSL | Secure Sockets Layer
TLS | Transport Layer Security
UAP | User Application Program
UNC | Universal Naming Convention
WSDL | Web Service Description Language
XML | Extensible Markup Language

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

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

付録D　用語解説

（英字）

CA（Certificate Authority）

認証局と呼ばれる，証明書を発行する機関です。

ほかのエンティティのために有効な証明書を発行する，信頼のおけるエンティティです。次に示す種類があります。

ルートCA
上位のCAによる認証を受けないで，自分の正当性を自ら証明します。

中間CA
自分の正当性を証明するために，上位のCAによる認証を受けています。

Eclipse

Eclipseプロジェクト（eclipse.org）が提供するオープンソースの統合開発環境です。ソースコードの編集支援機能やデバッグ機能など，アプリケーションの開発効率を向上させる各種機能を備えています。

Cosminexus サービスプラットフォームでは，Eclipseに必要な機能をプラグインして利用します。

HCSC-Data Transform（データ変換基盤）

データ変換定義に従って，要求電文・応答電文の電文フォーマットを変換する機能です。

HCSCTE

Cosminexus サービスプラットフォームの開発環境で利用する開発支援機能です。HCSCTEで提供される機能は，Eclipseにプラグインして利用します。

アダプタやビジネスプロセスの作成・定義機能などが含まれます。

HCSCコンポーネント

開発環境で作成するサービスアダプタ，DBアダプタ，ビジネスプロセス，およびユーザ定義受付の総称です。

HCSCサーバ

実行環境でサービス部品の実行を管理するサーバ機能です。メッセージング基盤，DBアダプタ連携基盤，ビジネスプロセス基盤，データ変換基盤など，実行環境に必要な機能が含まれます。また，リクエスタサービス，および連携サービスなどの機能も含まれます。

J2EEサーバ

アプリケーションを実行するためのサーバ基盤であるJ2EEコンテナを生成，実行する環境です。Cosminexus サービスプラットフォームは，J2EEサーバとしてCosminexus Component Containerを使用します。

MyEclipse

Javaアプリケーションの開発環境です。MyEclipseには，Eclipseでアプリケーションを開発するときに使用するプラグインがまとめられています。MyEclipseを使用すると，アプリケーションの作成，J2EEサーバへのアプリケーションのデプロイ，J2EEサーバの起動・停止，データベースの操作などができます。

Cosminexusでは，構成ソフトウェアとして，MyEclipseの日本語版環境であるMyEclipse for Cosminexusを提供しています。

RAPサーバ

リモートAPI接続時に，クライアントからの要求を代理実行するサービスです。

RAPリスナー

リモートAPI接続で，クライアントからのコネクション確立要求を受け付けるサービスです。

RPC

UAPを実行するプロセス間で通信する機能です。

SOAP

ネットワーク上のサービスを呼び出す際のメッセージを規定したものです。HTTPとXMLがベースとなっています。

SPP

OpenTP1のUAPのうち，ファイルへのアクセスなどサーバの役割をするプログラムです。

SSL（Secure Sockets Layer）

情報を暗号化してネットワークで送受信するためのプロトコルの一つです。

TLS（Transport Layer Security）

情報を暗号化してネットワークで送受信するためのプロトコルの一つです。SSLを基に改良が加えられたプロトコルです。

TP1/Client/J

WWWブラウザで動作するJavaアプレット，Javaアプリケーション，およびアプリケーションサーバで動作するJavaサーブレットから，OpenTP1のサーバUAPへRPCでサービスを要求するための製品です。

UAP

ユーザの業務をプログラムとして作成したものです。

uCosminexus Service Architect

Cosminexus サービスプラットフォームの開発環境を構築・運用するための製品です。

uCosminexus Service Platform

Cosminexus サービスプラットフォームの実行環境・運用環境を構築・運用するための製品です。

XMLスキーマ

W3C勧告で定められた仕様で，XML文書内の論理的なデータ構造を規定するための仕組みです。

XMLフォーマット定義ファイル

XML形式のデータを扱う場合に利用する電文フォーマット定義ファイルです。XMLスキーマファイルとして作成します。

（ア行）

アクティビティ

ビジネスプロセスの処理フローを定義する部品です。基本アクティビティと構造アクティビティに分類されます。複数のアクティビティを画面上に配置し，コネクションで連結して，ビジネスプロセスの処理フローを定義します。

アダプタ

Cosminexus サービスプラットフォームから，各種のソフトウェア部品をサービスとして呼び出すためのインターフェースとなるコンポーネントです。

アダプタには，サービスアダプタとカスタムアダプタがあります。

アダプタ名

TP1アダプタを識別する名称です。サービスアダプタ定義画面（基本）の「サービスID」で指定します。

運用環境

開発環境で作成したEARファイルをリポジトリから読み込み，実行環境に配備する環境です。また，実行環境で利用するHCSCサーバをセットアップします。実行環境での業務の運用を開始したあとは，システムの起動・停止，および状態を監視します。

応答電文

サービスの実行結果を返すための電文です。応答電文には，サービス部品からHCSCサーバに送信される電文と，HCSCサーバからサービスリクエスタに送信される電文があります。

（カ行）

開発環境

実行環境でサービス部品を呼び出すために必要なHCSCコンポーネントを作成したり，作成したHCSCコンポーネントをHCSCサーバおよびクラスタにどのように配備するか定義（配備定義）したりする環境です。

カスタムアダプタ

呼び出すサービスの種類が，Webサービス，SessionBean，MDB（WS-R），およびMDB（DBキュー）以外のアダプタです。

キーストア

秘密鍵，公開鍵，および証明書を持つ，保護されたデータベースです。

クライアント認証

サーバが，クライアントから送られてきたクライアントの証明書を基に，信頼できるクライアントかどうかを確認することです。

クラスタ

ある共通の機能を提供するサーバの集合です。

Cosminexus サービスプラットフォームでは，複数のHCSCサーバでクラスタを構成するロードバランスクラスタと，二つのHCSCサーバで実行系と待機系を構成するHAクラスタがあります。

公開鍵

特定のエンティティ（署名者）に関連づけられた数値です。

該当するエンティティとの間に信頼できる関係を持つ必要がある，すべての人に対して公開することを意図しています。署名の検証に使用されます。

コネクション

OpenTP1システムなどの接続先システムとの間に確立する論理的な通信路のことです。OpenTP1システムとはコネクション単位に送受信を行います。

（サ行）

サーバ認証

クライアントが，サーバから送られてきたサーバの証明書を基に，信頼できるサーバかどうかを確認することです。

サービス

業務と1対1に対応し，業務に必要な機能を再利用できるソフトウェア部品のことです。SOAでは，サービスを組み合わせて業務システムを構築します。これによって，業務の変化に対して，システムを迅速に変更できます。

サービスアダプタ

どのサービスを実行するかを定義したHCSCコンポーネントです。呼び出すサービス部品の種類（Webサービス，SessionBean，MDB（WS-R），MDB（DBキュー））ごとに定義する内容は異なります。

サービス部品

サービスアダプタおよびDBアダプタから実行できる業務処理のことです。Webサービス，SessionBean，MDB（WS-R），MDB（DBキュー），およびデータベースの操作をサービス部品として利用できます。

サービス部品電文

サービス部品独自の電文フォーマットを持った電文です。サービス部品がデータベースの操作の場合，DBアダプタ電文といいます。

サービスリクエスタ

HCSCサーバへサービスの実行要求（要求電文）を送信するアプリケーションです。HCSCサーバの標準受付が同期標準受付（Webサービス／SessionBean）か，非同期標準受付（MDB（WS-R）／MDB（DBキュー））か，またはユーザ定義受付（Webサービス）かによって，作成するサービスリクエスタの形式が異なります。

標準受付にサービスの実行を要求するサービスリクエスタを作成するときは，HCSCサーバに送信される要求電文の電文フォーマットを，標準電文に合わせる必要があります。

ユーザ定義受付にサービスの実行を要求するサービスリクエスタを作成するときは，サービスまたはビジネスプロセスに定義した電文フォーマット（WSDL）に合わせることができます。

システム構成定義

HCSCサーバおよびクラスタのセットアップ情報と，HCSCコンポーネントをHCSCサーバおよびクラスタにどのように配備するかの情報が含まれる定義情報です。

HCSCサーバおよびクラスタのセットアップ情報は，運用環境で更新されます。開発環境では，HCSCサーバおよびクラスタにHCSCコンポーネントをどのように配備するかの情報を定義します。

実行環境

サービスリクエスタで受け付けた実行要求に応じて，HCSCサーバを介して適切なサービス部品を呼び出し，業務を実行する環境です。

常設コネクション

コネクションを確立する契機となった要求が終了しても，コネクションを解放しないで利用し続ける確立方式です。

証明書

公開鍵証明書です。あるエンティティの識別情報および公開鍵の内容を証明します。証明書には，自己署名付き証明書と，CA（認証局）から発行された証明書があります。

性能解析トレース

Cosminexusシステムの性能解析をするためのトレース情報です。

（タ行）

データ変換

標準電文とサービス部品電文の電文フォーマットが異なる場合に，データ変換定義に従って，標準電文をサービス部品電文の電文フォーマットに変換することです。

データ変換定義

標準電文とサービス部品電文の電文フォーマットの相違を解消するためのデータ変換方法を定義したものです。標準電文とサービス部品電文の電文フォーマット定義ファイルの各要素をマッピングし，必要に応じてファンクションを設定して定義します。

電文フォーマット

要求電文および応答電文のデータ構造です。

サービスリクエスタからHCSCサーバに送信される要求電文の電文フォーマットは，標準電文の電文フォーマットに合わせる必要があります。標準電文とサービス部品に実行要求するための電文（サービス部品電文）の電文フォーマットが異なる場合は，データ変換定義を作成して，電文フォーマットの相違を解消します。

電文フォーマット定義ファイル

電文の構造（電文フォーマット）を定義したファイルです。XMLフォーマット定義ファイルとバイナリフォーマット定義ファイルとがあります。サービスの実行に利用する電文でXML形式のデータを扱う場合は，XMLフォーマット定義ファイルを，XML形式以外のバイナリ形式のデータを扱う場合は，バイナリフォーマット定義ファイルを利用します。

トラストストア

信頼できる証明書を格納したキーストアです。サーバ認証をする場合に，このトラストストアに格納されている証明書を基に，そのサーバが信頼できるかどうかが判断されます。

（ナ行）

ノード

データ変換定義画面で，ツリービューアに表示される各要素のことです。データ変換の元になる変換元ノードと，変換先になる変換先ノードがあります。

（ハ行）

バイナリフォーマット定義ファイル

XML形式以外のバイナリ形式のデータを扱う場合に利用する電文フォーマット定義ファイルです。XMLスキーマファイルとして作成します。バイナリ形式のデータ内の値の格納形式を定義し，定義した情報をXMLスキーマファイルに付加したファイル（拡張子：.fdx）です。

配備

HCSCコンポーネントを適切なHCSCサーバに配置することです。開発環境で作成したHCSCコンポーネントは，運用環境を利用して実行環境（HCSCサーバ）に配備します。

配備定義

開発環境で，HCSCコンポーネントをHCSCサーバおよびクラスタにどのように配備するか定義し，システム構成定義を更新することです。運用環境からHCSCコンポーネントを配備するときには，開発環境で配備定義したシステム構成定義の内容に従って配備します。

パッケージング

開発環境で作成したHCSCコンポーネントを，実行環境に配備できるようにEARファイルに組み立てることです。

ビジネスプロセス

複数のサービスコンポーネントを疎結合で連携させて，一連の業務の流れとして定義したサービスコンポーネントです。複数の基本アクティビティおよび構造アクティビティをコネクションで連結して定義します。

非常設コネクション

コネクションを確立する契機となった要求の処理が終了した場合に，そのつどコネクションを解放する確立方式です。

秘密鍵

特定のエンティティだけが知っている数値のことです。この数値を「エンティティの秘密鍵（または非公開鍵）」と呼びます。

秘密鍵は秘密にすることが前提です。秘密鍵と公開鍵は，すべての公開鍵暗号化システムで対になって存在します。

ファンクション

データ変換を定義する場合に，変換元ノードの値を加工して変換先ノードにマッピングする場合に使用するときの加工の方法を定義するものです。

文字列や数値を変換するファンクション，ノードの名称を取得するファンクション，条件による処理の選択や繰り返しを定義するファンクションなどがあります。

（マ行）

マッピング

データ変換を定義する場合に，変換元と変換先のノードを連結することです。マッピングの始点をマッピング元，終点をマッピング先といいます。

メソッドトレース

障害が発生し，原因の究明が困難な場合に必要な情報です。

（ヤ行）

ユーザ電文

サービスリクエスタから送信される要求電文です。

要求電文

サービスの実行を要求するための電文です。要求電文には，サービスリクエスタからHCSCサーバに送信される電文とHCSCサーバ内のアダプタからサービス部品に送信される電文があります。

（ラ行）

リクエスタサービス

サービスリクエスタからの要求電文を受け付けるための機能（インターフェース）です。HCSCサーバに含まれる機能です。リクエスタサービスを開始すると，サービスリクエスタからの要求電文を受け付けられる状態になります。

同期受付（Webサービス／SessionBean）および非同期受付（MDB（WS-R）／MDB（DBキュー））の要求を受け付けることができます。

リポジトリ

定義したHCSCコンポーネントやシステム構成定義を格納するディレクトリです。格納した情報は，リポジトリの管理機能（リポジトリのインポート／エクスポート機能）を利用して，開発環境と運用環境との間で受け渡しします。

索引

[Ｃ][Ｄ][Ｅ][Ｆ][Ｈ][Ｊ][Ｍ][Ｒ][Ｓ][Ｔ][Ｕ][Ｘ]
[ア行][カ行][サ行][タ行][ナ行][ハ行][マ行][ヤ行][ラ行]

(英字)

(Ｃ)

CA〔用語解説〕

(Ｄ)

dcrapautoconnectオペランドの指定によるメリットおよびデメリット

(Ｅ)

Eclipse〔用語解説〕

(Ｆ)

faultDetailの内容（オプション要素）

faultDetailの内容（共通要素）

(Ｈ)

HCSC-Data Transform〔用語解説〕

HCSCTE〔用語解説〕

HCSCコンポーネント〔用語解説〕

HCSCサーバ〔用語解説〕

HCSCサーバに通知する情報

(Ｊ)

J2EEサーバ〔用語解説〕

J2EEサーバ用オプション定義ファイルの編集

(Ｍ)

MyEclipse〔用語解説〕

(Ｒ)

RAPサーバ〔用語解説〕

RAPリスナー〔用語解説〕

RPC〔用語解説〕

RPC通信

RPC通信失敗時のfactor要素対応表

RPCのサービス要求方式

RPCの送受信バッファの生成

RPCの通信形態

(Ｓ)

SOAP〔用語解説〕

SPP〔用語解説〕

SSL〔用語解説〕

(Ｔ)

TLS〔用語解説〕

TP1/Client/J〔用語解説〕

TP1/Client/J環境定義の設定

TP1/Client/Jのトレース情報の採取

TP1/Client/Jの例外に対するfactor要素の対応表

TP1アダプタが設定するエラー情報

TP1アダプタでの障害情報

TP1アダプタの運用例

TP1アダプタの開始と停止

TP1アダプタの環境作成手順

TP1アダプタの環境定義ファイルの記載形式

TP1アダプタの環境定義ファイルの作成

TP1アダプタのサービスアダプタ定義画面（基本）の設定項目

TP1アダプタの設定項目の反映

TP1アダプタの追加・定義

TP1アダプタの通信構成定義およびTP1/Client/J環境定義の対応

TP1アダプタの通信構成定義ファイルの記載形式

TP1アダプタの通信構成定義ファイルの作成

TP1アダプタを使用したシステムの構成例

(Ｕ)

UAP〔用語解説〕

uCosminexus Service Adapter Architect for TP1

uCosminexus Service Adapter for TP1

uCosminexus Service Architect

uCosminexus Service Architect〔用語解説〕

uCosminexus Service Platform

uCosminexus Service Platform〔用語解説〕

uCosminexus TP1/Client/J

uCosminexus 日立コード変換 - Development Kit

uCosminexus 日立コード変換 - Runtime

uCosminexus 日立コード変換 - Server Runtime

(Ｘ)

XMLスキーマ〔用語解説〕

XMLフォーマット定義ファイル〔用語解説〕

(ア行)

(あ)

アクティビティ〔用語解説〕

アダプタ〔用語解説〕

アダプタ構成例

アダプタのサービスアダプタ定義（詳細）画面の設定項目

アダプタ名〔用語解説〕

(う)

運用

運用環境〔用語解説〕

(お)

応答監視時間設定失敗時のfactor要素対応表

応答電文〔用語解説〕

(カ行)

(か)

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

開発環境〔用語解説〕

開発環境のTP1アダプタのディレクトリ構成

開発環境の構成

開発環境を使用するためのセットアップ

概要

カスタムアダプタ〔用語解説〕

(き)

キーストア〔用語解説〕

機能

旧バージョンからの移行

(く)

クライアント認証〔用語解説〕

クラスタ〔用語解説〕

(こ)

公開鍵〔用語解説〕

構成

コネクション〔用語解説〕

コネクション確立失敗時のfactor要素対応表

(サ行)

(さ)

サーバ認証〔用語解説〕

サービス〔用語解説〕

サービスアダプタ〔用語解説〕

サービスアダプタ定義（詳細）画面

サービスアダプタ定義画面（基本）

［サービスアダプタ定義追加（汎用カスタムアダプタ）］ダイアログ

［サービスアダプタ定義追加］ダイアログ

サービス部品〔用語解説〕

サービス部品電文〔用語解説〕

サービスリクエスタ〔用語解説〕

(し)

時間監視

システム構成定義〔用語解説〕

実行環境〔用語解説〕

実行環境の構成

実行環境プロパティファイルの作成

障害情報の通知

障害対策

常設コネクション〔用語解説〕

常設コネクションを確立した場合の処理概要（オートコネクトモード）

常設コネクションを確立した場合の処理概要（非オートコネクトモード）

証明書〔用語解説〕

(す)

スケジューラダイレクト機能

スケジューラダイレクト機能使用時のTP1/Client/J環境定義

スケジューラダイレクト機能を使用した場合の処理の概要

スケジューラダイレクト機能を使用する場合

(せ)

性能解析トレース〔用語解説〕

設定

設定手順

設定前の準備

前提条件

(タ行)

(た)

タイマ設定値の妥当性

(つ)

通信形態による障害情報の通知

通信先を指定した接続

通信先を指定した接続をする場合

通信先を指定した場合の接続処理の概要

通信処理の運用中に監視時間に適用される値

通信処理の開始中および停止中に監視時間として適用される値

(て)

データ変換〔用語解説〕

データ変換（マッピング）の定義

データ変換基盤〔用語解説〕

データ変換定義〔用語解説〕

データ変換定義画面

電文フォーマット〔用語解説〕

電文フォーマット定義ファイル〔用語解説〕

(と)

同期応答型RPC通信

同期応答型RPC通信をする場合の処理の概要

トラストストア〔用語解説〕

トラブルシューティング

(ナ行)

(ね)

ネームサービス機能

ネームサービス機能使用時のTP1/Client/J環境定義

ネームサービス機能を使用した場合の処理の概要

ネームサービス機能を使用する場合

ネットワーク構成

(の)

ノード〔用語解説〕

(ハ行)

(は)

バイナリフォーマット定義ファイル〔用語解説〕

配備〔用語解説〕

配備定義〔用語解説〕

パッケージング〔用語解説〕

(ひ)

非応答型RPC通信

非応答型RPC通信をする場合の処理の概要

ビジネスプロセス〔用語解説〕

ビジネスプロセスを利用したエラー情報の参照

非常設コネクション〔用語解説〕

非常設コネクションを確立した場合の処理の概要（非オートコネクトモード）

秘密鍵〔用語解説〕

(ふ)

ファンクション〔用語解説〕

複数のコネクションが確立された場合の処理の概要（オートコネクトモード）

複数の接続先システムのサービスを呼び出す場合のアダプタ構成例

(マ行)

(ま)

マッピング〔用語解説〕

(め)

メソッドトレース〔用語解説〕

メッセージ

メッセージ一覧

メッセージの形式

メッセージの種類

(も)

目的

(ヤ行)

(ゆ)

ユーザ電文〔用語解説〕

(よ)

要求電文〔用語解説〕

用語解説

(ラ行)

(り)

リクエスタサービス〔用語解説〕

リポジトリ〔用語解説〕

リモートAPI機能

リモートAPI機能使用時のTP1/Client/J環境定義

リモートAPI機能を使用する場合

(ろ)

ログ取得

■ 商標類

AIXは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
AIX 5Lは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
AMDは，Advanced Micro Devices, Inc.の商標です。
HP-UXは，Hewlett-Packard Companyのオペレーティングシステムの名称です。
iWayおよびiWay Softwareは，Information Builders, Inc.の米国およびその他の国における登録商標です。
Javaは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
JDKは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Linuxは，Linus Torvalds氏の日本およびその他の国における登録商標または商標です。
Microsoftは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
MyEclipseは，米国Genuitec社の商品名称です。
OMG，CORBA，IIOP，UML，Unified Modeling Language，MDA，Model Driven Architectureは，Object Management Group, Inc.の米国及びその他の国における登録商標または商標です。
Red Hatは，米国およびその他の国でRed Hat, Inc. の登録商標もしくは商標です。
SOAP（Simple Object Access Protocol）は，分散ネットワーク環境においてXMLベースの情報を交換するための通信プロトコルの名称です。
UNIXは，The Open Groupの米国ならびに他の国における登録商標です。
W3Cは，World Wide Web Consortiumの商標（多数の国において登録された）です。
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/).