OpenTP1 Version 7　分散トランザクション処理機能　TP1/Server Base Enterprise Option 使用の手引

解説・手引・文法・操作書

3000-3-F51-80

前書き

対象製品

・適用OS：Red Hat Enterprise Linux Server 6 (64-bit x86_64)，Red Hat Enterprise Linux Server 7 (64-bit x86_64)，Red Hat Enterprise Linux Server 8 (64-bit x86_64)

P-8264-2A21 uCosminexus TP1/Server Base Enterprise Option(64) 07-93

・適用OS：Red Hat Enterprise Linux Server 9 (64-bit x86_64)

P-8864-2A21 uCosminexus TP1/Server Base Enterprise Option(64) 08-01

これらのプログラムプロダクトのほかにもこのマニュアルをご利用になれる場合があります。詳細は「リリースノート」でご確認ください。

輸出時の注意

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

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

商標類

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

発行

2025年4月　3000-3-F51-80

著作権

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

変更内容

変更内容（3000-3-F51-80）　uCosminexus TP1/Server Base Enterprise Option(64)　08-01，uCosminexus TP1/Server Base Enterprise Option(64)　07-93

追加・変更内容

変更個所

対象製品を更新した。

P-1M64-2A21，P-1M64-1A11，P-9S64-2A11，およびP-9W64-2A21を削除した。

Red Hat Enterprise Linux Server 8 (64-bit x86_64)をサポートした（P-8264-2A21）。

Red Hat Enterprise Linux Server 9 (64-bit x86_64)をサポートした（P-8864-2A21の追加）。

−

ipc_notify_response_host定義を追加した。

8章

RPC関連定義

eetrbtaskedコマンドの出力内容について，-eオプションにrまたはrbを指定した場合のトランザクション情報の「状態」の説明を変更した。

10章

eetrbtasked

コンテナオーケストレーションツールを使用したTP1/EEの構成と構築についての説明を追加した。

12章

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

はじめに

このマニュアルは，次に示すプログラムプロダクトの概要，定義方法，運用方法，および操作方法について説明したものです。

uCosminexus TP1/Server Base Enterprise Option(64)

以降，このマニュアルでは，これらのプログラムプロダクトを「TP1/EE」と表記します。

対象読者

システム管理者，システム設計者，プログラマ，およびオペレータの方を対象としています。

また，次に示す知識があることを前提としています。

オペレーティングシステム（Linuxなど）とオンラインシステムの基礎的な知識

TP1/EEとあわせて使用するTP1/Server Baseの知識

読書手順

TP1/EEの一連の関連マニュアルは，利用目的に合わせて，選択して読むことができます。次の案内に従ってお読みいただくことをお勧めします。

図中で使用する記号

このマニュアルの図中で使用する記号を，次のように定義します。

JISコード配列のキーボードとASCIIコード配列のキーボードとの違いについて

JISコード配列とASCIIコード配列では，次に示すコードで入力文字の違いがあります。このマニュアルの文字入力例（コーディング例）の表記は，JISコード配列（日本語のキーボード）に従った文字に統一しています。

コード

JISコード配列

ASCIIコード配列

(5c)₁₆

' ¥ '（円記号）

' ＼ '（バックスラッシュ）

(7e)₁₆

' ￣ '（オーバライン）

' ~ '（チルダ）

文法の記号

システム定義の説明，およびコマンドの説明に使用する各種の記号を説明します。

ここで説明する文法記述記号，属性表示記号および構文要素記号は，実際の定義には記述しません。

（1）文法記述記号

システム定義，コマンドのオプションおよび引数の指定方法について説明する記号です。

文法記述記号

意味

〔　　〕

この記号で囲まれている項目は省略してもよいことを示します。

（例）mysvgdef 〔-b〕

これは，mysvgdef -bと指定するか，mysvgdefと指定することを示します。

（例）〔-c レコード数〕

これは，何も指定しないか，または-cオプションで指定された項目は「レコード数」を値として取ることを示します。

…

この記号で示す直前の項目を繰り返し指定できることを示します。

（例）eetrblineed -v サービス名〔,サービス名…〕

これは，eetrblineedで指定するサービス名を複数個指定できることを示します。

｛｛　　｝｝

この記号で囲まれた複数の項目が一つの繰り返し項目の単位であることを示します。

（例）｛｛stsflgrp -g ファイルグループ番号｝｝

これは，stsflgrp -g ファイルグループ番号

stsflgrp -g ファイルグループ番号

と指定できることを示します。

｛　　｝

この記号で囲まれている複数の項目のうちから一つを選択することを示します。項目の区切りは｜で示します。

（例）｛-a｜-v サービス名｝

これは，-aと-v サービス名の二つの項目のうち，どちらかを指定することを示します。

｜

この記号で区切られた項目は選択できることを示します。

（例）service_hold=Y｜N

これは，service_holdオペランドに，YかNを指定できることを示します。

＿

（下線）

この記号で示す項目は，該当オペランド，またはオプションを省略した場合の省略時解釈値を示します。

（例）rpc_cmtsend_retry=Y｜N

これは，rpc_cmtsend_retryオペランドを省略した場合，Yを省略時解釈値とすることを示します。

△

半角スペースを示します。

（例）論理ファイル名△物理ファイル名

これは，論理ファイル名と物理ファイル名の間に半角スペースを挿入することを示します。

（2）属性表示記号

システム定義，およびコマンドのユーザ指定値の範囲などを説明する記号です。

属性表示記号

意味

〜

この記号のあとに指定値の属性を示します。

《　　》

指定を省略したときに仮定される値を示します。

〈　　〉

指定値の構文要素を示します。

((　　))

指定値の指定範囲を示します。

（3）構文要素記号

システム定義，およびコマンドのユーザ指定値の内容を説明する記号です。

構文要素記号

意味

〈英字〉

アルファベット（A〜Z，a〜z）と_（アンダスコア）

〈英字記号〉

アルファベット（A〜Z，a〜z）と#，@，¥，$，%

〈英数字〉

英字と数字（0〜9）

〈英数字記号〉

英字記号と数字（0〜9）

〈符号なし整数〉

数字列（0〜9）

〈16進数〉

数字（0〜9），A〜F，およびa〜f

〈識別子〉

先頭がアルファベットの英数字列

〈英大識別子〉

先頭がアルファベットの大文字の英数字列

〈記号名称〉

先頭が英字記号の英数字記号列

〈文字列〉

引用符「"」を除く任意の文字の配列※

〈パス名〉

記号名称，/，および　.（ピリオド）

（ただし，パス名は使用するOSに依存）

〈TP1EEファイル名〉

アルファベット（A〜Z，a〜z），数字（0〜9），　.（ピリオド），_（アンダスコア），および@で構成される文字列（最大14文字）

〈ホスト名〉

英数字，および!，#，$，%，&，'，(，)，*，+，-，.（ピリオド），/，;，<，=，>，?，@，[，¥，]，^，_（アンダスコア），{，|，}，~，,（コンマ）

ただし，OSによって使用できる文字が異なります。詳細は，使用しているOSのマニュアルを参照してください。

使用上の注意

すべて半角文字を使用してください。

注※

システム定義のオペランド，およびコマンドのオプションに文字列を指定する場合は，指定値全体を引用符「"」で囲む必要があります。この場合，指定値全体を囲む引用符は指定値には含まれません。また，特に断りがないかぎり，引用符は指定値の中の文字として使用できません。

注意事項

製品形名P-8864-2A21ではデータベースとしてOracleを使用できません。データベースはHiRDBだけ使用できます。

1　概要

この章では，TP1/EEの特長，システム形態，ソフトウェア構成，およびサービスについて説明します。

1.1　TP1/EEとは

TP1/EE（TP1/Server Base Enterprise Option）は，TP1/Server Baseとあわせて使用するオプション製品です。TP1/EEは，TP1/Server Baseにサービスを提供するUAP（SPP）として動作することによって，TP1/Server Baseの機能の一部をマルチスレッドで実現します。

TP1/Server BaseのSPPとしてTP1/EEを使用すると，現存する資産を生かしながら，メインフレーム基幹システムを，マルチスレッドで実現する大規模オープン基幹システムに移行できます。これによって，大規模・大量データ処理のコストパフォーマンスを向上させながら，高性能，高生産性および高信頼性を実装するOLTPを実現できます。

分散トランザクション処理機能を持つTP1/EEは，オープンシステム上でオンライントランザクション処理※（OLTP：Online Transaction Processing）をできるようにするソフトウェア（TPモニタ）です。

注※

データ通信業務では，業務処理ごとの単位に区切って，それぞれの処理の結果を有効にするか無効にするかを明確に決める必要があります。有効にするか無効にするかどちらかに決定する処理の単位をトランザクションといいます。

TP1/Server BaseとTP1/EEの特長を次の図に示します。

図1‒1　TP1/Server BaseとTP1/EEの特長

注意事項

TP1/EEは，TP1/Server Baseとあわせて使用するオプション製品です。したがって，以降の説明で「TP1/EE」とだけ記載されている場合は，TP1/Server Baseを省略して説明していることを意味します。説明上は省略されていても，実際にはTP1/Server BaseなしでTP1/EEを使用することはできないため，ご注意ください。TP1/EEとTP1/Server Baseとの関係の詳細については，「1.3　TP1/EEのソフトウェア構成」を参照してください。

1.1.1　TP1/Server Baseの特長

TP1/Server Baseの特長について説明します。TP1/EEはTP1/Server Baseとあわせて使用するため，TP1/Server Baseの特長は，TP1/EEを使用するときの特長でもあります。

(1)　トランザクション処理ができる分散コンピューティング環境の実現

TP1/Server Baseを使うと，資源・機能を適切に分散配置した，分散コンピューティング環境でのOLTPを実現できます。そのため，システム規模や業務量など，それぞれのシステム固有の状況に適した構成を柔軟に選択できます。

(2)　柔軟なシステム構成

TP1/Server Baseでは，分散コンピューティング環境でのOLTPを実現するために，UAPを含めたシステム構成が，クライアント／サーバ構造をしています。このため，プログラムやデータベースなどのソフトウェア資源を，ハードウェアの構成から独立させることができます。さらに，業務量の増加などでハードウェア構成を変更しても，ソフトウェア資源にはほとんど影響がありません。

(3)　基幹システムと連携した大規模システムの実現

TP1/Server Baseを使用したシステムは，VOS3システムなどの基幹システムと接続できます。このため，基幹システムの大容量データベース管理やネットワーク管理の業務に，TP1/Server Baseの分散コンピューティング環境を統合できます。その結果，基幹システムからワークステーションまでの広範囲にわたる大規模システムを実現できます。

(4)　オープンシステム化推進の支援

TP1/Server Baseの構造は，オープンシステムの標準化団体であるX/Openで規定しているDTPモデルに準拠しています。そのため，TP1/Server Baseで構築したOLTPシステムを使用すると，オープンシステムの利点を生かしたデータ通信システムを構築できます。

(5)　システム構築の高生産性と高信頼性の実現

分散コンピューティング環境でのビジネスアプリケーションのトランザクション処理には，高い生産性と信頼性が必要です。TP1/Server Baseでは，高い信頼性を要求される24時間運転業務に対応するため，システムの二重化を支援する機能（系切り替え機能）を備えています。系切り替え機能を使用すると，システムの障害による停止時間を最小限に抑えて，システム全体の稼働率を高め，生産性も向上できます。

1.1.2　TP1/EEの特長

TP1/EEをSPPとして動作させたときの，TP1/EE独自の特長について説明します。

(1)　マルチスレッドによる大規模・大量データ処理のコストパフォーマンス向上

TP1/EEでは，サービスのスケジュールや処理がマルチスレッドで動作します。このため，サービス単位の受け付け処理，サービス間で独立した処理，および複数サービスの均等処理が実現できます。さらに，一つのサービスに負荷が集中した場合は，業務処理を実行するスレッド数を動的に変更できます。その結果，大規模で大量なデータ処理のコストパフォーマンスを向上できます。

マルチスレッドでの処理を次の図に示します。

図1‒2　マルチスレッド処理

(2)　サーバアプリケーションで使用するメモリの確保・管理

TP1/EEがSPPで使用するメモリを確保・管理します。これによって，次のような，アプリケーション処理実行中のメモリ確保・解放に伴う性能への影響を防げます。

マルチスレッド上で動作しているスレッドのうち，一部のスレッドだけが異常終了した場合，異常終了したスレッドで確保したメモリの解放が困難になる

システムコールを不統一に使用すると，プログラムの移植性および保守性が低下する

(3)　OpenTP1システム以外の端末とのメッセージ通信

uCosminexus TP1/EE/Message Control Extension（MCP）を使用することで，OpenTP1が導入されていない端末とメッセージの送受信ができます。MCPでは，TCP/IPプロトコルまたはUDPプロトコルを使用したメッセージ通信ができます。

MCPの詳細については，マニュアル「TP1/EE/Message Control Extension 使用の手引」を参照してください。

(4)　インメモリデータ処理技術による高速トランザクション処理

インメモリデータ処理技術によるトランザクション処理の高速化と，高信頼性，高可用性を同時に実現するオンライントランザクション処理システムを構築できます（TP1キャッシュ機能）。TP1キャッシュ機能を使用するには，TP1/EEに加えて，uCosminexus TP1/EE/Extended Transaction Controller（XTC）およびuCosminexus TP1/EE/Extended Data Cache（XDB）が必要です。

XTCの詳細については，マニュアル「TP1/EE/Extended Transaction Controller 使用の手引」を，XDBの詳細については，マニュアル「TP1/EE/Extended Data Cache 使用の手引」を参照してください。

(5)　銀行勘定系サービス処理

uCosminexus TP1/Financial Service Platform（TP1/FSP）を使用することで，大規模な銀行勘定系サービス処理基盤を構築できます。

構造型データベースへのアクセス，オンラインバッチ（センタカット），オフラインバッチ，「全国銀行データ通信システム接続プロトコル」などに準拠した接続ができます。

TP1/FSPで使用する機能に応じて，MCPやTP1/Client/Wが必要です。

TP1/FSPの詳細については，TP1/FSPの関連ドキュメントを参照してください。また，MCPの詳細については，マニュアル「TP1/EE/Message Control Extension 使用の手引」を，TP1/Client/Wの詳細については，マニュアル「OpenTP1 クライアント使用の手引 TP1/Client/W，TP1/Client/P編」を参照してください。

1.2　TP1/EEのシステム形態

TP1/EEはTP1/Server Baseとあわせて使用します。このため，TP1/EEを使用したシステム（TP1/EEシステム）は，TP1/Server Baseと同様に次のような形態へ適用できます。

1.2.1　クライアント／サーバシステム（C/Sシステム）の形態

クライアント／サーバ方式で構築する，水平分散のシステム形態です。複数のTP1/EEシステムが，互いに協調して一つのオンラインシステムとして動作します。

業務を拡大するときは，必要なハードウェアを追加してシステムを拡張できます。ソフトウェア資源を煩雑に再編成する必要はありません。そのため，必要な規模に合わせたシステムを柔軟に構築できます。また，水平分散のトランザクション処理によるサーバ間の連携や，GUIのアプリケーションを使用したオンラインシステムにも対応しています。

クライアント／サーバシステム（C/Sシステム）の形態の例を次の図に示します。

図1‒3　クライアント／サーバシステム（C/Sシステム）の形態の例

注

このマニュアルでの「ノード」の意味は，ネットワークでつながれた，TP1/EEやTP1/Server Baseが稼働する一つのコンピュータ（マシン）のことです。

1.3　TP1/EEのソフトウェア構成

TP1/EEのソフトウェア構成の概要を次の図に示します。

図1‒4　TP1/EEのソフトウェア構成の概要（基本構成の場合）

注※

OpenTP1が導入されていないシステムとメッセージ通信する場合にMCPが必要です。

図1‒5　TP1/EEのソフトウェア構成の概要（TP1キャッシュ機能を使用する場合）

図1‒6　TP1/EEのソフトウェア構成の概要（銀行勘定系サービス処理基盤を構築する場合）

注※1

TP1/FSPを使用する場合は，リレーショナルデータベース，および構造型データベースが使用できます。

注※2

TP1/FSPで使用する機能に応じて，必要になります。

1.3.1　TP1/EEのソフトウェア製品

TP1/EEのソフトウェア製品と，関連するソフトウェア製品を次に示します。

(1)　TP1/EEの基本部分を構成する製品

TP1/EEシステムには，次に示す製品が必要です。

TP1/EE（TP1/Server Base Enterprise Option）

TP1/Server Base機能の一部をマルチスレッドで実現するオプション製品です。TP1/EEは，TP1/Server BaseのSPPとして動作します。

TP1/Server Base

分散トランザクション処理の基本制御をする製品です。トランザクションを制御したり，UAPをスケジュールしたりします。

(2)　TP1/EEのクライアント用マシンに必要な製品

TP1/EEのサーバへサービスを要求する，クライアント用マシンに必要な製品を次に示します。

TP1/Server Base

分散トランザクション処理の基本制御をする製品です。トランザクションを制御したり，UAPをスケジュールしたりします。

TP1/Client/W，TP1/Client/P

WSやPCをクライアント用マシンとして，TP1/EEのサーバへサービスを要求できるようにする製品です。

TP1/Client/J

Javaアプレット，Javaアプリケーション，またはJavaサーブレットから，TP1/EEのサーバへサービスを要求できるようにする製品です。

TP1/EEが，TP1/Client/W，TP1/Client/P，およびTP1/Client/Jと連携して動作する場合は，リモートAPI機能およびRPC通信を実現できます。TP1/Client/WおよびTP1/Client/Pについてはマニュアル「OpenTP1 クライアント使用の手引 TP1/Client/W，TP1/Client/P編」を，TP1/Client/Jについてはマニュアル「OpenTP1 クライアント使用の手引 TP1/Client/J編」を参照してください。

(3)　OpenTP1システム以外の端末とメッセージ通信をする場合に必要な製品

uCosminexus TP1/EE/Message Control Extension

通信先の相手システムにOpenTP1が導入されていない場合，TP1/EEでTCP/IPプロトコルおよびUDPプロトコルを使用したメッセージ通信を実現する製品です。

(4)　TP1キャッシュ機能を使用する場合に必要な製品

uCosminexus TP1/EE/Extended Transaction Controller

高速メッセージ処理基盤となる製品です。TP1/EE間でのシステム間通信（RPC）やメッセージの送受信を，UDPプロトコルを使用した独自のインタフェースによって実行する製品です。

uCosminexus TP1/EE/Extended Data Cache

高速データ処理基盤となる製品です。処理するデータすべてをメモリ上に展開することでディスクアクセスに掛かるオーバヘッドをなくして，トランザクションの処理性能を向上させる製品です。

(5)　銀行勘定系サービス処理基盤を構築する場合に必要な製品

uCosminexus TP1/Financial Service Platform

大規模な銀行勘定系サービス処理基盤となる製品です。

構造型データベースへのアクセス，オンラインバッチ（センタカット），オフラインバッチ，「全国銀行データ通信システム接続プロトコル」などに準拠した接続ができます。

uCosminexus TP1/EE/Message Control Extension

TP1/FSPで「全国銀行データ通信システム接続プロトコル」に準拠した通信をする場合に必要な製品です。

TP1/Client/W

TP1/FSPでオンラインバッチ機能を使用する場合に必要な製品です。

1.3.2　X/OpenのDTPモデルとTP1/EEシステムの関係

TP1/EEを使った分散トランザクション処理システムは，X/OpenのDTPモデルに準拠しています。X/OpenのDTPモデルの構成を次の図に示します。

図1‒7　X/OpenのDTPモデルの構成

(1)　DTPモデルの構成

DTPモデルは，次に示す要素から構成されます。

アプリケーションプログラム

システム利用者が高級言語で作成するアプリケーションプログラムです。TP1/EEのUAPのことです。アプリケーションプログラムは，TP1/EEシステムで使用できます。

トランザクションマネジャ

システムのトランザクションを管理して，資源の更新情報を基に一貫性を保証します。トランザクションマネジャは，TP1/EEシステムで使用できます。TP1/EEがトランザクションマネジャを提供しています。

リソースマネジャ

ユーザデータなどシステムの資源を管理します。リソースマネジャは，TP1/EEシステムで使用できます。TP1/EEシステムで使用できるリソースマネジャはHiRDBおよびOracleです。

コミュニケーションリソースマネジャ

システム間の通信に関する資源を管理します。コミュニケーションリソースマネジャは，TP1/EEシステムで使用できません。

(2)　各要素間のインタフェース

DTPモデルを構成する各要素は，次に示すインタフェースで連携できます。

TXインタフェース

アプリケーションプログラムからトランザクションマネジャへトランザクションの開始と終了を指示します。

XATMIインタフェース，TxRPCインタフェース

アプリケーションプログラムからコミュニケーションリソースマネジャへ通信を指示します。

XAインタフェース

トランザクションマネジャとリソースマネジャで資源の更新情報に基づいて同期を取ります。XAインタフェースは，TP1/EEシステムで使用できます。

XA+インタフェース

コミュニケーションリソースマネジャを使ってほかのシステムと通信する場合に，トランザクションマネジャで管理するトランザクションをほかのシステムの処理まで拡張します。

リソースマネジャが提供するインタフェース

アプリケーションプログラムからリソースマネジャへ資源の更新を指示します。リソースマネジャへのAPIには，SQLなどがあります。リソースマネジャが提供するインタフェースは，TP1/EEシステムで使用できます。

(3)　TP1/EEで構築するシステム

X/OpenのDTPモデルとTP1/EEで構築するシステムの関係の例を次の図に示します。

図1‒8　X/OpenのDTPモデルとTP1/EEで構築するシステムの関係の例

1.4　TP1/EEシステムのサービス

クライアント／サーバ構造に基づいたオンライントランザクション処理システムを構築するため，TP1/EEシステムでは，各種のサービス機能を使えます。ほかのプロセスから呼び出して利用できるプログラムの単位をサービス，サービスを提供するプロセスをサーバといいます。

TP1/EEのサービスをシステムサービスといいます。これに対して，ユーザで作成したUAPによって，業務処理としてサービスを提供するサーバをユーザサーバといいます。

1.4.1　TP1/EEのシステムサービス

TP1/EEで提供するシステムサービスを次に示します。（　）内の三文字の英字は，サービスを識別する名称です。

(1)　TP1/EEシステムの前提になるシステムサービス

トランザクションサービス（trn）

トランザクション処理の開始，終了，およびトランザクションの同期点取得による資源の更新処理を管理します。

スケジュールサービス（scd）

RPCのスケジュールや，マルチスレッドでのスケジュールを管理します。

ステータスサービス（sts）

トランザクションとは関連しない履歴情報を，専用のファイルに格納して管理します。

ロックサービス（lck）

トランザクション処理に伴う各種の排他制御を管理します。

ログサービス（log）

TP1/EEシステムからオペレータに内部情報を知らせるためのメッセージログを管理します。

タイマサービス（tim）

タイマトランザクションの監視時間，起動処理などを管理します。

メモリサービス（mem）

TP1/EEが使用するメモリ，およびユーザが使用するTP1/EEのメモリを管理します。

プロセスサービス（thd）

プロセス内のスレッドや，ハングアップ監視などの処理を管理します。

(2)　メッセージ関連のシステムサービス

DBキューサービス（dbq）

データベースをキューとして使用し，キューを介したメッセージ連携機能を提供します。

1.4.2　TP1/EEのシステム定義

TP1/EEの動作環境やTP1/EEが使う各種の資源は，システム定義に指定します。TP1/EEで使用するシステム定義は，次のように分けられます。

システムサービス定義

TP1/Server Baseの基本機能，ログサービス，ユーザサービスなどに関連する項目について定義します。

TP1/EEサービス定義

TP1/EEの基本機能，ファイルサービス，メモリなどに関連する項目について定義します。

システム定義の体系については，「7.1.1　定義の体系」を参照してください。

2　業務処理の形態

この章では，TP1/EEでできる業務処理の形態，TP1/EEと連携できるアプリケーションプログラム，およびTP1/EEで動作するスレッドについて説明します。

2.1　TP1/EEの通信形態

TP1/EEの通信形態は，RPCを使用したクライアント／サーバ形態です。RPCとは，UAPからほかのUAPへサービスを要求し，サービスを要求されたUAPは要求元のUAPへ処理結果を返す通信です。RPCを使用すると，通信相手のUAPがネットワーク上のどのノードにあるかを意識する必要はありません。

TP1/EEで使用する通信形態の概要について説明します。

2.1.1　クライアント／サーバ形態の通信

クライアント／サーバ形態の通信とは，TCP/IPプロトコルで接続したLANを介してメッセージを送受信することによって，相手システムと通信する方法です。メッセージの受信時，TP1/Server Baseを介さないでTP1/EEが直接受信することによって，効率良く処理できます。クライアント側およびサーバ側の形態を次に示します。

クライアント側（送信形態）

メッセージ送信では，同期応答型RPC，非同期応答型RPC，および非応答型RPCを使用して通信できます。非応答型RPCには，トランザクションに同期してメッセージを送信する形態と，UAPからの要求時点でメッセージを送信する形態があります。

サーバ側（受信形態）

メッセージ受信では，同期応答型RPC，非同期応答型RPC，および非応答型RPCを使用して通信できます。メッセージはTP1/EE内の受信スレッドが受信し，メッセージを格納する処理キューに登録します。

2.2　TP1/EEのアプリケーションプログラム

TP1/EEと連携できるUAPの概要について説明します。

サービス提供プログラム（SPP　Service Providing Program）

SPPは，サーバUAP（サービスを提供する側のUAP）およびクライアントUAP（サービスを要求する側のUAP）として動作します。クライアントUAPからの要求に対してサービスを提供したり，サーバUAPに対してサービスを要求したりします。SPPは，TP1/Server Baseが前提となります。TP1/EEは，TP1/Server BaseのSPPとして動作します。

SPPの詳細については，マニュアル「TP1/Server Base Enterprise Option プログラム作成の手引」を参照してください。

サービス利用プログラム（SUP　Service Using Program）

SUPは，クライアントUAP（サービスを要求する側のUAP）として動作する，クライアント専用のUAPです。サーバUAPに対してサービスを要求します。SUPは，TP1/Server Baseが前提となります。

SUPの詳細については，マニュアル「OpenTP1 プログラム作成の手引」を参照してください。

クライアントユーザプログラム（CUP　Client User Program）

CUPは，クライアントUAP（サービスを要求する側のUAP）として動作する，クライアント専用のUAPです。WSまたはPCから，TP1/Clientのライブラリ関数を使って，サーバUAPに対してサービスを要求します。CUPは，OpenTP1クライアント機能（TP1/Client/W，TP1/Client/P，またはTP1/Client/J）が前提となります。

CUPの詳細については，マニュアル「OpenTP1 クライアント使用の手引 TP1/Client/W，TP1/Client/P編」，またはマニュアル「OpenTP1 クライアント使用の手引 TP1/Client/J編」を参照してください。

2.3　TP1/EEのスレッド

TP1/EEのスレッドには，サービスを処理するための処理スレッドや，RPC通信メッセージを受信するための受信スレッドなどがあります。TP1/EEでは，一つのプロセス内で複数のスレッドを起動してマルチスレッドで処理することによって，同時に複数のUAPを実行できます。

TP1/EEで動作するスレッドと，各スレッドの処理内容を次の表に示します。

表2‒1　TP1/EEのスレッド一覧

スレッド名称

処理内容

メインスレッド

TP1/Server Baseから，TP1/EEプロセスで最初に起動されるスレッドです。

モニタスレッド

メインスレッドによって起動されるスレッドです。

TP1/EEの初期化処理，およびTP1/EE内の全スレッドの起動，終了，監視，終了待ち合わせをします。

シグナルスレッド

プロセス内の全シグナルを受信するスレッドです。

シグナル受信後，各シグナルに対応する処理をします。

TASKTMスレッド

トランザクション単位の統計情報などをTASKTMファイルや回線トレースファイルに出力するスレッドです。TASKTMスレッドには，次に示すスレッドがあります。

XDBトレーススレッド

XDBトレース情報を出力します。

PPトレーススレッド

MCPトレース情報を出力します。

統計情報スレッド

TP1/EEシステムの統計情報を出力します。

コマンドスレッド

コマンドプロセスからのコマンド要求を受信するスレッドです。受信したコマンド要求は処理キューに登録され，コマンドの処理は処理スレッドが行います。

処理スレッド

トランザクション処理をするスレッドです。システム定義で複数起動できます。処理スレッドには，次に示すスレッドがあります。

通常処理スレッド

予備処理スレッド

送信スレッド

コミット同期送信処理でエラーが発生した場合にリトライ送信をするスレッドです。プロセス関連定義のrpc_cmtsend_retryオペランドにNを指定した場合，リトライが無効になるため，このスレッドは起動されません。

また，送信スレッドは，TP1キャッシュ機能使用時にMCHメッセージの送信を行います。

受信スレッド

RPC通信でのメッセージを受信するスレッドです。受信したメッセージを基にサービスが処理キューに登録され，実際の処理は処理スレッドで行います。受信スレッドには，次に示すスレッドがあります。

応答受信スレッド

RPC要求メッセージへの応答メッセージや，トランザクション制御のメッセージを受信します。

rapクライアントスレッド

rapクライアントとして動作する場合に，rapサーバからのメッセージを受信します。

rap受信スレッド

rapサーバとして動作する場合に，rapクライアントからのメッセージを受信します。

DBキュー受信スレッド

DBキューを使用したシステム間のTCP/IP通信時に，イベント通知メッセージを受信します。

MCP受信スレッド

MCPのメッセージを受信します。

UDP受信スレッド

TP1キャッシュ機能使用時に，UDP通信のメッセージを受信します。

監視スレッド

トランザクション処理中のエラー発生時の回復を監視するスレッドです。監視スレッドには，次に示すスレッドがあります。

通信障害監視スレッド

トランザクション処理中に他プロセスとの通信障害が発生した場合の障害回復を監視します。

リソースマネジャ障害監視スレッド

トランザクション処理中にリソースマネジャ障害が発生した場合の障害回復を監視します。

履歴情報監視スレッド

UAP履歴情報取得機能を使用する場合に，UAP履歴情報グループ内で未使用の履歴情報表の数やスワップ処理の完了を監視します。UAP履歴情報取得機能については，TP1/FSPの関連ドキュメントを参照してください。

回復スレッド

トランザクションの回復処理をするスレッドです。プロセス関連定義のrecover_thread_noオペランドで複数起動できます。

ネームスレッド

ネームサービスを使用する場合に，TP1/Server Baseのネームサービスと連携するスレッドです。

転送スレッド

負荷を分散する場合に，自ノード内の他TP1/EEプロセス，または他ノードにRPCメッセージを転送するスレッドです。

系監視スレッド

HAモニタとの連携を行うスレッドです。

3　機能

この章では，TP1/EEの各種機能のうち，主な実現方法がオペランドやコマンドである機能について説明します。

この章で説明している機能の運用については，「6.　運用」を参照してください。また，主な実現方法がAPIである各種機能の詳細については，マニュアル「TP1/Server Base Enterprise Option プログラム作成の手引」を参照してください。

3.1　TP1/EEのリモートプロシジャコール通信

TP1/EEのライブラリ関数を使ったRPCについて説明します。

3.1.1　サービスの要求方法

クライアントUAPでは，サービス要求に必要な項目をdc_rpc_call関数またはee_rpc_call関数に設定してサーバUAPにサービスを要求します。サーバUAPは，複数のサービスを実行できます。サービスとは，RPCで呼び出す処理単位であり，各サーバUAPがクライアントUAPに提供する機能です。また，一つのサーバUAPが提供するサービスの集まりをサービスグループといいます。

クライアントUAPは，dc_rpc_call関数またはee_rpc_call関数にサービスグループ名およびサービス名を指定して，サーバUAPにサービスを要求します。TP1/Server Baseのネームサービスで，サーバUAPがあるノードのネットワークアドレスとサービスグループ名を管理しているので，ネットワーク上のどのノードにサーバUAPがあるかをクライアントUAPで意識する必要はありません。

これに対し，ee_rpc_call_to関数を使えば，特定のサービス要求先にサービスを要求できます。ee_rpc_call_to関数では，サービスグループ名とサービス名を引数に設定するのに加え，ホスト名またはノード識別子を指定して，特定のサービス要求先にサービスを要求します。通信先を指定したリモートプロシジャコールの詳細については，マニュアル「TP1/Server Base Enterprise Option プログラム作成の手引」を参照してください。

TP1/EEとTP1/Server BaseとのRPC通信で設定する必要があるシステム定義や関数については，「3.1.10　TP1/EEまたはTP1/Server BaseとRPC通信をする場合」を参照してください。

サービス要求を受け取ったサーバUAPから，さらに別のサービスを要求することもできます（RPCのネスト）。RPCでのサービスのネストの詳細については，マニュアル「TP1/Server Base Enterprise Option プログラム作成の手引」を参照してください。

3.1.2　リモートプロシジャコールの形態

RPCは，応答を受け取るかどうかで，応答型RPCと非応答型RPCに分類されます。RPCの種類を次の図に示します。

図3‒1　RPCの種類

(1)　同期応答型RPC

サービスを要求してから，応答が返ってくるのを待つRPCです。応答が返るまでの待ち時間を監視します。最大応答待ち時間を過ぎた場合，サービス要求はエラーリターンします。最大応答待ち時間は，RPC関連定義で指定します。

同期応答型RPCは，単純型RPCともいいます。

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

図3‒2　同期応答型RPCの処理概要

(2)　非同期応答型RPC

サービスを要求してから，応答が返ってくるのを待たないで，処理を続けるRPCです。応答を受信する関数を使って，応答を受信します。応答を受信する関数は，応答を受信するまで待ちます。この関数に設定した応答待ち時間を過ぎた場合，関数はエラーリターンします。

非同期応答型RPCは，ノーウェイト型RPCともいいます。

非同期応答型RPCの処理概要を次の図に示します。

図3‒3　非同期応答型RPCの処理概要

(3)　非応答型RPC

サービス要求の処理結果が戻らないRPCです。非応答型RPCでサービス要求をした場合，応答は受け取れません。サービスを要求したUAPは，処理を続けます。

非応答型RPCは，ノーリプライ型RPCともいいます。

非応答型RPCの処理概要を次の図に示します。

図3‒4　非応答型RPCの処理概要

3.1.3　ネームサービス

ネームサービスとは，TP1/Server Baseがある各ノードで，自ノードが管理している全サーバUAPのネーム情報（サービスグループ名，IPアドレス，ポート番号，負荷レベル，閉塞情報など）を管理する機能です。また，ネームサービス間では，ネーム情報を交換して，他ノードのネーム情報を取得します。このため，ネームサービスを使用すると，RPC通信をするときに，ネットワーク上のどのノードにサーバUAPがあるかをクライアントUAPで意識する必要はありません。

また，同一サービスグループ名のサーバUAPが複数起動されている場合は，ネームサービスが管理しているネーム情報を使用したノード間負荷バランス機能によって，最適なサーバUAPにサービスを要求できます。ノード間負荷バランス機能の詳細については，「3.1.4　ノード間負荷バランス機能」を参照してください。

ネームサービスを使用するかどうかは，RPC関連定義のname_useオペランドで指定します。ネームサービスを使用する場合，サービスの要求先の決定方法を，RPC関連定義のrpc_destination_modeオペランドで指定します。また，ネームサービスを使用してトランザクション連携をする場合は，サービスの要求元とサービスの要求先の両方でネームサービスを使用する必要があります。ネームサービスを使用しない場合は，サービスの要求先をサービスグループ情報関連定義のeesvgdef定義コマンドで指定します。

他プロセスのネーム情報は，TP1/Server Baseのネームサービスが提供するネーム情報検索機能を使用して検索します。そのため，TP1/Server Baseから検索できるネーム情報は，TP1/EEでも検索できます。また，検索したネーム情報は，TP1/EEプロセス内のキャッシュに格納されるため，次回の検索を高速に処理できます。

(1)　キャッシュ管理

TP1/EEは，ネームサービスから取得したネーム情報および自プロセスが登録したTP1/EEのネーム情報（サービスグループ名）を自プロセスのキャッシュに格納します。次回のネーム情報検索時に，該当するネーム情報がキャッシュにあれば，キャッシュに格納されていたネーム情報を使用します。このため，ネーム情報の検索を高速に処理できます。

(a)　キャッシュの追い出し

ネーム情報のサイズが，キャッシュ領域のサイズ（RPC関連定義のname_cache_sizeオペランドで指定）より大きい場合，TP1/EEはキャッシュに格納されている古いネーム情報を先入れ先出し方式（FIFO方式）で追い出し，空いた領域に新しいネーム情報を格納します。

キャッシュに格納されているネーム情報が頻繁に追い出されるとキャッシュ効率が低下するため，キャッシュの追い出し率をRPC関連定義のrpc_nam_eject_rateオペランドで指定します。このキャッシュの追い出し率を基に，追い出しキャッシュ数が算出されます。ただし，算出された追い出しキャッシュ数が，新しいネーム情報を格納するのに必要なキャッシュ数に満たない場合，またはRPC関連定義のrpc_nam_eject_rateオペランドに0を指定した場合は，新しいネーム情報を格納するのに必要なキャッシュ数を追い出します。

(b)　キャッシュ自動同期

次に示すどれかの条件を満たすネーム情報は，次回のネーム情報検索時にネームサービスで使用される可能性が高いため，キャッシュの有効期限（RPC関連定義のrpc_nam_use_timeオペランドで指定）が満了したときに，ネームスレッドで自動的に最新のネーム情報に更新されます（キャッシュ自動同期）。どの条件も満たしていないネーム情報は，キャッシュから削除されます。

RPC関連定義のrpc_nam_reserve_timeオペランドで指定したキャッシュの保留期間中に，該当するネーム情報が検索された場合

RPC関連定義のrpc_nam_use_timeオペランドで指定したキャッシュの有効期限内の検索回数が，RPC関連定義のrpc_nam_reserve_countオペランドで指定したキャッシュ自動同期を保留する回数以上あった場合

自TP1/EEプロセスのネーム情報（プロセス関連定義のservice_groupオペランドで指定）である場合

RPC関連定義のrpc_nam_reserve_countオペランドに1を指定している場合は，必ずキャッシュ自動同期を実行します。

(c)　eenamupdateコマンドによるキャッシュ即時更新

eenamupdateコマンド実行時は，コマンドの延長で指定サービスグループ名のネーム情報を取得し，キャッシュを更新します。

(2)　リトライ処理

ネームサービスを使用する場合，サービス要求メッセージの送信中に通信障害が発生したとき，または，サービス要求メッセージの送信先のサーバUAPが未起動などの旨の応答メッセージが返ってきたときは，リトライ処理を実行して，別のあて先にサービス要求メッセージを送信します。ネームサービスを使用しない場合は，リトライ処理を実行しません。

リトライ処理を実行するときのサービス要求先の決定方法は，RPC関連定義のrpc_destination_modeオペランドで指定します。rpc_destination_modeオペランドの指定値によって，リトライ処理の流れは次のように異なります。

rpc_destination_modeオペランドにnamdonlyを指定した場合のリトライ処理の流れ

ネームサービスから取得したあて先に，RPC関連定義のrpc_retry_countオペランドで指定した回数分，リトライ処理を実行します。※

RPC関連定義のrpc_retryオペランドにNを指定した場合は，1回だけリトライします。

rpc_destination_modeオペランドにnamdを指定した場合のリトライ処理の流れ

ネームサービスから取得したあて先に，取得したあて先分，またはRPC関連定義のrpc_retry_countオペランドで指定した回数分，リトライ処理を実行します。

RPC関連定義のrpc_retryオペランドにNを指定した場合は，1回だけリトライします。

サービスグループ情報関連定義のeesvgdef定義コマンドの-hオプションに指定したあて先に，指定したホストの数だけ，リトライ処理を実行します。

ネームサービスから取得したあて先に対するリトライ回数がRPC関連定義のrpc_retry_countオペランドの指定値以内である場合は，再度ネームサービスから取得したあて先に，RPC関連定義のrpc_retry_countオペランドで指定した回数分，リトライ処理を実行します。※

rpc_destination_modeオペランドにdefinitionを指定した場合のリトライ処理の流れ

サービスグループ情報関連定義のeesvgdef定義コマンドの-hオプションに指定したあて先に，指定したホストの数だけ，リトライ処理を実行します。

ネームサービスから取得したあて先に，RPC関連定義のrpc_retry_countオペランドで指定した回数分，リトライ処理を実行します。※

rpc_destination_modeオペランドにdefinitiononlyを指定した場合のリトライ処理の流れ

サービスグループ情報関連定義のeesvgdef定義コマンドの-hオプションに指定したあて先に，指定したホストの数だけ，リトライ処理を実行します。

注※

ネームサービスからのネーム情報取得に失敗した場合で，RPC関連定義のrpc_retryオペランドにYを指定したときは，次に示すオペランドの指定値に従ってリトライ処理を実行します。

リトライ回数

RPC関連定義のrpc_retry_countオペランド

リトライ間隔

RPC関連定義のrpc_retry_intervalオペランド

(3)　注意事項

ネームサービスへのネーム情報の登録に失敗すると，TP1/EEプロセスが終了します。ネーム情報の登録に失敗した場合の対策について，要因別に説明します。

キャッシュ領域のサイズ不足

キャッシュ領域のサイズが不足していると，ネーム情報の登録に失敗します。このため，TP1/Server Baseのネームサービス定義のname_cache_sizeオペランド，またはname_total_sizeオペランドで，キャッシュ領域のサイズに十分な値を指定してください。

同一TP1/Server Baseの管理下に同一サービスグループ名が存在

同一TP1/Server Baseの管理下に同一サービスグループ名のサーバが複数起動されていると，ネーム情報の登録に失敗します。このため，同一TP1/Server Baseの管理下にあるTP1/Server Baseのサービスグループ名（TP1/Server Baseのユーザサービス定義のservice_groupオペランドで指定），およびTP1/EEのサービスグループ名（プロセス関連定義のservice_groupオペランドで指定）が，それぞれ一意になるように指定してください。

ネーム情報を検索したときに受信するRPC応答メッセージのサイズは，最大約15キロバイトです。受信バッファサイズ（メモリ関連定義のrecv_message_buf_sizeオペランドで指定）が16キロバイト未満の場合，RPC応答メッセージの受信に失敗し，ネーム情報の検索に失敗することがあります。このため，ネームサービスを使用する場合は，受信バッファサイズに16キロバイト以上を指定することをお勧めします。なお，RPC関連定義のrpc_name_service_extendオペランドに1を指定している場合は，受信バッファサイズに32キロバイト以上を指定してください。

TP1/EEのサービスグループはTP1/Server Baseのネームサーバでネーム情報を管理するため，ネーム情報のノード識別子にTP1/Server Baseのノード識別子が設定されます。このため，TP1/EEのサービスグループに対してノード識別子を指定してdc_rpc_call_to関数を呼び出す場合は，TP1/Server Baseのノード識別子を指定してください。TP1/EEのノード識別子を指定した場合は，エラーリターンします。

ネームサービスを使用しない場合，RPCメッセージの送信先のノードでは，ノード間負荷バランス機能を使用したRPCメッセージの転送処理は行われません。また，RPCメッセージの送信先のノードに，該当するサービスグループ名が見つからなかった場合は，エラーリターンします。

3.1.4　ノード間負荷バランス機能

ノード間負荷バランス機能とは，負荷の軽いサーバを選択してRPCメッセージを送信または転送して，他ノードにある同じサービスグループ名のサーバUAP間でサービス処理の負荷を分散させる機能です。ノード間負荷バランス機能は，ネームサービスが稼働している場合に使用できます。

ノード間負荷バランス機能を使用する場合は，RPC関連定義のrpc_loadbalanceオペランドにYを指定してください。

なお，TP1キャッシュ機能を使用する場合，CLサーバでは実行系だけがノード間負荷バランス機能による監視の対象となります。また，MCPを使用する場合，端末キューに滞留するメッセージについては，ノード間負荷バランス機能による監視の対象外となります。

(1)　負荷レベル

RPCメッセージは，各ノードの負荷レベルに応じて送信されます。次に示す負荷レベルがあります。

LEVEL0

小さい負荷です。通常，RPCメッセージはLEVEL0またはLEVEL1のノードに送信されます。

LEVEL1

やや大きい負荷です。障害などによるRPCメッセージの再送受信時には，RPCメッセージはLEVEL1のノードに送信されにくくなります。ただし再送受信時にLEVEL1またはLEVEL2のノードしかない場合は，それらのノードに送信されます。

LEVEL2

大きい負荷です。通常，RPCメッセージはLEVEL2のノードに送信されません。ただし，LEVEL2のノードしかない場合は，LEVEL2のノードに送信されます。

各ノードの負荷レベルは，負荷レベル監視間隔（RPC関連定義のloadcheck_intervalオペランドで指定）ごとに監視されます。負荷レベルは，ユーザが選択した方法に従って決定されます。

注意事項

特定のサービスでの，単位時間当たりの処理数※を超えるサービス要求が，複数回の負荷レベル監視にわたって連続して発生した場合は，ノードの負荷が軽いときでも負荷レベルがLEVEL2に遷移します。この場合，処理スレッド数を見直して，サービス引き出しの多重度を上げてください。

注※

単位時間当たりの処理数は，次に示す計算式から算出される値です。

（1÷1サービス要求を処理する時間）×サービス引き出しの多重度

負荷レベルに変更があった場合は，各ノードのネームサービスに負荷レベルが通知され，サーバ情報が更新されます。

(2)　負荷レベルの決定方法

ユーザは，次に示す負荷レベルの決定方法を選択できます。

固定の処理キュー処理率をしきい値とした決定方法

ユーザが指定する処理キュー滞留率をしきい値とした決定方法

ユーザが指定する処理キュー滞留数をしきい値とした決定方法

負荷レベルの決定方法は，RPC関連定義のloadcheck_typeオペランドで指定します。

注意事項

負荷レベルの決定方法を選択するときは，次に示す点を考慮してください。

TP1キャッシュ機能を使用する場合，処理キューの処理数は同期点処理が完了したときに更新されます。UAPでee_scd_msg_receive関数を呼び出した場合，ee_scd_msg_receive関数で受信した処理キューは，そのサービスが終了するまで滞留しているものと見なされます。サービスが終了したあと，処理数が更新されます。

サービス閉塞時に処理キューを引き出し禁止にしている場合（ユーザサービス関連定義のforbid_draw_serviceオペランドにYを指定），閉塞中のサービスの処理キューの滞留数は減少しません。そのため，負荷レベルが高くなることがあります。

(a)　固定の処理キュー処理率をしきい値とした決定方法

今回の負荷レベルは，前回の負荷レベル，およびノード間負荷バランスで使用する処理キュー処理率によって決定されます。処理キュー処理率とは，次に示す計算式から算出される処理率です。

処理キュー処理率＝（負荷レベル監視間隔中に処理された処理キューの数÷前回の負荷レベルチェック時の処理キュー滞留数）×100

負荷レベルと処理キュー処理率について次の表に示します。

表3‒1　負荷レベルと処理キュー処理率

前回の負荷レベル

処理キュー処理率：q

今回の負荷レベル

LEVEL0

50 ≦ q

LEVEL0

q ＜ 50

LEVEL1

LEVEL1

75 ≦ q

LEVEL0

50 ≦ q ＜ 75

LEVEL1

q ＜ 50

LEVEL2

LEVEL2

q ＝ 100

LEVEL0

q ＜ 100

LEVEL2

固定の処理キュー処理率をしきい値とした決定方法での，負荷レベルが遷移する例を次の図に示します。

図3‒5　負荷レベルが遷移する例（固定の処理キュー処理率をしきい値とした決定方法の場合）

負荷レベルが遷移する負荷レベル監視のチェックポイントごとに説明します。

C₂（LEVEL0からLEVEL1への負荷レベルの遷移）

C₁時点の処理キュー滞留数（P₁）に対する，C₁からC₂までの負荷レベル監視間隔中に処理された処理キューの数（S₁）の割合である処理キュー処理率が50%未満になったため，負荷レベルはLEVEL0からLEVEL1に遷移します。

C₄（LEVEL1からLEVEL2への負荷レベルの遷移）

C₃時点の処理キュー滞留数（P₃）に対する，C₃からC₄までの負荷レベル監視間隔中に処理された処理キューの数（S₃）の割合である処理キュー処理率が50%未満になったため，負荷レベルはLEVEL1からLEVEL2に遷移します。

C₆（LEVEL2からLEVEL0への負荷レベルの遷移）

C₅時点の処理キュー滞留数（P₅）に対する，C₅からC₆までの負荷レベル監視間隔中に処理された処理キューの数（S₅）の割合である処理キュー処理率が100%になったため，負荷レベルはLEVEL2からLEVEL0に遷移します。

(b)　ユーザが指定する処理キュー滞留率をしきい値とした決定方法

今回の負荷レベルは，前回の負荷レベル，およびノード間負荷バランスでユーザが指定する処理キュー滞留率によって決定されます。処理キュー滞留率とは，次に示す計算式から算出される滞留率です。

処理キュー滞留率＝（負荷レベル監視時にキュー中に滞留している処理キューの数※1÷メモリ関連定義のpce_noオペランドで指定したサービス処理キュー数※2）×100

注※1

TP1キャッシュ機能を使用する場合，CLサーバの実行系で自動的に確保される処理キュー数（UDP受信スレッド数＋1）も別途確保されます。そのため，処理キュー滞留率が100%にならないことがあります。

注※2

TP1キャッシュ機能を使用する場合，XTC用ワーク領域（XTCPOOL）の確保によって，pce_noオペランドで指定した数以上のサービス処理キューを滞留させることができます。しかし，処理キュー滞留率を算出する場合，XTC用ワーク領域分については考慮されません（pce_noオペランドの指定値が計算式として使用されます）。そのため，処理キュー滞留率が100%を超えることがありますが，その場合でも100%として扱われます。

しきい値とする処理キュー滞留率の指定

RPC関連定義のlevelup_queue_rateオペランドおよびleveldown_queue_rateオペランドを次に示すとおりに指定することによって，サービスグループごとに処理キュー滞留率によって負荷レベルを決定するしきい値を指定できます。

set levelup_queue_rate = U1,U2
set leveldown_queue_rate = D0,D1

U1：サーバの負荷レベルがLEVEL1に上がったと判断する処理キュー滞留率

U2：サーバの負荷レベルがLEVEL2に上がったと判断する処理キュー滞留率

D0：サーバの負荷レベルがLEVEL0に下がったと判断する処理キュー滞留率

D1：サーバの負荷レベルがLEVEL1に下がったと判断する処理キュー滞留率

負荷レベルと処理キュー滞留率について次の表に示します。

表3‒2　負荷レベルと処理キュー滞留率

前回の負荷レベル

処理キュー滞留率：q

今回の負荷レベル

LEVEL0

q ＜ U1

LEVEL0

U1 ≦ q ＜ U2

LEVEL1

U2 ≦ q

LEVEL2

LEVEL1

q ≦ D0

LEVEL0

D0 ＜ q ＜ U2

LEVEL1

U2 ≦ q

LEVEL2

LEVEL2

q ≦ D0

LEVEL0

D0 ＜ q ≦ D1

LEVEL1

D1 ＜ q

LEVEL2

ユーザが指定する処理キュー処理率をしきい値とした決定方法での，負荷レベルが遷移する例を次の図に示します。

図3‒6　負荷レベルが遷移する例（ユーザが指定する処理キュー滞留率をしきい値とした決定方法の場合）

負荷レベルが遷移する負荷レベル監視のチェックポイントごとに説明します。ここでは，メモリ関連定義のpce_noオペランドで指定したサービス処理キュー数を2000とします。

C₂（LEVEL0からLEVEL2への負荷レベルの遷移）

メモリ関連定義のpce_noオペランドで指定したサービス処理キュー数に対する，C₂時点の処理キュー滞留数の割合（P₂）がU2以上になったため，負荷レベルはLEVEL0からLEVEL2に遷移します。

C₄（LEVEL2からLEVEL1への負荷レベルの遷移）

メモリ関連定義のpce_noオペランドで指定したサービス処理キュー数に対する，C₄時点の処理キュー滞留数の割合（P₄）がD1以下になったため，負荷レベルはLEVEL2からLEVEL1に遷移します。

C₆（LEVEL1からLEVEL0への負荷レベルの遷移）

メモリ関連定義のpce_noオペランドで指定したサービス処理キュー数に対する，C₂時点の処理キュー滞留数の割合（P₂）がD0以下になったため，負荷レベルはLEVEL1からLEVEL0に遷移します。

(c)　ユーザが指定する処理キュー滞留数をしきい値とした決定方法

今回の負荷レベルは，前回の負荷レベル，およびノード間負荷バランスでユーザが指定する処理キュー滞留数によって決定されます。処理キュー滞留数とは，負荷レベル監視時にキュー中に滞留している処理キューの数です。

しきい値とする処理キュー滞留数の指定

RPC関連定義のlevelup_queue_countオペランドおよびleveldown_queue_countオペランドを次に示すとおりに指定することによって，サービスグループごとに処理キュー滞留数によって負荷レベルを決定するしきい値を指定できます。

set levelup_queue_count = U1,U2
set leveldown_queue_count = D0,D1

U1：サーバの負荷レベルがLEVEL1に上がったと判断する処理キュー滞留数

U2：サーバの負荷レベルがLEVEL2に上がったと判断する処理キュー滞留数

D0：サーバの負荷レベルがLEVEL0に下がったと判断する処理キュー滞留数

D1：サーバの負荷レベルがLEVEL1に下がったと判断する処理キュー滞留数

TP1キャッシュ機能を使用する場合，CLサーバの実行系では，UDP受信スレッド数＋1の処理キューが自動的に確保されます。自動的に確保される処理キュー数分を引いてlevelup_queue_countオペランドおよびleveldown_queue_countオペランドを指定してください。

負荷レベルと処理キュー滞留数について次の表に示します。

表3‒3　負荷レベルと処理キュー滞留数

前回の負荷レベル

処理キュー滞留数：n

今回の負荷レベル

LEVEL0

n ＜ U1

LEVEL0

U1 ≦ n ＜ U2

LEVEL1

U2 ≦ n

LEVEL2

LEVEL1

n ≦ D0

LEVEL0

D0 ＜ n ＜ U2

LEVEL1

U2 ≦ n

LEVEL2

LEVEL2

n ≦ D0

LEVEL0

D0 ＜ n ≦ D1

LEVEL1

D1 ＜ n

LEVEL2

ユーザが指定する処理キュー処理数をしきい値とした決定方法での，負荷レベルが遷移する例を次の図に示します。

図3‒7　負荷レベルが遷移する例（ユーザが指定する処理キュー滞留数をしきい値とした決定方法の場合）

負荷レベルが遷移する負荷レベル監視のチェックポイントごとに説明します。

C₂（LEVEL0からLEVEL2への負荷レベルの遷移）

負荷レベル監視時にキュー中に滞留している処理キューの数（P₂）がU2以上になったため，負荷レベルはLEVEL0からLEVEL2に遷移します。

C₄（LEVEL2からLEVEL1への負荷レベルの遷移）

負荷レベル監視時にキュー中に滞留している処理キューの数（P₄）がD1以下になったため，負荷レベルはLEVEL2からLEVEL1に遷移します。

C₆（LEVEL1からLEVEL0への負荷レベルの遷移）

負荷レベル監視時にキュー中に滞留している処理キューの数（P₆）がD0以下になったため，負荷レベルはLEVEL1からLEVEL0に遷移します。

(3)　ノード間負荷バランス拡張機能

ユーザは次に示す指定ができます。

負荷監視インタバル時間の指定

RPC関連定義のloadcheck_intervalオペランドを指定すると，負荷監視インタバル時間を指定できます。負荷監視時に負荷レベルの変更があった場合は，各ノードのネームサービスに負荷レベルが通知されます。そのため，負荷監視インタバルごとにサーバ情報がネットワーク上に送信される可能性がありますので，必要以上に小さい値を指定しないでください。

loadcheck_intervalオペランドの指定を省略した場合の負荷監視インタバルは，30秒です。

通信障害時のリトライ回数の指定

通常，サービス要求のスケジュール時に通信障害が発生すると，再スケジュールしないでエラーリターンします。

RPC関連定義のscd_retry_of_comm_errorオペランドを指定することによって，通信障害が発生したノード以外へスケジュールするリトライ回数を指定できます。

ただし，scd_retry_of_comm_errorオペランドの指定値が，サービス要求の対象となるサービスグループが起動しているノード数を上回っている場合は，サービス要求の対象となるサービスグループが起動しているノード数をリトライ回数の上限値とします。ただし，scd_retry_of_comm_errorオペランドに0を指定した場合には，リトライしません。

(4)　ノード間負荷バランス機能によるRPCメッセージの送信先および転送先の決定

次に示す場合は，ノード間負荷バランス機能でRPCメッセージの送信先および転送先を決定します。

RPCメッセージの送信時

ee_rpc_call関数またはee_rpc_cmtsend関数を呼び出し，かつ送信先をネームサーバから取得する場合は，ノード間負荷バランス機能によってRPCメッセージの送信先を決定します。

RPCメッセージの送信先に指定されたサービスグループのノードがない場合は，エラーリターンします。指定されたサービスグループのノードが複数ある場合は，負荷レベルによって送信先を決定します。

RPCメッセージの送信先がTP1/Server Baseの場合，閉塞状態または未起動のサービスグループは，RPCメッセージの送信先に指定されません。

また，入力パラメタ長が従来のEERPC_MAX_MESSAGE_SIZEの最大値（1メガバイト）より大きい場合，EERPC_MAX_MESSAGE_SIZEの値を超えた入力パラメタに対応していないサービスグループは，送信の対象外となります。詳細は，「3.1.11　RPCメッセージの最大長拡張機能」を参照してください。

RPCメッセージの転送時

自ノードの負荷レベルがLEVEL2でRPCメッセージを受信した場合，ノード間負荷バランス機能によってRPCメッセージの転送先を決定します。

他ノードに同じ名称のサービスグループがない場合は，他ノードに転送しないで自ノードでサービス要求を処理します。他ノードに同じ名称のサービスグループがある場合は，ノード間負荷バランス機能によって，転送するかどうかおよび転送先を決定します。

RPCメッセージの転送先がTP1/Server Baseの場合，閉塞状態または未起動のサービスグループは，RPCメッセージの転送先に指定されません。

また，入力パラメタ長が従来のEERPC_MAX_MESSAGE_SIZEの最大値（1メガバイト）より大きい場合，EERPC_MAX_MESSAGE_SIZEの値を超えた入力パラメタに対応していないサービスグループは，送信の対象外となります。詳細は，「3.1.11　RPCメッセージの最大長拡張機能」を参照してください。

3.1.5　フラグメントメッセージ

RPCで送信するメッセージのサイズが32キロバイト，または送信バッファサイズ（メモリ関連定義のsend_message_buf_sizeオペランドで指定）を超えた場合，クライアント側でメッセージを複数のフラグメントに分割して送信します。複数のフラグメントに分割されたメッセージをフラグメントメッセージといいます。

サーバ側では，フラグメントメッセージを受信する際，受信スレッドですべてのフラグメントを受信するまで待ち合わせをします。フラグメントメッセージの待ち合わせ監視時間は3分とし，タイムアウト検知時はコネクションを切断します。すべてのフラグメントを受信したあと，処理キューにサービス登録要求をします。なお，フラグメントメッセージ受信に掛かる時間は，フラグメント化されていないメッセージの受信に掛かる時間よりも長くなります。

処理キューからサービスを引き出したあと，処理スレッドでフラグメントメッセージを組み立てます。フラグメントメッセージ組み立て時の最大全体長は8メガバイトです。

3.1.6　トランザクショナルRPC

RPCでは，サービス要求をしてから結果が返ってくるまでの処理をトランザクションとするかどうかをee_rpc_call関数の引数で指定できます。トランザクションとするRPCを，トランザクショナルRPCといいます。トランザクショナルRPCの場合は，複数のノードにわたって処理しているRPCでも，一つのトランザクションとして処理できます。

非応答型RPCでTP1/EEがクライアントの場合，メッセージの送信方法に即時送信とトランザクション同期型送信の2種類がありますが，即時送信で要求したRPCだけがトランザクショナルRPCになります。トランザクション同期型送信で要求したRPCは，トランザクショナルRPCになりません。

トランザクショナルRPCの詳細については，マニュアル「TP1/Server Base Enterprise Option プログラム作成の手引」を参照してください。

3.1.7　トランザクション処理結果によるRPC応答メッセージ送信

同期応答型RPCまたは非同期応答型RPCの場合，トランザクション処理結果に従ってRPC応答メッセージを送信できます。また，サービス関数の終了時に同期点処理で障害が発生した場合に，RPC応答メッセージの送信をERRTRNRの終了時まで抑止することもできます。

(1)　トランザクション処理結果に従ったRPC応答メッセージの送信

トランザクション処理結果に従ってRPC応答メッセージを送信するかどうかを，RPC関連定義のrpc_reply_tp1modeオペランドで指定できます。rpc_reply_tp1modeオペランドの指定を省略するか，またはYを指定した場合，トランザクション処理結果がコミットかロールバックかに関係なく，RPC応答メッセージを送信します。rpc_reply_tp1modeオペランドにNを指定した場合，トランザクション処理結果がコミットのときはRPC応答メッセージを送信し，ロールバックなどのコミット以外のときはRPCエラー応答メッセージを送信します。

プロセスダウン時に，トランザクション処理結果に応じてRPCエラー応答メッセージを送信したい場合は，RPC関連定義のrpc_reply_tp1mode_downオペランドにNまたはJを指定します。トランザクション処理結果に応じたRPCエラー応答メッセージを送信することによって，RPC要求元のクライアントUAPでの対処がしやすくなります。なお，トランザクション処理終了後にプロセスダウンした場合は，処理結果がコミットかロールバックかに関係なく，TP1/EE再開始時にRPCエラー応答メッセージを送信します。ただし，該当トランザクションが，リモートAPI機能による自サービスグループへの代理実行要求の場合は，この機能を使用できません。

(2)　ERRTRNRによるRPC応答メッセージの送信

RPC応答メッセージの送信をERRTRNRの終了時まで抑止する場合は，ERRTRNRによるRPC応答メッセージ送信機能を使用します。この機能を使用すると，RPC応答メッセージの送信をERRTRNRの終了時まで抑止することによって，UAPの性能が劣化しにくくなります。この機能を使用するには，次に示すように定義を指定する必要があります。

RPC関連定義のrpc_reply_errtrnrオペランドにYを指定

ユーザサービス関連定義のerrtrnrオペランドを指定

注意事項

rpc_reply_errtrnrオペランドにYを指定している場合に，errtrnrオペランドの指定を省略すると，プロセスダウンします。

リモートAPI機能による自サービスグループへの代理実行要求の場合は，この機能を使用できません。

この機能は，rpc_reply_tp1modeオペランドの指定値およびERRTRNR終了後のトランザクションの処理結果に関係なく，ルートトランザクションブランチであるサービストランザクションでの同期点処理でERRTRNRが起動された場合に動作します。ただし，DBキュー読み出し時のサービストランザクションでは動作しません。ERRTRNRによるRPC応答メッセージ送信処理の流れを次の図に示します。

図3‒8　ERRTRNRによるRPC応答メッセージ送信処理の流れ

クライアントUAPが応答型RPCでTP1/EEにサービスを要求します。TP1/EEはサービストランザクションを起動してサーバUAP1にサービスを要求します。

同期点処理で障害が発生したため，サービストランザクションでのRPC応答メッセージの送信を抑止します。

ユーザがサーバUAP1のサービス関数からサーバUAP2のサービス関数に情報を引き継ぎます。※

サービストランザクションが終了したあとで，ERRTRNRが開始します。

ERRTRNRはサーバUAP2にサービスを要求します。サーバUAP2からTP1/EEにサービス関数がリターンしたあとで，同期点処理が完了します。

2.で抑止していたRPC応答メッセージをERRTRNRが送信します。

注※

次に示す情報はTP1/EEがERRTRNRのサービス関数に引き継ぎます。それ以外のサービス関数の応答に必要な情報は，ユーザが引き継ぐ必要があります。

サービストランザクションのサービス関数のリターン時に設定したサービス関数の応答（out）およびサービス関数の応答の長さ（out_len）

トランザクションインタフェース情報の応答要否

障害が発生した場合の処理

サービストランザクションのサービス関数がリターンした時点からERRTRNRが起動されるまでの間にプロセスダウンが発生した場合，TP1/EE再開始時に，RPC要求元のクライアントUAPに対してRPCエラー応答※が送信されます。RPC応答メッセージは送信されません。

ERRTRNRの起動中にスレッドダウンまたはプロセスダウンが発生した場合は，RPC要求元のクライアントUAPに対してRPCエラー応答※が送信されます。

注※

RPCエラー応答には，EERPCER_TIMED_OUT，EERPCER_NO_BUFS_AT_SERVER，およびEERPCER_TRNCHK_EXTENDがあります。どのRPCエラー応答が送信されるかは，RPC関連定義のrpc_reply_tp1mode_downオペランドの指定値によって異なります。

3.1.8　サービス関数異常時のRPC応答メッセージ送信

同期応答型RPCまたは非同期応答型RPCの場合，トランザクション処理結果に従ってRPC応答メッセージを送信できます。また，サービス関数の処理中に障害（スレッドダウン）が発生した場合に，RPC応答メッセージの送信をERRTRN3の終了時まで抑止できます。

(1)　ERRTRN3によるRPC応答メッセージ送信

通常の応答型RPCでは，RPC受信したサービストランザクション起動時のサービス関数の引数として指定した応答データ格納領域（out）にUAPが応答データを格納します。格納された応答データを，サービス関数終了時にRPC応答メッセージとして送信します。

サービストランザクションで障害（スレッドダウン）発生時，ERRTRN3でRPC応答送信をするかどうかを，RPC関連定義のrpc_reply_errtrn3で指定できます。

RPC応答メッセージの送信をERRTRN3の終了時まで抑止する場合は，ERRTRN3によるRPC応答メッセージ送信機能を使用します。この機能を使用すると，RPC応答メッセージの送信をERRTRN3の終了時まで抑止し，RPC送信元にUAPが障害要因を連絡できます。この機能を使用するには，次のように定義を指定する必要があります。

RPC関連定義のrpc_reply_errtrn3オペランドにYを指定

ユーザサービス関連定義のerrtrn3オペランドを指定

rpc_reply_errtrn3に「Y」を指定した場合，サービストランザクション実行中のスレッドダウンを検知すると，ERRTRN3サービス終了時にそのサービストランザクションの応答送信をします。この応答送信は，ERRTRN3サービスで作成したRPC応答メッセージを使用します。

RPC応答メッセージは，ERRTRN3トランザクションインタフェース情報の応答（out）およびサービス関数の応答の長さ（out_len）に設定してください。

なお，サービストランザクション起動時のサービス関数とERRTRN3サービス関数のデータは，ユーザが引き継ぐ必要があります。

ただし，そのトランザクションが，リモートAPI機能（rap）による自サービスグループに対する代理実行要求の場合は，この機能を使用できません。ERRTRN3によるRPC応答メッセージ送信処理の流れを次の図に示します。

図3‒9　ERRTRN3によるRPC応答メッセージの送信処理の流れ

この機能は次の動作条件がすべて満たされた場合に動作します。

rpc_reply_errtrn3オペランドに「Y」を設定している。

サービストランザクション（MN）の処理中にスレッドダウンし，ERRTRN3起動事象が発生する。

ルートトランザクションブランチで発生する。

同期応答型RPCまたは非同期応答型RPCの応答送信をする。

(2)　障害時処理

サービストランザクションの異常終了検知からERRTRN3起動までの間にプロセスダウンが発生した場合，TP1/EEでの再開始時に該当するクライアントUAP（RPC要求元）に対して，RPCエラー応答を送信します。この場合，RPC応答メッセージは返信できません。クライアントUAP（RPC要求元）には，次のエラー要因を返します。

EERPCER_TIMED_OUT

EERPCER_TRNCHK_EXTEND

EERPCER_NO_BUFS_AT_SERVER

エラー要因についてはrpc_reply_tp1mode_downオペランドの設定値によって変わります。

なお，ERRTRN3内でスレッドダウンまたはプロセスダウンが発生した場合は，該当するクライアントUAP（RPC要求元）に対して，上記のRPCエラー応答を返信します。

ERRTRN3で応答送信に失敗した場合は，KFSB50396-Eメッセージを出力して処理を継続します。

また，ERRTRN3サービスは必ずユーザサービス関連定義（errtrn3オペランド）に設定する必要があります。

この機能使用時にerrtrn3オペランドの設定がない場合には，定義不正でTP1/EEプロセスの起動に失敗します。

3.1.9　別トランザクションによるRPC同期応答

サービス要求を受信したトランザクションとは別の任意のトランザクションから，サービス要求に対するRPC応答メッセージを送信できます。

サーバUAPで応答型RPCメッセージを受信したトランザクションは，ee_rpc_reply_suspend関数を呼び出すことによって，サービス終了時のRPC応答メッセージの送信を抑止します。また，メッセージを受信したトランザクションとは別のトランザクションでee_rpc_reply_send関数を呼び出すことによって，クライアントUAPにRPC応答メッセージを送信します。この機能は，応答型RPCメッセージを受信したルートトランザクションブランチだけで使用できます。ただし，該当トランザクションが，リモートAPI機能による自サービスグループへの代理実行要求の場合は，この機能を使用できません。詳細については，マニュアル「TP1/Server Base Enterprise Option プログラム作成の手引」を参照してください。

3.1.10　TP1/EEまたはTP1/Server BaseとRPC通信をする場合

TP1/EEとTP1/Server Base，またはTP1/EE同士がRPC通信をする場合に設定する必要があるシステム定義または関数について説明します。

TP1/Server Baseのシステム定義についてはマニュアル「OpenTP1 システム定義」を，TP1/Server Baseの関数についてはマニュアル「OpenTP1 プログラム作成リファレンス C言語編」またはマニュアル「OpenTP1 プログラム作成リファレンス COBOL言語編」を参照してください。

(1)　サービスの要求元とは別のノードにサービスがある場合

サービスの要求元とは別のノードにサービスがある場合，サービス要求をトランザクションにするかどうかを選択できます。

(a)　TP1/EEがサーバUAPで，TP1/Server BaseがクライアントUAPの場合

TP1/EEがサーバUAPで，TP1/Server BaseがクライアントUAPの場合，TP1/Server Base側で次に示す項目を設定する必要があります。

システム共通定義のrpc_datacompオペランド

Nを指定してください。

ユーザサービス定義のtrn_optimum_itemオペランド

asyncprepare以外を指定してください。

dc_rpc_call関数を使用してサービス要求をする場合

dc_rpc_call関数を使用してサービス要求をする場合のflags引数を次の表に示します。

表3‒4　dc_rpc_call関数のflags引数

RPCの種類

サービス要求

flags引数

同期応答型

トランザクションにする場合

DCNOFLAGS

トランザクションにしない場合

DCRPC_TPNOTRAN

非同期応答型

トランザクションにする場合

DCRPC_NOWAIT

トランザクションにしない場合

DCRPC_NOWAIT|DCRPC_TPNOTRAN

非応答型

トランザクションにする場合

DCRPC_NOREPLY

トランザクションにしない場合

DCRPC_NOREPLY|DCRPC_TPNOTRAN

TP1/Server Baseのネームサービスにサービス情報を問い合わせないで，直接TP1/EEに対してサービス要求をしたい場合は，次に示す定義を指定してください。

ユーザサービス定義のrpc_destination_modeオペランド

特に指定する必要はありません。デフォルト値（definition）のままとしてください。

ユーザサービスネットワーク定義のdcsvgdef定義コマンドの-hオプション

TP1/EEのサービスグループ情報関連定義のmysvgdef定義コマンドの-hオプションで指定したホスト名およびポート番号と同じ値を指定してください。

dc_rpc_call_to関数を使用してサービス要求をする場合

dc_rpc_call_to関数を使用してサービス要求をする場合のdirection引数およびflags引数を次に示します。

direction

DCRPC_BINDTBL_SET関数またはDCRPC_DIRECT_SCHEDULE関数を使用して作成したDCRPC_BINDING_TBL構造体のアドレスを指定してください。

flags

次の表に従ってflags引数を指定してください。

表3‒5　dc_rpc_call_to関数のflags引数

RPCの種類

サービス要求

flags引数

同期応答型

トランザクションにする場合

DCNOFLAGS

トランザクションにしない場合

DCRPC_TPNOTRAN

非同期応答型

トランザクションにする場合

DCRPC_NOWAIT

トランザクションにしない場合

DCRPC_NOWAIT|DCRPC_TPNOTRAN

非応答型

トランザクションにする場合

DCRPC_NOREPLY

トランザクションにしない場合

DCRPC_NOREPLY|DCRPC_TPNOTRAN

DCRPC_BINDTBL_SET関数の引数

DCRPC_BINDTBL_SET関数の引数の設定を次に示します。

nid

TP1/Server Baseのシステム共通定義のnode_idオペランドで指定したノード識別子と同じ値を指定してください。

hostnm

TP1/Server Baseのシステム共通定義のmy_hostオペランドで指定したホスト名と同じ値を指定してください。my_hostオペランドを省略，またはMYHOSTを指定している場合は，hostnameコマンドが返す名称を指定してください。

portno

TP1/Server Baseのシステム共通定義のname_portオペランドで指定したポート番号と同じ値を指定してください。

DCRPC_DIRECT_SCHEDULE関数の引数

DCRPC_DIRECT_SCHEDULE関数の引数の設定を次に示します。

hostnm

TP1/EEのサービスグループ情報関連定義のmysvgdef定義コマンドの-hオプションで指定したホスト名およびポート番号と同じ値を指定してください。

scdport

TP1/EEのサービスグループ情報関連定義のmysvgdef定義コマンドの-hオプションで指定したホスト名およびポート番号と同じ値を指定してください。

(b)　TP1/Server BaseがサーバUAPで，TP1/EEがクライアントUAPの場合

TP1/Server BaseがサーバUAPで，TP1/EEがクライアントUAPの場合，TP1/EE側で次に示す項目を設定する必要があります。

ee_rpc_call関数を使用してサービス要求をする場合

ee_rpc_call関数を使用してサービス要求をする場合のflags引数を次の表に示します。

表3‒6　ee_rpc_call関数のflags引数

RPCの種類

サービス要求

flags引数

同期応答型

トランザクションにする場合

EENOFLAGS

トランザクションにしない場合

EERPC_TPNOTRAN

非同期応答型

トランザクションにする場合

EERPC_NOWAIT

トランザクションにしない場合

EERPC_NOWAIT|EERPC_TPNOTRAN

非応答型

トランザクションにする場合

EERPC_NOREPLY

トランザクションにしない場合

EERPC_NOREPLY|EERPC_TPNOTRAN

ee_rpc_call_to関数を使用してサービス要求をする場合

ee_rpc_call_to関数を使用してサービス要求する場合のdirection引数およびflags引数を次に示します。

direction

EERPC_BINDING_TBL構造体のアドレスを指定してください。

flags

次の表に従ってflags引数を指定してください。

表3‒7　ee_rpc_call_to関数のflags引数

RPCの種類

サービス要求

flags引数

同期応答型

トランザクションにする場合

EENOFLAGS

トランザクションにしない場合

EERPC_TPNOTRAN

非同期応答型

トランザクションにする場合

EERPC_NOWAIT

トランザクションにしない場合

EERPC_NOWAIT|EERPC_TPNOTRAN

非応答型

トランザクションにする場合

EERPC_NOREPLY

トランザクションにしない場合

EERPC_NOREPLY|EERPC_TPNOTRAN

EERPC_BINDING_TBL構造体の引数

次の表に従ってEERPC_BINDING_TBL構造体の引数を設定してください。

表3‒8　EERPC_BINDING_TBL構造体の引数

サービス要求先の特定方法

EERPC_BINDING_TBL構造体の引数

nid

hostnm

portno

flags

ノード識別子を指定

TP1/Server Base（サーバ）側のサービス受信口となるノード識別子

NULL

0

EENOFLAGS

ネームサーバを指定

NULL

TP1/Server Base（サーバ）側のサービス受信口となるホスト名

TP1/Server Base（サーバ）側のネームサービスのポート番号

EERPC_NAMPORT

スケジュールサービスのポートを指定

NULL

TP1/Server Base（サーバ）側のサービス受信口となるホスト名

TP1/Server Base（サーバ）側のスケジュールサービスのポート番号

EERPC_SCDPORT

(c)　TP1/EEがサーバUAPで，TP1/Client/WまたはTP1/Client/PがクライアントUAPの場合

TP1/EEがサーバUAPで，TP1/Client/WまたはTP1/Client/PがクライアントUAPの場合，TP1/Client/WまたはTP1/Client/P側で次に示す項目を設定する必要があります。

クライアント環境定義のDCCLTDATACOMPオペランド

Nを指定してください。

dc_rpc_call_s関数を使用してサービス要求をする場合

dc_rpc_call_s関数を使用してサービス要求をする場合のflags引数を次の表に示します。

表3‒9　dc_rpc_call_s関数のflags引数

RPCの種類

flags引数

同期応答型

DCNOFLAGS

非応答型

DCRPC_NOREPLY

TP1/Server Baseのネームサービスにサービス情報を問い合わせないで，直接TP1/EEに対してサービス要求をしたい場合は，次に示す定義を指定してください。

クライアント環境定義のPDHOSTオペランド，DCSCDPORTオペランド，およびDCSCDDIRECTオペランド

PDHOSTオペランド

TP1/EEのサービスグループ情報関連定義のmysvgdef定義コマンドの-hオプションで指定したホスト名と同じ値を指定してください。

DCSCDPORTオペランド

TP1/EEのサービスグループ情報関連定義のmysvgdef定義コマンドの-hオプションで指定したポート番号と同じ値を指定してください。

DCSCDDIRECTオペランド

Yを指定してください。

dc_rpc_call_to_s関数を使用してサービス要求をする場合

dc_rpc_call_to_s関数を使用してサービス要求をする場合のdirection引数およびflags引数を次に示します。

direction

DCRPC_DIRECT_SCHEDULE関数を使用して作成したDCRPC_BINDING_TBL構造体のアドレスを指定してください。

flags

dc_rpc_call_s関数と同様です。

DCRPC_DIRECT_SCHEDULE関数の引数

DCRPC_DIRECT_SCHEDULE関数の引数の設定を次に示します。

hostnm

TP1/EEのサービスグループ情報関連定義のmysvgdef定義コマンドの-hオプションで指定したホスト名およびポート番号と同じ値を指定してください。

scdport

TP1/EEのサービスグループ情報関連定義のmysvgdef定義コマンドの-hオプションで指定したホスト名およびポート番号と同じ値を指定してください。

(d)　TP1/EEがサーバUAPで，TP1/Client/JがクライアントUAPの場合

TP1/EEがサーバUAPで，TP1/Client/JがクライアントUAPの場合，TP1/Client/J側で次に示す項目を設定する必要があります。

TP1/Client/J環境定義のdccltdatacompオペランド

Nを指定してください。

rpcCallメソッドを使用してサービス要求をする場合

rpcCallメソッドを使用してサービス要求をする場合のflags引数を次の表に示します。

表3‒10　rpcCall関数のflags引数

RPCの種類

flags引数

同期応答型

DCNOFLAGS

非応答型

DCRPC_NOREPLY

TP1/Server Baseのネームサービスにサービス情報を問い合わせないで，直接TP1/EEに対してサービス要求をしたい場合は，次に示す定義を指定してください。

TP1/Client/J環境定義のpdhostオペランド，およびdcscddirectオペランド

pdhostオペランド

TP1/EEのサービスグループ情報関連定義のmysvgdef定義コマンドの-hオプションで指定したホスト名およびポート番号と同じ値を指定してください。

dcscddirectオペランド

Yを指定してください。

rpcCallToメソッドを使用してサービス要求をする場合

rpcCallメソッドを使用してサービス要求をする場合のdirection引数およびflags引数を次に示します。

direction

setScdDirectObjectメソッドを使用して作成したDCRpcBindTblオブジェクトを指定してください。

flags

rpcCallメソッドと同様です。

setScdDirectObjectメソッドの引数

setScdDirectObjectメソッドの引数の設定を次に示します。

scdhost

TP1/EEのサービスグループ情報関連定義のmysvgdef定義コマンドの-hオプションで指定したホスト名およびポート番号と同じ値を指定してください。

scdport

TP1/EEのサービスグループ情報関連定義のmysvgdef定義コマンドの-hオプションで指定したホスト名およびポート番号と同じ値を指定してください。

(2)　自ノード内でサービスを実行する場合

サービス要求先とサービス要求元が同じノード内にある場合に，RPC関連定義のrpc_connect_unixdomainオペランドの指定を省略するか，またはYを指定すると，サービス要求元はUNIXドメインプロトコルを通して，UNIXドメインソケットを使用してサービス要求をします。UNIXドメインを使用すると，通信性能が上がります。このため，通常はrpc_connect_unixdomainオペランドの指定を省略するか，またはYを指定してください。ただし通信性能が向上することで，TCP/IPのバッファが不足したり，バッファ不足に伴うリトライが多発したりして，全体の性能が低下するおそれがあります。そのような場合に，rpc_connect_unixdomainオペランドにNを指定すると，通信性能は低下しますが，全体の性能は良くなることがあります。

なお，TP1/EEでは，RPC関連定義のrpc_multi_tp1_in_same_hostオペランドの指定に従い，UNIXドメインソケット用のパス名を生成します。

(a)　TP1/Server BaseとRPC通信する場合

TP1/EEがサーバUAPでTP1/Server BaseがクライアントUAPの場合，またはTP1/Server BaseがサーバUAPでTP1/EEがクライアントUAPの場合，次に示すオペランドの指定値を同一にしておく必要があります。

TP1/EEのRPC関連定義のrpc_multi_tp1_in_same_hostオペランド

TP1/Server Baseのシステム共通定義のrpc_multi_tp1_in_same_hostオペランド

(b)　サーバUAPとクライアントUAPが共にTP1/EEの場合

サービス要求先とサービス要求元のRPC関連定義のrpc_multi_tp1_in_same_hostオペランドの指定値を同一にしておく必要があります。

3.1.11　RPCメッセージの最大長拡張機能

RPCメッセージの最大長拡張機能を使用すると，次に示す関数を使って送受信できるメッセージの最大長を，1メガバイト〜8メガバイトで指定できます。この機能を使用する場合，あらかじめメモリ関連定義のmax_message_sizeオペランドに1048577以上を指定しておく必要があります。

C言語の場合：ee_rpc_call，ee_rpc_call_to，またはee_rpc_cmtsend

COBOL言語の場合：CBLEERPC('CALL ')，CBLEERPC('CALLTO ')，またはCBLEERPC('CMTSND ')

この機能を使用する場合，送信先となるすべてのノードで，最大長のRPCメッセージを受信できるよう定義してください。RPCメッセージを受信できないノードがある場合，送信先ノードのノード間負荷バランス機能が実行されたときに，リターン値EERPCER_NET_DOWNが返されてエラーとなるか，またはRPCメッセージの一部が失われるおそれがあります。1メガバイトより大きいRPCメッセージを送信する場合は，次の点に注意してください。

SPPが起動している送信先ノードは，1メガバイトより大きいRPCメッセージを受信できるバージョンの製品を使用してください。

SPPが起動しているノードで，1メガバイトより大きいRPCメッセージを受信できないバージョンの製品がある場合，次に示すどちらかのリターン値が返されてエラーになります。

EERPCER_NO_SUCH_SERVICE_GROUP

EERPCER_TRNCHK

サービス要求元のノードを開始してから，SPPを起動してください。

サービス要求元のノード開始前にSPPを起動した場合は，リターン値EERPCER_NO_SUCH_SERVICE_GROUPが返されてエラーとなるおそれがあります。

(1)　ネームサービス機能によるRPCメッセージの最大長拡張機能のチェック

ネームサービス機能を使用すると，RPCメッセージの最大長拡張機能をサポートしているかどうかの情報をネーム情報として保持し，RPCメッセージの送信時に1メガバイトより大きいRPCメッセージを受信できるバージョンであるかどうかを判断できます。サービス要求先がRPCメッセージの最大長拡張機能をサポートしていない場合は，サービス要求をエラーとします。

なお，ネームサービス機能を使用しない場合，サービス要求先でRPCメッセージの最大長拡張機能をサポートしているかどうかの判断はできません。

1メガバイトより大きいRPCメッセージを送信する場合の，TP1/EEおよびTP1/Server Baseのバージョンによる動作の違いを次の図と表に示します。

図3‒10　1メガバイトより大きいRPCメッセージを送信する場合の，TP1/EEおよびTP1/Server Baseのバージョンによる動作の違い（ネームサービス機能使用時）

表3‒11　1メガバイトより大きいRPCメッセージを送信する場合の，TP1/EEおよびTP1/Server Baseのバージョンによる動作の違い

サービス要求元

サービス要求先

TP1/EE

TP1/Server Base

02-00以前

07-00以降

06-01以前

06-02以降

TP1/EE 02-00以前

×※1

×※1

×※1

×※1

TP1/EE 07-00以降でネームサービス機能を使用

×※2

○※3

×※2

○

TP1/EE 07-00以降でネームサービス機能を未使用

○

○

○

○

（凡例）

○：サービス要求ができます（サービス要求先として選択されます）。

×：サービス要求ができません（サービス要求先として選択されません）。

注※1

引数不正となり，リターン値EERPCER_MESSAGE_TOO_BIGが返されてエラーになります。

注※2

サービス要求先として選択されません。

注※3

サービス要求先がネームサービス機能を使用していない場合，サービス要求先として選択されません。

3.1.12　トランザクションインタフェース情報のノード識別子を利用したリモートプロシジャコール

TP1/EE同士のRPC通信で，ee_rpc_call関数（またはee_rpc_call_to関数）やee_rpc_cmtsend関数（またはee_rpc_cmtsend_to関数）を使用してサービス要求を送信する場合に，サービス要求先のトランザクションインタフェース情報（EERPC_INTERFACE_TBL）に，サービス要求元のTP1/Server Baseのノード識別子またはTP1/EEのノード識別子のどちらを設定するかを選択できます。

この機能は，トランザクションインタフェース情報に設定されているノード識別子を利用して，ノード識別子を指定したサービス要求を送信したい場合などに使用します。

例えば，TP1/EEのサービスグループはTP1/Server Baseのネームサーバでネーム情報を管理するため，TP1/EEのサービスグループに対してノード識別子を指定してdc_rpc_call_to関数を呼び出す場合は，TP1/Server Baseのノード識別子を指定する必要があります。このため，この機能を使用して，サービス要求先のトランザクションインタフェース情報に，サービス要求元のTP1/Server Baseのノード識別子を設定すれば，ノード識別子を指定したサービス要求を送信できます。

トランザクションインタフェース情報のノード識別子の利用の例を次の図に示します。

図3‒11　トランザクションインタフェース情報のノード識別子の利用の例

TP1/Server Baseのノード識別子またはTP1/EEのノード識別子のどちらを設定するかは，サービス要求元のRPC関連定義のrpc_extend_sb_node_idオペランドの指定値によって決まります。

rpc_extend_sb_node_idオペランドにYを指定した場合は，要求先のトランザクションインタフェース情報には，TP1/Server Baseのノード識別子が設定されます。Nを指定した場合，または省略した場合は，要求先のトランザクションインタフェース情報には，TP1/EEのノード識別子が設定されます。

rpc_extend_sb_node_idオペランドにYを指定した場合は，サービス要求メッセージのサイズが16バイト増加します。

なお，次の場合には，rpc_extend_sb_node_idオペランドの指定は無効になります。

サービス要求元でRPC関連定義のname_useオペランドにNを指定している場合

サービス要求先のTP1/EEのバージョンが07-80より前の場合

サービス要求先がTP1/EE以外の場合

3.1.13　一時クローズ機能

大規模なシステムを構築する場合，TCP/IPが管理するコネクション数が不足するおそれがあります。このような場合に，使用するコネクション数を制限するのが，一時クローズ機能です。

TP1/EEでは，コネクション確立時のオーバヘッドを抑えるために，確立したコネクションを切断しないで保持し，同一宛先との通信に再利用します。保持するコネクション数が上限に達した場合に，コネクションを確立したプロセス間の合意によって，コネクションを切断する機能を一時クローズ機能といいます。

この機能を送受信用コネクションで使用する場合は，RPC関連定義のrpc_reply_sockctl_useオペランドにYを設定します。同様に，受信用コネクションで使用する場合は，RPC関連定義のrpc_recv_sockctl_useオペランドにYを設定します。

一時クローズ機能の要求元では，使用中コネクション数が定義で指定した一時クローズ処理開始数の割合以上になると処理を開始し，確立時刻が古いコネクションから順に一時クローズ処理非対象数の割合で指定したコネクション数になるまで一時クローズ処理要求を送信します。その後，一時クローズ処理応答を受信することで，そのコネクションは解放されます。

一方，要求先では一時クローズ処理要求を受信すると，一時クローズ処理応答を要求元へ送信することで，コネクションが切断可能であることを通知します。

一時クローズ機能使用時の例を次の図に示します。

図3‒12　一時クローズ機能使用時の例

(1)　コネクション種別

一時クローズ機能で処理対象となるコネクション種別を次の表に示します。

表3‒12　一時クローズ処理の対象コネクション種別

コネクション種別

一時クローズ処理対象

送信用コネクション※

×

受信用コネクション

○

送受信用コネクション

○

常設コネクション：rapサーバ

×

常設コネクション：rapクライアント

×

TCP/IP共有送信用コネクション

×

（凡例）

○：一時クローズ処理の対象です。

×：一時クローズ処理の対象外です。

注※

このコネクションは，定義（eesvgdef）で指定したコネクション数分を確立したままとするコネクションなので，一時クローズ対象外とします。

また，一時クローズ要求電文の送信時に，RPC電文の送信が行われているコネクションについては，一時クローズ要求処理を行いません。

(2)　一時クローズ処理を開始する契機

一時クローズ機能では，次に示すオペランドによって一時クローズ処理開始数と一時クローズ処理非対象数の割合を指定できます。

表3‒13　一時クローズ処理開始契機で参照する定義

コネクション種別

最大コネクション数定義

一時クローズ処理開始数定義（割合）

一時クローズ処理非対象数定義（割合）

受信用コネクション※

mysvgdef定義コマンドの-sオプション指定値

rpc_recv_sockctl_highwaterオペランドの第1指定値

rpc_recv_sockctl_highwaterオペランドの第2指定値

送受信用コネクション

rpc_reply_con_max_cntオペランド指定値

rpc_reply_sockctl_highwaterオペランドの第1指定値

rpc_reply_sockctl_highwaterオペランドの第2指定値

注※

受信用コネクションでは，受信スレッド（mysvgdefオペランドのポート番号）ごとに使用中コネクション数および非対象数を算出して一時クローズ処理を行います。

使用中コネクション数が次の値以上となった場合に，一時クローズ処理を開始します。

↑（（最大コネクション数定義）×（一時クローズ処理開始数定義÷100））↑

また，一時クローズ処理非対象とするコネクション数は次の値となります。

↑（（最大コネクション数定義）×（一時クローズ処理非対象数定義÷100））↑

(3)　一時クローズ機能使用時のコネクション数推移

一時クローズ機能では，使用中コネクション数がオペランドで指定した処理開始数以上になった場合に，確立時刻の古いコネクションから順に一時クローズ処理要求を送信します。一時クローズ処理要求は，オペランドで指定した非対象数になるまで行われます。また，一時クローズ処理要求後にコネクション数が増加した場合も，使用中コネクション数が処理開始数以上であれば，増加したコネクション数分，一時クローズ処理要求を送信します。

コネクション数推移を次の図に示します。

図3‒13　一時クローズ機能使用時のコネクション数推移

(4)　注意事項

一時クローズ機能を使用した場合は，応答受信スレッドで一時クローズ処理用の電文送受信処理が発生するため，送受信用コネクションを使用する受信処理やコネクション受付処理が機能未使用時と比べて遅れることがあります。

3.1.14　サービスグループ閉塞機能

(1)　概要

サービスグループ閉塞機能は，特定のサーバ（TP1/EE）をシステムから切り離すための機能です。

サービスグループ閉塞／閉塞解除はeesgrpctlコマンドを使用します。

システムからの切り離しとは，サービスグループ閉塞対象TP1/EEへのネーム情報を使用したRPC送信要求を対象外にすることを意味します。

ただし，次の場合，サービスグループ閉塞機能を使用できません。

MCPを使用している場合（mcp_use=Yを指定している場合）

XTCを使用している場合（xtc_use=Yを指定している場合）

ネーム機能を使用していない場合（name_use=Nを指定している場合）

サービスグループを閉塞すると，サービスグループ閉塞したTP1/EEはRPC送信元からの送信先サーバ，負荷レベルによる転送先サーバとしての対象から外れます。

サービスグループ閉塞を解除するとRPC要求送信先サーバ，および転送先サーバの対象となります。

コマンドにオプションを指定すると，サービスグループの閉塞状態を確認（表示）できます。

なお，サービスグループ閉塞後，RPC要求元サーバ，および同一サービスグループ名の他のサーバでeenamupdateコマンドを実行すると，各サーバのネーム情報を即時更新（送信先サーバとして除外）できます。

eenamupdateコマンドを実行しない場合は，ネーム情報の更新までタイムラグが発生する場合があります。

この間，サービスグループ閉塞したTP1/EEがRPC要求を受信する場合があります。その場合の動作は「(4)　サービスグループ閉塞中の動作」を参照してください。

図3‒14　サービスグループ閉塞

(2)　サービスグループ閉塞機能を使用する場合の前提

OBM機能を使用している場合

OBMを使用している場合はOBMを停止してからサービスグループを閉塞してください。

OBMを停止しない場合，サービスグループ閉塞中にBCM-BCS間またはeeobmstartコマンド-BCM間の通信ができなくなり，実行中のOBMが強制停止するおそれがあります。このため，サービスグループ閉塞前にOBMを停止してください。

DBキュー機能を使用している場合

DBキューを使用している場合は，次のどちらかを実施してください。

DBキューの読み出しを継続したい場合

サービスグループ閉塞をするTP1/EEがDBキュー読み出しサーバの場合，サービスグループ閉塞前にDBキューサービスを閉塞し，その後読み出しサーバを切り替えてください。その後，DBキューサービスの閉塞を解除してください。

DBキューの読み出しを停止しても良い場合

サービスグループ閉塞をするTP1/EEがDBキュー読み出しサーバの場合，サービスグループ閉塞前にDBキューサービスを閉塞してください。

(3)　サービスグループ閉塞の流れ

緊急ライブラリ入れ替え時を例にサービスグループ閉塞の手順の流れを次の図に示します。

サーバA，B，C，Dはそれぞれ次の機能を持ったサーバで，サーバBのライブラリ入れ替えをする場合の例を説明しています。

サーバA：RPC送信元サーバでOBMのBCMがあるサーバ。

サーバB：RPC送信先サーバでOBMのBCSおよびDBキューの読み出しをするサーバ。

サーバC，D：RPC送信先サーバでOBMのBCSがあるサーバ。

なお，この例では，OBM，DBキューを使用しているサーバを対象とし，DBキューは読み出しを停止しても良い場合について説明しています。1.〜10.の順で実行してください。

図3‒15　サービスグループ閉塞の流れ

サーバAで，OBM停止コマンド（eeobmstop）を実行してOBMを停止する。

DBキューサービス閉塞コマンド（eedbqdctsv）を実行し，DBキューサービスを閉塞する。

サービスグループ閉塞コマンド（eesgrpctl）を実行し，サービスグループを閉塞する。

サービスグループ閉塞したTP1/EEにRPC送信するすべてのプロセスで，ネーム情報更新コマンド（eenamupdate）を実行する。

サービスグループ閉塞したプロセスと同一サービスグループ名のすべてのプロセスに対してもネーム情報更新コマンドを実行する必要があります。これは，負荷レベルによるサービスグループ閉塞済みのサーバへの転送を防止するためです。

処理キュー統計情報表示コマンド（eelsque）を実行し，全サービスの滞留数が0になったか確認する。

ライブラリ入れ替えコマンド（eechglib）の自ノード実行で，サーバのライブラリを入れ替える。

サービスグループ閉塞解除コマンド（eesgrpctl）を実行し，サービスグループの閉塞を解除する。

4.と同プロセスに対してネーム情報更新コマンド（eenamupdate）を実行する。

DBキューサービス閉塞解除コマンド（eedbqactsv）を実行し，DBキューサービスの閉塞を解除する。

サーバAで，OBM開始コマンド（eeobmstart）を実行してOBMを再開する。

(4)　サービスグループ閉塞中の動作

RPC負荷レベルの監視無効

RPC負荷レベル監視を抑止します。

サービスグループ閉塞中を示すメッセージ出力

定期的にメッセージログファイルにサービスグループ閉塞中を示すKFSB80310-Iメッセージを出力します。

RPCのユーザサービス

処理キューに滞留しているサービスを処理します。ただし，サービス閉塞または引き出し禁止の場合は除きます。

新規にRPC要求を受信した場合，そのRPC要求が転送できるときは，同一サービスグループ名の他サーバに転送します。

転送できない場合，RPCエラー応答（リターン値EERPCER_SERVICE_CLOSED）を返却します。また，非応答型のRPC要求を受信した場合は，受信した要求を破棄します。

ee_rpc_call()，ee_rpc_cmtsend()のflagsにEERPC_CALL_MYPROC（自プロセス通信）を指定した場合は，正常に処理します。

次に，RPC要求方法と，RPC受信側での転送，送信可否を示します。ただし，サービスグループ閉塞コマンドの実行からネーム情報即時反映コマンドの実行までの間に，RPC要求を送信することがあります。

表3‒14　RPC要求とその転送/送信可否

項番

内容

動作

サービスグループ閉塞前に実行したもの

（サービスグループ閉塞時にキューに滞留していたもの）

サービスグループ閉塞後に実行したもの

RPC送信先※1

RPC送信元※2

1

eesvgdef定義先の送信の

ee_rpc_call()

ee_rpc_cmtsend()

実行する。

横転送

正常送信

2

ネーム情報による送信の

ee_rpc_call()

ee_rpc_cmtsend()

dc_rpc_call()

実行する。

横転送

送信不可

（送信先対象外）

3

横転送（転送回数が上限未満）

実行する。

横転送

−

4

横転送（転送回数が上限以上）

実行する。

破棄

−

5

ネームサーバ指定の

ee_rpc_call_to

dc_rpc_call_to()

実行する。

破棄

送信エラー

6

ノード識別子指定の

ee_rpc_call_to

dc_rpc_call_to()

実行する。

破棄

送信エラー

7

スケジュールダイレクトの

ee_rpc_call_to

dc_rpc_call_to()

実行する。

破棄

正常送信

8

ee_rpc_call_to（上記以外）

実行する。

可

送信エラー

（凡例）

−：対象外です。

注※1

サービスグループ閉塞したプロセスがRPC要求を受信した場合の動作です。

注※2

RPC送信元がサービスグループ閉塞したプロセスに対し，RPC要求を送信した場合の動作です。

(a)　RPCプロトコルを使用したTP1/EE機能

サービスグループ閉塞中のRPCプロトコルを使用したTP1/EE機能の各処理を次の表に示します。

表3‒15　RPCプロトコルを使用したTP1/EE機能の処理

項番

内容

動作

サービスグループ閉塞前に実行したもの

（サービスグループ閉塞時にキューに滞留していたもの）

サービスグループ閉塞後に実行したもの

1

eechglib

（他ノード実行）

−

実行しないでください。実行した場合の動作は保証しません。

全ノード指定で実行した場合，サービスグループ閉塞したプロセスだけ実行されないことがあります。

2

eesvctl

（他ノード実行）

−

実行しないでください。実行した場合の動作は保証しません。

全ノード指定で実行した場合，サービスグループ閉塞したプロセスだけ実行されないことがあります。

3

eesdhchg

（他ノード実行）

−

実行しないでください。実行した場合の動作は保証しません。

全ノード指定で実行した場合，サービスグループ閉塞したプロセスだけ実行されないことがあります。

4

eeucmd

（他ノード実行）

−

実行しないでください。実行した場合の動作は保証しません。

5

eetimchown

−

実行しないでください。実行した場合の動作は保証しません。

6

OBMサービス

実行しないでください。OBMが強制停止するおそれがあります。事前にeeobmstopコマンドでOBMを停止しておいてください。

7

永続タイマサービス実行

実行します。ただし，サービスグループ閉塞中に新たに起動時刻に達したタイマの起動要求は，他ノードに横転送します。

実行します。ただし，タイマの起動要求は，他ノードに横転送します。

（凡例）

−：対象外です。

(b)　RPCプロトコル以外のサービス実行

サービスグループ閉塞中の各トランザクションの動作を次の表に示します。

表3‒16　各トランザクションの動作

項番

トランザクション

動作

サービスグループ閉塞前に実行したもの

（サービスグループ閉塞時にキューに滞留していたもの）

サービスグループ閉塞後に実行したもの

1

TMトランザクション

（永続化無のユーザタイマ）

実行します。

ただし，サービスグループ閉塞中に新たに起動時刻に達したタイマは，サービスグループ閉塞解除まで実行しません。

（タイマ起動監視状態継続）

サービスグループ閉塞解除まで実行しません。

（タイマ起動監視状態継続）

ただし，即時起動を指定した場合は実行します。

2

MNトランザクション（DBQ）

実行します。

処理キュー滞留数チェック時に滞留数が0にならないおそれがあるため，事前にeedbqdctsvコマンドでDBキューサービスを閉塞しておいてください。

（DBキュー読み出し継続）

3

MNトランザクション

（RAP）

実行します。

実行します。

（エラー応答します）。

4

UTトランザクション

（eeexecut）

実行します。

5

CUトランザクション

（eeucmd）

実行します。

6

エラートランザクション

実行します。

(5)　再開始時のサービスグループ閉塞状態引き継ぎ

サービスグループの閉塞状態は，TP1/EEプロセスの再開始時に引き継ぎます。

サービスグループの閉塞状態が「閉塞中」または「閉塞処理中」の状態で，次のようにTP1/EEプロセスが終了した場合，再開始時のサービスグループの閉塞状態は「閉塞中」となります。それ以外は「閉塞解除中」となります。

TP1/EEプロセスが異常終了した

TP1/EEプロセスを強制停止／計画停止A／計画停止Bで終了させた

再開始時にサービスグループの閉塞状態が「閉塞中」の場合，起動直後にKFSB80310-Iメッセージを出力します。以降，閉塞状態が継続する間，1分間隔でKFSB80310-Iメッセージを出力します。

(6)　ネーム情報更新機能

ネーム情報更新機能は，サービスグループの閉塞または閉塞解除をしてサーバ（TP1/EE）のネーム情報（削除・登録）を即時に更新するための機能です。

通常，TP1/EEのネーム情報は，インターバル間隔で更新します。このため，サービスグループ閉塞・閉塞解除によるネーム情報の更新は即時に行われない場合があります。

指定したサービスグループ（サービスグループ閉塞・閉塞解除したサービスグループ）のネーム情報を即時更新したい場合は，eenamupdateコマンドで更新できます。

サービスグループ閉塞をした場合，ネーム情報の更新はTP1/EE以外の全TP1/EEに対し実行する必要があります。

3.1.15　Cosminexus連携機能

(1)　TP1/EEがクライアントのときのCosminexus連携

CosminexusのTP1インバウンド連携機能を使用することで，TP1/EEのUAPからJ2EEサーバ上の業務プログラムを呼び出せます。CosminexusのTP1インバウンド連携機能については，マニュアル「Cosminexus V9 アプリケーションサーバ機能解説 基本・開発編（コンテナ共通機能）」を参照してください。

TP1/EEのUAPからは，OpenTP1システムのSPPやTP1/EEを呼び出す場合と同様の手順でアプリケーションサーバ上の業務を呼び出せます。

図3‒16　TP1インバウンド連携機能を使用したCosminexusとの連携

表3‒17　クライアントでのTP1/EEの機能の使用可否

機能の分類

TP1/EEの機能

使用可否

ユーザアプリケーションプログラムの種類

SPP

○

RPCの種類

同期応答型RPC

○

非同期応答型RPC

×

非応答型RPC

×

トランザクショナルRPC

×

呼び出し先のRPC受信形態

キュー受信型サーバ

○

リモートAPI機能

リモートAPI機能

×

RPCのサービス要求方式

サービスグループ情報関連定義eesvgdef定義コマンドによるサービス要求

○

ee_rpc_call_to関数によるスケジューラダイレクト機能

○

ネームサービス機能

×

ユーザ電文

ユーザ電文長8メガバイト拡張

○

そのほか

コネクションの保持

○

要求用TCP/IPコネクションの接続リトライ

○

（凡例）

○：使用できます。

×：使用できません。

Cosminexusがネームサービスに対応していないため，eesvgdefコマンド形式定義で，Cosminexus連携用の-cオプションを指定してください。

-cオプションを指定したサービスグループに対して次のAPIを発行した場合，Cosminexusに特化した制御を行います。

ee_rpc_call()

ee_rpc_cmtsend()

ee_rpc_call_to()※

ee_rpc_cmtsend_to()※

注※

引数で指定したEERPC_BINDING_TBL構造体のflagsがEERPC_SCDPORTの場合（COBOL言語ではデータ名Kが'S'の場合）だけ，CosminexusへRPC要求できます。なお，指定したサービスグループ名がCosminexusかどうかを判定するためにだけ，eesvgdefコマンド形式定義を使用します。RPC要求先のIPアドレスとポート番号は，EERPC_BINDING_TBL構造体で指定したIPアドレスおよびポート番号（COBOL言語ではデータ名Nおよびデータ名M）です。eesvgdefコマンド形式定義で指定したIPアドレスおよびポート番号ではありません。

次に，-cオプションを指定した場合の動作を示します。

RPC要求先への最大コネクション数：1固定

コネクションのドメイン種別：INETドメインだけ使用

ee_rpc_call()またはee_rpc_cmtsend()のRPC要求先の決定方法：eesvgdefコマンド形式定義を使用

(a)　サーバ側の機能

Cosminexusがサーバとなるときの機能については，マニュアル「Cosminexus V9 アプリケーションサーバ 機能解説 基本・開発編（コンテナ共通機能）」のTP1インバウンド連携機能を参照してください。

(b)　定義の関連

Cosminexusと連携するときの定義の関連を次に示します。

Cosminexusの定義については，マニュアル「Cosminexus V9 アプリケーションサーバ 機能解説 基本・開発編（コンテナ共通機能）」のTP1インバウンド連携機能を参照してください。

図3‒17　TP1/EEとCosminexusの定義の関連

(c)　注意事項

RPC関連定義name_useオペランドは省略するか，Yを指定してください。

(2)　TP1/EEがサーバのときのCosminexus連携

J2EEで動作するアプリケーションサーバ（Cosminexus）は，JCAに準拠したuCosminexus TP1 ConnectorまたはCosminexus TP1 Connectorを使用することで，TP1/EEのUAPを呼び出せます。

J2EEで動作するアプリケーションサーバと連携する場合のRPCの流れを次に示します。

図3‒18　J2EEで動作するアプリケーションサーバとのRPC連携

(a)　アプリケーションサーバについて

アプリケーションサーバ（Cosminexus）については，マニュアル「Cosminexus V9 アプリケーションサーバ 機能解説 基本・開発編（コンテナ共通機能）」の「OpenTP1とのOutboundでの接続（SPPまたはTP1/Message Queue）」を参照してください。

(b)　注意事項

RPC関連定義name_useオペランドは省略するか，Yを指定してください。

3.2　トランザクション制御

TP1/EEを使うと，分散コンピューティング環境で高い信頼性を要求される業務処理プログラムに必要な，各種のトランザクション制御機能を実現できます。TP1/EEを運用しているときにこれらの機能を使うことで，分散システムに特有な障害対策の負担を軽減できます。

3.2.1　分散トランザクション

トランザクションとは，関連する複数の処理を一つのまとまった処理として扱うための論理的な単位です。一つのトランザクション内で実行した処理は，すべてが有効になるか，すべてが無効になるかのどちらかです。

これまでのオンラインシステムは，トランザクションを単体の大型コンピュータで実行していました。このため，一つのコンピュータ内でしかトランザクションの整合性を保証していませんでした。

分散コンピューティング環境で動作するTP1/EEでは，トランザクションはほかのコンピュータに分散して実行されます。このようなトランザクション処理を分散トランザクションといいます。TP1/EEは，分散して処理する一連のトランザクション全体の整合性を保証しています。

トランザクション制御では，リソースマネジャの排他制御によって，複数のトランザクションが同時に，同じ資源を更新することはありません。資源は常にトランザクションごとに更新されます。

トランザクションが正常に終了して，トランザクションを有効にすると決定した場合，その後のUAPの処理に関係なく資源を更新することをリソースマネジャに指示します。このため，資源間の不整合が起きません。これは，障害が発生しても資源間で不整合が生じないように，トランザクションに関する履歴情報を，ステータスファイルに取得しているためです。トランザクションの処理中に障害が発生して，トランザクションを有効にしないと決定した場合には，トランザクションを開始する前の状態に資源を戻すことをリソースマネジャに指示します。このように，業務をトランザクションとして処理することで，資源の整合性を保てます。

分散トランザクションを次の図に示します。

図3‒19　分散トランザクション

トランザクションは，トランザクションマネジャが管理，実行します。トランザクションマネジャが管理，実行する処理内容の一覧を次の表に示します。トランザクションの種別については，マニュアル「TP1/Server Base Enterprise Option プログラム作成の手引」を参照してください。

表3‒18　トランザクションマネジャの処理内容一覧

処理名

処理内容

TP1/EEの開始・終了処理

リソースマネジャとのコネクション確保・解放

トランザクションの回復

仕掛り中トランザクションの終了監視

トランザクションの開始・終了処理

グローバルトランザクションの開始・完了

トランザクションブランチの開始・完了

トランザクション開始・終了出口

同期点処理

2相コミット

トランザクション連携

TP1/Server Baseとの連携

TP1/EEとの連携

トランザクション最適化

1相最適化

リードオンリー最適化

回復処理

プロセスダウンおよびスレッドダウン発生後のトランザクションの回復

通信障害監視処理

通信障害発生時の通信先プロセス監視

リソースマネジャ障害監視処理

リソースマネジャ障害発生時のリソースマネジャ監視

時間監視処理

トランザクション処理時間監視

トランザクションブランチ同期点処理時の最大通信待ち時間監視

XA連携処理

リソースマネジャ接続に関するX/Openインタフェース

XAインタフェース

xa_open関数リトライ

エラートランザクション処理

不正サービス名称検出通知

サービス閉塞通知

UAP異常終了通知

タイマトランザクション起動破棄通知

コミット決着失敗通知

送信障害通知

監視トランザクション処理

オンライン開始監視

プロセス終了監視

インタバルタイマ監視

資源の排他制御

資源の排他制御

3.2.2　グローバルトランザクション

UAPでRPCを使うと，トランザクションは複数のUAPにわたって構成されます。複数のUAPで構成されるトランザクションを，グローバルトランザクションといいます。グローバルトランザクションを構成する各UAPを，トランザクションブランチといいます。特に，トランザクションの開始を宣言したUAPをルートトランザクションブランチといいます。また，一つのトランザクションブランチから生成されたトランザクションブランチを子トランザクションブランチといい，子トランザクションブランチを生成したトランザクションブランチを親トランザクションブランチといいます。

各グローバルトランザクションの間には，関連がありません。グローバルトランザクションとしてRPCが使えるのは，TP1/EE同士，またはTP1/EEとTP1/Server Baseとの間です。TP1/EEとTP1/Clientとの間でRPCを使ってトランザクション連携することはできません。

(1)　グローバルトランザクションの構造

TP1/EEのトランザクションサービスでのグローバルトランザクションの構造を次の図に示します。

図3‒20　グローバルトランザクションの構造

一つのトランザクションブランチは，常に一つのグローバルトランザクションに属します。一つのスレッドは，常に一つのトランザクションブランチに結合します。

一つのリソースマネジャは，複数のトランザクションブランチからアクセスされる可能性，および複数のグローバルトランザクションに属する可能性があります。いったん結合したトランザクションブランチとリソースマネジャは，グローバルトランザクションが完了するまで，結合したままの状態になります。

(2)　グローバルトランザクションID

グローバルトランザクションIDは，グローバルトランザクションを識別するために使用します。

グローバルトランザクションIDは，一意である必要があります。TP1/EEでは，グローバルトランザクションの開始時刻，グローバルトランザクション通番，およびルートトランザクションブランチがあるTP1/EEのシステム識別子を使用してグローバルトランザクションIDを作成することによって一意性を保証します。

TP1/EE再開始時のグローバルトランザクション通番は，前回のオンラインで最後に使用したグローバルトランザクション通番の次の番号から使用されます。グローバルトランザクション通番は，TP1/EE再開始時のグローバルトランザクション通番が更新されるときに，ステータスファイルに開始CJ（トランザクション開始時に取得するステータスファイル）として出力されます。

ただし，マシンの時刻を変更した場合は，グローバルトランザクションIDが一意ではなくなるおそれがあります。TP1/EEでは，時刻を変更する場合，adjtime()システムコールのように，常に単調に時刻の値を増加させながら増加の速度を速くしたり遅くしたりすることで時刻を補正する機能を使用することをお勧めします。

注意事項

TP1/EEの開始中，オンライン中，または停止中には，時刻を変更しないでください。何らかのテストで時刻を進める必要がある場合は，TP1/EEを停止させたあとで時刻を進めてください。何らかのテストで時刻を遅らせる必要がある場合は，TP1/EEを終了し，ステータスファイルをすべて初期化したあとで時刻を遅らせてください。時刻を遅らせたあとに，TP1/EEを起動してください。

(3)　TP1/Server Baseとのトランザクション連携

次に示すどちらかの場合，TP1/EEとTP1/Server Baseとの間でトランザクション連携をします。

TP1/EEがクライアントUAPで，ee_rpc_call関数のflagsオプションにEERPC_TPNOTRANを指定しない場合，かつ，TP1/Server Baseがトランザクション属性のサーバUAPの場合

TP1/Server Baseがトランザクション属性のクライアントUAPで，dc_rpc_call関数のflagsオプションにDCRPC_TPNOTRANを指定しない場合

TP1/EEとTP1/Server Baseとの間でトランザクション連携をするときは，グローバルトランザクション内でコミットやロールバックをするために，RPCと連携して同期点メッセージを送受信します（トランザクショナルRPC）。

TP1/EEとTP1/Server Baseとの間でトランザクション連携をする場合は，RPC関連定義のname_useオペランドにYを指定してください。

注意事項

オンラインテスタを起動した状態のTP1/Server BaseとTP1/EEとの間では，トランザクション連携をすることはできません。

非同期プリペア最適化を実行したTP1/Server Baseとの間でトランザクション連携をする場合，TP1/EE側では非同期プリペア最適化を実行しません。

3.2.3　トランザクションのコミットとロールバック

トランザクションは，成功または失敗することによって終了します。トランザクションが成功すること，つまり整合性を保って資源を更新することを，トランザクションのコミットといいます。トランザクションがコミットしたときに初めて，グローバルトランザクション内のすべてのトランザクションブランチでの資源の更新が有効になります。トランザクションをコミットするかどうか最終的に決定するトランザクション処理の区切りを，同期点といいます。資源は，同期点で更新します。

トランザクションが失敗して，トランザクションで更新するはずの資源の状態を，トランザクション開始直前の状態に戻すことを，トランザクションのロールバックといいます。トランザクションをコミットできなかった場合や，処理の不整合を検出した場合には，これまでの処理をロールバックで取り消して，データの整合性を保ちます。トランザクションがロールバックした要因はログに取得できます。ロールバック要因をログに取得するかどうか，トランザクション関連定義のtrn_rollback_information_putオペランドで指定してください。

TP1/EEはトランザクションブランチごとに経過時間を監視しています。経過時間を過ぎてもトランザクションが終了しないときには，トランザクションをロールバックします。経過時間の監視については，「11.4.3　トランザクション処理時間監視」を参照してください。

トランザクションのロールバックを次の図に示します。

図3‒21　トランザクションのロールバック

(1)　グローバルトランザクションの完了

グローバルトランザクション全体が完了するのは，次に示すどちらかの時点です。

トランザクションブランチがすべてコミットまたはすべてロールバックしたあとに各ノードでのトランザクション完了処理が終了する時点

ヒューリスティック決着がすべてのトランザクションブランチに対して完了する時点

グローバルトランザクション全体が完了した時点で，このグローバルトランザクションに関する情報は，すべて消滅します。

ヒューリスティック決着については，「3.2.4(1)(b)　ヒューリスティック決着」を参照してください。

(2)　トランザクションの決着

トランザクションブランチの決着結果は，そのトランザクションブランチが属するグローバルトランザクションの決着結果と一致している必要があります。トランザクションブランチの決着結果がグローバルトランザクションの決着結果と一致しない場合は，ヒューリスティック決着となります。

ヒューリスティック決着については，「3.2.4(1)(b)　ヒューリスティック決着」を参照してください。

3.2.4　同期点処理

トランザクションをコミットするかどうかを最終的に決定する同期点での処理について説明します。

(1)　2相コミット

(a)　2相コミットの概要

複数の資源を更新するとき，トランザクションは同期点で，2相コミットと呼ばれる方法で最終的に資源を更新するかどうか決定します。2相コミットとは，同期点処理を資源の更新準備処理（プリペア処理）と，資源の更新処理（コミット処理またはロールバック処理）の二段階に分ける方法です。同期点処理を二つの相に分けることで，複数の資源を矛盾なく更新できます。

2相コミットの詳細については，マニュアル「TP1/Server Base Enterprise Option プログラム作成の手引」を参照してください。

(b)　ヒューリスティック決着

ルートトランザクションブランチがトランザクションブランチにコミットの準備を指示したあとで通信障害が発生して，ルートトランザクションブランチでの決着がトランザクションブランチに届かなくなることを，ヒューリスティックハザードといいます。ヒューリスティックハザードが起こった場合には，コマンドを使って，トランザクションブランチごとにトランザクションを強制的に決着できます。ルートトランザクションブランチの同期点処理を待たないで，コマンドでトランザクションブランチのトランザクションを強制的に決着することを，ヒューリスティック決着といいます。

ヒューリスティック決着の詳細については，マニュアル「TP1/Server Base Enterprise Option プログラム作成の手引」を，ヒューリスティック決着の操作方法については，「6.4.2　トランザクションの強制決着」を参照してください。

(2)　トランザクションの最適化

TP1/EEのトランザクションマネジャは，トランザクション処理の性能を上げるため，トランザクション関連定義の指定に従って次に示す最適化の処理をしています。

1相最適化

リードオンリー最適化

トランザクションの最適化は，クライアント側のトランザクションブランチとサーバ側のトランザクションブランチとの間で，同期点処理の効率を上げることを目的としています。一つのグローバルトランザクション内で複数の最適化を混在できます。

トランザクションの最適化の詳細については，マニュアル「TP1/Server Base Enterprise Option プログラム作成の手引」を参照してください。

(3)　タイムアウト時の処理

TP1/EEがサービスを要求したあと，サービス要求先でアドレス未解決，異常終了などが発生すると，応答待ちタイムアウトが発生します。

応答待ちタイムアウト発生時の処理の流れを次に示します。

図3‒22　応答待ちタイムアウト発生時の処理の流れ

TP1/EEは，TP1/EE（SPP1）およびTP1/EE（SPP2）にサービスを要求したあと，同期点処理をするためにTP1/EE（SPP1）およびTP1/EE（SPP2）からの応答を待ちます。TP1/EE（SPP2）のアドレス未解決，異常終了などが原因でTP1/EE（SPP2）が応答に失敗した場合，TP1/EEは応答待ちタイムアウトとなり，TP1/EE（SPP2）に対してロールバック要求を送信しないでTP1/EEおよびTP1/EE（SPP1）のロールバック処理だけをします。TP1/EE（SPP2）は，同期点メッセージ受信待ちタイムアウトを検知して，TP1/EE（SPP2）のロールバック処理をします。ロールバック処理が完了すると，コミット決着失敗通知（ERRTRNR）が登録されます。

3.2.5　XAインタフェースによるトランザクション制御

XAインタフェースによるトランザクション制御について説明します。

(1)　XAインタフェースの概要

XAインタフェースは，X/Openが規定したDTPモデルの一部です。

XAインタフェースとは，トランザクションマネジャとリソースマネジャとの間の指示のやり取りを規定したものです。したがって，UAPがXAインタフェースを直接使用することはありません。TP1/EEとリソースマネジャが使用するXAライブラリ・サブルーチンについては，マニュアル「OpenTP1 解説」のXAインタフェースについての説明を参照してください。

(2)　XAインタフェースによるコネクション制御

リソースマネジャとのコネクションは，処理要求（トランザクション）ごとに確立・解放するかどうかを選択できます。コネクションをトランザクションごとに確立・解放するかどうかは，トランザクション関連定義のtrn_rm_open_close_scopeオペランドで指定します。

なお，HiRDBと連携する場合の環境設定については「6.8.2(1)　環境設定（HiRDB連携時）」を，Oracleと連携する場合の環境設定については「6.8.3(1)　環境設定（Oracle連携時）」を参照してください。

(a)　トランザクションごとに確立・解放しない場合

トランザクションの実行性能を優先したい場合は，trn_rm_open_close_scopeオペランドの指定を省略するか，またはprocessを指定してください。TP1/EEは，xa_open関数を呼び出して1対1のコネクションをリソースマネジャと確立します。確立したコネクションは，xa_close関数を呼び出すことで解放されます。xa_open関数は，処理スレッドの開始処理の中で呼び出され，処理スレッドの起動中は常にxa_open関数呼び出し後の状態になります。したがって，トランザクションごとにコネクションを確立・解放することがありません。このため，コネクション制御時のオーバヘッドを軽減できます。

(b)　トランザクションごとに確立・解放する場合

次に示す場合は，trn_rm_open_close_scopeオペランドにtransactionを指定してください。

リソースマネジャの資源を有効利用したい場合

リソースマネジャの障害を復旧したあとのSQLが，コネクションの切断によってエラーとなるのを回避したい場合

リソースマネジャによっては，TP1/EEまたはリソースマネジャがトランザクションの開始時またはSQLの実行時にコネクションを再接続します。この場合，コネクションの切断が要因となるSQLエラーは発生しません。コネクションが切断された場合の再接続については，各リソースマネジャのマニュアルを参照してください。

trn_rm_open_close_scopeオペランドにtransactionを指定した場合，TP1/EEはトランザクションの開始時にxa_open関数を発行してコネクションを確立し，トランザクションの終了時にxa_close関数を発行してコネクションを解放します。ただし，APIによる連鎖モードのコミットおよび連鎖モードのロールバックの場合は，UAPリターン後のトランザクション終了時にxa_close関数を発行します。

(3)　処理スレッドを使用したアンディレード回復時のコネクション制御

プロセスダウン後にアンディレード回復を実行する場合，トランザクション関連定義のtrn_undelayed_recover_threadオペランドにYを指定すると，回復スレッドと処理スレッドの両方を使用してプロセスを回復させることができます。回復スレッドだけではなく処理スレッドも使用することによって，アンディレード回復処理に掛かる時間を短縮できます。

処理スレッドを使用したアンディレード回復の場合，スレッド開始処理時ではなく，トランザクション開始時にxa_open関数を呼び出して，リソースマネジャとのコネクションを確立します。コネクションの確立に成功した場合，次回のトランザクション開始時にはxa_open関数を呼び出す必要がありません。

アンディレード回復の詳細については，「11.1.2(2)　アンディレード回復」を参照してください。

(4)　xa_open関数のリトライ

TP1/EE開始時およびトランザクション開始時にリソースマネジャのオープン処理（xa_open関数）でエラーが発生した場合は，xa_open関数の呼び出しをリトライします。リトライ回数はトランザクション関連定義のtrn_retry_count_rm_openオペランドまたはtrn_retry_count_rm_open_mimeオペランドで，リトライ間隔はトランザクション関連定義のtrn_retry_interval_rm_openオペランドまたはtrn_retry_interval_rm_open_mimeオペランドで指定します。リトライ回数がtrn_retry_count_rm_openオペランドまたはtrn_retry_count_rm_open_mimeオペランドの指定値を超えた場合は，エラーメッセージが出力されたあと，トランザクション関連定義のtrn_wait_rm_openオペランドの指定値に従って処理されます。ただし，前回のリソースマネジャのオープン処理でエラーが発生していた場合は，エラーメッセージは出力されません。

3.2.6　エラートランザクション

TP1/EEでは，メッセージ送受信の処理でエラーや障害が起こった場合，ユーザによる決着処理ができるようにエラートランザクションを起動します。

TP1/EEで起動されるエラートランザクションには，次に示す種類があります。

不正サービス名称検出通知（ERRTRN1）

サービス閉塞通知（ERRTRN2）

UAP異常終了通知（ERRTRN3）

タイマトランザクション起動破棄通知（ERRTRN4）

コミット決着失敗通知（ERRTRNR）

送信障害通知（ERRTRNS）

エラートランザクションの詳細については，マニュアル「TP1/Server Base Enterprise Option プログラム作成の手引」を参照してください。

3.2.7　監視トランザクション

TP1/EEでは，次に示す監視をトランザクションで行います。

(1)　オンライン開始監視

オンライン開始前に，オンライン開始監視トランザクションを起動して，オンラインを開始できるかどうかチェックします。オンライン開始監視トランザクションは，正常開始の場合も再開始の場合も起動します。オンライン開始監視トランザクションを強制停止させることはできません。

強制停止の処理については，「6.1.2　TP1/EEの終了」を参照してください。

(2)　プロセス終了監視

プロセス終了（正常終了または計画停止A）時に，プロセス終了監視トランザクションを起動して，プロセスを終了できるかどうかチェックします。プロセス終了（正常終了または計画停止A）時に登録済みの処理キュー終了後から，システム終了トランザクション終了後まで監視します。

正常終了または計画停止Aの処理については，「6.1.2　TP1/EEの終了」を参照してください。

(3)　インタバルタイマ監視

一定時間ごとにインタバルタイマ監視トランザクションを起動して，TP1/EEを監視します。プロセス初期化トランザクション起動前からプロセス終了トランザクション起動前まで監視します。

3.3　リモートAPI機能

リモートAPI機能の概要について説明します。リモートAPI機能の詳細については，マニュアル「TP1/Server Base Enterprise Option プログラム作成の手引」を参照してください。

3.3.1　概要

リモートAPI機能とは，クライアント側のノードにあるUAPが発行したAPIを，TP1/EEのプロセスで代理実行する機能です。リモートAPI機能を要求するクライアント側のノードにあるUAPをrapクライアントといいます。rapクライアントが発行したAPIを，OpenTP1のrapリスナー（TP1/EEではrap受信スレッド）が受け付け，rapサーバがサーバ側のノードで実行します。TP1/EEは，rapクライアントとしても，rapサーバとしても動作します。

リモートAPI機能で代理実行できるAPIを次に示します。

ee_rpc_call関数

ee_rpc_call関数を呼び出す場合（TP1/EEがrapクライアントとして動作する場合）は，次に示すように定義を指定しておく必要があります。

RPC関連定義のrpc_destination_modeオペランドにnamdonly以外を指定

サービスグループ情報関連定義のeesvgdef定義コマンドの-tオプションにRAPを指定

dc_rpc_call関数

TP1/EEがrapサーバとして動作する場合だけ使用できます。TP1/EEがrapクライアントとして動作する場合は使用できません。

rapサーバとして動作するTP1/EEは，サポートしていないAPIの代理実行を要求された場合，rapクライアントに代理実行エラー応答メッセージを返します。また，トランザクショナルRPC形式のリモートAPI要求を受け付けた場合，非トランザクショナルRPCとして処理します。

リモートAPI機能で非同期応答型RPCは使用できません。非同期応答型RPCを使用した場合，通常のRPCとして動作します。また，トランザクション内からリモートAPI機能を使用してee_rpc_call関数を発行してもトランザクションとして処理されません。

TP1/Server Baseがrapクライアントである場合，rapクライアント側で，rapサーバ（TP1/EE）のサービス情報（ホスト名およびポート番号）を定義しておきます。rapサーバのサービス情報は，TP1/Server Baseのユーザサービスネットワーク定義のdcsvgdef定義コマンドで定義できます。その際，-wオプションを必ず指定してください。

TP1/Server BaseがrapクライアントでTP1/EEがrapサーバの場合のリモートAPI機能を次の図に示します。

図3‒23　リモートAPI機能（TP1/EEがrapサーバの場合）

3.3.2　常設コネクション

rapクライアントとrapサーバは，論理的な通信路である常設コネクションを使用して，リモートAPIのメッセージを送受信します。常設コネクションは，rapクライアントとrapサーバとを1対1で関連づけます。

TP1/EEでは，常設コネクションの管理にオートコネクトモードを使用します。オートコネクトモードでは，コネクションの確立・解放をOpenTP1が管理します。

リモートAPI要求メッセージの受信時間監視

常設コネクションの確立後，最初のリモートAPI要求メッセージを受信するまでの時間を監視します。一定時間を過ぎてもリモートAPI要求メッセージが到着しない場合は，常設コネクションを切断します。切断時にメッセージを出力するかどうかを，RPC関連定義のrpc_first_connect_errmsgオペランドで指定できます。

同時接続するrapクライアントの最大数

rapサーバに同時接続するrapクライアントの最大数を，RPC関連定義のrap_max_clientオペランドで指定できます。同時接続するrapクライアントの数がrap_max_clientオペランドの指定値を超えた場合，または，プロセス終了処理中の場合は，常設コネクション確立エラー応答メッセージを送信し，常設コネクションを切断します。

常設コネクション確立状態でTP1/EEプロセス終了

常設コネクションが確立している状態で，rapサーバとして動作するTP1/EEが正常終了または計画停止Aになった場合の動作を，RPC関連定義のrpc_rap_remaincon_endwaitオペランドで指定できます。RPC関連定義のrpc_rap_remaincon_endwaitオペランドにYを指定すると，常設コネクションが解放されるまでrapサーバとして動作するTP1/EEの終了を保留します。このとき，RPC関連定義のrap_msg_output_intervalオペランドで指定した時間間隔で，接続中のrapクライアント数表示メッセージを出力します。

問い合わせ間隔最大時間（RPC関連定義のrap_inquire_timeオペランドで指定）に0を指定し，かつ，rapクライアントが常駐SPPの場合，常設コネクションが解放されないことがあります。この場合は，eerpcrapclsコマンドで常設コネクションを切断するか，または，eesvstopコマンドの-fオプションでTP1/EEプロセスを強制終了させます。

3.3.3　rapクライアントマネジャ

rapクライアントが常設コネクションを確立していると認識していても，その常設コネクションが有効でない場合（rapサーバ側マシンの電源の切断など）があります。この場合，rapクライアントがee_rpc_call関数を呼び出してrapサーバにサービス要求を送信しても，rapサーバでサービス要求は受信されません。さらに，rapクライアントには，タイムアウトになるまでee_rpc_call関数の応答が返ってきません。

この現象を回避するために，rapクライアントマネジャ機能を使用します。rapクライアントマネジャ機能を使用すると，rapサーバがrapクライアントに起動通知をすることで，現在の常設コネクションが有効かどうかを判断できます。また，現在のコネクションが無効であった場合は，新しく有効なコネクションを確立して代理実行を要求します。

(1)　rapクライアントマネジャ機能を使用するための準備

rapクライアントマネジャ機能を使用するには，次に示すRPC関連定義のオペランドを指定する必要があります。

rapクライアントとして動作するTP1/EEの場合

rap_client_manager_portオペランドを指定

rap_listen_infオペランドを指定

rapサーバとして動作するTP1/EEの場合

rap_notifyオペランドにYを指定

rap_client_manager_nodeオペランドを指定

(2)　rapクライアントマネジャ機能を使用した場合の処理の流れ

rapクライアントマネジャ機能を使用した場合，rapクライアントが代理実行を要求する前に，rapサーバがrapクライアントのrapクライアントマネジャに対して起動通知を送信します。rapクライアントマネジャは，rapサーバのrapリスナーから起動通知を受信します。rapクライアントマネジャは，この起動通知によって現在のコネクションが有効かどうかを判断します。コネクションが無効であると判断した場合，不要なコネクションを解放し，再度コネクションを確立したあとで，rapサーバに対して代理実行を要求します。

rapクライアントマネジャ機能を使用した場合の例を次の図に示します。

図3‒24　rapクライアントマネジャ機能を使用した場合の例

この図の場合に指定するオペランドの例を次に示します。

TP1/EE（rapクライアント）

eesvgdef -g eeserver1 -h HOST_D:PORT_D -t RAP
rap_client_manager_port = PORT_C
rap_listen_inf = "ees1:PORT_B=HOST_D:PORT_D"

TP1/EE（rapサーバ）

rap_listen_port = PORT_B
rap_notify = Y
rap_client_manager_node = "HOST_A:PORT_C"

rapクライアントマネジャ機能を使用した場合の例について説明します。

rapクライアントとrapサーバは，常設コネクション-Aを確立していますが，rapサーバの電源が切断されます。

rapサーバが再起動されます。

rapサーバのrapリスナーは，RPC関連定義のrap_client_manager_nodeオペランドに指定されたノードのrapクライアントマネジャに対して起動通知をします。

rapクライアントは，rapサーバから起動通知を受信したことによって常設コネクション-Aが無効であると判断して，常設コネクション-Aを解放します。

rapクライアントは，再度コネクションを確立（常設コネクション-B）してrapサーバに対して代理実行を要求します。

3.4　DBキュー機能

DBキュー機能を使用すると，HiRDBなどのデータベース上に作成したキュー（DBキュー）を介して，TP1/EE内や，TP1/EEと他システムとのシステム間で，非同期型のメッセージ送受信ができます。また，DBキューを使用したシステム間通信では，通信先に合わせて，TCP/IPまたはRPCのどちらの通信形態を使用するかを選択できます。

DBキュー機能の運用方法については，「6.6　DBキュー機能の運用」を参照してください。

3.4.1　DBキューを使用したメッセージ送受信の方式

DBキューを使用したメッセージ送受信の方式には，次の2種類があります。

AP間通信

DBキューに書き込んだメッセージを読み出すトランザクションを，TP1/EEがスケジュールします。DBキューにメッセージを書き込んだトランザクションがコミットすると，TP1/EEによってメッセージを読み出すトランザクションが開始されます。

読み出したメッセージのトランザクションは，サービス関数を呼び出してからリターンするまでです。サービス関数内で連鎖モードの同期点を取得した場合，再起動トランザクションも読み出したメッセージのトランザクションになります。

読み出したメッセージは，サービス関数がリターンすると，読み出し済みになります。

ユーザキューアクセス

DBキューに書き込んだメッセージを読み出すトランザクションを，AP間通信をすることなく，ユーザが独自にスケジュールします。DBキューに書き込んだメッセージは，関数の発行によってユーザの任意のタイミングで読み出せます。

読み出したメッセージのトランザクションは，読み出し要求をしてから同期点を取得するまでです。

サービス関数内で連鎖モードの同期点を取得した場合，同期点の取得前に読み出したメッセージは読み出し済みになり，ほかのトランザクションで次のメッセージを読み出せるようになります。

AP間通信の概要については「3.4.2　DBキューを使用したAP間通信の概要」を，ユーザキューアクセスの概要については「3.4.3　DBキューを使用したユーザキューアクセスの概要」を参照してください。

3.4.2　DBキューを使用したAP間通信の概要

DBキューを使用したAP間通信では，同一システム内でのAP間通信，および他システムとのAP間通信（システム間通信）ができます。

(1)　同一システム内でのAP間通信

TP1/EE内でのAP間通信の場合，メッセージ送信元APのメッセージ書き込み要求を行ったトランザクションのコミットを契機として，DBキューにメッセージを送信します。メッセージ送信先APでは，メッセージ読み出しトランザクション起動時にメッセージを受信します。

DBキューを使用したAP間通信の流れを次の図に示します。

図3‒25　DBキューを使用したAP間通信の流れ

DBキューを使用したAP間通信の詳細については，マニュアル「TP1/Server Base Enterprise Option プログラム作成の手引」のDBキューによるメッセージ制御の説明を参照してください。

(2)　他システムとのAP間通信（システム間通信）

TP1/EE同士，またはTP1/EEとJ2EEとの間で，DBキューを使用してシステム間通信ができます。ただし，Oracleをリソースマネジャとして使用する場合，TP1/EEとJ2EEとの間では，DBキューを使用したシステム間通信はできません。

システム間通信の場合，送信元APとは別のノードに送信先APがあるため，DBキューを共用データベースとして使用します。メッセージ送信元APのメッセージ書き込み要求を行ったトランザクションのコミットを契機として，DBキューにメッセージを送信します。メッセージ送信先APでは，メッセージ読み出しトランザクション起動時にメッセージを受信します。

DBキューを使用したシステム間通信の流れを次の図に示します。

図3‒26　DBキューを使用したシステム間通信の流れ

DBキューを使用したシステム間通信の詳細については，マニュアル「TP1/Server Base Enterprise Option プログラム作成の手引」のDBキューによるメッセージ制御の説明を参照してください。

3.4.3　DBキューを使用したユーザキューアクセスの概要

DBキューを使用したユーザキューアクセスでは，同一システム内でのユーザキューアクセス，および他システムとのユーザキューアクセス（システム間通信）ができます。

(1)　同一システム内でのユーザキューアクセス

TP1/EE内のAP間でDBキューを使用したユーザキューアクセスをする場合，メッセージ送信元APのメッセージ書き込み要求を行ったトランザクションのコミットを契機として，DBキューにメッセージを送信します。メッセージ送信先APでは，ee_dbq_msgget関数を発行することで，任意のタイミングでメッセージを受信します。

TP1/EE内のAP間でのDBキューを使用したユーザキューアクセスの流れを次の図に示します。

図3‒27　TP1/EE内のAP間でのDBキューを使用したユーザキューアクセスの流れ

DBキューを使用したユーザキューアクセスの詳細については，マニュアル「TP1/Server Base Enterprise Option プログラム作成の手引」のDBキューによるメッセージ制御の説明を参照してください。

(2)　他システムとのユーザキューアクセス（システム間通信）

TP1/EE同士，またはTP1/EEとJ2EEとの間で，DBキューを使用したユーザキューアクセスによるシステム間通信ができます。ただし，Oracleをリソースマネジャとして使用する場合，TP1/EEとJ2EEとの間では，DBキューを使用したユーザキューアクセスによるシステム間通信はできません。

システム間通信の場合，送信元APとは別のノードに送信先APがあるため，DBキューを共用データベースとして使用します。メッセージ送信元APのメッセージ書き込み要求を行ったトランザクションのコミットを契機として，DBキューにメッセージを送信します。メッセージ送信先APでは，ee_dbq_msgget関数を使用することで，任意のタイミングでメッセージを受信します。

DBキューを使用したユーザキューアクセスによるシステム間通信の流れを次の図に示します。

図3‒28　DBキューを使用したユーザキューアクセスによるシステム間通信の流れ

DBキューを使用したユーザキューアクセスの詳細については，マニュアル「TP1/Server Base Enterprise Option プログラム作成の手引」のDBキューによるメッセージ制御の説明を参照してください。

3.4.4　DBキューの管理

(1)　システム定義によるDBキューの関連づけ

DBキュー機能では，DBキュー機能関連定義の各種定義コマンドを使用して，次の図に示すようなDBキューの関連づけをします。

図3‒29　システム定義によるDBキューの関連づけ

DBキューとDBキューグループの関連づけ

DBキュー名はdbqdef定義コマンドの-qオプションで，DBキューグループ名はdbqgrpdef定義コマンドの-dオプションで指定します。dbqdef定義コマンドの-dオプションで，DBキューをDBキューグループに関連づけます。

DBキューサービスとDBキューサービスグループの関連づけ

DBキューサービス名はdbqsrvdef定義コマンドの-vオプションで，DBキューサービスグループ名はdbqsvgdef定義コマンドの-pオプションで指定します。dbqsrvdef定義コマンドの-pオプションで，DBキューサービスをDBキューサービスグループに関連づけます。

DBキューグループと，DBキューサービスグループまたはサービスグループの関連づけ

DBキューグループは，DBキューサービスグループまたはサービスグループのどちらかと関連づけられます。両方と関連づけることはできません。

DBキューグループとDBキューサービスグループを関連づけるには，dbqsvgdef定義コマンドの-dオプションおよびdbqgrpdef定義コマンドの-pオプションを指定します。また，dbqsrvdef定義コマンドの-qオプションを指定すると，DBキューサービスとDBキューを関連づけることもできます。

DBキューグループとサービスグループを関連づけるには，dbqgrpdef定義コマンドの-eオプションを指定します。

(2)　メッセージ書き込み要求時のDBキューとDBキューグループの指定

DBキューにメッセージを書き込むには，ee_dbq_msgput関数を呼び出します。ee_dbq_msgput関数では，メッセージの書き込み先としてDBキューまたはDBキューグループを指定できます。

DBキューを指定した場合

指定したDBキューにメッセージを書き込みます。

DBキューグループを指定した場合

指定したDBキューグループ下にある任意のDBキューにメッセージを書き込みます。メッセージを書き込むDBキューを決定する手順を次に示します。

DBキュー名（DBキュー機能関連定義のdbqgrpdef定義コマンドで指定）をキーにして，昇順にソートします。

ソートした順番で，前回書き込んだDBキューの次のDBキューにメッセージを書き込みます。

最後のDBキューに書き込んだ場合，次は先頭のDBキューに戻ります。

(a)　DBキューの競合回避

DBキューの競合を避けるため，1トランザクションで書き込むDBキュー数を最小にします。

DBキューグループ指定のメッセージ書き込み要求を，1トランザクションで複数回行った場合，一つのDBキューにすべてのメッセージを書き込みます。

また，1トランザクションでDBキューグループ指定とDBキュー指定のメッセージ書き込み要求を行った場合，DBキュー指定で指定したDBキューにDBキューグループ指定で要求したメッセージを書き込みます。1トランザクションで複数のDBキュー指定の書き込み要求を行い，その後DBキューグループ指定の書き込み要求を行った場合，最初にDBキュー指定のメッセージ書き込み要求を行ったDBキューにDBキューグループ指定のメッセージを書き込みます。

(b)　DBキューグループ指定で書き込んだメッセージの読み出し処理

DBキューを使用したユーザキューアクセスをしない場合にDBキューグループ指定でメッセージ書き込み要求を行ったときは，TP1/EEが選択した任意のDBキューに書き込みます。DBキューグループ指定でメッセージ書き込み要求を行い，特定のDBキューサービスで処理を行いたい場合は，DBキュー機能関連定義のdbqsrvdef定義コマンドでDBキューサービスを定義する際に，同一DBキューグループのDBキューを指定してください。

3.4.5　DBキュー機能のトランザクションの流れ（AP間通信）

DBキュー機能を使用したAP間通信でのメッセージ送受信トランザクションの流れについて説明します。

(1)　メッセージ書き込みから読み出しまでの処理の流れ（同一システム内でのAP間通信）

DBキューを使用した同一システム内でのAP間通信について，メッセージ書き込みから読み出しまでの処理の流れを次に示します。

図3‒30　メッセージ書き込みから読み出しまでの処理の流れ（同一システム内でのAP間通信）

サービストランザクション（メッセージ書き込み要求を行うトランザクション）で起動されたUAP1で，ee_dbq_msgput関数を呼び出してメッセージの書き込み処理を要求します。

サービストランザクションのコミットを契機に，DBキューにメッセージを書き込みます。

メッセージ読み出しトランザクションの開始時にDBキューからメッセージを読み出します。

メッセージ読み出しトランザクションでUAP2を起動して，DBキューから読み出したメッセージをUAP2に渡します。

メッセージ読み出しトランザクションのコミット後，未読み出しメッセージがなくなるまでメッセージ読み出しトランザクションを繰り返し起動します。

(2)　メッセージ書き込みから読み出しまでの処理の流れ（他システムとのAP間通信）

DBキューを使用した他システムとのAP間通信について，メッセージ書き込みから読み出しまでの処理の流れを次に示します。

図3‒31　メッセージ書き込みから読み出しまでの処理の流れ（他システムとのAP間通信）

システムAでは，サービストランザクション（メッセージ書き込み要求を行うトランザクション）で起動されたUAP1で，ee_dbq_msgput関数を呼び出してメッセージの書き込み処理を要求します。

システムAでは，サービストランザクションのコミットを契機に，DBキューにメッセージを書き込みます。

システムAからシステムBに，イベントを送信します。

イベントを受信したシステムBでは，メッセージ読み出しトランザクションの開始時にDBキューからメッセージを読み出します。

システムBでUAP2を起動して，DBキューから読み出したメッセージをUAP2に渡します。

システムBでは，メッセージ読み出しトランザクションのコミット後，未読み出しメッセージがなくなるまでメッセージ読み出しトランザクションを繰り返し起動します。

(3)　読み出したメッセージのロールバックを要求された場合

DBキューからメッセージを読み出したあとに，ユーザからメッセージ読み出しトランザクションのロールバックを要求された場合，TP1/EEでロールバック処理をします。ロールバック後，ロールバックによって読み出しを取り消したメッセージを再度読み出すトランザクションを起動します。

ロールバック後，ロールバックによって読み出しを取り消したメッセージを破棄して次のメッセージから読み出したい場合は，ロールバック時にee_dbq_rbskip関数を呼び出します。

(4)　メッセージの読み出し中にスレッドダウンが発生した場合

DBキューからメッセージを読み出している最中にスレッドダウンが発生した場合，回復トランザクションでDBキューの回復処理をします。トランザクション回復後，エラートランザクション（ERRTRN3）を起動して，障害発生を通知します。

メッセージの読み出し中に，スレッドの強制終了を指定したロールバックを要求した場合，スレッドダウンします。ただし，スケジュール停止状態にはならないため，ロールバックによって読み出しを取り消したメッセージを再度DBキューから読み出すトランザクションを起動します。また，同一メッセージを再度読み出すトランザクションとは別に，スレッドダウンによってエラートランザクション（ERRTRN3）を起動します。同一メッセージを再度読み出すトランザクションとエラートランザクションの順序は保証されません。したがって，メッセージの読み出し中にスケジュール停止状態などにしたい場合は，エラートランザクション（ERRTRN3）起動後ではなく，ロールバックを要求する前に行ってください。

(5)　メッセージの書き込み中にDB障害が発生した場合

DBキューにメッセージを書き込んでいる最中にDB障害が発生した場合，メッセージ書き込み要求を行ったトランザクションをロールバックしてからエラートランザクション（ERRTRNR）を起動して，障害発生を通知します。

(6)　メッセージの読み出し中にDB障害が発生した場合

DBキューからメッセージを読み出している最中にDB障害が発生した場合，メッセージの読み出しを停止させ，トランザクションをロールバックします。ロールバックしたあとにエラートランザクション（ERRTRNR）を起動して，障害発生を通知します。

その後，ユーザからメッセージ読み出し停止解除を要求された場合，読み出し停止状態を解除して，メッセージ読み出しトランザクションを起動します。

3.4.6　DBキュー機能のトランザクションの流れ（ユーザキューアクセス）

DBキュー機能を使用したユーザキューアクセスでのメッセージ送受信トランザクションの流れについて説明します。

(1)　メッセージ書き込みの処理の流れ（同一システム内でのユーザキューアクセス）

DBキューを使用したユーザキューアクセスでは，連鎖モードのコミット要求およびサービス関数（UAP）のリターン時に，DBキューへの書き込み処理をします。

DBキューを使用した同一システム内でのユーザキューアクセスについて，メッセージ書き込みの処理の流れを次に示します。

図3‒32　メッセージ書き込みの処理の流れ（同一システム内でのユーザキューアクセス）

サービストランザクション（メッセージ書き込み要求を行うトランザクション）で起動されたUAPで，ee_dbq_msgput関数を呼び出してメッセージの書き込み処理を要求します。

UAPがリターンします。

サービストランザクションのコミットを契機に，DBキューにメッセージを書き込みます。

(2)　メッセージ書き込みの処理の流れ（他システムとのユーザキューアクセス）

DBキューを使用したユーザキューアクセスでは，連鎖モードのコミット要求およびサービス関数（UAP）のリターン時に，DBキューへの書き込み処理をします。

DBキューを使用した他システムとのユーザキューアクセスについて，他システムが読み出すDBキューにメッセージを書き込む場合の処理の流れを次に示します。

図3‒33　他システムが読み出すDBキューにメッセージを書き込む場合の処理の流れ（他システムとのユーザキューアクセス）

サービストランザクション（メッセージ書き込み要求を行うトランザクション）で起動されたUAPで，ee_dbq_msgput関数を呼び出してメッセージの書き込み処理を要求します。

UAPがリターンします。

サービストランザクションのコミットを契機に，DBキューにメッセージを書き込みます。

DBキューを読み出す側の他システムに対して，DBキューにメッセージを書き込んだことを通知するためのイベントを送信するトランザクションを開始します。

イベントを送信します。イベントを受信した他システムでは，DBキューの書き込み通番を更新するためのトランザクションを開始し，未読み出しメッセージ数を管理します。

(3)　メッセージ読み出しの処理の流れ

DBキューを使用したユーザキューアクセスでは，連鎖モードのコミット要求およびサービス関数（UAP）のリターン時に，DBキュー内のメッセージを読み出し済みにします。

DBキューを使用したユーザキューアクセスについて，メッセージ読み出しの処理の流れを次に示します。

図3‒34　メッセージ読み出しの処理の流れ（ユーザキューアクセス）

メッセージ読み出しトランザクションで，メッセージの読み出し処理をするUAPを起動します。

UAP内でee_dbq_msgget関数を呼び出して，DBキューに書き込まれたメッセージの読み出し処理を要求します。

DBキューに書き込まれたメッセージを読み出します。

読み出したメッセージをUAPに渡します。

UAPがリターンします。

メッセージ読み出しトランザクションのコミットのあと，3.でDBキューから読み出したメッセージを読み出し済みにします。

(4)　読み出したメッセージのロールバックを要求された場合の処理の流れ

DBキューを使用したユーザキューアクセスでは，連鎖モードのロールバック要求でDBキューのee_dbq_msgget関数による処理がロールバックされます。そのため，再度ee_dbq_msgget関数を実行すると，同じメッセージが読み出されます。サービス関数（UAP）のリターン時には，DBキュー内のメッセージは読み出し済みになります。

DBキューを使用したユーザキューアクセスについて，読み出したメッセージのロールバックを要求された場合の処理の流れを次に示します。

図3‒35　読み出したメッセージのロールバックを要求された場合の処理の流れ（ユーザキューアクセス）

メッセージ読み出しトランザクションで，メッセージの読み出し処理をするUAPを起動します。

UAP内でee_dbq_msgget関数を呼び出して，DBキューに書き込まれたメッセージの読み出し処理を要求します。

DBキューに書き込まれたメッセージを読み出します。

読み出したメッセージをUAPに渡します。

UAPがロールバックを要求します。ロールバック処理では，DBキューに対しての操作はありません。

UAP内でee_dbq_msgget関数を呼び出して，DBキューに書き込まれたメッセージの読み出し処理を要求します。

DBキューに書き込まれたメッセージを読み出します。このとき読み出されるメッセージは，3.でDBキューから読み出したメッセージと同じメッセージです。

読み出したメッセージをUAPに渡します。

UAPがリターンします。

メッセージ読み出しトランザクションのコミットのあと，7.でDBキューから読み出したメッセージを読み出し済みにします。

3.4.7　DBキュー読み出しサーバ変更機能

DBキュー機能では，一つのサーバでDBキューからメッセージを読み出します。そのため，DBキュー読み出しサーバが障害でダウンした場合は，DBキューに書き込まれるメッセージを読み出せなくなるため，DBキューが未読み出しメッセージで満杯になるおそれがあります。この現象は，DBキュー読み出しサーバをeedbqchgrコマンドで変更することによって回避できます。DBキュー読み出しサーバは，サーバがダウンした場合だけではなく，サーバが起動中の場合にも変更できます。

(1)　DBキュー読み出しサーバがダウンしている場合

DBキュー読み出しサーバがダウンした場合のサーバ変更処理の流れを次の図に示します。

図3‒36　DBキュー読み出しサーバの変更処理の流れ（サーバがダウンした場合）

(2)　DBキュー読み出しサーバが起動中の場合

起動中のDBキュー読み出しサーバでeedbqstopコマンドを実行して，DBキューの読み出しを停止します。次に，eedbqlsコマンドを実行してDBキューの情報を表示します。DBキューのステータスがC（読み出し停止の状態）になっていることを確認してから，eedbqchgrコマンドを実行してDBキュー読み出しサーバを変更します。

DBキュー読み出しサーバが起動中の場合のサーバ変更処理の流れを次の図に示します。

図3‒37　DBキュー読み出しサーバの変更処理の流れ（サーバが起動中の場合）

(3)　注意事項

DBキュー読み出しサーバを変更する際，変更前と変更後のサーバが同じ製品になるようにしてください。DBキュー読み出しサーバをTP1/EEからTP1/EE以外の製品（Cosminexus Reliable Messagingなど）に変更したり，TP1/EE以外の製品からTP1/EEに変更したりすることはできません。

ユーザキューアクセスでDBキューから読み出しを実行するTP1/EEがある場合に，誤ってほかのTP1/EEからeedbqchgrコマンドが実行されたときは，処理の状況によって次の結果になります。

DBキューから読み出しをしていたTP1/EEのトランザクションがロールバックする

ee_dbq_msgget関数によるメッセージの読み出しが成功したあとに，ほかのTP1/EEからeedbqchgrコマンドが実行された場合，ee_dbq_msgget関数を発行したトランザクションがロールバックします。

DBキューから読み出しをしていたTP1/EEが発行したee_dbq_msgget関数がエラーリターンする

ほかのTP1/EEからのeedbqchgrコマンドの実行後に，DBキューから読み出しをしようとしたTP1/EEがee_dbq_msgget関数を発行した場合，ee_dbq_msgget関数がエラーリターンします。

3.4.8　DBキュー書き込み抑止機能

DBキュー機能では，一つのサーバでDBキューからメッセージを読み出します。そのため，DBキュー読み出しサーバの終了後は，ほかのサーバがDBキューに書き込むメッセージを読み出せなくなるため，DBキューが未読み出しメッセージで満杯になるおそれがあります。この現象は，サーバ終了前にeedbqwtprコマンドを実行してDBキューへのメッセージの書き込みを抑止することによって回避できます。メッセージの書き込み抑止状態は，再度サーバを正常開始する際に解除されます。

また，TP1/EE以外の製品（Cosminexus Reliable Messagingなど）からのメッセージの書き込みも抑止できます。

DBキューの書き込み抑止および書き込み抑止解除の流れを次の図に示します。

図3‒38　DBキューの書き込み抑止および抑止解除の流れ

(1)　注意事項

eedbqwtprコマンドで書き込みを抑止しているDBキューに対して，ee_dbq_msgput関数でDBキューまたはDBキューグループを指定してメッセージの書き込み要求を行った場合，ee_dbq_msgput関数は正常に終了し，メッセージ書き込み要求を行ったトランザクションをロールバックしてからエラートランザクション（ERRTRNR）を起動します。ただし，ee_trn_chained_commit関数を呼び出して連鎖モードのコミット要求をした場合，ee_trn_chained_commit関数はエラーリターンし，エラートランザクション（ERRTRNR）を起動しません。

また，DBキューグループを指定してメッセージの書き込み要求を行った場合は，eedbqwtprコマンドで書き込みを抑止しているDBキューを，eedbqisltコマンドで縮退させることによって，DBキューグループ指定の対象外とする必要があります。

eedbqwtprコマンドは，DBキュー機能オプションがTYPE1のDBキューグループのDBキューに対して実行できます。DBキュー機能オプションは，DBキュー機能関連定義のdbqgrpdef定義コマンドの-kオプションで指定します。DBキュー機能オプションの詳細については，「6.6.1　DBキュー機能オプション」を参照してください。

DBキュー読み出しサーバが終了した場合や障害でダウンした場合は，eedbqwtprコマンドを実行できません。この場合は，DBキュー読み出しサーバをeedbqchgrコマンドで変更してください。DBキュー読み出しサーバの変更については，「3.4.7　DBキュー読み出しサーバ変更機能」を参照してください。

DBキューは，作成完了と同時に書き込み可能な状態となります。

3.4.9　DBキューの通番の管理

TP1/EEによってDBキューにメッセージが書き込まれるのは，サービストランザクション（メッセージ書き込み要求を行うトランザクション）の同期点処理のタイミングです。TP1/EEでは，このときの書き込みの順番を通番管理しています。

サービストランザクション中でee_dbq_msgput関数が発行され，DBキューへのメッセージ書き込み要求が行われると，同期点処理でメッセージを書き込む順番にメッセージに通番が設定されます。この通番は，1から順番に昇順で設定され，番号が抜け落ちることはありません。

通番がdbqdef定義コマンドの-lオプションで指定した最大書き込みメッセージ数に達した場合の動作は，eedbqtblhコマンドでDBキューを作成するときの，-aオプションに指定する属性によって設定できます。

(1)　DBキューの上書き抑止

1日の業務のメッセージを確実に保持して運用したい場合など，一定期間メッセージを上書きしないで保持したい場合，DBキューに上書きを抑止するための属性（上書き抑止属性）を設定してください。読み出し済みのメッセージを保持する必要がない場合は，上書き抑止属性を設定しないでください。

上書き抑止属性を設定する場合の動作（eedbqtblhコマンドの-aオプションに3を指定）

通番が最大書き込みメッセージ数に達すると，メッセージの書き込み要求をしたトランザクションをロールバックします。サービス関数のリターン時の書き込みでロールバックした場合は，ERRTRNRを起動します。

また，DBキューグループを指定してee_dbq_msgput関数を発行した場合も同様にロールバックすることがあります。通番が最大書き込みメッセージ数に達したDBキューがある場合に，DBキューグループを指定したee_dbq_msgput関数を発行するときは，eedbqisltコマンドで該当のDBキューを縮退させてください。これによって，通番が最大書き込みメッセージ数に達したDBキューを，DBキューグループを指定したee_dbq_msgput関数によるメッセージの書き込みの対象外にできます。

注意事項

上書き抑止属性を設定したDBキューを再利用する場合は，DBキューの通番を初期化してください。DBキューの通番の初期化については，「(2)　DBキューの通番の初期化」を参照してください。

上書き抑止属性を設定したDBキューに書き込むのは，バージョンが07-80以降のTP1/EEにしてください。07-80より前のTP1/EEで書き込んだ場合は上書きを抑止できません。

上書き抑止属性を設定しない場合の動作（eedbqtblhコマンドの-aオプションに0または2を指定）

通番が最大書き込みメッセージ数に達すると，次のメッセージに設定される通番は1に戻り，読み出し済みの古いメッセージを上書きします。ただし，古いメッセージが未読み出しメッセージのときは，上書きをしないで，メッセージの書き込み要求をしたトランザクションをロールバックします。サービス関数のリターン時の書き込みでロールバックした場合は，ERRTRNRを起動します。

(2)　DBキューの通番の初期化

DBキューの通番は，DBキュー表の作成時に初期化されます。この初期化以降に，TP1/EEの正常終了や正常開始などを契機としてDBキューの通番が自動的に初期化されることはありません。業務日付の更新など，業務の区切りで通番を初期化したい場合は，コマンドの実行または関数の発行によって，手動で項番を初期化してください。ただし，通番を初期化すると，DBキューに残っている未読み出しメッセージはすべて破棄されます。

通番を初期化するコマンドまたは関数を使用するには，次の条件をすべて満たしている必要があります。

DBキューから読み出すTP1/EEのバージョンが07-80以降である（Cosminexus Reliable Messagingを使用していない）。

eedbqtblhコマンドでDBキューを作成するときに，-aオプションに2または3を指定して通番初期化属性を設定している。

通番を初期化するDBキューが，dbqgrpdef定義コマンドの-kオプションに1を指定したDBキューグループに属している。

通番の初期化は，通番の初期化を要求したトランザクションがコミットすると有効になります。そのため，トランザクションがロールバックした場合，通番は初期化されません。

なお，通番の初期化には，読み出し停止状態のDBキューを対象とした初期化と，データベースがHiRDBの場合にDBキューやTP1/EEの状態に関係なく初期化できる強制初期化があります。

(a)　読み出し停止状態のDBキューの通番の初期化

TP1/EEがオンライン状態の場合，読み出し停止状態のDBキューの通番はeedbqclrコマンドまたはee_dbq_clear関数によって初期化できます。

ただし，次の条件をすべて満たしている必要があります。

通番を初期化するDBキューから読み出すTP1/EEがeedbqclrコマンドを実行，またはee_dbq_clear関数を発行する。

他スレッドで，メッセージの読み出し，スキップ，または初期化を実行していない。

通番を初期化するDBキューが読み出し停止状態である。

通番を初期化するDBキューが書き込み抑止状態※である。

注※

ee_dbq_clear関数が正常リターンしてからトランザクションが決着する前に書き込み抑止状態を解除すると，ee_dbq_clear関数を発行したトランザクションがロールバックします。

読み出し停止中のDBキューの初期化と次に示す関数またはコマンドが競合すると，競合する関数またはコマンドがエラーリターン（タイミングエラー）することがあります。

ee_dbq_msgget関数

ee_dbq_msgrefer関数

ee_dbq_msgrefer2関数

ee_dbq_inquire関数

ee_dbq_inquire2関数

eedbqlsコマンド

eedbqlsdqコマンド

(b)　通番の強制初期化

データベースにHiRDBを使用している場合，DBキューやTP1/EEの状態に関係なく，強制的にDBキューの通番を初期化できます。強制的なDBキューの通番の初期化には，eedbqclrhコマンドを実行します。また，ee_dbq_clear関数を発行することでも，DBキューの状態に関係なく強制的に通番を初期化できます。

強制初期化と次のトランザクションが競合した場合，競合するトランザクションがロールバックすることがあります。

DBキューからメッセージを読み出し中のトランザクション

DBキューのメッセージをスキップ中のトランザクション

また，強制初期化と次に示す関数またはコマンドが競合すると，競合する関数またはコマンドがエラーリターン（タイミングエラー）することがあります。

ee_dbq_msgget関数

ee_dbq_msgrefer関数

ee_dbq_msgrefer2関数

ee_dbq_inquire関数

ee_dbq_inquire2関数

eedbqlsコマンド

eedbqlsdqコマンド

(3)　注意事項

ee_dbq_clear関数を発行したトランザクションで通番の初期化を実行中のDBキューに対して，DBキュー関連の関数を発行した場合の動作を次の表に示します。

項番

関数名

通番の初期化を実行中のDBキューに対して発行した場合の動作

1

ee_dbq_acsctl

通番の初期化とは互いに影響しません。

2

ee_dbq_conctl

3

ee_dbq_inqsrv

4

ee_dbq_inquire

関数を発行した順番に関係なく，初期化前の通番を参照します。

5

ee_dbq_inquire2

6

ee_dbq_msgget

先に発行した関数が有効になります。あとから発行した関数は，エラーリターン（タイミングエラー）します。ただし，ee_dbq_msgget関数のあとに強制初期化を実行した場合は，強制初期化が有効になります。

7

ee_dbq_msgput

関数を発行した順番に関係なく，先に通番が初期化されます。書き込み要求されたメッセージには，1から順番に通番が設定されます。ee_dbq_clear関数は，同一トランザクション内で先に発行された書き込み要求を取り消すことはできません。

8

ee_dbq_msgrefer

関数を発行した順番に関係なく，初期化前の通番でメッセージを読み出します。

9

ee_dbq_msgrefer2

10

ee_dbq_rbskip

通番の初期化とは互いに影響しません。トランザクションがコミットした場合は，通番が初期化されます。ロールバックした場合は，サービス開始時にサービス関数に渡したDBキューから読み出したメッセージを読み出し済みにします。

11

ee_dbq_skip

関数を発行した順番に関係なく，通番が初期化されます。

12

ee_dbq_srvctl

通番の初期化とは互いに影響しません。

ee_dbq_clear関数の発行，またはeedbqclrコマンド，もしくはeedbqclrhコマンドを実行したトランザクションとは別のトランザクションで通番の初期化を実行中のDBキューに対して，DBキュー関連の関数を発行した場合の動作を次の表に示します。

項番

関数名

通番の初期化を実行中のDBキューに対して発行した場合の動作

1

ee_dbq_acsctl

通番の初期化とは互いに影響しません。

2

ee_dbq_conctl

3

ee_dbq_inqsrv

4

ee_dbq_inquire

関数がエラーリターン（タイミングエラー）することがあります。

5

ee_dbq_inquire2

6

ee_dbq_msgget

関数がエラーリターン（タイミングエラー）するか，関数を発行したトランザクションが同期点処理でロールバックすることがあります。

7

ee_dbq_msgput

同期点処理が行われる順番で決まります。通番の初期化を要求したトランザクションが先に同期点処理された場合，通番の初期化後に書き込み要求されたメッセージには，1から順番に通番が設定されます。

書き込み要求したトランザクションが先に同期点処理された場合は，メッセージ書き込み後に通番を初期化します。書き込んだメッセージは破棄されます。

8

ee_dbq_msgrefer

関数がエラーリターン（タイミングエラー）することがあります。

9

ee_dbq_msgrefer2

10

ee_dbq_rbskip

通番の初期化とは互いに影響しません。

11

ee_dbq_skip

関数がエラーリターン（タイミングエラー）するか，関数を発行したトランザクションが同期点処理でロールバックすることがあります。

12

ee_dbq_srvctl

通番の初期化とは互いに影響しません。

3.4.10　DBキュー自動読み出し停止機能

DBキュー自動読み出し停止機能を使用すると，AP間通信をするDBキューのスケジュール状態を読み出し停止にする条件を指定できます。

(1)　TP1/EE起動時の読み出し停止

TP1/EEの起動時にDBキューを読み出し停止にできます。読み出し停止にする条件には，正常開始・再開始のどちらか，または両方を指定できます。ただし，DBキュー自動読み出し停止機能を使用するには，対象のDBキューが，AP間通信をする自システムのTP1/EEが読み出すDBキューである必要があります。

読み出し停止にするための条件は，DBキューごとに個別に指定したり，すべてのDBキューに一括して指定したりできます。

(a)　自動読み出し停止機能の個別指定

TP1/EEの起動時にDBキューを読み出し停止にするかどうかをDBキューごとに個別に指定する場合，dbqdef定義コマンドの-tオプションで指定できます。-tオプションを省略すると，DBキュー機能関連定義のdbq_uap_stopオペランドの指定に従います。なお，ユーザキューアクセスをするDBキューに，dbqdef定義コマンドの-tオプションを指定した場合は，TP1/EEの起動時に定義不正によってエラーになります。

dbqdef定義コマンドの-tオプションの指定値による動作を次の表に示します。

表3‒19　dbqdef定義コマンドの-tオプションの指定値による動作

項番

dbqdef定義コマンドの-tオプションの指定値

正常開始時のDBキューの状態

再開始時のDBキューの状態※

1

-tオプションを省略

DBキュー機能関連定義のdbq_uap_stopオペランドの指定に従う

2

no

起動

前回の状態で開始

3

start

読み出し停止

4

restart

起動

読み出し停止

5

all

読み出し停止

注※

オンラインが停止した原因がDBキューのメッセージ読み出しトランザクションだった場合，再開始時（プロセスの回復時）にはdbqdef定義コマンドの-tオプションの指定値に関係なく，該当するDBキューを読み出し停止にします。

(b)　自動読み出し停止機能の一括指定

TP1/EEの起動時にすべてのDBキューを一括して読み出し停止にする場合，DBキュー機能関連定義のdbq_uap_stopオペランドで指定できます。このオペランドを省略した場合は，デフォルト値としてnoが使用されます。なお，dbqdef定義コマンドの-tオプションを同時に指定したときは，dbqdef定義コマンドの-tオプションが有効になります。

DBキュー機能関連定義のdbq_uap_stopオペランドの指定値による動作を次の表に示します。

表3‒20　DBキュー機能関連定義のdbq_uap_stopオペランドの指定値による動作

項番

DBキュー機能関連定義のdbq_uap_stopオペランドの指定値

正常開始時のDBキューの状態

再開始時のDBキューの状態※

1

no

起動

前回の状態で開始

2

start

読み出し停止

3

restart

起動

読み出し停止

4

all

読み出し停止

注※

オンラインが停止した原因がDBキューのメッセージ読み出しトランザクションだった場合，再開始時（プロセスの回復時）にはDBキュー機能関連定義のdbq_uap_stopオペランドの指定値に関係なく，該当するDBキューを読み出し停止にします。

また，DBキュー機能関連定義のdbq_uap_stopオペランドと，dbqdef定義コマンドの-tオプションの関係について次の表に示します。

表3‒21　DBキュー機能関連定義のdbq_uap_stopオペランドと，dbqdef定義コマンドの-tオプションの関係

項番

DBキュー機能関連定義のdbq_uap_stopオペランド

dbqdef定義コマンドの-tオプション

DBキューに有効となる定義

1

省略

省略

DBキュー機能関連定義のdbq_uap_stopオペランドのデフォルト値（no）

2

指定

dbqdef定義コマンドの-tオプション

3

指定

省略

DBキュー機能関連定義のdbq_uap_stopオペランド

4

指定

dbqdef定義コマンドの-tオプション

(2)　障害発生時の自動読み出し停止

DBキュー機能では，メッセージ読み出しトランザクションで障害が発生することがあります。この障害には二つのケースがあり，DBキュー機能関連定義のdbq_read_error_uap_stopオペランドで指定した障害ケースが発生した場合は，DBキューを読み出し停止にできます。ただし，障害発生時の自動読み出し停止ができるのは，AP間通信をするDBキューのメッセージ読み出しトランザクションだけです。

AP間通信をするDBキューのメッセージ読み出しトランザクションの流れと障害の発生タイミングを次の図に示します。図中では，障害の発生タイミングに1.〜5.の番号を記載しています。

図3‒39　メッセージ読み出しトランザクションの流れと障害の発生タイミング

dbq_read_error_uap_stopオペランドに1を指定した場合，図中の1.，2.，および4.で障害が発生したときにDBキューを読み出し停止にします。dbq_read_error_uap_stopオペランドに2を指定した場合，図中の1.〜5.で障害が発生したときにDBキューを読み出し停止にします。

図中の1.〜5.で発生するおそれのある障害の詳細は次のとおりです。

メッセージ読み出しSQLエラー

サービス関数障害でスレッドダウン（thkind引数にEETRN_KILLまたはEETRN_ABRTを設定し，スレッドの強制終了指定をしたee_trn_chained_rollback関数を発行した場合は含まない）

関数（thkind引数にEETRN_KEEPを設定したee_trn_chained_commit関数，またはee_trn_chained_rollback関数）による同期点処理障害

メッセージ読み出し通番の更新SQLエラー

サービス関数のリターン時の同期点処理障害

なお，dbq_read_error_uap_stopオペランドに2を指定した場合，図中の3.が発生してもDBキューを読み出し停止にはしません。図中の3.では，関数がエラーリターンするため，リターンコードを参照してユーザが措置を決定します。

定義の指定による障害発生時の自動読み出し停止の動作を次の表に示します。

表3‒22　定義の指定による障害発生時の自動読み出し停止の動作

DBキュー機能関連定義のdbq_read_error_uap_stopオペランドの指定値

障害の発生タイミング（図中の番号）によるDBキューの状態

1.

2.

3.

4.

5.

1

読み出し停止

読み出し停止

読み出し停止しない

読み出し停止

読み出し停止しない

2

読み出し停止

3.4.11　DBキューメッセージスキップ機能

DBキューから読み出したメッセージが不正なメッセージである場合，そのメッセージをスキップすることで業務を続行できます。また，メッセージ読み出しトランザクションで障害が発生した場合も，障害の発生時に読み出していたメッセージをスキップすることで，読み出しを停止することなく次のメッセージを読み出せます。

メッセージをスキップするか，DBキューを読み出し停止にするかは，dbqgrpdef定義コマンドの-sオプションでDBキューグループごとに定義します。読み出しを停止する場合は，ロールバックしたDBキューが読み出し停止になります。同一グループ内のほかのDBキューについては，読み出し停止にしません。

メッセージをスキップした場合は，KFSB55612-Wメッセージが出力されます。

(1)　メッセージスキップの対象

メッセージスキップの対象になるのは，AP間通信のDBキューでトランザクション開始時に読み出したメッセージです。次の関数の発行でトランザクションがロールバックした場合にメッセージをスキップします。次の関数の発行以外でロールバックした場合は，メッセージをスキップしません。

ee_trn_chained_rollback関数（thkind引数にEETRN_KILLまたはEETRN_ABRTを設定）

ee_trn_rollback_mark関数

サービス関数実行中にスレッドダウン

なお，ユーザキューアクセスの場合，メッセージスキップはできません。

(2)　メッセージスキップの処理で障害が発生した場合

メッセージスキップの処理で障害が発生した場合，メッセージスキップの処理を中止し，DBキューを読み出し停止にします。DBキューの読み出しを再開すると，再度同じメッセージを読み出すため，必要に応じて再度トランザクションをロールバックするか，DBキューの読み出しを再開する前にeedbqskipコマンドを実行して，不要なメッセージをスキップしてください。

また，メッセージスキップの処理を実行する前に，TP1/EEがプロセスダウンまたは計画停止Bによって停止した場合もメッセージはスキップされません。TP1/EEのリラン後に再度同じメッセージを読み出すため，必要に応じて再度トランザクションをロールバックしてください。

3.4.12　DBキューのメッセージ読み出しトランザクションロールバック時の機能の優先順位

メッセージ読み出しトランザクションが，障害や関数の発行によってロールバックした場合，次に示す機能が有効になります。

連続ロールバックの監視

DBキュー機能関連定義のdbq_rollback_retry_countオペランドで監視回数を指定します。

ロールバック時のメッセージスキップ

dbqgrpdef定義コマンドの-sオプション，または-rオプションでメッセージスキップの有無を指定します。

dbqgrpdef定義コマンドの-rオプションについては，TP1/FSPの関連ドキュメントを参照してください。

障害発生時の自動読み出し停止

DBキュー機能関連定義のdbq_read_error_uap_stopオペランドで障害ケースを指定します。

これらの機能の対象になるロールバック要因，および有効になる機能が複数ある場合の関係を次の表に示します。

表3‒23　メッセージ読み出しトランザクションが，障害や関数の発行によってロールバックした場合に有効になる機能のロールバック要因との関係

項番

ロールバック要因

対象になる機能

連続ロールバックの監視

ロールバック時のメッセージスキップ

障害発生時の自動読み出し停止

-sオプション指定

-rオプション指定

1

メッセージ読み出しエラー

−

−

−

◎

2

サービス関数の実行中のスレッドダウン※1

−

◎

−

○

3

メッセージ読み出し通番更新エラー

−

−

−

◎

4

サービス関数のリターン時の同期点処理障害

−

−

−

◎

5

ee_trn_rollback_mark関数の発行※2

◎

○

−

−

6

関数の発行によるスレッドダウン※2，※3

◎

○

−

−

7

連鎖モードのロールバック※4

−

−

−

−

8

連鎖モードのコミット時の同期点処理障害※5

−

−

−

−

9

リトライモードのロールバック

−

−

◎

−

10

サービス関数実行中のTP1/EEのプロセスダウン

−

−

−

−

（凡例）

◎：最優先で有効になる機能

○：有効になる機能

−：無効になる機能

注※1

thkind引数にEETRN_KILLまたはEETRN_ABRTを設定したee_trn_chained_rollback関数の発行によるスレッドダウンは含みません。

注※2

連続ロールバックの監視，およびロールバック時のメッセージスキップの二つの機能が有効の場合，リトライ回数の上限を超えるとメッセージをスキップします。

注※3

thkind引数にEETRN_KILLまたはEETRN_ABRTを設定したee_trn_chained_rollback関数の発行によるスレッドダウンです。

注※4

thkind引数にEETRN_KEEPを設定したee_trn_chained_rollback関数の発行によるロールバックです。

注※5

ee_trn_chained_commit関数の発行によるコミットです。

3.4.13　DBキュースケジュール状態一括変更機能

自システムのTP1/EEが読み出すすべてのDBキューのスケジュール状態を，1回のコマンドの実行で読み出し停止（eedbqstopコマンド）にしたり，再開（eedbqrstコマンド）したりできます。

TP1/EE起動時に自動読み出し停止にしたDBキューの読み出しを再開する場合などは，eedbqrstコマンドを実行することでDBキューのスケジュール状態を一括して変更できます。

3.4.14　データ連携支援対応

TP1/FSPのデータ連携支援がDBキューに書き込んだメッセージを読み出せます。

AP間通信，ユーザーキュー機能のどちらも使用できます。

データ連携支援がDBキューに書き込んだメッセージを読み出すためには，eedbqtblhコマンドでDBキューを作成するときにデータ連携書き込み属性を付与する必要があります。

TP1/EEのUAPが使用するDBキュー機能のAPIは，データ連携書き込み属性を付与しても，付与しなかった場合と同じように使用することができます。UAPの修正，コンパイルは必要ありません。

TP1/EEに対して実行するDBキュー機能の運用コマンドは，データ連携書き込み属性を付与しても，付与しなかった場合と同じように使用することができます。オプションフラグ，出力結果などのインタフェースの変更はありません。

3.4.15　DBキュー書き込み禁止機能

DBキューへの書き込みで障害が発生した場合に，KFSB85652-Iを出力してDBキュー書き込み状態を書き込み禁止状態に変更できます。この機能を利用する場合は，DBキュー機能関連定義のdbq_inhibit_useにYを指定し，dbqgrpdef定義コマンドの-kオプションに1を指定します。

障害発生と判断するのは，DBキューへの書き込み処理で次の状態となった場合です。

SQL実行でエラー発生

DBキューの内容が矛盾

DBキューの最大メッセージ数超過

DBキューのメッセージ書き込み抑止を検知

この機能を使用すると，DBキューへの書き込み要求が正常終了したあと，DBキューへの書き込みで障害が発生した場合，書き込み禁止状態にしてロールバックします。以降のDBキューへの書き込み要求は，書き込み禁止状態になっているためエラーリターンします。書き込み要求がすぐにリターンすることで任意の後処理が実行できます。詳細は，「3.4.15(1)　トランザクションの流れ」を参照してください。

この機能を使用しない場合，DBキューへの書き込み要求が正常終了したあと，DBキューへの書き込みで障害が発生したときは，書き込み禁止状態にせずにロールバックするだけです。以降のDBキューへの書き込み要求も正常終了した後にロールバックします。詳細は，「3.4.5(5)　メッセージの書き込み中にDB障害が発生した場合」を参照してください。

書き込み禁止状態は，eedbqinhibitコマンドで解除できます。また，eedbqinhibitコマンドで書き込み禁止状態の設定もできます。

同一プロセスで複数トランザクションから同一DBキューに対する書き込みを行っていた場合に障害が発生すると，タイミングによっては複数のトランザクションがロールバックすることがあります。詳細は，「3.4.15(2)　同一プロセスの複数トランザクションで書き込み要求時の流れ」を参照してください。

また，書き込み禁止状態はプロセスごとで管理します。複数プロセスから同一DBキューに対する書き込みで障害が発生した場合は，それぞれのプロセスでトランザクションがロールバックし，それぞれのプロセスで書き込み禁止状態になります。そのためプロセスごとにeedbqinhibitコマンドによって書き込み禁止状態の解除が必要となります。詳細は，「3.4.15(3)　複数プロセスから同一DBキューへの書き込み要求時の流れ」を参照してください。

同一トランザクションから複数のDBキューに対して書き込み要求を行った場合に，DBキューへの書き込みで障害が発生すると，障害が発生したDBキューだけ書き込み禁止状態となります。詳細は，「3.4.15(4)　同一トランザクションから複数DBキューへ書き込み要求時の流れ」を参照してください。

DBキューへの書き込み要求をDBキューグループ指定で行った場合に，DBキューへの書き込みで障害が発生すると，障害が発生したDBキューだけ書き込み禁止状態としてほかのDBキューへのリトライは行わずにロールバックします。詳細は，「3.4.15(5)　DBキューグループ指定で書き込み要求時の流れ」を参照してください。

(1)　トランザクションの流れ

図3‒40　DBキューサービス起動〜書き込みで障害発生

サービスからのメッセージ書き込み関数処理で書き込みメッセージを保留します。

DBキュー書き込み状態を確認し，書き込み可能状態の場合は正常終了します。

トランザクションコミット前処理でDBキュー書き込み時に障害発生。

DBキュー書き込み状態を書き込み禁止状態にします。

該当するトランザクションをロールバックします。

ERRTRNRを起動します。

サービスからのメッセージ書き込み関数処理で書き込みメッセージを保留します。

DBキュー書き込み状態を確認し，書き込み禁止状態の場合はエラーリターンします。

(2)　同一プロセスの複数トランザクションで書き込み要求時の流れ

図3‒41　同一プロセス内の複数トランザクションからの書き込み要求

同一プロセス内の複数トランザクションから同一DBキューに対して書き込み要求を行う場合，書き込み禁止状態設定前は書き込み要求が正常終了し，書き込み処理で障害が発生すると，トランザクションをロールバックします。書き込み禁止状態設定以降の書き込み要求はエラーリターンします。

(3)　複数プロセスから同一DBキューへの書き込み要求時の流れ

図3‒42　複数プロセスから同一DBキューへの書き込み要求で障害発生時の処理

書き込み禁止状態はプロセスごとに管理するため，障害中のDBキューへ複数プロセスから書き込みを行った場合，それぞれのプロセスごとに書き込みで障害が発生した時点で書き込み禁止状態となります。

また，書き込み禁止状態を解除する場合，それぞれのプロセスで書き込み禁止状態解除コマンドを実行する必要があります。

(4)　同一トランザクションから複数DBキューへ書き込み要求時の流れ

図3‒43　同一トランザクションから複数DBキューへ書き込み要求を行った場合の処理

同一トランザクションから複数のDBキューへ書き込み要求を行った場合に書き込みで障害が発生すると，障害が発生したDBキューだけ書き込み禁止状態を設定して以降の書き込み処理は行わずにロールバックします。

(5)　DBキューグループ指定で書き込み要求時の流れ

図3‒44　DBキューグループ指定で書き込み要求を行った場合の処理

DBキューグループ指定で書き込み要求を行った場合に書き込みで障害が発生すると，障害が発生したDBキューだけ書き込み禁止状態にして，同一グループ内の他DBキューへの書き込みリトライは行わずにロールバックします。

書き込み禁止状態となったDBキューは縮退中と同じ扱いとし，DBキューグループ指定時の書き込み対象から除外します。

DBキューグループ指定で書き込み要求を行った場合に，すべてのDBキューが書き込める状態ではなかったとき，書き込み要求はエラーリターンします。

3.4.16　交替用メッセージ表書き込み機能

TP1/FSPを使用している場合だけ使用できます。

この機能は，次に示す項目を設定することで使用できます。

TP1/FSP定義のtrn_max_retry_countを省略，または0以外の値を指定します。

TP1/EE定義のdbqgrpdef -k 1を指定します。

eedbqtblhコマンド実行時に-aオプションに8を論理和で指定してDBキューを作成します。

この機能を使用すると，DBキューのメッセージ表を格納したRDエリアの容量不足，RDエリアの閉塞などの障害が発生したときに，交替用のメッセージ表に書き込み，トランザクションをコミットします。これによって業務が継続でき，可用性が向上します。メッセージ表以外のDBキューの表で障害が発生した場合は，この機能は動作しません。

この機能を使用していない場合，DBキューのメッセージ表を格納したRDエリアの容量不足，RDエリアの閉塞などの障害が発生したときに，DBキューに書き込み要求（ee_dbq_msgput関数）を行ったトランザクションは，ロールバックします。

(1)　交替用メッセージ表へのメッセージの書き込み

書き込み要求を実行したトランザクションでは，同期点処理でDBキューにメッセージを書き込みます。DBキューのメッセージ表の更新で障害が発生した場合は※，DBキュー機能は，トランザクションをリトライロールバックさせます。APがリトライロールバック後のトランザクションで再度書き込み要求を実行すると，DBキュー機能は，交替用のメッセージ表にメッセージを書き込み，トランザクションをコミットします。

DBキューの通常のメッセージ表と交替用のどちらの表に書き込むかはDBキュー機能が決めるため，APはリトライロールバック後のトランザクションとリトライロールバック前のトランザクションで処理を変える必要がありません。

注※

HiRDBで暗黙的ロールバックが発生しない障害の場合は，リトライロールバックしないで同一トランザクションで交替用メッセージ表を更新します。

図3‒45　交替用メッセージ表へのメッセージの書き込み

UAPがメッセージ書き込み要求関数処理を実行し，DBキュー機能が要求を受け付けます。

DBキュー機能がメッセージ表を更新します。HiRDBが暗黙的にロールバックする障害が発生します。

DBキュー機能がリトライロールバック要求をします。

同一のメッセージを入力としたトランザクションを再起動します。

UAPが1.と同じAPIを実行し，DBキュー機能が要求を受け付けます。

交替用メッセージ表を更新します。

一度交替用のメッセージ表に書き込みを行うと，後続のトランザクションでは交替用の表にメッセージを書き込みます。通常のメッセージ表の障害を取り除いたあとに，eedbqaltputコマンドを実行すると，通常のメッセージ表への書き込みに戻ります。現在どちらの表に書き込む状態かは，eedbqlsコマンドで確認できます。

交替用のメッセージ表の更新でも障害が発生した場合は，トランザクションはロールバックしERRTRNRが実行されます。書き込み禁止機能を使用している場合は，書き込み禁止状態にします。

図3‒46　交替用メッセージ表への書き込み時の障害

交替用メッセージ表書き込み機能によってリトライロールバックした場合も，TP1/FSPの機能によってリトライロールバックした場合と同様にリトライ回数をカウントアップし，リトライ回数を超過した場合は，リトライしないでERRTRN3を起動します。

リトライロールバック前処理UOCでリトライロールバックをキャンセルした場合もリトライしないでERRTRN3を起動します。リトライロールバックをキャンセルすると交替用メッセージ表への書き込みは行われません。

DBキューのメッセージ表以外の表（ライト管理表，リード管理表）の更新で障害が発生した場合は，この機能を使用していない場合と同様に，DBキューに書き込み要求を行ったトランザクションはロールバックします。

(2)　交替用メッセージ表からのメッセージの入力

UAP間通信用DBキューからのメッセージ入力およびAPI※によるメッセージ読み出し・参照時は，交替用メッセージ表書き込み機能が通常のメッセージ表と交替用のメッセージ表のどちらにメッセージが書き込まれているかを判断してメッセージを入力します。UAPはどちらの表にメッセージが書き込まれたかを意識する必要はありません。

ただし，どちらの表にメッセージが書き込まれたかを判断するためのメッセージ表，または交替用メッセージ表へのアクセスでHiRDBが暗黙的ロールバックする障害が発生した場合は，リトライロールバックしてスレッドダウンします。UAP間通信用DBキューからのメッセージ入力での障害では，UAPの処理は開始していないためリトライロールバック前処理UOCは呼び出しません。また，リトライロールバック回数をカウントしません。

注※

次のAPIが該当します。

ee_dbq_msgget関数

ee_dbq_msgrefer関数

ee_dbq_msgrefer2関数

ee_dbq_msgrefer2関数を例に交替用メッセージ表からのメッセージを入力する処理の流れを次に示します。

図3‒47　交替用メッセージ表からのメッセージの入力

UAPがメッセージ入力関数処理を実行し，DBキュー機能が要求を受け付けます。

DBキュー機能がメッセージ表から入力します。HiRDBが暗黙的にロールバックする障害が発生します。

DBキュー機能がリトライロールバック要求をします。

スレッドダウンし，同一のメッセージを入力としたトランザクションを再起動します。

UAPが1.と同じAPIを実行し，DBキュー機能が要求を受け付けます。

交替用メッセージ表から入力します。

次から交替用メッセージ表から先に確認される状態に更新します。

ふだんは，通常のメッセージ表から先に確認します。一度交替用のメッセージ表から未読み出しメッセージを入力した場合は，次のトランザクションからは，交替用のメッセージ表から先に確認される状態に切り替えます。再び通常のメッセージ表から未読み出しメッセージを入力した場合は，次のトランザクションからは，通常のメッセージ表から先に確認される状態に戻ります。

(3)　交替用メッセージ表書き込み機能の使用時の制限事項

(a)　DBキューの関数を使用できるトランザクションの制限

交替用メッセージ表書き込み機能の使用時は，次の関数の使用を制限します。

ee_dbq_msgput関数

ee_dbq_msgget関数

ee_dbq_msgrefer関数

ee_dbq_msgrefer2関数

交替用メッセージ表書き込み機能の使用時にこれらの関数を使用できるトランザクション種別を，次に示します。ほかのトランザクション種別で実行した場合は，エラーリターンします。

MN，TM，CU，E3，およびこれらのトランザクションの再起動トランザクション（RM）

(b)　リトライロールバック機能の仕様による制限

交替用メッセージ表書き込み機能は，リトライロールバック機能を使用して実現しています。そのため，リトライロールバック機能が使用できない次の条件を満たす場合は，メッセージ表の書き込みで障害が発生しても交替用メッセージ表への書き込みは行わないで，トランザクションがロールバックします。

トランザクショナル連携ありのRPC受信時のトランザクション

トランザクショナルRPCを発行したトランザクション

RPC応答メッセージ抑止をしたトランザクション

UAP異常終了通知トランザクション（ERRTRN3）

3.5　オンラインバッチ機能

オンラインバッチ機能を使用すると，UAPを利用して大量のデータのバッチ処理を実現できます。オンラインバッチ機能の特長を次に示します。

大量のデータを任意の単位でまとめて処理できます

オンラインバッチ機能を使用すると，大量のユーザデータを任意の単位ごとにバッチ処理できます。これによって，データベースの負荷を分散させることができるため，データベースの競合を回避できます。

業務の内容に応じた処理形態を選択できます

オンラインバッチ機能の処理形態には，データ処理を管理できるデータ型と，データ処理のスケジュールを管理できるイベント型の2種類があります。

オンラインバッチ機能を使用するには，プロセス関連定義のdbq_obs_useオペランドにYを指定します。また，オンラインバッチ機能を使用するには，前提プログラムとしてJustware for OLTPが必要です。Justware for OLTPの詳細については，Justware for OLTPのドキュメントを参照してください。

データ型オンラインバッチ機能の運用方法については「6.7　オンラインバッチ機能の運用」を，オンラインバッチ機能の詳細についてはマニュアル「TP1/Server Base Enterprise Option プログラム作成の手引」を参照してください。

3.6　アプリケーションプログラムのスケジュール

アプリケーションプログラムのサービスを効率良く処理する方法について説明します。

3.6.1　マルチスレッド制御

TP1/EEは，マルチスレッドに対応しているため，TP1/EEプロセス内で複数のサービスを同時に実行できます。処理スレッドを利用して，各サービスを同一プロセスで実行できるため，サービスごとにプロセスを分ける方法よりも速く処理できます。同じサービスはシリアルに実行します。ただし，サービス引き出しの多重度を2以上に指定している場合は，パラレルに実行します。TP1/EEプロセス内で実行するスレッドの最大数は，プロセス関連定義のthread_noオペランドで指定できます。

TP1/EEは，マルチスレッドに対応するため，次の制御をします。

保護区／非保護区の制御

UAPを処理内容に応じて保護区と非保護区に分けてプロセスの終了を制御します。

TP1/EEプロセスのハングアップ監視

TP1/EEプロセスのハングアップを監視し，プロセスを強制停止します。

(1)　保護区／非保護区の制御

TP1/EEでは，UAPを処理内容に応じて保護区（プロセスダウン域）と非保護区（スレッドダウン域）に分けてプロセスの終了を制御します。保護区を実行中に異常が発生した場合は，プロセス内の全スレッドを終了させます。非保護区を実行中に異常が発生した場合は，異常が発生したスレッドだけを終了させます。異常が発生したスレッドだけを終了させることで，プロセスの終了を局所化できます。

UAPの保護区／非保護区は，ee_thd_protstart関数およびee_thd_protend関数で切り替えます。UAPの保護区／非保護区の詳細，およびee_thd_protstart関数，ee_thd_protend関数の詳細については，マニュアル「TP1/Server Base Enterprise Option プログラム作成の手引」を参照してください。

UOCは保護区であり，保護区／非保護区の切り替えはできません。

(2)　TP1/EEプロセスのハングアップ監視

TP1/EEプロセスのハングアップ監視は，TP1/EEが実行します。TP1/EEは，TP1/EEのモニタスレッドがプロセス関連定義のproc_hungup_timeオペランドで指定した時間以上停止すると，TP1/EEプロセスを強制停止します。TP1/EEのハングアップ監視の範囲を次の図に示します。

図3‒48　TP1/EEのハングアップ監視範囲

(3)　スレッド生成失敗時の処理

TP1/EE起動時のスレッド生成の場合は，プロセス関連定義のthread_noオペランドに指定したスレッド数と同じ数のスレッドが生成される必要があります。一つでもスレッド生成に失敗すると，プロセスダウンしてTP1/EEを起動できません。

TP1/EE起動時以外のスレッド生成の場合は，処理スレッドが異常終了すると，TP1/EEは処理スレッドを再生成しようとします。処理スレッドの再生成に失敗した場合，プロセスダウンします。

3.6.2　サービスのスケジュール

TP1/EEのサービスをスケジュールする方法について説明します。

(1)　処理キューによるスケジュール制御

TP1/EEのすべてのトランザクションは，TP1/EEで制御する処理キューとして登録されます。処理キューは，処理スレッドがサービス単位にラウンドロビン方式で引き出します。したがって，特定のサービスに偏らないように，トランザクションを効率良く処理できます。

処理キューによるスケジュール制御の運用方法については，「6.9　処理キュー制御機能の運用」を参照してください。

(2)　処理スレッドの動的制御

TP1/EEでは，システム開始時に通常処理する通常処理スレッドとともに，予備用に処理する予備処理スレッドを生成します。プロセス関連定義のreserve_thread_noオペランドを省略するか，0を指定した場合，予備処理スレッドは作成されません。通常処理スレッド数はプロセス関連定義のthread_noオペランドで，予備処理スレッド数はreserve_thread_noオペランドで指定します。

なお，プロセス関連定義のreserve_thread_noオペランドを指定し，プロセス関連定義のreserve_start_pce_noオペランドを省略または0を指定した場合でも，予備処理スレッドは作成されません。

通常処理スレッド数を10，予備処理スレッド数を5と定義した場合に，トラフィックが低い状態では通常処理スレッド数（10）分だけ起動します。特定のサービスのトラフィックが高い状態では，通常処理スレッド数（10）に加えて予備処理スレッド数（5）分を起動します。

処理スレッドの運用方法については，「6.10　処理スレッド動的増加機能の運用」を参照してください。

(3)　サービスの閉塞

トランザクションに異常が発生した場合，サービスを閉塞させることで，処理を一時的に止められます。UAPに異常が発生し，スレッドダウンまたはプロセスダウンした場合に，サービスを自動的に閉塞させるかどうかをプロセス関連定義のservice_holdオペランド，service_hold_watch_useオペランド，およびユーザサービス関連定義のservice_attr定義コマンドで指定できます。また，任意のタイミングでサービスを閉塞させたい場合は，eedctsvコマンドを実行するか，ee_thd_abdctl関数を呼び出します。

サービスの閉塞中にトランザクション起動要求があった場合，エラートランザクションが起動され，ユーザが任意に決着できるようになります。サービス閉塞を解除してサービスを再開始したい場合は，eeactsvコマンドを実行するか，ee_thd_abdctl関数を呼び出します。

なお，サービスグループ単位で閉塞させたい場合は，TP1/EEを停止させてください。TP1/EE停止後，プロセスの回復処理をした場合，サービスの閉塞状態は引き継がれます。

(4)　タイマトランザクション制御

タイマトランザクションは，一定時間経過後に実行する業務処理のトランザクションです。時刻または経過時間を指定して，サービストランザクションと同じサービスに登録すると，各サービスと連動して業務処理を実行できます。タイマトランザクションの起動方式には，即時登録方式とトランザクション同期登録方式の2種類があります。

タイマトランザクションの起動は，ee_tim_execap関数で設定します。設定したタイマトランザクションは，ee_tim_execap_cancel関数で取り消せます。

タイマトランザクションの詳細については，マニュアル「TP1/Server Base Enterprise Option プログラム作成の手引」を参照してください。

3.7　TP1/EEの運用を補助する機能

TP1/EEの運用を補助するための機能について説明します。

3.7.1　資源の排他制御

TP1/EEではUAPで使用する資源を共用できるようにしています。一つの資源を複数のUAPが使用しても整合性を保つことができる機能を排他制御と呼びます。排他資源の占有，および待ち状態はeelcklsコマンドで表示できます。

(1)　排他制御の管理範囲と有効範囲

TP1/EEは，資源の排他要求時から排他資源の解除要求時まで排他を管理します。排他制御の管理単位は，グローバルトランザクションです。

排他制御の有効範囲は，一つのTP1/EEプロセス内だけです。ほかのTP1/EEプロセス上のUAPとの排他制御はできません。また，排他状態はリラン時に引き継がれません。

(2)　資源の排他要求

資源を確保するときは，UAPからee_lck_get関数を呼び出します。このとき，引数に資源名称，排他制御モードなどを指定します。資源名称はTP1/EEプロセス内で一意となる固有の名称にする必要があります。排他制御モードとは，同じ資源にアクセスするほかのUAPに対する排他の方式です。

排他制御モードには，資源を参照するだけのUAPとは資源を共用し，資源を更新するUAPだけを排他するPRモードと，一つのUAPが資源を占有し，ほかのUAPをすべて排他するEXモードがあります。

(a)　資源の共有・非共有

あるトランザクションが排他要求した資源を，ほかのトランザクションがすでに排他確保していた場合，使用中の排他制御モードと要求元の排他制御モードの組み合わせによって，資源を共有確保させるかどうか決めます。共有確保できない場合，UAPからの排他要求時にエラーリターンするか，資源の解放待ちとするかを指定できます。

使用中の排他制御モードとその組み合わせによる資源の共有を次の表に示します。

表3‒24　使用中の排他制御モードとその組み合わせによる資源の共有

使用中の排他制御モード

要求元の排他制御モード

PRモード

EXモード

PRモード

共有できます

共有できません

EXモード

共有できません

共有できません

(b)　排他モードの遷移

排他を確保できたときの排他要求の排他制御モードが，その資源の排他モードとなります。

グローバルトランザクションでは，同一資源に対して複数回排他要求をした場合，複数の排他制御モードが混在しないように，資源の排他モードを制御します。

排他モードの遷移について，次の図と表に示します。

図3‒49　排他モードの遷移

表3‒25　排他モードの遷移

項番

排他確保済みの資源の

排他制御モード

排他要求の

排他制御モード

遷移後の

排他制御モード

1

PRモード

PRモード

PRモード

2

EXモード

EXモード

3

EXモード

PRモード

EXモード

4

EXモード

EXモード

(3)　資源の排他の解除

次に示す方法で資源の排他を解除します。

資源名称を指定した排他の解除要求をUAPが出す。

全資源の排他の解除要求をUAPが出す。

また，排他をしたトランザクションが正常終了または異常終了した場合，TP1/EEのロックサービスによって自動的に排他は解除されます。これによって，UAPでの排他の解除漏れや，UAP異常終了が発生した場合でも，資源が不当に占有されることがなくなります。

なお，同一トランザクション内（グローバルトランザクションも含む）で，同一の資源に対して複数回排他要求をした場合，排他要求の回数分，排他の解除要求をする必要があります。

(4)　排他待ち

資源を排他する場合，すでにほかのUAPによって資源が排他状態であるとき，ee_lck_get関数の引数で資源を排他できるまで待つかどうかを指定できます。

資源を排他できるまで待つと指定した場合には，排他待ちの優先順位に従って，ほかのUAPが資源の排他を解除するまで待ちます。待たないと指定した場合は，すぐにエラーリターンします。なお，排他待ちの優先順位は資源の排他要求を行った順番によって決まります。資源の排他要求を行う順番がほかのUAPよりも早い場合，排他待ちの優先順位はほかのUAPよりも高くなります。排他待ちの優先順位が高い場合，排他待ちしている，優先順位の低いほかのUAPよりも先に資源を排他できます。

トランザクション関連定義のlck_wait_timeoutオペランドで排他待ち限界経過時間を指定すると，排他待ち状態がこの時間を超えたとき，その排他要求をエラーリターンします。このとき，確保しようとした資源に関する詳細がタイムアウト情報としてメッセージに出力されます。

TP1/EEでは，デッドロックの検知をしないため，トランザクション関連定義のlck_wait_timeoutオペランドで排他待ち限界経過時間を指定することをお勧めします。

3.7.2　運用コマンド実行機能

運用コマンド実行機能を使用すると，オンライン中に入力できる，ユーザが作成したコマンドおよびTP1/Server Baseのコマンドを，TP1/EEプロセス中のUAPからee_adm_call_command関数で実行できます。コマンドの実行結果はUAPにリターンします。

運用コマンド実行機能では，RPC通信にネームサービスを使用しません。このため，必ずサービスグループ情報関連定義のeesvgdef定義コマンドに，コマンドを実行したいノードの運用コマンド実行サーバのサービスグループ情報を指定してください。

運用コマンド実行機能は，TP1/EEのコマンドにも使用できます。ただし，TP1/EEのコマンドのうち，コマンドの処理と同等の処理を関数で提供しているものに関しては，運用コマンド実行機能で実行することはお勧めしません。

なお，TP1/Server BaseのコマンドおよびTP1/EEのコマンドの一部は，運用コマンド実行機能で実行できません。

運用コマンド実行機能の詳細については，マニュアル「TP1/Server Base Enterprise Option プログラム作成の手引」を参照してください。

3.7.3　UAP共用ライブラリ入れ替え機能

UAP共用ライブラリ入れ替え機能を使用すると，オンライン中のTP1/EEプロセスを停止させないでUAP共用ライブラリを入れ替えられます。

UAP共用ライブラリ入れ替え機能を使用する場合は，ユーザサービス関連定義のuap_exchange_useオペランドにYを指定してください。

入れ替え先UAP共用ライブラリを用意したあとでeechgapコマンドを実行すると，UAP共用ライブラリを入れ替えられます。UAP共用ライブラリを入れ替える手順について説明します。手順2.〜4.は，eechgapコマンドで実行してください。

任意のディレクトリ下に入れ替え先UAP共用ライブラリを用意します。

入れ替え先UAP共用ライブラリの名称は，使用中のライブラリ名と同じ名称にする必要はありません。

TP1/EEプロセスのすべてのトランザクションをUAPリターン後に停止させます（トランザクションの静止化）。

ユーザが用意した入れ替え先UAP共用ライブラリと，入れ替え元UAP共用ライブラリを入れ替えます。

トランザクションの停止を解除して，通常の処理に戻ります（トランザクションの静止化状態の解除）。

トランザクションの静止化およびトランザクションの静止化状態の解除について説明します。

(1)　トランザクションの静止化

トランザクションの静止化では，サービストランザクションが登録してあるサービスから処理キューの引き出しを一時的に禁止して，サービストランザクションの起動を一時的に停止させます。サービストランザクションとは，ユーザサービス関連定義でエントリポインタ名を指定してUAPを起動するすべてのトランザクションのことです。

トランザクションの静止化中にイベントを受信した場合は，そのまま処理キューを登録しますが，処理キューの滞留監視の対象外となります。

トランザクションの静止化が完了するのは，起動中のトランザクションがすべてUAPリターンした時点です。

入れ替えるUAPがCOBOL言語で作成されている場合（プロセス関連定義のcobol_use_flagオペランドにYを指定している場合）は，トランザクションの静止化の要求時に起動しているトランザクションが決着したあと，UAP共用ライブラリを入れ替える前にCOBOL実行空間を削除します。トランザクションの静止化が完了するのは，COBOL実行空間の削除が完了した時点です。

(2)　トランザクションの静止化状態の解除

トランザクションの静止化状態の解除では，トランザクションの静止化で一時的に禁止していた処理キューの引き出しを再開します。

(3)　注意事項

UAP共用ライブラリ入れ替え機能の実行中にエラーが発生した場合は，UAP共用ライブラリを入れ替えません。

UAP共用ライブラリ名はTP1/EE開始時にステータスファイルに出力されます。UAP共用ライブラリ入れ替え機能の実行中にプロセスダウンした場合は，TP1/EE開始時に取得したステータスファイルの情報を基にプロセスを回復します。TP1/EEプロセスの再開始前と再開始後でUAP共用ライブラリ定義数が異なっている場合は，再開始処理でプロセスダウンします。したがって，UAP共用ライブラリ入れ替え機能を使用する場合は，UAP共用ライブラリ定義数（ユーザサービス関連定義のmoduleオペランドで指定）を変更しないでください。

TP1/EEは，トランザクションの静止化から解除までの静止化状態を監視します。静止化状態が1分以上続いている場合は，静止化中であることを警告するKFSB40810-Wメッセージを，1分間隔で出力します。ただし，eechgapコマンドを実行するタイミングによってメッセージの出力間隔に誤差が発生することがあります。

トランザクションの静止化の処理中にエラーが発生した場合，トランザクションの静止化の処理中または静止化状態の解除後に，次に示すトランザクションが起動します。

トランザクションの静止化の処理中に起動するトランザクション

回復トランザクション

エラー再送トランザクション

ERRTRN3

ERRTRNR

トランザクションの静止化状態の解除後に起動するトランザクション

ERRTRNS

次の図に示すUAP共用ライブラリの入れ替えを実行しないでください。実行した場合の動作は保障しません。

3.7.4　定義事前チェック機能

定義事前チェック機能を使用すると，TP1/EEを稼働する前に，定義の構文チェックをしたり，定義の論理チェックをして必要なメモリ領域を確保したりすることによって，該当する定義でTP1/EEを稼働できるかどうかを判定できます。

定義事前チェック機能は，eedefchkコマンドに，チェック対象となるTP1/EEサービス定義ファイル名およびチェックレベルを指定して実行します。チェック結果は，メッセージとして標準出力に出力します。ここで出力されるメッセージは，TP1/EEの初期化処理中の定義チェック処理で出力されるメッセージと同じです。

チェックレベルには，定義構文チェックと定義詳細チェックがあります。それぞれのチェックレベルについて説明します。

(1)　定義構文チェック

定義構文チェックでチェックできる内容を次に示します。

記述のフォーマットチェック

指定値の妥当性のチェック

指定値の範囲が正常かどうか，不正な文字を使用していないかどうか，関連する定義で指定値の整合性が保たれているかどうかなどのチェックです。

必ず指定する値の有無チェック

オペランドの二重定義チェック

複数回指定できないオペランドを複数回指定していないかどうかのチェックです。

これらのチェック内容は，1回のチェックですべてのオペランドに対してチェックできます。

定義構文チェックを実行するには，次に示す準備が必要です。

チェック対象となる定義ファイルの作成

環境変数DCDIRの設定

TP1/EEのインストール

(2)　定義詳細チェック

定義詳細チェックでは，定義構文チェックで実行するチェック内容に加えて，定義の指定値間の詳細な論理チェックを実行します。定義詳細チェックを実行すると，TP1/EEの初期化処理時に実行する定義チェックと同じチェックを実行したあとで，メモリ領域を確保します。

定義詳細チェックでチェックできる内容を次に示します。

定義構文チェックで実行するチェック

複数のオペランド間にわたる指定内容の論理チェック

指定内容の重複チェック

定義コマンドの指定数の上限チェック

UAP共用ライブラリの存在確認チェック

指定したホスト名のアドレス解決チェック

メモリの確保が可能かどうかのチェック

定義詳細チェックの結果ではメモリの確保が可能でも，TP1/EE起動時にメモリの確保が可能であることは保証しません。

これらのチェックを実行したあとで，定義の内容に基づいて実際に確保したメモリ領域のサイズに共用ワーク領域分のサイズを足した値を表示します。

定義詳細チェックを実行するには，次に示す準備が必要です。

チェック対象となる定義ファイルの作成

環境変数DCDIRの設定

TP1/EEのインストール

メモリ関連定義のmax_mem_sizeオペランドで指定したサイズの空きメモリの確保

チェックの実行環境がmax_mem_sizeオペランドで指定したサイズのメモリを確保できない環境設定になっている場合は，ulimitコマンドや環境変数LDR_CNTRLを使用してリソースの使用制限を変更してください。

UAP共用ライブラリの作成

3.7.5　起動順序のシリアル化機能

TP1/EEでは，一つのTP1/EEの初期化トランザクションが終了する前に次のTP1/EEの初期化トランザクションが起動されることがあります。このため，TP1/Server Baseのユーザサービス構成定義のdcsvstart定義コマンドに指定した順序どおりにTP1/EEが起動されないことがあります。そのような場合に起動順序のシリアル化機能を使用すると，指定した順序どおりにTP1/EEを起動できます。

起動順序のシリアル化機能を使用する場合は，プロセス関連定義のinitialize_syncオペランドにYを指定してください。起動順序のシリアル化機能を使用した場合の処理の例を次の図に示します。

図3‒50　起動順序のシリアル化機能を使用した処理の例

TP1/Server Baseがユーザサービス構成定義のdcsvstart定義コマンドの指定に従って，SPP1を起動します。

SPP1のプロセス関連定義のinitialize_syncオペランドにYが指定されているため，SPP1の起動が完了したあとにSPP2が起動されます（起動順序のシリアル化）。

SPP2のプロセス関連定義のinitialize_syncオペランドにNが指定されているため，SPP2の起動が完了する前にSPP3が起動されます。

TP1/EE起動時の処理には，起動順序のシリアル化機能を使用するかどうかによって，処理内容が異なるものがあります。TP1/EE起動時の処理と，起動順序のシリアル化機能の使用有無による処理内容の違いについて，次の表に示します。

表3‒26　起動順序のシリアル化機能の使用有無によるTP1/EE起動時の処理内容の違い

TP1/EE起動時の処理

処理内容

機能を使用しない場合

機能を使用する場合

eesvstartコマンドまたはdcsvstartコマンドの終了処理

eesvstartコマンドまたはdcsvstartコマンドは，初期化処理中に終了します。

eesvstartコマンドまたはdcsvstartコマンドは，初期化処理の完了後に終了します。ただし，起動順序のシリアル化機能を使用しない場合よりeesvstartコマンドまたはdcsvstartコマンドの処理に掛かる時間が長くなります。

初期化処理中のeesvstopコマンド実行の受け付け処理

eesvstopコマンドの実行を受け付けます。ただし，TP1/EEが終了するのは初期化処理の完了後となります。-fオプションを指定したeesvstopコマンドを実行すると，TP1/EEは即座に終了します。

-fオプションを指定したeesvstopコマンドの実行だけを受け付けます。-fオプションを指定したeesvstopコマンドを実行すると，TP1/EEは即座に終了します。

-fオプションを指定したeesvstopコマンド以外を実行した場合は，コマンドがエラー終了します。

初期化処理中のdcstopコマンド実行の受け付け処理

dcstopコマンドの実行を受け付けます。ただし，TP1/EEが終了するのは初期化処理の完了後となります。-fオプションを指定したdcstopコマンドを実行すると，TP1/EEは即座に終了します。

dcstopコマンドの実行を受け付けません。dcstopコマンドを実行した場合は，コマンドがエラー終了します。-fオプションを指定したdcstopコマンドを実行すると，TP1/EEは即座に終了します。

初期化トランザクション起動中のプロセスダウン後の処理

TP1/Server BaseからTP1/EEが再起動されます。TP1/EEは，KFSB65390-Eメッセージを出力したあとに終了します。eesvstartコマンドまたはdcsvstartコマンドを実行すると，コマンドは正常終了します。

TP1/EEは再起動されません。eesvstartコマンドまたはdcsvstartコマンドを実行すると，コマンドは異常終了します。

定義チェック中のプロセスダウン後の処理

TP1/EEは再起動されません。eesvstartコマンドまたはdcsvstartコマンドを実行すると，コマンドは異常終了します。

3.7.6　回線トレースファイルとTASKTMファイルの関連づけ

注意事項

MCPをご利用の場合は，説明中の"回線トレースファイル"を"MCPトレースファイル"に置き換えてお読みください。

メッセージ受信時に取得する回線トレースファイルと，メッセージ受信後にトランザクションを起動して取得するTASKTMファイルに，それぞれ受信IDを出力することができます。この受信IDを基に，回線トレースファイルとTASKTMファイルのレコードを関連づけることで，受信したメッセージがどのトランザクションを起動したものなのかを結び付けられます。結び付けた情報は，障害対策などに利用できます。

受信IDは符号なし4バイト型で，受信スレッド通番とメッセージ通番から構成されます。受信スレッド数別に，受信IDの構成を次に示します。

全プロトコルの受信スレッド数の合計が255以下の場合

受信スレッド通番：上位1バイト（1〜255）

メッセージ通番：下位3バイト（1〜16777215）

全プロトコルの受信スレッド数の合計が256以上の場合

受信スレッド通番：上位2バイト（1〜65535）

メッセージ通番：下位2バイト（1〜65535）

なお，受信スレッドが管理するメッセージ通番の単位は，使用するプロトコルによって異なります。UDPプロトコルの場合は送信元のスレッド単位，それ以外のプロトコルの場合はコネクション単位となります。

以降，回線トレースファイルとTASKTMファイルのレコードを関連づけるために必要な設定と，関連づけのパターンについて説明します。

(1)　関連づけに必要な定義，およびコマンドオプション

関連づけをするために，次の定義を指定します。

トラブルシュート関連定義のtrb_tasktm_typeオペランド：2

トラブルシュート関連定義のtrb_trace_typeオペランド：1

また，次のコマンドにオプションを指定し，実行します。

eetrblinedumpコマンド：-kオプション

eetrblineedコマンド：-kオプション

(2)　関連づけのパターン

回線トレースファイルとTASKTMファイルに出力される，受信IDの関連づけのパターンは複数あります。ここでは，それぞれのパターンについて説明します。

(a)　パターン1（1：1）

出力される受信IDの対応が，1対1の場合の例を示します。

図3‒51　関連づけのパターン1（1：1）

この例では，目的の受信IDに該当する回線トレースファイルとTASKTMファイルのレコードが，それぞれ1行ずつあります。

(b)　パターン2（1：n）

出力される受信IDの対応が，回線トレースファイルでは1レコード，TASKTMファイルでは複数レコードの場合の例を示します。nは2以上の整数です。

図3‒52　関連づけのパターン2（1：n）

この例では，回線トレースファイルの目的の受信IDを含むレコードが1行であるのに対し，TASKTMファイルの対応するレコードが2行です。

(c)　パターン3（n：1）

出力される受信IDの対応が，回線トレースファイルでは複数レコード，TASKTMファイルでは1レコードの場合の例を示します。nは2以上の整数です。

図3‒53　関連づけのパターン3（n：1）

この例では，回線トレースファイルの目的の受信IDを含むレコードが2行であるのに対し，TASKTMファイルの対応するレコードが1行です。

(d)　パターン4（n：m）

出力される受信IDの対応が，回線トレースファイルとTASKTMファイルのレコードでそれぞれ複数行にわたる場合の例を示します。nおよびmは2以上の整数です。

図3‒54　関連づけのパターン4（n：m）

この例では，目的の受信IDに該当する回線トレースファイルとTASKTMファイルのレコードが，それぞれ2行ずつあります。

3.8　複数のTP1/EEを使用する場合の機能

TP1/EEを大規模システムへ適用するための機能について説明します。

3.8.1　系切り替え機能

TP1/Server Baseでは，サーバシステム（系）を二つ準備して，一つの系に障害が発生したときに，もう一方の系に切り替えることによって，OpenTP1システムの稼働率を上げることができます。この機能を系切り替え機能といいます。系切り替え機能を使用するには，HAモニタが必要です。

TP1/EEは，TP1/Server BaseのSPPとして動作するため，TP1/EEが直接HAモニタと連携することはありません。系切り替え機能使用時のTP1/EEの動作は，TP1/Server Baseに依存します。

系切り替え機能については，次のとおり参照してください。

系切り替え機能の詳細，および系切り替え機能使用時のTP1/Server Baseの運用については，マニュアル「OpenTP1 解説」を参照してください。

系切り替え機能使用時のTP1/EEの運用については，「6.8.1　系切り替え機能使用時の運用」を参照してください。

HAモニタについては，マニュアル「高信頼化システム監視機能 HAモニタ」を参照してください。

3.9　COBOL用メモリ管理機能

COBOL用メモリ管理機能は，UAPをCOBOLで作成した場合に，COBOL2002とTP1/EEが連係して，COBOLが使用するメモリ領域をTP1/EEで管理する機能です。

WORKING-STORAGE SECTIONなどのCOBOLが利用するメモリ領域は，TP1/EEがメモリプールとしてまとめて確保・管理します。TP1/EEは，COBOLからのメモリ要求ごとに，メモリプールからメモリを割り当てます。使用済みとなったメモリはメモリプールに返還し，次回のCOBOLからのメモリ割り当て要求時に再利用します。

COBOLとOSの間にTP1/EEのプール管理を介在させることで，システムコール（malloc，free）の発行が抑制され，マシン全体としての処理性能向上が期待できます。ただし，一定量のメモリをプール管理するため，マシン全体としてのメモリの利用効率は低下するおそれがあります。

COBOL用メモリ管理機能の管理対象は，DATA DIVISION（PICTURE句で宣言された変数やデータ）など，COBOL自体が使用する領域です。次の領域は，管理対象外です。

COBOLのUAPがTP1/EE提供API（CBLEEMEM('GETWK ')）によって取得するメモリ領域（メモリ関連定義のuser_work_sizeオペランドで指定したエリア）

ユーザ用プロセス管理テーブルエリア（メモリ関連定義のsystem_user_areaオペランド，またはsystem_user_area_mbオペランドで指定したエリア）

ユーザ用スレッド対応インタフェースエリア（メモリ関連定義のthread_user_areaオペランド，またはthread_user_area_mbオペランドで指定したエリア）

この機能を使用する場合は，メモリ関連定義のmemory_cobol_area_sizeオペランド，またはmemory_cobol_area_thd_sizeオペランドを指定します。定義を設定すれば，UAPでこの機能を実装する必要はありません。

3.9.1　メモリプールの作成単位

COBOL用メモリ管理機能を使用する場合，COBOL用メモリ領域のメモリプールの作成単位を，TP1/EEのプロセス単位に1プールとするか，処理スレッド単位に1プールとするかをメモリ関連定義で選択できます。どちらを選択するかは，システムに求められる性能要件とマシンに搭載できるメモリ容量によって判断してください。

(1)　プロセス単位にメモリプールを作成する場合

COBOL用メモリ領域のメモリプールを，TP1/EEのプロセスに一つずつ作成します。各処理スレッドからのメモリ割り当て要求に対して，同一のメモリプールからメモリを割り当てます。

プロセス単位にメモリプールを作成する場合，作成するメモリプールのサイズをメモリ関連定義のmemory_cobol_area_sizeオペランドで指定します。

プロセス単位にメモリプールを作成すると，同一プロセス内のすべての処理スレッドでメモリプールを共有するため，TP1/EE内でのメモリ利用効率を向上できます。ただし，各処理スレッドからのメモリ割り当て・解放の処理に排他制御を伴うため，処理スレッドのメモリ割り当て・解放要求が競合した場合に同時実行性が低下するおそれがあります。

(2)　処理スレッド単位にメモリプールを作成する場合

COBOL用メモリ領域のメモリプールを，TP1/EEの処理スレッドに一つずつ作成します。各処理スレッドからのメモリ割り当て要求に対して，処理スレッド専用のメモリプールからメモリを割り当てます。

処理スレッド単位にメモリプールを作成する場合，作成するメモリプールのサイズをメモリ関連定義のmemory_cobol_area_thd_sizeオペランドで指定します。

処理スレッド単位にメモリプールを作成すると，ほかのスレッドの処理に影響されません。このため，複数の処理スレッドで同時にメモリ割り当て・解放要求が発生した場合に，処理性能を向上できます。ただし，各処理スレッドに専用のメモリプールを作成するため，メモリの利用効率が低下するおそれがあります。

3.9.2　メモリプールを確保するタイミングとサイズ

COBOL用メモリ領域のメモリプールを確保するタイミングとサイズについて説明します。

(1)　プロセス単位にメモリプールを作成する場合

メモリプールは，TP1/EEのプロセス起動時にOSから初期プールを確保します。確保するプールのサイズは，メモリ関連定義のmemory_cobol_area_sizeオペランドの第一指定値に指定したサイズです。

オンライン中にプールが不足した場合，OSから追加でプールを確保します。追加確保するプールのサイズは，メモリ関連定義のmemory_cobol_area_sizeオペランドの第二指定値に指定したサイズ，または確保要求での要求サイズです。どちらのサイズで確保するかは，オペランドの指定値，要求サイズ，およびOSの空きメモリ容量によって決まります。

OSから割り当てられたメモリプールは，TP1/EEのプロセスが終了するまでOSには返還しません。

(2)　処理スレッド単位にメモリプールを作成する場合

メモリプールは，TP1/EEのプロセス起動時にOSから初期プールを確保します。確保するプールのサイズは，「メモリ関連定義のmemory_cobol_area_thd_sizeの第一指定値に指定したサイズ×処理スレッド数」です。

オンライン中にプールが不足した場合，OSから追加でプールを確保します。追加確保するプールのサイズは，メモリ関連定義のmemory_cobol_area_thd_sizeオペランドの第二指定値に指定したサイズ，または確保要求での要求サイズです。どちらのサイズで確保するかは，オペランドの指定値，要求サイズ，およびOSの空きメモリ容量によって決まります。

なお，プールを追加確保する場合は，プロセス単位で排他を掛けます。

3.9.3　メモリの使用状況の確認

COBOL用メモリ管理機能（COBOL用ワーク領域）のメモリの使用状況は，コマンド，システム統計情報，またはメッセージログで確認できます。

コマンドでの確認

メモリ使用状況を表示するeememlsコマンドを使用して，プロセス単位のメモリ使用状況を確認できます。

システム統計情報での確認

プロセス単位の稼働統計情報を確認できます。システム統計情報の確認については，「6.3.4　統計情報ファイルの運用」，および「付録B.1　システム統計情報」を参照してください。

メッセージログでの確認

プロセス単位のメモリ使用状況

オンライン終了時のメッセージログ（KFSB45105-W）で確認できます。なお，このメッセージログを出力するためには，メモリ関連定義のmemory_alert_rateオペランドの設定が必要です。

処理スレッド単位のメモリ使用状況

処理スレッド単位のプールを最も多く確保した処理スレッドのメモリ使用状況を，オンライン終了時のメッセージログ（KFSB85102-I）で確認できます。なお，このメッセージログを出力するためには，TP1/Server Baseのユーザサービス定義で環境変数EEPARM1の設定が必要です。

3.10　ファイルディスクリプタの拡張（Linuxの場合）

TP1/EEがオープンできるファイルディスクリプタの上限値を拡張します。ファイルディスクリプタを拡張する場合は，次のオペランドを指定する必要があります。

TP1/EEのプロセス関連定義 ……… descriptors_expanse_use

TP1/SBのユーザサービス定義 …… setrlimit_nofile

上記オペランドは，「setrlimit_nofile >= max_descriptors」にする必要があります。

プロセス関連定義のdescriptors_expanse_useオペランドにYを指定した場合は，ファイルディスクリプタの上限値（max_descriptorsオペランド）を拡張することができます。ただし，次のような場合は，KFSB65305-Eメッセージを出力し，TP1/EEの起動に失敗します。

max_descriptorsオペランドで指定している値が，ハードウェアリミットよりも大きい

ファイルディスクリプタの上限拡張（ソフトウェアリミットの拡張）に失敗した

プロセス関連定義のdescriptors_expanse_useオペランドにYを指定した場合は，次のオペランドの最大値が拡張されるので，必要に応じてオペランド値を見直してください。ただし，プロセス関連定義のdescriptors_expanse_useオペランドにNを指定した場合に，次の表に示す上限値を超過した値を指定したときは，KFSB61817-Eメッセージを出力し，TP1/EEの起動に失敗します。

表3‒27　上限値が拡張されるオペランド一覧と上限値

項番

オペランド名

descriptors_expanse_use

オペランドがNの場合の上限値

descriptors_expanse_use

オペランドがYの場合の上限値

1

max_descriptors

1,024

32,767

2

fil_filesystem_no

800

4,096

3

socket_no

800

20,000

4

rpc_reply_con_max_cnt

800

20,000

5

rpc_reply_con_cnt

800

20,000

6

rpc_reply_proc_max_cnt

800

20,000

7

rap_max_client

800

20,000

8

rpc_tcpsend_con_max_cnt

800

20,000

9

rpc_tcpsend_con_cnt

800

20,000

10

rpc_tcpsend_proc_max_cnt

800

20,000

この機能を使用する場合は，UAP内，または関連PPでselect（）関数を使用して，ファイルディスクリプタを参照するような個所は修正が必要になるときがあります。

3.11　コマンドログ取得機能

運用コマンド実行時の情報（開始と任意情報と終了）をコマンドログファイルに出力します。

3.11.1　出力先

コマンドログの出力先を次の表に示します。

表3‒28　コマンドログの出力先

項番

機能

コマンドログファイル格納ディレクトリ

ファイル名

1

オンラインコマンド

$DCDIR/spool/dceeinf/cmdlog

cmdlog1，cmdlog2

2

オフラインバッチ用コマンド

$EEBPPDIR/cmdlog

cmdlog1，cmdlog2

3

データ連携支援用コマンド

$EERKSDIR/cmdlog

cmdlog1，cmdlog2

cmdlog1およびcmdlog2のファイルサイズは，1メガバイトです。

cmdlog1およびcmdlog2のファイルはラップアラウンドして使用します。

3.11.2　コマンドログの取得タイミング

コマンドログ取得対象コマンドの開始時，終了時にコマンドログファイルへ情報を出力します。

3.11.3　コマンドログ取得対象コマンド

コマンドログの取得対象となるのは，TP1/EE，オフラインバッチ，およびデータ連携支援のプロセス開始／終了，プロセスの状態変更を行うコマンドです。

3.11.4　コマンドログ取得処理失敗について

コマンドログの取得に失敗した場合でもコマンド処理を続行します。

3.12　処理キュー統計情報の表示機能

コマンド実行（eelsque）単位の処理キュー統計情報を表示する機能です。前回コマンド実行時から今回コマンド実行時までの処理キュー統計情報を出力します。

処理キュー統計情報の内容は次のとおりです。

前回コマンド実行時から今回コマンド実行時までに処理した処理キュー数

今回コマンド実行時に滞留していた処理キュー数

前回コマンド実行時から今回コマンド実行時までに，滞留していた処理キューの最小滞留時間

前回コマンド実行時から今回コマンド実行時までに，滞留していた処理キューの最大滞留時間

前回コマンド実行時から今回コマンド実行時までに，滞留していた処理キューの平均滞留時間

今回コマンド実行時に，対象処理キューを実行中のスレッド数

サービス／トランザクションレベルの同時処理限界数

サービス／トランザクションレベル（処理キュー名）

統計情報はサービス名単位で表示します。ただし，次の条件をすべて満たす場合，トランザクションレベル名単位でキュー情報を表示します。

fsp_useオペランドにYを指定

TP1/FSPのqueue_draw_method定義-pオプションにtrnlevelを指定

出力対象は次の定義で指定したサービス，またはトランザクションレベルです。

service

dbq_service

dbq_obs_service

obm_service

queue_trnlevel

統計情報の取得対象となるトランザクションは次のとおりです。

ユーザコマンドトランザクション

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

MCP後処理トランザクション

タイマトランザクション

ERRTRN2

ERRTRN4

キュー情報の1つの処理数を例に説明します。

次の図はサービス単位の処理キューの処理数の変化を時系列に表した図です。

コマンド実行1でサービスSV1のキュー情報を出力後，全ユーザサービスの出力用キュー情報を初期化します。コマンド実行2で-vオプションを省略した場合，SV2，SV3の出力されるキュー情報はコマンド実行1を実行した時間からカウントしたキュー情報になります。

図3‒55　出力するキュー情報

4　TP1EEファイルシステムとファイル

この章では，TP1EEファイルシステムおよびTP1EEファイルの概要について説明します。TP1EEファイルシステムとファイルの運用については「6.2　TP1EEファイルの運用」，TP1EEファイルシステムとファイルの障害対策については「11.5　TP1EEファイル障害」を参照してください。

4.1　TP1EEファイルシステムの概要

TP1/EEは，ファイルの使用効率がよいOSが提供するファイルシステムと，信頼性が高いTP1/EEが提供するファイルシステムを使用しています。TP1/EEで管理するファイルシステムを，TP1EEファイルシステムといいます。

注意事項

TP1EEファイルシステムとOpenTP1ファイルシステム（TP1/Server Baseで管理するファイルシステム）には，互換性がありません。

TP1/EEのコマンドで，OpenTP1ファイルシステムを参照，更新することはできません。また，TP1/Server Baseのコマンドで，TP1EEファイルシステムを参照，更新することはできません。

したがって，TP1EEファイルシステムとOpenTP1ファイルシステムの両方を作成する必要があります。

4.1.1　TP1EEファイルシステムとTP1EEファイル

OSが入出力するディスクは連続領域ごとに分割され，それぞれの領域をパーティションと呼びます。それぞれのパーティションを，OSが提供するファイルシステムまたはTP1EEファイルシステムに使用できます。

TP1EEファイルシステムは，OSが提供するファイルシステムとは独立した，TP1/EE専用のファイルシステムです。キャラクタ型スペシャルファイル，ブロック型スペシャルファイル，または通常ファイル上にTP1EEファイルシステムを作成します。TP1/EEシステムの信頼性に関係する重要な情報を格納するファイルは，TP1EEファイルシステム上に作成します。TP1EEファイルシステム上に作成するファイルを，TP1EEファイルといいます。

TP1EEファイルを次の表に示します。

表4‒1　TP1EEファイルの一覧

ファイル名

ファイルの使用方法

ステータスファイル

システムサービスの稼働状態やシステム制御情報を格納して，障害が起こったときにTP1/EEを回復するときに使います。

TP1EEファイルシステムとOSが提供するファイルシステムの関係を図4-1に示します。また，TP1EEファイルシステムとOSが提供するファイルシステムとの違いを表4-2に，TP1EEファイルシステムを作成するファイルの選択方法を図4-2に示します。

図4‒1　TP1EEファイルシステムとOSが提供するファイルシステムの関係

表4‒2　TP1EEファイルシステムとOSが提供するファイルシステムとの違い

比較項目

TP1EEファイルシステム

OSが提供するファイルシステム

キャラクタ型スペシャルファイルまたはブロック型スペシャルファイル上

通常ファイル上

信頼性

TP1/EEが異常終了したとき直前に正常終了した書き込み要求で指定したデータ

書き込まれている

不定

ファイル領域の連続性

TP1EEファイルシステム作成時に連続領域を確保

TP1EEファイルシステム作成時にファイル領域を確保するが，連続領域である保証はない

TP1EEファイルシステム作成時にファイル領域を確保するが，連続領域である保証はない

性能

ディスク領域の使用効率

TP1EEファイル中のレコードが書き込まれていない領域も，そのファイルのために確保済みのため，ほかのファイルに割り当てることはできない

ファイルのサイズが大きくなるときに1ブロックずつ確保するため，TP1EEファイルと比べて使用効率が良い

読み込みの実行時間（関数がリターンするまでの時間）

OSが提供するファイルシステムより遅い

バッファ上でヒットするとディスクから読まないので速い

書き込みの実行時間（関数がリターンするまでの時間）

OSが提供するファイルシステムより遅い

キャラクタ型スペシャルファイルまたはブロック型スペシャルファイル上のTP1EEファイルシステムより遅い

遅延書き込みのため速い

アクセス時間のばらつき

均等

ばらつきあり

ばらつきあり

運用

ファイル容量の見積もり

ファイルの作成時に容量を指定する必要がある

ファイルの容量を指定する必要はない

ファイル容量の動的増分

増分できない

増分できる

ディレクトリによるファイルの分類

できない

できる

図4‒2　TP1EEファイルシステムを作成するファイルの選択方法

4.1.2　通常ファイル

通常ファイルは，柔軟性があり使用効率がよいという特長があります。このため，TP1/EEの定義ファイルなどに使用します。

TP1/EEで使用する通常ファイルを次の表に示します。

表4‒3　TP1/EEで使用する通常ファイル

ファイル名

ファイルの用途

備考

ユーザプログラムライブラリ

UAP共用ライブラリを格納するファイルです。

ユーザが作成します。

各種定義ファイル

TP1/EEの各種システム定義を格納します。

TP1/EEプログラムファイル

TP1/EEのプログラムを格納します。TP1/EEの実行形式ファイルとUAPの作成に使うファイルがあります。

インストール時に自動的に作成されます。

メッセージオブジェクトファイル

メッセージテキストを格納します。

TASKTMファイル

トランザクションごとの統計情報を格納します。

TP1/EE実行時に作成されます。

回線トレースファイル

送受信メッセージや，リソースマネジャ使用時のXAインタフェースなどのデータ，状態に関する情報を格納します。

UAPトレースファイル

UAPの障害に備えて，UAPで使用したTP1/EEのライブラリ関数の発行履歴を取得する，UAPトレース情報を格納します。

統計情報ファイル

TP1/EEシステムの稼働状況に関する情報を格納します。

メモリダンプファイル

TP1/EEが出力したメモリの内容を格納します。

UAPの異常終了によって，スレッドダウンが発生したときに作成されます。

メッセージログファイル

TP1/EEおよびUAPが出力したメッセージを格納します。

TP1/EE実行時に作成されます。

4.2　ステータスファイル

ステータスファイルの概要について説明します。

4.2.1　ステータスファイルの目的

前回のTP1/EEが，eesvstopコマンドを入力して終了したか，障害が起こって異常終了したかを判断して，再開始処理を自動化するためのデータをステータスファイルに格納します。TP1/EEを開始するために引き継がなければならないシステム制御情報を，状態が変化した時点で格納します。システム制御情報には，次のようなものがあります。

TP1/EEシステムの終了状態

サービスの閉塞状態

システム定義情報

トランザクション情報

DBキュー状態

DBキューサービス状態

RPC情報

UAP共用ライブラリ入れ替え情報

処理キューの最大同時処理限界数の変更情報

ERRTRNRによるRPC応答メッセージ送信情報

SDBハンドラ情報（TP1/FSPを使用する場合）

タイマデータ表情報（TP1/FSPを使用する場合）

4.2.2　ステータスファイルの構成

ステータスファイルは，TP1/EEを再開始するためのきわめて重要なファイルです。ステータスファイルに何らかの障害が起こった場合でもTP1/EEを再開始できるように，二つのステータスファイルを組にして二重化します。組になった二つのステータスファイルを論理ファイルといい，個々のステータスファイルをそれぞれA系，B系と呼んで区別します。論理ファイルは，複数個指定できます。

二つのステータスファイルが同時に障害にならないように，各論理ファイル，A系のステータスファイルおよびB系のステータスファイルは，なるべくディスクを分けてください。

ユーザは，ステータスファイル関連定義のstsflnam定義コマンドの-lオプションで論理ファイルに任意の名称を指定します。この論理ファイル名を使用することで，A系，B系のステータスファイルを同時にオープン，クローズするなど，論理ファイル単位に運用できます。

ステータスファイルには，次の2種類があります。

制御用ステータスファイル

シグナル用ステータスファイル

なお，制御用ステータスファイルとシグナル用ステータスファイルは，異なるTP1EEファイルシステム上に作成してください。

ステータスファイルの構成を次の図に示します。

図4‒3　ステータスファイルの構成

(1)　制御用ステータスファイル

制御用ステータスファイルは，幾つかのグループに分けることができます。各グループのディスクを分けると，グループごとにアクセスできるため，性能の向上が図れます。制御用ステータスファイルは，ステータスファイル関連定義のstsflnam定義コマンドで，各グループに論理ファイルを最低3組，最大7組，指定でき，論理ファイルとステータスファイルの対応関係を定義します。各グループで，一つの論理ファイルを現用ファイル，そのほかの論理ファイルを予備ファイルとして障害に備えます。グループごとに，グループ数によって決められたシステム制御情報を取得します。

(2)　シグナル用ステータスファイル

シグナル用ステータスファイルは，プロセスダウンの原因となったサービスを再開始時に閉塞するため，プロセスダウン時にシグナルハンドラからのアクセス用に設けた専用ファイルです。

シグナル用ステータスファイルは，論理ファイルを1組だけ指定でき，現用ファイルとして使用します。また，予備ファイルはなく，グループに分けることもできません。

(3)　レコード長およびレコード数の設定

eestsinitコマンドでステータスファイルを作成，初期設定するとき，TP1/EEが必要とする容量を満たすようにレコード長とレコード数を設定してください。なお，レコード長は制御用ステータスファイルごと，シグナル用ステータスファイルごとに同じ値を，レコード数はグループごとに同じ値を設定してください。

レコード長またはレコード数を変更した場合は，正常開始から立ち上げる必要があります。レコード長またはレコード数を変更したステータスファイルを予備ファイルとした再開始はできません。開始／再開始時にチェックし，レコード長またはレコード数が不一致の場合，そのファイルを閉塞し，使用できないようにします。

制御用ステータスファイルでレコード長またはレコード数が不一致である場合，TP1/EEシステムを停止させるか開始／再開始させるかは，ステータスファイル関連定義のsts_initial_error_switchオペランドで指定します。

シグナル用ステータスファイルでレコード長またはレコード数が不一致である場合，A系，B系のうちどちらか片方の系が正常のときは，正常な系で開始／再開始処理を続行します。

(4)　ステータスファイルの片系運転

オンライン中にステータスファイルに障害が発生して，予備ファイルがない場合でも，異常終了しないで正常な系だけで処理を続けられます。これをステータスファイルの片系運転といいます。

制御用ステータスファイルの場合，片系運転をするかどうかをステータスファイル関連定義のsts_single_operation_switchオペランドで指定します。シグナル用ステータスファイルの場合，正常な系だけで処理を続行します。

ただし，片系運転中にシステムが異常終了すると，再開始時に現用ファイルを決定できないため，再開始ができません。そのため，ステータスファイル関連定義のstsflgrp定義コマンドで前回オンライン時の現用ファイルを定義する必要があります。

また，片系運転中にステータスファイルで障害が発生した場合や，ファイル更新中にシステムが異常終了した場合は，再開始のための情報が失われるため，再開始ができません。制御用ステータスファイルの場合，片系運転に切り替わったことを知らせるメッセージログが出力されたときは，使用できる予備ファイルを早急に用意して，正常な両系運転に復帰させてください。シグナル用ステータスファイルの場合，両系運転に復帰できません。ファイルを再作成し，次回のオンラインに備えてください。

ステータスファイルの片系運転の詳細については，「11.5.1　ステータスファイルの障害」を参照してください。

4.2.3　ステータスファイルの状態

ステータスファイルは次の状態に分けられます。

現用

現時点でシステム制御情報の出力対象になっているオープン中の状態です。ファイルの実体が必要です。

予備

現時点でシステム制御情報の出力対象にはなっていないが，現用のステータスファイルが入出力障害などで使用できなくなったときに，現用のステータスファイルと切り替えるためにオープン中の状態です。ファイルの実体が必要です。

シグナル用ステータスファイルの場合，この状態は存在しません。

無効

ステータスファイル関連定義のstsflnam定義コマンドに指定されているが，オープンしないとオンラインでは使用できないクローズ中の状態です。

閉塞

オンライン中に障害が発生し，閉塞しているクローズ中の状態です。

TP1/EEは，TP1/EEプロセス開始／再開始時に，ステータスファイル関連定義のstsflnam定義コマンドで指定したすべてのステータスファイルをオープンします。オープンしたステータスファイルのうちシステム制御情報の出力対象となっているファイルを現用ファイルといい，オープン中のその他のファイルを予備ファイルといいます。現用ステータスファイルに障害が発生しないかぎり，システム制御情報は常に現用ステータスファイルに格納されます。

システム制御情報は，まずA系のステータスファイルに書き込まれ，その後B系のファイルに書き込まれます。このため，A系ファイル書き込み中にTP1/EEが異常終了し，A系ファイルが利用できなくなっても，B系ファイルは元の状態を保っているので，プロセスの回復時にB系ファイルを読み込むことで再開始できます。

4.2.4　制御用ステータスファイルのスワップ

制御用ステータスファイルで，論理ファイル単位に現用ファイルを切り替えることをスワップと言います。シグナル用ステータスファイルには予備ファイルがないため，スワップしません。A系またはB系のシグナル用ステータスファイルに入出力障害が発生すると，障害ファイルを閉塞し，正常なファイルだけで片系運転をします。

制御用ステータスファイルのスワップの詳細については，「6.2.2（2）　制御用ステータスファイルのスワップ」を参照してください。

4.2.5　取得するステータスファイルの種類

トランザクション制御では，TP1/EEプロセスダウン後の再開始処理で，未決着トランザクションを回復させるために，トランザクション情報をステータスファイルに出力します。

トランザクション情報を取得するステータスファイルの種類については，「11.1.3　回復処理で使用するステータスファイル」を参照してください。

5　環境設定

この章では，TP1/EEの環境設定とその手順について説明します。

5.1　環境設定の概要

TP1/EEの環境設定の手順を次の図に示します。

図5‒1　TP1/EEの環境設定の手順

この図の手順のうち，5，6，7，10，11，15，16，19の手順については，「5.2　環境設定の詳細」で詳細を説明します。それ以外の手順については，マニュアル「OpenTP1 運用と操作」の環境設定の説明を参照してください。

OpenTP1が導入されていない端末とメッセージの送受信をする場合は，uCosminexus TP1/EE/Message Control Extension（MCP）が必要です。MCPの環境設定の手順については，マニュアル「TP1/EE/Message Control Extension 使用の手引」を参照してください。

TP1キャッシュ機能を使用する場合は，uCosminexus TP1/EE/Extended Transaction Controller（XTC）およびuCosminexus TP1/EE/Extended Data Cache（XDB）が必要です。それぞれの環境設定の手順については，マニュアル「TP1/EE/Extended Transaction Controller 使用の手引」およびマニュアル「TP1/EE/Extended Data Cache 使用の手引」を参照してください。

銀行勘定系サービス処理基盤を構築する場合は，uCosminexus TP1/Financial Service Platform（TP1/FSP）が必要です。TP1/FSPの環境設定の手順については，TP1/FSPの関連ドキュメントを参照してください。

5.2　環境設定の詳細

「5.1　環境設定の概要」の「図5-1　TP1/EEの環境設定の手順」のうち，5，6，7，10，11，15，16，19の手順は，TP1/EEを使用するための環境設定です。それぞれの手順の詳細を説明します。

5.2.1　TP1/EEのインストール

TP1/EEのプログラムプロダクトをインストールします。「5.1　環境設定の概要」の「図5-1　TP1/EEの環境設定の手順」の手順4でTP1/Server Baseをインストールしたときに作成されたインストールディレクトリ下に必要なファイルが格納されます。

5.2.2　TP1/Server Baseシステム定義の作成

OpenTP1管理者は，スーパユーザがTP1/Server BaseをOSに登録する前に，TP1/EEを使用するための指定をしたTP1/Server Baseのシステム定義を作成します。TP1/EEを使用するためのTP1/Server Baseのシステム定義の詳細については，「7.2.2　TP1/Server Baseのシステムサービス定義の内容」を参照してください。

5.2.3　TP1/EEサービス定義の作成

OpenTP1管理者は，TP1/EEを起動する前にTP1/EEサービス定義を作成します。TP1/EEサービス定義の詳細については，「7.2.3　TP1/EEサービス定義の内容」および「8.　TP1/EEサービス定義の詳細」を参照してください。

5.2.4　TP1EEファイルシステム領域の作成

TP1EEファイルシステムは，キャラクタ型スペシャルファイル，ブロック型スペシャルファイル，または通常ファイル上に作成できます。

TP1EEファイルシステムをキャラクタ型スペシャルファイル，またはブロック型スペシャルファイル上に作成する場合は，TP1EEファイルシステム用にディスクパーティションを割り当てます。このパーティションは，マウントしないでください。

TP1EEファイルシステムを通常ファイル上に作成する場合は，TP1EEファイルシステム用にディスクパーティションを割り当てる必要はありません。

TP1EEファイルシステムを作成したキャラクタ型スペシャルファイル，ブロック型スペシャルファイル，または通常ファイルを，TP1EEファイルシステム領域といいます。権限を持たないユーザからTP1EEファイルのあるTP1EEファイルシステム領域をアクセスされないようにするために，TP1EEファイルシステム領域の所有者とアクセス権は，次の表に示すように設定します。所有者とアクセス権の設定にはOSのコマンドを使用します。

表5‒1　TP1EEファイルシステム領域の所有者とアクセス権

所有者／アクセス権

TP1EEファイルシステム領域

所有者

ユーザID

OpenTP1管理者

グループID

OpenTP1グループ

アクセス権

所有者

rw（読み書きができる）

グループ

r-（読むことができる）

そのほか

r-（読むことができる）

5.2.5　OpenTP1管理者の環境設定

TP1/EEのコマンドを実行するために，ログイン環境に次の環境変数を設定してください。

DCDIR

DCCONFPATH

DCUAPCONFPATH

PATH

LANG※1

LIBPATH※2

注※1

TP1/EEのメッセージログの言語種別を設定します。詳細については，「6.3.6（4）　出力するメッセージログの言語種別の設定」を参照してください。

注※2

OSがLinuxの場合は，LD_LIBRARY_PATHです。

上記の環境変数の設定内容の詳細については，このマニュアルまたはマニュアル「OpenTP1 運用と操作」の環境設定の説明を参照してください。

5.2.6　TP1EEファイルシステムの初期設定

eefilmkfsコマンドで，キャラクタ型スペシャルファイル，ブロック型スペシャルファイル，または通常ファイルを，TP1EEファイルシステムとして使用できる状態に初期設定します。

5.2.7　TP1EEファイルの作成

eefilmkfsコマンドで初期設定したTP1EEファイルシステム上に，次の表に示すTP1EEファイルを作成，初期設定します。

表5‒2　作成，初期設定するTP1EEファイルと使用する運用コマンド

TP1EEファイル

初期設定する運用コマンド

備考

ステータスファイル

eestsinit

必須

5.2.8　リソースマネジャ連携オブジェクトファイルの作成

TP1/EE下で動作するUAPがトランザクション内でリソースマネジャにアクセスする場合，そのUAPにリソースマネジャ連携オブジェクトファイルをリンケージする必要があります。eetrnmkobjコマンドでリソースマネジャ連携オブジェクトファイルを作成して，UAPにリンケージします。

トランザクション内でリソースマネジャにアクセスしないUAPの場合は，リソースマネジャ連携オブジェクトファイルをリンケージする必要はありません。

TP1/EEを開始する前に，TP1/EE用UAP作成時オブジェクトファイル，リソースマネジャ連携オブジェクトファイル，およびリソースマネジャが提供するXAインタフェース用オブジェクトファイルをUAPにリンケージしてください。

6　運用

この章では，TP1/Server Base Enterprise Optionの運用方法および操作方法について説明します。

6.1　TP1/EEの開始と終了

TP1/EEの開始方法と終了方法について説明します。

6.1.1　TP1/EEの開始

TP1/EEは，TP1/Server BaseのシステムのSPPとして，TP1/EE単位に開始できます。TP1/EEは，TP1/Server Baseがオンライン中でも開始できます。

TP1/EEの開始方法には，次のニつがあります。

TP1/Server Baseのdcstartコマンドを実行してTP1/Server Base開始時に開始する方法

この方法でTP1/EEを開始する場合は，TP1/EEの開始モードは前回の終了モードを引き継ぎます。この方法でTP1/EEを開始するには，TP1/Server Baseのシステムサービス構成定義のuap_confオペランドにYを，また，ユーザサービス構成定義のdcsvstart定義コマンドの-uオプションにTP1/EEのサーバ名を指定しておく必要があります。

TP1/Server Baseの開始方法およびdcstartコマンドの詳細については，マニュアル「OpenTP1 運用と操作」を参照してください。また，TP1/Server Baseの定義については，マニュアル「OpenTP1 システム定義」を参照してください。

TP1/Server Baseの稼働中にeesvstartコマンドを実行して開始する方法

この方法でTP1/EEを開始する場合は，TP1/EEの開始モードは前回の終了モードを引き継ぎます。

TP1/EEの開始モードには次の三つがあります。

正常開始

再開始

強制正常開始

なお，TP1/EEでは，指定した順序に従って初期化トランザクションを起動させることでTP1/EEの起動順序をシリアル化することもできます。TP1/EEの起動順序のシリアル化については，「3.7.5　起動順序のシリアル化機能」を参照してください。

(1)　正常開始

TP1/EEが前回のオンライン処理で正常終了した場合は，TP1/EEは正常開始します。

(2)　再開始

TP1/EEが前回のオンライン処理で正常終了しなかった場合は，TP1/EEは再開始します。再開始時，ステータスファイルの情報を基にトランザクションおよびサービス閉塞の状態を，前回のオンライン処理時の状態に回復します。

(3)　強制正常開始

TP1/EEの前回のオンライン処理の終了状態に関係なくTP1/EEを開始する場合，またはステータスファイルの読み込みエラーのため，前回のオンライン処理時の状態に回復できない場合は，強制的に正常開始します。

6.1.2　TP1/EEの終了

TP1/EEは，TP1/Server BaseのシステムのSPPとして，TP1/EE単位に終了できます。

TP1/EEの終了方法には，次の二つがあります。

TP1/Server Baseのdcstopコマンドを実行してTP1/Server Base終了時に終了する方法

この方法でTP1/EEを終了する場合は，TP1/EEの終了モードはdcstopコマンドのオプションの指定に従います。dcstopコマンドの詳細については，マニュアル「OpenTP1 運用と操作」を参照してください。

TP1/Server Baseの稼働中にeesvstopコマンドを実行して終了する方法

この方法でTP1/EEを終了する場合は，eesvstopコマンドのオプションで終了モードを指定できます。前回のTP1/EEの終了モードを開始時に引き継ぎたい場合は，この方法でTP1/EEを終了してください。

TP1/EEの終了モードには次の四つがあります。

正常終了

計画停止A

計画停止B

強制停止

各終了モードの処理を説明します。

(1)　正常終了

受信スレッドで新しいサービス要求の受け付けを禁止して，処理キュー上の受け付け済みのサービス要求をすべて処理したあとに終了します。

エラートランザクションは，終了処理が完了するまでに起動したものをすべて処理します。タイマトランザクションが登録中で引き出されていない状態の場合は，ERRTRN4が起動します。

eesvstopコマンドにオプションを指定しないで実行すると，TP1/EEは正常終了モードで終了します。この場合，プロセス終了監視トランザクションが起動されます。また，TP1/EEは，DBキューの未読み出しメッセージの監視，およびTP1/EEの終了監視をします。TP1/EEの終了監視では，すべての処理スレッドでトランザクションが起動していないことを監視します。

正常終了モードで終了した場合，次回のTP1/EEの開始モードは正常開始になります。

(2)　計画停止A

受信スレッドで新しいサービス要求の受け付けを禁止して，処理キュー上の受け付け済みのサービス要求をすべて処理したあとに終了します。

エラートランザクションは，終了処理が完了するまでに起動したものをすべて処理します。タイマトランザクションが登録中で引き出されていない状態の場合は，ERRTRN4が起動します。

eesvstopコマンドに-aオプションを指定して実行すると，TP1/EEは計画停止Aモードで終了します。この場合，プロセス終了監視トランザクションが起動され，TP1/EEの終了監視をします。TP1/EEの終了監視では，すべての処理スレッドでトランザクションが起動していないことを監視します。

計画停止Aモードで終了した場合，次回のTP1/EEの開始モードは再開始になります。

(3)　計画停止B

新しいサービス要求の受け付けを禁止して，実行中のサービス要求が完了したあとに終了します。処理キュー上の受け付け済みのサービス要求はすべて破棄します。

eesvstopコマンドに-bオプションを指定して実行すると，TP1/EEは計画停止Bモードで終了します。この場合，TP1/EEは，TP1/EEの終了監視をしません。

計画停止Bモードで終了した場合，次回のTP1/EEの開始モードは再開始になります。

(4)　強制停止

実行中のサービス要求の完了を待たないで終了します。処理キュー上の受け付け済みのサービス要求はすべて破棄します。

eesvstopコマンドに-fオプションを指定して実行すると，TP1/EEは強制停止モードで終了します。

強制停止モードで終了した場合，次回のTP1/EEの開始モードは再開始になります。

6.2　TP1EEファイルの運用

TP1EEファイルシステムおよびTP1EEファイルの運用方法について説明します。

6.2.1　TP1EEファイルシステムの運用

TP1EEファイルシステムとOpenTP1ファイルシステム（TP1/Server Baseで管理するファイルシステム）には，互換性がありません。したがって，TP1EEファイルシステムとOpenTP1ファイルシステムの両方を作成する必要がありますので，注意してください。ここでは，TP1EEファイルシステムの作成方法について説明します。

(1)　TP1EEファイルシステムの作成

OpenTP1管理者は，TP1EEファイルシステムをeefilmkfsコマンドで初期設定します。このとき，TP1EEファイルシステム領域として，キャラクタ型スペシャルファイル，ブロック型スペシャルファイル，または通常ファイルを割り当てます。初期設定は，TP1EEファイルシステム領域を割り当てるときに一度だけ実行します。

TP1EEファイルシステムをキャラクタ型スペシャルファイルまたはブロック型スペシャルファイル上に作成する場合，パーティションの容量より大きな値を指定すると，そのパーティションに物理的に続くパーティションを破壊することがありますので注意してください。TP1EEファイルシステムを通常ファイル上に作成する場合，TP1EEファイルシステムの容量不足が発生しないように，容量を正しく見積もってください。

また，TP1EEファイルは，eestsinitコマンドを使ってTP1EEファイルシステム上に作成します。キャラクタ型スペシャルファイル上のTP1EEファイルシステムに作成したTP1EEファイルの完全パス名の例を次に示します。

TP1EEファイルの作成，運用方法の詳細については，「6.2.2　ステータスファイルの運用」を参照してください。

(2)　TP1EEファイルシステムの状態表示

次のような場合，eefilstatfsコマンドでTP1EEファイルシステムの状態を表示できます。

初期設定時に指定したセクタ長を確認したいとき

TP1EEファイル用の領域の総容量を知りたいとき

TP1EEファイル用の領域の中で，未使用の領域の容量を知りたいとき

すでに作成されたファイルの数や，これから作成できるファイルの数を知りたいとき

表示内容は，ユーザ領域総容量，作成済みファイル数，ファイルシステム初期化時刻などです。

(3)　TP1EEファイルシステムの内容表示

次のような場合，eefillsコマンドでTP1EEファイルシステムの内容を表示できます。

TP1EEファイルシステム中にどのようなTP1EEファイルがあるか確認したいとき

TP1EEファイルの所有者，アクセス権，レコード長，レコード数，および最終更新日時を確認したいとき

TP1EEファイルのロック状態を確認したいとき

eefilchmod（アクセス許可モードの変更）コマンド，eefilchown（所有者の変更）コマンドをすべてのファイル，または複数のファイルに対して実行する前に，TP1EEファイルの情報一覧を出力して確認したいとき

表示内容はアクセス権，所有者名，最終更新日時などです。

eefillsコマンド実行時，最終更新日時が最近のものから表示したり，最終アクセス日時が最近のものから表示したりすることを，オプションで指定できます。

(4)　TP1EEファイルシステムのバックアップとリストア

TP1EEファイルには，TP1/EEのプロセスの回復などに使用する重要な情報が入っています。TP1EEファイルを破壊から守るため，定期的（TP1/EEの開始前など）にeefilbkupコマンドでTP1EEファイルシステムごと，またはTP1EEファイルごとにTP1EEファイルのバックアップを取得しておいてください。バックアップを取得しておけば，TP1EEファイルが破壊された場合でも，eefilrstrコマンドでTP1EEファイルをリストアして回復できます。なお，TP1EEファイル名を指定してリストアすることもできますが，これは主に保守情報を取得するために行います。

TP1EEファイルシステムのバックアップとリストアを次の図に示します。

図6‒1　TP1EEファイルシステムのバックアップとリストア

eefilbkupコマンドを実行すると，レコード長，レコード数，および最終更新日時など個々のTP1EEファイルの属性もバックアップされます。

バックアップ用のファイルには一つのTP1EEファイルシステムだけがバックアップできます。複数のTP1EEファイルシステムをバックアップしたい場合は，バックアップしたいTP1EEファイルシステムごとに別のファイルを指定する必要があります。

(5)　TP1EEファイルシステムの保護

操作の誤りでファイルを破壊することは絶対に避けなければなりません。そして，重要なファイル（オンラインを続行するための制御情報，会社の業務情報など）ほど厳重な保護をしなければなりません。ここでは，TP1EEファイルシステムの保護について説明します。

(a)　TP1EEファイルシステム単位の保護

TP1EEファイルシステム単位にファイルの所有者とアクセス権を管理して，不意な破壊からTP1EEファイルシステムを保護しておきます。ファイルへのアクセス権は，OSのコマンド（例　chmodコマンド）を使って設定します。

ファイル所有者の区別：OpenTP1管理者，OpenTP1グループ

ファイルのアクセス権：読み書きできる，読むことができる

TP1EEファイルシステムの保護（所有者とアクセス権）の例を次の表に示します。

表6‒1　TP1EEファイルシステムの保護（所有者とアクセス権）の例

所有者／アクセス権

設定値

所有者

ユーザID

OpenTP1管理者

グループID

OpenTP1グループ

アクセス権

所有者

rw（読み書きができる）

グループ

r-（読むことができる）

その他

r-（読むことができる）

（凡例）

rw：読み書きできることを示します。

r-：読むことができることを示します。

(b)　TP1EEファイル単位の保護

OpenTP1管理者は，オンライン中にコマンドを使ってTP1EEファイル単位に所有者とアクセス権を動的に変更できます。これによって，オンライン中にTP1EEファイルの使用を特定のユーザに認めたり認めなかったりできます。

TP1EEファイル所有者の変更

OpenTP1管理者は，eefilchownコマンドで，TP1EEファイルの所有者を変更できます。

TP1EEファイルグループの変更

OpenTP1管理者は，eefilchgrpコマンドで，TP1EEファイルのグループを別グループに変更できます。

TP1EEファイルのアクセス許可モードの変更

OpenTP1管理者は，eefilchmodコマンドで，TP1EEファイルのアクセス許可モードを変更できます。

(6)　TP1EEファイルシステムの割り当て

ファイルの種類ごとにディスクを分けてTP1EEファイルシステムを作成すれば，性能や信頼性を向上できます。しかし，ファイルの種類の数だけディスクを用意しなければならないため，コストが高くなります。

一つのディスクにすべてのファイルシステムを作成すれば，コストを低く抑えられます。しかし，ディスクが破壊された場合にすべてのファイルが使えなくなるため，信頼性は良くありません。

ファイルの構成を決めるときに考慮する，代表的な項目を次に示します。

ハードウェア構成上の考慮

キャラクタ型スペシャルファイルまたはブロック型スペシャルファイル上にTP1EEファイルシステムを作成する場合，ディスクの構成が決まっているときには，TP1EEファイルシステムに割り当てることができるパーティション数とその容量を知っておく必要があります。TP1EEファイルシステム作成の際に，誤って大きな容量を指定すると，そのパーティションに物理的に続くパーティションを破壊するおそれがありますので注意してください。

性能上の考慮

アクセスが集中する複数のファイルを一つのディスクに割り当てると，データの入出力時間が掛かり性能が悪くなります。これを防ぐため，アクセスが集中するファイル同士はディスクを分ける必要があります。

最適なファイル構成にするためには，上記の項目などを考慮して性能・信頼性・コスト・操作性などを総合的に判断する必要があります。

(7)　TP1EEファイルシステムのガーベジコレクション

TP1EEファイルの作成と削除を繰り返した場合，キャラクタ型スペシャルファイルまたはブロック型スペシャルファイル上のTP1EEファイルシステム中に十分な空き領域があっても，必要な連続領域が確保できないためにTP1EEファイルが作成できなくなることがあります。この場合，TP1EEファイルシステムのガーベジコレクション（TP1EEファイルシステム中の使用中の領域を集中させ，空き領域を連続させること）が必要になります。通常ファイル上のTP1EEファイルシステムの場合は，必要ありません。

TP1EEファイルシステムのガーベジコレクションを次の図に示します。

図6‒2　TP1EEファイルシステムのガーベジコレクション

TP1EEファイルシステムのガーベジコレクションの手順を次に示します。

TP1EEファイルシステムをeefilbkupコマンドでバックアップします。

バックアップ済みのTP1EEファイルシステムをeefilmkfsコマンドで初期設定します。

eefilrstrコマンドで，バックアップファイルを初期設定済みのTP1EEファイルシステムにリストアします。

(8)　TP1EEファイルシステムの属性変更の手順

容量や最大ファイル数などのTP1EEファイルシステムの属性を変更できます。

TP1EEファイルシステムの属性変更の手順を次に示します。

TP1EEファイルシステムをeefilbkupコマンドでバックアップします。

セクタ長などの属性をeefilmkfsコマンドで変更します。

eefilrstrコマンドで，バックアップファイルを初期設定済みのTP1EEファイルシステムにリストアします。

(9)　TP1EEファイルシステムの再作成

TP1EEファイルシステムを作成する場合，すでにTP1EEファイルシステムが存在していても，コマンドのオプション指定でTP1EEファイルシステムを再作成できます。

TP1EEファイルシステムは，次のコマンドで再作成できます。

eefilrstrコマンド（-t，-o，または-rオプションのどれかを指定した場合）

eestsinitコマンド

TP1EEファイルシステムを再作成する場合，新しいTP1EEファイルシステムが作成されてから，既存のTP1EEファイルシステムが削除されます。このため，一時的にTP1EEファイルシステムを作成するための未使用領域が必要です。未使用領域が不足していると，容量不足となり，TP1EEファイルシステムの再作成に失敗します。再作成に失敗した場合は，既存のTP1EEファイルシステムをeestsrmコマンドで削除したあと，未使用領域を確保し，再度TP1EEファイルシステムを作成してください。

6.2.2　ステータスファイルの運用

ステータスファイルの運用方法について説明します。

(1)　ステータスファイルの作成と定義

物理ファイルの作成

TP1/EEを作成する前に，eestsinitコマンドでステータスファイルをTP1EEファイルシステム上に作成します。A系，B系の二系統のファイルを作成します。

A系，またはB系の物理ファイルは複数のディスクに分散させて作成してください。一つのディスク上に同じ系のすべての物理ファイルを作成すると，ディスクの全面障害が発生した場合，その系は使用できません。

物理ファイルの名称には，ステータスファイル関連定義のステータスファイル名と同じ名称を指定します。

シグナル用ステータスファイルと制御用ステータスファイルは，異なるTP1EEファイルシステム上に作成してください。

制御用ステータスファイルで複数のファイルグループを使用する場合は，グループごとにディスクを分けて作成してください。同じディスクに複数のグループの物理ファイルを作成すると，性能向上が図れません。

また，ステータスファイル関連定義の指定値を変更した場合，ステータスファイルの容量が変更されることがあります。このため，ステータスファイル関連定義を変更した場合は，ステータスファイルの容量を再度見積もってください。

物理ファイルと論理ファイルの対応

作成したステータスファイルの名称と論理ファイルの名称をステータスファイル関連定義で指定します。論理ファイル名は，A系とB系のステータスファイルを一組にするために，ユーザが任意に付ける名称です。

制御用ステータスファイルの場合，A系，B系のステータスファイルのどちらか一方の系だけしか使用できなくなったときに片系運転するかどうかを，ステータスファイル関連定義のsts_single_operation_switchオペランドで指定します。シグナル用ステータスファイルの場合は，正常な系だけで処理を続行します。

(2)　制御用ステータスファイルのスワップ

制御用ステータスファイルで，論理ファイル単位に現用ファイルを切り替えることをスワップと言います。シグナル用ステータスファイルには予備ファイルがないため，スワップしません。A系またはB系のシグナル用ステータスファイルに入出力障害が発生すると，障害ファイルを閉塞し，正常なファイルだけで片系運転をします。

制御用ステータスファイルでスワップが発生するのは次の場合です。

現用ファイルのA系またはB系で障害が発生した場合

スワップコマンド（eestsswapコマンド）を実行した場合

フラグメンテーション発生による連続空きレコードのサイズ不足を検知した場合

スワップが発生すると，スワップ開始の旨のメッセージを出力し，正常な系の制御用ステータスファイルからシステム制御情報を予備の論理ファイルに複写します。複写が終わると，現用と予備を切り替えます。スワップ処理完了時，現用ファイルとなった制御用ステータスファイル名をメッセージに出力します。

スワップ元およびスワップ先のファイルは，同一グループ内のファイルです。複数のグループにわたってスワップすることはできません。

スワップの要因が，eestsswapコマンドの実行以外の場合，スワップ先となる予備の論理ファイルがないときは，TP1/EEはプロセスダウンします。ただし，ステータスファイル関連定義のsts_single_operation_switchオペランドにcontinueを指定した場合は，片系が正常であれば片系運転となります。

制御用ステータスファイル内のシステム制御情報は，スワップすることで制御用ステータスファイルの先頭から再編成されます。TP1/EEの再開始を繰り返すと制御用ステータスファイルにフラグメンテーションが発生することがあります。このため，TP1/EEはフラグメンテーションによる連続空きレコードのサイズ不足を検知した時に，制御用ステータスファイルをスワップしてフラグメンテーションを解消します。

制御用ステータスファイルのスワップを次の図に示します。ステータスファイルに障害が発生した場合の処理については，「11.5.1　ステータスファイルの障害」を参照してください。

図6‒3　制御用ステータスファイルのスワップ

(3)　ステータスファイルの使い方

ステータスファイルは，TP1/EEを構成する各システムサービスの稼働状態，ファイルの状態，各種装置のシステム制御情報などを記録するために使用します。

制御用ステータスファイル，シグナル用ステータスファイルそれぞれのファイルの使い方を次に示します。

(a)　制御用ステータスファイル

TP1/EEは，制御用ステータスファイルをA系とB系の二重で管理し，さらに次に示す状態で管理します。

現用

現時点でシステム制御情報の出力対象になっているオープン中の状態です。ファイルの実体が必要です。

予備

現時点でシステム制御情報の出力対象にはなっていないが，現用のステータスファイルが入出力障害などで使用できなくなったときに，現用のステータスファイルと切り替えるためにオープン中の状態です。ファイルの実体が必要です。

シグナル用ステータスファイルの場合，この状態は存在しません。

無効

ステータスファイル関連定義に指定されているが，オープンしないとオンラインでは使用できないクローズ中の状態です。また，削除されて実体のない状態を，実体なしの無効ファイルといいます。

閉塞

オンライン中に障害が発生し，閉塞しているクローズ中の状態です。

閉塞状態になったステータスファイルは，eestsrmコマンドでファイルの実体を削除し，eestsinitコマンドで初期設定したあと，eestsopenコマンドでオープンすると，予備の状態になります。

オープン中のときは，eestscloseコマンドを実行してクローズ中の状態にしてください。クローズ中の状態にしたステータスファイルは，eestsrmコマンドでファイルの実体を削除し，eestsinitコマンドで初期設定したあと，eestsopenコマンドでオープンすると，予備の状態になります。

オンライン中の制御用ステータスファイルの状態遷移を次の図に示します。

図6‒4　オンライン中の制御用ステータスファイルの状態遷移

ステータスファイルは，ステータスファイル関連定義でA系，B系それぞれ7組まで指定できます。TP1/EEを正常開始すると，ステータスファイル関連定義で最初に指定したステータスファイルが現用となり，残りのステータスファイルのうち，オープンできたものは予備となります。ただし，前回オンラインで使用したステータスファイル（現用ファイル）がある場合は，ステータスファイル関連定義で指定した順番に関係なく前回使用したファイルを現用ファイルとします。障害が発生してオープンできなかったものは閉塞となります。TP1/EEを再開始すると，前回の現用ファイルが引き継がれます。

現用のステータスファイルには，A系とB系で同じ内容が書き込まれます。

TP1/EEは，A系，B系のどちらかの現用のステータスファイルに入出力障害が発生すると，もう一方の系の現用のファイルの内容をA系，B系の予備のファイルに複写し，その後，予備のファイルを現用に切り替えます（スワップ）。ユーザがeestsswapコマンドでスワップすることもできます。

障害が発生してスワップしたステータスファイルは，eestsrmコマンドで削除し，eestsinitコマンドで再作成したあと，eestsopenコマンドでオープンすると，予備のファイルとなります。

eestsrmコマンドで削除できるのは，閉塞・無効状態のファイルです。現用・予備ファイルは削除できません。予備ファイルは，eestscloseコマンドで無効ファイルにしてから削除できます。

eestsinitコマンドで再作成したファイルは，eestsopenコマンドで予備ファイルに登録し，次の障害に備えます。そのとき，片系運転をしていて，現用ファイルが予備に登録したファイルと同じ論理ファイルの場合，登録した予備ファイルは現用ファイルになり，両系運転に戻ります。

予備ファイルがない場合，ステータスファイル関連定義のsts_single_operation_switchオペランドに，片系運転する（continue）と指定していると，正常な系だけで処理を続行します。片系運転しない（stop）と指定していると，TP1/EEは異常終了します。

なお，片系運転で処理を続行しているときに，正常な系に障害が発生したり，ステータスファイルを更新中にTP1/EEが異常終了したりすると，TP1/EEを再開始できなくなります。そのため，できるだけ早く両系運転の状態（A系，B系とも運転している状態）にしてください。両系運転の状態にするには，次の二つの方法があります。

クローズ中の無効ファイルをeestsopenコマンドでオープンし，予備ファイルを用意します。eestsswapコマンドを実行して現用ファイルをスワップします。

障害が発生して閉塞したファイルをeestsrmコマンドで削除し，eestsinitコマンドで再作成したあと，eestsopenコマンドでオープンします。片系運転の場合，eestsopenコマンドを実行すると，障害が発生した系のファイルに正常な系のファイルの内容が複写され，現用ファイルとして回復できます。

また，制御用ステータスファイルは複数のグループに分けることができます。複数のグループをステータスファイル関連定義で指定している場合，そのうちのどれかのグループで処理を続行できない異常が発生すると，TP1/EEは異常終了します。一部の正常なグループだけで処理を続行することはできません。

(b)　シグナル用ステータスファイル

TP1/EEは，シグナル用ステータスファイルをA系とB系の二重で管理し，さらに次に示す状態で管理します。

現用

現時点でシステム制御情報の出力対象になっているオープン中の状態です。ファイルの実体が必要です。

無効

ステータスファイル関連定義に指定されているが，オープンしないとオンラインでは使用できないクローズ中の状態です。また，削除されて実体のない状態を，実体なしの無効ファイルといいます。

閉塞

オンライン中にステータスファイルに障害が発生し，閉塞している状態です。

閉塞状態になったステータスファイルは，eestsrmコマンドでファイルの実体を削除し，eestsinitコマンドで再作成してクローズ中の無効ファイルにしておいて，次回のオンラインに備えます。

オンライン中のシグナル用ステータスファイルの状態遷移を次の図に示します。

図6‒5　オンライン中のシグナル用ステータスファイルの状態遷移

現用のステータスファイルには，A系とB系で同じ内容が書き込まれます。

TP1/EEは，A系，B系のどちらかのシグナル用ステータスファイルに入出力障害が発生すると，正常な系だけで処理を続行します。

なお，片系運転で処理を続行しているときに，正常な系に障害が発生したり，シグナル用ステータスファイルを更新中にTP1/EEが異常終了したりすると，TP1/EEの再開始でシステム制御情報を引き継げなくなります。

(4)　ステータスファイルの状態表示

ステータスファイルの使用状況は，オンライン中の場合，eestslsコマンドで表示できます。表示内容は，論理ファイル状態，物理ファイル状態，レコード長，レコード使用率などです。

(5)　ステータスファイルの内容表示

eestsfillsコマンドを実行すると，ステータスファイルの内容をオフラインでも表示できます。表示内容は，物理ファイル名，初期設定時刻，レコード長，レコード使用率などです。

なお，eestsfillsコマンドに-xオプションを指定すると，ステータスファイルを排他的にオープンして，ファイルの内容を表示できます。

(6)　ステータスファイルのオープンとクローズ

オープンとは，ファイルの実体が現用，または予備の状態のことをいいます。クローズとは，ファイルの実体が無効，または閉塞の状態のことをいいます。

制御用ステータスファイルの場合，クローズ中の無効のステータスファイルをeestsopenコマンドでオープンすると，予備になります。

ただし，現用のステータスファイルが片系運転の場合は，障害が発生して閉塞した系のファイルをeestsrmコマンドで削除し，eestsinitコマンドで初期設定したあと，eestsopenコマンドでオープンすると，現用となります。

予備のステータスファイルをeestscloseコマンドでクローズすると，無効になります。

シグナル用ステータスファイルは，コマンドでオープンまたはクローズすることはできません。

(7)　ステータスファイルの開始／再開始

TP1/EEプロセスの開始／再開始時，ステータスファイル関連定義に指定されたステータスファイルをすべてオープンし，制御用ステータスファイルの各グループで，現用ファイルと予備ファイルを決定し，現用ファイル名をメッセージに出力します。

制御用ステータスファイル

TP1/EE正常開始時，ステータスファイル関連定義で最初に指定したステータスファイルが現用ファイルとなり，残りのステータスファイルは予備ファイルとなります。ただし，前回オンラインで使用したステータスファイル（現用ファイル）がある場合は，ステータスファイル関連定義の順番に関係なく前回使用したファイルを現用ファイルとします。再開始時は，前回の現用ファイルを引き継ぎます。

シグナル用ステータスファイル

現用ファイルをオープンし，現用ファイル名をメッセージに出力します。

(8)　ステータスファイルの終了

TP1/EEプロセス終了時，ステータスファイル関連定義に指定されたステータスファイルをクローズして終了します。

(9)　ステータスファイルの削除

無効，および障害が発生して閉塞状態になったステータスファイルは，eestsrmコマンドで削除できます。現用と予備の状態のステータスファイルは削除できません。

(10)　ステータスファイルの容量が不足したとき

システム開始時にステータスファイルの容量不足が発生した場合，TP1/EEはKFSB51012-Eメッセージを出力して停止します。

(11)　ステータスファイルの状態遷移

オンライン中の制御用ステータスファイルの状態遷移表を表6-2に，オンライン中のシグナル用ステータスファイルの状態遷移表を表6-3に示します。

表6‒2　オンライン中の制御用ステータスファイルの状態遷移表

状態

現用

予備

無効

閉塞

ACTIVE

STANDBY

CLOSE

NONE

BLOCKADE

オープン／クローズ

オープン

クローズ

状態の番号

1

2

3

4

5

イベント

eestsswap実行

→2

→1

−

−

−

eestsclose実行

−

→3

−

−

−

eestsopen実行

−

−

→2

−

−

eestsrm実行

−

−

→4

−

→4

eestsinit実行

−

−

−

→3

−

入出力障害

A系，B系共に障害

→5

−

−

−

−

片系障害

予備ファイルあり

→5

→1

−

−

−

予備ファイルなし

片系運転可

両系運転中

−

−

−

−

−

片系運転中

→5

−

−

−

−

片系運転不可

→5

−

−

−

−

（凡例）

−：起こり得ない，または状態が遷移しないことを示します。

→n：遷移先の状態の番号を示します。

注

すべてのイベントは正常に処理されるものとします。

次に示すクローズ状態のファイルに対してeestsinit，またはeestsrmコマンドを実行しても，eestslsコマンドで表示されるファイル状態は変わりません。

CLOSE

NONE

BLOCKADE

表6‒3　オンライン中のシグナル用ステータスファイルの状態遷移表

状態

現用

無効

閉塞

ACTIVE

CLOSE

NONE

BLOCKADE

オープン／クローズ

オープン

クローズ

状態の番号

1

2

3

4

eestsrm実行

−

→3

−

→3

eestsinit実行

−

−

→2

−

イベント

入出力障害

A系，B系共に障害

→4

−

−

−

片系障害

両系運転中

−

−

−

−

片系運転中

→4

−

−

−

（凡例）

−：起こり得ない，または状態が遷移しないことを示します。

→n：遷移先の状態の番号を示します。

注

すべてのイベントは正常に処理されるものとします。

次に示すクローズ状態のファイルに対してeestsinit，またはeestsrmコマンドを実行しても，eestslsコマンドで表示されるファイル状態は変わりません。

CLOSE

NONE

BLOCKADE

6.3　ファイルの運用

ここでは，ファイルの運用方法について説明します。

TP1/EEが出力するファイルとスレッドの対応を次の表に示します。

表6‒4　TP1/EEが出力するファイルとスレッドの対応

出力するファイル

スレッド

TASKTMファイル

TASKTMスレッド

回線トレースファイル

TASKTMスレッド

UAPトレースファイル

TASKTMスレッド

XDBトレース情報ファイル

XDBトレーススレッド

MCPトレースファイル

PPトレーススレッド

統計情報ファイル

統計情報スレッド

メモリダンプファイル

処理スレッド

XDBトレース情報ファイルの運用については，マニュアル「TP1/Server Base Enterprise Option プログラム作成の手引」を参照してください。

MCPトレースファイルの運用については，マニュアル「TP1/EE/Message Control Extension 使用の手引」を参照してください。

6.3.1　TASKTMファイルの運用

TASKTMファイルは，トランザクションの開始からコミットまたはロールバックまでの間に各スレッドで処理する事象の発生回数や時間を，TASKTM情報として取得します。リソースマネジャにHiRDBを使用する場合は，DB情報も取得します。

処理スレッドでコミットまたはロールバックが複数実行される場合は，トランザクションごとにTASKTM情報を取得します。また，処理スレッド完了時もTASKTM情報を取得します。

TASKTMファイルに取得したTASKTM情報は，eetrbtaskedコマンドを実行して編集し，標準出力，またはCSV形式のファイルとして出力します。また，eetrbtaskdumpコマンドを実行すると，コアファイルまたはメモリダンプファイルを入力情報として，TASKTMファイルの編集結果を標準出力，またはCSV形式のファイルとして出力することもできます。

TASKTMスレッドの異常やI/Oが間延びしてバッファが不足した場合，eetrbtaskedコマンドではTASKTM情報を出力できません。ただし，eetrbtaskfputコマンドを実行すると強制出力できます。

(1)　TASKTMファイルの容量設定

TASKTMファイルは，トラブルシュート関連定義のtrb_tasktm_file_sizeオペランドに指定したサイズで，TP1/EEのプロセスごとにUNIXファイルとして作成されます。プロセスごとに，トラブルシュート関連定義のtrb_tasktm_file_noオペランドで指定した数のTASKTMファイルが作成され，ラウンドロビン方式で使用されます。TASKTMファイルのサイズおよびファイル数は，ノードで稼働するTP1/EEのプロセス数やノードのリソース容量などを考慮して，指定してください。

(a)　見積もりに必要な情報

TASKTMファイルのサイズおよびファイル数を見積もるために必要になる情報を次の表に示します。

表6‒5　TASKTMファイルのサイズおよびファイル数を見積もるために必要になる情報

項目

トラブルシュート関連定義のtrb_tasktm_typeオペランドの指定値

1

2，または3

トランザクション単位のバイト数※1

400

512

1ブロック単位に付加する情報のバイト数

96

1ファイル単位に付加する情報のバイト数

128＋34×（サービス数）＋256※2

注※1

ee_trb_uinfo_tm関数を使用する場合

　trb_tasktm_typeが1：464となります。

　trb_tasktm_typeが2：576となります。

　trb_tasktm_typeが3：560となります。

注※2

トラブルシュート関連定義のtrb_tasktm_typeオペランドの指定値が2で，かつMCPを使用する場合は，次の式になります。

128＋34×（サービス数）＋256＋16×（論理端末数）＋16×（コネクションID数）

また，トラブルシュート関連定義のtrb_tasktm_typeオペランドの指定値が3で，かつMCPとトランザクションレベル方式の処理キュースケジュールを使用する場合は，次の式になります。

128＋34×（サービス数）＋256＋16×（論理端末数）＋16×（コネクションID数）＋34×（トランザクションレベル名の指定数）

なお，トランザクションレベル方式については，TP1/FSPの関連ドキュメントを参照してください。

トランザクション数をx，サービス数をs，トラブルシュート関連定義のtrb_tasktm_buffer_sizeオペランドで指定する値をbとすると，TASKTMファイルに出力する情報の合計は，次に示す式で求める値になります。

trb_tasktm_type=1の場合

TASKTMファイルに出力する情報の合計（T）
  ＝（400×x）＋（↑（（400×x）÷b）↑×96）＋（128＋34×s＋256）

trb_tasktm_type=2の場合

TASKTMファイルに出力する情報の合計（T）
  ＝（512×x）＋（↑（（512×x）÷b）↑×96）＋（128＋34×s＋256）

（凡例）

↑↑：小数点以下を切り上げます。

TASKTMファイルに出力する情報の合計（T）から，TASKTMファイルのサイズおよびファイル数を見積もってください。6時間（21600秒）で指定したファイル数を使い切り，ラウンドロビン方式で最初に作成したファイルの上書きが開始されるように，TASKTMファイルのサイズおよびファイル数を指定することをお勧めします。

(b)　見積もり例

TASKTMファイルの見積もり例を次に示します。

前提条件

1サービス内で実行するコミットまたはロールバックの数は1回

UAPで発行する数は0回で，TP1/EEで発行する数が1回です。

1秒間当たりに稼働するサービス数は100

トランザクション数＝100×1となります。

サービス数は5000

trb_tasktm_buffer_sizeオペランドの指定値は200キロバイト（204800バイト）

trb_tasktm_type=1の場合

T＝400×100×21600
   ＋（↑（（400×100×21600）÷204800）↑×96）
   ＋128＋34×5000＋256
 ＝864575408

（凡例）

↑↑：小数点以下を切り上げます。

TASKTMファイルに出力する情報の合計は，864575408バイト（約0.8ギガバイト）になります。

ファイル数を3にすると，1ファイルに格納する情報は，次のようになります。

1ファイルに格納する情報＝864575408÷3＝288191803

1ファイルに格納する情報は，288191803バイト（約0.27ギガバイト）です。したがって，ファイルサイズは0.3ギガバイトとします。

trb_tasktm_type=2の場合

T＝512×100×21600
   ＋（↑（（512×100×21600）÷204800）↑×96）
   ＋128＋34×5000＋256
 ＝1106608784

（凡例）

↑↑：小数点以下を切り上げます。

TASKTMファイルに出力する情報の合計は，1106608784バイト（約1.0ギガバイト）になります。

ファイル数を3にすると，1ファイルに格納する情報は，次のようになります。

1ファイルに格納する情報＝1106608784÷3＝368869595

1ファイルに格納する情報は，368869595バイト（約0.34ギガバイト）です。したがって，ファイルサイズは0.4ギガバイトとします。

(2)　TASKTMファイルの作成

TASKTMファイルはTP1/EEの起動時，$DCDIR/spool/dceeinf/tasktmディレクトリ下にTP1/EEが作成します。したがって，OpenTP1管理者はTASKTMファイルを作成する必要はありません。TP1/EEが作成するファイル名は，次に示す規則で付けられます。

サービスグループ名tasktmXXX（XXXは，3けたのファイル通番）

(3)　TASKTMファイルの削除

TP1/EEの起動時に，前回のTP1/EE稼働時のTASKTMファイルが存在する場合は，最も古いTASKTMファイルにTASKTM情報を上書きします。したがって，OpenTP1管理者はTASKTMファイルを削除する必要はありません。

(4)　TASKTMファイルの保存

出力中のTASKTMファイルのサイズが，トラブルシュート関連定義のtrb_tasktm_file_sizeオペランドの指定値を超えた場合，出力先が新しいTASKTMファイルに切り替わります。この場合，出力先が新しいTASKTMファイルに切り替わることを通知するKFSB85400-Iメッセージが出力されます。このメッセージが出力されるタイミングで，TASKTMファイルのバックアップを取得して，同一論理ボリューム上でファイル移動（mvコマンド）することをお勧めします。

TASKTMファイル数が，トラブルシュート関連定義のtrb_tasktm_file_noオペランドの指定値を超えた場合，最も古いTASKTMファイルにTASKTM情報を上書きします。古いTASKTMファイルのTASKTM情報を保存したい場合は，TP1/EEが上書きする前に，OpenTP1管理者がバックアップしてください。

使用中のTASKTMファイルをバックアップした場合，編集結果が正しく表示できないことがあります。そのため，TASKTMファイルを切り替えることを通知するメッセージが出力されてから，バックアップを取得してください。また，使用中のTASKTMファイルは，移動または削除しないでください。

(5)　TASKTMファイルに関するシステム定義の関連

TASKTMファイルに関するシステム定義には，ファイルサイズの指定（trb_tasktm_file_sizeオペランド）とバッファサイズの指定（trb_tasktm_buffer_sizeオペランド）があります。

それぞれのオペランドについて，次に示す式を満たすように指定してください。

a＞b

（凡例）

a：trb_tasktm_file_sizeオペランドの指定値

b：ファイル単位に付加する情報のバイト数＋trb_tasktm_buffer_sizeオペランドの指定値

6.3.2　回線トレースファイルの運用

回線トレースファイルは，送受信メッセージや，リソースマネジャ使用時のXAインタフェースなどのデータおよび状態などに関する情報を，回線トレース情報として取得します。通常はイベント発生時の要求ごとに回線トレース情報を取得します。ただし，トランザクション実行中に要求された取得項目は，トランザクション終了時に一括して取得します。

回線トレースファイルに取得した回線トレース情報は，eetrblineedコマンドを実行して編集し，標準出力，またはCSV形式のファイルとして出力します。また，eetrblinedumpコマンドを実行すると，コアファイルまたはメモリダンプファイルを入力情報として，回線トレースファイルの編集結果を標準出力，またはCSV形式のファイルとして出力することもできます。

TASKTMスレッドの異常やI/Oが間延びしてバッファが不足した場合，eetrblineedコマンドでは回線トレース情報を出力できません。ただし，eetrbtrcefputコマンドを実行すると強制出力できます。

(1)　回線トレースファイルの容量設定

回線トレースファイルは，トラブルシュート関連定義のtrb_trace_file_sizeオペランドに指定したサイズで，TP1/EEのプロセスごとにUNIXファイルとして作成されます。プロセスごとに，トラブルシュート関連定義のtrb_trace_file_noオペランドで指定した数の回線トレースファイルが作成され，ラウンドロビン方式で使用されます。回線トレースファイルのサイズおよびファイル数は，ノードで稼働するTP1/EEのプロセス数やノードのリソース容量などを考慮して，指定してください。

(a)　見積もりに必要な情報

トラブルシュート関連定義のtrb_trace_typeオペランドに1を指定した場合に，回線トレースファイルのサイズおよびファイル数を見積もるために必要になる情報を次に示します。

トランザクション単位のバイト数：480

SDBハンドラ機能の個別開始APIの実行回数単位のバイト数：100

SDBハンドラ機能のDBアクセスAPIの実行回数単位のバイト数：108

SDBハンドラ機能の個別終了APIの実行回数単位のバイト数：52

SDBハンドラ機能の一括削除APIの実行回数単位のバイト数：52

SDBハンドラ機能のシステム構成表示のバイト数：52

メッセージ受信単位のバイト数：380

メッセージ送信単位のバイト数：380

1ブロック単位に付加する情報のバイト数：96

1ファイル単位に付加する情報のバイト数：128＋34×（サービス数＋DBキュー機能で使用するDBキュー数＋オンラインバッチ機能で使用するDBキュー数＋オンラインバッチ機能で使用するロット数）＋256

SDBハンドラ機能については，TP1/FSPの関連ドキュメントを参照してください。

回線トレースファイルに出力する情報の合計は次に示す式で求める値になります。

回線トレースファイルに出力する情報の合計（T）
  ＝（480×x）＋（380×y）＋（380×z）＋h＋u
    ＋（↑（（（480×x）＋（380×y）＋（380×z）＋h＋u）÷b）↑×96）
    ＋（128＋34×（s＋d1＋d2＋l）＋256）

（凡例）

↑↑：小数点以下を切り上げます。

x：トランザクション数

y：RPCの受信メッセージ数

z：RPCの送信メッセージ数

h：SDBハンドラ機能を使用する場合に加算する値（TP1/FSPのSDBハンドラ機能の各種API実行回数×ｘ×該当するAPIの実行回数単位のバイト数）。使用しない場合は0を指定する。

u：ee_trb_utrace_put関数×（ee_trb_utrace_put関数で取得するトレースデータのデータ長＋28）バイト

b：バッファサイズ。trb_extend_functionオペランドに00000001を論理和で指定した場合，trb_line_trace_buffer_sizeオペランドの指定値とtrb_line_cmtrace_buffer_sizeオペランドの指定値の小さい方を指定する。trb_extend_functionオペランドを省略または00000000を論理和で指定した場合は，trb_line_trace_buffer_sizeオペランドの指定値を指定する。

s：サービス数

d1：DBキュー機能で使用するDBキュー数

d2：オンラインバッチ機能で使用するDBキュー数

l：オンラインバッチ機能で使用するロット数

回線トレースファイルに出力する情報の合計（T）から，回線トレースファイルのサイズおよびファイル数を見積もってください。6時間（21600秒）で指定したファイル数を使い切り，ラウンドロビン方式で最初に作成したファイルの上書きが開始されるように，回線トレースファイルのサイズおよびファイル数を指定することをお勧めします。

(b)　見積もり例

回線トレースファイルの見積もり例を次に示します。

前提条件

1サービス内で実行するコミットまたはロールバックの数は1回

UAPで発行する数は0回で，TP1/EEで発行する数が1回です。

1メッセージの受信で起動されるトランザクションは1

1トランザクションのRPCのメッセージ送信回数は1

1秒間当たりに稼働するサービス数は100

トランザクション数＝100×1となります。

サービス数は5000

trb_line_trace_buffer_sizeオペランドの指定値は200キロバイト（204800バイト）

1トランザクションで21回の個別開始APIと33回のDBアクセスAPIを発行（SDBハンドラ機能を使用する場合）

SDBハンドラ機能を使用しない場合

T＝（（480×100×21600）＋（380×100×21600）
   ＋（380×100×21600））
   ＋（↑（（（480×100×21600）
   ＋（380×100×21600）
   ＋（380×100×21600））÷204800）↑×96）
   ＋（128＋34×5000＋256）
 ＝2679825968

（凡例）

↑↑：小数点以下を切り上げます。

回線トレースファイルに出力する情報の合計は，2679825968バイト（約2.5ギガバイト）になります。

ファイル数を3ファイルに固定すると，1ファイルに格納する情報は，次のようになります。

1ファイルに格納する情報＝2679825968÷3＝893275323

1ファイルに格納する情報は，893275323バイト（約0.8ギガバイト）です。したがって，ファイルサイズを1ギガバイトとします。

SDBハンドラ機能を使用する場合

T＝（（480×100×21600）＋（380×100×21600）
   ＋（380×100×21600））＋12234240000※
   ＋（↑（（（480×100×21600）
   ＋（380×100×21600）＋（380×100×21600）
   ＋12234240000※）÷204800）↑×96）
   ＋（128＋34×5000＋256）
 ＝14919800720

（凡例）

↑↑：小数点以下を切り上げます。

注※

SDBハンドラ機能を使用する場合の「h」の値は，次の計算式で求められます。

（21×100×100×21600）＋（33×108×100×21600）＝12234240000

回線トレースファイルに出力する情報の合計は，14919800720バイト（約13.9ギガバイト）になります。

ファイル数を3ファイルに固定すると，1ファイルに格納する情報は，次のようになります。

1ファイルに格納する情報＝14919800720÷3＝4973266907

1ファイルに格納する情報は，4973266907バイト（約4.64ギガバイト）になりますが，回線トレースファイルの最大サイズは4000000キロバイト（約3.8ギガバイト）のため，ファイルサイズを固定して計算し直します。

ファイルサイズを2ギガバイトに固定すると，ファイル数は次のようになります。

ファイル数＝14919800720÷（2×1024×1024×1024）≒7

したがって，ファイル数を7ファイルとします。

(2)　回線トレースファイルの作成

回線トレースファイルはTP1/EEの起動時，$DCDIR/spool/dceeinf/trcディレクトリ下にTP1/EEが作成します。したがって，OpenTP1管理者は回線トレースファイルを作成する必要はありません。TP1/EEが作成するファイル名は，次に示す規則で付けられます。

サービスグループ名trcXXX（XXXは，3けたのファイル通番）

(3)　回線トレースファイルの削除

TP1/EEの起動時に，前回のTP1/EE稼働時の回線トレースファイルが存在する場合は，最も古い回線トレースファイルに回線トレース情報を上書きします。したがって，OpenTP1管理者は回線トレースファイルを削除する必要はありません。

(4)　回線トレースファイルの保存

出力中の回線トレースファイルのサイズが，トラブルシュート関連定義のtrb_trace_file_sizeオペランドの指定値を超えた場合，出力先が新しい回線トレースファイルに切り替わります。この場合，出力先が新しい回線トレースファイルに切り替わることを通知するKFSB85400-Iメッセージが出力されます。このメッセージが出力されるタイミングで，回線トレースファイルのバックアップを取得して，同一論理ボリューム上でファイル移動（mvコマンド）することをお勧めします。

回線トレースファイル数が，トラブルシュート関連定義のtrb_trace_file_noオペランドの指定値を超えた場合，最も古い回線トレースファイルに回線トレース情報を上書きします。古い回線トレースファイルの回線トレース情報を保存したい場合はTP1/EEが上書きする前に，OpenTP1管理者がバックアップしてください。

使用中の回線トレースファイルをバックアップした場合，編集結果が正しく表示できないことがあります。そのため，回線トレースファイルを切り替えることを通知するメッセージが出力されてから，バックアップを取得してください。また，使用中の回線トレースファイルは，移動または削除しないでください。

(5)　回線トレース情報の取得量の変更

送受信データごとに回線トレース情報を取得する場合，I/O処理の増加によって性能が低下したり，重要な回線トレース情報が欠落したりすることがあります。これを防止するために，RPC関連定義のrpc_tcp_linetraceオペランドまたはrpc_rap_linetraceオペランドを指定することで，送受信時の回線トレース情報の取得内容を変更できます。

それぞれのオペランドの指定値別に，取得内容および取得サイズの差異について説明します。

(a)　取得内容

メッセージ送受信が正常終了した場合の取得内容を，オペランドの指定値によって変更できます。オペランドの指定値別に，回線トレース情報の取得内容について説明します。

00000000（デフォルト）

すべての回線トレース情報を，送信側と受信側で取得します。

送受信処理が正常に完了した場合は，最大で376バイト取得します。

00000020

送受信データの先頭にある製品ヘッダ（RPCの場合は264バイト，リモートAPI機能の場合は376バイト）を回線トレース情報として取得します。RPCのフラグメントメッセージの場合は，フラグメントごとに製品ヘッダ分だけ取得します。該当するフラグメントで，製品ヘッダ分の回線トレースを取得済みの場合，送受信データの内容は取得しません。

また，送受信データに製品ヘッダがない場合は，送受信データ長を0として回線トレースを取得します。

(b)　取得サイズの差異

回線トレース情報の取得サイズの差異について，次の図に示します。この例では，RPCのメッセージを4回に分けて受信したため，メッセージが四つに分割されています。

図6‒6　回線トレース情報の取得サイズの差異（オペランドの指定値別）

(6)　回線トレースファイルに関するシステム定義の関連

ここでは，回線トレースファイルに関するシステム定義のうち，指定値同士に関連があるものについて説明します。

回線トレースファイルのサイズに関するシステム定義には，次のものがあります。

ファイルサイズの指定（trb_trace_file_sizeオペランド）

バッファサイズの指定（trb_line_trace_buffer_sizeオペランド，およびtrb_line_cmtrace_buffer_sizeオペランド）

一時バッファ領域サイズの指定（trb_line_cmtrace_buf_entry_sizeオペランド）

それぞれのオペランドについて，次に示す式を満たすように指定してください。

a＞b＞c

（凡例）

a：trb_trace_file_sizeオペランドの指定値

b：ファイル単位に付加する情報のバイト数＋バッファサイズ※

c：trb_line_cmtrace_buf_entry_sizeオペランドの指定値

注※

バッファサイズは，trb_extend_functionオペランドに00000001を論理和で指定した場合，trb_line_trace_buffer_sizeオペランドの指定値とtrb_line_cmtrace_buffer_sizeオペランドの指定値の大きい方を加算してください。trb_extend_functionオペランドを省略するか，または00000000を指定した場合は，trb_line_trace_buffer_sizeオペランドの指定値を加算してください。

6.3.3　UAPトレースファイルの運用

UAPトレースファイルは，UAPの障害に備えて，UAPで使用したTP1/EEのライブラリ関数の発行履歴をUAPトレース情報として取得します。UAPトレース情報では，エラーとなったライブラリ関数や取得日時などの，トラブルシュートに関する情報を取得します。UAPトレース情報は，プロセス関連定義のtrb_uap_trace_file_outオペランドを指定した場合に，TP1/EEのライブラリ関数を呼び出す前後で取得されます。

UAPトレースファイルに取得したUAPトレース情報は，eetrbuatedコマンドを実行して編集し，出力します。また，eetrbuapdumpコマンドを実行すると，コアファイルまたはメモリダンプファイルを入力情報として，UAPトレースファイルの編集結果を出力できます。

TASKTMスレッドの異常やI/Oが間延びしてバッファが不足した場合，eetrbuatedコマンドではUAPトレース情報を出力できません。ただし，eetrbuatfputコマンドを実行すると強制出力できます。

(1)　UAPトレースファイルの容量設定

UAPトレースファイルは，トラブルシュート関連定義のtrb_uap_trace_file_sizeオペランドに指定したサイズで，TP1/EEのプロセスごとにUNIXファイルとして作成されます。プロセスごとに，トラブルシュート関連定義のtrb_uap_trace_file_noオペランドで指定した数のUAPトレースファイルが作成され，ラウンドロビン方式で使用されます。UAPトレースファイルのサイズおよびファイル数は，ノードで稼働するTP1/EEのプロセス数やノードのリソース容量などを考慮して，指定してください。

(a)　見積もりに必要な情報

UAPトレースファイルのサイズの見積もり方法を次に示します。

1関数単位のバイト数：280

1ブロック単位に付加する情報のバイト数：96

1ファイル単位に付加する情報のバイト数：128

1サービス内で呼び出す関数の数（サービス関数自身も含む）をx，1秒間当たりのサービス数をv，システム稼働時間（秒）をtとするとUAPトレースファイルに出力する情報の合計は次に示す式で求める値になります。

UAPトレースファイルに出力する情報の合計（T）＝
　　（280×x×v×t）＋（↑（（280×x×v×t）÷200000※）↑×96）＋128

（凡例）

↑↑：小数点以下を切り上げます。

注※

ブロックサイズ（単位：バイト）です。

UAPトレースファイルに出力する情報の合計（T）から，UAPトレースファイルのサイズおよびファイル数を見積もってください。6時間（21600秒）で指定したファイル数を使い切り，ラウンドロビン方式で最初に作成したファイルの上書きが開始されるように，UAPトレースファイルのサイズおよびファイル数を指定することをお勧めします。

(b)　見積もり例

UAPトレースファイルの見積もり例を次に示します。

前提条件

1関数発行単位のバイト数：280

1サービス内で呼び出す関数の数：5回

1秒間当たりのサービス数：100

システム稼働時間：6時間（21,600秒）

T＝280×5×100×21600
   ＋（↑（（280×5×100×21600）÷200×1024）↑×96）＋128＋256
 ＝3025417920

（凡例）

↑↑：小数点以下を切り上げます。

UAPトレースファイルに出力する情報の合計は，3025417920バイト（約2.8ギガバイト）になります。

ファイル数を3ファイルにすると，1ファイルに格納する情報は，次のようになります。

1ファイルに格納する情報＝3025417920÷3＝1008472640

1ファイルに格納する情報は，1008472640（約1.0ギガバイト）です。したがって，ファイルサイズを1ギガバイトとします。

(2)　UAPトレースファイルの作成

UAPトレースファイルはTP1/EEの起動時，$DCDIR/spool/dceeinf/uatディレクトリ下にTP1/EEが作成します。したがって，OpenTP1管理者がUAPトレースファイルを作成する必要はありません。TP1/EEが作成するファイル名は，次に示す規則で付けられます。

サービスグループ名uatXXX（XXXは，3けたのファイル通番）

(3)　UAPトレースファイルの削除

TP1/EEの起動時に，前回のTP1/EE稼働時のUAPトレースファイルが存在する場合は，最も古いUAPトレースファイルにUAPトレース情報を上書きします。したがって，OpenTP1管理者はUAPトレースファイルを削除する必要はありません。

(4)　UAPトレースファイルの保存

出力中のUAPトレースファイルのサイズが，トラブルシュート関連定義のtrb_uap_trace_file_sizeオペランドの指定値を超えた場合，出力先が新しいUAPトレースファイルに切り替わることを通知するKFSB85400-Iメッセージが出力されます。このメッセージが出力されるタイミングで，UAPトレースファイルのバックアップを取得して，同一論理ボリューム上でファイル移動（mvコマンド）することをお勧めします。

UAPトレースファイル数が，トラブルシュート関連定義のtrb_uap_trace_file_noオペランドの指定値を超えた場合，最も古いUAPトレースファイルにUAPトレース情報を上書きします。古いUAPトレースファイルのUAPトレース情報を保存したい場合は，TP1/EEが上書きする前に，OpenTP1管理者がバックアップしてください。

使用中のUAPトレースファイルをバックアップした場合，編集結果が正しく表示できないことがあります。そのため，UAPトレースファイルを切り替えることを通知するメッセージが出力されてから，バックアップを取得してください。また，使用中のUAPトレースファイルは，移動または削除しないでください。

(5)　UAPトレースファイルに関するシステム定義の関連

UAPトレースファイルに関するシステム定義には，ファイルサイズの指定（trb_uap_trace_file_sizeオペランド）とバッファサイズの指定（trb_uap_trace_buffer_sizeオペランド）があります。

それぞれのオペランドについて，次に示す式を満たすように指定してください。

a＞b

（凡例）

a：trb_uap_trace_file_sizeオペランドの指定値

b：ファイル単位に付加する情報のバイト数＋trb_uap_trace_buffer_sizeオペランドの指定値

6.3.4　統計情報ファイルの運用

統計情報ファイルは，TP1/EEシステムの稼働中に発生する事象の発生状況や頻度を，統計情報として取得します。統計情報ファイルでは，処理キューの滞留数や通信遅延時間などを確認できるため，システムの処理遅延や内部の動作を解析できます。また，統計情報ファイルを編集，出力すると，システム稼働状況の把握や，システム構築時の指針の作成に役立ちます。

統計情報ファイルが取得する情報について説明します。

基本統計情報

TP1/EEシステムの起動時またはeetrbstcseコマンドの実行時から，トラブルシュート関連定義のtrb_stc_interval_timeオペランドまたはeetrbstcseコマンドで指定した時間間隔で取得される統計情報です。基本統計情報の種類を次に示します。

システム統計情報（sys）

TP1/EEシステム全体の稼働状況を数値化した情報

処理キュー統計情報（pci）

処理キューに関する統計情報を処理キュー単位にまとめた情報

拡張統計情報

TP1/EEシステムの起動時またはeetrbstceseコマンドの実行時から，イベントが発生したときに取得される統計情報です。拡張統計情報の種類を次に示します。

レスポンス統計情報（ersp）

RPCを実行したときの実行時間に関する情報

通信遅延時間統計情報（edly）

RPCを実行したときの通信遅延時間に関する情報

DBキュー統計情報（edbq）

DBキュー機能に関する統計情報をDBキュー単位にまとめた情報

オンラインバッチ統計情報（eobs）

オンラインバッチ機能に関する統計情報をDBキュー単位およびロット単位にまとめた情報

統計情報を取得する場合は，プロセス関連定義のtrb_stc_useオペランドにYを指定してください。また，統計情報ファイルの最大容量をトラブルシュート関連定義のtrb_stc_file_sizeオペランドで，統計情報ファイルの最大ファイル数をトラブルシュート関連定義のtrb_stc_file_noオペランドで指定してください。

統計情報の取得を開始，終了するタイミングを次に示します。

統計情報の取得の開始

TP1/EEシステムの起動時に開始します。TP1/EEシステムの再開始時に統計情報を取得したい場合は，トラブルシュート関連定義のtrb_stc_basic_kindオペランド（基本統計情報）またはtrb_stc_ext_kindオペランド（拡張統計情報）を指定するか，eetrbstcseコマンド（基本統計情報）またはeetrbstceseコマンド（拡張統計情報）を実行してください。

統計情報の取得の終了

TP1/EEシステムの終了時，またはeetrbstcseコマンド（基本統計情報）またはeetrbstceseコマンド（拡張統計情報）で-rオプションを指定して実行したときに終了します。

統計情報ファイルを利用して稼働状況を調査する場合は，出力対象になっている統計情報ファイルを，eetrbstcfputコマンドを実行してスワップしたあと，eetrbstcedコマンドを実行して編集し，標準出力，またはCSV形式のファイルとして出力します。

統計情報ファイルの作成には，未使用のファイルがある場合はファイル通番の昇順に，未使用のファイルがない場合は更新日時の最も古いファイルから順にラウンドロビン方式でファイルを使用します。

TP1/EEシステムの稼働状況をリアルタイムに標準出力に出力したい場合は，eetrbreportコマンドを実行してください。

(1)　統計情報ファイルの容量設定

統計情報ファイルは，トラブルシュート関連定義のtrb_stc_file_sizeオペランドに指定したサイズで，TP1/EEのプロセスごとにUNIXファイルとして作成されます。プロセスごとに，トラブルシュート関連定義のtrb_stc_file_noオペランドで指定した数の統計情報ファイルが作成され，ラウンドロビン方式で使用されます。統計情報ファイルのサイズおよびファイル数は，ノードで稼働するTP1/EEのプロセス数やノードのリソース容量などを考慮して，指定してください。

(a)　見積もりに必要な情報

統計情報ファイルのサイズおよびファイル数を見積もるために必要になる情報を次に示します。

インタバル取得当たりのシステム統計情報のバイト数：4096

インタバル取得当たりの処理キュー統計情報のバイト数：20×（サービス数）

RPC実行1回当たりのレスポンス統計情報のバイト数：128

DBキューのI/O1回当たりのDBキュー統計情報のバイト数：64

1ブロック単位に付加する情報のバイト数：96

1ファイル単位に付加する情報のバイト数：128＋34×（サービス数＋DBキュー機能で使用するDBキュー数＋オンラインバッチ機能で使用するDBキュー数＋オンラインバッチ機能で使用するロット数）

システム統計情報のインタバル取得回数をx，RPC実行回数をy，DBキューのI/O回数をz，サービス数をs，DBキュー機能で使用するDBキュー数をd1，オンラインバッチ機能で使用するDBキュー数をd2，オンラインバッチ機能で使用するロット数をl，trb_stc_buffer_size定義で指定する値をｂ，TP1/FSPでOBM統計情報を取得する場合に加算する値をh（使用しない場合は0），同時に実行するOBM数をo1，最下位ロットの最大数をo2，OBM統計情報のインタバル取得回数をo3とすると全体の統計情報サイズは次の式となります。

全体の統計情報サイズ（T）
       ＝(4096×x)＋（s×20×x）＋（128×y）＋（64×z）＋h
         ＋（↑（（（4096×x）＋（s×20×x）＋（128×y）＋（64×z）＋h）
         ÷ｂ）↑×96）＋（128＋34×(ｓ＋d1＋d2＋1)＋256）
       ｈ＝（（36＋（96×o2））×o1×o3）

（凡例）

↑↑：小数点以下を切り上げます。

全体の統計情報サイズ（T）から，統計情報ファイルのサイズおよびファイル数を見積もってください。6時間（21600秒）で指定したファイル数を使い切り，ラウンドロビン方式で最初に作成したファイルの上書きが開始されるように，統計情報ファイルのサイズおよびファイル数を指定することをお勧めします。

(b)　見積もり例

統計情報ファイルの見積もり例を次に示します。

前提条件

システム統計情報を取得するインタバルを10分として，6時間で36回取得

トランザクションの頻度を基に，RPCを実行する回数は1秒に50回と仮定して，6時間で1080000回

トランザクションの頻度を基に，DBキューのI/O回数は1秒に50回と仮定して，6時間で1080000回

サービス数は5000

DBキュー機能で使用するDBキューの数は50

オンラインバッチ機能で使用するDBキューの数は0

オンラインバッチ機能で使用するロットの数は0

trb_stc_buffer_size定義で指定する値は200

T＝（4096×36）＋（5000×20×36）＋（128×1080000）＋（64×1080000）
   ＋0
   ＋（↑（（（4096×36）＋（5000×20×36）
          ＋（128×1080000）＋（64×1080000）＋0）
          ÷200000）↑×96）
   ＋（128＋34×（5000＋50＋0＋0）＋256）
 ＝211378516（約202MB）

（凡例）

↑↑：小数点以下を切り上げます。

ファイル数を3ファイルに固定すると，1ファイルに格納する情報は，次のようになります。

ファイルサイズ＝1ファイルに格納する情報＝211378516÷3＝70459506（約68MB）

したがって，ファイルサイズを100メガバイトとします。

TP1/FSPでOBM統計情報を取得する場合，上記の計算式にhを加味してファイルサイズを見積もる必要があります。

TP1/FSPでOBM統計情報を取得する場合に追加する前提条件を次に示します。

前提条件

インタバル時間を1分として，6時間で360回取得

同時に実行するOBM数は100

最下位ロットの最大数は100

OBM統計情報のインタバル取得回数は360回

h＝（（40＋112×100）×100×360）＝404640000
T＝211291060（約220MB）
ファイルサイズ＝615931060÷3＝205310354（約196MB）

したがって，ファイルサイズを200メガバイトとします。

(2)　統計情報ファイルの作成

統計情報ファイルは，TP1/EEの起動時，$DCDIR/spool/dceeinf/stcディレクトリ下にトラブルシュート関連定義のtrb_stc_file_noオペランドで指定したファイル数分，TP1/EEが作成します。したがって，OpenTP1管理者は統計情報ファイルを作成する必要はありません。TP1/EEが作成するファイル名は，次に示す規則で付けられます。

サービスグループ名stcXXX（XXXは，3けたのファイル通番）

(3)　統計情報ファイルの削除

TP1/EEの起動時に，前回のTP1/EE稼働時の統計情報ファイルが存在する場合，最も古い統計情報ファイルに統計情報を上書きします。したがって，OpenTP1管理者は統計情報ファイルを削除する必要はありません。

(4)　統計情報ファイルの保存

出力中の統計情報ファイルのサイズが，トラブルシュート関連定義のtrb_stc_file_sizeオペランドの指定値を超えた場合，出力先が新しい統計情報ファイルに切り替わります。この場合，出力先が新しい統計情報ファイルに切り替わることを通知するKFSB85400-Iメッセージが出力されます。このメッセージが出力されるタイミングで，統計情報ファイルのバックアップを取得（cpコマンド）することをお勧めします。

統計情報ファイル数が，トラブルシュート関連定義のtrb_stc_file_noオペランドの指定値を超えた場合，最も古い統計情報ファイルに統計情報を上書きします。古い統計情報ファイルの統計情報を保存したい場合はTP1/EEが上書きする前に，OpenTP1管理者がバックアップしてください。

使用中の統計情報ファイルをバックアップした場合，編集結果が正しく表示できないことがあります。そのため，統計情報ファイルを切り替えることを通知するメッセージが出力されてから，バックアップを取得してください。また，使用中の統計情報ファイルは，移動または削除しないでください。

(5)　統計情報ファイルに関するシステム定義の関連

統計情報ファイルに関するシステム定義には，ファイルサイズの指定（trb_stc_file_sizeオペランド）とバッファサイズの指定（trb_stc_buffer_sizeオペランド）があります。

それぞれのオペランドについて，次に示す式を満たすように指定してください。

a＞b

（凡例）

a：trb_stc_file_sizeオペランドの指定値

b：ファイル単位に付加する情報のバイト数＋trb_stc_buffer_sizeオペランドの指定値

6.3.5　メモリダンプファイルの運用

メモリダンプファイルは，TP1/EEが出力したメモリの内容を取得します。

(1)　メモリダンプファイルの容量設定

メモリダンプファイルは，トラブルシュート関連定義のtrb_dump_area_kindオペランドの指定値によって決定されたサイズで，TP1/EEのプロセスごとにUNIXファイルとして作成されます。プロセスごとに，トラブルシュート関連定義のtrb_dump_file_noオペランドで指定した数のメモリダンプファイルが作成され，ラウンドロビン方式で使用されます。trb_dump_file_noオペランドは，メモリダンプファイルのファイル数がスレッドダウンの回数および頻度に依存することを考慮して，必要に応じて指定してください。

トラブルシュート関連定義のtrb_dump_area_kindオペランドの指定値が9および13の場合の，メモリダンプファイルのサイズを説明します。

9の場合

eememlsコマンドで表示される次の項目を合計したサイズ

システム領域

ユーザテーブル領域

13の場合

システム領域

ユーザテーブル領域

COBOLワーク領域

XDBワーク領域

XTCワーク領域

大量処理用システム領域

(2)　メモリダンプファイルの作成

メモリダンプファイルは，UAPの異常終了によってスレッドダウンが発生したときに，$DCDIR/spool/dceeinf/dumpディレクトリ下にTP1/EEが作成します。したがって，OpenTP1管理者はメモリダンプファイルを作成する必要はありません。

(3)　メモリダンプファイルの削除

UAPの異常終了によってスレッドダウンが発生した場合にメモリダンプファイルが存在するときは，最も古いメモリダンプファイルにメモリダンプ情報を上書きします。したがって，OpenTP1管理者はメモリダンプファイルを削除する必要はありません。

(4)　メモリダンプファイルの保存

メモリダンプファイル数が，トラブルシュート関連定義のtrb_dump_file_noオペランドの指定値を超えた場合，最も古いメモリダンプファイルにメモリダンプ情報を上書きします。古いメモリダンプファイルのメモリダンプ情報を保存したい場合はTP1/EEが上書きする前に，OpenTP1管理者がバックアップしてください。

6.3.6　メッセージログファイルの運用

メッセージログファイルは，稼働状況管理，障害発生時の切り分けなどをするために，システムの稼働状況を示すメッセージを付加情報付きで取得します。

メッセージログファイルは，メッセージログ関連定義のlog_file_sizeオペランドに指定したサイズで，TP1/EEのプロセス（サービスグループ）ごとにUNIXファイルとして作成されます。プロセスごとに，メッセージログ関連定義のlog_file_maxオペランドで指定した数のメッセージログファイルが作成され，ラウンドロビン方式で使用されます。

メッセージログファイルのサイズおよびファイル数は，ハードディスク容量などのシステム構成を考慮して指定してください。

メッセージログファイルは，テキストファイルです。メッセージログファイル内のメッセージは，テキストエディタなどで参照できます。メッセージログファイルは，先頭の1行がファイルヘッダ情報，2行目以降がメッセージです。ファイルヘッダ情報は，製品形名，TP1/EEのバージョン，ファイル出力日時，サービスグループ名，および定義ファイルパスです。

(1)　メッセージの出力先

メッセージの出力タイミングは，稼働状況の変化，障害発生，コマンド実行，UAPからの出力要求などです。メッセージログは，その種別や出力タイミングによって，メッセージログファイル以外の場所にも出力します。メッセージの出力先を次の表に示します。

表6‒6　メッセージの出力先

出力先

出力するメッセージログ

メッセージログファイル※1

メッセージログファイル出力設定があるTP1/EEのメッセージ，およびUAPのメッセージを出力します。すべてのメッセージを付加情報付きで出力します。

syslog※1

syslog出力設定があるTP1/EEのメッセージ，およびUAPのメッセージを出力します。メッセージログ関連定義のlog_syslog_outオペランドで，出力するメッセージのレベルを指定できます。また，付加情報付きで出力することもできます。

標準出力※2

標準出力の出力設定があるTP1/EEのメッセージを出力します。

標準エラー出力※2

標準エラー出力の出力設定があるTP1/EEのエラーメッセージおよび警告メッセージを出力します。また，障害などが原因で，メッセージログファイルにメッセージを出力できない場合は，該当するメッセージを出力します。

注※1

標準出力，および標準エラー出力に複数行で出力するメッセージ，またはUAPから出力するメッセージテキスト内に改行「¥n」を含んだメッセージは，1行で出力します。

注※2

コマンドが出力するメッセージおよびエラーメッセージを除いて，デフォルト（TP1/Server Baseの設定）では，製品ログファイルとは別のUNIXファイルに出力します。標準出力および標準エラー出力の出力設定があるメッセージは，標準出力および標準エラー出力に出力するかどうかをメッセージログ関連定義のlog_msg_consoleオペランドで指定できます。標準出力および標準エラー出力に出力する場合は，log_msg_consoleオペランドにYを指定します。log_msg_consoleオペランドにYを指定した場合，プロセスID，プロセス内メッセージ通番，出力要求時の日時などの付加情報を出力するかどうかをメッセージログ関連定義で指定できます。

標準出力および標準エラー出力の詳細については，マニュアル「TP1/Server Base Enterprise Option メッセージ」，およびマニュアル「OpenTP1 運用と操作」を参照してください。

作成したUAPからも，メッセージを出力できます。UAPからメッセージの出力要求を受け付けると，TP1/EEのメッセージとして，メッセージログファイルとsyslogに出力します。

ただし，メッセージの出力量が多い場合は，メッセージの出力処理に大量のCPUを消費したり，運用監視をするためにメッセージを収集しているプログラムの処理が遅延したりするおそれがあります。UAPからメッセージを出力する場合は，メッセージを多量に出力しないように設計してください。

(a)　syslog遅延出力

syslogでメモリ不足またはバッファ不足が発生すると，syslogにメッセージを出力できません。TP1/EEでは，syslogに出力できないメッセージをsyslog失敗リストに保管できます（syslog遅延出力）。syslogへのメッセージの出力タイミングとは別のタイミングで，syslog失敗リストからsyslogにメッセージを出力できます。syslog失敗リストを使用して，syslog遅延出力するには，次の条件を満たす必要があります。

OSがLinuxの場合，拡張SYSLOG機能がインストールされている。

メッセージログ関連定義のlog_syslog_outオペランドに1以上，およびメッセージログ関連定義のlog_syslog_elistオペランドに1以上を指定している。

メッセージをsyslog失敗リストに保管するのは，次のどちらかの場合です。

syslog失敗リスト内のメッセージ数が0で，メッセージのsyslogへの出力が，メモリ不足またはバッファ不足で失敗した場合。

syslog失敗リスト内のメッセージ数が1以上で，メッセージログ関連定義のlog_syslog_elistオペランドの指定値未満の場合。

メッセージが，syslog失敗リストのエレメントのメッセージ格納領域長より長い場合は，（超過文字列＋4バイト）の文字列をメッセージ終端から切り捨てます。文字列を切り捨てたメッセージは，文字列の最後に，「(EL)」（4バイトの半角英字記号）を付加します。

syslog失敗リストが取得したメッセージ数がメッセージログ関連定義のlog_syslog_elistオペランドの指定値を超えた場合，標準エラー出力にsyslog出力失敗のメッセージを出力します。

(b)　文字コード変換機能

文字コード変換機能は，拡張SYSLOG機能を利用して，UAPおよびTP1/EEがsyslogに出力するメッセージの文字コードをUTF-8に変換する機能です。次の条件を満たす場合に使用できます。

OSがLinuxである。

拡張SYSLOG機能（02-00以降）をインストールしている。

日立コード変換をインストールしている。

文字コード変換機能の使用は，メッセージログ関連定義のlog_hsyslog_cmodeオペランドで指定します。log_hsyslog_cmodeオペランドにSJISを指定すると，文字コードをシフトJISからUTF-8に変換します。

TP1/EEが出力するシステムメッセージは，環境変数LANGで指定した言語種別がlog_hsyslog_cmodeオペランドに指定した文字コードと一致する場合にだけ，文字コード変換したメッセージをsyslogに出力します。

また，ee_logprint関数（COBOL言語の場合，CBLEELOG('PRINT ')）によってUAPがメッセージを出力する場合，変換前の文字コードに関係なく，出力要求されたすべてのメッセージをlog_hsyslog_cmodeオペランドで指定した文字コードと仮定して，文字コードを変換したメッセージをsyslogへ出力します。そのため，log_hsyslog_cmodeオペランドに指定した文字コードと異なる文字コードを出力要求すると，syslogへの出力で文字化けが発生するおそれがあります。

文字コード変換機能を使用するときの注意事項を次に示します。

変換前の文字コードが定義されていない文字コードの場合，該当する文字を「??」（0x3f3f）で出力します。

拡張SYSLOG機能で出力できるメッセージの最大長は，syslogのヘッダ文字列を含めて1018バイトです。シフトJISからUTF-8に変換すると，文字列長は最大で3倍に増加するため，変換前の文字列長が340バイト以上のメッセージは，変換後に切り捨てられることがあります。

UAPをCOBOL言語で作成し，COBOL言語のSYSLOG出力機能を使用（環境変数CBLSYSLOGにYESを指定）する場合は，メッセージログ関連定義のlog_syslog_elistオペランドに1以上を指定する必要があります。環境変数CBLSYSLOGにYESを指定していて，かつlog_syslog_elistオペランドに0を指定しているときは，KFSB61902-Eメッセージを出力してプロセス起動を終了します。

インストールしている拡張SYSLOG機能が01-02以前の場合，KFSB61901-Eメッセージを出力してプロセス起動を終了します。

日立コード変換がインストールされていない場合や，日立コード変換の初期化に失敗した場合は，文字コード変換機能は無効となります。該当するメッセージは，変換前の文字コードでsyslogに出力します。

文字コード変換の対象となるのは，syslogに出力するメッセージだけです。メッセージログファイル，標準出力，および標準エラー出力には，文字コード変換をしないでメッセージを出力します。

(2)　メッセージログファイルの作成

メッセージログファイルは，TP1/EEの起動時にTP1/EEが作成します。TP1/EEの起動時に，すでにメッセージログファイルが存在する場合は，最も古いファイルから，ファイルの内容を初期化したあとに上書きして再利用します。

メッセージログファイルが取得するメッセージの付加情報は，TASKTM情報と対応させるために取得します。メッセージログファイルが取得する付加情報の詳細については，マニュアル「TP1/Server Base Enterprise Option メッセージ」のメッセージログファイルの付加情報の説明を参照してください。

メッセージログファイルを格納するディレクトリ，およびメッセージログファイルのファイル名を次に示します。

格納ディレクトリ

$DCDIR/spool/dceeinf/log/*

メッセージログファイル名

xx....xxlognnn

xx....xx：サービスグループ名　　〜〈最大31バイトの半角英数字〉

log：メッセージログファイルを示す固定文字列

nnn：メッセージログファイルのID　　〜((001〜010))

(3)　メッセージログファイルの保存

出力中のメッセージログファイルのサイズが，メッセージログ関連定義のlog_file_sizeオペランドに指定した値を超える場合，出力先が新しいメッセージログファイルに切り替わります。この場合，出力先が新しいメッセージログファイルに切り替わったことを通知するKFSB81901-Iメッセージが出力されます。KFSB81901-Iメッセージが出力されるタイミングで，メッセージログのバックアップを取得して，同一論理ボリューム上でファイル移動（mvコマンド）することをお勧めします。

JP1/Baseを使用してTP1/EEのメッセージログファイルを監視する場合は，メッセージログのバックアップを取得するときに，ファイル移動（mvコマンド）ではなく，ファイル複写（cpコマンド）をしてください。ファイル移動をすると，メッセージログファイルがいったん削除されるため，ファイル移動をしたメッセージログファイルはJP1/Baseの監視対象外となります。

(4)　出力するメッセージログの言語種別の設定

メッセージログを英語で出力するか日本語で出力するかを選択できます。出力するメッセージログの言語種別は，TP1/Server Baseのシステム共通定義のputenv形式でLANG変数に設定します。次に示す表に従って，環境変数LANGを設定してください。

表6‒7　メッセージログの言語種別に対する環境変数LANGの設定値

言語種別

Linuxの場合

英語

C

シフトJISコード

−

日本語EUCコード

−

日本語UTF-8コード

ja_JP.UTF-8

環境変数LANGを設定していない場合，またはサポートしていない文字列を環境変数LANGに設定した場合は，メッセージログは英語で出力されます。

6.4　トランザクションに関する運用

トランザクションの運用方法について説明します。

6.4.1　トランザクションの状態表示

トランザクションマネジャが管理するトランザクション，およびリソースマネジャの情報を，eetrnlstrコマンドで表示できます。

表示内容はプロセスID，トランザクション識別子，リソースマネジャ名などです。

また，TP1/EEのeetrnlstrコマンドおよびTP1/Server Baseのtrnlsコマンドを使用してトランザクションの状態を表示すると，TP1/EEとTP1/Server Baseとの間でトランザクション連携しているかどうかを確認できます。

eetrnlstrコマンドおよびtrnlsコマンドを実行して出力される16文字のTRNGID（トランザクショングローバル識別子）が同じ場合，TP1/EEとTP1/Server Baseとの間でトランザクション連携していることを確認できます。

trnlsコマンドの詳細については，マニュアル「OpenTP1 運用と操作」を参照してください。

6.4.2　トランザクションの強制決着

eetrnlstrコマンドで表示したトランザクションの第1状態および第2状態がREADY（p），READY（d）またはREADY（i）となり，その状態が長く続く場合は，グローバルトランザクションを構成している各トランザクションブランチが，何らかの要因（通信障害など）でトランザクションを決着できない状態になったと考えられます。この場合，TP1/EEがリトライしてトランザクションを決着させます。TP1/EEのリトライを待てない場合は，ユーザが運用コマンドを入力して，該当するトランザクションブランチを強制決着（ヒューリスティック決着）できます。ルートトランザクションブランチがコミットしている場合は，eetrncmtコマンドを実行してトランザクションブランチをコミットします。ルートトランザクションブランチがロールバックしている場合は，eetrnrbkコマンドを実行してトランザクションブランチをロールバックします。ルートトランザクションブランチがコミットしているか，ロールバックしているかは，eetrnlstrコマンドでトランザクションの状態を表示して確認してください。

同一グローバルトランザクション内でトランザクションブランチが別計算機上に分散している場合でも，運用コマンドは計算機ごとに入力する必要があります。その場合は，すべてのトランザクションブランチを同一の方法（コミットするか，ロールバックするか）で決着させてください。

eetrncmtコマンドを実行すると，eetrnlstrコマンドで表示したトランザクション第1状態はHEURISTIC_COMMIT状態になります。eetrnrbkコマンドを実行すると，HEURISTIC_ROLLBACK状態になります。その後，eetrncmtコマンド，またはeetrnrbkコマンドによる処理が終了するまでの一時的な経過状態として，HEURISTIC_FORGETTING状態になります。

6.4.3　トランザクションの強制終了

通信障害が発生してトランザクションを強制決着すると，トランザクションブランチ間の連絡が完了するまでトランザクションを終了できません。通信障害が長時間回復する見込みのない場合には，トランザクションを強制終了できます。この場合，-fオプション指定のeetrncmtもしくはeetrnrbkコマンド，またはeetrnfgtコマンドを使用します。

-fオプションを指定したeetrncmt，またはeetrnrbkコマンドを実行すると，eetrnlstrコマンドで表示したトランザクションの状態がREADY（p），READY（d）またはREADY（i）のトランザクションを，強制的にコミット，またはロールバックします。この場合，該当するトランザクションブランチの決着結果を，同一グローバルトランザクション内のほかのトランザクションブランチに通知できないことがあります。そのため，同一グローバルトランザクション内のすべてのトランザクションブランチを，同一の方法で決着できなくなることがあります。

-fオプションを指定しないeetrncmt，またはeetrnrbkコマンドを実行したあと，トランザクションを強制終了したい場合は，eetrnfgtコマンドを使用します。eetrnfgtコマンドを実行すると，eetrnlstrコマンドで表示したトランザクションの第1状態および第2状態がHEURISTIC_FORGETTING（p），HEURISTIC_FORGETTING（d）またはHEURISTIC_FORGETTING（i）のトランザクションを，強制的に終了します。この場合も，該当するトランザクションブランチの決着結果を，同一グローバルトランザクション内のほかのトランザクションブランチに通知できないことがあります。そのため，同一グローバルトランザクション内のすべてのトランザクションブランチを，同一の方法で決着できなくなることがあります。

トランザクションを強制終了すると，リソースマネジャが使用していた資源が解放されるので，ほかのUAPから使用できるようになります。

6.5　コネクションに関する運用

TP1/EEのコネクションには，RPCメッセージ送受信用コネクション，リモートAPI機能で使用する常設コネクション，DBキューイベント通知メッセージ送受信用コネクション，およびTCP/IP共有送信用コネクションがあります。これらの運用方法について説明します。

6.5.1　RPC要求メッセージ送受信用コネクション

RPCメッセージ送受信用コネクションには，RPC要求用とRPC応答用があります。ここでは，RPC要求メッセージ送受信用コネクションについて説明します。

RPC要求メッセージ送受信用コネクションの確立方法には，TP1/EEがサーバとしてコネクション確立要求を受け付ける場合と，TP1/EEがクライアントとしてコネクション確立要求をする場合があります。

ネームサービスを使用する場合は，サービス要求送信時にRPC要求メッセージ送受信用コネクションを使用しないで，RPC応答メッセージ送受信用コネクションを使用します。

(1)　TP1/EEがサーバとしてコネクション確立要求を受信する場合

クライアントは，サービスグループ情報関連定義のmysvgdef定義コマンドの-hオプションで指定したTP1/EEの受信スレッドポートに対してコネクション確立要求をします。

確立したコネクションは，TP1/EEがRPC要求メッセージを受信したあとも解放されないで保持されます。クライアントがCUP以外の場合は，コネクション数が最大コネクション数（サービスグループ情報関連定義のmysvgdef定義コマンドの-sオプションで指定）を超えた時点で，コネクションを解放します。クライアントがCUPの場合は，TP1/EEがRPC要求メッセージを受信したあとに，即座にコネクションを切断します。

(2)　TP1/EEがクライアントとしてコネクション確立要求を送信する場合

TP1/EEは，サービスグループ情報関連定義のeesvgdef定義コマンドの-hオプションで指定したTP1/Server Baseのスケジューラポート，またはTP1/EEの受信スレッドポートに対してコネクション確立要求をします。RPC関連定義のrpc_connect_errmsgオペランドにYを指定した場合は，コネクション確立失敗時にKFSB40322-Eメッセージを出力します。

確立したコネクションは，TP1/EEがRPC要求メッセージを送信したあとも解放されないで保持されます。一つのホスト下で使用できる最大コネクション数は，サービスグループ情報関連定義のeesvgdef定義コマンドの-sオプションで指定します。また，コネクションの確立は，サービスグループ情報関連定義のeesvgdef定義コマンドの-aオプションによってTP1/EE起動時に行うこともできます。

6.5.2　RPC応答メッセージ送受信用コネクション

RPCメッセージ送受信用コネクションには，RPC要求用とRPC応答用があります。ここでは，RPC応答メッセージ送受信用コネクションについて説明します。

RPC応答メッセージ送受信用コネクションの確立方法には，TP1/EEがサーバとしてコネクション確立要求を受け付ける場合と，TP1/EEがクライアントとしてコネクション確立要求をする場合があります。

コネクションの接続先がCUPの場合，または，コネクションの上限値（RPC関連定義のrpc_reply_con_cntオペランド，rpc_reply_con_max_cntオペランド，およびrpc_reply_proc_max_cntオペランドで指定）を超えた場合は，RPC応答メッセージの送信後（TP1/EEがクライアント場合）または受信後（TP1/EEがサーバの場合）に，コネクションを切断します。

ネームサービスを使用する場合は，サービス要求送信時にRPC応答メッセージ送受信用コネクションを使用します。

(1)　TP1/EEがサーバとしてコネクション確立要求を受信する場合

クライアントは，サービスグループ情報関連定義のmyreplydef定義コマンドの-hオプションで指定したTP1/EEの受信スレッドポート，またはRPC関連定義のrpc_reply_port_autoオペランドにYを指定している場合はOS自動割り当てしたポートに対して，コネクション確立要求をします。TP1/EEは，ポートをパッシブオープンしてコネクション確立を受け付けます。確立したコネクションは，TP1/EEがRPC応答メッセージを受信したあとも解放されないで保持されます。

(2)　TP1/EEがクライアントとしてコネクション確立要求を送信する場合

TP1/EEは，RPC応答メッセージもしくはRPC要求メッセージの送信時に，送信先に対するコネクションが存在しない場合，または他スレッドがコネクションを使用している場合，送信先に対してコネクション確立要求をします。RPC関連定義のrpc_connect_errmsgオペランドにYを指定した場合は，コネクション確立失敗時にKFSB40322-Eメッセージを出力します。確立したコネクションは，TP1/EEがRPC応答メッセージを送信したあとも解放されないで保持されます。

6.5.3　リモートAPIのメッセージ送受信用コネクション

rapクライアントとrapサーバは，論理的な通信路である常設コネクションを使用して，リモートAPIのメッセージを送受信します。TP1/EEでは，常設コネクションをOpenTP1が管理します（オートコネクトモード）。

リモートAPIのメッセージ送受信用コネクションの確立方法について説明します。

(1)　TP1/EEがrapクライアントとしてコネクションを確立する場合

リモートAPIを使用するサービスグループに対してee_rpc_call関数を呼び出した場合，該当するサービスグループのrapサーバに対してTP1/EEがTCPコネクション確立要求メッセージを送信してTCPコネクションを確立します。確立したTCPコネクションは，TCPコネクション確立要求メッセージを送信したあとも解放されないで保持されます。

TP1/EEがrapサーバに常設コネクション確立要求メッセージを送信すると，常設コネクションが確立されます。確立した常設コネクションは，TP1/EEがリモートAPI要求メッセージを送信したあとも解放されないで保持されます。確立した常設コネクションは，TP1/EEのオンライン終了時に切断されます。

常設コネクションの数が常設コネクション最大数（RPC関連定義のrpc_rap_connection_countオペランドで指定）を超える場合は，最も古く，かつ使用されていない常設コネクションを解放したあとで，新しく常設コネクションを確立します。

(2)　TP1/EEがrapサーバとしてコネクションを確立する場合

rapクライアントは，RPC関連定義のrap_listen_portオペランドで指定したTP1/EEの受信スレッドポートに対して常設コネクション確立要求をします。TP1/EE（rapサーバ）は，ポートをパッシブオープンして常設コネクション確立を受け付けます。確立した常設コネクションは，TP1/EEがリモートAPI要求メッセージを受信したあとも解放されないで保持されます。確立した常設コネクションは，常設コネクション解放応答メッセージ送信後，またはメッセージの送受信で障害が発生した場合に切断されます。

(3)　rapクライアントマネジャ機能を使用してコネクションを確立する場合

TP1/EE（rapクライアント）は，rapの受信用ポート（RPC関連定義のrap_client_manager_portオペランドで指定）をパッシブオープンしてTCPコネクション確立要求を受け付けます。確立したTCPコネクションは，rapクライアントがrapサーバから起動通知を受信したあとに解放されます。

6.5.4　DBキューイベント通知メッセージ送受信用コネクション

DBキューイベント通知メッセージ送受信用コネクションの確立方法には，TP1/EEがサーバとしてコネクション確立要求を受け付ける場合と，TP1/EEがクライアントとしてコネクション確立要求をする場合があります。

(1)　TP1/EEがサーバとしてコネクション確立要求を受信する場合

クライアントは，サービスグループ情報関連定義のmysvgdef定義コマンドの-hオプションで指定したTP1/EEの受信スレッドポートに対してコネクション確立要求をします。確立したコネクションは，DBキューイベント通知メッセージを受信したあとも解放されないで保持されます。

受け付けたコネクション数が最大コネクション数（サービスグループ情報関連定義のmysvgdef定義コマンドの-sオプションで指定）を超えた場合，TP1/EEは超過したコネクション確立要求を受け付けません。

(2)　TP1/EEがクライアントとしてコネクション確立要求を送信する場合

TP1/EEがクライアントとしてコネクション確立要求を送信する場合，TP1/EEサービス定義でイベント通知メッセージ送信先を指定しておくか，またはDBキュー表でイベント通知メッセージ送信先を管理する必要があります。

(a)　TP1/EEサービス定義でイベント通知メッセージ送信先を指定しておく方法

この方法には，サービスグループ情報関連定義またはDBキュー機能関連定義を使用します。

サービスグループ情報関連定義を使用する場合

TP1/EEは，DBキューイベント通知メッセージの送信時に，サービスグループ情報関連定義のeesvgdef定義コマンドの-hオプションに指定しておいた次に示すどちらかのポートに対して，コネクション確立要求をします。

TP1/EEのDBキュー受信スレッドポート

Cosminexus Reliable Messagingの共用キューを使用して，複数システム間でのアプリケーション連携をする場合のイベント受信用ポート

RPC関連定義のrpc_connect_errmsgオペランドにYを指定した場合は，コネクション確立失敗時にKFSB40322-Eメッセージを出力します。

確立したコネクションは，TP1/EEがDBキューイベント通知メッセージを送信したあとも解放されないで保持されます。一つのホスト下で使用できる最大コネクション数は，サービスグループ情報関連定義のeesvgdef定義コマンドの-sオプションで指定します。また，コネクションの確立は，サービスグループ情報関連定義のeesvgdef定義コマンドの-aオプションによってTP1/EE起動時に行うこともできます。

DBキュー機能関連定義を使用する場合

TP1/EEは，DBキューイベント通知メッセージの送信時に，DBキュー機能関連定義のdbqprcdef定義コマンドの-hオプションに指定しておいた次に示すどちらかのポートに対して，TCP/IP共有送信用コネクションの確立要求をします。

TP1/EEのDBキュー受信スレッドポート

Cosminexus Reliable Messagingの共用キューを使用して，複数システム間でのアプリケーション連携をする場合のイベント受信用ポート

TCP/IP共有送信用コネクションの詳細については，「6.5.5　TCP/IP共有送信用コネクション」を参照してください。

(b)　DBキュー表でイベント通知メッセージ送信先を管理する方法

TP1/EEは，DBキューイベント通知メッセージの送信時に，DBキュー表から取得しておいた次に示すどちらかのポートに対して，TCP/IP共有送信用コネクションの確立要求をします。

TP1/EEのDBキュー受信スレッドポート

Cosminexus Reliable Messagingの共用キューを使用して，複数システム間でのアプリケーション連携をする場合のイベント受信用ポート

TCP/IP共有送信用コネクションの詳細については，「6.5.5　TCP/IP共有送信用コネクション」を参照してください。

DBキュー表でイベント通知メッセージ送信先を管理する方法の詳細については，「6.6.6　DBキュー表によるイベント通知メッセージ送信先の管理」を参照してください。

6.5.5　TCP/IP共有送信用コネクション

TCP/IP上で送信するメッセージが共有して使用するためのコネクションを，TCP/IP共有送信用コネクションといいます。

TCP/IP共有送信用コネクションは，DBキュー機能のシステム間の通信で使用します。

RPC関連定義のrpc_tcpsend_con_max_cntオペランド，rpc_tcpsend_con_cntオペランド，およびrpc_tcpsend_proc_max_cntオペランドを指定することによって，TCP/IP共有送信用コネクション全体のテーブル領域をあらかじめ確保しておきます。確保しておいたテーブル領域のコネクションを，DBキューイベント通知メッセージなどのTCP/IP上で送信するメッセージが共有して使用できます。

TP1/EEは，TCP/IP上でのメッセージの送信時，送信先に対するコネクションが存在しない場合，または，他スレッドがコネクションを使用している場合，送信先に対してコネクション確立要求をします。確立したコネクションは，TP1/EEがメッセージを送信したあとも解放されないで保持されます。保持したコネクションは，TP1/EEの終了時，または，相手システムからのコネクション解放要求の受け付け時に，解放されます。RPC関連定義のrpc_connect_errmsgオペランドにYを指定した場合は，コネクション確立失敗時にKFSB40322-Eメッセージを出力します。

6.5.6　コネクション確立後の時間監視

コネクションの確立後，最初のRPC要求メッセージ，リモートAPI要求メッセージ，またはDBキューイベント通知メッセージを受信するまでの時間を監視します。TP1/EE側で，一定時間を過ぎてもRPC要求メッセージ，リモートAPI要求メッセージ，またはDBキューイベント通知メッセージを受信できなかった場合は，コネクションを切断します。

監視時間内にRPC要求メッセージまたはリモートAPI要求メッセージを受信しなかった場合で，RPC関連定義のrpc_first_connect_errmsgオペランドにYを指定したときは，コネクション切断時にKFSB50310-EメッセージまたはKFSB50380-Eメッセージを出力します。

監視時間内にDBキューイベント通知メッセージを受信しなかった場合で，RPC関連定義のrpc_first_connect_errmsg_dbqオペランドにYを指定したときは，コネクション切断時にKFSB50312-Eメッセージを出力します。

RPC関連定義のrpc_firstmsg_recv_timerオペランドに1以上が指定されている場合は，コネクションを確立したあと，RPC要求メッセージの時間監視をします。監視時間内にメッセージを受信しなかった場合は，該当するコネクションは切断されます。監視時間内にメッセージを受信しなかった場合で，RPC関連定義のrpc_first_connect_errmsgオペランドにYを指定したときは，該当するコネクション切断時にKFSB50310-Eメッセージを出力します。rpc_firstmsg_recv_timerオペランドに0が指定されている場合は，時間監視をしません。

6.5.7　RPCメッセージ用コネクションのチェック機能

コネクションを確立した状態で相手先のマシンがダウンした場合，RSTパケットが送信されないため，自TP1/EEではコネクションの切断を検知できません。このとき，切断されたコネクションを使用してメッセージを送信すると，メッセージの吸い込み（送信元ではメッセージの送信に成功したように見えるものの，実際には送信に失敗している事象）が発生します。

RPCメッセージ用コネクションのチェック機能を使用すると，TP1/Server Baseのネームサーバと連携し，コネクションの確立先のマシンが再起動していないかを確認して，TP1/EEが保持するTCP/IPのコネクションの中から相手マシンのダウンなどで切断されたコネクションを無効にできます。

RPCメッセージ用コネクションのチェック機能は，TP1/Server Baseの起動通知機能（システム共通定義のname_notifyオペランドにYを指定）を使用し，コネクションの確立先プロセスの起動時刻とコネクション確立時刻を比較することで，コネクションが確立されているかどうかを判断します。必要に応じて，TP1/Server Baseのノード監視機能（ネームサービス定義のname_audit_confオペランドに1または2を指定），起動通知機能（システム共通定義のname_notifyオペランドにYを指定），namunavlコマンド，およびnamalivechkコマンドを使用することもできます。

RPCメッセージ用コネクションのチェック機能は，次の条件を満たす場合に使用できます。

RPC関連定義のname_useオペランドにYを指定している。

RPC関連定義のrpc_nam_conn_checkオペランドにYを指定している。

TP1/Server Baseのユーザサービス定義のservice_expiration_timeオペランドに0を指定している。

TP/EEがオンライン中である。

(1)　確立コネクションのチェック方法

RPCメッセージ用コネクションのチェック機能を使用すると，TP1/EEはRPC関連定義のrpc_nam_check_timeオペランドの指定値ごとに起動時刻をチェックします。このときチェックされるのは，RPC関連定義のrpc_nam_check_numオペランドで指定したあて先分の起動時刻です。

取得したコネクションの確立先の起動時刻と，コネクションの確立時刻を比較し，コネクションの確立時刻が起動時刻よりも古い場合は，無効なコネクションと判断してコネクションを切断します。

ただし，最大で次の計算式の時間分，チェックが遅れることがあります。

((↑(コネクション確立先÷rpc_nam_check_numオペランドの指定値)↑)−1)×rpc_nam_check_timeオペランドの指定値

（凡例）

↑↑：小数点以下を切り上げます。

(2)　注意事項

RPCメッセージ用コネクションのチェック機能でコネクションのチェックができるのは，TP1/Server Baseのシステム共通定義のall_nodeオペランド，またはall_node_exオペランドで指定した範囲内との間のコネクションだけです。

6.5.8　通信障害によるメッセージ消失

サーバとのコネクション確立後にサーバを再起動した場合や，通信障害が発生した場合，RPC要求メッセージが通信回線上で消失することがあります。非応答型RPCの場合，メッセージの消失を検知できないため，ユーザによる送達確認の実施が必要になります。

また，TP1/EEを再起動したあとに，再起動前と同じポート番号を使用すると，通信障害が発生してメッセージが通信回線上で消失することがあります。この場合，RPC応答待ちタイムアウトが発生するか，RPC要求先でサービスが実行されない現象が発生します。この現象が発生する頻度を軽減する機能を，ポート番号自動割り当て機能といいます。ポート番号自動割り当て機能を使用すると，TP1/EEを起動するたびに，異なるポート番号を使用します。

ポート番号自動割り当て機能を使用することで回避できる通信障害を次に示します。

TP1/EEとキュー受信型サーバとでRPC通信をする場合

次に示す流れで通信した場合に，3.のキュー受信型サーバのメッセージ送信で発生するおそれのある通信障害です。

TP1/EEとキュー受信型サーバとでRPC通信をします。

TP1/EEを終了して再起動します。

再起動後のTP1/EEとキュー受信型サーバとで再度RPC通信をします。

なお，この通信障害は，TP1/EE同士，またはTP1/EEとソケット受信型とのRPC通信では発生しません。

TP1/EE同士またはTP1/EEとTP1/Server BaseとでRPC通信をする場合

次に示す流れで通信した場合に，3.のTP1/EEまたはTP1/Server Baseのメッセージ送信で発生するおそれのある通信障害です。

TP1/EE同士またはTP1/EEとTP1/Server BaseとでRPC通信をします。

ノードに障害が発生し，ダウンしたノードをTP1/EEを含めて再起動します。

障害が発生していないノードのTP1/EEまたはTP1/Server Baseで，再度RPC通信をします。

ポート番号自動割り当て機能を使用するかどうかは，サービスグループ情報関連定義のmysvgdef定義コマンド，およびRPC関連定義のrpc_reply_port_autoオペランドで指定します。次の表に従って定義を指定してください。

表6‒8　ポート番号自動割り当て機能の指定方法

ポートの種別

定義の指定方法

ポート番号の割り当て方法

RPC要求メッセージ受信用のポート

mysvgdef定義コマンドの-hオプションのポート番号に0以外を指定

mysvgdef定義コマンドの指定値

mysvgdef定義コマンドの-hオプションのポート番号に0を指定

OS自動割り当て

RPC応答メッセージ受信用のポート

rpc_reply_port_autoオペランドの指定を省略するか，Nを指定

サービスグループ情報関連定義のmyreplydef定義コマンドの指定値

rpc_reply_port_autoオペランドにYを指定

OS自動割り当て

定義の指定方法の詳細については，「8.　TP1/EEサービス定義の詳細」を参照してください。

6.5.9　エラー発生時のメッセージの出力抑止

コネクション確立失敗を検知したとき，コネクション切断を検知したとき，未サポートメッセージを受信したときなどにメッセージが出力されます。RPC関連定義を指定することによって，メッセージの出力を抑止できます。

出力を抑止できるメッセージと，抑止するためのRPC関連定義の指定値を次の表に示します。

表6‒9　出力抑止対象メッセージ一覧

メッセージ出力タイミング

出力メッセージ

メッセージの出力を抑止できる

RPC関連定義の指定値

コネクション確立失敗

KFSB40322-E

rpc_connect_errmsgオペランドにNを指定

コネクション切断

KFSB40310-W

rpc_connect_stopmsgオペランドにNを指定

未サポートメッセージ受信

KFSB40313-W

rpc_support_errmsgオペランドにNを指定

RPCサービス受信失敗

KFSB50310-E

rpc_first_connect_errmsgオペランドにNを指定

6.6　DBキュー機能の運用

DBキュー機能の運用方法について説明します。

6.6.1　DBキュー機能オプション

DBキュー機能を使用するためには，DBキュー機能関連定義のdbqgrpdef定義コマンドでDBキューグループ名を定義する際に，それぞれのDBキューグループに対してDBキュー機能オプションを指定する必要があります。DBキュー機能オプションは，dbqgrpdef定義コマンドの-kオプションで指定します。-kオプションに0を指定するとTYPE0が，1を指定するとTYPE1が設定されます。

TYPE0を指定するかTYPE1を指定するかによって，使用できるDBキュー機能の種類が異なります。次に示す表に従って指定するDBキュー機能オプションを決定してください。

表6‒10　DBキュー機能使用時に指定するDBキュー機能オプション

DBキュー機能の種類

DBキュー機能オプション

TYPE0

TYPE1

ユーザキューアクセス

×

○

DBキュー読み出しサーバ変更機能

×

○

DBキュー書き込み抑止機能

×

○

DBキューの上書き抑止

×

○

DBキューの通番の初期化

×

○

DBキュー自動読み出し停止機能

○

○

DBキューメッセージスキップ機能

○

○

DBキュースケジュール状態一括変更機能

×

○

DBキュー書き込み禁止機能

×

○

DBキュー表によるイベント通知メッセージ送信先の管理

×

○

TP1/EEサービス定義によるイベント通知メッセージ送信先の指定

○

×

交替用メッセージ表書き込み機能

×

○

（凡例）

○：使用できます。

×：使用できません。

6.6.2　DBキューの状態遷移（AP間通信）

DBキュー機能を使用してAP間通信する場合のDBキューの状態遷移の流れを次の図に示します。

図6‒7　DBキューの状態遷移（AP間通信）

図の説明を次に示します。説明文中の番号は図中の番号と対応します。

DBキューは，TP1/EE開始時のDBキュー表の構成チェックが正常に完了することで通常状態となります（1）。DBキュー表の構成チェックの結果，DBキュー表の構成に問題がある場合（2）は，DB構成不正による使用不可とし，該当するDBキューに対する状態参照だけできます。状態参照以外の要求は受け付けません。

DBキュー表の構成チェックが完了していない場合，RM未接続による使用不可のままになります。TP1/EE開始時に，リラン時の情報や定義によって，障害による読み出し停止，またはコマンド・関数・定義による読み出し停止になります（3）。

通常状態や障害による読み出し停止，またはコマンド・関数・定義による読み出し停止状態になると，関数受け付け可能状態になり，DBキューに対する要求を受け付け，トランザクションが動作します。DBキューのトランザクション処理でDB障害が発生した場合は，該当するDBキューからのメッセージ読み出しを停止させるため，障害による読み出し停止状態となります（4）。DBキューの内部矛盾を検知した場合は，DBキューの内部矛盾による使用不可とします（5）。また，ユーザが関数によってメッセージの読み出しを停止させることもできます（6）。

障害による読み出し停止，またはコマンド・関数・定義による読み出し停止状態は，コマンド・関数によって読み出し再開要求（7）をすることで解除され，通常状態となります。

なお，DBキューが関数受け付け可能状態になると，DBキューに対する処理要求を受け付けます。処理要求の受け付け後は，DBキューの起動中のトランザクションを管理することで，DBキューのトランザクションが同時に動作しないようにします。管理するトランザクションを次に示します。

メッセージを読み出すトランザクション

メッセージをスキップするトランザクション

通番を初期化するトランザクション

(1)　DBキューとDBキューサービスとの接続

DBキュー機能を使用してAP間通信する場合，DBキューから読み出したメッセージを送信するため，DBキューとDBキューサービスとを，DBキュー機能関連定義のdbqsrvdef定義コマンドによって接続します。TP1/EE起動後に，dbqsrvdef定義コマンドで指定した接続を変更したい場合は，eedbqcnctコマンド，eedbqrelsコマンド，またはee_dbq_conctl関数によって，DBキューとDBキューサービスとを接続したり，接続を解除したりできます。

(2)　TP1/EE開始時のDBキュー表の構成チェック

DBキュー機能を使用してAP間通信する場合，TP1/EE起動時およびリソースマネジャ接続時にDBキュー表の構成をチェックします。DBキュー表の構成に誤りがあった場合，DBキューから読み出しを停止できますが，コマンドまたは関数でDBキューの読み出しの停止解除はできません。

(3)　DBキューの読み出し停止および停止解除

DBキュー機能を使用してAP間通信する場合，eedbqstopコマンドまたはee_dbq_acsctl関数によって，DBキューの読み出しを停止できます。また，DBキュー機能関連定義のdbqdef定義コマンドの-tオプションによって，TP1/EE起動時からDBキューの読み出しを停止できます。DBキューの読み出しを再開したい場合は，eedbqrstコマンドまたはee_dbq_acsctl関数によってDBキューの読み出しの停止を解除します。

(4)　TP1/EE終了時の未読み出しメッセージのチェック

DBキュー機能を使用してAP間通信する場合，TP1/EE正常終了時に未読み出しメッセージがある場合，未読み出しメッセージがなくなるまでTP1/EEを終了しません。未読み出しメッセージのチェック対象となるのは，DBキューサービスと接続している場合の，起動中状態または運用スケジュール停止中状態のDBキューです。

DBキューが読み出しを停止している場合，eedbqrstコマンドによってメッセージの読み出しを再開できます。また，eedbqskipコマンドによって未読み出しメッセージを読み出し済みにできます。全メッセージの読み出しが完了すると，TP1/EEを終了します。

なお，TP1/EEの計画停止時（計画停止Aおよび計画停止B）は，未読み出しメッセージをチェックしません。

6.6.3　DBキューの状態遷移（ユーザキューアクセス）

DBキュー機能を使用してユーザキューアクセスする場合のDBキューの状態遷移の流れを次の図に示します。

図6‒8　DBキューの状態遷移（ユーザキューアクセス）

図の説明を次に示します。説明文中の番号は図中の番号と対応します。

DBキューは，TP1/EE開始時のDBキュー表の構成チェックが正常に完了することで通常状態となります（1）。DBキュー表の構成チェックの結果，DBキュー表の構成に問題がある場合（2）は，DB構成不正による使用不可とし，該当するDBキューに対する状態参照だけできます。状態参照以外の要求は受け付けません。

DBキュー表の構成チェックが完了していない場合，RM未接続による使用不可のままになります。TP1/EE開始時に，リラン時の情報によって，コマンド・関数による読み出し停止になります（3）。

通常状態，またはコマンド・関数による読み出し停止状態になると，関数受け付け可能状態になり，DBキューに対する要求を受け付け，トランザクションが動作します。DBキューのトランザクション処理でDBキューの内部矛盾を検知した場合は，DBキューの内部矛盾による使用不可とします（4）。また，ユーザが関数によってメッセージの読み出しを停止させることもできます（5）。

コマンド・関数による読み出し停止状態は，コマンド・関数によって読み出し再開要求（6）をすることで解除され，通常状態となります。

なお，DBキューが関数受け付け可能状態になると，DBキューに対する処理要求を受け付けます。処理要求の受け付け後は，DBキューの起動中のトランザクションを管理することで，DBキューのトランザクションが同時に動作しないようにします。管理するトランザクションを次に示します。

メッセージを読み出すトランザクション

メッセージをスキップするトランザクション

通番を初期化するトランザクション

(1)　DBキューとDBキューサービスとの接続

DBキュー機能を使用してユーザキューアクセスする場合，DBキューから読み出したメッセージを送信するため，DBキューとDBキューサービスとを，DBキュー機能関連定義のdbqsrvdef定義コマンドによって接続します。TP1/EE起動後に，dbqsrvdef定義コマンドで指定した接続を変更したい場合は，eedbqcnctコマンド，eedbqrelsコマンド，またはee_dbq_conctl関数によって，DBキューとDBキューサービスとを接続したり，接続を解除したりできます。

(2)　TP1/EE開始時のDBキュー表の構成チェック

DBキュー機能を使用してユーザキューアクセスする場合，TP1/EE起動時およびリソースマネジャ接続時にDBキュー表の構成をチェックします。DBキュー表の構成に誤りがあった場合，DBキューから読み出しを停止できますが，コマンドまたは関数でDBキューの読み出しの停止解除はできません。

(3)　DBキューの読み出し停止および停止解除

DBキュー機能を使用してユーザキューアクセスする場合，eedbqstopコマンドまたはee_dbq_acsctl関数によって，DBキューの読み出しを停止できます。DBキューの読み出しを再開したい場合は，eedbqrstコマンドまたはee_dbq_acsctl関数によってDBキューの読み出しの停止を解除します。

(4)　TP1/EE終了時の未読み出しメッセージのチェック

DBキュー機能を使用してユーザキューアクセスする場合，TP1/EE正常終了時に未読み出しメッセージがあるときも，TP1/EEを終了します。

6.6.4　DBキュー表の構成

DBキュー表には次の5種類があります。

ライト管理表

メッセージを書き込んだ通番，通番のラップの有無，および最大書き込み通番を管理します。

リード管理表

メッセージを読み込んだ通番および通番のラップの有無を管理します。

メッセージ管理表

メッセージを管理します。

データ連携支援引き継ぎ情報表

TP1/FSPデータ連携支援の実行をするときに，DBキューに同じデータを書き込まないようにする制御で使用する情報を管理します。データ連携支援書き込み属性を付与したDBキューに作成されます。データ連携支援書き込み属性がないDBキューには作成されません。

交替用メッセージ表

メッセージ表のRDエリア容量不足，RDエリア閉塞などの障害が発生した場合に，業務を継続するためにメッセージを管理する交替用の表です。交替用メッセージ表書き込み機能を使用しない場合は作成されません。

交替用メッセージ表書き込み機能を使用する場合は，メッセージ表とメッセージ表のINDEXを，ほかの表とは別のRDエリアに作成してください。交替用メッセージ表書き込み機能は，メッセージ表のRDエリア容量不足，RDエリア閉塞などの障害時に別のRDエリアに作成した交替用メッセージ表に書き込む機能です。同じRDエリアに作成すると，障害発生時に交替用メッセージ表の書き込みも失敗するため，交替用メッセージ表書き込み機能を使用する意味がありません。各表を作成するRDエリアは，eedbqtblhコマンドのオプションで指定できます。

DBキュー表の命名規則を次の表に示します。

表6‒11　DBキュー表の命名規則

表の種類

表の名称

例（DBキュー名が"DB001"の場合）

ライト管理表

DBキュー名＋WT

DB001WT

リード管理表

DBキュー名＋RD

DB001RD

メッセージ管理表

DBキュー名＋MG

DB001MG

データ連携支援引き継ぎ情報表

DBキュー名＋KS

DB001KS

交替用メッセージ表

DBキュー名+ AM

DB001AM

(1)　HiRDBをリソースマネジャとして使用する場合

HiRDBをリソースマネジャとして使用する場合のDBキュー表の作成方法，表の構成情報，必要となる権限，および注意事項について説明します。

(a)　DBキュー表の作成

DBキュー表は，eedbqtblhコマンドを使用して作成します。

(b)　DBキューが使用する表の構成情報

HiRDB上のRDエリアサイズなどを見積もるための情報を次の表に示します。

表6‒12　DBキューが使用する表の構成情報（HiRDBの場合）

表の種類

表の数

行数

ライト管理表

DBキュー数

1

リード管理表

DBキュー数

1

メッセージ管理表

DBキュー数

DBキューの最大メッセージ数※1

データ連携支援引き継ぎ情報表

データ連携支援書き込み属性を付与したDBキュー数

データ連携支援数※2

交替用メッセージ表

交替用メッセージ表書き込み機能を使用するDBキュー数

DBキューの最大メッセージ数※1

注※1

eedbqtblhコマンドの-cオプション指定値

注※2

データ連携支援ID一つにつき1行

DBキューが使用する表の列属性と列数を次の表に示します。

表6‒13　DBキューが使用する表の列属性と列数（HiRDBの場合）

表の種類

列属性

列数

ライト管理表

INTEGER

2

SMALLINT

1

BINARY※1

1

リード管理表

INTEGER

1

SMALLINT

1

BINARY※1

2

メッセージ表

INTEGER

1

BINARY※2

1

BINARY※3

1

データ連携支援引き継ぎ情報表

CHARCTER(26)

1

CHARCTER(32)

1

INTEGER

2

DECIMAL(19,0)

1

交替用メッセージ表

INTEGER

1

BINARY※2

1

BINARY※3

1

注※1

データの長さは，256バイトです。

注※2

データの長さは，eedbqtblhコマンドの-zオプションの指定値＋4（単位：バイト）です。

注※3

データの長さは，512バイトです。

メッセージ管理表および交替用メッセージ表には，インデクスを使用しています。メッセージ管理表および交替用メッセージ表のインデクスについて次の表に示します。

表6‒14　メッセージ管理表および交替用メッセージ表のインデクス（HiRDBの場合）

種別

DB格納キー長（バイト）

ユニーク

4

(c)　ユーザに必要な権限

TP1/EEがDBキュー表にアクセスする場合は，HiRDBのクライアント環境定義ファイル（環境変数設定ファイル）に設定するユーザ名でDBキュー表にアクセスします。HiRDBのクライアント環境定義ファイルの設定の詳細については，「6.8.2　HiRDB連携時の運用」を参照してください。また，eedbqtblhコマンドでDBキュー表にアクセスする場合は，環境変数PDUSERに設定するユーザ名でDBキュー表にアクセスします。

これらのユーザ名に，次に示す権限を設定する必要があります。

CONNECT

RDAREA

RDエリア名（eedbqtblhコマンドの-bオプションで指定）に対する利用権限，またはeedbqtblhコマンドの-bオプションを省略したときに使用されるRDエリア名に対する利用権限です。

権限の設定方法の詳細については，マニュアル「HiRDB システム運用ガイド」を参照してください。

(d)　HiRDBをリソースマネジャとして使用する場合の注意事項

一度作成した表はTP1/EEで管理するため，変更や更新などをしないでください。ただし，最大メッセージ数などを変更したい場合は，eedbqtblhコマンドで表をいったん削除したあとに再作成することによって変更できます。

HiRDBクライアント環境定義のPDDBLOGオペランドにNO（ログレスモード指定）を指定している場合，DBキューの表全体にHiRDBが排他を取得するため，DBキューの性能が低下します。

DBキューを複数使用する場合，スキーマ構成を統一してください。

一つのHiRDBサーバに，DBキュー機能で使用するDBキュー表と同じ名称のDBキュー表を作成しないでください。DBキュー機能では，クラスタキーの構成チェックをするため，同じ名称のDBキュー表が複数存在する場合，KFSB55600-Eメッセージを出力します。この場合，DBキューを使用できないことがあります。

DBキュー機能のSQL実行時にエラーが発生した場合は，TP1/EEが出力するメッセージとHiRDBが出力するエラーログファイルを参照し，原因を取り除いてください。HiRDBのクライアント環境定義のPDUAPERLOGオペランドで，エラーログファイルのサイズには十分な値を指定してください。十分な値を指定しないと，エラーログファイルを取得できません。

HiRDBのエラーログファイルおよびPDUAPERLOGオペランドの詳細については，マニュアル「HiRDB UAP開発ガイド」の，クライアント環境定義の設定内容およびエラーログ機能に関する記述を参照してください。

DBキュー機能のSQL実行時に複数のエラーが発生した場合，TP1/EEが出力するメッセージ中のSQLCODEには，最後にエラーが発生したSQL実行時のSQLCODEが表示されます。

HiRDBのシステム共通定義のpd_max_access_tablesオペランドには，次に示す計算式で算出した値以上の値を指定してください。

DBキュー機能関連定義のdbqdef定義コマンドの指定数×3

pd_max_access_tablesオペランドに指定した値が上記の計算式で算出した値に満たない場合，次に示す状態になることがあります。

オンライン開始監視トランザクションおよびDBキュータイマトランザクションがロールバックして，DBキュー表の構成チェックに時間が掛かる。

プロセス終了監視トランザクションがロールバックして，TP1/EE終了時の未読み出しメッセージのチェックに時間が掛かる。また，一部のDBキューの未読み出しメッセージをチェックできない。

eedbqlsqgコマンドまたはeedbqlsdqコマンド実行時のコマンドトランザクションがロールバックして，一部のDBキューの状態を表示できない。

eedbqchgrコマンドに-Gオプションまたは-Nオプションを指定して実行したコマンドトランザクションがロールバックして，一部のDBキューの状態を変更できない。

Cosminexus Reliable Messagingの共用キューと接続する場合，TP1/EEのシステム定義，運用コマンド，またはAPI関数で，次に示すとおりにDBキュー名を指定してください。

〈システム名〉_SHR_〈キュー名〉

システム名およびキュー名については，マニュアル「Cosminexus Reliable Messaging」を参照してください。

(2)　Oracleをリソースマネジャとして使用する場合

Oracleをリソースマネジャとして使用する場合のDBキュー表の作成方法，表の構成情報，必要となる権限，および注意事項について説明します。

(a)　DBキュー表の作成

DBキュー表は，eedbqtbloコマンドで作成します。

(b)　DBキューが使用する表の構成情報

Oracle上の表領域の容量などを見積もるための情報を次の表に示します。

表6‒15　DBキューが使用する表の構成情報（Oracleの場合）

表の種類

表の数

行数

ライト管理表

DBキュー数

1

リード管理表

DBキュー数

1

メッセージ管理表

DBキュー数

DBキューの最大メッセージ数（eedbqtbloコマンドの-cオプションの指定値）

DBキューが使用する表の列属性と列数を次の表に示します。

表6‒16　DBキューが使用する表の列属性と列数（Oracleの場合）

表の種類

列属性

列数

ライト管理表

NUMBER(10)

2

NUMBER(5)

1

RAW(256)

1

リード管理表

NUMBER(10)

1

NUMBER(5)

1

RAW(256)

2

メッセージ管理表

NUMBER(10)

1

BLOB※

1

RAW(512)

1

注※

データの長さは，DBキューに書き込むメッセージのメッセージ長＋4（単位：バイト）です。

メッセージ管理表には，インデクスを使用しています。メッセージ管理表のインデクスについて次の表に示します。

表6‒17　メッセージ管理表のインデクス（Oracleの場合）

種別

キーの属性

ユニーク

NUMBER(10)

(c)　ユーザに必要な権限

TP1/EEがDBキュー表にアクセスする場合は，トランザクション関連定義のtrnstring定義コマンドのxa_open関数用文字列に指定するユーザ名でDBキュー表にアクセスします。また，eedbqtbloコマンドでDBキュー表にアクセスする場合は，eedbqtbloコマンドの-uオプションで指定するユーザ名でDBキュー表にアクセスします。

これらのユーザ名に，次に示す権限を設定する必要があります。

システム権限

CREATE SESSION

CREATE TABLE

ALTER SESSION

eedbqtbloコマンドに-Tオプションを指定する場合だけ，必ず設定してください。

オブジェクト権限

SELECT ON DBA_PENDING_TRANSACTIONS

割り当て制限

表領域名（eedbqtbloコマンドの-bオプションで指定）に対する割り当て制限，またはeedbqtbloコマンドの-bオプションを省略するときに使用される表領域名に対する割り当て制限です。

権限の設定方法の詳細については，Oracleのマニュアルを参照してください。

(d)　Oracleをリソースマネジャとして使用する場合の注意事項

一度作成した表はTP1/EEで管理するため，変更や更新などをしないでください。ただし，最大メッセージ数などを変更したい場合は，eedbqtbloコマンドで表をいったん削除したあとに再作成することによって変更できます。

DBキューを複数使用する場合，スキーマ構成を統一してください。

DBキュー機能のSQL実行時にエラーが発生した場合，Oracleのエラー情報は，TP1/EEのメッセージ，または回線トレースファイルに出力されます。出力されたTP1/EEのメッセージ，または回線トレースファイルの編集結果を見て原因を取り除いてください。

次に示すロケール（言語種別）は，同一の言語としてください。DBキュー機能の使用時にTP1/EEが出力するメッセージにはOracleのメッセージが含まれているため，同一の言語が設定されていないとメッセージが正しく出力されないからです。

TP1/EEが動作するOracleのクライアントに対してNLSパラメタで選択するロケール

環境変数LANGに設定する言語種別

OracleのNLSパラメタについては，Oracleのマニュアルを参照してください。

Cosminexus Reliable Messagingの共用キューと接続する場合，TP1/EEのシステム定義，運用コマンド，またはAPI関数で，次に示すとおりにDBキュー名を指定してください。

〈システム名〉_SHR_〈キュー名〉

システム名およびキュー名については，マニュアル「Cosminexus Reliable Messaging」を参照してください。

6.6.5　DBキュー読み出しサーバ変更機能の運用

DBキューからメッセージを読み出すサーバを変更する場合の運用方法について説明します。

(1)　読み出し先DBキューのステータス

読み出し先DBキューのステータスとは，DBキューからメッセージを読み出すサーバを示す情報です。この情報は，DBキュー読み出しサーバを変更する際の判断基準となります。

(a)　読み出し先DBキューのステータスの種類

読み出し先DBキューのステータスには，次の3種類があります。

自サーバ読み出し

自システムのサーバで，DBキューからメッセージを読み出す状態のことです。

他サーバ読み出し

自システム以外のサーバで，DBキューからメッセージを読み出す状態のことです。

なし

DBキューからメッセージを読み出すサーバが存在しない状態のことです。

注意事項

「自サーバ読み出し」と「他サーバ読み出し」のステータスは，相対的な関係にあります。例えば，次に示す図では，読み出しサーバ変更後のDBキューのステータスは，サーバ1側から見た場合は「他サーバ読み出し」となり，サーバ2側から見た場合は「自サーバ読み出し」となります。

(b)　読み出し先DBキューのステータスの変更

読み出し先DBキューのステータスは，次に示すタイミングで「自サーバ読み出し」に変更されます。

DBキュー機能関連定義のdbqgrpdef定義コマンドの-oオプションにmy（自サーバ読み出し）を指定したTP1/EE（読み出しサーバ）が正常開始したとき

eedbqchgrコマンドを実行して読み出しサーバを変更したとき

(2)　TP1/EEの開始モードと読み出し先DBキューのステータスの遷移

TP1/EE（DBキュー読み出しサーバ）の開始モードと，読み出し先DBキューのステータスの遷移を次の表に示します。

表6‒18　TP1/EEの開始モードと読み出し先DBキューのステータスの遷移

項番

TP1/EEの開始モード

dbqgrpdef定義コマンドの-oオプションの指定値

読み出し先DBキューのステータス

サーバ開始前

サーバ開始時

1

正常開始または強制正常開始

my（自サーバ読み出し）

なし

自サーバ読み出し

2

自サーバ読み出し

自サーバ読み出し

3

他サーバ読み出し

（読み出しサーバがTP1/EEの場合）

自サーバ読み出し

4

他サーバ読み出し

（読み出しサーバがTP1/EE以外の場合）

他サーバ読み出し※1

5

other（他サーバ読み出し）

なし

なし

6

自サーバ読み出し

なし

7

他サーバ読み出し

他サーバ読み出し

8

再開始

my（自サーバ読み出し）

なし

なし※2

9

自サーバ読み出し

自サーバ読み出し

10

他サーバ読み出し

他サーバ読み出し

11

other（他サーバ読み出し）

なし

なし

12

自サーバ読み出し

自サーバ読み出し

13

他サーバ読み出し

他サーバ読み出し

注※1

DBキュー読み出しサーバを，TP1/EE以外の製品（Cosminexus Reliable Messagingなど）からTP1/EEに変更することはできません。したがって，正常開始時または強制正常開始時でも，読み出し先DBキューのステータスは変更されません。

注※2

読み出し先DBキューのステータスが「なし」である状態が続くと，DBキューが未読み出しメッセージで満杯になる現象が発生するおそれがあります。この現象を回避するために，DBキュー機能関連定義のdbq_readcheckmsg_intervalオペランドで，DBキュー読み出しサーバが存在しないことを警告するKFSB45612-Wメッセージを出力するように指定してください。

(3)　読み出し先DBキューのステータスの遷移例

読み出し先DBキューのステータスの遷移例について説明します。

(a)　「自サーバ読み出し」のステータスで自サーバが正常終了する場合

「自サーバ読み出し」のステータスで自サーバが正常終了する場合の，読み出し先DBキューのステータスの遷移を次の図に示します。

図6‒9　「自サーバ読み出し」のステータスで自サーバが正常終了する場合

サーバ1を正常開始します。

dbqgrpdef定義コマンドの-oオプションにmyを指定することで，DBキュー1のステータスは「自サーバ読み出し」になります（表6-18の項番1）。

サーバ1でDBキュー1からメッセージを読み出します。

サーバ1を正常終了します。

サーバ1を再度正常開始します。

dbqgrpdef定義コマンドの-oオプションにmyを指定しているため，DBキュー1のステータスは「自サーバ読み出し」のままとなります（表6-18の項番2）。

(b)　eedbqchgrコマンドを実行して読み出しサーバを変更する場合

eedbqchgrコマンドを実行して読み出しサーバを変更する場合の，読み出し先DBキューのステータスの遷移を次の図に示します。

図6‒10　eedbqchgrコマンドを実行して読み出しサーバを変更する場合

サーバ1を正常開始します。

dbqgrpdef定義コマンドの-oオプションにmyを指定することで，DBキュー1のステータスは「自サーバ読み出し」になります（表6-18の項番1）。

サーバ1でDBキュー1からメッセージを読み出します。

サーバ2でeedbqchgrコマンドを実行して，DBキュー読み出しサーバをDBキュー2に変更します。

DBキュー1のステータスは「他サーバ読み出し」（サーバ2側から見た場合は「自サーバ読み出し」）に変更されます。

サーバ1を正常終了します。

サーバ2でDBキュー1からメッセージを読み出します。

サーバ1を再度正常開始します。

dbqgrpdef定義コマンドの-oオプションにmyを指定することで，DBキュー1のステータスは「自サーバ読み出し」に変更されます（表6-18の項番3）。

(c)　「他サーバ読み出し」のステータスで他サーバが正常終了する場合

「他サーバ読み出し」のステータスで他サーバが正常終了する場合の，読み出し先DBキューのステータスの遷移を次の図に示します。

図6‒11　「他サーバ読み出し」のステータスで他サーバが正常終了する場合

サーバ1を正常開始します。

dbqgrpdef定義コマンドの-oオプションにmyを指定することで，DBキュー1のステータスは「自サーバ読み出し」になります（表6-18の項番1）。

サーバ1でDBキュー1からメッセージを読み出します。

サーバ2でeedbqchgrコマンドを実行して，DBキュー読み出しサーバをサーバ2に変更します。

DBキュー1のステータスは「他サーバ読み出し」（サーバ2側から見た場合は「自サーバ読み出し」）に変更されます。

サーバ2でDBキュー1からメッセージを読み出します。

サーバ2を正常終了します。

サーバ1でeedbqchgrコマンドを実行して，DBキュー読み出しサーバを割り当てます。

DBキュー1のステータスは「自サーバ読み出し」に変更されます。

(d)　「自サーバ読み出し」のステータスで，正常開始時に「他サーバ読み出し」を指定する場合

「自サーバ読み出し」のステータスで，正常開始時に「他サーバ読み出し」を指定する場合の，読み出し先DBキューのステータスの遷移を次の図に示します。

図6‒12　「自サーバ読み出し」のステータスで，正常開始時に「他サーバ読み出し」を指定する場合

サーバ2を正常開始します。

サーバ2でdbqgrpdef定義コマンドの-oオプションにmyを指定することで，DBキュー1のステータスは，サーバ1側から見た場合は「他サーバ読み出し」（サーバ2側から見た場合は「自サーバ読み出し」）になります（表6-18の項番1）。

サーバ2でDBキュー1からメッセージを読み出します。

サーバ1でeedbqchgrコマンドを実行して，DBキュー読み出しサーバをサーバ1に変更します。

DBキュー1のステータスは「自サーバ読み出し」に変更されます。

サーバ1でDBキュー1からメッセージを読み出します。

サーバ1を正常終了します。

サーバ1を再度正常開始します。

dbqgrpdef定義コマンドの-oオプションにotherを指定することで，DBキュー1のステータスは「なし」に変更されます（表6-18の項番6）。

サーバ1でeedbqchgrコマンドを実行して，DBキュー読み出しサーバを割り当てます。

DBキュー1のステータスは「自サーバ読み出し」に変更されます。

(e)　DBキューのステータスを変更する前に自サーバが計画停止Bまたはプロセスダウンで終了する場合

DBキューのステータスを変更する前に自サーバが計画停止Bまたはプロセスダウンで終了する場合の，読み出し先DBキューのステータスの遷移を次の図に示します。

図6‒13　DBキューのステータスを変更する前に自サーバが計画停止Bまたはプロセスダウンで終了する場合

サーバ1を正常開始します。

DBキュー1のステータスを変更する前に，サーバ1が計画停止Bまたはプロセスダウンで終了します。

DBキュー1のステータスは「なし」のままとなります。

サーバ1を再開始します。

dbqgrpdef定義コマンドの-oオプションにmyを指定していますが，DBキュー1のステータスは「なし」のままとなります（表6-18の項番8）。

DBキュー1のステータスが「なし」である状態が続いた場合，DBキュー機能関連定義のdbq_readcheckmsg_intervalオペランドに指定した間隔で，KFSB45612-Wメッセージが出力されます。

サーバ1でeedbqchgrコマンドを実行して，DBキュー読み出しサーバを割り当てます。

DBキュー1のステータスは「自サーバ読み出し」に変更されます。

(f)　自サーバが計画停止Bまたはプロセスダウンで終了し，他サーバが正常終了する場合

自サーバが計画停止Bまたはプロセスダウンで終了し，他サーバが正常終了する場合の，読み出し先DBキューのステータスの遷移を次の図に示します。

図6‒14　自サーバが計画停止Bまたはプロセスダウンで終了し，他サーバが正常終了する場合

サーバ2を正常開始します。

サーバ2でdbqgrpdef定義コマンドの-oオプションにmyを指定することで，DBキュー1のステータスは，サーバ1側から見た場合は「他サーバ読み出し」（サーバ2側から見た場合は「自サーバ読み出し」）になります（表6-18の項番1）。

サーバ2でDBキュー1からメッセージを読み出します。

サーバ1が計画停止Bまたはプロセスダウンで終了します。

サーバ2を正常終了します。

サーバ1を再開始します。

dbqgrpdef定義コマンドの-oオプションにmyを指定していますが，DBキュー1のステータスは「他サーバ読み出し」のままとなります（表6-18の項番10）。

サーバ1でeedbqchgrコマンドを実行して，DBキュー読み出しサーバをサーバ1に変更します。

DBキュー1のステータスは「自サーバ読み出し」に変更されます。

(4)　DBキュー読み出しサーバが複数ある場合

DBキューからのメッセージの読み出し処理中にeedbqchgrコマンドを実行すると，二つのサーバが同一のメッセージを読み出すおそれがあります。この現象を回避するために，DBキュー読み出しサーバが複数ある場合，TP1/EEは，最初にコミットしたメッセージ読み出しトランザクションを優先し，その他のサーバのメッセージ読み出しトランザクションをロールバックします。

DBキュー読み出しサーバが複数ある場合の処理の流れを次の図に示します。

図6‒15　DBキュー読み出しサーバが複数ある場合の処理の流れ

サーバ2を正常開始します。

サーバ2でdbqgrpdef定義コマンドの-oオプションにmyを指定しておきます。

サーバ2で，DBキュー1のメッセージ読み出しトランザクションを開始します。

サーバ1でeedbqchgrコマンドを実行して，DBキュー読み出しサーバをサーバ1に変更します。

サーバ1で，DBキュー1のメッセージ読み出しトランザクションを開始します。

サーバ1で，メッセージ読み出しトランザクションがコミットします。

コミット後，未読み出しメッセージがなくなるまでメッセージ読み出しトランザクションを繰り返し起動します。

サーバ2で，メッセージ読み出しトランザクションをロールバックします。

6.6.6　DBキュー表によるイベント通知メッセージ送信先の管理

DBキューへのメッセージ書き込み時に送信されるイベント通知メッセージの送信先に関する情報を，DBキュー表で管理します。イベント通知メッセージの送信には，TCP/IP共有送信用コネクションを使用します。

イベント通知メッセージ送信先の情報は，次に示すどちらかの場合にDBキューに格納されます。

DBキュー機能関連定義のdbqgrpdef定義コマンドの-oオプションにmyを指定して，DBキュー読み出しサーバを正常開始した場合

eedbqchgrコマンドを実行して，DBキュー読み出しサーバを変更した場合

また，DBキュー読み出しサーバが正常終了または計画停止Aで終了した場合，イベント通知メッセージ送信先の情報はDBキューから削除されます。

ここでは，イベント通知メッセージ送信先の情報を管理する流れについて説明します。

TCP/IP共有送信用コネクションの詳細については，「6.5.5　TCP/IP共有送信用コネクション」を参照してください。

(1)　DBキュー読み出しサーバが正常終了または計画停止Aで終了した場合

DBキュー読み出しサーバが正常終了または計画停止Aで終了した場合のイベント通知メッセージ送信先の情報の流れについて，次の図に示します。

図6‒16　DBキュー読み出しサーバが正常終了または計画停止Aで終了した場合のイベント通知メッセージ送信先の情報の流れ

自システムを正常開始します。

自システムでdbqgrpdef定義コマンドの-oオプションにmyを指定しておいたため，正常開始時に，自システム（DBキュー読み出しサーバ）の情報がイベント通知メッセージ送信先の情報としてDBキューに格納されます。

相手システムがDBキューにメッセージを書き込みます。

DBキューに格納されているイベント通知メッセージ送信先の情報を基に，自システムにイベント通知メッセージが送信されます。

自システムでDBキューからメッセージを読み出します。

自システムを正常終了または計画停止Aで終了します。

DBキューに格納されているイベント通知メッセージ送信先の情報が削除されます。

相手システムがDBキューにメッセージを書き込みます。

DBキューにイベント通知メッセージ送信先の情報が格納されていないため，イベント通知メッセージは送信されません。

(2)　DBキュー読み出しサーバが計画停止Bまたはプロセスダウンで終了した場合

DBキュー読み出しサーバが計画停止Bまたはプロセスダウンで終了した場合のイベント通知メッセージ送信先の情報の流れについて，次の図に示します。

図6‒17　DBキュー読み出しサーバが計画停止Bまたはプロセスダウンで終了した場合のイベント通知メッセージ送信先の情報の流れ

自システムを正常開始します。

自システムでdbqgrpdef定義コマンドの-oオプションにmyを指定しておいたため，正常開始時に，自システム（DBキュー読み出しサーバ）の情報がイベント通知メッセージ送信先の情報としてDBキューに格納されます。

相手システムがDBキューにメッセージを書き込みます。

DBキューに格納されているイベント通知メッセージ送信先の情報を基に，自システムにイベント通知メッセージが送信されます。

自システムでDBキューからメッセージを読み出します。

自システムを計画停止Bまたはプロセスダウンで終了します。

計画停止Bまたはプロセスダウンで終了した場合は，DBキューに格納されているイベント通知メッセージ送信先の情報が削除されないで残ります。

相手システムがDBキューにメッセージを書き込みます。

DBキューに格納されているイベント通知メッセージ送信先の情報を基に，自システムにイベント通知メッセージが送信されます。しかし，自システムは未起動のため，イベント通知メッセージの送信処理でエラーが発生し，KFSB45642-Wメッセージが出力されます。

6.6.7　連鎖モードのコミットの同期点決着

DBキュー機能を使用したAP間通信とユーザキューアクセスでは，連鎖モードのコミットでの同期点処理が異なります。

次の図に示すメッセージの読み出し例で，DBキュー機能を使用したAP間通信と，ユーザキューアクセスが混在する場合の同期点処理について説明します。

図6‒18　メッセージの読み出し例

DBキュー機能を使用したAP間通信と，ユーザキューアクセスが混在する場合，図中のメッセージ1，メッセージ3は，UAPのリターンのタイミングで同期点処理されます。しかし，メッセージ2は，連鎖モードのコミットのタイミングで同期点処理されます。

6.6.8　TP1/EEのバージョン混在時の注意事項

dbqgrpdef定義コマンドの-kオプションに1を指定している複数のTP1/EEが，同じDBキューにアクセスする場合，TP1/EEのバージョンが07-80より前と07-80以降で混在していると，次に示す制限があるため注意してください。

DBキューからメッセージを読み出すTP1/EEのバージョンが07-80以降である場合，eedbqchgrコマンドを使用してDBキューからメッセージを読み出すTP1/EEを07-80よりも前のバージョンに変更しないでください。変更した場合の動作は保証しません。

DBキューからメッセージを読み出すTP1/EEのバージョンが07-80より前である場合，ほかのTP1/EEからeedbqrstコマンド，eedbqstopコマンド，またはee_dbq_acsctl関数を実行してもDBキューの読み出し停止や再開はできません。DBキューからメッセージを読み出しているTP1/EEでコマンドを実行するか，または関数を発行してください。

TP1/EEのバージョンが07-80より前である場合，eedbqtblhコマンドの-aオプションに0以外を指定したDBキューを使用しないでください。使用した場合の動作は保証しません。

6.7　オンラインバッチ機能の運用

データ型オンラインバッチ処理の場合に使用するオンラインバッチDBキュー表の運用方法について説明します。なお，オンラインバッチDBキュー表の作成方法については，Justware for OLTPのドキュメントを参照してください。

オンラインバッチDBキュー表には次の3種類があります。

ライト管理表

メッセージを書き込んだ通番，および最大書き込み通番を管理します。

リード管理表

メッセージを読み込んだ通番を管理します。

メッセージ管理表

メッセージを管理します。

オンラインバッチDBキュー表の命名規則を次の表に示します。

表6‒19　オンラインバッチDBキュー表の命名規則

表の種類

表の名称

例（DBキュー名が"DB001"の場合）

ライト管理表

DBキュー名＋WT

DB001WT

リード管理表

DBキュー名＋RD

DB001RD

メッセージ管理表

DBキュー名＋MG

DB001MG

6.7.1　HiRDBをリソースマネジャとして使用する場合

HiRDBをリソースマネジャとして使用する場合のオンラインバッチDBキュー表の作成方法，必要となる権限，および注意事項について説明します。

(1)　オンラインバッチDBキュー表の作成

オンラインバッチDBキュー表の作成前に必要なRDエリアの作成については，マニュアル「HiRDB コマンドリファレンス」を参照してください。

オンラインバッチDBキュー表は，HiRDBのpddefコマンドで作成します。pddefコマンドでオンラインバッチDBキュー表を作成するために，TP1/EEでは次に示すサンプルファイルを提供しています。必要に応じて下線部分の設定値を変更してください。

CREATE FIX TABLE DBQ004WT
  (
  LOTWKEY             CHAR(28) NOT NULL,
  WC#                   INTEGER NOT NULL)
IN DBQ001USER PCTFREE=(10,0);

CREATE FIX TABLE DBQ004RD
  (
  LOTRKEY              CHAR(28) NOT NULL,
  RM#                   INTEGER NOT NULL,
  RS#                     INTEGER NOT NULL,
PRIMARY CLUSTER KEY
  (
  LOTRKEY            ASC))
IN DBQ001USER PCTFREE=(10,0);

CREATE TABLE DBQ004MG
  (
  LOTNAME             CHAR(24) NOT NULL,
  MSG#                  INTEGER  NOT NULL,
  MSG                   BINARY(100) NOT NULL)
IN DBQ001USER PCTFREE=(10,0)
PRIMARY CLUSTER KEY(LOTNAME ASC,MSG# ASC);

下線部分の設定値について説明します。

DBQ004

DBキュー名を指定してください。

DBQ001USER

RDエリア名を指定してください。

BINARY(100)

メッセージ長（単位：バイト）を，括弧の中に指定してください。

(2)　ユーザに必要な権限

TP1/EEは，HiRDBのクライアント環境定義ファイル（環境変数設定ファイル）に設定するユーザ名で，オンラインバッチDBキュー表にアクセスします。HiRDBのクライアント環境定義ファイルの設定の詳細については，「6.8.2　HiRDB連携時の運用」を参照してください。

HiRDBのクライアント環境定義ファイル（環境変数設定ファイル）に設定するユーザ名には，次に示す権限を設定する必要があります。

CONNECT

RDAREA

オンラインバッチDBキュー表を作成するRDエリア名に対する利用権限です。

権限の設定方法の詳細については，マニュアル「HiRDB UAP開発ガイド」を参照してください。

(3)　HiRDBをリソースマネジャとして使用する場合の注意事項

一度作成したライト管理表およびリード管理表は，TP1/EEで管理するため，変更や更新などをしないでください。

HiRDBクライアント環境定義のPDDBLOGオペランドにNO（ログレスモード指定）を指定している場合，DBキューの表全体にHiRDBが排他を取得するため，DBキューの性能が低下します。

DBキューを複数使用する場合，スキーマ構成を統一してください。

一つのHiRDBサーバに，同じ名称のオンラインバッチDBキュー表を複数作成することはできません。オンラインバッチ機能では，クラスタキーの構成チェックをするため，同じ名称のオンラインバッチDBキュー表が複数存在する場合，KFSB55670-Eメッセージを出力します。この場合，オンラインバッチ処理を開始できないことがあります。

オンラインバッチ機能のSQL実行時にエラーが発生した場合は，TP1/EEが出力するメッセージとHiRDBが出力するエラーログファイルを参照し，原因を取り除いてください。HiRDBのクライアント環境定義のPDUAPERLOGオペランドで，エラーログファイルのサイズには十分な値を指定してください。十分な値を指定しないと，エラーログファイルを取得できません。

HiRDBのエラーログファイルおよびPDUAPERLOGオペランドの詳細については，マニュアル「HiRDB UAP開発ガイド」の，クライアント環境定義の設定内容およびエラーログ機能に関する記述を参照してください。

オンラインバッチ機能のSQL実行時に複数のエラーが発生した場合，TP1/EEが出力するメッセージ中のSQLCODEには，最後にエラーが発生したSQL実行時のSQLCODEが表示されます。

HiRDBのシステム共通定義のpd_max_access_tablesオペランドには，次に示す計算式で算出した値以上の値を指定してください。

（DBキュー機能関連定義のdbqdef定義コマンドの指定数＋DBキュー機能関連定義のdbqobsdef定義コマンドの指定数）×3

pd_max_access_tablesオペランドに指定した値が上記の計算式で算出した値に満たない場合，TP1/EEの再開始時にオンライン開始監視トランザクションがロールバックし，一部の起動中ロットの状態の回復処理に失敗した結果，トランザクション処理状態が中断中となるおそれがあります。

6.7.2　Oracleをリソースマネジャとして使用する場合

Oracleをリソースマネジャとして使用する場合のオンラインバッチDBキュー表の作成方法，必要となる権限，および注意事項について説明します。

(1)　オンラインバッチDBキュー表の作成

オンラインバッチDBキュー表は，OracleのSQLで作成します。OracleのSQLでオンラインバッチDBキュー表を作成するために，TP1/EEでは次に示すサンプルファイルを提供しています。必要に応じて下線部分の設定値を変更してください。

CREATE TABLE DBQ004WT
  (
  LOTWKEY             CHAR(28) NOT NULL,
  WC#                   NUMBER(10) NOT NULL)
TABLESPACE DBQ001USER PCTFREE 10;

CREATE TABLE DBQ004RD
  (
  LOTRKEY              CHAR(28) NOT NULL,
  RM#                    NUMBER(10) NOT NULL,
  RS#                     NUMBER(10) NOT NULL,
PRIMARY KEY (LOTRKEY)
)
TABLESPACE DBQ001USER PCTFREE 10;

CREATE TABLE DBQ004MG
  (
  LOTNAME             CHAR(24) NOT NULL,
  MSG#                  NUMBER(10) NOT NULL,
  MSG                   BLOB NOT NULL,
  PRIMARY KEY(LOTNAME,MSG#)
)
TABLESPACE DBQ001USER PCTFREE 10;

下線部分の設定値について説明します。

DBQ004

DBキュー名を指定してください。

DBQ001USER

表領域名を指定してください。

(2)　ユーザに必要な権限

TP1/EEは，トランザクション関連定義のtrnstring定義コマンドのxa_open関数用文字列に指定するユーザ名で，オンラインバッチDBキュー表にアクセスします。trnstring定義コマンドのxa_open関数用文字列に指定するユーザ名には，次に示す権限を設定する必要があります。

システム権限

CREATE SESSION

CREATE TABLE

オブジェクト権限

SELECT ON DBA_PENDING_TRANSACTIONS

割り当て制限

オンラインバッチDBキュー表を作成する表領域に対する割り当て制限です。

権限の設定方法の詳細については，Oracleのマニュアルを参照してください。

(3)　Oracleをリソースマネジャとして使用する場合の注意事項

一度作成したライト管理表およびリード管理表は，TP1/EEで管理するため，変更や更新などをしないでください。

TP1/EEシステムでDBキューを複数使用する場合，スキーマ構成を統一してください。

オンラインバッチ機能機能のSQL実行時にエラーが発生した場合，Oracleのエラー情報は，TP1/EEのメッセージ，または回線トレースファイルに出力されます。出力されたTP1/EEのメッセージ，または回線トレースファイルの編集結果を見て原因を取り除いてください。

次に示すロケール（言語種別）は，同一の言語としてください。オンラインバッチ機能の使用時にTP1/EEが出力するメッセージにはOracleのメッセージが含まれているため，同一の言語が設定されていないとメッセージが正しく出力されないからです。

TP1/EEが動作するOracleのクライアントに対してNLSパラメタで選択するロケール

環境変数LANGに設定する言語種別

OracleのNLSパラメタについては，Oracleのマニュアルを参照してください。

6.8　他製品との連携時の運用

HAモニタ，HiRDB，Oracleなどと連携する場合の運用方法について説明します。

6.8.1　系切り替え機能使用時の運用

TP1/EEは，TP1/Server BaseのSPPとして動作するため，TP1/EEが直接HAモニタと連携することはありません。系切り替え時のTP1/EEの動作は，TP1/Server Baseに依存します。

ここでは，系切り替え機能使用時のTP1/EEの運用について説明します。系切り替え機能の詳細，および系切り替え機能使用時のTP1/Server Baseの運用については，マニュアル「OpenTP1 解説」を参照してください。また，系切り替え機能使用時に必要なHAモニタについては，マニュアル「高信頼化システム監視機能 HAモニタ」を参照してください。

(1)　系切り替え機能使用時の準備

(a)　TP1/EEの設定

系切り替え機能を使用する場合，実行系にあるTP1/EEと待機系にあるTP1/EEでは，次の内容をすべて一致させておく必要があります。

TP1/EEのシステム定義

UAPの実行形式プログラム

TP1/EEおよび関連プログラムプロダクトのバージョン

OpenTP1管理者の環境（ユーザID，グループID，環境変数）

TP1/EEディレクトリの完全パス名

なお，ステータスファイルは共用ディスクに設定しておく必要があります。

(b)　TP1/Server Baseの設定

TP1/Server Baseのシステム構成定義のha_confオペランドにYを指定します。また，ユーザサーバを自動起動するために，TP1/Server Baseのユーザサービス定義のnode_down_restartオペランドにYを指定します。そのほかのTP1/Server Baseの設定については，マニュアル「OpenTP1 運用と操作」を参照してください。

(2)　開始と終了

(a)　開始

実行系にあるTP1/EEおよび待機系にあるTP1/EEを両方とも開始してください。実行系にあるTP1/EEおよび待機系あるTP1/EEは，系切り替え機能を使用しない場合と同様に開始します。

(b)　終了

実行系TP1/EEの終了

実行系にあるTP1/EEだけを終了する場合は，eesvstopコマンドを実行します。

待機系TP1/EEの終了

待機系にあるTP1/Server Baseの終了に伴い，待機系にあるTP1/EEも終了します。待機系にあるTP1/EEだけを終了させることはできません。待機系にあるTP1/Server Baseを終了する場合は，dcstopコマンドを実行します。

(3)　系切り替えの方法

実行系にあるTP1/Server Baseに障害が発生した場合，待機系にあるTP1/Server Baseに切り替えて，オンラインを継続できます。TP1/Server Baseの系切り替えに伴い，TP1/EEも切り替わります。系切り替え後，待機系は実行系となります。なお，TP1/EEで切り替え時に引き継ぐファイルは，ステータスファイルだけです。

TP1/Server Baseの系切り替え方法の詳細については，マニュアル「OpenTP1 運用と操作」を参照してください。

(4)　TP1/EEの待機

TP1/Server Baseのシステム環境定義のuser_server_haオペランドにYを指定すると，予備のTP1/Server Base（待機系）が待機状態になるまでに，TP1/Server Baseのユーザサービス構成定義に指定したTP1/EEのプロセスだけを待機状態にさせることができます。ただし，次のことに注意してください。

TP1/EEでは，起動処理中に実行系から待機系に切り替わるのを待ちます。

TP1/Server Baseでは実行系のユーザサーバの構成を引き継ぎます。そのため，待機系に切り替わったあと，実行系のTP1/Server Baseでユーザサービス構成定義に指定されていたユーザサーバが構成から外れていた場合，TP1/EEプロセスは終了します。

TP1/Server Baseのシステム環境定義のuser_server_haオペランドにYを指定しない場合，TP1/EEは待機状態になりません。

(5)　運用コマンド

系切り替え機能使用時に使用できる運用コマンドについては，「9.5　運用コマンドの一覧」を参照してください。表の「オフライン」列に「○」が付いている運用コマンドを使用できます。

(6)　注意事項

実行系のTP1/EEに対して，UAP共用ライブラリ入れ替え機能を使ってUAP共用ライブラリを入れ替える場合は，実行系のUAP共用ライブラリを入れ替える前に入れ替え後のUAP共用ライブラリを待機系に格納してください。入れ替え後のUAP共用ライブラリの完全パス名は，実行系と待機系で一致するようにしてください。

6.8.2　HiRDB連携時の運用

HiRDBと連携する場合のTP1/EEの運用について説明します。

(1)　環境設定（HiRDB連携時）

HiRDB連携時にTP1/EEで設定する必要がある項目について説明します。

(a)　TP1/EEのトランザクション関連定義のtrn_rm_open_close_scopeオペランド

trn_rm_open_close_scopeオペランドは，指定を省略するかまたはprocessを指定することをお勧めします。

trn_rm_open_close_scopeオペランドの指定を省略またはprocessを指定した場合で，ネットワークダウン以外の障害によってTP1/EEとHiRDBとのコネクションが切断されたときは，コネクションの切断が要因となるSQLエラーは発生しません。これは，障害が復旧したあとにコネクションが再接続されるためです。

コネクション切断の要因がネットワークダウンの場合は，コネクションの切断が要因となるSQLエラーが発生します。これは，障害が復旧したあともコネクション切断を検知できないことが要因となって，コネクションの再接続ができないためです。ただし，該当するスレッドでの次のトランザクションではコネクション切断を検知して再接続するため，コネクションの切断が要因となるSQLエラーは発生しません。

(b)　TP1/EEのトランザクション関連定義のtrnstring定義コマンド

trnstring定義コマンドで次のように指定します。

-o　"トランザクションサービス用xa_open関数用文字列"

"HiRDBの環境変数グループ識別子*HiRDBの環境変数設定ファイル名（クライアント環境定義ファイル名）"の書式で記述します。HiRDBの環境変数グループ識別子は任意の4バイト文字固定で，HiRDBの環境変数設定ファイル名はフルパス名で記述してください。

-c　"トランザクションサービス用xa_close関数用文字列"

指定する必要はありません。

-O　"ユーザサービス用xa_open関数用文字列"

"HiRDBの環境変数グループ識別子+HiRDBの環境変数設定ファイル名（クライアント環境定義ファイル名）"の書式で記述します。HiRDBの環境変数グループ識別子は任意の4バイト文字固定で，HiRDBの環境変数設定ファイル名はフルパス名で記述してください。

-C　"ユーザサービス用xa_close関数用文字列"

指定する必要はありません。

-x

指定する必要はありません。

注意事項

-oオプションおよび-Oオプションには，同一のHiRDBの環境変数グループ識別子を指定してください。

HiRDBの環境変数グループ識別子とHiRDBの環境変数設定ファイル名の間に，-oオプションの場合は"*"を，-Oオプションの場合は"+"を指定してください。

-rオプションを指定しないでください。-rオプションを指定すると，トランザクション決着が遅くなることがあります。

-iオプションを指定する場合，複数のリソースマネジャ拡張子を指定しないでください。複数のリソースマネジャ拡張子を指定すると，不要な通信が発生し，トランザクション性能に影響します。

trnstring定義コマンドを複数指定する場合，trnstring定義コマンド間でHiRDBの環境変数グループ識別子が重複しないようにしてください。重複した場合，エラーになったり，想定していないHiRDBサーバに対してSQLを実行したりすることがあります。

(c)　TP1/Server Baseのユーザサービス定義

TP1/Server Baseのユーザサービス定義のputenv形式またはdcputenv形式で，次のHiRDBの環境変数を指定します。HiRDBの環境変数の詳細については，マニュアル「HiRDB UAP開発ガイド」を参照してください。

PDSWAITTIME　トランザクション処理中のサーバの最大待ち時間

任意の値を指定します。HiRDBサーバがHiRDBクライアントからの要求に対する応答を返してから，次にHiRDBクライアントから要求が来るまでのHiRDBサーバの最大待ち時間を指定する環境変数です。

PDSWATCHTIME　トランザクション処理以外のサーバの最大待ち時間

任意の値を指定します。HiRDBサーバがHiRDBクライアントからの要求に対する応答を返してから，次にHiRDBクライアントから要求が来るまでのHiRDBサーバの最大待ち時間を指定する環境変数です。0以外を指定するときは，PDKALVLに2を指定してください。

PDXAMODE　トランザクションの移行機能

0を指定します。トランザクションの移行機能を使用するかどうかを指定する環境変数です。

PDTXACANUM

トランザクション実行中の障害を考慮し，次の算出式を満たす値以上を指定することを推奨します。

指定値≧TP1/EEのスレッド数×HiRDB用リソースマネジャ数×2

TP1/EEのスレッド数

通常処理スレッド数，予備処理スレッド数，タイマ処理スレッド，および回復スレッド数の合計に3を加えた値です。

・通常処理スレッド数

TP1/EEのプロセス関連定義のthread_noオペランドで指定します。

・予備処理スレッド数

TP1/EEのプロセス関連定義のreserve_thread_noオペランドで指定します。

・タイマ処理スレッド数

TP1/FSPのタイマ関連定義のtim_perm_thread_noオペランドで指定します。

・回復スレッド数

TP1/EEのプロセス関連定義のrecover_thread_noオペランドで指定します。

HiRDB用リソースマネジャ数

トランザクション関連定義trnstring定義コマンドに指定するX/OpenのXAインタフェースを使用するHiRDB用リソースマネジャの数です。

(d)　HiRDBのクライアント環境定義ファイル（環境変数設定ファイル）

HiRDBのクライアント環境定義ファイルを次のように設定します。ファイル名は任意で，ファイル名の長さの上限は250バイトです。次に示す設定値以外の環境変数の設定は任意です。

HiRDBのクライアント環境定義ファイルの詳細については，マニュアル「HiRDB UAP開発ガイド」を参照してください。

PDHOST=HiRDBサーバのホスト名

接続するHiRDBサーバのホスト名を指定します。

PDUSER=ユーザ名/パスワード

ユーザ名およびパスワードを指定します。

大文字，小文字の指定に関係なく大文字として扱われます。ただし，「'"ユーザ名"/"パスワード"'」のように，小文字を引用符「"」で囲んだ場合は，小文字として扱われます。

PDNAMEPORT=HiRDBサーバのポート番号

接続するHiRDBサーバのポート番号を指定します。HiRDBのシステム共通定義のpd_name_portオペランドの指定値を指定してください。pd_name_portオペランドについては，マニュアル「HiRDB システム定義」を参照してください。

(2)　リソースマネジャに関する準備（HiRDB連携時）

使用できるリソースマネジャの種別や，注意点について説明します。

(a)　使用できるリソースマネジャ

静的リソースマネジャおよび動的リソースマネジャを使用できます。静的リソースマネジャおよび動的リソースマネジャの比較を次の表に示します。

表6‒20　動的リソースマネジャおよび静的リソースマネジャの比較（HiRDBの場合）

項目

動的リソースマネジャ

静的リソースマネジャ

コネクション形態

TP1/EE起動時にコネクションを確立し，TP1/EE終了時にコネクションを解放します。

SQLを発行した場合の動作

xa関数を，1リソースマネジャ当たり3〜4回発行します。

SQLを発行しない場合の動作

xa関数を発行しません。

xa関数を，1リソースマネジャ当たり3〜4回発行します。

(b)　UAP作成時のリソースマネジャ連携オブジェクトファイル

eetrnmkobjコマンドを使用して作成します。

(c)　コネクション数に関する注意点

TP1/EEは，HiRDBとの間に複数のコネクションを確立します。そのため，HiRDBの定義に次の算出式を満たすよう指定する必要があります。

HiRDBとの同時接続数

HiRDBのシステム共通定義のpd_max_usersオペランドで指定します。

トランザクション実行中の障害を考慮し，次の算出式を満たす値以上を加算することを推奨します。

指定値≧TP1/EEのスレッド数×HiRDB用リソースマネジャ数×2

TP1/EEのスレッド数

通常処理スレッド数，予備処理スレッド数，およびタイマ処理スレッド数の合計に1を加えた値です。

なお，TP1/FSPのトランザクション関連定義のtrn_aph_useオペランドにYを指定した場合は，1を加えてください。

通常処理スレッド数

TP1/EEのプロセス関連定義のthread_noオペランドで指定します。

予備処理スレッド数

TP1/EEのプロセス関連定義のreserve_thread_noオペランドで指定します。

タイマ処理スレッド数

TP1/FSPのタイマ関連定義のtim_perm_thread_noオペランドで指定します。

tim_perm_thread_noオペランドについては，TP1/FSPの関連ドキュメントを参照してください。

HiRDB用リソースマネジャ数

トランザクション関連定義のtrnstring定義コマンドに指定するHiRDB用リソースマネジャの数です。接続するHiRDBサーバごとに定義したtrnstring定義コマンドの数です。

(3)　実行中のトランザクションの確認

トランザクション関連定義のtrnstring定義コマンド，eetrnlstrコマンド，およびHiRDBのpdlsコマンドを使用するとHiRDBで実行中のトランザクションを確認できます。トランザクションの確認方法は，TP1/EE 01-01とTP1/EE 01-02以降で異なります。

なお，pdlsコマンドの詳細については，マニュアル「HiRDB コマンドリファレンス」を参照してください。

(a)　TP1/EE 01-01でトランザクションを確認する方法

次に示す条件が成り立つ場合，TP1/EEのトランザクションがHiRDB上で実行されていることを確認できます。

A=A'かつB=B'かつC=C'

A，A'，B，B'，C，およびC'の内容を次に示します。

A

トランザクション関連定義のtrnstring定義コマンドの-Oオプションで指定する1文字目から4文字目

A'

pdls -d trnコマンドの-aオプションを実行したときに表示されるENVGRPの1文字目から4文字目

B

eetrnlstrコマンドを実行したときに表示されるXIDの25文字目から40文字目

B'

pdls -d trnコマンドの-aオプションを実行したときに表示されるXIDの1文字目から16文字目

C

eetrnlstrコマンドを実行したときに表示されるXIDの73文字目から88文字目

C'

pdls -d trnコマンドの-aオプションを実行したときに表示されるXIDの18文字目から33文字目

A，A'，B，B'，C，およびC'に該当する文字の例を次に示します。

A：トランザクション関連定義のtrnstring定義コマンドの指定例

B，C：「eetrnlstr -g サービスグループ名 -t -i」と指定した場合の出力形式の例

A'，B'，C'：「pdls -d trn -a」と指定した場合の出力形式の例

(b)　TP1/EE 01-02以降でトランザクションを確認する方法

次に示す条件が成り立つ場合，TP1/EEのトランザクションがHiRDB上で実行されていることを確認できます。

A=A'かつB=B'

A，A'，B，およびB'の内容を次に示します。

A

トランザクション関連定義のtrnstring定義コマンドの-Oオプションで指定する1文字目から4文字目

B

eetrnlstrコマンドを実行したときに表示されるHXIDの1文字目から33文字目

A'

pdls -d trnコマンドの-aオプションを実行したときに表示されるENVGRPの1文字目から4文字目

B'

pdls -d trnコマンドの-aオプションを実行したときに表示されるXIDの1文字目から33文字目

A，A'，B，およびB'に該当する文字の例を次に示します。

A：トランザクション関連定義のtrnstring定義コマンドの指定例

B：「eetrnlstr -g サービスグループ名 -t -i」と指定した場合の出力形式の例

A'，B'：「pdls -d trn -a」と指定した場合の出力形式の例

(4)　コーディング例

C言語またはCOBOL言語を使用したUAPのコーディング例については，マニュアル「TP1/Server Base Enterprise Option プログラム作成の手引」を参照してください。

6.8.3　Oracle連携時の運用

Oracleと連携する場合のTP1/EEの運用について説明します。

(1)　環境設定（Oracle連携時）

Oracle連携時にTP1/EEで設定する必要がある項目について指定します。

(a)　TP1/EEのプロセス関連定義のother_lib_stack_sizeオペランド

プロセス関連定義のother_lib_stack_sizeオペランドで，追加するスタックサイズを指定してください。これは，Oracleライブラリの追加によるトランザクション回復中のスタックサイズ不足を防ぐためです。スタックサイズ不足が発生すると，メモリが破壊されて，プロセスダウンすることがあります。

(b)　TP1/EEのトランザクション関連定義のtrnstring定義コマンド

trnstring定義コマンドで次のように指定します。

-o　"トランザクションサービス用xa_open関数用文字列"

xa_open関数用文字列（オープン文字列）については，Oracleのマニュアルを参照してください。また，TP1/EEはマルチスレッドで動作するため，スレッドを使用できるように指定してください。

オープン文字列に指定するuidには，OracleのDBA_PENDING_TRANSACTIONSビューのSELECT権限があるユーザ名を指定してください。DBA_PENDING_TRANSACTIONSビューのSELECT権限がない場合，UAPの部分回復，およびTP1/EEシステム再開始後のトランザクション回復処理が正常に行われないことがあります。

オープン文字列に指定するSesTmは，Oracleのグローバルトランザクション監視時間値です。SesTmには，TP1/EEのトランザクション処理の監視時間より大きい値を指定してください。SesTmにTP1/EEのトランザクション処理の監視時間より小さい値を指定した場合，SesTmに指定した時間が経過したあと，OracleがTP1/EEの指示を待たないでトランザクションを決着させることがあるため，TP1/EEがプロセスダウンすることがあります。

-c　"トランザクションサービス用xa_close関数用文字列"

xa_close関数用文字列（クローズ文字列）については，Oracleのマニュアルを参照してください。

-O　"ユーザサービス用xa_open関数用文字列"

xa_open関数用文字列（オープン文字列）については，Oracleのマニュアルを参照してください。また，TP1/EEはマルチスレッドで動作するため，スレッドを使用できるように指定してください。

オープン文字列に指定するSesTmは，Oracleのグローバルトランザクション監視時間値です。SesTmには，TP1/EEのトランザクション処理の監視時間より大きい値を指定してください。SesTmにTP1/EEのトランザクション処理の監視時間より小さい値を指定した場合，SesTmに指定した時間が経過したあと，OracleがTP1/EEの指示を待たないでトランザクションを決着させることがあるため，TP1/EEがプロセスダウンすることがあります。

また，オープン文字列に指定するLoose_Couplingには，trueを指定してください。Loose_Couplingの指定を省略した場合，およびfalseを指定した場合の動作は保証しません。

なお，DBキュー機能またはオンラインバッチ機能で使用するリソースマネジャがOracleの場合は，次に示すフィールドをオープン文字列に指定してください。

Objects=true

DBキュー機能またはオンラインバッチ機能ではLOB型を使用するため，このフィールドを指定する必要があります。指定を省略した場合，動作は保証しません。

MaxCur

UAPを実行するために必要なカーソル数に10を加算した値を指定してください。指定値が小さいと，UAPが実行するSQL，DBキュー機能が実行するSQL，またはオンラインバッチ機能が実行するSQLの実行時間が長くなるおそれがあります。

-C　"ユーザサービス用xa_close関数用文字列"

xa_close関数用文字列（クローズ文字列）については，Oracleのマニュアルを参照してください。

-r

Oracle RAC機能を使用する場合は，-rオプションを必ず指定してください。-rオプションの指定を省略した場合，トランザクションの決着が不整合になることがあります。また，-rオプションを有効にするために"RAC_FAILOVER=T"をxa_open関数用文字列に指定してください。

Oracle RAC機能を使用する場合でOracle 10g R2以降のときは，-rオプションを指定しないでDTPサービスを使用してください。DTPサービスについては，Oracleのマニュアルを参照してください。

-x

1スレッドから一つのOracleインスタンスに対して複数のセションを確立する場合は，-xオプションを必ず指定してください。-xオプションの指定を省略した場合，xa関数がエラーとなることがあります。

注意事項

trnstring定義コマンドで複数のOracleに接続するように定義した場合で，SQLの実行時にエラーが発生したときは，リソースマネジャとのコネクションの解放指示を行ってください。これは，SQLの実行時にエラーが発生してロールバックを行っても，Oracleの暗黙カーソルがクローズされないことがあるためです。暗黙カーソルがクローズされない状態のまま，以降のトランザクションでSQLを実行するとエラーになることがあります。リソースマネジャとのコネクションの解放の詳細については，マニュアル「TP1/Server Base Enterprise Option プログラム作成の手引」を参照してください。

(c)　TP1/Server Baseのユーザサービス定義またはユーザサービスデフォルト定義

Oracleにアクセスするためには，Oracleが定めた環境変数を設定する必要があります。環境変数は，TP1/Server Baseのユーザサービス定義，またはユーザサービスデフォルト定義にputenv形式で指定してください。

次に示すような，設定が必要な環境変数名や設定値については，Oracleのインストール時に設定した値や，環境設定に関して記載されたOracleのマニュアルを参照してください。

データ識別子（ORACLE_SID）

ORACLEホームディレクトリ（ORACLE_HOME）

(2)　リソースマネジャに関する準備（Oracle連携時）

使用できるリソースマネジャの種別や，注意点について説明します。

(a)　使用できるリソースマネジャ

静的リソースマネジャおよび動的リソースマネジャを使用できます。静的リソースマネジャおよび動的リソースマネジャの比較を次の表に示します。

表6‒21　動的リソースマネジャおよび静的リソースマネジャの比較（Oracleの場合）

項目

動的リソースマネジャ

静的リソースマネジャ

コネクション形態

TP1/EE起動時にコネクションを確立し，TP1/EE終了時にコネクションを解放します。

SQLを発行した場合の動作

xa関数を，1リソースマネジャ当たり3〜4回発行します。

SQLを発行しない場合の動作

xa関数を発行しません。

xa関数を，1リソースマネジャ当たり3〜4回発行します。

(b)　UAP作成時のリソースマネジャ連携オブジェクトファイル

eetrnmkobjコマンドを使用して作成します。eetrnmkobjコマンドのオプションに指定する情報については，次の表を参考にしてOracleのXAインタフェースに関して記載されたマニュアルを参照してください。

表6‒22　eetrnmkobjコマンドのオプションに指定する情報（Oracle 10g R2以降の場合）

設定項目

対応するOracleのマニュアルでの説明

リソースマネジャ名

xa_switch_tリソース・マネジャ

リソースマネジャスイッチ名※

xa_switch_t構造体

リソースマネジャ関連オブジェクト

ライブラリ

注※

DBキュー機能またはオンラインバッチ機能で使用するリソースマネジャがOracleの場合は，静的登録のためのリソースマネジャスイッチ名を指定してください。動的登録のためのリソースマネジャスイッチ名を指定した場合，システムの動作は保証しません。

(c)　コネクション数に関する注意点

TP1/EEは，Oracleとの間に複数のコネクションを確立します。そのため，Oracleとの同時接続数が，OracleのSESSIONS定義の指定値を超えないように指定する必要があります。OracleのSESSIONS定義の指定値を超えてOracleにアクセスした場合，xa関数がエラーリターンします。

OracleのSESSIONS定義の指定値は，次に示す計算式（Oracle 10g R2以降の場合）を参考にして見積もってください。

SESSIONS定義の指定値≧((TP1/EEの処理スレッド数＋TP1/EEの回復スレッド数＋1)
×Oracle用リソースマネジャ数)

TP1/EEの処理スレッド数

通常処理スレッド数，予備処理スレッド数，およびタイマ処理スレッド数の合計に1を加えた値です。

通常処理スレッド数

TP1/EEのプロセス関連定義のthread_noオペランドで指定します。

予備処理スレッド数

TP1/EEのプロセス関連定義のreserve_thread_noオペランドで指定します。

タイマ処理スレッド数

TP1/EEのタイマ関連定義のtim_perm_thread_noオペランドで指定します。

tim_perm_thread_noオペランドについては，TP1/FSPの関連ドキュメントを参照してください。

TP1/EEの回復スレッド数

TP1/EEのプロセス関連定義のrecover_thread_noオペランドで指定します。

Oracle用リソースマネジャ数

トランザクション関連定義のtrnstring定義コマンドに指定するOracle用リソースマネジャの数です。

(3)　Oracleインスタンスに対する複数のセションの確立

1スレッドから一つのOracleインスタンスに対して複数のセションを確立する場合は，同一グローバルトランザクション内であっても，コネクションごとにトランザクションIDを変更する必要があります。このため，1スレッドから一つのOracleインスタンスに対して複数のセションを確立する場合は，同一グローバルトランザクション内であってもトランザクションIDが一意になるように，トランザクション関連定義のtrnstring定義コマンドに-xを指定してください。

HiRDBおよびOracleに対して複数のセションを確立する場合の処理の例を次の図に示します。図中の"HiRDB_DB_SERVER"はHiRDBのリソースマネジャ名を，"Oracle_XA"はOracleのリソースマネジャ名を示します。

図6‒19　複数のセションを確立する場合の処理の例

図の説明を次に示します。説明文中の番号は図中の番号と対応します。

TP1/EEは，トランザクションの開始時にXIDを作成します（1）。次に，TP1/EEのトランザクション関連定義に従って，次に示すとおりにxa関数を発行します。

HiRDBに対するxa関数の発行

（1）で作成したXIDを指定してxa関数を発行します（2，3）。

Oracleに対するxa関数の発行

trnstring定義コマンドに-xオプションが指定されているため，（1）で作成したXIDにrmidを付加（XID1_0，XID1_1）してxa関数を発行します（4，5）。

(4)　トランザクションの回復待ち合わせ

Oracle RAC機能を使用している場合にOracleサーバが異常終了すると，障害が発生したサーバから切り替え先サーバにインダウトトランザクション（未決着トランザクション情報）が転送されます。このインダウトトランザクションの転送処理に時間が掛かると，Oracleの仕様上，TP1/EEとOracleとの間でトランザクション決着種別が不一致になることがあります。これを防ぐためには，インダウトトランザクションの転送処理を行っている間は，TP1/EEのトランザクションの回復を待ち合わせる必要があります。

Oracle RAC機能を使用している環境で，Oracleサーバに障害が発生したときのトランザクション回復の流れを次の図に示します。

図6‒20　Oracleサーバに障害が発生したときのトランザクション回復の流れ

図の説明を次に示します。説明文中の番号は図中の番号と対応します。

トランザクション実行中にOracleサーバ（ノード1）で障害が発生した場合（1），未決着トランザクション情報は，切り替え先サーバであるOracleサーバ（ノード2）に転送されます（2，3）。TP1/EEは，（2，3）の転送処理が完了したあとに，xa_recover関数を発行します（4）。xa_recover関数がリターンすると，トランザクションの回復処理が続行されます。

(a)　使用方法

Oracle RAC機能を使用する場合は，トランザクション関連定義のtrnstring定義コマンドに-rオプションを指定してください。trnstring定義コマンドに-rオプションを指定すると，TP1/EEの開始処理中またはオンライン処理中にリソースマネジャから未決着トランザクション情報の通知があるまで，トランザクションの回復処理を待ち合わせます。

回復スレッド数（プロセス関連定義のrecover_thread_noオペランドで指定）は，trnstring定義コマンドの-rオプションに指定したリソースマネジャ数以上にすることをお勧めします。これは，TP1/EEがリソースマネジャからの応答を待ち合わせる際，TP1/EEの回復スレッドが占有されるためです。回復スレッド数を増やさなかった場合は，トランザクションの回復処理に時間が掛かることがあります。

(b)　注意事項

トランザクションの回復処理を待ち合わせた場合，TP1/EEの開始処理中またはオンライン処理中にリソースマネジャに障害が発生すると，そのリソースマネジャが参加したトランザクションの該当リソースマネジャの障害が回復されるまで，トランザクションの回復処理が遅れます。

6.8.4　COBOL言語を使用する場合の設定

TP1/EEでCOBOL言語によって作成したUAPを使用する場合に設定する必要のある項目や，UAPの作成方法について説明します。

なお，OSがLinux (IA32)の場合，COBOL製品として使用できるのはCOBOL85だけです。また，OSがLinux (EM64T)の場合，COBOL製品として使用できるのはCOBOL2002だけです。

(1)　システム定義

システム定義を次のように指定します。

プロセス関連定義のcobol_use_flagオペランド

Yを指定します。

COBOL言語のUAPを使用している場合に，cobol_use_flagオペランドにNを指定したとき，システムの動作は保証しません。また，COBOL言語をインストールしていない環境で，cobol_use_flagオペランドにYを指定した場合は，TP1/EE起動時にエラーメッセージを出力します。

プロセス関連定義のcobol_langオペランド

COBOL85を使用する場合は85を，COBOL2002を使用する場合は2002を指定します。

プロセス関連定義のcobol_uap_cblendオペランド

UAP実行前に，COBOL実行空間を毎回再生成するかどうかを指定します。

メモリ関連定義のmemory_cobol_area_sizeオペランド，またはmemory_cobol_area_thd_sizeオペランド

COBOLプログラムが使用するメモリサイズを指定します。

COBOLプログラム用のメモリを，TP1/EEで提供するエリア内で確保したい場合に指定します。memory_cobol_area_sizeオペランド，またはmemory_cobol_area_thd_sizeオペランドを指定することによって，次の利点があります。

TP1/EEで一括確保したエリアを使用することによって，メモリを効率良く使用でき，フラグメンテーションの発生を抑止できます。

UAPの障害発生時にスレッドダウンさせる機能を使用した場合，プロセスダウンになる可能性が低くなります。

(2)　環境変数

プロセス関連定義のcobol_use_flagオペランドにYを指定した場合，次の環境変数で指定したCOBOLファイル名の終端にIFA番号が付加されます。

CBLABNLST

CBLDDUMP

CBL_SYSERR

CBL_SYSPUNCH

CBL_SYSOUT

スレッドダウンが発生してスレッドを消滅させたあとにスレッドを再起動する場合，IFA番号は前回のスレッドから引き継がれます。そのため，スレッドの再起動後も，スレッドの再起動前と同じファイルに出力されます。

なお，DISPLAY文で環境変数を指定した場合は，ファイル名の終端にIFA番号が付加されません。また，プロセス関連定義のcobol_use_flagオペランドにNを指定した場合，COBOLファイル名はCOBOL言語の仕様に従います。

(3)　COBOL言語によるUAP作成方法

COBOL言語でUAPを作成する方法について説明します。

(a)　コンパイルとリンケージ

コンパイル

TP1/EEで使用するCOBOLプログラムをマルチスレッド対応にするためには，次に示すマルチスレッド用のコンパイラオプションを指定します。

COBOL85の場合：-Mtおよび-Mp

COBOL2002の場合：-MultiThread

(4)　注意事項

TP1/EEで同期シグナルを捕捉しスレッドダウンとなる場合，COBOLの異常終了時要約情報リストを採取します。

COBOL85/TDは，TP1/EE環境では使用できません。

COBOL2002のテストデバッガ，カバレージをTP1/EE環境で使用する場合の注意事項を次に示します。そのほかの注意事項については，マニュアル「COBOL2002 使用の手引 操作編」を参照してください。

COBOLプログラムから連動実行してテストデバッグ，カバレージ情報の蓄積，カウント情報の表示を実行する場合，メモリ不足のため起動できないことがあります。その場合は，メモリ関連定義のmemory_cobol_area_sizeオペランド，memory_cobol_area_thd_sizeオペランド，およびmax_mem_sizeオペランドを調整してください。プログラムでハングアップまたはタイムアウトが発生する場合は，トランザクション関連定義のtrn_expiration_timeオペランドに0を設定することで回避できます。

TP1/EEで使用するCOBOLではマルチスレッド機能を使用する必要があるため，COBOLで使用できる機能に制約や注意事項があります。詳細については，COBOL85の場合はマニュアル「COBOL85 使用の手引」を，COBOL2002の場合はマニュアル「COBOL2002 使用の手引 手引編」を参照してください。

COBOL言語のUAPで使用したファイルは，サービスプログラム実行中にCLOSE文で閉じてください。閉じないままにしておくと，次のサービスプログラムで同名のファイルを操作したときにエラーメッセージが表示されます。

スレッド内でサービスプログラムが繰り返し実行される場合，データ領域のVALUE句は無効となります。データ領域は必要に応じて初期化されるか，プログラムを初期化属性（プログラムの見出し部にINITIAL句を指定）としてください。または，cobol_uap_cblendオペランドにYを指定してください。

サービスプログラム実行中に次の環境変数の値を変更することはできません。

CBL_SYSOUT（DISPLAY文の出力先）

CBLLPATHまたはCBLLSLIB（COBOLダイナミックリンク機能の検索ディレクトリ）

COBOL言語で作成したUAPを終了する場合，STOP RUN文ではなくEXIT PROGRAM文を実行してください。

6.9　処理キュー制御機能の運用

トランザクションが登録された処理キューは，プロセス内のサービス単位でのラウンドロビン方式および先入れ先出し方式（FIFO方式）で引き出されます。

また，サービス単位の処理キューの同時処理限界数は，ユーザサービス関連定義のserviceオペランドで指定できます。

サービスAの同時処理限界数に2以上を指定した場合で，サービスA以外のサービスに登録されている処理キューがないときは，サービス単位の処理キューの同時処理が実行されます。したがって，サービスAから，指定した同時処理限界数分の処理キューが引き出されます。

6.10　処理スレッド動的増加機能の運用

処理スレッド動的増加機能の運用方法について説明します。

6.10.1　予備処理スレッド起動タイミング

処理キュー登録時，次のすべての条件を満たす場合に予備処理スレッドが起動されます。

処理キューが登録されているサービス数が通常処理スレッド数より多い。

予備処理スレッド起動しきい値以上の処理キューが登録されているサービスがある。

予備処理スレッド数および予備処理スレッド起動しきい値を定義している。

通常処理スレッド数，予備処理スレッド数，および予備処理スレッド起動しきい値は，次に示すプロセス関連定義のオペランドで指定します。

通常処理スレッド数：thread_noオペランド

予備処理スレッド数：reserve_thread_noオペランド

予備処理スレッド起動しきい値：reserve_start_pce_noオペランド

予備処理スレッド数を定義した場合，各スレッドに対して通常処理スレッド／予備処理スレッドの区別はしないで，一つの処理スレッドのグループとして扱います。処理中に，通常処理スレッドとして処理するか，予備処理スレッドとして処理するかを決定します。

6.10.2　通常処理スレッドの処理キュー検索

通常処理スレッドの場合は，サービスに登録されている処理キューをラウンドロビン方式で検索します。登録されている処理キューの数が予備処理スレッド起動しきい値を超えているかどうかに関係なく，すべてのサービスに対して処理キューの引き出しを行います。

通常処理スレッドの処理キュー検索の概要を次の図に示します。

図6‒21　通常処理スレッドの処理キュー検索

6.10.3　予備処理スレッドの処理キュー検索

予備処理スレッドの場合は，予備処理スレッド起動しきい値以上の数の処理キューが登録されているサービスに対して，処理キューをラウンドロビン方式で検索します。登録されている処理キューの数が予備処理スレッド起動しきい値未満のサービスは，処理対象外です。

予備処理スレッドの処理キュー検索の概要を次の図に示します。予備処理スレッドが一つの場合は，次の図のサービス2および4の処理キューがラウンドロビンで処理されます。

図6‒22　予備処理スレッドの処理キュー検索

7　システム定義の概要

この章では，システム定義の概要について説明します。また，システム定義の種類，および定義の変更方法について説明します。

7.1　概要

TP1/EEのシステム定義の体系，構成，作成手順，および規則について説明します。なお，TP1/Server Baseの定義については，TP1/EEで必要になる部分について記載しています。

7.1.1　定義の体系

TP1/EEの定義は，TP1/Server Baseのシステムサービス定義とTP1/EEの定義とで構成されています。TP1/EEの定義をTP1/EEサービス定義と呼びます。TP1/Server Baseの環境下で動作するTP1/EEプロセスの動作は，TP1/EEサービス定義で定義します。

TP1/EEサービス定義の体系を，次の図に示します。なお，TP1/Server Baseのシステムサービス定義の体系の詳細については，マニュアル「OpenTP1 システム定義」を参照してください。

図7‒1　TP1/EEサービス定義の体系

7.1.2　定義の構成

TP1/EEサービス定義は，一つのファイルに定義します。TP1/EEシステムの動作する環境をTP1/EE（SPP）ごとに定義します。

TP1/EEサービス定義は，次に示す定義で構成されます。TP1/EEサービス定義の概要を次の表に示します。

表7‒1　TP1/EEサービス定義の概要

定義名

内容

プロセス関連定義

TP1/EEプロセスの環境および動作を定義します。

メモリ関連定義

TP1/EEプロセスで使用するメモリの情報を定義します。

RPC関連定義

RPC関連情報を定義します。

ユーザサービス関連定義

UAP関連情報を定義します。

メッセージログ関連定義

メッセージログ関連情報を定義します。

トラブルシュート関連定義

トラブルシュートおよびトレース関連情報を定義します。

トランザクション関連定義

トランザクション関連情報を定義します。

ステータスファイル関連定義

TP1/EEで使用するステータスファイル関連情報を定義します。

DBキュー機能関連定義

DBキュー機能関連情報を定義します。

オンラインバッチ機能関連定義

オンラインバッチ機能関連情報を定義します。

ファイルサービス関連定義

ファイルサービス関連情報を定義します。

サービスグループ情報関連定義

サービスグループ情報を定義します。

7.1.3　定義の作成手順

TP1/EEサービス定義を作成する場合は，テキストエディタを使用して定義ファイルを作成します。

定義の作成手順とオンライン開始時の処理の流れを次の図に示します。

図7‒2　定義の作成手順とオンライン開始時の処理の流れ

7.1.4　定義の規則

定義の基本事項と記述形式について説明します。

(1)　基本事項

(a)　定義ファイル

TP1/EEサービス定義ファイルは，環境変数DCCONFPATHまたはDCUAPCONFPATHに指定したディレクトリに格納してください。

TP1/EEサービス定義ファイル名は，環境変数EEDEFFILEに指定します。EEDEFFILEで指定したTP1/EEサービス定義ファイル名と，DCCONFPATHまたはDCUAPCONFPATHで指定したTP1/EEサービス定義ファイルの絶対パス名との文字列の合計が，1023文字以下になるようにしてください。

DCCONFPATH，およびDCUAPCONFPATHの両方が定義されていて，両方のディレクトリにTP1/EEサービス定義ファイルが格納されている場合は，DCCONFPATHに指定されたディレクトリ下のTP1/EEサービス定義ファイルが有効になります。

DCCONFPATH，およびDCUAPCONFPATHの両方が定義されていて，DCCONFPATHに指定されたディレクトリ下にTP1/EEサービス定義ファイルが格納されていない，または該当するファイルのオープンに失敗した場合は，DCUAPCONFPATHに指定したディレクトリ下のTP1/EEサービス定義ファイルが有効になります。

DCCONFPATH，およびDCUAPCONFPATHの両方が定義されていて，両方のディレクトリにTP1/EEサービス定義ファイルが格納されていない，または該当ファイルのオープンに失敗した場合は，TP1/EEを起動できません。システムは，プロセスダウンします。

同一ノードで複数のTP1/EEを動作させる場合

同一ノードで複数のTP1/EEが動作するシステム構成では，それぞれのTP1/EEに定義ファイルを作成します。同一ノードで複数のTP1/EEが動作する場合，すべてのTP1/EEの定義ファイルを，同じディレクトリに格納してください。また，定義ファイルの名称は同一ノード内で一意の名称にしてください。

同一ノードで複数のTP1/EEが動作する場合，TP1/EEごとに異なる指定値にする必要があるTP1/EEサービス定義を，次の表に示します。

表7‒2　TP1/EEごとに異なる指定値にするTP1/EEサービス定義

定義

オペランド／コマンド

定義内容

プロセス関連定義

service_group

サービスグループ名

cmd_port

コマンド受信用のポート番号

RPC関連定義

rap_listen_port

リモートAPI受信用のポート番号

rap_client_manager_port

rapクライアントマネジャ機能での受信用ポート番号

サービスグループ情報関連定義

mysvgdef

自サービスグループ情報

myreplydef

自サービスグループ応答情報

(b)　記述順序

TP1/EEサービス定義の，定義間の記述順序は任意です。

TP1/EEサービス定義の定義形式には，set形式，およびコマンド形式があります。どちらの定義形式も同一定義ファイルに格納します。set形式，コマンド形式の記述順序は任意です。

定義情報はテキストエディタでメンテナンスできます。ただし，オンラインで使用中の定義を変更または削除しないでください。定義を変更または削除した場合，そのオンラインの動作は保証できません。定義を変更する手順については，「7.3　TP1/EEシステムの定義の変更」を参照してください。

(2)　記述形式

(a)　set形式

set形式ではオペランドに値を設定します。

形式

set　オペランド=値

set形式のオペランドのうち，複数の値を指定できないオペランドで，指定値のあとにスペースが入力され，その後ろに文字が記述してあった場合は，スペース以降はコメントと認識されます。

(b)　コマンド形式

コマンド形式では次の形式に従ってオプションを設定します。

形式

コマンド名　オプション

用語の定義

コマンド名：コマンド名称です。

オプション：マイナス記号で始まる文字列です。

引数を取らない形式1と引数を必要とする形式2の二つがあります。

形式1　-オプションフラグ

形式2　-オプションフラグ　フラグ引数

（凡例）

オプションフラグ：マイナス記号に続く1文字の英数字です。英大文字と英小文字とは区別します。

フラグ引数：オプションフラグに対する文字列です。

(c)　コメント

コメントを記入する場合は，コメントの先頭に「#」を記述してください。行の先頭に「#」を記述すると1行全体がコメント扱いになります。

形式1　定義の記述　　　#コメント・・・・・・

形式2　#コメント・・・・・・・

形式1の場合，コメント文字「#」の前にスペースを入力してください。

コメント文字「#」がある行は，「#」以降の文字列がすべてコメントとして認識されます。そのため，継続させたい行（「¥」を付ける行）には，コメントを記入できません。ただし，引用符で囲んだ文字列の中に「#」がある場合は，「#」および「#」以降の文字列は，文字として認識されます。

コメント文字の使用例を次に示します。

「#」および「#」以降がコメントとして認識される例

#abc
set△service_group=srvgrp01△#abc

「#」および「#」以降も文字として認識される例

set△service_group=srvgrp01#abc
set△service_group="srvgrp01=srvgrp02#abc"
set△service_group="srvgrp01=srvgrp02△#abc"

(d)　行の継続

定義の1行の長さは最大80文字です。80文字を超える指定の場合は，複数行に分けて記述してください。

行を継続させるには，行の末尾に継続文字「¥」を記述し，その直後で改行してください。継続文字「¥」と改行（「¥n」）が連続していない場合は，継続されません。継続行の先頭にスペースがある場合は，スペースも含めて継続されます。

ただし，ユーザサービス関連定義のserviceオペランドの引用符で囲まれている指定値など，スペースを入力できない位置で行を継続させた場合は，先頭にスペースがあるとエラーになります。

連続した「¥」の次が改行（「¥n」）の場合は，連続した「¥」の最後の「¥」が継続文字として認識されます。それ以前の「¥」はすべて文字として認識されます。そのため，80文字目に文字としての「¥」は使用できません。80文字目に文字としての「¥」を使用したい場合は，次に示すどちらかの方法で記述してください。

80文字目に「¥」を記述し，その直後で改行してください。次の行には，「¥△¥n」（「¥」，スペース，改行の順）と記述してください。

80文字目より前で「¥」を記述し，その直後で改行してください。次の行には，続きの文字を記述してください。

文字列の最後の「¥」を文字として認識させたい場合は，「¥」の後ろにスペースを入力してください。

(e)　注意事項

改行コード（「¥n」）はLFだけを記述できます。CR+LFやCRは記述できません。

ASCII文字だけを記述できます。ASCII文字以外は記述できません。

複数の値を指定できない定義の場合，一つ目の指定値のあとに，文字列やコンマ「,」などがあったときは，エラーまたは警告になります。エラーまたは警告になる定義例を次に示します。

エラーになる例

set△service_group="srvgrp01"abc
set△service_hold="Y"N

警告が出る例

set△service_group=srvgrp01,
set△service_group=srvgrp01, srvgrp02
set△service_group="srvgrp01",
set△service_hold=Y,
set△service_hold=Y, C
set△service_hold="Y", N

複数の値を指定できない定義に二つ以上の値が指定してあるか，またはオペランドが複数回指定してあったため警告が出た場合，その後の処理では一つ目の指定値が有効になります。一つ目の指定値が不正な場合は，二つ目以降の指定値が正常でも，エラーになります。一つ目の指定値が正常な場合は，二つ目以降の指定値が不正でも，一つ目の指定値が有効になるため，処理は続行されます。ただし，オペランドが複数回指定してある場合で，二つ目以降の定義形式が不正なとき（指定値がない，オペランドと指定値の間の「=」がないなど）は，エラーになります。

set形式を記述する場合は，「△set△オペランド△=△指定値△,△指定値」という形式で記述してください。ただし，setの前，「=」前後，および指定値を区切るコンマ「,」の前後には，スペースを入力しなくても記述できます。

コマンド形式のフラグ引数を持たないオプションフラグ（-a，-bなど）は，「-ab」のように指定できません。オプションフラグの指定順序は任意です。定義にはコマンド名，オプションフラグ，フラグ引数以外はスペースだけを記述してください。フラグ引数で指定値をコロン「:」またはコンマ「,」で区切る場合は，「:」，「,」の前後にスペースを入力しないでください。フラグ引数として識別子，英数字列を指定する場合は，フラグ引数を引用符で囲まないでください。フラグ引数として文字列を指定する場合は，フラグ引数を引用符で囲んでください。

7.2　システム定義の種類

システム定義の概要と定義の種類について説明します。

7.2.1　システム定義とファイル名

TP1/EEを使用する場合に必要なシステム定義を次の表に示します。項番1〜4の定義はTP1/Server Baseのシステムサービス定義です。

表7‒3　システムサービス定義を登録するファイル名

項番

定義名

定義ファイル名（絶対パス名）

定義の内容

1

システム共通定義

$DCCONFPATH/betranrc

「7.2.2(1)　TP1/Server Baseのシステム共通定義の内容」を参照

2

ネームサービス定義

$DCCONFPATH/nam

「7.2.2(2)　TP1/Server Baseのネームサービス定義の内容」を参照

3

ログサービス定義

$DCCONFPATH/log

「7.2.2(3)　TP1/Server Baseのログサービス定義の内容」を参照

4

ユーザサービス定義

$DCCONFPATH/ユーザサーバ名※1

「7.2.2(4)　TP1/Server Baseのユーザサービス定義の内容」を参照

5

TP1/EEサービス定義

$DCCONFPATHまたは$DCUAPCONFPATH/任意※2

「7.2.3　TP1/EEサービス定義の内容」を参照

注※1

システム開始時に一緒に起動するユーザサーバの場合は，ユーザサービス構成定義（dcsvstart定義コマンド）で指定するユーザサーバ名と同じ名称を指定してください。

必要に応じて起動するユーザサーバの場合は，サーバ起動コマンド（dcsvstart）で指定するユーザサーバ名と同じ名称を指定してください。

なお，ほかの定義ファイルで使用しているファイル名は指定できません。

注※2

同じTP1/Server Baseで複数のTP1/EEを起動する場合，TP1/Server Base内で一意になる名称を指定してください。

7.2.2　TP1/Server Baseのシステムサービス定義の内容

TP1/EEを使用する場合，以降の表に示すTP1/Server Baseのシステムサービス定義を定義する必要があります。TP1/Server Baseのシステムサービス定義の詳細については，マニュアル「OpenTP1 システム定義」を参照してください。

TP1/EEを使用する場合のTP1/Server Baseのシステムサービス定義には，指定値が固定のオペランド，任意の値を指定するオペランド，および指定を省略できるオペランドがあります。

(1)　TP1/Server Baseのシステム共通定義の内容

TP1/EEを使用する場合のTP1/Server Baseのシステム共通定義の内容を，次の表に示します。表中のオペランドには，指定値に示す値を必ず入力してください。表中にないシステム共通定義のオペランドには，TP1/EEを含めたTP1/Server Baseの環境を考慮した値を任意に指定してください。

表7‒4　システム共通定義の内容

形式

オペランド／環境変数

定義内容

指定値

putenv

LANG

環境変数LANG

「6.3.6(4)　出力するメッセージログの言語種別の設定」を参照してください。

(2)　TP1/Server Baseのネームサービス定義の内容

TP1/EEを使用する場合のTP1/Server Baseのネームサービス定義の内容を，次の表に示します。表中のオペランドには，指定値に示す値を必ず入力してください。指定値の範囲内で，TP1/EEを実行するための最適値を任意に指定できます。表中にないネームサービス定義のオペランドは，TP1/EEには影響しないので，指定する必要はありません。

表7‒5　ネームサービス定義の内容

形式

オペランド／環境変数

定義内容

指定値

set

name_total_size

サービス情報領域の大きさ

〈符号なし整数〉((1〜32767))（単位：キロバイト）※1

name_cache_size

サービス情報キャッシュ領域の大きさ

〈符号なし整数〉((1〜32767))（単位：キロバイト）※2

max_socket_descriptors

ソケット用ファイル記述子の最大数

〈符号なし整数〉((32〜2032))※3

注※1

name_total_sizeオペランドには，システムサービス，TP1/EEを含むTP1/Server Baseの各ユーザサーバなどのサービス情報数を基に算出した値を指定してください。TP1/EEがネームサービス機能を使用する場合（TP1/EEのRPC関連定義のname_useオペランドにYを指定），通常のユーザサーバのサービス情報数に1を加算した値をTP1/EEのサービス情報数として計算してください。

注※2

TP1/EEがネームサービス機能を使用する場合（TP1/EEのRPC関連定義のname_useオペランドにYを指定），name_cache_sizeオペランドには，TP1/EEを含む自ノードから検索する，他ノードのサービス情報数を基に算出した値を指定してください。

注※3

TP1/EEがネームサービス機能を使用する場合（TP1/EEのRPC関連定義のname_useオペランドにYを指定），max_socket_descriptorsオペランドには，自ノードのTP1/EEの数を加算してください。

自ノードのユーザサーバ（TP1/EEを含む）と，他ノードのTP1/EEとの間でトランザクショナルRPCを行う場合，接続する他ノードのTP1/EEの数を加算してください。

(3)　TP1/Server Baseのログサービス定義の内容

TP1/EEを使用する場合のTP1/Server Baseのログサービス定義の内容を，次の表に示します。表中のオペランドには，指定値に示す値を必ず入力してください。表中にないログサービス定義のオペランドには，TP1/EEを含めたTP1/Server Baseの環境を考慮した値を任意に指定してください。

表7‒6　ログサービス定義の内容

形式

オペランド／環境変数

定義内容

指定値

putenv

TZ

タイムゾーン

JST-9

(4)　TP1/Server Baseのユーザサービス定義の内容

TP1/EEを使用する場合のTP1/Server Baseのユーザサービス定義の内容を，次の表に示します。表中のオペランドには，指定値に示す値を必ず入力してください。指定値に範囲があるオペランドは，範囲内でTP1/EEを実行するための最適値を任意に指定できます。表中にないユーザサービス定義のオペランドは，TP1/EEには影響しないので，指定する必要はありません。

なお，TP1/Server Baseのユーザサービス定義のうち，指定値が固定のオペランドおよび任意の値を指定するオペランドについては，サンプルファイルが/インストールディレクトリ/examples/tp1ee/conf/sbusrsmpディレクトリ下に提供されています。サンプルファイルは，TP1/Server Baseのバージョンが06-01以降の場合に使用できますので，必要に応じてご利用ください。

表7‒7　ユーザサービス定義の内容

形式

オペランド／環境変数

定義内容

指定値

set

service_group

サービスグループ名

〈1〜31文字の識別子〉※1

module

このサービスグループを実行する実行形式プログラム名

〈1〜14文字の識別子〉※2

service

このサービスグループに属するサービス名とそのサービスを提供するエントリポインタ名の組み合わせ

tp1_Enterprise_Option_service=tp1ee

nice

プロセスの優先順位の変更

〈符号なし整数〉((0〜39))

parallel_count

常駐プロセス数と最大プロセス数

1

hold

UAPが異常終了した場合にサービスグループまたはサービスを閉塞するかどうかを指定

N

hold_recovery

サービスグループまたはサービスの閉塞状態をプロセスの回復時に引き継ぐかどうかを指定

N

message_buflen

最大メッセージ長

1024（単位：バイト）

message_store_buflen

メッセージ格納プール長

1024（単位：バイト）

trn_expiration_time

トランザクションブランチの限界経過時間

0（単位：秒）

trn_expiration_time_suspend

トランザクションブランチの時間監視の範囲

N

watch_next_chain_time

連鎖RPC間隔監視時間

0（単位：秒）

atomic_update

サービスをトランザクションとして実行するかどうかを指定

N

receive_from

スケジュールキュー，またはUNIXドメインもしくはインターネットドメインを使用するかどうかを指定

queue

uap_trace_max

UAPトレース格納最大数

0

term_watch_time

連続異常終了限界経過時間

1（単位：分）

mcf_jnl_buff_size

MCFのジャーナルバッファの大きさ

4096（単位：バイト）

type

このサービスグループの種別

other

critical

UAPが異常終了した場合のシステムの処置

Y｜N

trn_cpu_time

トランザクションブランチが同期点処理までに使用できるCPU時間

0（単位：秒）

service_hold

サービス単位に閉塞管理するかどうかを指定

N

service_priority_control

サービス要求単位の優先順位に従ってスケジュールするかどうかを指定

N

trf_put

トランザクションが出力したジャーナルをトランザクションリカバリジャーナルファイルへ出力するかどうかを指定

N

trn_statistics_item

トランザクションブランチの統計情報項目

nothing

node_down_restart

ユーザサーバを自動起動するかどうかを指定

Y｜N

rpc_response_statistics

レスポンス統計情報を取得するかどうかを指定

N

cancel_normal_terminate

dcsvstopコマンドによる正常終了を抑止するかどうかを指定

N

prc_abort_signal

サーバのアボート用シグナル番号

3

max_socket_descriptors

ソケット用ファイル記述子の最大数

〈符号なし整数〉128以上

max_open_fds

UAPプロセスでアクセスするファイルおよびパイプの最大数

〈符号なし整数〉128以上※3

service_term_watch_time

連続サービス異常終了限界経過時間

0（単位：分）

xat_osi_usr

OSI TP通信用のスタブを使用するかどうかを指定

N

watch_time

RPCの応答に対する最大待ち時間

180（単位：秒）

rpc_trace

RPCトレースを取得するかどうかを指定

N

schedule_method

ユーザサーバのスケジューリング方式

msgque

mcf_spp_oj

SPPでのOJの履歴情報を取得するかどうかを指定

N

adm_message_option

メッセージ出力指定

〈1けたの16進数〉

trn_watch_time

トランザクション同期点処理時の最大通信待ち時間

120（単位：秒）

trn_limit_time

トランザクションブランチ最大実行可能時間

0（単位：秒）

trn_rollback_response_receive

ロールバック完了通知を受信するかどうかを指定

N

trn_partial_recovery_type

UAP障害時のトランザクション同期点処理方式

type1

rpc_destination_mode

サービスの送信先を決定する方法

definition

rpc_rap_auto_connect

UAPとリモートAPI制御プロセスの間のコネクションを自動的に管理するかどうかを指定

N

rpc_rap_inquire_time

リモートAPI機能を使用して要求するサービスの問い合わせ間隔最大時間

0（単位：秒）

rpc_request_cancel_for_timedout

クライアントUAPの応答待ち時間をサーバに意識させるかどうかを指定

N

status_change_when_terming

次回再開始時に最終的な状態の変化を反映するかどうかを指定

Y

service_expiration_time

サービス関数開始から終了までの実行監視時間

0（単位：秒）

multi_schedule

マルチスケジューラ機能を使用してスケジューリングするかどうかを指定

N

make_queue_on_starting

非常駐のサービスグループに割り当てるスケジュールキューをサーバ起動時に割り当てるかどうかを指定

N

polling_control_data

一時クローズ処理要求の到着を検査するかどうかを指定

N

groups

サービスグループのグループアクセスリストを設定

〈符号なし整数〉((0〜4294967294))

loadlevel_message

負荷レベル通知メッセージを出力するかどうかを指定

N

ipc_backlog_count

コネクション確立要求を格納するキューの長さ

0

schedule_delay_abort

スケジュール遅延時にシステムダウンするかどうかを指定

N

rap_autoconnect_con_error_msg

APIの代理実行要求時，rapサーバとのコネクションが切断されていた場合に，エラーメッセージを出力するかどうかを指定

N

setrlimit_nofile※⁴

プロセスがオープンできるファイル識別子の上限値

〈符号なし整数〉((1024〜32767))

putenv

任意

環境変数名　環境変数値

〈文字列〉

EEDEFFILE

TP1/EEサービス定義ファイル名

〈文字列〉※⁵

EETHDUNALIGN

アドレス境界不正検出時の動作を指定（Linux版限定）

《N》｜O※⁶

PDSWAITTIME

トランザクション処理中のサーバの最大待ち時間

〈符号なし整数〉((0〜65535))（単位：秒）

PDSWATCHTIME

トランザクション処理以外のサーバの最大待ち時間

〈符号なし整数〉((0〜65535))（単位：秒）

PDXAMODE

トランザクションの移行機能

0

EEPARM1※⁷

TP1/EEデバッグ用のパラメタ

〈8けたの符号なし整数〉

dcputenv

任意

環境変数名　環境変数値

〈文字列〉

EEDEFFILE

TP1/EEサービス定義ファイル名

〈文字列〉※⁵

EETHDUNALIGN

アドレス境界不正検出時の動作を指定（Linux版限定）

《N》｜O※⁶

PDSWAITTIME

トランザクション処理中のサーバの最大待ち時間

〈符号なし整数〉((0〜65535))（単位：秒）

PDSWATCHTIME

トランザクション処理以外のサーバの最大待ち時間

〈符号なし整数〉((0〜65535))（単位：秒）

PDXAMODE

トランザクションの移行機能

0

注※1

service_groupオペランドに指定するサービスグループ名は，ネットワークで接続されるすべてのOpenTP1システムの中で一意になるように指定してください。TP1/EEのプロセス関連定義のservice_groupオペランドの指定値と同じサービスグループ名は指定しないでください。

注※2

moduleオペランドには，このサービスグループを実行するUAP（TP1/EE）の実行形式ファイル名を指定します。この実行形式ファイルは，TP1/Server Baseのプロセスサービス定義のprcsvpath定義コマンドで指定したディレクトリにあります。

注※3

max_open_fds設定値が次の計算式の値より大きくなるように設定してください。満たさなければファイルディスクリプタ数の関係でTP1/EEの起動ができなくなる場合があります。

（MCPのUDPスレッドグループ数（MCP構成定義eemcpthdgrp定義数）×2）
＋（MCPのTCP（server）のユニークアドレス数（MCP構成定義での
   サーバ型コネクション（MCP構成定義eemcpcn -yのmodeオペランドで
   serverを指定）であるeemcpcn定義の-rオプションに指定した
   IPアドレスまたはホスト名とポート番号の組み合わせ数
   （受信スレッド数））×3）＋（mysvgdef定義数）
＋XTCのUDP数（XTCサービス定義myudpsnddefオペランドの
   -pオプションに指定したポート番号数またはXTCサービス定義
   myudpsnddefオペランドの-pオプション指定値
＋XTCサービス定義myudprcvdefオペランドの-pオプションに指定した
   ポート番号数）＋30

設定可能なmax_open_fds定義の上限値に関しては，OpenTP1のマニュアルおよび関連ドキュメントを参照してください。

※4

setrlimit_nofile=プロセスがオープンできるファイル識別子の上限値　　〜〈符号なし整数〉((1024〜32767))

プロセスfork後にsetrlimitシステムコールでRLIMIT_NOFILEのハードリミットを指定値で設定します。

この指定を省略した場合は，setrlimitシステムコールでRLIMIT_NOFILEのハードリミットを設定しません。TP1/SBを起動しているマシンの設定値に依存します。

このオペランド指定値がRLIMIT_NOFILEのソフトウェアリミットよりも小さい場合，KFCA00722-Eメッセージを出力します。また，setrlimitシステムコールでエラーが発生した場合，KFCA00700-Eメッセージを出力します。

注※5

環境変数名にEEDEFFILEを，環境変数の値にTP1/EEサービス定義ファイル名を指定してください。EEDEFFILEで指定したTP1/EEサービス定義ファイル名と，DCCONFPATHまたはDCUAPCONFPATHで指定したTP1/EEサービス定義ファイルの絶対パス名との文字列の合計が，1023文字以下になるように，TP1/EEサービス定義ファイル名を指定してください。

注※6

Nを指定すると，アドレス境界不正検出時のsyslogメッセージ出力を抑止します。

Oを指定すると，OSの指定値で動作します。OSのデフォルト値では，アドレス境界不正検出時のsyslogメッセージを出力し，処理を続行します。

注※7

環境変数名にEEPARM1を指定し，環境変数の値に次の値を指定します。複数の指定値を有効にする場合は，符号なし整数の和で指定します。

00000001：処理スレッド単位での，COBOL用メモリ管理機能の使用状況メッセージの表示

処理スレッド単位でCOBOL用メモリ管理機能を使用する（TP1/EEサービス定義のmemory_cobol_area_thd_sizeオペランドの指定あり）場合，システム終了時にKFSB85102-Iメッセージで最も大きなプールを使用した処理スレッドのプール利用率を表示します。memory_cobol_area_thd_sizeオペランドの指定がない場合は，指定を無視します。

00000002：UAP履歴情報取得機能のテストモードの使用

00000004：SDBハンドラ機能のDML実行失敗メッセージの表示

SDBハンドラ機能を使用する（SDBハンドラ関連定義のsdh_useオペランドにYを指定）場合に，SDBハンドラ機能の関数の延長で構造型データベースに要求したDMLが失敗すると，KFSB54304-Eメッセージを表示します。sdh_useオペランドの指定がない場合，およびsdh_useオペランドにNを指定した場合は，指定を無視します。

指定値00000002，および00000004の詳細については，TP1/FSPの関連ドキュメントを参照してください。

7.2.3　TP1/EEサービス定義の内容

TP1/EEサービス定義の内容を，以降の表に示します。なお，TP1/EEサービス定義の詳細については，「8.　TP1/EEサービス定義の詳細」を参照してください。

(1)　プロセス関連定義の内容

プロセス関連定義の内容を，次の表に示します。

表7‒8　プロセス関連定義の内容

形式

オペランド

定義内容

指定値

set

service_group

サービスグループ名

〈1〜31文字の識別子〉

service_hold

UAP異常終了時のサービス閉塞

《Y》｜N

thread_no

通常処理スレッド数

〈符号なし整数〉((1〜999))《10》

rpc_cmtsend_retry

障害発生時に別処理スレッドで再送信するか送信障害トランザクションを起動するかを指定

Y｜《N》

reserve_thread_no

予備処理スレッド数

〈符号なし整数〉((0〜998))《0》

reserve_start_pce_no

予備処理スレッド起動処理キュー数

〈符号なし整数〉((0〜1000))《0》

cmd_port

コマンド受信用のポート番号

〈符号なし整数〉((5001〜65535))《20345》

uap_stack_size

UAP実行に必要なスタックサイズ

〈符号なし整数〉((0〜65535))《0》（単位：キロバイト）

other_lib_stack_size

他製品との連携時に必要なスタックサイズ

〈符号なし整数〉((0〜65535))《0》（単位：キロバイト）

uapabend_downmode

UAP異常発生時のダウン種別

《P》｜S

clock_time_interval

イベント監視インタバル間隔時間

100｜250｜《500》｜1000（単位：ミリ秒）

term_watch_time

連続異常終了限界経過時間

〈符号なし整数〉((0〜65535))《30》（単位：分）

service_hold_watch_use

サービス異常終了回数を監視してサービスを閉塞するかどうかを指定

Y｜《N》

service_hold_watch_procdown

連続サービス異常終了の監視情報を再開始時に継続するかどうかを指定

《Y》｜N

service_term_watch_time

連続サービス異常終了限界経過時間

〈符号なし整数〉((0〜65535))《0》（単位：分）

max_descriptors

ファイル識別子の最大数

〈符号なし整数〉((400〜32767))《400》

cobol_use_flag

UAPにCOBOL言語を使用するかどうかを指定

《Y》｜N

cobol_lang※

使用するCOBOL製品

《85》｜2002

cobol_uap_cblend

UAP実行前に，COBOL実行空間を毎回再生成するかどうかを指定

Y｜《N》

execap_permission_time

時刻指定のタイマトランザクション起動要求時の先行許容時間，および後退許容時間

〈符号なし整数〉((1〜1439))《1080，60》（単位：分）

thd_hungup_time

スレッドハングアップ監視時間

〈符号なし整数〉((0〜65535))《10》（単位：秒）

thd_trb_hungup_time

トラブルシュートで使用するスレッドのスレッドハングアップ監視時間

〈符号なし整数〉((0〜65535))《60》（単位：秒）

proc_hungup_time

TP1/EEプロセスハングアップ監視時間

〈符号なし整数〉((0〜65535))《10》（単位：秒）

dbq_use

DBキュー機能を使用するかどうかを指定

Y｜《N》

dbq_obs_use

オンラインバッチ機能を使用するかどうかを指定

Y｜《N》

recover_thread_no

回復スレッド数

〈符号なし整数〉((1〜64))《2》

call_cmd_srvgroup

運用コマンド実行サービスグループ名

〈1〜31文字の識別子〉

call_cmd_service

運用コマンド実行サービス名

〈1〜31文字の識別子〉

call_cmd_time

運用コマンド実行サーバ応答監視時間

〈符号なし整数〉((0〜65535))《30》（単位：秒）

fil_filesystem_no

TP1EEファイルシステム総数

〈符号なし整数〉((1〜4096))《2》

stay_watch_queue_rate

オンライン打ち切り監視範囲処理キュー滞留率

〈符号なし整数〉((1〜99))（単位：%）

stay_watch_down_rate

オンライン打ち切り係数

〈符号なし整数〉((1〜99))（単位：%）

stay_watch_check_interval

処理キュー滞留監視間隔時間

〈符号なし整数〉((10〜180))（単位：秒）

trb_stc_use

統計情報を取得するかどうかを指定

Y｜《N》

trb_uap_trace_file_out

UAPトレース情報をUAPトレースファイルに出力するかどうかを指定

Y｜《N》

initialize_sync

起動順序のシリアル化機能を使用するかどうかを指定

Y｜《N》

sys_dba_waittime

システム用トランザクションの処理監視時間に加算するDBアクセス時間

〈符号なし整数〉((0〜65535))《0》（単位：秒）

xtc_use

XTCを使用するかどうかを指定

Y｜《N》

xdb_use

XDBを使用するかどうかを指定

Y｜《N》

mcp_use

MCPを使用するかどうかを指定

Y｜《N》

fsp_use

TP1/FSPを使用するかどうかを指定

Y｜《N》

thd_mutex_attr_adaptive（Linux版限定）

mutexの属性としてPTHREAD_MUTEX_ADAPTIVE_NPを設定するかどうかを指定

Y｜《N》

thd_backtrace_msg（Linux版限定）

障害検知時のバックトレースメッセージ出力有無

《Y》｜N

thd_cpuinfo_msg（Linux版限定）

CPU時間情報メッセージ出力有無

《Y》｜N

descriptors_expanse_use（Linux版限定）

ディスクリプタ値の拡張

Y｜《N》

注※

OSがLinux (IA32)の場合，COBOL言語を使用したUAPは使用できません。また，OSがLinux (EM64T)の場合，必ず2002を指定してください。

(2)　メモリ関連定義の内容

メモリ関連定義の内容を，次の表に示します。

表7‒9　メモリ関連定義の内容

形式

オペランド

定義内容

指定値

set

pce_no

サービス処理キュー数

〈符号なし整数〉((100〜500000))《2000》

system_user_area

プロセス管理テーブルユーザエリアサイズ

〈符号なし整数〉((0〜16777216))《0》（単位：バイト）

system_user_area_mb

プロセス管理テーブルユーザワークエリアサイズ（ユーザSAT）

〈符号なし整数〉((0〜16384))（単位：メガバイト）

thread_user_area

スレッド対応インタフェースユーザエリアサイズ

〈符号なし整数〉((0〜16777216))《0》（単位：バイト）

thread_user_area_mb

スレッド対応インタフェースユーザワークエリアサイズ（ユーザIFA）

〈符号なし整数〉((0〜16384))（単位：メガバイト）

system_work_size

システムワーク領域最大サイズ

〈符号なし整数〉((100〜1048576))《450》（単位：キロバイト）

user_work_size

ユーザワーク領域最大サイズ

〈符号なし整数〉((0〜1048576))《100》（単位：キロバイト）

max_mem_size

TP1/EEプロセスで確保するメモリの最大サイズ

〈符号なし整数〉((1〜2000000000))（単位：バイト）

max_mem_size_mb

TP1/EEプロセスで確保するメモリの最大サイズ

〈符号なし整数〉((1〜4194304))（単位：メガバイト）

memory_alert_rate

セグメント使用率規定値超過メッセージ出力時の使用割合

〈符号なし整数〉((0〜100))《80》（単位：%）

memory_leak_message

UAP確保メモリの解放漏れ警告メッセージを出力するかどうかを指定

《Y》｜N｜F

time_message_size

タイマトランザクション登録時に使用する最大データサイズ

〈符号なし整数〉((0〜16777216))（単位：バイト）

time_message_no

タイマトランザクション登録時に使用する最大データ数

〈符号なし整数〉((0〜65535))

icb_no

タイマトランザクション登録最大数

〈符号なし整数〉((0〜65535))《1000》

max_message_size

メッセージ引き渡しエリアの最大サイズ

〈符号なし整数〉((1000〜16777216))《33000》（単位：バイト）

max_outmessage_size

メッセージ応答エリアの最大サイズ

〈符号なし整数〉((1000〜16777216))《33000》（単位：バイト）

recv_message_buf_size

受信バッファサイズ

〈符号なし整数〉((1000〜66000))《33000》（単位：バイト）

recv_message_buf_cnt

受信バッファ面数

〈符号なし整数〉((1〜2000000))《128》

send_message_buf_size

送信バッファサイズ

〈符号なし整数〉((1000〜66000))《33000》（単位：バイト）

send_message_buf_cnt

送信バッファ面数

〈符号なし整数〉((1〜2000000))《128》

dbq_recv_message_buf_cnt

DBキュー機能で使用する受信バッファ面数

〈符号なし整数〉((1〜240000))《128》

dbq_send_message_buf_cnt

DBキュー機能で使用する送信バッファ面数

〈符号なし整数〉((1〜240000))《128》

dbq_max_message_size

DBキュー機能で使用する最大メッセージサイズ

〈符号なし整数〉((1000〜8388608))《33000》（単位：バイト）

dbq_use_buf_cnt

DBキュー機能で使用する最大バッファ面数

〈符号なし整数〉((1〜240000))《128》

memory_cobol_area_size

COBOL用メモリ管理機能でプロセス単位に確保するプールサイズ

〈符号なし整数〉((1〜1048576))（単位：キロバイト）

memory_cobol_area_thd_size

COBOL用メモリ管理機能で処理スレッド単位に確保するプールサイズ

〈符号なし整数〉((1〜1048576))（単位：キロバイト）

(3)　RPC関連定義の内容

RPC関連定義の内容を，次の表に示します。

表7‒10　RPC関連定義の内容

形式

オペランド

定義内容

指定値

set

ipc_sendbuf_size

TCP/IPの送信バッファサイズ

〈符号なし整数〉((8192〜1048576))《8192》（単位：バイト）

ipc_recvbuf_size

TCP/IPの受信バッファサイズ

〈符号なし整数〉((8192〜1048576))《8192》（単位：バイト）

ipc_backlog_count

コネクション確立要求を格納するキューの長さ

〈符号なし整数〉((0〜4096))《0》

ipc_tcpnodelay

Nagleアルゴリズムを無効にするかどうかを指定

Y｜《N》

service_group_no

サービスグループ名の最大数

〈符号なし整数〉((2〜32767))《2》

hostname_no

ホスト名の最大数

〈符号なし整数〉((2〜32767))《2》

socket_no

ソケット用ファイル記述子の最大数

〈符号なし整数〉((32〜20000))《32》

fragment_buf_no

フラグメントメッセージ用バッファ面数

〈符号なし整数〉((0〜65535))《0》

rpc_router_retry_count

TCP/IPバッファ不足発生時のリトライ回数

〈符号なし整数〉((0〜255))《3》

rpc_router_retry_interval

TCP/IPバッファ不足発生時のリトライ間隔

〈符号なし整数〉((1〜200))《35》（単位：ミリ秒）

rpc_connect_timer

コネクション確立監視時間

〈符号なし整数〉((1〜60))《10》（単位：秒）

rpc_multi_tp1_in_same_host

同一グローバルドメインとして運用しているかどうかを指定

Y｜《N》

rpc_connect_errmsg

コネクション確立失敗時にメッセージを出力するかどうかを指定

《Y》｜N

rpc_connect_stopmsg

コネクション切断時にメッセージを出力するかどうかを指定

《Y》｜N

rpc_support_errmsg

未サポートメッセージ受信時にメッセージを出力するかどうかを指定

《Y》｜N

rpc_first_connect_errmsg

コネクション確立後の最初のメッセージの受信失敗時にメッセージを出力するかどうかを指定

Y｜《N》

rpc_firstmsg_recv_timer

コネクション確立の受け付けから最初のメッセージ受信までの監視時間

〈符号なし整数〉((0〜600))《0》（単位：秒）

rpc_first_connect_errmsg_dbq

コネクション確立後の最初のDBキューイベント通知メッセージの受信失敗時にメッセージを出力するかどうかを指定

Y｜《N》

rpc_firstmsg_recv_timer_dbq

コネクション確立の受け付けから最初のDBキューイベント通知メッセージ受信までの監視時間

〈符号なし整数〉((0〜600))《0》（単位：秒）

node_id

ノード識別子

〈4文字の識別子〉

watch_time

最大応答待ち時間

〈符号なし整数〉((0〜65535))《180》（単位：秒）

rpc_reply_con_max_cnt

サービス応答用コネクションの最大数

〈符号なし整数〉((32〜20000))《256》

rpc_reply_con_cnt

接続先プロセスごとのサービス応答用コネクションの最大数

〈符号なし整数〉((1〜20000))《2》

rpc_reply_proc_max_cnt

サービス応答用コネクションの接続先プロセス最大数

〈符号なし整数〉((32〜20000))《128》

rpc_reply_suspend_cnt

RPC応答メッセージ送信の同時抑止最大数

〈符号なし整数〉((0〜32767))《128》

rpc_reply_suspend_time

RPC応答メッセージ送信の抑止最大時間

〈符号なし整数〉((0〜65535))《180》（単位：秒）

rpc_reply_suspend_recover

RPC応答のトランザクションまたがり送信機能をTP1/EE再開始時に引き継ぐかどうかを指定

《Y》｜N

rpc_reply_suspend_autosend

抑止中のRPC応答の抑止状態を自動的に解除してRPC応答を送信するかどうかを指定

Y｜《N》

rap_listen_port

リモートAPI受信用のポート番号

〈符号なし整数〉((5001〜65535))

rap_inquire_time

問い合わせ間隔最大時間

〈符号なし整数〉((0〜1048575))《180》（単位：秒）

rap_inquire_timeout_message

リモートAPI要求の最大待ち時間を超えた場合にエラーメッセージを出力するかどうかを指定

《Y》｜N

rpc_rap_remaincon_endwait

接続中のrapクライアントがある場合のTP1/EEの終了処理の動作を指定

Y｜《N》｜F

rap_msg_output_interval

rapクライアント数表示メッセージの出力間隔

〈符号なし整数〉((0〜3600))《180》（単位：秒）

rap_max_client

同時接続可能なrapクライアント数

〈符号なし整数〉((128〜20000))《256》

rap_max_server_rate

同時にrap処理できる処理スレッド数の割合

〈符号なし整数〉((1〜100))《40》（単位：%）

rap_notify

rapクライアントマネジャに対して起動通知を送信するかどうかを指定

Y｜《N》

rap_client_manager_node

rapクライアントが存在するOpenTP1システムのホスト名

〈1〜255文字のホスト名〉

rapクライアントの存在するOpenTP1システムのrapクライアントマネジャのポート番号

〈符号なし整数〉((1〜65535))

rpc_rap_inquire_time

リモートAPI機能を使用して要求するサービスの問い合わせ間隔最大時間

〈符号なし整数〉((0〜1048575))《0》（単位：秒）

rpc_rap_connection_count

常設コネクション最大数

〈符号なし整数〉((1〜800))《16》

rap_client_manager_port

rapクライアントマネジャ機能での受信用ポート番号

〈符号なし整数〉((5001〜65535))

rap_listen_inf

rapリスナーを起動するOpenTP1ノードのノード識別子

〈4文字の識別子〉

rapリスナーのポート番号

〈符号なし整数〉((5001〜65535))

リモートAPI機能によるサービスの受信口となるホスト名

〈1〜255文字のホスト名〉

リモートAPI機能によるサービスの受信口となるポート番号

〈符号なし整数〉((1〜65535))

rpc_rap_watch_time

rapリスナーからの最大応答待ち時間

〈符号なし整数〉((0〜65535))（単位：秒）

rap_client_hostname

rapクライアントのホスト名

ホスト名

rpc_reply_tp1mode

TP1/Server Base互換のRPC応答モードかどうかを指定

《Y》｜N

rpc_reply_tp1mode_down

ダウン時のRPCエラー応答がTP1/Server Base互換のRPC応答モードかどうかを指定

《Y》｜N｜J

rpc_replymsg_save

サービス関数で設定した応答データの内容をスレッド間で引き継ぐかどうかを指定

《Y》｜N

ipc_sendbuf_size_dbq

TCP/IPの送信バッファサイズ

〈符号なし整数〉((1024〜1048576))《1024》（単位：バイト）

ipc_recvbuf_size_dbq

TCP/IPの受信バッファサイズ

〈符号なし整数〉((1024〜1048576))《1024》（単位：バイト）

ipc_backlog_count_dbq

コネクション確立要求を格納するキューの長さ

〈符号なし整数〉((0〜4096))《0》

ipc_tcpnodelay_dbq

Nagleアルゴリズムを無効にするかどうかを指定

Y｜《N》

rpc_destination_mode

サービスの要求先の決定方法を指定

namdonly｜namd｜《definition》｜definitiononly

rpc_retry

RPCをリトライするかどうかを指定

Y｜《N》

rpc_retry_count

サービス要求送信リトライ回数最大値

〈符号なし整数〉((1〜3600))《18》

rpc_retry_interval

サービス要求送信リトライ間隔

〈符号なし整数〉((1〜3600))《10》（単位：秒）

name_use

ネームサービスを使用するかどうかを指定

《Y》｜N

name_cache_size

サービス情報キャッシュ領域のサイズ

〈符号なし整数〉((1〜32768))《16》（単位：キロバイト）

rpc_nam_watch_time

ネームサーバからの最大応答待ち時間

〈符号なし整数〉((0〜65535))《60》（単位：秒）

rpc_nam_retry_count

ネームサーバへの要求失敗時のリトライ回数

〈符号なし整数〉((0〜64))《5》

rpc_nam_retry_interval

ネームサーバへの要求失敗時のリトライ間隔

〈符号なし整数〉((1〜60))《5》（単位：秒）

rpc_nam_use_time

キャッシュの有効期限

〈符号なし整数〉((1〜65535))《300》（単位：秒）

rpc_nam_reserve_count

キャッシュ自動同期の保留回数

〈符号なし整数〉((0〜32767))《0》

rpc_nam_reserve_time

キャッシュ自動同期の保留期間

〈符号なし整数〉((0〜65535))《0》（単位：秒）

rpc_nam_eject_rate

キャッシュ追い出し率

〈符号なし整数〉((0〜50))《0》（単位：%）

rpc_name_service_extend

ネームサービスで管理するサーバUAPの取得数を拡張するかどうか

〈符号なし整数〉((0，1))《0》

rpc_loadbalance

ノード間負荷バランス機能を使用するかどうかを指定

《Y》｜N

rpc_transfer_othersvg

他サービスグループへのRPCメッセージを，ノード間負荷バランス機能を使用して転送するかどうかを指定

《Y》｜N

rpc_myproc_first

自ノードでのサービス要求の処理を優先させるかどうかを指定

《Y》｜N

loadcheck_interval

負荷レベル監視間隔

〈符号なし整数〉((0〜65535))《30》(単位：秒)

loadcheck_type

負荷レベルの決定方法を指定

《auto》｜rate｜count

levelup_queue_rate

このサービスグループの負荷レベルを判断する処理キュー滞留率（up）

〈符号なし整数〉((1〜100))（単位：%）

leveldown_queue_rate

このサービスグループの負荷レベルを判断する処理キュー滞留率（down）

〈符号なし整数〉((0〜99))《U1÷2，(U1+U2)÷2》（単位：%）

levelup_queue_count

このサービスグループの負荷レベルを判断する処理キュー滞留数（up）

〈符号なし整数〉((1〜500000))

leveldown_queue_count

このサービスグループの負荷レベルを判断する処理キュー滞留数（down）

〈符号なし整数〉((0〜499999))《U1÷2，(U1+U2)÷2》

scd_retry_of_comm_error

RPCメッセージ転送のリトライ回数

〈符号なし整数〉((0〜128))《0》

loadlevel_message

負荷レベルの変更があった場合にメッセージを出力するかどうかを指定

Y｜《N》｜A

multi_schedule

TP1/Server Baseのマルチスケジューラ機能のスケジューラデーモンが起動しているノードを優先的に選択するかどうかを指定

Y｜《N》

rpc_reply_errtrnr

ERRTRNRによるRPC応答メッセージ送信機能を使用するかどうかを指定

Y｜《N》

rpc_reply_errtrnr_cnt

ERRTRNRによるRPC応答メッセージ送信機能の同時使用最大数

〈符号なし整数〉((32〜2000))《128》

rpc_tcpsend_con_max_cnt

TCP/IP共有送信用コネクションの最大数

〈符号なし整数〉((1〜20000))

rpc_tcpsend_con_cnt

接続先プロセスごとのTCP/IP共有送信用コネクションの最大数

〈符号なし整数〉((1〜20000))

rpc_tcpsend_proc_max_cnt

TCP/IP共有送信用コネクションの接続先プロセス最大数

〈符号なし整数〉((1〜20000))

rpc_connect_unixdomain

UNIXドメインを使用してコネクションを確立するかどうかを指定

《Y》｜N

rpc_reply_port_auto

RPC応答メッセージ受信用のポート番号にポート番号自動割り当て機能を使用するかどうかを指定

Y｜《N》

rpc_nowait_cnt

非同期応答型RPCの同時要求メッセージの最大数

〈符号なし整数〉((0〜65535))《0》

rpc_extend_function

RPCサービスの機能拡張レベル

《00000000》｜00000004｜00000008

rpc_tcp_linetrace

RPCの回線トレース情報の取得量の変更

《00000000》｜00000020

rpc_rap_linetrace

リモートAPI機能使用時の回線トレース情報の取得量の変更

《00000000》｜00000020

rpc_extend_sb_node_id

TP1/Server Baseのノード識別子を通知するかどうかを指定

Y｜《N》

rpc_keepalive_use

ソケットオプション「SO_KEEPALIVE」を使用するかどうかを指定

Y｜《N》

rpc_keepalive_time

keep-aliveプローブを送信するまでの時間（Linux版限定）

〈符号なし整数〉((0〜7200))《0》（単位：秒）

rpc_keepalive_interval

keep-aliveプローブを送信する間隔（Linux版限定）

〈符号なし整数〉((0〜180))《0》（単位：秒）

rpc_keepalive_count

keep-aliveプローブを送信する回数（Linux版限定）

〈符号なし整数〉((0〜10))《0》

rpc_nam_conn_check

RPCメッセージ用コネクションのチェック機能を使用するかどうかを指定

Y｜《N》

rpc_nam_check_time

コネクション確立先の起動時刻を取得する間隔

〈符号なし整数〉((0〜3600))《5》（単位：秒）

rpc_nam_check_num

一度に確認するコネクション確立先数

〈符号なし整数〉((1〜512))《5》

rpc_request_cancel_for_timedout

ee_rpc_call関数の応答待ち時間をサーバUAPに意識させるかどうかを指定

Y｜《N》

rpc_request_cancel_for_server

サーバ側でクライアントUAPの応答待ち時間を意識して処理するかどうかを指定

《Y》｜N

rpc_reply_sockctl_use

送受信用コネクションの一時クローズ機能の使用有無

Y｜《N》

rpc_reply_sockctl_highwater

送受信用コネクションの一時クローズ処理開始数の割合，非対象数の割合

〈符号なし整数〉((0〜100))《0》

rpc_recv_sockctl_use

受信用コネクションの一時クローズ機能の使用有無

Y｜《N》

rpc_recv_sockctl_highwater

受信用コネクションの一時クローズ処理開始数の割合，非対象数の割合

〈符号なし整数〉((0〜100))《0》

rpc_conn_recv_check_use

送信用コネクションの受信監視を行うかどうかを指定

Y｜《N》

rpc_conn_recv_check_interval

送信用コネクションの受信監視を行う間隔

〈符号なし整数〉((1〜3600))《120》（単位：秒）

rpc_recivingconnect_stopmsg_dbq

受信中にコネクション切断検知した場合にメッセージ出力するかどうか

《Y》｜N

rpc_connect_conflict_timer

Cosminexusへの送信処理が競合した場合の，送信開始までの最大待ち時間

〈符号なし整数〉((0〜1048576))《200》（単位：ミリ秒）

ipc_notify_response_host

応答電文受信用IPアドレスを通知するかどうかを指定

Y｜《N》

(4)　ユーザサービス関連定義の内容

ユーザサービス関連定義の内容を，次の表に示します。

表7‒11　ユーザサービス関連定義の内容

形式

オペランド／コマンド

オプション

定義内容

指定値

set

service

サービス名とエントリポインタ名の組み合わせ，および同時処理限界数

名称：〈1〜31文字の識別子〉

数：〈符号なし整数〉((1〜255))《1》

dbq_service

DBキュー機能のサービス名とエントリポインタ名の組み合わせ

〈1〜31文字の識別子〉

dbq_obs_service

オンラインバッチ機能のサービス名とエントリポインタ名の組み合わせ

〈1〜31文字の識別子〉

errtrn1

ERRTRN1を起動するエントリポインタ名

〈1〜31文字の識別子〉

errtrn2

ERRTRN2を起動するエントリポインタ名

〈1〜31文字の識別子〉

errtrn3

ERRTRN3を起動するエントリポインタ名

〈1〜31文字の識別子〉

errtrn4

ERRTRN4を起動するエントリポインタ名

〈1〜31文字の識別子〉

errtrns

ERRTRNSを起動するエントリポインタ名

〈1〜31文字の識別子〉

errtrnr

ERRTRNRを起動するエントリポインタ名

〈1〜31文字の識別子〉

system_start_mi

プロセス初期化トランザクションを起動するエントリポインタ名

〈1〜31文字の識別子〉

system_end_me

プロセス終了トランザクションを起動するエントリポインタ名

〈1〜31文字の識別子〉

forbid_draw_service

処理キューを引き出し禁止にするかどうかを指定

Y｜《N》

module

UAP共用ライブラリ名

〈510文字以内のパス名〉

module_open_flag

UAP共用ライブラリのシンボル利用可否

≪LOCAL≫｜GLOBAL

uap_exchange_use

UAP共用ライブラリ入れ替え機能を使用するかどうかを指定

Y｜《N》

コマンド

service_attr

-v

サービス名

〈1〜31文字の識別子〉

-x

トランザクション種別

〈2文字〉

-a

トランザクション処理監視時間

〈符号なし整数〉((0〜65535))《トランザクション関連定義で指定したトランザクション処理監視時間》（単位：秒）

-c

サービスを自動的に閉塞するかどうかを指定

なし。

-d

サービス引き出し禁止指定

Y｜N《forbid_draw_service指定値》

(5)　メッセージログ関連定義の内容

メッセージログ関連定義の内容を，次の表に示します。

表7‒12　メッセージログ関連定義の内容

形式

オペランド

定義内容

指定値

set

log_file_size

メッセージログファイルの最大容量

〈符号なし整数〉((10〜32767))《1024》（単位：キロバイト）

log_file_max

メッセージログファイルの最大ファイル数

〈符号なし整数〉((3〜10))《3》

log_syslog_out

syslogへのメッセージ出力レベル

〈符号なし整数〉((0〜6))《3》

log_usermsg_console

ee_logprint()/CBLEELOG(‘PRINT’)で出力するメッセージを標準出力に出力するかどうかを指定

all｜《api》

log_syslog_prcid

syslog出力時にプロセスIDを付けるかどうかを指定

Y｜《N》

log_base_infid

syslog出力およびメッセージの標準出力時に付けるTP1/EE識別子

〈2文字の識別子〉

log_syslog_prcno

syslog出力時にメッセージ通番を付けるかどうかを指定

Y｜《N》

log_syslog_date

syslog出力時に日付を付けるかどうかを指定

Y｜《N》

log_syslog_time

syslog出力時に時刻を付けるかどうかを指定

Y｜《N》

log_syslog_service_name

syslog出力時にサービス名を付けるかどうかを指定

Y｜《N》

log_syslog_central_no

syslog出力時に中央処理通番を付けるかどうかを指定

Y｜《N》

log_syslog_id

syslog出力時にOpenTP1識別子を付けるかどうかを指定

Y｜《N》

log_syslog_elist

syslog失敗リストのエレメント数

〈符号なし整数〉((0〜65536))《100》

log_msg_console

標準出力および標準エラー出力の出力設定があるメッセージを標準出力および標準エラー出力に出力するかどうかを指定

《Y》｜N

log_msg_allno

メッセージの標準出力時にプロセス内のメッセージ通番を付けるかどうかを指定

Y｜《N》

log_msg_prcid

メッセージの標準出力時にメッセージの出力要求元のプロセスのプロセスIDを付けるかどうかを指定

Y｜《N》

log_msg_prcno

メッセージの標準出力時にプロセス内のメッセージ通番を付けるかどうかを指定

Y｜《N》

log_msg_sysid

メッセージの標準出力時にTP1/EE識別子を付けるかどうかを指定

《Y》｜N

log_msg_date

メッセージの標準出力時にメッセージの出力要求時の日付を付けるかどうかを指定

《Y》｜N

log_msg_time

メッセージの標準出力時にメッセージの出力要求時の時刻を付けるかどうかを指定

《Y》｜N

log_msg_hostname

メッセージの標準出力時にメッセージの出力要求元のホスト名を付けるかどうかを指定

《Y》｜N

log_msg_pgmid

メッセージの標準出力時にメッセージの出力要求元のプログラムIDを付けるかどうかを指定

《Y》｜N

log_hsyslog_cmode

syslog出力時に拡張SYSLOGの文字コード変換機能を使用するかどうかを指定

SJIS｜《NONE》

(6)　トラブルシュート関連定義の内容

トラブルシュート関連定義の内容を，次の表に示します。

表7‒13　トラブルシュート関連定義の内容

形式

オペランド

定義内容

指定値

set

trb_tasktm_file_size

TASKTMファイルの最大容量

〈符号なし整数〉((400〜4000000))《40000》（単位：キロバイト）

trb_tasktm_file_no

TASKTMファイルの最大ファイル数

〈符号なし整数〉((3〜100))《3》

trb_tasktm_buffer_size

TASKTMバッファのサイズ

〈符号なし整数〉((1〜20000))《200》（単位：キロバイト）

trb_tasktm_buffer_no

TASKTMバッファ数

〈符号なし整数〉((3〜200))《3》

trb_trace_file_size

回線トレースファイルの最大容量

〈符号なし整数〉((400〜4000000))《40000》（単位：キロバイト）

trb_trace_file_no

回線トレースファイルの最大ファイル数

〈符号なし整数〉((3〜100))《3》

trb_line_trace_buffer_size

回線トレースバッファサイズ

〈符号なし整数〉((1〜20000))《200》（単位：キロバイト）

trb_line_trace_buffer_no

回線トレースバッファ数（xa_open関数以外）

〈符号なし整数〉((3〜200))《3》

trb_line_xatrace_buffer_no

回線トレースバッファ数（xa_open関数）

〈符号なし整数〉((3〜200))《3》

trb_uap_trace_entry_no

UAPトレース情報格納最大レコード数

〈符号なし整数〉((16〜4095))《32》

trb_uap_trace_file_size

UAPトレースファイルの最大容量

〈符号なし整数〉((400〜4000000))《40000》（単位：キロバイト）

trb_uap_trace_file_no

UAPトレースファイルの最大ファイル数

〈符号なし整数〉((3〜100))《3》

trb_uap_trace_buffer_size

UAPトレースバッファサイズ

〈符号なし整数〉((1〜20000))《200》（単位：キロバイト）

trb_uap_trace_buffer_no

UAPトレースバッファ数

〈符号なし整数〉((3〜200))《3》

trb_dump_file_no

メモリダンプファイルの最大ファイル数

〈符号なし整数〉((3〜20))《10》

trb_dump_output_time

メモリダンプファイル出力監視時間

〈符号なし整数〉((0〜65535))《60》（単位：秒）

trb_dump_area_kind

メモリダンプファイル出力領域種別

〈符号なし整数〉((0〜63))《9》

trb_tasktm_type

TASKTMファイルの取得情報のタイプ

〈符号なし整数〉((1〜3))《1》

trb_trace_type

回線トレースファイルの取得情報のタイプ

〈符号なし整数〉((1))《1》

trb_iso_interval_time

縮退監視メッセージ出力間隔時間

〈符号なし整数〉((0〜60))《5》（単位：分）

trb_stc_file_size

統計情報ファイルの最大容量

〈符号なし整数〉((400〜4000000))《40000》（単位：キロバイト）

trb_stc_file_no

統計情報ファイルの最大ファイル数

〈符号なし整数〉((3〜100))《3》

trb_stc_buffer_size

統計情報バッファのサイズ

〈符号なし整数〉((2〜20000))《200》（単位：キロバイト）

trb_stc_buffer_no

統計情報バッファ数

〈符号なし整数〉((3〜200))《3》

trb_stc_interval_time

統計情報取得間隔時間

〈符号なし整数〉((1〜1440))《10》（単位：分）

trb_stc_basic_kind

基本統計情報の統計情報種別

sys｜pci｜apm

trb_stc_ext_kind

拡張統計情報の統計情報種別

ersp｜edly｜edbq｜eobs

trb_stc_sys_kind

システム統計情報の統計情報種別

aph｜api｜dbq｜fil｜mem｜obm｜rpc｜scd｜sdh｜sts｜tim｜trb｜trn｜xtc｜xdb

trb_stc_obm_interval_time

OBM統計情報取得時間間隔

〈符号なし整数〉((1〜60))《1》（単位：分）

trb_extend_function

トラブルシュートおよび統計情報の機能拡張レベル

《00000000》｜00000001｜00000010｜00000020

trb_line_cmtrace_buffer_size

回線トレースバッファサイズ

〈符号なし整数〉((2〜20000))《200》（単位：キロバイト）

trb_line_cmtrace_buffer_no

回線トレースバッファ数

〈符号なし整数〉((3〜200))《3》

trb_line_cmtrace_buf_entry_size

一時バッファ領域サイズ

〈符号なし整数〉((1〜64))《12》（単位：キロバイト）

(7)　トランザクション関連定義の内容

トランザクション関連定義の内容を，次の表に示します。

表7‒14　トランザクション関連定義の内容

形式

オペランド／コマンド

オプション

定義内容

指定値

set

trn_tran_process_count

同時に起動するトランザクションブランチの数

〈符号なし整数〉((1〜8192))

trn_expiration_time

トランザクション処理監視時間

〈符号なし整数〉((0〜65535))《60》（単位：秒）

trn_expiration_time_mi

MIトランザクション処理監視時間

〈符号なし整数〉((0〜65535))（単位：秒）

trn_expiration_time_me

MEトランザクション処理監視時間

〈符号なし整数〉((0〜65535))（単位：秒）

trn_expiration_time_mn

MNトランザクション処理監視時間

〈符号なし整数〉((0〜65535))（単位：秒）

trn_expiration_time_tm

TMトランザクション処理監視時間

〈符号なし整数〉((0〜65535))（単位：秒）

trn_expiration_time_e1

E1トランザクション処理監視時間

〈符号なし整数〉((0〜65535))（単位：秒）

trn_expiration_time_e2

E2トランザクション処理監視時間

〈符号なし整数〉((0〜65535))（単位：秒）

trn_expiration_time_e3

E3トランザクション処理監視時間

〈符号なし整数〉((0〜65535))（単位：秒）

trn_expiration_time_e4

E4トランザクション処理監視時間

〈符号なし整数〉((0〜65535))（単位：秒）

trn_expiration_time_es

ESトランザクション処理監視時間

〈符号なし整数〉((0〜65535))（単位：秒）

trn_expiration_time_er

ERトランザクション処理監視時間

〈符号なし整数〉((0〜65535))（単位：秒）

trn_expiration_time_rl

RLトランザクション処理監視時間

〈符号なし整数〉((0〜65535))（単位：秒）

trn_max_subordinate_count

子トランザクションブランチ最大数

〈符号なし整数〉((0〜1024))《32》

trn_optimum_item

トランザクション最適化項目

onephase｜readonly

trn_watch_time

トランザクション同期点処理時の最大通信待ち時間

〈符号なし整数〉((1〜65535))《120》（単位：秒）

trn_rollback_information_put

ロールバック要因に関するメッセージをログに取得するかどうかを指定

《no》｜self｜remote｜all

trn_wait_rm_open

リソースマネジャのオープン処理（xa_open関数）で障害が発生した場合の処置

《continue》｜stop｜retry_continue｜retry_stop

trn_retry_interval_rm_open

xa_open関数呼び出しリトライインタバル時間

〈符号なし整数〉((1〜3600))《10》（単位：秒）

trn_retry_count_rm_open

xa_open関数呼び出しリトライ回数

〈符号なし整数〉((1〜65535))《18》

trn_retry_interval_rm_open_mime

xa_open関数呼び出しリトライインタバル時間（MI，MEトランザクション用）

〈符号なし整数〉((1〜3600))《10》（単位：秒）

trn_retry_count_rm_open_mime

xa_open関数呼び出しリトライ回数（MI，MEトランザクション用）

〈符号なし整数〉((1〜65535))《18》

trn_endprepare_msg_interval

終了時の仕掛り中トランザクション情報メッセージ出力間隔時間

〈符号なし整数〉((0〜3600))《180》（単位：秒）

trn_delayed_allrecover

TP1/EE再開始時のプロセスの回復方法

《Y》｜N

trn_recovery_failmsg_interval

仕掛り中トランザクション情報メッセージ間隔最小時間

〈符号なし整数〉((0〜65535))《180》（単位：秒）

trn_endrerun_msg_interval

TP1/EE再開始時の仕掛りトランザクション情報メッセージ出力間隔時間

〈符号なし整数〉((0〜3600))《180》（単位：秒）

trn_max_commit_count

コミット関数の呼び出し回数上限値

〈符号なし整数〉((0〜999999))《0》

trn_max_commit_downmode

コミット関数の呼び出し回数が上限値に達した場合の処理を指定

P｜T｜《N》

trn_max_rollback_count

ロールバック関数の呼び出し回数上限値

〈符号なし整数〉((0〜999999))《0》

trn_max_rollback_downmode

ロールバック関数の呼び出し回数が上限値に達した場合の処理を指定

P｜T｜《N》

trn_undelayed_recover_thread

アンディレード回復処理に処理スレッドを使用するかどうかを指定

Y｜《N》

trn_rm_open_close_scope

XAインタフェースである二つの関数（xa_open関数とxa_close関数）の発行タイミングを指定

《process》｜transaction

trn_sta_pdcwaittime

開始時のPDCWAITTIMEの変更時間

〈符号なし整数〉((0〜65535))《変更なし》（単位：秒）

trn_onl_pdcwaittime

オンライン中のPDCWAITTIMEの変更時間

〈符号なし整数〉((0〜65535))《変更なし》（単位：秒）

lck_timeout_info

排他待ちタイムアウト時にタイムアウト情報をメッセージに出力するかどうかを指定

《Y》｜N

lck_limit_foruser

同時に発生する排他要求数の最大値

〈符号なし整数〉((0〜327670))《0》

lck_wait_timeout

排他待ち限界経過時間

〈符号なし整数〉((0〜327670))《0》（単位：10ミリ秒）

コマンド

trnstring

-n

リソースマネジャ名

〈1〜31文字の英数字〉

-i

リソースマネジャ拡張子

〈1〜2文字の識別子〉

-o

トランザクションサービス用xa_open関数用文字列

〈1〜255文字の文字列〉

-c

トランザクションサービス用xa_close関数用文字列

〈1〜255文字の文字列〉

-O

ユーザサービス用xa_open関数用文字列

〈1〜255文字の文字列〉

-C

ユーザサービス用xa_close関数用文字列

〈1〜255文字の文字列〉

-r

トランザクションの回復処理を待ち合わせるかどうかを指定

なし。

-x

一つのインスタンスのリソースマネジャに対して複数のセションを確立するかどうかを指定

なし。

(8)　ステータスファイル関連定義の内容

ステータスファイル関連定義の内容を，次の表に示します。

表7‒15　ステータスファイル関連定義の内容

形式

オペランド／コマンド

オプション

定義内容

指定値

set

sts_initial_error_switch

TP1/EE開始時にステータスファイルに異常を検知した場合のTP1/EEの処理

《stop》｜continue｜force

sts_single_operation_switch

現用ステータスファイルの片系に入出力障害が発生した場合，スワップできる両系がそろった論理ファイルが存在しないときのTP1/EEの処理

《stop》｜continue

sts_buffer_count

ステータスファイルをスタックするバッファ数

〈符号なし整数〉((32〜4194304))

sts_control_buffer_length

制御用ステータスファイルをスタックするバッファ長

〈符号なし整数〉((512〜32768))《4608》（単位：バイト）

sts_signal_buffer_length

シグナル用ステータスファイルをスタックするバッファ長

〈符号なし整数〉((512〜32768))《4608》（単位：バイト）

コマンド

stsflgrp

-g

ファイルグループ番号

〈符号なし整数〉((0〜16))

-l

前回オンラインの現用ファイル名

〈1〜8文字の識別子〉

-k

前回オンラインの稼働系

A｜B

stsflnam

-g

ファイルグループ番号

〈符号なし整数〉((0〜16))

-l

論理ファイル名

〈1〜8文字の識別子〉

-a

A系ステータスファイル名

〈510文字以内のパス名〉

-b

B系ステータスファイル名

〈510文字以内のパス名〉

(9)　DBキュー機能関連定義の内容

DBキュー機能関連定義の内容を，次の表に示します。

表7‒16　DBキュー機能関連定義の内容

形式

オペランド／コマンド

オプション

定義内容

指定値

set

dbq_rollback_retry_count

連続ロールバック監視回数

((-1〜10))《5》

dbq_reqbuf_retry_timer

バッファ空き待ち監視時間

〈符号なし整数〉((0〜100))《1》（単位：100ミリ秒）

dbq_readcheckmsg_interval

DBキュー読み出しサーバ監視メッセージ出力間隔

〈符号なし整数〉((0，10〜3600))《180》（単位：秒）

dbq_endcheckmsg_interval

TP1/EE終了時未読み出し監視メッセージ出力間隔

〈符号なし整数〉((0〜3600))《180》（単位：秒）

dbq_endcheck_mode

TP1/EE正常終了時に未読み出しメッセージがなくなるまでDBキューをチェックするかどうかを指定

NO｜《UAP》

dbq_uap_stop

AP間通信をするすべての自サーバ読み出しのDBキューを，一括で読み出し停止にさせるTP1/EEの開始モードを指定

《no》｜start｜restart｜all

dbq_read_error_uap_stop

AP間通信をするDBキューのメッセージ読み出しトランザクションで，DBキューを読み出し停止にする障害ケースを指定

〈符号なし整数〉((1，2))《1》

dbq_inhibit_use

DBキュー書き込みで障害が発生したとき，または書き込み抑止を検知したときにDBキュー書き込み状態を書き込み禁止状態にするかどうかを指定

Y｜《N》

コマンド

dbqdef

-q

DBキュー名

〈1〜27文字の英大識別子〉

-d

DBキューグループ名

〈1〜31文字の識別子〉

-l

最大書き込みメッセージ数

〈符号なし整数〉((1〜2147483647))《1000》

-n

リソースマネジャ名

〈1〜31文字の英数字〉

-i

リソースマネジャ拡張子

〈1〜2文字の識別子〉

-t

DBキューを読み出し停止とするTP1/EEの開始モードを指定

no｜《start》｜restart｜all

dbqgrpdef

-d

DBキューグループ名

〈1〜31文字の識別子〉

-p

関連づけるDBキューサービスグループ名

〈1〜31文字の識別子〉

-k

DBキュー機能オプションの指定

《0》｜1

-e

関連づけるサービスグループ名

〈1〜31文字の識別子〉

-t

イベント通知をTCP/IP通信でするかどうかを指定

なし。

-f

関連づける他サーバのプロセス識別子

〈1〜31文字の識別子〉

-o

DBキュー読み出しサーバを指定

my｜other

-c

DBキュー読み出しサーバ変更機能を使用するかどうかを指定

なし。

-u

DBキューでAP間通信機能とユーザキューアクセス機能のどちらを使用するかを指定

《uap》｜user

-s

UAP障害によってDBキューの読み出しトランザクションがロールバックした場合の動作を指定

《stop》｜skip

dbqsrvdef

-v

DBキューサービス名

〈1〜31文字の識別子〉

-p

関連づけるDBキューサービスグループ名

〈1〜31文字の識別子〉

-q

DBキュー名

〈1〜27文字の英大識別子〉

-n

DBキューサービスで使用するDBキューの最大数

〈符号なし整数〉((1〜64))《20》

-t

DBキューサービスを同時に起動させるトランザクションの最大数

〈符号なし整数〉((1〜64))《1》

-c

DBキューサービスのスケジュール方式

《R》｜P

dbqsvgdef

-p

DBキューサービスグループ名

〈1〜31文字の識別子〉

-d

DBキューグループ名

〈1〜31文字の識別子〉

dbqprcdef

-f

関連づける他サーバのプロセス識別子

〈1〜31文字の識別子〉

-h

イベント通知先のホスト名，ポート番号，および自ホスト名

ホスト名：〈1〜255文字のホスト名〉

ポート番号：〈符号なし整数〉((1〜65535))

自ホスト名：〈1〜255文字のホスト名〉

-b

使用するネットワークアダプタを自ホスト名として固定するかどうかを指定

なし。

(10)　オンラインバッチ機能関連定義の内容

オンラインバッチ機能関連定義の内容を，次の表に示します。

表7‒17　オンラインバッチ機能関連定義の内容

形式

オペランド／コマンド

オプション

定義内容

指定値

set

dbq_obs_lot_no

ロット管理テーブル面数

〈符号なし整数〉((1〜32767))《128》

dbq_obs_endcheckmsg_interval

TP1/EE終了時未読み出し監視メッセージ出力間隔

〈符号なし整数〉((0〜3600))《180》（単位：秒）

dbq_obs_trn_end_api

DBキューのトランザクションの決着タイミングをAPI関数による同期点取得時にするかどうかを指定

Y｜《N》

コマンド

dbqobsdef

-q

DBキュー名

〈1〜27文字の識別子〉

-n

リソースマネジャ名

〈1〜31文字の識別子〉

-i

リソースマネジャ拡張子

〈1〜2文字の識別子〉

dbqobssrvdef

-v

オンラインバッチサービス名

〈1〜31文字の英大識別子〉

-e

-vオプションで指定したサービスが，バッチ処理終了時に呼び出されるかどうかを指定

なし。

dbqobslotdef

-o

ロット名

〈1〜23文字の識別子〉

-v

起動するオンラインバッチサービス名

〈1〜31文字の識別子〉

(11)　ファイルサービス関連定義

ファイルサービス関連定義の内容を，次の表に示します。

表7‒18　ファイルサービス関連定義の内容

形式

オペランド

定義内容

指定値

set

fil_watch_time

TP1EEファイルシステムのI/O処理監視時間

〈符号なし整数〉((0〜3600))（単位：秒）

fil_watch_timeout

TP1EEファイルシステムのI/O処理監視時間を超えた場合のTP1/EEの処理を指定

《down》｜continue

(12)　サービスグループ情報関連定義の内容

サービスグループ情報関連定義の内容を，次の表に示します。

表7‒19　サービスグループ情報関連定義の内容

形式

コマンド

オプション

定義内容

指定値

コマンド

eesvgdef

-g

サービスグループ名

〈1〜31文字の識別子〉

-h

サービス要求するホスト名およびポート番号

ホスト名：〈1〜255文字のホスト名〉

ポート番号：〈符号なし整数〉((1〜65535))

-s

最大ソケット数

〈符号なし整数〉((1〜32))《1》

-a

コネクションを自動確立するかどうかを指定

なし。

-t

相手ホストとの通信で使用する通信形態を指定

《RPC》｜DBQ｜RAP

-c

Cosminexus連携

なし。

mysvgdef

-g

サービスグループ名

〈1〜31文字の識別子〉

-h

サービス要求を受け付けるポート番号およびホスト名

ポート番号：〈符号なし整数〉((0，5001〜65535))

自ホスト名：〈1〜255文字のホスト名〉

-s

最大ソケット数

〈符号なし整数〉((1〜1024))《16》

-f

フラグメントメッセージ用バッファ面数

〈符号なし整数〉((0〜65535))《0》

-b

サービス要求を受け付けるホストを固定するかどうかを指定

なし。

-t

相手ホストとの通信で使用する通信形態を指定

《RPC》｜DBQ

myreplydef

-g

サービスグループ名

〈1〜31文字の識別子〉

-h

サービス応答を受け付けるポート番号およびホスト名

ポート番号：〈符号なし整数〉((5001〜65535))

自ホスト名：〈1〜255文字のホスト名〉

-f

フラグメントメッセージ用バッファ面数

〈符号なし整数〉((0〜65535))《0》

-b

サービス要求を受け付けるホストを固定するかどうかを指定

なし。

7.3　TP1/EEシステムの定義の変更

TP1/EEシステムの定義の変更方法について説明します。

7.3.1　定義の変更手順

定義内容を変更する場合は，TP1/EEシステムを正常終了させてから行ってください。定義内容の変更後は正常開始から始めます。

TP1/EEシステムが再開始する場合は，変更できないシステムサービス定義があります。TP1/EEシステムの再開始時に変更できない定義については，「7.3.2　再開始時に変更できない定義」を参照してください。

定義内容は，TP1/EEシステムへの影響について十分検討してから変更してください。

7.3.2　再開始時に変更できない定義

TP1/EEのシステム定義には，システムの再開始時に変更できる，または変更が有効になる定義と，システムの再開始時には変更できない，または変更が有効にならない定義とがあります。

(1)　TP1/Server Baseのシステムサービス定義

TP1/Server Baseのシステム再開始時に変更できるシステムサービス定義については，マニュアル「OpenTP1 システム定義」を参照してください。

ただし，TP1/EEが動作するTP1/Server Baseの場合は，マニュアル「OpenTP1 システム定義」で示すシステム再開始時に変更できる定義の中にも，TP1/Server Baseシステム再開始時に変更できないシステムサービス定義があります。TP1/EEが動作するTP1/Server Baseの再開始時に変更できない定義を次の表に示します。

表7‒20　TP1/EEが動作する場合の再開始時に変更できないTP1/Server Baseのシステムサービス定義

定義名

オペランド

ユーザサービス定義

uid

(2)　TP1/EEサービス定義

TP1/EEの再開始時に変更できないTP1/EEサービス定義について説明します。TP1/EEの再開始時に変更できないTP1/EEサービス定義には，再開始時に変更するとプロセスダウンする定義と，再開始時に変更してもプロセスダウンしない定義とがあります。再開始時に変更するとプロセスダウンするTP1/EEサービス定義を次の表に示します。

表7‒21　再開始時に変更するとプロセスダウンするTP1/EEサービス定義の一覧

定義名

オペランド／コマンド

プロセス関連定義

service_group

RPC関連定義

node_id

rpc_reply_suspend_cnt

rpc_reply_suspend_recover

rpc_reply_errtrnr

rpc_reply_errtrnr_cnt

ユーザサービス関連定義

service

dbq_service

dbq_obs_service

uap_exchange_use

トランザクション関連定義

trn_tran_process_count

trn_max_subordinate_count

trnstring※

DBキュー機能関連定義

dbqdef

dbqsrvdef

オンラインバッチ機能関連定義

dbq_obs_lot_no

dbqobsdef

dbqobssrvdef

dbqobslotdef

トラブルシュート関連定義

trb_tasktm_type

trb_trace_type

注※

-rオプションは除きます。

注意事項

TP1/EEは，再開始時に変更するとプロセスダウンするTP1/EEサービス定義をチェックするためにステータスファイルを使用します。正常開始時にステータスファイルへの書き込み処理ができなかった場合，および再開始時にステータスファイルの読み込み処理ができなかった場合は，プロセスダウンします。

再開始時に変更してもプロセスダウンしないTP1/EEサービス定義を次の表に示します。

表7‒22　再開始時に変更してもプロセスダウンしないTP1/EEサービス定義の一覧

定義名

オペランド／コマンド

プロセス関連定義

reserve_thread_no

thread_no

cmd_port

xtc_use

mcp_use

fsp_use

RPC関連定義

rap_listen_port

name_use

ユーザサービス関連定義

errtrn1

errtrn2

errtrn3

errtrn4

errtrns

errtrnr

module※

ステータスファイル関連定義

sts_single_operation_switch

sts_control_buffer_length

sts_signal_buffer_length

stsflgrp -gオプション

stsflnam

DBキュー機能関連定義

dbqgrpdef -kオプション

サービスグループ情報関連定義

mysvgdef

myreplydef

注※

UAP共用ライブラリ入れ替え機能を使用する場合に変更すると，プロセスダウンします。

8　TP1/EEサービス定義の詳細

この章では，TP1/EEサービス定義の詳細について，それぞれの定義ごとに説明します。

プロセス関連定義

形式

set形式

  set service_group="サービスグループ名"
〔set service_hold=Y|N〕
〔set thread_no=通常処理スレッド数〕
〔set rpc_cmtsend_retry=Y|N〕
〔set reserve_thread_no=予備処理スレッド数〕
〔set reserve_start_pce_no=予備処理スレッド起動処理キュー数〕
〔set cmd_port=コマンド受信用のポート番号〕
〔set uap_stack_size=UAP実行に必要なスタックサイズ〕
〔set other_lib_stack_size=他製品との連携時に必要なスタックサイズ〕
〔set uapabend_downmode=P|S〕
〔set clock_time_interval=イベント監視インタバル間隔時間〕
〔set term_watch_time=連続異常終了限界経過時間〕
〔set service_hold_watch_use=Y|N〕
〔set service_hold_watch_procdown=Y|N〕
〔set service_term_watch_time=連続サービス異常終了限界経過時間〕
〔set max_descriptors=ファイル識別子の最大数〕
〔set descriptors_expanse_use=Y|N〕
〔set cobol_use_flag=Y|N〕
〔set cobol_lang=85|2002〕
〔set cobol_uap_cblend=Y|N〕
〔set execap_permission_time=先行許容時間,後退許容時間〕
〔set thd_hungup_time=スレッドハングアップ監視時間〕
〔set thd_trb_hungup_time=トラブルシュートで使用するスレッドのスレッドハングアップ監視時間〕
〔set proc_hungup_time=TP1/EEプロセスハングアップ監視時間〕
〔set thd_backtrace_msg=Y|N〕
〔set thd_cpuinfo_msg=Y|N〕
〔set dbq_use=Y|N〕
〔set dbq_obs_use=Y|N〕
〔set recover_thread_no=回復スレッド数〕
〔set call_cmd_srvgroup=運用コマンド実行サービスグループ名〕
〔set call_cmd_service=運用コマンド実行サービス名〕
〔set call_cmd_time=運用コマンド実行サーバ応答監視時間〕
〔set fil_filesystem_no=TP1EEファイルシステム総数〕
〔set stay_watch_queue_rate=オンライン打ち切り監視範囲処理キュー滞留率〕
〔set stay_watch_down_rate=オンライン打ち切り係数〕
〔set stay_watch_check_interval=処理キュー滞留監視間隔時間〕
〔set trb_stc_use=Y|N〕
〔set trb_uap_trace_file_out=Y|N〕
〔set initialize_sync=Y|N〕
〔set sys_dba_waittime=システム用トランザクションの処理監視時間に加算するDBアクセス時間〕
〔set xtc_use=Y|N〕
〔set xdb_use=Y|N〕
〔set mcp_use=Y|N〕
〔set fsp_use=Y|N〕
〔set thd_mutex_attr_adaptive=Y|N〕

コマンド形式

なし。

機能

TP1/EEプロセスの環境および動作を定義します。

説明

各オペランドについて説明します。

set形式のオペランド

●service_group="サービスグループ名"　　〜〈1〜31文字の識別子〉

サービスグループ名を指定します。

サービスグループ名はネットワークで接続されるすべてのOpenTP1システムの中で一意となるように指定します。

このオペランドは省略できません。必ず指定してください。

●service_hold=Y|N　　〜《Y》

UAPがサービストランザクションまたはタイマトランザクションを実行中に，異常（シグナル，ハングアップ，ロールバックアベンド）が発生し，スレッドダウンまたはプロセスダウンした場合に，対象サービスを自動的に閉塞するかどうかを指定します。

Y

サービスを閉塞します。スレッドまたはプロセスの再起動時に，対象サービスが閉塞します。

N

サービスを閉塞しません。

●thread_no=通常処理スレッド数　　〜〈符号なし整数〉((1〜999))《10》

プロセス内で使用する通常処理スレッド数を指定します。通常処理スレッドとは，各種トランザクション処理をするスレッドのことです。

定義で指定するスレッド数の合計は，1000以内にする必要があります。スレッド数の合計とは，次の指定値の合計に1を加えた値です。

thread_noオペランドに指定する通常処理スレッド数

reserve_thread_noオペランドに指定する予備処理スレッド数

TP1/FSPのタイマ関連定義のtim_perm_thread_noオペランドに指定するタイマ処理スレッド数＋1

recover_thread_noオペランドに指定する回復スレッド数

サービスグループ情報関連定義のmysvgdef定義コマンドの-hオプションで指定したポート番号と自ホスト名の組み合わせ数（受信スレッド数）

サービスグループ情報関連定義のmyreplydef定義コマンドの-hオプションで指定したポート番号と自ホスト名の組み合わせ数（応答受信スレッド数）

OBM関連定義のobm_server_typeオペランドにMを指定した場合，＋1

OBM関連定義のobm_server_typeオペランドにSを指定した場合，＋5

プロセス関連定義のdbq_useオペランドにYを指定した場合，＋4

スレッド数の合計が1000を超えた場合は，TP1/EEは起動できません。初期化処理の途中でプロセスダウンします。

●rpc_cmtsend_retry=Y|N　　〜《N》

ee_rpc_cmtsend関数によるサービス要求時に送信エラーが発生した場合，別処理スレッドで再送信するか送信障害トランザクション（ERRTRNS）を起動するかを指定します。ただし，ユーザサービス関連定義のerrtrnsオペランドが定義されていない場合は，送信障害トランザクション（ERRTRNS）を起動できません。

Y

別処理スレッド（送信スレッド）で再送信します。送信スレッドからの送信がエラーになった場合は，送信障害トランザクション（ERRTRNS）を起動します。

N

送信障害トランザクション（ERRTRNS）を起動します。

●reserve_thread_no=予備処理スレッド数　　〜〈符号なし整数〉((0〜998))《0》

プロセス内で使用する予備処理スレッド数を指定します。予備処理スレッドとは，ユーザサービスの処理が一定数以上滞留したときに，ユーザサービストランザクション処理をするスレッドのことです。

定義で指定するスレッド数の合計は，1000以内にする必要があります。スレッド数の合計とは，次の指定値の合計に1を加えた値です。

thread_noオペランドに指定する通常処理スレッド数

reserve_thread_noオペランドに指定する予備処理スレッド数

TP1/FSPのタイマ関連定義のtim_perm_thread_noオペランドに指定するタイマ処理スレッド数＋1

recover_thread_noオペランドに指定する回復スレッド数

サービスグループ情報関連定義のmysvgdef定義コマンドの-hオプションで指定したポート番号と自ホスト名の組み合わせ数（受信スレッド数）

サービスグループ情報関連定義のmyreplydef定義コマンドの-hオプションで指定したポート番号と自ホスト名の組み合わせ数（応答受信スレッド数）

OBM関連定義のobm_server_typeオペランドにMを指定した場合，＋1

OBM関連定義のobm_server_typeオペランドにSを指定した場合，＋5

プロセス関連定義のdbq_useオペランドにYを指定した場合，＋4

スレッド数の合計が1000を超えた場合は，TP1/EEは起動できません。初期化処理の途中でプロセスダウンします。

reserve_thread_noオペランドもしくはreserve_start_pce_noオペランドを省略した場合，または0を指定した場合，予備処理スレッドは起動されません。

●reserve_start_pce_no=予備処理スレッド起動処理キュー数　　〜〈符号なし整数〉((0〜1000))《0》

予備処理スレッドを起動するサービスに対する滞留処理キュー数を指定します。

reserve_thread_noオペランドもしくはreserve_start_pce_noオペランドを省略した場合，または0を指定した場合，予備処理スレッドは起動されません。

●cmd_port=コマンド受信用のポート番号　　〜〈符号なし整数〉((5001〜65535))《20345》

コマンド受信用のポート番号を指定します。

TP1/EEを複数起動する場合は，TP1/EE（プロセス）ごとにポート番号を変えてください。また，TP1/EE以外のプログラムが特定のポート番号を使用している場合は，その特定のポート番号と異なるポート番号を指定してください。

このオペランドで指定するポート番号は自ホストで使用するポート番号と重複しないようにしてください。

このオペランドで指定したポート番号が使用中だった場合，OSが自動的に割り当てるポート番号をコマンド受信用のポート番号として使用します。そのため，OSが任意に割り当てるポート番号は指定しないでください。OSが任意に割り当てるポート番号は，OSの種別やバージョンによって異なります。詳細については使用しているOSのマニュアルを参照してください。

●uap_stack_size=UAP実行に必要なスタックサイズ　　〜〈符号なし整数〉((0〜65535))《0》（単位：キロバイト）

UAP実行に必要なスタックサイズを指定します。処理スレッド（通常処理スレッドおよび予備処理スレッド）は，自スレッドで必要なスタックサイズにuap_stack_sizeオペランドの指定値を加算したスタックサイズで動作します。スタックサイズが不足した場合，スレッドダウンまたはプロセスダウンします。

●other_lib_stack_size=他製品との連携時に必要なスタックサイズ　　〜〈符号なし整数〉((0〜65535))《0》（単位：キロバイト）

UAPを実行しないTP1/EE内部のスレッドでOracleなどの他製品と連携する場合に必要なスタックサイズを指定します。

TP1/EE内部のスレッドは，自スレッドで必要なスタックサイズにother_lib_stack_sizeオペランドの指定値を加算したスタックサイズで動作します。スタックサイズが不足した場合は，プロセスダウンします。

●uapabend_downmode=P|S　　〜《P》

UAP異常発生時（シグナル，ハングアップ）のダウン種別を指定します。

P

プロセスダウンします。

S

異常が発生したUAPが保護区に設定されている場合は，UAPをプロセスダウンします。異常が発生したUAPが非保護区に設定されている場合は，異常が発生した個所をスレッドダウンします。

uapabend_downmodeオペランドにSを指定する場合，必ずUAPで保護区／非保護区を切り替えてください。UAPの保護区／非保護区は，ee_thd_protstart関数およびee_thd_protend関数で切り替えます。非保護区で，保護区で行う必要のある処理を行っている場合にスレッドダウンしたときは，プロセスハングアップ，データ破壊，リソース不足などの予期しない障害を引き起こすおそれがあります。保護区で行う必要のある処理を次に示します。

シグナルアンセーフな，システムコールおよび標準ライブラリ関数の呼び出し※1

TP1/EE以外の製品が提供する，シグナルアンセーフな提供関数の呼び出し※2

TP1/EEの管理範囲外のリソース（ファイル，共用メモリなど）を使用している場合で，スレッドダウンによって処理が中断されたときに，解放漏れ，データ矛盾などが発生する処理※3

複数のスレッド間でデータ共有，同期処理などを行っている場合に，ほかのスレッドからの影響を受けてはいけない処理（クリティカルセクション）※3

注※1

システムコールおよび標準ライブラリ関数がシグナルアンセーフかどうかは，ご使用のプラットフォームの，APIについてのマニュアルを参照してください。

注※2

各製品が提供する関数がシグナルアンセーフかどうかは，各製品のマニュアルを参照してください。シグナルアンセーフかどうかが明確ではない場合は，保護区で行うことをお勧めします。

注※3

ERRTRN3などを利用することによってリソースを回復できる場合は，この処理を保護区で行う必要はありません。

●clock_time_interval=イベント監視インタバル間隔時間　　〜〈符号なし整数〉｛100|250|500|1000｝《500》（単位：ミリ秒）

イベント（スレッド状態変化，終了コマンド実行，タイマ起動など）を監視する間隔を指定します。

clock_time_intervalオペランドの指定値を大きくした場合，イベント監視処理のオーバヘッドは小さくなりますが，イベント発生からイベント検出までの時間が長くなります。

clock_time_intervalオペランドの指定値を小さくした場合，イベント発生からイベント検出までの時間は短くなりますが，イベント監視処理のオーバヘッドが大きくなります。

●term_watch_time=連続異常終了限界経過時間　　〜〈符号なし整数〉((0〜65535))《30》（単位：分）

TP1/EEプロセスの連続異常終了を監視する時間を指定します。

指定時間内に3回異常終了した場合，TP1/EEプロセスは再起動されません。ただし，UAPがサービストランザクションまたはタイマトランザクション実行中にプロセスダウンした場合は，異常回数としてカウントされません。

term_watch_timeオペランドに0を指定した場合は，TP1/EEプロセスの連続異常終了を監視しません。

●service_hold_watch_use=Y|N　　〜《N》

UAPがサービストランザクションまたはタイマトランザクションを実行中に，異常（シグナル，ハングアップ，ロールバックアベンド）が発生し，スレッドダウンまたはプロセスダウンした場合に，サービス異常終了回数を監視してサービスを閉塞するかどうかを指定します。

Y

UAPのサービス連続異常終了回数を監視します。

service_term_watch_timeオペランドで指定した監視時間内に3回異常終了した場合に，サービスを閉塞します。

N

UAPのサービス連続異常終了回数を監視しません。

サービス異常終了回数の監視は，serviceオペランドで指定したサービスだけを対象とします。

このオペランドは，UAP異常時に自動閉塞するサービスが1つ以上ある場合に有効になります。サービスの自動閉塞は次のどれかに当てはまるサービスで行われます。

service_holdオペランドにYを指定し，かつservice_attr定義コマンドを省略する

service_attr定義コマンドを指定し，かつservice_attr定義コマンドの-cオプションを指定する

●service_hold_watch_procdown=Y|N　　〜《Y》

連続サービス異常終了の監視情報を再開始時に継続するかどうかを指定します。

Y

再開始時に前回までの監視情報を継続します。

プロセスダウンすると，次回の再開始時に監視情報を引き継ぎ，時間監視を継続します。ただし，強制正常開始時は，前回までの監視情報を破棄して，時間監視を最初から行います。

N

再開始時に前回までの監視情報を継続しません。

プロセスダウンすると，次回の再開始時に監視情報を破棄して，時間監視を最初から行います。

終了コマンドの入力による終了（正常終了，計画停止A，計画停止B，または強制停止）の場合は，このオペランドの指定値に関係なく，次回開始時に監視情報を破棄して，時間監視を最初から行います。

このオペランドは，service_hold_watch_useオペランドにYを指定した場合に有効になります。

また，このオペランドは，ステータスファイルレス機能で全体レスのオプションを使用する場合に，無条件でNが設定されます。

このオペランドの指定値と前回終了要因の関連を次の表に示します。

表8‒1　service_hold_watch_procdownオペランドの指定値と前回終了要因の関連

前回終了要因

service_hold_watch_procdownオペランドの指定値

Y

N

正常終了

×

×

計画停止A

×

×

計画停止B

×

×

強制停止

×

×

プロセスダウン

○

×

（凡例）

○：監視情報を引き継ぎます。

×：監視情報を引き継ぎません（連続サービス異常終了の時間監視を最初から行います）。

●service_term_watch_time=連続サービス異常終了限界経過時間　　〜〈符号なし整数〉((0〜65535))《0》（単位：分）

UAPのサービス連続異常終了を監視する時間を分単位で指定します。

指定時間内のサービス異常終了回数が2回以内であれば，自動閉塞はしません。指定時間内にサービスが3回異常終了すると，該当するサービスを自動閉塞します。

サービスの自動閉塞時，またはAPIやコマンドによるサービス閉塞時には，該当するサービスの監視情報を破棄します。サービス閉塞解除後は，時間監視を最初から行います。

このオペランドに0を指定した場合は，連続サービス異常終了を監視しないため，自動閉塞はしません。

このオペランドはservice_hold_watch_useオペランドにYを指定した場合に有効になります。service_hold_watch_useオペランドにNを指定した場合は，異常終了によるプロセスダウン後の再開始でも前回までの監視情報を破棄して，時間監視を最初から行います。

service_holdオペランドおよびservice_hold_watch_useオペランドとの関連を次の表に示します。

表8‒2　service_holdオペランドおよびservice_hold_watch_useオペランドとの関連

オペランドの指定値

サービス異常終了回数と閉塞の有無

service_hold

service_hold_watch_use

service_term_watch_time

1回目

2回目

3回目

Y

Y

0

閉塞しません。

閉塞しません。

閉塞しません。

0以外

閉塞しません。

閉塞しません。

閉塞します。

N

×

閉塞します。

−

−

N

×

×

閉塞しません。

閉塞しません。

閉塞しません。

（凡例）

×：指定できません（指定しても無視されます）。

−：何もしません。

●max_descriptors=ファイル識別子の最大数　　〜〈符号なし整数〉((400〜32767))《400》

TP1/EEプロセスで使用するファイル識別子の最大数を指定します。

【Linux限定】

プロセス関連定義のdescriptors_expanse_useオペランドを省略，またはNを指定している場合，このオペランドの指定値は，400〜1024となります。

●descriptors_expanse_use=Y|N　　〜《N》

【Linux限定】

TP1/EEで使用するディスクリプタ値を拡張するかどうかを指定します。

Y

ディスクリプタ値を拡張します。

N

ディスクリプタ値を拡張しません。

このオペランドにYを設定する場合は，TP1/SBのユーザサービス定義のsetrlimit_nofileオペランドには，プロセス関連定義のmax_descriptorsオペランド以上の値を指定してください。

●cobol_use_flag=Y|N　　〜《Y》

UAPにCOBOL言語を使用するかどうかを指定します。

Y

COBOL言語を使用します。UAP異常発生時に，異常終了時要約リストが出力されます。また，スレッドダウン時，COBOL実行空間が削除されます。

次の環境変数で指定したCOBOLファイル名の終端にIFA番号が付加されます。スレッド再起動時，IFA番号は前回起動時のスレッドから引き継がれるため，スレッド再起動前と再起動後で同じファイルに出力されます。

CBLABNLST

CBLDDUMP

CBL_SYSERR

CBL_SYSPUNCH

CBL_SYSOUT

ただし，DISPLAY文で環境変数を指定した場合は，ファイル名の終端にIFA番号は付加されません。

N

COBOL言語を使用しません。COBOLファイル名はCOBOL言語の仕様に従います。

●cobol_lang=85|2002　　〜《85》

UAPにCOBOL言語を使用する場合のCOBOL製品を指定します。

Linux (EM64T)では，使用できるCOBOL製品にあわせて動作するため，このオペランドを指定する必要はありません。

85

COBOL85を使用します。

2002

COBOL2002を使用します。

このオペランドは，cobol_use_flagオペランドにYを指定した場合に有効になります。

●cobol_uap_cblend=Y|N　　〜《N》

UAP実行前に，COBOL実行空間を毎回再生成するかどうかを指定します。このオペランドは，cobol_use_flagオペランドにYを指定した場合に有効になります。

Y

COBOL実行空間を再生成します。UAP実行前にCOBOL実行空間の削除が行われるため，毎回初期状態で実行されます。COBOL実行空間のメモリ使用量は，該当するスレッドで最後に実行した関数の使用量分だけとなります。

UAP実行前のCOBOL実行空間の再生成に掛かる時間は，UAP実行時間に含まれます。

N

COBOL実行空間を再生成しません。初期化属性を持たないUAPを実行すると，該当するスレッドで最後に実行したときの終了状態に依存した動作となります。また，COBOL実行空間のメモリ使用量は，該当するスレッドで実行した関数の使用量分だけ累積されます。

●execap_permission_time=先行許容時間,後退許容時間　　〜〈符号なし整数〉((1〜1439))《先行許容時間：1080，後退許容時間：60》（単位：分）

時刻指定のタイマトランザクション起動要求時の先行許容時間，および後退許容時間を指定します。指定できる時間は，1から1439（1分〜23時間59分）です。

execap_permission_timeオペランドを指定する場合，先行許容時間および後退許容時間の両方を指定してください。

先行許容時間は，現在時刻からタイマトランザクション起動要求できる時刻（現在時刻以降の時刻）までの時間です。後退許容時間は，現在時刻から現在時刻より前の時刻を指定してもタイマトランザクション起動要求できる時刻（現在時刻以前の時刻）までの時間です。

先行許容時間および後退許容時間の合計が，1440（24時間）以内になるように指定してください。先行許容時間と後退許容時間との合計が，1440（24時間）になる場合，両方の許容時間の範囲内になる時刻が存在します。この場合，後退許容時間内の時刻と判断します。

先行許容時間および後退許容時間と，タイマトランザクション起動との関連の詳細については，マニュアル「TP1/Server Base Enterprise Option プログラム作成の手引」のタイマトランザクションの登録の説明を参照してください。

●thd_hungup_time=スレッドハングアップ監視時間　　〜〈符号なし整数〉((0〜65535))《10》（単位：秒）

次に示すスレッド以外のハングアップ監視時間を指定します。

メインスレッド

モニタスレッド

トラブルシュートおよび統計情報機能で使用するスレッド

0を指定した場合は，スレッドのハングアップ監視をしません。

●thd_trb_hungup_time=トラブルシュートで使用するスレッドのスレッドハングアップ監視時間　　〜〈符号なし整数〉((0〜65535))《60》（単位：秒）

トラブルシュートおよび統計情報機能で使用するスレッドのハングアップ監視時間を指定します。

トラブルシュートおよび統計情報機能では，出力要求のあったレコードをバッファにスタックして，バッファ単位でファイルに出力します。また，出力要求のあったバッファに対して排他を確保します。thd_trb_hungup_timeオペランドでは，これらのファイル出力，および排他確保のハングアップ監視時間を指定します。

0を指定した場合は，スレッドのハングアップ監視をしません。

●proc_hungup_time=TP1/EEプロセスハングアップ監視時間　　〜〈符号なし整数〉((0〜65535))《10》（単位：秒）

TP1/EEプロセスのハングアップ監視時間を指定します。

0を指定した場合は，プロセスのハングアップ監視をしません。

●thd_backtrace_msg=Y|N　　〜《Y》

【Linux限定】

障害を検知したスレッドのバックトレース情報を，メッセージで出力するかどうかを指定します。

出力する場合は，KFSB55392-Iメッセージでバックトレース情報が表示されます。

Y

バックトレース情報を出力します。

N

バックトレース情報を出力しません。

●thd_cpuinfo_msg=Y|N　　〜《Y》

【Linux限定】

CPU時間情報メッセージの出力有無を指定します。

出力する場合は，KFSB55395-Iメッセージが表示されます。

Y

追加情報メッセージを出力します。

N

追加情報メッセージを出力しません。

●dbq_use=Y|N　　〜《N》

DBキュー機能を使用するかどうかを指定します。

Y

DBキュー機能を使用します。

N

DBキュー機能を使用しません。

●dbq_obs_use=Y|N　　〜《N》

オンラインバッチ機能を使用するかどうかを指定します。

Y

オンラインバッチ機能を使用します。

N

オンラインバッチ機能を使用しません。

●recover_thread_no=回復スレッド数　　〜〈符号なし整数〉((1〜64))《2》

プロセス内で使用する回復スレッド数を指定します。

定義で指定するスレッド数の合計は，1000以内にする必要があります。スレッド数の合計とは，次の指定値の合計に1を加えた値です。

thread_noオペランドに指定する通常処理スレッド数

reserve_thread_noオペランドに指定する予備処理スレッド数

TP1/FSPのタイマ関連定義のtim_perm_thread_noオペランドに指定するタイマ処理スレッド数＋1

recover_thread_noオペランドに指定する回復スレッド数

サービスグループ情報関連定義のmysvgdef定義コマンドの-hオプションで指定したポート番号と自ホスト名の組み合わせ数（受信スレッド数）

サービスグループ情報関連定義のmyreplydef定義コマンドの-hオプションで指定したポート番号と自ホスト名の組み合わせ数（応答受信スレッド数）

OBM関連定義のobm_server_typeオペランドにMを指定した場合，＋1

OBM関連定義のobm_server_typeオペランドにSを指定した場合，＋5

プロセス関連定義のdbq_useオペランドにYを指定した場合，＋4

スレッド数の合計が1000を超えた場合は，TP1/EEは起動できません。初期化処理の途中でプロセスダウンします。

●call_cmd_srvgroup=運用コマンド実行サービスグループ名　　〜〈1〜31文字の識別子〉

運用コマンド実行機能を使用する場合に，同一OpenTP1上の運用コマンド実行サーバにあるサービスグループ名を指定します。ユーザサービス定義のservice_groupオペランドに指定した値と同じ値を指定してください。

運用コマンド実行機能を使用しない場合は，指定する必要はありません。

●call_cmd_service=運用コマンド実行サービス名　　〜〈1〜31文字の識別子〉

運用コマンド実行機能を使用する場合に，同一OpenTP1上の運用コマンド実行サーバにあるサービス名を指定します。TP1/Server Baseのユーザサービス定義のserviceオペランドに指定した値と同じ値を指定してください。

運用コマンド実行機能を使用しない場合は，指定する必要はありません。

●call_cmd_time=運用コマンド実行サーバ応答監視時間　　〜〈符号なし整数〉((0〜65535))《30》（単位：秒）

運用コマンド実行機能を使用する場合に，サービスの応答監視時間を指定します。ee_adm_call_command関数の引数として渡す応答監視時間にEEADM_TIMEOUT_DEFを設定した場合に，call_cmd_timeオペランドは有効になります。サービスを要求する運用コマンド実行サーバのユーザサービス定義のservice_expiration_timeオペランドで指定した値より小さい値を指定してください。

なお，call_cmd_timeオペランドが有効な場合で，0を指定したときは時間監視をしません。

●fil_filesystem_no=TP1EEファイルシステム総数　　〜〈符号なし整数〉((1〜4096))《2》

TP1EEファイルシステムの総数を指定します。TP1/EEプロセスが動作するのに必要なTP1EEファイルが存在するTP1EEファイルシステムの合計数以上の値を指定してください。オンライン途中から使用する可能性のあるTP1EEファイルが存在するTP1EEファイルシステムも含まれます。

【Linux限定】

プロセス関連定義のdescriptors_expanse_useオペランドを省略，またはNを指定している場合，このオペランドの指定値は，1〜800となります。

●stay_watch_queue_rate=オンライン打ち切り監視範囲処理キュー滞留率　　〜〈符号なし整数〉((1〜99))（単位：%）

オンライン打ち切り判定を開始するときの処理キュー滞留率のしきい値となるオンライン打ち切り監視範囲処理キュー滞留率を指定します。

次の場合，処理キューの滞留監視機能を使用しません。

stay_watch_queue_rateオペランドを省略した場合

stay_watch_queue_rateオペランドが指定されている場合でも，プロセス関連定義のstay_watch_down_rateオペランドまたはstay_watch_check_intervalオペランドのどちらかが省略されているとき

●stay_watch_down_rate=オンライン打ち切り係数　　〜〈符号なし整数〉((1〜99))（単位：%）

オンライン打ち切り監視中，処理キュー処理率の低下を判定するためのオンライン打ち切り判定計算式で使用する，オンライン打ち切り係数を指定します。前回監視時の使用中処理キュー数に対する，今回の監視時間間隔中に処理されない処理キューの割合が，オンライン打ち切り係数に達した場合，処理キュー処理率の低下と判定します。

次の場合，処理キューの滞留監視機能を使用しません。

stay_watch_down_rateオペランドを省略した場合

stay_watch_down_rateオペランドが指定されている場合でも，プロセス関連定義のstay_watch_queue_rateオペランドまたはstay_watch_check_intervalオペランドのどちらかが省略されているとき

●stay_watch_check_interval=処理キュー滞留監視間隔時間　　〜〈符号なし整数〉((10〜180))（単位：秒）

処理キューの滞留監視間隔時間を指定します。

次の場合，処理キューの滞留監視機能を使用しません。

stay_watch_check_intervalオペランドを省略した場合

stay_watch_check_intervalオペランドが指定されている場合でも，stay_watch_queue_rateオペランドまたはstay_watch_down_rateオペランドのどちらかが省略されているとき

●trb_stc_use=Y|N　　〜《N》

統計情報を取得するかどうかを指定します。

Y

統計情報を取得します。

N

統計情報を取得しません。

●trb_uap_trace_file_out=Y|N　　〜《N》

UAPトレース情報をUAPトレースファイルに出力するかどうかを指定します。

Y

UAPトレース情報をUAPトレースファイルに出力します。

N

UAPトレース情報をUAPトレースファイルに出力しません。

●initialize_sync=Y|N　　〜《N》

起動順序のシリアル化機能を使用するかどうかを指定します。起動順序のシリアル化機能を使用すると，指定した順序どおりにTP1/EEを起動できます。

Y

起動順序のシリアル化機能を使用します。

N

起動順序のシリアル化機能を使用しません。

initialize_syncオペランドにYを指定した場合，eesvstartコマンドの処理に掛かる時間が，Nを指定した場合より長くなります。

●sys_dba_waittime=システム用トランザクションの処理監視時間に加算するDBアクセス時間　　〜〈符号なし整数〉((0〜65535))《0》（単位：秒）

コマンドトランザクション，DBキューシステムトランザクション，DBキュータイマトランザクション，プロセス終了監視トランザクション，およびオンライン開始監視トランザクションでDBにアクセスするときに，1回のSQLの発行に対するトランザクションの処理監視時間を指定します。

このオペランドの指定値にTP1/EEプロセスで発行するSQLの回数が乗算された値※1が，トランザクションの処理監視時間に加算されます※2。

HiRDBと接続するときは，HiRDBのクライアント環境定義のPDCWAITTIMEオペランドより大きい値をこのオペランドに指定することをお勧めします。PDCWAITTIMEオペランドより小さい値を指定した場合，TP1/EEプロセスが異常終了するおそれがあります。

注※1

乗算の結果が65535以上になった場合，トランザクションの処理監視時間は65535となります。

注※2

このオペランドに0を指定した場合は，TP1/EEプロセスのトランザクションの処理監視時間に加算されません。

●xtc_use=Y|N　　〜《N》

XTCを使用するかどうかを指定します。

Y

XTCを使用します。

N

XTCを使用しません。

●xdb_use=Y|N　　〜《N》

XDBを使用するかどうかを指定します。XDBは，XTCの使用が前提となります。

Y

XDBを使用します。

N

XDBを使用しません。

●mcp_use=Y|N　　〜《N》

MCPを使用するかどうかを指定します。

Y

MCPを使用します。

N

MCPを使用しません。

●fsp_use=Y|N　　〜《N》

TP1/FSPを使用するかどうかを指定します。

Y

TP1/FSPを使用します。

N

TP1/FSPを使用しません。

●thd_mutex_attr_adaptive=Y|N　　〜《N》（Linux版限定）

製品内部の排他で使用するmutexの属性としてPTHREAD_MUTEX_ADAPTIVE_NPを設定するかどうかを指定します。

Y

PTHREAD_MUTEX_ADAPTIVE_NPを設定します。

N

PTHREAD_MUTEX_ADAPTIVE_NPを設定しません（デフォルトのmutex属性を使用します）。

PTHREAD_MUTEX_ADAPTIVE_NPは，スレッド間での排他競合時の性能に影響するmutex属性です。総スレッド数が多い場合，排他競合の多発によって性能が劣化するおそれがあります。PTHREAD_MUTEX_ADAPTIVE_NPを設定することで，排他競合による性能低下を軽減できる場合があります。

xtc_useオペランドにYを指定した場合，thd_mutex_attr_adaptiveオペランドにYを指定することをお勧めします。

なお，このオペランドは，OSがLinuxの場合に指定できます。

コマンド形式

なし。

メモリ関連定義

形式

set形式

〔set pce_no=サービス処理キュー数〕
〔set system_user_area=プロセス管理テーブルユーザエリアサイズ〕
〔set system_user_area_mb=プロセス管理テーブルユーザエリアサイズ〕
〔set thread_user_area=スレッド対応インタフェースユーザエリアサイズ〕
〔set thread_user_area_mb=スレッド対応インタフェースユーザエリアサイズ〕
〔set system_work_size=システムワーク領域最大サイズ〕
〔set user_work_size=ユーザワーク領域最大サイズ〕
〔set max_mem_size=TP1/EEプロセスで確保するメモリの最大サイズ〕
〔set max_mem_size_mb=TP1/EEプロセスで確保するメモリの最大サイズ〕
〔set memory_alert_rate=セグメント使用率規定値超過メッセージ出力時の使用割合〕
〔set memory_leak_message=Y|N|F〕
〔set memory_leak_message_ignore_attr=TASK | FREE〕
〔set time_message_size=タイマトランザクション登録時に使用する最大データサイズ〕
〔set time_message_no=タイマトランザクション登録時に使用する最大データ数〕
〔set icb_no=タイマトランザクション登録最大数〕
〔set max_message_size=メッセージ引き渡しエリアの最大サイズ〕
〔set max_outmessage_size=メッセージ応答エリアの最大サイズ〕
〔set recv_message_buf_size=受信バッファサイズ〕
〔set recv_message_buf_cnt=受信バッファ面数〕
〔set send_message_buf_size=送信バッファサイズ〕
〔set send_message_buf_cnt=送信バッファ面数〕
〔set dbq_recv_message_buf_cnt=DBキュー機能で使用する受信バッファ面数〕
〔set dbq_send_message_buf_cnt=DBキュー機能で使用する送信バッファ面数〕
〔set dbq_max_message_size=DBキュー機能で使用する最大メッセージサイズ〕
〔set dbq_use_buf_cnt=DBキュー機能で使用する最大バッファ面数〕
〔set memory_cobol_area_size=初期化確保時のプールサイズ,追加確保時のプールサイズ〕
〔set memory_cobol_area_thd_size=初期化確保時のプールサイズ,追加確保時のプールサイズ〕

コマンド形式

なし。

機能

TP1/EEプロセスで使用するメモリの情報を定義します。

説明

各オペランドについて説明します。

set形式のオペランド

●pce_no=サービス処理キュー数　　〜〈符号なし整数〉((100〜500000))《2000》

プロセス内に滞留させることができるサービス処理キュー数を指定します。サービス処理キュー数には，TP1/EEが使用するシステム処理キュー数も含まれます。

サービス処理キュー数が不足すると，システムの動作速度やRPCサービス要求の受信数に影響するため，pce_noオペランドには余裕を持った値を指定してください。

pce_noオペランドに指定するサービス処理キュー数は，次に示す計算式で算出します。

処理キュー数＝（100※1＋受信バッファ面数※2
              ＋システム内で同時に登録するタイマトランザクション数
              ＋DBキュー同時起動数※3
              ＋DBキュー送信バッファ面数※4）×1.5※5

注※1

100とは，システム処理キュー数です。

注※2

受信バッファ面数とは，メモリ関連定義のrecv_message_buf_cntオペランドの指定値とdbq_recv_message_buf_cntオペランドの指定値の合計です。

注※3

DBキュー同時起動数とは，全DBキューの，DBキュー機能関連定義のdbqsrvdef定義コマンドの-tオプションの指定値の合計です。

注※4

DBキュー送信バッファ面数とは，メモリ関連定義のdbq_send_message_buf_cntオペランドの指定値です。

注※5

1.5とは，安全率です。

●system_user_area=プロセス管理テーブルユーザエリアサイズ　　〜〈符号なし整数〉((0〜16777216))《0》（単位：バイト）

TP1/EEプロセスで使用するメモリ領域のうち，ユーザ（UAP）がプロセス対応として使用する領域のサイズを指定します。

このオペランドを指定した場合は，指定されたサイズの領域を1プロセスに対して1面確保します。指定を省略，または0を指定した場合は，該当する領域を確保しません。

このオペランドで確保した領域は初期化されます。

●system_user_area_mb=プロセス管理テーブルユーザエリアサイズ　　〜〈符号なし整数〉((0〜16384))《0》（単位：メガバイト）

TP1/EEプロセスで使用するメモリ領域のうち，ユーザ（UAP）がプロセス対応として使用する領域のサイズを，メガバイト単位で指定します。

このオペランドを指定した場合は，指定されたサイズの領域を1プロセスに対して1面確保します。指定を省略，または0を指定した場合は，該当する領域を確保しません。

性能低下を防止するため，このオペランドで確保した領域は，各面の先頭から16メガバイトだけ初期化されます。

このオペランドを指定した場合，system_user_areaオペランドは指定できません。

このオペランドを指定する場合，マニュアル中のsystem_user_areaオペランドに関する記載は，このオペランドおよびその設定値（バイト換算）として読み替えてください。

●thread_user_area=スレッド対応インタフェースユーザエリアサイズ　　〜〈符号なし整数〉((0〜16777216))《0》（単位：バイト）

TP1/EEプロセスで使用するメモリ領域のうち，ユーザ（UAP）がスレッド対応として使用する領域のサイズを指定します。

このオペランドを指定した場合は，指定されたサイズの領域を処理スレッド（通常処理スレッド＋予備処理スレッド＋タイマ処理スレッド＋1）ごとに1面確保します。指定を省略，または0を指定した場合は，該当する領域を確保しません。

このオペランドで確保した領域は初期化されます。

●thread_user_area_mb=スレッド対応インタフェースユーザエリアサイズ　　〜〈符号なし整数〉((0〜16384))《0》（単位：メガバイト）

TP1/EEプロセスで使用するメモリ領域のうち，ユーザ（UAP）がスレッド対応として使用する領域のサイズを，メガバイト単位で指定します。

このオペランドを指定した場合は，指定されたサイズの領域を処理スレッド（通常処理スレッド＋予備処理スレッド＋タイマ処理スレッド＋1）ごとに1面確保します。指定を省略，または0を指定した場合は，該当する領域を確保しません。

性能低下を防止するため，このオペランドで確保した領域は，各面の先頭から16メガバイトだけ初期化されます。

このオペランドを指定した場合，thread_user_areaオペランドは指定できません。

このオペランドを指定する場合，マニュアル中のthread_user_areaオペランドに関する記載は，このオペランドおよびその設定値（バイト換算）として読み替えてください。

●system_work_size=システムワーク領域最大サイズ　　〜〈符号なし整数〉((100〜1048576))《450》（単位：キロバイト）

TP1/EEプロセスで使用するメモリ領域のうち，システムがワークイメージで使用するセグメント（ワークセグメント）のプール領域のサイズを指定します。

system_work_sizeオペランドを指定した場合は，指定されたサイズのプール領域をプロセスに1面確保します。

system_work_sizeオペランド指定サイズが不足した場合は，共用ワーク領域を使用します。共用ワーク領域のサイズについてはmax_mem_sizeオペランドを参照してください。

●user_work_size=ユーザワーク領域最大サイズ　　〜〈符号なし整数〉((0〜1048576))《100》（単位：キロバイト）

TP1/EEプロセスで使用するメモリ領域のうち，ユーザ（UAP）がワークイメージで使用するセグメント（ワークセグメント）のプール領域のサイズを指定します。

user_work_sizeオペランドを指定した場合は，指定されたサイズのプール領域をプロセスに1面確保します。0を指定した場合は，該当する領域を確保しません。

user_work_sizeオペランドに1以上を指定し，かつ指定サイズが不足した場合は，共用ワーク領域を使用します。共用ワーク領域のサイズについてはmax_mem_sizeオペランドを参照してください。

●max_mem_size=TP1/EEプロセスで確保するメモリの最大サイズ　　〜〈符号なし整数〉((1〜2000000000))（単位：バイト）

トランザクション処理でTP1/EEプロセス（TP1/EEおよびユーザ（UAP））が使用するメモリのサイズの合計をバイト単位で指定します。

max_mem_sizeオペランドで指定したメモリサイズは，そのままOSに要求されます（バウンダリ調整しないでmallocします）。各サイズの固定長（PCE，ICBなど）および可変長（IBF，OBF，ユーザワークエリアなど）は，max_mem_sizeオペランドで確保したエリアから1エントリ単位で4バイトのバウンダリ調整をしてから指定数分を割り当てます。

固定長の場合，1エントリは管理エリア＋各エリアサイズです。可変長の場合，1エントリは管理エリア＋エリア指定サイズでバウンダリ調整をします。

このオペランドに指定したサイズのうち，システムに必要なサイズを確保した余りの領域を共用ワーク領域として使用します。共用ワーク領域は，システムワーク領域（system_work_size指定値）およびユーザワーク領域（user_work_size指定値。ただし，user_work_sizeに0を指定した場合は対象外）が不足した場合の予備領域です。共用ワーク領域のサイズは，eememlsコマンドで確認できます。

このオペランド，またはmax_mem_size_mbオペランドのどちらか一方を必ず指定してください。

●max_mem_size_mb=TP1/EEプロセスで確保するメモリの最大サイズ　　〜〈符号なし整数〉((1〜4194304))（単位：メガバイト）

トランザクション処理でTP1/EEプロセス（TP1/EEおよびユーザ（UAP））が使用するメモリのサイズの合計をメガバイト単位で指定します。

このオペランド，またはmax_mem_sizeオペランドのどちらか一方を必ず指定してください。

このオペランドを指定する場合，マニュアル中のmax_mem_sizeオペランドに関する記載は，このオペランドおよびその設定値（バイト換算）として読み替えてください。

●memory_alert_rate=セグメント使用率規定値超過メッセージ出力時の使用割合　　〜〈符号なし整数〉((0〜100))《80》（単位：%）

システムバッファセグメントの使用率をTP1/EEプロセスの正常終了または計画停止時に通知する場合の割合を指定します。

memory_alert_rateオペランドを指定した場合は，オンライン中にセグメントの使用率が指定値を超過したすべてのセグメントに対して，TP1/EEプロセスの正常終了または計画停止時に使用率超過を警告するメッセージログを出力します。0を指定した場合は，メッセージログを出力しません。

●memory_leak_message=Y|N|F　　〜《Y》

ユーザ（UAP）が使用するワークセグメントの解放漏れがあった場合，TP1/EEプロセスの正常終了または計画停止時に，UAP確保メモリの解放漏れ警告メッセージを出力するかどうかを指定します。

Y

ワークセグメントの解放漏れがあった場合に，TP1/EEプロセスの正常終了または計画停止時に警告メッセージを出力します。

N

ワークセグメントの解放漏れがあった場合でも，TP1/EEプロセスの正常終了または計画停止時に警告メッセージを出力しません。

F

ワークセグメントの解放漏れがあった場合に，TP1/EEプロセスの正常終了または計画停止時に警告メッセージを出力します。また，解放漏れがあったワークセグメントがFREE属性の場合は，そのワークセグメントの詳細情報を示すメッセージも出力します。

●memory_leak_message_ignore_attr=TASK｜FREE　　〜《なし》

memory_leak_messageがYまたはFの場合に，ワークセグメント解放漏れメッセージの出力を抑止するセグメント属性を指定します。TASK属性およびFREE属性の両方の解放漏れメッセージの出力抑止を行う場合は，memory_leak_messageにNを指定してください。

抑止対象のメッセージはKFSB55107-E，KFSB55108-E，KFSB55109-Eです。

TASK

TASK属性のワークセグメント解放漏れメッセージの出力を抑止します。

FREE

FREE属性のワークセグメント解放漏れメッセージの出力を抑止します。

定義とメッセージ出力を行うセグメント属性の関係を次の表に示します。

表8‒3　定義と出力セグメント属性の関係

定義

memory_leak_message

Y

F

N

TASK

FREE

TASK

FREE

TASK

FREE

memory_leak_message_ignore_attr

TASK

×

○

×

◎

×

×

FREE

○

×

○

×

×

×

省略

○

○

○

◎

×

×

（凡例）

◎：メッセージを出力します（KFSB55107，KFSB55108，KFSB55109を出力）。

○：メッセージを出力します（KFSB55107を出力）。

×：メッセージを出力しません。

●time_message_size=タイマトランザクション登録時に使用する最大データサイズ　　〜〈符号なし整数〉((0〜16777216))（単位：バイト）

タイマトランザクションに使用するユーザデータの最大サイズを指定します。

time_message_sizeオペランドを省略した場合，max_message_sizeオペランドで指定した値を設定します。

●time_message_no=タイマトランザクション登録時に使用する最大データ数　　〜〈符号なし整数〉((0〜65535))

同時に登録するタイマトランザクションのうち，ユーザデータを持つタイマトランザクションの登録件数を指定します。

time_message_noオペランドを省略した場合，icb_noオペランドの指定値を設定します。

●icb_no=タイマトランザクション登録最大数　　〜〈符号なし整数〉((0〜65535))《1000》

同時に起動待ち，および同期点待ちとなるタイマトランザクションの登録要求の最大数を指定します。

●max_message_size=メッセージ引き渡しエリアの最大サイズ　　〜〈符号なし整数〉((1000〜16777216))《33000》（単位：バイト）

クライアントから受信したメッセージ，またはDBキューのメッセージをサービス関数に引き渡す格納領域（IMA）の大きさを，指定します。

サービス関数の入力パラメタ長（in_len）の最大値を指定してください。入力パラメタ長の最大値は，クライアントから受信したメッセージサイズとDBキューのメッセージサイズとを比較して，大きい方のサイズを指定してください。

●max_outmessage_size=メッセージ応答エリアの最大サイズ　　〜〈符号なし整数〉((1000〜16777216))《33000》（単位：バイト）

クライアントに対する応答メッセージを格納する領域（OMA）の大きさを指定します。

サービス関数の出力パラメタ長（out_len）の最大値を指定してください。

●recv_message_buf_size=受信バッファサイズ　　〜〈符号なし整数〉((1000〜66000))《33000》（単位：バイト）

クライアントからメッセージを受信する場合に使用するバッファサイズ（IBFサイズ）を指定します。

クライアントからの送信メッセージサイズが32キロバイトを超える場合（フラグメントメッセージ）は，33000以上を指定してください。ネームサービスを使用する場合は，16000以上を指定してください。ただし，RPC関連定義のrpc_name_service_extendオペランドに1を指定している場合は，33000以上を指定してください。

ノード間負荷バランス機能を使用する場合は，メモリ関連定義のsend_message_buf_sizeオペランドの指定値と同じ値を指定してください。send_message_buf_sizeオペランドの指定値と異なる値を指定した場合は，ノード間負荷バランス機能を使用したメッセージの転送処理に失敗するおそれがあります。

●recv_message_buf_cnt=受信バッファ面数　　〜〈符号なし整数〉((1〜2000000))《128》

受信バッファの面数を指定します。

受信バッファはRPCサービス要求，またはMCPメッセージを受信してからUAP実行前まで，メッセージ単位（フラグメントメッセージの場合は分割メッセージ単位）に使用します。そのため，pce_noオペランドの指定値，およびフラグメントメッセージの有無を考慮して，受信バッファの面数を指定してください。

RPCサービス要求受信時，またはMCPメッセージ受信時に受信バッファ面数が不足していた場合は，RPCサービス要求，MCPメッセージを受信できません。また，フラグメントが発生していない場合は，プロセス内で処理中および処理待ち（滞留）となるRPCサービス要求数，MCP受信メッセージの最大値は，受信バッファ面数となります。受信バッファ面数に最小の値を設定する場合は，最低でも処理スレッド数分（プロセス関連定義のthread_noオペランドの指定値＋プロセス関連定義のreserve_thread_noオペランドの指定値＋（TP1/FSPのタイマ関連定義のtim_perm_thread_noオペランドの指定値＋1）＋2）を指定してください。tim_perm_thread_noオペランドについては，TP1/FSPの関連ドキュメントを参照してください。

RPC関連定義のrpc_name_service_extendオペランドに1を指定している場合は，3以上を指定してください。

●send_message_buf_size=送信バッファサイズ　　〜〈符号なし整数〉((1000〜66000))《33000》（単位：バイト）

TP1/EEからメッセージを送信する場合に使用するバッファサイズ（OBFサイズ）を指定します。

送信メッセージサイズが送信バッファサイズより大きい場合は，分割してフラグメントメッセージとしてメッセージを送信します。ノード間負荷バランス機能を使用する場合は，メモリ関連定義のrecv_message_buf_sizeオペランドの指定値と同じ値を指定してください。recv_message_buf_sizeオペランドの指定値と異なる値を指定した場合は，ノード間負荷バランス機能を使用したメッセージの転送処理に失敗するおそれがあります。

●send_message_buf_cnt=送信バッファ面数　　〜〈符号なし整数〉((1〜2000000))《128》

送信バッファの面数を指定します。

フラグメントメッセージが発生した場合は，メッセージの分割数の送信バッファを使用するので，分割数を考慮して送信バッファの面数を指定してください。

フラグメントメッセージが発生しない場合，送信バッファ数は次に示す計算式で算出してください。

送信バッファ数＝（システム内で同時に発行するRPCサービス要求数
                ＋システム内で同時に発行する他システム向けDBキューの
                  書き込み要求数
                ＋システム内で同時に発行するMCPメッセージの送信数
                ＋システム内で同時に起動するトランザクションブランチ数※1
                ＋システム内で同時に起動するトランザクションブランチ間通信数※2
                ＋処理スレッド数※3）×1.5※4

注※1

RPC関連定義のrpc_replymsg_saveオペランドに，Yを指定した場合に必要です。

注※2

トランザクショナルRPCを使用する場合，次の値を加算してください。

　処理スレッド数＋回復スレッド数＋1

注※3

プロセス関連定義のfsp_useオペランドに，Yを指定した場合に必要です。

注※4

1.5とは，安全率です。

●dbq_recv_message_buf_cnt=DBキュー機能で使用する受信バッファ面数　　〜〈符号なし整数〉((1〜240000))《128》

受信バッファの面数を指定します。受信バッファは，DBキューを使用した，TCP/IPによるシステム間通信で使用します。

受信バッファは，DBキューのイベント通知メッセージを受信してから処理キューを登録するまでメッセージ単位に使用されます。したがって，処理キュー登録数（メモリ関連定義のpce_noオペランドの指定値）も考慮して，dbq_recv_message_buf_cntオペランドの値を指定してください。ほかのシステムのすべてのDBキュー数を最小基準値として，それ以上の面数を指定してください。イベント通知メッセージの受信時に受信バッファ面数が不足していた場合，イベント通知メッセージを受信できません。

●dbq_send_message_buf_cnt=DBキュー機能で使用する送信バッファ面数　　〜〈符号なし整数〉((1〜240000))《128》

DBキュー機能で使用する送信バッファの面数を指定します。ほかのシステムのすべてのDBキュー数を最小値として，それ以上の面数を指定してください。

●dbq_max_message_size=DBキュー機能で使用する最大メッセージサイズ　　〜〈符号なし整数〉((1000〜8388608))《33000》（単位：バイト）

DBキュー機能で使用するメッセージの最大サイズを指定します。複数指定したeedbqtblhコマンドの-zオプションの指定値のうち，いちばん大きい値をdbq_max_message_sizeオペランドに指定してください。

●dbq_use_buf_cnt=DBキュー機能で使用する最大バッファ面数　　〜〈符号なし整数〉((1〜240000))《128》

メッセージの書き込み（ee_dbq_msgput関数），およびメッセージの読み出し（ee_dbq_msgrefer関数）で使用するバッファ面数を指定します。これらの関数の呼び出し時に1バッファ使用します。1トランザクションでこれらの関数を呼び出す合計回数と同時に実行するトランザクション数を考慮して指定してください。

●memory_cobol_area_size=初期化確保時のプールサイズ，追加確保時のプールサイズ　　〜〈符号なし整数〉((1〜1048576))（単位：キロバイト）

COBOL用メモリ管理機能でメモリプールをプロセス単位で作成する場合に，COBOL用メモリ管理機能でプロセス単位に確保するプールサイズを指定します。

オペランドの第一指定値には，初期化時に確保するプールのサイズを指定します。第二指定値には，追加確保時に確保するプールのサイズを指定します。memory_cobol_area_sizeオペランドを指定する場合には必ず両方の値を指定してください。

ただし，実際のメモリ要求などで，追加確保プールサイズは指定値と一致しないことがあります。

COBOL用メモリ管理機能でメモリプールを処理スレッド単位で作成する（memory_cobol_area_thd_sizeオペランドを指定）場合，このオペランドを指定する必要はありません。このオペランドは，プロセス関連定義のcobol_use_flagオペランドにYを指定した場合に有効になります。

●memory_cobol_area_thd_size=初期化確保時のプールサイズ，追加確保時のプールサイズ　　〜〈符号なし整数〉((1〜1048576))（単位：キロバイト）

COBOL用メモリ管理機能でメモリプールを処理スレッド単位で作成する場合に，COBOL用メモリ管理機能で処理スレッド単位に確保するプールサイズを指定します。このオペランドを指定した場合，COBOL用のメモリプールを処理スレッド単位で管理します。

オペランドの第一指定値には，初期化時に確保するプールのサイズを指定します。第二指定値には，追加確保時に確保するプールのサイズを指定します。memory_cobol_area_thd_sizeオペランドを指定する場合には必ず両方の値を指定してください。

ただし，実際のメモリ要求などで，追加確保プールサイズは設定値と一致しないことがあります。

このオペランドは，プロセス関連定義のcobol_use_flagオペランドにYを指定した場合に有効になります。また，このオペランドとmemory_cobol_area_sizeオペランド（COBOL用メモリ管理機能でプロセス単位にメモリプールを作成）の両方を指定した場合，memory_cobol_area_sizeオペランドの指定は無効となります。

コマンド形式

なし。

RPC関連定義

形式

set形式

〔set ipc_sendbuf_size=TCP/IPの送信バッファサイズ〕
〔set ipc_recvbuf_size=TCP/IPの受信バッファサイズ〕
〔set ipc_backlog_count=コネクション確立要求を格納するキューの長さ〕
〔set ipc_tcpnodelay=Y|N〕
〔set service_group_no=サービスグループ名の最大数〕
〔set hostname_no=ホスト名の最大数〕
〔set socket_no=ソケット用ファイル記述子の最大数〕
〔set fragment_buf_no=フラグメントメッセージ用バッファ面数〕
〔set rpc_router_retry_count=TCP/IPバッファ不足発生時のリトライ回数〕
〔set rpc_router_retry_interval=TCP/IPバッファ不足発生時のリトライ間隔〕
〔set rpc_connect_timer=コネクション確立監視時間〕
〔set rpc_multi_tp1_in_same_host=Y|N〕
〔set rpc_connect_errmsg=Y|N〕
〔set rpc_connect_stopmsg=Y|N〕
〔set rpc_support_errmsg=Y|N〕
〔set rpc_first_connect_errmsg=Y|N〕
〔set rpc_firstmsg_recv_timer=コネクション確立の受け付けから最初のメッセージ受信までの監視時間〕
〔set rpc_first_connect_errmsg_dbq=Y|N〕
〔set rpc_firstmsg_recv_timer_dbq=コネクション確立の受け付けから最初のDBキューイベント通知メッセージ受信までの監視時間〕
〔set rpc_recivingconnect_stopmsg_dbq=Y|N〕
〔set rpc_conn_recv_check_use=Y|N〕
〔set rpc_conn_recv_check_interval=送信用コネクションの受信監視を行う間隔〕
〔set node_id=ノード識別子〕
〔set watch_time=最大応答待ち時間〕
〔set rpc_reply_con_max_cnt=サービス応答用コネクションの最大数〕
〔set rpc_reply_con_cnt=接続先プロセスごとのサービス応答用コネクションの最大数〕
〔set rpc_reply_proc_max_cnt=サービス応答用コネクションの接続先プロセス最大数〕
〔set rpc_reply_suspend_cnt=RPC応答メッセージ送信の同時抑止最大数〕
〔set rpc_reply_suspend_time=RPC応答メッセージ送信の抑止最大時間〕
〔set rpc_reply_suspend_recover＝Y|N〕
〔set rpc_reply_suspend_autosend＝Y|N〕
〔set rap_listen_port=リモートAPI受信用のポート番号〕
〔set rap_inquire_time=問い合わせ間隔最大時間〕
〔set rap_inquire_timeout_message=Y|N〕
〔set rpc_rap_remaincon_endwait=Y|N|F〕
〔set rap_msg_output_interval=rapクライアント数表示メッセージの出力間隔〕
〔set rap_max_client=同時接続可能なrapクライアント数〕
〔set rap_max_server_rate=同時にrap処理できる処理スレッド数の割合〕
〔set rap_notify=Y|N〕
〔set rap_client_manager_node="ホスト名:ポート番号"
                           〔,"ホスト名:ポート番号"〕…〕
〔set rpc_rap_inquire_time=リモートAPI機能を使用して要求するサービスの問い合わせ間隔最大時間〕
〔set rpc_rap_connection_count=常設コネクション最大数〕
〔set rap_client_manager_port=rapクライアントマネジャ機能での受信用ポート番号〕
〔set rap_listen_inf="ノード識別子:ポート番号=ホスト名:ポート番号"
                  〔,"ノード識別子:ポート番号=ホスト名:ポート番号"〕…〕
〔set rpc_rap_watch_time=rapリスナーからの最大応答待ち時間〕
〔set rap_client_hostname=rapクライアントの自ホスト名〕
〔set rpc_reply_tp1mode=Y|N〕
〔set rpc_reply_tp1mode_down=Y|N|J〕
〔set rpc_replymsg_save=Y|N〕
〔set ipc_sendbuf_size_dbq=TCP/IPの送信バッファサイズ〕
〔set ipc_recvbuf_size_dbq=TCP/IPの受信バッファサイズ〕
〔set ipc_backlog_count_dbq=コネクション確立要求を格納するキューの長さ〕
〔set ipc_tcpnodelay_dbq=Y|N〕
〔set rpc_destination_mode=namdonly|namd|definitiononly|definition〕
〔set rpc_retry=Y|N〕
〔set rpc_retry_count=サービス要求送信リトライ回数最大値〕
〔set rpc_retry_interval=サービス要求送信リトライ間隔〕
〔set name_use=Y|N〕
〔set name_cache_size=サービス情報キャッシュ領域のサイズ〕
〔set rpc_nam_watch_time=ネームサーバからの最大応答待ち時間〕
〔set rpc_nam_retry_count=ネームサーバへの要求失敗時のリトライ回数〕
〔set rpc_nam_retry_interval=ネームサーバへの要求失敗時のリトライ間隔〕
〔set rpc_nam_use_time=キャッシュの有効期限〕
〔set rpc_nam_reserve_count=キャッシュ自動同期の保留回数〕
〔set rpc_nam_reserve_time=キャッシュ自動同期の保留期間〕
〔set rpc_nam_eject_rate=キャッシュ追い出し率〕
〔set rpc_name_service_extend=0|1〕
〔set rpc_loadbalance=Y|N〕
〔set rpc_transfer_othersvg=Y|N〕
〔set rpc_myproc_first=Y|N〕
〔set loadcheck_interval=負荷レベル監視間隔〕
〔set loadcheck_type=auto|rate|count〕
〔set levelup_queue_rate=U1,U2〕
〔set leveldown_queue_rate=D0,D1〕
〔set levelup_queue_count=U1,U2〕
〔set leveldown_queue_count=D0,D1〕
〔set scd_retry_of_comm_error=RPCメッセージ転送のリトライ回数〕
〔set loadlevel_message=Y|N|A〕
〔set multi_schedule=Y|N〕
〔set rpc_reply_errtrn3=Y|N〕
〔set rpc_reply_errtrnr=Y|N〕
〔set rpc_reply_errtrnr_cnt=ERRTRNRによるRPC応答メッセージ送信機能の同時使用最大数〕
〔set rpc_tcpsend_con_max_cnt=TCP/IP共有送信用コネクションの最大数〕
〔set rpc_tcpsend_con_cnt=接続先プロセスごとのTCP/IP共有送信用コネクションの最大数〕
〔set rpc_tcpsend_proc_max_cnt=TCP/IP共有送信用コネクションの接続先プロセス最大数〕
〔set rpc_connect_unixdomain=Y|N〕
〔set rpc_reply_port_auto=Y|N〕
〔set rpc_nowait_cnt=非同期応答型RPCの同時要求メッセージの最大数〕
〔set rpc_extend_function=RPCサービスの機能拡張レベル〕
〔set rpc_tcp_linetrace=RPCの回線トレース情報の取得量の変更〕
〔set rpc_rap_linetrace=リモートAPI機能使用時の回線トレース情報の取得量の変更〕
〔set rpc_extend_sb_node_id=Y|N〕
〔set rpc_keepalive_use=Y|N〕
〔set rpc_keepalive_time=keep-aliveプローブを送信するまでの時間〕
〔set rpc_keepalive_interval=keep-aliveプローブを送信する間隔〕
〔set rpc_keepalive_count=keep-aliveプローブを送信する回数〕
〔set rpc_nam_conn_check=Y|N〕
〔set rpc_nam_check_time=コネクション確立先の起動時刻を取得する間隔〕
〔set rpc_nam_check_num=一度に確認するコネクション確立先数〕
〔set rpc_request_cancel_for_timedout=Y|N〕
〔set rpc_request_cancel_for_server=Y|N〕
〔set rpc_reply_sockctl_use=Y|N〕
〔set rpc_reply_sockctl_highwater=送受信用コネクションの一時クローズ処理開始数の割合，送受信用コネクションの一時クローズ処理非対象数の割合〕
〔set rpc_recv_sockctl_use=Y|N〕
〔set rpc_recv_sockctl_highwater=受信用コネクションの一時クローズ処理開始数の割合，受信用コネクションの一時クローズ処理非対象数の割合〕
〔set rpc_connect_conflict_timer=送信開始待ち時間〕
〔set ipc_notify_response_host=Y|N〕

コマンド形式

なし。

機能

RPC関連情報を定義します。

説明

各オペランドについて説明します。

set形式のオペランド

●ipc_sendbuf_size=TCP/IPの送信バッファサイズ　　〜〈符号なし整数〉((8192〜1048576))《8192》（単位：バイト）

コネクションごとに確保されるTCP/IPの送信バッファのサイズを指定します。

高速な通信媒体やMTUの大きな通信媒体を使用している場合，この値を大きくすることによって性能向上を図れます。ただし，イーサネットなどのMTUの小さな通信媒体を使用している場合，性能が悪くなるおそれがあります。

ipc_sendbuf_sizeオペランドには，OSで使用できるTCP/IPの送信バッファのサイズ以下の値を指定してください。また，ipc_sendbuf_sizeオペランドの指定値は，メモリ関連定義のsend_message_buf_sizeオペランドの指定値より大きくすること，コネクション接続先のTCP/IPの受信バッファサイズ（RPC関連定義のipc_recvbuf_sizeオペランドの指定値）以下にすることをお勧めします。

●ipc_recvbuf_size=TCP/IPの受信バッファサイズ　　〜〈符号なし整数〉((8192〜1048576))《8192》（単位：バイト）

コネクションごとに確保されるTCP/IPの受信バッファのサイズを指定します。高速な通信媒体やMTUの大きな通信媒体を使用している場合，この値を大きくすることによって性能向上を図れます。ただし，イーサネットなどのMTUの小さな通信媒体を使用している場合，性能が悪くなるおそれがあります。

ipc_recvbuf_sizeオペランドには，OSで使用できるTCP/IPの受信バッファのサイズ以下の値を指定してください。また，ipc_recvbuf_sizeオペランドの指定値は，コネクション接続先のipc_sendbuf_sizeオペランドの指定値以上にすることをお勧めします。

TCP/IPは，受信したデータに対し，送達確認（ACK）パケットを返信します。受信バッファのサイズに対して受信したデータが小さいと，遅延ACKとなり，データを受信してもすぐにACKを返信しません。ipc_recvbuf_sizeオペランドに大きな値を指定し，小さいデータをやり取りするような通信処理の場合，遅延ACKの影響によって性能が悪くなるおそれがあります。

●ipc_backlog_count=コネクション確立要求を格納するキューの長さ　　〜〈符号なし整数〉((0〜4096))《0》

コネクション確立要求を格納するキューの長さを指定します。

一度に大量のコネクション確立要求を受信すると，キューが不足し，コネクション確立処理に失敗することがあります。その場合，このオペランドでコネクション確立要求を格納するキューの長さを変更し，コネクション確立処理の失敗を防ぐことができます。

0を指定した場合，SOMAXCONNが指定されていると仮定します。SOMAXCONNについては，OSのマニュアルを参照してください。

実際のキューの長さは，指定した値より長くなることがあります。

キューの長さの上限値，下限値は，各OSによって異なります。OSによって，キューの長さの上限値，下限値が制限されている場合，指定した値が有効にならないことがあります。コネクション確立要求を格納するキューについての詳細は，OSのマニュアル，またはTCP/IPの文献を参照してください。

●ipc_tcpnodelay=Y|N　　〜《N》

INETドメインを使用して通信する場合，Nagleアルゴリズムを無効にするかどうかを指定します。

ipc_tcpnodelayオペランドにYを指定してNagleアルゴリズムを無効にした場合は，INETドメイン通信時の送信効率が低下して，ネットワークのトラフィックを増加させるおそれがあります。ipc_tcpnodelayオペランドを指定する場合は，ipc_sendbuf_sizeオペランドの指定値，ipc_recvbuf_sizeオペランドの指定値，ネットワークの帯域などを考慮して，十分検討することをお勧めします。

●service_group_no=サービスグループ名の最大数　　〜〈符号なし整数〉((2〜32767))《自動算出》

TP1/EEが通信に使用するサービスグループ名の最大数を指定します。

サービスグループ情報関連定義のeesvgdef定義コマンドの-gオプションで指定したサービスグループ名定義数に，1を加算した値以上の値を指定してください。DBキューを使用したシステム間通信をする場合は，さらに1を加算した値以上の値を指定してください。

省略した場合は，上記の算出方法によって，サービスグループ名の最大数を自動で算出します。算出した値が最小値未満の場合は最小値を，最大値超過の場合は最大値を設定します。

●hostname_no=ホスト名の最大数　　〜〈符号なし整数〉((2〜32767))《自動算出》

TP1/EEが通信に使用するホスト名の最大数を指定します。

次に示す計算式の値以上の値を指定してください。

サービスグループ情報関連定義のeesvgdef定義コマンドの相手ホスト情報数（ホスト名とポート番号の組み合わせ数）＋サービスグループ情報関連定義のmysvgdef定義コマンドの自ホスト情報数（ポート番号と自ホスト名の組み合わせ数）

省略した場合は，上記の算出方法によって，ホスト名の最大数を自動で算出します。算出した値が最小値未満の場合は最小値を，最大値超過の場合は最大値を設定します。

●socket_no=ソケット用ファイル記述子の最大数　　〜〈符号なし整数〉((32〜20000))《自動算出》

TP1/EEで通信に使用するソケット数の最大値を指定します。

次に示す計算式の合計以上の値を指定してください。

サービスグループ情報関連定義のmysvgdef定義コマンドの-sオプションの指定値×自ホスト情報数（ポート番号と自ホスト名の組み合わせ数）

サービスグループ情報関連定義のeesvgdef定義コマンドの-sオプションの指定値×相手ホスト情報数（ホスト名とポート番号の組み合わせ数）

省略した場合は，上記の算出方法によって，ソケット数の最大値を自動で算出します。算出した値が最小値未満の場合は最小値を，最大値超過の場合は最大値を設定します。

【Linux限定】

プロセス関連定義のdescriptors_expanse_useオペランドを省略，またはNを指定している場合，このオペランドの指定範囲は32〜800となります。

●fragment_buf_no=フラグメントメッセージ用バッファ面数　　〜〈符号なし整数〉((0〜65535))《自動算出》

クライアントから受信したメッセージが，フラグメントメッセージの場合に使用するバッファ面数を指定します。

次に示す計算式の値以上の値を指定してください。

サービスグループ情報関連定義のmysvgdef定義コマンドの-fオプションの指定値×自ホスト情報数（ポート番号と自ホスト名の組み合わせ数）

fragment_buf_noオペランドに0を指定した場合，フラグメントメッセージを受信できません。

省略した場合は，上記の算出方法によって，バッファ面数を自動で算出します。算出した値が最大値超過の場合は最大値を設定します。

●rpc_router_retry_count=TCP/IPバッファ不足発生時のリトライ回数　　〜〈符号なし整数〉((0〜255))《3》

TP1/EEの内部で呼び出すシステムコール（write）でTCP/IPバッファ不足が発生した場合，システムコールをリトライする回数を指定します。

システムコールエラーが多発する場合は，RPC関連定義のipc_sendbuf_sizeオペランド，ipc_sendbuf_size_dbqオペランド，ipc_tcpnodelayオペランド，ipc_tcpnodelay_dbqオペランドの指定値，メモリ関連定義のsend_message_buf_sizeオペランドの指定値，コネクション接続先のTCP/IPの受信バッファサイズなどを見直してください。

●rpc_router_retry_interval=TCP/IPバッファ不足発生時のリトライ間隔　　〜〈符号なし整数〉((1〜200))《35》（単位：ミリ秒）

TP1/EEの内部で呼び出すシステムコール（write）でTCP/IPバッファ不足が発生した場合，システムコールをリトライする間隔を指定します。

システムコールエラーが多発する場合は，RPC関連定義のrpc_router_retry_countオペランドの指定値とあわせて値を見直してください。

●rpc_connect_timer=コネクション確立監視時間　　〜〈符号なし整数〉((1〜60))《10》（単位：秒）

ee_rpc_call関数またはee_rpc_cmtsend関数でサービス要求をする場合，または，DBキューを使用したシステム間通信をする場合に，コネクションが確立されていないとき，コネクションを確立するまでの監視時間を指定します。

サービスグループ情報関連定義のeesvgdef定義コマンドでサービスグループに複数のホストを定義した場合，最初に選択したホストでコネクション確立できないときは，次のホストにコネクション確立要求をします。この場合，ホスト単位にコネクション確立の監視をします。

●rpc_multi_tp1_in_same_host=Y|N　　〜《N》

サービス要求するTP1/Server Baseが同一ホスト内の複数のOpenTP1を同一グローバルドメインとして運用しているかどうかを指定します。

Y

同一ホスト内の複数のTP1/Server Baseを，同一グローバルドメインとして運用しています。

N

同一ホスト内の複数のTP1/Server Baseを，同一グローバルドメインとして運用していません。

同一ホスト内で複数のTP1/Server Baseが動作する環境の場合に，別のTP1/Server Base，または別のTP1/Server Base下のTP1/EEとRPC通信をするときは，rpc_multi_tp1_in_same_hostオペランドにYを指定してください。

●rpc_connect_errmsg=Y|N　　〜《Y》

コネクション確立失敗時にメッセージを出力するかどうかを指定します。対象メッセージはKFSB40322-Eメッセージ，およびKFSB40367-Eメッセージです。

Y

メッセージを出力します。

N

メッセージを出力しません。

●rpc_connect_stopmsg=Y|N　　〜《Y》

コネクション切断時にメッセージを出力するかどうかを指定します。対象メッセージはKFSB40310-Wメッセージです。ただし，リモートAPIの処理の場合は，理由コード0008を付加したKFSB50380-Eメッセージが対象になります。

Y

KFSB40310-Wメッセージを出力します。

N

KFSB40310-Wメッセージを出力しません。

●rpc_support_errmsg=Y|N　　〜《Y》

未サポートメッセージ受信時にメッセージを出力するかどうかを指定します。対象メッセージはKFSB40313-Wメッセージです。

Y

KFSB40313-Wメッセージを出力します。

N

KFSB40313-Wメッセージを出力しません。

●rpc_first_connect_errmsg=Y|N　　〜《N》

コネクション確立後，監視時間内に最初のメッセージを受信しなかった場合のコネクション切断時にメッセージを出力するかどうかを指定します。対象メッセージはKFSB50310-Eメッセージです。ただし，リモートAPIの処理の場合は，理由コード0009を付加したKFSB50380-Eメッセージが対象になります。

Y

KFSB50310-Eメッセージを出力します。

N

KFSB50310-Eメッセージを出力しません。

●rpc_firstmsg_recv_timer=コネクション確立の受け付けから最初のメッセージ受信までの監視時間　　〜〈符号なし整数〉((0〜600))《0》（単位：秒）

コネクション確立要求を受け付けてから，最初のメッセージを受信するまでの監視時間を指定します。

指定時間内にメッセージを受信しなかった場合は，コネクションを切断します。タイムアウト時間は，最大で10秒の誤差が生じます。0を指定した場合は，時間監視をしません。

●rpc_first_connect_errmsg_dbq=Y|N　　〜《N》

DBキューを使用したシステム間通信をTCP/IP通信によって行う場合，コネクション確立後，監視時間内に最初のDBキューイベント通知メッセージを受信しなかったときのコネクション切断時にKFSB50312-Eメッセージを出力するかどうかを指定します。

Y

KFSB50312-Eメッセージを出力します。

N

KFSB50312-Eメッセージを出力しません。

●rpc_firstmsg_recv_timer_dbq=コネクション確立の受け付けから最初のDBキューイベント通知メッセージ受信までの監視時間　　〜〈符号なし整数〉((0〜600))《0》（単位：秒）

DBキューを使用したシステム間通信をTCP/IP通信によって行う場合，コネクション確立要求を受け付けてから，最初のDBキューイベント通知メッセージを受信するまでの監視時間を指定します。

指定時間内にメッセージを受信しなかった場合は，コネクションを切断します。タイムアウト時間は，最大で10秒の誤差が生じます。0を指定した場合は，時間監視をしません。

●rpc_recivingconnect_stopmsg_dbq=Y|N　　〜《Y》

DBキューを使用した他システム間通信をTCP/IP通信で行う場合，相手システムからのメッセージ受信中にコネクション切断を検知したときに出力しているメッセージを，出力するかどうかを指定します。抑止の対象となるメッセージはKFSB50312-Eの理由コード「0020」です。

Y

出力します。

N

出力しません。

相手システムがデータ連携支援の場合は，KFSB50312-Eメッセージが多発する可能性があるため，このオペランド値にNを指定することを推奨します。

●rpc_conn_recv_check_use=Y|N　　〜《N》

送信用コネクションの受信監視を行うかどうかを指定します。

name_useオペランドの設定値がYの場合は，このオペランド指定値は無効となります。

Y

受信監視を行います。

N

受信監視を行いません。

●rpc_conn_recv_check_interval=送信用コネクションの受信監視を行う間隔　　〜〈符号なし整数〉((1〜3600))《120》（単位：秒）

このオペランド指定値ごとに，送信用コネクションで受信イベントが発生しているかどうかの監視処理を行います。

このオペランド指定値が大きい場合は，コネクションの受信イベントを検知するまでの時間が長くなります。

このオペランド指定値が小さい場合は，システムの負荷が増加します。また，RPC要求電文の送信処理が遅延する頻度が高くなる可能性があります。

rpc_conn_recv_check_useオペランドの設定値がNの場合は，このオペランド指定値は無効となります。

●node_id=ノード識別子　　〜〈4文字の識別子〉

OpenTP1システム内で一意となるノード識別子を指定します。

このオペランドは省略できません。必ず指定してください。

●watch_time=最大応答待ち時間　　〜〈符号なし整数〉((0〜65535))《180》（単位：秒）

RPCによってプロセス間通信をする場合，サービス要求を送信してからサービスの応答が返るまでの待ち時間の最大値を指定します。

TP1/EEの終了処理で，watch_timeオペランドで指定した時間だけ終了処理を待ち合わせる場合があります。したがって，watch_timeオペランドに大きな値を指定した場合，TP1/EEの終了処理に時間が掛かることがあります。

指定時間を過ぎても応答がない場合は，RPCは送受信タイムアウトとしてエラーリターンします。

0を指定した場合は，応答を受信するまで待ち続けます。0を指定した場合，TP1/EEが終了しないことがあります。

●rpc_reply_con_max_cnt=サービス応答用コネクションの最大数　　〜〈符号なし整数〉((32〜20000))《256》

サービス応答用コネクションの最大数を指定します。

サービス応答の受信時にサービス応答用コネクションが指定値を超えた場合，サービス応答メッセージの受信はエラーになります。

サービス応答の送信時にサービス応答用コネクションが指定値を超えた場合，サービス応答メッセージの送信後，コネクションを切断します。

rpc_reply_con_max_cntオペランドには，（プロセス関連定義のthread_noオペランドの指定値＋プロセス関連定義のreserve_thread_noオペランドの指定値＋RPC関連定義のrpc_reply_proc_max_cntオペランドの指定値＋（TP1/FSPのタイマ関連定義のtim_perm_thread_noオペランドの指定値＋1）＋1）以上の値を指定してください。

ネームサービスを使用する場合は，rpc_reply_con_max_cntオペランドの指定値をサービス要求送信時のコネクションにも使用します。このため，rpc_reply_con_max_cntオペランドには，（プロセス関連定義のthread_noオペランドの指定値＋プロセス関連定義のreserve_thread_noオペランドの指定値＋RPC関連定義のrpc_reply_proc_max_cntオペランドの指定値＋（TP1/FSPのタイマ関連定義のtim_perm_thread_noオペランドの指定値＋1）＋1）および（接続先プロセス数×RPC関連定義のrpc_reply_con_cntオペランドの指定値）の合計値を指定してください。tim_perm_thread_noオペランドについては，TP1/FSPの関連ドキュメントを参照してください。

TP1/FSPのeechglib，eesvctl，eesdhchg，eeucmdコマンドを他ノードで実行する場合，実行するノード数分の値を本定義値に加算してください。

【Linux限定】

プロセス関連定義のdescriptors_expanse_useオペランドを省略，またはNを指定している場合，このオペランドの指定範囲は32〜800となります。

●rpc_reply_con_cnt=接続先プロセスごとのサービス応答用コネクションの最大数　　〜〈符号なし整数〉((1〜20000))《2》

接続先プロセスごとのサービス応答用コネクションの最大数を指定します。

該当プロセスに対するサービス応答用コネクション数が指定値を超えた場合，サービス応答メッセージの送受信後，コネクションを切断します。

TP1/FSPのeechglib，eesvctl，eesdhchg，eeucmdコマンドを他ノードで実行する場合，実行するノード数分の値を本定義値に加算してください。

【Linux限定】

プロセス関連定義のdescriptors_expanse_useオペランドを省略，またはNを指定している場合，このオペランドの指定範囲は1〜800となります。

●rpc_reply_proc_max_cnt=サービス応答用コネクションの接続先プロセス最大数　　〜〈符号なし整数〉((32〜20000))《128》

サービス応答用コネクションの接続先プロセスの最大数を指定します。

サービス応答用コネクションの接続先プロセス数が指定値を超えた場合，サービス応答メッセージの送受信後，コネクションを切断します。

次に示す計算式の値以上の値を指定してください。

（要求元のプロセス数※1＋（要求先のプロセス数※1×2）＋SPP数＋（TP1/SB数×3）＋1）×1.5※²

注※1

次に示すAPIとコマンドを使用している場合，APIとコマンドを実行している側が要求元のプロセスになります。自サーバ読み出し，またはDBキュー読出しサーバ変更機能を使用するTP1/EEのプロセスが要求先のプロセスになります。

ee_dbq_inquire2関数（flagsにEEDBQ_REQ_READSTATUSを指定）

ee_dbq_acsctl関数（flagsにEEDBQ_ACSCTL_ANYを指定）

eedbqlsコマンド

eedbqstopコマンド

eedbqrstコマンド

注※2

安全率です。

また次の条件に当てはまる場合は説明に従って指定値を加算してください。

ネーム機能を使用する場合は「1」を加算してください。

RPC関連定義のrpc_nam_conn_checkオペランドにYを指定している場合は「1」を加算してください。

ee_adm_call_command関数を使用している場合は「同時実行数+1」を加算してください。

負荷分散構成の場合は，同一サービスグループ名の各TP1/EEに「プロセス数-1」を加算してください。

TP1/FSPのeechglibコマンド，eesvctlコマンド，またはeesdhchgコマンドを他ノード実行する場合は，コマンド投入元に「他ノード実行先プロセス数×2」，他ノード実行先に「1」を加算してください。

TP1/FSPのeeucmdコマンドを他ノード実行する場合は，コマンド投入元に「他ノード実行先数プロセス数×2」，他ノード実行先に「1」を加算してください。

TP1/FSPのOBM機能を使用する場合は，BCM側に次の合計値を加算してください。

eeobmstartコマンドの同時実行数×2

BCS数×3

TP1/FSPのOBM機能を使用する場合は，BCS側に「3」を加算してください。

TP1/FSPのタイマ永続化機能を使用する場合は，タイマ監視するTP1/EEに「2」，タイマ登録/起動するTP1/EEに「1」を加算してください。

【Linux限定】

プロセス関連定義のdescriptors_expanse_useオペランドを省略，またはNを指定している場合，このオペランドの指定範囲は32〜800となります。

●rpc_reply_suspend_cnt=RPC応答メッセージ送信の同時抑止最大数　　〜〈符号なし整数〉((0〜32767))《128》

別トランザクションによるRPC同期応答機能で，RPC応答を同時に抑止できる最大数を指定します。

同時抑止数が指定値を超えた場合，RPC応答を抑止するee_rpc_reply_suspend関数はエラーリターンします。

0を指定した場合，RPC応答メッセージ送信を抑止しません。

●rpc_reply_suspend_time=RPC応答メッセージ送信の抑止最大時間　　〜〈符号なし整数〉((0〜65535))《180》（単位：秒）

別トランザクションによるRPC同期応答機能で，RPC応答を抑止する最大時間を指定します。

抑止時間が指定値を超えた場合，RPCエラー応答メッセージが自動的に送信されます。以降に呼び出したee_rpc_reply_send関数はエラーリターンします。

0を指定した場合，抑止時間は無制限になります。

抑止時間は5秒間隔で監視するため，RPCエラー応答メッセージの送信は，rpc_reply_suspend_timeオペランドの指定値より最大で5秒の遅延が発生する場合があります。

●rpc_reply_suspend_recover=Y|N　　〜《Y》

別トランザクションによるRPC同期応答機能をTP1/EE再開始時に引き継ぐかどうかを指定します。

Y

TP1/EE再開始時に前回のRPC応答の抑止状態を引き継ぎます。

N

TP1/EE再開始時に前回のRPC応答の抑止状態を引き継ぎません。

●rpc_reply_suspend_autosend=Y|N　　〜《N》

別トランザクションによるRPC同期応答機能で，TP1/EE再開始時に，抑止中のRPC応答の抑止状態を自動的に解除してRPC応答を送信するかどうかを指定します。

Y

TP1/EE再開始時に抑止中のRPC応答の抑止状態を自動的に解除してRPC応答を送信します。

N

TP1/EE再開始時に抑止中のRPC応答の抑止状態を自動的に解除してRPC応答を送信しません。

rpc_reply_suspend_autosendオペランドは，rpc_reply_suspend_recoverオペランドにYを指定している場合だけ有効です。

●rap_listen_port=リモートAPI受信用のポート番号　　〜〈符号なし整数〉((5001〜65535))

リモートAPI受信用のポート番号を指定します。

TP1/EEを複数起動する場合は，TP1/EE（プロセス）ごとにポート番号を変えてください。また，TP1/EE以外のプログラムが特定のポート番号を使用している場合は，その特定のポート番号と異なるポート番号を指定してください。

このオペランドで指定するポート番号は自ホストで使用するポート番号と重複しないようにしてください。

OSが任意に割り当てるポート番号は指定しないでください。OSが任意に割り当てるポート番号は，OSの種別やバージョンによって異なります。詳細については使用しているOSのマニュアルを参照してください。

rap_listen_portオペランドを省略した場合は，リモートAPI機能は使用できません。

●rap_inquire_time=問い合わせ間隔最大時間　　〜〈符号なし整数〉((0〜1048575))《180》（単位：秒）

rapクライアントからのリモートAPI要求に対して応答メッセージ送信後，次のリモートAPI要求が来るまでの最大待ち時間を指定します。この値は，TP1/EE側で監視するタイマです。指定時間を超えてもリモートAPI要求を受信できない場合，rapクライアントがダウンしたと判断して処理します。

rap_inquire_timeオペランドに0を指定し，かつ，rapクライアントが常駐SPPの場合，常設コネクションが解放されないことがあります。この場合は，eerpcrapclsコマンドで常設コネクションを切断するか，または，eesvstopコマンドの-fオプションでTP1/EEプロセスを強制終了させます。

rap_inquire_timeオペランドの指定値は，rapクライアント側のTP1/Server Baseのユーザサービス定義のrpc_rap_inquire_timeオペランドに0を指定した場合に，有効になります。rapクライアント側のrpc_rap_inquire_timeオペランドに0以外を指定した場合は，rapクライアント側で指定したrpc_rap_inquire_timeオペランドの指定値が有効になります。

●rap_inquire_timeout_message=Y|N　　〜《Y》

クライアントからのリモートAPI要求の最大待ち時間を超えた場合に，エラーメッセージを出力するかどうかを指定します。

Y

クライアントからのリモートAPI要求の最大待ち時間を超えたことを検知したとき，KFSB50380-Eメッセージを出力します。

N

クライアントからのリモートAPI要求の最大待ち時間を超えたことを検知しても，KFSB50380-Eメッセージを出力しません。

●rpc_rap_remaincon_endwait=Y|N|F　　〜《N》

TP1/EEの正常終了または計画停止Aの実行時に，接続中のrapクライアントがある場合のTP1/EEの終了処理の動作を指定します。

Y

rapクライアントとの接続が解除されるまでプロセス終了を待ちます。

N

rapクライアントに解放を通知して，rapクライアントとの接続を解除します。

F

rapクライアントに解放を通知しないで，rapクライアントとの接続を強制解除します。

●rap_msg_output_interval=rapクライアント数表示メッセージの出力間隔　　〜〈符号なし整数〉((0〜3600))《180》（単位：秒）

rapサーバとして動作している場合

rpc_rap_remaincon_endwaitオペランドにYを指定した場合，TP1/EEの正常終了または計画停止Aの実行時に，rapクライアントとの接続が解除されるまでTP1/EEプロセスの終了を待ち合わせます。この場合，rap_msg_output_intervalオペランドで指定した間隔で，接続中のrapクライアント数表示メッセージを出力します。

rap_msg_output_intervalオペランドに0を指定した場合は，rapクライアント数表示メッセージを一度だけ出力します。

rapクライアントとして動作している場合

TP1/EEの正常終了または計画停止Aの実行時にrapリスナーとの接続が解除されるまでTP1/EEプロセスの終了を待ち合わせます。この場合，rap_msg_output_intervalオペランドで指定した間隔で，接続中のrapリスナー数表示メッセージを出力します。

rap_msg_output_intervalオペランドに0を指定した場合は，rapリスナー数表示メッセージを一度だけ出力します。

●rap_max_client=同時接続可能なrapクライアント数　　〜〈符号なし整数〉((128〜20000))《256》

同時に接続できるrapクライアント数を指定します。rap_max_clientオペランドの指定値を超えてrapクライアントが接続要求をしてきた場合は，rapクライアントに対して接続数超過のエラーを返します。

【Linux限定】

プロセス関連定義のdescriptors_expanse_useオペランドを省略，またはNを指定している場合，このオペランドの指定範囲は128〜800となります。

●rap_max_server_rate=同時にrap処理できる処理スレッド数の割合　　〜〈符号なし整数〉((1〜100)《40》（単位：%）

同時にリモートAPI処理を実行できる処理スレッドの割合を指定します。

rap_max_server_rateオペランドの指定値を基に，次の計算式で同時にリモートAPI処理を実行できる処理スレッド数を算出します。

プロセス関連定義のthread_noオペランドの指定値×（rap_max_server_rateオペランドの指定値÷100）

小数点以下は切り捨てます。計算結果が0の場合は，同時にリモートAPI処理を実行できる処理スレッド数に1を設定します。計算結果が255以上の場合は，同時にリモートAPI処理を実行できる処理スレッド数に255を設定します。

rap_max_server_rateオペランドの指定値を超えてリモートAPI要求を受け付けた場合は，処理中のリモートAPIが終了後，次のリモートAPI要求が処理されます。

rap_max_server_rateオペランドの指定値を大きくすると，リモートAPI機能で処理スレッドを占有し，RPCサービスを行う処理スレッドが不足するおそれがあります。

自サービスグループに対する代理実行は，rap_max_server_rateオペランドの指定値の影響を受けません。

リモートAPI機能を使用する場合は，処理スレッド数を2以上に指定してください。

●rap_notify=Y|N　　〜《N》

RPC関連定義のrap_client_manager_nodeオペランドで指定したノードのrapクライアントマネジャに対して起動通知を送信するかどうかを指定します。

Y

起動通知を送信します。

N

起動通知を送信しません。

RPC関連定義のrap_listen_portオペランドの指定が省略されている場合，このオペランドの指定は無視されます。

●rap_client_manager_node="ホスト名:ポート番号"〔,"ホスト名:ポート番号"〕…

RPC関連定義のrap_notifyオペランドにYを指定して起動通知する場合に，このオペランドに指定したノードで起動するOpenTP1のrapクライアントマネジャに対して起動通知を行います。

rap_notifyオペランドにYを指定した場合，このオペランドの指定は省略できません。

ホスト名　　〜〈1〜255文字のホスト名〉

OpenTP1システムのホスト名を指定します。ホスト名とは，/etc/hostsに定義したホスト名のことです。

ポート番号　　〜〈符号なし整数〉((1〜65535))

OpenTP1システムのrapクライアントマネジャのポート番号を指定します。

●rpc_rap_inquire_time=リモートAPI機能を使用して要求するサービスの問い合わせ間隔最大時間　　〜〈符号なし整数〉((0〜1048575))《0》（単位：秒）

リモートAPI機能を使用してサービスを要求する場合に，リモートAPI制御プロセスがUAPからのサービス要求を処理してから，次のサービス要求を処理するまでの間隔の，最大待ち時間を指定します。このオペランドの指定値は，rapサーバ側で監視するタイマであり，指定時間を超えても次のサービス要求がない場合，rapサーバのリモートAPI制御プロセスは，UAPがダウンしたものと見なして処理します。

このオペランドに0を指定した場合，リモートAPI制御プロセス側の定義で指定した値が有効になります。

●rpc_rap_connection_count=常設コネクション最大数　　〜〈符号なし整数〉((1〜800))《16》

常設コネクションの最大数を指定します。このオペランドの指定値を超えてrapサーバへの接続要求を行った場合は，最も古く，かつ使用されていない常設コネクションを解放したあとで，新しく常設コネクションを確立します。

サービスグループ情報関連定義のeesvgdef定義コマンドの-tオプションにRAP（リモートAPI通信を使用する）が指定されていない場合，このオペランドの指定は無視されます。

●rap_client_manager_port=rapクライアントマネジャ機能での受信用ポート番号　　〜〈符号なし整数〉((5001〜65535))

rapクライアントマネジャ機能で使用する受信用のポート番号を指定します。

このオペランドを指定する場合，次のことに注意してください。

TP1/EEを複数起動する場合は，TP1/EEプロセスごとにポート番号を変えてください。

TP1/EE以外のプログラムが特定のポート番号を使用している場合は，その特定のポート番号とは異なる番号を指定してください。

このオペランドで指定するポート番号が，自ホストで使用するポート番号と重複しないようにしてください。

OSには任意に割り当てる番号がありますが，この番号を指定しないでください。OSが任意に割り当てる番号は，OSの種別やバージョンによって異なります。詳細は，使用しているOSのマニュアルを参照してください。

サービスグループ情報関連定義のeesvgdef定義コマンドの-tオプションにRAP（リモートAPI通信を使用する）が指定されていない場合，このオペランドの指定は無視されます。

このオペランドの指定を省略した場合，rapクライアントマネジャ機能を使用することはできません。

●rap_listen_inf="ノード識別子:ポート番号=ホスト名:ポート番号"〔,"ノード識別子:ポート番号=ホスト名:ポート番号"〕…

監視するrapリスナーを指定します。

"ノード識別子※1:ポート番号※2=ホスト名※3:ポート番号※4"

注※1　ノード識別子　　〜〈4文字の識別子〉

rapリスナーを起動するOpenTP1ノードのノード識別子のことです。

注※2　ポート番号　　〜〈符号なし整数〉((5001〜65535))

rapリスナーのポート番号のことです。

注※3　ホスト名　　〜〈1〜255文字のホスト名〉

リモートAPI機能によるサービスの受信口となるホスト名で，サービスグループ情報関連定義のeesvgdef定義コマンドに指定しているホスト名のことです。

注※4　ポート番号　　〜〈符号なし整数〉((1〜65535))

リモートAPI機能によるサービスの受信口となるポート番号で，サービスグループ情報関連定義のeesvgdef定義コマンドに指定しているポート番号のことです。

rap_client_manager_portオペランドの指定が省略されているか，またはサービスグループ情報関連定義のeesvgdef定義コマンドの-tオプションにRAP（リモートAPI通信を使用する）が指定されていない場合，このオペランドの指定は無視されます。

●rpc_rap_watch_time=rapリスナーからの最大応答待ち時間　　〜〈符号なし整数〉((0〜65535))（単位：秒）

rapリスナーと常設コネクションの確立・解放処理を行う場合の，確立要求を送信してから応答が返るまでの待ち時間の最大値を指定します。指定時間を過ぎても応答がない場合，RPCは送受信タイムアウトとしてエラーリターンします。

このオペランドに0を指定した場合は，応答を受信するまで待ち続けます。0を指定した場合，TP1/EEが終了しないことがあります。

このオペランドの指定を省略した場合は，RPC関連定義のwatch_timeオペランドの値を仮定します。また，ee_rpc_set_watch_time関数でサービスの応答待ち時間を更新した場合，ee_rpc_set_watch_time関数で指定した値が有効になります。

サービスグループ情報関連定義のeesvgdef定義コマンドの-tオプションにRAP（リモートAPI通信を使用する）が指定されていない場合，このオペランドの指定は無視されます。

●rap_client_hostname=rapクライアントの自ホスト名　　〜〈1〜255文字のホスト名〉

TP1/EEがrapクライアントとして動作する構成では，常設コネクションのrapクライアント側IPアドレスを明示的に設定したい場合，このオプションで自ホスト名を指定します。このオプションを省略した場合は，OSが自動的にIPアドレスを設定します。

自ホスト名は，/etc/hostsファイルまたはDNSなどで，IPアドレスとマッピングできなければなりません。

なお，ホスト名にlocalhostなどIPアドレスが127.0.0.1となるホスト名を指定しないでください。

このオペランドは，自マシンに複数のIPアドレスがあり（複数のネットワークインタフェースが実装されているマシン，エイリアスIPアドレスが設定されているマシンなど），かつ，OSで自動設定したIPアドレスがファイアウォールなどで通信ブロックされるような場合に指定してください。

●rpc_reply_tp1mode=Y|N　　〜《Y》

TP1/EEに対して非トランザクショナルRPCを使用した場合，TP1/EEはトランザクション決着後にRPC応答を送信します。このとき，TP1/Server Base互換のRPC応答モードかどうかを指定します。

Y

TP1/Server Base互換のRPC応答モードです。トランザクションの結果に関係なく，RPC正常応答を送信します。

N

TP1/EE独自のRPC応答モードです。トランザクションがコミットした場合は，RPC正常応答を送信し，コミット以外（ロールバック，コミットとロールバックとが混在，決着結果が不明）の場合は，RPCエラー応答（EERPCER_TRNCHK_EXTEND）を送信します。

rpc_reply_tp1mode_downオペランドにJを指定した場合は，rpc_reply_tp1modeオペランドに必ずYを指定してください。Nを指定すると，RPCエラー応答からトランザクション決着結果を判断することができません。

●rpc_reply_tp1mode_down=Y|N|J　　〜《Y》

TP1/EEに対して非トランザクショナルRPCを実行した場合で，RPC要求先のTP1/EEがスレッドダウンまたはプロセスダウンしたとき，TP1/EEはトランザクション決着後にRPCエラー応答を送信します。このとき，ダウン時のRPCエラー応答がTP1/Server Base互換のRPC応答モードかどうかを指定します。

Y

TP1/Server Base互換のRPC応答モードです。トランザクションの結果に関係なく，RPCエラー応答（EERPCER_TIMED_OUT）を送信します。

N

TP1/EE独自のRPC応答モードです。トランザクションがコミットした場合は，RPCエラー応答（EERPCER_NO_BUFS_AT_SERVER）を送信します。コミット以外（ロールバック，コミットとロールバックとが混在，決着結果が不明）の場合は，RPCエラー応答（EERPCER_TRNCHK_EXTEND）を送信します。

J

TP1/EE独自のRPC応答モードです。トランザクションがロールバックした場合は，RPCエラー応答（EERPCER_TRNCHK_EXTEND）を送信します。ロールバック以外（コミット，コミットとロールバックとが混在，決着結果が不明）の場合は，RPCエラー応答（EERPCER_TIMED_OUT）を送信します。

rpc_reply_tp1mode_downオペランドにJを指定した場合は，rpc_reply_tp1modeオペランドに必ずYを指定してください。Nを指定すると，RPCエラー応答からトランザクション決着結果を判断することができません。

rpc_reply_tp1mode_downオペランドの指定値とトランザクション決着結果に応じたRPCエラー応答の一覧を次の表に示します。

表8‒4　rpc_reply_tp1mode_downオペランドの指定値とトランザクション決着結果に応じたRPCエラー応答

rpc_reply_tp1mode_downオペランドの指定値

トランザクション決着結果

RPCエラー応答

Y

コミット

EERPCER_TIMED_OUT

ロールバック

コミットとロールバックとが混在，または決着結果が不明

N

コミット

EERPCER_NO_BUFS_AT_SERVER

ロールバック

EERPCER_TRNCHK_EXTEND

コミットとロールバックとが混在，または決着結果が不明

J

コミット

EERPCER_TIMED_OUT

ロールバック

EERPCER_TRNCHK_EXTEND

コミットとロールバックとが混在，または決着結果が不明

EERPCER_TIMED_OUT

●rpc_replymsg_save=Y|N　　〜《Y》

スレッドダウン，または，通信障害やリソースマネジャ障害を監視する監視スレッドに，サービス関数で設定した応答データ（out）の内容をスレッド間で引き継ぐかどうかを指定します。

Y

応答データを引き継ぎ，トランザクション決着時にRPC応答を送信します。

応答データは送信バッファ上に退避されます。そのため，スレッドダウンまたは監視スレッドでの監視が多発した場合，送信バッファが不足するおそれがあります。送信バッファが不足した場合，応答データを引き継がないで，トランザクション決着時にRPCエラー応答（EERPCER_NO_BUFS_AT_SERVER）を送信します。

N

応答データを引き継がないで，トランザクション決着時にRPCエラー応答（EERPCER_NO_BUFS_AT_SERVER）を送信します。

●ipc_sendbuf_size_dbq=TCP/IPの送信バッファサイズ　　〜〈符号なし整数〉((1024〜1048576))《1024》（単位：バイト）

DBキューを使用したシステム間通信をTCP/IP通信で行う場合，使用するコネクションごとに確保されるTCP/IPの送信バッファサイズを指定します。

高速な通信媒体やMTUの大きな通信媒体を使用している場合，この値を大きくすることによって性能向上を図れます。ただし，イーサネットなどのMTUの小さな通信媒体を使用している場合，性能が悪くなるおそれがあります。

ipc_sendbuf_size_dbqオペランドには，OSで使用できるTCP/IPの送信バッファのサイズ以下の値を指定してください。また，ipc_sendbuf_size_dbqオペランドの指定値は，コネクション接続先のTCP/IPの受信バッファサイズ（RPC関連定義のipc_recvbuf_size_dbqオペランドの指定値）以下にすることをお勧めします。

●ipc_recvbuf_size_dbq=TCP/IPの受信バッファサイズ　　〜〈符号なし整数〉((1024〜1048576))《1024》（単位：バイト）

DBキューを使用したシステム間通信をTCP/IP通信で行う場合，使用するコネクションごとに確保されるTCP/IPの受信バッファサイズを指定します。

高速な通信媒体やMTUの大きな通信媒体を使用している場合，この値を大きくすることによって性能向上を図れます。ただし，イーサネットなどのMTUの小さな通信媒体を使用している場合，性能が悪くなるおそれがあります。

ipc_recvbuf_size_dbqオペランドには，OSで使用できるTCP/IPの受信バッファのサイズ以下の値を指定してください。また，ipc_recvbuf_size_dbqオペランドの指定値は，コネクション接続先のTCP/IPの送信バッファサイズ（RPC関連定義のipc_sendbuf_size_dbqオペランドの指定値）より大きい値にすることをお勧めします。

TCP/IPは，受信したデータに対し，送達確認（ACK）パケットを返信します。受信バッファのサイズに対して受信したデータが小さいと，遅延ACKとなり，データを受信してもすぐにACKを返信しません。ipc_recvbuf_size_dbqオペランドに大きな値を指定し，小さいデータをやり取りするような通信処理の場合，遅延ACKの影響によって性能が悪くなるおそれがあります。遅延ACKについては，TCP/IPの文献を参照してください。

●ipc_backlog_count_dbq=コネクション確立要求を格納するキューの長さ　　〜〈符号なし整数〉((0〜4096))《0》

DBキューを使用したシステム間通信をTCP/IP通信で行う場合，コネクション確立要求を格納するキューの長さを指定します。

一度に大量のコネクション確立要求を受信すると，キューが不足し，コネクション確立処理に失敗することがあります。その場合，このオペランドでコネクション確立要求を格納するキューの長さを変更し，コネクション確立処理の失敗を防ぐことができます。

0を指定した場合，SOMAXCONNが指定されていると仮定します。SOMAXCONNについては，OSのマニュアルを参照してください。

実際のキューの長さは，指定した値より長くなることがあります。

キューの長さの上限値，下限値は，各OSによって異なります。OSによって，キューの長さの上限値，下限値が制限されている場合，指定した値が有効にならない場合があります。コネクション確立要求を格納するキューについての詳細は，OSのマニュアル，またはTCP/IPの文献を参照してください。

●ipc_tcpnodelay_dbq=Y|N　　〜《N》

DBキューを使用したシステム間通信をTCP/IP通信で行う場合，Nagleアルゴリズムを無効にするかどうかを指定します。

ipc_tcpnodelay_dbqオペランドにYを指定し，Nagleアルゴリズムを無効にした場合，通信時の送信効率が低下して，ネットワークのトラフィックを増加させるおそれがあります。ipc_tcpnodelay_dbqオペランドを指定する場合は，RPC関連定義のipc_sendbuf_size_dbqオペランドの指定値，ipc_recvbuf_size_dbqオペランドの指定値，ネットワークの帯域などを考慮して，この機能の必要性を十分に検討してください。なお，Nagleアルゴリズムの詳細については，TCP/IPの文献を参照してください。

●rpc_destination_mode=namdonly|namd|definitiononly|definition　　〜《definition》

ee_rpc_call関数またはee_rpc_cmtsend関数を使用したサービスの要求先の決定方法を指定します。

RPC関連定義のname_useオペランドにNを指定した場合，rpc_destination_modeオペランドの指定は無効になります。

namdonly

ネームサービスから取得したあて先にサービスを要求します。サービスグループ情報関連定義のeesvgdef定義コマンドの指定値の検索は一切しません。

namd

ネームサービスから取得したあて先にサービスを要求します。

ネームサービスから取得したあて先に該当するサービスが見つからない場合は，サービスグループ情報関連定義のeesvgdef定義コマンドの指定値を検索します。

definition

サービスグループ情報関連定義のeesvgdef定義コマンドの指定値から取得したあて先にサービスを要求します。eesvgdef定義コマンドの指定値に該当するサービスグループが見つからない場合，または，通信障害が発生した場合は，ネームサービスに登録されているあて先を検索します。

definitiononly

サービスグループ情報関連定義のeesvgdef定義コマンドの指定値から取得したあて先にサービスを要求します。ネームサービスに登録されているあて先の検索は一切しません。

●rpc_retry=Y|N　　〜《N》

別ノードに対するTP1/EEのRPCでは，系切り替え中などの，相手サーバが起動していない場合，通信障害が起こり，サービス要求がエラーになるおそれがあります。このとき，RPCをリトライするかどうかを指定します。

RPC関連定義のname_useオペランドにNを指定した場合，rpc_retryオペランドの指定は無効になります。

Y

RPCをリトライします。

N

RPC関連定義のrpc_retry_countオペランドおよびrpc_retry_intervalオペランドの指定値を無視して，RPCを1回だけリトライします。

●rpc_retry_count=サービス要求送信リトライ回数最大値　　〜〈符号なし整数〉((1〜3600))《18》

サービス要求のあて先をネームサービスから取得した場合，サービス要求メッセージを送信するリトライ回数の最大値を指定します。

RPC関連定義のrpc_retryオペランドにYを指定した場合は，rpc_retry_countオペランドの指定は有効になります。rpc_retryオペランドにNを指定した場合は，rpc_retry_countオペランドおよびrpc_retry_intervalオペランドの指定値に関係なく，RPCを1回だけリトライします。

RPC関連定義のname_useオペランドにNを指定した場合，rpc_retry_countオペランドの指定は無効になります。

●rpc_retry_interval=サービス要求送信リトライ間隔　　〜〈符号なし整数〉((1〜3600))《10》（単位：秒）

サービス要求のあて先をネームサービスから取得した場合，サービス要求メッセージを送信するリトライ間隔を指定します。

RPC関連定義のrpc_retryオペランドにYを指定した場合は，rpc_retry_intervalオペランドは有効になります。rpc_retryオペランドにNを指定した場合は，rpc_retry_countオペランドおよびrpc_retry_intervalオペランドの指定値に関係なく，RPCを1回だけリトライします。

RPC関連定義のname_useオペランドにNを指定した場合，rpc_retry_intervalオペランドの指定は無効になります。

●name_use=Y|N　　〜《Y》

ネームサービスを使用するかどうかを指定します。

Y

ネームサービスを使用します。

N

ネームサービスを使用しません。

●name_cache_size=サービス情報キャッシュ領域のサイズ　　〜〈符号なし整数〉((1〜32768))《16》（単位：キロバイト）

自TP1/EEプロセスが確保するサービス情報のキャッシュ領域のサイズを指定します。

サービス情報のキャッシュ領域のサイズは，他ノードに登録されているサービス情報のうち，自ノードから検索を要求するサービス情報の数を基に計算します。

サービス情報のキャッシュ領域のサイズを大きくすると，他ノードのサービス情報を検索するときの応答性能が向上します。ただし，必要以上に大きくした場合，OpenTP1システム全体のメモリを圧迫します。

サービス情報のキャッシュ領域のサイズは，次に示す計算式で算出します。

キャッシュ領域の大きさ=
  ↑（サービスグループ数※1×（1＋平均プロセス数※2）×160×1.2）÷1024↑

↑↑：小数点以下を切り上げます。

注※1

サービスグループ数とは，自プロセスからRPC要求をするサービスグループの数です。

注※2

平均プロセス数とは，同一サービスグループ名のSPPまたはTP1/EEの数の平均です。

RPC関連定義のname_useオペランドにNを指定した場合，name_cache_sizeオペランドの指定は無効になります。

●rpc_nam_watch_time=ネームサーバからの最大応答待ち時間　　〜〈符号なし整数〉((0〜65535))《60》（単位：秒）

ネームサーバに対してサービス検索要求を送信してからサービス検索応答が返るまでの待ち時間の最大値を指定します。

rpc_nam_watch_timeオペランドで指定した時間だけTP1/EEの終了処理を待ち合わせる場合があります。したがって，rpc_nam_watch_timeオペランドに大きな値を指定した場合，TP1/EEの終了処理に時間が掛かることがあります。

指定時間を過ぎても応答がない場合は，RPCはネットワーク障害としてエラーリターンします。

0を指定した場合は，応答を受信するまで待ち続けます。0を指定した場合，TP1/EEが終了しないことがあります。

指定時間を過ぎたかどうかは，5秒間隔でチェックします。そのため，最大で5秒の誤差が生じます。

RPC関連定義のname_useオペランドにNを指定した場合，rpc_nam_watch_timeオペランドの指定は無効になります。

●rpc_nam_retry_count=ネームサーバへの要求失敗時のリトライ回数　　〜〈符号なし整数〉((0〜64))《5》

ネームサーバへのサービス検索要求失敗時のリトライ回数を指定します。

0を指定した場合は，リトライしません。

RPC関連定義のname_useオペランドにNを指定した場合，rpc_nam_retry_countオペランドの指定は無効になります。

●rpc_nam_retry_interval=ネームサーバへの要求失敗時のリトライ間隔　　〜〈符号なし整数〉((1〜60))《5》（単位：秒）

ネームサーバへのサービス検索要求失敗時のリトライ間隔を指定します。

リトライ間隔が経過しているかどうかは，5秒間隔でチェックします。そのため，最大で5秒の誤差が生じます。

RPC関連定義のname_useオペランドにNを指定した場合，rpc_nam_retry_intervalオペランドの指定は無効になります。

●rpc_nam_use_time=キャッシュの有効期限　　〜〈符号なし整数〉((1〜65535))《300》（単位：秒）

キャッシュの有効期限を指定します。

有効期限が満了した場合，キャッシュの削除またはキャッシュ自動同期を行います。

有効期限が満了しているかどうかは，5秒間隔でチェックします。そのため，最大で5秒の誤差が生じます。

RPC関連定義のname_useオペランドにNを指定した場合，rpc_nam_use_timeオペランドの指定は無効になります。

●rpc_nam_reserve_count=キャッシュ自動同期の保留回数　　〜〈符号なし整数〉((0〜32767))《0》

キャッシュ自動同期の保留回数を指定します。

同一サービスグループ名に対するサービス要求が，キャッシュの有効期限（RPC関連定義のrpc_nam_use_timeオペランドで指定）内に，rpc_nam_reserve_countオペランドで指定した回数以上あった場合，ネーム情報の有効期限（RPC関連定義のrpc_nam_use_timeオペランドで指定）満了時にキャッシュ自動同期を実行します。

0を指定した場合は，キャッシュ保留回数によるキャッシュ自動同期を実行しません。

1を指定した場合は，ネーム情報の有効期限満了時，必ずキャッシュ自動同期を実行します。

RPC関連定義のname_useオペランドにNを指定した場合，rpc_nam_use_timeオペランドの指定は無効になります。

●rpc_nam_reserve_time=キャッシュ自動同期の保留期間　　〜〈符号なし整数〉((0〜65535))《0》（単位：秒）

キャッシュ自動同期の保留期間を指定します。

キャッシュの有効期限が満了した時刻からrpc_nam_reserve_timeオペランドで指定した値分さかのぼった期間を保留期間とし，保留期間内にキャッシュ情報を検索した場合，キャッシュ自動同期を実行します。

保留期間がキャッシュの有効期限（RPC関連定義のrpc_nam_use_timeオペランドで指定）より大きい場合，有効期限全体が保留期間となります。

0を指定した場合は，キャッシュの保留期間によるキャッシュ自動同期を実行しません。

RPC関連定義のname_useオペランドにNを指定した場合，rpc_nam_reserve_timeオペランドの指定は無効になります。

●rpc_nam_eject_rate=キャッシュ追い出し率　　〜〈符号なし整数〉((0〜50))《0》（単位：%）

キャッシュ追い出し時の追い出しキャッシュ率を指定します。

キャッシュ追い出し時，rpc_nam_eject_rateオペランドから算出した追い出しキャッシュ数を追い出します。

追い出しキャッシュ数が，新しいネーム情報を格納するのに必要なキャッシュ数未満の場合，必要最低限のキャッシュ数を追い出します。

0を指定した場合は，必要最低限のキャッシュ数を追い出します。

RPC関連定義のname_useオペランドにNを指定した場合，rpc_nam_eject_rateオペランドの指定は無効になります。

●rpc_name_service_extend=サーバUAPの取得数を拡張　　〜〈符号なし整数〉((0，1))《0》

ネームサービスで管理するサーバUAPの取得数を拡張するかどうかを指定します。このオペランドを省略すると，RPC通信先の対象は最大で128のままです。

0

拡張しません。RPC通信先の対象は最大で128のままです。

1

拡張します。RPC通信先の各ノードで起動する同一サービスグループ名のサーバUAPに対して，RPC通信先の対象を最大512にできます。ただし，RPC通信先の各ノードは，TP1/Server Baseのall_nodeオペランドで指定したOpenTP1システムに含まれている必要があります。TP1/ServerBaseのall_nodeオペランドの指定値が128を超える場合は，このオペランドに1を指定してください。

RPC関連定義のname_useオペランドにＮを指定した場合，このオペランドの指定は無視されます。

●rpc_loadbalance=Y|N　　〜《Y》

自サービスグループあてのRPCメッセージの受信時に，ノード間負荷バランス機能を使用するかどうかを指定します。

Y

ノード間負荷バランス機能を使用して，RPCメッセージを転送します。

N

ノード間負荷バランス機能を使用しないで，自ノードでサービス要求を処理します。

RPC関連定義のname_useオペランドにNを指定した場合，rpc_loadbalanceオペランドの指定は無効になります。

●rpc_transfer_othersvg=Y|N　　〜《Y》

他サービスグループへのRPCメッセージを，ノード間負荷バランス機能を使用して転送するかどうかを指定します。

Y

ノード間負荷バランス機能を使用して，RPCメッセージを転送します。

N

ノード間負荷バランス機能を使用しないで，サービスグループ名不正でエラーリターンします。

RPC関連定義のname_useオペランドにNを指定した場合，rpc_transfer_othersvgオペランドの指定は無効になります。

●rpc_myproc_first=Y|N　　〜《Y》

ノード間負荷バランス機能の使用時に，自サービスグループあてのサービス要求を受信した場合，または自サービスグループあてのサービス要求を自プロセスから送信する場合，自ノードでのサービス要求の処理を優先させるかどうかを指定します。

Y

自ノードの負荷レベルを最初にチェックし，サービス要求を自ノードで処理できる場合は，他ノードに転送しないで自ノードで処理します。

N

要求されたサービスを自ノードで処理できる場合でも，自ノードを優先しないで，ランダムにノードを選択してスケジュールします。

RPC関連定義のname_useオペランドにNを指定した場合，rpc_myproc_firstオペランドの指定は無効になります。

●loadcheck_interval=負荷レベル監視間隔　　〜〈符号なし整数〉((0〜65535))《30》(単位：秒)

自ノードの負荷レベルを監視する間隔を指定します。

監視時に負荷レベルの変更がある場合は，自ノードのネーム情報を更新します。

0を指定した場合は，負荷レベルを監視しません。この場合，分散処理するすべてのRPC関連定義のloadcheck_intervalオペランドに0を指定し，TP1/Server Baseのスケジュールサービス定義のscd_announce_server_statusオペランドにNを指定してください。指定が異なるノードがある場合，負荷が集中するおそれがあります。

RPC関連定義のname_useオペランドにNを指定した場合，loadcheck_intervalオペランドの指定は無効になります。

●loadcheck_type=auto|rate|count　　〜《auto》

負荷レベル監視で使用する，負荷レベルの決定方法を指定します。

auto

固定の処理キュー処理率のしきい値を使用します。

rate

levelup_queue_rateオペランドおよびleveldown_queue_rateオペランドで指定した処理キュー滞留率のしきい値を使用します。

count

levelup_queue_countオペランドおよびleveldown_queue_countオペランドで指定した処理キュー滞留数のしきい値を使用します。

RPC関連定義のloadcheck_intervalオペランドに0を指定した場合，loadcheck_typeオペランドの指定は無効になります。

●levelup_queue_rate=U1,U2　　〜〈符号なし整数〉((1〜100))（単位：%）

　leveldown_queue_rate=D0,D1　　〜〈符号なし整数〉((0〜99))《U1÷2，(U1+U2)÷2》（単位：%）

このサービスグループの負荷レベルを判断する処理キュー滞留率を指定します。

U1

サーバの負荷レベルがLEVEL1に上がったと判断する処理キュー滞留率

U2

サーバの負荷レベルがLEVEL2に上がったと判断する処理キュー滞留率

D0

サーバの負荷レベルがLEVEL0に下がったと判断する処理キュー滞留率

D1

サーバの負荷レベルがLEVEL1に下がったと判断する処理キュー滞留率

levelup_queue_rateオペランドおよびleveldown_queue_rateオペランドの各指定値は，次の条件を満たすように指定する必要があります。

（条件）　0≦D0＜U1≦D1＜U2≦100，かつ，1≦U1

指定値が条件を満たしていない場合，サーバ起動時に定義エラーとなり起動が失敗となります。

なお，RPC関連定義のloadcheck_intervalオペランドに0を指定した場合，またはRPC関連定義のloadcheck_typeオペランドにrate以外を指定した場合は，levelup_queue_rateオペランドおよびleveldown_queue_rateオペランドの指定は無効になります。

loadcheck_typeオペランドにrateを指定した場合，levelup_queue_rateオペランドは省略できません。必ず指定してください。loadcheck_typeオペランドにrateを指定した場合でも，leveldown_queue_rateオペランドの指定は省略できます。この場合，leveldown_queue_rateオペランドの各指定値は，levelup_queue_rateオペランドの指定値（U1，U2）を基に，次に示す計算式で算出された値が決定されます。

D0＝U1÷2
D1＝(U1＋U2)÷2　（D0，D1共に小数点以下は切り捨て）

●levelup_queue_count=U1,U2　　〜〈符号なし整数〉((1〜500000))

　leveldown_queue_count=D0,D1　　〜〈符号なし整数〉((0〜499999))《U1÷2，(U1+U2)÷2》

このサービスグループの負荷レベルを判断する処理キュー滞留数を指定します。

U1

サーバの負荷レベルがLEVEL1に上がったと判断する処理キュー滞留数

U2

サーバの負荷レベルがLEVEL2に上がったと判断する処理キュー滞留数

D0

サーバの負荷レベルがLEVEL0に下がったと判断する処理キュー滞留数

D1

サーバの負荷レベルがLEVEL1に下がったと判断する処理キュー滞留数

levelup_queue_countオペランドおよびleveldown_queue_countオペランドの各指定値は，次の条件を満たすように指定する必要があります。

（条件）　0≦D0＜U1≦D1＜U2≦メモリ関連定義のpce_noオペランドの指定値，かつ，1≦U1

指定値が条件を満たしていない場合，サーバ起動時に定義エラーとなり起動が失敗となります。

なお，RPC関連定義のloadcheck_intervalオペランドに0を指定した場合，またはRPC関連定義のloadcheck_typeオペランドにcount以外を指定した場合は，levelup_queue_countオペランドおよびleveldown_queue_countオペランドの指定は無効になります。

loadcheck_typeオペランドにcountを指定した場合，levelup_queue_countオペランドは省略できません。必ず指定してください。loadcheck_typeオペランドにcountを指定した場合でも，leveldown_queue_countオペランドの指定は省略できます。この場合，leveldown_queue_countオペランドの各指定値は，levelup_queue_countオペランドの指定値（U1，U2）を基に，次に示す計算式で算出された値が決定されます。

D0＝U1÷2
D1＝(U1＋U2)÷2　（D0，D1共に小数点以下は切り捨て）

●scd_retry_of_comm_error=RPCメッセージ転送のリトライ回数　　〜〈符号なし整数〉((0〜128))《0》

RPCサービス要求メッセージの転送時に通信障害が発生した場合，障害が発生したプロセス以外のプロセスに転送し直すリトライ回数を指定します。ただし，scd_retry_of_comm_errorオペランドの指定値が，RPC要求の対象となる稼働中サービスグループのプロセス数を上回っている場合は，稼働中サービスグループのプロセス数をリトライ回数の上限値とします。

scd_retry_of_comm_errorオペランドに0を指定した場合はリトライしません。

RPC関連定義のrpc_loadbalanceオペランドとrpc_transfer_othersvgオペランドの両方にNを指定した場合は，scd_retry_of_comm_errorオペランドの指定は無効になります。

●loadlevel_message=Y|N|A　　〜《N》

ノード間負荷バランス機能を使用して負荷レベルを監視している際，負荷レベルの変更があった場合にメッセージを出力するかどうかを指定します。

Y

負荷レベルがLEVEL2またはLEVEL0に変更された場合に通知メッセージを出力します。

N

負荷レベルの変更があっても通知メッセージを出力しません。

A

負荷レベルの変更があった場合，通知メッセージを出力します。

RPC関連定義のloadcheck_intervalオペランドに0を指定した場合，loadlevel_messageオペランドの指定は無効になります。

●multi_schedule=Y|N　　〜《N》

ノード間負荷バランス機能を使用してRPCメッセージの送信先を決定するときに，TP1/Server Baseのマルチスケジューラ機能のスケジューラデーモンが起動しているノードを優先的に選択するかどうかを指定します。

Y

マルチスケジューラ機能のスケジューラデーモンが起動しているノードを優先的に選択します。

N

マルチスケジューラ機能のスケジューラデーモンが起動しているノードを優先しないで，ランダムにノードを選択してスケジュールします。

RPC関連定義のrpc_myproc_firstオペランドとmulti_scheduleオペランドの両方にYを指定した場合は，rpc_myproc_firstオペランドの処理（自ノードでの優先処理）を先に適用します。また，RPC関連定義のname_useオペランドにNを指定した場合，multi_scheduleオペランドの指定は無効になります。

●rpc_reply_errtrn3=Y|N　　〜《N》

ERRTRN3によるRPC応答メッセージ送信機能を使用するかどうかを指定します。

Y

この機能を使用します。

N

この機能を使用しません。

このオペランドにYを指定した場合は，ユーザサービス関連定義のerrtrn3オペランドを必ず指定してください。

●rpc_reply_errtrnr=Y|N　　〜《N》

ERRTRNRによるRPC応答メッセージ送信機能を使用するかどうかを指定します。

Y

ERRTRNRによるRPC応答メッセージ送信機能を使用します。

N

ERRTRNRによるRPC応答メッセージ送信機能を使用しません。

●rpc_reply_errtrnr_cnt=ERRTRNRによるRPC応答メッセージ送信機能の同時使用最大数　　〜〈符号なし整数〉((32〜2000))《128》

ERRTRNRによるRPC応答メッセージ送信機能を同時に使用する最大数を指定します。

すべての処理スレッドで同時にERRTRNRによるRPC応答メッセージ送信機能が動作した場合を想定して，処理スレッド数（プロセス関連定義のthread_noオペランドの指定値＋プロセス関連定義のreserve_thread_noオペランドの指定値）以上の値を指定することをお勧めします。再開始時などに処理スレッド数が増加する運用の場合は，あらかじめスレッドの増加分を考慮した値を指定してください。

ERRTRNRによるRPC応答メッセージ送信機能の同時使用数が，rpc_reply_errtrnr_cntオペランドの指定値を超えた場合，KFSB50395-Eメッセージが出力されます。ERRTRNRによるRPC応答メッセージの送信は行われません。

RPC関連定義のrpc_reply_errtrnrオペランドにNを指定，または指定を省略した場合，rpc_reply_errtrnr_cntオペランドの指定は無効になります。

●rpc_tcpsend_con_max_cnt=TCP/IP共有送信用コネクションの最大数　　〜〈符号なし整数〉((1〜20000))《50》

TCP/IP共有送信用コネクションの最大数を指定します。

DBキューイベント通知メッセージなどのTCP/IP上で送信するメッセージの送信時に，TCP/IP共有送信用コネクションの数がrpc_tcpsend_con_max_cntオペランドの指定値を超えた場合は，メッセージの送信後にコネクションを切断します。

TCP/IP共有送信用コネクションを使用してDBキューイベント通知メッセージを送信する場合，rpc_tcpsend_con_max_cntオペランドに指定する値を，次に示す計算式で算出します。

1トランザクションでメッセージの書き込み要求（ee_dbq_msgput関数発行）をするDBキュー数×同時に動作するトランザクション数

このオペランドは，次のどちらかの場合に有効となります。該当しない場合は，指定しても無視します。

dbqgrpdefに-fオプションを指定する。

dbqgrpdefに-k 1を指定する。

このオペランドには，次のいちばん小さい値を設定することを推奨します。

dbqgrpdef -cオプションを指定している場合は，次のいちばん小さい値にDBキューから読み出すプロセス数を掛けた数を指定することを推奨します。

dbqdef指定数

処理スレッド数

DBキューに書き込みを行うトランザクションの同時実行数

この数以上を指定しなかった場合は，DBキューにメッセージを書き込むときにコネクションの確立処理が行われ，その処理時間だけDBキューからメッセージを読み出すサービスの開始が遅れることがあります。

【Linux限定】

プロセス関連定義のdescriptors_expanse_useオペランドを省略，またはNを指定している場合，このオペランドの指定範囲は1〜800となります。

●rpc_tcpsend_con_cnt=接続先プロセスごとのTCP/IP共有送信用コネクションの最大数　　〜〈符号なし整数〉((1〜20000))《5》

接続先プロセスごとのTCP/IP共有送信用コネクションの最大数を指定します。

該当プロセスに対するTCP/IP共有送信用コネクション数がrpc_tcpsend_con_cntオペランドの指定値を超えた場合は，メッセージの送信後にコネクションを切断します。

このオペランドは，次のどちらかの場合に有効となります。該当しない場合は，指定しても無視します。

dbqgrpdefに-fオプションを指定する。

dbqgrpdefに-k 1を指定する。

このオペランドには，次のいちばん小さい値を設定することを推奨します。

dbqdef指定数

処理スレッド数

DBキューに書き込みを行うトランザクションの同時実行数

この数以上を指定しなかった場合は，DBキューにメッセージを書き込むときにコネクションの確立処理が行われ，その処理時間だけDBキューからメッセージを読み出すサービスの開始が遅れることがあります。

【Linux限定】

プロセス関連定義のdescriptors_expanse_useオペランドを省略，またはNを指定している場合，このオペランドの指定範囲は1〜800となります。

●rpc_tcpsend_proc_max_cnt=TCP/IP共有送信用コネクションの接続先プロセス最大数　　〜〈符号なし整数〉((1〜20000))《5》

TCP/IP共有送信用コネクションの接続先プロセスの最大数を指定します。

TCP/IP共有送信用コネクションの接続先プロセス数がrpc_tcpsend_proc_max_cntオペランドの指定値を超えた場合は，メッセージの送信後にコネクションを切断します。

TCP/IP共有送信用コネクションの接続先プロセスは，接続先プロセスのIPアドレス，接続先プロセスのポート番号，および自ホストのIPアドレス（TCP/IP共有送信用コネクションを使用する機能から自ホストのIPアドレスを固定（bind）する要求があった場合）の組み合わせで1プロセスとします。このため，接続先プロセスのIPアドレスとポート番号が同じでも，自ホストのIPアドレスが異なる場合は，別プロセスとして扱います。

このオペランドは，次のどちらかの場合に有効となります。該当しない場合は，指定しても無視します。

dbqgrpdefに-fオプションを指定する。

dbqgrpdefに-k 1を指定する。

このオペランドには，DBキューから読み出すプロセス数を指定することを推奨します。

DBキューから読み出すプロセス数は，次のどちらかの設定をしているdbqgrpdefが存在するTP1/EEの数です。

-oを省略，または-o myを設定

-cを設定

この数以上を指定しなかった場合は，DBキューにメッセージを書き込むときにコネクションの確立処理が行われ，その処理時間だけDBキューからメッセージを読み出すサービスの開始が遅れることがあります。

【Linux限定】

プロセス関連定義のdescriptors_expanse_useオペランドを省略，またはNを指定している場合，このオペランドの指定範囲は1〜800となります。

●rpc_connect_unixdomain=Y|N　　〜《Y》

同一ノード内のRPC通信で，コネクション確立要求をする際にUNIXドメインを使用してコネクションを確立するかどうかを指定します。

Y

UNIXドメインを使用してコネクションを確立します。

N

INETドメインを使用してコネクションを確立します。

●rpc_reply_port_auto=Y|N　　〜《N》

RPC応答メッセージ受信用のポート番号にポート番号自動割り当て機能を使用するかどうかを指定します。このオペランドの設定値としてYを指定すると，次の通信障害（電文の吸い込み）の発生頻度を軽減できます。なお，このオペランドの設定値としてYを指定した場合，使用するポート数が一つ増えます。

TP1/SBのSPP（キュー受信型）とRPCを行う場合，TP1/EEの再起動時，TP1/EEへのRPC応答電文，またはトランザクション電文の送信処理で通信障害（電文の吸い込み）が発生する可能性があります。

別マシンとRPCを行う場合，ハード障害などによるマシンダウン＆リブート時，TP1/EEへのRPC応答電文，またはトランザクション電文の送信処理で通信障害（電文の吸い込み）が発生する可能性があります。

Y

RPC応答メッセージ受信用に，OSが自動的に割り当てるポート番号を使用します。この場合，使用するポート数が一つ増えます。サービスグループ情報関連定義のmyreplydef定義コマンドで指定したポート番号は，ネームサーバからのメッセージ受信用に使用します。

N

RPC応答メッセージ受信用およびネームサーバからのメッセージ受信用に，サービスグループ情報関連定義のmyreplydef定義コマンドで指定したポート番号を使用します。

●rpc_nowait_cnt=非同期応答型RPCの同時要求メッセージの最大数　　〜〈符号なし整数〉((0〜65535))《0》

処理スレッドごとに，同時に送信できる非同期応答型RPCの要求メッセージの最大数を指定します。同時に送信できる要求メッセージがこのオペランドの指定値を超えた場合，非同期応答型RPCの要求メッセージを送信するee_rpc_call関数（flagsにEERPC_NOWAITを設定）はエラーリターンします。

このオペランドの指定を省略した場合は，非同期応答型RPCの要求メッセージを送信できません。

TP1/FSPのeechglib，eesvctl，eesdhchg，eeucmdコマンドを他ノードで実行する場合，実行するノード数分の値を本定義値に加算してください。

●rpc_extend_function=RPCサービスの機能拡張レベル　　〜〈16進数〉｛00000000|00000004|00000008｝《00000000》

RPCサービスの機能拡張レベルを指定します。

00000000

RPCサービスの機能を拡張しません。

00000004

非同期応答型RPCの応答メッセージを受け取っていない状態で，トランザクションの同期点処理をした場合に，非トランザクション属性の非同期応答型RPCの応答メッセージは破棄しないで，トランザクション属性の非同期応答型RPCの応答メッセージだけを破棄します。

00000008

サーバ側でee_rpc_call関数，およびee_rpc_call_to関数の呼び出し元の応答受信タイムアウトを検出し，処理を中断してサービス要求を破棄した場合に，KFSB40307-Wメッセージを出力します。

●rpc_tcp_linetrace=RPCの回線トレース情報の取得量の変更　　〜〈16進数〉｛00000000|00000020｝《00000000》

RPCの回線トレース情報の取得量を変更する場合に，変更する項目を指定します。

00000000

すべての回線トレース情報を取得します。

00000020

送受信が正常に行われた場合に，送受信データの先頭にある製品ヘッダを回線トレース情報として取得します。送受信データに製品ヘッダがない場合は，送受信データの内容は取得しません。

●rpc_rap_linetrace=リモートAPI機能使用時の回線トレース情報の取得量の変更　　〜〈16進数〉｛00000000|00000020｝《00000000》

リモートAPI機能使用時の回線トレース情報の取得量を変更する場合に，変更する項目を指定します。

00000000

すべての回線トレース情報を取得します。

00000020

送受信が正常に行われた場合に，送受信データの先頭にある製品ヘッダを回線トレース情報として取得します。送受信データに製品ヘッダがない場合は，送受信データの内容は取得しません。

●rpc_extend_sb_node_id=Y|N　　〜《N》

RPCのサービス要求を行う際に，TP1/Server Baseのノード識別子を通知するかどうかを指定します。ネームサービス機能を使わない（name_useオペランドにNを指定）場合は，このオペランドの指定は無効になります。

Y

TP1/Server Baseのノード識別子を通知します。要求先のトランザクションインタフェース情報のノード識別子には，TP1/Server Baseのノード識別子が設定されます。

N

TP1/Server Baseのノード識別子を通知しません。要求先のトランザクションインタフェース情報のノード識別子には，TP1/EEのノード識別子が設定されます。

●rpc_keepalive_use=Y|N　　〜《N》

TCP/IPが提供するソケットオプション「SO_KEEPALIVE」を使用するかどうかを指定します。SO_KEEPALIVEを使用すると，何のデータも送受信されないで一定時間が経過した場合に，パケット（keep-aliveプローブ）を相手側に送ることで到達できなかった通信相手を検出できます。これをキープアライブといいます。

Y

キープアライブを使用します。使用する場合は，一定時間（rpc_keepalive_timeオペランドで指定）の経過後にkeep-aliveプローブを送信します。反応がない場合は，一定間隔（rpc_keepalive_intervalオペランドで指定）ごとに一定回数分（rpc_keepalive_countオペランドで指定）のkeep-aliveプローブを送信します。一定回数分これを繰り返しても反応がない場合は，到達できない通信相手と判断し，接続を切断します。経過時間，間隔，回数については，OSのマニュアルを参照してください。

N

キープアライブを使用しません。

キープアライブを使用すればコネクションの切断を検出できるようになりますが，ネットワークの負荷を高めることがあります。このため，この機能の必要性を十分に検討した上で使用するようにしてください。

●rpc_keepalive_time=keep-aliveプローブを送信するまでの時間　　〜〈符号なし整数〉((0〜7200))《0》（単位：秒）

keep-aliveプローブを送信するまでの時間を秒単位で指定します。このオペランド設定値に0を指定した場合は，OSの設定値が使用されます。OSの設定値については，OSのマニュアルを参照してください。

rpc_keepalive_useオペランドにNを指定した場合，このオペランドの指定は無効になります。

なお，このオペランドは，OSがLinuxの場合に指定できます。

●rpc_keepalive_interval=keep-aliveプローブを送信する間隔　　〜〈符号なし整数〉((0〜180))《0》（単位：秒）

keep-aliveプローブを送信する間隔を秒単位で指定します。このオペランドに0を指定した場合は，OSの設定値が使用されます。OSの設定値については，OSのマニュアルを参照してください。

rpc_keepalive_useオペランドにNを指定した場合，このオペランドの指定は無効になります。

なお，このオペランドは，OSがLinuxの場合に指定できます。

●rpc_keepalive_count=keep-aliveプローブを送信する回数　　〜〈符号なし整数〉((0〜10))《0》

keep-aliveプローブを送信するリトライ最大回数を指定します。このオペランドに0を指定した場合は，OSの設定値が使用されます。OSの設定値については，OSのマニュアルを参照してください。

rpc_keepalive_useオペランドにNを指定した場合，このオペランドの指定は無効になります。

なお，このオペランドは，OSがLinuxの場合に指定できます。

●rpc_nam_conn_check=Y|N　　〜《N》

rpc_nam_check_timeオペランドの指定値ごとに，コネクション確立先との間のコネクション確立時刻とコネクション確立先（IPアドレス単位）の起動時刻を比較します。コネクション確立時刻が起動時刻よりも古い場合は，確立していたコネクションは切断します。コネクション確立先はIPアドレス単位で管理します。

この機能が使用できるのは，コネクション確立先のプロセスがTP1/Server Base，またはTP1/EEの場合だけです。また，name_useオペランドにNを指定した場合，このオペランドの指定は無効になります。

Y

RPCメッセージ用コネクションのチェック機能を使用します。

N

RPCメッセージ用コネクションのチェック機能を使用しません。

●rpc_nam_check_time=コネクション確立先の起動時刻を取得する間隔　　〜〈符号なし整数〉((0〜3600))《5》（単位：秒）

このオペランドで指定する間隔ごとに，コネクション確立先（IPアドレス単位）の起動時刻を取得します。このオペランドの指定値が大きい場合は，使用できないコネクションを検知するまでの時間が長くなります。また，このオペランドの指定値が小さい場合は，システムの負荷が増加することがあります。

rpc_nam_conn_checkオペランドにNを指定した場合，このオペランドの指定は無効になります。

●rpc_nam_check_num=一度に確認するコネクション確立先数　　〜〈符号なし整数〉((1〜512))《5》

このオペランドで指定する確立先数ごとに，コネクション確立先（IPアドレス単位）の起動時刻を取得します。このオペランドの指定値よりもコネクション確立先が多い場合は，すべてのコネクションの確立先をチェックするのに，次の計算式以上の時間が掛かります。

（（↑（コネクション確立先÷rpc_nam_check_numオペランドの指定値）↑）−1）
　×rpc_nam_check_timeオペランドの指定値

（凡例）

↑↑：小数点以下を切り上げます。

このオペランドの指定値が小さい場合は，使用できないコネクションを検知するまでの時間が長くなります。また，このオペランドの指定値が大きい場合は，システムの負荷が増加することがあります。

rpc_nam_conn_checkオペランドにNを指定した場合，このオペランドの指定は無効になります。

●rpc_request_cancel_for_timedout=Y｜N　　〜《N》

ee_rpc_call関数で，RPCサービス要求メッセージを送信してからサービスの応答が返るまでの待ち時間をサーバ側に引き継ぎ，サーバにクライアントが待ち状態であることを意識させるかどうかを指定します。

ee_rpc_call関数の応答待ち時間をサーバに引き継ぐと，ee_rpc_call関数がタイムアウトしても，サーバ側でサービスを実行したり，同期点処理の実行を待ち続けたりすることを防止できます。

このオペランドは，同期応答型のサービス要求に対してだけ有効です。

Y

自TP1/EEのUAPの応答待ち時間をサーバに意識させます。RPC要求メッセージのサイズが16〜36バイト増加し，ネットワーク負荷やディスクI/Oサイズが微増します。

N

自TP1/EEのUAPの応答待ち時間をサーバに意識させません。

●rpc_request_cancel_for_server=Y｜N　　〜《Y》

クライアント側でrpc_request_cancel_for_timedoutオペランドにYを指定した場合に，サーバ側で応答待ち時間を意識して処理するかどうかを指定します。

Y

サーバ側でクライアントUAPの応答待ち時間を意識します。処理キューの滞留時間が，クライアントが指定した応答待ち時間を超えた場合は，メッセージを破棄します。

サーバ側でクライアントUAPのタイムアウトを検知してサービス要求を破棄したことをメッセージに表示したい場合は，サーバ側のrpc_extend_functionオペランドに00000008を指定してください。

TP1/FSPを使用する場合，サーバ側のUAP内でトランザクションのリトライロールバックを行ったときは，最初の処理キュー登録時の時刻からの経過時間がクライアント側の応答待ち時間を超えているかどうかで，クライアントUAPがタイムアウトしているかどうかを判断します。

N

サーバ側でクライアントUAPの応答待ち時間を意識しません。この場合，rpc_request_cancel_for_timedoutオペランドにYを指定し，クライアント側でタイムアウトが発生しているときでも，サーバ側でサービスを実行したり，同期点処理の実行を待ち続けたりします。

●rpc_reply_sockctl_use=Y｜N　　〜《N》

送受信用コネクションについて，一時クローズ機能の使用有無を指定します。

Y

一時クローズ機能を使用します。

N

一時クローズ機能を使用しません。

●rpc_reply_sockctl_highwater=送受信用コネクションの一時クローズ処理開始数の割合，送受信用コネクションの一時クローズ処理非対象数の割合　　〜〈符号なし整数〉((0〜100))《送受信用コネクションの一時クローズ処理開始数の割合：100，送受信用コネクションの一時クローズ処理非対象数の割合：0》（単位：%）

送受信用コネクションについて，一時クローズ処理を開始するコネクション数と，一時クローズ処理非対象とするコネクション数を割合で指定します。

送受信用コネクション数が，次の値以上となった時点で一時クローズ処理を開始します。

↑（rpc_reply_con_max_cnt指定値×（一時クローズ処理開始数の割合÷100））↑

一時クローズ処理非対象となる送受信用コネクション数は，次の値となります。

↑（rpc_reply_con_max_cnt指定値×（一時クローズ処理非対象数の割合÷100））↑

rpc_reply_sockctl_useオペランドにNを指定した場合は，このオペランドの指定値を無視します。

一時クローズ処理非対象数の割合には，一時クローズ処理開始数の割合以下の値を指定してください。一時クローズ処理開始数の割合より大きな値を指定した場合は，一時クローズ処理開始数の割合と同じ値になります。

●rpc_recv_sockctl_use=Y｜N　　〜《N》

受信用コネクションについて，一時クローズ機能の使用有無を指定します。

Y

一時クローズ機能を使用します。

N

一時クローズ機能を使用しません。

●rpc_recv_sockctl_highwater=受信用コネクションの一時クローズ処理開始数の割合，受信用コネクションの一時クローズ処理非対象数の割合　　〜〈符号なし整数〉((0〜100))《受信用コネクションの一時クローズ処理開始数の割合：100，受信用コネクションの一時クローズ処理非対象数の割合：0》（単位：%）

受信用コネクションについて，一時クローズ処理を開始するコネクション数と，一時クローズ処理非対象とするコネクション数を割合で指定します。

受信スレッドを複数定義している場合，受信スレッドごとに使用中コネクション数を取得して一時クローズ処理を行います。

受信スレッドごとの受信用コネクション数が次の値以上となった時点で，その受信スレッドについて一時クローズ処理を開始します。

↑（mysvgdef定義コマンド-sオプション指定値×（一時クローズ処理開始数の割合÷100））↑

一時クローズ処理非対象となる受信用コネクション数は，次の値となります。

↑（mysvgdef定義コマンド-sオプション指定値×（一時クローズ処理非対象数の割合÷100））↑

rpc_recv_sockctl_useオペランドにNを指定した場合は，このオペランドの指定値を無視します。

一時クローズ処理非対象数の割合には，一時クローズ処理開始数の割合以下の値を指定してください。一時クローズ処理開始数の割合より大きな値を指定した場合は，一時クローズ処理開始数の割合と同じ値になります。

●rpc_connect_conflict_timer=送信開始待ち時間　　〜〈符号なし整数〉((0〜1048576))《200》（単位：ミリ秒）

複数の処理スレッドが，同一のCosminexusに対して同時にRPC要求を行った場合，RPC要求順にシリアライズしてRPC要求メッセージを送信します。送信中の処理スレッドが送信完了すると，次の処理スレッドが送信を開始します。このオペランドは，送信を開始するまでの最大待ち時間を指定します。このオペランドで指定した時間以内に送信を開始できない場合は，KFSB40355-Eメッセージ（理由コード：0020）を出力し，RPC要求はEERPCER_NO_SERVICE_SOCKETエラーとなります。このオペランドに0を指定した場合，無制限に送信開始待ちを行います。

同一のCosminexusに対するRPC要求が競合しない場合はこのオペランドを指定する必要はありませんが，競合する場合は，TCP/IPバッファ不足によるリトライ処理なども考慮し，次の値より大きい値を指定することを推奨します。

rpc_router_retry_count値×rpc_router_retry_interval値×競合する処理スレッド数

●ipc_notify_response_host=Y｜N　　〜《N》

応答電文受信用IPアドレスを通知するかどうかを指定します。

OpenTP1システム内にKubernetesノードで起動するプロセス（TP1/Server Base，TP1/EE，およびTP1/Client/J）が存在する場合，各プロセスでこのオペランドにYを指定してください。プロセス間でオペランドの指定値が不一致の場合，TP1/EEプロセスの起動またはRPC応答の送信に失敗します。

このオペランドにYを指定することで，サービス要求先のプロセスに，myreplydef定義コマンドで指定した応答電文受信用IPアドレスを通知します。また，サービス要求元が通知してきた応答電文受信用IPアドレスに対して，RPC応答を送信します。これによって，Kubernetesノードを含むOpenTP1システム内で通信ができるようになります。

TP1/EEをKubernetes構成で動作させる場合，マニュアル「OpenTP1 解説」のコンテナオーケストレーションツールを使用したOpenTP1の構成と構築について説明している個所を参照してください。

Y

応答電文受信用IPアドレスを通知します。Kubernetes構成でのRPC通信ができます。

N

応答電文受信用IPアドレスを通知しません。Kubernetes構成でのRPC通信ができません。

TP1/EEをKubernetesノード上のpodで起動する場合，次の指定をしてください。

rpc_reply_port_autoオペランドにN

mysvgdef定義コマンドの-hオプションのポート番号に0以外

TP1/EEをKubernetesノード上のpodで起動する場合，Serviceを作成し，TP1/EEの受信用ポートに対するコネクション確立受付を許可する必要があります。許可しない場合，相手プロセスからのコネクション確立が失敗します。許可が必要な受信用ポートを次に示します。

mysvgdef定義コマンドで指定したポート番号（RPC要求電文受信のため）

myreplydef定義コマンドで指定したポート番号（RPC応答電文およびネームサービス電文受信のため）

rap_listen_portオペランドで指定したポート番号

コマンド形式

なし。

ユーザサービス関連定義

形式

set形式

  set service="サービス名=エントリポインタ名〔,同時処理限界数〕"〔,"サービス名=エントリポインタ名〔,同時処理限界数〕"〕…
〔set dbq_service="サービス名=エントリポインタ名"〔,"サービス名=エントリポインタ名"〕…〕
〔set dbq_obs_service="サービス名=エントリポインタ名"〔,"サービス名=エントリポインタ名"〕…〕
〔set errtrn1="ERRTRN1を起動するエントリポインタ名"〕
〔set errtrn2="ERRTRN2を起動するエントリポインタ名"〕
〔set errtrn3="ERRTRN3を起動するエントリポインタ名"〕
〔set errtrn4="ERRTRN4を起動するエントリポインタ名"〕
〔set errtrns="ERRTRNSを起動するエントリポインタ名"〕
〔set errtrnr="ERRTRNRを起動するエントリポインタ名"〕
〔set system_start_mi="プロセス初期化トランザクションを起動するエントリポインタ名"〕
〔set system_end_me="プロセス終了トランザクションを起動するエントリポインタ名"〕
〔set forbid_draw_service=Y|N〕
  set module="UAP共用ライブラリ名"〔,"UAP共用ライブラリ名"〕…
〔set uap_exchange_use=Y|N〕
〔set module_open_flag=LOCAL|GLOBAL〕

コマンド形式

｛｛service_attr  ｛-v  サービス名｜-x  トランザクション種別｝
                  〔-a  トランザクション処理監視時間〕
                  〔-c〕
                  〔-d  Y｜N〕
                    ｝｝

機能

UAP関連情報を定義します。

説明

各オペランドについて説明します。

set形式のオペランド

●service="サービス名=エントリポインタ名〔,同時処理限界数〕"〔,"サービス名=エントリポインタ名〔,同時処理限界数〕"〕…　　〜サービス名，エントリポインタ名：〈1〜31文字の識別子〉　　〜同時処理限界数：〈符号なし整数〉((1〜255))《1》

サービスグループに属するサービス名とそのサービスを提供するエントリポインタ名の組み合わせ，および同時処理限界数をすべてのサービスについて指定します。

エントリポインタ名は，C言語の場合は関数名，COBOL言語の場合はプログラム名または入り口名を指します。サービス名とエントリポインタ名は，1対1で対応している必要はありません。複数のサービス名に一つのエントリポインタ名を対応させられます。

指定できるサービス名とエントリポインタ名の組み合わせの最大数は，32000です。serviceオペランド，dbq_serviceオペランド，およびdbq_obs_serviceオペランドで指定した組み合わせの数の合計が32000以下になるようにしてください。また，serviceオペランド，dbq_serviceオペランド，およびdbq_obs_serviceオペランドで指定する名称は，必ず一意にしてください。

同時処理限界数は，サービスに対する同時処理限界数を指定します。該当するサービス処理を同時に処理できる場合，同時に処理できる最大値を指定します。

指定値は，必ず「"サービス名=エントリポインタ名〔,同時処理限界数〕"」の形式で指定してください。一つの指定値の途中にスペースは入力できません。複数の指定値を指定する場合は，引用符で囲んだ指定値間を，「,」で区切って指定するか，またはserviceオペランドを複数回指定してください。指定値間を区切る「,」の前後にはスペースを入力できます。

RPC受信時などでの，該当するサービス名の検索を高速化するために，初期化処理でユーザサービス関連定義のserviceオペランドに指定されたサービス名を昇順にソートします。そのため，serviceオペランドに指定するサービス名を昇順または降順に指定すると，サービス名の順番をランダムに指定する場合と比べて，初期化処理に掛かる時間が削減でき，プロセス再開始時間も短縮できます。このため，serviceオペランドに指定するサービス名は，サービス名の昇順または降順に指定することお勧めします。

なお，TP1/FSPのeesvctlコマンドを使用する場合は，サービス名に"all"という名称を使用しないでください。eesvctlコマンドについては，TP1/FSPの関連ドキュメントを参照してください。

このオペランドは省略できません。必ず指定してください。

●dbq_service="サービス名=エントリポインタ名"〔,"サービス名=エントリポインタ名"〕…　　〜〈1〜31文字の識別子〉

このサービスグループに属するDBキュー機能のサービス名とそのサービスを提供するエントリポインタ名の組み合わせを，すべてのサービスについて指定します。

エントリポインタ名は，C言語の場合は関数名，COBOL言語の場合はプログラム名または入り口名を指します。サービス名とエントリポインタ名は，1対1で対応している必要はありません。複数のサービス名に一つのエントリポインタ名を対応させられます。

指定できるサービス名とエントリポインタ名の組み合わせの最大数は，32000です。serviceオペランド，dbq_serviceオペランド，およびdbq_obs_serviceオペランドで指定した組み合わせの数の合計が32000以下になるようにしてください。また，serviceオペランド，dbq_serviceオペランド，およびdbq_obs_serviceオペランドで指定する名称は，必ず一意にしてください。

指定値は，必ず「"サービス名=エントリポインタ名"」の形式で指定してください。一つの指定値の途中にスペースは入力できません。複数の指定値を指定する場合は，引用符で囲んだ指定値間を「,」で区切って指定するか，またはdbq_serviceオペランドを複数回指定してください。指定値間を区切る「,」の前後にはスペースを入力できます。

該当するサービス名の検索を高速化するために，初期化処理では，dbq_serviceオペランドに指定されたサービス名を昇順にソートします。そのため，dbq_serviceオペランドに指定するサービス名を降順に指定すると，初期化処理時間を削減でき，プロセス再開始時間を短縮できます。昇順またはランダムに記述すると，初期化処理に時間が掛かります。

●dbq_obs_service="サービス名=エントリポインタ名"〔,"サービス名=エントリポインタ名"〕…　　〜〈1〜31文字の識別子〉

このサービスグループに属するオンラインバッチ機能のサービス名とそのサービスを提供するエントリポインタ名の組み合わせを，すべてのサービスについて指定します。

エントリポインタ名は，C言語の場合は関数名，COBOL言語の場合はプログラム名または入り口名を指します。サービス名とエントリポインタ名は，1対1で対応している必要はありません。複数のサービス名に一つのエントリポインタ名を対応させられます。

指定できるサービス名とエントリポインタ名の組み合わせの最大数は，32000です。serviceオペランド，dbq_serviceオペランド，およびdbq_obs_serviceオペランドで指定した組み合わせの数の合計が32000以下になるようにしてください。また，serviceオペランド，dbq_serviceオペランド，およびdbq_obs_serviceオペランドで指定する名称は，必ず一意にしてください。

指定値は，必ず「"サービス名=エントリポインタ名"」の形式で指定してください。一つの指定値の途中にスペースは入力できません。複数の指定値を指定する場合は，引用符で囲んだ指定値間を「,」で区切って指定するか，またはdbq_obs_serviceオペランドを複数回指定してください。指定値間を区切る「,」の前後にはスペースを入力できます。

該当するサービス名の検索を高速化するために，初期化処理では，dbq_obs_serviceオペランドに指定されたサービス名を昇順にソートします。そのため，dbq_obs_serviceオペランドに指定するサービス名を降順に指定すると，初期化処理時間を削減でき，プロセス再開始時間を短縮できます。昇順またはランダムに記述すると，初期化処理に時間が掛かります。

●errtrn1="ERRTRN1を起動するエントリポインタ名"　　〜〈1〜31文字の識別子〉

エラートランザクション（ERRTRN1）を起動するエントリポインタ名を指定します。

errtrn1オペランドで指定したエントリポインタ名は，ほかのオペランドで指定したエントリポインタ名と同じでもかまいません。エントリポインタ名の詳細については，serviceオペランドを参照してください。

errtrn1オペランドを省略した場合は，errtrn1を起動しません。

●errtrn2="ERRTRN2を起動するエントリポインタ名"　　〜〈1〜31文字の識別子〉

エラートランザクション（ERRTRN2）を起動するエントリポインタ名を指定します。

errtrn2オペランドで指定したエントリポインタ名は，ほかのオペランドで指定したエントリポインタ名と同じでもかまいません。エントリポインタ名の詳細については，serviceオペランドを参照してください。

errtrn2オペランドを省略した場合は，errtrn2を起動しません。

●errtrn3="ERRTRN3を起動するエントリポインタ名"　　〜〈1〜31文字の識別子〉

エラートランザクション（ERRTRN3）を起動するエントリポインタ名を指定します。

errtrn3オペランドで指定したエントリポインタ名は，ほかのオペランドで指定したエントリポインタ名と同じでもかまいません。エントリポインタ名の詳細については，serviceオペランドを参照してください。

errtrn3オペランドを省略した場合はerrtrn3を起動しません。

●errtrn4="ERRTRN4を起動するエントリポインタ名"　　〜〈1〜31文字の識別子〉

エラートランザクション（ERRTRN4）を起動するエントリポインタ名を指定します。

errtrn4オペランドで指定したエントリポインタ名は，ほかのオペランドで指定したエントリポインタ名と同じでもかまいません。エントリポインタ名の詳細については，serviceオペランドを参照してください。

errtrn4オペランドを省略した場合はerrtrn4を起動しません。

●errtrns="ERRTRNSを起動するエントリポインタ名"　　〜〈1〜31文字の識別子〉

エラートランザクション（ERRTRNS）を起動するエントリポインタ名を指定します。

errtrnsオペランドで指定したエントリポインタ名は，ほかのオペランドで指定したエントリポインタ名と同じでもかまいません。エントリポインタ名の詳細については，serviceオペランドを参照してください。

errtrnsオペランドを省略した場合はerrtrnsを起動しません。

●errtrnr="ERRTRNRを起動するエントリポインタ名"　　〜〈1〜31文字の識別子〉

エラートランザクション（ERRTRNR）を起動するエントリポインタ名を指定します。

errtrnrオペランドで指定したエントリポインタ名は，ほかのオペランドで指定したエントリポインタ名と同じでもかまいません。エントリポインタ名の詳細については，serviceオペランドを参照してください。

errtrnrオペランドを省略した場合はerrtrnrを起動しません。

●system_start_mi="プロセス初期化トランザクションを起動するエントリポインタ名"　　〜〈1〜31文字の識別子〉

TP1/EEプロセス初期化トランザクション（MI）を起動するエントリポインタ名を指定します。

system_start_miオペランドで指定したエントリポインタ名は，ほかのオペランドで指定したエントリポインタ名と同じでもかまいません。エントリポインタ名の詳細については，serviceオペランドを参照してください。

system_start_miオペランドを省略した場合はプロセス初期化トランザクションを起動しません。

●system_end_me="プロセス終了トランザクションを起動するエントリポインタ名"　　〜〈1〜31文字の識別子〉

TP1/EEプロセス終了トランザクション（ME）を起動するエントリポインタ名を指定します。

system_end_meオペランドで指定したエントリポインタ名は，ほかのオペランドで指定したエントリポインタ名と同じでもかまいません。エントリポインタ名の詳細については，serviceオペランドを参照してください。

system_end_meオペランドを省略した場合はプロセス終了トランザクションを起動しません。

●forbid_draw_service=Y|N　　〜《N》

UAPのスレッドダウン時，または運用コマンドもしくはAPIによるサービス閉塞時に，該当するサービスの処理キューを引き出し禁止にするかどうかを指定します。

Y

サービス閉塞時に，処理キューを引き出し禁止にします。

ただし，TP1/EEサービス定義のプロセス関連定義のservice_holdオペランドにNを指定した場合にUAPがスレッドダウンしたときは，引き出し禁止にしません。

N

サービス閉塞時に，処理キューを引き出し禁止にしません。

●module="UAP共用ライブラリ名"〔,"UAP共用ライブラリ名"〕…　　〜〈510文字以内のパス名〉

サービス処理を含んだUAP共用ライブラリの名称を絶対パス名で指定します。

なお，UAP共用ライブラリは，HAシステムで共用しないでください（共用ディレクトリを指定しないでください）。

複数のUAP共用ライブラリで，同一サービス処理がある場合，最初に定義したUAP共用ライブラリのサービス処理が有効になります。

複数の値を指定する場合は，指定値を「,」で区切って指定するか，またはmoduleオペランドを複数回指定してください。指定できるUAP共用ライブラリ名の最大数は，64です。ただし，性能上，一つにまとめることをお勧めします。

このオペランドは省略できません。必ず指定してください。

●uap_exchange_use=Y|N　　〜《N》

UAP共用ライブラリ入れ替え機能を使用するかどうかを指定します。

Y

UAP共用ライブラリ入れ替え機能を使用します。

N

UAP共用ライブラリ入れ替え機能を使用しません。

uap_exchange_useオペランドにYを指定した場合，ユーザサービス関連定義のmoduleオペランドは変更しないでください。moduleオペランドを変更した場合，TP1/EEは再開始時にプロセスダウンします。

次の図に示すUAP共用ライブラリの入れ替えを実行しないでください。実行した場合の動作は保障しません。

TP1/EEのプロセスダウンを防ぐため，次の図に示すように，UOCのエントリポインタとそれ以外のエントリポインタは別々のUAP共用ライブラリとして作成し，それぞれmoduleオペランドに指定してください。

●module_open_flag=LOCAL|GLOBAL〜《LOCAL》

ユーザサービス定義のmoduleオペランド，module_dirオペランド，static_module_dirオペランドで定義したUAP共用ライブラリにあるシンボルを，ほかのUAP共用ライブラリで利用可能にするかどうかを指定します。

LOCAL

ほかのUAP共用ライブラリでシンボルを利用可能にしません。

GLOBAL

ほかのUAP共用ライブラリでシンボルを利用可能にします。

このオペランドにGLOBALを指定した環境で，ユーザサービス定義のmoduleオペランドに定義したUAP共用ライブラリをeechgapコマンドで入れ替える場合，ほかのUAP共用ライブラリで参照するシンボル（グローバル変数や関数）を含むライブラリを入れ替え対象のライブラリに指定しないでください。ほかの共用ライブラリで参照するシンボルを含むライブラリを入れ替えた場合，入れ替え後の動作については保証しません。

コマンド形式

次ページに記述しています。

service_attr

名称

サービス属性の定義

形式

｛｛service_attr  ｛-v  サービス名｜-x  トランザクション種別｝
                  〔-a  トランザクション処理監視時間〕
                  〔-c〕
                  〔-d  Y｜N〕〕
                    ｝｝

機能

set形式のユーザサービス関連定義で定義した各サービスの付加情報を定義します。service_attr定義コマンドは，32000個＋-xオプションで指定できるトランザクション種別の数まで指定できます。

service_attr定義コマンドを省略した場合は，プロセス関連定義のservice_holdオペランドの指定値に従って，自動的に閉塞するかどうかを決定します。

オプション

●-v　サービス名　　〜〈1〜31文字の識別子〉

ユーザサービス関連定義のserviceオペランドで指定したサービスに対して付加情報を設定する場合に指定します。

●-x　トランザクション種別　　〜〈2文字の文字列〉

ユーザサービス関連定義のserviceオペランドで指定したサービス以外のトランザクションに対して付加情報を設定する場合に，トランザクション種別を設定します。

MI

プロセス初期化トランザクションに対して設定します。

ME

プロセス終了トランザクションに対して設定します。

E1

ERRTRN1に対して設定します。

E2

ERRTRN2に対して設定します。

E3

ERRTRN3に対して設定します。

E4

ERRTRN4に対して設定します。

ES

ERRTRNSに対して設定します。

ER

ERRTRNRに対して設定します。

UI

実行系連絡トランザクションに対して設定します。

MV

イベント通知トランザクションに対して設定します。

RL

MCP後処理トランザクションに対して設定します。

●-a　トランザクション処理監視時間　　〜〈符号なし整数〉((0〜65535))《トランザクション関連定義で指定したトランザクション処理監視時間》（単位：秒）

トランザクション処理の監視時間を秒単位で指定します。

監視時間が指定値を超えた場合は，プロセス関連定義のuapabend_downmodeオペランドの指定に従って異常終了します。

このオプションに0を指定した場合は，時間監視しません。また，このオプションの指定はeetrntimコマンドで変更できません。

このオプションを省略した場合，トランザクション関連定義の各オペランドで指定したトランザクション処理監視時間に従って，時間監視します。

●-c

UAPがサービストランザクションまたはタイマトランザクションを実行中に，異常（シグナル，ハングアップ，またはロールバックアベンド）が発生し，スレッドダウンまたはプロセスダウンした場合に，対象サービスを自動的に閉塞するときに指定します。

このオプションを有効にした場合，スレッドまたはプロセスの再起動時に，対象サービスが閉塞します。

このオプションを省略した場合，プロセス関連定義のservice_holdオペランドの指定値に関係なく，対象サービスを閉塞しません。

●-d　Y｜N 〜《forbid_draw_serviceオペランドの指定値》

UAPスレッドダウン時，または運用コマンド（API）によるサービス閉塞時に該当サービスの処理キューを引き出し禁止にするかどうかを指定します。

Y

サービス閉塞時，処理キューを引き出し禁止にします。

-cオプションを省略時，トランザクション異常（シグナル，ハングアップまたはロールバックアベンド）が発生し，スレッドダウンまたはプロセスダウンした場合は引き出し禁止にはなりません。したがって，トランザクション異常時も引き出し禁止にしたい場合は-cオプションを必ず指定してください。

N

サービス閉塞時，処理キューを引き出し禁止にしません。

-dオプションを省略した場合，ユーザサービス関連定義のforbid_draw_serviceオペランドの指定値に従って，処理キューを引き出し禁止にするかどうかを決定します。

-dオプションは，-vオプションを指定した場合に指定できます。-xオプションを指定した場合は，指定できません。

メッセージログ関連定義

形式

set形式

〔set log_file_size=メッセージログファイルの最大容量〕
〔set log_file_max=メッセージログファイルの最大ファイル数〕
〔set log_syslog_out=syslogへのメッセージ出力レベル〕
〔set log_usermsg_console=all|api〕
〔set log_syslog_prcid=Y|N〕
〔set log_base_infid=TP1/EE識別子〕
〔set log_syslog_prcno=Y|N〕
〔set log_syslog_date=Y|N〕
〔set log_syslog_time=Y|N〕
〔set log_syslog_service_name=Y|N〕
〔set log_syslog_central_no=Y|N〕
〔set log_syslog_id=Y|N〕
〔set log_syslog_elist=syslog失敗リストのエレメント数〕
〔set log_msg_console=Y|N〕
〔set log_msg_allno=Y|N〕
〔set log_msg_prcid=Y|N〕
〔set log_msg_prcno=Y|N〕
〔set log_msg_sysid=Y|N〕
〔set log_msg_date=Y|N〕
〔set log_msg_time=Y|N〕
〔set log_msg_hostname=Y|N〕
〔set log_msg_pgmid=Y|N〕
〔set log_hsyslog_cmode=SJIS|NONE〕

コマンド形式

なし。

機能

メッセージログ関連情報を定義します。

説明

各オペランドについて説明します。

set形式のオペランド

●log_file_size=メッセージログファイルの最大容量　　〜〈符号なし整数〉((10〜32767))《1024》（単位：キロバイト）

メッセージログファイルの最大容量を指定します。

●log_file_max=メッセージログファイルの最大ファイル数　　〜〈符号なし整数〉((3〜10))《3》

メッセージログを出力する最大ファイル数を指定します。

●log_syslog_out=syslogへのメッセージ出力レベル　　〜〈符号なし整数〉((0〜6))《3》

ログファイルへ出力されるメッセージについて，syslogへ出力するレベルを指定します。

0

すべてのメッセージを出力しません。

1

レベル1のメッセージを出力します。

2

レベル2以下のメッセージを出力します。

3

レベル3以下のメッセージを出力します。

4

レベル4以下のメッセージを出力します。

5

レベル5以下のメッセージを出力します。

6

すべてのメッセージを出力します。

メッセージの出力レベルとメッセージの内容を次の表に示します。

表8‒5　メッセージの出力レベル

レベル

メッセージの種類

1

I

TP1/EEの起動，終了などを示すメッセージ

E

プロセスダウンなどの致命的な障害を示すメッセージ

Q

ユーザからの応答が必要なメッセージ

このメッセージは，コンソール出力のため常に出力されます。

2

E

業務レベルでの障害などを示すメッセージ

3

E

基本レイヤ（部品）の障害を示すメッセージ

4

W

処理続行に支障はないが，ユーザに状況（障害）を通知するメッセージ

5

I

スレッド起動，コネクション確立などの情報を示すメッセージ

6

I

レベル5よりも優先順位が低い情報を示すメッセージ

●log_usermsg_console=all｜api　　〜《api》

ee_logprint，CBLEELOG(‘PRINT’)で，メッセージを標準出力に出力するかどうかの指定方法を指定します。log_msg_consoleにNを指定した場合はこの指定に関係なく，メッセージを標準出力に出力しません。

all

メッセージ出力時，APIの指定に関係なくすべてのメッセージを標準出力に出力します。

api

メッセージ出力時，標準出力にメッセージを出力するかどうかは，APIの指定に従います。

定義：log_msg_console

定義：log_usermsg_console

APIの指定

標準出力への出力有無

Y（デフォルト）

all

有り

○

無し（デフォルト）

○

api（デフォルト）

有り

○

無し（デフォルト）

×

N

−

−

×

（凡例）

○：メッセージを標準出力に出力します。

×：メッセージを標準出力に出力しません。

−：該当しません。

●log_syslog_prcid=Y|N　　〜《N》

syslog出力時にプロセスIDを付けるかどうかを指定します。

Y

syslog出力時，出力メッセージにプロセスIDを付けます。

N

syslog出力時，出力メッセージにプロセスIDを付けません。

●log_base_infid=TP1/EE識別子　　〜〈2文字の識別子〉

syslog出力時およびメッセージの標準出力時に付けるTP1/EE識別子を指定します。

メッセージの標準出力を行う場合にこのオペランドを有効にするには，log_msg_sysidオペランドにYを指定する必要があります。この場合，ノードIDの替わりにこのオペランドの指定値を出力します。

このオペランドを省略すると，TP1/EE識別子を付けません。

●log_syslog_prcno=Y|N　　〜《N》

syslog出力時にメッセージ通番を付けるかどうかを指定します。

Y

syslog出力時，出力メッセージにメッセージ通番を付けます。

N

syslog出力時，出力メッセージにメッセージ通番を付けません。

●log_syslog_date=Y|N　　〜《N》

syslog出力時に日付を付けるかどうかを指定します。

Y

syslog出力時，出力メッセージに日付を付けます。

N

syslog出力時，出力メッセージに日付を付けません。

●log_syslog_time=Y|N　　〜《N》

syslog出力時に時刻を付けるかどうかを指定します。

Y

syslog出力時，出力メッセージに時刻を付けます。

N

syslog出力時，出力メッセージに時刻を付けません。

●log_syslog_service_name=Y|N　　〜《N》

syslog出力時にサービス名を付けるかどうかを指定します。

Y

syslog出力時，出力メッセージにサービス名を付けます。

N

syslog出力時，出力メッセージにサービス名を付けません。

●log_syslog_central_no=Y|N　　〜《N》

syslog出力時に中央処理通番を付けるかどうかを指定します。

Y

syslog出力時，出力メッセージに中央処理通番を付けます。

N

syslog出力時，出力メッセージに中央処理通番を付けません。

●log_syslog_id=Y|N　　〜《N》

syslog出力時にOpenTP1識別子を付けるかどうかを指定します。OpenTP1識別子は，TP1/Server Baseのシステム共通定義のsystem_idオペランドで指定します。

Y

syslog出力時，出力メッセージにOpenTP1識別子を付けます。

N

syslog出力時，出力メッセージにOpenTP1識別子を付けません。

●log_syslog_elist=syslog失敗リストのエレメント数　　〜〈符号なし整数〉((0〜65536))《100》

ログサービスがsyslogファイルへの出力に失敗した場合に，該当するメッセージをリトライタイミングまで保管するメモリキューのエレメント数を指定します。1エレメントのサイズは512バイトです。

syslog失敗リストが満杯になった状態で，新たにメッセージを保管する必要がある場合は，エラーメッセージを標準エラー出力に出力したあとに，メッセージを破棄します。

log_syslog_elistオペランドは，1以上の値を指定し，かつ，log_syslog_outオペランドで1以上の値を指定した場合だけ，有効になります。

OSがLinuxの場合，環境変数CBLSYSLOGにYESを指定したときは，log_syslog_elistオペランドに1以上の値を指定してください。

●log_msg_console=Y|N　　〜《Y》

標準出力および標準エラー出力の出力設定があるメッセージを標準出力および標準エラー出力に出力するかどうかを指定します。

Y

標準出力および標準エラー出力の出力設定があるメッセージを，標準出力および標準エラー出力に出力します。

N

標準出力および標準エラー出力の出力設定があるメッセージを，標準出力および標準エラー出力に出力しません。

Yを指定したときだけ，以下のオペランド（log_msg_xxxx）の指定が有効になります。

●log_msg_allno=Y|N　　〜《N》

メッセージの標準出力時にプロセス内のメッセージ通番を付けるかどうかを指定します。

Y

プロセス内のメッセージ通番を付けます。

N

プロセス内のメッセージ通番を付けません。

log_msg_allnoオペランドにYを指定したときに出力される情報の内容は，メッセージログ関連定義のlog_msg_prcnoオペランドにYを指定したときに出力される情報の内容と同一です。

●log_msg_prcid=Y|N　　〜《N》

メッセージの標準出力時にメッセージの出力要求元のプロセスのプロセスIDを付けるかどうかを指定します。

Y

メッセージの要求元のプロセスのプロセスIDを付けます。

N

メッセージの要求元のプロセスのプロセスIDを付けません。

●log_msg_prcno=Y|N　　〜《N》

メッセージの標準出力時にプロセス内のメッセージ通番を付けるかどうかを指定します。

Y

プロセス内のメッセージ通番を付けます。

N

プロセス内のメッセージ通番を付けません。

log_msg_prcnoオペランドにYを指定したときに出力される情報の内容は，メッセージログ関連定義のlog_msg_allnoオペランドにYを指定したときに出力される情報の内容と同一です。

●log_msg_sysid=Y|N　　〜《Y》

メッセージの標準出力時にTP1/EE識別子を付けるかどうかを指定します。TP1/EE識別子には，RPC関連定義のnode_idオペランドの指定値の下2けたが出力されます。

Y

TP1/EE識別子を付けます。

N

TP1/EE識別子を付けません。

●log_msg_date=Y|N　　〜《Y》

メッセージの標準出力時にメッセージの出力要求時の日付を付けるかどうかを指定します。

Y

メッセージの出力要求時の日付を付けます。

N

メッセージの出力要求時の日付を付けません。

●log_msg_time=Y|N　　〜《Y》

メッセージの標準出力時にメッセージの出力要求時の時刻を付けるかどうかを指定します。

Y

メッセージの出力要求時の時刻を付けます。

N

メッセージの出力要求時の時刻を付けません。

●log_msg_hostname=Y|N　　〜《Y》

メッセージの標準出力時にメッセージの出力要求元のホスト名を付けるかどうかを指定します。

Y

メッセージの出力要求元のホスト名を付けます。

N

メッセージの出力要求元のホスト名を付けません。

●log_msg_pgmid=Y|N　　〜《Y》

メッセージの標準出力時にメッセージの出力要求元のプログラムIDを付けるかどうかを指定します。プログラムIDには，「ee」+半角スペース1文字が出力されます。

Y

メッセージの出力要求元のプログラムIDを付けます。

N

メッセージの出力要求元のプログラムIDを付けません。

●log_hsyslog_cmode=SJIS|NONE　　〜《NONE》

syslog出力時に拡張SYSLOGの文字コード変換機能を使用するかどうかを指定します。

このオペランドは，log_syslog_elistオペランドに1以上の値を指定した場合にだけ有効になります。

SJIS

拡張SYSLOGの文字コード変換機能を使用し，シフトJISからUTF-8に変換します。

NONE

拡張SYSLOGの文字コード変換機能を使用しません。

コマンド形式

なし。

トラブルシュート関連定義

形式

set形式

〔set trb_tasktm_file_size=TASKTMファイルの最大容量〕
〔set trb_tasktm_file_no=TASKTMファイルの最大ファイル数〕
〔set trb_tasktm_buffer_size=TASKTMバッファのサイズ〕
〔set trb_tasktm_buffer_no=TASKTMバッファ数〕
〔set trb_trace_file_size=回線トレースファイルの最大容量〕
〔set trb_trace_file_no=回線トレースファイルの最大ファイル数〕
〔set trb_line_trace_buffer_size=回線トレースバッファサイズ〕
〔set trb_line_trace_buffer_no=回線トレースバッファ数（xa_open関数以外）〕
〔set trb_line_xatrace_buffer_no=回線トレースバッファ数（xa_open関数）〕
〔set trb_uap_trace_entry_no=UAPトレース情報格納最大レコード数〕
〔set trb_uap_trace_file_size=UAPトレースファイルの最大容量〕
〔set trb_uap_trace_file_no=UAPトレースファイルの最大ファイル数〕
〔set trb_uap_trace_buffer_size=UAPトレースバッファサイズ〕
〔set trb_uap_trace_buffer_no=UAPトレースバッファ数〕
〔set trb_dump_file_no=メモリダンプファイルの最大ファイル数〕
〔set trb_dump_output_time=メモリダンプファイル出力監視時間〕
〔set trb_dump_area_kind=メモリダンプファイル出力領域種別〕
〔set trb_tasktm_type=TASKTMファイルの取得情報のタイプ〕
〔set trb_trace_type=回線トレースファイルの取得情報のタイプ〕
〔set trb_iso_interval_time=縮退監視メッセージ出力間隔時間〕
〔set trb_stc_file_size=統計情報ファイルの最大容量〕
〔set trb_stc_file_no=統計情報ファイルの最大ファイル数〕
〔set trb_stc_buffer_size=統計情報バッファのサイズ〕
〔set trb_stc_buffer_no=統計情報バッファ数〕
〔set trb_stc_interval_time=統計情報取得間隔時間〕
〔set trb_stc_obm_interval_time=OBM統計情報取得間隔時間〕
〔set trb_stc_basic_kind=基本統計情報種別〔,基本統計情報種別〕〕
〔set trb_stc_ext_kind=拡張統計情報種別〔,拡張統計情報種別〕…〕
〔set trb_stc_sys_kind=システム統計情報種別〔,システム統計情報種別〕…〕
〔set trb_extend_function=トラブルシュートおよび統計情報の機能拡張レベル〕
〔set trb_line_cmtrace_buffer_size=回線トレースバッファサイズ〕
〔set trb_line_cmtrace_buffer_no=回線トレースバッファ数〕
〔set trb_line_cmtrace_buf_entry_size=一時バッファ領域サイズ〕

コマンド形式

なし。

機能

トラブルシュートおよびトレース関連情報を定義します。

説明

各オペランドについて説明します。

set形式のオペランド

●trb_tasktm_file_size=TASKTMファイルの最大容量　　〜〈符号なし整数〉((400〜4000000))《40000》（単位：キロバイト）

TASKTM情報を取得するファイルの最大容量を指定します。

次の式を満たすように指定してください。

trb_tasktm_file_sizeオペランドの指定値 ＞ trb_tasktm_buffer_sizeオペランドの指定値

●trb_tasktm_file_no=TASKTMファイルの最大ファイル数　　〜〈符号なし整数〉((3〜100))《3》

TASKTM情報を出力する最大ファイル数を指定します。

●trb_tasktm_buffer_size=TASKTMバッファのサイズ　　〜〈符号なし整数〉((1〜20000))《200》（単位：キロバイト）

TASKTM情報をスタックするバッファのバッファサイズをキロバイト単位で指定します。

次の式を満たすように指定してください。

trb_tasktm_file_sizeオペランドの指定値 ＞ trb_tasktm_buffer_sizeオペランドの指定値

TASKTM編集時に破棄したレコード数が出力された場合は，最初にtrb_tasktm_buffer_noオペランドの設定値を増やしてください。trb_tasktm_buffer_noオペランドに最大値を設定しても破棄したレコード数が出力される場合は，このオペランドの設定値を増やしてください。

●trb_tasktm_buffer_no=TASKTMバッファ数　　〜〈符号なし整数〉((3〜200))《3》

TASKTM情報をスタックするバッファのバッファ数を指定します。

TASKTM編集時に破棄したレコード数が出力された場合は，このオペランドの設定値を増やしてください。最大値に設定しても破棄したレコード数が出力される場合は，trb_tasktm_buffer_sizeオペランドの設定値を増やしてください。

●trb_trace_file_size=回線トレースファイルの最大容量　　〜〈符号なし整数〉((400〜4000000))《40000》（単位：キロバイト）

回線トレース情報を取得するファイルの最大容量を指定します。

次の式を満たすように指定してください。

trb_trace_file_sizeオペランドの指定値 ＞ trb_line_trace_buffer_sizeオペランドの指定値

trb_extend_functionオペランドに00000001を論理和で指定したときは，次の式も満たすように指定してください。

trb_trace_file_sizeオペランドの指定値 ＞ trb_line_cmtrace_buffer_sizeオペランドの指定値

●trb_trace_file_no=回線トレースファイルの最大ファイル数　　〜〈符号なし整数〉((3〜100))《3》

回線トレース情報を出力する最大ファイル数を指定します。

●trb_line_trace_buffer_size=回線トレースバッファサイズ　　〜〈符号なし整数〉((1〜20000))《200》（単位：キロバイト）

次の回線トレース情報をスタックするバッファのバッファサイズをキロバイト単位で指定します。

RPC機能のトレース情報（trb_extend_functionオペランドに00000001を論理和で指定しない場合）

XAインタフェース，TP1EE情報コード，およびee_trb_utrace_put関数で出力したトレース情報

rap機能のトレース情報（trb_extend_functionオペランドに00000001を論理和で指定しない場合）

DBキュー機能（TCP/IP通信）のトレース情報

Oracleのエラー情報

RPC機能（UDP通信）のトレース情報（trb_extend_functionオペランドに00000001を論理和で指定しない場合）

SDBハンドラ機能のトレース情報

次の式を満たすように指定してください。式を満たさなかった場合は，KFSB65404-Eメッセージを出力してプロセスダウンします。

trb_trace_file_sizeオペランドの指定値 ＞ trb_line_trace_buffer_sizeオペランドの指定値

trb_extend_functionオペランドに00000001を論理和で指定したときは，次の式も満たすように指定してください。

trb_trace_file_sizeオペランドの指定値 ＞ trb_line_cmtrace_buffer_sizeオペランドの指定値

回線トレース編集時に破棄したレコード数が出力された場合は，最初にtrb_line_trace_buffer_noオペランド，trb_line_xatrace_buffer_noオペランドの設定値を増やしてください。trb_line_trace_buffer_noオペランド，trb_line_xatrace_buffer_noオペランドに最大値を設定しても破棄したレコード数が出力される場合は，このオペランドの設定値を増やしてください。

●trb_line_trace_buffer_no=回線トレースバッファ数　　〜〈符号なし整数〉((3〜200))《3》

次の回線トレース情報をスタックするバッファのバッファ数を指定します。

RPC機能のトレース情報（trb_extend_functionオペランドに00000001を論理和で指定しない場合）

rap機能のトレース情報（trb_extend_functionオペランドに00000001を論理和で指定しない場合）

DBキュー機能（TCP/IP通信）のトレース情報

Oracleのエラー情報

RPC機能（UDP通信）のトレース情報（trb_extend_functionオペランドに00000001を論理和で指定しない場合）

回線トレース編集時に破棄したレコード数が出力された場合は，このオペランドの設定値を増やしてください。最大値に設定しても破棄したレコード数が出力される場合は，trb_line_trace_buffer_sizeオペランドの設定値を増やしてください。

●trb_line_xatrace_buffer_no=回線トレースバッファ数　　〜〈符号なし整数〉((3〜200))《3》

次の回線トレース情報をスタックするバッファのバッファ数を指定します。

XAインタフェース，TP1EE情報コード，およびee_trb_utrace_put関数で出力したトレース情報

SDBハンドラ機能のトレース情報

回線トレース編集時に破棄したレコード数が出力された場合は，このオペランドの設定値を増やしてください。最大値に設定しても破棄したレコード数が出力される場合は，trb_line_trace_buffer_sizeオペランドの設定値を増やしてください。

●trb_uap_trace_entry_no=UAPトレース情報格納最大レコード数　　〜〈符号なし整数〉((16〜4095))《32》

UAPトレース情報を格納する最大レコード数を指定します。

UAPが異常終了した場合，障害が発生するまでにUAPで使用したライブラリ関数の呼び出し履歴を，コアファイルまたはメモリダンプファイルに取得します。

●trb_uap_trace_file_size=UAPトレースファイルの最大容量　　〜〈符号なし整数〉((400〜4000000))《40000》（単位：キロバイト）

UAPトレース情報を取得するUAPトレースファイルの最大容量を指定します。

次の式を満たすように指定してください。

trb_uap_trace_file_sizeオペランドの指定値 ＞ trb_uap_trace_buffer_sizeオペランドの指定値

プロセス関連定義のtrb_uap_trace_file_outオペランドにNを指定した場合，trb_uap_trace_file_sizeオペランドの指定は無効になります。

●trb_uap_trace_file_no=UAPトレースファイルの最大ファイル数　　〜〈符号なし整数〉((3〜100))《3》

UAPトレース情報を出力する最大ファイル数を指定します。

プロセス関連定義のtrb_uap_trace_file_outオペランドにNを指定した場合，trb_uap_trace_file_noオペランドの指定は無効になります。

●trb_uap_trace_buffer_size=UAPトレースバッファサイズ　　〜〈符号なし整数〉((1〜20000))《200》（単位：キロバイト）

UAPトレース情報をスタックするバッファのバッファサイズをキロバイト単位で指定します。

次の式を満たすように指定してください。

trb_uap_trace_file_sizeオペランドの指定値 ＞ trb_uap_trace_buffer_sizeオペランドの指定値

プロセス関連定義のtrb_uap_trace_file_outオペランドにNを指定した場合，trb_uap_trace_buffer_sizeオペランドの指定は無効になります。

UAPトレース編集時に破棄したレコード数が出力された場合は，最初にtrb_uap_trace_buffer_noオペランドの設定値を増やしてください。trb_uap_trace_buffer_noオペランドに最大値を設定しても破棄したレコード数が出力される場合は，このオペランドの設定値を増やしてください。

●trb_uap_trace_buffer_no=UAPトレースバッファ数　　〜〈符号なし整数〉((3〜200))《3》

UAPトレース情報をスタックするバッファのバッファ数を指定します。

プロセス関連定義のtrb_uap_trace_file_outオペランドにNを指定した場合，trb_uap_trace_buffer_noオペランドの指定は無効になります。

UAPトレース編集時に破棄したレコード数が出力された場合は，このオペランドの設定値を増やしてください。最大値に設定しても破棄したレコード数が出力される場合は，trb_uap_trace_buffer_sizeオペランドの設定値を増やしてください。

●trb_dump_file_no=メモリダンプファイルの最大ファイル数　　〜〈符号なし整数〉((3〜20))《10》

メモリダンプ情報を出力する最大ファイル数を指定します。

●trb_dump_output_time=メモリダンプファイル出力監視時間　　〜〈符号なし整数〉((0〜65535))《60》（単位：秒）

メモリダンプファイル出力処理に対するタイマ監視時間を指定します。

0を指定した場合は，時間監視しません。

●trb_dump_area_kind=メモリダンプファイル出力領域種別　　〜〈符号なし整数〉((0｜9｜13))《9》

メモリダンプファイルに出力する出力対象領域を指定します。

0

出力対象領域なしと設定します。

9

システム用テーブル領域とユーザ用テーブル領域を設定します。

13

システム用テーブル領域とユーザ用テーブル領域に加え次の表に示す出力対象領域を設定します。

通常は，このオペランドを指定する必要はありません。

保守員がこのオペランドの指定を依頼した場合は，保守員の指示に従ってください。

表8‒6　trb_dump_area_kindオペランドに13を指定した場合に設定する出力対象領域

出力対象領域

有効となる条件

COBOL用メモリ領域

COBOL用メモリ管理機能を使用している。

XDB用ワーク領域（XDBPOOL）

XDBを使用している。

XTC用ワーク領域（XTCPOOL）

XTCを使用している。

大量処理用システム領域（MPSPOOL）

大量処理用メモリ管理機能を使用している。

●trb_tasktm_type=TASKTMファイルの取得情報のタイプ　　〜〈符号なし整数〉((1〜3))《1》

TASKTMファイルの取得情報のタイプを指定します。

1

2，および3で示す機能を使用しない場合に指定します。

2

バージョン07-50でサポートされた情報を編集します。次の機能のどれかを使用する場合に指定することをお勧めします。

資源の排他制御

MCP

XTC

XDB

3

バージョン07-80でサポートされた情報を編集します。次の機能のどれかを使用する場合に指定することをお勧めします。

資源の排他制御

MCP

XTC

TP1/FSP

このオペランドに2，または3を指定すると，1を指定するときよりも多くの情報を取得します。詳細については，「eetrbtasked」の出力形式を参照してください。

なお，このオペランドに2，または3を指定すると，1を指定するときよりもファイルサイズが増加するため，注意してください。

●trb_trace_type=回線トレースファイルの取得情報のタイプ　　〜〈符号なし整数〉((1))《1》

回線トレースファイルの取得情報のタイプを指定します。trb_trace_typeオペランドを指定する場合は，1を指定してください。

●trb_iso_interval_time=縮退監視メッセージ出力間隔時間　　〜〈符号なし整数〉((0〜60))《5》（単位：分）

トラブルシュートで使用するファイルが縮退し，正常なファイルが2ファイル以下になっている間に出力されるKFSB45407-Wメッセージの出力間隔を指定します。

0を指定した場合，KFSB45407-Wメッセージは出力されません。

●trb_stc_file_size=統計情報ファイルの最大容量　　〜〈符号なし整数〉((400〜4000000))《40000》（単位：キロバイト）

統計情報ファイルの最大容量を指定します。

次の式を満たすように指定してください。

trb_stc_file_sizeオペランドの指定値 ＞ trb_stc_buffer_sizeオペランドの指定値

プロセス関連定義のtrb_stc_useオペランドにNを指定した場合，trb_stc_file_sizeオペランドの指定は無効になります。

●trb_stc_file_no=統計情報ファイルの最大ファイル数　　〜〈符号なし整数〉((3〜100))《3》

統計情報を出力する最大ファイル数を指定します。

プロセス関連定義のtrb_stc_useオペランドにNを指定した場合，trb_stc_file_noオペランドの指定は無効になります。

●trb_stc_buffer_size=統計情報バッファのサイズ　　〜〈符号なし整数〉((2〜20000))《200》（単位：キロバイト）

統計情報をスタックするバッファのバッファサイズをキロバイト単位で指定します。ただし，サービスの定義数やTP1/EEのバージョンによっては，バッファサイズの最小値が異なります。次に示す式を満たすように，値を指定してください。式を満たさない場合は，システムが自動的に式を満たす値に変更します。

統計情報バッファサイズ＝↑（432 +（16 × サービス数））÷1024↑

（凡例）

↑↑：小数点以下を切り上げます。

TP1/EE 07-70以降でこの計算式の値が3以下の場合，4を指定してください。

このオペランドは，次の式を満たすように指定してください。

trb_stc_file_sizeオペランドの指定値 ＞ trb_stc_buffer_sizeオペランドの指定値

統計情報編集時に破棄したレコード数が出力された場合は，最初にtrb_stc_trace_buffer_noオペランドの設定値を増やしてください。trb_stc_trace_buffer_noオペランドに最大値を設定しても破棄したレコード数が出力される場合は，このオペランドの設定値を増やしてください。

プロセス関連定義でtrb_stc_useオペランドにNを指定した場合，trb_stc_buffer_sizeオペランドの指定は無効になります。

●trb_stc_buffer_no=統計情報バッファ数　　〜〈符号なし整数〉((3〜200))《3》

統計情報をスタックするバッファのバッファ数を指定します。

統計情報編集時に破棄したレコード数が出力された場合は，このオペランドの設定値を増やしてください。最大値に設定しても破棄したレコード数が出力される場合は，trb_stc_buffer_sizeオペランドの設定値を増やしてください。

プロセス関連定義でtrb_stc_useオペランドにNを指定した場合，trb_stc_buffer_noオペランドの指定は無効になります。

●trb_stc_interval_time=統計情報取得間隔時間　　〜〈符号なし整数〉((1〜1440))《10》（単位：分）

システム起動時から取得を開始する基本統計情報（システム統計情報と処理キュー統計情報）の取得時間間隔を指定します。

プロセス関連定義のtrb_stc_useオペランドにNを指定した場合，または，トラブルシュート関連定義のtrb_stc_basic_kindオペランドの指定を省略した場合は，trb_stc_interval_timeオペランドの指定は無効になります。

●trb_stc_obm_interval_time=OBM統計情報取得間隔時間　　〜〈符号なし整数〉((1〜60))《1》（単位：分）

システム起動時から取得開始するOBM統計情報のインタバル取得時の時間間隔を指定します。インタバル取得に該当するのはOBM統計情報です。

プロセス関連定義でtrb_stc_use=Nを指定した場合，また，trb_stc_ext_kindでeobmの指定がない場合はこのオペランドの指定を無視します。

●trb_stc_basic_kind=基本統計情報種別〔,基本統計情報種別〕

TP1/EEシステムの起動時から取得を開始する基本統計情報の統計情報種別を指定します。

同じ基本統計情報種別を複数個指定した場合は，1個と見なされます。

sys

システム統計情報を取得します。

pci

処理キュー統計情報を取得します。

apm

UAP履歴情報メモリ通番統計情報を取得します。

trb_stc_basic_kindオペランドの指定を省略すると，基本統計情報を取得しません。

プロセス関連定義のtrb_stc_useオペランドにNを指定した場合は，trb_stc_basic_kindオペランドの指定は無効になります。

apmは，TP1/FSPのUAP履歴情報メモリ通番機能を使用（trnaphgroupオペランドの-mオプションを指定）した場合に有効です。UAP履歴情報メモリ通番機能を使用していない場合はapmを指定しても無視されます。

●trb_stc_ext_kind=拡張統計情報種別〔,拡張統計情報種別〕…

TP1/EEシステムの起動時から取得を開始する拡張統計情報の統計情報種別を指定します。

同じ拡張統計情報種別を複数個指定した場合は，1個と見なされます。

ersp

レスポンス統計情報を取得します。

edly

通信遅延時間統計情報を取得します。

edbq

DBキュー統計情報を取得します。

プロセス関連定義のdbq_useオペランドにNを指定した場合，edbqの指定は無効になります。

eobs

オンラインバッチ統計情報を取得します。

プロセス関連定義のdbq_obs_useオペランドにNを指定した場合，eobsの指定は無効になります。

trb_stc_ext_kindオペランドの指定を省略すると，拡張統計情報を取得しません。

プロセス関連定義のtrb_stc_useオペランドにNを指定した場合，trb_stc_ext_kindオペランドの指定は無効になります。

●trb_stc_sys_kind=システム統計情報種別〔,システム統計情報種別〕…

取得するシステム統計情報の統計情報種別を指定します。

同じシステム統計情報種別を複数個指定した場合は，1個と見なされます。

aph

UAP履歴情報を取得します。

TP1/FSPのトランザクション関連定義のtrn_aph_useオペランドにNを指定した場合，aphの指定は無効になります。

api

API情報を取得します。

dbq

DBキュー情報を取得します。

プロセス関連定義のdbq_useオペランドおよびdbq_obs_useオペランドの両方にNを指定した場合，dbqの指定は無効になります。

fil

ファイルサービス情報を取得します。

mem

メモリ情報を取得します。

obm

OBM情報を取得します。

OBM関連定義のobm_server_typeオペランドにNを指定した場合，obmの指定は無効になります。

rpc

RPC情報を取得します。

scd

スケジュール情報を取得します。

sdh

SDBハンドラ情報を取得します。

SDBハンドラ関連定義のsdh_useオペランドにNを指定した場合，sdhの指定は無効になります。

sts

ステータスファイル情報を取得します。

tim

タイマ情報を取得します。

trb

トラブルシュート情報

trn

トランザクション情報を取得します。

xtc

XTCの情報を取得します。

プロセス関連定義のxtc_useオペランドにNを指定した場合，xtcの指定は無効になります。

xdb

XDBの情報を取得します。

プロセス関連定義のxdb_useオペランドにNを指定した場合，xdbの指定は無効になります。

trb_stc_sys_kindオペランドの指定を省略すると，すべてのシステム統計情報を取得します。オペランド値は，17個まで指定できます。同じ値を重複して指定した場合は無効になります。

プロセス関連定義のtrb_stc_useオペランドにNを指定した場合，または，トラブルシュート関連定義のtrb_stc_basic_kindオペランドにsysが指定されていない場合は，trb_stc_sys_kindオペランドの指定は無効になります。

OBM関連定義，およびSDBハンドラ関連定義については，TP1/FSPの関連ドキュメントを参照してください。

●trb_extend_function=トラブルシュートおよび統計情報の機能拡張レベル　　〜〈16進数〉((00000000|00000001|00000010|00000020))《00000000》

トラブルシュートおよび統計情報の機能拡張レベルを，符号なし整数の和で指定します。

00000000

トラブルシュートおよび統計情報の機能拡張をしません。

00000001

回線トレースの一括出力機能を使用します。

00000010

トラブルシュートのバッファコピー抑止機能を使用します。

この場合，バッファを1面多く確保します。確保するサイズを次に示します。

trb_tasktm_buffer_sizeオペランドの指定値

trb_uap_trace_buffer_sizeオペランドの指定値

trb_line_trace_buffer_sizeオペランドの指定値×2

trb_line_cmtrace_buffer_sizeオペランドの指定値※

注※

00000001を論理和で指定した場合に該当します。

00000020

統計情報のバッファコピー抑止機能を使用します。

この場合，バッファを1面多く確保します。確保するサイズを次に示します。

trb_stc_buffer_sizeオペランドの指定値

●trb_line_cmtrace_buffer_size=回線トレースバッファサイズ　　〜〈符号なし整数〉((2〜20000))《200》（単位：キロバイト）

次の回線トレース情報をスタックするバッファのバッファサイズをキロバイト単位で指定します。

RPC機能のトレース情報

rap機能のトレース情報

RPC機能（UDP通信）のトレース情報

このオペランドは，trb_extend_functionオペランドに00000001を論理和で指定した場合に有効です。

このオペランドは，次の式を満たすように指定してください。式を満たさなかった場合は，KFSB65404-Eメッセージを出力してプロセスダウンします。

trb_trace_file_sizeオペランドの指定値 ＞ trb_line_cmtrace_buffer_sizeオペランドの指定値

回線トレース編集時に破棄したレコード数が出力された場合は，最初にtrb_line_cmtrace_buffer_noオペランドの設定値を増やしてください。trb_line_cmtrace buffer_noオペランドに最大値を設定しても破棄したレコード数が出力される場合は，このオペランドの設定値を増やしてください。

●trb_line_cmtrace_buffer_no=回線トレースバッファ数　　〜〈符号なし整数〉((3〜200))《3》

次の回線トレース情報をスタックするバッファのバッファ数を指定します。

RPC機能のトレース情報

rap機能のトレース情報

RPC機能（UDP通信）のトレース情報

このオペランドは，trb_extend_functionオペランドに00000001を論理和で指定した場合に有効です。

回線トレース編集時に破棄したレコード数が出力された場合は，このオペランドの設定値を増やしてください。最大値に設定しても破棄したレコード数が出力される場合は，trb_line_cmtrace_buffer_sizeオペランドの設定値を増やしてください。

●trb_line_cmtrace_buf_entry_size=一時バッファ領域サイズ　　〜〈符号なし整数〉((1〜64))《12》（単位：キロバイト）

次の回線トレース情報をスレッド単位で格納する一時バッファ領域のサイズを，キロバイト単位で指定します。

RPC機能のトレース情報

rap機能のトレース情報

RPC機能（UDP通信）のトレース情報

次に示す式を満たすように指定することをお勧めします。式を満たさなかった場合は，UDP，rap，およびRPC通信制御の性能が劣化するおそれがあります。

trb_line_cmtrace_buffer_size＞trb_line_cmtrace_buf_entry_size

このオペランドは，trb_extend_functionオペランドに00000001を論理和で指定した場合に有効です。

コマンド形式

なし。

トランザクション関連定義

形式

set形式

  set trn_tran_process_count=同時に起動するトランザクションブランチの数
〔set trn_expiration_time=トランザクション処理監視時間〕
〔set trn_expiration_time_mi=MIトランザクション処理監視時間〕
〔set trn_expiration_time_me=MEトランザクション処理監視時間〕
〔set trn_expiration_time_mn=MNトランザクション処理監視時間〕
〔set trn_expiration_time_tm=TMトランザクション処理監視時間〕
〔set trn_expiration_time_e1=E1トランザクション処理監視時間〕
〔set trn_expiration_time_e2=E2トランザクション処理監視時間〕
〔set trn_expiration_time_e3=E3トランザクション処理監視時間〕
〔set trn_expiration_time_e4=E4トランザクション処理監視時間〕
〔set trn_expiration_time_es=ESトランザクション処理監視時間〕
〔set trn_expiration_time_er=ERトランザクション処理監視時間〕
〔set trn_expiration_time_rl=RLトランザクション処理監視時間〕
〔set trn_max_subordinate_count=子トランザクションブランチ最大数〕
〔set trn_optimum_item=トランザクション最適化項目〔,トランザクション最適化項目〕〕
〔set trn_watch_time=トランザクション同期点処理時の最大通信待ち時間〕
〔set trn_rollback_information_put=no|self|remote|all〕
〔set trn_wait_rm_open=continue|stop|retry_continue|retry_stop〕
〔set trn_retry_interval_rm_open=xa_open関数呼び出しリトライインタバル時間〕
〔set trn_retry_count_rm_open=xa_open関数呼び出しリトライ回数〕
〔set trn_retry_interval_rm_open_mime=xa_open関数呼び出しリトライインタバル時間(MI，MEトランザクション用)〕
〔set trn_retry_count_rm_open_mime=xa_open関数呼び出しリトライ回数（MI，MEトランザクション用）〕
〔set trn_endprepare_msg_interval=終了時の仕掛り中トランザクション情報メッセージ出力間隔時間〕
〔set trn_delayed_allrecover=Y|N〕
〔set trn_recovery_failmsg_interval=仕掛り中トランザクション情報メッセージ間隔最小時間〕
〔set trn_endrerun_msg_interval=TP1/EE再開始時の仕掛りトランザクション情報メッセージ出力間隔時間〕
〔set trn_max_commit_count=コミット関数の呼び出し回数上限値〕
〔set trn_max_commit_downmode=P|T|N〕
〔set trn_max_rollback_count=ロールバック関数の呼び出し回数上限値〕
〔set trn_max_rollback_downmode=P|T|N〕
〔set trn_undelayed_recover_thread=Y|N〕
〔set trn_rm_open_close_scope=process|transaction〕
〔set lck_timeout_info=Y|N〕
〔set lck_limit_foruser=同時に発生する排他要求数の最大値〕
〔set lck_wait_timeout=排他待ち限界経過時間〕
〔set trn_sta_pdcwaittime=開始時のPDCWAITTIMEの変更時間〕
〔set trn_onl_pdcwaittime=オンライン中のPDCWAITTIMEの変更時間〕

コマンド形式

｛｛trnstring  -n  リソースマネジャ名
             〔-i  リソースマネジャ拡張子〔,リソースマネジャ拡張子〕…〕
             〔-o  "トランザクションサービス用xa_open関数用文字列"〕
             〔-c  "トランザクションサービス用xa_close関数用文字列"〕
             〔-O  "ユーザサービス用xa_open関数用文字列"〕
             〔-C  "ユーザサービス用xa_close関数用文字列"〕
             〔-r〕〔-x〕
                         ｝｝

機能

トランザクション関連情報を定義します。

説明

各オペランドについて説明します。

set形式のオペランド

●trn_tran_process_count=同時に起動するトランザクションブランチの数　　〜〈符号なし整数〉((1〜8192))

同時に起動するトランザクションブランチの数を指定します。

トランザクション処理のRPC機能を使用する処理スレッド数（予備処理スレッド数，およびタイマ処理スレッド数に1を加えた値を含む），送信スレッド数，回復スレッド数，および回復処理を待っているトランザクションブランチ数の総数を指定します。

トランザクションブランチを起動した処理スレッドが異常終了した場合に，回復スレッドがほかのトランザクションブランチの決着を処理中のとき，異常終了した処理スレッドのトランザクションブランチは回復処理待ちの状態になります。回復処理待ちの状態が長く続くと，起動できるトランザクションブランチ数が少なくなることがあります。そのため，処理スレッドの異常終了後にトランザクションブランチを起動できる処理スレッドの扱いや，異常発生の頻度などを考慮して，trn_tran_process_countオペランドを指定してください。また，再開始時にスレッドを増加させるなどの運用をする場合は，スレッドの増加分を考慮して指定してください。指定数の目安を次に示します。

（トランザクション実行する処理スレッド数＋送信スレッド数＋回復スレッド数）＜trn_tran_process_countオペランドの指定値

なお，同時に起動するトランザクションブランチが，trn_tran_process_countオペランドの指定数を超えて起動した場合，プロセスダウンします。

また，trn_tran_process_countオペランドの指定値が大きくなるほどメモリ資源の使用効率が悪くなるので注意してください。

このオペランドは省略できません。必ず指定してください。

●trn_expiration_time=トランザクション処理監視時間　　〜〈符号なし整数〉((0〜65535))《60》（単位：秒）

トランザクション処理の監視時間を指定します。

監視時間が指定値を超えた場合は，プロセス関連定義のuapabend_downmodeオペランドの指定に従って異常終了します。

trn_expiration_timeオペランドに0を指定した場合は，時間監視しません。

●trn_expiration_time_mi=MIトランザクション処理監視時間　　〜〈符号なし整数〉((0〜65535))（単位：秒）

初期化トランザクションでのトランザクション処理の監視時間を指定します。

監視時間が指定値を超えた場合は，プロセス関連定義のuapabend_downmodeオペランドの指定に従って異常終了します。

trn_expiration_time_miオペランドに0を指定した場合は，時間監視しません。trn_expiration_time_miオペランドを省略した場合は，トランザクション関連定義のtrn_expiration_timeオペランドの指定値をデフォルト値とします。

●trn_expiration_time_me=MEトランザクション処理監視時間　　〜〈符号なし整数〉((0〜65535))（単位：秒）

終了トランザクションでのトランザクション処理の監視時間を指定します。

監視時間が指定値を超えた場合は，プロセス関連定義のuapabend_downmodeオペランドの指定に従って異常終了します。

trn_expiration_time_meオペランドに0を指定した場合は，時間監視しません。trn_expiration_time_meオペランドを省略した場合は，トランザクション関連定義のtrn_expiration_timeオペランドの指定値をデフォルト値とします。

●trn_expiration_time_mn=MNトランザクション処理監視時間　　〜〈符号なし整数〉((0〜65535))（単位：秒）

サービストランザクションでのトランザクション処理の監視時間を指定します。

監視時間が指定値を超えた場合は，プロセス関連定義のuapabend_downmodeオペランドの指定に従って異常終了します。

trn_expiration_time_mnオペランドに0を指定した場合は，時間監視しません。trn_expiration_time_mnオペランドを省略した場合は，トランザクション関連定義のtrn_expiration_timeオペランドの指定値をデフォルト値とします。

●trn_expiration_time_tm=TMトランザクション処理監視時間　　〜〈符号なし整数〉((0〜65535))（単位：秒）

タイマトランザクションでのトランザクション処理の監視時間を指定します。

監視時間が指定値を超えた場合は，プロセス関連定義のuapabend_downmodeオペランドの指定に従って異常終了します。

trn_expiration_time_tmオペランドに0を指定した場合は，時間監視しません。trn_expiration_time_tmオペランドを省略した場合は，トランザクション関連定義のtrn_expiration_timeオペランドの指定値をデフォルト値とします。

●trn_expiration_time_e1=E1トランザクション処理監視時間　　〜〈符号なし整数〉((0〜65535))（単位：秒）

ERRTRN1でのトランザクション処理の監視時間を指定します。

監視時間が指定値を超えた場合は，プロセス関連定義のuapabend_downmodeオペランドの指定に従って異常終了します。

trn_expiration_time_e1オペランドに0を指定した場合は，時間監視しません。trn_expiration_time_e1オペランドを省略した場合は，トランザクション関連定義のtrn_expiration_timeオペランドの指定値をデフォルト値とします。

●trn_expiration_time_e2=E2トランザクション処理監視時間　　〜〈符号なし整数〉((0〜65535))（単位：秒）

ERRTRN2でのトランザクション処理の監視時間を指定します。

監視時間が指定値を超えた場合は，プロセス関連定義のuapabend_downmodeオペランドの指定に従って異常終了します。

trn_expiration_time_e2オペランドに0を指定した場合は，時間監視しません。trn_expiration_time_e2オペランドを省略した場合は，トランザクション関連定義のtrn_expiration_timeオペランドの指定値をデフォルト値とします。

●trn_expiration_time_e3=E3トランザクション処理監視時間　　〜〈符号なし整数〉((0〜65535))（単位：秒）

ERRTRN3でのトランザクション処理の監視時間を指定します。

監視時間が指定値を超えた場合は，プロセス関連定義のuapabend_downmodeオペランドの指定に従って異常終了します。

trn_expiration_time_e3オペランドに0を指定した場合は，時間監視しません。trn_expiration_time_e3オペランドを省略した場合は，トランザクション関連定義のtrn_expiration_timeオペランドの指定値をデフォルト値とします。

●trn_expiration_time_e4=E4トランザクション処理監視時間　　〜〈符号なし整数〉((0〜65535))（単位：秒）

ERRTRN4でのトランザクション処理の監視時間を指定します。

監視時間が指定値を超えた場合は，プロセス関連定義のuapabend_downmodeオペランドの指定に従って異常終了します。

trn_expiration_time_e4オペランドに0を指定した場合は，時間監視しません。trn_expiration_time_e4オペランドを省略した場合は，トランザクション関連定義のtrn_expiration_timeオペランドの指定値をデフォルト値とします。

●trn_expiration_time_es=ESトランザクション処理監視時間　　〜〈符号なし整数〉((0〜65535))（単位：秒）

ERRTRNSでのトランザクション処理の監視時間を指定します。

監視時間が指定値を超えた場合は，プロセス関連定義のuapabend_downmodeオペランドの指定に従って異常終了します。

trn_expiration_time_esオペランドに0を指定した場合は，時間監視しません。trn_expiration_time_esオペランドを省略した場合は，トランザクション関連定義のtrn_expiration_timeオペランドの指定値をデフォルト値とします。

●trn_expiration_time_er=ERトランザクション処理監視時間　　〜〈符号なし整数〉((0〜65535))（単位：秒）

ERRTRNRでのトランザクション処理の監視時間を指定します。

監視時間が指定値を超えた場合は，プロセス関連定義のuapabend_downmodeオペランドの指定に従って異常終了します。

trn_expiration_time_erオペランドに0を指定した場合は，時間監視しません。trn_expiration_time_erオペランドを省略した場合は，トランザクション関連定義のtrn_expiration_timeオペランドの指定値をデフォルト値とします。

●trn_expiration_time_rl=RLトランザクション処理監視時間　　〜〈符号なし整数〉((0〜65535))（単位：秒）

MCP後処理トランザクションでのトランザクション処理の監視時間を指定します。

監視時間が指定値を超えた場合は，プロセス関連定義のuapabend_downmodeオペランドの指定に従って異常終了します。

trn_expiration_time_rlオペランドに0を指定した場合は，時間監視しません。trn_expiration_time_rlオペランドを省略した場合は，トランザクション関連定義のtrn_expiration_timeオペランドの指定値をデフォルト値とします。

●trn_max_subordinate_count=子トランザクションブランチ最大数　　〜〈符号なし整数〉((0〜1024))《32》

TP1/EE下の一つのトランザクションブランチから生成する子トランザクションブランチの最大数を指定します。trn_max_subordinate_countオペランドの指定値は，一つのトランザクションブランチから呼び出すee_rpc_call関数の最大数です。

trn_max_subordinate_countオペランドは，トランザクション連携をする場合だけ有効です。トランザクション連携をしない場合は0を指定することを推奨します。

●trn_optimum_item=トランザクション最適化項目〔,トランザクション最適化項目〕

複数のユーザサーバで構成されるグローバルトランザクションの性能を向上させるための最適化項目を指定します。TP1/EEのトランザクション制御は2相コミットで実行しているため，二つのトランザクションブランチ間のコミットには，4回のプロセス間通信が必要になります。トランザクションを最適化すると，プロセス間通信を削減できます。

最適化項目は，次の文字列で指定します。複数の最適化項目を指定することもできます。

onephase

1相最適化をします。次の条件をすべて満たす場合，子トランザクションブランチのコミット処理だけで済むため，コミットで必要なプロセス間通信を2回削減できます。

クライアント側のトランザクションブランチにリンケージされているリソースマネジャが，動的登録をするリソースマネジャだけである

クライアント側のトランザクションブランチが，リソースマネジャへアクセスしていない

クライアント側のトランザクションブランチの子トランザクションブランチは一つ以下である

readonly

リードオンリー最適化をします。次の条件を満たす場合，子トランザクションブランチ側でリソースマネジャの更新処理をしていないため，2相目の処理が不要になり，コミットで必要なプロセス間通信を2回削減できます。

サーバ側のトランザクションブランチが，リソースの更新処理（参照処理は除く）をしていない

このオペランド省略時は，トランザクションの最適化をしません。

●trn_watch_time=トランザクション同期点処理時の最大通信待ち時間　　〜〈符号なし整数〉((1〜65535))《120》（単位：秒）

トランザクションの同期点処理で，トランザクションブランチ間で行う通信（プリペア，コミット，ロールバック，応答など）の受信待ち時間の最大値を指定します。

指定時間を過ぎても通信がない場合は，該当するトランザクションブランチが2相コミットの1相目完了前のときは，ロールバックします。1相目完了後のときは，トランザクションサービスの回復スレッドでトランザクション決着処理を再試行します。

trn_watch_timeオペランドは，トランザクション連携をする場合だけ有効です。RPCがタイムアウトした場合，トランザクションの同期点処理でtrn_watch_timeオペランドの指定時間待ち合わせを行うことがあります。

●trn_rollback_information_put=no|self|remote|all　　〜《no》

トランザクションブランチがロールバックした場合に，ロールバック要因に関するメッセージをログに取得するかどうかを指定します。対象メッセージはKFSB80900-Iメッセージです。

no

KFSB80900-Iメッセージを取得しません。

self

ロールバック要因が発生したトランザクションブランチでだけ，KFSB80900-Iメッセージを取得します。

remote

ロールバック要因が発生したトランザクションブランチ，およびほかのトランザクションブランチからロールバック要求されたトランザクションブランチで，KFSB80900-Iメッセージを取得します。

all

remoteを指定した場合と同じです。

●trn_wait_rm_open=continue|stop|retry_continue|retry_stop　　〜《continue》

リソースマネジャのオープン処理（xa_open関数）で障害が発生した場合の処置を指定します。

continue

xa_open関数エラーを無視して処理を続行します。

stop

xa_open関数エラーが発生した場合，処理を中止します。

retry_continue

xa_open関数エラーが発生した場合，処理を中断し，trn_retry_interval_rm_openオペランドまたはtrn_retry_interval_rm_open_mimeオペランドで指定した間隔で，trn_retry_count_rm_openオペランドまたはtrn_retry_count_rm_open_mimeオペランドで指定した回数だけ，xa_open関数の呼び出しをリトライします。リトライしてもxa_open関数エラーが解消されない場合は，エラーを無視して処理を続行します。

retry_stop

xa_open関数エラーが発生した場合，処理を中断しtrn_retry_interval_rm_openオペランドまたはtrn_retry_interval_rm_open_mimeオペランドで指定した間隔で，trn_retry_count_rm_openオペランドまたはtrn_retry_count_rm_open_mimeオペランドで指定した回数だけ，xa_open関数の呼び出しをリトライします。リトライしてもxa_open関数エラーが解消されない場合は，処理を中止します。

●trn_retry_interval_rm_open=xa_open関数呼び出しリトライインタバル時間　　〜〈符号なし整数〉((1〜3600))《10》（単位：秒）

xa_open関数の呼び出しをリトライする間隔を指定します。

●trn_retry_count_rm_open=xa_open関数呼び出しリトライ回数　　〜〈符号なし整数〉((1〜65535))《18》

xa_open関数の呼び出しをリトライする回数を指定します。

●trn_retry_interval_rm_open_mime=xa_open関数呼び出しリトライインタバル時間（MI，MEトランザクション用）　　〜〈符号なし整数〉((1〜3600))《10》（単位：秒）

MIトランザクション，およびMEトランザクションの場合の，xa_open関数の呼び出しをリトライする間隔を指定します。

●trn_retry_count_rm_open_mime=xa_open関数呼び出しリトライ回数（MI，MEトランザクション用）　　〜〈符号なし整数〉((1〜65535))《18》

MIトランザクション，およびMEトランザクションの場合の，xa_open関数の呼び出しをリトライする回数を指定します。

●trn_endprepare_msg_interval=終了時の仕掛り中トランザクション情報メッセージ出力間隔時間　　〜〈符号なし整数〉((0〜3600))《180》（単位：秒）

TP1/EEの正常終了および計画停止A時に，仕掛り中トランザクションがある場合にメッセージを出力する間隔を指定します。仕掛り中トランザクションには，UAPを実行しないシステム系のトランザクションも含みます。

0を指定した場合は，メッセージを1回だけ出力します。

終了トランザクション（ME）完了後も，システム系のトランザクションが動作します。そのため，障害などでユーザが運用をする可能性があるシステム系のトランザクションについては，メッセージ出力の対象となります。

trn_endprepare_msg_intervalオペランドの指定値と，実際のメッセージ出力間隔とは，最大5秒の誤差が発生します。trn_endprepare_msg_intervalオペランドの指定値とメッセージ出力の関係を次に示します。

プロセス終了監視トランザクション起動間隔＜trn_endprepare_msg_intervalオペランドの指定値＜メッセージ出力間隔

●trn_delayed_allrecover=Y|N　　〜《Y》

TP1/EE再開始時のプロセスの回復方法を指定します。

Y

ディレード回復を使用して，プロセスを回復します。

N

アンディレード回復を使用して，プロセスを回復します。

●trn_recovery_failmsg_interval=仕掛り中トランザクション情報メッセージ間隔最小時間　　〜〈符号なし整数〉((0〜65535))《180》（単位：秒）

仕掛り中トランザクション情報メッセージ（KFSB40911-Wメッセージ）を出力する最小時間間隔を指定します。

0を指定した場合は，KFSB40911-Wメッセージを出力しません。

●trn_endrerun_msg_interval=TP1/EE再開始時の仕掛りトランザクション情報メッセージ出力間隔時間　　〜〈符号なし整数〉((0〜3600))《180》（単位：秒）

TP1/EE再開始時，仕掛り中トランザクションがある場合に，KFSB80902-Iメッセージを出力する間隔を指定します。

0を指定した場合は，1回だけKFSB80902-Iメッセージを出力します。

trn_endrerun_msg_intervalオペランドの指定値と，実際のメッセージ出力間隔とは，最大1秒の誤差が発生します。

●trn_max_commit_count=コミット関数の呼び出し回数上限値　　〜〈符号なし整数〉((0〜999999))《0》

トランザクション起動後にUAPをリターンするまでの，ee_trn_chained_commit関数の呼び出し回数の上限値を指定します。ee_trn_chained_commit関数の呼び出し回数が指定値に達した場合，トランザクション関連定義のtrn_max_commit_downmodeオペランドの指定に従って処理します。

trn_max_commit_countオペランドに0を指定するか，指定を省略した場合は，ee_trn_chained_commit関数の呼び出し回数をチェックしません。

●trn_max_commit_downmode=P|T|N　　〜《N》

コミット関数の呼び出し回数が上限値に達した場合の処理を指定します。

コミット関数とは，ee_trn_chained_commit関数のことです。上限値は，トランザクション関連定義のtrn_max_commit_countオペランドで指定します。

P

プロセスダウンします。

T

スレッドダウンします（UAPの非保護区内の場合だけ）。

N

KFSB50927-Eメッセージを出力します。

トランザクション関連定義のtrn_max_commit_countオペランドに0を指定するか，指定を省略した場合は，trn_max_commit_downmodeオペランドの指定は無効になります。

●trn_max_rollback_count=ロールバック関数の呼び出し回数上限値　　〜〈符号なし整数〉((0〜999999))《0》

トランザクション起動後にUAPをリターンするまでの，ee_trn_chained_rollback関数またはee_trn_rollback_mark関数の呼び出し回数の上限値を指定します。ee_trn_chained_rollback関数またはee_trn_rollback_mark関数の呼び出し回数が指定値に達した場合，トランザクション関連定義のtrn_max_rollback_downmodeオペランドの指定に従って処理します。

trn_max_rollback_countオペランドに0を指定するか，指定を省略した場合は，ee_trn_chained_rollback関数またはee_trn_rollback_mark関数の呼び出し回数をチェックしません。

●trn_max_rollback_downmode=P|T|N　　〜《N》

ロールバック関数の呼び出し回数が上限値に達した場合の処理を指定します。

ロールバック関数とは，ee_trn_chained_rollback関数またはee_trn_rollback_mark関数のことです。上限値は，トランザクション関連定義のtrn_max_rollback_countオペランドで指定します。

P

プロセスダウンします。

T

スレッドダウンします（UAPの非保護区内の場合だけ）。

N

KFSB50927-Eメッセージを出力します。

トランザクション関連定義のtrn_max_rollback_countオペランドに0を指定するか，指定を省略した場合は，trn_max_rollback_downmodeオペランドの指定は無効になります。

●trn_undelayed_recover_thread=Y|N　　〜《N》

プロセスダウン後のアンディレード回復処理に処理スレッドを使用するかどうかを指定します。回復スレッドだけではなく処理スレッドも使用することによって，アンディレード回復処理に掛かる時間を短縮できます。

Y

処理スレッドと回復スレッドの両方を使用してアンディレード回復を実行します。

N

回復スレッドだけを使用してアンディレード回復を実行します。

trn_undelayed_recover_threadオペランドは，trn_delayed_allrecoverオペランドにNを指定している場合だけ有効です。

●trn_rm_open_close_scope=process|transaction　　〜《process》

リソースマネジャに対して，XAインタフェースである二つの関数（xa_open関数とxa_close関数）の発行タイミングを指定します。

process

TP1/EE開始時にxa_open関数を発行し，TP1/EE終了時にxa_close関数を発行します。

transaction

トランザクション開始時にxa_open関数を発行し，トランザクション終了時にxa_close関数を発行します。

●lck_timeout_info=Y|N　　〜《Y》

排他待ちタイムアウト時にタイムアウト情報をメッセージに出力するかどうかを指定します。

Y

タイムアウト情報を出力します。

N

タイムアウト情報を出力しません。

●lck_limit_foruser=同時に発生する排他要求数の最大値　　〜〈符号なし整数〉((0〜327670))《0》

同時に発生する排他要求数の最大値を指定します。0を指定した場合，排他制御は使用できません。

●lck_wait_timeout=排他待ち限界経過時間　　〜〈符号なし整数〉((0〜327670))《0》（単位：10ミリ秒）

排他要求が待ち状態になってから解除されるまでの排他待ち時間を監視する限界経過時間を指定します。指定時間を経過しても待ち状態が解除されない場合，排他要求をエラーリターンします。

0を指定した場合は，排他待ちの時間監視をしません。

排他待ち時間は，トランザクション処理監視時間に含まれます。このため，トランザクション処理の監視時間より小さな値を指定してください。

●trn_sta_pdcwaittime=開始時のPDCWAITTIMEの変更時間　　〜〈符号なし整数〉((0〜65535))《変更なし》（単位：秒）

TP1/EE開始時のトランザクションで，HiRDBクライアント環境定義のPDCWAITTIMEの値を変更したいときに変更時間を指定します。

対象となるトランザクションは次のとおりです。

MIトランザクション

JIトランザクション

UTトランザクション（TP1/EE開始時だけ）

TP1/EE開始時に動作する内部トランザクション

●trn_onl_pdcwaittime=オンライン中のPDCWAITTIMEの変更時間　　〜〈符号なし整数〉((0〜65535))《変更なし》（単位：秒）

オンライン中のトランザクションで，trn_sta_pdcwaittimeによって変更したHiRDBクライアント環境定義のPDCWAITTIMEの値を変更したいときに変更時間を指定します。

HiRDBクライアント環境定義のPDCWAITTIMEと同じ値を指定してください。

trn_sta_pdcwaittimeの指定があるときだけ有効となります。

オンライン中にRM障害などによってリソースマネジャとのコネクションが切断した場合，変更した値は無効となり，以降のトランザクションはPDCWAITTIMEの値で動作します。

コマンド形式

次ページに記述しています。

trnstring

名称

リソースマネジャへのアクセス用の定義

形式

｛｛trnstring  -n  リソースマネジャ名
           〔-i  リソースマネジャ拡張子〔,リソースマネジャ拡張子〕…〕
           〔-o  "トランザクションサービス用xa_open関数用文字列"〕
           〔-c  "トランザクションサービス用xa_close関数用文字列"〕
           〔-O  "ユーザサービス用xa_open関数用文字列"〕
           〔-C  "ユーザサービス用xa_close関数用文字列"〕
           〔-r〕〔-x〕
                       ｝｝

機能

リソースマネジャにアクセスするための文字列または拡張子を定義します。

次の両方の条件を満たす場合は，このコマンドを定義する必要はありません。

一つのリソースマネジャに対して，複数のリソースマネジャ拡張子を割り当てて，複数の制御単位としてアクセスする必要がない場合。

xa_open関数用文字列とxa_close関数用文字列の両方がNULL文字列を通知する必要がある場合。

TP1/EEのトランザクションサービスでは，X/OpenのXAインタフェースに従い，リソースマネジャと連携してトランザクションを実行します。XAインタフェースでは，リソースマネジャが規定したxa_open関数用文字列，およびxa_close関数用文字列を通知する必要があります。

TP1/EE下のトランザクション内で，処理スレッドが，TP1/EE以外の提供するリソースマネジャにアクセスする場合（リソースマネジャ連携オブジェクトファイルをユーザサーバにリンケージした場合），そのリソースマネジャのxa_open関数用文字列，およびxa_close関数用文字列を指定します。xa_open関数，およびxa_close関数は，このコマンドで指定された文字列を引数として，処理スレッド起動，および終了時にトランザクションサービスに呼び出されます。

トランザクションサービスは，処理スレッド異常終了時またはTP1/EE再開始時に，処理スレッドが行っていたトランザクションを回復します。このとき，xa_open関数およびxa_close関数を使用するため，トランザクションサービスには処理スレッドがアクセスするすべてのリソースマネジャのxa_open関数用文字列，およびxa_close関数用文字列を定義する必要があります。

trnstring定義コマンドで指定したリソースマネジャ，およびtrnstring定義コマンドを使用しないリソースマネジャの合計が256を超えないようにしてください。257以上のリソースマネジャを指定した場合，TP1/EEはプロセスダウンします。

必要な文字列を定義しなかった場合，または不当な文字列を指定した場合は，処理スレッドの起動，終了，またはトランザクションの回復がエラーになります。

オプション

●-n　リソースマネジャ名　　〜〈1〜31文字の英数字〉

TP1/EE下のトランザクションでアクセスするリソースマネジャ名を指定します。

●-i　リソースマネジャ拡張子　　〜〈1〜2文字の識別子〉

一つのリソースマネジャを複数の制御単位としてアクセスする場合，リソースマネジャ名を「リソースマネジャ名＋リソースマネジャ拡張子」に修飾するための文字列を指定します。

複数の拡張子が同じxa_open関数用文字列，またはxa_close関数用文字列を使用する場合は，このオプションに複数の拡張子を指定できます。その場合は，拡張子と拡張子の間を「,」で区切ります。

-iオプションは，一つのリソースマネジャに複数のリソースマネジャ拡張子を割り当てて，複数の制御単位としてアクセスする場合だけ指定してください。TP1/EEは，-iオプションを指定したリソースマネジャに対して，リソースマネジャ名を「リソースマネジャ名＋リソースマネジャ拡張子」に修飾して管理します。そのため，リソースマネジャ名だけではアクセスできません。

-iオプションに指定するリソースマネジャを識別するための文字列は，すべてのtrnstring定義コマンドで重複しないように指定してください。一つの定義ファイル内に同一リソースマネジャ名で，同一リソースマネジャ拡張子のtrnstring定義コマンドを複数指定した場合，最初に指定した定義が有効になります。

●-o　"トランザクションサービス用xa_open関数用文字列"　　〜〈1〜255文字の文字列〉

TP1/EEの回復スレッドおよび監視スレッドからxa_open関数を呼び出す場合に使用する文字列を指定します。指定する文字列は，各リソースマネジャのマニュアルを参照してください。

Oracleと接続する場合に，引用識別子（引用符「"」で囲んだ識別子）を含む文字列を指定するときは，次に示すように引用符を二重に指定してください。

""ORACLE_XA+DB=MANAGERS+SqlNet=SID1+ACC=P/"scott"/"tiger"...""

NULL文字列を通知する必要がある場合は，-oオプションを省略してください。

●-c　"トランザクションサービス用xa_close関数用文字列"　　〜〈1〜255文字の文字列〉

TP1/EEの回復スレッドおよび監視スレッドからxa_close関数を呼び出す場合に使用する文字列を指定します。指定する文字列は，各リソースマネジャのマニュアルを参照してください。

Oracleと接続する場合に，引用識別子（引用符「"」で囲んだ識別子）を含む文字列を指定するときは，次に示すように引用符を二重に指定してください。

""ORACLE_XA+DB=MANAGERS+SqlNet=SID1+ACC=P/"scott"/"tiger"...""

NULL文字列を通知する必要がある場合は，-cオプションを省略してください。

●-O　"ユーザサービス用xa_open関数用文字列"　　〜〈1〜255文字の文字列〉

ユーザサービス（処理スレッド）からxa_open関数を呼び出す場合に使用する文字列を指定します。指定する文字列は，各リソースマネジャのマニュアルを参照してください。

Oracleと接続する場合に，引用識別子（引用符「"」で囲んだ識別子）を含む文字列を指定するときは，次に示すように引用符を二重に指定してください。

""ORACLE_XA+DB=MANAGERS+SqlNet=SID1+ACC=P/"scott"/"tiger"...""

NULL文字列を通知する必要がある場合は，-Oオプションを省略してください。

●-C　"ユーザサービス用xa_close関数用文字列"　　〜〈1〜255文字の文字列〉

ユーザサービス（処理スレッド）からxa_close関数を呼び出す場合に使用する文字列を指定します。指定する文字列は，各リソースマネジャのマニュアルを参照してください。

Oracleと接続する場合に，引用識別子（引用符「"」で囲んだ識別子）を含む文字列を指定するときは，次に示すように引用符を二重に指定してください。

""ORACLE_XA+DB=MANAGERS+SqlNet=SID1+ACC=P/"scott"/"tiger"...""

NULL文字列を通知する必要がある場合は，-Cオプションを省略してください。

●-r

TP1/EEの開始処理中またはオンライン処理中に，リソースマネジャから未決着トランザクション情報の通知があるまで，トランザクションの回復処理を待ち合わせます。-rオプションを指定すると，トランザクションの回復時は，リソースマネジャに対して発行するxa_recover関数が未決着トランザクション情報を取得するまで，トランザクションの回復処理は行われません。

-rオプションを指定する場合，回復スレッド数（プロセス関連定義のrecover_thread_noオペランドで指定）は，-rオプションで指定したリソースマネジャ数以上にすることをお勧めします。

●-x

一つのインスタンスのリソースマネジャに対して複数のセションを確立します。-xオプションを指定しないで，一つのインスタンスのリソースマネジャに複数のセションを確立した場合は，xa関数がエラーリターンすることがあります。

ステータスファイル関連定義

形式

set形式

〔set sts_initial_error_switch=stop|continue|force〕
〔set sts_single_operation_switch=stop|continue〕
  set sts_buffer_count=ステータスファイルをスタックするバッファ数
〔set sts_control_buffer_length=制御用ステータスファイルをスタックするバッファ長〕
〔set sts_signal_buffer_length=シグナル用ステータスファイルをスタックするバッファ長〕

コマンド形式

｛｛stsflgrp  -g  ファイルグループ番号
            〔-l  前回オンラインの現用ファイル名〕
            〔-k  A|B〕｝｝
｛｛stsflnam  -g  ファイルグループ番号
              -l  論理ファイル名
              -a  A系ステータスファイル名
              -b  B系ステータスファイル名｝｝

機能

TP1/EEで使用するステータスファイル関連情報を定義します。

説明

各オペランドについて説明します。

set形式のオペランド

●sts_initial_error_switch=stop|continue|force　　〜《stop》

TP1/EE開始時に，定義で指定したステータスファイルに次に示す異常を検知した場合の，TP1/EEの処理を指定します。

ステータスファイルの実体がない。

ステータスファイル障害を検知した。

stop

TP1/EEを停止します。stopを指定した場合，次の処理をします。

定義に指定したステータスファイルのうち，一つでも異常を検知すると，TP1/EEは停止します。異常が発生したステータスファイルの対策を実施したあと，TP1/EEを再起動してください。

前回のオンラインで現用だったステータス論理ファイルの両系に異常が発生した場合は，TP1/EEを再開始できません。

continue

TP1/EEの処理を続行します。continueを指定した場合，次の処理をします。

前回のオンラインで現用だったステータス論理ファイルの片系に障害が発生した場合，正常な系のファイルの内容を予備のA系，B系ファイルに複写します。その後，予備ファイルを現用に切り替えて，TP1/EEを開始します。複写できる予備ファイルがない場合，sts_single_operation_switchオペランドの指定に従い，TP1/EEを停止するか，続行するかを決定します。

TP1/EEの開始時，TP1/EEが現用に選択したステータスファイルが，前回のオンラインの最新現用ファイルかどうかを判断できない場合，stsflgrp定義コマンドの-lオプションで指定された前回の現用ファイル名とファイル名が一致すれば，TP1/EEを開始します。stsflgrp定義コマンドに-lオプションが指定されていない場合，または指定されたファイル名が不一致だった場合は，TP1/EEを停止します。

最新の現用ファイルかどうかを判断できない場合とは，TP1/EEの開始時に定義した論理ファイルが，一つでも次に示す状態になった場合のことです。

表8‒7　最新の現用ファイルかどうかを判断できない論理ファイルの状態

A系の状態

B系の状態

BLOCKADE

BLOCKADE

BLOCKADE

NONE

NONE

BLOCKADE

NONE

NONE

なお，sts_single_operation_switchオペランドにcontinueを指定した場合は，TP1/EEの開始時に定義した論理ファイルが，一つでも次に示す状態になった場合にも，最新の現用ファイルかどうかを判断できません。

表8‒8　最新の現用ファイルかどうかを判断できない論理ファイルの状態（sts_single_operation_switchオペランドのcontinue指定時）

A系の状態

B系の状態

OPEN

OPEN以外

OPEN以外

OPEN

sts_single_operation_switchオペランドでstopを指定，または指定を省略した場合，一方の系が異常でもう一方の系が初期化状態の論理ファイルは，現用決定対象ファイルから除き，現用ファイル決定処理をします。

A系にもB系にも正常なステータス論理ファイルが一つもない場合，TP1/EEは停止します。

force

片系障害時，TP1/EEの処理を強制的に続行します。forceを指定した場合，次の処理をします。

前回のオンラインで現用だったステータス論理ファイルの片系に異常が発生すると，正常な系のファイルの内容を予備のA系，B系ファイルに複写します。その後，予備ファイルを現用に切り替えて，TP1/EEを開始します。複写できる予備ファイルがない場合，正常な系だけでTP1/EEの処理を続行します。

TP1/EEの開始時に定義した論理ファイルにオープンできなかったファイルがある場合，オープンできたファイルの中から最新の現用ファイルを決定します。

A系，B系の片方または両方が正常なステータス論理ファイルが一つもない場合，TP1/EEは停止します。

sts_single_operation_switchオペランドでcontinueを指定した場合だけ，forceを指定できます。forceを指定した場合，stsflgrp定義コマンドの-lオプションおよび-kオプションは無効になります。

forceと指定すると，片系運転中にTP1/EEが異常終了した場合に定義を変更することなく再開始できます。しかし，再開始時に前回の現用ファイルがオープンできなかった場合，現用ファイルを正しく決定できません。A系，B系が同じディスクにある構成の場合，ディスクに障害が発生すると，A系，B系の両方がオープンできなくなり，正常に再開始できません。forceを指定する場合は，再開始時の現用ファイルの決定が不正になるのを防ぐため，A系，B系が別のディスクになる構成にしてください。

TP1/EE開始前に，前回のオンライン時に現用だった論理ファイルの片系をeestsinitコマンドを実行して初期化した場合，現用ファイルを正しく決定できなくなるので，注意してください。

sts_initial_error_switchオペランドは，TP1/EEを強制正常開始（eesvstartコマンドの-aオプションにNを指定して実行）する場合は無効です。強制正常開始時は，A系，B系の両方ともオープンできたファイルが一つでもあれば，それを現用として処理を開始します。A系，B系ともオープンできたファイルが一つもない場合は，TP1/EEは停止します。

●sts_single_operation_switch=stop|continue　　〜《stop》

TP1/EEの開始中，または開始後に，現用ステータスファイルの片系に入出力障害が発生した場合，スワップできる両系がそろった論理ファイルが存在しないときのTP1/EEの処理を指定します。

stop

TP1/EEを停止します。

continue

現用ステータスファイルの正常な系だけでTP1/EEの処理を続行します。

片系運転状態になると，エラーメッセージが出力されます。片系運転中に次のような障害が発生すると，TP1/EEを再開始できなくなります。そのため，片系運転状態になった場合は，すぐに障害対策してください。

片系運転中に，正常な系に障害が発生した場合。

片系運転中で，ファイルを更新する場合に，システムダウンが発生したとき。

このオペランドは，シグナル用ステータスファイルには無効です。

●sts_buffer_count=ステータスファイルをスタックするバッファ数　　〜〈符号なし整数〉((32〜4194304))

一つのステータスファイルグループで使用する，ステータスファイルをスタックするバッファ数を指定します。

このオペランドは，シグナル用ステータスファイルには無効です。

このオペランドは省略できません。必ず指定してください。

●sts_control_buffer_length=制御用ステータスファイルをスタックするバッファ長　　〜〈符号なし整数〉((512〜32768))《4608》（単位：バイト）

制御用ステータスファイルをスタックするバッファ長を指定します。

sts_control_buffer_lengthオペランドの指定値は，eestsinitコマンドの-sオプションの指定値と同じ値を指定してください。

●sts_signal_buffer_length=シグナル用ステータスファイルをスタックするバッファ長　　〜〈符号なし整数〉((512〜32768))《4608》（単位：バイト）

シグナル用ステータスファイルをスタックするバッファ長を指定します。

sts_signal_buffer_lengthオペランドの指定値は，eestsinitコマンドの-sオプションの指定値と同じ値を指定してください。

コマンド形式

次ページ以降に記述しています。

stsflgrp

名称

ステータスファイルのファイルグループの定義

形式

｛｛stsflgrp  -g  ファイルグループ番号
            〔-l  前回オンラインの現用ファイル名〕
            〔-k  A|B〕
               ｝｝

機能

ステータスファイルのファイルグループ番号と属性を定義します。

stsflgrp定義コマンドは，ステータスファイル関連定義内に最低2個，最大17個指定できます。

stsflgrp定義コマンドの-lオプションおよび-kオプションの指定は，sts_initial_error_switchオペランドおよびsts_single_operation_switchオペランドの指定によっては無効になります。stsflgrp定義コマンドの-lオプションおよび-kオプションと，sts_initial_error_switchオペランドおよびsts_single_operation_switchオペランドとの関係を次に示します。

表8‒9　stsflgrp定義コマンドの-lオプションおよび-kオプションと，sts_initial_error_switchオペランドおよびsts_single_operation_switchオペランドとの関係

制御用ステータスファイル

シグナル用ステータスファイル

sts_initial_error_switchオペランドの指定

stop

continue

force

force以外

force

sts_single_operation_switchオペランドの指定

stop

continue

stop

continue

continue

−

−

stsflgrp定義コマンドの-lオプション

−

−

○

○

−

−

−

stsflgrp定義コマンドの-kオプション

−

−

−

○

−

○

−

（凡例）

○：有効

−：無効

オプション

●-g　ファイルグループ番号　　〜〈符号なし整数〉((0〜16))

ステータスファイルのファイルグループ番号を指定します。

制御用ステータスファイルグループとシグナル用ステータスファイルグループを指定する必要があります。シグナル用ステータスファイルグループは0を，制御用ステータスファイルグループは1から16までを昇順に連番になるよう指定します。0と1は必ず指定してください。

●-l　前回オンラインの現用ファイル名　　〜〈1〜8文字の識別子〉

前回までのオンラインで最新の現用ファイルだった制御用ステータスファイルの論理ファイル名を指定します。シグナル用ステータスファイルの場合は指定しても無効になります。

-lオプションは，sts_initial_error_switchオペランドにcontinueの指定があり，TP1/EEが選択した現用ファイルが前回までのオンラインで最新の現用ファイルかどうかを判断できない場合だけ，有効になります。

-lオプションは，次のように指定してください。

現用ファイルが変更されるたびに値を修正できる場合

すべてのステータスファイルの初期化直後にTP1/EEを開始したときは，ファイルグループ内で最初にstsflnam定義コマンドに指定した論理ファイル名を指定してください。そのあと，現用ファイルがスワップによって変更された場合は，-lオプションの指定を新しい現用ファイル名に変更してください。

現用ファイルが変更されても値を修正できない場合

システムを開始した場合に，エラーメッセージが出力されシステム起動エラーとなったときは，前回のオンラインの最新現用ファイルを，ログファイルを基に調査します。エラーメッセージで出力された論理ファイル名と一致する場合は，その論理ファイル名を-lオプションに指定し，TP1/EEを再開始してください。

●-k　A|B

前回のオンライン時，制御用の現用ステータスファイルの片系に障害が発生して閉塞状態になった場合，正常だった系を指定します。

A

前回正常だった系がA系の場合に指定します。

B

前回正常だった系がB系の場合に指定します。

-kオプションは，TP1/EE再開始時に，前回のオンライン中に障害が発生した系を現用に選択して誤動作するのを防ぐために指定します。片系に障害が発生して閉塞状態になったままオンラインが終了した場合は，必ず指定してください。

-kオプションは，制御用ステータスファイルの場合，sts_single_operation_switchオペランドにcontinueを指定し，sts_initial_error_switchオペランドにcontinueを指定した場合だけ有効になります。シグナル用ステータスファイルの場合，sts_initial_error_switchオペランドにforceを指定した場合は無効になります。

-kオプションを指定した場合，次の処理をします。

TP1/EE開始時にステータスファイルの両系で障害を検知しなかった場合，-kオプションに指定された系のファイルの内容を，もう一方の系のファイルに複写します。

TP1/EE開始時に制御用ステータスファイルの現用ステータスファイル，またはシグナル用ステータスファイルの片系の障害を検知した場合で，-kオプションの指定がない，または-kオプションに指定した系が障害を検知した系だった場合，TP1/EEは停止します。

stsflnam

名称

ステータスファイルの名称の指定

形式

｛｛stsflnam  -g ファイルグループ番号
              -l 論理ファイル名
              -a A系ステータスファイル名
              -b B系ステータスファイル名｝｝

機能

ステータスファイルグループを構成するファイルの名称を指定します。

ステータスファイルは，信頼性を高めるためにA系，B系の二重構成で管理します。現用のステータスファイルには，A系，B系で同じ内容が書き込まれます。

A系およびB系の物理ファイルは，複数のディスクに分散して作成してください。一つのディスク上に同じ系のすべての物理ファイルを作成すると，ディスクの全面障害が発生した場合，該当する系を使用できません。例えば，一つのディスク上に同じ系の物理ファイルを作成した場合，ディスク障害発生時にA系，B系の両方に書き込める世代がなくなるため，TP1/EEを停止するか，または片系運転状態になります。

なお，制御用ステータスファイルを構成するすべてのA系ステータスファイルおよびB系ステータスファイルには，sts_control_buffer_lengthオペランドに指定したレコード長と同じレコード長のファイルを指定してください。シグナル用ステータスファイルを構成するA系ステータスファイルおよびB系ステータスファイルには，sts_signal_buffer_lengthオペランドに指定したバッファ長と同じレコード長のファイルを指定してください。また，同じファイルグループを構成するすべてのA系ステータスファイルおよびB系ステータスファイルには，同じレコード数のファイルを指定してください。

論理ファイル名には，同じファイル名を指定できません。また，A系，B系のステータスファイル名に同じパス名を指定できません。絶対パス名が異なっていても，同じファイル名を指定できません。

ステータスファイルには，制御用ステータスファイルおよびシグナル用ステータスファイルの二種類があります。それぞれを指定する場合について次に説明します。

制御用ステータスファイルの場合

stsflnam定義コマンドは，一つのファイルグループに対して3個〜7個指定できます。

TP1/EEの正常開始時に，ステータスファイル関連定義で最初に指定したステータスファイルが現用ファイルになります。残りのステータスファイルは予備ファイルになります。ただし，前回オンラインで使用したステータスファイル（現用ファイル）がある場合は，このファイルを現用ファイルにします。再開始時には，前回の現用ファイルを引き継ぎます。

複数のファイルグループを使用する場合は，グループごとにディスクを分けて作成してください。同じディスクに作成すると，性能向上が図れません。

ステータスファイルに障害が発生した場合，TP1/EEを停止させないために，ステータスファイルをスワップします。ステータスファイルをスワップするには，現用ファイルのほかに，予備用のステータスファイルを指定する必要があります。

シグナル用ステータスファイルの場合

stsflnam定義コマンドは，1個だけ指定できます。

シグナル用ステータスファイルに障害が発生した場合，片系障害のときは，ステータスファイルの正常な系だけでTP1/EEの処理を続行し，両系障害のときは，TP1/EEを停止します。

オプション

●-g　ファイルグループ番号　　〜〈符号なし整数〉((0〜16))

ステータスファイルのファイルグループ番号を指定します。ファイルグループ番号は，あらかじめstsflgrp定義コマンドで指定しておいてください。

●-l　論理ファイル名　　〜〈1〜8文字の識別子〉

ステータスファイルの論理ファイル名を指定します。

●-a　A系ステータスファイル名　　〜〈パス名〉〈510文字以内のパス名〉

論理ファイルを構成するA系のステータスファイル名を絶対パス名で指定します。ただし，環境変数は使用できません。

パス名中の物理ファイル名は，14文字以内にしてください。

●-b　B系ステータスファイル名　　〜〈パス名〉〈510文字以内のパス名〉

論理ファイルを構成するB系のステータスファイル名を絶対パス名で指定します。ただし，環境変数は使用できません。

パス名中の物理ファイル名は，14文字以内にしてください。

DBキュー機能関連定義

形式

set形式

〔set dbq_rollback_retry_count=連続ロールバック監視回数〕
〔set dbq_reqbuf_retry_timer=バッファ空き待ち監視時間〕
〔set dbq_readcheckmsg_interval=DBキュー読み出しサーバ監視メッセージ出力間隔〕
〔set dbq_endcheckmsg_interval=TP1/EE終了時未読み出し監視メッセージ出力間隔〕
〔set dbq_endcheck_mode=NO｜UAP〕
〔set dbq_uap_stop=no｜start｜restart｜all〕
〔set dbq_read_error_uap_stop=DBキューを読み出し停止にする障害ケース〕
〔set dbq_inhibit_use=Y｜N〕

コマンド形式

｛｛dbqdef  -q DBキュー名
            -d DBキューグループ名
          〔-l 最大書き込みメッセージ数〕
            -n リソースマネジャ名
          〔-i リソースマネジャ拡張子〕
          〔-t no｜start｜restart｜all〕
                  ｝｝

｛｛dbqgrpdef  -d DBキューグループ名
             〔-p 関連づけるDBキューサービスグループ名〕
               -k 0|1
           ｛〔-e 関連づけるサービスグループ名〕
             〔-t〕 | 〔-f 関連づける他サーバのプロセス識別子〕｝
             〔-o my|other〕
             〔-c〕
             〔-u uap|user〕
             〔-s stop|skip〕
                  ｝｝

｛｛dbqsrvdef  -v DBキューサービス名
               -p 関連づけるDBキューサービスグループ名
             〔-q DBキュー名，DBキュー名…〕
             〔-n DBキューサービスで使用するDBキューの最大数〕
             〔-t DBキューサービスを同時に起動させるトランザクションの最大数〕
             〔-c R|P〕
                  ｝｝
｛｛dbqsvgdef  -p DBキューサービスグループ名
               -d DBキューグループ名
                  ｝｝
｛｛dbqprcdef  -f  関連づける他サーバのプロセス識別子
               -h  ホスト名:ポート番号〔:自ホスト名〕
             〔-b〕
                  ｝｝

コマンド形式の定義は，DBキュー機能を使用してAP間通信をする場合と，ユーザキューアクセスをする場合とで指定できる定義が異なります。指定できる定義コマンドの違いを，次の表に示します。

表8‒10　指定できる定義コマンドの違い

定義コマンド

メッセージ送受信方式

AP間通信

ユーザキューアクセス

dbqdef

必須

必須

dbqgrpdef

必須

必須

dbqsrvdef

省略可

指定不可

dbqsvgdef

省略可

指定不可

dbqprcdef

省略可

指定不可

機能

DBキュー機能関連情報を定義します。

説明

各オペランドについて説明します。

set形式のオペランド

●dbq_rollback_retry_count=連続ロールバック監視回数　　〜((-1〜10))《5》

同一メッセージ処理のロールバック監視回数を指定します。ロールバック監視回数は，APIからのロールバック要求の回数をカウントします。ロールバック要求の回数が，dbq_rollback_retry_countオペランドの指定値を超えた場合，dbqgrpdef定義コマンドの-sオプションの指定に従って該当するDBキューのスケジュールを停止，またはメッセージをスキップして次のメッセージの読み出しをします。

-1を指定した場合，最初のロールバック要求でdbqgrpdef定義コマンドの-sオプションの指定に従った処理をします。

0を指定した場合，ロールバック回数を監視しません。

●dbq_reqbuf_retry_timer=バッファ空き待ち監視時間　　〜〈符号なし整数〉((0〜100))《1》（単位：100ミリ秒）

DBキュー機能で使用するバッファの空き処理キュー登録時，処理キューの確保待ち時間を指定します。

●dbq_readcheckmsg_interval=DBキュー読み出しサーバ監視メッセージ出力間隔　　〜〈符号なし整数〉((0，10〜3600))《180》（単位：秒）

DBキュー機能関連定義のdbqgrpdef定義コマンドの-kオプションに1を指定し，-oオプションにmyを指定したDBキューからメッセージを読み出すサーバが存在しない場合の，KFSB45612-Wメッセージを出力する間隔を指定します。

0を指定した場合，メッセージを出力しません。

●dbq_endcheckmsg_interval=TP1/EE終了時未読み出し監視メッセージ出力間隔　　〜〈符号なし整数〉((0〜3600))《180》（単位：秒）

TP1/EEの正常終了時に，DBキューに未読み出しメッセージが存在する場合のメッセージを出力する間隔を指定します。

0を指定した場合，未読み出しメッセージ検知時に1回だけメッセージを出力します。

dbq_endcheckmsg_intervalオペランドの指定値と実際のメッセージ出力間隔は，最大5秒の誤差が発生します。dbq_endcheckmsg_intervalオペランドの指定値とメッセージ出力間隔の関係を次に示します。

プロセス終了監視トランザクション起動間隔＜dbq_endcheckmsg_intervalオペランドの指定値＜メッセージ出力間隔

●dbq_endcheck_mode=NO｜UAP　　〜《UAP》

TP1/EE正常終了時にDBキューに未読み出しメッセージが存在する場合，未読み出しメッセージがなくなるまでDBキューをチェックするかどうかを指定します。

NO

未読み出しメッセージがあってもTP1/EEを終了します。

UAP

AP間通信をするDBキューに未読み出しメッセージがある場合，TP1/EEを終了しません。

●dbq_uap_stop=no｜start｜restart｜all　　〜《no》

AP間通信をするすべての自サーバ読み出しのDBキューを，一括で読み出し停止にさせるTP1/EEの開始モードを指定します。dbqdef定義コマンドの-tオプションを同時に指定した場合は，dbqdef定義コマンドの-tオプションが有効になります。

no

正常開始時に読み出し停止にしません。再開始時に前回のオンライン処理時の状態で開始します。

start

正常開始時に読み出し停止にします。再開始時に前回のオンライン処理時の状態で開始します。

restart

正常開始時に読み出し停止にしません。再開始時に読み出し停止にします。

all

正常開始時，および再開始時に読み出し停止にします。

注意事項

AP間通信をするDBキューのメッセージ読み出しトランザクションが原因でオンラインが停止した場合に再開始処理をすると，プロセス回復時に定義の指定内容に関係なく，該当するDBキューが読み出し停止になります。

●dbq_read_error_uap_stop=DBキューを読み出し停止にする障害ケース　　〜〈符号なし整数〉((1，2))《1》

AP間通信をするDBキューのメッセージ読み出しトランザクションで，DBキューを読み出し停止にする障害ケースを指定します。

1

次の障害発生時に，該当するDBキューを読み出し停止にします。

メッセージ読み出しSQLエラー

メッセージ読み出し通番の更新SQLエラー

サービス関数障害でスレッドダウン※

注※

連鎖モードのロールバック要求関数を発行し，スレッドの強制終了（EETRN_KILLまたはEETRN_ABRT）を指定した場合は含みません。この場合は，dbq_read_error_uap_stopオペランドの指定内容に影響されません。dbq_rollback_retry_countオペランドの指定で読み出し停止にできます。

2

次の障害発生時に，該当するDBキューを読み出し停止にします。

指定値1で示す障害

サービス関数終了時の同期点処理障害

次の関数による同期点処理障害

ee_trn_chained_commit

ee_trn_chained_rollback（thkindにEETRN_KEEPを設定）

CBLEETRN('C-COMMIT')

CBLEETRN('C-ROLL ')（データ名Cに'KEEP'を設定）

●dbq_inhibit_use=Y｜N　　〜《N》

DBキュー書き込みで障害が発生したとき，または書き込み抑止を検知したときにDBキュー書き込み状態を書き込み禁止状態にするかどうかを指定します。このオペランドにYを指定すると，eedbqinhibitコマンドによる書き込み禁止状態の変更ができます。このオペランドにYを指定する場合には，dbqgrpdef定義コマンドの-kオプションに1を指定する必要があります。

Y

DBキュー書き込み状態を書き込み禁止にします。コマンドによる書き込み禁止状態の変更が可能となります。

N

DBキュー書き込み状態を書き込み禁止にしません。

コマンド形式

次ページ以降に記述しています。

dbqdef

名称

DBキューの実行環境の定義

形式

｛｛dbqdef  -q  DBキュー名
            -d  DBキューグループ名
          〔-l  最大書き込みメッセージ数〕
            -n  リソースマネジャ名
          〔-i  リソースマネジャ拡張子〕
          〔-t  no｜start｜restart｜all〕
                 ｝｝

機能

DBキュー機能を使用するための実行環境を定義します。dbqdef定義コマンドは，DBキュー単位に指定してください。dbqdef定義コマンドは，32000個まで指定できます。

dbqdef定義コマンドを指定する場合，DBキュー名を降順に指定することをお勧めします。該当するDBキュー名の検索を高速化するため，初期化処理でdbqdef定義コマンドに指定されたDBキュー名を昇順にソートします。そのため，DBキュー名を降順に指定すると初期化処理時間を削減でき，プロセス再開始時間を短縮できます。昇順またはランダムに指定すると，初期化処理に時間が掛かります。

オプション

●-q　DBキュー名　　〜〈1〜27文字の英大識別子〉

DBキュー名を指定します。

DBキュー機能で使用するDBキューは，三つの表で構成されます。表の名称には，DBキュー名の後ろにWT，RD，またはMGが付加されます。-qオプションには，DBキュー表の名称からWT，RD，またはMGを除いたDBキュー名を指定します。

●-d　DBキューグループ名　　〜〈1〜31文字の識別子〉

該当するDBキューと関連づけるDBキューグループ名を指定します。

●-l　最大書き込みメッセージ数　　〜〈符号なし整数〉((1〜2147483647))《1000》

DBキューに書き込む最大メッセージ数を指定します。

●-n　リソースマネジャ名　　〜〈1〜31文字の英数字〉

DBキュー機能で使用するリソースマネジャ名を指定します。

trnstring定義コマンドで指定したリソースマネジャ名を指定してください。

●-i　リソースマネジャ拡張子　　〜〈1〜2文字の識別子〉

DBキュー機能で使用するリソースマネジャ拡張子を指定します。

trnstring定義コマンドで指定したリソースマネジャ拡張子を指定してください。-iオプションは省略できます。指定する場合は，一つだけ指定できます。

●-t　no｜start｜restart｜all　　〜《start》

該当するDBキューを読み出し停止とするTP1/EEの開始モードを指定します。-tオプションを省略した場合は，dbq_uap_stopオペランドの指定値に従います。eedbqrstコマンドまたはee_dbq_acsctl関数で読み出し停止状態を解除できます。なお，ユーザキューアクセス機能を使用するDBキューに-tオプションを指定した場合は，TP1/EE起動時に定義不正でエラーになります。

-tオプションは，自サーバ読み出しのDBキューの場合に有効になります。自サーバ読み出しの決定は，正常開始の場合はdbqgrpdef定義コマンドの-oオプションに従い，再開始の場合は前回終了時のDBキューの読み出し先サーバのステータスに従います。読み出し先サーバ変更機能を使用する場合，再開始を考慮して指定してください。

no

正常開始時に読み出し停止にしません。再開始時に前回のオンライン処理時の状態で開始します。

start

正常開始時に読み出し停止にします。再開始時に前回のオンライン処理時の状態で開始します。

restart

正常開始時に読み出し停止にしません。再開始時に読み出し停止にします。

all

正常開始時，および再開始時に読み出し停止にします。

注意事項

AP間通信をするDBキューのメッセージ読み出しトランザクションが原因でオンラインが停止した場合に再開始処理をすると，プロセス回復時に定義の指定内容に関係なく，該当するDBキューが読み出し停止になります。

dbqgrpdef

名称

DBキューのグループ名の定義

形式

｛｛dbqgrpdef  -d DBキューグループ名
             〔-p 関連づけるDBキューサービスグループ名〕
               -k 0|1
           ｛〔-e 関連づけるサービスグループ名〕
             〔-t〕 | 〔-f 関連づける他サーバのプロセス識別子〕｝
             〔-o my|other〕
             〔-c〕
             〔-u uap|user〕
             〔-s stop|skip〕
                  ｝｝

dbqgrpdef定義コマンドは，DBキュー機能を使用してAP間通信をするDBキューと，ユーザキューアクセスをするDBキューとで指定できるオプションが異なります。指定するオプションの違いを，次の表に示します。

表8‒11　指定できるオプションの違い

オプション

メッセージ送受信方式

AP間通信

ユーザキューアクセス

-kに0を指定

-kに1を指定

-d

必須

必須

必須

-p

省略可

省略可

指定不可

-k

0（省略可）

1

1（必須）

-e

省略可

指定不可

指定不可

-t

省略可

指定不可

指定不可

-f

省略可

指定不可

指定不可

-o

指定不可

省略可

省略可

-c

指定不可

省略可

省略可

-u

省略可

省略可

必須

-s

省略可

省略可

指定不可

機能

DBキューのグループ名を定義します。また，DBキューグループ定義とサービスグループ定義とを関連づけます。dbqgrpdef定義コマンドは，1000個まで指定できます。

dbqgrpdef定義コマンドの-eオプションまたは-fオプションの指定値は，次に示す表に従って，サービスグループ情報関連定義のeesvgdef定義コマンドまたはDBキュー機能関連定義のdbqprcdef定義コマンドの指定値と合わせる必要があります。

表8‒12　dbqgrpdef定義コマンドと，eesvgdef定義コマンドまたはdbqprcdef定義コマンドとの関係

dbqgrpdef定義コマンドの指定値

eesvgdef定義コマンドまたはdbqprcdef定義コマンドの指定値

-eオプションの指定値

-tオプションを指定しない場合

-tオプションにRPCを指定または省略したeesvgdef定義コマンドの-gオプションの指定値と合わせてください。

-tオプションを指定した場合

-tオプションにDBQを指定したeesvgdef定義コマンドの-gオプションの指定値と合わせてください。

-fオプションの指定値

dbqprcdef定義コマンドの-fオプションの指定値と合わせてください。

オプション

●-d　DBキューグループ名　　〜〈1〜31文字の識別子〉

DBキューグループ名を指定します。TP1/EEシステム内で一意になるように指定してください。

●-p　関連づけるDBキューサービスグループ名　　〜〈1〜31文字の識別子〉

DBキューサービスグループ名を指定します。

AP間通信をするDBキューに次のオプションを指定した場合，-pオプションを指定してください。

-cオプション

-oオプションにmyを指定

AP間通信をするDBキューに次のオプションを指定した場合，-pオプションは指定しないでください。

-eオプション

-fオプション

ユーザキューアクセスをするDBキューには，-pオプションは指定しないでください。

●-k　0|1　　〜《0》

-dオプションで指定したDBキューグループのDBキュー機能オプションを指定します。

0

DBキュー機能オプションをTYPE0にします。

1

DBキュー機能オプションをTYPE1にします。ユーザキューアクセスをする場合は，1を指定してください。

-kオプションに1を指定した場合，RPC関連定義のrpc_tcpsend_con_max_cntオペランド，rpc_tcpsend_con_cntオペランド，およびrpc_tcpsend_proc_max_cntオペランドを必ず指定してください。dbq_inhibit_useにYを指定した場合，-kオプションには1を指定してください。dbq_inhibit_useにYを指定して-kオプションを省略または0を指定した場合，KFSB65606-E メッセージ（理由コード：5）を出力し，TP1/EEの起動が失敗します。

●-e　関連づけるサービスグループ名　　〜〈1〜31文字の識別子〉

-kオプションに0を指定または省略時に，該当するDBキューから他サーバでメッセージを読み出す場合，サービスグループ情報関連定義のeesvgdef定義コマンドの-gオプションで指定したサービスグループ名を指定します。

-eオプションと-fオプションの両方を省略した場合，DBキューから自サーバでメッセージを読み出します。

-kオプションに1を指定した場合は，-eオプションを指定しないでください。

●-t

eesvgdef定義コマンドで他サーバを指定したDBキューのイベント通知を，TCP/IP通信で行います。-tオプションは，サービスグループ情報関連定義のeesvgdef定義コマンドの-tオプションにDBQを指定した場合に有効です。

●-f　関連づける他サーバのプロセス識別子　　〜〈1〜31文字の識別子〉

-kオプションに0を指定または省略時に，該当するDBキューから他サーバでメッセージを読み出す場合，DBキュー機能関連定義のdbqprcdef定義コマンドの-fオプションで指定した他サーバのプロセス識別子を指定します。

-eオプションと-fオプションの両方を省略した場合，DBキューから自サーバでメッセージを読み出します。

-fオプションを指定した場合，RPC関連定義のrpc_tcpsend_con_max_cntオペランド，rpc_tcpsend_con_cntオペランド，およびrpc_tcpsend_proc_max_cntオペランドを必ず指定してください。

-kオプションに1を指定した場合は，-fオプションを指定しないでください。

●-o　my|other

-kオプションに1を指定した場合，TP1/EEの開始時に，-dオプションで指定したDBキューグループのDBキューからメッセージを読み出すサーバを指定します。複数のTP1/EEで同一のDBキューを指定する場合は，一つのTP1/EEにmyを指定し，ほかのTP1/EEではotherを指定することを推奨します。複数のTP1/EEにmyを指定した場合は，後から正常開始をしたTP1/EEが読み出しサーバとなります。その際に，先に正常開始したTP1/EEのDBキューサービスはロールバックする場合があります。詳細は，「6.6.5(1)　読み出し先DBキューのステータス」を参照してください。

my

TP1/EEの開始時に，自サーバでDBキューからメッセージを読み出します。読み出し先DBキューのステータスは「自サーバ読み出し」となります。

other

TP1/EEの開始時に，他サーバでDBキューからメッセージを読み出します。読み出し先DBキューのステータスは「他サーバ読み出し」となります。

-oオプションを省略し，-kオプションに1を指定した場合は，myが仮定されます。

1つのdbqgrpdefに対して，-o myを指定または省略するTP1/EEは1つとなるように設定してください。

複数のTP1/EEで-o myを指定または省略した場合は，各TP1/EEが開始時に読み出し先DBキューのステータスを決定します。

TP1/EEが正常開始する場合は，最初に開始したTP1/EEのステータスが「自サーバ読み出し」となったあとに，順次起動した順番で「自サーバ読み出し」となるサーバが切り替わります。最後に起動したTP1/EEが「自サーバ読み出し」となります。

TP1/EE読み出し先DBキューのステータスの詳細は，「6.6.5(2)　TP1/EEの開始モードと読み出し先DBキューのステータスの遷移」を参照してください。

●-c

-dオプションで指定したDBキューグループで，DBキュー読み出しサーバ変更機能を使用する場合に指定します。-kオプションに1を指定した場合に，-cオプションは指定できます。

-cオプションを省略した場合は，DBキュー読み出しサーバ変更機能を使用しません。

●-u　uap｜user　　〜《uap》

該当するDBキューグループのDBキューでAP間通信，またはユーザキューアクセスの，どちらのメッセージ送受信方式かを指定します。

uap

AP間通信をします。

user

ユーザキューアクセスをします。

●-s　stop｜skip　　〜《stop》

次の要因でDBキューの読み出しトランザクションがロールバックした場合の動作を指定します。

ee_trn_chained_rollback関数（thkind引数にEETRN_KILLまたはEETRN_ABRTを設定）

CBLEETRN('C-ROLL ')（データ名Cに'KILL'または'ABRT'を設定）

ee_trn_rollback_mark関数

CBLEETRN('ROLLMARK')

サービス関数実行中にスレッドダウン

stop

読み出しを停止します。

skip

メッセージをスキップして次のメッセージを読み出します。

ただし，-oオプションにotherを指定し，かつ-cオプションを省略した場合は，このオプションを指定しても無効になります。

dbqsrvdef

名称

DBキューサービスの定義

形式

｛｛dbqsrvdef  -v DBキューサービス名
               -p 関連づけるDBキューサービスグループ名
             〔-q DBキュー名，DBキュー名…〕
             〔-n DBキューサービスで使用するDBキューの最大数〕
             〔-t DBキューサービスを同時に起動させるトランザクションの最大数〕
             〔-c R|P〕
                 ｝｝

機能

DBキューのサービスを定義します。DBキューサービスは，DBキューからメッセージを読み出して起動します。DBキュー名は複数指定できます。dbqsrvdef定義コマンドは，31999個まで指定できます。

dbqsrvdef定義コマンドに指定するDBキューサービス名は，降順に指定することをお勧めします。該当するDBキューサービス名の検索を高速化するために，初期化処理では，dbqsrvdef定義コマンドに記述されたDBキューサービス名を昇順にソートします。そのため，dbqsrvdef定義コマンドに指定するDBキューサービス名を降順に指定すると，初期化処理時間を削減でき，プロセス再開始時間を短縮できます。昇順またはランダムに記述すると，初期化処理に時間が掛かります。

オプション

●-v　DBキューサービス名　　〜〈1〜31文字の識別子〉

DBキューサービス名を指定します。ユーザサービス関連定義のdbq_serviceオペランドで指定したサービス名を指定してください。

●-p　関連づけるDBキューサービスグループ名　　〜〈1〜31文字の識別子〉

DBキューサービスと関連づけるDBキューのサービスグループ名を指定します。

●-q　DBキュー名　　〜〈1〜27文字の英大識別子〉

DBキューサービスと関連づけるDBキュー名を指定します。DBキュー名の最大数は，-nオプションの指定値以内です。

DBキューグループを指定してメッセージを書き込む場合，同一DBキューグループのDBキューを指定することをお勧めします。

-qオプションに指定できるのは，次に示すDBキューです。

DBキュー読み出しサーバ変更機能を使用していないDBキューグループで，-eオプションおよび-fオプションを指定していないDBキューグループのDBキュー

DBキュー読み出しサーバ変更機能を使用しているDBキューグループのDBキュー

●-n　DBキューサービスで使用するDBキューの最大数　　〜〈符号なし整数〉((1〜64))《20》

該当するDBキューサービスで使用するDBキューの最大数を指定します。

●-t　DBキューサービスを同時に起動させるトランザクションの最大数　　〜〈符号なし整数〉((1〜64))《1》

該当するDBキューサービスを同時に起動させるトランザクションの最大数を指定します。

-nオプションの指定値以上の値を指定しても，-nオプションの指定値と同じ値になります。

●-c　R|P　　〜《R》

該当するDBキューサービスのスケジュール方式を指定します。

R

均等スケジュール方式（ラウンドロビン）

-qオプションに指定した順番に，DBキューから，1メッセージずつ読み出す方式です。

P

優先スケジュール方式

-qオプションで最初に指定されたDBキューから毎回読み出す方式です。-qオプションで最初に指定されたDBキューにメッセージがない場合，2番目以降に指定されたDBキューから，1メッセージずつ読み出します。

dbqsvgdef

名称

DBキューのサービスグループの定義

形式

｛｛dbqsvgdef  -p  DBキューサービスグループ名
               -d  DBキューグループ名
                  ｝｝

機能

DBキューのサービスグループを定義します。dbqgrpdef定義コマンドで指定したサービスグループ名と関連づけます。dbqsvgdef定義コマンドは，1000個まで指定できます。

オプション

●-p　DBキューサービスグループ名　　〜〈1〜31文字の識別子〉

DBキューのサービスグループ名を指定します。

●-d　DBキューグループ名　　〜〈1〜31文字の識別子〉

関連するDBキューグループ名を指定します。dbqgrpdef定義コマンドの-uオプションにuserを指定したDBキューグループ名は指定できません。

dbqprcdef

名称

他サーバのプロセス情報の定義

形式

｛｛dbqprcdef  -f  関連づける他サーバのプロセス識別子
               -h  ホスト名:ポート番号〔:自ホスト名〕
             〔-b〕
                  ｝｝

機能

DBキューを使用した他システムとのAP間通信をする場合，イベント通知の送信先サーバのホスト名，ポート番号などを指定します。dbqprcdef定義コマンドは，RPC関連定義のrpc_tcpsend_proc_max_cntオペランドに指定した数まで指定できます。

オプション

●-f　関連づける他サーバのプロセス識別子　　〜〈1〜31文字の識別子〉

イベント通知の送信先サーバのプロセス識別子を指定します。

-fオプションは，dbqgrpdef定義コマンドの-fオプションと関連づけるために指定します。このため，TP1/EEシステム間で一意になるように指定する必要はありません。

●-h　ホスト名:ポート番号〔:自ホスト名〕

ホスト名　　〜〈1〜255文字のホスト名〉

イベント通知の送信先サーバのホスト名を指定します。ホスト名は，/etc/hostsファイルまたはDNSなどで，IPアドレスとマッピングできるように指定する必要があります。

ポート番号　　〜〈符号なし整数〉((1〜65535))

イベント通知の送信先サーバのポート番号を指定します。

自ホスト名　　〜〈1〜255文字のホスト名〉

使用するネットワークアダプタを自システムのホスト名として指定します。

自ホスト名は，/etc/hostsファイルに登録されている必要があります。

自ホスト名は，-bオプションを指定する場合は必ず指定してください。

●-b

-hオプションで指定したホスト名（自IPアドレス）を固定する場合に指定します。

マルチホームドホスト形態でTP1/EEと自ホスト（IPアドレス）を対応づけるときに使用するネットワークアダプタを特定する必要がある場合に指定します。マルチホームドホストの場合，複数の物理ネットワークに接続しているので，複数のホスト名（IPアドレス）を持つ形態になります。2：1系切り替え構成や，相互系切り替え構成のように，IPアドレスを引き継ぐ系切り替えで，1ホスト（ノード）内に複数のOpenTP1（TP1/EEを含む）が稼働する場合は，このオプションを指定する必要があります。

オンラインバッチ機能関連定義

形式

set形式

〔set dbq_obs_lot_no=ロット管理テーブル面数〕
〔set dbq_obs_endcheckmsg_interval=TP1/EE終了時未読み出し監視メッセージ出力間隔〕
〔set dbq_obs_trn_end_api=Y|N〕

コマンド形式

｛｛dbqobsdef  -q DBキュー名
               -n リソースマネジャ名
             〔-i リソースマネジャ拡張子〕
                  ｝｝
｛｛dbqobssrvdef  -v オンラインバッチサービス名
                〔-e〕
                  ｝｝
｛｛dbqobslotdef  -o ロット名
                〔-v 起動するオンラインバッチサービス名〕
                  ｝｝

機能

オンラインバッチ機能関連情報を定義します。

説明

各オペランドについて説明します。

set形式のオペランド

●dbq_obs_lot_no=ロット管理テーブル面数　　〜〈符号なし整数〉((1〜32767))《128》

ロット管理テーブルの面数を指定します。すべてのロット数を最低基準値として，それ以上の面数を指定してください。

●dbq_obs_endcheckmsg_interval=TP1/EE終了時未読み出し監視メッセージ出力間隔　　〜〈符号なし整数〉((0〜3600))《180》（単位：秒）

TP1/EEの正常終了時に，オンラインバッチ機能で使用するDBキューに未読み出しメッセージが存在する場合のメッセージを出力する間隔を指定します。

0を指定した場合，未読み出しメッセージ検知時に1回だけメッセージを出力します。

dbq_obs_endcheckmsg_intervalオペランドの指定値と実際のメッセージ出力間隔は，最大5秒の誤差が発生します。dbq_obs_endcheckmsg_intervalオペランドの指定値とメッセージ出力間隔の関係を次に示します。

プロセス終了監視トランザクション起動間隔＜dbq_obs_endcheckmsg_intervalオペランドの指定値＜メッセージ出力間隔

●dbq_obs_trn_end_api=Y|N　　〜《N》

オンラインバッチ機能で使用するDBキューのトランザクションの決着タイミングをAPI関数による同期点取得時にするかどうかを指定します。

Y

ee_trn_chained_commit関数またはee_trn_chained_rollback関数による同期点取得時に，バッチ処理を制御するサービストランザクションを決着させます。ee_trn_chained_commit関数またはee_trn_chained_rollback関数が呼び出されなかった場合は，サービス関数の終了時に，バッチ処理を制御するサービストランザクションを決着させます。

N

バッチ処理を制御するサービストランザクションを，サービス関数の終了時に決着させます。

コマンド形式

次ページ以降に記述しています。

dbqobsdef

名称

オンラインバッチ機能の実行環境の定義

形式

｛｛dbqobsdef  -q DBキュー名
               -n リソースマネジャ名
             〔-i リソースマネジャ拡張子〕
                  ｝｝

機能

オンラインバッチ機能を使用するための実行環境を定義します。dbqobsdef定義コマンドは，DBキュー単位に指定してください。dbqobsdef定義コマンドは，32000個まで指定できます。

dbqobsdef定義コマンドを指定する場合，DBキュー名を降順に指定することをお勧めします。該当するDBキュー名の検索を高速化するため，初期化処理でdbqobsdef定義コマンドに指定されたDBキュー名を昇順にソートします。そのため，DBキュー名を降順に指定すると初期化処理時間を削減でき，プロセス再開始時間を短縮できます。昇順またはランダムに指定すると，初期化処理に時間が掛かります。

オプション

●-q　DBキュー名　　〜〈1〜27文字の英大識別子〉

DBキュー名を指定します。

オンラインバッチ機能で使用するDBキューは，三つの表で構成されます。表の名称には，DBキュー名の後ろにWT，RD，またはMGが付加されます。-qオプションには，オンラインバッチDBキュー表の名称からWT，RD，またはMGを除いたDBキュー名を指定します。

●-n　リソースマネジャ名　　〜〈1〜31文字の英数字〉

オンラインバッチ機能で使用するリソースマネジャ名を指定します。

trnstring定義コマンドで指定したリソースマネジャ名を指定してください。

●-i　リソースマネジャ拡張子　　〜〈1〜2文字の識別子〉

オンラインバッチ機能で使用するリソースマネジャ拡張子を指定します。

trnstring定義コマンドで指定したリソースマネジャ拡張子を指定してください。-iオプションは省略できます。指定する場合は，一つだけ指定できます。

dbqobssrvdef

名称

オンラインバッチサービスの定義

形式

｛｛dbqobssrvdef  -v オンラインバッチサービス名
                〔-e〕
                  ｝｝

機能

オンラインバッチ機能のサービスを定義します。オンラインバッチサービスは，DBキューからメッセージを読み出して起動します。dbqobssrvdef定義コマンドは，31999個まで指定できます。

dbqobssrvdef定義コマンドに指定するオンラインバッチサービス名は，降順に指定することをお勧めします。該当するオンラインバッチサービス名の検索を高速化するために，初期化処理では，dbqobssrvdef定義コマンドに記述されたオンラインバッチサービス名を昇順にソートします。そのため，dbqobssrvdef定義コマンドに指定するオンラインバッチサービス名を降順に指定すると，初期化処理時間を削減でき，プロセス再開始時間を短縮できます。昇順またはランダムに記述すると，初期化処理に時間が掛かります。

オプション

●-v　オンラインバッチサービス名　　〜〈1〜31文字の識別子〉

オンラインバッチサービス名を指定します。ユーザサービス関連定義のdbq_obs_serviceオペランドで指定したサービス名を指定してください。

●-e

-vオプションで指定したオンラインバッチサービスが，バッチ処理の終了時に呼び出されます。

dbqobslotdef

名称

ロットの定義

形式

｛｛dbqobslotdef  -o ロット名
                〔-v 起動するオンラインバッチサービス名〕
                  ｝｝

機能

オンラインバッチ機能で使用するロットを定義します。dbqobslotdef定義コマンドは，10000個まで指定できます。

dbqobslotdef定義コマンドに指定するロット名は，降順に指定することをお勧めします。該当するロット名の検索を高速化するために，初期化処理では，dbqobslotdef定義コマンドに記述されたロット名を昇順にソートします。そのため，dbqobslotdef定義コマンドに指定するロット名を降順に指定すると，初期化処理時間を削減でき，プロセス再開始時間を短縮できます。昇順またはランダムに記述すると，初期化処理に時間が掛かります。

オプション

●-o　ロット名　　〜〈1〜23文字の識別子〉

ロット名を指定します。

●-v　起動するオンラインバッチサービス名　　〜〈1〜31文字の識別子〉

起動するオンラインバッチサービス名を指定します。ユーザサービス関連定義のdbq_obs_serviceオペランドで指定したサービス名を指定してください。-vオプションを省略した場合，ee_dbq_obsstart関数でオンラインバッチサービス名を設定してください。

ファイルサービス関連定義

形式

set形式

〔set fil_watch_time=TP1EEファイルシステムのI/O処理監視時間〕
〔set fil_watch_timeout=down|continue〕

コマンド形式

なし。

機能

ファイルサービス関連情報を定義します。

説明

各オペランドについて説明します。

set形式のオペランド

●fil_watch_time=TP1EEファイルシステムのI/O処理監視時間　　〜〈符号なし整数〉((0〜3600))（単位：秒）

トランザクション処理での，TP1EEファイルシステムへのI/O処理（I/O処理待ちも含む）を監視する時間を指定します。監視時間が指定値を超えた場合，TP1/EEはファイルサービス関連定義のfil_watch_timeoutオペランドの指定値に従って処理します。

fil_watch_timeオペランドを指定した場合，TP1EEファイルシステムのI/O処理時間はトランザクション処理時間に含まれません。また，fil_watch_timeオペランドに0を指定した場合は，I/O処理時間を監視しません。

fil_watch_timeオペランドは，TP1EEファイルシステムのI/O処理時間をトランザクション処理時間に含めたくない場合だけ指定してください。ステータスファイルサイズが大きい（10メガバイト以上）場合は，fil_watch_timeオペランドを指定することをお勧めします。ステータスファイルに片系障害が発生したり，eestsswapコマンドを実行したりしてスワップが発生した場合に，ステータスファイルのサイズと比例してスワップ処理時間が長くなることで，トランザクション処理時間に影響を及ぼすのを防ぐためです。

fil_watch_timeオペランドの指定値は，TP1EEファイルシステムがあるディスクの性能，およびTP1EEファイルシステムのI/O処理の多重度を考慮して，次に示す計算式を参考にして指定してください。

fil_watch_timeオペランドの指定値＞TP1EEファイルシステムのI/O処理の多重度※×ディスクへの1回のI/O処理時間

注※

処理スレッド数と回復スレッド数とを加算した値です。

fil_watch_timeオペランドの指定を省略すると，TP1EEファイルシステムのI/O処理時間をトランザクション処理時間に含みます。

I/O処理時間の監視範囲の詳細については，「11.4.7　I/O処理時間監視」を参照してください。

●fil_watch_timeout=down|continue　　〜《down》

トランザクション処理での，TP1EEファイルシステムへのI/O処理時間（I/O処理待ち時間も含む）が，ファイルサービス関連定義のfil_watch_timeオペランドで指定するTP1EEファイルシステムのI/O処理監視時間を超えた場合のTP1/EEの処理を指定します。

down

TP1/EEは，KFSB55312-Eメッセージを出力したあと，強制終了します。

continue

TP1/EEは，TP1EEファイルシステムへのI/O処理が完了したあと，KFSB51502-Wメッセージを出力して処理を続行します。

fil_watch_timeオペランドの指定を省略，または0を指定した場合は，fil_watch_timeoutオペランドの指定は無効になります。

コマンド形式

なし。

サービスグループ情報関連定義

形式

set形式

なし。

コマンド形式

｛｛eesvgdef  -g  サービスグループ名
              -h  ホスト名:ポート番号〔,ホスト名:ポート番号〕…
            〔-s  最大ソケット数〕
            〔-a〕
            〔-t RPC|DBQ|RAP〕
            〔-c〕
                  ｝｝
｛｛mysvgdef  -g  サービスグループ名
              -h  ポート番号:自ホスト名〔,ポート番号:自ホスト名〕…
            〔-s  最大ソケット数〕
            〔-f  フラグメントメッセージ用バッファ面数〕
            〔-t RPC|DBQ〕
            〔-b〕
                  ｝｝
｛｛myreplydef  -g  サービスグループ名
                -h  ポート番号:自ホスト名
              〔-f  フラグメントメッセージ用バッファ面数〕
              〔-b〕
                  ｝｝

機能

サービスグループ情報を定義します。

説明

各オペランドについて説明します。

set形式のオペランド

なし。

コマンド形式

次ページ以降に記述しています。

eesvgdef

名称

相手サービスグループ情報の定義

形式

｛｛eesvgdef  -g  サービスグループ名
              -h  ホスト名:ポート番号〔,ホスト名:ポート番号〕…
            〔-s  最大ソケット数〕
            〔-a〕
            〔-t RPC|DBQ|RAP〕
            〔-c〕
                  ｝｝

機能

TP1/EEからTP1/Server Base下のSPPのサービスを利用する場合

そのSPPのサービスグループ名，SPPの存在するノードのホスト名，およびTP1/Server Baseのスケジュールサービス定義のscd_portオペランドに指定したポート番号を指定します。

TP1/EEからTP1/EEのサービスを利用する場合

サービスグループ情報関連定義のmysvgdef定義コマンドで指定したホスト名とポート番号を指定します。

DBキューを使用したシステム間通信をする場合

相手システムのサービスグループ名，ノードのホスト名，ポート番号，およびイベント通知をRPC通信とTCP/IP通信のどちらで行うかを指定します。

リモートAPI機能を使用して通信する場合

リモートAPI機能によるサービスの受信口のホスト名とポート番号を指定します。この場合，サービスグループに対してトランザクションとしてサービスを要求しても，非トランザクションモードとして処理されます。

複数のホスト名，複数のポート番号も指定できます。ただし，リモートAPI機能を使用して通信する場合，複数のホスト名，複数のポート番号を指定できません。また，複数のeesvgdef定義コマンドに同じサービスグループ名を指定すると，定義ファイルで先に記述されているeesvgdef定義コマンドの指定が有効になります。複数のeesvgdef定義コマンドに同じサービスグループ名を指定している場合に，複数のeesvgdef定義コマンドで-tオプションの指定が統一されていないときも，定義ファイルで先に記述されているeesvgdef定義コマンドの指定が有効になります。

TP1/EEは，UAPから呼び出されるee_rpc_call関数，およびee_rpc_cmtsend関数の第一引数に指定したサービスグループ名を，eesvgdef定義コマンドに指定されたサービスグループ名の中から検索します。サービスグループ名が一致するeesvgdef定義コマンドが見つかった場合，そのeesvgdef定義コマンドに指定されているホストとポート番号へサービス要求を送信します。

同一サービスグループ下に複数のホスト名を指定した場合は，先頭から順番にラウンドロビン方式でホストを選択します。

ネームサービスを使用していない場合

初回の送信時は先頭ホストを選択，2回目以降の送信時は前回の次ホストを選択し，サービス要求を送信します。

送信に失敗した場合は，ee_rpc_call関数はエラーリターンします。

ネームサービスを使用している場合

初回の送信時は先頭ホストを選択，2回目以降の送信時は前回送信したホストを再選択し，サービス要求を送信します。

送信に失敗した場合は次ホストを選択し，サービス要求を送信します。

すべてのホストに対するサービス要求の送信に失敗した場合は，ee_rpc_call関数はエラーリターンします。

ee_rpc_call関数，またはee_rpc_cmtsend関数で，自プロセスあてにサービス要求する場合は，自ホストの情報を定義する必要があります。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

サービス要求するサービスグループ名を指定します。

●-h　ホスト名:ポート番号

ホスト名　　〜〈1〜255文字のホスト名〉

サービス要求するホスト名を指定します。ホスト名は，/etc/hostsファイル，DNSなどで，IPアドレスとマッピングできるように指定する必要があります。

ポート番号　　〜〈符号なし整数〉((1〜65535))

サービス要求するホストのポート番号を指定します。相手ホストがTP1/Server Baseの場合は，スケジュールサービスのポート番号を指定します。

●-s　最大ソケット数　　〜〈符号なし整数〉((1〜32))《1》

ホスト単位に接続するソケットの最大数を指定します。

複数スレッドから同一サービスグループ名で送信要求をする場合，サービスグループ下のソケット数の合計は，処理スレッド数に1を加算した値より大きい値にすることをお勧めします。

TP1/Server Baseへサービス要求する場合は，TP1/Server Baseのスケジュールサービス定義のmax_socket_descriptorsオペランドの指定値に，使用するソケット数を追加してください。次に示すときは，-sオプションの指定は無効となります。

ネームサービスを使用した場合に，-tオプションの指定を省略するか，RPCを指定したとき

-tオプションにRAPを指定したとき

●-a

TP1/EEプロセス起動時に，相手ホストとのコネクションを自動確立する場合に指定します。相手ホストがTP1/Server Base下のSPPの場合，または相手ホストがコネクションを確立してから最初のメッセージを受信するまでの時間監視をしている場合は，-aオプションを指定しないでください。次に示すときは，-aオプションの指定は無効となります。

ネームサービスを使用した場合に，-tオプションの指定を省略するか，RPCを指定したとき

-tオプションにRAPを指定したとき

●-t　RPC|DBQ|RAP　　〜《RPC》

相手ホストとの通信で使用する通信形態を指定します。

RPC

RPC通信を使用します。

DBキュー機能で使用するホストの場合，DBキューを使用したシステム間通信をRPC通信によって行います。ただし，RPC関連定義のname_useオペランドの指定に関係なく，ネームサービスは使用しません。

DBQ

DBキューを使用したシステム間通信をTCP/IP通信によって行います。

DBQを指定した場合は，サービスグループ情報関連定義のmysvgdef定義コマンドの-tオプションでDBQを指定し，DBキューのイベント通知用のポートとホスト名の組み合わせを一つ以上指定してください。

ただし，TP1/EE 01-01と通信する場合は，-tオプションを指定しないでください。

RAP

リモートAPI機能を使用して通信します。

RAPを指定した場合，-hオプションで指定した値が，リモートAPI機能によるサービスの受信口の情報となります。-hオプションには，自プロセスのホスト名およびポート番号（RPC関連定義のrap_listen_portオペランドで指定）を指定しないでください。自プロセスのホスト名およびポート番号を指定した上でサービスを要求した場合の動作は保証しません。

●-c Cosminexus連携

RPC要求先がCosminexusの場合に指定します。このオプションを指定しなかった場合は，TP1/EE側のRPC要求送信が失敗，またはCosminexus側のRPC応答送信が失敗します。

RPC要求先がCosminexus以外の場合は，このオプションを指定しないでください。指定した場合の動作は保証しません。

このオプションを指定し，かつ，次のどちらかの条件を満たす場合は，KFSB61817-Eメッセージ（理由コード：60）を出力し，TP1/EEの起動が失敗します。

ネームサービス機能を使用していない（name_use=N）

当該eesvgdefコマンド形式定義の-tオプションに「RPC」以外を指定している

このオプションを指定し，かつ，次の条件を満たす場合は，KFSB60353-Eメッセージ（理由コード：0010）を出力し，TP1/EEの起動が失敗します。

他eesvgdefコマンド形式定義（「DBQ」と「UDP」は除く）で同一サービスグループ名を指定し，かつ，-cオプションが指定されていない

mysvgdef

名称

自サービスグループ情報の定義

形式

｛｛mysvgdef  -g  サービスグループ名
              -h  ポート番号:自ホスト名〔,ポート番号:自ホスト名〕…
            〔-s  最大ソケット数〕
            〔-f  フラグメントメッセージ用バッファ面数〕
            〔-b〕
            〔-t RPC|DBQ〕
                  ｝｝

機能

TP1/EEでサービス要求を受け付けるためのポート番号と自ホスト名などを指定します。

DBキューを使用したシステム間通信をする場合，イベント通知を受信するためのポート番号と自ホスト名，およびイベント通知をRPC通信とTCP/IP通信のどちらで行うかを指定します。

ポート番号と自ホスト名の組み合わせは64まで指定できます。RPC通信用にポート番号と自ホスト名の組み合わせを1以上指定する必要があります。

mysvgdef定義コマンドで指定したポート番号と自ホスト名の組み合わせ数が，受信スレッド数になります。

マルチホームドホスト形態で，かつネームサービスを使用してサービス要求を受け付ける場合，サービス要求を受け付けるための自ホスト名は，TP1/Server Baseによって制御されます。マルチホームドホストについては，マニュアル「OpenTP1 解説」を参照してください。

定義で指定するスレッド数の合計は，1000以内にする必要があります。スレッド数の合計とは，次の指定値の合計に1を加えた値です。

プロセス関連定義のthread_noオペランドに指定する通常処理スレッド数

プロセス関連定義のreserve_thread_noオペランドに指定する予備処理スレッド数

TP1/FSPのタイマ関連定義のtim_perm_thread_noオペランドに指定するタイマ処理スレッド数＋1

プロセス関連定義のrecover_thread_noオペランドに指定する回復スレッド数

mysvgdef定義コマンドの-hオプションで指定したポート番号と自ホスト名の組み合わせ数（受信スレッド数）

myreplydef定義コマンドの-hオプションで指定したポート番号と自ホスト名の組み合わせ数（応答受信スレッド数）

スレッド数の合計が1000を超えた場合は，TP1/EEは起動できません。初期化処理の途中でプロセスダウンします。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

サービス要求を受け付けるサービスグループ名を指定します。プロセス関連定義のservice_groupオペランドで指定したサービスグループ名を指定してください。

●-h　ポート番号:自ホスト名

ポート番号　　〜〈符号なし整数〉((0，5001〜65535))

サービス要求を受け付けるためのポート番号を受信スレッド数分指定します。ポート番号は，mysvgdef定義コマンド内で重ならないように指定してください。TP1/Server Baseのシステム共通定義のrpc_port_baseオペランドには，-hオプションで指定したポート番号より大きな値を指定してください。

RPC通信の場合，-hオプション（ポート番号）に0を指定すると，RPC要求メッセージ受信用のポートに，OSが自動的に割り当てるポート番号を使用します。受信スレッドを複数個指定する場合，-hオプション（ポート番号）に0を指定できるのは，最初に定義する受信スレッドだけです。また，-hオプション（ポート番号）に0を指定できるのは，すべてのサービス要求元で，自TP1/EEのホスト名およびポート番号がネームサービスを使用して取得される環境の場合だけです。自TP1/EEのホスト名およびポート番号を，サービスグループ情報関連定義のeesvgdef定義コマンドで指定するなどの環境で-hオプション（ポート番号）に0を指定すると，サービスの受け付けができなくなります。

RPC関連定義のname_useオペランドにNを指定した場合は，-hオプション（ポート番号）に0を指定できません。

自ホスト名　　〜〈1〜255文字のホスト名〉

自システムのホスト名を指定します。自ホスト名は，/etc/hostsファイル，DNSなどで，IPアドレスとマッピングできるように指定する必要があります。

マルチホームドホスト形態で，かつネームサービスを使用してサービス要求を受け付ける場合は，TP1/Server Baseのシステム共通定義のmy_hostオペランドに指定したホスト名と同じ名称を指定してください。my_hostオペランドの指定を省略，またはMYHOSTを指定した場合は，hostnameコマンドが返す名称が指定されたと解釈されます。

なお，-hオプション（自ホスト名）には，IPアドレスが127.0.0.1となるホスト名（localhostなど）を指定しないでください。

●-s　最大ソケット数　　〜〈符号なし整数〉((1〜1024))《16》

指定したポート番号で受け付けるソケットの最大数を指定します。

-tオプションにRPCを指定した場合

該当TP1/EEに対してRPCコールを発行するプロセス数以上の値を指定してください。発行元がTP1/EEの場合はRPC要求元のTP1/EEの同時実行数です。

また次の条件にあてはまる場合は説明に従って指定値を加算してください。

負荷分散構成の場合は，同一サービスグループ名の各TP1/EEに「プロセス数-1」を加算してください。

TP1/FSPのeechglibコマンド，eesvctlコマンド，またはeesdhchgコマンドを他ノード実行する場合は，他ノード実行先に「1」を加算してください。なお，複数のTP1/EEから他ノード実行する場合は，プロセス分の加算が必要です。

TP1/FSPのeeucmdコマンドを他ノード実行する場合は，他ノード実行先に次のうち小さい方の値を加算してください。なお，複数のTP1/EEから他ノード実行する場合は，プロセス分の加算が必要です。

・eeucmdコマンドを同時に実行している数

・eeucmdコマンドを投入したTP1/EEプロセスの処理スレッド数（255を超える場合は255）

TP1/FSPのOBM機能を使用する場合は，BCM側に次の合計値を加算してください。

・eeobmstartコマンドの同時実行数×2

・次の小さい方の値

　・（OBMのトランザクションの同時実行数+1）×BCSプロセス数

　・BCSのスレッド数×BCSのプロセス数

OBM機能を使用する場合は，BCS側に次の小さい方の値を加算してください。

・ロットの同時実行数

・BCMの処理スレッド数

タイマ永続化機能を使用する場合は，ユーザタイマ登録/起動するTP1/EE（TP1/FSPのタイマ関連定義のtimpermdef定義コマンドの-a entryを指定したTP1/EE）側に「1」を加算してください。

-tオプションにDBQを指定した場合

次の小さい方の値を指定してください。

dbqdef定義コマンド※1の指定数×プロセス数※2

処理スレッド数×プロセス数※2

注※1

自サーバ読み出し，またはDBキュー読み出しサーバ変更機能を使用するdbqdef定義コマンド

注※2

自サーバ読み出し，またはDBキュー読み出しサーバ変更機能を使用するdbqdef定義コマンドに対してee_dbq_msgput関数を実行するTP1/EEのプロセス

●-f　フラグメントメッセージ用バッファ面数　　〜〈符号なし整数〉((0〜65535))《0》

自ホスト情報（ポート番号と自ホスト名との組み合わせ）単位に使用するフラグメントメッセージ用バッファ面数を指定します。

0を指定，または指定を省略した場合，フラグメントメッセージを受信できません。

-tオプションにDBQを指定した場合は，-fオプションに0を指定してください。

●-b

-hオプションで指定したホスト名（自IPアドレス）を固定する場合に指定します。

マルチホームドホスト形態でTP1/EEと自ホスト（IPアドレス）を対応づける必要がある場合に指定します。マルチホームドホストの場合，複数の物理ネットワークに接続しているので，複数のホスト名（IPアドレス）を持つ形態になります。2：1系切り替え構成や，相互系切り替え構成のように，IPアドレスを引き継ぐ系切り替えで，1ホスト（マシン）内に複数のOpenTP1（TP1/EE含む）が稼働する場合は，このオプションを指定する必要があります。

マルチホームドホスト形態で，かつネームサービスを使用してサービス要求を受け付ける場合，このオプションを指定しないでください。

●-t　RPC|DBQ　　〜《RPC》

相手ホストとの通信で使用する通信形態を指定します。

RPC

RPC通信を使用します。

DBキュー機能で使用するホストの場合，DBキューを使用したシステム間通信をRPC通信によって行います。

DBQ

DBキューを使用したシステム間通信をTCP/IP通信によって行います。

ただし，TP1/EE 01-01と通信する場合は，-tオプションを指定しないでください。

myreplydef

名称

自サービスグループ応答情報の定義

形式

myreplydef  -g サービスグループ名
            -h ポート番号:自ホスト名
          〔-f フラグメントメッセージ用バッファ面数〕
          〔-b〕

機能

TP1/EEでサービス応答，およびネームサービスからのメッセージを受け付けるためのポート番号と自ホスト名などを指定します。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

サービス応答，およびネームサービスからのメッセージを受け付けるサービスグループ名を指定します。プロセス関連定義のservice_groupオペランドで指定したサービスグループ名を指定してください。

●-h

ポート番号　　〜〈符号なし整数〉((5001〜65535))

サービス応答を受け付けるためのポート番号を指定します。ポート番号は，mysvgdef定義コマンドと重ならないように指定してください。TP1/Server Baseのシステム共通定義のrpc_port_baseオペランドには，-hオプションで指定したポート番号より大きな値を指定してください。

RPC関連定義のrpc_reply_port_autoオペランドにYを指定した場合，-hオプションで指定したポート番号は，ネームサーバからのメッセージ受信用だけに使用します。

自ホスト名　　〜〈1〜255文字のホスト名〉

自システムのホスト名を指定します。自ホスト名は，/etc/hostsファイル，DNSなどで，IPアドレスとのマッピングができるように指定する必要があります。-hオプション（自ホスト名）には，IPアドレスが127.0.0.1となるホスト名（localhostなど）を指定しないでください。

RPC関連定義のipc_notify_response_hostオペランドにYを指定する場合（Kubernetesクラスタ構成），自ホスト名として次の値を指定します。

自ノードがKubernetesクラスタ外のTP1/EEの場合

自ノードが起動するマシンのホスト名またはIPアドレスを指定します。

自ノードがKubernetesクラスタ内のTP1/EEの場合

Kubernetesクラスタ内のどれかのKubernetesノードのホスト名またはIPアドレスを指定します。

ここで設定するIPアドレスは，他ノードで起動するプロセスが指定している，自ノードを示すホスト名またはIPアドレスと一致させることを推奨します。RPC要求元がTP1/EEの場合の，RPC要求先を示すホスト名またはIPアドレスを次に示します。

eesvgdef定義コマンドに指定するホスト名またはIPアドレス

ee_rpc_call_to関数やee_rpc_cmtsend_to関数のdirection引数に指定するホスト名またはIPアドレス

●-f　フラグメントメッセージ用バッファ面数　　〜〈符号なし整数〉((0〜65535))《0》

自ホスト情報（ポート番号と自ホスト名との組み合わせ）単位に使用するフラグメントメッセージ用バッファ面数を指定します。

RPC関連定義のrpc_name_service_extendオペランドに1を指定している場合は，3以上を指定してください。

0を指定，または指定を省略した場合，フラグメントメッセージを受信できません。

●-b

-hオプションで指定したホスト名（自IPアドレス）を固定する場合に指定します。

マルチホームドホスト形態でTP1/EEと自ホスト（IPアドレス）を対応づける必要がある場合に指定します。マルチホームドホストの場合，複数の物理ネットワークに接続しているので，複数のホスト名（IPアドレス）を持つ形態になります。2：1系切り替え構成や，相互系切り替え構成のように，IPアドレスを引き継ぐ系切り替えで，1ホスト（マシン）内に複数のOpenTP1（TP1/EE含む）が稼働する場合は，このオプションを指定する必要があります。

9　運用コマンドの概要

この章では，TP1/EEで使用する運用コマンドの入力方法，および記述形式を説明します。

9.1　運用コマンドの入力方法

TP1/EEの運用コマンドの入力方法には，シェルから入力する方法とUAPの中に組み込んで実行する方法とがあります。

UAPに組み込んで実行する方法の詳細については，マニュアル「TP1/Server Base Enterprise Option プログラム作成の手引」を参照してください。

運用コマンドは，TP1/EEプロセスとは別プロセスで動作する実行形式ファイルです。

運用コマンドのうち，TP1/EEプロセスと連携して処理をする運用コマンドは，TP1/EEプロセスが起動中の場合（コマンドスレッドが受信可能の場合）に実行できます。

9.2　運用コマンドの記述形式

運用コマンドの記述形式を次に示します。

　　コマンド名　オプション　コマンド引数

9.2.1　コマンド名

コマンド名は，実行するコマンドのファイル名称です。

TP1/EEの運用コマンドは$DCDIR/bin/にありますので，運用コマンドを実行する場合はPATHに$DCDIR/binを加えてください。または，コマンドをフルパスで指定してください。

9.2.2　オプション

次の説明中に使用する$はシェルのプロンプト，cmdはコマンド名称です。

オプションは半角マイナス記号「-」で始まる文字列で，フラグ引数を取らないか，または1個のフラグ引数を取ります。なお，オプションの指定順序は問いません。

オプションの記述形式を次に示します。

　-オプションフラグ

　または

　-オプションフラグ　フラグ引数

（凡例）

オプションフラグ：1文字の英数字

　　　　　　　　　（英大文字と英小文字は区別されます）

フラグ引数：オプションフラグに対する引数

フラグ引数を取らないオプションは，一つのマイナス記号のあとにまとめて指定できます。なお，フラグ引数を取らないオプションにフラグ引数を記述した場合，そのオプション以降の指定値はコマンド引数と認識されます。

（例）

次の二つは同じ意味です。

$ cmd -a -b -c

$ cmd -abc

フラグ引数を必要とするオプションのフラグ引数は，省略できません。

フラグ引数中に空白を含める場合で，シェルから入力するときには，前後を引用符「"」で囲まなければなりません。

（例）

1 2を引数に持つオプションfは，次のように入力します。

$ cmd -f "1 2"

同じオプションを2回以上指定すると，最後に指定したものが有効になります。

（例）

$ cmd -a 1　-a 2

　　　無効 有効

オプションは，コマンド引数より前に指定しなければなりません。

（例）

オプション-aが，フラグ引数をとらない場合，次のように入力すると，fileと-bは，コマンド引数と見なされます。

$ cmd -a file -b

二つのマイナス記号「--」は，オプションの終わりを示します。

（例）

次のように入力すると，-bはコマンド引数と見なされます。

$ cmd -a -- -b

マイナス記号だけのオプションは，入力できません。

（例）

次のように入力すると，「-」はコマンド引数と見なされます。

$ cmd -

9.2.3　コマンド引数

コマンド引数の指定例を次に示します。次の説明中に使用する$はシェルのプロンプト，cmdはコマンド名称，-aはフラグ引数を必要とするオプション，-bはフラグ引数を必要としないオプション，Pはコマンド引数です。

コマンド引数の指定がない場合，次のように入力します。

（例）

$cmd

$cmd -b

$cmd -a 1 -b

コマンド引数の指定がある場合，次のように入力します。

（例）

$cmd P

$cmd -b P

$cmd -a 1 -b P

9.3　運用コマンドの使用方法の表示

運用コマンドの使用方法を知りたい場合，コマンド名に続けてオプションとして-hを指定すると，そのコマンドの使用方法を示すヘルプメッセージを出力させることができます。

ヘルプメッセージを出力させるときの記述例を次に示します。

$ cmd -h

9.4　運用コマンドの動作結果の通知

運用コマンドでは，exitコードを使うとコマンドの実行結果を通知できます。運用コマンドが返すexitコードを次の表に示します。

表9‒1　コマンドのexitコード

動作結果

exitコード

正常終了

0

エラー終了

0以外

9.5　運用コマンドの一覧

TP1/EEの運用コマンド一覧を表9-2に示します。

表9-2中のオンライン中に実行できる運用コマンドは，実行時に，次に示す環境変数を設定してください。

PATH

TP1/EEの運用コマンド実行ファイル名が格納されているディレクトリを設定してください。

LD_LIBRARY_PATH

TP1/EEのライブラリのインストールディレクトリを設定してください。

LANG

TP1/EEのメッセージログの言語種別を設定してください。詳細については，「6.3.6(4)　出力するメッセージログの言語種別の設定」を参照してください。

表9‒2　TP1/EEの運用コマンド一覧

機能

運用コマンド

オフライン

オンライン

API

TP1/EE管理

運用コマンド実行機能の実行環境設定

eeadmccsetup

○

○

×

TP1/EE稼働前の定義チェック

eedefchk

○

○

○

ファイルサービス

TP1EEファイルシステムの初期化

eefilmkfs

○

○

○

TP1EEファイルシステムの状態表示

eefilstatfs

○

○

○

TP1EEファイルシステムの内容表示

eefills

○

○

○

TP1EEファイルシステムのバックアップ

eefilbkup

○

○

○

TP1EEファイルシステムのリストア

eefilrstr

○

○

○

TP1EEファイルグループの変更

eefilchgrp

○

○

○

TP1EEファイルのアクセス許可モードの変更

eefilchmod

○

○

○

TP1EEファイル所有者の変更

eefilchown

○

○

○

プロセス制御

TP1/EEの開始

eesvstart

○

×

△

TP1/EEの終了

eesvstop

×

○

○※1

システム制御

サービスの閉塞

eedctsv

×

○

○

サービスの閉塞解除

eeactsv

×

○

○

サービスの状態表示

eelssv

×

○

○

メモリの使用状況の表示

eememls

×

○

○

処理キューの滞留状態の表示およびサービスの最大同時処理限界数の変更

eelspce

×

○

○

UAP共用ライブラリの入れ替え

eechgap

×

○

×

動作中のUAP共用ライブラリ名の表示

eeapls

×

○

○

処理キュー統計情報の表示

eelsque

×

○

○

通信制御

RPC通信機能で使用しているコネクションの状態表示

eerpclscn

×

○

○

RPC通信機能で使用しているコネクションの切断

eerpcsockcls

×

○

○

TCP/IP共有送信用コネクションの状態表示

eerpctcpls

×

○

○

RPC応答メッセージ送信抑止状態の表示

eerpcspndls

×

○

○

RPC応答メッセージ送信抑止状態の解放

eerpcspndrles

×

○

○

常設コネクション状態表示

eerpcrapls

×

○

○

常設コネクションの切断

eerpcrapcls

×

○

○

ネームサービスのネーム情報の削除

eerpcnamdel

○

○

△

一時クローズ処理の実行状態の表示

eerpcstat

×

○

○

ネーム情報の即時更新

eenamupdate

×

○

○

サービスグループの閉塞，閉塞解除，および，閉塞状態の表示

eesgrpctl

×

○

○

トランザクション制御

オンライン中のトランザクションの状態表示

eetrnlstr

×

○

○

リソースマネジャ連携用オブジェクトファイルの作成

eetrnmkobj

○

○

○

リソースマネジャの情報の表示

eetrnlsrm

○

○

○

トランザクションのコミット

eetrncmt

×

○

○

トランザクションのロールバック

eetrnrbk

×

○

○

トランザクションの強制終了

eetrnfgt

×

○

○

トランザクション処理の監視時間の変更

eetrntim

×

○

○

オフライン中にコアファイルからトランザクション状態を取得，表示

eetrnlsdump

○

○

○

排他管理

排他情報の表示

eelckls

×

○

○

ステータスファイル管理

ステータスファイルの作成，初期設定

eestsinit

○

○

○

ステータスファイルのオープン

eestsopen

×

○

○

ステータスファイルのクローズ

eestsclose

×

○

○

ステータスファイルの削除

eestsrm

○

○

○

ステータスファイルのスワップ

eestsswap

×

○

○

ステータスファイルの状態表示

eestsls

×

○

○

ステータスファイルの内容表示

eestsfills

○

○

○

DBキュー制御

DBキューの情報表示

eedbqls

×

○

○

DBキューの状態，未読み出しメッセージの有無のリスト表示

eedbqlsdq

×

○

○

DBキューとDBキューサービスとの接続

eedbqcnct

×

○

○

DBキューグループとDBキューサービスとの接続解除

eedbqrels

×

○

○

DBキューの読み出し停止

eedbqstop

×

○

○

DBキューの読み出し再開

eedbqrst

×

○

○

DBキューのメッセージのスキップ

eedbqskip

×

○

○

DBキューサービスの閉塞

eedbqdctsv

×

○

○

DBキューサービスの閉塞解除

eedbqactsv

×

○

○

DBキューサービスの状態のリスト表示

eedbqlssv

×

○

○

DBキューサービスとDBキューとの接続状態の表示

eedbqlscs

×

○

○

DBキューグループのDBキューリストの表示

eedbqlsqg

×

○

○

DBキューグループ指定によるメッセージ書き込み時のDBキューの縮退指定

eedbqislt

×

○

○

DBキュー読み出しサーバの変更

eedbqchgr

×

○

○

DBキューの書き込み抑止または抑止解除

eedbqwtpr

×

○

○

DBキューの書き込み禁止/禁止解除

eedbqinhibit

×

○

○

DBキューの通番初期化

eedbqclr

×

○

○

HiRDB用のDBキュー表の作成または削除

eedbqtblh

○

×※2

×

HiRDB用のDBキューの通番強制初期化

eedbqclrh

○

○

○

Oracle用のDBキュー表の作成または削除

eedbqtblo

○

×※2

×

DBキュー書き込みメッセージ表の戻し

eedbqaltput

×

○

○

DBキュー交替用切り替え状況の表示

eedbqaltlsh

○

○

×

メッセージ応答

TP1/EEプロセスのメッセージへの応答

eetrbwtor

×

○

×

トラブルシューティング

保守資料の取得

eerasget

○

○

×

TASKTM情報の強制出力

eetrbtaskfput

×

○

○

TASKTM情報の編集出力

eetrbtasked

○

○

○

TASKTM情報の編集出力（コアファイルまたはメモリダンプファイル入力）

eetrbtaskdump

○

○

○

回線トレース情報の強制出力

eetrbtrcefput

×

○

○

回線トレース情報の編集出力

eetrblineed

○

○

○

回線トレース情報の編集出力（コアファイルまたはメモリダンプファイル入力）

eetrblinedump

○

○

○

UAPトレース情報の強制出力

eetrbuatfput

×

○

○

UAPトレース情報の編集出力

eetrbuated

○

○

○

UAPトレース情報の編集出力（コアファイルまたはメモリダンプファイル入力）

eetrbuapdump

○

○

○

テーブル情報の表示

eetrbtbldump

○

○

○

基本統計情報の取得

eetrbstcse

×

○

○

拡張統計情報の取得

eetrbstcese

×

○

○

統計情報の強制出力

eetrbstcfput

×

○

○

統計情報の編集

eetrbstced

○

○

○

システム統計情報のリアルタイム編集

eetrbreport

×

○

○

ファイルの縮退回復

eetrbrcvr

×

○

○

（凡例）

オフライン：TP1/EE未起動での実行。

オンライン：TP1/EE起動中の実行。

API：ee_adm_call_command関数での実行。

○：実行できます。

×：実行できません。

△：自TP1/EEに対しては実行できませんが，他TP1/EEに対しては実行できます。

注※1

自TP1/EEに対して使用する場合はコマンド入力文字列に&を付加し，バックグラウンド実行にしてください。

注※2

次に示すどちらかの場合は，eedbqtblhコマンドまたはeedbqtbloコマンドで，使用中のDBキューの削除および再作成を実行しないでください。使用中のDBキューの削除および再作成を実行した場合はDBキューが破壊されるため，システムの動作は保証しません。

・DBキューを使用しているTP1/EEが動作している場合

・DBキューを使用しているCosminexus Reliable Messagingが動作している場合

9.6　運用コマンド入力時の注意事項

TP1/EE，およびTP1/Server Baseのコマンドを入力する場合の注意事項について説明します。

9.6.1　TP1/EEのコマンドの入力時の注意事項

TP1/EEプロセスでは，コマンドを入力順に処理します。そのため，運用コマンドを業務運用の一部に組み込む場合は，次に示すことに注意してください。

複数の運用コマンドを入力した場合は，順番待ちが発生して応答時間が長くなる。

一度に大量の運用コマンドを受け付けた場合は，後続のコマンドがエラーになることがある。

9.6.2　使用できないTP1/Server Baseのコマンド

次に示すTP1/Server Baseのコマンドは，TP1/EEに対して実行できません。

表9‒3　使用できないTP1/Server Baseのコマンド

運用コマンド

機能

scdhold※

スケジュールの閉塞

scdrles

スケジュールの再開始

scdchprc

プロセス数の変更

scdrsprc

プロセスの停止および再起動

注※

-aオプションを指定してscdholdコマンドを実行した場合，TP1/EEは正常停止します。この場合，eesvstopコマンドでサーバを終了させてから，eesvstartコマンドでTP1/EEを開始させてください。このとき，TP1/EEは，eesvstopコマンドのオプションに関係なく正常開始します。scdholdコマンドを実行してTP1/EEを停止したあとに，eesvstopコマンドを実行しないでscdrlesコマンドを実行した場合，TP1/EE起動中にKFSB55315-Eメッセージが出力され，起動が完了します。

10　運用コマンドの詳細

この章では，運用コマンドをアルファベット順に説明します。

eeactsv

名称

サービスの閉塞解除

形式

eeactsv -gサービスグループ名 ｛-a｜-v サービス名｝

機能

サービスの閉塞を解除します。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

閉塞を解除するサービスグループ名を指定します。

●-a

閉塞しているすべてのサービスの閉塞を解除します。

●-v　サービス名　　〜〈1〜31文字の識別子〉

閉塞を解除するサービス名を指定します。

出力メッセージ

メッセージID

内容

出力先

KFSB95301-E

コマンドの形式が不正です。

標準エラー出力

KFSB95302-E

フラグ引数が不正です。

標準エラー出力

KFSB95304-E

オプションの組み合わせが不正です。

標準エラー出力

KFSB95305-E

コマンドが失敗しました。

標準エラー出力

KFSB95306-E

領域の確保に失敗しました。

標準エラー出力

KFSB95307-E

内部矛盾が発生しました。

標準エラー出力

KFSB95330-I

ヘルプメッセージ

標準出力

KFSB95331-I

サービスを閉塞解除しました。

標準出力

KFSB95332-E

サービスの閉塞解除に失敗しました。

標準エラー出力

KFSB95333-I

すべてのサービスを閉塞解除しました。

標準出力

KFSB95334-E

すべてのサービスの閉塞解除に失敗しました。

標準エラー出力

eeadmccsetup

名称

運用コマンド実行機能の実行環境設定

形式

eeadmccsetup 〔-d〕 〔ユーザプログラムファイルディレクトリ〕

機能

運用コマンド実行機能を実行するために必要な環境設定をします。

オプション

●-d

TP1/EE実行環境から運用コマンド実行機能の実行環境を削除します。

コマンド引数

●ユーザプログラムファイルディレクトリ　　〜〈パス名〉

ユーザプログラムファイルを格納するディレクトリを指定します。

省略した場合は，$DCDIR/aplibが仮定されます。

出力メッセージ

メッセージID

内容

出力先

KFSB91801-E

コマンドの形式が不正です。

標準エラー出力

KFSB91803-E

コマンドの引数が不正です。

標準エラー出力

KFSB91804-E

コマンドの実行環境が不正です。

標準エラー出力

KFSB91852-I

ヘルプメッセージ

標準出力

注意事項

eeadmccsetupコマンドは，OpenTP1管理者が実行してください。

eeadmccsetupコマンドで環境設定をする場合，旧バージョンの環境が残っているときは，まず-dオプションを使用して旧バージョンの環境を削除してから，新しいバージョンの環境設定をしてください。

eeapls

名称

動作中のUAP共用ライブラリ名の表示

形式

eeapls -g サービスグループ名

機能

指定したサービスグループで使用しているUAP共用ライブラリ名を表示します。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

UAP共用ライブラリ名を表示するTP1/EEプロセスのサービスグループ名を指定します。

出力形式

日本語の出力形式を次に示します。

サービスグループ名=aa....aa
ＵＡＰ共用ライブラリ名
bb....bb

英語の出力形式を次に示します。

service group name = aa....aa
UAP common library name
bb....bb

出力形式中の，各変数の意味を次に示します。

変数

意味

aa....aa

サービスグループ名

bb....bb

UAP共用ライブラリ名

出力メッセージ

メッセージID

内容

出力先

KFSB90301-E

領域の確保に失敗しました。

標準エラー出力

KFSB90302-E

通信障害が発生しました。

標準エラー出力

KFSB90303-E

コマンドの形式が不正です。

標準エラー出力

KFSB90304-E

フラグ引数が不正です。

標準エラー出力

KFSB90305-E

コマンド処理でエラーが発生しました。

標準エラー出力

KFSB90306-E

内部矛盾が発生しました。

標準エラー出力

KFSB90375-I

ヘルプメッセージ

標準出力

eechgap

名称

UAP共用ライブラリの入れ替え

形式

eechgap -g サービスグループ名
       ｛-s｜-r｜-b 入れ替え元UAP共用ライブラリ名
                 -a 入れ替え先UAP共用ライブラリ名 〔-c〕｝
       〔-t トランザクション静止化監視時間〕

機能

指定したサービスグループのトランザクションを停止し（トランザクションの静止化），UAP共用ライブラリを入れ替えます。このコマンドの実行中にエラーが発生した場合は，UAP共用ライブラリを入れ替えません。なお，トランザクションの静止化のタイミングはUAPリターン後になります。また，オプションの指定によって，トランザクションの静止化だけ，またはトランザクション静止化状態の解除だけの実行もできます。

このコマンドは，動作中のトランザクションが少ないときに実行してください。動作中のトランザクションが多いときにこのコマンドを実行すると，処理キューが滞留します。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

UAP共用ライブラリの入れ替えをするTP1/EEプロセスのサービスグループ名を指定します。

●-s

トランザクションを静止化します。

●-r

トランザクションの静止化状態を解除します。

●-b　入れ替え元UAP共用ライブラリ名　　〜〈510文字以内のパス名〉

入れ替え元となるUAP共用ライブラリの名称を絶対パス名で指定します。

●-a　入れ替え先UAP共用ライブラリ名　　〜〈510文字以内のパス名〉

入れ替え先となるUAP共用ライブラリの名称を絶対パス名で指定します。

●-c

UAP共用ライブラリを入れ替えたあと，トランザクションの静止化状態の解除をしない場合に指定します。省略した場合は，UAP共用ライブラリを入れ替えたあとにトランザクションの静止化状態を解除します。

●-t　トランザクション静止化監視時間　　〜〈符号なし整数〉((1〜300))《20》（単位：秒）

すべてのトランザクションが停止するまでの監視時間を指定します。監視時間内に，動作中のトランザクションが終了しなかった場合は，トランザクションの静止化状態を解除します。

出力メッセージ

メッセージID

内容

出力先

KFSB90301-E

領域の確保に失敗しました。

標準エラー出力

KFSB90302-E

通信障害が発生しました。

標準エラー出力

KFSB90303-E

コマンドの形式が不正です。

標準エラー出力

KFSB90304-E

フラグ引数が不正です。

標準エラー出力

KFSB90305-E

コマンド処理でエラーが発生しました。

標準エラー出力

KFSB90306-E

内部矛盾が発生しました。

標準エラー出力

KFSB90307-E

オプションフラグの組み合わせが不正です。

標準エラー出力

KFSB90370-I

ヘルプメッセージ

標準出力

KFSB90371-I

UAP共用ライブラリの入れ替えが完了しました。

標準出力

KFSB90372-I

トランザクションを静止化しました。

標準出力

KFSB90373-I

トランザクションの静止化状態を解除しました。

標準出力

KFSB90374-E

トランザクションの静止化が完了しませんでした。

標準エラー出力

注意事項

入れ替え先UAP共用ライブラリ名には，入れ替え元UAP共用ライブラリ名と同じ絶対パス名を指定しないでください。同じ絶対パス名を指定した場合は，入れ替え元UAP共用ライブラリでUAP処理が実行されることがあります。

このコマンドを実行する場合，-bオプションには，次の図に示す入れ替え対象のUAP共用ライブラリを指定しないでください。実行した場合の動作は保障しません。

eedbqactsv

名称

DBキューサービスの閉塞解除

形式

eedbqactsv -g サービスグループ名
         ｛-a｜-v DBキューサービス名｝

機能

DBキューサービスの閉塞を解除します。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

閉塞を解除するTP1/EEプロセスのサービスグループ名を指定します。

●-a

閉塞しているすべてのDBキューサービスの閉塞を解除します。

●-v　DBキューサービス名　　〜〈1〜31文字の識別子〉

閉塞を解除するDBキューサービス名を指定します。

出力メッセージ

メッセージID

内容

出力先

KFSB95600-E

メモリを確保できません。

標準エラー出力

KFSB95601-E

コマンドの形式が不正です。

標準エラー出力

KFSB95602-E

コマンドのオプションが不正です。

標準エラー出力

KFSB95603-E

コマンドのオプションの組み合わせが不正です。

標準エラー出力

KFSB95637-I

DBキューサービスを閉塞解除しました。

標準出力

KFSB95638-I

すべてのDBキューサービスを閉塞解除しました。

標準出力

KFSB95639-I

永久閉塞中サービスを除き，すべてのDBキューサービスを閉塞解除しました。

標準出力

KFSB95650-E

TP1/EEプロセスでエラーを検知したため，DBキューコマンドが失敗しました。

標準エラー出力

KFSB95651-E

コマンドプロセスでエラーを検知したため，DBキューコマンドが失敗しました。

標準エラー出力

KFSB95668-I

ヘルプメッセージ

標準出力

注意事項

サービスが永久閉塞中の場合は，閉塞を解除できません。

指定したDBキューサービスがすでに閉塞解除状態の場合，コマンド成功を示す次のメッセージを出力します。

KFSB95637-I

KFSB95638-I

KFSB95639-I

eedbqaltlsh

名称

DBキュー交替用切り替え状況の表示

形式

eedbqaltlsh -q DBキュー名 〔-a〕〔-f〕

機能

通常のメッセージ表から交替用のメッセージ表に書き込む表を切り替えたメッセージ通番を表示します。また，交替用のメッセージ表から通常のメッセージ表に書き込む表を戻したメッセージ通番を表示します。

このコマンドは，通常のメッセージ表を全件検索する場合があるため，DBキューの最大メッセージ数が多いと処理時間が長くなります。

オプション

●-q　DBキュー名　　〜〈1〜27文字の英大識別子〉

DBキュー名を指定します。

●-a

メッセージ表を切り替え，および戻したすべてのメッセージ通番を表示する場合に指定します。

省略した場合は，最初に切り替え，または最初に戻したときのメッセージ通番だけが表示されます。

●-f

読み出し済みメッセージと，未読み出しメッセージの両方を表示する場合に指定します。

省略した場合は，未読み出しメッセージ通番だけが表示されます。

出力形式

●標準出力への出力形式

出力形式を次に示します。

    NORMAL           ALTER
nnnnnnnnn1 ---> nnnnnnnnn2    ※1
nnnnnnnnn3 <--- nnnnnnnnn4    ※2

注1※

通常のメッセージ表から交替用のメッセージ表に切り替えたことを示します。

注2※

交替用のメッセージ表から通常のメッセージ表に戻したことを示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

nnnnnnnnn1

交替用に切り替える直前のメッセージ通番

nnnnnnnnn2

交替用に切り替えたときのメッセージ通番

nnnnnnnnn3

通常用に戻したときのメッセージ通番

nnnnnnnnn4

通常用に戻す直前のメッセージ通番

切り替えていない場合は，次のように出力します。

not change

オプションの指定と表示例を次に示します。

図10‒1　通番がラップしていない場合

図の説明を次に示します。説明文中の値は図中の通番と対応します。

-aオプション，-fオプション省略時の出力形式を次に示します。

    NORMAL           ALTER
       300 --->        301

-aオプション指定，-fオプション省略時の出力形式を次に示します。

    NORMAL           ALTER
       300 --->        301
       401 <---        400

-aオプション省略，-fオプション指定時の出力形式を次に示します。

    NORMAL           ALTER
       100 --->        101

-aオプション，-fオプション指定時の出力形式を次に示します。

    NORMAL           ALTER
       100 --->        101
       201 <---        200
       300 --->        301
       401 <---        400

図10‒2　通番がラップしている場合

図の説明を次に示します。説明文中の値は図中の通番と対応します。

-aオプション，-fオプション省略時の出力形式を次に示します。

    NORMAL           ALTER
      1000 --->          1

-aオプション指定，-fオプション省略時の出力形式を次に示します。

    NORMAL           ALTER
      1000 --->          1
       101 <---        100

-aオプション省略，-fオプション指定時の出力形式を次に示します。

    NORMAL           ALTER
       800 --->        801

-aオプション，-fオプション指定時の出力形式を次に示します。

    NORMAL           ALTER
       800 --->        801
       901 <---        900
      1000 --->          1
       101 <---        100

出力メッセージ

メッセージID

内容

出力先

KFSB95600-E

メモリを確保できません。

標準エラー出力

KFSB95601-E

コマンドの形式が不正です。

標準エラー出力

KFSB95602-E

コマンドのオプションが不正です。

標準エラー出力

KFSB95613-E

DBキュー表の作成または削除に失敗しました（SQLエラー）。

標準エラー出力

KFSB95209-I

ヘルプメッセージ

標準出力

注意事項

このコマンドは，HiRDBのクライアント環境定義の指定値によってHiRDBに接続します。したがって，HiRDBのクライアント環境定義（PDHOST，PDNAMEPORT，およびPDUSER）を設定しておく必要があります。HiRDBのクライアント環境定義については，マニュアル「HiRDB UAP開発ガイド」を参照してください。

このコマンドは，HiRDBのクライアント環境定義のPDCLTAPNAMEに実行するコマンド名を設定してからHiRDBに接続します。

HiRDBのエラーログファイルを取得してください。HiRDBのエラーログファイルについては，マニュアル「HiRDB UAP開発ガイド」を参照してください。

HiRDBでエラーが発生した場合，TP1/EEのKFSB95613-EメッセージのSQLCODEに，HiRDBのリターンコードを表示します。このリターンコードに対応するメッセージIDを基に，X/OpenのTXインタフェースを使用しない場合に作成されるHiRDBのエラーログファイルを参照し，原因を取り除いてください。HiRDBのエラーログファイルについては，マニュアル「HiRDB UAP開発ガイド」を参照してください。

eedbqaltput

名称

DBキュー書き込みメッセージ表の戻し

形式

eedbqaltput -g サービスグループ名 -q DBキュー名

機能

DBキューのメッセージ表への書き込みを交替用から通常のメッセージ表に戻します。-qオプションに指定したDBキューに複数のTP1/EEから書き込みを行っている場合は，どれか1つのTP1/EEでこのコマンドを実行してください。交替用メッセージ表に書き込んでいるかどうかの状態は，ライト管理表上で管理し，複数のTP1/EE間で共用しています。そのため，どれか1つのTP1/EEでこのコマンドを実行することで，ほかのTP1/EEが書き込む表も元に戻ります。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

サービスグループ名を指定します。

●-q　DBキュー名　　〜〈1〜27文字の英大識別子〉

DBキュー名を指定します。

出力メッセージ

メッセージID

内容

出力先

KFSB95600-E

メモリを確保できません。

標準エラー出力

KFSB95601-E

コマンドの形式が不正です。

標準エラー出力

KFSB95602-E

コマンドのオプションが不正です。

標準エラー出力

KFSB95647-I

コマンドが成功しました。

標準出力

KFSB95650-E

TP1/EEプロセスでエラーを検知したため，DBキューコマンドが失敗しました。

標準エラー出力

KFSB95651-E

コマンドプロセスでエラーを検知したため，DBキューコマンドが失敗しました。

標準エラー出力

KFSB95208-I

ヘルプメッセージ

標準出力

注意事項

要求されたDBキューが通常のメッセージ表に書き込んでいる状態でこのコマンドを実行した場合は，コマンドは正常終了しKFSB95647-Iを出力します。

eedbqchgr

名称

DBキュー読み出しサーバの変更

形式

eedbqchgr -g 変更後のDBキュー読み出しサーバのサービスグループ名
          -f
        ｛-q DBキュー名｜
          -G 変更前のDBキュー読み出しサーバのサービスグループ名｜
          -N 変更前のDBキュー読み出しサーバのノード識別子｝ 〔-t〕

機能

DBキューからメッセージを読み出すサーバを変更します。

DBキュー読み出しサーバが障害でダウンした場合や，運用上，DBキュー読み出しサーバを変更したい場合に，別のサーバでeedbqchgrコマンドを実行すると，そのeedbqchgrコマンドを実行したサーバでDBキューからメッセージを読み出すようになります。

オプション

●-g　変更後のDBキュー読み出しサーバのサービスグループ名　　〜〈1〜31文字の識別子〉

変更後のDBキュー読み出しサーバのサービスグループ名を指定します。

●-f

DBキュー読み出しサーバの状態に関係なく，サーバを強制的に変更します。

変更前のDBキュー読み出しサーバで，メッセージ読み出しトランザクションの起動中に，-fオプションを指定したeedbqchgrコマンドを実行すると，二つのサーバが同一のメッセージを読み出すおそれがあります。この場合，どちらか一方のサーバのメッセージ読み出しトランザクションをTP1/EEがロールバックします。詳細については，「6.6.5(4)　DBキュー読み出しサーバが複数ある場合」を参照してください。

●-q　DBキュー名　　〜〈1〜27文字の識別子〉

メッセージを読み出すサーバを変更するDBキュー名を指定します。

●-G　変更前のDBキュー読み出しサーバのサービスグループ名　　〜〈1〜31文字の識別子〉

変更前のDBキュー読み出しサーバのサービスグループ名を指定します。-Gオプションで指定したサービスグループでメッセージを読み出しているすべてのDBキューが対象となります。

●-N　変更前のDBキュー読み出しサーバのノード識別子　　〜〈4文字の識別子〉

変更前のDBキュー読み出しサーバのノード識別子を指定します。-Nオプションで指定したノード識別子のサーバでメッセージを読み出しているすべてのDBキューが対象となります。

●-t

DBキュー読み出しサーバの変更後，読み出し先DBキューを読み出し停止状態にする場合に指定します。DBキューの読み出しを再開するには，eedbqrstコマンドまたはee_dbq_acsctl関数を使用します。

省略した場合は，DBキュー読み出しサーバを変更すると，DBキューの読み出しを開始します。

出力形式

日本語の出力形式を次に示します。

サービスグループ名 ：aa....aa
ノード識別子       ：bb....bb
ＤＢキュー名       ：cc....cc※

英語の出力形式を次に示します。

service group name                  : aa....aa
node ID                             : bb....bb
DB queue name                       : cc....cc※

注※

メッセージを読み出すサーバを変更したDBキューが複数ある場合は，出力対象のDBキュー数分の行が出力されます。メッセージを読み出すサーバを変更したDBキューがない場合は，サービスグループ名，ノード識別子，およびDBキュー名は出力されません。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa....aa

変更後のDBキュー読み出しサーバのサービスグループ名（1〜31文字）

bb....bb

変更後のDBキュー読み出しサーバのノード識別子（1〜4文字）

cc....cc

メッセージを読み出すサーバを変更したDBキュー名（1〜27文字）

出力メッセージ

メッセージID

内容

出力先

KFSB95600-E

メモリを確保できません。

標準エラー出力

KFSB95601-E

コマンドの形式が不正です。

標準エラー出力

KFSB95602-E

コマンドのオプションが不正です。

標準エラー出力

KFSB95622-I

ヘルプメッセージ

標準出力

KFSB95647-I

コマンドが成功しました。

標準出力

KFSB95650-E

TP1/EEプロセスでエラーを検知したため，DBキューコマンドが失敗しました。

標準エラー出力

KFSB95651-E

コマンドプロセスでエラーを検知したため，DBキューコマンドが失敗しました。

標準エラー出力

KFSB95653-E

TP1/EEプロセスでエラーを検知したため，DBキューコマンドが失敗しました。

標準エラー出力

注意事項

eedbqchgrコマンドは，DBキュー機能関連定義のdbqgrpdef定義コマンドで-cオプションを指定していないDBキューには実行できません。

KFSB95650-EメッセージまたはKFSB95653-Eメッセージが出力された場合でも，一部のDBキュー読み出しサーバの変更処理は終了していることがあります。

eedbqchgrコマンドの-Gオプションおよび-Nオプションに，OpenTP1システム内のどのTP1/EEでも定義されていないサービスグループ名およびノードIDを指定した場合，コマンドは正常に終了します。

eedbqchgrコマンドの実行時に，ee_dbq_msgput関数でメッセージの書き込みをしているサーバがある場合，変更前のDBキュー読み出しサーバで，理由コード0003を付加したKFSB45641-Wメッセージを出力することがあります。この場合でも，DBキュー読み出しサーバの変更，およびee_dbq_msgput関数の呼び出しは正常に終了しています。

理由コード0024を付加したKFSB95650-Eメッセージが出力された場合，eedbqlsコマンドで表示したDBキュー読み出しサーバは自サーバとなっているけれども，実際はどのサーバでもメッセージを読み出していない状態になるおそれがあります。この場合は，eedbqchgrコマンドを再実行してください。

メッセージ書き込み抑止状態のDBキューは，eedbqchgrコマンドを実行したあとも書き込み抑止状態のままとなります。

書き込み禁止状態のDBキューは，eedbqchgrコマンド実行後も書き込み禁止状態のままです。

eedbqclr

名称

DBキューの通番初期化

形式

eedbqclr -g サービスグループ名
         -q DBキュー名

機能

通番初期化属性があるDBキューの書き込み通番，および読み出し通番を0で初期化します。未読み出しメッセージはすべて破棄します。初期化した通番を元に戻したり，破棄したメッセージを読み出したりはできません。

このコマンドは，次の条件をすべて満たしている場合に実行できます。条件を満たしていない場合はエラーとなります。

コマンドを実行するサーバが，初期化するDBキューから読み出すサーバである。

読み出し停止状態である。

書き込み抑止状態である。

対象となるDBキューに対してメッセージの読み出し，スキップ，または初期化を実行しているトランザクションがない。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

通番を初期化するTP1/EEプロセスのサービスグループ名を指定します。

●-q　DBキュー名　　〜〈1〜27文字の英大識別子〉

通番を初期化するDBキュー名を指定します。

出力メッセージ

メッセージID

内容

出力先

KFSB95600-E

メモリを確保できません。

標準エラー出力

KFSB95601-E

コマンドの形式が不正です。

標準エラー出力

KFSB95602-E

コマンドのオプションが不正です。

標準エラー出力

KFSB95619-I

ヘルプメッセージ

標準出力

KFSB95629-I

コマンドを受け付けました。

標準出力

KFSB95650-E

TP1/EEプロセスでエラーを検知したため，DBキューコマンドが失敗しました。

標準エラー出力

KFSB95651-E

コマンドプロセスでエラーを検知したため，DBキューコマンドが失敗しました。

標準エラー出力

注意事項

このコマンドが成功しても，同期点処理で障害が発生すると通番は初期化されません。このコマンドが成功した場合は，eedbqlsコマンドで通番が初期化されたかどうかを確認してください。

eedbqclrh

名称

HiRDB用DBキューの通番強制初期化

形式

eedbqclrh -q DBキュー名

機能

通番初期化属性があるDBキューの書き込み通番，および読み出し通番を0で初期化します。未読み出しメッセージはすべて破棄します。初期化した通番を元に戻したり，破棄したメッセージを読み出したりはできません。

このコマンドによる強制初期化と次のトランザクションが競合すると，次のトランザクションがロールバックすることがあります。

DBキューからのメッセージを読み出し中のトランザクション

DBキューのメッセージをスキップ中のトランザクション

オプション

●-q　DBキュー名　　〜〈1〜27文字の英大識別子〉

通番を初期化するDBキュー名を指定します。

出力メッセージ

メッセージID

内容

出力先

KFSB95600-E

メモリを確保できません。

標準エラー出力

KFSB95601-E

コマンドの形式が不正です。

標準エラー出力

KFSB95602-E

コマンドのオプションが不正です。

標準エラー出力

KFSB95613-E

SQL実行時にエラーが発生しました。

標準エラー出力

KFSB95618-I

ヘルプメッセージ

標準出力

KFSB95648-I

通番を初期化しました。

標準出力

注意事項

このコマンドは，HiRDBのクライアント環境定義の指定値に従ってHiRDBに接続します。このため，HiRDBのクライアント環境定義（PDHOST，PDNAMEPORT，およびPDUSER）を設定しておく必要があります。HiRDBのクライアント環境定義については，マニュアル「HiRDB UAP開発ガイド」を参照してください。

このコマンドは，HiRDBのクライアント環境定義のPDCLTAPNAMEに実行するコマンド名を設定してからHiRDBに接続します。

HiRDBのエラーログファイルを取得してください。

HiRDBでエラーが発生した場合，KFSB95613-EメッセージのSQLCODEにHiRDBのリターンコードを表示します。このリターンコードに対応するメッセージIDを基に，X/OpenのTXインタフェースを使用しない場合に作成されるHiRDBのエラーログファイルを参照し，原因を取り除きます。HiRDBのエラーログファイルについては，マニュアル「HiRDB UAP開発ガイド」を参照してください。

このコマンドは，DBキューからメッセージを読み出すTP1/EEが停止しているときに使用してください。メッセージを読み出すTP1/EEがオンライン中の場合は，eedbqclrコマンドを使用してください。オンライン中にこのコマンドを実行してもメッセージを読み出すTP1/EEが通番初期化を検知しない場合があります。通番初期化を検知しない状態で，該当するDBキューにアクセスするコマンドおよびAPIを実行すると，コマンドおよびAPIがエラーになります。

eedbqcnct

名称

DBキューとDBキューサービスとの接続

形式

eedbqcnct -g サービスグループ名
          -q DBキュー名
          -v DBキューサービス名

機能

DBキューとDBキューサービスとを接続します。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

接続するTP1/EEプロセスのサービスグループ名を指定します。

●-q　DBキュー名　　〜〈1〜27文字の識別子〉

接続するDBキュー名を指定します。

●-v　DBキューサービス名　　〜〈1〜31文字の識別子〉

接続するDBキューサービス名を指定します。

出力メッセージ

メッセージID

内容

出力先

KFSB95600-E

メモリを確保できません。

標準エラー出力

KFSB95601-E

コマンドの形式が不正です。

標準エラー出力

KFSB95602-E

コマンドのオプションが不正です。

標準エラー出力

KFSB95630-I

DBキューの接続が成功しました。

標準出力

KFSB95650-E

TP1/EEプロセスでエラーを検知したため，DBキューコマンドが失敗しました。

標準エラー出力

KFSB95651-E

コマンドプロセスでエラーを検知したため，DBキューコマンドが失敗しました。

標準エラー出力

KFSB95662-I

ヘルプメッセージ

標準出力

注意事項

DBキュー機能関連定義のdbqgrpdef定義コマンドで-cオプションを指定していない，他サーバでメッセージを読み出しているDBキューには接続できません。

該当するDBキューの読み出し処理中に接続，接続解除を続けて実行することはできません。

最初のAP起動時には，TP1/EEサービス定義の指定で，任意のDBキューサービスに接続されているか，またはどのDBキューサービスにも接続されていないことがあります。任意のDBキューサービスに接続されているDBキューを，ほかのDBキューサービスと接続させるように変更する場合は，現在接続されているDBキューサービスを指定して接続解除してから，変更先のDBキューサービスと接続してください。

指定したDBキューとDBキューサービスとがすでに接続中の場合，コマンド成功を示すKFSB95630-Iメッセージを出力します。

eedbqdctsv

名称

DBキューサービスの閉塞

形式

eedbqdctsv -g サービスグループ名
           -v DBキューサービス名

機能

DBキューサービスを閉塞します。閉塞後はイベント受信時にAPを起動しません。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

閉塞するTP1/EEプロセスのサービスグループ名を指定します。

●-v　DBキューサービス名　　〜〈1〜31文字の識別子〉

閉塞するDBキューサービス名を指定します。

出力メッセージ

メッセージID

内容

出力先

KFSB95600-E

メモリを確保できません。

標準エラー出力

KFSB95601-E

コマンドの形式が不正です。

標準エラー出力

KFSB95602-E

コマンドのオプションが不正です。

標準エラー出力

KFSB95603-E

コマンドのオプションの組み合わせが不正です。

標準エラー出力

KFSB95635-I

DBキューサービスを閉塞しました。

標準出力

KFSB95650-E

TP1/EEプロセスでエラーを検知したため，DBキューコマンドが失敗しました。

標準エラー出力

KFSB95651-E

コマンドプロセスでエラーを検知したため，DBキューコマンドが失敗しました。

標準エラー出力

KFSB95667-I

ヘルプメッセージ

標準出力

注意事項

指定したDBキューサービスがすでに閉塞状態の場合，コマンド成功を示すKFSB95635-Iメッセージを出力します。

eedbqinhibit

名称

DBキューのメッセージの書き込み禁止状態操作

形式

eedbqinhibit -g サービスグループ名
          {-a|-p DBキューグループ名|-q DBキュー名} 〔-r〕

機能

DBキューへの書き込み禁止状態を解除，または設定します。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

DBキューへの書き込み禁止状態を解除，または設定するTP1/EEプロセスのサービスグループ名を指定します。

●-a

すべてのDBキューを対象として実行します。

●-p　DBキューグループ名　　〜〈1〜31文字の識別子〉

DBキューへの書き込み禁止状態を解除，または設定するDBキューグループ名を指定します。

●-q　DBキュー名　　〜〈1〜27文字の識別子〉

DBキューへの書き込み禁止状態を解除，または設定するDBキュー名を指定します。

●-r

DBキューへの書き込み禁止状態を解除します。

出力メッセージ

メッセージID

内容

出力先

KFSB95600-E

メモリを確保できません。

標準エラー出力

KFSB95601-E

コマンドの形式が不正です。

標準エラー出力

KFSB95602-E

コマンドのオプションが不正です。

標準エラー出力

KFSB95647-I

コマンドが成功しました。

標準出力

KFSB95650-E

TP1/EEプロセスでエラーを検知したため，DBキューコマンドが失敗しました。

標準出力

KFSB95651-E

コマンドプロセスでエラーを検知したため，DBキューコマンドが失敗しました。

標準エラー出力

KFSB95206-I

ヘルプメッセージ

標準出力

注意事項

DBキュー機能関連定義のdbq_inhibit_useを省略しているか，Nを設定していた場合は，このコマンドを実行できません。

書き込み禁止状態に書き込み禁止のコマンドを実行してもKFSB95647-Iメッセージを表示します。

書き込み禁止状態の解除中に書き込み禁止解除のコマンドを実行してもKFSB95647-Iメッセージを表示します。

eedbqislt

名称

DBキューグループ指定によるメッセージ書き込み時のDBキューの縮退指定

形式

eedbqislt -g サービスグループ名
          -q DBキュー名 〔-r〕

機能

DBキューグループを指定してメッセージを書き込む場合，該当するDBキューグループのDBキューを，書き込み先DBキューとして含むかどうかを指定します。書き込み先DBキューに含まないDBキューがある場合，DBキューグループは縮退運転をします。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

書き込み対象のTP1/EEプロセスのサービスグループ名を指定します。

●-q　DBキュー名　　〜〈1〜27文字の識別子〉

該当するDBキュー名を指定します。

●-r

-qオプションに指定したDBキューを，書き込み先DBキューに含む場合に指定します。-rオプションを省略した場合，-qオプションに指定したDBキューは，書き込み先DBキューから除外されます。この場合，DBキューグループは縮退運転になります。

出力メッセージ

メッセージID

内容

出力先

KFSB95600-E

メモリを確保できません。

標準エラー出力

KFSB95601-E

コマンドの形式が不正です。

標準エラー出力

KFSB95602-E

コマンドのオプションが不正です。

標準エラー出力

KFSB95621-I

ヘルプメッセージ

標準出力

KFSB95645-I

DBキューを縮退しました。

標準出力

KFSB95646-I

DBキューを縮退復帰しました。

標準出力

KFSB95650-E

TP1/EEプロセスでエラーを検知したため，DBキューコマンドが失敗しました。

標準エラー出力

KFSB95651-E

コマンドプロセスでエラーを検知したため，DBキューコマンドが失敗しました。

標準エラー出力

eedbqls

名称

DBキューの情報表示

形式

eedbqls -g サービスグループ名
        -q DBキュー名

機能

DBキューにアクセスして，DBキューの情報を表示します。

DBキューを読み出しているTP1/EEプロセスのバージョンが07-80以降で，かつDBキュー関連定義のdbqgrpdef定義コマンドの-kオプションに1を指定している場合は，RPC通信を使用してDBキューの読み出し状態を表示します。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

情報を表示するTP1/EEプロセスのサービスグループ名を指定します。

●-q　DBキュー名　　〜〈1〜27文字の識別子〉

情報を表示するDBキュー名を指定します。

出力形式

日本語の出力形式を次に示します。

サービスグループ名　：aa....aa
ＤＢキューグループ名：bb....bb
ＤＢキューサービス名：cc....cc
ＤＢキュー名：dd....dd
ＩＰアドレス　　　　：ee....ee
ポート番号　　　　　：ff....ff
読出し基盤種別　　：gg....gg
読出しシステム種別：hh....hh
読出しサービスグループ名：ii....ii
読出しプロセス識別子：jj....jj
ＤＢキューステータス：k（l）
書込み禁止ステータス：y
書込み通番　　　　：mmmmmmmmmm
読出し通番　　　　：nnnnnnnnnn
書込み最大通番　　：oooooooooo
未読出し数　　　　：pppppppppp
ＤＢキュー種別：qq....qq
ＤＢキュー属性：rr....rr
ＴＰ１／ＳＢノード識別子：ss....ss
書込みメッセージ表：t
読出しメッセージ表：u

英語の出力形式を次に示します。

service group name                  : aa....aa
DB queue group name                 : bb....bb
DB queue service name               : cc....cc
DB queue name                       : dd....dd
IP address                          : ee....ee
port number                         : ff....ff
read basis type                     : gg....gg
read system type                    : hh....hh
read service group name             : ii....ii
read process ID                     : jj....jj
DB queue status                     : k(l)
DB queue write inhibit status       : y
serial number for writing           : mmmmmmmmmm
serial number for reading           : nnnnnnnnnn
maximum serial number for writing   : oooooooooo
number of unread messages           : pppppppppp
DB queue type                       : qq....qq
DB queue attribute                  : rr....rr
TP1/SB node ID                      : ss....ss
write message table                 : t
read message table                  : u

出力形式中の，各変数の意味を次に示します。

変数

意味

aa....aa

サービスグループ名（1〜31文字）

bb....bb

DBキューグループ名（1〜31文字）

cc....cc

DBキューサービス名（1〜31文字）

接続されていない場合は，「*」を表示します。

dd....dd

DBキュー名（1〜27文字）

ee....ee

DBキュー読み出しサーバのIPアドレス※1

ff....ff

DBキュー読み出しサーバのポート番号※1

gg....gg

読み出すサーバの種別※1，※2

TP1EE…TP1/EE

CosmiRM…uCosminexus Reliable Messaging

読み出すサーバを確認できない場合は，「*」を表示します。

hh....hh

使用者が読み出すサーバを特定するための情報※1，※2

読み出すサーバの種別によって次の内容を表示します。

TP1EE…ノード識別子

CosmiRM…システム名（RMSystemName指定値）

読み出すサーバを確認できない場合は，「*」を表示します。

ii....ii

DBキュー読み出しサーバサービスグループ名（1〜31文字）※3

DBキュー読み出しサーバを確認できない場合，またはDBキュー読み出しサーバにサービスグループ名がない場合は，「*」を表示します。

jj....jj

DBキュー読み出しサーバのプロセス識別子（1〜31文字）※4

k

メッセージを読み出しているTP1/EEプロセスのDBキューの読み出し状態

N…通常状態

P…障害による読み出し停止の状態

B…DBキューの読み出し停止を受け付けたが，次のトランザクションが動作中

読み出しトランザクション

スキップトランザクション

通番初期化トランザクション

C…コマンド，TP1/EEサービス定義，またはAPI関数による読み出し停止の状態

E…DBの構成不正，またはDBキューの内容矛盾のため使用できない状態

R…リソースマネジャと未接続のため使用できない状態

U…状態不明（次のどれかが発生）

情報照会処理が時間切れ

対象のDBキューを読み出し中

サーバが存在しない

情報照会処理が失敗

情報照会処理の実行後に読み出しサーバの変更を検知

なお，次の場合は「N」を表示します。

DBキューの読み出し状態が読み出し停止中でも，次の場合にメッセージを読み出しているTP1/EEプロセスがDBキュー関連定義のdbqgrpdef定義コマンドの-gオプションに指定したプロセスと異なっているとき

・DBキュー関連定義のdbqgrpdef定義コマンドの-kオプションに0を指定している

・メッセージを読み出しているTP1/EEプロセスのバージョンが07-80より前

メッセージを読み出しているTP1/EEプロセスが存在しない場合

l

DBキューのステータス

W…書き込み可能の状態

P…書き込み抑止の状態

DBキューの読み出し状態がEまたはRの場合，および，DBアクセスエラーなどによってDBキューのステータスを確認できない場合は，「*」を表示します。

mmmmmmmmmm

書き込み通番（10進数10けた）※2，※5

nnnnnnnnnn

読み出し通番（10進数10けた）※2，※5

oooooooooo

最大書き込みメッセージ数（10進数10けた）

pppppppppp

未読み出しメッセージ数（10進数10けた）※2，※5

qq....qq

DBキュー種別※1

UAP…AP間通信をするDBキュー

USER…ユーザキューアクセスをするDBキュー

rr....rr

DBキュー属性（16進数8けた）※1

DBキューに付与した属性を論理和で表示します。

00000000…付与した属性がありません

00000001…上書き抑止属性

00000002…通番初期化属性

00000004…データ連携支援書き込み属性

00000008…交替用メッセージ表書き込み機能を使用

********…DBキュー属性未サポート（バージョン07-80よりも前のバージョン，またはTP1/EE以外のシステムで作成された）

ss....ss

該当するDBキューの読み出しを行うTP1/EEプロセスのTP1/Server Baseのノード識別子※1，※2，※5

次の条件がすべて成り立つ場合に表示します。

該当するDBキューの読み出しを行うサーバの基盤種別がTP1/EE

該当するDBキューの読み出しを行うTP1/EEプロセスでネーム機能が有効

該当するDBキューの読み出しを行うTP1/EEプロセスのTP1/EEバージョンが07-80以降

TP1/Server Baseのノード識別子を表示しない場合は，「*」を表示します。

y

DBキュー書き込み禁止ステータス

W…書き込み可能の状態

P…書き込み抑止の状態

t

DBキュー交替用メッセージ表書き込み機能使用時のee_dbq_msgpu関数実行時にメッセージを書き込む表を表示します。

N…通常のメッセージ表に書き込みます。通常のメッセージ表の更新で障害が発生した場合は，交替用メッセージ表に書き込みます。

A…交替用メッセージ表に書き込みます。

*…DBキュー交替用メッセージ表書き込み機能未使用

u

DBキュー交替用メッセージ表書き込み機能使用時のメッセージを入力※6する表を表示します。

N…通常のメッセージ表から入力します。通常のメッセージ表からの入力で障害が発生するか，通常のメッセージ表にメッセージが書き込まれていなければ交替用メッセージ表から入力します。

A…交替用メッセージ表から入力します。交替用メッセージ表からの入力で障害が発生するか，交替用メッセージ表にメッセージが書き込まれていなければ通常のメッセージ表から入力します。

*…DBキュー交替用メッセージ表書き込み機能未使用

注※1

DBキュー機能関連定義のdbqgrpdef定義コマンドの-kオプションに1を指定した場合に出力されます。

注※2

DBアクセスエラーが発生した場合は，「*」を表示します。

注※3

DBキュー機能関連定義のdbqgrpdef定義コマンドの-fオプションの指定を省略した場合に出力されます。

注※4

DBキュー機能関連定義のdbqgrpdef定義コマンドに-fオプションを指定した場合に出力されます。

注※5

DBキューの読み出し状態が次の場合は，「*」を表示します。

・E：DBの構成不正，またはDBキューの内容矛盾による使用不可

・R：リソースマネジャの未接続による使用不可

注※6

メッセージの入力が行われるのは次の契機です。

・UAP間通信用のDBキューにメッセージが書き込まれたとき

・次のどれかのAPI関数が実行されたとき

　ee_dbq_msgget，ee_dbq_msgrefer，ee_dbq_msgrefer2

出力メッセージ

メッセージID

内容

出力先

KFSB95600-E

メモリを確保できません。

標準エラー出力

KFSB95601-E

コマンドの形式が不正です。

標準エラー出力

KFSB95602-E

コマンドのオプションが不正です。

標準エラー出力

KFSB95650-E

TP1/EEプロセスでエラーを検知したため，DBキューコマンドが失敗しました。

標準エラー出力

KFSB95651-E

コマンドプロセスでエラーを検知したため，DBキューコマンドが失敗しました。

標準エラー出力

KFSB95660-I

ヘルプメッセージ

標準出力

eedbqlscs

名称

DBキューサービスとDBキューとの接続状態の表示

形式

eedbqlscs -g サービスグループ名
          -v DBキューサービス名

機能

DBキューサービスとDBキューとの接続状態を表示します。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

状態を表示するTP1/EEプロセスのサービスグループ名を指定します。

●-v　DBキューサービス名　　〜〈1〜31文字の識別子〉

状態を表示するDBキューサービス名を指定します。

出力形式

日本語の出力形式を次に示します。

ＤＢキューサービス名：aa....aa
状態：bbb
接続しているＤＢキュー名
cc....cc※

英語の出力形式を次に示します。

DB queue service name : aa....aa
status : bbb
connection-destination DB queue name
  cc....cc※

注※

接続しているDBキューが複数ある場合は，接続しているDBキュー数分の行が出力されます。接続しているDBキューがない場合は，「なし」を表示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa....aa

DBキューサービス名

bbb

DBキューサービスの状態

ACT…閉塞解除中

DTP…閉塞中

DTC…コマンドによる閉塞中

DTE…永久閉塞中

cc....cc

DBキュー名

出力メッセージ

メッセージID

内容

出力先

KFSB95600-E

メモリを確保できません。

標準エラー出力

KFSB95601-E

コマンドの形式が不正です。

標準エラー出力

KFSB95602-E

コマンドのオプションが不正です。

標準エラー出力

KFSB95603-E

コマンドのオプションの組み合わせが不正です。

標準エラー出力

KFSB95650-E

TP1/EEプロセスでエラーを検知したため，DBキューコマンドが失敗しました。

標準エラー出力

KFSB95651-E

コマンドプロセスでエラーを検知したため，DBキューコマンドが失敗しました。

標準エラー出力

KFSB95670-I

ヘルプメッセージ

標準出力

eedbqlsdq

名称

DBキューの状態，未読み出しメッセージの有無のリスト表示

形式

eedbqlsdq -g サービスグループ名
          -s｛act｜dct｜all｝
          〔-u｛uap｜user｜all｝〕
          〔-m〕

機能

DBキューの状態や，未読み出しメッセージの有無をリスト表示します。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

DBキューの状態をリスト表示するTP1/EEプロセスのサービスグループ名を指定します。

●-s　｛act｜dct｜all｝

リスト表示するDBキューの状態を指定します。

act

読み出し開始状態または読み出し再開始状態のDBキューをリスト表示します。

dct

次の状態のDBキューをリスト表示します。

コマンド，定義，または関数による読み出し停止状態

障害による読み出し停止状態

読み出し停止を受け付けたが，DBキュー読み出しトランザクションまたはスキップトランザクションの実行中

DBの構成不正，またはDBキュー内部矛盾による使用不可状態

リソースマネジャ未接続による使用不可状態

all

状態に関係なくDBキューをリスト表示します。

●-u　｛uap｜user｜all｝　　〜《all》

リスト表示するDBキューの種別を指定します。

uap

UAP間通信をするDBキュー

user

ユーザキューアクセスをするDBキュー

all

UAP間通信をするDBキューとユーザキューアクセスをするDBキュー

●-m

未読み出しメッセージがあるDBキューをリスト表示します。

ただし，次の状態のDBキューは未読み出しメッセージの有無に関係なくリスト表示します。

DBの構成不正，またはDBキュー内部矛盾による使用不可状態

リソースマネジャ未接続による使用不可状態

-mオプションの指定を省略した場合は，未読み出しメッセージの有無に関係なくリスト表示します。

出力形式

日本語の出力形式を次に示します。

状態      :ＤＢキュー名 種別
xxx (y,z) :aa....aa※    bb....bb c

英語の出力形式を次に示します。

status    : DB queue name DB queue type
xxx (y,z) : aa....aa※     bb....bb c

注※

出力対象のDBキューが複数ある場合は，出力対象のDBキュー数分の行が出力されます。出力対象のDBキューがない場合は，「対象のDBキューはありません。」を表示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

xxx

DBキューのステータス1

ACT…読み出し開始状態または読み出し再開始状態

メッセージを読み出しているTP1/EEプロセスが-gオプションに指定したプロセスと異なると，DBキューの読み出し状態が読み出し停止の場合でも「ACT」を表示します。

CME…コマンド実行中に障害が発生した状態

DTB…DBキューの読み出し停止を受け付けたが，メッセージ読み出しトランザクション，またはメッセージの読み出しをスキップするトランザクションが動作中の状態

DTC…コマンド，TP1/EEサービス定義，またはAPI関数による読み出し停止の状態

DTE…DBの構成不正，またはDBキューの内容矛盾のため使用できない状態

DTP…障害による読み出し停止の状態

DTR…リソースマネジャと未接続のため使用できない状態

y

DBキューのステータス2

W…書き込み可能の状態

P…書き込み抑止の状態

xxxがDTE，DTR，CMEの場合，および，DBアクセスエラーなどによってDBキューのステータス2を確認できない場合は，「*」を表示します。

z

DBキュー書き込み禁止ステータス

W…書き込み可能の状態

P…書き込み抑止の状態

aa....aa

DBキュー名

bb....bb

リスト表示するDBキューの種類

UAP…UAP間通信をするDBキュー

USER…ユーザキューアクセスをするDBキュー

c

未読み出しメッセージ数の確認結果

-mオプションを指定した場合，または未読み出しメッセージ数を確認できなかった場合は「*」を出力します。通番の初期化中の場合，未読み出しメッセージ数を確認できません。

未読み出しメッセージ数を確認できた場合，または-mオプションを指定しなかった場合は「*」を出力しません。

出力メッセージ

メッセージID

内容

出力先

KFSB95600-E

メモリを確保できません。

標準エラー出力

KFSB95601-E

コマンドの形式が不正です。

標準エラー出力

KFSB95602-E

コマンドのオプションが不正です。

標準エラー出力

KFSB95650-E

TP1/EEプロセスでエラーを検知したため，DBキューコマンドが失敗しました。

標準エラー出力

KFSB95651-E

コマンドプロセスでエラーを検知したため，DBキューコマンドが失敗しました。

標準エラー出力

KFSB95661-I

ヘルプメッセージ

標準出力

注意事項

コマンド実行中に障害が発生したDBキューは，-sオプションまたは-mオプションの指定に関係なくリスト表示します。

-mオプション指定時に未読み出しメッセージ数を確認できなかった場合は，このコマンドを再実行してください。

eedbqlsqg

名称

DBキューグループのDBキューリストの表示

形式

eedbqlsqg -g サービスグループ名
          -p DBキューグループ名

機能

DBキューグループに属するDBキューのリストを表示します。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

DBキューのリストを表示するTP1/EEプロセスのサービスグループ名を指定します。

●-p　DBキューグループ名　　〜〈1〜31文字の識別子〉

DBキューのリストを表示するDBキューグループ名を指定します。

出力形式

日本語の出力形式を次に示します。

ＤＢキューグループ名：aa....aa
状態  :ＤＢキュー名
xxx (y,z): bb....bb

英語の出力形式を次に示します。

DB queue group name                 : aa....aa
status    : DB queue name
xxx (y,z) : bb....bb

出力形式中の，各変数の意味を次に示します。

変数

意味

aa....aa

DBキューグループ名

xxx

DBキューのステータス1

ACT…読み出し開始状態または読み出し再開始状態

CME…コマンド実行中に障害が発生した状態

DTB…DBキューの読み出し停止を受け付けたけれども，メッセージ読み出しトランザクション，またはメッセージの読み出しをスキップするトランザクションが動作中の状態

DTC…コマンド，TP1/EEサービス定義，またはAPI関数による読み出し停止状態

DTE…DBの構成不正またはDBキューの内容矛盾のため使用できない状態

DTP…障害による読み出し停止状態

DTR…リソースマネジャと未接続のため使用できない状態

xxxの後ろに「*」が表示されている場合，DBキューグループが縮退運転中で，該当するDBキューが書き込み先から除外されていることを示します。

「xxx : bb....bb」は，DBキュー数分出力されます。

y

DBキューのステータス2

W…書き込み可能の状態

P…書き込み抑止の状態

xxxがDTE，DTR，CMEの場合，および，DBアクセスエラーなどによってDBキューのステータス2を確認できない場合は，「*」を表示します。

z

DBキュー書き込み禁止ステータス

W…書き込み可能の状態

P…書き込み抑止の状態

bb....bb

DBキュー名

出力メッセージ

メッセージID

内容

出力先

KFSB95600-E

メモリを確保できません。

標準エラー出力

KFSB95601-E

コマンドの形式が不正です。

標準エラー出力

KFSB95602-E

コマンドのオプションが不正です。

標準エラー出力

KFSB95603-E

コマンドのオプションの組み合わせが不正です。

標準エラー出力

KFSB95620-I

ヘルプメッセージ

標準出力

KFSB95650-E

TP1/EEプロセスでエラーを検知したため，DBキューコマンドが失敗しました。

標準エラー出力

KFSB95651-E

コマンドプロセスでエラーを検知したため，DBキューコマンドが失敗しました。

標準エラー出力

eedbqlssv

名称

DBキューサービスの状態のリスト表示

形式

eedbqlssv -g サービスグループ名
          -s｛act｜dct｜all｝

機能

DBキューサービスの状態をリスト表示します。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

状態をリスト表示するTP1/EEプロセスのサービスグループ名を指定します。

●-s　｛act｜dct｜all｝

リスト表示するDBキューの状態を指定します。

act

閉塞していないDBキューサービスをすべてリスト表示します。

dct

閉塞しているDBキューサービスをすべてリスト表示します。

all

すべてのDBキューサービスをリスト表示します。

出力形式

日本語の出力形式を次に示します。

状態：ＤＢキューサービス名
xxx ：aa....aa※

英語の出力形式を次に示します。

status : DB queue service name
xxx    : aa....aa※

注※

出力対象のDBキューサービスが複数ある場合は，出力対象のDBキューサービス数分の行が出力されます。出力対象のDBキューサービスがない場合は，「対象のDBキューサービスはありません。」を表示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

xxx

DBキューサービスの状態

ACT…閉塞解除中

DTP…閉塞中

DTC…コマンドまたはAPI関数による閉塞中

DTE…永久閉塞中

aa....aa

DBキューサービス名

出力メッセージ

メッセージID

内容

出力先

KFSB95600-E

メモリを確保できません。

標準エラー出力

KFSB95601-E

コマンドの形式が不正です。

標準エラー出力

KFSB95602-E

コマンドのオプションが不正です。

標準エラー出力

KFSB95603-E

コマンドのオプションの組み合わせが不正です。

標準エラー出力

KFSB95650-E

TP1/EEプロセスでエラーを検知したため，DBキューコマンドが失敗しました。

標準エラー出力

KFSB95651-E

コマンドプロセスでエラーを検知したため，DBキューコマンドが失敗しました。

標準エラー出力

KFSB95669-I

ヘルプメッセージ

標準出力

eedbqrels

名称

DBキューとDBキューサービスとの接続解除

形式

eedbqrels -g サービスグループ名
          -q DBキュー名
          -v DBキューサービス名

機能

DBキューとDBキューサービスとの接続を解除します。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

接続を解除するTP1/EEプロセスのサービスグループ名を指定します。

●-q　DBキュー名　　〜〈1〜27文字の識別子〉

接続を解除するDBキュー名を指定します。

●-v　DBキューサービス名　　〜〈1〜31文字の識別子〉

接続を解除するDBキューサービス名を指定します。

出力メッセージ

メッセージID

内容

出力先

KFSB95600-E

メモリを確保できません。

標準エラー出力

KFSB95601-E

コマンドの形式が不正です。

標準エラー出力

KFSB95602-E

コマンドのオプションが不正です。

標準エラー出力

KFSB95631-I

DBキューの接続解除が成功しました。

標準出力

KFSB95650-E

TP1/EEプロセスでエラーを検知したため，DBキューコマンドが失敗しました。

標準エラー出力

KFSB95651-E

コマンドプロセスでエラーを検知したため，DBキューコマンドが失敗しました。

標準エラー出力

KFSB95663-I

ヘルプメッセージ

標準出力

注意事項

指定したDBキューとDBキューサービスとが接続されていない場合，コマンド成功を示すKFSB95631-Iメッセージを出力します。

eedbqrst

名称

DBキューの読み出し再開

形式

eedbqrst -g サービスグループ名
        ｛-q DBキュー名 ｜ -u｛uap｜user｜all｝｝

機能

DBキュー名またはDBキュー種別を指定して，DBキューを読み出し再開状態にします。

DBキュー名は，メッセージを読み出しているTP1/EEプロセスのサービスグループ名を意識しないでDBキューの読み出しを再開したい場合に指定します。

DBキュー種別は，-gオプションで指定したTP1/EEプロセスで読み出しているDBキューを一括で再開したい場合に指定します。また，eedbqstopコマンドで一括停止したDBキューを一括で再開したい場合にも指定します。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

読み出しを再開するTP1/EEプロセスのサービスグループ名を指定します。

●-q　DBキュー名　　〜〈1〜27文字の識別子〉

読み出しを再開するDBキュー名を指定します。

-qオプションに指定したDBキューを読み出しているTP1/EEプロセスが，-gオプションに指定したTP1/EEプロセスと異なる場合，メッセージを読み出しているTP1/EEのバージョン07-80以降，かつDBキューのフォーマットタイプが1であれば，RPC通信でDBキューを読み出し元に関係なく再開します。

●-u　｛uap｜user｜all｝

読み出しを再開する，-gオプションで指定したTP1/EEプロセスで読み出しているDBキューの種別を指定します。

uap

UAP間通信をするDBキュー

user

ユーザキューアクセスをするDBキュー

all

UAP間通信機能を使用するDBキューとユーザキューアクセス機能を使用するDBキュー

出力メッセージ

メッセージID

内容

出力先

KFSB95600-E

メモリを確保できません。

標準エラー出力

KFSB95601-E

コマンドの形式が不正です。

標準エラー出力

KFSB95602-E

コマンドのオプションが不正です。

標準エラー出力

KFSB95633-I

DBキューの読み出しを開始しました。

標準出力

KFSB95650-E

TP1/EEプロセスでエラーを検知したため，DBキューコマンドが失敗しました。

標準エラー出力

KFSB95651-E

コマンドプロセスでエラーを検知したため，DBキューコマンドが失敗しました。

標準エラー出力

KFSB95665-I

ヘルプメッセージ

標準出力

注意事項

指定したDBキューがすでに読み出し再開状態の場合，コマンド成功を示すKFSB95633-Iメッセージを出力します。

DBキュー機能関連定義のdbqgrpdef定義コマンドの-kオプションに1を指定したDBキューに対してeedbqrstコマンドを実行した場合，DBキューのステータスが他サーバ読み出しのときでも，コマンド成功を示すKFSB95633-Iメッセージを出力することがあります。

次に示す条件を満たす場合，DBキュー読み出し先サーバ変更機能とこのコマンドが競合すると，コマンド成功を示すKFSB95633-Iメッセージを出力してもDBキューが読み出し再開状態にならないことがあります。

-qオプション指定時にメッセージを読み出しているTP1/EEのバージョンが07-80以降

DBキューのフォーマットタイプが1

eedbqskip

名称

DBキューのメッセージのスキップ

形式

eedbqskip -g サービスグループ名
          -q DBキュー名
        〔-s ｛all｜one｜num｝〕
        〔-n メッセージ読み出し通番〕

機能

DBキューのメッセージを指定された分だけ読み出し済みにします。

eedbqskipコマンドは，次の条件をすべて満たしている場合に実行できます。条件を満たしていない場合はエラーとなります。

コマンドを実行するサーバが，DBキューから読み出すサーバである。

読み出し停止状態である。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

メッセージをスキップするTP1/EEプロセスのサービスグループ名を指定します。

●-q　DBキュー名　　〜〈1〜27文字の識別子〉

メッセージをスキップするDBキュー名を指定します。

●-s　｛all｜one｜num｝　　〜《one》

スキップするメッセージを指定します。

all

書き込み通番のメッセージまで読み出し済みにします。

one

1メッセージだけ読み出し済みにします。

num

指定された通番のメッセージまで読み出し済みにします。

●-n　メッセージ読み出し通番　　〜((1〜2147483647))

読み出し済みにしたいメッセージの読み出し通番を指定します。

-sオプションにnumを指定したときだけ指定できます。

出力メッセージ

メッセージID

内容

出力先

KFSB95600-E

メモリを確保できません。

標準エラー出力

KFSB95601-E

コマンドの形式が不正です。

標準エラー出力

KFSB95602-E

コマンドのオプションが不正です。

標準エラー出力

KFSB95603-E

コマンドのオプションの組み合わせが不正です。

標準エラー出力

KFSB95634-I

DBキューの読み出し通番スキップを受け付けました。

標準出力

KFSB95650-E

TP1/EEプロセスでエラーを検知したため，DBキューコマンドが失敗しました。

標準エラー出力

KFSB95651-E

コマンドプロセスでエラーを検知したため，DBキューコマンドが失敗しました。

標準エラー出力

KFSB95666-I

ヘルプメッセージ

標準出力

注意事項

スキップの処理中（コミットされるまで）は，別のスキップは受け付けません。

eedbqskipコマンドは，該当するDBキューが読み出し停止の状態（コマンド，TP1/EEサービス定義，API関数で指定するか，または障害発生による）にある場合だけ実行できます。

メッセージ読み出し通番は，コミット時に更新されます。

eedbqstop

名称

DBキューの読み出し停止

形式

eedbqstop -g サービスグループ名
          ｛-q DBキュー名 ｜ -u｛uap｜user｜all｝｝

機能

DBキュー名またはDBキュー種別を指定して，DBキューを読み出し停止状態にします。

DBキュー名は，メッセージを読み出しているTP1/EEプロセスのサービスグループ名を意識しないでDBキューの読み出しを停止したい場合に指定します。

DBキュー種別は，-gオプションで指定したTP1/EEプロセスで読み出しているDBキューを一括で停止したい場合に指定します。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

読み出しを停止するTP1/EEプロセスのサービスグループ名を指定します。

●-q　DBキュー名　　〜〈1〜27文字の識別子〉

読み出しを停止するDBキュー名を指定します。

-qオプションに指定したDBキューを読み出しているTP1/EEプロセスが，-gオプションに指定したTP1/EEプロセスと異なる場合，メッセージを読み出しているTP1/EEのバージョンが07-80以降，かつDBキューのフォーマットタイプが1であれば，RPC通信でDBキューを読み出し元に関係なく停止します。

●-u　｛uap｜user｜all｝

読み出しを停止する，-gオプションで指定したTP1/EEプロセスで読み出しているDBキューの種別を指定します。

uap

UAP間通信をするDBキュー

user

ユーザキューアクセスをするDBキュー

all

UAP間通信機能を使用するDBキューとユーザキューアクセス機能を使用するDBキュー

出力メッセージ

メッセージID

内容

出力先

KFSB95600-E

メモリを確保できません。

標準エラー出力

KFSB95601-E

コマンドの形式が不正です。

標準エラー出力

KFSB95602-E

コマンドのオプションが不正です。

標準エラー出力

KFSB95632-I

DBキューの読み出しを停止しました。

標準出力

KFSB95650-E

TP1/EEプロセスでエラーを検知したため，DBキューコマンドが失敗しました。

標準エラー出力

KFSB95651-E

コマンドプロセスでエラーを検知したため，DBキューコマンドが失敗しました。

標準エラー出力

KFSB95664-I

ヘルプメッセージ

標準出力

注意事項

指定したDBキューがすでに読み出し停止状態の場合，コマンド成功を示すKFSB95632-Iメッセージを出力します。

DBキュー機能関連定義のdbqgrpdef定義コマンドの-kオプションに1を指定したDBキューに対してeedbqstopコマンドを実行した場合，DBキューのステータスが他サーバ読み出しのときでも，コマンド成功を示すKFSB95632-Iメッセージを出力することがあります。

次に示す条件を満たす場合，DBキュー読み出し先サーバ変更機能とこのコマンドが競合すると，コマンド成功を示すKFSB95632-Iメッセージを出力してもDBキューが読み出し停止にならないことがあります。

-qオプション指定時にメッセージを読み出しているTP1/EEのバージョンが07-80以降

DBキューのフォーマットタイプが1

eedbqtblh

名称

HiRDB用のDBキュー表の作成または削除

形式

DBキュー表を作成する場合と削除する場合で，指定できるオプションが異なります。

DBキュー表を作成する場合

eedbqtblh -q DBキュー名
        〔-z 最大メッセージ長〕
        〔-c 最大書き込みメッセージ数〕
        ｛〔-b RDエリア名〕
         |〔-m メッセージ表RDエリア名〕
          〔-M メッセージ表INDEXのRDエリア名〕
          〔-n 交替用メッセージ表RDエリア名〕
          〔-N 交替用メッセージ表INDEXのRDエリア名〕
          〔-p その他の表のRDエリア名〕｝
        〔-o 同期点行数〕
        〔-a DBキューの属性〕

DBキュー表を削除する場合

eedbqtblh -q DBキュー名
          -r ｛nochk|chk｝

機能

HiRDB上にDBキュー表を作成または削除します。

オプション

●-q　DBキュー名　　〜〈1〜27文字の英大識別子〉

表を作成または削除するDBキュー名を，英字の大文字で指定します。小文字が含まれている場合は，エラーになります。

●-z　最大メッセージ長　　〜〈符号なし整数〉((1000〜8388608))《33000》（単位：バイト）

DBキューで使用するメッセージの最大サイズを指定します。

データ連携支援の反映処理の書き込み先として使用する場合，反映処理するデータサイズがこの指定値を超過すると，データ連携支援を中断します。

●-c　最大書き込みメッセージ数　　〜〈符号なし整数〉((1〜2147483647))《1000》

DBキューに書き込む最大メッセージ数を指定します。

-cオプションには，DBキュー機能関連定義のdbqdef定義コマンドの-lオプションの指定値と同じ値を指定してください。-cオプションの指定値がdbqdef定義コマンドの-lオプションの指定値と異なる場合は，eedbqtblhコマンドで指定したDBキューが，TP1/EE起動時に永久閉塞します。

●-b　RDエリア名　　〜〈1〜30文字の文字列〉

DBキュー表を格納するHiRDB上のRDエリア名を指定します。

このオプションを指定するとDBキューの各表とINDEXは，すべてこのオプションで指定したRDエリアに格納します。RDエリア名に空白を含む場合は引用符「"」で囲んでください。指定したRDエリア名は，引用符の有無に関係なく大文字と小文字が区別されます。

-b，-m，-M，-n，-N，-pオプションをすべて省略すると，格納するRDエリアをHiRDBが自動決定します。

HiRDBのユティリティの詳細についてはマニュアル「HiRDB コマンドリファレンス」を，HiRDBが決定するRDエリアについてはマニュアル「HiRDB SQLリファレンス」を参照してください。

●-m　メッセージ表RDエリア名　　〜〈1〜30文字の文字列〉

メッセージ表を格納するHiRDB上のRDエリアを指定します。RDエリアに空白を含む場合は引用符「"」で囲んでください。指定したRDエリア名は引用符の有無に関係なく大文字と小文字が区別されます。

このオプションと-bオプションを省略するとメッセージ表を格納するRDエリアをHiRDBが自動決定します。

●-M　メッセージ表INDEXのRDエリア名　　〜〈1〜30文字の文字列〉

メッセージ表のINDEXを格納するHiRDB上のRDエリアを指定します。

RDエリアに空白を含む場合は引用符「"」で囲んでください。指定したRDエリア名は引用符の有無に関係なく大文字と小文字が区別されます。

このオプションと-bオプションを省略するとメッセージ表のINDEXを格納するRDエリアをHiRDBが自動決定します。

●-n　交替用メッセージ表のRDエリア名　　〜〈1〜30文字の文字列〉

交替用メッセージ表を格納するHiRDB上のRDエリアを指定します。RDエリアに空白を含む場合は引用符「"」で囲んでください。指定したRDエリア名は引用符の有無に関係なく大文字と小文字が区別されます。

このオプションと-bオプションを省略すると交替用メッセージ表を格納するRDエリアをHiRDBが自動決定します。

-aオプションで，交替用メッセージ表書き込み機能を使用する属性を付与しなかった場合にこのオプションを指定すると，このコマンドはKFSB95651-Eを出力して異常終了します。

●-N　交替用メッセージ表INDEXのRDエリア名　　〜〈1〜30文字の文字列〉

メッセージ表INDEXを格納するHiRDB上のRDエリアを指定します。RDエリアに空白を含む場合は引用符「"」で囲んでください。指定したRDエリア名は引用符の有無に関係なく大文字と小文字が区別されます。

このオプションと-bオプションを省略すると交替用メッセージ表INDEXを格納するRDエリアをHiRDBが自動決定します。

-aオプションで，交替用メッセージ表書き込み機能を使用する属性を付与しなかった場合にこのオプションを指定すると，このコマンドはKFSB95651-Eを出力して異常終了します。

●-p　その他の表のRDエリア名　　〜〈1〜30文字の文字列〉

ライト管理表，リード管理表，およびデータ連携支援引き継ぎ情報表を格納するHiRDB上のRDエリアを指定します。RDエリアに空白を含む場合は引用符「"」で囲んでください。指定したRDエリア名は引用符の有無に関係なく大文字と小文字が区別されます。

このオプションと-bオプションを省略するとライト管理表，リード管理表，およびデータ連携支援引き継ぎ情報表を格納するRDエリアをHiRDBが自動決定します。

●-o　同期点行数　　〜〈符号なし整数〉((1〜1000))《100》（単位：10000行）

トランザクションを決着させる区切りとなる，DBキュー表への追加行数を指定します。

DBキューのメッセージ管理表および交替用メッセージ表の作成時に，-cオプションに指定された最大書き込みメッセージ数分の行を追加します。1トランザクションで多数の行を追加すると，HiRDBのジャーナルログが満杯になるなどの現象が発生し，eedbqtblhコマンドが失敗するおそれがあります。そこで，ジャーナルログが満杯になるなどの現象を回避するために，DBキュー表に追加した行数が，-oオプションの指定値に達するごとに，トランザクションを決着させる必要があります。

●-a　DBキューの属性　　〜〈1文字の16進数〉((0，2，3，4，6，7，8，a，b，c，e，f))《0》

DBキューに付与する属性を指定します。複数の属性を付与する場合は，論理和で指定します。このオプションを省略すると，DBキューに属性を付与しません。

0

DBキューに属性を付与しません。

1

上書き抑止属性を付与します。この属性を付与すると，書き込むメッセージ数が最大メッセージ数を超えた場合に，読み出し済みのメッセージがあっても上書きしません。書き込むメッセージ数が最大メッセージ数を超えた場合，この属性を付与しないと読み出し済みのメッセージを上書きます。

上書き抑止属性を付与する場合は，通番初期化属性も付与してください。

2

通番初期化属性を付与します。この属性を付与すると，eedbqclrコマンド，eedbqclrhコマンド，およびee_dbq_clear関数を使用してDBキューの通番を初期化します。この属性を付与しないと通番は初期化できません。

4

データ連携支援書き込み属性を付与します。この属性を付与すると，TP1/FSPデータ連携支援の反映処理の書き込み先として使用できます。

8

交替用メッセージ表書き込み機能を使用する属性を付与します。この属性を付与すると，交替用メッセージ表を作成し，メッセージ表の書き込みで障害が発生した場合に交替用メッセージ表に書き込みます。

●-r　｛nochk｜chk｝

-qオプションで指定したDBキューが使用する表を削除します。

nochk

DBキュー表を削除する前に，未読み出しメッセージの有無をチェックしません。

-qオプションで指定したDBキューの表を強制的に削除します。

chk

DBキュー表を削除する前に，未読み出しメッセージの有無をチェックします。

-qオプションで指定したDBキューに未読み出しメッセージがある場合は，表を削除しません。

-rオプションを指定した場合にnochkまたはchkの指定を省略すると，KFSB95601-Eメッセージを出力します。-rオプション自体の指定を省略した場合，DBキュー表を作成します。

-rオプションは，-q以外のオプションと同時に指定することはできません。

出力メッセージ

メッセージID

内容

出力先

KFSB95600-E

メモリを確保できません。

標準エラー出力

KFSB95601-E

コマンドの形式が不正です。

標準エラー出力

KFSB95602-E

コマンドのオプションが不正です。

標準エラー出力

KFSB95603-E

コマンドのオプションの組み合わせが不正です。

標準エラー出力

KFSB95613-E

DBキュー表の作成または削除に失敗しました（SQLエラー）。

標準エラー出力

KFSB95614-E

未読み出しメッセージがあるため，DBキュー表を削除できません。

標準エラー出力

KFSB95624-I

ヘルプメッセージ

標準出力

KFSB95648-I

DBキュー表の作成または削除に成功しました。

標準出力

KFSB95649-W

DBキュー表を一部削除できませんでした。

標準エラー出力

KFSB95651-E

DBキューコマンドが失敗しました。

標準エラー出力

注意事項

DBキュー表に接続するシステム（TP1/EEなど）が起動中，開始中，または終了中にeedbqtblhコマンドを実行しないでください。DBキュー表に接続するシステム（TP1/EEなど）が起動中，開始中，または終了中にeedbqtblhコマンドを実行した場合，システムの動作は保証しません。

eedbqtblhコマンドは，HiRDBのクライアント環境定義ファイルの指定値によってHiRDBに接続します。したがって，HiRDBのクライアント環境定義ファイル（PDHOST，PDNAMEPORT，およびPDUSER）を設定しておく必要があります。HiRDBのクライアント環境定義ファイルについては，マニュアル「HiRDB UAP開発ガイド」を参照してください。

HiRDBのエラーログファイルを取得してください。HiRDBのエラーログファイルについては，マニュアル「HiRDB UAP開発ガイド」を参照してください。

HiRDBでエラーが発生した場合，TP1/EEのKFSB95613-EメッセージのSQLCODEに，HiRDBのリターンコード※が表示されます。このリターンコードに対応するメッセージIDを基に，X/OpenのTXインタフェースを使用しない場合に作成されるHiRDBのエラーログファイルを参照し，原因を取り除いてください。HiRDBのエラーログファイルについては，マニュアル「HiRDB UAP開発ガイド」を参照してください。

RDエリアは，あらかじめHiRDBのデータベース初期設定ユティリティ（pdinit）で作成，またはデータベース構成変更ユティリティ（pdmod）で追加しておく必要があります。HiRDBのユティリティについては，マニュアル「HiRDB コマンドリファレンス」を参照してください。

-bオプションにHiRDBのデータベース初期設定ユティリティ（pdinit）で作成，またはデータベース構成変更ユティリティ（pdmod）で追加したRDエリアのRDエリア名以外を指定した場合，コマンド失敗となります。また，KFSB95613-EメッセージのHiRDBリターンコード※の内容は「RDエリアがない」または「SQL文誤り」などの意味になります。HiRDBのユティリティについては，マニュアル「HiRDB コマンドリファレンス」を参照してください。

-oオプションに小さな値を指定した場合，ジャーナルログが満杯になる現象の発生頻度は低くなりますが，HiRDBの同期点処理が頻繁に発生するためオーバヘッドが大きくなります。-oオプションに大きな値を指定した場合，オーバヘッドは少なくなりますが，ジャーナルログが満杯になるなどの現象の発生頻度は高くなります。

-oオプションに最小値の1（10000行）を指定しても，HiRDBのジャーナルログが満杯や通信エラーなどになる場合は，HiRDBのジャーナルログのサイズなどを見直してください。HiRDBのジャーナルログについては，マニュアル「HiRDB システム導入・設計ガイド」を参照してください。

DBキュー表を作成する場合で，eedbqtblhコマンドに指定したDBキューに対応するDBキュー表がすでに存在するときは，-rオプションを指定したeedbqtblhコマンドを実行していったん表を削除してください。表の削除後，eedbqtblhコマンドを実行して表を再作成してください。

eedbqtblhコマンドの実行中にHiRDBの障害などが発生した場合，作成途中のDBキュー表を削除してコマンド処理を終了します。表の削除は，HiRDBの障害などによって失敗することがあります。表の削除に失敗した場合は，HiRDBの障害などを取り除いたあとに，表の作成に失敗したDBキュー名を-qオプションに指定し，-rオプションを指定したeedbqtblhコマンドを実行していったん表を削除してください。表の削除後，eedbqtblhコマンドを実行して表を再作成してください。

-rオプションにchkを指定してコマンドが失敗し，かつKFSB95613-EメッセージのHiRDBリターンコード※の内容が「表がシステムにない」または「行がない」という意味の場合は，-rオプションにnochkを指定して再度削除してください。

-rオプションにnochkを指定した実行結果がKFSB95649-Wとなり，かつKFSB95613-EメッセージのHiRDBリターンコード※の内容が「表がシステムにない」という意味以外の場合は，エラー要因を取り除いた上で，コマンドを再実行してください。

注※

KFSB95613-EメッセージのSQLCODEに表示されたHiRDBのリターンコードの内容の検索方法については，マニュアル「TP1/Server Base Enterprise Option メッセージ」のKFSB95613-Eメッセージの対策を参照してください。

eedbqtblo

名称

Oracle用のDBキュー表の作成または削除

形式

DBキュー表を作成する場合と削除する場合で，指定できるオプションが異なります。

DBキュー表を作成する場合

eedbqtblo -q DBキュー名
        〔-c 最大メッセージ数〕
        〔-b 表領域名〕
        〔-o 同期点行数〕
          -u ユーザ名とパスワード
        〔-n 接続識別子〕
        〔-T〕

DBキュー表を削除する場合

eedbqtblo -q DBキュー名
          -r ｛nochk|chk｝
          -u ユーザ名とパスワード
        〔-n 接続識別子〕
        〔-T〕

機能

Oracle上にDBキュー表を作成または削除します。

オプション

●-q　DBキュー名　　〜〈1〜27文字の英大識別子〉

表を作成または削除するDBキュー名を，英字の大文字で指定します。小文字が含まれている場合は，エラーになります。

●-c　最大メッセージ数　　〜〈符号なし整数〉((1〜2147483647))《1000》

DBキューに書き込む最大メッセージ数を指定します。

-cオプションには，DBキュー機能関連定義のdbqgrpdef定義コマンドの-lオプションの指定値と同じ値を指定してください。-cオプションの指定値がdbqdef定義コマンドの-lオプションの指定値と異なる場合は，eedbqtbloコマンドで指定したDBキューが，TP1/EE起動時に永久閉塞します。

●-b　表領域名　　〜〈1〜30文字の文字列〉

DBキュー表を格納するOracle上の表領域名を指定します。

表領域名に空白を含む場合は，シングルクォーテーション「'」または引用符「"」で囲んでください。指定した表領域名は，シングルクォーテーションと引用符の有無に関係なく大文字と小文字が区別されます。

-bオプションを省略すると，デフォルトの表領域を使用します。デフォルトの表領域については，Oracleのマニュアルを参照してください。

●-o　同期点行数　　〜〈符号なし整数〉((1〜1000))《100》（単位：10000件）

トランザクションを決着させる区切りとなる，DBキュー表への追加行数を指定します。

DBキューのメッセージ管理表の作成時に，-cオプションに指定された最大メッセージ数分の行を追加します。1トランザクションで多数の行を追加すると，OracleのUNDO表領域が不足したり，REDOログが満杯になったりするなどの現象が発生し，eedbqtbloコマンドが失敗するおそれがあります。そこで，これらの現象を回避するために，DBキュー表に追加した行数が，-oオプションの指定値に達するごとに，トランザクションを決着させる必要があります。

●-u　ユーザ名とパスワード　　〜〈1〜65文字の文字列〉

Oracleにログインするためのユーザ名とパスワードを指定します。

ユーザ名とパスワードの間はスラント「/」で区切ってください。ユーザ名およびパスワードに引用識別子（引用符「"」で囲んだ識別子）を使用する場合は，シングルクォーテーション「'」で囲んでください。詳細については，Oracleのマニュアルを参照してください。

●-n　接続識別子　　〜〈1〜1024文字の文字列〉

Oracleに接続するための接続識別子を指定します。

接続識別子に空白を含む場合は，シングルクォーテーション「'」または引用符「"」で囲んでください。

接続識別子に引用符「"」を使用する場合は，シングルクォーテーション「'」で囲んでください。接続識別子にシングルクォーテーション「'」を使用する場合は，引用符「"」で囲んでください。

-nオプションを省略すると，デフォルトのデータベースと接続します。接続識別子の詳細については，Oracleのマニュアルを参照してください。

●-T

eedbqtbloコマンドの実行中にOracleのSQLトレース機能を使用します。

このオプションを使用するためには，-uオプションで指定したユーザにALTER SESSIONシステム権限が必要です。

-Tオプションを省略すると，Oracle初期化パラメタSQL_TRACEの値によってSQLトレース機能を使用するかどうかが決まります。

SQLトレース機能，Oracle初期化パラメタ，ALTER SESSIONシステム権限の詳細については，Oracleのマニュアルを参照してください。

●-r　｛nochk｜chk｝

-qオプションで指定したDBキューが使用する表を削除します。

nochk

DBキュー表を削除する前に，未読み出しメッセージの有無をチェックしません。

-qオプションで指定したDBキューの表を強制的に削除します。

chk

DBキュー表を削除する前に，未読み出しメッセージの有無をチェックします。

-qオプションで指定したDBキューに未読み出しメッセージがある場合は，表を削除しません。

-rオプションを指定した場合にnochkまたはchkの指定を省略すると，KFSB95601-Eメッセージを出力します。-rオプション自体の指定を省略した場合，DBキュー表を作成します。

出力メッセージ

メッセージID

内容

出力先

KFSB95600-E

メモリを確保できません。

標準エラー出力

KFSB95601-E

コマンドの形式が不正です。

標準エラー出力

KFSB95602-E

コマンドのオプションが不正です。

標準エラー出力

KFSB95603-E

コマンドのオプションの組み合わせが不正です。

標準エラー出力

KFSB95614-E

未読み出しメッセージがあるため，DBキュー表を削除できません。

標準エラー出力

KFSB95616-E

コマンド処理でエラーが発生しました。

標準エラー出力

KFSB95625-I

ヘルプメッセージ

標準出力

KFSB95648-I

DBキュー表の作成または削除に成功しました。

標準出力

KFSB95649-W

DBキュー表を一部削除できませんでした。

標準エラー出力

注意事項

DBキュー表に接続するシステム（TP1/EEなど）が起動中，開始中，または終了中にeedbqtbloコマンドを実行しないでください。DBキュー表に接続するシステム（TP1/EEなど）が起動中，開始中，または終了中にeedbqtbloコマンドを実行した場合，システムの動作は保証しません。

Oracleの環境変数ORACLE_HOMEを定義してください。また，LIBPATH（Linuxの場合はLD_LIBRARY_PATH）にOracleのライブラリパスを定義してください。指定する値については，Oracleのマニュアルを参照してください。

-oオプションに小さな値を指定した場合，OracleのUNDO表領域が不足したり，REDOログが満杯になったりする現象の発生頻度は低くなりますが，Oracleの同期点処理が頻繁に発生するためオーバヘッドが大きくなります。-oオプションに大きな値を指定した場合，オーバヘッドは少なくなりますが，OracleのUNDO表領域が不足したり，REDOログが満杯になったりするなどの現象の発生頻度は高くなります。

-oオプションに最小値の1（10000行）を指定しても，OracleのUNDO表領域が不足したり，REDOログが満杯になったりする場合は，OracleのUNDO表領域のサイズおよびREDOログのサイズを増やしてください。

DBキュー表を作成する場合で，eedbqtbloコマンドに指定するDBキューに対応するDBキュー表がすでに存在するときは，-rオプションを指定したeedbqtbloコマンドを実行していったん表を削除してください。表の削除後，eedbqtbloコマンドを実行して表を再作成してください。

eedbqtbloコマンドの実行中にOracleの障害などが発生した場合に，DBキュー表の作成が途中で失敗したときは，eedbqtbloコマンドがDBキュー表を削除してコマンド処理を終了します。表の削除は，Oracleの障害などによって失敗することがあります。表の削除に失敗した場合は，Oracleの障害などを取り除いたあとに，表の作成に失敗したDBキュー名を-qオプションに指定し，-rオプションにnochkを指定したeedbqtbloコマンドを実行していったん表を削除してください。表の削除後，eedbqtbloコマンドを実行して表を再作成してください。

-rオプションにchkを指定してコマンドが失敗し，かつKFSB95616-EメッセージのOracleメッセージの内容が「表またはビューが存在しない」または「データが見つからない」という意味の場合は，-rオプションにnochkを指定して再度削除してください。

-rオプションにnochkを指定した実行結果がKFSB95649-Wとなり，かつKFSB95616-EメッセージのOracleメッセージの内容が「表またはビューが存在しない」という意味以外の場合は，エラー要因を取り除いた上で，コマンドを再実行してください。

eedbqwtpr

名称

DBキューの書き込み抑止または抑止解除

形式

eedbqwtpr -g サービスグループ名
          -q DBキュー名 〔-r〕

機能

DBキューへのメッセージの書き込み抑止または書き込み抑止の解除をします。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

DBキューへのメッセージの書き込みを抑止するTP1/EEプロセスのサービスグループ名を指定します。

●-q　DBキュー名　　〜〈1〜27文字の識別子〉

DBキューへのメッセージの書き込みを抑止するDBキュー名を指定します。

●-r

DBキューへのメッセージの書き込み抑止を解除します。

出力メッセージ

メッセージID

内容

出力先

KFSB95600-E

メモリを確保できません。

標準エラー出力

KFSB95601-E

コマンドの形式が不正です。

標準エラー出力

KFSB95602-E

コマンドのオプションが不正です。

標準エラー出力

KFSB95623-I

ヘルプメッセージ

標準出力

KFSB95647-I

コマンドが成功しました。

標準出力

KFSB95650-E

TP1/EEプロセスでエラーを検知したため，DBキューコマンドが失敗しました。

標準エラー出力

KFSB95651-E

コマンドプロセスでエラーを検知したため，DBキューコマンドが失敗しました。

標準エラー出力

KFSB95653-E

TP1/EEプロセスでエラーを検知したため，DBキューコマンドが失敗しました。

標準エラー出力

注意事項

eedbqwtprコマンドは，DBキュー機能オプションがTYPE1のDBキューグループのDBキューに対して実行できます。DBキュー機能オプションは，DBキュー機能関連定義のdbqgrpdef定義コマンドの-kオプションで指定します。

次に示す場合は，コマンド成功を示すKFSB95647-Iメッセージを出力します。

メッセージの書き込みを抑止しているDBキューに対してeedbqwtprコマンドを実行して，書き込み抑止を指示した場合

メッセージの書き込み可能状態のDBキューに対して，-rオプションを指定したeedbqwtprコマンドを実行して，書き込み抑止の解除を指示した場合

理由コード0024を付加したKFSB95650-Eメッセージが出力された場合は，eedbqlsコマンドを実行してDBキューの状態を確認してください。書き込み抑止の状態または書き込み可能の状態になっていない場合は，eedbqwtprコマンドを再実行してください。

eedctsv

名称

サービスの閉塞

形式

eedctsv -g サービスグループ名
        -v サービス名

機能

サービスを閉塞します。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

閉塞するサービスグループ名を指定します。

●-v　サービス名　　〜〈1〜31文字の識別子〉

閉塞するサービス名を指定します。

出力メッセージ

メッセージID

内容

出力先

KFSB95301-E

コマンドの形式が不正です。

標準エラー出力

KFSB95302-E

フラグ引数が不正です。

標準エラー出力

KFSB95304-E

オプションの組み合わせが不正です。

標準エラー出力

KFSB95305-E

コマンドが失敗しました。

標準エラー出力

KFSB95306-E

領域の確保に失敗しました。

標準エラー出力

KFSB95307-E

内部矛盾が発生しました。

標準エラー出力

KFSB95320-I

ヘルプメッセージ

標準出力

KFSB95321-I

サービスを閉塞しました。

標準出力

KFSB95322-E

サービスの閉塞に失敗しました。

標準エラー出力

注意事項

TP1/FSP（全銀RC）で自動生成するサービスは，このコマンドの対象とすることができません。

eedefchk

名称

TP1/EE稼働前の定義チェック

形式

eedefchk -t ｛syntax｜detail｝ TP1/EEサービス定義ファイル名

機能

コマンド引数で指定したTP1/EEサービス定義ファイルの定義内容をチェックし，該当する定義でTP1/EEを稼働できるかどうかを判定します。また，コマンドのオプションで指定するチェックレベルで，チェックする内容を選択できます。

TP1/EEの定義に加え，TP1/EEサービス定義ファイルに設定する関連製品（XTCおよびTP1/FSP）の定義の内容もチェック対象となります。MCP構成定義やOBM構成定義など，TP1/EEサービス定義ファイルとは別のファイルに設定する定義は，チェック対象となりません。OBM構成定義については，TP1/FSPの関連ドキュメントを参照してください。

オプション

●-t ｛syntax｜detail｝

チェックレベルを指定します。

syntax

定義構文チェックをします。

定義構文チェックでは，定義の記述のフォーマットチェック，指定値の範囲チェック，必ず指定する値の有無チェック，およびオペランドの二重定義チェックをします。

detail

定義詳細チェックをします。

定義詳細チェックでは，定義構文チェックで実行するチェック内容に加えて，定義の指定値間の詳細な論理チェックを実行し，メモリ領域を確保します。また，定義の内容に基づいて実際に確保したメモリ領域のサイズに共用ワーク領域分のサイズを足した値を表示します。

コマンド引数

●TP1/EEサービス定義ファイル名　　〜〈1023文字以内のパス名〉

チェック対象となるTP1/EEサービス定義ファイル名を指定します。

出力形式

コマンドを実行したTP1/EEのバージョンを表示するメッセージを標準出力に出力します。その後，チェック結果をメッセージとして標準出力に出力します。チェック結果を表示するメッセージは，TP1/EE初期化中の定義チェック処理で出力されるメッセージと同じです。チェック結果のメッセージの対策が「TP1/EEを再起動してください」の場合は，「eedefchkコマンドを再実行してください」と読み替えてください。

出力メッセージ

メッセージID

内容

出力先

KFSB91801-E

コマンドの形式が不正です。

標準エラー出力

KFSB91802-E

フラグ引数が不正です。

標準エラー出力

KFSB91805-E

内部矛盾が発生しました。

標準エラー出力

KFSB91806-E

領域の確保に失敗しました。

標準エラー出力

KFSB91807-E

コマンド実行中にエラーが発生しました。

標準エラー出力

KFSB91853-I

ヘルプメッセージ

標準出力

KFSB91854-I

定義チェック処理を終了します。

標準出力

KFSB91855-I

定義チェック処理を開始します。

標準出力

KFSB91856-I

定義チェック処理を終了します。

標準出力

注意事項

定義構文チェックを実行する場合は，定義ファイルのほかに次に示す準備が必要です。

環境変数DCDIRの設定

TP1/EEのインストール

定義詳細チェックを実行する場合は，定義ファイルのほかに次に示す準備が必要です。

環境変数DCDIRの設定

TP1/EEのインストール

メモリ関連定義のmax_mem_sizeオペランドで指定したサイズの空きメモリの確保

UAP共用ライブラリの作成（プロセス関連定義のfsp_useオペランドにYを指定した場合は，UAP共用ライブラリ格納ディレクトリ）

定義詳細チェックでは，メモリ関連定義のmax_mem_sizeオペランドに指定したサイズのメモリを実際に使用します。max_mem_sizeオペランドで指定したサイズのメモリを確保できない環境の場合は，ulimitコマンドまたは環境変数LDR_CNTRLを使用してリソースの使用制限を変更してください。

本番用のメモリ関連定義のmax_mem_sizeオペランドには，定義詳細チェックで得られたメモリサイズ以上の値を指定してください。

eedefchkコマンドでは，次に示すシステム構成物との整合性はチェックしません。

TP1/EEの実行形式ファイル

UAP共用ライブラリ（UAP共用ライブラリの存在確認チェック以外）

ステータスファイル

関連するソフトウェア製品の構成およびインストール状況

データベースのテーブル構成

eedefchkコマンドでは，次に示す定義内容の整合性はチェックしません。

トラブルシュート関連定義のtrb_stc_sys_kindオペランドにdbqを指定してDBキュー情報を取得する場合，またはtrb_stc_ext_kindオペランドにedbqを指定してDBキュー統計情報を取得する場合に，前提となる定義（プロセス関連定義のdbq_useオペランドにYを指定）が指定されているかどうか

トラブルシュート関連定義のtrb_stc_ext_kindオペランドにeobsを指定してオンラインバッチ統計情報を取得する場合に，前提となる定義（プロセス関連定義のdbq_obs_useオペランドにYを指定）が指定されているかどうか

DBキュー機能関連定義のdbqgrpdef定義コマンドで指定したサービスグループ名が，サービスグループ情報関連定義のeesvgdef定義コマンドで指定したサービスグループ名のどれかと一致するかどうか

eefilbkup

名称

TP1EEファイルシステムのバックアップ

形式

eefilbkup 〔-y〕 〔-r〕 〔-i〕 〔-｛c｜l｜f｝〕
           TP1EEファイルシステム領域名〔/TP1EEファイル名〕
           バックアップファイル名

機能

TP1EEファイルシステムをバックアップします。このとき，TP1EEファイルの属性もバックアップします。バックアップ用のファイルには一つのTP1EEファイルシステムだけをバックアップできます。複数のTP1EEファイルシステムをバックアップしたい場合は，バックアップしたいTP1EEファイルシステムの数だけファイルが必要です。

eefilbkupコマンドを実行できるのは，スーパユーザおよびTP1EEファイルシステムを初期設定するユーザだけです。

eefilbkupコマンドは，TP1EEファイルシステムをバックアップする前にユーザに確認を求めますが，-yオプションを指定すると，確認を求めないですぐにバックアップできます。

バックアップしたTP1EEファイルシステムは，eefilrstrコマンドでリストアできます。

オプション

●-y

ユーザに確認しないで，すぐにTP1EEファイルシステムをバックアップします。

-yオプションの指定を省略すると，ユーザに確認してからTP1EEファイルシステムをバックアップします。

●-r

バックアップ先ファイルがすでにある場合，そのファイルを削除して，新しくバックアップ先ファイルを作成します。

-rオプションの指定を省略すると，バックアップ先ファイルがすでにある場合，eefilbkupコマンドはエラー終了します。

●-i

TP1EEファイルの読み出し中にエラーが発生した場合，そのファイルのバックアップを中止して，次のファイルから再び読み出します。なお，エラーが発生したファイルの残りのエリアはクリアされます。

-iオプションの指定を省略すると，TP1EEファイルの読み出し中にエラーが発生した場合，eefilbkupコマンドはエラー終了し，エラーメッセージが出力されます。

●-｛c｜l｜f｝

指定を省略すると，-cが仮定されます。

-c

指定したTP1EEファイルシステム中のTP1EEファイルを他プロセス，または他ユーザが使用中の場合，TP1EEファイルシステムをバックアップしません。

-l

指定したTP1EEファイルシステム中のTP1EEファイルを他プロセス，または他ユーザが使用中の場合，使用中のTP1EEファイルについてはバックアップしません。

-f

指定したTP1EEファイルシステム中のTP1EEファイルを他プロセス，または他ユーザが使用中の場合でも，TP1EEファイルシステムを強制的にバックアップします。

コマンド引数

●TP1EEファイルシステム領域名　　〜〈パス名〉

バックアップするTP1EEファイルシステムがあるキャラクタ型スペシャルファイル名，ブロック型スペシャルファイル名，または通常ファイル名を指定します。

●TP1EEファイル名　　〜〈TP1EEファイル名〉

バックアップするTP1EEファイルの名称を指定します。

このコマンド引数を指定すると，指定したTP1EEファイルだけがバックアップされます。

●バックアップファイル名　　〜〈パス名〉

バックアップ先のファイルの名称を指定します。

出力メッセージ

メッセージID

内容

出力先

KFSB91501-I

ヘルプメッセージ

標準出力

KFSB91510-E

バックアップファイル(eefilbkup)がオープンできません。

標準エラー出力

KFSB91511-E

バックアップファイル(eefilbkup)がすでに存在します。

標準エラー出力

KFSB91514-Q

退避を行います。

標準出力

KFSB91516-E

スーパユーザまたはTP1EEファイルシステム初期化ユーザでしか実行できません。

標準エラー出力

KFSB91528-E

TP1EEファイルシステム領域は，他プロセスで使用中のため，処理を中止します。

標準エラー出力

KFSB91529-E

TP1EEファイルは，他プロセスで使用中のため，処理を行いません。

標準エラー出力

KFSB91534-E

フラグ引数が不正です。

標準エラー出力

KFSB91535-E

コマンド引数が不正です。

標準エラー出力

KFSB91536-E

コマンドの形式が不正です。

標準エラー出力

KFSB91537-E

オプションフラグの組み合わせが不正です。

標準エラー出力

KFSB91547-I

コマンドが正常に終了しました。

標準出力

KFSB91548-E

正常に退避されていないTP1EEファイルが存在するため，eefilbkupコマンドが警告終了しました。

標準エラー出力

KFSB91549-E

eefilbkupコマンドでエラーが発生したため，処理を中止しました。

標準エラー出力

KFSB91570-E

バックアップファイルまたはTP1EEファイルシステム領域は，このコマンドで扱うことのできないバージョンです。

標準エラー出力

KFSB91571-E

TP1EEファイルシステム領域に対するアクセス権がありません。

標準エラー出力

KFSB91572-E

TP1EEファイルシステム領域のオープン処理で上限値オーバが報告されました。

標準エラー出力

KFSB91573-E

TP1EEファイルシステム領域が存在しません。

標準エラー出力

KFSB91575-E

ファイルは，TP1EEファイルシステムを構築できるファイルではありません。

標準エラー出力

KFSB91579-E

TP1EEファイルのロックに失敗しました。

標準エラー出力

KFSB91581-E

ファイルでI/Oエラーが発生しました。

標準エラー出力

KFSB91582-E

領域の確保に失敗しました。

標準エラー出力

KFSB91583-E

TP1EEファイルシステム領域でI/Oエラーが発生しました。

標準エラー出力

KFSB91599-E

内部矛盾が発生しました。

標準エラー出力

eefilchgrp

名称

TP1EEファイルグループの変更

形式

eefilchgrp グループ TP1EEファイルシステム領域名/TP1EEファイル名

機能

TP1EEファイルのグループを，指定したOpenTP1グループに変更します。

eefilchgrpコマンドを実行できるのは，スーパユーザ，またはTP1EEファイルの所有者だけです。

コマンド引数

●グループ　　〜〈9文字以内の文字列〉

10進数のグループID，またはグループファイル（/etc/group）にあるグループ名のどれかを指定します。

指定した文字列がすべて数字で，かつその文字列に一致するグループ名が/etc/groupエントリ中にない場合，その文字列を10進数のグループIDと見なします。

●TP1EEファイルシステム領域名　　〜〈パス名〉

TP1EEファイルシステムがあるキャラクタ型スペシャルファイル名，ブロック型スペシャルファイル名，または通常ファイル名を指定します。

●TP1EEファイル名　　〜〈TP1EEファイル名〉

TP1EEファイルの名称を指定します。

出力メッセージ

メッセージID

内容

出力先

KFSB91507-I

ヘルプメッセージ

標準出力

KFSB91533-E

TP1EEファイルは存在しません。

標準エラー出力

KFSB91534-E

フラグ引数が不正です。

標準エラー出力

KFSB91535-E

コマンド引数が不正です。

標準エラー出力

KFSB91536-E

コマンドの形式が不正です。

標準エラー出力

KFSB91541-E

指定したグループ名が存在しません。

標準エラー出力

KFSB91543-E

指定したグループIDが大き過ぎます。

標準エラー出力

KFSB91570-E

バックアップファイルまたはTP1EEファイルシステム領域は，このコマンドで扱うことのできないバージョンです。

標準エラー出力

KFSB91571-E

TP1EEファイルシステム領域に対するアクセス権がありません。

標準エラー出力

KFSB91572-E

TP1EEファイルシステム領域のオープン処理で上限値オーバが報告されました。

標準エラー出力

KFSB91573-E

TP1EEファイルシステム領域が存在しません。

標準エラー出力

KFSB91575-E

TP1EEファイルシステムを構築できるファイルではありません。

標準エラー出力

KFSB91576-E

TP1EEファイルシステムではありません。

標準エラー出力

KFSB91577-E

このコマンドは，スーパユーザまたはTP1EEファイルの所有者だけが実行できます。

標準エラー出力

KFSB91578-E

TP1EEファイルシステムのロックに失敗しました。

標準エラー出力

KFSB91582-E

領域の確保に失敗しました。

標準エラー出力

KFSB91583-E

TP1EEファイルシステム領域でI/Oエラーが発生しました。

標準エラー出力

KFSB91599-E

内部矛盾が発生しました。

標準エラー出力

注意事項

コマンド引数に指定するグループには，9文字以内の文字列を指定してください。

eefilchmod

名称

TP1EEファイルのアクセス許可モードの変更

形式

eefilchmod モード TP1EEファイルシステム領域名/TP1EEファイル名

機能

TP1EEファイルのファイルアクセス許可を，指定したモードに従って変更します。

eefilchmodコマンドを実行できるのは，スーパユーザ，またはTP1EEファイルの所有者です。

コマンド引数

●モード　　〜〈7文字以内の文字列〉

モードは，絶対形式，または記号形式で指定します。モードは7文字以内で指定してください。

絶対形式で指定する場合は，次の表に示した値を組み合わせて指定してください。それ以外の値を指定してコマンドが正常終了した場合は，モードに指定した値とは別のアクセス許可が設定されている可能性があります。

絶対形式

意味

0400

所有者による読み出し権

0200

所有者による書き込み権

0040

グループによる読み出し権

0020

グループによる書き込み権

0004

他者による読み出し権

0002

他者による書き込み権

記号形式で指定する場合，次の形式で指定します。

〔だれに〕操作〔アクセス権〕

だれに：だれに対する許可であるかを指定します。

u…所有者

g…グループ

o…他者

a…所有者，グループ，および他者

この指定を省略すると，aが仮定されます。

操作：どのような操作をするかを指定します。

+…アクセス権を追加

-…アクセス権を削除

=…アクセス権に指定したもの以外を削除

アクセス権：アクセス権を指定します。

r…読み出しを許可

w…書き込みを許可

アクセス権の指定を省略すると，読み出しも書き込みもできません。操作に=を指定したときだけ，アクセス権の指定を省略できます。

●TP1EEファイルシステム領域名　　〜〈パス名〉

TP1EEファイルシステムがあるキャラクタ型スペシャルファイル名，ブロック型スペシャルファイル名，または通常ファイル名を指定します。

●TP1EEファイル名　　〜〈TP1EEファイル名〉

TP1EEファイルの名称を指定します。

指定例

絶対形式で所有者による読み出し権と所有者による書き込み権を指定する場合

eefilchmod 0600 /dev/rdsk/rhd011/tp1ee01

記号形式で所有者による読み出し権と所有者による書き込み権を指定する場合

eefilchmod u+rw /dev/rdsk/rhd011/tp1ee01

出力メッセージ

メッセージID

内容

出力先

KFSB91508-I

ヘルプメッセージ

標準出力

KFSB91533-E

TP1EEファイルは存在しません。

標準エラー出力

KFSB91534-E

フラグ引数が不正です。

標準エラー出力

KFSB91535-E

コマンド引数が不正です。

標準エラー出力

KFSB91536-E

コマンドの形式が不正です。

標準エラー出力

KFSB91538-E

モード引数の指定が不正です。

標準エラー出力

KFSB91570-E

バックアップファイルまたはTP1EEファイルシステム領域は，このコマンドで扱うことのできないバージョンです。

標準エラー出力

KFSB91571-E

TP1EEファイルシステム領域に対するアクセス権がありません。

標準エラー出力

KFSB91572-E

TP1EEファイルシステム領域のオープン処理で上限値オーバが報告されました。

標準エラー出力

KFSB91573-E

TP1EEファイルシステム領域が存在しません。

標準エラー出力

KFSB91575-E

TP1EEファイルシステムを構築できるファイルではありません。

標準エラー出力

KFSB91576-E

TP1EEファイルシステムではありません。

標準エラー出力

KFSB91577-E

このコマンドは，スーパユーザまたはTP1EEファイルの所有者だけが実行できます。

標準エラー出力

KFSB91578-E

TP1EEファイルシステムのロックに失敗しました。

標準エラー出力

KFSB91582-E

領域の確保に失敗しました。

標準エラー出力

KFSB91583-E

TP1EEファイルシステム領域でI/Oエラーが発生しました。

標準エラー出力

KFSB91599-E

内部矛盾が発生しました。

標準エラー出力

eefilchown

名称

TP1EEファイル所有者の変更

形式

eefilchown 所有者 TP1EEファイルシステム領域名/TP1EEファイル名

機能

指定したTP1EEファイルの所有者を変更します。

eefilchownコマンドを実行できるのは，スーパユーザ，またはTP1EEファイルの所有者です。

コマンド引数

●所有者　　〜〈9文字以内の文字列〉

10進数のユーザID，またはパスワードファイル（/etc/passwd）にあるログイン名のどれかを指定します。

指定した文字列がすべて数字で，かつその文字列に一致するログイン名が/etc/passwdエントリ中にない場合，その文字列を10進数のユーザIDと見なします。

●TP1EEファイルシステム領域名　　〜〈パス名〉

TP1EEファイルシステムがあるキャラクタ型スペシャルファイル名，ブロック型スペシャルファイル名，または通常ファイル名を指定します。

●TP1EEファイル名　　〜〈TP1EEファイル名〉

TP1EEファイルの名称を指定します。

出力メッセージ

メッセージID

内容

出力先

KFSB91506-I

ヘルプメッセージ

標準出力

KFSB91533-E

TP1EEファイルは存在しません。

標準エラー出力

KFSB91534-E

フラグ引数が不正です。

標準エラー出力

KFSB91535-E

コマンド引数が不正です。

標準エラー出力

KFSB91536-E

コマンドの形式が不正です。

標準エラー出力

KFSB91540-E

指定したログイン名が存在しません。

標準エラー出力

KFSB91542-E

指定したユーザIDが大き過ぎます。

標準エラー出力

KFSB91570-E

バックアップファイルまたはTP1EEファイルシステム領域は，このコマンドで扱うことのできないバージョンです。

標準エラー出力

KFSB91571-E

TP1EEファイルシステム領域に対するアクセス権がありません。

標準エラー出力

KFSB91572-E

TP1EEファイルシステム領域のオープン処理で上限値オーバが報告されました。

標準エラー出力

KFSB91573-E

TP1EEファイルシステム領域が存在しません。

標準エラー出力

KFSB91575-E

TP1EEファイルシステムを構築できるファイルではありません。

標準エラー出力

KFSB91576-E

TP1EEファイルシステムではありません。

標準エラー出力

KFSB91577-E

このコマンドは，スーパユーザまたはTP1EEファイルの所有者だけが実行できます。

標準エラー出力

KFSB91578-E

TP1EEファイルシステムのロックに失敗しました。

標準エラー出力

KFSB91582-E

領域の確保に失敗しました。

標準エラー出力

KFSB91583-E

TP1EEファイルシステム領域でI/Oエラーが発生しました。

標準エラー出力

KFSB91599-E

内部矛盾が発生しました。

標準エラー出力

注意事項

コマンド引数に指定する所有者には，9文字以内の文字列を指定してください。

eefills

名称

TP1EEファイルシステムの内容表示

形式

eefills｛〔-〔H〕〔L〕〔｛t｜u｝〕〕 TP1EEファイルシステム領域名
         〔/TP1EEファイル名〕|〔-x〕 TP1EEファイルシステム領域名
         〔/TP1EEファイル名〕｝

機能

TP1EEファイルシステムの内容を標準出力に出力します。

コマンド引数にTP1EEファイルシステム領域名だけを指定した場合は，指定したTP1EEファイルシステム内にあるすべてのTP1EEファイルの内容を，TP1EEファイル名のアルファベット順で出力します。コマンド引数にTP1EEファイル名も指定した場合は，指定したTP1EEファイルの内容だけ出力します。

オプション

●-H

表示する情報にヘッダを付けて，ファイル名のアルファベット順に，縦方向に表示します。

●-L

ファイルのロック状態を，ファイル名のアルファベット順に，縦方向に表示します。

●-｛t｜u｝

-t

最終更新日時が最近のものから順に，TP1EEファイルシステムの内容を表示します。

-u

最終アクセス日時が最近のものから順に，TP1EEファイルシステムの内容を表示します。

-Hオプションおよび-Lオプションと，-tオプションまたは-uオプションを同時に指定すると，表示内容の順序は，-tオプションまたは-uオプションの指定が有効になります。

●-x

ファイル名だけをアルファベット順に，横方向に表示します。

すべてのオプションの指定を省略すると，TP1EEファイルシステムの内容がファイル名のアルファベット順に，縦方向に表示されます。

コマンド引数

●TP1EEファイルシステム領域名　　〜〈パス名〉

TP1EEファイルシステムがあるキャラクタ型スペシャルファイル名，ブロック型スペシャルファイル名，または通常ファイル名を指定します。

●TP1EEファイル名　　〜〈TP1EEファイル名〉

TP1EEファイル名を指定します。

出力形式

●-Hオプションを指定した場合

日本語と英語で共通の出力形式を次に示します。

MODE   UID      GID      RSIZE RNUM    TIME              FILE
aabbcc dd....dd ee....ee fffff ggggggg hh....hh          ii....ii

出力形式中の，各変数の意味を次に示します。

変数

意味

aa

所有者に対するアクセス権

r…読み出し権がある

w…書き込み権がある

-…読み出し権，または書き込み権がない

bb

グループに対するアクセス権

r…読み出し権がある

w…書き込み権がある

-…読み出し権，または書き込み権がない

cc

他者に対するアクセス権

r…読み出し権がある

w…書き込み権がある

-…読み出し権，または書き込み権がない

dd....dd

所有者名（9文字以内）

ee....ee

所有者のグループ名（9文字以内）

fffff

レコード長（単位：バイト）

ggggggg

レコード数

hh....hh

最終更新日時

時:分△月日年の形式

ii....ii

TP1EEファイル名

●-Hオプションと-Lオプションを指定した場合

日本語と英語で共通の出力形式を次に示します。

MODE   UID      GID      PID      L TIME     FILE
aabbcc dd....dd ee....ee pp....pp q hh....hh ii....ii

出力形式中の，各変数の意味を次に示します。

変数

意味

aa

所有者に対するアクセス権

r…読み出し権がある

w…書き込み権がある

-…読み出し権，または書き込み権がない

bb

グループに対するアクセス権

r…読み出し権がある

w…書き込み権がある

-…読み出し権，または書き込み権がない

cc

他者に対するアクセス権

r…読み出し権がある

w…書き込み権がある

-…読み出し権，または書き込み権がない

dd....dd

所有者名（9文字以内）

ee....ee

所有者のグループ名（9文字以内）

pp....pp

ロックを掛けているプロセスのプロセスID（10文字以内）

ロックが掛けられていない場合は，「−」が表示されます。

q

ロック状態の識別フラグ

E…占有ロック

S…共有ロック

-…ロックが掛けられていない

hh....hh

最終更新日時

時:分△月日年の形式

ii....ii

TP1EEファイル名

出力メッセージ

メッセージID

内容

出力先

KFSB91503-I

ヘルプメッセージ

標準出力

KFSB91533-E

TP1EEファイルは存在しません。

標準エラー出力

KFSB91534-E

フラグ引数が不正です。

標準エラー出力

KFSB91535-E

コマンド引数が不正です。

標準エラー出力

KFSB91536-E

コマンドの形式が不正です。

標準エラー出力

KFSB91537-E

オプションフラグの組み合わせが不正です。

標準エラー出力

KFSB91570-E

バックアップファイルまたはTP1EEファイルシステム領域は，このコマンドで扱うことのできないバージョンです。

標準エラー出力

KFSB91571-E

TP1EEファイルシステム領域に対するアクセス権がありません。

標準エラー出力

KFSB91572-E

TP1EEファイルシステム領域のオープン処理で上限値オーバが報告されました。

標準エラー出力

KFSB91573-E

TP1EEファイルシステム領域が存在しません。

標準エラー出力

KFSB91575-E

TP1EEファイルシステムを構築できるファイルではありません。

標準エラー出力

KFSB91576-E

TP1EEファイルシステムではありません。

標準エラー出力

KFSB91578-E

TP1EEファイルシステムのロックに失敗しました。

標準エラー出力

KFSB91582-E

領域の確保に失敗しました。

標準エラー出力

KFSB91583-E

入出力エラーが発生しました。

標準エラー出力

KFSB91599-E

内部矛盾が発生しました。

標準エラー出力

eefilmkfs

名称

TP1EEファイルシステムの初期化

形式

キャラクタ型スペシャルファイルの場合

eefilmkfs｛-s セクタ長 -n 容量 -l 最大ファイル数
         〔-v TP1EEファイルシステム名〕
         〔-p 物理区画サイズ〕 スペシャルファイル名
         ｜-c 物理区画サイズ スペシャルファイル名｝

ブロック型スペシャルファイルの場合（Linux版限定）

eefilmkfs｛-s セクタ長 -n 容量 -l 最大ファイル数
         〔-v TP1EEファイルシステム名〕｝

通常ファイルの場合

eefilmkfs 〔-r〕 -n 容量 -l 最大ファイル数
          〔-v TP1EEファイルシステム名〕 通常ファイル名

機能

指定したハードディスクのパーティション，または通常ファイルを，TP1EEファイルシステム用に初期設定します。初期設定は，TP1EEファイルシステムとして通常ファイル，またはパーティションを割り当てるときに一度だけ行います。

eefilmkfsコマンドを実行できるのは，キャラクタ型スペシャルファイルまたはブロック型スペシャルファイルの場合，スーパユーザまたはファイルの所有者です。通常ファイルの場合は，スーパユーザ，または通常ファイルを作成するディレクトリに書き込みを許可されているユーザです。通常ファイルがすでに存在する場合は，スーパユーザ，または通常ファイルの所有者です。

オプション

●-s　セクタ長　　〜〈128の倍数かつ4096の約数〉

TP1EEファイルシステムを構築するハードディスクのセクタ長を指定します。

●-r

ユーザに確認を求めないで初期化します。そのため，指定した通常ファイルがすでにある場合，そのファイルの内容は失われます。

-rオプションの指定を省略すると，指定した通常ファイルがすでにある場合，初期化するかどうか，確認を求められます。

●-n　容量　　〜((1〜4095))（単位：メガバイト）

TP1EEファイルシステムとして割り当てる容量をメガバイトで指定します。

●-l　最大ファイル数　　〜((1〜4096))

TP1EEファイルシステム内に作成するファイル数の上限を指定します。

●-v　TP1EEファイルシステム名　　〜〈1〜8文字のファイル名〉

TP1EEファイルシステムに付ける名称を指定します。

-vオプションの指定を省略すると，TP1EEファイルシステムに名称が付きません。

●-p　物理区画サイズ　　〜((1〜1024))（単位：メガバイト）（AIX版限定）

-pオプションは，新たにTP1EEファイルシステムを作成する場合に指定します。スペシャルファイル名に指定したキャラクタ型スペシャルファイルが存在するボリュームグループの物理区画サイズを指定してください。物理区画サイズは，mkvgコマンドなどでボリュームグループを作成する際に定められている値です。すでにボリュームグループを作成している場合の実際の物理区画サイズは，lsvgコマンドなどで確認できます。-pオプションで指定した物理区画サイズは，eefilstatfsコマンドで確認できます。

-pオプションを指定したTP1EEファイルシステムの場合，物理区画を意識したデータの書き込みが行われます。これによって，データの書き込み時の障害によって発生するおそれのあるデータの不整合を抑止できます。

-pオプションの指定を省略した場合は，物理区画を意識しないデータの書き込みが行われます。

なお，このオプションは，OSがAIXの場合に指定できます。

●-c　物理区画サイズ　　〜((1〜1024))（単位：メガバイト）（AIX版限定）

-cオプションは，すでに存在するTP1EEファイルシステムの物理区画サイズを設定または変更する場合に指定します。スペシャルファイル名に指定したキャラクタ型スペシャルファイルが存在するボリュームグループの物理区画サイズを指定してください。-cオプションで指定した物理区画サイズは，eefilstatfsコマンドで確認できます。

-cオプションを指定した場合，スペシャルファイル名に指定したTP1EEファイルシステムの初期化は行いません。TP1EEファイルシステムを初期化したい場合は，-pオプションを指定したeefilmkfsコマンドを実行してください。

なお，このオプションは，OSがAIXの場合に指定できます。

コマンド引数

●スペシャルファイル名　　〜〈パス名〉

初期化するスペシャルファイルの名称を指定します。

指定するファイルはキャラクタ型スペシャルファイルまたはブロック型スペシャルファイルです。

パス名は，TP1EEファイル名を含めて510文字以内になるように指定してください。

●通常ファイル名　　〜〈パス名〉

初期化する通常ファイルの名称を指定します。

パス名は，TP1EEファイル名を含めて510文字以内になるように指定してください。

出力メッセージ

メッセージID

内容

出力先

KFSB91505-I

ヘルプメッセージ

標準出力

KFSB91527-E

TP1EEファイルシステム領域は，他プロセスで使用中のため，TP1EEファイルシステムとして初期化できません。

標準エラー出力

KFSB91530-Q

ファイルをTP1EEファイルシステムとして初期化します。

標準エラー出力

KFSB91531-E

容量不足が発生したため，TP1EEファイルシステム領域をTP1EEファイルシステムとして初期化することができません。

標準エラー出力

KFSB91532-E

このコマンドは，スーパユーザまたはTP1EEファイルシステム領域の所有者だけが実行できます。

標準エラー出力

KFSB91534-E

フラグ引数が不正です。

標準エラー出力

KFSB91535-E

コマンド引数が不正です。

標準エラー出力

KFSB91536-E

コマンドの形式が不正です。

標準エラー出力

KFSB91537-E

オプションフラグの組み合わせが不正です。

標準エラー出力

KFSB91571-E

TP1EEファイルシステム領域に対するアクセス権がありません。

標準エラー出力

KFSB91573-E

TP1EEファイルシステム領域が存在しません。

標準エラー出力

KFSB91575-E

TP1EEファイルシステムを構築できるファイルではありません。

標準エラー出力

KFSB91576-E

TP1EEファイルシステムではありません。

標準エラー出力

KFSB91578-E

TP1EEファイルシステムのロックに失敗しました。

標準エラー出力

KFSB91582-E

領域の確保に失敗しました。

標準エラー出力

KFSB91583-E

入出力エラーが発生しました。

標準エラー出力

KFSB91599-E

内部矛盾が発生しました。

標準エラー出力

注意事項

初期設定時，容量としてディスクボリューム，またはパーティションの容量より大きな値を指定すると，そのパーティションに物理的に続くパーティションを破壊することがあります。そのためOpenTP1管理者は，TP1EEファイルシステムの容量を正確に計算して，ディスクを割り当ててください。

TP1EEファイルシステムにキャラクタ型スペシャルファイルまたはブロック型スペシャルファイルを指定する場合，UNIXファイルシステムとして使用しているパーティションを指定しないでください。

オンラインで使用しているTP1EEファイルシステムを初期化しないでください。オンラインで使用しているTP1EEファイルシステムを初期化した場合，オンラインが正常に動作しなくなったり，TP1EEファイルシステム中の管理情報やTP1EEファイルの内容が破壊されたりするおそれがあります。

TP1EEファイルシステムの初期化に失敗した場合は，TP1EEファイルシステムの中の管理情報が破壊されているおそれがあります。

-pオプションまたは-cオプションで指定する物理区画サイズは，lsvgコマンドなどで表示される物理区画サイズと同じ値を指定してください。異なる値を指定した場合は，指定した物理区画サイズが設定され，コマンドは正常終了します。

-pオプションまたは-cオプションで指定した値が有効となるのは，eefilmkfsコマンド実行後の，TP1EEファイルシステムへの書き込み時です。

-pオプションは，キャラクタ型スペシャルファイルにTP1EEファイルシステムを作成する場合だけに実行してください。-cオプションは，キャラクタ型スペシャルファイルに作成したTP1EEファイルシステムの物理区画サイズを設定または変更する場合だけに実行してください。

通常ファイルに作成したTP1EEファイルシステムに対して，-pオプションまたは-cオプションを指定したeefilmkfsコマンドを実行した場合，KFSB91505-IメッセージおよびKFSB91537-Eメッセージを出力します。

オンラインで使用中（現用，または予備の状態）のTP1EEファイルが存在するTP1EEファイルシステムに対して，eefilmkfsコマンドを実行しないでください。

eefilrstr

名称

TP1EEファイルシステムのリストア

形式

eefilrstr 〔-y〕〔-｛t｜o｜r｝〕 〔-｛c｜l｝〕
          バックアップファイル名 〔/TP1EEファイル名〕
          TP1EEファイルシステム領域名

機能

eefilbkupコマンドでバックアップしたTP1EEファイルシステムをTP1EEファイルシステム領域にリストアします。

eefilrstrコマンドは，TP1EEファイルシステムをリストアする前にユーザに確認を求めますが，-yオプションを指定すると，確認を求めないですぐにリストアできます。

eefilrstrコマンドを実行できるのは，スーパユーザ，およびTP1EEファイルシステムを初期設定するユーザだけです。

オプション

●-y

ユーザに確認しないで，すぐにTP1EEファイルシステムをリストアします。

-yオプションの指定を省略すると，ユーザに確認してからTP1EEファイルシステムがリストアされます。

●-｛t｜o｜r｝

指定を省略すると，-tが仮定されます。

リストア元のファイルとリストア先のTP1EEファイルシステムに，同じ名称のTP1EEファイルがあるときの動作を指定します。

-t

最終更新日時を比較して，リストア元のファイル上のTP1EEファイルの方が新しければ，TP1EEファイルをリストアします。

-o

同じ名称のTP1EEファイルについてはリストアしません。

-r

最終更新日時に関係なく，TP1EEファイルをリストアします。

●-｛c｜l｝

指定を省略すると，-cが仮定されます。

-c

TP1EEファイルシステム中のTP1EEファイルを他プロセスが使用中の場合，TP1EEファイルシステムをリストアしません。

-l

TP1EEファイルシステム中のTP1EEファイルを他プロセスが使用中の場合，使用中のTP1EEファイルはリストアしません。

コマンド引数

●バックアップファイル名　　〜〈パス名〉

TP1EEファイルシステムをバックアップしたファイルの名称を指定します。

●TP1EEファイル名　　〜〈TP1EEファイル名〉

リストアするTP1EEファイルの名称を指定します。

このコマンド引数を指定すると，指定したTP1EEファイルだけがリストアされます。

●TP1EEファイルシステム領域名　　〜〈パス名〉

TP1EEファイルシステムをリストアするキャラクタ型スペシャルファイル名，ブロック型スペシャルファイル名，または通常ファイル名を指定します。指定するファイルは，TP1EEファイルシステム用に初期設定しておく必要があります。

出力メッセージ

メッセージID

内容

出力先

KFSB91502-I

ヘルプメッセージ

標準出力

KFSB91510-E

バックアップファイルがオープンできません。

標準エラー出力

KFSB91512-E

TP1EEファイルの作成に失敗しました。

標準エラー出力

KFSB91513-Q

回復を行います。

標準エラー出力

KFSB91515-W

TP1EEファイルのレコード長が，セクタ長の整数倍ではないため回復できません。

標準エラー出力

KFSB91516-E

スーパユーザまたはTP1EEファイルシステム初期化ユーザでしか実行できません。

標準エラー出力

KFSB91517-W

TP1EEファイルは，I/Oエラーによって正常に退避されていません。

標準エラー出力

KFSB91518-E

バックアップファイルではありません。

標準エラー出力

KFSB91519-E

TP1EEファイルに対する書き込み権がないため回復できません。

標準エラー出力

KFSB91528-E

TP1EEファイルシステム領域は，他プロセスで使用中のため，処理を中止します。

標準エラー出力

KFSB91529-E

TP1EEファイルは，他プロセスで使用中のため，処理を行いません。

標準エラー出力

KFSB91533-E

TP1EEファイルは存在しません。

標準エラー出力

KFSB91534-E

フラグ引数が不正です。

標準エラー出力

KFSB91535-E

コマンド引数が不正です。

標準エラー出力

KFSB91536-E

コマンドの形式が不正です。

標準エラー出力

KFSB91537-E

オプションフラグの組み合わせが不正です。

標準エラー出力

KFSB91547-I

コマンドが正常に終了しました。

標準出力

KFSB91570-E

バックアップファイルまたはTP1EEファイルシステム領域は，このコマンドで扱うことのできないバージョンです。

標準エラー出力

KFSB91581-E

I/Oエラーが発生しました。

標準エラー出力

KFSB91582-E

領域の確保に失敗しました。

標準エラー出力

KFSB91583-E

TP1EEファイルシステム領域でI/Oエラーが発生しました。

標準エラー出力

KFSB91599-E

内部矛盾が発生しました。

標準エラー出力

注意事項

eefilbkupコマンドを実行すると，プロセスの打ち切りなどでファイル管理テーブルが孤立している無効ファイルもバックアップします。eefilrstrコマンドで-rオプションを指定した場合，バックアップされた無効ファイルと同じ名称のファイルがあると，そのファイルを無効ファイルと置き換えてしまいます。このため，基本的に-tオプション，または-oオプションを指定してください。

TP1EEファイルシステム中のTP1EEファイルを他プロセスが使用中の場合，TP1EEファイルシステムをリストアしません。強制的にリストアしたい場合は，-lオプションを指定してください。

リストア先のTP1EEファイルシステムを初期設定しないでeefilrstrコマンドを実行すると，リストアする前にあったTP1EEファイルがeefilrstrコマンド実行後も残ります。これは，TP1EEファイル単位にリストアされるためです。

バックアップファイルのレコード長がリストア先スペシャルファイルのセクタ長よりも短かった場合，またはバックアップファイルのレコード長がリストア先スペシャルファイルのセクタ長の倍数でなかった場合，そのファイルはリストアしないで，次のファイルのリストア処理を行います。

TP1EEファイルシステムが正常にバックアップできていなかった場合，警告メッセージを出力して，TP1EEファイルシステムのリストア処理を続けます。

eefilstatfs

名称

TP1EEファイルシステムの状態表示

形式

eefilstatfs 〔-w〕 〔-l〕 〔-p〕 TP1EEファイルシステム領域名

機能

TP1EEファイルシステムの状態を標準出力に出力します。

オプション

●-w

TP1EEファイル管理領域開始位置を表示します。

●-l

空き領域サイズの情報を表示します。

●-p（AIX版限定）

キャラクタ型スペシャルファイルに作成したTP1EEファイルシステムに指定した物理区画サイズを表示します。表示される物理区画サイズは，実際の物理区画サイズではなく，eefilmkfsコマンドの-pオプションまたは-cオプションで指定した値です。実際の物理区画サイズは，lsvgコマンドなどで確認できます。

なお，このオプションは，OSがAIXの場合に指定できます。

コマンド引数

●TP1EEファイルシステム領域名　　〜〈パス名〉

TP1EEファイルシステムがあるキャラクタ型スペシャルファイル名，ブロック型スペシャルファイル名，または通常ファイル名を指定します。

出力形式

日本語の出力形式を次に示します。

セクタ長[B]                         ：aa....aa
領域総容量[KB]                      ：bb....bb
領域残り容量[KB]                    ：cc....cc
作成可能最大ファイルサイズ[KB]      ：dd....dd
最大作成可能ファイル数              ：ee....ee
作成済みファイル数                  ：ff....ff
残り作成可能ファイル数              ：gg....gg
空き領域総数                        ：hh....hh
ファイルシステム初期化ユーザID      ：ii....ii
ファイルシステム初期化時刻          ：jj....jj
ファイルシステム名                  ：kk....kk
TP1EEファイル管理領域開始位置       ：ll....ll
物理区画サイズ[MB]                  ：mm....mm

英語の出力形式を次に示します。

sector length [B]                       ：aa....aa
total capacity of area [KB]             ：bb....bb
remaining capacity of area [KB]         ：cc....cc
maximum size of making file [KB]        ：dd....dd
maximum number of making file           ：ee....ee
number of made file                     ：ff....ff
remaining number of making file         ：gg....gg
total number of free areas              ：hh....hh
file system initialized user ID         ：ii....ii
file system initialized time            ：jj....jj
file system name                        ：kk....kk
start point of TP1EE file control area  ：ll....ll
physical partition size [MB]            ：mm....mm

出力形式中の，各変数の意味を次に示します。

変数

意味

aa....aa

eefilmkfsコマンドの-sオプションで指定したセクタ長

bb....bb

TP1EEファイルシステム中でTP1EEファイル用として割り当てられた領域の総容量

cc....cc

割り当てた領域の中で，未使用（TP1EEファイルとして割り当てられていない）領域の容量

dd....dd

現在，一つのTP1EEファイルとして確保できる容量の最大値

ee....ee

eefilmkfsコマンドの-lオプションで指定した，作成できるTP1EEファイルの上限数

ff....ff

すでに作成されたTP1EEファイルの数

gg....gg

作成できるTP1EEファイル数（最大作成可能ファイル数−作成済みファイル数）

hh....hh

不連続な空き領域の総数

ii....ii

TP1EEファイルシステムを初期設定したユーザのログイン名

jj....jj

TP1EEファイルシステムを初期設定した日時

曜日△月△日△時:分:秒△年（西暦）の形式

kk....kk

eefilmkfsコマンドで指定したTP1EEファイルシステム名

ll....ll

TP1EEファイル管理領域開始位置（-wオプション指定時だけ表示されます）

mm....mm

eefilmkfsコマンドで指定した物理区画サイズ（-pオプション指定時だけ表示されます）

-lオプションを指定した場合は，次の空き領域サイズも表示されます。

空き領域サイズの情報

 空き領域サイズ (KB)  領域数
          -       1  :aa....aa
       1  -       2  :aa....aa
       2  -       4  :aa....aa
       4  -       8  :aa....aa
       8  -      16  :aa....aa
      16  -      32  :aa....aa
      32  -      64  :aa....aa
      64  -     128  :aa....aa
     128  -     256  :aa....aa
     256  -     512  :aa....aa
     512  -    1024  :aa....aa
    1024  -    2048  :aa....aa
    2048  -    4096  :aa....aa
    4096  -    8192  :aa....aa
    8192  -   16384  :aa....aa
   16384  -   32768  :aa....aa
   32768  -   65536  :aa....aa
   65536  -  131072  :aa....aa
  131072  -          :aa....aa

出力形式中の，aa....aaは，領域数を示しています。

出力メッセージ

メッセージID

内容

出力先

KFSB91534-E

フラグ引数が不正です。

標準エラー出力

KFSB91535-E

コマンド引数が不正です。

標準エラー出力

KFSB91536-E

コマンドの形式が不正です。

標準エラー出力

KFSB91537-E

オプションフラグの組み合わせが不正です。

標準エラー出力

KFSB91551-I

ヘルプメッセージ

標準出力

KFSB91570-E

バックアップファイルまたはTP1EEファイルシステム領域は，このコマンドで扱うことのできないバージョンです。

標準エラー出力

KFSB91571-E

TP1EEファイルシステム領域に対するアクセス権がありません。

標準エラー出力

KFSB91572-E

TP1EEファイルシステム領域のオープン処理で上限値オーバが報告されました。

標準エラー出力

KFSB91573-E

TP1EEファイルシステム領域が存在しません。

標準エラー出力

KFSB91575-E

TP1EEファイルシステムを構築できるファイルではありません。

標準エラー出力

KFSB91576-E

TP1EEファイルシステムではありません。

標準エラー出力

KFSB91582-E

領域の確保に失敗しました。

標準エラー出力

KFSB91583-E

TP1EEファイルシステム領域でI/Oエラーが発生しました。

標準エラー出力

KFSB91599-E

内部矛盾が発生しました。

標準エラー出力

注意事項

通常ファイルに作成したTP1EEファイルシステムに対して-pオプションを指定したeefilstatfsコマンドを実行した場合，KFSB91537-EメッセージおよびKFSB91551-Iメッセージを出力します。

eefilmkfsコマンドで物理区画サイズを指定していないキャラクタ型スペシャルファイルのTP1EEファイルシステムに対して-pオプションを指定したeefilstatfsコマンドを実行した場合，物理区画サイズは0と表示されます。

eelckls

名称

排他情報の表示

形式

eelckls -g サービスグループ名〔｛-a｜-r 資源名称｝〕 〔-t〕

機能

排他情報を標準出力に出力します。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

排他情報を出力するTP1/EEプロセスのサービスグループ名を指定します。

●-a

排他資源の占有，および待ち情報を表示します。

このオプションの指定を省略すると，待ち情報だけを表示します。

●-r　資源名称　　〜〈1〜16文字の英数字〉

指定した資源の占有，および待ち情報を表示します。このオプションを指定した場合，指定した文字列（資源名称）に対して前方一致検索を行い，該当する資源の情報をすべて表示します。

●-t

トランザクショングローバル識別子およびトランザクションブランチ識別子を表示します。

出力形式

●-tオプションを省略した場合

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

出力形式中の，右端の数字の意味を次に示します。

1：改行を含まないで1行で表示します。

2：改行を含まないで1行で表示します。占有，および待ち情報が複数ある場合，その数だけ繰り返し表示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa....aa

資源名称

bb

排他制御モード（2文字）

PR…ほかのUAPに対して，参照だけを許可し，更新を禁止します。

EX…ほかのUAPに対して，参照，更新を禁止します。

cc....cc

要求種別（7文字以内）

MIGRATE…ユーザの排他要求

dd....dd

資源の解放待ち時間（10進数，単位はミリ秒）

占有情報の場合は**********が表示されます。

ee....ee

デッドロックプライオリティ

***が表示されます。

ff....ff

排他待ちプライオリティ値（10進数）

0が表示されます。

gg....gg

中央処理通番（10進数）

●-tオプションを指定した場合

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

出力形式中の，右端の数字の意味を次に示します。

1：改行を含まないで1行で表示します。

2：改行を含まないで1行で表示します。占有，および待ち情報が複数ある場合，その数だけ繰り返し表示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa....aa

資源名称

bb

排他制御モード（2文字）

PR…ほかのUAPに対して，参照だけを許可し，更新を禁止します。

EX…ほかのUAPに対して，参照，更新を禁止します。

cc....cc

要求種別（7文字以内）

MIGRATE…ユーザの排他要求

dd....dd

資源の解放待ち時間（10進数，単位はミリ秒）

占有情報の場合は**********が表示されます。

ee....ee

デッドロックプライオリティ

***が表示されます。

ff....ff

排他待ちプライオリティ値（10進数）

0が表示されます。

gg....gg

中央処理通番（10進数）

hh....hh

トランザクショングローバル識別子（16文字の英数字）

ii....ii

トランザクションブランチ識別子（16文字の英数字）

出力メッセージ

メッセージID

内容

出力先

KFSB90401-E

コマンド引数が不正です。

標準エラー出力

KFSB90402-E

フラグ引数が不正です。

標準エラー出力

KFSB90404-E

コマンドが失敗しました。

標準エラー出力

KFSB90405-E

領域の確保に失敗しました。

標準エラー出力

KFSB90406-E

内部矛盾が発生しました。

標準エラー出力

KFSB90421-I

ヘルプメッセージ

標準出力

eelspce

名称

処理キューの滞留状態の表示およびサービスの最大同時処理限界数の変更

形式

eelspce -g サービスグループ名｛-s ｛sys｜usr｜all｝｜-w｜
                               -v サービス名 -n 最大同時処理限界数｝

機能

処理キューの滞留状態を表示したりサービスの最大同時処理限界数を変更したりします。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

処理対象のサービスグループ名を指定します。

●-s　｛sys｜usr｜all｝

sys

システム用処理キューの滞留数を出力します。

usr

ユーザサービス関連定義のserviceオペランドおよびdbq_serviceオペランドで指定した，現在の処理キューの滞留数を出力します。

all

すべての処理キューの滞留数を出力します。

●-w

処理キューの滞留監視機能に関する情報を出力します。

処理キューの確保数，使用中処理キューの数，処理キューの滞留率，オンライン打ち切り監視範囲の処理キュー滞留率，および処理キューの滞留監視状態を出力します。

●-v　サービス名　　〜〈1〜31文字の識別子〉

最大同時処理数を変更したいサービス名を指定します。

●-n　最大同時処理限界数　　〜〈符号なし整数〉((1〜255))

サービスの最大同時処理限界数を指定します。

出力形式

●-sオプションを指定した場合

サービス名の定義順に出力します。

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

nn....nn

滞留中の処理キューの数

mmm

同時に処理できる処理キューの最大数

ppp

サービス処理中の処理キューの数

q....q

トランザクション処理中の処理キューの数※1

xxxxxxxx

処理キューの引き出し状態

00000000：引き出し禁止でない

00000001：UAP入れ替え処理（eechgapコマンド）による引き出し禁止

00000004：スレッドダウン，またはeedctsvコマンドによる引き出し禁止

00000100：TP1/FSPのeesvctlコマンドによる引き出し禁止

00000200：UAP共用ライブラリ同時入れ替え機能（eechglibコマンド）※2による引き出し禁止

上記以外：システムによる引き出し禁止

なお，引き出し禁止状態は論理和で表示されます。

g....g

TP1/EEがトラブルシュートで使用する情報

ss....ss

サービス名

注※1

XTCを使用する場合，サービス名がユーザサービスのときは，送達確認送信処理中の処理キューも含まれます（送達確認送信処理中の処理キューは，サービス処理中の処理キューの数には含まれません）。

注※2

UAP共用ライブラリ同時入れ替え機能については，TP1/FSPの関連ドキュメントを参照してください。

●-wオプションを指定した場合

日本語の出力形式を次に示します。

処理キュー滞留情報                 aa....aa
ＰＣＥ確保数                       bb....bb
使用中ＰＣＥ数                     cc....cc
処理キュー滞留率（％）             dd....dd
監視範囲処理キュー滞留率（％）     ee....ee

英語の出力形式を次に示します。

processing queue retention information     aa....aa
PCE reservation number                                   bb....bb
number of PCE in use                                     cc....cc
processing queue retention ratio (%)                     dd....dd
processing queue retention ratio in monitoring range (%) ee....ee

出力形式中の，各変数の意味を次に示します。

変数

意味

aa....aa

処理キューの滞留監視状態

ON…処理キューの滞留監視機能がオンライン打ち切り監視中

OFF…処理キューの滞留監視機能が通常監視状態

NOT USED…処理キューの滞留監視機能を使用していない状態

bb....bb

処理キューの確保数

cc....cc

使用中の処理キューの数

dd....dd

現在の処理キューの滞留率（%）（小数点以下切り捨て）

ee....ee

オンライン打ち切り監視範囲の処理キューの滞留率（%）

処理キューの滞留監視機能を使用していない場合は，「-」を表示します。

出力メッセージ

メッセージID

内容

出力先

KFSB95301-E

コマンドの形式が不正です。

標準エラー出力

KFSB95302-E

フラグ引数が不正です。

標準エラー出力

KFSB95304-E

オプションの組み合わせが不正です。

標準エラー出力

KFSB95305-E

コマンドが失敗しました。

標準エラー出力

KFSB95306-E

領域の確保に失敗しました。

標準エラー出力

KFSB95307-E

内部矛盾が発生しました。

標準エラー出力

KFSB95360-I

ヘルプメッセージ

標準出力

KFSB95361-I

最大同時処理限界数を変更しました。

標準出力

注意事項

このコマンドで変更したサービスの最大同時処理限界数は，プロセスの再開始時に引き継がれます。

DBキューサービスに対して，このコマンドを使用してサービスの最大同時処理限界数を変更する場合は，DBキューサービスを同時に起動させるトランザクションの最大数（DBキュー機能関連定義のdbqsrvdef定義コマンドの-tオプションで指定）との関連に注意してください。

eelsque

名称

処理キュー統計情報の表示

形式

eelsque -g サービスグループ名 〔-v {サービス名｜トランザクションレベル名}〕

機能

コマンド実行単位（前回コマンド実行時から今回コマンド実行時まで）の処理キュー統計情報を表示します。

オンライン開始後の初回コマンド実行時は，オンラインを開始してからのキュー情報を表示します。

統計情報はサービス名単位で表示します。ただし，次の条件をすべて満たす場合，トランザクションレベル名単位でキュー情報を表示します。

fsp_useオペランドにYを指定

TP1/FSPのqueue_draw_method定義-pオプションにtrnlevelを指定

出力対象は次の定義で指定したサービス，またはトランザクションレベルです。

service

dbq_service

dbq_obs_service

obm_service

queue_trnlevel

統計情報の取得対象となるトランザクションは次のとおりです。

CU：ユーザコマンドトランザクション

MN：サービストランザクション

RL：MCP後処理トランザクション

TM：タイマトランザクション

E2：ERRTRN2

E4：ERRTRN4

オプション

●-g サービスグループ名　　〜<1〜31文字の識別子>

対象のサービスグループ名を指定します。

●-v {サービス名｜トランザクションレベル名}　　〜<1〜31文字の識別子>

キュー情報を出力するサービス名を指定します。

ただし，次の条件をすべて満たす場合，キュー情報を出力するトランザクションレベル名を指定してください。

fsp_useオペランドにYを指定

TP1/FSPのqueue_draw_method定義-pオプションにtrnlevelを指定

本オプションを省略した場合，すべての処理キュー情報を出力します。

出力形式

日本語の出力形式を次に示します。

処理キュー統計情報
開始時刻：aa....aa
終了時刻：bb....bb
  処理数    滞留数      最小      最大      平均      実行数/上限  処理キュー名
cc....cc  dd....dd  ee....ee  ff....ff  gg....gg          hhh/iii  jj....jj
cc....cc  dd....dd  ee....ee  ff....ff  gg....gg          hhh/iii  jj....jj
   ：        ：        ：        ：        ：               ：        ：
   ：        ：        ：        ：        ：               ：        ：

英語の出力形式を次に示します。

Processing queue statistical information
Start time：aa....aa
End time  ：bb....bb
   In proc      Retain         Min         Max         Avr  Execution/Limit  Processing queue
  cc....cc    dd....dd    ee....ee    ff....ff    gg....gg          hhh/iii  jj....jj
  cc....cc    dd....dd    ee....ee    ff....ff    gg....gg          hhh/iii  jj....jj
     ：          ：          ：          ：          ：               ：        ：
     ：          ：          ：          ：          ：               ：        ：

出力形式中の，各変数の意味を次に示します。

変数

意味

aa....aa

前回コマンド実行時刻（yyyy/mm/dd hh:mm:ss.sss形式）。

オンライン開始後の初回コマンド実行時はオンライン開始時間。

bb....bb

今回コマンド実行時刻（yyyy/mm/dd hh:mm:ss.sss形式）。

cc....cc

前回コマンド実行時から今回コマンド実行時までに処理した処理キュー数。

処理キュー数が2147483647を超えた場合，2147483647を出力します。※1

dd....dd

今回コマンド実行時に滞留していた処理キュー数。

処理キュー数が2147483647を超えた場合，2147483647を出力します。

ee....ee

前回コマンド実行時から今回コマンド実行時までに，滞留していた処理キューの最小滞留時間。※1，※2

ff....ff

前回コマンド実行時から今回コマンド実行時までに，滞留していた処理キューの最大滞留時間。※1，※2

gg....gg

前回コマンド実行時から今回コマンド実行時までに，滞留していた処理キューの平均滞留時間。※1，※2

hh....hh

今回コマンド実行時に，対象処理キューを実行中のスレッド数。

ii....ii

対象サービス／対象トランザクションレベルの同時処理限界数。

jj....jj

対象サービス名／対象トランザクションレベル名。

注※1

-vオプションの指定有無に関わらず，前回コマンド実行時から今回コマンド実行時までの情報を出力します。

キュー情報の1つの処理数を例に説明します。

次の図はサービス単位の処理キューの処理数の変化を時系列に表しています。

コマンド実行1でサービスSV1のキュー情報を出力したあと，全ユーザサービスの出力用キュー情報を初期化します。コマンド実行2で-vオプションを省略した場合，SV2，SV3の出力されるキュー情報はコマンド実行1を実行した時間からカウントしたキュー情報になります。

注※2

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。

4294967.295を超過した場合，4294967.295を表示します。滞留がなかった場合，0.000を表示します。

出力メッセージ

メッセージID

内容

出力先

KFSB95301-E

コマンドの形式が不正です。

標準エラー出力

KFSB95302-E

フラグ引数が不正です。

標準エラー出力

KFSB95305-E

コマンドが失敗しました。

標準エラー出力

KFSB95306-E

領域の確保に失敗しました。

標準エラー出力

KFSB95307-E

内部矛盾が発生しました。

標準エラー出力

KFSB95390-I

ヘルプメッセージ

標準出力

eelssv

名称

サービスの状態表示

形式

eelssv -g サービスグループ名 ｛-s ｛act｜dct｜all｝｜-v サービス名｝

機能

サービスの状態を表示します。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

状態を表示するサービスグループ名を指定します。

●-s ｛act｜dct｜all｝

サービス名をリスト表示します。サービス名を昇順に出力します。

act

閉塞していないサービス名をすべてリスト表示します。

dct

閉塞しているサービス名をすべてリスト表示します。

all

すべてのサービス名をリスト表示します。

●-v　サービス名　　〜〈1〜31文字の識別子〉

状態を表示するサービス名を指定します。指定したサービスの閉塞状態を表示します。

出力形式

日本語の出力形式を次に示します。

状態 : サービス名
xxx  : aa....aa※

英語の出力形式を次に示します。

Stat : Service name
xxx  : aa....aa※

注※

出力対象のサービスが複数ある場合は，出力対象のサービス数分の行が出力されます。

出力形式中の，各変数の意味を次に示します。

変数

意味

xxx

サービスの状態

ACT…閉塞解除中

DCT…閉塞中

aa....aa

サービス名

出力メッセージ

メッセージID

内容

出力先

KFSB95301-E

コマンドの形式が不正です。

標準エラー出力

KFSB95302-E

フラグ引数が不正です。

標準エラー出力

KFSB95304-E

オプションの組み合わせが不正です。

標準エラー出力

KFSB95305-E

コマンドが失敗しました。

標準エラー出力

KFSB95306-E

領域の確保に失敗しました。

標準エラー出力

KFSB95307-E

内部矛盾が発生しました。

標準エラー出力

KFSB95340-I

ヘルプメッセージ

標準出力

eememls

名称

メモリの使用状況の表示

形式

eememls -g サービスグループ名 〔-u〕

機能

コマンド実行時のメモリの使用状況を標準出力に出力します。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

メモリの使用状況を表示するサービスグループ名を指定します。

●-u

使用中のユーザ用FREE属性セグメント数を表示します。

-uオプションを省略した場合，メモリ全体の使用状況を表示します。

出力形式

●-uオプションを省略した場合

次に示すメモリ情報を標準出力に出力します。

メモリの全体サイズ（TP1/EEの初期化処理時に確保したメモリサイズ＋追加確保したメモリサイズ）

TP1/EEの初期化処理時に確保したメモリサイズ

オンライン中に追加確保したメモリのサイズ

システム領域

COBOL用ワーク領域※1

XDB用ワーク領域（XDBPOOL）※2

XTC用ワーク領域（XTCPOOL）※3

大量処理用システム領域（MPSPOOL）※4

OBM用システム領域（OBMPOOL）※5

ユーザ用テーブル領域

ユーザ用ワーク領域

共用ワーク領域

大量処理用ユーザ領域（MPUPOOL）※4

システムバッファ領域

注※1

COBOL用メモリ管理機能を使用する場合（メモリ関連定義のmemory_cobol_area_sizeオペランド，またはmemory_cobol_area_thd_sizeオペランドで指定）だけ表示します。COBOL用メモリ管理機能を使用しない場合は，表示しません。

注※2

XDBを使用する場合（プロセス関連定義のxdb_useオペランドにYを指定）だけ表示します。XDBを使用しない場合は，表示しません。

注※3

XTCを使用する場合（プロセス関連定義のxtc_useオペランドにYを指定）だけ表示します。XTCを使用しない場合は，表示しません。

注※4

大量処理用メモリ管理機能を使用する場合（XTCサービス定義のメモリ関連定義のmemory_mdpsys_area_sizeオペランドおよびmemory_mdpusr_area_sizeオペランドで指定）だけ表示します。大量処理用メモリ管理機能を使用しない場合は，表示しません。

注※5

OBM機能用メモリ管理機能を使用する場合（TP1/FSPのメモリ関連定義のmemory_obm_area_sizeオペランドで指定）だけ表示します。OBM機能用メモリ管理機能を使用しない場合は，表示しません。

出力形式を次に示します。

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa....aa

サービスグループ名

bb....bb

全体メモリサイズ，初期メモリサイズ，拡張メモリサイズ（バイト）

cc....cc

領域確保サイズ（バイト）

dd....dd

領域使用サイズ（バイト）

eeee

領域使用率（%）（小数点以下切り捨て）

計算できない場合は，「-」を表示します。

ffffffff

セグメントサイズ（バイト）

管理領域のサイズを含めた，セグメント全体のサイズです。

ggggggg

セグメント確保数

hhhhhhh

セグメント使用数

セグメントの使用状況によって，7けたを超える場合があります。

iiii

セグメント使用率（%）

セグメントの使用状況によって，4けたを超える場合があります。計算できない場合は，「-」を表示します。

jjjjjjjjjj

セグメント最大使用数

yy/mm/dd hh:mm:ss

セグメント最大数使用日時

「年/月/日△時:分:秒」の形式で表示します。年は西暦の下2けたで表示します。セグメントの最大数を使用していない場合は，「-」を表示します。

●-uオプションを指定した場合

日本語の出力形式を次に示します。

プロセスのメモリ使用状況（サービスグループ名：aa....aa）
セグメント情報
使用中のユーザ用FREE属性セグメント数    bb....bb

英語の出力形式を次に示します。

Status of memory used by process (service group name : aa....aa)
Segment information
Number of FREE-attribute segments for using user     bb....bb

出力形式中の，各変数の意味を次に示します。

変数

意味

aa....aa

サービスグループ名

bb....bb

ユーザ用の使用中FREE属性セグメント数

出力メッセージ

メッセージID

内容

出力先

KFSB95101-E

コマンドの形式が不正です。

標準エラー出力

KFSB95102-E

フラグ引数が不正です。

標準エラー出力

KFSB95104-E

オプションの組み合わせが不正です。

標準エラー出力

KFSB95105-E

コマンドが失敗しました。

標準エラー出力

KFSB95106-E

領域の確保に失敗しました。

標準エラー出力

KFSB95107-E

内部矛盾が発生しました。

標準エラー出力

KFSB95120-I

ヘルプメッセージ

標準出力

eenamupdate

名称

ネーム情報の即時更新する。

形式

eenamupdate -g 処理対象サービスグループ名 -o ネーム情報更新サービスグループ名

機能

TP1/Server Baseのネームサーバからネーム情報を取得し，ネーム情報キャッシュを更新します。更新結果は標準出力へ出力します。以降のRPC要求は，更新済みネーム情報を基にRPC要求先が決定されます。

次の場合，本コマンドはエラーとなります。

ネーム機能未使用時（name_use=N）

本コマンドでは，TP1/Server Baseに対するネーム情報検索処理をします。TP1/Server Baseやネットワークの状態によっては，コマンド終了に時間が掛かる場合があります。

また，TP1/Server Baseに対するネーム情報検索処理が失敗した場合，KFSB40360-EメッセージまたはKFSB50390-Eメッセージが出力されます。出力されたメッセージ内容を基に障害要因を取り除いてください。

コマンド失敗時は，ネーム情報キャッシュは更新されません。ただし，ネーム情報検索処理が終了する前に，コマンドプロセスが何らかの理由で異常終了した場合は，キャッシュの更新有無は不定となります。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

処理対象プロセスのサービスグループ名を指定します。

●-o　サービスグループ名　　〜〈1〜31文字の識別子〉

ネーム情報を更新するサービスグループ名を指定します。

出力形式

日本語の出力形式を次に示します。

サービスグループ名＝aa....aa
ノード識別子     IPアドレス           ポート番号
bbbb             cc....cc               dd....dd

英語の出力形式を次に示します。

service group name = aa....aa
Node ID       IP address                    Port
bbbb            cc....cc                dd....dd

出力形式中の，各変数の意味を次に示します。

変数

意味

aa....aa

ネーム情報を更新するサービスグループ名

bbbb

RPC要求先のノード識別子。

RPC要求先がTP1/EEの場合，該当TP1/EEが属するTP1/Server Baseのノード識別子が表示されます。

cc....cc

RPC要求先のIPアドレス

dd....dd

RPC要求先のポート番号。

RPC要求先がTP1/Server Baseのマルチスケジューラの場合，ポート番号の最小値が表示されます。

最新のネーム情報を取得した結果，プロセス未起動などでRPC要求先がない場合は，次のメッセージを出力します。

日本語形式

ネーム情報はありません。

英語形式

There is no name information.

出力メッセージ

メッセージID

内容

出力先

KFSB90301-E

領域の確保に失敗しました。

標準エラー出力

KFSB90302-E

通信障害が発生しました。

標準エラー出力

KFSB90303-E

コマンドの形式が不正です。

標準エラー出力

KFSB90304-E

フラグ引数が不正です。

標準エラー出力

KFSB90305-E

コマンド処理でエラーが発生しました。

標準エラー出力

KFSB90306-E

内部矛盾が発生しました。

標準エラー出力

KFSB90392-E

ネームサービス機能を使用していません。

標準エラー出力

KFSB90396-I

ヘルプメッセージ

標準出力

eerasget

名称

保守資料の取得

形式

eerasget 〔-l｜-s〕 〔-c〕 取得先ファイル名

機能

TP1/EEのトラブルシュートに必要な保守資料を，指定されたファイルに取得します。

eerasgetコマンドは，OpenTP1管理者の権限を持つユーザが，TP1/EEを操作している環境で実行してください。TP1/EEの動作に必要な環境変数を適切に設定しているかどうかを確認してください。また，コマンド実行者がファイルやディレクトリを作成できるように，保守資料を取得するファイルを格納するディレクトリに適切なアクセス権限を設定しておいてください。

eerasgetコマンドは，$DCDIR/spool/dceeinfディレクトリ下の情報を中心とした，TP1/EEのトラブルシュートに必要な保守資料を取得します。保守資料のファイルを格納するディレクトリは，保守資料取得のための一時作業領域としても使用します。eerasgetコマンドを実行する前に$DCDIR/spool/dceeinfディレクトリ下の容量を確認して，保守資料のファイルを格納するために必要な容量を判断してください。保守資料のファイルを格納するディレクトリには，十分な空き容量があるディレクトリを指定してください。

eerasgetコマンドは，TP1/Server Baseのdcrasgetコマンドを実行すると同期して実行されます。この場合，-lオプションを指定したeerasgetコマンドと，-sオプションを指定したeerasgetコマンドが実行されます。

TP1/EE稼働中にeerasgetコマンドを実行した場合，理由コードOS COMMAND FAILEDを付加したKFSB95429-Eメッセージが出力されても，保守資料は問題なく取得されます。

オプション

●-l

状態表示コマンドを実行して取得する情報，環境変数の情報，およびシステム定義ファイルの情報を取得します。

●-s

$DCDIR/spool/dceeinfディレクトリ下のトラブルシュート情報を取得します。

-lオプションおよび-sオプションを省略した場合，状態表示コマンドを実行して取得する情報，環境変数の情報，システム定義ファイルの情報，および$DCDIR/spool/dceeinfディレクトリ下のトラブルシュート情報を取得します。

●-c

保守資料の取得後に，取得先のファイルを圧縮します。

コマンド引数

●取得先ファイル名

保守資料を取得するファイル名をフルパスで指定します。

OSがLinuxの場合，-cオプションを指定して取得先ファイル名の末尾に「.gz」以外を指定すると，取得先ファイル名の末尾に自動的に「.gz」が付加されます。

出力メッセージ

メッセージID

内容

出力先

KFSB95429-E

コマンドでエラーが発生しました。

標準エラー出力

KFSB95436-I

ヘルプメッセージ

標準出力

eerpclscn

名称

RPC通信機能で使用しているコネクションの状態表示

形式

eerpclscn -g サービスグループ名
      〔｛-s サービスグループ名 -n ホスト名 〔-m〕〔-q〕
        ｜-r｜-o ｛all｜clt｜svr｜rep｝｝〕

機能

RPC通信機能で使用しているコネクションの状態を，標準出力に出力します。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

処理対象のサービスグループ名を指定します。

●-s　サービスグループ名　　〜〈1〜31文字の識別子〉

コネクションの状態を表示するサービスグループ名を指定します。サービスグループ情報関連定義のmysvgdef定義コマンドまたはeesvgdef定義コマンドで指定したサービスグループ名を指定してください。

省略時は，全サービスグループ名を対象にします。

●-n　ホスト名　　〜〈1〜255文字のホスト名〉

コネクションの状態を表示するホスト名を指定します。サービスグループ情報関連定義のmysvgdef定義コマンドまたはeesvgdef定義コマンドで指定したサービスグループ名に対応したホスト名を指定してください。

●-m

サービスグループ情報関連定義のmysvgdef定義コマンドで指定したサービスグループのコネクションの状態を表示する場合，指定します。

-mオプションを省略した場合は，サービスグループ情報関連定義のeesvgdef定義コマンドで指定したサービスグループのコネクションの状態を表示します。

●-q

サービスグループ情報関連定義のeesvgdef定義コマンドの-tオプションでDBQを指定したサービスグループのコネクションの状態を表示する場合に指定します。

サービスグループ情報関連定義のmysvgdef定義コマンドの-tオプションでDBQを指定したサービスグループのコネクションの状態も一緒に表示する場合は，-qオプションと-mオプションの両方を指定してください。

●-r

RPC応答送受信用コネクションの状態を表示する場合，指定します。-rオプションを指定した場合，-sオプション，-nオプション，および-mオプションの指定は無視されます。

●-o　｛all｜clt｜svr｜rep｝

コネクション確立先の情報を表示する場合に指定します。表示する情報は，INETドメインを使用して確立しているコネクションだけです。このオプション指定時は，-sオプション，-nオプション，-mオプション，-qオプション，および-rオプションの指定は無視されます。このオプションでは，DBキュー機能用，およびRAP機能用のソケットは表示されません。

all

すべてのソケットを表示します。

clt

クライアント用ソケット（サービスグループ情報関連定義のeesvgdef定義コマンドで指定したソケット）だけを表示します。

svr

サーバ用ソケット（サービスグループ情報関連定義のmysvgdef定義コマンドで指定したソケット）だけを表示します。

rep

送受信用ソケット（サービスグループ情報関連定義のmyreplydef定義コマンドで指定したソケット）だけを表示します。

出力形式

●-rオプションおよび-oオプションの指定を省略した場合

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

出力形式中の，右端の数字の意味を次に示します。

1：サービスグループ数分表示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa....aa

処理対象のTP1/EEサービスグループ名

bb....bb

コネクションの状態を表示するサービスグループ名

cc....cc

コネクションの状態を表示するホスト名

dd....dd

cc....ccに対応したIPアドレス

ee....ee

ポート番号

ffffff

ソケット種別

CLIENT…クライアント用ソケット

SERVER…サーバ用ソケット

CLT_DB…DBキュー機能（TCP/IP通信）で使用するクライアント用ソケット

SRV_DB…DBキュー機能（TCP/IP通信）で使用するサーバ用ソケット

CLT_RP…リモートAPI機能で使用するクライアント用ソケット

gg....gg

ホスト下のソケット（コネクション）定義数

hh....hh

ホスト下のコネクション確立済みソケット数

表示対象がない場合，日本語では「表示対象がありません。」を，英語では「There is no connection to be displayed.」を表示します。

●-rオプションを指定した場合

日本語の出力形式を次に示します。

ＩＰアドレス       ポート番号  ソケット種別  確立済ソケット数
aa....aa           bb....bb    cc....cc        dd....dd

英語の出力形式を次に示します。

IP address              Port   Socket type        Socket_num
aa....aa            bb....bb      cc....cc          dd....dd

出力形式中の，各変数の意味を次に示します。

変数

意味

aa....aa

コネクションの状態を表示するIPアドレス

cc....ccがPREREPの場合は，自ホストの情報を表示します。

bb....bb

コネクションの状態を表示するポート番号

cc....ccがPREREPの場合は，自ホストの情報を表示します。

cc....cc

ソケット種別

PREREP…応答用ソケット（相手情報未確定）

REPLY…応答用ソケット

dd....dd

コネクション確立済みソケット数

表示対象がない場合，日本語では「ＲＰＣ応答送受信用の確立済コネクションはありません。」を，英語では「There is no pre-established connection for the send/receive of RPC responses.」を表示します。

●-oオプションを指定した場合

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

出力形式中の，右端の数字の意味を次に示します。

1および2：改行を含まないで1行で表示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa....aa

コネクションの状態を表示するIPアドレス

bbbbb

listenポートのポート番号

ccccc

相手ホストのポート番号

ddddd

自ホストのポート番号

eeeee

ソケット種別

CLIENT…クライアント用ソケット

SERVER…サーバ用ソケット

REPLY…送受信用ソケット

ff....ff

一時クローズ状態

−…一時クローズ機能未使用

NORMAL…一時クローズ処理未実施

PROCESS…一時クローズ処理中

WAIT…一時クローズ処理後の応答待ち

REFUSED…一時クローズ処理対象外

y1/m1/d1 h1:m1:s1

コネクション確立時刻

「年/月/日△時:分:秒」の形式で出力します。

y2/m2/d2 h2:m2:s2

コネクション最終使用時刻

「年/月/日△時:分:秒」の形式で出力します。

表示対象がない場合，日本語では「表示対象のコネクションがありません。」を，英語では「There is no connection to be displayed.」を表示します。

出力メッセージ

メッセージID

内容

出力先

KFSB90301-E

領域の確保に失敗しました。

標準エラー出力

KFSB90302-E

通信障害が発生しました。

標準エラー出力

KFSB90303-E

コマンドの形式が不正です。

標準エラー出力

KFSB90304-E

フラグ引数が不正です。

標準エラー出力

KFSB90305-E

コマンド処理でエラーが発生しました。

標準エラー出力

KFSB90306-E

内部矛盾が発生しました。

標準エラー出力

KFSB90307-E

オプションフラグの組み合わせが不正です。

標準エラー出力

KFSB90330-I

ヘルプメッセージ

標準出力

注意事項

ソケット種別がCLT_RPの場合は，ソケット定義数と確立済みソケット数に0が表示されます。ソケット定義数と確立済みソケット数を確認したい場合は，eerpcraplsコマンドを使用してください。

eerpcnamdel

名称

ネームサービスのネーム情報の削除

形式

eerpcnamdel -u ユーザサーバ名

機能

ネームサービスに登録しているネーム情報を削除します。

このコマンドを実行する場合は，TP1/EEが起動されていないことを確認してください。起動中のTP1/EEに対してこのコマンドを実行した場合，ほかのOpenTP1からのサービス要求を受け付けなくなることがあります。

なお，このコマンドは，eesvstopコマンドを実行すると自動的に実行されます。

オプション

●-u　ユーザサーバ名　　〜〈1〜31文字の識別子〉

ネーム情報を削除するユーザサーバ名を指定します。

出力メッセージ

メッセージID

内容

出力先

KFSB90301-E

領域の確保に失敗しました。

標準エラー出力

KFSB90302-E

通信障害が発生しました。

標準エラー出力

KFSB90303-E

コマンドの形式が不正です。

標準エラー出力

KFSB90304-E

フラグ引数が不正です。

標準エラー出力

KFSB90305-E

コマンド処理でエラーが発生しました。

標準エラー出力

KFSB90306-E

内部矛盾が発生しました。

標準エラー出力

KFSB90307-E

オプションフラグの組み合わせが不正です。

標準エラー出力

KFSB90380-I

ヘルプメッセージ

標準出力

eerpcrapcls

名称

常設コネクションの切断

形式

eerpcrapcls -g サービスグループ名 -i サービスID

機能

rap機能で使用している常設コネクションを切断します。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

常設コネクションを切断するサービスグループ名を指定します。

●-i　サービスID　　〜〈1〜4294967295〉

常設コネクションを切断するサービスIDを指定します。eerpcraplsコマンドで取得した値を指定してください。

出力メッセージ

メッセージID

内容

出力先

KFSB90301-E

領域の確保に失敗しました。

標準エラー出力

KFSB90302-E

通信障害が発生しました。

標準エラー出力

KFSB90303-E

コマンドの形式が不正です。

標準エラー出力

KFSB90304-E

フラグ引数が不正です。

標準エラー出力

KFSB90305-E

コマンド処理でエラーが発生しました。

標準エラー出力

KFSB90306-E

内部矛盾が発生しました。

標準エラー出力

KFSB90307-E

オプションフラグの組み合わせが不正です。

標準エラー出力

KFSB90365-I

ヘルプメッセージ

標準出力

KFSB90366-I

コネクションを切断します。

標準出力

KFSB90367-E

指定されたサービスIDは無効です。

標準エラー出力

KFSB90368-E

指定されたサービスIDは解放できない状態です。

標準エラー出力

eerpcrapls

名称

常設コネクション状態表示

形式

eerpcrapls -g サービスグループ名

機能

rap機能で使用している常設コネクションの状態を標準出力に出力します。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

常設コネクションの状態を表示するサービスグループ名を指定します。

出力形式

●rapサーバおよびrapクライアントとして動作している場合

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

●rapサーバとして動作している場合

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

●rapクライアントとして動作している場合

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa....aa

常設コネクション数

bbbbb

rap要求同時処理数（現在の同時処理数）※

ccccc

rap要求同時処理数（現在までの最大同時処理数）※

ddddd

rap要求同時処理数（同時処理可能最大数）※

eeeee

rap処理待ち要求数（現在の処理待ち数）※

fffff

rap処理待ち要求数（現在までの最大処理待ち数）※

ggggg

rap処理待ち要求数（処理待ち可能最大数）※

hh....hh

サービスID

ii-jj

常設コネクションの状態

ii-jjの組み合わせと意味を次に示します。

CN-W1：常設コネクション確立要求メッセージ待ち

CN-W2：常設コネクション確立要求処理待ち

CN-SN：常設コネクション確立応答メッセージ送信中

CN-SE：常設コネクション確立エラー応答メッセージ送信中

AP-W1：代理実行要求待ち

AP-W2：代理実行要求処理待ち

AP-RN：代理実行処理中

AP-SN：代理実行応答メッセージ送信中

RL-WT：WT 常設コネクション解放要求処理待ち

RL-SN：常設コネクション解放応答メッセージ送信中

RF-WT：常設コネクション解放指示処理待ち

RF-SN：常設コネクション解放指示メッセージ送信中

NN-WT：TCPコネクション切断待ち

kk....kk

クライアントのIPアドレス

常設コネクションの確立前，またはrapクライアントがTP1/Client/Jの場合は，「0.0.0.0」が表示されることがあります。

ll....ll

クライアントのポート番号

常設コネクションの確立前，またはrapクライアントがTP1/Client/Jの場合は，「0」が表示されることがあります。

mmmm

使用コネクション数（使用している常設コネクション数）

nnnn

使用コネクション数（現在までに使用した常設コネクション最大数）

oooo

確立コネクション数（確立中の常設コネクション数）

pppp

確立コネクション数（現在までに確立した常設コネクション最大数）

qqqq

確立コネクション数（確立できる常設コネクションの最大数）（RPC関連定義のrpc_rap_connection_countオペランドの指定値）

rr....rr

常設コネクションの最大数を超過したことが原因で，常設コネクションを解放した回数

s

常設コネクションの種別

S…rapサーバ

C…rapクライアント

tt-uu

常設コネクションの状態

tt-uuの組み合わせと意味を次に示します。

CN-RN：常設コネクション確立中

CN-FR：常設コネクション確立済み

AP-RN：代理実行処理中

RL-RN：常設コネクション解放中

NN-RN：TCPコネクション確立中

NN-W1：TCPコネクション切断待ち

NN-W2：TCPコネクション切断待ち（コネクションを再利用）

vv....vv

サーバのIPアドレス

常設コネクションの確立前，またはrapクライアントがTP1/Client/Jの場合は，「0.0.0.0」が表示されることがあります。

ww....ww

サーバのポート番号

常設コネクションの確立前，またはrapクライアントがTP1/Client/Jの場合は，「0」が表示されることがあります。

yy/mm/dd hh:mm:ss

サーバが割り当てられた日時

「年/月/日△時:分:秒」の形式で表示します。「年」は西暦の下2けたを表示します。

YY/MM/DD HH:MM:SS

サーバが最後に要求を受け付けた日時

「年/月/日△時:分:秒」の形式で表示します。「年」は西暦の下2けたを表示します。

注※

0パディングされ，5けたの数値が表示されます。

リモートAPI機能を使用していても表示対象がない場合，日本語では「使用中の常設コネクションはありません。」を，英語では「There are no permanent connections in use.」を表示します。

出力メッセージ

メッセージID

内容

出力先

KFSB90301-E

領域の確保に失敗しました。

標準エラー出力

KFSB90302-E

通信障害が発生しました。

標準エラー出力

KFSB90303-E

コマンドの形式が不正です。

標準エラー出力

KFSB90304-E

フラグ引数が不正です。

標準エラー出力

KFSB90305-E

コマンド処理でエラーが発生しました。

標準エラー出力

KFSB90306-E

内部矛盾が発生しました。

標準エラー出力

KFSB90307-E

オプションフラグの組み合わせが不正です。

標準エラー出力

KFSB90360-I

ヘルプメッセージ

標準出力

eerpcsockcls

名称

RPC通信機能で使用しているコネクションの切断

形式

eerpcsockcls -g サービスグループ名 -i IPアドレス
           〔〔-l listenポート番号〕〔-o 相手ポート番号〕
           〔-m 自ポート番号〕〕〔-f〕

機能

RPC通信機能で使用しているコネクションを切断します。

コネクション接続先のマシンがダウンしたなどの場合，コネクション確立時刻（eerpclscnコマンドの-oオプションで確認可能）がマシンダウンした時刻よりも前であれば，このコマンドを使用してコネクションを切断してください。

切断するコネクションはeerpclscnコマンドの-oオプションを指定して確認します。また，コネクションの切断が成功したかどうかも，eerpclscnコマンドの-oオプションを指定して確認します。

このコマンドで受信コネクションを切断した場合，実際に切断されるまでに，最大で10秒掛かることがあります。なお，コネクション最大数（mysvgdefコマンドの-sオプションに指定した値）に達していた場合でも，コネクション確立要求を受けた時点で対象のコネクションが切断されるため，新たにコネクション確立要求を受けられます。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

コネクションを切断するサービスグループ名を指定します。

●-i　IPアドレス　　〜〈7〜15文字の符号なし整数〉

コネクション確立先のIPアドレスを指定します。IPアドレスを指定する場合は，xxx.xxx.xxx.xxxの形式で指定します。xxxは，0〜255（10進数）で指定します。

-lオプションと-oオプションと-mオプションを省略した場合は，-iオプションで指定したIPアドレスとの間のコネクションをすべて切断します。

●-l　listenポート番号　　〜〈1〜65535〉

切断するコネクションのlistenポート番号を指定します。

●-o　相手ポート番号　　〜〈1〜65535〉

切断するコネクションの相手ポート番号を指定します。

●-m　自ポート番号　　〜〈1〜65535〉

切断するコネクションの自ポート番号を指定します。

●-ｆ

切断対象のコネクションがコマンド受け付け時点で送信中の場合，送信処理を中断（送信処理はエラーリターン（EERPCER_NET_DOWN）する）し，そのコネクションを切断します。

このオプションを指定し，かつ，コマンドが正常リターンした場合は，指定されたコネクションは切断されています。

このオプションの指定は，「送信コネクション」または「送受信コネクション」の場合だけ，有効です。上記以外のコネクションに指定した場合は，このオプションの指定は無視します。

このオプションを指定しない場合，送信中のコネクションはコマンド実行後も切断されません。

出力形式

日本語の出力形式を次に示します。

KFSB90339-I コネクション切断を受け付けました。IPアドレス＝aa....aa，
listenポート番号＝bb....bb，相手ポート番号＝cc....cc，自ポート番号＝dd....dd

英語の出力形式を次に示します。

KFSB90339-I The connection close has been accepted. IP-address = aa....aa,
listen port number = bb....bb, target port number = cc....cc, local port number = dd....dd

-lオプションと-oオプションと-mオプションを省略し，かつコネクションを切断した場合は，出力形式のポート番号には「0」が表示されます。

出力メッセージ

メッセージID

内容

出力先

KFSB90301-E

領域の確保に失敗しました。

標準エラー出力

KFSB90302-E

通信障害が発生しました。

標準エラー出力

KFSB90303-E

コマンドの形式が不正です。

標準エラー出力

KFSB90304-E

フラグ引数が不正です。

標準エラー出力

KFSB90305-E

コマンド処理でエラーが発生しました。

標準エラー出力

KFSB90306-E

内部矛盾が発生しました。

標準エラー出力

KFSB90338-I

ヘルプメッセージ

標準出力

KFSB90339-I

コネクション切断を受け付けました。

標準出力

eerpcspndls

名称

RPC応答メッセージ送信抑止状態の表示

形式

eerpcspndls -g サービスグループ名

機能

RPC応答メッセージの送信抑止状態を表示します。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

RPC応答メッセージの送信抑止状態を表示するサービスグループ名を指定します。

出力形式

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa....aa

サービス名

bb....bb

抑止識別子（10進数，右詰め）

yy/mm/dd hh:mm:ss

抑止開始日時

「年/月/日△時:分:秒」の形式で表示します。「年」は西暦の下2けたを表示します。

YY/MM/DD HH:MM:SS

タイムアウト日時

「年/月/日△時:分:秒」の形式で表示します。「年」は西暦の下2けたを表示します。タイムアウト日時が無制限の場合は，「-」を表示します。

cc....cc

送信先のIPアドレス

dd....dd

送信先のポート番号

表示対象がない場合，日本語では「送信抑止状態のＲＰＣ応答メッセージはありません。」を，英語では「There are no RPC response messages for which transmission is suppressed.」を表示します。

出力メッセージ

メッセージID

内容

出力先

KFSB90301-E

領域の確保に失敗しました。

標準エラー出力

KFSB90302-E

通信障害が発生しました。

標準エラー出力

KFSB90303-E

コマンドの形式が不正です。

標準エラー出力

KFSB90304-E

フラグ引数が不正です。

標準エラー出力

KFSB90305-E

コマンド処理でエラーが発生しました。

標準エラー出力

KFSB90306-E

内部矛盾が発生しました。

標準エラー出力

KFSB90307-E

オプションフラグの組み合わせが不正です。

標準エラー出力

KFSB90350-I

ヘルプメッセージ

標準出力

eerpcspndrles

名称

RPC応答メッセージ送信抑止状態の解放

形式

eerpcspndrles -g サービスグループ名 -i 抑止識別子

機能

RPC応答メッセージ送信抑止状態を解放します。

抑止状態のRPC応答メッセージは，eerpcspndrlesコマンドの処理終了後に解放されます。解放処理は5秒間隔で実行されるため，解放までに最大5秒の遅延が発生する場合があります。

抑止中のサービス関数には，RPCエラー応答メッセージ（EERPCER_TIMED_OUT）が送信されます。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

RPC応答メッセージ送信抑止状態を解放するサービスグループ名を指定します。

●-i　抑止識別子　　〜〈1〜4294967295〉

RPC応答メッセージ送信抑止状態を解放するサービスの抑止識別子を指定します。抑止識別子はeerpcspndlsコマンドで取得した値を指定してください。

出力メッセージ

メッセージID

内容

出力先

KFSB90301-E

領域の確保に失敗しました。

標準エラー出力

KFSB90302-E

通信障害が発生しました。

標準エラー出力

KFSB90303-E

コマンドの形式が不正です。

標準エラー出力

KFSB90304-E

フラグ引数が不正です。

標準エラー出力

KFSB90305-E

コマンド処理でエラーが発生しました。

標準エラー出力

KFSB90306-E

内部矛盾が発生しました。

標準エラー出力

KFSB90307-E

オプションフラグの組み合わせが不正です。

標準エラー出力

KFSB90355-I

ヘルプメッセージ

標準出力

KFSB90356-I

RPC応答メッセージ送信抑止状態を解放します。

標準出力

KFSB90357-E

指定された抑止識別子は無効です。

標準エラー出力

eerpcstat

目的

一時クローズ処理の実行状態の表示

形式

eerpcstat -g サービスグループ名 〔-t {all｜svr｜rep}〕

機能

一時クローズ処理の実行状態を表示します。このコマンドで表示する内容は，統計情報ではなくコマンド入力時点での一時クローズ処理の実行状況です。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

対象となるTP1/EEプロセスのサービスグループ名を指定します。

●-t　{all｜svr｜rep}

コネクションごとの一時クローズ処理の実行状態を表示します。

省略時は，-t allが仮定されます。

all

すべてのコネクションの状態を表示します。

svr

受信用コネクションだけを表示します（mysvgdefで指定したソケット）。

rep

送受信用コネクションを表示します。

出力形式

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa....aa

処理対象のTP1/EEサービスグループ名

bbbbbb

コネクション種別

SERVER…受信用コネクション

REPLY…送受信用コネクション

cc....cc

ソケット定義数

受信用コネクション…mysvgdefオペランドの-sオプション指定値

送受信用コネクション…rpc_reply_con_max_cntオペランド指定値

dd....dd

確立済みソケット数

ee....ee1

一時クローズ要求電文送信済みのソケット数（現時点で要求処理中のソケット数）

ee....ee2

一時クローズ要求電文送信済みのソケット数（現在までの要求処理合計数）

ff....ff1

一時クローズ要求電文受信済みのソケット数（現時点で受付処理中のソケット数）

ff....ff2

一時クローズ要求電文受信済みのソケット数（現在までの受付処理合計数）

ggg

一時クローズ開始数パーセンテージ（単位：%）

hhh

一時クローズ非対象数パーセンテージ（単位：%）

ii....ii

一時クローズによってクローズしたソケット数

jj....jj

一時クローズ要求送信を拒否したソケット数

kkk.kkk.kkk.kkk

IPアドレス

受信用コネクション…自IPアドレス

送受信用コネクション…自IPアドレス

lllll

ポート番号

受信用コネクション…自ポート番号

送受信用コネクション…自ポート番号

bbbbbb〜lllllは，コネクション種別ごとに表示されます。また，受信用コネクションは受信スレッドごと（mysvgdefの自ポート番号単位）に表示されます。

出力メッセージ

メッセージID

内容

出力先

KFSB90301-E

領域の確保に失敗しました。

標準エラー出力

KFSB90302-E

通信障害が発生しました。

標準エラー出力

KFSB90303-E

コマンドの形式が不正です。

標準エラー出力

KFSB90304-E

フラグ引数が不正です。

標準エラー出力

KFSB90305-E

コマンド処理でエラーが発生しました。

標準エラー出力

KFSB90306-E

内部矛盾が発生しました。

標準エラー出力

KFSB90394-I

ヘルプメッセージ

標準出力

eerpctcpls

名称

TCP/IP共有送信用コネクションの状態表示

形式

eerpctcpls -g サービスグループ名

機能

TCP/IP共有送信用コネクションの状態を表示します。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

TCP/IP共有送信用コネクションの状態を表示するサービスグループ名を指定します。

出力形式

日本語の出力形式を次に示します。

サービスグループ名＝aa....aa
ＩＰアドレス    ポート番号  ソケット定義数  確立済ソケット数  自ＩＰアドレス
bb....bb         cc....cc     dd....dd        ee....ee          ff....ff

英語の出力形式を次に示します。

service group name = aa....aa
IP address              Port  Socket_def_num        Socket_num  My IP address
bb....bb            cc....cc        dd....dd          ee....ee  ff....ff

出力形式中の，各変数の意味を次に示します。

変数

意味

aa....aa

サービスグループ名

bb....bb

接続先プロセスのIPアドレス

cc....cc

接続先プロセスのポート番号

dd....dd

接続先プロセス下のソケット（コネクション）定義数（RPC関連定義のrpc_tcpsend_con_cntオペランドの指定値）

ee....ee

接続先プロセス下のコネクション確立済みのソケット数

ff....ff

自ホストのIPアドレス

TCP/IP共有送信用コネクションを使用する機能から接続要求があった場合に表示します。接続要求がない場合は，「-」を表示します。

表示対象がない場合，日本語では「ＴＣＰ／ＩＰ共用送信用の確立済コネクションはありません。」を，英語では「There is no pre-established connection for TCP/IP common transmission.」を表示します。

出力メッセージ

メッセージID

内容

出力先

KFSB90301-E

領域の確保に失敗しました。

標準エラー出力

KFSB90302-E

通信障害が発生しました。

標準エラー出力

KFSB90303-E

コマンドの形式が不正です。

標準エラー出力

KFSB90304-E

フラグ引数が不正です。

標準エラー出力

KFSB90305-E

コマンド処理でエラーが発生しました。

標準エラー出力

KFSB90306-E

内部矛盾が発生しました。

標準エラー出力

KFSB90307-E

オプションフラグの組み合わせが不正です。

標準エラー出力

KFSB90386-I

ヘルプメッセージ

標準出力

eesgrpctl

名称

サービスグループの閉塞，閉塞解除，および，閉塞状態の表示

形式

eesgrpctl -g サービスグループ名 {-s｜-r｜-l}

機能

サービスグループの閉塞，閉塞解除，および閉塞状態を表示します。

次のどれかの条件を満たす場合，サービスグループの閉塞および閉塞解除要求はエラーとなります。

MCP機能使用時（mcp_use=Y）

XTC機能使用時（xtc_use=Y）

ネーム機能未使用時（name_use=N）

本コマンドのサービスグループ閉塞（-s），閉塞解除（-r）の延長で，親TP1/Server Base，および親TP1/Server Baseのall_nodeで指定された他TP1/Server Baseに対して，ネーム情報登録／登録解除処理が行われます。

TP1/Server Baseやネットワークの状態によっては，コマンド終了に時間が掛かる場合があります。また，TP1/Server Baseに対するネーム情報登録／登録解除処理が失敗した場合，KFSB40360-EメッセージまたはKFSB50390-Eメッセージが出力されます。出力されたメッセージ内容を基に障害要因を取り除いてください。

サービスグループ閉塞，および閉塞解除が失敗した場合，サービスグループ閉塞状態はOBSまたはBIDとなります。この状態はプロセス間のネーム情報が不整合となり，RPC要求などが意図しない動作となるおそれがあります。そのため，障害要因を取り除いたあとに，再度コマンドを実行し，処理を正常終了させてください。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

処理対象のサービスグループ名を指定します。

●-s

サービスグループを閉塞する場合に指定します。

●-r

サービスグループを閉塞解除する場合に指定します。

●-l

サービスグループの閉塞状態を表示する場合に指定します。

出力形式

日本語の出力形式を次に示します。

サービスグループ閉塞状態＝aa....aa

英語の出力形式を次に示します。

service group status = aa....aa

出力形式中の，各変数の意味を次に示します。

変数

意味

aa....aa

サービスグループ閉塞状態

INA…閉塞中

DTP…閉塞処理中（閉塞処理時にエラーが発生した場合だけ出力されます）

ACT…閉塞解除中

BID…閉塞解除処理中（閉塞解除処理時にエラーが発生した場合だけ出力されます）

出力メッセージ

メッセージID

内容

出力先

KFSB90301-E

領域の確保に失敗しました。

標準エラー出力

KFSB90302-E

通信障害が発生しました。

標準エラー出力

KFSB90303-E

コマンドの形式が不正です。

標準エラー出力

KFSB90304-E

フラグ引数が不正です。

標準エラー出力

KFSB90305-E

コマンド処理でエラーが発生しました。

標準エラー出力

KFSB90306-E

内部矛盾が発生しました。

標準エラー出力

KFSB90392-E

ネームサービス機能を使用していません。

標準エラー出力

KFSB90399-I

ヘルプメッセージ

標準出力

eestsclose

名称

ステータスファイルのクローズ

形式

eestsclose -g サービスグループ名 ｛-n 論理ファイル名｜-f 物理ファイル名｝

機能

オープン状態のステータスファイルをクローズします。

eestscloseコマンドでクローズできるファイルは，ステータスファイル関連定義で指定した制御用ステータスファイルだけです。TP1/EEがオンライン中のときにクローズできます。

現用使用中のファイルはクローズできません。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

TP1/EEプロセスのサービスグループ名を指定します。

●-n　論理ファイル名　　〜〈1〜8文字の識別子〉

クローズする論理ファイルの名称を指定します。指定した論理ファイルを構成するA系ファイルとB系ファイルを両方同時にクローズします。

次の場合に指定できます。

A系ファイル，B系ファイルのどちらかが，BLOCKADE，またはSTANDBY状態の場合

A系ファイル，B系ファイルの両方が，BLOCKADE，またはSTANDBY状態の場合

論理ファイル名を指定すると，物理ファイルのパス名を意識する必要はありません。

●-f　物理ファイル名　　〜〈パス名〉

クローズする物理ファイルの名称をパス名で指定します。

予備状態の系をクローズするときに指定します。

なお，「eestsclose -f　A系物理ファイル名」，「eestsclose -f　B系物理ファイル名」と2回eestscloseコマンドを実行するのは，「eestsclose -n　論理ファイル名」と実行するのと同じことです。

出力メッセージ

メッセージID

内容

出力先

KFSB91001-E

コマンドの形式が不正です。

標準エラー出力

KFSB91002-E

フラグ引数が不正です。

標準エラー出力

KFSB91003-E

フラグ引数の組み合わせが不正です。

標準エラー出力

KFSB91004-E

コマンドが失敗しました。

標準エラー出力

KFSB91005-E

領域の確保に失敗しました。

標準エラー出力

KFSB91006-E

内部矛盾が発生しました。

標準エラー出力

KFSB91053-I

ヘルプメッセージ

標準出力

eestsfills

名称

ステータスファイルの内容表示

形式

eestsfills -f 物理ファイル名 〔-cx〕

機能

ステータスファイルの内容を，オフラインで標準出力に出力します。

オプション

●-f　物理ファイル名　　〜〈パス名〉

物理ファイルの名称をパス名で指定します。

●-c

ステータスファイルをチェックします。チェック内容を次に示します。

レコード（先頭，終端）整合性チェック番号によるレコード破壊チェック

eestsinitコマンド実行時のファイル管理情報によるレコード長，レコード数チェック

ステータスファイル管理情報によるファイル更新完了チェック

ステータスファイル管理情報内のレコード数，レコード種別チェック

チェック結果が不正の場合，指定したステータスファイルの内容を表示したあとに，エラーメッセージを出力します。

-cオプションの指定を省略すると，ステータスファイルはチェックされません。

●-x

ステータスファイルを排他的にオープンします。そのため，TP1/EE開始時にeestsfillsコマンドを実行すると，TP1/EEが排他エラーで異常終了する場合があります。

-xオプションの指定を省略すると，ステータスファイルは排他的にオープンされません。そのため，指定したステータスファイルをTP1/EEで使用中（現用，または予備の状態）の場合，正しい状態が表示されない場合があります。

出力形式

●-sオプションにtrnを指定した場合

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa....aa

物理ファイル名（510文字以内）

yy/mm/dd hh:mm:ss

初期設定日時

「年/月/日△時:分:秒」の形式で表示します。「年」は西暦の下2けたを表示します。

YY/MM/DD HH:MM:SS

現用決定日時

「年/月/日△時:分:秒」の形式で表示します。「年」は西暦の下2けたを表示します。

現用ファイルとして使用されていない場合，「--/--/-- --:--:--」を表示します。

bb....bb

レコード長（10進数）（単位：バイト）

cc....cc

レコード数（10進数）

ddd

ファイル内のレコード使用率（1〜3けた）（単位：%）

ee....ee

ファイル内の最大連続空きレコード数（10進数）

ff....ff

ファイル内の管理レコード数（10進数）

出力メッセージ

メッセージID

内容

出力先

KFSB91001-E

コマンドの形式が不正です。

標準エラー出力

KFSB91002-E

フラグ引数が不正です。

標準エラー出力

KFSB91004-E

コマンドが失敗しました。

標準エラー出力

KFSB91005-E

領域の確保に失敗しました。

標準エラー出力

KFSB91006-E

内部矛盾が発生しました。

標準エラー出力

KFSB91007-E

ステータス物理ファイルでエラーが発生しました。

標準エラー出力

KFSB91054-I

ヘルプメッセージ

標準出力

注意事項

障害が発生したファイルや破壊されたファイルに対する表示内容は，不正となる場合があります。

eestsinit

名称

ステータスファイルの作成，初期設定

形式

eestsinit -f 物理ファイル名 〔-s レコード長〕 〔-c レコード数〕

機能

TP1EEファイルを作成し，ステータスサービスが使用できる形式に初期設定します。

TP1EEがオンラインで使用中（現用，または予備の状態）のステータスファイルは初期設定できません。

オプション

●-f　物理ファイル名　　〜〈パス名〉

初期設定する物理ファイルの名称をパス名で指定します。

ステータスファイル関連定義のstsflnam定義コマンドで指定したステータスファイル名と同じ名称を指定してください。

●-s　レコード長　　〜((512〜32768))《4608》（単位：バイト）

ステータスファイルのレコード長を指定します。TP1EEファイルシステム作成時（eefilmkfsコマンド）に指定したセクタ長の倍数を指定してください。

●-c　レコード数　　〜((32〜4194304))《256》

ステータスファイルのレコード数を指定します。

出力メッセージ

メッセージID

内容

出力先

KFSB91001-E

コマンドの形式が不正です。

標準エラー出力

KFSB91002-E

フラグ引数が不正です。

標準エラー出力

KFSB91003-E

フラグ引数の組み合わせが不正です。

標準エラー出力

KFSB91005-E

領域の確保に失敗しました。

標準エラー出力

KFSB91006-E

内部矛盾が発生しました。

標準エラー出力

KFSB91007-E

ステータス物理ファイルでエラーが発生しました。

標準エラー出力

KFSB91055-I

ヘルプメッセージ

標準出力

注意事項

TP1/EEが稼働中のときだけ，現用ステータスファイルを管理しています。そのため，オンライン中に使用した現用のステータスファイルを初期設定しないように注意してください。

物理ファイルのレコード長は，制御用ステータスファイル，シグナル用ステータスファイルごとに同じ値にしてください。また，ステータスファイル関連定義のsts_control_buffer_lengthオペランドおよびsts_signal_buffer_lengthオペランドに指定するバッファ長と同じになるよう初期設定してください。

一つのステータスファイルグループを構成する物理ファイルは，レコード数が同じになるように初期設定してください。オンライン中は，レコード数およびレコード長を変更できません。変更した場合は，正常開始で再起動してください。

レコード長は，仮定値を使用することをお勧めします。レコード長が4608バイトより短いとステータスファイルの入出力回数が増加します。4608バイトより長いとステータスファイルの使用効率が悪くなります。

ステータスファイルのレコード数はTP1/EEのシステム構成に依存します。オンライン中の場合はeestslsコマンドで，オフラインの場合はeestsfillsコマンドでステータスファイルのレコード使用率を確認できます。レコード使用率を参考にしてレコード数を設定してください。

同一のTP1EEファイルシステムに対して，eestsinitコマンドおよびeestsrmコマンドを同時に実行しないでください。

シグナル用ステータスファイルのレコード数は，最小値の32で問題ありません。レコード数は，次の計算式の値以内で設定してください。算出された値を超過すると，TP1/EEを起動できません。

C≦2×R−80

（凡例）

C：シグナル用ステータスファイルのレコード数（eestsinitコマンドの-cオプションの指定値）

R：シグナル用ステータスファイルのレコード長（eestsinitコマンドの-sオプションの指定値）

eestsls

名称

ステータスファイルの状態表示

形式

eestsls -g サービスグループ名
    〔｛-r ファイルグループ番号｜-n 論理ファイル名｜-f 物理ファイル名｜-l｜-p｝〕

機能

ステータスファイルの状態を，オンライン中に標準出力に出力します。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

TP1/EEプロセスのサービスグループ名を指定します。

●-r　ファイルグループ番号　　〜〈0〜16〉

ステータスファイルの状態を表示するファイルグループ番号を指定します。

指定されたファイルグループ番号内のすべての論理ファイルおよび物理ファイルの状態を表示します。

●-n　論理ファイル名　　〜〈1〜8文字の識別子〉

状態を表示する論理ファイルの名称を指定します。

指定された論理ファイル，および論理ファイル中のすべての物理ファイルの状態を表示します。

●-f　物理ファイル名　　〜〈パス名〉

状態を表示する物理ファイルの名称をパス名で指定します。

●-l

ステータスファイルの使用中のすべての論理ファイルの状態を表示します。

●-p

ステータスファイルの使用中のすべての物理ファイルの状態を表示します。

すべてのオプションの指定を省略すると，使用中のすべてのステータスファイルの状態を表示します。

出力形式

●-rオプションを指定した場合，またはすべてのオプションを省略した場合

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

出力形式中の，右端の数字の意味を次に示します。

1：物理ファイル状態表示部

状態を表示する物理ファイル数分表示します。

2：論理ファイル状態表示部

状態を表示する論理ファイル数分表示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa....aa

グループ番号

bb....bb

論理ファイル名（8文字以内）

cc....cc

論理ファイル状態

ACTIVE…現用ファイル

BLOCKADE…障害閉塞ファイル

CLOSE…無効ファイル（クローズ中）

NONE…無効ファイル（ファイル実体がない）

STANDBY…予備ファイル

ddd

ファイル内のレコード使用率（1〜3けたの%表示）

現用ファイル以外の場合，「-」を表示します。

ee....ee

ファイル内の最大連続空きレコード数（10進数）

現用ファイル以外の場合，「-」を表示します。

ff....ff

ファイル内管理レコード数（10進数）

現用ファイル以外の場合，「-」を表示します。

g

物理ファイルがA系かB系かの表示

A…A系

B…B系

hh....hh

物理ファイル状態

複数の状態が共存する場合，複数表示します。

a…現用ファイル

b…障害閉塞ファイル

c…クローズファイル

i…初期設定状態

l…論理エラー

n…ファイル実体がない状態

o…オープンファイル

p…物理エラー

r…障害情報によるファイル状態回復

s…予備ファイル

u…使用済みファイル

ii....ii

レコード長（10進数）（単位：バイト）

jj....jj

レコード数（10進数）

kk....kk

物理ファイル名（510文字以内）

●-nオプションを指定した場合

-nオプションで指定した論理ファイルについて，-rオプションを指定した場合の2の部分を表示します。

●-fオプションを指定した場合

-fオプションで指定した物理ファイルについて，-rオプションを指定した場合の1の部分を表示します。

●-lオプションを指定した場合

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

出力形式中の，右端の数字の意味を次に示します。

1：論理ファイル状態表示部

ステータスファイルで使用中の論理ファイル数分表示されます。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa....aa

グループ番号

bb....bb

論理ファイル名（8文字以内）

cc....cc

論理ファイル状態

ACTIVE…現用ファイル

BLOCKADE…障害閉塞ファイル

CLOSE…無効ファイル（クローズ中）

NONE…無効ファイル（ファイル実体がない）

STANDBY…予備ファイル

ddd

ファイル内のレコード使用率（1〜3けたの%表示）

現用ファイル以外の場合，「-」を表示します。

ee....ee

ファイル内の最大連続空きレコード数（10進数）

現用ファイル以外の場合，「-」を表示します。

ff....ff

ファイル内管理レコード数（10進数）

現用ファイル以外の場合，「-」を表示します。

●-pオプションを指定した場合

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa....aa

グループ番号

論理ファイル数分表示されます。

bb....bb

論理ファイル名（8文字以内）

論理ファイル数分表示されます。

c

物理ファイルがA系かB系かの表示

A…A系

B…B系

物理ファイル数分表示されます。

dd....dd

物理ファイル状態

複数の状態が共存する場合，複数表示します。

a…現用ファイル

b…障害閉塞ファイル

c…クローズファイル

i…初期設定状態

l…論理エラー

n…ファイル実体がない状態

o…オープンファイル

p…物理エラー

r…障害情報によるファイル状態回復

s…予備ファイル

u…使用済みファイル

物理ファイル数分表示されます。

ee....ee

レコード長（10進数）（単位：バイト）

物理ファイル数分表示されます。

ff....ff

レコード数（10進数）

物理ファイル数分表示されます。

gg....gg

物理ファイル名（510文字以内）

物理ファイル数分表示されます。

出力メッセージ

メッセージID

内容

出力先

KFSB91001-E

コマンドの形式が不正です。

標準エラー出力

KFSB91002-E

フラグ引数が不正です。

標準エラー出力

KFSB91003-E

フラグ引数の組み合わせが不正です。

標準エラー出力

KFSB91004-E

コマンドが失敗しました。

標準エラー出力

KFSB91005-E

領域の確保に失敗しました。

標準エラー出力

KFSB91006-E

内部矛盾が発生しました。

標準エラー出力

KFSB91050-I

ヘルプメッセージ

標準出力

注意事項

次に示すクローズ状態のファイルに，eestsinitコマンド，またはeestsrmコマンドを実行しても，eestslsコマンドで表示するファイル状態は変わりません。

CLOSE

NONE

BLOCKADE

なお，eestsinitコマンド，またはeestsrmコマンドを実行したあとに，eestsopenコマンドでステータスファイルをオープンしてから，eestslsコマンドを実行すると，現在のファイル状態を表示できます。

eestsopen

名称

ステータスファイルのオープン

形式

eestsopen -g サービスグループ名　｛-n 論理ファイル名|-f 物理ファイル名｝

機能

eestsinitコマンドで初期設定したステータスファイル，またはeestscloseコマンドでクローズしたステータスファイルをオープンします。

ただし，eestsopenコマンドでオープンできるステータスファイルは，ステータスファイル関連定義で指定した制御用ステータスファイルだけです。TP1/EEがオンライン中のときにオープンできます。

現用のステータスファイルが片系運転の場合，同じ論理ファイルの閉塞状態の物理ファイルをeestsrmコマンドで削除し，eestsinitコマンドで再作成後，eestsopenコマンドを実行すると，現用のステータスファイルとして回復できます。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

TP1/EEプロセスのサービスグループ名を指定します。

●-n　論理ファイル名　　〜〈1〜8文字の識別子〉

オープンする論理ファイルの名称を指定します。指定した論理ファイルを構成するA系ファイルとB系ファイルを両方同時にオープンします。

次の場合に指定できます。

A系ファイル，B系ファイルのどちらかが，CLOSE，NONE，またはBLOCKADE状態の場合

A系ファイル，B系ファイルの両方が，CLOSE，NONE，またはBLOCKADE状態の場合

論理ファイル名を指定すると，物理ファイルのパス名を意識する必要はありません。

●-f　物理ファイル名　　〜〈パス名〉

オープンする物理ファイルの名称をパス名で指定します。

ステータスファイルに障害が発生し，閉塞状態になったステータスファイルを再作成したあと，およびeestsinitコマンドで初期設定した物理ファイルをオープンするときに指定します。

なお，「eestsopen -f　A系物理ファイル名」，「eestsopen -f　B系物理ファイル名」と2回eestsopenコマンドを実行するのは，「eestsopen -n　論理ファイル名」と実行するのと同じことです。

出力メッセージ

メッセージID

内容

出力先

KFSB91001-E

コマンドの形式が不正です。

標準エラー出力

KFSB91002-E

フラグ引数が不正です。

標準エラー出力

KFSB91003-E

フラグ引数の組み合わせが不正です。

標準エラー出力

KFSB91004-E

コマンドが失敗しました。

標準エラー出力

KFSB91005-E

領域の確保に失敗しました。

標準エラー出力

KFSB91006-E

内部矛盾が発生しました。

標準エラー出力

KFSB91056-I

ヘルプメッセージ

標準出力

eestsrm

名称

ステータスファイルの削除

形式

eestsrm -f 物理ファイル名

機能

障害が発生して閉塞状態になったステータスファイルを，オフライン中に削除します。

TP1/EEがオンラインで使用中（現用，または予備の状態）のステータスファイルは削除できません。

オプション

●-f　物理ファイル名　　〜〈パス名〉

削除する物理ファイルの名称を指定します。

出力メッセージ

メッセージID

内容

出力先

KFSB91001-E

コマンドの形式が不正です。

標準エラー出力

KFSB91002-E

フラグ引数が不正です。

標準エラー出力

KFSB91005-E

領域の確保に失敗しました。

標準エラー出力

KFSB91006-E

内部矛盾が発生しました。

標準エラー出力

KFSB91007-E

ステータス物理ファイルでエラーが発生しました。

標準エラー出力

KFSB91057-I

ヘルプメッセージ

標準出力

注意事項

TP1/EEが稼働中のときだけ，現用ステータスファイルを管理しています。そのため，eestsrmコマンドを実行する場合，次のことに注意してください。

オンライン中に使用した現用のステータスファイルを削除しないでください。

障害が発生して閉塞状態になったステータスファイルだけを削除してください。

同一のTP1EEファイルシステムに対して，eestsinitコマンドおよびeestsrmコマンドを同時に実行しないでください。

TP1/EEがオンライン中に閉塞状態になったステータスファイルに対してeestsrmコマンドを実行した場合，KFSB91007-Eメッセージを出力してエラーとなることがあります。eestslsコマンドを実行して物理ファイルの状態が「o…オープンファイル」となっているときは，eestscloseコマンドを実行してから，再度eestsrmコマンドを実行してください。

eestsswap

名称

ステータスファイルのスワップ

形式

eestsswap -g サービスグループ名 -r ファイルグループ番号 〔-c〕

機能

ステータスファイルの状態を切り替えます。

現用のステータスファイルを予備とし，両系とも予備のステータスファイルを現用とします。TP1/EEがオンライン中のときにスワップできます。

ただし，eestsswapコマンドでスワップできるファイルは，ステータスファイル関連定義で指定した制御用ステータスファイルだけです。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

TP1/EEプロセスのサービスグループ名を指定します。

●-r　ファイルグループ番号　　〜〈1〜16〉

スワップするステータスファイルのファイルグループ番号を指定します。

●-c

現用のステータスファイルが両系運転中でもスワップさせる場合に指定します。

-cオプションが指定されていない場合，ステータスファイルが片系運転中のときだけスワップします。片系運転は，ステータスファイル関連定義のsts_single_operation_switchオペランドでcontinueを指定した場合に発生します。

出力メッセージ

メッセージID

内容

出力先

KFSB91001-E

コマンドの形式が不正です。

標準エラー出力

KFSB91002-E

フラグ引数が不正です。

標準エラー出力

KFSB91004-E

コマンドが失敗しました。

標準エラー出力

KFSB91005-E

領域の確保に失敗しました。

標準エラー出力

KFSB91006-E

内部矛盾が発生しました。

標準エラー出力

KFSB91058-I

ヘルプメッセージ

標準出力

eesvstart

名称

TP1/EEの開始

形式

eesvstart -u ユーザサーバ名〔,ユーザサーバ名…〕〔-a N〕

機能

サーバを開始します。

なお，このコマンドはTP1/Server Baseのdcsvstartコマンドを包含しています。

また，eesvstartコマンドが終了しない場合は，eesvstop -dfコマンドでTP1/EEを強制停止し，コアファイルを取得すると，要因を調査できます。

このコマンドでオンラインが開始され，サービス要求，MCPサーバ型コネクションの確立受け付け，および運用コマンドを受け付け可能となるのは，KFSB80003-Iメッセージが出力された時点です。したがって，このコマンドがリターンしたとしても，KFSB80003-Iメッセージが出力されるまでは，サービス要求，MCPサーバ型コネクションの確立受け付け，およびほかの運用コマンドがエラーになることがあります。また，MCPクライアント型コネクション使用時のコネクション自動確立，およびMCP（UDP）使用時の論理端末の自動閉塞解除については，マニュアル「TP1/EE/Message Control Extension 使用の手引」を参照してください。

オプション

●-u　ユーザサーバ名　　〜〈1〜8文字の識別子〉

開始するTP1/EEユーザサーバのサーバ名を指定します。一つのeesvstartコマンドで指定できるユーザサーバ名の最大数は50です。

複数のユーザサーバ名を指定する場合は，ユーザサーバ名とユーザサーバ名との間をコンマ（,）で区切ります。このとき，コンマの前後に空白を入れないでください。

●-a　N

TP1/EEを強制正常開始モードで開始します。

出力メッセージ

メッセージID

内容

出力先

KFSB91801-E

コマンドの形式が不正です。

標準エラー出力

KFSB91802-E

フラグ引数が不正です。

標準エラー出力

KFSB91803-E

コマンドの引数が不正です。

標準エラー出力

KFSB91808-E

ユーザサーバ名が重複しています。

標準エラー出力

KFSB91850-I

ヘルプメッセージ

標準出力

表に示すメッセージ以外のメッセージが出力された場合は，マニュアル「OpenTP1 メッセージ」を参照してください。

eesvstop

名称

TP1/EEの終了

形式

eesvstop 〔-a｜-b｜-f｜-df〕 ユーザサーバ名〔 ユーザサーバ名…〕

機能

サーバを終了します。

なお，このコマンドはTP1/Server Baseのdcsvstopコマンドを包含しています。

オプション

●-a

指定したユーザサーバを計画停止Aで停止します。

●-b

指定したユーザサーバを計画停止Bで停止します。

●-f

指定したユーザサーバを強制停止します。

●-df

ユーザサーバを強制停止したときに，ユーザサーバのコアファイルを取得します。eesvstartコマンド，またはeesvstopコマンドが終了しないときにトラブルシュート情報としてコアファイルを取得するために指定します。

すべてのオプションの指定を省略すると，該当するサーバを正常終了します。

コマンド引数

●ユーザサーバ名　　〜〈1〜8文字の識別子〉

終了するTP1/EEユーザサーバ名を指定します。一つのeesvstopコマンドで指定できるユーザサーバ名の最大数は50です。

出力メッセージ

メッセージID

内容

出力先

KFSB91801-E

コマンドの形式が不正です。

標準エラー出力

KFSB91802-E

フラグ引数が不正です。

標準エラー出力

KFSB91803-E

コマンドの引数が不正です。

標準エラー出力

KFSB91808-E

ユーザサーバ名が重複しています。

標準エラー出力

KFSB91851-I

ヘルプメッセージ

標準出力

表に示すメッセージ以外のメッセージが出力された場合は，マニュアル「OpenTP1 メッセージ」を参照してください。

注意事項

次の場合はTP1/Server Baseが異常終了することがあります。

TP1/Server Baseのユーザサービス定義でcritical=Yを指定している場合にeesvstop -dfコマンドを実行したとき

TP1/Server Baseのユーザサービス定義でcritical=Yを指定している場合にeesvstop -fコマンドを実行したとき

eesvstopコマンドをOSコマンドで強制停止させた場合

eetrblinedump

名称

回線トレース情報の編集出力（コアファイルまたはメモリダンプファイル入力）

形式

eetrblinedump 〔-r ランID〕 〔-s {rpc｜trn｜rap｜dbq｜ora｜udp｜sdh}〕
              〔-x 中央処理通番の下限値，中央処理通番の上限値〕
              〔-v サービス名〔,サービス名…〕〕
              〔-i IPアドレス〔,IPアドレス…〕〕
              〔-q DBキュー名〔,DBキュー名…〕〕
              〔-l ロット名〔,ロット名…〕〕
              〔-k 出力種別〕
              〔-c CSV出力ファイル名 〔-n ファイル出力行〕〕
               ファイル名

機能

指定されたコアファイルまたはメモリダンプファイルから回線トレース情報を編集し，標準出力，またはCSV形式でファイルに出力します。

オプション

●-r　ランID　　〜〈8文字の16進数〉

指定されたランIDを持つ情報だけを編集，出力します。

●-s　{rpc｜trn｜rap｜dbq｜ora｜udp｜sdh}　　〜《rpc》

rpc

RPC機能のトレース情報だけを編集，出力します。

trn

XAインタフェース，TP1EE情報コード，およびee_trb_utrace_put関数で出力したトレース情報だけを編集，出力します。

rap

rap機能のトレース情報だけを編集，出力します。

dbq

DBキュー機能（TCP/IP通信）のトレース情報だけを編集，出力します。

ora

Oracleのエラー情報だけを編集，出力します。

udp

RPC機能（UDP通信）のトレース情報だけを編集，出力します。

sdh

SDBハンドラ機能のトレース情報だけを編集，出力します。

●-x　中央処理通番の下限値，中央処理通番の上限値　　〜〈1〜8文字の16進数〉((0〜ffffffff))

指定されたカレント中央処理通番の範囲内の情報だけ編集，出力します。-xオプションを指定する場合，上限値および下限値を必ず指定してください。

中央処理通番を指定するときは，最大値（4294967295）を考慮してください。ラップした場合に4294967290から3まで出力したいときは，「-x FFFFFFFA,3」と指定します。

●-v　サービス名　　〜〈1〜31文字の識別子〉

指定されたサービス名を持つ情報だけを編集，出力します。サービス名は，最大10個指定できます。

●-i　IPアドレス　　〜〈7〜15文字の符号なし整数〉

IPアドレスを指定する場合は，xxx.xxx.xxx.xxxの形式で指定します。xxxは，0〜255（10進数）で指定します。IPアドレスは，最大10個指定できます。

●-q　DBキュー名　　〜〈1〜27文字の識別子〉

指定されたDBキュー名を持つ情報だけを編集，出力します。DBキュー名は，最大10個指定できます。-qオプションは，-sオプションにoraを指定した場合だけ指定できます。

●-l　ロット名　　〜〈1〜23文字の識別子〉

指定されたロット名を持つ情報だけを編集，出力します。ロット名は，最大10個指定できます。-lオプションは，-sオプションにoraを指定した場合だけ指定できます。

●-k　出力種別　〜((1))

1

受信IDを出力します。

●-c　CSV出力ファイル名　　〜〈パス名〉

指定されたファイルに編集結果をCSV形式で出力します。

-nオプションを指定した場合は，パス名中のファイル名は，245文字以下としてください。-nオプション指定時にファイル名が246文字以上の場合はオプションエラーで，このコマンドが異常終了します。

●-n　ファイル出力行　〜(10000〜100000)

-cオプションに指定したcsvファイルを分割して出力する場合に1ファイルに出力する行数を指定します。見出し行を含めて-nオプションに指定した行数を出力したときに，出力するファイルを切り替えます。切り替えた先のファイルには見出し行から出力します。

分割したファイルには，10進数の文字列をファイル名の末尾に付与します。付与する文字列は1から9999ファイルまでは「0001」からの連番で左に0を埋めた4けたの文字列とします。10000ファイルを超えた場合は左に0埋めをしません。ファイル名に「.」を含む場合は，最後の「.」の前に付与します。

ファイル名に文字列を付与する例を示します。

（例1）-cにxxxと指定した場合

    xxx0001
    xxx0002
     ：

（例2）-cにxxx.csvと指定した場合

    xxx0001.csv
    xxx0002.csv
     ：

このオプションを省略した場合は，ファイルを分割しないで1ファイルに出力します。

コマンド引数

●ファイル名　　〜〈パス名〉

編集するコアファイル名またはメモリダンプファイル名を指定します。

指定できるオプションの組み合わせを次の図に示します。

図10‒3　eetrblinedumpコマンドのオプションの組み合わせ

（凡例）

○：指定できます。

×：指定できません。

−：該当しません。

出力形式

●-sオプションにtrnを指定した場合

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

出力形式中の，右端の数字の意味を次に示します。

1：改行を含まないで1行で表示します。

2：レコード数分表示します。

3：改行して複数行で表示します。

4：xa関数発行前のとき出力します。

5：xa関数発行後のとき出力します。

6：SQLの場合に出力します。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa-aa-aa

eetrblinedumpコマンドを実行したTP1/EEのバージョン

bb....bb

eetrblinedumpコマンドの引数

cc....cc

入力ファイル名

d1-d1-d1

ファイルを作成したTP1/EEのバージョン

d2-d2-d2

ファイルを作成したXTCのバージョン

XTCを使用する場合にだけ表示します。

d3-d3-d3

ファイルを作成したTP1/FSPのバージョン

TP1/FSPを使用する場合にだけ表示します。

T1

回線トレース情報取得タイプ

ff....ff

サービスグループ名（31文字以内）

gggggggg

TP1/EEのランID（8けたの16進数）

hhhh/hh/hh hh:hh:hh hhh.hhh

回線トレース情報を取得した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

ii....ii

イベント名（15文字以内）

イベントの前後で回線トレース情報を取得するため，イベント名のあとに，イベントの前後を示す「前」または「後」を表示します。また，ee_trb_utrace_put関数で指定したID，およびTP1/EEがトラブルシュートで使用するコードを，16進数で表示します。

jjj

データ長（3けたの10進数）（単位：バイト）

oooo/oo/oo oo:oo:oo ooo.ooo

実行日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。XA関数呼び出し前のときに表示します。

kkkkkkkk

該当するレコードを取得したカレント中央処理通番（8けたの16進数）

ll....ll

サービス名（31文字以内）

表示する内容がない場合，「*」を表示します。

mm....mm.mmm

XA関数の呼び出し時間

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。4294967.295ミリ秒を超えた場合，「4294967.295」を表示します。XA関数呼び出し後のときに表示します。

nnnnnnnn

リターンコード（8けたの16進数）

XA関数呼び出し後のときに表示します。

n1....n1

リソースマネジャ名とリソースマネジャ拡張子

（trnstringの-nオプション指定値と-iオプション指定値をつなげた値）

yy

XAインタフェース

ssss/ss/ss ss:ss:ss sss.sss

トレース情報の出力を再開した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

tt....tt

すべての出力バッファを使用している間にトレース情報出力要求が発生したため，破棄したレコード数

uuuu/uu/uu uu:uu:uu uuu.uuu

破棄を開始した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

vvvvvvvv

破棄を開始したレコードを取得した中央処理通番

該当しない場合は0が表示されます。

wwwwwwww

破棄を開始したレコードを取得した受信ID

該当しない場合は0が表示されます。

●-sオプションにrpc，rap，dbq，またはudpを指定した場合

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

出力形式中の，右端の数字の意味を次に示します。

1：改行を含まないで1行で表示します。

2：レコード数分表示します。

3：改行して複数行で表示します。

4：-kに1を指定した場合出力します。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa-aa-aa

eetrblinedumpコマンドを実行したTP1/EEのバージョン

bb....bb

eetrblinedumpコマンドの引数

cc....cc

入力ファイル名

d1-d1-d1

ファイルを作成したTP1/EEのバージョン

d2-d2-d2

ファイルを作成したXTCのバージョン

XTCを使用する場合にだけ表示します。

d3-d3-d3

ファイルを作成したTP1/FSPのバージョン

TP1/FSPを使用する場合にだけ表示します。

T1

回線トレース情報取得タイプ

ff....ff

サービスグループ名（31文字以内）

gggggggg

TP1/EEのランID（8けたの16進数）

hhhh/hh/hh hh:hh:hh hhh.hhh

回線トレース情報を取得した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

ii....ii

イベント名（15文字以内）

イベントの前後で回線トレース情報を取得するため，イベント名のあとに，イベントの前後を示す「前」または「後」を表示します。また，ee_trb_utrace_put関数で指定したID，およびTP1/EEがトラブルシュートで使用するコードを，16進数で表示します。

jjj

データ長（3けたの10進数）（単位：バイト）

oooo/oo/oo oo:oo:oo ooo.ooo

実行日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

kkkkkkkk

該当するレコードを取得したカレント中央処理通番（8けたの16進数）

llllllll

該当するレコードを取得した受信ID（8けたの16進数）

-kオプションに1を指定した場合にだけ出力します。

ppp

回線トレース情報を取得した機能種別（3文字）

rpc…RPC機能で取得

rap…rap機能で取得

dbq…DBキュー機能（TCP/IP通信）で取得

udp…RPC機能（UDP通信）で取得

qq....qq.qq....qq.qq....qq.qq....qq

受信元または送信先のIPアドレス（15けた以内の10進数）

rr....rr

受信元または送信先のポート番号（5けた以内の10進数）

nnnn

リターンコード（4けたの16進数）

uu....uu

実際に送受信したデータ長

トラブルシュート関連定義のtrb_trace_typeオペランドで1を指定した場合に表示します。

yy

メッセージ情報

ssss/ss/ss ss:ss:ss sss.sss

トレース情報の出力を再開した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

tt....tt

すべての出力バッファを使用している間にトレース情報出力要求が発生したため，破棄したレコード数

uuuu/uu/uu uu:uu:uu uuu.uuu

破棄を開始した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

vvvvvvvv

破棄を開始したレコードを取得した中央処理通番

該当しない場合は0が表示されます。

wwwwwwww

破棄を開始したレコードを取得した受信ID

該当しない場合は0が表示されます。

●-sオプションにoraを指定した場合

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

出力形式中の，右端の数字の意味を次に示します。

1：改行を含まないで1行で表示します。

2：レコード数分表示します。

3：改行して複数行で表示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa-aa-aa

eetrblinedumpコマンドを実行したTP1/EEのバージョン

bb....bb

eetrblinedumpコマンドの引数

cc....cc

入力ファイル名

d1-d1-d1

ファイルを作成したTP1/EEのバージョン

d2-d2-d2

ファイルを作成したXTCのバージョン

XTCを使用する場合にだけ表示します。

d3-d3-d3

ファイルを作成したTP1/FSPのバージョン

TP1/FSPを使用する場合にだけ表示します。

T1

回線トレース情報取得タイプ

ff....ff

サービスグループ名（31文字以内）

gggggggg

TP1/EEのランID（8けたの16進数）

hhhh/hh/hh hh:hh:hh hhh.hhh

回線トレース情報を取得した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

ii....ii

イベント名（15文字以内）

イベントの前後で回線トレース情報を取得するため，イベント名のあとに，イベントの前後を示す「前」または「後」を表示します。また，ee_trb_utrace_put関数で指定したID，およびTP1/EEがトラブルシュートで使用するコードを，16進数で表示します。

jjj

データ長（3けたの10進数）（単位：バイト）

kkkk/kk/kk kk:kk:kk kkk.kkk

実行日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

llllllll

該当するレコードを取得したカレント中央処理通番（8けたの16進数）

mm....mm

SQLCODE（10進数）

nn....nn

DBキュー名（27文字以内）

oo....oo

ロット名（23文字以内）

pp....pp

Oracleのエラー情報（512文字以内）

qqqq/qq/qq qq:qq:qq qqq.qqq

トレース情報の出力を再開した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

rr....rr

すべての出力バッファを使用している間にトレース情報出力要求が発生したため，破棄したレコード数

ssss/ss/ss ss:ss:ss sss.sss

破棄を開始した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

tttttttt

破棄を開始したレコードを取得した中央処理通番

該当しない場合は0が表示されます。

uuuuuuuu

破棄を開始したレコードを取得した受信ID

該当しない場合は0が表示されます。

●-sオプションにsdhを指定した場合

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

出力形式中の，右端の数字の意味を次に示します。

1：改行を含まないで1行で表示します。

2：レコード数分表示します。

3：イベント名に「イベント名＋"前"」以外が出力された場合に表示します。

4：イベント名が「DBMSERR」以外の場合，またはTP1/EEがトラブルシュートで使用する情報の場合に表示します。

5：改行して複数行で表示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa-aa-aa

eetrblinedumpコマンドを実行したTP1/EEのバージョン

bb....bb

eetrblinedumpコマンドの引数

cc....cc

入力ファイル名

d1-d1-d1

ファイルを作成したTP1/EEのバージョン

d2-d2-d2

ファイルを作成したXTCのバージョン

XTCを使用する場合にだけ表示します。

d3-d3-d3

ファイルを作成したTP1/FSPのバージョン

TP1/FSPを使用する場合にだけ表示します。

T1

回線トレース情報取得タイプ

ff....ff

サービスグループ名（31文字以内）

gggggggg

TP1/EEのランID（8けたの16進数）

hhhh/hh/hh hh:hh:hh hhh.hhh

回線トレース情報を取得した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

ii....ii

イベント名（15文字以内）

イベントの前後で回線トレース情報を取得するため，イベント名のあとに，イベントの前後を示す「前」または「後」を表示します。また，ee_trb_utrace_put関数で指定したID，およびTP1/EEがトラブルシュートで使用するコードを，16進数で表示します。

jjj

データ長（3けたの10進数）（単位：バイト）

oooo/oo/oo oo:oo:oo ooo.ooo

実行日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。DML関数呼び出し前のときに表示します。

kkkkkkkk

該当するレコードを取得したカレント中央処理通番（8けたの16進数）

ll....ll

サービス名（31文字以内）

表示する内容がない場合，「*」を表示します。

mm....mm.mmm

DML関数の呼び出し時間

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。4294967.295ミリ秒を超えた場合，「4294967.295」を表示します。DML関数呼び出し後のときに表示します。

nnnnnnnn

リターンコード（8けたの16進数）

イベント名に「イベント名＋"前"」以外が出力された場合に表示します。

yy

SDHインタフェース

ssss/ss/ss ss:ss:ss sss.sss

トレース情報の出力を再開した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

tt....tt

すべての出力バッファを使用している間にトレース情報出力要求が発生したため，破棄したレコード数

uuuu/uu/uu uu:uu:uu uuu.uuu

破棄を開始した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

vvvvvvvv

破棄を開始したレコードを取得した中央処理通番

該当しない場合は0が表示されます。

wwwwwwww

破棄を開始したレコードを取得した受信ID

該当しない場合は0が表示されます。

zz....zz

SDBのエラー情報（280文字以内）

イベント名に「DBMSERR」が出力された場合にだけ表示します。

出力メッセージ

メッセージID

内容

出力先

KFSB95400-E

メモリを確保できません。

標準エラー出力

KFSB95401-E

コマンドの形式が不正です。

標準エラー出力

KFSB95402-E

コマンドのオプションが不正です。

標準エラー出力

KFSB95403-E

コマンドのオプションの組み合わせが不正です。

標準エラー出力

KFSB95410-E

ファイルのオープン処理で障害が発生しました。

標準エラー出力

KFSB95411-E

ファイルからの読み出し処理で障害が発生しました。

標準エラー出力

KFSB95412-E

ファイルへの書き込み処理で障害が発生しました。

標準エラー出力

KFSB95413-E

ファイルのクローズ処理で障害が発生しました。

標準エラー出力

KFSB95414-E

ファイルポインタの移動処理で障害が発生しました。

標準エラー出力

KFSB95415-Q

-cオプションに指定したファイルはすでに存在します。

標準出力

KFSB95416-E

指定したファイルに編集するデータがありません。

標準エラー出力

KFSB95443-I

ヘルプメッセージ

標準出力

KFSB95457-Q

上書き確認（-nオプション指定時）

標準出力

注意事項

編集対象のレコードがない場合，ヘッダ情報だけ表示します。

該当する回線トレース情報が回線トレースファイルに出力される以前の回線トレース出力時刻には，*を表示します。

回線トレース情報に欠落があった場合，欠落したレコード数を表示します。欠落したレコード数が4294967295以上の場合，4294967295と表示します。

回線トレース情報取得時の障害発生などで情報を取得できない場合は，取得できなかった情報の値に0が表示されます。

ファイル名に指定できるコアファイルまたはメモリダンプファイルは，該当するバージョンの該当するOSで作成されたファイルだけです。

-cオプションを指定してCSVファイルに出力する場合，ファイル作成バージョンは，日本語では「ファイル作成バージョン：dd-dd-dd」の形式で，英語では「File creation version: dd-dd-dd」の形式で表示します。

破棄を開始した日時を出力する場合，出力される日時の順序が逆転することがあります。

eetrblineed

名称

回線トレース情報の編集出力

形式

eetrblineed 〔-e 編集種別 〕〔-t 〔開始時刻〕〔,終了時刻〕〕
            〔-r ランID〕 〔-s ｛rpc｜trn｜rap｜dbq｜ora｜udp｜sdh｝〕
            〔-x 中央処理通番の下限値,中央処理通番の上限値〕
            〔-v サービス名〔,サービス名…〕〕
            〔-i IPアドレス〔,IPアドレス…〕〕
            〔-q DBキュー名〔,DBキュー名…〕〕
            〔-l ロット名〔,ロット名…〕〕
            〔-c CSV出力ファイル名 〔-n ファイル出力行〕〕
            〔-k 出力種別〕
            回線トレースファイル名 〔回線トレースファイル名…〕

機能

回線トレース情報を編集し，標準出力，またはCSV形式でファイルに出力します。

オプション

●-e　編集種別　　〜《f》

編集種別を指定します。

r

レコード単位で編集，出力します。

f

ファイル情報一覧を出力します。

-eオプションにfを指定した場合，その他のオプションを指定するとエラーになります。

●-t　開始時刻,終了時刻

指定された時刻内に，出力バッファに出力された回線トレース情報を編集，出力します。

開始時刻，および終了時刻は，1970年1月1日0時0分0秒から当年当月当日の現在時刻までの範囲で指定します。

開始時刻または終了時刻のどちらか一方を必ず指定してください。開始時刻の指定を省略すると，回線トレースファイルの先頭から指定した終了時刻までが出力範囲になります。終了時刻の指定を省略すると，指定した開始時刻から回線トレースファイルの最後までが出力範囲になります。

開始時刻，および終了時刻は，「hhmmss〔MMDD〔YYYY〕〕」の形式で指定します。

hh：時（00≦hh≦23）

指定を省略できません。

mm：分（00≦mm≦59）

指定を省略できません。

ss：秒（00≦ss≦59）

指定を省略できません。

MM：月（01≦MM≦12）

指定を省略できます。※

DD：日（01≦DD≦31）

指定を省略できます。※

YYYY：年（西暦）（1970≦YYYY≦9999）

指定を省略できます。※

注※

開始時刻，または終了時刻の「年」の指定を省略した場合は，当年の指定月日時刻と見なされます。「年，月，日」の指定を省略した場合，当年当月当日の指定時刻と見なされます。「月，日」，「月」，または「日」だけを省略することはできません。省略した場合はオプションエラーになります。「月」または「日」を省略したい場合は，「年」，「月」，「日」のすべてを省略してください。

-tオプションの指定を省略すると，指定したファイル内のすべての情報を編集，出力します。

●-r　ランID　　〜〈8文字の16進数〉

指定されたランIDを持つ回線トレース情報だけ編集，出力します。

●-s　｛rpc｜trn｜rap｜dbq｜ora｜udp｜sdh｝　　〜《rpc》

rpc

RPC機能のトレース情報だけを編集，出力します。

trn

XAインタフェース，TP1/EE情報コード，およびee_trb_utrace_put関数で出力したトレース情報だけを編集，出力します。

rap

rap機能のトレース情報だけを編集，出力します。

dbq

DBキュー機能（TCP/IP通信）のトレース情報だけを編集，出力します。

ora

Oracleのエラー情報だけを編集，出力します。

udp

RPC機能（UDP通信）のトレース情報だけを編集，出力します。

sdh

SDBハンドラ機能のトレース情報だけを編集，出力します。

●-x　中央処理通番の下限値,中央処理通番の上限値　　〜〈1〜8文字の16進数〉((0〜ffffffff))

指定されたカレント中央処理通番の範囲内の情報だけ編集，出力します。-xオプションを指定する場合，上限値および下限値を必ず指定してください。

中央処理通番を指定する場合，最大値（4294967295）を考慮して指定してください。ラップした場合に4294967290から3まで出力したいときは，「-x FFFFFFFA,3」と指定します。

●-v　サービス名　　〜〈1〜31文字の識別子〉

指定されたサービス名を持つ情報だけ編集，出力します。サービス名は，最大10個指定できます。

●-i　IPアドレス　　〜〈7〜15文字の符号なし整数〉

IPアドレスを指定する場合は，xxx.xxx.xxx.xxxの形式で指定します。xxxは，0〜255（10進数）で指定します。IPアドレスは，最大10個指定できます。

●-q　DBキュー名　　〜〈1〜27文字の識別子〉

指定されたDBキュー名を持つ情報だけを編集，出力します。DBキュー名は，最大10個指定できます。-qオプションは，-sオプションにoraを指定した場合だけ指定できます。

●-l　ロット名　　〜〈1〜23文字の識別子〉

指定されたロット名を持つ情報だけを編集，出力します。ロット名は，最大10個指定できます。-lオプションは，-sオプションにoraを指定した場合だけ指定できます。

●-c　CSV出力ファイル名　　〜〈パス名〉

指定されたファイルに編集結果をCSV形式で出力します。

-nオプションを指定した場合は，パス名中のファイル名は，245文字以下としてください。-nオプション指定時にファイル名が246文字以上の場合はオプションエラーで，このコマンドが異常終了します。

●-ｎ　ファイル出力行　　〜(10000〜100000)

-cオプションに指定したcsvファイルを分割して出力する場合に1ファイルに出力する行数を指定します。見出し行を含めて-nオプションに指定した行数を出力したときに，出力するファイルを切り替えます。切り替えた先のファイルには見出し行から出力します。

分割したファイルには，10進数の文字列をファイル名の末尾に付与します。付与する文字列は1から9999ファイルまでは「0001」からの連番で左に0を埋めた4けたの文字列とします。10000ファイルを超えた場合は左に0埋めをしません。ファイル名に「.」を含む場合は，最後の「.」の前に付与します。

ファイル名に文字列を付与する例を示します。

（例1）-cにxxxと指定した場合

    xxx0001
    xxx0002
     ：

（例2）-cにxxx.csvと指定した場合

    xxx0001.csv
    xxx0002.csv
     ：

このオプションを省略した場合は，ファイルを分割しないで1ファイルに出力します。

●-k　出力種別　〜((1))

1

受信IDを出力します。

コマンド引数

●回線トレースファイル名　　〜〈パス名〉

編集するファイル名を指定します。-eオプションにfを指定した場合は，最大1024個回線トレースファイル名を指定できます。

指定できるオプションの組み合わせを次の図に示します。

図10‒4　eetrblineedコマンドのオプションの組み合わせ

（凡例）

○：指定できます。

×：指定できません。

−：該当しません。

出力形式

●-eオプションにr，かつ-sオプションにtrnを指定した場合

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

出力形式中の，右端の数字の意味を次に示します。

1：改行を含まないで1行で表示します。

2：レコード数分表示します。

3：改行して複数行で表示します。

4：xa関数発行前のとき出力します。

5：xa関数発行後のとき出力します。

6：SQLの場合に出力します。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa-aa-aa

eetrblineedコマンドを実行したTP1/EEのバージョン

bb....bb

eetrblineedコマンドの引数

cc....cc

入力ファイル名

dddd/dd/dd dd:dd:dd ddd.ddd

回線トレース情報のファイル出力を開始した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

e1-e1-e1

ファイルを作成したTP1/EEのバージョン

e2-e2-e2

ファイルを作成したXTCのバージョン

XTCを使用する場合にだけ表示します。

e3-e3-e3

ファイルを作成したTP1/FSPのバージョン

TP1/FSPを使用する場合にだけ表示します。

T1

回線トレース情報取得タイプ

ff....ff

サービスグループ名（31文字以内）

gggggggg

TP1/EEのランID（8けたの16進数）

hhhh/hh/hh hh:hh:hh hhh.hhh

回線トレース情報を取得した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

ii....ii

イベント名（15文字以内）

イベントの前後で回線トレース情報を取得するため，イベント名のあとに，イベントの前後を示す「前」または「後」を表示します。また，ee_trb_utrace_put関数で指定したID，およびTP1/EEがトラブルシュートで使用するコードを，16進数で表示します。

jjj

データ長（3けたの10進数）（単位：バイト）

oooo/oo/oo oo:oo:oo ooo.ooo

実行日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。XA関数呼び出し前のときに表示します。

kkkkkkkk

該当するレコードを取得したカレント中央処理通番（8けたの16進数）

ll....ll

サービス名（31文字以内）

表示する内容がない場合，「*」を表示します。

mm....mm.mmm

XA関数の呼び出し時間

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。4294967.295ミリ秒を超えた場合，「4294967.295」を表示します。XA関数呼び出し後のときに表示します。

nnnnnnnn

リターンコード（8けたの16進数）

XA関数呼び出し後のときに表示します。

n1....n1

リソースマネジャ名とリソースマネジャ拡張子

（trnstringの-nオプション指定値と-iオプション指定値をつなげた値）

yy

XAインタフェース

ssss/ss/ss ss:ss:ss sss.sss

トレース情報の出力を再開した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

tt....tt

すべての出力バッファを使用している間にトレース情報出力要求が発生したため，破棄したレコード数

vvvv/vv/vv vv:vv:vv vvv.vvv

破棄を開始した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

wwwwwwww

破棄を開始したレコードを取得した中央処理通番

該当しない場合は0が表示されます。

xxxxxxxx

破棄を開始したレコードを取得した受信ID

該当しない場合は0が表示されます。

●-eオプションにr，かつ-sオプションにrpc，rap，dbq，またはudpを指定した場合

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

注※

この範囲の出力形式の説明は，「●-eオプションにr，かつ-sオプションにtrnを指定した場合」を参照してください。

出力形式中の，右端の数字の意味を次に示します。

1：改行を含まないで1行で表示します。

2：レコード数分表示します。

3：改行して複数行で表示します。

4：-kに1を指定した場合出力します。

出力形式中の，各変数の意味を次に示します。

変数

意味

hhhh/hh/hh hh:hh:hh hhh.hhh

回線トレース情報を取得した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

ii....ii

イベント名（15文字以内）

イベントの前後で回線トレース情報を取得するため，イベント名のあとに，イベントの前後を示す「前」または「後」を表示します。また，ee_trb_utrace_put関数で指定したID，およびTP1/EEがトラブルシュートで使用するコードを，16進数で表示します。

jjj

データ長（3けたの10進数）（単位：バイト）

oooo/oo/oo oo:oo:oo ooo.ooo

実行日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

kkkkkkkk

該当するレコードを取得したカレント中央処理通番（8けたの16進数）

llllllll

該当するレコードを取得した受信ID（8けたの16進数）

-kオプションに1を指定した場合だけ出力します。

ppp

回線トレース情報を取得した機能種別（3文字）

rpc…RPC機能で取得

rap…rap機能で取得

dbq…DBキュー機能（TCP/IP通信）で取得

udp…RPC機能（UDP通信）で取得

qq....qq.qq....qq.qq....qq.qq....qq

受信元または送信先のIPアドレス（15けた以内の10進数）

rr....rr

受信元または送信先のポート番号（5けた以内の10進数）

nnnn

リターンコード（4けたの16進数）

uu....uu

実際に送受信したデータ長

トラブルシュート関連定義のtrb_trace_typeオペランドで1を指定した場合に表示します。

yy

メッセージ情報

ssss/ss/ss ss:ss:ss sss.sss

トレース情報の出力を再開した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

tt....tt

すべての出力バッファを使用している間にトレース情報出力要求が発生したため，破棄したレコード数

vvvv/vv/vv vv:vv:vv vvv.vvv

破棄を開始した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

wwwwwwww

破棄を開始したレコードを取得した中央処理通番

該当しない場合は0が表示されます。

xxxxxxxx

破棄を開始したレコードを取得した受信ID

該当しない場合は0が表示されます。

●-eオプションにr，かつ-sオプションにsdhを指定した場合

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

注※

この範囲の出力形式の説明は，「●-eオプションにr，かつ-sオプションにtrnを指定した場合」を参照してください。

出力形式中の，右端の数字の意味を次に示します。

1：改行を含まないで1行で表示します。

2：レコード数分表示します。

3：イベント名に「イベント名＋"前"」以外が出力された場合に表示します。

4：イベント名が「DBMSERR」以外の場合，またはTP1/EEがトラブルシュートで使用する情報の場合に表示します。

5：改行して複数行で表示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

hhhh/hh/hh hh:hh:hh hhh.hhh

回線トレース情報を取得した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

ii....ii

イベント名（15文字以内）

イベントの前後で回線トレース情報を取得するため，イベント名のあとに，イベントの前後を示す「前」または「後」を表示します。また，ee_trb_utrace_put関数で指定したID，およびTP1/EEがトラブルシュートで使用するコードを，16進数で表示します。

jjj

データ長（3けたの10進数）（単位：バイト）

oooo/oo/oo oo:oo:oo ooo.ooo

実行日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。DML関数呼び出し前のときに表示します。

kkkkkkkk

該当するレコードを取得したカレント中央処理通番（8けたの16進数）

ll....ll

サービス名（31文字以内）

表示する内容がない場合，「*」を表示します。

mm....mm.mmm

DML関数の呼び出し時間

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。4294967.295ミリ秒を超えた場合，「4294967.295」を表示します。DML関数呼び出し後のときに表示します。

nnnnnnnn

リターンコード（8けたの16進数）

DML関数呼び出し後のときに表示します。

yy

SDHインタフェース

ssss/ss/ss ss:ss:ss sss.sss

トレース情報の出力を再開した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

tt....tt

すべての出力バッファを使用している間にトレース情報出力要求が発生したため，破棄したレコード数

vvvv/vv/vv vv:vv:vv vvv.vvv

破棄を開始した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

wwwwwwww

破棄を開始したレコードを取得した中央処理通番

該当しない場合は0が表示されます。

xxxxxxxx

破棄を開始したレコードを取得した受信ID

該当しない場合は0が表示されます。

zz....zz

SDBのエラー情報（280文字以内）

イベント名に「DBMSERR」が出力された場合にだけ表示します。

●-sオプションにoraを指定した場合

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

注※

この範囲の出力形式の説明は，「●-eオプションにr，かつ-sオプションにtrnを指定した場合」を参照してください。

出力形式中の，右端の数字の意味を次に示します。

1：改行を含まないで1行で表示します。

2：レコード数分表示します。

3：改行して複数行で表示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

kkkkkkkk

該当するレコードを取得したカレント中央処理通番（8けたの16進数）

zz....zz

SQLCODE（10進数）

mm....mm

DBキュー名（27文字以内）

nn....nn

ロット名（23文字以内）

pp....pp

Oracleのエラー情報（512文字以内）

ssss/ss/ss ss:ss:ss sss.sss

トレース情報の出力を再開した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

tt....tt

すべての出力バッファを使用している間にトレース情報出力要求が発生したため，破棄したレコード数

vvvv/vv/vv vv:vv:vv vvv.vvv

破棄を開始した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

wwwwwwww

破棄を開始したレコードを取得した中央処理通番

該当しない場合は0が表示されます。

xxxxxxxx

破棄を開始したレコードを取得した受信ID

該当しない場合は0が表示されます。

●-eオプションにfを指定した場合

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

出力形式中の，右端の数字の意味を次に示します。

1：指定したファイル数分表示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa-aa-aa

eetrblineedコマンドを実行したTP1/EEのバージョン

bb....bb

eetrblineedコマンドの引数

cc....cc

入力ファイル名

dddd/dd/dd dd:dd:dd ddd.ddd

回線トレース情報のファイル出力を開始した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

e1-e1-e1

ファイルを作成したTP1/EEのバージョン

e2-e2-e2

ファイルを作成したXTCのバージョン

XTCを使用する場合にだけ表示します。

T1

回線トレース情報取得タイプ

ff....ff

サービスグループ名（31文字以内）

gggggggg

TP1/EEのランID（8けたの16進数）

指定したファイルが回線トレースファイルではない場合，日本語では「回線トレースファイルではありません。」を，英語では「This is not a line trace file.」を表示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

xxxx/xx/xx xx:xx:xx xxx.xxx

出力した回線トレース情報の中でいちばん古い起動時刻

出力対象の回線トレース情報がない場合は

「****/**/** **:**:** ***.***」

を出力します。

出力対象の回線トレース情報に時刻がない場合（xa関数実行後のトレースだけの場合など）は

「****/**/** **:**:** ***.***」

を出力します。

yyyy/yy/yy yy:yy:yy yyy.yyy

出力した回線トレース情報の中でいちばん新しい起動時刻

出力対象の回線トレース情報がない場合は

「****/**/** **:**:** ***.***」

を出力します。

出力対象の回線トレース情報に時刻がない場合（xa関数実行後のトレースだけの場合など）は

「****/**/** **:**:** ***.***」

を出力します。

nnnnnnnn

出力した回線トレース情報の中でいちばん値の小さい中央処理通番。16進数8けた※

出力対象の回線トレース情報がない場合は

「********」

を出力します。

出力対象の回線トレース情報の中央処理通番がすべて0x00000000の場合は

「********」

を出力します。

mmmmm

出力した回線トレース情報の中でいちばん値の大きい中央処理通番。16進数8けた※

中央処理通番が0x00000000の場合は比較対象外です。

出力対象の回線トレース情報がない場合は

「********」

を出力します。

出力対象の回線トレース情報の中央処理通番がすべて0x00000000の場合は

「********」

を出力します。

zzz

-cオプションに指定した出力ファイル名

注※

出力対象の回線トレース情報の中央処理通番が0x00000000，0x00000001，0x00000002の三つの場合，nnnnnnnnに表示される値は0x00000001で，mmmmmmmmに表示される値は0x00000002となり，0x00000000がnnnnnnnn，mmmmmmmmに表示されることはありません。

出力メッセージ

メッセージID

内容

出力先

KFSB95400-E

メモリを確保できません。

標準エラー出力

KFSB95401-E

コマンドの形式が不正です。

標準エラー出力

KFSB95402-E

コマンドのオプションが不正です。

標準エラー出力

KFSB95403-E

コマンドのオプションの組み合わせが不正です。

標準エラー出力

KFSB95405-E

ファイルのヘッダ情報が不正です。

標準エラー出力

KFSB95406-E

データブロックが不正です。

標準エラー出力

KFSB95409-E

バージョンが不一致です。

標準エラー出力

KFSB95410-E

ファイルのオープン処理で障害が発生しました。

標準エラー出力

KFSB95411-E

ファイルからの読み出し処理で障害が発生しました。

標準エラー出力

KFSB95412-E

ファイルへの書き込み処理で障害が発生しました。

標準エラー出力

KFSB95413-E

ファイルのクローズ処理で障害が発生しました。

標準エラー出力

KFSB95415-Q

-cオプションに指定したファイルはすでに存在します。

標準出力

KFSB95431-I

ヘルプメッセージ

標準出力

KFSB95457-Q

上書き確認（-nオプション指定時）

標準出力

注意事項

-eオプションにrを指定した場合，編集対象のレコードがないときは，-eオプションにfを指定した場合と同様に，回線トレース情報を表示します。

回線トレース情報に欠落があった場合，欠落したレコード数を表示します。欠落したレコード数が4294967295以上の場合，4294967295と表示します。

回線トレース情報取得時の障害発生などで情報を取得できない場合は，取得できなかった情報の値に0が表示されます。

-cオプションを指定してCSVファイルに出力する場合，ファイル作成バージョンは，日本語では「ファイル作成バージョン：ee-ee-ee」の形式で，英語では「File creation version: ee-ee-ee」の形式で表示します。

破棄を開始した日時を出力する場合，出力する日時の順序が逆転することがあります。

eetrbrcvr

名称

ファイルの縮退回復

形式

eetrbrcvr -g サービスグループ名〔-s ｛tsk｜lin｜uat｜dmp｜stc｜xdb｜mcp｜all｝〕

機能

縮退中のファイルを回復することで使用可能にし，トラブルシュート情報のファイルの取得を再開します。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

TP1/EEプロセスのサービスグループ名を指定します。

●-s　｛tsk｜lin｜uat｜dmp｜stc｜xdb｜mcp｜all｝　　〜《all》

tsk

TASKTMファイルを縮退から回復する場合，指定します。

lin

回線トレースファイルを縮退から回復する場合，指定します。

uat

UAPトレースファイルを縮退から回復する場合，指定します。

dmp

メモリダンプファイルを縮退から回復する場合，指定します。

stc

統計情報ファイルを縮退から回復する場合，指定します。

xdb

XDBトレース情報ファイルを縮退から回復する場合，指定します。

mcp

MCPトレースファイルを縮退から回復する場合，指定します。

all

TASKTMファイル，回線トレースファイル，UAPトレースファイル，メモリダンプファイル，統計情報ファイル，XDBトレース情報ファイル，およびMCPトレースファイルを縮退から回復する場合に指定します。

出力メッセージ

メッセージID

内容

出力先

KFSB95400-E

メモリを確保できません。

標準エラー出力

KFSB95401-E

コマンドの形式が不正です。

標準エラー出力

KFSB95402-E

コマンドのオプションが不正です。

標準エラー出力

KFSB95426-E

強制出力コマンドが失敗しました。

標準エラー出力

KFSB95427-E

強制出力コマンドが失敗しました。

標準エラー出力

KFSB95442-I

ヘルプメッセージ

標準出力

KFSB95453-I

コマンドの受け付けが成功しました。

標準出力

注意事項

縮退していないファイルに対してeetrbrcvrコマンドを実行した場合，回復処理は行わないで，メッセージも出力しません。

eetrbreport

名称

システム統計情報のリアルタイム編集

形式

eetrbreport -g サービスグループ名 〔-c〕〔-r〕
          〔-s 〔開始編集ID〕〔,終了編集ID〕〕

機能

メモリ上に取得したシステム統計情報を，標準出力にリアルタイムに編集，出力します。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

TP1/EEプロセスのサービスグループ名を指定します。

●-c

システム統計情報をcsv形式で標準出力に出力します。

●-r

システム統計情報を標準出力に出力するとともに，メモリ上の統計情報をリセットします。

メモリ上の統計情報の取得値が，長時間の運用によって上限（4294967295）を超えそうな場合に，-rオプションでメモリ上の統計情報の取得値をリセットできます。

●-s　開始編集ID,終了編集ID

編集，出力するシステム統計情報の編集IDを指定します。編集IDについては，「付録B.1　システム統計情報」の「表B-1　システム統計情報の詳細」および「表B-2　システム統計情報の編集内容」を参照してください。

開始編集IDまたは終了編集IDのどちらか一方を必ず指定してください。

開始編集IDだけを指定すると，指定した編集ID以上のシステム統計情報を出力します。

終了編集IDだけを指定すると，指定した編集ID以下のシステム統計情報を出力します。

開始編集ID，終了編集IDをともに指定する場合は，開始編集ID以上，終了編集ID以下のシステム統計情報を出力します。「開始編集ID≦終了編集ID」となるように指定してください。

-sオプションの指定を省略すると，すべてのシステム統計情報を編集，出力します。

出力形式

●標準出力への出力形式

日本語の出力形式を次に示します。

_________________________________________________
ID     件数        平均        最大       最小
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
aaa  bb....bb    cc....cc    dd....dd   ee....ee
 ：　　　：　　　　　：　　　　　：　　　　　：

英語の出力形式を次に示します。

_________________________________________________
ID   Number      Average     Maximum     Minimum
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
aaa  bb....bb    cc....cc    dd....dd   ee....ee
 ：　　　：　　　　　：　　　　　：　　　　　：

出力形式中の，各変数の意味を次に示します。

変数

意味

aaa

編集ID（3けたの10進数）

bb....bb

件数（16けたの10進数）

出力対象でない場合は「-」を出力します。

cc....cc

平均（16けたの10進数）

出力対象でない場合は，「-」を表示します。

dd....dd

最大値（16けたの10進数）

出力対象でない場合は，「-」を表示します。

ee....ee

最小値（16けたの10進数）

出力対象でない場合は，「-」を表示します。

件数や取得値の累積でオーバフローが発生した場合，件数および平均に「*」を表示します。この場合でも，最大値および最小値は表示します。

●標準出力への出力形式（csv形式）（-cオプションを指定した場合）

日本語と英語で共通の出力形式を次に示します。

aaa,bb....bb,cc....cc,dd....dd,ee....ee
 ：    ：       ：       ：       ：

出力形式中の，各変数の意味を次に示します。

変数

意味

aaa

編集ID（3けた以内の10進数）

bb....bb

件数（16けた以内の10進数）

出力対象でない場合は「-」を出力します。

cc....cc

平均（16けた以内の10進数）

出力対象でない場合は「-」を出力します。

dd....dd

最大値（16けた以内の10進数）

出力対象でない場合は「-」を出力します。

ee....ee

最小値（16けた以内の10進数）

出力対象でない場合は「-」を出力します。

件数や取得値の累積でオーバフローが発生した場合，件数および平均に「*」を表示します。この場合でも，最大値および最小値は表示します。

出力メッセージ

メッセージID

内容

出力先

KFSB95400-E

メモリを確保できません。

標準エラー出力

KFSB95401-E

コマンドの形式が不正です。

標準エラー出力

KFSB95402-E

コマンドのオプションが不正です。

標準エラー出力

KFSB95440-I

ヘルプメッセージ

標準出力

KFSB95451-E

コマンドが失敗しました。

標準エラー出力

KFSB95452-E

コマンドが失敗しました。

標準エラー出力

注意事項

トラブルシュート情報関連定義のtrb_stc_basic_kindオペランドにsysを指定している場合，またはeetrbstcseコマンドを実行してシステム統計情報を取得している場合，システム統計情報の取得時に，メモリ上の統計情報の取得値が自動的にリセットされます。

eetrbstced

名称

統計情報の編集

形式

eetrbstced 〔-e 編集種別〕
           〔-t 〔開始時刻〕〔,終了時刻〕〕
           〔-r ランID〕
           〔-i 時間間隔〕
           〔-s 〔開始編集ID〕〔,終了編集ID〕〕
           〔-v サービス名〔,サービス名…〕〕
           〔-q DBキュー名〔,DBキュー名…〕〕
           〔-l ロット名〔,ロット名…〕〕
           〔-o OBM名〔，ロット名〔，ロット名〕〕〕
           〔-c csv出力ファイル名〕
            統計情報ファイル名〔統計情報ファイル名…〕

機能

指定された統計情報ファイルを編集し，標準出力に出力します。

オプション

●-e　編集種別　　〜《f》

編集種別を指定します。

sys

システム統計情報を編集出力します。

pci

処理キュー統計情報を出力します。

apm

UAP履歴情報メモリ通番統計情報を出力します。

ersp

レスポンス統計情報を出力します。

edly

通信遅延時間統計情報を出力します。

edbq

DBキュー統計情報を出力します。

eobs

オンラインバッチ統計情報を出力します。

eobm

OBM統計情報を出力します。

all

すべての統計情報を出力します。

f

ファイル情報一覧を出力します。

●-t　開始時刻,終了時刻

編集する出力範囲を指定します。開始時刻，および終了時刻は，1970年1月1日0時0分0秒から当年当月当日の現在時刻までの範囲で指定します。

開始時刻または終了時刻のどちらか一方を必ず指定してください。開始時刻の指定を省略すると，統計情報ファイルの先頭から指定した終了時刻までが出力範囲になります。終了時刻の指定を省略すると，指定した開始時刻から統計情報ファイルの最後までが，出力範囲になります。

開始時刻，および終了時刻は，「hhmmss〔MMDD〔YYYY〕〕」の形式で指定します。

hh：時（00≦hh≦23）

指定を省略できません。

mm：分（00≦mm≦59）

指定を省略できません。

ss：秒（00≦ss≦59）

指定を省略できません。

MM：月（01≦MM≦12）

指定を省略できます。※

DD：日（01≦DD≦31）

指定を省略できます。※

YYYY：年（西暦）（1970≦YYYY≦9999）

指定を省略できます。※

注※

開始時刻，または終了時刻の「年」の指定を省略した場合は，当年の指定月日時刻と見なされます。「年，月，日」の指定を省略した場合，当年当月当日の指定時刻と見なされます。「月，日」，「月」，または「日」だけを省略することはできません。省略した場合はオプションエラーになります。「月」または「日」を省略したい場合は，「年」，「月」，「日」のすべてを省略してください。

-tオプションの指定を省略すると，指定したファイル内のすべての情報を編集，出力します。

●-r　ランID　　〜〈8文字の16進数〉

指定されたランIDを持つ統計情報だけ編集，出力します。

●-i　時間間隔　　〜《h01》

統計情報を編集，出力する間隔を，時間または分で指定します。

h〔HH〕

時間間隔（01≦HH≦24）で出力します。

HHの指定を省略すると，1時間間隔で出力されます。

m〔MM〕

分間隔（01≦MM≦30）で出力します。

MMの指定を省略すると，10分間隔で出力されます。

時間間隔と分間隔の両方を指定すると，エラーになります。

-iオプションの指定を省略すると，1時間間隔で出力されます。

システム統計情報，処理キュー統計情報を編集，出力する場合は，取得時の時間間隔以上の値を指定することをお勧めします。取得時の時間間隔未満の値を設定すると，該当データなしの時間帯が多くなります。

●-s　開始編集ID,終了編集ID

システム統計情報を編集，出力する場合に指定します。

編集，出力するシステム統計情報の編集IDを指定します。編集IDについては，「付録B.1　システム統計情報」の「表B-1　システム統計情報の詳細」および「表B-2　システム統計情報の編集内容」を参照してください。

開始編集IDまたは終了編集IDのどちらか一方を必ず指定してください。

開始編集IDだけ指定すると，開始編集ID以上のシステム統計情報を出力します。

終了編集IDだけ指定すると，終了編集ID以下のシステム統計情報を出力します。

開始編集ID，終了編集IDともに指定する場合は，開始編集ID以上，終了編集ID以下のシステム統計情報を出力します。「開始編集ID≦終了編集ID」となるように指定してください。

-sオプションの指定を省略すると，すべてのシステム統計情報を編集，出力します。

●-v　サービス名　　〜〈1〜31文字の識別子〉

レスポンス統計情報，または処理キュー統計情報を編集，出力する場合に指定します。

指定されたサービス名を持つ情報だけ編集，出力します。サービス名は，最大10個指定できます。

●-q　DBキュー名　　〜〈1〜27文字の識別子〉

DBキュー統計情報またはオンラインバッチ統計情報を編集，出力する場合に指定します。

指定されたDBキュー名を持つ情報だけ編集，出力します。DBキュー名は，最大10個指定できます。

●-l　ロット名　　〜〈1〜23文字の識別子〉

オンラインバッチ統計情報を編集，出力する場合に指定します。

指定されたロット名を持つ情報だけ編集，出力します。ロット名は，最大10個指定できます。

●-o　OBM名〔，ロット名〔，ロット名〕〕　　〜〈1〜8文字の識別子，1〜8文字の英数字，1〜8文字の英数字〉

指定されたOBM名を持つ情報だけ編集出力します。

2階層目のロットから最下位ロットまで順に「，」で区切り指定できます。

-oオプションはOBM統計情報を編集出力する場合に指定できます。

●-c　csv出力ファイル名

csv形式で標準出力に出力します。

コマンド引数

●統計情報ファイル名　　〜〈パス名〉

編集する統計情報ファイル名を指定します。-eオプションにfを指定した場合は，最大1024個の統計情報ファイル名を指定できます。

指定できるオプションの組み合わせを次の図に示します。

図10‒5　eetrbstcedコマンドのオプションの組み合わせ

（凡例）

○：指定できます。

×：指定できません。

−：該当しません。

出力形式

●-eオプションにsysを指定した場合

-cオプションを指定しないときの日本語の出力形式を次に示します。

-cオプションを指定しないときの英語の出力形式を次に示します。

-cオプションを指定したときの日本語の出力形式を次に示します。

-cオプションを指定したときの英語の出力形式を次に示します。

（凡例）

下線：該当する編集対象時間の先頭行にだけ出力します。

出力形式中の，右端の数字の意味を次に示します。

1：出力範囲の編集対象時間の全システム統計情報を出力するまで繰り返します。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa-aa-aa

eetrbstcedコマンドを実行したTP1/EEのバージョン

bb....bb

eetrbstcedコマンドの引数

cc....cc

入力ファイル名

dddd/dd/dd dd:dd:dd ddd.ddd

該当するファイルに出力を開始した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

e1-e1-e1

ファイルを作成したTP1/EEのバージョン

e2-e2-e2

ファイルを作成したXTCのバージョン※

e3-e3-e3

ファイルを作成したMCPのバージョン※

e4-e4-e4

ファイルを作成したXDBのバージョン※

e5-e5-e5

ファイルを作成したTP1/FSPのバージョン※

T1

統計情報取得タイプ

ff....ff

サービスグループ名（31文字以内）

gggggggg

TP1/EEのランID（8けたの16進数）

hhhh/hh/hh hh:hh:hh

編集対象時間帯の開始日時

「年/月/日△時:分:秒」の形式で出力します。

iiii/ii/ii ii:ii:ii

編集対象時間帯の終了日時

「年/月/日△時:分:秒」の形式で出力します。

jj....jj

統計情報種別

kkk

編集ID（3けた以内の10進数）

ll....ll

イベント

mm....mm

イベント数（16けた以内の10進数）

出力対象でない場合は，「-」を表示します。

オーバフローした場合は，「*」を表示します。

nn....nn

平均値（16けた以内の10進数）

出力対象でない場合は，「-」を表示します。

オーバフローした場合は，「*」を表示します。

oo....oo

最大値（16けた以内の10進数）

出力対象でない場合は，「-」を表示します。

pp....pp

最小値（16けた以内の10進数）

出力対象でない場合は，「-」を表示します。

qq....qq

平均値，最大値，最小値の単位

rr....rr

すべての出力バッファを使用している間にシステム統計情報の出力要求が発生したため，破棄したシステム統計情報数

破棄したシステム統計情報がない場合は出力しません。

注※

それぞれのプログラムプロダクトを使用する場合にだけ表示します。

●-eオプションにpciを指定した場合

-cオプションを指定しないときの日本語の出力形式を次に示します。

-cオプションを指定しないときの英語の出力形式を次に示します。

出力形式中の，右端の数字の意味を次に示します。

1：出力範囲の編集対象時間の全処理キュー統計情報を出力するまで繰り返します。

2：サービス名単位に繰り返します。

-cオプションを指定したときの日本語の出力形式を次に示します。

-cオプションを指定したときの英語の出力形式を次に示します。

（凡例）

下線：該当する編集対象時間の先頭行にだけ出力します。

出力形式中の，右端の数字の意味を次に示します。

1：出力範囲の編集対象時間の全処理キュー統計情報を出力するまでサービス名単位に繰り返します。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa-aa-aa

eetrbstcedコマンドを実行したTP1/EEのバージョン

bb....bb

eetrbstcedコマンドの引数

cc....cc

入力ファイル名

dddd/dd/dd dd:dd:dd ddd.ddd

該当するファイルに出力を開始した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

e1-e1-e1

ファイルを作成したTP1/EEのバージョン

e2-e2-e2

ファイルを作成したXTCのバージョン※

e3-e3-e3

ファイルを作成したMCPのバージョン※

e4-e4-e4

ファイルを作成したXDBのバージョン※

e5-e5-e5

ファイルを作成したTP1/FSPのバージョン※

T1

統計情報取得タイプ

ff....ff

サービスグループ名（31文字以内）

gggggggg

TP1/EEのランID（8けたの16進数）

jjjj/jj/jj jj:jj:jj

編集対象時間帯の開始日時

「年/月/日△時:分:秒」の形式で出力します。

kkkk/kk/kk kk:kk:kk

編集対象時間帯の終了日時

「年/月/日△時:分:秒」の形式で出力します。

ll....ll

サービス名（31文字以内）

サービス名がない処理キューは，「pce（qq）」を出力します。qqは，処理キューリクエストコード（2文字）です。

mm....mm

処理キューに登録した件数（10けた以内の10進数）

オーバフローした場合は，「*」を表示します。

nn....nn

処理キューを引き出した件数（10けた以内の10進数）

オーバフローした場合は，「*」を表示します。

oo....oo

処理キューから引き出されないで滞留している件数（10けた以内の10進数）

pp....pp

すべての出力バッファを使用している間に処理キュー統計情報の出力要求が発生したため，破棄した処理キュー統計情報数

破棄した処理キュー統計情報がない場合は出力しません。

注※

それぞれのプログラムプロダクトを使用する場合にだけ表示します。

●-eオプションにapmを指定した場合

-cオプションを指定しないときの日本語の出力形式を次に示します。

1：出力範囲の編集対象時間の全メモリ通番統計情報を出力するまで繰り返します。

2：UAP履歴情報グループ名単位に繰り返します。

-cオプションを指定しないときの英語の出力形式を次に示します。

1：出力範囲の編集対象時間の全メモリ通番統計情報を出力するまで繰り返します。

2：UAP履歴情報グループ名単位に繰り返します。

-cオプションを指定したときの日本語の出力形式を次に示します。

-cオプションを指定しないときの英語の出力形式を次に示します。

（凡例）

下線：該当する編集対象時間の先頭行にだけ出力します。

1：改行しないで1行で出力します。

2：出力範囲の編集対象時間のすべてのUAP履歴情報グループ名の，メモリ通番統計情報を出力するまで繰り返します。

3：該当する編集対象時間の先頭行にだけ出力します。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa-aa-aa

eetrbstcedコマンドを実行したTP1/EEのバージョン

a1

統計情報取得タイプ

bb....bb

eetrbstcedコマンドの引数

cc....cc

入力ファイル名

dddd/dd/dd dd:dd:dd ddd.ddd

該当するファイルに出力を開始した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

e1-e1-e1

ファイルを作成したTP1/EEのバージョン

e2-e2-e2

ファイルを作成したTP1/XTCのバージョン※

e3-e3-e3

ファイルを作成したTP1/MCPのバージョン※

e4-e4-e4

ファイルを作成したTP1/XDBのバージョン※

e5-e5-e5

ファイルを作成したTP1/FSPのバージョン※

ff....ff

サービスグループ名（31文字以内）

gggggggg

TP1/EEのランID（8けたの16進数）

jjjj/jj/jj jj:jj:jj

編集対象時間帯の開始日時

「年/月/日△時:分:秒」の形式で出力します。

kkkk/kk/kk kk:kk:kk

編集対象時間帯の終了日時

「年/月/日△時:分:秒」の形式で出力します。

ll....ll

UAP履歴情報グループ名（26文字以内）

mm....mm

一括して予約した通番を，予約してからすべて割り当てるまでの時間（編集対象時間帯の平均値，最大値，最小値（10進数10けた以内，マイクロ秒））

イベント数は一括して予約した通番をすべて割り当てた回数を表示します。値，回数が4294967295以上となった場合は，「*」を表示します。

この値を参照してトランザクション関連定義のtrnaphgroupの-rオプションをチューニングします。

nn....nn

一括して予約した通番の割り当てていない通番の数が，しきい値を下回ってからすべて割り当てるまでの時間（編集対象時間帯の平均値，最大値，最小値（10進数10けた以内，マイクロ秒））

イベント数は一括して予約した通番をすべて割り当てた回数を表示します。値，回数が4294967295以上となった場合は，「*」を表示します。

この値を参照してトランザクション関連定義のtrnaphgroupの-lオプションをチューニングします。

oo....oo

メモリ通番を一括して予約する処理に掛かった時間（編集対象時間帯の平均値，最大値，最小値（10進数10けた以内，マイクロ秒））

イベント数はメモリ通番を一括して予約する処理の回数を表示します。値，回数が4294967295以上となった場合は，「*」を表示します。

この値を参照してトランザクション関連定義のtrnaphgroupの-r，-lオプションをチューニングします。

pp....pp

処理スレッドで通番予約処理を実行した回数

処理スレッドで通番予約処理を実行するのは，次のどちらかの場合です。

UAP履歴情報API実行時に，予約したメモリ通番が不足した場合

UAP履歴情報API実行時に，UAP履歴情報表のスワップが発生した場合

回数が4294967295以上となった場合は，「*」を表示します。

この値を参照してトランザクション関連定義のtrnaphgroupの-r，-lオプション，およびUAP履歴情報取得機能コマンドのeeaphgrphの-cオプションをチューニングします。

qq....qq

すべての統計情報出力バッファが使用中となったために，出力しないで破棄したメモリ通番割り当て統計情報数

破棄したメモリ通番割り当て統計情報がない場合は出力しません。

注※

それぞれのプログラムプロダクトを使用する場合にだけ表示します。

●-eオプションにerspを指定した場合

-cオプションを指定しないときの日本語の出力形式を次に示します。

-cオプションを指定しないときの英語の出力形式を次に示します。

-cオプションを指定したときの日本語の出力形式を次に示します。

-cオプションを指定したときの英語の出力形式を次に示します。

（凡例）

下線：該当する編集対象時間の先頭行にだけ出力します。

出力形式中の，右端の数字の意味を次に示します。

1：サービスグループ名単位に繰り返します。

2：出力範囲の編集対象時間の全レスポンス統計情報を出力するまで繰り返します。

3：サービス名単位に繰り返します。

4：ノード識別子単位に繰り返します。1行には最大10のノード識別子を出力します。

5：改行を含まないで1行で表示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa-aa-aa

eetrbstcedコマンドを実行したTP1/EEのバージョン

bb....bb

eetrbstcedコマンドの引数

cc....cc

入力ファイル名

dddd/dd/dd dd:dd:dd ddd.ddd

該当するファイルに出力を開始した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

e1-e1-e1

ファイルを作成したTP1/EEのバージョン

e2-e2-e2

ファイルを作成したXTCのバージョン※

e3-e3-e3

ファイルを作成したMCPのバージョン※

e4-e4-e4

ファイルを作成したXDBのバージョン※

e5-e5-e5

ファイルを作成したTP1/FSPのバージョン※

T1

統計情報取得タイプ

ff....ff

サービスグループ名（31文字以内）

gggggggg

TP1/EEのランID（8けたの16進数）

hh....hh

ノード識別子

非応答型のRPC要求をした場合は，表示しません。

ii....ii

サービスグループ名（31文字以内）

jjjj/jj/jj jj:jj:jj

編集対象時間帯の開始日時

「年/月/日△時:分:秒」の形式で出力します。

kkkk/kk/kk kk:kk:kk

編集対象時間帯の終了日時

「年/月/日△時:分:秒」の形式で出力します。

ll....ll

サービス名（31文字以内）

先頭がアンダスコア（_）で始まるサービス名は，TP1/EEがTP1/EE間の制御に使用するサービスです。先頭がアンダスコア（_）で始まるサービス名のレスポンス統計情報は，TP1/EEのトラブルシュートに使用します。

mm....mm

各件数（10けた以内の10進数）

該当するサービスに対して発行したRPCの種別ごとの発行回数を表示します。

成功したRPCについてだけ回数を数えます。オーバフローした場合は，「*」を表示します。

xx....xx

レスポンスタイム（10けた以内の10進数）

ee_rpc_call要求をして，サーバに要求を送信してからサーバから応答を受け取るまでの時間を表示します。オーバフローした場合は，「*」を表示します。

同期応答型

ee_rpc_callの要求開始から応答を受け取るまでの時間を表示します。

非同期応答型

ee_rpc_callの要求開始から応答を応答領域に書き込むまでの時間を表示します。

非応答型

時間を取得しません。

yy....yy

サービス実行時間（10けた以内の10進数）

ユーザサービス関数の実行時間を表示します。オーバフローした場合は，「*」を表示します。

zz....zz

サービス待ち時間（10けた以内の10進数）

処理キューに登録してから引き出されるまでの時間を表示します。オーバフローした場合は，「*」を表示します。

nn....nn

すべての出力バッファを使用している間にレスポンス統計情報の出力要求が発生したため，破棄したレスポンス統計情報数

破棄したレスポンス統計情報がない場合は出力しません。

注※

それぞれのプログラムプロダクトを使用する場合にだけ表示します。

送信先のサーバが統計情報機能をサポートしていない場合，サービスグループ名，サービス名，およびRPC種別ごとの発行回数を取得します。ノード識別子，レスポンスタイム，サービス実行時間，およびサービス待ち時間は取得しません。

サービスの実行形態によって，レスポンス統計情報の出力結果が異なります。次に示す実行形態ごとの出力例を参照してください。

サービスの要求元とは別ノードにサービスがある場合

図10‒6　サービスの要求元とは別ノードにサービスがある場合の例

「図10-4　サービスの要求元とは別ノードにサービスがある場合の例」の各ノードで取得された統計情報を編集すると，出力結果は次のようになります。

SPP Aの統計情報を編集した場合

注※1

0が入ります。

注※2

図10-4のt9−t3の値が入ります。

注※3

図10-4のt3−t2の値が入ります。

注※4

図10-4のt8−t4の値が入ります。

注※5

図10-4のt7−t6の値が入ります。

注※6

図10-4のt6−t5の値が入ります。

出力形式中の，各項目の意味を次に示します。

サービスグループAのサービスA

項目

意味

RPC種別ごとの件数

SPP AからサービスグループAのサービスAを1回も呼び出していないことを表しています。

レスポンスタイム

SUPがdc_rpc_callを発行して応答を受け取るまでの時間ですが，SPP Bの統計情報を編集しているため，この値は取得しません。そのため0が入ります。

サービス実行時間

サービスグループAのサービスAが処理を開始してから，応答送信をするまでの時間です。ただし，応答送信をした際の通信時間は含まれません。

サービス待ち時間

SUPからの要求が，処理キューに入ってから取り出されるまでの時間です。

サービスグループBのサービスB

項目

意味

RPC種別ごとの件数

SPP BからサービスグループBのサービスBに対して，同期応答型で1回呼び出したことを表しています。

レスポンスタイム

SPP Aがee_rpc_callを発行して応答を受け取るまでの時間です。

サービス実行時間

サービスグループBのサービスBが処理を開始してから，応答送信をするまでの時間です。ただし，応答送信をした際の通信時間は含まれません。

サービス待ち時間

SPP Aからの要求が，スケジュールキューに入ってから取り出されるまでの時間です。

SPP Bの統計情報を編集した場合

注※1

0が入ります。

注※2

図10-4のt7−t6の値が入ります。

注※3

図10-4のt6−t5の値が入ります。

出力形式中の，各項目の意味を次に示します。

項目

意味

RPC種別ごとの件数

SPP BからサービスグループBのサービスBを1回も呼び出していないことを表しています。

レスポンスタイム

SPP Aがee_rpc_callを発行して応答を受け取るまでの時間ですが，サービスグループBの統計情報を編集しているため，この値は取得しません。そのため0が入ります。

サービス実行時間

サービスグループBのサービスBが処理を開始してから，応答送信をするまでの時間です。ただし，応答送信をした際の通信時間は含まれません。

サービス待ち時間

SPP Aからの要求が，スケジュールキューに入ってから取り出されるまでの時間です。

自ノード内でサービスを実行する場合

自ノード内でサービスを実行する場合の例を次の図に示します。

図10‒7　自ノード内でサービスを実行する場合の例

「図10-5　自ノード内でサービスを実行する場合の例」のノードで取得された統計情報を編集すると，レスポンス統計情報の出力結果は次のようになります。

注※1

0が入ります。

注※2

図10-5のt9−t3の値が入ります。

注※3

図10-5のt3−t2の値が入ります。

注※4

図10-5のt8−t4の値が入ります。

注※5

図10-5のt7−t6の値が入ります。

注※6

図10-5のt6−t5の値が入ります。

出力形式中の，各項目の意味を次に示します。

サービスグループAのサービスA

項目

意味

RPC種別ごとの件数

自ノードからサービスグループAのサービスAを呼び出していないことを示します。クライアントが同一ノード内であっても，クライアントの統計情報はSPP Aで取得しません。

レスポンスタイム

SUPがdc_rpc_callを発行して応答を受け取るまでの時間です。SUPがdc_rpc_callを発行して応答を受け取るまでの時間ですが，SPP Aの統計情報を編集しているため，この値は取得しません。そのため0が入ります。

サービス実行時間

サービスグループAのサービスAが処理を開始してから，応答送信をするまでの時間です。ただし，応答送信をした際の通信時間は含まれません。

サービス待ち時間

SUPからの要求が，スケジュールキューに入ってから取り出されるまでの時間です。

サービスグループBのサービスB

項目

意味

RPC種別ごとの件数

自ノードからサービスグループAのサービスBに対して，同期応答型で1回呼び出したことを表しています。

レスポンスタイム

SPP Aがee_rpc_callを発行して応答を受け取るまでの時間です。

サービス実行時間

サービスグループBのサービスBが処理を開始してから，応答送信をするまでの時間です。ただし，応答送信をした際の通信時間は含まれません。

イベント数は，サービスA側とサービスB側で統計情報を取得するため，2となっています。

平均値についても，（サービスAの値+サービスBの値）÷2の値となっています。

サービス待ち時間

SPP Aからの要求が，スケジュールキューに入ってから取り出されるまでの時間です。

イベント数は，サービスA側とサービスB側で統計情報を取得するため，2となっています。

●-eオプションにedlyを指定した場合

-cオプションを指定しないときの日本語の出力形式を次に示します。

-cオプションを指定しないときの英語の出力形式を次に示します。

-cオプションを指定したときの日本語の出力形式を次に示します。

-cオプションを指定したときの英語の出力形式を次に示します。

出力形式中の，右端の数字の意味を次に示します。

1：送信先ノード識別子単位に繰り返します。

2：出力範囲の編集対象時間の全通信遅延時間統計情報を出力するまで繰り返します。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa-aa-aa

eetrbstcedコマンドを実行したTP1/EEのバージョン

bb....bb

eetrbstcedコマンドの引数

cc....cc

入力ファイル名

dddd/dd/dd dd:dd:dd ddd.ddd

該当するファイルに出力を開始した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

e1-e1-e1

ファイルを作成したTP1/EEのバージョン

e2-e2-e2

ファイルを作成したXTCのバージョン※

e3-e3-e3

ファイルを作成したMCPのバージョン※

e4-e4-e4

ファイルを作成したXDBのバージョン※

e5-e5-e5

ファイルを作成したTP1/FSPのバージョン※

T1

統計情報取得タイプ

ff....ff

サービスグループ名（31文字以内）

gggggggg

TP1/EEのランID（8けたの16進数）

hh....hh

ノード識別子

ii....ii

送信先ノード識別子

jjjj/jj/jj jj:jj:jj

編集対象時間帯の開始日時

「年/月/日△時:分:秒」の形式で出力します。

kkkk/kk/kk kk:kk:kk

編集対象時間帯の終了日時

「年/月/日△時:分:秒」の形式で出力します。

ll....ll

同期型RPCの回数

オーバフローした場合は，「*」を表示します。

TP1/EEがTP1/EE間の制御に使用する同期型RPCの回数を含みます。

xx....xx

レスポンスタイムからサーバ側の処理時間を引いた値

通信（要求送信＋応答送信）に掛かった時間（10けた以内の10進数）を表示します。オーバフローした場合は，「*」を表示します。

mm....mm

すべての出力バッファを使用している間に通信遅延時間統計情報の出力要求が発生したため，破棄した通信遅延時間統計情報数

破棄した通信遅延時間統計情報がない場合は出力しません。

注※

それぞれのプログラムプロダクトを使用する場合にだけ表示します。

送信先のサーバが統計情報機能をサポートしていない場合，通信遅延時間統計情報は取得しません。

●-eオプションにedbqを指定した場合

-cオプションを指定しないときの日本語の出力形式を次に示します。

-cオプションを指定しないときの英語の出力形式を次に示します。

出力形式中の，右端の数字の意味を次に示します。

1：出力範囲の編集対象時間の全DBキュー統計情報を出力するまで繰り返します。

2：DBキュー名単位に繰り返します。

-cオプションを指定したときの日本語の出力形式を次に示します。

-cオプションを指定したときの英語の出力形式を次に示します。

（凡例）

下線：該当する編集対象時間の先頭行にだけ出力します。

出力形式中の，右端の数字の意味を次に示します。

1：改行を含まないで1行で表示します。

2：DBキュー名単位に，出力範囲の編集対象時間の全DBキュー統計情報を出力するまで繰り返します。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa-aa-aa

eetrbstcedコマンドを実行したTP1/EEのバージョン

bb....bb

eetrbstcedコマンドの引数

cc....cc

入力ファイル名

dddd/dd/dd dd:dd:dd ddd.ddd

該当するファイルに出力を開始した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

e1-e1-e1

ファイルを作成したTP1/EEのバージョン

e2-e2-e2

ファイルを作成したXTCのバージョン※

e3-e3-e3

ファイルを作成したMCPのバージョン※

e4-e4-e4

ファイルを作成したXDBのバージョン※

e5-e5-e5

ファイルを作成したTP1/FSPのバージョン※

T1

統計情報取得タイプ

ff....ff

サービスグループ名（31文字以内）

gggggggg

TP1/EEのランID（8けたの16進数）

jjjj/jj/jj jj:jj:jj

編集対象時間帯の開始日時

「年/月/日△時:分:秒」の形式で出力します。

kkkk/kk/kk kk:kk:kk

編集対象時間帯の終了日時

「年/月/日△時:分:秒」の形式で出力します。

ll....ll

DBキュー名（27文字以内）

AA....AA

メッセージの読み出し処理をコミット決着した回数と，メッセージ長の平均値，最大値，最小値（10けた以内の10進数）

オーバフローした場合は，「*」を表示します。

BB....BB

メッセージの書き込み処理をコミット決着した回数と，メッセージ長の平均値，最大値，最小値（10けた以内の10進数）

オーバフローした場合は，「*」を表示します。

CC....CC

メッセージのスキップ処理をコミット決着した数（10けた以内の10進数）

オーバフローした場合は，「*」を表示します。

DD....DD

未読み出しメッセージをチェックした回数と，未読み出しのメッセージ数の平均値，最大値，最小値（10けた以内の10進数）

オーバフローした場合は，「*」を表示します。

他システムがメッセージを読み出すキューの場合は，常に「0」を表示します。

EE....EE

DBキュー内部処理のDBアクセスエラー回数（10けた以内の10進数）

オーバフローした場合は，「*」を表示します。

FF....FF

DBキュー内部処理のメッセージ満杯エラー回数（10けた以内の10進数）

オーバフローした場合は，「*」を表示します。

GG....GG

DBキュー内部処理のDBアクセス（リード）処理回数と，実行時間の平均値，最大値，最小値（10けた以内の10進数）

オーバフローした場合は，「*」を表示します。

HH....HH

DBキュー内部処理のDBアクセス（ライト）処理回数と，実行時間の平均値，最大値，最小値（10けた以内の10進数）

オーバフローした場合は，「*」を表示します。

nn....nn

すべての出力バッファを使用している間にDBキュー統計情報の出力要求が発生したため，破棄したDBキュー統計情報数

破棄したDBキュー統計情報がない場合は出力しません。

注※

それぞれのプログラムプロダクトを使用する場合にだけ表示します。

●-eオプションにeobsを指定した場合

-cオプションを指定しないときの日本語の出力形式を次に示します。

-cオプションを指定しないときの英語の出力形式を次に示します。

出力形式中の，右端の数字の意味を次に示します。

1：出力範囲の編集対象時間の全オンラインバッチ統計情報を出力するまで繰り返します。

2：DBキュー名単位，およびロット名単位に繰り返します。

-cオプションを指定したときの日本語の出力形式を次に示します。

-cオプションを指定したときの英語の出力形式を次に示します。

（凡例）

下線：該当する編集対象時間の先頭行にだけ出力します。

出力形式中の，右端の数字の意味を次に示します。

1：改行を含まないで1行で表示します。

2：DBキュー名単位，およびロット名単位に，出力範囲の編集対象時間の全オンラインバッチ統計情報を出力するまで繰り返します。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa-aa-aa

eetrbstcedコマンドを実行したTP1/EEのバージョン

bb....bb

eetrbstcedコマンドの引数

cc....cc

入力ファイル名

dddd/dd/dd dd:dd:dd ddd.ddd

該当するファイルに出力を開始した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

e1-e1-e1

ファイルを作成したTP1/EEのバージョン

e2-e2-e2

ファイルを作成したXTCのバージョン※

e3-e3-e3

ファイルを作成したMCPのバージョン※

e4-e4-e4

ファイルを作成したXDBのバージョン※

e5-e5-e5

ファイルを作成したTP1/FSPのバージョン※

T1

統計情報取得タイプ

ff....ff

サービスグループ名（31文字以内）

gggggggg

TP1/EEのランID（8けたの16進数）

jjjj/jj/jj jj:jj:jj

編集対象時間帯の開始日時

「年/月/日△時:分:秒」の形式で出力します。

kkkk/kk/kk kk:kk:kk

編集対象時間帯の終了日時

「年/月/日△時:分:秒」の形式で出力します。

ll....ll

DBキュー名（27文字以内）

mm....mm

ロット名（23文字以内）

AA....AA

メッセージの読み出し処理をコミット決着した回数と，メッセージ長の平均値，最大値，最小値（10けた以内の10進数）

オーバフローした場合は，「*」を表示します。

BB....BB

メッセージのスキップ処理をコミット決着した数（10けた以内の10進数）

オーバフローした場合は，「*」を表示します。

CC....CC

未読み出しメッセージをチェックした回数と，未読み出しのメッセージ数の平均値，最大値，最小値（10けた以内の10進数）

オーバフローした場合は，「*」を表示します。

DD....DD

DBキュー内部処理のDBアクセスエラー回数（10けた以内の10進数）

オーバフローした場合は，「*」を表示します。

EE....EE

DBキュー内部処理のDBアクセス（リード）処理回数と，実行時間の平均値，最大値，最小値（10けた以内の10進数）

オーバフローした場合は，「*」を表示します。

FF....FF

DBキュー内部処理のDBアクセス（ライト）処理回数と，実行時間の平均値，最大値，最小値（10けた以内の10進数）

オーバフローした場合は，「*」を表示します。

nn....nn

すべての出力バッファを使用している間にオンラインバッチ統計情報の出力要求が発生したため，破棄したオンラインバッチ統計情報数

破棄したオンラインバッチ統計情報がない場合は出力しません。

注※

それぞれのプログラムプロダクトを使用する場合にだけ表示します。

●-eオプションにeobmを指定した場合

-cオプションを指定しないときの日本語の出力形式を次に示します。

-cオプションを指定しないときの英語の出力形式を次に示します。

1：出力範囲の編集対象時間の全OBM統計情報を出力するまで繰り返します。

2：OBM開始回数単位に繰り返します。

3：ロット名単位に繰り返します。

4：改行キーを含まないで1行で出力します。

-cオプションを指定したときの日本語の出力形式を次に示します。

-cオプションを指定したときの英語の出力形式を次に示します。

（凡例）

下線：該当する編集対象時間の先頭行にだけ出力します。

1：出力範囲の編集対象時間の全OBM統計情報を出力するまで繰り返します。

2：ロット単位に繰り返します。

3：該当する編集対象時間の先頭行にだけ出力します。

4：改行キーを含まないで1行で出力します。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa-aa-aa

eetrbstcedコマンドを実行したTP1/EEのバージョン

a1

統計情報取得タイプ

bb....bb

eetrbstcedコマンドの引数

cc....cc

入力ファイル名

dddd/dd/dd dd:dd:dd ddd.ddd

該当するファイルに出力を開始した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

e1-e1-e1

ファイルを作成したTP1/EEのバージョン

e2-e2-e2

ファイルを作成したTP1/XTCのバージョン※

e3-e3-e3

ファイルを作成したTP1/MCPのバージョン※

e4-e4-e4

ファイルを作成したTP1/XDBのバージョン※

e5-e5-e5

ファイルを作成したTP1/FSPのバージョン※

ff....ff

サービスグループ名（31文字以内）

gggggggg

TP1/EEのランID（8けたの16進数）

hhhhhhhh

OBM名

ii....ii

OBM開始回数

kkkk/kk/kk kk:kk:kk

編集対象時間帯の開始日時

「年/月/日△時:分:秒」の形式で出力します。

llll/ll/ll ll:ll:ll

編集対象時間帯の終了日時

「年/月/日△時:分:秒」の形式で出力します。

mmmmmmm1

レベル1ロット名

mmmmmmm2

レベル2ロット名

mmmmmmm3

レベル3ロット名

nnn

編集期間中の最後のロット状態

WAT：実行待ち

RUN：実行中

PLN：計画停止

STP：強制停止

END：処理済み

pp....pp

該当ロットの処理済み件数

qq....qq

該当ロットの全データ件数

rr....rr

指定時間内に処理をした件数

TP1/EEがダウンした場合や，OBM統計情報の取得を停止していた場合，OBM統計情報が取得されていないため，この値を合計しても全データ件数（qq....qq）と一致しないことがあります。

ss....ss

イベント数：BCMデータ待ち時間の発生した回数

平均値，最大値，最小値：データ待ち時間（10進数10けた以内，マイクロ秒）。

オーバフローした場合は「*」を表示します。

tt....tt

イベント数：BCSデータ待ち時間の発生した回数

平均値，最大値，最小値：データ待ち時間（10進数10けた以内，マイクロ秒）。

オーバフローした場合は「*」を表示します。

uu....uu

イベント数：バッチデータSQLを実行した回数

平均値，最大値，最小値：SQL時間（10進数10けた以内，マイクロ秒）。

オーバフローした場合は「*」を表示します。

注※

それぞれのプログラムプロダクトを使用する場合にだけ表示します。

●-eオプションにallを指定した場合

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

出力形式中の，右端の数字の意味を次に示します。

1：統計情報ごとに出力範囲の編集対象時間の統計情報を出力するまで繰り返します。該当する統計情報が1件もない場合は出力しません。各統計情報の詳細は，該当する統計情報を説明している個所を参照してください。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa-aa-aa

eetrbstcedコマンドを実行したTP1/EEのバージョン

bb....bb

eetrbstcedコマンドの引数

cc....cc

入力ファイル名

dddd/dd/dd dd:dd:dd ddd.ddd

該当するファイルに出力を開始した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

e1-e1-e1

ファイルを作成したTP1/EEのバージョン

e2-e2-e2

ファイルを作成したXTCのバージョン※

e3-e3-e3

ファイルを作成したMCPのバージョン※

e4-e4-e4

ファイルを作成したXDBのバージョン※

e5-e5-e5

ファイルを作成したTP1/FSPのバージョン※

T1

統計情報取得タイプ

ff....ff

サービスグループ名（31文字以内）

gggggggg

TP1/EEのランID（8けたの16進数）

jjjj/jj/jj jj:jj:jj

編集対象時間帯の開始日時

「年/月/日△時:分:秒」の形式で出力します。

kkkk/kk/kk kk:kk:kk

編集対象時間帯の終了日時

「年/月/日△時:分:秒」の形式で出力します。

注※

それぞれのプログラムプロダクトを使用する場合にだけ表示します。

●-eオプションにfを指定した場合

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

出力形式中の，右端の数字の意味を次に示します。

1：指定したファイル数分繰り返します。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa-aa-aa

eetrbstcedコマンドを実行したTP1/EEのバージョン

bb....bb

eetrbstcedコマンドの引数

cc....cc

入力ファイル名

dddd/dd/dd dd:dd:dd ddd.ddd

該当するファイルに出力を開始した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

e1-e1-e1

ファイルを作成したTP1/EEのバージョン

e2-e2-e2

ファイルを作成したXTCのバージョン※

e3-e3-e3

ファイルを作成したMCPのバージョン※

e4-e4-e4

ファイルを作成したXDBのバージョン※

e5-e5-e5

ファイルを作成したTP1/FSPのバージョン※

T1

統計情報取得タイプ

ff....ff

サービスグループ名（31文字以内）

gggggggg

TP1/EEのランID（8けたの16進数）

注※

それぞれのプログラムプロダクトを使用する場合にだけ表示します。

指定したファイルが統計情報ファイルではない場合，日本語では「統計情報ファイルではありません。」を，英語では「This is not a statistical information file.」を表示します。

出力メッセージ

メッセージID

内容

出力先

KFSB95400-E

メモリを確保できません。

標準エラー出力

KFSB95401-E

コマンドの形式が不正です。

標準エラー出力

KFSB95402-E

コマンドのオプションが不正です。

標準エラー出力

KFSB95403-E

コマンドのオプションの組み合わせが不正です。

標準エラー出力

KFSB95405-E

ファイルのヘッダ情報が不正です。

標準エラー出力

KFSB95406-E

データブロックが不正です。

標準エラー出力

KFSB95409-E

バージョンが不一致です。

標準エラー出力

KFSB95410-E

ファイルのオープン処理で障害が発生しました。

標準エラー出力

KFSB95411-E

ファイルからの読み出し処理で障害が発生しました。

標準エラー出力

KFSB95412-E

ファイルへの書き込み処理で障害が発生しました。

標準エラー出力

KFSB95413-E

ファイルのクローズ処理で障害が発生しました。

標準エラー出力

KFSB95415-Q

-cオプションに指定したファイルはすでに存在します。

標準出力

KFSB95439-I

ヘルプメッセージ

標準出力

注意事項

-tオプションおよび-iオプションの指定と，統計情報出力時刻との関係を次の図に示します。統計情報の取得は，-tオプションで指定した時間で終了するため，-iオプションで指定した時間間隔では出力されないことがあります。必要な統計情報を出力できるようにオプションを指定してください。

出力する統計情報が一つもない場合，-eオプションにfを指定した場合と同じ内容を出力します。

出力する統計情報がない時間帯には，「***** 該当データなし *****」と出力します。

eetrbstcedコマンドを実行して出力される平均値は，小数点以下を切り捨てた値です。

eetrbstcese

名称

拡張統計情報の取得

形式

eetrbstcese -g サービスグループ名
          〔-e 拡張統計情報種別〔,拡張統計情報種別…〕〕
          〔-i 時間間隔〕
          〔-r〕

機能

TP1/EEプロセスの拡張統計情報を取得します。

拡張統計情報の取得は，eetrbstceseコマンドに-rオプションを指定して実行したとき，またはTP1/EEプロセスが停止したときに終了します。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

対象となるTP1/EEプロセスのサービスグループ名を指定します。

-gオプション以外のオプションをすべて省略すると，すべての拡張統計情報（レスポンス統計情報，通信遅延時間統計情報，DBキュー統計情報，およびOBM統計情報）を取得します。

●-e　拡張統計情報種別

取得する，または取得を終了する拡張統計情報種別を指定します。

ersp

レスポンス統計情報

edly

通信遅延時間統計情報

edbq

DBキュー統計情報

eobs

オンラインバッチ統計情報

eobm

OBM統計情報

-eオプションを省略すると，ersp，edly，edbq，eobsの拡張統計情報を取得します。

-eオプションを省略して-rオプションを指定すると，ersp，edly，edbq，eobsの拡張統計情報の取得を終了します。

DBキュー機能を使用しない場合に，edbqを指定したときは，edbqの指定は無視されます。edbq以外の拡張統計情報種別も同時に指定した場合，edbq以外の指定は有効です。

オンラインバッチ機能を使用しない場合に，eobsを指定したときは，eobsの指定は無視されます。eobs以外の拡張統計情報種別も同時に指定した場合，eobs以外の指定は有効です。

OBM機能未使用時にeobmを指定した場合，eobmを無視します（同時にeobm以外を指定した場合，オプション不正となります）。

eobm指定時はデータ型OBMが実行中，かつBCMの場合だけOBM統計情報を取得します。

●-ｉ　時間間隔　　〜((1〜60))《1》

OBM統計情報を取得する時間間隔を，分単位で指定します。

-iオプションは拡張統計情報種別にOBM統計情報を指定した場合に指定できます。

●-r

拡張統計情報の取得を終了します。-eオプションを指定した場合は，-eオプションで指定した拡張統計情報の取得を終了します。-eオプションを省略した場合は，ersp，edly，edbq，eobsの拡張統計情報の取得を終了します。-rオプションは，-iのオプションと同時に指定できません。

-g以外のオプションを省略すると，すべての拡張統計情報を取得します。

出力メッセージ

メッセージID

内容

出力先

KFSB95400-E

メモリを確保できません。

標準エラー出力

KFSB95401-E

コマンドの形式が不正です。

標準エラー出力

KFSB95402-E

コマンドのオプションが不正です。

標準エラー出力

KFSB95403-E

オプション組み合わせ不正

標準エラー出力

KFSB95441-I

ヘルプメッセージ

標準出力

KFSB95450-I

コマンドが成功しました。

標準出力

KFSB95451-E

コマンドが失敗しました。

標準エラー出力

KFSB95452-E

コマンドが失敗しました。

標準エラー出力

注意事項

eetrbstceseコマンドは，TP1/EEプロセスの再開始時には引き継がれません。再開始後に拡張統計情報を取得する場合は，eetrbstceseコマンドを再実行してください。ただし，TP1/EEプロセスを再開始する前にトラブルシュート関連定義のtrb_stc_ext_kindオペランドを指定しておくと，再開始後に定義に従って拡張統計情報を取得します。

時間間隔を変更したい場合は，-rオプション指定のeetrbstceseコマンドで取得を終了してから，再度eetrbstceseコマンドを実行してください。OBM統計情報を取得している場合（トラブルシュート情報関連定義のtrb_stc_ext_kindに指定値があるときのTP1/EEプロセス初期化処理後，またはeetrbstceseコマンドによる取得開始後）は，eetrbstceseコマンドによる取得開始は受け付けません。

eetrbstcfput

名称

統計情報の強制出力

形式

eetrbstcfput -g サービスグループ名

機能

統計情報バッファにスタックしている統計情報をファイルに強制出力し，ファイルをスワップします。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

TP1/EEプロセスのサービスグループ名を指定します。

出力メッセージ

メッセージID

内容

出力先

KFSB95400-E

領域不足

標準エラー出力

KFSB95401-E

コマンド形式不正

標準エラー出力

KFSB95402-E

オプション不正

標準エラー出力

KFSB95425-I

コマンド成功（強制出力に成功）

標準出力

KFSB95426-E

コマンド失敗（TP1/EEプロセスでエラーを検知）

標準エラー出力

KFSB95427-E

コマンド失敗（コマンドプロセスでエラーを検知）

標準エラー出力

KFSB95438-I

ヘルプメッセージ

標準出力

eetrbstcse

名称

基本統計情報の取得

形式

eetrbstcse -g サービスグループ名
       ｛〔-e 基本統計情報種別〔,基本統計情報種別…〕〕
         〔-k システム統計情報種別〔,システム統計情報種別…〕〕
         〔-i 時間間隔〕
         ｜-r｝

機能

TP1/EEプロセスの基本統計情報（システム統計情報および処理キュー統計情報）を，指定した時間間隔で取得します。

基本統計情報の取得は，eetrbstcseコマンドに-rオプションを指定して実行したとき，またはTP1/EEプロセスが停止したときに終了します。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

対象となるTP1/EEプロセスのサービスグループ名を指定します。

-gオプション以外のオプションをすべて省略すると，すべての基本統計情報（システム統計情報および処理キュー統計情報）を10分間隔で取得します。

●-e　基本統計情報種別

取得する基本統計情報種別を指定します。

sys

システム統計情報

pci

処理キュー統計情報

apm

UAP履歴情報メモリ通番統計情報

-eオプションを省略すると，すべての基本統計情報を取得します。

注意事項

apmは，TP1/FSPのUAP履歴情報メモリ通番機能を使用（trnaphgroupオペランドの-mオプションを指定）した場合に有効です。TP1/FSPのUAP履歴情報メモリ通番機能を使用していない場合にapmを指定，またはこのオプションを省略するとUAP履歴情報メモリ通番統計情報を取得しません。

●-k　システム統計情報種別

取得するシステム統計情報の種別を指定します。システム統計情報を取得しない場合，-kオプションの指定は無視されます。

api

API情報

aph

UAP履歴情報

dbq

DBキュー情報

fil

ファイルサービス情報

mem

メモリ情報

obm

OBM情報

rpc

RPC情報

scd

スケジュール情報

sdh

SDBハンドラ情報

sts

ステータスファイル情報

tim

タイマ情報

trb

トラブルシュート情報

trn

トランザクション情報

xdb

XDB情報

xtc

XTC情報

-kオプションの指定を省略すると，-kオプションで指定できるすべてのシステム統計情報を取得します。

UAP履歴情報取得機能を使用しない場合にaphを指定したときは，aphの指定は無視されます。

DBキュー機能を使用しない場合にdbqを指定したときは，dbqの指定は無視されます。dbq以外のシステム統計情報種別も同時に指定した場合，dbq以外の指定は有効です。

OBM機能を使用しない場合にobmを指定したときは，obmの指定は無視されます。

SDBハンドラ機能を使用しない場合にsdhを指定したときは，sdhの指定は無視されます。

XDBを使用しない場合にxdbを指定したときは，xdbの指定は無視されます。

XTCを使用しない場合にxtcを指定したときは，xtcの指定は無視されます。

●-i　時間間隔　　((1〜1440))《10》

基本統計情報を取得する時間間隔を，分単位で指定します。

●-r

基本統計情報の取得を終了します。-rオプションは，-gオプション以外のオプションと同時に指定できません。

出力メッセージ

メッセージID

内容

出力先

KFSB95400-E

メモリを確保できません。

標準エラー出力

KFSB95401-E

コマンドの形式が不正です。

標準エラー出力

KFSB95402-E

コマンドのオプションが不正です。

標準エラー出力

KFSB95403-E

コマンドのオプションの組み合わせが不正です。

標準エラー出力

KFSB95437-I

ヘルプメッセージ

標準出力

KFSB95450-I

コマンドが成功しました。

標準出力

KFSB95451-E

コマンドが失敗しました。

標準エラー出力

KFSB95452-E

コマンドが失敗しました。

標準エラー出力

注意事項

eetrbstcseコマンドは，TP1/EEプロセスの再開始時には引き継がれません。再開始後に基本統計情報を取得する場合は，eetrbstcseコマンドを再実行してください。ただし，TP1/EEプロセスを再開始する前にトラブルシュート関連定義のtrb_stc_basic_kindオペランドを指定しておくと，再開始後に定義に従って基本統計情報を取得します。

トラブルシュート情報関連定義のtrb_stc_basic_kindオペランドを指定しているか，またはeetrbstcseコマンドを実行して基本統計情報を取得している場合は，eetrbstcseコマンドによる取得の開始は受け付けません。時間間隔，基本統計情報種別，およびシステム統計情報種別を変更したい場合は，eetrbstcseコマンドに-rオプションを指定して基本統計情報の取得を終了してから，eetrbstcseコマンドを再実行してください。

TP1/FPのUAP履歴情報メモリ通番機能を使用していない場合に，eetrbstcseコマンドの-eオペランドにapmだけを指定した場合は，基本統計情報の取得を開始しません。eetrbstcseコマンドは，KFSB95451-Eを出力して異常終了します。

eetrbtaskdump

名称

TASKTM情報の編集出力（コアファイルまたはメモリダンプファイル入力）

形式

eetrbtaskdump 〔-e 編集種別 〕 〔-r ランID〕 〔-i IFA番号〕
              〔-x 中央処理通番の下限値，中央処理通番の上限値〕
              〔-p {コード1｜コード2}〔,{コード1｜コード2}…〕〕
              〔-v サービス名〔,サービス名…〕〕
                -c CSV出力ファイル名 〔-n ファイル出力行〕
               ファイル名

機能

指定されたコアファイルまたはメモリダンプファイルからTASKTM情報を編集し，CSV形式でファイルに出力します。

オプション

●-e　編集種別　　〜《r》

編集種別を指定します。

r

トランザクション単位で編集，出力します。

rb

DBキューの情報も付加し，トランザクション単位で編集，出力します。

●-r　ランID　　〜〈8文字の16進数〉

指定されたランIDを持つTASKTM情報だけ編集，出力します。

●-i　IFA番号　　〜〈符号なし整数〉((1〜65535))

指定されたIFA番号を持つTASKTM情報だけ編集，出力します。

●-x　中央処理通番の下限値，中央処理通番の上限値　　〜〈1〜8文字の16進数〉((0〜ffffffff))

指定されたカレント中央処理通番の範囲内の情報だけ編集，出力します。-xオプションを指定した場合，上限値および下限値を必ず指定してください。

中央処理通番を指定するときは，最大値（4294967295）を考慮してください。ラップした場合に4294967290から3まで出力したいときは，「-x FFFFFFFA,3」と指定します。

●-p　｛コード1｜コード2｝〔,｛コード1｜コード2｝…〕

指定された処理キューリクエストコードを持つ情報だけ編集，出力します。処理キューリクエストコードは，最大10個指定できます。

コード1

処理キューリクエストコード1を指定します。2文字の16進数で指定してください。

コード2

処理キューリクエストコード1および処理キューリクエストコード2を，"処理キューリクエストコード1""処理キューリクエストコード2"の形式で指定します。処理キューリクエストコード1および処理キューリクエストコード2は，それぞれ2文字の16進数で指定してください。

●-v　サービス名　　〜〈1〜31文字の識別子〉

指定されたサービス名を持つ情報だけ編集，出力します。サービス名は，最大10個指定できます。

●-c　CSV出力ファイル名　　〜〈パス名〉

指定されたファイルに編集結果をCSV形式で出力します。

-nオプションを指定した場合は，パス名中のファイル名は，245文字以下としてください。-nオプション指定時にファイル名が246文字以上の場合はオプションエラーで，このコマンドが異常終了します。

●-n　ファイル出力行　　〜(10000〜100000)

-cオプションに指定したcsvファイルを分割して出力する場合に1ファイルに出力する行数を指定します。見出し行を含めて-nオプションに指定した行数を出力したときに，出力するファイルを切り替えます。切り替えた先のファイルには見出し行から出力します。

分割したファイルには，10進数の文字列をファイル名の末尾に付与します。付与する文字列は1から9999ファイルまでは「0001」からの連番で左に0を埋めた4けたの文字列とします。10000ファイルを超えた場合は左に0埋めをしません。ファイル名に「.」を含む場合は，最後の「.」の前に付与します。

ファイル名に文字列を付与する例を示します。

（例1）-cにxxxと指定した場合

    xxx0001
    xxx0002
     ：

（例2）-cにxxx.csvと指定した場合

    xxx0001.csv
    xxx0002.csv
     ：

このオプションを省略した場合は，ファイルを分割しないで1ファイルに出力します。

コマンド引数

●ファイル名　　〜〈パス名〉

編集するコアファイル名またはメモリダンプファイル名を指定します。

出力形式

-eオプションにrまたはrbを指定した場合の出力形式を次に示します。

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

出力形式中の，右端の数字の意味を次に示します。

1：ヘッダ情報です。出力内容は表10-1を参照してください。

2：トランザクション情報です。出力内容は表10-2を参照してください。

出力形式中の，各変数の意味を次に示します。

表10‒1　ヘッダ情報

項目名

変数

意味

日本語

英語

TASKTMバージョン

TASKTM information Version

aa-aa-aa

eetrbtaskdumpコマンドを実行したTP1/EEのバージョン

出力指定

Specify output

bb....bb

eetrbtaskdumpコマンドの引数

ファイル名

File name

cc....cc

入力ファイル名

ファイル作成日付

File creation date

dddd/dd/dd dd:dd:dd ddd.ddd

TASKTM情報のファイル出力を開始した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

ファイル作成バージョン(TP1/EE)

File creation version(TP1/EE :e1-e1-e1)

e1-e1-e1

ファイルを作成したTP1/EEのバージョン

ファイル作成バージョン(TP1/XTC)

(TP1/XTC:e2-e2-e2)

e2-e2-e2

ファイルを作成したXTCのバージョン※1

ファイル作成バージョン(TP1/MCP)

(TP1/MCP:e3-e3-e3)

e3-e3-e3

ファイルを作成したMCPのバージョン※2

ファイル作成バージョン(TP1/XDB)

(TP1/XDB:e4-e4-e4)

e4-e4-e4

ファイルを作成したXDBのバージョン※3

ファイル作成バージョン(TP1/FSP)

(TP1/FSP:e5-e5-e5)

e5-e5-e5

ファイルを作成したTP1/FSPのバージョン※4

ファイルタイプ

File type

a1

TASKTM情報取得タイプ

サービスグループ名

Service group name

ff....ff

サービスグループ名（31文字以内）

ランID

Run ID

gggggggg

TP1/EEのランID

表10‒2　トランザクション情報

項目名

変数

意味

トラブルシュート関連定義のtrb_tasktm_type オペランドの指定値

日本語

英語

TASKTM出力時刻

TASKTM output time

yyyy/mm/dd hh:mm:ss nnn.nnn

TASKTM情報を取得した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

すべて

起動時刻

Start time

yyyy/mm/dd hh:mm:ss nnn.nnn

トランザクションを起動した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

すべて

サービス名

Service name

n....n

サービス名（31文字以内）

表示する内容がない場合，「*」を表示します。

回復トランザクションの場合は，監視依頼元のサービス名を出力します。

すべて

カレント

Current

0xnnnnnnnn

カレント中央処理通番（8けたの16進数）

すべて

オリジナル

Original

0xnnnnnnnn

オリジナル中央処理通番（8けたの16進数）

すべて

種別

Type

nn

トランザクション種別（2文字）

トランザクション種別については，マニュアル「TP1/Server Base Enterprise Option プログラム作成の手引」のトランザクション種別の説明を参照してください。

表示する内容がない場合，「*」を表示します。

すべて

状態

Status

0xnnnnnnnn

トランザクションの状態（8けたの16進数）

1〜2けた目

(80)₁₆…コミット要求あり

(40)₁₆…ロールバック要求あり

(20)₁₆…送信要求あり

(10)₁₆…UAPからリソースマネジャとのコネクション解放指示あり

(08)₁₆…UAP異常終了

(04)₁₆…監視時間変更あり

(02)₁₆…予備

(01)₁₆…予備

3〜4けた目

(80)₁₆…コミットに決着

(40)₁₆…ロールバックに決着

(20)₁₆…監視依頼

(10)₁₆…TP1/EEによるスレッドダウン

(08)₁₆…大量処理用メモリ管理機能使用中

(04)₁₆…UAP履歴情報の途中書き込みあり

(02)₁₆〜(01)₁₆…予備

5〜6けた目

(80)₁₆…中間同期点取得済み

(40)₁₆…コミットまたはロールバック失敗

(20)₁₆…予備

(10)₁₆…TP1/EEからリソースマネジャとのコネクション解放指示あり

(08)₁₆…リソースマネジャ使用不可トランザクション

(04)₁₆〜(02)₁₆…予備

(01)₁₆…通常処理スレッドまたは予備処理スレッドの処理

　0…通常処理スレッド処理

　1…予備処理スレッド処理

7〜8けた目

(80)₁₆…UAP未起動

(40)₁₆…TP1/EEでロールバックに決着

(20)₁₆…子トランザクションブランチを含みコミットに決着

(10)₁₆…子トランザクションブランチを含みロールバックに決着

(08)₁₆…子トランザクションブランチを含みコマンドまたはリソースマネジャ独自によるコミットに決着

(04)₁₆…子トランザクションブランチを含みコマンドまたはリソースマネジャ独自によるロールバックに決着

(02)₁₆…子トランザクションブランチを含みコマンドまたはリソースマネジャ独自によるヒューリスティックハザードに決着

(01)₁₆…子トランザクションブランチを含みコマンドまたはリソースマネジャ独自によるヒューリスティックミックスに決着

すべて

pce

pce

nn nn nnnnnnnn

処理キューコード（14文字）

すべて

IFA

IFA

n....n

IFA番号（5けた以内の10進数）

すべて

IPアドレス

IP address

n....n.n....n.n....n.n....n

トランザクション要求元のIPアドレス（「.」で区切った四つの3けた以内の10進数）

UNIXドメインを使用したRPCの場合，およびタイマなどプロセス内の要求の場合は「0.0.0.0」を表示します。

すべて

ポート

Port

n....n

トランザクション要求元のポート番号（5けた以内の10進数）

通信方式がINETドメインの場合は送信元のポート番号，UNIXドメインを使用したRPCの場合は受信スレッドのポート番号を表示します。

すべて

pce時間

pce time

n....n.nnn

処理キュー引き出し待ち時間

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。

すべて

トランザクション時間

Transaction time

n....n.nnn

トランザクション実行時間

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。

すべて

UAP時間

UAP time

n....n.nnn

UAP実行時間

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。

すべて

TRB1

TRB1

n....n.nnn

TP1/EEで使用するトラブルシュート情報

すべて

SQL回数

SQL count

n....n

トランザクション内で発行したHiRDBのSQLの合計発行回数（10けた以内の10進数）※5

すべて

SQL実行時間

Execution time

n....n.nnn

トランザクション内で発行したHiRDBのSQLの合計実行時間※5

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。

すべて

HiRDBサーバ名

HiRDB server

n....n

HiRDBのサーバ名（8文字以内）※5

表示する内容がない場合，「*」を表示します。

すべて

接続先ID

Con ID

n....n

HiRDBサーバの接続先ID（10けた以内の10進数）※5

すべて

サーバID

Server ID

n....n

HiRDBサーバのプロセスID（10けた以内の10進数）※5

すべて

合計pce数

Total pce

n....n

登録済みの処理キュー数の合計（10けた以内の10進数）

すべて

滞留pce数

Resident pce

n....n

滞留している処理キュー数（10けた以内の10進数）

すべて

起動スレッド数

Start thread

n....n

起動中の通常処理スレッド数，または回復スレッド数（5けた以内の10進数）

すべて

起動予備スレッド数

Standby thread

n....n

起動中の予備処理スレッド数（5けた以内の10進数）

すべて

TRB2

TRB2

n....n

TP1/EEで使用するトラブルシュート情報

すべて

TRB3

TRB3

n....n.nnn

TP1/EEで使用するトラブルシュート情報

すべて

API回数

API count

n....n

API関数の呼び出し回数（5けた以内の10進数）

すべて

API実行時間

API time

n....n.nnn

API関数の実行時間

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。

すべて

TRB4

TRB4

n....n

TP1/EEで使用するトラブルシュート情報

すべて

TRB5

TRB5

n....n.nnn

TP1/EEで使用するトラブルシュート情報

すべて

DBキュー名

DB queue name

n....n

DBキュー名（27文字以内）※6

すべて

ロット名

Lot name

n....n

ロット名（23文字以内）※6

すべて

DBキュー通番

DB queue num

n....n

DBキューメッセージの読み込み通番（5けた以内の10進数）※6

すべて

DBキュー回数

DB queue count

n....n

DBキュー機能のアクセス回数（5けた以内の10進数）※6

すべて

DBキューアクセス実行時間

DB queue access time

n....n.nnn

DBキュー機能のアクセス時間※6

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。

すべて

同期点実行時間

Synchro time

n....n.nnn

同期点実行時間※7

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。

すべて

ディスクリプタ不足

Descriptor shortage

n....n

ディスクリプタ不足によるコネクション確立失敗回数※7

すべて

EAGAIN

EAGAIN

n....n

送信時のEAGAIN発生回数※7

すべて

CL通番

CL number

0xnnnnnnnnnnnnnnnn

CLサーバでの自系のCL通番※1，※8

2，3

実行系CL通番

Online CL number

0xnnnnnnnnnnnnnnnn

CLサーバ（待機系）での，実行系のCL通番※1，※8

2，3

msgrcv回数

Msgrcv_count

n....n

ee_scd_msg_receive関数の発行回数（累計）※1，※8

2，3

排他API要求回数

Ex-API req count

n....n

排他APIの要求回数（累計）※8

2，3

排他API保持時間

Ex-API remain time

n....n

排他APIの保持時間（累計）※8

2，3

排他API待ち時間

Ex-API wait time

n....n.nnn

排他APIの待ち時間（累計）※8

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。

2，3

排他API待ち行列数

Ex-API wait que cnt

n....n

排他API待ち行列数の最大※8

2，3

排他API待ちタイムアウト回数

Ex-API wait timeout cnt

n....n

排他API待ちタイムアウト回数（累計）※8

2，3

MCP論理端末名

MCP term name

n....n

MCPメッセージのトランザクションの場合の，メッセージを受信したMCPの論理端末名※2，※8

2，3

コネクションID

Connection ID

n....n

MCPメッセージのトランザクションの場合の，メッセージを受信したMCPのコネクションID名（トランザクション起動時）※2，※8

2，3

UOC実行時間

UOC time

n....n

UOC実行時間（累計）※2，※8

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。

2，3

XDB_SQL実行時間

XDB_SQL time

n....n.nnn

XDBのSQL実行時間※3，※8

2

XDB_処理行数

XDB_search line

n....n

XDBの処理行数※3，※8

2

XDB_更新行数

XDB_updated line

n....n

XDBの更新行数※3，※8

2

XDB_参照系SQL実行回数

XDB_refer SQL count

n....n

XDBの参照系SQL実行回数※3，※8

2

XDB_更新系SQL実行回数

XDB_update SQL count

n....n

XDBの更新系SQL実行回数※3，※8

2

作業表作成回数

W-table c-cnt

n....n

XDBの作業表作成回数※3，※8

2

作業表削除回数

W-table d-cnt

n....n

XDBの作業表削除回数※3，※8

2

作業表確保最大ページ数

W-table max page count

n....n

XDBの作業表確保最大ページ数※3，※8

2

ページ要求回数

Page req count

n....n

XDBのページ要求回数※3，※8

2

XDB_COMMIT処理時間

XDB_COMMIT time

n....n

XDB部分のコミット処理時間※3，※8

2

XDB_COMMIT排他待ち時間

XDB_COMMIT lock wait time

n....n

XDB部分のコミット排他待ち時間※3，※8

2

更新バッファ長

Update b-len

n....n

更新バッファの長さ※3，※8

2

XDB_状態

XDB_status

0xnnnnnnnn

XDBの状態※3，※8

2

XDB_スレッド領域追加確保回数

XDB_thread area count

n....n

トランザクションの処理中にXDBスレッド領域が追加確保された回数※3，※8

2

XDB_スレッド領域最大使用サイズ

XDB_thread area max size

n....n

トランザクションの処理中に実際に使用されたXDBスレッド領域の最大サイズ※3，※8

2

受信ID

Receiving ID

0xnnnnnnnn

回線トレースと結び付ける受信ID（8けたの16進数）

すべて

UAP履歴情報数

UAP log information count

n....n

UAP履歴情報の取得回数（10けた以内の10進数）※4

1回のAPIで複数のUAP履歴情報の取得を要求した場合は，UAP履歴情報の数でカウントします。また，OJなど製品が取得するUAP履歴情報の取得回数を含みます。

3

UAP履歴情報サイズ

UAP log information total size

n....n

UAP履歴情報の取得サイズの合計（10けた以内の10進数）※4

履歴情報共通インデクスのサイズも含みます。

3

UAP履歴情報書き込み時間

UAP log information write time

n....n.nnn

UAP履歴情報の書き込みに掛かった時間の合計※4

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。

UAP履歴情報の通番割り当てに掛かった時間を含みます。

3

UAP履歴情報通番割り当て時間

UAP log information assign time

n....n.nnn

UAP履歴情報の通番割り当てに掛かった時間の合計※4

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。

3

トランザクションレベル名

Transaction level name

n....n

トランザクションレベル名（31文字以内の文字列）※4，※9

3

トランレベルpce数

Tran-level Resident pce

n....n

処理キューから引き出した時点の該当トランザクションレベル名の処理キューに登録されている，PCE数（10けた以内の10進数）※4，※9

3

SDH_SQL実行回数

SDH_SQL count

n....n

SDBハンドラのSQL実行回数（10けた以内の10進数）※4，※10

3

SDH_SQL実行時間

SDH_SQL execution time

n....n.nnn

SDBハンドラのSQL実行時間※4，※10

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。

3

SDH_ワークメモリ使用サイズ

SDH_Work memory used size

n....n

SDBハンドラ用ワークメモリの使用サイズ（10けた以内の10進数）※4，※10

3

SDH_状態

SDH_status

0xnnnnnnnn

SDBハンドラ状態（8けたの16進数）※4，※10

1〜2けた目

(80)₁₆…該当するトランザクションでSDBハンドラを使用

(40)₁₆…デッドロック検知，および排他待ち時間超過検知

(20)₁₆…SQLエラー発生

(10)₁₆…予備

(08)₁₆…ee_trn_retry_rollback関数発行

(04)₁₆…ee_trn_rollback_mark関数発行

(02)₁₆〜(01)₁₆…予備

3〜4けた目…予備

5〜6けた目

(80)₁₆…イニシャライズAPI発行

(40)₁₆…個別開始API発行

(20)₁₆…個別終了API発行

(10)₁₆…システム構成表示（キーの容量）API発行

(08)₁₆〜(01)₁₆…予備

7〜8けた目

(80)₁₆〜(20)₁₆…予備

(10)₁₆…一括削除API発行

(08)₁₆…SDBアクセス（検索）API発行

(04)₁₆…SDBアクセス（格納）API発行

(02)₁₆…SDBアクセス（変更）API発行

(01)₁₆…SDBアクセス（削除）API発行

3

業務ID

Biz ID

XXXX(nn....nn)

業務ID

XXXXには，業務IDの先頭4バイトを文字列で出力します。表示不能な文字は'.'で出力します。

nn....nnには，業務IDを16進数で出力します(XXXXで出力する，業務IDの先頭4バイトを含む）。※4

3

業務ID属性

Biz ID Type

n....n

業務IDの属性

START：TP1/FSPが新規に業務IDを割り当てた

CONTINUE：TP1/FSPが既存の業務IDを引き継いだ

CONTINUE_USER：ユーザ指示によって業務IDを引き継いだ※4

3

業務IDネスト数

Biz ID Nest

n....n

業務IDのネスト数※4

3

業務ID送信元ノード識別子

Biz ID node ID

XXXX(nn....nn)

業務IDの送信元TP1/EEのノード識別子

XXXXには，表示不能な文字は'.'で出力する。

次のどれかの場合は，"****(2a2a2a2a)"と出力する。

TP1/FSPが新規に業務IDを割り当てた

TP1/FSPが業務IDをプロセス内連携で引き継いだ場合で，引き継ぎ元のトランザクションで新規に業務IDを割り当てていた

ユーザ指示によって業務IDを引き継いだ場合は，ユーザが指示した値が出力します。※4

3

OBM_UOC実行時間

OBM_UOC time

n....n.nnn

OBMのUOC実行時間「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。※4

3

OBM名／ロット名

OBM/Lot name

n....n

トランザクションに対応するOBM名かロット名

ロットの階層が1階層の場合は，OBM名を出力します。

ロットの階層が2階層以上の場合は，OBM名の後に'-'で区切って2階層目以降のロット名を上位階層から順に出力します。※4

3

スレッドID

Thread ID

n....n

スレッドID

Linuxの場合だけ

すべて

OBM管理表_SQL実行回数

OBM_table_SQL count

n....n

OBM管理表へのSQL実行回数※4

3

OBM管理表_SQL実行時間

OBM_table_SQL exec time

n....n.nnn

OBM管理表へのSQL実行時間「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。※4

3

バッチデータ表_SQL実行回数

Batch_data_table_SQL count

n....n

バッチデータ表へのSQL実行回数※4

3

バッチデータ表_SQL実行時間

Batch_data_table_SQL exec time

n....n.nnn

バッチデータ表へのSQL実行時間「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。※4

3

BCMデータ待ち時間

BCM Data wait time

n....n.nnn

BCSへデータ送信できない時間「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。※4

3

BCSデータ待ち時間

BCS Data wait time

n....n.nnn

BCSが次のデータを待っている時間「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。※4

3

UAP履歴情報_状態

UAP log status

0xnnnn

UAP履歴情報の状態

1〜2けた目

(80)₁₆：処理スレッドの通番予約有無

UAP履歴情報メモリ通番機能使用時の場合だけセットされる可能性がある

(40)₁₆：スワップ有無

(20)₁₆：UAP履歴情報の途中書き込み有

(10)₁₆：予備

(08)₁₆：OJ取得要求失敗あり(RPC/RAP)

(04)₁₆：OJ取得要求失敗あり(MCP)

(02)〜(01)₁₆：予備

3〜4けた目：予備※4

3

FSP_状態

FSP_Status

0xnnnn

FSPの状態

1〜2けた目：(全銀RC)

(80)₁₆：送達管理電文 NAK送信要求あり

(40)₁₆：OJ出力有無を示すコード。※11

　0x00：OJ出力なし※12

　0x01：OJ出力あり

(20)₁₆：リトライロールバック要求あり※13

(10)₁₆：リトライロールバック要求が上限に達した※14

またはリトライロールバック前処理UOCのリターン値がEETRN_UOC_NORETRY_KILLかEETRN_UOC_NORETRY_ABORT

(08)₁₆：DBキューの交替用メッセージ表書き込み機能でリトライ実施

(04)〜(01)₁₆：予備

3〜4けた目

(80)〜(01)₁₆：予備※4

3

論理パス名

Logical Path Name

n....n

全銀RCプロトコル接続機能の情報メッセージ，送達管理メッセージのトランザクションの場合の，メッセージを受信した論理パス名

3

ユーザ情報

User Infomation

n....n

ee_trb_uinfo_tm()で登録したユーザ情報

63文字の文字列または126けたの16進数

すべて

0xnn....nn

TASKTM出力再開始時刻

TASKTM output restart time

yyyy/mm/dd hh:mm:ss nnn.nnn

TASKTM情報の出力を再開した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。XA関数呼び出し前のときに表示します。

すべて

TASKTM情報破棄数

TASKTM information destruction count

n....n

すべての出力バッファを使用している間にTASKTM情報の出力要求が発生したため，破棄したレコード数

すべて

注※1

XTCを使用する場合にだけ表示します。

注※2

MCPを使用する場合にだけ表示します。

注※3

XDBを使用する場合にだけ表示します。

注※4

TP1/FSPを使用する場合にだけ表示します。

注※5

HiRDBの情報を最大8個表示します。リソースマネジャに対してアクセスした順番に8個のHiRDBの情報を表示します。アクセスしたHiRDBが9個以上になっても8個の情報だけ表示します。

この情報は，HiRDBのSQLを発行した場合に表示します。HiRDB以外のSQLを発行した場合，またはSQLを発行していない場合は，数値には「0」を，文字には「*」を表示します。

注※6

DBキューサービスの場合で，-eオプションにrbを指定したときだけ表示します。

注※7

ファイルを作成したTP1/EEのバージョンが01-02以降のときに表示します。

注※8

トラブルシュート関連定義のtrb_tasktm_typeオペランドに2を指定した場合にだけ表示します。

注※9

トランザクションレベル方式の処理キューを使用する場合にだけ表示します。

注※10

SDBハンドラを使用する場合にだけ表示します。

注※11

RPC/RAPの応答電文の送信時にOJを出力した場合に表示します。取得対象のトランザクションはMN，E3，ERです。

注※12

「OJ出力なし」とは，次のどちらかを意味します。

・OJ出力なし。

・OJ出力あり（ヘッダ出力，ユーザデータ出力なし）。

なお，次のどちらかに該当する場合，「OJ出力あり（ヘッダ出力，ユーザデータ出力なし）」となります。

・機能拡張オペランドで「00000001」（ユーザデータ取得なし）を指定している。

・OJ編集UOCで編集後のユーザデータサイズが0である。

注※13

リトライ回数に関係なく設定します。

注※14

リトライ回数超過（API発行時点で，定義数分リトライ済）時に設定します。

出力メッセージ

メッセージID

内容

出力先

KFSB95400-E

メモリを確保できません。

標準エラー出力

KFSB95401-E

コマンドの形式が不正です。

標準エラー出力

KFSB95402-E

コマンドのオプションが不正です。

標準エラー出力

KFSB95403-E

コマンドのオプションの組み合わせが不正です。

標準エラー出力

KFSB95410-E

ファイルのオープン処理で障害が発生しました。

標準エラー出力

KFSB95411-E

ファイルからの読み出し処理で障害が発生しました。

標準エラー出力

KFSB95412-E

ファイルへの書き込み処理で障害が発生しました。

標準エラー出力

KFSB95413-E

ファイルのクローズ処理で障害が発生しました。

標準エラー出力

KFSB95414-E

ファイルポインタの移動処理で障害が発生しました。

標準エラー出力

KFSB95415-Q

-cオプションに指定したファイルはすでに存在します。

標準出力

KFSB95416-E

指定したファイルに編集するデータがありません。

標準エラー出力

KFSB95443-I

ヘルプメッセージ

標準出力

KFSB95457-Q

上書き確認（-nオプション指定時）

標準出力

注意事項

編集対象のレコードがないときは，ヘッダ情報だけを表示します。

該当するTASKTM情報が，TASKTMファイルに出力される以前の情報であった場合は，「*」を表示します。

経過時間を表示する項目で4294967.295ミリ秒を超えた場合，「4294967.295」を表示します。

TASKTM情報取得時の障害発生などで情報を取得できない場合は，取得できなかった情報の値に「0」が表示されます。

ファイル名に指定できるコアファイルまたはメモリダンプファイルは，該当するバージョンの該当するOSで作成されたファイルだけです。

-cオプションを指定してCSVファイルに出力する場合，ファイル作成バージョンは，日本語では「ファイル作成バージョン：dd-dd-dd」の形式で，英語では「File creation version: dd-dd-dd」の形式で表示します。

eetrbtasked

名称

TASKTM情報の編集出力

形式

ファイル一覧を出力する場合

eetrbtasked 〔-e f〕TASKTMファイル名 〔TASKTMファイル名…〕

トランザクション単位で編集，出力する場合

eetrbtasked -e r 〔b〕〔-t 〔開始時刻〕〔,終了時刻〕〕
            〔-r ランID〕 〔-i IFA番号〕
            〔-x 中央処理通番の下限値,中央処理通番の上限値〕
            〔-p ｛コード1｜コード2｝〔,｛コード1｜コード2｝…〕〕
            〔-v サービス名〔,サービス名…〕〕
              -c CSV出力ファイル名〔-n ファイル出力行〕
            〔-s 〔-j 編集間隔〕〕
            TASKTMファイル名

機能

TASKTM情報を編集し，CSV形式でファイルに出力します。

オプション

●-e　編集種別　　〜《f》

編集種別を指定します。

r

トランザクション単位で編集，出力します。

rb

DBキューの情報も付加し，トランザクション単位で編集，出力します。

f

ファイル情報一覧を出力します。

-eオプションにfを指定した場合，その他のオプションを指定するとエラーになります。

-cオプションも指定しないでください。

●-t　開始時刻,終了時刻

指定された時刻内に，出力バッファに出力されたTASKTM情報を編集，出力します。

開始時刻，および終了時刻は，1970年1月1日0時0分0秒から当年当月当日の現在時刻までの範囲で指定します。

開始時刻または終了時刻のどちらか一方を必ず指定してください。開始時刻の指定を省略すると，TASKTMファイルの先頭から指定した終了時刻までが出力範囲になります。終了時刻の指定を省略すると，指定した開始時刻からTASKTMファイルの最後までが，出力範囲になります。

開始時刻，および終了時刻は，「hhmmss〔MMDD〔YYYY〕〕」の形式で指定します。

hh：時（00≦hh≦23）

指定を省略できません。

mm：分（00≦mm≦59）

指定を省略できません。

ss：秒（00≦ss≦59）

指定を省略できません。

MM：月（01≦MM≦12）

指定を省略できます。※

DD：日（01≦DD≦31）

指定を省略できます。※

YYYY：年（西暦）（1970≦YYYY≦9999）

指定を省略できます。※

注※

開始時刻，または終了時刻の「年」の指定を省略した場合は，当年の指定月日時刻と見なされます。「年，月，日」の指定を省略した場合，当年当月当日の指定時刻と見なされます。「月，日」，「月」，または「日」だけを省略することはできません。省略した場合はオプションエラーになります。「月」または「日」を省略したい場合は，「年」，「月」，「日」のすべてを省略してください。

-tオプションの指定を省略すると，指定したファイル内のすべての情報を編集，出力します。

●-r　ランID　　〜〈8文字の16進数〉

指定されたランIDを持つTASKTM情報だけ編集，出力します。

●-i　IFA番号　　〜〈符号なし整数〉((1〜65535))

指定されたIFA番号を持つTASKTM情報だけ編集，出力します。

●-x　中央処理通番の下限値,中央処理通番の上限値　　〜〈1〜8文字の16進数〉((0〜ffffffff))

指定されたカレント中央処理通番の範囲内の情報だけ編集，出力します。-xオプションを指定する場合，上限値および下限値を必ず指定してください。

中央処理通番を指定する場合，最大値（4294967295）を考慮して指定してください。ラップした場合に4294967290から3まで出力したいときは，「-x FFFFFFFA,3」と指定します。

●-p　｛コード1｜コード2｝〔,｛コード1｜コード2｝…〕

指定された処理キューリクエストコードを持つ情報だけ編集，出力します。処理キューリクエストコードは，最大10個指定できます。

コード1

処理キューリクエストコード1を指定します。2文字の16進数で指定してください。

コード2

処理キューリクエストコード1および処理キューリクエストコード2を，"処理キューリクエストコード1""処理キューリクエストコード2"の形式で指定します。処理キューリクエストコード1および処理キューリクエストコード2は，それぞれ2文字の16進数で指定してください。

●-v　サービス名　　〜〈1〜31文字の識別子〉

指定されたサービス名を持つ情報だけ編集，出力します。サービス名は，最大10個指定できます。

●-c　CSV出力ファイル名　　〜〈パス名〉

指定したファイルに編集結果をCSV形式で出力します。

-nオプションを指定した場合は，パス名中のファイル名は，245文字以下としてください。-nオプション指定時にファイル名が246文字以上の場合はオプションエラーで，このコマンドが異常終了します。

●-n　ファイル出力行　〜((10000〜100000))

-cオプションに指定したcsvファイルを分割して出力する場合に1ファイルに出力する行数を指定します。見出し行を含めて-nオプションに指定した行数を出力したときに，出力するファイルを切り替えます。切り替えた先のファイルには見出し行から出力します。

分割したファイルには，10進数の文字列をファイル名の末尾に付与します。付与する文字列は1から9999ファイルまでは「0001」からの連番で左に0を埋めた4けたの文字列とします。10000ファイルを超えた場合は左に0埋めをしません。ファイル名に「.」を含む場合は，最後の「.」の前に付与します。

ファイル名に文字列を付与する例を示します。

（例1）-cにxxxと指定した場合

      xxx0001
      xxx0002
       ：

（例2）-cにxxx.csvと指定した場合

      xxx0001.csv
      xxx0002.csv
       ：

このオプションを省略した場合は，ファイルを分割しないで1ファイルに出力します。

●-s

一定の間隔で取得したTASKTM情報の平均値，最大値，および最小値を算出して，編集，出力します。

●-j　編集間隔　　〜《h01》

統計情報を編集，出力する間隔を，時間または分で指定します。

h〔HH〕

時間間隔（01≦HH≦24）で出力します。

HHの指定を省略すると，1時間間隔で出力されます。

m〔MM〕

分間隔（01≦MM≦30）で出力します。

MMの指定を省略すると，10分間隔で出力されます。

時間間隔と分間隔の両方を指定すると，エラーになります。

-jオプションの指定を省略すると，1時間間隔で出力されます。

コマンド引数

●TASKTMファイル名　　〜〈パス名〉

編集するファイル名を指定します。-eオプションにfを指定した場合は，最大1024個TASKTMファイル名を指定できます。

指定できるオプションの組み合わせを次の図に示します。

図10‒8　eetrbtaskedコマンドのオプションの組み合わせ

（凡例）

○：指定できます。

×：指定できません。

−：該当しません。

出力形式

●-eオプションにrまたはrbを指定した場合

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

出力形式中の，右端の数字の意味を次に示します。

1：ヘッダ情報です。出力内容は表10-3を参照してください。

2：トランザクション情報です。出力内容は表10-4を参照してください。

出力形式中の，各変数の意味を次に示します。

表10‒3　ヘッダ情報

項目名

変数

意味

日本語

英語

TASKTMバージョン

TASKTM information Version

aa-aa-aa

eetrbtaskedコマンドを実行したTP1/EEのバージョン

出力指定

Specify output

bb....bb

eetrbtaskedコマンドの引数

ファイル名

File name

cc....cc

入力ファイル名

ファイル作成日付

File creation date

dddd/dd/dd dd:dd:dd ddd.ddd

TASKTM情報のファイル出力を開始した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

ファイル作成バージョン(TP1/EE)

File creation version(TP1/EE :e1-e1-e1)

e1-e1-e1

ファイルを作成したTP1/EEのバージョン

ファイル作成バージョン(TP1/XTC)

(TP1/XTC:e2-e2-e2)

e2-e2-e2

ファイルを作成したXTCのバージョン※1

ファイル作成バージョン(TP1/MCP)

(TP1/MCP:e3-e3-e3)

e3-e3-e3

ファイルを作成したMCPのバージョン※2

ファイル作成バージョン(TP1/XDB)

(TP1/XDB:e4-e4-e4)

e4-e4-e4

ファイルを作成したXDBのバージョン※3

ファイル作成バージョン(TP1/FSP)

(TP1/FSP:e5-e5-e5)

e5-e5-e5

ファイルを作成したTP1/FSPのバージョン※4

ファイルタイプ

File type

a1

TASKTM情報取得タイプ

サービスグループ名

Service group name

ff....ff

サービスグループ名（31文字以内）

ランID

Run ID

gggggggg

TP1/EEのランID

表10‒4　トランザクション情報

項目名

変数

意味

トラブルシュート関連定義のtrb_tasktm_type オペランドの指定値

日本語

英語

TASKTM出力時刻

TASKTM output time

yyyy/mm/dd hh:mm:ss nnn.nnn

TASKTM情報を取得した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

すべて

起動時刻

Start time

yyyy/mm/dd hh:mm:ss nnn.nnn

トランザクションを起動した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

すべて

サービス名

Service name

n....n

サービス名（31文字以内）

表示する内容がない場合，「*」を表示します。

回復トランザクションの場合は，監視依頼元のサービス名を出力します。

すべて

カレント

Current

0xnnnnnnnn

カレント中央処理通番（8けたの16進数）

すべて

オリジナル

Original

0xnnnnnnnn

オリジナル中央処理通番（8けたの16進数）

すべて

種別

Type

nn

トランザクション種別（2文字）

トランザクション種別については，マニュアル「TP1/Server Base Enterprise Option プログラム作成の手引」のトランザクション種別の説明を参照してください。

表示する内容がない場合，「*」を表示します。

すべて

状態

Status

0xnnnnnnnn

トランザクションの状態（8けたの16進数）

1〜2けた目

(80)₁₆…コミット要求あり

(40)₁₆…ロールバック要求あり

(20)₁₆…送信要求あり

(10)₁₆…UAPからリソースマネジャとのコネクション解放指示あり

(08)₁₆…UAP異常終了

(04)₁₆…監視時間変更あり

(02)₁₆…静止化要求によるトランザクション強制終了

(01)₁₆…予備

3〜4けた目

(80)₁₆…コミットに決着

(40)₁₆…ロールバックに決着

(20)₁₆…監視依頼

(10)₁₆…TP1/EEによるスレッドダウン

(08)₁₆…大量処理用メモリ管理機能使用中

(04)₁₆…UAP履歴情報の途中書き込みあり

(02)₁₆〜(01)₁₆…予備

5〜6けた目

(80)₁₆…中間同期点取得済み

(40)₁₆…コミットまたはロールバック失敗

(20)₁₆…予備

(10)₁₆…TP1/EEからリソースマネジャとのコネクション解放指示あり

(08)₁₆…リソースマネジャ使用不可トランザクション

(04)₁₆〜(02)₁₆…予備

(01)₁₆…通常処理スレッドまたは予備処理スレッドの処理

　0…通常処理スレッド処理

　1…予備処理スレッド処理

7〜8けた目

(80)₁₆…UAP未起動

(40)₁₆…TP1/EEでロールバックに決着

(20)₁₆…子トランザクションブランチを含みコミットに決着

(10)₁₆…子トランザクションブランチを含みロールバックに決着

(08)₁₆…子トランザクションブランチを含みコマンドまたはリソースマネジャ独自によるコミットに決着

(04)₁₆…子トランザクションブランチを含みコマンドまたはリソースマネジャ独自によるロールバックに決着

(02)₁₆…子トランザクションブランチを含みコマンドまたはリソースマネジャ独自によるヒューリスティックハザードに決着

(01)₁₆…子トランザクションブランチを含みコマンドまたはリソースマネジャ独自によるヒューリスティックミックスに決着

すべて

pce

pce

nn nn nnnnnnnn

処理キューコード（14文字）

すべて

IFA

IFA

n....n

IFA番号（5けた以内の10進数）

すべて

IPアドレス

IP address

n....n.n....n.n....n.n....n

トランザクション要求元のIPアドレス（「.」で区切った四つの3けた以内の10進数）

UNIXドメインを使用したRPCの場合，およびタイマなどプロセス内の要求の場合は「0.0.0.0」を表示します。

すべて

ポート

Port

n....n

トランザクション要求元のポート番号（5けた以内の10進数）

通信方式がINETドメインの場合は送信元のポート番号，UNIXドメインを使用したRPCの場合は受信スレッドのポート番号を表示します。

すべて

pce時間

pce time

n....n.nnn

処理キュー引き出し待ち時間

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。

すべて

トランザクション時間

Transaction time

n....n.nnn

トランザクション実行時間

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。

すべて

UAP時間

UAP time

n....n.nnn

UAP実行時間

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。

すべて

TRB1

TRB1

n....n.nnn

TP1/EEで使用するトラブルシュート情報

すべて

SQL回数

SQL count

n....n

トランザクション内で発行したHiRDBのSQLの合計発行回数（10けた以内の10進数）※5

すべて

SQL実行時間

Execution time

n....n.nnn

トランザクション内で発行したHiRDBのSQLの合計実行時間※5

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。

すべて

HiRDBサーバ名

HiRDB server

n....n

HiRDBのサーバ名（8文字以内）※5

表示する内容がない場合，「*」を表示します。

すべて

接続先ID

Con ID

n....n

HiRDBサーバの接続先ID（10けた以内の10進数）※5

すべて

サーバID

Server ID

n....n

HiRDBサーバのプロセスID（10けた以内の10進数）※5

すべて

合計pce数

Total pce

n....n

登録済みの処理キュー数の合計（10けた以内の10進数）

すべて

滞留pce数

Resident pce

n....n

滞留している処理キュー数（10けた以内の10進数）

すべて

起動スレッド数

Start thread

n....n

起動中の通常処理スレッド数，または回復スレッド数（5けた以内の10進数）

すべて

起動予備スレッド数

Standby thread

n....n

起動中の予備処理スレッド数（5けた以内の10進数）

すべて

TRB2

TRB2

n....n

TP1/EEで使用するトラブルシュート情報

すべて

TRB3

TRB3

n....n.nnn

TP1/EEで使用するトラブルシュート情報

すべて

API回数

API count

n....n

API関数の呼び出し回数（5けた以内の10進数）

すべて

API実行時間

API time

n....n.nnn

API関数の実行時間

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。

すべて

TRB4

TRB4

n....n

TP1/EEで使用するトラブルシュート情報

すべて

TRB5

TRB5

n....n.nnn

TP1/EEで使用するトラブルシュート情報

すべて

DBキュー名

DB queue name

n....n

DBキュー名（27文字以内）※6

すべて

ロット名

Lot name

n....n

ロット名（23文字以内）※6

すべて

DBキュー通番

DB queue num

n....n

DBキューメッセージの読み込み通番（5けた以内の10進数）※6

すべて

DBキュー回数

DB queue count

n....n

DBキュー機能のアクセス回数（5けた以内の10進数）※6

すべて

DBキューアクセス実行時間

DB queue access time

n....n.nnn

DBキュー機能のアクセス時間※6

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。

すべて

同期点実行時間

Synchro time

n....n.nnn

同期点実行時間※7

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。

すべて

ディスクリプタ不足

Descriptor shortage

n....n

ディスクリプタ不足によるコネクション確立失敗回数※7

すべて

EAGAIN

EAGAIN

n....n

送信時のEAGAIN発生回数※7

すべて

CL通番

CL number

0xnnnnnnnnnnnnnnnn

CLサーバでの自系のCL通番※1，※8

2，3

実行系CL通番

Online CL number

0xnnnnnnnnnnnnnnnn

CLサーバ（待機系）での，実行系のCL通番※1，※8

2，3

msgrcv回数

Msgrcv_count

n....n

ee_scd_msg_receive関数の発行回数（累計）※1，※8

2，3

排他API要求回数

Ex-API req count

n....n

排他APIの要求回数（累計）※8

2，3

排他API保持時間

Ex-API remain time

n....n

排他APIの保持時間（累計）※8

2，3

排他API待ち時間

Ex-API wait time

n....n.nnn

排他APIの待ち時間（累計）※8

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。

2，3

排他API待ち行列数

Ex-API wait que cnt

n....n

排他API待ち行列数の最大※8

2，3

排他API待ちタイムアウト回数

Ex-API wait timeout cnt

n....n

排他API待ちタイムアウト回数（累計）※8

2，3

MCP論理端末名

MCP term name

n....n

MCPメッセージのトランザクションの場合の，メッセージを受信したMCPの論理端末名※2，※8

2，3

コネクションID

Connection ID

n....n

MCPメッセージのトランザクションの場合の，メッセージを受信したMCPのコネクションID名（トランザクション起動時）※2，※8

2，3

UOC実行時間

UOC time

n....n

UOC実行時間（累計）※2，※8

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。

2，3

XDB_SQL実行時間

XDB_SQL time

n....n.nnn

XDBのSQL実行時間※3，※8

2

XDB_処理行数

XDB_search line

n....n

XDBの処理行数※3，※8

2

XDB_更新行数

XDB_updated line

n....n

XDBの更新行数※3，※8

2

XDB_参照系SQL実行回数

XDB_refer SQL count

n....n

XDBの参照系SQL実行回数※3，※8

2

XDB_更新系SQL実行回数

XDB_update SQL count

n....n

XDBの更新系SQL実行回数※3，※8

2

作業表作成回数

W-table c-cnt

n....n

XDBの作業表作成回数※3，※8

2

作業表削除回数

W-table d-cnt

n....n

XDBの作業表削除回数※3，※8

2

作業表確保最大ページ数

W-table max page count

n....n

XDBの作業表確保最大ページ数※3，※8

2

ページ要求回数

Page req count

n....n

XDBのページ要求回数※3，※8

2

XDB_COMMIT処理時間

XDB_COMMIT time

n....n

XDB部分のコミット処理時間※3，※8

2

XDB_COMMIT排他待ち時間

XDB_COMMIT lock wait time

n....n

XDB部分のコミット排他待ち時間※3，※8

2

更新バッファ長

Update b-len

n....n

更新バッファの長さ※3，※8

2

XDB_状態

XDB_status

0xnnnnnnnn

XDBの状態※3，※8

2

XDB_スレッド領域追加確保回数

XDB_thread area count

n....n

トランザクションの処理中にXDBスレッド領域が追加確保された回数※3，※8

2

XDB_スレッド領域最大使用サイズ

XDB_thread area max size

n....n

トランザクションの処理中に実際に使用されたXDBスレッド領域の最大サイズ※3，※8

2

受信ID

Receiving ID

0xnnnnnnnn

回線トレースと結び付ける受信ID（8けたの16進数）

すべて

UAP履歴情報数

UAP log information count

n....n

UAP履歴情報の取得回数（10けた以内の10進数）※4

1回のAPIで複数のUAP履歴情報の取得を要求した場合は，UAP履歴情報の数でカウントします。また，OJなど製品が取得するUAP履歴情報の取得回数を含みます。

3

UAP履歴情報サイズ

UAP log information total size

n....n

UAP履歴情報の取得サイズの合計（10けた以内の10進数）※4

履歴情報共通インデクスのサイズも含みます。

3

UAP履歴情報書き込み時間

UAP log information write time

n....n.nnn

UAP履歴情報の書き込みに掛かった時間の合計※4

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。

UAP履歴情報の通番割り当てに掛かった時間を含みます。

3

UAP履歴情報通番割り当て時間

UAP log information assign time

n....n.nnn

UAP履歴情報の通番割り当てに掛かった時間の合計※4

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。

3

トランザクションレベル名

Transaction level name

n....n

トランザクションレベル名（31文字以内の文字列）※4，※9

3

トランレベルpce数

Tran-level Resident pce

n....n

処理キューから引き出した時点の該当トランザクションレベル名の処理キューに登録されている，PCE数（10けた以内の10進数）※4，※9

3

SDH_SQL実行回数

SDH_SQL count

n....n

SDBハンドラのSQL実行回数（10けた以内の10進数）※4，※10

3

SDH_SQL実行時間

SDH_SQL execution time

n....n.nnn

SDBハンドラのSQL実行時間※4，※10

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。

3

SDH_ワークメモリ使用サイズ

SDH_Work memory used size

n....n

SDBハンドラ用ワークメモリの使用サイズ（10けた以内の10進数）※4，※10

3

SDH_状態

SDH_status

0xnnnnnnnn

SDBハンドラ状態（8けたの16進数）※4，※10

1〜2けた目

(80)₁₆…該当するトランザクションでSDBハンドラを使用

(40)₁₆…デッドロック検知，および排他待ち時間超過検知

(20)₁₆…SQLエラー発生

(10)₁₆…予備

(08)₁₆…ee_trn_retry_rollback関数発行

(04)₁₆…ee_trn_rollback_mark関数発行

(02)₁₆〜(01)₁₆…予備

3〜4けた目…予備

5〜6けた目

(80)₁₆…イニシャライズAPI発行

(40)₁₆…個別開始API発行

(20)₁₆…個別終了API発行

(10)₁₆…システム構成表示（キーの容量）API発行

(08)₁₆〜(01)₁₆…予備

7〜8けた目

(80)₁₆〜(20)₁₆…予備

(10)₁₆…一括削除API発行

(08)₁₆…SDBアクセス（検索）API発行

(04)₁₆…SDBアクセス（格納）API発行

(02)₁₆…SDBアクセス（変更）API発行

(01)₁₆…SDBアクセス（削除）API発行

3

業務ID

Biz ID

XXXX(nn....nn)

業務ID

XXXXには，業務IDの先頭4バイトを文字列で出力します。表示不能な文字は'.'で出力します。

nn....nnには，業務IDを16進数で出力します(XXXXで出力する，業務IDの先頭4バイトを含む）。※4

3

業務ID属性

Biz ID Type

n....n

業務IDの属性

START：TP1/FSPが新規に業務IDを割り当てた

CONTINUE：TP1/FSPが既存の業務IDを引き継いだ

CONTINUE_USER：ユーザ指示によって業務IDを引き継いだ※4

3

業務IDネスト数

Biz ID Nest

n....n

業務IDのネスト数※4

3

業務ID送信元ノード識別子

Biz ID node ID

XXXX(nn....nn)

業務IDの送信元TP1/EEのノード識別子

XXXXには，表示不能な文字は'.'で出力する。

次のどれかの場合は，"****(2a2a2a2a)"と出力する。

TP1/FSPが新規に業務IDを割り当てた

TP1/FSPが業務IDをプロセス内連携で引き継いだ場合で，引き継ぎ元のトランザクションで新規に業務IDを割り当てていた

ユーザ指示によって業務IDを引き継いだ場合は，ユーザが指示した値が出力します。※4

3

OBM_UOC実行時間

OBM_UOC time

n....n.nnn

OBMのUOC実行時間「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。※4

3

OBM名／ロット名

OBM/Lot name

n....n

トランザクションに対応するOBM名かロット名

ロットの階層が1階層の場合は，OBM名を出力します。

ロットの階層が2階層以上の場合は，OBM名の後に'-'で区切って2階層目以降のロット名を上位階層から順に出力します。※4

3

スレッドID

Thread ID

n....n

スレッドID

Linuxの場合だけ

すべて

OBM管理表_SQL実行回数

OBM_table_SQL count

n....n

OBM管理表へのSQL実行回数※4

3

OBM管理表_SQL実行時間

OBM_table_SQL exec time

n....n.nnn

OBM管理表へのSQL実行時間「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。※4

3

バッチデータ表_SQL実行回数

Batch_data_table_SQL count

n....n

バッチデータ表へのSQL実行回数※4

3

バッチデータ表_SQL実行時間

Batch_data_table_SQL exec time

n....n.nnn

バッチデータ表へのSQL実行時間「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。※4

3

BCMデータ待ち時間

BCM Data wait time

n....n.nnn

BCSへデータ送信できない時間「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。※4

3

BCSデータ待ち時間

BCS Data wait time

n....n.nnn

BCSが次のデータを待っている時間「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。※4

3

UAP履歴情報_状態

UAP log status

0xnnnn

UAP履歴情報の状態

1〜2けた目

(80)₁₆：処理スレッドの通番予約有無

UAP履歴情報メモリ通番機能使用時の場合だけセットされる可能性がある

(40)₁₆：スワップ有無

(20)₁₆：UAP履歴情報の途中書き込み有

(10)₁₆：予備

(08)₁₆：OJ取得要求失敗あり(RPC/RAP)

(04)₁₆：OJ取得要求失敗あり(MCP)

(02)〜(01)₁₆：予備

3〜4けた目：予備※4

3

FSP_状態

FSP_Status

0xnnnn

FSPの状態

1〜2けた目：(全銀RC)

(80)₁₆：送達管理電文 NAK送信要求あり

(40)₁₆：OJ出力有無を示すコード。※11

　0x00：OJ出力なし※12

　0x01：OJ出力あり

(20)₁₆：リトライロールバック要求あり※13

(10)₁₆：リトライロールバック要求が上限に達した※14

またはリトライロールバック前処理UOCのリターン値がEETRN_UOC_NORETRY_KILLかEETRN_UOC_NORETRY_ABORT

(08)₁₆：DBキューの交替用メッセージ表書き込み機能でリトライ実施

(04)〜(01)₁₆：予備

3〜4けた目

(80)〜(01)₁₆：予備※4

3

論理パス名

Logical Path Name

n....n

全銀RCプロトコル接続機能の情報メッセージ，送達管理メッセージのトランザクションの場合の，メッセージを受信した論理パス名

3

ユーザ情報

User Infomation

n....n

ee_trb_uinfo_tm()で登録したユーザ情報

63文字の文字列または126けたの16進数

すべて

0xnn....nn

TASKTM出力再開始時刻

TASKTM output restart time

yyyy/mm/dd hh:mm:ss nnn.nnn

TASKTM情報の出力を再開した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。XA関数呼び出し前のときに表示します。

すべて

TASKTM情報破棄数

TASKTM information destruction count

n....n

すべての出力バッファを使用している間にTASKTM情報の出力要求が発生したため，破棄したレコード数

すべて

注※1

XTCを使用する場合にだけ表示します。

注※2

MCPを使用する場合にだけ表示します。

注※3

XDBを使用する場合にだけ表示します。

注※4

TP1/FSPを使用する場合にだけ表示します。

注※5

HiRDBの情報を最大8個表示します。リソースマネジャに対してアクセスした順番に8個のHiRDBの情報を表示します。アクセスしたHiRDBが9個以上になっても8個の情報だけ表示します。

この情報は，HiRDBのSQLを発行した場合に表示します。HiRDB以外のSQLを発行した場合，またはSQLを発行していない場合は，数値には「0」を，文字には「*」を表示します。

注※6

DBキューサービスの場合で，-eオプションにrbを指定したときだけ表示します。

注※7

ファイルを作成したTP1/EEのバージョンが01-02以降のときに表示します。

注※8

トラブルシュート関連定義のtrb_tasktm_typeオペランドに2を指定した場合にだけ表示します。

注※9

トランザクションレベル方式の処理キューを使用する場合にだけ表示します。

注※10

SDBハンドラを使用する場合にだけ表示します。

注※11

RPC/RAPの応答電文の送信時にOJを出力した場合に表示します。取得対象のトランザクションはMN，E3，ERです。

注※12

「OJ出力なし」とは，次のどちらかを意味します。

・OJ出力なし。

・OJ出力あり（ヘッダ出力，ユーザデータ出力なし）。

なお，次のどちらかに該当する場合，「OJ出力あり（ヘッダ出力，ユーザデータ出力なし）」となります。

・機能拡張オペランドで「00000001」（ユーザデータ取得なし）を指定している。

・OJ編集UOCで編集後のユーザデータサイズが0である。

注※13

リトライ回数に関係なく設定します。

注※14

リトライ回数超過（API発行時点で，定義数分リトライ済）時に設定します。

●-sオプションを指定した場合

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

出力形式中の，右端の数字の意味を次に示します。

1，2および3：改行を含まないで1行で表示します。

3：サービス数分表示します。

4：出力範囲の編集対象時間の全TASKTM情報を出力するまで繰り返します。出力するTASKTM情報がない場合，日本語では「***** 該当データなし *****」を，英語では「***** No corresponding data *****」を出力します。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa-aa-aa

eetrbtaskedコマンドを実行したTP1/EEのバージョン

bb....bb

eetrbtaskedコマンドの引数

cc....cc

入力ファイル名

dddd/dd/dd dd:dd:dd ddd.ddd

TASKTM情報のファイル出力を開始した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

e1-e1-e1

ファイルを作成したTP1/EEのバージョン

e2-e2-e2

ファイルを作成したXTCのバージョン※1

e3-e3-e3

ファイルを作成したMCPのバージョン※2

e4-e4-e4

ファイルを作成したXDBのバージョン※3

e5-e5-e5

ファイルを作成したTP1/FSPのバージョン※4

T1

TASKTM情報取得タイプ

ff....ff

サービスグループ名（31文字以内）

gggggggg

TP1/EEのランID（8けたの16進数）

hhhh/hh/hh hh:hh:hh

編集対象時間帯の開始日時

「年/月/日△時:分:秒」の形式で出力します。

iiii/ii/ii ii:ii:ii

編集対象時間帯の終了日時

「年/月/日△時:分:秒」の形式で出力します。

jj....jj

サービス名（31文字以内）

サービス名がないトランザクションは，トランザクション種別，処理キューリクエストコードのコード1，およびコード2を表示します（例：初期化トランザクションの場合「MI（09 00）」）

kk....kk

トランザクションの起動件数

ll....ll

ブランチ本体がコミットに決着した件数

mm....mm

ブランチ本体がロールバックに決着した件数

nn....nn

トランザクションが決着しなかったため，監視依頼した回数

oo....oo

子トランザクションブランチを含んでコミットに決着した件数

pp....pp

子トランザクションブランチを含んでロールバックに決着した件数

qq....qq

ヒューリスティックコミット（eetrncmtコマンド），またはリソースマネジャ独自のコミットに決着した件数（子トランザクションブランチを含む）

rr....rr

ヒューリスティックロールバック（eetrnrbkコマンド），またはリソースマネジャ独自のロールバックに決着した件数（子トランザクションブランチを含む）

ss....ss

ヒューリスティックハザードが発生し，コマンドまたはリソースマネジャ独自に決着した件数（子トランザクションブランチを含む）

tt....tt

ヒューリスティックミックスが発生し，コマンドまたはリソースマネジャ独自に決着した件数（子トランザクションブランチを含む）

uu....uu

処理スレッドで決着したトランザクションの件数

vv....vv

回復スレッドで決着したトランザクションの件数

XX....XX

次に示す各項目を表示します。

PCE時間：処理キューからのサービス引き出し待ち時間

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。

トランザクション時間：トランザクション実行時間

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。

UAP時間：UAP実行時間

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。

SQL回数：トランザクション内で発行したSQLの合計発行回数（10けた以内の10進数）

SQL実行時間：トランザクション内で発行したSQLの合計実行時間

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。

滞留PCE数：滞留している処理キュー数（10けた以内の10進数）

TRB2：TP1/EEで使用するトラブルシュート情報

TRB3：TP1/EEで使用するトラブルシュート情報

API回数：API関数の呼び出し回数（5けた以内の10進数）

API実行時間：API関数の実行時間

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。

TRB4：TP1/EEで使用するトラブルシュート情報

TRB5：TP1/EEで使用するトラブルシュート情報

DBキュー回数：DBキュー機能のアクセス回数（5けた以内の10進数）

DBキューアクセス実行時間：DBキュー機能のアクセス時間

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。

同期点実行時間

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。

ディスクリプタ不足：ディスクリプタ不足によるコネクション確立失敗回数

EAGAIN：送信時のEAGAIN発生回数

msgrcv回数：ee_scd_msg_receive関数の発行回数（累計）※1

排他API要求回数：排他APIの要求回数（累計）

排他API保持時間：排他APIの保持時間（累計）

排他API待ち時間：排他APIの待ち時間（累計）

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。

排他API待ち行列数：排他API待ち行列数の最大

排他API待ちタイムアウト回数：排他API待ちタイムアウト回数（累計）

UOC実行時間：UOC実行時間（累計）※2

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。

XDB_SQL実行時間：XDBのSQL実行時間※3

XDB_処理行数：XDBの処理行数※3

XDB_更新行数：XDBの更新行数※3

XDB_参照系SQL実行回数：XDBの参照系SQL実行回数※3

XDB_更新系SQL実行回数：XDBの更新系SQL実行回数※3

作業票作成回数：XDBの作業表作成回数※3

作業票削除回数：XDBの作業表削除回数※3

作業票確保最大ページ数：XDBの作業表確保最大ページ数※3

ページ要求回数：XDBのページ要求回数※3

XDB_COMMIT処理時間：XDB部分のコミット処理時間※3

XDB_COMMIT排他待ち時間：XDB部分のコミット排他待ち時間※3

更新バッファ長：更新バッファの長さ※3

XDB_スレッド領域追加確保回数：トランザクションの処理中にXDBスレッド領域が追加確保された回数※3

XDB_スレッド領域最大使用サイズ：トランザクションの処理中に実際に使用されたXDBスレッド領域の最大サイズ※3

UAP履歴情報数：UAP履歴情報の取得回数※4

UAP履歴情報サイズ：UAP履歴情報の取得サイズの合計（履歴情報共通インデクスのサイズも含む）※4

UAP履歴情報書き込み時間：UAP履歴情報の書き込みに掛かった時間の合計※4

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。

UAP履歴情報バッファ使用数：UAP履歴情報用のバッファの使用数※4

SDH_SQL実行回数：SDBハンドラのSQL実行回数※4

SDH_SQL実行時間：SDBハンドラのSQL実行時間※4

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。

SDH_ワークメモリ使用サイズ：SDBハンドラ用ワークメモリの使用サイズ※4

OBM_UOC実行時間：OBMのUOC実行時間※4

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。

OBM管理表_SQL実行回数：OBM管理表へのSQL実行回数※4

OBM管理表_SQL実行時間：OBM管理表へのSQL実行時間※4

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。

バッチデータ表_SQL実行回数：バッチデータ表へのSQL実行回数※4

バッチデータ表_SQL実行時間：バッチデータ表へのSQL実行時間※4

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。

BCMデータ待ち時間：BCSへデータ送信できない時間※4

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。

BCSデータ待ち時間：BCSが次のデータを待っている時間※4

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。

xx....xx

XX....XXに示した各項目の平均値，最大値，および最小値

平均値は，小数点以下を切り捨てます。「ミリ秒.マイクロ秒」で表示する項目は，マイクロ秒の小数点以下を切り捨てます。オーバフローした場合は，「*」を表示します。

ww....ww

すべての出力バッファを使用している間にTASKTM情報の出力要求が発生したため，破棄したレコード数

破棄したレコードがない場合は出力しません。

注※1

XTCを使用する場合にだけ表示します。

注※2

MCPを使用する場合にだけ表示します。

注※3

XDBを使用する場合にだけ表示します。

注※4

TP1/FSPを使用する場合にだけ表示します。

●-eオプションにfを指定した場合

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

出力形式中の，右端の数字の意味を次に示します。

1：指定したファイル数分表示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa-aa-aa

eetrbtaskedコマンドを実行したTP1/EEのバージョン

bb....bb

eetrbtaskedコマンドの引数

cc....cc

入力ファイル名

dddd/dd/dd dd:dd:dd ddd.ddd

TASKTM情報のファイル出力を開始した日時

「年/月/日△時:分:秒.マイクロ秒」の形式で出力します。

e1-e1-e1

ファイルを作成したTP1/EEのバージョン

e2-e2-e2

ファイルを作成したXTCのバージョン※

e3-e3-e3

ファイルを作成したMCPのバージョン※

e4-e4-e4

ファイルを作成したXDBのバージョン※

e5-e5-e5

ファイルを作成したTP1/FSPのバージョン※

T1

TASKTM情報取得タイプ

ff....ff

サービスグループ名（31文字以内）

gggggggg

TP1/EEのランID（8けたの16進数）

注※

それぞれのプログラムプロダクトを使用する場合にだけ表示します。

指定したファイルがTASKTMファイルではない場合，日本語では「ＴＡＳＫＴＭファイルではありません。」を，英語では「This is not a TASKTM file.」を表示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

xxxx/xx/xx xx:xx:xx xxx.xxx

出力したTASKTM情報の中でいちばん古い起動時刻

出力対象のTASKTM情報がない場合は「****/**/** **:**:** ***.***」を出力します。

yyyy/yy/yy yy:yy:yy yyy.yyy

出力したTASKTM情報の中でいちばん新しい起動時刻

出力対象のTASKTM情報がない場合は「****/**/** **:**:** ***.***」を出力します。

nnnnnnnn

出力したTASKTM情報の中でいちばん値の小さい中央処理通番

16進数8けた出力対象のTASKTM情報がない場合は「********」を出力します。

mmmmmmmm

出力したTASKTM情報の中でいちばん値の大きい中央処理通番

16進数8けた出力対象のTASKTM情報がない場合は「********」を出力します。

zzz

-cオプションに指定した出力ファイル名

出力メッセージ

メッセージID

内容

出力先

KFSB95400-E

メモリを確保できません。

標準エラー出力

KFSB95401-E

コマンドの形式が不正です。

標準エラー出力

KFSB95402-E

コマンドのオプションが不正です。

標準エラー出力

KFSB95403-E

コマンドのオプションの組み合わせが不正です。

標準エラー出力

KFSB95405-E

ファイルのヘッダ情報が不正です。

標準エラー出力

KFSB95406-E

データブロックが不正です。

標準エラー出力

KFSB95409-E

バージョンが不一致です。

標準エラー出力

KFSB95410-E

ファイルのオープン処理で障害が発生しました。

標準エラー出力

KFSB95411-E

ファイルからの読み出し処理で障害が発生しました。

標準エラー出力

KFSB95412-E

ファイルへの書き込み処理で障害が発生しました。

標準エラー出力

KFSB95413-E

ファイルのクローズ処理で障害が発生しました。

標準エラー出力

KFSB95415-Q

-cオプションに指定したファイルはすでに存在します。

標準出力

KFSB95430-I

ヘルプメッセージ

標準出力

KFSB95457-Q

上書き確認（-nオプション指定時）

標準出力

注意事項

-eオプションにrを指定した場合，編集対象のレコードがないときは，-eオプションにfを指定した場合と同様に，TASKTM情報を表示します。

TASKTM情報に欠落があった場合，欠落したレコード数を表示します。欠落したレコード数が4294967295以上の場合，「4294967295」と表示します。

TASKTM情報取得時の障害発生などで情報を取得できない場合は，取得できなかった情報の値に「0」が表示されます。

HiRDB（リソースマネジャ）の情報は，最大8個表示します。HiRDBに対してアクセスした順番に8個のHiRDBの情報を表示します。アクセスしたHiRDBが9個以上になっても8個の情報だけ表示します。

-cオプションを指定してCSVファイルに出力する場合，ファイル作成バージョンは，日本語では「ファイル作成バージョン：ee-ee-ee」の形式で，英語では「File creation version: ee-ee-ee」の形式で表示されます。

eetrbtaskfput

名称

TASKTM情報の強制出力

形式

eetrbtaskfput -g サービスグループ名

機能

TASKTMバッファにスタックしているTASKTM情報をファイルに強制的に出力し，ファイルを切り替えます。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

TP1/EEプロセスのサービスグループ名を指定します。

出力メッセージ

メッセージID

内容

出力先

KFSB95400-E

メモリを確保できません。

標準エラー出力

KFSB95401-E

コマンドの形式が不正です。

標準エラー出力

KFSB95402-E

コマンドのオプションが不正です。

標準エラー出力

KFSB95425-I

強制出力コマンドが成功しました。

標準出力

KFSB95426-E

強制出力コマンドが失敗しました。

標準エラー出力

KFSB95427-E

強制出力コマンドが失敗しました。

標準エラー出力

KFSB95434-I

ヘルプメッセージ

標準出力

eetrbtbldump

名称

テーブル情報の出力

形式

eetrbtbldump -t テーブル名〔,通番〕 〔-b サイズ〕 ファイル名

機能

コアファイルまたはメモリダンプファイルからテーブル情報を編集し，標準出力に出力します。

オプション

●-t　テーブル名〔,通番〕

テーブル名と通番を指定します。指定例を次に示します。

uia,xxxxx

xxxxx：5けた以内の10進数

テーブル名の大文字／小文字は区別しません。

指定したテーブルのサイズが4ギガバイトを超える場合，オフセット表示が初期化されることがあります。また，指定したテーブル名と同一の文字列がコアファイルまたはメモリダンプファイルに含まれる場合，正しく表示されないことがあります。

指定するテーブル名によって，通番を指定するかどうかが異なります。-tオプションに指定できるテーブル名と通番指定の有無を次の表に示します。

表10‒5　テーブル名一覧

テーブル名

テーブルの種類

通番指定の有無

uia

スレッド対応インタフェースユーザワークエリアサイズ（ユーザIFA）

○

ust

プロセス管理テーブルユーザワークエリアサイズ（ユーザSAT）

×

（凡例）

○：通番を指定してください。

×：通番を指定する必要はありません。

●-b　サイズ　　〜〈符号なし整数〉((16〜10000))（単位：バイト）

指定したサイズを編集，出力します。

-bオプションを指定しない場合，-tオプションで指定したテーブル全体を編集，出力します。

●ファイル名　　〜〈パス名〉

入力元のコアファイルまたはメモリダンプファイル名を指定します。

出力形式

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa-aa-aa

eetrbtbldumpコマンドを実行したTP1/EEのバージョン

bb....bb

eetrbtbldumpコマンドの引数

cc....cc

入力ファイル名

y

テーブル情報

1行前に出力した行と同一の場合，「TO NEXT LINE LOCATION SAME AS ABOVE」を表示します。複数行で同一の場合は，「TO NEXT LINE LOCATION SAME AS ABOVE」を一度だけ表示します。最後の2行が同一の場合は，「TO NEXT LINE LOCATION SAME AS ABOVE」を表示しません。

出力メッセージ

メッセージID

内容

出力先

KFSB95400-E

メモリを確保できません。

標準エラー出力

KFSB95401-E

コマンドの形式が不正です。

標準エラー出力

KFSB95402-E

コマンドのオプションが不正です。

標準エラー出力

KFSB95410-E

ファイルのオープン処理で障害が発生しました。

標準エラー出力

KFSB95411-E

ファイルからの読み出し処理で障害が発生しました。

標準エラー出力

KFSB95413-E

ファイルのクローズ処理で障害が発生しました。

標準エラー出力

KFSB95414-E

ファイルポインタの移動処理で障害が発生しました。

標準エラー出力

KFSB95416-E

指定したファイルに編集するデータがありません。

標準エラー出力

KFSB95417-E

データの編集途中でファイルの終わりに達しました。

標準エラー出力

KFSB95433-I

ヘルプメッセージ

標準出力

eetrbtrcefput

名称

回線トレース情報の強制出力

形式

eetrbtrcefput -g サービスグループ名

機能

回線トレースバッファにスタックしている回線トレース情報をファイルに強制的に出力し，ファイルを切り替えます。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

TP1/EEプロセスのサービスグループ名を指定します。

出力メッセージ

メッセージID

内容

出力先

KFSB95400-E

メモリを確保できません。

標準エラー出力

KFSB95401-E

コマンドの形式が不正です。

標準エラー出力

KFSB95402-E

コマンドのオプションが不正です。

標準エラー出力

KFSB95425-I

強制出力コマンドが成功しました。

標準出力

KFSB95426-E

強制出力コマンドが失敗しました。

標準エラー出力

KFSB95427-E

強制出力コマンドが失敗しました。

標準エラー出力

KFSB95435-I

ヘルプメッセージ

標準出力

eetrbuapdump

名称

UAPトレース情報の編集出力（コアファイルまたはメモリダンプファイル入力）

形式

eetrbuapdump 〔-e ｛sum｜ifa,IFA番号｜rec｝〕 ファイル名

機能

コアファイルまたはメモリダンプファイルからUAPトレース情報を編集し，標準出力に出力します。

オプション

●-e　｛sum｜ifa, IFA番号｜rec｝　　〜《sum》

出力するUAPトレース情報を指定します。

sum

ファイルに存在するUAPトレース情報の一覧を表示します。

ifa, IFA番号　　〜〈符号なし整数〉((1〜65535))

指定されたIFA番号を持つUAPトレース情報だけ出力します。

rec

ファイルに出力されていないすべてのUAPトレース情報レコードを編集します。

recを指定できるのは，プロセス関連定義のtrb_uap_trace_file_outオペランドを指定した環境下で作成されたコアファイルまたはメモリダンプファイルを入力情報としたときだけです。

●ファイル名　　〜〈パス名〉

入力元のコアファイルまたはメモリダンプファイル名を指定します。

出力形式

●-eオプションにsumを指定した場合

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa-aa-aa

eetrbuapdumpコマンドを実行したTP1/EEのバージョン

bb....bb

eetrbuapdumpコマンドの引数

cc....cc

入力ファイル名

d1-d1-d1

ファイルを作成したTP1/EEのバージョン

d2-d2-d2

ファイルを作成したXTCのバージョン※

d3-d3-d3

ファイルを作成したMCPのバージョン※

d4-d4-d4

ファイルを作成したXDBのバージョン※

d5-d5-d5

ファイルを作成したTP1/FSPのバージョン※

ee....ee

サービスグループ名（31文字以内）

ffffffff

TP1/EEのランID（8けた以内の16進数）

gg....gg

IFA番号（5けた以内の10進数）

hhhh/hh/hh hh:hh:hh

UAPトレース情報の取得日時

「年/月/日△時:分:秒」の形式で出力します。

ii....ii

トレース取得通番（10けた以内の10進数）

jj....jj

サービス名（31文字以内）

注※

それぞれのプログラムプロダクトを使用する場合にだけ表示します。

●-eオプションにifaを指定した場合

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

注※

出力する内容は，発行したTP1/EEのライブラリ関数によって異なります。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa-aa-aa

eetrbuapdumpコマンドを実行したTP1/EEのバージョン

bb....bb

eetrbuapdumpコマンドの引数

cc....cc

入力ファイル名

d1-d1-d1

ファイルを作成したTP1/EEのバージョン

d2-d2-d2

ファイルを作成したXTCのバージョン※

d3-d3-d3

ファイルを作成したMCPのバージョン※

d4-d4-d4

ファイルを作成したXDBのバージョン※

d5-d5-d5

ファイルを作成したTP1/FSPのバージョン※

ee....ee

サービスグループ名（31文字以内）

ffffffff

TP1/EEのランID（8けたの16進数）

gg....gg

呼び出した関数名（COBOL言語）

hh....hh

呼び出した関数名（C言語）

ii

入口または出口のコール種別

jjjj/jj/jj jj:jj:jj jjj.jjj

UAPトレース情報の取得開始日時と取得終了日時

「年/月/日△時:分:秒 ミリ秒.マイクロ秒」の形式で出力します。サービス関数の場合は，取得日時だけを表示します。サービス関数以外の場合は，取得開始日時と取得終了日時の2種類を表示します。

kk....kk

トレース取得通番

j1....j1.j1....j1

APIの実行時間。ミリ秒.マイクロ秒で表示します。

ll....ll

サービス名（31文字以内）

mm....mm，nn....nn，oo，pp，およびy

TP1/EEの関数の情報

出力する内容は，呼び出したTP1/EEの関数によって異なります。

1行前に出力した行と同一の場合，「TO NEXT LINE LOCATION SAME AS ABOVE」を表示します。複数行で同一の場合は，「TO NEXT LINE LOCATION SAME AS ABOVE」を一度だけ表示します。最後の2行が同一の場合は，「TO NEXT LINE LOCATION SAME AS ABOVE」を表示しません。

qq....qq

オプション（COBOL言語）

呼び出したライブラリ関数のデータ領域にオプションがある場合だけ表示します。

rr....rr

オプション（C言語）

呼び出した関数の引数にオプションがある場合だけ表示します。不正なコードの場合は，「????」を表示します。

ss....ss

リターンコード（COBOL言語）

サービス関数を呼び出したときは，表示しません。

tt....tt

リターンコード（C言語）

サービス関数を呼び出したときは，表示しません。

COBOL言語特有のリターンコードの場合は，「NOTHING」を表示します。また，不正なコードの場合は，「????」を表示します。

注※

それぞれのプログラムプロダクトを使用する場合にだけ表示します。

●-eオプションにrecを指定した場合

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

注※

出力する内容は，発行したTP1/EEのライブラリ関数によって異なります。

出力形式中の，右端の数字の意味を次に示します。

1：改行を含まないで1行で表示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa-aa-aa

eetrbuapdumpコマンドを実行したTP1/EEのバージョン

bb....bb

eetrbuapdumpコマンドの引数

cc....cc

入力ファイル名

d1-d1-d1

ファイルを作成したTP1/EEのバージョン

d2-d2-d2

ファイルを作成したXTCのバージョン※

d3-d3-d3

ファイルを作成したMCPのバージョン※

d4-d4-d4

ファイルを作成したXDBのバージョン※

d5-d5-d5

ファイルを作成したTP1/FSPのバージョン※

ee....ee

サービスグループ名（31文字以内）

ffffffff

TP1/EEのランID（8けたの16進数）

gg....gg

呼び出した関数名（COBOL言語）

hh....hh

呼び出した関数名（C言語）

ii

入口または出口のコール種別

jjjj/jj/jj jj:jj:jj jjj.jjj

UAPトレース情報の取得開始日時と取得終了日時

「年/月/日△時:分:秒 ミリ秒.マイクロ秒」の形式で出力します。サービス関数の場合は，取得日時だけを表示します。サービス関数以外の場合は，取得開始日時と取得終了日時の2種類を表示します。

j1....j1.j1....j1

APIの実行時間。ミリ秒.マイクロ秒で表示します。

kkkkkkkk

カレント中央処理通番（8けたの16進数）

uu....uu

トレース取得通番

ll....ll

サービス名（31文字以内）

mm....mm，nn....nn，oo，pp，およびy

TP1/EEの関数の情報

出力する内容は，呼び出したTP1/EEの関数によって異なります。

1行前に出力した行と同一の場合，「TO NEXT LINE LOCATION SAME AS ABOVE」を表示します。複数行で同一の場合は，「TO NEXT LINE LOCATION SAME AS ABOVE」を一度だけ表示します。最後の2行が同一の場合は，「TO NEXT LINE LOCATION SAME AS ABOVE」を表示しません。

qq....qq

オプション（COBOL言語）

呼び出したライブラリ関数のデータ領域にオプションがある場合だけ表示します。

rr....rr

オプション（C言語）

呼び出した関数の引数にオプションがある場合だけ表示します。不正なコードの場合は，「????」を表示します。

ss....ss

リターンコード（COBOL言語）

サービス関数を呼び出したときは，表示しません。

tt....tt

リターンコード（C言語）

サービス関数を呼び出したときは，表示しません。

COBOL言語特有のリターンコードの場合は，「NOTHING」を表示します。また，不正なコードの場合は，「????」を表示します。

注※

それぞれのプログラムプロダクトを使用する場合にだけ表示します。

出力メッセージ

メッセージID

内容

出力先

KFSB95400-E

メモリを確保できません。

標準エラー出力

KFSB95401-E

コマンドの形式が不正です。

標準エラー出力

KFSB95402-E

コマンドのオプションが不正です。

標準エラー出力

KFSB95410-E

ファイルのオープン処理で障害が発生しました。

標準エラー出力

KFSB95411-E

ファイルからの読み出し処理で障害が発生しました。

標準エラー出力

KFSB95413-E

ファイルのクローズ処理で障害が発生しました。

標準エラー出力

KFSB95414-E

ファイルポインタの移動処理で障害が発生しました。

標準エラー出力

KFSB95416-E

指定したファイルに編集するデータがありません。

標準エラー出力

KFSB95417-E

データの編集途中でファイルの終わりに達しました。

標準エラー出力

KFSB95432-I

ヘルプメッセージ

標準出力

注意事項

サービス関数の開始時のトランザクション情報には，情報長，サービスグループ名長，サービスグループ名，サービス名長，サービス名を表示しません。

入力および出力メッセージ長が60バイトを超える場合は，60バイトまで表示します。60バイト未満の場合は，メッセージ長で表示します。メッセージ長の表示は，実際に送受信したメッセージ長を表示します。

-eオプションにrecを指定した場合，表示するUAPトレース情報が重複することがあります。重複しているかどうかは，UAPトレース情報の中央処理通番とトレース取得通番によって判断してください。

eetrbuated

名称

UAPトレース情報の編集出力

形式

eetrbuated 〔-e 編集種別 〕〔-t 〔開始時刻〕〔,終了時刻〕〕
           〔-r ランID〕 〔-x 中央処理通番の下限値,中央処理通番の上限値〕
           〔-v サービス名〔,サービス名…〕〕
           UAPトレースファイル名 〔UAPトレースファイル名…〕

機能

UAPトレース情報を編集し，標準出力に出力します。

オプション

●-e　編集種別　　〜《f》

編集種別を指定します。

r

UAPトレース情報をレコード単位で編集，出力します。

f

ファイル情報一覧を出力します。

-eオプションにfを指定した場合，その他のオプションを指定するとエラーになります。

●-t　開始時刻,終了時刻

指定された時刻内に，出力バッファに出力されたUAPトレース情報を編集，出力します。

開始時刻，および終了時刻は，1970年1月1日0時0分0秒から当年当月当日の現在時刻までの範囲で指定します。

開始時刻または終了時刻のどちらか一方を必ず指定してください。開始時刻の指定を省略すると，UAPトレースファイルの先頭から指定した終了時刻までが出力範囲になります。終了時刻の指定を省略すると，指定した開始時刻からUAPトレースファイルの最後までが出力範囲になります。

開始時刻，および終了時刻は，「hhmmss〔MMDD〔YYYY〕〕」の形式で指定します。

hh：時（00≦hh≦23）

指定を省略できません。

mm：分（00≦mm≦59）

指定を省略できません。

ss：秒（00≦ss≦59）

指定を省略できません。

MM：月（01≦MM≦12）

指定を省略できます。※

DD：日（01≦DD≦31）

指定を省略できます。※

YYYY：年（西暦）（1970≦YYYY≦9999）

指定を省略できます。※

注※

開始時刻，または終了時刻の「年」の指定を省略した場合は，当年の指定月日時刻と見なされます。「年，月，日」の指定を省略した場合，当年当月当日の指定時刻と見なされます。「月，日」，「月」，または「日」だけを省略することはできません。省略した場合はオプションエラーになります。「月」または「日」を省略したい場合は，「年」，「月」，「日」のすべてを省略してください。

-tオプションの指定を省略すると，指定したファイル内のすべての情報を編集，出力します。

●-r　ランID　　〜〈8文字の16進数〉

指定されたランIDを持つUAPトレース情報だけ編集，出力します。

●-x　中央処理通番の下限値,中央処理通番の上限値　　〜〈1〜8文字の16進数〉((0〜ffffffff))

指定されたカレント中央処理通番の範囲内の情報だけ編集，出力します。-xオプションを指定する場合，上限値および下限値を必ず指定してください。

中央処理通番を指定するときは，最大値（4294967295）を考慮してください。ラップした場合に4294967290から3まで出力したいときは，「-x FFFFFFFA,3」と指定します。

●-v　サービス名　　〜〈1〜31文字の識別子〉

指定されたサービス名を持つ情報だけ編集，出力します。サービス名は，最大10個指定できます。

コマンド引数

●UAPトレースファイル名　　〜〈パス名〉

編集するファイル名を指定します。-eオプションにfを指定した場合は，最大1024個UAPトレースファイル名を指定できます。

指定できるオプションの組み合わせを次の表に示します。

表10‒6　eetrbuatedコマンドのオプションの組み合わせ

オプション

-e

-t

-r

-x

-v

UAPトレースファイル名

r

f

単一

複数

-e

r

−

×

○

○

○

○

○

×

f

×

−

×

×

×

×

○

○

-t

○

×

−

○

○

○

○

×

-r

○

×

○

−

○

○

○

×

-x

○

×

○

○

−

○

○

×

-v

○

×

○

○

○

−

○

×

UAPトレースファイル名

単一

○

○

○

○

○

○

−

−

複数

×

○

×

×

×

×

−

−

（凡例）

○：指定できます。

×：指定できません。

−：該当しません。

出力形式

●-eオプションにrを指定した場合

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

注※

出力する内容は，発行したTP1/EEのライブラリ関数によって異なります。

出力形式中の，右端の数字の意味を次に示します。

1：改行を含まないで1行で表示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa-aa-aa

eetrbuatedコマンドを実行したTP1/EEのバージョン

bb....bb

eetrbuatedコマンドの引数

cc....cc

入力ファイル名

dddd/dd/dd dd:dd:dd ddd.ddd

UAPトレース情報のファイル出力を開始した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

e1-e1-e1

ファイルを作成したTP1/EEのバージョン

e2-e2-e2

ファイルを作成したXTCのバージョン※

e3-e3-e3

ファイルを作成したMCPのバージョン※

e4-e4-e4

ファイルを作成したXDBのバージョン※

e5-e5-e5

ファイルを作成したTP1/FSPのバージョン※

T1

UAPトレース取得タイプ

ff....ff

サービスグループ名（31文字以内）

gggggggg

TP1/EEのランID（8けたの16進数）

zzzz/zz/zz zz:zz:zzz zzz.zzz

取得時刻

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

hh....hh

呼び出した関数名（COBOL言語）

ii....ii

呼び出した関数名（C言語）

jj

入口または出口のコール種別

kkkk/kk/kk kk:kk:kk kkk.kkk

UAPトレース情報の取得開始日時と取得終了日時

「年/月/日△時:分:秒 ミリ秒.マイクロ秒」の形式で出力します。サービス関数の場合は，取得日時だけを表示します。サービス関数以外の場合は，取得開始日時と取得終了日時の2種類を表示します。

k1....k1.k1....k1

APIの実行時間。ミリ秒.マイクロ秒で表示します。

llllllll

カレント中央処理通番（8けたの16進数）

xx....xx

トレース取得通番（スレッドごとに取得する通番）

mm....mm

サービス名（31文字以内）

nn....nn，oo....oo，pp，qq，およびy

TP1/EEの関数の情報

出力する内容は，呼び出したTP1/EEの関数によって異なります。

1行前に出力した行と同一の場合，「TO NEXT LINE LOCATION SAME AS ABOVE」を表示します。複数行で同一の場合は，「TO NEXT LINE LOCATION SAME AS ABOVE」を一度だけ表示します。最後の2行が同一の場合は，「TO NEXT LINE LOCATION SAME AS ABOVE」を表示しません。

rr....rr

オプション（COBOL言語）

呼び出したライブラリ関数のデータ領域にオプションがある場合だけ表示します。

ss....ss

オプション（C言語）

呼び出した関数の引数にオプションがある場合だけ表示します。不正なコードの場合は，「????」を表示します。

tt....tt

リターンコード（COBOL言語）

サービス関数を呼び出したときは，表示しません。

uu....uu

リターンコード（C言語）

サービス関数を呼び出したときは，表示しません。

COBOL言語特有のリターンコードの場合は，「NOTHING」を表示します。また，不正なコードの場合は，「????」を表示します。

vvvv/vv/vv vv:vv:vv vvv.vvv

UAPトレース情報の出力を再開した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

ww....ww

すべての出力バッファを使用している間にトレース情報出力要求が発生したため，破棄したレコード数

注※

それぞれのプログラムプロダクトを使用する場合にだけ表示します。

●-eオプションにfを指定した場合

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

出力形式中の，右端の数字の意味を次に示します。

1：ファイル数分出力します。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa-aa-aa

eetrbuatedコマンドを実行したTP1/EEのバージョン

bb....bb

eetrbuatedコマンドの引数

cc....cc

入力ファイル名

dddd/dd/dd dd:dd:dd ddd.ddd

UAPトレース情報のファイル出力を開始した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

e1-e1-e1

ファイルを作成したTP1/EEのバージョン

e2-e2-e2

ファイルを作成したXTCのバージョン※

e3-e3-e3

ファイルを作成したMCPのバージョン※

e4-e4-e4

ファイルを作成したXDBのバージョン※

e5-e5-e5

ファイルを作成したTP1/FSPのバージョン※

T1

UAPトレース取得タイプ

ff....ff

サービスグループ名（31文字以内）

gggggggg

TP1/EEのランID（8けたの16進数）

注※

それぞれのプログラムプロダクトを使用する場合にだけ表示します。

指定したファイルがUAPトレースファイルではない合，日本語では「ＵＡＰトレースファイルではありません。」を，英語では「This is not a UAP trace file.」を表示します。

出力メッセージ

メッセージID

内容

出力先

KFSB95400-E

メモリを確保できません。

標準エラー出力

KFSB95401-E

コマンドの形式が不正です。

標準エラー出力

KFSB95402-E

コマンドのオプションが不正です。

標準エラー出力

KFSB95403-E

コマンドのオプションの組み合わせが不正です。

標準エラー出力

KFSB95405-E

ファイルのヘッダ情報が不正です。

標準エラー出力

KFSB95406-E

データブロックが不正です。

標準エラー出力

KFSB95409-E

バージョンが不一致です。

標準エラー出力

KFSB95410-E

ファイルのオープン処理で障害が発生しました。

標準エラー出力

KFSB95411-E

ファイルからの読み出し処理で障害が発生しました。

標準エラー出力

KFSB95413-E

ファイルのクローズ処理で障害が発生しました。

標準エラー出力

KFSB95446-I

ヘルプメッセージ

標準出力

注意事項

-eオプションにrを指定した場合で，編集対象のレコードがないときは，-eオプションにfを指定した場合と同様に，UAPトレース情報を表示します。

サービス関数の開始時のトランザクション情報には，情報長，サービスグループ名長，サービスグループ名，サービス名長，サービス名を表示しません。

入力および出力メッセージ長が60バイトを超える場合は，60バイトまで表示します。60バイト未満の場合は，メッセージ長で表示します。メッセージ長の表示は，実際に送受信したメッセージ長を表示します。

eetrbuatfput

名称

UAPトレース情報の強制出力

形式

eetrbuatfput -g サービスグループ名

機能

UAPトレースバッファにスタックしているUAPトレース情報をファイルに強制的に出力し，ファイルを切り替えます。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

TP1/EEプロセスのサービスグループ名を指定します。

出力メッセージ

メッセージID

内容

出力先

KFSB95400-E

メモリを確保できません。

標準エラー出力

KFSB95401-E

コマンドの形式が不正です。

標準エラー出力

KFSB95402-E

コマンドのオプションが不正です。

標準エラー出力

KFSB95425-I

強制出力コマンドが成功しました。

標準出力

KFSB95426-E

強制出力コマンドが失敗しました。

標準エラー出力

KFSB95427-E

強制出力コマンドが失敗しました。

標準エラー出力

KFSB95445-I

ヘルプメッセージ

標準出力

eetrbwtor

名称

TP1/EEプロセスのメッセージへの応答

形式

eetrbwtor -g サービスグループ名 -n メッセージ識別子 〔処理オプション〕

機能

eetrbwtorコマンドの実行待ちメッセージを出力したTP1/EEに応答します。指定できるオプションは，TP1/EEプロセスで出力したメッセージによって異なります。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

TP1/EEプロセスのサービスグループ名を指定します。

●-n　メッセージ識別子　　〜〈符号なし整数〉((1〜4294967295))

応答するメッセージのメッセージ識別番号を指定します。

●処理オプション

応答するメッセージによって指定する処理オプションは異なります。

出力形式

応答するメッセージによって出力形式は異なります。

出力メッセージ

メッセージID

内容

出力先

KFSB95401-E

コマンドの形式が不正です。

標準エラー出力

KFSB95402-E

コマンドのオプションが不正です。

標準エラー出力

KFSB95448-I

ヘルプメッセージ

標準出力

KFSB95451-E

コマンドが失敗しました。

標準エラー出力

eetrncmt

名称

トランザクションのコミット

形式

eetrncmt -g サービスグループ名
       ｛-t 〔-f〕 ｜-T トランザクション識別子 〔-f〕｝

機能

eetrncmtコマンドは，グローバルトランザクションを構成している各トランザクションブランチが何らかの要因（通信障害など）でトランザクションを決着できないときに実行します。eetrnlstrコマンドを実行して表示された情報中のステータスがREADY（p），READY（d），またはREADY（i）状態のときに，トランザクションブランチを強制的にコミットし，ほかのトランザクションブランチに連絡完了後，トランザクションを終了します。ルートトランザクションブランチがコミットされた場合に実行してください。

eetrncmtコマンドを実行してトランザクションをコミットする場合，ほかのトランザクションとの不整合を発生させないために，グローバルトランザクション内のほかのトランザクションブランチもコミットしてください。通信障害が発生している場合，トランザクションブランチ間の連絡が完了するまでトランザクションを終了できません。このとき，-fオプションを指定すると，トランザクションを強制的に終了できます。通信障害が一時的な場合，-fオプションは指定しないでeetrncmtコマンドを実行してください。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

TP1/EEプロセスのサービスグループ名を指定します。

●-t

トランザクションのステータスがREADY（p），READY（d），またはREADY（i）状態のすべてのトランザクションのコミットを受け付けます。さらに，コミットするトランザクションに関する情報を標準出力に出力します。

●-f

トランザクションを強制終了します。

-fオプションの指定を省略すると，トランザクションは強制終了されません。

●-T　トランザクション識別子　　〜〈144文字の16進数〉

指定されたトランザクション識別子（XID）を持つトランザクションのステータスがREADY（p），READY（d），またはREADY（i）状態であれば，コミットを受け付けます。さらに，コミットするトランザクションに関する情報を標準出力に出力します。

トランザクション識別子は，eetrnlstrコマンドで知ることができます。

出力形式

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

出力形式中の，右端の数字の意味を次に示します。

1：1トランザクションの情報を，改行を含まないで1行で表示します。トランザクションが複数ある場合，トランザクション数分表示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa....aa

トランザクション識別子（16進数）

bb....bb

トランザクション記述子（10進数）

トランザクションブランチを区別するためのインデクス番号を表示します。

cc....cc

トランザクション第1状態（20文字以内）

トランザクションブランチの処理状態を表示します。

BEGINNING…トランザクションブランチ開始処理中

ACTIVE…実行中

SUSPENDED…中断中

IDLE…同期点処理へ移行

PREPARE…コミット（1相目）処理中

READY…コミット（2相目）処理待ち

HEURISTIC_COMMIT…ヒューリスティック決着のコミット処理中

HEURISTIC_ROLLBACK…ヒューリスティック決着のロールバック処理中

COMMIT…コミット処理中

ROLLBACK_ACTIVE…ロールバック処理待ち

ROLLBACK…ロールバック処理中

HEURISTIC_FORGETTING…ヒューリスティック決着後のトランザクションブランチ終了処理中

FORGETTING…トランザクションブランチ終了処理中

d

トランザクション第2状態（1文字）

トランザクションブランチのTP1/EEプロセスに関する状態を表示します。

d…リソースマネジャ障害監視依頼中

i…通信障害監視依頼中

p…通信障害監視スレッド，またはリソースマネジャ障害監視スレッドでのトランザクションブランチ監視

r…回復スレッドでのトランザクションブランチ回復処理実行中

u…トランザクション処理実行中

ee....ee

サービス名（31文字以内）

トランザクションブランチを起動しているサービス名を表示します。

サービス名がないトランザクションの場合は，「*」を表示します。

ff....ff

スレッドID（10進数）

トランザクションブランチが動作しているスレッドのIFA番号を表示します。

gg....gg

ブランチ記述子（10進数）

一つのトランザクションブランチから分岐したトランザクションブランチを区別するためのインデクス番号を表示します。ルートトランザクションブランチの場合は，「**********」を表示します。

hh....hh

親トランザクション記述子（10進数）

該当するトランザクションブランチを生成したトランザクションのトランザクション記述子を表示します。ルートトランザクションブランチの場合は，「**********」を表示します。

ii....ii

トランザクションブランチ数（10進数）

処理中のトランザクションブランチ数を表示します。

jjjjjjjj

中央処理通番（16進数）

出力メッセージ

メッセージID

内容

出力先

KFSB90901-E

コマンドの形式が不正です。

標準エラー出力

KFSB90902-E

フラグ引数が不正です。

標準エラー出力

KFSB90904-E

コマンドが失敗しました。

標準エラー出力

KFSB90905-E

領域の確保に失敗しました。

標準エラー出力

KFSB90906-E

内部矛盾が発生しました。

標準エラー出力

KFSB90919-I

ヘルプメッセージ

標準出力

注意事項

トランザクションのコミットは，eetrncmtコマンドの実行とは非同期で実行します。

eetrnfgt

名称

トランザクションの強制終了

形式

eetrnfgt -g サービスグループ名 ｛-t｜-T トランザクション識別子｝

機能

eetrnlstrコマンドを実行して表示された情報中のステータスがHEURISTIC_FORGETTING（p），HEURISTIC_FORGETTING（d），またはHEURISTIC_FORGETTING（i）状態のときに，トランザクションを強制終了します。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

TP1/EEプロセスのサービスグループ名を指定します。

●-t

トランザクションのステータスがHEURISTIC_FORGETTING（p），HEURISTIC_FORGETTING（d），またはHEURISTIC_FORGETTING（i）状態のすべてのトランザクションの終了を受け付けます。さらに，終了するトランザクションに関する情報を標準出力に出力します。

●-T　トランザクション識別子　　〜〈144文字の16進数〉

指定されたトランザクション識別子（XID）を持つトランザクションのステータスがHEURISTIC_FORGETTING（p），HEURISTIC_FORGETTING（d），またはHEURISTIC_FORGETTING（i）状態であれば，トランザクションの終了を受け付けます。さらに，終了するトランザクションに関する情報を標準出力に出力します。

トランザクション識別子は，eetrnlstrコマンドで知ることができます。

出力形式

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

出力形式中の，右端の数字の意味を次に示します。

1：1トランザクションの情報を，改行を含まないで1行で表示します。トランザクションが複数ある場合，トランザクション数分表示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa....aa

トランザクション識別子（16進数）

bb....bb

トランザクション記述子（10進数）

トランザクションブランチを区別するためのインデクス番号を表示します。

cc....cc

トランザクション第1状態（20文字以内）

トランザクションブランチの処理状態を表示します。

BEGINNING…トランザクションブランチ開始処理中

ACTIVE…実行中

SUSPENDED…中断中

IDLE…同期点処理へ移行

PREPARE…コミット（1相目）処理中

READY…コミット（2相目）処理待ち

HEURISTIC_COMMIT…ヒューリスティック決着のコミット処理中

HEURISTIC_ROLLBACK…ヒューリスティック決着のロールバック処理中

COMMIT…コミット処理中

ROLLBACK_ACTIVE…ロールバック処理待ち

ROLLBACK…ロールバック処理中

HEURISTIC_FORGETTING…ヒューリスティック決着後のトランザクションブランチ終了処理中

FORGETTING…トランザクションブランチ終了処理中

d

トランザクション第2状態（1文字）

トランザクションブランチのTP1/EEプロセスに関する状態を表示します。

d…リソースマネジャ障害監視依頼中

i…通信障害監視依頼中

p…通信障害監視スレッド，またはリソースマネジャ障害監視スレッドでのトランザクションブランチ監視

r…回復スレッドでのトランザクションブランチ回復処理実行中

u…トランザクション処理実行中

ee....ee

サービス名（31文字以内）

トランザクションブランチを起動しているサービス名を表示します。

サービス名がないトランザクションの場合は，「*」を表示します。

ff....ff

スレッドID（10進数）

トランザクションブランチが動作しているスレッドのIFA番号を表示します。

gg....gg

ブランチ記述子（10進数）

一つのトランザクションブランチから分岐したトランザクションブランチを区別するためのインデクス番号を表示します。ルートトランザクションブランチの場合は，「**********」を表示します。

hh....hh

親トランザクション記述子（10進数）

該当するトランザクションブランチを生成したトランザクションのトランザクション記述子を表示します。ルートトランザクションブランチの場合は，「**********」を表示します。

ii....ii

トランザクションブランチ数（10進数）

処理中のトランザクションブランチ数を表示します。

jjjjjjjj

中央処理通番（16進数）

出力メッセージ

メッセージID

内容

出力先

KFSB90901-E

コマンドの形式が不正です。

標準エラー出力

KFSB90902-E

フラグ引数が不正です。

標準エラー出力

KFSB90904-E

コマンドが失敗しました。

標準エラー出力

KFSB90905-E

領域の確保に失敗しました。

標準エラー出力

KFSB90906-E

内部矛盾が発生しました。

標準エラー出力

KFSB90921-I

ヘルプメッセージ

標準出力

注意事項

トランザクションの強制終了は，eetrnfgtコマンドの実行とは非同期で実行します。

eetrnlsdump

名称

オフライン中にコアファイルからトランザクション状態を取得，表示

形式

eetrnlsdump -t 〔-s〕〔-i〕 ファイル名

機能

指定されたコアファイルまたはメモリダンプファイルから，オンライン時のトランザクションの状態を編集し，標準出力に出力します。

オプション

●-t

すべてのトランザクションに関する情報を表示します。

●-s

TP1/Server Base形式のトランザクション識別子（TRNGID，TRNBID）を表示します。

●-i

HiRDB形式のトランザクション識別子を表示します。

コマンド引数

●ファイル名　　〜〈パス名〉

コアファイル名またはメモリダンプファイル名を指定します。

出力形式

●「eetrnlsdump　-t ファイル名」と指定した場合

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

出力形式中の，右端の数字の意味を次に示します。

1：1トランザクションの情報を，改行を含まないで1行で表示します。トランザクションが複数ある場合，トランザクション数分表示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa....aa

トランザクション識別子（16進数）

bb....bb

トランザクション記述子（10進数）

トランザクションブランチを区別するためのインデクス番号を表示します。

cc....cc

トランザクション第1状態（20文字以内）

トランザクションブランチの処理状態を表示します。

BEGINNING…トランザクションブランチ開始処理中

ACTIVE…実行中

SUSPENDED…中断中

IDLE…同期点処理へ移行

PREPARE…コミット（1相目）処理中

READY…コミット（2相目）処理待ち

HEURISTIC_COMMIT…ヒューリスティック決着のコミット処理中

HEURISTIC_ROLLBACK…ヒューリスティック決着のロールバック処理中

COMMIT…コミット処理中

ROLLBACK_ACTIVE…ロールバック処理待ち

ROLLBACK…ロールバック処理中

HEURISTIC_FORGETTING…ヒューリスティック決着後のトランザクションブランチ終了処理中

FORGETTING…トランザクションブランチ終了処理中

d

トランザクション第2状態（1文字）

トランザクションブランチのTP1/EEプロセスに関する状態を表示します。

d…リソースマネジャ障害監視依頼中

i…通信障害監視依頼中

p…通信障害監視スレッド，またはリソースマネジャ障害監視スレッドでのトランザクションブランチ監視

r…回復スレッドでのトランザクションブランチ回復処理実行中

u…トランザクション処理実行中

ee....ee

サービス名（31文字以内）

トランザクションブランチを起動しているサービス名を表示します。

サービス名がないトランザクションの場合は，「*」を表示します。

ff....ff

スレッドID（10進数）

トランザクションブランチが動作しているスレッドのIFA番号を表示します。

gg....gg

ブランチ記述子（10進数）

一つのトランザクションブランチから分岐したトランザクションブランチを区別するためのインデクス番号を表示します。ルートトランザクションブランチの場合は，「**********」を表示します。

hh....hh

親トランザクション記述子（10進数）

該当するトランザクションブランチを生成したトランザクションのトランザクション記述子を表示します。ルートトランザクションブランチの場合は，「**********」を表示します。

ii....ii

トランザクションブランチ数（10進数）

処理中のトランザクションブランチ数を表示します。

jjjjjjjj

中央処理通番（16進数）

●「eetrnlsdump　-t -s ファイル名」と指定した場合

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

出力形式中の，右端の数字の意味を次に示します。

1：改行を含まないで1行で表示します。

2：1トランザクションの情報を，改行を含まないで1行で表示します。トランザクションが複数ある場合，トランザクション数分表示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

kkkkkkkk

ルートトランザクションブランチのシステムノードID（8文字）

llllllll

グローバルトランザクション番号（16進数）

mmmmmmmm

親トランザクションブランチのシステムノードID（8文字）

ルートトランザクションブランチの場合は，「**********」を表示します。

nnnnnnnn

トランザクションブランチ番号（16進数）

ルートトランザクションブランチの場合は，「**********」を表示します。

上記以外の項目については，「●「eetrnlsdump　-t ファイル名」と指定した場合」の説明を参照してください。

●「eetrnlsdump　-t -i ファイル名」と指定した場合

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

出力形式中の，右端の数字の意味を次に示します。

1：改行を含まないで1行で表示します。

2：1トランザクションの情報を，改行を含まないで1行で表示します。トランザクションが複数ある場合，トランザクション数分表示します。

出力形式中のkk....kkは，HiRDB形式のトランザクション識別子（33文字以内）を示しています。

上記以外の項目については，「●「eetrnlsdump　-t ファイル名」と指定した場合」の説明を参照してください。

●「eetrnlsdump　-t -s -i ファイル名」と指定した場合

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

出力形式中の，右端の数字の意味を次に示します。

1：改行を含まないで1行で表示します。

2：1トランザクションの情報を，改行を含まないで1行で表示します。トランザクションが複数ある場合，トランザクション数分表示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

kkkkkkkk

ルートトランザクションブランチのシステムノードID（8文字）

llllllll

グローバルトランザクション番号（16進数）

mmmmmmmm

親トランザクションブランチのシステムノードID（8文字）

ルートトランザクションブランチの場合は，「**********」を表示します。

nnnnnnnn

トランザクションブランチ番号（16進数）

ルートトランザクションブランチの場合は，「**********」を表示します。

oo....oo

HiRDB形式のトランザクション識別子（33文字以内）

上記以外の項目については，「●「eetrnlsdump　-t ファイル名」と指定した場合」の説明を参照してください。

出力メッセージ

メッセージID

内容

出力先

KFSB90901-E

コマンドの形式が不正です。

標準エラー出力

KFSB90905-E

領域の確保に失敗しました。

標準エラー出力

KFSB90906-E

内部矛盾が発生しました。

標準エラー出力

KFSB90907-E

ファイルのオープン処理で障害が発生しました。

標準エラー出力

KFSB90908-E

ファイルからの読み込み処理で障害が発生しました。

標準エラー出力

KFSB90910-E

ファイルのクローズ処理で障害が発生しました。

標準エラー出力

KFSB90924-I

ヘルプメッセージ

標準出力

KFSB90925-E

指定したファイルに編集するデータがありません。

標準エラー出力

eetrnlsrm

名称

リソースマネジャの情報の表示

形式

eetrnlsrm -o ファイル名〔,ファイル名…〕

機能

リソースマネジャ連携用オブジェクトファイルに登録されているリソースマネジャ情報を表示します。

オプション

●-o　ファイル名　　〜〈パス名〉

指定したファイルに登録されているリソースマネジャの情報を標準出力に出力します。指定できるファイルは，リソースマネジャ連携用オブジェクトファイルだけです。複数のファイルを指定する場合は，ファイル名とファイル名の間をコンマ「,」で区切ってください。

ファイル名は，1個当たり最大511文字指定できます。また，複数のファイルを指定するときは，最大16384文字指定できます。

出力形式

日本語の出力形式を次に示します。

ファイル名    RM名       スイッチ名      オブジェクト名
aa....aa      bb....bb   cc....cc        dd....dd            1
                                         dd....dd            2

英語の出力形式を次に示します。

File name    RM name    Switch name     Object name
aa....aa     bb....bb   cc....cc        dd....dd             1
                                        dd....dd             2

出力形式中の，右端の数字の意味を次に示します。

1：登録されているリソースマネジャの数だけ繰り返し表示します。

2：同一ファイルに複数のリソースマネジャ関連オブジェクトがある場合に表示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa....aa

指定したファイル名（パス名は除く）

bb....bb

リソースマネジャ名（32文字以内）

cc....cc

リソースマネジャスイッチ名（32文字以内）

dd....dd

リソースマネジャ関連オブジェクト名

出力メッセージ

メッセージID

内容

出力先

KFSB90901-E

コマンドの形式が不正です。

標準エラー出力

KFSB90902-E

フラグ引数が不正です。

標準エラー出力

KFSB90905-E

領域の確保に失敗しました。

標準エラー出力

KFSB90906-E

内部矛盾が発生しました。

標準エラー出力

KFSB90907-E

ファイルのオープン処理で障害が発生しました。

標準エラー出力

KFSB90908-E

ファイルからの読み込み処理で障害が発生しました。

標準エラー出力

KFSB90910-E

ファイルのクローズ処理で障害が発生しました。

標準エラー出力

KFSB90911-E

ファイルポインタの移動処理で障害が発生しました。

標準エラー出力

KFSB90912-E

リソースマネジャ情報を表示できません。

標準エラー出力

KFSB90917-I

ヘルプメッセージ

標準出力

eetrnlstr

名称

オンライン中のトランザクションの状態表示

形式

eetrnlstr -g サービスグループ名
        ｛-t 〔-s〕〔-i〕｜-T トランザクション識別子
        ｛〔-r〕 ｜〔-s〕〔-i〕｝ ｜-a｝

機能

トランザクションに関する情報を標準出力に出力します。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

TP1/EEプロセスのサービスグループ名を指定します。

●-t

すべてのトランザクションに関する情報を表示します。

●-s

TP1/Server Base形式のトランザクション識別子（TRNGID，TRNBID）を表示します。

●-i

HiRDB形式のトランザクション識別子を表示します。

●-T　トランザクション識別子　　〜〈144文字の16進数〉

指定したトランザクション識別子（XID）を持つトランザクションに関する情報を表示します。

●-r

リソースマネジャに接続しているトランザクションに関する情報を表示します。

●-a

トランザクション連携先のノード識別子，およびTP1/Server Base形式のトランザクション識別子（TRNGID，TRNBID）を表示します。

出力形式

●「eetrnlstr -g サービスグループ名 -t」または「eetrnlstr -g サービスグループ名 -T トランザクション識別子」と指定した場合

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

出力形式中の，右端の数字の意味を次に示します。

1：1トランザクションの情報を，改行を含まないで1行で表示します。トランザクションが複数ある場合，トランザクション数分表示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa....aa

トランザクション識別子（16進数）

bb....bb

トランザクション記述子（10進数）

トランザクションブランチを区別するためのインデクス番号を表示します。

cc....cc

トランザクション第1状態（20文字以内）

トランザクションブランチの処理状態を表示します。

BEGINNING…トランザクションブランチ開始処理中

ACTIVE…実行中

SUSPENDED…中断中

IDLE…同期点処理へ移行

PREPARE…コミット（1相目）処理中

READY…コミット（2相目）処理待ち

HEURISTIC_COMMIT…ヒューリスティック決着のコミット処理中

HEURISTIC_ROLLBACK…ヒューリスティック決着のロールバック処理中

COMMIT…コミット処理中

ROLLBACK_ACTIVE…ロールバック処理待ち

ROLLBACK…ロールバック処理中

HEURISTIC_FORGETTING…ヒューリスティック決着後のトランザクションブランチ終了処理中

FORGETTING…トランザクションブランチ終了処理中

d

トランザクション第2状態（1文字）

トランザクションブランチのTP1/EEプロセスに関する状態を表示します。

d…リソースマネジャ障害監視依頼中

i…通信障害監視依頼中

p…通信障害監視スレッド，またはリソースマネジャ障害監視スレッドでのトランザクションブランチ監視

r…回復スレッドでのトランザクションブランチ回復処理実行中

u…トランザクション処理実行中

ee....ee

サービス名（31文字以内）

トランザクションブランチを起動しているサービス名を表示します。

サービス名がないトランザクションの場合は，「*」を表示します。

ff....ff

スレッドID（10進数）

トランザクションブランチが動作しているスレッドのIFA番号を表示します。

gg....gg

ブランチ記述子（10進数）

一つのトランザクションブランチから分岐したトランザクションブランチを区別するためのインデクス番号を表示します。ルートトランザクションブランチの場合は，「**********」を表示します。

hh....hh

親トランザクション記述子（10進数）

該当するトランザクションブランチを生成したトランザクションのトランザクション記述子を表示します。ルートトランザクションブランチの場合は，「**********」を表示します。

ii....ii

トランザクションブランチ数（10進数）

処理中のトランザクションブランチ数を表示します。

jjjjjjjj

中央処理通番（16進数）

●「eetrnlstr -g サービスグループ名 -T トランザクション識別子 -r」と指定した場合

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

（凡例）

下線：1トランザクションに複数のリソースマネジャが接続している場合，接続しているリソースマネジャ数分表示します。

出力形式中の，右端の数字の意味を次に示します。

1：改行を含まないで1行で表示します。

2：1トランザクションの情報を1行で表示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa....aa

トランザクション識別子（16進数）

bb....bb

トランザクション記述子（10進数）

トランザクションブランチを区別するためのインデクス番号を表示します。

cc....cc

トランザクション第1状態（20文字以内）

トランザクションブランチの処理状態を表示します。

BEGINNING…トランザクションブランチ開始処理中

ACTIVE…実行中

SUSPENDED…中断中

IDLE…同期点処理へ移行

PREPARE…コミット（1相目）処理中

READY…コミット（2相目）処理待ち

HEURISTIC_COMMIT…ヒューリスティック決着のコミット処理中

HEURISTIC_ROLLBACK…ヒューリスティック決着のロールバック処理中

COMMIT…コミット処理中

ROLLBACK_ACTIVE…ロールバック処理待ち

ROLLBACK…ロールバック処理中

HEURISTIC_FORGETTING…ヒューリスティック決着後のトランザクションブランチ終了処理中

FORGETTING…トランザクションブランチ終了処理中

d

トランザクション第2状態（1文字）

トランザクションブランチのTP1/EEプロセスに関する状態を表示します。

d…リソースマネジャ障害監視依頼中

i…通信障害監視依頼中

p…通信障害監視スレッド，またはリソースマネジャ障害監視スレッドでのトランザクションブランチ監視

r…回復スレッドでのトランザクションブランチ回復処理実行中

u…トランザクション処理実行中

ee....ee

サービス名（31文字以内）

トランザクションブランチを起動しているサービス名を表示します。

サービス名がないトランザクションの場合は，「*」を表示します。

ff....ff

スレッドID（10進数）

トランザクションブランチが動作しているスレッドのIFA番号を表示します。

gg....gg

ブランチ記述子（10進数）

一つのトランザクションブランチから分岐したトランザクションブランチを区別するためのインデクス番号を表示します。ただし，ルートトランザクションブランチの場合は，「**********」を表示します。

hh....hh

親トランザクション記述子（10進数）

該当するトランザクションブランチを生成したトランザクションのトランザクション記述子を表示します。ルートトランザクションブランチの場合は，「**********」を表示します。

kk....kk

リソースマネジャ名（31文字以内）

ll....ll

リソースマネジャ拡張子（2文字以内）

mm....mm

リソースマネジャID（10進数）

nn....nn

リソースマネジャ状態（16文字以内）

ACTIVE…xa_start関数処理中

ACTIVE_STARTED…リソースマネジャ実行中

BEGINNING…リソースマネジャ開始処理中

COMMIT…xa_commit関数処理中

FORGETTING…リソースマネジャ終了中

FORGOTTEN…リソースマネジャ未起動

IDLE…同期点処理へ移行

IDLING…xa_end関数（SUCCESS），xa_end関数（FAIL）処理中

PREPARE…xa_prepare関数処理中

READY…ready

RESUMING…xa_start関数（resume）処理中

ROLLBACK…xa_rollback関数処理中

SUSPENDED…リソースマネジャ中断中

SUSPENDING…xa_end関数（suspend）処理中

ii....ii

トランザクションブランチ数（10進数）

処理中のトランザクションブランチ数を表示します。

jjjjjjjj

中央処理通番（16進数）

●「eetrnlstr -g サービスグループ名 -t -s」または「eetrnlstr -g サービスグループ名 -T トランザクション識別子 -s」と指定した場合

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

出力形式中の，右端の数字の意味を次に示します。

1：改行を含まないで1行に表示します。

2：1トランザクションの情報を1行で表示します。トランザクションが複数ある場合，トランザクション数分表示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

kkkkkkkk

ルートトランザクションブランチのシステムノードID（8文字）

llllllll

グローバルトランザクション番号（16進数）

mmmmmmmm

親トランザクションブランチのシステムノードID（8文字）

ルートトランザクションブランチの場合は，「**********」を表示します。

nnnnnnnn

トランザクションブランチ番号（16進数）

ルートトランザクションブランチの場合は，「**********」を表示します。

上記以外の項目については，「●「eetrnlstr -g サービスグループ名 -t」または「eetrnlstr -g サービスグループ名 -T トランザクション識別子」と指定した場合」の説明を参照してください。

●「eetrnlstr -g サービスグループ名 -t -i」または「eetrnlstr -g サービスグループ名 -T トランザクション識別子 -i」と指定した場合

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

出力形式中の，右端の数字の意味を次に示します。

1：改行を含まないで1行に表示します。

2：1トランザクションの情報を1行で表示します。トランザクションが複数ある場合，トランザクション数分表示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

kk....kk

HiRDB形式のトランザクション識別子（33文字以内）

上記以外の項目については，「●「eetrnlstr -g サービスグループ名 -t」または「eetrnlstr -g サービスグループ名 -T トランザクション識別子」と指定した場合」の説明を参照してください。

●「eetrnlstr -g サービスグループ名 -t -s -i」または「eetrnlstr -g サービスグループ名 -T トランザクション識別子 -s -i」と指定した場合

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

出力形式中の，右端の数字の意味を次に示します。

1：改行を含まないで1行に表示します。

2：1トランザクションの情報を1行で表示します。トランザクションが複数ある場合，トランザクション数分表示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

kkkkkkkk

ルートトランザクションブランチのシステムノードID（8文字）

llllllll

グローバルトランザクション番号（16進数）

mmmmmmmm

親トランザクションブランチのシステムノードID（8文字）

ルートトランザクションブランチの場合は，「**********」を表示します。

nnnnnnnn

トランザクションブランチ番号（16進数）

ルートトランザクションブランチの場合は，「**********」を表示します。

oo....oo

HiRDB形式のトランザクション識別子（33文字以内）

上記以外の項目については，「●「eetrnlstr -g サービスグループ名 -t」または「eetrnlstr -g サービスグループ名 -T トランザクション識別子」と指定した場合」の説明を参照してください。

●「eetrnlstr -g サービスグループ名 -a」と指定した場合

日本語と英語で共通の出力形式を次に示します。

TRNGID           TRNBID           SUPERIOR       SUBORDINATE       1
kkkkkkkkllllllll mmmmmmmmnnnnnnnn pppp(qqqqqqqq) rrrr(ssssssss)    2
                                                      :
                                                 rrrr(ssssssss)    2
kkkkkkkkllllllll mmmmmmmmnnnnnnnn pppp(qqqqqqqq) rrrr(ssssssss)    2

出力形式中の，右端の数字の意味を次に示します。

1：改行を含まないで1行に表示します。

2：1トランザクションの情報を1行で表示します。1トランザクションの連携先が複数ある場合，最大32個表示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

kkkkkkkk

ルートトランザクションブランチのシステムノードID（8文字）

llllllll

グローバルトランザクション番号（16進数）

mmmmmmmm

スペリアトランザクションブランチのシステムノードID（8文字）

ルートトランザクションの場合は，「********」を表示します。

nnnnnnnn

トランザクションブランチ番号（16進数）

ルートトランザクションの場合は，「********」を表示します。

pppp

親トランザクションブランチのノード識別子（4文字）

ルートトランザクションの場合は，「****」を表示します。

qqqqqqqq

親トランザクションブランチのトランザクション記述子（16進数）

ルートトランザクションの場合は，「********」を表示します。

rrrr

子トランザクションブランチのノード識別子（4文字）

子トランザクションブランチが存在しない場合は「****」を表示します。

ssssssss

子トランザクションブランチのトランザクション記述子（16進数）

子トランザクションブランチが存在しない場合は「********」を表示します。

出力メッセージ

メッセージID

内容

出力先

KFSB90901-E

コマンドの形式が不正です。

標準エラー出力

KFSB90902-E

フラグ引数が不正です。

標準エラー出力

KFSB90904-E

コマンドが失敗しました。

標準エラー出力

KFSB90905-E

領域の確保に失敗しました。

標準エラー出力

KFSB90906-E

内部矛盾が発生しました。

標準エラー出力

KFSB90922-I

ヘルプメッセージ

標準出力

eetrnmkobj

名称

リソースマネジャ連携用オブジェクトファイルの作成

形式

eetrnmkobj -r リソースマネジャ名〔,リソースマネジャ名…〕
           -o リソースマネジャ連携用オブジェクトファイル名
           -s リソースマネジャスイッチ名〔,リソースマネジャスイッチ名…〕
           -O リソースマネジャ関連オブジェクト〔,リソースマネジャ関連オブジェクト…〕
         〔-i HiRDB提供ヘッダのパス〕
         〔-C 'コンパイルオプション名〔 コンパイルオプション名〕…'〕

機能

リソースマネジャ連携用オブジェクトファイルをカレントディレクトリに作成します。

オプション

●-r　リソースマネジャ名　　〜〈1〜32文字〉

連携するリソースマネジャ名を指定します。複数のリソースマネジャを指定する場合は，リソースマネジャ名をコンマ「,」で区切ってください。リソースマネジャ名は，最大32個指定できます。

同一のリソースマネジャを重複して指定した場合，引数エラーになります。

●-o　リソースマネジャ連携用オブジェクトファイル名　　〜〈1〜12文字〉

作成するリソースマネジャ連携用オブジェクトファイル名を指定します。

●-s　リソースマネジャスイッチ名　　〜〈1〜32文字〉

連携するリソースマネジャのリソースマネジャスイッチ名を指定します。複数のリソースマネジャスイッチ名を指定する場合は，リソースマネジャスイッチ名をコンマ「,」で区切ってください。その場合，-rオプションで指定したリソースマネジャ名の指定順とそろえてください。リソースマネジャスイッチ名は，最大32個指定できます。

同一のリソースマネジャを持つリソースマネジャスイッチ名は，指定しないでください。

●-O　リソースマネジャ関連オブジェクト　　〜〈1〜4095文字〉

連携するリソースマネジャに関連のあるオブジェクトファイル（XAインタフェース用オブジェクトファイル）を指定します。リソースマネジャ関連オブジェクトについては，マニュアル「HiRDB UAP開発ガイド」を参照してください。なお，HiRDB以外のリソースマネジャをご使用になる場合は，ご使用になるリソースマネジャのマニュアルを参照してください。

リソースマネジャ関連オブジェクトにコンマを指定する必要がある場合は，コンマの前に「¥」を挿入してください。

複数のリソースマネジャ関連オブジェクトを指定する必要がある場合は，次に示すように指定してください。

シングルクォーテーション「'」で囲んで一つのフラグ引数として扱うように指定してください。最大16384文字指定できます。

リソースマネジャ関連オブジェクトとリソースマネジャ関連オブジェクトとの間を空白で区切ってください。

また，一つのリソースマネジャに対して，複数のリソースマネジャ関連オブジェクトを指定できます。一つのリソースマネジャに対して，複数のリソースマネジャ関連オブジェクトを指定する必要がある場合は，次のことに注意してください。

-rオプションで複数のリソースマネジャ名を指定する場合は，-rオプションで指定したリソースマネジャ名と，-Oオプションで指定するリソースマネジャ関連オブジェクトの指定順をそろえてください。

各リソースマネジャに対応するリソースマネジャ関連オブジェクトごとに，コンマ「,」で区切ってください。

●-C　コンパイルオプション名　　〜〈1〜512文字〉

コンパイル実行時に使用するコンパイルオプションを指定します。

指定するコンパイルオプション名はシングルクォーテーション「'」で囲んでください。コンパイルオプション名にコンマ「，」を指定する必要がある場合は，コンマの前に「¥」を挿入してください。

複数のコンパイルオプション名を指定する場合は，コンパイルオプション名とコンパイルオプション名との間を空白で区切ります。

-Cオプションは，コンパイルを実行する場合だけ指定してください。

●-i　HiRDB提供ヘッダのパス　　〜〈1〜511文字のパス名〉

-rオプションでHiRDB_DB_SERVERを指定した場合，HiRDB提供ヘッダファイルが格納されているディレクトリのパス名を指定します。-rオプションでHiRDB_DB_SERVERを指定しなかった場合，-iオプションは無視されます。

HiRDB提供のヘッダファイルが見つからなかった場合，リソースマネジャ連携用オブジェクトファイルの作成に失敗し，理由コード0001を付加したKFSB90913-Eメッセージが出力されます。

出力メッセージ

メッセージID

内容

出力先

KFSB90901-E

コマンドの形式が不正です。

標準エラー出力

KFSB90902-E

フラグ引数が不正です。

標準エラー出力

KFSB90905-E

領域の確保に失敗しました。

標準エラー出力

KFSB90906-E

内部矛盾が発生しました。

標準エラー出力

KFSB90907-E

ファイルのオープン処理で障害が発生しました。

標準エラー出力

KFSB90909-E

ファイルへの書き込み処理で障害が発生しました。

標準エラー出力

KFSB90910-E

ファイルのクローズ処理で障害が発生しました。

標準エラー出力

KFSB90911-E

ファイルポインタの移動処理で障害が発生しました。

標準エラー出力

KFSB90913-E

リソースマネジャ連携用オブジェクトファイルの作成で障害が発生しました。

標準エラー出力

KFSB90914-I

ファイルの作成を開始しました。

標準出力

KFSB90915-I

ファイルの作成を完了しました。

標準出力

KFSB90916-I

ヘルプメッセージ

標準出力

注意事項

コンパイラのパスが解決していることを確認してからeetrnmkobjコマンドを実行してください。

リソースマネジャ連携用オブジェクトファイルの作成後，eetrnlsrmコマンドでリソースマネジャ情報を表示して，eetrnmkobjコマンドの実行内容が正しいかどうか確認してください。

理由コード0002を付加したKFSB90907-Eメッセージは，eetrnmkobjコマンドで同じ名前のファイルを同時に作成しようとした，または以前に同じ名前のファイルを作成しようとして失敗したときに出力されます。

TP1/EEの再開始時に，リソースマネジャ連携用オブジェクトファイルを変更しないでください。

eetrnrbk

名称

トランザクションのロールバック

形式

eetrnrbk -g サービスグループ名 ｛-t 〔-f〕
       ｜-T トランザクション識別子 〔-f〕｝

機能

eetrnrbkコマンドは，グローバルトランザクションを構成している各トランザクションブランチが何らかの要因（通信障害など）でトランザクションを決着できないときに実行します。eetrnlstrコマンドを実行して表示された情報中のステータスがREADY（p），READY（d），またはREADY（i）状態のときに，トランザクションブランチを強制的にロールバックし，ほかのトランザクションブランチに連絡完了後，トランザクションを終了します。ルートトランザクションブランチがロールバックされた場合に実行してください。

eetrnrbkコマンドを実行してトランザクションをロールバックする場合，ほかのトランザクションとの不整合を発生させないために，グローバルトランザクション内のほかのトランザクションブランチもロールバックしてください。通信障害が発生している場合，トランザクションブランチ間の連絡が完了するまでトランザクションを終了できません。このとき，-fオプションを指定すると，トランザクションを強制的に終了できます。通信障害が一時的な場合，-fオプションは指定しないでeetrnrbkコマンドを実行してください。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

TP1/EEプロセスのサービスグループ名を指定します。

●-t

トランザクションのステータスがREADY（p），READY（d），またはREADY（i）状態のすべてのトランザクションのロールバックを受け付けます。さらに，ロールバックするトランザクションに関する情報を標準出力に出力します。

●-f

トランザクションを強制終了します。

-fオプションの指定を省略すると，トランザクションは強制終了されません。

●-T　トランザクション識別子　　〜〈144文字の16進数〉

指定されたトランザクション識別子（XID）を持つトランザクションのステータスがREADY（p），READY（d），またはREADY（i）状態であれば，トランザクションのロールバックを受け付けます。さらに，ロールバックするトランザクションに関する情報を標準出力に出力します。

トランザクション識別子は，eetrnlstrコマンドで知ることができます。

出力形式

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

出力形式中の，右端の数字の意味を次に示します。

1：1トランザクションの情報を1行で表示します。トランザクションが複数ある場合，トランザクション数分表示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa....aa

トランザクション識別子（16進数）

bb....bb

トランザクション記述子（10進数）

トランザクションブランチを区別するためのインデクス番号を表示します。

cc....cc

トランザクション第1状態（20文字以内）

トランザクションブランチの処理状態を表示します。

BEGINNING…トランザクションブランチ開始処理中

ACTIVE…実行中

SUSPENDED…中断中

IDLE…同期点処理へ移行

PREPARE…コミット（1相目）処理中

READY…コミット（2相目）処理待ち

HEURISTIC_COMMIT…ヒューリスティック決着コミット処理中

HEURISTIC_ROLLBACK…ヒューリスティック決着ロールバック処理中

COMMIT…コミット処理中

ROLLBACK_ACTIVE…ロールバック処理待ち

ROLLBACK…ロールバック処理中

HEURISTIC_FORGETTING…ヒューリスティック決着後のトランザクションブランチ終了処理中

FORGETTING…トランザクションブランチ終了処理中

d

トランザクション第2状態（1文字）

トランザクションブランチのTP1/EEプロセスに関する状態を表示します。

d…リソースマネジャ障害監視依頼中

i…通信障害監視依頼中

p…通信障害監視スレッド，またはリソースマネジャ障害監視スレッドでのトランザクションブランチ監視

r…回復スレッドでのトランザクションブランチ回復処理実行中

u…トランザクション処理実行中

ee....ee

サービス名（31文字以内）

トランザクションブランチを起動しているサービスの名称を表示します。

サービス名がないトランザクションの場合は，「*」を表示します。

ff....ff

スレッドID（10進数）

トランザクションブランチが動作しているスレッドのIFA番号を表示します。

gg....gg

ブランチ記述子（10進数）

一つのトランザクションブランチから分岐したトランザクションブランチを区別するためのインデクス番号を表示します。ルートトランザクションブランチの場合は，「**********」を表示します。

hh....hh

親トランザクション記述子（10進数）

該当するトランザクションブランチを生成したトランザクションのトランザクション記述子を表示します。ルートトランザクションブランチの場合は，「**********」を表示します。

ii....ii

トランザクションブランチ数（10進数）

処理中のトランザクションブランチ数を表示します。

jjjjjjjj

中央処理通番（16進数）

出力メッセージ

メッセージID

内容

出力先

KFSB90901-E

コマンドの形式が不正です。

標準エラー出力

KFSB90902-E

フラグ引数が不正です。

標準エラー出力

KFSB90904-E

コマンドが失敗しました。

標準エラー出力

KFSB90905-E

領域の確保に失敗しました。

標準エラー出力

KFSB90906-E

内部矛盾が発生しました。

標準エラー出力

KFSB90920-I

ヘルプメッセージ

標準出力

注意事項

トランザクションのロールバックは，eetrnrbkコマンドの実行とは非同期で実行します。

eetrntim

名称

トランザクション処理の監視時間の変更

形式

eetrntim -g サービスグループ名 ｛-s トランザクション種別
                                 -t トランザクション処理監視時間
                               ｜-r｜-l｝

機能

トランザクション処理の監視時間を変更します。

オプション

●-g　サービスグループ名　　〜〈1〜31文字の識別子〉

TP1/EEプロセスのサービスグループ名を指定します。

●-s　トランザクション種別

トランザクション処理の監視時間を変更するトランザクション種別を指定します。

MI

初期化トランザクション（trn_expiration_time_mi）

ME

終了トランザクション（trn_expiration_time_me）

MN

サービストランザクション（trn_expiration_time_mn）

E1

エラートランザクション1（trn_expiration_time_e1）

E2

エラートランザクション2（trn_expiration_time_e2）

E3

エラートランザクション3（trn_expiration_time_e3）

E4

エラートランザクション4（trn_expiration_time_e4）

ES

エラートランザクションS（trn_expiration_time_es）

ER

エラートランザクションR（trn_expiration_time_er）

TM

タイマトランザクション（trn_expiration_time_tm）

UI

実行系連絡トランザクション（trn_expiration_time_ui）

MV

イベント通知トランザクション（trn_expiration_time_mv）

RL

MCP後処理トランザクション（trn_expiration_time_rl）

UT

ユーザ初期化トランザクション（trn_expiration_time_ut）

CU

ユーザコマンドトランザクション（trn_expiration_time_cu）

JI

共有リソース初期化トランザクション（trn_expiration_time_ji）

ALL

-sオプションで指定できるすべてのトランザクション種別を変更対象とします。

●-t　トランザクション処理監視時間　　〜((0〜65535))

変更するトランザクション処理の監視時間を指定します。

0を指定した場合，監視をしません。

●-r

-sオプションで指定できるすべてのトランザクション種別のトランザクション処理の監視時間を，eetrntimコマンドで変更する前の値に戻します。eetrntimコマンドで変更する前の値とは，トランザクション関連定義のtrn_expiration_timeオペランド，またはtrn_expiration_time_**オペランド（**は小文字のトランザクション種別）で指定した値です。

●-l

コマンド実行時の，トランザクション種別ごとのトランザクション処理の監視時間を表示します。

出力形式

●「eetrntim -g サービスグループ名 -s トランザクション種別 -t トランザクション処理監視時間」または「eetrntim -g サービスグループ名 -r」と指定した場合

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

出力形式中の，右端の数字の意味を次に示します。

1：改行を含まないで1行に表示します。

2：-sオプションでALLを指定した場合，および-rオプションを指定した場合，システム用トランザクションを除いたすべてのトランザクションについて繰り返し表示します。-sオプションでALLを指定した場合，および-rオプションを指定した場合以外は，1行で表示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

aa

トランザクション種別（2文字）

監視時間を変更したトランザクションの種別

MI…初期化トランザクション

ME…終了トランザクション

MN…サービストランザクション

E1…エラートランザクション1

E2…エラートランザクション2

E3…エラートランザクション3

E4…エラートランザクション4

ES…エラートランザクションS

ER…エラートランザクションR

TM…タイマトランザクション

UI…実行系連絡トランザクション

MV…イベント通知トランザクション

RL…MCP後処理トランザクション

UT…ユーザ初期化トランザクション

CU…ユーザコマンドトランザクション

JI…共有リソース初期化トランザクション

bb....bb

トランザクション関連定義による指定時間（5けた以内の10進数）

トランザクション関連定義のtrn_expiration_timeオペランド，またはtrn_expiration_time_**オペランド（**は小文字のトランザクション種別）で指定したトランザクション処理の監視時間を表示します。

cc....cc

変更前のトランザクション処理の監視時間（5けた以内の10進数）

変更前のトランザクション処理の監視時間を表示します。

dd....dd

変更後のトランザクション処理の監視時間（5けた以内の10進数）

変更後のトランザクション処理の監視時間を表示します。

●「eetrntim -g サービスグループ名 -l」と指定した場合

日本語の出力形式を次に示します。

英語の出力形式を次に示します。

出力形式中の，右端の数字の意味を次に示します。

1：改行を含まないで1行に表示します。

2：システム用トランザクションを含めたすべてのトランザクションについて繰り返し表示します。

出力形式中の，各変数の意味を次に示します。

変数

意味

aaa

トランザクション種別（2文字または3文字）

監視時間を表示するトランザクションの種別

MI…初期化トランザクション

ME…終了トランザクション

MN…サービストランザクション

E1…エラートランザクション1

E2…エラートランザクション2

E3…エラートランザクション3

E4…エラートランザクション4

ES…エラートランザクションS

ER…エラートランザクションR

TM…タイマトランザクション

UI…実行系連絡トランザクション

MV…イベント通知トランザクション

RL…MCP後処理トランザクション

UT…ユーザ初期化トランザクション

CU…ユーザコマンドトランザクション

JI…共有リソース初期化トランザクション

SYS…システム用トランザクション

bb....bb

トランザクション関連定義による指定時間（5けた以内の10進数）

トランザクション関連定義のtrn_expiration_timeオペランド，またはtrn_expiration_time_**オペランド（**は小文字のトランザクション種別）で指定したトランザクション処理の監視時間を表示します。

cc....cc

トランザクション処理の監視時間（5けた以内の10進数）

コマンド実行時のトランザクション処理の監視時間を表示します。

出力メッセージ

メッセージID

内容

出力先

KFSB90901-E

コマンドの形式が不正です。

標準エラー出力

KFSB90902-E

フラグ引数が不正です。

標準エラー出力

KFSB90904-E

コマンドが失敗しました。

標準エラー出力

KFSB90905-E

領域の確保に失敗しました。

標準エラー出力

KFSB90906-E

内部矛盾が発生しました。

標準エラー出力

KFSB90923-I

ヘルプメッセージ

標準出力

注意事項

ee_trn_set_exp_time関数またはee_trn_watch関数を使用した変更は，ee_trn_set_exp_time関数またはee_trn_watch関数を呼び出したトランザクションだけに有効です。このため，ee_trn_set_exp_time関数またはee_trn_watch関数を使用した変更は，eetrntimコマンドに-lオプションを指定して表示するトランザクション処理の監視時間情報には反映されません。

eetrntimコマンドで変更した監視時間はTP1/EEの再開始時に引き継がれません。

ユーザサービス関連定義のservice_attr定義コマンドの-aオプションで指定したトランザクション処理監視時間は，このコマンドでの変更および表示はできません。

11　障害対策

この章では，TP1/EEの障害を分類し，それぞれの障害が発生した場合の対処方法について説明します。また，障害情報を取得する方法についても説明します。

11.1　TP1/EEシステム障害の対策

TP1/EEは，マルチスレッド処理のための障害対策として，UAPの障害発生によるプロセスダウンを局所化できます。

回復処理は，回復スレッドで実行します。プロセス関連定義のrecover_thread_noオペランドに回復スレッド数を指定することで，回復処理の同時並行度を変更できます。

回復処理の種類と処理内容について説明します。

スレッドの回復

システムの処理を続行したまま障害個所を回復し，障害で処理が中断したトランザクションの決着処理をします。

プロセスの回復

プロセスダウンで処理が中断したすべてのトランザクションに対してTP1/EE再開始時に決着処理をします。

ディレード回復

トランザクションの回復処理よりオンラインの開始処理を優先します。TP1/EE再開始時のトランザクションの決着を待たないでTP1/EEのオンラインの開始処理をします。

アンディレード回復

オンラインの開始処理よりトランザクションの回復処理を優先します。TP1/EE再開始時のすべてのトランザクションの決着処理が完了するまでTP1/EEのオンラインの開始処理を待ちます。

11.1.1　スレッドの回復

スレッドの回復では，システムの処理を続行したまま，障害個所を部分的に回復してスレッドを再生成します。

UAP内の障害発生によるスレッドダウン，通信障害，リソースマネジャの障害などが原因で未決着状態のトランザクションは，回復スレッドで回復します。回復スレッドは，障害発生時点のトランザクションの情報を基に，トランザクションを回復します。

(1)　UAP内の障害発生によるスレッドダウン時のスレッドの回復

UAP内の障害発生によるスレッドダウンは，ERRTRN3を起動して，UAP異常発生元のトランザクション情報をUAPに渡します。その後，回復スレッドでトランザクションを回復します。

UAP内で障害が発生してスレッドダウンした場合の，スレッドの回復の処理の流れを次の図に示します。

図11‒1　UAP内の障害発生時のスレッドの回復

(2)　通信障害またはリソースマネジャの障害発生時のスレッドの回復

通信障害またはリソースマネジャの障害が発生してトランザクションが決着できなかった場合は，次に示す処理を行い，決着できなかったトランザクション情報をUAPに渡します。

UAP処理リターン後の同期点処理で障害が発生した場合

処理スレッドは，エラートランザクション（ERRTRNR）を起動します。

ライブラリ関数（ee_trn_chained_commit関数，ee_trn_chained_rollback関数）による同期点処理（コミットまたはロールバック）で障害が発生した場合

ライブラリ関数がエラーリターンします。

その後，通信障害監視機能またはリソースマネジャ障害監視機能を使用して，障害の回復を監視し，障害が回復すると回復スレッドでトランザクションの回復処理をします。

UAP処理リターン後の同期点処理でリソースマネジャの障害が発生した場合のスレッドの回復の処理の流れを次の図に示します。

図11‒2　UAP処理リターン後の同期点処理でのリソースマネジャの障害発生時のスレッドの回復

11.1.2　プロセスの回復

TP1/EEがプロセスダウンした場合は，ステータスファイルの情報を基にプロセスを回復します。仕掛り中のすべてのトランザクションは，プロセスダウン時点のトランザクションの情報を基に回復します。

プロセスの回復には，ディレード回復とアンディレード回復の2種類の処理があります。プロセスの回復の種類は，トランザクション関連定義のtrn_delayed_allrecoverオペランドで指定できます。

(1)　ディレード回復

ディレード回復は，すべての未決着トランザクションについて，回復スレッドに回復処理要求をします。ただし，回復スレッドのトランザクションの決着処理の完了を待たないでオンラインの開始処理をします。このため，初期化トランザクションの起動以降に，前回のオンライン時のトランザクションが決着することがあります。

(2)　アンディレード回復

アンディレード回復は，すべての未決着トランザクションについて，回復スレッドに回復処理要求をします。回復スレッドがすべてのトランザクションの決着処理を完了するのを待ってオンラインの開始処理をします。そのため，初期化トランザクションの起動時には，前回のオンライン時のトランザクションはすべて決着しています。

アンディレード回復は，すべてのトランザクションの決着を待ってからオンラインの開始処理をします。回復処理中のトランザクションの件数は，一定時間ごとに表示されます。回復処理中にほかのプロセスとの通信障害またはリソースマネジャの障害が発生すると，回復処理中のトランザクションの決着に時間が掛かることがあります。トランザクションの回復処理を続行するかどうかはユーザが決定します。回復処理を中断させる場合は，eesvstopコマンドを実行してTP1/EEを強制停止してください。この場合は，次回のTP1/EE起動時にプロセスを回復するかどうかを決定する必要があります。

アンディレード回復を実行する場合，トランザクション関連定義のtrn_undelayed_recover_threadオペランドにYを指定すると，回復スレッドと処理スレッドの両方を使用してプロセスを回復させることができます。回復スレッドだけではなく処理スレッドも使用することによって，アンディレード回復処理に掛かる時間を短縮できます。

(3)　プロセスの回復中に障害が発生した場合

プロセスの回復中に障害が発生すると，再度プロセスダウンするため，プロセスダウンとプロセスの回復が繰り返し実行されるおそれがあります。そのため，TP1/EE内で単位時間内に3回障害が発生した場合は，プロセスの回復を抑止します。また，UAP内で障害が発生した場合は，トランザクションサービスの閉塞処理をします。この場合，プロセスダウンしたときは，閉塞状態を引き継いで，障害の発生したサービスの異常終了を防ぎます。

(4)　1相最適化の実行中にプロセスダウンしたときのプロセスの回復

トランザクションが1相最適化を実行しているときにプロセスダウンが発生すると，プロセスの回復処理では，ロールバックに決着したメッセージを出力します。しかし，タイミングによってはコミットしている場合があります。

11.1.3　回復処理で使用するステータスファイル

TP1/EEは，ステータスファイルの情報を基に未決着トランザクションを回復します。ステータスファイルにはトランザクション情報が出力されています。トランザクション情報を取得するステータスファイルの種類を次の表に示します。

表11‒1　トランザクション情報を取得するステータスファイルの種類

種別

説明

CJ

開始CJ

トランザクション開始時に取得するステータスファイル

同期点開始CJ

1相目処理開始時（xa_prepare関数を呼び出す前）に取得するステータスファイル

HJ

非ルートトランザクションブランチで1相目処理が完了し，レディー応答送信前に取得するステータスファイル

PJ

ルートトランザクションブランチの場合

1相目処理完了時に取得するステータスファイル

非ルートトランザクションブランチの場合

コミット要求を受信したときに取得するステータスファイル

TJ

トランザクション完了時に取得するステータスファイル

BJ

1相目処理で失敗した場合，またはUAPからのee_trn_chained_rollback関数の呼び出しでロールバックする場合に，ee_trn_rollback_mark関数の呼び出し後の同期点処理時に取得するステータスファイル

DJ

ヒューリスティック決着するときに取得するステータスファイル

11.2　通信障害の対策

トランザクションブランチ間で通信障害が発生した場合，障害が発生した個所によっては，トランザクションを決着（コミットまたはロールバック）できないことがあります。

通信障害が発生した場合の処理について説明します。

11.2.1　通信障害監視

同期点処理でコミット要求に対する応答待ちタイムアウトなどの通信障害が発生した場合は，トランザクションを決着できません。そのため，通信障害監視スレッドに，通信先プロセスの障害回復監視を依頼します。通信障害監視スレッドは，通信先プロセスの回復を監視するために，通信障害が発生した通信先プロセスに対して，起動確認要求をします。通信障害監視スレッドは，通信先プロセスから起動確認応答を受信するまで，一定間隔で起動確認要求をします。起動確認応答を受信すると，回復スレッドがトランザクションを決着します。通信障害監視スレッドは，TP1/EEプロセスに一つ存在します。

11.2.2　通信障害監視スレッドの仕掛り中トランザクション監視

通信障害が発生したため，通信障害監視スレッドで障害回復を監視している場合は，トランザクション関連定義のtrn_recovery_failmsg_intervalオペランドに指定した時間間隔で，仕掛り中トランザクションの情報を出力します。仕掛り中トランザクションの情報は，KFSB40911-Wメッセージに出力されます。ただし，監視要因が発生してからKFSB40911-Wメッセージが出力される前に，トランザクションの回復処理が実行された場合は，KFSB40911-Wメッセージは出力されません。

11.3　リソースマネジャ障害の対策

TP1/EEは，トランザクション関連定義のtrnstring定義コマンドで指定したリソースマネジャと連携してトランザクションを実行しています。そのため，リソースマネジャへのアクセス（XAインタフェース）中に障害が発生した場合は，リソースマネジャが回復するまでトランザクションを決着（コミットまたはロールバック）できないことがあります。

リソースマネジャに障害が発生した場合の処理について説明します。

11.3.1　TP1/EE開始時のリソースマネジャ監視

TP1/EE開始時に，すべてのリソースマネジャに対してxa_recover関数を呼び出して，トランザクション未決着リストを取得します。ノード識別子が一致するTP1/EEが認識できない未決着トランザクションは，強制的にロールバックされます。

11.3.2　TP1/EEオンライン中のリソースマネジャ監視

xa関数を呼び出してリソースマネジャへアクセスしたときに障害を検知した場合は，トランザクションを決着できません。そのため，リソースマネジャ障害監視スレッドに，リソースマネジャの障害回復監視を依頼します。リソースマネジャ障害監視スレッドは，障害が発生したリソースマネジャに対して，xa_open関数を呼び出します。xa_open関数が正常リターンすると，回復スレッドでトランザクションを決着します。リソースマネジャ障害監視スレッドは，TP1/EEプロセスに一つ存在します。

11.3.3　リソースマネジャ障害監視スレッドの仕掛り中トランザクション監視

リソースマネジャで障害が発生したために，リソースマネジャ障害監視スレッドで障害回復を監視している場合は，トランザクション関連定義のtrn_recovery_failmsg_intervalオペランドに指定した時間間隔で，仕掛り中トランザクションの情報を出力します。仕掛り中トランザクションの情報は，KFSB40911-Wメッセージに出力されます。ただし，監視要因が発生してからKFSB40911-Wメッセージが出力される前に，トランザクションの回復処理が実行された場合は，KFSB40911-Wメッセージは出力されません。

11.4　TP1/EEの内部監視

TP1/EEは，システムの障害を検知するために，次の表に示す項目を監視しています。

表11‒2　TP1/EE監視項目一覧

監視項目

監視内容

関連する定義

問い合わせ時間間隔

rapクライアントでの応答待ち時間間隔

常設コネクション確立・解放要求メッセージの送信，または代理実行要求メッセージの送信から，応答メッセージを受信するまでの時間を監視します。

rapサーバでの問い合わせ時間間隔

常設コネクション確立応答メッセージの送信，または代理実行応答メッセージの送信から，次の要求メッセージを受信するまでの時間を監視します。

RPC関連定義

連続異常終了限界経過時間

TP1/EEの連続異常終了の時間を監視します。

TP1/Server Baseのプロセスサービス定義

トランザクション処理時間

トランザクションブランチの開始から，同期点処理の終了までの経過時間を監視します。

トランザクション関連定義

トランザクションブランチ同期点処理時の最大通信待ち時間

トランザクションブランチの同期点処理のプリペア，コミット，またはロールバックの応答受信待ち時間を監視します。

トランザクション関連定義

処理キューの滞留

処理キューに滞留するサービス要求を，一定の時間間隔で監視します。

プロセス関連定義

スレッドハングアップ時間

メインスレッド，モニタスレッド以外のスレッドのハングアップ時間を監視します。

プロセス関連定義

I/O処理時間

TP1EEファイルシステムのI/O処理時間を監視します。

ファイルサービス関連定義

11.4.1　問い合わせ時間間隔監視

問い合わせ時間間隔監視には，rapクライアントでの監視とrapサーバでの監視があります。それぞれの監視処理について説明します。

(1)　rapクライアントでの応答待ち時間間隔監視

常設コネクション確立・解放要求メッセージの送信，または代理実行要求メッセージの送信から，応答メッセージを受信するまでの時間を監視します。

要求メッセージを送信したあと，次に示すようにオペランドに指定した時間を過ぎても応答メッセージを受信しなかった場合は，KFSB50381-Eメッセージを出力して，TCPコネクションを切断します。

RPC関連定義のrpc_rap_watch_timeオペランドに指定した時間を過ぎても常設コネクション確立・解放応答メッセージを受信しなかった場合

RPC関連定義のwatch_timeオペランドに指定した時間を過ぎても代理実行応答メッセージを受信しなかった場合

(2)　rapサーバでの問い合わせ時間間隔監視

常設コネクション確立応答メッセージの送信，または代理実行応答メッセージの送信から，次の要求メッセージを受信するまでの時間を監視します。RPC関連定義のrap_inquire_timeオペランドに指定した時間を過ぎても要求メッセージを受信しなかった場合は，エラーメッセージを出力し，常設コネクション解放応答メッセージを送信します。その後，TCPコネクションを切断します。エラーメッセージを出力するかどうかは，rap_inquire_timeout_messageオペランドで指定できます。

なお，問い合わせ時間間隔監視は，定期的に起動するインタバルタイマトランザクションで監視するため，インタバルタイマトランザクション起動間隔分の誤差が発生することがあります。

11.4.2　連続異常終了限界経過時間監視

TP1/Server Baseのプロセスサービス定義のterm_watch_timeオペランドに指定した連続異常終了限界経過時間内に，TP1/EEが3回異常終了すると，TP1/EEはスケジュール閉塞します。

スケジュール閉塞したTP1/EEは，eesvstopコマンドで終了させてください。その後，TP1/EEを開始する場合は，eesvstartコマンドを実行してください。スケジュール閉塞したTP1/EEに対して，TP1/Server Baseのscdrlesコマンドを実行して再開始しようとすると，TP1/EEのプロセス関連定義のterm_watch_timeオペランドに指定した連続異常終了限界経過時間によって，TP1/EEの開始直後にTP1/EEが終了するおそれがあります。

11.4.3　トランザクション処理時間監視

トランザクション処理時間監視では，トランザクションブランチの開始から，同期点処理の終了までの経過時間を監視します。

トランザクション処理監視時間は，トランザクション関連定義のtrn_expiration_timeオペランド，trn_expiration_time_**オペランド（**は小文字のトランザクション種別），またはユーザサービス関連定義のservice_attr定義コマンドで指定します。トランザクション処理監視時間を過ぎても同期点処理が終了していない場合は，モニタスレッドから処理スレッドに対してシグナルが渡されます。この場合，TP1/EEはスレッド制御によってプロセスダウンまたはスレッドダウンします。

なお，TP1/EEのトランザクションに関する時間監視の詳細については，「付録C　トランザクションの時間監視」を参照してください。

(1)　トランザクション処理監視時間の変更

トランザクション処理の監視時間は，コマンドまたは関数で変更できます。

コマンドで変更する場合

eetrntimコマンドを使用して，次のどちらかの方法で指定したトランザクション処理の監視時間を変更します。

トランザクション関連定義のtrn_expiration_timeオペランドで指定

トランザクション関連定義のtrn_expiration_time_**オペランドで指定

eetrntimコマンドを実行すると，コマンドの実行後に起動されるトランザクション処理の監視時間を変更できます。eetrntimコマンド実行時の，実行中のトランザクション処理の監視時間は変更できません。

関数で変更する場合

ee_trn_set_exp_time関数を使用して，次のどれかの方法で指定したトランザクション処理の監視時間を変更します。

トランザクション関連定義のtrn_expiration_timeオペランドで指定

トランザクション関連定義のtrn_expiration_time_**オペランドで指定

ユーザサービス関連定義のservice_attr定義コマンドで指定

ee_trn_set_exp_time関数を呼び出すと，実行中のトランザクション処理の監視時間を，関数で指定した監視時間で再開始できます。ee_trn_set_exp_time関数を呼び出す前のトランザクション処理時間監視は，無効になります。

ee_trn_set_exp_time関数を使用した変更は，ee_trn_set_exp_time関数を呼び出したトランザクションだけに有効です。また，ee_trn_set_exp_time関数は，同一トランザクション内で2回以上呼び出すことはできません。

(2)　注意事項

TP1/EEのトランザクション処理監視時間には，次に示すHiRDBサーバのSQLタイムアウト値よりも大きな値を指定してください。

HiRDBのクライアント環境定義のPDCWAITTIMEオペランドの値

TP1/Server Baseのユーザサービス定義のputenv形式またはdcputenv形式で指定する，HiRDBの環境変数のPDSWAITTIME

TP1/EEのトランザクション処理監視時間にHiRDBのSQLタイムアウト値よりも小さい値を指定すると，トランザクション経過時間監視によってスレッドダウンが多発した場合に，スレッドが保有していたHiRDBのリソースが解放されません。このため，リソース不足が原因となってTP1/EEがプロセスダウンすることがあります。

11.4.4　トランザクションブランチ同期点処理時の最大通信待ち時間監視

トランザクションブランチの同期点処理のプリペア，コミット，またはロールバックの応答受信待ち時間を監視します。トランザクション関連定義のtrn_watch_timeオペランドに指定した時間を過ぎても応答を受信できない場合は，該当するトランザクションブランチが2相コミットの1相目完了前のときはロールバックします。該当するトランザクションブランチが2相コミットの1相目完了後のときは回復スレッドでトランザクションを決着します。

トランザクション処理時間監視およびトランザクションブランチ同期点処理時の最大通信待ち時間監視の範囲を，次の図に示します。

図11‒3　トランザクション処理時間監視およびトランザクションブランチ同期点処理時の最大通信待ち時間監視の範囲

なお，TP1/EEのトランザクションに関する時間監視の詳細については，「付録C　トランザクションの時間監視」を参照してください。

11.4.5　処理キューの滞留監視

オンライン中に，プログラムループ，デッドロック，各種テーブルの不当な破壊などが発生すると，トランザクション処理が進まないため，オンラインシステムの処理を続行できない場合があります。

このような異常を早期に検知するために，処理キューに滞留するサービス要求を一定の時間間隔で監視する機能を，処理キューの滞留監視機能といいます。処理キューの滞留監視機能を使用すると，オンラインの再開始を速やかに処理できます。処理キューは，次に示すような流れで滞留します。

何らかの理由によってサービス要求の処理が遅れる。

処理キューからのサービス要求の取り出しが遅れる。

サービス要求が処理キューに滞留する。

処理キューの滞留監視時に，オンライン打ち切りと判定された場合は，KFSB60802-EメッセージおよびKFSB65380-Eメッセージを出力し，TP1/EEをプロセスダウン（強制停止）させます。

(1)　指定するオペランド

処理キューの滞留監視機能を使用するには，次に示すプロセス関連定義のオペランドをすべて指定してください。

stay_watch_check_intervalオペランド

滞留している処理キューを監視する時間の間隔（処理キュー滞留監視間隔時間）を指定します。

stay_watch_queue_rateオペランド

オンラインを打ち切るかどうかの判定を開始する際の判断になる，処理キュー滞留率のしきい値を指定します。

処理キュー滞留率とは，次に示す計算式から算出される滞留率です。

処理キュー滞留率＝（プロセス全体の処理キュー滞留数÷処理キュー確保数）×100

stay_watch_down_rateオペランド

オンラインを打ち切るかどうかの判定で使用する，オンライン打ち切り係数を指定します。オンライン打ち切り係数とは，処理キューの滞留監視で使用する処理キュー処理率の低下を判断するしきい値です。

処理キュー処理率とは，次に示す計算式から算出される処理率です。

処理キュー処理率＝（前回監視時から今回監視時までの処理キュー処理数÷前回監視時のプロセス全体での処理キュー滞留数）×100

これらのオペランドのどれか一つでも省略した場合は，KFSB40802-Wメッセージを出力し，処理キューの滞留監視機能を使用しないで処理を続けます。これらのオペランドのすべてを省略した場合は，KFSB40802-Wメッセージを出力しません。

注意事項

処理キューの滞留監視機能を使用するときに指定するしきい値の指定によっては，ノード間負荷バランス機能で使用する負荷レベルがLEVEL2になる前にプロセスダウンするおそれがあります。このため，処理キューの滞留監視機能を使用するためのオペランドには，ノード間負荷バランス機能を考慮した値を指定してください。

(2)　処理キューの滞留監視の処理の流れ

処理キューの滞留監視の処理の流れを説明します。

プロセス関連定義のstay_watch_check_intervalオペランドで指定した値を基に，一定の時間間隔で処理キューを監視します（通常監視区間）。

処理キュー滞留率が，プロセス関連定義のstay_watch_queue_rateオペランドの指定値以上になった時点で，オンライン打ち切り監視判定区間に入り，オンライン打ち切り判定を開始します。オンライン打ち切り判定では，次に示すオンライン打ち切り判定式によって処理キューの滞留状況を判定します。

オンライン打ち切り判定式

    Sn-1※1 ＜ オンライン打ち切り係数 × Pn-1※2

注※1　前回監視時から今回監視時までの処理キュー処理数です。

注※2　前回監視時の処理キュー滞留数です。

オンライン打ち切り判定後の処理を次に示します。

オンライン打ち切り判定式が成立しない場合

処理を続行します。

オンライン打ち切り判定式が成立した場合

KFSB60802-EメッセージおよびKFSB65380-Eメッセージを出力し，TP1/EEをプロセスダウンさせます。

メッセージを出力したあとにトラブルシュート情報を取得するため，プロセスダウンするまでに時間が掛かることがあります。

TP1/EEがプロセスダウンした場合は，同一ノード内でTP1/EEプロセスを再開始します。待機系にあるTP1/EEに切り替えたい場合は，TP1/Server Baseのユーザサービス定義のcriticalオペランドにYを指定してください。

オンライン打ち切り判定のチェックポイントの処理キュー滞留率が，プロセス関連定義のstay_watch_queue_rateオペランドの指定値以上の間は，オンライン打ち切り監視判定区間のまま，処理を続行します。

オンライン打ち切り判定のチェックポイントの処理キュー滞留率が，プロセス関連定義のstay_watch_queue_rateオペランドの指定値未満になった場合は，オンライン打ち切り監視判定を終了して1.の処理に戻ります。

(3)　処理の流れの例

プロセス関連定義の各オペランドで次のように指定した場合の処理キューの滞留監視の処理の流れを図11-4に示します。

プロセス関連定義

stay_watch_check_interval=60（秒）

stay_watch_queue_rate=60（％）

stay_watch_down_rate=20（％）

処理キュー確保数は，100個とします（メモリ関連定義のpce_noオペランドで指定）。

図11‒4　処理キューの滞留監視機能の処理の例

オンライン打ち切り監視判定のチェックポイント（Cn）ごとに説明します。処理キューの滞留監視は，プロセス関連定義のstay_watch_check_intervalオペランドに60を指定しているため，60秒ごとに実施します。

C₁の処理

処理キュー滞留数（P₁）が60個，処理キュー滞留率が60％で，プロセス関連定義のstay_watch_queue_rateオペランドの指定値以上になったため，オンライン打ち切り監視判定区間に入り，オンライン打ち切り判定を開始します。

C₂の処理

処理キュー滞留数（P₂）が75個，処理キュー滞留率が75％で，プロセス関連定義のstay_watch_queue_rateオペランドの指定値以上のため，オンライン打ち切り監視判定区間のまま，次に示す値でオンライン打ち切り判定を実施します。

C₁からC₂までの処理キュー処理数（S₁）：13個

C₁時点の処理キュー滞留数（P₁）：60個

C₁からC₂までの処理キュー処理数が，C₁時点の処理キュー滞留数（P₁）にオンライン打ち切り係数を掛けた値より大きい（前回から滞留している処理キューの個数が，前回から滞留したままとなってもオンラインを継続できる処理キュー数の上限値を超えない）ため，オンライン打ち切り判定式が成立しません。

このため，オンライン打ち切り監視判定区間のまま，処理を続行します。

C₃の処理

処理キュー滞留数（P₃）が70個，処理キュー滞留率が70％で，プロセス関連定義のstay_watch_queue_rateオペランドの指定値以上のため，オンライン打ち切り監視判定区間のまま，次に示す値でオンライン打ち切り判定を実施します。

C₂からC₃までの処理キュー処理数（S₂）：14個

C₂時点の処理キュー滞留数（P₂）：75個

C₂からC₃までの処理キュー処理数が，C₂時点の処理キュー滞留数（P₂）にオンライン打ち切り係数を掛けた値より小さい（前回から滞留している処理キューの個数が，前回から滞留したままとなってもオンラインを継続できる処理キュー数の上限値を超える）ため，オンライン打ち切り判定式が成立します。

このため，オンラインを打ち切り，KFSB60802-EメッセージおよびKFSB65380-Eメッセージを出力し，TP1/EEをプロセスダウンさせます。

C₄の処理（C₃の時点で処理キュー処理率が低下しなかった場合）

処理キュー滞留数（P₄）が59個，処理キュー滞留率が59％で，プロセス関連定義のstay_watch_queue_rateオペランドの指定値未満になったため，オンライン打ち切り監視判定を終了します。

C₅以降の処理

オンライン打ち切り監視判定を終了したあとも，60秒ごとに処理キューの滞留監視を実施します。

(4)　サービスの閉塞による処理キューの引き出し禁止

処理キューを引き出し禁止に設定している場合（ユーザサービス関連定義のforbid_draw_serviceオペランドにYを指定），サービスの閉塞時に処理キューの滞留監視機能が停止します。

すべてのサービスの閉塞が解除されたあと，処理キューの滞留監視を再開します。また，処理キュー滞留監視間隔時間にサービスの閉塞，閉塞解除が行われた場合は，次回のチェックポイントで通常監視状態から開始します。

11.4.6　スレッドハングアップ時間監視

メインスレッド，モニタスレッド以外のスレッドのハングアップ時間を監視します。プロセス関連定義のthd_hungup_timeオペランドに指定した時間を過ぎてもスレッドが停止している場合は，KFSB55350-Eメッセージを出力し，保護区／非保護区の設定に従ってプロセスダウンまたはスレッドダウンします。

スレッドハングアップ時間監視の範囲を次の図に示します。

図11‒5　スレッドハングアップ時間監視の範囲

11.4.7　I/O処理時間監視

I/O処理時間監視では，トランザクション処理でのTP1EEファイルシステムのI/O処理時間を監視します。トランザクション処理ではない場合のTP1/EE開始時および終了時のI/O処理は監視しません。

TP1EEファイルシステムのI/O処理監視時間は，ファイルサービス関連定義のfil_watch_timeオペランドで指定します。fil_watch_timeオペランドに指定した時間を超えた場合，TP1/EEは，ファイルサービス関連定義のfil_watch_timeoutオペランドの指定に従って動作します。

なお，TP1/EEのトランザクションに関する時間監視の詳細については，「付録C　トランザクションの時間監視」を参照してください。

(1)　I/O処理時間監視での監視範囲

I/O処理時間監視での監視範囲は，トランザクション処理でのTP1EEファイルシステムへのI/O処理時間，およびI/O処理の待ち時間を監視します。I/O処理の待ち時間とは，ほかのトランザクションが処理しているTP1EEファイルシステムへのI/O処理が完了するのを待つ時間のことです。

I/O処理時間監視の監視範囲を次の図に示します。

図11‒6　I/O処理時間監視の監視範囲

図中のtについて次に説明します。

t1：fil_watch_time（TP1EEファイルシステムのI/O処理監視時間）

UAP1のトランザクション処理でのTP1EEファイルシステムへのI/O処理時間を監視します。

t2：fil_watch_time（TP1EEファイルシステムのI/O処理監視時間）

UAP2ではI/O処理の待ち時間が発生するため，トランザクション処理でのTP1EEファイルシステムへのI/O処理時間とI/O処理の待ち時間を監視します。

(2)　トランザクション処理とI/O処理の監視範囲，およびステータスファイルの排他範囲

トランザクション処理とI/O処理の監視範囲，およびステータスファイルの排他範囲を次の図に示します。

図11‒7　トランザクション処理とI/O処理の監視範囲，およびステータスファイルの排他範囲

図中のtについて次に説明します。

t1：trn_expiration_time，trn_expiration_time_**またはservice_attr（トランザクション処理監視時間）

トランザクションブランチの開始から，同期点処理の終了までの経過時間を監視します。監視対象区間は，t1_1，t1_2，t1_3，およびt1_4で示す区間を合計したものです。

t2：fil_watch_time（TP1EEファイルシステムのI/O処理監視時間）

TP1EEファイルシステムへのI/O処理（読み込み処理および書き込み処理）を開始してから完了するまでの経過時間を監視します。

注※

**には，小文字のトランザクション種別が入ります。

(3)　トランザクション処理でのTP1EEファイルシステムへのI/O

ファイルサービス関連定義のfil_watch_timeオペランドを指定するときに考慮する，トランザクション処理でのTP1EEファイルシステムへのI/O回数と，I/Oサイズについて説明します。

(a)　TP1EEファイルシステムへのI/O回数

正常なトランザクションの場合，1トランザクション当たりのTP1EEファイルシステムへのI/O処理回数は，次の表に示す回数が目安となります。

表11‒3　TP1EEファイルシステムへのI/O処理回数の目安

項番

同期点処理の方法

I/O処理の回数

1

1相最適化をするトランザクション

4〜6

2

2相コミットをする場合の，親トランザクションブランチ

8〜12

3

2相コミットをする場合の，子トランザクションブランチ

10〜15

4

スワップが発生した場合のトランザクション（スワップ処理部分だけ）※1

次に示す計算式で求めます。

（7＋↑a／b↑×3）×c

5

別トランザクションによるRPC同期応答機能（ee_rpc_reply_suspend関数）を使用したトランザクション※2

RPC関連定義のrpc_reply_suspend_recoverオペランドにNを指定した場合：2〜3

RPC関連定義のrpc_reply_suspend_recoverオペランドにNを指定しない場合：4〜6

6

別トランザクションによるRPC同期応答機能（ee_rpc_reply_send関数）を使用したトランザクション※2

RPC関連定義のrpc_reply_suspend_recoverオペランドにNを指定した場合：0

RPC関連定義のrpc_reply_suspend_recoverオペランドにNを指定しない場合：2〜3

（凡例）

a：eestsinitコマンドの-cオプションの指定値です。

b：ステータスファイル関連定義のsts_buffer_countオペランドの指定値です。

c：同じファイルグループ番号を，ステータスファイル関連定義のstsflgrp定義コマンドの-gオプションに指定した個数から，1を引いた値です。スワップ先でのI/O処理中に障害が発生しない場合，cは1となります。

↑↑：小数点以下を切り上げます。

注※1

スワップ処理以外のI/O処理の回数については，項番1〜3を参照してください。

注※2

項番1〜3の回数に加算してください。

なお，ステータスファイル関連定義のsts_buffer_countオペランドで確保したバッファ内に前回の書き込み要求の情報が残っている場合，読み込み要求が不要となり，I/O処理回数を削減できます。例えば，1相最適化をするトランザクションであれば，I/O処理回数は4回となります。トランザクション制御機能が使用する情報がすべてバッファ内に納まるように，sts_buffer_countオペランドを指定することをお勧めします。

(b)　TP1EEファイルシステムへのI/Oサイズ

トランザクション処理でのTP1EEファイルシステムへのI/Oサイズは，スワップが発生したときに最大となります。最大I/Oサイズは，次の表に示すサイズが目安となります。

表11‒4　TP1EEファイルシステムへの最大I/Oサイズの目安

条件

最大I/Oサイズ（単位：バイト）

OSがLinuxの場合に，キャラクタ型スペシャルファイルまたはブロック型スペシャルファイルを使用している

65536

a×c≧a×b

a×b

a×c＜a×b

a×c

（凡例）

a：eestsinitコマンドの-sオプションの指定値です。

b：eestsinitコマンドの-cオプションの指定値です。

c：ステータスファイル関連定義のsts_buffer_countオペランドの指定値です。

11.5　TP1EEファイル障害

TP1EEファイルに障害が発生した場合の対処方法を説明します。

11.5.1　ステータスファイルの障害

ステータスファイルに障害が発生した場合の対処方法を説明します。

(1)　制御用ステータスファイルの障害

制御用ステータスファイルの障害対策について説明します。

(a)　オンライン開始時

オンライン開始時に制御用ステータスファイルに障害が発生した場合の障害対策について説明します。ステータスファイル関連定義の指定によって，対処方法が異なります。

sts_initial_error_switchオペランドにstopを指定した場合

ステータスファイル関連定義のsts_initial_error_switchオペランドにstopを指定，または指定を省略した場合は，ステータスファイルに障害が発生したとき，TP1/EEを停止します。システム定義に指定したステータスファイルに一つでも障害があれば，TP1/EEを開始しません。対処方法は，障害が発生したファイルによって異なります。

障害が発生したファイルが前回の現用ファイルの場合

A系，B系の現用ファイルが両方とも障害となった場合，次の手順でTP1/EEを開始してください。ただし，システム制御情報は引き継げません。

障害ファイルを回復します。

障害ファイルを回復する方法については，「(c)　障害ファイルの回復方法および予備ファイルの作成方法」を参照してください。

TP1/EEをeesvstartコマンドの-a　Nオプションで強制的に正常開始します。

開始時に，回復したステータスファイルがオープンされ，予備ファイルになります。

A系，B系の現用ファイルのどちらか片方だけが障害となった場合，次の手順でTP1/EEを開始してください。

現用ファイルをスワップするための予備ファイルがあるかどうかを確認します。予備ファイルがない場合は，予備ファイルを作成します。

予備ファイルを作成する方法については，「(c)　障害ファイルの回復方法および予備ファイルの作成方法」を参照してください。

ステータスファイル関連定義のsts_initial_error_switchオペランドの指定をcontinueに変更します。

TP1/EEを再開始します。

障害ファイルを回復し，予備ファイルにします。

障害ファイルを回復する方法については，「(c)　障害ファイルの回復方法および予備ファイルの作成方法」を参照してください。

障害が発生したファイルが前回の現用ファイルではない場合

障害が発生したステータスファイルの実体がある場合，次の手順でTP1/EEを開始してください。

障害が発生して閉塞したステータスファイルをeestsrmコマンドで削除します。

削除したステータスファイルをeestsinitコマンドで初期設定して，障害を回復します。

TP1/EEを再開始します。

開始時に，回復したステータスファイルがオープンされ，予備ファイルになります。

障害が発生したステータスファイルの実体がない場合，次の手順でTP1/EEを開始してください。

障害が発生したステータスファイルをeestsinitコマンドで初期設定して，障害を回復します。

TP1/EEを再開始します。

開始時に，回復したステータスファイルがオープンされ，予備ファイルになります。

sts_initial_error_switchオペランドにcontinueを指定した場合

ステータスファイル関連定義のsts_initial_error_switchオペランドにcontinueを指定した場合は，ステータスファイルに障害が発生しても処理を続行します。

なお，TP1/EEは，再開始時にオープンできたファイルの中からいちばん新しい現用決定時刻を持つファイルを現用ファイルと決定します。しかし，次に示す場合，現用と決定したファイルが本当に前回の現用ファイルであるかどうか，TP1/EEは判断できません。

両系ともオープンできないファイルが一組でもある場合

前回のオンラインが片系運転で，片系がオープンできないファイルが一組でもある場合

したがって，このような場合，ステータスファイル関連定義のstsflgrp定義コマンドに，次に示す項目を指定しておくことで，TP1/EEが決定した現用ファイルが最新の現用ファイルかどうかを調べることができます。

stsflgrp定義コマンドの-lオプション

前回のオンラインで最新の現用ファイルだった論理ファイルの名称を指定します。

stsflgrp定義コマンドの-kオプション

前回のオンラインで最新の現用ファイルが片系運転だった場合，正常に稼働していた系を指定します。

TP1/EEが決定した現用ファイルが上記のstsflgrp定義コマンドの指定値と一致した場合，開始処理を続行します。一致しなかった場合，開始処理を停止します。「(b)　オンライン中」を参照して，A系，B系の現用ファイルが両方とも障害となった場合と同様に対処してください。stsflgrp定義コマンドの指定がなく，正しい現用ファイルかどうか判断できなかった場合も，開始処理を停止します。stsflgrp定義コマンドを指定してTP1/EEを開始してください。

また，stsflgrp定義コマンドの-kオプションの指定があり，かつ両系がオープンできた場合，stsflgrp定義コマンドの-kオプションに指定された系の情報を現用と見なして，もう一方の系に複写後，再開始します。

最新の現用ファイルの片系に障害が発生した場合は，正常な系の内容を予備ファイルのA系とB系に複写します。複写後，現用ファイルと予備ファイルを切り替えて，処理を続行します。障害ファイルを回復し，予備ファイルにしてください。ただし，複写できる予備ファイルがない場合の処理は，ステータスファイル関連定義の指定によって異なります。

sts_single_operation_switchオペランドにstopを指定した場合

ステータスファイル関連定義のsts_single_operation_switchオペランドにstopを指定，または指定を省略した場合は，ステータスファイルに障害が発生したとき，TP1/EEを停止します。次の手順でTP1/EEを開始してください。

現用ファイルをスワップするための予備ファイルがあるかどうかを確認します。予備ファイルがない場合は，予備ファイルを作成します。

予備ファイルを作成する方法については，「(c)　障害ファイルの回復方法および予備ファイルの作成方法」を参照してください。

TP1/EEを再開始します。

障害ファイルを回復し，予備ファイルにします。

障害ファイルを回復する方法については，「(c)　障害ファイルの回復方法および予備ファイルの作成方法」を参照してください。

sts_single_operation_switchオペランドにcontinueを指定した場合

ステータスファイル関連定義のsts_single_operation_switchオペランドにcontinueを指定した場合は，ステータスファイルに障害が発生しても正常な系だけで処理を続行します。「(c)　障害ファイルの回復方法および予備ファイルの作成方法」を参照して障害を回復し，予備ファイルにしてください。

片系運転中にTP1/EEが異常終了した場合は，次の手順でTP1/EEを開始してください。

現用ファイルをスワップするための予備ファイルがあるかどうかを確認します。予備ファイルがない場合は，予備ファイルを作成します。

予備ファイルを作成する方法については，「(c)　障害ファイルの回復方法および予備ファイルの作成方法」を参照してください。

ステータスファイル関連定義のsts_initial_error_switchオペランドの指定をcontinueに変更します。

ステータスファイル関連定義のstsflgrp定義コマンドの-lオプションに前回オンラインの現用ファイル名を指定し，-kオプションに正常な系を指定します。

TP1/EEを再開始します。

障害ファイルを回復し，予備ファイルにします。

障害ファイルを回復する方法については，「(c)　障害ファイルの回復方法および予備ファイルの作成方法」を参照してください。

sts_initial_error_switchオペランドにforceを指定した場合

ステータスファイル関連定義のsts_initial_error_switchオペランドにforceを指定した場合は，ステータスファイルに障害が発生しても処理を続行します。

なお，TP1/EEは，再開始時にオープンできたファイルの中からいちばん新しい現用決定時刻を持つファイルを現用ファイルと決定します。

最新の現用ファイルの片系に障害が発生した場合は，正常な系の内容を予備ファイルのA系とB系に複写します。その後，現用ファイルと予備ファイルを切り替えて，処理を続行します。「(c)　障害ファイルの回復方法および予備ファイルの作成方法」を参照して障害を回復し，予備ファイルにしてください。

複写できる予備ファイルがない場合は，正常な系だけで処理を続行します。「(c)　障害ファイルの回復方法および予備ファイルの作成方法」を参照して障害を回復し，予備ファイルにしてください。片系運転中にTP1/EEが異常終了した場合は，次の手順でTP1/EEを再開始してください。

TP1/EEを再開始します。

障害ファイルを回復し，予備ファイルにします。

障害ファイルを回復する方法については，「(c)　障害ファイルの回復方法および予備ファイルの作成方法」を参照してください。

注意事項

sts_initial_error_switchオペランドにforceを指定する場合は，A系とB系が別々のディスクとなるファイル構成にしてください。

A系とB系が同じディスクだと，ディスクに障害が発生した場合にA系とB系の両方をオープンできなくなり，正しく再開始できません。再開始時に誤った現用ファイルを決定する危険を少なくするため，sts_initial_error_switchオペランドにforceを指定する場合は，A系とB系が別々のディスクとなるファイル構成にしてください。

なお，再開始時に誤った現用ファイルを決定した場合，「(3)　誤ったステータスファイルを使用した場合の対応」を参照して対処してください。

sts_single_operation_switchオペランドにcontinueを指定した場合にだけ，sts_initial_error_switchオペランドにforceを指定できます。sts_initial_error_switchオペランドにforceを指定することによって，片系運転中にTP1/EEが異常終了した場合に，stsflgrp定義コマンドの指定値を変更することなく再開始できます。ただし，再開始時に前回の現用ファイルをオープンできなかった場合に，現用ファイルの決定が正しくできなくなります。

強制正常開始（eesvstartコマンドの-a　Nオプションで指定）の場合は，ステータスファイル関連定義の指定に関係なく，両系ともオープンできたファイルが一組でもある場合，それを現用として処理を開始します。両系ともオープンできたファイルが一組もなかった場合は，TP1/EEは停止します。

(b)　オンライン中

オンライン中に制御用ステータスファイルに障害が発生した場合の障害対策について説明します。現用ファイルの両系に障害が発生した場合と片系に障害が発生した場合に分けられます。

A系，B系の現用ファイルが両方とも障害となった場合

TP1/EEを停止します。次の手順でTP1/EEを開始してください。ただし，システム制御情報は引き継げません。

予備ファイルがあるかどうかを確認します。予備ファイルがない場合は，予備ファイルを用意します。

予備ファイルを作成する方法については，「(c)　障害ファイルの回復方法および予備ファイルの作成方法」を参照してください。

eesvstartコマンドの-a　NオプションでTP1/EEを強制的に正常開始します。

障害ファイルを回復し，予備ファイルにします。

障害ファイルを回復する方法については，「(c)　障害ファイルの回復方法および予備ファイルの作成方法」を参照してください。

A系，B系の現用ファイルのどちらか片方だけが障害となった場合

予備ファイルがあるとき

TP1/EEは現用ファイルを予備ファイルにスワップします。その後，「(c)　障害ファイルの回復方法および予備ファイルの作成方法」を参照して障害を回復し，予備ファイルにしてください。

予備ファイルがないとき

sts_single_operation_switchオペランドにstopを指定した場合

ステータスファイル関連定義のsts_single_operation_switchオペランドにstopを指定，または指定を省略した場合は，ステータスファイルに障害が発生したとき，TP1/EEを停止します。次の手順でTP1/EEを開始してください。

予備ファイルを用意します。

予備ファイルを作成する方法については，「(c)　障害ファイルの回復方法および予備ファイルの作成方法」を参照してください。

ステータスファイル関連定義のsts_initial_error_switchオペランドの指定をcontinueに変更します。

TP1/EEを再開始します。

障害ファイルを回復し，予備ファイルにします。

障害ファイルを回復する方法については，「(c)　障害ファイルの回復方法および予備ファイルの作成方法」を参照してください。

sts_single_operation_switchオペランドにcontinueを指定した場合

ステータスファイル関連定義のsts_single_operation_switchオペランドにcontinueを指定した場合は，ステータスファイルに障害が発生しても正常な系だけで処理を続行します。「(c)　障害ファイルの回復方法および予備ファイルの作成方法」を参照して障害を回復し，予備ファイルにしてください。

片系運転中にTP1/EEが異常終了した場合は，「(a)　オンライン開始時」の，sts_single_operation_switchオペランドにcontinueを指定した場合，またはsts_initial_error_switchオペランドにforceを指定した場合の記述を参照して，TP1/EEを開始してください。

なお，TP1/EEは，TP1/EE起動中に発生した制御用ステータスファイル障害，およびオンライン中に障害が発生した現用ファイルの閉塞状態だけを再開始時に引き継ぎます。このため，オンライン中にeestsopenコマンドでオープンした状態，またはeestscloseコマンドでクローズした状態は引き継ぎません。また，TP1/EEは，オフライン中にeestsinitコマンドまたはeestsrmコマンドを実行したときのステータスファイルの状態を認識しません。

(c)　障害ファイルの回復方法および予備ファイルの作成方法

障害ファイルの回復方法および予備ファイルの作成方法を次に示します。

障害ファイルの回復方法

障害が発生したステータスファイルは，次の手順で障害を回復し，予備ファイルにしてください。

障害が発生して閉塞したステータスファイルをeestsrmコマンドで削除します。

削除したステータスファイルを，eestsinitコマンドで初期設定して回復します。

オンライン中の場合，初期設定したステータスファイルをeestsopenコマンドでオープンして，予備ファイルにします。オフライン中の場合，オンライン開始時にオープンされ，予備ファイルになります。

予備ファイルの作成方法

オンライン中にスワップによって予備ファイルが少なくなった場合

次のどれかの操作で予備ファイルを用意してください。

クローズ中の無効ファイルをeestsopenコマンドでオープンして予備ファイルにします。

実体のない無効ファイルをeestsinitコマンドで初期設定したあと，eestsopenコマンドでオープンして予備ファイルにします。

障害ファイルをeestsrmコマンドで削除し，eestsinitコマンドで初期設定したあと，eestsopenコマンドでオープンして予備ファイルにします。

オフライン中に予備ファイルを用意したい場合

次のどれかの操作を実行してください。オンライン開始時にオープンされ，予備ファイルになります。

クローズ中の無効ファイルの場合，オンライン開始時に予備ファイルになります。

実体のない無効ファイルをeestsinitコマンドで初期設定します。

障害ファイルをeestsrmコマンドで削除し，eestsinitコマンドで初期設定します。

(d)　現用ファイルが片系運転になった場合の対策

片系運転中に正常な系に障害が発生したり，ファイルの更新中に異常終了したりすると，TP1/EEを再開始できなくなります。そのため，現用ファイルが片系運転の状態になった場合，次のどちらかの方法に従って対策を実施し，両系運転の状態にしてください。

予備ファイルを用意してスワップする方法

現用ファイルを次の手順でスワップしてください。

予備ファイルを作成します。

予備ファイルを作成する方法については，「(c)　障害ファイルの回復方法および予備ファイルの作成方法」を参照してください。

eestsswapコマンドを実行して現用ファイルをスワップします。

障害が発生した系のファイルを回復する方法

障害が発生して閉塞したファイルを次の手順で回復してください。

障害が発生して閉塞した系のステータスファイルを回復します。

障害ファイルを回復する方法については，「(c)　障害ファイルの回復方法および予備ファイルの作成方法」を参照してください。

回復したステータスファイルをeestsopenコマンドでオープンします。

eestsopenコマンドを実行すると，正常な系のファイルの内容が，障害が発生した系のファイルに複写されます。複写が完了した時点で，現用決定時刻を新たに取得し，現用ファイルとして回復します。

(2)　シグナル用ステータスファイルの障害

シグナル用ステータスファイルの障害対策について説明します。シグナル用ステータスファイルの障害は，現用ファイルの両系に障害が発生した場合と片系に障害が発生した場合に分けられます。

(a)　A系，B系の現用ファイルが両方とも障害となった場合

TP1/EEを停止します。次の手順でTP1/EEを開始してください。ただし，システム閉塞情報は引き継げません。

障害ファイルを回復します。

障害ファイルを回復する方法については，「(c)　障害ファイルの回復方法」を参照してください。

TP1/EEを開始します。

(b)　A系，B系の現用ファイルのどちらか片方だけが障害となった場合

正常な系だけで処理を続行します。「(c)　障害ファイルの回復方法」を参照して，障害ファイルを回復してください。ステータスファイル関連定義の指定によって，次回オンライン開始時の対処方法が異なります。

sts_initial_error_switchオペランドにstopまたはcontinueを指定した場合

ステータスファイル関連定義のsts_initial_error_switchオペランドにstop，continueを指定，または指定を省略した場合は，ステータスファイルに障害が発生したとき，TP1/EEを停止します。次の手順でTP1/EEを開始してください。

ステータスファイル関連定義のstsflgrp定義コマンドの-kオプションに正常な系を指定します。

TP1/EEを開始します。

障害ファイルを回復します。

障害ファイルを回復する方法については，「(c)　障害ファイルの回復方法」を参照してください。

再開始時，stsflgrp定義コマンドの-kオプションに指定した系を現用と見なし，処理します。指定した系がオープンできないと，TP1/EEを停止します。「(a)　A系，B系の現用ファイルが両方とも障害となった場合」を参照して，A系，B系の現用ファイルが両方とも障害となった場合と同様に対処してください。

再開始時，stsflgrp定義コマンドの-kオプションの指定がない場合は，TP1/EEを停止します。stsflgrp定義コマンドの-kオプションを指定して，TP1/EEを開始してください。

また，stsflgrp定義コマンドの-kオプションの指定があり，かつ両系がオープンできた場合，stsflgrp定義コマンドの-kオプションに指定された系の情報を現用と見なして，もう一方の系に複写後，再開始します。

sts_initial_error_switchオペランドにforceを指定した場合

ステータスファイル関連定義のsts_initial_error_switchオペランドにforceを指定した場合，TP1/EEを停止します。次の手順でTP1/EEを再開始してください。再開始時に，オープンできた系を現用と見なして処理をします。

TP1/EEを開始します。

障害ファイルを回復します。

障害ファイルを回復する方法については，「(c)　障害ファイルの回復方法」を参照してください。

なお，TP1/EEは，TP1/EE起動中に障害が発生したシグナル用ステータスファイルの閉塞状態だけを再開始時に引き継ぎます。また，TP1/EEは，オフライン中にeestsinitコマンドまたはeestsrmコマンドを実行したときのステータスファイルの状態を認識しません。なお，シグナル用ステータスファイルへは，プロセスダウン時に情報を格納するため，オンライン中に障害が発生することはありません。

(c)　障害ファイルの回復方法

シグナル用ステータスファイルに障害が発生した場合，次の手順で障害を回復してください。オンライン中でもオフライン中でも回復する方法は同じです。

障害が発生して閉塞したステータスファイルをeestsrmコマンドで削除します。

削除したステータスファイルをeestsinitコマンドで初期設定します。

今回のオンラインファイル中に現用ファイルとして復帰することはできませんが，次回のオンライン開始時に，現用ファイルとして使用できるようになります。

(3)　誤ったステータスファイルを使用した場合の対応

誤ったステータスファイルを使用してTP1/EEを開始した場合の影響と対策について説明します。

再開始時に，現用ステータスファイルが前回オンラインと同じものかどうかは，各オンラインで出力されるKFSB81000-IメッセージおよびKFSB81003-Iメッセージで表示する現用ステータス論理ファイル名によって判断してください。

(a)　システムステータス

開始モードが正しく判断できないことがあります。

再開始となるはずの条件下で正常開始となった場合，「(4)　システム制御情報を引き継げない場合の対応」を参照して対処してください。正常開始となるはずの条件下で再開始となった場合，TP1/EEを終了して強制正常開始をしてください。

(b)　システム定義情報

TP1/EEの再開始時に変更できないシステム定義の変更可否を正しく判定できないことがあります。

TP1/EEの再開始時に変更できないシステム定義を変更していなくてもKFSB51802-Eメッセージを出力してプロセスダウンした場合，強制正常開始をしてください。

TP1/EEの再開始時に変更できないシステム定義の詳細については，「7.3.2　再開始時に変更できない定義」を参照してください。

(c)　トランザクション情報

前回オンラインではトランザクション仕掛り中でTP1/EEプロセス終了後，誤ったステータスファイルで開始し，該当するトランザクションが仕掛り中でない場合

前回オンラインで仕掛り中だったトランザクションがリソースマネジャに残っていた場合，前回オンラインのトランザクション状態に関係なく強制的にロールバック決着を行います。

前回オンラインではトランザクション決着でTP1/EEプロセス終了後，誤ったステータスファイルで開始し，該当するトランザクションが仕掛り中だった場合

前回オンラインで決着済みのトランザクションについて，再度トランザクションの決着を行う場合があります。リソースマネジャとしては，すでにトランザクションを決着しているため，xa関数エラーのメッセージが表示される場合があります。ただし，トランザクションブランチ先があり，すでにブランチ先のプロセスが終了しているなどの原因によって通信ができない場合，トランザクションの決着ができないため，決着処理ができるまでリトライします。このとき，KFSB40911-Wメッセージが一定間隔で出力されるため，TP1/EEプロセスを強制終了させてから，強制正常開始をしてください。

前回オンラインではトランザクション仕掛り中でTP1/EEプロセス終了後，誤ったステータスファイルで開始し，該当するトランザクションが仕掛り中だった場合

誤ったステータスファイル情報を基にトランザクションを決着します。

(d)　サービス閉塞情報

サービス閉塞状態を正しく引き継げません。前回閉塞していないサービスを閉塞したり，前回閉塞したサービスを閉塞しないことがあります。

必要に応じて，eedctsvコマンドまたはeeactsvコマンドによってサービスを閉塞または閉塞解除してください。

(e)　DBキュー情報

DBキューサービス閉塞状態，DBキューの読み出し停止状態，およびDBキューサービスとDBキューの接続状態を引き継げません。前回閉塞していないサービスの閉塞，または前回閉塞したサービスを閉塞しないことがあります。必要に応じて，DBキュー制御コマンドを使用してDBキュー情報の照会，DBキューの読み出し停止，DBキューサービスの閉塞などの操作をしてください。DBキュー制御コマンドについては，「10.　運用コマンドの詳細」を参照してください。

(f)　RPC応答メッセージ送信抑止機能使用時のRPC情報

ee_rpc_reply_suspend関数を使用して，RPC応答メッセージ送信を抑止した場合，RPC応答メッセージ送信の抑止情報を正しく引き継げません。前回オンラインで抑止していたRPC応答メッセージを送信できないことや，前回オンラインで抑止していないRPC応答メッセージを送信することがあります。

RPC要求元のUAPが無制限にRPC応答待ちをしている場合，RPC応答メッセージを送信できないと，RPC要求元のUAPが終了しなくなります。必要に応じてUAPを強制終了させてください。強制終了させる方法は，RPC要求元のUAPの種類によって異なります。

(g)　ERRTRNRによるRPC応答メッセージ送信機能使用時のRPC情報

サービストランザクションのサービス関数がリターンしたときの同期点処理から，ERRTRNRによるRPC応答メッセージ送信までの間にプロセスダウンが発生した場合，RPC応答メッセージの送信先の情報を正しく引き継げません。前回オンライン時に，ERRTRNRによるRPC応答メッセージを送信できないことや，誤った送信先にERRTRNRによるRPC応答メッセージを送信することがあります。

RPC要求元のUAPが無制限にRPC応答待ちをしている場合，RPC応答メッセージを送信できないと，RPC要求元のUAPが終了しなくなります。必要に応じてUAPを強制終了させてください。強制終了させる方法は，RPC要求元のUAPの種類によって異なります。

(h)　ロールバックアボート時のRPC情報

応答型RPC中にロールバックアボートを発行した場合に採取するRPC応答メッセージ情報を正しく引き継げません。前回オンライン時にロールバックアボートでプロセスを終了させた場合にRPC応答メッセージが送信できないことや，前回オンライン時にロールバックアボートでプロセスを終了させていない場合でもRPC応答メッセージを送信することがあります。

RPC要求元のUAPが無制限にRPC応答待ちをしている場合，RPC応答メッセージを送信できないと，RPC要求元のUAPが終了しなくなります。必要に応じてUAPを強制終了させてください。強制終了させる方法は，RPC要求元のUAPの種類によって異なります。

(i)　サービスまたはトランザクションレベルの最大同時処理限界数

サービスまたはトランザクションレベルの最大同時処理限界数を正しく引き継げません。

前回オンラインで変更した最大同時処理限界数と異なる場合があります。

最大同時処理限界数を変更する必要がある場合は，サービスのときはeelspceコマンド，トランザクションレベルのときはeelstrnlevelコマンドで変更してください。eelspceコマンドについては，「10.　運用コマンドの詳細」の「eelspce」を参照してください。eelstrnlevelコマンドについては，TP1/FSPの関連ドキュメントを参照してください。

(j)　UAP共用ライブラリ格納ディレクトリ情報

UAP共用ライブラリ格納ディレクトリ情報を正しく引き継げません。

前回オンラインで変更したUAP共用ライブラリ格納ディレクトリと異なる場合があります。

UAP共用ライブラリ格納ディレクトリを変更する必要がある場合は，eechglibコマンドで変更してください。eechglibコマンドについては，TP1/FSPの関連ドキュメントを参照してください。

(k)　ユーザタイマの永続化機能のタイマ監視表情報

ユーザタイマの永続化機能のタイマ監視表情報を正しく引き継げません。

前回オンラインで変更したタイマ監視情報と異なる場合があります。

タイマ監視表情報を変更する必要がある場合は，eetimchownコマンドで変更してください。eetimchownコマンドについては，TP1/FSPの関連ドキュメントを参照してください。

(4)　システム制御情報を引き継げない場合の対応

A系，B系の現用ファイルが両方とも障害となるなどの原因によって，再開始時にシステム制御情報を引き継げなくなった場合，すべてのステータスファイルを削除したあとに再度ステータスファイルを作成してTP1/EEを開始するか，障害となったステータスファイルを回復させ，TP1/EEを強制正常開始する必要があります。システム制御情報を引き継がないでTP1/EEを再開始した場合の影響と対策について説明します。

(a)　トランザクション情報

前回オンラインのトランザクション状態を引き継げません。仕掛り中のトランザクションがリソースマネジャに残った状態でTP1/EEを開始した場合，前回オンラインのトランザクション状態に関係なく，強制的にロールバック決着をします。

(b)　サービス閉塞情報

前回オンラインのサービス閉塞状態を引き継げません。必要に応じて，eedctsvコマンドによってサービスを閉塞してください。

(c)　DBキュー情報

前回オンラインのDBキューサービス閉塞状態，DBキューの読み出し停止状態，およびDBキューサービスとDBキューの接続状態を引き継げません。前回オンラインの状態にする必要がある場合は，DBキュー制御コマンドを使用してDBキュー情報の照会，DBキューの読み出し停止，DBキューサービスの閉塞などの操作をしてください。DBキュー制御コマンドについては，「10.　運用コマンドの詳細」を参照してください。

(d)　RPC応答メッセージ送信抑止機能使用時のRPC情報

ee_rpc_reply_suspend関数を使用して，RPC応答メッセージ送信を抑止した場合，前回オンラインで抑止していたRPC応答メッセージを送信できません。

RPC要求元のUAPが無制限にRPC応答待ちをしている場合，RPC応答メッセージを送信できないと，RPC要求元のUAPが終了しなくなります。必要に応じてUAPを強制終了させてください。強制終了させる方法は，RPC要求元のUAPの種類によって異なります。

(e)　ERRTRNRによるRPC応答メッセージ送信機能使用時のRPC情報

前回オンライン時にERRTRNRによるRPC応答メッセージ送信処理を行おうとした送信先にRPC応答メッセージを送信できません。

RPC要求元のUAPが無制限にRPC応答待ちをしている場合，RPC応答メッセージを送信できないと，RPC要求元のUAPが終了しなくなります。必要に応じてUAPを強制終了させてください。強制終了させる方法は，RPC要求元のUAPの種類によって異なります。

(f)　ロールバックアボート時のRPC情報

前回オンライン時にロールバックアボートでプロセスを終了させた場合にRPC応答メッセージが送信されません。

RPC要求元のUAPが無制限にRPC応答待ちをしている場合，RPC応答メッセージを送信できないと，RPC要求元のUAPが終了しなくなります。必要に応じてUAPを強制終了させてください。強制終了させる方法は，RPC要求元のUAPの種類によって異なります。

(g)　サービスまたはトランザクションレベルの最大同時処理限界数

前回オンラインのサービスまたはトランザクションレベルの最大同時処理限界数を引き継げません。

最大同時処理限界数を変更する必要がある場合は，サービスのときはeelspceコマンド，トランザクションレベルのときはeelstrnlevelコマンドで変更してください。eelspceコマンドについては，「10.　運用コマンドの詳細」の「eelspce」を参照してください。eelstrnlevelコマンドについては，TP1/FSPの関連ドキュメントを参照してください。

(h)　UAP共用ライブラリ格納ディレクトリ情報

前回オンラインのUAP共用ライブラリ格納ディレクトリ情報を引き継げません。

UAP共用ライブラリ格納ディレクトリを変更する必要がある場合は，eechglibコマンドで変更してください。eechglibコマンドについては，TP1/FSPの関連ドキュメントを参照してください。

(i)　ユーザタイマの永続化機能のタイマ監視表情報

前回オンラインのユーザタイマの永続化機能のタイマ監視表情報を正しく引き継げません。

タイマ監視表情報を変更する必要がある場合は，eetimchownコマンドで変更してください。eetimchownコマンドについては，TP1/FSPの関連ドキュメントを参照してください。

11.6　ファイル障害

ファイルに障害が発生した場合の対処方法を説明します。

XDBトレース情報ファイルについては，マニュアル「TP1/EE/Extended Data Cache 使用の手引」を参照してください。

MCPトレースファイルについては，マニュアル「TP1/EE/Message Control Extension 使用の手引」を参照してください。

11.6.1　TASKTMファイルの障害

TASKTMファイルの出力時に障害が発生した場合，TASKTMファイルを切り替えます。TP1/EE起動中は，障害が発生したファイルを使用しないでください。OpenTP1管理者は，障害が発生した原因を調査して取り除くか，またはTASKTMファイルを削除してから，TP1/EEを再開始してください。

11.6.2　回線トレースファイルの障害

回線トレースファイルの出力時に障害が発生した場合，回線トレースファイルを切り替えます。TP1/EE起動中は，障害が発生したファイルを使用しないでください。OpenTP1管理者は，障害が発生した原因を調査して取り除くか，または回線トレースファイルを削除してから，TP1/EEを再開始してください。

11.6.3　UAPトレースファイルの障害

UAPトレースファイルの出力時に障害が発生した場合，UAPトレースファイルを切り替えます。TP1/EE起動中は，障害が発生したファイルを使用しないでください。OpenTP1管理者は，障害が発生した原因を調査して取り除くか，またはUAPトレースファイルを削除してから，TP1/EEを再開始してください。

11.6.4　統計情報ファイルの障害

統計情報ファイルの出力時に障害が発生した場合，統計情報ファイルを切り替えます。TP1/EE起動中は，障害が発生したファイルを使用しないでください。OpenTP1管理者は，障害が発生した原因を調査して取り除くか，または統計情報ファイルを削除してから，TP1/EEを再開始してください。

11.6.5　メモリダンプファイルの障害

メモリダンプファイルの出力時に障害が発生した場合，メモリダンプファイルを切り替えます。TP1/EE起動中は，障害が発生したファイルを使用しないでください。OpenTP1管理者は，障害が発生した原因を調査して取り除くか，またはメモリダンプファイルを削除してから，TP1/EEを再開始してください。

11.6.6　メッセージログファイルの障害

メモリ不足などの要因でメッセージログファイルの出力時に障害が発生した場合，KFSB51900-Eメッセージが標準エラー出力に出力されます。KFSB51900-Eメッセージに出力された情報（出力に失敗したメッセージログのメッセージと詳細情報）に従って対処してください。

ログファイルまたはsyslogへの出力ができない状態になったとき，インタバルタイマトランザクションを使用して定期的に回復処理を行います。

ログファイル回復処理では，出力するファイルの順番を初期化時と同様に再設定します。ログファイルへ出力できる状態になったときは，KFSB81900-Iメッセージを出力します。

syslogへ出力できる状態になったときは，KFSB81902-Iメッセージを出力します。

11.6.7　ファイルの縮退

TP1/EEのトラブルシュートで使用するファイルに入出力障害が発生した場合，そのファイルの代わりに障害が発生していないファイルにトラブルシュートの情報が出力されます。障害が発生して使用できなくなったファイルの状態をファイルの縮退と呼びます。

トラブルシュートで使用するすべてのファイルが縮退した場合は，トラブルシュートの情報は出力されません。また，トラブルシュートの情報を格納するディレクトリが作成できない場合もトラブルシュートに必要な情報は出力されません。

縮退するおそれのあるファイルを次に示します。

TASKTMファイル

回線トレースファイル

UAPトレースファイル

XDBトレース情報ファイル

MCPトレースファイル

統計情報ファイル

メモリダンプファイル

TP1/EEの正常開始時の初期化処理で，TASKTMファイル，回線トレースファイル，統計情報ファイル，およびメモリダンプファイルのうちのどれか一つのファイルが縮退した場合，TP1/EEはプロセスダウンします。つまり，すべてのファイルが正常の場合だけTP1/EEを正常開始できます。TP1/EEの正常開始時の初期化処理以外の場合は，TP1/EEは処理を続行します。

(1)　ファイルの縮退の監視

入出力障害によってトラブルシュートで使用するファイルが縮退し，正常なファイルが2ファイル以下になっている間，KFSB45407-Wメッセージが出力され続けます。これによって，ファイルの縮退状況を把握し，すべてのファイルが縮退する前に対処できます。

KFSB45407-Wメッセージが出力される時間間隔はトラブルシュート関連定義のtrb_iso_interval_timeオペランドで指定します。なお，このオペランドに0を指定した場合，KFSB45407-Wメッセージは出力されません。

(2)　ファイルの縮退からの回復

ファイルが縮退した原因を取り除いたあと，eetrbrcvrコマンドを実行することによって，ファイルの縮退状態から正常な状態に回復できます。

11.7　障害時に取得する情報

TP1/EEで障害が発生した場合に取得する情報を次に示します。

11.7.1　保守資料

TP1/EEのトラブルシュートに必要な保守資料を，eerasgetコマンドを使用して指定したファイルに取得します。保守資料は，TP1/Server Baseのdcrasgetコマンドでも取得できます。eerasgetコマンドまたはdcrasgetコマンドで取得できる保守資料を次に示します。

表11‒5　eerasgetコマンドまたはdcrasgetコマンドで取得する保守資料一覧

取得する保守資料

取得する保守資料が格納されているディレクトリ

TP1/Server Baseのシステムサービス定義およびTP1/EEサービス定義のファイル

$DCCONFPATHまたは$DCUAPCONFPATH

TASKTMファイル

$DCDIR/spool/dceeinf/tasktm

回線トレースファイル

$DCDIR/spool/dceeinf/trc

UAPトレースファイル

$DCDIR/spool/dceeinf/uat

統計情報ファイル

$DCDIR/spool/dceeinf/stc

メモリダンプファイル

$DCDIR/spool/dceeinf/dump

メッセージログファイル

$DCDIR/spool/dceeinf/log

OSコマンドおよびTP1/EEコマンドの実行結果

該当なし。

保守資料のファイルを格納するディレクトリは，保守資料取得のための一時作業領域としても使用します。eerasgetコマンドを実行する前に$DCDIR/spool/dceeinfディレクトリ下の容量を確認して，保守資料のファイルを格納するために必要な容量を判断してください。保守資料のファイルを格納するディレクトリには，十分な空き容量があるディレクトリを指定してください。

11.7.2　TASKTMファイル

TASKTM情報とは，トランザクションごとの統計情報です。eetrbtaskedコマンドを実行して編集，出力します。障害が発生した時刻指定やIFA番号，カレント中央処理通番などで抽出できます。編集結果をリダイレクトするか，CSV形式で出力して保存することをお勧めします。なお，TP1/EEが起動中の場合，eetrbtaskfputコマンドを実行してTASKTMファイルを強制出力させることもできます。eetrbtaskfputコマンドを実行した場合，出力バッファのサイズに達していないときでもバッファをファイルに出力し，ファイルサイズに達しないときでも使用中ファイルをクローズして次ファイルを使用します。

また，TASKTMファイルに出力する前にアボートした場合に備えて，eetrbtaskdumpコマンドを実行してコアファイルまたはメモリダンプファイルから情報を取得し，編集結果を出力できます。

古いTASKTMファイルを残しておきたい場合は，新しいTASKTMファイルを出力して古いファイルを上書きしてしまう前に，コピーしておいてください。

11.7.3　回線トレースファイル

回線トレース情報とは，送受信メッセージや，リソースマネジャ使用時のXAインタフェースなどのデータ，状態に関する情報です。eetrblineedコマンドを実行して編集，出力します。障害が発生した時刻指定やIPアドレス，サービス名などで抽出できます。編集結果をリダイレクトするか，CSV形式で出力して保存することをお勧めします。なお，TP1/EEが起動中の場合，eetrbtrcefputコマンドを実行して回線トレースファイルを強制出力させることもできます。eetrbtrcefputコマンドを実行した場合，出力バッファのサイズに達していないときでもバッファをファイルに出力し，ファイルサイズに達しないときでも使用中ファイルをクローズして次ファイルを使用します。

また，回線トレースファイルに出力する前にアボートした場合に備えて，eetrblinedumpコマンドを実行してコアファイルまたはメモリダンプファイルから情報を取得し，編集結果を出力できます。

古い回線トレースファイルを残しておきたい場合は，新しい回線トレースファイルを出力して古いファイルを上書きしてしまう前に，コピーしておいてください。

11.7.4　UAPトレースファイル

UAPトレース情報とは，UAPで使用したTP1/EEのライブラリ関数の発行履歴や取得日時などのトラブルシュートに関する情報です。eetrbuatedコマンドを実行して編集，出力します。参照したいトレース情報が出力された時刻指定やカレント中央処理通番，サービス名などで抽出できます。編集結果をリダイレクトするか，ファイルに保存することをお勧めします。なお，TP1/EEが起動中の場合，eetrbuatfputコマンドを実行して強制出力させることもできます。eetrbuatfputコマンドを実行した場合，出力バッファのサイズに達していないときでもバッファをファイルに出力し，ファイルサイズに達しないときでも使用中ファイルをクローズして次ファイルを使用します。

また，UAPトレースファイルに出力する前にアボートした場合に備えて，eetrbuapdumpコマンドを実行してコアファイルまたはメモリダンプファイルから情報を取得し，編集結果を出力できます。

古いUAPトレースファイルを残しておきたい場合は，新しいUAPトレースファイルを出力して古いファイルを上書きしてしまう前に，コピーしておいてください。

11.7.5　統計情報ファイル

統計情報とは，TP1/EEシステムの稼働中に発生する事象の発生状況や頻度に関する情報です。eetrbstcedコマンドを実行して編集，出力します。システム統計情報，処理キュー統計情報など，統計情報種別で抽出できます。編集結果をリダイレクトするか，CSV形式で出力して保存することをお勧めします。なお，TP1/EEが起動中の場合，eetrbstcfputコマンドを実行して統計情報ファイルを強制出力させることもできます。eetrbstcfputコマンドを実行した場合，出力バッファのサイズに達していないときでもバッファをファイルに出力し，ファイルサイズに達しないときでも使用中ファイルをクローズして次ファイルを使用します。

古い統計情報ファイルを残しておきたい場合は，新しい統計情報ファイルを出力して古いファイルを上書きしてしまう前に，コピーしておいてください。

11.7.6　コアファイル

コアファイルには，TP1/EEおよびTP1/Server Base関連のプロセスのデータ，スタックなどの情報が出力されます。

古いコアファイルを残しておきたい場合は，新しいコアファイルが出力されて古いファイルを上書きしてしまう前に，コピーしておいてください。

11.7.7　メモリダンプファイル

メモリダンプファイルには，TP1/EEが出力したメモリの内容が出力されます。

古いメモリダンプファイルを残しておきたい場合は，新しいメモリダンプファイルが出力されて古いファイルを上書きしてしまう前に，コピーしておいてください。

11.7.8　TP1/EEのメッセージログファイル

メッセージログとは，TP1/EEシステムの稼働状況に関する情報です。

メッセージログファイルは，メッセージログ関連定義のlog_file_maxオペランドで指定したファイル数分作成できます。TP1/EE起動時に，指定したファイル数分がすでに作成されている場合，最も古いファイルから，ファイルの内容を初期化したあとに上書きして再利用します。したがって，古いメッセージログファイルを残しておきたい場合は，古いファイルをコピーしておいてください。

古いファイルと新しいファイルを切り替えるときにKFSB81901-Iメッセージが出力されるため，このメッセージを古いファイルのコピー契機として使用できます。

11.7.9　TP1/Server Baseのメッセージログファイルおよび標準出力ファイル

TP1/Server Baseのメッセージログファイルおよび標準出力ファイルには，TP1/Server Baseが取得するメッセージログおよび標準出力の内容が出力されます。

古いファイルを残しておきたい場合は，新しいファイルが出力されて古いファイルを上書きしてしまう前に，コピーしておいてください。

11.7.10　HiRDBのエラーログファイル

HiRDBのエラーログファイルには，HiRDBクライアントとHiRDBサーバとの間での通信処理中や，XAインタフェースでエラーが発生した場合に，エラー情報が出力されます。

古いファイルを残しておきたい場合は，新しいファイルが出力されて古いファイルを上書きしてしまう前に，コピーしておいてください。

11.7.11　syslogファイル

syslogファイルには，syslog機能で出力した情報が出力されます。

11.8　DBキュー機能の障害対策

DBキュー機能使用時に発生するおそれのある障害を次に示します。

UAP障害

DBアクセス障害

オンライン停止

バッファ取得失敗によるトランザクション起動障害

SQLタイムアウト

それぞれの障害が発生した場合の，DBキュー機能の処理を説明します。

11.8.1　UAP障害

UAP障害が発生してスレッドダウンした場合，DBキュー機能は次のように処理します。

メッセージ書き込み要求の処理

コミット前にスレッドダウンした場合は，UAPから書き込み要求のあったメッセージを破棄し，ロールバックします。そのため，コミット前のUAPから書き込み要求のあったメッセージは，DBに書き込みません。

メッセージ読み出し要求の処理（AP間通信）

読み出し時またはAP起動時にスレッドダウンした場合は，スレッド回復時にロールバックします。

サービス関数の処理中にスレッドダウンした場合は，読み出し先のDBキューをスケジュール停止状態にして，以降は受信トランザクションを起動しません。DBキューのスケジュール停止状態は，ee_dbq_acsctl関数の呼び出しまたはeedbqrstコマンドの実行で解除します。

連鎖モードのロールバックを要求する関数を発行し，スレッドの強制終了を指定した場合は，読み出し先のDBキューをスケジュール停止状態にしません。このため，別トランザクションのサービス関数で，再度DBキューから同一メッセージを読み出せます。

また，自動読み出し停止機能を使用して自動で読み出しを停止するかどうかを選択できます。

メッセージ読み出し要求の処理（ユーザキューアクセス）

読み出し時またはAP起動時にスレッドダウンした場合は，スレッド回復時にロールバックします。

連鎖モードのロールバックを要求する関数を発行し，スレッドの強制終了を指定した場合は，読み出し先のDBキューをスケジュール停止状態にしません。このため，別トランザクションのサービス関数で，再度DBキューから同一メッセージを読み出せます。

11.8.2　DBアクセス障害

DBアクセス障害の原因と，それぞれの障害が発生した場合の処理を説明します。

メッセージ書き込み時の障害

メッセージ書き込み時に障害が発生した場合，エラーメッセージを出力して，該当するトランザクションをロールバックします。

メッセージ読み出し時の障害（AP間通信）

メッセージ読み出し時に障害が発生した場合，エラーメッセージを出力して，該当するDBキューをスケジュール停止状態にします。

メッセージ読み出し時の障害（ユーザキューアクセス）

メッセージ読み出し時に障害が発生した場合，該当するDBキューはスケジュール停止状態にしません。APIまたはコマンドで，該当するDBキューを読み出し停止とするか，またはメッセージを読み出すトランザクションを起動させないなどの操作をしてください。

メッセージ読み出し時の障害の例を次に示します。

API実行中（メッセージ読み出し，または連鎖モードのコミット）のDB障害

エラーメッセージを出力して，関数をエラーリターンします。エラートランザクション（ERRTRNR）は起動しません。

UAP終了時の同期点決着でのDB障害

エラーメッセージを出力して，トランザクションをロールバックします。ロールバック後にエラートランザクション（ERRTRNR）を起動します。

ほかのDBの障害

ほかのDBで障害が発生した場合，同じトランザクションでDBキューにアクセスしているときは，該当するDBキューに対する書き込み，および読み出しをロールバックします。エラートランザクション（ERRTRNR）は，障害が発生したほかのDBで起動されるため，該当するDBでは起動しません。

AP間通信の場合は，自動読み出し停止機能を使用して自動で読み出しを停止するかどうかを選択できます。ユーザキューアクセスの場合は，APで読み出し停止を制御するため，自動で読み出し停止にはなりません。

xa_start関数エラー

読み出し処理をするトランザクションが，複数のリソースマネジャに対してxa_start関数の呼び出しに失敗した場合，読み出し対象のDBキューがあるリソースマネジャに対してxa_start関数の呼び出し結果が成功したかどうかを確認します。

読み出し対象のDBキューがあるリソースマネジャに対するxa_start関数の呼び出しが失敗していた場合は，サービス関数を起動しないでトランザクションを終了します。読み出し対象のDBキューがあるリソースマネジャに対するxa_start関数の呼び出しが成功していた場合は，トランザクション処理を続行します。MNは，リソースマネジャ未接続の情報を付加して起動します。

11.8.3　オンライン停止

オンラインが停止した場合は，ステータスファイルを基にDBキュー表の状態を回復し，プロセスを回復します。オンラインが停止する原因になったトランザクションが，DBキューの読み出しトランザクションの場合は，プロセスの回復時に該当するDBキューを読み出し停止にします。ただし，ユーザキューアクセスのときは，プロセスの回復時に該当するDBキューを読み出し停止にしません。

オンラインが停止した場合は，TP1/EEがトランザクションテーブルの状態を基にトランザクションを回復しています。そのため，DBキュー機能では，トランザクションの回復はしないで，対象DBキューの未読み出しチェックだけをします。

11.8.4　処理キュー登録失敗によるトランザクション起動障害

処理キューの登録に失敗した場合，処理キューの登録をリトライします。リトライしても処理キューを登録できなかった場合は，次の表に示す処理をします。

表11‒6　処理キュー登録失敗時の処理

処理キュー登録に失敗した処理

処理キュー登録リトライ失敗時の処理

対策

読み出し処理要求

DBキュースケジュール停止

メモリ関連定義のpce_noオペランド（処理キュー登録数を指定）の指定値を見直して，再実行してください。

イベント受信処理

エラーメッセージ出力

イベント送信処理

エラーメッセージ出力

プロセスの回復後の未読み出しチェック

エラーメッセージ出力

ポーリング処理

エラーメッセージ出力

11.8.5　SQLタイムアウト

DBキュー機能では，SQLを発行してDBにアクセスします。リソースマネジャにHiRDBを使用する場合と，Oracleを使用する場合について説明します。

(1)　HiRDBをリソースマネジャとして使用する場合

ディスク障害，HiRDBの通信障害などが原因で処理が滞るのを防ぐため，SQLタイムアウトを設定します。SQLタイムアウトは，HiRDBのクライアント環境定義のPDCWAITTIMEオペランドに指定します。

なお，HiRDBのクライアント環境定義のPDCWAITTIMEオペランドの値は，TP1/EEのトランザクション関連定義のtrn_expiration_timeオペランド，およびTP1/EEのプロセス関連定義のsys_dba_waittimeオペランドより小さい値を指定してください。

(2)　Oracleをリソースマネジャとして使用する場合

OracleクライアントとOracleサーバとの間で通信障害が発生した場合に処理が滞るのを防ぐため，障害を検知できるようにSQLタイムアウトを設定します。SQLタイムアウトは，Oracleクライアントのtnsnames.oraファイルに「ENABLE=BROKEN」を記述することで設定します。

なお，tnsnames.oraファイルの「ENABLE=BROKEN」での障害検知を有効にするために，TP1/EEのプロセス関連定義のsys_dba_waittimeオペランド，およびトランザクション関連定義のtrn_expiration_timeオペランドの値は，TCP/IPのKEEPALIVEの時間間隔よりも大きい値を指定してください。TCP/IPのKEEPALIVEは，OSのコマンド（noコマンド）で設定および確認してください（例：/usr/sbin/no -o tcp_keepidle）。OSがLinuxの場合は，OSのコマンド（sysctlコマンド）で設定および確認してください（例：sysctl net.ipv4.tcp_keepalive_time）。

11.9　オンラインバッチ機能の障害対策

オンラインバッチ機能使用時に発生するおそれのある障害と，障害発生時のオンラインバッチ機能の処理について次の表に示します。

表11‒7　オンラインバッチ機能の障害対策

障害内容

オンラインバッチ機能の処理

バッチ処理トランザクション

バッチ終了トランザクション

プロセスダウン

UAPの保護区で異常が発生した場合，またはロールバック要求（プロセス強制終了の指示）を受けた場合に，プロセスダウンが発生した。

「11.9.1　全面リラン処理」を参照してください。

スレッドダウン

UAPの非保護区で異常が発生した場合，またはロールバック要求（スレッド強制終了指示）を受けた場合に，スレッドダウンが発生した。

バッチ処理を中断し，中断のバッチ終了トランザクションを起動します。

バッチ処理を中断し，中断のバッチ終了トランザクションを起動しません。

同期点要求時の障害発生

オンラインバッチ機能関連定義のdbq_obs_trn_end_apiオペランドにYを指定した場合に，API関数からの同期点要求時に障害が発生した。

オンラインバッチ機能関連定義のdbq_obs_trn_end_apiオペランドにNを指定した場合に，API関数からの同期点要求時に障害が発生した。

バッチ処理を中断しません。

オンラインバッチ機能関連定義のdbq_obs_trn_end_apiオペランドにYを指定した場合に，UAPリターン後の同期点要求時に障害が発生した。

API関数から同期点要求をしていない場合

バッチ処理を中断し，中断のバッチ終了トランザクションを起動します。

API関数から同期点要求をしていない場合

バッチ処理を中断し，中断のバッチ終了トランザクションを起動しません。

API関数から同期点要求をしている場合

バッチ処理を中断しません。

オンラインバッチ機能関連定義のdbq_obs_trn_end_apiオペランドにNを指定した場合に，UAPリターン後の同期点要求時に障害が発生した。

バッチ処理を中断し，中断のバッチ終了トランザクションを起動します。

バッチ処理を中断し，中断のバッチ終了トランザクションを起動しません。

DB障害発生

データ型オンラインバッチ処理のバッチ処理トランザクション実行中，DBキューからのメッセージ読み出し処理時に，DB障害が発生した。

該当しません。

11.9.1　全面リラン処理

プロセスダウン後の全面リラン処理で，起動中のロットに対する回復処理を行います。回復処理を行うロットには，回復処理時の状態によって，次の表に示す処理を行います。

表11‒8　ロットの回復処理時の状態と全面リラン後の処理

回復処理時の状態

全面リラン後の処理

バッチ処理トランザクションの実行中

バッチ処理トランザクションを起動します。

正常終了のバッチ終了トランザクションの実行中

ee_dbq_obsend関数を呼び出してからバッチ終了トランザクションがコミットするまでの間に，正常終了のバッチ終了トランザクションを起動します。

強制終了のバッチ終了トランザクションの実行中

ee_dbq_obscancel関数を呼び出してからバッチ終了トランザクションがコミットするまでの間に，強制終了のバッチ終了トランザクションを起動します。

中断のバッチ終了トランザクションの実行中

障害発生からバッチ終了トランザクションがコミットするまでの間に，中断のバッチ終了トランザクションを起動します。

ロットの中断中

全面リラン後の処理はありません。

ee_dbq_obsrestart関数によってトランザクション処理を開始します。

プロセスダウンの直接の原因となったバッチ処理トランザクションは，中断のバッチ終了トランザクションを起動します。プロセスダウンの直接の原因となったバッチ終了トランザクションは，障害中断中となります。

11.10　障害メッセージの応答機能

TP1/EEで対応する処理を決定できない障害が発生した場合，ユーザに応答を促すメッセージが出力されます。このメッセージに対して，状況に応じた処理オプションとともにeetrbwtorコマンドを実行することで障害に対応できます。

ユーザに応答を促すメッセージには，メッセージ識別子番号および処理オプションが出力されます。メッセージの説明に応じた対策を行ったあと，eetrbwtorコマンドのオプションに，出力されたメッセージ識別子番号，状況に応じた処理オプションなどを入力して実行します。

これによって，TP1/EEで対応する処理を決定できない障害については，ユーザが判断して対処できます。

11.11　トラブルシュートの性能向上

トラブルシュートの性能を向上させる機能として，次の機能があります。

回線トレースの一括出力機能

バッファコピー抑止機能

11.11.1　回線トレースの一括出力機能

回線トレース情報のレコードは，出力要求時に排他が確保されて，出力バッファにコピーされます。このときの排他確保が性能に影響する場合，回線トレースの一括出力機能を使用することで，性能を向上させることができます。

回線トレースの一括出力機能を使用すると，回線トレース情報のレコードをスレッド対応エリアにいったん蓄積した上で，同期点取得時などに一括して出力バッファにコピーします。これによって，排他回数を削減できます。

スレッド対応エリアから出力バッファへの出力タイミングは次のとおりです。

同期点取得時

受信メッセージ待ちの発生時

スレッド対応エリアが満杯になったとき

回線トレースの一括出力機能は，トラブルシュート関連定義のtrb_extend_functionオペランドで指定します。

11.11.2　バッファコピー抑止機能

トラブルシュート情報および統計情報は，レコード出力用のバッファが満杯になると，いったんファイル出力用のバッファにコピーされてからファイルに出力されます。これによって，満杯だったレコード出力用のバッファが，再びレコード出力用のバッファに割り当てられます。

このとき，バッファのサイズが大きいと，ファイル出力用のバッファへのコピーが性能低下の原因になるおそれがあります。そこで，満杯になったレコード出力用のバッファから直接ファイルに出力して，レコード出力用のバッファには，確保しておいた予備のバッファ1面を割り当てることができます。これを，バッファコピー抑止機能といいます。なお，満杯だったレコード出力用のバッファは，ファイル出力を終えると予備のバッファに割り当てられます。

バッファコピー抑止機能は，トラブルシュート関連定義のtrb_extend_functionオペランドで指定します。

12　コンテナオーケストレーションツールを使用したOpenTP1の構成と構築

この章では，コンテナオーケストレーションツールを使用したTP1/EEの構成と構築について説明します。

TP1/EEはTP1/Server Base上で動作するSPPの位置づけとなります。そのため，コンテナ構成の構築や運用については，TP1/Server Baseに依存します。詳細については，マニュアル「OpenTP1 解説」を参照してください。ここでは，コンテナ構成についてTP1/EEで固有な点を記載します。

なお，この章では，PodやKubernetesに関する各種オブジェクトの作成方法など，環境構築の具体的な方法については記載していません。具体的な方法については，TP1/EEの取扱説明書「OpenShiftを使用したTP1/EEシステムの構築」を参照してください。

12.1　この章を読む際の留意事項

TP1/EEは，08-01以降でコンテナに対応しています。

対応しているコンテナプラットフォームとオーケストレーションツールは，PodmanとOpenShiftの組み合わせだけとなります。それ以外については，TP1/Server Baseと同様です。

12.2　概要

コンテナをサポートするTP1/EEのバージョン，およびTP1/EEが対応するコンテナについて説明します。

12.2.1　コンテナをサポートするTP1/EEのバージョン

TP1/EEがコンテナ環境で動作するには，08-01以降が必要です。

12.2.2　TP1/EEが対応するコンテナ

TP1/EEが対応するコンテナはPodmanだけです。

12.3　システム構成

リモートAPI機能以外のRPCを使用する場合，TP1/EEの08-01以降が必要です。

それ以外については，TP1/Server Baseと同様です。

12.3.1　トランザクション連携

TP1/Server Baseの固有機能に対する説明のため，TP1/EEは該当しません。

12.3.2　旧バージョンとのRPC連携

旧バージョンとRPC連携する場合の通信可否については，TP1/Server Baseと同様です。

ipc_notify_response_hostオペランドの指定については，TP1/EEのRPC関連定義のipc_notify_response_hostオペランドで指定することとなります。

12.3.3　他製品とのRPC連携

他製品とRPC連携する場合の通信可否については，TP1/Server Baseと同様です。ipc_notify_response_hostオペランドの指定については，TP1/EEのRPC関連定義のipc_notify_response_hostオペランドで指定することとなります。

12.4　サポート機能

コンテナ内のTP1/EEでサポートする機能などについて説明します。

12.4.1　サポート機能の詳細

コンテナ内のTP1/EEがサポートする機能を次の表に示します。

表12‒1　コンテナ内のTP1/EEがサポートする機能

項番

機能名

サポート

特記事項

1

トランザクション制御

分散トランザクション

○

−

2

リソースマネジャ連携

○

−

3

クライアント／サーバ形態の通信

リモートプロシジャコール（RPC）通信※1

○

−

4

Cosminexus連携機能

〇

−

5

DBキュー機能

DBキュー機能

〇

−

6

オンラインバッチ機能

オンラインバッチ機能

〇

−

7

アプリケーションプログラムのスケジュール

マルチスレッド制御

○

−

8

ノード間負荷バランス機能

○

−

9

サービスのスケジュール

○

−

10

サービスグループ閉塞

○

−

11

TP1/EEの運用を補助する機能

資源の排他制御

○

−

12

運用コマンド実行機能

○

−

13

UAP共用ライブラリ入れ替え機能

○

入れ替え対象のUAP共有ライブラリは永続ボリューム下を指定してください。pod内のディレクトリ下を指定した場合，pod再起動時にUAP共有ライブラリが削除されTP1/EEの起動が失敗します。

14

定義事前チェック機能

○

−

15

起動順序のシリアル化機能

○

−

16

回線トレースファイルとTASKTMファイルの関連づけ

○

−

17

TP1/EEファイルシステム

〇

−

18

トラブルシュート機能

○

−

19

メッセージログ機能

〇

−

20

メモリ管理機能

〇

−

21

複数のTP1/EEを使用する場合の機能

系切り替え機能

（HAモニタを使用した系切り替え）

×

−

22

TCPコネクション管理

一時クローズ機能

○

−

23

ポート番号自動割り当て機能

×

この機能は使用できません。ポート番号は明示的に指定してください。※²

（凡例）

〇：サポート

×：未サポート

−：特記事項なし

注※1

サポートするRPC通信種別を次の表に示します。

項番

RPCの種別

TP1/EEの配置

送信元TP1/EE

送信先TP1/EE

1

リモートAPI機能（rap）を使用したRPC

コンテナ内

コンテナ内

2

コンテナ外

コンテナ内

3

コンテナ内

コンテナ外

4

コンテナ外

コンテナ外

5

ネームサービスを使用したRPC

コンテナ内

コンテナ内

6

コンテナ外

コンテナ内

7

コンテナ内

コンテナ外

8

コンテナ外

コンテナ外

9

スケジューラダイレクト機能を使用したRPC

コンテナ内

コンテナ内

10

コンテナ外

コンテナ内

11

コンテナ内

コンテナ外

12

コンテナ外

コンテナ外

注※2

コンテナ内で起動するTP1/EEには，必ず次の値を指定してください。指定しない場合はRPC要求／応答電文が受信できないため，RPCがエラーとなります。

RPC要求メッセージ受信用のポート：

mysvgdef定義コマンドの-hオプションのポート番号に0以外を指定

RPC応答メッセージ受信用のポート：

RPC関連定義のrpc_reply_port_autoオペランドの指定を省略するか，Nを指定

12.4.2　RPC通信

RPC通信については，TP1/Server Baseと同様です。

なお，同一コンテナ内で複数のTP1/EEプロセスを起動した場合の，TP1/EEプロセス間のRPC通信については，すべてのRPC種別が通信可能です。

12.4.3　RPC通信の注意事項

TP1/EEには，TP1/Server Baseのdcbindht定義に相当するものがないため，RPC通信の注意事項との対応が取れません。RPC通信の注意事項については，マニュアル「OpenTP1 解説」を参照してください。

12.4.4　コンテナ内のTP1/Server Baseに関する注意事項

TP1/Server Baseの固有機能に対する説明のため，TP1/EEは該当しません。

12.5　システム構成と環境設定

TP1/Server Baseの固有機能に対する説明のため，TP1/EEは該当しません。

12.5.1　リモートAPI機能を使用したRPC

リモートAPI機能を使用したRPCについては，TP1/Server Baseと同様です。

rap_listen_portオペランドの指定については，TP1/EEのRPC関連定義のrap_listen_portオペランドで指定することとなります。

また，TP1/EEがコネクション確立で使用するポート番号をServiceに登録する必要があります。ポート番号については「12.6.4　Serviceの作成」を参照してください。

12.5.2　ネームサービスを使用したRPC

ネームサービスを使用したRPCについては，TP1/Server Baseと同様です。ただし，TP1/EEでは追加で次の指定が必要となります。

RPC関連定義のipc_notify_response_hostオペランドにYを指定

myreplydef定義コマンドに，TP1/Server Baseのipc_response_hostオペランドで指定したホスト名を指定

また，TP1/EEがコネクション確立で使用するポート番号をServiceに登録する必要があります。ポート番号については「12.6.4　Serviceの作成」を参照してください。

12.5.3　スケジューラダイレクト機能を使用したRPC

「12.5.2　ネームサービスを使用したRPC」と同様のTP1/EEの定義が必要です。なお，RPC要求を受け付けるポート番号は，TP1/Server Baseのscd_portオペランドで指定したポート番号ではなく，TP1/EEのmysvgdef定義コマンド定義で指定したポート番号となります。

また，TP1/EEがコネクション確立で使用するポート番号をServiceに登録する必要があります。ポート番号については，「12.6.4　Serviceの作成」を参照してください。

12.6　コンテナ環境独自の設定

コンテナ環境独自の設定について説明します。

12.6.1　OpenTP1の開始と終了

TP1/EEの起動／終了の方法は，非コンテナ構成と同様，次に示す2種類があります。

TP1/Server Baseの起動／終了と同期して，TP1/EEも起動／終了します。

eesvstartコマンド／eesvstopコマンドを使用して，TP1/EEを起動／終了します。

12.6.2　TP1/Server Baseの再開始

TP1/Server Baseの再開始は，TP1/Server Baseと同様です。

12.6.3　TP1/Server Baseのノード追加

TP1/Server Baseの固有機能に対する説明のため，TP1/EEは該当しません。

12.6.4　Serviceの作成

コンテナ内でTP1/EEを起動する場合，次のポートをServiceに登録し，コンテナ外からコンテナ内への通信ができるようにしてください。実際の登録方法は，TP1/Server Baseについて説明しているOpenTP1のマニュアルを参照してください。

mysvgdef定義コマンドの-hオプションで指定したポート番号

myreplydef定義コマンドの-hオプションで指定したポート番号

RPC関連定義のrap_listen_portオペランドで指定したポート番号※

注※

コンテナ内のTP1/EEに対して，リモートAPI機能を使用したサービス呼び出しを行う場合

12.7　障害対応

障害対応については，TP1/Server Baseについて説明しているOpenTP1のマニュアルおよびTP1/EEの取扱説明書「OpenShiftを使用したTP1/EEシステムの構築」を参照してください。

12.8　制限事項

TP1/EEの制限事項については，「12.4.1　サポート機能の詳細」の「表12-1　コンテナ内のTP1/EEがサポートする機能」を参照してください。

付録

付録A　中央処理通番

中央処理通番とは，TP1/EEがトランザクションを起動するときに，トランザクション単位に割り当てる通番です。

中央処理通番の範囲は16進数で00000001〜ffffffffです。ラップした場合は，再度00000001から始まります。

中央処理通番には，次の種類があります。

カレント中央処理通番

該当するトランザクションに割り当てられた中央処理通番です。

オリジナル中央処理通番

トランザクションから発生したトランザクションの，トランザクション登録元のカレント中央処理通番です。

トランザクションに割り当てられる中央処理通番の例を次の表に示します。

表A‒1　トランザクションに割り当てられる中央処理通番

同期点

カレント中央処理通番※

オリジナル中央処理通番

トランザクション開始

1

0

コミット／ロールバック後（1回目）

2

1

コミット／ロールバック後（2回目）

3

1

コミット／ロールバック後（3回目）

4

1

コミット／ロールバック後（4回目）

5

1

コミット／ロールバック後（5回目）

6

1

コミット／ロールバック後（6回目）

7

1

（凡例）

コミット：ee_trn_chained_commit関数呼び出し

ロールバック：ee_trn_chained_rollback関数呼び出し

注※

カレント中央処理通番は，同期点ごとに変更されます。また，連番にならないことがあります。

付録B　統計情報の詳細

統計情報の詳細を統計情報の種類ごとに説明します。

付録B.1　システム統計情報

システム統計情報の詳細を次の表に示します。

表B‒1　システム統計情報の詳細

統計情報種別

イベント

詳細内容

チューニングする定義※1

統計情報編集ID※2

ｒｐｃ情報

（RPC-information）（rpc）

ｒｐｃコールレスポンスタイム（RPC call response time）※3

ee_rpc_call関数を呼び出してサーバに要求メッセージを送信してから，サーバから応答を受信するまでのレスポンスタイム（レスポンス統計情報で取得）を，インタバル時間内で集計した数値。

−

1

ユーザサービス実行時間（User service execution time）※3

サービス関数の実行時間（レスポンス統計情報で取得）を，インタバル時間内で集計した数値。

−

2

ｒｐｃタイムアウト（RPC timeout）

RPCの応答待ちの処理で発生したタイムアウトエラーの件数。

−

3

ＩＢＦ定義（IBF definition）

メモリ関連定義のrecv_message_buf_cntオペランドで指定した受信バッファ面数。

−

4

ＩＢＦ空き（IBF free）

空き受信バッファ面数。

メモリ関連定義

recv_message_buf_cnt

5

ＩＢＦ確保要求（IBF reservation request）

RPCの処理の内部で，受信バッファの確保を要求した回数。

−

6

ＩＢＦ確保失敗（IBF reservation failure）

RPCの処理の内部で，受信バッファの確保に失敗した回数。

メモリ関連定義

recv_message_buf_cnt

7

ＩＢＦ割当て待ち（IBF allocation waiting）

RPCの処理の内部での，受信バッファ割り当て待ちのスレッド数。

メモリ関連定義

recv_message_buf_cnt

8

ＩＢＦ解放（IBF release）

RPCの処理の内部で，受信バッファの解放を要求した回数。

−

9

ＯＢＦ定義（OBF definition）

メモリ関連定義のsend_message_buf_cntオペランドで指定した送信バッファ面数。

−

10

ＯＢＦ空き（OBF free）

空き送信バッファ面数。

メモリ関連定義

send_message_buf_cnt

11

ＯＢＦ確保要求（OBF reservation request）

RPCの処理の内部で，送信バッファの確保を要求した回数。

−

12

ＯＢＦ確保失敗（OBF reservation failure）

RPC処理の内部で，送信バッファの確保に失敗した回数。

メモリ関連定義

send_message_buf_cnt

13

ＯＢＦ割当て待ち（OBF allocation waiting）

RPCの処理の内部での，送信バッファ割り当て待ちのスレッド数。

メモリ関連定義

send_message_buf_cnt

14

ＯＢＦ解放（OBF release）

RPCの処理の内部で，送信バッファの解放を要求した回数。

−

15

ＥＡＧＡＩＮ（EAGAIN）

EAGAINが発生した回数。

−

16

ディスクリプタ不足（Descriptor shortage）

ディスクリプタ不足によるコネクション確立失敗回数。

RPC関連定義

socket_no

17

一時クローズ処理開始

（Temporary closing start）

一時クローズ処理要求のコネクション選択処理が行われた回数。

RPC関連定義

rpc_reply_sockctl_highwater

rpc_recv_sockctl_highwater

18

一時クローズ要求送信

（Temporary closing request send）

一時クローズ要求電文を送信した回数。

RPC関連定義

rpc_reply_sockctl_highwater

rpc_recv_sockctl_highwater

19

一時クローズ要求受信

（Temporary closing request receive）

一時クローズ要求電文を受信した回数。

RPC関連定義

rpc_reply_sockctl_highwater

rpc_recv_sockctl_highwater

20

ｒｐｃ情報

（RPC-information）（rap）

常設コネクション不足（Permanent connection shortage）

rapサーバの常設コネクション不足によるコネクション切断回数。

RPC関連定義

rap_max_client

31

クライアントの常設コネクション不足（Client permanent connection shortage）

rapクライアントの常設コネクションが不足した回数。

RPC関連定義

rpc_rap_connection_count

32

常設コネクション数（Permanent connection count）

rapサーバの常設コネクション数。

RPC関連定義

rap_max_client

33

クライアントの常設コネクション数（Client permanent connection count）

rapクライアントの常設コネクション数。

RPC関連定義

rpc_rap_connection_count

34

ｒｐｃ情報

（RPC-information）（nam）

ｌｏｏｋｕｐ（Lookup）

サービス情報の参照要求回数。

−

41

キャッシュ不足（Cache shortage）

RPCの処理の内部で，キャッシュ不足が発生した回数。

RPC関連定義

name_cache_size

42

キャッシュヒット（Cache hits）

サービス情報キャッシュ領域に設定されたサービス情報の参照回数。

RPC関連定義

name_cache_size

43

キャッシュミスヒット（Cache missed hits）

サービス情報の参照要求時に，サービス情報キャッシュ領域に要求したサービス情報が設定されていなかった回数。

−

44

負荷レベルの変動（Load level variance）

負荷レベルの変動回数。

−

45

高負荷時の転送（Transfer during high load）

自プロセスが高負荷レベル（負荷レベル2）のため，RPCメッセージを他プロセスに転送した回数。

−

46

高負荷時以外の転送（Transfer other than during high load）

自プロセスは高負荷レベル（負荷レベル2）ではないが，RPCメッセージを他プロセスに転送した回数。

−

47

ｒｐｃ情報（RPC-information）（UDP）

送信パケット（Sending packet）

送信したパケット数。

−

50

再送パケット（Sending again packet）

送信したパケット中の再送パケット数。

−

51

再送パケット比率（Sending again packet ratio）

送信完了時の再送パケット比率。

RPC関連定義

rpc_udp_congestion_packet_count

52

ＮＡＣＫ受信（NACK receive）

否定応答（NACK）パケットの受信回数。

−

53

再送タイマタイムアウト（Sending again timer time out）

再送タイマのタイムアウト回数。

UDPグループ情報関連定義

eeudpdef

myudpsnddef

clgrpdef

-wオプションおよび-Wオプション

54

輻輳変動（Congestion change）

輻輳状態と通常状態の遷移回数。

RPC関連定義

rpc_udp_congestion_packet_count

55

送信ソケット空き待ち（Sending socket space waiting）

使用できる送信ソケットがないことによる空き待ち回数。

RPC関連定義

myudpsnddef

-pオプションまたは-Pオプションで指定するポート数

56

通信時間（Communication time）

通信時間（送信関数の呼び出しから肯定応答（ACK）または否定応答（NACK）の受信まで）。

−

57

受信パケット（Receiving packet）

受信したパケット数。

−

58

重複パケット破棄（Duplication packet destroy）

受信パケットの中で，受信済みだったために破棄したパケット数。

−

59

欠落パケット破棄（Defective packet destroy）

受信パケットの中で，パケットが欠落していたために破棄したパケット数。

−

60

旧パケット破棄（Old packet destroy）

受信パケットの中で，完成済みメッセージまたは旧メッセージだったために破棄したパケット数。

−

61

受信タイムアウト（Receiving time out）

メッセージ完成待ちタイマのタイムアウト回数。

−

62

タイマ情報

（timer-information）

ＩＣＢ定義（ICB definition）

メモリ関連定義のicb_noオペランドで指定した，タイマトランザクションの登録最大数に10を加算した数。

−

71

ＩＣＢ空き（ICB free）

空きタイマサービス制御管理テーブル数。

メモリ関連定義

icb_no

72

ＩＣＢ確保要求（ICB reservation request）

タイマ処理の内部で，タイマサービス制御管理テーブルの確保を要求した回数。

−

73

ＩＣＢ確保失敗（ICB reservation failure）

タイマ処理の内部で，タイマサービス制御管理テーブルの確保に失敗した回数。

メモリ関連定義

icb_no

74

ＩＣＢ割当て待ち（ICB allocation waiting）

タイマ処理の内部での，タイマサービス制御管理テーブル割り当て待ちのスレッド数。

メモリ関連定義

icb_no

75

ＩＣＢ解放（ICB release）

タイマ処理の内部で，タイマサービス制御管理テーブルの解放を要求した回数。

−

76

ＴＴＢＦ定義（TTBF definition）

メモリ関連定義のtime_message_noオペランドで指定した，タイマトランザクション登録時に使用する最大データ数。

−

77

ＴＴＢＦ空き（TTBF free）

空きタイマトランザクション用バッファ数。

メモリ関連定義

time_message_no

78

ＴＴＢＦ確保要求（TTBF reservation request）

タイマ処理の内部で，タイマトランザクション用バッファの確保を要求した回数。

−

79

ＴＴＢＦ確保失敗（TTBF reservation failure）

タイマ処理の内部で，タイマトランザクション用バッファの確保に失敗した回数。

メモリ関連定義

time_message_no

80

ＴＴＢＦ割当て待ち（TTBF allocation waiting）

タイマ処理の内部での，タイマトランザクション用バッファ割り当て待ちのスレッド数。

メモリ関連定義

time_message_no

81

ＴＴＢＦ解放（TTBF release）

タイマ処理の内部で，タイマトランザクション用バッファの解放を要求した回数。

−

82

スケジュール情報

（schedule-information）

ＰＣＥ定義（PCE definition）

メモリ関連定義のpce_noオペランドで指定したサービス処理キュー数。

−

91

ＰＣＥ空き（PCE free）

空きサービス処理キュー数。

メモリ関連定義

pce_no

92

ＰＣＥ確保要求（PCE reservation request）

スケジュール処理の内部で，サービス処理キューの確保を要求した回数。

−

93

ＰＣＥ確保失敗（PCE reservation failure）

スケジュール処理の内部で，サービス処理キューの確保に失敗した回数。

メモリ関連定義

pce_no

94

ＰＣＥ割当て待ち（PCE allocation waiting）

スケジュール処理の内部での，サービス処理キュー割り当て待ちのスレッド数。

メモリ関連定義

pce_no

95

ＰＣＥ解放（PCE release）

スケジュール処理の内部で，サービス処理キューの解放を要求した回数。

−

96

予備処理スレッド引出し（Standby processing thread withdrawal）

予備処理スレッドで処理キューを引き出した回数。

プロセス関連定義

reserve_thread_no

reserve_start_pce_no

97

予備処理スレッド起動（Standby processing thread startup）

起動している予備処理スレッド数。

プロセス関連定義

reserve_thread_no

98

ＰＣＥ滞留率（PCE retention rate）

処理キューの滞留率（1秒ごとに算出）。

プロセス関連定義

thread_no

reserve_thread_no

reserve_start_pce_no

stay_watch_queue_rate

stay_watch_down_rate

ユーザサービス関連定義

service（同時処理限界数）

99

処理キュー引出し待ち時間（Processing queue wait time）

処理キュー引き出し待ち時間。

プロセス関連定義

thread_no

reserve_thread_no

reserve_start_pce_no

ユーザサービス関連定義

service（同時処理限界数）

100

トランザクション情報

（transaction-information）

トランザクションブランチ起動（Transaction branch startup）

起動しているトランザクションブランチ数。

トランザクション関連定義

trn_tran_process_count

121

コミット（Commit）

トランザクションのコミット決着回数。

−

122

ロールバック（Rollback）

トランザクションのロールバック決着回数。

−

123

ＵＡＰ実行時間（UAP execution time）

UAPの実行時間。

−

124

ＡＰＩ情報

（api-information）

ＳＱＬ実行時間（SQL execution time）

HiRDBのSQLの実行時間。

−

141

ＡＰＩ実行時間（API execution time）

APIの実行時間。

−

142

排他ＡＰＩ保持時間（Ex-API remain time）

排他を保持していた時間。

−

143

排他ＡＰＩ待ち時間（Ex-API wait time）

排他確保までの待ち時間。

−

144

排他ＡＰＩ待ち行列数（Ex-API wait que cnt）

排他確保待ちの待ち行列数。

−

145

排他ＡＰＩ待ちタイムアウト回数（Ex-API wait timeout cnt）

排他API待ちのタイムアウト回数。

−

146

スレッド情報（thread-information）

ＣＰＵ時間

（CPU time）

1秒当たりのTP1/EEプロセスのCPU時間。

イベント数は，CPU時間の計測回数。

−

152

ステータスファイル情報

（status-file-information）

スタック用バッファヒット率（Hit rate for buffer stacks）

ステータスファイルI/O時にステータスファイルのスタック用バッファを検索してヒットした割合（ステータスファイルのバッファサーチ回数）。

ステータスファイル関連定義

sts_buffer_count

161

スワップ時間（Swap time）

ステータスファイルのスワップ処理時間。

−

162

ファイルサービス情報

（file-service-information）

Ｉ／Ｏ時間（I/O time）

TP1EEファイルシステムのファイルI/O時間。

−

171

メモリ情報

（memory-information）

システム用ワーク領域空き（System work area free）

システム用ワーク領域の空きサイズ。

メモリ関連定義

system_work_size

181

システム用ワーク確保（System work reservation

システム用ワークを確保した回数。

−

182

システム用ワーク解放（System work release）

システム用ワークを解放した回数。

−

183

システム用ワーク確保失敗（System work reservation failure）

システム用ワーク確保エラー時の要求サイズ。

メモリ関連定義

system_work_size

184

ユーザ用ワーク領域空き（User work area free）

ユーザ用ワーク領域の空きサイズ。

メモリ関連定義

user_work_size

185

ユーザ用ワーク確保（User work reservation）

ユーザ用ワークを確保した回数。

−

186

ユーザ用ワーク解放（User work release）

ユーザ用ワークを解放した回数。

−

187

ユーザ用ワーク確保失敗（User work reservation failure）

ユーザ用ワーク確保エラー時の要求サイズ。

メモリ関連定義

user_work_size

188

共用ワーク領域空き（Shared work area free）

共用ワーク領域の空きサイズ。

メモリ関連定義

max_mem_size

189

共用ワーク確保（Shared work reservation）

共用ワークを確保した回数。

−

190

共用ワーク解放（Shared work release）

共用ワークを解放した回数。

−

191

共用ワーク確保失敗（Shared work reservation failure）

共用ワーク確保エラー時の要求サイズ。

メモリ関連定義

max_mem_size

192

ＣＯＢＯＬ用プール空き（COBOL pool free）

COBOL用プールの空きサイズ。

メモリ関連定義

memory_cobol_area_size

memory_cobol_area_thd_size

193

ＣＯＢＯＬ用プール確保（COBOL pool reservation）

COBOL用プールを確保した回数。

−

194

ＣＯＢＯＬ用プール解放（COBOL pool release）

COBOL用プールを解放した回数。

−

195

ＣＯＢＯＬ用プール確保失敗（COBOL pool reservation failure）

COBOL用プール確保エラー時の要求サイズ。

メモリ関連定義

memory_cobol_area_size

memory_cobol_area_thd_size

196

ＸＴＣ用プール空き（XTC pool free）

XTC用ワーク領域（XTCPOOL）の空きサイズ。

メモリ関連定義

memory_xtc_area_size

memory_xtc_limit_size

197

ＸＴＣ用プール確保（XTC pool reservation）

XTC用ワーク領域の確保回数。

−

198

ＸＴＣ用プール解放（XTC pool release）

XTC用ワーク領域の解放回数。

−

199

ＸＴＣ用プール確保失敗（XTC pool reservation failure）

XTC用ワーク領域の確保エラー時の要求サイズ。

メモリ関連定義

memory_xtc_area_size

memory_xtc_limit_size

200

ＸＤＢ用プール空き（XDB pool free）

XDB用ワーク領域（XDBPOOL）の空きサイズ。

メモリ関連定義

memory_xdb_area_size

memory_xdb_limit_size

201

ＸＤＢ用プール確保（XDB pool reservation）

XDB用ワーク領域の確保回数。

−

202

ＸＤＢ用プール解放（XDB pool release）

XDB用ワーク領域の解放回数。

−

203

ＸＤＢ用プール確保失敗（XDB pool reservation failure）

XDB用ワーク領域の確保エラー時の要求サイズ。

メモリ関連定義

memory_xdb_area_size

memory_xdb_limit_size

204

大量処理用システムプール空き（MDP system pool free）

大量処理用システム領域（MPSPOOL）の空きサイズ。

メモリ関連定義

memory_mdpsys_area_size

205

大量処理用システムプール確保（MDP system pool reservation）

大量処理用システム領域の確保回数。

−

206

大量処理用システムプール解放（MDP system pool release）

大量処理用システム領域の解放回数。

−

207

大量処理用システムプール確保失敗（MDP system pool reservation failure）

大量処理用システム領域の確保エラー時の要求サイズ。

メモリ関連定義

memory_mdpsys_area_size

208

大量処理用ユーザプール空き（MDP user pool free）

大量処理用ユーザ領域（MPUPOOL）の空きサイズ。

メモリ関連定義

memory_mdpusr_area_size

209

大量処理用ユーザプール確保（MDP user pool reservation）

大量処理用ユーザ領域の確保回数。

−

210

大量処理用ユーザプール解放（MDP user pool release）

大量処理用ユーザ領域の解放回数。

−

211

大量処理用ユーザプール確保失敗（MDP user pool reservation failure）

大量処理用ユーザ領域の確保エラー時の要求サイズ。

メモリ関連定義

memory_mdpusr_area_size

212

ＸＴＣ用プール合計サイズ（XTC pool max size）

XTC用ワーク領域の合計サイズ。

メモリ関連定義

memory_xtc_area_size

memory_xtc_limit_size

213

ＸＤＢ用プール合計サイズ（XDB pool max size）

XDB用ワーク領域の合計サイズ。

メモリ関連定義

memory_xdb_area_size

memory_xdb_limit_size

214

大量処理用システムプール合計サイズ（MDP system pool max size）

大量処理用システム領域の合計サイズ。

メモリ関連定義

memory_mdpsys_area_size

215

大量処理用ユーザプール合計サイズ（MDP user pool max size）

大量処理用ユーザ領域の合計サイズ。

メモリ関連定義

memory_mdpusr_area_size

216

ＤＢキュー情報

（DB-queue-information）

アクセス時間（Access time）

DBキューのDBアクセス処理時間。

−

221

ＱＩＢＦ定義（QIBF definition）

メモリ関連定義のdbq_recv_message_buf_cntオペランドで指定した，DBキュー機能で使用する受信バッファ面数。

−

222

ＱＩＢＦ空き（QIBF free）

空きDBキュー用入力バッファ数。

メモリ関連定義

dbq_recv_message_buf_cnt

223

ＱＩＢＦ確保要求（QIBF reservation request）

DBキュー処理の内部で，DBキュー用入力バッファの確保を要求した回数。

−

224

ＱＩＢＦ確保失敗（QIBF reservation failure）

DBキュー処理の内部で，DBキュー用入力バッファの確保に失敗した回数。

メモリ関連定義

dbq_recv_message_buf_cnt

225

ＱＩＢＦ割当て待ち（QIBF allocation waiting）

DBキュー処理の内部での，DBキュー用入力バッファ割り当て待ちのスレッド数。

メモリ関連定義

dbq_recv_message_buf_cnt

226

ＱＩＢＦ解放（QIBF release）

DBキュー処理の内部で，DBキュー用入力バッファの解放を要求した回数。

−

227

ＱＯＢＦ定義（QOBF definition）

メモリ管理定義のdbq_send_message_buf_cntオペランドで指定したDBキュー機能で使用する送信バッファ面数。

−

228

ＱＯＢＦ空き（QOBF free）

空きDBキュー用出力バッファ数。

メモリ関連定義

dbq_send_message_buf_cnt

229

ＱＯＢＦ確保要求（QOBF reservation request）

DBキュー処理の内部で，DBキュー用出力バッファの確保を要求した回数。

−

230

ＱＯＢＦ確保失敗（QOBF reservation failure）

DBキュー処理の内部で，DBキュー用出力バッファの確保に失敗した回数。

メモリ関連定義

dbq_send_message_buf_cnt

231

ＱＯＢＦ割当て待ち（QOBF allocation waiting）

DBキュー処理の内部での，DBキュー用出力バッファ割り当て待ちのスレッド数。

メモリ関連定義

dbq_send_message_buf_cnt

232

ＱＯＢＦ解放（QOBF release）

DBキュー処理の内部で，DBキュー用出力バッファの解放を要求した回数。

−

233

ＱＷＢＦ定義（QWBF definition）

メモリ関連定義のdbq_use_buf_cntオペランドで指定した，DBキュー機能で使用する最大バッファ面数。

−

234

ＱＷＢＦ空き（QWBF free）

空きDBキュー用ライトアクセスリストバッファ数。

メモリ関連定義

dbq_use_buf_cnt

235

ＱＷＢＦ確保要求（QWBF reservation request）

トランザクション処理の内部で，DBキュー用ライトアクセスリストバッファの確保を要求した回数。

−

236

ＱＷＢＦ確保失敗（QWBF reservation failure）

トランザクション処理の内部で，DBキュー用ライトアクセスリストバッファの確保に失敗した回数。

メモリ関連定義

dbq_use_buf_cnt

237

ＱＷＢＦ割当て待ち（QWBF allocation waiting）

トランザクション処理の内部での，DBキュー用ライトアクセスリストバッファ割り当て待ちのスレッド数。

メモリ関連定義

dbq_use_buf_cnt

238

ＱＷＢＦ解放（QWBF release）

トランザクション処理の内部で，DBキュー用ライトアクセスリストバッファの解放を要求した回数。

−

239

ＸＴＣ情報（XTC-information）※4

ＵＩＢＦ定義（UIBF definition）

メモリ関連定義のudp_recv_message_buf_cntオペランドの設定値。

−

270

ＵＩＢＦ空き（UIBF free）

空きUDP用受信バッファ（UIBF）数。

メモリ関連定義

udp_recv_message_buf_cnt

271

ＵＩＢＦ確保要求（UIBF reservation request）

UDP通信でUDP用受信バッファ（UIBF）確保要求をした回数。

−

272

ＵＩＢＦ確保失敗（UIBF reservation failure）

UDP通信でUDP用受信バッファ（UIBF）確保に失敗した回数。

メモリ関連定義

udp_recv_message_buf_cnt

273

ＵＩＢＦ割当て待ち（UIBF allocation waiting）

UDP通信でUDP用受信バッファ（UIBF）割り当て待ちのスレッド数。

メモリ関連定義

udp_recv_message_buf_cnt

274

ＵＩＢＦ解放（UIBF release）

UDP通信でUDP用受信バッファ（UIBF）解放要求をした回数。

−

275

ＵＯＢＦ定義（UOBF definition）

メモリ関連定義のudp_send_message_buf_cntオペランドの設定値。

−

276

ＵＯＢＦ空き（UOBF free）

空きUDP用送信バッファ（UOBF）数。

メモリ関連定義

udp_send_message_buf_cnt

277

ＵＯＢＦ確保要求（UOBF reservation request）

UDP通信でUDP用送信バッファ（UOBF）確保要求をした回数。

−

278

ＵＯＢＦ確保失敗（UOBF reservation failure）

UDP通信でUDP用送信バッファ（UOBF）確保に失敗した回数。

メモリ関連定義

udp_send_message_buf_cnt

279

ＵＯＢＦ割当て待ち（UOBF allocation waiting）

UDP通信でUDP用送信バッファ（UOBF）割り当て待ちのスレッド数。

メモリ関連定義

udp_send_message_buf_cnt

280

ＵＯＢＦ解放（UOBF release）

UDP通信でUDP用送信バッファ（UOBF）解放要求をした回数。

−

281

ＸＤＢ情報（XDB-information）※5

更新バッファ長（Update buffer length）

トランザクションで取得するDB更新バッファの長さ。

−

300

共有メモリ面数（Shared memory surface count）

使用中の共有メモリ面数。

XDBサービス定義

eexdbarea

301

共有メモリ合計長（Total length of shared memory）

使用中の共有メモリの合計長。

XDBサービス定義

eexdbarea

302

ＳＱＬプールリクエスト回数（SQL pool request count）

SQLプールを検索した回数。

−

303

ＳＱＬプールヒット回数（SQL pool hit count）

SQL解析結果が見つかり，前処理が省略できた回数。

XDBサービス定義

xdb_sqlpool_size

304

ＳＱＬプール登録回数（SQL pool registration count）

SQLの解析結果を登録した回数。

−

305

ＳＱＬプール掃き出し回数（SQL pool flush count）

SQLプール内のSQL解析結果を掃き出した回数。

−

306

ＳＱＬプール使用サイズ（SQL pool used size）

SQLプール内で使用しているスレッド単位のメモリサイズ。

XDBサービス定義

xdb_sqlpool_size

307

ＳＱＬプール動的メモリ確保サイズ（SQL pool memory allocation size）

SQLプールのメモリが不足して動的に確保したメモリのサイズ。

−

308

表定義情報取得要求回数（Table definition request count）

表定義情報の取得要求回数（累計）。

XDBサービス定義

xdb_tabledefpool_size

309

表定義情報取得要求エラー回数（Table definition request err count）

表定義情報を取得しようとしたときに発生したエラーの総数。

XDBサービス定義

xdb_tabledefpool_size

310

表定義プールヒット回数（Table definition pool hit count）

取得要求した表定義情報が表定義プール内で見つかった回数（累計）。

XDBサービス定義

xdb_tabledefpool_size

311

表定義プール情報掃き出し回数（Table definition pool flush count）

表定義プールから使用中でない表定義情報を掃き出した回数（累計）。

XDBサービス定義

xdb_tabledefpool_size

312

表定義プール表定義最大サイズ（Table definition pool max size）

表定義プールに登録されている表定義情報の合計長。

XDBサービス定義

xdb_tabledefpool_size

313

作業表確保ページ数（Secured pages of work table count）

作業表で確保した最大ページ数。

−

314

ＵＡＰ履歴情報（UAP-log-information）※6

ＵＡＰ履歴情報数（UAP log information count）

UAP履歴情報の取得回数。イベント数は，UAP履歴情報を取得したトランザクション数。

−

320

ＵＡＰ履歴情報サイズ（UAP log information total size）

UAP履歴情報の取得サイズ（履歴情報共通インデクスのサイズも含む）。イベント数は，UAP履歴情報を取得したトランザクション数。

−

321

ＵＡＰ履歴情報書き込み時間（UAP log information write time）

UAP履歴情報の書き込みに掛かった時間（UAP履歴情報の通番割り当てにかかった時間を含む）。イベント数は，UAP履歴情報を取得したトランザクション数。

−

322

ＵＡＰ履歴情報再書き込み回数（UAP log information rewrite count）

データ抽出ユティリティ，またはデータ連携支援を現用の履歴情報表に対して実行していて，データ抽出による追い抜きが発生した場合の再書き込み回数。

−

323

ＵＡＰ履歴情報通番割り当て時間（UAP log information assign time）

UAP履歴情報の通番割り当てにかかった時間の合計。イベント数は，UAP履歴情報を取得したトランザクション数。

−

324

ＳＤＢハンドラ情報（SDB-handler-information）※6

個別開始ＡＰＩ実行時間（Start-API execution time）

個別開始APIの実行時間。

−

330

個別終了ＡＰＩ実行時間（Finish-API execution time）

個別終了APIの実行時間。

−

331

検索/変更/格納/削除ＡＰＩ実行時間（Access-API execution time）

検索/変更/格納/削除APIの実行時間。

−

332

一括削除ＡＰＩ実行時間（Clear-API execution time）

一括削除APIの実行時間。

−

333

システム構成表示ＡＰＩ実行時間（Refer-API execution time）

システム構成表示APIの実行時間。

−

334

デッドロック回数（Deadlock count）

デッドロック，および排他待ち時間超過回数。

−

335

ＳＱＬエラー回数（SQL error count）

SQLエラー回数。

−

336

ＳＱＬ以外のエラー回数（Error count other than SQL error）

SQL以外のエラー（パラメタ，シーケンス，メモリ不足など）回数。

−

337

ワークメモリ追加確保サイズ（Work memory allocation size）

ワークメモリを追加確保したサイズ。

SDBハンドラ関連定義

sdh_workmem_size

338

ワークメモリ追加確保失敗サイズ（Work memory failure allocation size）

ワークメモリの追加確保に失敗したサイズ。

メモリ管理定義

system_work_size

max_mem_size

max_mem_size_mb

339

ワークメモリ使用サイズ（Work memory used size）

トランザクション当たりのワークメモリ使用サイズ。

SDBハンドラ関連定義

sdh_workmem_size

340

ＳＱＬ実行時間（SQL execution time）

SQL実行時間。

−

341

ＯＢＭ情報（OBM-information）※6

ＯＢＭ用プール合計サイズ（OBM pool max size）

OBM用プール合計サイズ。

メモリ管理定義

memory_obm_area_size

351

ＯＢＭ用プール空き（OBM pool free）

OBM用プール空きサイズ。

メモリ管理定義

memory_obm_area_size

352

ＯＢＭ用プール確保（OBM pool reservation）

OBM用プール確保回数。

−

353

ＯＢＭ用プール解放（OBM pool release）

OBM用プール解放回数。

−

354

ＯＢＭ用プール確保失敗（OBM pool reservation failure）

OBM用プール確保エラー時の要求サイズ。

メモリ管理定義

memory_obm_area_size

355

ＯＢＭ管理表ＳＱＬ実行時間（OBM table SQL exec time）

OBM管理表へのSQL実行時間。イベント数は，OBM管理表へのSQL実行時間を取得したトランザクション回数。

−

356

バッチデータ表ＳＱＬ実行時間（Batch data table SQL exec time）

バッチデータ表へのSQL実行時間。イベント数は，バッチデータ表へのSQL実行時間を取得したトランザクション回数。

−

357

トラブルシュート情報（troubleshooting-information）

ＴＡＳＫＴＭスレッド排他関数実行時間（TASKTM exclusive execution time）

TASKTMスレッドがバッファの出力要求を受け付けてから，I/O待ちのため滞留しているバッファのI/Oが完了するまでの排他関数実行時間。

−

401

ＴＡＳＫＴＭスレッド排他関数実行回数（TASKTM exclusive execution cnt）

TASKTMスレッドがバッファの出力要求を受け付けてから，I/O待ちのため滞留しているバッファのI/Oが完了するまでの排他関数実行回数。

−

402

ＴＡＳＫＴＭスレッド滞留バッファ数（TASKTM thread retention）

TASKTMスレッドでI/O待ちのため滞留しているバッファ数。イベント数は，TASKTMスレッドキュー引き出し回数。

トラブルシュート関連定義

trb_tasktm_buffer_no

trb_tasktm_buffer_size

trb_line_trace_buffer_no

trb_line_xatrace_buffer_no

trb_line_trace_buffer_size

trb_uap_trace_buffer_no

trb_uap_trace_buffer_size

trb_extend_functionオペランドに00000100を指定した場合は，次の定義も指定してください。

トラブルシュート関連定義

trb_stc_buffer_no

trb_stc_buffer_size

MCP構成定義のeemcptrcコマンドの-bオプション

XDBサービス定義

xdb_trace_buffer_number

xdb_trace_buffer_size

403

ＴＡＳＫＴＭ出力レコード数（TASKTM output records）

ファイルに出力したTASKTMレコードの数。

−

411

ＴＡＳＫＴＭ破棄レコード数（TASKTM destruction records）

ファイルに出力しないで破棄したTASKTMレコードの数。

トラブルシュート関連定義

trb_tasktm_buffer_no

trb_tasktm_buffer_size

412

ＴＡＳＫＴＭブロックのレコード数（TASKTM records per block）

TASKTMブロックごとのレコード数。

トラブルシュート関連定義

trb_tasktm_buffer_size

413

ＴＡＳＫＴＭブロック長（TASKTM block size）

TASKTMのブロック長。

トラブルシュート関連定義

trb_tasktm_buffer_size

414

ＴＡＳＫＴＭｗｒｉｔｅ時間（TASKTM write time）

TASKTMブロック出力のwriteシステムコール実行時間。

−

415

ＴＡＳＫＴＭｏｐｅｎ時間（TASKTM open time）

TASKTMファイルスワップ時のopenシステムコール実行時間。イベント数は，TASKTMファイルスワップ回数。

トラブルシュート関連定義

trb_tasktm_file_size

trb_tasktm_file_no

416

ＴＡＳＫＴＭｃｌｏｓｅ時間（TASKTM close time）

TASKTMファイルスワップ時のcloseシステムコール実行時間。イベント数は，TASKTMファイルスワップ回数。

トラブルシュート関連定義

trb_tasktm_file_size

trb_tasktm_file_no

417

回線トレース出力レコード数（Line trace output records）

ファイルに出力した回線トレースレコードの数。

−

421

回線トレース破棄レコード数（Line trace destruction records）

ファイルに出力しないで破棄した回線トレースレコードの数。

トラブルシュート関連定義

trb_line_trace_buffer_no

trb_line_xatrace_buffer_no

trb_line_trace_buffer_size

422

回線トレースブロックのレコード数（Line trace records per block）

回線トレースブロックごとのレコード数。

トラブルシュート関連定義

trb_line_trace_buffer_size

423

回線トレースブロック長（Line trace block size）

回線トレースのブロック長。

トラブルシュート関連定義

trb_line_trace_buffer_size

424

回線トレースｗｒｉｔｅ時間（Line trace write time）

回線トレースブロック出力のwriteシステムコール実行時間。

−

425

回線トレースｏｐｅｎ時間（Line trace open time）

回線トレースファイルスワップ時のopenシステムコール実行時間。イベント数は，回線トレースファイルスワップ回数。

トラブルシュート関連定義

trb_trace_file_size

trb_trace_file_no

426

回線トレースｃｌｏｓｅ時間（Line trace close time）

回線トレースファイルスワップ時のcloseシステムコール実行時間。イベント数は，回線トレースファイルスワップ回数。

トラブルシュート関連定義

trb_trace_file_size

trb_trace_file_no

427

ＵＡＰトレース出力レコード数（UAP trace output records）

ファイルに出力したUAPトレースレコードの数。

−

431

ＵＡＰトレース破棄レコード数（UAP trace destruction records）

ファイルに出力しないで破棄したUAPトレースレコードの数。

トラブルシュート関連定義

trb_uap_trace_buffer_no

trb_uap_trace_buffer_size

432

ＵＡＰトレースブロックのレコード数（UAP trace records per block）

UAPトレースブロックごとのレコード数。

トラブルシュート関連定義

trb_uap_trace_buffer_size

433

ＵＡＰトレースブロック長（UAP trace block size）

UAPトレースのブロック長。

トラブルシュート関連定義

trb_uap_trace_buffer_size

434

ＵＡＰトレースｗｒｉｔｅ時間（UAP trace write time）

UAPトレースブロック出力のwriteシステムコール実行時間。

−

435

ＵＡＰトレースｏｐｅｎ時間（UAP trace open time）

UAPトレースファイルスワップ時のopenシステムコール実行時間。イベント数は，UAPトレースファイルスワップ回数。

トラブルシュート関連定義

trb_uap_trace_file_size

trb_uap_trace_file_no

436

ＵＡＰトレースｃｌｏｓｅ時間（UAP trace close time）

UAPトレースファイルスワップ時のcloseシステムコール実行時間。イベント数は，UAPトレースファイルスワップ回数。

トラブルシュート関連定義

trb_uap_trace_file_size

trb_uap_trace_file_no

437

統計情報スレッド排他関数実行時間（Statistics exclusive execution time）

統計情報スレッドがバッファの出力要求を受け付けてから，I/O待ちのため滞留しているバッファのI/Oが完了するまでの排他関数実行時間。

−

441

統計情報スレッド排他関数実行回数（Statistics exclusive execution cnt）

統計情報スレッドがバッファの出力要求を受け付けてから，I/O待ちのため滞留しているバッファのI/Oが完了するまでの排他関数実行回数。

−

442

統計情報スレッド滞留バッファ数（Statistics thread retention）

統計情報スレッドでI/O待ちのため滞留しているバッファ数。イベント数は，統計情報スレッドキュー引き出し回数。

トラブルシュート関連定義

trb_stc_buffer_no

trb_stc_buffer_size

443

統計情報出力レコード数（Statistics output records）

ファイルに出力した統計情報レコードの数。

−

451

統計情報破棄レコード数（Statistics destruction records）

ファイルに出力しないで破棄した統計情報レコードの数。

トラブルシュート関連定義

trb_stc_buffer_no

trb_stc_buffer_size

452

統計情報ブロックのレコード数（Statistics records per block）

統計情報ブロックごとのレコード数。

トラブルシュート関連定義

trb_stc_buffer_no

trb_stc_buffer_size

453

統計情報ブロック長（Statistics block size）

統計情報のブロック長。

トラブルシュート関連定義

trb_stc_buffer_size

454

統計情報ｗｒｉｔｅ時間（Statistics write time）

統計情報ブロック出力のwriteシステムコール実行時間。

−

455

統計情報ｏｐｅｎ時間（Statistics open time）

統計情報ファイルスワップ時のopenシステムコール実行時間。イベント数は，統計情報ファイルスワップ回数。

トラブルシュート関連定義

trb_stc_file_size

trb_stc_file_no

456

統計情報ｃｌｏｓｅ時間（Statistics close time）

統計情報ファイルスワップ時のcloseシステムコール実行時間。イベント数は，統計情報ファイルスワップ回数。

トラブルシュート関連定義

trb_stc_file_size

trb_stc_file_no

457

ＰＰスレッド排他関数実行時間（PP exclusive execution time）

PPスレッドがバッファの出力要求を受け付けてから，I/O待ちのため滞留しているバッファのI/Oが完了するまでの排他関数実行時間。

−

461

ＰＰスレッド排他関数実行回数（PP exclusive execution cnt）

PPスレッドがバッファの出力要求を受け付けてから，I/O待ちのため滞留しているバッファのI/Oが完了するまでの排他関数実行回数。

−

462

ＰＰスレッド滞留バッファ数（PP thread retention）

PPスレッドでI/O待ちのため滞留しているバッファ数。イベント数は，PPスレッドキュー引き出し回数。

MCP構成定義のeemcptrcコマンドの-bオプション

463

ＭＣＰトレース出力レコード数（MCP trace output records）

ファイルに出力したMCPトレースレコードの数。

−

471

ＭＣＰトレース破棄レコード数（MCP trace destruction records）

ファイルに出力しないで破棄したMCPトレースレコードの数。

MCP構成定義のeemcptrcコマンドの-bオプション

472

ＭＣＰトレースブロックのレコード数（MCP trace records per block）

MCPトレースブロックごとのレコード数。

MCP構成定義のeemcptrcコマンドの-bオプション

473

ＭＣＰトレースブロック長（MCP trace block size）

MCPトレースのブロック長。

MCP構成定義のeemcptrcコマンドの-bオプションのbufferszオペランド

474

ＭＣＰトレースｗｒｉｔｅ時間（MCP trace write time）

MCPトレースブロック出力のwriteシステムコール実行時間。

−

475

ＭＣＰトレースｏｐｅｎ時間（MCP trace open time）

MCPトレースファイルスワップ時のopenシステムコール実行時間。イベント数は，MCPトレースファイルスワップ回数。

MCP構成定義のeemcptrcコマンドの-fオプション

476

ＭＣＰトレースｃｌｏｓｅ時間（MCP trace close time）

MCPトレースファイルスワップ時のcloseシステムコール実行時間。イベント数は，MCPトレースファイルスワップ回数。

MCP構成定義のeemcptrcコマンドの-fオプション

477

ＸＤＢスレッド排他関数実行時間（XDB trace exclusive execution time）

XDBスレッドがバッファの出力要求を受け付けてから，I/O待ちのため滞留しているバッファのI/Oが完了するまでの排他関数実行時間。

−

481

ＸＤＢスレッド排他関数実行回数（XDB trace exclusive execution cnt）

XDBスレッドがバッファの出力要求を受け付けてから，I/O待ちのため滞留しているバッファのI/Oが完了するまでの排他関数実行回数。

−

482

ＸＤＢスレッド滞留バッファ数（XDB trace thread retention）

XDBスレッドでI/O待ちのため滞留しているバッファ数。イベント数は，XDBスレッドキュー引き出し回数。

XDBサービス定義

xdb_trace_buffer_number

xdb_trace_buffer_size

483

ＸＤＢトレース出力レコード数（XDB trace output records）

ファイルに出力したXDBトレースレコードの数。

−

491

ＸＤＢトレース破棄レコード数（XDB trace destruction records）

ファイルに出力しないで破棄したXDBトレースレコードの数。

XDBサービス定義

xdb_trace_buffer_number

xdb_trace_buffer_size

492

ＸＤＢトレースブロックのレコード数（XDB trace records per block）

XDBトレースブロックごとのレコード数。

XDBサービス定義

xdb_trace_buffer_size

493

ＸＤＢトレースブロック長（XDB trace block size）

XDBトレースのブロック長。

XDBサービス定義

xdb_trace_buffer_size

494

ＸＤＢトレースｗｒｉｔｅ時間（XDB trace write time）

XDBトレースブロック出力のwriteシステムコール実行時間。

−

495

ＸＤＢトレースｏｐｅｎ時間（XDB trace open time）

XDBトレース情報ファイルスワップ時のopenシステムコール実行時間。イベント数は，XDBトレースファイルスワップ回数。

XDBサービス定義

xdb_trace_file_number

xdb_trace_file_size

496

ＸＤＢトレースｃｌｏｓｅ時間（XDB trace close time）

XDBトレース情報ファイルスワップ時のcloseシステムコール実行時間。イベント数は，XDBトレースファイルスワップ回数。

XDBサービス定義

xdb_trace_file_number

xdb_trace_file_size

497

（凡例）

−：該当なし。

注※1

統計情報を参考にチューニングする定義です。

注※2

eetrbreportコマンドおよびeetrbstcedコマンド実行時に指定する引数です。

注※3

サービス要求先のサーバが統計情報機能をサポートしていない場合は取得しません。

注※4

XTC使用時に，eetrbstcseコマンドでXTCのシステム統計情報の取得を指定した場合に取得します。

注※5

XDB使用時に，eetrbstcseコマンドでXDBのシステム統計情報の取得を指定した場合に取得します。各事象の詳細，およびこれらのシステム統計情報を使ったチューニング方法については，マニュアル「TP1/EE/Extended Data Cache 使用の手引」の「システム統計情報に出力されるXDBに関する情報」を参照してください。

注※6

TP1/FSP使用時に取得します。各事象の詳細，およびこれらのシステム統計情報を使ったチューニング方法については，TP1/FSPの関連ドキュメントを参照してください。

システム統計情報の編集内容を次の表に示します。

表中の「数」は特に説明がない場合，そのイベントの発生回数です。

表中の「単位」は事象の単位です。なお，システム統計情報の発生件数が0の場合，編集値は意味のない値になります。

表B‒2　システム統計情報の編集内容

統計情報種別

編集内容

統計情報編集ID※1

イベント

数

編集値

平均

最大

最小

単位

ｒｐｃ情報

（RPC-information）（rpc）

ｒｐｃコールレスポンスタイム（RPC call response time）※2

○※3

○

○

○

マイクロ秒（microsec.）

1

ユーザサービス実行時間（User service execution time）※2

○※3

○

○

○

マイクロ秒（microsec.）

2

ｒｐｃタイムアウト（RPC timeout）

○

−

−

−

−

3

ＩＢＦ定義（IBF definition）

−

○

−

−

面（pages）

4

ＩＢＦ空き（IBF free）

○※4

○

−

○

面（pages）

5

ＩＢＦ確保要求（IBF reservation request）

○

−

−

−

−

6

ＩＢＦ確保失敗（IBF reservation failure）

○

−

−

−

−

7

ＩＢＦ割当て待ち（IBF allocation waiting）

○※5

○

○

−

スレッド（threads）

8

ＩＢＦ解放（IBF release）

○

−

−

−

−

9

ＯＢＦ定義（OBF definition）

−

○

−

−

面（pages）

10

ＯＢＦ空き（OBF free）

○※4

○

−

○

面（pages）

11

ＯＢＦ確保要求（OBF reservation request）

○

−

−

−

−

12

ＯＢＦ確保失敗（OBF reservation failure）

○

−

−

−

−

13

ＯＢＦ割当て待ち（OBF allocation waiting）

○※5

○

○

−

スレッド（threads）

14

ＯＢＦ解放（OBF release）

○

−

−

−

−

15

ＥＡＧＡＩＮ（EAGAIN）

○

−

−

−

−

16

ディスクリプタ不足（Descriptor shortage）

○

−

−

−

−

17

一時クローズ処理開始（Temporary closing start）

○

−

−

−

回数

18

一時クローズ要求送信（Temporary closing request send）

○

−

−

−

回数

19

一時クローズ要求受信（Temporary closing request receive）

○

−

−

−

回数

20

ｒｐｃ情報

（RPC-information）（rap）

常設コネクション不足（Permanent connection shortage）

○

−

−

−

−

31

クライアントの常設コネクション不足（Client permanent connection shortage）

○

−

−

−

−

32

常設コネクション数（Permanent connection count）

○※5

○

○

−

−

33

クライアントの常設コネクション数（Client permanent connection count）

○※5

○

○

−

−

34

ｒｐｃ情報

（RPC-information）（nam）

ｌｏｏｋｕｐ（Lookup）

○

−

−

−

−

41

キャッシュ不足（Cache shortage）

○

−

−

−

−

42

キャッシュヒット（Cache hits）

○

−

−

−

−

43

キャッシュミスヒット（Cache missed hits）

○

−

−

−

−

44

負荷レベルの変動（Load level variance）

○

−

−

−

−

45

高負荷時の転送（Transfer during high load）

○

−

−

−

−

46

高負荷時以外の転送（Transfer other than during high load）

○

−

−

−

−

47

ｒｐｃ情報（RPC-information）（UDP）

送信パケット（Sending packet）

○

−

−

−

−

50

再送パケット（Sending again packet）

○

−

−

−

−

51

再送パケット比率（Sending again packet ratio）

○

○

○

○

％

52

ＮＡＣＫ受信（NACK receive）

○

−

−

−

−

53

再送タイマタイムアウト（Sending again timer time out）

○

−

−

−

−

54

輻輳変動（Congestion change）

○

−

−

−

−

55

送信ソケット空き待ち（Sending socket space waiting）

○

−

−

−

−

56

通信時間（Communication time）

○

○

○

○

マイクロ秒（microsec.）

57

受信パケット（Receiving packet）

○

−

−

−

−

58

重複パケット破棄（Duplication packet destroy）

○

−

−

−

−

59

欠落パケット破棄（Defective packet destroy）

○

−

−

−

−

60

旧パケット破棄（Old packet destroy）

○

−

−

−

−

61

受信タイムアウト（Receiving time out）

○

−

−

−

−

62

タイマ情報

（timer-information）

ＩＣＢ定義（ICB definition）

−

○

−

−

面（pages）

71

ＩＣＢ空き（ICB free）

○※4

○

−

○

面（pages）

72

ＩＣＢ確保要求（ICB reservation request）

○

−

−

−

−

73

ＩＣＢ確保失敗（ICB reservation failure）

○

−

−

−

−

74

ＩＣＢ割当て待ち（ICB allocation waiting）

○※5

○

○

−

スレッド（threads）

75

ＩＣＢ解放（ICB release）

○

−

−

−

−

76

ＴＴＢＦ定義（TTBF definition）

−

○

−

−

面（pages）

77

ＴＴＢＦ空き（TTBF free）

○※4

○

−

○

面（pages）

78

ＴＴＢＦ確保要求（TTBF reservation request）

○

−

−

−

−

79

ＴＴＢＦ確保失敗（TTBF reservation failure）

○

−

−

−

−

80

ＴＴＢＦ割当て待ち（TTBF allocation waiting）

○※5

○

○

−

スレッド（threads）

81

ＴＴＢＦ解放（TTBF release）

○

−

−

−

−

82

スケジュール情報

（schedule-information）

ＰＣＥ定義（PCE definition）

−

○

−

−

面（pages）

91

ＰＣＥ空き（PCE free）

○※4

○

−

○

面（pages）

92

ＰＣＥ確保要求（PCE reservation request）

○

−

−

−

−

93

ＰＣＥ確保失敗（PCE reservation failure）

○

−

−

−

−

94

ＰＣＥ割当て待ち（PCE allocation waiting）

○※5

○

○

−

スレッド（threads）

95

ＰＣＥ解放（PCE release）

○

−

−

−

−

96

予備処理スレッド引出し（Standby processing thread withdrawal）

○

−

−

−

−

97

予備処理スレッド起動（Standby processing thread startup）

−

−

○

−

スレッド（threads）

98

ＰＣＥ滞留率（PCE retention rate）

○

○

○

−

％

99

処理キュー引出し待ち時間（Processing queue wait time）

○※6

○

○

○

マイクロ秒（microsec.）

100

トランザクション情報

（transaction-information）

トランザクションブランチ起動（Transaction branch startup）

○※6

○

○

−

ブランチ（branches）

121

コミット（Commit）

○

−

−

−

−

122

ロールバック（Rollback）

○

−

−

−

−

123

ＵＡＰ実行時間（UAP execution time）

○※7

○

○

○

マイクロ秒（microsec.）

124

ＡＰＩ情報

（api-information）

ＳＱＬ実行時間（SQL execution time）

○※6

○

○

○

マイクロ秒（microsec.）

141

ＡＰＩ実行時間（API execution time）

○※6

○

○

○

マイクロ秒（microsec.）

142

排他ＡＰＩ保持時間（Ex-API remain time）

○

○

○

○

マイクロ秒（microsec.）

143

排他ＡＰＩ待ち時間（Ex-API wait time）

○※6

○

○

○

マイクロ秒（microsec.）

144

排他ＡＰＩ待ち行列数（Ex-API wait que cnt）

○※6

○

○

○

−

145

排他ＡＰＩ待ちタイムアウト回数（Ex-API wait timeout cnt）

○※6

○

○

○

−

146

スレッド情報

（thread-information）

ＣＰＵ時間（CPU time）

○

○

○

○

ミリ秒（millisec.）

152

ステータスファイル情報

（status-file-information）

スタック用バッファヒット率（Hit rate for buffer stacks）

○

○

−

−

％

161

スワップ時間（Swap time）

○

○

○

○

マイクロ秒（microsec.）

162

ファイルサービス情報

（file-service-information）

Ｉ／Ｏ時間（I/O time）

○※6

○

○

○

マイクロ秒（microsec.）

171

メモリ情報

（memory-information）

システム用ワーク領域空き（System work area free）

○※4

○

−

○

バイト（bytes）

181

システム用ワーク確保（System work reservation

○

−

−

−

−

182

システム用ワーク解放（System work release）

○

−

−

−

−

183

システム用ワーク確保失敗（System work reservation failure）

○

−

○

−

バイト（bytes）

184

ユーザ用ワーク領域空き（User work area free）

○※4

○

−

○

バイト（bytes）

185

ユーザ用ワーク確保（User work reservation）

○

−

−

−

−

186

ユーザ用ワーク解放（User work release）

○

−

−

−

−

187

ユーザ用ワーク確保失敗（User work reservation failure）

○

−

○

−

バイト（bytes）

188

共用ワーク領域空き（Shared work area free）

○※4

○

−

○

バイト（bytes）

189

共用ワーク確保（Shared work reservation）

○

−

−

−

−

190

共用ワーク解放（Shared work release）

○

−

−

−

−

191

共用ワーク確保失敗（Shared work reservation failure）

○

−

○

−

バイト（bytes）

192

ＣＯＢＯＬ用プール空き（COBOL pool free）

○※4

○

−

○

バイト（bytes）

193

ＣＯＢＯＬ用プール確保（COBOL pool reservation）

○

−

−

−

−

194

ＣＯＢＯＬ用プール解放（COBOL pool release）

○

−

−

−

−

195

ＣＯＢＯＬ用プール確保失敗（COBOL pool reservation failure）

○

−

○

−

バイト（bytes）

196

ＸＴＣ用プール空き（XTC pool free）

○※4

○

−

○

バイト（bytes）

197

ＸＴＣ用プール確保（XTC pool reservation）

○

−

−

−

−

198

ＸＴＣ用プール解放（XTC pool release）

○

−

−

−

−

199

ＸＴＣ用プール確保失敗（XTC pool reservation failure）

○

−

○

−

バイト（bytes）

200

ＸＤＢ用プール空き（XDB pool free）

○※4

○

−

○

バイト（bytes）

201

ＸＤＢ用プール確保（XDB pool reservation）

○

−

−

−

−

202

ＸＤＢ用プール解放（XDB pool release）

○

−

−

−

−

203

ＸＤＢ用プール確保失敗（XDB pool reservation failure）

○

−

○

−

バイト（bytes）

204

大量処理用システムプール空き（MDP system pool free）

○※4

○

−

○

バイト（bytes）

205

大量処理用システムプール確保（MDP system pool reservation）

○

−

−

−

−

206

大量処理用システムプール解放（MDP system pool release）

○

−

−

−

−

207

大量処理用システムプール確保失敗（MDP system pool reservation failure）

○

−

○

−

バイト（bytes）

208

大量処理用ユーザプール空き（MDP user pool free）

○※4

○

−

○

バイト（bytes）

209

大量処理用ユーザプール確保（MDP user pool reservation）

○

−

−

−

−

210

大量処理用ユーザプール解放（MDP user pool release）

○

−

−

−

−

211

大量処理用ユーザプール確保失敗（MDP user pool reservation failure）

○

−

○

−

バイト（bytes）

212

ＸＴＣ用プール合計サイズ（XTC pool max size）

○※4

○

○

○

バイト（bytes）

213

ＸＤＢ用プール合計サイズ（XDB pool max size）

○※4

○

○

○

バイト（bytes）

214

大量処理用システムプール合計サイズ（MDP system pool max size）

−

−

○

○

バイト（bytes）

215

大量処理用ユーザプール合計サイズ（MDP user pool max size）

−

−

○

○

バイト（bytes）

216

ＤＢキュー情報

（DB-queue-information）

アクセス時間（Access time）

○※6

○

○

○

マイクロ秒（microsec.）

221

ＱＩＢＦ定義（QIBF definition）

−

−

○

−

面（pages）

222

ＱＩＢＦ空き（QIBF free）

○※4

○

−

○

面（pages）

223

ＱＩＢＦ確保要求（QIBF reservation request）

○

−

−

−

−

224

ＱＩＢＦ確保失敗（QIBF reservation failure）

○

−

−

−

−

225

ＱＩＢＦ割当て待ち（QIBF allocation waiting）

○※5

○

○

−

スレッド（threads）

226

ＱＩＢＦ解放（QIBF release）

○

−

−

−

−

227

ＱＯＢＦ定義（QOBF definition）

−

○

−

−

面（pages）

228

ＱＯＢＦ空き（QOBF free）

○※4

○

−

○

面（pages）

229

ＱＯＢＦ確保要求（QOBF reservation request）

○

−

−

−

−

230

ＱＯＢＦ確保失敗（QOBF reservation failure）

○

−

−

−

−

231

ＱＯＢＦ割当て待ち（QOBF allocation waiting）

○※5

○

○

−

スレッド（threads）

232

ＱＯＢＦ解放（QOBF release）

○

−

−

−

−

233

ＱＷＢＦ定義（QWBF definition）

−

○

−

−

面（pages）

234

ＱＷＢＦ空き（QWBF free）

○※4

○

−

○

面（pages）

235

ＱＷＢＦ確保要求（QWBF reservation request）

○

−

−

−

−

236

ＱＷＢＦ確保失敗（QWBF reservation failure）

○

−

−

−

−

237

ＱＷＢＦ割当て待ち（QWBF allocation waiting）

○※5

○

○

−

スレッド（threads）

238

ＱＷＢＦ解放（QWBF release）

○

−

−

−

−

239

ＸＴＣ情報（XTC-information）

ＵＩＢＦ定義（UIBF definition）

−

○

−

−

面（pages）

270

ＵＩＢＦ空き（UIBF free）

○※4

○

−

○

面（pages）

271

ＵＩＢＦ確保要求（UIBF reservation request）

○

−

−

−

−

272

ＵＩＢＦ確保失敗（UIBF reservation failure）

○

−

−

−

−

273

ＵＩＢＦ割当て待ち（UIBF allocation waiting）

○※5

○

○

−

スレッド（threads）

274

ＵＩＢＦ解放（UIBF release）

○

−

−

−

−

275

ＵＯＢＦ定義（UOBF definition）

−

○

−

−

面（pages）

276

ＵＯＢＦ空き（UOBF free）

○※4

○

−

○

面（pages）

277

ＵＯＢＦ確保要求（UOBF reservation request）

○

−

−

−

−

278

ＵＯＢＦ確保失敗（UOBF reservation failure）

○

−

−

−

−

279

ＵＯＢＦ割当て待ち（UOBF allocation waiting）

○※5

○

○

−

スレッド（threads）

280

ＵＯＢＦ解放（UOBF release）

○

−

−

−

−

281

ＸＤＢ情報（XDB-information）

更新バッファ長（Update buffer length）

○※7

○

○

○

バイト（bytes）

300

共有メモリ面数（Shared memory surface count）

−

−

○

−

面（pages）

301

共有メモリ合計長（Total length of shared memory）

−

−

○

−

バイト（bytes）

302

ＳＱＬプールリクエスト回数（SQL pool request count）

○

−

−

−

回数

303

ＳＱＬプールヒット回数（SQL pool hit count）

○

−

−

−

回数

304

ＳＱＬプール登録回数（SQL pool registration count）

○

−

−

−

回数

305

ＳＱＬプール掃き出し回数（SQL pool flush count）

○

−

−

−

回数

306

ＳＱＬプール使用サイズ（SQL pool used size）

○※8

○

○

○

バイト（bytes）

307

ＳＱＬプール動的メモリ確保サイズ（SQL pool memory allocation size）

○※9

○

○

○

バイト（bytes）

308

表定義情報取得要求回数（Table definition request count）

○

−

−

−

回数

309

表定義情報取得要求エラー回数（Table definition request err count）

○

−

−

−

回数

310

表定義プールヒット回数（Table definition pool hit count）

○

−

−

−

回数

311

表定義プール情報掃き出し回数（Table definition pool flush count）

○

−

−

−

回数

312

表定義プール表定義最大サイズ（Table definition pool max size）

−

−

○

−

バイト（bytes）

313

作業表確保ページ数（Secured pages of work table count）

−

−

○

−

ページ（Page）

314

ＵＡＰ履歴情報（UAP-log-information）※10

ＵＡＰ履歴情報数（UAP log information count）

○※6

○

○

○

−

320

ＵＡＰ履歴情報サイズ（UAP log information total size）

○※6

○

○

○

バイト（bytes）

321

ＵＡＰ履歴情報書き込み時間（UAP log information write time）

○※6

○

○

○

マイクロ秒（microsec.）

322

ＵＡＰ履歴情報再書き込み回数（UAP log information rewrite count）

○

−

−

−

−

323

ＵＡＰ履歴情報通番割り当て時間（UAP log information assign time）

○

○

○

○

マイクロ秒（microsec.）

324

ＳＤＢハンドラ情報（SDB-handler-information）※10

個別開始ＡＰＩ実行時間（Start-API execution time）

○※11

○

○

○

マイクロ秒（microsec.）

330

個別終了ＡＰＩ実行時間（Finish-API execution time）

○※11

○

○

○

マイクロ秒（microsec.）

331

検索/変更/格納/削除ＡＰＩ実行時間（Access-API execution time）

○※11

○

○

○

マイクロ秒（microsec.）

332

一括削除ＡＰＩ実行時間（Clear-API execution time）

○※11

○

○

○

マイクロ秒（microsec.）

333

システム構成表示ＡＰＩ実行時間（Refer-API execution time）

○※11

○

○

○

マイクロ秒（microsec.）

334

デッドロック回数（Deadlock count）

○

−

−

−

−

335

ＳＱＬエラー回数（SQL error count）

○

−

−

−

−

336

ＳＱＬ以外のエラー回数（Error count other than SQL error）

○

−

−

−

−

337

ワークメモリ追加確保サイズ（Work memory allocation size）

○※12

○

○

○

キロバイト（Kbytes）

338

ワークメモリ追加確保失敗サイズ（Work memory failure allocation size）

○※13

○

○

○

キロバイト（Kbytes）

339

ワークメモリ使用サイズ（Work memory used size）

○※14

○

○

○

キロバイト（Kbytes）

340

ＳＱＬ実行時間（SQL execution time）

○※6

○

○

○

マイクロ秒（microsec.）

341

ＯＢＭ情報（OBM-information）※10

ＯＢＭ用プール合計サイズ（OBM pool max size）

○※4

○

○

○

バイト（bytes）

351

ＯＢＭ用プール空き（OBM pool free）

○※4

○

−

○

バイト（bytes）

352

ＯＢＭ用プール確保（OBM pool reservation）

○

−

−

−

−

353

ＯＢＭ用プール解放（OBM pool release）

○

−

−

−

−

354

ＯＢＭ用プール確保失敗（OBM pool reservation failure）

○

−

○

−

バイト（bytes）

355

ＯＢＭ管理表ＳＱＬ実行時間（OBM table SQL exec time）

○

○

○

○

マイクロ秒（microsec.）

356

バッチデータ表ＳＱＬ実行時間（Batch data table SQL exec time）

○

○

○

○

マイクロ秒（microsec.）

357

トラブルシュート情報（troubleshooting-information）

ＴＡＳＫＴＭスレッド排他関数実行時間（TASKTM exclusive execution time）

○

○

○

○

マイクロ秒（microsec.）

401

ＴＡＳＫＴＭスレッド排他関数実行回数（TASKTM exclusive execution cnt）

○

○

○

○

−

402

ＴＡＳＫＴＭスレッド滞留バッファ数（TASKTM thread retention）

○※15

○

○

○

面（pages）

403

ＴＡＳＫＴＭ出力レコード数（TASKTM output records）

○

−

−

−

−

411

ＴＡＳＫＴＭ破棄レコード数（TASKTM destruction records）

○

−

−

−

−

412

ＴＡＳＫＴＭブロックのレコード数（TASKTM records per block）

○

○

○

○

−

413

ＴＡＳＫＴＭブロック長（TASKTM block size）

○

○

○

○

バイト（bytes）

414

ＴＡＳＫＴＭｗｒｉｔｅ時間（TASKTM write time）

○

○

○

○

マイクロ秒（microsec.）

415

ＴＡＳＫＴＭｏｐｅｎ時間（TASKTM open time）

○※16

○

○

○

マイクロ秒（microsec.）

416

ＴＡＳＫＴＭｃｌｏｓｅ時間（TASKTM close time）

○※16

○

○

○

マイクロ秒（microsec.）

417

回線トレース出力レコード数（Line trace output records）

○

−

−

−

−

421

回線トレース破棄レコード数（Line trace destruction records）

○

−

−

−

−

422

回線トレースブロックのレコード数（Line trace records per block）

○

○

○

○

−

423

回線トレースブロック長（Line trace block size）

○

○

○

○

バイト（bytes）

424

回線トレースｗｒｉｔｅ時間（Line trace write time）

○

○

○

○

マイクロ秒（microsec.）

425

回線トレースｏｐｅｎ時間（Line trace open time）

○※16

○

○

○

マイクロ秒（microsec.）

426

回線トレースｃｌｏｓｅ時間（Line trace close time）

○※16

○

○

○

マイクロ秒（microsec.）

427

ＵＡＰトレース出力レコード数（UAP trace output records）

○

−

−

−

−

431

ＵＡＰトレース破棄レコード数（UAP trace destruction records）

○

−

−

−

−

432

ＵＡＰトレースブロックのレコード数（UAP trace records per block）

○

○

○

○

−

433

ＵＡＰトレースブロック長（UAP trace block size）

○

○

○

○

バイト（bytes）

434

ＵＡＰトレースｗｒｉｔｅ時間（UAP trace write time）

○

○

○

○

マイクロ秒（microsec.）

435

ＵＡＰトレースｏｐｅｎ時間（UAP trace open time）

○※16

○

○

○

マイクロ秒（microsec.）

436

ＵＡＰトレースｃｌｏｓｅ時間（UAP trace close time）

○※16

○

○

○

マイクロ秒（microsec.）

437

統計情報スレッド排他関数実行時間（Statistics exclusive execution time）

○

○

○

○

マイクロ秒（microsec.）

441

統計情報スレッド排他関数実行回数（Statistics exclusive execution cnt）

○

○

○

○

−

442

統計情報スレッド滞留バッファ数（Statistics thread retention）

○※15

○

○

○

面（pages）

443

統計情報出力レコード数（Statistics output records）

○

−

−

−

−

451

統計情報破棄レコード数（Statistics destruction records）

○

−

−

−

−

452

統計情報ブロックのレコード数（Statistics records per block）

○

○

○

○

−

453

統計情報ブロック長（Statistics block size）

○

○

○

○

バイト（bytes）

454

統計情報ｗｒｉｔｅ時間（Statistics write time）

○

○

○

○

マイクロ秒（microsec.）

455

統計情報ｏｐｅｎ時間（Statistics open time）

○※16

○

○

○

マイクロ秒（microsec.）

456

統計情報ｃｌｏｓｅ時間（Statistics close time）

○※16

○

○

○

マイクロ秒（microsec.）

457

ＰＰスレッド排他関数実行時間（PP exclusive execution time）

○

○

○

○

マイクロ秒（microsec.）

461

ＰＰスレッド排他関数実行回数（PP exclusive execution cnt）

○

○

○

○

−

462

ＰＰスレッド滞留バッファ数（PP thread retention）

○※15

○

○

○

面（pages）

463

ＭＣＰトレース出力レコード数（MCP trace output records）

○

−

−

−

−

471

ＭＣＰトレース破棄レコード数（MCP trace destruction records）

○

−

−

−

−

472

ＭＣＰトレースブロックのレコード数（MCP trace records per block）

○

○

−

−

−

473

ＭＣＰトレースブロック長（MCP trace block size）

○

○

○

○

バイト（bytes）

474

ＭＣＰトレースｗｒｉｔｅ時間（MCP trace write time）

○

○

○

○

マイクロ秒（microsec.）

475

ＭＣＰトレースｏｐｅｎ時間（MCP trace open time）

○※16

○

○

○

マイクロ秒（microsec.）

476

ＭＣＰトレースｃｌｏｓｅ時間（MCP trace close time）

○※16

○

○

○

マイクロ秒（microsec.）

477

ＸＤＢスレッド排他関数実行時間（XDB trace exclusive execution time）

○

○

○

○

マイクロ秒（microsec.）

481

ＸＤＢスレッド排他関数実行回数（XDB trace exclusive execution cnt）

○

○

○

○

−

482

ＸＤＢスレッド滞留バッファ数（XDB trace thread retention）

○※15

○

○

○

面（pages）

483

ＸＤＢトレース出力レコード数（XDB trace output records）

○

−

−

−

−

491

ＸＤＢトレース破棄レコード数（XDB trace destruction records）

○

−

−

−

−

492

ＸＤＢトレースブロックのレコード数（XDB trace records per block）

○

○

○

○

−

493

ＸＤＢトレースブロック長（XDB trace block size）

○

○

○

○

バイト（bytes）

494

ＸＤＢトレースｗｒｉｔｅ時間（XDB trace write time）

○

○

○

○

マイクロ秒（microsec.）

495

ＸＤＢトレースｏｐｅｎ時間（XDB trace open time）

○※16

○

○

○

マイクロ秒（microsec.）

496

ＸＤＢトレースｃｌｏｓｅ時間（XDB trace close time）

○※16

○

○

○

マイクロ秒（microsec.）

497

（凡例）

○：編集，出力します。

−：編集，出力しません。

注※1

eetrbreportコマンドおよびeetrbstcedコマンド実行時に指定する引数です。

注※2

サービス要求先のサーバが統計情報機能をサポートしていない場合は取得しません。

注※3

ee_rpc_call関数が成功した回数です。

注※4

確保回数，解放回数，および編集対象時間内の統計情報インタバル出力回数を合計した回数です。

注※5

確保回数および解放回数を合計した回数です。

注※6

トランザクション数です。

注※7

コミットおよびロールバックの回数です。

注※8

SQLプールの使用量に変動があった回数です。

注※9

SQLプールが不足して，動的に領域を確保した回数です。

注※10

TP1/FSP使用時に取得します。各事象の詳細については，TP1/FSPの関連ドキュメントを参照してください。

注※11

関数の呼び出し回数です。

注※12

ワークメモリの追加確保回数です。

注※13

ワークメモリの追加確保失敗回数です。

注※14

TP1/FSPで提供しているSDBハンドラの関数を呼び出したトランザクション数です。

注※15

スレッドキューの引き出し回数です。

注※16

ファイルのスワップ回数です。

付録B.2　レスポンス統計情報

(1)　レスポンス統計情報の詳細

レスポンス統計情報の詳細を次の表に示します。

表B‒3　レスポンス統計情報の詳細

項目

詳細内容

RPC種別

統計情報を出力したノードから該当するサービスに対して呼び出したRPCの，種別ごとの呼び出し回数

レスポンスタイム

ee_rpc_call関数を呼び出してから応答メッセージを受信するまでの時間。ただし，次に示すとおり，時間はフラグによって異なります。

EENOFLAGS（同期応答型RPC）：ee_rpc_call関数を呼び出してから応答メッセージを受信するまでの時間

EERPC_NOREPLY（非応答型RPC）：取得しません。

サービス実行時間

サービス関数を実行してから応答メッセージを送信するまでの時間

サービス待ち時間

スケジュールキューに要求が入ってから取り出されるまでの時間

なお，レスポンス統計情報では，成功したRPCについてだけ回数を数えています。タイムアウトなどでエラーになったRPCについては回数に含みません。

(2)　レスポンス統計情報の出力結果例

サービスの実行形態によって，レスポンス統計情報の出力結果が異なります。実行形態ごとの統計情報の例を次に示します。

(a)　サービスの要求元とは別ノードにサービスがある場合

サービスの要求元とは別ノードにサービスがある場合の例を次の図に示します。

図B‒1　サービスの要求元とは別ノードにサービスがある場合の例

この図の各ノードで取得された統計情報を編集すると，出力結果は次のようになります。

●SPP Aの統計情報を編集した場合

注※1

0が入ります。

注※2

図B-1のt9−t3の値が入ります。

注※3

図B-1のt3−t2の値が入ります。

注※4

図B-1のt8−t4の値が入ります。

注※5

図B-1のt7−t6の値が入ります。

注※6

図B-1のt6−t5の値が入ります。

出力項目について説明します。

サービスグループAのサービスA

RPC種別ごとの件数

SPP AからサービスグループAのサービスAを1回も呼び出していないことを表しています。

レスポンスタイム

SUPがdc_rpc_callを呼び出して応答を受け取るまでの時間ですが，SPP Bの統計情報を編集しているため，この値は取得しません。そのため0が入ります。

サービス実行時間

サービスグループAのサービスAが処理を開始してから，応答送信をするまでの時間です。ただし，応答送信をした際の通信時間は含まれません。

サービス待ち時間

SUPからの要求が，処理キューに入ってから取り出されるまでの時間です。

サービスグループBのサービスB

RPC種別ごとの件数

SPP BからサービスグループBのサービスBに対して，同期応答型で1回呼び出したことを表しています。

レスポンスタイム

SPP Aがee_rpc_callを呼び出して応答を受け取るまでの時間です。

サービス実行時間

サービスグループBのサービスBが処理を開始してから，応答送信をするまでの時間です。ただし，応答送信をした際の通信時間は含まれません。

サービス待ち時間

SPP Aからの要求が，処理キューに入ってから取り出されるまでの時間です。

●SPP Bの統計情報を編集した場合

注※1

0が入ります。

注※2

図B-1のt7−t6の値が入ります。

注※3

図B-1のt6−t5の値が入ります。

出力項目について説明します。

RPC種別ごとの件数

SPP BからサービスグループBのサービスBを1回も呼び出していないことを表しています。

レスポンスタイム

SPP Aがee_rpc_callを呼び出して応答を受け取るまでの時間ですが，サービスグループBの統計情報を編集しているため，この値は取得できません。そのため0が入ります。

サービス実行時間

サービスグループBのサービスBが処理を開始してから，応答送信をするまでの時間です。ただし，応答送信をした際の通信時間は含まれません。

サービス待ち時間

SPP Aからの要求が，処理キューに入ってから取り出されるまでの時間です。

(b)　自ノード内でサービスを実行する場合

自ノード内でサービスを実行する場合の例を次の図に示します。

図B‒2　自ノード内でサービスを実行する場合の例

この図のノードで取得された統計情報を編集すると，レスポンス統計情報の出力結果は次のようになります。

注※1

0が入ります。

注※2

図B-2のt9−t3の値が入ります。

注※3

図B-2のt3−t2の値が入ります。

注※4

図B-2のt8−t4の値が入ります。

注※5

図B-2のt7−t6の値が入ります。

注※6

図B-2のt6−t5の値が入ります。

出力項目について説明します。

サービスグループAのサービスA

RPC種別ごとの件数

自ノードからサービスグループAのサービスAを呼び出していないことを表します。クライアントが同一ノード内であっても，クライアントの統計情報はSPP Aで取得しません。

レスポンスタイム

SUPがdc_rpc_callを呼び出して応答を受け取るまでの時間です。SUPがdc_rpc_callを呼び出して応答を受け取るまでの時間ですが，SPP Aの統計情報を編集しているため，この値は取得しません。そのため0が入ります。

サービス実行時間

サービスグループAのサービスAが処理を開始してから，応答送信をするまでの時間です。ただし，応答送信をした際の通信時間は含まれません。

サービス待ち時間

SUPからの要求が，処理キューに入ってから取り出されるまでの時間です。

サービスグループBのサービスB

RPC種別ごとの件数

自ノードからサービスグループBのサービスBに対して，同期応答型で1回呼び出したことを表しています。

レスポンスタイム

SPP Aがee_rpc_callを呼び出して応答を受け取るまでの時間です。

サービス実行時間

サービスグループBのサービスBが処理を開始してから，応答送信をするまでの時間です。ただし，応答送信をした際の通信時間は含まれません。

イベント数は，サービスA側とサービスB側で統計情報を取得するため，2となっています。

平均値についても，（サービスAの値+サービスBの値）÷2の値となっています。

サービス待ち時間

SPP Aからの要求が，スケジュールキューに入ってから取り出されるまでの時間です。

イベント数は，サービスA側とサービスB側で統計情報を取得するため，2となっています。

付録C　トランザクションの時間監視

TP1/EEでのトランザクションの時間監視について説明します。トランザクションの監視時間は，次に示すオペランドで指定します。

RPC関連定義

watch_timeオペランド

トランザクション関連定義

trn_expiration_timeオペランド

trn_expiration_time_**オペランド（**は小文字のトランザクション種別）

trn_watch_timeオペランド

ユーザサービス関連定義

service_attr定義コマンド

トランザクションの時間監視について，次の図に示します。

図C‒1　トランザクションの時間監視

図中のtについて次に説明します。図中の「ステータスファイルへの出力」の詳細については，「11.4.7(2)　トランザクション処理とI/O処理の監視範囲，およびステータスファイルの排他範囲」のステータスファイルへの出力開始からステータスファイルへの出力終了までの処理の説明を参照してください。

t1：trn_expiration_time，trn_expiration_time_**※またはservice_attr（トランザクション処理監視時間）

トランザクションブランチの開始から，同期点処理の終了までの経過時間を監視します。ただし，XAインタフェースによるリソースマネジャの処理は監視しません。

監視対象区間は，t1_1，t1_2，t1_3，およびt1_4で示す区間を合計したものです。

タイムアウト時には，KFSB55311-Eメッセージを出力し，TP1/EEプロセスを強制停止するか，または該当するスレッドを強制終了します。

t2：watch_time（最大応答待ち時間）

RPCを実行してから応答が返ってくるまでの時間を監視します。ただし，RPCの実行時にコネクションが確立されていない場合，コネクションを確立するまでの時間はt2に含まれません。コネクションを確立するまでの監視時間は，RPC関連定義のrpc_connect_timerオペランドで指定します。

タイムアウト時には，ee_rpc_call関数がエラーリターンします。

t3：trn_watch_time（トランザクション同期点処理時の最大通信待ち時間）

トランザクションの同期点処理で，トランザクションブランチ間で行う通信（プリペア，コミット，ロールバック，応答など）の受信待ち時間を監視します。

タイムアウト時には，同期点処理時に発生した障害の個所に応じて，トランザクションを決着させます。

t4：trn_expiration_time，trn_expiration_time_**※またはservice_attr（トランザクション処理監視時間）

トランザクションブランチの開始から，同期点処理の終了までの経過時間を監視します。ただし，XAインタフェースによるリソースマネジャの処理は監視しません。

監視対象区間は，t4_1，t4_2，およびt4_3で示す区間を合計したものです。

タイムアウト時には，KFSB55311-Eメッセージを出力し，TP1/EEプロセスを強制停止するか，または該当するスレッドを強制終了します。

t5：trn_watch_time（トランザクション同期点処理時の最大通信待ち時間）

トランザクションの同期点処理で，トランザクションブランチ間で行う通信（プリペア，コミット，ロールバック，応答など）の受信待ち時間を監視します。

タイムアウト時には，同期点処理時に発生した障害の個所に応じて，トランザクションを決着させます。

注※

**には，小文字のトランザクション種別が入ります。

付録D　TP1/EEが出力するファイル一覧

ここでは，TP1/EEシリーズの製品が出力するファイルの一覧を，製品別に示します。

なお，バージョン列に記載しているのは，TP1/EEのバージョンです。

付録D.1　TP1/EE

出力されるTP1/EEファイルの一覧を次の表に示します。各ファイルの詳細な説明については，表D-2を参照してください。

表D‒1　出力されるTP1/EEのファイル一覧

項番

名称

ファイル名または

ディレクトリ名

バージョン

タイプ

ファイル形式

取得

タイミング

削除可否

1

メモリダンプファイル

$DCDIR/spool/dceeinf/dump/XXXdumpNNN

（XXX：サービスグループ名，NNN：001〜の通番）

01-00-A

C，H

バイナリ

スレッドダウン時

△

2

メッセージログファイル

$DCDIR/spool/dceeinf/log/XXXlogNNN

（XXX：サービスグループ名，NNN：001〜の通番）

01-00-A

C，F，H

テキスト

TP1/EE実行時

×

3

統計情報ファイル

$DCDIR/spool/dceeinf/stc/XXXstcNNN

（XXX：サービスグループ名，NNN：001〜の通番）

01-02

C，F，H

バイナリ

次のコマンド実行時

eesvstart

eesvstop

eetrbstcfput

eerasget

eetrbrcvr

dcstop

dcrasget

統計情報バッファ（1面）満杯時

△

4

TASKTMファイル

$DCDIR/spool/dceeinf/tasktm/XXXtasktmNNN

（XXX：サービスグループ名，NNN：001〜の通番）

01-00-A

C，F，H

バイナリ

次のコマンド実行時

eesvstart

eesvstop

eetrbtaskfput

eerasget

eetrbrcvr

dcstop

dcrasget

TASKTMバッファ（1面）満杯時

△

5

回線トレースファイル

$DCDIR/spool/dceeinf/trc/XXXtrcNNN

（XXX：サービスグループ名，NNN：001〜の通番）

01-00-A

C，F，H

バイナリ

次のコマンド実行時

eesvstart

eesvstop

eetrbtrcefput

eerasget

eetrbrcvr

dcstop

dcrasget

回線トレースバッファ（1面）満杯時

△

6

UAPトレースファイル

$DCDIR/spool/dceeinf/uat/XXXuatNNN

（XXX：サービスグループ名，NNN：001〜の通番）

07-50

C，F，H

バイナリ

次のコマンド実行時

eesvstart

eesvstop

eetrbuatfput

eerasget

eetrbrcvr

dcstop

dcrasget

UAPトレースバッファ（1面）満杯時

△

7

TP1/EE終了ステータスファイル

$DCDIR/tmp/.XXX.ste

（XXX：ユーザサーバ名）

01-00-A

J

テキスト

eesvstopコマンド実行時

×

8

TP1/EE開始ステータスファイル

$DCDIR/tmp/.XXX.sts

（XXX：ユーザサーバ名）

01-00-A

J

テキスト

eesvstartコマンド実行時

×

9

障害情報ファイル

$DCDIR/tmp/XXX_abdinfo

（XXX：サービスグループ名）

01-00-A

J

テキスト

eesvstartコマンド実行時

×

10

ポート番号格納ファイル

$DCDIR/tmp/XXX_portnum

（XXX：サービスグループ名）

01-00-A

J

バイナリ

eesvstartコマンド実行時

×

11

異常終了排他ファイル

$DCDIR/tmp/XXX_sigabdlock

（XXX：サービスグループ名）

01-00-A

J

なし

eesvstartコマンド実行時

×

12

連続異常終了時刻引き継ぎファイル

$DCDIR/tmp/XXX_srvholdtm

（XXX：サービスグループ名）

07-60

J

テキスト

次の条件をすべて満たす場合のTP1/EE起動時

サービス連続異常終了監視の有効時

service_hold_watch_procdownオペランドにYを指定

×

13

サービスUAP障害ファイル

$DCDIR/tmp/XXX_uaperr

（XXX：サービスグループ名）

01-00-A

J

なし

eesvstartコマンド実行時

×

14

UNIXドメインソケットファイル

rpc_multi_tp1_in_same_hostオペランドにYを指定する場合：

（Linux版）

/opt/OpenTP1/etc/so_unix/tkYYYYY

rpc_multi_tp1_in_same_hostオペランドにNを指定する場合：

$DCDIR/.tact/tkYYYYY

（YYYYY：ポート番号）

01-00-A

J

なし

eesvstartコマンド実行時

×

15

eerasgetワークファイル

ZZZ/EERAS.TMP

（ZZZ：eerasgetコマンドの引数で指定した取得先ファイル名からファイル名を除いたディレクトリ）

01-01

J

バイナリ

eerasgetコマンド実行時

dcrasgetコマンド実行時

□（eerasget）

（凡例）

C：ラウンドロビン（バックアップ取得機能がないタイプ）

F：ラウンドロビン（一定量に達する直前の出力で，新しいファイルに切り替わるタイプ）

H：ラウンドロビン（切り替わった先のファイルのデータを，削除してから先頭から書き込むタイプ）

J：制御ファイル，一時ファイル

△：削除してはいけません。ただし，障害調査が不要であれば，ユーザ判断で削除できます。

□：コマンド終了時に削除します。（　）内は該当するコマンド名です。

×：削除してはいけません。

出力されるTP1/EEのファイルの説明を次の表に示します。

表D‒2　出力されるTP1/EEのファイルの説明

項番

名称

サイズ

最大ファイル数

説明

1

メモリダンプファイル

「6.3.5(1)　メモリダンプファイルの容量設定」参照

trb_dump_file_noオペランドの指定値

トラブルシュート関連のファイルです。必要に応じてバックアップを取得してください。

2

メッセージログファイル

log_file_sizeオペランドの指定値

log_file_maxオペランドの指定値

トラブルシュート関連のファイルです。必要に応じてバックアップを取得してください。

TP1/EE終了後は，障害調査やJP1で監視が不要なケースであれば，ユーザ判断で削除できます。

3

統計情報ファイル

trb_stc_file_sizeオペランドの指定値

trb_stc_file_noオペランドの指定値

トラブルシュート関連のファイルです。必要に応じてバックアップを取得してください。

4

TASKTMファイル

trb_tasktm_file_sizeオペランドの指定値

trb_tasktm_file_noオペランドの指定値

トラブルシュート関連のファイルです。必要に応じてバックアップを取得してください。

5

回線トレースファイル

trb_trace_file_sizeオペランドの指定値

trb_trace_file_noオペランドの指定値

トラブルシュート関連のファイルです。必要に応じてバックアップを取得してください。

6

UAPトレースファイル

trb_uap_trace_buffer_sizeオペランドの指定値

trb_uap_trace_file_noオペランドの指定値

トラブルシュート関連のファイルです。必要に応じてバックアップを取得してください。

7

TP1/EE終了ステータスファイル

2バイト

1ファイル

システム制御関連のファイルです。バックアップは不要です。

8

TP1/EE開始ステータスファイル

2バイト

1ファイル

システム制御関連のファイルです。バックアップは不要です。

9

障害情報ファイル

20バイト

1ファイル

システム制御関連のファイルです。バックアップは不要です。

10

ポート番号格納ファイル

10バイト

1ファイル

システム制御関連のファイルです。バックアップは不要です。

11

異常終了排他ファイル

0バイト

1ファイル

システム制御関連のファイルです。バックアップは不要です。

12

連続異常終了時刻引き継ぎファイル

8×サービス数

1ファイル

システム制御関連のファイルです。バックアップは不要です。

13

サービスUAP障害ファイル

0バイト

1ファイル

システム制御関連のファイルです。バックアップは不要です。

14

UNIXドメインソケットファイル

0バイト

mysvgdef定義コマンドおよびmyreplydef定義コマンドで指定したポート番号数

システム制御関連のファイルです。バックアップは不要です。

15

eerasgetワークファイル

収集する情報に依存

収集する情報に依存

システム制御関連のファイルです。バックアップは不要です。

付録D.2　XTC

出力されるXTCのファイルの一覧を次の表に示します。各ファイルの詳細な説明については，表D-4を参照してください。

表D‒3　出力されるXTCのファイル一覧

項番

名称

ファイル名または

ディレクトリ名

バージョン

タイプ

ファイル形式

取得

タイミング

削除可否

1

HAモニタ情報ファイル

$DCDIR/spool/dceeinf/.XXX_moninfo

（XXX：サービスグループ名）

07-50

J

バイナリ

eesvstartコマンド実行時

×

2

キューダンプファイル

$DCDIR/spool/dceeinf/quedump/XXX/quedump

（XXX：サービスグループ名）

07-50

A

バイナリ

XTC孤立時

次のコマンド実行時

eesvstop

dcstop

△

3

XDBトレース情報ファイル

$DCDIR/spool/dceeinf/xdb/XXXxdbNNN

（XXX：サービスグループ名，NNN：001〜の通番）

07-50

C，F，H

バイナリ

次のコマンド実行時

eesvstart

eesvstop

eexdbfput

eerasget

eetrbrcvr

dcstop

dcrasget

XDBトレースバッファ（1面）満杯時

△

（凡例）

A：単調増加（削除機能がないタイプ）

C：ラウンドロビン（バックアップ取得機能がないタイプ）

F：ラウンドロビン（一定量に達する直前の出力で，新しいファイルに切り替わるタイプ）

H：ラウンドロビン（切り替わった先のファイルのデータを，削除してから先頭から書き込むタイプ）

J：制御ファイル，一時ファイル

△：削除してはいけません。ただし，障害調査が不要であれば，ユーザ判断で削除できます。

×：削除してはいけません。

出力されるXTCのファイルの説明を次の表に示します。

表D‒4　出力されるXTCのファイルの説明

項番

名称

サイズ

最大ファイル数

説明

1

HAモニタ情報ファイル

32バイト

1ファイル

システム制御関連のファイルです。バックアップは不要です。

2

キューダンプファイル

マニュアル「TP1/EE/Extended Transaction Controller 使用の手引」のキューダンプファイルの容量見積もりの説明を参照してください。

単調増加

トラブルシュート関連のファイルです。必要に応じてバックアップを取得してください。

3

XDBトレース情報ファイル

xdb_trace_file_sizeオペランドの指定値

xdb_trace_file_numberオペランドの指定値

トラブルシュート関連のファイルです。必要に応じてバックアップを取得してください。

付録D.3　MCP

出力されるMCPのファイルの一覧を次の表に示します。各ファイルの詳細な説明については，表D-6を参照してください。

表D‒5　出力されるMCPのファイル一覧

項番

名称

ファイル名または

ディレクトリ名

バージョン

タイプ

ファイル形式

取得

タイミング

削除可否

1

MCPトレースファイル

$DCDIR/spool/dceeinf/mcp/XXXmcpNNN

（XXX：サービスグループ名，NNN：001〜の通番）

07-50

C，F，H

バイナリ

次のコマンド実行時

eesvstart

eesvstop

eemcpfput

eerasget

eetrbrcvr

dcstop

dcrasget

MCPトレースバッファ（1面）満杯時

△

（凡例）

C：ラウンドロビン（バックアップ取得機能がないタイプ）

F：ラウンドロビン（一定量に達する直前の出力で，新しいファイルに切り替わるタイプ）

H：ラウンドロビン（切り替わった先のファイルのデータを，削除してから先頭から書き込むタイプ）

△：削除してはいけません。ただし，障害調査が不要であれば，ユーザ判断で削除できます。

出力されるMCPのファイルの説明を次の表に示します。

表D‒6　出力されるMCPのファイルの説明

項番

名称

サイズ

最大ファイル数

説明

1

MCPトレースファイル

eemcptrc定義コマンドの-fオプションのfileszオペランドの指定値

eemcptrc定義コマンドの-fオプションのfilenoオペランドの指定値

トラブルシュート関連のファイルです。必要に応じてバックアップを取得してください。

付録D.4　TP1/FSP

出力されるTP1/FSPのファイルの一覧を次の表に示します。各ファイルの詳細な説明については，表D-8を参照してください。また，TP1/FSPについては，TP1/FSPの関連ドキュメントを参照してください。

表D‒7　出力されるTP1/FSPのファイル一覧

項番

名称

ファイル名または

ディレクトリ名

バージョン

タイプ

ファイル形式

取得

タイミング

削除可否

1

TP1/Client/Wトレースファイル

環境変数DCTRCPATHに設定したパス（省略時は$DCDIR/spool/dceeinf）※

07-80

C，E，H※

バイナリまたはテキスト※

OBM実行時（eeobmstartコマンド）

△

2

OBM実行結果ファイル

$DCDIR/spool/dceeinf/obm/XXX_OOO_NNN

（XXX：サービスグループ名，OOO：OBM名，NNN：001〜の通番）

07-80

C，H

テキスト

OBM実行時（eeobmstartコマンド）

○

3

ジョブ排他ファイル

$EEBPPDIR/job/JJJ/.jobact_lock

（JJJ：ジョブ名）

07-80

J

なし

eebpprunコマンド実行時

×

4

定義ファイル

$EEBPPDIR/job/JJJ/conf/deffile

（JJJ：ジョブ名）

07-80

L

テキスト

eebpprunコマンド実行時

△

5

定義ファイル

（正常終了時）

$EEBPPDIR/job/JJJ/conf/deffile_save

（JJJ：ジョブ名）

07-80

L

テキスト

eebpprunコマンド正常終了時

△

6

メッセージログファイル

（オフラインバッチ）

$EEBPPDIR/job/JJJ/spool/dceeinf/log/JJJlogNNN

（JJJ：ジョブ名，NNN：001〜010の通番）

07-80

C，F，H

テキスト

eebpprunコマンド実行時

×

7

統計情報ファイル

（オフラインバッチ）

$EEBPPDIR/job/JJJ/spool/dceeinf/stc/JJJstcNNN

（JJJ：ジョブ名，NNN：001〜の通番）

07-80

C，F，H

バイナリ

eebpprunコマンド実行時

統計情報バッファ（1面）満杯時

eebpprunコマンド終了時

△

8

TASKTMファイル

$EEBPPDIR/job/JJJ/spool/dceeinf/tasktm/JJJtasktmNNN

（JJJ：ジョブ名，NNN：001〜の通番）

07-80

C，F，H

バイナリ

eebpprunコマンド実行時

TASKTMバッファ（1面）満杯時

eebpprunコマンド終了時

△

9

回線トレースファイル

$EEBPPDIR/job/JJJ/spool/dceeinf/trc/JJJtrcNNN

（JJJ：ジョブ名，NNN：001〜の通番）

07-80

C，F，H

バイナリ

eebpprunコマンド実行時

回線トレースバッファ（1面）満杯時

eebpprunコマンド終了時

△

10

UAPトレースファイル

$EEBPPDIR/job/JJJ/spool/dceeinf/uat/JJJuatNNN

（JJJ：ジョブ名，NNN：001〜の通番）

07-80

C，F，H

バイナリ

eebpprunコマンド実行時

UAPトレースバッファ（1面）満杯時

eebpprunコマンド終了時

△

11

実行時環境変数退避ファイル

$EEBPPDIR/job/JJJ/spool/JJJ_env

（JJJ：ジョブ名）

07-80

L

テキスト

eebpprunコマンド実行時

△

12

プロセス情報ファイル

$EEBPPDIR/job/JJJ/spool/JJJ_jobinfo

（JJJ：ジョブ名）

07-80

L

テキスト

eebpprunコマンド実行時

△

13

ジョブ実行環境構築ファイル

$EEBPPDIR/job/JJJ/spool/JJJ_setup

（JJJ：ジョブ名）

07-80

J

なし

eebpprunコマンド実行時

×

14

環境稼働中チェックファイル

$EEBPPDIR/lock/.bppact_lock

07-80

J

なし

eebppsetupコマンド実行時

×

15

ユーザメモリダンプファイル

$EEUSERDUMPDIR/userdump_XXXXXXXX

（XXXXXXXX：中央処理通番）

07-80

A

バイナリ

ee_mem_userdump関数【CBLEEMEM('USERDUMP')】で次の場合

API関数発行時（即時出力）

スレッドダウン発生時（出力設定時）

○

16

環境操作排他ファイル

/tmp/.eebpp/.eebppsetup_lock

07-80

J

なし

eebppsetupコマンド実行時

□（eebppsetup）

17

eebpprasgetワークファイル

ZZZ/EEBPPRAS.TMP

（ZZZ：eebpprasgetコマンドの引数にした取得先ファイル名からファイル名を除いたディレクトリ）

07-80

J

バイナリ

eebpprasgetコマンド実行時

□（eebpprasget）

18

メッセージログファイル

（データ連携支援）

（データ連携支援の制御情報ファイルのLOGDIRオペランドの指定値）/XXXlogrksNNN

（XXX：データ連携支援ID，NNN：001〜の通番）

07-80

C，F，H

テキスト

データ連携支援を動作させたとき

×

19

統計情報ファイル

（データ連携支援）

（データ連携支援の制御情報ファイルのSTACDIRオペランドの指定値）/（統計情報ファイル名）

（統計情報ファイル名（テキスト形式）：XXXstacNNN，統計情報ファイル名（CSV形式）：XXXstacNNN.csv，XXX：データ連携支援ID，NNN：001〜の通番）

07-80

C，F

テキスト

データ連携支援の制御情報ファイルのSTACオペランドを指定し，データ連携支援を動作させたとき

○

20

メッセージログファイル

（データ抽出ユティリティ）

環境変数EETRNIOALOGDIRを指定する場合：

（環境変数EETRNIOALOGDIRの指定値）/EETRNIOAlogioaNNN

（NNN：001〜003）

環境変数EETRNIOALOGDIRを指定しない場合：

（データ抽出ユティリティを使用したUAPを実行したカレントパス）/EETRNIOAlogioaNNN

（NNN：001〜003）

07-80

C，F，H

テキスト

データ抽出ユティリティを使用したUAPを動作させたとき

×

（凡例）

A：単調増加（削除機能がないタイプ）

C：ラウンドロビン（バックアップ取得機能がないタイプ）

E：ラウンドロビン（一定量に達した直後の出力で，新しいファイルに切り替わるタイプ）

F：ラウンドロビン（一定量に達する直前の出力で，新しいファイルに切り替わるタイプ）

H：ラウンドロビン（切り替わった先のファイルのデータを，削除してから先頭から書き込むタイプ）

J：制御ファイル，一時ファイル

L：コマンド実行などで1回ごとに出力し，最大容量が決まっているファイル

○：ユーザ判断で削除できます。

△：削除してはいけません。ただし，障害調査が不要であれば，ユーザ判断で削除できます。

□：コマンド終了時に削除します。（　）内は該当するコマンド名です。

×：削除してはいけません。

注※

詳細については，マニュアル「OpenTP1 クライアント使用の手引 TP1/Client/W，TP1/Client/P編」を参照してください。

出力されるTP1/FSPのファイルの説明を次の表に示します。

表D‒8　出力されるTP1/FSPファイルの説明

項番

名称

サイズ

最大ファイル数

説明

1

TP1/Client/Wトレースファイル

マニュアル「OpenTP1 クライアント使用の手引 TP1/Client/W，TP1/Client/P編」参照

マニュアル「OpenTP1 クライアント使用の手引 TP1/Client/W，TP1/Client/P編」参照

オンラインバッチ関連のファイルです。必要に応じてバックアップを取得してください。

2

OBM実行結果ファイル

700+ロット数（OBM名に対応するOBM構成定義ファイルのlotdef定義コマンドの定義数）×100バイト

obmdef定義コマンドの数×obmstart定義コマンドの-fオプションのfile_noオペランドの指定値

オンラインバッチ関連のファイルです。必要に応じてバックアップを取得してください。

3

ジョブ排他ファイル

0バイト

1ファイル

オフラインバッチ関連のファイルです。バックアップは不要です。

4

定義ファイル

使用する定義ファイルに依存

1ファイル

オフラインバッチ関連のファイルです。必要に応じてバックアップを取得してください。

5

定義ファイル

（正常終了時）

使用する定義ファイルに依存

1ファイル

オフラインバッチ関連のファイルです。必要に応じてバックアップを取得してください。

6

メッセージログファイル

（オフラインバッチ）

log_file_sizeオペランドの指定値

10ファイル

オフラインバッチ関連のファイルです。必要に応じてバックアップを取得してください。

eebpprunコマンド終了後は，障害調査やJP1で監視が不要なケースであれば，ユーザ判断で削除できます。

7

統計情報ファイル

（オフラインバッチ）

trb_stc_file_sizeオペランドの指定値

trb_stc_file_noオペランドの指定値

オフラインバッチ関連のファイルです。必要に応じてバックアップを取得してください。

8

TASKTMファイル

trb_tasktm_file_sizeオペランドの指定値

trb_tasktm_file_noオペランドの指定値

オフラインバッチ関連のファイルです。必要に応じてバックアップを取得してください。

9

回線トレースファイル

trb_trace_file_sizeオペランドの指定値

trb_trace_file_noオペランドの指定値

オフラインバッチ関連のファイルです。必要に応じてバックアップを取得してください。

10

UAPトレースファイル

trb_uap_trace_buffer_sizeオペランドの指定値

trb_uap_trace_file_noオペランドの指定値

オフラインバッチ関連のファイルです。必要に応じてバックアップを取得してください。

11

実行時環境変数退避ファイル

環境変数設定内容に依存

1ファイル

オフラインバッチ関連のファイルです。必要に応じてバックアップを取得してください。

12

プロセス情報ファイル

収集する情報に依存

1ファイル

オフラインバッチ関連のファイルです。必要に応じてバックアップを取得してください。

13

ジョブ実行環境構築ファイル

0バイト

1ファイル

オフラインバッチ関連のファイルです。バックアップは不要です。

14

環境稼働中チェックファイル

0バイト

1ファイル

オフラインバッチ関連のファイルです。バックアップは不要です。

15

ユーザメモリダンプファイル

API関数の引数の指定値

API関数発行トランザクション数

ユーザメモリダンプ関連のファイルです。必要に応じてバックアップを取得してください。

16

環境操作排他ファイル

0バイト

1ファイル

オフラインバッチ関連のファイルです。バックアップは不要です。

17

eebpprasgetワークファイル

収集する情報に依存

収集する情報に依存

オフラインバッチ関連のファイルです。バックアップは不要です。

18

メッセージログファイル

（データ連携支援）

データ連携支援の制御情報ファイルのLOGSIZEオペランドの指定値

データ連携支援の制御情報ファイルのLOGMAXオペランドの指定値

データ連携支援関連のファイルです。必要に応じてバックアップを取得してください。

データ連携支援終了後は，障害調査やJP1で監視が不要なケースであれば，ユーザ判断で削除できます。

19

統計情報ファイル

（データ連携支援）

データ連携支援の制御情報ファイルのSTACSIZEオペランドの指定値

データ連携支援の制御情報ファイルのSTACNOオペランドの指定値

データ連携支援関連のファイルです。必要に応じてバックアップを取得してください。

STACTYPEオペランドにCSVを指定した場合はCSV形式だけを出力し，それ以外の場合はテキスト形式だけを出力します。

20

メッセージログファイル

（データ抽出ユティリティ）

1024キロバイト

3ファイル

データ抽出ユティリティ関連のファイルです。必要に応じてバックアップを取得してください。

データ抽出ユティリティ終了後は，障害調査やJP1で監視が不要なケースであれば，ユーザ判断で削除できます。

付録E　各バージョンの変更内容

各バージョンの変更内容を示します。

付録E.1　変更内容（3000-3-F51-70）

次の製品の変更内容（3000-3-F51-70）を表に示します。

uCosminexus TP1/Server Base Enterprise Option(64) 07-91

追加・変更内容

交替用メッセージ表書き込み機能を追加した。

統計情報ファイルの削除の説明を変更した。

HiRDB連携時のTP1/Server Baseのユーザサービス定義の説明を変更した。

PDSWATCHTIMEの指定値を変更した。

次のオペランドに説明を追加した。

trb_tasktm_buffer_size

trb_tasktm_buffer_no

trb_line_trace_buffer_size

trb_line_trace_buffer_no

trb_line_xatrace_buffer_no

trb_uap_trace_buffer_size

trb_uap_trace_buffer_no

trb_stc_buffer_size

trb_stc_buffer_no

trb_line_cmtrace_buffer_size

trb_line_cmtrace_buffer_no

次のコマンドを追加した。

eedbqaltlsh

eedbqaltput

次のコマンドを変更した。

eedbqls

eedbqtblh

eetrbtaskdump

eetrbtasked

付録E.2　変更内容（3000-3-F51-60）

次の製品の変更内容（3000-3-F51-60）を表に示します。

uCosminexus TP1/Server Base Enterprise Option(64) 07-89

追加・変更内容

適用OSにAIX V7.2を追加した。

DBキュー書き込み禁止機能を追加した。

rap_client_hostname定義を追加した。

dbq_inhibit_use定義を追加した。

eedbqinhibitコマンドを追加した。

eedbqchgrコマンドの注意事項を追加した。

eedbqlsコマンドの出力項目を追加した。

eedbqlsdqコマンドの出力項目を追加した。

eedbqlsqgコマンドの出力項目を追加した。

付録E.3　変更内容（3000-3-F51-50）

次の製品の変更内容（3000-3-F51-50）を表に示します。

uCosminexus TP1/Server Base Enterprise Option(64) 07-87

追加・変更内容

eechgapコマンドの入れ替え対象および対象外のライブラリの説明を追加した。

trn_thd_down_countオペランドおよびtrn_thd_down_intervalオペランドに関する定義の説明を削除した。また，これらのオペランドと関連する，スレッドダウン監視の説明を削除した。

dbqgrpdefオペランドの-oオプションの説明を追加した。

トランザクション情報のFSP_状態に関する注意事項を追加した。

UAP履歴情報の状態の説明を変更した。

uCosminexus TP1/Server Base Enterprise Option(64) 07-86

追加・変更内容

HiRDB連携時の運用でのTP1/EEのスレッド数の説明に，trn_aph_useオペランドにYを指定した場合の説明を追加した。

付録E.4　変更内容（3000-3-F51-40）

次の製品の変更内容（3000-3-F51-40）を表に示します。

uCosminexus TP1/Server Base Enterprise Option(64)　07-85

追加・変更内容

トランザクション処理結果によるRPC応答メッセージ送信で，ERRTRNRによる応答メッセージ送信のサービス関数に引き継ぐ情報に関しての注意事項を追加した。

ERRTRN3でRPC応答メッセージ送信をできるようにした。

サービスグループを閉塞できるようにした。

ネームのキャッシュ情報を即時更新できるようにした。

処理キューの統計情報を表示できるようにした。

HiRDB連携時の運用に次の内容を変更した。

環境設定にPDTXACANUMを追加した。

コネクションに関する注意点を変更した。

システム定義の次の内容を変更した。

cobol_langの設定方法の説明を変更した。

rpc_reply_errtrn3を追加した。

次の定義パラメタの説明にTP1/FSPを使用する場合の説明を追加した。

rpc_reply_con_max_cnt，rpc_reply_con_cnt，rpc_reply_proc_max_cnt，rpc_nowait_cnt，mysvgdef

TASKTM情報の編集出力内容のFSP_状態に出力される内容を変更した。

TASKTM情報の編集出力内容に※11を追加した。

eetrbtaskedコマンドで-sオプションを指定した場合の出力内容に，OBMの項目を追加した。

各バージョンの変更内容を追加した。

付録E.5　変更内容（3000-3-F51-30）

次の製品の変更内容（3000-3-F51-30）を表に示します。

uCosminexus TP1/Server Base Enterprise Option　07-84

uCosminexus TP1/Server Base Enterprise Option(64)　07-84

追加・変更内容

メッセージログを標準出力に出力できるようにした。これに伴い，次のオペランドを追加した。

メッセージログ関連定義

log_usermsg_console

回線トレース情報をCSVファイル形式で出力する際，ファイルを分割できるようにした。

これに伴い，次のコマンドを変更した。

eetrblinedump

eetrblineed

eetrbtaskdump

eetrbtasked

各バージョンの変更内容を追加した。

uCosminexus TP1/Server Base Enterprise Option　07-83

uCosminexus TP1/Server Base Enterprise Option(64)　07-83

追加・変更内容

回線トレースファイルのサイズおよびファイル数の見積もりに必要な情報に次の値を追加した。

u（ee_trb_utrace_put関数×（ee_trb_utrace_put関数で取得するトレースデータのデータ長＋28）バイト）

トラブルシュート関連定義のtrb_dump_area_kindオペランドの指定値が9，13の場合の，メモリダンプファイルサイズを変更した。

これに伴い，次のオペランドを変更した。

トラブルシュート関連定義

trb_dump_area_kind

TP1/EEのトランザクション関連定義のtrnstring定義コマンドの-rオプションの説明に，Oracle RAC機能をOracle 10g R2以降で使用する場合の注意事項を追加した。

複数のユーザサーバで構成されるグローバルトランザクションの性能を向上させるための最適化項目を指定する場合の条件を変更した。

uCosminexus TP1/Server Base Enterprise Option　07-82

uCosminexus TP1/Server Base Enterprise Option(64)　07-82

追加・変更内容

CosminexusのTP1インバウンド連携機能を使用できるようにした。

これに伴い，次のオペランドを追加した。

RPC関連定義

rpc_connect_conflict_timer

また，次のコマンドを変更した。

サービスグループ情報関連定義

eesvgdef

max_open_fds設定値を設定する場合の注意を変更した。

OSがLinuxの場合に，障害検知時のバックトレースメッセージ出力有無を指定できるようにした。

これに伴い，次のオペランドを追加した。

プロセス関連定義

thd_backtrace_msg

OSがLinuxの場合に，CPU時間情報メッセージ出力有無を指定できるようにした。

これに伴い，次のオペランドを追加した。

プロセス関連定義

thd_cpuinfo_msg

mysvgdefコマンドで指定する最大ソケット数の値を変更した。

RPC応答メッセージ受信用に，OSが自動的に割り当てるポート番号を使用すると，通信障害（電文の吸い込み）の発生頻度を軽減できる場合があることを追記した。

uCosminexus TP1/Server Base Enterprise Option　07-81

uCosminexus TP1/Server Base Enterprise Option(64)　07-81

追加・変更内容

システム構築時に使用するコネクション数を制限できる一時クローズ機能を追加した。

これに伴い，次のオペランドを追加した。

RPC関連定義

rpc_recivingconnect_stopmsg_dbq

rpc_conn_recv_check_use

rpc_conn_recv_check_interval

rpc_reply_sockctl_use

rpc_reply_sockctl_highwater

rpc_recv_sockctl_use

rpc_recv_sockctl_highwater

次のコマンドを追加した。

eerpcstat

次のコマンドを変更した。

eerpclscn

eerpcsockcls

eesvstart

TP1/FSPのデータ連携支援がDBキューに書き込んだメッセージを読み出せるようにした。

これに伴い，次のオペランドを変更した。

RPC関連定義

rpc_tcpsend_con_max_cnt

rpc_tcpsend_con_cnt

rpc_tcpsend_proc_max_cnt

また，次のコマンドを変更した。

eedbqtblh

OSがLinuxの場合に，TP1/EEがオープンできるファイルディスクリプタの上限値を拡張できるようにした。

これに伴い，次のオペランドを変更した。

プロセス関連定義

max_descriptors

fil_filesystem_no

RPC関連定義

socket_no

rpc_reply_con_max_cnt

rpc_reply_con_cnt

rpc_reply_proc_max_cnt

rap_max_client

rpc_tcpsend_con_max_cnt

rpc_tcpsend_con_cnt

rpc_tcpsend_proc_max_cnt

また，次のオペランドを追加した。

プロセス関連定義

descriptors_expanse_use

運用コマンド実行時の情報（開始と任意情報と終了）をコマンドログファイルに出力する，コマンドログ取得機能を追加した。

統計情報としてUAP履歴情報メモリ通番統計情報およびOBM統計情報を使用できるようにした。

これに伴い，見積もりに必要な情報を変更した。

また，次のコマンドを変更した。

eetrbstced

eetrbstcese

eetrbstcse

また，次のオペランドを追加した。

トラブルシュート関連定義

trb_stc_obm_interval_time

系切り替え機能使用時の運用について注意事項を追加した。

ワークセグメント解放漏れメッセージの出力を抑止するセグメント属性を指定できるようにした。

これに伴い，次のオペランドを追加した。

メモリ関連定義

memory_leak_message_ignore_attr

ユーザサービス定義のmoduleオペランド，module_dirオペランド，static_module_dirオペランドで定義したUAP共用ライブラリにあるシンボルを，ほかのUAP共用ライブラリで利用可能にするかどうかを指定できるようにした。

これに伴い，次のオペランドを追加した。

ユーザサービス関連定義

module_open_flag

サービス閉塞時に処理キューを引き出し禁止にするかどうかを指定できるようにした。

これに伴い，次のコマンドを変更した。

ユーザサービス関連定義

service_attr

システムワーク領域またはユーザワーク領域で指定できる領域サイズが不足した場合は，供用領域を使用できるようにした。

これに伴い，次のオペランドを変更した。

メモリ関連定義

system_work_size

user_work_size

max_mem_size

TP1/FSP（全銀RC）で自動生成するサービスは対象にならないことを明記した。

ソケット種別がCLT_RPの場合の注意事項を追加した。

切断対象のコネクションがコマンド受け付け時点で送信中の場合に，送信処理を中断してコネクションを切断できるようにした。

これに伴い，次のコマンドを変更した。

eerpcsockcls

付録E.6　変更内容（3000-3-F51-20）

次の製品の変更内容（3000-3-F51-20）を表に示します。

uCosminexus TP1/Server Base Enterprise Option　07-80

uCosminexus TP1/Server Base Enterprise Option(64)　07-80

追加・変更内容

TP1/EEのオプション製品として，TP1/FSPをサポートした。

これに伴い，次のオペランドを追加した。

プロセス関連定義

fsp_use

次のオペランドの説明を変更した。

メモリ関連定義

send_message_buf_cnt

ユーザサービス関連定義

service

次のオペランドの指定値を追加した。

トラブルシュート関連定義

trb_tasktm_type

trb_stc_sys_kind

次のコマンドを変更した。

eedefchk

eelspce

eememls

eetrblinedump

eetrblineed

eetrbstced

eetrbstcse

eetrbtaskdump

eetrbtasked

eetrbuapdump

eetrbuated

eetrntim

次のトランザクション種別を追加した。

CU，JI，UT

次のシステム統計情報を追加した。

UAP履歴情報

SDBハンドラ情報

OBM情報

通信先を指定したサービスの要求をできるようにした。

ネームサービスで管理するサーバUAPの取得数を拡張できるようにした。

これに伴い，次のオペランドを追加した。

RPC関連定義

rpc_name_service_extend

また，次のオペランド，および定義コマンドのオプションの説明を変更した。

メモリ関連定義

recv_message_buf_size

recv_message_buf_cnt

サービスグループ情報関連定義

myreplydef定義コマンドの-f

dc_rpc_call_to関数を使用してサービス要求をする場合に，DCRPC_DIRECT_SCHEDULE関数で設定する引数に，nidを追加した。

サービス要求を送信する場合に，サービス要求先のトランザクションインタフェース情報に，サービス要求元のTP1/Server Baseのノード識別子またはTP1/EEのノード識別子を設定できるようにした。

これに伴い，次のオペランドを追加した。

RPC関連定義

rpc_extend_sb_node_id

DBキューに書き込んだメッセージを読み出すトランザクションを，AP間通信をすることなくユーザが独自にスケジュールする，ユーザキューアクセスをできるようにした。

これに伴い，次の定義コマンドのオプションを追加した。

DBキュー機能関連定義

dbqgrpdef定義コマンドの-u

また，使用する機能別に指定できるオプションの違いについて，DBキュー機能関連定義のdbqgrpdef定義コマンドに説明を追加した。dbqgrpdef定義コマンドの次のオプションに説明を追加した。

-p

-k

-e

-f

-o

-c

さらに，次の定義コマンド，および定義コマンドのオプションに説明を追加した。

DBキュー機能関連定義

dbqsvgdef定義コマンドの-d

dbqprcdef定義コマンド

別プロセスによるトランザクション回復機能を削除した。

これに伴い，関連する定義，コマンド，トランザクション種別を削除した。

また，関連する定義，コマンドの説明を変更した。

DBキューにメッセージを書き込むときの順番を通番管理できるようにした。

これに伴い，次のコマンド，およびコマンドのオプションを追加した。

eedbqclr

eedbqclrh

eedbqtblh -a

AP間通信をするDBキューのスケジュール状態を読み出し停止にする条件を指定できるようにした。

これに伴い，次のオペランド，および定義コマンドのオプションを追加した。

DBキュー機能関連定義

dbq_uap_stop

dbq_read_error_uap_stop

dbqdef定義コマンドの-t

DBキューから不正なメッセージを読み出したり，メッセージの読み出し時に障害が発生したりしたときに，メッセージをスキップすることで読み出しを停止することなく次のメッセージを読み出せるようにした。

これに伴い，次の定義コマンドのオプションを追加した。

DBキュー機能関連定義

dbqgrpdef定義コマンドの-s

また，次のオペランドの説明を変更した。

DBキュー機能関連定義

dbq_rollback_retry_count

メッセージ読み出しトランザクションが，障害や関数の発行によってロールバックした場合に有効になる機能の，ロールバック要因との関係について説明を追加した。

自システムのTP1/EEが読み出すすべてのDBキューのスケジュール状態を，1回のコマンドの実行で読み出し停止にしたり，再開したりできるようにした。

これに伴い，次のコマンドで-uオプション，および注意事項を追加した。また，コマンドの説明，および-qオプションの説明を変更した。

eedbqrst

eedbqstop

TP1/EE起動時以外のスレッド生成で，処理スレッドの再生成に失敗した場合は，実行している処理スレッドの数に関係なく，プロセスダウンするようにした。

処理スレッド単位に，COBOL用メモリ領域のメモリプールを作成できるようにした。

これに伴い，COBOL用メモリ管理機能の説明を追加した。

次のオペランドの説明を変更した。

メモリ関連定義

memory_cobol_area_size

次のオペランドを追加した。

メモリ関連定義

memory_cobol_area_thd_size

また，TP1/EEを使用する場合のTP1/Server Baseのユーザサービス定義として，putenv形式の環境変数EEPARM1を追加した。

TASKTMファイルと回線トレースファイルの見積もりに必要な情報を変更した。これに伴い，見積もり例も変更した。

TP1/Server Baseのネームサーバと連携し，コネクションの確立先のマシンが再起動していないかを確認して，TP1/EEが保持するTCP/IPのコネクションの中から相手マシンのダウンなどで切断されたコネクションを無効にできるようにした。

これに伴い，次のオペランドを追加した。

RPC関連定義

rpc_nam_conn_check

rpc_nam_check_time

rpc_nam_check_num

DBキュー機能を使用したAP間通信と，ユーザキューアクセスが混在する場合の連鎖モードのコミットでの同期点処理について説明を追加した。

dbqgrpdef定義コマンドの-kオプションに1を指定している複数のTP1/EEが，同じDBキューにアクセスする場合の注意事項を追加した。

HiRDBと連携する場合の，TP1/EEのtrnstring定義コマンドの-iオプションについての注意事項，およびtrnstring定義コマンドを複数指定する場合の注意事項を追加した。

タイマ処理スレッドを追加した。

HiRDBとの同時接続数の計算式に，HiRDB用リソースマネジャ数を追加した。

UAP実行前に，COBOL実行空間を毎回再生成するかどうかを指定できるようにした。

これに伴い，次のオペランドを追加した。

プロセス関連定義

cobol_uap_cblend

TP1/EEごとに異なる指定値にするTP1/EEサービス定義に，RPC関連定義のrap_client_manager_portオペランドを追加した。

定義を記述できる文字に関する注意事項を追加した。

TCP/IPが提供するソケットオプション「SO_KEEPALIVE」を使用するかどうかを指定できるようにした。

これに伴い，次のオペランドを追加した。

RPC関連定義

rpc_keepalive_use

rpc_keepalive_time

rpc_keepalive_interval

rpc_keepalive_count

サーバ側で，クライアントUAPの応答待ち時間を意識して処理できるようにした。

これに伴い，次のオペランドを追加した。

RPC関連定義

rpc_request_cancel_for_timedout

rpc_request_cancel_for_server

また，次のオペランドの指定値を追加した。

RPC関連定義

rpc_extend_function

TASKTMファイルの取得情報のタイプを追加した。

これに伴い，次のオペランドの指定値を追加した。

トラブルシュート関連定義

trb_tasktm_type

トランザクション関連定義のtrn_unknown_rm_tran_downオペランドを削除した。

これに伴い，TP1/EE開始時のリソースマネジャ監視，およびステータスファイルの障害の説明を変更した。

TP1/EE正常終了時にDBキューに未読み出しメッセージが存在する場合，未読み出しメッセージがなくなるまでDBキューをチェックするかどうかを指定できるようにした。

これに伴い，次のオペランドを追加した。

DBキュー機能関連定義

dbq_endcheck_mode

RPC関連定義のrpc_connect_errmsgオペランドで抑止できるメッセージに，KFSB40367-Eメッセージを追加した。

次のオペランドの説明に，回線トレース情報の詳細を追加した。

トラブルシュート関連定義

trb_line_trace_buffer_size

trb_line_trace_buffer_no

trb_line_xatrace_buffer_no

trb_line_cmtrace_buffer_size

trb_line_cmtrace_buffer_no

trb_line_cmtrace_buf_entry_size

トランザクション関連定義のtrn_endprepare_msg_intervalオペランドで出力間隔を指定できる対象メッセージについて，説明を追加した。

eedbqlsdqコマンドで，未読み出しメッセージの有無をリスト表示できるようにした。

これに伴い，-uオプション，および-mオプションを追加した。

RPC通信で使用するコネクションを切断できるようにした。

これに伴い，eerpcsockclsコマンドを追加した。

eedbqlsコマンドで表示する情報を変更した。

コネクション確立先の情報を表示できるようにした。

これに伴い，eerpclscnコマンドの-oオプションを追加した。

シグナル用ステータスファイルのレコード数の計算式を追加した。

eetrntimコマンドの注意事項を追加した。

ユーザサービス関連定義のservice_attr定義コマンドで指定したトランザクション処理の監視時間を関数で変更できることについて，説明を追加した。

TP1EEファイルシステムへのI/O処理回数の目安に，別トランザクションによるRPC同期応答機能を使用したトランザクションの情報を追加した。

また，ステータスファイル関連定義のsts_buffer_countオペランドで確保したバッファ内に前回の書き込み要求の情報が残っている場合について，説明を追加した。

ステータスファイルの障害時の対処について，次の情報を追加した。

サービスまたはトランザクションレベルの最大同時処理限界数

UAP共用ライブラリ格納ディレクトリ情報

ユーザタイマの永続化機能のタイマ監視表情報

TP1/EEが出力するファイル一覧を追加した。

各バージョンの変更内容を追加した。

付録E.7　変更内容（3000-3-F51-10）

次の製品の変更内容（3000-3-F51-10）を表に示します。

uCosminexus TP1/Server Base Enterprise Option　07-70

uCosminexus TP1/Server Base Enterprise Option(64)　07-70

追加・変更内容

排他制御モードに，PRモードを追加した。

これに伴い，次のコマンドの説明を変更した。

eelckls

受信IDを出力することで，回線トレースファイルとTASKTMファイルを関連づけられるようにした。

これに伴い，次のコマンドにオプションを追加した。

eetrblinedumpコマンドの-kオプション

eetrblineedコマンドの-kオプション

また，次のコマンドの出力形式を変更した。

eetrblinedump

eetrblineed

eetrbtaskdump

eetrbtasked

TP1EEファイルシステムの再作成について，説明を追加した。

TASKTMファイルのサイズおよびファイル数を見積もるために必要になる情報に，MCPを使用する場合の説明を追加した。

回線トレース情報の取得量を変更できるようにした。

これに伴い，次のオペランドを追加した。

RPC関連定義

rpc_tcp_linetrace

rpc_rap_linetrace

プロセス管理テーブルユーザエリア，およびスレッド対応インタフェースユーザエリアのサイズを拡張した。

これに伴い，次のオペランドを追加した。

メモリ関連定義

system_user_area_mb

thread_user_area_mb

また，次のオペランドの説明を変更した。

メモリ関連定義

system_user_area

thread_user_area

メッセージの送受信で使用する，バッファサイズの上限値を66000に変更した。

これに伴い，次のオペランドの説明を変更した。

メモリ関連定義

recv_message_buf_size

send_message_buf_size

再開始時に変更してもプロセスダウンしないTP1/EEサービス定義の説明に，次のオペランドを追加した。

xtc_use

mcp_use

次のオペランドの説明を修正した。

RPC関連定義

service_group_no

hostname_no

次の定義コマンドを省略した場合，および次の定義コマンドの-cオプションを省略した場合の対象サービスの閉塞について，説明を変更した。

ユーザサービス関連定義

service_attr定義コマンド

次のオペランドの説明に，指定値の関係に関する説明を追記した。

トラブルシュート関連定義

trb_tasktm_file_size

trb_tasktm_buffer_size

trb_trace_file_size

trb_line_trace_buffer_size

trb_uap_trace_file_size

trb_uap_trace_buffer_size

trb_stc_file_size

trb_stc_buffer_size

trb_stc_sys_kind

trb_line_cmtrace_buffer_size

次のオペランドの説明に，統計情報バッファのサイズの見積もり式を追加した。

トラブルシュート関連定義

trb_stc_buffer_size

システム統計情報として，トラブルシュート情報を取得できるようにした。

これに伴い，次のオペランドの説明を変更した。

トラブルシュート関連定義

trb_stc_sys_kind

次のコマンドの説明を変更した。

eetrblinedump

eetrblineed

eetrbstcse

また，次のコマンドの出力形式を変更した。

eetrblinedump

eetrblineed

排他待ち時間は，トランザクション処理監視時間より小さい値を指定する旨を追加した。

次のコマンドに，保守資料の取得後に取得先のファイルを圧縮するための-cオプションを追加した。

eerasget

次のコマンドの，オプションの組み合わせ表を修正した。

eetrblinedump

eetrblineed

eetrbstced

eetrbtasked

eetrbuated

付録E.8　変更内容（3000-3-F51）

uCosminexus TP1/Server Base Enterprise Option　07-60の製品の変更内容（3000-3-F51）を表に示します。

追加・変更内容

TP1キャッシュ機能およびMCPを使用した場合のノード間負荷バランス機能の監視対象を記載した。

TP1キャッシュ機能を使用した場合に，ノード間負荷バランス機能で負荷レベルを決定する方法を記載した。また，処理キュー滞留率の計算方法を変更した。

OSがLinuxの場合に，TP1EEファイルシステム領域として，ブロック型スペシャルファイルを使用できるようにした。

これに伴い，次のコマンドの説明を変更した。

eefilbkup

eefilchgrp

eefilchmod

eefilchown

eefills

eefilmkfs

eefilrstr

eefilstatfs

UAPがサービストランザクションまたはタイマトランザクションを実行中に異常が発生し，スレッドダウンまたはプロセスダウンした場合に，サービス異常終了回数を監視してサービスを閉塞するかどうかを指定できるようにした。

これに伴い，次のオペランドを追加した。

プロセス関連定義

service_hold_watch_use

service_hold_watch_procdown

service_term_watch_time

XTCを使用する際，大量な処理を一時的に扱うためのメモリ領域として，次の領域を使用できるようにした。

大量処理用システム領域（MPSPOOL）

大量処理用ユーザ領域（MPUPOOL）

これに伴い，次のオペランドの説明を変更した。

トラブルシュート関連定義

trb_dump_area_kind

また，次のコマンドの出力形式を変更した。

eememls

eetrbtasked

TP1/EEが出力するTASKTM情報を追加した。

これに伴い，eetrbtaskedコマンドの出力形式を変更した。

処理キューを引き出し禁止に設定している場合，処理キューの滞留監視中にサービスが閉塞したとき，オンライン打ち切り監視判定区間を終了して，通常監視区間になるようにした。

XAインタフェースによるリソースマネジャの処理は，トランザクションの時間監視の対象外にした。

uCosminexus TP1/Server Base Enterprise Option　07-50の製品の変更内容（3000-3-F51）を表に示します。

追加・変更内容

TP1/EEのオプション製品として，次の製品をサポートした。

XDB

XTC

MCP

これに伴い，次のとおり追加・変更した。

次のオペランドおよび定義コマンドを追加した。

プロセス関連定義

xtc_use

xdb_use

mcp_use

ユーザサービス関連定義

forbid_draw_service

service_attr

トランザクション関連定義

trn_expiration_time_rl

次のオペランドを変更した。

メモリ関連定義

pce_no

recv_message_buf_cnt

send_message_buf_cnt

RPC関連定義

levelup_queue_count

leveldown_queue_count

トラブルシュート関連定義

trb_dump_area_kind

trb_tasktm_type

trb_stc_sys_kind

次のコマンドのオプションを変更した。

eetrblinedumpコマンドの-sオプション

eetrblineedコマンドの-sオプション

eetrbrcvrコマンドの-sオプション

eetrbstcseコマンドの-kオプション

eetrbtbldumpコマンドの-tオプション

eetrntimコマンドの-sオプション

次のコマンドの出力形式を変更した。

eelspce

eememls

eetrblinedump

eetrblineed

eetrbstced

eetrbtasked

eetrbtaskdump

eetrbuapdump

eetrbuated

eetrntim

eerpclscn

次のコマンドの出力メッセージを変更した。

eetrblineed

eetrbstced

eetrbtasked

eetrbuated

UAPで使用する資源の排他制御をできるようにした。

これに伴い，次のオペランドを追加した。

トランザクション関連定義

lck_timeout_info

lck_limit_foruser

lck_wait_timeout

また，eelcklsコマンドを追加した。

TP1/EEがクライアントUAP（SPP）の場合に，非同期応答型RPCを使用できるようにした。

これに伴い，次のオペランドを追加した。

RPC関連定義

rpc_extend_function

rpc_nowait_cnt

トラブルシュートで使用するバッファのサイズと数を定義できるようにした。

これに伴い，次のオペランドを追加した。

トラブルシュート関連定義

trb_tasktm_buffer_size

trb_tasktm_buffer_no

trb_uap_trace_buffer_size

trb_uap_trace_buffer_no

trb_line_trace_buffer_size

trb_line_trace_buffer_no

trb_line_xatrace_buffer_no

trb_stc_buffer_size

trb_stc_buffer_no

OSがLinuxの場合にも，syslogに出力できないメッセージをsyslog失敗リストに保管できるようにした。

また，拡張SYSLOG機能を利用して，UAPおよびTP1/EEがsyslogに出力するメッセージの文字コードをUTF-8に変換できるようにした。

これに伴い，次のオペランドを追加した。

メッセージログ関連定義

log_hsyslog_cmode

また，次のオペランドの説明を変更した。

メッセージログ関連定義

log_syslog_elist

トラブルシュートおよび統計情報機能で使用するスレッドのハングアップ監視時間を，プロセス関連定義のthd_hungup_timeオペランドとは別に指定できるようにした。

これに伴い，次のオペランドを追加した。

プロセス関連定義

thd_trb_hungup_time

また，次のオペランドの説明を変更した。

プロセス関連定義

thd_hungup_time

OSがLinuxの場合に，スレッド間での排他競合による性能低下を軽減できるようにした。

これに伴い，次のオペランドを追加した。

プロセス関連定義

thd_mutex_attr_adaptive

トランザクション処理でTP1/EEプロセスが使用するメモリに，2GB以上の値を指定できるようにした。

これに伴い，次のオペランドを追加した。

メモリ関連定義

max_mem_size_mb

また，次のオペランドの説明を変更した。

メモリ関連定義

max_mem_size

また，次のコマンドの出力形式を変更した。

eememls

eetrbreport

eetrbstced

syslog出力およびメッセージの標準出力時に，TP1/EE識別子を付けられるようにした。

また，syslog出力時に，OpenTP1識別子を付けられるようにした。

これに伴い，次のオペランドを追加した。

メッセージログ関連定義

log_base_infid

log_syslog_id

TASKTM情報，回線トレース情報，UAPトレース情報，および統計情報を出力する最大ファイル数の指定可能範囲を拡張した（10→100）。

これに伴い，次のオペランドの説明を変更した。

トラブルシュート関連定義

trb_tasktm_file_no

trb_trace_file_no

trb_uap_trace_file_no

trb_stc_file_no

次の拡張機能を使用できるようにした。

回線トレースの一括出力

トラブルシュートのバッファコピー抑止

統計情報のバッファコピー抑止

これに伴い，次のオペランドを追加した。

トラブルシュート関連定義

trb_extend_function

trb_line_cmtrace_buffer_size

trb_line_cmtrace_buffer_no

trb_line_cmtrace_buf_entry_size

TP1/EEで対応する処理を決定できない障害が発生した場合に，ユーザに応答を促すメッセージが出力されるようにした。

これに伴い，eetrbwtorコマンドを追加した。

付録E.9　変更内容（3000-3-982-40）

uCosminexus TP1/Server Base Enterprise Option　07-01の製品の変更内容（3000-3-982-40）を表に示します。

追加・変更内容

Oracleをリソースマネジャとして使用できるようにした。また，Oracleをリソースマネジャとして使用する場合にSQLトレースを取得できるようにした。

これに伴い，次のとおりに定義を変更した。

プロセス関連定義

other_lib_stack_sizeオペランドを追加した。

トランザクション関連定義

trnstring定義コマンドに，-rオプションおよび-xオプションを追加した。

また，次のとおりにコマンドを変更した。

eedbqtbloコマンドを追加した。

eetrblinedumpコマンドおよびeetrblineedコマンドに，-qオプションおよび-lオプションを追加した。

リソースマネジャとのコネクションを解放することで，Oracleの暗黙カーソルをクローズできるようにした。

メッセージログの言語種別に英語を追加した。

これに伴い，コマンドに英語の出力形式を追加した。

TP1/EEがクライアントUAPの場合のRPC通信で，UNIXドメインを使用できるようにした。

これに伴い，RPC関連定義のrpc_connect_unixdomainオペランドを追加した。

トランザクションごとにxa_open関数およびxa_close関数を発行できるようにした。

これに伴い，トランザクション関連定義にtrn_rm_open_close_scopeオペランドを追加した。

ホスト名に指定できる文字の種類および文字数を拡張した。

オペランドの指定範囲をTP1/Server Baseと統一した。

eesvstartコマンドおよびeesvstopコマンドに，複数のユーザサーバを指定できるようにした。

32ビットアーキテクチャ対応OSを使用する環境で必要となるオブジェクトファイルを作成できるようにした。

これに伴い，eetrnmkobjコマンドに-Cオプションを追加した。

通信障害によるメッセージの消失を軽減するために，TP1/EEが使用するポート番号を，自動的に割り当てる機能を追加した。

これに伴い，RPC関連定義のrpc_reply_port_autoオペランドを追加した。

TP1EEファイルシステムのI/O処理時間を監視できる機能を追加した。

これに伴い，ファイルサービス関連定義を追加した。

ファイルサービス関連定義

fil_watch_time

fil_watch_timeout

別プロセスによるトランザクション回復に時間が掛かる場合の対策方法を記載した。

付録E.10　変更内容（3000-3-982-30）

uCosminexus TP1/Server Base Enterprise Option　07-00の製品の変更内容（3000-3-982-30）を表に示します。

追加・変更内容

TP1/EEをリモートAPI機能のrapサーバとして動作できるようにした。

これに伴い，次のオペランドを追加した。

RPC関連定義

rap_notify

rap_client_manager_node

rpc_rap_inquire_time

rpc_rap_connection_count

rap_client_manager_port

rap_listen_inf

rpc_rap_watch_time

RPCメッセージの最大長拡張機能を追加した。

これに伴い，メモリ関連定義のオペランド，およびeedbqtblhコマンドの-zオプションの最大値を拡張した。

トラブルシュート機能で次のことができるようにした。

UAPトレース情報の編集出力，および強制出力

TASKTM情報の編集出力（コアファイルまたはメモリダンプファイル入力）

回線トレース情報の編集出力（コアファイルまたはメモリダンプファイル入力）

また，UAPトレースファイル，TASKTMファイル，および回線トレースファイルの障害時の運用を変更した。

これに伴い，次のオペランドを追加した。

プロセス関連定義

trb_uap_trace_file_out

トラブルシュート関連定義

trb_uap_trace_file_size

trb_uap_trace_file_no

また，次のコマンドを追加した。

eetrblinedump

eetrbtaskdump

eetrbuated

eetrbuatfput

適用OSにRed Hat Enterprise Linux AS 4 (IPF)を追加した。

システム用トランザクションの処理監視時間に加算するDBアクセス時間を指定できる機能を追加した。

これに伴い，プロセス関連定義にsys_dba_waittimeオペランドを追加した。

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

このマニュアルの関連マニュアルを次に示します。必要に応じてお読みください。

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

このマニュアルの関連マニュアルを次に示します。必要に応じてお読みください。

OpenTP1 Version 7

関連製品

COBOL85 使用の手引（3000-3-354）

COBOL2002 使用の手引 手引編（3000-3-D42）

COBOL2002 使用の手引 操作編（3000-3-D43）

HiRDB Version 9 構造型データベース機能（3000-6-361）

HiRDB Version 9 解説（3020-6-450）

HiRDB Version 9 システム導入・設計ガイド（UNIX(R)用）（3000-6-452）

HiRDB Version 9 システム定義（UNIX(R)用）（3000-6-453）

HiRDB Version 9 システム運用ガイド（UNIX(R)用）（3000-6-454）

HiRDB Version 9 コマンドリファレンス（UNIX(R)用）（3000-6-455）

HiRDB Version 9 UAP開発ガイド（3020-6-456）

HiRDB Version 9 SQLリファレンス（3020-6-457）

HiRDB Version 9 メッセージ（3020-6-458）

HiRDB Version 9 XDM/RD E2接続機能（3020-6-465）

HiRDB Version 10 解説（3020-6-551）

HiRDB Version 10 システム導入・設計ガイド（UNIX(R)用）（3020-6-552）

HiRDB Version 10 システム定義（UNIX(R)用）（3020-6-554）

HiRDB Version 10 システム運用ガイド（UNIX(R)用）（3020-6-556）

HiRDB Version 10 コマンドリファレンス（UNIX(R)用）（3020-6-558）

HiRDB Version 10 UAP開発ガイド（3020-6-560）

HiRDB Version 10 SQLリファレンス（3020-6-561）

HiRDB Version 10 メッセージ（3020-6-562）

HiRDB Version 10 XDM/RD E2接続機能（3020-6-565）

HiRDB Version 10 構造型データベース機能（3020-6-578）

高信頼化システム監視機能 HAモニタ Linux(R)編（3000-9-132）

高信頼化システム監視機能 HAモニタ Linux(R)（x86）編（3000-9-201）

高信頼化システム監視機能 HAモニタ メッセージ（3000-9-203）

Cosminexus Reliable Messaging（3020-3-M17）

Cosminexus アプリケーションサーバ V8 Cosminexus Reliable Messaging（3020-3-U21）

Cosminexus V9 アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)（3020-3-Y07）

なお，このマニュアルでは，次のマニュアルについて，対象OSおよびバージョン番号を省略して表記しています。マニュアルの正式名称とこのマニュアルでの表記を次に示します。

正式名称

このマニュアルでの表記

HiRDB Version 10 システム導入・設計ガイド（UNIX(R)用）

HiRDB システム導入・設計ガイド

HiRDB Version 9 システム導入・設計ガイド（UNIX(R)用）

HiRDB Version 10 システム定義（UNIX(R)用）

HiRDB システム定義

HiRDB Version 9 システム定義（UNIX(R)用）

HiRDB Version 10 システム運用ガイド（UNIX(R)用）

HiRDB システム運用ガイド

HiRDB Version 9 システム運用ガイド（UNIX(R)用）

HiRDB Version 10 コマンドリファレンス（UNIX(R)用）

HiRDB コマンドリファレンス

HiRDB Version 9 コマンドリファレンス（UNIX(R)用）

HiRDB Version 10 UAP開発ガイド

HiRDB UAP開発ガイド

HiRDB Version 9 UAP開発ガイド

HiRDB Version 10 SQLリファレンス

HiRDB SQLリファレンス

HiRDB Version 9 SQLリファレンス

HiRDB Version 10 メッセージ

HiRDB メッセージ

HiRDB Version 9 メッセージ

HiRDB Version 10 XDM/RD E2接続機能

XDM/RD E2接続機能

HiRDB Version 9 XDM/RD E2接続機能

高信頼化システム監視機能 HAモニタ Linux(R)編

高信頼化システム監視機能 HAモニタ

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

(1)　製品名

このマニュアルで使用する製品名称の略称を次に示します。

略称

名称

Linux

Linux (EM64T)

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

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

Red Hat Enterprise Linux Server 8 (64-bit x86_64)

Red Hat Enterprise Linux Server 9 (64-bit x86_64)

Linux (IA32)

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

Linux (EM64T) 対応TP1/EE製品

P-8264-2A21 uCosminexus TP1/Server Base Enterprise Option(64)

P-8864-2A21 uCosminexus TP1/Server Base Enterprise Option(64)

MCP

uCosminexus TP1/EE/Message Control Extension

Oracle

Oracle 10g R2

Oracle Database 10g Release 2

Oracle 11g R1

Oracle Database 11g Release 1

TP1/Client

TP1/Client/J

uCosminexus TP1/Client/J

TP1/Client/P

uCosminexus TP1/Client/P

TP1/Client/W

uCosminexus TP1/Client/W

TP1/EE

TP1/Server Base Enterprise Option

uCosminexus TP1/Server Base Enterprise Option

uCosminexus TP1/Server Base Enterprise Option(64)

TP1/FSP

uCosminexus TP1/Financial Service Platform

TP1/Server Base

uCosminexus TP1/Server Base

UNIX

UNIX(R)

XDB

uCosminexus TP1/EE/Extended Data Cache

XTC

uCosminexus TP1/EE/Extended Transaction Controller

(2)　アーキテクチャによる違い

TP1/EEマニュアルでは，32ビットアーキテクチャ対応OSと64ビットアーキテクチャ対応OSで記述を書き分けている個所があります。ご使用のOSをご確認の上，アーキテクチャに応じた記載個所をお読みください。

このマニュアルでのアーキテクチャの違いによる表記と対応OSを次の表に示します。

マニュアルの表記

OS

32ビットアーキテクチャの場合

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

64ビットアーキテクチャの場合

Red Hat Enterprise Linux Server 6 (64-bit x86_64)，Red Hat Enterprise Linux Server 7 (64-bit x86_64)，Red Hat Enterprise Linux Server 8 (64-bit x86_64)，Red Hat Enterprise Linux Server 9 (64-bit x86_64)

(3)　インストールディレクトリのパス

このマニュアルでは，TP1/EEのインストールディレクトリを次のように表記しています。

このマニュアルでの表記

読み替え

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

/opt/OpenTP1

付録F.3　英略語

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

英略語

英字での表記

AP

Application Program

API

Application Programming Interface

C/S

Client/Server

CPU

Central Processing Unit

CR

Carriage Return

CSV

Comma Separated Value

CUP

Client User Program

DAM

Direct Access Method

DB

Database

DBMS

Database Management System

DML

Data Manipulation Language

DNS

Domain Name System

DTP

Distributed Transaction Processing

EOF

End of File

FIFO

First-In-First-Out

GUI

Graphical User Interface

HA

High Availability

I/O

Input/Output

ID

Identifier

IP

Internet Protocol

J2EE

Java 2 Platform Enterprise Edition

LAN

Local Area Network

LF

Line Feed

MCF

Message Control Facility

MTU

Maximum Transmission Unit

NFS

Network File System

OLTP

Online Transaction Processing

OS

Operating System

OSI

Open Systems Interconnection

OSI TP

Open Systems Interconnection Transaction Processing

PC

Personal Computer

RAC

Real Application Clusters

RPC

Remote Procedure Call

SDB

Structured Database

SPP

Service Providing Program

SUP

Service Using Program

TAM

Table Access Method

TCP/IP

Transmission Control Protocol/Internet Protocol

TP

Transaction Processing

UAP

User Application Program

UDP

User Datagram Protocol

UOC

User Own Coding

WAN

Wide Area Network

WS

Workstation

XA

Extended Architecture

TP1/EEマニュアルで使用する略称の一覧を次に示します。

略称

名称

AP

アプリケーションプログラム

API

アプリケーションプログラミングインタフェース

CUP

クライアントユーザプログラム

DB

データベース

IFA

スレッド対応エリア

IMA

入力メッセージ引き渡しエリア

OMA

出力メッセージ引き渡しエリア

RPC

リモートプロシジャコール

SPP

サービス提供プログラム

SUP

サービス利用プログラム

UAP

ユーザアプリケーションプログラム

WS

ワークステーション

XID

トランザクション識別子

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

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

付録G　用語解説

（英字）

CUP（Client User Program）

OpenTP1クライアント機能（TP1/Client）で使用する，クライアント専用のUAPのことです。TP1/EEがTP1/Clientと連携して動作する場合は，リモートAPI機能およびRPC通信を実現できます。

DBキュー機能

データベースを介してAP間またはシステム間で連携する，TP1/EEの機能です。DBキュー機能を使用すると，データベースをキューとして，TP1/EE内でのAP間や，TP1/EE同士またはTP1/EEとJ2EEとの間でのシステム間で，非同期型のメッセージ送受信ができます。ただし，Oracleをリソースマネジャとして使用する場合，TP1/EEとJ2EEとの間では，DBキューを使用したシステム間通信はできません。

DTPモデル

オープンシステムの標準化を目的とした団体であるX/Openが規定する，分散処理システムモデルのことです。DTPモデルは，トランザクション処理を管理，実行するトランザクションマネジャ，各種資源を管理するリソースマネジャ，および業務処理をするUAPから構成されます。

OpenTP1管理者

OpenTP1を管理する，UNIX OSの利用者のことです。OpenTP1管理者をどの利用者名称とするかは，スーパユーザが決めます。OpenTP1管理者は，OpenTP1を使う上で重要な権限を持つユーザです。システムの機密保護上，利用者名称にはパスワードを必ず設定して，限られた人だけがOpenTP1管理者の利用者名称を使えるようにしてください。

OpenTP1ファイルシステム/OpenTP1ファイル

TP1/Server Base専用のファイルシステムをOpenTP1ファイルシステム，OpenTP1ファイルシステムの個々のファイルをOpenTP1ファイルといいます。OpenTP1ファイルシステムとして使用する領域をキャラクタ型スペシャルファイルまたはブロック型スペシャルファイル上に作成して，TP1/Server Baseのコマンドで初期化します。その後，使用する目的別のコマンドでOpenTP1ファイルを初期化してから使用します。

OpenTP1ホームディレクトリ

OpenTP1で使う各種ファイル，またはディレクトリを格納しているディレクトリのことです。OpenTP1ホームディレクトリの名称の仮定値は，インストールディレクトリです。

OpenTP1では，OpenTP1ホームディレクトリをDCDIRという環境変数で管理しています。OpenTP1が組み込んであるマシンでは，任意のディレクトリから$DCDIRと指定して移動すると，OpenTP1ホームディレクトリに移れます。

RAC（Real Application Clusters）

共有ディスクにある一つのデータベースを複数ノードで共用して処理するクラスタシステムのことです。

RPC（Remote Procedure Call）

→リモートプロシジャコール欄を参照してください。

SPP（Service Providing Program）

OpenTP1のUAPのうち，ファイルへのアクセスなどサーバの役割をするプログラムのことです。SPPは，クライアントUAPから要求されたサービスを実行するサービス関数と，サービス関数をまとめるメイン関数から構成されます。

SUP（Service Using Program）

OpenTP1のUAPのうち，SPPに処理要求をするだけの，クライアント専用のプログラムのことです。ほかのUAPにサービスを提供するための関数は持ちません。

TASKTM

TP1/EEが出力するトランザクションごとの統計情報です。トランザクションの開始からコミットまたはロールバックの間に，各スレッドで処理する事象発生回数や時間が，TASKTM情報としてファイルに格納されます。TASKTM情報を編集，出力する場合は，TP1/EEのコマンドを実行します。

TCP/IP

米国国防総省高等研究計画局（DARPA）のプロジェクトであるARPANETが開発したプロトコルのことです。TCP/IPプロトコルは，主にLANで使われます。TP1/EEでは，クライアント／サーバ形態の通信の通信プロトコルにTCP/IPを使用します。

TP1EEファイルシステム/TP1EEファイル

TP1/EE専用のファイルシステムをTP1EEファイルシステム，TP1EEファイルシステムの個々のファイルをTP1EEファイルといいます。TP1EEファイルシステムとして使用する領域をキャラクタ型スペシャルファイルまたはブロック型スペシャルファイル上に作成して，TP1/EEのコマンドで初期化します。その後，使用する目的別のコマンドでTP1EEファイルを初期化してから使用します。

TP1キャッシュ機能

インメモリデータ処理技術を中心とした高速トランザクション処理機能の総称です。TP1キャッシュ機能を使用することで，トランザクション処理の高速化と，高信頼性，高可用性を同時に実現するオンライントランザクション処理システムを構築できます。

TPモニタ

トランザクション処理の監視，および制御をするソフトウェアのことです。オンラインシステムを構築するための基盤となる機能を提供しています。主な機能として，端末やほかのコンピュータとデータをやり取りするための通信機能，トランザクションを効率的に処理するためのスケジュール機能，トラブルが起こってもデータとトランザクションの消失や不整合を防ぐ回復機能があります。

UAP（User Application Program）

ユーザの業務をプログラムとして作成したものです。アプリケーションプログラムともいいます。

（ア行）

アドレス境界

アドレス境界とは，ナチュラルマスクに対応したネットワークアドレスの境界を意味します。アドレスクラスの境界ではありません。

アプリケーション

TP1/EEの業務処理の総称です。アプリケーションとして作成するプログラムをアプリケーションプログラム（またはユーザアプリケーションプログラム　UAP）といいます。

応答メッセージ

→問い合わせ応答メッセージ欄を参照してください。

オートコネクトモード

常設コネクションの確立・解放をOpenTP1が管理する形態を，オートコネクトモードといいます。

オンラインバッチ機能

UAPを利用して大量データのバッチ処理を実現する，TP1/EEの機能です。オンラインバッチ機能を使用すると，大量データをロットという単位で処理することによってデータベースの負荷を分散できたり，データ型とイベント型という2種類の処理形態によって多様な業務に対応できたりします。

（カ行）

回線トレース

送受信メッセージや，リソースマネジャ使用時のXAインタフェースなどのデータ，状態に関する情報です。通常はイベント発生時の要求ごとに取得します。ただし，トランザクション実行中に要求された取得項目は，トランザクション終了時に一括して取得します。回線トレースを編集，出力する場合は，TP1/EEのコマンドを実行します。

キュー受信型サーバ

スケジュールキューを経由してメッセージを受信するサーバUAPのことです。

クライアント／サーバ

プログラムとプログラムで通信する場合の関係を示す用語です。業務処理を依頼する方をクライアント，要求を受けて業務を実行する方をサーバといいます。クライアント／サーバとは，プログラム間の相対的な関係を示します。

クライアントUAP／サーバUAP

複数のUAPプロセス間でクライアント／サーバ型の通信をするときに，業務処理を依頼するためにサービスを要求するUAPをクライアントUAP，要求を受けて業務を実行するUAPをサーバUAPといいます。TP1/EEを使用した通信で，クライアントUAPとなるのは，SUP，SPP，およびCUPです。サーバUAPとなるのはSPPです。

グローバルトランザクション

RPCを使用した複数のUAPにわたる処理をトランザクションとする場合，このトランザクションをグローバルトランザクションといいます。グローバルトランザクションは複数のUAPから構成されます。それぞれのUAPをトランザクションブランチといいます。

コネクション

メッセージ送受信の業務で，ほかのシステムとOpenTP1システムとの間に確立する論理的な通信路をコネクションといいます。

コミット

トランザクションの同期点を取得できたことをコミットといいます。コミットできた場合，該当するトランザクション処理が有効になります。

（サ行）

サービス

クライアント／サーバシステムでは，クライアントから要求された手続きを総称してサービスといいます。UAPのコーディング時には，C言語の場合は関数として，COBOL言語の場合はサブルーチンとして，サービスを作成します。作成したサービスのことを，C言語の場合はサービス関数，COBOL言語の場合はサービスプログラムといいます。

サービスグループ

OpenTP1のサーバUAPは，クライアントからの手続き要求を処理するサービスの集合です。このことから，サーバUAPのことをサービスグループといいます。TP1/EEのリモートプロシジャコールの関数ee_rpc_callでは，サービスを要求するときにサービスグループ名とサービス名を引数に設定します。

システムサービス

TP1/EEの個々の機能を指してシステムサービスといいます。

スーパユーザ（superuser）

UNIX OSの最高権限を持つユーザのことです。UNIXファイルシステムのすべてのファイルに対してアクセス権を持ちます。スーパユーザの利用者名称はrootで固定されています。

ステータスサービス

TP1/EEの機能の一つで，サービスの閉塞状態などのシステム制御情報を管理する機能です。

スレッドの回復

TP1/EEに障害が発生した場合に，システムの処理を続行したまま障害個所を回復し，障害で処理が中断したトランザクションの決着処理をすることをスレッドの回復といいます。

ソケット受信型サーバ

スケジュールキューを経由しないで直接メッセージを受信するサーバUAPのことです。

（タ行）

デッドロック

複数のUAPが複数の資源を確保しようとして，互いのUAPが資源を解放するのを待ち続けて処理が止まってしまう状態のことをデッドロックといいます。

問い合わせ応答メッセージ

メッセージ送受信の業務で，メッセージを送信して応答を返す形態で使用するメッセージのことです。

同期点

トランザクション処理の区切りを同期点といいます。トランザクション処理が正常終了したことを示す同期点処理をコミット，トランザクション処理がうまくいかなかったため無効にする同期点処理をロールバックといいます。

トランザクショナルRPC

RPCでは，サービス要求をしてから結果が返ってくるまでの処理をトランザクションとするかどうかをee_rpc_call関数の引数で指定できます。トランザクションとするRPCを，トランザクショナルRPCといいます。トランザクショナルRPCの場合は，複数のノードにわたって処理しているRPCでも，一つのトランザクションとして処理できます。トランザクショナルRPCは，TP1/EE同士，またはTP1/EEとTP1/Server Baseとの間で実行できます。

トランザクション

ファイルからデータを読み出して，変更したデータを書き込む処理（更新処理）では，データの一貫性を保持するため，途中で分けられません。このような処理の単位をトランザクションといいます。トランザクションの処理結果は，有効にするか無効にするかのどちらかに必ず決められます。

トランザクションブランチ

RPCを使用した複数のUAPにわたる処理をトランザクションとする処理（グローバルトランザクション）を構成するそれぞれのUAPをトランザクションブランチといいます。トランザクションを開始したトランザクションブランチを，ルートトランザクションブランチといいます。また，一つのトランザクションブランチから生成されたトランザクションブランチを子トランザクションブランチといい，子トランザクションブランチを生成したトランザクションブランチを親トランザクションブランチといいます。

トランザクションマネジャ（Transaction Manager）

トランザクション処理を管理，および実行する機能のことです。

（ナ行）

ノード

ネットワークでつながれた，TP1/EEやTP1/Server Baseが稼働する一つのコンピュータ（マシン）のことです。

（ハ行）

物理区画

論理ボリュームにディスクスペースを割り当てるための最小単位を物理区画といいます。

プロセス

ユーザサーバ，またはTP1/EEが，OSの作業領域を使用することで生成される作業領域の処理をプロセスといいます。

プロセスの回復

TP1/EEに障害が発生した場合に，プロセスダウンで処理が中断したすべてのトランザクションに対してTP1/EE再開始時に決着処理をすることをプロセスの回復といいます。プロセスの回復には，トランザクションの回復処理よりオンラインの開始処理を優先するディレード回復と，オンラインの開始処理よりトランザクションの回復処理を優先するアンディレード回復があります。

ホスト

ネットワークにつながれた，TP1/EEが稼働する一つの計算機（マシン）のことです。

（マ行）

マルチスレッド

一つのアプリケーションがスレッドと呼ばれる処理単位を複数生成し，並行して複数の処理を行うことをマルチスレッドといいます。TP1/EEは，TP1/Server Base機能の一部をマルチスレッドで実現します。

メッセージログ

TP1/EEシステムの稼働状況に関する情報です。稼働状況を管理したり，障害発生時の切り分けをしたりするために取得します。メッセージログファイルは，TP1/EEの起動時に，TP1/EEのサービスグループごとにUNIXファイルとしてTP1/EEが作成します。

（ヤ行）

ユーザサーバ

ユーザで作成したUAPによって，業務処理としてサービスを提供するサーバをユーザサーバといいます。

（ラ行）

リソースマネジャ（Resource Manager）

分散処理システムでの，資源を管理する機能の総称です。DBMSはリソースマネジャです。

リモートAPI機能

クライアント側のノードにあるUAPが呼び出したAPIを，TP1/EEのプロセスで代理実行する機能をリモートAPI機能といいます。リモートAPI機能を要求するクライアント側のノードにあるUAPをrapクライアントといいます。rapクライアントが呼び出したAPIをrapサーバで実行します。TP1/EEは，rapクライアントとしても，rapサーバとしても動作します。リモートAPI機能で代理実行できるAPIは，ee_rpc_call関数，およびdc_rpc_call関数です。dc_rpc_call関数は，TP1/EEがrapサーバとして動作する場合だけ使用できます。

リモートプロシジャコール（Remote Procedure Call）

UAPを実行するプロセス間で通信する機能を，リモートプロシジャコール（RPC）といいます。TP1/EEのUAPは，ほかのシステムのUAPとRPCで通信します。TP1/Server Baseのネームサービスで，サーバUAPがあるノードのネットワークアドレスとサービスグループ名を管理しているので，RPCを使用するときは，通信相手がクライアント／サーバシステムのどのノードのUAPかを意識する必要はありません。

ルートトランザクションブランチ

グローバルトランザクションに属するトランザクションブランチのうち，トランザクションを開始したUAPをルートトランザクションブランチといいます。

ロールバック

トランザクション処理を無効にする同期点処理をロールバックといいます。UAPから関数を呼び出す場合と，TP1/EEからUAPの処理を無効にする場合があります。

索引

数字

1相最適化[1]

1相最適化の実行中にプロセスダウンしたときのプロセスの回復[1]

2相コミット[1]

A

AP間通信[1]

C

call_cmd_service[1]

call_cmd_srvgroup[1]

call_cmd_time[1]

clock_time_interval[1]

cmd_port[1]

cobol_lang[1]

cobol_uap_cblend[1]

cobol_use_flag[1]

COBOL言語を使用する場合の設定[1]

COBOL実行空間を毎回再生成するかどうかを指定[1]

COBOL製品を指定[1]

COBOL用メモリ管理機能[1]

COBOL用メモリ管理機能で処理スレッド単位に確保するプールサイズ[1]

COBOL用メモリ管理機能でプロセス単位に確保するプールサイズ[1]

Cosminexus連携機能[1]

CUP[1]

CUP〔用語解説〕[1]

D

dbq[1]

dbq_endcheck_mode[1]

dbq_endcheckmsg_interval[1]

dbq_inhibit_use[1]

dbq_max_message_size[1]

dbq_obs_endcheckmsg_interval[1]

dbq_obs_lot_no[1]

dbq_obs_service[1]

dbq_obs_trn_end_api[1]

dbq_obs_use[1]

dbq_read_error_uap_stop[1]

dbq_readcheckmsg_interval[1]

dbq_recv_message_buf_cnt[1]

dbq_reqbuf_retry_timer[1]

dbq_rollback_retry_count[1]

dbq_send_message_buf_cnt[1]

dbq_service[1]

dbq_uap_stop[1]

dbq_use[1]

dbq_use_buf_cnt[1]

dbqdef[1]

dbqgrpdef[1]

dbqobsdef[1]

dbqobslotdef[1]

dbqobssrvdef[1]

dbqprcdef[1]

dbqsrvdef[1]

dbqsvgdef[1]

DBアクセス障害[1]

DBキューイベント通知メッセージ送受信用コネクション[1]

DBキュー書き込み禁止機能[1]

DBキュー書き込みメッセージ表の戻し[1]

DBキュー書き込み抑止機能[1]

DBキュー機能[1]

DBキュー機能オプション[1]

DBキュー機能関連定義[1]

DBキュー機能関連定義の内容[1]

DBキュー機能で使用する最大バッファ面数[1]

DBキュー機能で使用する最大メッセージサイズ[1]

DBキュー機能で使用する受信バッファ面数[1]

DBキュー機能で使用する送信バッファ面数[1]

DBキュー機能の運用[1]

DBキュー機能のサービス名とそのサービスを提供するエントリポインタ名の組み合わせ[1]

DBキュー機能の障害対策[1]

DBキュー機能のトランザクションの流れ（AP間通信）[1]

DBキュー機能のトランザクションの流れ（ユーザキューアクセス）[1]

DBキュー機能〔用語解説〕[1]

DBキュー機能を使用するかどうかを指定[1]

DBキューグループ指定によるメッセージ書き込み時のDBキューの縮退指定[1]

DBキューグループのDBキューリストの表示[1]

DBキュー交替用切り替え状況の表示[1]

DBキューサービス[1]

DBキューサービスとDBキューとの接続状態の表示[1]

DBキューサービスの状態のリスト表示[1]

DBキューサービスのスケジュール方式[1]

DBキューサービスの閉塞[1]

DBキューサービスの閉塞解除[1]

DBキュー自動読み出し停止機能[1]

DBキュースケジュール状態一括変更機能[1]

DBキューとDBキューサービスとの接続[1]

DBキューとDBキューサービスとの接続〔AP間通信〕[1]

DBキューとDBキューサービスとの接続解除[1]

DBキューとDBキューサービスとの接続〔ユーザキューアクセス〕[1]

DBキューの上書き抑止[1]

DBキューの書き込み抑止または抑止解除[1]

DBキューの管理[1]

DBキューの状態，未読み出しメッセージの有無のリスト表示[1]

DBキューの状態遷移（AP間通信）[1]

DBキューの状態遷移（ユーザキューアクセス）[1]

DBキューの情報表示[1]

DBキューの通番初期化[1]

DBキューの通番の管理[1]

DBキューの通番の初期化[1]

DBキューのトランザクションの決着タイミングをAPI関数による同期点取得時にするかどうかを指定[1]

DBキューのメッセージの書き込み禁止状態操作[1]

DBキューのメッセージのスキップ[1]

DBキューのメッセージ読み出しトランザクションロールバック時の機能の優先順位[1]

DBキューの読み出し再開[1]

DBキューの読み出し停止[1]

DBキューの読み出し停止および停止解除〔AP間通信〕[1]

DBキューの読み出し停止および停止解除〔ユーザキューアクセス〕[1]

DBキュー表によるイベント通知メッセージ送信先の管理[1]

DBキュー表の構成[1]

DBキュー表の命名規則[1]

DBキューメッセージスキップ機能[1]

DBキュー読み出しサーバ監視メッセージ出力間隔[1]

DBキュー読み出しサーバの変更[1]

DBキュー読み出しサーバ変更機能[1]

DBキュー読み出しサーバ変更機能の運用[1]

DBキューを使用したAP間通信の概要[1]

DBキューを使用したメッセージ送受信の方式[1]

DBキューを使用したユーザキューアクセスの概要[1]

DBキューを読み出し停止にする障害ケース[1]

DCDIR[1]

descriptors_expanse_use[1]

DTPモデル[1]

DTPモデル〔用語解説〕[1]

E

E1トランザクション処理監視時間[1]

E2トランザクション処理監視時間[1]

E3トランザクション処理監視時間[1]

E4トランザクション処理監視時間[1]

eeactsv[1]

eeadmccsetup[1]

eeapls[1]

eechgap[1]

eedbqactsv[1]

eedbqaltlsh[1]

eedbqaltput[1]

eedbqchgr[1]

eedbqclr[1]

eedbqclrh[1]

eedbqcnct[1]

eedbqdctsv[1]

eedbqinhibit[1]

eedbqislt[1]

eedbqls[1]

eedbqlscs[1]

eedbqlsdq[1]

eedbqlsqg[1]

eedbqlssv[1]

eedbqrels[1]

eedbqrst[1]

eedbqskip[1]

eedbqstop[1]

eedbqtblh[1]

eedbqtblo[1]

eedbqwtpr[1]

eedctsv[1]

eedefchk[1]

eefilbkup[1]

eefilchgrp[1]

eefilchmod[1]

eefilchown[1]

eefills[1]

eefilmkfs[1]

eefilrstr[1]

eefilstatfs[1]

eelckls[1]

eelspce[1]

eelsque[1]

eelssv[1]

eememls[1]

eenamupdate[1]

eenamupdateコマンドによるキャッシュ即時更新[1]

eerasget[1]

eerasgetコマンドまたはdcrasgetコマンドで取得する保守資料一覧[1]

eerpclscn[1]

eerpcnamdel[1]

eerpcrapcls[1]

eerpcrapls[1]

eerpcsockcls[1]

eerpcspndls[1]

eerpcspndrles[1]

eerpcstat[1]

eerpctcpls[1]

eesgrpctl[1]

eestsclose[1]

eestsfills[1]

eestsinit[1]

eestsls[1]

eestsopen[1]

eestsrm[1]

eestsswap[1]

eesvgdef[1]

eesvstart[1]

eesvstop[1]

eetrblinedump[1]

eetrblineed[1]

eetrbrcvr[1]

eetrbreport[1]

eetrbstced[1]

eetrbstcese[1]

eetrbstcfput[1]

eetrbstcse[1]

eetrbtaskdump[1]

eetrbtasked[1]

eetrbtaskfput[1]

eetrbtbldump[1]

eetrbtrcefput[1]

eetrbuapdump[1]

eetrbuated[1]

eetrbuatfput[1]

eetrbwtor[1]

eetrncmt[1]

eetrnfgt[1]

eetrnlsdump[1]

eetrnlsrm[1]

eetrnlstr[1]

eetrnmkobj[1]

eetrnrbk[1]

eetrntim[1]

errtrn1[1]

errtrn2[1]

errtrn3[1]

ERRTRN3によるRPC応答メッセージ送信機能を使用するかどうかを指定[1]

errtrn4[1]

errtrnr[1]

ERRTRNRによるRPC応答メッセージ送信機能[1]

ERRTRNRによるRPC応答メッセージ送信機能を使用するかどうかを指定[1]

ERRTRNRによるRPC応答メッセージの送信[1]

errtrns[1]

ERトランザクション処理監視時間[1]

ESトランザクション処理監視時間[1]

execap_permission_time[1]

EXモード[1]

F

FIFO方式[1]

fil_filesystem_no[1]

fil_watch_time[1]

fil_watch_timeout[1]

forbid_draw_service[1]

fragment_buf_no[1]

fsp_use[1]

H

HiRDB用DBキューの通番強制初期化[1]

HiRDB用のDBキュー表の作成または削除[1]

HiRDB連携時の運用[1]

hostname_no[1]

I

I/O処理時間監視[1]

I/O処理時間監視での監視範囲[1]

icb_no[1]

initialize_sync[1]

ipc_backlog_count[1]

ipc_backlog_count_dbq[1]

ipc_notify_response_host[1]

ipc_recvbuf_size[1]

ipc_recvbuf_size_dbq[1]

ipc_sendbuf_size[1]

ipc_sendbuf_size_dbq[1]

ipc_tcpnodelay[1]

ipc_tcpnodelay_dbq[1]

L

lck[1]

lck_limit_foruser[1]

lck_timeout_info[1]

lck_wait_timeout[1]

leveldown_queue_count[1]

leveldown_queue_rate[1]

levelup_queue_count[1]

levelup_queue_rate[1]

loadcheck_interval[1]

loadcheck_type[1]

loadlevel_message[1]

log[1]

log_base_infid[1]

log_file_max[1]

log_file_size[1]

log_hsyslog_cmode[1]

log_msg_allno[1]

log_msg_console[1]

log_msg_date[1]

log_msg_hostname[1]

log_msg_pgmid[1]

log_msg_prcid[1]

log_msg_prcno[1]

log_msg_sysid[1]

log_msg_time[1]

log_syslog_central_no[1]

log_syslog_date[1]

log_syslog_elist[1]

log_syslog_id[1]

log_syslog_out[1]

log_syslog_prcid[1]

log_syslog_prcno[1]

log_syslog_service_name[1]

log_syslog_time[1]

log_usermsg_console[1]

M

max_descriptors[1]

max_mem_size[1]

max_mem_size_mb[1]

max_message_size[1]

max_outmessage_size[1]

MCP[1]

mcp_use[1]

MCP受信スレッド[1]

MCPトレースファイル[1]

MCPを使用するかどうかを指定[1]

mem[1]

memory_alert_rate[1]

memory_cobol_area_size[1]

memory_cobol_area_thd_size[1]

memory_leak_message[1]

memory_leak_message_ignore_attr[1]

MEトランザクション処理監視時間[1]

MIトランザクション処理監視時間[1]

MNトランザクション処理監視時間[1]

module[1]

module_open_flag[1]

multi_schedule[1]

mutexの属性としてPTHREAD_MUTEX_ADAPTIVE_NPを設定するかどうかを指定[1]

myreplydef[1]

mysvgdef[1]

N

Nagleアルゴリズムを無効にするかどうかを指定[1]、[2]

name_cache_size[1]

name_use[1]

node_id[1]

O

OBM統計情報取得間隔時間[1]

OpenTP1管理者の環境設定[1]

OpenTP1管理者〔用語解説〕[1]

OpenTP1の開始と終了[1]

OpenTP1ファイルシステム〔用語解説〕[1]

OpenTP1ファイル〔用語解説〕[1]

OpenTP1ホームディレクトリ〔用語解説〕[1]

Oracle RAC機能[1]

Oracle用のDBキュー表の作成または削除[1]

Oracle連携時の運用[1]

other_lib_stack_size[1]

P

pce_no[1]

PPトレーススレッド[1]

proc_hungup_time[1]

PRモード[1]

R

RAC〔用語解説〕[1]

rap_client_hostname[1]

rap_client_manager_node[1]

rap_client_manager_port[1]

rap_inquire_time[1]

rap_inquire_timeout_message[1]

rap_listen_inf[1]

rap_listen_port[1]

rap_max_client[1]

rap_max_server_rate[1]

rap_msg_output_interval[1]

rap_notify[1]

rapクライアント[1]

rapクライアント数表示メッセージの出力間隔[1]

rapクライアントの自ホスト名[1]

rapクライアントマネジャ[1]

rapクライアントマネジャ機能[1]

rapクライアントマネジャ機能での受信用ポート番号[1]

rapクライアントマネジャに対して起動通知[1]

rapクライアントマネジャに対して起動通知を送信するかどうかを指定[1]

rapリスナーからの最大応答待ち時間[1]

rapリスナーのポート番号[1]

rapリスナーを起動するOpenTP1ノードのノード識別子[1]

recover_thread_no[1]

recv_message_buf_cnt[1]

recv_message_buf_size[1]

Remote Procedure Call〔用語解説〕[1]

reserve_start_pce_no[1]

reserve_thread_no[1]

Resource Manager〔用語解説〕[1]

RLトランザクション処理監視時間[1]

rpc_cmtsend_retry[1]

rpc_conn_recv_check_interval[1]

rpc_conn_recv_check_use[1]

rpc_connect_conflict_timer[1]

rpc_connect_errmsg[1]

rpc_connect_stopmsg[1]

rpc_connect_timer[1]

rpc_connect_unixdomain[1]

rpc_destination_mode[1]

rpc_extend_function[1]

rpc_extend_sb_node_id[1]

rpc_first_connect_errmsg[1]

rpc_first_connect_errmsg_dbq[1]

rpc_firstmsg_recv_timer[1]

rpc_firstmsg_recv_timer_dbq[1]

rpc_keepalive_count[1]

rpc_keepalive_interval[1]

rpc_keepalive_time[1]

rpc_keepalive_use[1]

rpc_loadbalance[1]

rpc_multi_tp1_in_same_host[1]

rpc_myproc_first[1]

rpc_nam_check_num[1]

rpc_nam_check_time[1]

rpc_nam_conn_check[1]

rpc_nam_eject_rate[1]

rpc_nam_reserve_count[1]

rpc_nam_reserve_time[1]

rpc_nam_retry_count[1]

rpc_nam_retry_interval[1]

rpc_nam_use_time[1]

rpc_nam_watch_time[1]

rpc_name_service_extend[1]

rpc_nowait_cnt[1]

rpc_rap_connection_count[1]

rpc_rap_inquire_time[1]

rpc_rap_linetrace[1]

rpc_rap_remaincon_endwait[1]

rpc_rap_watch_time[1]

rpc_recivingconnect_stopmsg_dbq[1]

rpc_recv_sockctl_highwater[1]

rpc_recv_sockctl_use[1]

rpc_reply_con_cnt[1]

rpc_reply_con_max_cnt[1]

rpc_reply_errtrn3[1]

rpc_reply_errtrnr[1]

rpc_reply_errtrnr_cnt[1]

rpc_reply_port_auto[1]

rpc_reply_proc_max_cnt[1]

rpc_reply_sockctl_highwater[1]

rpc_reply_sockctl_use[1]

rpc_reply_suspend_autosend[1]

rpc_reply_suspend_cnt[1]

rpc_reply_suspend_recover[1]

rpc_reply_suspend_time[1]

rpc_reply_tp1mode[1]

rpc_reply_tp1mode_down[1]

rpc_replymsg_save[1]

rpc_request_cancel_for_server[1]

rpc_request_cancel_for_timedout[1]

rpc_retry[1]

rpc_retry_count[1]

rpc_retry_interval[1]

rpc_router_retry_count[1]

rpc_router_retry_interval[1]

rpc_support_errmsg[1]

rpc_tcp_linetrace[1]

rpc_tcpsend_con_cnt[1]

rpc_tcpsend_con_max_cnt[1]

rpc_tcpsend_proc_max_cnt[1]

rpc_transfer_othersvg[1]

RPC応答メッセージ受信用のポート番号にポート番号自動割り当て機能を使用するかどうかを指定[1]

RPC応答メッセージ送受信用コネクション[1]

RPC応答メッセージ送信の同時抑止最大数[1]

RPC応答メッセージ送信の抑止最大時間[1]

RPC応答メッセージ送信抑止状態の解放[1]

RPC応答メッセージ送信抑止状態の表示[1]

RPC関連定義[1]

RPC関連定義の内容[1]

RPCサービスの機能拡張レベル[1]

RPC通信[1]

RPC通信機能で使用しているコネクションの状態表示[1]

RPC通信機能で使用しているコネクションの切断[1]

RPC通信の注意事項[1]

RPCの回線トレース情報の取得量の変更[1]

RPCの種類[1]

RPCメッセージ転送のリトライ回数[1]

RPCメッセージの最大長拡張機能[1]

RPCメッセージ用コネクションのチェック機能[1]

RPC要求メッセージ送受信用コネクション[1]

RPC〔用語解説〕[1]

RPCをリトライするかどうかを指定[1]

S

scd[1]

scd_retry_of_comm_error[1]

send_message_buf_cnt[1]

send_message_buf_size[1]

service[1]

service_attr[1]

service_group[1]

service_group_no[1]

service_hold[1]

service_hold_watch_procdown[1]

service_hold_watch_use[1]

service_term_watch_time[1]

Serviceの作成[1]

socket_no[1]

SPP[1]

SPP〔用語解説〕[1]

SQLタイムアウト[1]

SQLトレース[1]

stay_watch_check_interval[1]

stay_watch_down_rate[1]

stay_watch_queue_rate[1]

sts[1]

sts_buffer_count[1]

sts_control_buffer_length[1]

sts_initial_error_switch[1]

sts_signal_buffer_length[1]

sts_single_operation_switch[1]

stsflgrp[1]

stsflnam[1]

SUP[1]

superuser〔用語解説〕[1]

SUP〔用語解説〕[1]

sys_dba_waittime[1]

syslog失敗リストのエレメント数[1]

syslog出力時にOpenTP1識別子を付けるかどうかを指定[1]

syslog出力時に拡張SYSLOGの文字コード変換機能を使用するかどうかを指定[1]

syslog出力時にサービス名を付けるかどうかを指定[1]

syslog出力時に時刻を付けるかどうかを指定[1]

syslog出力時に中央処理通番を付けるかどうかを指定[1]

syslog出力時に日付を付けるかどうかを指定[1]

syslog出力時にプロセスIDを付けるかどうかを指定[1]

syslog出力時にメッセージ通番を付けるかどうかを指定[1]

syslog遅延出力[1]

syslogへのメッセージ出力レベル[1]

system_end_me[1]

system_start_mi[1]

system_user_area[1]

system_user_area_mb[1]

system_work_size[1]

T

TASKTM情報の強制出力[1]

TASKTM情報の編集出力[1]

TASKTM情報の編集出力（コアファイルまたはメモリダンプファイル入力）[1]

TASKTMスレッド[1]

TASKTMバッファ数[1]

TASKTMバッファのサイズ[1]

TASKTMファイルの運用[1]

TASKTMファイルの最大ファイル数[1]

TASKTMファイルの最大容量[1]

TASKTMファイルの取得情報のタイプ[1]

TASKTMファイルの障害[1]

TASKTM〔用語解説〕[1]

TCP/IP共有送信用コネクション[1]

TCP/IP共有送信用コネクションの最大数[1]

TCP/IP共有送信用コネクションの状態表示[1]

TCP/IP共有送信用コネクションの接続先プロセス最大数[1]

TCP/IPの受信バッファサイズ[1]、[2]

TCP/IPの送信バッファサイズ[1]、[2]

TCP/IPバッファ不足発生時のリトライ回数[1]

TCP/IPバッファ不足発生時のリトライ間隔[1]

TCP/IP〔用語解説〕[1]

term_watch_time[1]

thd[1]

thd_backtrace_msg[1]

thd_cpuinfo_msg[1]

thd_hungup_time[1]

thd_mutex_attr_adaptive[1]

thd_trb_hungup_time[1]

thread_no[1]

thread_user_area[1]

thread_user_area_mb[1]

tim[1]

time_message_no[1]

time_message_size[1]

TMトランザクション処理監視時間[1]

TP1/Client/J[1]

TP1/Client/P[1]

TP1/Client/W[1]、[2]

TP1/EE[1]

TP1/EEオンライン中のリソースマネジャ監視[1]

TP1/EE開始時のDBキュー表の構成チェック〔AP間通信〕[1]

TP1/EE開始時のDBキュー表の構成チェック〔ユーザキューアクセス〕[1]

TP1/EE開始時のリソースマネジャ監視[1]

TP1/EEが対応するコンテナ[1]

TP1/EE稼働前の定義チェック[1]

TP1/EE監視項目一覧[1]

TP1/EEサービス定義[1]

TP1/EEサービス定義の作成[1]

TP1/EEサービス定義の詳細[1]

TP1/EEサービス定義の体系[1]

TP1/EEサービス定義の内容[1]

TP1/EE再開始時の仕掛りトランザクション情報メッセージ出力間隔時間[1]

TP1/EE再開始時のプロセスの回復方法[1]

TP1/EE識別子[1]

TP1/EEシステム[1]

TP1/EEシステム障害の対策[1]

TP1/EEシステムの定義の変更[1]

TP1/EE終了時の未読み出しメッセージのチェック〔AP間通信〕[1]

TP1/EE終了時の未読み出しメッセージのチェック〔ユーザキューアクセス〕[1]

TP1/EE終了時未読み出し監視メッセージ出力間隔[1]、[2]

TP1/EEのアプリケーションプログラム[1]

TP1/EEのインストール[1]

TP1/EEの運用を補助する機能[1]

TP1/EEの開始[1]、[2]

TP1/EEの環境設定の手順[1]

TP1/EEの終了[1]、[2]

TP1/EEのスレッド[1]

TP1/EEのスレッド一覧[1]

TP1/EEの通信形態[1]

TP1/EEの内部監視[1]

TP1/EEのバージョン混在時の注意事項[1]

TP1/EEのリモートプロシジャコール通信[1]

TP1/EEプロセスで確保するメモリの最大サイズ[1]、[2]

TP1/EEプロセスのハングアップ監視[1]

TP1/EEプロセスのメッセージへの応答[1]

TP1/EEプロセスハングアップ監視時間[1]

TP1/EEまたはTP1/Server BaseとRPC通信をする場合[1]

TP1/FSP[1]

TP1/FSPを使用するかどうかを指定[1]

TP1/Server Base[1]、[2]

TP1/Server Base互換のRPC応答モードかどうかを指定[1]

TP1/Server Baseシステム定義の作成[1]

TP1/Server Baseとのトランザクション連携[1]

TP1/Server Baseの再開始[1]

TP1/Server Baseのシステムサービス定義の内容[1]

TP1/Server Baseのノード識別子を通知するかどうかを指定[1]

TP1/Server Baseのノード追加[1]

TP1EEファイル[1]

TP1EEファイルグループの変更[1]

TP1EEファイルシステム[1]

TP1EEファイルシステム総数[1]

TP1EEファイルシステムとOSが提供するファイルシステムとの違い[1]

TP1EEファイルシステムとOSが提供するファイルシステムの関係[1]

TP1EEファイルシステムとTP1EEファイル[1]

TP1EEファイルシステムとファイル[1]

TP1EEファイルシステムのI/O処理監視時間[1]

TP1EEファイルシステムのI/O処理監視時間を超えた場合のTP1/EEの処理を指定[1]

TP1EEファイルシステムの運用[1]

TP1EEファイルシステムの概要[1]

TP1EEファイルシステムの再作成[1]

TP1EEファイルシステムの作成[1]

TP1EEファイルシステムの状態表示[1]、[2]

TP1EEファイルシステムの初期化[1]

TP1EEファイルシステムの初期設定[1]

TP1EEファイルシステムの属性変更の手順[1]

TP1EEファイルシステムの内容表示[1]、[2]

TP1EEファイルシステムのバックアップ[1]

TP1EEファイルシステムの保護[1]

TP1EEファイルシステムのリストア[1]

TP1EEファイルシステムの割り当て[1]

TP1EEファイルシステム〔用語解説〕[1]

TP1EEファイルシステム領域[1]、[2]

TP1EEファイルシステム領域の作成[1]

TP1EEファイルシステム領域の所有者とアクセス権[1]

TP1EEファイルシステムを作成するファイルの選択方法[1]

TP1EEファイル障害[1]

TP1EEファイル所有者の変更[1]

TP1EEファイルのアクセス許可モードの変更[1]

TP1EEファイルの運用[1]

TP1EEファイルの作成[1]

TP1EEファイル〔用語解説〕[1]

TP1キャッシュ機能[1]

TP1キャッシュ機能〔用語解説〕[1]

TPモニタ〔用語解説〕[1]

Transaction Manager〔用語解説〕[1]

trb_dump_area_kind[1]

trb_dump_file_no[1]

trb_dump_output_time[1]

trb_extend_function[1]

trb_iso_interval_time[1]

trb_line_cmtrace_buf_entry_size[1]

trb_line_cmtrace_buffer_no[1]

trb_line_cmtrace_buffer_size[1]

trb_line_trace_buffer_no[1]

trb_line_trace_buffer_size[1]

trb_line_xatrace_buffer_no[1]

trb_stc_basic_kind[1]

trb_stc_buffer_no[1]

trb_stc_buffer_size[1]

trb_stc_ext_kind[1]

trb_stc_file_no[1]

trb_stc_file_size[1]

trb_stc_interval_time[1]

trb_stc_obm_interval_time[1]

trb_stc_sys_kind[1]

trb_stc_use[1]

trb_tasktm_buffer_no[1]

trb_tasktm_buffer_size[1]

trb_tasktm_file_no[1]

trb_tasktm_file_size[1]

trb_tasktm_type[1]

trb_trace_file_no[1]

trb_trace_file_size[1]

trb_trace_type[1]

trb_uap_trace_buffer_no[1]

trb_uap_trace_buffer_size[1]

trb_uap_trace_entry_no[1]

trb_uap_trace_file_no[1]

trb_uap_trace_file_out[1]

trb_uap_trace_file_size[1]

trn[1]

trn_delayed_allrecover[1]

trn_endprepare_msg_interval[1]

trn_endrerun_msg_interval[1]

trn_expiration_time[1]

trn_expiration_time_e1[1]

trn_expiration_time_e2[1]

trn_expiration_time_e3[1]

trn_expiration_time_e4[1]

trn_expiration_time_er[1]

trn_expiration_time_es[1]

trn_expiration_time_me[1]

trn_expiration_time_mi[1]

trn_expiration_time_mn[1]

trn_expiration_time_rl[1]

trn_expiration_time_tm[1]

trn_max_commit_count[1]

trn_max_commit_downmode[1]

trn_max_rollback_count[1]

trn_max_rollback_downmode[1]

trn_max_subordinate_count[1]

trn_onl_pdcwaittime[1]

trn_optimum_item[1]

trn_recovery_failmsg_interval[1]

trn_retry_count_rm_open[1]

trn_retry_count_rm_open_mime[1]

trn_retry_interval_rm_open[1]

trn_retry_interval_rm_open_mime[1]

trn_rm_open_close_scope[1]

trn_rollback_information_put[1]

trn_sta_pdcwaittime[1]

trn_tran_process_count[1]

trn_undelayed_recover_thread[1]

trn_wait_rm_open[1]

trn_watch_time[1]

trnstring[1]

TxRPCインタフェース[1]

TXインタフェース[1]

U

uap_exchange_use[1]

uap_stack_size[1]

uapabend_downmode[1]

UAP異常発生時のダウン種別[1]

UAP確保メモリの解放漏れ警告メッセージを出力するかどうかを指定[1]

UAP共用ライブラリ入れ替え機能[1]

UAP共用ライブラリ入れ替え機能を使用するかどうかを指定[1]

UAP共用ライブラリの入れ替え[1]

UAP共用ライブラリ名[1]

UAP実行に必要なスタックサイズ[1]

UAP障害[1]

UAPトレース情報格納最大レコード数[1]

UAPトレース情報の強制出力[1]

UAPトレース情報の編集出力[1]

UAPトレース情報の編集出力（コアファイルまたはメモリダンプファイル入力）[1]

UAPトレース情報をUAPトレースファイルに出力するかどうかを指定[1]

UAPトレースバッファサイズ[1]

UAPトレースバッファ数[1]

UAPトレースファイルの運用[1]

UAPトレースファイルの最大ファイル数[1]

UAPトレースファイルの最大容量[1]

UAPトレースファイルの障害[1]

UAPにCOBOL言語を使用するかどうかを指定[1]

UAP〔用語解説〕[1]

uCosminexus TP1/EE/Extended Data Cache[1]

uCosminexus TP1/EE/Extended Transaction Controller[1]

uCosminexus TP1/EE/Message Control Extension[1]、[2]

uCosminexus TP1/Financial Service Platform[1]

UDP受信スレッド[1]

UNIXドメインを使用してコネクションを確立するかどうかを指定[1]

user_work_size[1]

W

watch_time[1]

X

xa_open関数のリトライ[1]

xa_open関数呼び出しリトライインタバル時間[1]

xa_open関数呼び出しリトライインタバル時間（MI，MEトランザクション用）[1]

xa_open関数呼び出しリトライ回数[1]

xa_open関数呼び出しリトライ回数（MI，MEトランザクション用）[1]

XA+インタフェース[1]

XATMIインタフェース[1]

XAインタフェース[1]

XAインタフェースである二つの関数（xa_open関数とxa_close関数）の発行タイミングを指定[1]

XAインタフェースによるコネクション制御[1]

XAインタフェースによるトランザクション制御[1]

XAインタフェースの概要[1]

XDB[1]

xdb_use[1]

XDBトレース情報ファイル[1]

XDBトレーススレッド[1]

XDBを使用するかどうかを指定[1]

XTC[1]

xtc_use[1]

XTCを使用するかどうかを指定[1]

あ

アドレス境界〔用語解説〕[1]

アプリケーションプログラム[1]

アプリケーションプログラムのスケジュール[1]

アプリケーション〔用語解説〕[1]

誤ったステータスファイルを使用した場合の対応[1]

アンディレード回復[1]、[2]

アンディレード回復処理に処理スレッドを使用するかどうかを指定[1]

い

一時クローズ機能[1]

一時バッファ領域サイズ[1]

イベント監視インタバル間隔時間[1]

インタバルタイマ監視[1]

う

運用[1]

運用コマンド実行機能[1]

運用コマンド実行機能の実行環境設定[1]

運用コマンド実行サーバ応答監視時間[1]

運用コマンド実行サービスグループ名[1]

運用コマンド実行サービス名[1]

運用コマンド入力時の注意事項[1]

運用コマンドの一覧[1]

運用コマンドの概要[1]

運用コマンドの記述形式[1]

運用コマンドの詳細[1]

運用コマンドの使用方法の表示[1]

運用コマンドの動作結果の通知[1]

運用コマンドの入力方法[1]

え

エラートランザクション[1]

エラー発生時のメッセージの出力抑止[1]

お

応答待ちタイムアウト発生時の処理の流れ[1]

応答メッセージ〔用語解説〕[1]

オートコネクトモード[1]

オートコネクトモード〔用語解説〕[1]

オプション[1]

オプションフラグ[1]

オフライン中にコアファイルからトランザクション状態を取得，表示[1]

親トランザクションブランチ[1]

オンライン打ち切り監視範囲処理キュー滞留率[1]

オンライン打ち切り監視判定区間[1]

オンライン打ち切り係数[1]、[2]

オンライン開始監視[1]

オンライン中のPDCWAITTIMEの変更時間[1]

オンライン中のシグナル用ステータスファイルの状態遷移[1]

オンライン中の制御用ステータスファイルの状態遷移[1]

オンライン中のトランザクションの状態表示[1]

オンライン停止[1]

オンラインバッチDBキュー表の命名規則[1]

オンラインバッチ機能[1]

オンラインバッチ機能関連定義[1]

オンラインバッチ機能関連定義の内容[1]

オンラインバッチ機能の運用[1]

オンラインバッチ機能のサービス名とそのサービスを提供するエントリポインタ名の組み合わせ[1]

オンラインバッチ機能の障害対策[1]

オンラインバッチ機能〔用語解説〕[1]

オンラインバッチ機能を使用するかどうかを指定[1]

か

ガーベジコレクション[1]

開始時のPDCWAITTIMEの変更時間[1]

回線トレース情報の強制出力[1]

回線トレース情報の取得量の変更[1]

回線トレース情報の編集出力[1]

回線トレース情報の編集出力（コアファイルまたはメモリダンプファイル入力）[1]

回線トレースの一括出力機能[1]

回線トレースバッファサイズ[1]、[2]

回線トレースバッファ数[1]

回線トレースバッファ数〔trb_line_trace_buffer_no〕[1]

回線トレースバッファ数〔trb_line_xatrace_buffer_no〕[1]

回線トレースファイルとTASKTMファイルの関連づけ[1]

回線トレースファイルの運用[1]

回線トレースファイルの最大ファイル数[1]

回線トレースファイルの最大容量[1]

回線トレースファイルの取得情報のタイプ[1]

回線トレースファイルの障害[1]

回線トレース〔用語解説〕[1]

回復処理で使用するステータスファイル[1]

回復スレッド[1]

回復スレッド数[1]

概要[1]

拡張統計情報の取得[1]

拡張統計情報の統計情報種別[1]

片系運転[1]

環境設定[1]

環境設定（HiRDB連携時）[1]

環境設定（Oracle連携時）[1]

環境設定の概要[1]

環境設定の詳細[1]

監視するrapリスナーを指定[1]

監視スレッド[1]

監視トランザクション[1]

き

起動順序のシリアル化機能[1]

起動順序のシリアル化機能の使用有無によるTP1/EE起動時の処理内容の違い[1]

起動順序のシリアル化機能を使用した処理の例[1]

起動順序のシリアル化機能を使用するかどうかを指定[1]

機能[1]

基本統計情報の取得[1]

基本統計情報の統計情報種別[1]

キャッシュ追い出し率[1]

キャッシュ自動同期[1]

キャッシュ自動同期の保留回数[1]

キャッシュ自動同期の保留期間[1]

キャッシュの追い出し[1]

キャッシュの有効期限[1]

キュー受信型サーバ〔用語解説〕[1]

旧バージョンとのRPC連携[1]

強制正常開始[1]

強制停止[1]

行の継続[1]

業務処理の形態[1]

く

クライアント／サーバ形態の通信[1]

クライアント／サーバ〔用語解説〕[1]

クライアントUAP／サーバUAP〔用語解説〕[1]

グローバルトランザクション[1]

グローバルトランザクションID[1]

グローバルトランザクションの構造[1]

グローバルトランザクション〔用語解説〕[1]

け

系[1]

計画停止A[1]

計画停止B[1]

系監視スレッド[1]

系切り替え機能[1]

系切り替え機能使用時の運用[1]

現用[1]

こ

後退許容時間[1]

交替用メッセージ表書き込み機能[1]

子トランザクションブランチ[1]

子トランザクションブランチ最大数[1]

コネクション確立監視時間[1]

コネクション確立後，監視時間内に最初のDBキューイベント通知メッセージを受信しなかったときのコネクション切断時にKFSB50312-Eメッセージを出力するかどうかを指定[1]

コネクション確立後，監視時間内に最初のメッセージを受信しなかった場合のコネクション切断時にメッセージを出力するかどうかを指定[1]

コネクション確立後の時間監視[1]

コネクション確立失敗時にメッセージを出力するかどうかを指定[1]

コネクション確立の受け付けから最初のDBキューイベント通知メッセージ受信までの監視時間[1]

コネクション確立の受け付けから最初のメッセージ受信までの監視時間[1]

コネクション確立要求を格納するキューの長さ[1]、[2]

コネクション切断時にメッセージを出力するかどうかを指定[1]

コネクションに関する運用[1]

コネクション〔用語解説〕[1]

この章を読む際の留意事項[1]

コマンド受信用のポート番号[1]

コマンドスレッド[1]

コマンドのexitコード[1]

コマンド引数[1]

コマンド名[1]

コマンドログ取得機能[1]

コミット[1]

コミット関数の呼び出し回数が上限値に達した場合の処理を指定[1]

コミット関数の呼び出し回数上限値[1]

コミット〔用語解説〕[1]

コミュニケーションリソースマネジャ[1]

コメント[1]

コンテナオーケストレーションツールを使用したOpenTP1の構成と構築[1]

コンテナ環境独自の設定[1]

コンテナ内のTP1/Server Baseに関する注意事項[1]

コンテナをサポートするTP1/EEのバージョン[1]

さ

サーバUAPの取得数を拡張[1]

サービス[1]

サービス異常終了回数を監視してサービスを閉塞するかどうかを指定[1]

サービス応答用コネクションの最大数[1]

サービス応答用コネクションの接続先プロセス最大数[1]

サービス関数異常時のRPC応答メッセージ送信[1]

サービス関数で設定した応答データの内容をスレッド間で引き継ぐかどうかを指定[1]

サービスグループ[1]

サービスグループ情報関連定義[1]

サービスグループ情報関連定義の内容[1]

サービスグループ閉塞機能[1]

サービスグループ名[1]、[2]

サービスグループ名の最大数[1]

サービスグループ〔用語解説〕[1]

サービス情報キャッシュ領域のサイズ[1]

サービス処理キュー数[1]

サービスの状態表示[1]

サービスのスケジュール[1]

サービスの閉塞[1]、[2]

サービスの閉塞解除[1]

サービスの要求先の決定方法を指定[1]

サービスの要求方法[1]

サービス名[1]

サービス名とそのサービスを提供するエントリポインタ名の組み合わせ[1]

サービス要求送信リトライ回数最大値[1]

サービス要求送信リトライ間隔[1]

サービス〔用語解説〕[1]

サービスを自動的に閉塞[1]

再開始[1]

再開始時に変更できない定義[1]

最大応答待ち時間[1]

先入れ先出し方式[1]

作成，初期設定するTP1EEファイルと使用する運用コマンド[1]

サポート機能[1]

サポート機能の詳細[1]

し

仕掛り中トランザクション情報メッセージ間隔最小時間[1]

シグナルスレッド[1]

シグナル用ステータスファイル[1]、[2]

シグナル用ステータスファイルの障害[1]

シグナル用ステータスファイルをスタックするバッファ長[1]

資源の排他制御[1]

システム間通信[1]、[2]

システム共通定義の内容[1]

システム構成[1]

システム構成と環境設定[1]

システムサービス[1]

システムサービス定義[1]

システムサービス定義を登録するファイル名[1]

システムサービス〔用語解説〕[1]

システム制御情報を引き継げない場合の対応[1]

システム定義[1]

システム定義とファイル名[1]

システム定義の概要[1]

システム定義の種類[1]

システム統計情報の詳細[1]

システム統計情報の統計情報種別[1]

システム統計情報の編集内容[1]

システム統計情報のリアルタイム編集[1]

システム用トランザクションの処理監視時間に加算するDBアクセス時間[1]

システムワーク領域最大サイズ[1]

実行中のトランザクションの確認[1]

自ノードでのサービス要求の処理を優先させるかどうかを指定[1]

終了時の仕掛り中トランザクション情報メッセージ出力間隔時間[1]

縮退監視メッセージ出力間隔時間[1]

受信スレッド[1]

受信バッファサイズ[1]

受信バッファ面数[1]

出力するメッセージログの言語種別の設定[1]

取得するステータスファイルの種類[1]

障害時に取得する情報[1]

障害対応[1]

障害対策[1]

障害メッセージの応答機能[1]

常設コネクション[1]、[2]

常設コネクション最大数[1]

常設コネクション状態表示[1]

常設コネクションの切断[1]

使用できないTP1/Server Baseのコマンド[1]

処理キュー[1]

処理キュー制御機能の運用[1]

処理キュー滞留監視[1]

処理キュー滞留監視間隔時間[1]、[2]

処理キュー滞留率[1]

処理キュー統計情報の表示機能[1]

処理キュー登録失敗時の処理[1]

処理キュー登録失敗によるトランザクション起動障害[1]

処理キューによるスケジュール制御[1]

処理キューの滞留監視で使用する，処理キュー処理率[1]

処理キューの滞留状態の表示およびサービスの最大同時処理限界数の変更[1]

処理キューを引き出し禁止にするかどうかを指定[1]

処理スレッド[1]

処理スレッド動的増加機能の運用[1]

処理スレッドの動的制御[1]

処理スレッドを使用したアンディレード回復時のコネクション制御[1]

す

スーパユーザ〔用語解説〕[1]

スケジューラダイレクト機能を使用したRPC[1]

スケジュールサービス[1]

ステータスサービス[1]

ステータスサービス〔用語解説〕[1]

ステータスファイル[1]

ステータスファイル関連定義[1]

ステータスファイル関連定義の内容[1]

ステータスファイルの運用[1]

ステータスファイルのオープン[1]

ステータスファイルのクローズ[1]

ステータスファイルの構成[1]

ステータスファイルの削除[1]、[2]

ステータスファイルの作成，初期設定[1]

ステータスファイルの作成と定義[1]

ステータスファイルの障害[1]

ステータスファイルの状態[1]

ステータスファイルの状態遷移[1]

ステータスファイルの状態表示[1]、[2]

ステータスファイルのスワップ[1]

ステータスファイルの使い方[1]

ステータスファイルの内容表示[1]、[2]

ステータスファイルの目的[1]

ステータスファイルをスタックするバッファ数[1]

スレッド生成失敗時の処理[1]

スレッド対応インタフェースユーザエリアサイズ〔thread_user_area〕[1]

スレッド対応インタフェースユーザエリアサイズ〔thread_user_area_mb〕[1]

スレッドの回復[1]、[2]

スレッドの回復〔用語解説〕[1]

スレッドハングアップ監視時間[1]

スレッドハングアップ時間監視[1]

スワップ[1]

スワップできる両系がそろった論理ファイルが存在しないときのTP1/EEの処理[1]

せ

制御用ステータスファイル[1]、[2]

制御用ステータスファイルの障害[1]

制御用ステータスファイルのスワップ[1]、[2]

制御用ステータスファイルをスタックするバッファ長[1]

制限事項[1]

正常開始[1]

正常終了[1]

セグメント使用率規定値超過メッセージ出力時の使用割合[1]

接続先プロセスごとのTCP/IP共有送信用コネクションの最大数[1]

接続先プロセスごとのサービス応答用コネクションの最大数[1]

接続中のrapクライアントがある場合のTP1/EEの終了処理の動作を指定[1]

先行許容時間[1]

そ

送信スレッド[1]

送信バッファサイズ[1]

送信バッファ面数[1]

ソケット受信型サーバ〔用語解説〕[1]

ソケット用ファイル記述子の最大数[1]

た

タイマサービス[1]

タイマトランザクション[1]

タイマトランザクション制御[1]

タイマトランザクション登録最大数[1]

タイマトランザクション登録時に使用する最大データサイズ[1]

タイマトランザクション登録時に使用する最大データ数[1]

タイムアウト情報[1]

タイムアウト情報をメッセージに出力[1]

ダウン時のRPCエラー応答がTP1/Server Base互換のRPC応答モードかどうかを指定[1]

他サービスグループへのRPCメッセージを，ノード間負荷バランス機能を使用して転送するかどうかを指定[1]

他製品とのRPC連携[1]

他製品との連携時に必要なスタックサイズ[1]

他製品との連携時の運用[1]

ち

中央処理通番[1]

つ

通常監視区間[1]

通常処理スレッド[1]

通常処理スレッド数[1]

通常処理スレッドの処理キュー検索[1]

通常ファイル[1]

通信障害監視[1]

通信障害監視スレッドの仕掛り中トランザクション監視[1]

通信障害時のリトライ回数の指定[1]

通信障害によるメッセージ消失[1]

通信障害の対策[1]

て

定義構文チェック[1]

定義事前チェック機能[1]

定義詳細チェック[1]

定義の規則[1]

定義の構成[1]

定義の作成手順[1]

定義の体系[1]

定義の変更手順[1]

ディレード回復[1]、[2]

データ連携支援対応[1]

テーブル情報の出力[1]

デッドロック〔用語解説〕[1]

転送スレッド[1]

と

問い合わせ応答メッセージ〔用語解説〕[1]

問い合わせ間隔最大時間[1]

問い合わせ時間間隔監視[1]

同一グローバルドメインとして運用しているかどうかを指定[1]

同期応答型RPC[1]

同期点[1]

同期点処理[1]

同期点〔用語解説〕[1]

統計情報取得間隔時間[1]

統計情報スレッド[1]

統計情報の強制出力[1]

統計情報の編集[1]

統計情報バッファ数[1]

統計情報バッファのサイズ[1]

統計情報ファイルの運用[1]

統計情報ファイルの最大ファイル数[1]

統計情報ファイルの最大容量[1]

統計情報ファイルの障害[1]

統計情報を取得するかどうかを指定[1]

動作中のUAP共用ライブラリ名の表示[1]

同時処理限界数[1]

同時接続可能なrapクライアント数[1]

同時にrap処理できる処理スレッド数の割合[1]

同時に起動するトランザクションブランチの数[1]

同時に発生する排他要求数の最大値[1]

トラブルシュートおよび統計情報の機能拡張レベル[1]

トラブルシュート関連定義[1]

トラブルシュート関連定義の内容[1]

トラブルシュートで使用するスレッドのスレッドハングアップ監視時間[1]

トラブルシュートの性能向上[1]

トランザクショナルRPC[1]

トランザクショナルRPC〔用語解説〕[1]

トランザクションインタフェース情報のノード識別子を利用したリモートプロシジャコール[1]

トランザクション関連定義[1]

トランザクション関連定義の内容[1]

トランザクションサービス[1]

トランザクション情報を取得するステータスファイルの種類[1]

トランザクション処理監視時間[1]

トランザクション処理結果によるRPC応答メッセージ送信[1]

トランザクション処理時間監視[1]

トランザクション処理でのTP1EEファイルシステムへのI/O[1]

トランザクション処理とI/O処理の監視範囲，およびステータスファイルの排他範囲[1]

トランザクション処理の監視時間の変更[1]

トランザクション制御[1]

トランザクション同期点処理時の最大通信待ち時間[1]

トランザクションに関する運用[1]

トランザクションに割り当てられる中央処理通番[1]

トランザクションの回復待ち合わせ[1]

トランザクションの強制決着[1]

トランザクションの強制終了[1]、[2]

トランザクションのコミット[1]

トランザクションのコミットとロールバック[1]

トランザクションの時間監視[1]

トランザクションの状態表示[1]

トランザクションの静止化[1]

トランザクションの静止化状態の解除[1]

トランザクションのロールバック[1]

トランザクションブランチ[1]

トランザクションブランチ同期点処理時の最大通信待ち時間監視[1]

トランザクションブランチ〔用語解説〕[1]

トランザクションマネジャ[1]

トランザクションマネジャの処理内容一覧[1]

トランザクションマネジャ〔用語解説〕[1]

トランザクション〔用語解説〕[1]

トランザクション連携[1]

ね

ネームサーバからの最大応答待ち時間[1]

ネームサーバへの要求失敗時のリトライ回数[1]

ネームサーバへの要求失敗時のリトライ間隔[1]

ネームサービス[1]、[2]

ネームサービス定義の内容[1]

ネームサービスのネーム情報の削除[1]

ネームサービスを使用したRPC[1]

ネームサービスを使用するかどうかを指定[1]

ネームスレッド[1]

の

ノード間負荷バランス拡張機能[1]

ノード間負荷バランス機能[1]

ノード間負荷バランス機能によるRPCメッセージの送信先および転送先の決定[1]

ノード間負荷バランス機能を使用するかどうかを指定[1]

ノード間負荷バランスで使用する処理キュー処理率[1]

ノード間負荷バランスでユーザが指定する処理キュー滞留数[1]

ノード間負荷バランスでユーザが指定する処理キュー滞留率[1]

ノード識別子[1]

ノード〔用語解説〕[1]

は

パーティション[1]

排他情報の表示[1]

排他制御モード[1]

排他待ち[1]

排他待ち限界経過時間[1]

バックアップ[1]

バッファ空き待ち監視時間[1]

バッファコピー抑止機能[1]

ひ

非応答型RPC[1]

非同期応答型RPC[1]

非同期応答型RPCの同時要求メッセージの最大数[1]

非保護区[1]

ヒューリスティック決着[1]、[2]

ヒューリスティックハザード[1]

標準出力および標準エラー出力の出力設定があるメッセージを標準出力および標準エラー出力に出力するかどうかを指定[1]

ふ

ファイル一覧[1]

ファイルサービス関連定義[1]、[2]

ファイル識別子の最大数[1]

ファイル障害[1]

ファイルディスクリプタの拡張（Linuxの場合）[1]

ファイルの運用[1]

ファイルの縮退[1]

ファイルの縮退回復[1]

負荷監視インタバル時間の指定[1]

負荷レベル[1]

負荷レベルが遷移する例（固定の処理キュー処理率をしきい値とした決定方法の場合）[1]

負荷レベルが遷移する例（ユーザが指定する処理キュー滞留数をしきい値とした決定方法の場合）[1]

負荷レベルが遷移する例（ユーザが指定する処理キュー滞留率をしきい値とした決定方法の場合）[1]

負荷レベル監視間隔[1]

負荷レベルと処理キュー処理率[1]

負荷レベルと処理キュー滞留数[1]

負荷レベルと処理キュー滞留率[1]

負荷レベルの決定方法[1]

負荷レベルの決定方法を指定[1]

負荷レベルの変更があった場合にメッセージを出力するかどうかを指定[1]

負荷レベルを判断する処理キュー滞留数を指定[1]

負荷レベルを判断する処理キュー滞留率を指定[1]

複数のTP1/EEを使用する場合の機能[1]

物理区画〔用語解説〕[1]

フラグ引数[1]

フラグメントメッセージ[1]

フラグメントメッセージ用バッファ面数[1]

プリペア処理[1]

プロセス管理テーブルユーザエリアサイズ〔system_user_area〕[1]

プロセス管理テーブルユーザエリアサイズ〔system_user_area_mb〕[1]

プロセス関連定義[1]

プロセス関連定義の内容[1]

プロセスサービス[1]

プロセス終了監視[1]

プロセスの回復[1]、[2]

プロセスの回復中に障害が発生した場合[1]

プロセスの回復〔用語解説〕[1]

プロセス〔用語解説〕[1]

分散トランザクション[1]、[2]

へ

閉塞[1]

別処理スレッドで再送信するか送信障害トランザクションを起動するかを指定[1]

別トランザクションによるRPC同期応答[1]

別トランザクションによるRPC同期応答機能をTP1/EE再開始時に引き継ぐかどうかを指定[1]

ほ

ポート番号自動割り当て機能[1]

保護区[1]

保護区／非保護区の制御[1]

保守資料の取得[1]

ホスト名の最大数[1]

ホスト〔用語解説〕[1]

ま

マルチスケジューラ機能のスケジューラデーモンが起動しているノードを優先的に選択するかどうかを指定[1]

マルチスレッド[1]

マルチスレッド処理[1]

マルチスレッド制御[1]

マルチスレッド〔用語解説〕[1]

み

未サポートメッセージ受信時にメッセージを出力するかどうかを指定[1]

む

無効[1]

め

メインスレッド[1]

メッセージ応答エリアの最大サイズ[1]

メッセージの出力先[1]

メッセージの標準出力時にTP1/EE識別子を付けるかどうかを指定[1]

メッセージの標準出力時にプロセス内のメッセージ通番を付けるかどうかを指定[1]、[2]

メッセージの標準出力時にメッセージの出力要求時の時刻を付けるかどうかを指定[1]

メッセージの標準出力時にメッセージの出力要求時の日付を付けるかどうかを指定[1]

メッセージの標準出力時にメッセージの出力要求元のプログラムIDを付けるかどうかを指定[1]

メッセージの標準出力時にメッセージの出力要求元のプロセスのプロセスIDを付けるかどうかを指定[1]

メッセージの標準出力時にメッセージの出力要求元のホスト名を付けるかどうかを指定[1]

メッセージ引き渡しエリアの最大サイズ[1]

メッセージログ関連定義[1]

メッセージログ関連定義の内容[1]

メッセージログファイルの運用[1]

メッセージログファイルの最大ファイル数[1]

メッセージログファイルの最大容量[1]

メッセージログファイルの障害[1]

メッセージログ〔用語解説〕[1]

メモリ関連定義[1]

メモリ関連定義の内容[1]

メモリサービス[1]

メモリダンプファイル出力監視時間[1]

メモリダンプファイル出力領域種別[1]

メモリダンプファイルの運用[1]

メモリダンプファイルの最大ファイル数[1]

メモリダンプファイルの障害[1]

メモリの使用状況の確認[1]

メモリの使用状況の表示[1]

メモリプールの作成単位[1]

メモリプールを確保するタイミングとサイズ[1]

も

文字コード変換機能[1]

モニタスレッド[1]

ゆ

ユーザキューアクセス[1]

ユーザサーバ[1]

ユーザサーバ〔用語解説〕[1]

ユーザサービス関連定義[1]

ユーザサービス関連定義の内容[1]

ユーザサービス定義の内容[1]

ユーザワーク領域最大サイズ[1]

よ

用語解説[1]

抑止中のRPC応答の抑止状態を自動的に解除してRPC応答を送信するかどうかを指定[1]

予備[1]

予備処理スレッド[1]

予備処理スレッド起動処理キュー数[1]

予備処理スレッド起動タイミング[1]

予備処理スレッド数[1]

予備処理スレッドの処理キュー検索[1]

ら

ラウンドロビン方式[1]

り

リードオンリー最適化[1]

リストア[1]

リソースマネジャ[1]

リソースマネジャが提供するインタフェース[1]

リソースマネジャ障害監視スレッドの仕掛り中トランザクション監視[1]

リソースマネジャ障害の対策[1]

リソースマネジャに関する準備（HiRDB連携時）[1]

リソースマネジャに関する準備（Oracle連携時）[1]

リソースマネジャのオープン処理（xa_open関数）で障害が発生した場合の処置[1]

リソースマネジャの情報の表示[1]

リソースマネジャ〔用語解説〕[1]

リソースマネジャ連携オブジェクトファイルの作成[1]

リソースマネジャ連携用オブジェクトファイルの作成[1]

リトライ処理[1]

リモートAPI機能[1]

リモートAPI機能使用時の回線トレース情報の取得量の変更[1]

リモートAPI機能によるサービスの受信口となるポート番号[1]

リモートAPI機能によるサービスの受信口となるホスト名[1]

リモートAPI機能〔用語解説〕[1]

リモートAPI機能を使用したRPC[1]

リモートAPI機能を使用して要求するサービスの問い合わせ間隔最大時間[1]

リモートAPI受信用のポート番号[1]

リモートAPIのメッセージ送受信用コネクション[1]

リモートAPI要求の最大待ち時間を超えた場合にエラーメッセージを出力するかどうかを指定[1]

リモートプロシジャコールの形態[1]

リモートプロシジャコール〔用語解説〕[1]

る

ルートトランザクションブランチ[1]

ルートトランザクションブランチ〔用語解説〕[1]

れ

連鎖モードのコミットの同期点決着[1]

連続異常終了限界経過時間[1]

連続異常終了限界経過時間監視[1]

連続サービス異常終了限界経過時間[1]

連続サービス異常終了の監視情報を再開始時に継続するかどうかを指定[1]

連続ロールバック監視回数[1]

ろ

ロールバック[1]

ロールバック関数の呼び出し回数が上限値に達した場合の処理を指定[1]

ロールバック関数の呼び出し回数上限値[1]

ロールバック要因に関するメッセージをログに取得するかどうかを指定[1]

ロールバック〔用語解説〕[1]

ログサービス[1]

ログサービス定義の内容[1]

ロックサービス[1]

ロット管理テーブル面数[1]