OpenTP1 Version 7

分散トランザクション処理機能

OpenTP1 運用と操作

操作書

3000-3-D53-50

目　　次

前書き

変更内容

はじめに

第1編　OpenTP1の環境設定

1.　環境設定

1.1　概要

1.1.1　環境設定手順の概要

1.2　スーパユーザによる環境設定

1.2.1　OpenTP1管理者の登録

1.2.2　OpenTP1グループの設定

1.2.3　OpenTP1のインストール

1.2.4　OpenTP1ディレクトリの作成

1.2.5　OpenTP1のOSへの登録と削除

1.2.6　OpenTP1ファイルシステム領域の作成

1.2.7　ドメイン通信の環境設定

1.2.8　システム共通定義の変更

1.3　OpenTP1管理者による環境設定

1.3.1　システム定義の作成と確認

1.3.2　OpenTP1管理者の環境設定

1.3.3　OpenTP1の内部制御用資源の確保

1.3.4　OpenTP1ファイルシステムの初期設定

1.3.5　OpenTP1ファイルの作成

1.3.6　OpenTP1ファイル以外のファイルの作成

1.3.7　リソースマネジャの登録

1.3.8　トランザクション制御用オブジェクトファイルの作成

1.3.9　システム共通定義の変更

1.4　TP1/Message Control実行のための準備

1.4.1　MCF通信サービスのMCFメイン関数の作成方法

1.4.2　アプリケーション起動サービスのMCFメイン関数の作成方法

1.4.3　MCFメイン関数のディレクトリへの組み込み

1.4.4　MCFサービス名の登録

1.4.5　システムサービス情報定義ファイルの作成

1.4.6　定義オブジェクトファイルの作成

1.4.7　コマンドログ取得のための準備

第2編　OpenTP1の運用

2.　OpenTP1の開始と終了

2.1　開始

2.1.1　開始方法

2.1.2　開始モード

2.1.3　開始方法の決定

2.1.4　開始形態の決定

2.2　終了

2.2.1　終了モード

2.2.2　終了方法

2.2.3　注意事項

3.　OpenTP1オンラインの運用

3.1　サーバに関する運用

3.1.1　ユーザサーバの開始

3.1.2　ユーザサーバの終了

3.1.3　サーバの状態表示

3.1.4　ユーザサーバ，およびユーザサーバから起動されるコマンドのサーチパス

3.1.5　ユーザサーバの入れ替え

3.1.6　ユーザサーバのプロセス

3.2　スケジュールに関する運用

3.2.1　スケジュールの状態表示

3.2.2　スケジュールの閉塞，および再開始

3.2.3　スケジュールの自動閉塞

3.2.4　ノード間負荷バランス

3.2.5　プロセス数の変更

3.2.6　スケジュールキューの監視

3.2.7　スケジュールキューの滞留監視

3.2.8　ユーザサーバプロセスのリフレッシュ機能

3.3　トランザクションに関する運用

3.3.1　トランザクションの状態表示

3.3.2　トランザクションの強制決着

3.3.3　トランザクションの強制終了

3.3.4　未決着トランザクション情報ファイルの削除

3.3.5　トランザクション統計情報の取得開始，終了

3.3.6　XAリソースサービス使用時のトランザクション統計情報の取得

3.4　排他に関する運用

3.4.1　排他情報の表示

3.4.2　排他制御用テーブルのプール情報の表示

3.4.3　デッドロック情報ファイルとタイムアウト情報ファイルの削除

3.5　標準出力ファイルに関する運用

3.6　ログ機能

3.6.1　メッセージログ

3.6.2　コマンドログ

3.7　監査ログの運用

3.7.1　監査ログ機能の環境設定

3.7.2　監査ログの出力方式

3.7.3　監査ログファイルの見積もり例

3.7.4　監査ログに出力される情報

3.7.5　監査イベントの一覧と出力ポイント

3.7.6　監査ログの運用例

3.8　トレースに関する運用

3.8.1　UAPトレースの出力

3.8.2　RPCトレースに関する運用

3.8.3　MCFトレースのスワップ

3.8.4　MCFトレースの一時出力

3.8.5　性能検証用トレースに関する運用

3.9　共用メモリに関する運用

3.9.1　共用メモリ使用状況の表示

3.9.2　メッセージ格納バッファプール

3.10　OpenTP1のドメインに関する運用

3.10.1　ドメイン構成の変更

3.10.2　ドメイン代表スケジュールサービス

3.10.3　起動通知情報の無効化

3.10.4　OpenTP1起動確認とキャッシュ削除機能

3.11　ノード自動追加機能を使用する運用

3.11.1　ノード自動追加機能を使用するための構成

3.11.2　ノード自動追加機能を使用するための準備

3.11.3　ノード自動追加機能の導入後の運用

3.11.4　ノード自動追加機能とその他の機能との併用

3.11.5　ノーマルノードを混在させて使用する運用

3.12　TP1/NET/OSI-TP-Extendedを使用する運用

3.13　リモートAPI機能を使用する運用

3.13.1　リモートAPI機能を使用するための準備

3.13.2　rapリスナーおよびrapサーバの状態表示

3.13.3　リモートAPI機能の性能改善

3.13.4　rapリスナーおよびrapサーバの起動と停止

3.13.5　rapクライアントマネジャの起動と停止

3.13.6　rapリスナーとのコネクション確立処理

3.13.7　リモートAPI機能を使用する場合の注意

3.14　OpenTP1の連続運転に関する運用

3.14.1　リソースの扱い

3.14.2　構成変更時の注意

3.14.3　MCF通信サービスの部分入れ替え

3.14.4　時刻変更に関する注意

3.15　XAリソースサービスを使用する運用

3.15.1　XAリソースサービスを使用するための準備

3.15.2　XAリソースサービスのトランザクション管理

3.15.3　XAリソースサービスの開始と終了

3.15.4　XARファイルに障害が発生した場合の運用

3.15.5　XAリソースサービスのトレース

3.16　JP1連携時の運用

3.16.1　シナリオテンプレートを利用したシステムの運用

3.16.2　シナリオの登録

3.16.3　スケールアウトの運用

3.16.4　スケールインの運用

3.16.5　ローリングアップデートの運用

3.16.6　サンプルシナリオテンプレートの利用

3.17　リアルタイム統計情報サービスを使用する運用

3.17.1　リアルタイム統計情報サービスを使用するための準備

3.17.2　リアルタイム統計情報サービスの開始と終了

3.17.3　リアルタイム統計情報の取得

3.17.4　リアルタイム統計情報の出力

3.17.5　リアルタイム統計情報の取得情報の設定変更

4.　OpenTP1のファイルの運用

4.1　OpenTP1ファイルシステムの運用

4.1.1　OpenTP1ファイルシステムの作成

4.1.2　OpenTP1ファイルシステムの状態表示

4.1.3　OpenTP1ファイルシステムの内容表示

4.1.4　OpenTP1ファイルシステムのバックアップ

4.1.5　OpenTP1ファイルシステムのリストア

4.1.6　OpenTP1ファイル所有者の変更

4.1.7　OpenTP1ファイルグループの変更

4.1.8　OpenTP1ファイルのアクセス許可モードの変更

4.1.9　OpenTP1ファイルシステムのガーベジコレクション

4.1.10　OpenTP1ファイルシステムの属性変更の手順

4.1.11　OpenTP1ファイルの再作成

4.2　ステータスファイルの運用

4.2.1　ステータスファイルの作成と定義

4.2.2　ステータスファイルの使い方

4.2.3　ステータスファイルの状態表示

4.2.4　ステータスファイルの内容表示

4.2.5　ステータスファイルのオープンとクローズ

4.2.6　ステータスファイルの削除

4.2.7　ステータスファイルの容量が不足したとき

4.2.8　ステータスファイルの状態遷移

4.3　システムジャーナルファイルの運用

4.3.1　OpenTP1のジャーナルについて

4.3.2　システムジャーナルファイルの作成と定義

4.3.3　システムジャーナルファイルの使い方

4.3.4　システムジャーナルファイルのアンロード

4.3.5　システムジャーナルファイルの再使用

4.3.6　システムジャーナルファイル情報の表示

4.3.7　システムジャーナルファイルのオープンとクローズ

4.3.8　システムジャーナルファイルのステータス変更

4.3.9　システムジャーナルファイルのスワップ

4.3.10　スワップ先のファイルグループがないとき

4.3.11　システムジャーナルファイルの状態遷移

4.3.12　システム統計情報のジャーナル出力

4.3.13　アンロードジャーナルファイルの時系列ソート，およびマージ

4.3.14　アンロードジャーナルファイルの複写

4.3.15　アンロードジャーナルファイルの編集出力

4.3.16　アンロードジャーナルファイルのレコード出力

4.3.17　稼働統計情報の出力

4.3.18　ファイル回復用ジャーナルの集積

4.3.19　ジャーナルファイルレス機能を使用する運用

4.4　リカバリジャーナルファイルの運用

4.4.1　トランザクションリカバリジャーナルファイルの運用

4.4.2　サーバリカバリジャーナルファイルの運用

4.5　チェックポイントダンプファイルの運用

4.5.1　チェックポイントダンプファイルの作成と定義

4.5.2　チェックポイントダンプファイルの使い方

4.5.3　チェックポイントダンプファイルの削除

4.5.4　チェックポイントダンプファイルの自動オープン

4.5.5　チェックポイントダンプの取得先がないとき

4.5.6　チェックポイントダンプファイル情報の表示

4.5.7　チェックポイントダンプファイルのオープンとクローズ

4.5.8　チェックポイントダンプファイルの二重化

4.5.9　チェックポイントダンプファイルの状態遷移

4.5.10　チェックポイントダンプ取得契機のスキップ回数の監視

4.6　DAMファイルの運用

4.6.1　DAMファイルの作成

4.6.2　DAMファイルの状態管理

4.6.3　DAMファイルの状態表示

4.6.4　DAMファイルの追加と削除

4.6.5　論理ファイルの論理閉塞と閉塞解除

4.6.6　DAMファイルのバックアップとリストア

4.6.7　DAMファイルの回復

4.6.8　DAMファイルの排他

4.6.9　オンライン中にDAMファイルを追加する手順

4.6.10　DAMファイルのキャッシュブロック数の設定

4.6.11　DAMファイルのブロック長の拡張

4.6.12　DAMファイルのユーザデータの抽出

4.7　TAMファイルの運用

4.7.1　TAMファイルの作成

4.7.2　TAMテーブルの状態管理

4.7.3　TAMテーブルの状態表示

4.7.4　TAMテーブルの追加と切り離し

4.7.5　TAMテーブルの論理閉塞と閉塞解除

4.7.6　TAMテーブルのロードとアンロード

4.7.7　TAMファイルのバックアップとリストア

4.7.8　TAMファイルからのTAMデータファイルの作成

4.7.9　TAMファイルの削除

4.7.10　TAMファイルの回復

4.7.11　TAMファイルの排他

4.7.12　オンライン中にTAMファイルを追加する手順

4.7.13　TAMファイル作成後のシノニム情報の表示

4.7.14　TAMファイルのレコード数の拡張

5.　メッセージの送受信の運用

5.1　MCF通信サービスに関する運用

5.2　コネクションに関する運用

5.3　アプリケーションに関する運用

5.4　論理端末に関する運用

5.5　サービスグループに関する運用

5.6　サービスに関する運用

5.7　各プロトコル固有の運用

5.7.1　セションの開始と終了

5.7.2　バッファグループの使用状況表示

5.7.3　マップファイル

5.8　メッセージキューの滞留監視

5.9　キューに関する運用

5.10　MCF構成変更再開始機能に関する運用

5.10.1　MCF構成変更再開始機能使用時の流れ

5.10.2　MCF構成変更再開始機能使用時の準備

5.10.3　MCF構成変更再開始機能使用時のOpenTP1の終了と再開始

5.10.4　MCF構成変更再開始機能使用時の構成変更手順

5.10.5　MCF構成変更再開始機能使用時のメッセージのバックアップとリストア

5.10.6　MCF構成変更再開始機能使用時の障害対策

6.　OpenTP1の付加機能の運用

6.1　リソースマネジャに関する運用

6.1.1　リソースマネジャの情報の表示

6.1.2　リソースマネジャの登録と削除

6.1.3　トランザクション制御用オブジェクトファイルの作成

6.1.4　リソースマネジャモニタの運用

6.1.5　リソースマネジャ起動待ち合わせ機能

6.1.6　トランザクションの回復待ち合わせ（Oracle9i RAC機能使用時）

6.1.7　オンライン前トランザクション回復機能

7.　マルチノード機能使用時の運用

7.1　OpenTP1の環境設定

7.1.1　OpenTP1管理者の登録

7.1.2　OpenTP1グループの設定

7.1.3　OpenTP1のインストール

7.1.4　OpenTP1ディレクトリの作成

7.1.5　システム定義の作成

7.1.6　OpenTP1のOSへの登録

7.1.7　OpenTP1ファイルシステム領域の作成

7.1.8　OpenTP1の内部制御用資源の確保

7.1.9　OpenTP1管理者の環境設定

7.1.10　OpenTP1ファイルシステムの初期設定

7.1.11　OpenTP1ファイルの作成

7.1.12　OpenTP1ファイル以外のファイルの作成

7.2　OpenTP1の開始と終了

7.2.1　開始

7.2.2　終了

7.3　OpenTP1ノードの状態表示

7.4　グローバルジャーナルに関する運用

7.4.1　アーカイブジャーナルファイルの構成，および作成と定義

7.4.2　アーカイブジャーナルファイルの使い方

7.4.3　アーカイブジャーナルファイルのアンロード

7.4.4　アーカイブジャーナルファイルの再使用

7.4.5　アーカイブジャーナルファイル情報の表示

7.4.6　アーカイブ状態の表示

7.4.7　アーカイブジャーナルファイルのオープンとクローズ

7.4.8　アーカイブジャーナルファイルのステータス変更

7.4.9　アーカイブジャーナルファイルのスワップ

7.4.10　スワップ先のファイルグループがないとき

7.4.11　アーカイブジャーナルファイルの状態遷移

7.4.12　グローバルアーカイブアンロードジャーナルファイル，およびアンロードジャーナルファイルの時系列ソート，およびマージ

7.4.13　グローバルアーカイブアンロードジャーナルファイルの編集出力

7.4.14　グローバルアーカイブアンロードジャーナルファイルのレコード出力

7.4.15　稼働統計情報の出力

7.4.16　ファイル回復用ジャーナルの集積

7.4.17　被アーカイブジャーナルノードのシステムジャーナルファイルのアンロード

7.4.18　被アーカイブジャーナルノードのファイル回復

7.4.19　リカバリジャーナルファイルの回復

8.　マルチOpenTP1の運用

8.1　マルチOpenTP1の環境設定

8.1.1　OpenTP1管理者の設定

8.1.2　OpenTP1ディレクトリの作成

8.1.3　OpenTP1のOSへの登録

8.1.4　OpenTP1ファイルシステムの初期設定

8.1.5　ユーザの環境設定

8.1.6　共用ライブラリの変更

8.1.7　OpenTP1ファイルの作成

8.1.8　OpenTP1ファイル以外のファイルの作成

8.2　運用コマンド実行時の環境

9.　系切り替え機能使用時の運用

9.1　系切り替え機能使用時の準備

9.2　開始と終了

9.2.1　開始

9.2.2　終了

9.3　系切り替えの方法

9.3.1　自動系切り替え

9.3.2　計画系切り替え

9.3.3　連動系切り替え

9.4　系切り替え機能使用時のオンラインタイミング

9.5　ユーザサーバの待機

9.6　運用コマンド

第3編　OpenTP1の障害対策

10.　障害対策

10.1　障害発生時の現象と原因

10.2　OpenTP1ファイル障害

10.2.1　ステータスファイル

10.2.2　システムジャーナルファイル

10.2.3　アーカイブジャーナルファイル

10.2.4　リカバリジャーナルファイル

10.2.5　チェックポイントダンプファイル

10.2.6　DAMファイル

10.2.7　TAMファイル

10.2.8　メッセージキューファイル

10.2.9　XARファイル

10.2.10　MCF定義ファイル

10.3　ファイル障害

10.3.1　メッセージログファイル

10.4　通信障害

10.5　UAP障害

10.5.1　UAPを開始できない場合

10.5.2　UAPが終了しない場合

10.5.3　UAPが異常終了する場合

10.5.4　UAPのデッドロックが発生する場合

10.6　OpenTP1障害

10.6.1　OpenTP1を開始できない場合

10.6.2　OpenTP1が停止しない場合

10.6.3　OpenTP1が異常終了した場合

10.6.4　OpenTP1の運用コマンドが正常終了しない場合

10.6.5　OpenTP1の運用コマンドが応答待ちタイムアウトになる場合

10.6.6　マルチノード機能使用時のOpenTP1障害

10.7　CPU障害

10.8　障害時に取得する情報

10.9　全面回復時に引き継がれる情報

11.　トラブル発生時の調査手順

11.1　取得情報と確認事項

11.1.1　取得情報

11.1.2　障害が発生したときに確認する事項

11.1.3　トレースの確認方法

11.2　調査手順

11.2.1　KFCA00307-Eメッセージが出力された場合

11.2.2　KFCA00327-Wメッセージが出力された場合

11.2.3　KFCA00328-Wメッセージが出力された場合

11.2.4　KFCA00502-Iメッセージが出力された場合

11.2.5　KFCA00837-Iメッセージが出力された場合

11.2.6　KFCA00854-Eメッセージが出力された場合

11.2.7　KFCA00906-EまたはKFCA00907-Eメッセージが出力された場合

11.2.8　KFCA01803-Iメッセージが出力された場合

11.2.9　KFCA01820-Eメッセージが出力された場合

11.2.10　KFCA01864-Eメッセージが出力された場合

11.2.11　-902: DCTRNER_ROLLBACKエラーリターンが出力された場合

11.2.12　ユーザサーバが起動しない場合

第4編　OpenTP1の運用コマンド

12.　運用コマンド

12.1　運用コマンドの概要

12.1.1　運用コマンドの入力方法

12.1.2　運用コマンドの記述形式

12.1.3　運用コマンドの使用方法の表示

12.1.4　運用コマンドの一覧

12.1.5　運用コマンド入力時の注意事項

13.　運用コマンドの詳細

damadd

dambkup

damchdef

damchinf

damdel

damfrc

damhold

damload

damls

damrles

damrm

damrstr

dcalzprf

dcauditsetup

dccspool

dcdefchk

dcjchconf

dcjcmdex

dcjnamch

dcmakeup

dcmapchg

dcmapls

dcmstart

dcmstop

dcndls

dcpplist

dcrasget

dcreport

dcreset

dcsetup

dcshmls

dcstart

dcstats

dcstop

dcsvstart

dcsvstop

filbkup

filchgrp

filchmod

filchown

fills

filmkfs

filrstr

filstatfs

jnladdpf

jnlardis

jnlarls

jnlatunl

jnlchgfg

jnlclsfg

jnlcolc

jnlcopy

jnldelpf

jnledit

jnlinit

jnlls

jnlmcst

jnlmkrf

jnlopnfg

jnlrinf

jnlrm

jnlrput

jnlsort

jnlstts

jnlswpfg

jnlunlfg

lckls

lckpool

lckrminf

logcat

logcon

mcfaactap

mcfaclcap

mcfadctap

mcfadltap

mcfalsap

mcfalstap

mcfreport

mcfstats

mcftactcn

mcftactle

mcftactmj

mcftactsg

mcftactss

mcftactsv

mcftchcn

mcftdctcn

mcftdctle

mcftdctmj

mcftdctsg

mcftdctss

mcftdctsv

mcftdlqle

mcftdlqsg

mcftdmpqu

mcftedalt

mcftendct

mcfthldiq

mcfthldoq

mcftlsbuf

mcftlscn

mcftlscom

mcftlsle

mcftlsln

mcftlssg

mcftlssv

mcftlstrd

mcftlsutm

mcftofln

mcftonln

mcftrlsiq

mcftrlsoq

mcftspqle

mcftstalt

mcftstart

mcftstop

mcftstptr

mcftstrtr

mcftswptr

mcfuevt

namalivechk

namblad

namchgfl

namdomainsetup

nammstr

namndchg

namndopt

namndrm

namnlcre

namnldel

namnldsp

namsvinf

namunavl

prcdlpath

prcdlpathls

prckill

prcls

prcpath

prcpathls

prctctrl

prctee

prfed

prfget

queinit

quels

querm

rapdfgen

rapls

rapsetup

rpcdump

rpcmrg

rpcstat

rtsedit

rtsls

rtssetup

rtsstats

scdchprc

scdhold

scdls

scdrles

scdrsprc

stsclose

stsfills

stsinit

stsls

stsopen

stsrm

stsswap

tamadd

tambkup

tamcre

tamdel

tamfrc

tamhold

tamhsls

tamlckls

tamload

tamls

tamrles

tamrm

tamrstr

tamunload

tptrnls

trncmt

trndlinf

trnfgt

trnlnkrm

trnls

trnlsrm

trnmkobj

trnrbk

trnstics

usmdump

xarevtr

xarfills

xarforce

xarhold

xarinit

xarls

xarrles

xarrm

付録

付録A　入出力キューのダンプファイルの形式

付録B　OpenTP1のイベント

付録B.1　イベント登録の方法

付録B.2　登録できるOpenTP1のイベント

付録C　監査イベントの出力情報

付録D　メッセージ制御機能で取得するジャーナル情報

付録D.1　AJレコード形式

付録D.2　GJレコード形式

付録D.3　IJレコード形式

付録D.4　MJレコード形式

付録D.5　OJレコード形式

付録D.6　メッセージ制御機能のジャーナル取得条件

付録D.7　メッセージ制御機能が取得するジャーナルの必要量の計算式

付録E　統計情報の詳細

付録E.1　システム統計情報

付録E.2　トランザクション統計情報

付録E.3　レスポンス統計情報

付録E.4　通信遅延時間統計情報

付録E.5　リアルタイム統計情報

付録F　OpenTP1が出力するファイル一覧

付録G　メッセージキュー用物理ファイルの見積もり式

付録G.1　レコード長の見積もり式

付録G.2　レコード数の見積もり式

付録G.3　見積もり例

付録H　OpenTP1ファイルの見積もり式

付録H.1　ステータスファイルのサイズの見積もり式

付録H.2　システムジャーナルファイルのサイズの見積もり式

付録H.3　チェックポイントダンプファイルのサイズの見積もり式

付録H.4　アーカイブジャーナルファイルのサイズの見積もり式

付録H.5　DAMファイルのサイズの見積もり式

付録H.6　TAMファイルのサイズの見積もり式

付録I　レコードロック数の見積もり式

付録J　UNIXのメッセージ送受信関数で使用する資源の見積もり式

付録K　OpenTP1ファイルシステムの見積もり式

付録L　性能検証用トレース情報の取得・解析

付録L.1　性能検証用トレースの取得情報

付録L.2　性能検証用トレース情報の取得例

付録L.3　性能検証用トレース情報の解析例

付録M　シナリオテンプレートの詳細

付録M.1　OpenTP1_AddNode

付録M.2　OpenTP1_ChangeNodeID

付録M.3　OpenTP1_Deploy

付録M.4　OpenTP1_ScenarioAddNode

付録M.5　OpenTP1_Start

付録M.6　OpenTP1_StartUAP

付録M.7　OpenTP1_Stop

付録M.8　OpenTP1_StopUAP

付録M.9　OpenTP1_Undeploy

付録M.10　OpenTP1_UpdateDomain

付録M.11　OpenTP1_ScenarioScaleout

索引

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

All Rights Reserved. Copyright (C) 2006, 2012, Hitachi, Ltd.

前書き

■ 対象製品

マニュアル「OpenTP1 解説」を参照してください。

■ 輸出時の注意

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

■ 商標類

AIXは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
BSDは，米国Berkeley Software Design, Inc.の商品名称です。
HP-UXは，Hewlett-Packard Development Company, L.P.のオペレーティングシステムの名称です。
Linuxは，Linus Torvalds氏の日本およびその他の国における登録商標または商標です。
OracleとJavaは，Oracle Corporation 及びその子会社，関連会社の米国及びその他の国における登録商標です。
OSFは，Open Software Foundation, Inc.の商標です。
Red Hatは，米国およびその他の国でRed Hat, Inc. の登録商標もしくは商標です。
UNIXは，The Open Groupの米国ならびに他の国における登録商標です。
Windowsは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
X/Openは，The Open Groupの英国ならびに他の国における登録商標です。
XATMIは，X/Open Company Limitedが開発したアプリケーションインタフェースの名称です。
その他記載の会社名，製品名は，それぞれの会社の商標もしくは登録商標です。
プログラムプロダクト「P-9D64-3F31，P-9D64-8531，P-9D64-8931，R-19451-216，R-19452-216，R-19453-216，R-19454-216，R-19455-216，R-19456-216，R-19459-216，R-1945A-216，R-1945C-216，R-1945D-216，R-1945E-216，R-F19456-2156，R-F19456-21C6」には，Oracle Corporationまたはその子会社，関連会社が著作権を有している部分が含まれています。
プログラムプロダクト「P-9D64-3F31，P-9D64-8531，P-9D64-8931，R-19451-216，R-19452-216，R-19453-216，R-19454-216，R-19455-216，R-19456-216，R-19459-216，R-1945A-216，R-1945C-216，R-1945D-216，R-1945E-216，R-F19456-2156，R-F19456-21C6」には，UNIX System Laboratories, Inc.が著作権を有している部分が含まれています。

本書には，X/Openの許諾に基づき X/Open CAE Specification System Interfaces and Headers，Issue4，（C202 ISBN 1-872630-47-2）Copyright (C) July 1992，X/Open Company Limitedの内容が含まれています；
なお，その一部は IEEE Std 1003.1-1990，(C) 1990 Institute of Electrical and Electronics Engineers, Inc.及び IEEE std 1003.2/D12，(C) 1992 Institute of Electrical and Electronics Engineers, Inc.を基にしています。
事前に著作権所有者の許諾を得ずに，本書の該当部分を複製，複写及び転記することは禁じられています。

本書には，X/Openの許諾に基づき X/Open Preliminary Specification Distributed Transaction Processing : The TxRPC Specification（P305 ISBN 1-85912-000-8）Copyright (C) July 1993，X/Open Company Limitedの内容が含まれています；
事前に著作権所有者の許諾を得ずに，本書の該当部分を複製，複写及び転記することは禁じられています。

本書には，Open Software Foundation, Inc.が著作権を有する内容が含まれています。
This document and the software described herein are furnished under a license, and may be used and copied only in accordance with the terms of such license and with the inclusion of the above copyright notice. Title to and ownership of the document and software remain with OSF or its licensors.

■ 発行

2012年11月 3000-3-D53-50

■ 著作権

All Rights Reserved. Copyright (C) 2006, 2012, Hitachi, Ltd.

変更内容

変更内容（3000-3-D53-50） uCosminexus TP1/Server Base 07-06，uCosminexus TP1/Server Base(64) 07-06

追加・変更内容
変更個所

DCUAPCONFPATH環境変数にユーザサービスデフォルト定義ファイルが設定できる説明を追加した。
1.3.1，1.3.2，3.17.3，3.17.5，7.1.9，8.1.5，11.1.1，

13.　運用コマンドの詳細

dcdefchk

hostnameコマンドが返す名称をIPアドレスとマッピングできる環境設定が必要である説明を追加した。
1.3.2

ノード構成の変更（ノードの追加や削除）に自動的に対応できるようにした（ノード自動追加機能）。
これに伴い，次のコマンドを追加した。

nammstr

namndopt

namndrm

namnlcre

namnldel

namnldsp

namsvinfコマンドに-xオプションを追加した。
次のコマンドの説明を変更した。

namalivechk

namblad

namchgfl

namndchg

namsvinf

namunavl

namdオンラインチェックファイルを追加した。
また，性能検証用トレース情報に，次のイベントIDを追加した。

0xf030～0xf035

0xf10c～0xf10f

0xf110～0xf114

0xf219

0xf21a～0xf21f

0xf220

1.3.5，3.11，10.9，12.1.4，

13.　運用コマンドの詳細

namalivechk，

namblad，

namchgfl，

nammstr，

namndchg，

namndopt，

namndrm，

namnlcre，

namnldel，

namnldsp，

namsvinf，

namunavl，

付録F(1)，付録L.1(1)

性能検証用トレースの情報をCSV形式で出力し，トレース解析できるようにした。
これに伴い，dcalzprfコマンドを追加した。
また，性能検証用トレース情報の取得例および活用例を追加した。
3.8.5，10.8，12.1.4，

13.運用コマンドの詳細

dcalzprf，

付録L.2，付録L.3

$DCDIR/spool/save配下のトラブルシュート情報ファイルについて，説明を追加した。
3.14.1

系切り替え機能使用時の動作について説明を追加した。
9.4，

13.　運用コマンドの詳細

dcstart

運用コマンド入力時の注意事項を追加した。
12.1.5

保守資料の取得先ディレクトリにprc_current_work_pathオペランドおよびprc_coresave_pathオペランドで指定するディレクトリを追加した。

13.　運用コマンドの詳細

dcrasget

定義変更をシステムに反映するためdcresetコマンドの実行が必要であることを次の定義の説明に追加した。

システム環境定義

プロセスサービス定義

13.　運用コマンドの詳細

dcreset

未起動のホストが，システム共通定義のall_nodeオペランドに含まれていた場合，OpenTP1の起動に時間がかかる注意事項を追加した。

13.　運用コマンドの詳細

dcstart

次のコマンドの注意事項を追加した。

dcstop

jnlchgfg

jnlls

jnlunlfg

13.　運用コマンドの詳細

dcstop，

jnlchgfg，

jnlls，

jnlunlfg

ユーザサーバごとに，共有化したバッファの使用サイズを制限できるようにした。
これに伴い，scdlsコマンドの出力形式を変更した。

13.　運用コマンドの詳細

scdls

新しいプロセスの起動タイミングについて，説明を追加した。

13.　運用コマンドの詳細

scdrsprc

被アーカイブジャーナルノードの不正ジャーナル情報ファイルの最大ファイル数を1に変更した。
付録F(1) 表F-2

uCosminexus TP1/Server Base 07-05，uCosminexus TP1/Server Base(64) 07-05，uCosminexus TP1/Message Control 07-05，uCosminexus TP1/Message Control(64) 07-05

追加・変更内容
変更個所

65535を超えるユーザIDには対応していない旨を追加した。
1.2.1

退避コアファイルのディレクトリについて，プロセスサービス定義のprc_coresave_pathオペランドを指定している場合の退避ディレクトリを追加した。
1.3.6(3)(b)，3.14.1，7.1.12(3)，10.8

/tmp/betran.logファイルの世代管理方式を変更した。
3.5

監査ログの出力項目を変更した。
3.7.4(2) 表3-12

一つのリソースマネジャを複数の制御単位に分け，接続するユーザ名称などを変更してリソースマネジャに接続できるようにした（リソースマネジャ接続先選択機能）。
これに伴い，エラーログ情報のファイル名またはディレクトリの情報，およびサイズの説明を変更した。
また，性能検証用トレース情報のイベントIDに0x4018を追加した。
11.1.1 表11-1，付録F(1)，付録L.1

prcteeコマンド実行方法について，注意事項を追加した。
12.1.4 表12-1，

13.　運用コマンドの詳細

prctee

Red Hat Enterprise Linux Server 6以降で使用する場合の注意事項を追加した。

13.　運用コマンドの詳細

dcsetup

filmkfsコマンドの-sオプションに最大セクタ長に関する説明を追加した。

13.　運用コマンドの詳細

filmkfs

ジャーナルの編集対象について説明を追加した。

13.　運用コマンドの詳細

jnledit

出力形式SYNC（同期型メッセージ）およびIO（非同期型問い合わせ応答メッセージ）について，一時的にメッセージが増加する場合があることを追加した。

13.　運用コマンドの詳細

mcftlsle

追加パス名は絶対パス指定であることを追加した。

13.　運用コマンドの詳細

prcdlpath

追加パス名の有効範囲について説明を追加した。

13.　運用コマンドの詳細

prcdlpath

変更パス名は絶対パス指定であることを追加した。

13.　運用コマンドの詳細

prcpath

出力メッセージ「KFCA00751-E」を追加した。

13.　運用コマンドの詳細

prcdlpath，

prcdlpathls

prcteeプロセスが出力するOpenTP1の標準出力，および標準エラー出力のファイル出力先を変更できることを追加した。

13.　運用コマンドの詳細

prctctrl

次の場合の注意事項を追加した。

dcsetupコマンドまたはprctctrlコマンドを実行する場合

prcountファイルを修正する場合

コマンド引数のファイル長と出力ファイル名を省略する場合

13.　運用コマンドの詳細

prctee

ジャーナルのレコードサイズの注意事項を追加した。
付録D

ジャーナル取得条件の種別CJを追加した。
付録D.6，付録D.7

種別がGJ，IJ，MJ，OJ，CJ（メッセージ入力時，同起点取得時，メッセージ出力時）の計算式について，32ビット版の場合と，64ビット版の場合とで分けた。
付録D.7

TP1/Server Base（UNIX版・Windows版共通）が出力するファイルに，OpenTP1デバッグ情報ファイル2を追加した。
付録F(1)

TP1/Server Base（UNIX版固有）が出力するファイルに，次のファイルを追加した。

dcsetup用バックアップファイル2

OpenTP1制御ファイル1

OpenTP1制御ファイル2

また次のファイルを削除した。

モジュールトレースデータファイルのバックアップファイル

モジュールトレースデータファイル

付録F(2)

Red Hat Enterprise Linux Server 6以降で実行する場合の注釈を追加した。
付録F(2)

性能検証用トレース情報に，次のイベントIDを追加した。

0x5200

0x5201

付録L.1(1) 表L-1

次に示すイベントIDのトレースデータ長を変更した。

0x1000～0x1001

0x1003

0x1005

0x1007～0x1009

0x2000～0x2001

0x2003～0x2005

0x4000

0x4002

0x4004

0x4006

0x4008

0x400a

0x400c

0x400e

0x4010

0x4012

0x4014

0x4016

0x5001～0x5008

0x6400～0x6401

0x6420～0x6421

0x6430～0x6431

0xd000

0xd002

0xf008

0xf100～0xf101

付録L.1(1) 表L-1

uCosminexus TP1/Server Base 07-02，uCosminexus TP1/Message Control 07-01

追加・変更内容
変更個所

前回のオンライン停止時に残っていた未処理受信メッセージや未送信メッセージを引き継ぎ，TP1/Message Controlの構成を変更できるようにした（MCF構成変更再開始機能）。
これに伴い，次の終了モードを追加した。

MCF構成変更準備停止

また，これに伴い次のコマンドを変更した。

dcstartコマンドに-bオプションを追加した。

dcstopコマンドに-qオプションを追加した。

2.1.4，2.2.1(5)，2.2.1(7) 表2-2，2.2.2，5.10，10.6.3(5)，

13.　運用コマンドの詳細

dcstart，

dcstop，

付録D.6，付録H.1

uCosminexus TP1/Message Control 07-00，uCosminexus TP1/Message Control(64) 07-00

追加・変更内容
変更個所

リモートMCFサービスに関する記述を削除した。
3.10.1(2)，4.4.2(1)，

13.　運用コマンドの詳細

mcftstart，

mcftstop，

付録H

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

変更内容（3000-3-D53-40） uCosminexus TP1/Server Base 07-04，uCosminexus TP1/Server Base(64) 07-04，uCosminexus TP1/Message Control 07-05，uCosminexus TP1/Message Control(64) 07-05，uCosminexus TP1/NET/Library 07-05，uCosminexus TP1/NET/Library(64) 07-05

追加・変更内容

アクセス権限についての説明を追加した。

MCFダンプファイルの説明を変更した。

サービス関数動的ローディング機能で使用する，UAP共用ライブラリのサーチパスをオンライン中に変更できるようにした。
これに伴い，次のコマンドを追加した。

prcdlpath

prcdlpathls

また，OpenTP1が出力するファイル一覧に，次のファイルを追加した。

prcdlpathコマンドの引き継ぎファイル

チェックポイントダンプ取得契機のスキップ回数を監視できるようにした。

OpenTP1の起動コマンドがリターンした直後にMCFの運用コマンドを実行する場合，mcftlscomコマンドでMCF通信サービスの開始を待ち合わせられるようにした。
これに伴い，mcftlscomコマンドに次のオプションを追加した。

-w

-t

mcftlsleコマンドで，最大未送信メッセージ数を表示できるようにした。
これに伴い，mcftlsleコマンドに次のオプションを追加した。

-m

-r

mcftlsbufコマンドで，最大バッファ使用数を表示できるようにした。
これに伴い，mcftlsbufコマンドに次のオプションを追加した。

-m

-r

次のコマンドの一括処理ブロック数に関する説明を変更した。

dambkup

damload

damrstr

出力形式中の静的共用メモリブロック使用サービス種別の詳細を追加した。

dcstop -f入力時の注意事項を追加した。

不要な出力メッセージを削除した。

出力メッセージを追加した。

注意事項に，UJ以外のジャーナルファイルをレコードまたはブロック単位に編集した場合の説明を追加した。

出力形式中のファイル名称が59文字以内である旨を追加した。

次のコマンドを，トランザクション第2状態が「u」以外であれば受け付けられるようにした。

trncmt

trnfgt

trnrbk

これに伴い，これらのコマンドに-qオプションを追加した。

OpenTP1が出力するファイル一覧に，次のファイルを追加した。

prcpathコマンドの引き継ぎファイル

OpenTP1デバッグ情報ファイルのファイル名またはディレクトリ名の説明を，UNIX版とWindows版とで分けた。

damd生存確認ファイルのサイズの説明を，32ビット版の場合と64ビット版の場合とで分けた。

変更内容（3000-3-D53-30） uCosminexus TP1/Server Base 07-03，uCosminexus TP1/Server Base(64) 07-03，uCosminexus TP1/Message Control 07-03，uCosminexus TP1/Message Control(64) 07-03，uCosminexus TP1/NET/Library 07-04，uCosminexus TP1/NET/Library(64) 07-04

追加・変更内容

OpenTP1ファイルへのアクセス要求で，イベントトレース（FILイベントトレース）を出力できるようにした。
これに伴い，FILイベントトレース情報ファイルを追加した。また，prfgetコマンドの-fオプションに_flを追加した。

ジャーナルサービスで性能検証用トレース（JNL性能検証用トレース）を出力できるようにした。
これに伴い，JNL性能検証用トレース情報ファイルを追加した。また，prfgetコマンドの-fオプションに_jlを追加した。

ロックサービスを使用した排他制御の各種イベントの性能検証用トレース（LCK性能検証用トレース）を出力できるようにした。
これに伴い，prfedコマンドの-dオプションを指定した場合にLCK性能検証用トレース情報ファイルを出力できるようにした。
また，prfgetコマンドの-fオプションに_lkを追加した。

プロセスをアボートしなくてもUAPトレース（UAPトレースデータファイル）を取得できるようにした。
これに伴い，次のファイルを取得できるようにした。

UAPトレースデータファイル

UAPトレースデータファイルのバックアップファイル

監査イベントに「OpenTP1サービス開始」，および「OpenTP1サービス停止」を追加した。

特定のノードのサービス情報を優先的に使用する機能（サービス情報優先度指定機能）を追加した。
これに伴い，優先選択ノードの定義ファイルの説明を追加した。
また，次のコマンドの出力形式の説明を変更した。

namsvinf

リモートAPI機能を使用する場合の注意を追加した。

リアルタイム統計情報サービスの拡張機能（RTSSPP）が開始している場合にリアルタイム統計情報サービスを終了させるときの対処についての説明を追加した。

OpenTP1ファイルシステムのユーザ領域情報として使用中領域と未使用領域（空き領域）の一覧を表示できるようにした。
これに伴い，次のオプションを追加した。

filstatfsコマンドの-Sオプション

ジャーナルファイルレスモードで使用できない機能として，次のコマンドを追加した。

jnlmkrf

MCF通信サービスの状態表示について，説明を追加した。

アプリケーションに関するタイマ起動要求の状態を表示できるようにした。
これに伴い，次のコマンドを追加した。

mcfalstap

縮退運転の原因と，復旧手順についての説明を追加した。

ユーザタイマ監視の状態を表示できるようにした。
これに伴い，次のコマンドを追加した。

mcftlsutm

OpenTP1の標準出力，標準エラー出力をリダイレクトするprcteeプロセスを停止・再開始できるようにした。
これに伴い，次のコマンドを追加した。

prctctrl

次のコマンドを実行するための条件を変更した。

damrstr

tamrstr

システム環境定義のmode_confオペランドにAUTOを指定している場合の注意事項を追加した。

dcsetupコマンドの-dオプションに，-yオプションまたは-nオプションを省略した場合の説明を追加した。

dcshmlsコマンドの実行結果として得られる，OSに確保要求した共用メモリプールの大きさの算出式を追加した。

OSの時刻補正機能などによる時刻戻しが発生した場合について注意事項を追加した。

コマンドのメモリ所要量の見積もり式を追加した。

出力先ファイル名を指定する場合の文字数制限をなくした。

mcftlsleコマンドの出力形式で，未送信メッセージ数の表示可能数を変更した。

トレース情報ファイルの編集結果をcsv形式で出力できるようにした。
これに伴い，次のオプションを追加した。

prfedコマンドの-vオプション

stslsコマンドの実行結果として得られる物理ファイル状態について，説明を追加した。

監査イベント（OpenTP1ファイルシステムに対するアクセスエラー）について，出力内容の説明を追加した。

UNIXのメッセージ送受信関数で使用する資源の見積もり式で，次の見積もり式を変更した。

メッセージIDの数

メッセージID当たりの最大待ち合わせメッセージの総バイト数

OpenTP1のすべてのメッセージのうちの最大待ち合わせメッセージ数

次に示すイベントIDのトレースデータ長を変更した。

0xf000～0xf104

0xf106～0xf204

0xf206～0xf218

uCosminexus TP1/Message Control 07-02，uCosminexus TP1/NET/Library 07-03

追加・変更内容

キューを監視している場合，および相手システムからの応答メッセージ受信を待ち合わせしている場合に，監視処理中および処理完了時にログメッセージを出力することで，処理状況を把握できるようにした。

MHPでサービス関数動的ローディング機能を使用できるようにした。

次の操作を，ライブラリ関数でできるようにした。

コネクションの状態表示，確立，および解放

サーバ型コネクションの確立要求の状態表示，および受付開始・終了

アプリケーションに関するタイマ起動要求の削除

論理端末の状態表示，閉塞，閉塞解除，および出力キューの削除

MCF通信サービスの状態取得

相手システムとのメッセージ送受信に関するネットワークの状態を表示できるようにした。
これに伴い，次のコマンドを追加した。

mcftlsln

最大未処理受信メッセージ数を表示できるようにした。
これに伴い，次のオプションを追加した。

mcftlssgコマンドの-mオプション

また，最大未処理受信メッセージに関する注意事項を追加した。

uCosminexus TP1/Message Control 07-01，uCosminexus TP1/NET/Library 07-01

追加・変更内容

メッセージ送受信での主なイベントで，性能検証用トレース（MCF性能検証用トレース）を出力できるようにした。
これに伴い，MCF性能検証用トレース情報ファイルを追加した。また，prfgetコマンドの-fオプションに_mcを追加した。

サーバ型コネクションの確立要求の受付開始・終了を，手動でできるようにした。
これに伴い，次のコマンドを追加した。

mcftofln

mcftonln

リアルタイム統計情報の取得項目として，MCFの情報も取得できるようにした。
これに伴い，次のコマンドのオプションの組み合わせについて説明を追加した。

rtsedit

rtsls

rtsstats

変更内容（3000-3-D53-20） uCosminexus TP1/Server Base 07-02，uCosminexus TP1/Message Control 07-01，uCosminexus TP1/NET/Library 07-01

追加・変更内容

OpenTP1管理者の登録に関する注意事項を追加した。

プロセスサービスでイベントトレースを出力できるようにした。
これに伴い，プロセスサービスイベントトレース情報ファイルを追加した。また，prfgetコマンドの-fオプションに_prを追加した。

PRFトレースファイルのバックアップ抑止機能を追加した。
これに伴い，性能検証用トレースファイルの運用方法，および性能検証用トレースファイルのバックアップファイルを追加した。

XAリソースサービスで性能検証用トレース（prfトレース）を出力できるようにした。
これに伴い，XAR性能検証用トレース情報ファイルを追加した。

ネームサービスでイベントトレースを出力できるようにした。
これに伴い，NAMイベントトレースを追加した。また，prfgetコマンドの-fオプションに_nmを追加した。

Linuxで，次のコマンドを実行したときに出力されるファイルの拡張子を.gzに変更した。

dcrasget -c

usmdump

サービス関数を動的にローディングできる機能を追加した。
これに伴い，ユーザサーバプロセスのリフレッシュ機能の説明を変更した。また，次の項目の注意事項を追加した。

rtsstatsコマンド

リアルタイム統計情報の取得

リアルタイム統計情報の取得情報の設定変更

監査ログを出力する機能を追加した。
これに伴い，監査ログの運用方法を追加した。また，dcauditsetupコマンドを追加した。

リモートAPI機能に関する説明を変更した。

OpenTP1で使用するディスク量の扱いに関する説明で，次のディレクトリを追加した。

「$DCDIR/spool/dcjnlinf/unload/*」

時刻変更に関する説明を変更した。

システムジャーナルファイルを使用しないでシステムを運用する機能（ジャーナルファイルレス機能）を追加した。
これに伴い，次の内容を追加した。

ジャーナルファイルレス機能を使用する場合のシステムの運用方法

運用コマンドの出力メッセージ

dcsetupコマンドの-jオプション

リアルタイム統計情報サービスで，RTSログファイルをバックアップする機能を追加した。
これに伴い，RTSログファイルの作成についての説明を変更した。

システムジャーナルファイルの並列アクセス機能を追加した。
これに伴い，システムジャーナルファイルの使い方についての説明を変更した。

アンロードチェックの抑止に関する説明を変更した。

入力キューに滞留するメッセージキューを監視する機能を追加した。
これに伴い，メッセージキューの滞留監視機能の概要および処理の流れを追加した。

次に示すコマンドの，コマンドログの出力可否を変更した。

trnstics

trndlinf

lckrminf

damadd

damrm

damhold

damrles

damchdef

tamadd

tamrm

tamhold

tamrles

tamload

tamunload

prfget

rtsstats

filmkfsコマンドの注意事項を変更した。

mcftswptrコマンドの出力メッセージとして，KFCA10266-Wを追加した。

namchgflコマンド，またはnamndchgコマンドを実行してノード数を変更する場合の注意事項を追加した。

XAリソースサービスで性能検証用トレース（prfトレース）を出力できるようにした。
これに伴い，XAR性能検証用トレース情報ファイルを追加した。また，prfgetコマンドの-fオプションに_xrを追加した。

複数のRPCトレースファイルにまたがって電文が出力されている場合，rpcmrgコマンドが何も出力しない，または出力情報に抜けが発生する説明を追加した。

rtseditコマンドおよびrtslsコマンドを実行した場合に，「----」が表示されたときの説明を追加した。

コマンドの対象外のサーバについて説明を追加した。

スケジュールサービスの動作をサービス単位で指定できるようになった。
これに伴い，サービス単位の情報を取得するために，scdlsコマンドに次のオプションを追加した。

-aeオプション

-eオプション

-tオプション

次に示す二つの説明を追加した。

出力形式の，トランザクション情報が表示された場合に，「初期状態」を追加した。

注意事項に，""***""が表示された場合の説明を追加した。

構造体dc_mcf_dump_infoの形式のlong型をint型に変更した。

リアルタイム統計情報サービスで取得できる項目を追加した。

はじめに

このマニュアルは，分散トランザクション処理機能 OpenTP1の運用方法と操作方法について説明したものです。

本文中に記載されている製品のうち，このマニュアルの対象製品ではない製品については，OpenTP1 Version 7対応製品の発行時期をご確認ください。

＜はじめにの構成＞

対象読者

文法の記号

その他の前提条件

対象読者

システム管理者，システム設計者の方々を対象としています。

このマニュアルは，マニュアル「OpenTP1 解説」を前提としていますので，あらかじめお読みいただくことをお勧めします。

文法の記号

(1)文法記述記号

文法の記述を説明する記号です。

文法記述記号
意味

｛　　｝
波括弧
この記号で囲まれている複数の項目のうちから一つを選択できることを示します。

（例）filcopy　〔-｛c｜r｜f｝〕

-c，-r，-fの三つのオプションのうち，どれか一つを指定することを示します。

〔　　〕
きっ甲
この記号で囲まれている項目は省略できることを示します。

（例）dcstart 〔-n〕

dcstartと指定するか，またはdcstart -nと指定することを示します。

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

（例）jnlls -j　sys｜cpd

-jオプションにsysかcpdのどちらかを指定できることを示します。

＿
下線
この記号で示す項目は，該当オプションまたはコマンド引数を省略した場合の仮定値を示します。

（例）filcopy 〔-｛c｜r｜f｝〕

オプションの指定を省略した場合，-cオプションを仮定することを示します。

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

（例）dcsvstart -u　ユーザサーバ名〔，ユーザサーバ名〕…

-uオプションのユーザサーバ名を繰り返し指定できることを示します。

△
白三角
半角スペースを示します。

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

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

(2)属性表示記号

ユーザ指定値の範囲などを説明する記号です。

属性表示記号 | 意味
～ | この記号のあとにユーザ指定値の属性を示します。
《　　》 | ユーザ指定値の省略値を示します。
〈　　〉 | ユーザ指定値の構文要素記号を示します。
((　　)) | ユーザ指定値の指定範囲を示します。

(3)構文要素記号

ユーザ指定値の内容を説明する記号です。

構文要素記号
意味

英字
アルファベット（A～Z，a～z），および＿（アンダスコア）の文字

英字記号
アルファベット（A～Z，a～z），＃，＠，および￥

英数字
英字と数字（0～9）

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

特殊文字
＊

符号なし整数
数字（0～9）

16進数
数字（0～9），A～F，およびa～f
（ただし，数字（0～9），a～fと記述している場合は，A～Fは含まない16進数）

識別子
先頭がアルファベット（A～Z，a～z）で始まる英数字列

記号名称
先頭が英字記号で始まる英数字記号列

文字列
任意の文字の配列

パス名
記号名称，／，および　．（ピリオド）
（ただし，パス名は使用するOSに依存）

OpenTP1ファイル名
アルファベット（A～Z，a～z），数字（0～9），　．（ピリオド），＿（アンダスコア），および＠で構成される文字列（最大14文字）

その他の前提条件

このマニュアルをお読みになる際のその他の前提情報については，マニュアル「OpenTP1 解説」を参照してください。

1.　環境設定

OpenTP1の環境設定とその手順を説明します。

＜この章の構成＞

1.1　概要

1.2　スーパユーザによる環境設定

1.3　OpenTP1管理者による環境設定

1.4　TP1/Message Control実行のための準備

1.1　概要

ここでは，OpenTP1開始直前までの環境設定手順を説明します。OpenTP1の環境設定は，OSの管理者であるスーパユーザの作業から始まります。その後，スーパユーザが登録したOpenTP1管理者が，OpenTP1の環境設定を引き継ぎます。

次に示すOpenTP1の機能を使う場合には，通常の環境設定手順に加えて，各製品をご使用になる場合の専用の手順が必要になります。

TP1/Message Control

TP1/Messaging

TP1/Message Queue

TP1/NET/OSI-TP-Extended

＜この節の構成＞

1.1.1　環境設定手順の概要

1.1.1　環境設定手順の概要

OpenTP1の環境設定手順について図で説明します。

＜この項の構成＞

(1)　OpenTP1の環境設定手順

(2)　TP1/Message Controlを使用する場合

(3)　TP1/Messagingを使用する場合

(4)　TP1/Message Queueを使用する場合

(5)　TP1/NET/OSI-TP-Extendedを使用する場合

(1)　OpenTP1の環境設定手順

OpenTP1の環境設定手順を次の図に示します。

図1-1　OpenTP1の環境設定手順

JP1/Base，JP1/AJS，およびJP1/AJS2 - Scenario Operationと連携して，スケールアウトのシナリオテンプレートを利用すると，OpenTP1の環境設定手順の一部を自動化できます。シナリオテンプレートを利用した環境設定については，「3.16.3(3)　スケールアウトとDPMを利用するOpenTP1の環境設定手順」を参照してください。

(2)　TP1/Message Controlを使用する場合

TP1/Message Controlを使用する場合の環境設定の手順を次の図に示します。

図1-2　TP1/Message Controlを使用する場合の環境設定の手順

(3)　TP1/Messagingを使用する場合

TP1/Messagingを使用する場合の環境設定の手順については，マニュアル「TP1/Messaging 使用の手引」を参照してください。

(4)　TP1/Message Queueを使用する場合

TP1/Message Queueを使用する場合の環境設定の手順を次の図に示します。

図1-3　TP1/Message Queueを使用する場合の環境設定の手順

(5)　TP1/NET/OSI-TP-Extendedを使用する場合

TP1/NET/OSI-TP-Extendedを使用する場合の環境設定の手順を次の図に示します。

図1-4　TP1/NET/OSI-TP-Extendedを使用する場合の環境設定の手順

1.2　スーパユーザによる環境設定

OpenTP1を実行するためにスーパユーザが実施する環境設定について説明します。OpenTP1の運用コマンドの詳細は，「13.　運用コマンドの詳細」を参照してください。

OSに依存する部分は，ユーザが使用するOSのマニュアルを参照してください。

＜この節の構成＞

1.2.1　OpenTP1管理者の登録

1.2.2　OpenTP1グループの設定

1.2.3　OpenTP1のインストール

1.2.4　OpenTP1ディレクトリの作成

1.2.5　OpenTP1のOSへの登録と削除

1.2.6　OpenTP1ファイルシステム領域の作成

1.2.7　ドメイン通信の環境設定

1.2.8　システム共通定義の変更

1.2.1　OpenTP1管理者の登録

OpenTP1をインストールする前にOpenTP1管理者のユーザIDをOSに登録します。

ユーザIDには必ずパスワードを設定しておいてください。なお，OpenTP1システムは65535を超えるユーザIDには対応していません。

ログイン名称：任意

ユーザID：任意

グループID：任意

ホームディレクトリ：任意

ログインシェル：任意

OpenTP1管理者には，次の権限が与えられます。

OpenTP1の各種システムファイルやディレクトリの所有者としてのアクセス権が与えられます。これによって，ほかのユーザからの書き込みを禁止できます。

OpenTP1の構成変更を伴うような運用コマンドを実行できます。

ユーザIDの登録後，必ずパスワードを設定してください。

1.2.2　OpenTP1グループの設定

OpenTP1専用のグループを設定してください。

OpenTP1グループを設定すると，グループ以外のユーザによるファイルのアクセスを制限できるので，OpenTP1の機密保護を強化できます。

1.2.3　OpenTP1のインストール

OpenTP1のプログラムプロダクトをインストールします。OpenTP1インストールディレクトリは，ご使用のOSによって異なります。

1.2.4　OpenTP1ディレクトリの作成

OpenTP1ディレクトリを作成します。OpenTP1ディレクトリ名長は，ご使用のOSによって異なります。

OpenTP1ディレクトリにシンボリックリンクは使用できません。

OpenTP1ディレクトリだけで一つのパーティションを割り当ててください。そのパーティションは，ほかのプログラムで使用しないでください。ほかのプログラムがOpenTP1ディレクトリのパーティションにファイルを作成して，ディスク容量およびiノード数を圧迫した場合，OpenTP1の動作に支障が出ることがあります。

所有者，グループおよびモードを次のように指定します。

所有者：OpenTP1管理者

グループ：OpenTP1グループ

モード：0755

1.2.5　OpenTP1のOSへの登録と削除

OpenTP1のOSへの登録と削除の方法について説明します。

＜この項の構成＞

(1)　OpenTP1のOSへの登録

(2)　OpenTP1のOSからの削除

(1)　OpenTP1のOSへの登録

OpenTP1管理者がOpenTP1のシステム定義情報を作成したあと，スーパユーザは，OpenTP1のdcsetupコマンドを使用して，OpenTP1をOSへ登録します。

dcsetupコマンドに指定したOpenTP1ホームディレクトリにOpenTP1の実行に必要なディレクトリやファイルが存在しない場合は，OSへの登録とともに，実行に必要なディレクトリの作成，ファイルのコピー，およびリソースマネジャの追加を行います。したがって，一度環境を作成したディレクトリに対してdcsetupコマンドを実行するとOSへの登録だけを行います。

マルチOpenTP1を使用しない場合，OpenTP1ホームディレクトリに/BeTRANを指定してください。これによって，初めてOpenTP1をOSへ登録するときにファイルのコピーを省略できます。/BeTRANのオーナーおよびグループは，プログラムのインストール時にrootのIDに変更されます。インストール後にdcsetupコマンドを実行する場合は，/BeTRANのオーナーとグループをOpenTP1管理者のIDに変更してください。

マルチOpenTP1を使用する場合，新たにOpenTP1用のディレクトリを作成し，ディレクトリのオーナーとグループをOpenTP1管理者のIDに変更して，dcsetupの引数に指定してください。マルチOpenTP1を使用するときは，ルートパーティションを圧迫しないようルートパーティション以外のディレクトリを指定してください。

OpenTP1をOSに登録する際には次の点に注意してください。

OpenTP1のホームディレクトリとして指定するディレクトリとして，リモートファイルシステム上のディレクトリ，またはシンボリックリンクしたディレクトリは指定しないでください。指定した場合の動作は保証できません。

dcsetupコマンドで指定するOpenTP1ホームディレクトリは必ず，OpenTP1用に作成したディレクトリか，または/BeTRANというディレクトリを指定してください。それ以外のディレクトリを指定した場合は環境が破壊されます。

dcsetupコマンドを実行することで，OpenTP1ホームディレクトリに存在するディレクトリ（aplib，bin，conf，etc，examples，include，lib，spool，tmp），およびそのディレクトリの下にあるファイルのオーナーとグループは，OpenTP1ホームディレクトリのオーナーとグループに合わせて変更されます。
オーナーとグループの変更は，examplesを除くディレクトリが一つでも新規に作成されたときに行われます。

(2)　OpenTP1のOSからの削除

OpenTP1をOSから削除する場合は，OpenTP1を終了してからスーパユーザがOpenTP1のdcsetupコマンドを使用します。

OpenTP1をOSから削除するときは，OpenTP1ホームディレクトリにある環境を削除するかどうかを選択します。OpenTP1ホームディレクトリにある環境を削除する場合，OpenTP1ホームディレクトリの指定場所によって次のように処理が異なります。

OpenTP1ホームディレクトリが/BeTRANの場合

spool，およびtmpディレクトリの削除

RM接続情報の削除

メッセージオブジェクトファイルの削除

OpenTP1ホームディレクトリが/BeTRAN以外の場合

bin，etc，include，lib，spool，およびtmpディレクトリの削除

RM接続情報の削除

メッセージオブジェクトファイルの削除

なお，dcsetupコマンドを実行したときに，すでにOpenTP1がOSから削除されていても，dcsetupコマンドによってOpenTP1ホームディレクトリにある環境を削除できます。

OpenTP1ホームディレクトリにある環境を削除しなかった場合は，必要に応じて，再度dcsetupコマンドを実行することで，OpenTP1のOSへの登録だけを実行できます。OpenTP1ホームディレクトリ下の環境が変わる場合は，いったんdcsetupコマンドでOSからOpenTP1を削除したあと，再度dcsetupを実行してOpenTP1をOSに登録してください。

1.2.6　OpenTP1ファイルシステム領域の作成

OpenTP1ファイルシステムは，キャラクタ型スペシャルファイル上，または通常ファイル上に作成できます。

OpenTP1ファイルシステムをキャラクタ型スペシャルファイル上に作成する場合は，OpenTP1ファイルシステム用にディスクパーティションを割り当てます。このパーティションは，マウントしないでください。

OpenTP1ファイルシステムを通常ファイル上に作成する場合は，OpenTP1ファイルシステム用にディスクパーティションを割り当てる必要はありません。

OpenTP1ファイルシステムを作成するときは，キャラクタ型スペシャルファイル上と通常ファイル上のどちらに作成する場合でも，次の2種類のOpenTP1ファイルシステムを作成します。

システム用OpenTP1ファイルシステム

ユーザ用OpenTP1ファイルシステム

したがって，OpenTP1ファイルシステムをキャラクタ型スペシャルファイル上に作成する場合は，システム用とユーザ用の2種類のディスクパーティションを割り当てます。

OpenTP1ファイルシステムを作成したキャラクタ型スペシャルファイルや通常ファイルをOpenTP1ファイルシステム領域といいます。権限を持たないユーザからOpenTP1ファイルのあるOpenTP1ファイルシステム領域をアクセスされないようにするために，OpenTP1ファイルシステム領域の所有者とアクセス権は，次の表に示すように設定します。

所有者とアクセス権の設定にはOSのコマンドを使用します。

表1-1　OpenTP1ファイルシステム領域の所有者とアクセス権

OpenTP1ファイルシステム領域
所有者
アクセス権

ユーザID
グループID
所有者
グループ
そのほか

システム用
OpenTP1管理者
OpenTP1グループ
rw
（読み書きができる）
r-
（読むことができる）
r-
（読むことができる）

ユーザ用
OpenTP1管理者
OpenTP1グループ
rw
（読み書きができる）
rw
（読み書きができる）
r-
（読むことができる）

注

システム用とユーザ用を同一OpenTP1ファイルシステム領域に割り当てることもできます。その場合，アクセス権はユーザ用としてください。

1.2.7　ドメイン通信の環境設定

ドメインを代表するスケジュールサービスをドメインデータファイルに登録すると，dc_rpc_call関数を使用したドメイン指定の通信が実現できます。ドメイン間通信の電文はすべて，ドメインを代表するスケジュールサービスを経由して，最終通信先のスケジュールサービスに渡ります。

ドメインは複数のOpenTP1サーバで構成されます。そのドメインを代表するOpenTP1サーバを決めてください。そのOpenTP1サーバのスケジュールサービスがドメインを代表するスケジュールサービスになります。ドメインデータファイルには，ドメイン代表スケジュールサービスを登録します。ホスト名を指定してドメインデータファイルに登録します。ドメインデータファイルとは，DNSのhosts情報ファイルのことです。

ドメイン指定の通信をするには，ユーザサーバからドメイン指定のdc_rpc_call関数を発行します。電文を受けたドメイン代表スケジュールサービスは，ドメイン内の最終通信先のスケジュールサービスにその電文を渡します。

ドメイン指定の通信をするには，次の環境設定が必要です。

＜この項の構成＞

(1)　ドメイン代表スケジュールサービスの登録

(2)　ドメイン代表スケジュールサービスのポート番号の登録

(3)　システム定義の指定

(4)　同一ホスト内に複数のスケジュールサービスがある場合

(1)　ドメイン代表スケジュールサービスの登録

ドメインデータファイルには，三つのドメイン代表スケジュールサービスが登録できます。namdomainsetupコマンドを使用して，ドメイン代表スケジュールサービスのホスト名を登録します。ドメイン代表スケジュールサービスを登録できるのは，スーパユーザだけです。

(2)　ドメイン代表スケジュールサービスのポート番号の登録

/etc/servicesにドメイン代表スケジュールサービスのポート番号を登録します。ポート番号は，すべてのドメインで同一にしてください。次の形式で指定します。

OpenTP1scd　ポート番号/tcp　エイリアス名

OpenTP1scdは固定です。

プロトコル名はtcpを指定します。

任意のエイリアス名を指定できます。

OpenTP1を起動するすべてのホストの/etc/servicesにドメイン代表スケジュールサービスのポート番号を登録してください。ただし，NISで運用している場合は，NISサーバの/etc/servicesだけに登録します。

/etc/servicesにポート番号を登録しなかった場合にドメイン指定のdc_rpc_call関数を発行すると，DCRPCER_NO_PORTでエラーリターンします。

(3)　システム定義の指定

スケジュールサービス定義
ドメイン代表スケジュールサービスのポート番号を定義します。スケジュールサービス定義のscd_portオペランドにドメイン代表スケジュールサービスのポート番号を指定してください。このポート番号は，/etc/servicesに登録したポート番号を指定します。

システム共通定義
自ドメインを構成するノードを設定します。システム共通定義のall_nodeオペランドにノード名を指定します。

(4)　同一ホスト内に複数のスケジュールサービスがある場合

マルチOpenTP1や系切り替え機能使用時など，同一ホスト内で複数のスケジュールサービス（OpenTP1）を起動する場合，それぞれのスケジュールサービスごとにポート番号は異なります。同一ホスト内の複数のスケジュールサービスを，ドメイン代表スケジュールサービスとして設定すると，ドメイン指定のdc_rpc_call関数を発行して，設定したスケジュールサービス間のドメイン通信はできません。同一ホスト内で複数のスケジュールサービスを起動する場合は，そのうちの一つのスケジュールサービスだけを，ドメイン代表スケジュールサービスにしてください。環境設定を次に示します。

ドメイン代表スケジュールサービスの登録
ドメイン代表スケジュールサービスとしてドメインデータファイルに登録するスケジュールサービスを一つだけ登録します。

ポート番号の登録
/etc/servicesに登録するポート番号は一つだけです。ドメインデータファイルに登録したスケジュールサービスのポート番号を登録します。

システム定義
ドメイン代表スケジュールサービスのポート番号を，スケジュールサービス定義のscd_portオペランドに指定します。/etc/servicesに登録したポート番号です。
システム共通定義のall_nodeオペランドに，自ドメインを構成するノード名を指定します。

1.2.8　システム共通定義の変更

OpenTP1をOSに登録したあとにシステム共通定義を変更した場合は，OpenTP1を再登録してください。再登録には，次の二つの方法があります。

＜この項の構成＞

(1)　スーパユーザが変更する場合

(2)　OpenTP1管理者が変更する場合

(1)　スーパユーザが変更する場合

定義変更後，OpenTP1を正常終了してからOpenTP1をOSから削除します。

dcsetupコマンドに-dオプションを指定します。次に，変更した定義を有効にするためにdcsetupコマンドを使用して，OpenTP1を再登録します。

(2)　OpenTP1管理者が変更する場合

OpenTP1管理者は，dcresetコマンドを使用してシステム共通定義を変更できます。dcresetコマンドは，OpenTP1正常終了後に実行します。OpenTP1オンライン中にdcresetコマンドを実行するとシステムダウンします。

1.3　OpenTP1管理者による環境設定

OpenTP1を実行するためにOpenTP1管理者が実施する環境設定について説明します。OpenTP1の運用コマンドの詳細は，「13.　運用コマンドの詳細」を参照してください。

OSに依存する部分は，ユーザが使用するOSのマニュアルを参照してください。

＜この節の構成＞

1.3.1　システム定義の作成と確認

1.3.2　OpenTP1管理者の環境設定

1.3.3　OpenTP1の内部制御用資源の確保

1.3.4　OpenTP1ファイルシステムの初期設定

1.3.5　OpenTP1ファイルの作成

1.3.6　OpenTP1ファイル以外のファイルの作成

1.3.7　リソースマネジャの登録

1.3.8　トランザクション制御用オブジェクトファイルの作成

1.3.9　システム共通定義の変更

1.3.1　システム定義の作成と確認

スーパユーザがOpenTP1をOSに登録する前に，OpenTP1管理者はOpenTP1のシステム定義を作成します。システム定義を作成したあとでdcdefchkコマンドを実行すると，OpenTP1を起動する前に，システム定義の指定値に誤りがないかどうかをチェックできます。システム定義および定義チェックの詳細については，マニュアル「OpenTP1 システム定義」を参照してください。

＜この項の構成＞

(1)　dcdefchkコマンドでチェックできる内容

(2)　dcdefchkコマンドのチェック処理の流れ

(3)　注意事項

(1)　dcdefchkコマンドでチェックできる内容

dcdefchkコマンドを実行すると，次に示すチェックが行われます。

(a)　システム定義の構文チェック

システム定義の構文チェックでは，次の内容をチェックします。

各オペランドに指定した値が指定できる文字かどうか。

各オペランドに指定した値が最小値，または最大値を超えていないかどうか。

定義コマンドに不正なオプションが指定されていないかどうか。

定義コマンドに指定したコマンド引数，およびフラグ引数が指定できる文字かどうか。

定義コマンドに指定したコマンド引数，およびフラグ引数が最小値，または最大値を超えていないかどうか。

(b)　システム定義の論理チェック

システム定義の論理チェックでは，オペランドまたは定義コマンドに指定した値がOpenTP1を運用する上で問題ないかなどをチェックします。主に次の内容をチェックします。

複数のオペランドまたは定義コマンド間にわたる指定内容の相関関係に問題がないかどうか。

オペランドまたは定義コマンドに指定した値が推奨値かどうか。

オペランドまたは定義コマンドに指定したファイルおよびディレクトリのアクセス権限に問題がないかどうか。

(c)　OpenTP1ファイルのチェック

OpenTP1ファイルのチェックでは，システム定義に指定したOpenTP1ファイルが正しいファイルかどうかをチェックします。

(2)　dcdefchkコマンドのチェック処理の流れ

dcdefchkコマンドのチェック処理の流れを次に示します。

オペランドの構文チェック
定義格納ディレクトリ下のシステム定義ファイルに対して，オペランドの構文チェックを行います。チェックの順序は，次のとおりです。
1.　$DCCONFPATH下にあるシステム定義ファイル
2.　$DCUAPCONFPATHが指定されている場合，$DCUAPCONFPATH下にあるユーザサービス定義ファイルまたはユーザサービスデフォルト定義ファイル

KFCA00258-Iメッセージの出力
1.の構文チェックを行った定義ファイルの一覧をKFCA00258-Iメッセージに出力します。このとき，システムサービス定義としてチェックを行ったファイルだけを出力します。ユーザサービス定義としてチェックを行ったファイルは出力しません。

KFCA00254-Rメッセージの出力
dcdefchkコマンドに-rオプションが指定されている場合に，1.の構文チェックエラーを検出すると，KFCA00254-Rメッセージを出力します。KFCA00254-Rメッセージは，コマンド処理を続行するか停止するかを選択するためのメッセージです。

システム定義（ユーザサービス定義以外）に指定した定義コマンドの構文チェック（論理チェックを一部含む）
定義格納ディレクトリ（$DCCONFPATH，$DCUAPCONFPATHで示されるディレクトリ）下のシステム定義に対して，定義コマンドの構文チェックを行います（論理チェックを一部含む）。
なお，この処理以降では，次に示すメッセージ区分を持ったメッセージを出力します。ただし，一部メッセージ区分を持たないメッセージを出力することもあります。

メッセージ区分

ERROR：OpenTP1の起動および停止ができない状態，または動作不完全となる問題を検出した場合に出力します。

WARNG：推奨しない値が指定されていることを検出した場合に出力します。

CHECK：指定された定義の妥当性について確認を促す場合に出力します。

システム定義（ユーザサービス定義以外）の論理チェック
定義格納ディレクトリ下のシステム定義に指定されている定義の論理チェックを行います。

ユーザサービス定義に指定した定義コマンドの構文チェック（論理チェックを一部含む）
定義格納ディレクトリ下のユーザサービス定義に指定されている定義コマンドの構文チェックを行います（論理チェックを一部含む）。

ユーザサービス定義の論理チェック
定義格納ディレクトリ下のユーザサービス定義に指定されている定義の論理チェックを行います。

チェック処理の流れの順番を次の表に示します。表内の番号は，チェック処理の流れの順番と対応しています。なお，OpenTP1ファイルのチェックは，dcdefchkコマンドのチェック処理の流れの4.および5.で行っています。

表1-2　dcdefchkコマンドのチェック処理の流れ

チェック種別
オペランド
（set形式）
定義コマンド（コマンド形式）

ユーザサービス定義以外
ユーザサービス定義

構文チェック
1.
4.
6.

論理チェック
5.および7.
4.および5.
6.および7.

(3)　注意事項

dcdefchkコマンドは，OpenTP1の動作中でも実行できます。その場合，確認するシステム定義の指定値は動作中のOpenTP1で有効な値ではなく，コマンド実行時にシステム定義に指定した値です。例えば，プロセスサービス定義に指定したprcsvpathの値をprcpathコマンドで変更しても，チェック対象の値はプロセスサービス定義に指定した値となります。

コマンドを実行する環境に設定した環境変数$DCDIRをOpenTP1ディレクトリとして使用します。そのため，dcstartコマンドを実行する環境に設定したOpenTP1ディレクトリパス名と異なる値を設定している場合，正しく定義チェックできません。

$DCCONFPATH，および$DCUAPCONFPATHに指定したディレクトリパスが50バイト以上の場合，構文チェックでエラーを検出したときに出力するメッセージ（KFCA00242-E）に出力される定義ファイル名が途中までしか出力されません。チェック対象の定義ファイルを50バイト以下のディレクトリパス名で示されるディレクトリにコピーし，$DCDIR/conf/envにputenv形式で指定する環境変数DCCONFPATHにコピー先ディレクトリを指定してdcdefchkコマンドを実行してください。

定義チェック対象としないファイルを定義格納ディレクトリに格納しないでください。システム定義格納ディレクトリ（$DCCONFPATHおよび$DCUAPCONFPATH）下にシステム定義ファイル，ユーザサービス定義ファイル，およびユーザサービスデフォルト定義ファイル以外のファイルがあると正しく定義チェックできません。ただし，ドメイン定義ファイル格納ディレクトリ，およびドメイン定義ファイルは除きます。

システム定義格納ディレクトリ（$DCCONFPATH，および$DCUAPCONFPATH）下にあるシステムサービス定義ファイル以外のファイルで，ファイル名が「.」や「_」で始まるファイル，およびファイル名が9バイト以上のファイルについては，チェックの対象外になります。

dcdefchkコマンドが定義チェックの対象とするオペランドは，マニュアル「OpenTP1 システム定義」に記載しているオペランドだけです。

定義チェックコマンド（dcdefchkコマンド）とOpenTP1ファイルの作成コマンド（jnlinitコマンドなど）を同時に実行しないでください。

構文チェックでオペランドの指定値に問題を検出した場合，論理チェックでは，そのオペランドにデフォルト値が指定されていると解釈して論理チェックを行います。

ファイルやディレクトリのアクセス権限チェックは，コマンドを実行したユーザのUID/GIDに従ったアクセス権限のチェックを行います。

待機状態など，OpenTP1ファイルシステムにアクセスできない状態の場合，論理チェック時にメッセージを出力することがあります。

dcdefchkコマンドの定義チェック時に出力する一部のメッセージには，dcdefchkコマンド専用のメッセージ区分を持たないメッセージがあります。そのため，dcdefchkコマンドに-eオプションを指定しても，メッセージの種類がEであるメッセージを出力することがあります。

環境変数（putenv形式およびdcputenv形式の定義）は，正しく論理チェックできないことがあります。

1.3.2　OpenTP1管理者の環境設定

OpenTP1のコマンドを実行するために，ログイン環境に次の環境変数を設定してください。

DCDIR

OpenTP1ディレクトリを完全パス名で指定します。DCDIRに設定するディレクトリ名は，50バイト以内で指定してください。OpenTP1ディレクトリにシンボリックリンクは使用できません。

DCCONFPATH

OpenTP1定義ファイルを格納するディレクトリの完全パス名を246バイト以下で指定します。

なお，アクセス権限は，DCDIRと同じにする必要があります。DCDIRのアクセス権限については，「1.2.4　OpenTP1ディレクトリの作成」を参照してください。

DCUAPCONFPATH

OpenTP1ユーザサービス定義ファイルまたはユーザサービスデフォルト定義ファイルをDCCONFPATH環境変数で設定したディレクトリとは別のディレクトリに格納したい場合，そのディレクトリの完全パス名を246バイト以下で指定します。

なお，アクセス権限は，DCDIRと同じにする必要があります。DCDIRのアクセス権限については，「1.2.4　OpenTP1ディレクトリの作成」を参照してください。

PATH

$DCDIR/binをPATHに加えます。

また，hostnameコマンドが返す名称をIPアドレスとマッピングできる環境設定（/etc/hosts，DNSなど）が必要です。

1.3.3　OpenTP1の内部制御用資源の確保

OpenTP1が内部制御用に使用するOSの資源を確保するには，dcmakeupコマンドを使用します。dcmakeupコマンドを実行すると，資源を確保し，OpenTP1ディレクトリ下に格納します。確保する資源の数は，OpenTP1ディレクトリ下のシステム定義から解析します。

プロセスサービス定義のprc_process_countオペランドの値を変更した場合は，dcsetupコマンドを実行したあと，dcstartコマンドを実行する前に，必ずdcmakeupコマンドを実行してください。

dcmakeupコマンドを実行しなかった場合，OpenTP1の開始処理でこのコマンドの処理が実行されますが，十分な数の資源を確保するのに時間が掛かることがあります。

1.3.4　OpenTP1ファイルシステムの初期設定

OpenTP1管理者は，filmkfsコマンドで，キャラクタ型スペシャルファイル，または通常ファイルを，OpenTP1ファイルシステムとして使用できる状態に初期設定します。

1.3.5　OpenTP1ファイルの作成

OpenTP1のfilmkfsコマンドで初期設定したOpenTP1ファイルシステム上に，次の表に示すOpenTP1ファイルを作成，初期設定します。

表1-3　作成，初期設定するOpenTP1ファイルと使用する運用コマンド

OpenTP1ファイル | 初期設定する運用コマンド | OpenTP1ファイルを作成するOpenTP1ファイルシステム領域 | 備考
ステータスファイル | stsinit | システム用OpenTP1ファイルシステム領域 | ノード内に必須
ジャーナル関係のファイル | システムジャーナルファイル | jnlinit
チェックポイントダンプファイル
XARファイル | xarinit | ノード内に任意※¹
ノードリストファイル | namnlcre | ノード内に任意
メッセージキューファイル | queinit | ユーザ用OpenTP1ファイルシステム領域 | ノード内に任意※²
MQAキューファイル | mqainit | ノード内に任意※³
DAMファイル | damload | ノード内に任意
TAMファイル | tamcre | ノード内に任意

注※1

XAリソースサービスを使用するときに必要です。

注※2

TP1/Message Controlを使用するときに必要です。

注※3

TP1/Message Queueを使用するときに必要です。運用コマンドの詳細はマニュアル「TP1/Message Queue 使用の手引」を参照してください。

ステータスファイル，システムジャーナルファイル，チェックポイントダンプファイル，XARファイル，およびノードリストファイルは，システム用OpenTP1ファイルシステム領域内に作成してください。

次のファイルは，ユーザ用OpenTP1ファイルシステム領域内に作成してください。

メッセージキューファイル

MQAキューファイル

DAMファイル

TAMファイル

なお，ISAMファイルについては，マニュアル「索引順編成ファイル管理 ISAM」を参照してください。

1.3.6　OpenTP1ファイル以外のファイルの作成

OpenTP1を実行するためには，OpenTP1ファイル以外に次に示すOSのファイルが必要です。

＜この項の構成＞

(1)　ユーザが作成するファイル

(2)　インストール時，またはOSへの登録時に作成されるファイルとディレクトリ

(3)　OpenTP1実行時に作成されるファイル

(1)　ユーザが作成するファイル

ユーザが作成するファイルを次に示します。

ユーザプログラムファイル
UAPの実行形式プログラムを格納するファイルです。

MCF通信プロセスプログラムファイルおよびMCFアプリケーション起動プロセスプログラムファイル
メッセージ制御機能を使用する場合に，作成するMCF通信プロセスの実行形式プログラムおよびMCFアプリケーション起動プロセスの実行形式プログラムを格納するファイルです。

各種定義ファイル
OpenTP1の各種定義を格納するファイルです。
定義ファイルは，OSのテキストエディタを使用して，テキストファイルとして作成します。

上記のファイルをユーザが作成するディレクトリ下に作成します。なお，ディレクトリ$DCDIR/aplibと$DCDIR/confは，OpenTP1のインストール時に作成されます。

ユーザが作成するファイルとディレクトリを次の表に示します。

表1-4　ユーザが作成するファイルとディレクトリ

ファイル | ディレクトリ | ファイル名 | ファイル種別
ユーザプログラムファイル | $DCDIR/aplib/※¹ | 実行形式プログラム名※² | 実行形式ファイル
MCF通信プロセスプログラムファイル，MCFアプリケーション起動プロセスプログラムファイル | $DCDIR/lib/servers/ | 実行形式プログラム名 | 実行形式ファイル
各種定義ファイル | システム環境定義 | $DCDIR/conf/ | env | テキストファイル
システム環境定義以外の定義 | $DCCONFPATH/ | 定義ファイル名 | テキストファイル
システムサービス情報定義 | $DCDIR/lib/sysconf/ | システムサービス情報定義ファイル名 | テキストファイル
システムサービス共通情報定義※³ | $DCDIR/lib/sysconf/ | mcf | テキストファイル

注※1

プロセスサービス定義で変更できます。

注※2

ユーザサービス定義で変更できます。

注※3

インストール時またはOSへの登録時に作成されるファイルですが，動作環境によっては定義内容の変更が必要なファイルです。

(2)　インストール時，またはOSへの登録時に作成されるファイルとディレクトリ

OpenTP1のインストール時に作成されるファイルを次に示します。

OpenTP1プログラムファイル
OpenTP1のプログラムを格納するファイルです。
OpenTP1の実行形式ファイルとUAPの作成に使うファイルがあります。

OpenTP1の実行形式ファイル：システムサービス，コマンド

UAPの作成に使うファイル：ヘッダファイル，アーカイブファイル

定義解析用ファイル
OpenTP1の内部で，定義解析用に使用されるファイルです。

メッセージオブジェクトファイル
メッセージテキストを格納するファイルです。

上記のファイルは，OpenTP1が作成するディレクトリ下に作成されます。

OpenTP1のインストール時，またはOSへの登録時に作成されるディレクトリを次に示します。

ユーザプログラムファイルディレクトリ
ユーザプログラムファイルを格納するディレクトリです。

各種定義ファイルディレクトリ
OpenTP1の各種定義ファイルを格納するディレクトリです。

システム管理情報ディレクトリ
システム管理情報を格納するディレクトリです。

退避コアファイルディレクトリ
退避コアファイルを格納するディレクトリです。

コマンドログディレクトリ
コマンドログファイルを格納するディレクトリです。

デッドロック情報ファイルディレクトリ
デッドロック情報，タイムアウト情報ファイルを格納するディレクトリです。

トランザクション情報ディレクトリ
トランザクション情報を格納するディレクトリです。

ジャーナル情報ディレクトリ
ジャーナル情報を格納するディレクトリです。

プロセスサービス情報ディレクトリ
プロセスサービス情報を格納するディレクトリです。

トランザクションジャーナルディレクトリ
トランザクションジャーナル情報を格納するディレクトリです。

サーバリカバリジャーナルディレクトリ
サーバリカバリジャーナル情報を格納するディレクトリです。

トランザクション制御用オブジェクト格納ディレクトリ
トランザクション制御用オブジェクトファイルを格納するディレクトリです。

オンラインテスタ用ディレクトリ
オンラインテスタで使用するファイルを格納するディレクトリです。

システム内部排他制御用ディレクトリ
OpenTP1内部の排他制御用の情報を格納するディレクトリです。

システム内部同期制御用ディレクトリ
OpenTP1内部の同期制御用の情報を格納するディレクトリです。

インストール時，またはOSへの登録時に作成されるファイルとディレクトリを次の表に示します。

表1-5　インストール時，またはOSへの登録時に作成されるファイルとディレクトリ

名称 | ディレクトリ | ファイル名
OpenTP1プログラムファイル | OpenTP1サーバ | $DCDIR/lib/servers/ | －※
コマンド | $DCDIR/bin/ | －
ヘッダファイル | $DCDIR/include/ | －
アーカイブファイル | $DCDIR/lib/ | －
定義解析用ファイル | $DCDIR/lib/sysconf/ | －※
$DCDIR/lib/sysdef/ | －
メッセージオブジェクトファイル | $DCDIR/lib/ | emsgtxt，jmsgtxt
ユーザプログラムファイルディレクトリ | $DCDIR/aplib/ | なし
各種定義ファイルディレクトリ | $DCDIR/conf/ | なし
システム管理情報ディレクトリ | $DCDIR/etc/ | －
退避コアファイルディレクトリ | $DCDIR/spool/save/ | なし
コマンドログディレクトリ | $DCDIR/spool/cmdlog/ | －
デッドロック情報ファイルディレクトリ | $DCDIR/spool/dclckinf/ | なし
トランザクション情報ディレクトリ | $DCDIR/spool/dctrninf/ | なし
ジャーナル情報ディレクトリ | $DCDIR/spool/dcjnlinf/errinf/ | なし
プロセスサービス情報ディレクトリ | $DCDIR/spool/dcprcinf/ | なし
トランザクションジャーナルディレクトリ | $DCDIR/spool/dctjlinf/ | －
サーバリカバリジャーナルディレクトリ | $DCDIR/spool/dcsjl/ | －
トランザクション制御用オブジェクト格納ディレクトリ | $DCDIR/spool/trnrmcmd/userobj/ | dc_trn_allrm.o
オンラインテスタ用ディレクトリ | $DCDIR/spool/uto/ | なし
システム内部排他制御用ディレクトリ | $DCDIR/spool/olkfifs/ | －
システム内部同期制御用ディレクトリ | $DCDIR/spool/olkrsfs/ | －

（凡例）

－：ユーザは指定する必要がないことを示します。

注※

MCFを使用する場合は，ファイルの作成が必要です。

(3)　OpenTP1実行時に作成されるファイル

次に示すファイルは，オンライン実行時にOpenTP1によって動的に作成されます。

(a)　通常作成されるファイル

OpenTP1実行時，通常作成されるファイルを次に示します。

メッセージログファイル
OpenTP1が出力したシステムメッセージを格納するファイルです。

MCFトレースファイル
TP1/Message Controlのトレース情報を格納するファイルです。

スケジュールキュー情報ファイル
OpenTP1の内部で，スケジュールキュー情報を格納するファイルです。

RPCトレースファイル
RPCトレースを格納するファイルです。

トレース情報ダンプファイル
OpenTP1内部のトレース情報を格納するファイルです。

性能検証用トレース情報ファイル
性能検証用のトレース情報を格納するファイルです。

性能検証用トレース情報ファイルのバックアップファイル
性能検証用トレース情報ファイルのバックアップファイルです。

XAR性能検証用トレース情報ファイル
XAリソースサービスを使用したトランザクション連携の各種イベント（アプリケーションサーバからのトランザクション要求，OpenTP1のトランザクション処理）のトレース情報を格納するファイルです。

XAR性能検証用トレース情報ファイルのバックアップファイル
XAR性能検証用トレース情報ファイルのバックアップファイルです。

JNL性能検証用トレース情報ファイル
ジャーナルサービスのトレース情報を格納するファイルです。

JNL性能検証用トレース情報ファイルのバックアップファイル
JNL性能検証用トレース情報ファイルのバックアップファイルです。

LCK性能検証用トレース情報ファイル
ロックサービスを使用した排他制御の各種イベントのトレース情報を格納するファイルです。

LCK性能検証用トレース情報ファイルのバックアップファイル
LCK性能検証用トレース情報ファイルのバックアップファイルです。

MCF性能検証用トレース情報ファイル
MCF性能検証用のトレース情報を格納するファイルです。

MCF性能検証用トレース情報ファイルのバックアップファイル
MCF性能検証用トレース情報ファイルのバックアップファイルです。

TRNイベントトレース情報ファイル
トランザクションブランチで呼び出されるXA関数やトランザクションサービス（トランザクション管理サービス，トランザクション回復サービス，およびリソースマネジャ監視サービス）の各種イベントのトレース情報を格納するファイルです。

TRNイベントトレース情報ファイルのバックアップファイル
TRNイベントトレース情報ファイルのバックアップファイルです。

NAMイベントトレース情報ファイル
ネームサービスで実行される通信処理，キャッシュへのサービス情報の登録，削除などの各種イベントのトレース情報を格納するファイルです。

NAMイベントトレース情報ファイルのバックアップファイル
NAMイベントトレース情報ファイルのバックアップファイルです。

プロセスサービスイベントトレース情報ファイル
プロセスサービスのトレース情報を格納するファイルです。

プロセスサービスイベントトレース情報ファイルのバックアップファイル
プロセスサービスイベントトレース情報ファイルのバックアップファイルです。

FILイベントトレース情報ファイル
OpenTP1ファイルへのアクセス要求に対して，指定した値以上の処理時間が掛かった場合にイベント情報を格納するファイルです。

FILイベントトレース情報ファイルのバックアップファイル
FILイベントトレース情報ファイルのバックアップファイルです。

RTSログファイル
リアルタイム統計情報を格納するファイルです。

MCF稼働統計情報ファイル
MCFの稼働統計情報を格納するファイルです。

UAPトレースデータファイル
UAPトレースのトレース情報を格納するファイルです。uap_trace_file_putオペランドにYを指定した場合にだけ作成されます。uap_trace_file_putオペランドは，次のどれかの定義で指定します。

システム共通定義

ユーザサービスデフォルト定義

ユーザサービス定義

UAPトレースデータファイルのバックアップファイル
UAPトレースのトレース情報を格納するファイルのバックアップファイルです。

なお，OpenTP1実行時には，システムサービス，およびユーザサーバのカレントワーキングディレクトリも作成されます。

OpenTP1実行時に作成されるファイルは，OpenTP1が作成するディレクトリ下に作成されます。通常作成されるファイルとディレクトリを次の表に示します。

表1-6　通常作成されるファイルとディレクトリ

名称 | ディレクトリ | ファイル名
メッセージログファイル | $DCDIR/spool/ | dclog1，およびdclog2
MCFトレースファイル※¹ | $DCDIR/spool/ | mcftAXXZZ※²
スケジュールキュー情報ファイル | $DCDIR/spool/ | scdqid1，およびscdqid2
RPCトレースファイル | $DCDIR/spool/ | rpctr1，およびrpctr2※³
トレース情報ダンプファイル | $DCDIR/spool/save/ | dcmtrdp1，およびdcmtrdp2
性能検証用トレース情報ファイル | $DCDIR/spool/dcprfinf/ | prf_nnn※4
性能検証用トレース情報ファイルのバックアップファイル | $DCDIR/spool/save/ | prf_nnn.bk1※5，およびprf_nnn.bk2※5
XAR性能検証用トレース情報ファイル | $DCDIR/spool/dcxarinf/ | _xr_nnn※4
XAR性能検証用トレース情報ファイルのバックアップファイル | $DCDIR/spool/save/ | _xr_nnn.bk1※5，および_xr_nnn.bk2※5
JNL性能検証用トレース情報ファイル | $DCDIR/spool/dcjnlinf/prfinf/ | _jl_nnn※4
JNL性能検証用トレース情報ファイルのバックアップファイル | $DCDIR/spool/save/ | _jl_nnn.bk1※5，および_jl_nnn.bk2※5
LCK性能検証用トレース情報ファイル | $DCDIR/spool/dclckinf/prf/ | _lk_nnn※4
LCK性能検証用トレース情報ファイルのバックアップファイル | $DCDIR/spool/save/ | _lk_nnn.bk1※5，および_lk_nnn.bk2※5
MCF性能検証用トレース情報ファイル | $DCDIR/spool/dcmcfinf/ | _mc_nnn※4
MCF性能検証用トレース情報ファイルのバックアップファイル | $DCDIR/spool/save/ | _mc_nnn.bk1※5，および_mc_nnn.bk2※5
TRNイベントトレース情報ファイル | $DCDIR/spool/dctrninf/trace/prf/ | _tr_nnn※4
TRNイベントトレース情報ファイルのバックアップファイル | $DCDIR/spool/save/ | _tr_nnn.bk1※5，および_tr_nnn.bk2※5
NAMイベントトレース情報ファイル | $DCDIR/spool/dcnaminf/ | _nm_001，_nm_002，および_nm_003
NAMイベントトレース情報ファイルのバックアップファイル | $DCDIR/spool/save/ | _nm_nnn.bk1※5，および_nm_nnn.bk2※5
プロセスサービスイベントトレース情報ファイル | $DCDIR/spool/dcprcinf/ | _pr_001，_pr_002，および_pr_003
プロセスサービスイベントトレース情報ファイルのバックアップファイル | $DCDIR/spool/save/ | _pr_nnn.bk1※5，および_pr_nnn.bk2※5
FILイベントトレース情報ファイル | $DCDIR/spool/dcfilinf/ | _fl_001，_fl_002，および_fl_003
FILイベントトレース情報ファイルのバックアップファイル | $DCDIR/spool/save/ | _fl_nnn.bk1※5，および_fl_nnn.bk2※5
RTSログファイル | $DCDIR/spool/dcrtsinf/※6 | rtslog[1～10]※6，※7
MCF稼働統計情報ファイル | $DCDIR/spool/※⁸ | mcfstc※⁸
カレントワーキングディレクトリ※9 | $DCDIR/tmp/home/サーバ名.ID※¹⁰/ | －
UAPトレースデータファイル | $DCDIR/tmp/home/サーバ名.ID | dcuat.map
UAPトレースデータファイルのバックアップファイル | $DCDIR/spool/save/trc/※11 | サーバ名n.uatmap※12，およびサーバ名_n.uatmap※12

（凡例）

－：ユーザは指定する必要がないことを示します。

注※1

TP1/Message Controlを使用するときだけ作成されます。

注※2

AXXZZ：

AXX：MCF識別子

A：MCFマネジャ定義の，mcfmenv定義コマンドの-mオプションのidオペランドで指定したMCFマネジャプロセス識別子

XX：MCF通信構成定義の，mcftenv定義コマンドの-sオプションで指定したMCF通信プロセス識別子

ZZ：トレーススワップファイル識別子

注※3

ファイル名はシステム共通定義で変更できます。

注※4

nnn：それぞれ，次に示す定義のprf_file_countオペランドで指定した値を上限とした001から始まる値です。

性能検証用トレース：性能検証用トレース定義

XAR性能検証用トレース：XAR性能検証用トレース定義

JNL性能検証用トレース：JNL性能検証用トレース定義

LCK性能検証用トレース：LCK性能検証用トレース定義

MCF性能検証用トレース：MCF性能検証用トレース定義

TRNイベントトレース：TRNイベントトレース定義

注※5

nnn：バックアップ元のファイル名に対応した値です。

注※6

リアルタイム統計情報サービス定義のrts_log_file_nameオペランドの指定を省略した場合，このディレクトリにRTSログファイルが作成されます。

注※7

リアルタイム統計情報サービス定義のrts_log_file_countオペランドに指定した値分ファイルを作成します。

注※8

運用コマンド（mcfstats）で出力ファイル名を省略したとき，このディレクトリにこのファイルが作成されます。

注※9

カレントワーキングディレクトリはシステム共通定義のprc_current_work_pathオペランドを設定することによって変更できます。

注※10

ユーザ環境設定コマンドの場合，サーバ名は'_usrcmd'と表示されます。IDは1以上の通番です。ただし，運用コマンド（dcstart，dcstop，dcsvstart，およびdcsvstop），およびユーザ環境設定コマンドには，'.ID'は付きません。

注※11

プロセスサービス定義のprc_coresave_pathオペランドを指定している場合，ディレクトリは，「（prc_coresave_path指定値）/trc/」となります。

注※12

n：ファイルの通番（1～3）です。

(b)　障害時に作成されるファイル

障害時に作成されるファイルを次に示します。

共用メモリダンプファイル
OpenTP1が出力した共用メモリの内容を格納するファイルです。

退避コアファイル
異常終了したプロセスのコアファイルを退避するファイルです。

デッドロック，タイムアウト情報ファイル
デッドロック情報，タイムアウト情報を格納するファイルです。
不要となったファイルは削除してください。

MCFダンプファイル
TP1/Message Controlのダンプを格納するファイルです。

MCF共用メモリダンプファイル
メッセージ送受信関連のシステムサービスで障害が発生したときに，共用メモリプール中の，TP1/Message Controlが出力した内容を格納するファイルです。

未決着トランザクション情報ファイル
障害発生時，未決着のトランザクション情報を格納するファイルです。
不要となったファイルは削除してください。

不正ジャーナル情報ファイル
ジャーナルを読み込むときに不正なジャーナルを検知した場合，その不正なデータを格納するファイルです。

入出力キューの内容複写ファイル
入出力キューの内容複写コマンド（mcftdmpqu）を実行したときに，入出力キューの内容を格納するファイルです。

UAPトレース編集出力ファイル
UAPが異常終了した場合に，UAPのトレース情報を自動的に編集出力して格納するファイルです。

OpenTP1デバッグ情報ファイル
UAPが異常終了した場合に，OpenTP1の情報を格納するファイルです。

OpenTP1実行時に作成されるファイルは，OpenTP1が作成するディレクトリ下に作成されます。障害時に作成されるファイルとディレクトリを次の表に示します。

表1-7　障害時に作成されるファイルとディレクトリ

名称
ディレクトリ
ファイル名

共用メモリダンプファイル
$DCDIR/spool/

Linuxの場合

shmdump[1～3].gz，およびshmdump.XXX※1[1～3].gz

その他の場合

shmdump[1～3].Z，およびshmdump.XXX※1[1～3].Z

退避コアファイル
$DCDIR/spool/save/※²
サーバ名n※³

デッドロック，タイムアウト情報ファイル
$DCDIR/spool/dclckinf/
ファイル名※⁴

MCFダンプファイル※⁵
$DCDIR/spool/
mcfdKAXXZZ※⁶

MCF共用メモリダンプファイル※⁵
$DCDIR/spool/
mcfsAXXY※⁷

未決着トランザクション情報ファイル
$DCDIR/spool/dctrninf/
ファイル名※⁸

不正ジャーナル情報ファイル
$DCDIR/spool/dcjnlinf/errinf/
r_n※⁹

入出力キューの内容複写ファイル
$DCDIR/spool/
ファイル名※¹⁰

UAPトレース編集出力ファイル
$DCDIR/spool/save
サーバ名n※¹¹.uat

OpenTP1デバッグ情報ファイル
$DCDIR/spool/save
サーバ名n※¹¹.deb

注※1

XXX：リソースマネジャ名（dam，tam，ist，ism）

注※2

プロセスサービス定義のprc_coresave_pathオペランドを指定している場合，退避コアファイルは，prc_coresave_pathオペランドに指定したディレクトリに退避します。

注※3

n：退避コアファイルの通番（1～3）

ただし，サーバが強制停止時（dcsvstop -dfコマンドもしくはprckillコマンドを実行したとき，または実時間監視タイムアウトになったとき）に出力されるコアファイルには，通番は付きません。なお，プロセスサービスのコアファイルが 'core'という名称で，ディレクトリに取得されることがあります。また，ユーザ環境設定コマンドが異常終了した場合，そのコアファイルは'_usrcmd'に通番（1～3）が付いた名称で退避されます。

注※4

デッドロック検知日時を基に決定されます。ファイル名の長さは日付が1けたか2けたかによって異なります。

（例）

10月3日6時29分56秒のとき…Oct3062956

10月10日18時6分0秒のとき…Oct10180600

注※5

TP1/Message Controlを使用するときだけ作成されます。

注※6

KAXXZZ：

K：プロセス種別

m：MCFマネジャプロセス

c：MCF通信サービスまたはMCFアプリケーション起動サービス

u：ユーザサービスその他

AXX：MCF識別子

A：MCFマネジャ定義の，mcfmenv定義コマンドの-mオプションのidオペランドで指定したMCFマネジャプロセス識別子

XX：MCF通信構成定義の，mcftenv定義コマンドの-sオプションで指定したMCF通信プロセス識別子

ZZ：ダンプ通番（01～99）

注※7

AXXY：

AXX：MCF識別子

A：MCFマネジャ定義のmcfmenv -mのidオペランドで指定したMCFマネジャプロセス識別子

XX：MCF通信構成定義のmcftenv -sで指定したMCF通信プロセス識別子

Y：ファイルの通番（1～3）

注※8

rl＋トランザクションサービス開始時刻（16進数8けた）がファイル名になります。

注※9

n：不正なデータを検知したジャーナルの世代番号（16進表示）

注※10

入出力キューの内容複写コマンド（mcftdmpqu）で指定されたファイル名

注※11

n：ファイルの通番（1～3）

(c)　OpenTP1内部処理用のファイル

(a)，(b)に示したファイル以外に，$DCDIR/spool/と$DCDIR/tmp/の下には，OpenTP1内部処理用のファイルがあります。ユーザは勝手に変更しないようにしてください。なお，$DCDIR/tmp/下の内部処理用のファイルは，OpenTP1を開始するとすべてクリアされます。

(d)　OpenTP1が使用するOS用のファイル

OpenTP1は，/dev/consoleや/dev/nullを標準入出力で使用します。/dev/consoleおよび/dev/nullのパーミッションは変更しないでください。変更されたパーミッションによっては，動作を保証できなくなります。

1.3.7　リソースマネジャの登録

OpenTP1のプログラムプロダクトをインストールするときのトランザクションサービス制御用実行形式プログラム，およびクライアントサービス実行形式プログラムには，リソースマネジャが提供するXAインタフェース用オブジェクトファイルはリンケージされていません。dcsetupコマンド実行時，インストールされているOpenTP1のプログラムプロダクトを判断し，自動的にOpenTP1提供のリソースマネジャ（DAM，TAM，MCF，ISAM，MQA）のXAインタフェース用オブジェクトファイルをリンケージします。そのため，OpenTP1下でそのほかのリソースマネジャを使用したトランザクションを実行する場合は，dcsetupコマンド実行後，OpenTP1を開始する前に，OpenTP1のtrnlnkrmコマンドでOpenTP1提供以外のリソースマネジャを登録してください。trnlnkrmコマンドを実行すると，トランザクションサービス制御用実行形式プログラム，クライアントサービス実行形式プログラム，および標準トランザクション制御用オブジェクトファイルが再作成されます。

なお，OpenTP1以外が提供するリソースマネジャを使用する場合については，マニュアル「OpenTP1 プログラム作成の手引」を参照してください。

1.3.8　トランザクション制御用オブジェクトファイルの作成

OpenTP1下で動作するUAPがトランザクション内でリソースマネジャにアクセスする場合，そのUAPにトランザクション制御用オブジェクトファイルをリンケージする必要があります。

OpenTP1に登録されているすべてのリソースマネジャをアクセスするUAPの場合は，OpenTP1が提供する標準トランザクション制御用オブジェクトファイルのdc_trn_allrm.o（dcsetupコマンド実行時に作成され，trnlnkrmコマンド実行時に再作成される$DCDIR/spool/trnrmcmd/userobj下のファイル）をリンケージします。

OpenTP1に登録されている一部のリソースマネジャだけをアクセスするUAPの場合は，trnmkobjコマンドでトランザクション制御用オブジェクトファイルを作成して，UAPにリンケージします。

トランザクション内でリソースマネジャにアクセスしないUAPの場合は，トランザクション制御用オブジェクトファイルをリンケージする必要はありません。ただし，trnlnkrmコマンドでリソースマネジャの登録状態を変更した場合，標準トランザクション制御用オブジェクトファイルをリンケージしているUAPは，再びリンケージする必要があります。

ただし，グローバルトランザクションを構成するすべてのUAPに，同じリソースマネジャをリンケージすると，コミット処理を最適化（プロセス間通信を抑止）できて，トランザクション性能が向上します。

OpenTP1を開始する前に，トランザクション制御用オブジェクトファイルと，リソースマネジャが提供するXAインタフェース用オブジェクトファイルをUAPにリンケージしてください。

1.3.9　システム共通定義の変更

dcresetコマンドを使用すると，OpenTP1管理者がシステム共通定義を変更できます。dcresetコマンドを実行すると，システム共通定義の変更した内容がOpenTP1に反映されます。dcresetコマンドで定義を変更する場合は，OpenTP1正常終了後に実行してください。OpenTP1オンライン中に実行すると，システムダウンします。

dcresetコマンドを使用する場合は，dcsetup -dとdcsetupコマンドを実行（定義の削除と登録）する必要はありません。スーパユーザがシステム共通定義の変更内容をOpenTP1に反映する場合に，dcsetup -dとdcsetupコマンドを実行します。

1.4　TP1/Message Control実行のための準備

TP1/Message Controlは，OpenTP1プロセスサービスによって起動されます。TP1/Message Controlの通信サービスを起動するためには，ユーザがMCFメイン関数をコーディングする必要があります。

ここでは，TP1/Message Controlを実行するためにユーザが準備することを説明します。なお，以降TP1/Message Controlを「MCF」と呼びます。

＜この節の構成＞

1.4.1　MCF通信サービスのMCFメイン関数の作成方法

1.4.2　アプリケーション起動サービスのMCFメイン関数の作成方法

1.4.3　MCFメイン関数のディレクトリへの組み込み

1.4.4　MCFサービス名の登録

1.4.5　システムサービス情報定義ファイルの作成

1.4.6　定義オブジェクトファイルの作成

1.4.7　コマンドログ取得のための準備

1.4.1　MCF通信サービスのMCFメイン関数の作成方法

プロトコルごとのメッセージ送受信機能を使用する場合，MCF通信サービス用のMCFメイン関数をコーディングし，コンパイルおよびリンケージしてください。

MCFメイン関数ではスタート関数（dc_mcf_svstart）を発行します。

UOCを使用する場合は，MCFメイン関数でUOCの関数アドレスを指定してください。UOCは，MCFメイン関数と同じ言語（K&R版 C，ANSI C，またはC++）で作成してください。

なお，TP1/NET/XMAP3プロトコル使用時は，UOC内で使用するマッピングサービスを，あらかじめMCFメイン関数で開始しておく必要があります。マッピングサービスの開始については，マニュアル「OpenTP1 プロトコル TP1/NET/XMAP3編」を参照してください。

プロトコルとUOCを定義するMCFメイン関数のコーディング概要を図1-5と図1-6に示します。

図1-5　プロトコルとUOCを定義するMCFメイン関数のコーディング概要（ANSI CとC++の場合）

プロトコル提供ヘッダファイルを取り込みます。
dcm××××.hの××××はプロトコルごとに変わります。各プロトコルのマニュアルを参照してください。

使用するUOCの関数をextern宣言します。UOCのリターン値はDCLONG型にしてください。
これらのUOCを使用する場合だけコーディングしてください。

UOCテーブルをextern宣言します。
2のUOCを使用する場合だけコーディングしてください。

各UOCの関数アドレスを，次に示すシステム提供変数に設定します。
dcmcf_uoctbl.msgrcv /*入力メッセージ編集UOCアドレス*/
dcmcf_uoctbl.msgsend /*出力メッセージ編集UOCアドレス*/
これらのUOCを使用する場合だけコーディングしてください。

スタート関数を発行します。必ずコーディングしてください。

図1-6　プロトコルとUOCを定義するMCFメイン関数のコーディング概要（K&R版 Cの場合）

プロトコル提供ヘッダを取り込みます。
dcm××××.hの××××はプロトコルごとに変わります。各プロトコルのマニュアルを参照してください。

使用するUOCの関数をextern宣言します。UOCのリターン値はDCLONG型にしてください。
これらのUOCを使用する場合だけコーディングしてください。

UOCテーブルをextern宣言します。
2のUOCを使用する場合だけコーディングしてください。

各UOCの関数アドレスを，次に示すシステム提供変数に設定します。
dcmcf_uoctbl.msgrcv /*入力メッセージ編集UOCアドレス*/
dcmcf_uoctbl.msgsend /*出力メッセージ編集UOCアドレス*/
これらのUOCを使用する場合だけコーディングしてください。

スタート関数を発行します。必ずコーディングしてください。

1.4.2　アプリケーション起動サービスのMCFメイン関数の作成方法

アプリケーション起動機能とMCFイベント処理用MHPを使用する場合，プロトコル用とは別に，アプリケーション起動サービス用にMCFメイン関数をコーディングし，コンパイルおよびリンケージしてください。

MCFメイン関数ではスタート関数（dc_mcf_svstart）を発行します。

タイマ起動引き継ぎ決定UOCを使用する場合は，アプリケーション起動サービス用のメイン関数で，タイマ起動引き継ぎ決定UOCのアドレスを指定してください。タイマ起動引き継ぎ決定UOCは，MCFメイン関数と同じ言語（K&R版 C，ANSI C，またはC++）で作成してください。タイマ起動引き継ぎ決定UOCについては，マニュアル「OpenTP1 プログラム作成リファレンス C言語編」を参照してください。

アプリケーション起動サービス用のMCFメイン関数のコーディング概要を図1-7と図1-8に示します。

図1-7　アプリケーション起動サービス用のMCFメイン関数のコーディング概要（ANSI CとC++の場合）

アプリケーション起動サービス提供のヘッダファイルを取り込みます。

使用するUOCの関数をextern宣言します。UOCのリターン値はDCLONG型にしてください。
タイマ起動引き継ぎ決定UOCを使用する場合だけコーディングしてください。

UOCテーブルをextern宣言します。
タイマ起動引き継ぎ決定UOCを使用する場合だけコーディングしてください。

タイマ起動引き継ぎ決定UOCの関数アドレスを，次に示すシステム提供変数に設定します。
dcmcf_uoctbl.rrntime /*タイマ起動引き継ぎ決定UOCアドレス*/
タイマ起動引き継ぎ決定UOCを使用する場合だけコーディングしてください。

スタート関数を発行します。必ずコーディングしてください。

図1-8　アプリケーション起動サービス用のMCFメイン関数のコーディング概要（K&R版 Cの場合）

アプリケーション起動サービス提供のヘッダファイルを取り込みます。

使用するUOCの関数をextern宣言します。UOCのリターン値はDCLONG型にしてください。
タイマ起動引き継ぎ決定UOCを使用する場合だけコーディングしてください。

UOCテーブルをextern宣言します。
タイマ起動引き継ぎ決定UOCを使用する場合だけコーディングしてください。

タイマ起動引き継ぎ決定UOCの関数アドレスを，次に示すシステム提供変数に設定します。
dcmcf_uoctbl.rrntime /*タイマ起動引き継ぎ決定UOCアドレス*/
タイマ起動引き継ぎ決定UOCを使用する場合だけコーディングしてください。

スタート関数を発行します。必ずコーディングしてください。

1.4.3　MCFメイン関数のディレクトリへの組み込み

MCFメイン関数のディレクトリへの組み込み方法の概要を次の図に示します。

図1-9　MCFメイン関数のディレクトリへの組み込み方法の概要

注※

MCF実行形式プログラム名は，先頭がmcfuで始まる8文字以内の名称を指定してください。

1.4.4　MCFサービス名の登録

MCFを実行するために，MCFサービス名をシステムサービス構成定義で定義しておく必要があります。

MCFサービス名はMCFマネジャ定義オブジェクトファイル名と一致させてください。

1.4.5　システムサービス情報定義ファイルの作成

システムサービス情報定義ファイルをOSのテキストエディタで作成します。作成するファイルのパス名は，「$DCDIR/lib/sysconf/システムサービス情報定義ファイル名」としてください。

定義形式を次に示します。

set module = "MCF実行形式プログラム名"
set fixpriority = 52

module

ユーザが作成したMCF通信サービス，またはアプリケーション起動サービスのMCF実行形式プログラム名を指定します。

MCF実行形式プログラム名は，先頭がmcfuで始まる8文字以内の名称としてください。

fixpriority

OSの固定プロセス実行優先度として52を指定します。

1.4.6　定義オブジェクトファイルの作成

定義オブジェクトファイルを次の手順で作成します。

ただし，開始から再開始の間に定義オブジェクトファイルを変更してはなりません。変更した場合，再開始の動作は保証できません。

OSのテキストエディタを使用して，MCFの定義ファイルから，次に示す定義ソースファイルを作成します。

MCFマネジャ定義ソースファイル

MCF通信構成定義の共通定義ソースファイル

MCF通信構成定義のデータコミュニケーション定義ソースファイル

MCFアプリケーション定義ソースファイル

MCF定義オブジェクト生成ユティリティを使用して，定義ソースファイルから，次に示すオブジェクトファイルを作成します。

MCFマネジャ定義オブジェクトファイル

MCF通信構成定義の共通定義オブジェクトファイル

MCF通信構成定義のデータコミュニケーション定義オブジェクトファイル

MCFアプリケーション定義オブジェクトファイル

MCF定義結合ユティリティを使用して，MCF通信構成定義の，共通定義とデータコミュニケーション定義のオブジェクトファイルを結合します。

定義オブジェクトファイルの作成方法の概要を次の図に示します。

図1-10　定義オブジェクトファイルの作成方法の概要

注※1

次に示すコマンドで生成します。

mcf××××△-i△〔パス名〕入力ファイル名△-o△〔パス名〕出力オブジェクトファイル名

mcf××××は，ソースファイルごとに異なります。

mcfmngr：MCFマネジャ定義ソースファイル

mcfcomn：MCF通信構成定義ソースファイル

mcfosua：MCF通信構成定義のTP1/NET/User Agentプロトコル固有定義ソースファイル

mcftcp：MCF通信構成定義のTP1/NET/TCP/IPプロトコル固有定義ソースファイル

mcfostp：MCF通信構成定義のTP1/NET/OSI-TPプロトコル固有定義ソースファイル

mcfxp：MCF通信構成定義のTP1/NET/XMAP3プロトコル固有定義ソースファイル

mcfosnf：MCF通信構成定義のTP1/NET/OSAS-NIFプロトコル固有定義ソースファイル

mcfhdlcs：MCF通信構成定義のTP1/NET/HDLCプロトコル固有定義ソースファイル

mcfhsc1：MCF通信構成定義のTP1/NET/HSCプロトコル固有定義ソースファイル（HSC1手順の場合）

mcfhsc2：MCF通信構成定義のTP1/NET/HSCプロトコル固有定義ソースファイル（HSC2手順の場合）

mcfx25：MCF通信構成定義のTP1/NET/X25プロトコル固有定義ソースファイル

mcfhnanf：MCF通信構成定義のTP1/NET/HNA-NIFプロトコル固有定義ソースファイル

mcfslup2：MCF通信構成定義のTP1/NET/Secondary Logical Unit - TypeP2プロトコル固有定義ソースファイル

mcfncsb：MCF通信構成定義のTP1/NET/NCSBプロトコル固有定義ソースファイル

mcfhna560：MCF通信構成定義のTP1/NET/HNA-560/20プロトコル固有定義ソースファイル

mcfapli：MCFアプリケーション定義ソースファイル

mcfslup1：MCF通信構成定義のTP1/NET/Secondary Logical Unit - TypeP1プロトコル固有定義ソースファイル

mcfx25ex：MCF通信構成定義のTP1/NET/X25-Extendedプロトコル固有定義ソースファイル

mcfhna56s：MCF通信構成定義のTP1/NET/HNA-560/20 Data Transportation Supportプロトコル固有定義ソースファイル

注※2

次に示すコマンドで，MCF通信構成定義の二つのオブジェクトファイルを結合します。

mcflink△-i△共通定義オブジェクトファイル名△データコミュニケーション定義オブジェクトファイル名△-o△出力オブジェクトファイル名

1.4.7　コマンドログ取得のための準備

MCF関連の運用コマンドのコマンドログを取得するためには環境変数を設定する必要があります。環境変数の設定についての詳細は，「3.6.2(2)　コマンドログの取得方法」を参照してください。

2.　OpenTP1の開始と終了

OpenTP1の開始方法と終了方法について説明します。

＜この章の構成＞

2.1　開始

2.2　終了

2.1　開始

OpenTP1の開始方法と開始モードについて説明します。

＜この節の構成＞

2.1.1　開始方法

2.1.2　開始モード

2.1.3　開始方法の決定

2.1.4　開始形態の決定

2.1.1　開始方法

OpenTP1の開始方法には，次の二つがあります。

自動開始
自動的に開始する方法です。

手動開始
OpenTP1の開始コマンド（dcstart）を入力して開始する方法です。

2.1.2　開始モード

OpenTP1の開始モードには，次の二つがあります。

正常開始
前回のオンラインが正常に終了して引き継ぐ情報がないとき，または新たにOpenTP1を開始するときのモードです。

全面回復による再開始
前回のオンラインの終了状態を引き継いで開始するときのモードです。
以降「再開始」と呼びます。

2.1.3　開始方法の決定

開始方法は，システム環境定義（mode_conf）の指定内容によって決まります。

＜この項の構成＞

(1)　システム環境定義でAUTOを指定

(2)　システム環境定義でMANUAL1を指定

(3)　システム環境定義でMANUAL2を指定

(1)　システム環境定義でAUTOを指定

開始方法は自動開始になります。

(2)　システム環境定義でMANUAL1を指定

開始方法は手動開始になります。

ただし，前回のOpenTP1が異常終了の場合は自動的に再開始します。

(3)　システム環境定義でMANUAL2を指定

開始方法は手動開始になります。

2.1.4　開始形態の決定

開始方法と開始モードの組み合わせを開始形態といいます。

開始形態は，前回の終了モードとシステム環境定義（mode_conf）の指定内容によって決定されます。

開始形態の決定を次の表に示します。

表2-1　開始形態の決定

開始形態決定の条件 | 開始形態
前回の終了モード | mode_confの指定値 | 開始方法 | 開始モード
正常終了 | AUTO | 手動※¹ | 正常開始
MANUAL1 | 手動
MANUAL2
強制正常終了 | AUTO | 手動※¹ | 正常開始
MANUAL1 | 手動
MANUAL2
計画停止A | AUTO | 手動※¹ | 再開始
MANUAL1 | 手動 | 再開始※²
MANUAL2
計画停止B | AUTO | 手動※¹ | 再開始
MANUAL1 | 手動 | 再開始※²
MANUAL2
強制停止 | AUTO | 手動※¹ | 再開始
MANUAL1 | 手動 | 再開始※²
MANUAL2
異常終了 | AUTO | 自動 | 再開始
MANUAL1 | 自動※³
MANUAL2 | 手動 | 再開始※²

注※1

OS起動時は自動開始となります。

注※2

dcstart -nコマンドで強制的に正常開始することもできます。ただし，強制的に正常開始すると前回仕掛り中の情報は失われます。

注※3

OS起動時は手動開始となります。

また，MCF構成変更再開始を使用する場合の開始形態については，「5.10.3(2)　MCF構成変更再開始機能によるOpenTP1の再開始」を参照してください。

2.2　終了

OpenTP1の終了モードと終了方法について説明します。

＜この節の構成＞

2.2.1　終了モード

2.2.2　終了方法

2.2.3　注意事項

2.2.1　終了モード

OpenTP1の終了モードについて説明します。

＜この項の構成＞

(1)　正常終了

(2)　強制正常終了

(3)　計画停止A

(4)　計画停止B

(5)　MCF構成変更準備停止

(6)　強制停止

(7)　異常終了

(1)　正常終了

新しいサービス要求の受け付けを禁止し，スケジュールキュー上のすべてのサービス要求の処理完了後，OpenTP1が終了します。

MCFを使用している場合，入力キュー，および出力キュー上のすべてのメッセージの処理が完了後，OpenTP1は終了します。このため，正常終了の際，MCFは滞留メッセージが0件になるのを，入力キュー，出力キューの順番で監視します。監視時間は，MCF通信構成定義のタイマ定義（mcfttim）で指定します。

キューを監視している間，一定間隔でログメッセージ（KFCA16532-I～KFCA16537-I）が出力されます。ただし，このログメッセージは，MCFマネジャ定義のログメッセージ出力抑止定義（mcfmsmsg）で出力を抑止できます。

正常終了中に，入力キュー，出力キューに対して，新たなメッセージの入力が連続して（または断続的に）発生すると，「正常終了が終わらない」，「OpenTP1システムがダウンする」，「ERREVTAが起動される」という事象を発生させる場合があるので，ご注意ください。

(2)　強制正常終了

運用中に異常終了したサーバがあっても，(1)の正常終了と同じように，新しいサービス要求の受け付けを禁止し，スケジュールキュー上のすべてのサービス要求の処理完了後，OpenTP1が終了します。

この終了モードは，運用中にUAPなどのサーバが異常終了しても，システムは正常に終了できます。

また，強制正常終了のあとは正常開始になるため，前回のオンラインの状態は引き継ぎません。

(3)　計画停止A

新しいサービス要求の受け付けを禁止し，スケジュールキュー上のすべてのサービス要求の処理を完了したあと，OpenTP1が終了します。

MCFを使用している場合，入力キュー上の未処理メッセージはすべて処理されます。このため，計画停止Aの際，MCFは，入力キュー上の滞留メッセージが0件になるまで監視します。監視時間は，MCF通信構成定義のタイマ定義（mcfttim）で指定します。

キューを監視している間，一定間隔でログメッセージ（KFCA16532-I，KFCA16533-I，KFCA16536-I，KFCA16537-I）が出力されます。ただし，このログメッセージは，MCFマネジャ定義のログメッセージ出力抑止定義（mcfmsmsg）で出力を抑止できます。

計画停止A中に，入力キューに対して，新たなメッセージの入力が連続して（または断続的に）発生すると，「計画停止Aが終わらない」，「OpenTP1システムがダウンする」という事象を発生させる場合があるので，ご注意ください。

なお，出力キュー上の未送信メッセージは残ります。

オンラインを停止する時間になっても出力キュー上のメッセージを処理しきれなかった場合には，計画停止AでOpenTP1を終了させます。

(4)　計画停止B

現在実行しているサービスの完了を待って，OpenTP1が終了します。

スケジュールサービスは新しいサービス要求の受け付けを禁止し，現在処理中のサービス要求だけを処理します。その他のサービス要求はすべて破棄されます。

MCFを使用している場合，メモリキューの入力キュー，および出力キュー上のメッセージは破棄されます。ディスクキューの入力キュー上の未処理メッセージ，および出力キュー上の未送信メッセージは残ります。

(5)　MCF構成変更準備停止

終了モードMCF構成変更準備停止については，「5.10.3(1)　MCF構成変更再開始機能によるOpenTP1の終了」を参照してください。

(6)　強制停止

現在実行しているサービスの完了を待たないで，OpenTP1が直ちに終了します。

スケジュールキュー上のサービス要求はすべて破棄されます。

MCFを使用している場合，メモリキューの入力キュー，および出力キュー上のメッセージは破棄されます。ディスクキューの入力キュー上の未処理メッセージ，および出力キュー上の未送信メッセージは残ります。

(7)　異常終了

何らかの異常が発生すると，OpenTP1が全面停止します。

スケジュールキュー上のサービス要求はすべて破棄されます。

MCFを使用している場合，メモリキューの入力キュー，および出力キュー上のメッセージは破棄されます。ディスクキューの入力キュー上の未処理メッセージ，および出力キュー上の未送信メッセージは残ります。

終了モードによるスケジュールキュー上のサービス要求，および入出力キュー上のメッセージの扱いを次の表に示します。

表2-2　スケジュールキュー上のサービス要求，および入出力キュー上のメッセージの扱い

終了モード | スケジュールキュー上のサービス要求 | 入力キュー上のメッセージ | 出力キュー上のメッセージ
ディスク | メモリ | ディスク | メモリ
正常終了 | ○ | ○ | ○ | ○ | ○
強制正常終了 | ○ | ○ | ○ | ○ | ○
計画停止A | ○ | ○ | ○ | △ | ×
計画停止B | × | △ | × | △ | ×
MCF構成変更準備停止 | × | △ | × | △ | ×
強制停止 | × | △ | × | △ | ×

（凡例）

○：すべて処理します。

△：残ります。

×：すべて破棄します。

2.2.2　終了方法

OpenTP1への終了要求は，運用コマンドで行います。

終了モードと運用コマンドを次に示します。

正常終了：dcstopコマンド

強制正常終了：dcstop -nコマンド

計画停止A：dcstop -aコマンド

計画停止B：dcstop -bコマンド

MCF構成変更準備停止：dcstop -b -qコマンド※

強制停止：dcstop -fコマンド

注※

MCF構成変更準備停止を使用するためには，TP1/Message Control - Extension 1が必要です。

なお，強制停止した場合に，仕掛り状態を引き継ぐ必要があるときは次回のOpenTP1を再開始してください。引き継ぐ必要がないときは正常開始してください。

2.2.3　注意事項

OpenTP1のシステムサービスをkillコマンドで直接停止させると，OpenTP1は異常終了します。

3.　OpenTP1オンラインの運用

OpenTP1の正常時の運用方法について説明します。

＜この章の構成＞

3.1　サーバに関する運用

3.2　スケジュールに関する運用

3.3　トランザクションに関する運用

3.4　排他に関する運用

3.5　標準出力ファイルに関する運用

3.6　ログ機能

3.7　監査ログの運用

3.8　トレースに関する運用

3.9　共用メモリに関する運用

3.10　OpenTP1のドメインに関する運用

3.11　ノード自動追加機能を使用する運用

3.12　TP1/NET/OSI-TP-Extendedを使用する運用

3.13　リモートAPI機能を使用する運用

3.14　OpenTP1の連続運転に関する運用

3.15　XAリソースサービスを使用する運用

3.16　JP1連携時の運用

3.17　リアルタイム統計情報サービスを使用する運用

3.1　サーバに関する運用

＜この節の構成＞

3.1.1　ユーザサーバの開始

3.1.2　ユーザサーバの終了

3.1.3　サーバの状態表示

3.1.4　ユーザサーバ，およびユーザサーバから起動されるコマンドのサーチパス

3.1.5　ユーザサーバの入れ替え

3.1.6　ユーザサーバのプロセス

3.1.1　ユーザサーバの開始

ユーザサーバは，サーバ単位に開始できます。オンライン中の開始もできます。

ユーザサーバの開始方法には，次の二つがあります。

ユーザサービス構成定義に従って，OpenTP1開始時に開始します。
この場合，システムサービス構成定義でuap_confを指定しておく必要があります。

オンライン中に運用コマンド（dcsvstart -u）を入力して開始します。

ユーザサーバの開始を次の図に示します。

図3-1　ユーザサーバの開始

3.1.2　ユーザサーバの終了

＜この項の構成＞

(1)　終了モード

(2)　終了方法

(3)　ユーザサーバの終了形態とOpenTP1全体の終了形態との関係

(4)　ユーザサーバ（MHP）終了状態でのアプリケーション起動要求の扱いについて

(5)　注意事項

(1)　終了モード

ユーザサーバは，サーバ単位に終了できます。

ユーザサーバの終了モードには次の二つがあります。

正常終了
新しいメッセージの受け付けは禁止され，スケジュールキュー上のすべてのサービス要求の処理が完了後，ユーザサーバは終了します。

強制停止
ユーザサーバをすぐに停止します。
スケジュールキュー上のサービス要求は破棄され，応答待ち状態のクライアントにエラーリターンします。

(2)　終了方法

ユーザサーバの終了は，運用コマンドを使用してOpenTP1へ要求します。

終了モードと運用コマンドを次に示します。

正常終了：dcsvstopコマンド

強制停止：dcsvstop -fコマンド

(3)　ユーザサーバの終了形態とOpenTP1全体の終了形態との関係

ユーザサーバを強制停止すると，OpenTP1は正常終了できません。

ユーザサーバを再開始し，正常終了させたあと，OpenTP1を正常終了するか，またはOpenTP1を正常終了以外（強制正常終了，計画停止A，計画停止B，強制停止）で終了させてください。

(4)　ユーザサーバ（MHP）終了状態でのアプリケーション起動要求の扱いについて

アプリケーションの起動要求が発生したとき，該当するMHPが開始されていない状態，または正常終了・強制停止している状態であった場合，その起動要求は次のように扱われます。

メッセージ受信による起動要求：ERREVT2を起動

UAPからの関数発行による起動要求：ERREVT2を起動（ただしタイマ起動の場合は，ERREVT4を起動）

MCFイベント発生によるMCFイベント処理用アプリケーション起動要求：廃棄

(5)　注意事項

ユーザサーバをkillコマンドで直接停止させると，OpenTP1が異常終了することがあります。

3.1.3　サーバの状態表示

ユーザサーバ，およびシステムサービスの状態を，prclsコマンドで表示できます。表示内容はサーバの状態，プロセスIDなどです。

3.1.4　ユーザサーバ，およびユーザサーバから起動されるコマンドのサーチパス

＜この項の構成＞

(1)　サーチパス名の表示と変更

(2)　サーチパスの引き継ぎ

(3)　注意事項

(1)　サーチパス名の表示と変更

OpenTP1がユーザサーバを開始するときに使用するサーチパスは，prcpathlsコマンドで表示できます。

また，サーチパスはprcpathコマンドで変更できます。

(2)　サーチパスの引き継ぎ

プロセスサービス定義でprc_take_over_svpath=Yを指定すると，再開始時にサーチパスを引き継ぐことができます。ただし，次の場合はprc_take_over_svpath=Yを指定しても，パスは引き継ぎません。

系切り替えが発生した場合

前回のオンライン中にサーチパスの保存に失敗した場合

ファイルからのサーチパスの回復に失敗した場合

(3)　注意事項

サーチパスに指定したディレクトリ間で，コマンド名が重複しないように注意してください。コマンド名が重複している場合，正しいコマンドが起動しないで別のコマンドが起動することがあります。また，コマンド名は，OpenTP1が提供するコマンド群（$DCDIR/binの下）のコマンド名とも重複しないようにしてください。

3.1.5　ユーザサーバの入れ替え

OpenTP1実行中にユーザサーバを入れ替えることができます。

＜この項の構成＞

(1)　サービス提供プログラム（SPP）の場合

(2)　メッセージ処理プログラム（MHP）の場合

(1)　サービス提供プログラム（SPP）の場合

次の手順でユーザサーバを入れ替えてください。

ユーザサーバをdcsvstopコマンドで終了します。

ユーザサーバを入れ替えます。必要ならユーザサービス定義も入れ替えます。

入れ替えたユーザサーバをdcsvstartコマンドで開始します。

現在稼働中のユーザサーバがあるディレクトリとは別のディレクトリ下に，新しいユーザサーバを作ることもできます。この場合，次の手順で実行してください。

ユーザサーバをdcsvstopコマンドで終了します。

別のディレクトリ下にユーザサーバを設定します。

prcpathコマンドで新しいディレクトリにパスを変更します。

新しいユーザサーバをdcsvstartコマンドで開始します。

ただし，dcstartコマンドでOpenTP1を再開始すると，元のユーザサーバに戻ります。

(2)　メッセージ処理プログラム（MHP）の場合

サービスグループ単位に，実行中のMHPを入れ替えることができます。

次の手順で入れ替えてください。

ユーザサーバ（サービスグループ）のスケジュールをmcftdctsgコマンドで閉塞します。または，入力キューをmcfthldiqコマンドで保留します。

ユーザサーバをdcsvstopコマンドで終了します。

ユーザサーバを入れ替えます。

入れ替えたユーザサーバをdcsvstartコマンドで再開始します。

入れ替えたユーザサーバ（サービスグループ）のスケジュールをmcftactsgコマンドで閉塞解除します。または，入力キューの保留をmcftrlsiqコマンドで解除します。

ユーザサーバ（サービスグループ）のスケジュールを閉塞している間に発生した起動要求は，ディスクキューの場合，閉塞解除後に再スケジュールされます。メモリキューの場合は，すでにスケジュールされたものを含めて，エラーイベントとなります。

また，スケジュールの閉塞（mcftdctsgコマンド）または入力キューの保留（mcfthldiqコマンド）実行時に，-rオプションを指定すると，全面回復時には閉塞状態や保留状態は引き継がれません。

3.1.6　ユーザサーバのプロセス

＜この項の構成＞

(1)　プロセスの終了

(1)　プロセスの終了

ユーザサーバのプロセスを強制停止する場合は，dcsvstop -fコマンドを使用してユーザサーバを強制停止してプロセスを強制停止します。この場合，ユーザサーバのすべてのプロセスが強制停止します。

特定プロセスだけを強制停止する場合は，prckillコマンドを使用します。

prckillコマンドは，ユーザサービス定義，またはユーザサービスデフォルト定義のprc_abort_signalオペランドで指定した，シグナル番号でプロセスを強制停止します。

3.2　スケジュールに関する運用

＜この節の構成＞

3.2.1　スケジュールの状態表示

3.2.2　スケジュールの閉塞，および再開始

3.2.3　スケジュールの自動閉塞

3.2.4　ノード間負荷バランス

3.2.5　プロセス数の変更

3.2.6　スケジュールキューの監視

3.2.7　スケジュールキューの滞留監視

3.2.8　ユーザサーバプロセスのリフレッシュ機能

3.2.1　スケジュールの状態表示

次のような場合，scdlsコマンドでスケジュールサービス下で動作するサーバのスケジュール状態，またはサービスの状態を表示できます。

サーバの状態を知りたいとき

現在のスケジュールキューの状態を知りたいとき

サービス要求のキューイング数を知りたいとき

サービスごとの閉塞状況を知りたいとき（ユーザサービス定義でservice_hold=Yと指定している場合）

表示内容は，スケジュールサービス下で動作するサーバの数，サーバ名，現在のサービス要求キューイング数などです。

3.2.2　スケジュールの閉塞，および再開始

ユーザサーバに障害が発生したり，実行形式ファイルの入れ替えなどでユーザサーバのスケジュールを停止したいときには，scdholdコマンドでスケジュールを閉塞します。ユーザサービス定義でservice_hold=Yと指定しておくと，サービス単位にスケジュールを閉塞できます。ただし，MHP，およびシステムサービスに対するスケジュールの閉塞はできません。MHPのスケジュールはmcftdctsvコマンドで閉塞してください。

スケジュールを閉塞すると，それ以降に発生したサービス要求，およびスケジュールキュー上のサービス要求はエラーリターンされます。ただし，-pオプション指定のscdholdコマンドを実行すると，スケジュールキュー上のサービス要求はスケジュールを再開始するまで保持されます。また，スケジュール閉塞以降に発生したサービス要求も受け付けられます。

scdholdコマンドで閉塞したスケジュールは，scdrlesコマンドで再開始できます。

再開始時に，スケジュールの閉塞状態を引き継げます。そのためには，ユーザサービス定義で次の指定をしてください。

receive_from=queue

hold_recovery=Y

なお，ユーザサービス定義の指定によってもスケジュールは閉塞します。スケジュールを閉塞する指定と条件を次に示します。

hold=Yと指定し，ユーザサーバが1回異常終了したとき

term_watch_timeオペランドを指定し，指定した時間内に連続して3回ユーザサーバが異常終了したとき

3.2.3　スケジュールの自動閉塞

＜この項の構成＞

(1)　異常終了時のメッセージ

(2)　サービスグループ自動閉塞後に到着したメッセージ

(3)　アプリケーション閉塞とサービス閉塞のメッセージ

(1)　異常終了時のメッセージ

MHPが異常終了した場合，サービスグループのスケジュールを自動閉塞して，異常終了したMHPの受信メッセージをスケジュールキューの先頭に再スケジュールできます。ただし，全面回復時には，MHPの受信メッセージは再スケジュールされません。

アプリケーション属性定義では，次のように指定してください。

  mcfaalcap -g srvghold  = s
               recvmsg   = r
            -d holdlimit = 1

サービスグループのスケジュール自動閉塞の指定の組み合わせによって，異常終了したMHPのメッセージの扱いが異なります。次の表に異常終了時のメッセージの扱いを示します。

表3-1　異常終了時のメッセージの扱い

アプリケーション属性定義の指定
メモリキュー
ディスクキュー

サービスグループスケジュール自動閉塞指定あり
（srvghold=s）
再スケジュール指定あり
（recvmsg=r）
異常限界回数に達している
ERREVT2※¹
スケジュール待ち状態※²

異常限界回数に達していない
ERREVT2またはERREVT3
ERREVT2またはERREVT3

再スケジュール指定なし
（recvmsg=e，または省略）
ERREVT2またはERREVT3
ERREVT2またはERREVT3

サービスグループスケジュール自動閉塞指定なし（srvghold=m，または省略）
ERREVT2またはERREVT3
ERREVT2またはERREVT3

注※1

メモリキューはため込みません。

注※2

スケジュールキューの先頭にスケジュールされます。

(2)　サービスグループ自動閉塞後に到着したメッセージ

サービスグループのスケジュールが自動閉塞した前後に，到着したメッセージの扱いを表3-2と表3-3に示します。

表3-2　ディスクキューのメッセージの扱い

閉塞種別 | タイミング
閉塞前に到着して入力キューに登録しているメッセージ | 閉塞後に到着したメッセージ
入力とスケジュールの閉塞 | スケジュール待ち状態になる。閉塞解除後にMHPを起動する。 | ERREVT2に対応する入力キューに登録する。
入力の閉塞 | MHPを起動する。 | ERREVT2に対応する入力キューに登録する。
スケジュールの閉塞 | スケジュール待ち状態になる。閉塞解除後にMHPを起動する。 | 入力キューに登録してスケジュール待ち状態になる。

表3-3　メモリキューのメッセージの扱い

閉塞種別 | タイミング
閉塞前に到着して入力キューに登録しているメッセージ | 閉塞後に到着したメッセージ
入力とスケジュールの閉塞 | ERREVT2に対応する入力キューに再度登録する。 | ERREVT2に対応する入力キューに登録する。
入力の閉塞 | MHPを起動する。 | ERREVT2に対応する入力キューに登録する。
スケジュールの閉塞 | ERREVT2に対応する入力キューに再度登録する。 | ERREVT2に対応する入力キューに登録する。

(3)　アプリケーション閉塞とサービス閉塞のメッセージ

アプリケーション閉塞やサービス閉塞をしたメッセージの扱いを表3-4と表3-5に示します。

表3-4　アプリケーション閉塞のメッセージの扱い

閉塞種別 | タイミング
閉塞前に到着して入力キューに登録しているメッセージ | 閉塞後に到着したメッセージ
入力とスケジュールの閉塞 | ERREVT2に対応する入力キューに再度登録する。 | ERREVT2に対応する入力キューに登録する。
入力の閉塞 | MHPを起動する。 | ERREVT2に対応する入力キューに登録する。
スケジュールの閉塞 | ERREVT2に対応する入力キューに再度登録する。 | ERREVT2に対応する入力キューに登録する。

表3-5　サービス閉塞のメッセージの扱い

閉塞種別 | タイミング
閉塞前に到着して入力キューに登録しているメッセージ | 閉塞後に到着したメッセージ
入力とスケジュールの閉塞 | ERREVT2に対応する入力キューに再度登録する。 | ERREVT2に対応する入力キューに登録する。
入力の閉塞 | MHPを起動する。 | ERREVT2に対応する入力キューに登録する。
スケジュールの閉塞 | ERREVT2に対応する入力キューに再度登録する。 | ERREVT2に対応する入力キューに登録する。

3.2.4　ノード間負荷バランス

OpenTP1は，サービス要求処理の負荷を分散して各ノードに振り分けています。

この負荷分散をノード間負荷バランスといいます。

＜この項の構成＞

(1)　ノード間負荷バランス機能の前提条件

(2)　ノード間負荷バランス機能の運用形態

(3)　負荷状態の参照

(4)　自ノードの優先

(5)　ノード間負荷バランスとほかの機能との組み合わせ

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

(1)　ノード間負荷バランス機能の前提条件

ノード間負荷バランス機能を使用するには，次の条件を満たしている必要があります。

複数のノードに同一のサービスを提供するユーザサーバが起動されている

各OpenTP1ノード間は，システム共通定義のall_nodeオペランドに自分以外のノードを定義することで，お互いのOpenTP1ノードで起動されているユーザサーバの情報（ネーム情報）をやり取りしている

注

ノード間負荷バランス機能は，ノード間でユーザサーバの動作条件がほぼ同じであることを前提としています。選択されるノードによって次に示す条件が大きく異なる場合は，ノード間負荷バランス機能に不適当な環境ですので，同じ名前のサービスグループを複数のノードに配置しないでください。

公衆回線の回線料金などの通信コスト

回線速度

回線品質

ノードの単体性能

(2)　ノード間負荷バランス機能の運用形態

ノード間負荷バランス機能を使用する際の運用形態には，次の二つがあります。

サーバ側の判断でノード間負荷バランスを行う

サーバ側（TP1/Server Base）のスケジューラが，より負荷レベルの低いノードへ要求を転送し，処理を実行します。

サーバからの負荷情報を基にクライアント側の判断でノード間負荷バランスを行う

この形態では，クライアントとして使用しているプログラムによって処理が異なります。

クライアントにTP1/Client/PまたはTP1/Client/Wを使用
クライアント側（TP1/Client/PまたはTP1/Client/W）は，サーバ側から得たサーバの負荷レベルの情報を基に，クライアント側でサービス要求を行うOpenTP1ノードを決めてからRPCを行います。

クライアントにTP1/Server Baseを使用
クライアント側（TP1/Server Base）は，これから要求を出そうとしているサーバの負荷レベルをすでに知っているため，最初から負荷レベルの低いノードに対してRPCを行います。要求を受け取った時点で，スケジューラは負荷レベルの評価による転送はしないで，自ノードで要求を処理できる状態であれば自ノードで処理し，サーバが閉塞しているとき，および，自ノードのサーバの負荷レベルがLEVEL2で，他ノードに負荷レベルの低いサーバがあるときだけ，ほかのノードに対して処理要求を転送します。

ノード間負荷バランスを使用する場合は，次のように定義します。

表3-6　ノード間負荷バランスを使用する場合の定義

ノード間負荷バランスの運用形態
種別
定義内容

サーバ側の判断で負荷分散を行う
サーバ
（TP1/Server Base）
スケジュールサービス定義

set scd_this_node_first = N(デフォルト)

set scd_announce_server_status = Y(デフォルト)

クライアント
（TP1/Client/P，TP1/Client/W）
クライアント環境定義

dcscddirect = Y(TP1/Client/Pの場合)

dchostselect = Y(スケジュールの依頼をランダムに変更したい場合だけ)

クライアント側の判断で負荷分散を行う
（クライアントにTP1/Client/P，TP1/Client/Wを使用）
サーバ
（TP1/Server Base）
スケジュールサービス定義

scd_this_node_first=N(デフォルト)

scd_announce_server_status=Y(デフォルト)

クライアント
（TP1/Client/P，TP1/Client/W）
クライアント環境定義

dccltloadbalance = Y

dccltcachetim = xx(秒)

クライアント側の判断で負荷分散を行う
（クライアントにTP1/Server Baseを使用）
サーバ
（TP1/Server Base）
スケジュールサービス定義

scd_this_node_first=N(デフォルト)

scd_announce_server_status=Y(デフォルト)

クライアント
（TP1/Server Base）

(3)　負荷状態の参照

スケジュールサービス定義でscd_announce_server_status=Yを指定すると，OpenTP1は，30秒以上の任意の間隔でサーバの負荷状態をすべてのノードに通知します。OpenTP1は，サービス要求処理をサーバの負荷状態に応じたノードを選択してスケジュールします。

scd_announce_server_status=Nを指定した場合は，サーバの負荷状態はほかのノードに通知されません。したがって，OpenTP1はランダムにノードを選択してサーバをスケジュールします。

scd_announce_server_statusオペランドの指定は，分散環境を構成するすべてのノードで同じにしてください。指定が異なると，特定のノードに負荷が集中します。

次に示す両方の条件に該当する場合は，scd_announce_server_status=Nを指定してください。

同一サービスグループが複数ノードに存在しない環境

通信コストの掛かる回線を使用しているなどの理由で，できるだけ通信をしたくない環境

この場合，ノード間負荷バランスをする必要はありません。したがって，そのほかのノードにサーバの負荷状態を通知する必要もありません。scd_announce_server_status=Yを指定すると，サーバの負荷状態を通知するために回線を使用します。サーバが一つのノードだけで起動されている場合は，そのすべてのノードでscd_announce_server_status=Nを指定して，サーバの負荷状態の通知を抑止してください。

(4)　自ノードの優先

ノード間負荷バランスでは，サーバが自ノードにあっても，必ず自ノードにスケジュールされるとは限りません。

要求されたサーバが自ノードにある場合に，自ノードのサーバを優先してスケジュールするときは，スケジュールサービス定義でscd_this_node_first=Yを指定してください。ただし，要求されたサーバが自ノードにない場合，自ノードのサーバが過負荷状態や閉塞状態などでスケジュールできない場合は，ほかのノードにスケジュールします。

ノード間の通信を少なくしたいシステムに有効です。

scd_announce_server_statusオペランドとscd_this_node_firstオペランドの組み合わせを次の表に示します。

表3-7　scd_announce_server_statusとscd_this_node_firstオペランドの組み合わせ

オペランド | scd_announce_server_status
Y | N
scd_this_node_first | Y | サーバの負荷状態をほかのノードに通知します。負荷を考慮したノード間ロードバランスになりますが，自ノードにあるサーバが優先されます。 | サーバの負荷状態をほかのノードに通知しません。ランダムに選択されたノードのサーバにスケジュールされます。自ノードにサーバがある場合で，スケジュールできるときは，自ノードにスケジュールされます。
N | サーバの負荷状態をほかのノードに通知します。負荷を考慮したノード間ロードバランスになります。スケジュール可能な負荷の低いサーバのノードにスケジュールされます。 | サーバの負荷状態をほかのノードに通知しません。ランダムに選択されたノードのサーバにスケジュールされます。自ノードのサーバでも，自ノードにスケジュールされない場合があります。

(5)　ノード間負荷バランスとほかの機能との組み合わせ

ノード間負荷バランスをほかの機能と組み合わせて使用する場合の動作を次の表に示します。

表3-8　ノード間負荷バランスとほかの機能との組み合わせ

組み合わせる機能
ノード間負荷バランスの
使用形態
動作

TP1/Clientで常設コネクション

サーバ側の判断で負荷分散を行う

クライアント側の判断で負荷分散を行う(クライアントにTP1/Client/P，TP1/Client/Wを使用)

TP1/Server Base側のCUP実行プロセスが，常設コネクションを張ったノードでRPCを行うため，ノード間負荷バランスは，「クライアント側の判断で負荷分散を行う(クライアントにTP1/Server Baseを使用)」と同じ結果になります。

TP1/Clientでトランザクション制御API

サーバ側の判断で負荷分散を行う

クライアント側の判断で負荷分散を行う(クライアントにTP1/Client/P，TP1/Client/Wを使用)

TP1/Server Base側のトランザクショナルRPC実行プロセスがRPCを行うため，ノード間負荷バランスは，「クライアント側の判断で負荷分散を行う(クライアントにTP1/Server Baseを使用)」と同じ結果になります。

リモートAPI機能

サーバ側の判断で負荷分散を行う

クライアント側の判断で負荷分散を行う(クライアントにTP1/Client/P，TP1/Client/Wを使用)

クライアント側の判断で負荷分散を行う(クライアントにTP1/Server Baseを使用)

TP1/Server Base側のrapサーバが実際にRPCを行うため，ノード間負荷バランスは，「クライアント側の判断で負荷分散を行う(クライアントにTP1/Server Baseを使用)」と同じ結果になります。

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

ノード間の負荷を分散するための拡張機能として，次の指定ができます。

LEVEL0のノードへのスケジュール比率の指定
スケジュールサービス定義のschedule_rateオペランドを指定することによって，負荷レベルがLEVEL0のノードへ優先的にスケジュールさせることができます。

負荷監視のインタバル時間の指定
ユーザサービス定義およびユーザサービスデフォルト定義のloadcheck_intervalオペランドを指定することによって，サービスグループごとに負荷監視インタバル時間を指定できます。

負荷レベルのしきい値の指定
ユーザサービス定義およびユーザサービスデフォルト定義のlevelup_queue_countオペランドおよびleveldown_queue_countオペランドを指定することによって，負荷レベルを決定するしきい値（サービス要求滞留数）をサービスグループごとに指定できます。

通信障害時のリトライ回数の指定
スケジュールサービス定義のscd_retry_of_comm_errorオペランドを指定することによって，サービス要求のスケジュール時に通信障害が発生した場合でも，障害ノード以外へのスケジュールをリトライさせることができます。
この指定をしない場合は，通信障害時に再スケジュールしないでエラーリターンします。
なお，この機能は，TP1/Extension 1をインストールしていることが前提です。TP1/Extension 1をインストールしていない場合の動作は保証できませんので，ご了承ください。

3.2.5　プロセス数の変更

scdchprcコマンドを使用して，ユーザサーバ，および一部のシステムサーバの常駐プロセス数や最大プロセス数を該当サーバ運用中に変更できます。プロセス数の変更によってプロセス数の過不足が生じる場合には，プロセスの終了または生成をします。変更内容の有効期間は該当サーバが終了（強制終了を含む）するまでであり，システムの全面回復では引き継がれません。

なお，この機能は，TP1/Extension 1をインストールしていることが前提です。TP1/Extension 1をインストールしていない場合の動作は保証できませんので，ご了承ください。

3.2.6　スケジュールキューの監視

クライアントからのサービス要求がサービス処理の段階で遅れ始めると，スケジュールキューからサービス要求を取り出せないため，スケジュールキューにサービス要求が滞留する場合があります。

ユーザサービス定義のschedule_delay_limitオペランドにスケジュール遅延限界経過時間を指定すると，サービス要求がスケジュールキューに滞留している時間を監視できます。スケジュールキューにサービス要求が登録されているにもかかわらず，サービス要求が取り出されない状態が，スケジュール遅延限界経過時間を超えた場合，つまり，最終キュー操作時刻と，スケジューラによるキューの状態チェック時刻との間隔が，schedule_delay_limitオペランドに指定した時間を超えた場合，該当サーバごとにKFCA00838-Wメッセージを出力します。

最終キュー操作時刻は次の契機で更新されます。

スケジュールキューからサービス要求が取り出されるとき

スケジュールキューに滞留しているサービス要求が0の場合，スケジュールキューにサービス要求が登録されるとき

また，ユーザサービス定義でschedule_delay_abort=Yを指定すると，KFCA00838-WメッセージとともにKFCA00839-Eメッセージを出力して，スケジューラデーモンを強制停止しOpenTP1をシステムダウンさせます。OpenTP1システムがホットスタンバイ構成になっているシステムでは，サービス要求が滞留している状態を検知して系切り替えを実行する契機になります。

schedule_delay_limitオペランドに15を，schedule_delay_abortオペランドにYを指定した場合のスケジュールキューの監視の例を次の図に示します。

図3-2　スケジュールキューの監視の例（schedule_delay_limit=15，schedule_delay_abort=Yの場合）

●説明

スケジューラがキューの状態をチェックします。
スケジュールキューに登録された，またはスケジュールキューから取り出されたサービス要求はありません。サービス要求滞留時間は計算されないため，スケジュール遅延限界経過時間とサービス要求滞留時間は照合されません。処理は続行されます。

三つのサービス要求が登録されます。
一つ目，および二つ目のサービス要求は取り出され，処理が開始されます。
三つ目のサービス要求は，処理を行うシステムに空きがないため，滞留します。この時点の最終キュー操作時刻は，11秒です。

スケジューラがキューの状態をチェックします。
この時点の最終キュー操作時刻は，11秒です。サービス要求滞留時間※1が9秒間のため，スケジュール遅延限界経過時間に指定した値を超えていません。そのため，処理は続行されます。

一つ目のサービス要求の処理が完了します。
三つ目のサービス要求が，一つ目のサービス要求を処理していたシステムへ取り出され，処理が開始されます※2。この時点の最終キュー操作時刻は，27秒です。

四つ目のサービス要求が登録されます。
二つ目，および三つ目のサービス要求が処理中で，処理を行うシステムに空きがありません。そのため，四つ目のサービス要求は，スケジュールキューに滞留します。この時点の最終キュー操作時刻は，28秒です。

五つ目のサービス要求が登録されます。
二つ目，および三つ目のサービス要求が処理中で，処理を行うシステムに空きがありません。そのため，五つ目のサービス要求は，スケジュールキューに滞留します。この時点の最終キュー操作時刻は，28秒です。

スケジューラがキューの状態をチェックします。
この時点の最終キュー操作時刻は，28秒です。サービス要求滞留時間※1が2秒間のため，スケジュール遅延限界経過時間に指定した値を超えていません。そのため，処理は続行されます。

スケジューラがキューの状態をチェックします。
この時点の最終キュー操作時刻は，28秒です。サービス要求滞留時間※1は12秒間のため，スケジュール遅延限界経過時間に指定した値を超えていません。そのため，処理は続行されます。

六つ目のサービス要求が登録されます。
二つ目，および三つ目のサービス要求が処理中で，処理を行うシステムに空きがありません。そのため，六つ目のサービス要求は，スケジュールキューに滞留します。この時点の最終キュー操作時刻は，28秒です。

スケジューラがキューの状態をチェックします。
この時点の最終キュー操作時刻は，28秒です。サービス要求滞留時間※1が22秒間のため，スケジュール遅延限界経過時間に指定した値を超えています。そのため，OpenTP1システムがダウンします。

注※1

サービス要求滞留時間は，スケジューラによるキューの状態チェックの時刻から，最終キュー操作時刻を引いた値です。

注※2

三つ目のサービス要求は，実際には，16秒間（27秒－11秒）スケジュールキューに滞留しています。これは，スケジュール遅延限界経過時間の指定値を超えています。

しかし，スケジュール遅延限界経過時間の指定値を超えているかどうかは，スケジューラによるキューの状態チェックの時刻から，最終キュー操作時刻を引いた値（30秒－28秒）で判断されます。したがって，処理は続行されます。

3.2.7　スケジュールキューの滞留監視

クライアントからのサービス要求がサービス処理の段階で遅れ始めると，スケジュールキューからサービス要求を取り出せないため，スケジュールキューにサービス要求が滞留する場合があります。

このとき，スケジュールキューに滞留するサービス要求を一定の時間間隔でユーザサーバ単位に監視する機能を，スケジュールキューの滞留監視機能といいます。このスケジュールキューの滞留監視機能はユーザサーバ（SPP）だけで有効です。スケジュールキューにサービス要求が滞留する様子を次の図に示します。

図3-3　スケジュールキューにサービス要求が滞留する様子

何らかの理由によってサービス要求の処理が遅れる。

スケジュールキューからのサービス要求の取り出しが遅れる。

サービス要求がスケジュールキューに滞留する。

スケジュールキューの滞留監視時にスケジュールキューに滞留しているサービス要求数が，システム定義のオペランドに指定した値を超えた場合は，KFCA00833-Wメッセージが出力されます。さらに，オペランドの指定によっては，そのあとKFCA00834-Eメッセージが出力されOpenTP1をシステムダウン（強制停止）させます。

＜この項の構成＞

(1)　指定するオペランド

(2)　処理の流れ

(3)　処理の流れの例

(1)　指定するオペランド

スケジュールキューの滞留監視機能を使用するには，次に示すユーザサービス定義またはユーザサービスデフォルト定義のオペランドを指定します。個々のオペランドの詳細についてはマニュアル「OpenTP1 システム定義」を参照してください。

stay_watch_queue_count
スケジュールキューの滞留監視判定を開始する際の判断になるサービス要求滞留数を指定します。

stay_watch_check_rate
スケジュールキューの滞留監視判定で使用する，サーバが処理できるサービス要求の処理率を指定します。

stay_watch_abort
スケジュールキューの滞留監視判定式を満たした場合に，OpenTP1をシステムダウンさせるかどうかを指定します。

stay_watch_start_interval
スケジュールキューに滞留しているサービス要求数を監視するインタバル時間を指定します。

stay_watch_check_interval
スケジュール滞留監視判定式を基に判定処理を行うインタバル時間を指定します。

上記のオペランドを指定できるユーザサーバはSPPだけです。これらのオペランドをrapサーバ，MHPサーバに指定してもスケジュールキューの滞留監視機能は有効になりません。また，stay_watch_queue_countオペランドの指定を省略，またはstay_watch_queue_countオペランドに0を指定した場合，上記2.～5.のオペランドの指定値は無効になるので注意してください。

(2)　処理の流れ

スケジュールキューの滞留監視の処理の流れを説明します。なお，ユーザサーバ（SPP）はすでに起動されている状態とします。

stay_watch_start_intervalオペランドで指定した値を基に，一定の時間間隔でスケジュールキューの監視を開始します。

スケジュールキューに滞留しているサービスの要求数がstay_watch_queue_countオペランドの指定値を超えた時点でスケジュールキューの滞留監視判定区間に入り，滞留監視判定が開始されます。
スケジュールキューの滞留監視判定が開始されると，スケジュールキューの滞留監視判定式によってスケジュールキューの滞留状況が判定されます。

スケジュールキューの滞留監視判定式

判定後の処理を次に示します。

スケジュールキューの滞留監視判定式が成立しない場合
処理が続行されます。

スケジュールキューの滞留監視判定式が成立し，stay_watch_abortオペランドにNを指定している場合
KFCA00833-Wメッセージが出力され，処理が続行されます。

スケジュールキューの滞留監視判定式が成立し，stay_watch_abortオペランドにYを指定している場合
KFCA00833-Wメッセージ，およびKFCA00834-Eメッセージが出力され，OpenTP1をシステムダウンさせます。

スケジュールキューの滞留監視判定処理はstay_watch_check_intervalオペランドで指定したインタバル時間で，ユーザサーバ単位の監視を行います。
スケジュールキューに滞留しているサービスの要求数がstay_watch_queue_countオペランドで指定した値よりも少なくなった場合は，1.に戻ります。

(3)　処理の流れの例

ユーザサービス定義の各オペランドで次のように指定した場合のスケジュールキューの滞留監視機能の処理の例を説明します。

ユーザサービス定義

set stay_watch_queue_count=30（個）

set stay_watch_check_rate=70（%）

set stay_watch_abort=Y

set stay_watch_start_interval=5（秒）

set stay_watch_check_interval=10（秒）

図3-4　スケジュールキューの滞留監視機能の処理の例

stay_watch_queue_count=30と指定しているため，図3-4でC₂からC₅の区間およびC₈以降の区間で，スケジュールキューの滞留監視判定が行われます。スケジュールキューの滞留監視判定区間では，stay_watch_check_intervalオペランドの指定値の間隔による監視が行われます。この一定時間間隔の監視で，サービス要求の処理件数とサービス要求の処理率を基にスケジュールキューの滞留監視判定式による判定が行われます。

スケジュールキューの滞留監視判定式

図3-4の例を判定式で表すと次のようになります。

Pn-1 - Bn < m₁ × Pn-1

（凡例）

n：0または正の整数

Pn-1 - Bn：該当区間のサービス要求の処理件数

m₁：サービス要求の処理率（set stay_watch_check_rateオペランドの指定値）

Pn-1：該当区間のサービス要求の滞留数

次の表は，図3-4でのサービス要求の処理件数，およびスケジュールキューの滞留監視判定式の判定結果をまとめたものです。

n
サービス要求の処理件数
（Pn-1 - Bn）
期待するサービス要求の処理件数
（m₁×Pn-1）
スケジュールキューの滞留監視判定式の判定結果
（Pn-1-Bn<m₁×Pn-1）

0
－
－
滞留監視判定の対象外

1
18-9=9
0.7×18=12.6
滞留監視判定の対象外

2
28-25=3
0.7×28=19.2
滞留監視判定の開始

3
32-8=24
0.7×32=22.4
OpenTP1オンライン続行

4
45-13=32
0.7×45=31.5
OpenTP1オンライン続行

5
35-0=35
0.7×35=24.5
OpenTP1オンライン続行

6
30-3=27
0.7×30=21
滞留監視判定の対象外

7
11-5=6
0.7×11=7.7
滞留監視判定の対象外

8
17-15=2
0.7×17=11.9
滞留監視判定の開始

9
32-29=3
0.7×32=22.4
OpenTP1システムダウン

（凡例）

n：0または正の整数を示します。

－：該当しません。

上記の表でn=1またはn=7の場合，スケジュールキューの滞留監視判定式が成立しますが，スケジュールキューの滞留監視判定中ではないため，OpenTP1システムはダウンしません。また，n=2またはn=8の場合，スケジュールキューの滞留監視判定の開始時であるため，OpenTP1システムはダウンしません。

n=9の場合は，スケジュールキューの滞留監視判定中で，スケジュールキューの滞留監視判定式が成立し，かつstay_watch_abort=Yであるため，OpenTP1をシステムダウンさせます。

3.2.8　ユーザサーバプロセスのリフレッシュ機能

scdrsprcコマンドを使用すると，ユーザサーバのオンラインを停止しなくてもユーザサーバプロセスを停止および再起動できます。scdrsprcコマンド実行時にサービス要求実行中のユーザサーバプロセスは，サービス要求が完了したあとに停止および再起動します。

ここでは，ロードモジュールの入れ替え手順，サービス関数の入れ替え手順，および新しいロードモジュールまたはサービス関数での起動確認について説明します。

なお，この機能は，TP1/Extension 1をインストールしていることが前提です。TP1/Extension 1をインストールしていない場合の動作は保証できません。

＜この項の構成＞

(1)　ロードモジュールの入れ替え手順

(2)　サービス関数の入れ替え手順（サービス関数動的ローディング機能使用時）

(3)　新しいロードモジュールまたはサービス関数での起動確認

(1)　ロードモジュールの入れ替え手順

scdrsprcコマンドを使用すると，オンラインを停止しなくてもユーザサーバのロードモジュールを入れ替えられます。ロードモジュールの入れ替え手順を，次に示します。

該当ユーザサーバの新しいロードモジュールを格納したディレクトリを作成します。

prcpathlsコマンドでユーザサーバのサーチパスを確認します。

prcpathコマンドで該当ユーザサーバのサーチパスより前に1.で作成したディレクトリを指定します。

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

(2)　サービス関数の入れ替え手順（サービス関数動的ローディング機能使用時）

サービス関数動的ローディング機能を使用している場合，オンラインを停止しなくてもユーザサーバのサービス関数を入れ替えられます。サービス関数の入れ替え手順を，次に示します。

該当ユーザサーバのユーザサービス定義のserviceオペランドに指定したUAP共用ライブラリ名を変更します。

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

また，UAP共用ライブラリ名だけをユーザサービス定義に指定している場合は，次の手順でもサービス関数を入れ替えられます。

変更したいUAP共用ライブラリのサーチパスが示すディレクトリに，UAP共用ライブラリがあることを確認します。
サーチパスに指定したディレクトリ間で，ライブラリ名が重複しないように注意してください。ライブラリ名が重複している場合，正しいライブラリが読み込まれないで別のライブラリが読み込まれることがあります。また，ライブラリ名は，OpenTP1が提供するライブラリ群（$DCDIR/lib下）のライブラリ名とも重複しないようにしてください。

prcdlpathコマンドを実行して，UAP共用ライブラリのサーチパスを変更します。
プロセスサービス定義のprc_take_over_dlpathオペランドにYを指定すると，OpenTP1の再開始時に，prcdlpathコマンドで設定したサーチパスを引き継げます。ただし，次の場合はパスを引き継ぎません。

系切り替えが発生した場合

前回のオンライン中にサーチパスの保存に失敗した場合

ファイルからのサーチパスの回復に失敗した場合

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

(3)　新しいロードモジュールまたはサービス関数での起動確認

新しいロードモジュールまたはサービス関数での起動を確認するには，OSのシステムコマンドで該当するユーザサーバのプロセス起動時刻を確認し，scdrsprcコマンドの実行時刻と比較してください。

なお，scdrsprcコマンドを使用してサービス関数を入れ替える場合は，ユーザサーバのサービス関数を削除または追加できません。ユーザサーバのサービス関数を削除または追加する場合は，dcsvstopコマンドを使用してユーザサーバを終了したあとに，dcsvstartコマンドを使用してユーザサーバを開始させる必要があります。

scdrsprcコマンドを使用する場合，またはdcsvstopコマンドとdcsvstartコマンドを使用する場合について，ユーザサーバのサービス関数を変更できる範囲を次の表に示します。

表3-9　ユーザサーバのサービス関数を変更できる範囲

実行方法 | サービス関数の入れ替え | サービス関数の追加 | サービス関数の削除
scdrsprcコマンドを使用 | ○ | × | ×
dcsvstopコマンドとdcsvstartコマンドを使用 | ○ | ○※ | ○

（凡例）

○：変更できます。

×：変更できません。

注※

MHPの場合にサービス関数を追加するときは，アプリケーション属性定義（mcfaalcap）を変更する必要があります。

3.3　トランザクションに関する運用

＜この節の構成＞

3.3.1　トランザクションの状態表示

3.3.2　トランザクションの強制決着

3.3.3　トランザクションの強制終了

3.3.4　未決着トランザクション情報ファイルの削除

3.3.5　トランザクション統計情報の取得開始，終了

3.3.6　XAリソースサービス使用時のトランザクション統計情報の取得

3.3.1　トランザクションの状態表示

トランザクションマネジャが管理するトランザクション，およびリソースマネジャの情報を，trnlsコマンドで表示できます。

表示内容はプロセスID，トランザクショングローバル識別子，リソースマネジャ名などです。

3.3.2　トランザクションの強制決着

trnlsコマンドでトランザクションの状態を表示したときに，トランザクション第1状態，第2状態，および第3状態がREADY（p，n）状態となり，その状態が長く続く場合は，グローバルトランザクションを構成している各トランザクションブランチが，何らかの要因（通信障害など）でトランザクションを決着できない状態になったと考えられます。この場合，OpenTP1がリトライしてトランザクションを決着させます。OpenTP1のリトライを待てない場合は，ユーザが運用コマンドを入力して，該当するトランザクションブランチを強制決着（ヒューリスティック決定）できます。ルートトランザクションブランチがコミットしている場合，trncmtコマンドを実行してトランザクションブランチをコミットします。ルートトランザクションブランチがロールバックしている場合，trnrbkコマンドを実行してトランザクションブランチをロールバックします。ルートトランザクションブランチがコミットしているか，ロールバックしているかは，trnlsコマンドでトランザクションの状態を表示するか，またはlogcatコマンドでメッセージログファイルを参照して確認してください。

同一グローバルトランザクション内でトランザクションブランチが別計算機上に分散している場合でも，運用コマンドは計算機ごとに入力する必要があります。その場合，すべてのトランザクションブランチを同一の方法（コミットするか，ロールバックするか）で決着させてください。

trncmtコマンドを実行すると，trnlsコマンドで表示したトランザクション第1状態はHEURISTIC_COMMIT状態になります。trnrbkコマンドを実行すると，HEURISTIC_ROLLBACK状態になります。その後，trncmtコマンド，またはtrnrbkコマンドによる処理が終了するまでの一時的な経過状態として，HEURISTIC_FORGETTING状態になります。

3.3.3　トランザクションの強制終了

通信障害が発生してトランザクションを強制決着すると，トランザクションブランチ間の連絡が完了するまでトランザクションを終了できません。通信障害が長時間回復する見込みのない場合には，トランザクションを強制終了できます。この場合，-fオプション指定のtrncmtもしくはtrnrbkコマンド，またはtrnfgtコマンドを使用します。

-fオプションを指定したtrncmt，またはtrnrbkコマンドを実行すると，トランザクション第1状態，第2状態，および第3状態がREADY（p，n）状態のトランザクションを，強制的にコミット，またはロールバックします。この場合，該当するトランザクションブランチの決着結果を，同一グローバルトランザクション内のほかのトランザクションブランチに通知することはできません。そのため，同一グローバルトランザクション内のすべてのトランザクションブランチを，同一の方法で決着できなくなることがあります。

-fオプションを指定しないtrncmt，またはtrnrbkコマンドを実行したあと，トランザクションを強制終了したい場合は，trnfgtコマンドを使用します。trnfgtコマンドを実行すると，トランザクション第1状態，第2状態，および第3状態がHEURISTIC_FORGETTING（p，n）状態のトランザクションを，強制的に終了します。この場合も，該当するトランザクションブランチの決着結果を，同一グローバルトランザクション内のほかのトランザクションブランチに通知することはできません。そのため，同一グローバルトランザクション内のすべてのトランザクションブランチを，同一の方法で決着できなくなることがあります。

トランザクションを強制終了すると，リソースマネジャが使用していた資源が解放されるので，ほかのUAPから使用できるようになります。

3.3.4　未決着トランザクション情報ファイルの削除

トランザクションサービス定義でtrn_tran_recovery_list=Yを指定すると，未決着トランザクション情報ファイルが$DCDIR/spool/dctrninfの下に作成されます。このファイルは全面回復のたびに作成されます。不要になったファイルは削除してください。ファイルが増えるとファイルシステムを圧迫する場合があります。

ファイルを削除するには，OpenTP1開始時に自動的に削除する方法と任意の時点で削除する方法があります。

OpenTP1開始時に自動的に削除する場合は，トランザクションサービス定義trn_recovery_list_removeオペランドでnormalかforceを指定してください。

任意の時点で削除する場合は，trndlinfコマンドを実行してください。

3.3.5　トランザクション統計情報の取得開始，終了

トランザクション統計情報のジャーナルファイルへの取得を，trnsticsコマンドで指示できます。

トランザクション統計情報の取得は，-sオプション指定のtrnsticsコマンドで開始できます。-sオプション指定のtrnsticsコマンドを実行すると，trnsticsコマンドが正常終了したあとに開始されるトランザクションから，トランザクション統計情報を取得します。trnsticsコマンドが正常終了する前に，すでに開始されていたトランザクションに関しては，トランザクション統計情報を取得できません。

また，トランザクション統計情報は，OpenTP1のシステム定義でtrn_statistics_itemにnothing以外を指定したユーザサービスが実行したトランザクションでだけ取得できます。

トランザクション統計情報の取得の終了は，-eオプション指定のtrnsticsコマンドで指示します。-eオプション指定のtrnsticsコマンドを実行すると，trnsticsコマンドが正常終了したあとに開始されるトランザクションから，トランザクション統計情報を取得しません。

トランザクション統計情報を取得する場合，取得する情報の種類が多くなるほどトランザクションの性能は劣化します。そのため，トランザクションの性能が劣化してもかまわない場合だけ，トランザクション統計情報を取得するようにしてください。

なお，OpenTP1再開始時は，trnsticsコマンドの指定は引き継げません。OpenTP1再開始時は，OpenTP1再開始前のトランザクションサービス定義のtrn_tran_statistics（トランザクションブランチごとの統計情報を取得するかどうか）の指定に従います。

3.3.6　XAリソースサービス使用時のトランザクション統計情報の取得

XAリソースサービスのトランザクション統計情報も，trnsticsコマンドで取得できます。ただし，トランザクション統計情報を取得するトランザクションブランチが，アプリケーションサーバから派生したトランザクションブランチなのか，またはOpenTP1から開始されたトランザクションブランチなのかの区別はできません。すべてOpenTP1内のトランザクションブランチとして扱われます。また，rapサーバ上のトランザクションブランチのCPU時間情報は取得できません。

3.4　排他に関する運用

＜この節の構成＞

3.4.1　排他情報の表示

3.4.2　排他制御用テーブルのプール情報の表示

3.4.3　デッドロック情報ファイルとタイムアウト情報ファイルの削除

3.4.1　排他情報の表示

排他情報を，lcklsコマンドで表示できます。

表示内容はデッドロックプライオリティ値，資源名称，待ち時間などです。

3.4.2　排他制御用テーブルのプール情報の表示

排他制御用テーブルプールの使用率を監視するには，lckpoolコマンドを使用します。

lckpoolコマンドでは，次に示すサーバとサービスの排他要求数，排他制御用テーブルプール使用率などが表示されます。

ユーザサーバ

DAMサービス

TAMサービス

MQAサービス

3.4.3　デッドロック情報ファイルとタイムアウト情報ファイルの削除

出力されたデッドロック情報とタイムアウト情報を，lckrminfコマンドで削除できます。lckrminfコマンドを実行すると，コマンドを実行した時刻から起算して「24時間×lckrminfコマンドで指定した日数」以前に作成されたデッドロック情報ファイルとタイムアウト情報ファイルを削除します。

3.5　標準出力ファイルに関する運用

OpenTP1配下のプロセスの標準出力，標準エラー出力は，通常ファイル/tmp/betran.log（デフォルト時）となっています。このファイルはマシン起動時に削除するなどの仕掛けがないかぎり，無制限に増加しディスクを圧迫してしまう可能性があります。これを防ぐために，/tmp/betran.logファイルを世代管理させることができます。

/tmp/betran.logファイルを世代管理させるには，次のように設定します。

$DCDIR下でOpenTP1が起動している場合，OpenTP1を停止します。

$ dcstop<CR>

prcteeプロセスを停止します。
prcteeプロセスを停止する方法として，dcsetupコマンドまたはprctctrlコマンドを使用する方法があります。

dcsetupコマンドを使用する方法

# /BeTRAN/bin/dcsetup -d $DCDIR<CR>

KFCA01836-R 指定したOpenTP1ディレクトリ下の実行に必要なファイルを削除するかどうか指定してください。

[y：削除する　n：削除しない]

n<CR>

OS（/etc/inittab）にOpenTP1が登録されている場合，OSから削除します。ただし，Red Hat Enterprise Linux Server 6以降で使用するときは，OS（/etc/initディレクトリ下のOpenTP1制御ファイル）にOpenTP1が登録されている場合，OSから削除します。

prctctrlコマンドを使用する方法

# /BeTRAN/bin/prctctrl -e<CR>

$DCDIR/bin/prcoutファイルを開き，prcteeコマンドの定義（下線部分）を変更します。prcteeコマンドについては，「13.　運用コマンドの詳細」を参照してください。

（HP-UXの例）

1 #!/bin/sh

2 #!ALL RIGHTS RESERVED,COPYRIGHT (C)1995,HITACHI,LTD.

3 #!LICENSED MATERIAL OF HITACHI,LTD.

4 #!@(#) prcout(96/12/18 14:36:42)-1.7

5 PATH=/bin:/usr/bin

6 export PATH

7

8 if [ ! -d "$1" ] ; then

9 echo "usage : prcout OpenTP1_directory" 1>&2

10 exit 1

11 fi

12 DCDIR="$1"

13 export DCDIR

14 $DCDIR/bin/prctee 0 /tmp/betran.log

prcteeプロセスを起動します。
prcteeプロセスを停止したコマンドによって，起動方法が異なります。

dcsetupコマンドを使用してprcteeプロセスを停止した場合

dcsetupコマンドを使用してprcteeプロセスを起動します。

# /BeTRAN/bin/dcsetup $DCDIR<CR>

OS（/etc/inittab）にOpenTP1を登録します。ただし，Red Hat Enterprise Linux Server 6以降で使用するときは，OS（/etc/initディレクトリ下のOpenTP1制御ファイル）にOpenTP1を登録します。

prctctrlコマンドでprcteeプロセスを停止した場合

prctctrlコマンドでprcteeプロセスを起動します。

# /BeTRAN/bin/prctctrl -s<CR>

なお，dcresetコマンドを実行，またはOpenTP1を開始した場合でも，prcteeプロセスを起動できます。

3.6　ログ機能

＜この節の構成＞

3.6.1　メッセージログ

3.6.2　コマンドログ

3.6.1　メッセージログ

オンラインの状態を監視するために，次の二つの機能があります。

リアルタイム出力機能

メッセージログファイルへの出力，および編集出力機能

＜この項の構成＞

(1)　リアルタイム出力機能

(2)　メッセージログファイルへの出力，および編集出力機能

(1)　リアルタイム出力機能

メッセージログファイルに出力されるメッセージログを，リアルタイムに標準出力に出力できます。標準出力に出力するには，ログサービス定義でlog_msg_console=Yと指定します。このとき，メッセージ通番，要求元プロセスのプロセスID，出力要求時の日時などを出力するかどうかを指定できます。

なお，log_msg_consoleオペランドの指定は，オンライン中にlogconコマンドで変更できます。

(2)　メッセージログファイルへの出力，および編集出力機能

(a)　メッセージログファイルへの出力

OpenTP1は，各システムサービス，MCF，UAPからの出力要求を受けて，メッセージログファイルにメッセージログを出力します。

メッセージログファイルには$DCDIR/spool/dclog1と$DCDIR/spool/dclog2の二つがあります。二つのファイルはラウンドロビン方式で使用され，1世代前のメッセージ情報が保証されます。ファイルが切り替わるときには，その旨のメッセージが出力されます。ファイルを保存する必要がある場合は，上書きされる前にバックアップしてください。

(b)　メッセージログ編集出力機能

logcatコマンドを実行すると，メッセージログファイル中のメッセージを標準出力に出力できます。このとき，$DCDIR/spool/dclog1と$DCDIR/spool/dclog2の二つのファイルのメッセージが時間順にマージされ，古いものから順に出力されます。

(c)　ログ出力量に関する注意事項

ログの出力量が多い場合には，次に示す弊害が発生するおそれがあります。OpenTP1を運用する際には，障害発生時にメッセージの出力量が激しく上昇しないような注意が必要です。

dc_logprint関数およびCBLDCLOG('PRINT')のリターンが遅くなる
これはトランザクション処理時間が延びることを意味し，全体をスローダウンさせる要因になります。

ログ出力処理に大量のCPUを消費する
システム定義の指定によってOpenTP1のログ出力以外にOSのsyslogfileやJP1にメッセージを渡すためにCPU消費が上昇する傾向が現れます。

運用監視に支障がでる可能性がある
大量のメッセージ出力によって，運用監視をするためにメッセージを収集しているプログラムが処理に追い付けなくなる可能性があります。

3.6.2　コマンドログ

＜この項の構成＞

(1)　コマンドログの出力形式

(2)　コマンドログの取得方法

(3)　注意事項

(1)　コマンドログの出力形式

OpenTP1の運用コマンドを実行した場合に，コマンド実行時刻，終了時刻などの情報を$DCDIR/spool/cmdlogのcmdlog1，およびcmdlog2に出力します。cmdlog1，およびcmdlog2は，1MBを超えた時点でラップアラウンドします。

cmdlog1，およびcmdlog2はviエディタなどで参照できます。コマンドログにはコマンドの開始時刻，終了時刻が出力されるので，コマンドの実行に必要な所要時間の測定などができます。

出力する情報は次のとおりです。

> AAAA BBBB C  DDDD/DD/DD EE:EE:EE.EEEEEE FFFFFFFF : GGGGGGGG : HHHHHHH

>：コマンドログの1行の始まりを示すコマンドログレコード開始識別子です。

AAAA：実行したコマンドのプロセスIDを半角数字で出力します。

BBBB：コマンド実行者のユーザIDを出力します。

C：プロセス内のメッセージ通番を出力します（実行したコマンドプロセスが出力したコマンドログ情報の通番です）。半角数字で0～65535まで出力します。65535を超えた場合は0に戻ります。

DDDD/DD/DD：コマンドログに出力した年月日を，YYYY/MM/DDの形式で半角数字で出力します。

EE:EE:EE.EEEEEE：コマンドログに出力した時刻を，HH:MM:SS.mmmmmmの形式で半角数字で出力します。なお，mmmmmmはマイクロ秒を示します。

FFFFFFFF：コマンド実行時のコマンドライン情報を出力します。OpenTP1内部で実行するコマンドが出力されることがあります。

GGGGGGGG：次の識別情報を出力します。
start：コマンド開始時の情報を示します。
end：コマンド終了時の情報を示します。
info：コマンド実行中の保守情報を示します。

HHHHHHH：コマンドの保守情報を出力します。

(2)　コマンドログの取得方法

MCF関連の運用コマンドでは，コマンドログを取得するために環境変数を設定する必要があります。環境変数を設定する必要があるコマンドについては，表12-1を参照してください。ここでは，環境変数の設定手順について説明します。

手動で運用コマンドを実行する場合
OpenTP1管理者のログイン環境に次の環境変数を設定してください。
変数：DCMCFCMDLOG
値：Y
設定していない場合および「Y」以外の値を設定した場合は，コマンドログを取得しません。

自動で運用コマンドを実行する場合
OpenTP1のUAPからdc_adm_call_command関数を発行して運用コマンドを実行する場合は，該当のUAPのユーザサービス定義またはユーザサービスデフォルト定義に次のように設定してください。

putenv DCMCFCMDLOG Y

設定していない場合および「Y」以外の値を設定した場合は，コマンドログを取得しません。COBOLおよびDMLインタフェースを使用してコマンドを実行する場合も同様です。

(3)　注意事項

MCF関連の運用コマンドのコマンドログ取得についての注意事項を次に示します。

UAPやシェルファイルを使用して同時に大量のコマンドを実行する場合は，コマンドログ出力がボトルネックになり性能劣化が予想されます。この場合は，環境変数DCMCFCMDLOGは設定しないでください。

運用コマンドの実行でエラーが発生した場合，環境変数DCMCFCMDLOGの設定に関係なくコマンドログを取得することがあります。

3.7　監査ログの運用

監査ログとは，システム構築者，運用者，および使用者がOpenTP1のプログラムに対して実行した操作，およびその操作に伴うプログラムの動作の履歴が出力されるファイルです。

監査ログには「いつ」「だれが」「何をしたか」などが記録され，システムの使用状況や不正アクセスなどを監査する資料として使用できます。

＜この節の構成＞

3.7.1　監査ログ機能の環境設定

3.7.2　監査ログの出力方式

3.7.3　監査ログファイルの見積もり例

3.7.4　監査ログに出力される情報

3.7.5　監査イベントの一覧と出力ポイント

3.7.6　監査ログの運用例

3.7.1　監査ログ機能の環境設定

＜この項の構成＞

(1)　定義の作成

(2)　実行環境の作成

(3)　監査ログの取得項目の指定方法

(4)　監査ログの取得項目の例

(5)　監査ログの取得についての注意事項

(1)　定義の作成

監査ログを出力するには，次に示す定義を指定します。

ログサービス定義のlog_audit_outオペランドにYを指定

ログサービス定義のlog_audit_messageオペランドに監査ログを取得する項目のメッセージIDを指定

作成したログサービス定義は，システム環境定義（$DCDIR/conf/env）の環境変数DCCONFPATHで指定したディレクトリに格納してください。システム環境定義に環境変数DCCONFPATHが指定されていない場合は，$DCDIR/confをシステム定義格納ディレクトリと仮定します。

なお，ログサービス定義の詳細については，マニュアル「OpenTP1 システム定義」を参照してください。

(2)　実行環境の作成

ログサービス定義を作成したあと，dcauditsetupコマンドを実行すると，監査ログ機能に必要なディレクトリおよびファイルが作成されます。作成されるディレクトリおよびファイル名を次の表に示します。

表3-10　dcauditsetupコマンドの実行時に作成されるファイルとディレクトリ

ファイルおよびディレクトリ | ユーザID | グループID | アクセス権 | 内容
$DCDIR/auditlog※ | OpenTP1管理者のユーザID | OpenTP1管理者のグループID | 0777 | 監査ログファイルを格納するディレクトリ
$DCDIR/auditlog/audit.log※ | OpenTP1管理者のユーザID | OpenTP1管理者のグループID | 0666 | 監査ログファイル

注※

ログサービス定義のlog_audit_pathオペランドの指定を省略した場合のディレクトリです。log_audit_pathオペランドを指定した場合，指定したディレクトリが作成され，作成されたディレクトリ下にファイルが作成されます。

なお，作成されるディレクトリは最下層だけです。上位のディレクトリは事前に準備しておく必要があります。また，最下層のディレクトも事前に準備する場合は，上記の表に示す権限になるように作成してください。

実行環境を作成したあとに監査ログについての定義を変更する場合，次に示す手順で行ってください。

OpenTP1を停止します。

定義を変更します。

dcauditsetupコマンドを実行します（スーパユーザ権限で実行してください）。

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

OpenTP1を起動します。

システム環境定義のDCCONFPATHオペランドを変更した場合，変更後のDCCONFPATHに格納されたログサービス定義の設定を有効にする必要があります。この場合も同様の方法で変更を行ってください。

(3)　監査ログの取得項目の指定方法

監査ログを取得する項目は，ログサービス定義またはユーザサービス定義のlog_audit_messageオペランドで指定します。

監査ログを取得する項目のメッセージIDと定義の対応については，マニュアル「OpenTP1 システム定義」を参照してください。

なお，ログサービス定義のlog_audit_messageオペランドの指定値を変更した場合は，dcauditsetupコマンドを実行して，定義の変更を反映させる必要があります。

(4)　監査ログの取得項目の例

監査ログは大量に取得すると性能劣化を招くため，必要な項目だけを取得するようにしてください。推奨する監査ログの取得項目を次に示します。

OpenTP1の開始，終了などに関する監査ログ（KFCA33400-I～KFCA33404-E）

コマンド実行に関する監査ログ（KFCA33419-I）

ユーザサーバで任意に取得した監査ログ（KFCA34000-x～KFCA34999-x）※
ユーザサーバで監査ログを取得する場合は，まず動作履歴を残したいユーザサーバを絞り込んでください。ユーザサーバプログラムを修正できない場合は，サービス関数の実行開始（KFCA33412-I），または実行完了（KFCA33413-I）のどちらかの監査ログを取得することで，ユーザサーバプログラムへのアクセス記録を管理できます。

注※

KFCA34000-x～KFCA34999-xは，UAPで任意の監査ログを取得する場合に，監査ログに対して割り当てられるメッセージIDです。xにはdc_log_audit_print関数で指定したメッセージの種類（E，WまたはI）が入ります。

推奨する監査ログの取得項目について，ログサービス定義およびユーザサービス定義に指定した例を，次に示します。

ログサービス定義のlog_audit_messageオペランドの指定

set log_audit_message=33400,33401,33402,33403,33404,33419

監査ログを出力するユーザサーバのユーザサービス定義

set log_audit_message=34000

(5)　監査ログの取得についての注意事項

監査ログを大量に取得すると性能劣化を招きます。取得対象には，監査に必要な項目だけを選択して，指定してください。事前に性能評価を実施してから使用することをお勧めします。

3.7.2　監査ログの出力方式

＜この項の構成＞

(1)　監査ログの出力先

(2)　監査ログの障害

(3)　監査ログの切り替え時の注意事項

(1)　監査ログの出力先

監査ログは，ログサービス定義のlog_audit_pathオペランドで指定した出力先にシフト方式で出力されます。デフォルトの出力先を次に示します。

Windowsの場合
%DCDIR%¥auditlog¥audit.log

UNIXの場合
$DCDIR/auditlog/audit.log

監査ログファイルは，ログサービス定義のlog_audit_sizeオペランドで指定したサイズに達するまで出力されます。また，ログサービス定義のlog_audit_countオペランドで指定した世代数の監査ログファイルが出力されます。

シフト方式による監査ログの取得の流れを次の図に示します。なお，ここではlog_audit_countオペランドの指定値が4の場合の例を示します。

図3-5　シフト方式による監査ログの取得

カレントファイル（audit.log）に監査ログが蓄積された結果，カレントログファイルの容量がlog_audit_sizeオペランドの指定値に達したとき，カレントファイルの名称はaudit001.logに変更されます。

1.以降，再びカレントファイルの容量がlog_audit_sizeオペランドの指定値に達したとき，カレントファイルのバックアップファイルであるaudit001.logは，audit002.logに名称が変更されます。そのあと，カレントファイルの名称はaudit001.logに変更されます。

2.以降，再びカレントファイルの容量がlog_audit_sizeオペランドの指定値に達したとき，カレントファイルのバックアップファイルであるaudit002.logは，audit003.logに名称が変更され，audit001.logは，audit002.logに名称が変更されます。そのあと，カレントファイルの名称はaudit001.logに変更されます。

カレントのファイルの数がlog_audit_countオペランドの指定値を超えた場合，そのバックアップファイルは削除されます。

(2)　監査ログの障害

障害が発生して監査ログの出力に失敗すると，監査ログの出力でエラーが発生したことを通知するメッセージが標準エラー出力，およびsyslogに出力されます。

(3)　監査ログの切り替え時の注意事項

出力先ファイルの切り替えが発生したプロセスの実行者がrootまたはOpenTP1管理者ではない場合，新たに作成される監査ログファイルの所有者は，そのプロセスの実行者になります。

3.7.3　監査ログファイルの見積もり例

監査ログファイルは，世代数が多いほど出力先ファイルの切り替えに伴うオーバヘッドが大きくなります。監査ログファイルのサイズを大きく指定することで，ファイルの切り替え回数を減らし，世代数が多くならないようにしてください。

一つの監査ログファイルで7日間運用する場合のファイルサイズの見積もり例を次の表に示します。

表3-11　監査ログファイルの見積もり例

想定システム例
取得する監査ログ
1日当たりの監査ログファイルのサイズ
監査ログファイルの最大サイズ（log_audit_sizeオペランドの指定値）

OpenTP1およびユーザサーバの起動・停止操作を重点的に監視する場合

OpenTP1の起動・停止：1回/日

ユーザサーバの起動，停止：1回/日×100サーバ

KFCA33400-I（OpenTP1開始）

KFCA33402-I（OpenTP1正常終了）

KFCA33405-I（ユーザサーバ開始）

KFCA33406-I（ユーザサーバ正常終了）

約60キロバイト
1メガバイト

サービスの実行操作を重点的に監視する場合（監視対象サーバが限定されている場合）

監視対象とするユーザサーバ数：5

1サーバ当たりのサービス関数実行回数：60件/時間

1日の業務時間：8時間

監査ログを取得する回数：1回/サービス

KFCA34000-I（UAPで任意に発行するログ，ログメッセージサイズを400バイトとする）
約1メガバイト
10メガバイト

サービスの実行操作を重点的に監視する場合（すべてのサーバを監視対象とする場合）

起動するユーザサーバ数：100

1サーバ当たりのサービス関数の実行回数：60件/時間

1日の業務時間：8時間

監査ログを取得する回数：1回/サービス

KFCA34000-I（UAPで任意に発行するログ，ログメッセージサイズを600バイトとする）
約28メガバイト
200メガバイト

注

単位時間当たりの監査ログ量を見積もった上で，監査ログファイルの容量および世代数を見積もってください。

イベントごとの監査ログ量については，「付録C 監査イベントの出力情報」を参照してください。

3.7.4　監査ログに出力される情報

＜この項の構成＞

(1)　監査ログの出力形式

(2)　監査ログの出力例と出力項目

(1)　監査ログの出力形式

監査ログは次の形式で出力されます。

CALFHM 1.0,出力項目1=値1,出力項目2=値2,・・・出力項目n=値n

「CALFHM 1.0」は，ヘッダ情報です。監査ログに共通で出力されます。

(2)　監査ログの出力例と出力項目

監査ログの出力例を次に示します。

CALFHM 1.0, seqnum=1, msgid=KFCA33400-I,
date=2007-10-30T16:09:59.884+09:00, progid=OpenTP1, compid=adm, pid=11600,
ocp:ipv4=192.112.100.10, ctgry=StartStop, result=Success,
subj:euid="tp1user", obj="smpl", op=Start, loc="/OpenTP1", msg="User tp1user
started OpenTP1(smpl)."

監査ログの出力項目を次の表に示します。

表3-12　監査ログの出力項目

出力項目名
意味
出力内容
共通情報／固有情報※1

seqnum
通番
プロセスごとに監査ログの通番が出力されます。
共通情報

msgid
メッセージID
メッセージIDが出力されます。

date
日付・時刻
メッセージが出力された日時が次の形式で出力されます。YYYY-MM-DDThh:mm:ss.sssTZD
YYYY：年
MM：月
DD：日
T：日付と時刻の区切り
hh：時
mm：分
ss：秒
sss：ミリ秒
TZD：タイムゾーン※2

progid
発生プログラム名
「OpenTP1」という文字列が出力されます。

compid
コンポーネント名
監査事象が発生したコンポーネントの名称が出力されます。監査ログを出力するAPIを使用してUAPから取得した監査ログの場合，「*AA」の形式で出力されます。AAは，監査ログを出力するAPIで指定した値です。「*」から始まらない場合は，OpenTP1によって出力される監査ログになります。

pid
プロセスID
監査事象が発生したプロセスのプロセスIDが出力されます。

ocp:ipv4t
発生場所
監査事象が発生したIPアドレスが出力されます。

ctgry
監査事象種別
監査事象の種別が次の形式で出力されます。

StartStop：サーバ，サービスなどの起動・終了を示す事象です。

Authentication：ユーザ認証が実行されたことを示す事象です。

ConfigurationAccess：設定および構成の変更を示す事象です。

AccessControl：ユーザが管理リソースへのアクセスを試みて成功・失敗したことを示す事象です。

Failure：ソフトウェアの異常を示す事象です。

LinkStatus※3：機器間のリンク状態を示す事象です。

ExternalService※3：外部サービスとの通信結果を示す事象です。

ContentAccess：ユーザの重要なデータへのアクセスを試みて，成功・失敗したことを示す事象です。

Maintenance：保守操作を実行して成功・失敗したことを示す事象です。

AnomalyEvent：異常な通信の発生を示す事象です。

ManagementAction※3：プログラムの重要なアクションの実行を示す事象，ほかの監査事象を契機として実行するアクションなどを示す事象です。

result
監査事象の結果
監査事象の結果が次の形式で出力されます。

Success：監査事象の成功を示す事象です。

Failure：監査事象の失敗を示す事象です。

Occurrence：成功および失敗の区別がない事象です。

subj:euid
サブジェクト識別情報
監査事象を発生させた利用者または代行するプロセスが次のどちらかで出力されます。

実効ユーザ（OSアカウントのユーザID）

プロセスID

subj:pid

obj
オブジェクト情報
監査事象となった操作の対象の情報が出力されます。
固有情報

op
動作情報
監査事象となった操作の種別が次の形式で出力されます。

Start：起動を示します。

Stop：停止を示します。

Login：ログインを示します。

Logout※3：ログアウトを示します。

Logon※3：ログオンを示します。

Logoff※3：ログオフを示します。

Refer：設定情報の参照を示します。

Add※3：設定情報の追加を示します。

Update※3：設定情報の更新を示します。

Delete：設定情報の削除を示します。

Occur：障害などの発生を示します。

Enforce：処理の実施を示します。

Up※3：リンクの活性を示します。

Down※3：リンクの非活性を示します。

Request※3：要求を示します。

Response※3：応答を示します。

Send※3：発信を示します。

Receive※3：受信を示します。

Install※3：インストールを示します。

Uninstall※3：アンインストールを示します。

Backup※3：バックアップを示します。

Maintain：保守作業を示します。

Invoke※3：管理者などの呼び出しを示します。

Notify※3：管理者などへの通知を示します。

objloc
オブジェクトロケーション情報
オブジェクトロケーション情報が出力されます。

from:ipv4
リクエスト送信元ホスト
監査事象が複数のプログラム間で連携して動作する場合に，リクエストの送信元のIPアドレスが出力されます。

from:port
リクエスト送信元ポート番号
監査事象が複数のプログラム間で連携して動作する場合に，リクエストの送信元のポート番号が出力されます。

to:ipv4
リクエスト送信先ホスト
監査事象が複数のプログラム間で連携して動作する場合に，リクエストの送信先のIPアドレスが出力されます。

to:port
リクエスト送信先ポート番号
監査事象が複数のプログラム間で連携して動作する場合に，リクエストの送信先のポート番号が出力されます。

loc
ロケーション情報
環境変数DCDIRに設定された情報が出力されます。

msg
自由記述
監査事象の内容を示す文章が出力されます。

注※1

共通情報として分類されている出力項目は，すべて監査ログに出力されます。固有情報として分類されている出力項目は，状況によって任意に出力されます。

注※2

タイムゾーンは，1970年1月1日0時0分0秒（UTC）からの時差で表示されます。表示形式と意味を次に示します。

+hh.mm

UTCからhh時間mm分進んでいることを示します。

-hh.mm

UTCからhh時間mm分遅れていることを示します。

Z

UTCと同じ

日本標準時の場合，+09:00と表示されます。

注※3

監査ログを出力するAPIを使用して，UAPから監査ログを取得するように実装した場合にだけ出力される情報です。

監査イベントごとに設定される項目の詳細については，「付録C 監査イベントの出力情報」を参照してください。

3.7.5　監査イベントの一覧と出力ポイント

監査ログを出力するイベント（監査イベント）の一覧とイベント発生時に監査ログが出力されるポイントについて説明します。

＜この項の構成＞

(1)　監査イベントの一覧

(2)　監査ログの出力ポイント

(1)　監査イベントの一覧

監査イベントの一覧を次の表に示します。

表3-13　監査イベントの一覧

監査イベント
メッセージID

OpenTP1開始
KFCA33400-I

OpenTP1待機状態
KFCA33401-I

OpenTP1正常終了
KFCA33402-I

OpenTP1異常終了
KFCA33403-E

プロセスサービスの重大なエラー
KFCA33404-E

ユーザサーバ開始
KFCA33405-I

ユーザサーバ正常終了
KFCA33406-I

ユーザサーバ異常終了
KFCA33407-E

ユーザサーバ閉塞
KFCA33408-I

ユーザサーバのサービス閉塞
KFCA33409-I

クライアントユーザ認証成功
KFCA33410-I

クライアントユーザ認証失敗
KFCA33411-W

サービス関数の実行開始
KFCA33412-I

サービス関数の実行完了
KFCA33413-I

不正電文の破棄
KFCA33414-W

RPC呼び出し完了
KFCA33415-I

RPC応答の受信
（dc_rpc_poll_any_replies関数の使用時）
KFCA33416-I

rapの不正電文の破棄
KFCA33417-W

OpenTP1ファイルシステムに対するアクセスエラー
KFCA33418-W

コマンドの実行
KFCA33419-I

OpenTP1サービス開始
KFCA33420-I

OpenTP1サービス停止
KFCA33421-I

UAPからユーザが任意に取得する監査ログの取得
KFCA34000-x～KFCA34999-x※

メッセージの詳細については，マニュアル「OpenTP1 メッセージ」を参照してください。

注※

KFCA34000-x～KFCA34999-xは，UAPで任意の監査ログを取得する場合に，監査ログに対して割り当てられるメッセージIDです。xにはdc_log_audit_print関数で指定したメッセージの種類（E，WまたはI）が入ります。

(2)　監査ログの出力ポイント

イベント発生時に監査ログが出力されるポイントについて説明します。

(a)　OpenTP1開始

OpenTP1を開始するときの監査ログの出力ポイントを次の図に示します。

図3-6　監査ログの出力ポイント（OpenTP1開始）

この図に示した監査ログの出力ポイントと出力される監査ログのメッセージIDの対応を次の表に示します。

表3-14　監査ログの出力ポイントとメッセージIDの対応（OpenTP1開始）

監査イベント | 図中の番号 | 出力される監査ログのメッセージID
OpenTP1開始 | 1 | KFCA33400-I

(b)　OpenTP1待機状態

OpenTP1を待機状態にするときの監査ログの出力ポイントを次の図に示します。

図3-7　監査ログの出力ポイント（OpenTP1待機状態）

この図に示した監査ログの出力ポイントと出力される監査ログのメッセージIDの対応を次の表に示します。

表3-15　監査ログの出力ポイントとメッセージIDの対応（OpenTP1待機状態）

監査イベント | 図中の番号 | 出力される監査ログのメッセージID
OpenTP1待機状態 | 1 | KFCA33401-I

(c)　OpenTP1正常終了

OpenTP1を正常終了するときの監査ログの出力ポイントを次の図に示します。

図3-8　監査ログの出力ポイント（OpenTP1正常終了）

この図に示した監査ログの出力ポイントと出力される監査ログのメッセージIDの対応を次の表に示します。

表3-16　監査ログの出力ポイントとメッセージIDの対応（OpenTP1正常終了）

監査イベント | 図中の番号 | 出力される監査ログのメッセージID
OpenTP1正常終了 | 1 | KFCA33402-I

(d)　OpenTP1異常終了・プロセスサービスの重大なエラー

OpenTP1が異常終了するとき，またはプロセスサービスに重大なエラーが発生するときの監査ログの出力ポイントを次の図に示します。

図3-9　監査ログの出力ポイント（OpenTP1異常終了・プロセスサービスの重大なエラー）

この図に示した監査ログの出力ポイントと出力される監査ログのメッセージIDの対応を次の表に示します。

表3-17　監査ログの出力ポイントとメッセージIDの対応（OpenTP1異常終了・プロセスサービスの重大なエラー）

監査イベント | 図中の番号 | 出力される監査ログのメッセージID
OpenTP1異常終了 | 1 | KFCA33403-E
プロセスサービスの重大なエラー | 2 | KFCA33404-E

(e)　ユーザサーバ開始

ユーザサーバを開始するときの監査ログの出力ポイントを次の図に示します。

図3-10　監査ログの出力ポイント（ユーザサーバ開始）

この図に示した監査ログの出力ポイントと出力される監査ログのメッセージIDの対応を次の表に示します。

表3-18　監査ログの出力ポイントとメッセージIDの対応（ユーザサーバ開始）

監査イベント | 図中の番号 | 出力される監査ログのメッセージID
ユーザサーバ開始 | 1 | KFCA33405-I

(f)　ユーザサーバ正常終了

ユーザサーバを正常終了するときの監査ログの出力ポイントを次の図に示します。

図3-11　監査ログの出力ポイント（ユーザサーバ正常終了）

この図に示した監査ログの出力ポイントと出力される監査ログのメッセージIDの対応を次の表に示します。

表3-19　監査ログの出力ポイントとメッセージIDの対応（ユーザサーバ正常終了）

監査イベント | 図中の番号 | 出力される監査ログのメッセージID
ユーザサーバ正常終了 | 1 | KFCA33406-I

(g)　ユーザサーバ異常終了

ユーザサーバが異常終了するときの監査ログの出力ポイントを次の図に示します。

図3-12　監査ログの出力ポイント（ユーザサーバ異常終了）

この図に示した監査ログの出力ポイントと出力される監査ログのメッセージIDの対応を次の表に示します。

表3-20　監査ログの出力ポイントとメッセージIDの対応（ユーザサーバ異常終了）

監査イベント | 図中の番号 | 出力される監査ログのメッセージID
ユーザサーバ異常終了 | 1 | KFCA33407-E

(h)　ユーザサーバ閉塞・ユーザサーバのサービス閉塞

ユーザサーバが閉塞するとき，またはユーザサーバのサービスが閉塞するときの監査ログの出力ポイントを次の図に示します。

図3-13　監査ログの出力ポイント（ユーザサーバ閉塞・ユーザサーバのサービス閉塞）

この図に示した監査ログの出力ポイントと出力される監査ログのメッセージIDの対応を次の表に示します。

表3-21　監査ログの出力ポイントとメッセージIDの対応（ユーザサーバ閉塞・ユーザサーバのサービス閉塞）

監査イベント | 図中の番号 | 出力される監査ログのメッセージID
ユーザサーバ閉塞 | 1 | KFCA33408-I
ユーザサーバのサービス閉塞 | 1 | KFCA33409-I

(i)　クライアントユーザ認証成功・失敗

クライアントユーザの認証が成功，または失敗したときの監査ログの出力ポイントを次の図に示します。

図3-14　監査ログの出力ポイント（クライアントユーザ認証成功・失敗）

この図に示した監査ログの出力ポイントと出力される監査ログのメッセージIDの対応を次の表に示します。

表3-22　監査ログの出力ポイントとメッセージIDの対応（クライアントユーザ認証成功・失敗）

監査イベント | 図中の番号 | 出力される監査ログのメッセージID
クライアントユーザ認証成功 | 1 | KFCA33410-I
クライアントユーザ認証失敗 | 1 | KFCA33411-W

(j)　RPCの実行

同期応答型RPC，非同期応答型RPC，および非応答型RPCを実行したときの監査ログの出力ポイントをそれぞれ図3-15，図3-16，および図3-17に示します。

図3-15　監査ログの出力ポイント（同期応答型RPC）

図3-16　監査ログの出力ポイント（非同期応答型RPC）

図3-17　監査ログの出力ポイント（非応答型RPC）

これらの図に示した監査ログの出力ポイントと出力される監査ログのメッセージIDの対応を次の表に示します。

表3-23　監査ログの出力ポイントとメッセージIDの対応（RPCの実行）

監査イベント | 図中の番号 | 出力される監査ログのメッセージID
サービス関数の実行開始 | 1 | KFCA33412-I
サービス関数の実行完了 | 2 | KFCA33413-I
RPC呼び出し完了 | 3 | KFCA33415-I
RPC応答の受信（dc_rpc_poll_any_replies関数の使用時） | 4 | KFCA33416-I

(k)　不正電文の破棄

不正電文が破棄されたときの監査ログの出力ポイントを次の図に示します。

図3-18　監査ログの出力ポイント（不正電文の破棄）

この図に示した監査ログの出力ポイントと出力される監査ログのメッセージIDの対応を次の表に示します。

表3-24　監査ログの出力ポイントとメッセージIDの対応（不正電文の破棄）

監査イベント | 図中の番号 | 出力される監査ログのメッセージID
不正電文の破棄 | 1 | KFCA33414-W
rapの不正電文の破棄 | 1 | KFCA33417-W

(l)　OpenTP1ファイルシステムに対するアクセスエラー

OpenTP1ファイルシステムに対するアクセスエラーが発生したときの監査ログの出力ポイントを次の図に示します。

図3-19　監査ログの出力ポイント（OpenTP1ファイルシステムに対するアクセスエラー）

この図に示した監査ログの出力ポイントと出力される監査ログのメッセージIDの対応を次の表に示します。

表3-25　監査ログの出力ポイントとメッセージIDの対応（OpenTP1ファイルシステムに対するアクセスエラー）

監査イベント | 図中の番号 | 出力される監査ログのメッセージID
OpenTP1ファイルシステムに対するアクセスエラー | 1 | KFCA33418-W

(m)　コマンドの実行

コマンドを実行したときの監査ログの出力ポイントを次の図に示します。

図3-20　監査ログの出力ポイント（コマンドの実行）

この図に示した監査ログの出力ポイントと出力される監査ログのメッセージIDの対応を次の表に示します。

表3-26　監査ログの出力ポイントとメッセージIDの対応（コマンドの実行）

監査イベント | 図中の番号 | 出力される監査ログのメッセージID
コマンドの実行 | 1 | KFCA33419-I

(n)　OpenTP1サービス開始

OpenTP1サービスを開始したときの監査ログの出力ポイントを次の図に示します。

図3-21　監査ログの出力ポイント（OpenTP1サービス開始）

この図に示した監査ログの出力ポイントと出力される監査ログのメッセージIDの対応を次の表に示します。

表3-27　監査ログの出力ポイントとメッセージIDの対応（OpenTP1サービス開始）

監査イベント | 図中の番号 | 出力される監査ログのメッセージID
OpenTP1サービス開始 | 1 | KFCA33420-I

(o)　OpenTP1サービス停止

OpenTP1サービスを停止したときの監査ログの出力ポイントを次の図に示します。

図3-22　監査ログの出力ポイント（OpenTP1サービス停止）

この図に示した監査ログの出力ポイントと出力される監査ログのメッセージIDの対応を次の表に示します。

表3-28　監査ログの出力ポイントとメッセージIDの対応（OpenTP1サービス停止）

監査イベント | 図中の番号 | 出力される監査ログのメッセージID
OpenTP1サービス停止 | 1 | KFCA33421-I

3.7.6　監査ログの運用例

監査ログを使用して監査を実施するシステムでは，監査ログをすべて保存しておくことが求められます。そのため，シフト方式によって削除される監査ログファイルをバックアップしたり，監査ログの出力に失敗した場合は，システムを停止するなどの運用を検討したりする必要があります。これらの処理は，JP1などの運用管理プログラムを使用して自動実行することをお勧めします。また，JP1/NETM/Auditを使用することで，複数のホストに分散している監査ログを自動的に収集し，一元的に監査ログを管理できます。

ここでは，JP1などの運用管理プログラムと連携して監査ログを運用する例について説明します。

＜この項の構成＞

(1)　監査ログを自動でバックアップする運用例

(2)　監査ログの出力失敗時にシステムを停止させる運用例

(3)　監査ログの自動収集および一元管理の運用例

(1)　監査ログを自動でバックアップする運用例

監査ログの出力先ファイルが切り替わると，ファイルが切り替わったことを通知するメッセージが標準出力およびsyslogに出力されます。JP1などの運用管理プログラムを使用すると，ファイル切り替えを通知するメッセージを監視して，自動でファイルをバックアップできます。

運用管理プログラムを使用して，監査ログを自動でバックアップする流れを次の図に示します。

図3-23　監査ログを自動でバックアップする流れ

監査ログの出力先が，カレントファイルからカレントファイルのバックアップファイルに切り替わります。

監査ログの出力先が切り替わったことを通知するメッセージ（KFCA01925-I）をOpenTP1が出力します。

JP1などの運用管理プログラムが通知メッセージを検知します。

JP1などの運用管理プログラムが古い監査ログファイルを取得します。

(2)　監査ログの出力失敗時にシステムを停止させる運用例

JP1などの運用管理プログラムを使用すると，監査ログの出力に失敗したことを通知するメッセージを監視して，システムを自動で停止できます。

運用管理プログラムを使用して，監査ログの出力に失敗した場合にシステムを自動で停止させる流れを次の図に示します。

図3-24　監査ログの出力に失敗した場合にシステムを自動停止させる流れ

障害によってOpenTP1が監査ログの出力に失敗します。

監査ログの出力に失敗したことを通知するエラーメッセージ（KFCA01921-E～KFCA01924-E）をOpenTP1が出力します。

JP1などの運用管理プログラムがエラーメッセージを検知します。

JP1などの運用管理プログラムがOpenTP1を停止させます。

(3)　監査ログの自動収集および一元管理の運用例

運用管理プログラムとしてJP1/NETM/Auditを使用すると，監査ログの自動収集，および収集した監査ログを一元管理できます。一元管理をすることで，複数のサーバから収集した監査ログの検索，集計，結果の出力などが容易にできます。JP1/NETM/Auditを使用した監査ログの収集，および一元管理の例を次の図に示します。

図3-25　JP1/NETM/Auditを使用した監査ログの収集・一元管理の例

この例では，複数のOpenTP1サーバがそれぞれのディスクに出力した監査ログを監査ログ管理サーバで自動収集しています。また，監査ログ管理サーバに収集された監査ログは，監査ログ管理データベースで一元管理しています。

JP1/NETM/Auditとの連携で必要となるJP1関連製品を次に示します。

表3-29　JP1/NETM/Auditとの連携で必要となるJP1関連製品

JP1関連製品
機能
配置するサーバ

JP1/NETM/Audit
JP1/Baseと連携して，OpenTP1サーバが出力する監査ログを収集します。また，収集した監査ログを監査ログ管理サーバのデータベースで一元管理します。
監査ログ管理サーバ

JP1/Base
出力された監査ログを，JP1イベントとして送受信します。

監査ログ管理サーバ

OpenTP1サーバ

監査ログは次に示すタイミングで自動収集されます。

指定した日時に定期的に収集

（JP1/Baseの）イベントデータベースの切り替え時に自動収集

即時収集

OpenTP1サーバおよび監査ログ管理サーバで必要な設定について説明します。

OpenTP1サーバで必要な設定

OpenTP1サーバの設定手順を次に示します。

JP1/Baseをセットアップします。

監査ログ管理サーバから，監査ログ収集対象のOpenTP1サーバに，JP1/Baseのアダプタコマンドのファイルとアダプタコマンドの動作に必要な定義のファイルをコピーします。

イベントサービスを起動します。

監査ログ管理サーバで必要な設定

OpenTP1はJP1/NETM/Auditを標準サポートしています。そのためJP1/NETM/AuditでOpenTP1を収集対象に設定できます。

OpenTP1ではJP1/NETM/Auditで使用する製品定義ファイルおよび動作定義ファイルを，次の場所に格納しています。

製品定義ファイルの格納場所
（インストールディレクトリ）/jp1_template/JP1_NETM_Audit/OpenTP1.conf

動作定義ファイルの格納場所
（インストールディレクトリ）/jp1_template/JP1_NETM_Audit/admjevlog_OpenTP1.conf

JP1/NETM/Auditを使用した監査ログの収集および一元管理の詳細については，マニュアル「JP1/NETM/Audit」を参照してください。

3.8　トレースに関する運用

＜この節の構成＞

3.8.1　UAPトレースの出力

3.8.2　RPCトレースに関する運用

3.8.3　MCFトレースのスワップ

3.8.4　MCFトレースの一時出力

3.8.5　性能検証用トレースに関する運用

3.8.1　UAPトレースの出力

UAPが異常終了した場合は，UAPトレースが自動でファイルに編集出力されます。また，uatdumpコマンドを使用してUAPトレースを標準出力に編集出力できます。

出力内容は，起動していたサービスが属するサービスグループの名称，UAPトレース情報の取得日時などです。

なお，UAPトレースの詳細，およびuatdumpコマンドについては，マニュアル「OpenTP1 テスタ・UAPトレース使用の手引」を参照してください。

3.8.2　RPCトレースに関する運用

＜この項の構成＞

(1)　RPCトレースのマージ

(2)　RPCトレースの出力

(3)　注意事項

(1)　RPCトレースのマージ

複数のRPCトレースファイルのトレース情報をマージする場合，rpcmrgコマンドを使用します。rpcmrgコマンドを実行すると，トレース情報を時系列に並べ，RPCトレースファイルの形式で出力できます。

(2)　RPCトレースの出力

RPCトレースファイルからRPCトレースを編集して出力する場合，rpcdumpコマンドを使用します。オプションの指定によって，ユーザが必要な範囲のRPCトレースだけを出力できます。

出力内容は，起動していたサービスが属するサービスグループの名称，RPCトレース出力元のプロセスIDなどです。

(3)　注意事項

RPCトレースを取得した場合，処理速度が低下し，RPCがタイムアウトでエラーリターンすることがあります。その場合は，次のどちらかの対処をしてください。

dc_rpc_set_watch_time関数を発行して，最大応答待ち時間（未発行時：180秒）を十分な値まで増やしてください。

状況に応じて次の1.または2.の最大応答待ち時間（デフォルト値：180秒）を十分な値まで増やしてください。

watch_timeオペランド（システム共通定義，ユーザサービス定義，またはユーザサービスデフォルト定義で指定）に指定した最大応答待ち時間

クライアントからrapサーバに引き継いだ最大応答待ち時間

クライアントからrapサーバに最大応答待ち時間を引き継ぐかどうかは，クライアント環境定義のDCWATCHTIMINHERITオペランド（TP1/Client/W，TP1/Client/Pの場合），またはTP1/Client/J環境定義のdcwatchtiminheritオペランド（TP1/Client/Jの場合）で指定します。
DCWATCHTIMINHERITオペランドまたはdcwatchtiminheritオペランドにYが指定されている場合は，上記2.の最大応答待ち時間を使用してください。
DCWATCHTIMINHERITオペランドまたはdcwatchtiminheritオペランドにNが指定されているか，指定が省略されている場合は，上記1.の最大応答待ち時間を使用してください。

3.8.3　MCFトレースのスワップ

最新のMCFトレースをファイルに出力したい場合は，mcftswptrコマンドでMCFトレースファイルをスワップしてください。

3.8.4　MCFトレースの一時出力

共用メモリ上に取得しているMCFトレース情報を，任意のタイミングでMCFトレースファイルに出力できます。MCFトレース情報の取得を開始するには，mcftstrtrコマンドを使用します。MCFトレース情報の取得を終了し，MCFトレースファイルに出力するには，mcftstptrコマンドを使用します。これらのコマンドは，主にMCFトレースのディスク出力機能を使用しないように定義した場合（mcfttrc -t "disk=no"）で，一時的にMCFトレースファイルを取得したいときに使用します。

MCFトレース情報をMCFトレースファイルへ出力する処理の概要を次の図に示します。

図3-26　MCFトレースの一時出力処理の概要

3.8.5　性能検証用トレースに関する運用

OpenTP1は，OpenTP1で動作するサービスの主なイベントで，性能検証用トレース情報を取得しています。性能検証用トレース情報は，性能検証およびトラブルシュートの効率向上を目的とします。

prfgetコマンドでトレース情報を取得し，prfedコマンド，またはdcalzprfコマンドで編集出力します。prfgetコマンドは，性能検証用トレース情報をバイナリ形式でUNIXファイルに出力します。prfedコマンド，またはdcalzprfコマンドは，バイナリ形式のトレース情報をキャラクタ形式に編集出力します。prfedコマンド，またはdcalzprfコマンドは，トレース情報の詳細を見るために使用します。

性能検証用トレース情報取得機能の特長は次のとおりです。

ノードおよびプロセスをわたる場合でもトレースを追うことができます。

APIの単位でなく，内部のイベント単位でトレースを取得するので，どの処理が性能ネックか検証できます。

各トレース情報がいつ取得されたかは，出力されたイベントIDで識別します。イベントIDとトレース情報取得のタイミングについては，「付録L.1　性能検証用トレースの取得情報」を参照してください。

また，性能検証用トレースの利用例を「付録L.3　性能検証用トレース情報の解析例」に記載してあります。併せてご参照ください。

なお，この機能は，TP1/Extension 1をインストールしていることが前提です。TP1/Extension 1をインストールしていない場合の動作は保証できませんので，ご了承ください。

注意事項

通常再開始，ホットスタンバイでは，トレース情報は引き継がれません。

性能検証用トレース取得機能では，オンラインの性能に影響がないように，トレース取得での排他は行われません。このため，マルチプロセッサ環境でトレース取得の競合が発生した場合，トレース情報が抜けたり，不正なトレース情報が取得されることがあります。不正なトレース情報は，prfedコマンド，またはdcalzprfコマンドでトレース情報を編集すると，エラーレコードとして表示されます。

性能検証用トレース取得機能での，性能検証用トレースファイル運用の流れを次の図に示します。

図3-27　性能検証用トレースファイルの運用の流れ

オンライン中に出力されるprfトレースデータは$DCDIR/spool/dcprfinf下にprf_nnn※1というファイル名で取得されます。一つのファイルの容量は，prf_file_sizeオペランドで指定した値です。また，ファイルの世代数はprf_file_countオペランドで指定した値です。オンライン中は一つのファイル容量がいっぱいになるとスワップしてトレースを取得します。

OpenTP1の終了処理時には，$DCDIR/spool/save下にあるprf_nnn.bk2※2をprf_nnn.bk1※2に移します。

$DCDIR/spool/dcprfinf下のprf_nnn※1を$DCDIR/spool/save下にprf_nnn.bk2※2としてコピーします。

注※1

nnn：性能検証用トレース定義のprf_file_countオペランドで指定した値を上限とした001から始まる値です。

注※2

nnn：バックアップ元のファイル名に対応した値です。

＜この項の構成＞

(1)　OpenTP1で取得する性能検証用トレース

(2)　性能検証用トレースファイルのバックアップ機能

(3)　性能検証用トレースファイルのバックアップの抑止

(1)　OpenTP1で取得する性能検証用トレース

OpenTP1では性能検証用トレースとして次の表に示すトレースを取得します。これらを総称して性能検証用トレースと呼びます。また，性能検証用トレースデータを取得するファイルを性能検証用トレースファイルと呼びます。

トレース名称 | 性能検証用トレースファイル名
性能検証用トレース | prf_nnn※
XAR性能検証用トレース | _xr_nnn※
JNL性能検証用トレース | _jl_nnn※
LCK性能検証用トレース | _lk_nnn※
MCF性能検証用トレース | _mc_nnn※
NAMイベントトレース | _nm_001，_nm_002，_nm_003
プロセスサービスイベントトレース | _pr_001，_pr_002，_pr_003
FILイベントトレース | _fl_001，_fl_002，_fl_003
TRNイベントトレース | _tr_nnn※

注※

nnn：それぞれ，次に示す定義のprf_file_countオペランドで指定した値を上限とした001から始まる値です。

・性能検証用トレース：性能検証用トレース定義

・XAR性能検証用トレース：XAR性能検証用トレース定義

・JNL性能検証用トレース：JNL性能検証用トレース定義

・LCK性能検証用トレース：LCK性能検証用トレース定義

・MCF性能検証用トレース：MCF性能検証用トレース定義

・TRNイベントトレース：TRNイベントトレース定義

(2)　性能検証用トレースファイルのバックアップ機能

OpenTP1の性能検証用トレース取得機能では，トレースデータの誤消去による調査時の資料不足を防止するため，OpenTP1の終了時にトレースファイルのバックアップを取得しています。トレースファイルのバックアップを取得するメリットおよびデメリットは次のとおりです。

メリット
OpenTP1終了時に，取得済みのトレースデータをバックアップすることで資料の誤消去による調査資料不足を防止できる。

デメリット

バックアップするためにディスク領域が必要になる。

OpenTP1の終了に時間が掛かる。

(3)　性能検証用トレースファイルのバックアップの抑止

性能検証用トレースファイルのバックアップ機能はメリットがある一方，定義によってはデメリットの方が大きくなる場合があります。メリットよりデメリットの方が大きい場合は，バックアップを抑止できます。この場合，OpenTP1は自動的にバックアップを取得しないため，運用に当たって性能検証用トレースファイルをバックアップするようにしなければなりません。

性能検証用トレースファイルのバックアップを抑止する場合は，障害調査などの場合に資料不足にならないように，十分に検討することをお勧めします。

3.9　共用メモリに関する運用

＜この節の構成＞

3.9.1　共用メモリ使用状況の表示

3.9.2　メッセージ格納バッファプール

3.9.1　共用メモリ使用状況の表示

OpenTP1稼働中の共用メモリの使用状況を知りたいときは，dcshmlsコマンドを使用します。dcshmlsコマンドを実行すると，現在使用中の共用メモリの合計値，共用メモリの使用率などを表示できます。また，オプションの指定によって，静的共用メモリ，または動的共用メモリの使用状況も表示できます。

3.9.2　メッセージ格納バッファプール

OpenTP1はクライアントからのサービス要求を，いったんメッセージ格納バッファプールに蓄積して処理しています。このメッセージ格納バッファプールは，ユーザサーバ単位に共用メモリに作成されるので，サービスを処理するユーザサーバの数が増えるとシステムのリソースを圧迫する場合があります。

スケジュールサービス定義のscdbufgrpオペランドを指定した場合，メッセージ格納バッファプールを共用できます。一つのメッセージ格納バッファプールを複数のユーザサーバで共有するので，共用メモリの使用量を削減できます。一つのメッセージ格納バッファプールを共用する複数のユーザサーバをスケジュールバッファグループと呼びます。

スケジュールバッファグループが共用しているメッセージ格納バッファプールの状態を表示するには，scdlsコマンドに-bオプションを指定します。次の内容が表示されます。

メッセージ格納バッファプール使用可能サイズ

メッセージ格納バッファプールの使用中のサイズ

メッセージ格納バッファプールの最大サイズ

メッセージ格納バッファプールを共用しているユーザサーバ名

これらの情報はスケジュールバッファグループごとに表示されます。また，共用しているユーザサーバの情報として，次に示す情報がユーザサーバ単位に表示されます。

ユーザサーバの状態

サービス要求の滞留数

最大サービスと要求の滞留数

ユーザサーバが使用しているメッセージ格納バッファプールサイズ

ユーザサーバが使用できるメッセージ格納バッファプールの最大サイズ

OpenTP1起動時に，スケジュールサービス定義で指定しただけの共用メモリを確保できないときはシステムダウンします。この場合は，メモリの値を見積もり直してください。

3.10　OpenTP1のドメインに関する運用

システム共通定義のall_nodeオペランドで指定したノードを一つのまとまりにしたものをOpenTP1のドメインといいます。

＜この節の構成＞

3.10.1　ドメイン構成の変更

3.10.2　ドメイン代表スケジュールサービス

3.10.3　起動通知情報の無効化

3.10.4　OpenTP1起動確認とキャッシュ削除機能

3.10.1　ドメイン構成の変更

ドメインを構成するノードをOpenTP1の動作中に変更するには，namndchgコマンドまたはnamchgflコマンドを使用します。それぞれのコマンドでドメイン構成を変更する方法を次に示します。

＜この項の構成＞

(1)　namndchgコマンドを使用したドメイン構成の変更

(2)　namchgflコマンドを使用したドメイン構成の変更

(3)　追加ノード数の変更

(1)　namndchgコマンドを使用したドメイン構成の変更

システム共通定義のall_nodeオペランドを変更し，namndchgコマンドを実行してドメイン構成を変更します。ドメイン構成の変更手順を次に示します。

システム共通定義のall_nodeオペランドのノードの構成を変更します。

namndchgコマンドを実行します。コマンドが正常終了すると，変更したノードでドメインが構成されます。

また，namndchgコマンドに-lオプションを指定すると，そのときにドメインを構成しているノード名とポート番号（all_nodeオペランドの指定内容）が表示されます。

(2)　namchgflコマンドを使用したドメイン構成の変更

ドメイン定義ファイルの定義でドメインの構成を変更します。namchgflコマンドを使用すると，システム共通定義を変更しなくてもドメイン構成を変更できます。namchgflコマンドを有効にするには，システム共通定義のname_domain_file_useオペランドにYを指定してください。name_domain_file_useオペランドの詳細については，マニュアル「OpenTP1 システム定義」を参照してください。ドメイン構成の変更手順を次に示します。

ドメイン定義ファイルを作成します。

namchgflコマンドを実行します。コマンドが正常終了すると，変更したノードでドメインが構成されます。グローバルキャッシュは初期化され，無登録状態になります。all_node_exのドメイン定義ファイルも変更対象にするには，namchgflコマンドに-eオプションを指定してください。

ドメイン構成の変更前後で同一ノードが指定されていた場合，そのノードについては，次の情報を変更前から引き継ぎます。

RPC抑止リストの登録状態

コネクションの接続時刻

●ドメイン定義ファイル

システム共通定義を変更しないでドメイン構成を変更するには，ドメイン定義ファイルが必要です。ドメイン定義ファイルには，all_nodeを指定するファイルと，all_node_exを指定するファイル，さらに優先選択ノードを指定する定義ファイルがあります。優先選択ノードの定義ファイルの指定方法は，all_nodeを指定するファイルおよびall_node_exを指定するファイルと同じです。

ファイル名称は40バイト以内の任意の名称です。それぞれのファイルを次の場所に格納してください。

all_nodeを指定するファイル

$DCCONFPATH/dcnamndディレクトリ下

all_node_exを指定するファイル

$DCCONFPATH/dcnamndexディレクトリ下

優先選択ノードを指定する定義ファイル

$DCCONFPATH/dcnamprディレクトリ下

これらのファイルのノード名やポート番号などに不正があった場合は，KFCA00656-E（ノード名不正），KFCA00657-E（ポート番号不正）またはKFCA00666-E（ホスト未定義）のメッセージを出力後，namchgflコマンドがエラーリターンし，ドメイン構成の変更は無効となります。

また，優先選択ノードの定義ファイルに指定したノードがall_nodeのドメイン定義ファイルに指定されていなかった場合は，KFCA00603-W（all_nodeに未定義）のメッセージを出力し，優先選択ノードの指定は無効となります。なお，同一ファイル内のほかの行で正しく定義されているノードについては，優先選択ノードの指定は有効となります。

それぞれのディレクトリ下に，複数のドメイン定義ファイルを格納した場合，同じディレクトリ下に格納されているすべてのドメイン定義ファイルを合わせて一つのドメイン（OpenTP1システム）を構成します。

次の場合，ドメイン定義ファイルは，自ノードだけのドメインとしてOpenTP1システムを構成します。優先選択ノードの定義ファイルは，ドメイン定義ファイルの指定に従います。

ドメイン定義ファイルが正しい場所に存在しない場合

ドメイン定義ファイルを格納するディレクトリが存在しない場合

ドメイン定義ファイルにノードが指定されていない場合

ドメイン定義ファイルの記述形式を次に示します。

ノード名〔,〔ポート番号〕〕〔,〕

ノード名　〈1～255文字の識別子〉

OpenTP1システムのすべてのノード名を指定します。識別子に使用できる文字は英数字，ピリオド，およびハイフンです。/etc/hostsに定義したホスト名がノード名になります。

ポート番号　〈符号なし整数〉((5001～65535))

ネームサーバがウェルノウンポート番号として使用するポート番号を指定します。ポート番号を省略した場合，システム共通定義のname_portオペランドに指定したネームサービスのポート番号を設定します。name_portオペランドを指定していない場合，10000を設定します。

1行に指定できる文字数は272バイトです。

1行には，ノード名とポート番号を一組だけ指定できます。

コメントを記入する場合は，コメントの先頭に'#'を記述してください。
行の先頭に'#'を記述すると1行全体がコメント扱いになります。

システム定義で使用している，複数行に分けて記述する場合の継続符号'¥'は不要です。

二つ目のコンマ（,）以降の文字は，エラー判定の対象外です。

注意事項

ドメイン定義ファイルに指定するノードには，一意のノード識別子を指定してください。

変更前のドメイン構成からノードを削除すると，次の機能が正しく動作しないおそれがあります。
・ISTサービス
・マルチノード機能

トランザクショナルRPCを使用したサービスを利用している場合，ドメイン構成の変更時に削除したノードのノード識別子と同一のノード識別子が指定されているノードは，追加しないでください。このようなノードを指定した場合，次の動作は保証できません。
・回復処理
・ISTサービス
・マルチノード機能

系切り替え構成でnamchgflコマンドを使用する場合，リラン時に備え，実行系と待機系で同じ内容のドメイン定義ファイルを格納してください。

namchgflコマンドの実行中にkillコマンドなどでnamchgflコマンドプロセスを強制停止させないでください。ネームサービス機能が正しく動作しなくなるおそれがあります。

リランの前後でname_domain_file_useオペランドを変更した場合の動作は保証できません。

ドメイン定義ファイルの記述例を次に示します。

0---+----1----+----2----+----3----+----4----+----5----+----6----+----7----+-
10.209.117.30,11111,                                            #コメント
10.209.117.40,33333,                                            #コメント
               （改行）※
#ZZZ※
10.209.117.50,11111
10.209.117.60,33333
10.209.117.70
10.209.117.80,
10.209.117.90,,
               （空行）※

注※

改行，空行，またはコメントだけの行でも指定が継続していると判断します。

(3)　追加ノード数の変更

ネームサービスが使用できる共用メモリの領域は，OpenTP1起動時に定義します。共用メモリの領域のサイズはオンライン中には変更できません。そのため，OpenTP1起動時に，必要な共用メモリの領域（最大ノード数）を確保してください。最大ノード数は，システム共通定義のall_node_extend_numberオペランドまたはall_node_ex_extend_numberオペランドで指定します。これらのオペランドの詳細については，マニュアル「OpenTP1 システム定義」を参照してください。

3.10.2　ドメイン代表スケジュールサービス

OpenTP1を使用して大規模な分散システムを構築する場合，OpenTP1システムを小規模なドメインに分割して運用できます。OpenTP1システムを小規模のドメインに分割して運用する場合，システム共通定義のall_nodeオペランドは自ドメイン内の各OpenTP1ノードだけを定義します。OpenTP1システム内のすべてのOpenTP1ノードを定義する必要はありません。

ドメインの窓口となるスケジュールサービスをドメイン代表スケジュールサービスと呼びます。ドメイン代表スケジュールサービスは，ドメインデータファイル（DNSのhosts情報ファイル）に登録します。ドメインデータファイルへの登録および削除は，namdomainsetupコマンドを使用します。

ドメイン間の通信は，dc_rpc_call関数でサービスグループ名にドメイン修飾して実現します。ドメイン間の通信では，OpenTP1は指定されたドメイン代表スケジュールサービスのIPアドレスをDNSサーバに問い合わせ，サービス要求をそのドメイン代表スケジュールサービスに渡します。サービス要求を受け付けたドメイン代表スケジュールサービスは，そのサービス要求を自ドメイン内のサーバUAPにスケジュールします。

また，システム共通定義のdomain_masters_addrオペランドを指定すると，DNSサーバにIPアドレスを問い合わせないで，直接，通信先のドメイン代表スケジュールサービスと通信するので，通信回数を削減できます。ドメイン代表スケジュールサービスの定義方法の詳細については，マニュアル「OpenTP1 システム定義」を参照してください。

3.10.3　起動通知情報の無効化

システム共通定義のname_notifyオペランドで指定した通信先OpenTP1への起動通知機能を強制的に無効にするには，namunavlコマンドを使用します。namunavlコマンドの実行後は新たにコネクションを確立するので，通信先から起動通知情報を受け取らない場合でも正常に通信できるようになります。

3.10.4　OpenTP1起動確認とキャッシュ削除機能

namalivechkコマンドを使用すると，コマンドを実行した時点でのOpenTP1システム内の他OpenTP1ノードの起動状態を確認できます。

OpenTP1ノードのダウンを検知した場合，該当するOpenTP1ノードのすべてのサービス情報をキャッシュから削除します。そのため，以降のRPCでは，ダウンしているOpenTP1ノードが通信対象ではなくなり，不要な通信を抑止できます。OpenTP1システムのうちの一つのOpenTP1ノードがダウンしたときにnamalivechkコマンドを実行すると，効率良くRPCを実行できます。

3.11　ノード自動追加機能を使用する運用

ノード自動追加機能とは，OpenTP1システムへのノードの追加や削除を容易にするための機能です。

ノード自動追加機能を使用すると，既存ノードでの定義修正をすることなく，ノードの追加および削除ができます。ノード自動追加機能を使用しないOpenTP1システムでは，ノードの追加，削除を伴うシステム構成を変更する場合，すべてのOpenTP1ノードで，定義を修正する必要があります。

＜この節の構成＞

3.11.1　ノード自動追加機能を使用するための構成

3.11.2　ノード自動追加機能を使用するための準備

3.11.3　ノード自動追加機能の導入後の運用

3.11.4　ノード自動追加機能とその他の機能との併用

3.11.5　ノーマルノードを混在させて使用する運用

3.11.1　ノード自動追加機能を使用するための構成

ノード自動追加機能を使用する場合の構成例を次の図に示します。

図3-28　ノード自動追加機能を使用する場合の構成例

注※

ノーマルノードとは，バージョン07-05以前のOpenTP1を使用しているノード，またはこの機能を使用していないノードのことです。この機能を使用する構成に，ノーマルノードを混在させることもできます。ノーマルノードを混在させて使用する運用については，「3.11.5　ノーマルノードを混在させて使用する運用」を参照してください。

＜この項の構成＞

(1)　マネジャノード

(2)　エージェントノード

(3)　ノードリスト

(4)　その他の機能との併用

(1)　マネジャノード

マネジャノードは，OpenTP1システムを構成するすべてのノード情報を管理するノードです。OpenTP1システム内に一つだけ必要です。システム共通定義のname_service_modeオペランドでmanagerを指定します。

(a)　マネジャノードの役割

マネジャノードの役割を次に示します。

ノードの稼働状況の監視
マネジャノードは，OpenTP1システム内の全ノードの稼働状況を一定間隔で監視します。

ノードリストへのノード情報の登録
OpenTP1システム内にノードが追加された場合，追加されたノードからマネジャノードにノードリスト要求が送信されます。マネジャノードはこれを受信し，ノードリストにそのノードの情報を登録します。

ノードリストからのノード情報の削除
エージェントノードやノーマルノードに障害などが発生した場合，マネジャノードはこれを検知し，ノードリストからそのノードを削除します。
停止したノードをノードリストから削除したくない場合は，システム共通定義のname_remove_down_nodeオペランドにNを指定します。

ノードリストの配布
マネジャノードは，次の場合に最新のノードリストを各ノードに配布します。

ノード構成の変更後に，エージェントノードからノードリスト要求を受信した場合

OpenTP1システム内に新たにノードが追加された場合

(b)　マネジャノードの構成および運用

マネジャノードが障害などの要因で停止すると，次のような影響があります。

OpenTP1システムにノードを自動追加できない。
OpenTP1システム内で，追加したノードとほかのノードで，RPCが実行できません。

OpenTP1システムからノードを自動削除できない。
停止しているノードへRPC要求を出す場合があります。

エージェントノードにノードリストが配布されないため，各ノード間でノードリストに不整合が生じる。
マネジャノードが保持しているノードリストのノードだけがRPCの実行範囲となるため，負荷分散が不完全になることがあります。

マネジャノードの障害時対策として，次の構成および運用にしてください。

系切り替え構成にする。

ノードリストの引き継ぎ機能を使用する。

系切り替え構成を導入できない場合の対応については，「3.11.3(3)　ノード自動追加機能の障害時の運用」を参照してください。ノードリストの引き継ぎ機能については，「3.11.2(3)　ノードリストの引き継ぎ機能を使用する」を参照してください。

(2)　エージェントノード

エージェントノードは，マネジャノードに管理されるノードです。システム共通定義のname_service_modeオペランドでagentを指定します。

マネジャノードが障害などの要因で停止した場合，エージェントノードをマネジャノードに昇格させて，マネジャノードとしてノード管理を代行させることもできます。

(3)　ノードリスト

ノードリストは，OpenTP1システムを構成する各ノード情報を格納し，マネジャノードによって一元管理されます。OpenTP1の共用メモリ上で管理します。

(a)　ノードリストの整合性確保

マネジャノードのノード監視によって，ノードリストには各ノードの情報が定期的に反映され，最新のノード情報を保持します。最新のノードリストは，マネジャノードからノード自動追加機能を使用する各ノードに配布され，OpenTP1システム内で同じノードリストを参照するように制御されています。これをノードリストの整合性確保といいます。

ノードリストの整合性確保の流れを次の図に示します。

図3-29　ノードリストの整合性確保の流れ

図で示したノードリストの整合性確保の流れについて説明します。番号は図中の番号と対応しています。

マネジャノードとエージェントノードは，ノード監視およびノードリスト要求の送受信をします。

マネジャノードが，ノードAの停止を検知します。

マネジャノードは，マネジャノードのノードリストからノードAを削除します。
ただし，システム共通定義のname_remove_down_nodeオペランドにNを指定した場合は削除しません。

ノードBからマネジャノードへノードリスト要求を送信します。

マネジャノードは，ノードBへ最新のノードリストを送信します。

(b)　ノードリストの更新タイミング

ノードリストはノードの追加や削除時に更新されます。

次の場合は，ノードリストを更新しないで，次回のノードリストの整合性を確保するときに更新します。

マネジャノードがノードリストからノード情報を削除する際に，サービスグループ情報の検索など，ノードリストを参照する処理が並行して動作している場合

エージェントノードでノードリストの整合性を確保する際に，サービスグループ情報の検索など，ノードリストを参照する処理が並行して動作している場合

(c)　ノードリストの引き継ぎ機能

ノードリストはノードリストの整合性確保によって，共用メモリ上でオンライン中に更新されます。共有メモリはOpenTP1の開始ごとに初期化されるため，前回オンライン時のノードリストの情報は失われ，ノードリストが再構築されます。このため，起動直後のノードリストには自ノードの情報しかない状態になり，ノードリストの整合性が確保されるまでの間，RPCの要求先が制限されてしまいます。

ノードリストの引き継ぎ機能は，このような一時的な制限を解消するための機能です。系切り替え構成の場合は，必ずノードリストの引き継ぎ機能をお使いください。また，マネジャノードでも，ノードリストの引き継ぎ機能を使用することをお勧めします。

ノードリストの引き継ぎ機能については，「3.11.2(3)　ノードリストの引き継ぎ機能を使用する」を参照してください。

(4)　その他の機能との併用

ノード自動追加機能は，ノード監視機能および優先選択ノードと併用できます。これらの機能との併用については，「3.11.4　ノード自動追加機能とその他の機能との併用」を参照してください。

3.11.2　ノード自動追加機能を使用するための準備

ノード自動追加機能を使用するために必要な準備を説明します。

＜この項の構成＞

(1)　マネジャノードで必要なシステム定義

(2)　エージェントノードで必要な定義

(3)　ノードリストの引き継ぎ機能を使用する

(1)　マネジャノードで必要なシステム定義

マネジャノードに必要な定義，および任意の定義は次のとおりです。

必要な定義

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

managerを指定します。ノード自動追加機能でのノードの動作モードを「マネジャノード」に指定します。

ネームサービス定義

name_audit_intervalオペランド
ノードを監視する間隔を指定します。

name_total_sizeオペランド
自ノードのネームサービスが確保するサービス情報領域の大きさを指定します。サービス情報領域の大きさについては，マニュアル「OpenTP1 システム定義」を参照してください。

任意の定義

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

停止したノードをノードリストから削除するかどうかを指定します。

ネームサービス定義のnamnlfil定義コマンド

ノードリストの引き継ぎ機能で使用するノードリストファイルのファイル名を完全パスで指定します。

各システム定義の詳細については，マニュアル「OpenTP1 システム定義」を参照してください。

(2)　エージェントノードで必要な定義

エージェントノードに必要な定義および任意の定義は，次のとおりです。

必要な定義

システム共通定義

name_service_modeオペランド
agentを指定します。ノード自動追加機能でのノードの動作モードを「エージェントノード」に指定します。

name_manager_nodeオペランド
エージェントノードを管理するマネジャノードのノード名を指定します。

ネームサービス定義

name_audit_intervalオペランド
ノードを監視する間隔を指定します。

name_total_sizeオペランド
自ノードのネームサービスが確保するサービス情報領域の大きさを指定します。サービス情報領域の大きさについては，マニュアル「OpenTP1 システム定義」を参照してください。

任意の定義

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

ノーマルノードやノード自動追加機能を使用していないノードの情報を，ノードリストに登録するかどうかを指定します。

ネームサービス定義

name_start_watch_timeオペランド
OpenTP1起動時のノードリスト要求について，応答待ち時間を指定します。

name_start_retry_countオペランド
OpenTP1起動時のノードリスト要求について，リトライ回数を指定します。

name_start_retry_intervalオペランド
OpenTP1起動時のノードリスト要求について，リトライ間隔を指定します。

name_start_errorオペランド
ノードリスト要求でエラーが発生した回数が，ネームサービス定義のname_start_retry_countオペランドに指定した値を超えた場合の処理を指定します。

name_sync_ready_timeオペランド
ノードリストの同期を取るまでの待ち時間を指定します。

namnlfil定義コマンド
ノードリストの引き継ぎ機能で使用するノードリストファイルのファイル名を完全パスで指定します。

各システム定義の詳細については，マニュアル「OpenTP1 システム定義」を参照してください。

(3)　ノードリストの引き継ぎ機能を使用する

ノードリストはノードリストの整合性確保によって，共用メモリ上でオンライン中に更新されます。共有メモリはOpenTP1の開始ごとに初期化されるため，前回オンライン時のノードリストの情報は失われ，ノードリストが再構築されます。このため，起動直後のノードリストには自ノードの情報しかない状態になり，ノードリストの整合性が確保されるまでの間，RPCによるサービス要求先が制限されてしまいます。

ノードリストの引き継ぎ機能は，このような一時的な制限を解消するための機能です。前回起動中のノードリストの情報がファイルに書き込まれ，再起動時にその情報を基にノードリストが引き継がれ，回復します。

系切り替え構成の場合は，必ずノードリストの引き継ぎ機能をお使いください。また，マネジャノードでも，ノードリストの引き継ぎ機能を使用することをお勧めします。

ノードリスト情報を格納しておくファイルをノードリストファイルといいます。ノードリストを引き継ぐ場合は，namnlcreコマンドで事前にノードリストファイルを作成しておく必要があります。namnlcreコマンドについては，「13.　運用コマンドの詳細」の「namnlcre」を参照してください。

(a)　系切り替え構成でノードリストの引き継ぎ機能を使用する

系切り替え構成の場合は，必ずノードリストの引き継ぎ機能をお使いください。系切り替え構成でノードリストを引き継ぐ流れを次の図に示します。

図3-30　系切り替え構成でノードリストを引き継ぐ流れ

マネジャノードが障害などで停止しても，実行系システムで使用していたノードリストがノードリストファイルに書き込まれているため，系切り替え時に待機系システムへ引き継げます。

(b)　マネジャノードでノードリストの引き継ぎ機能を使用する

マネジャノードでノードリストを引き継ぐ流れを次の図に示します。

図3-31　マネジャノードでノードリストを引き継ぐ流れ

マネジャノードでノードリストを引き継ぐ場合

オンライン中にノードリストをノードリストファイルに書き込みます。

OpenTP1の開始時にノードリストには，自ノードの情報しかありません。

オンライン時に，前回オンライン時に保存したノードリストファイルからノードリストを引き継ぎます。
これによって，前回オンライン時と同等の構成でRPC要求が開始でき，エージェントノードからのノードリスト要求にも応答できます。

マネジャノードでノードリストを引き継がない場合

オンライン中にノードリストファイルへの書き込みはしません。

OpenTP1の開始時にノードリストには，自ノードの情報しかありません。

マネジャノードがエージェントノードからのノードリスト要求を受信するまでの間，ノードリストの状態は変わりません。

エージェントからのノードリスト要求を受信し，ノードリストを更新して，エージェントへノードリストを配布します。
RPC要求を開始できます。

マネジャノードが障害などで停止し再開始した場合も，ノードリストを引き継ぐときと，引き継がないときでは，RPCの開始までに同様の時間差があります。

(c)　エージェントノードでノードリストの引き継ぎ機能を使用する

エージェントノードでノードリストを引き継ぐ流れを次の図に示します。

図3-32　エージェントノードでノードリストを引き継ぐ流れ

図で示した流れについて説明します。番号は図中の番号と対応しています。

エージェントノードでノードリストを引き継ぐ場合

オンライン中にノードリストをノードリストファイルに書き込みます。

OpenTP1の開始時にノードリストには，自ノードの情報しかありません。

オンライン時に，前回オンライン時に保存したノードリストファイルからノードリストを引き継ぎます。
これによって，前回オンライン時と同等の構成でRPCが開始できます。

エージェントノードでノードリストを引き継がない場合

オンライン中にノードリストファイルへの書き込みはしません。

OpenTP1の開始時にノードリストには，自ノードの情報しかありません。

マネジャノードがノードBからのノードリスト要求に返信するまでの間，ノードリストの状態は変わりません。

マネジャノードのノードリストの配布のタイミングで，ノードリストは最新の情報に置き換わり，RPCが開始できます。

エージェントノードが障害などで停止し再開始した場合も，ノードリストを引き継ぐときと，引き継がないときでは，RPCの開始までに同様の時間差があります。

3.11.3　ノード自動追加機能の導入後の運用

ノード自動追加機能の導入後の運用について説明します。

＜この項の構成＞

(1)　ノードリストファイルに関する運用

(2)　ノード自動追加機能の通常時の運用

(3)　ノード自動追加機能の障害時の運用

(1)　ノードリストファイルに関する運用

ノードリストファイルはノードリストを引き継ぐときにnamnlcreコマンドで作成します。namnlcreコマンドについては，「13.　運用コマンドの詳細」の「namnlcre」を参照してください。

ノードリストファイルに関する運用について説明します。

(a)　ノードリストファイルの内容表示

ノードリストファイルには，ノード情報，動作モード，マネジャノード情報などが格納されています。ノードリストファイルの内容を表示する場合は，namnldspコマンドを実行します。namnldspコマンドについては，「13.　運用コマンドの詳細」の「namnldsp」を参照してください。

(b)　ノードリストファイルの削除

ノード自動追加機能の使用をやめる場合など，ノードリストファイルを削除するには，namnldelコマンドを実行します。OpenTP1システム内の構成を変更する場合など，ノードリストファイル中のノードリスト情報をリセットしたいときは，ノードリストを削除し，ノードリストの作成をします。namnldelコマンドについては，「13.　運用コマンドの詳細」の「namnldel」を参照してください。

(2)　ノード自動追加機能の通常時の運用

ノード自動追加機能の通常時の運用として，OpenTP1システムの構成変更や，動作モードの変更について説明します。

(a)　エージェントノードを追加する

OpenTP1システム内に新たにエージェントノードを追加する場合は，追加するエージェントノードのシステム共通定義で，次の定義を指定します。

name_service_modeオペランドにagentを指定

name_manager_nodeオペランドにマネジャノードのノード名を指定

追加するノードからマネジャノードへノードリスト要求を送信します。これによって，ノードリストにノードの情報が追加されます。マネジャノードから各ノードへ追加するノードのノード情報が配布され，各ノードは，ノードリストに追加するノードの情報を追加します。

(b)　エージェントノードを削除する

OpenTP1システム内の構成変更や，障害などでエージェントノードが停止した場合に，エージェントノードを削除する手順を次に示します。

システム共通定義のname_remove_down_nodeオペランドにYを指定している場合

削除するノードを停止します。

OpenTP1の停止時に，マネジャノードが停止したノードを検知して，ノードリストからノード情報を削除します。

システム共通定義のname_remove_down_nodeオペランドにNを指定している場合

削除するノードを停止します。

OpenTP1の停止時に，マネジャノードが停止したノードを検知して，マネジャノード上のRPC抑止リストに，停止したノードを登録します。

マネジャノードから各エージェントノードに最新のノードリストが配布されます。

ノードリストの整合性確保までの間，停止したノードへのRPC要求の送信を抑止するには，OpenTP1システム内のノードでnamndrmコマンドを実行して，停止したノードをノードリストから削除してください。namndrmコマンドについては「13.　運用コマンドの詳細」の「namndrm」を参照してください。

(c)　ノードの動作モードを切り替える

ノード自動追加機能を使用するための動作モード（マネジャノード，およびエージェントノード）は，システム共通定義のname_service_modeオペランドの指定値によって決定します。一度決定した動作モードを変更するには，各ノードのシステム共通定義のname_service_modeオペランドを変更する方法と，nammstrコマンドで変更する方法があります。nammstrコマンドについては「13.　運用コマンドの詳細」の「nammstr」を参照してください。

nammstrコマンドでは，動作モードの変更として，次のことができます。

動作モードの昇格

エージェントノードとして動作しているノードを，マネジャノードとして動作させる。

動作モードの降格

マネジャノードとして動作しているノードを，エージェントノードとして動作させる。

マネジャノードの変更

エージェントノード上で，マネジャノードとして指定しているノードを他のノードに変更する。

なお，nammstrコマンドでの動作モードの変更は，OpenTP1が稼働中の間だけ有効です。OpenTP1を再起動すると，システム共通定義に指定した動作モードに戻ります。

ノードリストを引き継ぐと，nammstrコマンドによる動作モードの状態，およびマネジャノードの指定先が，ノードリストファイルに引き継がれます。このため，再起動時もnammstrコマンドで変更した動作モードを引き継げます。

動作モードの昇格および降格の変更例を次の図に示します。

図3-33　動作モードの昇格および降格の変更例

図で示した動作モードの変更について説明します。番号は図中の番号と対応しています。

ノードAを停止します。
ノードA上で動作するOpenTP1，またはユーザサービスプロセスをすべて停止します。

エージェントノードB～Dは，ノードAをマネジャノードと認識しています。

ノードBでnammstr -uを実行し，ノードBがマネジャノードに昇格します。※1
-eオプションの指定で，コマンド実行前までにマネジャノードと認識していたノードAの情報をノードリストから削除することもできます。

ノードC，Dでは，ノードBからのノードリストの配布に従い，マネジャノードをノードBに変更します。

ノードAの動作モードはマネジャノードのままですが，エージェントノードがない状態になります。※2

ノードBでnammstr -d NODE-Aを実行し，ノードBがエージェントノードに降格します。また，ノードAをマネジャノードと認識します。※3

注※1

ノードAの停止を認識しないうちに，nammstrコマンドを実行した場合，エラーになることがあります。この場合，namsvinfコマンドに-bオプションを指定して実行し，ノードの状態を確認します。ノードAの状態が「INACT」になってから，再度コマンドを実行してください。

注※2

ユーザサーバだけを停止している場合は，OpenTP1システム上にマネジャノードが二つある状態になりますが，ノードC，Dは，ノードAからのノードリストは受け付けません。

注※3

ノードリストを引き継いでいる状態で，ノードの動作モードの降格をする場合は，OpenTP1を停止しないで，nammstrコマンドで実行することをお勧めします。OpenTP1を停止すると，ノードリストファイルの初期化，システム共通定義のname_service_modeオペランド，およびname_manager_nodeオペランドの修正後，OpenTP1の再起動が必要です。

動作モードの変更についての注意事項

マネジャノードまたはエージェントノードからノーマルノードへ変更する場合は，事前に変更するノードのOpenTP1を停止してください。停止した状態で定義を変更してから，OpenTP1を起動します。

ノードリストを引き継ぐ場合，OpenTP1開始時の動作モードは，ノードリストファイル中に格納された動作モードを適用します。ただし，ノードリストファイルの読み込みに失敗したときは，ノードリストファイル中に格納された動作モードではなく，システム共通定義のname_service_modeオペランドに指定した動作モードに従って，OpenTP1を開始します。

(3)　ノード自動追加機能の障害時の運用

マネジャノードが障害などの要因で停止すると，次のような影響があります。

OpenTP1システムにノードを自動追加できない。
マネジャノードが保持しているノードリストのノードだけがRPCの実行範囲となるため，負荷分散が不完全になることがあります。

OpenTP1システムからノードを自動削除できない。
停止しているノードへRPC要求を出す場合があります。

エージェントノードにノードリストが配布されないため，各ノード間でノードリストに不整合が生じる。
マネジャノードが保持しているノードリストのノードだけがRPCの実行範囲となるため，負荷分散が不完全になることがあります。

ノード自動追加機能の障害時の運用について，説明します。

(a)　マネジャノードが系切り替え構成でない場合の障害時の対応

マネジャノードは系切り替え構成での運用をお勧めします。マネジャノードを系切り替え構成で構築できない場合，マネジャノードで障害が発生したときは，次のように対応します。

次のどちらかの方法で，マネジャノードの再割り当てをします。

新規にマネジャノードを構築する。

既存のエージェントノードで，nammstrコマンドを実行し，マネジャノードに昇格する。

各エージェントノードに新マネジャノードを認識させます。

新規にマネジャノードを構築した場合は，各エージェントノードで，nammstrコマンドを実行し，マネジャノードを変更します。

nammstrコマンドでエージェントノードをマネジャノードに昇格した場合は，マネジャノードからのノードリストの配布によって，各エージェントノードで，新しいマネジャノードを認識します。

OpenTP1システムから旧マネジャノードが切り離されます。

旧マネジャノードをネットワークから切り離し，障害調査をします。

(b)　コマンドによるノード停止状態の検知

ノード自動追加機能を使用して，システム共通定義のname_remove_down_nodeオペランドにYを指定している場合，ノード情報の削除は，通常マネジャノードのノード監視プロセスが行います。ただし，次の場合は，ノード情報を削除しません。

namalivechkコマンドでノードの停止を検知した場合

namalivechkコマンドは，停止を検知したノードをRPC抑止リストへ登録します。このとき，ノード情報は削除しません。

システム共通定義のname_remove_down_nodeオペランドに，Yを指定しているときは，その後，マネジャノードのノード監視プロセスが，RPC抑止リストへ登録されたノードの情報をノードリストから削除します。

namsvinfコマンドでノードの停止を検知した場合

namsvinfコマンドは，停止を検知したノードをRPC抑止リストへ登録しません。また，ノード情報の削除もしません。

nambladコマンドでノードをRPC抑止リストへ登録した場合

コマンドに指定したノードをRPC抑止リストへ登録します。このとき，ノード情報は削除しません。

システム共通定義のname_remove_down_nodeオペランドに，Yを指定しているときは，その後，マネジャノードのノード監視プロセスが，RPC抑止リストへ登録されたノードの情報をノードリストから削除します。

name_remove_down_nodeオペランドについては，マニュアル「OpenTP1 システム定義」を参照してください。

3.11.4　ノード自動追加機能とその他の機能との併用

ノード自動追加機能は，優先選択ノードおよびノード監視機能と併用できます。併用した場合の運用方法や，ノード自動追加機能の動作の変更点を説明します。

＜この項の構成＞

(1)　ノード自動追加機能と優先選択ノードとの併用

(2)　ノード自動追加機能とノード監視機能との併用

(1)　ノード自動追加機能と優先選択ノードとの併用

ノード自動追加機能と優先選択ノードは併用できます。ノード自動追加機能使用時に，all_nodeオペランドに優先選択ノードを指定します。また，namndoptコマンドで，OpenTP1のオンライン中にノードの優先度を動的に変更することもできます。

ノードリストを引き継ぐときは，all_nodeオペランドの指定，およびnamndoptコマンドによって変更された優先選択ノードの情報もノードリストファイルへの書き込みの対象になります。このため，次回OpenTP1起動時には，ノードリストファイルと共に優先選択ノードの情報を引き継いだ状態でオンラインになります。

優先選択ノードについては，マニュアル「OpenTP1 解説」を参照してください。

(a)　定義ファイルでの優先選択ノード指定

システム共通定義のall_nodeオペランドで，優先選択ノードを指定する例を次に示します。

set all_node=NODE-A:10000:high, 10.209.111.333:10001:high

なお，優先選択ノード指定を指定していないノードについては，ノード情報として認識しません。また，ノードリストにも登録されません。

システム共通定義のall_nodeオペランドについては，マニュアル「OpenTP1 システム定義」を参照してください。

(b)　namndoptコマンドによる優先選択ノード指定

namndoptコマンドで，OpenTP1オンライン中に優先選択ノードを指定できます。

特定ノード（10.209.111.333）の優先度をLowからHighに変更する場合の，namndoptコマンドの実行例を次に示します。

>namndopt -p high 10.209.111.333:10000

namndoptコマンドについては，「13.　運用コマンドの詳細」の「namndopt」を参照してください。

(2)　ノード自動追加機能とノード監視機能との併用

ノード自動追加機能とノード監視機能は併用できます。二つの機能から監視することによって，より短い間隔でノードを監視できます。

ノード自動追加機能とノード監視機能を併用したノード監視の流れを次の図に示します。

図3-34　ノード自動追加機能とノード監視機能を併用したノード監視の流れ

図で示した流れについて説明します。番号は図中の番号と対応しています。

マネジャノードおよびノード監視機能を使用しているノードAは，監視対象（ノードB）のノードの停止を検知します。

マネジャノードは，ノードリストからノードBを削除します。
ノードAは，ノードBをRPC抑止リストへ登録します。これによって，ノードAからノードBへのRPC通信処理が停止します。

ノードCはノードBに対してRPC通信処理が発生します。

ノードCはマネジャノードへノードリスト要求を送信し，マネジャノードからノードBが削除されたノードリストを受信します。これによって，ノードCからノードBへのRPC通信処理が停止します。

ノード監視機能については，マニュアル「OpenTP1 解説」を参照してください。

3.11.5　ノーマルノードを混在させて使用する運用

ノーマルノードを混在させて使用する場合の注意事項を説明します。

＜この項の構成＞

(1)　ノーマルノードを混在させて使用する場合のシステム共通定義の指定

(2)　マネジャノードからノーマルノードへ変更する場合の注意事項

(1)　ノーマルノードを混在させて使用する場合のシステム共通定義の指定

ノーマルノードを混在させて使用する場合，システム共通定義に次の指定をしてください。

マネジャノードのname_remove_down_nodeオペランドには，Nを指定してください。Nを指定しないと，次の問題が発生します。

ノーマルノードが停止し，再開始しても，ノード情報がノードリストに登録されません。

マネジャノードや他のエージェントノードまたはノーマルノードの起動，停止，および負荷状態の変更に関する通知がノーマルノードへ送信されません。

ノード間の負荷バランスを保つために，name_remove_down_nodeオペランドには，Nを指定してください。

name_node_add_policyオペランドの指定によって，RPCの実行範囲と，ノード間の負荷バランスの範囲が異なります。ノーマルノードを含む構成でノード自動追加機能を使用する場合は，OpenTP1システム内のノード間の負荷バランスを保つために，name_node_add_policyオペランドにallを指定することをお勧めします。また，この場合は，ノーマルノードのシステム共通定義のall_nodeオペランドには，OpenTP1システムを構成するすべてのノードを指定してください。すべてのノードの指定がない場合は，ノード負荷バランス機能が正常に動作しないことがあります。
name_node_add_policyオペランドにusing_only，またはallを指定した場合のノード負荷バランスの範囲を，それぞれ以降の図に示します。

図3-35　name_node_add_policyオペランドにusing_onlyを指定した場合のノード負荷バランスの範囲

この構成例の場合，ノードAにノードNのノード情報が送信されません。このため，ノードAからSPPを呼び出すとき，呼び出せるのはノードM（マネジャノード），およびノードA上のSPPです。

図3-36　name_node_add_policyオペランドにallを指定した場合のノード負荷バランスの範囲

この場合，ノードAにノードNのノード情報が送信されます。このため，ノードAからSPPを呼び出すとき，呼び出せるのはノードM（マネジャノード），ノードA，およびノードN上のSPPです。

(2)　マネジャノードからノーマルノードへ変更する場合の注意事項

マネジャノードからノーマルノードへ変更する場合は，変更したあと，マネジャノードの再割り当てが必要です。新たにマネジャノードを構築するか，既存のエージェントノードをマネジャノードへ昇格させてください。

マネジャノードからノーマルノードへ変更する手順を次に示します。

変更するノードのOpenTP1を停止します。

マネジャノードをノーマルノードへ変更します。
システム共通定義のname_service_modeオペランドで，動作モードを変更します。

マネジャノードの再割り当てをします。
新たにマネジャノードとするノードを構築するか，既存のエージェントノードをマネジャノードに昇格させます。エージェントノードから昇格させる場合は，nammstrコマンドに-u，および-eオプションを指定して，旧マネジャノードのノード情報を削除してください。

ノードリストの整合性確保によって，しばらくすると，エージェントノードのノードリストから，旧マネジャノードのノード情報が削除されます。
ノードリストの整合性確保までに，エージェントノードのノードリストから旧マネジャノードのノード情報を削除するには，各エージェントノード上でnamndrmコマンドに-nオプションを指定して実行します。旧マネジャノードの存在を確認するには，エージェントノードで，namsvinfコマンドに-bオプションを指定して実行します。

3.12　TP1/NET/OSI-TP-Extendedを使用する運用

TP1/NET/OSI-TP-Extendedを使用して，通信プロトコルにOSI TPを使ったクライアント／サーバ型通信を実現できます。

TP1/NET/OSI-TP-Extendedを使用する場合の環境設定，コマンドについては，マニュアル「OpenTP1 プロトコル TP1/NET/OSI-TP-Extended編」を参照してください。

3.13　リモートAPI機能を使用する運用

＜この節の構成＞

3.13.1　リモートAPI機能を使用するための準備

3.13.2　rapリスナーおよびrapサーバの状態表示

3.13.3　リモートAPI機能の性能改善

3.13.4　rapリスナーおよびrapサーバの起動と停止

3.13.5　rapクライアントマネジャの起動と停止

3.13.6　rapリスナーとのコネクション確立処理

3.13.7　リモートAPI機能を使用する場合の注意

3.13.1　リモートAPI機能を使用するための準備

リモートAPI機能を使用する場合，次に示す準備が必要です。

＜この項の構成＞

(1)　実行環境の設定

(2)　定義の作成

(3)　リモートAPI機能に使用する定義の自動生成

(1)　実行環境の設定

rapサーバ側
rapsetupコマンドでリモートAPI機能の実行環境を設定します。

rapクライアント側
rapクライアントマネジャ機能を使用する場合，rapクライアント側でもrapsetupコマンドを実行して，リモートAPI機能の実行環境を設定します。

(2)　定義の作成

rapサーバ側
rapリスナーサービス定義を作成します。

rapクライアント側
ユーザサービス定義とユーザサービスネットワーク定義を作成します。ユーザサービスネットワーク定義では，リモートAPI機能を介しての通信であることを定義するために，dcsvgdef定義コマンドで-wオプションを指定します。

（定義例）

dcsvgdef -g サービスグループ名 -h ホスト名 -p ポート番号 -w

rapクライアントマネジャ機能を使用する場合は，rapクライアントマネジャサービス定義も作成します。

定義の詳細については，マニュアル「OpenTP1 システム定義」を参照してください。

(3)　リモートAPI機能に使用する定義の自動生成

rapサーバ側
(2)で作成したrapリスナーサービス定義を入力ファイルとして，rapdfgenコマンドを実行します。これによって，rapリスナー用ユーザサービス定義およびrapサーバ用ユーザサービス定義が生成されます。
生成されたこれらの定義は，$DCCONFPATH下に出力されます。

（実行例）

＞rapdfgen rapリスナーサービス定義ファイル名

rapクライアント側
rapクライアントマネジャ機能を使用する場合，(2)で作成したrapクライアントマネジャサービス定義を入力ファイルとして，rapdfgenコマンドを実行します。これによって，rapクライアントマネジャ用ユーザサービス定義が$DCCONFPATH下に生成されます。

（実行例）

＞rapdfgen -m rapクライアントマネジャサービス定義ファイル名

3.13.2　rapリスナーおよびrapサーバの状態表示

raplsコマンドでrapリスナーおよびrapサーバの状態を表示できます。

3.13.3　リモートAPI機能の性能改善

リモートAPI機能を使用した電文の送受信を行う場合，送受信する電文長に依存してレスポンスが悪化し，性能が低下することがあります。リモートAPI機能では，レスポンス改善のための性能チューニング用パラメタを提供しています。パラメタでソケットウィンドウサイズを大きくし，送受信リトライ間隔を短く設定すれば，レスポンスを改善できます。

性能チューニング用パラメタの適応については，システム要件に合わせてユーザで判断してください。性能チューニングパラメタは，次の手順で設定してください。

rapリスナーサービス定義の次のオペランドを指定する

rap_max_buff_sizeオペランド

rap_io_retry_intervalオペランド

rap_sock_countオペランド

rap_sock_intervalオペランド

rap_connect_retry_countオペランド

rap_connect_retry_intervalオペランド

rap_listen_backlogオペランド

オペランドの詳細については，マニュアル「OpenTP1 システム定義」を参照してください。

オペランドを指定後，rapdfgenコマンドを実行する

3.13.4　rapリスナーおよびrapサーバの起動と停止

rapリスナーおよびrapサーバの起動には，dcsvstartコマンドを実行します。または，ユーザサービス構成定義にdcsvstart定義コマンドを指定してOpenTP1を開始することで，rapリスナーおよびrapサーバを起動できます。

コマンド引数にrapリスナー名を指定してdcsvstartコマンドを実行すると，rapリスナーとrapサーバの両方が起動します。

（実行例）

＞dcsvstart -u rapリスナー名

rapリスナーおよびrapサーバの停止には，dcsvstopコマンドを実行します。または，dcstopコマンドを実行してOpenTP1を停止することで，rapリスナーおよびrapサーバを停止できます。

コマンド引数にrapリスナー名を指定してdcsvstopコマンドを実行すると，rapリスナーとrapサーバの両方が停止します。

（実行例）

＞dcsvstop rapリスナー名

rapリスナーおよびrapサーバは，システム管理者のユーザ識別子で起動してください。rapリスナーおよびrapサーバは，$DCDIR/spool下にファイルを作成するため，システム管理者のユーザ識別子で起動しないとディレクトリのパーミッションの関係で起動時にエラーとなり起動できません。

また，rapリスナーの開始時にKFCA00327-Wメッセージが出力されることがあります。これは，rapリスナーがrapサーバに対してサービス関数を実行する時に発行するRPCのエラーメッセージです。rapリスナーは，RPCでエラーが発生した場合リトライする仕様となっているため，エラーメッセージが表示されてもプログラム上の問題はありません。

rapサーバについては，rapサーバ単独での停止および開始（dcsvstopコマンドでの停止，dcsvstartコマンドでの開始）をしないでください。また，rapサーバがオンライン中であるとき，rapサーバに対してscdholdコマンドを実行しないでください。ただし，次の場合にはdcsvstartコマンドでrapサーバを起動してください。

定義誤りでエラーとなった場合
rapサーバはrapリスナーによって自動起動されますが，処理上，KFCA00244-Eメッセージにシステム定義のエラー個所が表示されません。KFCA01812-Eメッセージの要因コードがCONFIGURATIONの場合は，rapサーバの定義内容を見直してください。また，rapリスナーは定義誤りなどが原因でrapサーバが起動不可となったことを知ることができないため，KFCA26950-Iメッセージを出力し，「リモートAPIサービスの準備中」のままとなっています。この場合は，rapサーバのオペランドを修正したあと，dcsvstartコマンドでrapサーバを手動で起動してください。

rapリスナーおよびrapサーバの終了中にダウンした場合
rapリスナーおよびrapサーバの終了中にrapリスナーがダウンした場合，次回のdcsvstartコマンドでrapリスナーを起動してもrapサーバがKFCA26950-Iメッセージを出力し，「リモートAPIサービスの準備中」のままとなる場合があります。rapサーバが開始されない場合は，dcsvstartコマンドでrapサーバを手動で起動してください。

3.13.5　rapクライアントマネジャの起動と停止

rapクライアントマネジャの起動には，dcsvstartコマンドを実行します。または，ユーザサービス構成定義にdcsvstart定義コマンドを指定してOpenTP1を開始することで，rapクライアントマネジャを起動できます。

（実行例）

＞dcsvstart -u rapクライアントマネジャ名

rapクライアントマネジャの停止には，dcsvstopコマンドを実行します。または，dcstopコマンドを実行してOpenTP1を停止することで，rapクライアントマネジャを停止できます。

（実行例）

＞dcsvstop rapクライアントマネジャ名

rapクライアントマネジャ機能を使用する場合，次の順序で起動します。

rapクライアントマネジャの起動
rapクライアント側のノードで，rapクライアントマネジャを起動します。

rapリスナーの起動
rapサーバ側のノードで，rapリスナーサービス定義のrap_notifyオペランドにYを指定しているrapリスナーを起動し，rapクライアントマネジャに通知します。ここで起動するrapリスナーの情報は，rapクライアントマネジャサービス定義のrap_listen_infオペランドに指定されている必要があります。

rapクライアントの起動
rapクライアント側のノードで，rapクライアントを起動しdc_rpc_callを発行します。
rapクライアントマネジャは，システム管理者のユーザ識別子で起動してください。定義の詳細については，マニュアル「OpenTP1 システム定義」を参照してください。

3.13.6　rapリスナーとのコネクション確立処理

connect()が集中してrapリスナーのリッスンキューがあふれると，エラーコードECONNREFUSEDが返されます。このエラーコードが返されたときは，再度connect()処理をすることで対策できます。connect()のリトライ回数とリトライ間隔は，ユーザサービス定義ではDCFPL_CONNECT_RETRY_COUNTオペランド，DCFPL_CONNECT_RETRY_INTERVALオペランドで指定してください。rapリスナーサービス定義では，rap_connect_retry_countオペランド，rap_connect_retry_intervalオペランドで指定したあとに，rapdfgenコマンドを実行してください。

3.13.7　リモートAPI機能を使用する場合の注意

リモートAPI機能を使用し，TP1/Server Base，またはTP1/LiNKがrapクライアント側のノードとなる場合，rapクライアントと同一のOpenTP1ノード内にあるrapサーバに対して，API代理実行を要求しないでください。要求した場合の動作は保証しません。

リモートAPI機能を使用し，TP1/Server Baseがrapクライアントとなる場合，RPCのユーザデータの圧縮機能は使用できません。

リモートAPI機能を使用して連鎖RPC（dc_rpc_call関数のflags引数にDCRPC_CHAINEDを指定）を行ったが，RPCが正常に終了しなかったため，dc_rpc_close関数を発行してUAPの処理を中止した場合，rapサーバは連鎖RPCのリソースを完全にクリアするために「KFCA26921-E 理由コード=401」を出力し，Vrext03で異常終了します。また，連鎖RPCが正常に行われたとしても連鎖RPCの終了RPC（dc_rpc_call関数のflags引数にDCNOFLAGSを指定）を行わなかった場合も同様に，rapサーバはダウンします。

rapdfgenコマンドによって作成されたrapリスナー用ユーザサービス定義，rapサーバ用ユーザサービス定義，およびrapクライアントマネジャ用ユーザサービス定義は，$DCCONFPATH下にあることを前提としているため，$DCCONFPATH下から$DCUAPCONFPATH下に移動しないでください。$DCUAPCONFPATH下に移動した場合の動作は保証しません。

次に示すコマンドは，rapサーバに対して実行しないでください。実行した場合の動作は保証しません。

scdchprcコマンド

scdholdコマンド

scdrlesコマンド

scdrsprcコマンド

ユーザサービスネットワーク定義のdcsvgdef定義コマンドに-wオプションを指定してOpenTP1間でリモートAPI機能を使用する場合（例えば，アプリケーションゲートウェイ型ファイアウォールなどのゲートウェイを介してRPCをする場合など），トランザクション属性でdc_rpc_call関数を発行してもトランザクションにはなりません。したがって，トランザクション内から連鎖RPCを開始し，同期点処理で連鎖RPCを終了させる運用は，リモートAPI機能を使用した場合には正しく動作しません。flags引数にDCNOFLAGSを指定したdc_rpc_call関数で，明示的に連鎖RPCを終了するようにしてください。

メッセージを監視する場合，リモートAPI機能が開始されているかどうかは，KFCA26952-Iメッセージの出力有無で判断してください。KFCA01813-Iメッセージはrapリスナーの開始中に障害が発生した場合も出力されるため，KFCA01813-Iメッセージの出力有無でリモートAPI機能の開始を判断しないでください。
メッセージの詳細については，マニュアル「OpenTP1 メッセージ」を参照してください。

3.14　OpenTP1の連続運転に関する運用

＜この節の構成＞

3.14.1　リソースの扱い

3.14.2　構成変更時の注意

3.14.3　MCF通信サービスの部分入れ替え

3.14.4　時刻変更に関する注意

3.14.1　リソースの扱い

OpenTP1を連続運転できるようにするには，連続運転で使用するリソース量が増加し続けないようにしておく必要があります。OpenTP1では，リソースに関して，次のように制御しています。

通番

ジャーナルブロックなどの通番は，最大値になると0または1に戻してラップアラウンドして使用されるため，連続運転しても問題ありません。

メモリ量

連続運転によって，所要メモリ量が増加し続けることはありません。

ディスク量

ファイルごとのディスク容量の扱いを，次の表に示します。

表3-30　OpenTP1で使用するディスク量の扱い

ディレクトリ
説　明

/tmp
OpenTP1配下のプロセスの標準出力，標準エラー出力ファイル（betran.log）が格納されます。このファイルは無制限に増加する可能性があるため，マシン起動時に削除される仕掛けを作ったり，betran.logの世代管理をしたりすることをお勧めします（「3.5　標準出力ファイルに関する運用」参照）。

$DCDIR/bin
増加しません。

$DCDIR/lib
増加しません。

$DCDIR/include
増加しません。

$DCDIR/etc
増加しません。

$DCDIR/aplib
増加しません。

$DCDIR/tmp
各プロセスのホームディレクトリになります。プロセスがダウンした場合，ここにコアファイルができ，その後$DCDIR/spool/saveまたはプロセスサービス定義のprc_coresave_pathオペランドで指定したディレクトリに移されます。したがって，一時的に増加しますが元に戻ります。オンラインを再開始するとクリアされます。

$DCDIR/spool/save/*※1
コアファイルが退避されます。コアファイルは3世代以上は作成されないため，一定容量以上にはなりません。

$DCDIR/spool/dclckinf/*
デッドロック情報，タイムアウト情報が格納されます。一定間隔で削除することをお勧めします。※²

$DCDIR/spool/dctrninf/*
トランザクションサービス定義でtrn_tran_recovery_list=Yを指定すると，未決着トランザクション情報が格納されます。※³
$DCDIR/spool/dctrninf/traceにはXAインタフェースのトレースが格納されますが，一定容量でラップアラウンドするため，一定容量以上にはなりません。

$DCDIR/spool/errlog/*
OpenTP1エラーログ情報が格納されます。一定容量でラップアラウンドするため，一定容量以上にはなりません。

$DCDIR/spool/cmdlog/*
OpenTP1のコマンドログが格納されます。一定容量でラップアラウンドするため，一定容量以上にはなりません。

$DCDIR/spool/dcjnlinf/*
ジャーナル不正ブロック情報が格納されます。通常ここにファイルは作成されません。

$DCDIR/spool/dcjnlinf/unload/*
システムジャーナルサービス定義にjnl_auto_unload=Yを指定して，jnl_auto_unload_pathオペランドの指定を省略した場合に，自動アンロード機能が生成したアンロードジャーナルファイルが格納されます。不要になったファイルは一定間隔で削除することをお勧めします。

$DCDIR/spool/dctjlinf/*
$DCDIR/spool/dcsjl/*
ここに作成されるファイルは削除しないでください。

$DCDIR/spool/trnrmcmd/*
trnmkobjコマンドで作成したオブジェクトファイルが格納されます。

$DCDIR/spool/olkfifs/*
$DCDIR/spool/olkrsfs/*
ファイルサイズは一定値であり，ファイル数も定義に比例するため，一定数以上にはなりません。

$DCDIR/spool/dcprfinf/*
ファイルサイズ，ファイル数が一定値であり，かつ，ラップアラウンドするため，一定容量以上にはなりません。

$DCDIR/spool/
dclog1，dclog2などのトレースが格納されます。OpenTP1のトレースはラップアラウンドするので，一定容量以上にはなりません。共用メモリダンプもここに出力されます。サイズは定義に依存するため一定容量になります。

注※1

$DCDIR/spool/save配下のトラブルシュート情報ファイルは，障害調査が不要であればrmコマンドで削除したり，dccspoolコマンドを用いて経過日数指定などで削除したりしてもかまいません。

通常運用の中で，ディスク使用率閾値を設定するなどして，定期的に監視・削除することをお勧めします。

注※2

lck_deadlock_info_remove_levelを指定すると，一定間隔で自動的に削除できます。

注※3

リランごとに情報が蓄積されるので，一定間隔で削除するようにしてください。なお，trn_recovery_list_remove_levelを指定すると，一定間隔で自動的に削除できます。

3.14.2　構成変更時の注意

OpenTP1の環境や構成を変更する場合の注意を，次に示します。

システム定義の変更
システム定義には，再開始時に反映されるものと，正常開始時に反映されるものがあります。そのため，必要に応じてOpenTP1を停止してください。

製品のバージョンアップ
OpenTP1を正常停止させたあと，バージョンアップしてください。

APの追加
オンライン中に追加できます。

APの入れ替え
入れ替え対象のAPを停止させたあと，APを入れ替えてください。

MCF通信サービスの部分入れ替え
TP1/NET/TCP/IP，TP1/NET/Secondary Logical Unit - TypeP2，またはTP1/NET/OSAS-NIFを使用している場合，オンライン中にMCF通信サービスのファイルを入れ替えられます。
MCF通信サービスの部分入れ替えについては，「3.14.3　MCF通信サービスの部分入れ替え」を参照してください。

3.14.3　MCF通信サービスの部分入れ替え

通信プロトコル製品に，TP1/NET/TCP/IP，TP1/NET/Secondary Logical Unit - TypeP2，またはTP1/NET/OSAS-NIFを使用している場合，オンライン中にMCF通信サービスのファイルを部分的に入れ替えられます。該当するMCF通信サービスだけを停止させてファイルを入れ替えることで，OpenTP1システムを停止させることなくファイルを変更できます。MCF通信サービスの部分入れ替えを実行するには，mcftstopコマンド，およびmcftstartコマンドを使用します。

部分的に入れ替られるのは次のファイルです。

MCF通信サービスのロードモジュール（メイン関数）

MCF通信サービスに取り込んでいるユーザ作成のライブラリ（UOC）

該当プロトコル製品が提供するライブラリ（モジュール入れ替えの場合）

MCF通信サービスの部分入れ替えをすると，次の図のように，MCF通信サービスBの業務に影響を与えないでMCF通信サービスAに関する内容を入れ替えられます。

図3-37　MCF通信サービスで部分的に入れ替えられるファイル

プロトコル製品が提供するライブラリを入れ替える場合，該当するプロトコル製品を使用しているすべてのMCF通信サービスを停止させる必要があります。

mcftstopコマンドを実行して該当するMCF通信サービスを停止する前に，論理端末の閉塞，およびコネクションの解放をして，該当するMCF通信サービスがメッセージの処理をしない状態にする必要があります。

MCF通信サービスの部分入れ替えの処理の流れを次に示します。

対象のMCF通信サービスの論理端末を閉塞します。
例：mcftdctle -s 01 -l "*"
MCF通信サービスがメッセージ送信処理をしない状態になります。

対象のMCF通信サービスのコネクションを解放します。
例：mcftdctcn -s 01 -c "*"
MCF通信サービスがメッセージ受信処理をしない状態になります。

対象のMCF通信サービスを部分停止します。
例：mcftstop -s 01

MCF通信サービスが停止していることを確認します。
例：mcftlscom -s 01

対象のMCF通信サービスのライブラリを入れ替えます。

対象のMCF通信サービスを部分開始します。
例：mcftstart -s 01

必要であれば，コネクションの確立，および論理端末の閉塞解除をします。
例（コネクションの確立）：mcftactcn -s 01 -c "*"
例（論理端末の閉塞解除）：mcftactle -s 01 -l "*"

3.14.4　時刻変更に関する注意

OpenTP1ではステータスファイル，ジャーナルファイル，チェックポイントダンプファイルなどに日付や時間の情報を格納しています。OpenTP1の再開始時などにその情報を使用します。また，トレースファイルなど，各種作業ファイルにも日付や時刻の情報を持ち，さまざまなチェック処理でその情報を使用しています。 そのため，OpenTP1の開始中，オンライン中，または停止中に時刻を変更した場合，問題が発生します。

OpenTP1では，時刻を変更する場合，adjtime()システムコールのように，常に単調に時刻の値を増加させながら増加の速度を速くしたり遅くしたりすることで時刻を補正する機能を使用することを推奨します。

＜この項の構成＞

(1)　時刻を進める場合

(2)　時刻を遅らせる場合

(1)　時刻を進める場合

OpenTP1のデーモンが一定期間動作しない場合は，OpenTP1の内部のチェックによってタイムアウトになり，システムがダウンします。そのため，システムの時刻を進めた場合，タイムアウトが発生したと不当に判断してシステムダウンすることがあります。OpenTP1の開始中，オンライン中，または停止中に，秒単位またはそれより大きな単位で時刻を進めないでください。何らかのテストで時刻を進める必要がある場合は，OpenTP1を停止させたあとに時刻を変更してください。

100ミリ秒以下の値であれば，OpenTP1がオンライン中でも時刻を進めることができます。ただし，この場合も，統計情報が正確に表示されなかったり，トレース情報の時刻表示が不当な値になったりする可能性がありますのでご注意ください。

(2)　時刻を遅らせる場合

時刻を遅らせた場合，再開始の失敗，トランザクション回復不正，不当なシステムウェイトなどの問題が発生する可能性があり，動作を保証できません。そのため，OpenTP1の開始中，オンライン中，または停止中に強制的に時刻を遅らせないでください。時刻を遅らせると，システムの時刻よりも時刻が進んだ状態のファイルがOpenTP1システム内に残り，ラップアラウンド運用のトレースファイルの切り替えに失敗する場合があります。何らかのテストで時刻を遅らせる必要がある場合は，dcstopコマンドでOpenTP1をいったん終了させてください。

時刻変更後，OpenTP1を起動する場合は，OpenTP1を停止した時刻よりも未来の時刻になるのを待ってから起動してください。OpenTP1を停止した時刻よりも未来の時刻になるのを待たないで起動する場合，dcsetupコマンドの-dオプションでいったんOpenTP1をシステムから削除し，OpenTP1ファイルシステムの再作成など，システムの再構築をしてください。

3.15　XAリソースサービスを使用する運用

XAリソースサービスを使用する運用について説明します。XAリソースサービスの概要については，マニュアル「OpenTP1 解説」を参照してください。

＜この節の構成＞

3.15.1　XAリソースサービスを使用するための準備

3.15.2　XAリソースサービスのトランザクション管理

3.15.3　XAリソースサービスの開始と終了

3.15.4　XARファイルに障害が発生した場合の運用

3.15.5　XAリソースサービスのトレース

3.15.1　XAリソースサービスを使用するための準備

XAリソースサービスを使用するために必要な準備について説明します。

＜この項の構成＞

(1)　前提機能

(2)　前提となる定義

(1)　前提機能

XAリソースサービスを使用するためには，リモートAPI機能と，次に示す製品を使用する必要があります。

J2EEで動作するアプリケーションサーバと連携する場合

TP1/Client/J

uCosminexus TP1 ConnectorまたはCosminexus TP1 Connector

.NET Frameworkアプリケーションと連携する場合

Client .NET

Connector .NET

(2)　前提となる定義

XAリソースサービスを使用する場合は，次に示す定義を指定する必要があります。

トランザクションサービス定義のtrn_xar_use=Y

システム共通定義のjnl_fileless_option=N，またはオペランドの指定を省略

XAリソースサービス定義（ファイル名：xar）

定義の詳細については，マニュアル「OpenTP1 システム定義」を参照してください。

3.15.2　XAリソースサービスのトランザクション管理

XAリソースサービスは，TP1/Client/JまたはClient .NETからのトランザクション要求種別に従って，トランザクションの管理を開始したり終了したりします。また，TP1/Client/JまたはClient .NETから渡されるXAリソースサービスで連携するアプリケーションサーバのXID（トランザクション識別子）と，OpenTP1が管理しているXIDとを対応づけて，トランザクション情報を共用メモリ上で管理します。MSDTC連携機能を使用する場合は，RI（トランザクション回復情報）も管理します。RIとは，トランザクション決着処理で障害が発生した場合にトランザクションを回復するため情報で，トランザクション決着処理時にMSDTCが作成します。これらのトランザクションの状態は，必要に応じてXARファイルに記録されます。

＜この項の構成＞

(1)　XAリソースサービスの運用

(2)　トランザクション情報の管理

(3)　XARファイルの運用

(1)　XAリソースサービスの運用

XAリソースサービスの運用を次の図に示します。

図3-38　XAリソースサービスの運用

XAリソースサービスを使用する場合で次に示すときは，トランザクションが不正に残ることがあります。

rapリスナー，またはrapサーバを強制停止（dcsvstop -fコマンド実行）した場合
この場合，rapリスナーまたはrapサーバを開始（dcsvstartコマンド実行）してください。

リモートAPI機能で動作が保証されていない操作を行った場合

rapリスナーおよびrapサーバが正常終了していない状態で，rapdfgenコマンドで起動中のrapリスナー，およびrapサーバの定義を変更した場合
この場合の動作は保証できません。

(2)　トランザクション情報の管理

J2EEで動作するアプリケーションサーバと連携する場合のトランザクション情報の管理を次の表に示します。

表3-31　トランザクション情報の管理（J2EEで動作するアプリケーションサーバと連携する場合）

トランザクション要求種別 | トランザクション情報の管理 | トランザクションの状態変更（正常ケース）
開始 | 終了 | ファイルのI/O
Start() | ○ | － | ○ | なし → Active
Call() | － | － | － | 変化しない
End() | － | － | － | Active → Idle
Prepare() | － | － | － | Idle → Prepared
○ | － | Idle → なし※1
Commit() | － | ○ | － | Prepared → なし※2
Idle → なし※3
Rollback() | － | ○ | － | Prepared → なし※2
Idle → なし※3
Recover() | － | － | － | 変化しない
Forget() | － | ○ | － | Heuristically Completed → なし

（凡例）

○：処理を実行します。

－：処理を実行しません。

注※1

トランザクションブランチがread onlyの場合

注※2

2相コミット，またはロールバックの場合

注※3

1相コミット，またはロールバックの場合

.NET Frameworkアプリケーションと連携する場合のトランザクション情報の管理を次の表に示します。

表3-32　トランザクション情報の管理（.NET Frameworkアプリケーションと連携する場合）

トランザクション要求種別
トランザクション情報の管理
トランザクションの状態変更
（正常ケース）

開始
終了
ファイルのI/O

Call()
○
－
－
なし → Active※1

－
－
－
変化しない

Prepare()
－
－
○
Active → Idle → Prepared

○
○
Active → Idle → なし※2

Commit()
－
○
－
Prepared → なし※3

Active → Idle → なし※4

Rollback()
－
○
－
Prepared → なし※3

Active → Idle → なし※4

Recover()
－
－
－
変化しない

Forget()
－
○
－
Heuristically Completed → なし

（凡例）

○：処理を実行します。

－：処理を実行しません。

注※1

トランザクション内で最初のCall()要求の場合

注※2

トランザクションブランチがread onlyの場合

注※3

2相コミット，またはロールバックの場合

注※4

1相コミット，またはロールバックの場合

(3)　XARファイルの運用

XAリソースサービスは，必要に応じてトランザクション情報をXARファイルに格納します。XARファイルは，XAリソースサービスの正常開始処理で初期化されます。

(a)　XARファイルの作成

XARファイルはxarinitコマンドで作成し，xarrmコマンドで削除します。また，XARファイルのファイル情報はxarfillsコマンドで確認します。

XARファイルには，オンライン用XARファイルとバックアップ用XARファイルの二つが必要です。オンライン用XARファイルとバックアップ用XARファイルは，同一のレコード長およびレコード数にしてください。また，I/Oできるファイルにしてください。

通常はオンライン用XARファイルを使用し，オンライン用XARファイルに障害が発生した場合，バックアップ用XARファイルに自動的にスワップします。障害発生を考慮して，オンライン用XARファイルとバックアップ用XARファイルは異なるディスクボリュームに格納してください。

XARファイルは，一つのトランザクションブランチに対して1レコードを使用します。そのため，XARファイルには，同時に起動するトランザクションブランチ数（トランザクションサービス定義のtrn_tran_process_countオペランドの値）以上のレコードが必要です。

J2EEで動作するアプリケーションサーバと連携する場合
XARファイルの1レコード情報は512バイトです。キャラクタ型スペシャルファイルを使用する場合，OpenTP1ファイルシステム構築時にfilmkfsコマンドの-sオプションで指定したセクタ長の単位でファイルのI/Oを行います。そのため，OpenTP1ファイルシステムのセクタ長に512バイトを指定することをお勧めします。ただし，OSによっては，セクタ長に指定できる値の最小値が512バイトよりも大きいものがあります（HP-UXの場合1024バイト）。そのようなOSのOpenTP1ファイルシステムのセクタ長には，指定できる最小値を指定することをお勧めします。なお，指定値は512バイトの整数倍にしてください。UNIXファイルシステムを使用する場合，ファイルのI/Oの単位には512バイトが仮定されます。

.NET Frameworkアプリケーションと連携する場合
MSDTC連携機能を使用する場合，XARファイルのレコード長に1024バイト以上を指定することをお勧めします。これは，RIのサイズがMSDTCが動作する環境に依存するため，環境によってはXARファイルのレコード長の不足が原因となってトランザクション決着処理に失敗することがあるためです。
XARファイルのレコード長（xarinitコマンドの-sオプションで指定）には，OpenTP1ファイルシステムのセクタ長の倍数を指定してください。XARファイルに格納できる最大RIサイズは，xarfillsコマンドまたはxarlsコマンドで確認できます。
XARファイルのレコード長の不足が原因となってトランザクションの決着処理に失敗した場合は，次に示す手順でXARファイルを再作成してください。

OpenTP1を停止します。

KFCA32045-Eメッセージの「必要なXARファイルのレコード長」に表示された値をxarinitコマンドの-sオプションに指定して，XARファイルを再作成します。

OpenTP1を正常開始します。

(b)　XARファイルの指定

XAリソースサービス定義の定義コマンドxarfileでXARファイルを指定します。指定する前に，上記の条件に合うXARファイルをあらかじめ作成しておいてください。存在しないファイルをXARファイルに指定した場合，エラーになります。また，トランザクションサービス定義のtrn_tran_process_countオペランドの値よりもレコード数が少ないXARファイルを指定した場合もエラーになります。

定義コマンドxarfileの-t onlineオプションでオンライン用XARファイルを，-t backupオプションでバックアップ用XARファイルを指定します。必ず両方のXARファイルを指定してください。

(c)　注意事項

XARファイルの二重化機能はサポートしていません。また，次の状態ではXAリソースサービスはトランザクション情報を管理できません。

OpenTP1が未起動

リモートAPI機能が未起動

XAリソースサービスが未起動

XAリソースサービスが閉塞

XAリソースサービスは，オンライン用XARファイルとバックアップ用XARファイルの両方に障害が発生した場合に閉塞します。閉塞を解除するには，xarrlesコマンドを実行してください。詳細については，「3.15.4　XARファイルに障害が発生した場合の運用」を参照してください。

XAリソースサービスが管理するトランザクションの状態を表示するには，xarlsコマンドを実行してください。未決着のトランザクションを決着させるには，xarforceコマンドを実行してください。

3.15.3　XAリソースサービスの開始と終了

＜この項の構成＞

(1)　XAリソースサービスの開始

(2)　XAリソースサービスの再開始

(3)　XAリソースサービスの終了

(1)　XAリソースサービスの開始

XAリソースサービスを開始すると，XARファイルは初期化されます。XAリソースサービスの開始に失敗した場合，OpenTP1の起動も失敗します。

XAリソースサービスを使用するための定義については，「3.15.1(2)　前提となる定義」を参照してください。

(2)　XAリソースサービスの再開始

XAリソースサービスを再開始するにはOpenTP1を再開始します。前回OpenTP1を正常開始したときのXAリソースサービスの開始状態によって，XAリソースサービスを再開始するかどうかが決定します。前回のOpenTP1の正常開始時にXAリソースサービスを開始していれば，XAリソースサービスを再開始します。XAリソースサービスを開始していなければ，XAリソースサービスを再開始しません。

XAリソースサービスを再開始すると，XARファイルは初期化されます。

XAリソースサービスの再開始に失敗した場合，OpenTP1の再開始も失敗します。

OpenTP1再開始時に，次の定義オペランドおよび定義コマンドを変更できます。

xar_eventtrace_level：XARイベントトレース情報の出力レベル

xar_eventtrace_record：XARイベントトレース情報ファイルの最大出力レコード数

xar_session_time：アイドル状態のトランザクションブランチの監視時間

xar_prf_trace_level：XAR性能検証用トレース情報の取得レベル

xarfile：XAR物理ファイルの指定

OpenTP1の再開始時に定義コマンドxarfileの値を変更するのはXARファイルに障害が発生した場合だけです。それ以外の場合，OpenTP1の再開始時に定義コマンドxarfileを変更すると，トランザクションブランチを回復できなくなるので注意してください。XARファイルに障害が発生したときのトランザクションブランチの回復方法については，「3.15.4　XARファイルに障害が発生した場合の運用」を参照してください。

XAリソースサービスを再開始すると，XARファイルを使用して前回のトランザクションブランチの状態に戻す処理（トランザクションブランチの回復処理）をします。バックアップ用XARファイルが使用されている場合，バックアップ用XARファイルからトランザクションブランチを回復します。バックアップ用XARファイルが使用されていない場合，オンライン用XARファイルからトランザクションブランチを回復します。

トランザクションブランチの回復処理では，XARファイルの各レコードに記録されている前回のトランザクション情報を調査します。1相目の状態（Prepared）のまま決着が行われていないトランザクションブランチの場合，再びPrepared状態に戻します。XARファイルにはトランザクションブランチのXID情報が含まれているため，再びXAリソースサービスで連携するアプリケーションサーバからのトランザクション決着指示を受け付けられるようになります。

Heuristically completed状態のトランザクションブランチの場合，再びHeuristically completed状態に戻し，ヒューリスティックを完了させます。

Prepared状態になる前（Active，Idle）のトランザクションブランチの場合，すべてロールバックします。これらのトランザクションブランチのXID情報は削除されるため，XAリソースサービスで連携するアプリケーションサーバからトランザクションブランチの決着要求が来てもコミット決着できません。

また，トランザクション決着済み（コミットまたはロールバック）のトランザクションブランチの場合，トランザクションブランチの回復処理が行われてもトランザクションの決着結果は変わりません。

トランザクションの状態ごとのトランザクションブランチの回復処理を次の表に示します。

表3-33　OpenTP1再開始時のトランザクションブランチ回復処理

トランザクション状態 | 処置 | XID情報
Active | ロールバック | 削除
Idle | ロールバック | 削除
Prepared | OpenTP1のPJ出力前 | トランザクション決着待ち | 残す
OpenTP1のPJ出力後 | コミット済み | 削除
Rollback only | ロールバック | 削除
Heuristically completed | ヒューリスティック完了 | 残す

(3)　XAリソースサービスの終了

XAリソースサービスは，OpenTP1の終了時に終了します。すべてのXAリソースサービスで連携するアプリケーションサーバからのトランザクションブランチが決着していないとOpenTP1を終了できません。決着していないトランザクションブランチがある場合，トランザクションブランチの決着を待ちます。OpenTP1の強制停止コマンドを実行した場合，トランザクションブランチの決着を待たないで強制的にOpenTP1が終了します。

3.15.4　XARファイルに障害が発生した場合の運用

XAリソースサービスのオンライン中に，XARファイルのI/O障害が発生した場合，オンライン用XARファイルからバックアップ用XARファイルに自動的にスワップします。この機能をスワップ機能といいます。この機能を使用すると，オンライン用XARファイルに障害が発生しても，XAリソースサービスのオンラインを続行できます。

XARファイルのI/O障害発生時にXAリソースサービスのオンラインを再開始する方法は，障害がどのファイルで，またどの時点で発生するかによって異なります。障害発生時点ごとの運用方法を次に示します。

オンライン用XARファイルに障害が発生した時点で，スワップ機能を使用して新しいXARファイルと入れ替える方法

1.の後，さらにバックアップ用XARファイルに障害が発生し，XAリソースサービスが閉塞した時点で新しいXARファイルと入れ替える方法

オンライン用XARファイルに障害が発生し，OpenTP1が停止した時点で新しいXARファイルと入れ替える方法

オンライン用とバックアップ用の両方のXARファイルに障害が発生し，XAリソースサービスが閉塞およびOpenTP1が停止した時点で新しいXARファイルと入れ替える方法

1および2の方法は，OpenTP1を停止させることなく，障害が発生したXARファイルを新しいXARファイルに入れ替えます。これらの方法は，共用メモリから障害発生前のトランザクションブランチを回復できます。

1の方法は，バックアップ用XARファイルに障害が発生する前に対策を実施するので，より確実にXAリソースサービスを運用できます。

3の方法は，OpenTP1が停止しても，バックアップ用XARファイルの情報から障害発生前のトランザクションブランチを回復できます。

4の方法はOpenTP1が停止し，さらにオンライン用およびバックアップ用の両方のXARファイルに障害が発生しているため，新しいXARファイルに入れ替えても，障害発生前のトランザクションブランチを回復できません。

それぞれの方法の詳細について説明します。

＜この項の構成＞

(1)　オンライン用XARファイルに障害が発生した時点でのXARファイルの入れ替え

(2)　バックアップ用XARファイルに障害が発生した時点でのXARファイルの入れ替え

(3)　オンライン用XARファイルに障害が発生しOpenTP1が停止した場合のXARファイルの入れ替え

(4)　バックアップ用XARファイルに障害が発生しOpenTP1が停止した場合のXARファイルの入れ替え

(1)　オンライン用XARファイルに障害が発生した時点でのXARファイルの入れ替え

オンライン用XARファイルに障害が発生すると，XAリソースサービスはバックアップ用XARファイルにスワップして運用を続行します。この時点でオンライン用XARファイルを新しいファイルに入れ替えると，OpenTP1を停止させることなく，障害発生前のトランザクションブランチを回復できます。

XAリソースサービスがバックアップ用XARファイルを使用して運用中の場合，オンライン用XARファイルを入れ替えるには，xarholdコマンドを使用してXAリソースサービスを強制的に閉塞します。XAリソースサービスが閉塞しても，ほかのOpenTP1サービスは実行できます。オンライン用XARファイルに障害が発生した時点での，オンライン用XARファイルの入れ替え方法を次に示します。

xarholdコマンドを実行します。
XAリソースサービスが閉塞します。

新しいオンライン用XARファイルを作成します。
障害が発生しているオンライン用XARファイルとは別のディスクボリュームに作成してください。新しいオンライン用XARファイルは，バックアップ用XARファイルと同一レコード長，同一レコード数で作成してください。

作成したXARファイルに合わせてXAリソースサービス定義のオンライン用XARファイルの定義を変更します。
オンライン用XARファイルの定義だけを変更してください。

xarrlesコマンドを実行します。
XAリソースサービスの閉塞が解除されます。共用メモリからトランザクションブランチを回復し，新しく作成したオンライン用XARファイルを使用してXAリソースサービスのオンラインが再開始されます。

オンライン用XARファイルに障害が発生した場合のXARファイルの入れ替え方法を次の図に示します。

図3-39　オンライン用XARファイルに障害が発生した場合のXARファイルの入れ替え

(2)　バックアップ用XARファイルに障害が発生した時点でのXARファイルの入れ替え

オンライン用XARファイルに障害が発生し，バックアップ用XARファイルにスワップしてXAリソースサービスの運用を続行している間に，バックアップ用XARファイルにも障害が発生した場合，XAリソースサービスは閉塞状態になります。XAリソースサービスが閉塞状態になると，XAリソースサービスで連携するアプリケーションサーバからのトランザクション指示に対して，すべてXAER_RMERRを返します。ただし，障害が局所化されているため，OpenTP1は停止しないで，XAリソースサービス以外のOpenTP1サービスは実行できます。また，XARファイルを新しいファイルに入れ替えれば，XAリソースサービスのトランザクションブランチを回復できます。

オンライン用XARファイルとバックアップ用XARファイルの両方に障害が発生してXAリソースサービスが閉塞状態になった場合の，XARファイルの入れ替え方法を次に示します。

新しいXARファイルを作成します。
オンライン用とバックアップ用のXARファイルを，同一レコード長，同一レコード数で，障害の発生していないディスクボリューム上に作成してください。

作成したXARファイルに合わせてXAリソースサービス定義のXARファイルの定義を変更します。
オンライン用およびバックアップ用の両方のXARファイルの定義を変更してください。

xarrlesコマンドを実行します。
XAリソースサービスの閉塞が解除されます。共用メモリからトランザクションブランチを回復し，新しく作成したオンライン用XARファイルを使用してXAリソースサービスのオンラインが再開始されます。

バックアップ用XARファイルで障害が発生した場合のXARファイルの入れ替え方法を次の図に示します。

図3-40　バックアップ用XARファイル障害発生時のXARファイルの入れ替え

(3)　オンライン用XARファイルに障害が発生しOpenTP1が停止した場合のXARファイルの入れ替え

オンライン用XARファイルに障害が発生し，さらにOpenTP1が停止（正常停止／異常停止）すると，XAリソースサービスは閉塞します。XAリソースサービスを再開始するには，新しいXARファイルを作成してからOpenTP1を再開始します。

オンライン用XARファイルに障害が発生し，さらにOpenTP1が停止した場合のXARファイルの入れ替え方法を次に示します。

新しいオンライン用XARファイルを作成します。
障害が発生しているオンライン用XARファイルとは別のディスクボリュームに作成してください。新しいオンライン用XARファイルは，バックアップ用XARファイルと同一レコード長，同一レコード数で作成してください。

作成したオンライン用XARファイルに合わせてXAリソースサービス定義のXARファイルの定義を変更します。
定義を変更するのはオンライン用XARファイルだけです。XAリソースサービスは，バックアップ用XARファイルからトランザクションブランチを回復するので，バックアップ用XARファイルは変更しないでください。

OpenTP1を再開始します。
OpenTP1を再開始すると，XAリソースサービスの閉塞が解除されます。バックアップ用XARファイルからトランザクションブランチを回復し，新しく作成したオンライン用XARファイルを使用してXAリソースサービスが再開始されます。

注意事項

停止したOpenTP1を正常開始，および再開始するときは，オンライン用およびバックアップ用の両方のXARファイルがI/O可能になっている必要があります。XARファイルに障害が発生したままではOpenTP1を開始できません。

オンライン用XARファイルに障害が発生し，さらにOpenTP1が停止した場合のXARファイルの入れ替え方法を次の図に示します。

図3-41　オンライン用XARファイル障害発生およびOpenTP1停止時のXARファイルの入れ替え

(4)　バックアップ用XARファイルに障害が発生しOpenTP1が停止した場合のXARファイルの入れ替え

オンライン用およびバックアップ用の両方のXARファイルに障害が発生し，さらにOpenTP1が停止（正常停止／異常停止）すると，XAリソースサービスは閉塞します。この場合，障害発生前のトランザクションブランチは回復できません。XAリソースサービスを再開始するには，新しいXARファイルを作成してからOpenTP1を強制正常開始します。

オンライン用およびバックアップ用の両方のXARファイルに障害が発生し，OpenTP1が停止した場合のXARファイルの入れ替え方法を次に示します。

新しいXARファイルを作成します。
オンライン用とバックアップ用のXARファイルを，同一レコード長，同一レコード数で，障害の発生していないディスクボリューム上に作成してください。

作成したXARファイルに合わせてXAリソースサービス定義のXARファイルの定義を変更します。
オンライン用およびバックアップ用の両方のXARファイルの定義を変更してください。

OpenTP1を強制正常開始します。
OpenTP1を再開始すると，XAリソースサービスの閉塞が解除されます。新しく作成したオンライン用XARファイルを使用してXAリソースサービスのオンラインが再開始されます。ただし，障害前のトランザクションブランチは回復できません。

注意事項

停止したOpenTP1を強制正常開始するときは，オンライン用およびバックアップ用の両方のXARファイルがI/O可能になっている必要があります。XARファイルに障害が発生したままではOpenTP1を開始できません。

オンライン用およびバックアップ用の両方のXARファイルに障害が発生し，OpenTP1が停止した場合のXARファイルの入れ替え方法を次の図に示します。

図3-42　オンライン用およびバックアップ用の両方のXARファイルに障害が発生し，OpenTP1が停止した場合のXARファイルの入れ替え

3.15.5　XAリソースサービスのトレース

XAリソースサービスは，障害の原因を解析するために次に示すトレース情報を取得しています。

XARイベントトレース

XAR性能検証用トレース

各トレース情報の詳細については，マニュアル「OpenTP1 解説」を参照してください。

3.16　JP1連携時の運用

JP1と連携してシナリオテンプレートを利用する機能を使う場合は，JP1/Base，JP1/AJS，およびJP1/AJS2 - Scenario Operationを使用します。JP1/Baseについてはマニュアル「JP1/Base」を，JP1/AJSについては内容に応じて該当するマニュアルを，JP1/AJS2 - Scenario Operationについてはマニュアル「JP1/Automatic Job Management System 2 - Scenario Operation」を参照してください。

＜この節の構成＞

3.16.1　シナリオテンプレートを利用したシステムの運用

3.16.2　シナリオの登録

3.16.3　スケールアウトの運用

3.16.4　スケールインの運用

3.16.5　ローリングアップデートの運用

3.16.6　サンプルシナリオテンプレートの利用

3.16.1　シナリオテンプレートを利用したシステムの運用

OpenTP1で利用するシナリオテンプレートとは，OpenTP1コマンド，およびOpenTP1コマンドを組み合わせた運用手順を，テンプレート（ひな形）として部品化したものです。また，シナリオテンプレートを業務に関連づけて運用手順として実行できるようにしたものを，シナリオと呼びます。

シナリオテンプレートを利用すると，JP1と連携してOpenTP1システムを自動的に運用できます。OpenTP1がシナリオテンプレートを提供しているシナリオを次に示します。

スケールアウト
新しいOpenTP1ノードを構築して，OpenTP1システムのドメイン構成に新しいOpenTP1ノードを追加します。

スケールイン
業務単位またはノード単位で，負荷レベルの低いノードのリソースを解放して，他システムに割り当てます。

ローリングアップデート
システムを停止させることなく，OSやUAPのセキュリティ対策パッチを適用します。

OpenTP1が提供しているシナリオテンプレートを次に示します。

OpenTP1_AddNode

OpenTP1_ChangeNodeID

OpenTP1_Deploy

OpenTP1_ScenarioAddNode

OpenTP1_Start

OpenTP1_StartUAP

OpenTP1_Stop

OpenTP1_StopUAP

OpenTP1_Undeploy

OpenTP1_UpdateDomain

OpenTP1_ScenarioScaleout

シナリオテンプレートの詳細については，「付録M　シナリオテンプレートの詳細」を参照してください。

シナリオテンプレートからOpenTP1コマンドを実行する場合は，JP1/AJS2 - Scenario OperationでOpenTP1コマンドの終了状態を判断するために，dcjcmdexコマンドにOpenTP1コマンドを指定して実行してください。また，シナリオテンプレートから実行されるOpenTP1コマンドの優先順位を下げないために，シナリオテンプレートの「優先順位」を「3」に設定してください。優先順位の設定については，マニュアル「JP1/Automatic Job Management System 2 - Scenario Operation」を参照してください。

3.16.2　シナリオの登録

シナリオテンプレートをJP1/AJS2 - Scenario Operationに登録するには，次に示すシナリオテンプレート定義ファイルをJP1/AJS2 - Scenario Operation Managerのシナリオライブラリフォルダに組み込みます。

シナリオテンプレート定義ファイル

/BeTRAN/jp1_template/ScenarioTemplate/TP1_ServerBase.sjis.xml

組み込み先シナリオライブラリフォルダ

/ScenarioLibrary/OpenTP1/TP1_ServerBase

シナリオテンプレート定義ファイルをJP1/AJS2 - Scenario Operation Managerのシナリオライブラリフォルダに組み込む方法については，マニュアル「JP1/Automatic Job Management System 2 - Scenario Operation」を参照してください。

シナリオの登録時に設定するシナリオ変数について説明します。

＜この項の構成＞

(1)　シナリオ変数

(1)　シナリオ変数

運用環境によって変化する情報を，シナリオに応じてあらかじめ設定しておく変数をシナリオ変数と呼びます。例えば，ホスト名，ファイル名などをシナリオ変数として設定したあとで，シナリオ登録時にシナリオ変数の値を設定すると，運用環境に応じたシナリオを実行できます。

OpenTP1が提供するシナリオテンプレートは，入力するシナリオ変数（入力シナリオ変数）から，環境変数，およびシナリオの実行ユーザを設定します。

入力シナリオ変数から設定する環境変数を次の表に示します。

表3-34　入力シナリオ変数から設定する環境変数

環境変数 | 説明 | シナリオ実行時の設定値※1
DCDIR | OpenTP1ディレクトリ※2 | ?DCDIR?
DCCONFPATH | OpenTP1定義ファイルを格納するディレクトリ※3 | ?DCCONFPATH?

注※1

「?」で囲まれた文字列は，値を設定するJP1/AJS2 - Scenario Operationの入力シナリオ変数を示します。

注※2

完全パス名を50バイト以内で指定してください。シンボリックリンクは使用できません。

注※3

完全パス名で指定してください。

これらの環境変数を実行ユーザのシステム環境変数に設定している場合は，入力シナリオ変数にもシステム環境変数と同じ値を設定する必要があります。入力シナリオ変数，システム環境変数の両方を指定した場合の動作については，マニュアル「JP1/Automatic Job Management System 構築ガイド」の環境変数に関する記述を参照してください。

システム環境変数とは，次に示す変数のことです。

UNIXの場合

JP1/AJS2 - Scenario Operationでシナリオジョブを定義するときに指定したスクリプトファイルでの定義

ローカルログインスクリプトでの定義

システムログインスクリプトでの定義

Windowsの場合

システム環境変数

シナリオの実行ユーザは，各シナリオテンプレートの入力シナリオ変数USER_NAMEで指定します。シナリオの実行ユーザとして指定できるのは，JP1/Baseでユーザマッピングされたユーザだけです。シナリオを実行する前に，OpenTP1管理者をユーザマッピングしてください。ユーザマッピングの詳細については，マニュアル「JP1/Base」を参照してください。

3.16.3　スケールアウトの運用

スケールアウトを実行すると，新しいOpenTP1ノードを構築して，OpenTP1システムのドメイン構成に新しいOpenTP1ノードを追加します。これによって，システム拡張に伴う作業を速やかに処理できます。

＜この項の構成＞

(1)　スケールアウトの運用モデル

(2)　スケールアウトのシナリオ構成

(3)　スケールアウトとDPMを利用するOpenTP1の環境設定手順

(1)　スケールアウトの運用モデル

スケールアウトを実行すると，新しいOpenTP1ノードを追加するシナリオ，およびドメイン構成を更新するシナリオが実行されます。

(a)　ドメイン構成管理ノードを使用した場合

ドメイン構成管理ノードを使用してスケールアウトを実行する場合の運用モデルを次の図に示します。

図3-43　スケールアウトの運用モデル（ドメイン構成管理ノードを使用した場合）

ドメイン構成管理ノードを使用してスケールアウトを実行する場合の手順を次に示します。

新規追加ノードの構築シナリオ(a)を実行し，OpenTP1-Cを構築します。

OpenTP1-N（ドメイン構成管理ノード）に対してドメイン構成の更新シナリオ(b)を実行し，OpenTP1-Cをドメイン構成に追加します。

(b)　ドメイン構成管理ノードを使用しない場合

ドメイン構成管理ノードを使用しないでスケールアウトを実行する場合の運用モデルを次の図に示します。

図3-44　スケールアウトの運用モデル（ドメイン構成管理ノードを使用しない場合）

この運用モデルでは，システム内のドメイン構成をノードがお互いに設定し合って管理します。新しくOpenTP1ノードを構築したあと，ほかのノードが新規ノードを認識できるように，すべてのノードに対してドメイン構成を更新します。

ドメイン構成管理ノードを使用しないでスケールアウトを実行する場合の手順を次に示します。

新規追加ノードの構築シナリオ(a)を実行し，OpenTP1-Dを構築します。

OpenTP1-A，B，Cに対してそれぞれドメイン構成の更新シナリオ(b)を実行し，OpenTP1-Dをドメイン構成に追加します。

OpenTP1-Dに対してドメイン構成の更新シナリオ(b)を実行し，システム内の他ノード（OpenTP1-A，B，C）をドメイン構成に追加します。

(2)　スケールアウトのシナリオ構成

OpenTP1のスケールアウトでは，新しいOpenTP1ノードを追加するシナリオを実行したあとに，ドメイン構成を更新するシナリオを実行します。

それぞれのシナリオについて説明します。

(a)　新しいOpenTP1ノードを追加するシナリオ

新しいOpenTP1ノードを追加するシナリオの実行順序を，次の図に示します。

図3-45　新しいOpenTP1ノードを追加するシナリオの実行順序

各シナリオテンプレートの説明を次の表に示します。

表3-35　新しいOpenTP1ノードを追加するシナリオのシナリオテンプレート

項番 | シナリオテンプレートの名称 | 説明
1 | OpenTP1_MakeTP1Dir※1 | OpenTP1ディレクトリの作成
2 | OpenTP1_SetConfig※1 | OpenTP1の定義設定
3 | OpenTP1_ChangeNodeID※2 | ノードIDの設定
4 | OpenTP1_Deploy※2 | OpenTP1の登録
5 | OpenTP1_MakeFileSystem※1 | OpenTP1ファイルシステムの作成
6 | OpenTP1_Start※2 | OpenTP1の起動
7 | OpenTP1_StartUAP※2 | UAPの起動

注※1

ユーザが作成します。OpenTP1が提供するサンプルについては，「3.16.6　サンプルシナリオテンプレートの利用」を参照してください。

注※2

OpenTP1が提供します。詳細については，「付録M　シナリオテンプレートの詳細」を参照してください。

(b)　ドメイン構成を更新するシナリオ

ドメイン構成を更新するときの前提条件を次に示します。

システム共通定義のname_domain_file_useオペランドにYを指定している

ドメイン構成を更新するノードがオンラインである

ドメイン構成を更新するシナリオの実行順序を，次の図に示します。

図3-46　ドメイン構成を更新するシナリオの実行順序

各シナリオテンプレートの説明を次の表に示します。

表3-36　ドメイン構成を更新するシナリオのシナリオテンプレート

項番 | シナリオテンプレートの名称 | 説明
1 | OpenTP1_AddNode | ドメイン定義ファイルへの追加
2 | OpenTP1_UpdateDomain | ドメイン構成の更新

これらのシナリオテンプレートはOpenTP1が提供します。詳細については，「付録M　シナリオテンプレートの詳細」を参照してください。

(3)　スケールアウトとDPMを利用するOpenTP1の環境設定手順

スケールアウトを実行すると，OpenTP1の環境設定手順の一部を自動化できます。ここでは，スケールアウトとDPMのディスク複製機能を利用する場合の環境設定手順について説明します。手順1.～8.は，スーパユーザが実行してください。また，手順1.～5.はOpenTP1システムのマスタコンピュータ（ディスク複製元）で，手順6.はDPMがインストールされているコンピュータで，手順7.～9.は新しく追加するOpenTP1ノード（ディスク複製先）で実行してください。

/etc/hostsファイルに，OpenTP1システムが使用するホスト名を登録します。

OpenTP1管理者を登録します。
詳細については，「1.2.1　OpenTP1管理者の登録」を参照してください。

OpenTP1グループを設定します。
詳細については，「1.2.2　OpenTP1グループの設定」を参照してください。

OpenTP1のプログラムプロダクトをインストールします。
OpenTP1のプログラムプロダクトをインストールするディスク（マスタディスク）は，必ずOSと同じディスクに作成してください。

スケールアウトで使用する，OpenTP1の環境設定をするためのファイルを作成します。
詳細については，「3.16.6（3）　サンプルシナリオテンプレートのカスタマイズ」を参照してください。

DPMのディスク複製機能を利用して，OpenTP1システムのマスタコンピュータからバックアップしたディスクを，新しく追加するOpenTP1ノードにリストアします。
ディスク複製先のネットワークタイプは，DHCPではなく固定IPで割り当ててください。DPMの使用方法については，マニュアル「JP1/ServerConductor/Deployment Manager」を参照してください。

JP1/AJS - Agentをセットアップします。
JP1/AJS - Agentのセットアップ方法については，マニュアル「JP1/Automatic Job Management System 構築ガイド」を参照してください。

OpenTP1ファイルシステムにrawデバイスを割り当てます。
OpenTP1ファイルシステムをキャラクタ型スペシャルファイルで運用する場合は，スケールアウトでのOpenTP1ファイルシステムの初期設定を自動的に処理するために，OpenTP1ファイルシステムにrawデバイスを割り当てます。

スケールアウトを実行します。
スケールアウトを実行すると，新しいOpenTP1ノードを追加するシナリオが実行されます。このシナリオが実行されると，次に示す処理を自動的に実行できます。
1.　OpenTP1ディレクトリの作成
2.　システム定義の作成
3.　OpenTP1のOSへの登録
4.　OpenTP1ファイルシステムの初期設定
5.　OpenTP1ファイルの作成

3.16.4　スケールインの運用

スケールインを実行すると，ノード単位または業務単位で，負荷レベルの低いノードのリソースを解放して，他システムに割り当てます。これによって，リソースを有効に利用できます。

＜この項の構成＞

(1)　スケールインのシナリオ構成

(1)　スケールインのシナリオ構成

OpenTP1のスケールインのシナリオには，OpenTP1を停止してノード単位にリソースを解放するシナリオと，UAPを停止して業務単位にリソースを解放するシナリオの二つがあります。二つのシナリオのどちらかを実行してください。それぞれのシナリオについて説明します。

(a)　OpenTP1を停止してリソースを解放するシナリオ

OpenTP1を停止してOpenTP1ノードのリソースを解放するシナリオを，次の図に示します。

図3-47　OpenTP1を停止してリソースを解放するシナリオ

シナリオテンプレートの説明を次の表に示します。

表3-37　OpenTP1を停止してリソースを解放するシナリオのシナリオテンプレート

項番 | シナリオテンプレートの名称 | 説明
1 | OpenTP1_Stop | OpenTP1の停止

このシナリオテンプレートはOpenTP1が提供します。詳細については，「付録M　シナリオテンプレートの詳細」を参照してください。

(b)　UAPを停止してリソースを解放するシナリオ

UAPを停止してOpenTP1の業務リソースを解放するシナリオを，次の図に示します。

図3-48　UAPを停止してリソースを解放するシナリオ

シナリオテンプレートの説明を次の表に示します。

表3-38　UAPを停止してリソースを解放するシナリオのシナリオテンプレート

項番 | シナリオテンプレートの名称 | 説明
1 | OpenTP1_StopUAP | UAPの停止

このシナリオテンプレートはOpenTP1が提供します。詳細については，「付録M　シナリオテンプレートの詳細」を参照してください。

3.16.5　ローリングアップデートの運用

ローリングアップデートを実行すると，システムを停止させることなく，OSやUAPのセキュリティ対策パッチを適用します。これによって，システムを連続運転できます。

OpenTP1の停止および削除によってOpenTP1システムが停止するおそれのあるノードは，ローリングアップデートを実行しないでください。

＜この項の構成＞

(1)　ローリングアップデートの運用モデル

(2)　ローリングアップデートのシナリオ構成

(1)　ローリングアップデートの運用モデル

ローリングアップデートを実行する場合の運用モデルを次の図に示します。

図3-49　ローリングアップデートの運用モデル

(2)　ローリングアップデートのシナリオ構成

ローリングアップデートの実行順序を，次の図に示します。

図3-50　ローリングアップデートの実行順序

各シナリオテンプレートの説明を次の表に示します。

表3-39　ローリングアップデートのシナリオテンプレート

項番 | シナリオテンプレートの名称 | 説明
1 | OpenTP1_Stop※1 | OpenTP1の停止
2 | OpenTP1_Undeploy※1 | OpenTP1の削除
3 | Patch※2 | パッチの適用
4 | OpenTP1_Deploy※1 | OpenTP1の登録
5 | OpenTP1_Start※1 | OpenTP1の起動

注※1

OpenTP1が提供します。詳細については，「付録M　シナリオテンプレートの詳細」を参照してください。

注※2

ユーザが作成します。

3.16.6　サンプルシナリオテンプレートの利用

OpenTP1では，スケールアウトのシナリオテンプレートのうち，新しいOpenTP1ノードを追加するシナリオのサンプルシナリオテンプレートを提供しています。

OpenTP1をインストールした状態でサンプルシナリオテンプレート（OpenTP1_ScenarioScaleout）を実行すると，新しいOpenTP1の環境構築をしたあとに，OpenTP1とサンプルユーザサーバ（basespp）を起動します。サンプルシナリオテンプレートをカスタマイズすると，ご使用の環境に合わせて，スケールアウトを簡単に実行できます。

＜この項の構成＞

(1)　サンプルシナリオテンプレートの概要

(2)　サンプルシナリオテンプレートの登録

(3)　サンプルシナリオテンプレートのカスタマイズ

(1)　サンプルシナリオテンプレートの概要

サンプルシナリオテンプレートの概要について説明します。

サンプルシナリオテンプレートは，次の表に示す処理を実行します。

表3-40　サンプルシナリオテンプレートが実行する処理

項番
処理内容
シナリオテンプレートの名称
参照する入力シナリオ変数

1
OpenTP1ディレクトリの作成
OpenTP1_MakeTP1Dir

DCDIR

DCCONFPATH

HOST_NAME

USER_NAME

GROUP_NAME

2
OpenTP1の定義設定
OpenTP1_SetConfig

DCDIR

DCCONFPATH

HOST_NAME

USER_NAME

BETRAN_FILE1

BETRAN_FILE2

PORT_NUMBER

3
ノードIDの設定
OpenTP1_ChangeNodeID

DCDIR

DCCONFPATH

HOST_NAME

USER_NAME

NODE_ID

4
OpenTP1の登録
OpenTP1_Deploy

DCDIR

DCCONFPATH

HOST_NAME

5
OpenTP1ファイルシステムの作成
OpenTP1_MakeFileSystem

DCDIR

DCCONFPATH

HOST_NAME

USER_NAME

BETRAN_FILE1

BETRAN_FILE2

6
OpenTP1の起動
OpenTP1_Start

DCDIR

DCCONFPATH

HOST_NAME

USER_NAME

7
UAP（サンプルプログラム）の起動
OpenTP1_StartUAP

DCDIR

DCCONFPATH

HOST_NAME

USER_NAME

USER_SERVER_NAME

シナリオテンプレートごとに詳細を説明します。

1.OpenTP1ディレクトリの作成（OpenTP1_MakeTP1Dir）

OpenTP1ディレクトリ作成シェルファイル※を使用して，次に示す順序でOpenTP1ディレクトリを作成します。

ユーザ名・グループ名を取得（getUSERNAME）します。
指定したUSER_NAME，GROUP_NAMEが取得され，makeTP1Dirシナリオに引き継がれます。ただし，USER_NAME，GROUP_NAMEを両方とも省略した場合は，JP1/Baseで定義したユーザマッピングのプライマリユーザおよびユーザが属するグループが取得されます。

OpenTP1ディレクトリを作成（makeTP1Dir）します。
OpenTP1ディレクトリ作成シェルファイル※を使用して，次のようなOpenTP1ディレクトリを作成します。
　・ディレクトリ：入力シナリオ変数DCDIRの設定値
　・所有者：入力シナリオ変数USER_NAMEの設定値
　・グループ：入力シナリオ変数GROUP_NAMEの設定値
　・モード：0755
指定したOpenTP1ディレクトリの親ディレクトリがない場合は，親ディレクトリも含めて作成します。ただし，所有者・グループ・モードの設定は，OpenTP1ディレクトリにだけ行います。

2.OpenTP1の定義設定（OpenTP1_SetConfig）

OpenTP1環境設定シェルファイル※を使用して，OpenTP1のシステム定義およびロードモジュールを，次に示す順序で設定します。

$DCDIR/aplib，$DCDIR/jp1_template/tools，および$DCCONFPATHディレクトリを作成します。

/BeTRAN/jp1_template/examplesディレクトリ下のaplib，conf，およびtoolsを作成したディレクトリ下にコピーします。

システム定義のノード固有情報（ファイルシステムのパス名など）を設定します。

3.ノードIDの設定（OpenTP1_ChangeNodeID）

OpenTP1のノードIDを入力シナリオ変数NODE_IDの設定値で設定します。

4.OpenTP1の登録（OpenTP1_Deploy）

dcsetupコマンドを実行し，OpenTP1をOSに登録します。

5.OpenTP1ファイルシステムの作成（OpenTP1_MakeFileSystem）

OpenTP1ファイル作成シェルファイル※を使用して，OpenTP1ファイルシステムおよびOpenTP1ファイルを作成します。

OpenTP1ファイルシステム名は，入力シナリオ変数BETRAN_FILE1，およびBETRAN_FILE2の設定値になります。

6.OpenTP1の起動（OpenTP1_Start）

OpenTP1を起動します。

7.UAP（サンプルプログラム）の起動（OpenTP1_StartUAP）

入力シナリオ変数USER_SERVER_NAMEに設定されたユーザサーバのUAPを起動します。

注※

シェルファイルは，ご使用のOSによって異なります。OSごとのシェルファイルのパスを，次の表に示します。

表3-41　OSごとのシェルファイルのパス

シェルファイル名 | OS
UNIX | Windows
OpenTP1ディレクトリ作成シェルファイル | /BeTRAN/jp1_template/examples/tools/dcjmk_dcdir.sh | （OpenTP1をインストールしたディレクトリ）¥jp1_template¥examples¥tools¥dcjmk_dcdir.bat
OpenTP1環境設定シェルファイル | /BeTRAN/jp1_template/examples/tools/dcjset_conf.sh | （OpenTP1をインストールしたディレクトリ）¥jp1_template¥examples¥tools¥dcjset_conf.bat
OpenTP1ファイル作成シェルファイル | /BeTRAN/jp1_template/examples/tools/dcj_mkfs.sh | （OpenTP1をインストールしたディレクトリ）¥jp1_template¥examples¥tools¥dcj_mkfs.bat

(2)　サンプルシナリオテンプレートの登録

サンプルシナリオテンプレートを実行するには，サンプルシナリオテンプレートを，JP1/AJS2 - Scenario Operation Viewの操作によってJP1/AJS - Managerに登録します。

サンプルシナリオテンプレートは，次の場所に格納されています。

/ScenarioLibrary/OpenTP1/TP1_ServerBase/OpenTP1_ScenarioScaleout

サンプルシナリオテンプレートを登録するには，次の表に示す入力シナリオ変数を設定します。

表3-42　サンプルシナリオテンプレートへの設定情報

入力シナリオ変数 | 内容 | 設定例
DCDIR | OpenTP1のホームディレクトリ | /home/user/OpenTP1
DCCONFPATH | OpenTP1定義ファイル格納ディレクトリ | /home/user/OpenTP1/conf
HOST_NAME※1 | 実行するOpenTP1ノードのホスト名 | hostX
USER_NAME※1 | OpenTP1のユーザ名 | user
GROUP_NAME※1 | OpenTP1のグループ名 | tp1
BETRAN_FILE1※2 | OpenTP1ファイルシステムのパス | /home/user/OpenTP1/betranfile1
BETRAN_FILE2※2 | OpenTP1ファイルシステムのパス | /home/user/OpenTP1/betranfile2
USER_SERVER_NAME | ユーザサーバ名 | basespp（サンプルでは固定）
NODE_ID | OpenTP1のノード識別子（ノードごとに一意の4文字の文字列） | smpl
PORT_NUMBER | OpenTP1のネームポート番号 | 10000

注※1

設定を省略できます。入力シナリオ変数USER_NAMEおよび入力シナリオ変数GROUP_NAMEは，両方設定するか，または両方設定しないかのどちらかにしてください。

注※2

キャラクタ型スペシャルファイルを設定する場合は，シナリオを実行する前にパーティションを割り当ててください。

この設定例の値をサンプルシナリオテンプレートに設定してシナリオを実行した場合，次の図に示すようなディレクトリ構成のOpenTP1実行環境が作成されます。

図3-51　サンプルシナリオテンプレート実行後のOpenTP1ディレクトリ

(3)　サンプルシナリオテンプレートのカスタマイズ

サンプルとして提供されるOpenTP1定義ファイルやシェルファイルなどをカスタマイズすると，OpenTP1の構成を簡単に変更できます。また，ご使用の環境に合わせてカスタマイズしたファイルを，OpenTP1のインストール環境とともにDPMで作成するマスタディスクに格納すると，スケールアウトを簡単に実行できます。

ユーザがカスタマイズできるサンプルファイルを次に示します。

サンプルプログラムのロードモジュール

システム定義ファイル

OpenTP1環境設定シェルファイル

OpenTP1ファイル作成シェルファイル

各ファイルのカスタマイズ方法を次に示します。

(a)　サンプルプログラムのロードモジュールのカスタマイズ

業務に合わせたSUPおよびSPPを作成し，ロードモジュール（実行形式ファイル）を任意のディレクトリに格納してください。

(b)　システム定義ファイルおよびOpenTP1環境設定シェルファイルのカスタマイズ

OpenTP1のシステム定義をカスタマイズするには，システム定義ファイルおよびOpenTP1環境設定シェルファイルを変更します。

システム定義ファイルのカスタマイズ
OpenTP1の各システム定義ファイルの中で，必要なものをあらかじめ設定しておきます。設定内容をノードごとに変えたい場合は，シナリオテンプレート用の文字列「@DCxxxxxx@」を設定してください。「@DCxxxxxx@」の値は，dcjchconfコマンドで設定できます。

OpenTP1環境設定シェルファイルのカスタマイズ
次の表に示すファイルは，OpenTP1環境設定シェルファイルの設定に従って，インストールディレクトリ（/BeTRAN）下からOpenTP1ディレクトリ（$DCDIR）下にコピーされます。そのため，これらのファイルの格納場所を変更した場合は，OpenTP1環境設定シェルファイルの設定値を変更してください。

表3-43　サンプルのOpenTP1環境設定シェルファイルの設定値

ファイルの種類
格納場所
コピー先

サンプルプログラムのロードモジュール
/BeTRAN/jp1_template/examples/aplib
$DCDIR/aplib

システム定義ファイル
/BeTRAN/jp1_template/examples/conf
$DCCONFPATH

OpenTP1ファイル作成シェルファイル
/BeTRAN/jp1_template/examples/tools
（ファイル名：dcj_mkfs.sh）
$DCDIR/jp1_template/tools

OpenTP1環境設定シェルファイルは，システム定義ファイルに設定された文字列「@DCxxxxxx@」を，dcjchconfコマンドを実行して設定します。サンプルシナリオテンプレートの場合，次の表に示すように設定されます。

表3-44　サンプルシナリオテンプレートの文字列「@DCxxxxxx@」の設定値

ファイル名 | オペランド名／定義コマンド名 | システム定義ファイルの設定値 | OpenTP1環境設定シェルファイルの設定値※1
cdtrn | jnladdpf | @DCbetran@ | ?BETRAN_FILE1?
env | DCCONFPATH | @DCconfpath@ | $DCCONFPATH
prc | prcsvpath | @DChomepath@ | $DCDIR
sts | sts_file_name | @DCbetran@ | ?BETRAN_FILE1?
@DCbetran2@ | ?BETRAN_FILE2?
sysjnl | jnladdpf | @DCbetran@ | ?BETRAN_FILE1?
betranrc | node_id※2 | @DCNODE_ID@ | ?NODE_ID?
name_port | @DCport_number@ | ?PORT_NUMBER?

注※1

「?」で囲まれた文字列は，入力シナリオ変数に設定された値を示します。

注※2

サンプルシナリオテンプレートが実行する「ノードIDの設定」シナリオを実行すると，自動的に設定されます。

(c)　OpenTP1ファイル作成シェルファイルのカスタマイズ

サンプルシナリオテンプレートでは，入力シナリオ変数BETRAN_FILE1および入力シナリオ変数BETRAN_FILE2で設定したOpenTP1ファイルシステム（/home/user/OpenTP1/betranfile1および/home/user/OpenTP1/betranfile2）に，次の表に示すファイルを作成します。作成するファイルを変更する場合は，OpenTP1ファイル作成シェルファイルをカスタマイズしてください。

表3-45　入力シナリオ変数BETRAN_FILEに作成されるファイル

ファイル名 | ファイル種別
cpdf01※1 | チェックポイントダンプファイル
cpdf02※1
cpdf03※1
stsfil01※1 | ステータスファイル（A系）
stsfil03※1
jnlf01※1 | システムジャーナルファイル
jnlf02※1
jnlf03※1
stsfil02※2 | ステータスファイル（B系）
stsfil04※2

注※1

/home/user/OpenTP1/betranfile1に作成されるファイルです。

注※2

/home/user/OpenTP1/betranfile2に作成されるファイルです。

3.17　リアルタイム統計情報サービスを使用する運用

リアルタイム統計情報サービスを使用して，リアルタイム統計情報を取得する運用について説明します。

＜この節の構成＞

3.17.1　リアルタイム統計情報サービスを使用するための準備

3.17.2　リアルタイム統計情報サービスの開始と終了

3.17.3　リアルタイム統計情報の取得

3.17.4　リアルタイム統計情報の出力

3.17.5　リアルタイム統計情報の取得情報の設定変更

3.17.1　リアルタイム統計情報サービスを使用するための準備

リアルタイム統計情報サービスを使用する場合，次に示す準備が必要です。

＜この項の構成＞

(1)　実行環境の設定

(2)　定義の作成

(1)　実行環境の設定

rtssetupコマンドで，リアルタイム統計情報サービスの実行環境を設定します。rtssetupコマンドを実行すると，実行モジュールおよびユーザサービス定義が作成されます。作成されるディレクトリとファイル名を次の表に示します。

表3-46　rtssetupコマンドを実行すると作成されるディレクトリとファイル名

ディレクトリ | ファイル名 | 説明
$DCDIR/aplib/※ | rtssup | 実行モジュール
rtsspp
$DCCONFPATH/ | RTSSUP | ユーザサービス定義
RTSSPP

注※

rtssetupコマンドのサーバ格納先パスの指定を省略した場合のディレクトリです。サーバ格納先パスを指定した場合，ファイルは指定したディレクトリに出力されます。

実行モジュールの格納先や$DCCONFPATHで指定したパスに，すでに同一名称のファイルがある場合，rtssetupコマンドはファイルを作成しません。

(2)　定義の作成

リアルタイム統計情報サービス定義およびリアルタイム取得項目定義を作成します。定義の詳細については，マニュアル「OpenTP1 システム定義」を参照してください。

3.17.2　リアルタイム統計情報サービスの開始と終了

リアルタイム統計情報サービスでは，次に示す順序でサービスを開始，終了する必要があります。

リアルタイム統計情報サービスの開始（RTSSUPの起動）

リアルタイム統計情報サービスの拡張機能の開始（RTSSPPの起動）※

リアルタイム統計情報サービスの拡張機能の終了（RTSSPPの停止）

リアルタイム統計情報サービスの終了（RTSSUPの停止）

注※

リアルタイム統計情報サービスの拡張機能（RTSSPP）の開始が必要なのは，リアルタイム統計情報サービス（RTSSUP）の開始中に，リアルタイム統計情報の取得情報の設定を変更したい場合だけです。取得情報の設定変更については，「3.17.5　リアルタイム統計情報の取得情報の設定変更」を参照してください。

リアルタイム統計情報サービス開始および終了について説明します。

＜この項の構成＞

(1)　リアルタイム統計情報サービスの開始

(2)　リアルタイム統計情報サービスの拡張機能の開始

(3)　リアルタイム統計情報サービスの拡張機能の終了

(4)　リアルタイム統計情報サービスの終了

(5)　リアルタイム統計情報サービスの再開始

(6)　リアルタイム統計情報サービスの動作

(1)　リアルタイム統計情報サービスの開始

リアルタイム統計情報サービスの開始方法には，次のニつがあります。

OpenTP1の開始後にdcsvstartコマンドでRTSSUPを起動する方法

ユーザサービス構成定義のdcsvstart定義コマンドでRTSSUPを起動する方法

リアルタイム統計情報サービスは，サービスの開始時に次に示す処理を行います。

共用メモリの確保

リアルタイム統計情報を取得するために必要な，RTSサービス用の共用メモリを確保します。必要なRTSサービス用の共用メモリを確保できなかった場合，リアルタイム統計情報サービスは開始処理を中止します。リアルタイム統計情報サービスで使用する共用メモリの詳細については，マニュアル「OpenTP1 解説」を参照してください。

RTSログファイルの作成

RTSログファイルの詳細については，「3.17.4(2)　リアルタイム統計情報のRTSログファイルへの出力」を参照してください。

リアルタイム統計情報サービスの管理情報の取得

取得したリアルタイム統計情報サービスの管理情報は，rtslsコマンドで標準出力に出力できます。

(2)　リアルタイム統計情報サービスの拡張機能の開始

リアルタイム統計情報サービスの拡張機能の開始方法には，次のニつがあります。

dcsvstartコマンドでRTSSPPを起動する方法

ユーザサービス構成定義のdcsvstart定義コマンドでRTSSPPを起動する方法
この方法でRTSSPPを起動する場合，次に示すように定義を記述して，RTSSUPを起動したあとにRTSSPPを起動するようにしてください。

dcsvstart -u RTSSUP
dcsvstart -u RTSSPP

リアルタイム統計情報サービスが開始していない状態でリアルタイム統計情報サービスの拡張機能を開始した場合，RTSSPPはKFCA32723-Eメッセージをメッセージログに出力したあと，エラーの要因がSERVER DOWNのKFCA01812-Eメッセージを出力してダウンします。これらのメッセージが表示された場合は，dcsvstartコマンドでRTSSUPを起動（リアルタイム統計情報サービスを開始）したあとに再度RTSSPPを起動してください。リアルタイム統計情報サービスの拡張機能を開始できます。

リアルタイム統計情報サービスの拡張機能（RTSSPP）に対して次に示すコマンドを実行しないでください。実行した場合は，エラーとなります。

scdchprcコマンド※1

scdholdコマンド※2

scdrlesコマンド※1

scdrsprcコマンド※1

注※1

RTSSPPがダウンします。

注※2

rtsstatsコマンドを実行できなくなります。

(3)　リアルタイム統計情報サービスの拡張機能の終了

リアルタイム統計情報サービスの拡張機能を終了させるには，dcsvstopコマンドでRTSSPPを停止させます。

(4)　リアルタイム統計情報サービスの終了

リアルタイム統計情報サービスを終了させるには，dcsvstopコマンドでRTSSUPを停止させます。RTSSPPが開始している場合は，dcsvstopコマンドでRTSSPPを停止させてからRTSSUPを停止させてください。

(5)　リアルタイム統計情報サービスの再開始

リアルタイム統計情報サービスを再開始するには，リアルタイム統計情報サービスの終了後に，リアルタイム統計情報サービスを開始させます。リアルタイム統計情報サービスは，サービスの再開始時にRTSログファイルを作り直して使用します。

リアルタイム統計情報サービスは，再開始時にリアルタイム統計情報の取得を開始します。取得を開始するときに前回のリアルタイム統計情報サービスで取得していた統計情報を引き継ぐかどうかは，RTSSUPの開始時の状態によって異なります。

(6)　リアルタイム統計情報サービスの動作

RTSSUPの開始時の状態によって，リアルタイム統計情報サービスの動作（前回のリアルタイム統計情報の引き継ぎ，反映されるリアルタイム統計情報サービス定義）が異なるものがあります。RTSSUPの開始時の状態と，リアルタイム統計情報サービスの動作を次の表に示します。

表3-47　RTSSUPの開始時の状態とリアルタイム統計情報サービスの動作

RTSSUPの開始時の状態 | リアルタイム統計情報サービスの動作
開始形態 | 前回の状態 | 前回のリアルタイム統計情報の引き継ぎ | 反映される定義
開始 | 未起動 | リアルタイム統計情報を取得していないため，該当しません | ○
再開始 | dcsvstopコマンドで停止 | 引き継ぎません | △
-fオプションを指定したdcsvstopコマンドで強制停止 | 引き継ぎます | ×
ダウン | 引き継ぎます | ×
OpenTP1の再開始※ | オンライン | 引き継ぎません | ○
-fオプションを指定したdcsvstopコマンドで強制停止 | 引き継ぎません | ○

（凡例）

○：リアルタイム統計情報サービス定義の，すべてのオペランドおよび定義コマンドが反映されます。

△：リアルタイム統計情報サービス定義のうち，次に示すオペランド以外が反映されます。

　・rts_service_maxオペランド

　・rts_item_maxオペランド

×：リアルタイム統計情報サービス定義の，すべてのオペランドおよび定義コマンドは反映されません。

注※

-Uオプションを指定したdcstartコマンドでOpenTP1を再開始した場合，リアルタイム統計情報サービスは開始されません。

3.17.3　リアルタイム統計情報の取得

リアルタイム統計情報は，RTSサービス用の共用メモリに取得されます。

リアルタイム統計情報を取得する方法には，定義で実行環境を指定する方法と，APIで任意の区間を指定する方法があります。ここでは，定義で実行環境を指定する方法について説明します。APIで任意の区間を指定する方法については，マニュアル「OpenTP1 プログラム作成の手引」を参照してください。

定義で実行環境を指定したリアルタイム統計情報の取得の概要を図に示します。

図3-52　リアルタイム統計情報の取得の概要

リアルタイム統計情報サービスは，リアルタイム統計情報サービス定義およびリアルタイム取得項目定義のファイルの内容を解析します。

リアルタイム統計情報サービスは，RTSサービス用の共用メモリにリアルタイム統計情報の格納領域を設定します。

設定された格納領域には，UAPからのリアルタイム統計情報が定義に基づいて取得されます。

＜この項の構成＞

(1)　取得対象の指定方法

(2)　取得項目の指定方法

(3)　取得間隔の指定方法

(4)　注意事項

(1)　取得対象の指定方法

リアルタイム統計情報サービスでは，統計情報を取得する対象を指定できます。取得対象は，リアルタイム統計情報サービス定義のrtsput定義コマンドで指定します。rtsput定義コマンドで指定できる取得対象の上限数は，リアルタイム統計情報サービス定義のrts_service_maxオペランドに指定した値までです。統計情報の取得対象の詳細については，「付録E.5　リアルタイム統計情報」を参照してください。

rtsput定義コマンドのオプションの指定値と，統計情報の取得対象の組み合わせを次の表に示します。

表3-48　rtsput定義コマンドのオプションの指定値と取得対象

rtsput定義コマンドのオプションの指定値 | 取得対象
-u sys | システム全体の統計情報※1
-u srv -s サーバ名 | 指定したサーバの統計情報※2
-u svc -s サーバ名 -v サービス名 | 指定したサービスの統計情報
-u obj -o ポート番号 -b IPアドレス | 指定したポート番号およびIPアドレスの統計情報

注※1

rts_service_maxオペランドで指定する取得対象の指定数に関係なく取得できます。

注※2

指定したサーバの次に示す統計情報を取得します。

・サーバ全体での統計情報

・サーバが提供する各サービスの統計情報

・サービス以外の処理（メイン関数など）の統計情報

このため，取得対象の指定数は，指定したサーバが提供するサービス数に2を加えたものになります。システムサーバやSUPなどのサービスを持たないサーバを指定した場合は，サーバ全体の統計情報だけを取得します。

リアルタイム統計情報の取得対象に指定したサーバは，リアルタイム統計情報サービスの開始時にあらかじめ起動しておく必要はありません。次に示す場合でも，リアルタイム統計情報を取得できます。

リアルタイム統計情報サービスを開始したあとで，取得対象とするサーバを起動した場合

リアルタイム統計情報サービスの開始中に，取得対象とするサーバをいったん停止して再起動した場合

(2)　取得項目の指定方法

それぞれの取得対象で，取得するリアルタイム統計情報を指定できます。一つの取得対象で取得できる項目の上限数は，リアルタイム統計情報サービス定義のrts_item_maxオペランドに指定した値までです。

取得項目の指定には，次に示す方法があります。

rtsput定義コマンドの-eオプションに，取得する情報の項目IDを指定する方法
項目IDの詳細については，「付録E.5　リアルタイム統計情報」を参照してください。

rtsput定義コマンドの-fオプションに，リアルタイム取得項目定義ファイルを指定する方法
リアルタイム取得項目定義の指定方法については，マニュアル「OpenTP1 システム定義」を参照してください。

(3)　取得間隔の指定方法

リアルタイム統計情報取得間隔は，リアルタイム統計情報サービス定義のrts_trcput_intervalオペランドで指定します。

取得間隔の概要を図に示します。

図3-53　リアルタイム統計情報の取得間隔の概要

RTSサービス用の共用メモリには，リアルタイム統計情報を格納する領域が複数個用意されています。

リアルタイム統計情報サービスは，rts_trcput_intervalオペランドに指定した時間の経過までは，同じ格納領域で統計情報を取得，編集します。

指定時間が経過したら格納領域を切り替えます。

リアルタイム統計情報サービス定義のrts_log_fileオペランドにYが設定されている場合，編集が終了した格納領域のリアルタイム統計情報は，RTSログファイルに出力されます。
RTSログファイルへの出力の詳細については，「3.17.4(2)　リアルタイム統計情報のRTSログファイルへの出力」を参照してください。

統計情報の取得間隔は，リアルタイム統計情報サービスの正常開始時に，リアルタイム統計情報サービス定義のrts_trcput_intervalオペランドで変更できます。定義の指定が反映されるタイミングについては，「3.17.2(6)　リアルタイム統計情報サービスの動作」を参照してください。

(4)　注意事項

リアルタイム統計情報を取得する対象となるサーバは，OpenTP1のシステムサービスを提供するサーバと，dcsvstartコマンドで起動したUAPだけです。

サービス単位でリアルタイム統計情報を取得できるのは，UAPだけです。ただし，SUPとXATMIインタフェースを使用したUAPでは，サービス単位のリアルタイム統計情報は取得できません。

rtsput定義コマンドの-uオプションにsrvを指定した場合，指定したサーバが提供する各サービスの名称は，そのサーバのユーザサービス定義のserviceオペランドから取得します。
このため，環境変数DCCONFPATHまたはDCUAPCONFPATHで指定したパスに，ユーザサービス定義ファイルまたはユーザサービスデフォルト定義ファイルが格納されている必要があります。
ユーザサービス定義ファイルが格納されていない場合は，リアルタイム統計情報サービスを開始できません。また，ユーザサービス定義ファイルにserviceオペランドが指定されていない場合は，サーバ単位でのリアルタイム統計情報だけを取得します。

リアルタイム統計情報サービスの開始後にユーザサービス定義に追加または削除したサービスは，rtsput定義コマンドの-uオプションにsrvを指定している場合でも，リアルタイム統計情報の取得対象に反映されません。リアルタイム統計情報サービスの開始後に取得対象の設定を変更するには，rtsstatsコマンドを使用するか，またはリアルタイム統計情報サービス（RTSSUP）を再起動してください。
また，リアルタイム統計情報サービスの開始後に，サービス関数動的ローディング機能で追加または削除したサービスも，リアルタイム統計情報の取得対象に反映されません。リアルタイム統計情報サービスの開始後に取得対象の設定を変更するには，rtsstatsコマンドを使用するか，またはリアルタイム統計情報サービス（RTSSUP）を再起動してください。
rtsstatsコマンドを使用して取得対象の設定を変更する方法については，「3.17.5　リアルタイム統計情報の取得情報の設定変更」を参照してください。

システム全体の統計情報，またはマルチサーバを使用しているUAPでは，複数プロセスからの書き込み処理が同時に行われた場合，リアルタイム統計情報が取得されないことがあります。これは，統計情報の取得処理で排他を使用しないためです。

3.17.4　リアルタイム統計情報の出力

RTSサービス用の共用メモリに取得したリアルタイム統計情報の出力について説明します。

＜この項の構成＞

(1)　リアルタイム統計情報の標準出力への出力

(2)　リアルタイム統計情報のRTSログファイルへの出力

(3)　リアルタイム統計情報のRTSログファイルの編集出力

(1)　リアルタイム統計情報の標準出力への出力

rtslsコマンドを実行すると，RTSサービス用の共用メモリ上に取得したリアルタイム統計情報を標準出力に出力できます。標準出力に出力できるのは，リアルタイム統計情報サービスの管理情報および統計情報です。これらの情報を標準出力に出力することによって，OpenTP1システムの稼働状況をリアルタイムに把握することができます。

(2)　リアルタイム統計情報のRTSログファイルへの出力

RTSサービス用の共用メモリに取得したリアルタイム統計情報は，リアルタイム統計情報サービスが作成するRTSログファイルに出力できます。RTSログファイルに出力するには，リアルタイム統計情報サービス定義のrts_log_fileオペランドにYを指定して，リアルタイム統計情報サービスを開始します。

(a)　RTSログファイルの作成

リアルタイム統計情報サービスは，リアルタイム統計情報サービスの開始時にRTSログファイルを作成します。

作成するRTSログファイルの数は，リアルタイム統計情報サービス定義のrts_log_file_countオペランドで指定します。

RTSログファイルを格納先と名称は，リアルタイム統計情報サービス定義のrts_log_file_nameオペランドで指定します。作成されるRTSログファイルの名称には，RTSログファイルの世代番号が付加されます。次に示すようにオペランドを指定した場合，リアルタイム統計情報サービスは，/OpenTP1/spool/dcrtsinf直下のディレクトリにrtslog1，rstlog2，rtslog3という名称のRTSログファイルを作成します。

set rts_log_file_count=3
set rts_log_file_name=/OpenTP1/spool/dcrtsinf/rtslog

リアルタイム統計情報サービス定義のrts_log_file_backupオペランドにYを指定するか，またはオペランドの指定を省略した場合，リアルタイム統計情報サービスの開始時にRTSログファイルのバックアップファイルを作成します。上記の定義例のようにオペランドを指定して，/OpenTP1/spool/dcrtsinfの直下のディレクトリにrtslog1，rtslog2，rtslog3という名称のRTSログファイルが作成されている場合，rtslog1.bk，rtslog2.bk，rtslog3.bkという名称のバックアップファイルを作成します。その後，rtslog1，rtslog2，rtslog3という名称のRTSログファイルを作り直します。rts_log_file_backupオペランドにNを指定した場合は，バックアップファイルを作成しません。

RTSログファイルの出力先に，RTSログファイル，またはバックアップファイルと同じ名称のファイルやディレクトリを作成しないでください。同じ名称のファイルを作成した場合は，RTSログファイル，またはバックアップファイルで上書きします。同じ名称のディレクトリを作成した場合は，RTSログファイル，またはバックアップファイルを作成できません。

(b)　RTSログファイルへの出力

リアルタイム統計情報サービスは，RTSサービス用の共用メモリに取得した統計情報を，リアルタイム統計情報サービス定義のrts_trcput_intervalオペランドで指定した取得間隔でRTSログファイルに出力します。

RTSログファイルのサイズは，リアルタイム統計情報サービス定義のrts_log_file_sizeオペランドで指定します。RTSログファイルに出力されるリアルタイム統計情報のサイズがrts_log_file_sizeオペランドの指定値を超える場合，出力先は次の世代のRTSログファイルに切り替わります。すべての世代のRTSログファイルを使い切った場合は，最初の世代のRTSログファイルに戻ってリアルタイム統計情報を出力します。

RTSログファイルの出力先の切り替えを次の図に示します。

図3-54　RTSログファイルの出力先の切り替え

(c)　RTSログファイルの障害

リアルタイム統計情報サービスのオンライン中にRTSログファイルのI/O障害が発生した場合，統計情報の出力先のRTSログファイルを，次の世代のRTSログファイルに切り替えて出力処理を続行します。

すべてのRTSログファイルにI/O障害が発生した場合，KFCA32708-Wメッセージを出力してRTSログファイルへのリアルタイム統計情報の出力を停止します。RTSサービス用の共用メモリへの取得は続行します。

(3)　リアルタイム統計情報のRTSログファイルの編集出力

rtseditコマンドを実行すると，RTSログファイルに出力した統計情報を，CSV形式で編集出力できます。

3.17.5　リアルタイム統計情報の取得情報の設定変更

リアルタイム統計情報サービスの開始中に，統計情報の取得対象や取得項目を変更するには，rtsstatsコマンドを使用します。取得対象や取得項目を変更する場合は，リアルタイム統計情報サービス（RTSSUP），およびリアルタイム統計情報サービスの拡張機能（RTSSPP）を開始している必要があります。

すでにリアルタイム統計情報を取得している取得対象に対して取得項目を追加する場合の例を，次の図に示します。

図3-55　取得項目を追加する例

次のように指定して，rtsstatsコマンドを実行します。

rtsstats -a -u svc -s サーバ1 -v サービス1 -e ID2 -f ファイル1

RTSSPPは，-eオプションによって項目ID2を追加して，-fオプションで指定したファイル1によって項目ID3を追加します。

リアルタイム統計情報サービスの開始中に，取得情報の設定を変更する方法について説明します。

＜この項の構成＞

(1)　取得対象の追加

(2)　取得項目の追加

(3)　取得対象の削除

(4)　取得項目の削除

(5)　注意事項

(1)　取得対象の追加

取得対象を追加する場合は，rtsstatsコマンドに-aオプションを指定して実行します。

取得対象の数がリアルタイム統計情報サービス定義のrts_service_maxオペランドの指定値を超える場合，rtsstatsコマンドはKFCA32742-Eメッセージを出力して終了します。システム全体の統計情報は取得対象の数に含まれないため，取得対象の数が最大数に達している場合でも追加できます。

-uオプションでsrvを指定した場合は，-sオプションで指定したサーバの，次に示す統計情報の取得を追加します。

サーバ全体での統計情報

サーバが提供する各サービスの統計情報

サービス以外の処理（メイン関数など）の統計情報

このため，取得対象の指定数は，指定したサーバが提供するサービス数に2を加えたものになります。システムサーバやSUPなどのサービスを持たないサーバを指定した場合は，サーバ全体の統計情報だけを取得します。

追加する取得対象の取得項目は，次に示す方法で指定します。

rtsstatsコマンドの-eオプションに項目IDを指定して実行する方法
指定した項目IDの項目を追加します。

rtsstatsコマンドの-fオプションにリアルタイム取得項目定義ファイル名を指定して実行する方法
指定したリアルタイム取得項目定義でYをした項目をすべて追加します。

取得項目の数がリアルタイム統計情報サービス定義のrts_item_maxオペランドの指定値を超える場合，rtsstatsコマンドはKFCA32743-Eメッセージを出力して終了します。

(2)　取得項目の追加

すでにリアルタイム統計情報を取得している取得対象に対して取得項目を追加する場合は，取得対象の追加と同様に，-aオプションに追加する項目を指定してrtsstatsコマンドを実行します。

(3)　取得対象の削除

取得対象を削除する場合は，-dオプションを指定したrtsstatsコマンドを実行します。このとき，-eオプションおよび-fオプションは指定しないでください。

(4)　取得項目の削除

すでにリアルタイム統計情報を取得している取得対象に対して取得する項目の一部を削除する場合は，-dオプションに削除する項目を指定してrtsstatsコマンドを実行します。

削除する項目は，-eオプションまたは-fオプションに指定します。-eオプションを指定した場合は，指定した項目IDの項目を削除します。-fオプションを指定した場合は，指定したリアルタイム取得項目定義でYを定義した項目を残して，それ以外の項目をすべて削除します。

(5)　注意事項

rtsstatsコマンドによって取得対象および取得項目を変更できるのは，リアルタイム統計情報サービスが起動している間だけです。リアルタイム統計情報サービスを正常停止した場合，次回のリアルタイム統計情報サービスの開始時には，rtsstatsコマンドによる変更は破棄され，リアルタイム統計情報サービスのrtsput定義コマンドで指定した取得対象および取得項目が再設定されます。

-uオプションにsrvを指定したrtsstatsコマンドを実行した場合，指定したサーバが提供する各サービスの名称は，そのサーバのユーザサービス定義のserviceオペランドから取得します。このため，環境変数DCCONFPATHまたはDCUAPCONFPATHで指定したパスに，ユーザサービス定義ファイルまたはユーザサービスデフォルト定義ファイルが格納されている必要があります。
ユーザサービス定義ファイルが格納されていない場合は，rtsstatsコマンドの実行に失敗します。また，ユーザサービス定義ファイルにserviceオペランドが指定されていない場合は，サーバ単位でのリアルタイム統計情報だけを取得します。

-uオプションにsrvを指定してrtsstatsコマンドを実行したあとに，ユーザサービス定義のserviceオペランドにサービスを追加または削除した場合，追加または削除したサービスは，統計情報の取得対象に反映されません。rtsstatsコマンドを実行したあとに追加または削除したサービスを統計情報の取得対象にする場合は，rtsstatsコマンドを再実行してください。
また，rtsstatsコマンドを実行したあとに，サービス関数動的ローディング機能でサービスを追加または削除した場合も，追加または削除したサービスは，統計情報の取得対象に反映されません。rtsstatsコマンドを実行したあとに追加または削除したサービスを統計情報の取得対象にする場合は，rtsstatsコマンドを再実行してください。

4.　OpenTP1のファイルの運用

OpenTP1で使用するファイルの運用方法について説明します。

＜この章の構成＞

4.1　OpenTP1ファイルシステムの運用

4.2　ステータスファイルの運用

4.3　システムジャーナルファイルの運用

4.4　リカバリジャーナルファイルの運用

4.5　チェックポイントダンプファイルの運用

4.6　DAMファイルの運用

4.7　TAMファイルの運用

4.1　OpenTP1ファイルシステムの運用

OpenTP1ファイルシステムの運用について説明します。OpenTP1ファイルシステムの容量の見積もり式については，「付録K　OpenTP1ファイルシステムの見積もり式」を参照してください。

＜この節の構成＞

4.1.1　OpenTP1ファイルシステムの作成

4.1.2　OpenTP1ファイルシステムの状態表示

4.1.3　OpenTP1ファイルシステムの内容表示

4.1.4　OpenTP1ファイルシステムのバックアップ

4.1.5　OpenTP1ファイルシステムのリストア

4.1.6　OpenTP1ファイル所有者の変更

4.1.7　OpenTP1ファイルグループの変更

4.1.8　OpenTP1ファイルのアクセス許可モードの変更

4.1.9　OpenTP1ファイルシステムのガーベジコレクション

4.1.10　OpenTP1ファイルシステムの属性変更の手順

4.1.11　OpenTP1ファイルの再作成

4.1.1　OpenTP1ファイルシステムの作成

OpenTP1管理者は，OpenTP1ファイルシステムをfilmkfsコマンドで初期設定します。このとき，OpenTP1ファイルシステム領域として，キャラクタ型スペシャルファイル，または通常ファイルを割り当てます。初期設定は，OpenTP1ファイルシステム領域を割り当てるときに一度だけ実行します。

OpenTP1ファイルシステムをキャラクタ型スペシャルファイル上に作成する場合，パーティションの容量より大きな値を指定すると，そのパーティションに物理的に続くパーティションを破壊することがありますので注意してください。

OpenTP1ファイルシステムを通常ファイル上に作成する場合，OpenTP1ファイルシステムの容量不足が発生しないように，容量を正しく見積もってください。

4.1.2　OpenTP1ファイルシステムの状態表示

次のような場合，filstatfsコマンドでOpenTP1ファイルシステムの状態を表示できます。

初期設定時に指定したセクタ長を確認したいとき

ユーザに割り当てられた領域の総容量を知りたいとき

ユーザに割り当てられた領域の中で，未使用の領域の容量を知りたいとき

すでに作成されたファイルの数や，これから作成できるファイルの数を知りたいとき

ユーザ領域の使用中領域と未使用領域（空き領域）の詳細を確認したいとき

表示内容は，ユーザ領域総容量，作成済みファイル数，ファイルシステム初期化時刻などです。

4.1.3　OpenTP1ファイルシステムの内容表示

次のような場合，fillsコマンドでOpenTP1ファイルシステムの内容を表示できます。

OpenTP1ファイルシステム中にどのようなOpenTP1ファイルがあるか確認したいとき

OpenTP1ファイルの所有者，アクセス権，レコード長，レコード数，および最終更新日時を確認したいとき

OpenTP1ファイルのロック状態を確認したいとき

filchmod（アクセス許可モードの変更），filchown（所有者の変更）コマンドをすべてのファイル，または複数のファイルに対して実行する前に，OpenTP1ファイルの情報一覧を出力して確認したいとき

表示内容はアクセス権，所有者名，最終更新日時などです。

fillsコマンド実行時，最終更新日時が最近のものから表示したり，最終アクセス日時が最近のものから表示したりすることを，オプションで指定できます。

4.1.4　OpenTP1ファイルシステムのバックアップ

OpenTP1ファイルシステムをfilbkupコマンドでバックアップできます。OpenTP1ファイルシステムに障害が発生した場合に備えて，OpenTP1ファイルシステムを定期的にバックアップしてください。

filbkupコマンドを実行すると，レコード長，レコード数，および最終更新日時など個々のOpenTP1ファイルの属性もバックアップされます。

バックアップ用のファイルには一つのOpenTP1ファイルシステムだけがバックアップできます。複数のOpenTP1ファイルシステムをバックアップしたい場合は，バックアップしたいOpenTP1ファイルシステムごとに別のファイルを指定する必要があります。

また，OpenTP1ファイル名を指定してバックアップすることもできますが，これは主に保守情報を取得するために行います。

4.1.5　OpenTP1ファイルシステムのリストア

filbkupコマンドでバックアップした情報は，filrstrコマンドでOpenTP1ファイルシステム領域にリストアできます。

また，OpenTP1ファイル名を指定してリストアすることもできますが，これは主に保守情報を取得するために行います。

4.1.6　OpenTP1ファイル所有者の変更

OpenTP1管理者は，filchownコマンドで，OpenTP1ファイルの所有者を変更できます。

4.1.7　OpenTP1ファイルグループの変更

OpenTP1管理者は，filchgrpコマンドで，OpenTP1ファイルのグループを別グループに変更できます。

4.1.8　OpenTP1ファイルのアクセス許可モードの変更

OpenTP1管理者は，filchmodコマンドで，OpenTP1ファイルのアクセス許可モードを変更できます。

4.1.9　OpenTP1ファイルシステムのガーベジコレクション

OpenTP1ファイルの作成と削除を繰り返した場合，OpenTP1ファイルシステム中に十分な空き領域があっても，必要な連続領域が確保できないためにOpenTP1ファイルが作成できなくなることがあります。この場合，OpenTP1ファイルシステムのガーベジコレクション（OpenTP1ファイルシステム中の使用中の領域を集中させ，空き領域を連続させること）が必要になります。

OpenTP1ファイルシステムのガーベジコレクションを次の図に示します。

図4-1　OpenTP1ファイルシステムのガーベジコレクション

OpenTP1ファイルシステムのガーベジコレクションの手順を次に示します。

OpenTP1ファイルシステムをfilbkupコマンドでバックアップします。

バックアップ済みのOpenTP1ファイルシステムをfilmkfsコマンドで初期設定します。

filrstrコマンドで，バックアップファイルを初期設定済みのOpenTP1ファイルシステムにリストアします。

なお，filstatfsコマンドに-Sオプションを指定して実行すると，OpenTP1ファイルシステム内の連続領域の状況を確認できます。確認した情報を基に，必要に応じて不要なOpenTP1ファイルを削除すると，前後の空き領域が結合され，大きなサイズの連続した空き領域を確保できます。

4.1.10　OpenTP1ファイルシステムの属性変更の手順

容量や最大ファイル数などのOpenTP1ファイルシステムの属性を変更できます。

OpenTP1ファイルシステムの属性変更の手順を次に示します。

OpenTP1ファイルシステムをfilbkupコマンドでバックアップします。

セクタ長などの属性をfilmkfsコマンドで変更します。

filrstrコマンドで，バックアップファイルを初期設定済みのOpenTP1ファイルシステムにリストアします。

4.1.11　OpenTP1ファイルの再作成

OpenTP1ファイルを作成するに当たり，すでにOpenTP1ファイルが存在する場合，コマンドオプションの指定によってOpenTP1ファイルを再作成できます。

OpenTP1ファイルを再作成するために必要なコマンドとオプションの組み合わせを次の表に示します。

表4-1　OpenTP1ファイルを再作成するコマンドのオプション

OpenTP1ファイルの作成コマンド
OpenTP1ファイルの削除コマンド
再作成するオプション

filrstr
OpenTP1ファイルの種類によって次のコマンドを実行

damdel

jnlrm

mqadel

querm

stsrm

tamdel

-t，-o，-rオプションのうちのどれかを指定

mqainit
mqadel
-rオプションを指定

queinit
querm
-rオプションを指定

stsinit
stsrm
オプションを指定する必要はありません

注

ISAMファイルの作成については，マニュアル「索引順編成ファイル管理 ISAM」を参照してください。

OpenTP1ファイルを再作成するときは，OpenTP1ファイルの作成と，旧OpenTP1ファイルの削除が行われます。したがって，一時的にOpenTP1ファイルを作成するための未使用領域が必要になります。未使用領域が不足している場合，容量不足が発生しOpenTP1ファイルの再作成が失敗します。この場合，いったんOpenTP1ファイルを削除コマンドで削除したあと，OpenTP1ファイルの作成コマンドを実行してください。

4.2　ステータスファイルの運用

ステータスファイルの運用について説明します。ステータスファイルのサイズの見積もり式については，「付録H.1　ステータスファイルのサイズの見積もり式」を参照してください。

＜この節の構成＞

4.2.1　ステータスファイルの作成と定義

4.2.2　ステータスファイルの使い方

4.2.3　ステータスファイルの状態表示

4.2.4　ステータスファイルの内容表示

4.2.5　ステータスファイルのオープンとクローズ

4.2.6　ステータスファイルの削除

4.2.7　ステータスファイルの容量が不足したとき

4.2.8　ステータスファイルの状態遷移

4.2.1　ステータスファイルの作成と定義

物理ファイルの作成
OpenTP1を作成する前に，stsinitコマンドでステータスファイルをOpenTP1ファイルシステム上に作成します。A系，B系の二系統のファイルを作成します。
A系，またはB系の物理ファイルは複数のディスクに分散させて作成してください。一つのディスク上に同じ系のすべての物理ファイルを作成すると，ディスクの全面障害が発生した場合，その系は使用できません。全面回復時にはA系，B系の両方の正常なファイルが最低一つは必要です。片系のファイルだけで，OpenTP1は全面回復できません。
物理ファイルの名称には，ステータスサービス定義のステータスファイル名と同じ名称を指定します。

物理ファイルと論理ファイルの対応
作成したステータスファイルの名称と論理ファイルの名称をステータスサービス定義で指定します。論理ファイル名は，A系とB系のステータスファイルを一組にするために，ユーザが任意に付ける名称です。

また，A系，B系のステータスファイルのうち，どちらか片方の系だけしか使用できなくなったときに片系運転するかどうかを，ステータスサービス定義のsts_single_operation_switchオペランドで指定します。

ステータスサービス定義については，マニュアル「OpenTP1 システム定義」を参照してください。

4.2.2　ステータスファイルの使い方

ステータスファイルは，OpenTP1を構成する各システムサービスの稼働状態，ファイルの状態，各種装置のシステム制御情報などを記録するために使用します。

OpenTP1は，ステータスファイルをA系とB系の二重で管理し，さらに次に示す状態で管理します。

現用
現時点でシステム制御情報の出力対象になっているオープン中の状態です。ファイルの実体が必要です。

予備
現時点でシステム制御情報の出力対象にはなっていないが，現用のステータスファイルが入出力障害などで使用できなくなったときに，現用のステータスファイルと切り替えるためにオープン中の状態です。ファイルの実体が必要です。

無効
ステータスサービス定義に指定されているが，オープンしないとオンラインでは使用できないクローズ中の状態です。また，削除されて実体のない状態を，実体なしの無効ファイルといいます。OpenTP1の開始時に実体がない無効ファイルがあると，OpenTP1の開始はできません。

閉塞
オンライン中にステータスファイルに障害が発生し，閉塞している状態です。
閉塞状態になったステータスファイルは，stsrmコマンドでファイルの実体を削除し，stsinitコマンドで初期設定したあと，stsopenコマンドでオープンすると，予備の状態になります。

オンライン中のステータスファイルの状態遷移を次の図に示します。

図4-2　オンライン中のステータスファイルの状態遷移

ステータスファイルは，ステータスサービス定義でA系，B系それぞれ7組まで指定できます。OpenTP1を正常開始すると，ステータスサービス定義で最初に指定したステータスファイルが現用となり，残りのステータスファイルのうち，オープンできたものは予備となります。ただし，障害が発生してオープンできなかったものは閉塞となります。再開始すると，前回の現用ファイルが引き継がれます。

現用のステータスファイルには，A系とB系で同じ内容が書き込まれます。

OpenTP1は，A系，B系のどちらかの現用のステータスファイルに入出力障害が発生すると，もう一方の系の現用のファイルの内容をA系，B系の予備のファイルに複写し，その後，予備のファイルを現用に切り替えます。このような，現用のファイルの切り替えをスワップといいます。ユーザがstsswapコマンドでスワップすることもできます。

障害が発生してスワップしたステータスファイルは，stsrmコマンドで削除し，stsinitコマンドで初期設定したあと，stsopenコマンドでオープンすると，予備のファイルとなります。

無効のファイルがない場合，ステータスサービス定義に片系運転する（sts_single_operation_switch=continue）と指定していると，正常な系だけで処理を続行します。片系運転しない（sts_single_operation_switch=stop）と指定していると，OpenTP1は異常終了します。

なお，片系運転で処理を続行しているときに，正常な系に障害が発生したり，ステータスファイルを更新中にOpenTP1が異常終了したりすると，OpenTP1を再開始できなくなります。そのため，できるだけ早く両系運転の状態（A系，B系とも運転している状態）にしてください。両系運転の状態にするには，次の二つの方法があります。

予約ファイルをstsopenコマンドでオープンし，予備ファイルを用意します。stsswapコマンドを実行して現用ファイルをスワップします。

障害が発生して閉塞したファイルをstsrmコマンドで削除し，stsinitコマンドで初期設定したあと，stsopenコマンドでオープンします。片系運転の場合，stsopenコマンドを実行すると，障害が発生した系のファイルに正常な系のファイルの内容が複写され，現用ファイルとして回復できます。

4.2.3　ステータスファイルの状態表示

ステータスファイルの使用状況は，stslsコマンドで表示できます。

表示内容は論理ファイル状態，ファイル内のレコード使用率などです。

4.2.4　ステータスファイルの内容表示

stsfillsコマンドを実行すると，ステータスファイルの内容をオフラインで表示できます。

表示内容は，物理ファイル名，初期設定時刻，レコード長などです。

なお，stsfillsコマンドに-xオプションを指定すると，ステータスファイルを排他的にオープンして，ファイルの内容を表示します。

4.2.5　ステータスファイルのオープンとクローズ

オープンとは，ファイルの実体が現用，または予備の状態のことをいいます。クローズとは，ファイルの実体が無効，または閉塞の状態のことをいいます。

無効のステータスファイルをstsopenコマンドでオープンすると，予備になります。

ただし，現用のステータスファイルが片系運転の場合は，障害が発生して閉塞した系のファイルをstsinitコマンドで初期設定したあと，stsopenコマンドでオープンすると，現用となります。

予備のステータスファイルをstscloseコマンドでクローズすると，無効になります。

4.2.6　ステータスファイルの削除

無効，および障害が発生して閉塞状態になったステータスファイルは，stsrmコマンドで削除できます。現用と予備の状態のステータスファイルは削除できません。

4.2.7　ステータスファイルの容量が不足したとき

オンライン中にステータスファイルの容量不足が発生した場合，OpenTP1が予備ファイルの中からスワップできるファイルを選択し，自動的にスワップします。スワップできる容量の予備ファイルがない場合，OpenTP1は異常終了します。そのため，stslsコマンドで表示されるステータスファイル内のレコード使用率が高くなった場合，次の手順でステータスファイルの容量を増やしてください。

予備ファイルの一つをstscloseコマンドでクローズします。

クローズしたファイルをstsrmコマンドで削除します。

stsinitコマンドの-cオプションに現用ファイルのレコード数より大きな値を指定して，stsinitコマンドを実行します。

再作成したファイルをstsopenコマンドでオープンして予備ファイルとします。

4.2.8　ステータスファイルの状態遷移

オンライン中のステータスファイルの状態遷移表を次の表に示します。

表4-2　オンライン中のステータスファイルの状態遷移表

状態
現用
予備
無効
閉塞

ACTIVE
STANDBY
CLOSE
NONE
BLOCKADE

オープン／クローズ
オープン
クローズ

状態の番号
1
2
3
4
5

イベント
stsswap実行
→2
→1
－
－
－

stsclose実行
－
→3
－
－
－

stsopen実行
－
－
→2
－
－

出
力
障
害
A系，B系共に障害
→5
－
－
－
－

片
系
障
害
予備ファイルあり
→5
－
－
－
－

予備ファイルなし
片系
運転可
両系
運転中
－
－
－
－
－

片系
運転中
→5
－
－
－
－

片系運転不可
→5
－
－
－
－

（凡例）

－：起こり得ない，または状態が遷移しないことを示します。

→n：遷移先の状態の番号を示します。

注

すべてのイベントは正常に処理されるものとします。

ステータスサービスが動作中のときだけ，ステータスファイルの状態を管理しています。

このため，ステータスサービスが動作中に次に示すクローズ状態のファイルに対してstsinit，またはstsrmコマンドを実行しても，stslsコマンドで表示されるファイル状態は変わりません。

CLOSE

NONE

BLOCKADE

4.3　システムジャーナルファイルの運用

システムジャーナルファイルの運用について説明します。システムジャーナルファイルのサイズの見積もり式については，「付録H.2　システムジャーナルファイルのサイズの見積もり式」を参照してください。

＜この節の構成＞

4.3.1　OpenTP1のジャーナルについて

4.3.2　システムジャーナルファイルの作成と定義

4.3.3　システムジャーナルファイルの使い方

4.3.4　システムジャーナルファイルのアンロード

4.3.5　システムジャーナルファイルの再使用

4.3.6　システムジャーナルファイル情報の表示

4.3.7　システムジャーナルファイルのオープンとクローズ

4.3.8　システムジャーナルファイルのステータス変更

4.3.9　システムジャーナルファイルのスワップ

4.3.10　スワップ先のファイルグループがないとき

4.3.11　システムジャーナルファイルの状態遷移

4.3.12　システム統計情報のジャーナル出力

4.3.13　アンロードジャーナルファイルの時系列ソート，およびマージ

4.3.14　アンロードジャーナルファイルの複写

4.3.15　アンロードジャーナルファイルの編集出力

4.3.16　アンロードジャーナルファイルのレコード出力

4.3.17　稼働統計情報の出力

4.3.18　ファイル回復用ジャーナルの集積

4.3.19　ジャーナルファイルレス機能を使用する運用

4.3.1　OpenTP1のジャーナルについて

OpenTP1のジャーナルの構成について説明します。

＜この項の構成＞

(1)　レコード

(2)　ジャーナルブロック

(1)　レコード

OpenTP1のジャーナルには，OLTPレコードとジャーナルレコードがあります。

OLTPレコード

OLTPレコードは，ジャーナルを取得する場合のI/O単位で，1OLTPレコードは4096バイトです。jnlinitコマンドの-nオプションで指定するレコード数，およびjnllsコマンドに-dオプションを指定した場合に表示されるレコード数は，OLTPレコードを示します。

ジャーナルレコード

ジャーナルレコードは，ジャーナルブロックを構成するデータの単位です。システムで発生する履歴情報，統計情報などの論理的単位が一つのジャーナルレコードになります。ジャーナルレコードの最大長は，システムジャーナルサービス定義のjnl_max_datasizeオペランドに指定した値以下です。jnleditコマンドの結果で表示されるレコードはジャーナルレコードを示します。

(2)　ジャーナルブロック

ジャーナルバッファ上のデータをジャーナルファイルに出力する単位がジャーナルブロックです。一つのジャーナルバッファは，システムジャーナルサービス定義のjnl_max_datasizeオペランドに指定した大きさで確保されます。一つのジャーナルブロックは1～n個のジャーナルレコードで構成されています。ジャーナルレコードを取得した場合に，ジャーナルバッファにジャーナルレコードが書き込めなくなったり，同期点ジャーナルレコードの取得要求が発生したりするときは，その時点までのジャーナルレコードを1件のジャーナルブロックとしてジャーナルファイルに取得します。ジャーナルブロックをジャーナルファイルに書き込むと，jnllsコマンドで表示されるブロック番号が1カウント増えます。

OpenTP1のジャーナルは，1件のジャーナルブロックを出力するのにOLTPレコードを1～n個使用します。例えば，システムジャーナルサービス定義のjnl_max_datasizeオペランドに32000を指定していた場合，1～8個のOLTPレコードを使用します。最大8個になるときの計算式は，↑(32000／4096)↑です（↑↑：小数点以下切り上げ）。ジャーナルバッファにジャーナルレコードを取得できなくなった場合はOLTPレコードを8レコード分使用します。ただし，同期点ジャーナルレコードの取得の場合，その時点までのジャーナルレコードをジャーナルブロックとして取得するため，4096バイト未満のジャーナルブロックができる場合があります。この場合は，OLTPレコードは1レコード分だけ使用します。

レコードとジャーナルブロックの関係を次の図に示します。

図4-3　レコードとジャーナルブロックの関係

図4-3では，一つのジャーナルブロックは，6個のジャーナルレコードで構成され，二つのOLTPレコードを使用してジャーナルファイル内に格納されています。

OpenTP1のジャーナルファイル内の使用済み容量は，jnllsコマンドに-dオプションを付けて実行して表示されたレコード数に，OLTPレコードの4096バイトを掛けると求められます。例えば，次の図に示すようなjnllsコマンドの実行結果を得た場合，jnlgrp02の使用済みのジャーナルファイル容量は，(13)₁₆×4096バイト=77824バイトとなります。

図4-4　jnlls -j sys -dの実行結果

4.3.2　システムジャーナルファイルの作成と定義

ユーザは，OpenTP1を開始する前に，jnlinitコマンドで物理ファイルをOpenTP1ファイルシステム上に作成します。このとき，物理ファイルの名称には，システムジャーナルサービス定義の物理ファイル名と同じ名称を指定します。

物理ファイル作成後，複数の物理ファイルを管理するための論理的なファイルであるファイルグループ，およびファイルグループと要素ファイルの対応関係をシステムジャーナルサービス定義に指定します。

ファイルグループとは，OpenTP1がジャーナルを世代管理するための論理的なファイルです。オンライン中のジャーナルファイルのスワップなどは，この単位で実行されます。システムジャーナルサービス定義には，2個以上256個までのファイルグループを指定でき，ユーザはそれぞれのファイルグループに任意の名称を付けます。この名称は，システムジャーナルサービス定義内で一意になるように付けてください。

要素ファイルとは，システムジャーナルファイルの並列アクセス機能を使用する場合に，分散して使用する論理的なファイルです。オンライン中のジャーナルファイルへのアクセスは，分散された要素ファイルに並列に行われます。そのため，ディスクへの負荷を分散できます。

並列アクセス機能を使用する場合は，システムジャーナルサービス定義のjnl_max_file_dispersionオペランドに2以上を指定し，jnl_min_file_dispersionオペランドを指定します。また，一つのファイルグループには2個以上8個までの要素ファイルを指定できます。ユーザは，それぞれの要素ファイルに任意の名称を付けます。この名称はシステムジャーナルサービス定義内で一意になるように付けてください。jnl_max_file_dispersionオペランドにはファイルグループを構成する最大要素ファイル数を指定します。jnl_min_file_dispersionオペランドには要素ファイルが障害などで使用できなくなった場合に，最低限の並列アクセスを保障する要素ファイル数を指定します。

並列アクセス機能を使用しない場合，ユーザは要素ファイルを指定する必要はありません。

システムジャーナルファイルは二重化することもできます。この場合，OpenTP1を開始する前に，jnlinitコマンドでA系，B系の二系統の物理ファイルを作成します。物理ファイル作成後，システムジャーナルサービス定義でjnl_dual=Yと指定し，さらに，A系，B系の物理ファイルとファイルグループの対応関係を指定します。また，二重化したときに，片系しか使用できなくなった場合について，片系運転可とするか，片系運転不可とするかをシステムジャーナルサービス定義のjnl_singleoperationオペランドで指定します。

ジャーナルファイルをオンラインで一度使用したあとでOpenTP1の環境を変更した場合，ジャーナルファイルの再作成が必要です。ジャーナルファイルの再作成が必要となる変更を次に示します。

システム共通定義のnode_idオペランドの変更

システムジャーナルサービス定義のjnladdfg定義コマンドおよびjnladdpf定義コマンドの-gオプションで指定するファイルグループ名の変更

システムジャーナルサービス定義の定義ファイル名の変更

変更後の環境で，ジャーナルファイルを再作成しないでOpenTP1を起動しようとした場合，KFCA01240-Eメッセージが出力されます。この場合，エラーとなったジャーナルファイルは使用できません。

システムジャーナルサービス定義については，マニュアル「OpenTP1 システム定義」を参照してください。

4.3.3　システムジャーナルファイルの使い方

システムジャーナルファイルは，OpenTP1の各種履歴情報である回復用ジャーナルの取得と，UAPの任意の履歴情報であるユーザジャーナルの取得のために使用します。

要素ファイルを構成する物理ファイルのうち，一つ以上の物理ファイルがオープンされていることを要素ファイルがオープン状態，物理ファイルがまったくオープンされていないことを要素ファイルがクローズ状態といいます。

要素ファイルを構成する物理ファイルのうち，必要以上の物理ファイルがオープンされていることを要素ファイルが使用可能状態，必要以上の物理ファイルがオープンされていないことを要素ファイルが使用不可能状態といいます。要素ファイルを構成する物理ファイルの必要数は，システムジャーナルサービス定義の指定によって決まります。

jnl_dual=Nのとき：1

jnl_dual=Y，かつjnl_singleoperation=Yのとき：1

jnl_dual=Y，かつjnl_singleoperation=Nのとき：2

要素ファイルの状態と物理ファイルの状態の関係を次の表に示します。

表4-3　要素ファイルの状態と物理ファイルの状態の関係

要素ファイルの状態1 | 要素ファイルの状態2 | 物理ファイルのオープン／クローズ状態
使用可能／使用不可能状態 | オープン／クローズ状態
片系運転可 | 片系運転不可 | A系 | B系
○ | ○ | オープン | オープン | オープン
○ | × | オープン | オープン | クローズ
○ | × | オープン | クローズ | オープン
× | × | クローズ | クローズ | クローズ

（凡例）

○：使用可能

×：使用不可能

ファイルグループを構成する要素ファイルのうち，一つ以上の要素ファイルがオープンされていることをファイルグループがオープン状態，要素ファイルがまったくオープンされていないことをファイルグループがクローズ状態といいます。

また，ファイルグループを構成する要素ファイルのうち，最小分散数以上の要素ファイルがオープンされていることをファイルグループが使用可能状態，最小分散数以上の要素ファイルがオープンされていないことをファイルグループが使用不可能状態といいます。

要素ファイルの必要数は，システムジャーナルサービス定義の指定によって決まります。

並列アクセス機能を使用しない場合：1

並列アクセス機能を使用する場合：並列アクセス化する場合の最小分散数

障害の発生などによって使用可能な要素ファイル数がjnl_min_file_dispersionオペランド未満になった場合，ファイルグループをクローズします。要素ファイルで障害が発生した場合のファイルグループ，要素ファイル，物理ファイルの状態を次の表に示します。

表4-4　障害発生時と状態の関係

状態 | ファイルグループの状態 | 要素ファイルの状態 | 物理ファイルの状態
並列アクセス機能未使用 | 非二重化で障害，または二重化でA系，B系ともに障害 | クローズ | クローズ | クローズ
二重化で片系障害 | 片系運転可 | オープン | オープン
片系運転不可 | オープン（予約） | クローズ
並列アクセス機能使用 | 非二重化で障害，または二重化でA系，B系ともに障害 | クローズ | クローズ
二重化で片系障害 | 片系運転可 | 使用できる要素ファイルが最小分散数以上 | オープン | オープン
使用できる要素ファイルが最小分散数未満 | オープン | オープン
片系運転不可 | 使用できる要素ファイルが最小分散数以上 | オープン | クローズ
使用できる要素ファイルが最小分散数未満 | オープン（予約） | クローズ

OpenTP1は，オンライン中のシステムジャーナルファイルのファイルグループを次に示す三つの状態で管理します。

現用
現時点でジャーナルの出力対象になっている使用可能状態のファイルグループです。この状態のファイルグループは常に一つです。

待機
現時点でジャーナルの出力対象にはなっていないが，現用に変更するために待機している使用可能状態のファイルグループです。
この状態はさらに次の二つに分けられます。

スワップ先にできる状態
上書きできる（回復に必要なジャーナルがない）状態で，かつアンロード済み（jnlunlfgコマンドでファイルにコピーされた）状態の待機ファイルグループです。次回スワップ発生時，すぐに現用になることができます。

スワップ先にできない状態
上書きできない状態，またはアンロード待ち状態の待機ファイルグループです。次回スワップ発生時，すぐに現用になることはできません。

予約
使用不可能状態のファイルグループです。

予約以外のファイルグループは，二つ以上必要です。

OpenTP1を正常開始すると，システムジャーナルサービス定義で指定したファイルグループのうち，ONLと指定したファイルグループがすべてオープンされます。オープンされたファイルグループのうち，最初に指定したファイルグループが現用となり，その他は待機となります。オープンできなかったファイルグループ，およびONLと指定しなかったファイルグループは，予約となります。再開始すると，前回現用だったファイルグループが引き継がれます。

ジャーナルは，現用のファイルグループに出力されます。現用のファイルグループが満杯になると，システムジャーナルサービス定義で現用の次に指定したファイルグループ（待機中）にスワップします。二重化した場合，どちらか一方の系が満杯になると，スワップします。システムジャーナルファイル中のすべてのファイルグループが満杯となった場合は，最初のファイルグループに戻ってジャーナルを出力します。

ファイルグループにOpenTP1の回復に必要なジャーナルがある場合，そのファイルグループを上書きできない状態と判断して，保護します。上書きできない状態のファイルグループは，現用にできません。

上書きできないファイルグループは，OpenTP1がチェックポイントダンプを取得すると，それ以前のジャーナルは不要となるため，上書きできる状態になります。

4.3.4　システムジャーナルファイルのアンロード

満杯，障害，または運用コマンドによってスワップして待機状態となったファイルグループは，アンロード待ち状態となります。アンロード待ち状態とは，DAMファイルの回復やユーザの運用に備えて，ユーザがジャーナルをアンロードするまでジャーナルを保存している状態です。アンロード待ち状態のファイルグループは，現用にできません。

アンロード待ち状態のファイルグループは，jnlunlfgコマンドを使用するか，または自動アンロード機能を使用するかしてアンロードすると，アンロード済み状態になります。アンロード済み状態とは，アンロード待ち状態のファイルグループからjnlunlfgコマンドまたは自動アンロード機能でジャーナルをコピーした状態，またはjnlchgfgコマンドでジャーナルを破棄した状態です。

jnlunlfgコマンドまたは自動アンロード機能でアンロードして作成したファイルをアンロードジャーナルファイルといいます。

＜この項の構成＞

(1)　jnlunlfgコマンドを使用したアンロード

(2)　自動アンロード機能を使用したアンロード

(3)　アンロードチェックの抑止

(1)　jnlunlfgコマンドを使用したアンロード

ファイルグループからジャーナルが切り離された旨のメッセージ（KFCA01222-I）が出力されたら，jnlunlfgコマンドを実行してください。

なお，-fオプション指定のjnlunlfgコマンドを実行すると，ファイルグループの状態をチェックしないでアンロードするため，現用ファイルグループ，およびアンロード済みのファイルグループをアンロードできます。ただし，アンロード済みのファイルグループを-fオプション指定のjnlunlfgコマンドでアンロードする場合は，一度jnlclsfgコマンドでクローズしてからアンロードしてください。

-fオプション指定のjnlunlfgコマンドを実行しても，ファイルグループの状態は変更できません。

(2)　自動アンロード機能を使用したアンロード

自動アンロード機能を使用すると，jnlunlfgコマンドを実行しなくても，OpenTP1の稼働中に，自動的にシステムジャーナルファイルをアンロードできます。自動アンロード機能を使用するには，システムジャーナルサービス定義のjnl_unload_checkオペランドおよびjnl_auto_unloadオペランドにYを指定してください。また，アンロードジャーナルファイルを格納するディレクトリは，システムジャーナルサービス定義のjnl_auto_unload_pathオペランドに指定してください。

なお，自動アンロード機能でアンロードできるのは，システムジャーナルファイルだけです。アーカイブジャーナルファイルはアンロードできません。

(a)　アンロードの契機

自動アンロード機能でアンロードする契機は，システムジャーナルファイルが現用ファイルを解放してアンロード待ち状態になったときです。アンロード待ち状態になるのは，次の場合です。

満杯，障害，または運用コマンドによってスワップした場合

OpenTP1システムが正常終了した場合

(b)　アンロードジャーナルファイル格納ディレクトリの運用

自動アンロード機能を使用してアンロードするアンロードジャーナルファイルの格納ディレクトリは，システムジャーナルサービス定義のjnl_auto_unload_pathオペランドに指定します。格納ディレクトリには，複数のディレクトリを指定できます。

一つのディレクトリをアンロードジャーナルファイル格納ディレクトリに指定した場合

アンロード中にディスク満杯を検知した場合，作成途中のアンロードジャーナルファイルを削除し，自動アンロード機能を停止します。

アンロード中にディスク障害を検知するなど，アンロードジャーナルファイル格納ディレクトリを使用できなくなった場合，自動アンロード機能を停止します。

複数のアンロードジャーナルファイル格納ディレクトリを指定した場合

OpenTP1を起動して最初に使用するアンロードジャーナルファイル格納ディレクトリを，次の表に示します。

表4-5　最初に使用するアンロードジャーナルファイル格納ディレクトリ

OpenTP1の
開始形態
最初に使用するアンロードジャーナルファイル格納ディレクトリ

正常開始
システムジャーナルサービス定義のjnl_auto_unload_pathオペランドに指定されたディレクトリのうち，過去に自動アンロード機能を使用して作成したアンロードジャーナルファイルが格納されていない最初のディレクトリ

計画停止後の開始
前回のOpenTP1稼働時の最後に使用していたディレクトリ

再開始

アンロード中にディスク満杯を検知した場合，作成途中のアンロードジャーナルファイルを削除し，システムジャーナルサービス定義のjnl_auto_unload_pathオペランドに指定されている次のディレクトリにアンロードジャーナルファイルを作成します。システムジャーナルサービス定義のjnl_auto_unload_pathオペランドに指定されたディレクトリに，前回使用時に作成されたアンロードジャーナルファイルがある場合，さらに次のディレクトリを格納先にします。ファイルを作成するディレクトリが決定したら，同一世代のアンロードを開始します。システムジャーナルサービス定義のjnl_auto_unload_pathオペランドに指定されているすべてのディレクトリで，同一世代のアンロードができない場合，自動アンロード機能は停止します。

アンロード中にディスク障害を検知するなど，アンロードジャーナルファイル格納ディレクトリを使用できなくなった場合，システムジャーナルサービス定義のjnl_auto_unload_pathオペランドに指定されている次のディレクトリにアンロードします。ディスク障害が発生したディレクトリは，次回以降のファイル格納ディレクトリになります。

システムジャーナルサービス定義のjnl_auto_unload_pathオペランドの最終パラメタに指定したディレクトリでディスク満杯を検知すると，システムジャーナルサービス定義のjnl_auto_unload_pathオペランドの最初のパラメタに指定したディレクトリにアンロードします。格納ディレクトリには，複数のディレクトリを指定できます。

8個の格納ディレクトリを指定した場合の運用方法を次の図に示します。

図4-5　アンロードジャーナルファイル格納ディレクトリの運用

自動アンロード機能を使用したアンロード中に，すべてのジャーナルファイルが満杯になり，アンロードできない場合はKFCA01220-Eメッセージを出力し，システムを停止します。自動アンロード機能を使用したアンロード中に，ジャーナルファイルをクローズした場合は，自動アンロード機能は続行されます。

アンロードジャーナルファイル格納ディレクトリに，次の名称のファイルを格納した場合，そのファイルをOpenTP1が削除することがあるので注意してください。

（システムジャーナルサービス定義ファイル名）_bbbbbbbbbbbb_cc....cc

bbbbbbbbbbbb：12文字の任意の文字列

cc....cc：1～8文字の任意の文字列

(c)　アンロードジャーナルファイル

自動アンロード機能で生成されるアンロードジャーナルファイルは，次の名称規則でファイル名の重複を防止します。

（システムジャーナルサービス定義のファイル名）_（ジャーナルサービスのランID）（ジャーナルファイル世代番号）_（ジャーナルファイルグループ名）

ファイル名は最大28文字です。ファイル名を構成するそれぞれの値を次に示します。

システムジャーナルサービス定義のファイル名：最大8文字の文字列

ジャーナルサービスのランID：8けたの16進数

ジャーナルファイル世代番号：4けたの16進数

ジャーナルファイル世代番号が4けた未満の場合，左側に0を挿入して4けたにします。5けた以上の場合，下4けたが付与されます。

ジャーナルファイルグループ名：最大8文字の文字列

例

システムジャーナルサービス定義のファイル名：sysjnl

ジャーナルサービスのランID：40e8ca39

ジャーナルファイル世代番号：3

ジャーナルファイルグループ名：jnlfg02

アンロードジャーナルファイル名：sysjnl_40e8ca390003_jnlfg02

自動アンロード機能を実行中に，アンロードジャーナルファイル格納先として現在使用しているディレクトリ下に格納されているファイルは，操作しないでください。操作した場合，ファイルの整合性は保証できません。アンロードジャーナルファイル格納先として使用しているディレクトリは，jnlatunl -j sys -iを実行すると確認できます。

自動アンロード機能の停止中は，アンロードジャーナルファイルを移動およびコピーできます。また，自動アンロード機能を使用中でもアンロードジャーナルファイル格納先として使用されていないディレクトリ下に格納されているアンロードジャーナルファイルは，移動およびコピーできます。また，ファイル回復用ジャーナルに使用しない場合は，削除することもできます。ただし，ファイルの操作中に，該当ディレクトリがアンロードジャーナルファイル格納先になった場合，OpenTP1が生成するアンロードジャーナルファイルを操作しないように注意してください。

(d)　自動アンロード機能の再開始

OpenTP1稼働中に，自動アンロード機能が停止した場合，次の手順で再開始します。

システムジャーナルサービス定義のjnl_auto_unload_pathオペランドに指定したすべてのディレクトリから，アンロードジャーナルファイルを退避するか，または不要なアンロードジャーナルファイルを削除して，ディスクに空き領域を作成します。

jnlatunl -j sys -bを実行します。
自動アンロード機能が再開始します。

jnlatunl -j sys -iを実行します。
自動アンロード機能が動作中であることを確認します。

(3)　アンロードチェックの抑止

アンロード待ち状態のファイルグループを，アンロードしないで現用に割り当てられます。これをジャーナルアンロードチェックの抑止といいます。通常OpenTP1では，ファイルグループのアンロード状態をチェックしていて，ファイルグループがアンロード済み状態の場合だけ現用に割り当てます。アンロード状態のチェックを抑止すると，スワップ先のファイルグループがアンロード待ち状態でも，現用として割り当てるので，ファイルグループをアンロードする必要はありません。

ジャーナルアンロードチェックの抑止機能を使用する場合は，システムジャーナルサービス定義でjnl_unload_check=Nを指定します。この指定は，システム再開時に変更できます。

オンライン中にアンロードする場合は，アンロードするファイルグループをjnlclsfgコマンドでクローズしてから，アンロードを実行してください。jnlclsfgコマンドを実行しないでオンライン中のアンロードを実行すると，アンロード実行中のファイルグループが現用になることがあります。このとき，ファイルグループにはアンロード中のデータと，現用になって新たに書き込まれるデータとが混在するので，OpenTP1はアンロードを中断しますが，オンラインダウンすることはありません。

アンロードを一度も実行しない場合，アンロードジャーナルファイルを入力するコマンドは使用できません。アンロードジャーナルファイルを入力するコマンドを次の表に示します。

表4-6　アンロードジャーナルファイルを入力するコマンド一覧

機能 | コマンド
ジャーナル関係のファイル管理 | ファイル回復用ジャーナルの集積 | jnlcolc
アンロードジャーナルファイルの複写 | jnlcopy
アンロードジャーナルファイルの編集出力 | jnledit
MCF統計情報の出力 | jnlmcst
ジャーナル関係のファイル回復 | jnlmkrf
アンロードジャーナルファイルのレコード出力 | jnlrput
アンロードジャーナルファイルのマージ，時系列ソート | jnlsort
統計情報の出力 | jnlstts
DAMファイル管理 | 論理ファイルの回復 | damfrc
TAMファイル管理 | TAMファイルの回復 | tamfrc

ジャーナルアンロードチェックの抑止機能を使用する指定でも，jnllsコマンドを実行すると，ファイルグループはアンロード待ち状態が表示されます。アンロード待ち状態が表示されても，そのファイルグループは現用として割り当てられます。

4.3.5　システムジャーナルファイルの再使用

満杯，または運用コマンドによってスワップして待機状態となったファイルグループを再使用するためには，次に示す条件を両方とも満たす必要があります。条件を満たしている場合，次回スワップ時に現用として使用できます。

ファイルグループが上書きできる状態になっていること

ファイルグループがアンロード済み状態になっていること

ただし，システムジャーナルサービス定義にjnl_unload_check=N（ジャーナルアンロードチェックの抑止機能）を指定している場合は，ファイルグループの状態をチェックしないでスワップします。

オンライン中のシステムジャーナルファイルの状態遷移を次の図に示します。

図4-6　オンライン中のシステムジャーナルファイルの状態遷移

OpenTP1が強制終了または異常終了後，OpenTP1を強制正常開始し，起動処理中に前回のオンラインで現用として使用していたジャーナルファイルを現用に割り当てようとしたときに，そのファイルグループをクローズし，次のファイルグループを現用として割り当てます。

クローズされたジャーナルファイルは，jnlunlfgコマンドまたはjnlchgfgコマンドでファイルグループのステータスを変更後，jnlopnfgコマンドを実行するまで使用できません。

4.3.6　システムジャーナルファイル情報の表示

システムジャーナルファイル情報は，jnllsコマンドで表示できます。再開始中に読み込んだシステムジャーナルファイル情報は，jnlrinfコマンドで表示できます。

表示内容はファイルグループ名称，ファイル種別，ファイルグループの状態などです。

4.3.7　システムジャーナルファイルのオープンとクローズ

予約のファイルグループをjnlopnfgコマンドでオープンすると，待機のファイルグループとなります。

上書きできる状態のファイルグループをjnlclsfgコマンドでクローズすると，予約のファイルグループになります。上書きできない状態のファイルグループは，回復に必要なジャーナルがあるため，クローズできません。

なお，上書きできる状態のファイルグループが一つしかない場合，そのファイルグループはクローズできません。

システムジャーナルファイルのオープンとクローズコマンドによる状態の変化を次の図に示します。

図4-7　オープンとクローズコマンドによる状態の変化（システムジャーナルファイル）

4.3.8　システムジャーナルファイルのステータス変更

アンロード待ち状態となった待機のファイルグループを，実際にはアンロードしないで状態だけを強制的にアンロード済み状態にするには，jnlchgfgコマンドを使用します。強制的にアンロード済み状態にするとジャーナルはコピーされないので注意してください。

アンロード済み状態となったファイルグループは，上書きできる状態であれば，次回スワップ時に現用として使用できます。

4.3.9　システムジャーナルファイルのスワップ

ユーザが緊急に現用ファイルグループのアンロードや編集をしたいときは，jnlswpfgコマンドを使用すると，すぐにスワップできます。ただし，スワップ先のファイルグループがないときは，エラーとなってスワップできません。

4.3.10　スワップ先のファイルグループがないとき

OpenTP1では，ファイルグループが満杯になったりジャーナルの出力時に障害が発生したりした場合にスワップします。ユーザは，OpenTP1が必ずスワップできるように，スワップ先にできる待機のファイルグループを用意しておく必要があります。

ジャーナルファイルグループのスワップ要因が発生した場合，OpenTP1はメモリ上のステータスをチェックし，スワップ先を探します。メモリ上のファイルグループを検索した結果スワップ先が見つからなかった場合，オープン中のファイルグループのジャーナルファイル内のステータスを読み込み，ファイル内のステータスでメモリ上のステータスを更新します。その後，再度メモリ上のステータスをチェックし，スワップ先にできる待機のファイルグループを探します。それでもスワップ先にできる待機のファイルグループがないときは，OpenTP1は異常終了します。

スワップ先のファイルグループがなくてOpenTP1が異常終了した場合，jnlunlfgコマンドでファイルグループをアンロードし，障害となったファイルグループがあれば，これを対処してOpenTP1を再開始します。それでもOpenTP1を開始できない場合は，システムジャーナルサービス定義でONL指定のファイルグループを新たに指定し，OpenTP1を再開始してください。

4.3.11　システムジャーナルファイルの状態遷移

オンライン中のシステムジャーナルファイルの状態遷移を次に示します。

（凡例）

－：起こり得ない，または状態が遷移しないことを示します。

→n：遷移先の状態の番号を示します。

注1

すべてのイベントは正常に処理されるものとします。

ジャーナルサービスが動作中のときだけ，システムジャーナルファイルのファイルグループの状態を管理しています。また，クローズ中のファイルグループの状態（アンロード済み／待ち状態，上書きできる／できない状態）は管理していません。このため，クローズ中のファイルグループにjnlunlfg，またはjnlchgfgコマンドを実行しても，jnllsコマンドで表示される状態は変わりません。

なお，jnlunlfg，またはjnlchgfgコマンドを実行したあとに，jnlopnfgコマンドを実行し，jnllsコマンドを実行すると，現在のファイルの状態が表示されます。

注2

イベント「満杯スワップ」，「現用障害でスワップ」，「jnlswpfgでスワップ」の現用から状態遷移するシステムジャーナルファイルは，障害の発生したスワップ元のシステムジャーナルファイルを示します。待機から状態遷移するシステムジャーナルファイルはスワップ先のシステムジャーナルファイルを示します。

注※

-a，-b，-eオプションの指定を省略したとき。

4.3.12　システム統計情報のジャーナル出力

システム統計情報をシステムジャーナルファイルに編集出力できます。この場合，dcstatsコマンドを使用します。dcstatsコマンドを実行すると，-mオプションで指定した時間間隔で，システムジャーナルファイルに出力し続けます。編集出力情報は，-kオプションで指定した統計情報種別ごとに，それぞれの事象の発生件数，平均値，最大値，最小値を時系列に出力します。サーバ名を指定して，指定したサーバ単位に出力することもできます。

システム統計情報の出力は，dcstatsコマンドに-rオプションを指定すると終了できます。-rオプションを指定したdcstatsコマンドを実行しないと，OpenTP1が停止するまでシステム統計情報を出力し続けます。

dcstatsコマンドで指定したシステム統計情報の種別や時間間隔などを変更したい場合は，dcstats -rコマンドを実行後，dcstatsコマンドを実行し直してください。

dcstatsコマンドの指定は，OpenTP1再開始時には引き継がれません。OpenTP1再開始後にシステム統計情報を出力する場合は，再びdcstatsコマンドを実行してください。

なお，システム統計情報は，共用メモリ上から標準出力へリアルタイムに編集出力することもできます。標準出力へリアルタイムに編集出力するには，dcreportコマンドを実行してください。

システム統計情報の編集内容は，表E-2を参照してください。

4.3.13　アンロードジャーナルファイルの時系列ソート，およびマージ

マルチノード機能使用時，アンロードジャーナルファイルとグローバルアーカイブアンロードジャーナルファイルの内容をブロック単位にソート，およびマージできます。この場合，jnlsortコマンドを使用します。ノード識別子やジャーナルサーバランIDの指定によって，ユーザが必要な範囲の情報だけをソート，およびマージできます。

4.3.14　アンロードジャーナルファイルの複写

アンロードジャーナルファイルの内容をレコード単位に複写できます。この場合，jnlcopyコマンドを使用します。複写範囲を指定すると，ユーザが必要な範囲の情報だけを複写できます。

4.3.15　アンロードジャーナルファイルの編集出力

アンロードジャーナルファイルの内容をブロック単位，またはレコード単位に編集して出力できます。この場合，jnleditコマンドを使用します。編集範囲やジャーナル取得モードの指定によって，ユーザが必要な範囲の情報だけを出力できます。オプションの指定によってファイル情報一覧の出力もできます。

4.3.16　アンロードジャーナルファイルのレコード出力

アンロードジャーナルファイル内のユーザジャーナルレコードの情報，トランザクションブランチのCPU使用時間情報，またはレスポンス統計情報を編集しないでそのまま標準出力に出力できます。

この場合，jnlrputコマンドを使用します。出力範囲やジャーナル取得モードの指定によってユーザが必要な範囲の情報だけを出力できます。また，オプションの指定によって，コミット決着済みのユーザジャーナルレコードを出力できます。

jnlrputコマンドで出力できるデータを次の表に示します。

表4-7　jnlrputコマンドで出力できるデータ

データ
概要

ファイル管理情報（128バイト）
該当する出力結果がレコード出力処理結果のデータであることを示す情報です。
出力結果全体の状態や内容を示します。

レコード情報
レコード管理情報（128バイト）
レコード情報の先頭であることを示す情報です。
該当するレコード情報全体の状態や内容を示します。

レコードデータ
レコードデータヘッダ
（128バイト）
ジャーナルレコードの固定レコードデータを示します。
固定レコードデータがない場合は予備領域とします。

第2レコードデータヘッダ
（128バイト）
ジャーナルレコードの第2固定レコードデータを示します。
固定レコードデータがない場合は出力しません。

レコードデータ（可変長）
ジャーナルレコードの浮動レコードデータを示します。
浮動レコードデータがない場合は出力しません。

4.3.17　稼働統計情報の出力

アンロードジャーナルファイルから稼働統計情報を収集し，編集して出力できます。

この場合，jnlsttsコマンド，またはjnlmcstコマンドを使用します。

jnlsttsコマンドで編集出力できる稼働統計情報は，システム統計情報，トランザクション統計情報，レスポンス統計情報，および通信遅延時間統計情報です。

jnlmcstコマンドで編集出力できる稼働統計情報は，MCF稼働統計情報です。

また，次のコマンドを使用すると，アンロードジャーナルファイルを使用しないで稼働統計情報を出力できます。

dcreportコマンド
共用メモリ上に取得したシステム統計情報を，標準出力へリアルタイムに編集出力できます。

mcfstatsコマンドおよびmcfreportコマンド
MHPおよびTP1/Message ControlのMCF稼働統計情報を共用メモリに取得し，UNIXファイルに出力した統計情報を，編集して出力できます。

＜この項の構成＞

(1)　jnlsttsコマンドで編集できる稼働統計情報

(2)　jnlmcstコマンドで取得できる稼働統計情報

(3)　dcreportで取得できる稼働統計情報

(4)　mcfstats，mcfreportで取得できる稼働統計情報

(1)　jnlsttsコマンドで編集できる稼働統計情報

(a)　システム統計情報

jnlsttsコマンドの-eオプション（編集項目）にsysを指定します。jnlsttsコマンドを実行すると，収集したシステム統計情報が時系列に編集出力されます。編集範囲を指定すると，ユーザが必要な範囲の情報だけを編集出力できます。

編集内容は，システムジャーナルファイルに出力できるシステム統計情報の編集内容と同じですので，表E-2を参照してください。

(b)　トランザクション統計情報

jnlsttsコマンドの-eオプション（編集項目）にtrnを指定します。jnlsttsコマンドを実行すると，トランザクションブランチ起動元ユーザサーバ名単位，またはトランザクションブランチ起動元ユーザサーバのサービス名単位に，収集したトランザクション統計情報が時系列に編集出力されます。編集範囲を指定すると，ユーザが必要な範囲の情報だけを編集出力できます。

なお，トランザクション統計情報を取得するためには，あらかじめ，ユーザサービス定義でtrn_statistics_itemオペランドでnothing以外を指定しておく必要があります。

トランザクション統計情報の編集内容を次の表に示します。

表4-8　トランザクション統計情報の編集内容

編集内容 | 単位
項目 | 発生件数 | 編集値
平均 | 最大 | 最小
ブランチ実行時間（同期点処理時間を含む） | × | ○ | ○ | ○ | マイクロ秒
ブランチ同期点処理実行時間 | × | ○ | ○ | ○ | マイクロ秒
ブランチ本体決着方法 | ○ | × | × | × | 件数
子ブランチ含む決着方法 | ○ | × | × | × | 件数
ブランチ決着プロセス種別 | ○ | × | × | × | 件数

（凡例）

○：編集できます。

×：編集できません。

(c)　レスポンス統計情報

jnlsttsコマンドの-eオプション（編集項目）にrspを指定します。jnlsttsコマンドを実行すると，サービス名単位に，収集したレスポンス統計情報が時系列に編集出力されます。編集範囲を指定すると，ユーザが必要な範囲の情報だけを編集出力できます。

なお，レスポンス統計情報を取得するためには，あらかじめ，ユーザサービス定義でrpc_response_statistics=Yと指定しておく必要があります。

表4-9に示す項目のうち，RPC種別，レスポンスタイムを取得したい場合は，クライアント側（dc_rpc_callの呼び出し元）UAPのユーザサービス定義のrpc_response_statisticsオペランドでYを指定してください。指定していない場合，この二つの情報は取得されないで，jnlsttsコマンドの編集結果には0データが出力されます。

サービス実行時間，サービス待ち時間については，クライアント側，サーバ側のどちらのユーザサービス定義のrpc_response_statisticsオペランドでYを指定しても情報は取得されます。

レスポンス統計情報の編集内容を次の表に示します。

表4-9　レスポンス統計情報の編集内容

編集内容 | 単位
項目 | 発生件数 | 編集値
平均 | 最大 | 最小
RPC種別 | ○ | × | × | × | 件数
レスポンスタイム | ○ | ○ | ○ | ○ | マイクロ秒
サービス実行時間 | ○ | ○ | ○ | ○ | マイクロ秒
サービス待ち時間 | ○ | ○ | ○ | ○ | マイクロ秒

（凡例）

○：編集できます。

×：編集できません。

(d)　通信遅延時間統計情報

jnlsttsコマンドの-eオプション（編集項目）にdlyを指定します。jnlsttsコマンドを実行すると，送信先のノード識別子単位に，収集した通信遅延時間統計情報が時系列に編集出力されます。編集範囲を指定すると，ユーザが必要な範囲の情報だけを編集出力できます。

通信遅延時間統計情報の編集内容を次の表に示します。

表4-10　通信遅延時間統計情報の編集内容

編集内容 | 単位
項目 | 発生件数 | 編集値
平均 | 最大 | 最小
通信遅延時間 | ○ | ○ | ○ | ○ | マイクロ秒

（凡例）

○：編集できます。

(2)　jnlmcstコマンドで取得できる稼働統計情報

jnlmcstコマンドを使用して，MCF稼働統計情報のメッセージ受信系，および送信系の情報を編集出力できます。

論理端末名称ごと，またはアプリケーション名ごとに編集出力できます。どちらの場合も編集範囲やジャーナル取得モードの指定によって，ユーザが必要な範囲の情報だけを出力できます。

なお，jnlmcstコマンドは，MCFの取得する統計ジャーナル（IJ，GJ，OJ，AJ）からMCF稼働統計情報を編集出力します。したがって，MCF稼働統計情報を編集出力する場合は，あらかじめ次の定義を指定してください。

システム定義
MCFアプリケーション属性定義のmcfaalcap（アプリケーション属性定義）でIJ，GJ，OJを取得する指定をします。

各プロトコルの定義
論理端末定義でAJを取得する指定をします。

jnlmcstコマンドで編集するMCF稼働統計情報の編集内容を次の表に示します。

表4-11　MCF稼働統計情報の編集内容（jnlmcstコマンド）

統計情報種別
編集内容
単位

事象
出力形式
編集値

最小
最大
平均
合計

メッセージ受信系情報
問い合わせメッセージ入力数
0～4294967295​，
または＊
○
○
○
○
件数

一方受信メッセージ入力数
0～4294967295​，
または＊
○
○
○
○
件数

受信要求発行数
0～4294967295​，
または＊
○
○
○
○
回数

受信メッセージサイズ
0～4294967295​，
＊，または－
○
○
○
×
バイト

メッセージ送信系情報
優先分岐送信要求発行数
0～4294967295​，
または＊
○
○
○
○
回数

一般分岐送信要求発行数
0～4294967295​，
または＊
○
○
○
○
回数

応答送信要求発行数
0～4294967295​，
または＊
○
○
○
○
回数

出力数（セグメント）
0～4294967295​，
または＊
○
○
○
○
件数

（凡例）

○：編集できます。

×：編集できません。

(3)　dcreportで取得できる稼働統計情報

dcreportコマンドを使用すると，共用メモリ上に取得したシステム統計情報を，標準出力へリアルタイムに編集出力できます。

このコマンドで編集出力できるシステム稼働統計情報の詳細，および編集内容については，表E-1および表E-2を参照してください。なお，このコマンドでシステム稼働統計情報を編集出力する場合，あらかじめシステム共通定義でset statistics=Yを指定しておく必要があります。

(4)　mcfstats，mcfreportで取得できる稼働統計情報

mcfstatsコマンドを使用してMCF稼働統計情報を取得し，mcfreportでMCF稼働統計情報を編集出力できます。

これらのコマンドで取得・編集出力できるMCF稼働統計情報の種別を，次の表に示します。なお，これらのコマンドでMCF稼働統計情報を取得・編集出力する場合，あらかじめMCFマネジャ定義でmcfmcomn -w "stats=yes"を指定しておく必要があります。

表4-12　MCF稼働統計情報の種別

種別
内容
主な用途

受信メッセージ情報
（サービスグループ単位）
メッセージ処理回数
メッセージ処理待ち数・時間・合計値・最大値・最小値
サービスグループ関連チューニング用

送信メッセージ情報
（論理端末単位）
論理端末関連チューニング用

コネクション処理待ち情報（通信サーバ単位）
最大処理多重度チューニング用（mcfttred -m）

稼働統計情報の出力開始および出力終了の契機は次のとおりです。

開始
mcfstatsコマンドでMCF稼働統計情報のファイル出力を開始できます。
mcfstatsコマンドを実行すると，-sオプションで指定した時間間隔で，-tオプションで指定した回数ファイルに出力します。-tオプションを省略した場合は，終了契機まで出力し続けます。

終了

指定した回数分ファイル出力を行うと，MCF稼働統計情報のファイル出力を終了します。

mcfstatsコマンドに-rオプションを指定すると，MCF稼働統計情報のファイル出力を終了できます。

MCFの正常・計画・強制・異常終了時にMCF稼働統計情報のファイル出力を終了します。MCF再開始時にはmcfstatsコマンドの情報は引き継がれていません。MCF再開始後にMCF稼働統計のファイル出力をする場合には，再度mcfstatsコマンドを実行してください。

出力したMCF稼働統計の情報が，mcfstatsコマンドの-fオプションで指定した出力ファイルサイズを超えた場合，MCF稼働統計情報のファイル出力を終了します。

mcfreportコマンドで編集するMCF稼働統計情報の編集内容を次の表に示します。

表4-13　MCF稼働統計情報の編集内容（mcfreportコマンド）

編集内容 | 単位
編集種別 | 取得値 | 発生件数 | 編集値
平均 | 最大 | 最小
受信メッセージ情報 | スケジュール待ち行列数 | ○ | ○ | ○ | ○ | 要求数
スケジュール待ち時間 | × | ○ | ○ | ○ | 秒
送信メッセージ情報 | スケジュール待ち行列数 | ○ | ○ | ○ | ○ | 要求数
スケジュール待ち時間 | × | ○ | ○ | ○ | 秒
コネクション処理待ち情報 | スケジュール待ち行列数 | ○ | ○ | ○ | ○ | 要求数
スケジュール待ち時間 | × | ○ | ○ | ○ | 秒

（凡例）

○：編集できます。

×：編集できません。

4.3.18　ファイル回復用ジャーナルの集積

DAMファイル，TAMファイル，またはISAMファイルを回復するために必要なジャーナルレコードを，アンロードジャーナルファイルから抽出できます。この場合，jnlcolcコマンドを使用します。jnlcolcコマンドを実行して作成したファイルを集積ジャーナルファイルといいます。DAMファイル，TAMファイル，またはISAMファイル回復時に，集積ジャーナルファイルを使用すると，ファイルの回復処理に掛かる時間を短縮できます。

4.3.19　ジャーナルファイルレス機能を使用する運用

ジャーナルファイルレス機能とは，システムジャーナルファイル（OpenTP1の各種履歴情報である回復用ジャーナル，UAPの任意の履歴情報であるユーザジャーナル，および統計用ジャーナル）を取得しない機能です。

OpenTP1では，システムを回復したり各種の稼働状況を検知したりするために，システムジャーナルファイルを取得しています。しかし，次に示すようなシステムでは，システムジャーナルファイルの取得は必須ではありません。

システムジャーナルファイルの取得が必須ではないシステムの例

TP1/EEでトランザクションを制御するシステム

ジャーナルサービスによるシステム回復が不要なシステム

トランザクション制御を行わないネームサービス機能用のノードを使用するシステム

このようなシステムを運用する場合，ジャーナルファイルレス機能を使用し，システムジャーナルファイルを取得しないようにすることで，リソース管理の負荷を軽減できます。

ジャーナルファイルレス機能は，システム共通定義のjnl_fileless_optionオペランドにYを指定することで使用できるようになります。ジャーナルファイルレス機能を使用した環境を，ジャーナルファイルレスモードといいます。

ジャーナルファイルレスモードでは，一部の機能が使用できません。ジャーナルファイルレスモードで使用できない機能を次の表に示します。

表4-14　ジャーナルファイルレスモードで使用できない機能

分類 | ジャーナルファイルレスモードで使用できない機能
機能 | トランザクション機能※1
XAリソースサービスによるトランザクション機能
DAM，TAM，MCF，MQなどOpenTP1提供のリソースマネジャ機能
各種統計情報
グローバルアーカイブジャーナル機能
自動アンロード機能
ライブラリ関数 | dc_jnl_ujput関数
dc_trn_begin関数
dc_trn_unchained_commit関数
dc_trn_chained_commit関数
dc_trn_unchained_rollback関数
dc_trn_chained_rollback関数
dc_trn_info関数
tx_begin関数
tx_close関数
tx_commit関数
tx_info関数
tx_open関数
tx_rollback関数
tx_set_commit_return関数
tx_set_transaction_control関数
tx_set_transaction_timeout関数
運用コマンド | jnllsコマンド
jnlunlfgコマンド
jnlchgfgコマンド
jnlopnfgコマンド
jnlclsfgコマンド
jnlswpfgコマンド
jnlrinfコマンド
jnldelpfコマンド
jnladdpfコマンド
jnlardisコマンド
jnlarlsコマンド
jnlatunlコマンド
jnlmkrfコマンド
dcdefchkコマンド（ジャーナルサービス定義，システムジャーナルサービス定義，チェックポイントダンプサービス定義の論理チェック）
その他 | OpenTP1の再開始（リラン）によるシステムの回復
ユーザサービス定義のatomic_updateオペランド※2

注※1

XAインタフェースによるリソースマネジャへのアクセスも使用できないため，trnlnkrmコマンドでOpenTP1にリソースマネジャを登録しないでください。リソースマネジャが登録されたOpenTP1をジャーナルファイルレスモードで起動すると，トランザクションリソースマネジャ監視サービスの起動処理でエラーとなり，OpenTP1が異常終了します。

注※2

トランザクション機能が使用できないため，ユーザサービス定義のatomic_updateオペランドは，指定値に関係なく，Ｎが指定されたものとして動作します。

また，ジャーナルファイルレスモードでは，一部のOpenTP1ファイルと定義ファイルを使用しません。ジャーナルファイルレスモードで使用しないファイルを次の表に示します。

表4-15　ジャーナルファイルレスモードで使用しないファイル

ファイルの種類 | ジャーナルファイルレスモードで使用しないファイル
OpenTP1ファイル | システムジャーナルファイル
チェックポイントダンプファイル
定義ファイル | ジャーナルサービス定義ファイル
システムジャーナルサービス定義ファイル
チェックポイントダンプサービス定義ファイル

4.4　リカバリジャーナルファイルの運用

＜この節の構成＞

4.4.1　トランザクションリカバリジャーナルファイルの運用

4.4.2　サーバリカバリジャーナルファイルの運用

4.4.1　トランザクションリカバリジャーナルファイルの運用

＜この項の構成＞

(1)　トランザクションリカバリジャーナルファイルの回復

(1)　トランザクションリカバリジャーナルファイルの回復

OpenTP1の再開始中にトランザクションリカバリジャーナルファイルに障害が発生し，トランザクションを回復できなくなった場合，jnlmkrfコマンドを使用します。jnlmkrfコマンドを実行すると，アンロードジャーナルファイルを使用してトランザクションリカバリジャーナルファイルを回復できます。

4.4.2　サーバリカバリジャーナルファイルの運用

＜この項の構成＞

(1)　サーバリカバリジャーナルファイルの回復

(1)　サーバリカバリジャーナルファイルの回復

OpenTP1の再開始中にサーバリカバリジャーナルファイルに障害が発生し，サービスを回復できなくなった場合，jnlmkrfコマンドを使用します。jnlmkrfコマンドを実行すると，アンロードジャーナルファイルを使用してサーバリカバリジャーナルファイルを回復できます。

4.5　チェックポイントダンプファイルの運用

チェックポイントダンプファイルの運用について説明します。チェックポイントダンプファイルのサイズの見積もり式については，「付録H.3　チェックポイントダンプファイルのサイズの見積もり式」を参照してください。

＜この節の構成＞

4.5.1　チェックポイントダンプファイルの作成と定義

4.5.2　チェックポイントダンプファイルの使い方

4.5.3　チェックポイントダンプファイルの削除

4.5.4　チェックポイントダンプファイルの自動オープン

4.5.5　チェックポイントダンプの取得先がないとき

4.5.6　チェックポイントダンプファイル情報の表示

4.5.7　チェックポイントダンプファイルのオープンとクローズ

4.5.8　チェックポイントダンプファイルの二重化

4.5.9　チェックポイントダンプファイルの状態遷移

4.5.10　チェックポイントダンプ取得契機のスキップ回数の監視

4.5.1　チェックポイントダンプファイルの作成と定義

チェックポイントダンプファイルは，複数（2～30）のファイルグループで構成されます。ファイルグループは，論理ファイルです。通常は，一つのファイルグループは，一つの物理ファイルと対応しますが，一つのファイルグループに二つの物理ファイルを割り当てる二重化もできます。

＜この項の構成＞

(1)　作成方法

(2)　二重化する場合

(1)　作成方法

物理ファイルの初期設定
OpenTP1を開始する前に，OpenTP1ファイルシステム上にチェックポイントダンプファイルの物理ファイルを作成します。jnlinitコマンドを使用します。

物理ファイルと論理ファイル（ファイルグループ）の対応
作成した物理ファイルをファイルグループと対応させます。チェックポイントダンプサービス定義のjnladdpf定義コマンドで指定します。

(2)　二重化する場合

チェックポイントダンプファイルを二重化すると，全面回復時に障害が発生して一つの系（A系）のファイルからの回復に失敗しても，残るもう一つの系（B系）のファイルを使用して全面回復できます。

物理ファイルの初期設定
OpenTP1を開始する前に，A系，B系になる二つの物理ファイルを作成してください。jnlinitコマンドを使用し，OpenTP1ファイルシステム上に作成します。
A系，またはB系の物理ファイルは複数のディスクに分散させて作成してください。片系運転不可の運用では，一つのディスク上に同じ系のすべての物理ファイルを作成すると，ディスクの全面障害が発生した場合にその系は使用できなくなり，OpenTP1は使用できるファイルグループがないとしてシステムダウンします。

定義方法
チェックポイントダンプサービス定義のjnl_dual=Yを必ず指定してください。作成したA系，B系の物理ファイルとファイルグループの対応は，jnladdpf定義コマンドで指定します。
二重化の場合，障害時に備えて片系運転ができます。片系運転可，片系運転不可の指定は，チェックポイントダンプサービス定義のjnl_singleoperationオペランドで指定します。
チェックポイントダンプサービス定義については，マニュアル「OpenTP1 システム定義」を参照してください。

4.5.2　チェックポイントダンプファイルの使い方

チェックポイントダンプファイルは，OpenTP1の回復に必要なテーブル情報を取得するために使用します。

OpenTP1は障害に備えて，複数のチェックポイントダンプファイルに，ラウンドロビン方式でチェックポイントダンプを取得します。そのうち，最新世代のチェックポイントダンプがOpenTP1の全面回復時に必要となります。全面回復時には，最新世代のチェックポイントダンプの取得からOpenTP1停止までの間に取得した，回復用のすべてのジャーナルも必要です。

最新世代のチェックポイントダンプが読み込めない場合，その直前に取得したチェックポイントダンプを使用します。そのチェックポイントダンプファイルも使用できない場合，さらに一つ前のチェックポイントダンプファイルを使用します。このようにして順にさかのぼって，使用できる世代のチェックポイントダンプファイルを使用します。このとき，読み込む世代のチェックポイントダンプの取得以降に取得した回復用のすべてのジャーナルが必要です。必要なジャーナルが上書きされたために失われている場合には，回復できません。現状では有効保証世代は2世代です。最新のチェックポイントダンプ以降に取得したジャーナルが保証されます。

チェックポイントダンプファイルの使用順序を次の図に示します。

図4-8　チェックポイントダンプファイルの使用順序

OpenTP1は，各サーバのチェックポイントダンプを次に示すタイミングで取得します。

各サーバの開始，再開始処理が完了したとき。

システムジャーナルファイルがスワップしたとき。

前回のチェックポイントダンプを取得してから，システムジャーナルサービス定義で指定した件数のジャーナルを取得したとき。

各サーバの終了準備処理が完了したとき。

OpenTP1は，オンライン中のチェックポイントダンプファイルのファイルグループを，次に示す状態で管理します。

上書きできる，または書き込み中の状態
OpenTP1の全面回復時に使用するチェックポイントダンプを含まないので上書きできる状態，またはチェックポイントダンプを取得中の状態です。

上書きできない状態
OpenTP1の全面回復時に使用するチェックポイントダンプを含んでいるために，上書きを抑止している状態です。

予約
オープンしないとオンラインで使用できないクローズ中の状態です。

OpenTP1を開始すると，チェックポイントダンプサービス定義で指定したファイルグループのうち，ONLと指定したファイルグループがすべてオープンされます。オープンされたファイルグループは，上書きできるファイルグループとなります。オープンできなかったファイルグループ，およびONLと指定しなかったファイルグループは，予約となります。

なお，チェックポイントダンプサービス定義でファイルグループだけ定義して，対応する物理ファイルを定義していない（定義コマンドjnladdfgだけ指定し，定義コマンドjnladdpfを指定していない）チェックポイントダンプファイルに対して，オンライン中に物理ファイルを割り当てることができます。この場合jnladdpfコマンドを使用します。jnladdpfコマンドを実行すると，オンライン中に，新しい物理ファイルをファイルグループに割り当てます。割り当てられたファイルは，予約となります。オンラインで使用できる状態にするためには，jnlopnfgコマンドでオープンしてください。

チェックポイントダンプの取得が発生すると，上書きできるファイルグループの中から出力先を選んで，書き込み中のファイルグループとします。

チェックポイントダンプの取得が完了すると，書き込み中であったファイルグループを上書きできないファイルグループとし，上書きできないファイルグループの中で最も古いファイルグループを，上書きできるファイルグループとします。

OpenTP1開始時，予約以外のファイルグループは有効保証世代数より1個以上多く必要です。ただし，チェックポイントダンプサービス定義で縮退運転オプションに縮退機能を使用すると指定（jnl_reduced_modeに1，または2を指定）した場合，予約以外のファイルグループは有効保証世代数より2個以上多く必要です。

上書きできるファイルグループがない場合は，メッセージログファイルにエラーメッセージが出力され，OpenTP1は異常終了します。

4.5.3　チェックポイントダンプファイルの削除

オンライン中に，チェックポイントダンプファイルのファイルグループから物理ファイルを削除できます。この場合，jnldelpfコマンドを使用します。jnldelpfコマンドを実行すると，jnladdpfコマンドでオンライン中に割り当てた物理ファイルのうち，オープンされていない物理ファイルまたは閉塞状態の物理ファイルを削除できます。

4.5.4　チェックポイントダンプファイルの自動オープン

オンライン中にチェックポイントダンプファイルが不足した場合，自動的に予約のファイルグループをオープンして上書きできる状態にできます。この場合，チェックポイントダンプサービス定義でjnl_reserved_file_auto_open=Yと指定しておきます。

チェックポイントダンプファイルの自動オープンは，ファイル数が有効保証世代数にまで減った場合に実行されます。ただし，一度でもオープンされたファイル（オープンに失敗したファイルを含む）は，自動オープンの対象になりません。

4.5.5　チェックポイントダンプの取得先がないとき

オンライン中にチェックポイントダンプの取得が完了し，次回の取得先として使用できるファイルグループがない場合，OpenTP1はメッセージログファイルにエラーメッセージを出力します。この場合，予約のファイルグループをjnlopnfgコマンドでオープンし，上書きできるファイルグループにしてください。

取得先として使用できるファイルグループがないまま，次のチェックポイントダンプ取得が発生した場合，OpenTP1は異常終了します。

4.5.6　チェックポイントダンプファイル情報の表示

チェックポイントダンプファイル情報は，jnllsコマンドで表示できます。

表示内容はサーバ名，ファイルグループ名，対応するジャーナルファイルの情報などです。

4.5.7　チェックポイントダンプファイルのオープンとクローズ

予約のファイルグループをjnlopnfgコマンドでオープンすると，上書きできる状態になります。

上書きできる状態のファイルグループをjnlclsfgコマンドでクローズすると，予約の状態になります。

チェックポイントダンプファイルのオープンとクローズコマンドによる状態の変化を次の図に示します。

図4-9　オープンとクローズコマンドによる状態の変化（チェックポイントダンプファイル）

4.5.8　チェックポイントダンプファイルの二重化

チェックポイントダンプファイルを二重化すると，チェックポイントダンプ取得時にA系，およびB系のファイルに同じダンプ情報を取得します。そのため，OpenTP1全面回復時にA系ファイルからの回復に失敗しても，B系ファイルを使用して回復できるので，チェックポイントダンプファイルの世代戻りを回避できます。

チェックポイントダンプファイルを二重化する場合，片系だけの運転ができる運用（片系運転可）と，片系だけの運転をしない運用（片系運転不可）の二つの運用方法があります。

片系運転可の運用では，二つの物理ファイルのうちのどちらかが，オープン状態であれば，そのファイルグループは使用できます。したがって，チェックポイントダンプの取得時，A系，またはB系のどちらかに障害が発生した場合でも，正常な系へのチェックポイントダンプの取得は続行します。正常な系へのチェックポイントダンプの取得が終わると，そのファイルグループは有効なファイルグループとなります。

片系運転不可の運用では，両方の物理ファイルがオープン状態の場合だけそのファイルグループは使用できます。どちらかの物理ファイルがオープンできない場合，そのファイルグループは予約状態になり，使用できません。ただし，A系からの読み込み時に障害が発生した場合は，B系から読み込みます。読み込み完了後，そのファイルグループは予約状態になります。

片系運転可と片系運転不可の障害時のファイルグループの状態の相違を次の表に示します。

表4-16　片系運転可と片系運転不可の障害時のファイルグループの状態の相違

障害内容
片系運転可
片系運転不可

全面回復時のオープン障害
片系障害
正常な系がオープンされ処理は続行します。
上書きできる状態の場合，正常な系がオープンされます（上書きできない状態になると，そのファイルグループは予約状態になります）。
上書きできない状態の場合，ファイルグループは予約状態になります。

両系障害
ファイルグループは予約状態になります。
ファイルグループは予約状態になります。

チェックポイントダンプ取得中の障害（書き込み中）
片系障害
正常な系に取得します。
ファイルグループは予約状態になり，ほかのファイルグループに取得します。

両系障害
ファイルグループは予約状態になり，ほかのファイルグループに取得します。
両系障害は起こりません。片系障害発生した時点で，障害を対策してください。

チェックポイントダンプ読み込み中の障害
A系障害
B系から読み込みます。
B系から読み込み，完了後にファイルグループは予約状態になります。ただし，上書きできない状態の場合は，上書きできる状態に遷移するときにそのファイルグループを予約状態にします。

B系障害
ファイルグループは予約状態になり，一つ前の世代から読み込みます。
ファイルグループは予約状態になり，一つ前の世代から読み込みます。

片系運転可，片系運転不可の運用方法では，どちらかの系だけの，オンライン中の割り当て，切り離し，オープン，クローズにも違いがあります。

片系だけのオンライン操作の相違を次の表に示します。

表4-17　片系だけのオンライン操作の相違

操作内容
片系運転可
片系運転不可

片系だけのオンライン中の割り当て
できます。
できます。

片系だけのオンラインからの切り離し
できます。
ただし，切り離した状態ではそのファイルグループは使用できません。
できます。
ただし，切り離した状態ではそのファイルグループは使用できません。

片系だけのオープン
両系が割り当てられている場合は，できます。
できません。

片系だけのクローズ
上書きできる状態の場合は，できます。
上書きできない状態の場合は，できません。
できません。

4.5.9　チェックポイントダンプファイルの状態遷移

オンライン中のチェックポイントダンプファイルの状態遷移表を表4-18に示します。

また，二重化した場合で片系運転可のオンライン中のチェックポイントダンプファイルの状態遷移表を表4-19に，片系運転不可のオンライン中のチェックポイントダンプファイルの状態遷移表を表4-20に示します。

表4-18　オンライン中のチェックポイントダンプファイルの状態遷移表

状態 | 上書きできる | 書き込み中 | 上書きできない | 予約
オープン／クローズ | オープン | クローズ
状態の番号 | 1 | 2 | 3 | 4
イベント | チェックポイントダンプ取得タイミング | →2 | － | － | －
チェックポイントダンプ有効化 | － | →3 | →1※ | －
出力障害 | － | →4 | － | －
jnlclsfg実行 | →4 | － | － | －
jnlopnfg実行 | － | － | － | →1

（凡例）

－：起こり得ない，または状態が遷移しないことを示します。

→n：遷移先の状態の番号を示します。

注

すべてのイベントは正常に処理されるものとします。

注※

上書きできないファイルのうち，いちばん古いファイルの状態遷移です。

表4-19　片系運転可のオンライン中のチェックポイントダンプファイルの状態遷移表

状態
上書きできる
書き込み中
上書きできない
予約

オープン／クローズ
A系
オープン
オープン
クローズ
オープン
オープン
クローズ
オープン
オープン
クローズ
クローズ

B系
クローズ
オープン
クローズ
オープン
クローズ
オープン

状態の番号
1
2
3
4
5
6
7
8
9
10

イベント
チェックポイントダンプ取得タイミング
→4
→5
→6
－
－
－
－
－
－
－

チェックポイントダンプ有効化
－
－
－
→7
→8
→9
→
1※
→
2※
→
3※
－

A系出力障害
－
－
－
→6
→10
－
－
－
－
－

B系出力障害
－
－
－
→5
－
→10
－
－
－
－

jnlclsfgコマンドの実行
-abオプション
→10
→10
→10
－
－
－
－
－
－
－

-aオプション
→3
→10
－
－
－
－
－
－
－
－

-bオプション
→2
－
→10
－
－
－
－
－
－
－

jnlopnfgコマンドの実行
-abオプション
－
→1
→1
－
－
－
－
→7
→7
→1

-aオプション
－
－
→1
－
－
－
－
－
→7
→2

-bオプション
－
→1
－
－
－
－
－
→7
－
→3

（凡例）

－：起こり得ない，または状態が遷移しないことを示します。

→n：遷移先の状態の番号を示します。

注

すべてのイベントは正常に処理されるものとします。

注※

上書きできないファイルのうち，いちばん古いファイルの状態遷移です。

表4-20　片系運転不可のオンライン中のチェックポイントダンプファイルの状態遷移表

状態 | 上書きできる | 書き込み中 | 上書きできない | 予約
オープン／クローズ | A系 | オープン | クローズ
B系 | オープン | クローズ
状態の番号 | 1 | 2 | 3 | 4
イベント | チェックポイントダンプ取得タイミング | →2 | － | － | －
チェックポイントダンプ有効化 | － | →3 | →1※ | －
A系出力障害 | － | →4 | － | －
B系出力障害 | － | →4 | － | －
jnlclsfgコマンドの実行 | -abオプション | →4 | － | － | －
-aオプション | － | － | － | －
-bオプション | － | － | － | －
jnlopnfgコマンドの実行 | -abオプション | － | － | － | →1
-aオプション | － | － | － | －
-bオプション | － | － | － | －

（凡例）

－：起こり得ない，または状態が遷移しないことを示します。

→n：遷移先の状態の番号を示します。

注

すべてのイベントは正常に処理されるものとします。

注※

上書きできないファイルのうち，いちばん古いファイルの状態遷移です。

4.5.10　チェックポイントダンプ取得契機のスキップ回数の監視

UAPの無限ループなどが発生すると，チェックポイントダンプの取得処理が連続してできない（チェックポイントダンプ取得契機がスキップされる）ことがあります。チェックポイントダンプが取得できないままオンライン処理を続行すると，回復に必要なシステムジャーナルファイルが多くなり，最終的には使用できるシステムジャーナルファイルが不足して，システムダウンすることがあります。

チェックポイントダンプ取得契機のスキップ回数を監視することで，このようなシステムダウンを防止できます。これによって，チェックポイントダンプ取得契機のスキップが一定の回数に達した場合に，スキップ要因となっているトランザクションの情報をKFCA32550-Iメッセージで表示し，トランザクションの実行プロセスを強制的に停止して，トランザクションを決着（コミットまたはロールバック）します。

ここでは，チェックポイントダンプ取得契機のスキップ回数を監視するために必要な定義などについて説明します。

＜この項の構成＞

(1)　必要な定義

(2)　トランザクションを決着できない場合

(3)　スキップ回数の上限値の見積もり式と算出例

(1)　必要な定義

チェックポイントダンプサービス定義に次のオペランドを指定します。

jnl_cdskip_limitオペランド

jnl_cdskip_msgオペランド

jnl_cdskip_limitオペランドでは，スキップ回数の上限値を指定します。このオペランドに指定したスキップ回数に達した場合は，スキップ要因となっているトランザクションの情報が表示され，トランザクションの実行プロセスが強制停止されます。その後，チェックポイントダンプの取得が完了するまで，スキップが発生するごとに，この処理は繰り返し実行されます。スキップ回数は，チェックポイントダンプの取得完了時に0が設定されます。

jnl_cdskip_msgオペランドでは，スキップ発生時にスキップ要因のトランザクションの情報を表示するかどうかを指定します。

これらのオペランドは，トランザクションサービス用のチェックポイントダンプサービス定義（jnl_objservernameオペランドに_tjlを指定）にだけ指定できます。オペランドの詳細については，マニュアル「OpenTP1 システム定義」を参照してください。

(2)　トランザクションを決着できない場合

スキップ回数を監視してトランザクション実行プロセスを強制停止しても，次に示す場合はトランザクションの決着ができないことがあります。

ブランチ拡張先のトランザクションブランチからの応答がない場合

リソースマネジャからの応答がない，またはエラーの場合

(3)　スキップ回数の上限値の見積もり式と算出例

ここでは，jnl_cdskip_limitオペランドに指定するスキップ回数の上限値の見積もり式と算出例について説明します。

(a)　見積もり式

チェックポイントダンプ取得契機のスキップ回数の上限値は，次の見積もり式を目安に指定します。

↓（a×b÷c）×d↓

（凡例）

a：システムジャーナルサービス定義に指定した，ONL指定のjnladdfg定義コマンドの数

b：システムジャーナルファイルの総ブロック数

総ブロック数は，次の計算式で求められます。

↓システムジャーナルファイルのサイズ÷システムジャーナルサービス定義のjnl_max_datasizeオペランドの指定値↓

システムジャーナルファイルのサイズが異なる場合は，全システムジャーナルファイルの平均サイズを求めて計算してください。

c：システムジャーナルサービス定義のjnl_cdintervalオペランドの指定値

d：チェックポイントダンプ取得契機のスキップを許容する割合（余裕値）

有効保証世代数が1の場合：0.333以下を指定

有効保証世代数が2の場合：0.167以下を指定

↓↓：小数点以下を切り捨てます。

(b)　算出例

ここでは，次の条件を満たす算出例について説明します。（　）内の番号は，以降に示す図中の番号と対応しています。

ファイルグループ：3世代（すべて同じサイズ）……（1）
計算式中のaに該当します。図中のJNL1～JNL3が該当します。

システムジャーナルファイルのサイズ：65メガバイト（68157440バイト）……（2）
計算式中のbを求めるための値です。

システムジャーナルサービス定義のjnl_max_datasizeオペランド：32000バイト
計算式中のbを求めるための値です。

システムジャーナルサービス定義のjnl_cdintervalオペランド：1000ブロック……（3）
計算式中のcに該当します。

有効保証世代数：1
計算式中のdを求めるための値です。この例では，dが0.333となります。

計算式中のbから，システムジャーナルファイルの総ブロック数は，↓68157440÷32000↓＝2129になります。この値と，ONL指定のjnladdfg定義コマンドの数3，jnl_cdintervalオペランドの指定値1000，およびチェックポイントダンプ取得契機のスキップを許容する割合0.333を用いると，次のように計算式が成り立ちます。

↓（3×2129÷1000）×0.333↓＝2

つまり，jnl_cdskip_limitオペランドに指定するスキップ回数の上限値は2になります。

以降，この計算式の考え方について説明します。

計算式（↓（a×b÷c）×d↓）の考え方

ここでは，次の図に示す例で，スキップ回数の上限値の見積もり式の考え方を説明します。

図4-10　スキップ回数の上限値の考え方の例

計算式中の「（a×b÷c）」について説明します。

この例ではファイルグループが3世代であるため，全体では，2129×3＝6387ブロックとなります。jnl_cdintervalオペランドの指定値が1000ブロックであるため，6387÷1000＝6.387となり，システムジャーナルファイルのファイルグループ「JNL1」から「JNL3」の最終ブロックに出力するまで，最低6回のチェックポイントダンプ取得契機が発生します。

処理中のトランザクションの情報が取得される場所によって，チェックポイントダンプ取得契機のスキップ回数は変動します。スキップ回数は，ファイルグループ「JNL1」の最終ブロック（図中のチェックポイントダンプ取得契機2）で取得された場合は最低4回（図中のチェックポイントダンプ取得契機3～6），最初のブロック（図中のチェックポイントダンプ取得契機1）で取得された場合は最低5回（図中のチェックポイントダンプ取得契機2～6）となります。このため，4回目や5回目のスキップ発生時にシステムジャーナルファイルのファイルグループとしてスワップ先がなくなり，システムがダウンします。つまり，システムダウンを回避するためには，スキップ回数の上限を3回以下にする必要があります。

なお，システムジャーナルファイルのファイルグループは，チェックポイントダンプの取得によってファイルグループ内の情報が不要になり，アンロードが実施されるとスワップできる状態となります。

計算式中の「（a×b÷c）」の算出結果に，チェックポイントダンプ取得契機のスキップを許容する割合（この場合は0.333）を乗じると，スキップ回数の上限値（この場合は2）が決定します。

4.6　DAMファイルの運用

DAMファイルの運用について説明します。DAMファイルのサイズの見積もり式については，「付録H.5　DAMファイルのサイズの見積もり式」を参照してください。

＜この節の構成＞

4.6.1　DAMファイルの作成

4.6.2　DAMファイルの状態管理

4.6.3　DAMファイルの状態表示

4.6.4　DAMファイルの追加と削除

4.6.5　論理ファイルの論理閉塞と閉塞解除

4.6.6　DAMファイルのバックアップとリストア

4.6.7　DAMファイルの回復

4.6.8　DAMファイルの排他

4.6.9　オンライン中にDAMファイルを追加する手順

4.6.10　DAMファイルのキャッシュブロック数の設定

4.6.11　DAMファイルのブロック長の拡張

4.6.12　DAMファイルのユーザデータの抽出

4.6.1　DAMファイルの作成

ユーザは，OpenTP1ファイルシステムを作成したあと，damloadコマンドを使用して，DAMファイルを作成します。このとき，OpenTP1ファイルシステムのアクセス権はユーザ用としてください。また，物理ファイルの名称はDAMサービス定義の物理ファイル名と同じ名称を指定してください。damloadコマンドを実行すると，物理ファイルの割り当て，物理ファイルへの初期データの出力を行います。オンライン中のDAMファイルへのアクセスは，物理ファイルではなく，物理ファイルに対応する論理ファイルに対して行います。論理ファイルと物理ファイルの対応関係は，DAMサービス定義で指定します。論理ファイルは物理ファイルのアクセス権を引き継ぎません。

DAMサービス定義については，マニュアル「OpenTP1 システム定義」を参照してください。

DAMファイルは，UAPから作成することもできます。詳細は，マニュアル「OpenTP1 プログラム作成の手引」を参照してください。

4.6.2　DAMファイルの状態管理

オンライン中のDAMファイルは，次の三つの状態で管理されます。

使用中
DAMファイルをアクセス中の状態です。

論理閉塞
damholdコマンドで論理ファイルを論理閉塞した状態です。

障害閉塞
ディスク障害などが発生してDAMファイルを閉塞した状態です。

4.6.3　DAMファイルの状態表示

DAMファイルの状態は，fills，およびdamlsコマンドで表示します。

＜この項の構成＞

(1)　fillsコマンドによる状態表示

(2)　damlsコマンドによる状態表示

(1)　fillsコマンドによる状態表示

fillsコマンドに物理ファイル名を指定して実行すると物理ファイルの状態を表示します。

表示内容は，所有者名，レコード長，最終更新日時などです。アクセス権限も表示されますが，物理ファイルのアクセス権限は無効です。書き込み権限がなく，読み込み権限だけのファイルに対してもUAPからアクセスし，書き込むことができます。

(2)　damlsコマンドによる状態表示

damlsコマンドを実行すると，論理ファイルの状態を表示します。

表示内容は論理ファイル名，ファイルの閉塞状態，ブロック長などです。

4.6.4　DAMファイルの追加と削除

オンライン中に論理ファイルを追加するには，damaddコマンドを使用します。この追加とは，すでにある物理ファイルを論理ファイルとして定義することです。ユーザは，damaddコマンドを実行する前に，物理ファイルを作成しておく必要があります。

ディファード更新機能を使用する場合は，damaddコマンドに-dオプションを指定します。-dオプションを指定すると，指定した論理ファイルをディファード更新指定のファイルとして追加できます。

また，回復対象外のファイルとして追加登録したい場合は，-nオプションを指定します。さらに，キャッシュレスアクセス方式を指定したい場合は，-fオプションも同時に指定します。

論理ファイルをオンラインから切り離すにはdamrmコマンドを，物理ファイルを削除するにはdamdelコマンドを使用します。オンラインで使用している物理ファイルを削除する場合，対応する論理ファイルをdamrmコマンドでオンラインから切り離したあと，damdelコマンドを実行してください。

また，オンラインで使用中（オープン中）のDAMファイルは，damrmコマンドでオンラインから切り離すことはできません。オンラインから切り離すには，該当する論理ファイルをオープンしているすべてのサービスで，論理ファイルをクローズする必要があります。

4.6.5　論理ファイルの論理閉塞と閉塞解除

オンラインに登録したDAMファイルのアクセスを禁止するには，damholdコマンドで論理ファイルを論理閉塞します。

また，オンライン中にDAMファイルをメンテナンスするためには，オンラインからDAMファイルを切り離す必要があります。オンラインからDAMファイルを切り離すには，damhold，damrmの順でコマンドを入力してください。

damholdコマンドで論理閉塞したDAMファイルをオンラインでアクセスできるようにするには，damrlesコマンドを使用します。また，障害回復後にオンラインに復帰したDAMファイルをアクセスできるようにするときにも，damrlesコマンドを使用します。

なお，DAMサービスは，damholdコマンドを受け付けた時点で，指定されたファイルのアクセスを禁止状態にします。ディファード更新指定のファイルを論理閉塞する場合，そのファイルに対応するバッファ領域のブロックがディスクに出力されるまで論理閉塞待ち状態となり，論理閉塞されません。そのため，バッファ領域のブロックがディスクに出力されるまで，論理ファイルは削除できません。damrmコマンドを実行してもコマンドエラーとなります。

4.6.6　DAMファイルのバックアップとリストア

＜この項の構成＞

(1)　DAMファイルのバックアップ

(2)　バックアップの出力先

(3)　DAMファイルのリストア

(1)　DAMファイルのバックアップ

DAMファイルをバックアップするにはdambkupコマンドを使用します。

バックアップは，オフラインでも，オンライン中でも実行できます。オンライン中にバックアップすることをオンラインバックアップといいます。

オフラインでバックアップする手順を次に示します。

damholdコマンドを実行して論理ファイルを論理閉塞します。

damrmコマンドを実行して，論理閉塞した論理ファイルをオンラインから切り離します。

-oオプションを指定しないdambkupコマンドを実行してDAMファイルをバックアップします。

オンラインバックアップは，dambkupコマンドに-oオプションを指定して実行します。オンラインバックアップの場合，DAMファイルの論理閉塞（damholdコマンドの実行）やオンラインからの切り離し（damrmコマンドの実行）の必要はありません。

なお，オンラインバックアップしたファイルを使用してDAMファイルを回復すると，回復時に使用するアンロードジャーナルファイルの量が少なくて済みます。そのため，-oオプションを指定しないでバックアップしたファイルを使用してDAMファイルを回復する場合と比べて，DAMファイルの回復処理に必要な時間が少なくて済みます。

ユーザは，業務を開始する前に，必ずDAMファイルをバックアップしてください。

(2)　バックアップの出力先

バックアップの出力先には，ファイルまたは標準出力を指定できます。ファイルに出力する場合は，dambkupコマンドでファイル名を指定します。標準出力に出力する場合は，dambkupコマンドで-sオプションを指定します。

(3)　DAMファイルのリストア

バックアップしたファイルをリストアするにはdamrstrコマンドを使用します。

リストアの入力元には，ファイルまたは標準入力を指定できます。ファイルからバックアップを入力する場合はdamrstrコマンドにファイル名を指定します。標準入力からバックアップを入力する場合は，damrstrコマンドに-sオプションを指定します。

4.6.7　DAMファイルの回復

DAMファイルの回復をDAM FRCといいます。

DAM FRCは，damfrcコマンドで実行します。damfrcコマンドを実行すると，DAMファイルのバックアップと，指定したアンロードジャーナルファイル，または集積ジャーナルファイルを使用して，DAMサービス定義で指定された論理ファイルを障害が発生した直前の状態にまで回復します。ただし，damfrcコマンドは回復対象ファイルに対してだけ実行できます。回復対象外ファイルに対してdamfrcコマンドを実行しても，ファイルは回復できません。

damfrcコマンドを実行すると，DAM FRCで使用する引き継ぎファイルをOpenTP1が作成します。引き継ぎファイルは，各アンロードジャーナルの処理が完了するごとに，カレントディレクトリ上にjnlcolc***（***はキー），またはjnlcolc***.bak（一時的なバックアップファイル）というファイル名で作成されます。引き継ぎファイルはDAM FRCを複数回に分けて実行するときに使用されます。引き継ぎファイルには，引き継がなければならないジャーナル情報が取得されます。OpenTP1は，-eオプション指定時のDAM FRC完了後，引き継ぎファイルを削除します。

なお，DAM FRC実行の手順については，「10.2.6　DAMファイル」を参照してください。

＜この項の構成＞

(1)　DAM FRCを1回で実行するとき

(2)　DAM FRCを複数回に分けて実行するとき

(3)　複数のDAM FRCを同時に実行するとき

(4)　途中の世代のシステムジャーナルファイルを使用してDAM FRCを実行するとき

(5)　集積ジャーナルファイルを使用してDAM FRCを実行するとき

(1)　DAM FRCを1回で実行するとき

一度でDAM FRCが完了する場合は，damfrcコマンドに-s，-eオプションを両方とも指定します。-sオプションを指定すると，前回のDAM FRCを引き継ぎません。

(2)　DAM FRCを複数回に分けて実行するとき

複数のアンロードジャーナルファイルがある場合，DAM FRCを複数回に分けて実行できます。この場合，最初に実行するdamfrcコマンドには-sオプションを，最後に実行するdamfrcには-eオプションを指定します。

(3)　複数のDAM FRCを同時に実行するとき

複数のDAM FRCを同時に実行するときには，引き継ぎファイルを個別に作成する必要があります。この場合，damfrcコマンドに-kオプションを指定します。-kオプションで別のキーを指定すると，別の引き継ぎファイルが作成されます。最後に実行するdamfrcコマンドには-eオプションを指定してください。

(4)　途中の世代のシステムジャーナルファイルを使用してDAM FRCを実行するとき

オンライン中にDAMファイルをバックアップした場合，その時点の世代以降のシステムジャーナルファイルを使用してDAM FRCを実行できます。この場合，damfrcコマンドに-gオプションを指定します。

(5)　集積ジャーナルファイルを使用してDAM FRCを実行するとき

jnlcolcコマンドで作成済みの集積ジャーナルファイルを使用してDAM FRCを実行すると，DAM FRCの処理時間を短縮できます。この場合，damfrcコマンドに-cオプションを指定します。

4.6.8　DAMファイルの排他

ブロック排他の場合は，次に示す形式を資源名称として排他されます。

　論理ファイル名＋ハイフン（－）＋（相対ブロック番号＋1（16進数））

ファイル排他の場合は，次に示す形式を資源名称として排他されます。

　論理ファイル名（8文字）＋スペース（△）

論理ファイル名が8文字に満たない場合は，8文字になるようにDAMサービスがスペースを挿入します。したがって，ファイル排他の場合，資源名の長さは必ず9文字になります。

ファイル排他とブロック排他の例を次に示します。

論理ファイル dam1 の相対ブロック番号30にブロック排他した場合
排他資源名＝"dam1－1f"

論理ファイル dam1 をファイル排他した場合
排他資源名＝"dam1△△△△△"

4.6.9　オンライン中にDAMファイルを追加する手順

オンライン中にDAMファイルを追加する手順を次に示します。

物理ファイルをdamloadコマンドで作成します。

damaddコマンドで，1.で作成した物理ファイルを論理ファイルと対応付けます。このとき，DAMサービス定義に指定していない論理ファイルを指定してください。

4.6.10　DAMファイルのキャッシュブロック数の設定

DAMサービスでは，一度読み込んだDAMファイルのブロックデータをDAMサービス専用の共用メモリにためておき，同じブロックに参照要求があったときにメモリ上のデータを利用することでファイルに対するI/O回数を削減します。共用メモリ内では各DAMファイルごとにブロックデータをチェイン管理しています。このブロックデータを格納する領域をキャッシュブロックといいます。

damchdefコマンドを使用すると，一つのDAMファイルで管理するキャッシュブロック数の上限（しきい値）を設定できます。しきい値を設定すると，未使用状態のキャッシュブロックが再利用されるためメモリ資源を有効に使用できます。

キャッシュブロック数のしきい値を決定するときの運用例を次に示します。

damchinfコマンドを実行して，キャッシュブロック情報を取得します。damchinfコマンドの実行結果の例を，次に示します。

UAPのアクセス形態によるしきい値に指定する値を考察します。

以降，damfile1にほとんどアクセスしない業務の場合
damfile0，damfile2に割り当てられるキャッシュブロック領域は約20%しかありません。damfile1には，以降ほとんどアクセスしないことから，damfile1のキャッシュブロックチェインにつながっている7,900個分のキャッシュブロック用領域は確保されたままになります。そこで，damfile1のしきい値に小さい値を指定することで，確保されたままのキャッシュブロック用領域を小さくし，damfile0，damfile2に割り当てるキャッシュブロック領域を大きくできます。また，damfile1のキャッシュブロックチェインにキャッシュブロックが多数つながっているため，キャッシュブロック用領域が不足するとクリーンアップ処理が実行されます。この場合，クリーンアップ対象が"1"となっていることから，damfile1のキャッシュブロックチェインがクリーンアップ対象となります。そのため，7,900個のキャッシュブロック解放処理が実行されることから，急激な性能劣化が予想されます。この現象を抑止するためにも，damfile1にしきい値を指定することが有効です。

damfile1に頻繁にアクセスする業務の場合
damfile1に頻繁にアクセスするということは，damfile1のキャッシュブロックチェインの検索処理が頻繁に実行されることになります。この場合，しきい値を指定することで，キャッシュブロックチェインを短くでき，その結果チェイン検索時間が短縮します。ただし，しきい値が小さ過ぎる場合，キャッシュ効率が悪化するため，かえって性能劣化となります。しきい値を変更しながら最適な値を決定してください。

すべてのDAMファイルにまんべんなくアクセスする業務の場合
すべてのDAMファイルにまんべんなくアクセスするため，各DAMファイルに割り当てられるキャッシュブロック用領域は平均化していることが望まれます。各DAMファイルのしきい値に同等な値を設定すると各DAMファイルが使用するキャッシュブロック用領域が平均化されます。

4.6.11　DAMファイルのブロック長の拡張

DAMファイルのブロック長を拡張するにはdambkupコマンドでバックアップしたあと，damrstrコマンドでリストア先物理ファイルのブロック長を指定します。ブロック長の拡張には，ブロック構成を維持する方式とブロック構成を維持しない方式があります。ブロック構成を維持する方式は，バックアップ元DAMファイルのブロック構成をリストア先DAMファイルでも維持します。ブロック構成を維持しない方式は，バックアップ元DAMファイルのデータをリストア先DAMファイルの先頭ブロックから詰めて格納します。ブロック構成を維持する場合は，damrstrコマンドに-eオプションと拡張後のブロック長を指定します。ブロック構成を維持しない場合は，damrstrコマンドに-pオプションと拡張後のブロック長を指定します。なお，オンラインバックアップしたファイルのブロック長は拡張できません。また，damfrcコマンドに指定する回復対象定義ファイルに，ブロック長を拡張したDAMファイルを指定することはできません。

4.6.12　DAMファイルのユーザデータの抽出

DAMファイルの管理情報を除いたユーザデータだけを抽出するには，dambkupコマンドに-dオプションを指定します。抽出したユーザデータはdamrstrコマンドでリストアできません。

4.7　TAMファイルの運用

TAMファイルの運用について説明します。TAMファイルのサイズの見積もり式については，「付録H.6　TAMファイルのサイズの見積もり式」を参照してください。

＜この節の構成＞

4.7.1　TAMファイルの作成

4.7.2　TAMテーブルの状態管理

4.7.3　TAMテーブルの状態表示

4.7.4　TAMテーブルの追加と切り離し

4.7.5　TAMテーブルの論理閉塞と閉塞解除

4.7.6　TAMテーブルのロードとアンロード

4.7.7　TAMファイルのバックアップとリストア

4.7.8　TAMファイルからのTAMデータファイルの作成

4.7.9　TAMファイルの削除

4.7.10　TAMファイルの回復

4.7.11　TAMファイルの排他

4.7.12　オンライン中にTAMファイルを追加する手順

4.7.13　TAMファイル作成後のシノニム情報の表示

4.7.14　TAMファイルのレコード数の拡張

4.7.1　TAMファイルの作成

ユーザは，OpenTP1ファイルシステムを作成したあと，tamcreコマンドを使用してTAMファイルを作成します。このとき，OpenTP1ファイルシステムのアクセス権はユーザ用としてください。また，TAMファイル名は，TAMサービス定義の物理ファイル名と同じ名称を指定してください。作成したTAMファイルとTAMテーブルの対応関係は，TAMサービス定義で指定します。

TAMサービス定義については，マニュアル「OpenTP1 システム定義」を参照してください。

tamcreコマンド実行時，TAMファイルの作成と同時に初期データをTAMファイルに格納できます。そのためには，tamcreコマンド実行前に，TAMデータファイル（TAMファイルの初期データを格納するファイル）を作成し，初期データを格納しておく必要があります。なお，tamcreコマンドで-sオプションを指定するかどうかで，TAMファイルのデータ部のレコード形式が異なります。

TAMデータファイルの形式と-sオプションを指定しない場合のTAMファイルのデータ部のレコード形式との関係，および-sオプションを指定した場合のTAMファイルのデータ部のレコード形式との関係を以降の図に示します。

図4-11　TAMデータファイルの形式とTAMファイルのデータ部のレコード形式との関係（-sオプション指定なし）

図4-12　TAMデータファイルの形式とTAMファイルのデータ部のレコード形式との関係（-sオプション指定あり）

4.7.2　TAMテーブルの状態管理

オンライン中のTAMテーブルは，次の三つの状態で管理されます。

論理閉塞
tamholdコマンドでTAMテーブルを論理閉塞した状態です。

障害閉塞
ディスク障害などが発生してTAMテーブルを閉塞した状態です。

未閉塞
オンラインでアクセスできる状態です。

4.7.3　TAMテーブルの状態表示

TAMテーブルの状態はtamlsコマンドで表示できます。

表示内容はTAMテーブル名，使用中レコード数などです。

4.7.4　TAMテーブルの追加と切り離し

オンラインにTAMテーブルを追加するには，tamaddコマンドを使用します。追加したTAMテーブルのローディング契機，アクセス形態はtamaddコマンドのオプションに従います。追加完了後，tamrlesコマンドで閉塞を解除すると，TAMテーブルをオンラインでアクセスできるようになります。

また，tamaddコマンドに-iオプションを指定した場合のTAMテーブルは，I/O障害処理続行型テーブルとなります。この場合，TAMファイルの更新時に入出力エラーが発生しても，該当するTAMファイルは障害閉塞状態になりません。そのため，同一オンラインのUAPからは，アクセスを続行できます。ただし，オンライン再開始時には，TAMファイルの状態に不整合が生じるのを防ぐ必要があります。そのため，前回のオンラインで障害が発生したままのTAMテーブル（I/O障害処理続行型テーブル）は，オンライン再開始時，オンラインから切り離されます。オンライン再開始後，TAMファイルを回復して，再びオンラインへ追加登録してください。

長いレコードの一部分だけ更新するような場合，更新した部分だけのジャーナルを取得すると，ジャーナル量を削減できます。TAMテーブルを追加するときにtamaddコマンドで-jオプションを指定します。

TAMテーブルをオンラインから切り離すには，tamrmコマンドを使用します。オンラインから一度切り離したTAMテーブルを同じTAMテーブル名で再び追加する場合，ファイル属性（レコード長，キー長など）が同じであれば追加できます。

4.7.5　TAMテーブルの論理閉塞と閉塞解除

オンラインに登録したTAMテーブルのアクセスを禁止するには，tamholdコマンドで論理閉塞します。

論理閉塞したTAMテーブルをオンラインでアクセスできるようにするには，tamrlesコマンドで閉塞解除します。また，障害回復後，tamaddコマンドでオンラインに追加したTAMテーブルをアクセスできるようにする場合も，tamrlesコマンドを使用します。

4.7.6　TAMテーブルのロードとアンロード

TAMテーブルをメモリ上にロードする契機は，TAMサービス定義のローディング契機の指定によって決まります。

startを指定した場合：TAMサービス開始時にロード

cmdを指定した場合：tamloadコマンド実行時にロード

libを指定した場合：TAMテーブルオープン時にロード

ローディング契機がcmdのTAMテーブルは，tamunloadコマンドでアンロードできます。

4.7.7　TAMファイルのバックアップとリストア

＜この項の構成＞

(1)　TAMファイルのバックアップ

(2)　バックアップの出力先

(3)　TAMファイルのリストア

(1)　TAMファイルのバックアップ

TAMファイルをバックアップするにはtambkupコマンドを使用します。

バックアップは，オフラインでも，オンライン中でも実行できます。オンライン中に実行バックアップすることをオンラインバックアップといいます。

オフラインでバックアップする手順を次に示します。

tamholdコマンドを実行してTAMテーブルを論理閉塞します。

tamrmコマンドを実行して，論理閉塞したTAMテーブルをオンラインから切り離します。

-oオプションを指定しないtambkupコマンドを実行して，TAMファイルをバックアップします。

オンラインバックアップは，tambkupコマンドに-oオプションを指定して実行します。オンラインバックアップの場合，TAMテーブルの論理閉塞（tamholdコマンドの実行）やオンラインからの切り離し（tamrmコマンドの実行）の必要はありません。

なお，オンラインバックアップしたファイルを使用してTAMファイルを回復すると，回復時に使用するアンロードジャーナルファイルの量が少なくて済みます。そのため，-oオプションを指定しないでバックアップしたファイルを使用してTAMファイルを回復する場合と比べて，TAMファイルの回復処理に必要な時間が少なくて済みます。

ユーザは，業務を開始する前に，必ずTAMファイルをバックアップしてください。

(2)　バックアップの出力先

バックアップの出力先には，ファイルまたは標準出力を指定できます。ファイルに出力する場合は，tambkupコマンドにファイル名を指定します。標準出力に出力する場合は，tambkupコマンドに-sオプションを指定します。

(3)　TAMファイルのリストア

バックアップしたファイルをリストアするにはtamrstrコマンドを使用します。

リストアの入力元には，ファイルまたは標準入力を指定できます。ファイルからバックアップを入力する場合はtamrstrコマンドにファイル名を指定します。標準入力からバックアップを入力する場合は，tamrstrコマンドに-sオプションを指定します。

4.7.8　TAMファイルからのTAMデータファイルの作成

オンライン終了後，またはオンラインからTAMテーブルを切り離したあとに，オンラインでアクセスしたTAMファイルからTAMデータファイルを作成できます。この場合，-dオプションを指定したtambkupコマンドを実行します。-dオプションを指定したtambkupコマンドを実行すると，TAMファイル内の有効レコードから，TAMデータファイルが作成されます。作成されるTAMデータファイルには，キー値を基に昇順にソートされたデータが格納されます。ユーザは，オフラインでTAMデータファイルの内容を更新できます。更新後，tamcreコマンドを実行すると，オフライン中に更新した内容が反映されたTAMファイルを作成できます。

4.7.9　TAMファイルの削除

TAMファイルを削除するには，tamdelコマンドを使用します。オンラインで使用しているTAMファイルを削除する場合，対応するTAMテーブルをtamrmコマンドでオンラインから切り離したあと，tamdelコマンドを実行してください。

4.7.10　TAMファイルの回復

TAMファイルの回復をTAM FRCといいます。

TAM FRCは，tamfrcコマンドで実行します。tamfrcコマンドを実行すると，TAMファイルのバックアップと，指定したアンロードジャーナルファイル，または集積ジャーナルファイルを使用して，障害が発生した直前の状態にまでTAMファイルを回復します。

tamfrcコマンドを実行すると，TAM FRCで使用する引き継ぎファイルをOpenTP1が作成します。引き継ぎファイルは，TAM FRCを複数回に分けて実行するときに使用されます。引き継ぎファイルには，引き継がなければならないジャーナル情報が取得されます。OpenTP1は，-eオプション指定時のTAM FRC完了後，引き継ぎファイルを削除します。

tamfrcコマンドで-fオプションを指定すると，複数のTAMファイルを回復できます。テキストエディタで回復対象定義ファイルを作成してください。回復対象定義ファイルに複数のTAMファイルを指定します。tamfrcコマンド実行時に-fオプションと作成した回復対象定義ファイルを指定します。

TAM FRC実行の手順については，「10.2.7　TAMファイル」を参照してください。

＜この項の構成＞

(1)　TAM FRCを1回で実行するとき

(2)　TAM FRCを複数回に分けて実行するとき

(3)　集積ジャーナルファイルを使用してTAM FRCを実行するとき

(1)　TAM FRCを1回で実行するとき

一度でTAM FRCが完了する場合は，tamfrcコマンドに-s，-eオプションを両方とも指定します。-sオプションを指定すると，前回のTAM FRCを引き継ぎません。

(2)　TAM FRCを複数回に分けて実行するとき

複数のアンロードジャーナルファイルがある場合，TAM FRCを複数回に分けて実行できます。この場合，最初に実行するtamfrcコマンドには-sオプションを，最後に実行するtamfrcコマンドには-eオプションを指定します。

(3)　集積ジャーナルファイルを使用してTAM FRCを実行するとき

jnlcolcコマンドで作成済みの集積ジャーナルファイルを使用してTAM FRCを実行すると，TAM FRCの処理時間を短縮できます。この場合，tamfrcコマンドに-jオプションを指定します。

4.7.11　TAMファイルの排他

レコード排他の場合，レコード識別子（'R'）＋TAMテーブル番号（10進数5けた）＋レコード番号（10進数10けた）を資源名称として排他されます。

テーブル排他の場合，テーブル識別子（'T'）＋TAMテーブル番号（10進数5けた）を資源名称として排他されます。

レコード資源名称およびテーブル資源名称の形式を次に示します。

レコード資源名称:Raaaaabbbbbbbbbb (16けた)
テーブル資源名称:Taaaaa           (6けた)

R：レコード識別子

T：テーブル識別子

aaaaa：テーブル番号(5けた)

bb....bb：レコード番号(10けた)

また，デッドロック情報ファイル，タイムアウト情報ファイル，またはlcklsコマンドで表示されたTAM排他資源の内容を明確にするには，tamlcklsコマンドに資源名称を指定します。

4.7.12　オンライン中にTAMファイルを追加する手順

オンライン中にTAMファイルを追加する手順を次に示します。

TAMファイルをtamcreコマンドで作成します。

tamaddコマンドで，1.で作成したTAMファイルをTAMテーブルと対応付けます。このとき，TAMサービス定義に指定していないTAMテーブルを指定してください。なお，TAMサービス定義に指定してあるTAMテーブルでも，tamrmコマンドでオンラインから切り離されていれば指定できます。

4.7.13　TAMファイル作成後のシノニム情報の表示

tamcreコマンドで作成したハッシュ形式のTAMファイルについて，シノニムがどの程度発生しているかを表示するには，tamhslsコマンドを使用します。

4.7.14　TAMファイルのレコード数の拡張

TAMファイルのレコード数を拡張する場合は，いったん，tambkupコマンドの-dオプションでユーザデータだけをバックアップしたあと，tamcreコマンドでレコード数を拡張した新規ファイルを作成してください。その後，tamcreコマンドの-dオプションでバックアップしたデータをTAMファイルに割り当ててください。

tamcreコマンドでレコード数を拡張した新規ファイルを作成したあと，tamrstrコマンドでリストアしても，バックアップファイルの制御情報が上書きされるためにレコード数は拡張されませんので注意してください。

5.　メッセージの送受信の運用

メッセージの送受信について説明します。この章で説明するコネクションが，ユーザの使用するプロトコルで何に相当するかは，各プロトコルのマニュアルを参照してください。

また，OpenTP1のメッセージ制御機能を使う場合，次に示すプログラムプロダクトが前提となります。

・TP1/Message Control（メッセージ制御機能の管理）

・TP1/NET/Library（ネットワークの制御）

・TP1/NET/各プロトコル名（通信プロトコル別のインタフェースの制御）

＜この章の構成＞

5.1　MCF通信サービスに関する運用

5.2　コネクションに関する運用

5.3　アプリケーションに関する運用

5.4　論理端末に関する運用

5.5　サービスグループに関する運用

5.6　サービスに関する運用

5.7　各プロトコル固有の運用

5.8　メッセージキューの滞留監視

5.9　キューに関する運用

5.10　MCF構成変更再開始機能に関する運用

5.1　MCF通信サービスに関する運用

ここでは，MCF通信サービスに関する運用について説明します。

＜この節の構成＞

(1)　MCF通信サービスの状態表示

(2)　MCF通信サービスの開始の待ち合わせ

(1)　MCF通信サービスの状態表示

MCF通信サービスの状態は，mcftlscomコマンドで表示できます。表示内容はMCF通信サーバ名，MCF通信サーバのプロセスID，MCF通信サービスの状態などです。

MCF通信サービスの状態は，UAPからの関数の発行でも取得できます。詳細については，マニュアル「OpenTP1 プログラム作成の手引」を参照してください。

(2)　MCF通信サービスの開始の待ち合わせ

mcftlscomコマンドに-wオプションを指定することで，MCF通信サービスの開始を待ち合わせることができます。これによって，dcstartコマンド（Windowsの場合はntbstartコマンド）がリターンした直後に，MCF通信サービスが開始したかどうかを意識しないでMCFの運用コマンドを実行できます。

以降，OSがUNIXで，運用コマンド（mcfuevt）を実行する場合を例に説明します。

MCF通信サービスの開始を待ち合わせない場合の，運用コマンド実行時の処理の流れを，次の図に示します。

図5-1　運用コマンド実行時の処理の流れ（MCF通信サービスの開始を待ち合わせない場合）

この図では，MCF通信サービスの開始処理中であるため，mcfuevtコマンドの受け付けができません。MCF通信サービスが開始したかどうかは，mcftlscomコマンドを繰り返し実行して確認する必要があります。

MCF通信サービスの開始を待ち合わせる場合の運用コマンド実行時の処理の流れを，次の図に示します。

図5-2　運用コマンド実行時の処理の流れ（MCF通信サービスの開始を待ち合わせる場合）

この図では，mcftlscomコマンドがMCF通信サービスの開始を待ってからリターンします。このため，MCF通信サービスの開始を確認しなくても，mcfuevtコマンドを実行できます。

5.2　コネクションに関する運用

ここでは，コネクションに関する運用について説明します。

＜この節の構成＞

(1)　コネクションの状態表示

(2)　コネクションの確立と解放

(3)　コネクションの切り替え

(4)　サーバ型コネクションの確立要求の受付開始と終了

(1)　コネクションの状態表示

コネクションの状態は，mcftlscnコマンドで表示できます。mcftlscnコマンドに-dオプションを指定すると，コネクションに対応する論理端末の情報も表示します。表示内容はコネクションID，プロトコル種別，コネクション状態などです。

コネクションの状態は，UAPからの関数の発行でも取得できます。詳細については，マニュアル「OpenTP1 プログラム作成の手引」を参照してください。

(2)　コネクションの確立と解放

コネクション障害，またはmcftdctcnコマンドの入力でコネクションが閉塞中の場合，mcftactcnコマンドでコネクションを確立できます。

mcftactcnコマンドで確立したコネクションを解放したいときには，mcftdctcnコマンドを使用します。コネクションを正常に解放できない場合，mcftdctcnコマンドに-fオプションを指定すると，コネクションを強制的に解放できます。コネクションを強制的に解放すると，受信途中のメッセージは捨てられて入力キューに登録されません。送信中の場合，送信処理は中断され，送信途中のメッセージは出力キュー上に残ります。

コネクションの確立と解放は，UAPからの関数の発行でも実行できます。詳細については，マニュアル「OpenTP1 プログラム作成の手引」を参照してください。

(3)　コネクションの切り替え

相手システムが異常終了したり，回線障害が発生したりした場合，mcftchcnコマンドでコネクションを切り替え，メッセージ送受信を続行できます。ただし，切り替え先のコネクションに障害が発生した場合は，mcftchcnコマンドを実行してもメッセージの送受信はできません。

該当する論理端末をmcftdctleコマンドで閉塞し，切り替え元のコネクション，および切り替え先のコネクションをmcftdctcnコマンドで解放したあと，mcftchcnコマンドを実行してください。mcftchcnコマンドを実行すると，コネクションと論理端末の対応を切り替え，切り替え先のコネクションでメッセージを送受信できます。

mcftchcnコマンドは，未送信メッセージがない状態で実行してください。出力キューに未送信メッセージが残っている状態でmcftchcnコマンドを実行すると，未送信メッセージは切り替え先のコネクションに送信されます。また，問い合わせ応答形態のUAPが問い合わせメッセージを受信したあと，応答メッセージを送信する前にmcftchcnコマンドを実行すると，応答メッセージは切り替え先のコネクションに送信されます。

コネクションを切り替えたあと，コネクションの状態を更新したい場合は，mcftactcnコマンドでコネクションを確立してください。コネクション確立後，mcftlscnコマンドを実行すると，コネクションを切り替えたあとのコネクション状態を表示できます。

なお，mcftchcnコマンドを実行するには，TP1/NET/High Availabilityをインストールしておく必要があります。

(4)　サーバ型コネクションの確立要求の受付開始と終了

サーバ型コネクションで，コネクション確立要求の受付を開始する場合は，mcftonlnコマンドを実行します。一方，コネクション確立要求の受付を終了する場合は，mcftoflnコマンドを実行します。また，mcftlslnコマンドの実行によって，確立要求の受付状態を表示することもできます。

詳細については，マニュアル「OpenTP1 プロトコル」の該当するプロトコル編を参照してください。

5.3　アプリケーションに関する運用

ここでは，アプリケーションに関する運用について説明します。

＜この節の構成＞

(1)　アプリケーションの状態表示

(2)　アプリケーションの閉塞と閉塞解除

(3)　アプリケーション異常終了回数の初期化

(4)　アプリケーションに関するタイマ起動要求の表示

(5)　アプリケーションに関するタイマ起動要求の削除

(6)　アプリケーションプログラムの起動

(1)　アプリケーションの状態表示

アプリケーションの状態は，mcfalsapコマンドで表示できます。

表示内容は，アプリケーション種別，アプリケーション名，アプリケーションの状態などです。

(2)　アプリケーションの閉塞と閉塞解除

アプリケーションは，mcfadctapコマンドで閉塞できます。mcfadctapコマンドを実行すると，オプションの指定によって入力キューの入力，入力キューのスケジュールを閉塞します。また，アプリケーション属性定義で，アプリケーションが異常終了した場合のアプリケーションの入力キューの入力，およびスケジュールの閉塞を指定（aplihold=a）またはアプリケーションのスケジュールに閉塞を指定（aplihold=s）すると，該当するアプリケーションが異常終了し，アプリケーション異常終了回数に達した場合，そのアプリケーションは閉塞されます。

入力キューの入力を閉塞した場合，入力キューにすでにあるメッセージは正常に処理されます。閉塞中にメッセージを受信すると，メッセージ廃棄通知イベント（ERREVT2）が通知されます。

入力キューのスケジュールを閉塞中にメッセージを受信した場合，メッセージ廃棄通知イベント（ERREVT2）が通知されます。

閉塞されたアプリケーションは，mcfaactapコマンドで閉塞解除できます。mcfaactapコマンドを実行すると，アプリケーションの異常終了回数は初期化され，0が設定されます。

mcfadctapコマンド，またはmcfaactapコマンドで変更した状態（入力キューの入力，および入力キューのスケジュール状態）を，全面回復時に引き継ぐことができます。MCF通信構成定義の状態引き継ぎ定義で，アプリケーション数上限値を指定しておくと，指定した値までの資源の状態を引き継ぎます。

(3)　アプリケーション異常終了回数の初期化

アプリケーション異常終了回数は，アプリケーションが異常終了したときに加算されます。この回数がアプリケーション定義で指定した異常終了限界回数に達すると，アプリケーション，またはサービスが自動的に閉塞されます。アプリケーション異常終了回数を初期化（0を設定）する場合には，mcfaclcapコマンドを実行してください。なお，アプリケーション異常終了回数は，mcfaactapコマンドでアプリケーションを閉塞解除した時点でも初期化されます。

(4)　アプリケーションに関するタイマ起動要求の表示

アプリケーションに関するタイマ起動要求の状態は，mcfalstapコマンドで表示できます。表示内容は，アプリケーション名やアプリケーション起動要求の受付時刻などです。

(5)　アプリケーションに関するタイマ起動要求の削除

タイマ起動要求をしたアプリケーションの起動を停止するには，mcfadltapコマンドを使用します。mcfadltapコマンドを実行すると，指定されたアプリケーションに対するタイマ起動要求を削除し，アプリケーションの起動を停止します。

アプリケーションに関するタイマ起動要求の削除は，UAPからの関数の発行でも実行できます。詳細については，マニュアル「OpenTP1 プログラム作成の手引」を参照してください。

(6)　アプリケーションプログラムの起動

運用コマンドから直接アプリケーションプログラムを起動できます。mcfuevtコマンドを実行すると，アプリケーション属性定義（mcfaalcap）に指定したアプリケーション名（UCMDEVT）に対応するサービスを起動します。

5.4　論理端末に関する運用

ここでは，論理端末に関する運用について説明します。

＜この節の構成＞

(1)　論理端末の状態表示

(2)　論理端末の閉塞と閉塞解除

(3)　論理端末のメッセージキューの先頭スキップ

(4)　論理端末の出力キューの内容複写

(5)　論理端末の出力キュー処理の保留と保留解除

(6)　論理端末の出力キュー削除

(7)　論理端末の出力キューの内容出力

(8)　論理端末に関するメッセージジャーナル取得の開始と終了

(9)　論理端末に対する継続問い合わせ応答処理の強制終了

(10)　代行送信の開始と終了

(1)　論理端末の状態表示

論理端末の状態は，mcftlsleコマンドで表示できます。

表示内容はMCF識別子，論理端末名称，論理端末状態，未送信メッセージ数，最大未送信メッセージ数などです。

TP1/NET/OSI-TPでは，論理端末に状態を持ちません。

論理端末の状態は，UAPからの関数の発行でも取得できます。詳細については，マニュアル「OpenTP1 プログラム作成の手引」を参照してください。

(2)　論理端末の閉塞と閉塞解除

論理端末は，mcftdctleコマンドで閉塞できます。閉塞中の分岐メッセージの送信要求は，出力キューに滞留します。

論理端末の閉塞は，mcftactleコマンドで解除できます。閉塞が解除されると，出力キュー上に残っているメッセージが送信されます。

メッセージの受信仕掛り中，または送信仕掛り中に，論理端末を閉塞するmcftdctleコマンドを実行した場合，OpenTP1の動作はご使用のプロトコル製品によって異なります。プロトコル製品ごとのOpenTP1の動作を次の表に示します。

表5-1　受信仕掛り中，または送信仕掛り中にmcftdctleコマンドを入力したときの動作

状況
OpenTP1の動作
ご使用のプロトコル製品

受信仕掛り中のmcftdctle入力
受信仕掛り中のメッセージを破棄します。
以降の受信メッセージは入力キューに登録しません。

TP1/NET/C/S560

TP1/NET/HNA-NIF

TP1/NET/HSC（HSC2手順の場合）

TP1/NET/OSAS-NIF

TP1/NET/User Agent

TP1/NET/User Datagram Protocol

TP1/NET/XMAP3

論理端末が閉塞状態でも，メッセージを受信します。
論理端末閉塞によるメッセージ受信処理への影響はありません。

TP1/NET/HDLC

TP1/NET/HSC（HSC1手順の場合）

TP1/NET/NCSB

TP1/NET/Secondary Logical Unit - TypeP2

TP1/NET/TCP/IP

TP1/NET/X25

送信仕掛り中のmcftdctle入力
mcftdctleコマンドがエラーリターンします。
分岐メッセージの送信仕掛り中でない場合は，論理端末は閉塞されます。

TP1/NET/NCSB

TP1/NET/Secondary Logical Unit - TypeP2

TP1/NET/X25

分岐メッセージの送信処理が中断されます。
UAPからの送信メッセージは，出力キュー上に格納されます。

TP1/NET/C/S560

TP1/NET/HDLC

TP1/NET/HSC

TP1/NET/User Agent

TP1/NET/XMAP3

分岐メッセージの送信処理が中断されます。
UAPからの送信メッセージは，破棄されます。

TP1/NET/HNA-NIF

分岐メッセージの送信処理が中断されます。
UAPからの送信メッセージは，出力キューにディスクキューを使用している場合は，出力キュー上に格納されます。出力キューにメモリキューを使用している場合は，破棄されます。

TP1/NET/OSAS-NIF

分岐メッセージの送信処理を中断しません。
送信仕掛り中のメッセージの送信完了後に論理端末が閉塞されます。

TP1/NET/TCP/IP

TP1/NET/User Datagram Protocol

論理端末の閉塞と閉塞解除は，UAPからの関数の発行でも実行できます。詳細については，マニュアル「OpenTP1 プログラム作成の手引」を参照してください。

(3)　論理端末のメッセージキューの先頭スキップ

誤って送信要求したメッセージや送信に失敗したメッセージを破棄したい場合，mcftspqleコマンドを使用します。mcftspqleコマンドを実行すると，キューイングされているメッセージの先頭メッセージを破棄できます。ただし，mcftspqleコマンドを実行する前に，mcftdctleコマンドで論理端末を閉塞しておく必要があります。TP1/NET/HNA-560/20プロトコルを使用している場合は，さらにmcftdctssコマンドでセションを終了しておく必要があります。

また，mcftspqleコマンドを実行する前に，mcftlsleコマンドで論理端末の状態を表示すると，論理端末の状態や未送信メッセージ数などを確認できます。

(4)　論理端末の出力キューの内容複写

端末障害が発生したような場合，mcftdmpquコマンドで出力キューに滞留しているディスクメッセージの内容を確認できます。mcftdmpquコマンドを実行すると，出力キューの内容が指定したファイルに複写されます。-aオプションを指定すると，以前mcftdmpquコマンドを実行したときの複写先ファイルに，出力キューの内容が再び追加書き込みされます。

ただし，mcftdmpquコマンドを単独で使用する場合は，mcftdmpquコマンドを実行する前にmcftdctleコマンドで論理端末を閉塞しておく必要があります。また，mcftdlqleコマンド（出力キューの削除）と組み合わせてmcftdmpquコマンドを使用する場合は，mcftdmpquコマンドを実行する前にmcfthldoqコマンドで出力キュー処理を保留しておく必要があります。このとき，mcftdlqleコマンドの-dオプション（削除種別）にはdiskを指定してください。

(5)　論理端末の出力キュー処理の保留と保留解除

論理端末の出力キューの内容複写（mcftdmpquコマンド）と削除（mcftdlqleコマンド）を続けて行う場合は，複写するメッセージ件数と削除するメッセージ件数を一致させる必要があります。そのため，この間出力キューへの入力，およびスケジュールを抑止しなければなりません。このように一時的な出力キューへの入力，スケジュールの保留は，mcfthldoqコマンドで実行できます。mcfthldoqコマンドを実行すると，オプションの指定によって，出力キューの入力，スケジュール，または入力とスケジュールの両方を保留します。

出力キュー処理の保留は，mcftrlsoqコマンドで解除できます。

mcfthldoqコマンドはOpenTP1システムに次のような影響を与えるので，使用する際にはご注意ください。また，mcfthldoqコマンドを実行後，目的の処理が終了したら，必ずmcftrlsoqコマンドを実行してください。

任意の論理端末の出力キューの入力を保留した場合，該当する論理端末に対してメッセージ送信を行ったUAPは，保留解除されるまで停止します。

複数の論理端末にメッセージ送信を行うUAPを使用する場合，その一つの論理端末の出力キューの入力を保留すると，ほかの論理端末へのメッセージ送信も保留解除されるまで停止することがあります。

保留中の論理端末が一つでも存在する場合に，正常終了，計画停止A，または計画停止BでOpenTP1を終了すると，OpenTP1は異常終了します。

mcfthldoqコマンド，またはmcftrlsoqコマンドで変更した状態（出力キューの入力，およびスケジュールの保留と保留解除状態）を，全面回復時に引き継ぐことができます。MCF通信構成定義の状態引き継ぎ定義で，論理端末数の上限値を指定しておくと，指定した値までの資源の状態を引き継ぎます。このとき，スケジュールの保留によってOTQに滞留していたメッセージは，全面回復後でも保留解除待ち状態で引き継がれます。入力の保留によってOTQへの入力を待たされているメッセージは，全面回復時，OTQに入力されます。

(6)　論理端末の出力キュー削除

コネクションの確立後，出力キューに残っているメッセージを破棄する場合，mcftdlqleコマンドを使用します。

mcftdlqleコマンドのオプションの指定によって，ディスクキューだけを削除したり，ディスクキューとメモリキューを両方とも削除したりできます。

ただし，mcftdlqleコマンドを単独で使用する場合は，mcftdlqleコマンドを実行する前にmcftdctleコマンドで論理端末を閉塞しておく必要があります。

TP1/NET/HNA-560/20プロトコルを使用している場合は，さらにmcftdctssコマンドでセションを終了しておく必要があります。また，論理端末が代行元論理端末であってはなりません。

mcftdmpquコマンド（入出力キューの内容複写）と組み合わせてmcftdlqleコマンドを使用する場合は，mcftdmpquコマンドを実行する前にmcfthldoqコマンドで出力キュー処理を保留しておく必要があります。この場合，mcftdlqleコマンドの-dオプション（削除種別）にはdiskを指定してください。

論理端末の出力キュー削除は，UAPからの関数の発行でも実行できます。詳細については，マニュアル「OpenTP1 プログラム作成の手引」を参照してください。

(7)　論理端末の出力キューの内容出力

端末障害が発生したような場合，次の手順で論理端末の出力キューの内容をファイルに出力できます。

mcfthldoqコマンドを実行して，出力キュー処理を保留します。

mcftdmpquコマンドを実行して，出力キューの内容を指定したファイルに複写します。

mcftdlqleコマンドを実行して，出力キューを削除します。このとき，-dオプション（削除種別）にはdiskを指定してください。

mcftrlsoqコマンドを実行して，出力キュー処理の保留を解除します。

入出力キューのダンプファイルの形式については，「付録A　入出力キューのダンプファイルの形式」を参照してください。

(8)　論理端末に関するメッセージジャーナル取得の開始と終了

メッセージジャーナル（MJ）を取得する場合，mcftactmjコマンドを使用します。mcftactmjコマンドを実行すると，指定された論理端末に関するメッセージジャーナルの取得を開始します。メッセージジャーナルは，入力メッセージ編集UOCコール後と出力メッセージ編集UOCコール前に取得されます。

メッセージジャーナルの取得を終了するには，mcftdctmjコマンドを実行します。

(9)　論理端末に対する継続問い合わせ応答処理の強制終了

継続問い合わせ応答処理を終了する場合，mcftendctコマンドを使用します。mcftendctコマンドを実行すると，指定した論理端末に対する継続問い合わせ応答を強制的に終了できます。

なお，mcftendctコマンドは，TP1/NET/XMAP3プロトコル，またはTP1/NET/HNA-560/20プロトコル使用時に使用できるコマンドです。

継続問い合わせ応答処理については，マニュアル「OpenTP1 プロトコル TP1/NET/XMAP3編」，またはマニュアル「OpenTP1 プロトコル TP1/NET/HNA-560/20編」を参照してください。

(10)　代行送信の開始と終了

メッセージ送信先の論理端末が閉塞状態の場合，または障害があってメッセージを出力できない場合，mcftstaltコマンドを使用します。mcftstaltコマンドを実行すると，メッセージの出力を別の論理端末が代行します。

代行送信を終了するには，mcftedaltコマンドを実行します。

なお，mcftstalt，およびmcftedaltコマンドは，TP1/NET/XMAP3プロトコル，またはTP1/NET/HNA-560/20プロトコル使用時に使用できるコマンドです。

代行送信については，マニュアル「OpenTP1 プロトコル TP1/NET/XMAP3編」，またはマニュアル「OpenTP1 プロトコル TP1/NET/HNA-560/20編」を参照してください。

5.5　サービスグループに関する運用

ここでは，サービスグループに関する運用について説明します。

＜この節の構成＞

(1)　サービスグループの状態表示

(2)　サービスグループの閉塞と閉塞解除

(3)　サービスグループの入力キューの内容複写

(4)　サービスグループの入力キュー処理の保留と保留解除

(5)　サービスグループの入力キュー削除

(6)　サービスグループの入力キューの内容出力

(1)　サービスグループの状態表示

サービスグループの状態は，mcftlssgコマンドで表示できます。

表示内容はサービスグループ名，サービスグループの状態，受信メッセージ数などです。

(2)　サービスグループの閉塞と閉塞解除

サービスグループは，mcftdctsgコマンドで閉塞できます。mcftdctsgコマンドを実行すると，オプションの指定によって入力キューの入力，入力キューのスケジュールを閉塞します。また，アプリケーション属性定義で，アプリケーションが異常終了した場合のサービスグループのスケジュール閉塞（srvghold=s）を指定すると，アプリケーションが異常終了し，アプリケーション異常終了限界回数になった場合にサービスグループは閉塞されます。

入力キューの入力を閉塞した場合，入力キューにすでにあるメッセージは正常に処理されます。閉塞中にメッセージを受信すると，メッセージ廃棄通知イベント（ERREVT2）が通知されます。

入力キューのスケジュールを閉塞中にメッセージを受信したとき，メモリキューの場合はメッセージ廃棄通知イベント（ERREVT2）が通知されます。ディスクキューの場合は，サービスグループの閉塞解除後にメッセージを再スケジュールします。

再開始時に，前回のオンラインで仕掛り中だった入力メッセージの再スケジュールに失敗すると，該当するサービスグループの入力キューのスケジュールは閉塞されます。

また，次に示すオペランドの指定値を超えたためにUAPがタイムアウトで異常終了した場合も，サービスおよびサービスグループが閉塞対象となります。

trn_cpu_time

watch_next_chain_time

xat_trn_expiration_time

再スケジュール失敗の原因を取り除いたあと，mcftactsgコマンドを入力すると，サービスグループの閉塞を解除し，前回のオンラインで仕掛り中だった入力メッセージを再スケジュールできます。

mcftdctsgコマンド，またはmcftactsgコマンドで変更した状態（入力キューの入力，および入力キューのスケジュール状態）を，全面回復時に引き継ぐことができます。MCFマネジャ定義の状態引き継ぎ定義で，サービスグループ数上限値を指定しておくと，指定した値までの資源の状態を引き継ぎます。また，全面回復時に閉塞状態を引き継がない場合には，mcftdctsgコマンドに-rオプションを指定します。

(3)　サービスグループの入力キューの内容複写

サービスグループの入力キューの内容を出力できなくなったときなど，mcftdmpquコマンドで入力キューに滞留しているディスクメッセージの内容を確認できます。mcftdmpquコマンドを実行すると，入力キューの内容がファイルに複写されます。-aオプションを指定すると，以前mcftdmpquコマンドを実行したときの複写先ファイルに，入力キューの内容が再び追加書き込みされます。

mcftdlqsgコマンド（入力キューの削除）と組み合わせてmcftdmpquコマンドを使用する場合は，mcftdmpquコマンドを実行する前にmcfthldiqコマンドで入力キュー処理を保留しておく必要があります。この場合，mcftdlqsgコマンドの-dオプション（削除種別）にはdiskを指定してください。

(4)　サービスグループの入力キュー処理の保留と保留解除

サービスグループの入力キューの内容複写（mcftdmpquコマンド）と削除（mcftdlqsgコマンド）を続けて行う場合は，複写するメッセージ件数と削除するメッセージ件数を一致させる必要があります。そのため，この間入力キューへの入力，およびスケジュールを抑止しなければなりません。このように一時的な入力キューへの入力，スケジュールの保留は，mcfthldiqコマンドで行えます。mcfthldiqコマンドを実行すると，オプションの指定によって，入力キューの入力，スケジュール，または入力とスケジュールの両方を保留します。

入力キュー処理の保留は，mcftrlsiqコマンドで解除できます。

mcfthldiqコマンドはOpenTP1システムに次のような影響を与えるので，使用する際にはご注意ください。また，mcfthldiqコマンドを実行後，目的の処理が終了したら，必ずmcftrlsiqコマンドを実行してください。

MCFアプリケーション起動サービスを使って起動する任意のサービスグループの入力キューの入力を保留した場合，該当するMCFアプリケーション起動サービスは，すべてのサービスグループの起動を保留します。

MCF通信サービスが起動する任意のサービスグループの入力キューの入力を保留した場合，その入力元論理端末への送信メッセージも，保留解除されるまで，OTQに滞留します。

MCF通信サービスが起動する任意のサービスグループの入力キューの入力を保留した場合，該当するMCF通信サービスの処理性能が劣化することがあります。

入力キューへの入力が保留中であるサービスグループに対して，メッセージ入力があった場合，その入力元論理端末とその論理端末の属するコネクションに対する運用コマンドがタイムアウトになることがあります。タイムアウトが発生しても，運用コマンドは受け付けられています。サービスグループの保留を解除したあとに運用コマンドは実行されます。

保留中のサービスグループが一つでもある場合に，正常終了，計画停止A，または計画停止BでOpenTP1を終了すると，OpenTP1は異常終了します。

mcfthldiqコマンド，またはmcftrlsiqコマンドで変更した状態（入力キューの入力，およびスケジュールの保留と保留解除状態）を，全面回復時に引き継ぐことができます。MCFマネジャ定義の状態引き継ぎ定義で，サービスグループ数の上限値を指定しておくと，指定した値までの資源の状態を引き継ぎます。このとき，スケジュールの保留によってITQに滞留していたメッセージは，全面回復後でも保留解除待ち状態で引き継がれます。入力の保留によってITQへの入力を待たされているメッセージは，全面回復時，ITQに入力されます。なお，サービスグループ数の上限値を指定した環境で，保留状態を引き継ぎたくない場合は，mcfthldiqコマンドに-rオプションを指定してください。

(5)　サービスグループの入力キュー削除

入力キューに残っているメッセージを削除する場合は，mcftdlqsgコマンドを使用します。

mcftdlqsgコマンドのオプションの指定によって，ディスクキューだけを削除したり，ディスクキューとメモリキューを両方とも削除したりできます。

ただし，mcftdlqsgコマンドを単独で使用する場合は，mcftdlqsgコマンドを実行する前に，mcftdctsgコマンドでサービスグループを閉塞しておく必要があります。

mcftdmpquコマンド（入出力キューの内容複写）と組み合わせてmcftdlqsgコマンドを使用する場合は，mcftdmpquコマンドを実行する前にmcfthldiqコマンドで入力キュー処理を保留しておく必要があります。この場合，mcftdlqsgコマンドの-dオプション（削除種別）にはdiskを指定してください。

(6)　サービスグループの入力キューの内容出力

サービスグループの入力キューの内容を出力できなくなったときなど，次の手順でサービスグループの入力キューの内容をファイルに出力できます。

mcfthldiqコマンドを実行して，入力キュー処理を保留します。

mcftdmpquコマンドを実行して，入力キューの内容を指定したファイルに複写します。

mcftdlqsgコマンドを実行して，入力キューを削除します。このとき，-dオプション（削除種別）にはdiskを指定してください。

mcftrlsiqコマンドを実行して，入力キュー処理の保留を解除します。入出力キューのダンプファイルの形式については，「付録A　入出力キューのダンプファイルの形式」を参照してください。

5.6　サービスに関する運用

ここでは，サービスに関する運用について説明します。

＜この節の構成＞

(1)　サービスの状態表示

(2)　サービスの閉塞と閉塞解除

(1)　サービスの状態表示

サービスの状態はmcftlssvコマンドで表示できます。

表示内容はサービス名，サービスの状態などです。

(2)　サービスの閉塞と閉塞解除

サービスは，mcftdctsvコマンドで閉塞できます。mcftdctsvコマンドを実行すると，オプションの指定によって，入力キューの入力や入力キューのスケジュールを閉塞します。また，アプリケーション属性定義で，アプリケーションが異常終了した場合のサービスの入力，スケジュールの閉塞（servhold=a）またはサービスのスケジュールの閉塞（servhold=s）を指定すると，該当するアプリケーションが異常終了し，アプリケーション異常終了限界回数に達した場合，そのサービスは閉塞されます。

入力キューの入力を閉塞した場合，入力キューにすでにあるメッセージは正常に処理されます。閉塞中にメッセージを受信すると，メッセージ廃棄通知イベント（ERREVT2）が通知されます。

入力キューのスケジュールを閉塞中にメッセージを受信した場合，メッセージ廃棄通知イベント（ERREVT2）が通知されます。

また，次に示すオペランドの指定値を超えたためにUAPがタイムアウトで異常終了した場合も，サービスおよびサービスグループが閉塞対象となります。

trn_cpu_time

watch_next_chain_time

xat_trn_expiration_time

閉塞されたサービスは，mcftactsvコマンドで閉塞解除できます。

mcftdctsvコマンド，またはmcftactsvコマンドで変更した状態（入力キューの入力，および入力キューのスケジュール状態）を，全面回復時に引き継ぐことができます。

MCFマネジャ定義の状態引き継ぎ定義で，サービス数上限値を指定しておくと，指定した値までの資源の状態を引き継ぎます。

5.7　各プロトコル固有の運用

ここでは，各プロトコル製品固有の運用について説明します。

＜この節の構成＞

5.7.1　セションの開始と終了

5.7.2　バッファグループの使用状況表示

5.7.3　マップファイル

5.7.1　セションの開始と終了

セションの開始はmcftactssコマンドで，セションの終了はmcftdctssコマンドで実行できます。

なお，mcftactssコマンド，およびmcftdctssコマンドは，TP1/NET/HNA-560/20プロトコル使用時に使用できるコマンドです。

セションについては，マニュアル「OpenTP1 プロトコル TP1/NET/HNA-560/20編」を参照してください。

5.7.2　バッファグループの使用状況表示

バッファグループの使用状況は，mcftlsbufコマンドで表示できます。

表示内容はMCF識別子，バッファグループ番号，バッファ数，使用中バッファ数，最大バッファ使用数などです。

5.7.3　マップファイル

TP1/NET/XMAP3プロトコル，またはTP1/NET/HNA-560/20プロトコルを使用している場合に，マッピングサービス機能を使用できます。マッピングサービス機能で使用するdcmapchgコマンドとdcmaplsコマンドは，TP1/NET/XMAP3プロトコル，またはTP1/NET/HNA-560/20プロトコルの場合だけ使用できます。

マッピングサービス機能については，マニュアル「OpenTP1 プロトコル TP1/NET/XMAP3編」，またはマニュアル「OpenTP1 プロトコル TP1/NET/HNA-560/20編」を参照してください。

＜この項の構成＞

(1)　パス名の変更

(2)　資源の表示

(1)　パス名の変更

マッピングサービス機能使用時，使用しているマップを切り替えたい場合は，dcmapchgコマンドを使用します。dcmapchgコマンドを使用すると，次に示すマップファイルのパス名を変更できます。

標準用物理マップ読み込みパス

交代用物理マップ読み込みパス

標準用PAGECモジュール読み込みパス

交代用PAGECモジュール読み込みパス

(2)　資源の表示

dcmaplsコマンドを使用してロード済みの物理マップ，またはPAGECモジュールを表示できます。dcmaplsコマンドに-sオプションを指定します。

dcmaplsコマンドに-pオプションを指定すると，マップファイルパスのパス名が表示されます。

5.8　メッセージキューの滞留監視

入力キューに滞留するメッセージキューを一定の時間間隔で監視する機能を，メッセージキューの滞留監視機能といいます。この機能はユーザサーバ（MHP）だけで有効です。メッセージキューの滞留監視機能の概要を次の図に示します。

図5-3　メッセージキューの滞留監視機能の概要

MCFサービスの開始後，入力キューに滞留するメッセージキューの監視が始まります。
メッセージキューの滞留数だけを監視している時間を滞留数監視区間と呼びます。監視はMCFサービスが終了するまで行われます。

入力キューに滞留しているメッセージ数が，しきい値を超えた場合は，一定の時間間隔でMHPの処理能力を監視します。
この時間を処理能力判定区間と呼びます。処理能力判定区間で，MHPの処理能力が期待件数に満たない場合，KFCA11820-Wメッセージを出力して処理を続行するか，またはKFCA11821-Eメッセージを出力してOpenTP1システムをダウンします。

なお，メッセージキューの滞留監視の開始後，監視対象として定義したサービスグループがMCFアプリケーション属性定義に定義されていない場合は，KFCA11822-Wメッセージが出力され処理は続行されます。

＜この節の構成＞

(1)　指定するオペランド

(2)　処理の流れ

(3)　処理の流れの例

(4)　注意事項

(1)　指定するオペランド

メッセージキューの滞留監視機能を使用するには，次に示すMCFマネジャ定義のmcfmsvg定義コマンドを指定します。

mcfmsvg -g "servgrpn=サービスグループ名"
入力キューの滞留監視を行うサービスグループ名を指定します。

mcfmsvg -w "watchcnt=入力キューの滞留監視数"
滞留数監視区間から処理能力判定区間に遷移する際の判断になる入力キューのメッセージ滞留数（しきい値）を指定します。

mcfmsvg -w "watchint=入力キューの滞留監視インタバル時間"
入力キューに滞留しているメッセージ数およびMHPの処理能力を監視するインタバル時間を指定します。

mcfmsvg -w "expectcnt=MHPに期待するサービス要求の処理数"
次回のMHPの処理能力判定時までに期待するサービス要求の処理数（入力キューに滞留しているメッセージが処理完了となる件数）を指定します。

mcfmsvg -w "abort=yes｜no"
MHPの処理能力の不足を検出した場合，OpenTP1システムをダウンさせるかどうかを指定します。

それぞれのオペランドの詳細については，マニュアル「OpenTP1 システム定義」を参照してください。

(2)　処理の流れ

メッセージキューの滞留監視の処理の流れを説明します。

MCFサービスの開始後，滞留数監視区間が始まり，入力キューの滞留監視インタバル時間（mcfmsvg -w watchintで指定）の間隔でメッセージキューの滞留数の監視を開始します。

入力キューに滞留しているメッセージ数が入力キューの滞留監視数（mcfmsvg -w watchcntで指定）を超えた時点で処理能力判定区間に入ります。
処理能力判定区間では，次に示す式によってMHPの処理能力が判定されます。

MHPの処理能力判定式

判定後の処理を次に示します。

MHPの処理能力判定式が成立しない場合
処理が続行されます。

MHPの処理能力判定式が成立し，MHPの処理能力の不足時にOpenTP1システムをダウンさせる指定をしていない場合（mcfmsvg -w abortにnoを指定）
KFCA11820-Wメッセージが出力され，処理が続行されます。

MHPの処理能力判定式が成立し，MHPの処理能力の不足時にOpenTP1システムをダウンさせる指定をしている場合（mcfmsvg -w abortにyesを指定）
KFCA11821-Eメッセージが出力され，OpenTP1システムをダウンさせます。

入力キューに滞留しているメッセージ数が入力キューの滞留監視数（mcfmsvg -w watchcntで指定）よりも少なくなった場合，処理能力判定区間から滞留数監視区間に戻ります。

メッセージキューの滞留監視時の判定条件とMCFの動作を次の表に示します。

表5-2　メッセージキューの滞留監視時の判定条件とMCFの動作

判定条件 | MCFの動作
前回判定時の区間 | 滞留数と監視数の関係 | AとBの関係 | AとCの関係 | mcfmsvg -w abortの指定
滞留数監視区間 | 滞留数＜監視数 | 判定しない | 判定しない | 判定しない | 滞留数監視区間のまま処理を続行する。
滞留数≧監視数 | 判定しない | 判定しない | 判定しない | 処理能力判定区間に遷移して処理を続行する。
処理能力判定区間 | 滞留数＜監視数 | 判定しない | 判定しない | 判定しない | 滞留数監視区間に遷移して処理を続行する。
滞留数≧監視数 | A≧B | A≧C | 判定しない | 処理能力判定区間のまま処理を続行する。
A＜C | 判定しない
A＜B | A≧C | 判定しない
A＜C | yes | KFCA11821-Eメッセージを出力して，MHPを強制終了し，OpenTP1システムをダウンさせる。
no | KFCA11820-Wメッセージを出力して，処理能力判定区間のまま，処理を続行する。

（凡例）

A：MHPが処理したサービス要求数

B：MHPに期待するサービス要求の処理数

C：前回判定時に滞留していたサービス要求数

(3)　処理の流れの例

MCFマネジャ定義のmcfmsvg定義コマンドで次のように指定した場合のメッセージキューの滞留監視機能の処理の例を説明します。

MCFマネジャ定義のmcfmsvg定義コマンドの指定

入力キューの滞留監視数（mcfmsvg -w "watchcnt=30"）

入力キューの滞留監視インタバル時間（mcfmsvg -w "watchint=5"）

MHPに期待するサービス要求の処理数（mcfmsvg -w "expectcnt=24"）

MHPの処理能力の不足を検出した場合，OpenTP1システムをダウンさせるかどうかを指定（mcfmsvg -w "abort=yes"）

図5-4　メッセージキューの滞留監視機能の処理の例

入力キューの滞留監視数を30と指定しているため，この図でC2からC5の区間およびC8以降が処理能力判定区間です。それ以外は滞留数監視区間です。

入力キューの滞留監視を判定する時点でのメッセージキューの滞留数と判定結果を次の表に示します。

表5-3　メッセージキューの滞留数と判定結果

項番
前回判定時から引き続き滞留しているメッセージキューの個数
（Bn）
前回判定時のメッセージキューの滞留数
（Pn-1）
前回判定時から今回までのサービス要求処理数
（Pn-1-Bn）
MHPに期待するサービス要求の処理数
判定結果

1
11
－
－
24
滞留数が監視数に達していないため，滞留数監視区間のままオンライン続行

2
9
18
9
24

3
25
28
3
24
滞留数が監視数に達したため，処理能力判定区間を開始

4
8
32
24
24
滞留数が監視数に達しているが，MHPが期待件数以上のサービス要求を処理できているため，処理能力判定区間のままオンライン続行

5
13
45
32
24

6
0
35
35
24

7
3
30
27
24
滞留数が監視数に達していないため，滞留数監視区間を開始

8
5
11
6
24
滞留数が監視数に達していないため，滞留数監視区間のままオンライン続行

9
15
17
2
24
滞留数が監視数に達したため，処理能力判定区間を開始

10
29
32
3
24
滞留数が監視数に達しており，MHPが期待件数または前回のメッセージ滞留数以上の要求を処理できていないため，オンライン停止

（凡例）

－：該当しない

(4)　注意事項

閉塞中または保留中のサービスグループは，メッセージキューの滞留監視の対象外です。また，処理能力判定区間で閉塞または保留した場合，処理能力判定区間から滞留数監視区間に移行したものと見なされます。したがって，閉塞解除または保留解除したあとの最初の監視で，閉塞または保留時の区間に関係なく，改めてメッセージの滞留数の判定を行い，入力キュー滞留監視数を超えている場合は，処理能力判定区間を開始します。

mcftdlqsgコマンドによって削除した入力キューの滞留数は，MHPで処理したサービス要求数に含まれません。

OpenTP1のオンライン中に，秒単位またはそれより大きな単位で時刻を進めたり戻したりしないでください。この機能は日付や時間の情報を使用しているため，OpenTP1のオンライン中に時刻を変更した場合，次に示す問題が発生します。

時刻を進めた場合，MCFが判定時刻に到達したと不当に判断して定義内容によってはOpenTP1システムがダウンするおそれがあります。

時刻を戻した場合，定義内容によっては入力キューの滞留監視を行わなくなるおそれがあります。

時刻の変更の詳細については，「3.14.4　時刻変更に関する注意」を参照してください。

5.9　キューに関する運用

＜この節の構成＞

(1)　キューグループの状態表示

(2)　メッセージキュー用物理ファイルの割り当て

(3)　メッセージキュー用物理ファイルの削除

(1)　キューグループの状態表示

キューグループごとに，物理ファイル，およびキューファイルの状態を，quelsコマンドで表示できます。

表示内容は物理ファイルのレコード長，使用中のレコード数，物理ファイルのパス名などです。

(2)　メッセージキュー用物理ファイルの割り当て

メッセージキューサービスがメッセージキューとして使用する物理ファイルを，queinitコマンドで割り当てることができます。

(3)　メッセージキュー用物理ファイルの削除

queinitコマンドでメッセージキュー用に割り当てた物理ファイルは，quermコマンドで削除できます。ただし，指定した物理ファイルがオンラインで使用中の場合は削除できません。

5.10　MCF構成変更再開始機能に関する運用

MCF構成変更再開始機能は，OpenTP1の再開始時に，オンライン停止時に入力キュー（ディスクキュー）上に残っていた未処理受信メッセージおよび出力キュー（ディスクキュー）上に残っていた未送信メッセージを次回のオンラインに引き継いだまま，OpenTP1ファイルシステムやキューグループの構成変更，および論理端末やアプリケーションの構成変更をできるようにする機能です。

MCF構成変更再開始機能を使用するためには，TP1/Message Control - Extension 1が必要です。

ここでは，MCF構成変更再開始機能使用時の流れや手順，障害対策などについて説明します。

＜この節の構成＞

5.10.1　MCF構成変更再開始機能使用時の流れ

5.10.2　MCF構成変更再開始機能使用時の準備

5.10.3　MCF構成変更再開始機能使用時のOpenTP1の終了と再開始

5.10.4　MCF構成変更再開始機能使用時の構成変更手順

5.10.5　MCF構成変更再開始機能使用時のメッセージのバックアップとリストア

5.10.6　MCF構成変更再開始機能使用時の障害対策

5.10.1　MCF構成変更再開始機能使用時の流れ

MCF構成変更再開始機能使用時の，ユーザの操作の流れについて説明します。

OpenTP1を終了します。
コマンドラインからMCF構成変更準備停止のオプション（-b -q）を指定したdcstopコマンドを実行し，オンラインを停止します。
Windowsの場合，MCF構成変更準備停止によるOpenTP1の停止は，サービスダイアログやOpenTP1のGUI機能で行うことはできません。コマンドラインから実行してください。
TP1/Message Controlは終了処理中にディスクキュー上の未処理受信メッセージまたは未送信メッセージをバックアップします。
OpenTP1の終了については，「5.10.3(1)　MCF構成変更再開始機能によるOpenTP1の終了」を参照してください。

注意

TP1/Message Controlの構成を変更する前に，全システムサーバが終了してから，OpenTP1ファイルシステム，システムサービス定義，メッセージキューサービス定義，およびネットワークコミュニケーション定義をバックアップしてください。

TP1/Message Controlの構成を変更します。
OpenTP1がオフライン状態になってからTP1/Message Controlの構成を変更します。
変更できる項目は次のとおりです。

OpenTP1ファイルシステム

メッセージキュー用物理ファイル

システムサービス定義とメッセージキューサービス定義

ネットワークコミュニケーション定義

構成変更の手順については，「5.10.4　MCF構成変更再開始機能使用時の構成変更手順」を参照してください。

OpenTP1を開始し，オンラインを再開します。
OpenTP1を起動すると，MCF構成変更再開始が行われます。
Windowsの場合，OpenTP1の起動には，サービスダイアログ，コマンドライン，およびGUI機能が使用できます。ただし，MCF構成変更再開始を取り消した再開始モードによるOpenTP1の起動の場合（dcstartコマンドに-bオプションを指定した場合）は，サービスダイアログやOpenTP1のGUI機能で行うことはできません。コマンドラインから実行してください。
MCF構成変更準備停止が異常終了した場合など，終了モードの違いによってMCF構成変更再開始が行われないことがあります。
OpenTP1の開始については，「5.10.3(2)　MCF構成変更再開始機能によるOpenTP1の再開始」を参照してください。
OpenTP1の起動中に，TP1/Message Controlがバックアップした未処理受信メッセージまたは未送信メッセージのリストアを行い，ディスクキューを回復します。

MHPを開始します。
dcsvstartコマンドで，追加したMHPを開始します。
MCF構成変更再開始でのOpenTP1の起動では，ユーザサービス構成定義に記述したMHPは起動されません。MCF構成変更再開始でOpenTP1の起動した場合は，dcsvstartコマンドで追加したMHPを開始してください。

参考

OpenTP1システムの開始に合わせてMHPを自動的に起動したい場合は，システム環境定義のuser_command_onlineオペランドを使用してください。

ただし，user_command_onlineオペランドの使用時には，次のことに注意してください。

追加したMHPは，次回の構成変更再開始で自動起動されないよう，user_command_onlineオペランドで実行するコマンドから起動処理を削除してください。

user_command_onlineオペランドを実行する必要がない場合は，user_command_onlineオペランドの記述を削除するかコメントにしてください。
削除するかコメントにしないと，次回以降のOpenTP1の起動処理が失敗します。

5.10.2　MCF構成変更再開始機能使用時の準備

MCF構成変更再開始機能使用時に，事前に実施しておく必要がある項目について説明します。

＜この項の構成＞

(1)　メモリ使用量の再見積もり

(2)　共用メモリ，ステータスファイル，およびチェックポイントダンプファイルの再見積もり

(3)　ネットワークコミュニケーション定義の見直し

(4)　オンラインの停止および開始時間の見積もり

(5)　系切り替え構成時の注意事項

(1)　メモリ使用量の再見積もり

(a)　静的共用メモリ

MCF構成変更再開始機能を使用する場合，MCFサービスで使用する共用メモリの使用量が増加します。MCFマネジャプロセスで使用する共用メモリの見積もり式に400バイトを加算してください。

また，構成変更する内容に応じて共用メモリのサイズを再見積もりしてください。詳細については，マニュアル「OpenTP1　システム定義」の共用メモリの見積もり式の記述を参照してください。

(b)　ローカルメモリ

MCF構成変更再開始機能を使用する場合，TP1/Message Controlの構成に応じてローカルメモリが増加します。増加するメモリ所要量の計算式を次に示します。

80×a＋128×(b＋c)＋d＋1204

（凡例）

a：キューグループ数（mcfmqgid定義コマンドの指定数）

b：論理端末数（mcftalcle定義コマンドの指定数）

c：MHPサービスグループ数（mcfaalcap定義コマンドに指定したサービスグループの種類数）

d：最大セグメント長（mcfmuap定義コマンドの-eオプションのsegsizeオペランドの指定値）

(2)　共用メモリ，ステータスファイル，およびチェックポイントダンプファイルの再見積もり

システム定義の内容に応じて，共用メモリ，ステータスファイル，およびチェックポイントダンプファイルの必要量が変わります。システムの構成変更を行う場合は，共用メモリ，ステータスファイルを再見積もりしてください。

共有メモリの見積もりについてはマニュアル「OpenTP1 システム定義」の共有メモリの見積もり式を，ステータスファイルの見積もりについては「付録H.1　ステータスファイルのサイズの見積もり式」を参照してください。

また，チェックポイントダンプファイルは，将来的に拡張する分をあらかじめ加算しておいてください。

(3)　ネットワークコミュニケーション定義の見直し

(a)　状態引き継ぎ定義（mcfmstsおよびmcftsts）の見直し

MCF構成変更再開始機能では，次の項目の状態を引き継ぐことができます。

論理端末

サービスグループ

サービス

アプリケーション

状態を引き継ぐ場合，次の指定値に将来的な拡張分をあらかじめ加算してください。

MCFマネジャ定義の状態引き継ぎ定義（mcfmsts -vおよび-g）

MCF通信構成定義の状態引き継ぎ定義（mcftsts -lおよび-a）

各定義の指定値が不足した場合は，状態引き継ぎの登録ができなかった旨のメッセージを出力し，状態引き継ぎは行いません。

(b)　UAP共通定義（mcfmuap）の見直し

MCF構成変更再開始機能を使用する場合，MCFマネジャ定義のUAP共通定義に指定する最大セグメント長（mcfmuap -e segsize指定値）には，次の中で最も大きい値を指定してください。

すべてのMCF通信プロセスのバッファグループ定義のバッファ長（mcftbuf -g length）

エラーイベント処理用MHPで送受信するメッセージの最大セグメント長

アプリケーションプログラムを起動する場合に送信するメッセージの最大セグメント長

指定値を超える未処理受信メッセージまたは未送信メッセージがある場合は，MCF構成変更準備停止時にOpenTP1が異常終了します。

(4)　オンラインの停止および開始時間の見積もり

オンラインの停止および開始の所要時間は，次の項目に比例して増減します。ご注意ください。

MCFマネジャ定義の入出力キュー定義（mcfmqgid）の指定数

MCF通信構成定義の論理端末定義（mcftalcle）の指定数

MCFアプリケーション定義のアプリケーション属性定義（mcfaalcap）に指定したサービスグループの種類数

MCF構成変更準備停止時に入力キューまたは出力キューに滞留しているメッセージ数

(5)　系切り替え構成時の注意事項

系切り替え構成でMCF構成変更再開始機能を使用する場合の注意事項を次に示します。

ホットスタンバイ構成で，実行系のOpenTP1をMCF構成変更準備停止する場合，あらかじめ待機系のOpenTP1を停止して，待機系のOpenTP1のMCF構成変更準備停止時のバックアップファイルを削除しておいてください。
待機系のOpenTP1を起動したままで実行系のOpenTP1をMCF構成変更準備停止した場合，終了中に障害が発生すると待機系のOpenTP1システムがMCF構成変更再開始モードで再開始します。
このとき，待機系のOpenTP1に以前のMCF構成変更準備停止時のバックアップファイルが残っていると，前回オンライン中の未処理受信メッセージおよび未送信メッセージが失われるおそれがあります。
待機系のOpenTP1システムがMCF構成変更再開始モードで開始し，OpenTP1が異常終了した場合，dcstartコマンドに-nオプションを指定して強制的に正常開始するか，dcstartコマンドに-bオプションを指定して強制的に再開始してください。

構成変更をする場合，待機系のシステムサービス定義およびネットワークコミュニケーション定義も実行系に合わせて変更してください。

MCF構成変更再開始モードでオンラインを再開始する場合，MCF構成変更準備停止で停止した系で再開始してください。

HAモニタの計画系切り替えを行う場合，OpenTP1をMCF構成変更準備停止で停止しないでください。

5.10.3　MCF構成変更再開始機能使用時のOpenTP1の終了と再開始

MCF構成変更再開始機能使用時のOpenTP1の終了と再開始について説明します。

＜この項の構成＞

(1)　MCF構成変更再開始機能によるOpenTP1の終了

(2)　MCF構成変更再開始機能によるOpenTP1の再開始

(1)　MCF構成変更再開始機能によるOpenTP1の終了

dcstop -b -qコマンドを入力することで，終了モード「MCF構成変更準備停止」でオンラインが終了します。

MCF構成変更準備停止の場合，実行中のサービスの完了を待って，OpenTP1が終了します。

スケジュールサービスは新しいサービス要求の受け付けを禁止し，処理中のサービス要求だけを処理します。その他のサービス要求はすべて破棄します。

TP1/Message Controlは再開始中に，メモリキューの入力キュー，および出力キュー上のメッセージは破棄します。ディスクキューの入力キュー上の未処理受信メッセージおよび出力キュー上の未送信メッセージは，システムサービス共通情報定義で指定したファイルにバックアップします。

注意

MCF構成変更準備停止による終了中にOpenTP1が異常終了した場合，次回の開始モードは再開始となります。このとき，システムの構成は変更できません。

MCF構成変更準備停止による終了中にOpenTP1が作成したMCF構成変更準備停止時のバックアップファイルは，次のMCF構成変更準備停止が終了するまでOpenTP1は削除しません。不要となったファイルはユーザが削除してください。また，OpenTP1ファイルシステムのバックアップファイルについても，不要となった時点でユーザが削除してください。

(2)　MCF構成変更再開始機能によるOpenTP1の再開始

前回停止したときの終了モードがMCF構成変更準備停止であった場合，オプションの指定なしでOpenTP1を起動すると自動的にMCF構成変更再開始モードでOpenTP1が再開始します。

MCF構成変更再開始モードでOpenTP1が再開始する場合，再開始モードと同様に前回のオンラインの終了状態を引き継いで開始します。

前回停止したときの終了モードがMCF構成変更準備停止であり，かつ異常終了した場合は，終了モードによって開始モードが変わります。また，開始モードによっては，構成を変更できないときがあります。

前回の終了モードによる開始形態の決定条件，開始形態，およびオフライン中の構成変更の可否について，次の表に示します。

表5-4　前回の終了モードによる開始形態の決定条件，開始形態，およびオフライン中の構成変更の可否

開始形態の決定条件
開始形態
オフライン中の構成変更の可否

前回の
停止状態
前回の終了モード
mode_confの指定値
開始
方法
開始モード

正常終了
MCF構成変更準備停止
AUTO
手動※1
MCF構成変更再開始
○

MANUAL1
手動
MCF構成変更再開始※2，※3
○

MANUAL2

異常終了
MCF構成変更準備停止中
AUTO
手動※1
再開始
×

MANUAL1
手動
再開始※2
×

MANUAL2

MCF構成変更再開始中（オンライン開始前）
AUTO
手動※1
MCF構成変更再開始
○

MANUAL1
手動
MCF構成変更再開始※2，※3
○

MANUAL2

MCF構成変更再開始中（オンライン開始後）
AUTO
自動
再開始
×

MANUAL1
自動※4

MANUAL2
手動
再開始※2
×

（凡例）

○：構成変更できる。

×：構成変更できない。

注※1

OS起動時は自動開始です。

ただし，WindowsでOS起動時に自動開始する場合については，マニュアル「OpenTP1 使用の手引 Windows(R)編」を参照してください。

注※2

dcstart -nコマンドで強制的に正常開始することもできます。

ただし，強制的に正常開始すると前回停止時の状態情報は失われます。

注※3

dcstart -bコマンドで強制的に再開始することもできます。

注※4

OS起動時は手動開始です。

5.10.4　MCF構成変更再開始機能使用時の構成変更手順

MCF構成変更準備停止でオンラインを停止した場合，オフライン中に構成変更できる項目を次に示します。

OpenTP1ファイルシステム

メッセージキュー用物理ファイル

システムサービス定義とメッセージキューサービス定義

ネットワークコミュニケーション定義

注

これらの項目のほか，マニュアル「OpenTP1 システム定義」の再開始時に変更できる定義に記載されているシステムサービス定義も変更対象となります。

＜この項の構成＞

(1)　OpenTP1ファイルシステムの変更手順

(2)　メッセージキュー用物理ファイルの変更手順

(3)　システムサービス定義およびメッセージキューサービス定義の変更手順

(4)　ネットワークコミュニケーション定義の変更手順

(1)　OpenTP1ファイルシステムの変更手順

OpenTP1ファイルシステムの変更は，次の場合に行います。

メッセージキュー用物理ファイルを拡張および追加するための，OpenTP1ファイルシステムの容量が不足している場合

OpenTP1ファイル数が最大ファイル数に達した場合

十分な空き容量があるが，メッセージキュー用物理ファイルを確保するための連続領域が不足している場合

なお，OpenTP1ファイルシステム用に設定したパーティション，または通常ファイル名は変更できません。

OpenTP1ファイルシステムは次の手順で変更します。

OpenTP1ファイルシステムをバックアップします。
filbkupコマンドで，拡張するOpenTP1ファイルシステムのバックアップを取得します。

$ filbkup OpenTP1ファイルシステム領域名 バックアップファイル名

OpenTP1ファイルシステムを初期設定します。
filmkfsコマンドで，OpenTP1ファイルシステムを初期設定します。このとき，-nオプションや-lオプションの指定値には変更前のOpenTP1ファイルシステムより小さい値を指定できますが，手順1でバックアップしたOpenTP1ファイルをすべてリストアできるだけの値を指定する必要があります。
キャラクタ型スペシャルファイルを使用している場合の例を次に示します。

$ filmkfs -s xxx -n xxx -l xxx スペシャルファイル名

OpenTP1ファイルシステムをリストアします。
filrstrコマンドで，手順1で取得したバックアップから手順2で設定したOpenTP1ファイルシステムにリストアします。

$ filrstr バックアップファイル名 OpenTP1ファイルシステム領域名

(2)　メッセージキュー用物理ファイルの変更手順

メッセージキュー用物理ファイルを拡張・追加する場合は，必ずOpenTP1ファイルシステムの容量が不足していないかを確認してから実行してください。メッセージキュー用物理ファイルは，次の手順で変更します。

メッセージキュー用物理ファイルを削除します。
quermコマンドで，拡張または削除するメッセージキュー用物理ファイルをOpenTP1ファイルシステムから削除します。

$ querm メッセージキュー用物理ファイル名

メッセージキュー用物理ファイルを割り当てます。
queinitコマンドで，拡張または追加するメッセージキュー用物理ファイルをOpenTP1ファイルシステムに割り当てます。

$ queinit -s xxx -n xxx メッセージキュー用物理ファイル名

(3)　システムサービス定義およびメッセージキューサービス定義の変更手順

システムサービス定義およびメッセージキューサービス定義は，マニュアル「OpenTP1 システム定義」に記載しているすべての定義内容をオフライン中に変更できます。変更した構成に応じて，定義の変更，追加，および削除を行ってください。

システムサービス定義およびメッセージキューサービス定義は次の手順で変更します。

オペランドの指定値を変更します。
変更が必要なオペランドの指定値を変更します。マニュアル「OpenTP1 システム定義」の再開始時に変更できる定義に記載されている，システムサービス定義とメッセージキューサービス定義のオペランドの指定値を変更できます。
システムサービス定義とメッセージキューサービス定義を変更する場合の例を次に示します。変更部分は下線で示しています。

表5-5　システムサービス定義とメッセージキューサービス定義の変更例

変更前
変更後

<システム環境定義>

set static_shmpool_size =80000

set dynamic_shmpool_size=80000

<メッセージキューサービス定義>

set que_xidnum = 256

<システム環境定義>

set static_shmpool_size =100000

set dynamic_shmpool_size=100000

<メッセージキューサービス定義>

set que_xidnum = 512

キューグループを追加します。
メッセージキュー用物理ファイルを追加した場合，メッセージキューサービス定義に新たに使用するキューグループを追加します。
メッセージキューサービス定義にキューグループを追加する場合の例を次に示します。追加部分は下線で示しています。

表5-6　メッセージキューサービス定義へのキューグループの追加例

変更前
変更後

quegrp -g quegrp1 -f 物理ファイルA
quegrp -g quegrp2 -f 物理ファイルB

quegrp -g quegrp1 -f 物理ファイルA
quegrp -g quegrp2 -f 物理ファイルB
quegrp -g quegrp3 -f 物理ファイルC

キューグループを削除します。
メッセージキュー用物理ファイルを削除した場合，メッセージキューサービス定義から該当するキューグループを削除します。
メッセージキューサービス定義からキューグループを削除する場合の例を次に示します。

表5-7　メッセージキューサービス定義からのキューグループの削除例

変更前
変更後

quegrp -g quegrp1 -f 物理ファイルA
quegrp -g quegrp2 -f 物理ファイルB
quegrp -g quegrp3 -f 物理ファイルC

quegrp -g quegrp1 -f 物理ファイルA
（削除）
quegrp -g quegrp3 -f 物理ファイルC

(4)　ネットワークコミュニケーション定義の変更手順

ネットワークコミュニケーション定義の追加，削除，および変更できる定義内容，ならびに変更手順について次に示します。

なお，ネットワークコミュニケーション定義の追加，削除，および変更できる定義内容には制限があります。

(a)　ネットワークコミュニケーション定義の追加および削除できる定義内容

ネットワークコミュニケーション定義でオフライン中に追加，および削除できる定義内容を次の表に示します。

表5-8　オフライン中に追加および削除できる定義内容

定義名 | コマンド
MCFマネジャ定義 | mcfmqgid（入出力キュー定義）
mcfmsvg（サービスグループ属性定義）
MCF通信構成定義 | 共通定義 | mcftbuf（バッファグループ定義）
アプリケーション起動定義 | mcftalcle（論理端末定義）
プロトコル固有定義（TP1/NET/TCP/IP） | mcftalccn（コネクション定義の開始）
mcftalcle（論理端末定義）
mcftalced（コネクション定義の終了）
プロトコル固有定義（TP1/NET/XMAP3） | mcftalccn（コネクション定義の開始）
mcftalcle（論理端末定義）
mcftalced（コネクション定義の終了）
MCFアプリケーション定義 | mcfaalcap（アプリケーション属性定義）

注

既存の定義のオプションやオペランド指定値の追加，および削除対象にできるのは，(b)に示すものだけです。

(b)　ネットワークコミュニケーション定義の変更できる定義内容

ネットワークコミュニケーション定義でオフライン中に変更できる定義内容は，MCFマネジャ定義，MCF通信構成定義（共通定義），およびシステムサービス共通情報定義の次に示す定義内容です。

オフライン中に変更できるMCFマネジャ定義の定義内容を次の表に示します。

表5-9　オフライン中に変更できるMCFマネジャ定義の定義内容

コマンド | オプション | オペランド | 定義内容
mcfmcomn | -n | － | 出力通番使用論理端末数※
-p | － | MCF作業領域長
-j | － | MCFマネジャプロセスのジャーナルバッファのサイズ
mcfmuap | -j | － | ユーザサーバのジャーナルバッファの大きさ
-e | segsize | 最大セグメント長
mcfmexp | -g | － | サービスグループの登録数
-l | － | 論理端末の登録数

（凡例）

－：該当しない

注※

前回の指定値より小さい値を指定できますが，前回オンライン時の使用量より小さい値を指定した場合，KFCA11243-Eメッセージを出力し，MCFマネジャプロセスが異常終了します。

オフライン中に変更できるMCF通信構成定義（共通定義）の定義内容を次の表に示します。

表5-10　オフライン中に変更できるMCF通信構成定義（共通定義）の定義内容

コマンド | オプション | オペランド | 定義内容
mcftcomn | -j | － | MCF通信サービスまたはアプリケーション起動プロセスのジャーナルバッファのサイズ
mcfttim | -p | timereqno | 最大タイマ監視要求数
msgsize | 最大メッセージ長
mcfttrc | -t | size | トレースバッファの大きさ
bufcnt | トレースバッファの数
trccnt | トレースファイルの数
msgsize | トレースとして取得する送受信メッセージの最大サイズ
mcftbuf | -g | length | バッファ長
count | バッファ数
extend | 拡張バッファ数

（凡例）

－：該当しない

オフライン中に変更できるシステムサービス共通情報定義の定義内容を次の表に示します。

表5-11　オフライン中に変更できるシステムサービス共通情報定義の定義内容

形式 | オペランド | 定義内容
set | max_socket_descriptors | ソケット用ファイル記述子の最大数
max_open_fds | MCF通信サービスまたはアプリケーション起動サービスでアクセスするファイルの最大数

(c)　ネットワークコミュニケーション定義の変更手順

ネットワークコミュニケーション定義は次の手順で変更します。

キューグループの入出力キュー定義を追加します。
メッセージキューサービス定義にキューグループを追加した場合，MCFマネジャ定義のソースファイルに，新たに使用するキューグループの入出力キュー定義を追加します。
キューグループquegrp3（ITQ）を追加する場合の例を次に示します。追加部分は下線で示しています。

表5-12　キューグループquegrp3（ITQ）の追加例

変更前
変更後

mcfmqgid -q "quekind=otq quegrpid=quegrp1"
mcfmqgid -q "quekind=itq quegrpid=quegrp2

mcfmqgid -q "quekind=otq quegrpid=quegrp1"
mcfmqgid -q "quekind=itq quegrpid=quegrp2"
mcfmqgid -q "quekind=itq quegrpid=quegrp3"

キューグループの入出力キュー定義を削除します。
メッセージキューサービス定義の変更でキューグループを削除した場合，MCFマネジャ定義のソースファイルから削除したキューグループに対応する入出力キュー定義を削除します。
キューグループquegrp2（ITQ）を削除する場合の例を次に示します。

表5-13　キューグループquegrp2（ITQ）の削除例

変更前
変更後

mcfmqgid -q "quekind=otq quegrpid=quegrp1"
mcfmqgid -q "quekind=itq quegrpid=quegrp2"
mcfmqgid -q "quekind=itq quegrpid=quegrp3"

mcfmqgid -q "quekind=otq quegrpid=quegrp1"
（削除）
mcfmqgid -q "quekind=itq quegrpid=quegrp3"

コネクションおよび論理端末を追加します。
MCF通信構成定義のプロトコル固有定義のソースファイルに，追加するコネクション・論理端末のコネクション定義および論理端末定義を追加します。
コネクションCN3，および論理端末LE3を追加する場合の例を次に示します。追加部分は下線で示しています。

表5-14　コネクションCN3，および論理端末LE3の追加例

変更前
変更後

mcftalccn -c CN1 …
mcftalcle -l LE1 ¥
         -k "quekind=disk quegrpid=quegrp1" …
mcftalced
mcftalccn -c CN2 …
mcftalcle -l LE2 ¥
         -k "quekind=disk quegrpid=quegrp1" …
mcftalced

mcftalccn -c CN1 …
mcftalcle -l LE1 ¥
         -k "quekind=disk quegrpid=quegrp1" …
mcftalced
mcftalccn -c CN2 …
mcftalcle -l LE2 ¥
         -k "quekind=disk quegrpid=quegrp1" …
mcftalced
mcftalccn -c CN3 …
mcftalcle -l LE3 ¥
         -k "quekind=disk quegrpid=quegrp1" …
mcftalced

コネクションおよび論理端末を削除します。
MCF通信構成定義のプロトコル固有定義のソースファイルから，削除するコネクション・論理端末のコネクション定義および論理端末定義を削除します。
コネクションCN2，および論理端末LE2を削除する場合の例を次に示します。

表5-15　コネクションCN2，および論理端末LE2の削除例

変更前
変更後

mcftalccn -c CN1 …
mcftalcle -l LE1 ¥
         -k "quekind=disk quegrpid=quegrp1" …
mcftalced
mcftalccn -c CN2 …
mcftalcle -l LE2 ¥
         -k "quekind=disk quegrpid=quegrp1" …
mcftalced
mcftalccn -c CN3 …
mcftalcle -l LE3 ¥
         -k "quekind=disk quegrpid=quegrp1" …
mcftalced

mcftalccn -c CN1 …
mcftalcle -l LE1 ¥
         -k "quekind=disk quegrpid=quegrp1" …
mcftalced
（削除）
・
・
（削除）
mcftalccn -c CN3 …
mcftalcle -l LE3 ¥
         -k "quekind=disk quegrpid=quegrp1" …
mcftalced

アプリケーション属性定義を追加します。
MCFアプリケーション定義のソースファイルに，追加するアプリケーションのアプリケーション属性定義を追加します。
アプリケーションAP3を追加する場合の例を次に示します。追加部分は下線で示しています。

表5-16　アプリケーションAP3の追加例

変更前
変更後

mcfaalccap -n "name=AP1" ¥
          -g "servgrpn=SG1 quekind=disk ¥
              quegrpid=quegrp2 …
mcfaalccap -n "name=AP2" ¥
          -g "servgrpn=SG1 quekind=disk ¥
              quegrpid=quegrp2 …

mcfaalccap -n "name=AP1" ¥
          -g "servgrpn=SG1 quekind=disk ¥
              quegrpid=quegrp2 …
mcfaalccap -n "name=AP2" ¥
          -g "servgrpn=SG1 quekind=disk ¥
              quegrpid=quegrp2 …
mcfaalccap -n "name=AP3" ¥
          -g "servgrpn=SG3 quekind=disk ¥
              quegrpid=quegrp3 …

アプリケーション属性定義を削除します。
MCFアプリケーション定義のソースファイルから，削除するアプリケーションのアプリケーション属性定義を削除します。なお，アプリケーションを削除する場合，サービスグループ単位で削除してください。複数のアプリケーションが一つのサービスグループに関連づけられている場合，一部のアプリケーションだけを削除できません。
一部のアプリケーションだけを削除して，MCF構成変更再開始によるオンライン開始をした場合，OpenTP1終了時にKFCA11002-Eメッセージを出力し，OpenTP1の終了処理がタイムアウトすることがあるので注意してください。
アプリケーションAP1，およびAP2のアプリケーション属性定義を削除する場合の例を次に示します。

表5-17　アプリケーションAP1，およびAP2の削除例

変更前
変更後

mcfaalccap -n "name=AP1" ¥
          -g "servgrpn=SG1 quekind=disk ¥
              quegrpid=quegrp2 …
mcfaalccap -n "name=AP2" ¥
          -g "servgrpn=SG1 quekind=disk ¥
              quegrpid=quegrp2 …
mcfaalccap -n "name=AP3" ¥
          -g "servgrpn=SG3 quekind=disk ¥
              quegrpid=quegrp3 …

（削除）
・
・
・
・
（削除）
mcfaalccap -n "name=AP3" ¥
          -g "servgrpn=SG3 quekind=disk ¥
              quegrpid=quegrp3 …

MCFマネジャ定義およびMCF通信構成定義のオプションまたはオペランドの指定値を変更します。
必要に応じて「(a)　ネットワークコミュニケーション定義の追加および削除できる定義内容」に示したMCFマネジャ定義，MCF通信構成定義のオプションおよびオペランドの指定値を変更します。
MCFマネジャ定義のオプションまたはオペランドの指定値を変更する場合の例を次に示します。変更部分は下線で示しています。

表5-18　MCFマネジャ定義のオプションおよびオペランドの指定値変更例

変更前
変更後

<MCFマネジャ定義>

mcfmcomn -n 100 -p 1000

mcfmexp -g 200 -l 100

<MCFマネジャ定義>

mcfmcomn -n 200 -p 2000

mcfmexp -g 300 -l 200

定義オブジェクトファイルを再作成し，$DCCONFPATHにコピーします。
変更したネットワークコミュニケーション定義に対応する定義生成ユティリティを使用して，定義オブジェクトファイルを再作成し，$DCCONFPATHにコピーします。MCFマネジャ定義オブジェクトファイルの再作成例を次に示します。

$ mcfmngr -i MCFマネジャ定義ソースファイル -o MCFマネジャ定義オブジェクトファイル
$ cp※ MCFマネジャ定義オブジェクトファイル $DCCONFPATH

注※

Windowsの場合，copyコマンドを使用します。

5.10.5　MCF構成変更再開始機能使用時のメッセージのバックアップとリストア

MCF構成変更再開始機能使用時のメッセージのバックアップとリストアについて説明します。

＜この項の構成＞

(1)　メッセージのバックアップ

(2)　メッセージのリストア

(1)　メッセージのバックアップ

OpenTP1が終了モード「MCF構成変更準備停止」でオンラインを停止した場合，TP1/Message Controlはディスクキューの入力キュー（ITQ）上の未処理受信メッセージと出力キュー（OTQ）上の未送信メッセージをシステムサービス共通情報定義で指定したファイルにバックアップします。

処理が完了したメッセージおよびメモリキューの未処理受信メッセージまたは未送信メッセージは，バックアップ対象になりません。

なお，MCF構成変更準備停止時のバックアップファイルは，未処理受信メッセージおよび未送信メッセージがない場合も作成されます。

未処理受信メッセージまたは未送信メッセージのバックアップの流れを次の図に示します。

図5-5　未処理受信メッセージまたは未送信メッセージのバックアップの流れ

(2)　メッセージのリストア

OpenTP1が開始モード「MCF構成変更再開始」でオンラインを開始した場合，TP1/Message Controlはシステムサービス共通情報定義で指定したファイルからメッセージを読み出し，バックアップしたときのキューグループにメッセージをリストアします。

未処理受信メッセージまたは未送信メッセージのリストアの流れを次の図に示します。

図5-6　未処理受信メッセージまたは未送信メッセージのリストアの流れ

オフライン中の構成変更によって，リストア先のキューグループが削除されている場合，TP1/Message Controlは該当するキューグループに格納されていたメッセージを破棄します。

削除したキューグループがある場合のメッセージのリストアの流れを次の図に示します。

図5-7　削除したキューグループがある場合のメッセージのリストアの流れ

また，オフライン中の構成変更によって，論理端末またはアプリケーションが削除されている場合，TP1/Message Controlは該当する論理端末の未送信メッセージやアプリケーションの未処理受信メッセージを破棄します。

削除した論理端末がある場合のメッセージのリストアの流れを次の図に示します。

図5-8　削除した論理端末がある場合のメッセージのリストアの流れ

削除したキューグループ，または論理端末がある場合，TP1/Message Controlはメッセージ破棄時にログメッセージを出力しません。また，破棄したメッセージに対応するエラーイベントは発生しません。

なお，アプリケーション起動プロセスのアプリケーション起動用論理端末定義（mcftalcle）を削除した場合，アプリケーションの起動による未処理受信メッセージが次回オンラインに引き継がれないことがあります。また，入力キューに滞留していた未処理受信メッセージが次回オンライン時に引き継がれたあと，MHP内でのアプリケーションの起動に失敗することがあります。

削除された論理端末から入力した未処理受信メッセージ，および削除したアプリケーションから出力した未送信メッセージは破棄しないで，MCF構成変更再開始によるオンライン再開始時に引き継がれます。不要なメッセージは，ユーザが削除してください。

5.10.6　MCF構成変更再開始機能使用時の障害対策

MCF構成変更再開始機能使用時の障害対策について，出力されるメッセージ別に説明します。

＜この項の構成＞

(1)　KFCA01861-Eメッセージが出力されたとき

(2)　KFCA11818-Eメッセージが出力されたとき

(3)　KFCA11819-Eメッセージが出力されたとき

(4)　KFCA11243-Eメッセージが出力されたとき

(5)　その他のエラーメッセージが出力されたとき

(1)　KFCA01861-Eメッセージが出力されたとき

KFCA01861-Eメッセージが出力されたときの障害の内容，OpenTP1の動作，および対処方法を次に示します。

障害の内容
TP1/Message Control - Extension 1がインストールされていません。

OpenTP1の動作

KFCA01861-Eメッセージが出力されます。

dcstopコマンドがエラーリターンします。

対処方法
TP1/Message Control - Extension 1のリリースノートに従って，OpenTP1環境にTP1/Message Control - Extension 1を組み込んでください。

(2)　KFCA11818-Eメッセージが出力されたとき

KFCA11818-Eメッセージが出力されたときの障害の内容，OpenTP1の動作，および対処方法を次に示します。

障害の内容
次のMCF構成変更準備停止中の障害です。

MCF構成変更準備停止時のバックアップファイルへのアクセス権がありません。

ディスク容量が不足しています。

メモリが不足しています。

キューファイルでI/Oエラーが発生しました。

OpenTP1の動作

KFCA11818-Eメッセージが出力されます。

OpenTP1が異常終了します。

対処方法
自システムおよびシステム定義を見直して障害要因を取り除いたあと，OpenTP1を起動してください。このとき，開始モードは再開始となります。
システムの構成変更は，MCF構成変更準備停止を再度実施し，オンラインが停止したあとに行ってください。

(3)　KFCA11819-Eメッセージが出力されたとき

KFCA11819-Eメッセージが出力されたときは，バックアップファイルの状態で，障害の内容や対処方法が異なります。それぞれのケースについて次に示します。

(a)　バックアップファイルが消失または破損したとき

バックアップファイルが消失または破損したときの障害の内容，OpenTP1の動作，および対処方法を次に示します。

障害の内容
MCF構成変更再開始中の障害です。
MCF構成変更準備停止時のバックアップファイルが消失または破損しました。

OpenTP1の動作

KFCA11819-Eメッセージが出力されます。

OpenTP1が異常終了します。

対処方法
次の手順で前回オンライン時の状態を回復してください。
なお，システムの構成変更は，MCF構成変更準備停止を再度実施し，オンラインが停止したあとに行ってください。

ユーザ側でバックアップしていたOpenTP1ファイルシステム，システムサービス定義，メッセージキューサービス定義およびネットワークコミュニケーション定義をリストアします。

コマンドラインからOpenTP1開始コマンド（UNIXの場合はdcstart -b，Windowsの場合はntbstart -b）を入力してください。このとき，開始モードは再開始となります。

(b)　バックアップファイルの消失および破損以外のとき

バックアップファイルの消失および破損以外の障害の内容，OpenTP1の動作，および対処方法を次に示します。

障害の内容
MCF構成変更再開始中の障害です。

MCF構成変更準備停止時のバックアップファイルへのアクセス権がありません。

メモリが不足しています。

キューファイルでI/Oエラーが発生しました。

OpenTP1の動作

KFCA11819-Eメッセージが出力されます。

OpenTP1が異常終了します。

対処方法
自システムおよびシステム定義を見直して障害要因を取り除いたあと，OpenTP1を起動してください。このとき，開始モードはMCF構成変更再開始となります。
なお，OpenTP1開始コマンドを入力する前にシステムの構成を変更できます。

(4)　KFCA11243-Eメッセージが出力されたとき

KFCA11243-Eメッセージが出力されたときの障害の内容，OpenTP1の動作，および対処方法を次に示します。

障害の内容
MCFマネジャ定義の出力通番使用論理端末数（mcfmcomn -n）の指定数が不足しています。

OpenTP1の動作

KFCA11243-Eメッセージが出力されます。

OpenTP1が異常終了します

対処方法
MCFマネジャ定義の出力通番使用論理端末数（mcfmcomn -n）の指定数を見直して障害要因を取り除いたあと，OpenTP1を起動してください。このとき，開始モードはMCF構成変更再開始となります。
なお，OpenTP1開始コマンドを入力する前にシステムの構成を変更できます。

(5)　その他のエラーメッセージが出力されたとき

(1)～(4)以外のエラーメッセージが出力されたときの障害の内容，OpenTP1の動作，および対処方法を次に示します。

障害の内容
(1)～(4)以外のMCF構成変更再開始中の障害が発生しました。

OpenTP1の動作

各種エラーメッセージが出力されます。

OpenTP1が異常終了します。

対処方法
システムの構成変更の有無に応じて次の作業を行ってください。
システムの構成変更をする場合

ユーザ側でバックアップしていたOpenTP1ファイルシステム，システムサービス定義，メッセージキューサービス定義，およびネットワークコミュニケーション定義をリストアします。

自システムおよびシステム定義を見直して障害要因を取り除いたあと，必要に応じてシステムの構成変更を行ってください。

OpenTP1を起動してください。このとき，開始モードはMCF構成変更再開始となります。

システムの構成変更をしない場合

ユーザ側でバックアップしていたOpenTP1ファイルシステム，システムサービス定義，メッセージキューサービス定義，およびネットワークコミュニケーション定義をリストアします。

コマンドラインからOpenTP1開始コマンド（UNIXの場合はdcstart -bコマンド，Windowsの場合はntbstart -bコマンド）を実行してください。このとき，開始モードは再開始となります。

6.　OpenTP1の付加機能の運用

OpenTP1の付加機能について説明します。

＜この章の構成＞

6.1　リソースマネジャに関する運用

6.1　リソースマネジャに関する運用

＜この節の構成＞

6.1.1　リソースマネジャの情報の表示

6.1.2　リソースマネジャの登録と削除

6.1.3　トランザクション制御用オブジェクトファイルの作成

6.1.4　リソースマネジャモニタの運用

6.1.5　リソースマネジャ起動待ち合わせ機能

6.1.6　トランザクションの回復待ち合わせ（Oracle9i RAC機能使用時）

6.1.7　オンライン前トランザクション回復機能

6.1.1　リソースマネジャの情報の表示

リンケージされているリソースマネジャの情報を確認するには，trnlsrmコマンドを使用します。trnlsrmコマンドを実行すると，OpenTP1，UAP，またはトランザクション制御用オブジェクトファイルにリンケージされているリソースマネジャの情報（リソースマネジャ名，属性，スイッチ名，オブジェクト名など）を標準出力に出力できます。

6.1.2　リソースマネジャの登録と削除

OpenTP1のプログラムプロダクトをインストールするときのトランザクションサービス制御用実行形式プログラム，およびクライアントサービス実行形式プログラムには，リソースマネジャが提供するXAインタフェース用オブジェクトファイルはリンケージされていません。dcsetupコマンド実行時，インストールされているOpenTP1のプログラムプロダクトを判断し，自動的にOpenTP1提供リソースマネジャ（DAM，TAM，MCF，ISAM，MQA）のXAインタフェース用オブジェクトファイルをリンケージします。そのため，OpenTP1下でそのほかのリソースマネジャを使用したトランザクションを実行する場合は，dcsetupコマンド実行後，OpenTP1を開始する前に，trnlnkrmコマンドでOpenTP1提供以外のリソースマネジャを登録する必要があります。trnlnkrmコマンドを実行すると，トランザクションサービス制御用実行形式プログラム，クライアントサービス実行形式プログラム，および標準トランザクション制御用オブジェクトファイルが再作成されます。なお，OpenTP1以外が提供するリソースマネジャを使用する場合については，マニュアル「OpenTP1 プログラム作成の手引」を参照してください。

トランザクションサービス制御用実行形式プログラム，およびクライアントサービス実行形式プログラムには，OpenTP1下で動作するUAPがアクセスする，すべてのリソースマネジャのXAインタフェース用オブジェクトファイルがリンケージされていなければなりません。トランザクションサービス制御用実行形式プログラム，およびクライアントサービス実行形式プログラムにリンケージされていないリソースマネジャのXAインタフェース用オブジェクトファイルをリンケージしているUAPは起動できないことがあります。

OpenTP1では，最大32個のリソースマネジャを登録できます。

OpenTP1下で実行されるトランザクションからアクセスしなくなったリソースマネジャを削除する場合，-D，または-dオプション指定のtrnlnkrmコマンドを使用します。-D，または-dオプション指定のtrnlnkrmコマンドを実行すると，トランザクションサービス制御用実行形式プログラム，およびクライアントサービス実行形式プログラムから指定したリソースマネジャのXAインタフェース用オブジェクトファイルを削除し，標準トランザクション制御用オブジェクトファイルを再び作成します。

trnlnkrmコマンドは，オフラインでだけ使用できます。

6.1.3　トランザクション制御用オブジェクトファイルの作成

OpenTP1下で動作するUAPがトランザクション内でリソースマネジャにアクセスする場合，そのUAPにトランザクション制御用オブジェクトファイルをリンケージする必要があります。

OpenTP1に登録されているすべてのリソースマネジャをアクセスするUAPの場合は，OpenTP1が提供する標準トランザクション制御用オブジェクトファイルのdc_trn_allrm.o（dcsetupコマンド実行時に作成され，trnlnkrmコマンド実行時に再作成される$DCDIR/spool/trnrmcmd/userobj下のファイル）をリンケージします。

OpenTP1に登録されている一部のリソースマネジャだけをアクセスするUAPの場合は，trnmkobjコマンドでトランザクション制御用オブジェクトファイルを作成して，UAPにリンケージします。

トランザクション内でリソースマネジャにアクセスしないUAPの場合は，トランザクション制御用オブジェクトファイルをリンケージする必要はありません。ただし，trnlnkrmコマンドでリソースマネジャの登録状態を変更した場合，標準トランザクション制御用オブジェクトファイルをリンケージしているUAPは，再びリンケージする必要があります。

ユーザは，OpenTP1を開始する前に，トランザクション制御用オブジェクトファイルと，リソースマネジャが提供するXAインタフェース用オブジェクトファイルをUAPにリンケージしてください。

トランザクション制御用オブジェクトファイルをリンケージしていないUAP，またはリソースマネジャが提供するXAインタフェース用オブジェクトファイルをリンケージしていないUAPは，UAP起動時，またはそのリソースマネジャが提供する関数発行時にエラーとなることがあります。

6.1.4　リソースマネジャモニタの運用

リソースマネジャモニタ（RMM）の機能を使用するには，プログラムプロダクトTP1/Resource Manager Monitorをインストールしておく必要があります。

＜この項の構成＞

(1)　監視対象リソースマネジャ用コマンド作成時の注意

(1)　監視対象リソースマネジャ用コマンド作成時の注意

監視対象リソースマネジャ用コマンドは，ユーザが作成し，監視対象RM定義で指定します。監視対象リソースマネジャ用コマンド作成時の注意事項を示します。

(a)　開始コマンド

開始コマンドは，次に示す条件を満たすように作成してください。

コマンド終了時には，終了コマンドを実行できる状態になっていること。

コマンド終了時には，すべての監視対象プロセスが起動を完了していること。

コマンド終了時には，監視対象リソースマネジャとして処理を監視できる状態になっていること。

exit()の終了コードが"0"の場合は正常終了し，"0"以外の場合は異常終了となること。

RMMサービスは開始コマンドの処理が終了するのを待って，exit()の終了コードが"0"の場合は正常終了，"0"以外の場合は異常終了と判断します。

なお，開始コマンドが正常終了しても，監視対象プロセスのプロセスIDの取得処理に失敗した場合，開始処理は失敗となります。また，OpenTP1が開始コマンドの終了を時間監視しているため，監視時間を超えた場合も開始処理は失敗となります。

(b)　終了コマンド

終了コマンドは，次に示す条件を満たすように作成してください。

コマンド終了時には，開始コマンドを実行できる状態になっていること。

コマンド終了時には，すべての監視対象プロセスが終了していること。

コマンド終了時には，監視対象リソースマネジャのシステムリソースを解放していること。

exit()の終了コードが"0"の場合は正常終了し，"0"以外の場合は異常終了となること。

RMMサービスは終了コマンドの処理が終了するのを待って，exit()の終了コードが"0"の場合は正常終了，"0"以外の場合は異常終了と判断します。

なお，終了コマンドが正常終了しても，監視対象プロセスがまだある場合は，終了処理は失敗となります。また，OpenTP1が終了コマンドの終了を時間監視しているため，監視時間を超えた場合も終了処理は失敗となります。

(c)　強制停止コマンド

強制停止コマンドは，次に示す条件を満たすように作成してください。

コマンド終了時には，開始コマンドを実行できる状態になっていること。

コマンド終了時には，監視対象リソースマネジャのシステムリソースを解放していること。

exit()の終了コードが"0"の場合は正常終了し，"0"以外の場合は異常終了となること。

強制停止コマンドは，監視対象プロセスがない状態でも実行できます。

RMMサービスは強制停止コマンドの処理が終了するのを待って，exit()の終了コードが"0"の場合は正常終了，"0"以外の場合は異常終了と判断します。

なお，強制停止コマンドが正常終了しても，監視対象プロセスがまだある場合は，強制停止処理は失敗となります。また，OpenTP1が強制停止コマンドの終了を時間監視しているため，監視時間を超えた場合も強制停止処理は失敗となります。

(d)　監視対象プロセスID取得コマンド

監視対象プロセスID取得コマンドの作成
監視対象プロセスID取得コマンドは，次に示す条件を満たすように作成してください。

すべての監視対象プロセスのプロセスIDを標準出力に出力すること。

プロセスIDの出力形式は，次の図に示すようにすること。

図6-1　プロセスIDの出力形式

exit()の終了コードによって，次の状態をRMMサービスに連絡できること。
0：監視対象リソースマネジャはすでに処理中です。
1：監視対象リソースマネジャは正常な状態ではありません。
2：監視対象リソースマネジャは停止中です。

RMMでは，監視対象プロセスID取得コマンドのモデルとなるコマンドを，rmmoraidとして提供しています。rmmoraidコマンドは次に示す条件を満たすように作成されています。

すべての監視対象プロセスのプロセスIDを標準出力に出力します。

出力形式は，図6-1に従います。

プロセス名をコマンド中に記述すれば，そのプロセスのプロセスIDを，/bin/psを使用して取得します。

exit()の終了コードの意味を次に示します。
0：監視対象プロセスIDをすべて取得しました。
1：監視対象プロセスIDが一部ありません。
2：監視対象プロセスIDが全部ありません。

監視対象リソースマネジャの再起動
監視対象リソースマネジャに，障害時の自動全面回復機能がある場合は，RMMサービスでその監視対象リソースマネジャを再起動させる必要はありません。障害時は，その監視対象リソースマネジャの機能で自動的に全面回復します。プロセスID取得コマンドの標準出力の最初に0を出力してください。これによってRMMサービスが，監視対象リソースマネジャの全面回復をすることはありません。
監視対象リソースマネジャの機能で自動全面回復する場合，次の条件を満たしてください。

監視対象のプロセスは一つだけ

exit()の終了コードは0または2

プロセスID取得コマンドのexit()の終了コード0で終了したとき，RMMサービスは監視対象リソースマネジャの自動全面回復終了と判断します。
プロセスID取得コマンドの標準出力の出力形式を次の図に示します。

図6-2　プロセスID取得コマンドの標準出力の出力形式

(e)　そのほか

RMMサービスでは，ORACLE用の定義に使用できる，次の四つのコマンドを用意しています。
　開始コマンド：$DCDIR/etc/RMmonitor/rmmorast
　終了コマンド：$DCDIR/etc/RMmonitor/rmmorasp
　強制停止コマンド：$DCDIR/etc/RMmonitor/rmmoraab
　プロセスID取得コマンド：$DCDIR/etc/RMmonitor/rmmoraid
これらのコマンドは，すべてボーンシェルによってシェルスクリプトで実現されます。これらの変更可能領域には"＃　CHANGEABLE"と書かれていますので，それらの行を各環境に合わせて変更，記述してください。

RMMサービスでは，HiRDB（シングルモード）の定義に使用できる，次の四つのコマンドを用意しています。
　開始コマンド：$DCDIR/etc/RMmonitor/rmmhirst
　終了コマンド：$DCDIR/etc/RMmonitor/rmmhirsp
　強制停止コマンド：$DCDIR/etc/RMmonitor/rmmhirab
　プロセスID取得コマンド：$DCDIR/etc/RMmonitor/rmmhirid
これらのコマンドは，すべてボーンシェルによってシェルスクリプトで実現されます。これらの変更可能領域には"＃　CHANGEABLE"と書かれていますので，それらの行を各環境に合わせて変更，記述してください。

HiRDBは，障害時の自動全面回復機能があります。プロセスID取得コマンドの標準出力の最初に0を出力してください。障害時は，HiRDBが全面回復します。

作成されたシェルスクリプトは，RMMサービスによってfork&execされるため，通常のシェルから実行される場合と，次の七つの点で異なります。

環境変数として，次の変数があらかじめ設定されています。
DCSVNAME："_rmm"（変更不可）
DCDIR：OpenTP1に対して設定したもの（変更不可）
DCCONFPATH：OpenTP1に対して設定したもの（変更不可）
LANG：OpenTP1に対して設定したもの（変更可）
TZ：OSのデフォルト値（変更可）
PATH：プロセスサービス定義のprcsvpathの指定に従う（変更可）

カレントディレクトリは$DCDIR/tmp/home/_rmm.×××（×××はRMMサービスのプロセスID）です。

プロセスの標準入力，標準出力，および標準エラー出力はコンソールです。

ユーザID，およびグループIDは，監視対象RM定義に従います。

制御端末はありません。

umaskは000です。

シグナル受信時の動作はすべてOSのデフォルトのものです。

上記の内容は，シェルスクリプト中で使用するコマンド，および起動されるプロセスに対して影響します。上記の内容に関して設定値以外のものにしたい場合は，シェルスクリプト中，またはユーザが用意したコマンド中で，変更してください。

6.1.5　リソースマネジャ起動待ち合わせ機能

OpenTP1以外が提供するリソースマネジャ（非同期RM）は，OpenTP1と同期を取らないで起動・停止できます。XAインタフェースでアクセスする非同期RMが未起動の状態でOpenTP1を起動し，その非同期RMにアクセスするユーザサーバを実行した場合，xa_open関数エラーとなりユーザサーバの異常終了や閉塞が発生することがあります。特に，上記のユーザサーバを自動起動（OpenTP1起動時に指定されたユーザサーバを起動する機能）する場合，その可能性が高くなります。

このような現象を回避するには，非同期RMの起動を完了させたあと，OpenTP1を起動するという運用をする必要があります。この機能は，OpenTP1起動時にOpenTP1に登録された非同期RMの起動を確認し，未起動の場合には全非同期RMが起動されるまでOpenTP1を中断状態とする機能です。この機能を使用することによって，システム開始時にOpenTP1と非同期RMとの起動のタイミングを意識する必要がなくなり，システム運用の負担を軽減できます。

非同期RMの起動確認は，非同期RMが提供するxa_open関数が正常終了するかしないかで判断します。したがって，未起動状態でもxa_open関数が正常終了する非同期RMとの起動待ち合わせはできません。

＜この項の構成＞

(1)　使用方法

(2)　注意事項

(1)　使用方法

この機能は，トランザクションサービス定義にtrn_wait_rm_openオペランドを指定することで使用できるようになります。未起動非同期RMの起動確認をリトライする回数，およびインタバルを指定できます。

(2)　注意事項

この機能によって起動待ち合わせができるリソースマネジャは，trnlnkrmコマンドでOpenTP1システムに登録したOpenTP1以外が提供するリソースマネジャだけです。

トランザクションサービス定義のtrn_wait_rm_openオペランドにstopまたはretry_stopを指定したシステムで，起動待ち合わせ対象のリソースマネジャが障害などで起動できなくなった場合は，OpenTP1システムも起動（リラン）できなくなります。リソースマネジャの起動を中止してOpenTP1を起動する場合は，trn_wait_rm_openオペランドの指定値をcontinueまたはretry_ continueに変更し，OpenTP1システムを再起動してください。リトライ中に開始処理を中止する場合は，dcstop -fコマンドでOpenTP1システムを強制停止してください。

非同期RMの起動確認は，非同期RMが提供するxa_open関数が正常終了するかしないかで判断します。したがって，未起動状態でもxa_open関数が正常終了する非同期RMとの起動待ち合わせはできません。

トランザクションサービス定義のtrn_wait_rm_openオペランドにretry_continueまたはretry_stopを指定し，非同期RMのxa_open関数エラーが発生した場合，trn_retry_interval_rm_openオペランドで指定したインタバルで，trn_retry_count_rm_openオペランドで指定した回数だけ，未起動非同期RMのxa_open関数を発行します。したがって，実際のxa_open関数発行のリトライ間隔は，「全未起動非同期RMのxa_open関数処理時間＋trn_retry_interval_rm_openオペランド指定時間」となります。

HiRDBの起動待ち合わせをする場合は，HiRDB 02-05-/G以降を使用してください。

6.1.6　トランザクションの回復待ち合わせ（Oracle9i RAC機能使用時）

Oracle9i RAC※機能を使用した場合，異常終了時には，障害が発生した運用系サーバから，待機系サーバへインダウトトランザクション（未決着トランザクション情報）が転送されます。このとき，インダウトトランザクションの転送処理に時間が掛かると，Oracle9iの仕様上，OpenTP1とOracle9iの間でトランザクション決着種別が不一致になることがあります。

このため，インダウトトランザクションの転送処理を行っている間，OpenTP1のトランザクション回復処理を待ち合わせることで，トランザクションの決着種別の不一致を回避します。

注※

RACとは，Real Application Clustersの略で，共有ディスクにある一つのデータベースを複数ノードで共用して処理するクラスタシステムのことです。

＜この項の構成＞

(1)　使用方法

(2)　注意事項

(1)　使用方法

Oracle9i RAC機能を使用する場合には，トランザクションサービス定義のtrnstring定義コマンドで-rオプションを指定し，OpenTP1のトランザクションの回復を待ち合わせます。なお，trnstring定義コマンドの-rオプションを有効にするには，オープン文字列に"OPS_FAILOVER=T"を指定する必要があります。

trnstring定義コマンドの-rオプションを指定する場合，リソースマネジャからの応答を待ち合わせるので，トランザクション回復プロセスが占有されます。したがって，トランザクション並行回復プロセス数（trn_recovery_process_countオペランドの指定値）をtrnstring定義コマンドの-rオプションで指定したリソースマネジャ数分増やしてください。トランザクション並行回復プロセス数を増やさなかった場合には，トランザクション回復処理に影響を及ぼすことがあります。

(2)　注意事項

トランザクションの回復処理を待ち合わせた場合に，開始処理中，またはオンライン処理中にリソースマネジャに障害が発生すると，そのリソースマネジャが参加したトランザクションの該当リソースマネジャの障害が回復されるまで，トランザクション回復処理が遅れます。

トランザクションサービス定義に指定するtrnstring定義コマンドの-rオプションは再開始時に変更，または削除できます。詳細については，マニュアル「OpenTP1 システム定義」のシステムサービス定義や，再開始時に変更できる定義についての説明を参照してください。

6.1.7　オンライン前トランザクション回復機能

OpenTP1では，トランザクションを回復する場合は，全面回復による再開始時に，ジャーナルを基にしてOpenTP1内で管理しているトランザクションの決着処理をしています。

オンライン前トランザクション回復機能は，OpenTP1開始時に（正常開始，再開始に関係なく），トランザクションサービス定義のtrnstring定義コマンドの-mオプションで指定したリソースマネジャから未決着トランザクション情報を取得し，OpenTP1がオンラインになる前に回復処理をする機能です。

この機能を使用すると，リソースマネジャからの未決着トランザクション情報がなくなるまで，トランザクションサービス定義のtrn_start_recovery_intervalオペランドに指定した間隔時間で回復処理が繰り返されます。このため，リソースマネジャからの未決着トランザクション情報がなくなるまでは，OpenTP1はオンライン状態にはなりません。

＜この項の構成＞

(1)　使用方法

(2)　注意事項

(1)　使用方法

この機能を使用するには，trnlnkrmコマンドでOpenTP1システムにリソースマネジャを再登録し，トランザクションサービス定義のtrnstring定義コマンドに-mオプションを指定します。詳細については，マニュアル「OpenTP1 システム定義」のトランザクションサービス定義の説明を参照してください。

(2)　注意事項

trnstring定義コマンドに指定できるのは，trnlnkrmコマンドでOpenTP1システムに登録したリソースマネジャだけです。

xa_recover関数がすぐにリターンしないリソースマネジャが存在した場合，トランザクション決着が遅れることがあります。

7.　マルチノード機能使用時の運用

マルチノード機能使用時のOpenTP1の環境設定とその手順，開始方法と終了方法，ノードの状態の表示方法，グローバルジャーナルの運用方法について説明します。

＜この章の構成＞

7.1　OpenTP1の環境設定

7.2　OpenTP1の開始と終了

7.3　OpenTP1ノードの状態表示

7.4　グローバルジャーナルに関する運用

7.1　OpenTP1の環境設定

マルチノード機能使用時の環境設定について説明します。環境設定は説明の順に行ってください。

＜この節の構成＞

7.1.1　OpenTP1管理者の登録

7.1.2　OpenTP1グループの設定

7.1.3　OpenTP1のインストール

7.1.4　OpenTP1ディレクトリの作成

7.1.5　システム定義の作成

7.1.6　OpenTP1のOSへの登録

7.1.7　OpenTP1ファイルシステム領域の作成

7.1.8　OpenTP1の内部制御用資源の確保

7.1.9　OpenTP1管理者の環境設定

7.1.10　OpenTP1ファイルシステムの初期設定

7.1.11　OpenTP1ファイルの作成

7.1.12　OpenTP1ファイル以外のファイルの作成

7.1.1　OpenTP1管理者の登録

スーパユーザが，OpenTP1管理者のユーザIDをOSに登録します。

ログイン名称，ユーザID，グループID，ホームディレクトリ，ログインシェルを，すべて任意に設定します。

ユーザIDの登録後，必ずパスワードを設定してください。

OpenTP1管理者には，次の権限が与えられます。

OpenTP1の各種システムファイルやディレクトリとしてのアクセス権が与えられ，ほかのユーザからの書き込みを禁止できます。

OpenTP1の構成変更を伴うような運用コマンドを実行できます。

7.1.2　OpenTP1グループの設定

スーパユーザが，OpenTP1専用のグループを設定します。

OpenTP1グループを設定すると，グループ以外のユーザによるファイルのアクセスを制限できるので，OpenTP1の機密保護を強化できます。

7.1.3　OpenTP1のインストール

スーパユーザが，OpenTP1のプログラムプロダクトをインストールします。すべてのOpenTP1ノードにTP1/Server BaseとTP1/Multiをインストールしてください。

OpenTP1インストールディレクトリは，ご使用のOSによって異なります。

7.1.4　OpenTP1ディレクトリの作成

スーパユーザが，OpenTP1ディレクトリを作成します。OpenTP1ディレクトリ名長は，ご使用のOSによって異なります。

OpenTP1ディレクトリにシンボリックリンクは使用できません。

OpenTP1ディレクトリだけで一つのパーティションを割り当ててください。そのパーティションは，ほかのプログラムで使用しないでください。ほかのプログラムがOpenTP1ディレクトリのパーティションにファイルを作成して，ディスク容量およびiノード数を圧迫した場合，OpenTP1の動作に支障が出ることがあります。

所有者，グループおよびモードを次のように指定します。

所有者：OpenTP1管理者

グループ：OpenTP1グループ

モード：0755

7.1.5　システム定義の作成

OpenTP1管理者が，OpenTP1のシステム定義を作成します。システム定義は，スーパユーザがOpenTP1をOSに登録する前に作成してください。

システム定義は，グローバルアーカイブジャーナルサービスがあるノード（以降，アーカイブジャーナルノードと呼ぶ）と，アーカイブジャーナルノードによってアーカイブされるノード（以降，被アーカイブジャーナルノードと呼ぶ）では，内容が異なります。

システム定義については，マニュアル「OpenTP1 システム定義」を参照してください。

7.1.6　OpenTP1のOSへの登録

スーパユーザが，OpenTP1のdcsetupコマンドを使用して，OpenTP1をOSへ登録します。この作業は，OpenTP1管理者がシステム定義を作成したあとで行ってください。

7.1.7　OpenTP1ファイルシステム領域の作成

OpenTP1ファイルシステムは，キャラクタ型スペシャルファイル上，または通常ファイル上に作成できます。

OpenTP1ファイルシステムをキャラクタ型スペシャルファイル上に作成する場合は，OpenTP1ファイルシステム用にディスクパーティションを割り当てます。このパーティションは，マウントしないでください。通常ファイル上に作成する場合は，ディスクパーティションを割り当てる必要はありません。

被アーカイブジャーナルノードには，システム用とユーザ用の2種類のOpenTP1ファイルシステムを作成します。そのため，OpenTP1ファイルシステムをキャラクタ型スペシャルファイル上に作成する場合は，システム用とユーザ用の2種類のディスクパーティションを割り当てます。アーカイブジャーナルノードには，ユーザ用のOpenTP1ファイルシステムは必要ありません。

OpenTP1ファイルシステムを作成したキャラクタ型スペシャルファイルや通常ファイルを，OpenTP1ファイルシステム領域といいます。

権限のないユーザがOpenTP1ファイルシステム領域をアクセスしないようにするために，OpenTP1ファイルシステム領域の所有者とアクセス権は，次の表に示すように設定してください。所有者とアクセス権は，OSのコマンドで設定します。

表7-1　OpenTP1ファイルシステム領域の所有者とアクセス権

OpenTP1ファイルシステム領域
所有者
アクセス権

ユーザID
グループID
所有者
グループ
そのほか

システム用
OpenTP1管理者
OpenTP1グループ
rw
（読み書きができる）
r-
（読むことができる）
r-
（読むことができる）

ユーザ用
OpenTP1管理者
OpenTP1グループ
rw
（読み書きができる）
rw
（読み書きができる）
r-
（読むことができる）

注

システム用とユーザ用を同一のOpenTP1ファイルシステム領域に割り当てることもできます。その場合，アクセス権はユーザ用にしてください。

7.1.8　OpenTP1の内部制御用資源の確保

OpenTP1が内部制御用に使用するOSの資源を確保するには，dcmakeupコマンドを使用します。dcmakeupコマンドを実行すると，資源を確保し，OpenTP1ディレクトリ下に格納します。確保する資源の数は，OpenTP1ディレクトリ下のシステム定義から解析します。

プロセスサービス定義のprc_process_countオペランドの値を変更した場合は，dcsetupコマンドを実行したあと，dcstartコマンドを実行する前に，必ずdcmakeupコマンドを実行してください。

dcmakeupコマンドを実行しなかった場合，OpenTP1の開始処理でこのコマンドの処理が実行されますが，十分な数の資源を確保するのに時間が掛かることがあります。

7.1.9　OpenTP1管理者の環境設定

OpenTP1のコマンドを実行するために，ログイン環境に次の環境変数を設定してください。

DCDIR

OpenTP1ディレクトリを完全パス名で指定します。DCDIRに設定するディレクトリ名は，50バイト以内で指定してください。OpenTP1ディレクトリにシンボリックリンクは使用できません。

DCCONFPATH

OpenTP1定義ファイルを格納するディレクトリの完全パス名を246バイト以下で指定します。

DCUAPCONFPATH

OpenTP1ユーザサービス定義ファイルまたはユーザサービスデフォルト定義ファイルをDCCONFPATH環境変数で設定したディレクトリとは別のディレクトリに格納したい場合，そのディレクトリの完全パス名を246バイト以下で指定します。

PATH

$DCDIR/binをPATHに加えます。

7.1.10　OpenTP1ファイルシステムの初期設定

OpenTP1管理者は，filmkfsコマンドでOpenTP1ファイルシステムを初期設定します。

7.1.11　OpenTP1ファイルの作成

OpenTP1管理者は，filmkfsコマンドで初期設定したOpenTP1ファイルシステム上に，次の表に示すOpenTP1ファイルを作成，初期設定します。

表7-2　作成，初期設定するOpenTP1ファイルと使用する運用コマンド

ノード | OpenTP1 | 運用コマンド | OpenTP1ファイルシステム領域 | 備考
アーカイブジャーナルノード | ステータスファイル | stsinit | システム用 | ノード内に必須
アーカイブジャーナルファイル | jnlinit
被アーカイブジャーナルノード | ステータスファイル | stsinit | システム用 | ノード内に必須
ジャーナル関係のファイル | システムジャーナルファイル | jnlinit
チェックポイントダンプファイル | jnlinit
ノードリストファイル | namnlcre | ノード内に任意
メッセージキューファイル | queinit | ユーザ用 | ノード内に任意※
DAMファイル | damload | ノード内に任意
TAMファイル | tamcre | ノード内に任意

注

ISAMファイルを使用する場合は，マニュアル「索引順編成ファイル管理 ISAM」を参照してください。

注※

MCFを使用する場合に必要です。

7.1.12　OpenTP1ファイル以外のファイルの作成

OpenTP1を実行するためには，OpenTP1ファイル以外に次に示すOSのファイルが必要です。

＜この項の構成＞

(1)　ユーザが作成するファイル

(2)　インストール時，またはOSへの登録時に作成されるファイルとディレクトリ

(3)　OpenTP1実行時に作成されるファイルとディレクトリ

(1)　ユーザが作成するファイル

ユーザが作成するファイルを次に示します。

ユーザプログラムファイル
UAPの実行形式プログラムを格納するファイルです。
アーカイブジャーナルノードでは必要ありません。

MCF通信プロセスプログラムファイルおよびMCFアプリケーション起動プロセスプログラムファイル
メッセージ制御機能を使用する場合に，作成するMCF通信プロセスの実行形式プログラムおよびMCFアプリケーション起動プロセスの実行形式プログラムを格納するファイルです。

各種定義ファイル
OpenTP1の各種定義を格納するファイルです。
定義ファイルは，OSのテキストエディタを使用して，テキストファイルとして作成します。

上記のファイルをユーザが作成するディレクトリ下に作成します。

ユーザが作成するファイルとディレクトリを次の表に示します。表中のディレクトリ$DCDIR/aplib，および$DCDIR/confは，OpenTP1のインストール時に作成されます。

表7-3　ユーザが作成するファイルとディレクトリ

ファイル | ディレクトリ | ファイル名 | ファイル種別
ユーザプログラムファイル | $DCDIR/aplib/※¹ | 実行形式プログラム名※² | 実行形式ファイル
MCF通信プロセスプログラムファイル，MCFアプリケーション起動プロセスプログラムファイル | $DCDIR/lib/servers/ | 実行形式プログラム名 | 実行形式ファイル
各種定義ファイル | システム環境定義 | $DCDIR/conf | env | テキストファイル
システム環境定義以外の定義 | $DCCONFPATH/ | 定義ファイル名
システムサービス情報定義 | $DCDIR/lib/sysconf/ | システムサービス情報定義ファイル名
システムサービス共通情報定義※³ | $DCDIR/lib/sysconf/ | mcf

注※1

プロセスサービス定義で変更できます。

注※2

ユーザサービス定義で変更できます。

注※3

インストール時またはOSへの登録時に作成されるファイルですが，動作環境によっては定義内容の変更が必要なファイルです。

(2)　インストール時，またはOSへの登録時に作成されるファイルとディレクトリ

OpenTP1のインストール時，またはOSへの登録時に作成されるファイルとディレクトリを次の表に示します。

表7-4　インストール時，またはOSへの登録時に作成されるファイルとディレクトリ

名称
ディレクトリ
ファイル名

OpenTP1プログラムファイル
OpenTP1サーバ
$DCDIR/lib/servers/
－※

コマンド
$DCDIR/bin/
－

ヘッダファイル
$DCDIR/include/
－

アーカイブファイル
$DCDIR/lib/
－

定義解析用ファイル
$DCDIR/lib/sysconf/
－※

$DCDIR/lib/sysdef/
－

メッセージオブジェクトファイル
$DCDIR/lib/
emsgtxt，jmsgtxt

ユーザプログラムファイルディレクトリ
$DCDIR/aplib/
なし

各種定義ファイルディレクトリ
$DCDIR/conf/
なし

システム管理情報ディレクトリ
$DCDIR/etc/
－

退避コアファイルディレクトリ
$DCDIR/spool/save/
なし

コマンドログディレクトリ
$DCDIR/spool/cmdlog/
－

デッドロック情報ファイルディレクトリ
$DCDIR/spool/dclckinf/
なし

トランザクション情報ディレクトリ
$DCDIR/spool/dctrninf/
なし

ジャーナル情報ディレクトリ
$DCDIR/spool/dcjnlinf/errinf/
なし

プロセスサービス情報ディレクトリ
$DCDIR/spool/dcprcinf/
なし

トランザクションジャーナルディレクトリ
$DCDIR/spool/dctjlinf/
－

サーバリカバリジャーナルディレクトリ
$DCDIR/spool/dcsjl/
－

トランザクション制御用オブジェクト格納
ディレクトリ
$DCDIR/spool/trnrmcmd/userobj/
dc_trn_allrm.o

オンラインテスタ用ディレクトリ
$DCDIR/spool/uto/
なし

システム内部排他制御用ディレクトリ
$DCDIR/spool/olkfifs/
－

システム内部同期制御用ディレクトリ
$DCDIR/spool/olkrsfs/
－

（凡例）

－：ユーザは指定する必要がないことを示します。

注

アーカイブジャーナルノードでは，使用されないものがあります。

注※

MCFを使用する場合は，ファイルの作成が必要です。

(3)　OpenTP1実行時に作成されるファイルとディレクトリ

OpenTP1実行時に動的に作成されるファイルとディレクトリを次の表に示します。

表7-5　OpenTP1実行時に作成されるファイルとディレクトリ（マルチノード機能使用時）

名称
ディレクトリ
ファイル名
ノード1※¹
ノード2※²

メッセージログファイル
$DCDIR/spool/
dclog1，およびdclog2
○
○

MCFトレースファイル※³
$DCDIR/spool/
mcftAXXZZ※⁴
×
○

スケジュールキュー情報ファイル
$DCDIR/spool/
scdqid1，およびscdqid2
×
○

RPCトレースファイル
$DCDIR/spool/
rpctr1，およびrpctr2※⁵
○
○

トレース情報ダンプファイル
$DCDIR/spool/save/
dcmtrdp1，およびdcmtrdp2
○
○

性能検証用トレース情報ファイル
$DCDIR/spool/dcprfinf/
prf_001，prf_002，およびprf_003
○
○

性能検証用トレース情報ファイルのバックアップファイル
$DCDIR/spool/save/
prf_nnn.bk1※6，およびprf_nnn.bk2※6
○
○

XAR性能検証用トレース情報ファイル
$DCDIR/spool/dcxarinf/
_xr_nnn※7
○
○

XAR性能検証用トレース情報ファイルのバックアップファイル
$DCDIR/spool/save/
_xr_nnn.bk1※6，および_xr_nnn.bk2※6
○
○

JNL性能検証用トレース情報ファイル
$DCDIR/spool/dcjnlinf/prfinf/
_jl_nnn※7
○
○

JNL性能検証用トレース情報ファイルのバックアップファイル
$DCDIR/spool/save/
_jl_nnn.bk1※6，および_jl_nnn.bk2※6
○
○

LCK性能検証用トレース情報ファイル
$DCDIR/spool/dclckinf/prf/
_lk_nnn※7
○
○

LCK性能検証用トレース情報ファイルのバックアップファイル
$DCDIR/spool/save/
_lk_nnn.bk1※6，および_lk_nnn.bk2※6
○
○

MCF性能検証用トレース情報ファイル
$DCDIR/spool/dcmcfinf/
_mc_nnn※7
○
○

MCF性能検証用トレース情報ファイルのバックアップファイル
$DCDIR/spool/save/
_mc_nnn.bk1※6，および_mc_nnn.bk2※6
○
○

TRNイベントトレース情報ファイル
$DCDIR/spool/dctrninf/trace/prf/
_tr_nnn※⁷
○
○

TRNイベントトレース情報ファイルのバックアップファイル
$DCDIR/spool/save/
_tr_nnn.bk1※6，および_tr_nnn.bk2※6
○
○

NAMイベントトレース情報ファイル
$DCDIR/spool/dcnaminf/
_nm_001，_nm_002，および_nm_003
○
○

NAMイベントトレース情報ファイルのバックアップファイル
$DCDIR/spool/save/
_nm_nnn.bk1※6，および_nm_nnn.bk2※6
○
○

プロセスサービスイベントトレース情報ファイル
$DCDIR/spool/dcprcinf/
_pr_001，_pr_002，および_pr_003
○
○

プロセスサービスイベントトレース情報ファイルのバックアップファイル
$DCDIR/spool/save/
_pr_nnn.bk1※6，および_pr_nnn.bk2※6
○
○

FILイベントトレース情報ファイル
$DCDIR/spool/dcfilinf/
_fl_001，_fl_002，および_fl_003
○
○

FILイベントトレース情報ファイルのバックアップファイル
$DCDIR/spool/save/
_fl_nnn.bk1※6，および_fl_nnn.bk2※6
○
○

RTSログファイル
$DCDIR/spool/dcrtsinf/※8
rtslog[1～10]※8，※9
○
○

MCF稼働統計情報ファイル
$DCDIR/spool/※¹⁰
mcfstc※¹⁰
×
○

カレントワーキングディレクトリ※¹¹
$DCDIR/tmp/home/サーバ名.ID※¹²/
－
○
○

UAPトレースデータファイル
$DCDIR/tmp/home/サーバ名.ID/
dcuat.map※13
○
○

UAPトレースデータファイルのバックアップファイル
$DCDIR/spool/save/trc/※14
サーバ名n.uatmap※15，およびサーバ名_n.uatmap※15
○
○

共用メモリダンプファイル
$DCDIR/spool/

Linuxの場合

shmdump[1～3].gz，およびshmdump.XXX※16[1～3].gz

その他の場合

shmdump[1～3].Z，およびshmdump.XXX※16[1～3].Z

○
○

退避コアファイル
$DCDIR/spool/save/※¹⁷
サーバ名n※¹⁸
○
○

デッドロック，タイムアウト情報ファイル
$DCDIR/spool/dclckinf/
ファイル名※¹⁹
×
○

MCFダンプファイル※³
$DCDIR/spool/
mcfdKAXXZZ※²⁰
×
○

MCF共用メモリダンプファイル※³
$DCDIR/spool/
mcfsAXXY※²¹
×
○

未決着トランザクション情報ファイル
$DCDIR/spool/dctrninf/
ファイル名※²²
×
○

アーカイブジャーナルノードの不正ジャーナル情報ファイル
$DCDIR/spool/dcjnlinf/errinf/
an_X※²³
○
×

被アーカイブジャーナルノードの不正ジャーナル情報ファイル
$DCDIR/spool/dcjnlinf/errinf/
r_n※²⁴
×
○

入出力キューの内容複写ファイル
$DCDIR/spool/
ファイル名※²⁵
×
○

UAPトレース編集出力ファイル
$DCDIR/spool/save/
サーバ名n※¹⁶.uat
×
○

OpenTP1デバッグ情報ファイル
$DCDIR/spool/save/
サーバ名n※¹⁶.deb
○
○

（凡例）

○：作成されます。

×：作成されません。

－：ユーザは指定する必要がないことを示します。

注※1

アーカイブジャーナルノード

注※2

被アーカイブジャーナルノード

注※3

MCFを使用するときだけ必要です。

注※4

AXXZZ：

AXX：MCF識別子

A：MCFマネジャ定義の，mcfmenv定義コマンドの-mオプションのidオペランドで指定したMCFマネジャプロセス識別子

XX：MCF通信構成定義の，mcftenv定義コマンドの-sオプションで指定したMCF通信プロセス識別子

ZZ：トレーススワップファイル識別子

注※5

ファイル名はシステム共通定義で変更できます。

注※6

nnn：バックアップ元のファイル名に対応した値です。

注※7

nnn：それぞれ，次に示す定義のprf_file_countオペランドで指定した値を上限とした001から始まる値です。

性能検証用トレース：性能検証用トレース定義

XAR性能検証用トレース：XAR性能検証用トレース定義

JNL性能検証用トレース：JNL性能検証用トレース定義

LCK性能検証用トレース：LCK性能検証用トレース定義

MCF性能検証用トレース：MCF性能検証用トレース定義

TRNイベントトレース：TRNイベントトレース定義

注※8

リアルタイム統計情報サービス定義のrts_log_file_nameオペランドの指定を省略した場合，このディレクトリにRTSログファイルが作成されます。

注※9

リアルタイム統計情報サービス定義のrts_log_file_countオペランドに指定した値分ファイルを作成します。

注※10

運用コマンド（mcfstats）で出力ファイル名を省略したとき，このディレクトリにこのファイルが作成されます。

注※11

カレントワーキングディレクトリはシステム共通定義のprc_current_work_pathオペランドを設定することによって変更できます。

注※12

ユーザ環境設定コマンドの場合，サーバ名は，’_usrcmd’と表示されます。

IDは1以上の通番です。ただし，運用コマンド（dcstart，dcstop，dcsvstart，およびdcsvstop），およびユーザ環境設定コマンドには，’.ID’は付きません。

注※13

uap_trace_file_putオペランドにYを指定した場合だけ，このファイルが作成されます。uap_trace_file_putオペランドは，次のどれかの定義で指定します。

システム共通定義

ユーザサービスデフォルト定義

ユーザサービス定義

注※14

プロセスサービス定義のprc_coresave_pathオペランドを指定している場合，ディレクトリは，「（prc_coresave_path指定値）/trc/」となります。

注※15

n：ファイルの通番（1～3）

注※16

XXX：リソースマネジャ名（dam，tam，ist，ism）

注※17

プロセスサービス定義のprc_coresave_pathオペランドを指定している場合，退避コアファイルは，prc_coresave_pathオペランドに指定したディレクトリに退避します。

注※18

n：退避コアファイルの通番（1～3）

ただし，サーバが強制停止時（dcsvstop -dfコマンドまたはprckillコマンドを実行したとき，または実時間監視タイムアウトになったとき）に出力されるコアファイルの場合は，通番は付きません。なお，プロセスサービスのコアファイルが’core’という名称で，ディレクトリに取得されることがあります。また，ユーザ環境設定コマンドが異常終了した場合，そのコアファイルは’_usrcmd’に通番（1～3）が付いた名称で退避されます。

注※19

デッドロック検知日時を基に決定されます。ファイル名の長さは，日付が1けたか，2けたかによって異なります。

（例）10月3日6時29分56秒のとき…Oct3062956

　　　10月10日18時6分0秒のとき…Oct10180600

注※20

KAXXZZ：

K：プロセス種別

m：MCFマネジャプロセス

c：MCF通信サービスまたはMCFアプリケーション起動サービス

u：ユーザサービスその他

AXX：MCF識別子

A：MCFマネジャ定義の，mcfmenv定義コマンドの-mオプションのidオペランドで指定したMCFマネジャプロセス識別子

XX：MCF通信構成定義の，mcftenv定義コマンドの-sオプションで指定したMCF通信プロセス識別子

ZZ：ダンプ通番（01～99）

注※21

AXXY：

AXX：MCF識別子

A：MCFマネジャ定義の，mcfmenv定義コマンドの-mオプションのidオペランドで指定したMCFマネジャプロセス識別子

XX：MCF通信構成定義の，mcftenv定義コマンドの-sオプションで指定したMCF通信プロセス識別子

Y：ファイルの通番（1～3）

注※22

rl＋トランザクションサービス開始時刻（16進数8けた）

注※23

n：不正なデータを検知したジャーナルのリソースグループの通番

この通番は，グローバルアーカイブジャーナルサービス定義のjnldfsv定義コマンドの-aオプションに指定したリソースグループに，順番に割り当てられる値です。

X：不正なデータを検知したジャーナルの世代番号

注※24

n：不正なデータを検知したジャーナルの世代番号

注※25

入出力キューの内容複写コマンド（mcfdmpqu）で指定したファイル名

なお，この表に示すファイル以外に，$DCDIR/spool/，および$DCDIR/tmp/の下には，OpenTP1の内部処理用のファイルがあります。ユーザは勝手に変更しないようにしてください。$DCDIR/tmp/下の内部処理用のファイルは，OpenTP1を開始するとすべてクリアされます。

7.2　OpenTP1の開始と終了

＜この節の構成＞

7.2.1　開始

7.2.2　終了

7.2.1　開始

一つのOpenTP1ノードから，マルチノードエリア，またはマルチノードサブエリアを構成する複数のOpenTP1ノードを開始できます。この場合，dcmstartコマンドを使用します。

dcmstartコマンドを実行すると，次に示すOpenTP1ノードを正常開始，または再開始します。

コマンド入力環境の環境変数DCDIRに対応したOpenTP1ノードが属するマルチノードエリアを構成するすべてのOpenTP1ノード

指定したマルチノードサブエリアを構成するすべてのOpenTP1ノード

指定したノード識別子のOpenTP1ノード

グローバルアーカイブジャーナル機能を使用する場合，アーカイブジャーナルノードは，ほかのノードと同様にdcstartコマンド，またはdcmstartコマンドで開始します。このとき，ほかのノードと同時か，または先にアーカイブジャーナルノードを開始してください。ほかのノードを先に開始すると，あとでアーカイブジャーナルノードを開始したときに，そのノードのジャーナルをアーカイブできなくなることがあります。

また，アーカイブジャーナルノードは，ほかのノードがすべて正常終了している場合だけ正常開始してください。ほかのノードが正常終了していない場合に，アーカイブジャーナルノードを正常開始すると，正常終了していないほかのノードのジャーナルをアーカイブできなくなることがあります。

7.2.2　終了

＜この項の構成＞

(1)　終了モード

(2)　終了方法

(1)　終了モード

(a)　正常終了

一つのOpenTP1ノードから，マルチノードエリア，またはマルチノードサブエリアを構成するOpenTP1ノードをすべて正常終了します。マルチノードエリア，またはマルチノードサブエリアを構成するOpenTP1ノードのジャーナルはすべてアーカイブされます。

次回の開始は正常開始となります。終了したときのアーカイブジャーナルファイルの続きにはジャーナルをアーカイブしません。

(b)　計画停止

一つのOpenTP1ノードから，マルチノードエリア，またはマルチノードサブエリアを構成するOpenTP1ノードをすべて正常終了，または計画停止します。マルチノードエリア，またはマルチノードサブエリアを構成するOpenTP1ノードのジャーナルはすべてアーカイブされます。

次回の開始は再開始となります。終了したときのアーカイブジャーナルファイルの続きにジャーナルをアーカイブします。

(c)　強制停止

一つのOpenTP1ノードから，マルチノードエリア，またはマルチノードサブエリアを構成するOpenTP1ノードをすべて強制的に終了します。

次回の開始は再開始となります。終了したときのアーカイブジャーナルファイルの続きにジャーナルをアーカイブします。

(d)　異常終了

何らかの異常が発生した場合，一つのOpenTP1ノードから，マルチノードエリア，またはマルチノードサブエリアを構成するOpenTP1ノードを直ちに終了します。

次回の開始は再開始となります。終了したときのアーカイブジャーナルファイルの続きにジャーナルをアーカイブします。

(2)　終了方法

一つのOpenTP1ノードから，マルチノードエリア，またはマルチノードサブエリアを構成する複数のOpenTP1ノードを終了するには，dcmstopコマンドを使用します。

dcmstopコマンドを実行すると，次に示すOpenTP1ノードを終了します。

コマンド入力環境の環境変数DCDIRに対応したOpenTP1ノードが属するマルチノードエリアを構成するすべてのOpenTP1ノード

指定したマルチノードサブエリアを構成するすべてのOpenTP1ノード

指定したノード識別子のOpenTP1ノード

終了モードと運用コマンドを次に示します。

　正常終了：dcmstopコマンド

　計画停止：dcmstop -aコマンド，またはdcmstop -bコマンド

　強制停止：dcmstop -fコマンド

なお，OpenTP1ノードごとに終了する場合は，dcstopコマンドを使用します。

終了モードと運用コマンドを次に示します。

　正常終了：dcstopコマンド

　強制正常終了：dcstop -nコマンド

　計画停止：dcstop -aコマンド，またはdcstop -bコマンド

　強制停止：dcstop -fコマンド

グローバルアーカイブジャーナル機能を使用する場合，アーカイブジャーナルノードは，ほかのノードと同様にdcstopコマンド，またはdcmstopコマンドで終了します。このとき，ほかのノードと同時か，またはほかのノードのあとにアーカイブジャーナルノードを終了してください。ほかのノードより先にdcstopコマンド，またはdcmstopコマンドを実行すると，ほかのノードの終了を待ち合わせます。この待ち合わせの最大時間は，グローバルアーカイブジャーナルサービス定義のjnl_arc_terminate_timeoutに指定しておきます。詳細についてはマニュアル「OpenTP1 システム定義」を参照してください。

また，アーカイブジャーナルノードは，ほかのノードがすべて正常終了している場合でないと正常終了できません。ほかのノードの終了状態を確認したあと，アーカイブジャーナルノードの終了モードを指定してください。

次のような場合，アーカイブジャーナルノード側では接続中の状態が残ったままとなるため，アーカイブジャーナルノード側でjnlardisコマンドを実行し，接続を解除してください。

アーカイブジャーナルノードとの接続が完了していない（KFCA04130-Iメッセージが出力されてない）状態の被アーカイブジャーナルノードで，OpenTP1の終了コマンド（dcstopコマンド）が実行された場合

被アーカイブジャーナルノードにjnl_arc_terminate_timeoutオペランド（グローバルアーカイブジャーナルサービスとのタイムアウト）を設定し，被アーカイブジャーナルノードの終了時にタイムアウトが発生した場合（KFCA04148-Wメッセージが出力された場合）

7.3　OpenTP1ノードの状態表示

マルチノードエリアを構成する各OpenTP1ノードの状態を，dcndlsコマンドで表示できます。

オプションの指定によって，次に示す状態を表示できます。

マルチノードエリア，またはマルチノードサブエリアを構成するすべてのOpenTP1ノードの状態

指定したOpenTP1ノードの状態

7.4　グローバルジャーナルに関する運用

＜この節の構成＞

7.4.1　アーカイブジャーナルファイルの構成，および作成と定義

7.4.2　アーカイブジャーナルファイルの使い方

7.4.3　アーカイブジャーナルファイルのアンロード

7.4.4　アーカイブジャーナルファイルの再使用

7.4.5　アーカイブジャーナルファイル情報の表示

7.4.6　アーカイブ状態の表示

7.4.7　アーカイブジャーナルファイルのオープンとクローズ

7.4.8　アーカイブジャーナルファイルのステータス変更

7.4.9　アーカイブジャーナルファイルのスワップ

7.4.10　スワップ先のファイルグループがないとき

7.4.11　アーカイブジャーナルファイルの状態遷移

7.4.12　グローバルアーカイブアンロードジャーナルファイル，およびアンロードジャーナルファイルの時系列ソート，およびマージ

7.4.13　グローバルアーカイブアンロードジャーナルファイルの編集出力

7.4.14　グローバルアーカイブアンロードジャーナルファイルのレコード出力

7.4.15　稼働統計情報の出力

7.4.16　ファイル回復用ジャーナルの集積

7.4.17　被アーカイブジャーナルノードのシステムジャーナルファイルのアンロード

7.4.18　被アーカイブジャーナルノードのファイル回復

7.4.19　リカバリジャーナルファイルの回復

7.4.1　アーカイブジャーナルファイルの構成，および作成と定義

グローバルジャーナルサービス機能では，アーカイブするノードやその業務に応じて16種類までのリソースグループを使うことができます。一つのリソースグループは，一つのアーカイブジャーナルサービス定義で指定します。

アーカイブジャーナルサービス定義では，複数の物理ファイルと，それを管理するための論理的なファイルであるファイルグループ，および要素ファイルとの対応関係を指定します。

ファイルグループとは，OpenTP1がジャーナルを世代管理するための論理的なファイルで，オンライン中のジャーナルファイルのスワップなどは，この単位で行われます。一つのリソースグループには，2個以上256個までのファイルグループを指定でき，ユーザはそれぞれのファイルグループに任意の名称を付けます。この名称は重複しないように付けてください。

要素ファイルとは，アーカイブジャーナルファイルの並列アクセス機能を使用する場合に，分散して使用する論理的なファイルです。オンライン中のジャーナルファイルへのアクセスは，分散された要素ファイルに並列に行われるので，ディスクに対する負荷を分散できます。

並列アクセス機能を使用する場合は，アーカイブジャーナルサービス定義のjnl_max_file_dispersionオペランドに2以上を指定し，jnl_min_file_dispersionオペランドを指定します。また，一つのファイルグループには2個以上8個までの要素ファイルを指定でき，ユーザはそれぞれの要素ファイルに任意の名称を付けます。この名称は重複しないように付けてください。ただし，リソースグループで分散数は一意ですので，それぞれのファイルグループには同じ数の要素ファイルを指定しなければなりません。

並列アクセス機能を使用しない場合，ユーザは要素ファイルを指定する必要はありません。ただし，OpenTP1は一つのファイルグループが一つの要素ファイルであるかのように処理します。

アーカイブジャーナルファイルは二重化することもできます。この場合，一つの要素ファイルには，A系，B系の二つの物理ファイルを指定します。この二つの物理ファイルには，同じ内容のジャーナルが書き込まれます。二重化する場合は，アーカイブジャーナルサービス定義でjnl_dual=Yと指定します。jnl_dual=Yと指定したときに片系の物理ファイルしか使用できなくなった場合について，片系運転可とするか，片系運転不可とするかをjnl_singleoperationオペランドで指定します。

アーカイブジャーナルファイルを二重化しない場合は，一つの要素ファイルには一つの物理ファイルを指定します。ただし，リソースグループで二重化するかどうかは一意ですので，それぞれの要素ファイルには同じ数の物理ファイルを指定しなければなりません。

ユーザは，OpenTP1を開始する前に，jnlinitコマンドでOpenTP1ファイルシステム上に物理ファイルを作成します。このとき，物理ファイルの名称には，アーカイブジャーナルサービス定義に指定した物理ファイル名と同じ名称を指定します。

物理ファイル作成後，物理ファイルと要素ファイル，ファイルグループ，およびリソースグループの対応関係をアーカイブジャーナルサービス定義で指定します。

アーカイブジャーナルサービス定義についてはマニュアル「OpenTP1 システム定義」を参照してください。

アーカイブジャーナルファイルのサイズの見積もりについては，「付録H.4　アーカイブジャーナルファイルのサイズの見積もり式」を参照してください。

7.4.2　アーカイブジャーナルファイルの使い方

アーカイブジャーナルファイルには，複数のほかのノードのシステムジャーナルファイルの内容と同じものが，混在して取得されます。

要素ファイルを構成する物理ファイルのうち，一つ以上の物理ファイルがオープンされていることを要素ファイルがオープン状態，物理ファイルがまったくオープンされていないことを要素ファイルがクローズ状態といいます。

要素ファイルを構成する物理ファイルのうち，必要以上の物理ファイルがオープンされていることを要素ファイルが使用可能状態，必要以上の物理ファイルがオープンされていないことを要素ファイルが使用不可能状態といいます。

物理ファイルの必要数は，アーカイブジャーナルサービス定義の指定によって決まります。

jnl_dual=Nのとき：1

jnl_dual=Y，かつjnl_singleoperation=Yのとき：1

jnl_dual=Y，かつjnl_singleoperation=Nのとき：2

要素ファイルの状態と物理ファイルの状態の関係を次の表に示します。

表7-6　要素ファイルの状態と物理ファイルの状態の関係

要素ファイルの状態1 | 要素ファイルの状態2 | 物理ファイルのオープン／クローズ状態
使用可能／使用不可能状態 | オープン／クローズ状態
片系運転可 | 片系運転不可 | A系 | B系
○ | ○ | オープン | オープン | オープン
○ | × | オープン | オープン | クローズ
○ | × | オープン | クローズ | オープン
× | × | クローズ | クローズ | クローズ

（凡例）

○：使用できます。

×：使用できません。

ファイルグループを構成する要素ファイルのうち，一つ以上の要素ファイルがオープンされていることをファイルグループがオープン状態，要素ファイルがまったくオープンされていないことをファイルグループがクローズ状態といいます。

また，ファイルグループを構成する要素ファイルのうち，必要以上の要素ファイルがオープンされていることをファイルグループが使用可能状態，必要以上の要素ファイルがオープンされていないことをファイルグループが使用不可能状態といいます。

要素ファイルの必要数は，アーカイブジャーナルサービス定義の指定によって決まります。

並列アクセス機能を使用しないとき：1

並列アクセス機能を使用するとき：並列アクセス化する場合の最小分散数

OpenTP1は，オンライン中のアーカイブジャーナルファイルのファイルグループを次に示す三つの状態で管理します。

現用
現時点でジャーナルの出力対象になっている使用可能状態のファイルグループです。この状態のファイルグループは常に一つです。

待機
現時点でジャーナルの出力対象にはなっていないが，現用に変更するために待機している使用可能状態のファイルグループです。
この状態はさらに次の二つに分けられます。

スワップ先にできる状態
アンロード済み（jnlunlfgコマンドでファイルにコピーされた）状態の待機ファイルグループです。次回スワップ発生時，すぐに現用になることができます。

スワップ先にできない状態
アンロード待ち状態の待機ファイルグループです。次回スワップ発生時，すぐに現用になることはできません。

予約
使用不可能状態のファイルグループです。

予約以外のファイルグループは，二つ以上必要です。

OpenTP1を正常開始すると，アーカイブジャーナルサービス定義で指定したファイルグループのうち，ONLと指定したファイルグループがすべてオープンされます。オープンされたファイルグループのうち，最初に指定したファイルグループが現用となり，そのほかは待機となります。オープンできなかったファイルグループ，およびONLと指定しなかったファイルグループは，予約となります。再開始すると，前回現用だったファイルグループが引き継がれます。

ジャーナルは現用のファイルグループに出力されます。現用のファイルグループが満杯になると，アーカイブジャーナルサービス定義で現用の次に指定したファイルグループ（待機中）にスワップします。二重化した場合，どちらか一方の系が満杯になると，スワップします。システムジャーナルファイル中のすべてのファイルグループが満杯になった場合は，最初のファイルグループに戻ってジャーナルを出力します。

7.4.3　アーカイブジャーナルファイルのアンロード

＜この項の構成＞

(1)　アンロード

(2)　アンロードチェックの抑止

(1)　アンロード

満杯，障害，または運用コマンドによってスワップして待機状態となったファイルグループは，アンロード待ち状態となります。アンロード待ち状態とは，DAMファイルの回復やユーザの運用に備えて，ユーザがジャーナルをアンロードするまでジャーナルを保存している状態です。アンロード待ち状態のファイルグループは，現用にできません。

アンロード待ち状態のファイルグループは，jnlunlfgコマンドでアンロードするとアンロード済み状態になります。アンロード済み状態とは，アンロード待ち状態のファイルグループをjnlunlfgコマンドでジャーナルをコピーした状態，またはjnlchgfgコマンドでジャーナルを破棄した状態です。

ファイルグループからジャーナルが切り離された旨のメッセージ（KFCA01222-I）が出力されたら，jnlunlfgコマンドを実行してください。

jnlunlfgコマンドでアンロードして作成したファイルをグローバルアーカイブアンロードジャーナルファイルといいます。

なお，-fオプション指定のjnlunlfgコマンドを実行すると，ファイルグループの状態をチェックしないでアンロードするため，現用ファイルグループ，およびアンロード済みのファイルグループをアンロードできます。ただし，アンロード済みのファイルグループを-fオプション指定のjnlunlfgコマンドでアンロードする場合は，一度jnlclsfgコマンドでクローズしてからアンロードしてください。

-fオプション指定のjnlunlfgコマンドを実行しても，ファイルグループの状態は変更できません。

(2)　アンロードチェックの抑止

アンロード待ち状態のファイルグループを，アンロードしないで現用に割り当てられます。これをジャーナルアンロードチェックの抑止といいます。通常OpenTP1では，ファイルグループのアンロード状態をチェックしていて，ファイルグループがアンロード済み状態の場合だけ現用に割り当てます。アンロード状態のチェックを抑止すると，スワップ先のファイルグループがアンロード待ち状態でも，現用として割り当てるので，ファイルグループをアンロードする必要はありません。

ジャーナルアンロードチェックの抑止機能を使用する場合は，アーカイブジャーナルサービス定義でjnl_unload_check=Nを指定します。この指定は，システム再開時に変更できます。

オンライン中にアンロードする場合は，アンロードするファイルグループをjnlclsfgコマンドでクローズしてから，アンロードを実行してください。jnlclsfgコマンドを実行しないでオンライン中のアンロードを実行すると，アンロード実行中のファイルグループが現用になることがあります。このとき，ファイルグループにはアンロード中のデータと，現用になって新たに書き込まれるデータとが混在するので，OpenTP1はアンロードを中断しますが，オンラインダウンすることはありません。

アンロードを一度も実行しない場合，アンロードジャーナルファイルを入力するコマンドは使用できません。アンロードジャーナルファイルを入力するコマンドを次の表に示します。

表7-7　アンロードジャーナルファイルを入力するコマンド一覧

機能 | コマンド
ジャーナル関係のファイル管理 | ファイル回復用ジャーナルの集積 | jnlcolc
アンロードジャーナルファイルの複写 | jnlcopy
アンロードジャーナルファイルの編集出力 | jnledit
MCF統計情報の出力 | jnlmcst
ジャーナル関係のファイル回復 | jnlmkrf
アンロードジャーナルファイルのレコード出力 | jnlrput
アンロードジャーナルファイルのマージ，時系列ソート | jnlsort
統計情報の出力 | jnlstts
DAMファイル管理 | 論理ファイルの回復 | damfrc
TAMファイル管理 | TAMファイルの回復 | tamfrc

ジャーナルアンロードチェックの抑止機能を使用する指定でも，jnllsコマンドを実行すると，ファイルグループはアンロード待ち状態が表示されます。アンロード待ち状態が表示されても，そのファイルグループは現用として割り当てられます。

7.4.4　アーカイブジャーナルファイルの再使用

満杯，または運用コマンドによってスワップして待機状態となったファイルグループを再使用するためには，ファイルグループがアンロード済み状態になっている必要があります。

ただし，システムジャーナルサービス定義にjnl_unload_check=N（ジャーナルアンロードチェックの抑止機能）を指定している場合は，ファイルグループの状態をチェックしないでスワップします。

オンライン中のアーカイブジャーナルファイルの状態遷移を次の図に示します。

図7-1　オンライン中のアーカイブジャーナルファイルの状態遷移

グローバルアーカイブジャーナル機能を使用する場合で，次のようなときは，すべてのジャーナルをアーカイブ済みであっても最終ファイルグループのファイルステータスがアーカイブ済みにならないことがあります。

システムジャーナルサービス定義にjnl_arc_terminate_check = Nを指定しているとき

ジャーナルサービス定義のjnl_arc_terminate_timeoutに0以外を指定してあり，タイムアウトによってアーカイブサービスの途中で終了した場合（終了時に KFCA04148-W　理由コード：2008を出力した場合）

ファイルのステータスをアーカイブ済みにする場合は，jnlchgfgコマンドを使用してください。

7.4.5　アーカイブジャーナルファイル情報の表示

アーカイブジャーナルファイル情報は，jnllsコマンドで表示できます。再開始中に読み込んだアーカイブジャーナルファイル情報は，jnlrinfコマンドで表示できます。

表示内容はファイルグループ名称，ファイル種別，ファイルグループの状態などです。

7.4.6　アーカイブ状態の表示

グローバルアーカイブジャーナルサービスのリソースグループとジャーナルサービスのリソースグループの関係，およびアーカイブ状態をjnlarlsコマンドで表示できます。

7.4.7　アーカイブジャーナルファイルのオープンとクローズ

予約のファイルグループをjnlopnfgコマンドでオープンすると，待機のファイルグループとなります。待機のファイルグループをjnlclsfgコマンドでクローズすると，予約のファイルグループになります。なお，待機のファイルグループが一つしかない場合，そのファイルグループはクローズできません。

アーカイブジャーナルファイルのオープンとクローズコマンドによる状態の変化を次の図に示します。

図7-2　オープンとクローズコマンドによる状態の変化（アーカイブジャーナルファイル）

7.4.8　アーカイブジャーナルファイルのステータス変更

アンロード待ち状態となった待機のファイルグループを，実際にはアンロードしないで状態だけを強制的にアンロード済み状態にするには，jnlchgfgコマンドを使用します。強制的にアンロード済み状態にするとジャーナルはコピーされないので注意してください。

アンロード済み状態となったファイルグループは，上書きできる状態であれば，次回スワップ時に現用として使用できます。

7.4.9　アーカイブジャーナルファイルのスワップ

ユーザが緊急に現用のファイルグループをアンロードしたり編集したりしたいときは，jnlswpfgコマンドを使用すると，すぐにスワップできます。ただし，スワップ先のファイルグループがないときは，エラーとなってスワップできません。

7.4.10　スワップ先のファイルグループがないとき

ユーザは，必ずスワップできるようにスワップ先にできる待機のファイルグループを用意しておく必要があります。ファイルグループが満杯になったり，ジャーナルの出力時に障害が発生したりしてスワップするとき，スワップ先にできる待機のファイルグループがないと，OpenTP1は異常終了します。

スワップ先のファイルグループがなくてOpenTP1が異常終了した場合，jnlunlfgコマンドでファイルグループをアンロードし，障害となったファイルグループがあれば，障害を取り除いてOpenTP1を再開始します。再開始を試みてもOpenTP1を開始できない場合は，アーカイブジャーナルサービス定義でONL指定のファイルグループを新たに指定し，OpenTP1を再開始してください。

また，グローバルアーカイブジャーナルサービス中の被アーカイブノードが，システムジャーナルのスワップ先がなくてシステムダウンした場合，次のように対処してください。

グローバルアーカイブジャーナルサービスを続行する場合は，システムジャーナルサービス定義でONL指定のファイルグループを新たに指定して，被アーカイブノードを再開始する

グローバルアーカイブジャーナルサービスを続行しない場合は，すべてのシステムジャーナルファイルをjnlunlfgコマンドでアンロードし，被アーカイブノードを再開始する

7.4.11　アーカイブジャーナルファイルの状態遷移

オンライン中のアーカイブジャーナルファイルの状態遷移表を次の表に示します。

表7-8　オンライン中のアーカイブジャーナルファイルの状態遷移表

状態 | 現用／待機／予約 | 現用 | 待機 | 予約
アンロード済み／待ち | － | 待ち | 済み | 待ち | 済み
状態の番号 | 1 | 2 | 3 | 4 | 5
イベント | 満杯スワップ | →2 | － | →1 | － | －
現用障害でスワップ | 並列アクセス機能未使用 | 非二重化で障害，または二重化でA系，B系共に障害 | →4 | － | →1 | － | －
二重化で片系障害 | 片系運転可 | →2 | － | →1 | － | －
片系運転不可 | →4 | － | →1 | － | －
並列アクセス機能使用 | 非二重化で障害，または二重化でA系，B系共に障害 | 障害が発生した物理ファイルを閉塞したあと | 使用できる要素ファイルが最小分散数以上 | →2 | － | →1 | － | －
二重化で片系障害 | 片系運転不可 | 使用できる要素ファイルが最小分散数未満 | →4 | － | →1 | － | －
片系運転可 | →2 | － | →1 | － | －
jnlswpfgコマンドを実行してスワップ | →2 | － | →1 | － | －
jnlunlfgコマンドを実行 | － | →3 | － | →5 | －
jnlchgfgコマンドを実行 | － | →3 | － | →5 | －
jnlopnfgコマンドを実行※ | － | － | － | →2 | →3
jnlclsfgコマンドを実行※ | － | →4 | →5 | － | －

（凡例）

－：起こり得ない，または状態が遷移しないことを示します。

→n：遷移先の状態の番号を示します。

注

すべてのイベントは正常に処理されるものとします。

グローバルアーカイブジャーナルサービスが動作中のときだけアーカイブジャーナルファイルのファイルグループの状態を管理しています。また，クローズ中のファイルグループの状態（アンロード済み／待ち状態）は管理していません。そのため，クローズ中のファイルグループにjnlunlfg，またはjnlchgfgコマンドを実行しても，jnllsコマンドで表示される状態は変わりません。

なお，jnlunlfg，またはjnlchgfgコマンドを実行したあとに，jnlopnfgコマンドを実行し，jnllsコマンドを実行すると，現在のファイルの状態が表示されます。

注※

-a，-b，-eオプションの指定を省略したとき。

7.4.12　グローバルアーカイブアンロードジャーナルファイル，およびアンロードジャーナルファイルの時系列ソート，およびマージ

グローバルアーカイブアンロードジャーナルファイルとアンロードジャーナルファイルの内容を時系列にソート，およびマージできます。この場合，jnlsortコマンドを使用します。ソート，およびマージした結果は，グローバルアーカイブアンロードジャーナルファイルの形式で出力されます。

また，次に示すようなソート，およびマージもできます。

被アーカイブジャーナルノードのシステムジャーナルファイルに出力された時間によって，すべてのノードのジャーナルをソート，およびマージ

特定のノードのジャーナルだけをソート，およびマージ

7.4.13　グローバルアーカイブアンロードジャーナルファイルの編集出力

グローバルアーカイブアンロードジャーナルファイルの内容を，ユーザが確認できるようにテキスト形式に編集して出力できます。ブロック単位，またはレコード単位で編集します。この場合，jnleditコマンドを使用します。

jnleditコマンドを実行すると，すべての被アーカイブジャーナルノードのジャーナルを出力できます。また，jnlsortコマンドの結果を入力することで次に示すような編集，および出力もできます。

被アーカイブジャーナルノードのシステムジャーナルファイルに出力された時間によって，すべてのノードのジャーナルをソートし，編集して出力

特定のノードのジャーナルだけを編集して出力

すべてのノードのうち，特定のグローバルトランザクションに関係するジャーナルだけを抽出し，システムジャーナルファイルに出力された時間でソートし，編集して出力

7.4.14　グローバルアーカイブアンロードジャーナルファイルのレコード出力

グローバルアーカイブアンロードジャーナルファイルの内容を，ユーザが独自のプログラムで処理するために，ジャーナルをバイナリ形式で出力できます。

この場合，jnlrputコマンドを使用します。

jnlrputコマンドを実行すると，すべての被アーカイブジャーナルノードのジャーナルを出力できます。また，jnlsortコマンドの結果を入力することで次に示すような出力もできます。

被アーカイブジャーナルノードのシステムジャーナルファイルに出力された時間によって，すべてのノードのジャーナルをソートし，出力

特定のノードのジャーナルだけを出力

すべてのノードのうち，特定のグローバルトランザクションに関係するジャーナルだけを抽出し，システムジャーナルファイルに出力された時間でソートし，出力

7.4.15　稼働統計情報の出力

グローバルアーカイブアンロードジャーナルファイルから，すべての被アーカイブジャーナルノードの稼働統計情報を収集し，編集して出力できます。

この場合，jnlsttsコマンド，またはjnlmcstコマンドを使用します。

すべての被アーカイブジャーナルノードの情報を出力するほかに，jnlsortコマンドの結果を入力することで次のような出力もできます。

特定のノードのジャーナル情報だけを出力

7.4.16　ファイル回復用ジャーナルの集積

すべての被アーカイブジャーナルノードのファイル（DAMファイル，TAMファイル，ISAMファイル）を回復するために必要なジャーナルを，グローバルアーカイブアンロードジャーナルファイルから抽出できます。この場合，jnlsortコマンドとjnlcolcコマンドを使用します。jnlcolcコマンドを実行して作成したファイルを集積ジャーナルファイルといいます。DAMファイル，TAMファイル，またはISAMファイル回復時に，集積ジャーナルファイルを使用すると，ファイルの回復処理に必要な時間を短縮できます。

7.4.17　被アーカイブジャーナルノードのシステムジャーナルファイルのアンロード

被アーカイブジャーナルノードのシステムジャーナルファイルは，通常はアンロードする必要はありません。

ただし，アーカイブジャーナルファイルと被アーカイブジャーナルノードのシステムジャーナルファイルとでは，ジャーナルが出力されるタイミングにずれがあります。このため，DAMファイル，TAMファイル，またはISAMファイルの回復のためにすべてのジャーナルが必要になる場合は，アーカイブされていない部分のジャーナルの有無を確認し，被アーカイブジャーナルノードのシステムジャーナルファイルをアンロードする必要があります。

また，障害が発生してアーカイブできなくなった場合も，被アーカイブジャーナルノードのシステムジャーナルファイルをアンロードする必要があります。

7.4.18　被アーカイブジャーナルノードのファイル回復

被アーカイブジャーナルノードのDAMファイル，TAMファイル，またはISAMファイルが障害となった場合，バックアップファイルとジャーナルによってファイルを回復します。この場合，jnllsコマンド，およびOSのコマンドを使用して，バックアップファイルの大きさと，ファイルの更新に必要なジャーナル量を比較してください。バックアップファイルの方が大きい場合は被アーカイブジャーナルノードでファイルを回復し，小さい場合はアーカイブジャーナルノードでファイルを回復すると，ファイル転送に必要な時間が短くて済み，ファイルを早く回復できます。それぞれの場合の手順を次に示します。

＜この項の構成＞

(1)　バックアップファイルの大きさがファイルを更新するジャーナル量より大きいとき

(2)　バックアップファイルの大きさがファイルを更新するジャーナル量より小さいとき

(1)　バックアップファイルの大きさがファイルを更新するジャーナル量より大きいとき

あらかじめ被アーカイブジャーナルノードにバックアップファイルを保持しておきます。バックアップファイルが，オフライン状態でバックアップしたファイルの場合，バックアップ後の，次の被アーカイブジャーナルノードのオンラインのジャーナルサービスのランIDが，ファイルの回復に必要になります。オンラインバックアップしたファイルの場合，そのときの被アーカイブジャーナルノードのオンラインのジャーナルサービスのランIDが，ファイルの回復に必要になります。このランIDを，以降，「R」として説明します。

次の手順でファイルを回復してください。

回復に必要なアーカイブジャーナルファイルをjnlunlfgコマンドでアンロードします。回復に必要なアーカイブジャーナルファイルは，被アーカイブジャーナルノードのランIDがR以降のジャーナルを含むものです。ランIDは，jnlarlsコマンド，およびjnllsコマンドで確認してください。

被アーカイブジャーナルノードでアーカイブされていないジャーナルを含むすべてのシステムジャーナルファイルを，jnlunlfgコマンドでアンロードします。

1.のグローバルアーカイブアンロードジャーナルファイルから，被アーカイブジャーナルノードのノード識別子と被アーカイブジャーナルノードのランIDのRをキーに，jnlsortコマンドでジャーナルを集積します。

集積したジャーナルを被アーカイブジャーナルノードに転送します。OSのコマンドで転送してください。

転送したジャーナルファイルと2.のアンロードジャーナルファイルを指定してjnlsortコマンドを実行し，ジャーナルをさらに集積します。

バックアップファイルをDAMファイル，またはTAMファイルにリストアします。DAMファイルの場合はdamrstrコマンドで，TAMファイルの場合はtamrstrコマンドでリストアしてください。

5.の集積ジャーナルファイルを使用して，被アーカイブジャーナルノードでファイルを回復します。DAMファイルはdamfrcコマンドで，TAMファイルはtamfrcコマンドで回復してください。ISAMファイルの回復については，マニュアル「索引順編成ファイル管理 ISAM」を参照してください。

(2)　バックアップファイルの大きさがファイルを更新するジャーナル量より小さいとき

あらかじめアーカイブジャーナルノードにバックアップファイルを保持しておきます。バックアップファイルが，オフライン状態でバックアップしたファイルの場合，バックアップ後の，次の被アーカイブジャーナルノードのオンラインのジャーナルサービスのランIDが，ファイルの回復に必要になります。オンラインバックアップしたファイルの場合，そのときの被アーカイブジャーナルノードのオンラインのジャーナルサービスのランIDが，ファイルの回復に必要になります。このランIDを，以降，「R」として説明します。

なお，この場合，アーカイブジャーナルノードにTP1/FS/Direct Access，またはTP1/FS/Table Accessを組み込んでおく必要があります。また，アーカイブジャーナルノード上にファイルを回復するための作業用のファイルとして，OpenTP1ファイルが必要です。

次の手順でファイルを回復してください。

回復に必要なアーカイブジャーナルファイルをjnlunlfgコマンドでアンロードします。回復に必要なアーカイブジャーナルファイルは，被アーカイブジャーナルノードのランIDがR以降のジャーナルを含むものです。ランIDは，jnlarlsコマンド，およびjnllsコマンドで確認してください。

被アーカイブジャーナルノードでアーカイブされていないジャーナルを含むすべてのシステムジャーナルファイルを，jnlunlfgコマンドでアンロードします。

2.のアンロードジャーナルファイルをアーカイブジャーナルノードに転送します。OSのコマンドで転送してください。

3.の転送したアンロードジャーナルファイルと1.のグローバルアーカイブアンロードジャーナルファイルを指定して，被アーカイブジャーナルノードのノード識別子と被アーカイブジャーナルノードのランIDのRをキーに，jnlsortコマンドでジャーナルを集積します。

アーカイブジャーナルノードには，バックアップファイルをリストアするための，OpenTP1ファイルシステム上のDAMファイル，またはTAMファイルの物理ファイルが必要です。事前に作成していない場合，DAMファイルの場合はdamloadコマンドで，TAMファイルの場合はtamcreコマンドで作成してください。バックアップファイルをDAMファイル，またはTAMファイルにリストアします。DAMファイルの場合はdamrstrコマンドで，TAMファイルの場合はtamrstrコマンドでリストアしてください。

4.の集積ジャーナルファイルを使用して，アーカイブジャーナルノードでファイルを回復します。DAMファイルはdamfrcコマンドで，TAMファイルはtamfrcコマンドで回復してください。ISAMファイルの回復については，マニュアル「索引順編成ファイル管理 ISAM」を参照してください。

回復したDAMファイル，またはTAMファイルを再びバックアップします。

バックアップしたファイルを被アーカイブジャーナルノードに転送します。OSのコマンドで転送してください。

転送したバックアップファイルを，元のDAMファイル，またはTAMファイルにリストアします。DAMファイルの場合はdamrstrコマンドで，TAMファイルの場合はtamrstrコマンドでリストアしてください。

7.4.19　リカバリジャーナルファイルの回復

リカバリジャーナルファイルに障害が発生した場合は，次の手順で回復してください。

jnlmkrfコマンドを実行するために必要なジャーナルのポイントを確認します。

グローバルアーカイブアンロードジャーナルファイルから，1.のポイント以降の該当するノードのジャーナルを抽出します。

抽出したジャーナルのファイルを被アーカイブジャーナルノードに転送します。OSのコマンドで転送してください。

転送した抽出ジャーナルのファイル，および被アーカイブジャーナルノードのアンロードジャーナルファイルを指定してjnlmkrfコマンドを実行します。

8.　マルチOpenTP1の運用

マルチOpenTP1の運用方法について，ノード単位で行う正常時のOpenTP1の運用と異なる部分だけを説明します。

マルチOpenTP1の場合，同一ノード内でも個々のOpenTP1を独立して運用できます。

＜この章の構成＞

8.1　マルチOpenTP1の環境設定

8.2　運用コマンド実行時の環境

8.1　マルチOpenTP1の環境設定

＜この節の構成＞

8.1.1　OpenTP1管理者の設定

8.1.2　OpenTP1ディレクトリの作成

8.1.3　OpenTP1のOSへの登録

8.1.4　OpenTP1ファイルシステムの初期設定

8.1.5　ユーザの環境設定

8.1.6　共用ライブラリの変更

8.1.7　OpenTP1ファイルの作成

8.1.8　OpenTP1ファイル以外のファイルの作成

8.1.1　OpenTP1管理者の設定

次のどちらかで，OpenTP1管理者を設定します。

OpenTP1ごとに，個別にOpenTP1管理者を設定

共通のOpenTP1管理者を設定

8.1.2　OpenTP1ディレクトリの作成

OpenTP1ごとに個別のOpenTP1ディレクトリを作成します。

また，ユーザプログラムファイルは，プロセスサービス定義のprcsvpath定義コマンドで同じパス名を指定すると，マルチOpenTP1間で共用できます。

OpenTP1ディレクトリ作成時は，次のことに注意してください。

ルートパーティションを圧迫しないために，ルートパーティション以外のディレクトリを指定してください。

リモートファイルシステム，またはシンボリックリンクをしたディレクトリ上にはOpenTP1ディレクトリを作成しないでください。

8.1.3　OpenTP1のOSへの登録

OpenTP1ごとに，OpenTP1ディレクトリを指定したdcsetupコマンドを実行します。

8.1.4　OpenTP1ファイルシステムの初期設定

マルチOpenTP1では，OpenTP1ファイルシステム用として，OpenTP1ごとに異なるパーティション，または異なるファイルを割り当てて使用してください。

複数のOpenTP1で同じパーティション，または同じファイルを共有する場合には，OpenTP1ファイルシステム用のパーティション，またはファイルの確保とOpenTP1ファイルシステムの初期設定を，1回だけ行います。OpenTP1ごとには実行しないでください。OpenTP1ごとに実行すると，すでにあるファイルが消去されてしまいます。

8.1.5　ユーザの環境設定

マルチOpenTP1の場合も，次に示す環境変数で，特定のOpenTP1を操作できます。環境変数は，ユーザ開始ファイル（.profile，.login）で各ログイン環境に設定してください。

DCDIR

OpenTP1ディレクトリを完全パス名で指定します。DCDIRに設定するディレクトリ名は，50バイト以内で指定してください。OpenTP1ディレクトリにシンボリックリンクは使用できません。

DCCONFPATH

OpenTP1定義を格納するディレクトリの完全パス名を246バイト以下で指定します。

DCUAPCONFPATH

OpenTP1ユーザサービス定義ファイルまたはユーザサービスデフォルト定義ファイルをDCCONFPATH環境変数で設定したディレクトリとは別のディレクトリに格納したい場合，そのディレクトリの完全パス名を246バイト以下で指定します。

8.1.6　共用ライブラリの変更

マルチOpenTP1では，共用ライブラリの領域は，それぞれのOpenTP1のメモリに常駐されます。二つのOpenTP1システムのバージョンが同一の場合，共用ライブラリを一つにできます（HP-UX限定）。二つのOpenTP1システムが一つの共用ライブラリを参照することで，メモリの使用量を削減できます。

マルチOpenTP1で共用ライブラリを一つにする方法は，SHLIB_PATHをOpenTP1システム間で同じにします。次に手順例を示します。

＜この項の構成＞

(1)　/etc/inittabの変更

(2)　環境変数の変更

(3)　定義の変更

(1)　/etc/inittabの変更

/etc/inittabを変更するために，OpenTP1を停止してください。OpenTP1稼働中に作業をするとシステムダウンします。

変更前

d1:2:respawn:env SHLIB_PATH=/BeTRAN/lib /BeTRAN/lib/servers/prcd /BeTRAN
d2:2:respawn:env SHLIB_PATH=/BeTRAN1/lib /BeTRAN1/lib/servers/prcd /BeTRAN1

変更後（変更個所をアンダーラインで示します）

d1:2:respawn:env SHLIB_PATH=/BeTRAN/lib /BeTRAN/lib/servers/prcd /BeTRAN
d2:2:respawn:env SHLIB_PATH=/BeTRAN/lib /BeTRAN1/lib/servers/prcd /BeTRAN1

dcresetコマンドを入力して，/etc/inittabの変更をOSに反映させます。
dcsetup -dを実行すると，/etc/inittabの内容は削除されます。dcsetup -dを実行した場合は，dcsetupで登録したあとで再度/etc/inittabを変更してください。

(2)　環境変数の変更

コマンド発行環境を設定している環境変数を変更します。

変更前

環境変数 | OpenTP1 A | OpenTP1 B
DCDIR | /BeTRAN | /BeTRAN1
DCCONFPATH | /BeTRAN/conf | /BeTRAN1/conf
SHLIB_PATH | /BeTRAN/lib | /BeTRAN1/lib

変更後（変更個所をアンダーラインで示します）

環境変数 | OpenTP1 A | OpenTP1 B
DCDIR | /BeTRAN | /BeTRAN1
DCCONFPATH | /BeTRAN/conf | /BeTRAN1/conf
SHLIB_PATH | /BeTRAN/lib | /BeTRAN/lib

OpenTP1システムのバージョンが異なる場合は，動作の保証はできません。また，SHLIB_PATHのディレクトリ中にライブラリがない場合は，OSの制御でプロセスが起動されません。

(3)　定義の変更

システム定義のputenv形式にSHLIB_PATHを定義している場合は，環境変数と同様に変更してください。

8.1.7　OpenTP1ファイルの作成

次に示すOpenTP1ファイルを，各ファイルを初期設定する運用コマンドを使用して作成，初期設定します。

表8-1　初期設定するOpenTP1ファイル

OpenTP1ファイル | 運用コマンド
ステータスファイル | stsinit
ジャーナル関係のファイル | システムジャーナルファイル | jnlinit
チェックポイントダンプファイル
メッセージキューファイル | queinit
ノードリストファイル | namnlcre
MQA　キューファイル | mqainit
DAMファイル | damload
TAMファイル | tamcre

複数のOpenTP1で同じパーティションを共用する場合，各OpenTP1ファイルは，OpenTP1ごとに異なるファイル名になるように作成，初期設定します。

8.1.8　OpenTP1ファイル以外のファイルの作成

定義ファイルの格納ディレクトリを，OpenTP1ごとに，異なったディレクトリとして作成します。それぞれのディレクトリ下にOpenTP1の定義ファイルを作成します。定義内容は，マニュアル「OpenTP1 システム定義」を参照してください。

8.2　運用コマンド実行時の環境

OpenTP1管理者と，運用コマンドを実行するユーザは，環境変数を設定する必要があります。DCDIRには運用コマンドの操作対象にしたいOpenTP1ディレクトリを，DCCONFPATHには定義格納ディレクトリを設定してください。

設定したDCDIRによって，どのOpenTP1に対する運用コマンドであるかが決まります。

OpenTP1の環境変数を意識しないで，指定したOpenTP1に運用コマンドを入力できるようにするサンプルプログラムが，examples/tools/ディレクトリ下にあります。詳細については，マニュアル「OpenTP1 プログラム作成の手引」を参照してください。

9.　系切り替え機能使用時の運用

系切り替え機能使用時の運用について，系切り替え機能を使用しない場合のOpenTP1の運用と異なる部分だけを説明します。

系切り替え機能については，マニュアル「高信頼化システム監視機能 HAモニタ」を参照してください。

＜この章の構成＞

9.1　系切り替え機能使用時の準備

9.2　開始と終了

9.3　系切り替えの方法

9.4　系切り替え機能使用時のオンラインタイミング

9.5　ユーザサーバの待機

9.6　運用コマンド

9.1　系切り替え機能使用時の準備

系切り替え機能を使用するOpenTP1間では，次の内容をすべて一致させておく必要があります。

OpenTP1のシステム定義

ユーザサーバの実行形式プログラム

トランザクションサービス制御用実行形式プログラム※（trnlnkrmコマンドで再作成した場合）

OpenTP1，および関連プログラムプロダクトのバージョン

OpenTP1管理者の環境（ユーザID，グループID，環境変数）

OpenTP1ディレクトリの完全パス名

OpenTP1ファイルの設定

使用するOpenTP1ファイルは，共有ディスクのキャラクタ型スペシャルファイル上に作成したOpenTP1ファイルシステムに割り当ててください。

また，システム構成定義で系切り替え機能を使用する（ha_conf=Y）と指定しておきます。ただし，系切り替え機能使用時は，トランザクションリカバリジャーナルファイル機能は使用できません。ユーザサービス定義，またはユーザサービスデフォルト定義でtrf_put=Yと指定しないでください。

OpenTP1で系切り替え機能を使用するためには，OpenTP1で使用するホスト名称を実行系と待機系で同じにする必要があります。また，そのホスト名称に対応するIPアドレスも実行系と待機系で同じにする必要があります。

システム共通定義のmy_hostオペランドが指定されている場合，OpenTP1はその名称を使用します。my_hostオペランドが指定されていない場合，OpenTP1が稼働している計算機の標準ホスト名称を使用します。

注※

trnlnkrmコマンドを実行して，OpenTP1に登録するリソースマネジャの登録順序も，一致させる必要があります。

実行系と待機系のOpenTP1が使用するホスト名称の組み合わせについて，次の表に示します。

表9-1　実行系と待機系のOpenTP1が使用するホスト名称の組み合わせ

実行系と待機系のOpenTP1のmy_hostオペランドの指定 | 標準ホスト名称
同じ | 異なる
同じ | ○ | ○
異なる | × | ×
なし | ○ | ×

（凡例）

○：有効

×：無効

9.2　開始と終了

＜この節の構成＞

9.2.1　開始

9.2.2　終了

9.2.1　開始

実行系にあるOpenTP1，および待機系にあるOpenTP1は，系切り替え機能を使用しない場合と同様に開始します。実行系にあるOpenTP1，および待機系にあるOpenTP1を両方とも開始してください。

開始方法は，システム環境定義（mode_conf）の指定内容によって決まります。

OpenTP1異常終了後，自動開始するように，AUTO，またはMANUAL1を指定することをお勧めします。AUTOとMANUAL1は，OS起動後の開始方法が異なるため，運用方法に応じて指定してください。

ただし，待機系OpenTP1を実行系OpenTP1の未決着トランザクションの決着，データベースの整合性の管理などの後処理に使用する場合は，dcstartコマンドに-Uオプションを指定する必要があるため，自動開始しないように指定してください。

注意事項

システム環境定義のmode_confオペランドに，AUTOまたはMANUAL1を指定した場合は，OpenTP1が異常終了したときにOpenTP1が自動起動されるため，待機系OpenTP1を後処理に使用できません。待機系OpenTP1を後処理に使用したい場合は，いったんOpenTP1を停止してから，dcstartコマンドに-Uオプションを指定して実行してください。dcstartコマンドに-Uオプションを指定して待機系OpenTP1を開始する運用については，マニュアル「OpenTP1 解説」を参照してください。

9.2.2　終了

＜この項の構成＞

(1)　実行系OpenTP1の終了

(2)　待機系OpenTP1の終了

(1)　実行系OpenTP1の終了

系切り替え機能を使用しない場合と同様に，dcstopコマンドを実行します。

実行系にあるOpenTP1の終了に伴い，待機系にあるOpenTP1も終了します。

(2)　待機系OpenTP1の終了

実行系にあるOpenTP1の終了に伴い，待機系にあるOpenTP1も終了します。

待機系にあるOpenTP1だけを終了するには，-fオプション指定のdcstopコマンド（強制停止）を実行します。-fオプション以外は指定できません。

なお，HAモニタのコマンドを使用すれば，実行系にあるOpenTP1とは非同期に待機系にあるOpenTP1を終了できます。HAモニタのコマンドについては，高信頼化システム監視機能 HAモニタの各OS編のマニュアルを参照してください。

9.3　系切り替えの方法

実行系にあるOpenTP1に障害が発生した場合，待機系にあるOpenTP1に切り替えて，オンラインを継続できます。系切り替え後，待機系は実行系となります。

実行系から待機系への切り替え方法には，次の三つがあります。

自動系切り替え

計画系切り替え

連動系切り替え

なお，切り替え時に引き継ぐファイルは，共有ディスクのキャラクタ型スペシャルファイル上のOpenTP1ファイルだけです。

＜この節の構成＞

9.3.1　自動系切り替え

9.3.2　計画系切り替え

9.3.3　連動系切り替え

9.3.1　自動系切り替え

実行系OpenTP1に障害が発生した場合，自動的に待機系OpenTP1と切り替えます。

系切り替えの契機となる障害を次に示します。

系障害

系のハードウェア障害や電源断

カーネル障害

HAモニタ障害

RS-232Cアダプタ障害

系のスローダウン

ハード障害

OpenTP1の論理エラー

リソースの障害でシステムの運転が続行できない場合

通信管理（XNF/S-E2など）障害

OpenTP1の沈み込み

9.3.2　計画系切り替え

ユーザがHAモニタの計画系切り替えコマンドを実行すると，実行系OpenTP1を停止し，待機系OpenTP1と切り替えます。

9.3.3　連動系切り替え

実行系で複数のOpenTP1が動作している場合，障害発生時に複数のOpenTP1を一括して切り替える機能を連動系切り替えといいます。

連動系切り替えは，複数のOpenTP1をグループ化することで実現します。グループ化したOpenTP1は，そのうちの一つに障害が発生すると，OpenTP1のグループ単位で待機系に切り替えられます。また，グループ化したOpenTP1内では，障害が発生すると，グループ単位で切り替えるOpenTP1，障害が発生しても切り替えないOpenTP1，というようにOpenTP1ごとの設定ができます。

連動系切り替えの環境は，HAモニタで設定します。

9.4　系切り替え機能使用時のオンラインタイミング

系切り替え機能使用時のOpenTP1オンラインタイミングを次の図に示します。

図9-1　系切り替え機能使用時のOpenTP1オンラインタイミング

注※

ユーザコマンドはHAモニタの機能です。この機能を使用する際，OpenTP1は未起動の場合があります。そのためユーザコマンドからOpenTP1のコマンドを実行した場合，エラーになるおそれがあります。詳細については，マニュアル「高信頼化システム監視機能　HAモニタ」を参照してください。

図で示した処理の流れについて説明します。番号は図中の番号と対応しています。

システム環境定義のuser_commandオペランドに指定されたコマンドを実行します。

OpenTP1は待機サーバとして起動し，待機状態となります。

実行系OpenTP1で障害が発生し，系切り替えが行われます。

待機状態だったOpenTP1は実行系OpenTP1として起動します。

OpenTP1のすべてのシステムサーバを起動します。

HAモニタにOpenTP1起動処理完了を通知します。
なお，OpenTP1がダウンした場合，ダウンしたのがこの通知の前かあとかによってHAモニタの動作が異なります。

OpenTP1がこの通知の前にダウンした場合

系切り替えを中断します。

OpenTP1がこの通知のあとにダウンした場合

障害が発生したOpenTP1が待機系として起動している場合，系切り替え処理を開始します。

OpenTP1は，オンライン状態になるとKFCA01809-Iメッセージを出力します。

再開始で障害発生前にユーザサーバが起動していれば状態を回復します。

システム環境定義のuser_command_onlineオペランドに指定されたコマンドを実行します。

9.5　ユーザサーバの待機

システム環境定義でuser_server_ha=Yと指定しておくと，予備のOpenTP1（待機系）が待機状態になるまでに，ユーザサービス構成定義に指定したユーザサーバのプロセスだけを起動できます。ただし，次のことに注意してください。

ユーザサーバは，dc_rpc_open関数の中で実行系から待機系に切り替わるのを待ちます。そのため，dc_rpc_open関数が発行されないと，待機系にあるOpenTP1を切り替えられる状態になりません。

OpenTP1では前回のユーザサーバの構成を引き継ぎます。そのため，待機系OpenTP1に切り替わったあと，前回のオンラインでユーザサービス構成定義に指定されていたユーザサーバが構成から外れていた場合，dc_rpc_open関数を発行してもリターン値DCRPCER_STANDBY_ENDが返されます。この場合，必ずプロセスを終了させてください。また，待機系にあるOpenTP1に切り替わったあと，ユーザサーバの停止処理が行われるため，開始までに時間が掛かります。そのため，ユーザサービス構成定義に指定するユーザサーバには，システムの終了まで終了しないユーザサーバを指定することをお勧めします。

待機系にあるOpenTP1が待機系終了する場合も，dc_rpc_open関数を発行してもリターン値DCRPCER_STANDBY_ENDが返されます。この場合，必ずプロセスを終了させてください。

9.6　運用コマンド

使用できる運用コマンドには，次の制限があります。

オフライン中に実行できる運用コマンドは，実行系と待機系にある両方のOpenTP1を停止してから実行します。ただし，dcstartコマンドは，他系が停止しているかどうかに関係なく，そのマシンのOpenTP1が停止していれば実行できます。また，待機系にあるOpenTP1では，-nオプション指定のdcstartコマンド（強制的な正常開始）を実行しても，オプションの指定は無視されます。

オンライン中に実行できる運用コマンドは，オンライン中の実行系にあるOpenTP1で実行できます。待機系にあるOpenTP1で実行できるのは，-fオプション指定のdcstopコマンド（強制停止）と，-n，または-fオプション指定のjnlunlfgコマンド（ジャーナル関係のファイルのアンロード）です。

10.　障害対策

OpenTP1の障害を分類し，それぞれの障害が発生した場合の対処方法を説明します。

また，障害情報の取得方法についても説明します。

＜この章の構成＞

10.1　障害発生時の現象と原因

10.2　OpenTP1ファイル障害

10.3　ファイル障害

10.4　通信障害

10.5　UAP障害

10.6　OpenTP1障害

10.7　CPU障害

10.8　障害時に取得する情報

10.9　全面回復時に引き継がれる情報

10.1　障害発生時の現象と原因

障害発生時の現象と推定できる原因を次の表に示します。

表10-1　障害発生時の現象と原因

現象
原因
対策記述個所

UAPを開始できない
システム定義が誤っています
10.5

メモリ不足です

UAPが終了しない
UAPの不良です

UAPが異常終了する
UAP，またはOpenTP1の不良です

UAPのリンケージが誤っています

UAPのデッドロックが発生する
UAP間で排他要求がループしています

OpenTP1を開始できない
OpenTP1が正しくインストール，およびセットアップされていません
10.6

OpenTP1のシステム定義が誤っています

メモリ，またはディスクの容量不足です

OpenTP1の開始に必要なファイルがありません

OSの構成がOpenTP1の実行環境として不適当です

TCP／IP環境がセットアップされていません

ハードウェア（ディスク，またはLAN）不良です

ユーザ環境設定コマンドが誤っています

プロセスサービスの処理が中断されました

dcstopコマンドを入力したのにOpenTP1が停止しない
UAPの処理が長く続くか，または不良でUAPが終了しません

正常終了時，通信不良などで出力キューにたまったメッセージが出力されません

接続しているジャーナルサービスが終了しないため，アーカイブジャーナルノードのOpenTP1が停止しません

グローバルアーカイブジャーナルサービスとの接続が解除できないため，被アーカイブジャーナルノードのOpenTP1が停止しません

OpenTP1が異常終了した
OpenTP1のシステムサービス，またはユーザサーバをkillコマンドで停止させました
10.2

OpenTP1の不良です

スワップ先のジャーナルファイルグループがありません

ステータスファイルのA系，B系の予備ファイルがありません

ステータスファイルのA系，B系の現用ファイルが読み込めません

MCFの定義ファイルに障害が発生しました

MCFのキューファイルに障害が発生しました

UOCの不良です

UAPの不良です

OpenTP1の運用コマンドが正常終了しない
オプション，またはコマンド引数の指定が誤っています
10.6

運用コマンドを実行できる環境が設定されていません

該当する運用コマンドを実行する権限がありません

OpenTP1の運用コマンドが応答待ちタイムアウトになる
OSの負荷が高く，応答待ち時間内に処理が完了しません
10.6

ファイルの入出力エラーが発生する
ファイルに障害が発生しました
10.2，
10.3

ファイル障害メッセージが出力される

通信エラーメッセージが出力される
プロトコルに障害が発生しました
10.4

LANに障害が発生しました

10.2　OpenTP1ファイル障害

OpenTP1ファイルに障害が発生した場合の対処方法を説明します。

＜この節の構成＞

10.2.1　ステータスファイル

10.2.2　システムジャーナルファイル

10.2.3　アーカイブジャーナルファイル

10.2.4　リカバリジャーナルファイル

10.2.5　チェックポイントダンプファイル

10.2.6　DAMファイル

10.2.7　TAMファイル

10.2.8　メッセージキューファイル

10.2.9　XARファイル

10.2.10　MCF定義ファイル

10.2.1　ステータスファイル

＜この項の構成＞

(1)　オンライン中

(2)　再開始時

(3)　正常開始時

(1)　オンライン中

オンライン中の障害は，書き込み時に発生するものと読み込み時に発生するものに分けられます。

(a)　書き込み時

予備ファイルがあるとき

OpenTP1は現用ファイルを予備にスワップします。

その後，次の手順で障害が発生したステータスファイルを初期設定してください。

障害が発生して閉塞したステータスファイルをstsrmコマンドで削除します。

ステータスファイルをstsinitコマンドで作成します。

作成したステータスファイルをstsopenコマンドでオープンして，予備状態にします。

予備ファイルがないとき

片系運転可の場合，現用ファイルの片系に障害が発生すると，正常な系だけで処理を続行します。ただし，片系運転中に正常な系に障害が発生したり，ファイルの更新中に異常終了したりすると，OpenTP1を再開始できなくなります。そのため，現用ファイルが片系運転状態となった場合，ユーザは次のどちらかの対策を実施してください。

予備ファイルを用意してスワップ
現用ファイルを次の手順でスワップしてください。
1.　無効ファイルをstsopenコマンドでオープンし，予備ファイルを用意します。
2.　stsswapコマンドを実行して現用ファイルをスワップします。

障害が発生した系のファイルを回復
障害が発生して閉塞したファイルの内容を次の手順で回復してください。
1.　閉塞した系のファイルをstsrmコマンドで削除します。
2.　削除したファイルをstsinitコマンドで初期設定します。
3.　初期設定したファイルをstsopenコマンドでオープンします。
stsopenコマンドを実行すると，正常な系のファイルの内容が，障害が発生した系のファイルに複写されます。複写が完了した時点で，現用決定時刻を新たに取得し，現用ファイルとして回復します。

片系運転不可の場合，OpenTP1は異常終了します。

予備ファイルを用意したあと，OpenTP1を再開始します。その後，次の手順で障害が発生したステータスファイルを初期設定してください。

障害が発生して閉塞したステータスファイルをstsrmコマンドで削除します。

ステータスファイルをstsinitコマンドで作成します。

作成したステータスファイルをstsopenコマンドでオープンして，予備状態にします。

(b)　読み込み時

ステータスファイルはA系の現用ファイルから読み込まれます。A系の現用ファイルを読み込み中に障害が発生した場合，B系の現用ファイルを読み込めるかどうかでユーザの対処方法が異なります。

B系の現用ファイルが読み込めるとき

A系とB系の予備ファイルがある場合，OpenTP1はB系の現用ファイルの内容をA系とB系の予備ファイルに複写します。

A系とB系の予備ファイルがない場合，OpenTP1が停止します。A系とB系の予備ファイルを用意したあと，OpenTP1を再開始してください。その後，次の手順で新しいステータスファイルを用意してください。

障害が発生して閉塞したA系の物理ファイルをstsrmコマンドで削除します。

A系の物理ファイルをstsinitコマンドで初期設定します。

初期設定したファイルをstsopenコマンドでオープンします。

A系，B系の現用ファイルが読み込めないとき

OpenTP1が停止します。

次の手順でOpenTP1を開始してください。ただし，仕掛り中だった処理は引き継げません。DAM FRC，TAM FRCを実行してください。

障害が発生したステータスファイルをstsinitコマンドで初期設定します。

OpenTP1をdcstart -nコマンドで強制的に正常開始します。

(2)　再開始時

ステータスサービス定義の指定によって，対処方法が異なります。

(a)　sts_initial_error_switchの指定を省略，またはstopと指定した場合

ステータスファイルに障害が発生した場合，OpenTP1が異常終了します。定義に指定したステータスファイルに一つでも障害があれば，OpenTP1を開始しません。対処方法は，障害が発生したファイルによって異なります。

障害が発生したファイルが前回の現用ファイルの場合

A系，B系の現用ファイルが両方とも障害となった場合，次の手順でOpenTP1を開始してください。ただし，仕掛り中だった処理は引き継げません。

DAM FRC，TAM FRCを実行してください。

障害が発生したステータスファイルをstsinitコマンドで初期設定します。

OpenTP1をdcstart -nコマンドで強制的に正常開始します。

A系，B系の現用ファイルのどちらか片方だけが障害となった場合，次の手順でOpenTP1を開始してください。

現用ファイルをスワップするための予備ファイルがあるかどうかを確認します。予備ファイルがない場合は，stsinitコマンドで予備ファイルを作成します。

ステータスサービス定義のsts_initial_error_switchオペランドの指定をcontinueに変更します。

OpenTP1を再開始します。

障害が発生したファイルが前回の現用ファイルではない場合

次の手順でOpenTP1を開始してください。

障害が発生したファイルの実体がある場合は，stsrmコマンドで削除します。

ステータスファイルをstsinitコマンドで初期設定します。

OpenTP1を再開始します。

(b)　sts_initial_error_switch=continueまたはsts_initial_error_switch=excontinueと指定した場合

ステータスファイルに障害が発生しても処理を続行します。最新の現用ファイルの片系に障害が発生した場合は，正常な系の内容を予備ファイルのA系とB系に複写します。その後，現用ファイルと予備ファイルを切り替えて，OpenTP1を開始します。ただし，複写できる予備ファイルがない場合，OpenTP1は異常終了します。また，excontinueを指定した場合，初期化状態のファイルは現用ファイルとはしません。

なお，sts_initial_error_switch=continueと指定すると，OpenTP1は，再開始時にオープンできたファイルの中からいちばん新しい現用決定時刻を持つファイルを現用ファイルと決定します。しかし，両系ともオープンできないファイルが一組でもある場合，現用と決定したファイルが本当に前回の現用ファイルであるかどうか，ステータスサービスは判断できません。このような場合，ステータスサービス定義でsts_last_active_fileオペランドに前回のオンラインで最新の現用ファイルだった論理ファイルの名称を指定しておくことで，OpenTP1が決定した現用ファイルが正しい現用ファイルかどうかを調べることができます。OpenTP1が決定した現用ファイルがsts_last_active_fileオペランドで指定した論理ファイル名と一致した場合，開始処理を続行します。一致しなかった場合，開始処理を停止します。ユーザは，A系，B系の現用ファイルが両方とも障害となった場合と同様に対処してください。sts_last_active_fileオペランドの指定がなく，かつ現用ファイルを決定できない場合は，開始処理を停止します。

前回のオンライン中に現用ファイルの片系に障害が発生していた場合，片系運転後の再開始時に誤ったファイルを現用に選択しないために，ステータスサービス定義のsts_last_active_sideオペランドに正常な系を指定します。

再開始時，sts_last_active_sideオペランドに指定した系だけがオープンできた場合は，スワップします。スワップできないとOpenTP1は停止します（ステータスサービス開始時の現用ファイルの片系運転はできません）。また，sts_last_active_sideオペランドに指定した系がオープンできないと，OpenTP1は停止します。

現用と決定されたファイルのA系，B系の内容が異なる場合，sts_last_active_sideオペランドに指定された系に関係なく，最新の情報を持つ系を現用と見なして古い情報を持つ系に複写後，再開始します。

なお，ステータスサービスは，ステータスサービス起動中に発生したステータスファイル障害，およびオンライン中に障害が発生した現用ファイルの閉塞状態だけを再開始時に引き継ぎます。このため，オンライン中にstsopenコマンドでオープン，またはstscloseコマンドでクローズした状態は引き継ぎません。

また，ステータスサービスは，オフラインでstsinitコマンド，またはstsrmコマンドを実行したときのステータスファイルの状態を認識しません。

(3)　正常開始時

再開始時の場合と同様に対処してください。

10.2.2　システムジャーナルファイル

＜この項の構成＞

(1)　オンライン中

(2)　再開始時

(1)　オンライン中

(a)　書き込み時

スワップ先のファイルグループがある場合

現用のファイルグループへジャーナルを書き込み中に障害が発生した場合，スワップして，新しい現用のファイルグループへジャーナルデータを出力します。このとき，スワップする前の現用のファイルグループはクローズされ，予約となります。

ユーザが業務履歴を残しておく必要がある処理をしている場合は，障害が発生して予約となったファイルグループをjnlunlfgコマンドでアンロードしてください。

アンロードできなかった場合は，次の手順で対処してください。ただしこの場合，ジャーナルを残すことはできません。ジャーナルがないとDAM FRCやTAM FRCを実行できなくなるので，バックアップを取得しておく必要があります。

アンロードできないファイルグループをjnlrmコマンドで削除します。

jnlinitコマンドでファイルグループを再び作成します。

jnlopnfgコマンドでファイルグループをオープンします。

スワップ先のファイルグループがない場合

スワップ先となる上書きできる待機のファイルグループがないと，OpenTP1は異常終了します。この場合，次の手順で対処してください。

すべてのアンロード待ち状態のファイルグループをjnlunlfgコマンドでアンロードし，上書きできる待機ファイルグループを用意します。

OpenTP1を再開始します。

なお，上書きできる待機のファイルグループを用意できない場合は，システムジャーナルサービス定義に新たにONL指定のファイルグループの定義を追加したあと，OpenTP1を再開始してください。

(b)　読み込み時

システムジャーナルファイルを二重化している場合，A系の現用ファイルから読み込みます。A系の現用ファイルを読み込み中に障害が発生した場合，B系の現用ファイルに切り替えて読み込みます。

(2)　再開始時

(a)　ジャーナルの出力位置の回復

再開始でファイルグループの状態を回復したあと，ジャーナルの出力位置を回復するときにエラーが発生すると，OpenTP1は停止します。エラーメッセージが出力されるので理由コードに従ってエラーの原因を取り除いたあと，OpenTP1を再開始してください。

(b)　ファイルグループの追加

全面回復時，システムジャーナルサービス定義に新たにファイルグループを追加できます。

(c)　スワップ

システムジャーナルサービス定義でjnl_rerun_swap=Yと指定すると，再開始でのジャーナル出力位置の回復後にスワップします。また，Yを指定していない場合でも，ジャーナル出力位置の回復時に前回現用であったと思われるファイルグループに障害が発生，またはアンロードされていた場合も，ジャーナル出力位置の回復後にスワップします。

(d)　予約ファイルのオープン

システムジャーナルサービス定義でjnl_rerun_reserved_file_open=Yと指定すると，次の二つの条件を満たす場合に，予約ファイルを自動的にオープンします。

現用のファイルグループ以外の使用できるファイルグループのすべてがスワップできない状態の場合

再開始時に使用できるシステムジャーナルファイルの容量を超えてしまい，スワップ先として使用できるファイルグループがない場合

10.2.3　アーカイブジャーナルファイル

＜この項の構成＞

(1)　オンライン中

(2)　再開始時

(1)　オンライン中

(a)　書き込み時

スワップ先のファイルグループがある場合

現用のファイルグループへジャーナルを書き込み中に障害が発生した場合，スワップして，新しい現用のファイルグループへジャーナルを出力します。このとき，スワップする前の現用のファイルグループはクローズされ，予約となります。障害が発生して予約となったファイルグループは，jnlunlfgコマンドでアンロードしてください。

アンロードできなかった場合は，次の手順で対処してください。ただし，この場合ジャーナルを残すことはできません。ジャーナルがないとDAM FRCやTAM FRCを実行できなくなるので，バックアップを取得しておく必要があります。

アンロードできないファイルグループをjnlrmコマンドで削除します。

jnlinitコマンドでファイルグループを再び作成します。

jnlopnfgコマンドでファイルグループをオープンします。

スワップ先のファイルグループがない場合

スワップ先となるファイルグループがないと，OpenTP1は異常終了します。ただし，被アーカイブジャーナルノードのOpenTP1はそのまま続行します。この場合，次の手順で対処してください。

すべてのアンロード待ち状態のファイルグループをjnlunlfgコマンドでアンロードします。

OpenTP1を再開始します。

(b)　読み込み時

アーカイブジャーナルファイルを二重化している場合，A系の現用ファイルグループから読み込みます。A系の現用ファイルを読み込み中に障害が発生した場合，B系の現用ファイルに切り替えて読み込みます。

(2)　再開始時

再開始でファイルグループの状態を回復したあと，ジャーナルの出力位置を回復するときにエラーが発生すると，ジャーナルの読み込みを中止し，OpenTP1の再開始を続行します。ジャーナルの出力位置は，エラーが発生する直前までに読み込んだジャーナルを基に決定します。

なお，OpenTP1の再開始が完了したあと，読み込めないで失われたジャーナルから，アーカイブを再開します。

10.2.4　リカバリジャーナルファイル

＜この項の構成＞

(1)　トランザクションリカバリジャーナルファイル

(2)　サーバリカバリジャーナルファイル

(1)　トランザクションリカバリジャーナルファイル

(a)　 オンライン中

トランザクションリカバリジャーナルファイルに障害が発生すると，エラーメッセージが出力されます。出力されたエラーメッセージに従って，jnlmkrfコマンドを実行してください。jnlmkrfコマンドを実行すると，OpenTP1がトランザクションリカバリジャーナルファイルを回復します。回復できない場合は，OpenTP1を停止し，damfrcコマンドやtamfrcコマンドを実行してリソースマネジャを回復したあと，OpenTP1を強制的に正常開始してください。

(b)　再開始時

再開始時にトランザクションリカバリジャーナルファイルに障害が発生した場合は，damfrcコマンドやtamfrcコマンドを実行してリソースマネジャを回復したあと，OpenTP1を強制的に正常開始してください。

(2)　サーバリカバリジャーナルファイル

(a)　再開始時

サーバリカバリジャーナルファイルに障害が発生してKFCA03015-Eのメッセージが出力された場合は，jnlmkrfコマンドを実行してサーバリカバリジャーナルファイルを回復してください。サーバリカバリジャーナルファイルの回復にはKFCA03015-Eのメッセージで表示された世代のアンロードジャーナルが必要です。なお，現世代のジャーナルも必要です。現世代のシステムジャーナルファイルも必ずアンロードしてください。

jnlmkrfコマンドを実行してもサーバリカバリジャーナルファイルが回復できない場合は，damfrcコマンドやtamfrcコマンドを実行してリソースマネジャを回復したあと，OpenTP1を強制的に正常開始してください。

10.2.5　チェックポイントダンプファイル

＜この項の構成＞

(1)　オンライン中

(2)　再開始時

(1)　オンライン中

(a)　物理ファイルの再作成

チェックポイントダンプを書き込み時に障害が発生した場合，OpenTP1はメッセージログファイルにメッセージを出力し，障害が発生したファイルグループをクローズして予約のファイルグループにしたあと，上書きできる状態のファイルグループの中から出力先を選び直して，再びチェックポイントダンプを出力します。

ユーザは，該当するファイルグループが予約に変更されない場合に限って，jnlclsfgコマンドで障害が発生したファイルグループをクローズして予約のファイルグループにしてください。

jnlclsfgコマンドで予約にしたファイルグループは，次の手順で上書きできるファイルグループにすることができます。

ファイルグループをjnlrmコマンドで削除します。

ファイルグループをjnlinitコマンドで再び作成します。

作成したファイルグループをjnlopnfgコマンドでオープンします。

(b)　物理ファイルの再割り当て

オンライン中にjnladdpfコマンドで割り当てた物理ファイルに障害が発生した場合，別の物理ファイルを割り当てます。

二重化の運用の場合は，A系またはB系のどちらかの系だけを操作して，別の物理ファイルを割り当てられます。ただし，そのファイルグループはいったん予約状態になるので，両系とも物理ファイルの内容は無効になります。また，片系が切り離された状態では，ファイルグループは使用できません。

手順を次に示します。

障害が発生したファイルグループをクローズします。
jnlclsfgコマンドでファイルグループをクローズして，予約状態にしてください。

物理ファイルを削除します。
jnldelpfコマンドでファイルグループから障害が発生した物理ファイルを削除します。
A系，B系を指定できます。

別の物理ファイルを割り当てます。
jnladdpfコマンドで正常な物理ファイルを割り当てます。A系，B系を指定できます。

ファイルグループをオープンします。
jnlopnfgコマンドでファイルグループをオープンし，上書きできる状態にします。

(c)　片系の再作成

片系運転可の二重化運用時に，チェックポイントダンプファイルの片系障害が発生した場合は，障害の発生した系を再作成して両系を使用可能にできます。片系の再作成は，上書きできる状態のファイルグループだけ実行できます。

手順を次に示します。

障害が発生した系をクローズします。
jnlclsfgコマンドで障害の系をクローズしてください。すでにクローズしている場合に実行すると，コマンドエラーになります。
なお，正常な系にjnlclsfgコマンドを実行してはなりません。実行すると，物理ファイルの内容が無効になります。

障害の系を削除します。
jnlrmコマンドで障害の系の物理ファイルを削除します。

物理ファイルを再作成します。
jnlinitコマンドで障害の系に割り当てる物理ファイルを再度初期設定してください。

物理ファイルをオープンします。
jnlopnfgコマンドで再作成した物理ファイルをオープンします。

(2)　再開始時

OpenTP1を再開始すると，前回のOpenTP1でオープン中であったすべてのファイルグループをオープンします。

(a)　チェックポイントダンプファイルを二重化していない場合

オープンできなかったファイルグループ，および前回のオンラインで予約だったファイルグループは予約となります。

(b)　チェックポイントダンプファイルを二重化している場合

A系，またはB系どちらかのファイルがオープンできなかった場合

片系運転可の運用の場合，正常な系をオープンして処理を続行します。ただし，片系運転不可の運用の場合，読み込みが完了したあと，または上書きできない状態から上書きできる状態になった時に，ファイルグループは予約状態になります。

A系，B系のファイルが両方ともオープンできた場合

A系から読み込んで回復します。

片系運転可の運用でA系からの読み込みに失敗した場合は，B系から読み込みます。片系運転不可の運用でA系からの読み込みに失敗した場合は，B系から読み込んだあと（上書きできない状態のときは，上書きできる状態になったあと）にファイルグループは予約状態になります。

回復に必要なチェックポイントダンプファイルが，オープンエラーなどで読み込めない場合，OpenTP1はメッセージログファイルにメッセージを出力し，できるかぎりチェックポイントダンプの読み込みを続行します。

なお，再開始時にチェックポイントダンプサービス定義の追加，変更，削除はできません。

10.2.6　DAMファイル

＜この項の構成＞

(1)　DAM FRCの手順

(2)　DAM FRCが障害などで中断されたとき

(1)　DAM FRCの手順

DAMファイルに障害が発生すると，障害メッセージが表示され，DAMファイルは閉塞します。この場合ユーザは，次の手順でDAM FRCを実行してください。

なお，DAM FRCは，回復対象ファイルに対してだけ実行できます。回復対象外ファイルは，更新情報をジャーナルに取得しないため，DAM FRCは実行できません。

damrmコマンドを実行して，障害が発生したファイルの論理ファイルをOpenTP1から切り離します。

jnlswpfg，およびjnlunlfgコマンドを実行して，DAMファイルの回復に必要なジャーナルを準備します。

オンライン開始前，またはオンライン中に取得したバックアップファイルをdamrstrコマンドでリストアして，DAMファイルをオンライン開始前，またはオンラインバックアップ実施時の状態に回復します。このとき，damdelコマンドで障害が発生した物理ファイルを削除するか，または障害が発生したパーティションとは異なるパーティションに物理ファイルを割り当てます。物理ファイル名は，オンライン時と同じ名称にする必要はありません。

回復対象定義ファイルに，回復したいDAMファイルを定義します。回復対象定義ファイルはOSのテキストエディタで作成します。
定義形式を次に示します。

〔△〕論理ファイル△物理ファイル名〔△〕（改行）
〔論理ファイル△物理ファイル名〕〔△〕（改行）
       ：           ：
〔論理ファイル△物理ファイル名〕〔△〕（改行）

指定する物理ファイルは，バックアップしたファイルをリストアしたものです。オンラインバックアップしたファイルをリストアしたもの，またはオフライン状態でバックアップしたファイルをリストアしたもののどちらかを指定してください。混在はできません。

damfrcコマンドでDAM FRCを実行します。

damaddコマンドを実行して，回復処理が終了したDAMファイルを再びOpenTP1に追加登録します。

damrlesコマンドを実行して，論理ファイルの閉塞状態を解除します。論理ファイルの閉塞状態を解除すると，障害回復したDAMファイルを各トランザクションでアクセスできるようになります。

(2)　DAM FRCが障害などで中断されたとき

複数のアンロードジャーナルファイルを使用してDAM FRCを実行中に，障害などによって処理が中断された場合には，damfrcコマンドを再び実行してください。OpenTP1が引き継ぎファイルを参照し，処理済み以降のアンロードジャーナルファイルを使用してDAM FRCを実行します。ただし，-sオプションを指定すると引き継ぎファイルを参照しないため，-sオプションは指定しないでください。処理済みのアンロードジャーナルファイルがない場合，ジャーナルファイル不正で処理が中断されます。この場合は，-sオプションを指定してdamfrcコマンドを再び実行してください。

10.2.7　TAMファイル

＜この項の構成＞

(1)　TAM FRCの手順

(2)　TAM FRCが障害などで中断されたとき

(3)　I/O障害処理続行型テーブル使用時

(1)　TAM FRCの手順

TAMファイルに障害が発生すると，障害メッセージが表示され，TAMファイルは閉塞します。この場合ユーザは，次の手順でTAM FRCを実行してください。

tamrmコマンドを実行して，障害が発生したTAMファイルに対応するTAMテーブルをOpenTP1から切り離します。

jnlswpfg，およびjnlunlfgコマンドを実行して，TAMファイルの回復に必要なジャーナルを準備します。

オンライン開始前，またはオンライン中に取得したバックアップファイルをtamrstrコマンドでリストアして，TAMファイルをオンライン開始前，またはオンラインバックアップ実施時の状態に回復します。このとき，tamdelコマンドで障害が発生したTAMファイルを削除するか，または障害が発生したパーティションとは異なるパーティションにTAMファイルを割り当てます。TAMファイルの名称は，オンライン時と同じ名称にする必要はありません。

tamfrcコマンドでTAM FRCを実行します。

tamaddコマンドを実行して，回復処理が終了したTAMファイルをOpenTP1に追加登録します。

tamrlesコマンドを実行して，TAMテーブルの閉塞状態を解除します。TAMテーブルの閉塞状態を解除すると，障害回復したTAMファイルを各トランザクションでアクセスできるようになります。

(2)　TAM FRCが障害などで中断されたとき

複数のアンロードジャーナルファイルを使用してTAM FRCを実行中に，障害などによって処理が中断された場合には，tamfrcコマンドを再び実行してください。OpenTP1が引き継ぎファイルを参照し，処理済み以降のアンロードジャーナルファイルを使用してTAM FRCを実行します。ただし，-sオプションを指定すると引き継ぎファイルを参照しないため，-sオプションは指定しないでください。処理済みのアンロードジャーナルファイルがない場合，ジャーナルファイル不正で処理が中断されます。この場合は，-sオプションを指定してtamfrcコマンドを再び実行してください。

(3)　I/O障害処理続行型テーブル使用時

(a)　オンライン異常終了後の回復処理

I/O障害処理続行型テーブルを使用して更新処理を続行しているときにオンラインが異常終了した場合，該当するTAMファイルを回復する手順を次に示します。

該当するTAMファイルのバックアップファイルを，tamrstrコマンドでリストアします。

バックアップ取得以降，オンライン異常終了までのジャーナルを，jnlunlfgコマンドでアンロードします。

アンロードジャーナルファイルとリストアしたTAMファイルを指定して，tamfrcコマンドを実行します。

回復済みのTAMファイルを指定したtamaddコマンドを実行して，オンラインにTAMテーブルを追加登録します。

tamrlesコマンドで論理閉塞を解除します。

(b)　オンライン処理中の回復処理

I/O障害処理続行型テーブルを使用して更新処理を続行しているときに，オンラインを終了しないでTAMファイルを回復する手順を次に示します。

該当するI/O障害処理続行型テーブルに対するアクセスが終了した時点で，該当するTAMテーブルをtamholdコマンドで論理閉塞します。

TAMテーブルをtamrmコマンドでオンラインから切り離します。または，-oオプション指定のtambkupコマンドを実行してオンライン状態でTAMファイルをバックアップしたあと，tamrmコマンドを実行してオンラインから切り離します。

該当するTAMファイルに対するバックアップファイルを，tamrstrコマンドでリストアします。

バックアップ取得以降，オンライン異常終了までのジャーナルを，jnlunlfgコマンドでアンロードします。ただし，2.で-oオプション指定のtambkupコマンドを実行した場合，jnlunlfgコマンドを実行する必要はありません。

アンロードジャーナルファイルとリストアしたTAMファイルを指定して，tamfrcコマンドを実行します。ただし，2.で-oオプション指定のtambkupコマンドを実行した場合，tamfrcコマンドを実行する必要はありません。

回復済みのTAMファイルを指定して，tamaddコマンドでTAMテーブルをオンラインに追加登録します。tamaddコマンド実行後，tamrlesコマンドでTAMテーブルの閉塞状態を解除します。

(c)　オンライン正常終了後の回復処理

I/O障害処理続行型テーブルを使用して更新処理を続行し，オンラインを正常終了した場合，該当するTAMファイルをオフラインで回復してください。回復しないと，TAMファイルの状態がオンラインでアクセスした状態と異なるため，次回のオンラインでは使用できません。

該当するTAMファイルに対するバックアップファイルを，tamrstrコマンドでリストアします。

バックアップ取得以降，オンライン正常終了までのジャーナルを，jnlunlfgコマンドでアンロードします。

アンロードジャーナルファイルとリストアしたTAMファイルを指定して，tamfrcコマンドを実行します。

10.2.8　メッセージキューファイル

メッセージキューファイルに障害が発生すると，エラーメッセージが出力されます。

エラーメッセージに従って，次のように対処してください。

＜この項の構成＞

(1)　物理ファイルの容量不足の場合

(2)　ファイル障害の場合

(3)　ディスクキューが使用できない場合

(1)　物理ファイルの容量不足の場合

OpenTP1をいったん正常終了させます。-rオプション指定のqueinitコマンドでメッセージキュー用物理ファイルの容量を増やしたあと，OpenTP1を開始してください。

(2)　ファイル障害の場合

OpenTP1をいったん正常終了させます。quermコマンドでメッセージキュー用物理ファイルを削除し，新たにqueinitコマンドでメッセージキュー用物理ファイルを割り当てたあと，OpenTP1を開始してください。

(3)　ディスクキューが使用できない場合

MCFマネジャ定義の拡張予約定義でメモリキューの縮退運転を指定すると，MCF開始時に何らかの理由でディスクキューが使用できない場合に，メモリキューを代用して処理を続行できます。ただし，メモリキューで代用した場合，全面回復時にメッセージを回復できません。

オンライン中にディスクキューが使用できなくなったときに，メモリキューで代用することはできません。

メモリキューの縮退運転を開始すると，KFCA11065-WメッセージまたはKFCA11066-Wメッセージが出力されます。これらのメッセージが出力された場合は，縮退運転から復旧する必要があります。

縮退運転となる代表的な原因は，定義間の情報の不一致です。定義間で情報に不一致が発生する例を次に示します。

MCFアプリケーション定義のアプリケーション属性定義で指定したキューグループID（mcfaalcap -g quegrpid=キューグループID）が，メッセージキューサービス定義に指定されていない

MCF通信構成定義の論理端末定義で指定したキューグループID（mcftalcle -k quegrpid=キューグループID）が，メッセージキューサービス定義に指定されていない

これらの場合は，次に示す手順でメモリキューの縮退運転から復旧します。

OpenTP1システムを停止します。

メッセージキューサービス定義に不足しているキューグループIDを追加します。または，キューグループIDが誤っている場合は，訂正します。

手順2でキューグループIDを追加した場合は，対応するメッセージキューファイルの物理ファイルをqueinitコマンドで割り当てます。

手順2でMCFアプリケーション定義またはMCF通信構成定義を訂正した場合は，ユティリティ起動コマンドで定義オブジェクトファイルを生成します。

OpenTP1システムを正常開始します。

なお，メッセージキューファイルに障害が発生すると，キューイング中のメッセージは回復できません。受信メッセージの場合，IJを取得すると入力キューに格納しようとしたメッセージを確認できます。送信メッセージの場合，OJを取得すると出力キューに格納しようとしたメッセージを確認できます。IJ，OJを取得するかどうかは，アプリケーション属性定義で指定します。

10.2.9　XARファイル

XARファイルに障害が発生すると，障害メッセージが表示され，XARファイルは閉塞します。この場合，XARファイルを回復させる必要があります。XARファイルの回復方法の詳細は，「3.15.4　XARファイルに障害が発生した場合の運用」を参照してください。

10.2.10　MCF定義ファイル

MCF定義ファイルに障害が発生すると，エラーメッセージが出力されて，OpenTP1は停止します。出力されたエラーメッセージの理由コードに従って障害原因を取り除いたあと，OpenTP1を再開始してください。

10.3　ファイル障害

ファイルに障害が発生した場合の対処方法を説明します。

＜この節の構成＞

10.3.1　メッセージログファイル

10.3.1　メッセージログファイル

メッセージログファイルに障害が発生すると，エラーメッセージは標準エラー出力に出力されます。

ユーザは障害が発生したメッセージログファイルを削除して，OpenTP1を再開始してください。障害が発生したメッセージログファイルの内容を残しておきたい場合は，別名称のファイルにバックアップしてください。

10.4　通信障害

通信上の障害が発生した場合の対処方法を説明します。

＜この節の構成＞

(1)　通信制御装置，端末，回線障害

(2)　LAN障害

(3)　マルチノード機能使用時の通信障害

(1)　通信制御装置，端末，回線障害

コネクションに障害が発生した場合，出力されたエラーメッセージの理由コードに従って障害の原因を取り除いてください。その後，mcftactcnコマンドでコネクションを再び確立してください。

なお，障害発生時の対処方法の詳細は，各プロトコルのマニュアルを参照してください。

(2)　LAN障害

LANの障害が発生すると，エラーメッセージが出力されて，計算機間のRPCによるプロセス間通信でクライアントUAPはエラーリターンします。

OS，およびハードウェアの障害対策に従って障害原因を取り除いたあと，OpenTP1を再開始してください。

(3)　マルチノード機能使用時の通信障害

グローバルアーカイブジャーナルサービスと被アーカイブジャーナルノードのジャーナルサービスとの間で通信障害が発生した場合，エラーメッセージが出力されます。このメッセージに従って障害の原因を取り除いてください。

通信障害の間は，被アーカイブジャーナルノードのジャーナルはアーカイブされません。その結果，被アーカイブジャーナルノードのシステムジャーナルファイルのスワップ先がなくなると，被アーカイブジャーナルノードのOpenTP1は停止します。そのため，個別にアンロードしてください。

また，通信が復旧すると，個別にアンロードしていても，転送されていないジャーナルからアーカイブを再開します。個別のアンロードとスワップによって，アーカイブしなければならないジャーナルをすでに失っていた場合は，以降の該当するノードのアーカイブは中止します。そのため，通信復旧後も個別にアンロードしてください。

なお，通信障害の間にアーカイブジャーナルノード，または被アーカイブジャーナルノードを停止する場合は，必ず強制停止してください。

10.5　UAP障害

UAPに障害が発生した場合の対処方法を説明します。

＜この節の構成＞

10.5.1　UAPを開始できない場合

10.5.2　UAPが終了しない場合

10.5.3　UAPが異常終了する場合

10.5.4　UAPのデッドロックが発生する場合

10.5.1　UAPを開始できない場合

＜この項の構成＞

(1)　システム定義が誤っているとき

(2)　メモリの容量が不足しているとき

(1)　システム定義が誤っているとき

ユーザサービス構成定義，ユーザサービス定義の定義内容が誤っている旨のメッセージが出力されます。定義項目を見直し，正しく指定し直したあと，UAPを再び開始してください。

(2)　メモリの容量が不足しているとき

メモリの容量が不足している旨のメッセージが出力されます。共用メモリの場合は，システム定義の定義項目を見直してください。プロセス固有のメモリの場合は，必要ないプロセスを停止させてください。

10.5.2　UAPが終了しない場合

UAPの状態はprcls，scdlsコマンド，またはOSのpsコマンドで確認できます。

UAPの処理が終わらないで続く場合，UAPを強制停止してください。

10.5.3　UAPが異常終了する場合

UAPの処理が異常終了したのか，またはOpenTP1が異常終了したのかがメッセージに出力されます。

UAPの処理が異常終了した場合は，UAPを修正したあと，UAPを再び開始してください。

HP-UXの場合，UAPのリンケージのバインドモードはimmediateにしてください。immediate以外の場合は，UAPが原因不明で異常終了する場合があります。OSのchatrコマンドでimmediateかどうかを確認してください。

OpenTP1が異常終了した場合は，保守員に連絡してください。

10.5.4　UAPのデッドロックが発生する場合

使用する資源の順序がそろうようにUAPを修正したあと，UAPを再び開始してください。

10.6　OpenTP1障害

OpenTP1に障害が発生した場合の対処方法を説明します。

＜この節の構成＞

10.6.1　OpenTP1を開始できない場合

10.6.2　OpenTP1が停止しない場合

10.6.3　OpenTP1が異常終了した場合

10.6.4　OpenTP1の運用コマンドが正常終了しない場合

10.6.5　OpenTP1の運用コマンドが応答待ちタイムアウトになる場合

10.6.6　マルチノード機能使用時のOpenTP1障害

10.6.1　OpenTP1を開始できない場合

＜この項の構成＞

(1)　OpenTP1が正しくインストール，およびセットアップされていないとき

(2)　システム定義が誤っているとき

(3)　メモリ，またはディスクの容量不足のとき

(4)　OpenTP1の開始に必要なファイルがないとき

(5)　OSの構成がOpenTP1の実行環境として不適当なとき

(6)　TCP/IP環境がセットアップされていないとき

(7)　ハードウェア（ディスク，LAN）不良のとき

(8)　ユーザ環境設定のコマンドが誤っているとき

(9)　KFCA00715-Eが出力されるとき

(10)　CPUの負荷が高いとき

(1)　OpenTP1が正しくインストール，およびセットアップされていないとき

OpenTP1のインストール，およびセットアップをやり直してください。

(2)　システム定義が誤っているとき

システム定義で指定しなければならない項目の不良内容が，メッセージに出力されます。

システム定義の定義項目を見直し，正しく指定し直したあと，OpenTP1を再開始してください。

(3)　メモリ，またはディスクの容量不足のとき

メモリ，またはディスクの容量が不足している旨のメッセージが出力されます。

必要ないプロセスを停止させるか，または必要ないファイルを削除したあと，OpenTP1を再開始してください。

また，必要に応じて，OSのシステム定数（特に共用メモリ関連）を見直し，OSを構築し直してください。OpenTP1の定義内容も見直したあと，OpenTP1を再開始してください。

(4)　OpenTP1の開始に必要なファイルがないとき

必要なファイルがない旨のメッセージが出力されます。

必要なファイルを準備したあと，OpenTP1を再開始してください。

(5)　OSの構成がOpenTP1の実行環境として不適当なとき

OSを構築し直し，OpenTP1の定義内容も見直したあと，OpenTP1を再開始してください。

(6)　TCP/IP環境がセットアップされていないとき

通信不良のメッセージが出力されます。

TCP/IP環境を正しくセットアップしたあと，OpenTP1を再開始してください。

(7)　ハードウェア（ディスク，LAN）不良のとき

入出力エラーのメッセージが出力されます。

不良デバイスを修理，または交換してください。

(8)　ユーザ環境設定のコマンドが誤っているとき

システム環境定義のuser_commandオペランドで指定したユーザ環境設定コマンドに誤りがあると，OpenTP1を開始しようとしても，メッセージもダンプも出力されないで，開始できない場合があります。

user_commandオペランドで指定したユーザ環境設定コマンドが正しいかどうかを見直して，対策後に再度OpenTP1を開始してください。

(9)　KFCA00715-Eが出力されるとき

KFCA00715-Eメッセージが出力された場合，dcresetコマンドを実行してください。KFCA00715-Eメッセージは，OpenTP1の開始処理，または再開始処理ができない場合に出力されます。これは，何らかの障害でプロセスサービスの処理が中断したことを示します。メッセージ中に要因コードが示されるので，OpenTP1が開始処理，または再開始処理ができない障害を取り除いたあとに，dcresetコマンドを実行してください。障害が取り除かれない場合に，dcresetコマンドを実行してもKFCA00715-Eメッセージが再出力されます。

dcresetコマンドは，OpenTP1が終了しているときに実行してください。システム共通定義を変更する場合は，OpenTP1を正常終了して実行しますが，KFCA00715-Eメッセージが出力された場合は，異常終了時でもdcresetコマンドを実行できます。OpenTP1オンライン中にdcresetコマンドを実行するとシステムダウンします。

(10)　CPUの負荷が高いとき

JP1/AJSを使用してジョブからOpenTP1を開始するよう設定している場合，dcstartコマンドでOpenTP1を開始できないことがあります。このとき，CPUの利用率を確認すると，利用率が100%で，そのほとんどをOpenTP1のシステムサーバプロセスが占有していると表示されます。

JP1/AJSを使用してジョブからOpenTP1を開始するよう設定している場合，dcstartコマンドのOSプライオリティが最低値（nice値が39）に設定されます。そのため，多数のシステムサーバプロセスによってCPUの負荷が高まったとき，dcstartコマンドにCPUが割り当てられません。

次のようなマシン構成の場合，この現象が発生しやすくなります。

CPUの搭載数が1個

OpenTP1のシステムサーバプロセスが多い

この現象が発生している場合，psコマンドを実行して，dcstartコマンドのプロセスのnice値を確認してください。psコマンドの実行例を次に示します。

AIXの場合

ps -elf|grep dcstart
 200001 A   betran  16382  21390   2  60 20※ e7e4  3780          15:56:13  pts/1  0:00 dcstart

HP-UXの場合

ps -elf|grep dcstart
 1 S   betran  6995  6932  0 154 20※         41516c00  344           c0fa80 15:56:43 pts/tn 0:00 dcstart

注※

nice値を示します。この数値が39と表示されている場合，dcstartコマンドのOSプライオリティが最低値になっています。

OpenTP1の運用コマンドを実行するときのOSプライオリティは，OpenTP1のプライオリティと同じ値を設定することをお勧めします。OpenTP1のdcstartコマンドのプロセスを起動するJP1/AJSのジョブ定義の実行優先順位を，JP1/AJS - Viewから変更することで，OpenTP1の運用コマンドのプライオリティを変更できます。詳細については，マニュアル「JP1/Automatic Job Management System 操作ガイド」を参照してください。

10.6.2　OpenTP1が停止しない場合

＜この項の構成＞

(1)　UAPの処理が長く続くか，または不良でUAPが終了しないとき

(2)　正常終了時，通信不良などで出力キューにたまったメッセージが出力されないとき

(3)　接続しているジャーナルサービスが終了しないため，アーカイブジャーナルノードのOpenTP1が停止しないとき

(4)　グローバルアーカイブジャーナルサービスとの接続が解除できないため，被アーカイブジャーナルノードのOpenTP1が停止しないとき

(1)　UAPの処理が長く続くか，または不良でUAPが終了しないとき

UAPの状態は，prcls，scdlsコマンド，またはOSのpsコマンドで確認できます。

UAPの処理が終わらないで続く場合，UAPの終了を待つか，または終了しないUAPを強制停止させてください。

(2)　正常終了時，通信不良などで出力キューにたまったメッセージが出力されないとき

一定時間（MCF通信構成定義で指定した未処理送信メッセージ滞留時間）を経過すると，MCFの未処理送信メッセージ廃棄通知イベント（ERREVTA）が通知され，OpenTP1は正常終了します。このとき出力キュー上の未送信メッセージは破棄されます。

未送信メッセージを破棄したくない場合は，未処理送信メッセージ滞留時間を経過する前にOpenTP1を強制停止させてください。その後，OpenTP1を再開始すれば未送信メッセージを引き継げます。

(3)　接続しているジャーナルサービスが終了しないため，アーカイブジャーナルノードのOpenTP1が停止しないとき

アーカイブジャーナルノードのOpenTP1を正常終了，または計画停止するには，すべてのジャーナルサービスとの接続が解除されなければなりません。そのため，接続中の被アーカイブジャーナルノードのノード状態をdcndlsコマンドで確認し，次に示すように対処してください。

(a)　被アーカイブジャーナルノードが異常終了，または強制停止している場合

jnlardisコマンドで強制的に接続を解除するか，または被アーカイブジャーナルノードのOpenTP1を再開始したあと，正常終了，または計画停止してください。

(b)　被アーカイブジャーナルノードが正常終了，または計画停止している場合

jnlardisコマンドで強制的に接続を解除してください。

(c)　被アーカイブジャーナルノードがオンラインの場合

被アーカイブジャーナルノードのOpenTP1を終了してください。

(4)　グローバルアーカイブジャーナルサービスとの接続が解除できないため，被アーカイブジャーナルノードのOpenTP1が停止しないとき

接続先のアーカイブジャーナルノードのOpenTP1がオンラインでない場合，被アーカイブジャーナルノードのジャーナルサービスは，グローバルアーカイブジャーナルサービスとの接続を解除できません。そのため，アーカイブジャーナルノードのノード状態をdcndlsコマンドで確認し，次に示すように対処してください。

(a)　アーカイブジャーナルノードが終了している場合

アーカイブジャーナルノードのOpenTP1を再開始してください。

(b)　アーカイブジャーナルノードがオンラインの場合

被アーカイブジャーナルノードのOpenTP1を強制停止してください。

10.6.3　OpenTP1が異常終了した場合

＜この項の構成＞

(1)　OpenTP1のシステムサービス，またはユーザサーバをkillコマンドで直接停止したとき

(2)　OpenTP1内部で不良を検出したとき

(3)　MCF通信プロセスが異常終了したとき

(4)　UAPの不良が原因でOpenTP1が異常終了したとき

(5)　MCF構成変更準備停止中またはMCF構成変更再開始中にMCFマネジャプロセスが異常終了したとき

(1)　OpenTP1のシステムサービス，またはユーザサーバをkillコマンドで直接停止したとき

処理を続行したい場合は，再開始してください。

(2)　OpenTP1内部で不良を検出したとき

理由コードがメッセージに出力されます。

保守員に連絡してください。

(3)　MCF通信プロセスが異常終了したとき

UOCの不良の可能性があります。UOCの処理を見直してください。なお，UOC内で使用するローカル変数のサイズ（スタックのサイズ）の合計が1キロバイトを超えると，MCF通信プロセスが異常終了する場合があります。

(4)　UAPの不良が原因でOpenTP1が異常終了したとき

UAPの不良が原因で，OpenTP1が異常終了する場合があります。OpenTP1が異常終了する前に，UAPの処理が異常終了していないか確認してください。UAPの処理が異常終了していたときは，UAPの処理を見直してください。それでも原因がわからない場合は，保守員に連絡してください。

(5)　MCF構成変更準備停止中またはMCF構成変更再開始中にMCFマネジャプロセスが異常終了したとき

理由コードがメッセージに出力されます。

対処方法の詳細については，「5.10.6　MCF構成変更再開始機能使用時の障害対策」を参照してください。

10.6.4　OpenTP1の運用コマンドが正常終了しない場合

＜この項の構成＞

(1)　オプション，またはコマンド引数の指定が誤っているとき

(2)　運用コマンドを実行できる環境が設定されていないとき

(3)　該当する運用コマンドを実行する権限がないとき

(1)　オプション，またはコマンド引数の指定が誤っているとき

オプション，またはコマンド引数の指定が誤っている旨のエラーメッセージが出力されます。

オプション，またはコマンド引数を正しく指定し直してください。

(2)　運用コマンドを実行できる環境が設定されていないとき

運用コマンドを実行できる環境が設定されていない旨のエラーメッセージが出力されます。

正しい環境を設定してください。特に環境変数の設定に注意してください。

(3)　該当する運用コマンドを実行する権限がないとき

該当する運用コマンドを実行できる権限を持ったユーザで実行してください。

10.6.5　OpenTP1の運用コマンドが応答待ちタイムアウトになる場合

OSの負荷が低いときに運用コマンドを実行してください。または，システム共通定義の最大応答待ち時間（watch_timeオペランド）を長くしてください。

10.6.6　マルチノード機能使用時のOpenTP1障害

＜この項の構成＞

(1)　アーカイブジャーナルノードのOpenTP1障害

(2)　被アーカイブジャーナルノードのOpenTP1障害

(1)　アーカイブジャーナルノードのOpenTP1障害

アーカイブジャーナルノードのOpenTP1が異常終了しても，被アーカイブジャーナルノードのOpenTP1はそのまま続行します。ただし，被アーカイブジャーナルノードのジャーナルはアーカイブしません。その結果，被アーカイブジャーナルノードのシステムジャーナルファイルのスワップ先がなくなると，被アーカイブジャーナルノードのOpenTP1は停止します。そのため，被アーカイブジャーナルノード側で個別にアンロードしてください。

また，アーカイブジャーナルノードのOpenTP1が復旧すると，被アーカイブジャーナルノード側でアンロードしていても，転送されていないジャーナルからアーカイブを再開します。被アーカイブジャーナルノード側での個別のアンロードとスワップによって，アーカイブしなければならないジャーナルをすでに失っていた場合は，該当するノードの以降のアーカイブは中止します。そのため，通信復旧後も被アーカイブジャーナルノード側で個別にアンロードしてください。

なお，アーカイブジャーナルノードのOpenTP1が復旧するまで，被アーカイブジャーナルノードのOpenTP1は正常終了，または計画停止できません。この場合，被アーカイブジャーナルノードのOpenTP1は，アーカイブジャーナルノードのOpenTP1の復旧を待って終了するか，または強制停止してください。

ただし，被アーカイブジャーナルノードのジャーナルサービスが，停止時のアーカイブ待ち合わせ最大時間（ジャーナルサービス定義のjnl_arc_terminate_timeoutオペランドで指定）を設定している場合は，被アーカイブジャーナルノードのOpenTP1は正常終了，または計画停止できます。ジャーナルサービス定義については，マニュアル「OpenTP1 システム定義」を参照してください。

(2)　被アーカイブジャーナルノードのOpenTP1障害

被アーカイブジャーナルノードのOpenTP1が異常終了しても，アーカイブジャーナルノードのOpenTP1はそのまま続行します。

被アーカイブジャーナルノードのOpenTP1が復旧すると，転送されていないジャーナルからアーカイブを再開します。

なお，被アーカイブジャーナルノードのOpenTP1が復旧するまで，アーカイブジャーナルノードのOpenTP1は正常終了，または計画停止できません。この場合，アーカイブジャーナルノードのOpenTP1は，被アーカイブジャーナルノードのOpenTP1の復旧を待って終了するか，または強制停止してください。

ただし，jnlardisコマンドで接続を強制的に解除した場合は，アーカイブジャーナルノードのOpenTP1は正常終了，または計画停止できます。

10.7　CPU障害

CPUに障害が発生した場合の対処方法を説明します。

OS，およびハードウェアの障害対策に従って障害原因を取り除いたあと，CPU内のOSを回復し，OpenTP1を再開始してください。

10.8　障害時に取得する情報

障害時に取得する情報を次の表に示します。

表10-2　障害時に取得する情報

取得情報
出力情報
参照方法
注意事項

メッセージログファイル
（$DCDIR/spool/dclog1，dclog2）
OpenTP1，またはUAPが出力するメッセージ
logcatコマンドを実行してください。
古いメッセージログファイルを残しておきたい場合は，メッセージログファイルの交替で内容が失われる前にコピーしてください。

コンソールメッセージ
OpenTP1が出力するシステム情報
コンソールを見てください。
プリンタ出力，集中コンソールへの出力はOSの機能です。

コマンド実行時の標準出力，標準エラー出力
OpenTP1の運用コマンドの出力情報，およびエラーメッセージ
運用コマンドを入力した画面で見てください。
ファイルに残したい場合は，必要に応じてリダイレクトしてください。

コアファイル
（./core）
OpenTP1の関連プロセスのデータ，スタック
－
OpenTP1が起動するプロセスのコアファイルは，$DCDIR/spool/saveまたはプロセスサービス定義のprc_coresave_pathオペランドで指定したディレクトリ下にサーバ名n※¹という名称で退避されます。一つのサーバについて3個までしか退避されないので，残しておきたいコアファイルは，必要に応じてコピーしてください。

UAPトレース
uatdumpコマンドを実行してください。

共用メモリダンプファイル
（Linuxの場合$DCDIR/spool/shmdump〔1～3〕.gz,
$DCDIR/spool/shmdump.XXX※²〔1～3〕.gz，
その他の場合$DCDIR/spool/shmdump〔1～3〕.Z
$DCDIR/spool/shmdump.XXX※²〔1～3〕.Z）
OpenTP1が共用メモリに保持するデータ
－
古いダンプファイルを残しておきたい場合は，必要に応じてコピーしてください。

MCFダンプファイル
（$DCDIR/spool/mcfdKAXXZZ※3）
MCFに関するデータ
－
不要になったファイルは消去してください。

デッドロック，タイムアウト情報ファイル
（$DCDIR/spool/
dclckinf/ファイル名※⁴）
資源の待ち合わせ状態の情報
OSのcat，またはviなどのコマンドを実行してください。
不要になったファイルは，lckrminfコマンドを実行するか，または，ロックサービス定義のlck_deadlock_info_remove_levelオペランドを指定して消去してください。

MCFトレースファイル
（$DCDIR/spool/
mcftAXXZZ※⁵）
MCFトレース
－
古いMCFトレースファイルを残しておきたい場合は，必要に応じてコピーしてください。

RPCトレースファイル
（$DCDIR/spool/rpctr1，rpctr2）
UAPがRPCを使用して送受信するメッセージ
rpcdumpコマンドを実行してください。
RPCトレースファイルには，受信メッセージが送信メッセージより先に出力されることがあります。
RPCトレースファイルの指定したファイルサイズが小さ過ぎると，ファイル内のデータがすぐに上書きされ，十分な情報を蓄えることができなくなります。

UAPトレース編集出力ファイル
（$DCDIR/spool/save/
サーバ名n※⁶.uat）
UAPトレース
OSのcat，またはviなどのコマンドを実行してください。
一つのサーバについて3個しか作成されないので残しておきたいファイルは，必要に応じてコピーしてください。

OpenTP1デバッグ情報ファイル
（$DCDIR/spool/save/
サーバ名n※⁶.deb）
OpenTP1内部情報
－
一つのサーバについて3個しか作成されないので残しておきたいファイルは，必要に応じてコピーしてください。

XARイベントトレース情報ファイル
（$DCDIR/spool/dcxarinf/trace/xarevtr1，xarevtr2）
XAリソースサービス用イベントトレース
xarevtrコマンドを実行してください。
古いXARイベントトレースファイルを残しておきたい場合は，必要に応じてコピーしてください。

XAR性能検証用トレース情報ファイル
（$DCDIR/spool/dcxarinf/_xr_nnn※7）
XAリソースサービス用性能検証用トレース
prfgetコマンド， prfedコマンド，またはdcalzprfコマンドを実行してください。
古いXAR性能検証用トレース情報ファイルを残しておきたい場合は，必要に応じてコピーしてください。

JNL性能検証用トレース情報ファイル
（$DCDIR/spool/dcjnlinf/prfinf/_jl_nnn※7）
ジャーナルサービスのイベントトレース
prfgetコマンド， prfedコマンド，またはdcalzprfコマンドを実行してください。
古いJNL性能検証用トレース情報ファイルを残しておきたい場合は，必要に応じてコピーしてください。

LCK性能検証用トレース情報ファイル
（$DCDIR/spool/dclckinf/prf/_lk_nnn※7）
ロックサービスのイベントトレース
prfgetコマンド， prfedコマンド，またはdcalzprfコマンドを実行してください。
古いLCK性能検証用トレース情報ファイルを残しておきたい場合は，必要に応じてコピーしてください。

MCF性能検証用トレース情報ファイル
（$DCDIR/spool/dcmcfinf/_mc_nnn※7）
MCF用性能検証用トレース
prfgetコマンド， prfedコマンド，またはdcalzprfコマンドを実行してください。
古いMCF性能検証用トレース情報ファイルを残しておきたい場合は，必要に応じてコピーしてください。

プロセスサービスイベントトレース情報ファイル
（$DCDIR/spool/dcprcinf/_pr_001，_pr_002，_pr_003）
プロセスサービスのイベントトレース
prfgetコマンド， prfedコマンド，またはdcalzprfコマンドを実行してください。
古いプロセスサービスイベントトレース情報ファイルを残しておきたい場合は，必要に応じてコピーしてください。

FILイベントトレース情報ファイル
（$DCDIR/spool/dcfilinf/_fl_001，_fl_002，_fl_003）
OpenTP1ファイル用のイベントトレース
prfgetコマンド， prfedコマンド，またはdcalzprfコマンドを実行してください。
古いFILイベントトレース情報ファイルを残しておきたい場合は，必要に応じてコピーしてください。

（凡例）

－：OpenTP1保守情報のため，参照できません。

注※1

n：退避コアファイルの通番（1～3）

ただし，サーバが強制停止時（dcsvstop -dfコマンドまたはprckillコマンドを実行したとき，または実時間監視タイムアウトになったとき）に出力されるコアファイルには，通番は付きません。なお，プロセスサービスのコアファイルが'core'という名称でこのディレクトリに取得されることがあります。また，ユーザ環境設定コマンドが異常終了した場合，そのコアファイルは'_usrcmd'に通番（1～3）が付いた名称で退避されます。

注※2

XXX：リソースマネジャ名（dam，tam，ist，ism）

注※3

KAXXZZ：

K：プロセス種別

m：MCFマネジャプロセス

c：MCF通信サービスまたはMCFアプリケーション起動サービス

u：ユーザサービスその他

AXX：MCF識別子

A：MCFマネジャ定義の，mcfmenv定義コマンドの-mオプションのidオペランドで指定したMCFマネジャプロセス識別子

XX：MCF通信構成定義の，mcftenv定義コマンドの-sオプションで指定したMCF通信プロセス識別子

ZZ：ダンプ通番（01～99）

注※4

ファイル名はデッドロック検知日時を基に決定されます。ファイル名の長さは日付が1けたか2けたかによって異なります。

（例）

10月3日6時29分56秒のとき…Oct3062956

10月10日18時6分0秒のとき…Oct10180600

注※5

AXXZZ：

AXX：MCF識別子

A：MCFマネジャ定義の，mcfmenv定義コマンドの-mオプションのidオペランドで指定したMCFマネジャプロセス識別子

XX：MCF通信構成定義の，mcftenv定義コマンドの-sオプションで指定したMCF通信プロセス識別子

ZZ：トレーススワップファイル識別子

注※6

n：ファイルの通番（1～3）

注※7

nnn：それぞれ，次に示す定義のprf_file_countオペランドで指定した値を上限とした001から始まる値です。

XAR性能検証用トレース情報ファイル：XAR性能検証用トレース定義

JNL性能検証用トレース情報ファイル：JNL性能検証用トレース定義

LCK性能検証用トレース情報ファイル：LCK性能検証用トレース定義

MCF性能検証用トレース情報ファイル：MCF性能検証用トレース定義

10.9　全面回復時に引き継がれる情報

全面回復時に引き継がれる情報を次の表に示します。

表10-3　全面回復時に引き継がれる情報

分類 | 引き継がれる情報
ステータスファイル | 閉塞ファイルの状態
システムジャーナルファイル | ファイルのオープン状態
チェックポイントダンプファイル
アーカイブジャーナルファイル
ノードリストファイル | 動作モード
マネジャノード情報
ノードリスト情報
オプション情報（ノードの優先度）
DAMファイル | ユーザデータ
論理ファイルの閉塞状態
TAMファイル | ユーザデータ
TAMテーブルの状態
XARファイル | XARファイルの閉塞状態
メッセージキュー | メッセージ通番
キューポインタ
分岐メッセージ送信
端末構成
UAP | UAPの閉塞状態
ユーザサーバの構成

11.　トラブル発生時の調査手順

OpenTP1の障害が発生したときに取得する情報および調査手順について説明します。

「11.1　取得情報と確認事項」では障害発生時に取得する情報や確認する事項のうち，あらゆる障害に共通する内容について説明します。

「11.2　調査手順」では具体的な障害事例を基に，障害発生時の調査手順について説明します。

＜この章の構成＞

11.1　取得情報と確認事項

11.2　調査手順

11.1　取得情報と確認事項

ここでは障害発生時に取得する情報や確認する事項のうち，あらゆる障害に共通する内容について説明します。

＜この節の構成＞

11.1.1　取得情報

11.1.2　障害が発生したときに確認する事項

11.1.3　トレースの確認方法

11.1.1　取得情報

障害要因を調査する場合に必要な情報を製品ごとに示します。

ここでは調査に必要な基本的な情報を記載しています。「11.2　調査手順」で説明する個々の障害事例に記載していない障害については，ここで説明する情報を基に障害の要因を調査してください。

障害要因の調査に必要な情報を以降の表に示します。なお，通信先相手システムもOpenTP1システムである場合，現象発生ノードだけでなく，通信先相手システムのノードについても次の表の資料を取得してください。

表11-1　障害要因の調査に必要な情報（TP1/Server Base，TP1/LiNK，TP1/FS/Direct Access，TP1/FS/Table Accessなどの場合）

取得情報
備考

現象発生ノードのbetran.log（OpenTP1の標準出力および標準エラー出力先ファイル）
UNIX版の場合，$DCDIR/bin/prcoutに指定したファイルに出力されます。指定していない場合は，次のファイルに出力されます。

$DCDIR/spool/prclog1

$DCDIR/spool/prclog2

Windows版の場合は，イベントログ（アプリケーションログおよびシステムログ）を取得してください。また，標準出力リダイレクト機能を使用しているときは，システム環境定義のredirect_file_nameオペランドに指定したファイルも取得してください。指定していない場合は，次のファイルに出力されます。

%DCDIR%¥spool¥prclog1

%DCDIR%¥spool¥prclog2

現象発生ノードのsyslogファイル
Windows版の場合，取得する必要はありません。

現象発生ノードの$DCDIRのディレクトリ情報
UNIX版の場合，次に示すコマンドを実行し，情報を取得してください。

ls -laR $DCDIR

現象発生ノードの$DCDIR/spool配下のファイル
spool配下のすべてのファイルを取得するのが困難な場合は，spool配下をすべて退避したあと，次に示すファイルを取得してください。

$DCDIR/spool/rpclog*

$DCDIR/spool/errlog/errlog*

$DCDIR$/spool/errlog/errlog*.nam（バージョン07-05以降）

$DCDIR/spool/cmdlog/cmdlog*

現象発生ノードの$DCDIR/tmp配下のファイル
システム共通定義のprc_current_work_pathオペランドを指定している場合は，その配下のファイルもすべて取得してください。

現象発生ノードの$DCDIR/conf配下および$DCCONFPATH配下のファイル
$DCUAPCONFPATHを設定している場合は，$DCUAPCONFPATH配下のファイルも取得してください。定義ファイルを取得するときは，ユーザサービス定義またはユーザサービスデフォルト定義も取得してください。

注

情報を取得するにはdcrasgetコマンドを使用してください。ただし，Windowsのイベントログについてはdcrasgetコマンドでは取得できないので，OSのマニュアルに従って取得してください。

表11-2　障害要因の調査に必要な情報（TP1/Client/Pの場合）

取得情報
備考

クライアント環境定義ファイル（%WINDIR%¥betran.ini）
dc_clt_cltin_s関数の引数defpathに指定がある場合は，引数に指定したファイルを取得してください。なお，ターミナルサービス機能やメタフレーム機能を利用したPCを使用している場合は，%WINDIR%を「¥Documents and Settings¥各ユーザディレクトリ」下に読み替えてください。

dcerr*.trc（エラートレース）
dcuap*.trc（UAPトレース）
dcsoc*.trc（ソケットトレース）
dcmdl*.trc（モジュールトレース）
クライアント環境定義DCTRCPATHに指定したディレクトリ配下に出力されます。DCTRCPATHの指定がない場合は，CUPのカレントディレクトリ配下に出力されます。

表11-3　障害要因の調査に必要な情報（TP1/Client/Wの場合）

取得情報
備考

クライアント環境定義ファイル
（CUPを起動するユーザでログインして，OSのenvコマンドの実行結果を取得してください）
dc_clt_cltin_s関数の引数defpathに指定がある場合は，引数に指定したファイルを取得してください。

dcerr*.trc（エラートレース）
dcuap*.trc（UAPトレース）
dcsoc*.trc（ソケットトレース）
dcmdl*.trc（モジュールトレース）
クライアント環境定義DCTRCPATHに指定したディレクトリ配下に出力されます。DCTRCPATHの指定がない場合は，CUPのカレントディレクトリ配下に出力されます。

表11-4　障害要因の調査に必要な情報（TP1/Client/Jの場合）

取得情報
備考

クライアント環境定義（定義ファイル名および格納先は任意）
rpcOpenメソッドのdeffilename引数に指定がある場合は引数に指定したファイルを取得してください。

dcerr*.trc（エラートレース）
dcuap*.trc（UAPトレース）
dcmtd*.trc（メソッドトレース）
dcdat*.trc（データトレース）
情報の出力先を次に示します。

エラートレース：dcerrtracepathオペランドで指定したディレクトリ（dcerrtrace=Yの場合だけ出力されます）

UAPトレース：dcuaptracepathオペランドで指定したディレクトリ（dcuaptrace=Yの場合だけ出力されます）

メソッドトレース：dcmethodtracepathオペランドで指定したディレクトリ（dcmethodtrace=Yの場合だけ出力されます）

データトレース：dcdatatracepathオペランドで指定したディレクトリ（dcdatatrace=Yの場合だけ出力されます）

デバッグトレース（dcCltXXXXXXXXXXXX.dmp）
（XXXXXXXXXXXXはタイムスタンプを示します）
CUPを実行するユーザ（またはJavaVMを実行するユーザ）のホームディレクトリ下のTP1clientJディレクトリに出力されます。

表11-5　障害要因の調査に必要な情報（TP1/Client for .NET Frameworkの場合）

取得情報
備考

クライアント構成定義
アプリケーション構成ファイルまたはマシン構成ファイルを取得してください（例：CUP.exe.config）。

dcerr*.trc（エラートレース）
dcuap*.trc（UAPトレース）
dcmtd*.trc（メソッドトレース）
dcdat*.trc（データトレース）
情報の出力先を次に示します。

エラートレース：<errTrace>要素のpath属性に指定したディレクトリ（use="true"の場合だけ出力されます）

UAPトレース：<uapTrace>要素のpath属性に指定したディレクトリ（use="true"の場合だけ出力されます）

メソッドトレース：<methodTrace>要素のpath属性に指定したディレクトリ（use="true"の場合だけ出力されます）

データトレース：<dataTrace>要素のpath属性に指定したディレクトリ（use="true"の場合だけ出力されます）

デバッグトレース（dcCltxxxxxxxxxxxxx.dmp）
（xxxxxxxxxxxxxはタイムスタンプを示します）
情報の出力先を次に示します。

<debugTrace>要素のpath属性を指定した場合：<path属性の指定値>¥Hitachi¥OpenTP1¥TP1ClientNET

<debugTrace>要素のpath属性の指定を省略した場合：C:¥Document and Settings¥ユーザ名¥Application Data¥Hitachi¥OpenTP1¥TP1ClientNET

表11-6　障害要因の調査に必要な情報（TP1/Message Control，TP1/NET/***の場合）

取得情報
備考

表11-1の情報
－

次に示す定義

MCFマネジャ定義

MCF通信構成定義（共通定義および個別定義）

MCFアプリケーション定義

定義の格納先，およびファイル名は任意に指定されたものになります。また，オンラインで使用する定義ファイルはオブジェクトファイルですがオブジェクト生成前の定義ファイルを取得してください。

システムサービス情報定義（$DCDIR/lib/sysconf/配下の先頭4文字が「mcfu」で始まるファイル名）
－

システムサービス共通情報定義（$DCDIR/lib/sysconf/mcf）
－

MCFトレース（$DCDIR/spool/mcftXXXnn）
（XXXはMCF識別子，nnは通し番号を示します）
－

（凡例）

－：該当しません。

TP1/Message Queue，TP1/Message Queue - Access，およびMessage Queue - Operationの障害要因を調査する場合に必要な情報は，それぞれマニュアル「TP1/Message Queue 使用の手引」，マニュアル「TP1/Message Queue - Access 使用の手引」，マニュアル「Message Queue - Operation 使用の手引」を参照してください。

11.1.2　障害が発生したときに確認する事項

障害が発生したときの確認事項を製品ごとに説明します。

OpenTP1関連製品で共通の確認事項

OpenTP1製品のバージョン
正確なバージョンを確認してください。修正版の場合，バージョン表記に追加されたコードも確認してください。
例：07-00-01，06-03-/Aなど

現象発生日時

複数ノードが関連する場合，ノード間の時刻差

現象発生時のマシンの負荷状態（CPUが高負荷であるなど，わかる範囲で確認してください）

現象が発生した環境が本番環境かどうか

ユーザサーバでエラーが発生している場合，現象が発生したユーザサーバの動作実績

現象発生直前のOpenTP1環境に対する変更点

TP1/Clientをご使用の場合の確認事項

TP1/Clientが動作するサーバと通信相手サーバの間の時刻差

TP1/Message Queueをご使用の場合の確認事項

接続している相手製品の名称

接続相手が他社製品の場合，現象発生時の他社製品の調査見解

TP1/Message Queue - Accessをご使用の場合の確認事項

ユーザアプリケーションが使用しているMQCクライアント機能の種別

XA連携を使用している場合，使用しているトランザクションモニタの製品名称

11.1.3　トレースの確認方法

＜この項の構成＞

(1)　UAPトレース

(2)　スタックトレースの確認方法

(1)　UAPトレース

(a)　UAPトレースの概要

「11.2　調査手順」で説明する調査手順にはUAPトレースを参照する場合があります。UAPトレースとは，OpenTP1が提供している関数を発行した際に取得されるトレース情報です。OpenTP1が提供している関数については，プロセス停止時にUAPトレースを参照することで，どこまで処理が進んでいたのか確認できます。また，関数内で停止した場合はdc_***（入口）と表示され，関数外で停止した場合はdc_***（出口）と表示されるため，UAPトレースを参照することで停止した処理が関数内か，または関数外かを確認できます。

(b)　UAPトレースの確認方法

UAPトレースは，異常終了した場合に取得されるものです。正常停止した場合は出力されません。OpenTP1が起動中であれば，異常終了後，$DCDIR/spool/save配下に「ユーザサーバ名n.uat」※というファイル名で出力されます。

UAPトレースファイルは，テキスト形式なのでviなどの標準のエディタで参照できます。参照する際は，異常終了時に出力されるKFCA01820-EメッセージのPIDを確認して，UAPトレースの上部に出力されるPIDと比較し，同一PIDの情報を参照してください。

ユーザサーバの異常終了の際に，OpenTP1全体が異常終了してしまった場合，UAPトレースが$DCDIR/spool/save配下に出力されていないことがあります。$DCDIR/spool/save配下にUAPトレースが見つからない場合は，カレントディレクトリ（$DCDIR/spool/tmp/home/ユーザサーバ名）を参照しコアファイルを探してください。コアファイルが見つかったら「uatdump core > 任意のファイル名称」を実行してUAPトレースファイルを編集出力してください。

注※

nにファイルの世代番号が入ります。

(2)　スタックトレースの確認方法

「11.2　調査手順」で説明する調査手順にはスタックトレースを取得する指示があります。スタックトレースは次に示す方法で取得できます。

UNIXの場合

例としてAIXおよびLinuxの場合の手順を示します。OSによって取得方法は異なるので詳細についてはOSのマニュアルを参照してください。

AIX：「dbx ロードモジュール名称 コアファイル」を実行後，コマンド入力待ちになるので，whereを入力します。スタックトレースが表示されます。

Linux：「gdb UAPのロードモジュール名 コアファイル | tee ファイル名（任意）」を実行後，コマンド入力待ち状態になるので，btを入力します。複数行の出力をEnterキーを入力して表示させて，すべて表示させたらqを入力して終了します。指定したファイル名にスタックトレースが出力されます。

Windowsの場合

コマンドプロンプトを起動して，「drwtsn32 -i」を実行しておくことでプロセスの異常終了時にワトソンログ（スタックトレース情報含む）で指定したパスにログファイルが出力されます。詳細についてはOSのマニュアルを参照してください。

11.2　調査手順

具体的な障害事例を基に，障害発生時の調査手順について説明します。

＜この節の構成＞

11.2.1　KFCA00307-Eメッセージが出力された場合

11.2.2　KFCA00327-Wメッセージが出力された場合

11.2.3　KFCA00328-Wメッセージが出力された場合

11.2.4　KFCA00502-Iメッセージが出力された場合

11.2.5　KFCA00837-Iメッセージが出力された場合

11.2.6　KFCA00854-Eメッセージが出力された場合

11.2.7　KFCA00906-EまたはKFCA00907-Eメッセージが出力された場合

11.2.8　KFCA01803-Iメッセージが出力された場合

11.2.9　KFCA01820-Eメッセージが出力された場合

11.2.10　KFCA01864-Eメッセージが出力された場合

11.2.11　-902: DCTRNER_ROLLBACKエラーリターンが出力された場合

11.2.12　ユーザサーバが起動しない場合

11.2.1　KFCA00307-Eメッセージが出力された場合

＜この項の構成＞

(1)　現象

(2)　現象発生時の確認事項

(3)　取得情報

(4)　調査手順

(1)　現象

次に示すメッセージが出力されて，ファイル記述子の確保に失敗しました。

KFCA00307-E ソケット不足が発生したためRPCができません。

(2)　現象発生時の確認事項

現象発生日時

現象が発生したユーザサーバ名

ユーザサーバの動作実績

現象発生直前のOpenTP1環境に対する変更点

(3)　取得情報

表11-1の情報

(4)　調査手順

KFCA00307-Eメッセージは，通信で使用するファイル記述子が確保できなかった場合に出力されます。ファイル記述子の上限値は，max_socket_descriptorsオペランドの指定値です。この障害の主な原因を次に示します。

max_socket_descriptorsオペランドの見積もりが正しくないことによるファイル記述子の不足

OSのカーネルパラメタ※の指定値が小さい

注※

カーネルパラメタ名称はOSによって異なります。また，1プロセスまたはシステム全体とでパラメタが異なります。フローでは，カーネルパラメタ（システム全体）は，システム全体で使用できるファイル記述子の上限を意味し，カーネルパラメタ（プロセス）は，1プロセスで使用できるファイル記述子の上限を意味します。なお，カーネルパラメタを変更する場合は余裕を持った値を指定してください。

次に示すフローに従って原因を調査してください。

図11-1　KFCA00307-Eメッセージが出力された場合の調査手順

各サーバが使用するファイル記述子の総数は，「各サーバの定義に指定されているmax_socket_descriptorsオペランド+max_open_fdsオペランド」です。OpenTP1全体で使用するファイル記述子の総数は「各サーバのmax_socket_descriptorsオペランド+max_open_fdsオペランド」です。

各サーバのmax_socket_descriptorsオペランド指定値については次の表を参照して確認してください。計算はプロセス単位で行ってください。

表11-7　各サーバのmax_socket_descriptorsオペランドの指定値

項番
サーバ名
有効となるmax_socket_descriptorsオペランドの指定値

1
prcd，itvd，stsd，cpdd，tjld，qued，damd，tamd，tamiod，ismbd，istd，logd，prfiod，cltcond，cltd，clttrnd，xatd，xatcd，rmmd，admrsvre， mcfrmgrd
システム共通定義（betranrc）の指定値。省略値は64。

2
namd，namaudtd
ネームサービス定義（nam）の指定値。ネームサービス定義を省略している場合は，システム共通定義（betranrc）の指定値。省略値は64。

3
scdd，scdmltd
スケジュールサービス定義（scd）の指定値。スケジュールサービス定義を省略している場合は，システム共通定義（betranrc）の指定値。省略値は64。

4
trnd，trnrvd，trnrmd
トランザクションサービス定義（trn）の指定値。トランザクションサービス定義を省略している場合は，システム共通定義（betranrc）の指定値。省略値は64。

5
jnld，jnliod，jnlsdd，jnlswd，jard，jarswd，jarrvd
ジャーナルサービス定義（jnl）の指定値。ジャーナルサービス定義を省略している場合は，システム共通定義（betranrc）の指定値。省略値は64。

6
mcfmngrd，mapsmgrd，mcfcmdsv，mqtmngd
64で固定。

7
MCFアプリケーションサービス，MCF通信サービス
システムサービス共通情報定義（$DCDIR/lib/sysconf/mcf）の指定値。省略値は64。

8
mqad，mqaiod，mqacmd，mqamnd

TP1/Message Queue 05-12以前

システム共通定義（betranrc）の指定値。省略値は64。

TP1/Message Queue 05-13以降

MQAサービス定義（mqa）の指定値。省略値は64。

9
mqtdtcp

TP1/Message Queue 05-13以前

304で固定。

TP1/Message Queue 05-14以降

MQTサービス定義（mqt）の指定値。省略値は64。

10
rapリスナー，rapサーバ
rapリスナーサービス定義（任意名称）の指定値。省略している場合は次に示す優先順位に従います（1.＞2.）。

ユーザサービスデフォルト定義（usrrc）

システム共通定義（betranrc）

上記のすべての定義を省略している場合，省略値は64。

11
ユーザサーバ
ユーザサービス定義（任意名称）の指定値。省略している場合は次に示す優先順位に従います（1.＞2.）。

ユーザサービスデフォルト定義（usrrc）

システム共通定義（betranrc）

上記のすべての定義を省略している場合，省略値は64。

12
RTSSUP，RTSSPP
64で固定。

各サーバのmax_open_fdsオペランドの指定値については次の表を参照して確認してください。計算はプロセス単位で行ってください。

表11-8　各サーバのmax_open_fdsオペランドの指定値

項番 | サーバ名 | 有効となるmax_open_fdsオペランドの指定値
1 | prcd，namd，namaudtd，scdd，scdmltd，trnd，trnrvd，trnrmd，jnld，jnlswd，jnliod，jnlsdd，jard，jarswd，jarrvd，itvd，stsd，cpdd，tjld，qued，damd，tamd，tamiod，ismbd，istd，logd，prfiop，cltcond，cltd，clttrnd，xatd，xatcd，rmmd，admrsvre，mcfmngrd，mcfrmgrd，mapsmgrd，mcfcmdsvmqad，mqaiod，mqacmd，mqamnd，mqtdtcp，mqtmngd | 50で固定。
2 | MCFアプリケーションサービス，MCF通信サービス | システムサービス共通情報定義（$DCDIR/lib/sysconf/mcf）の指定値。省略値は100。
3 | rapリスナー，rapサーバ | ユーザサービスデフォルト定義（usrrc）の指定値。省略値は50。
4 | ユーザサーバ | ユーザサービス定義（任意名称）の指定値。ユーザサービス定義を省略している場合は，ユーザサービスデフォルト定義（usrrc）の指定値。省略値は50。
5 | RTSSUP，RTSSPP | 50で固定。

11.2.2　KFCA00327-Wメッセージが出力された場合

＜この項の構成＞

(1)　現象

(2)　現象発生時の確認事項

(3)　取得情報

(4)　調査手順

(1)　現象

次に示すメッセージが出力されて，RPCコールがエラーリターンしました。

KFCA00327-W RPCのサービス呼び出し処理でエラーが発生しました。

(2)　現象発生時の確認事項

現象発生日時

現象が発生したユーザサーバ名

RPCコール元およびRPCコール先のユーザサーバの動作実績

現象発生直前のOpenTP1環境に対する変更点

RPCコール元およびRPCコール先が異なるノードの場合，ノード間の時刻差

(3)　取得情報

表11-1の情報

hostsファイル（DNSを使用している場合は不要）

RPCコール先のノードが他ノードの場合：RPCコール先での表11-1の情報

(4)　調査手順

KFCA00327-Wメッセージは，RPCコールがエラーリターンした場合に出力されます。この障害の主な原因を次に示します。

RPCコールの引数に指定したサービスグループ名およびサービス名の不正

RPCコール先のユーザサーバがダウン

なお，この調査手順では，ネームサービス定義（nam）にname_global_lookup=Yを指定している場合，RPCコール先を特定できないことがあります。

次に示すフローに従って原因を調査してください。

図11-2　KFCA00327-Wメッセージが出力された場合の調査手順

11.2.3　KFCA00328-Wメッセージが出力された場合

＜この項の構成＞

(1)　現象

(2)　現象発生時の確認事項

(3)　取得情報

(4)　調査手順

(1)　現象

次に示すメッセージが出力されて，RPCコールに対する応答送信が失敗しました。

KFCA00328-W 応答送信処理でエラーが発生しました。

(2)　現象発生時の確認事項

現象発生日時

現象が発生したユーザサーバ名

ユーザサーバの動作実績

現象発生直前のOpenTP1環境に対する変更点

(3)　取得情報

表11-1の情報

hostsファイル（DNSを使用している場合は不要）

応答送信先が他ノードの場合：応答送信先での表11-1の情報

応答送信先がTP1/Clientの場合：応答送信先での表11-2，表11-3，または表11-4の情報

(4)　調査手順

KFCA00328-Wメッセージは，RPCコールに対する応答送信が失敗した場合に出力されます。応答送信先のRPCコール元のユーザサーバが存在しないことが原因として考えられます。

次に示すフローに従って原因を調査してください。

図11-3　KFCA00328-Wメッセージが出力された場合の調査手順

11.2.4　KFCA00502-Iメッセージが出力された場合

＜この項の構成＞

(1)　現象

(2)　現象発生時の確認事項

(3)　取得情報

(4)　調査手順

(1)　現象

次に示すメッセージが出力されて，実時間監視タイムアウトが発生しました。

KFCA00502-I 実時間監視タイムアウトが発生しました。

(2)　現象発生時の確認事項

現象発生日時

現象が発生したユーザサーバ名

ユーザサーバの動作実績

現象発生直前のOpenTP1環境に対する変更点

(3)　取得情報

表11-1の情報

(4)　調査手順

KFCA00502-Iメッセージは，trn_expiration_timeオペランド，service_expiration_timeオペランドなどの値を満了した場合に出力されます。プロセスを強制的に停止するため，KFCA01820-Eメッセージも出力されます。この障害の主な原因を次に示します。

ユーザ処理部分で時間が掛かっている

dc_rpc_call関数の応答に時間が掛かっている

次に示すフローに従って原因を調査してください。

図11-4　KFCA00502-Iメッセージが出力された場合の調査手順

11.2.5　KFCA00837-Iメッセージが出力された場合

＜この項の構成＞

(1)　現象

(2)　現象発生時の確認事項

(3)　取得情報

(4)　調査手順

(1)　現象

dcsvstopコマンドを実行しても，ユーザサーバが停止できない状態で，次に示すメッセージが出力されました。

KFCA00837-I サーバの終了処理を保留しています。

(2)　現象発生時の確認事項

現象発生日時

現象が発生したユーザサーバ名

停止できないユーザサーバの動作実績

現象発生直前のOpenTP1環境に対する変更点

(3)　取得情報

表11-1の情報

(4)　調査手順

この障害事例の主な原因は，停止しようとしているユーザサーバが要求を受けて動作中であるためです。dcsvstopコマンドを実行しても要求処理中，または要求がスケジュールキューに滞留している場合，要求に対する処理がすべて完了してから停止します。

次に示すフローに従って原因を調査してください。

図11-5　KFCA00837-Iメッセージが出力された場合の調査手順

11.2.6　KFCA00854-Eメッセージが出力された場合

＜この項の構成＞

(1)　現象

(2)　現象発生時の確認事項

(3)　取得情報

(4)　調査手順

(1)　現象

次に示すメッセージが出力されて，メッセージ格納バッファプール長の不足が発生しました。

KFCA00854-E メッセージ格納バッファプールのメモリ不足が発生しました。

(2)　現象発生時の確認事項

現象発生日時

現象が発生したユーザサーバ名

scdlsコマンドを実行して，スケジュールキューの滞留状態を確認（実行結果は残してください）

trnls -taコマンドを実行して，仕掛り中のトランザクション状態を確認（実行結果は残してください）

(3)　取得情報

表11-1の情報

時間が経過しても，現象が発生し続ける場合は，可能ならば「dcsvstop -fd ユーザサーバ名」を実行してユーザサーバを強制停止してください。実行可能な場合，$DCDIR/spoolの資料についてはコマンド実行後に取得してください。

(4)　調査手順

KFCA00854-Eメッセージは，該当ユーザサーバのメッセージ格納バッファプール長（message_store_buflenオペランド）が不足した場合に出力されます。この障害の主な原因を次に示します。

message_store_buflenオペランドの指定値が小さい

ユーザサーバの多重度（parallel_countオペランド）が適切ではない

想定以上のRPCコール要求が送信される

ユーザサーバのサービス関数内で処理に時間が掛かり，RPCコール要求がスケジュールキューに滞留している

次に示すフローに従って原因を調査してください。

なお，次に示すフローでは現象発生直後を想定しています。現象発生から長時間経過した場合，調査できないことがあります。ただし，長時間経過しても想定される原因は上記の四つです。取得している情報から原因を確認できるのであれば，対策してください。確認できないならば，情報を取得してサポートセンタへ問い合わせてください。

図11-6　KFCA00854-Eメッセージが出力された場合の調査手順

parallel_countオペランドおよびmessage_store_buflenオペランドを変更した場合，ほかのオペランドの指定値も見直す必要があります。parallel_countオペランドの指定値を大きくした場合に変更するオペランドを次の表に示します。なお，balance_countオペランドの変更によるほかのオペランドの見直しは不要です。

表11-9　parallel_countオペランドの指定値を大きくした場合に変更するオペランド

項番
定義ファイル名
オペランド名
備考

1
プロセスサービス定義（prc）
prc_process_count
－

2
タイマサービス定義（tim）
tim_watch_count
－

3
トランザクションサービス定義（trn）
trn_tran_process_count
－

4
ロックサービス定義（lck）
lck_limit_for***
user，dam，tamおよびmqaの四つがあります。該当ユーザサーバの処理に合わせて見直してください。

5

ユーザサービス定義

ユーザサービスデフォルト定義（usrrc）

システム共通定義（betranrc）

システムサービス共通情報定義

max_socket_descriptors
－

6
システム環境定義（env）
static_shmpool_size
－

7
システム環境定義（env）
dynamic_shmpool_size
dam_tran_process_countオペランドを変更した場合，見直してください。

8
DAMサービス定義（dam）
dam_tran_process_count
parallel_countオペランドを変更するユーザサーバがDAMにアクセスする場合，見直してください。

9
TAMサービス定義（tam）
tam_max_trnnum
parallel_countオペランドを変更するユーザサーバがTAMにアクセスする場合，見直してください。

10
RAPリスナーサービス定義（任意名称）
rap_max_client
parallel_countオペランドを変更するユーザサーバがRAPリスナーにアクセスする場合，見直してください。

（凡例）

－：該当しません。

表11-10　message_store_buflenオペランドの指定値を大きくした場合に変更するオペランド

項番 | 定義ファイル名 | オペランド名 | 備考
1 | システム環境定義（env） | static_shmpool_size | 共用メモリの計算については，マニュアルまたは「リリースノート」を参照してください。

11.2.7　KFCA00906-EまたはKFCA00907-Eメッセージが出力された場合

＜この項の構成＞

(1)　現象

(2)　現象発生時の確認事項

(3)　取得情報

(4)　調査手順

(1)　現象

次に示すどちらかのメッセージが出力されて，リソースマネジャのアクセスに失敗しました。

KFCA00906-E リソースマネジャへのアクセス時にエラーが発生しました。

KFCA00907-E リソースマネジャのXA関数でエラーが発生しました。

(2)　現象発生時の確認事項

現象発生日時

現象が発生したユーザサーバ名

ユーザサーバの動作実績

現象発生直前のOpenTP1環境に対する変更点

(3)　取得情報

表11-1の情報

(4)　調査手順

KFCA00906-EまたはKFCA00907-Eメッセージはリソースマネジャのアクセスに失敗した場合に出力されます。OpenTP1はOpenTP1以外のリソースマネジャ（Oracle，HiRDBなど）と連携する際に，標準規格であるxaインタフェースを使用してアクセスします。

OpenTP1側でエラーリターン値を決定しているのではなく，リソースマネジャ側でリターンした情報をメッセージに出力しているため，エラーリターンした原因を究明するにはリソースマネジャ側での調査が必要です。次に示すフローに従って現象の切り分けを行い，必要に応じてOpenTP1のサポートセンタ，またはリソースマネジャのサポートセンタへ問い合わせてください。

図11-7　KFCA00906-Eメッセージが出力された場合の調査手順

図11-8　KFCA00907-Eメッセージが出力された場合の調査手順

11.2.8　KFCA01803-Iメッセージが出力された場合

＜この項の構成＞

(1)　現象

(2)　現象発生時の確認事項

(3)　取得情報

(4)　調査手順

(1)　現象

OpenTP1が正常停止したあと，次回のOpenTP1の起動時に，次に示すメッセージが表示されて，開始モードとして再開始が選択されました。

KFCA01803-I OpenTP1の開始モードを決定しました。開始モード：R

(2)　現象発生時の確認事項

現象発生日時

OpenTP1の停止から起動までの間でステータスファイルへの操作の有無

(3)　取得情報

表11-1の情報

系切り替え構成の場合：実行系だけでなく待機系での表11-1の情報

(4)　調査手順

この障害事例の主な原因は，OpenTP1の停止から起動までの間にステータスファイルを操作（定義の変更，ファイルのリストアなど）したことです。

次に示すフローに従って原因を調査してください。

図11-9　KFCA01803-Iメッセージが出力された場合の調査手順

11.2.9　KFCA01820-Eメッセージが出力された場合

＜この項の構成＞

(1)　現象

(2)　現象発生時の確認事項

(3)　取得情報

(4)　調査手順

(1)　現象

次に示すメッセージが出力されて，プロセスが強制停止または異常停止しました。

KFCA01820-E サーバがダウンしました。

(2)　現象発生時の確認事項

現象発生日時

現象が発生したユーザサーバ名

ユーザサーバの動作実績

現象発生直前のOpenTP1環境に対する変更点

(3)　取得情報

表11-1の情報

(4)　調査手順

KFCA01820-Eメッセージはプロセスが強制停止または異常停止した場合に出力されます。この障害の主な原因を次に示します。

実時間監視タイムアウト

ユーザロジックによる強制停止または異常停止

次に示すフローに従って原因を調査してください。

図11-10　KFCA01820-Eメッセージが出力された場合の調査手順

11.2.10　KFCA01864-Eメッセージが出力された場合

＜この項の構成＞

(1)　現象

(2)　現象発生時の確認事項

(3)　取得情報

(4)　調査手順

(1)　現象

次に示すメッセージが出力されて，コマンドでタイムオーバが発生しました。

KFCA01864-E コマンドでタイムオーバが発生しました。コマンド名：dcstop

(2)　現象発生時の確認事項

現象発生日時

現象発生直前のOpenTP1環境に対する変更点

(3)　取得情報

表11-1の情報

(4)　調査手順

KFCA01864-Eメッセージは，dcstopコマンドを実行後，システム環境定義（env）のsystem_terminate_watch_timeオペランドの値を満了した場合に出力されます。この障害の主な原因は，OpenTP1停止の延長でユーザサーバを停止したときにユーザサーバが停止できないため，タイマ値が満了になることです。

次に示すフローに従って原因を調査してください。

図11-11　KFCA01864-Eメッセージが出力された場合の調査手順

11.2.11　-902: DCTRNER_ROLLBACKエラーリターンが出力された場合

＜この項の構成＞

(1)　現象

(2)　現象発生時の確認事項

(3)　取得情報

(4)　調査手順

(1)　現象

dc_trn_unchained_commit関数またはdc_trn_chained_commit関数が，エラーコード：-902，リターン値：DCTRNER_ROLLBACKでエラーリターンしました。

(2)　現象発生時の確認事項

現象発生日時

該当ユーザサーバでのdc_rpc_call関数またはdc_rpc_call_to関数の発行有無

発行している場合は，グローバルトランザクション構成

ノードが異なる場合は，ノード間の時刻差

リソースマネジャを使用している場合，該当ユーザサーバがアクセスするリソースマネジャ

(3)　取得情報

表11-1の情報

RPCコールを使用していて，子ブランチが他ノードの場合：RPCコール先での表11-1の情報

(4)　調査手順

この障害事例の主な原因として考えられる点を次に示します。

該当ユーザサーバがRPCコールを使用して子ブランチを生成しているとき，同期点処理に入ったあと，子ブランチ側でロールバック要因が発生。

該当ユーザサーバがOpenTP1以外のリソースマネジャ（Oracle，HiRDBなど）を使用しているとき，同期点処理に入ったあと，リソースマネジャ側でロールバック要因が発生（この場合，XA関数がエラーリターンしているため，KFCA00906-E，KFCA00907-E，またはKFCA00908-Eメッセージが出力されます）。

同期点処理中の通信でtrn_watch_timeオペランドの満了。

trn_rollback_information_put=allを指定しておくことで，ロールバックが発生した要因を示すKFCA00989-Iメッセージが出力されます。トラブル発生時の調査が容易になりますので，指定することをお勧めします。

次に示すフローはKFCA00989-Iメッセージを使用して調査する流れです。フローに従って現象の切り分けを行い，必要に応じてOpenTP1のサポートセンタ，またはリソースマネジャのサポートセンタへ問い合わせてください。

図11-12　-902: DCTRNER_ROLLBACKエラーリターンが出力された場合の調査手順

11.2.12　ユーザサーバが起動しない場合

＜この項の構成＞

(1)　現象

(2)　現象発生時の確認事項

(3)　取得情報

(4)　調査手順

(1)　現象

ユーザサービス構成定義（usrconf）が指定されていますが，OpenTP1の起動の延長でユーザサーバが起動しませんでした。

(2)　現象発生時の確認事項

現象発生日時

現象発生直前のOpenTP1環境に対する変更点

(3)　取得情報

現象発生ノードのbetran.log
Windowsの場合は，イベントログ（アプリケーションログおよびシステムログ）を取得してください。

現象発生ノードのsyslogファイル
Windowsの場合は不要です。

現象発生ノードの$DCDIR/conf配下
$DCCONFPATHが$DCDIR/conf以外の場合，$DCCONFPATH配下を取得してください。

$DCDIR/spool/errlog/errlog***

(4)　調査手順

ユーザサービス構成定義（usrconf）に指定したユーザサーバを起動させるには次に示す二つの条件を満たす必要があります。

システムサービス構成定義（sysconf）にuap_conf=Yを指定している

OpenTP1の起動モードが正常開始である

この障害の主な原因は，OpenTP1を再開始によって起動したために，ユーザサーバが起動しないことです。

次に示すフローに従って原因を調査してください。

図11-13　ユーザサーバが起動しない場合の調査手順

この障害事例の類似事例で，再開始によってOpenTP1が起動したときにユーザサーバが起動しないという現象があります。再開始でOpenTP1が起動する場合は，前回のオンラインの状態を引き継ぎます。通常，前回のオンラインで起動していたユーザサーバは，次回の再開始によるOpenTP1の起動時に起動しますが，node_down_restart=Nが指定されているユーザサーバについては起動しません。再開始によるOpenTP1の起動時にユーザサーバが起動しない場合は，node_down_restartオペランドの指定値を確認してください。

12.　運用コマンド

OpenTP1で使用する運用コマンドの入力方法，および記述形式を説明します。

＜この章の構成＞

12.1　運用コマンドの概要

12.1　運用コマンドの概要

＜この節の構成＞

12.1.1　運用コマンドの入力方法

12.1.2　運用コマンドの記述形式

12.1.3　運用コマンドの使用方法の表示

12.1.4　運用コマンドの一覧

12.1.5　運用コマンド入力時の注意事項

12.1.1　運用コマンドの入力方法

OpenTP1の運用コマンドの入力方法には，シェルから入力する方法とUAPの中に組み込んで実行する方法とがあります。

UAPに組み込んで実行する方法の詳細は，マニュアル「OpenTP1 プログラム作成の手引」を参照してください。

12.1.2　運用コマンドの記述形式

運用コマンドの記述形式を次に示します。

　　コマンド名　オプション　コマンド引数

＜この項の構成＞

(1)　コマンド名

(2)　オプション

(3)　コマンド引数

(1)　コマンド名

コマンド名は，実行するコマンドのファイル名称です。

OpenTP1の運用コマンドは$DCDIR/bin/にありますので，PATHに$DCDIR/binを加えてください。

(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 -

(3)　コマンド引数

コマンド引数は，コマンド操作の対象となるものを指定します。指定できるコマンド引数の数は1024個までです。ただし，コマンドによっては，コマンド引数の上限数が1024個より少ない場合もあります。

コマンド引数の指定例を次に示します。次の説明中に使用する$はシェルのプロンプト，cmdはコマンド名称，-aはフラグ引数を必要とするオプションフラグ，-bはフラグ引数を必要としないオプションフラグ，param1，param2，…paramNはコマンド引数です。

コマンド引数の指定がない場合，コマンド引数の数は0です。

（例）

$ cmd

$ cmd -b

$ cmd -a 1

param1だけがコマンド引数であるため，コマンド引数の数は1です。

（例）

$ cmd param1

$ cmd -b param1

$ cmd -a 1 -b param1

param1以降がコマンド引数であるため，コマンド引数の数はNです（ただしNは1024以内）。

（例）

$ cmd param1 param2 … paramN

$ cmd -b param1 param2 … paramN

$ cmd -a 1 -b param1 param2 … paramN

12.1.3　運用コマンドの使用方法の表示

運用コマンドの使用方法を知りたい場合，コマンド名に続けてオプションとして-hを指定すると，そのコマンドの使用方法を示すヘルプメッセージを出力させることができます。

ただし，次に示すコマンドについては，-hオプションを指定できません。

dcmstart

dcmstop

dcndls

dcrasget

dcreport

dcreset

dcsetup

dcstart

dcstop

dcsvstart

dcsvstop

jnlardis

prckill

prcls

prcpath

prcpathls

prctee

tptrnls

12.1.4　運用コマンドの一覧

OpenTP1の運用コマンド一覧を次の表に示します。

次の表に示すオンライン中に実行できる運用コマンドは，実行時に，次に示す環境変数にOpenTP1ディレクトリの環境変数と同じものが設定されていなければなりません。

DCDIR

DCCONFPATH

表12-1　OpenTP1の運用コマンド一覧

機能 | 運用コマンド | 定義に組み込む | TP1/Multi未インストールノード | TP1/Multiインストールノード | UAPから実行 | 監査ログの出力 | コマンドログの出力 | アクセス権限
オフ | オン | オフ | オン
arcjnlあり | arcjnlなし
システム管理 | OpenTP1のOSへの登録と削除 | dcsetup | × | ○ | × | ○ | × | × | × | ○ | × | スーパユーザ
プロセスサービスの再起動および定義の反映 | dcreset | × | ○ | × | ○ | × | × | × | ○ | × | OpenTP1管理者
OpenTP1の内部制御用資源の確保と解放 | dcmakeup | × | ○ | × | ○ | × | × | × | ○ | ○ | OpenTP1管理者
OpenTP1の開始 | dcstart | × | ○ | × | ○ | × | × | × | ○ | ○ | OpenTP1管理者
OpenTP1の終了 | dcstop | × | × | ○ | × | ○ | ○ | ○※¹ | ○ | ○ | OpenTP1管理者
システム統計情報の取得開始，終了 | dcstats | × | × | ○ | × | × | ○ | ○ | ○ | ○ | OpenTP1管理者
マルチノードエリア，サブエリアの開始 | dcmstart | × | × | × | ○ | ○ | ○ | ○ | × | × | OpenTP1管理者
マルチノードエリア，サブエリアの終了 | dcmstop | × | × | × | ○ | ○ | ○ | ○ | × | × | OpenTP1管理者
シナリオテンプレートからのOpenTP1コマンドの実行 | dcjcmdex | × | ○ | ○ | ○ | ○ | ○ | × | ○ | ○ | OpenTP1管理者
システム定義のオペランドの指定 | dcjchconf | × | ○ | × | ○ | × | × | × | × | × | OpenTP1管理者
ドメイン定義ファイルの更新 | dcjnamch | × | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | OpenTP1管理者
OpenTP1ノードの状態表示 | dcndls | × | × | × | ○ | ○ | ○ | ○ | × | × | 一般ユーザ
共用メモリの状態表示 | dcshmls | × | × | ○ | × | ○ | ○ | ○ | × | ○ | 一般ユーザ
一時クローズ処理の実行状態の表示 | rpcstat | × | × | ○ | × | ○ | ○ | ○ | × | ○ | 一般ユーザ
標準出力，標準エラー出力のリダイレクト※2 | prctee | × | ○ | × | ○ | × | × | × | × | × | OpenTP1管理者
prcteeプロセスの停止と再開始 | prctctrl | × | ○ | ○ | ○ | ○ | ○ | × | ○ | ○ | スーパユーザ
保守資料の取得 | dcrasget | × | ○ | ○ | ○ | ○ | ○ | ○ | × | × | OpenTP1管理者
システム統計情報の標準出力へのリアルタイム編集出力 | dcreport | × | × | ○ | × | × | ○ | ○ | × | × | OpenTP1管理者
トラブルシュート情報の削除 | dccspool | × | ○ | ○ | ○ | ○ | ○ | ○ | ○ | × | OpenTP1管理者
システム定義のチェック | dcdefchk | × | ○ | ○※3 | ○ | × | ○※3 | × | ○ | ○ | OpenTP1管理者
製品情報の表示 | dcpplist | × | ○ | ○ | ○ | ○ | ○ | ○ | × | × | OpenTP1管理者
サーバ管理 | サーバの開始 | dcsvstart | ○ | × | ○ | × | × | ○ | ○ | ○ | ○ | OpenTP1管理者
サーバの終了 | dcsvstop | × | × | ○ | × | × | ○ | ○ | ○ | ○ | OpenTP1管理者
サーバの状態表示 | prcls | × | × | ○ | × | ○ | ○ | ○ | × | × | 一般ユーザ
ユーザサーバ，およびユーザサーバから起動されるコマンドのサーチパス名の表示 | prcpathls | × | × | ○ | × | × | ○ | ○ | × | × | 一般ユーザ
ユーザサーバ，およびユーザサーバから起動されるコマンドのサーチパスの変更 | prcpath | × | × | ○ | × | × | ○ | ○ | ○ | ○ | OpenTP1管理者
UAP共用ライブラリのサーチパス名の表示 | prcdlpathls | × | × | ○ | × | × | ○ | ○ | × | × | 一般ユーザ
UAP共用ライブラリのサーチパスの変更 | prcdlpath | × | × | ○ | × | × | ○ | ○ | ○ | ○ | OpenTP1管理者
OpenTP1のプロセスの強制停止 | prckill | × | × | ○ | × | × | ○ | ○ | ○ | ○ | OpenTP1管理者
スケジュール管理 | スケジュールの状態表示 | scdls | × | × | ○ | × | × | ○ | ○ | × | × | 一般ユーザ
スケジュールの閉塞 | scdhold | × | × | ○ | × | × | ○ | ○ | ○ | ○ | OpenTP1管理者
スケジュールの再開始 | scdrles | × | × | ○ | × | × | ○ | ○ | ○ | ○ | OpenTP1管理者
プロセス数の変更 | scdchprc | × | × | ○ | × | × | ○ | ○ | ○ | ○ | OpenTP1管理者
プロセスの停止および再起動 | scdrsprc | × | × | ○ | × | × | ○ | ○ | ○ | ○ | OpenTP1管理者
トランザクション管理 | トランザクションの状態表示 | trnls | × | × | ○ | × | × | ○ | ○ | × | × | 一般ユーザ
トランザクションのコミット | trncmt | × | × | ○ | × | × | ○ | ○ | ○ | ○ | OpenTP1管理者
トランザクションのロールバック | trnrbk | × | × | ○ | × | × | ○ | ○ | ○ | ○ | OpenTP1管理者
トランザクションの強制終了 | trnfgt | × | × | ○ | × | × | ○ | ○ | ○ | ○ | OpenTP1管理者
トランザクション統計情報の取得開始，終了 | trnstics | × | × | ○ | × | × | ○ | ○ | ○ | ○ | OpenTP1管理者
未決着トランザクション情報ファイルの削除 | trndlinf | × | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | OpenTP1管理者
OSI　TP通信の未決着トランザクション情報の表示 | tptrnls | × | × | ○ | × | × | ○ | ○ | × | × | 一般ユーザ
XAリソース管理 | XARイベントトレース情報の表示 | xarevtr | × | ○ | ○ | ○ | × | ○ | × | × | × | 一般ユーザ
XARファイルの状態表示 | xarfills | × | ○ | ○ | ○ | × | ○ | ○ | × | × | 一般ユーザ
XARトランザクション状態の変更 | xarforce | × | × | ○ | × | × | ○ | ○ | ○ | ○ | OpenTP1管理者
XAリソースサービスの閉塞 | xarhold | × | × | ○ | × | × | ○ | ○ | ○ | ○ | OpenTP1管理者
XARファイルの作成 | xarinit | × | ○ | × | ○ | × | × | × | ○ | × | OpenTP1管理者
XARトランザクション情報の表示 | xarls | × | × | ○ | × | × | ○ | ○ | × | × | 一般ユーザ
XAリソースサービスの閉塞解除 | xarrles | × | × | ○ | × | × | ○ | ○ | ○ | ○ | OpenTP1管理者
XARファイルの削除 | xarrm | × | ○ | × | ○ | × | × | × | ○ | × | OpenTP1管理者
排他管理 | 排他情報の表示 | lckls | × | × | ○ | × | × | ○ | ○ | × | × | 一般ユーザ
排他制御用テーブルのプール情報の表示 | lckpool | × | × | ○ | × | × | ○ | ○ | × | × | 一般ユーザ
デッドロック情報ファイルとタイムアウト情報ファイルの削除 | lckrminf | × | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | OpenTP1管理者
ネーム管理 | OpenTP1起動確認，キャッシュ削除 | namalivechk | × | × | ○ | × | × | ○ | ○ | ○ | × | OpenTP1管理者
ドメイン代表スケジュールサービスの登録，削除 | namdomainsetup | × | × | ○ | ○ | ○ | ○ | ○ | × | × | スーパユーザ
ドメイン構成の変更（システム共通定義使用） | namndchg | × | × | ○ | × | ○ | ○ | ○ | ○ | ○ | OpenTP1管理者
ドメイン構成の変更（ドメイン定義ファイル使用） | namchgfl | × | × | ○ | × | ○ | ○ | ○ | ○ | ○ | OpenTP1管理者
起動通知情報の強制的無効化 | namunavl | × | × | ○ | × | × | ○ | × | ○ | × | OpenTP1管理者
OpenTP1のサーバ情報の表示 | namsvinf | × | × | ○ | × | × | ○ | ○ | × | × | OpenTP1管理者
RPC抑止リストの操作 | namblad | × | × | ○ | × | × | ○ | ○ | ○ | ○ | OpenTP1管理者
ノードリスト情報の削除 | namndrm | × | × | ○ | × | ○ | ○ | × | ○ | ○ | OpenTP1管理者
マネジャノードの変更 | nammstr | × | × | ○ | × | ○ | ○ | × | ○ | ○ | OpenTP1管理者
ノードリストファイルの作成 | namnlcre | × | ○ | ○ | ○ | ○ | ○ | × | ○ | ○ | OpenTP1管理者
ノードリストファイルの内容表示 | namnldsp | × | ○ | ○ | ○ | ○ | ○ | ○ | × | × | 一般ユーザ
ノードリストファイルの削除 | namnldel | × | ○ | ○ | ○ | ○ | ○ | × | ○ | ○ | OpenTP1管理者
ノードのオプション情報の変更 | namndopt | × | ○ | ○ | ○ | ○ | ○ | ○ | × | × | OpenTP1管理者
メッセージログ管理 | メッセージログファイルの内容表示 | logcat | × | × | ○ | × | ○ | ○ | ○ | × | × | 一般ユーザ
メッセージログのリアルタイム出力機能の切り替え | logcon | × | × | ○ | × | ○ | ○ | ○ | ○ | × | OpenTP1管理者
監査ログ管理 | 監査ログ機能の環境設定 | dcauditsetup | × | ○ | × | ○ | × | × | × | ○ | ○ | スーパユーザ
OpenTP1ファイル管理 | OpenTP1ファイルシステムの初期設定 | filmkfs | × | ○ | × | ○ | × | × | × | ○ | × | OpenTP1管理者
OpenTP1ファイルシステムの状態表示 | filstatfs | × | ○ | ○ | ○ | ○ | ○ | ○ | × | × | 一般ユーザ
OpenTP1ファイルシステムの内容表示 | fills | × | ○ | ○ | ○ | ○ | ○ | ○ | × | × | 一般ユーザ
OpenTP1ファイルシステムのバックアップ | filbkup | × | ○ | × | ○ | × | × | × | ○ | × | OpenTP1管理者
OpenTP1ファイルシステムのリストア | filrstr | × | ○ | × | ○ | × | × | × | ○ | × | OpenTP1管理者
OpenTP1ファイルグループの変更 | filchgrp | × | ○ | ○ | ○ | ○ | ○ | ○ | ○ | × | OpenTP1管理者
OpenTP1ファイルのアクセス許可モードの変更 | filchmod | × | ○ | ○ | ○ | ○ | ○ | ○ | ○ | × | OpenTP1管理者
OpenTP1ファイル所有者の変更 | filchown | × | ○ | ○ | ○ | ○ | ○ | ○ | ○ | × | OpenTP1管理者
ステータスファイル管理 | ステータスファイルの作成，初期設定 | stsinit | × | ○ | ○ | ○ | ○ | ○ | × | ○ | × | OpenTP1管理者
ステータスファイルの状態表示 | stsls | × | × | ○ | × | ○ | ○ | ○ | × | × | 一般ユーザ
ステータスファイルの内容表示 | stsfills | × | ○ | ○ | ○ | ○ | ○ | ○ | × | × | 一般ユーザ
ステータスファイルのオープン | stsopen | × | × | ○ | × | ○ | ○ | ○ | ○ | ○ | OpenTP1管理者
ステータスファイルのクローズ | stsclose | × | × | ○ | × | ○ | ○ | ○ | ○ | ○ | OpenTP1管理者
ステータスファイルの削除 | stsrm | × | ○ | ○ | ○ | ○ | ○ | ○ | ○ | × | OpenTP1管理者
ステータスファイルのスワップ | stsswap | × | × | ○ | × | ○ | ○ | ○ | ○ | ○ | OpenTP1管理者
ジャーナル関係のファイル管理 | ジャーナル関係のファイルの初期設定 | jnlinit | × | ○ | ○ | ○ | ○ | ○ | × | ○ | × | OpenTP1管理者
ジャーナル関係のファイル情報の表示 | jnlls | × | ○ | ○ | ○ | ○ | ○ | ○ | × | × | 一般ユーザ
再開始中読み込み済みジャーナル関係のファイル情報の表示 | jnlrinf | × | × | ○ | × | ○ | ○ | × | × | × | OpenTP1管理者
ジャーナル関係のファイルのオープン | jnlopnfg | × | × | ○ | × | ○ | ○ | ○ | ○ | ○ | OpenTP1管理者
ジャーナル関係のファイルのクローズ | jnlclsfg | × | × | ○ | × | ○ | ○ | ○ | ○ | ○ | OpenTP1管理者
ジャーナル関係の物理ファイルの割り当て | jnladdpf | ○ | × | ○ | × | × | ○ | ○ | ○ | ○ | OpenTP1管理者
ジャーナル関係の物理ファイルの削除 | jnldelpf | ○ | × | ○ | × | × | ○ | ○ | ○ | ○ | OpenTP1管理者
ジャーナル関係のファイルのスワップ | jnlswpfg | × | × | ○ | × | ○ | ○ | ○ | ○ | ○ | OpenTP1管理者
ジャーナル関係のファイルの削除 | jnlrm | × | × | ○ | × | ○ | ○ | × | ○ | × | OpenTP1管理者
ジャーナル関係のファイルのステータス変更 | jnlchgfg | × | ○ | ○ | ○ | ○ | ○ | × | ○ | ○ | OpenTP1管理者
ジャーナル関係のファイルのアンロード | jnlunlfg | × | ○ | ○ | ○ | ○ | ○ | × | ○ | ○ | OpenTP1管理者
自動アンロード機能の制御 | jnlatunl | × | × | ○ | × | × | ○ | × | ○ | ○ | OpenTP1管理者
ジャーナル関係のファイルの回復 | jnlmkrf | × | ○ | ○ | ○ | ○ | ○ | × | ○ | × | OpenTP1管理者
ファイル回復用ジャーナルの集積 | jnlcolc | × | ○ | ○ | ○ | ○ | ○ | × | ○ | × | OpenTP1管理者
アンロードジャーナルファイルの複写 | jnlcopy | × | ○ | ○ | ○ | × | ○ | × | ○ | × | OpenTP1管理者
アーカイブ状態の表示 | jnlarls | × | × | × | × | ○ | ○ | ○ | × | × | 一般ユーザ
アンロードジャーナルファイル，またはグローバルアーカイブアンロードジャーナルファイルの編集出力 | jnledit | × | ○ | ○ | ○ | ○ | ○ | × | ○ | × | OpenTP1管理者
アンロードジャーナルファイル，またはグローバルアーカイブアンロードジャーナルファイルのレコード出力 | jnlrput | × | ○ | ○ | ○ | ○ | ○ | × | ○ | × | OpenTP1管理者
アンロードジャーナルファイル，およびグローバルアーカイブアンロードジャーナルファイルの時系列ソート，およびマージ | jnlsort | × | × | × | ○ | ○ | ○ | × | ○ | × | OpenTP1管理者
稼働統計情報の出力 | jnlstts | × | ○ | ○ | ○ | ○ | ○ | × | ○ | × | OpenTP1管理者
MCF稼働統計情報の出力 | jnlmcst | × | ○ | ○ | ○ | ○ | ○ | × | ○ | × | OpenTP1管理者
リソースグループの接続の強制解除 | jnlardis | × | × | × | × | ○ | × | × | ○ | ○ | OpenTP1管理者
DAMファイル管理※⁴ | 物理ファイルの初期設定 | damload | × | ○ | × | ○ | × | × | × | ○ | × | OpenTP1管理者
論理ファイルの状態表示 | damls | × | × | ○ | × | × | ○ | ○ | × | × | 一般ユーザ
論理ファイルの追加 | damadd | × | × | ○ | × | × | ○ | ○ | ○ | ○ | OpenTP1管理者
論理ファイルの切り離し | damrm | × | × | ○ | × | × | ○ | ○ | ○ | ○ | OpenTP1管理者
論理ファイルの論理閉塞 | damhold | × | × | ○ | × | × | ○ | ○ | ○ | ○ | OpenTP1管理者
論理ファイルの閉塞解除 | damrles | × | × | ○ | × | × | ○ | ○ | ○ | ○ | OpenTP1管理者
物理ファイルの削除 | damdel | × | ○ | × | ○ | × | × | × | ○ | × | OpenTP1管理者
物理ファイルのバックアップ | dambkup | × | ○ | ○ | ○ | ○ | ○ | × | ○ | × | OpenTP1管理者
物理ファイルのリストア | damrstr | × | ○ | ○※⁵ | ○ | ○※⁵ | ○※⁵ | × | ○ | × | OpenTP1管理者
論理ファイルの回復 | damfrc | × | ○ | × | ○ | × | × | × | ○ | × | OpenTP1管理者
キャッシュブロック数のしきい値の設定 | damchdef | × | × | ○ | × | × | ○ | ○ | ○ | ○ | OpenTP1管理者
キャッシュブロック数の取得 | damchinf | × | × | ○ | × | × | ○ | ○ | × | × | 一般ユーザ
TAMファイル管理※⁶ | TAMファイルの初期設定 | tamcre | × | ○ | × | ○ | × | × | × | ○ | × | OpenTP1管理者
TAMテーブルの状態表示 | tamls | × | × | ○ | × | × | ○ | ○ | × | × | 一般ユーザ
TAMテーブルの追加 | tamadd | × | × | ○ | × | × | ○ | ○ | ○ | ○ | OpenTP1管理者
TAMテーブルの切り離し | tamrm | × | × | ○ | × | × | ○ | ○ | ○ | ○ | OpenTP1管理者
TAMテーブルの論理閉塞 | tamhold | × | × | ○ | × | × | ○ | ○ | ○ | ○ | OpenTP1管理者
TAMテーブルの閉塞解除 | tamrles | × | × | ○ | × | × | ○ | ○ | ○ | ○ | OpenTP1管理者
TAMテーブルのロード | tamload | × | × | ○ | × | × | ○ | ○ | ○ | ○ | OpenTP1管理者
TAMテーブルのアンロード | tamunload | × | × | ○ | × | × | ○ | ○ | ○ | ○ | OpenTP1管理者
TAMファイルの削除 | tamdel | × | ○ | × | ○ | × | × | × | ○ | × | OpenTP1管理者
TAMファイルのバックアップ | tambkup | × | ○ | ○ | ○ | ○ | ○ | × | ○ | × | OpenTP1管理者
TAMファイルのリストア | tamrstr | × | ○ | ○※⁷ | ○ | ○※⁷ | ○※⁷ | × | ○ | × | OpenTP1管理者
TAMファイルの回復 | tamfrc | × | ○ | × | ○ | × | × | × | ○ | × | OpenTP1管理者
TAM排他資源名称の変換 | tamlckls | × | × | ○ | × | × | ○ | ○ | × | × | 一般ユーザ
ハッシュ形式のTAMファイルおよびTAMテーブルのシノニム情報の表示 | tamhsls | × | ○ | ○ | ○ | × | ○ | × | × | × | OpenTP1管理者
メッセージキューファイル管理 | キューグループの状態表示 | quels | × | × | ○ | × | × | ○ | ○ | × | × | 一般ユーザ
メッセージキュー用物理ファイルの割り当て | queinit | × | ○ | ○ | ○ | × | ○ | × | ○ | × | OpenTP1管理者
メッセージキュー用物理ファイルの削除 | querm | × | ○ | ○ | ○ | × | ○ | × | ○ | × | OpenTP1管理者
リソースマネジャ管理 | リソースマネジャの情報の表示 | trnlsrm | × | ○ | ○ | ○ | × | ○ | × | × | ○ | 一般ユーザ
リソースマネジャの登録 | trnlnkrm | × | ○ | × | ○ | × | × | × | ○ | ○ | OpenTP1管理者
トランザクション制御用オブジェクトファイルの作成 | trnmkobj | × | ○ | ○ | ○ | × | ○ | × | ○ | ○ | OpenTP1管理者
トレース管理 | UAPトレースの編集出力 | uatdump※⁸ | × | ○ | × | ○ | × | × | × | × | × | 一般ユーザ
RPCトレースのマージ | rpcmrg | × | ○ | × | ○ | × | × | × | × | × | 一般ユーザ
RPCトレースの出力 | rpcdump | × | ○ | × | ○ | ○ | × | × | × | × | 一般ユーザ
共用メモリダンプの出力 | usmdump | × | × | ○ | × | ○ | ○ | ○ | × | × | OpenTP1管理者
リモートAPI管理 | リモートAPI機能の実行環境の設定 | rapsetup | × | ○ | × | ○ | × | × | × | ○ | × | OpenTP1管理者
リモートAPI機能に使用する定義の自動生成 | rapdfgen | × | ○ | ○※9 | ○ | ○※9 | ○※9 | × | ○ | × | OpenTP1管理者
rapリスナーおよびrapサーバの状態表示 | rapls | × | × | ○ | × | × | ○ | × | × | × | OpenTP1管理者
性能検証用トレース管理 | トレース情報ファイルの編集出力 | prfed | × | ○ | ○ | ○ | ○ | ○ | × | × | × | OpenTP1管理者
トレース情報ファイルの取り出し | prfget | × | ○ | ○ | ○ | ○ | ○ | × | ○ | ○ | OpenTP1管理者
リアルタイム統計情報サービス管理 | RTSログファイルの編集出力 | rtsedit | × | ○ | ○ | ○ | ○ | ○ | × | × | × | 一般ユーザ
リアルタイム統計情報の標準出力への出力 | rtsls | × | × | ○ | × | × | ○ | × | × | × | 一般ユーザ
リアルタイム統計情報サービスの実行環境の設定 | rtssetup | × | ○ | × | ○ | × | × | × | ○ | × | OpenTP1管理者
リアルタイム統計情報の設定変更 | rtsstats | × | × | ○ | × | × | ○ | × | ○ | ○ | OpenTP1管理者
OpenTP1解析支援 | 性能検証用トレース情報解析 | dcalzprf | × | ○ | ○ | ○ | ○ | ○ | × | × | ○ | OpenTP1管理者
コネクション管理※¹⁰，※¹¹ | コネクションの状態表示 | mcftlscn | × | × | ○ | × | × | ○ | ○ | × | × | 一般ユーザ
コネクションの確立 | mcftactcn | × | × | ○ | × | × | ○ | ○ | × | ○※12 | OpenTP1管理者
コネクションの解放 | mcftdctcn | × | × | ○ | × | × | ○ | ○ | × | ○※12 | OpenTP1管理者
コネクションの切り替え | mcftchcn | × | × | ○ | × | × | ○ | ○ | × | ○※12 | OpenTP1管理者
ネットワークの状態表示 | mcftlsln | × | × | ○ | × | × | ○ | ○ | × | × | 一般ユーザ
サーバ型コネクションの確立要求の受付開始 | mcftonln | × | × | ○ | × | × | ○ | ○ | × | ○※12 | OpenTP1管理者
サーバ型コネクションの確立要求の受付終了 | mcftofln | × | × | ○ | × | × | ○ | ○ | × | ○※12 | OpenTP1管理者
メッセージ多重処理状況の表示 | mcftlstrd | × | × | ○ | × | × | ○ | ○ | × | × | OpenTP1管理者
アプリケーション管理※¹⁰，※¹¹ | アプリケーションの状態表示 | mcfalsap | × | × | ○ | × | × | ○ | ○ | × | × | 一般ユーザ
アプリケーションの閉塞 | mcfadctap | × | × | ○ | × | × | ○ | ○ | × | ○※12 | OpenTP1管理者
アプリケーションの閉塞解除 | mcfaactap | × | × | ○ | × | × | ○ | ○ | × | ○※12 | OpenTP1管理者
アプリケーション異常終了回数の初期化 | mcfaclcap | × | × | ○ | × | × | ○ | ○ | × | ○※12 | OpenTP1管理者
アプリケーションに関するタイマ起動要求の表示 | mcfalstap | × | × | ○ | × | × | ○ | ○ | × | × | 一般ユーザ
アプリケーションに関するタイマ起動要求の削除 | mcfadltap | × | × | ○ | × | × | ○ | ○ | × | ○※12 | OpenTP1管理者
アプリケーション運用支援※¹⁰，※¹¹ | アプリケーションプログラムの起動 | mcfuevt | × | × | ○ | × | × | ○ | ○ | × | ○※12 | 一般ユーザ
論理端末管理※¹⁰，※¹¹ | 論理端末の状態表示 | mcftlsle | × | × | ○ | × | × | ○ | ○ | × | × | 一般ユーザ
論理端末の閉塞 | mcftdctle | × | × | ○ | × | × | ○ | ○ | × | ○※12 | OpenTP1管理者
論理端末の閉塞解除 | mcftactle | × | × | ○ | × | × | ○ | ○ | × | ○※12 | OpenTP1管理者
論理端末のメッセージキューの先頭スキップ | mcftspqle | × | × | ○ | × | × | ○ | ○ | × | ○※12 | OpenTP1管理者
論理端末の出力キュー処理の保留 | mcfthldoq | × | × | ○ | × | × | ○ | ○ | × | ○※12 | OpenTP1管理者
論理端末の出力キュー処理の保留解除 | mcftrlsoq | × | × | ○ | × | × | ○ | ○ | × | ○※12 | OpenTP1管理者
論理端末の出力キュー削除 | mcftdlqle | × | × | ○ | × | × | ○ | ○ | × | ○※12 | OpenTP1管理者
論理端末に関するメッセージジャーナルの取得開始 | mcftactmj | × | × | ○ | × | × | ○ | ○ | × | ○※12 | OpenTP1管理者
論理端末に関するメッセージジャーナルの取得終了 | mcftdctmj | × | × | ○ | × | × | ○ | ○ | × | ○※12 | OpenTP1管理者
論理端末に対する継続問い合わせ応答処理の強制終了 | mcftendct | × | × | ○ | × | × | ○ | ○ | × | ○※12 | OpenTP1管理者
代行送信の開始 | mcftstalt | × | × | ○ | × | × | ○ | ○ | × | ○※12 | OpenTP1管理者
代行送信の終了 | mcftedalt | × | × | ○ | × | × | ○ | ○ | × | ○※12 | OpenTP1管理者
サービスグループ管理※¹⁰，※¹¹ | サービスグループの状態表示 | mcftlssg | × | × | ○ | × | × | ○ | ○ | × | × | 一般ユーザ
サービスグループの閉塞 | mcftdctsg | × | × | ○ | × | × | ○ | ○ | × | ○※12 | OpenTP1管理者
サービスグループの閉塞解除 | mcftactsg | × | × | ○ | × | × | ○ | ○ | × | ○※12 | OpenTP1管理者
サービスグループの入力キュー処理の保留 | mcfthldiq | × | × | ○ | × | × | ○ | ○ | × | ○※12 | OpenTP1管理者
サービスグループの入力キュー処理の保留解除 | mcftrlsiq | × | × | ○ | × | × | ○ | ○ | × | ○※12 | OpenTP1管理者
サービスグループの入力キュー削除 | mcftdlqsg | × | × | ○ | × | × | ○ | ○ | × | ○※12 | OpenTP1管理者
サービス管理※¹⁰，※¹¹ | サービスの状態表示 | mcftlssv | × | × | ○ | × | × | ○ | ○ | × | × | 一般ユーザ
サービスの閉塞 | mcftdctsv | × | × | ○ | × | × | ○ | ○ | × | ○※12 | OpenTP1管理者
サービスの閉塞解除 | mcftactsv | × | × | ○ | × | × | ○ | ○ | × | ○※12 | OpenTP1管理者
セション管理※¹⁰，※¹¹ | セションの開始 | mcftactss | × | × | ○ | × | × | ○ | ○ | × | ○※12 | OpenTP1管理者
セションの終了 | mcftdctss | × | × | ○ | × | × | ○ | ○ | × | ○※12 | OpenTP1管理者
バッファ管理※¹⁰，※¹¹ | バッファグループの使用状況表示 | mcftlsbuf | × | × | ○ | × | × | ○ | ○ | × | × | 一般ユーザ
マップ管理※¹⁰，※¹¹ | マップファイルのパス名変更 | dcmapchg | × | × | ○ | × | × | ○ | × | × | × | OpenTP1管理者
マップファイルのロード済み資源の表示 | dcmapls | × | × | ○ | × | × | ○ | × | × | × | OpenTP1管理者
キュー管理※¹⁰，※¹¹ | 入出力キューの内容複写 | mcftdmpqu | × | × | ○ | × | × | ○ | ○ | × | ○※12 | 一般ユーザ
MCFトレース取得管理※¹⁰，※¹¹ | MCFトレースファイルの強制スワップ | mcftswptr | × | × | ○ | × | × | ○ | ○ | × | × | OpenTP1管理者
MCFトレース取得の開始 | mcftstrtr | × | × | ○ | × | × | ○ | ○ | × | × | OpenTP1管理者
MCFトレース取得の終了 | mcftstptr | × | × | ○ | × | × | ○ | ○ | × | × | OpenTP1管理者
MCF稼働統計情報管理 | MCF稼働統計情報の編集 | mcfreport | × | ○ | × | ○ | × | × | × | × | × | OpenTP1管理者
MCF稼働統計情報の出力 | mcfstats | × | × | ○ | × | × | ○ | ○ | × | ○※12 | OpenTP1管理者
MCF通信サービス管理※¹⁰，※¹³ | MCF通信サービスの部分停止 | mcftstop | × | × | ○ | × | × | ○ | × | × | ○※12 | OpenTP1管理者
MCF通信サービスの部分開始 | mcftstart | × | × | ○ | × | × | ○ | × | × | ○※12 | OpenTP1管理者
MCF通信サービスの状態参照と開始待ち合わせ | mcftlscom | × | × | ○ | × | × | ○ | × | × | × | OpenTP1管理者
ユーザタイマ管理※¹⁰，※¹¹ | ユーザタイマ監視の状態表示 | mcftlsutm | × | × | ○ | × | × | ○ | ○ | × | × | 一般ユーザ

（凡例）

オフ：オフライン中に実行

オン：オンライン中に実行

arcjnl：アーカイブジャーナルファイル

○：組み込み，または実行できます。

×：組み込み，または実行できません。

注1

プロトコルによって固有のコマンドがあります。プロトコル固有のコマンドについては，各プロトコルのマニュアルを参照してください。

注2

コマンドログの出力先およびコマンドログの情報については，「3.6.2(1)　コマンドログの出力形式」を参照してください。

注※1

UAPから実行する場合は，バックグラウンドで実行してください。

注※2

prcteeコマンドはコマンドラインやシェルから実行しないで，必ず$DCDIR/bin/prcoutに定義し，dcsetupコマンドまたはprctctrlコマンドで実行してください。詳細については，「3.5　標準出力ファイルに関する運用」を参照してください。

注※3

OpenTP1動作中に実行した場合は，動作中のOpenTP1で有効な値ではなく，コマンド実行時にシステム定義に指定した値です。

注※4

DAMファイル使用時にだけ使用できます。

注※5

damholdコマンドで論理ファイルを論理閉塞後，damrmコマンドで論理ファイルを切り離したあとは，オンライン中でも実行できます。

注※6

TAMファイル使用時にだけ使用できます。

注※7

tamholdコマンドでTAMテーブルを論理閉塞後，tamrmコマンドでTAMテーブルを切り離したあとは，オンライン中でも実行できます。

注※8

uatdumpコマンドの詳細については，マニュアル「OpenTP1 テスタ・UAPトレース使用の手引」を参照してください。

注※9

rapリスナーおよびrapサーバが正常停止している場合だけ実行できます。

注※10

MCF使用時にだけ使用できます。

注※11

運用コマンドを入力してから180秒以内に処理が終了しないとタイムアウトとなり，処理を終了します。

注※12

コマンドログを取得するには環境変数の設定が必要です。取得方法の詳細については，「3.6.2(2)　コマンドログの取得方法」を参照してください。

注※13

運用コマンドを入力するタイミング，および定義された環境によっては，制限事項があります。詳細については，「3.14.3　MCF通信サービスの部分入れ替え」，および「13.　運用コマンドの詳細」の各コマンドの説明を参照してください。

12.1.5　運用コマンド入力時の注意事項

OpenTP1終了中，強制終了中，または異常終了中に運用コマンドを入力すると，コマンドプロセスが異常終了することがあります。

rsh（リモートシェル）コマンドの引数にMCFの運用コマンドを指定する場合，MCFの運用コマンドの前後をアポストロフィ（’）で囲んで指定してください。

各運用コマンドは，入力された単位で順番に処理されます。運用コマンドを多数入力する場合には，順番待ちが発生して，入力数が増えるほど，待ち時間が拡大します。したがって，運用コマンドの入力を業務運用の一部に組み込む場合は，必要最小限の入力数となるように運用設計を行ってください。

運用コマンドを実行するときのOSプライオリティは，OpenTP1のプライオリティと同じ値を設定することをお勧めします。プライオリティが低い場合で，dcstartコマンドを実行すると，OpenTP1を開始できないことがあります。詳細については，「10.6.1(10)　CPUの負荷が高いとき」を参照してください。

OpenTP1停止直後に運用コマンドを入力すると，コマンドが中断することがあります。

13.　運用コマンドの詳細

運用コマンドをアルファベット順に説明します。

＜この章の構成＞

damadd

dambkup

damchdef

damchinf

damdel

damfrc

damhold

damload

damls

damrles

damrm

damrstr

dcalzprf

dcauditsetup

dccspool

dcdefchk

dcjchconf

dcjcmdex

dcjnamch

dcmakeup

dcmapchg

dcmapls

dcmstart

dcmstop

dcndls

dcpplist

dcrasget

dcreport

dcreset

dcsetup

dcshmls

dcstart

dcstats

dcstop

dcsvstart

dcsvstop

filbkup

filchgrp

filchmod

filchown

fills

filmkfs

filrstr

filstatfs

jnladdpf

jnlardis

jnlarls

jnlatunl

jnlchgfg

jnlclsfg

jnlcolc

jnlcopy

jnldelpf

jnledit

jnlinit

jnlls

jnlmcst

jnlmkrf

jnlopnfg

jnlrinf

jnlrm

jnlrput

jnlsort

jnlstts

jnlswpfg

jnlunlfg

lckls

lckpool

lckrminf

logcat

logcon

mcfaactap

mcfaclcap

mcfadctap

mcfadltap

mcfalsap

mcfalstap

mcfreport

mcfstats

mcftactcn

mcftactle

mcftactmj

mcftactsg

mcftactss

mcftactsv

mcftchcn

mcftdctcn

mcftdctle

mcftdctmj

mcftdctsg

mcftdctss

mcftdctsv

mcftdlqle

mcftdlqsg

mcftdmpqu

mcftedalt

mcftendct

mcfthldiq

mcfthldoq

mcftlsbuf

mcftlscn

mcftlscom

mcftlsle

mcftlsln

mcftlssg

mcftlssv

mcftlstrd

mcftlsutm

mcftofln

mcftonln

mcftrlsiq

mcftrlsoq

mcftspqle

mcftstalt

mcftstart

mcftstop

mcftstptr

mcftstrtr

mcftswptr

mcfuevt

namalivechk

namblad

namchgfl

namdomainsetup

nammstr

namndchg

namndopt

namndrm

namnlcre

namnldel

namnldsp

namsvinf

namunavl

prcdlpath

prcdlpathls

prckill

prcls

prcpath

prcpathls

prctctrl

prctee

prfed

prfget

queinit

quels

querm

rapdfgen

rapls

rapsetup

rpcdump

rpcmrg

rpcstat

rtsedit

rtsls

rtssetup

rtsstats

scdchprc

scdhold

scdls

scdrles

scdrsprc

stsclose

stsfills

stsinit

stsls

stsopen

stsrm

stsswap

tamadd

tambkup

tamcre

tamdel

tamfrc

tamhold

tamhsls

tamlckls

tamload

tamls

tamrles

tamrm

tamrstr

tamunload

tptrnls

trncmt

trndlinf

trnfgt

trnlnkrm

trnls

trnlsrm

trnmkobj

trnrbk

trnstics

usmdump

xarevtr

xarfills

xarforce

xarhold

xarinit

xarls

xarrles

xarrm

damadd

名称

論理ファイルの追加

形式

damadd 〔｛-d｜-n〔-f〕｝〕〔-l キャッシュブロック再利用境界値〕
       論理ファイル名 物理ファイル名

機能

指定した論理ファイルを追加登録します。

すでに使用している物理ファイルに対して別の論理ファイルを割り当てることはできません。

オプション

●-d

論理ファイルを，ディファード更新機能を使用するファイルとして追加登録します。

DAMサービス定義でディファード更新機能を使用するファイルを一つも指定していない場合，-dオプションは指定できません。

このオプションは，-nオプションと同時には指定できません。

●-n

回復対象外ファイルとして，追加登録します。

このオプションの指定を省略すると，回復対象ファイルとして追加登録されます。

このオプションは，-dオプションと同時には指定できません。

●-f

キャッシュレスアクセスの回復対象外ファイルとして，追加登録します。このオプションは，-nオプションと同時に指定してください。

●-l　キャッシュブロック再利用境界値　　～〈符号なし整数〉((0～4000000))《0》

DAMファイルのキャッシュブロック再利用境界値を指定します。

このオプションの指定を省略して，追加登録したDAMファイルの再利用境界値は，DAMサービス定義のdam_default_cache_numオペランドの指定の有無に関係なく0として扱われます。

コマンド引数

●論理ファイル名　　～〈1～8文字の識別子〉

追加登録する論理ファイルの名称を指定します。

●物理ファイル名　　～〈パス名〉

論理ファイルに対応する物理ファイルの名称を完全パス名で指定します。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA01650-E | コマンド引数の指定が誤っています | 標準エラー出力
KFCA01651-E | 論理ファイル名が8文字を超えています | 標準エラー出力
KFCA01652-E | 物理ファイル名が63文字を超えています | 標準エラー出力
KFCA01653-I | ヘルプメッセージ | 標準出力
KFCA01654-E | スペシャルファイルに対するアクセス権がありません | 標準エラー出力
KFCA01655-E | ファイルに対するアクセス権がありません | 標準エラー出力
KFCA01656-E | ブロック長が長過ぎます | 標準エラー出力
KFCA01657-E | DAMファイルではありません | 標準エラー出力
KFCA01658-E | 同じ論理ファイル名があります | 標準エラー出力
KFCA01659-E | 同じ物理ファイル名があります | 標準エラー出力
KFCA01660-E | 初期化されていません | 標準エラー出力
KFCA01661-E | 入出力エラーが発生しました | 標準エラー出力
KFCA01662-E | メモリ不足です | 標準エラー出力
KFCA01663-E | 物理ファイルがありません | 標準エラー出力
KFCA01664-E | 追加領域が不足しています | 標準エラー出力
KFCA01665-E | オープンファイル数オーバです | 標準エラー出力
KFCA01666-E | 物理ファイル名が誤っています | 標準エラー出力
KFCA01667-E | バージョンが不一致です | 標準エラー出力
KFCA01679-E | DAMサービスが起動されていません | 標準エラー出力
KFCA01680-E | DAMサービスのアドレス情報を検索できません | 標準エラー出力
KFCA01681-E | 通信障害が発生しました | 標準エラー出力
KFCA01682-E | ネットワーク障害が発生しました | 標準エラー出力
KFCA01683-E | タイムオーバです | 標準エラー出力
KFCA01684-E | DAMサービスが終了処理中です | 標準エラー出力
KFCA01695-E | DAMファイルが未完成です | 標準エラー出力
KFCA01696-E | 定義解析中にエラーが発生しました | 標準エラー出力
KFCA01698-E | レコード・ロック・セグメントが不足しています | 標準エラー出力
KFCA02524-E | ディファード指定で追加登録できません | 標準エラー出力

注意事項

登録済みの物理ファイルのブロック長より大きいブロック長を持つ物理ファイルに対応する論理ファイルの追加登録はできません。

DAMサービス定義で定義した「オンライン中に追加する最大論理ファイル数」を超えて追加登録することはできません。

dambkup

名称

物理ファイルのバックアップ

形式

dambkup 〔-c 一括処理ブロック数〕〔-o｜-d〕
       ｛物理ファイル名　バックアップファイル名｜-s 物理ファイル名｝

機能

指定した物理ファイルの内容を，指定したファイル，または標準出力にバックアップ出力します。

オプション

●-c　一括処理ブロック数　　～〈符号なし整数〉((1～2147483647))《10》

一度に入出力するブロック数を指定します。

指定したブロック数でディスクに入出力されます。ただし，バックアップ元物理ファイルのブロック数を超える値を指定した場合は，バックアップ元物理ファイルのブロック数でディスクに入出力されます。

●-o

オンライン中に，バックアップします。

このオプションは，対象となるDAMファイルがオンライン状態のときに有効です。

このオプションの指定を省略すると，オフライン状態でバックアップすることになります。この場合，次の手順でバックアップしてください。

damholdコマンドを実行して論理ファイルを論理閉塞します。

damrmコマンドを実行して，論理閉塞した論理ファイルをオンラインから切り離します。

-oオプションを指定しないdambkupコマンドを実行してDAMファイルをバックアップします。

●-d

バックアップ元の物理ファイルから，先頭の管理ブロックおよびチェックバイトを除いたユーザデータだけをバックアップします。

●-s

バックアップを標準出力に出力する場合に指定します。

コマンド引数

●物理ファイル名　　～〈パス名〉

バックアップ元の物理ファイルの名称を完全パス名で指定します。

●バックアップファイル名　　～〈パス名〉

バックアップ先のファイルの名称を指定します。

-sオプションを指定した場合は，このコマンド引数は指定できません。

注意事項

オンラインで使用中のDAMファイルに対して，-oオプションを指定しないdambkupコマンドは実行できません。

オンラインバックアップが完了すると，KFCA02531-Iメッセージが出力されます。このメッセージは，通常は標準出力に出力されますが，-sオプションを指定した場合は，標準エラー出力に出力されます。出力されたメッセージには回復対象ジャーナルファイルの世代番号とブロック番号が含まれています。この世代番号とブロック番号以降のアンロードジャーナルファイルが，DAMファイルの回復時に必要となります。

-oオプションと-sオプションを同時に指定してdambkupコマンドを実行する場合に，カレントディレクトリ下に次に示す容量以上の空き領域がないと，KFCA00107-Eメッセージを出力してコマンドが異常終了することがあります。この場合，ディスクの容量を調べて不要なファイルを削除して，領域を確保してください。
　　　バックアップ対象DAMファイルの容量＋128バイト以上
　　　（（ブロック数＋1）×ブロック長）

-dオプションを指定してバックアップしたデータは，物理ファイルにリストアできません。

オンライン中のDAMファイルからは，ユーザデータだけを抽出することはできません。

damchdef

名称

キャッシュブロック数のしきい値の設定

形式

damchdef　論理ファイル名　キャッシュブロック数のしきい値

機能

オンライン中，動的にキャッシュブロック数のしきい値を設定します。

コマンド引数

●論理ファイル名　　～〈1～8文字の識別子〉

キャッシュブロック数のしきい値を設定する論理ファイル名を指定します。指定する論理ファイルは，論理閉塞状態でなければなりません。

●キャッシュブロック数のしきい値　　～〈符号なし整数〉((0～4000000))

一つのDAMファイルで管理するキャッシュブロック数のしきい値を指定します。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA01650-E | コマンド引数の指定が誤っています | 標準エラー出力
KFCA01651-E | 論理ファイル名が8文字を超えています | 標準エラー出力
KFCA01670-E | 該当する論理ファイルがありません | 標準エラー出力
KFCA01679-E | DAMサービスが起動されていません | 標準エラー出力
KFCA02568-I | ヘルプメッセージ | 標準出力
KFCA02571-E | 指定したキャッシュブロック数のしきい値は有効な値ではありません | 標準エラー出力

注意事項

damchdefコマンドは，論理閉塞されている論理ファイルだけ有効となります。

damchdefコマンドで指定したしきい値は，対象論理ファイルがオンライン状態の間有効となります。damrmコマンドでオンラインから削除した場合は，指定したしきい値は無効となります。

damchinf

名称

キャッシュブロック数の取得

形式

damchinf 〔-c〕〔-i〕〔論理ファイル名〕

機能

現時点でのキャッシュブロックチェインにつながっているキャッシュブロック数を取得します。

オプション

●-c

各情報の区切りに","（コンマ）を付加します。

●-i

キャッシュメモリの全体情報だけを表示します。このオプションを省略すると，各論理ファイルのキャッシュメモリ情報も表示します。

コマンド引数

●論理ファイル名　　～〈1～8文字の識別子〉

キャッシュメモリ情報を表示する論理ファイル名を指定します。この引数を省略すると，DAMサービスが管理しているすべての論理ファイルのキャッシュメモリ情報を表示します。

出力形式

-iオプションを指定した場合，出力されません。

論理ファイル名を指定しないと，DAMサービスが管理している論理ファイルすべてについて，繰り返し出力されます。

aa...aa：クリーンアップ処理が実行された回数

bb...bb：次回のクリーンアップ処理の実行対象となるファイル番号

cc...cc：DAMキャッシュメモリ用共用メモリプールの使用率

dd...dd：ファイル番号(シーケンシャルに出力されるとは限りません)

ee...ee：論理ファイル名（8文字以内）

ff...ff：論理ファイル(ee...ee)のブロック長

gg...gg：論理ファイル(ee...ee)のブロック数

hh...hh：論理ファイル(ee...ee)につながっているキャッシュブロックの数

ii...ii：保守情報

jj...jj：キャッシュブロック数のしきい値

kk...kk：再利用キャッシュブロックチェインの有無

Exist…再利用キャッシュブロックチェインあり

None…再利用キャッシュブロックチェインなし

出力メッセージ

メッセージID | 内容 | 出力先
KFCA01650-E | コマンド引数の指定が誤っています | 標準エラー出力
KFCA01651-E | 論理ファイル名が8文字を超えています | 標準エラー出力
KFCA01670-E | 該当する論理ファイルがありません | 標準エラー出力
KFCA01679-E | DAMサービスが起動されていません | 標準エラー出力
KFCA02548-I | ヘルプメッセージ | 標準出力

注意事項

damchinfコマンドを，damaddコマンドおよびdamrmコマンドと同時に実行した場合，情報が出力されなかったり，不正な情報が出力されたりすることがあります。その場合は，再度コマンドを実行してください。

damdel

名称

物理ファイルの削除

形式

damdel 物理ファイル名

機能

指定した物理ファイルを削除します。

指定した物理ファイルをオンラインで使用している場合，およびほかのオフラインプロセスで使用している場合は，削除できません。オンラインで使用している物理ファイルを削除する場合は，対応する論理ファイルをdamrmコマンドでオンラインから切り離したあと，damdelコマンドを実行します。

コマンド引数

●物理ファイル名　　～〈パス名〉

削除する物理ファイルの名称を完全パス名で指定します。

damfrc

名称

論理ファイルの回復

形式

damfrc 〔-s〕 〔-e〕 〔-g〕 〔-k キー〕 〔-n〕 〔-c〕〔-m〕
       回復対象定義ファイル名
       ジャーナルファイル名 〔〔△ジャーナルファイル名〕 …〕

機能

指定したジャーナルファイルを使用して，DAMサービス定義で指定された論理ファイルを，障害が発生した直前の状態にまで回復します。

ただし，回復対象外ファイルに対してdamfrcコマンドを実行しても，ファイルは回復できません。

オプション

●-s

前回のDAM FRCを引き継ぎません。

このオプションの指定を省略すると，前回のDAM FRCが引き継がれます。

●-e

DAM FRC終了時に，引き継ぎファイルを削除します。

このオプションを指定してDAM FRCを実行した場合，次回のDAM FRC実行時には，必ず-sオプションを指定してください。

このオプションの指定を省略すると，引き継ぎファイルは削除されません。

●-g

-sオプションの指定があり，かつジャーナル世代番号が1であるアンロードジャーナルファイルの指定がない場合でも，DAM FRCを実行します。

上記の場合，このオプションの指定を省略すると，処理は中断されます。

-sオプションの指定がない場合，このオプションを指定しても無視されます。

●-k　キー　　～((001～999))《001》

複数のDAM FRCを同時に実行する場合，それぞれ別のキーとなるように指定してください。

また，tamfrcコマンド，およびmqafrcコマンドをこのコマンドと同時に，または連続して実行する場合も，それぞれ別のキーとなるように指定してください。

前回のDAM FRCを引き継ぐ場合は，前回指定したキーを指定してください。

●-n

集積ジャーナルファイル内のFJの変更後のデータからDAMファイルを回復します。

このオプションの指定を省略すると，集積ジャーナルファイル内のFJの変更前のデータと変更後のデータの正当性が検証され，検証結果が正しければ，変更後のデータからDAMファイルが回復されます。

●-c

コマンド引数に指定したジャーナルファイルを，あらかじめjnlcolcコマンドで作成した集積ジャーナルファイルと見なして，DAMファイルを回復します。

このオプションの指定を省略すると，コマンド引数に指定したジャーナルファイルをアンロードジャーナルファイルと見なされます。そのため，jnlcolcコマンドで集積ジャーナルファイルを作成したあと，damfrcコマンドを実行してください。

●-m

ファイルの回復に必要なジャーナルレコードをファイル上で集積します。

このオプションの指定を省略すると，メモリ上にバッファが確保されて，ジャーナルレコードが集積されます。

コマンド引数

●回復対象定義ファイル名　　～〈パス名〉

回復するDAMファイルを定義したファイルの名称を指定します。

回復対象定義ファイルは次の形式で，テキストエディタを用いて作成します。

    〔△〕論理ファイル名△物理ファイル名〔△〕（改行）
    〔論理ファイル名△物理ファイル名〕〔△〕（改行）
             :                 :

論理ファイル名　　～〈1～8文字の識別子〉

回復したいDAMファイルの論理ファイル名

物理ファイル名　　～〈パス名〉

回復先の物理ファイル名（完全パス名で指定）

指定する物理ファイルは，バックアップしたファイルをリストアしたものです。オンラインバックアップしたファイルをリストアしたもの，またはオフライン状態でバックアップしたファイルをリストアしたもののどちらかを指定してください。混在はできません。

●ジャーナルファイル名　　～〈パス名〉

DAM FRC実行時に使用するジャーナルファイルの名称を指定します。

-cオプションを指定した場合は，集積ジャーナルファイルの名称を，-cオプションの指定を省略した場合は，アンロードジャーナルファイルの名称を指定します。

複数世代のジャーナルを処理する場合，複数のジャーナルファイル名を指定します。ただし，集積ジャーナルファイルの場合は複数指定できません。

オンラインバックアップしたファイルを回復する場合，すべてのアンロードジャーナルファイルを指定する必要はありません。オンラインバックアップ完了時に出力されたメッセージ（KFCA02531-I）に含まれる，回復対象ジャーナルファイルの世代番号とブロック番号以降のアンロードジャーナルファイルを指定してください。

なお，オフライン状態でバックアップしたファイルを回復する場合は，すべてのアンロードジャーナルファイルを指定してください。

注意事項

damfrcコマンドは，jnlcolcコマンドを内部で使用しています。そのため，jnlcolcコマンドに関するエラーメッセージが出力されることがあります。マニュアル「OpenTP1 メッセージ」に従って対処してください。

damfrcコマンドは，条件によってカレントディレクトリにテンポラリファイルを作成します。そのため，カレントディレクトリには書き込み権を設定してください。また，テンポラリファイルのディスク容量は，次のようになります。

回復しようとするDAMファイルがオフラインバックアップ※¹で取得したものをリストアしたファイルであり，damfrcコマンドに-cオプションを指定していない場合：
　最大　4096+a　（単位：バイト）

回復しようとするDAMファイルがオンラインバックアップ※²で取得したものをリストアしたファイルであり，damfrcコマンドに-cオプションを指定していない場合：
　最大　96+4096+a　（単位：バイト）

上記1.および2.以外の場合（damfrcコマンドに-cオプションを指定した場合），テンポラリファイルを作成しません。

（凡例）
　a：damfrcコマンド実行時に指定したアンロードジャーナルファイルの総ディスク容量※³
注※1
　DAMファイルのバックアップ時，オフラインの状態（-oオプションなし）でdambkupコマンドを実行した場合。
注※2
　DAMファイルのバックアップ時，dambkupコマンドに-oオプションを指定した場合。
注※3
　総ディスク容量は，UNIXのlsコマンドで参照できます。複数個指定した場合は，その合計になります。

jnlunlfgコマンドに-tオプションを指定して取得したアンロードジャーナルファイルを指定しないでください。

使用例

次の場合の使用例を示します。それぞれ世代番号は1，2…とします。

　回復対象定義ファイル：damdef，damdef1…

　アンロードジャーナルファイル：jnl001，jnl002…

　集積ジャーナルファイル：jnlcolc01

複数のアンロードジャーナルファイルを使用し，1回でDAM FRCが完了する場合
回復対象定義ファイル名：/work/damdef
アンロードジャーナルファイル名：/jnldir/jnl001，/jnldir/jnl002

damfrc -se /work/damdef /jnldir/jnl001 /jnldir/jnl002

3回に分けてDAM FRCを実行する場合
回復対象定義ファイル名：/work/damdef
アンロードジャーナルファイル名：
　/jnldir/jnl001，/jnldir/jnl002，
　/jnldir/jnl003，/jnldir/jnl004

<1回目>
damfrc -s /work/damdef /jnldir/jnl001 /jnldir/jnl002
<2回目>
damfrc /work/damdef /jnldir/jnl003
<3回目>
damfrc -e /work/damdef /jnldir/jnl004

二つのDAM FRCを同時に1回で実行する場合
回復対象定義ファイル名：/work/damdef1，/work/damdef2
アンロードジャーナルファイル名：
　/jnldir/jnl001（両方のDAM FRCで使用）
　/jnldir/jnl002（二つ目のDAM FRCだけで使用）

<一つ目のDAM FRC>
damfrc -se -k001 /work/damdef1 /jnldir/jnl001
<二つ目のDAM FRC>
damfrc -se -k002 /work/damdef2 /jnldir/jnl001 /jnldir/jnl002

途中の世代のアンロードジャーナルファイルを使用して，DAM FRCを1回で実行する場合
回復対象定義ファイル名：/work/damdef
アンロードジャーナルファイル名：/jnldir/jnl002，/jnldir/jnl003

damfrc -seg /work/damdef /jnldir/jnl002 /jnldir/jnl003

集積ジャーナルファイルを使用して，DAM FRCを1回で実行する場合
回復対象定義ファイル名：/work/damdef
集積ジャーナルファイル名：/jnldir/jnlcolc01

damfrc -sec /work/damdef /jnldir/jnlcolc01

damhold

名称

論理ファイルの論理閉塞

形式

damhold 論理ファイル名

機能

指定した論理ファイルを論理閉塞します。

コマンド引数

●論理ファイル名　　～〈1～8文字の識別子〉

論理閉塞する論理ファイルの名称を指定します。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA01650-E | コマンド引数の指定が誤っています | 標準エラー出力
KFCA01651-E | 論理ファイル名が8文字を超えています | 標準エラー出力
KFCA01662-E | メモリ不足です | 標準エラー出力
KFCA01667-E | バージョンが不一致です | 標準エラー出力
KFCA01670-E | 該当する論理ファイルがありません | 標準エラー出力
KFCA01671-I | ヘルプメッセージ | 標準出力
KFCA01672-E | 論理ファイルは障害閉塞済みです | 標準エラー出力
KFCA01673-E | 論理ファイルは論理閉塞済みです | 標準エラー出力
KFCA01674-I | 論理閉塞待ちです | 標準出力
KFCA01679-E | DAMサービスが起動されていません | 標準エラー出力
KFCA01680-E | DAMサービスのアドレス情報を検索できません | 標準エラー出力
KFCA01681-E | 通信障害が発生しました | 標準エラー出力
KFCA01682-E | ネットワーク障害が発生しました | 標準エラー出力
KFCA01683-E | タイムオーバです | 標準エラー出力
KFCA01684-E | DAMサービス終了処理中です | 標準エラー出力
KFCA01696-E | 定義解析中にエラーが発生しました | 標準エラー出力

注意事項

DAMサービスは，damholdコマンドを受け付けた時点で，指定されたファイルのアクセスを禁止状態にします。ディファード更新指定のファイルを論理閉塞する場合，そのファイルに対応するバッファ領域のブロックがディスクに出力されるまで論理閉塞待ち状態となり，論理閉塞されません。そのため，バッファ領域のブロックがディスクに出力されるまで，論理ファイルは削除できません。damrmコマンドを実行してもコマンドエラーとなります。

damload

名称

物理ファイルの初期設定

形式

damload 〔-b 一括処理ブロック数〕ブロック長　ブロック数　物理ファイル名　〔入力ファイル名〕

機能

OpenTP1ファイルシステム上に物理ファイルを割り当て，指定した入力ファイルからデータを入力して物理ファイルに出力します。このとき，（ブロック長＋8）×（ブロック数＋1）が物理ファイルの大きさとなります。また，物理ファイルのアクセス権は0644（所有者による読み込み権と書き込み権，グループによる読み込み権，他者による読み込み権）となります。

オプション

●-b　一括処理ブロック数　　～〈符号なし整数〉((0～2147483647))《10》

一度に出力するブロック数を指定します。0を指定した場合は，10になります。

コマンド引数

●ブロック長　　～〈符号なし整数〉((セクタ長×n－8))

作成する物理ファイルのブロック長を指定します。

入力ファイルに対してもこの指定が有効になります。

●ブロック数　　～〈符号なし整数〉((1～2147483647))

作成する物理ファイルのブロック数を指定します。なお，ブロック数が非常に多い場合，DAMが共用メモリ内で管理しているキャッシュブロックのチェインが大き過ぎる可能性があります。この場合，性能に影響することがあります。多くのブロック数を持つDAMファイルを作成する場合は，DAMサービス定義のdamchlmt定義コマンドを使用してキャッシュブロック数のしきい値を指定してください。

●物理ファイル名　　～〈パス名〉

OpenTP1ファイルシステム上に作成する物理ファイルの名称を，完全パス名で指定します。

DAMサービス定義の定義コマンドdamfileの物理ファイル名に指定した名称と同じ名称を指定してください。

●入力ファイル名　　～〈パス名〉

データを入力するファイルの名称を指定します。

このコマンド引数の指定を省略すると，物理ファイルの割り当てだけ行われます。

注意事項

damloadコマンド実行時にエラーが発生した場合，物理ファイルが割り当て状態となりますので，damloadコマンドを再び実行する前に，damdelコマンドで物理ファイルを削除してください。

damloadコマンドで指定したブロック数と入力ファイルのブロック数が異なる場合，次のようになります。

指定したブロック数＞入力ファイルのブロック数の場合：

物理ファイルの最後までNULLデータのブロックを出力します。

指定したブロック数＜入力ファイルのブロック数の場合：

入力ファイルからのブロック入力を中止して，KFCA02599-Wメッセージを出力後，damloadコマンドを正常終了します。

damloadコマンドに指定するブロック長の最大値は，32760です。

DAMファイルはOpenTP1ファイルシステム上に作成されます。したがって，次の計算式を満たすブロック長，ブロック数をdamloadコマンドに指定してください。
OpenTP1ファイルシステム容量　＞　((ブロック長＋8)×(ブロック数+ 1))

damls

名称

論理ファイルの状態表示

形式

damls 〔-i〕〔論理ファイル名〕

機能

論理ファイルの状態を標準出力に出力します。

オプション

●-i

現在オンラインで使用中の論理ファイルの総数と，追加できる論理ファイル数を表示します。

このオプションの指定を省略すると，論理ファイルの総数と追加できる論理ファイル数は表示されません。

コマンド引数

●論理ファイル名　　～〈1～8文字の識別子〉

論理ファイルの名称を指定します。

このコマンド引数の指定を省略すると，DAMサービスが管理しているすべての論理ファイルの状態が表示されます。

出力形式

論理ファイル名を指定しないと，DAMサービスが管理している論理ファイルすべてについて，繰り返し出力されます。

-iオプション指定時に出力されます。

aa...aa：論理ファイル名（8文字以内）

bb...bb：物理ファイル名（63文字以内）

cc...cc：ブロック長

dd...dd：ブロック数

ee...ee：DAMファイルの閉塞状態

Not shutdown…未閉塞

Logical shutdown…論理閉塞

Error shutdown…障害閉塞

Under shutdown request…閉塞要求中

ff...ff：DAMファイルの属性

Quick write…即書き

Deferred write…ディファード

No recovery…回復対象外

Cache less…回復対象外およびキャッシュレスアクセス

g：セキュリティの有無

Y…セキュリティあり

N…セキュリティなし

hh...hh：日時（17文字）
年/月/日△時:分:秒（年は西暦の下2けた）

ii...ii：論理ファイルの総数

jj...jj：追加できる論理ファイルの数

出力メッセージ

メッセージID | 内容 | 出力先
KFCA01650-E | コマンド引数の指定が誤っています | 標準エラー出力
KFCA01651-E | 論理ファイル名が8文字を超えています | 標準エラー出力
KFCA01662-E | メモリ不足です | 標準エラー出力
KFCA01667-E | バージョンが不一致です | 標準エラー出力
KFCA01670-E | 該当する論理ファイルがありません | 標準エラー出力
KFCA01678-I | ヘルプメッセージ | 標準出力
KFCA01679-E | DAMサービスが起動されていません | 標準エラー出力
KFCA01680-E | DAMサービスのアドレス情報を検索できません | 標準エラー出力
KFCA01681-E | 通信障害が発生しました | 標準エラー出力
KFCA01682-E | ネットワーク障害が発生しました | 標準エラー出力
KFCA01683-E | タイムオーバです | 標準エラー出力
KFCA01684-E | DAMサービスが終了処理中です | 標準エラー出力
KFCA01696-E | 定義解析中にエラーが発生しました | 標準エラー出力

damrles

名称

論理ファイルの閉塞解除

形式

damrles 〔-o〕 論理ファイル名

機能

指定した論理ファイルの閉塞状態を解除します。

オプション

●-o

障害閉塞した論理ファイルの閉塞状態を解除します。

このオプションの指定を省略すると，damholdコマンドで論理閉塞した論理ファイルの閉塞状態が解除されます。

コマンド引数

●論理ファイル名　　～〈1～8文字の識別子〉

閉塞状態を解除する論理ファイルの名称を指定します。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA01650-E | コマンド引数の指定が誤っています | 標準エラー出力
KFCA01651-E | 論理ファイル名が8文字を超えています | 標準エラー出力
KFCA01662-E | メモリ不足です | 標準エラー出力
KFCA01667-E | バージョンが不一致です | 標準エラー出力
KFCA01670-E | 該当する論理ファイルがありません | 標準エラー出力
KFCA01675-I | ヘルプメッセージ | 標準出力
KFCA01676-E | 論理ファイルは障害閉塞されていません | 標準エラー出力
KFCA01677-E | 論理ファイルは論理閉塞されていません | 標準エラー出力
KFCA01679-E | DAMサービスが起動されていません | 標準エラー出力
KFCA01680-E | DAMサービスのアドレス情報を検索できません | 標準エラー出力
KFCA01681-E | 通信障害が発生しました | 標準エラー出力
KFCA01682-E | ネットワーク障害が発生しました | 標準エラー出力
KFCA01683-E | タイムオーバです | 標準エラー出力
KFCA01684-E | DAMサービスが終了処理中です | 標準エラー出力
KFCA01696-E | 定義解析中にエラーが発生しました | 標準エラー出力

damrm

名称

論理ファイルの切り離し

形式

damrm 論理ファイル名

機能

指定した論理ファイルをクローズしたあと，オンラインから切り離します。切り離すためには，該当する論理ファイルをあらかじめ論理閉塞しておく必要があります。

障害閉塞ファイルもオンラインから切り離すことができます。

コマンド引数

●論理ファイル名　　～〈1～8文字の識別子〉

オンラインから切り離す論理ファイルの名称を指定します。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA01650-E | コマンド引数の指定が誤っています | 標準エラー出力
KFCA01651-E | 論理ファイル名が8文字を超えています | 標準エラー出力
KFCA01662-E | メモリ不足です | 標準エラー出力
KFCA01667-E | バージョンが不一致です | 標準エラー出力
KFCA01668-I | ヘルプメッセージ | 標準出力
KFCA01669-E | 論理ファイルは閉塞されていません | 標準エラー出力
KFCA01670-E | 該当する論理ファイルがありません | 標準エラー出力
KFCA01679-E | DAMサービスが起動されていません | 標準エラー出力
KFCA01680-E | DAMサービスのアドレス情報を検索できません | 標準エラー出力
KFCA01681-E | 通信障害が発生しました | 標準エラー出力
KFCA01682-E | ネットワーク障害が発生しました | 標準エラー出力
KFCA01683-E | タイムオーバです | 標準エラー出力
KFCA01684-E | DAMサービスが終了処理中です | 標準エラー出力
KFCA01696-E | 定義解析中にエラーが発生しました | 標準エラー出力
KFCA01697-E | 他者が使用中のため，削除できません | 標準エラー出力
KFCA01698-E | レコード・ロック・セグメントが不足しています | 標準エラー出力
KFCA02573-E | トランザクション実行中のため削除できません | 標準エラー出力

注意事項

オンラインでオープン中（使用中）のDAMファイルは，damrmコマンドでオンラインから切り離すことはできません。オンラインから切り離すには，該当する論理ファイルをオープンしているすべてのサービスで，論理ファイルをクローズする必要があります。ただし，該当する論理ファイルにアクセスしたトランザクションが完了していない場合は，該当する論理ファイルをクローズしていても削除処理は実行できません。この場合，KFCA02573-Eメッセージを出力して処理を中断します。このため，DAMファイルにアクセスするトランザクションが多数あるときにdamrmコマンドを実行する場合は注意してください。

damrstr

名称

物理ファイルのリストア

形式

damrstr 〔-c 一括処理ブロック数〕
〔-e リストア先物理ファイルブロック長｜
 -p リストア先物理ファイルブロック長〕
｛バックアップファイル名 物理ファイル名｜-s 物理ファイル名｝

機能

dambkupコマンドでバックアップしたファイル，または標準入力から，データを物理ファイルにリストアします。

オプション

●-c　一括処理ブロック数　　～〈符号なし整数〉((1～2147483647))《10》

一度に入出力するブロック数を指定します。

バックアップ元物理ファイルのブロック数を超える値を指定した場合は，バックアップ元物理ファイルのブロック数が一度に入出力するブロック数となります。

●-e　リストア先物理ファイルブロック長　　～〈符号なし整数〉((セクタ長×n-8))

リストア先物理ファイルのブロック長をバイト単位で指定します。指定できる最大値は32760です。バックアップ元物理ファイルのブロック長と同じか，それよりも大きい値を設定してください。このオプションを指定した場合，リストア先物理ファイルとバックアップ元物理ファイルのブロック構成は変わりません。リストア先DAMファイルの各ブロックの拡張された部分はNULL文字で埋められます。このオプションおよび-pオプションを省略した場合，バックアップ元物理ファイルと同じ大きさのブロック長でリストアします。

●-p　リストア先物理ファイルブロック長　　～〈符号なし整数〉((セクタ長×n-8))

リストア先物理ファイルのブロック長をバイト単位で指定します。指定できる最大値は32760です。バックアップ元物理ファイルのブロック長と同じか，それよりも大きい値を設定してください。このオプションを指定した場合，バックアップ元物理ファイルのデータをリストア先物理ファイルの先頭ブロックから詰めて格納するため，リストア先物理ファイルではバックアップ元物理ファイルのブロック構成は維持されません。このオプションおよび-eオプションを省略した場合，バックアップ元物理ファイルと同じ大きさのブロック長でリストアします。

●-s

リストア元が標準入力の場合に指定します。

コマンド引数

●ファイル名　　～〈パス名〉

リストア元のファイルの名称を指定します。

-sオプションを指定した場合は，このコマンド引数は指定できません。

●物理ファイル名　　～〈パス名〉

リストア先DAMファイルの物理ファイル名を完全パス名で指定します。

注意事項

メッセージKFCA02587-Eが，要因：CREATE（物理ファイル割り当て処理），理由コード：-1514で出力された場合，次の対策をしてください。

リストア先物理ファイルブロック長を指定していない場合
damrstrコマンドを実行した環境では，指定されたバックアップファイルのブロック長はサポートできません。リストア先物理ファイルブロック長（-eまたは-p）を指定して再度damrstrコマンドを実行してください。

リストア先物理ファイルブロック長を指定している場合
damrstrコマンドを実行した環境では，リストア先物理ファイルブロック長（-eまたは-p）に指定した物理ファイルブロック長はサポートできません。物理ファイルブロック長は，（リストア先ファイルシステムのセクタ長×n－8）で求められる値を指定してください。なお，指定するリストア先物理ファイルブロック長は，バックアップ元物理ファイルのブロック長と同じかそれよりも大きい値にしてください。

バックアップ元物理ファイルより小さいブロック長の既存の物理ファイルにはリストアできません。

-eオプションを指定した場合，バックアップ元物理ファイルよりブロック数の少ない既存の物理ファイルにはリストアできません。

-pオプションを指定した場合，リストアでユーザデータが入るブロック数が，リストア先の既存の物理ファイルのブロック数よりも多くなる場合はリストアできません。

-pオプションを指定する場合，リストア先物理ファイルに必要なブロック数は次の式で求められます（小数点切り上げ）。
バックアップ元物理ファイルのブロック長×バックアップ元物理ファイルのブロック数／リストア先物理ファイルのブロック長

dambkupコマンドでオンラインバックアップした物理ファイルデータを，-eまたは-pオプションを指定してリストアすることはできません。

damfrcコマンドに指定する回復対象定義ファイルに，ブロック長を拡張したDAMファイルを指定することはできません。

damrstrコマンドに指定するブロック長の最大値は32760です。

-eまたは-pオプションにバックアップ元物理ファイルよりも大きいブロック長を指定した場合，この物理ファイルをアクセスしているDAMアクセス関数の引数に指定した入出力領域の大きさを見直してください。

物理ファイル名に指定した物理ファイルが未割り当ての場合，物理ファイルのアクセス権は0644（所有者による読み込み権と書き込み権，グループによる読み込み権，および他者による読み込み権）となります。

dcalzprf

名称

性能検証用トレース情報解析

形式

dcalzprf 〔-H ヘッダオプション〔,ヘッダオプション〕〕
〔-L 付加情報オプション〔,付加情報オプション〕〕
〔-x 表示するプロセス数〕
〔-d 起点時刻〕
〔-C 時刻差計算開始イベントID〔,時刻差計算開始イベントID〕...
 -F 時刻差計算終了イベントID〔,時刻差計算終了イベントID〕...〕
〔-o ファイル出力先ディレクトリ〕
〔-T 〔開始時刻〕〔,終了時刻〕〕
〔-r ランID〔,ランID〕...〕
〔-n ノードID〔,ノードID〕...〕
〔-g サービスグループ名〔,サービスグループ名〕...〕
〔-s サービス名〔,サービス名〕...〕
〔-p プロセスID〔,プロセスID〕...〕
〔-v サーバ名〔,サーバ名〕...〕
〔-e イベントID〔,イベントID〕...｜-S｜-U〕
〔-c 通信番号〔,通信番号〕...〕
〔-G グローバルトランザクションID〔,グローバルトランザクションID〕...〕
〔-f 送信元ノード〔,送信元ノード〕...〕
〔-t 送信先ノード〔,送信先ノード〕...〕
〔-R ルート通信番号〔,ルート通信番号〕...〕
〔-E〕
〔トレースデータファイル名〔 トレースデータファイル名〕...〕

機能

標準入力，または指定されたトレースデータファイルから，性能検証用トレース（prfトレース）情報を入力し，トレース情報を編集出力します。編集結果は，時間とプロセスの関連を表の形式で示したcsv形式でファイル出力します。

このコマンドの使用は，TP1/Extension 1をインストールしていることが前提です。

このコマンドのメインオプション一覧を次に示します。

表13-1　dcalzprfコマンドのメインオプション一覧

オプション | 機能 | 複数指定
-H | 編集結果ファイルのヘッダを変更 | ○
-L | 編集結果にレコード固有の付加情報を追加 | ○
-x | 一つのファイルに編集出力するプロセスのカラム数を指定 | ×
-d | 指定した起点時刻から各トレース情報までの時刻差を出力 | ×
-C | 指定したイベントIDのトレース情報と-Fオプションの引数に指定されたイベントIDのトレース情報の時刻差を出力 | ○
-F | 指定したイベントIDのトレース情報と-Cオプションの引数に指定されたイベントIDのトレース情報の時刻差を出力 | ○
-o | 編集結果ファイルの出力先ディレクトリを指定 | ×

（凡例）

○：コンマ区切りで複数の値を指定できます。

×：複数の値の指定はできません。

このコマンドのサブオプション一覧を次に示します。サブオプションによって，編集出力対象とするトレース情報を選択できます。サブオプションを活用することで，出力ファイルサイズを小さくすることができます。

表13-2　dcalzprfコマンドのサブオプション一覧

オプション | 機能 | 複数指定
-T | 指定された時刻内に取得されたトレース情報だけを編集出力 | ×
-r | 指定されたランIDを持つのトレース情報だけを編集出力 | ○
-n | 指定されたノードIDを持つのトレース情報だけを編集出力 | ○
-g | 指定されたサービスグループ名を持つトレース情報だけを編集出力 | ○
-s | 指定されたサービス名を持つのトレース情報だけを編集出力 | ○
-p | 指定されたプロセスIDの持つのトレース情報だけを編集出力 | ○
-v | 指定されたサーバ名を持つトレース情報だけを編集出力 | ○
-e | 指定されたイベントIDを持つトレース情報だけを編集出力 | ○
-S | OpenTP1のシステムが出力しているトレース情報だけを編集出力 | ×
-U | ユーザが出力しているトレース情報だけを編集出力 | ×
-c | 指定されたクライアント通信番号を持つトレース情だけを編集出力 | ○
-G | 指定されたグローバルトランザクションIDを持つトレース情報だけを編集出力 | ○
-f | 指定された送信元ノードIDを持つトレース情報だけを編集出力 | ○
-t | 指定された送信先ノードIDを持つトレース情報だけを編集出力 | ○
-R | 指定されたルート通信番号を持つトレース情報だけを編集出力 | ○
-E | 処理がエラーリターンしていることを記録したトレース情報だけを編集出力 | ×

（凡例）

○：コンマ区切りで複数の値を指定できます。

×：複数の値の指定はできません。

オプションで説明するイベントIDについては，「付録L.1　性能検証用トレースの取得情報」を参照してください。

オプション

●-H　pid｜name｜pid,name

編集結果ファイルのヘッダを変更します。

トレース情報にサーバ名が含まれていない場合，サーバ名を「****」と表示します。

このオプションの指定を省略すると，通番表示となります。

pid

編集結果ファイル内でプロセスごとに割り当てた通番を，プロセスID表示に変更します。

name

編集結果ファイル内でプロセスごとに割り当てた通番を，サーバ名表示に変更します。

pid,name

編集結果ファイル内でプロセスごとに割り当てた通番を，サーバ名（プロセスID）表示に変更します。

●-L　MCF｜MQ｜MCF,MQ

編集結果に，レコード固有の付加情報を追加します。

MCF

TP1/Message Controlのイベント情報で取得されるMCF固有情報から，論理端末名を切り出して出力します。

MQ

TP1/Message Queueイベント情報で取得されるキュー名，メッセージトークン，メッセージ識別子を出力します。

MCF,MQ

TP1/Message Controlのイベント情報で取得されるMCF固有情報から，論理端末名を切り出して出力します。また，TP1/Message Queueのイベント情報で取得されるキュー名，メッセージトークン，メッセージ識別子を出力します。

●-x　表示するプロセス数　　～〈符号なし整数〉((1～65536))《256》

一つのファイルに編集出力するプロセスのカラム数を指定します。指定を省略すると256が設定されていることを仮定します。

編集対象のprfトレースファイルに，指定した数より多いプロセスが含まれていた場合，複数のファイルに分割して編集出力します。出力ファイル数の計算式を次に示します。

↑P／-x指定値↑

（凡例）

↑↑：値を切り上げます

P：出力対象となるプロセス数

小さい値を指定し，上記の計算式の結果が大きくなりすぎた場合，出力ファイル数の上限により，編集結果ファイルが出力されないことがあります。

必要以上に大きな値を指定した場合，使用する表計算ソフトウェアの表示制限を超える形式でファイルを作成することがあり，編集結果を正しく表示できないときがあります。

●-d　起点時刻

指定した起点時刻から，各トレース情報までの時刻差を出力します。

起点時刻は，設定されているタイムゾーンの下限値（グリニッジ標準時の場合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：年（西暦を4けたで指定します（1970≦YYYY））

指定を省略できます。※

注※

「年」の指定を省略した場合は，当年の指定月日時刻と見なされます。「年，月，日」の指定を省略した場合，当年当月当日の指定時刻と見なされます。「月，日」，「月」，または「日」だけを省略することはできません。省略した場合はオプションエラーになります。「月」または「日」を省略したい場合は，「年」，「月」，「日」のすべてを省略してください。

起点時刻に0を指定した場合（"-d 0"）は，出力結果ファイルの先頭に出現したトレース情報の取得時刻を起点時刻として，各トレース情報までの時刻差を計算します。

●-C　時刻差算出開始イベントID　　～〈6けたの16進数（先頭の0xを含む）〉

このオプションに指定したイベントIDのトレース情報と，-Fオプションの引数に指定されたイベントIDのトレース情報の時刻差を出力します。-FオプションのイベントIDと重複しないように，セットで指定してください。

時刻差を計算できるのは，一つのプロセスが出力しているトレース情報に出現しているイベントの間ごとになります。二つ以上のプロセス間で出力しているイベントごとの時刻差は計算できません。

複数のイベントIDを指定する場合，イベントIDとイベントIDとの間をコンマ（，）で区切ります。複数イベントIDを指定した場合，該当のイベントIDがトレースから見つかるたびに，時刻差計算の始点を上書きしていきます。

●-F　時刻差算出終了イベントID　　～〈6けたの16進数（先頭の0xを含む）〉

このオプションに指定したイベントIDのトレース情報と，-Cオプションの引数に指定されたイベントIDのトレース情報の時刻差を出力します。-CオプションのイベントIDと重複しないように，セットで指定してください。

時刻差を計算できるのは，一つのプロセスが出力しているトレース情報に出現しているイベントの間ごとになります。二つ以上のプロセス間で出力しているイベントごとの時刻差は計算できません。

複数のイベントIDを指定する場合，イベントIDとイベントIDとの間をコンマ（，）で区切ります。

●-o　ファイル出力先ディレクトリ　　～〈パス名〉

prfトレースの編集結果ファイルを出力するディレクトリを指定します。

指定を省略した場合は，カレントディレクトリに編集結果ファイルを出力します。

●-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：年（西暦を4けたで指定します（1970≦YYYY））

指定を省略できます。※

注※

開始時刻，または終了時刻の「年」の指定を省略した場合は，当年の指定月日時刻と見なされます。「年，月，日」の指定を省略した場合，当年当月当日の指定時刻と見なされます。「月，日」，「月」，または「日」だけを省略することはできません。省略した場合はオプションエラーになります。「月」または「日」を省略したい場合は，「年」，「月」，「日」のすべてを省略してください。

●-r　ランID　　～〈3～10けたの16進数（先頭の0xを含む）〉

指定されたランIDを持つトレース情報だけを編集出力します。

●-n　ノードID　　～〈4文字の識別子〉

指定されたノードIDを持つトレース情報だけを編集出力します。

●-g　サービスグループ名　　～〈1～31文字の識別子〉

指定されたサービスグループ名を持つトレース情報だけを編集出力します。

●-s　サービス名　　～〈1～31文字の識別子〉

指定されたサービス名を持つトレース情報だけを編集出力します。

●-p　プロセスID　　～〈符号なし整数〉

指定されたプロセスIDのトレース情報だけを編集出力します。

●-v　サーバ名　　～〈1～8文字の識別子〉

指定されたサーバ名を持つトレース情報だけを編集出力します。

●-e　イベントID　　～〈6けたの16進数（先頭の0xを含む）〉

指定されたイベントIDを持つトレース情報だけを編集出力します。

●-S

OpenTP1のシステムが出力しているトレース情報だけを編集出力します。

●-U

ユーザが出力しているトレース情報だけを編集出力します。

●-c　通信番号　　～〈10けたの16進数（先頭の0xを含む）〉

指定されたクライアント通信番号を持つトレース情報だけを編集出力します。

●-G　グローバルトランザクションID　　～〈128文字以内の英数字〉

指定されたグローバルトランザクションIDを持つトレース情報だけを編集出力します。

●-f　送信元ノード　　～〈4文字の識別子〉

指定された送信元ノードIDを持つトレース情報だけを編集出力します。

●-t　送信先ノード　　～〈4文字の識別子〉

指定された送信先ノードIDを持つトレース情報だけを編集出力します。

●-R　ルート通信番号　　～〈10けたの16進数（先頭の0xを含む）〉

指定されたルート通信番号を持つトレース情報だけを編集出力します。

●-E

処理がエラーリターンしていることを記録したトレース情報だけを出力します。

コマンド引数

●トレースデータファイル名　　～＜パス名＞

性能検証用トレースファイルを指定します。トレースデータファイル名の指定がない場合，標準入力からデータを入力します。また，複数のファイルを指定した場合は，取得時刻順に並べ替えて出力することができます。

出力形式

dcalzprfコマンドでは，編集したトレース情報を編集結果ファイルに出力します。

編集結果ファイル名は「prfdataX.csv」です。Xの範囲は，0から次に示す値までです。出力先ディレクトリに，編集結果ファイル名（prfdataX.csv）と同名のファイルがある場合は，内容を上書きします。

-xオプション指定時：
↑P÷-xオプションの指定値↑－1

-xオプション省略時：
↑P÷256↑－1

（凡例）

↑↑：値を切り上げます。

P：出力対象となるプロセス数

「-C,-F」「-d」「-H pid,name」「-L MCF,MQ」の各オプションを指定したときの性能検証用トレースファイルの出力形式を次に示します。

図13-1　性能検証用トレースファイルの出力形式

（凡例）

1，2，および3：1行で表示します。

性能検証用トレースファイルの出力形式を，表計算ソフトで表示したときの例を次に示します。

図13-2　性能検証用トレースファイルの出力形式（表計算ソフトで表示）

性能検証用トレースファイルの出力条件とヘッダの詳細を次に示します。

表13-3　性能検証用トレースファイルの出力条件とヘッダの詳細

出力条件
ヘッダ
内容

共通
Date
aaaa：トレースを取得した時刻（年）

bb：トレースを取得した時刻（月）

cc：トレースを取得した時刻（日）

共通
Time
dd：トレースを取得した時刻（時）

ee：トレースを取得した時刻（分）

ff：トレースを取得した時刻（秒）

共通
under-Sec
gggggg：トレースを取得した時刻（マイクロ秒で6けた）

共通
Node-id
hhhh：ノードID（4文字）

-C，-Fオプション指定時
Diff
ii...ii：-C，-Fオプションに指定されたイベントID間の時刻差（マイクロ秒で16けた以内）（-Fに設定したイベントIDの行に出力されます）

-dオプション指定時
Total
jj...jj：-dオプションに指定した起点時刻から各トレース情報の時刻差（マイクロ秒で16けた以内）（起点時刻を省略した場合は編集出力ファイルごとの先頭トレース情報が起点時刻になります）

-Hオプション省略時
1,2,...,256※1
kk...kk：イベントID（詳細については「付録L.1　性能検証用トレースの取得情報」を参照）

-H pid指定時
ll...ll※2

-H name指定時
nn...nn※2，※3

-H pid,name指定時
nn...nn(ll...ll)※2，※3

共通
pid
ll...ll：プロセスID（10進10けた以内）

共通
Trace
mm...mm：該当プロセスでのトレース通番（10進5けた以内）

共通
Server-name
nn...nn：イベントの発生したサーバ名（8文字以内）

共通
rc
oo...oo：リターンコード（10進11けた以内（先頭の符号を含む））

共通
clt
pppp：クライアントOpenTP1識別子（4文字）
qqqqqqqqqq：クライアント通信番号（16進10けた（先頭の0xを含む））

共通
server
rrrr：サーバOpenTP1識別子（4文字）

共通
root
ssss：ルートOpenTP1識別子（4文字）
tttttttttt：ルート通信番号（16進10けた（先頭の0xを含む））

共通
svg
uu...uu：サービスグループ名（32文字以内）

共通
svc
vv...vv：サービス名（32文字以内）

共通
trn
ww...ww：グローバルトランザクションID（128文字以内）
xxxxxxxxxxxxxxxx：ブランチID（16文字）

共通
XA
xx...xx：イベント種別（75文字以内）※4

共通
JNL
yy：ジャーナル種別（2文字）※5

-L MQ指定時
Que-name
zz...zz：TP1/Message Queueを利用した際のキュー名（48文字以内）※6

Msg-Token
AA...AA：TP1/Message Queueを利用した際のメッセージトークン（16進18けた（先頭の0xを含む））※6

Msg-ID
BB...BB：TP1/Message Queueを利用した際のメッセージ識別子
（16進66けた（先頭の0xを含む））※6

-L MCF指定時
MCFData1
CC...CC：TP1/Message Controlを利用した際の論理端末名（8文字以内）※7

MCFData2
DD...DD：TP1/Message Controlを利用した際のUOC，API名，ジャーナル種別などの情報（8文字以内）※7

共通
Bin
EE...EE：詳細情報の16進数字列（8文字ごとの△（半角スペース）を含む，575文字以内）※8

共通
Ascii
"FF...FF"：詳細情報のアスキー文字列（256文字以内）※8

注

トレースで取得されていない項目は「**...**」で表示されます。

注※1

コマンドに指定した性能検証用トレースファイルに含まれていたプロセスに振られた通番です。デフォルトでは一つの出力結果ファイルで1～256が出力されます。-xオプションで1ファイル当たりの上限値を変更できます。

注※2

デフォルトでは一つの出力結果ファイルで256個のカラムが出力され，-xオプションで1ファイル当たりのカラム数を変更できます。トレースファイル上のプロセス数がカラム数未満の場合は，カラム数に満たない残りのヘッダおよび内容が空となります。

注※3

トレース情報にサーバ名が含まれていない場合，サーバ名を「****」と表示します。

注※4

trn_prf_event_trace_conditionオペランドにxafuncを指定した場合は，XA関数名が出力されます。

trn_prf_event_trace_conditionオペランドにtrnserviceを指定した場合は，次に示すイベント種別が出力されます。

表13-4　trn_prf_event_trace_conditionオペランドにtrnserviceを指定した場合の出力イベント種別

イベント | タイミング | イベント種別
トランザクション管理サービス | 開始中 | trnd starting
開始完了 | trnd started
終了中 | trnd ending
終了完了 | trnd ended
トランザクション回復サービス | 開始中 | trnrvd starting
開始完了 | trnrvd started
回復開始 | trnrvd recovery started
回復終了 | trnrvd recovery ended
終了中 | trnrvd ending
終了完了 | trnrvd ended
リソースマネジャ監視サービス | 開始中 | trnrmd starting
開始完了 | trnrmd started
終了中 | trnrmd ending
終了完了 | trnrmd ended

※5

イベントIDが0xc001の場合だけ出力します。1文字目はジャーナル種別の1文字目（例：CJの場合は'C'），2文字目は保守情報を示します。

※6

イベントIDが0xdで始まるものだけ出力します。それ以外は「**...**」で出力します。

※7

イベントIDが0xaで始まるものだけ出力します。それ以外は「**...**」で出力します。

※8

システムまたはユーザによる固有データが含まれないレコードでは出力されません。

dcalzprfコマンドでは編集出力ファイルとは別に，編集出力ファイルごとに割り振られたプロセスの通番と，実際のプロセスの情報の関連一覧を，標準出力に表示します。

形式は次のとおりです。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA01861-E | コマンドでエラーが発生しました | 標準エラー出力
KFCA01882-E | コマンドの引数に誤りがあります | 標準エラー出力
KFCA33303-E | ファイルのオープンに失敗しました | 標準エラー出力
KFCA33304-E | ファイルのアクセス中に障害が発生しました | 標準エラー出力
KFCA33305-E | ファイルの書き込みに失敗しました | 標準エラー出力
KFCA33307-I | ヘルプメッセージ | 標準出力
KFCA33308-W | 条件に合致するトレースデータがありません | 標準エラー出力

注意事項

このコマンドの使用は，TP1/Extension 1をインストールしていることが前提です。TP1/Extension 1をインストールしていない場合の動作は保証できません。

dcalzprfコマンドはprfトレースの編集出力処理にCPUなどのリソースを多く消費します。オンライン中に編集出力を実行した場合，編集対象に指定したprfトレースのファイル容量によっては，オンラインに影響を与えるおそれがあります。dcalzprfコマンドは原則としてオンライン中には実行しないでください。

次に示すトレースは，プロセス内で同一のトレース番号を使用します。このため，これらのトレースだけをコマンドで編集すると，「出力形式」に出力される該当プロセスでのトレース通番（mm...mm）は連番とならないことがあります。

性能検証用トレース

XAR性能検証用トレース

JNL性能検証用トレース

LCK性能検証用トレース

MCF性能検証用トレース

TRNイベントトレース

NAMイベントトレース

プロセスサービスイベントトレース

FILイベントトレース

トレース情報の詳細については，マニュアル「OpenTP1 解説」を参照してください。

性能検証用トレースの利用方法については，「付録L.3　性能検証用トレース情報の解析例」を参照してください。

出力されたcsvファイルを表計算ソフトで表示させると，DiffやTotalが大きい値の場合，指数表記で表示されたり，けた落ちが発生することがあります。ただし，DiffやTotalの値は，-Cオプションまたは-Fオプションに指定するイベントIDや，-dオプションに指定する起点時刻の絞り込みによって，値が大きくなることを抑止できます。

始点（-Cオプション）および終点（-Fオプション）を複数指定することで，始点-始点-終点-終点…のようなデータの並びになる場合や，途中のトレースが抜けている場合は，正しく時刻差（Diff）が計算できないことがあります。詳細については，「付録L.3(4)　dcalzprfコマンドでの性能検証用トレース解析」を参照してください。

編集結果ファイルを出力中に障害が発生し，コマンドが処理を中断，または異常終了した場合は，編集途中の編集結果ファイルが残ります。このときファイルのヘッダには，"Date"～"Node-id"だけが書かれた状態となります。

異なるサーバ名のプロセスに，同一のプロセスIDが割り当たった場合，標準出力や，-Hオプションを指定して出力されるヘッダのサーバ名には，最初に動作したサーバ名が出力されます。

dcauditsetup

名称

監査ログ機能の環境設定

形式

dcauditsetup OpenTP1ディレクトリ

機能

監査ログ機能を使用するために必要な環境を設定します。

ログサービス定義の監査ログに関連するオペランド（log_audit_xxxxオペランド）を変更する場合は，OpenTP1を停止し，定義を変更したあとにこのコマンドを実行してください。また，システム環境定義（env）のDCCONFPATHオペランドを変更した場合，変更後のDCCONFPATHに格納されたログサービス定義の設定を有効にする必要があります。この場合もこのコマンドを実行してください。

ログサービス定義のlog_audit_outオペランドを指定していない場合，またはlog_audit_outオペランドにNを指定している場合は，監査ログ機能は無効です。

このコマンドは，「引数で指定したOpenTP1ディレクトリ/conf/env」ファイルの環境変数DCCONFPATHを参照して，監査ログ機能を使用するための環境設定を行います。envが存在しない場合，または環境変数DCCONFPATHを定義していない場合，「OpenTP1ディレクトリ/conf」をDCCONFPATHの環境変数値として環境設定を行います。

このコマンドを実行したときに作成されるディレクトリおよびファイル名を次の表に示します。事前にディレクトリを準備する場合は，次の表に示す権限になるように作成してください。

表13-5　dcauditsetupコマンドの実行時に作成されるファイルとディレクトリ

ファイルおよびディレクトリ | ユーザID | グループID | アクセス権 | 内容
$DCDIR/auditlog※ | OpenTP1管理者のユーザID | OpenTP1管理者のグループID | 0777 | 監査ログファイルを格納するディレクトリ
$DCDIR/auditlog/audit.log※ | OpenTP1管理者のユーザID | OpenTP1管理者のグループID | 0666 | 監査ログファイル

注※

ログサービス定義のlog_audit_pathオペランドの指定を省略した場合のディレクトリです。log_audit_pathオペランドを指定した場合，指定したディレクトリが作成され，作成されたディレクトリ下にファイルが作成されます。

ログサービス定義の詳細については，マニュアル「OpenTP1 システム定義」を参照してください。

このコマンドの実行時に，監査ログの出力先ディレクトリおよび監査ログファイルがすでに存在する場合，次の表に示す実行結果になります。

表13-6　監査ログの出力先ディレクトリがすでに存在する場合のdcauditsetupコマンドの実行結果

ディレクトリのユーザID | ディレクトリのグループID | ディレクトリのアクセス権 | コマンドの実行結果
OpenTP1管理者のユーザID | OpenTP1管理者のグループID | 0777 | 成功
0777以外 | エラー
OpenTP1管理者のユーザID | 他グループ | 0777 | エラー
0777以外
他ユーザ | OpenTP1管理者のグループID | 0777 | エラー
0777以外
他ユーザ | 他グループ | 0777 | エラー
0777以外

表13-7　監査ログファイルがすでに存在する場合のdcauditsetupコマンドの実行結果

監査ログファイルのユーザID | 監査ログファイルのグループID | 監査ログファイルのアクセス権 | コマンドの実行結果
OpenTP1管理者のユーザID | OpenTP1管理者のグループID | 0666 | 成功
0666以外 | エラー
OpenTP1管理者のユーザID | 他グループ | 0666 | 成功
0666以外 | エラー
他ユーザ | OpenTP1管理者のグループID | 0666 | 成功
0666以外 | エラー
他ユーザ | 他グループ | 0666 | 成功
0666以外 | エラー

コマンド引数

●OpenTP1ディレクトリ　　～〈パス名〉

OpenTP1ディレクトリを50文字以内で指定します。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA33500-I | ヘルプメッセージ | 標準エラー出力
KFCA33501-E | コマンド実行中にエラーが発生しました | 標準エラー出力
KFCA33502-I | ログサービス定義を解析しました | 標準出力
KFCA33503-I | 監査ログ機能を有効・無効にしました | 標準出力

注意事項

このコマンドは，スーパユーザだけが実行できます。

dccspool

名称

トラブルシュート情報の削除

形式

dccspool 〔-i〕 〔-d 日数〕 〔-k ｛dump｜all｝〕

機能

$DCDIR/spoolディレクトリ下に作成されたトラブルシュート情報を削除します。

オプション

●-i

このオプションを指定すると，トラブルシュート情報が格納された各ファイルを削除するかどうかの確認が標準出力に出力されます。確認に対し，yを入力すると，該当ファイルが削除されます。

このオプションを省略した場合は，標準出力に確認が出力されないで，該当ファイルが削除されます。削除したファイルのファイル名称が標準出力に出力されます。

●-d　日数　　～〈符号なし整数〉((0～24855))《1》

dccspoolコマンドを実行した時刻から計算して，「このオプションで指定した値×24時間」前の時点以前に作成されたファイルを削除対象にします。例えば，日数に10を指定した場合，コマンドを実行した時刻の240時間前の時点以前に作成されたファイルが削除対象になります。

このオプションを省略した場合は，コマンドを実行した時刻の24時間前の時点以前に作成されたファイルが削除対象になります。

0を指定した場合は，作成時間に関係なくすべてのファイルが削除対象になります。

●-k　dump｜all　　～《dump》

このオプションでは削除対象のファイルを指定します。

dump

次のファイルが削除対象になります。

$DCDIR/spool/save下のファイル

$DCDIR/spool下の共用メモリダンプファイル

all

次のファイルが削除対象になります。

$DCDIR/spool/save下のファイル

$DCDIR/spool下の共用メモリダンプファイル

$DCDIR/spool/dclckinf下のデッドロック情報ファイルおよびタイムアウト情報ファイル

$DCDIR/spool/dctrninf下の未決着トランザクション情報ファイル

$DCDIR/spool/dcrapinf下の不正メッセージ情報ファイル

削除対象ファイルの一覧を次の表に示します。

表13-8　dccspoolコマンドで削除対象になるファイルの一覧

ファイルパス
ファイルの内容
-kオプションの指定

dump
all

$DCDIR/spool/save下のファイル
コアファイル，UAPトレース，OpenTP1デバッグ情報など
○
○

$DCDIR/spool/ファイル名※1
共用メモリダンプファイル。
OpenTP1が共用メモリに保持するデータ
○
○

$DCDIR/spool/dclckinf/ファイル名※2
デッドロック，タイムアウト情報ファイル。
資源の待ち合わせ状態の情報
×
○

$DCDIR/spool/dctrninf/ファイル名※3
未決着トランザクション情報ファイル。
未決着トランザクションの情報
×
○

$DCDIR/spool/dcrapinf/rapリスナー名.msg
$DCDIR/spool/dcrapinf/rapクライアント名.msg
不正メッセージ情報ファイル。
不正メッセージの情報
×
○

（凡例）

○：削除されます。

×：削除されません。

注※1

shmdump，shmdump[1～3]，shmdump[1～3].Z，shmdump.XXX，shmdump.XXX.Z，shmdump.XXX[1～3]，shmdump.XXX[1～3].Z（XXXはリソースマネジャ識別子dam，tam，ist，またはismが入ります）のすべてを削除対象とします。また，適用OSがLinuxの場合，拡張子が'.Z'ではなく，'.gz'になります。

注※2

ファイル名はデッドロック検知日時を基に決定されます。ファイル名の長さは日付が1けたか2けたかによって異なります。

注※3

ファイル名は「rl＋トランザクションサービスの開始時間（一意の8けたの16進数）」になります。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA01861-E | コマンド処理中にエラーが発生しました | 標準エラー出力

注意事項

プロセスサービス定義のprc_coresave_pathオペランドを設定し，コアファイルの退避を行っている場合，このコマンドでは退避先に退避されたコアファイルの削除は行いません。

usmdumpコマンドを実行して，$DCDIR/spool/save以外の任意のディレクトリに作成した共用メモリダンプファイルは，このコマンドでは削除されません。

dcdefchk

名称

システム定義のチェック

形式

dcdefchk 〔-r〕 〔-l〕 〔-c〕 〔-w〕 〔-e〕

機能

定義格納ディレクトリ（$DCCONFPATHおよび$DCUAPCONFPATH）下のシステム定義ファイル（ドメイン定義ファイルを含む）に指定した値をチェックします。チェックする項目と処理の流れについては，「1.3.1　システム定義の作成と確認」を参照してください。

なお，定義チェックを行った結果，次に示すメッセージ区分を持ったメッセージが出力されます。ただし，出力される一部のメッセージについては，次の区分を持たない場合もあります。

メッセージ区分

ERROR：OpenTP1の起動および停止ができない状態，または動作不完全となる問題を検出した場合に出力されます。

WARNG：推奨しない値が指定されていることを検出した場合に出力されます。

CHECK：オペランド値の妥当性について確認を促す場合に出力されます。

オプション

●-r

システム定義ファイルの構文チェックで誤りを検出した場合，コマンド処理を続行するかどうかを確認するメッセージ（KFCA00254-R）を出力します。

●-l

システム定義ファイルの定義チェックを実行します。

このオプションを指定してコマンドを実行する場合，事前にこのオプションを指定しないでコマンドを実行することをお勧めします。このときエラーメッセージ（メッセージの種類がE）が出力された場合は，そのエラーの対策を実施してください。対策を実施しないまま，このオプションを指定してコマンドを実行すると，エラーメッセージが複数回出力されることがあります。

●-c

システム定義ファイルの定義チェックで問題を検出した場合，メッセージ区分がCHECKに該当するメッセージは出力しません。

●-w

システム定義ファイルの定義チェックで問題を検出した場合，メッセージ区分がWARNGに該当するメッセージは出力しません。

●-e

システム定義ファイルの定義チェックで問題を検出した場合，メッセージ区分がERRORに該当するメッセージは出力しません。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA00200-E | 指定できないオプションを指定しています | 標準エラー出力
KFCA00253-I | 定義チェックコマンドを開始します | 標準出力
KFCA00254-R | 定義指定値にエラーがあります | 標準出力
KFCA00255-E | コマンド実行中にエラーが発生しました | 標準エラー出力
KFCA00256-I | ヘルプメッセージ | 標準出力
KFCA00257-E | 定義ファイル名と同じディレクトリがあります | 標準エラー出力
KFCA00258-I | システムサービス定義としてset形式オペランドの構文チェックを行いました | 標準出力
KFCA00283-W | 定義チェック中にエラーが発生しました | 標準エラー出力
KFCA00284-W | 定義チェック中に軽度エラーが発生しました | 標準エラー出力
KFCA00285-W | 必須定義オペランドが指定されていません | 標準エラー出力
KFCA00286-W | 必須定義ファイルがありません | 標準エラー出力

注

上記メッセージのほかに，KFCA00215-Eメッセージ～KFCA00223-Eメッセージ，KFCA00240-Eメッセージ～KFCA00252-Eメッセージ，KFCA00259-Wメッセージ～KFCA00282-Wメッセージ，およびマニュアル「OpenTP1 システム定義」の定義チェックの詳細で示しているメッセージを出力します。

注意事項

dcdefchkコマンドは，OpenTP1の動作中でも実行できます。その場合，確認するシステム定義の指定値は動作中のOpenTP1で有効な値ではなく，コマンド実行時にシステム定義に指定した値です。例えば，プロセスサービス定義に指定したprcsvpathの値をprcpathコマンドで変更しても，チェック対象の値はプロセスサービス定義に指定した値となります。

コマンドを実行する環境に設定した環境変数$DCDIRをOpenTP1ディレクトリとして使用します。そのため，dcstartコマンドを実行する環境に設定したOpenTP1ディレクトリパス名と異なる値を設定している場合，正しく定義チェックできません。

$DCCONFPATH，および$DCUAPCONFPATHに指定したディレクトリパスが50バイト以上の場合，構文チェックでエラーを検出したときに出力するメッセージ（KFCA00242-E）に出力される定義ファイル名が途中までしか出力されません。チェック対象の定義ファイルを50バイト以下のディレクトリパス名で示されるディレクトリにコピーし，$DCDIR/conf/envにputenv形式で指定する環境変数DCCONFPATHにコピー先ディレクトリを指定してdcdefchkコマンドを実行してください。

定義チェック対象としないファイルを定義格納ディレクトリに格納しないでください。システム定義格納ディレクトリ（$DCCONFPATHおよび$DCUAPCONFPATH）下にシステム定義ファイル，ユーザサービス定義ファイル，およびユーザサービスデフォルト定義ファイル以外のファイルがあると正しく定義チェックできません。ただし，ドメイン定義ファイル格納ディレクトリ，およびドメイン定義ファイルは除きます。

システム定義格納ディレクトリ（$DCCONFPATH，および$DCUAPCONFPATH）下にあるシステムサービス定義ファイル以外のファイルで，ファイル名が「.」や「_」で始まるファイル，およびファイル名が9バイト以上のファイルについては，チェックの対象外になります。

定義チェックの対象とする定義は，マニュアル「OpenTP1 システム定義」に記載している定義だけです。

OpenTP1ファイルの作成コマンド（jnlinitコマンドなど）を同時に実行しないでください。

構文チェックで定義の指定値に問題を検出した場合，論理チェックでは，該当する定義にデフォルト値が指定されていると解釈してチェック処理を進めます。

ファイルやディレクトリのアクセス権限チェックでは，dcdefchkコマンドを実行したユーザのUID/GIDに従ったアクセス権限をチェックします。

待機状態など，OpenTP1ファイルシステムにアクセスできない状態の場合，論理チェック時にメッセージを出力することがあります。

dcdefchkコマンドの定義チェック時に出力する一部のメッセージには，dcdefchkコマンド専用のメッセージ区分を持たないメッセージがあります。そのため，dcdefchkコマンドに-eオプションを指定しても，メッセージの種類がEであるメッセージを出力することがあります。

環境変数（putenv形式およびdcputenv形式の定義）は，正しく論理チェックできないことがあります。

dcjchconf

名称

システム定義のオペランドの指定

形式

dcjchconf 〔-f ファイル名〕 〔-n〕 オペランド名 オペランドの値

機能

システム定義ファイル，および運用スクリプトファイルのオペランドに値を設定します。

dcjchconfコマンドを使用してオペランドの値を設定するには，指定するファイルに，次のようにオペランド名を「@」で囲んで記述しておく必要があります。

node_idの値を設定する場合

set node_id = @DCNODE_ID@

dcjchconfコマンドを実行すると，「@」で囲んだオペランド名は，dcjchconfコマンドで指定したオペランドの値に変換されます。

オプション

●-f　ファイル名　　～〈パス名〉

オペランドの値を設定するファイルまたはディレクトリのパスを指定します。

ディレクトリを指定した場合は，指定したディレクトリ下のすべてのファイルが設定対象になります。

このオプションを省略した場合は，$DCCONFPATH下のすべてのファイルが設定の対象になります。

●-n

オペランドの値を設定したあと，改行をしません。

このオプションを省略した場合，オペランドの値を設定したあとの1行の長さが80バイトを超えるときは，80バイト目に継続符号'¥'を挿入して改行します。

改行させたくない場合は，-nオプションを指定してください。

コマンド引数

●オペランド名　　～〈1～4096文字の文字列〉

オペランド名には，先頭にDCを付けた文字列を指定します。

●オペランドの値　　～〈1～4096文字の文字列〉

オペランドに設定する値を指定します。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA01815-E | OSでエラーが発生しました | 標準エラー出力
KFCA01860-E | dcjchconfコマンドの入力形式が正しくありません | 標準エラー出力
KFCA01861-E | dcjchconfコマンドの処理に失敗しました | 標準エラー出力

注意事項

dcjchconfコマンドは，-fオプションで指定したファイルの格納されているディレクトリ下（または-fオプションで指定したディレクトリ下）に.dcjchconfという名称のディレクトリを作成し，設定前のファイルをバックアップ用に退避します。オペランドの設定に失敗した場合は，.dcjchconfディレクトリのバックアップファイルから回復してください。

dcjchconfコマンドは，-fオプションで指定したファイルの格納されているディレクトリ下（または-fオプションで指定したディレクトリ下）に.dcjchconf.tmpという名称のテンポラリファイルを作成します。コマンドが実行途中で失敗した場合は，テンポラリファイルが残ることがあります。

指定したオペランド名が設定の対象となるファイルにない場合も，dcjchconfコマンドは正常終了します。

使用例

$DCCONFPATH/betranrcファイルの「node_id」に「smpl」を設定する場合

dcjchconf -f $DCCONFPATH/betranrc DCNODE_ID smpl

dcjchconfコマンド実行前の$DCCONFPATH/betranrc

set node_id = @DCNODE_ID@

dcjchconfコマンド実行後の$DCCONFPATH/betranrc

set node_id = smpl

$DCCONFPATH/betranrcファイルの「all_node」に「hostA」および「hostB」を指定する場合で，指定するオペランドの値に引用符（"）が含まれるとき

dcjchconf -f $DCCONFPATH/betranrc DCALL_NODE '"hostA","hostB"'

dcjchconfコマンド実行前の$DCCONFPATH/betranrc

set all_node = @DCALL_NODE@

dcjchconfコマンド実行後の$DCCONFPATH/betranrc

set all_node = "hostA","hostB"

指定するオペランドの値に引用符（"）を使用する場合は，アポストロフィ（'）で囲みます。また，指定するオペランドの値に空白を含める場合は，引用符（"）またはアポストロフィ（'）で囲みます。
ご使用のOSがWindowsの場合，指定するオペランドの値に引用符（"）を使用する場合は，引用符（"）を「¥"」と記述します。また，指定するオペランドの値に空白を含める場合は，引用符（"）で囲みます。

dcjcmdex

名称

シナリオテンプレートからのOpenTP1コマンドの実行

形式

dcjcmdex OpenTP1コマンド名 〔コマンド引数名〔△コマンド引数名〕…〕

機能

JP1/AJS2 - Scenario Operationで定義されたシナリオテンプレートから，指定したOpenTP1コマンドを実行します。また，環境変数PATHに"$DCDIR/bin"をいちばん前に追加します（環境変数は実行したコマンドでだけ有効となります）。

実行したOpenTP1コマンドが正常終了した場合は0を，異常終了した場合は8を，リターン値として返します。

コマンド引数

●OpenTP1コマンド名

JP1/AJS2 - Scenario Operationで定義されたシナリオテンプレートから実行するOpenTP1コマンド名を指定します。

●コマンド引数名

OpenTP1コマンド名に指定するOpenTP1コマンドのオプション，およびコマンド引数を指定します。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA01815-E | OSでエラーが発生しました | 標準エラー出力
KFCA01860-E | dcjcmdexコマンドの入力形式が正しくありません | 標準エラー出力
KFCA01886-E | OpenTP1コマンドの処理に失敗しました | 標準エラー出力

注意事項

OpenTP1コマンド名にdcsetupコマンドを指定しないでください。指定すると，dcjcmdexコマンドが正しく動作しないことがあります。

使用例

dcsvstartコマンドで「basespp」という名称のユーザサーバを開始させる場合

dcjcmdex dcsvstart -u basespp

dcjchconfコマンドで，システム定義ファイルの「all_node」に「hostA」および「hostB」を指定する場合で，パラメタに引用符（"）が含まれるとき

dcjcmdex dcjchconf DCALL_NODE '"hostA","hostB"'

指定するオペランドの値に引用符（"）を使用する場合は，アポストロフィ（'）で囲みます。
ご使用のOSがWindowsの場合，指定するオペランドの値に引用符（"）を使用する場合は，引用符（"）を「¥"」と記述します。

dcjnamch

名称

ドメイン定義ファイルの更新

形式

dcjnamch 〔-e〕 〔-f ドメイン定義ファイル名〕 ノード名 〔ポート番号〕

機能

ドメイン定義ファイルに新しいノードを追加します。

dcjnamchコマンドでドメイン定義ファイルを更新したあと，namchgflコマンドを実行すると，オンライン中にシステム共通定義の指定値を変えることなくドメイン構成を変更できます。dcjnamchコマンドは，システム共通定義のname_domain_file_useオペランドにYを指定した場合にだけ使用できます。

オプション

●-e

システム共通定義のall_node_exオペランドで指定するドメイン定義ファイルに，新しいノードを追加します。

このオプションを省略した場合は，システム共通定義のall_nodeオペランドで指定するドメイン定義ファイルに，新しいノードを追加します。

●-f　ドメイン定義ファイル名　　～〈ファイル名〉

ノードを追加するドメイン定義ファイル名を指定します。

$DCCONFPATH/dcnamndディレクトリ下に格納されているドメイン定義ファイルを指定してください。指定したファイルがない場合，新規に作成されます。

-fオプションを省略した場合は，$DCCONFPATH/dcnamnd/dcj_allndファイルを作成して，指定したノードを追加します。

-fオプション，および-eオプションを両方とも指定した場合は，$DCCONFPATH/dcnamndexディレクトリ下のドメイン定義ファイルを使用します。

-fオプションを省略して-eオプションを指定した場合は，$DCCONFPATH/dcnamndex/dcj_allndexファイルを作成して，指定したノードを追加します。

コマンド引数

●ノード名　　～〈1～255文字の識別子〉

OpenTP1システムに追加するノード名を指定します。

/etc/hostsに定義したホスト名またはIPアドレスがノード名になります。

●ポート番号　　～〈符号なし整数〉((5001～65535))

ネームサーバがウェルノウンポート番号として使用するポート番号を指定します。ポート番号を省略した場合は，システム共通定義のname_portオペランドに指定したネームサービスのポート番号が仮定されます。name_portオペランドを指定していない場合は，10000が仮定されます。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA01815-E | OSでエラーが発生しました | 標準エラー出力
KFCA01860-E | dcjnamchコマンドの入力形式が正しくありません | 標準エラー出力
KFCA01861-E | dcjnamchコマンドの処理に失敗しました | 標準エラー出力
KFCA01870-E | メモリ不足が発生しました | 標準エラー出力

注意事項

ドメイン定義ファイルは，$DCCONFPATH/dcnamndディレクトリ下に作成されます。ただし，-eオプションを指定した場合は，システム共通定義のall_node_exオペランドで指定するドメイン定義ファイルが$DCCONFPATH/dcnamndexディレクトリ下に作成されます。定義ファイルを直接変更する場合は，「3.10.1　ドメイン構成の変更」を参照してください。

dcmakeup

名称

OpenTP1の内部制御用資源の確保と解放

形式

dcmakeup 〔-d〕 OpenTP1ディレクトリ

機能

OpenTP1が内部制御用に使用するOSの資源を確保，または解放します。

確保した資源は，OpenTP1ディレクトリ下に格納します。確保する資源の数は，OpenTP1ディレクトリ下のシステム定義情報から解析します。

プロセスサービス定義のprc_process_countオペランドの値を変更した場合は，dcsetupコマンドを実行したあと，dcstartコマンドを実行する前に，必ずdcmakeupコマンドを実行してください。

dcmakeupコマンドを実行しなかった場合，OpenTP1の開始処理でこのコマンドの処理が実行されますが，十分な数の資源を確保するのに時間が掛かることがあります。

いったん確保した資源はOpenTP1で再利用するため，解放する必要はありません。

すでに資源を確保したあとでdcmakeupコマンドを実行しても，正常リターンし，新たに資源を確保することはありません。

すでに資源を確保したあとにシステム定義を変更した場合，再びdcmakeupコマンドを実行するか，またはOpenTP1を開始すると，システム定義の指定値が増加しているものについて，増加した分に対応する資源だけを新たに確保します。システム定義の指定値が減少しているものについて減少した分の資源を解放することは行いません。

オプション

●-d

OpenTP1の内部制御用資源を解放します。

このオプションの指定を省略すると，OpenTP1が内部制御用に使用するOSの資源が確保され，指定したOpenTP1ディレクトリ下に格納されます。

コマンド引数

●OpenTP1ディレクトリ　　～〈パス名〉

確保する資源を格納するOpenTP1ディレクトリを指定します。

マルチOpenTP1の場合は，OpenTP1ごとに指定します。

dcmapchg

名称

マップファイルのパス名変更

形式

dcmapchg ｛｛-mM｜-mP｜-aM｜-aP｜-m｜-a｝ マッピングサービス識別子 パス名｝

機能

物理マップファイル，PAGECモジュールの読み込みパス名，またはマップファイルの標準読み込みパス名を変更します。

dcmapchgコマンドは，TP1/NET/XMAP3プロトコル，またはTP1/NET/HNA-560/20プロトコル使用時に使用できます。

オプション

●-mM

標準用物理マップ読み込みパス名を変更するときに指定します(TP1/NET/XMAP3)。

●-mP

標準用PAGECモジュール読み込みパス名を変更するときに指定します(TP1/NET/XMAP3)。

●-aM

交代用物理マップ読み込みパス名を変更するときに指定します(TP1/NET/XMAP3)。

●-aP

交代用PAGECモジュール読み込みパス名を変更するときに指定します(TP1/NET/XMAP3)。

●-m

マッピングサービス定義ファイルのMAPPATHで指定した，標準用物理読み込みパス名を変更します(TP1/NET/HNA-560/20)。

●-a

マッピングサービス定義ファイルのALTPATHで指定した，交代用物理マップ読み込みパス名を変更します(TP1/NET/HNA-560/20)。

コマンド引数

●マッピングサービス識別子　　～〈1～8文字の識別子〉

マッピングサービス定義で指定したマッピングサービス識別子を指定します。

●パス名　　～〈1～255文字のパス名〉

変更後のパス名を指定します。

使用例

標準用物理マップ読み込みパスを/tmpに変更する場合

dcmapchg -mM mapserv1  /tmp

交代用PAGECモジュール読み込みパス名を/tmpに変更する場合

dcmapchg -aP mapserv1  /tmp

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10865-I | ヘルプメッセージ | 標準出力
KFCA10870-E | オプションモード〈％s〉の指定に誤りがあります | 標準出力
KFCA10871-E | マッピングサービス識別子〈％s〉の指定に誤りがあります | 標準出力
KFCA10872-E | dcmapchgコマンド入力に誤りがあります | 標準出力
KFCA10873-E | ソケットインタフェース〈％s〉に異常が発生しました | 標準出力
KFCA10874-E | エラーコードは〈％s〉です | 標準出力
KFCA10875-E | マッピングサービスプロセスとの通信に異常を検知しました | 標準出力
KFCA10876-E | パス名の変更が失敗しました | 標準出力
KFCA10877-E | 〈％s〉はマッピングサービス定義ファイルにありません | 標準出力
KFCA10878-I | パス名を変更しました | 標準出力
KFCA10879-E | マッピングサービスは起動されていません | 標準出力
KFCA10880-E | パス名〈％s〉の指定に誤りがあります | 標準出力
KFCA10886-E | コマンド処理中にエラーが発生しました | 標準出力

dcmapls

名称

マップファイルのロード済み資源の表示

形式

dcmapls ｛｛-s｜-d｜-p｝マッピングサービス識別子｝

機能

マップファイルのロード済みの物理マップ，またはPAGECモジュールを標準出力に表示します。

dcmaplsコマンドは，TP1/NET/XMAP3プロトコル，またはTP1/NET/HNA-560/20プロトコル使用時に使用できます。

オプション

●-s

標準形式で表示する場合に指定します。

●-d

詳細形式で表示する場合に指定します。

●-p

読み込みパス名だけ表示する場合に指定します。

コマンド引数

●マッピングサービス識別子　　～〈1～8文字の英数字〉

マッピングサービス属性定義で指定したマッピングサービス識別子を指定します。

使用例

マッピングサービス識別子mapserv1のロード済み資源情報を標準形式で表示する場合

dcmapls -s mapserv1

マッピングサービス識別子mapserv1のロード済み資源情報を詳細形式で表示する場合

dcmapls -d mapserv1

出力形式

●-sオプションを指定した場合

KFCA10888-I    MPSの状態表示を開始します。
KFCA10890-I    ii...ii MAPNAME pp...pp
KFCA10891-I    mm...mm
KFCA10890-I    ii...ii MAPPATH pp...pp
KFCA10891-I    mm...mm  
KFCA10890-I    ii...ii ALTPATH pp...pp
KFCA10891-I    mm...mm
KFCA10890-I    ii...ii PGCMNAME pp...pp
KFCA10891-I    mm...mm
KFCA10890-I    ii...ii PGCSTDPN pp...pp
KFCA10891-I    mm...mm
KFCA10890-I    ii...ii PGCALTPN pp...pp
KFCA10891-I    mm...mm
KFCA10889-I    MPSの状態表示を終了します。

マッピングサービス属性定義でパス名を省略した場合は，KFCA10888-IメッセージとKFCA10890-Iメッセージだけが出力されます。

また，標準用物理マップ読み込みパスの表示（MAPPATH），交代用物理マップ読み込みパスの表示（ALTPATH）で，マップ名称が8個以上ある場合は，KFCA10891-Iメッセージが続いて出力されます。

MPS：マッピングサービス

MAPNAME：常駐する物理マップの読み込みパス

MAPPATH：標準用物理マップ読み込みパス

ALTPATH：交代用物理マップ読み込みパス

PGCMNAME：常駐するPAGECモジュールの読み込みパス

PGCSTDPN：標準用PAGECモジュールの読み込みパス

PGCALTPN：交代用PAGECモジュールの読み込みパス

ii...ii：マッピングサービス識別子

pp...pp：パス名

mm...mm：物理マップ名，またはPAGECモジュール名

●-dオプションを指定した場合

KFCA10888-I    MPSの状態表示を開始します。
KFCA10890-I    ii...ii MAPNAME pp...pp
KFCA10892-I    mm...mm ss...ss hh...hh ll...ll oo...oo       1
KFCA10892-I    mm...mm ss...ss hh...hh ll...ll oo...oo       1
KFCA10890-I    ii...ii MAPPATH pp...pp
KFCA10892-I    mm...mm ss...ss hh...hh ll...ll oo...oo       2
KFCA10892-I    mm...mm ss...ss hh...hh ll...ll oo...oo       2
KFCA10892-I    mm...mm ss...ss hh...hh ll...ll oo...oo       2
KFCA10890-I    ii...ii ALTPATH pp...pp
KFCA10892-I    mm...mm ss...ss hh...hh ll...ll oo...oo       2
KFCA10890-I    ii...ii PGCMNAME pp...pp
KFCA10892-I    mm...mm ss...ss hh...hh ll...ll oo...oo       1
KFCA10890-I    ii...ii PGCSTDPN pp...pp
KFCA10892-I    mm...mm ss...ss hh...hh ll...ll oo...oo       2
KFCA10892-I    mm...mm ss...ss hh...hh ll...ll oo...oo       2
KFCA10890-I    ii...ii PGCALTPN pp....pp
KFCA10892-I    mm...mm ss...ss hh...hh ll...ll oo...oo       2
KFCA10889-I    MPSの状態表示を終了します。

常駐指定した物理マップ，またはPAGECモジュールでもマッピングサービス開始時に入出力エラーなどで常駐化ができなかったものは表示されません。

LRU管理されている物理マップ，またはPAGECモジュールは，その時点で最も新しく使用された物理マップ，PAGECモジュールから順に表示されます。

マッピングサービス属性定義でパス名を省略した場合は，KFCA10888-IメッセージとKFCA10889-Iメッセージだけが出力されます。

MPS：マッピングサービス

MAPNAME：常駐する物理マップの読み込みパス

MAPPATH：標準用物理マップ読み込みパス

ALTPATH：交代用物理マップ読み込みパス

PGCMNAME：常駐するPAGECモジュールの読み込みパス

PGCSTDPN：標準用PAGECモジュールの読み込みパス

PGCALTPN：交代用PAGECモジュールの読み込みパス

ii...ii：マッピングサービス識別子

pp...pp：パス名

mm...mm：物理マップ名，またはPAGECモジュール名

ss...ss：物理マップサイズ，またはPAGECモジュールサイズ（10進形式）

hh...hh：保守情報1（16進形式）

ll...ll：保守情報2（16進形式）

oo...oo：保守情報3（16進形式）

●-pオプションを指定した場合

KFCA10888-I    MPSの状態表示を開始します。
KFCA10890-I    ii...ii MAPNAME pp...pp
KFCA10890-I    ii...ii MAPPATH pp...pp
KFCA10890-I    ii...ii ALTPATH pp...pp
KFCA10890-I    ii...ii PGCMNAME pp...pp
KFCA10890-I    ii...ii PGCSTDPN pp...pp
KFCA10890-I    ii...ii PGCALTPN pp...pp
KFCA10889-I    MPSの状態表示を終了します。

マッピングサービス属性定義でパス名を省略した場合は，KFCA10888-IメッセージとKFCA10890-Iメッセージだけが出力されます。

MPS：マッピングサービス

MAPNAME：常駐する物理マップの読み込みパス

MAPPATH：標準用物理マップ読み込みパス

ALTPATH：交代用物理マップ読み込みパス

PGCMNAME：常駐するPAGECモジュールの読み込みパス

PGCSTDPN：標準用PAGECモジュールの読み込みパス

PGCALTPN：交代用PAGECモジュールの読み込みパス

ii...ii：マッピングサービス識別子

pp...pp：パス名

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10866-I | ヘルプメッセージ | 標準出力
KFCA10870-E | オプションモード＜％s＞の指定に誤りがあります | 標準出力
KFCA10871-E | マッピングサービス識別子＜％s＞の指定に誤りがあります | 標準出力
KFCA10872-E | コマンド入力に誤りがあります | 標準出力
KFCA10875-E | マッピングサービスプロセスとの通信に異常を検知しました | 標準出力
KFCA10877-E | マッピングサービス識別子＜％s＞はマッピングサービス定義ファイルに定義されていません | 標準出力
KFCA10879-E | マッピングサービスが起動されていません | 標準出力
KFCA10881-E | マップ名称一覧表示に失敗しました | 標準出力
KFCA10886-E | コマンド処理中にエラーが発生しました | 標準出力
KFCA10888-I | 情報の表示を開始します | 標準出力
KFCA10889-I | 情報の表示を終了します | 標準出力
KFCA10890-I | 情報（マップ識別子，パス種別，パス名）を表示します | 標準出力
KFCA10891-I | 情報（マップ名，PAGECモジュール名）を表示します | 標準出力
KFCA10892-I | 情報（名称，サイズ，保守情報）を表示します | 標準出力

dcmstart

名称

マルチノードエリア，サブエリアの開始

形式

dcmstart 〔-n〕 〔-p〕 〔-t 開始確認時間〕
        ｛-g マルチノードサブエリア識別子｜-w ノード識別子
        〔,ノード識別子〕…｝

機能

次に示すOpenTP1ノードを，同時に正常開始，または再開始します。

コマンド入力環境の環境変数DCDIRに対応したOpenTP1ノードが属するマルチノードエリアを構成するすべてのOpenTP1ノード

指定したマルチノードサブエリアを構成するすべてのOpenTP1ノード

-wオプションで指定したOpenTP1ノード

dcmstartコマンド実行時の各OpenTP1ノードの状態によって，そのOpenTP1ノードに対する処理は異なります。

dcmstartコマンドは，指定された範囲のOpenTP1ノードがすべて開始処理を完了したことを確認するか，または開始できないことを確認するまで，OpenTP1ノードを監視します。また，約30秒ごとに，開始処理中のOpenTP1ノードを報告（メッセージを出力）します。

ただし，dcmstartコマンドを入力してから一定時間（マルチノード構成定義のdcmstart_watch_timeオペランドに指定した値）を経過しても，開始処理の完了，または開始できないことを確認できなかった場合は，メッセージを出力し，残りのOpenTP1ノードの監視を打ち切ります。監視を打ち切られたOpenTP1ノードでは，開始処理が続行されます。ただし，そのOpenTP1ノードの開始処理は滞っている可能性があります。この場合，該当するOpenTP1ノードが開始しない要因を調査し，対策してください。

dcmstartコマンドでOpenTP1ノードが開始できないことを確認できない状態とは，次のような状態を検知したときです。

OpenTP1ノードに開始指示を出したが，OpenTP1ノードの状態が開始確認時間の間，停止中(TERM)のまま変化しない状態。
典型的な例として次のような場合があります。

OpenTP1ノードの開始指示は伝わっているが，初期化処理に時間が掛かりOpenTP1の状態が開始中にならない。

開始要求したOpenTP1ノードでは何らかの要因でOpenTP1ノードの開始コマンドが起動できない。

系切り替え機能を使用しているOpenTP1ノードは，実行系，および待機系に対して開始処理を実行します。そのため，両方のOpenTP1に関するメッセージが出力されます。

オプション

●-n

前回の終了モードに関係なく，各OpenTP1ノードを強制的に正常開始します。

このオプションの指定を省略すると，各OpenTP1ノードの前回の終了状態から開始モードが決定されます。

　前回の終了モードが正常終了の場合…正常開始

　前回の終了モードが正常終了以外の場合…再開始

●-p

OpenTP1ノードに開始指示をした時点で，コマンドがリターンします。

各OpenTP1ノードの開始処理の結果は確認しません。

●-t　開始確認時間　　～((0～65535))

OpenTP1ノードの開始確認時間を秒単位で指定します。

開始確認は5秒ごとに行われるため，指定した時間よりも長い時間待つ場合があります。このオプションを省略した場合は，20が仮定されます。1～19を指定した場合も，20が仮定されます。0を指定した場合は，OpenTP1ノードの開始完了を確認するまでノードの監視を続けます。

このオプションの指定値よりもマルチノード構成定義のdcmstart_watch_timeオペランドの指定値の方が短い場合，dcmstart_watch_timeオペランドの指定値が優先されます。

●-g　マルチノードサブエリア識別子　　～〈1～8文字の識別子〉

開始するマルチノードサブエリア識別子を一つ指定します。サブエリア名に*を指定すると，マルチノードエリアを指定したと見なされます。*は，シェルに展開されないように，¥や ' 'でエスケープしてください。

マルチノード構成定義の定義コマンドdcmareaに指定された，マルチノードエリア，またはマルチノードサブエリアを構成するすべてのOpenTP1ノードを正常開始，または再開始します。

●-w　ノード識別子　　～〈4文字の識別子〉

指定したOpenTP1ノードを開始します。

複数のノード識別子を指定するときは，ノード識別子とノード識別子との間をコンマ（，）で区切ります。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA01860-E | dcmstartコマンドの入力形式が正しくありません | 標準エラー出力
KFCA04603-I | OpenTP1ノードは開始処理を始めました | 標準出力
KFCA04604-I | OpenTP1ノードはオンライン状態になりました | 標準出力
KFCA04605-W | OpenTP1ノードは起動できません | 標準出力
KFCA04606-W | OpenTP1ノードの開始を確認できませんでした | 標準出力
KFCA04613-E | dcmstartコマンドの引数が正しくありません | 標準エラー出力
KFCA04615-E | 定義ファイルにエラーがあります | 標準エラー出力
KFCA04616-E | マルチノード構成定義にエラーがあります | 標準エラー出力
KFCA04617-E | コマンドの指定はマルチノード構成定義の指定と不整合です | 標準エラー出力
KFCA04619-W | OpenTP1ノードは開始処理の監視時間を超えました | 標準出力
KFCA04620-I | OpenTP1ノードは開始中です | 標準出力
KFCA04621-E | マルチノード機能実行時にエラーが発生しました | 標準エラー出力
KFCA04625-I | OpenTP1ノードは待機状態になりました | 標準出力

注意事項

dcmstartコマンドで各OpenTP1ノードを開始する処理では，問い合わせ応答のメッセージ出力を抑止します。

個々のOpenTP1ノードは，dcstartコマンドを使用して単独に開始できます。ただし，dcmstartコマンドとdcstartコマンドは，同時に実行しないでください。同時に実行するとdcmstartコマンドのメッセージが不正になることがあります。

開始処理指示送信先OpenTP1ノードからの応答が，マルチノード構成定義で指定した最大応答待ち時間を超えた場合は，タイムアウトが発生した旨のメッセージを出力し，該当するOpenTP1ノードに対する処理は打ち切られます。

系切り替えが発生しているときに，dcmstartコマンドを実行した場合の動作は保証できません。

同じOpenTP1ノードに対して，同時にdcmstartコマンドを実行しないでください。同時に実行すると，dcmstartコマンドのメッセージが不正になることがあります。

一つのOpenTP1ノードが，二つ以上のマルチノードサブエリアに重複して属している場合，-gオプションでどのマルチノードサブエリア識別子を指定しても，開始処理が実行されます。

マルチノード物理定義からホスト名を取得できなかったノードの場合，メッセージのホスト名部分に'********'が表示されます。

dcmstop

名称

マルチノードエリア，サブエリアの終了

形式

dcmstop〔｛-a｜-b｜-f｝〕〔-p〕｛-g マルチノードサブエリア識別子｜
                                -w ノード識別子 〔,ノード識別子〕…｝

機能

次に示すOpenTP1ノードを同時に終了します。

コマンド入力環境の環境変数DCDIRに対応したOpenTP1ノードが属するマルチノードエリアを構成するすべてのOpenTP1ノード

指定したマルチノードサブエリアを構成するすべてのOpenTP1ノード

-wオプションで指定したOpenTP1ノード

dcmstopコマンド入力時の各OpenTP1ノードの状態によって，そのOpenTP1ノードに対する処理は異なります。

dcmstopコマンドは，指定された範囲のOpenTP1ノードがすべて終了したことを確認するか，または終了できないことを確認するまで，OpenTP1ノードを監視します。また，約30秒ごとに，終了処理中のOpenTP1ノードを報告（メッセージを出力）します。

ただし，dcmstopコマンドを入力してから一定時間（マルチノード構成定義のdcmstop_watch_timeオペランドに指定した値）を経過しても，終了処理の完了，または終了できないことを確認できなかった場合は，メッセージを出力し，残りのOpenTP1ノードの監視を打ち切ります。監視を打ち切られたOpenTP1ノードでは，終了処理が続行されます。ただし，そのOpenTP1ノードの終了処理は滞っている可能性があります。この場合，該当するOpenTP1ノードが終了しない要因を調査し，対策してください。

系切り替え機能を使用しているOpenTP1ノードは，実行系，および待機系に対して終了処理を実行します。そのため，両方のOpenTP1に関するメッセージが出力されます。

オプション

●-a

マルチノードエリア，またはマルチノードサブエリアに属する各OpenTP1ノードを計画停止Aで終了します。

●-b

マルチノードエリア，またはマルチノードサブエリアに属する各OpenTP1ノードを計画停止Bで終了します。

●-f

マルチノードエリア，またはマルチノードサブエリアに属する各OpenTP1ノードを強制停止します。

-a，-b，および-fオプションは同時に指定できません。

-a，-b，および-fオプションの指定をすべて省略した場合，マルチノードエリア，またはマルチノードサブエリアに属する各OpenTP1ノードは正常終了されます。

●-p

OpenTP1ノードに開始指示をした時点で，コマンドがリターンします。

各OpenTP1ノードの終了処理の結果は確認しません。

●-g　マルチノードサブエリア識別子　　～〈1～8文字の識別子〉

終了するマルチノードサブエリア識別子を一つ指定します。サブエリア名に*を指定すると，マルチノードエリアを指定したと見なされます。*は，シェルに展開されないように，¥や ' 'でエスケープしてください。

マルチノード構成定義の定義コマンドdcmareaに指定された，マルチノードエリア，またはマルチノードサブエリアを構成するすべてのOpenTP1ノードを終了します。

●-w　ノード識別子　　～〈4文字の識別子〉

指定したOpenTP1ノードを終了します。

複数のノード識別子を指定するときは，ノード識別子とノード識別子との間をコンマ（，）で区切ります。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA01860-E | dcmstopコマンドの入力形式が正しくありません | 標準エラー出力
KFCA04607-I | OpenTP1ノードは終了処理を始めました | 標準出力
KFCA04608-I | OpenTP1ノードは停止しました | 標準出力
KFCA04609-W | OpenTP1ノードは終了できません | 標準出力
KFCA04610-W | OpenTP1ノードの停止を確認できませんでした | 標準出力
KFCA04613-E | dcmstopコマンドの引数が正しくありません | 標準エラー出力
KFCA04614-W | OpenTP1ノードは終了処理の監視時間を超えました | 標準出力
KFCA04615-E | 定義ファイルにエラーがあります | 標準エラー出力
KFCA04616-E | マルチノード構成定義にエラーがあります | 標準エラー出力
KFCA04617-E | コマンドの指定はマルチノード構成定義の指定と不整合です | 標準エラー出力
KFCA04618-I | OpenTP1ノードは終了中です | 標準出力
KFCA04621-E | マルチノード機能実行時にエラーが発生しました | 標準エラー出力
KFCA04626-I | OpenTP1ノードの待機終了処理を始めました | 標準出力

注意事項

個々のOpenTP1ノードは，dcstopコマンドを使用して単独に終了できます。ただし，dcmstopコマンドとdcstopコマンドは同時に実行しないでください。同時に実行するとdcmstopコマンドのメッセージが不正になることがあります。

終了処理指示送信先OpenTP1ノードからの応答が，マルチノード構成定義で指定した最大応答待ち時間を超えた場合は，タイムアウトが発生した旨のメッセージを出力し，該当するOpenTP1ノードに対する処理は打ち切られます。

系切り替えが発生しているときに，dcmstopコマンドを実行した場合の動作は保証できません。

同じOpenTP1ノードに対して，同時にdcmstopコマンドを実行しないでください。同時に実行すると，dcmstopコマンドのメッセージが不正になることがあります。

一つのOpenTP1ノードが，二つ以上のマルチノードサブエリアに重複して属している場合，-gオプションでどのマルチノードサブエリア識別子を指定しても，終了処理が実行されます。

マルチノード物理定義からホスト名を取得できなかったノードの場合，メッセージのホスト名部分に'********'が表示されます。

dcndls

名称

OpenTP1ノードの状態表示

形式

dcndls ｛-g マルチノードサブエリア識別子｜-w ノード識別子
      〔,ノード識別子〕…｝

機能

指定したOpenTP1ノードの状態を標準出力に出力します。

系切り替え機能を使用しているOpenTP1ノードは，実行系，および待機系の状態を出力します。

オプション

●-g　マルチノードサブエリア識別子　　～〈1～8文字の識別子〉

状態を表示するマルチノードサブエリアの識別子を一つ指定します。サブエリア名に*を指定すると，マルチノードエリアを指定したと見なされます。*は，シェルに展開されないように，¥や ' 'でエスケープしてください。

マルチノード構成定義の定義コマンドdcmareaに指定された，マルチノードエリア，またはマルチノードサブエリアを構成するすべてのOpenTP1ノードの状態を表示します。

●-w　ノード識別子　　～〈4文字の識別子〉

指定したOpenTP1ノードの状態を表示します。

複数のノード識別子を指定するときは，ノード識別子とノード識別子との間をコンマ（，）で区切ります。

出力形式

aaaa：OpenTP1ノードのノード識別子（4文字）

bb...bb：OpenTP1ノードの状態（13文字以内）

NOTUP…通信不可
次のどれかの要因が考えられます。
・OpenTP1ノードのdcsetupコマンドが必要な状態
（dcsetupコマンドの未実行状態，またはdcsetupコマンドの再実行が必要な状態）
・マルチノード物理定義エラー
（OpenTP1ノードが未登録，またはホスト名・ポート番号の指定誤り）
・通信障害
（OpenTP1ノードがあるホストの電源が未投入，またはネットワーク障害）

TERM…停止中，または異常終了中

START_NORMAL…正常開始中

START_RECOVER…再開始中

ONLINE…オンライン中

STOP…終了処理中（正常停止）

STOPA…終了処理中（計画停止A）

STOPB…終了処理中（計画停止B）

STANDBY_START…待機系開始中

STANDBY…待機中

STANDBY_STOP…待機系終了処理中

NETDOWN…ネットワーク障害

TIMEOUT…タイムアウト

????…OpenTP1ノード状態の取得失敗

該当するOpenTP1ノードでエラーが発生しているときに表示されます。該当するOpenTP1ノードの定義を見直すか，またはTP1/Multiがインストールされているか確認してください。

cc...cc：マルチノードサブエリア識別子（8文字以内）
どのマルチノードエリアにも属さないノードのマルチノードサブエリア識別子の場合は，'********'が表示されます。
-gオプションで指定されたマルチノードサブエリア識別子に属するOpenTP1ノードが，ほかのマルチノードサブエリアにも重複して属している場合，-gオプションで指定されたマルチノードサブエリア識別子が表示されます。
-w，または-gオプションに'*'で指定されたOpenTP1ノードが，二つ以上のマルチノードサブエリアに重複して属している場合，マルチノード構成定義で最初に指定されたマルチノードサブエリア識別子が表示されます。

dd...dd：ホスト名（64文字以内）
マルチノード物理定義で指定したホスト名が出力されます。
マルチノード物理定義からホスト名を取得できなかったノードの場合は，'********'が表示されます。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA01860-E | dcndlsコマンドの入力形式が正しくありません | 標準エラー出力
KFCA04613-E | dcndlsコマンドの引数が正しくありません | 標準エラー出力
KFCA04615-E | 定義ファイルにエラーがあります | 標準エラー出力
KFCA04616-E | マルチノード構成定義にエラーがあります | 標準エラー出力
KFCA04617-E | コマンドの指定はマルチノード構成定義の指定と不整合です | 標準エラー出力
KFCA04621-E | マルチノード機能実行時にエラーが発生しました | 標準エラー出力

注意事項

系切り替えが発生しているときに，dcndlsコマンドを実行した場合の動作は保証できません。

dcpplist

名称

製品情報の表示

形式

dcpplist

機能

OpenTP1ディレクトリに構築した環境で動作している製品の形名やバージョンなどを表示します。

出力形式

#   Product ID           Version   Product Name
--- -------------------- --------- -----------------------------
aaa bb....bb             cc....cc  dd....dd

aaa：通番（3けた）

bb....bb：製品形名（20文字以内）

cc....cc：バージョン（9文字以内）

dd....dd：製品名（40バイト以内）

出力メッセージ

メッセージID | 内容 | 出力先
KFCA01815-E | OSでエラーが発生しました | 標準エラー出力
KFCA01860-E | 使用方法 | 標準エラー出力
KFCA01861-E | コマンド処理中にエラーが発生しました | 標準エラー出力

注意事項

dcpplistコマンドは日立PPインストーラの情報を使用しています。

dcpplistコマンドを実行すると，日立PPインストーラでインストールした製品の情報がすべて表示されます。したがって，OpenTP1関連製品以外の製品情報も表示されます。

インストールディレクトリをOpenTP1ディレクトリとして使用している場合にdcpplistコマンドを実行すると，現在インストールされている製品の一覧が表示されます。

表示される製品名には，uCosminexusが付与されていない場合があります。

dcrasget

名称

保守資料の取得

形式

dcrasget　〔-c〕 〔-g〕 〔-l〕 取得先ディレクトリ

機能

OpenTP1のトラブルシュートに必要な保守資料を，指定されたディレクトリに取得します。

このコマンドはOpenTP1管理者の権限を持つユーザが，OpenTP1を操作している環境で実行してください。OpenTP1の動作に必要な環境変数を適切に設定しているかどうかを確認してください。

このコマンドを入力すると，保守資料を取得する前に取得対象ディレクトリ※の情報を表示して，処理を続行するかどうかの問い合わせをします。

取得先ディレクトリには，資料を取得するための十分な空き領域が必要になります。このコマンドでは取得対象ディレクトリ※の情報を中心とした資料を取得します。また，取得先ディレクトリは，資料取得のための一時作業領域としても使用します。一時作業領域として，取得対象ディレクトリ※の容量の二倍以上の空き容量が必要になります。このコマンドを実行する前に取得対象ディレクトリ※の容量を確認し，十分な空き容量のあるディレクトリを取得先ディレクトリに指定してください

注※

$DCDIR/spoolディレクトリ，および$DCDIR/tmpディレクトリ（prc_current_work_pathオペランド，およびprc_coresave_pathオペランドを指定している場合は，指定したディレクトリを含む）

このコマンドは，シェルスクリプトなどの実行可能ファイル（$DCCONFPATH/usrrasget）が存在する場合は，コマンド実行時にこのファイルも実行します。dcrasgetコマンドの実行と同期して実行したい処理がある場合は，このファイルを作成してください。

オプション

●-c

保守資料取得先のファイルを，資料取得後に圧縮します。

●-g

保守資料を取得する前に取得対象ディレクトリの情報を表示して処理を続行するかどうかの問い合わせをしないで処理を実行します。

●-l

$DCDIR/spoolなどの容量の大きい情報は取得しないで，コマンド実行結果などによって得られる情報だけを取得します。

コマンド引数

●取得先ディレクトリ ～＜パス名＞

保守資料取得先ディレクトリをフルパスで指定します。

このコマンドはOpenTP1管理者の権限を持つユーザが実行するため，ファイルやディレクトリをコマンド実行者が作成できるように，指定するディレクトリに適切なアクセス権限を設定しておいてください。

指定されたディレクトリに，次に示す名称の資料ファイルが生成されます。

dcrasget.HOSTNAME.mmddHHMMSS.AAA.tar[.BB]

HOSTNAME：標準ホスト名

mmddHHMMSS：月日時分秒

AAA：取得される情報単位

SAV：$DCDIR/spool/save，およびprc_coresave_pathオペランドで指定したディレクトリ下の情報

SPL：$DCDIR/spoolディレクトリ下の情報（saveを除く）

TMP：$DCDIR/tmp，およびprc_current_work_pathオペランドで指定したディレクトリ下の情報

CNF：$DCDIR/confディレクトリなど定義関係の情報

INF：情報ファイルなどの情報

.BB：-cオプションが指定された場合に付加されます。適用OSがLinuxの場合は「.gz」で，その他のOSの場合は「.Z」です。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA01861-E | コマンド処理中にエラーが発生しました | 標準エラー出力
KFCA01897-I | 使用方法 | 標準出力

dcreport

名称

システム統計情報の標準出力へのリアルタイム編集出力

形式

dcreport　〔-l 〔-n〕〕 〔-c〕 〔-r〕 〔開始ID 〔△終了ID〕〕

機能

共用メモリ上に取得したシステム統計情報を，標準出力へリアルタイムに編集出力します。

このコマンドは，システム共通定義でset statistics=Yを指定している場合に使用できます。また，dcstatsコマンドでシステム統計情報のジャーナル出力要求を指定した場合も，ジャーナル出力中は，システム共通定義の指定に関係なくシステム統計情報を出力できます。

なお，出力される統計情報IDについては，表E-1および表E-2のdcreport編集用IDを参照してください。

オプション

●-l

標準出力およびメッセージログにシステム統計情報を出力します。

●-n

標準出力へのシステム統計情報の出力を抑止します。

●-c

標準出力へのシステム統計情報の出力をCSV形式で行います。

なお，-lと-cを同時に指定した場合，メッセージログには通常形式で出力します。

●-r

システム統計情報を出力するとともに，累積値をリセットします。

コマンド引数

●〔開始ID〔△終了ID〕〕　　～〈符号なし整数〉((1～213))

出力する統計情報IDを指定します。統計情報IDについては，表E-1および表E-2のdcreport編集用IDを参照してください。

開始IDだけを指定すると開始ID以上のシステム統計情報を出力します。

終了IDを指定すると，開始IDから終了IDまでのシステム統計情報を出力します。

このオプションを省略するとすべてのシステム統計情報を出力します。

なお，開始ID，終了ID共に指定する場合は，「開始ID≦終了ID」となるように指定してください。

出力形式

●標準出力の場合

___________________________________________________
ID     件数        平均        最大        最小
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
aaa  bbbbbbbbbb  cccccccccc  dddddddddd  eeeeeeeeee

aaa：統計情報ID（10進数3けた）

bbbbbbbbbb：件数（10進数10けた）

cccccccccc：平均（10進数10けた）

dddddddddd：最大値（10進数10けた）

eeeeeeeeee：最小値（10進数10けた）

件数，平均，最大値，最小値のすべてを取得できなかった項目は，件数に0000000000を出力し，平均，最大値，最小値に----------を出力します。

件数だけを取得した項目は，平均，最大値，最小値に----------を出力します。

件数や取得値の累積でオーバフローが発生した場合，件数，平均に**********を出力します。この場合でも，最大値，最小値は出力します。

●-cオプションを指定した場合（標準出力への出力形式（CSV形式））

aaa,bb...bb,cc...cc,dd...dd,ee...ee

aaa：統計情報ID（10進数3けた以内）

bb...bb：件数（10進数10けた以内）

cc...cc：平均（10進数10けた以内）

dd...dd：最大値（10進数10けた以内）

ee...ee：最小値（10進数10けた以内）

件数，平均，最大値，最小値のすべてを取得できなかった項目は，件数に0を出力し，平均，最大値，最小値に-を出力します。

件数だけを取得した項目は，平均，最大値，最小値に-を出力します。

件数や取得値の累積でオーバフローが発生した場合，件数，平均に*を出力します。この場合でも，最大値，最小値は出力します。

●-lオプションを指定した場合（ログファイルへの出力形式）

KFCA01890-I  統計情報：ID=aaa 件数=bb...bb
平均=cc...cc 最大=dd...dd 最小=ee...ee

aaa：統計情報ID（10進数3けた以内）

bb...bb：件数（10進数10けた以内）

cc...cc：平均（10進数10けた以内）

dd...dd：最大値（10進数10けた以内）

ee...ee：最小値（10進数10けた以内）

件数，平均，最大値，最小値のすべてを取得できなかった項目の情報は出力しません。

件数だけを取得した項目は，平均，最大値，最小値に-を出力します。

件数や取得値の累積でオーバフローが発生した場合，件数，平均に*を出力します。この場合でも，最大値，最小値は出力します。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA01860-E | dcreportコマンドの入力形式が正しくありません | 標準エラー出力
KFCA01861-E | コマンド処理中にエラーが発生しました | 標準エラー出力

注意事項

dcstatsコマンドによるシステム統計情報のジャーナル出力実行中は，-rオプションを指定した場合でも累積値をリセットしません。

dcreset

名称

プロセスサービスの再起動および定義の反映

形式

dcreset

機能

システム共通定義，システム環境定義，およびプロセスサービス定義を変更した場合は，変更内容をOpenTP1に反映します。また，KFCA00715-Eメッセージが出力された場合は，中断されていた開始，再開始の処理を開始（中断されていたプロセスサービスを再起動）します。

システム共通定義，システム環境定義，およびプロセスサービス定義を変更した場合は，OpenTP1を正常終了してコマンドを実行してください。

KFCA00715-Eメッセージが出力された場合は，メッセージの要因コードで示す障害を取り除き，OpenTP1が停止しているときに，コマンドを実行してください。

注意事項

OpenTP1オンライン中にコマンドを実行すると，システムダウンします。

このコマンドは，OpenTP1管理者と同じグループIDのユーザ，またはスーパユーザだけが実行できます。

システム環境定義のmode_confオペランドにAUTOを指定している場合，このコマンドを実行するとOpenTP1が自動開始します。

dcsetup

名称

OpenTP1のOSへの登録と削除

形式

dcsetup ｛〔-j〕｜ -d〔-y｜-n〕｝ OpenTP1ディレクトリ

機能

指定したOpenTP1ディレクトリにあるOpenTP1をOSに登録し，OpenTP1の一部をOSとともに開始，または終了します。

dcsetupコマンド実行環境に設定されていた次の環境変数は，OpenTP1で使用される環境変数としてOSに設定されます。

LANG

TZ

ただし，システム定義のputenv形式で環境変数LANGまたはTZが設定されていた場合，そのオペランドが有効になった時点で上書きされます。また，ログサービス定義にputenv形式で環境変数TZを設定する場合，dcsetupコマンド実行環境に設定されているタイムゾーンと一致させてください。一致していない場合，syslogの時刻が正しく出力されません。

また，OpenTP1をOSから削除します。削除はOpenTP1を終了してから実行してください。

dcsetupコマンドは，スーパユーザだけが実行できます。

dcsetupコマンドの入力結果および出力結果は，syslogに出力されるメッセージKFCA01895-IまたはKFCA01896-Iに示します。

オプション

●-j

dcsetupコマンド実行時に，インストールされているOpenTP1提供のリソースマネジャを登録しません。

システム共通定義のjnl_fileless_optionオペランドにYを指定している場合は，このオプションを指定してOpenTP1をセットアップしてください。

●-d

指定したOpenTP1ディレクトリにあるOpenTP1をOSから削除します。

このオプションの指定を省略すると，指定したOpenTP1ディレクトリにあるOpenTP1がOSに登録されます。

-yオプション，または-nオプションの指定を省略している場合，このオプションを指定してコマンドを実行すると，OpenTP1ディレクトリにある実行に必要なファイルを削除するかどうか，オペレータへの問い合わせが実行されます。

この問い合わせに対しyを指定すると，OpenTP1ディレクトリにある実行に必要なファイルを削除します。nを指定すると，OpenTP1ディレクトリにある実行に必要なファイルを削除しません。

コマンド実行時の問い合わせを抑止したい場合は，-yオプション，または-nオプションを指定してコマンドを実行してください。

●-y

指定したOpenTP1ディレクトリにある実行に必要なファイルを削除するかどうかのオペレータへの問い合わせを抑止できます。このオプションを指定すると，指定したOpenTP1ディレクトリにある実行に必要なファイルを削除します。

●-n

指定したOpenTP1ディレクトリにある実行に必要なファイルを削除するかどうかのオペレータへの問い合わせを抑止できます。このオプションを指定すると，指定したOpenTP1ディレクトリにある実行に必要なファイルを削除しません。

コマンド引数

●OpenTP1ディレクトリ　　～〈パス名〉

OpenTP1ディレクトリを指定します。50文字以内で指定してください。

マルチOpenTP1作成時には，OpenTP1ごとに指定します。

注意事項

dcsetupコマンドは，セットアップ先のOpenTP1が停止している場合にだけ実行できます。

OpenTP1ディレクトリにシンボリックリンクは使用できません。

dcsetupコマンド実行時に行われるコンパイル処理では，Cコンパイラを次の順序で検索します。

/bin/ccおよび/lib/ccom
/bin/ccと/lib/ccomの両方が必要です。

/usr/bin/cc

/usr/vac/bin/cc

上記の検索順序でCコンパイラが見つからない場合には，dcsetupコマンドを実行するプロセスの環境変数PATHの指定値に従います。

Linux以外のOSまたはRed Hat Enterprise Linux Server 6未満で使用する場合，次のことに注意してください。

$DCDIR/conf/inittab下に，inittabX（Xは1～3の通番）という名称のファイルをバックアップ用に退避します。

dcsetupコマンド実行中は，/etc/inittabをエディタなどで編集しないでください。編集すると，/etc/inittabが破壊されるおそれがあります。

dcsetupコマンドをkillコマンドなどで中断しないでください。コマンドの処理を中断すると，/etc/inittabが破壊されるおそれがあります。

dcsetupコマンドは，/tmpおよび/etcにテンポラリファイルを作成します。テンポラリファイルの作成に失敗すると，/etc/inittabが破壊されるおそれがあります。このコマンドを実行するときは，/tmpおよび/etcに十分な空き容量があることを確認してください。

Red Hat Enterprise Linux Server 6以降で使用する場合，次のことに注意してください。

dcsetupコマンド実行中は，/etc/iniディレクトリ下のOpenTP1制御ファイルをエディタなどで編集しないでください。編集すると，/etc/iniディレクトリ下のOpenTP1制御ファイルが破壊されるおそれがあります。

dcsetupコマンドをkillなどで中断しないでください。コマンドの処理を中断すると，/etc/iniディレクトリ下のOpenTP1制御ファイルが破壊されるおそれがあります。

dcsetupコマンドは，/tmpおよび/etcにテンポラリファイルを作成します。テンポラリファイルの作成に失敗すると，/etc/iniディレクトリ下のOpenTP1制御ファイルが破壊されるおそれがあります。このコマンドを実行するときは，/tmpおよび/etcに十分な空き容量があることを確認してください。

dcshmls

名称

共用メモリ使用状況の表示

形式

dcshmls 〔-d｛stt｜dyn｜all｝〕〔-r〕

機能

OpenTP1稼働中の共用メモリの使用状況を標準出力に出力します。

オプション

●-d　｛stt｜dyn｜all｝

使用状況を表示する共用メモリを指定します。

　stt：静的共用メモリの詳細使用状況

　dyn：動的共用メモリの詳細使用状況

　all：静的共用メモリ，および動的共用メモリの詳細使用状況

このオプションの指定を省略すると，次に示す情報が表示されます。

共用メモリプール種別

共用メモリプールの大きさ

現在使用中の共用メモリの合計

現在の共用メモリの使用率

共用メモリの最大使用量

●-r

OpenTP1がOSに対して確保するよう要求した共用メモリごとに，確保サイズと使用中サイズの概算値，共用メモリ識別子，および使用者種別を表示します。

出力形式

-dオプション指定時，またはオプションを指定しなかったときに表示されます。

「-d stt」，または「-d all」指定時に表示されます。

「-d dyn」，または「-d all」指定時に表示されます。

-rオプション指定時に表示されます。

aa...aa：共用メモリプール種別

Static…静的共用メモリ

Dynamic…動的共用メモリ

bbbbbbbb：共用メモリプールの大きさ（16進数）

cccccccc：現在使用中の共用メモリの合計（16進数）

dd：現在の共用メモリの使用率（％）（小数点以下切り捨て）

eeeeeeee：共用メモリの最大使用量（16進数）

fff：静的共用メモリブロック使用サービス種別（3文字）
ここでの説明は，マニュアル「OpenTP1 システム定義」，およびマニュアル「TP1/Message Queue 使用の手引」の共用メモリの見積もり式の名称に対応しています。

adm…システムマネジャ

prc…プロセスサーバ

tim…タイマサーバ

scd…スケジューラ，およびクライアント拡張サービス※1

lck…ロックサーバ

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

jnl…ジャーナルサーバ

cpd…チェックポイントダンプ，またはサーバリカバリジャーナル※2

tjl…トランザクションジャーナル

sts…ステータスサーバ

nam…ネームサーバ

que…キューサーバ

prf…性能トレース取得サービス

rap…rapリスナーおよびrapサーバ

xar…XAリソースサービス

dam…DAM

ist…IST

nts…メッセージキュー（OSがWindowsの場合）

rts…リアルタイム統計情報サービス

mcf…MCFサービス

mqa…MQAサーバ，リポジトリ管理機能，またはMQCサーバ

mqt…MQTマネジャサーバ

crm…XATMI通信サービス

注※1

クライアント拡張サービスを使用する場合，静的共用メモリブロック使用サービス種別はscdと表示される部分に含まれます。

注※2

静的共用メモリブロック使用サービス種別がcpdと表示され，かつ静的共用メモリブロック管理用subclass値（16進数）が00002000となる部分は，サーバリカバリジャーナルとなります。

gg：静的共用メモリブロック管理用class値（16進数）（内部情報）

hhhhhhhh：静的共用メモリブロックの共用メモリプールの先頭からの位置（16進数）

iiiiiiii：静的共用メモリブロックのサイズ（16進数）

jjjjjjjj：静的共用メモリブロック管理用subclass値（16進数）（内部情報）

kk...kk：動的共用メモリブロックを確保したプロセスのプロセスID

llllllll：動的共用メモリブロックの共用メモリプールの先頭からの位置（16進数）

mmmmmmmm：動的共用メモリブロックの動的メモリプールの先頭からの位置（16進数）

nnnnnnnn：動的共用メモリブロックのサイズ（16進数）

oo...oo：動的共用メモリブロックの種別

EMPTY…未使用

USE…使用中

pp...pp：共用メモリ識別子

qqqqqqqq：OSに確保要求した共用メモリプールの大きさ（16進数）
OSに確保要求した共用メモリプールの大きさは次のとおりです。
OSに確保要求した共用メモリプールの大きさ＝OpenTP1制御用共用メモリプールの大きさ＋静的共用メモリプールの大きさ＋動的共用メモリプールの大きさ

rrrrrrrr：現在使用中の共用メモリの概算値（16進数）
TP1/Server Baseの共用メモリの場合，共用メモリプールの先頭から，共用メモリ全体で使用中であるエリアの最高位までのサイズです。TP1/Server Baseの共用メモリプールのレイアウトは，アドレスの小さい順から，OpenTP1制御用共用メモリプール，動的共用メモリプール，静的共用メモリプールと配置されています。そのため，この値は，OpenTP1制御用共用メモリプールのサイズおよび動的共用メモリプールのサイズに，静的共用メモリプールの最大使用量を加えた値になります。

ss...ss：共用メモリプールの確保要求者種別

btn…TP1/Server Base

dam…TP1/FS/Direct Access

tam…TP1/FS/Table Access

ism…ISAM

mXX…MQA（XX：16進数で00～ff）

ist…TP1/Shared Table Access

rts…リアルタイム統計情報サービス

出力メッセージ

メッセージID | 内容 | 出力先
KFCA00110-I | ヘルプメッセージ | 標準出力
KFCA00111-E | オプションフラグの指定が誤っています | 標準エラー出力
KFCA00112-E | OpenTP1稼働環境ではありません | 標準エラー出力
KFCA00113-E | OpenTP1の共用メモリを参照できません | 標準エラー出力
KFCA00114-E | 共用メモリが破壊されているため，使用状況を検索できません | 標準エラー出力
KFCA00123-W | 使用状況を確認できない共用メモリブロックが存在します | 標準エラー出力

注意事項

このコマンドで出力される情報は，処理性能への影響を極力抑えるため，排他処理をしないで情報を参照します。このため，タイミングによっては情報を正しく取得できない可能性があります。KFCA00123-Wメッセージが出力された場合は，再度コマンドを実行してください。複数回実行しても同じメッセージが出力される場合は共用メモリが破壊されているおそれがありますので，dcstop -dfでシステムを強制停止してください。その際，KFCA00123-Wメッセージで出力された内容を記録し，コアファイルと共用メモリダンプを保存し，保守員に連絡してください。

dcstart

名称

OpenTP1の開始

形式

dcstart 〔-ngUb〕

機能

計算機内のOpenTP1を正常開始，または再開始します。

オプション

●-n

前回の終了モードに関係なく，OpenTP1を強制的に正常開始します。

このオプションの指定を省略すると，前回の終了モードの指定内容から開始モードが決定されます。前回の終了モードが正常終了の場合は，正常開始します。正常終了以外の場合は，前回の処理内容を引き継ぐために，再開始します。

●-g

ユーザサーバの開始に失敗したとき，およびOpenTP1を強制的に正常開始するときのオペレータへの問い合わせを抑止します。

●-U

このオプションを指定した場合，リラン時にユーザサーバを起動しません。このオプションは，障害が発生し，OpenTP1の状態を回復するためにOpenTP1をオンラインにして作業する必要はあるが，ユーザサーバは起動する必要がない場合などに使用してください。

このオプションは，系切り替え構成の場合の，待機系OpenTP1の開始にも使用できます。これによって，待機系OpenTP1を，実行系OpenTP1の未決着トランザクションの決着，データベースの整合性の管理などの後処理に使用できます。このオプションを使用して待機系OpenTP1を開始する運用については，マニュアル「OpenTP1 解説」を参照してください。

●-b

MCF構成変更準備停止でOpenTP1を停止したあと，MCF構成変更再開始ではなく強制的に再開始します。

詳細については，「5.10.3(2)　MCF構成変更再開始機能によるOpenTP1の再開始」を参照してください。

注意事項

dcstartコマンドを，バックグラウンドで実行する場合は，-gオプションを指定してください。

dcstart -Uオプションを使用する場合には，次のことに注意してください。

正常開始では-Uオプションは無視されます。

ジャーナルアーカイブノードで指定してもオプションは無視されます。

オンライン開始後に，このオプションでユーザサーバを起動したい場合には，dcsvstartを使用してください。

オンライン開始後に，このオプションでユーザサーバの構成を回復したい場合には，正常終了および強制正常終了以外でシステムを停止し，dcstartで-Uオプションを付けないでオンラインを起動してください。

リラン時に，ディスクキューのITQにメッセージが残っている場合，該当APが開始されていないためメッセージは廃棄されます。このとき，ERREVT2を処理するAPも開始されていないため，ERREVT2も通知されません。また，ユーザサーバでアプリケーションプログラムを起動し，そのメッセージがディスクキューのITQまたはOTQに残っている場合も同様です。

前回のオンラインでリモートAPI機能を使用したあとのリランの際にこのオプションを指定した場合，リモートAPIの構成回復まではしません。このオプションを指定したあとにリモートAPI機能を使用したい場合は，オンライン開始後，dcsvstartコマンドでrapリスナーを手動で起動するか，いったん，正常終了および強制正常終了以外でシステムを停止してからdcstartで-Uオプションを付けないでオンラインを起動してください。

OSI TPを使ったクライアント／サーバ形態で通信する場合の通信イベント処理用SPPもUAPと見なされます。通信イベント処理用SPPをOpenTP1の開始と同時に開始するように設定してあるときこの機能を使用すると，通信イベント処理用SPPが開始されないで，アソシエーションの障害検知や再接続ができなくなります。これを回避したい場合は，-UオプションでOpenTP1開始後に必ず通信イベント処理用SPPを開始させてください。

サーバ閉塞引き継ぎ機能を使用すると，次の問題が発生します。

スケジュールの閉塞状態は，dcstart -Uでリランしたオンラインでは引き継がれません。

スケジュール閉塞状態のSPPが存在し，かつdcstart -Uでリランしたオンラインを，いったん計画停止または強制停止してから再度dcstartを使用して起動した場合，dcstart -U以前のオンラインのスケジュール閉塞状態がSPPに引き継がれてしまいます。dcstart -U以前のオンラインのスケジュール閉塞状態が引き継がれないようにするには，次のような対策が必要です。
・dcstart -Uでリランしたオンラインは，正常停止するかまたは強制正常開始する。
・全ユーザサービス定義にhold_recovery=Nを指定する。
・スケジュールサービス定義にscd_hold_recovery_count=0を指定する。

通信できないIPアドレス，または通信できないIPアドレスに変換されるホスト名を，システムサービス定義のall_nodeオペランドに指定した場合，OpenTP1の起動に時間が掛かることがあります。詳細については，マニュアル「OpenTP1 システム定義」を参照してください。

dcstartコマンドをOSコマンドで強制停止させた場合，OpenTP1が異常終了することがあります。

dcstartコマンドでOpenTP1を起動する場合，プロセスサーバにOpenTP1の起動開始が通知されます。プロセスサーバへの起動通知に失敗すると，dcstartコマンドの機能によって，自動的に起動通知をリトライします。
この起動通知をリトライする機能を使用した場合，起動通知に失敗したとき，KFCA01801-Eメッセージ，またはKFCA01861-Eメッセージを出力し，起動通知のリトライ処理をします。
起動通知をリトライするために使用する定義については，マニュアル「OpenTP1 システム定義」を参照してください。

dcstartコマンドを実行してOpenTP1を起動する際に，次に示すメッセージが出力されることがあります。

KFCA01801-Eメッセージ（要因：SETUPまたはPAUSE）

KFCA01861-Eメッセージ（要因：COMMUNICATIONまたはTIMEOUT）

この場合は，次に示す方法で対処してください。

dcstartコマンドを再実行する

システム共通定義のdcstart_wakeup_retry_countオペランドおよびdcstart_wakeup_retry_intervalオペランドで，OpenTP1の起動をリトライする回数や間隔を指定する

dcstats

名称

システム統計情報の取得開始，終了

形式

dcstats ｛〔-k 統計情報種別〔,統計情報種別〕…〕 〔-m 時間間隔〕
      〔-｛a｜s｝〕 〔サーバ名〔△サーバ名〕…〕｜-r｝

機能

指定したサーバ名のシステム統計情報を，指定した時間間隔でシステムジャーナルファイルに出力します。

システム統計情報の出力は，-rオプション指定のdcstatsコマンドで終了できます。-rオプション指定のdcstatsコマンドを実行しないと，OpenTP1が停止するまで出力し続けます。

dcstatsコマンドを実行したあとに起動されたユーザサーバの，ユーザサーバ単位のシステム統計情報は取得されません。

dcstatsコマンドは，アーカイブジャーナルノードでは使用できません。

オプション

●-k　統計情報種別

出力するシステム統計情報の種別を指定します。

複数の統計情報種別を指定する場合，統計情報種別と統計情報種別との間をコンマ（，）で区切ります。

　rpc：RPC情報

　lck：ロック情報

　prc：プロセス情報

　nam：ネーム情報

　que：メッセージキュー情報

　scd：スケジュール情報

　mcf：MCF情報

　mqa：MQAサービス情報

　dam：DAM情報

　tam：TAM情報

　trn：トランザクション情報

　cpd：チェックポイントダンプ情報

　jnl：ジャーナル情報

　osl：共用メモリ管理情報

　ist：ノード間共用テーブル情報

　xat：XATMIサービス情報

このオプションの指定を省略すると，すべてのシステム統計情報が出力されます。

●-m　時間間隔　　～〈符号なし整数〉((1～1440))《10》

システム統計情報をシステムジャーナルファイルに出力する時間間隔を，分単位で指定します。

●-a

システム全体，および全ユーザサーバのシステム統計情報を出力します。

-sオプションと同時に指定することはできません。

●-s

システム全体のシステム統計情報を出力します。

-aオプションと同時に指定することはできません。

-a，-sオプション，およびサーバ名の指定をすべて省略すると，システム全体のシステム統計情報が出力されます。

●-r

システム統計情報の出力を終了します。

ほかのオプションと同時に指定すると，-rオプションが有効になり，ほかのオプションは無視されます。

コマンド引数

●サーバ名　　～〈1～8文字の英数字〉

出力するシステム統計情報の発生元のユーザサーバの名称を指定します。

指定したサーバ単位にシステム統計情報を出力します。

-aオプションを指定した場合，サーバ名の指定は無視されます。

注意事項

dcstatsコマンドの指定は，OpenTP1再開始時には引き継がれません。OpenTP1再開始後にシステム統計情報を出力する場合は，再びdcstatsコマンドを実行してください。

ユーザサーバを一度終了すると，正常開始時にはユーザサーバのシステム統計情報出力の指定は引き継がれません。一度終了したユーザサーバのシステム統計情報を出力する場合は，ユーザサーバの正常開始完了後にdcstatsコマンドを実行してください。

dcstop

名称

OpenTP1の終了

形式

dcstop 〔｛-n｜-a｜-b〔-q〕｜-f〔-d〕｝〕

機能

計算機内のOpenTP1を終了します。

オプション

●-n

次のような停止状態のユーザサーバがあっても強制的に正常終了します。

dcsvstop -fコマンドで強制停止したユーザサーバ

異常終了したユーザサーバがSUPまたはソケット受信型SPPの場合

これらの異常終了したサーバおよび強制停止したサーバをチェックして，システムの正常終了を続行することが，正常終了の処理と異なります。

●-a

OpenTP1を計画停止Aで終了します。

●-b

OpenTP1を計画停止Bで終了します。

●-f

OpenTP1を強制停止します。

-n，-a，-b，および-fオプションは，同時に指定できません。

●-d

OpenTP1を強制停止したときに，稼働するすべてのプロセスのコアファイル，および共用メモリ情報を取得します。dcstopコマンドが終了しないとき，またはシステムで異常が発生したときに，トラブルシュート情報としてコアファイル，および共用メモリ情報を取得するために指定します。

このオプションは-fオプションと一緒に指定してください。

●-q

OpenTP1をMCF構成変更準備停止で終了します。

このオプションは-bオプションと一緒に指定してください。-bオプションと同時に指定しない場合，KFCA01860-Eメッセージを出力してdcstopコマンドが終了します。

TP1/Message Control - Extension 1が組み込まれていない場合，KFCA01861-Eメッセージを出力してdcstopコマンドが終了します。

出力メッセージ

メッセージID
内容
出力先

KFCA01801-E
環境変数DCDIRが未設定です
標準エラー出力

KFCA01821-E
OpenTP1を続行できません
メッセージログファイル

KFCA01840-I
OpenTP1は終了中です
メッセージログファイル

KFCA01841-I
OpenTP1は停止しています
標準出力

KFCA01842-I
サーバは終了中です
メッセージログファイル

KFCA01844-E
サーバの終了処理が失敗しました
標準エラー出力

KFCA01846-E
システムを正常終了できません
メッセージログファイル，
標準エラー出力

KFCA01847-E
システムを終了できません
メッセージログファイル，
標準エラー出力

KFCA01848-I
すべてのユーザサーバが終了しました
メッセージログファイル

KFCA01849-W
サーバの終了を待ち合わせます
メッセージログファイル，
標準出力

KFCA01860-E
dcstopコマンドの入力形式が正しくありません
標準エラー出力

KFCA01861-E
dcstopコマンドの処理が失敗しました
標準エラー出力

KFCA01863-E
dcstopコマンドを実行できません
メッセージログファイル，
標準エラー出力

KFCA01864-E
タイムオーバです
メッセージログファイル，
標準エラー出力

KFCA01865-E
dcstopコマンドを中止します
メッセージログファイル，
標準エラー出力

KFCA01867-E
共用メモリを確保できません
標準エラー出力

KFCA01869-E
dcstopコマンドを実行できません
標準エラー出力

注意事項

すべてのオプションの指定を省略すると，OpenTP1は正常終了します。

システムサービスに障害が発生したときにdcstopコマンドを入力すると，タイミングによってはOpenTP1が異常終了することがあります。

部分回復中は終了できません。

終了処理中はサーバの再起動を抑止します。

dcstopコマンドが終了しないとき，またはシステムで異常が発生したとき，dcstop -fdコマンドでOpenTP1を強制停止し，コアファイルと共用メモリ情報を取得すると，要因を調査できます。

dcstop -fdが入力されると，障害情報の取得のためにマシンの負荷が上がります。そのため，二つ以上のOpenTP1が同一マシン上で稼働していた場合，マルチOpenTP1構成ではタイムアウトが，相互ホットスタンバイなどのHA構成ではスローダウンまたはタイムアウトが，ほかのOpenTP1で発生することがあります。

HP-UXの場合，dcsvstartコマンドで起動するユーザサーバのリンケージのバインドモードはimmediateにしてください。immediate以外でリンケージした実行形式ファイルを使用した場合は，OpenTP1は動作を保証しません。ユーザサーバが原因不明で異常終了した場合は，OSのchatrコマンドでバインドモードがimmediateかどうかを確認してください。

dcstopコマンドをOSコマンドで強制停止させた場合，OpenTP1が異常終了することがあります。

dcstop -fを入力した場合は，次のことに注意してください。

強制停止の延長で，KFCA00105-Eメッセージが出力されることがあります。

KFCA00105-Eメッセージでアボートコード「olkcrit」が出力されている場合，dcstopコマンドのリターン値が0以外になることがありますが，OpenTP1は停止しています。

dcstopコマンドが正常リターンした直後にOpenTP1の運用コマンドを入力するシェルスクリプトは，組まないようにしてください。

OpenTP1停止直後には，dcstopコマンドを入力しないでください。コマンドが中断するおそれがあります。

TP1/Message Controlを使用する場合，TP1/Message Controlの起動が完了してからdcstopコマンドを入力してください。TP1/Message Controlの起動が完了する前にdcstopコマンドを入力した場合，dcstopコマンドがタイムアウトすることがあります。TP1/Message Controlの起動が完了しているかどうかは，KFCA10151-Iメッセージが出力されているか，または-wオプションを指定したmcftlscomコマンドで確認できます。

dcsvstart

名称

サーバの開始

形式

dcsvstart -u ユーザサーバ名〔,ユーザサーバ名〕…〔-a 引数〕

機能

サーバを開始します。

dcsvstartコマンドは，アーカイブジャーナルノードでは使用できません。

オプション

●-u　ユーザサーバ名　　～〈1～8文字の識別子〉

開始するユーザサーバのサーバ名を指定します。

一つのdcsvstartコマンドで指定できるユーザサーバ名の最大数は50です。

複数のユーザサーバ名を指定する場合，ユーザサーバ名とユーザサーバ名との間をコンマ（,）で区切ります。このとき，ユーザサーバ名の直後に空白を入れないでください。

このオプションの指定を省略すると，ユーザサーバは開始しません。

●-a　引数

～〈，（コンマ）および"（ダブルクォーテーション）を除く1～127文字の文字列〉

-uオプションで指定されたサーバのうち，SUPの起動時の第1引数を指定します。

-uオプションで上記の条件のサーバが複数指定されている場合，そのすべてのサーバの第1引数に-aオプションで指定された文字列が渡されます。

出力メッセージ

メッセージID
内容
出力先

KFCA01801-E
環境変数DCDIRが未設定です
標準エラー出力

KFCA01811-I
サーバは開始中です
メッセージログファイル

KFCA01812-E
サーバの開始処理が失敗しました
メッセージログファイル，
標準エラー出力

KFCA01813-I
サーバはオンライン中です
メッセージログファイル

KFCA01815-E
OSでエラーが発生しました
標準エラー出力

KFCA01818-E
サーバの起動を中止します
標準エラー出力

KFCA01860-E
dcsvstartコマンドの入力形式が正しくありません
標準エラー出力

KFCA01861-E
dcsvstartコマンドの処理に失敗しました
標準エラー出力

KFCA01863-E
コマンドを実行できません
メッセージログファイル，
標準エラー出力

KFCA01863-E
タイムオーバです
メッセージログファイル，
標準エラー出力

KFCA01866-E
サーバ重複エラーが発生しました
標準エラー出力

KFCA01867-E
共用メモリを確保できません
標準エラー出力

KFCA01868-E
サーバ名が正しくありません
標準エラー出力

KFCA01869-E
dcsvstartコマンドは受け付けられません
標準エラー出力

KFCA01870-E
メモリ不足が発生しました
メッセージログファイル，
標準エラー出力

注意事項

dcsvstartコマンドが終了しない場合は，dcsvstop -dfコマンドでUAPを強制停止し，コアファイルを取得すると，要因を調査できます。dcsvstop -dfコマンドを実行すると，dcsvstartコマンドもコアファイルにトラブルシュート情報を出力して終了します。dcsvstartコマンドの異常終了によって，OpenTP1が異常終了することはありません。ただし，次の場合はOpenTP1が異常終了することがあります。

dcsvstop -dfコマンドに指定したユーザサーバに対して，ユーザサービス定義でcritical=Yを指定している場合。

dcsvstartコマンドをOSコマンドで強制停止させた場合。

MHPを開始するには，MHPに対するサービスの状態がすべて閉塞解除，保留解除された状態で，dcsvstartコマンドを実行する必要があります。サービスの状態は，mcfalsapコマンド，mcftlssvコマンド，およびmcftlssgコマンドで確認できます。

dcsvstop

名称

サーバの終了

形式

dcsvstop [-f[-d]] ユーザサーバ名[ ユーザサーバ名]…

機能

サーバを終了します。

dcsvstopコマンドは，アーカイブジャーナルノードでは使用できません。

オプション

●-d

ユーザサーバを強制停止したときに，ユーザサーバのコアファイルを取得します。dcsvstartコマンド，またはdcsvstopコマンドが終了しないときにトラブルシュート情報としてコアファイルを取得するために指定します。

このオプションは，-fオプションと一緒に指定してください。

●-f

指定したユーザサーバを強制停止します。

このオプションの指定を省略すると，OpenTP1は該当するサーバを正常終了します。

コマンド引数

●ユーザサーバ名　　～〈1～8文字の識別子〉

終了するユーザサーバの名称を指定します。一つのdcsvstopコマンドで指定できるユーザサーバ名の最大数は50です。

出力メッセージ

メッセージID
内容
出力先

KFCA01801-E
環境変数DCDIRが未設定です
標準エラー出力

KFCA01821-E
OpenTP1を続行できません
メッセージログファイル

KFCA01842-I
サーバは終了中です
メッセージログファイル

KFCA01843-I
サーバは停止しています
メッセージログファイル

KFCA01844-E
サーバの終了処理に失敗しました
メッセージログファイル，
標準エラー出力

KFCA01849-W
サーバの終了を待ち合わせます
メッセージログファイル，
標準出力

KFCA01860-E
dcsvstopコマンドの入力形式が正しくありません
標準エラー出力

KFCA01861-E
dcsvstopコマンドの処理に失敗しました
メッセージログファイル，
標準エラー出力

KFCA01862-E
サーバ名を入力してください
メッセージログファイル，
標準エラー出力

KFCA01863-E
dcsvstopコマンドを実行できません
メッセージログファイル，
標準エラー出力

KFCA01866-E
サーバ重複エラーが発生しました
標準エラー出力

KFCA01867-E
共用メモリを確保できません
標準エラー出力

KFCA01868-E
サーバ名が正しくありません
標準エラー出力

KFCA01869-E
dcsvstopコマンドは受け付けられません
標準エラー出力

注意事項

dcsvstopコマンドが終了しない場合，dcsvstop -dfコマンドでUAPを強制停止し，コアファイルを取得すると，要因を調査できます。強制停止するとdcsvstopコマンドはトラブルシュート情報をコアファイルに出力して終了します。dcsvstopコマンドの異常終了によって，OpenTP1が異常終了することはありません。ただし，次の場合はOpenTP1が異常終了することがあります。

dcsvstop -dfコマンドに指定したユーザサーバに対して，ユーザサービス定義でcritical=Yを指定している場合。

dcsvstopコマンドをOSコマンドで強制停止させた場合。

MHPに対してdcsvstopコマンドを実行する場合，入力キューへのメッセージ滞留状態によってMHPが終了しないことがあります。この場合は，dcsvstopコマンドを実行してMHPを終了したあとのメッセージ処理運用を考慮して，MCFを閉塞（mcftdctsgコマンドおよびmcfthldiqコマンド）するかどうかを判断してください。

filbkup

名称

OpenTP1ファイルシステムのバックアップ

形式

filbkup 〔-y〕〔-r〕〔-i〕〔-｛c｜l｜f｝〕
        OpenTP1ファイルシステム領域名〔/OpenTP1ファイル名〕
        バックアップファイル名

機能

指定したOpenTP1ファイルシステムをバックアップします。このとき，OpenTP1ファイルの属性もバックアップします。バックアップ用のファイルには一つのOpenTP1ファイルシステムだけをバックアップできます。複数のOpenTP1ファイルシステムをバックアップしたい場合は，バックアップしたいOpenTP1ファイルシステムの数だけファイルが必要です。

filbkupコマンドは，OpenTP1ファイルシステムをバックアップする前にユーザに確認を求めますが，-yオプションを指定すると，確認を求めないですぐにバックアップすることもできます。

filbkupコマンドを実行できるのはOpenTP1管理者です。

なお，バックアップしたOpenTP1ファイルシステムはfilrstrコマンドでリストアできます。

また，OpenTP1ファイル名を指定してバックアップすることもできますが，これは主に保守情報を取得するために行います。

オプション

●-y

このオプションを指定すると，ユーザに確認しないで，すぐにOpenTP1ファイルシステムをバックアップします。

-yオプションの指定を省略すると，OpenTP1ユーザに確認してからOpenTP1ファイルシステムをバックアップします。

●-r

バックアップ先ファイルがすでにある場合，そのファイルを削除して新しくバックアップ先ファイルを作成します。

-rオプションの指定を省略すると，バックアップ先ファイルがすでにある場合filbkupコマンドはエラー終了します。

●-i

OpenTP1ファイルの読み出し中にエラーが発生した場合，そのファイルのバックアップを中止して，次のファイルから再び読み出します。なお，エラーが発生したファイルの残りのエリアはクリアされます。

-iオプションの指定を省略すると，OpenTP1ファイルの読み出し中にエラーが発生した場合，filbkupコマンドはエラー終了し，エラーメッセージが出力されます。

●-｛c｜l｜f｝

-c

指定したOpenTP1ファイルシステム中のOpenTP1ファイルを他プロセス，または他ユーザが使用中の場合，OpenTP1ファイルシステムをバックアップしません。

-l

指定したOpenTP1ファイルシステム中のOpenTP1ファイルを他プロセス，または他ユーザが使用中の場合，使用中のOpenTP1ファイルについてはバックアップしません。

-f

指定したOpenTP1ファイルシステム中のOpenTP1ファイルを他プロセス，または他ユーザが使用中の場合でも，OpenTP1ファイルシステムを強制的にバックアップします。

コマンド引数

●OpenTP1ファイルシステム領域名　　～〈パス名〉

バックアップするOpenTP1ファイルシステムがあるキャラクタ型スペシャルファイル名，または通常ファイル名を指定します。

●OpenTP1ファイル名　　～〈OpenTP1ファイル名〉

バックアップするOpenTP1ファイルの名称を指定します。

このコマンド引数を指定すると，指定したOpenTP1ファイルだけがバックアップされます。

●バックアップファイル名　　～〈パス名〉

バックアップ先のファイルの名称を指定します。

注意事項

指定したOpenTP1ファイルシステム中のOpenTP1ファイルを他プロセス，または他ユーザが使用中の場合，OpenTP1ファイルシステムのバックアップは行いません。強制的にバックアップしたい場合は，-l，または-fオプションを指定してください。

OpenTP1ファイルシステムのバックアップ中にエラーが発生した場合，直ちにバックアップ処理を中断するため，バックアップ先のファイルの中身は保証できません。この場合のバックアップ先のファイルは削除されません。

filchgrp

名称

OpenTP1ファイルグループの変更

形式

filchgrp グループ OpenTP1ファイルシステム領域名/OpenTP1ファイル名

機能

指定したOpenTP1ファイルのグループを，指定したグループに変更します。

filchgrpコマンドを実行できるのは，OpenTP1管理者，またはOpenTP1ファイルの所有者だけです。

コマンド引数

●グループ

10進数のグループID，またはグループファイル（/etc/group）にあるグループ名のどれかを指定します。

指定した文字列がすべて数字で，かつその文字列に一致するグループ名称が/etc/groupエントリ中にない場合，その文字列を10進数のグループIDと見なします。

●OpenTP1ファイルシステム領域名　　～〈パス名〉

OpenTP1ファイルシステムがあるキャラクタ型スペシャルファイル名，または通常ファイル名を指定します。

●OpenTP1ファイル名　　～〈OpenTP1ファイル名〉

OpenTP1ファイル名を指定します。

出力メッセージ

メッセージID
内容
出力先

KFCA01507-I
ヘルプメッセージ
標準出力，
標準エラー出力

KFCA01533-E
指定したOpenTP1ファイルがありません
標準エラー出力

KFCA01536-E
コマンド引数の指定が誤っています
標準エラー出力

KFCA01541-E
指定したグループ名がありません
標準エラー出力

KFCA01543-E
指定したグループIDが大き過ぎます
標準エラー出力

KFCA01570-E
ファイルとのバージョンが不整合です
標準エラー出力

KFCA01571-E
ファイルに対するアクセス権がありません
標準エラー出力

KFCA01572-E
オープン時に上限値オーバが発生しました
標準エラー出力

KFCA01573-E
指定したOpenTP1ファイルシステム領域がありません
標準エラー出力

KFCA01574-E
指定したファイルのファイル名が長過ぎます
標準エラー出力

KFCA01575-E
指定したファイルがキャラクタ型スペシャルファイルまたは通常ファイルではないか，ファイルはあっても対応する装置がありません
標準エラー出力

KFCA01576-E
ファイルがOpenTP1ファイルシステムではありません
標準エラー出力

KFCA01577-E
filchgrpコマンドの実行権がありません
標準エラー出力

KFCA01578-E
OpenTP1ファイルシステムのロックに失敗しました
標準エラー出力

KFCA01582-E
メモリ不足です
標準エラー出力

KFCA01583-E
入出力エラーが発生しました
標準エラー出力

KFCA01599-E
異常が発生しました
標準エラー出力

filchmod

名称

OpenTP1ファイルのアクセス許可モードの変更

形式

filchmod モード OpenTP1ファイルシステム領域名/OpenTP1ファイル名

機能

指定したOpenTP1ファイルのファイルアクセス許可を，指定したモードに従って変更します。

filchmodコマンドを実行できるのは，OpenTP1管理者，またはOpenTP1ファイルの所有者です。

コマンド引数

●モード

モードは，絶対形式，または記号形式で指定します。

絶対形式で指定する場合，次の意味になります。

絶対形式 | 意味
0400 | 所有者による読み出し権
0200 | 所有者による書き込み権
0040 | グループによる読み出し権
0020 | グループによる書き込み権
0004 | 他者による読み出し権
0002 | 他者による書き込み権

記号形式で指定する場合，次の形式で指定します。

　〔だれに〕操作〔アクセス権〕

だれに：だれに対する許可であるかを指定します。
u…所有者
g…グループ
o…他者
a…所有者，グループ，および他者
この指定を省略すると，aが仮定されます。

操作：どのような操作をするかを指定します。
+…アクセス権を追加
-…アクセス権を削除
=…アクセス権に指定したもの以外を削除

アクセス権：アクセス権を指定します。
r…読み出しを許可
w…書き込みを許可
アクセス権の指定を省略すると，読み出しも書き込みもできません。操作に=を指定したときだけ，アクセス権の指定を省略できます。

●OpenTP1ファイルシステム領域名　　～〈パス名〉

OpenTP1ファイルシステムがあるキャラクタ型スペシャルファイル名，または通常ファイル名を指定します。

●OpenTP1ファイル名　　～〈OpenTP1ファイル名〉

OpenTP1ファイル名を指定します。

出力メッセージ

メッセージID
内容
出力先

KFCA01508-I
ヘルプメッセージ
標準出力，
標準エラー出力

KFCA01533-E
指定したOpenTP1ファイルがありません
標準エラー出力

KFCA01536-E
コマンド引数の指定が誤っています
標準エラー出力

KFCA01538-E
モード引数の指定が誤っています
標準エラー出力

KFCA01570-E
ファイルとのバージョンが不整合です
標準エラー出力

KFCA01571-E
ファイルに対するアクセス権がありません
標準エラー出力

KFCA01572-E
オープン時に上限値オーバが発生しました
標準エラー出力

KFCA01573-E
指定したOpenTP1ファイルシステム領域がありません
標準エラー出力

KFCA01574-E
指定したファイルのファイル名が長過ぎます
標準エラー出力

KFCA01575-E
指定したファイルがキャラクタ型スペシャルファイルまたは通常ファイルではないか，ファイルがあっても対応する装置がありません
標準エラー出力

KFCA01576-E
ファイルがOpenTP1ファイルシステムではありません
標準エラー出力

KFCA01577-E
filchmodコマンドの実行権がありません
標準エラー出力

KFCA01578-E
OpenTP1ファイルシステムのロックに失敗しました
標準エラー出力

KFCA01582-E
メモリ不足です
標準エラー出力

KFCA01583-E
入出力エラーが発生しました
標準エラー出力

KFCA01599-E
異常が発生しました
標準エラー出力

使用例

スペシャルファイル名が「/dev/rdsk/rhd2a」，OpenTP1ファイル名が「file」のときに，記号形式ですべてに対して読み出し権を追加する例を三つ示します。

filchmod ugo+r /dev/rdsk/rhd2a/file
filchmod a+r /dev/rdsk/rhd2a/file
filchmod +r /dev/rdsk/rhd2a/file

filchown

名称

OpenTP1ファイル所有者の変更

形式

filchown 所有者 OpenTP1ファイルシステム領域名/OpenTP1ファイル名

機能

指定したOpenTP1ファイルの所有者を変更します。

filchownコマンドを実行できるのはOpenTP1管理者，またはOpenTP1ファイルの所有者です。

コマンド引数

●所有者

10進数のユーザID，またはパスワードファイル（/etc/passwd）にあるログイン名のどれかを指定します。

指定した文字列がすべて数字で，かつその文字列に一致するログイン名が/etc/passwdエントリ中にない場合，その文字列を10進数のユーザIDと見なします。

●OpenTP1ファイルシステム領域名　　～〈パス名〉

OpenTP1ファイルシステムがあるキャラクタ型スペシャルファイル名，または通常ファイル名を指定します。

●OpenTP1ファイル名　　～〈OpenTP1ファイル名〉

OpenTP1ファイル名を指定します。

出力メッセージ

メッセージID
内容
出力先

KFCA01506-I
ヘルプメッセージ
標準出力，
標準エラー出力

KFCA01533-E
指定したOpenTP1ファイルがありません
標準エラー出力

KFCA01536-E
コマンド引数の指定が誤っています
標準エラー出力

KFCA01540-E
指定したログイン名がありません
標準エラー出力

KFCA01542-E
指定したユーザIDが大き過ぎます
標準エラー出力

KFCA01570-E
ファイルとのバージョンが不整合です
標準エラー出力

KFCA01571-E
ファイルに対するアクセス権がありません
標準エラー出力

KFCA01572-E
オープン時に上限値オーバが発生しました
標準エラー出力

KFCA01573-E
指定したOpenTP1ファイルシステム領域がありません
標準エラー出力

KFCA01574-E
指定したファイルのファイル名が長過ぎます
標準エラー出力

KFCA01575-E
指定したファイルがキャラクタ型スペシャルファイルまたは通常ファイルではないか，ファイルがあっても対応する装置がありません
標準エラー出力

KFCA01576-E
ファイルがOpenTP1ファイルシステムではありません
標準エラー出力

KFCA01577-E
filchownコマンドの実行権がありません
標準エラー出力

KFCA01578-E
OpenTP1ファイルシステムのロックに失敗しました
標準エラー出力

KFCA01582-E
メモリ不足です
標準エラー出力

KFCA01583-E
入出力エラーが発生しました
標準エラー出力

KFCA01599-E
異常が発生しました
標準エラー出力

fills

名称

OpenTP1ファイルシステムの内容表示

形式

fills｛〔-〔H〕〔L〕〔｛t｜u｝〕〕 OpenTP1ファイルシステム領域名
      〔/OpenTP1ファイル名〕｜〔-x〕 OpenTP1ファイルシステム領域名
      〔/OpenTP1ファイル名〕｝

機能

OpenTP1ファイルシステムの内容を標準出力に出力します。

コマンド引数にOpenTP1ファイルシステム領域名だけを指定した場合は，指定したOpenTP1ファイルシステム内にあるすべてのOpenTP1ファイルの内容を，ファイル名のアルファベット順で出力します。コマンド引数にOpenTP1ファイル名も指定した場合は，指定したOpenTP1ファイルの内容だけ出力します。

オプション

●-H

表示する情報にヘッダを付けて，ファイル名のアルファベット順に，縦方向に表示します。

●-L

ファイルのロック状態を，ファイル名のアルファベット順に，縦方向に表示します。

●-｛t｜u｝

-t

最終更新日時が最近のものから順に，OpenTP1ファイルシステムの内容を表示します。

-u

最終アクセス日時が最近のものから順に，OpenTP1ファイルシステムの内容を表示します。

-Hオプションおよび-Lオプションと，-tオプションまたは-uオプションを同時に指定すると，表示内容の順序は，-tオプションまたは-uオプションの指定が有効になります。

●-x

ファイル名だけをアルファベット順に，横方向に表示します。

すべてのオプションの指定を省略すると，OpenTP1ファイルシステムの内容がファイル名のアルファベット順に，縦方向に表示されます。

コマンド引数

●OpenTP1ファイルシステム領域名　　～〈パス名〉

OpenTP1ファイルシステムがあるキャラクタ型スペシャルファイル名，または通常ファイル名を指定します。

●OpenTP1ファイル名　　～〈OpenTP1ファイル名〉

OpenTP1ファイル名を指定します。

出力形式

●-Hオプションを指定した場合

 MODE   UID     GID    RSIZE   RNUM  TIME    FILE
aabbcc dd...dd ee...ee  ffff   ggggg hh...hh ii...ii

aa：所有者に対するアクセス権

r…読み出し権がある

w…書き込み権がある

-…読み出し権，または書き込み権がない

bb：グループに対するアクセス権

r…読み出し権がある

w…書き込み権がある

-…読み出し権，または書き込み権がない

cc：他者に対するアクセス権

r…読み出し権がある

w…書き込み権がある

-…読み出し権，または書き込み権がない

dd...dd：所有者名（9文字以内）

ee...ee：所有者のグループ名（9文字以内）

ffff：レコード長

ggggg：レコード数

hh...hh：最終更新日時
時:分△月日年の形式

ii...ii：OpenTP1ファイル名

●-Hオプションと-Lオプションを指定した場合

 MODE   UID     GID    PID  L TIME    FILE
aabbcc dd...dd ee...ee pppp q hh...hh ii...ii

aa：所有者に対するアクセス権

r…読み出し権がある

w…書き込み権がある

-…読み出し権，または書き込み権がない

bb：グループに対するアクセス権

r…読み出し権がある

w…書き込み権がある

-…読み出し権，または書き込み権がない

cc：他者に対するアクセス権

r…読み出し権がある

w…書き込み権がある

-…読み出し権，または書き込み権がない

dd...dd：所有者名（9文字以内）

ee...ee：所有者のグループ名（9文字以内）

pppp：ロックを掛けているプロセスのプロセスID
ロックが掛けられていない場合は，「－」が表示されます。

q：ロック状態の識別フラグ

E…占有ロック

S…共有ロック

-…ロックが掛けられていない

hh...hh：最終更新日時
時:分△月日年の形式

ii...ii：OpenTP1ファイル名

出力メッセージ

メッセージID
内容
出力先

KFCA01503-I
ヘルプメッセージ
標準出力，
標準エラー出力

KFCA01533-E
ファイルがありません
標準エラー出力

KFCA01536-E
コマンド引数の指定が誤っています
標準エラー出力

KFCA01537-E
オプションフラグの指定がないか，またはオプションフラグの組み合わせが誤っています
標準エラー出力

KFCA01570-E
ファイルとのバージョンが不整合です
標準エラー出力

KFCA01571-E
ファイルに対するアクセス権がありません
標準エラー出力

KFCA01572-E
オープン時に上限値オーバが発生しました
標準エラー出力

KFCA01573-E
指定したOpenTP1ファイルシステム領域がありません
標準エラー出力

KFCA01574-E
指定したファイルのファイル名が長過ぎます
標準エラー出力

KFCA01575-E
指定したファイルがキャラクタ型スペシャルファイルまたは通常ファイルではないか，ファイルがあっても対応する装置がありません
標準エラー出力

KFCA01576-E
ファイルがOpenTP1ファイルシステムではありません
標準エラー出力

KFCA01578-E
OpenTP1ファイルシステムのロックに失敗しました
標準エラー出力

KFCA01582-E
メモリ不足です
標準エラー出力

KFCA01583-E
入出力エラーが発生しました
標準エラー出力

KFCA01599-E
異常が発生しました
標準エラー出力

filmkfs

名称

OpenTP1ファイルシステムの初期設定

形式

キャラクタ型スペシャルファイルの場合

filmkfs -s セクタ長 -n 容量 -l 最大ファイル数
     〔-v OpenTP1ファイルシステム名〕 スペシャルファイル名

通常ファイルの場合

filmkfs〔-r〕 -n 容量 -l 最大ファイル数
      〔-v OpenTP1ファイルシステム名〕 通常ファイル名

機能

指定したハードディスクのパーティション，または通常ファイルを，OpenTP1ファイルシステム用に初期設定します。初期設定は，OpenTP1ファイルシステムとして通常ファイル，またはパーティションを割り当てるときに一度だけ行います。

filmkfsコマンドを実行できるのは，キャラクタ型スペシャルファイルの場合，スーパユーザ，またはキャラクタ型スペシャルファイルの所有者です。通常ファイルの場合は，スーパユーザ，または通常ファイルを作成するディレクトリに書き込みを許可されているユーザです。通常ファイルがすでに存在する場合は，スーパユーザ，または通常ファイルの所有者です。

オプション

●-r

ユーザに確認を求めないで初期化します。そのため，指定した通常ファイルがすでにある場合，そのファイルの内容は失われます。

-rオプションの指定を省略すると，指定した通常ファイルがすでにある場合，初期化するかどうか，確認を求められます。

●-s　セクタ長

OpenTP1ファイルシステムを構築するハードディスクのセクタ長を指定します。

-sオプションには，キャラクタ型スペシャルファイルに対応するディスクのセクタ長を指定してください。なお，指定できる最大のセクタ長は2048です。不正なセクタ長を指定した場合は，引数の指定誤り，I/Oエラーなどのエラーメッセージを出力して，filmkfsコマンドの処理が失敗します。

●-n　容量　　～((1～4095))（単位：メガバイト）

OpenTP1ファイルシステムとして割り当てる容量をメガバイトで指定します。

-nオプションには，キャラクタ型スペシャルファイルの容量以下の値を指定してください。ディスクボリューム，またはパーティションの容量より大きな値を指定すると，容量不足，I/Oエラーなどのエラーメッセージを出力して，filmkfsコマンドの処理が失敗します。

●-l　最大ファイル数　　～((1～4096))

OpenTP1ファイルシステム内に作成するファイル数の上限を指定します。

●-v　OpenTP1ファイルシステム名　　～〈1～8文字のOpenTP1ファイル名〉

OpenTP1ファイルシステムに付ける名称を指定します。

-vオプションの指定を省略すると，OpenTP1ファイルシステムに名称が付きません。

コマンド引数

●スペシャルファイル名　　～〈パス名〉

初期化するスペシャルファイルの名称を指定します。

指定するファイルはキャラクタ型スペシャルファイルです。

●通常ファイル名　　～〈パス名〉

初期化する通常ファイルの名称を指定します。

注意事項

容量不足，I/Oエラーなどのエラーメッセージを出力して，filmkfsコマンドの処理が失敗した場合，OpenTP1管理者は，OpenTP1ファイルシステムの容量を正確に計算して，ディスクを割り当てる必要があります。

OpenTP1ファイルシステムにキャラクタ型スペシャルファイルを指定する場合，UNIXファイルシステムとして使用しているパーティションを指定しないでください。

OpenTP1ファイルシステム領域名に指定できる長さは49文字までです。49文字を超えるOpenTP1ファイルシステム領域名を指定した場合，KFCA01574-Eメッセージを出力します。

OpenTP1ファイルシステムの信頼性を確保したい場合，キャラクタ型スペシャルファイルを使用する必要があります。

filrstr

名称

OpenTP1ファイルシステムのリストア

形式

filrstr 〔-y〕〔-q〕〔-｛t｜o｜r｝〕 〔-｛c｜l｝〕
         バックアップファイル名 〔/OpenTP1ファイル名〕
         OpenTP1ファイルシステム領域名

機能

filbkupコマンドでバックアップしたOpenTP1ファイルシステムをOpenTP1ファイルシステム領域にリストアします。

filrstrコマンドは，OpenTP1ファイルシステムをリストアする前にユーザに確認を求めますが，-yオプションを指定すると，確認を求めないですぐにリストアできます。

filrstrコマンドを実行できるのは，スーパユーザ，およびOpenTP1ファイルシステムを初期設定するユーザだけです。

また，OpenTP1ファイル名を指定してリストアすることもできますが，これは主に保守情報を取得するために行います。

オプション

●-y

ユーザに確認しないで，すぐにOpenTP1ファイルシステムをリストアします。

-yオプションの指定を省略すると，ユーザに確認してからOpenTP1ファイルシステムがリストアされます。

●-q

OpenTP1ファイルシステムのファイル管理情報を一括で書き込み，高速にリストアします。

●-｛t｜o｜r｝

リストア元のファイルとリストア先のOpenTP1ファイルシステムに，同じ名称のOpenTP1ファイルがあるときの動作を指定します。

-t

最終更新日時を比較して，リストア元のファイル上のOpenTP1ファイルの方が新しければ，OpenTP1ファイルをリストアします。

-o

同じ名称のOpenTP1ファイルについてはリストアしません。

-r

最終更新日時に関係なく，OpenTP1ファイルをリストアします。

●-｛c｜l｝

指定を省略，または-qオプションを指定すると，-cが仮定されます。

-c

OpenTP1ファイルシステム中のOpenTP1ファイルを他プロセス，または他ユーザが使用中の場合，OpenTP1ファイルシステムをリストアしません。

-l

OpenTP1ファイルシステム中のOpenTP1ファイルを他プロセス，または他ユーザ使用中の場合，使用中のOpenTP1ファイルはリストアしません。

コマンド引数

●バックアップファイル名　　～〈パス名〉

OpenTP1ファイルシステムをバックアップしたファイルの名称を指定します。

●OpenTP1ファイル名　　～〈OpenTP1ファイル名〉

リストアするOpenTP1ファイルの名称を指定します。

このコマンド引数を指定すると，指定したOpenTP1ファイルだけがリストアされます。

●OpenTP1ファイルシステム領域名　　～〈パス名〉

OpenTP1ファイルシステムをリストアするキャラクタ型スペシャルファイル名，または通常ファイル名を指定します。指定するキャラクタ型スペシャルファイル，または通常ファイルは，OpenTP1ファイルシステム用に初期設定しておく必要があります。

注意事項

filbkupコマンドを実行すると，プロセスの打ち切りなどでファイル管理テーブルが孤立している無効ファイルもバックアップします。filrstrコマンドで-rオプションを指定した場合，バックアップされた無効ファイルと同じ名称のファイルがあると，そのファイルを無効ファイルと置き換えてしまいます。このため，基本的に-tオプション，または-oオプションを指定してください。

OpenTP1ファイルシステム中のOpenTP1ファイルを他プロセス，または他ユーザが使用中の場合，OpenTP1ファイルシステムをリストアしません。強制的にリストアしたい場合は，-lオプションを指定してください。

リストア先のOpenTP1ファイルシステムを初期設定しないでfilrstrコマンドを実行すると，リストアする前にあったOpenTP1ファイルがfilrstrコマンド実行後も残ります。これは，OpenTP1ファイル単位にリストアされるためです。

バックアップファイルのレコード長がリストア先スペシャルファイルのセクタ長よりも短かった場合，またはバックアップファイルのレコード長がリストア先スペシャルファイルのセクタ長の倍数でなかった場合，そのファイルはリストアしないで，次のファイルのリストア処理を行います。

OpenTP1ファイルシステムが正常にバックアップできていなかった場合，警告メッセージを出力して，OpenTP1ファイルシステムのリストア処理を続けます。

4ギガバイトまでのOpenTP1ファイルシステムおよびOpenTP1ファイルに対応したfilbkupコマンドで作成したバックアップファイルを，4ギガバイト未対応のfilrstrコマンドで回復することはできません。また，4ギガバイト対応のOpenTP1ファイルシステムに対し，4ギガバイト未対応のfilbkupコマンドを使用した場合の動作は保証しません。

OSのkillコマンドの実行や，そのほかのエラーが要因となってfilrstrコマンドが異常終了すると，OpenTP1ファイルシステム全体として整合性が取れないため不正な状態となります。この場合，エラーの要因を取り除いてリストアし直す必要があります。
-qオプションを指定したfilrstrコマンドが異常終了した場合は，OpenTP1ファイルシステムの管理情報の復元がリストア処理の最後に行われ，そのファイルシステムはOpenTP1ファイルシステムとして認識されなくなります。その場合，OpenTP1ファイルシステムの初期設定からやり直してください。

filstatfs

名称

OpenTP1ファイルシステムの状態表示

形式

filstatfs 〔-w〕〔-S〕 OpenTP1ファイルシステム領域名

機能

指定したOpenTP1ファイルシステムの状態を標準出力に出力します。

オプション

●-w

OpenTP1ファイル管理領域開始位置を表示します。なお，このオプションは，適用OSがAIXの場合だけ指定できます。

●-S

ユーザ領域情報として，使用中領域と未使用領域（空き領域）の一覧を表示します。

コマンド引数

●OpenTP1ファイルシステム領域名　　～〈パス名〉

OpenTP1ファイルシステムがあるキャラクタ型スペシャルファイル名，または通常ファイル名を指定します。

出力形式

1：-wオプション指定時に表示されます。

2：-Sオプション指定時に表示されます。

aa...aa：filmkfsコマンドの-sオプションで指定したセクタ長

bb...bb：OpenTP1ファイルシステム中でユーザに割り当てられた領域の総容量

cc...cc：ユーザに割り当てられた領域の中で，未使用（OpenTP1ファイルとして割り当てられていない）領域の容量

dd...dd：一つのファイルとして確保できる容量の最大値（連続した空き領域のうち，管理情報（2セクタ長分）を除いた最大のサイズ）

ee...ee：filmkfsコマンドの-lオプションで指定した，作成できるファイルの上限数

ff...ff：すでに作成されたファイルの数

gg...gg：作成できるファイル数（最大作成可能ファイル数－作成済みファイル数）

hh...hh：断片化されたファイル領域数

ii...ii：OpenTP1ファイルシステムを初期設定したユーザのログイン名

jj...jj：OpenTP1ファイルシステムを初期設定した日時
曜日△月△日△時:分:秒△年（西暦）の形式

kk...kk：filmkfsコマンドで指定したOpenTP1ファイルシステム名

ll...ll：OpenTP1ファイル管理領域開始位置

mm...mm：ユーザ領域開始位置からのオフセット

nn...nn：ユーザ領域中の使用中または未使用の領域サイズ

oo...oo：ユーザ領域中の使用中または未使用の表示

used…使用中領域

unused…未使用領域

pp...pp：使用中領域に対応したOpenTP1ファイル名
未使用領域の場合は，"-"が表示されます。

出力メッセージ

メッセージID
内容
出力先

KFCA01536-E
コマンド引数の指定が誤っています
標準エラー出力

KFCA01551-I
ヘルプメッセージ
標準出力，
標準エラー出力

KFCA01570-E
ファイルとのバージョンが不整合です
標準エラー出力

KFCA01571-E
ファイルに対するアクセス権がありません
標準エラー出力

KFCA01572-E
オープン時に上限値オーバが発生しました
標準エラー出力

KFCA01574-E
指定したファイルのファイル名が長過ぎます
標準エラー出力

KFCA01575-E
指定したファイルがキャラクタ型スペシャルファイルまたは通常ファイルではないか，ファイルがあっても対応する装置がありません
標準エラー出力

KFCA01576-E
ファイルがOpenTP1ファイルシステムではありません
標準エラー出力

KFCA01582-E
メモリ不足が発生しました
標準エラー出力

KFCA01583-E
入出力エラーが発生しました
標準エラー出力

KFCA01599-E
異常が発生しました
標準エラー出力

注意事項

OpenTP1ファイルを作成する場合，作成に必要なサイズ以上の連続した空き領域が必要です。連続した空き領域のうち，最大のサイズは「dd...dd」で確認できます。-Sオプションを指定して実行すると，OpenTP1ファイルシステム内の連続領域の状況を確認できます。確認した情報を基に，必要に応じて不要なOpenTP1ファイルを削除することで，前後の空き領域と結合させたより大きなサイズの連続した空き領域を確保できます。

出力形式中にキロバイト[KB]で表示される値は小数点以下切り捨てです。したがって，-Sオプションでの一覧表示で，「OFFSET」＋「SIZE」の値が，次の領域の「OFFSET」と一致しない場合があります。

jnladdpf

名称

ジャーナル関係の物理ファイルの割り当て

形式

jnladdpf -j cpd -g ファイルグループ名 ｛-a 物理ファイル名｜
        -b 物理ファイル名｜-a 物理ファイル名 -b 物理ファイル名｝

機能

オンライン中に，チェックポイントダンプサービス定義に指定したファイルグループに，物理ファイルを割り当てます。jnladdpfコマンド入力後，jnlopnfgコマンドでオープンすると，ファイルグループはオンラインで使用できる状態になります。

すでに物理ファイルを割り当てているファイルグループに対してjnladdpfコマンドを入力すると，コマンドエラーとなります。

jnladdpfコマンドは，OpenTP1が動作中で，かつジャーナルサービスが動作中のときだけ入力できます。

オプション

●-j　cpd

チェックポイントダンプファイルに物理ファイルを割り当てます。

●-g　ファイルグループ名　　～〈1～8文字の識別子〉

物理ファイルを割り当てるファイルグループの名称を指定します。

チェックポイントダンプサービス定義に指定したファイルグループを指定してください。

●-a　物理ファイル名　　～〈1～63文字のパス名〉

ファイルグループに割り当てる物理ファイルの名称を，完全パス名で指定します。

チェックポイントダンプファイルを二重化している場合は，A系に物理ファイルを割り当てます。

●-b　物理ファイル名　　～〈1～63文字のパス名〉

ファイルグループに割り当てる物理ファイルの名称を，完全パス名で指定します。

チェックポイントダンプファイルを二重化している場合は，B系に物理ファイルを割り当てます。

チェックポイントダンプファイルを二重化していない場合に指定すると，エラーになります。

出力メッセージ

メッセージID
内容
出力先

KFCA01141-E
実行環境がジャーナルファイルレスモードのため，コマンドを実行できません
標準エラー出力

KFCA02191-E
-aオプションの指定が誤っています
標準エラー出力

KFCA02192-W
指定したファイルグループにはすでに物理ファイルが割り当てられています
標準エラー出力

KFCA02193-E
指定した物理ファイル名は正しくありません
標準エラー出力

KFCA02194-I
物理ファイルを割り当てました
メッセージログファイル

KFCA04128-I
ヘルプメッセージ
標準出力，
標準エラー出力

KFCA26001-E
-aまたは-bオプションの指定が誤っています
標準エラー出力

注意事項

チェックポイントダンプファイルを二重化する場合，A系，またはB系のどちらかの系だけの物理ファイルが割り当てられている状態では，ファイルグループをオープンできません。両方の系の物理ファイルを割り当ててください。

jnlardis

名称

リソースグループの接続の強制解除

形式

jnlardis -a アーカイブリソースグループ名
        -t ジャーナルリソースグループ名@ノード識別子 〔-p〕

機能

グローバルアーカイブジャーナルサービスのリソースグループとジャーナルサービスのリソースグループとの接続を強制的に解除します。

オプション

●-a　アーカイブリソースグループ名

グローバルアーカイブジャーナルサービスのリソースグループの名称を指定します。

●-t　ジャーナルリソースグループ名@ノード識別子

グローバルアーカイブジャーナルサービスのリソースグループとの接続を解除するジャーナルサービスのリソースグループの名称と，ノード識別子を@で連結したものを指定します。

●-p

ジャーナルサービスが計画停止したものと見なして，接続を解除します。

このオプションの指定を省略すると，ジャーナルサービスが正常終了したものと見なされて接続が解除されます。

注意事項

指定したジャーナルサービスのリソースグループがオンライン中の場合，jnlardisコマンドを実行して接続を解除したグローバルアーカイブジャーナルサービスのリソースグループとジャーナルサービスのリソースグループを，OpenTP1が再び接続し直すことがあります。

jnlarls

名称

アーカイブ状態の表示

形式

jnlarls 〔-Z〕

機能

グローバルアーカイブジャーナルサービスのリソースグループとジャーナルサービスのリソースグループの関係，およびアーカイブ状態を表示します。

オプション

●-Z

ヘッダ行を削除して状態を表示します。

このオプションの指定を省略すると，ヘッダ行が表示されます。

出力形式

1：-Zオプションを指定すると表示されません。

aaaaaaaa：アーカイブジャーナルノードの名称，または被アーカイブジャーナルノードの名称

bbb：ジャーナルサービス，またはグローバルアーカイブジャーナルサービスのファイル種別

sys…システムジャーナルファイル

jar…アーカイブジャーナルファイル

cccccccc：リソースグループ名（システムジャーナルサービス定義の定義ファイル名，またはアーカイブジャーナルサービス定義の定義ファイル名）

d：アーカイブ先識別子

＞…この記号の右がアーカイブジャーナルであることを示します。

＜…この記号の左がアーカイブジャーナルであることを示します。

e：接続状態（アーカイブ先識別子の右に示すサービス側が認識している状態）

c…接続中，またはサービス中

-…未接続（グローバルアーカイブジャーナルサービスの場合，過去に一度以上接続されていたことを示す），または初期状態

d…正常切断の出力完了待ち，または切断処理中

f…強制，またはサービス停止切断の出力完了待ち

i…接続処理中

n…未サービス

f：追い付き状態

w…バッファリング中

r…追い付き処理中

s…停止指示

-…アーカイバの場合に表示

gggggggg：アーカイブジャーナルランID（アーカイブ先識別子の右に示すサービス側が認識しているジャーナルサーバ側のランID）

アーカイブ先識別子が＞のとき…グローバルアーカイブジャーナルサービスがアーカイブ済み（出力）であるジャーナルサーバ側のランID

アーカイブ先識別子が＜のとき…ジャーナルサービスがアーカイブ中（転送中）であるジャーナルサーバ側のランID

hhhhhhhh：アーカイブジャーナル世代番号（アーカイブ先識別子の右に示すサービス側が認識しているジャーナルサーバ側の世代番号）

アーカイブ先識別子が＞のとき…グローバルアーカイブジャーナルサービスがアーカイブ済み（出力）であるジャーナルサーバ側の世代番号

アーカイブ先識別子が＜のとき…ジャーナルサービスがアーカイブ中（転送中）であるジャーナルサーバ側の世代番号

iiiiiiii：アーカイブジャーナルブロック番号（アーカイブ先識別子の右に示すサービス側が認識しているジャーナルサーバ側のブロック番号）

アーカイブ先識別子が＞のとき…グローバルアーカイブジャーナルサービスがアーカイブ済み（出力）であるジャーナルサーバ側のブロック番号

アーカイブ先識別子が＜のとき…ジャーナルサービスがアーカイブ中（転送中）であるジャーナルサーバ側のブロック番号

出力メッセージ

メッセージID
内容
出力先

KFCA01141-E
実行環境がジャーナルファイルレスモードのため，コマンドを実行できません
標準エラー出力

KFCA01280-E
jnlarlsコマンドの処理が失敗しました
標準エラー出力

KFCA01281-E
jnlarlsコマンドの入力形式が誤っています
標準エラー出力

KFCA04127-I
ヘルプメッセージ
標準出力，
標準エラー出力

注意事項

次に示す場合にjnlarlsコマンドを実行すると，正しい状態が表示されないことがあります。

システムジャーナルファイルのジャーナルデータをアーカイブジャーナルファイルに転送中で，アーカイブジャーナルファイルの状態が変更されている場合

jnlarlsコマンドで表示される接続状態は，相手ノードが異常終了，または強制停止しても，変わりません。

jnlatunl

名称

自動アンロード機能の制御

形式

jnlatunl -j sys 〔｛-i｜-b｜-t〔-w〕｝〕

機能

自動アンロード機能を制御します。次の制御ができます。

自動アンロード機能の動作状態を表示します。

OpenTP1稼働中に，停止した自動アンロード機能を再開始します。

実行中の自動アンロード機能を中断します。

オプション

●-j sys

システムジャーナルファイルに対して操作することを示します。このオプションは必ず指定してください。

●-i

自動アンロード機能の動作状態を表示する場合に指定します。

●-b

OpenTP1稼働中に，自動アンロード機能を再開始する場合に指定します。再開始直後のアンロードジャーナルファイル格納ディレクトリには，前回稼働時の最後に使用していたディレクトリを使用します。

●-t

自動アンロード機能を中断する場合に指定します。実行中のアンロードは強制終了します。

●-w

-tオプションを指定して自動アンロード機能を中断する場合に，アンロードを実行中の世代に対するアンロードが完了するまでは，コマンドの終了を遅延させるときに指定します。このオプションは，-tオプションを指定したときだけ有効です。なお，-tオプションを指定して-wオプションを省略した場合は，jnlatunlコマンドを実行した時点で自動アンロード機能を中断し，実行中のアンロードを強制終了します。

このオプションを指定すると，アンロード完了の最大応答待ち時間は，約9時間（32768秒）となります。この時間を経過してもアンロードが完了しない場合は，その時点で自動アンロード機能を中断し，実行中のアンロードを強制終了します。

出力形式

●-iオプションを指定した場合

状態      アンロード中ファイルグループ   アンロード先ディレクトリ
aa....aa  bb....bb                       cc....cc
現用世代情報
ファイルグループ  世代番号    ランID       アンロード時ファイル名
dd....dd          ee....ee    ff....ff     gg....gg

aa...aa
自動アンロード機能の動作状態

ACTIVE：動作中

STOP：停止中

STOPPING：コマンド停止時，または自動アンロードの処理終了応答待ち

－：自動アンロード機能を使用できない状態

bb....bb
現在アンロード中のシステムジャーナルファイルのファイルグループ名。アンロード中でない場合，********が表示されます。

cc....cc
使用中のアンロードジャーナルファイル格納ディレクトリ名

dd....dd
現用世代のシステムジャーナルファイルのファイルグループ名

ee....ee
現用世代のシステムジャーナルファイルの世代番号

ff....ff
現用世代のシステムジャーナルファイルのランID

gg....gg
現用世代を自動アンロードしたときに作成したファイル名

出力メッセージ

メッセージID | 内容 | 出力先
KFCA01141-E | 実行環境がジャーナルファイルレスモードのため，コマンドを実行できません | 標準エラー出力
KFCA01160-I | ジャーナルユティリティサービスを開始しました | メッセージログファイル
KFCA01161-I | ジャーナルユティリティサービスを終了しました | メッセージログファイル
KFCA01162-E | ジャーナルユティリティサービスを開始できません | 標準エラー出力
KFCA01163-W | ジャーナルユティリティサービスの終了中に障害が発生しましたが，このまま続行します | メッセージログファイル
KFCA01168-W | アンロードを中止します | メッセージログファイル
KFCA01169-W | 定義句に誤りがあります。ジャーナルファイルの自動アンロード機能を使用しないモードで起動します | メッセージログファイル
KFCA01170-I | ジャーナルファイルの自動アンロードを開始しました | 標準エラー出力
KFCA01171-I | ジャーナルファイルの自動アンロードを開始します | メッセージログファイル
KFCA01172-I | ジャーナルファイルの自動アンロードが完了しました | メッセージログファイル
KFCA01173-W | ジャーナルファイルの自動アンロード機能を停止しました | メッセージログファイル
KFCA01174-W | 自動アンロード処理中ですが，処理を中断します | メッセージログファイル
KFCA01175-I | 自動アンロード処理の終了を待ち合わせています | メッセージログファイル
KFCA01176-I | 自動アンロード先ディレクトリに設定します | メッセージログファイル
KFCA01177-E | 自動アンロードでファイルに障害が発生しました | メッセージログファイル
KFCA01178-E | 自動アンロードの処理中に障害が発生しました | メッセージログファイル
KFCA01179-W | 自動アンロード先ディレクトリを切り替えることができません | メッセージログファイル
KFCA01299-I | ヘルプメッセージ | 標準出力

注意事項

システムの実行環境が自動アンロード機能を使用しない環境の場合，-bオプション，および-tオプションは指定できません。

-bオプションで自動アンロード機能の再開始を指示した場合に，コマンドが正常に終了しても，自動アンロードプロセスの障害などによって自動アンロード機能が開始されていないときがあります。自動アンロード機能が正しく開始されているかは-iオプションを指定して確認してください。

jnlatunlコマンドで-tまたは-wオプションを指定して，自動アンロード処理の終了待ちの場合に，OpenTP1が異常終了または強制停止したとき，jnlatunlコマンドは正常に終了しないでolkcrt2でアボートします。ただし，オンラインへの影響はありません。また，OpenTP1を再起動する必要はありません。

jnlchgfg

名称

ジャーナル関係のファイルのステータス変更

形式

jnlchgfg -j sys｜jar 〔-r リソースグループ名〕
        -g ファイルグループ名 〔-d サービス定義名〕
      〔-S〕

機能

指定したファイルグループを強制的にアンロード済み状態にします。ただし，現用ファイルグループのステータス変更はできません。

また，アーカイブジャーナルファイルのアーカイブ待ち状態を強制的にアーカイブ済み状態にできます。

オプション

●-j　sys｜jar

ステータスを変更するジャーナル関係のファイルを指定します。

　sys：システムジャーナルファイル

　jar：アーカイブジャーナルファイル

●-r　リソースグループ名　　～〈1～8文字の識別子〉

対象とするリソースグループの名称を指定します。

-jオプションでsysを指定している場合，システムジャーナルサービス定義の定義ファイル名を指定します。

jオプションでjarを指定している場合，ステータスを変更するアーカイブジャーナルサービス定義の定義ファイル名を指定します。

このオプションの指定を省略すると，-jオプションでsysを指定している場合は，$DCCONFPATH/jnlのジャーナルサービス定義で指定したソースグループ名が仮定されます。jオプションでjarを指定している場合は，$DCCONFPATH/jarのグローバルアーカイブジャーナルサービス定義の定義コマンドjnldfsv -aの先頭に定義したアーカイブジャーナルサービス定義の定義ファイル名が仮定されます。

●-g　ファイルグループ名　　～〈1～8文字の識別子〉

ステータスを変更するシステムジャーナルファイルのファイルグループ名を指定します。

●-d　サービス定義名　　～〈パス名〉または〈ファイル名〉

ステータスを変更するファイルグループを定義しているシステムジャーナルサービス定義ファイル名を，次のどちらかで指定します。

/（ルート）で始まる完全パス名で指定

定義ファイル名だけで指定
定義ファイル名だけで指定する場合，$DCCONFPATHに定義ファイルが格納されているディレクトリを設定しておく必要があります。

このオプションの指定を省略すると，-rオプションの指定に従います。

●-S

アーカイブ待ち状態をアーカイブ済み状態に変更します。

システムジャーナルサービス定義でjnl_arc_check_level=2を指定した場合は，アーカイブジャーナルファイルをアンロードおよびアーカイブしないと，そのファイルグループは再使用できません。アーカイブジャーナルサービスに異常が発生して，アーカイブできなくなった場合にこのオプションを指定すると，強制的にアーカイブ済み状態になるのでシステムを続行できます。

ただし，強制的にアーカイブ済み状態にしたファイルグループがその後，スワップ先のファイルグループになった場合は，アーカイブジャーナルサービスが正常に戻ってもそのファイルグループをアーカイブすることはできません。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA01141-E | 実行環境がジャーナルファイルレスモードのため，コマンドを実行できません | 標準エラー出力

注意事項

jnlchgfgコマンドは，ジャーナルサービス開始中に実行してはなりません。ジャーナルサービス開始中とは，正常開始時はKFCA01100-IからKFCA01102-Iまで，再開始時はKFCA01101-IからKFCA01102-Iまでのことです。実行した場合，システムジャーナルファイルの状態がOpenTP1に反映されないことがあります。この場合，ジャーナルサービス開始，再開始処理完了後にjnlclsfgコマンドで該当するファイルグループをクローズし，その後，jnlopnfgコマンドでオープンすると，システムジャーナルファイルの状態が反映されます。

jnlchgfgコマンドは，定義ファイルを参照して実行されます。そのため，ジャーナルを取得したオンライン時とjnlchgfgコマンド実行時の定義ファイルが一致していないと，ステータスをきちんと変更できません。

ジャーナルを取得したオンライン時とjnlchgfgコマンド実行時の定義ファイルが異なる場合，-d，-rオプションを指定します。バックアップ先のディレクトリが$DCCONFPATHでないときは-dオプションを指定し，ファイル名が変更されたときは-rオプションを指定してください。ただし，この場合でもシステムジャーナルサービス定義，またはアーカイブジャーナルサービス定義は，ジャーナルを取得したオンライン時の定義がバックアップされている必要があります。

OpenTP1停止直後には，jnlchgfgコマンドを入力しないでください。コマンドが中断するおそれがあります。

jnlclsfg

名称

ジャーナル関係のファイルのクローズ

形式

jnlclsfg -j sys｜cpd｜jar 〔-s サーバ名〕〔-r リソースグループ名〕
        -g ファイルグループ名 〔-e 要素ファイル名〕〔-a〕〔-b〕

機能

指定したファイルグループを構成するオープン中の物理ファイルをクローズし，オンラインで使用しないようにします。ただし，次のファイルグループを構成する物理ファイルはクローズできません。

現用，および上書きできない状態のシステムジャーナルファイル，またはアーカイブジャーナルファイル

書き込み中，および上書きできない状態のチェックポイントダンプファイル

なお，jnlclsfgコマンドは，OpenTP1が動作中で，かつジャーナルサービスが動作中のときだけ入力できます。

オプション

●-j　sys｜cpd｜jar

クローズするジャーナル関係のファイルを指定します。

　sys：システムジャーナルファイル

　cpd：チェックポイントダンプファイル

　jar：アーカイブジャーナルファイル

●-s　サーバ名　　～〈1～8文字の識別子〉

チェックポイントダンプファイルをクローズするとき，対象となるサーバの名称を指定します。サーバ名を指定することによって，ファイルグループ名の検索範囲を限定できます。

このオプションの指定を省略すると，すべてのサーバのチェックポイントダンプファイルでファイルグループ名と一致するもののうち，最初に見つけたものをクローズします。

-jオプションでcpd以外を指定している場合，-sオプションの指定は無視されます。

●-r　リソースグループ名　　～〈1～8文字の識別子〉

-jオプションでjarを指定している場合，クローズするファイルのリソースグループの名称を指定します。グローバルアーカイブジャーナルサービス定義の定義コマンドjnldfsv -aで指定したアーカイブジャーナルサービス定義の定義ファイル名を指定してください。

このオプションの指定を省略すると，オンライン中のアーカイブジャーナルファイルのうちから，アーカイブジャーナルサービス定義の定義コマンドjnldfsv -aの先頭に定義したファイル名が仮定されます。

-jオプションでjar以外を指定している場合，-rオプションの指定は無視されます。

●-g　ファイルグループ名　　～〈1～8文字の識別子〉

クローズするジャーナル関係のファイルのファイルグループ名を指定します。

●-e　要素ファイル名

クローズするジャーナル関係のファイルのファイルグループ中の，要素ファイルの名称を指定します。

●-a

A系の物理ファイルをクローズ対象とします。

●-b

B系の物理ファイルをクローズ対象とします。

二重化していないときに指定すると，コマンドエラーとなります。

上記の-a，-bオプションを両方とも省略した場合，次のようになります。

二重化していない場合は，-aオプションを指定した場合と同様に，A系の物理ファイルをクローズ対象とします。

二重化している場合は，-a，-bオプションを同時に指定した場合と同様に，A系，B系両方の物理ファイルをクローズ対象とします。

片系運転不可の二重化の運用では，-j cpdの指定に，-aまたは-bオプションのどちらかを指定するとコマンドエラーになります。

なお，クローズ対象となる物理ファイルがすべてクローズ済みのときは，警告メッセージ（KFCA01283-W，またはKFCA02168-W）を出力します。ただし，コマンドエラーにはなりません（コマンド終了コードは0）。

出力メッセージ

メッセージID
内容
出力先

KFCA01141-E
実行環境がジャーナルファイルレスモードのため，コマンドを実行できません
標準エラー出力

KFCA01216-I
ファイルグループのクローズが成功しました
メッセージログファイル

KFCA01280-E
jnlclsfgコマンドの処理が失敗しました
標準エラー出力

KFCA01281-E
jnlclsfgコマンドの入力形式が誤っています
標準エラー出力

KFCA01283-W
jnlclsfgコマンド実行中に軽度エラーが発生しました
標準エラー出力

KFCA01285-E
スワップ処理中です
標準エラー出力

KFCA01295-I
ヘルプメッセージ
標準出力，
標準エラー出力

KFCA02128-E
指定したサーバ名が誤っています
標準エラー出力

KFCA02129-E
指定したファイルグループ名が誤っています
標準エラー出力

KFCA02130-E
-sオプションの指定が誤っています
標準エラー出力

KFCA02131-E
-gオプションの指定が誤っています
標準エラー出力

KFCA02132-E
障害が発生してjnlclsfgコマンドの処理を中止しました
標準エラー出力

KFCA02168-W
指定したファイルグループはクローズ済みです
標準エラー出力

KFCA02170-E
ファイルのクローズに失敗しました
標準エラー出力

KFCA02184-E
ファイルグループの数が不足しているためクローズできません
標準エラー出力

注意事項

jnlclsfgコマンドをスワップ処理中，またはほかの運用コマンドの処理中に入力すると，エラーとなることがあります。

jnlcolc

名称

ファイル回復用ジャーナルの集積

形式

jnlcolc -k 回復種別 〔-f〕〔-l〕〔-n〕〔-m〕
     〔-i オンラインバックアップ情報名〕〔-c キー〕
     〔ファイル名〔△ファイル名〕…〕

機能

指定したファイルから，DAMファイル，TAMファイル，またはISAMファイルの回復に必要なジャーナルレコードを抽出し，標準出力に出力します。集積結果をリダイレクトしてファイルに出力することもできます。

オプション

●-k　回復種別

回復対象とするファイル種別を指定します。

　d：DAMファイル

　t：TAMファイル

　i：ISAMファイル

●-f

最初のファイルから，ファイルの回復に必要なジャーナルを抽出します。このとき，ジャーナルファイルの先頭ブロック番号が1から昇順に連番であることをチェックします。エラーであれば処理を終了します。

このオプションの指定を省略すると，前回のジャーナルレコード抽出処理からの引き継ぎがあるものとして，引き継ぎファイルの最終ブロック番号＋1から昇順に連番であることがチェックされます。エラーであれば処理を終了します。

●-l

最後のファイルから，ファイルの回復処理に必要なジャーナルを抽出します。その後，引き継ぎファイルを削除します。

このオプションを指定してファイル回復用ジャーナルを集積した場合，別オンラインのジャーナル集積時には，必ず-fオプションを指定してください。

このオプションの指定を省略すると，引き継ぎファイルは削除されません。

●-n

トランザクション内の同一論理ファイル，同一相対ブロック番号の更新情報があっても，すべてのFJレコードを出力します（FJの更新前と更新後の情報のチェック，および重複情報の削除はしません）。

このオプションの指定を省略すると，トランザクション内に同一論理ファイル，同一相対ブロック番号の更新情報があった場合，最終の更新情報だけが出力されます。

このオプションは，回復種別がDAMファイルの場合だけ有効です。

●-m

ファイルの回復に必要なジャーナルレコードをファイル上で集積します。

このオプションを指定すると，-nオプションを指定したと見なします。

このオプションの指定を省略すると，メモリ上にバッファが確保されて，ジャーナルレコードが集積されます。

●-i　オンラインバックアップ情報名

指定したファイルからファイル回復用ジャーナルの集積開始情報を取得し，開始位置以前のレコードをスキップします。

このオプションの指定は，-kオプションにd，またはt（回復種別にDAMファイル，またはTAMファイル）を指定した場合だけ有効です。

このオプションの指定を省略すると，ファイルの先頭からファイル回復用ジャーナルが集積されます。

●-c　キー　 ～((001～999))《001》

引き継ぎファイルの名称の一部を指定します。実際は，OpenTP1が「jnlcolc***」という名称でファイルを作成し，***にはこのオプションで指定した値が設定されて，引き継ぎファイルの名称となります。

コマンド引数

●ファイル名　　～〈パス名〉

ファイルの回復に必要なジャーナルレコードがあるファイルの名称を指定します。マルチノード機能を使用している場合は，jnlsortコマンドでソート，およびマージ（ノードの抽出，ジャーナルサーバランIDの特定）した結果のファイル名を指定してください。

マルチノード機能を使用していない場合は，アンロードジャーナルファイルの名称を指定してください。

複数のファイルを指定するときは，ファイル名とファイル名との間を空白で区切ります。指定できるファイル数は256個までです。

このコマンド引数の指定を省略すると，標準入力と見なされます。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA02600-E | アンロードジャーナルファイルのアクセスでエラーが発生しました | 標準エラー出力
KFCA02601-E | アンロードジャーナルファイルが不正です | 標準エラー出力
KFCA02602-E | ジャーナルブロックが不正です | 標準エラー出力
KFCA02603-E | ジャーナルレコードが不正です | 標準エラー出力
KFCA02604-E | メモリが確保できません | 標準エラー出力
KFCA02605-E | 引き継ぎファイルのアクセスでエラーが発生しました | 標準エラー出力
KFCA02606-E | 引き継ぎファイルが不正です | 標準エラー出力
KFCA02607-E | 引き継ぎファイルとアンロードジャーナルファイルの関係が不正です | 標準エラー出力
KFCA02621-W | 出力するファイル回復対象レコードがありません | 標準エラー出力
KFCA02650-I | ヘルプメッセージ | 標準出力，標準エラー出力
KFCA02651-E | jnlcolcコマンドのパラメタ不正，または制限値オーバです | 標準エラー出力
KFCA02652-E | jnlcolcコマンドのオプションの組み合わせが不当です | 標準エラー出力
KFCA02653-E | jnlcolcコマンドのオプションの指定に誤りがあります | 標準エラー出力
KFCA02654-E | jnlcolcコマンドのファイル名の指定に誤りがあります | 標準エラー出力
KFCA02655-E | jnlcolcコマンドで更新前後情報の不一致を検出しました | 標準エラー出力
KFCA02657-E | jnlcolcコマンドの-kオプションの指定がありません | 標準エラー出力
KFCA02658-E | jnlcolcコマンドでファイル回復対象レコードが不正です | 標準エラー出力

注意事項

jnlcolcコマンドで指定した引き継ぎファイルがすでにある場合は，既存のファイルを「jnlcolc***.bak」という名称で残します。

複数のジャーナルファイルを集積する場合，同一オンライン中に出力されたジャーナルファイルである必要があります。1ファイルでも異なる場合は，処理を終了します。

出力するジャーナルレコードは，次の種類です。
DAMファイル回復時
　FJ：ファイル（DAM）の更新情報
　HJ：トランザクションの仮同期点情報
　PJ：トランザクションのコミット処理開始情報
　DJ：ヒューリスティック決定情報
　BJ：トランザクションのロールバック情報
TAMファイルの回復時
　CJ：回復対象テーブルの更新情報
　HJ：トランザクションの仮同期点情報
　PJ：トランザクションのコミット処理開始情報
　DJ：ヒューリスティックの決定情報
　BJ：トランザクションのロールバック情報
ISAMファイル回復時
　FJ：ファイル（ISAM）の更新情報
　HJ：トランザクションの仮同期点情報
　PJ：トランザクションのコミット処理開始情報
　DJ：ヒューリスティック決定情報
　BJ：トランザクションのロールバック情報

jnlcolcコマンドを複数回実行して，複数のアンロードジャーナルファイルからジャーナルレコードを集積する場合，-k，-n，-cオプションの指定値は，それぞれのjnlcolcコマンドですべて同じにしてください。

アンロードジャーナルファイル名，またはグローバルアーカイブアンロードジャーナルファイル名の指定を省略すると，標準入力からの入力となります。そのため，入力ファイルをパイプ，リダイレクションなどで指定してください。

メモリ確保エラーが発生した場合，-mオプション指定のjnlcolcコマンドを再び入力してください。この場合，ファイル上でジャーナルレコードを集積するため，処理速度が遅くなります。なお，ファイル名省略時は，-mオプションは指定しないでください。

jnlcolcコマンドは，ファイル（DAM，TAM，またはISAMファイル）回復コマンド，およびjnlsortコマンドとともに使用して，ファイルを回復するためのコマンドです。なお，ISAMファイルの回復コマンドについては，マニュアル「索引順編成ファイル管理 ISAM」を参照してください。

複数のジャーナルファイルを集積する場合，ファイル名称を時系列に指定してください。時系列でない場合，ジャーナルファイル不正でエラーメッセージ（KFCA02601-E）を出力して処理を終了します。

jnlunlfgコマンドに-tオプションを指定して取得したアンロードジャーナルファイルを指定しないでください。指定した場合，KFCA02601-Eメッセージが出力されます。

このコマンドで入力できる文字数はご使用のOSによって変わります。入力文字数が上限値を超えるとエラーになります。

指定したファイル数が256個以下の場合でも，1プロセスでオープンできるファイルの最大数を超えるとエラーになります。

使用例

使用例を示します。世代番号は1，2…とします。

アンロードジャーナルファイル：sysjnl001，sysjnl002，…

ファイル分割していないアンロードジャーナルファイルから，DAM FRC用のジャーナルレコードを集積する場合

jnlcolc -k d -f -l /tp1/jnl/sysjnl001

三つのファイルに分割しているアンロードジャーナルファイルから，TAM FRC用のジャーナルレコードを1回で集積する場合

jnlcolc -k t -f -l /tp1/jnl/sysjnl001 /tp1/jnl/sysjnl002/tp1/jnl/sysjnl003

四つのファイルに分割しているアンロードジャーナルファイルから，DAM FRC用のジャーナルレコードを3回で集積する場合

〈1回目〉
jnlcolc -k d -f /tp1/jnl/sysjnl001 /tp1/jnl/sysjnl002
〈2回目〉
jnlcolc -k d /tp1/jnl/sysjnl003
〈3回目〉
jnlcolc -k d -l /tp1/jnl/sysjnl004

jnlcopy

名称

アンロードジャーナルファイルの複写

形式

jnlcopy 〔-t〔開始〕〔,終了〕〔-j レコード種別〔レコード種別〕…〕
       〔-o ジャーナル取得モード〔ジャーナル取得モード〕…〕
       〔アンロードジャーナルファイル名
       〔△アンロードジャーナルファイル名〕…〕

機能

指定したアンロードジャーナルファイル内の情報を，標準出力に出力します。

マルチノード機能を使用している場合，jnlcopyコマンドは使用できません。

オプション

●-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からの西暦を4けたで指定します）

指定を省略できます。※

注※

開始，または終了の「年」の指定を省略した場合は，当年の指定月日時刻と見なされます。「年，月，日」の指定を省略した場合，当年当月当日の指定時刻と見なされます。「月，日」，「月」，または「日」だけを省略することはできません。省略した場合はオプションエラーになります。「月」または「日」を省略したい場合は，「年」，「月」，「日」のすべてを省略してください。

-tオプションの指定を省略すると，指定したファイル内のすべての情報を編集出力します。

●-j　レコード種別

複写する内容をジャーナルレコード種別で指定します。

複数のレコード種別を指定できます。

レコード種別の指定値と内容を次に示します。

レコード種別 | 指定値 | 内容 | 備考
PJ | p | トランザクションのコミット処理開始情報 | 同期点ジャーナル
HJ | h | トランザクションの仮同期点情報
BJ | b | トランザクションのロールバック情報
TJ | t | トランザクションの同期点処理終了情報
DJ | d | ヒューリスティック決定情報
FJ | f | DAMファイルの更新情報 | 回復用ジャーナル
CJ | c | 回復対象テーブルの更新情報
XJ | x | システムサービス固有回復情報
SJ | s | システム統計情報 | 統計用ジャーナル
AJ | a | 送信完了情報
IJ | i | 入力キュー登録メッセージ
OJ | o | 出力キュー登録メッセージ
MJ | m | メッセージジャーナル
GJ | g | receive情報
UJ | u | ユーザ任意の情報 | ユーザジャーナル

-tオプションを指定し，-jオプションの指定を省略すると，指定した範囲内のすべてのジャーナルレコードが複写されます。

-tオプションの指定を省略し，-jオプションを指定すると，指定したレコード種別と同じジャーナルレコード種別のアンロードジャーナルファイルがすべて複写されます。

-t，および-jオプションの指定を省略すると，アンロードジャーナルファイル内のすべての情報が出力されます。

●-o　ジャーナル取得モード

ジャーナルの取得モードを指定します。複数のジャーナル取得モードを指定できます。

c

トランザクションテストモードでコミット属性のジャーナル，またはMCFのトランザクション外テストモードのジャーナルを複写します。

r

トランザクションテストモードでロールバック属性のジャーナルを複写します。

s

オンラインテストモード以外のジャーナルを複写します。

このオプションの指定を省略すると，すべてのジャーナル取得モードのジャーナルが複写されます。

コマンド引数

●アンロードジャーナルファイル名　　～〈パス名〉

アンロードジャーナルファイルの名称を指定します。

複数のアンロードジャーナルファイルを指定するときは，アンロードジャーナルファイル名とアンロードジャーナルファイル名との間を空白で区切ります。指定できるファイル数は256個までです。

このコマンド引数の指定を省略すると，標準入力と見なされます。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA02600-E | アンロードジャーナルファイルのアクセスでエラーが発生しました | 標準エラー出力
KFCA02601-E | アンロードジャーナルファイルが不正です | 標準エラー出力
KFCA02602-E | ジャーナルブロックが不正です | 標準エラー出力
KFCA02603-E | ジャーナルレコードが不正です | 標準エラー出力
KFCA02604-E | メモリが確保できません | 標準エラー出力
KFCA02620-W | 対象レコードが存在しません | 標準エラー出力
KFCA02630-I | ヘルプメッセージ | 標準エラー出力
KFCA02631-E | jnlcopyコマンドのパラメタ不正，または制限値オーバです | 標準エラー出力
KFCA02632-E | jnlcopyコマンドのオプションの組み合わせが不当です | 標準エラー出力
KFCA02633-E | jnlcopyコマンドのオプションの指定に誤りがあります | 標準エラー出力
KFCA02634-E | jnlcopyコマンドのファイル名の指定に誤りがあります | 標準エラー出力

注意事項

複写範囲を指定する場合，開始時刻，または終了時刻と一致するジャーナルレコードがないときは，開始時刻と終了時刻の間にあるジャーナルレコードが複写対象になります。

複写対象のジャーナルレコードがない場合，エラーメッセージを出力して処理を終了します。

開始時刻が終了時刻より遅くなるように複写範囲を指定するときは，必ず「月」「日」，または「月」「日」「年（西暦）」を指定して，終了時刻が開始時刻よりあとになるようにしてください。省略するとエラーになります。日付を省略すると，jnlcopyコマンドを入力した年月日と見なすため，複写範囲が該当する年月日以外の日付の場合は，必ず「月」「日」，または「月」「日」「年（西暦）」を指定してください。

複数のアンロードジャーナルファイルを指定する場合は，それらのファイルが，同一オンライン中に出力されたアンロードジャーナルファイルで，世代番号が連続していなければなりません。

アンロードジャーナルファイル名の指定を省略すると，標準入力からの入力となります。そのため，入力ファイルをパイプ，リダイレクションなどで指定してください。

jnlcopyコマンドの出力情報は，ほかの運用コマンドの入力情報となります。そのため，jnlcopyコマンドでは，ファイル，ブロック，レコードの各管理情報も出力します。

このコマンドで入力できる文字数はご使用のOSによって変わります。入力文字数が上限値を超えるとエラーになります。

指定したファイル数が256個以下の場合でも，1プロセスでオープンできるファイルの最大数を超えるとエラーになります。

使用例

アンロードジャーナルファイルの先頭から，1993年5月29日17時30分0.999999秒までの情報を出力する場合

アンロードジャーナルファイル：sysjnl001，sysjnl002

jnlcopy -t ,17300005291993 /tp1/jnl/sysjnl001 /tp1/jnl/sysjnl002

jnldelpf

名称

ジャーナル関係の物理ファイルの削除

形式

jnldelpf -j cpd -g ファイルグループ名 〔-a〕 〔-b〕

機能

オンライン中に，指定したファイルグループから物理ファイルを削除します。削除できる物理ファイルは，jnladdpfコマンドでオンライン中に割り当てた物理ファイルのうち，オープンされていない物理ファイルまたは閉塞状態の物理ファイルです。それ以外の物理ファイルを削除しようとすると，エラーとなります。

jnldelpfコマンドは，OpenTP1が動作中で，かつジャーナルサービスが動作中のときだけ入力できます。

オプション

●-j　cpd

チェックポイントダンプファイルのファイルグループから，物理ファイルを削除します。

●-g　ファイルグループ名　　～〈1～8文字の識別子〉

物理ファイルを削除するファイルグループの名称を指定します。

●-a

A系の物理ファイルを削除します。

●-b

B系の物理ファイルを削除します。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA01141-E | 実行環境がジャーナルファイルレスモードのため，コマンドを実行できません | 標準エラー出力
KFCA26001-E | -aまたは-bオプションの指定が誤っています | 標準エラー出力
KFCA26002-E | 指定したファイルグループには該当する物理ファイルが割り当てられていません | 標準エラー出力
KFCA26003-I | ファイルグループから物理ファイルを切り離しました | メッセージログファイル
KFCA26010-E | 指定したファイルグループからは物理ファイルを切り離せません | 標準エラー出力

jnledit

名称

アンロードジャーナルファイル，またはグローバルアーカイブアンロードジャーナルファイルの編集出力

形式

jnledit 〔-e 編集種別〕〔-t〔開始〕〔,終了〕〕
       〔-j レコード種別〔レコード種別〕…〕〔-s サーバ名〕
       〔-v サービス名〕
       〔-u トランザクショングローバル識別子
                              〔,トランザクションブランチ識別子〕〕
       〔-o ジャーナル取得モード〔ジャーナル取得モード〕…〕
       〔-m 論理端末名称〔，論理端末名称〕…〕
       〔-w けた〕〔-l 行〕〔-c〕
       〔ファイル名〔△ファイル名〕…〕

機能

指定したアンロードジャーナルファイル，またはグローバルアーカイブアンロードジャーナルファイル内の情報を編集し，標準出力へ出力します。

オプション

●-e　編集種別　　～《f》

編集種別を指定します。

　r：レコード単位で編集します。

　b：ブロック単位で編集します。

　f：ファイル情報一覧を出力します。

●-t　〔開始〕〔，終了〕

編集範囲を指定します。開始には，編集出力を開始する時刻を指定します。終了には，編集出力を終了する時刻を指定します。

-eオプションでrを指定した場合は，ジャーナルレコードを出力する時刻で指定します。-eオプションでbを指定した場合は，ジャーナルブロックを出力する時刻を指定します。

開始は，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からの西暦を4けたで指定します）

指定を省略できます。※

注※

開始，または終了の「年」の指定を省略した場合は，当年の指定月日時刻と見なされます。「年，月，日」の指定を省略した場合，当年当月当日の指定時刻と見なされます。「月，日」，「月」，または「日」だけを省略することはできません。省略した場合はオプションエラーになります。「月」または「日」を省略したい場合は，「年」，「月」，「日」のすべてを省略してください。

-tオプションの指定を省略すると，指定したファイル内のすべての情報を編集出力します。

●-j　レコード種別

編集する内容をジャーナルレコード種別で指定します。

レコード種別の指定値と内容を次に示します。

レコード種別 | 指定値 | 内容 | 備考
PJ | p | トランザクションのコミット処理開始情報 | 同期点ジャーナル
HJ | h | トランザクションの仮同期点情報
BJ | b | トランザクションのロールバック情報
TJ | t | トランザクションの同期点処理終了情報
DJ | d | ヒューリスティック決定情報
FJ | f | DAMファイルの更新情報 | 回復用ジャーナル
CJ | c | 回復対象テーブルの更新情報
XJ | x | システムサービス固有回復情報
SJ | s | システム統計情報 | 統計用ジャーナル
AJ | a | 送信完了情報
IJ | i | 入力キュー登録メッセージ
OJ | o | 出力キュー登録メッセージ
MJ | m | メッセージジャーナル
GJ | g | receive情報
UJ | u | ユーザ任意の情報 | ユーザジャーナル

-jオプションの指定を省略すると，すべてのジャーナルレコード種別が編集対象になります。

●-s　サーバ名　　～〈1～8文字の英数字〉

編集する内容をサーバ名で指定します。

このオプションは，レコード種別がcの場合に有効になります。指定されたサーバ名に一致するCJが編集対象ですが，そのCJにトランザクション識別子が設定されていれば，その情報を基に同じトランザクション識別子を持つ別の種別のレコードもさらに編集対象となります。トランザクション識別子で別のレコードも編集出力したい場合には，-jオプションで，対象とするレコード種別をあわせて指定します。

-sオプションの指定を省略すると，すべてのサーバが編集対象になります。

●-v　サービス名　　～〈1～31文字の英数字〉

編集する内容をサービス名で指定します。

このオプションは，レコード種別がcの場合に有効になります。指定されたサービス名に一致するCJが編集対象ですが，そのCJにトランザクション識別子が設定されていれば，その情報を基に同じトランザクション識別子を持つ別の種別のレコードもさらに編集対象となります。トランザクション識別子で別のレコードも編集出力したい場合には，-jオプションで，対象とするレコード種別をあわせて指定します。

-vオプションの指定を省略すると，すべてのサービスが編集対象になります。

●-u　トランザクショングローバル識別子〔，トランザクションブランチ識別子〕

～〈33けたの英数字，特殊文字，および16進数字〉

編集する内容をトランザクション識別子で指定します。トランザクション識別子は「トランザクショングローバル識別子，トランザクションブランチ識別子」の形式で指定します。

-uオプションの指定を省略すると，すべてのトランザクション識別子を編集出力します。

●-o　ジャーナル取得モード

ジャーナルの取得モードを指定します。複数のジャーナル取得モードを指定できます。

c

トランザクションテストモードでコミット属性のジャーナル，またはMCFのトランザクション外テストモードのジャーナルを編集出力します。

r

トランザクションテストモードでロールバック属性のジャーナルを編集出力します。

s

オンラインテストモード以外のジャーナルを編集出力します。

-oオプションの指定を省略すると，すべてのジャーナル取得モードのジャーナルを編集出力します。

●-m　論理端末名称　　～〈16けた以内の英数字〉

編集出力する論理端末名を指定します。このオプションは，レコード種別がa，g，i，m，oの場合に有効になります。

-mオプションを省略すると，すべての論理端末を編集出力します。

●-w　けた　　～〈符号なし整数〉((80～132))《80》

1行の出力けた数を指定します。

●-l　行　　～〈符号なし整数〉((12～256))《24》

1ページの出力行数を指定します。

●-c

16進数，および文字形式で編集します。

-cオプションの指定を省略すると，16進数だけで編集します。

コマンド引数

●ファイル名　　～〈パス名〉

アンロードジャーナルファイル，またはグローバルアーカイブアンロードジャーナルファイルの名称を指定します。

-eオプションでfを指定した場合だけ，複数のファイル名を指定できます。複数のファイル名を指定するときは，ファイル名とファイル名との間を空白で区切ります。指定できるファイル数は256個までです。

このコマンド引数の指定を省略すると，標準入力と見なされます。

指定できるオプションとコマンド引数の組み合わせを次に示します。

（凡例）

○：指定できます。

△：指定できますが，編集対象とならない場合があります。レコード種別やジャーナルの内容によっては，ジャーナルに該当情報を持たないものがあります。

×：指定できません。

－：無効です。

出力形式

●-cオプションを指定した場合

注※1

レコード種別がAJ，IJ，OJ，MJ，GJの場合は，ジャーナル取得時刻（MCFジャーナルバッファに書き出した時刻）を表示します。

注※2

トランザクションを開始するCJの場合に表示します。

1：指定したレコードの数だけ繰り返し表示されます。

aa...aa：指定したファイルの名称（59文字以内）

bbb：ファイル種別

sys…システムジャーナルファイル

jar…グローバルアーカイブアンロードジャーナルファイル

cc...cc：ファイルの作成日時

dddddddd：ブロック番号（16進数字8けた）

eeeeeeee：レコード番号（16進数字8けた）

ff...ff：レコード単位に編集したときの日時
年－月－日 時：分：秒. マイクロ秒（マイクロ秒は0～999999の10進数）の形式で出力します。ただし，TP1/Server Base 06-01より前のバージョンのジャーナルを編集した場合，マイクロ秒の値は0が出力されます。

gg：レコード種別（英字2文字）

h：レコードタイプ（英数字1文字）

ii...ii：ジャーナル取得モード（英字13文字以内）

jj...jj：トランザクショングローバル識別子（英数字と特殊文字で8文字と16進数字8けた）

kk...kk：トランザクションブランチ識別子（英数字と特殊文字で8文字と16進数字8けた）

ll...ll：ジャーナルレコード（16進数字32～96けた，および文字16～32文字）ジャーナルレコードが管理情報だけの場合は，タイトルだけ出力します。

mm...mm：MCFレコードの作成日時
メッセージ制御機能でジャーナルレコードを作成した日時を出力します。
年－月－日 時：分：秒. マイクロ秒（マイクロ秒は0～999999の10進数）の形式で出力します。

nn...nn：トランザクションブランチ開始日時
年－月－日 時：分：秒. マイクロ秒（マイクロ秒は0～999999の10進数）の形式で出力します。

vv－rr：バージョン番号－リビジョン番号

yyyy：ページ

●「jnledit -e f」の場合

注※1

ファイル種別がjarの場合は，先頭ブロック番号，および先頭レコード番号に'0x********'を表示します。

注※2

各世代最終情報が無効，または設定されていない場合は，各世代最終情報の各項目に'*...*'を表示します。

1：指定したファイルの数だけ表示されます。

2：指定したファイルがグローバルアーカイブアンロードジャーナルファイルの場合に表示されます。

3：指定したファイルが，jnlunlfgコマンドに-tオプションを指定して取得したファイルの場合に表示されます。

aa...aa：指定したファイルの名称（59文字以内）

bb...bb：ファイルの作成日時

ccc：ジャーナルファイル種別

sys…システムジャーナルファイル

jar…グローバルアーカイブアンロードジャーナルファイル

dd...dd：ノード識別子

eeeeeeee：ジャーナルサーバのランID（16進数字8けた。先頭に0xを表示）

ff....ff：使用開始日時

gggggggg：先頭世代番号（16進数字8けた。先頭に0xを表示）

hhhhhhhh：最終世代番号（16進数字8けた。先頭に0xを表示）

iiiiiiii：先頭ブロック番号（16進数字8けた。先頭に0xを表示）

jjjjjjjj：先頭レコード番号（16進数字8けた。先頭に0xを表示）

kkkkkkkk：リソース名称（英数字8文字以内）

llllllll：ファイルの世代番号（16進数字8けた。先頭に0xを表示）

mmmmmmmm：ブロック番号（16進数字8けた。先頭に0xを表示）

nn...nn：サーバ側のジャーナルデータ取得日時

oo...oo：jnlunlfgコマンドの-tオプションで指定した開始日時（省略時は'*...*'を表示）

pp...pp：jnlunlfgコマンドの-tオプションで指定した終了日時（省略時は'*...*'を表示）

vv－rr：バージョン番号－リビジョン番号

yyyy：ページ

出力メッセージ

メッセージID | 内容 | 出力先
KFCA02600-E | アンロードジャーナルファイルのアクセスでエラーが発生しました | 標準エラー出力
KFCA02601-E | アンロードジャーナルファイルが不正です | 標準エラー出力
KFCA02602-E | ジャーナルブロックが不正です | 標準エラー出力
KFCA02603-E | ジャーナルレコードが不正です | 標準エラー出力
KFCA02604-E | メモリが確保できません | 標準エラー出力
KFCA02640-I | ヘルプメッセージ | 標準出力，標準エラー出力
KFCA02641-E | jnleditコマンドのパラメタ不正，または制限値オーバです | 標準エラー出力
KFCA02642-E | jnleditコマンドのオプションの組み合わせが不当です | 標準エラー出力
KFCA02643-E | jnleditコマンドのオプションの指定に誤りがあります | 標準エラー出力
KFCA02644-E | jnleditコマンドのファイル名の指定に誤りがあります | 標準エラー出力

注意事項

編集範囲を指定する場合，開始時刻，または終了時刻と一致するジャーナルレコードがないときは，開始時刻と終了時刻の間にあるジャーナルレコードが編集対象になります。

編集対象のジャーナルレコードがない場合，ファイル名，ファイル種別，作成日を出力します。

開始時刻が終了時刻より遅くなるように編集範囲を指定するときは，必ず「月」「日」，または「月」「日」「年（西暦）」を指定して，終了時刻が開始時刻よりあとになるようにしてください。省略するとエラーになります。日付を省略すると，jnleditコマンドを入力した年月日と見なすため，編集範囲が該当する年月日以外の日付の場合は，必ず「月」「日」，または「月」「日」「年（西暦）」を指定してください。

ファイル名の指定を省略すると，標準入力からの入力となります。そのため，入力ファイルをパイプ，リダイレクションなどで指定してください。

16進数字は，（8けた×4ブロック）の倍数，文字は（4文字×4ブロック）の倍数で，合計が-wオプションで指定したけた数に入る値で編集します。

UJをレコードまたはブロック単位に編集した場合，データはユーザ指定値に8バイト加えた値を，4バイト境界に調整した値の分だけ編集出力されます。そのため，ユーザ指定値が4バイト境界になっていない場合，ユーザ指定値以降のデータには，無効なデータが出力されます。
実際にユーザが出力したデータは，編集データの先頭4バイトに設定されているデータ長より8バイト少なく，編集データの先頭8バイト目から始まります。

UJ以外のジャーナルファイルをレコードまたはブロック単位に編集した場合，データは4バイト境界に調整した値の分だけ編集出力されます。そのため，レコードのサイズが4バイト境界になっていない場合，レコードのサイズ以降のデータには，無効なデータが出力されます。

このコマンドで入力できる文字数はご使用のOSによって変わります。入力文字数が上限値を超えるとエラーになります。

指定したファイル数が256個以下の場合でも，1プロセスでオープンできるファイルの最大数を超えるとエラーになります。

次のオプションを使用して編集する内容を指定すると，該当する情報をレコード内に持ち，条件に一致するジャーナルだけが編集出力されます。
-jオプションで指定するジャーナルレコード種別やジャーナルデータの内容によっては，該当する情報そのものをレコード内に持たないジャーナルもあります。それらのジャーナルは編集出力の対象にはなりません。

-s サーバ名

-v サービス名

-u トランザクション識別子

-m 論理端末名称

使用例

アンロードジャーナルファイルの先頭から，1993年5月29日17時30分0.999999秒までの情報を，16進数，および文字形式で，レコード単位に編集して出力する場合

アンロードジャーナルファイル：sysjnl001

jnledit -e r -t ,17300005291993 -c /tp1/jnl/sysjnl001

jnlinit

名称

ジャーナル関係のファイルの初期設定

形式

jnlinit -j jnl｜cpd｜srf -f 物理ファイル名 -n OpenTP1レコード数

機能

OpenTP1ファイルシステム下にジャーナル関係のファイルを作成し，オンラインで使用できるように初期設定します。

オプション

●-j　jnl｜cpd｜srf

初期設定するジャーナル関係のファイルを指定します。

jnl：システムジャーナルファイル，またはアーカイブジャーナルファイル

cpd：チェックポイントダンプファイル

srf：OpenTP1ファイルで作成するサーバリカバリジャーナルファイル

●-f　物理ファイル名　　～〈パス名〉

初期設定する物理ファイル名を完全パス名で指定します。

-jオプションでjnlを指定したシステムジャーナルファイルの場合，システムジャーナルサービス定義の定義コマンドjnladdpfの物理ファイル名に指定した名称と同じ名称を指定してください。

-jオプションでjnlを指定したアーカイブジャーナルファイルの場合，アーカイブジャーナルサービス定義の定義コマンドjnladdpfの物理ファイル名に指定した名称と同じ名称を指定してください。

-jオプションでcpd，またはsrfを指定した場合，チェックポイントダンプサービス定義の定義コマンドjnladdpfの物理ファイル名に指定した名称と同じ名称を指定してください。

すでにある物理ファイルを指定するとエラーになります。

●-n　OpenTP1レコード数　　～〈符号なし整数〉((12～524287))

初期設定するOpenTP1ファイルのレコード数を指定します。

なお，ここでいうレコードとは，ジャーナルサービスが管理するOpenTP1ファイルシステム上の4096バイトの領域のことです。

-jオプションでjnlを指定する場合は，-nオプションには次に示す値以上を指定してください。

システムジャーナルファイルのとき：

↑((システムサービス定義のjnl_max_datasize値)＋336)／ 4096↑＋12

　　↑↑：小数点以下を切り上げます。

アーカイブジャーナルファイルのとき：260

注意事項

jnlinitコマンド実行時，次に示す環境変数にOpenTP1ディレクトリの環境変数と同じものが設定されていないと，コマンドエラー時にメッセージが出力されません。
　DCDIR

キャラクタ型スペシャルファイル上にOpenTP1ファイルシステムを作成した場合，ジャーナル関係のファイルを作成するハードディスクのパーティションは，セクタ長の整数倍が4096となるものでなければなりません。

jnlinitコマンドで初期設定したファイルのレコード数のうち，情報の取得に使用できるレコード数は，-nオプションで指定したレコード数-4レコードとなります。これは，OpenTP1が情報の取得に使用できるレコード数（-nオプションの値）から管理レコード部分（3レコード）を除いて初期化するためです。

jnlls

名称

ジャーナル関係のファイル情報の表示

形式

jnlls -j sys｜cpd｜jar｜srf 〔-s サーバ名〕〔-r リソースグループ名〕
   〔-g ファイルグループ名〕〔-d〕

機能

ジャーナル関係のファイルについての情報を標準出力に出力します。

オプション

●-j　sys｜cpd｜jar｜srf

情報を表示するジャーナル関係のファイルを指定します。

　sys：システムジャーナルファイル

　cpd：チェックポイントダンプファイル

　jar：アーカイブジャーナルファイル

　srf：OpenTP1ファイル化したサーバリカバリジャーナルファイル

cpd，またはsrfを指定した場合は，ジャーナルサービスが動作しているときだけコマンドを実行できます。

●-s　サーバ名　　～〈1～8文字の識別子〉

チェックポイントダンプファイルの情報を表示するとき，その対象となるサーバの名称を指定します。

このオプションの指定を省略すると，すべてのサーバの情報が出力されます。

-jオプションでcpd以外を指定している場合，-sオプションの指定は無視されます。

●-r　リソースグループ名　　～〈1～8文字の識別子〉

-jオプションでjarを指定している場合，情報を表示するファイルのリソースグループの名称を指定します。グローバルアーカイブジャーナルサービス定義の定義コマンドjnldfsv -aで指定したアーカイブジャーナルサービス定義の定義ファイル名を指定してください。

このオプションの指定を省略すると，すべてのリソースグループの情報が出力されます。

-jオプションでjar以外を指定している場合，-rオプションの指定は無視されます。

●-g　ファイルグループ名　　～〈1～8文字の識別子〉

システムジャーナルファイルの情報を表示するとき，特定のファイルグループの情報を表示する場合に指定します。

このオプションの指定を省略すると，すべてのファイルグループの情報が表示されます。

●-d

システムジャーナルファイル，アーカイブジャーナルファイル，またはチェックポイントダンプファイルの情報を表示するとき，要素ファイルの情報を表示する場合に指定します。

このオプションの指定を省略すると，要素ファイルの情報は表示されません。

-jオプションでsrfを指定している場合，-dオプションの指定は無視されます。

出力形式

●「jnlls -j sys -d」，または「jnlls -j jar -d」と指定した場合

注※

B系状態は，システムジャーナルファイルを二重化したときだけ表示されます。

1：ファイルグループ状態

2：要素ファイル状態

aaaaaaaa：ファイルグループ名

bbb：ファイル種別

sys…システムジャーナルファイル

jar…アーカイブジャーナルファイル

cccccccc：リソースグループ名（グローバルアーカイブジャーナルサービス定義で指定したアーカイブジャーナルサービス定義の定義ファイル名）

dddddddd：世代番号（16進数）

e：ファイルグループのオープン状態

o…オープン中（該当するファイルグループを構成する要素ファイルがオープンされています）

c…クローズ中（該当するファイルグループを構成する要素ファイルがクローズされています）

f：ファイルグループの状態

c…現用（ファイルグループが有効な要素ファイルで構成されていて，現時点でジャーナルの出力対象となっています）

s…待機中（ファイルグループが有効な要素ファイルで構成されているが，現時点でジャーナルの出力対象になっていません）

n…予約（ファイルグループが有効な要素ファイルで構成されていません）

g：ファイルグループのアンロード状態※¹

u…アンロード待ち（過去に現用として使用されていて，スワップされて現用でなくなり，アンロードしなければならないジャーナルを含んでいます）

-…アンロード済み

h：ファイルグループが上書きできるか，できないかの状態

d…上書きできません（システムの回復に必要なジャーナルを含んでいます）

-…上書きできます（システムの回復に必要なジャーナルを含んでいません）

i：ファイルグループのOpenTP1での状態

b…jnlunlfg，jnlchgfgコマンドで使用中，または回復処理で使用中の状態です

-…jnlunlfg，jnlchgfgコマンドで使用中，または回復処理で使用中でない状態です

j：ファイルグループの不整合状態

c…過去に現用として使われていたときに，何らかの障害が発生してジャーナルファイル内の管理情報が現用のままとなっている要素ファイルがあります。例えば現用中にジャーナルの出力障害が発生したファイルグループなどです。

-…過去に現用として使用され，正しく処理されているファイルです

k：ファイルグループのアーカイブ済み状態※¹

u…アーカイブ待ち。マルチノード機能を使用していて，該当するファイルグループの中にアーカイブジャーナルファイルに出力されていないジャーナルを含んでいます。

-…アーカイブ済み

llllllll：ランID（ファイルが使用されたときのジャーナルサービス，またはグローバルアーカイブジャーナルサービスのランID。16進数）

mmmmmmmm：先頭ブロック番号（16進数）

nnnnnnnn：最終ブロック番号（16進数）

oooooooo：要素ファイル名

p：要素ファイルのオープン状態

o…オープン状態（該当する要素ファイルを構成する物理ファイルがオープンされています）

c…クローズ状態（該当する要素ファイルを構成する物理ファイルがクローズされています）

q：要素ファイルが使用できるかどうかの状態

n…要素ファイルが，オンラインで使用できる物理ファイルで構成されていません

u…要素ファイルが，オンラインで使用できる物理ファイルで構成されています

r：要素ファイルのアンロード状態※²

u…アンロード待ち（アンロードしなければならないジャーナルを含んでいます）

-…アンロード済み

s：要素ファイルのアーカイブ済み状態※¹

u…アーカイブ待ち。マルチノード機能を使用していて，該当する要素ファイルの中にアーカイブジャーナルファイルに出力されていないジャーナルを含んでいます

-…アーカイブ済み

t：要素ファイルの閉塞状態

h…閉塞中（該当する要素ファイルを構成する物理ファイルに対するジャーナルの出力，またはジャーナルファイルヘッダの入出力で障害が発生し，以後ジャーナルを出力していない物理ファイルを含む要素ファイルです）

-…閉塞中ではありません（正常な要素ファイルです）

u：要素ファイルが読み込める，または読み込めない状態

r…該当する要素ファイルを構成する物理ファイルが読み込めない状態です（全面回復，部分回復しようとしても，ジャーナルが消去（初期化）されていて読み込めません。システムジャーナルファイルに障害が発生し，障害の要因を取り除いたあと，物理ファイルを再作成してオープンした場合，この状態になります）

-…該当する要素ファイルを構成する物理ファイルが読み込める状態です

vvvvvvvv：該当するファイルでの使用済みレコード数（16進表示）※³，※⁴
ジャーナルを出力したOpenTP1ファイルシステム上のレコード数です

wwwwwwww：該当するファイル内の全レコード数（16進表示）※⁴，※⁵
ジャーナルを出力できるOpenTP1ファイルシステム上のレコード数です

A：物理ファイルのオープン状態

o…オープン中（ジャーナルサービスが該当する物理ファイルをオープンしています）

c…クローズ中（ジャーナルサービスが該当する物理ファイルをオープンしていません）

B：物理ファイルの状態

c…現用（ファイルグループの状態が現用のときは，実際にジャーナルの出力対象になっていることを示します。ファイルグループの状態が現用でないときは，過去に現用だったときに障害が発生し，回復されていないためにジャーナルファイルヘッダにステータスが残っている状態です。jnlunlfg，jnlchgfgコマンドで状態を回復するか，またはjnlinitコマンドで初期設定しないと再使用できません）

s…待機

C：物理ファイルのアンロード状態※²

u…アンロード待ち（該当する物理ファイルに，アンロードしなければならないジャーナルがあります）

-…アンロード済み（該当する物理ファイルには，アンロードしなければならないジャーナルがありません）

D：物理ファイルのアーカイブ済み状態※¹

u…アーカイブ待ち。マルチノード機能を使用していて，該当する物理ファイルの中にアーカイブジャーナルファイルに出力されていないジャーナルを含んでいます

-…アーカイブ済み

E：物理ファイルの閉塞状態

h…閉塞中（ジャーナルの出力，またはジャーナルファイルヘッダの入出力で障害が発生し，以後ジャーナルを出力していません）

-…閉塞中ではありません（ジャーナルを出力できます）

F：物理ファイルが読み込める状態かどうか

r…読み込めない状態（全面回復，部分回復しようとしても，ジャーナルが消去（初期化）されていて，読み込めません。システムジャーナルファイルに障害が発生し，障害の要因を取り除いたあと，物理ファイルを再作成してオープンしたような場合，この状態になります）

-…読み込める状態です

注※1

該当するファイルグループが次の場合には，必ず'u'が表示されます。

マルチノード機能を使用していないシステムジャーナルファイル

アーカイブジャーナルファイル

マルチノード機能を使用していて，ファイルグループのアーカイブ済み状態に'-'（アーカイブ済み）が表示された場合，要素ファイルと物理ファイルのアーカイブ済み状態に'u'（アーカイブ待ち）が表示されても，アーカイブされません。状態が不一致になるのは，物理ファイルに障害が発生して，状態が書き換えられなかったためです。

注※2

ファイルグループのアンロード状態がアンロード済みの場合は，要素ファイル，物理ファイルのアンロード状態がアンロード待ちであってもjnlunlfg，jnlchgfgコマンドを実行する必要はありません。ステータスが不一致になるのは，jnlunlfg，jnlchgfgコマンド実行時に障害が発生し，ステータスが書き換えられていないためです。

注※3

0が表示されているときは，ジャーナルが1件も出力されていない場合です。全面回復完了後，現用以外の状態の場合，使用済みレコード数の内容が正しくなくなることがあります。

注※4

1レコードとは，ジャーナルサービス，またはグローバルアーカイブジャーナルサービスで管理するOpenTP1ファイルシステム上の4096バイトのエリアのことです。

注※5

ファイル内の全レコード数はジャーナルサービス，またはグローバルアーカイブジャーナルサービスがジャーナルブロックを出力できるOpenTP1ファイルのレコード数であり，jnlinitコマンドの-nオプションで指定したレコード数－4です。

●「jnlls -j cpd」と指定した場合

aaaaaaaa：サーバ名

bbbbbbbb：ファイルグループ名

cccccccc：世代番号（16進数）

d：世代状態

a…上書きできない状態

u…上書きできる，または書き込み中の状態

r…予約の状態

eeeeeeee：オーバライトポインタのジャーナルファイルグループ名

ffffffff：オーバライトポインタのジャーナルブロック番号（16進数）

●「jnlls -j cpd -d」と指定した場合

aaaaaaaa～ffffffffについては，「「jnlls -j cpd」と指定した場合」と同じです。

g：A系，またはB系のファイル状態

o…オープン中

c…クローズ中

h…障害閉塞中

-…物理ファイルの割り当てなし

●「jnlls -j srf」と指定した場合

aaaaaaaa：サーバ名

bbbbbbbbbbbbbbb：ファイル名（チェックポイントダンプサービス定義で指定したサーバリカバリジャーナルファイルのファイルグループ名）

ccccc：サーバリカバリジャーナルファイルのブロック数

ddd：ファイルの使用率（jnlinitコマンドで初期設定したファイルのサイズに対する，OpenTP1ファイル化したサーバリカバリジャーナルの割合）

出力メッセージ

メッセージID
内容
出力先

KFCA01141-E
実行環境がジャーナルファイルレスモードのため，コマンドを実行できません
標準エラー出力

KFCA01280-E
jnllsコマンドの処理が失敗しました
標準エラー出力

KFCA01281-E
jnllsコマンドの入力形式が誤っています
標準エラー出力

KFCA01282-E
指定したものが見つかりません
標準エラー出力

KFCA02128-E
指定したサーバ名が誤っています
標準エラー出力

KFCA02130-E
-sオプションの指定が誤っています
標準エラー出力

KFCA02132-E
障害が発生してjnllsコマンドの処理を中止しました
標準エラー出力

KFCA02171-E
作業領域が確保できません
標準エラー出力

KFCA02172-I
表示するチェックポイントダンプファイルの情報がありません
標準エラー出力

KFCA01291-I
ヘルプメッセージ
標準出力，
標準エラー出力

注意事項

ファイルグループの状態を変更中（スワップ中，またはファイルグループを操作する運用コマンドの処理中など）にjnllsコマンドを入力すると，正しい状態が表示されないことがあります。

システムジャーナルサービス定義で，jnl_unload_check=Nを指定している場合は，ファイルグループはアンロード済み状態でなくてもスワップ先のファイルグループとして使用できます。

jnllsコマンドはOpenTP1が動作中の場合，共用メモリ上のジャーナル管理情報を基にファイル情報の表示をしています。しかし，OpenTP1が停止しているときは，共用メモリ上のジャーナル管理情報がないので，物理ファイルを読み込んでファイル情報を表示します。このため，OpenTP1の停止中に，jnllsコマンドを実行してもOpenTP1がオンラインで管理する情報は表示されません。

システムジャーナルファイルとアーカイブジャーナルファイルは，OpenTP1の動作中と停止中では，表示内容が異なります。OpenTP1の状態と表示内容の関係を次に示します。

表示項目 | OpenTP1の状態
表示内容 | 表示記号 | 動作中 | 停止中
ファイルグループ名 | aaaaaaaa | ○ | ○
ファイル種別 | bbb | ○ | ○
リソースグループ名 | cccccccc | ○ | ○
世代番号 | dddddddd | ○ | ○
ファイルグループに関する表示項目 | オープン状態 | e | ○ | ×
使用状況 | f | ○ | △※¹
アンロード状態 | g | ○ | ○
上書きの可否 | h | ○ | ×
OpenTP1での状態 | i | ○ | ×
不整合状態 | j | ○ | ○
アーカイブ済み状態 | k | ○ | ○
ランID | llllllll | ○ | ○
先頭ブロック番号 | mmmmmmmm | ○ | ○
最終ブロック番号 | nnnnnnnn | ○ | △※2
要素ファイルに関する表示項目 | 要素ファイル名 | oooooooo | ○ | ○
オープン状態 | p | ○ | ×
使用状況 | q | ○ | ×
アンロード状態 | r | ○ | ○
アーカイブ済み状態 | s | ○ | ○
閉塞状態 | t | ○ | ×
読み込みの可否 | u | ○ | ○
使用済みレコード数 | vvvvvvvv | ○ | ×
ファイル内の全レコード数 | wwwwwwww | ○ | ○
物理ファイルに関する表示項目 | オープン状態 | A | ○ | ×
使用状況 | B | ○ | ○
アンロード状態 | C | ○ | ○
アーカイブ済み状態 | D | ○ | ○
閉塞状態 | E | ○ | ×
読み込みの可否 | F | ○ | ○

（凡例）

○：表示されます。

×：表示されません。

△：表示されますが，OpenTP1動作中と値が異なります。

注※1

現用以外の場合は，？が表示されます。

注※2

現用のファイルグループは表示されません。また，障害の発生したファイルグループは，表示されない場合があります。

jnllsコマンドは，OpenTP1の停止中の場合は，物理ファイルを読み込んでジャーナル状態を表示します。どの物理ファイルを読み込むかは，ジャーナル関係の定義ファイルを解析して決定します。このため，次に示す定義は変更しないでください。

ジャーナルサービス定義

システムジャーナルサービス定義

グローバルアーカイブジャーナルサービス定義

アーカイブジャーナルサービス定義

定義を変更した場合，結果は保証できません。ただし，再開始時に変更できる定義を変更することはできます。

OpenTP1の停止中に，次に示すジャーナルファイルを表示する場合は，注意してください。

システムジャーナルファイル，アーカイブジャーナルファイルの場合
OpenTP1が停止している場合は，ジャーナル関係の定義ファイルと物理ファイルを読み込んで，ファイル情報を表示します。このため，jnllsコマンドはOpenTP1管理者が実行してください。

チェックポイントダンプファイル，OpenTP1ファイル化したサーバリカバリジャーナルファイルの場合
OpenTP1が停止している場合に，jnllsコマンドを実行するとコマンドエラーになります。

OpenTP1停止直後には，jnllsコマンドを入力しないでください。コマンドが中断するおそれがあります。

jnlmcst

名称

MCF稼働統計情報の出力

形式

jnlmcst 〔-e 編集種別〕〔-l 行〕〔-i 時間間隔〕
       〔-t〔開始〕〔,終了〕〕〔-m 論理端末名称〕
       〔-a アプリケーション名称〕
       〔-o ジャーナル取得モード〔ジャーナル取得モード〕…〕
       〔ファイル名〕

機能

指定したアンロードジャーナルファイル，またはグローバルアーカイブジャーナルファイルから，MCF稼働統計情報を収集し，編集後，標準出力へ出力します。

出力する情報を次に示します。

MCF稼働統計情報のメッセージ受信系，および送信系情報

オプション

●-e　編集種別　　～《all》

編集種別を指定します。

　let：論理端末名称ごとにMCF稼働統計情報を編集し，出力します。

　uap：アプリケーション名ごとにMCF稼働統計情報を編集し，出力します。

　all：すべてのMCF稼働統計情報を編集し，出力します。

●-l　行　　～〈符号なし整数〉((12～256))《24》

1ページの出力行数を指定します。

●-i　時間間隔

MCF稼働統計情報を編集し，出力する時間の間隔を，時間間隔，または分間隔で指定します。

h〔HH〕：時間間隔（01≦HH≦24）で出力します。

HHの指定を省略すると，1時間間隔で出力します。

m〔MM〕：1分間隔（01≦MM≦09），または10分間隔（10≦MM≦30）で出力します。

MMの指定を省略すると，10分間隔で出力します。

時間間隔と分間隔の両方を指定すると，エラーとなります。

-iオプションの指定を省略すると，1時間間隔で出力します。

●-t　〔開始〕〔，終了〕

MCF稼働統計情報の出力範囲をジャーナル出力時刻で指定します。

開始には，出力を開始する時刻を指定します。終了には，出力を終了する時刻を指定します。

開始は，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からの西暦を4けたで指定します）

指定を省略できます。※

注※

開始，または終了の「年」の指定を省略した場合は，当年の指定月日時刻と見なされます。「年，月，日」の指定を省略した場合，当年当月当日の指定時刻と見なされます。「月，日」，「月」，または「日」だけを省略することはできません。省略した場合はオプションエラーになります。「月」または「日」を省略したい場合は，「年」，「月」，「日」のすべてを省略してください。

-tオプションの指定を省略すると，指定したファイル内のすべての情報を編集出力します。

●-m　論理端末名称　　～〈1～16文字の英数字〉

編集対象の論理端末名称を指定します。

-mオプションの指定を省略すると，すべての論理端末が編集対象となります。

-mオプションの指定は，-eオプションでletを指定した場合だけ有効です。

●-a　アプリケーション名称　　～〈1～10文字の英数字〉

編集対象のアプリケーション名を指定します。

-aオプションの指定を省略すると，すべてのアプリケーションが編集対象となります。

-aオプションの指定は，-eオプションでuapを指定した場合だけ有効です。

●-o　ジャーナル取得モード

ジャーナルの取得モードを指定します。複数のジャーナル取得モードを指定できます。

c

トランザクションテストモードでコミット属性のMCF稼働統計情報，またはMCFのトランザクション外テストモードのMCF稼働統計情報を出力します。

r

トランザクションテストモードでロールバック属性のMCF稼働統計情報を出力します。

s

オンラインテストモード以外のMCF稼働統計情報を出力します。

-oオプションの指定を省略すると，すべてのジャーナル取得モードのMCF稼働統計情報が出力されます。

指定できるオプションの組み合わせを次に示します。

（凡例）

○：指定できます。

×：指定できません。

－：無効です。

コマンド引数

●ファイル名　　～〈パス名〉

アンロードジャーナルファイル，またはグローバルアーカイブアンロードジャーナルファイルの名称を指定します。

マルチノード機能を使用している場合は，jnlsortコマンドでソート，およびマージ（ノードの抽出，ジャーナルサーバランIDの特定）した結果のファイル名を指定してください。

このコマンド引数の指定を省略すると，標準入力と見なされます。

出力形式

「jnlmcst -e let」と指定した場合の出力形式を次に示します。

注※

-eオプションにuapを指定した場合はアプリケーション名が，-eオプションにallを指定した場合はすべてのMCF情報が表示されます。

aa...aa：指定したファイルの名称（59文字以内）

bb...bb：ファイルの作成日時

cc...cc：-tオプション指定開始時刻（-tオプション省略時は'*'を出力）

dd...dd：-tオプション指定終了時刻（-tオプション省略時は'*'を出力）

ee...ee：-iオプション指定出力間隔（-iオプション省略時は'△1 hour'を出力）
出力時間の間隔と単位を次のように出力します。

1時間間隔の場合…△1　hour

1分間隔の場合…△1　minute

ff...ff：ノード識別子

gg...gg：論理端末名称

xx...xx：統計情報（10けた以内の10進数）
最小値，最大値，平均値，合計値がオーバフローした場合は，'*'を出力します。
平均値は，小数点以下を四捨五入して出力します。
受信メッセージサイズの合計値には，'-'を出力します。

vv-rr ：バージョン番号－リビジョン番号

yyyy：ページ

出力メッセージ

メッセージID | 内容 | 出力先
KFCA02600-E | アンロードジャーナルファイルのアクセスでエラーが発生しました | 標準エラー出力
KFCA02601-E | アンロードジャーナルファイルが不正です | 標準エラー出力
KFCA02602-E | ジャーナルブロックが不正です | 標準エラー出力
KFCA02603-E | ジャーナルレコードが不正です | 標準エラー出力
KFCA02604-E | メモリが確保できません | 標準エラー出力
KFCA02670-I | ヘルプメッセージ | 標準出力，標準エラー出力
KFCA02671-E | jnlmcstコマンドのパラメタ不正，または制限値オーバです | 標準エラー出力
KFCA02672-E | jnlmcstコマンドのオプションの組み合わせが不当です | 標準エラー出力
KFCA02673-E | jnlmcstコマンドのオプションの指定に誤りがあります | 標準エラー出力
KFCA02674-E | jnlmcstコマンドのファイル名の指定に誤りがあります | 標準エラー出力

注意事項

MCF稼働統計情報の出力範囲を指定する場合，開始時刻，または終了時刻と一致するジャーナルレコードがないときは，開始時刻と終了時刻の間にあるジャーナルレコードが出力対象になります。

jnlmcstコマンドの対象となるジャーナルレコードがない場合，処理を終了します。

開始時刻が終了時刻より遅くなるようにMCF稼働統計情報の出力範囲を指定するときは，必ず「月」「日」，または「月」「日」「年（西暦）」を指定して，終了時刻が開始時刻よりあとになるようにしてください。省略するとエラーになります。日付を省略すると，jnlmcstコマンドを入力した年月日と見なすため，出力範囲が該当する年月日以外の日付の場合は，必ず「月」「日」，または「月」「日」「年（西暦）」を指定してください。

MCF稼働統計情報の編集出力開始時刻は，-tオプションで開始時刻を指定するか，指定しないかによって異なります。指定した場合，-tオプションの開始時刻が含まれる時間帯から出力します。指定しなかった場合，該当するファイルの先頭のIJ，GJ，OJ，AJレコード時刻が含まれる時間帯から出力します。ここでいう時間帯とは，それぞれの開始時刻の時間（hh：00）を基に，-iオプションで指定した時間間隔で区切った間隔のことです。

MCF稼働統計情報の出力終了時刻を指定すると，指定終了時刻を含む時間帯まで出力されます。

編集した平均値は小数点以下1けたを四捨五入して出力します。

受信メッセージサイズの合計値には，'－'を出力します。

最小値，最大値，平均値，合計値がオーバフローした場合，'*'を出力します。

ファイル名の指定を省略すると，標準入力からの入力となります。そのため，入力ファイルをパイプ，リダイレクションなどで指定してください。

-tオプション指定時，指定したファイル中に指定範囲と一致する部分が複数ある場合は，すべてが出力対象となります。

-tオプションの終了時刻の「年」に2038年を超える値を指定すると，CPU消費量およびメモリ所要量が増大してコマンドを終了するまでに時間が掛かる場合があります。

使用例

2003年5月29日17時30分0.0秒からアンロードジャーナルファイルの最後までのMCF稼働統計情報を編集出力する場合

アンロードジャーナルファイル：sysjnl001

jnlmcst -e all -t 17300005292003 /tp1/jnl/sysjnl001

jnlmkrf

名称

ジャーナル関係のファイルの回復

形式

jnlmkrf ｛-j trf｜-j srf -s サーバ名｝ アンロードジャーナルファイル名
       〔〔△アンロードジャーナルファイル名〕…〕

機能

OpenTP1の再開始中に障害が発生したジャーナル関係のファイルを回復します。

オプション

●-j　trf

トランザクションリカバリジャーナルファイルを回復します。

●-j　srf

サーバリカバリジャーナルファイルを回復します。

●-s　サーバ名　　～〈1～8文字の識別子〉

サーバリカバリジャーナルファイルを回復する場合に，対象となるサーバの名称を指定します。

-jオプションでsrfを指定している場合，必ず指定してください。指定を省略すると，コマンドエラーとなります。

-jオプションでtrfを指定している場合，-sオプションを指定しても-sオプションの指定は無視されます。

コマンド引数

●アンロードジャーナルファイル名　　～〈パス名〉

ジャーナル関係のファイルを回復するのに必要なジャーナルが含まれているシステムジャーナルファイルに対して，jnlunlfgコマンドを実行して作成したアンロードジャーナルファイルの名称を指定します。

アンロードジャーナルファイルが複数ある場合は，そのアンロードジャーナルファイルをすべて指定してください。アンロードジャーナルファイル名は64個まで指定できます。複数のアンロードジャーナルファイルを指定する場合は，アンロードジャーナルファイル名とアンロードジャーナルファイル名との間を空白で区切ります。指定するアンロードジャーナルファイルの世代は，順不同でかまいません。

指定したアンロードジャーナルファイルでジャーナルの通番抜けがある場合は，ジャーナル関係のファイルの回復を中止します。

jnlopnfg

名称

ジャーナル関係のファイルのオープン

形式

jnlopnfg -j sys｜cpd｜jar 〔-s サーバ名〕〔-r リソースグループ名〕
        -g ファイルグループ名〔-e 要素ファイル名〕〔-a〕〔-b〕

機能

指定したファイルグループを構成するクローズ中の物理ファイルをオープンし，オンラインで使用できるようにします。

jnlopnfgコマンドは，OpenTP1が動作中で，かつジャーナルサービスが動作中のときだけ入力できます。

オプション

●-j　sys｜cpd｜jar

オープンするジャーナル関係のファイルを指定します。

　sys：システムジャーナルファイル

　cpd：チェックポイントダンプファイル

　jar：アーカイブジャーナルファイル

●-s　サーバ名　　～〈1～8文字の識別子〉

チェックポイントダンプファイルをオープンするとき，対象となるサーバの名称を指定します。

このオプションの指定を省略すると，すべてのサーバのチェックポイントダンプファイルでファイルグループ名と一致するもののうち，最初に見つけられたものがオープンされます。

-jオプションでcpd以外を指定している場合，-sオプションの指定は無視されます。

●-r　リソースグループ名　　～〈1～8文字の識別子〉

-jオプションでjarを指定している場合，オープンするファイルのリソースグループの名称を指定します。グローバルアーカイブジャーナルサービス定義の定義コマンドjnldfsv -aで指定したアーカイブジャーナルサービス定義の定義ファイル名を指定してください。

このオプションの指定を省略すると，オンライン中のアーカイブジャーナルファイルのうちから，アーカイブジャーナルサービス定義の定義コマンドjnldfsv -aの先頭に定義したファイル名が仮定されます。

-jオプションでjar以外を指定している場合，-rオプションの指定は無視されます。

●-g　ファイルグループ名　　～〈1～8文字の識別子〉

オープンするジャーナル関係のファイルのファイルグループ名を指定します。

●-e　要素ファイル名

オープンするジャーナル関係のファイルのファイルグループ中の，要素ファイルの名称を指定します。

●-a

A系の物理ファイルをオープン対象とします。

●-b

B系の物理ファイルをオープン対象とします。

二重化していないときに指定すると，コマンドエラーとなります。

上記の-a，-bオプションを両方とも省略した場合，または-jオプションでcpdを指定した場合は，次のようになります。

二重化していない場合は，-aオプションを指定した場合と同様に，A系の物理ファイルをオープン対象とします。

二重化している場合は，-a，-bオプションを同時に指定した場合と同様に，A系，B系両方の物理ファイルをオープン対象とします。

片系運転不可の二重化の運用では，-j cpdの指定に，-aまたは-bオプションのどちらかを指定するとコマンドエラーになります。

なお，オープン対象となる物理ファイルがすべてオープン済みのときは，警告メッセージ（KFCA01283-W，またはKFCA02167-W）を出力します。ただし，コマンドエラーとはなりません（コマンド終了コードは0）。

出力メッセージ

メッセージID
内容
出力先

KFCA01141-E
実行環境がジャーナルファイルレスモードのため，コマンドを実行できません
標準エラー出力

KFCA01215-I
ファイルグループのオープンに成功しました
メッセージログファイル

KFCA01280-E
jnlopnfgコマンドの処理が失敗しました
標準エラー出力

KFCA01281-E
jnlopnfgコマンドの入力形式が誤っています
標準エラー出力

KFCA01283-W
jnlopnfgコマンド実行中に軽度エラーが発生しました
標準エラー出力

KFCA01285-E
スワップ処理中です
標準エラー出力

KFCA01294-I
ヘルプメッセージ
標準出力，
標準エラー出力

KFCA02128-E
指定したサーバ名が誤っています
標準エラー出力

KFCA02129-E
指定したファイルグループ名が誤っています
標準エラー出力

KFCA02130-E
-sオプションの指定が誤っています
標準エラー出力

KFCA02131-E
-gオプションの指定が誤っています
標準エラー出力

KFCA02132-E
障害が発生してjnlopnfgコマンドの処理を中止しました
標準エラー出力

KFCA02167-W
指定したファイルグループはオープン済みです
標準エラー出力

KFCA02169-E
ファイルのオープンに失敗しました
標準エラー出力

注意事項

jnlopnfgコマンドを，スワップ処理中，またはほかの運用コマンドの処理中に入力すると，エラーとなることがあります。

jnlrinf

名称

再開始中読み込み済ジャーナル関係のファイル情報の表示

形式

jnlrinf -j sys｜jar

機能

再開始中に読み込んだジャーナル情報を出力します。

オプション

●-j　sys｜jar

情報を表示するジャーナル関係のファイルを指定します。

　sys：システムジャーナルファイル

　jar：アーカイブジャーナルファイル

出力形式

aaa：ファイル種別

sys…システムジャーナルファイル

jar…アーカイブジャーナルファイル

bbbbbbbb：リソースグループ名（グローバルアーカイブジャーナルサービス定義で指定したアーカイブジャーナルサービス定義の定義ファイル名）

cccccccc：ファイルグループ名

dddddddd：世代番号（16進数）

eeeeeeeee：読み込み済みのブロック番号（16進数）

yyyy/mm/dd　hh:mm:ss：該当するブロックを読み込んだ時間

ffffffff：現在処理中の世代の先頭ブロック番号（16進数）

gggggggg：現在処理中の世代の最終ブロック番号（16進数）
現用または障害の発生したファイルグループの場合，「********」と表示されます。

出力メッセージ

メッセージID
内容
出力先

KFCA01141-E
実行環境がジャーナルファイルレスモードのため，コマンドを実行できません
標準エラー出力

KFCA01280-E
jnlrinfコマンドが実行できませんでした
標準エラー出力

KFCA01281-E
jnlrinfコマンドの形式が誤っています
標準エラー出力

KFCA01282-E
指定したものが見つかりません
標準エラー出力

KFCA01284-I
ヘルプメッセージ
標準出力，
標準エラー出力

注意事項

OpenTP1システムの稼働中でも，ジャーナルサービスが再開始中でないとき，KFCA01280-Eが出力されることがあります。

OpenTP1システムの開始ステータスが「再開始」で，ジャーナルサービスがオンラインのとき，このコマンドは，最後に読み込んだジャーナル情報を出力します。

jnlrm

名称

ジャーナル関係のファイルの削除

形式

jnlrm -f 物理ファイル名 〔-u〕

機能

OpenTP1ファイルシステム下のジャーナル関係のファイルを削除します。

指定したファイルがオープン中の場合は，削除できません。

オプション

●-f　物理ファイル名　　～〈パス名〉

削除する物理ファイル名を完全パス名で指定します。

●-u

-fオプションで指定したファイルがシステムジャーナルファイル，またはアーカイブジャーナルファイルの場合，そのファイルがアンロード待ち状態であっても，強制的にファイルを削除します。チェックポイントダンプファイル，またはサーバリカバリジャーナルファイルの場合，-uオプションの指定は無視されます。

このオプションの指定を省略すると，-fオプションで指定したファイルがシステムジャーナルファイル，またはアーカイブジャーナルファイルの場合，そのファイルのアンロード状態がチェックされます。ファイルがアンロード待ち状態の場合は，コマンドエラーとなります。

jnlrput

名称

アンロードジャーナルファイル，またはグローバルアーカイブアンロードジャーナルファイルのレコード出力

形式

jnlrput 〔-t〔開始〕〔,終了〕〕〔-e〕〔-f〕〔-l〕〔-c キー〕
       〔-u トランザクショングローバル識別子
                                 〔,トランザクションブランチ識別子〕〕
       〔-o ジャーナル取得モード〔ジャーナル取得モード〕…〕
       〔-j レコード種別〔レコード種別〕…〕〔-q _trn〕〔-q _rpc〕
       〔-d 任意抽出条件〕〔-x〕〔ファイル名〔△ファイル名〕…〕

機能

指定したアンロードジャーナルファイル，またはグローバルアーカイブアンロードジャーナルファイル内のユーザジャーナルレコードの情報，トランザクションブランチのCPU使用時間情報，およびレスポンス統計情報を標準出力に出力します。

オプション

●-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からの西暦を4けたで指定します）

指定を省略できます。※

注※

開始，または終了の「年」の指定を省略した場合は，当年の指定月日時刻と見なされます。「年，月，日」の指定を省略した場合，当年当月当日の指定時刻と見なされます。「月，日」，「月」，または「日」だけを省略することはできません。省略した場合はオプションエラーになります。「月」または「日」を省略したい場合は，「年」，「月」，「日」のすべてを省略してください。

-tオプションの指定を省略すると，指定したファイル内のすべてのジャーナルを出力します。

●-e

コミット決着済みのユーザジャーナルレコード（UJ）だけを出力します。

-eオプションの指定を省略すると，すべてのユーザジャーナルレコード（UJ）を出力します。

●-f

最初のファイルから，コミット決着済みのユーザジャーナルレコードを出力します。このとき，ジャーナルファイルの先頭ブロック番号が1から昇順に連番かどうかをチェックします。エラーがあれば処理を終了します。

-fオプションは，-eオプションを指定したときだけ有効です。

-fオプションの指定を省略すると，前回のレコード出力処理からの引き継ぎがあるものとして，引き継ぎファイルの最終ブロック番号＋1から昇順に連番であることがチェックされます。エラーがあれば処理を終了します。

●-l

最後のファイルから，コミット決着済みのユーザジャーナルレコードを出力します。その後，引き継ぎファイルを削除します。

-lオプションは，-eオプションを指定したときだけ有効です。

-lオプションの指定を省略すると，次回のレコード出力処理への引き継ぎがあるものとして，引き継ぎファイルを作成します。

●-c　キー　　～((001～999))《001》

引き継ぎファイルの名称の一部を指定します。実際は，OpenTP1が「jnlrput***」という名称でファイルを作成し，***にはこのオプションで指定した値が設定されて，引き継ぎファイルの名称となります。

●-u　トランザクショングローバル識別子〔，トランザクションブランチ識別子〕

～〈33けたの英数字，特殊文字，および16進数字〉

出力するユーザジャーナルレコードをトランザクション識別子で指定します。トランザクション識別子は「トランザクショングローバル識別子，トランザクションブランチ識別子」の形式で指定します。

-uオプションの指定を省略すると，すべてのトランザクション識別子を出力します。

●-o　ジャーナル取得モード

ジャーナルの取得モードを指定します。複数のジャーナルの取得モードを指定できます。

c

トランザクションテストモードでコミット属性のジャーナル，またはMCFのトランザクション外テストモードのジャーナルを出力します。

r

トランザクションテストモードでロールバック属性のジャーナルを出力します。

s

オンラインテストモード以外のジャーナルを出力します。

-oオプションの指定を省略すると，すべてのジャーナル取得モードのジャーナルを出力します。

●-j　レコード種別

出力する内容をレコード種別で指定します。

レコード種別の指定値と内容を次に示します。

レコード種別 | 指定値 | 内容 | 備考
SJ | s | システム統計情報※ | 統計用ジャーナル
AJ | a | 送信完了情報
IJ | i | 入力キュー登録メッセージ
OJ | o | 出力キュー登録メッセージ
MJ | m | メッセージジャーナル
GJ | g | receive情報
UJ | u | ユーザ任意の情報 | ユーザジャーナル

注※

-qオプションに'_trn'を指定したときはトランザクションブランチのCPU使用時間情報を，'_rpc'を指定したときはレスポンス統計情報を出力します。

-jオプションの指定を省略すると，ユーザジャーナル（UJ）だけを出力します。

●-q　_trn

指定したファイル内のトランザクションブランチのCPU使用時間情報を出力します。

-qオプションの指定は，-jオプションにs（システム統計情報）を指定したときだけ有効です。

●-q　_rpc

指定したファイル内のレスポンス統計情報を出力します。

-qオプションの指定は，-jオプションにs（システム統計情報）を指定したときだけ有効です。

●-d　任意抽出条件

ユーザジャーナルレコード（UJ）を抽出する条件を指定します。

比較データとジャーナルレコードを比較して，比較記号で指定した条件を満たすジャーナルレコードを抽出します。抽出条件は255けた以内で指定します。

抽出条件の記述形式を次に示します。

 比較位置,〔比較記号〕,〔比較形式〕,比較データ
          〔,比較位置,〔比較記号〕,〔比較形式〕,比較データ〕

抽出条件は二つまで指定できます。

複数の抽出条件を指定した場合は，すべての条件を満たすジャーナルレコードを抽出します。

比較位置　　～〈16進数字〉((0～7faf8))
ユーザジャーナルレコードと比較する，比較データの位置を指定します。UAP履歴情報の先頭からの位置を指定してください。UJコードの場合は，"CODE"を指定します。

比較記号　　～《eq》
ユーザジャーナルレコードと比較するデータの比較条件を比較記号で指定します。

eq：UJのデータと比較するデータの内容が等しい。

（UJのデータ内容＝比較データの内容）

ne：UJのデータと比較データの内容が等しくない。

（UJのデータ内容≠比較データの内容）

gt：UJのデータが比較データの内容より大きい。

（UJのデータ内容＞比較データの内容）

ge：UJのデータが比較データの内容と等しい，または大きい。

（UJのデータ内容≧比較データの内容）

lt：UJのデータが比較データの内容より小さい。

（UJのデータ内容＜比較データの内容）

le：UJのデータ内容が比較データの内容と等しい，または小さい。

（UJのデータ内容≦比較データの内容）

比較形式　　～《x》
比較するデータの形式を指定します。ここで指定した形式に従って，ユーザジャーナルレコードと比較データが比較されます。
　x：16進形式
　c：文字形式

比較データ
比較するデータを指定します。16進形式で比較データを指定する場合は，0～9，a～f，またはA～Fの範囲を偶数けたで指定してください。
UJコードを指定する場合は，16進形式で8けた以内の偶数けたで指定してください。
シェルのメタキャラクタ，コンマ（，），およびスペースは指定できません。

●-x

トランザクション外のユーザジャーナルレコード（UJ）だけを出力します。

-xオプションの指定を省略すると，すべてのユーザジャーナルレコード（UJ）を出力します。

コマンド引数

●ファイル名　　～〈パス名〉

アンロードジャーナルファイル，またはグローバルアーカイブアンロードジャーナルファイルの名称を指定します。

マルチノード機能を使用している場合は，jnlsortコマンドでソート，およびマージ（ノードの抽出，ジャーナルサーバランIDの特定）した結果のファイル名を指定してください。

-eオプション指定時は，複数のファイルを指定できます。複数のファイルを指定するときは，ファイル名とファイル名との間を空白で区切ります。指定できるファイル数は256個までです。

このコマンド引数の指定を省略すると，標準入力と見なされます。

指定できるオプションとコマンド引数の組み合わせを次に示します。

（凡例）

○：指定できます。

×：指定できません。

－：無効です。

出力形式

UJを出力した場合のジャーナルレコード全体の出力形式を次に示します。

ファイル管理情報の大きさは128バイトです。

レコード情報の大きさは，レコード管理情報（3）内のレコード情報サイズにあります。

レコード管理情報の大きさは，ファイル管理情報（1）内のレコード管理情報サイズにあります。

UJレコードデータヘッダの大きさは，ファイル管理情報（1）内のレコードデータヘッダサイズにあります。

UJレコードデータの大きさは，次のとおりです。
[UJレコードデータの大きさ]＝[レコード情報の大きさ]－[レコード管理情報の大きさ＋UJレコードデータヘッダの大きさ]

各情報の詳細な出力形式を次に示します。

注※

トランザクションid有無フラグが0x00の場合，global_tran_id[12]エントリ，およびbranch_tran_id[12]エントリに0x00が設定されます。

1：

ファイル管理情報（出力結果全体の状態や内容）を示します。

2，3，4，5，6，7，8，9，10，11および12：

レコード情報です。

2：

レコード管理情報（該当するレコード情報全体の状態や内容）を表示します。

3，4，5，6，7，8，9，10，11および12：

レコードデータ（固定レコードデータを示すレコードヘッダと，浮動レコードデータを示すレコードデータ）を表示します。

ただし，トランザクションブランチのCPU使用時間情報の場合は，固定レコードデータを示すレコードデータヘッダだけを表示します。

また，レスポンス統計情報の場合は，固定レコードデータを示すレコードデータヘッダおよび第2レコードデータヘッダを表示します。

1から12の出力形式：

dcjup.hで定義されています。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA02600-E | アンロードジャーナルファイルのアクセスでエラーが発生しました | 標準エラー出力
KFCA02601-E | アンロードジャーナルファイルが不正です | 標準エラー出力
KFCA02602-E | ジャーナルブロックが不正です | 標準エラー出力
KFCA02603-E | ジャーナルレコードが不正です | 標準エラー出力
KFCA02604-E | メモリが確保できません | 標準エラー出力
KFCA02605-E | 引き継ぎファイルのアクセスでエラーが発生しました | 標準エラー出力
KFCA02606-E | 引き継ぎファイルが不正です | 標準エラー出力
KFCA02607-E | 引き継ぎファイルとアンロードジャーナルファイルの関係が不正です | 標準エラー出力
KFCA02622-W | 出力する対象レコードが存在しません | 標準エラー出力
KFCA02680-I | ヘルプメッセージ | 標準出力，標準エラー出力
KFCA02681-E | jnlrputコマンドのパラメタ不正，または制限値オーバです | 標準エラー出力
KFCA02682-E | jnlrputコマンドのオプションの組み合わせが不当です | 標準エラー出力
KFCA02683-E | jnlrputコマンドのオプションの指定に誤りがあります | 標準エラー出力
KFCA02684-E | jnlrputコマンドのファイル名の指定に誤りがあります | 標準エラー出力
KFCA02685-E | jnlrputコマンドで抽出対象レコードが不正です | 標準エラー出力

注意事項

出力範囲を指定する場合，開始時刻，または終了時刻と一致するジャーナルレコードがないときは，開始時刻と終了時刻との間にあるジャーナルレコードが出力対象となります。

開始時刻が終了時刻より遅くなるように出力範囲を指定するときは，必ず「月」「日」，または「月」「日」「年（西暦）」を指定して，終了時刻が開始時刻よりあとになるようにしてください。省略するとエラーになります。日付を省略すると，jnlrputコマンドを入力した年月日と見なすため，出力範囲が該当する年月日以外の日付の場合は，必ず「月」「日」，または「月」「日」「年（西暦）」を指定してください。

ファイル名の指定を省略すると，標準入力からの入力となります。そのため，入力ファイルをパイプ，リダイレクションなどで指定してください。

-eオプション指定時，指定した引き継ぎファイルがすでにある場合は，既存のファイルを「jnlrput***.bak」という名称で残します。

-eオプションを指定したjnlrputコマンドを複数回実行して，複数のアンロードジャーナルファイルからコミット決着済みのユーザジャーナルレコード（UJ）を出力する場合，-cオプションには，それぞれのjnlrputコマンドですべて同じ値を指定してください。

-eオプションを指定して，複数のアンロードジャーナルファイル，またはグローバルアーカイブアンロードジャーナルファイルからレコードを抽出する場合，同一オンライン中に出力されたジャーナルファイルである必要があります。

RPCがタイムアウトした場合，レスポンス統計情報第2レコードヘッダのレスポンスタイム（res_min_data，res_miq_data）に，-1が設定されます。レスポンスタイム以外は0が設定されます。

-eオプションを指定した場合，jnlunlfgコマンドに-tオプションを指定して取得したアンロードジャーナルファイルを指定しないでください。指定した場合，KFCA02601-Eメッセージが出力されます。

このコマンドで入力できる文字数はご使用のOSによって変わります。入力文字数が上限値を超えるとエラーになります。

指定したファイル数が256個以下の場合でも，1プロセスでオープンできるファイルの最大数を超えるとエラーになります。

レコード管理情報の「トランザクショングローバル識別子」および「トランザクションブランチ識別子」の領域に設定される内容は，メッセージなどで出力されるグローバルトランザクションIDとは最後の4バイトが異なります（unsigned DCLONG型数値が設定されます）。

使用例

アンロードジャーナルファイルから，CPU使用時間情報を出力する場合

jnlrput -j s -q _trn /tp1/jnl/sysjnl001

三つのファイルに分割しているアンロードジャーナルファイルから，コミット決着済みのユーザジャーナルレコード（UJ）を1回で出力する場合

jnlrput -e -f -l /tp1/jnl/sysjnl001 /tp1/jnl/sysjnl002 /tp1/jnl/sysjnl003

四つのファイルに分割しているアンロードジャーナルファイルから，コミット決着済みのユーザジャーナルレコード（UJ）を3回で出力する場合

<1回目>
jnlrput -e -f /tp1/jnl/sysjnl001 /tp1/jnl/sysjnl002
<2回目>
jnlrput -e /tp1/jnl/sysjnl003
<3回目>
jnlrput -e -l /tp1/jnl/sysjnl004

アンロードジャーナル中の2003年1月1日0時0分0.0秒から2003年12月31日23時59分59.999999秒までのシステム統計情報（SJ）を出力する場合
アンロードジャーナルファイル：sysjnl001

jnlrput -t 00000001012003,23595912312003 -j s /tp1/jnl/sysjnl001

jnlsort

名称

アンロードジャーナルファイル，およびグローバルアーカイブアンロードジャーナルファイルの時系列ソート，およびマージ

形式

jnlsort 〔-n ノード識別子〕〔-g〕
       〔-i 〔開始ジャーナルサーバランID〕
                                 〔,終了ジャーナルサーバランID〕〕
       〔ファイル名〔△ファイル名〕…〕

機能

指定されたアンロードジャーナルファイル，およびグローバルアーカイブアンロードジャーナルファイルの内容をブロック単位で時系列にソート，およびマージします。結果は，グローバルアーカイブアンロードジャーナルファイルの形式で，標準出力に出力します。

オプション

●-n　ノード識別子　　～〈4文字の英数字記号〉

指定したノード識別子を持つジャーナルブロックだけをソート，およびマージします。

ノード識別子は，先頭文字を英字で，2文字目以降を英数字で指定します。

このオプションの指定を省略すると，ノード識別子単位にはソート，およびマージされません。

●-g

ジャーナルブロックのマージだけを実行し，ソートを抑止する場合に指定します。

複数のアンロードジャーナルファイル，およびグローバルアーカイブアンロードジャーナルファイルを指定した場合は，ランID（同一オンラインの場合は世代番号）の昇順でファイルを順番にマージします。この場合もジャーナルブロックのソートはしません。また，このオプションを指定した場合は作業用ファイルは作成されません。

●-i　〔開始ジャーナルサーバランID〕〔，終了ジャーナルサーバランID〕

～〈1～8けたの16進数字〉((0～ffffffff))

指定したジャーナルサーバランIDを持つジャーナルブロックだけをソート，およびマージします。

-iオプションを指定する場合，開始ジャーナルサーバランID，または終了ジャーナルサーバランIDのどちらか一方は必ず指定してください。両方とも指定する場合は，「開始ジャーナルサーバランID≦終了ジャーナルサーバランID」となるように指定してください。

開始ジャーナルサーバランIDを省略した場合は，0から指定した終了ジャーナルサーバランIDまでがソート，およびマージの範囲となります。

終了ジャーナルサーバランIDを省略した場合は，指定した開始ジャーナルサーバランIDからffffffffまでがソート，およびマージの範囲となります。

このオプションの指定を省略すると，ジャーナルサーバランID単位にはソート，およびマージされません。

コマンド引数

●ファイル名　　～〈パス名〉

アンロードジャーナルファイル名，およびグローバルアーカイブアンロードジャーナルファイル名を指定します。指定できるファイル数は256個までです。

省略した場合は，標準入力が入力されます。-nオプションの指定を省略した場合は，必ず指定してください。

指定できるオプションとコマンド引数の組み合わせを次に示します。

オプション | -n | -g | -i | アンロードジャーナルファイル | グローバルアーカイブアンロードジャーナルファイル
-n | － | ○ | ○ | ○ | ○
-g | ○ | － | ○ | ○ | ○
-i | ○ | ○ | － | ○ | ○
アンロードジャーナルファイル | ○ | ○ | ○ | － | ○
グローバルアーカイブアンロードジャーナルファイル | ○ | ○ | ○ | ○ | －

（凡例）

○：指定できます。

－：指定は無効になります。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA02600-E | アンロードジャーナルファイルのアクセスでエラーが発生しました | 標準エラー出力
KFCA02601-E | アンロードジャーナルファイルが不正です | 標準エラー出力
KFCA02602-E | ジャーナルブロックが不正です | 標準エラー出力
KFCA02603-E | ジャーナルレコードが不正です | 標準エラー出力
KFCA02604-E | メモリが確保できません | 標準エラー出力
KFCA02690-I | ヘルプメッセージ | 標準出力，標準エラー出力
KFCA02691-E | jnlsortコマンドのパラメタ不正，または制限値オーバです | 標準エラー出力
KFCA02692-E | jnlsortコマンドのオプションの組み合わせが不当です | 標準エラー出力
KFCA02693-E | jnlsortコマンドのオプションの指定に誤りがあります | 標準エラー出力
KFCA02694-E | jnlsortコマンドのファイル名の指定に誤りがあります | 標準エラー出力
KFCA02695-E | jnlsortコマンドで使用するワークファイルでアクセスエラーが発生しました | 標準エラー出力
KFCA02696-E | jnlsortコマンド対象のブロックがありません | 標準エラー出力

注意事項

jnlsortコマンドでは，OSのsortコマンドを使用するため，一時的に作業用ファイルを作成します。jnlsortコマンドで作成する作業用ファイルを次に示します。

ファイル名 | ディレクトリ | ファイルサイズ
sort_i＋プロセスID | カレントディレクトリ | 256バイト×ソート対象ブロック件数
sort_o＋プロセスID | カレントディレクトリ | 256バイト×ソート対象ブロック件数

標準入力を指定した場合（コマンド引数のファイル名を省略した場合）は，グローバルアーカイブアンロードジャーナルファイルだけ入力できます。

このコマンドで入力できる文字数はご使用のOSによって変わります。入力文字数が上限値を超えるとエラーになります。

指定したファイル数が256個以下の場合でも，1プロセスでオープンできるファイルの最大数を超えるとエラーになります。

jnlstts

名称

稼働統計情報の出力

形式

jnlstts 〔-e 編集項目〕〔-u 編集単位〕〔-l 行〕〔-c〕
       〔-i 時間間隔〕〔-t〔開始〕〔,終了〕〕
       〔-s ｛サーバ名｜サービス名｝ 〕
       〔ファイル名〕

機能

指定したアンロードジャーナルファイル，またはグローバルアーカイブアンロードジャーナルファイルから統計情報を収集し，編集後，標準出力へ出力します。

出力する情報を次に示します。

システム統計情報（システム統計レコード内の各コンポーネント情報）

トランザクション統計情報（システム統計レコード内の各トランザクションの情報）

レスポンス統計情報（システム統計レコード内の各レスポンスタイムの情報）

通信遅延時間統計情報（システム統計レコード内の通信遅延に関する情報）

オプション

●-e　編集項目　　～《all》

編集項目を指定します。

　sys：システム統計情報を出力します。

　trn：トランザクション統計情報を出力します。

　rsp：レスポンス統計情報を出力します。

　dly：通信遅延時間統計情報を出力します。

　all：上記すべての情報を編集します。

●-u　編集単位　　～《srv》

編集単位を指定します。

srv：サーバ名単位で編集します。

srvを指定すると，-sオプションにはサーバ名を指定したと見なされます。

svc：サービス名単位で編集します。

svcを指定すると-sオプションにはサービス名を指定したと見なされます。

-uオプションの指定は，-eオプションでtrn，またはallを指定した場合に有効です。

●-l　行　　～〈符号なし整数〉((12～256))《24》

1ページの出力行数を指定します。

●-c

稼働統計情報の編集結果を，CSV形式で出力します。

●-i　時間間隔

稼働統計情報を編集し，出力する時間の間隔を，時間間隔，または分間隔で指定します。

h〔HH〕：時間間隔（01≦HH≦24）で出力します。

HHの指定を省略すると，1時間間隔で出力します。

m〔MM〕：1分間隔（01≦MM≦09），または10分間隔（10≦MM≦30）で出力します。

MMの指定を省略すると，10分間隔で出力します。

時間間隔と分間隔の両方を指定すると，エラーとなります。

-iオプションの指定を省略すると，1時間間隔で出力します。

●-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からの西暦を4けたで指定します）

指定を省略できます。※

注※

開始，または終了の「年」の指定を省略した場合は，当年の指定月日時刻と見なされます。「年，月，日」の指定を省略した場合，当年当月当日の指定時刻と見なされます。「月，日」，「月」，または「日」だけを省略することはできません。省略した場合はオプションエラーになります。「月」または「日」を省略したい場合は，「年」，「月」，「日」のすべてを省略してください。

-tオプションの指定を省略すると，指定したファイル内のすべての情報を編集出力します。

●-s　サーバ名　　～〈1～8文字の英数字〉

統計情報を編集出力したいサーバの名称を指定します。

-eオプションでsysを指定し，サーバ名の指定を省略した場合は，すべてのサーバの統計情報が出力されます。

-uオプションでsrvを指定した場合，-sオプションにはサーバ名を指定したと見なされます。

-eオプションでsysを指定し，サーバ名にSYSTEMと指定すると，システム全体の統計情報が出力されます。

●-s　サービス名　　～〈1～31文字の英数字〉

統計情報を編集出力したいサービスの名称を指定します。

-eオプションでtrnを指定し，-uオプションでsvcを指定し，サービス名の指定を省略した場合は，すべてのサービスの統計情報を出力します。

-uオプションでsvcを指定した場合，-sオプションにはサービス名を指定したと見なされます。

-e，および-uオプションと-sオプションとの組み合わせを次に示します。

-eオプション | -uオプション | -sオプション | 出力対象 | 備考
sys | － | サーバ名 | 指定したサーバのシステム統計情報 | －
SYSTEM | システム全体の統計情報 | －
trn | srv | サーバ名 | 指定したサーバのトランザクション統計情報 | －
svc | サービス名 | 指定したサービスのトランザクション統計情報 | －
省略 | サーバ名 | 指定したサーバのトランザクション統計情報 | －
rsp | － | サービス名 | 指定したサービスのレスポンス統計情報 | －
dly | － | － | すべての通信遅延時間統計情報 | －
all | srv | サーバ名 | 指定したサーバに関するすべての統計情報 | レスポンス統計情報，通信遅延時間統計情報は全データ出力
svc | サービス名 | 指定したサービスに関するすべての統計情報 | システム統計情報，通信遅延時間統計情報は全データ出力
省略 | サーバ名 | 指定したサーバに関するすべての統計情報 | レスポンス統計情報，通信遅延時間統計情報は全データ出力

（凡例）

－：指定できません。または，該当しません。

jnlsttsコマンドで指定できるオプションの組み合わせを次に示します。

（凡例）

○：指定できます。

×：指定できません。

－：無効です。

注※1

-uオプションでsrvを指定した場合，または-uオプションの指定を省略した場合は，-sオプションにはサーバ名を指定したと見なされます。

注※2

-uオプションでsvcを指定した場合，-sオプションにはサービス名を指定したと見なされます。

コマンド引数

●ファイル名　　～〈パス名〉

アンロードジャーナルファイル，またはグローバルアーカイブアンロードジャーナルファイルの名称を指定します。

マルチノード機能を使用している場合は，jnlsortコマンドでソート，およびマージ（ノードの抽出，ジャーナルサーバランIDの特定）した結果のファイル名を指定してください。

このコマンド引数の指定を省略すると，標準入力と見なされます。

出力形式

●システム統計情報の場合

出力形式を次に示します。

-cオプションを指定したときの出力形式を次に示します（CSV形式）。

1：指定されたサーバ名ごとに，取得コンポーネントの統計情報を編集して表示します。

2～8：1行で表示します。

aa...aa：ファイルの名称（59文字以内）

bb...bb：ファイルの作成日時

cc...cc：-tオプション指定開始時刻（-tオプション省略時は'*'を設定）

dd...dd：-tオプション指定終了時刻（-tオプション省略時は'*'を設定）

ee...ee：ノード識別子

ffffffff：サーバの名称
'SYSTEM'と表示された場合は，システム全体の統計情報であることを示します。

gg...gg：システム統計情報の編集開始時間

hh...hh：システム統計情報の編集終了時間

xx...xx：統計情報（10けた以内の10進数。イベント数，平均値がオーバフローした場合は'*'を，最大値，最小値，平均値の編集データがない場合は'-'を設定）

vv-rr：バージョン番号－リビジョン番号

yyyy：ページ

●トランザクション統計情報の場合

-uオプションでsrvを指定した場合，または-uオプションの指定を省略した場合は，サーバ名単位で編集します。-uオプションでsvcを指定した場合は，サービス名単位で編集します。

出力形式を次に示します。

注※1

-uオプションでsvcを指定した場合は，「サービス名」を出力します。

注※2

-uオプションでsvcを指定した場合は，「ユーザサーバ名」を出力します。

-cオプションを指定したときの出力形式を次に示します（CSV形式）。

1：サービス名単位に繰り返し表示します。
-uオプションでsvcを指定した場合は，サーバ名単位に繰り返し表示します。

2～17：1行で表示します。

aa...aa：ファイルの名称（59文字以内）

bb...bb：ファイルの作成日時

cc...cc：-tオプション指定開始時刻（-tオプション省略時は'*'を設定）

dd...dd：-tオプション指定終了時刻（-tオプション省略時は'*'を設定）

ee...ee：ノード識別子

ffffffff：ユーザサーバの名称
-uオプションでsvcを指定した場合は，サービスの名称を出力します。

gg...gg：トランザクション統計情報の編集開始時間

hh...hh：トランザクション統計情報の編集終了時間

iiiiiiii：サービスの名称（サービス名がない場合は'*'を設定）
-uオプションでsvcを指定した場合は，ユーザサーバの名称を出力します。

xx...xx：統計情報（10けた以内の10進数。平均値は小数点以下1けたを四捨五入して表示。また，最大値，最小値，平均値がオーバフローした場合は'*'を，編集データがない場合は'-'を設定）

vv-rr：バージョン番号－リビジョン番号

yyyy：ページ

●レスポンス統計情報の場合

出力形式を次に示します。

-cオプションを指定したときの出力形式を次に示します（CSV形式）。

注

MHPのサービス実行時間，およびサービス待ち時間は取得されません。

1：サービス名単位に繰り返し表示します。

2～6：1行で表示します。

aa...aa：ファイルの名称（59文字以内）

bb...bb：ファイルの作成日時

cc...cc：-tオプション指定開始時刻（-tオプション省略時は'*'を設定）

dd...dd：-tオプション指定終了時刻（-tオプション省略時は'*'を設定）

ee...ee：ノード識別子

ff...ff：サービスグループの名称

gg...gg：レスポンス統計情報の編集開始時間

hh...hh：レスポンス統計情報の編集終了時間

ii...ii：サービスの名称

xx...xx：統計情報（10けた以内の10進数。平均値は小数点以下1けたを四捨五入して表示。また，最大値，最小値，平均値がオーバフローした場合は'*'を，編集データがない場合は'-'を設定）

vv-rr：バージョン番号－リビジョン番号

yyyy：ページ

●通信遅延時間統計情報の場合

出力形式を次に示します。

-cオプションを指定したときの出力形式を次に示します（CSV形式）。

1：送信先ノード識別子単位に繰り返し表示します。

2～4：1行で表示します。

aa...aa：ファイルの名称（59文字以内）

bb...bb：ファイルの作成日時

cc...cc：-tオプション指定開始時刻（-tオプション省略時は'*'を設定）

dd...dd：-tオプション指定終了時刻（-tオプション省略時は'*'を設定）

ee...ee：ノード識別子

ff...ff：送信先ノード識別子

gg...gg：通信遅延時間統計情報の編集開始時間

hh...hh：通信遅延時間統計情報の編集終了時間

xx...xx：統計情報（10けた以内の10進数。平均値は小数点以下1けたを四捨五入して表示。また，最大値，最小値，平均値がオーバフローした場合は'*'を設定）

vv-rr：バージョン番号－リビジョン番号

yyyy：ページ

出力メッセージ

メッセージID | 内容 | 出力先
KFCA02600-E | アンロードジャーナルファイルのアクセスでエラーが発生しました | 標準エラー出力
KFCA02601-E | アンロードジャーナルファイルが不正です | 標準エラー出力
KFCA02602-E | ジャーナルブロックが不正です | 標準エラー出力
KFCA02603-E | ジャーナルレコードが不正です | 標準エラー出力
KFCA02604-E | メモリが確保できません | 標準エラー出力
KFCA02660-I | ヘルプメッセージ | 標準出力，標準エラー出力
KFCA02661-E | jnlsttsコマンドのパラメタ不正，または制限値オーバです | 標準エラー出力
KFCA02662-E | jnlsttsコマンドのオプションの組み合わせが不当です | 標準エラー出力
KFCA02663-E | jnlsttsコマンドのオプションの指定に誤りがあります | 標準エラー出力
KFCA02664-E | jnlsttsコマンドのファイル名の指定に誤りがあります | 標準エラー出力
KFCA02665-E | jnlsttsコマンドの-lオプションの指定値が小さ過ぎるため統計情報を出力できません | 標準エラー出力

注意事項

稼働統計情報の出力範囲を指定する場合の開始時刻，または終了時刻と一致するジャーナルレコードがないときは，開始時刻と終了時刻の間にあるジャーナルレコードが出力対象になります。

開始時刻が終了時刻より遅くなるように稼働統計情報の出力範囲を指定するときは，必ず「月」「日」，または「月」「日」「年（西暦）」を指定して，終了時刻が開始時刻よりあとになるようにしてください。省略するとエラーになります。日付を省略すると，jnlsttsコマンドを入力した年月日と見なすため，出力範囲が該当する年月日以外の日付の場合は，必ず「月」「日」，または「月」「日」「年（西暦）」を指定してください。

稼働統計情報の編集出力開始時刻は，-tオプションで開始時刻を指定するか，指定しないかによって異なります。指定した場合，-tオプションの開始時刻が含まれる時間帯から出力します。指定しなかった場合，該当するファイルの先頭のSJレコード時刻が含まれる時間帯から出力します。ここでいう時間帯とは，それぞれの開始時刻の時間（hh：00）を基に，-iオプションで指定した時間間隔で区切った間隔のことです。
jnlsttsコマンドの-t，-iオプションの指定と，稼働統計情報（SJ）のアンロードジャーナルファイルへの出力時刻との関係を次に示します。

| -tオプションで指定した開始時刻 | SJのアンロードジャーナルファイルへの出力時刻 | -iオプションで指定した時間間隔 | 出力開始時刻 | 備考
例1 | 9時0分0秒 | 9時10分0秒 | 10分 | 9:00～9:10 | 9：00～9：10に該当する範囲は，9時0分0秒から9時9分59秒までで，この時間帯にSJは含まれていません。したがって，SJは次の時間帯に出力されます。
例2 | 9時0分0秒 | 8時50分0秒 | 7分 | 9:00～9:07 | SJは，-tオプションの指定開始時刻より前に出力されています。したがって，SJは出力対象外となり，jnlsttsコマンドを実行しても出力できません。
例3 | 指定なし | 9時5分34秒 | 4分 | 9:04～9:08 | 9時4分0秒から9時7分59秒までのSJが出力されます。
例4 | 指定なし | 9時37分0秒 | 30分 | 9:30～10:00 | 9時30分0秒から9時59分59秒までのSJが出力されます。
例5 | 9時29分59秒 | 9時30分0秒 | 30分 | 9:00～9:30 | 9：00～9：30に該当する範囲は，9時0分0秒から9時29分59秒までで，この時間帯にSJは含まれていません。したがって，SJは次の時間帯に出力されます。

稼働統計情報の出力終了時刻を指定すると，指定終了時刻を含む時間帯まで出力されます。例えば，-tオプションで終了時刻を9時0分0秒と指定し，-iオプションで時間間隔を30分と指定すると，最終時間帯は9:00～9:30ですが，実際は9時0分0秒の稼働統計情報が出力されます。

システム統計情報の場合，編集した平均値は小数点以下1けたを切り捨てて出力します。

トランザクション統計情報の場合，編集した平均値は小数点以下1けたを四捨五入して出力します。

イベント数，平均値がオーバフローして'*'が設定された場合でも，最大値と最小値は保証されます。

取得編集時間帯にデータがない場合は，その時間帯に'該当データなし'を出力します。

ファイル名の指定を省略すると，標準入力からの入力となります。そのため，入力ファイルをパイプ，リダイレクションなどで指定してください。

レスポンス統計情報の場合で，レスポンスタイム取得失敗の統計情報だけが取得されていた場合，データにはすべて0が出力されます。

-tオプションの終了時刻の「年」に2038年を超える値を指定すると，CPU消費量およびメモリ所要量が増大してコマンドを終了するまでに時間が掛かる場合があります。

OSの時刻補正機能などによる時刻戻しが発生して取得編集時間帯のデータがマイナス値になった場合，その時間帯の最大値，最小値，および平均値に'*'を出力します。

jnlsttsコマンドでは，編集する稼働統計情報の項目，出力範囲，または時間間隔によってメモリ所要量が異なります。次に示す見積もり式に従って，メモリ所要量を算出してください（単位：バイト）。

（凡例）

↑↑：小数点以下を切り上げます。

A：サーバ数。-uオプションにsvcを指定した場合はサービス数になります。

B：サービスグループ数。

注※1

システムジャーナルサービス定義のjnl_max_datasizeオペランドの指定値になります。

注※2

-tオプションで指定した編集開始から終了までの時間を，-iオプションで指定した時間間隔の値で割った値です。データがない時間帯はカウントしません。

注※3

-uオプションにsvcを指定した場合はサービス数になります。

注※4

-uオプションにsvcを指定した場合は各サービスのサーバ数になります。

使用例

アンロードジャーナルファイルの先頭から1993年5月29日17時30分0.999999秒までのシステム統計情報を，30分間隔で編集出力する場合

　アンロードジャーナルファイル：sysjnl001

jnlstts -e sys -i m30 -t ,17300005291993 /tp1/jnl/sysjnl001

上記の例の場合，最終時間帯は17:30～18:00ですが，1993年5月29日17時30分0.0秒から1993年5月29日17時30分0.999999秒までのシステム統計情報を出力します。

jnlswpfg

名称

ジャーナル関係のファイルのスワップ

形式

jnlswpfg -j sys｜jar 〔-r リソースグループ名〕

機能

現用のファイルグループを即時に切り替えます。スワップ先のファイルグループがない場合は，コマンドエラーとなります。

jnlswpfgコマンドは，OpenTP1が動作中で，かつジャーナルサービスが動作中のときだけ入力できます。

オプション

●-j　sys｜jar

スワップするジャーナル関係のファイルを指定します。

　sys：システムジャーナルファイル

　jar：アーカイブジャーナルファイル

●-r　リソースグループ名　　～〈1～8文字の識別子〉

-jオプションでjarを指定している場合，スワップするファイルのリソースグループの名称を指定します。グローバルアーカイブジャーナルサービス定義の定義コマンドjnldfsv -aで指定したアーカイブジャーナルサービス定義の定義ファイル名を指定してください。

このオプションの指定を省略すると，オンライン中のアーカイブジャーナルファイルのうちから，アーカイブジャーナルサービス定義の定義コマンドjnldfsv -aの先頭に定義したファイル名が仮定されます。

-jオプションでjar以外を指定している場合，-rオプションの指定は無視されます。

出力メッセージ

メッセージID
内容
出力先

KFCA01141-E
実行環境がジャーナルファイルレスモードのため，コマンドを実行できません
標準エラー出力

KFCA01280-E
jnlswpfgコマンドの処理が失敗しました
標準エラー出力

KFCA01281-E
jnlswpfgコマンドの入力形式が誤っています
標準エラー出力

KFCA01285-E
スワップ処理中です
標準エラー出力

KFCA01286-E
スワップ先がありません
標準エラー出力

KFCA01290-I
ヘルプメッセージ
標準出力，
標準エラー出力

jnlunlfg

名称

ジャーナル関係のファイルのアンロード

形式

jnlunlfg -j sys｜jar 〔〔-f〕｜〔-t〔開始〕〔,終了〕〕〕
      〔-r リソースグループ〕〔-R ランID〕
      〔-g ファイルグループ名〕
      〔-o 出力先ファイル名〕
      〔-d サービス定義名〕〔-n〕

機能

指定したファイルグループを出力先のファイル，または標準出力へアンロードし，ファイルグループをアンロード済み状態にします。

KFCA01222-Iメッセージが出力されたら，jnlunlfgコマンドを実行してアンロードしてください。

ただし，現用ファイルグループ，およびアンロード済みのファイルグループは-fオプションを指定しないとアンロードできません。

アーカイブジャーナルをアンロードする場合，アンロードが完了するとアンロード情報を出力します。

オプション

●-j　sys｜jar

アンロードするジャーナル関係のファイルを指定します。

　sys：システムジャーナルファイル

　jar：アーカイブジャーナルファイル

●-f

ファイルグループの状態をチェックしないでアンロードします。そのため，現用ファイルグループ，またはアンロード済みのファイルグループをアンロードできます。ただし，ファイルグループの状態は変更されません。

スワップ先にできる状態（アンロード済みで，かつ上書きできる状態）のファイルグループを，-fオプションを指定してアンロードすると，アンロード中に現用ファイルグループとなることがあります。この場合，オンラインでのジャーナル取得を追い越してアンロードされると，障害を検知してコマンドエラーとなります。そのため，アンロード済みのファイルグループは，-fオプションを指定してアンロードする前に，一度jnlclsfgコマンドでクローズしてください。

実行系OpenTP1でのアンロードジャーナルファイルは，待機系OpenTP1には引き継がれません。この場合，待機系OpenTP1で-fオプションを指定したjnlunlfgコマンドでアンロードできます。ただし，他系OpenTP1で該当するアンロードジャーナルファイルを使用していないときに，jnlunlfgコマンドを実行してください。

●-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からの西暦を4けたで指定します）

指定を省略できます。※

注※

システムに設定しているタイムゾーンによって指定できる範囲が異なります。例えば，TZ環境変数に「JST-9」と設定している場合は，1970年1月1日9時0分0秒からが指定できる範囲となります。

開始，または終了の「年」の指定を省略した場合は，当年の指定月日時刻と見なされます。「年，月，日」の指定を省略した場合，当年当月当日の指定時刻と見なされます。「月，日」，「月」，または「日」だけを省略することはできません。省略した場合はオプションエラーになります。「月」または「日」を省略したい場合は，「年」，「月」，「日」のすべてを省略してください。

このオプションの指定を省略すると，指定したファイル内のすべての情報をアンロードします。

このオプションを指定した場合，-fオプションは指定できません。また，このオプションを指定してアンロードしても，ファイルグループの状態は変更されません。

-tオプションおよび-Rオプションを指定して，-gオプションを省略した場合，-Rオプションで指定したランIDのファイルグループのうち，最も古い世代のファイルグループ内の-tオプションで指定した範囲をアンロードします。

-tオプションを指定して，-Rオプションおよび-gオプションを省略した場合，最新のランIDのファイルグループのうち，最も古い世代のファイルグループ内の-tオプションで指定した範囲をアンロードします。

●-r　リソースグループ名　　～〈1～8文字の識別子〉

アンロードするファイルのリソースグループの名称を指定します。

-jオプションでsysを指定している場合，システムジャーナルサービス定義の定義ファイル名を指定します。

-jオプションでjarを指定している場合，アンロードするアーカイブジャーナルサービス定義の定義ファイル名を指定します。

このオプションの指定を省略すると，-jオプションでsysを指定している場合，$DCCONFPATH/jnlのジャーナルサービス定義で指定されているリソースグループ名が仮定されます。-jオプションでjarを指定している場合，$DCCONFPATH/jarのグローバルアーカイブジャーナルサービス定義の定義コマンドjnldfsv -aの先頭に定義されたファイル名が仮定されます。

●-R　ランID

アンロードするジャーナルファイルグループのランIDを指定します。

このオプションを省略した場合は，-gオプションの指定に従います。

●-g　ファイルグループ名　　～〈1～8文字の識別子〉

アンロードするジャーナル関係のファイルのファイルグループ名を指定します。

このオプションを省略すると，アンロード待ち状態のファイルグループの中で，最も古い世代をアンロードします。また，-fオプションは指定できません。

-Rオプションとの組み合わせとアンロードされるジャーナルファイルグループを次に示します。

オプション
-R

指定あり
指定なし

-g
指定あり
-gで指定したファイルグループをアンロードします。
-Rで指定したランIDと-gで指定したファイルグループのランIDが一致しない場合，コマンドエラーになります。
-gで指定したファイルグループをアンロードします。

指定なし
-Rで指定したランIDのファイルグループのうち，最も古い世代のファイルグループをアンロードします。
最新のランIDのファイルグループのうち，最も古い世代のファイルグループをアンロードします。

●-o　出力先ファイル名　　～〈パス名〉

出力先のファイルの名称を指定します。

このオプションの指定を省略すると，標準出力へ出力されます。

●-d　サービス定義名　　～〈パス名〉または〈ファイル名〉

アンロードするファイルグループを定義しているシステムジャーナルサービス定義ファイル名を，次のどちらかで指定します。

/（ルート）で始まる完全パス名を指定

定義ファイル名だけを指定

定義ファイル名だけを指定する場合，$DCCONFPATHに定義ファイルが格納されているディレクトリがセットされていなければなりません。

このオプションの指定を省略すると，-rオプションの指定に従います。

●-n

ファイルグループの状態を変更しないで，アンロード待ちの状態を継続します。

このオプションを指定することによって，同一世代に対して繰り返しアンロードでき，複数のアンロードファイルを作成できます。

系切り替え機能を使用している場合，待機系OpenTP1では-nオプションを指定したjnlunlfgコマンドでアンロードできます。このときファイルグループの状態は変更されません。そのため，実行系OpenTP1でjnlchgfgコマンドを実行して，ファイルグループの状態をアンロード済みにします。この方法で，実行系OpenTP1のアンロードの負荷を待機系OpenTP1に分散できます。

出力形式

アーカイブジャーナルファイルをアンロードした場合の出力形式を次に示します。

ファイルグループ内でランIDごとに表示します。

aa...aa：ノード識別子（4文字の識別子）

bbb：ファイル種別

sys…システムジャーナルファイル

cccccccc：リソースグループ名

dddddddd：ランID（先頭に0xを付けて，16進数字8けたで表示）

eeeeeeee：世代番号（先頭に0xを付けて，16進数字8けたで表示）

ffffffff：ブロック番号（先頭に0xを付けて，16進数字8けたで表示）

gg...gg：ジャーナルブロックの取得時刻（年－月－日　時：分：秒の形式で表示）

出力メッセージ

メッセージID | 内容 | 出力先
KFCA01141-E | 実行環境がジャーナルファイルレスモードのため，コマンドを実行できません | 標準エラー出力

注意事項

jnlunlfgコマンドは，ジャーナルサービス開始処理中に実行してはなりません。ジャーナルサービス開始処理中とは，正常開始時はKFCA01100-IからKFCA01102-Iまで，再開始時はKFCA01101-IからKFCA01102-Iまでのことです。実行した場合，システムジャーナルファイルの状態がOpenTP1に反映されないことがあります。この場合，ジャーナルサービスの開始処理，または再開始処理完了後にjnlclsfgコマンドで該当するファイルグループをクローズし，その後，jnlopnfgコマンドでオープンすると，システムジャーナルファイルの状態が反映されます。

jnlunlfgコマンドは，定義ファイルを参照して実行されます。このため，ジャーナルを取得したオンライン時とjnlunlfgコマンド実行時の定義ファイルが一致していないと，きちんとアンロードできません。

ジャーナルを取得したオンライン時とjnlunlfgコマンド実行時の定義ファイルが異なる場合に-d，または-rオプションを指定します。バックアップ先のディレクトリが$DCCONFPATHでないときは-dオプションを指定し，ファイル名が変更されたときは-rオプションを指定してください。ただし，この場合でもシステムジャーナルサービス定義，またはアーカイブジャーナルサービス定義は，ジャーナルを取得したオンライン時の定義がバックアップされている必要があります。

-tオプションを指定して出力したアンロードしたファイルには，次のコマンドを使用しないでください。

damfrc

tamfrc

jnlcolc

jnlrput（-eオプションを指定する場合だけ使用できません）

OpenTP1停止直後には，jnlunlfgコマンドを入力しないでください。コマンドが中断するおそれがあります。

lckls

名称

排他情報の表示

形式

lckls ｛〔-a〕〔サーバ名〕｜〔-r 資源名称〕｝

機能

排他情報を標準出力に出力します。

オプション

●-a

排他資源の占有，および待ち情報を表示します。

このオプションの指定を省略すると，待ち情報だけ表示します。

●-r　資源名称

指定した資源の占有，および待ち情報を表示します。このオプションを指定した場合，指定した文字列（資源名称）に対して前方一致検索を行い，該当する資源の情報をすべて表示します。

コマンド引数

●サーバ名　　～〈1～8文字の識別子〉

サーバ名に指定したユーザサーバについての情報を標準出力に表示します。指定した文字列（ユーザサーバ名称）に対して前方一致検索を行い，該当するユーザサーバについての情報をすべて標準出力に出力します。

このコマンド引数の指定を省略すると，排他情報があるすべてのユーザサーバに関する情報が表示されます。

出力形式

1，および2：1行で表示します。ただし，占有，および待ち情報が複数ある場合，その数だけ2を繰り返し表示します。

aa...aa：サーバ名（8文字以内）

bbbbb：プロセスID（10進数）

cc...cc：資源名称（16文字以内）

ddd：サーバID（3文字）

ee：排他制御モード（2文字）

EX…ほかのUAPに対して，参照，更新を許可しません。

PR…ほかのUAPに対して，参照だけを許可します。

fffffff：要求種別（7文字以内）

MIGRATE…TAMサービスのロック要求，またはユーザのロック要求

BRANCH…DAMサービスのロック要求

ggggg：待ち時間（10進数，単位：秒）
占有情報の場合は*****が表示されます。

hhh：デッドロックプライオリティ値（10進数）

iii：排他待ちプライオリティ値（10進数）

出力メッセージ

メッセージID
内容
出力先

KFCA00430-E
lcklsコマンドが実行できません
標準エラー出力

KFCA00431-I
ヘルプメッセージ
標準出力，
標準エラー出力

KFCA00433-E
lcklsコマンドの実行環境が整っていません
標準エラー出力

KFCA00434-E
バージョン不一致のためlcklsコマンドが実行できません
標準エラー出力

KFCA00437-E
lcklsコマンドの形式が正しくありません
標準エラー出力

lckpool

名称

排他制御用テーブルのプール情報の表示

形式

lckpool

機能

排他制御用テーブルプールの使用率を標準出力に出力します。

出力形式

aaaaa：ユーザサーバの最大同時排他要求数の定義値（10進数）

bbbbb：ユーザサーバの現在の排他要求数（10進数）

ccc：ユーザサーバの現在の排他制御用テーブルプール使用率（10進数）

ddddd：DAMサービスの最大同時排他要求数の定義値（10進数）

eeeee：DAMサービスの現在の排他要求数（10進数）

fff：DAMサービスの現在の排他制御用テーブルプール使用率（10進数）

ggggg：TAMサービスの最大同時排他要求数の定義値（10進数）

hhhhh：TAMサービスの現在の排他要求数（10進数）

iii：TAMサービスの現在の排他制御用テーブルプール使用率（10進数）

jjjjj：MQAサービスの最大同時排他要求数の定義値（10進数）

kkkkk：MQAサービスの現在の排他要求数（10進数）

lll：MQAサービスの現在の排他制御用テーブルプール使用率（10進数）

出力メッセージ

メッセージID
内容
出力先

KFCA00430-E
lckpoolコマンドが実行できません
標準エラー出力

KFCA00432-I
ヘルプメッセージ
標準出力，
標準エラー出力

KFCA00433-E
lckpoolコマンドの実行環境が整っていません
標準エラー出力

KFCA00434-E
バージョン不一致のためlckpoolコマンドが実行できません
標準エラー出力

KFCA00437-E
lckpoolコマンドの形式が正しくありません
標準エラー出力

lckrminf

名称

デッドロック情報ファイルとタイムアウト情報ファイルの削除

形式

lckrminf -d 日数

機能

デッドロック情報ファイルとタイムアウト情報ファイルを削除します。

オプション

●-d　日数　　～((1～24855))

lckrminfコマンドを実行した時刻から起算して，「24時間×lckrminfコマンドで指定した日数」以前に作成されたデッドロック情報ファイルとタイムアウト情報ファイルを削除します。

出力メッセージ

メッセージID
内容
出力先

KFCA00430-E
lckrminfコマンドが実行できません
標準エラー出力

KFCA00433-E
lckrminfコマンドの実行環境が整っていません
標準エラー出力

KFCA00434-E
バージョン不一致のためlckrminfコマンドが実行できません
標準エラー出力

KFCA00437-E
lckrminfコマンドの形式が正しくありません
標準エラー出力

KFCA00439-I
ヘルプメッセージ
標準出力，
標準エラー出力

logcat

名称

メッセージログファイルの表示

形式

logcat 〔-niNIdtHpab〕〔-f メッセージログファイル名〕

機能

メッセージログファイル中のメッセージの内容を標準出力へ出力します。

出力するとき，$DCDIR/spool/dclog1と$DCDIR/spool/dclog2を時間順にマージします。

なお，出力する際に付ける情報をオプションで指定できます。

オプション

●-n

メッセージ通番を表示します。

●-i

要求元プロセスのプロセスIDを表示します。

●-N

1プロセスが出力したメッセージログの通番を表示します。

●-I

システムID（ユーザが指定したOpenTP1ごとの識別子）を表示します。

●-d

メッセージログの出力要求時の年月日を表示します。

●-t

メッセージログの出力要求時の時間を表示します。

●-H

メッセージログの出力要求元のホスト名を表示します。

●-p

要求元プログラムIDを表示します。

●-a

上記の情報をすべて付加します。ほかのオプションと一緒に指定した場合，ほかのオプションの指定は無視されます。

●-b

上記の情報を付加しないで，メッセージIDとメッセージテキストだけを出力します。ほかのオプションと一緒に指定した場合，ほかのオプションの指定は無視されます。ただし，-aオプションと一緒に指定した場合は，-aオプションの指定が有効になり，-bオプションの指定は無視されます。

●-f　メッセージログファイル名　　～〈パス名〉

メッセージログファイルの名称を指定します。

指定したメッセージログファイルの情報だけが表示されます。

このオプションの指定を省略すると，$DCDIR/spool/dclog1と$DCDIR/spool/dclog2が時間順にマージされて，古い情報から表示されます。

出力形式

「logcat -a」と指定した場合の出力形式を次に示します。

aaaaaaa bbbbb ccccccc dd ee...ee ff...ff gg...gg hhh ii...ii jj...jj

aaaaaaa：メッセージ通番（半角数字7文字）

bbbbb：プロセスID（半角数字5文字）

ccccccc：プロセス内メッセージ通番（半角数字7文字）

dd：システムID（半角英数字2文字）

ee...ee：年月日（半角数字10文字）
年／月／日の形式

ff...ff：時間（半角数字8文字）
時：分：秒の形式

gg...gg：要求元ホスト名（半角英数字8文字）
ホスト名の先頭8文字です。

hhh：要求元プログラムID（半角英数字3文字）
先頭が＊で始まるものはUAPが発行したメッセージです。
先頭が＊で始まらないものはシステムメッセージです。

ii...ii：メッセージID（半角英数字11文字）

jj...jj：メッセージテキスト

出力メッセージ

メッセージID
内容
出力先

KFCA01950-I
ヘルプメッセージ
標準出力，
標準エラー出力

KFCA01951-E
メモリ不足です
標準エラー出力

KFCA01952-E
ログサービスで異常が発生しました
標準エラー出力

KFCA01953-E
ログファイル格納ディレクトリが設定されていません
標準エラー出力

KFCA01954-E
ログファイルのオープンエラーが発生しました
標準エラー出力

KFCA01955-E
ログファイルの最終更新時刻の取得に失敗しました
標準エラー出力

KFCA01956-E
入出力エラーが発生しました
標準エラー出力

KFCA01957-E
ログファイルの形式が正しくありません
標準エラー出力

KFCA01958-E
ログファイルのバージョンが正しくありません
標準エラー出力

KFCA01978-E
コマンド引数の指定が誤っています
標準エラー出力

logcon

名称

メッセージログのリアルタイム出力機能の切り替え

形式

logcon 〔-｛y｜n｝〕

機能

オンライン中に，ログサービス定義のリアルタイム出力の指定（log_msg_console）を切り替えます。

logconコマンドは，ログサービスが動作中のときだけ有効です。

オプション

●-｛y｜n｝

-y

log_msg_consoleの指定をYに切り替えます。Yに切り替えると，メッセージログをリアルタイムに標準出力に出力します。

-n

log_msg_consoleの指定をNに切り替えます。Nに切り替えると，メッセージログをリアルタイムに標準出力に出力しません。

出力メッセージ

メッセージID
内容
出力先

KFCA01951-E
メモリ不足です
標準エラー出力

KFCA01952-E
ログサービスで異常が発生しました
標準エラー出力

KFCA01970-I
ヘルプメッセージ
標準出力，
標準エラー出力

KFCA01971-E
通信障害が発生しました
標準エラー出力

KFCA01972-E
ログサービスが起動されていません
標準エラー出力

KFCA01973-E
logconコマンドのバージョンが正しくありません
標準エラー出力

KFCA01974-E
起動状態です
標準エラー出力

KFCA01975-E
未起動状態です
標準エラー出力

KFCA01976-E
環境変数が設定されていません
標準エラー出力

KFCA01977-E
ネームサービスが起動されていません
標準エラー出力

KFCA01978-E
コマンド引数の指定が誤っています
標準エラー出力

KFCA01979-E
オプションフラグの指定がないか，またはオプションフラグの組み合わせが誤っています
標準エラー出力

mcfaactap

名称

アプリケーションの閉塞解除

形式

mcfaactap -s MCF通信プロセス識別子 -a アプリケーション名
       〔-k アプリケーション種別〕

機能

アプリケーションの閉塞を解除します。このとき，アプリケーションの異常終了回数は初期化されます（0が設定されます）。

オプション

●-s　MCF通信プロセス識別子　　～〈数字（0～9），a～f〉((01～ef))

MCF通信プロセス識別子を指定します。

複数のMCF通信プロセス識別子は指定できません。

●-a　アプリケーション名　　～〈1～8文字の識別子〉

閉塞を解除するアプリケーションの名称を指定します。

アプリケーション名は，1回につき8個まで指定できます。多数入力する運用を行う場合は，次に示す複数指定または一括指定を使用して，一つの運用コマンドで行う並列処理数を増やし，運用コマンド入力数を減らすように運用設計を行ってください。

複数のアプリケーション名を指定するときは，引用符（"）で囲んで，アプリケーション名とアプリケーション名との間を空白で区切ります。同一アプリケーション名は，重複して指定できません。

また，アプリケーション名は，＊を使って一括指定ができます。一括指定は一つだけ指定できます。一括指定と一括指定以外のアプリケーション名を混在して指定できません。一括指定の場合も，引用符（"）で囲みます。

＊：すべてのアプリケーションの閉塞を解除します。

先行文字列＊：先行文字列で始まるすべてのアプリケーションの閉塞を解除します。

〈複数指定の例〉apl1，apl2，apl3を指定する場合

-a "apl1△apl2△apl3"

〈一括指定の例〉aplで始まるすべてのアプリケーションを指定する場合

-a "apl*"

●-k　アプリケーション種別　　～《user》

アプリケーション種別を指定します。

　user：ユーザアプリケーション

　mcf：MCFイベント

出力メッセージ

メッセージID
内容
出力先

KFCA10350-I
mcfaactapコマンドが入力されました
標準出力

KFCA10351-E
MCF開始処理中です
標準エラー出力

KFCA10352-E
MCF終了処理中です
標準エラー出力

KFCA10353-W
入力形式が誤っています
標準エラー出力

KFCA10354-E
メモリ不足です
標準エラー出力

KFCA10355-W
引数の指定が誤っています
標準エラー出力

KFCA10356-E
プロセス間でタイムアウトが発生しました
標準エラー出力

KFCA10357-E
MCF内でタイムアウトが発生しました
標準エラー出力

KFCA10358-E
内部関数のエラーが発生しました
標準エラー出力

KFCA10359-W
mcfaactapコマンド入力元への応答に失敗しました
メッセージログファイル，または
標準エラー出力

KFCA10371-I
mcfaactapコマンドを正常に受け付けました
標準出力

KFCA10373-E
mcfaactapコマンドが異常終了しました
標準エラー出力

KFCA10380-E
相手プロセスの検索に失敗しました
標準エラー出力

KFCA10386-E
指定したアプリケーションは，登録されていません
標準エラー出力

KFCA10516-I
ヘルプメッセージ
標準出力

KFCA11063-W
該当するアプリケーションはすでに閉塞解除されています
標準エラー出力

KFCA11088-W
コマンド処理は正常に行われましたが，状態引き継ぎ登録処理に失敗しました
標準エラー出力

KFCA11089-W
コマンド処理は正常に行われましたが，状態引き継ぎ個数が定義で指定された上限値を超えているため状態引き継ぎ登録ができませんでした
標準エラー出力

KFCA11099-W
SPP資源のため閉塞，または閉塞解除できません
標準エラー出力

KFCA16402-E
コマンド処理中にRPC障害が発生しました
標準エラー出力

mcfaclcap

名称

アプリケーション異常終了回数の初期化

形式

mcfaclcap -s MCF通信プロセス識別子 -a アプリケーション名
       〔-k アプリケーション種別〕

機能

アプリケーション異常終了回数を初期化（0を設定）します。

オプション

●-s　MCF通信プロセス識別子　　～〈数字（0～9），a～f〉((01～ef))

MCF通信プロセス識別子を指定します。

複数のMCF通信プロセス識別子は指定できません。

●-a　アプリケーション名　　～〈1～8文字の識別子〉

異常終了回数を初期化（0を設定）するアプリケーションの名称を指定します。

アプリケーション名は，1回につき8個まで指定できます。多数入力する運用を行う場合は，次に示す複数指定または一括指定を使用して，一つの運用コマンドで行う並列処理数を増やし，運用コマンド入力数を減らすように運用設計を行ってください。

複数のアプリケーション名を指定するときは，引用符（"）で囲んで，アプリケーション名とアプリケーション名との間を空白で区切ります。同一アプリケーション名は，重複して指定できません。

また，アプリケーション名は，＊を使って一括指定ができます。一括指定は一つだけ指定できます。一括指定と一括指定以外のアプリケーション名を混在して指定できません。一括指定の場合も，引用符（"）で囲みます。

＊：すべてのアプリケーション異常終了回数を初期化します。

先行文字列＊：先行文字列で始まるすべてのアプリケーション異常終了回数を初期化します。

〈複数指定の例〉apl1，apl2，apl3を指定する場合

-a "apl1△apl2△apl3"

〈一括指定の例〉aplで始まるすべてのアプリケーションを指定する場合

-a "apl*"

●-k　アプリケーション種別　　～《user》

アプリケーション種別を指定します。

　user：ユーザアプリケーション

　mcf：MCFイベント

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10350-I | mcfaclcapコマンドが入力されました | 標準出力
KFCA10351-E | MCF開始処理中です | 標準エラー出力
KFCA10352-E | MCF終了処理中です | 標準エラー出力
KFCA10353-W | 入力形式が誤っています | 標準エラー出力
KFCA10354-E | メモリ不足です | 標準エラー出力
KFCA10355-W | 引数の指定が誤っています | 標準エラー出力
KFCA10356-E | プロセス間でタイムアウトが発生しました | 標準エラー出力
KFCA10357-E | MCF内でタイムアウトが発生しました | 標準エラー出力
KFCA10358-E | 内部関数のエラーが発生しました | 標準エラー出力
KFCA10359-W | mcfaclcapコマンド入力元への応答に失敗しました | メッセージログファイル，または標準エラー出力
KFCA10371-I | mcfaclcapコマンドを正常に受け付けました | 標準出力
KFCA10373-E | mcfaclcapコマンドが異常終了しました | 標準エラー出力
KFCA10380-E | 相手プロセスの検索に失敗しました | 標準エラー出力
KFCA10386-E | 指定したアプリケーションは，登録されていません | 標準エラー出力
KFCA10520-I | ヘルプメッセージ | 標準出力
KFCA11070-W | 該当するアプリケーションの異常終了回数はすでにクリアされています | 標準エラー出力
KFCA11801-W | SPP資源のため異常終了回数は初期化できません | 標準エラー出力
KFCA16402-E | コマンド処理中にRPC障害が発生しました | 標準エラー出力

mcfadctap

名称

アプリケーションの閉塞

形式

mcfadctap -s MCF通信プロセス識別子 -a アプリケーション名
       〔-t 閉塞種別〕〔-k アプリケーション種別〕

機能

アプリケーションを閉塞します。

オプション

●-s　MCF通信プロセス識別子　　～〈数字（0～9），a～f〉((01～ef))

MCF通信プロセス識別子を指定します。

複数のMCF通信プロセス識別子は指定できません。

●-a　アプリケーション名　　～〈1～8文字の識別子〉

閉塞するアプリケーションの名称を指定します。

アプリケーション名は，1回につき8個まで指定できます。多数入力する運用を行う場合は，次に示す複数指定または一括指定を使用して，一つの運用コマンドで行う並列処理数を増やし，運用コマンド入力数を減らすように運用設計を行ってください。

複数のアプリケーション名を指定するときは，引用符（"）で囲んで，アプリケーション名とアプリケーション名との間を空白で区切ります。同一アプリケーション名は，重複して指定できません。

また，アプリケーション名は，＊を使って一括指定ができます。一括指定は一つだけ指定できます。一括指定と一括指定以外のアプリケーション名を混在して指定できません。一括指定の場合も，引用符（"）で囲みます。

＊：すべてのアプリケーションを閉塞します。

先行文字列＊：先行文字列で始まるすべてのアプリケーションを閉塞します。

〈複数指定の例〉apl1，apl2，apl3を指定する場合

-a "apl1△apl2△apl3"

〈一括指定の例〉aplで始まるすべてのアプリケーションを指定する場合

-a "apl*"

●-t　閉塞種別　　～《insc》

アプリケーションの閉塞種別を指定します。

　insc：入力キューの入力とスケジュールを閉塞します。

　in：入力キューの入力だけ閉塞します。

　sc：入力キューのスケジュールだけ閉塞します。

●-k　アプリケーション種別　　～《user》

アプリケーション種別を指定します。

　user：ユーザアプリケーション

　mcf：MCFイベント

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10350-I | mcfadctapコマンドが入力されました | 標準出力
KFCA10351-E | MCF開始処理中です | 標準エラー出力
KFCA10352-E | MCF終了処理中です | 標準エラー出力
KFCA10353-W | 入力形式が誤っています | 標準エラー出力
KFCA10354-E | メモリ不足です | 標準エラー出力
KFCA10355-W | 引数の指定が誤っています | 標準エラー出力
KFCA10356-E | プロセス間でタイムアウトが発生しました | 標準エラー出力
KFCA10357-E | MCF内でタイムアウトが発生しました | 標準エラー出力
KFCA10358-E | 内部関数のエラーが発生しました | 標準エラー出力
KFCA10359-W | mcfadctapコマンド入力元への応答に失敗しました | メッセージログファイル，または標準エラー出力
KFCA10371-I | mcfadctapコマンドを正常に受け付けました | 標準出力
KFCA10373-E | mcfadctapコマンドが異常終了しました | 標準エラー出力
KFCA10380-E | 相手プロセスの検索に失敗しました | 標準エラー出力
KFCA10386-E | 指定したアプリケーションは，登録されていません | 標準エラー出力
KFCA10517-I | ヘルプメッセージ | 標準出力
KFCA11062-W | 該当するアプリケーションはコマンドによってすでに閉塞されています | 標準エラー出力
KFCA11088-W | コマンド処理は正常に行われましたが，状態引き継ぎ登録処理に失敗しました | 標準エラー出力
KFCA11089-W | コマンド処理は正常に行われましたが，状態引き継ぎ個数が定義で指定した上限値を超えているため状態引き継ぎ登録ができませんでした | 標準エラー出力
KFCA11099-W | SPP資源のため閉塞，または閉塞解除できません | 標準エラー出力
KFCA16402-E | コマンド処理中にRPC障害が発生しました | 標準エラー出力

mcfadltap

名称

アプリケーションに関するタイマ起動要求の削除

形式

mcfadltap 〔-s アプリケーション起動プロセス識別子〕
           -a アプリケーション名

機能

指定されたアプリケーションに関するタイマ要求を削除し，アプリケーションの起動を停止します。ただし，ans型，cont型のアプリケーションに関するタイマ要求は削除できません。

オプション

●-s　アプリケーション起動プロセス識別子　　～〈数字（0～9），a～f〉((01～ef))

アプリケーション起動プロセス識別子を指定します。アプリケーション起動プロセス識別子は複数指定できません。

このオプションの指定を省略すると，すべてのMCFに対して，mcfadltapコマンドを実行します。したがって，アプリケーション起動プロセスを検索するオーバヘッドが，運用コマンドの処理に加わります。

アプリケーション起動プロセスが多い構成や運用コマンドを多数入力する運用を行う場合は，-sオプションで，アプリケーション起動プロセス識別子を指定する運用設計を行ってください。

●-a　アプリケーション名　　～〈1～8文字の識別子〉

起動を停止するアプリケーションの名称を指定します。

アプリケーション名は，1回につき8個まで指定できます。多数入力する運用を行う場合は，次に示す複数指定または一括指定を使用して，一つの運用コマンドで行う並列処理数を増やし，運用コマンド入力数を減らすように運用設計を行ってください。

複数のアプリケーション名を指定するときは，引用符（"）で囲んで，アプリケーション名とアプリケーション名との間を空白で区切ります。同一アプリケーション名は，重複して指定できません。

また，アプリケーション名は，＊を使って一括指定ができます。一括指定は一つだけ指定できます。一括指定と一括指定以外のアプリケーション名を混在して指定できません。一括指定の場合も，引用符（"）で囲みます。

＊：すべてのアプリケーションの起動を停止します。

先行文字列＊：先行文字列で始まるすべてのアプリケーションの起動を停止します。

〈複数指定の例〉apl1，apl2，apl3を指定する場合

-a "apl1△apl2△apl3"

〈一括指定の例〉aplで始まるすべてのアプリケーションを指定する場合

-a "apl*"

出力メッセージ

メッセージID
内容
出力先

KFCA10350-I
mcfadltapコマンドが入力されました
標準出力

KFCA10351-E
MCF開始処理中です
標準エラー出力

KFCA10352-E
MCF終了処理中です
標準エラー出力

KFCA10353-W
入力形式が誤っています
標準エラー出力

KFCA10354-E
メモリ不足です
標準エラー出力

KFCA10355-W
引数の指定に誤りがあります
標準エラー出力

KFCA10356-E
プロセス間でタイムアウトが発生しました
標準エラー出力

KFCA10357-E
MCF内でタイムアウトが発生しました
標準エラー出力

KFCA10358-E
内部関数のエラーが発生しました
標準エラー出力

KFCA10359-W
mcfadltapコマンド入力元への応答に失敗しました
メッセージログファイル，または標準エラー出力

KFCA10371-I
mcfadltapコマンドを正常に受け付けました
標準出力

KFCA10373-E
mcfadltapコマンドが異常終了しました
標準エラー出力

KFCA10380-E
相手プロセスの検索に失敗しました
標準エラー出力

KFCA10391-E
mcfadltapコマンドはサポートされていません
標準エラー出力

KFCA10529-I
ヘルプメッセージ
標準出力

KFCA10704-I
タイマ起動処理中のアプリケーションをタイマ起動削除しました
メッセージログファイル

KFCA10705-E
タイマ起動削除処理中に障害を検知しました
標準エラー出力，
メッセージログファイル

KFCA10706-W
指定したアプリケーションはタイマ起動要求されていないか，またはすでにタイマ起動されています
標準エラー出力

KFCA16402-E
コマンド処理中にRPC障害が発生しました
標準エラー出力

mcfalsap

名称

アプリケーションの状態表示

形式

mcfalsap  -s MCF通信プロセス識別子 -a アプリケーション名
        〔-k アプリケーション種別〕

機能

指定したアプリケーションの入力，スケジュールの状態を表示します。

オプション

●-s　MCF通信プロセス識別子　　～〈数字（0～9），a～f〉((01～ef))

MCF通信プロセス識別子を指定します。

複数のMCF通信プロセス識別子は指定できません。

●-a　アプリケーション名　　～〈1～8文字の識別子〉

状態を表示するアプリケーションの名称を指定します。

アプリケーション名は，1回につき8個まで指定できます。多数入力する運用を行う場合は，次に示す複数指定または一括指定を使用して，一つの運用コマンドで行う並列処理数を増やし，運用コマンド入力数を減らすように運用設計を行ってください。

複数のアプリケーション名を指定するときは，引用符（"）で囲んで，アプリケーション名とアプリケーション名との間を空白で区切ります。同一アプリケーション名は，重複して指定できません。

また，アプリケーション名は，＊を使って一括指定ができます。一括指定は一つだけ指定できます。一括指定と一括指定以外のアプリケーション名を混在して指定できません。一括指定の場合も，引用符（"）で囲みます。

＊：すべてのアプリケーションの状態を表示します。

先行文字列＊：先行文字列で始まるすべてのアプリケーションの状態を表示します。

〈複数指定の例〉apl1，apl2，apl3を指定する場合

-a "apl1△apl2△apl3"

〈一括指定の例〉aplで始まるすべてのアプリケーションを指定する場合

-a "apl*"

●-k　アプリケーション種別　　～《user》

アプリケーション種別を指定します。

　user：ユーザアプリケーション

　mcf：MCFイベント

出力形式

aaaaaaaaaaa bbb cccc dd...dd eee fff〔tttt〕

aaaaaaaaaaa：メッセージID

bbb：MCF識別子

cccc：アプリケーション種別

dd…dd：アプリケーション名

eee：アプリケーションの状態（入力）

ACT…閉塞解除

DCT…閉塞

***…SPPのアプリケーションの場合に表示

fff：アプリケーションの状態（スケジュール）

ACT…閉塞解除

DCT…閉塞

***…SPPのアプリケーションの場合に表示

tttt：アプリケーションのテストモード状態（TP1/Message Control/Tester使用時だけ表示）

TEST…テストモード

空白…非テストモード

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10350-I | mcfalsapコマンドが入力されました | 標準出力
KFCA10351-E | MCF開始処理中です | 標準エラー出力
KFCA10352-E | MCF終了処理中です | 標準エラー出力
KFCA10353-W | 入力形式が誤っています | 標準エラー出力
KFCA10354-E | メモリ不足です | 標準エラー出力
KFCA10355-W | 引数の指定が誤っています | 標準エラー出力
KFCA10356-E | プロセス間でタイムアウトが発生しました | 標準エラー出力
KFCA10357-E | MCF内でタイムアウトが発生しました | 標準エラー出力
KFCA10358-E | 内部関数のエラーが発生しました | 標準エラー出力
KFCA10359-W | mcfalsapコマンド入力元への応答に失敗しました | メッセージログファイル
KFCA10360-I | 状態表示を開始します | 標準出力
KFCA10369-I | 状態表示を終了します | 標準出力
KFCA10373-E | mcfalsapコマンドが異常終了しました | 標準エラー出力
KFCA10379-I | 上記の出力形式を参照してください | 標準出力
KFCA10380-E | 相手プロセスの検索に失敗しました | 標準エラー出力
KFCA10386-E | 指定したアプリケーションは登録されていません | 標準エラー出力
KFCA10518-I | ヘルプメッセージ | 標準出力
KFCA16402-E | コマンド処理中にRPC障害が発生しました | 標準エラー出力

mcfalstap

名称

アプリケーションに関するタイマ起動要求の表示

形式

mcfalstap 〔-s アプリケーション起動プロセス識別子〕 -a アプリケーション名

機能

指定されたアプリケーションに関するタイマ起動要求を表示します。

オプション

●-s　アプリケーション起動プロセス識別子　　～〈数字（0～9），a～f〉((01～ef))

アプリケーション起動プロセス識別子を指定します。アプリケーション起動プロセス識別子は複数指定できません。

このオプションの指定を省略すると，すべてのMCFに対して，mcfalstapコマンドを実行します。したがって，アプリケーション起動プロセスを検索するオーバヘッドが，運用コマンドの処理に加わります。

アプリケーション起動プロセスが多い構成や運用コマンドを多数入力する運用を行う場合は，-sオプションで，アプリケーション起動プロセス識別子を指定する運用設計を行ってください。

●-a　アプリケーション名　　～〈1～8文字の識別子〉

表示するアプリケーションの名称を指定します。

アプリケーション名は，1回につき8個まで指定できます。多数入力する運用を行う場合は，次に示す複数指定または一括指定を使用して，一つの運用コマンドで行う並列処理数を増やし，運用コマンド入力数を減らすように運用設計を行ってください。

複数のアプリケーション名を指定するときは，引用符（"）で囲んで，アプリケーション名とアプリケーション名との間を空白で区切ります。同一アプリケーション名は，重複して指定できません。

また，アプリケーション名は，＊を使って一括指定ができます。一括指定は一つだけ指定できます。一括指定と一括指定以外のアプリケーション名を混在して指定できません。一括指定の場合も，引用符（"）で囲みます

＊：すべてのアプリケーションに関するタイマ起動要求を表示します。

先行文字列＊：先行文字列で始まるすべてのアプリケーションに関するタイマ起動要求を表示します。

〈複数指定の例〉apl1，apl2，apl3を指定する場合

-a "apl1△apl2△apl3"

〈一括指定の例〉aplで始まるすべてのアプリケーションを指定する場合

-a "apl*"

出力形式

mmm　aa....aa　hh1:mm1:ss1　bbbb　hhh2:mm2:ss2

mmm：MCF識別子

aa....aa：アプリケーション名称

hh1:mm1:ss1：アプリケーション起動要求の受付時刻（hh1：時，mm1：分，ss1：秒）

bbbb：経過時間，または時刻の種別

INTV：経過時間指定

TIME：時刻指定

hhh2:mm2:ss2：タイマ指定のアプリケーション起動時にUAPが指定した経過時間または時刻の値（hhh2：時，mm2：分，ss2：秒）
経過時間指定のアプリケーション起動要求時に指定した経過時間が360000の場合，100:00:00と表示されます。

表示例

KFCA10360-I TAPの状態表示を開始します。
KFCA16436-I A01　ap001    19:06:33　INTV　 00:45:00
KFCA16436-I A01　ap2      19:07:17　TIME　 19:20:00
KFCA16436-I A01　ap000003 19:08:23　INTV　100:00:00
KFCA10369-I TAPの状態表示を終了します。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10350-I | mcfalstapコマンドが入力されました | 標準出力
KFCA10351-E | MCF開始処理中です。開始処理が終了するまで待って再度コマンドを入力してください | 標準エラー出力
KFCA10352-E | MCF終了処理中です | 標準エラー出力
KFCA10353-W | 入力形式が誤っています。正しい形式で再度コマンドを入力してください | 標準エラー出力
KFCA10354-E | メモリ不足です。再度コマンドを入力して，結果が同じ場合は，システムの環境を見直してください | 標準エラー出力
KFCA10355-W | 引数の指定が誤っています。アプリケーション起動プロセス識別子，アプリケーション名の指定方法を見直して再度コマンドを入力してください | 標準エラー出力
KFCA10356-E | プロセス間でタイムアウトが発生しました。このメッセージ以前にログ出力されたメッセージを参照してください | 標準エラー出力
KFCA10357-E | MCF内でタイムアウトが発生しました。このメッセージ以前にログ出力されたメッセージを参照してください | 標準エラー出力
KFCA10358-E | 内部関数のエラーが発生しました | 標準エラー出力
KFCA10359-W | mcfalstapコマンド入力元への応答に失敗しました。理由コードが-19178の場合，アプリケーション名の指定に一括指定を使用しないか，または先行文字列を付加した一括指定を使用して表示対象を絞って再度コマンドを入力してください | メッセージログファイル，または標準エラー出力
KFCA10360-I | 状態表示を開始します | 標準出力
KFCA10369-I | 状態表示を終了します | 標準出力
KFCA10372-E | mcfalstapコマンドが異常終了しました。このメッセージ以前にログ出力されたメッセージを参照してください | 標準エラー出力
KFCA10380-E | 相手プロセスの検索に失敗しました。アプリケーション起動プロセス識別子を確認して再度コマンドを入力してください | 標準エラー出力
KFCA10391-E | コマンドを実行しようとしたサービスでは，mcfalstapコマンドはサポートされていません。-sオプションにアプリケーション起動プロセス識別子を指定して再度コマンドを入力してください | 標準エラー出力
KFCA10563-I | ヘルプメッセージ | 標準出力
KFCA10714-E | メモリ不足です。再度コマンドを入力して，結果が同じ場合は，システムの環境を見直してください | メッセージログファイル
KFCA16402-E | コマンド処理中にRPC障害が発生しました。理由コードに応じた対処をしてください | 標準エラー出力
KFCA16436-I | 上記の出力形式を参照してください | 標準出力
KFCA16437-I | タイマ起動要求されていないか，すでにタイマ起動されているか，またはアプリケーション名が誤っています。タイマ要求がある状況でこのメッセージが出力された場合は，アプリケーション名に誤りがないか再確認するか，一括指定を使用して再度コマンドを入力してください | 標準出力

mcfreport

名称

MCF稼働統計情報の編集

形式

mcfreport 〔-k 編集種別〕 〔-u 編集対象〕 〔-i 入力ファイル名〕
         〔-d 開始日付:終了日付｜対象日付〕 〔-t 開始時刻:終了時刻〕

機能

mcfstatsコマンドで出力したMCF稼働統計情報のファイルを入力し，編集結果を標準出力に出力します。

オプション

●-k　編集種別　　～《all》

編集する種別を指定します。

all：すべての統計情報を編集します。

in：受信メッセージに関する統計情報を編集します。

out：送信メッセージに関する統計情報を編集します。

cn：コネクション処理待ちに関する統計情報を編集します。

●-u　編集対象

編集の対象となるサービスグループ名，論理端末名称，またはMCF通信プロセス識別子を指定します。

-kオプションの指定によって，次の項目を指定します。

allを指定した場合：このオプションを省略します。

inを指定した場合：サービスグループ名

outを指定した場合：論理端末名称

cnを指定した場合：MCF通信プロセス識別子

-kオプションでin，out，cnを指定した場合，このオプションは必ず指定してください。allを指定した場合，このオプションの指定は無効となります。

サービスグループ名，論理端末名称，MCF通信プロセス識別子は複数指定できません。

編集対象は，＊を使って一括指定ができます。一括指定は一つだけ指定できます。一括指定と一括指定以外の項目を混在して指定できません。一括指定の場合，編集対象を引用符（"）で囲みます。

＊：すべてのサービスグループ，論理端末，またはMCF通信プロセスに関する統計情報を編集します。

先行文字列＊：先行文字列で始まるすべてのサービスグループ，論理端末に関する統計情報を編集します。MCF通信プロセスはこの指定はできません。

〈一括指定の例〉abcで始まるすべてのサービスグループを指定する場合

-u "abc*"

●-i　入力ファイル名　　～〈1～35文字のパス名〉《mcfstc》

mcfstatsコマンドの実行結果ファイルを指定します。ファイル名だけを指定した場合，カレントディレクトリ下のファイルを編集します。絶対パス名で指定した場合，指定したディレクトリ下のファイルを編集します。

このオプションを省略すると，カレントディレクトリ下のmcfstcを編集します。

●-d　開始日付:終了日付｜対象日付　　～〈10進数〉《s:e》

編集対象となる日付範囲または対象日付を指定します。

このオプション省略時は，-d s:eと仮定されます。

s：開始日付の省略値（00000101）

e：終了日付の省略値（99991231）

開始日付，終了日付，および対象日付は，YYYYMMDDで表します。

YYYY：年（指定したい年の西暦の数字）

MM：月（01～12）

DD：日（01～31）

●-t　開始時刻:終了時刻　　～〈10進数〉《s:e》

編集対象となる時刻の範囲を指定します。

このオプション省略時は，-t s:eと仮定されます。

s：開始時刻の省略値（0000）

e：終了時刻の省略値（2359）

開始時刻および終了時刻は，HHMMで表します。

HH：時（00～23）

MM：分（00～59）

-dオプションの指定値の範囲内でこのオプションの時刻範囲に該当する個所は，すべて編集の対象となります。例えば，-d△19970101:19970103△-t△0900:1700と指定した場合，1997年1月1日，2日，3日それぞれの9:00から17:00までの統計情報が編集の対象となります。なお，日付をわたる指定（例 -t△2300:0100）はできません。

出力形式

aaaaaaaa：入力ファイル名

bbbb-bb-bb bb:bb:bb：ファイル出力日時

cccccccc：論理端末名称

ddd：MCF識別子

eeeeeeeeee：処理済み同期型送信メッセージ数※

ffffffffff：処理待ち状態同期型送信メッセージ数の最小値・最大値・平均値・合計値

g.gggggg：同期型送信メッセージの処理待ち時間の最小値・最大値・平均値・合計値

hhhhhhhhhh：処理済み問い合わせ型送信メッセージ数※

iiiiiiiiii：処理待ち状態問い合わせ型送信メッセージ数の最小値・最大値・平均値・合計値

j.jjjjjj：問い合わせ型送信メッセージの処理待ち時間の最小値・最大値・平均値・合計値

kkkkkkkkkk：処理済み優先分岐型送信メッセージ数※

llllllllll：処理待ち状態優先分岐型送信メッセージ数の最小値・最大値・平均値・合計値

m.mmmmmm：優先分岐型送信メッセージの処理待ち時間の最小値・最大値・平均値・合計値

nnnnnnnnnn：処理済み一般分岐型送信メッセージ数※

oooooooooo：処理待ち状態一般分岐型送信メッセージ数の最小値・最大値・平均値・合計値

p.pppppp：一般分岐型送信メッセージの処理待ち時間の最小値・最大値・平均値・合計値

qqqqqqqqqq：処理済みコネクション数※

rrrrrrrrrr：処理待ち状態コネクション数の最小値・最大値・平均値・合計値

s.ssssss：コネクションの処理待ち時間の最小値・最大値・平均値・合計値

tttttttt：サービスグループ名

uuuuuuuuuu：処理済み受信メッセージ数※

vvvvvvvvvv：処理待ち状態受信メッセージ数の最小値・最大値・平均値・合計値

w.wwwwww：受信メッセージの処理待ち時間の最小値・最大値・平均値・合計値

注※

intの上限値まで表示されます。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA19751-I | MCF稼働統計情報の編集を開始します | 標準出力
KFCA19752-I | MCF稼働統計情報の編集を終了します | 標準出力
KFCA19753-E | MCF稼働統計情報編集に必要なメモリが確保できません | 標準エラー出力
KFCA19754-E | 不当なオプションがあります | 標準エラー出力
KFCA19755-E | 入力ファイル名の長さが既定値を超えています | 標準エラー出力
KFCA19757-E | 入力ファイル名の指定が誤っています | 標準エラー出力
KFCA19758-E | 編集種別の指定が誤っています | 標準エラー出力
KFCA19759-E | 編集対象の指定がありません | 標準エラー出力
KFCA19760-E | 編集対象の指定が誤っています | 標準エラー出力
KFCA19761-E | 日付の指定が誤っています | 標準エラー出力
KFCA19762-E | 時刻の指定が誤っています | 標準エラー出力
KFCA19763-E | 入力ファイル処理中に障害が発生しました | 標準エラー出力

注意事項

編集対象が不正であっても，その統計情報が出力されていないものとして処理し，特にエラーメッセージは出力しません。

mcfstatsコマンド実行中のファイルが指定された場合の動作は保証しません。

mcfstats

名称

MCF稼働統計情報の出力

形式

mcfstats 〔-k 出力種別〕 〔-u 出力対象〕 〔-o 出力ファイル名〕
        〔-f 出力ファイルサイズ〕 〔-s 時間間隔〕 〔-t 出力回数〕 〔-r〕

機能

指定した時間間隔で，MCF稼働統計情報をファイルに出力します。

-rオプションを指定した場合は，MCF稼働統計情報の出力を終了します。

オプション

●-k　出力種別　　～《all》

出力する種別を指定します。

all：すべての統計情報を出力します。

in：受信メッセージに関する統計情報を出力します。

out：送信メッセージに関する統計情報を出力します。

cn：コネクション処理待ちに関する統計情報を出力します。

●-u　出力対象

出力の対象となるサービスグループ名，論理端末名称，またはMCF通信プロセス識別子を指定します。

-kオプションの指定によって，次の項目を指定します。

allを指定した場合：このオプションを省略します。

inを指定した場合：サービスグループ名

outを指定した場合：論理端末名称

cnを指定した場合：MCF通信プロセス識別子

-kオプションでin，out，cnを指定した場合，このオプションは必ず指定してください。allを指定した場合，このオプションの指定は無効となります。

サービスグループ名，論理端末名称，MCF通信プロセス識別子は複数指定できません。

出力対象は，＊を使って一括指定ができます。一括指定は一つだけ指定できます。一括指定と一括指定以外の項目を混在して指定できません。一括指定の場合，出力対象を引用符（"）で囲みます。

＊：すべてのサービスグループ，論理端末またはMCF通信プロセスに関する統計情報を出力します。

先行文字列＊：先行文字列で始まるすべてのサービスグループ，論理端末に関する統計情報を出力します。MCF通信プロセスはこの指定はできません。

〈一括指定の例〉abcで始まるすべてのサービスグループを指定する場合

-u "abc*"

●-o　出力ファイル名　　～〈1～35文字のパス名〉《mcfstc》

出力ファイル名を指定します。ファイル名だけを指定した場合，$DCDIR/spool下にファイルが作成されます。絶対パス名で指定した場合，指定したディレクトリ下にファイルが作成されます。ただし，ディレクトリは作成しません。また，すでに存在するファイル名は指定できません。

このオプション省略時は，$DCDIR/spool/mcfstcに出力します。

●-f　出力ファイルサイズ　　～〈符号なし整数〉((1～1000))《10》（単位：メガバイト）

MCF稼働統計情報を出力するファイルのサイズをメガバイト単位で指定します。ファイルサイズは次に示す算出式で算出します。

サービスグループの場合：↑(64+A)×出力回数／(1024×1024)↑

論理端末の場合：↑(64+B)×出力回数／(1024×1024)↑

MCF通信プロセスの場合：↑(64+C)×出力回数／(1024×1024)↑

すべての場合：(64＋(A+B+C))×出力回数／(1024×1024)

（凡例）

↑↑：小数点以下を切り上げます。

A：96×サービスグループ総数

B：64×4×論理端末総数

C：64×MCF通信プロセス総数

注

この算出式は，-uオプションで"＊"指定をした場合の最大値を仮定しています。

指定されたファイルサイズを超えた場合は，統計情報の出力を終了します。

●-s　時間間隔　　～〈符号なし整数〉((1～43200))《60》（単位：秒）

MCF稼働統計情報をファイルに出力する時間間隔を，秒単位で指定します。

指定を省略した場合は，60秒間隔で出力します。

●-t　出力回数　　～〈符号なし整数〉((1～65535))（単位：回）

出力回数を指定します。

指定を省略した場合はmcfstats -rが実行されるまで，MCFが停止するまで，または-fオプションで指定したファイルサイズを超えるまで出力します。指定した回数出力すると終了します。

また，-fオプションで指定したファイルサイズを超えた場合は，指定した出力回数に満たなくてもMCF稼働統計情報の出力を終了します。

●-r

MCF稼働統計情報の出力を終了します。

このオプションを指定すると，ほかのオプションは無効となります。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA19700-E | 内部関数処理中に障害が発生しました | 標準出力，メッセージログファイル
KFCA19701-W | 共用メモリが不足しているため，MCF稼働統計情報の取得ができません | 標準エラー出力，メッセージログファイル
KFCA19702-I | MCF稼働統計情報のファイル出力を開始しました | 標準出力，メッセージログファイル
KFCA19703-I | MCF稼働統計情報のファイル出力を終了しました | 標準出力，メッセージログファイル
KFCA19704-W | MCF稼働統計情報の取得を開始していません | 標準エラー出力
KFCA19705-W | MCF稼働統計情報の出力を開始していません | 標準エラー出力
KFCA19706-I | ファイルサイズを超えたためMCF稼働統計情報のファイル出力を終了します | 標準出力，メッセージログファイル
KFCA19707-E | MCF稼働統計情報のファイル出力処理中に障害が発生しました | 標準エラー出力，メッセージログファイル
KFCA19708-W | MCF稼働統計情報のファイル出力を開始しているため，コマンドは受け付けられません | 標準エラー出力
KFCA19709-W | 指定されたファイルはすでに存在します | 標準エラー出力
KFCA19710-E | MCF稼働統計情報のファイル出力準備に失敗しました | 標準エラー出力
KFCA19711-E | ファイルのオープンに失敗しました | 標準エラー出力

注意事項

出力対象が不正であっても，その統計情報が取得されていないものとして処理し，エラーメッセージは出力しません。

統計情報出力中のファイルを削除した場合，これ以降のOpenTP1の動作は保証しません。

出力時間間隔を短くした場合，MCFの稼働状況によって出力時間間隔が多少広がる場合があります。

mcftactcn

名称

コネクションの確立

形式

mcftactcn 〔-s MCF通信プロセス識別子〕
         ｛-c コネクションID｜-g コネクショングループ名｝
         〔-u サブコネクションID〕 〔-S XPサービス名@ホスト名〕

機能

コネクションを確立します。

オプション

●-s　MCF通信プロセス識別子　　～〈数字（0～9），a～f〉((01～ef))

処理対象のコネクションを制御するMCF通信サービスのMCF通信プロセス識別子を指定します。MCF通信プロセス識別子は複数指定できません。

このオプションの指定を省略すると，すべてのMCFに対して，mcftactcnコマンドを実行します。したがって，MCF通信サービスを検索するオーバヘッドが，運用コマンドの処理に加わります。

MCF通信サービスが多い構成や運用コマンドを多数入力する運用を行う場合は，-sオプションで，MCF通信プロセス識別子を指定する運用設計を行ってください。

●-c　コネクションID　　～〈1～8文字の識別子〉

確立するコネクションのコネクションIDを指定します。

コネクションIDは，1回につき8個まで指定できます。多数入力する運用を行う場合は，次に示す複数指定または一括指定を使用して，一つの運用コマンドで行う並列処理数を増やし，運用コマンド入力数を減らすように運用設計を行ってください。

複数のコネクションIDを指定するときは，引用符（"）で囲んで，コネクションIDとコネクションIDとの間を空白で区切ります。同一コネクションIDは，重複して指定できません。

また，コネクションIDは，＊を使って一括指定ができます。一括指定は一つだけ指定できます。一括指定と一括指定以外のコネクションIDを混在して指定できません。一括指定の場合も，引用符（"）で囲みます。

＊：すべてのコネクションを確立します。

先行文字列＊：先行文字列で始まるすべてのコネクションを確立します。

〈複数指定の例〉cnn1，cnn2，cnn3を指定する場合

-c "cnn1△cnn2△cnn3"

〈一括指定の例〉cnnで始まるすべてのコネクションを指定する場合

-c "cnn*"

●-g　コネクショングループ名　　～〈1～8文字の識別子〉

確立するコネクショングループの名称を指定します。

コネクショングループ名は，一度に8個まで指定できます。多数入力する運用を行う場合は，次に示す複数指定または一括指定を使用して，一つの運用コマンドで行う並列処理数を増やし，運用コマンド入力数を減らすように運用設計を行ってください。

複数のコネクショングループ名を指定するときは，引用符（"）で囲んで，コネクショングループ名とコネクショングループ名との間を空白で区切ります。同一コネクショングループ名は，重複して指定できません。

また，コネクショングループ名は，＊を使って一括指定ができます。一括指定は一つだけ指定できます。一括指定と一括指定以外のコネクショングループ名を混在して指定できません。一括指定の場合も，引用符（"）で囲みます。

＊：すべてのコネクショングループを確立します。

先行文字列＊：先行文字列で始まるすべてのコネクショングループを確立します。

〈複数指定の例〉　cng1，cng2，cng3を指定する場合

-g "cng1△cng2△cng3"

〈一括指定の例〉　cngで始まるすべてのコネクショングループを指定する場合

-g "cng*"

なお，このオプションは，TP1/NET/OSI-TPプロトコル，TP1/NET/X25-EXプロトコル，およびTP1/NET/NCSBプロトコル使用時だけ指定できます。

●-u　サブコネクションID　　～〈1～8文字の識別子〉

確立するサブコネクションのサブコネクションIDを指定します。

コネクションIDの指定が一つで，一括指定でないときだけ指定できます。

複数のサブコネクションIDの指定はできません。また一括指定もできません。

このオプションの指定を省略すると，指定したコネクション下のすべてのサブコネクションが確立されます。

なお，このオプションは，TP1/NET/HNA-NIFプロトコル使用時だけ指定できます。

●-S　XPサービス名＠ホスト名

接続するXPサービスを指定します。使用するプロトコルがTP1/NET/XMAP3の場合に指定してください。

XPサービス名　　～〈1～14文字の識別子〉

接続するXPサービス名を指定します。

ホスト名　　～〈1～127文字の識別子〉

接続するXPサービスの管理デーモンが動作するホスト名称を指定します。

このオプションを指定する場合は，コネクションIDは一つしか指定できません。また，-gオプションは指定できません。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10350-I | mcftactcnコマンドが入力されました | 標準出力
KFCA10351-E | MCF開始処理中です | 標準エラー出力
KFCA10352-E | MCF終了処理中です | 標準エラー出力
KFCA10353-W | 入力形式が誤っています | 標準エラー出力
KFCA10354-E | メモリ不足です | 標準エラー出力
KFCA10355-W | 引数の指定が誤っています | 標準エラー出力
KFCA10356-E | プロセス間でタイムアウトが発生しました | 標準エラー出力
KFCA10357-E | MCF内でタイムアウトが発生しました | 標準エラー出力
KFCA10358-E | 内部関数のエラーが発生しました | 標準エラー出力
KFCA10359-W | mcftactcnコマンド入力元への応答に失敗しました | メッセージログファイル
KFCA10371-I | mcftactcnコマンドを正常に受け付けました | 標準出力
KFCA10373-E | mcftactcnコマンドが異常終了しました | 標準エラー出力
KFCA10380-E | 相手プロセスの検索に失敗しました | 標準エラー出力
KFCA10381-E | 指定したコネクションは登録されていません | 標準エラー出力
KFCA10391-E | mcftactcnコマンドはサポートされていません | 標準エラー出力
KFCA10500-I | ヘルプメッセージ | 標準出力
KFCA16402-E | コマンド処理中にRPC障害が発生しました | 標準エラー出力
KFCA16424-E | 指定したコネクショングループは登録されていません | 標準エラー出力

上記のほかに，使用するプロトコルによってメッセージが出力されます。詳細については各プロトコルのマニュアルを参照してください。

mcftactle

名称

論理端末の閉塞解除

形式

mcftactle 〔-s MCF通信プロセス識別子〕〔-c コネクションID〕
            -l 論理端末名称 〔-t 閉塞解除種別〕

機能

論理端末の閉塞を解除します。

オプション

●-s　MCF通信プロセス識別子　　～〈数字（0～9），a～f〉((01～ef))

処理対象の論理端末を制御するMCF通信サービスのMCF通信プロセス識別子を指定します。MCF通信プロセス識別子は複数指定できません。

このオプションの指定を省略すると，すべてのMCFに対して，mcftactleコマンドを実行します。したがって，MCF通信サービスを検索するオーバヘッドが，運用コマンドの処理に加わります。

MCF通信サービスが多い構成や運用コマンドを多数入力する運用を行う場合は，-sオプションで，MCF通信プロセス識別子を指定する運用設計を行ってください。

●-c　コネクションID　　～〈1～8文字の識別子〉

閉塞解除したい論理端末に対応するコネクションのコネクションIDを指定します。

複数のコネクションIDは指定できません。また，一括指定もできません。

●-l　論理端末名称　　～〈1～8文字の識別子〉

閉塞解除する論理端末の名称を指定します。

-cオプションを指定した場合は，指定したコネクションIDに対応する論理端末の名称を指定します。

論理端末名称は，1回につき8個まで指定できます。多数入力する運用を行う場合は，次に示す複数指定または一括指定を使用して，一つの運用コマンドで行う並列処理数を増やし，運用コマンド入力数を減らすように運用設計を行ってください。

複数の論理端末名称を指定するときは，引用符（"）で囲んで，論理端末名称と論理端末名称との間を空白で区切ります。同一論理端末名称は，重複して指定できません。

また，論理端末名称は，＊を使って一括指定ができます。一括指定は一つだけ指定できます。一括指定と一括指定以外の論理端末名称を混在して指定できません。一括指定の場合も，引用符（"）で囲みます。

＊：すべての論理端末の閉塞を解除します。

先行文字列＊：先行文字列で始まるすべての論理端末の閉塞を解除します。

〈複数指定の例〉len1，len2，len3を指定する場合

-l "len1△len2△len3"

〈一括指定の例〉lenで始まるすべての論理端末を指定する場合

-l "len*"

●-t　閉塞解除種別　　～〈1～8文字の識別子〉《all》

閉塞解除の種別を指定します。

　all：論理端末の端末状態，およびキュー状態の閉塞を解除します。

　term：論理端末の端末状態の閉塞を解除します。

　queue：論理端末のキュー状態の閉塞を解除します。

このオプションは，プロトコルによっては指定できないものがあります。その場合，このオプションの指定は無視されます。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10350-I | mcftactleコマンドが入力されました | 標準出力
KFCA10351-E | MCF開始処理中です | 標準エラー出力
KFCA10352-E | MCF終了処理中です | 標準エラー出力
KFCA10353-W | 入力形式が誤っています | 標準エラー出力
KFCA10354-E | メモリ不足です | 標準エラー出力
KFCA10355-W | 引数の指定が誤っています | 標準エラー出力
KFCA10356-E | プロセス間でタイムアウトが発生しました | 標準エラー出力
KFCA10357-E | MCF内でタイムアウトが発生しました | 標準エラー出力
KFCA10358-E | 内部関数のエラーが発生しました | 標準エラー出力
KFCA10359-W | mcftactleコマンド入力元への応答に失敗しました | メッセージログファイル，または標準エラー出力
KFCA10371-I | mcftactleコマンドを正常に受け付けました | 標準出力
KFCA10373-E | mcftactleコマンドが異常終了しました | 標準エラー出力
KFCA10380-E | 相手プロセスの検索に失敗しました | 標準エラー出力
KFCA10381-E | 指定したコネクションは登録されていません | 標準エラー出力
KFCA10382-E | 指定した論理端末は登録されていません | 標準エラー出力
KFCA10390-E | 指定したコネクションIDと論理端末名称の対応が正しくありません | 標準エラー出力
KFCA10391-E | mcftactleコマンドはサポートされていません | 標準エラー出力
KFCA10395-E | 指定したコネクションには未接続の論理端末名称が指定されています | 標準エラー出力
KFCA10503-I | ヘルプメッセージ | 標準出力
KFCA16402-E | コマンド処理中にRPC障害が発生しました | 標準エラー出力

上記のほかに，使用するプロトコルによってメッセージが出力されます。詳細については各プロトコルのマニュアルを参照してください。

mcftactmj

名称

論理端末に関するメッセージジャーナルの取得開始

形式

mcftactmj 〔-s MCF通信プロセス識別子〕 -l 論理端末名称

機能

指定された論理端末に関するメッセージジャーナルの取得を開始します。

オプション

●-s　MCF通信プロセス識別子　　～〈数字（0～9），a～f〉((01～ef))

処理対象の論理端末を制御するMCF通信サービスのMCF通信プロセス識別子を指定します。MCF通信プロセス識別子は複数指定できません。

このオプションの指定を省略すると，すべてのMCFに対して，mcftactmjコマンドを実行します。したがって，MCF通信サービスを検索するオーバヘッドが，運用コマンドの処理に加わります。

MCF通信サービスが多い構成や運用コマンドを多数入力する運用を行う場合は，-sオプションで，MCF通信プロセス識別子を指定する運用設計を行ってください。

●-l　論理端末名称　　～〈1～8文字の識別子〉

メッセージジャーナル（MJ）の取得を開始する論理端末の名称を指定します。

論理端末名称は，1回につき8個まで指定できます。多数入力する運用を行う場合は，次に示す複数指定または一括指定を使用して，一つの運用コマンドで行う並列処理数を増やし，運用コマンド入力数を減らすように運用設計を行ってください。

複数の論理端末名称を指定するときは，引用符（"）で囲んで，論理端末名称と論理端末名称との間を空白で区切ります。同一論理端末名称は，重複して指定できません。

また，論理端末名称は，＊を使って一括指定ができます。一括指定は一つだけ指定できます。一括指定と一括指定以外の論理端末名称を混在して指定できません。一括指定の場合も，引用符（"）で囲みます。

＊：すべての論理端末に関するメッセージジャーナルの取得を開始します。

先行文字列＊：先行文字列で始まるすべての論理端末に関するメッセージジャーナルの取得を開始します。

〈複数指定の例〉len1，len2，len3を指定する場合

-l "len1△len2△len3"

〈一括指定の例〉lenで始まるすべての論理端末を指定する場合

-l "len*"

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10107-W | 指定した論理端末のMJはすでに取得中です | 標準エラー出力
KFCA10350-I | mcftactmjコマンドが入力されました | 標準出力
KFCA10351-E | MCF開始処理中です | 標準エラー出力
KFCA10352-E | MCF終了処理中です | 標準エラー出力
KFCA10353-W | 入力形式が誤っています | 標準エラー出力
KFCA10354-E | メモリ不足です | 標準エラー出力
KFCA10355-W | 引数の指定に誤りがあります | 標準エラー出力
KFCA10356-E | プロセス間でタイムアウトが発生しました | 標準エラー出力
KFCA10357-E | MCF内でタイムアウトが発生しました | 標準エラー出力
KFCA10358-E | 内部関数のエラーが発生しました | 標準エラー出力
KFCA10359-W | mcftactmjコマンド入力元への応答に失敗しました | メッセージログファイル，または標準エラー出力
KFCA10371-I | mcftactmjコマンドを正常に受け付けました | 標準出力
KFCA10373-E | mcftactmjコマンドが異常終了しました | 標準エラー出力
KFCA10380-E | 相手プロセスの検索に失敗しました | 標準エラー出力
KFCA10382-E | 指定した論理端末は登録されていません | 標準エラー出力
KFCA10527-I | ヘルプメッセージ | 標準出力
KFCA16402-E | コマンド処理中にRPC障害が発生しました | 標準エラー出力

mcftactsg

名称

サービスグループの閉塞解除

形式

mcftactsg  -g サービスグループ名 〔-t 閉塞解除種別〕

機能

サービスグループの閉塞を解除します。

オプション

●-g　サービスグループ名　　～〈1～31文字の識別子〉

閉塞を解除するサービスグループ名を指定します。

サービスグループ名は，1回につき8個まで指定できます。多数入力する運用を行う場合は，次に示す複数指定または一括指定を使用して，一つの運用コマンドで行う並列処理数を増やし，運用コマンド入力数を減らすように運用設計を行ってください。

複数のサービスグループ名を指定するときは，引用符（"）で囲んで，サービスグループ名とサービスグループ名との間を空白で区切ります。同一サービスグループ名は，重複して指定できません。

また，サービスグループ名は，＊を使って一括指定ができます。一括指定は一つだけ指定できます。一括指定と一括指定以外のサービスグループ名を混在して指定できません。一括指定の場合も，引用符（"）で囲みます。

＊：すべてのサービスグループの閉塞を解除します。

先行文字列＊：先行文字列で始まるすべてのサービスグループの閉塞を解除します。

〈複数指定の例〉seg1，seg2，seg3を指定する場合

-g "seg1△seg2△seg3"

〈一括指定の例〉segで始まるすべてのサービスグループを指定する場合

-g "seg*"

●-t　閉塞解除種別　　～《insc》

閉塞解除の種別を指定します。

　insc：入力キューの入力と，スケジュールの閉塞を解除します。

　in：入力キューの入力の閉塞を解除します。

　sc：入力キューのスケジュールの閉塞を解除します。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10350-I | mcftactsgコマンドが入力されました | 標準出力
KFCA10353-W | 入力形式が誤っています | 標準エラー出力
KFCA10354-E | メモリ不足です | 標準エラー出力
KFCA10355-W | 引数の指定が誤っています | 標準エラー出力
KFCA10356-E | プロセス間でタイムアウトが発生しました | 標準エラー出力
KFCA10357-E | MCF内でタイムアウトが発生しました | 標準エラー出力
KFCA10358-E | 内部関数のエラーが発生しました | 標準エラー出力
KFCA10359-W | mcftactsgコマンド入力元への応答に失敗しました | メッセージログファイル，または標準エラー出力
KFCA10371-I | mcftactsgコマンドを正常に受け付けました | 標準出力
KFCA10373-E | mcftactsgコマンドが異常終了しました | 標準エラー出力
KFCA10380-E | 相手プロセスの検索に失敗しました | 標準エラー出力
KFCA10383-E | 指定したサービスグループは登録されていません | 標準エラー出力
KFCA10513-I | ヘルプメッセージ | 標準出力
KFCA11038-W | サービスグループはすでに閉塞解除されています | 標準エラー出力
KFCA11042-W | MHPユーザサーバが終了中のため閉塞解除はできません | 標準エラー出力
KFCA11043-E | MHPユーザサーバが起動されていないため閉塞解除はできません | 標準エラー出力
KFCA11053-E | ユーザサーバが閉塞中のため閉塞解除はできません | 標準エラー出力
KFCA11088-W | コマンド処理は正常に行われましたが状態引き継ぎ登録処理に失敗しました | 標準エラー出力
KFCA11089-W | コマンド処理は正常に行われましたが，状態引き継ぎ個数が，定義で指定された上限値を超えているため，状態引き継ぎ登録ができませんでした | 標準エラー出力
KFCA11098-W | SPP資源のため閉塞，または閉塞解除できません | 標準エラー出力
KFCA16402-E | コマンド処理中にRPC障害が発生しました | 標準エラー出力

mcftactss

名称

セションの開始

形式

mcftactss 〔-s MCF通信プロセス識別子〕 〔-c コネクションID〕
           -l 論理端末名称

機能

指定した論理端末に対応するセションを開始します。

mcftactssコマンドは，TP1/NET/HNA-560/20プロトコル使用時に使用できます。

オプション

●-s　MCF通信プロセス識別子　　～〈数字（0～9），a～f〉((01～ef))

処理対象の論理端末を制御するMCF通信サービスのMCF通信プロセス識別子を指定します。MCF通信プロセス識別子は複数指定できません。

このオプションの指定を省略すると，すべてのMCFに対して，mcftactssコマンドを実行します。したがって，MCF通信サービスを検索するオーバヘッドが，運用コマンドの処理に加わります。

MCF通信サービスが多い構成や運用コマンドを多数入力する運用を行う場合は，-sオプションで，MCF通信プロセス識別子を指定する運用設計を行ってください。

●-c　コネクションID　　～〈1～8文字の識別子〉

セションを開始するコネクションのコネクションIDを指定します。

複数のコネクションIDは指定できません。また，一括指定もできません。

このオプションの指定を省略すると，すべてのコネクションに対して，mcftactssコマンドが実行されます。

●-l　論理端末名称　　～〈1～8文字の識別子〉

セションを開始する論理端末の名称を指定します。

論理端末名称は，1回につき8個まで指定できます。多数入力する運用を行う場合は，次に示す複数指定または一括指定を使用して，一つの運用コマンドで行う並列処理数を増やし，運用コマンド入力数を減らすように運用設計を行ってください。

複数の論理端末名称を指定するときは，引用符（"）で囲んで，論理端末名称と論理端末名称との間を空白で区切ります。同一論理端末名称は，重複して指定できません。

また，論理端末名称は，＊を使って一括指定ができます。一括指定は一つだけ指定できます。一括指定と一括指定以外の論理端末名称を混在して指定できません。一括指定の場合も，引用符（"）で囲みます。

＊：すべての論理端末に対応するセションを開始します。

先行文字列＊：先行文字列で始まるすべての論理端末に対応するセションを開始します。

〈複数指定の例〉len1，len2，len3を指定する場合

-l "len1△len2△len3"

〈一括指定の例〉lenで始まるすべての論理端末を指定する場合

-l "len*"

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10350-I | mcftactssコマンドが入力されました | 標準出力
KFCA10351-E | MCF開始処理中です | 標準エラー出力
KFCA10352-E | MCF終了処理中です | 標準エラー出力
KFCA10353-W | 入力形式が誤っています | 標準エラー出力
KFCA10354-E | メモリ不足です | 標準エラー出力
KFCA10355-W | 引数の指定が誤っています | 標準エラー出力
KFCA10356-E | プロセス間でタイムアウトが発生しました | 標準エラー出力
KFCA10357-E | MCF内でタイムアウトが発生しました | 標準エラー出力
KFCA10358-E | 内部関数のエラーが発生しました | 標準エラー出力
KFCA10359-W | mcftactssコマンド入力元への応答に失敗しました | メッセージログファイル
KFCA10371-I | mcftactssコマンドを正常に受け付けました | 標準出力
KFCA10373-E | mcftactssコマンドが異常終了しました | 標準エラー出力
KFCA10380-E | 相手プロセスの検索に失敗しました | 標準エラー出力
KFCA10381-E | 指定したコネクションは登録されていません | 標準エラー出力
KFCA10382-E | 指定した論理端末は登録されていません | 標準エラー出力
KFCA10390-E | 指定したコネクションIDと論理端末名称の対応が正しくありません | 標準エラー出力
KECA10395-E | 指定したコネクションには未接続の論理端末名称が指定されています | 標準エラー出力
KFCA10539-I | ヘルプメッセージ | 標準出力
KFCA16402-E | コマンド処理中にRPC障害が発生しました | 標準エラー出力

上記のほかに，使用するプロトコルによってメッセージが出力されます。詳細については各プロトコルのマニュアルを参照してください。

mcftactsv

名称

サービスの閉塞解除

形式

mcftactsv -v サービス名

機能

サービスの閉塞を解除します。

オプション

●-v　サービス名　　～〈1～31文字の識別子〉

閉塞を解除するサービス名を指定します。

サービス名は，1回につき8個まで指定できます。多数入力する運用を行う場合は，次に示す複数指定または一括指定を使用して，一つの運用コマンドで行う並列処理数を増やし，運用コマンド入力数を減らすように運用設計を行ってください。

複数のサービス名を指定するときは，引用符（"）で囲んで，サービス名とサービス名との間を空白で区切ります。同一サービス名は，重複して指定できません。

また，サービス名は，＊を使って一括指定ができます。一括指定は一つだけ指定できます。一括指定と一括指定以外のサービス名を混在して指定できません。一括指定の場合も，引用符（"）で囲みます。

＊：すべてのサービスの閉塞を解除します。

先行文字列＊：先行文字列で始まるすべてのサービスの閉塞を解除します。

〈複数指定の例〉ser1，ser2，ser3を指定する場合

-v "ser1△ser2△ser3"

〈一括指定の例〉serで始まるすべてのサービスを指定する場合

-v "ser*"

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10350-I | mcftactsvコマンドが入力されました | 標準出力
KFCA10353-W | 入力形式が誤っています | 標準エラー出力
KFCA10354-E | メモリ不足です | 標準エラー出力
KFCA10355-W | 引数の指定が誤っています | 標準エラー出力
KFCA10356-E | プロセス間でタイムアウトが発生しました | 標準エラー出力
KFCA10357-E | MCF内でタイムアウトが発生しました | 標準エラー出力
KFCA10358-E | 内部関数のエラーが発生しました | 標準エラー出力
KFCA10359-W | mcftactsvコマンド入力元への応答に失敗しました | メッセージログファイル，または標準エラー出力
KFCA10371-I | mcftactsvコマンドを正常に受け付けました | 標準出力
KFCA10373-E | mcftactsvコマンドが異常終了しました | 標準エラー出力
KFCA10380-E | 相手プロセスの検索に失敗しました | 標準エラー出力
KFCA10384-E | 指定したサービスは登録されていません | 標準エラー出力
KFCA10510-I | ヘルプメッセージ | 標準出力
KFCA11037-W | サービスはすでに閉塞解除されています | 標準エラー出力
KFCA11088-W | コマンド処理は正常に行われましたが状態引き継ぎ登録処理に失敗しました | 標準エラー出力
KFCA11089-W | コマンド処理は正常に行われましたが，状態引き継ぎ個数が，定義で指定された上限値を超えているため，状態引き継ぎ登録ができませんでした | 標準エラー出力
KFCA11098-W | SPP資源のため閉塞，または閉塞解除できません | 標準エラー出力
KFCA16402-E | コマンド処理中にRPC障害が発生しました | 標準エラー出力

mcftchcn

名称

コネクションの切り替え

形式

mcftchcn 〔-s MCF通信プロセス識別子〕 -f 切り替え元コネクションID
          -t 切り替え先コネクションID

機能

切り替え元のコネクションと論理端末の接続を無効にして，切り替え先のコネクションと論理端末を接続します。

mcftchcnコマンドを実行する前に，切り替え元のコネクション上の論理端末を閉塞してください。

mcftchcnコマンドは，TP1/NET/TCP/IPプロトコル使用時に使用できます。

オプション

●-s　MCF通信プロセス識別子　　～〈数字（0～9），a～f〉((01～ef))

処理対象のコネクションを制御するMCF通信サービスのMCF通信プロセス識別子を指定します。MCF通信プロセス識別子は複数指定できません。

このオプションの指定を省略すると，すべてのMCFに対して，mcftchcnコマンドを実行します。したがって，MCF通信サービスを検索するオーバヘッドが，運用コマンドの処理に加わります。

MCF通信サービスが多い構成や運用コマンドを多数入力する運用を行う場合は，-sオプションで，MCF通信プロセス識別子を指定する運用設計を行ってください。

●-f　切り替え元コネクションID　　～〈1～8文字の識別子〉

切り替え元のコネクションIDを指定します。

複数の切り替え元コネクションIDは指定できません。

●-t　切り替え先コネクションID　　～〈1～8文字の識別子〉

切り替え先のコネクションIDを指定します。

複数の切り替え先コネクションIDは指定できません。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10350-I | mcftchcnコマンドが入力されました | 標準出力
KFCA10351-E | MCF開始処理中です | 標準エラー出力
KFCA10352-E | MCF終了処理中です | 標準エラー出力
KFCA10353-W | 入力形式が誤っています | 標準エラー出力
KFCA10354-E | メモリ不足です | 標準エラー出力
KFCA10355-W | 引数の指定が誤っています | 標準エラー出力
KFCA10356-E | プロセス間でタイムアウトが発生しました | 標準エラー出力
KFCA10358-E | 内部関数のエラーが発生しました | 標準エラー出力
KFCA10359-W | mcftchcnコマンド入力元への応答に失敗しました | メッセージログファイル
KFCA10371-I | mcftchcnコマンドを正常に受け付けました | 標準出力
KFCA10373-E | mcftchcnコマンドが異常終了しました | 標準エラー出力
KFCA10380-E | 相手プロセスの検索に失敗しました | 標準エラー出力
KFCA10381-E | 指定したコネクションは登録されていません | 標準エラー出力
KFCA10391-E | mcftchcnコマンドはサポートされていません | 標準エラー出力
KFCA10392-E | 必要なプログラムプロダクトがインストールされていません | 標準エラー出力
KFCA16402-E | コマンド処理中にRPC障害が発生しました | 標準エラー出力

メッセージの詳細については，マニュアル「OpenTP1 プロトコル TP1/NET/TCP/IP編」を参照してください。

注意事項

mcftchcnコマンドを実行するには，TP1/NET/High Availabilityをインストールしておく必要があります。

mcftdctcn

名称

コネクションの解放

形式

mcftdctcn 〔-s MCF通信プロセス識別子〕
         ｛-c コネクションID｜-g コネクショングループ名｝
         〔-u サブコネクションID〕 〔-f〕

機能

コネクションを解放します。

オプション

●-s　MCF通信プロセス識別子　　～〈数字（0～9），a～f〉((01～ef))

処理対象のコネクションを制御するMCF通信サービスのMCF通信プロセス識別子を指定します。MCF通信プロセス識別子は複数指定できません。

このオプションの指定を省略すると，すべてのMCFに対して，mcftdctcnコマンドを実行します。したがって，MCF通信サービスを検索するオーバヘッドが，運用コマンドの処理に加わります。

MCF通信サービスが多い構成や運用コマンドを多数入力する運用を行う場合は，-sオプションで，MCF通信プロセス識別子を指定する運用設計を行ってください。

●-c　コネクションID　　～〈1～8文字の識別子〉

解放するコネクションのコネクションIDを指定します。

コネクションIDは，1回につき8個まで指定できます。多数入力する運用を行う場合は，次に示す複数指定または一括指定を使用して，一つの運用コマンドで行う並列処理数を増やし，運用コマンド入力数を減らすように運用設計を行ってください。

複数のコネクションIDを指定するときは，引用符（"）で囲んで，コネクションIDとコネクションIDとの間を空白で区切ります。同一コネクションIDは，重複して指定できません。

また，コネクションIDは，＊を使って一括指定ができます。一括指定は一つだけ指定できます。一括指定と一括指定以外のコネクションIDを混在して指定できません。一括指定の場合も，引用符（"）で囲みます。

＊：すべてのコネクションを解放します。

先行文字列＊：先行文字列で始まるすべてのコネクションを解放します。

〈複数指定の例〉cnn1，cnn2，cnn3を指定する場合

-c "cnn1△cnn2△cnn3"

〈一括指定の例〉cnnで始まるすべてのコネクションを指定する場合

-c "cnn*"

●-g　コネクショングループ名　　～〈1～8文字の識別子〉

解放するコネクショングループの名称を指定します。

コネクショングループ名は，一度に8個まで指定できます。多数入力する運用を行う場合は，次に示す複数指定または一括指定を使用して，一つの運用コマンドで行う並列処理数を増やし，運用コマンド入力数を減らすように運用設計を行ってください。

複数のコネクショングループ名を指定するときは，引用符（"）で囲んで，コネクショングループ名とコネクショングループ名との間を空白で区切ります。同一コネクショングループ名は，重複して指定できません。

また，コネクショングループ名は，＊を使って一括指定ができます。一括指定は一つだけ指定できます。一括指定と一括指定以外のコネクショングループ名を混在して指定できません。一括指定の場合も，引用符（"）で囲みます。

＊：すべてのコネクショングループを解放します。

先行文字列＊：先行文字列で始まるすべてのコネクショングループを解放します。

〈複数指定の例〉　cng1，cng2，cng3を指定する場合

-g "cng1△cng2△cng3"

〈一括指定の例〉　cngで始まるすべてのコネクショングループを指定する場合

-g "cng*"

なお，このオプションは，TP1/NET/OSI-TPプロトコル，TP1/NET/X25-EXプロトコル，およびTP1/NET/NCSBプロトコル使用時だけ指定できます。

●-u　サブコネクションID　　～〈1～8文字の識別子〉

解放するサブコネクションのサブコネクションIDを指定します。

コネクションIDの指定が一つで，一括指定でないときだけ指定できます。

複数のサブコネクションIDの指定はできません。また一括指定もできません。

このオプションの指定を省略すると，指定したコネクション下のすべてのサブコネクションが解放されます。

なお，このオプションは，TP1/NET/HNA-NIFプロトコル使用時だけ指定できます。

●-f

該当するコネクションを強制的に解放します。

このオプションの指定を省略した場合の処理は，プロトコルによって異なります。詳細については各プロトコルのマニュアルを参照してください。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10350-I | mcftdctcnコマンドが入力されました | 標準出力
KFCA10351-E | MCF開始処理中です | 標準エラー出力
KFCA10352-E | MCF終了処理中です | 標準エラー出力
KFCA10353-W | 入力形式が誤っています | 標準エラー出力
KFCA10354-E | メモリ不足です | 標準エラー出力
KFCA10355-W | 引数の指定が誤っています | 標準エラー出力
KFCA10356-E | プロセス間でタイムアウトが発生しました | 標準エラー出力
KFCA10357-E | MCF内でタイムアウトが発生しました | 標準エラー出力
KFCA10358-E | 内部関数のエラーが発生しました | 標準エラー出力
KFCA10359-W | mcftdctcnコマンド入力元への応答に失敗しました | メッセージログファイル
KFCA10371-I | mcftdctcnコマンドを正常に受け付けました | 標準出力
KFCA10373-E | mcftdctcnコマンドが異常終了しました | 標準エラー出力
KFCA10380-E | 相手プロセスの検索に失敗しました | 標準エラー出力
KFCA10381-E | 指定したコネクションは登録されていません | 標準エラー出力
KFCA10391-E | mcftdctcnコマンドはサポートされていません | 標準エラー出力
KFCA10501-I | ヘルプメッセージ | 標準出力
KFCA16402-E | コマンド処理中にRPC障害が発生しました | 標準エラー出力
KFCA16424-E | 指定したコネクショングループは登録されていません | 標準エラー出力

上記のほかに，使用するプロトコルによってメッセージが出力されます。詳細については各プロトコルのマニュアルを参照してください。

mcftdctle

名称

論理端末の閉塞

形式

mcftdctle 〔-s MCF通信プロセス識別子〕〔-c コネクションID〕
           -l 論理端末名称 〔-t 閉塞種別〕

機能

論理端末を強制的に閉塞します。

オプション

●-s　MCF通信プロセス識別子　　～〈数字（0～9），a～f〉((01～ef))

処理対象の論理端末を制御するMCF通信サービスのMCF通信プロセス識別子を指定します。MCF通信プロセス識別子は複数指定できません。

このオプションの指定を省略すると，すべてのMCFに対して，mcftdctleコマンドを実行します。したがって，MCF通信サービスを検索するオーバヘッドが，運用コマンドの処理に加わります。

MCF通信サービスが多い構成や運用コマンドを多数入力する運用を行う場合は，-sオプションで，MCF通信プロセス識別子を指定する運用設計を行ってください。

●-c　コネクションID　　～〈1～8文字の識別子〉

閉塞したい論理端末に対応するコネクションのコネクションIDを指定します。

複数のコネクションIDは指定できません。また，一括指定もできません。

●-l　論理端末名称　　～〈1～8文字の識別子〉

閉塞する論理端末の名称を指定します。

-cオプションを指定した場合，指定したコネクションIDに対応する論理端末名称を指定します。

論理端末名称は，1回につき8個まで指定できます。多数入力する運用を行う場合は，次に示す複数指定または一括指定を使用して，一つの運用コマンドで行う並列処理数を増やし，運用コマンド入力数を減らすように運用設計を行ってください。

複数の論理端末名称を指定するときは，引用符（"）で囲んで，論理端末名称と論理端末名称との間を空白で区切ります。同一論理端末名称は，重複して指定できません。

また，論理端末名称は，＊を使って一括指定ができます。一括指定は一つだけ指定できます。一括指定と一括指定以外の論理端末名称を混在して指定できません。一括指定の場合も，引用符（"）で囲みます。

＊：すべての論理端末を閉塞します。

先行文字列＊：先行文字列で始まるすべての論理端末を閉塞します。

〈複数指定の例〉len1，len2，len3を指定する場合

-l "len1△len2△len3"

〈一括指定の例〉lenで始まるすべての論理端末を指定する場合

-l "len*"

●-t　閉塞種別　　～〈1～8文字の識別子〉《all》

閉塞の種別を指定します。

　all：論理端末の端末状態，およびキュー状態を閉塞します。

　term：論理端末の端末状態を閉塞します。

　queue：論理端末のキュー状態を閉塞します。

このオプションは，プロトコルによっては指定できないものがあります。その場合，このオプションの指定は無視されます。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10350-I | mcftdctleコマンドが入力されました | 標準出力
KFCA10351-E | MCF開始処理中です | 標準エラー出力
KFCA10352-E | MCF終了処理中です | 標準エラー出力
KFCA10353-W | 入力形式が誤っています | 標準エラー出力
KFCA10354-E | メモリ不足です | 標準エラー出力
KFCA10355-W | 引数の指定が誤っています | 標準エラー出力
KFCA10356-E | プロセス間でタイムアウトが発生しました | 標準エラー出力
KFCA10357-E | MCF内でタイムアウトが発生しました | 標準エラー出力
KFCA10358-E | 内部関数のエラーが発生しました | 標準エラー出力
KFCA10359-W | mcftdctleコマンド入力元への応答に失敗しました | メッセージログファイル，または標準エラー出力
KFCA10371-I | mcftdctleコマンドを正常に受け付けました | 標準出力
KFCA10373-E | mcftdctleコマンドが異常終了しました | 標準エラー出力
KFCA10380-E | 相手プロセスの検索に失敗しました | 標準エラー出力
KFCA10381-E | 指定したコネクションは登録されていません | 標準エラー出力
KFCA10382-E | 指定した論理端末は登録されていません | 標準エラー出力
KFCA10390-E | 指定したコネクションIDと論理端末名称の対応が正しくありません | 標準エラー出力
KFCA10391-E | mcftdctleコマンドはサポートされていません | 標準エラー出力
KFCA10395-E | 指定したコネクションには未接続の論理端末名称が指定されています | 標準エラー出力
KFCA10504-I | ヘルプメッセージ | 標準出力
KFCA16402-E | コマンド処理中にRPC障害が発生しました | 標準エラー出力

上記のほかに，使用するプロトコルによってメッセージが出力されます。詳細については各プロトコルのマニュアルを参照してください。

mcftdctmj

名称

論理端末に関するメッセージジャーナルの取得終了

形式

mcftdctmj 〔-s MCF通信プロセス識別子〕 -l 論理端末名称

機能

指定された論理端末に関するメッセージジャーナルの取得を終了します。

オプション

●-s　MCF通信プロセス識別子　　～〈数字（0～9），a～f〉((01～ef))

処理対象の論理端末を制御するMCF通信サービスのMCF通信プロセス識別子を指定します。MCF通信プロセス識別子は複数指定できません。

このオプションの指定を省略すると，すべてのMCFに対して，mcftdctmjコマンドを実行します。したがって，MCF通信サービスを検索するオーバヘッドが，運用コマンドの処理に加わります。

MCF通信サービスが多い構成や運用コマンドを多数入力する運用を行う場合は，-sオプションで，MCF通信プロセス識別子を指定する運用設計を行ってください。

●-l　論理端末名称　　～〈1～8文字の識別子〉

メッセージジャーナルの取得を終了する論理端末の名称を指定します。

論理端末名称は，1回につき8個まで指定できます。多数入力する運用を行う場合は，次に示す複数指定または一括指定を使用して，一つの運用コマンドで行う並列処理数を増やし，運用コマンド入力数を減らすように運用設計を行ってください。

複数の論理端末名称を指定するときは，引用符（"）で囲んで，論理端末名称と論理端末名称との間を空白で区切ります。同一論理端末名称は，重複して指定できません。

また，論理端末名称は，＊を使って一括指定ができます。一括指定は一つだけ指定できます。一括指定と一括指定以外の論理端末名称を混在して指定できません。一括指定の場合も，引用符（"）で囲んで指定します。

＊：すべての論理端末に関するメッセージジャーナルの取得を終了します。

先行文字列＊：先行文字列で始まるすべての論理端末に関するメッセージジャーナルの取得を終了します。

〈複数指定の例〉　len1，len2，len3を指定する場合

-l "len1△len2△len3"

〈一括指定の例〉　lenで始まるすべての論理端末を指定する場合

-l "len*"

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10108-W | 指定した論理端末のMJ取得処理は停止中です | 標準エラー出力
KFCA10350-I | mcftdctmjコマンドが入力されました | 標準出力
KFCA10351-E | MCF開始処理中です | 標準エラー出力
KFCA10352-E | MCF終了処理中です | 標準エラー出力
KFCA10353-W | 入力形式が誤っています | 標準エラー出力
KFCA10354-E | メモリ不足です | 標準エラー出力
KFCA10355-W | 引数の指定に誤りがあります | 標準エラー出力
KFCA10356-E | プロセス間でタイムアウトが発生しました | 標準エラー出力
KFCA10357-E | MCF内でタイムアウトが発生しました | 標準エラー出力
KFCA10358-E | 内部関数のエラーが発生しました | 標準エラー出力
KFCA10359-W | mcftdctmjコマンド入力元への応答に失敗しました | メッセージログファイル，または標準エラー出力
KFCA10371-I | mcftdctmjコマンドを正常に受け付けました | 標準出力
KFCA10373-E | mcftdctmjコマンドが異常終了しました | 標準エラー出力
KFCA10380-E | 相手プロセスの検索に失敗しました | 標準エラー出力
KFCA10382-E | 指定した論理端末は登録されていません | 標準エラー出力
KFCA10528-I | ヘルプメッセージ | 標準出力
KFCA16402-E | コマンド処理中にRPC障害が発生しました | 標準エラー出力

mcftdctsg

名称

サービスグループの閉塞

形式

mcftdctsg -g サービスグループ名 〔-t 閉塞種別〕〔-r〕

機能

サービスグループを閉塞します。

オプション

●-g　サービスグループ名　　～〈1～31文字の識別子〉

閉塞するサービスグループ名を指定します。

サービスグループ名は，1回につき8個まで指定できます。多数入力する運用を行う場合は，次に示す複数指定または一括指定を使用して，一つの運用コマンドで行う並列処理数を増やし，運用コマンド入力数を減らすように運用設計を行ってください。

複数のサービスグループ名を指定するときは，引用符（"）で囲んで，サービスグループ名とサービスグループ名との間を空白で区切ります。同一サービスグループ名は，重複して指定できません。

また，サービスグループ名は，＊を使って一括指定ができます。一括指定は一つだけ指定できます。一括指定と一括指定以外のサービスグループ名を混在して指定できません。一括指定の場合も，引用符（"）で囲みます。

＊：すべてのサービスグループを閉塞します。

先行文字列＊：先行文字列で始まるすべてのサービスグループを閉塞します。

〈複数指定の例〉　seg1，seg2，seg3を指定する場合

-g"seg1△seg2△seg3"

〈一括指定の例〉　segで始まるすべてのサービスグループを指定する場合

-g "seg*"

●-t　閉塞種別　　～《insc》

サービスグループの閉塞種別を指定します。

　insc：入力キューの入力とスケジュールを閉塞します。

　in：入力キューの入力だけ閉塞します。

　sc：入力キューのスケジュールだけ閉塞します。

●-r

全面回復時に，サービスグループの閉塞状態を引き継がない場合に指定します。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10350-I | mcftdctsgコマンドが入力されました | 標準出力
KFCA10353-W | 入力形式が誤っています | 標準エラー出力
KFCA10354-E | メモリ不足です | 標準エラー出力
KFCA10355-W | 引数の指定が誤っています | 標準エラー出力
KFCA10356-E | プロセス間でタイムアウトが発生しました | 標準エラー出力
KFCA10357-E | MCF内でタイムアウトが発生しました | 標準エラー出力
KFCA10358-E | 内部関数のエラーが発生しました | 標準エラー出力
KFCA10359-W | mcftdctsgコマンド入力元への応答に失敗しました | メッセージログファイル，または標準エラー出力
KFCA10371-I | mcftdctsgコマンドを正常に受け付けました | 標準出力
KFCA10373-E | mcftdctsgコマンドが異常終了しました | 標準エラー出力
KFCA10380-E | 相手プロセスの検索に失敗しました | 標準エラー出力
KFCA10383-E | 指定したサービスグループは登録されていません | 標準エラー出力
KFCA10514-I | ヘルプメッセージ | 標準出力
KFCA11064-W | 該当するサービスグループはコマンドによってすでに閉塞されています | 標準エラー出力
KFCA11088-W | コマンド処理は正常に行われましたが状態引き継ぎ登録処理に失敗しました | 標準エラー出力
KFCA11089-W | コマンド処理は正常に行われましたが，状態引き継ぎ個数が，定義で指定した上限値を超えているため，状態引き継ぎ登録ができませんでした | 標準エラー出力
KFCA11098-W | SPP資源のため閉塞，または閉塞解除できません | 標準エラー出力
KFCA16402-E | コマンド処理中にRPC障害が発生しました | 標準エラー出力

mcftdctss

名称

セションの終了

形式

mcftdctss 〔-s MCF通信プロセス識別子〕 〔-c コネクションID〕
           -l 論理端末名称

機能

指定した論理端末に対応するセションを終了します。

mcftdctssコマンドは，TP1/NET/HNA-560/20およびTP1/NET/C/S560プロトコル使用時に使用できます。

オプション

●-s　MCF通信プロセス識別子　　～〈数字（0～9），a～f〉((01～ef))

処理対象の論理端末を制御するMCF通信サービスのMCF通信プロセス識別子を指定します。MCF通信プロセス識別子は複数指定できません。

このオプションの指定を省略すると，すべてのMCFに対して，mcftdctssコマンドを実行します。したがって，MCF通信サービスを検索するオーバヘッドが，運用コマンドの処理に加わります。

MCF通信サービスが多い構成や運用コマンドを多数入力する運用を行う場合は，-sオプションで，MCF通信プロセス識別子を指定する運用設計を行ってください。

●-c　コネクションID　　～〈1～8文字の識別子〉

セションを終了するコネクションのコネクションIDを指定します。

複数のコネクションIDは指定できません。また，一括指定もできません。

このオプションの指定を省略すると，すべてのコネクションに対して，mcftdctssコマンドが実行されます。

●-l　論理端末名称　　～〈1～8文字の識別子〉

セションを終了する論理端末の名称を指定します。

論理端末名称は，1回につき8個まで指定できます。多数入力する運用を行う場合は，次に示す複数指定または一括指定を使用して，一つの運用コマンドで行う並列処理数を増やし，運用コマンド入力数を減らすように運用設計を行ってください。

複数の論理端末名称を指定するときは，引用符（"）で囲んで，論理端末名称と論理端末名称との間を空白で区切ります。同一論理端末名称は，重複して指定できません。

また，論理端末名称は，＊を使って一括指定ができます。一括指定は一つだけ指定できます。一括指定と一括指定以外の論理端末名称を混在して指定できません。一括指定の場合も，引用符（"）で囲んで指定します。

＊：すべての論理端末に対するセションを終了します。

先行文字列*：先行文字列で始まるすべての論理端末に対するセションを終了します。

〈複数指定の例〉len1，len2，len3を指定する場合

-l "len1△len2△len3"

〈一括指定の例〉lenで始まるすべての論理端末を指定する場合

-l "len*"

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10350-I | mcftdctssコマンドが入力されました | 標準出力
KFCA10351-E | MCF開始処理中です | 標準エラー出力
KFCA10352-E | MCF終了処理中です | 標準エラー出力
KFCA10353-W | 入力形式が誤っています | 標準エラー出力
KFCA10354-E | メモリ不足です | 標準エラー出力
KFCA10355-W | 引数の指定が誤っています | 標準エラー出力
KFCA10356-E | プロセス間でタイムアウトが発生しました | 標準エラー出力
KFCA10357-E | MCF内でタイムアウトが発生しました | 標準エラー出力
KFCA10358-E | 内部関数のエラーが発生しました | 標準エラー出力
KFCA10359-W | mcftdctssコマンド入力元への応答に失敗しました | メッセージログファイル
KFCA10371-I | mcftdctssコマンドを正常に受け付けました | 標準出力
KFCA10373-E | mcftdctssコマンドが異常終了しました | 標準エラー出力
KFCA10380-E | 相手プロセスの検索に失敗しました | 標準エラー出力
KFCA10381-E | 指定したコネクションは登録されていません | 標準エラー出力
KFCA10382-E | 指定した論理端末は登録されていません | 標準エラー出力
KFCA10390-E | 指定されたコネクションIDと論理端末名称の対応が正しくありません | 標準エラー出力
KFCA10395-E | 指定したコネクションには未接続の論理端末名称が指定されています | 標準エラー出力
KFCA10540-I | ヘルプメッセージ | 標準出力
KFCA16402-E | コマンド処理中にRPC障害が発生しました | 標準エラー出力

上記のほかに，使用するプロトコルによってメッセージが出力されます。詳細については各プロトコルのマニュアルを参照してください。

mcftdctsv

名称

サービスの閉塞

形式

mcftdctsv -v サービス名 〔-t 閉塞種別〕

機能

サービスを閉塞します。

オプション

●-v　サービス名　　～〈1～31文字の識別子〉

閉塞するサービスの名称を指定します。

サービス名は，1回につき8個まで指定できます。多数入力する運用を行う場合は，次に示す複数指定または一括指定を使用して，一つの運用コマンドで行う並列処理数を増やし，運用コマンド入力数を減らすように運用設計を行ってください。

複数のサービス名を指定するときは，引用符（"）で囲んで，サービス名とサービス名との間を空白で区切ります。同一サービス名は，重複して指定できません。

また，サービス名は，＊を使って一括指定ができます。一括指定は一つだけ指定できます。一括指定と一括指定以外のサービス名を混在して指定できません。一括指定の場合も，引用符（"）で囲んで指定します。

＊：すべてのサービスを閉塞します。

先行文字列＊：先行文字列で始まるすべてのサービスを閉塞します。

〈複数指定の例〉　ser1，ser2，ser3を指定する場合

-v "ser1△ser2△ser3"

〈一括指定の例〉　serで始まるすべてのサービスを指定する場合

-v "ser*"

●-t　閉塞種別　　～《insc》

サービスの閉塞種別を指定します。

　insc：入力キューの入力とスケジュールを閉塞します。

　in：入力キューの入力だけ閉塞します。

　sc：入力キューのスケジュールだけ閉塞します。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10350-I | mcftdctsvコマンドが入力されました | 標準出力
KFCA10353-W | 入力形式が誤っています | 標準エラー出力
KFCA10354-E | メモリ不足です | 標準エラー出力
KFCA10355-W | 引数の指定が誤っています | 標準エラー出力
KFCA10356-E | プロセス間でタイムアウトが発生しました | 標準エラー出力
KFCA10357-E | MCF内でタイムアウトが発生しました | 標準エラー出力
KFCA10358-E | 内部関数のエラーが発生しました | 標準エラー出力
KFCA10359-W | mcftdctsvコマンド入力元への応答に失敗しました | メッセージログファイル，または標準エラー出力
KFCA10371-I | mcftdctsvコマンドを正常に受け付けました | 標準出力
KFCA10373-E | mcftdctsvコマンドが異常終了しました | 標準エラー出力
KFCA10380-E | 相手プロセスの検索に失敗しました | 標準エラー出力
KFCA10384-E | 指定したサービスは登録されていません | 標準エラー出力
KFCA10511-I | ヘルプメッセージ | 標準出力
KFCA11036-W | 該当するサービスはコマンドによってすでに閉塞されています | 標準エラー出力
KFCA11088-W | コマンド処理は正常に行われましたが状態引き継ぎ登録処理に失敗しました | 標準エラー出力
KFCA11089-W | コマンド処理は正常に行われましたが，状態引き継ぎ個数が，定義で指定された上限値を超えているため，状態引き継ぎ登録ができませんでした | 標準エラー出力
KFCA11098-W | SPP資源のため閉塞，または閉塞解除できません | 標準エラー出力
KFCA16402-E | コマンド処理中にRPC障害が発生しました | 標準エラー出力

mcftdlqle

名称

論理端末の出力キュー削除

形式

mcftdlqle 〔-s MCF通信プロセス識別子〕 -l 論理端末名称
         〔-d 削除種別〕

機能

指定した論理端末の出力キューをすべて削除します。

mcftdlqleコマンドを単独で使用する場合は，mcftdlqleコマンドを実行する前に，mcftdctleコマンドまたはdc_mcf_tdctle関数で該当する論理端末を閉塞しておいてください。TP1/NET/HNA-560/20プロトコルを使用している場合は，さらにmcftdctssコマンドでセションを終了しておいてください。また，論理端末が代行元論理端末であってはなりません。

mcftdmpquコマンドと組み合わせて使用する場合は，mcftdlqleコマンドを実行する前に，mcfthldoqコマンドで該当する論理端末の出力キュー処理を保留しておいてください。

オプション

●-s　MCF通信プロセス識別子　　～〈数字（0～9），a～f〉((01～ef))

処理対象の論理端末を制御するMCF通信サービスのMCF通信プロセス識別子を指定します。MCF通信プロセス識別子は複数指定できません。

このオプションの指定を省略すると，すべてのMCFに対して，mcftdlqleコマンドを実行します。したがって，MCF通信サービスを検索するオーバヘッドが，運用コマンドの処理に加わります。

MCF通信サービスが多い構成や運用コマンドを多数入力する運用を行う場合は，-sオプションで，MCF通信プロセス識別子を指定する運用設計を行ってください。

●-l　論理端末名称　　～〈1～8文字の識別子〉

出力キューを削除する論理端末の名称を指定します。

論理端末名称は，1回につき8個まで指定できます。多数入力する運用を行う場合は，次に示す複数指定または一括指定を使用して，一つの運用コマンドで行う並列処理数を増やし，運用コマンド入力数を減らすように運用設計を行ってください。

複数の論理端末名称を指定するときは，引用符（"）で囲んで，論理端末名称と論理端末名称との間を空白で区切ります。同一論理端末名称は，重複して指定できません。

論理端末名称は，＊を使って一括指定ができます。一括指定は一つだけ指定できます。一括指定と一括指定以外の論理端末名称を混在して指定できません。一括指定の場合は，引用符（"）で囲んで指定します。

＊：すべての論理端末の出力キューを削除します。

先行文字列＊：先行文字列で始まるすべての論理端末の出力キューを削除します。

〈複数指定の例〉len1，len2，len3を指定する場合

-l "len1△len2△len3"

〈一括指定の例〉lenで始まるすべての論理端末を指定する場合

-l "len*"

●-d　削除種別

削除種別を指定します。

　disk：ディスクキューだけ削除します。

　memory：メモリキューだけ削除します。

　all：ディスクキューとメモリキューを両方とも削除します。

このオプションを指定すると，未処理送信メッセージ廃棄通知イベント（ERREVTA）は通知されません。

このオプションの指定を省略すると，未処理送信メッセージ廃棄通知イベント（ERREVTA）用のMHPが通知され，出力キュー（ディスクキューとメモリキュー）が削除されます。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10103-E | 指定した論理端末は閉塞（または保留）されていません | 標準エラー出力
KFCA10350-I | mcftdlqleコマンドが入力されました | 標準出力
KFCA10351-E | MCF開始処理中です | 標準エラー出力
KFCA10352-E | MCF終了処理中です | 標準エラー出力
KFCA10353-W | 入力形式が誤っています | 標準エラー出力
KFCA10354-E | メモリ不足です | 標準エラー出力
KFCA10355-W | 引数の指定が誤っています | 標準エラー出力
KFCA10356-E | プロセス間でタイムアウトが発生しました | 標準エラー出力
KFCA10357-E | MCF内でタイムアウトが発生しました | 標準エラー出力
KFCA10358-E | 内部関数のエラーが発生しました | 標準エラー出力
KFCA10359-W | mcftdlqleコマンド入力元への応答に失敗しました | メッセージログファイル，または標準エラー出力
KFCA10371-I | mcftdlqleコマンドを正常に受け付けました | 標準出力
KFCA10373-E | mcftdlqleコマンドが異常終了しました | 標準エラー出力
KFCA10380-E | 相手プロセスの検索に失敗しました | 標準エラー出力
KFCA10382-E | 指定した論理端末は登録されていません | 標準エラー出力
KFCA10391-E | mcftdlqleコマンドはサポートされていません | 標準エラー出力
KFCA10507-I | ヘルプメッセージ | 標準出力
KFCA16402-E | コマンド処理中にRPC障害が発生しました | 標準エラー出力

mcftdlqsg

名称

サービスグループの入力キュー削除

形式

mcftdlqsg -g サービスグループ名 -d 削除種別

機能

指定したサービスグループに対応する入力キューを削除します。

mcftdlqsgコマンドを単独で使用する場合は，mcftdlqsgコマンドを実行する前に，mcftdctsgコマンドで該当するサービスグループを閉塞しておいてください。

mcftdmpquコマンドと組み合わせて使用する場合は，mcftdlqsgコマンドを実行する前に，mcfthldiqコマンドで該当するサービスグループの入力キュー処理を保留しておいてください。

オプション

●-g　サービスグループ名　　～〈1～31文字の識別子〉

入力キューを削除するサービスグループの名称を指定します。

サービスグループ名は，1回につき8個まで指定できます。多数入力する運用を行う場合は，次に示す複数指定または一括指定を使用して，一つの運用コマンドで行う並列処理数を増やし，運用コマンド入力数を減らすように運用設計を行ってください。

複数のサービスグループ名を指定するときは，引用符（"）で囲んで，サービスグループ名とサービスグループ名との間を空白で区切ります。同一サービスグループ名は，重複して指定できません。

サービスグループ名は，＊を使って一括指定ができます。一括指定は一つだけ指定できます。一括指定と一括指定以外のサービスグループ名を混在して指定できません。一括指定の場合は，引用符（"）で囲んで指定します。

＊：すべてのサービスグループに対応する入力キューを削除します。

先行文字列 ＊：先行文字列で始まるすべてのサービスグループに対応する入力キューを削除します。

〈複数指定の例〉seg1，seg2，seg3を指定する場合

-g "seg1△seg2△seg3"

〈一括指定の例〉segで始まるすべてのサービスグループを指定する場合

-g "seg*"

●-d　削除種別

削除種別を指定します。

　disk：ディスクキューだけ削除します。

　memory：メモリキューだけ削除します。

　all：ディスクキューとメモリキューを両方とも削除します。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10350-I | mcftdlqsgコマンドが入力されました | 標準出力
KFCA10353-W | 入力形式が誤っています | 標準エラー出力
KFCA10354-E | メモリ不足です | 標準エラー出力
KFCA10355-W | 引数の指定が誤っています | 標準エラー出力
KFCA10356-E | プロセス間でタイムアウトが発生しました | 標準エラー出力
KFCA10357-E | MCF内でタイムアウトが発生しました | 標準エラー出力
KFCA10358-E | 内部関数のエラーが発生しました | 標準エラー出力
KFCA10359-W | mcftdlqsgコマンド入力元への応答に失敗しました | メッセージログファイル，または標準エラー出力
KFCA10371-I | mcftdlqsgコマンドを正常に受け付けました | 標準出力
KFCA10373-E | mcftdlqsgコマンドが異常終了しました | 標準エラー出力
KFCA10380-E | 相手プロセスの検索に失敗しました | 標準エラー出力
KFCA10383-E | 指定したサービスグループは登録されていません | 標準エラー出力
KFCA10522-I | ヘルプメッセージ | 標準出力
KFCA11077-W | 指定されたサービスグループは閉塞（または保留）されていません | 標準エラー出力
KFCA11097-W | SPP資源のため入力キューは削除できません | 標準エラー出力
KFCA16402-E | コマンド処理中にRPC障害が発生しました | 標準エラー出力

mcftdmpqu

名称

入出力キューの内容複写

形式

mcftdmpqu -k 出力単位種別 〔-u 出力単位名〕 -f ダンプファイル名 〔-a〕

機能

入力キュー，出力キューの内容をファイルに複写します。

複写対象はディスクメッセージです。

入力キューの内容を複写する場合は，あらかじめmcftdctsgコマンドで該当するサービスグループを閉塞しておいてください。mcftdmpquコマンドをmcftdlqsgコマンド（入力キューの削除）と組み合わせて使用する場合は，あらかじめmcfthldiqコマンドで該当するサービスグループの入力キュー処理を保留しておいてください。

出力キューの内容を複写する場合でmcftdmpquコマンドを単独で使用する場合は，あらかじめmcftdctleコマンドまたはdc_mcf_tdctle関数で該当する論理端末を閉塞しておいてください。mcftdmpquコマンドをmcftdlqleコマンドまたはdc_mcf_tdlqle関数（出力キューの削除）と組み合わせて使用する場合は，あらかじめmcfthldoqコマンドで該当する論理端末の出力キュー処理を保留しておいてください。

オプション

●-k　出力単位種別

ダンプ出力する出力単位の種別を指定します。

　all：入力キュー，出力キューのすべての内容をダンプ出力します。

　svg：サービスグループ単位に入力キューをダンプ出力します。

　le：論理端末名称単位に出力キューをダンプ出力します。

●-u　出力単位名

ダンプ出力の対象となるサービスグループ名，または論理端末名称を指定します。

-kオプションでsvgを指定した場合はサービスグループ名を，leを指定した場合は論理端末名称を指定します。

-kオプションでsvg，またはleを指定した場合，このオプションを必ず指定してください。

-kオプションでallを指定した場合，このオプションの指定は無視されます。

サービスグループ名，または論理端末名称は，一度に8個まで指定できます。複数のサービスグループ名，または論理端末名称を指定するときは，引用符(")で囲んで，名称を空白で区切ります。同一サービスグループ名，または同一論理端末名称は，重複して指定できません。

また，サービスグループ名，または論理端末名称は，＊を使って一括指定ができます。一括指定は一つだけ指定できます。一括指定と一括指定以外のサービスグループ名，または論理端末名称を混在して指定できません。一括指定の場合は，引用符（"）で囲みます。

＊：すべてのサービスグループ，またはすべての論理端末のダンプを出力します。

先行文字列＊：先行文字列で始まるすべてのサービスグループ，または論理端末のダンプを出力します。

〈複数指定の例〉　seg1，seg2，seg3を指定する場合

-g "seg1△seg2△seg3"

〈一括指定の例〉　segで始まるすべてのサービスグループを指定する場合

-u "seg*"

●-f　ダンプファイル名　　～〈1～35文字のパス名〉

出力するダンプファイルの名称を指定します。

ファイル名だけを指定した場合は，$DCDIR/spool下にファイルが作成されます。絶対パス名で指定した場合は，指定したディレクトリ下にファイルが作成されます。ただし，ディレクトリは作成されません。

Windowsの場合は，絶対パス名で指定できません。$DCDIR/spool下に作成されるファイル名だけを指定できます。

●-a

既存のファイルに追加書き込みする場合に，指定します。

このオプションの指定を省略すると，新規にファイルがオープンされて書き込まれます。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10103-E | 指定された論理端末が閉塞（または保留）されていません | 標準エラー出力
KFCA10350-I | mcftdmpquコマンドが入力されました | 標準出力
KFCA10353-W | 入力形式が誤っています | 標準エラー出力
KFCA10354-E | メモリ不足です | 標準エラー出力
KFCA10355-W | 引数の指定が誤っています | 標準エラー出力
KFCA10356-E | プロセス間でタイムアウトが発生しました | 標準エラー出力
KFCA10357-E | MCF内でタイムアウトが発生しました | 標準エラー出力
KFCA10358-E | 内部関数のエラーが発生しました | 標準エラー出力
KFCA10359-W | mcftdmpquコマンド入力元への応答に失敗しました | メッセージログファイル
KFCA10372-E | mcftdmpquコマンドが異常終了しました | 標準エラー出力
KFCA10374-I | 未送信メッセージをファイルにコピーしました | 標準出力
KFCA10375-I | ダンプファイル名 | 標準出力
KFCA10380-E | 相手プロセスの検索に失敗しました | 標準エラー出力
KFCA10383-E | サービスグループ名は登録されていません | 標準エラー出力
KFCA10519-I | ヘルプメッセージ | 標準出力
KFCA11096-W | SPP資源のため入力キューはダンプ取得できません | 標準エラー出力
KFCA11811-E | ファイル出力で障害が発生しました | 標準エラー出力
KFCA11812-E | 入出力キューの読み込みで障害を検知しました | 標準エラー出力
KFCA16402-E | コマンド処理中にRPC障害が発生しました | 標準エラー出力

mcftedalt

名称

代行送信の終了

形式

mcftedalt 〔-s MCF通信プロセス識別子〕 -l 論理端末名称

機能

代行送信を終了します。

mcftedaltコマンドは，TP1/NET/XMAP3プロトコル，またはTP1/NET/HNA-560/20プロトコル使用時に使用できます。

オプション

●-s　MCF通信プロセス識別子　　～〈数字（0～9），a～f〉((01～ef))

処理対象の論理端末を制御するMCF通信サービスのMCF通信プロセス識別子を指定します。MCF通信プロセス識別子は複数指定できません。

このオプションの指定を省略すると，すべてのMCFに対して，mcftedaltコマンドを実行します。したがって，MCF通信サービスを検索するオーバヘッドが，運用コマンドの処理に加わります。

MCF通信サービスが多い構成や運用コマンドを多数入力する運用を行う場合は，-sオプションで，MCF通信プロセス識別子を指定する運用設計を行ってください。

●-l　論理端末名称　　～〈1～8文字の識別子〉

代行を終了する代行送信元の論理端末の名称を指定します。mcftstaltコマンドの-fオプションで指定した論理端末名称を指定してください。

複数の論理端末名称は指定できません。また，一括指定もできません。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10117-I | メッセージの代行送信を終了します | 標準出力
KFCA10350-I | mcftedaltコマンドが入力されました | 標準出力
KFCA10351-E | MCF開始処理中です | 標準エラー出力
KFCA10352-E | MCF終了処理中です | 標準エラー出力
KFCA10353-W | 入力形式が誤っています | 標準エラー出力
KFCA10354-E | メモリ不足です | 標準エラー出力
KFCA10355-W | 引数の指定が誤っています | 標準エラー出力
KFCA10356-E | プロセス間でタイムアウトが発生しました | 標準エラー出力
KFCA10357-E | MCF内でタイムアウトが発生しました | 標準エラー出力
KFCA10358-E | 内部関数のエラーが発生しました | 標準エラー出力
KFCA10359-W | mcftedaltコマンド入力元への応答に失敗しました | メッセージログファイル
KFCA10371-I | mcftedaltコマンドを正常に受け付けました | 標準出力
KFCA10373-E | mcftedaltコマンドが異常終了しました | 標準エラー出力
KFCA10380-E | 相手プロセスの検索に失敗しました | 標準エラー出力
KFCA10382-E | 指定した論理端末は登録されていません | 標準エラー出力
KFCA10542-I | ヘルプメッセージ | 標準出力
KFCA16402-E | コマンド処理中にRPC障害が発生しました | 標準エラー出力

上記のほかに，使用するプロトコルに出力されるメッセージが出力されます。詳細については各プロトコルのマニュアルを参照してください。

mcftendct

名称

論理端末に対する継続問い合わせ応答処理の強制終了

形式

mcftendct 〔-f〕 〔-s MCF通信プロセス識別子〕 -l 論理端末名称

機能

指定された論理端末に対する継続問い合わせ応答処理を強制的に終了します。

mcftendctコマンドは，TP1/NET/XMAP3プロトコル，TP1/NET/HNA-560/20プロトコル，またはTP1/NET/HNA-560/20 DTSプロトコル使用時に使用できます。

オプション

●-f

継続問い合わせ応答処理を即時強制終了する場合に指定します。このオプションを指定すると，直ちに継続問い合わせ用一時記憶領域を解放し，該当する論理端末からの問い合わせを処理しているMHP（エラーイベントを含む）は異常終了します。このときエラーイベントは起動しません。

-fオプションを指定したmcftendctコマンドの実行後にMHPが次に示す処理をしたとき，MHPが異常終了します。

TP1/Message Control以外のリソースマネジャにもアクセスするMHPのサービス終了時

継続問い合わせ用一時記憶領域アクセス時（dc_mcf_tempget関数，dc_mcf_tempput関数発行時）

ロールバック要求時（dc_mcf_rollback関数発行時（action：DCMCFRTRY，またはDCMCFNRTNの場合））

このオプションの指定を省略すると，MHPが該当する論理端末からの問い合わせを処理中の場合，エラーメッセージが出力されます。

●-s　MCF通信プロセス識別子　　～〈数字（0～9），a～f〉((01～ef))

処理対象の論理端末を制御するMCF通信サービスのMCF通信プロセス識別子を指定します。MCF通信プロセス識別子は複数指定できません。

このオプションの指定を省略すると，すべてのMCFに対して，mcftendctコマンドを実行します。したがって，MCF通信サービスを検索するオーバヘッドが，運用コマンドの処理に加わります。

MCF通信サービスが多い構成や運用コマンドを多数入力する運用を行う場合は，-sオプションで，MCF通信プロセス識別子を指定する運用設計を行ってください。

●-l　論理端末名称　　～〈1～8文字の識別子〉

継続問い合わせ応答処理を終了する論理端末の名称を指定します。

論理端末名称は，1回につき8個まで指定できます。多数入力する運用を行う場合は，次に示す複数指定または一括指定を使用して，一つの運用コマンドで行う並列処理数を増やし，運用コマンド入力数を減らすように運用設計を行ってください。

複数の論理端末名称を指定するときは，引用符（"）で囲んで，論理端末名称と論理端末名称との間を空白で区切ります。同一論理端末名称は，重複して指定できません。

また，論理端末名称は，＊を使って一括指定ができます。一括指定は一つだけ指定できます。一括指定と一括指定以外の論理端末名称を混在して指定できません。一括指定の場合も，引用符（"）で囲みます。

＊：すべての論理端末に対する継続問い合わせ応答処理を強制的に終了します。

先行文字列＊：先行文字列で始まるすべての論理端末に対する継続問い合わせ応答処理を強制的に終了します。

〈複数指定の例〉　len1，len2，len3を指定する場合

-l "len1△len2△len3"

〈一括指定の例〉　lenで始まるすべての論理端末を指定する場合

-l "len*"

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10350-I | mcftendctコマンドが入力されました | 標準出力
KFCA10351-E | MCF開始処理中です | 標準エラー出力
KFCA10352-E | MCF終了処理中です | 標準エラー出力
KFCA10353-W | 入力形式が誤っています | 標準エラー出力
KFCA10354-E | メモリ不足です | 標準エラー出力
KFCA10355-W | 引数の指定に誤りがあります | 標準エラー出力
KFCA10356-E | プロセス間でタイムアウトが発生しました | 標準エラー出力
KFCA10357-E | MCF内でタイムアウトが発生しました | 標準エラー出力
KFCA10358-E | 内部関数のエラーが発生しました | 標準エラー出力
KFCA10359-W | mcftendctコマンド入力元への応答に失敗しました | メッセージログファイル，または標準エラー出力
KFCA10371-I | mcftendctコマンドを正常に受け付けました | 標準出力
KFCA10373-E | mcftendctコマンドが異常終了しました | 標準エラー出力
KFCA10380-E | 相手プロセスの検索に失敗しました | 標準エラー出力
KFCA10382-E | 指定した論理端末は登録されていません | 標準エラー出力
KFCA10391-E | mcftendctコマンドはサポートされていません | 標準エラー出力
KFCA10521-I | ヘルプメッセージ | 標準出力
KFCA16402-E | コマンド処理中にRPC障害が発生しました | 標準エラー出力

上記のほかに，使用するプロトコルによってメッセージが出力されます。詳細については各プロトコルのマニュアルを参照してください。

mcfthldiq

名称

サービスグループの入力キュー処理の保留

形式

mcfthldiq -g サービスグループ名 〔-k 保留種別〕〔-r〕

機能

指定したサービスグループに対応する入力キューの処理を保留します。

このコマンドを使用すると，OpenTP1システムに「注意事項」に示す影響を与えます。このコマンドを実行後，目的の処理が終了したら，必ずmcftrlsiqコマンドで保留解除を行ってください。

オプション

●-g　サービスグループ名　　～〈1～31文字の識別子〉

入力キューの処理を保留するサービスグループの名称を指定します。

サービスグループ名は，1回につき8個まで指定できます。多数入力する運用を行う場合は，次に示す複数指定または一括指定を使用して，一つの運用コマンドで行う並列処理数を増やし，運用コマンド入力数を減らすように運用設計を行ってください。

複数のサービスグループ名を指定するときは，引用符（"）で囲んで，サービスグループ名とサービスグループ名との間を空白で区切ります。同一サービスグループ名は，重複して指定できません。

サービスグループ名は，＊を使って一括指定ができます。一括指定は一つだけ指定できます。一括指定と一括指定以外のサービスグループ名を混在して指定できません。一括指定の場合は，引用符（"）で囲みます。

＊：すべてのサービスグループに対応する入力キューの処理を保留します。

先行文字列＊：先行文字列で始まるすべてのサービスグループに対応する入力キューの処理を保留します。

〈複数指定の例〉seg1，seg2，seg3を指定する場合

-g "seg1△seg2△seg3"

〈一括指定の例〉segで始まるすべてのサービスグループを指定する場合

-g "seg*"

●-k　保留種別　　～《insc》

入力キューの保留種別を指定します。

　insc：入力キューの入力とスケジュールを保留します。

　in：入力キューの入力だけ保留します。

　sc：入力キューのスケジュールだけ保留します。

●-r

全面回復時に，入力キューの保留状態を引き継がない場合に指定します。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10350-I | mcfthldiqコマンドが入力されました | 標準出力
KFCA10353-W | 入力形式が誤っています | 標準エラー出力
KFCA10354-E | メモリ不足です | 標準エラー出力
KFCA10355-W | 引数の指定が誤っています | 標準エラー出力
KFCA10356-E | プロセス間でタイムアウトが発生しました | 標準エラー出力
KFCA10357-E | MCF内でタイムアウトが発生しました | 標準エラー出力
KFCA10358-E | 内部関数のエラーが発生しました | 標準エラー出力
KFCA10359-W | mcfthldiqコマンド入力元への応答に失敗しました | メッセージログファイル，または標準エラー出力
KFCA10371-I | mcfthldiqコマンドを正常に受け付けました | 標準出力
KFCA10373-E | mcfthldiqコマンドが異常終了しました | 標準エラー出力
KFCA10380-E | 相手プロセスの検索に失敗しました | 標準エラー出力
KFCA10383-E | 指定したサービスグループは登録されていません | 標準エラー出力
KFCA10523-I | ヘルプメッセージ | 標準出力
KFCA11072-W | 該当するサービスグループはすでに保留されています | 標準エラー出力
KFCA11088-W | コマンド処理は正常に行われましたが状態引き継ぎ登録処理に失敗しました | 標準エラー出力
KFCA11089-W | コマンド処理は正常に行われましたが，状態引き継ぎ個数が，定義で指定された上限値を超えているため，状態引き継ぎ登録ができませんでした | 標準エラー出力
KFCA11800-W | SPP資源のため入力キューは保留，または保留解除できません | 標準エラー出力
KFCA16402-E | コマンド処理中にRPC障害が発生しました | 標準エラー出力

注意事項

MCFアプリケーション起動サービスを使って起動する任意のサービスグループの入力キューの入力を保留した場合，該当するMCFアプリケーション起動サービスは，すべてのサービスグループの起動を保留します。

MCF通信サービスが起動する任意のサービスグループの入力キューの入力を保留した場合，その入力元論理端末への送信メッセージも，保留解除されるまで，OTQに滞留します。

MCF通信サービスが起動する任意のサービスグループの入力キューの入力を保留した場合，該当するMCF通信サービスの処理性能が低下することがあります。

保留中のサービスグループが一つでもある場合に，正常終了，計画停止A，または計画停止BでOpenTP1を終了すると，OpenTP1は異常終了します。正常終了，計画停止A，または計画停止BでOpenTP1を終了するときは，すべてのサービスグループの保留を解除したあとにdcstopコマンドを実行してください。

入力キューへの入力が保留中であるサービスグループに対して，メッセージ入力があった場合，その入力元論理端末とその論理端末の属するコネクションに対する運用コマンドがタイムアウトになることがあります。タイムアウトが発生しても，運用コマンドは受け付けられています。サービスグループの保留を解除したあとに運用コマンドは実行されます。

mcfthldoq

名称

論理端末の出力キュー処理の保留

形式

mcfthldoq〔-s MCF通信プロセス識別子〕 -l 論理端末名称 〔-k 保留種別〕

機能

指定した論理端末に対応する出力キューの処理を保留します。

このコマンドを使用すると，OpenTP1システムに「注意事項」に示す影響を与えます。このコマンドを実行後，目的の処理が終了したら，必ずmcftrlsoqコマンドで保留解除を行ってください。

オプション

●-s　MCF通信プロセス識別子

処理対象の論理端末を制御するMCF通信サービスのMCF通信プロセス識別子を指定します。MCF通信プロセス識別子は複数指定できません。

このオプションの指定を省略すると，すべてのMCFに対して，mcfthldoqコマンドを実行します。したがって，MCF通信サービスを検索するオーバヘッドが，運用コマンドの処理に加わります。

MCF通信サービスが多い構成や運用コマンドを多数入力する運用を行う場合は，-sオプションで，MCF通信プロセス識別子を指定する運用設計を行ってください。

●-l　論理端末名称　　～〈1～8文字の識別子〉

出力キューの処理を保留する論理端末の名称を指定します。

論理端末名称は，1回につき8個まで指定できます。多数入力する運用を行う場合は，次に示す複数指定または一括指定を使用して，一つの運用コマンドで行う並列処理数を増やし，運用コマンド入力数を減らすように運用設計を行ってください。

複数の論理端末名称を指定するときは，引用符（"）で囲んで，論理端末名称と論理端末名称との間を空白で区切ります。同一論理端末名称は，重複して指定できません。

論理端末名称は，＊を使って一括指定ができます。一括指定は一つだけ指定できます。一括指定と一括指定以外の論理端末名称を混在して指定できません。一括指定の場合も，引用符（"）で囲みます。

＊：すべての論理端末に対応する出力キューの処理を保留します。

先行文字列＊：先行文字列で始まるすべての論理端末に対応する出力キューの処理を保留します。

〈複数指定の例〉len1，len2，len3を指定する場合

-l "len1△len2△len3"

〈一括指定の例〉lenで始まるすべての論理端末を指定する場合

-l "len*"

●-k　保留種別　　～《insc》

保留種別を指定します。

　insc：出力キューの入力とスケジュールを保留します。

　in：出力キューの入力だけ保留します。

　sc：出力キューのスケジュールだけ保留します。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10104-W | 該当する論理端末はすでに保留されています | 標準エラー出力
KFCA10122-W | コマンド処理は正常に行われましたが状態引き継ぎ登録処理に失敗しました | 標準エラー出力
KFCA10123-W | コマンド処理は正常に行われましたが，状態引き継ぎ個数が，定義で指定された上限値を超えているため，状態引き継ぎ登録ができませんでした | 標準エラー出力
KFCA10350-I | mcfthldoqコマンドが入力されました | 標準出力
KFCA10351-E | MCF開始処理中です | 標準エラー出力
KFCA10352-E | MCF終了処理中です | 標準エラー出力
KFCA10353-W | 入力形式が誤っています | 標準エラー出力
KFCA10354-E | メモリ不足です | 標準エラー出力
KFCA10355-W | 引数の指定が誤っています | 標準エラー出力
KFCA10356-E | プロセス間でタイムアウトが発生しました | 標準エラー出力
KFCA10357-E | MCF内でタイムアウトが発生しました | 標準エラー出力
KFCA10358-E | 内部関数のエラーが発生しました | 標準エラー出力
KFCA10359-W | mcfthldoqコマンド入力元への応答に失敗しました | メッセージログファイル，または標準エラー出力
KFCA10371-I | mcfthldoqコマンドを正常に受け付けました | 標準出力
KFCA10373-E | mcfthldoqコマンドが異常終了しました | 標準エラー出力
KFCA10380-E | 相手プロセスの検索に失敗しました | 標準エラー出力
KFCA10382-E | 指定した論理端末は登録されていません | 標準エラー出力
KFCA10391-E | mcfthldoqコマンドはサポートされていません | 標準エラー出力
KFCA10525-I | ヘルプメッセージ | 標準出力
KFCA16402-E | コマンド処理中にRPC障害が発生しました | 標準エラー出力

注意事項

任意の論理端末の出力キューの入力を保留した場合，該当する論理端末に対してメッセージ送信を行ったUAPは，保留解除されるまで停止します。

複数の論理端末にメッセージ送信を行うUAPを使用する場合，その一つの論理端末の出力キューの入力を保留すると，ほかの論理端末へのメッセージ送信も保留解除されるまで停止することがあります。

保留中の論理端末が一つでもある場合に，正常終了，計画停止A，または計画停止BでOpenTP1を終了すると，OpenTP1は異常終了します。正常終了，計画停止A，または計画停止BでOpenTP1を終了するときは，すべての論理端末の保留を解除したあとにdcstopコマンドを実行してください。

mcftlsbuf

名称

バッファグループの使用状況表示

形式

mcftlsbuf -s MCF通信プロセス識別子 -b バッファグループ番号〔-m〕〔-r〕

機能

バッファグループの使用状況を標準出力に出力します。

オプション

●-s　MCF通信プロセス識別子　　～〈数字（0～9），a～f〉((01～ef))

MCF通信プロセス識別子を指定します。

複数のMCF通信プロセス識別子は指定できません。

●-b　バッファグループ番号　　～〈符号なし整数〉((1～512))

使用状況を表示するバッファグループの番号を指定します。

複数のバッファグループ番号は指定できません。

allを指定すると，該当するMCF通信プロセスに対応するすべてのバッファグループの使用状況が表示されます。

●-m

次に示す時点から現在までの，最大バッファ使用数（使用中バッファ数と使用中拡張バッファ数の合計の最大値）を表示します。

正常開始

再開始

部分開始

mcftlsbufコマンドに-rオプションを指定して実行

このオプションで表示される最大バッファ使用数と，バッファグループ定義（mcftbuf）で指定したバッファ数（-gオプションのcountオペランドで指定）を比較することで，定義値の妥当性を検証できます。定義値の妥当性の検証については，以降の表示例を参照してください。

●-r

コマンド実行後，表示したバッファグループの最大バッファ使用数をリセットします。

出力形式

mmm ggg NNN XXX YYY ZZZ [MMM]

mmm：MCF識別子

ggg：バッファグループ番号

NNN：バッファ数

XXX：使用中バッファ数

YYY：拡張バッファ数

ZZZ：使用中拡張バッファ数

MMM：最大バッファ使用数（-mオプション指定時だけ表示）

表示例

（凡例）

a：バッファグループ番号

b：バッファ数

c：最大バッファ使用数

この例では，バッファグループ2，バッファグループ3は最大バッファ使用数の値がバッファ数以上になっています。これは，バッファグループ定義（mcftbuf）で指定したバッファ数が，一時的にすべて使用されたことを示しています。この場合，バッファグループ定義（mcftbuf）のバッファ数の指定を見直すことをお勧めします。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10350-I | mcftlsbufコマンドが入力されました | 標準出力
KFCA10351-E | MCF開始処理中です | 標準エラー出力
KFCA10352-E | MCF終了処理中です | 標準エラー出力
KFCA10353-W | 入力形式が誤っています | 標準エラー出力
KFCA10354-E | メモリ不足です | 標準エラー出力
KFCA10355-W | 引数の指定が誤っています | 標準エラー出力
KFCA10356-E | プロセス間でタイムアウトが発生しました | 標準エラー出力
KFCA10357-E | MCF内でタイムアウトが発生しました | 標準エラー出力
KFCA10358-E | 内部関数のエラーが発生しました | 標準エラー出力
KFCA10359-W | mcftlsbufコマンド入力元への応答に失敗しました | メッセージログファイル
KFCA10360-I | 状態表示を開始します | 標準出力
KFCA10366-I | 上記の出力形式を参照してください | 標準出力
KFCA10369-I | 状態表示を終了します | 標準出力
KFCA10372-E | mcftlsbufコマンドが異常終了しました | 標準エラー出力
KFCA10380-E | 相手プロセスの検索に失敗しました | 標準エラー出力
KFCA10385-E | 指定したバッファグループ番号は登録されていません | 標準エラー出力
KFCA10509-I | ヘルプメッセージ | 標準出力
KFCA16402-E | コマンド処理中にRPC障害が発生しました | 標準エラー出力

mcftlscn

名称

コネクションの状態表示

形式

mcftlscn 〔-s MCF通信プロセス識別子〕
        ｛-c コネクションID｜-g コネクショングループ名｝〔-d〕

機能

コネクションの状態を標準出力に出力します。

オプション

●-s　MCF通信プロセス識別子　　～〈数字（0～9），a～f〉((01～ef))

処理対象のコネクションを制御するMCF通信サービスのMCF通信プロセス識別子を指定します。MCF通信プロセス識別子は複数指定できません。

このオプションの指定を省略すると，すべてのMCFに対して，mcftlscnコマンドを実行します。したがって，MCF通信サービスを検索するオーバヘッドが，運用コマンドの処理に加わります。

MCF通信サービスが多い構成や運用コマンドを多数入力する運用を行う場合は，-sオプションで，MCF通信プロセス識別子を指定する運用設計を行ってください。

●-c　コネクションID　　～〈1～8文字の識別子〉

状態を表示するコネクションのコネクションIDを指定します。

コネクションIDは，1回につき8個まで指定できます。多数入力する運用を行う場合は，次に示す複数指定または一括指定を使用して，一つの運用コマンドで行う並列処理数を増やし，運用コマンド入力数を減らすように運用設計を行ってください。

複数のコネクションIDを指定するときは，引用符（"）で囲んで，コネクションIDとコネクションIDとの間を空白で区切ります。同一コネクションIDは，重複して指定できません。

また，コネクションIDは，＊を使って一括指定ができます。一括指定は一つだけ指定できます。一括指定と一括指定以外のコネクションIDを混在して指定できません。一括指定の場合も，引用符（"）で囲みます。

＊：すべてのコネクションの状態を表示します。

先行文字列＊：先行文字列で始まるすべてのコネクションの状態を表示します。

〈複数指定の例〉cnn1，cnn2，cnn3を指定する場合

-c "cnn1△cnn2△cnn3"

〈一括指定の例〉cnnで始まるすべてのコネクションを指定する場合

-c "cnn*"

●-g　コネクショングループ名　　～〈1～8文字の識別子〉

状態を表示するコネクショングループの名称を指定します。

コネクショングループ名は，一度に8個まで指定できます。多数入力する運用を行う場合は，次に示す複数指定または一括指定を使用して，一つの運用コマンドで行う並列処理数を増やし，運用コマンド入力数を減らすように運用設計を行ってください。

複数のコネクショングループ名を指定するときは，引用符（"）で囲んで，コネクショングループ名とコネクショングループ名との間を空白で区切ります。同一コネクショングループ名は，重複して指定できません。

また，コネクショングループ名は，＊を使って一括指定ができます。一括指定は一つだけ指定できます。一括指定と一括指定以外のコネクショングループ名を混在して指定できません。一括指定の場合も，引用符（"）で囲みます。

＊：すべてのコネクショングループの状態を表示します。

先行文字列＊：先行文字列で始まるすべてのコネクショングループの状態を表示します。

〈複数指定の例〉cng1，cng2，cng3を指定する場合

-g "cng1△cng2△cng3"

〈一括指定の例〉cngで始まるすべてのコネクショングループを指定する場合

-g "cng*"

なお，このオプションは，TP1/NET/OSI-TPプロトコル，TP1/NET/X25-EXプロトコル，およびTP1/NET/NCSBプロトコル使用時だけ指定できます。

●-d

コネクションの状態，そのコネクションに対応する論理端末などの付加情報を表示します。

このオプションの指定を省略すると，コネクションの状態だけが表示されます。

出力形式

1：-dオプション省略時はこの行だけ出力します。

2：コネクションに対応する論理端末などの付加情報を出力します。

mmm：MCF識別子

cccccccc：コネクションID

ppp：プロトコル種別

sssss：コネクション状態

ACT…確立

ACT/B…確立処理中

DCT…解放

DCT/B…解放処理中

dddd：詳細ステータス（保守情報）

bbbbbbbb：プロトコルによって表示内容が異なります。表示内容は各プロトコルのマニュアルを参照してください。

llllllll，ttt，uuuu：-dオプション指定時だけ表示します。また，プロトコルによって表示内容が異なります。表示内容は各プロトコルのマニュアルを参照してください。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10350-I | mcftlscnコマンドが入力されました | 標準出力
KFCA10351-E | MCF開始処理中です | 標準エラー出力
KFCA10352-E | MCF終了処理中です | 標準エラー出力
KFCA10353-W | 入力形式が誤っています | 標準エラー出力
KFCA10354-E | メモリ不足です | 標準エラー出力
KFCA10355-W | 引数の指定が誤っています | 標準エラー出力
KFCA10356-E | プロセス間でタイムアウトが発生しました | 標準エラー出力
KFCA10357-E | MCF内でタイムアウトが発生しました | 標準エラー出力
KFCA10358-E | 内部関数のエラーが発生しました | 標準エラー出力
KFCA10359-W | mcftlscnコマンド入力元への応答に失敗しました | メッセージログファイル
KFCA10360-I | 状態表示を開始します | 標準出力
KFCA10361-I | 標準情報 | 標準出力
KFCA10362-I | 詳細情報 | 標準出力
KFCA10369-I | 状態表示を終了します | 標準出力
KFCA10373-E | mcftlscnコマンドが異常終了しました | 標準エラー出力
KFCA10380-E | 相手プロセスの検索に失敗しました | 標準エラー出力
KFCA10381-E | 指定したコネクションは登録されていません | 標準エラー出力
KFCA10391-E | mcftlscnコマンドはサポートされていません | 標準エラー出力
KFCA10502-I | ヘルプメッセージ | 標準出力
KFCA16402-E | コマンド処理中にRPC障害が発生しました | 標準エラー出力
KFCA16424-E | 指定したコネクショングループは登録されていません | 標準エラー出力

上記のほかに，使用するプロトコルによってメッセージが出力されます。詳細については各プロトコルのマニュアルを参照してください。

mcftlscom

名称

MCF通信サービスの状態参照と開始待ち合わせ

形式

mcftlscom 〔｛-s MCF通信プロセス識別子｜-w〔-t 待機時間〕｝〕

機能

MCF通信サービスの状態を参照，またはMCF通信サービスの開始を待ち合わせます。

MCF通信サービスの状態参照
MCF通信サービスに使用するファイルの一部を入れ替える場合，MCF通信サービスの部分停止後に，このコマンドを実行し，MCF通信サービスの部分停止の完了を確認します。

MCF通信サービスの開始待ち合わせ
dcstartコマンド（Windowsの場合はntbstartコマンド）でOpenTP1を起動し，MCF通信サービスの開始を待って業務を実行させる場合，このコマンドを実行し，すべてのMCF通信サービスの開始を待ち合わせます。

オプション

●-s　MCF通信プロセス識別子　　～〈数字（0～9），a～f〉((01～ef))

状態を参照するMCF通信サービスのMCF通信プロセス識別子を指定します。MCF通信プロセス識別子は複数指定できません。

すべてのオプションを省略すると，すべてのMCF通信サービスの状態を出力します。

●-w

すべてのMCF通信サービスの開始を待ち合わせる場合に指定します。

●-t　待機時間　　～〈符号なし整数〉((0，10～3600))《0》（単位：秒）

すべてのMCF通信サービスの開始を待ち合わせる時間（待機時間）を指定します。0を指定した場合は，MCF通信サービスが開始するまで待ち合わせます。

指定した待機時間を経過した場合，コマンドのリターン値として，2が返されます。

出力形式

●-sオプションを指定した場合

KFCA16431-I bb cc...cc dd...dd ee...ee ff...ff gggg

bb：MCF通信プロセス識別子

cc...cc：MCF通信サーバ名

dd...dd：MCF通信サーバのプロセスID

ee...ee：プロトコル種別

ff...ff：MCF通信サービスの状態

OFFLINE…停止状態

STARTING…準備中

ONLINE…開始状態または終了準備中

PREENDING…終了準備中（部分停止時だけ出力されます）

ENDING…終了中

gggg：保守情報

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10350-I | mcftlscomコマンドが入力されました | 標準出力
KFCA10351-E | MCF開始処理中です | 標準エラー出力
KFCA10352-E | MCF終了処理中です | 標準エラー出力
KFCA10353-W | 入力形式が誤っています | 標準エラー出力
KFCA10354-E | メモリ不足です | 標準エラー出力
KFCA10355-W | 引数の指定が誤っています | 標準エラー出力
KFCA10356-E | プロセス間でタイムアウトが発生しました | 標準エラー出力
KFCA10357-E | MCF内でタイムアウトが発生しました | 標準エラー出力
KFCA10358-E | 内部関数のエラーが発生しました | 標準エラー出力
KFCA10359-W | mcftlscomコマンド入力元への応答に失敗しました | メッセージログファイル
KFCA10360-I | MCFの状態表示を開始します | 標準出力
KFCA10369-I | MCFの状態表示を終了します | 標準出力
KFCA10370-I | mcftlscomコマンドを正常に受け付けました | 標準出力
KFCA10373-E | mcftlscomコマンドが異常終了しました | 標準エラー出力
KFCA10380-E | 相手プロセスの検索に失敗しました | 標準エラー出力
KFCA10391-E | mcftlscomコマンドはサポートされていません | 標準エラー出力
KFCA10558-I | ヘルプメッセージ | 標準出力
KFCA16402-E | コマンド処理中にRPC障害が発生しました | 標準エラー出力
KFCA16431-I | 上記の出力形式を参照してください | 標準出力

注意事項

-wオプションを指定したmcftlscomコマンドを，複数のシェルまたはUAPから同時に実行しないでください。

-wオプションを指定したmcftlscomコマンドを実行し，かつMCF通信サービスの開始完了を待ち合わせている場合，次に示す運用コマンドも実行を待ち合わせます。
mcftactsg，mcftactsv，mcftdctsg，mcftdctsv，mcftdlqsg，mcftdmpqu，mcfthldiq，mcftrlsiq

mcftlsle

名称

論理端末の状態表示

形式

mcftlsle 〔-s MCF通信プロセス識別子〕〔-c コネクションID〕
          -l 論理端末名称 〔-q〕〔-m〕〔-r〕

機能

論理端末の状態を標準出力に出力します。

オプション

●-s　MCF通信プロセス識別子　　～〈数字（0～9），a～f〉((01～ef))

処理対象の論理端末を制御するMCF通信サービスのMCF通信プロセス識別子を指定します。MCF通信プロセス識別子は複数指定できません。

このオプションの指定を省略すると，すべてのMCFに対して，mcftlsleコマンドを実行します。したがって，MCF通信サービスを検索するオーバヘッドが，運用コマンドの処理に加わります。

MCF通信サービスが多い構成や運用コマンドを多数入力する運用を行う場合は，-sオプションで，MCF通信プロセス識別子を指定する運用設計を行ってください。

●-c　コネクションID　　～〈1～8文字の識別子〉

状態を表示したい論理端末に対応するコネクションのコネクションIDを指定します。

複数のコネクションIDは指定できません。また，一括指定もできません。

●-l　論理端末名称　　～〈1～8文字の識別子〉

状態を表示する論理端末の名称を指定します。

-cオプションを指定した場合，指定したコネクションIDに対応する論理端末名称を指定します。

論理端末名称は，1回につき8個まで指定できます。多数入力する運用を行う場合は，次に示す複数指定または一括指定を使用して，一つの運用コマンドで行う並列処理数を増やし，運用コマンド入力数を減らすように運用設計を行ってください。

複数の論理端末名称を指定するときは，引用符（"）で囲んで，論理端末名称と論理端末名称との間を空白で区切ります。同一論理端末名称は，重複して指定できません。

また，論理端末名称は，＊を使って一括指定ができます。一括指定は一つだけ指定できます。一括指定と一括指定以外の論理端末名称を混在して指定できません。一括指定の場合も，引用符（"）で囲んで指定します。

＊：すべての論理端末の状態を表示します。

先行文字列＊：先行文字列で始まるすべての論理端末の状態を表示します。

〈複数指定の例〉len1，len2，len3を指定する場合

-l "len1△len2△len3"

〈一括指定の例〉lenで始まるすべての論理端末を指定する場合

-l "len*"

●-q

指定した論理端末に対応する出力キューの保留状態を表示します。

このオプションの指定を省略すると，論理端末に対応する出力キューの保留状態は表示されません。

●-m

次の時点から，現在までの最大未送信メッセージ数（出力キューが待ち合わせたメッセージの最大数）を表示します。

正常開始

再開始

部分開始

mcftlsleコマンドに-rオプションを指定して実行

なお，このオプションで表示する最大未送信メッセージ数と，出力メッセージ最大格納数（論理端末定義（mcftalcle）の-mオプションのmmsgcntオペランド，およびdmsgcntオペランドで指定）を比較することで，定義値の妥当性を検証できます。定義値の妥当性の検証については，以降の表示例を参照してください。

●-r

コマンド実行後，-mオプションで表示した論理端末の最大未送信メッセージ数をリセットします。

出力形式

mmm llllllll sss [tttt]
   aaaaa bbbbbbbb
   SYNC xxxxxxxxxx yyyyyyyyyy zzzzzzzzzz [uuuuuuuuuu]
     IO      :          :          :          :
   PRIO      :          :          :          :
   NORM      :          :          :          :
   iii ooo

mmm：MCF識別子

llllllll：論理端末名称

sss：論理端末状態

ACT…閉塞解除状態

DCT…閉塞状態

tttt：論理端末のテストモード状態（TP1/Message Control/Tester使用時だけ表示）

TEST…テストモード

空白…非テストモード

aaaaa：代行種別（代行送信時だけ表示）

ALT_F…代行元

ALT_T…代行先

bbbbbbbb：論理端末名称（代行送信時だけ表示）
該当する論理端末が代行元論理端末の場合，それに対応する代行先論理端末名称を表示します。この場合，aaaaaにはALT_Tを表示します。

SYNC：同期型メッセージ※1

IO：非同期型問い合わせ応答メッセージ※2

PRIO：非同期型一方送信メッセージ（優先）

NORM：非同期型一方送信メッセージ（一般）

xxxxxxxxxx：未送信メッセージ数（unsigned shortの上限値まで表示可能）

yyyyyyyyyy：未送信メッセージの先頭の出力通番（intの上限値まで表示可能）

zzzzzzzzzz：未送信メッセージの最後の出力通番（intの上限値まで表示可能）

uuuuuuuuuu：最大未送信メッセージ数（-mオプション指定時だけ表示。unsigned shortの上限値まで表示可能）

iii：出力キューの入力の保留状態（-qオプション指定時だけ表示）

NOH…保留解除

HLD…保留

ooo：出力キューのスケジュールの保留状態（-qオプション指定時だけ表示）

NOH…保留解除

HLD…保留

注※1

未処理送信メッセージを破棄した場合（ERREVTAを起動するケース），メッセージの破棄が完了するまで，いったん，同期型メッセージの出力キューに格納するため，未送信メッセージ数が一時的に増加します。

注※2

次の場合，未送信メッセージ数が一時的に増加します。

応答型または継続問い合わせ応答型のアプリケーションを起動するメッセージを，運用コマンド（mcftdlqsg）で入力キューから削除した場合。

応答型または継続問い合わせ応答型のアプリケーションの動作（異常終了など）によって，本来，起動されるERREVT3が何らかの要因で起動できなかった場合。

表示例

（凡例）

a：未送信メッセージ数

b：最大未送信メッセージ数

この表示例を基に，次に示す条件を前提にして，定義値の妥当性について説明します。

システムで想定した最大未送信メッセージ数：10
PRIO，NORMの未送信メッセージ数として，それぞれ5を想定したときの合計値。

出力メッセージの割り当て先：メモリキューを使用（論理端末定義（mcftalcle）の-kオプションのquekindオペランドにmemoryを指定）

メモリ出力メッセージ最大格納数：20（論理端末定義（mcftalcle）の-mオプションのmmsgcntオペランドの指定値）
システムで想定した最大未送信メッセージ数10と余裕値10の合計値。

この例では，最大未送信メッセージ数（b）の合計が14となり，想定していた最大送信メッセージ数10を超えていることになります。

そのため，システムに何らかの問題が発生していないかどうかを確認することをお勧めします。システムに問題がない場合は，定義値の見直しをお勧めします。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10350-I | mcftlsleコマンドが入力されました | 標準出力
KFCA10351-E | MCF開始処理中です | 標準エラー出力
KFCA10352-E | MCF終了処理中です | 標準エラー出力
KFCA10353-W | 入力形式が誤っています | 標準エラー出力
KFCA10354-E | メモリ不足です | 標準エラー出力
KFCA10355-W | 引数の指定が誤っています | 標準エラー出力
KFCA10356-E | プロセス間でタイムアウトが発生しました | 標準エラー出力
KFCA10357-E | MCF内でタイムアウトが発生しました | 標準エラー出力
KFCA10358-E | 内部関数のエラーが発生しました | 標準エラー出力
KFCA10359-W | mcftlsleコマンド入力元への応答に失敗しました | メッセージログファイル
KFCA10360-I | 状態表示を開始します | 標準出力
KFCA10364-I | 上記の出力形式を参照してください | 標準出力
KFCA10365-I | 上記の出力形式を参照してください | 標準出力
KFCA10369-I | 状態表示を終了します | 標準出力
KFCA10373-E | mcftlsleコマンドが異常終了しました | 標準エラー出力
KFCA10380-E | 相手プロセスの検索に失敗しました | 標準エラー出力
KFCA10381-E | 指定したコネクションは登録されていません | 標準エラー出力
KFCA10382-E | 指定した論理端末は登録されていません | 標準エラー出力
KFCA10390-E | 指定したコネクションIDと論理端末名称の対応が正しくありません | 標準エラー出力
KFCA10391-E | mcftlsleコマンドはサポートされていません | 標準エラー出力
KFCA10395-E | 指定したコネクションには未接続の論理端末名称が指定されています | 標準エラー出力
KFCA10505-I | ヘルプメッセージ | 標準出力
KFCA16402-E | コマンド処理中にRPC障害が発生しました | 標準エラー出力

mcftlsln

名称

ネットワークの状態表示

形式

mcftlsln 〔-s MCF通信プロセス識別子〕〔-t〕

機能

ネットワークの状態を表示します。

オプション

●-s　MCF通信プロセス識別子　　～〈16進数字〉((01～ef))

MCF通信プロセス識別子を指定します。

MCF通信プロセス識別子は複数を指定できません。

このオプションの指定を省略すると，すべてのMCF通信プロセスに対して，mcftlslnコマンドを実行します。

●-t

相手システムとのメッセージ送受信に関するネットワークの状態を表示します。

このオプションの指定を省略すると，サーバ型コネクションの確立要求の受付状態を表示します。

出力形式

mmm uuuuuu

mmm：MCF識別子

uuuuuu：ネットワークの情報を表示します。
プロトコルによって表示内容が異なります。表示内容については，マニュアル「OpenTP1 プロトコル」の該当するプロトコル編を参照してください。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10350-I | mcftlslnコマンドが入力されました | 標準出力
KFCA10351-E | MCF開始処理中です | 標準エラー出力
KFCA10352-E | MCF終了処理中です | 標準エラー出力
KFCA10353-W | 入力形式が誤っています | 標準エラー出力
KFCA10354-E | メモリ不足です | 標準エラー出力
KFCA10355-W | 引数の指定が誤っています | 標準エラー出力
KFCA10356-E | プロセス間でタイムアウトが発生しました | 標準エラー出力
KFCA10357-E | MCF内でタイムアウトが発生しました | 標準エラー出力
KFCA10358-E | 内部関数のエラーが発生しました | 標準エラー出力
KFCA10359-W | mcftlslnコマンド入力元への応答に失敗しました | メッセージログファイル，または標準エラー出力
KFCA10360-I | 状態表示を開始します | 標準出力
KFCA10369-I | 状態表示を終了します | 標準出力
KFCA10372-E | mcftlslnコマンドが異常終了しました | 標準エラー出力
KFCA10380-E | 相手プロセスの検索に失敗しました | 標準エラー出力
KFCA10391-E | mcftlslnコマンドはサポートされていません | 標準エラー出力
KFCA10561-I | ヘルプメッセージ | 標準出力
KFCA16402-E | RPC障害が発生しました | 標準エラー出力
KFCA16432-I | ネットワーク情報の表示 | 標準出力

mcftlssg

名称

サービスグループの状態表示

形式

mcftlssg -g サービスグループ名 〔-q〕〔-m〕

機能

サービスグループの状態，および現在キューイングされている受信メッセージ数を表示します。

オプション

●-g　サービスグループ名　　～〈1～31文字の識別子〉

状態を表示するサービスグループ名を指定します。

サービスグループ名は，1回につき8個まで指定できます。多数入力する運用を行う場合は，次に示す複数指定または一括指定を使用して，一つの運用コマンドで行う並列処理数を増やし，運用コマンド入力数を減らすように運用設計を行ってください。

複数のサービスグループ名を指定するときは，引用符（"）で囲んで，サービスグループ名とサービスグループ名との間を空白で区切ります。同一サービスグループ名は，重複して指定できません。

また，サービスグループ名は，＊を使って一括指定ができます。一括指定は一つだけ指定できます。一括指定と一括指定以外のサービスグループ名を混在して指定できません。一括指定の場合も，引用符（"）で囲みます。

＊：すべてのサービスグループの状態を表示します。

先行文字列＊：先行文字列で始まるすべてのサービスグループの状態を表示します。

〈複数指定の例〉seg1，seg2，seg3を指定する場合

-g "seg1△seg2△seg3"

〈一括指定の例〉segで始まるすべてのサービスグループを指定する場合

-g "seg*"

●-q

指定したサービスグループに対応する入力キューの保留状態を表示します。

このオプションの指定を省略すると，サービスグループに対応する入力キューの保留状態は表示されません。

●-m

OpenTP1を正常開始または再開始してから現在までの，最大未処理受信メッセージ数を表示します。

出力形式

aaaaaaaaaaa bbb cc...cc ddd eee fff[(mmm)] [tttt]
aaaaaaaaaaa     iii ooo

aaaaaaaaaaa：メッセージID

bbb：MCF識別子

cc...cc ：サービスグループ名

ddd：サービスグループの状態（入力）

ACT…閉塞解除

DCT…閉塞

***…SPPのサービスグループの場合に表示

eee：サービスグループの状態（スケジュール）

ACT…閉塞解除

DCT…閉塞

***…SPPのサービスグループの場合に表示

fff：該当するサービスグループに対応する入力キューの未処理受信メッセージ数（intの上限値まで表示可能）

mmm：該当するサービスグループに対応する入力キューの最大未処理受信メッセージ数（-mオプション指定時だけ表示され，intの上限値まで表示可能）

tttt：サービスグループのテストモード状態（TP1/Message Control/Tester使用時だけ表示）

TEST…テストモード

空白…非テストモード

iii：入力キューの入力の保留状態（-qオプション指定時だけ表示）

NOH…保留解除

HLD…保留

***…SPPのサービスグループの場合に表示

ooo：入力キューのスケジュールの保留状態（-qオプション指定時だけ表示）

NOH…保留解除

HLD…保留

***…SPPのサービスグループの場合に表示

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10350-I | mcftlssgコマンドが入力されました | 標準出力
KFCA10353-W | 入力形式が誤っています | 標準エラー出力
KFCA10354-E | メモリ不足です | 標準エラー出力
KFCA10355-W | 引数の指定が誤っています | 標準エラー出力
KFCA10356-E | プロセス間でタイムアウトが発生しました | 標準エラー出力
KFCA10357-E | MCF内でタイムアウトが発生しました | 標準エラー出力
KFCA10358-E | 内部関数のエラーが発生しました | 標準エラー出力
KFCA10359-W | mcftlssgコマンド入力元への応答に失敗しました | メッセージログファイル，または標準エラー出力
KFCA10360-I | 状態表示を開始します | 標準出力
KFCA10367-I | 上記の出力形式を参照してください | 標準出力
KFCA10369-I | 状態表示を終了します | 標準出力
KFCA10373-E | mcftlssgコマンドが異常終了しました | 標準エラー出力
KFCA10380-E | 相手プロセスの検索に失敗しました | 標準エラー出力
KFCA10383-E | 指定したサービスグループは登録されていません | 標準エラー出力
KFCA10515-I | ヘルプメッセージ | 標準出力
KFCA16402-E | コマンド処理中にRPC障害が発生しました | 標準エラー出力

注意事項

入力キューにディスクキューを使用している場合で，かつOpenTP1再開始前に未処理受信メッセージがあるとき，その未処理受信メッセージ数がOpenTP1再開始時の最大未処理受信メッセージ数になります。

mcftlssv

名称

サービスの状態表示

形式

mcftlssv -v サービス名

機能

指定したサービスの入力，およびスケジュールの状態を表示します。

オプション

●-v　サービス名　　～〈1～31文字の識別子〉

状態を表示するサービスの名称を指定します。

サービス名は，1回につき8個まで指定できます。多数入力する運用を行う場合は，次に示す複数指定または一括指定を使用して，一つの運用コマンドで行う並列処理数を増やし，運用コマンド入力数を減らすように運用設計を行ってください。

複数のサービス名を指定するときは，引用符（"）で囲んで，サービス名とサービス名との間を空白で区切ります。同一サービス名は，重複して指定できません。

また，サービス名は，＊を使って一括指定ができます。一括指定は一つだけ指定できます。一括指定と一括指定以外のサービス名を混在して指定できません。一括指定の場合も，引用符（"）で囲みます。

＊：すべてのサービスの入力，およびスケジュールの状態を表示します。

先行文字列＊：先行文字列で始まるすべてのサービスの入力，およびスケジュールの状態を表示します。

〈複数指定の例〉ser1，ser2，ser3を指定する場合

-v "ser1△ser2△ser3"

〈一括指定の例〉serで始まるすべてのサービスを指定する場合

-v "ser*"

出力形式

aaaaaaaaaaa bbb cc...cc ddd eee

aaaaaaaaaaa：メッセージID

bbb：MCF識別子

cc...cc：サービス名

ddd：サービスの状態（入力）

ACT…閉塞解除状態

DCT…閉塞状態

***…SPPのサービスの場合に表示

eee：サービスの状態（スケジュール）

ACT…閉塞解除状態

DCT…閉塞状態

***…SPPのサービスの場合に表示

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10350-I | mcftlssvコマンドが入力されました | 標準出力
KFCA10353-W | 入力形式が誤っています | 標準エラー出力
KFCA10354-E | メモリ不足です | 標準エラー出力
KFCA10355-W | 引数の指定が誤っています | 標準エラー出力
KFCA10356-E | プロセス間でタイムアウトが発生しました | 標準エラー出力
KFCA10357-E | MCF内でタイムアウトが発生しました | 標準エラー出力
KFCA10358-E | 内部関数のエラーが発生しました | 標準エラー出力
KFCA10359-W | mcftlssvコマンド入力元への応答に失敗しました | メッセージログファイル，または標準エラー出力
KFCA10360-I | 状態表示を開始します | 標準出力
KFCA10368-I | 上記の出力形式を参照してください | 標準出力
KFCA10369-I | 状態表示を終了します | 標準出力
KFCA10373-E | mcftlssvコマンドが異常終了しました | 標準エラー出力
KFCA10380-E | 相手プロセスの検索に失敗しました | 標準エラー出力
KFCA10384-E | 指定したサービスは登録されていません | 標準エラー出力
KFCA10512-I | ヘルプメッセージ | 標準出力
KFCA16402-E | コマンド処理中にRPC障害が発生しました | 標準エラー出力

mcftlstrd

名称

メッセージ多重処理状況の表示

形式

mcftlstrd -s MCF通信プロセス識別子

機能

メッセージの多重処理状況を表示します。

MCF通信プロセスは，複数のコネクションから同時期に受信したメッセージおよびUAPから，複数のコネクションに対して同時期に送信要求されたメッセージを，並行して処理できます。並行して処理できる多重度の上限値は，最大処理多重度定義（mcfttred　-m）の指定値で変えることができます。ただし，システムの環境によっては，高トラフィック状態でも，定義で指定した値まで並行処理をしない場合があります。この場合，むだにローカルメモリを使用していることになり，かえって性能に悪影響を与えていることがあります（最大処理多重度定義の指定値を1増すごとに，MCF通信プロセスが使用するローカルメモリが約32キロバイト増加します）。

このコマンドを使用して，多重処理状況を調査し，最大処理多重度定義の指定値をチューニングしてください。例えば，高トラフィック状態でこのコマンドを数回実行した結果が，常にrunning＜現在の処理多重度定義値（処理多重度定義指定値＞コネクション数の場合，コネクション数），かつ，waiting＞0である場合は，running以上の多重処理は望めません。処理多重度指定値をrunning＋α（αは安全値。推奨値は3）に変更してください。実行結果がrunning＝現在の処理多重度定義値（処理多重度定義指定値＞コネクション数の場合，コネクション数），かつ，waiting＞0である場合は，処理多重度を上げることができる可能性があります。現状のスループット，ターンアラウンドタイムなどの性能要件の満足度およびメモリとの兼ね合いから，定義値の変更を検討してください。

なお，より統計的に処理状況を把握したい場合は，MCF稼働統計情報を取得してください。

オプション

●-s　MCF通信プロセス識別子

コマンドの対象となるMCF通信プロセス識別子を指定します。

このオプションは指定必須です。

MCF通信プロセス識別子は複数指定することはできません。また，*を使用してグループ名を指定することはできません。

出力形式

KFCA16430-I aaa running=bbbb waiting=cccc limit=dddd

aaa：MCF識別子

bbbb：処理中のメッセージを持つコネクション

cccc：処理待ち状態のメッセージを持つコネクション数（intの上限値まで表示可能）

dddd：最大処理多重度定義（mcfttred -m）の指定値
（最大処理多重度定義の指定値よりコネクション定義の数が小さい場合は，コネクション定義の数）

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10350-I | mcftlstrdコマンドが入力されました | 標準出力
KFCA10351-E | MCF開始処理中です | 標準エラー出力
KFCA10352-E | MCF終了処理中です | 標準エラー出力
KFCA10353-W | 入力形式が誤っています | 標準エラー出力
KFCA10354-E | メモリ不足です | 標準エラー出力
KFCA10355-W | 引数の指定が誤っています | 標準エラー出力
KFCA10356-E | プロセス間でタイムアウトが発生しました | 標準エラー出力
KFCA10357-E | MCF内でタイムアウトが発生しました | 標準エラー出力
KFCA10358-E | 内部関数のエラーが発生しました | 標準エラー出力
KFCA10372-E | mcftlstrdコマンドが異常終了しました | 標準エラー出力
KFCA10380-E | 相手プロセスの検索に失敗しました | 標準エラー出力
KFCA10555-I | ヘルプメッセージ | 標準出力
KFCA16402-E | コマンド処理中にRPC障害が発生しました | 標準エラー出力
KFCA16430-I | 上記の出力形式を参照してください | 標準出力

mcftlsutm

名称

ユーザタイマ監視の状態表示

形式

mcftlsutm 〔-s MCF通信プロセス識別子〕
         ｛ -a アプリケーション名 ｜ -l　論理端末名称 ｝

機能

ユーザタイマ監視の状態を表示します。

オプション

●-s　MCF通信プロセス識別子　　～〈数字（0～9），a～f〉((01～ef))

MCF通信プロセス識別子を指定します。MCF通信プロセス識別子は複数指定できません。

このオプションの指定を省略すると，すべてのMCFに対して，mcftlsutmコマンドを実行します。したがって，MCF通信プロセス識別子を検索するオーバヘッドが，運用コマンドの処理に加わります。

MCF通信プロセスが多い構成や運用コマンドを多数入力する運用を行う場合は，-sオプションで，MCF通信プロセス識別子を指定する運用設計を行ってください。

●-a　アプリケーション名　　～〈1～8文字の識別子〉

表示するアプリケーションの名称を指定します。

アプリケーション名は，1回につき8個まで指定できます。多数入力する運用を行う場合は，次に示す複数指定または一括指定を使用して，一つの運用コマンドで行う並列処理数を増やし，運用コマンド入力数を減らすように運用設計を行ってください。

複数のアプリケーション名を指定するときは，引用符（"）で囲んで，アプリケーション名とアプリケーション名との間を空白で区切ります。同一アプリケーション名は，重複して指定できません。

また，アプリケーション名は，＊を使って一括指定ができます。一括指定は一つだけ指定できます。一括指定と一括指定以外のアプリケーション名を混在して指定できません。一括指定の場合も，引用符（"）で囲みます。

＊：すべてのアプリケーションの，ユーザタイマ監視の状態を表示します。

先行文字列＊：先行文字列で始まるすべてのアプリケーションの，ユーザタイマ監視の状態を表示します。

〈複数指定の例〉apl1，apl2，apl3を指定する場合

-a "apl1△apl2△apl3"

〈一括指定の例〉aplで始まるすべてのアプリケーションを指定する場合

-a "apl*"

●-l　論理端末名称　　～〈1～8文字の識別子〉

表示する論理端末の名称を指定します。

論理端末名称は，1回につき8個まで指定できます。多数入力する運用を行う場合は，次に示す複数指定または一括指定を使用して，一つの運用コマンドで行う並列処理数を増やし，運用コマンド入力数を減らすように運用設計を行ってください。

複数の論理端末名称を指定するときは，引用符（"）で囲んで，論理端末名称と論理端末名称との間を空白で区切ります。同一論理端末名称は，重複して指定できません。

また，論理端末名称は，＊を使って一括指定ができます。一括指定は一つだけ指定できます。一括指定と一括指定以外の論理端末名称を混在して指定できません。一括指定の場合も，引用符（"）で囲んで指定します。

＊：すべての論理端末の，ユーザタイマ監視の状態を表示します。

先行文字列＊：先行文字列で始まるすべての論理端末の，ユーザタイマ監視の状態を表示します。

〈複数指定の例〉len1，len2，len3を指定する場合

-l "len1△len2△len3"

〈一括指定の例〉lenで始まるすべての論理端末を指定する場合

-l "len*"

出力形式

KFCA10360-I UTMの状態表示を開始します。
KFCA16433-I mmm aaaaa(bbbbb)　ccccc
KFCA16434-I mmm dd...dd ee...ee ff...ff gg...gg hh...hh
KFCA16434-I mmm dd...dd ee...ee ff...ff gg...gg hh...hh
KFCA10369-I UTMの状態表示を終了します。

UTM：ユーザタイマ監視

mmm：MCF識別子

aaaaa：ユーザタイマ登録数（5けた）

bbbbb：通信プロセスを正常開始または再開始してから現在までの最大ユーザタイマ登録数（5けた）

ccccc：同時に時間監視できるユーザタイマの最大値（5けた）

dd...dd：ユーザタイマ登録時に指定したアプリケーション名（8けた）

ee...ee：ユーザタイマ登録した時間（hh:mm:ss）

ff...ff：ユーザタイマ登録時に指定した論理端末名称（8けた）

gg...gg：ユーザタイマ登録時に指定したタイマ要求識別子（8けた（16進形式））

hh...hh：ユーザタイマ登録時に指定した起動時間（hh:mm:ss）
360000を指定した場合は100:00:00となります。

表示例

●通信プロセスにユーザタイマが登録されている場合

KFCA10360-I UTMの状態表示を開始します。
KFCA16433-I A01 30(100) 10000
KFCA16434-I A01 ap001    05:00:59 lec00101 00000001  00:00:50
KFCA16434-I A01 ap001    23:59:59 lec001 　00000002  99：00:00
KFCA16434-I A01 ap001001 00:01:20 lec00101 00003600 100:00:00
KFCA10369-I UTMの状態表示を終了します。

●通信プロセスにユーザタイマが登録されていない場合

KFCA10360-I UTMの状態表示を開始します。
KFCA16433-I A01 30(100) 10000
KFCA16435-I A01 MCF運用コマンドで指定されたユーザタイマは登録されていません。 コマンド名＝mcftlsutm
KFCA10369-I UTMの状態表示を終了します。

●通信プロセスにユーザタイマが定義されていない場合

KFCA10360-I UTMの状態表示を開始します。
KFCA16438-E A01 MCF運用コマンドは使用できません。 コマンド名＝mcftlsutm
KFCA10369-I UTMの状態表示を終了します。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10350-I | mcftlsutmコマンドが入力されました | 標準出力
KFCA10351-E | MCF開始処理中です。開始処理が終了するまで待って再度コマンドを入力してください | 標準エラー出力
KFCA10352-E | MCF終了処理中です | 標準エラー出力
KFCA10353-W | 入力形式が誤っています。正しい形式で再度コマンドを入力してください | 標準エラー出力
KFCA10354-E | メモリ不足です。再度コマンドを入力して，結果が同じ場合は，システムの環境を見直してください | 標準エラー出力
KFCA10355-W | 引数の指定が誤っています。MCF通信プロセス識別子，アプリケーション名，および論理端末名称の指定方法を見直して再度コマンドを入力してください | 標準エラー出力
KFCA10356-E | プロセス間でタイムアウトが発生しました。このメッセージ以前にログ出力されたメッセージを参照してください | 標準エラー出力
KFCA10357-E | MCF内でタイムアウトが発生しました。このメッセージ以前にログ出力されたメッセージを参照してください | 標準エラー出力
KFCA10358-E | 内部関数のエラーが発生しました | 標準エラー出力
KFCA10359-W | mcftlsutmコマンド入力元への応答に失敗しました | メッセージログファイル
KFCA10360-I | 状態表示を開始します | 標準出力
KFCA10369-I | 状態表示を終了します | 標準出力
KFCA10372-E | mcftlsutmコマンドが異常終了しました。このメッセージ以前にログ出力されたメッセージを参照してください | 標準エラー出力
KFCA10380-E | 相手プロセスの検索に失敗しました。MCF通信プロセス識別子を確認して再度コマンドを入力してください | 標準エラー出力
KFCA10562-I | ヘルプメッセージ | 標準出力
KFCA16402-E | コマンド処理中にRPC障害が発生しました。理由コードに応じた対処をしてください | 標準エラー出力
KFCA16433-I | 上記の出力形式を参照してください | 標準出力
KFCA16434-I | 上記の出力形式を参照してください | 標準出力
KFCA16435-I | mcftlsutmコマンドで指定したアプリケーション名または論理端末名のユーザタイマが登録されていないか，指定したアプリケーション名または論理端末名称が誤っています。ユーザタイマが登録されているか，指定したアプリケーション名または論理端末名称が誤っていないか確認してください | 標準出力
KFCA16438-E | mcftlsutmコマンドが使用できない環境です。MCF通信構成定義のタイマ定義で，ユーザタイマ監視機能を使用しない指定（mcfttim usertime=no）になっています。コマンドで指定した通信プロセスが正しいか確認してください。コマンドで指定した通信プロセスが正しい場合は，ユーザタイマ監視機能を使用する指定（mcfttim usertime=yes）にしてください | 標準エラー出力

mcftofln

名称

サーバ型コネクションの確立要求の受付終了

形式

mcftofln -s MCF通信プロセス識別子

機能

サーバ型コネクションの確立要求の受付を終了します。

オプション

●-s　MCF通信プロセス識別子　　～〈16進数字〉((01～ef))

MCF通信プロセス識別子を指定します。

MCF通信プロセス識別子は複数を指定できません。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10350-I | mcftoflnコマンドが入力されました | 標準出力
KFCA10351-E | MCF開始処理中です | 標準エラー出力
KFCA10352-E | MCF終了処理中です | 標準エラー出力
KFCA10353-W | 入力形式が誤っています | 標準エラー出力
KFCA10354-E | メモリ不足です | 標準エラー出力
KFCA10355-W | 引数の指定が誤っています | 標準エラー出力
KFCA10356-E | プロセス間でタイムアウトが発生しました | 標準エラー出力
KFCA10357-E | MCF内でタイムアウトが発生しました | 標準エラー出力
KFCA10358-E | 内部関数のエラーが発生しました | 標準エラー出力
KFCA10359-W | mcftoflnコマンド入力元への応答に失敗しました | メッセージログファイル
KFCA10370-I | mcftoflnコマンドを正常に受け付けました | 標準出力
KFCA10372-E | mcftoflnコマンドが異常終了しました | 標準エラー出力
KFCA10380-E | 相手プロセスの検索に失敗しました | 標準エラー出力
KFCA10391-E | mcftoflnコマンドはサポートされていません | 標準エラー出力
KFCA10560-I | ヘルプメッセージ | 標準出力
KFCA16402-E | RPC障害が発生しました | 標準エラー出力

上記のほかに，使用するプロトコルによってメッセージが出力されます。詳細については各プロトコルのマニュアルを参照してください。

mcftonln

名称

サーバ型コネクションの確立要求の受付開始

形式

mcftonln -s MCF通信プロセス識別子

機能

サーバ型コネクションの確立要求の受付を開始します。

オプション

●-s　MCF通信プロセス識別子　　～〈16進数字〉((01～ef))

MCF通信プロセス識別子を指定します。

MCF通信プロセス識別子は複数を指定できません。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10350-I | mcftonlnコマンドが入力されました | 標準出力
KFCA10351-E | MCF開始処理中です | 標準エラー出力
KFCA10352-E | MCF終了処理中です | 標準エラー出力
KFCA10353-W | 入力形式が誤っています | 標準エラー出力
KFCA10354-E | メモリ不足です | 標準エラー出力
KFCA10355-W | 引数の指定が誤っています | 標準エラー出力
KFCA10356-E | プロセス間でタイムアウトが発生しました | 標準エラー出力
KFCA10357-E | MCF内でタイムアウトが発生しました | 標準エラー出力
KFCA10358-E | 内部関数のエラーが発生しました | 標準エラー出力
KFCA10359-W | mcftonlnコマンド入力元への応答に失敗しました | メッセージログファイル
KFCA10370-I | mcftonlnコマンドを正常に受け付けました | 標準出力
KFCA10372-E | mcftonlnコマンドが異常終了しました | 標準エラー出力
KFCA10380-E | 相手プロセスの検索に失敗しました | 標準エラー出力
KFCA10391-E | mcftonlnコマンドはサポートされていません | 標準エラー出力
KFCA10559-I | ヘルプメッセージ | 標準出力
KFCA16402-E | RPC障害が発生しました | 標準エラー出力

上記のほかに，使用するプロトコルによってメッセージが出力されます。詳細については各プロトコルのマニュアルを参照してください。

mcftrlsiq

名称

サービスグループの入力キュー処理の保留解除

形式

mcftrlsiq -g サービスグループ名 〔-k 保留解除種別〕

機能

指定したサービスグループに対応する入力キューの処理の保留を解除します。

オプション

●-g　サービスグループ名　　～〈1～31文字の識別子〉

入力キューの処理の保留を解除するサービスグループの名称を指定します。

サービスグループ名は，1回につき8個まで指定できます。多数入力する運用を行う場合は，次に示す複数指定または一括指定を使用して，一つの運用コマンドで行う並列処理数を増やし，運用コマンド入力数を減らすように運用設計を行ってください。

複数のサービスグループ名を指定するときは，引用符（"）で囲んで，サービスグループ名とサービスグループ名との間を空白で区切ります。同一サービスグループ名は，重複して指定できません。

サービスグループ名は，＊を使って一括指定ができます。一括指定は一つだけ指定できます。一括指定と一括指定以外のサービスグループ名を混在して指定できません。一括指定の場合は，引用符（"）で囲みます。

＊：すべてのサービスグループに対応する入力キューの処理の保留を解除します。

先行文字列＊：先行文字列で始まるすべてのサービスグループに対応する入力キューの処理の保留を解除します。

〈複数指定の例〉seg1，seg2，seg3を指定する場合

-g "seg1△seg2△seg3"

〈一括指定の例〉segで始まるすべてのサービスグループを指定する場合

-g "seg*"

●-k　保留解除種別　　～《insc》

保留解除種別を指定します。

　insc：入力キューの入力とスケジュールの保留を解除します。

　in：入力キューの入力の保留だけ解除します。

　sc：入力キューのスケジュールの保留だけ解除します。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10350-I | mcftrlsiqコマンドが入力されました | 標準出力
KFCA10353-W | 入力形式が誤っています | 標準エラー出力
KFCA10354-E | メモリ不足です | 標準エラー出力
KFCA10355-W | 引数の指定が誤っています | 標準エラー出力
KFCA10356-E | プロセス間でタイムアウトが発生しました | 標準エラー出力
KFCA10357-E | MCF内でタイムアウトが発生しました | 標準エラー出力
KFCA10358-E | 内部関数のエラーが発生しました | 標準エラー出力
KFCA10359-W | mcftrlsiqコマンド入力元への応答に失敗しました | メッセージログファイル，または標準エラー出力
KFCA10371-I | mcftrlsiqコマンドを正常に受け付けました | 標準出力
KFCA10373-E | mcftrlsiqコマンドが異常終了しました | 標準エラー出力
KFCA10380-E | 相手プロセスの検索に失敗しました | 標準エラー出力
KFCA10383-E | 指定したサービスグループは登録されていません | 標準エラー出力
KFCA10524-I | ヘルプメッセージ | 標準出力
KFCA11073-W | 該当するサービスグループはすでに保留解除されています | 標準エラー出力
KFCA11074-W | MHPユーザサーバが終了処理中のためサービスグループを閉塞します | 標準エラー出力
KFCA11075-W | MHPユーザサーバが起動されていないためサービスグループを閉塞します | 標準エラー出力
KFCA11076-W | MHPユーザサーバが閉塞中のためサービスグループを閉塞します | 標準エラー出力
KFCA11088-W | コマンド処理は正常に行われましたが状態引き継ぎ登録処理に失敗しました | 標準エラー出力
KFCA11089-W | コマンド処理は正常に行われましたが，状態引き継ぎ個数が，定義で指定された上限値を超えているため，状態引き継ぎ登録ができませんでした | 標準エラー出力
KFCA11800-W | SPP資源のため入力キューは保留，または保留解除できません | 標準エラー出力
KFCA16402-E | コマンド処理中にRPC障害が発生しました | 標準エラー出力

注意事項

KFCA11074-Wメッセージ，KFCA11075-WメッセージまたはKFCA11076-Wメッセージが出力された場合，入力キューの処理の保留は解除されています。

mcftrlsoq

名称

論理端末の出力キュー処理の保留解除

形式

mcftrlsoq 〔-s MCF通信プロセス識別子〕 -l 論理端末名称
         〔-k 保留種別種別〕

機能

指定した論理端末に対応する出力キューの処理の保留を解除します。

オプション

●-s　MCF通信プロセス識別子

処理対象の論理端末を制御するMCF通信サービスのMCF通信プロセス識別子を指定します。MCF通信プロセス識別子は複数指定できません。

このオプションの指定を省略すると，すべてのMCFに対して，mcftrlsoqコマンドを実行します。したがって，MCF通信サービスを検索するオーバヘッドが，運用コマンドの処理に加わります。

MCF通信サービスが多い構成や運用コマンドを多数入力する運用を行う場合は，-sオプションで，MCF通信プロセス識別子を指定する運用設計を行ってください。

●-l　論理端末名称　　～〈1～8文字の識別子〉

出力キューの処理を保留する論理端末の名称を指定します。

論理端末名称は，1回につき8個まで指定できます。多数入力する運用を行う場合は，次に示す複数指定または一括指定を使用して，一つの運用コマンドで行う並列処理数を増やし，運用コマンド入力数を減らすように運用設計を行ってください。

複数の論理端末名称を指定するときは，引用符（"）で囲んで，論理端末名称と論理端末名称との間を空白で区切ります。同一論理端末名称は，重複して指定できません。

論理端末名称は，＊を使って一括指定ができます。一括指定は一つだけ指定できます。一括指定と一括指定以外の論理端末名称を混在して指定できません。一括指定の場合は，引用符（"）で囲みます。

＊：すべての論理端末に対応する出力キューの処理の保留を解除します。

先行文字列＊：先行文字列で始まるすべての論理端末に対応する出力キューの処理の保留を解除します。

〈複数指定の例〉len1，len2，len3を指定する場合

-l "len1△len2△len3"

〈一括指定の例〉lenで始まるすべての論理端末を指定する場合

-l "len*"

●-k　保留解除種別　　～《insc》

保留解除種別を指定します。

　insc：出力キューの入力とスケジュールの保留を解除します。

　in：出力キューの入力の保留だけ解除します。

　sc：出力キューのスケジュールの保留だけ解除します。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10105-W | 該当する論理端末はすでに保留解除されています | 標準エラー出力
KFCA10122-W | コマンド処理は正常に行われましたが状態引き継ぎ登録処理に失敗しました | 標準エラー出力
KFCA10123-W | コマンド処理は正常に行われましたが，状態引き継ぎ個数が，定義で指定された上限値を超えているため，状態引き継ぎ登録ができませんでした | 標準エラー出力
KFCA10350-I | mcftrlsoqコマンドが入力されました | 標準出力
KFCA10351-E | MCF開始処理中です | 標準エラー出力
KFCA10352-E | MCF終了処理中です | 標準エラー出力
KFCA10353-W | 入力形式が誤っています | 標準エラー出力
KFCA10354-E | メモリ不足です | 標準エラー出力
KFCA10355-W | 引数の指定が誤っています | 標準エラー出力
KFCA10356-E | プロセス間でタイムアウトが発生しました | 標準エラー出力
KFCA10357-E | MCF内でタイムアウトが発生しました | 標準エラー出力
KFCA10358-E | 内部関数のエラーが発生しました | 標準エラー出力
KFCA10359-W | mcftrlsoqコマンド入力元への応答に失敗しました | メッセージログファイル，または標準エラー出力
KFCA10371-I | mcftrlsoqコマンドを正常に受け付けました | 標準出力
KFCA10373-E | mcftrlsoqコマンドが異常終了しました | 標準エラー出力
KFCA10380-E | 相手プロセスの検索に失敗しました | 標準エラー出力
KFCA10382-E | 指定した論理端末は登録されていません | 標準エラー出力
KFCA10391-E | mcftrlsoqコマンドはサポートされていません | 標準エラー出力
KFCA10526-I | ヘルプメッセージ | 標準出力
KFCA16402-E | コマンド処理中にRPC障害が発生しました | 標準エラー出力

mcftspqle

名称

論理端末のメッセージキューの先頭スキップ

形式

mcftspqle -s MCF通信プロセス識別子 -l 論理端末名称
         -t メッセージ種別 〔-g〕

機能

指定した論理端末の指定したメッセージ種別の未送信メッセージのうち，先頭のメッセージを削除します。

mcftspqleコマンドを実行する前に，mcftdctleコマンドまたはdc_mcf_tdctle関数で論理端末を閉塞しておいてください。TP1/NET/HNA-560/20プロトコルを使用している場合は，さらにmcftdctssコマンドでセションを終了しておいてください。

オプション

●-s　MCF通信プロセス識別子　　～〈数字（0～9），a～f〉((01～ef))

MCF通信プロセス識別子を指定します。

複数のMCF通信プロセス識別子は指定できません。

●-l　論理端末名称　　～〈1～8文字の識別子〉

未送信メッセージのうち，先頭のメッセージを削除する論理端末の名称を指定します。

論理端末名称は，1回につき8個まで指定できます。多数入力する運用を行う場合は，次に示す複数指定または一括指定を使用して，一つの運用コマンドで行う並列処理数を増やし，運用コマンド入力数を減らすように運用設計を行ってください。

複数の論理端末名称を指定するときは，引用符（"）で囲んで，論理端末名称と論理端末名称との間を空白で区切ります。同一論理端末名称は，重複して指定できません。

また，論理端末名称は，＊を使って一括指定ができます。一括指定は一つだけ指定できます。一括指定と一括指定以外の論理端末名称を混在して指定できません。一括指定の場合も引用符(")で囲んで指定します。

＊：すべての論理端末の先頭メッセージを削除します。

先行文字列＊：先行文字列で始まるすべての論理端末の先頭メッセージを削除します。

〈複数指定の例〉len1，len2，len3を指定する場合

-l "len1△len2△len3"

〈一括指定の例〉lenで始まるすべての論理端末を指定する場合

-l "len*"

●-t　メッセージ種別

未送信メッセージのうち，先頭のメッセージを削除するメッセージの種別を指定します。

　IO：問い合わせ応答メッセージ

　PRIO：一方送信メッセージ（優先）

　NORM：一方送信メッセージ（一般）

●-g

未送信メッセージのうち，-tオプションで指定したメッセージ種別のメッセージグループを削除します。

メッセージグループがない場合，またはこのオプションの指定を省略した場合は，未送信メッセージのうち，-tオプションで指定したメッセージ種別の先頭のメッセージだけが削除されます。

なお，このオプションは，TP1/NET/XMAP3プロトコル使用時だけ指定できます。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10101-E | 指定した論理端末は閉塞されていません | 標準エラー出力
KFCA10102-E | 指定した種別のキューにメッセージがありません | 標準エラー出力
KFCA10350-I | mcftspqleコマンドが入力されました | 標準出力
KFCA10351-E | MCF開始処理中です | 標準エラー出力
KFCA10352-E | MCF終了処理中です | 標準エラー出力
KFCA10353-W | 入力形式が誤っています | 標準エラー出力
KFCA10354-E | メモリ不足です | 標準エラー出力
KFCA10355-W | 引数の指定が誤っています | 標準エラー出力
KFCA10356-E | プロセス間でタイムアウトが発生しました | 標準エラー出力
KFCA10357-E | MCF内でタイムアウトが発生しました | 標準エラー出力
KFCA10358-E | 内部関数のエラーが発生しました | 標準エラー出力
KFCA10359-W | mcftspqleコマンド入力元への応答に失敗しました | メッセージログファイル，または標準エラー出力
KFCA10371-I | mcftspqleコマンドを正常に受け付けました | 標準出力
KFCA10373-E | mcftspqleコマンドが異常終了しました | 標準エラー出力
KFCA10380-E | 相手プロセスの検索に失敗しました | 標準エラー出力
KFCA10382-E | 指定した論理端末は登録されていません | 標準エラー出力
KFCA10391-E | mcftspqleコマンドはサポートされていません | 標準エラー出力
KFCA10506-I | ヘルプメッセージ | 標準出力
KFCA16402-E | コマンド処理中にRPC障害が発生しました | 標準エラー出力

mcftstalt

名称

代行送信の開始

形式

mcftstalt 〔-s MCF通信プロセス識別子〕 -f 代行元論理端末名称
           -t 代行先論理端末名称

機能

送信先の論理端末に障害が発生してメッセージを送信できない場合に，ほかの論理端末が代行して送信先となります。

mcftstaltコマンドは，TP1/NET/XMAP3プロトコル，またはTP1/NET/HNA-560/20プロトコル使用時に使用できます。

オプション

●-s　MCF通信プロセス識別子　　～〈数字（0～9），a～f〉((01～ef))

処理対象の論理端末を制御するMCF通信サービスのMCF通信プロセス識別子を指定します。代行元と代行先の端末が同じプロセスに対応しているときだけ指定できます。MCF通信プロセス識別子は複数指定できません。

このオプションの指定を省略すると，すべてのMCFに対して，mcftstaltコマンドを実行します。したがって，MCF通信サービスを検索するオーバヘッドが，運用コマンドの処理に加わります。

MCF通信サービスが多い構成や運用コマンドを多数入力する運用を行う場合は，-sオプションで，MCF通信プロセス識別子を指定する運用設計を行ってください。

●-f　代行元論理端末名称　　～〈1～8文字の識別子〉

代行送信元の論理端末の名称を指定します。

指定する論理端末は，障害が発生して閉塞中の状態でなければなりません。

また，TP1/NET/HNA-560/20プロトコルを指定している場合は，指定する論理端末に対するセションが終了していなければなりません。

複数の代行元論理端末名称は指定できません。また，一括指定もできません。

●-t　代行先論理端末名称　　～〈1～8文字の識別子〉

代行送信先の論理端末の名称を指定します。すでに代行先として指定されている論理端末名称は指定できません。

閉塞状態の論理端末は指定できません。

また，TP1/NET/HNA-560/20プロトコルを指定している場合は，指定する論理端末に対するセションが，開始していなければなりません。

複数の代行先論理端末名称は指定できません。また，一括指定もできません。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10116-I | メッセージの代行送信を開始します | 標準出力
KFCA10350-I | mcftstaltコマンドが入力されました | 標準出力
KFCA10351-E | MCF開始処理中です | 標準エラー出力
KFCA10352-E | MCF終了処理中です | 標準エラー出力
KFCA10353-W | 入力形式が誤っています | 標準エラー出力
KFCA10354-E | メモリ不足です | 標準エラー出力
KFCA10355-W | 引数の指定が誤っています | 標準エラー出力
KFCA10356-E | プロセス間でタイムアウトが発生しました | 標準エラー出力
KFCA10357-E | MCF内でタイムアウトが発生しました | 標準エラー出力
KFCA10358-E | 内部関数のエラーが発生しました | 標準エラー出力
KFCA10359-W | mcftstaltコマンド入力元への応答に失敗しました | メッセージログファイル
KFCA10371-I | mcftstaltコマンドを正常に受け付けました | 標準出力
KFCA10373-E | mcftstaltコマンドが異常終了しました | 標準エラー出力
KFCA10380-E | 相手プロセスの検索に失敗しました | 標準エラー出力
KFCA10382-E | 指定した論理端末は登録されていません | 標準エラー出力
KFCA10541-I | ヘルプメッセージ | 標準出力
KFCA16402-E | コマンド処理中にRPC障害が発生しました | 標準エラー出力

上記のほかに，使用するプロトコルによってメッセージが出力されます。詳細については各プロトコルのマニュアルを参照してください。

注意事項

TP1/NET/HNA-560/20プロトコルを指定している場合，代行送信中に代行送信元の論理端末のセションが開始されると，現在送信中のロジカルメッセージの送信完了を待って，送信を終了します。

TP1/NET/HNA-560/20プロトコルを指定している場合，代行送信中に代行送信先の論理端末のセションが終了されると，その時点で代行送信を終了します。

mcftstart

名称

MCF通信サービスの部分開始

形式

mcftstart -s MCF通信プロセス識別子

機能

MCF通信サービスを部分開始します。

MCF通信サービスに使用するファイルの一部を入れ替える場合，入れ替え後にこのコマンドを実行し，入れ替え対象のMCF通信サービスを部分開始させます。

オプション

●-s　MCF通信プロセス識別子　　～〈数字（0～9），a～f〉((01～ef))

部分開始するMCF通信サービスのMCF通信プロセス識別子を指定します。MCF通信プロセス識別子は複数指定できません。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10350-I | mcftstartコマンドが入力されました | 標準出力
KFCA10351-E | MCF開始処理中です | 標準エラー出力
KFCA10352-E | MCF終了処理中です | 標準エラー出力
KFCA10353-W | 入力形式が誤っています | 標準エラー出力
KFCA10354-E | メモリ不足です | 標準エラー出力
KFCA10355-W | 引数の指定が誤っています | 標準エラー出力
KFCA10356-E | タイムアウトが発生しました | 標準エラー出力
KFCA10358-E | 内部関数のエラーが発生しました | 標準エラー出力
KFCA10359-W | mcftstartコマンド入力元への応答に失敗しました | メッセージログファイル
KFCA10370-I | mcftstartコマンドを正常に受け付けました | 標準出力
KFCA10372-E | mcftstartコマンドが異常終了しました | 標準エラー出力
KFCA10380-E | 相手プロセスの検索に失敗しました | 標準エラー出力
KFCA10391-E | mcftstartコマンドはサポートされていません | 標準エラー出力
KFCA16523-I | 部分開始中です | メッセージログファイル
KFCA16524-I | 部分開始しました | メッセージログファイル
KFCA16525-E | MCF部分開始中にOpenTP1終了コマンドが実行されました | メッセージログファイル
KFCA16527-E | MCF通信サービスが停止中ではありません | 標準エラー出力
KFCA16529-E | 併用できない機能が使用されています | 標準エラー出力

注意事項

このコマンドは，MCF通信サービスの部分開始が完了するのを待たないで終了します。

次のプロトコル製品以外を使用したMCF通信サービス（アプリケーション起動サービスを含む）は，部分開始できません。部分開始を実行した場合，メッセージKFCA10391-Eを出力します。

TP1/NET/TCP/IP

TP1/NET/Secondary Logical Unit - TypeP2

TP1/NET/OSAS-NIF

MCF通信サービスの部分停止前のユーザタイマ監視要求は，要求先のMCF通信サービスが部分停止状態になっても有効です。また，部分停止中のMCF通信サービスに対するユーザタイマ監視要求も登録されます。MCF通信サービスが部分停止している間は，タイマ監視は実行されませんが，部分停止中も経過時間に含まれます。そのため，部分停止後にMCF通信サービスを部分開始してタイマ監視を開始した場合，タイムアウトを検知し，UAPが起動されることがあります。

mcftstop

名称

MCF通信サービスの部分停止

形式

mcftstop -s MCF通信プロセス識別子

機能

MCF通信サービスを部分停止します。

MCF通信サービスに使用するファイルの一部を入れ替える場合，入れ替え前にこのコマンドを実行し，入れ替え対象のMCF通信サービスを部分停止させます。

なお，このコマンドの使用方法を誤ると，OpenTP1システムが異常終了する場合があります。ご使用の前に，注意事項をよくご確認ください。

オプション

●-s　MCF通信プロセス識別子　　～〈数字（0～9），a～f〉((01～ef))

部分停止するMCF通信サービスのMCF通信プロセス識別子を指定します。MCF通信プロセス識別子は複数指定できません。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10350-I | mcftstopコマンドが入力されました | 標準出力
KFCA10351-E | MCF開始処理中です | 標準エラー出力
KFCA10352-E | MCF終了処理中です | 標準エラー出力
KFCA10353-W | 入力形式が誤っています | 標準エラー出力
KFCA10354-E | メモリ不足です | 標準エラー出力
KFCA10355-W | 引数の指定が誤っています | 標準エラー出力
KFCA10356-E | タイムアウトが発生しました | 標準エラー出力
KFCA10358-E | 内部関数のエラーが発生しました | 標準エラー出力
KFCA10359-W | mcftstopコマンド入力元への応答に失敗しました | メッセージログファイル
KFCA10370-I | mcftstopコマンドを正常に受け付けました | 標準出力
KFCA10372-E | mcftstopコマンドが異常終了しました | 標準エラー出力
KFCA10380-E | 相手プロセスの検索に失敗しました | 標準エラー出力
KFCA10391-E | mcftstopコマンドはサポートされていません | 標準エラー出力
KFCA16521-I | 部分停止中です | メッセージログファイル
KFCA16522-I | 部分停止しました | メッセージログファイル
KFCA16526-E | MCF通信サービスがオンライン中ではありません | 標準エラー出力
KFCA16528-E | 併用できない機能が使用されています | 標準エラー出力

注意事項

このコマンドの使用方法を誤ると，OpenTP1システムが異常終了する場合があります。ご使用の前に，次に示す注意事項をよくご確認ください。

このコマンドを入力する前に，必ず部分停止対象のMCF通信サービスの論理端末を閉塞状態にし，またMCF通信サービスのコネクションを解放してください。MCF通信サービスがメッセージ送受信中にこのコマンドを入力した場合，このコマンドが終了しなくなったり，MCF通信サービスが異常終了したりすることがあります。

このコマンドは，MCF通信サービスの部分停止が完了するのを待たないで終了します。

次のプロトコル製品以外を使用したMCF通信サービス（アプリケーション起動サービスを含む）は，部分停止できません。部分停止を実行した場合，メッセージKFCA10391-Eを出力します。

TP1/NET/TCP/IP

TP1/NET/Secondary Logical Unit - TypeP2

TP1/NET/OSAS-NIF

MCF通信サービスの部分停止前のユーザタイマ監視要求は，要求先のMCF通信サービスが部分停止状態になっても有効です。また，部分停止中のMCF通信サービスに対するユーザタイマ監視要求も登録されます。MCF通信サービスが部分停止している間は，タイマ監視は実行されませんが，部分停止中も経過時間に含まれます。そのため，部分停止後にMCF通信サービスを部分開始してタイマ監視を開始した場合，タイムアウトを検知し，UAPが起動されることがあります。

保留中の論理端末またはサービスグループが一つでもある状態で，MCF通信サービスの部分停止を実行すると，OpenTP1は異常終了します。MCF通信サービスの部分停止は，すべての論理端末，サービスグループの保留を解除したあとに実行してください。

mcftstptr

名称

MCFトレース取得の終了

形式

mcftstptr -s MCF通信プロセス識別子

機能

MCFトレースの取得を終了し，取得したトレースデータをMCFトレースファイルへ出力します。

オプション

●-s　MCF通信プロセス識別子　　～〈数字（0～9），a～f〉((01～ef))

MCFトレースの取得を終了するMCF通信プロセス識別子を指定します。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10261-I | トレースデータの取得を終了します | メッセージログファイル
KFCA10264-W | トレースデータへの出力中のためコマンドを無視します | メッセージログファイル
KFCA10265-E | トレースファイルへの出力に失敗したためコマンド処理を中断します | メッセージログファイル
KFCA10266-W | トレースデータの取得を開始していません | メッセージログファイル

注意事項

このコマンドを実行する前に，mcftstrtrコマンド（MCFトレース取得の開始コマンド）を実行していないと，障害が発生し，エラーメッセージを出力します。ただし，MCF通信構成定義で，MCFトレースのディスク出力機能を使用するよう定義した場合（mcfttrc -t "disk=yes"）は，mcftstrtrを実行していなくても，mcftstptrコマンドを実行できます。この場合，MCFトレースファイル出力後，ディスク出力機能は停止します。ディスク出力機能を再開するには，mcftstrtrを実行してください。

-sオプションに同じMCF通信プロセス識別子を指定したmcftstptrコマンドを重複して実行すると，障害が発生し，エラーメッセージを出力します。

このコマンドを実行したあと，トレースデータ取得中にトレースバッファスワップが発生した場合，およびMCFトレース終了要求が発生した場合は，MCFトレースはトレースファイルに出力されません。MCFトレースを出力するには，MCFトレース取得の開始コマンド（mcftstrtr）を実行してください。

mcftstrtr

名称

MCFトレース取得の開始

形式

mcftstrtr -s MCF通信プロセス識別子

機能

MCFトレースの取得を開始します。

オプション

●-s　MCF通信プロセス識別子　　～〈数字（0～9），a～f〉((01～ef))

MCFトレースを取得するMCF通信プロセス識別子を指定します。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10260-I | トレースデータの取得を開始します | メッセージログファイル
KFCA10262-E | トレースデータの取得準備に失敗しました | メッセージログファイル
KFCA10263-W | トレースデータの取得中にトレース取得開始要求を受けました | メッセージログファイル
KFCA10269-E | トレースファイルの入出力中に障害が発生したため，トレースファイル出力を中止します | メッセージログファイル
KFCA10273-E | トレースファイルの入出力中に障害が発生しました | メッセージログファイル

注意事項

MCFトレースの取得開始位置は，mcftstrtrコマンドからMCF通信プロセスへ制御が移ってから設定されるため，mcftstrtrコマンド実行時よりは遅れます。

-sオプションに同じMCF通信プロセス識別子を指定したmcftstrtrコマンドを重複して実行すると，障害が発生し，エラーメッセージを出力します。

MCF通信構成定義で，MCFトレースのディスク出力機能を使用しないよう定義した場合（mcfttrc -t "disk=no"）でも，このコマンドを実行すると，MCFトレースの取得終了コマンド（mcftstptr）が実行されるまでは，ディスク出力機能を使用します。

mcftswptr

名称

MCFトレースファイルの強制スワップ

形式

mcftswptr 〔-s MCF通信プロセス識別子〕

機能

MCFトレースファイルを強制的にスワップします。

オプション

●-s　MCF通信プロセス識別子　　～〈数字（0～9），a～f〉((01～ef))

処理対象のコネクションを制御するMCF通信サービスのMCF通信プロセス識別子を指定します。MCF通信プロセス識別子は複数指定できません。

このオプションの指定を省略すると，すべてのMCFに対して，mcftswptrコマンドを実行します。したがって，MCF通信サービスを検索するオーバヘッドが，運用コマンドの処理に加わります。

MCF通信サービスが多い構成や運用コマンドを多数入力する運用を行う場合は，-sオプションで，MCF通信プロセス識別子を指定する運用設計を行ってください。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10264-W | トレースファイルへの出力中のためコマンドを無視します | 標準エラー出力
KFCA10266-W | トレースデータの取得を開始していません | メッセージログファイル
KFCA10267-W | トレース環境定義のディスク出力指定をしていないためトレースファイル出力をしません | 標準エラー出力
KFCA10278-I | トレースファイルの切り替えが終了しました | メッセージログファイル
KFCA10279-W | トレースファイルの切り替えが失敗しました | 標準エラー出力
KFCA10280-W | トレースファイルの出力処理ができないためコマンドを無視します | 標準エラー出力
KFCA10350-I | mcftswptrコマンドが入力されました | 標準出力
KFCA10351-E | MCF開始処理中です | 標準エラー出力
KFCA10352-E | MCF終了処理中です | 標準エラー出力
KFCA10353-W | 入力形式が誤っています | 標準エラー出力
KFCA10354-E | メモリ不足です | 標準エラー出力
KFCA10356-E | プロセス間でタイムアウトが発生しました | 標準エラー出力
KFCA10357-E | MCF内でタイムアウトが発生しました | 標準エラー出力
KFCA10358-E | 内部関数のエラーが発生しました | 標準エラー出力
KFCA10359-W | mcftswptrコマンド入力元への応答に失敗しました | メッセージログファイル
KFCA10370-I | mcftswptrコマンドを正常に受け付けました | 標準出力
KFCA10372-E | mcftswptrコマンドが異常終了しました | 標準エラー出力
KFCA10380-E | 相手プロセスの検索に失敗しました | 標準エラー出力
KFCA10508-I | ヘルプメッセージ | 標準出力
KFCA16402-E | コマンド処理中にRPC障害が発生しました | 標準エラー出力

mcfuevt

名称

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

形式

mcfuevt -s MCF通信プロセス識別子 -t 入力メッセージ

機能

アプリケーション属性定義で指定したアプリケーション（UCMDEVT）を起動し，-tオプションで指定した入力メッセージを渡します。

オプション

●-s　MCF通信プロセス識別子　　～〈数字（0～9），a～f〉((01～ef))

MCF通信プロセス識別子を指定します。

複数のMCF通信プロセス識別子は指定できません。

なお，UCMDEVTはプロトコルに依存しないアプリケーションのため，MCFアプリケーション起動プロセス識別子を指定することをお勧めします。MCFアプリケーション起動プロセス識別子を指定する場合，MCF通信構成定義のmcftenv定義コマンド（MCF環境定義）に指定したアプリケーション起動プロセス識別子と同じものを指定してください。

●-t　入力メッセージ　　～〈1～80文字の文字列〉

UCMDEVTに渡す入力メッセージを，引用符（"）で囲んで指定します。

全角1文字は，2文字として扱います。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA10350-I | mcfuevtコマンドが入力されました | 標準出力
KFCA10351-E | MCF開始処理中です | 標準エラー出力
KFCA10352-E | MCF終了処理中です | 標準エラー出力
KFCA10353-W | 入力形式が誤っています | 標準エラー出力
KFCA10354-E | メモリ不足です | 標準エラー出力
KFCA10355-W | 引数の指定が誤っています | 標準エラー出力
KFCA10356-E | プロセス間でタイムアウトが発生しました | 標準エラー出力
KFCA10357-E | MCF内でタイムアウトが発生しました | 標準エラー出力
KFCA10358-E | 内部関数のエラーが発生しました | 標準エラー出力
KFCA10359-W | mcfuevtコマンド入力元への応答に失敗しました | メッセージログファイル
KFCA10370-I | mcfuevtコマンドを正常に受け付けました | 標準出力
KFCA10372-E | mcfuevtコマンドが異常終了しました | 標準エラー出力
KFCA10380-E | 相手プロセスの検索に失敗しました | 標準エラー出力
KFCA10393-E | アプリケーション（UCMDEVT）がありません | 標準エラー出力
KFCA10394-E | 入力メッセージ長が誤っています | 標準エラー出力
KFCA10532-I | ヘルプメッセージ | 標準出力
KFCA11513-E | 定義コマンドのオペランド指定が誤っています | 標準エラー出力
KFCA16402-E | コマンド処理中にRPC障害が発生しました | 標準エラー出力

namalivechk

名称

OpenTP1起動確認とキャッシュ削除

形式

namalivechk ｛-l｜-c｝ 〔-t コネクト確立監視時間〕

機能

システム共通定義のall_nodeオペランド，およびall_node_exオペランドに指定されたOpenTP1ノードのうち，-lオプションで表示されたOpenTP1ノードを対象に起動を確認します。ノード自動追加機能を使用しているOpenTP1ノードでは，ノードリストおよびシステム共通定義のall_node_exオペランドに登録されているOpenTP1ノードを対象に，起動を確認します。

起動を検出できなかったOpenTP1ノード名をエラーログファイル，標準エラー出力，およびsyslogファイルに出力します。さらに，起動を検出できなかったOpenTP1ノードのすべてのサービス情報をキャッシュから削除し，そのノードとのコネクションを切断します。

OpenTP1が動作中のときだけこのコマンドを実行できます。

オプション

●-l

起動確認対象になるすべてのOpenTP1ノードのサービス情報を標準エラー出力へ出力します。起動確認対象になるOpenTP1ノードは，システム共通定義のall_nodeオペランドのうちOpenTP1が未起動を検知していないOpenTP1ノード，およびall_node_exオペランドに指定されたOpenTP1ノードです。

このオプションは，-cオプションと同時に指定することはできません。

●-c

-lオプションで表示されるOpenTP1ノードの起動を確認します。起動を確認した結果，起動を検出できなかったOpenTP1ノードの情報をエラーログファイル，および標準エラー出力へ出力します。また，システム共通定義のall_nodeオペランドに指定したOpenTP1ノードで，起動を検出できなかったOpenTP1ノードをRPC抑止リストへ登録します。さらに，これらのOpenTP1ノードとシステム共通定義のall_node_exオペランドに指定したOpenTP1ノードのサービス情報をキャッシュから削除します。RPC抑止リストとは，OpenTP1システムが，未起動のOpenTP1ノードの情報を保持しているリストです。

このオプションは，-lオプションと同時に指定することはできません。

●-t　コネクション確立監視時間　　～〈符号なし整数〉((1～65535))《8》（単位：秒）

このオプションで指定した時間内に起動を確認できないOpenTP1ノードは，未起動と判断します。範囲外の値を指定した場合，8秒が仮定されます。

出力形式

●namalivechk -lを実行した場合

No.|         起動確認ノード         | ポート番号
aaa|bb....bb                        |    ccccc

aaa：OpenTP1ノード項目番号（整数3文字以内）

bb....bb：起動確認対象のOpenTP1ノード名（英数字32文字以内）

ccccc：起動確認対象のOpenTP1ノードのポート番号（整数5文字以内）

●namalivechk -cを実行した場合

No.|        起動未検出ノード        | ポート番号
aaa|bb....bb                        |    ccccc

aaa：OpenTP1ノード項目番号（整数3文字以内）

bb....bb：起動を検出できないOpenTP1ノード名（英数字32文字以内）

ccccc：起動を検出できないOpenTP1ノードのポート番号（整数5文字以内）

出力メッセージ

メッセージID | 内容 | 出力先
KFCA33618-W | ノードリストファイルが他プロセスで使用中です | 標準エラー出力
KFCA33619-E | ネームサービス起動中のため，(namalivechk)コマンドが受け付けられません | 標準エラー出力

注意事項

同じIPアドレスを使用するノードをシステム共通定義のall_nodeオペランド，またはall_node_exオペランドに複数指定している場合，namalivechkコマンドは実行しないでください。

namblad

名称

OpenTP1ノードのRPC抑止リスト操作

形式

namblad ｛-a｜-d｝ ノード名〔:ポート番号〕〔,ノード名〔:ポート番号〕…〕

機能

コマンドに指定したノードをRPC抑止リストに登録，またはRPC抑止リストから削除します。

オプション

●-a

コマンド引数に指定したノードをRPC抑止リストに登録します。

●-d

コマンド引数に指定したノードをRPC抑止リストから削除します。

コマンド引数

●ノード名　　～〈1～255文字の識別子〉

RPC抑止リストに登録または削除を行うノード名を指定します。システム共通定義のall_nodeオペランド，または$DCCONFPATH/dcnamnd下のドメイン定義ファイルに指定したノード名を指定してください。all_nodeオペランドに指定していないノード名を指定した場合は，エラーが発生し，KFCA00675-Eメッセージが出力されます。

●ポート番号　　～〈符号なし整数〉((5001～65535))

システム共通定義，および$DCCONFPATH/dcnamnd下に作成したドメイン定義ファイルのall_nodeオペランドに指定したノード名に対応するポート番号を指定してください。ポート番号を省略した場合，システム共通定義のname_portオペランドの指定値が仮定されます。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA00674-I | ヘルプメッセージ | 標準出力
KFCA00675-E | 指定したノードはall_nodeに定義されていません | 標準エラー出力
KFCA00676-E | 指定したノードが重複しています | 標準エラー出力
KFCA33618-W | ノードリストファイルが他プロセスで使用中です | 標準エラー出力
KFCA33619-E | ネームサービス起動中のため，(namblad)コマンドが受け付けられません | 標準エラー出力

注意事項

UAPで実行するRPC処理と，このコマンドが同時に動作した場合，UAPで実行したRPCの性能に影響を及ぼすことがあります。

-aオプションを指定すると，コマンドに指定したノードをRPC抑止リストに登録します。ネームサービスがコマンドに指定したノードの起動を検知すると，RPC抑止リストから起動を検知したノードを削除することがあります。その場合，削除されたノードがRPC抑止リストに登録されていないと，namsvinfコマンドなどの表示情報で表示されるときがあります。

このコマンドを実行した場合，コマンドに指定したノード上で稼働しているサービスグループのサービス情報がキャッシュから削除されます。このとき，次の現象が起きます。

コマンドを実行したノードや，ほかのノード上で同一のサービスグループが動作している場合

nambladコマンドやネームサービスから実行されるRPC抑止リストからの削除が行われても，最大30分間，該当するノード上で動作しているサービスグループにRPC処理が実行されないことがあります。

コマンドを実行したノードや，ほかのノード上で同一のサービスグループが動作していない場合

nambladコマンドやネームサービスから実行されるRPC抑止リストからの削除が行われたとき，そのあとに実行したRPCでサービス情報を検索します。そのため，RPCの性能に影響を及ぼすことがあります。

ノード自動追加機能を使用しているノードでnambladコマンドに指定できるノード名は，ノードリストに登録されているIPアドレスだけです。なお，ノードリストに登録されていないノードをnambladコマンドに指定した場合，KFCA00675-Eメッセージが出力されます。

namchgfl

名称

ドメイン構成の変更（ドメイン定義ファイル使用）

形式

namchgfl 〔-n〕 〔-d 〔-t コネクション確立監視時間〕〕 〔-e〕

機能

OpenTP1のドメイン構成を，OpenTP1の動作中に変更します。all_nodeおよびall_node_exのドメイン定義ファイルに，変更後のドメイン構成（ノードの並び）を定義してください。その後，このコマンドを実行してください。コマンド正常終了後にドメイン定義ファイルのドメイン構成が有効になります。ドメイン定義ファイルの詳細については，「3.10.1(2)　namchgflコマンドを使用したドメイン構成の変更」を参照してください。

このコマンドは，システム共通定義のname_domain_file_useオペランドにYを指定した場合だけ使用できます。name_domain_file_useオペランドにNを指定した場合，このコマンドはエラーになります。また，OpenTP1が動作中のときだけこのコマンドを実行できます。

オプション

●-n

このオプションを指定した場合，共用メモリを変更しません。

このオプションは，共用メモリを変更しないで，all_nodeのドメイン定義ファイルに指定しているノードが共用メモリ中のネームサービスが管理する領域に格納できるかどうかの確認だけをしたいときに指定します。-eオプションを指定した場合は，all_node_exのドメイン定義ファイルに指定しているノードも確認対象になります。共用メモリの領域に格納しきれない場合，標準エラー出力にメッセージを出力します。

システム共通定義に指定したall_nodeオペランド，およびall_node_exオペランドのノードについては確認できません。

●-d

all_nodeのドメイン定義ファイルに指定しているノードの起動状況を確認する場合，指定します。すべてのノードが起動していて，さらに共用メモリ中のネームサービスが管理する領域に，all_nodeのドメイン定義ファイルに指定しているノードを格納できる場合だけ，ドメイン構成を変更します。-eオプションを指定した場合は，all_node_exのドメイン定義ファイルに指定しているノードも確認，変更対象になります。

未起動のノードがある場合，未起動のノードのノード情報を標準出力へ表示します。ただし，起動状況によって，各ノードのサービス情報を格納した領域から，サービス情報を削除したり，RPC抑止リストを登録／除外したりはしません。all_nodeのドメイン定義ファイル，およびall_node_exのドメイン定義ファイルに，未起動のノードがない場合（ノードが一つも指定されていないか，またはすべてのノードを起動状態と確認した場合）は，ノード情報にはヘッダ部分も含め何も出力しません。

システム共通定義に指定したall_nodeオペランド，およびall_node_exオペランドのノードについては確認および変更できません。

ドメイン定義ファイルに指定しているノードに未起動のノードがあっても共用メモリを変更したい場合は，このオプションを指定しないでください。

●-t　コネクション確立監視時間　　～〈符号なし整数〉((1～65535))《8》（単位：秒）

指定した時間内に起動を確認できないOpenTP1ノードを未起動と判断します。

確認，または確認と変更をする場合の指定方法について次に示します。

共用メモリの
領域サイズ確認
ノードの
起動状況確認
共用メモリの
変更
指定方法

○
×
×
namchgfl -n

○
○
×
namchgfl -n -d

○
×
○
namchgfl

○
○
○※
namchgfl -d

（凡例）

○：実施します。

×：実施しません。

注※

共用メモリの領域サイズが，ドメイン定義ファイルのノードを格納しきれない場合は，共用メモリを変更しません。

●-e

all_nodeのドメイン定義ファイル，およびall_node_exのドメイン定義ファイルに指定されたノードを，起動確認およびドメイン構成変更の対象にします。このオプションを指定しない場合，all_nodeのドメイン定義ファイルに指定されたノードだけを，起動確認およびドメイン構成変更の対象にします。

出力形式

「namchgfl -d -e」と指定した場合の出力形式を次に示します。

all_node 情報
No.|        未起動ノード             | ポート番号
aaa|bb....bb                        |    ccccc
aaa|bb....bb                        |    ccccc
all_node_ex 情報
No.|        未起動ノード             | ポート番号
aaa|bb....bb                        |    ccccc
aaa|bb....bb                        |    ccccc

aaa：ノードの項目番号（整数3文字以内）

bb....bb：未起動のノード名（英数字32文字以内）

ccccc：未起動のノードのポート番号（整数5文字以内）

出力メッセージ

メッセージID | 内容 | 出力先
KFCA00654-E | 定義ファイルに指定したall_nodeの数が許容範囲を超えています | 標準エラー出力
KFCA00655-E | 定義ファイルに指定したall_node_exの数が許容範囲を超えています | 標準エラー出力
KFCA00656-E | 指定されたノード名に誤りがあります | 標準エラー出力
KFCA00657-E | 指定されたポート番号に誤りがあります | 標準エラー出力
KFCA00658-W | 重複するノード情報が定義されています | 標準エラー出力
KFCA00659-I | コマンド（namchgfl）を開始しました | 標準出力
KFCA00660-I | 起動確認（namchgfl）を開始しました | 標準出力
KFCA00661-I | 起動確認（namchgfl）を終了しました | 標準出力
KFCA00662-I | ドメイン構成の書き換え（namchgfl）を終了しました | 標準出力
KFCA00663-E | name_domain_file_useにNを指定しているため，コマンド（namchgfl）をできません | 標準エラー出力
KFCA00665-E | 解析処理中にエラーが発生しました | 標準エラー出力
KFCA00666-E | 指定されたノード名は未定義です | 標準エラー出力
KFCA00669-W | ディレクトリが存在しません。オペランドが指定されていないとして，処理を続行します | 標準エラー出力
KFCA00670-I | ノードが指定されていません。自ノードだけで構成するOpenTP1システムとして続行します | 標準出力
KFCA00671-I | ドメイン定義ファイルに指定されたノードの確認（namchgfl）を終了しました | 標準出力
KFCA00672-E | コマンド（namchgfl）が異常終了しました | 標準エラー出力
KFCA33600-E | ノード自動追加機能を使用しているノードでコマンド（namchgfl）は実行できません | 標準エラー出力
KFCA33619-E | ネームサービス起動中のため，(namchgfl)コマンドが受け付けられません | 標準エラー出力

注意事項

namchgflコマンドを実行すると，ノード数を増やして大きな構成にできます。OpenTP1起動時より増やせるノード数は，次のとおりです。

all_node
システム共通定義のall_node_extend_numberオペランドに指定した値（省略値は64）まで増やせます。

all_node_ex
システム共通定義のall_node_ex_extend_numberオペランドに指定した値（省略値は64）まで増やせます。

all_nodeのドメイン定義ファイルからノードを削除する場合は，そのノードのSPPをすべて停止してから，namchgflコマンドを実行してください。SPP起動中にノードを削除した場合は，トランザクション処理などで障害が発生するおそれがあります。

次のどれかの場合は，KFCA00672-Eメッセージを出力してコマンドが異常終了します。

コマンド引数の指定に誤りがある。

ドメイン定義ファイルに指定した内容に誤りがある。

ドメイン定義ファイルに指定したノードが，共用メモリ中のネームサービスが管理する領域に格納しきれない。

ドメイン定義ファイルに指定したノードのうち，未起動と判断されたノードが一つ以上ある。

ノード自動追加機能を使用しているマネジャノードおよびエージェントノードでは，namchgflコマンドは実行できません。実行した場合はエラーとなり，KFCA33600-Eメッセージが出力されます。

namdomainsetup

名称

ドメイン代表スケジュールサービスの登録と削除

形式

namdomainsetup 〔-d〕ドメインデータファイル名 ホスト名

機能

ドメイン代表スケジュールサービスをドメインデータファイルに登録します。ドメイン代表スケジュールサービスは，最大3個登録できます。

また，ドメインデータファイルからドメイン代表スケジュールサービスを削除します。

オプション

●-d

指定したホスト名で起動するドメイン代表スケジュールサービスをドメインデータファイルから削除します。

コマンド引数

●ドメインデータファイル名　　～〈パス名〉

ドメインデータファイル名を完全パス名で指定します。ドメインデータファイルとは，DNSが管理するhosts情報ファイルのことです。

●ホスト名　　～〈1～255文字の識別子〉

ドメイン代表スケジュールサービスを起動するホストの名称を指定します。このオプションにホストのエイリアス名を指定してはなりません。

注意事項

namdomainsetupコマンドはスーパユーザしか実行できません。

コマンド実行後は，DNSを再起動してください。

nammstr

名称

マネジャノードの変更

形式

nammstr 〔-g〕｛-u|-d ノード名〔:ポート番号〕｜-c ノード名〔:ポート番号〕｝〔-w 最大応答待ち時間〕〔-f〕〔-e〕

機能

ノード自動追加機能使用時に，マネジャノードとして動作させるノードを変更します。マネジャノードが障害などの原因で停止し，システム内で動作させるマネジャノードを変更したい場合などに使用します。

また，このコマンドはノード自動追加機能を使用していないノードでは実行できません。実行した場合はエラーとなり，KFCA33601-Eメッセージが出力されます。

オプション

●-g

このオプションが指定された場合，再確認メッセージ（KFCA00644-R）の出力を抑止します。

●-u

コマンドを実行したエージェントノードを，一時的にマネジャノードとして動作させます（動作モードの昇格）。また，ノードリストに登録されているノードに対して，コマンドを実行したノードがマネジャノードとして動作する旨を通知します。

このオプションは，エージェントノードで指定できます。マネジャノードでは指定できません。また，-d，-cオプションと同時に指定できません。

このオプションを指定した場合，コマンドはコマンドを実行したノードがマネジャノードと認識しているノードの稼働状況を確認します。マネジャノードが稼働している場合，エラーとなります。

このオプションで変更した動作モードは，OpenTP1がオンラインの間だけ有効です。OpenTP1の再起動後は，システム共通定義のname_service_modeオペランドの指定で動作します。

●-d ノード名〔:ポート番号〕

コマンドを実行したマネジャノードを，一時的にエージェントノードとして動作させます（動作モードの降格）。また，ノードリストに登録されているノードに対して，コマンドを実行したノードがエージェントノードとして動作する旨を通知します。

このオプションは，エージェントノードで指定できます。マネジャノードでは指定できません。また，-u，-c，または-eオプションと同時に指定できません。

このオプションに指定するノード名には，コマンドを実行したノードに認識させたいマネジャノードのホスト名，またはIPアドレスを指定します。ポート番号には，ノード名に対応するポート番号を指定します。ポート番号を省略した場合，システム共通定義のname_portオペランドの指定値が仮定されます。また，システム共通定義のall_node_exオペランドに指定したノード名は指定できません。指定した場合はエラーとなり，KFCA33603-Eメッセージが出力されます。

このオプションを指定した場合，コマンドは指定されたノードに対してノードリスト要求を送信し，マネジャノードの動作状況を確認します。要求の送信に失敗したときや，-wオプションに指定した時間内にコマンドで指定したノードから応答を受信できなかったときは，エラーとなります。

このオプションで変更した動作モードは，OpenTP1がオンラインの間だけ有効です。OpenTP1の再起動後は，システム共通定義のname_service_modeオペランドの指定で動作します。

●-c　ノード名〔:ポート番号〕

このオプションで指定したノードをマネジャノードとして認識させます。

このオプションは，エージェントノードで指定できます。マネジャノードでは指定できません。また，-u，-dオプションと同時に指定できません。

このオプションのノード名には，自ノードに認識させたいマネジャノードのホスト名，またはIPアドレスを指定します。ポート番号には，ノード名に対応するポート番号を指定します。ポート番号を省略した場合，システム共通定義のname_portオペランドの指定値が仮定されます。また，システム共通定義のall_node_exオペランドに指定したノード名は指定できません。指定した場合はエラーとなり，KFCA33603-Eメッセージが出力されます。

このオプションを指定した場合，コマンドは指定されたノードに対してノードリスト要求を送信し，マネジャノードの動作状況を確認します。要求の送信に失敗したときや，-wオプションに指定した時間内にコマンドで指定したノードから応答を受信できなかったときは，エラーとなります。

このオプションで変更した動作モードは，OpenTP1がオンラインの間だけ有効です。OpenTP1の再起動後は，システム共通定義のall_nodeオペランド，またはドメイン定義ファイルに指定したすべてのノードに対してノードリスト要求を送信し，最初にノードリストを返信してきたノードをマネジャノードと認識します。

●-w　最大応答待ち時間　　～〈符号なし整数〉((1～1800))《8》（単位：秒）

-dまたは-cオプションに指定したノードにノードリスト要求を送信してから，応答が返るまでの最大応答待ち時間を指定します。このオプションに指定した時間内に応答を受信できなかった場合，エラーとなります。

このオプションは，-dまたは-cと同時に指定してください。

●-f

このオプションを-uオプションと同時に指定した場合，自ノードがマネジャノードと認識しているノードの稼働状況を確認しません。

このオプションを-dまたは-cオプションと同時に指定した場合，コマンドに指定されたノードに対してマネジャノードの動作状況を確認しません。

●-e

このオプションは，-uまたは-cオプションと同時に指定します。-dオプションと同時に指定できません。このコマンドを実行する前に，マネジャノードと認識していたノードの情報を，動作モードの変更（昇格または降格）をする際にノードリストから削除します。削除するノードのサービス情報がグローバルキャッシュに登録されている場合，サービス情報も削除します。

出力メッセージ

メッセージID
内容
出力先

KFCA00609-E
ネームサービスで管理できる最大ノード数を超えるため，ノードを追加できません
標準エラー出力

KFCA00611-E
コマンド引数の指定が誤っています
標準エラー出力

KFCA00620-E
nammstrコマンド実行中にエラーが発生しました
標準エラー出力

KFCA00629-I
ヘルプメッセージ
標準出力
標準エラー出力

KFCA00636-E
ノード情報を取得できませんでした
標準エラー出力

KFCA00644-R
コマンド(nammstr)を実行します
標準出力

KFCA00679-E
現在の動作モードで指定したオプションは使用できません
標準エラー出力

KFCA00681-E
マネジャノードを設定できません
標準エラー出力

KFCA00682-I
マネジャノードを設定しました
標準出力

KFCA00684-E
システム内で既にマネジャノードが動作しています
標準エラー出力

KFCA00685-I
ネームサービスの動作モードを変更しました
標準出力

KFCA33601-E
ノード自動追加機能を使用していないノードでコマンド(nammstr)は実行できません
標準エラー出力

KFCA33603-E
指定したノードはall_node_exオペランド，またはall_node_exのドメイン定義ファイルに指定されています
標準エラー出力

KFCA33605-E
マネジャノード変更通知に失敗しました
標準エラー出力

KFCA33606-E
他の処理がノード情報を更新しているため，コマンド(nammstr)は続行できません
標準エラー出力

KFCA33612-E
ノードリストファイルへのアクセスでエラーが発生しました
標準エラー出力

KFCA33618-W
ノードリストファイルが他プロセスで使用中です
標準エラー出力

KFCA33619-E
ネームサービス起動中のため，(nammstr)コマンドが受け付けられません
標準エラー出力

注意事項

nammstrコマンドを実行するノードのUAPをすべて停止してから，nammstrコマンドを実行してください。UAP動作中にこのコマンドを実行した場合，RPCの通信障害や，トランザクション処理などで障害が発生するおそれがあります。

nammstrコマンドは，OpenTP1開始中および終了中は実行できません。実行した場合はエラーとなり，KFCA00681-Eメッセージが出力されることがあります。

nammstrコマンドによる動作モードの変更（昇格，降格），およびマネジャノードの変更は，OpenTP1が稼働中の間だけ有効です。OpenTP1を再起動すると，システム共通定義に指定した動作モードに戻ります。ノードリストの引き継ぐと，nammstrコマンドによる動作モードの状態，およびマネジャノードの指定先がノードリストファイルに引き継がれます。また，再起動時にも前回起動時の動作モードを引き継げます。

-dまたは-cオプションのノード名には，システム共通定義のall_node_exオペランドに指定したノードを指定できません。指定した場合はエラーとなり，KFCA33603-Eメッセージが出力されます。

OpenTP1システム内でマネジャノードが稼働しているときに，-uオプションと-fオプションでエージェントノードをマネジャノードに強制的に昇格させると，同一のOpenTP1システム内に複数のマネジャノードが稼働している状態になります。このとき，マネジャノード間で何らかのメッセージ送受信が行われると，OpenTP1システム内のノード間でノードリストの不整合が発生し，RPCが正常に行われないおそれがあります。-fオプションを指定する場合は，OpenTP1システム内でマネジャノードが停止していることを確認してください。

namndchg

名称

ドメイン構成の変更（システム共通定義使用）

形式

namndchg 〔-l〕

機能

OpenTP1のドメイン構成を，OpenTP1の動作中に変更できます。ドメイン構成の変更は，システム共通定義のall_nodeオペランドに変更するドメイン構成（ノードの並び）を定義します。その後，このコマンドを実行してください。コマンド正常終了後に変更したドメイン構成が有効になります。

また，all_nodeオペランドの指定内容を標準出力に出力します。

OpenTP1が動作中のときだけコマンドを実行できます。

オプション

●-l

コマンドを実行したノードのノード名とポート番号，およびシステム共通定義のall_nodeオペランドで指定している現在のノード名とポート番号を標準出力に出力します。

出力形式

「namndchg -l」と指定した場合の出力形式を次に示します。

all_node information (aa....aa)
port number          node name
bbbbb                cc....cc

aa....aa：all_nodeオペランド登録時間（整数19文字）
yyyy/mm/dd hh:mm:ssの形式で表示します。

bbbbb：ポート番号（整数5文字以内）

cc...cc：ノード名（英数字255文字以内）

出力メッセージ

メッセージID
内容
出力先

KFCA00601-E
ネームサービス実行中に共用メモリが不足しました
標準エラー出力

KFCA00604-W
all_nodeオペランドで指定したノード名は重複しています
標準エラー出力

KFCA00606-E
all_nodeオペランドで指定したノード名は定義されていません
標準エラー出力

KFCA00607-E
all_nodeオペランドで指定したポート番号が誤っています
標準エラー出力

KFCA00611-E
コマンド引数の指定が誤っています
標準エラー出力

KFCA00615-I
ヘルプメッセージ
標準出力
標準エラー出力

KFCA00616-E
all_nodeオペランドの数が指定数を超えています
標準エラー出力

KFCA00620-E
namndchgコマンド実行中にエラーが発生しました
標準エラー出力

KFCA00663-E
name_domain_file_useにYを指定しているため，コマンド（namndchg）を続行できません
標準エラー出力

KFCA33600-E
ノード自動追加機能を使用しているノードでコマンド（namndchg）は実行できません
標準エラー出力

KFCA33619-E
ネームサービス起動中のため，(namndchg)コマンドが受け付けられません
標準エラー出力

注意事項

namndchgコマンドを実行すると，ノード数を増やして大きな構成にできます。OpenTP1起動時より増やせるノード数は，システム共通定義のall_node_extend_numberオペランドに指定した値（省略値は64）までです。

システム共通定義のall_nodeオペランドからノードを削除する場合は，そのノードのSPPをすべて停止してから，namndchgコマンドを実行してください。SPP起動中にノードを削除した場合は，トランザクション処理などで障害が発生する場合があります。

ノード自動追加機能を使用しているマネジャノードおよびエージェントノードでは，namndchgコマンドは実行できません。実行した場合はエラーとなり，KFCA33600-Eメッセージが出力されます。

システム共通定義のall_node_exオペランドは，OpenTP1起動時に指定した内容だけが有効となります。したがって，namndchgコマンドによってOpenTP1の動作中に指定内容を変更することはできません。
ただし，システム共通定義のall_nodeオペランドで，次の変更操作を行った場合，namndchgコマンドの実行後，all_node_exオペランドから該当するノードが削除されます。

システム共通定義のall_node_exオペランドに指定しているノードを，システム共通定義のall_nodeオペランドへ移動する変更操作を行った場合

システム共通定義のall_node_exオペランドに指定しているノードを，システム共通定義のall_nodeオペランドにも追加する変更操作を行った場合

all_nodeオペランドでの変更操作の例と，namndchgコマンド実行後のall_nodeおよびall_node_exオペランドについて，次の表に示します。

表13-9　all_nodeオペランドでの変更操作の例と，namndchgコマンド実行後のall_nodeおよびall_node_exオペランド

all_nodeオペランドに対する操作 | 変更操作の例 | コマンド実行後
all_nodeオペランド | all_node_exオペランド
追加 | all_node_exオペランドに指定していないノードをall_nodeオペランドに追加した場合 | 該当するノードを追加 | 変更なし
all_node_exオペランドに指定しているノードをall_nodeオペランドへ移動した場合 | 該当するノードを追加 | 該当するノードを削除
all_node_exオペランドに指定しているノードをall_nodeオペランドにも追加した場合 | 該当するノードを追加 | 該当するノードを削除
削除 | all_nodeオペランドに指定しているノードを削除した場合 | 該当するノードを削除 | 変更なし
all_nodeオペランドに指定しているノードをall_node_exオペランドに移動した場合 | 該当するノードを削除 | 変更なし

namndopt

名称

ノードのオプション情報の変更

形式

namndopt ｛-d｜-p｛high｜low｝ノード名〔:ポート番号〕｜-l｝

機能

ノード自動追加機能使用時に，指定したノードのオプション情報（ノードの優先度）を変更します。

オプション

●-d

コマンド引数に指定したノードのオプション情報をすべてデフォルト値に設定します。

●-p　｛high｜low｝

コマンド引数に指定したノードの優先度を指定します。

　high：コマンド引数に指定したノードを優先選択ノードに設定します。

　low：コマンド引数に指定したノードを優先選択ノードから除外します。

●-l

ノードリストの内容（ノードリスト情報，およびノードのオプション情報）を標準出力に出力します。

コマンド引数

●ノード名　　～〈1～255文字の識別子〉

オプション情報を変更するノード名を指定します。

●ポート番号　　～〈符号なし整数〉((5001～65535))

オプション情報を変更するノードのポート番号を指定します。ポート番号を省略した場合，システム共通定義のname_portオペランドの指定値が仮定されます。

出力形式

1：登録ノード数分繰り返し出力されます。

2：登録ノードリスト数分繰り返し出力されます。

3：ノードリストの状態を示します。

4：オプションノード数分繰り返します。

5：ノードリストオプションの状態を示します。

aaaa：最大ノード数

bb：最大ノードリスト数

cc：登録ノードリスト数

dd：ノードリスト通番

eeee：登録ノード数

fff.fff.fff.fff：ノードアドレス（IPアドレス）

ggggg：ポート番号

h：動作モード

M…マネジャノード

A…エージェントノード

N…ノーマルノード

*…システム共通定義のname_manager_nodeオペランドに指定されたノードをマネジャノードと認識していない

iiii：ノードID

jjjjj：RPC抑止リスト

INACT…登録

ACT…未登録

k：優先度

H…High

-…Low

llll：オプションノード数

mmm.mmm.mmm.mmm：ノードアドレス(IPアドレス)

nnnnn：ポート番号

o：優先度情報

H…High

-…Low

出力メッセージ

メッセージID
内容
出力先

KFCA00611-E
コマンド引数の指定が誤っています
標準エラー出力

KFCA00620-E
namndoptコマンド実行中にエラーが発生しました
標準エラー出力

KFCA33601-E
ノード自動追加機能を使用していないノードでコマンド(namndopt)は実行できません
標準エラー出力

KFCA33612-E
ノードリストファイルへのアクセスでエラーが発生しました
標準エラー出力

KFCA33618-W
ノードリストファイルが他プロセスで使用中です
標準エラー出力

KFCA33619-E
ネームサービス起動中のため，（namndopt）コマンドが受け付けられません
標準エラー出力

KFCA33620-I
ヘルプメッセージ
標準出力
標準エラー出力

KFCA33621-E
オプション指定可能なノード数の上限値（512）に達したため，オプションを指定できません
標準エラー出力

KFCA33625-E
指定したノードにはオプションが設定されていません
標準エラー出力

namndrm

名称

停止ノード情報の削除

形式

namndrm 〔-g〕〔-n ノード名〔:ポート番号〕〔,ノード名〔:ポート番号〕…〕〕〔-f〕

機能

ノード自動追加機能でノードリストに登録したノード情報のうち，システム停止や障害などの理由で停止しているノード情報を，ノードリストから削除します。

エージェントノードがマネジャノードからノードリストを受信できていない状態では，ノードリスト要求の送信先ノード（システム共通定義のname_manager_nodeオペランドに指定されたノード）からノード情報を削除します。

なお，このコマンドは，マネジャノードで実行してください。

オプション

●-g

このオプションが指定された場合，再確認メッセージ（KFCA00644-R）の出力を抑止します。

●-n　ノード名〔:ポート番号〕〔,ノード名〔:ポート番号〕…〕

ノードリストから削除する停止したノードのホスト名またはIPアドレスを指定します。ポート番号には，ノード名に対応するポート番号を指定します。ノードリストに登録されているノードは，namsvinfコマンドに-bオプションを指定して実行し，確認してください。ワイルドカードは使用できません。

ポート番号を省略した場合，システム共通定義のname_portオペランドの指定値が仮定されます。停止中ではないノードを指定した場合，エラーとなります。

-nオプションを省略した場合，ノードリストに登録しているマネジャノードを除くすべての停止ノードの情報を削除します。

●-f

稼働しているノードの情報をノードリストから強制削除します。削除するノードのサービス情報がグローバルキャッシュに登録されている場合，サービス情報も削除します。

出力メッセージ

メッセージID
内容
出力先

KFCA00611-E
コマンド引数の指定が誤っています
標準エラー出力

KFCA00620-E
namndrmコマンド実行中にエラーが発生しました
標準エラー出力

KFCA00628-I
ヘルプメッセージ
標準出力
標準エラー出力

KFCA00638-I
ノード情報を削除しました
標準出力

KFCA00639-E
指定したノードは動作中のため，ノード情報を削除できません
標準エラー出力

KFCA00644-R
コマンド(namndrm)を実行します
標準出力

KFCA00676-E
指定したノードが重複しています
標準エラー出力

KFCA00680-E
指定したノードはOpenTP1に登録されていません
標準エラー出力

KFCA33601-E
ノード自動追加機能を使用していないノードでコマンド(namndrm)は実行できません
標準エラー出力

KFCA33603-E
指定したノードはall_node_exオペランド，またはall_node_exのドメイン定義ファイルに指定されています
標準エラー出力

KFCA33606-E
他の処理がノード情報を更新しているため，コマンド(namndrm)は続行できません
標準エラー出力

KFCA33612-E
ノードリストファイルへのアクセスでエラーが発生しました
標準エラー出力

KFCA33618-W
ノードリストファイルが他プロセスで使用中です
標準エラー出力

KFCA33619-E
ネームサービス起動中のため，(namndrm)コマンドが受け付けられません
標準エラー出力

注意事項

namndrmコマンドを実行するノードのUAPをすべて停止してから，namndrmコマンドを実行してください。UAP動作中にこのコマンドを実行した場合，RPCの通信障害や，トランザクション処理などで障害が発生するおそれがあります。

namndrmコマンドは，ノード自動追加機能を使用していないノードでは実行できません。実行した場合はエラーとなり，KFCA33601-Eメッセージが出力されます。

namndrmコマンド実行時に，サービスグループ情報の検索などでノードリストを参照する処理が動作していると，エラーが発生してKFCA33606-Eメッセージが出力されます。この場合，再度コマンドを実行してください。

エージェントノードのノードリストからマネジャノードを削除すると，エージェントノードはマネジャノードを認識していない状態となります。このとき，マネジャノードを認識するまで，現在のノードリストに登録されているノード群だけをRPCの実行範囲とします。新たにOpenTP1システムに追加したノードをRPCの実行範囲にしたい場合，nammstrコマンド（-cオプションを指定）でエージェントノードにマネジャノードを認識させてください。

namndrmコマンドでエージェントノードのノードリストからマネジャノードを削除する場合は，-nオプションを指定してください。

エージェントノードのノードリストからノードリスト情報を強制的に削除する場合は，必ず-fオプションを指定してください。なお，指定したノードが稼働している場合など，システム内のノードの動作状況によっては，いったん削除したノードリスト情報が再度ノードリストに登録されることがあります。

エージェントノードのノードリスト要求の送信先ノード（システム共通定義のname_manager_nodeオペランドに指定されたノード）からノードリスト情報を削除する場合は，必ず-fオプションを指定してください。

namndrmコマンドでは，システム共通定義のall_node_exオペランドに指定したノードを削除できません。指定した場合はエラーとなり，KFCA33603-Eメッセージが出力されます。

namnlcre

名称

ノードリストファイルの初期設定

形式

namnlcre ノードリストファイル名

機能

OpenTP1ファイルシステム上に，ノードリストファイルを割り当てます。

コマンド引数

●ノードリストファイル名　　～〈パス名〉

作成するノードリストファイル名を完全パス名で指定します。指定したノードリストファイルがOpenTP1ファイルシステム上にすでにある場合は，エラーになります。

出力メッセージ

メッセージID
内容
出力先

KFCA00611-E
コマンド引数の指定が誤っています
標準エラー出力

KFCA00620-E
namnlcreコマンド実行中にエラーが発生しました
標準エラー出力

KFCA33607-I
ヘルプメッセージ
標準出力
標準エラー出力

KFCA33611-E
メモリ不足が発生しました
標準エラー出力

KFCA33612-E
ノードリストファイルへのアクセスでエラーが発生しました
標準エラー出力

namnldel

名称

ノードリストファイルの削除

形式

namnldel ノードリストファイル名

機能

指定したノードリストファイルを削除します。

コマンド引数

●ノードリストファイル名　　～〈パス名〉

削除するノードリストファイル名を完全パス名で指定します。

出力メッセージ

メッセージID
内容
出力先

KFCA00611-E
コマンド引数の指定が誤っています
標準エラー出力

KFCA00620-E
namnldelコマンド実行中にエラーが発生しました
標準エラー出力

KFCA33610-I
ヘルプメッセージ
標準出力
標準エラー出力

KFCA33611-E
メモリ不足が発生しました
標準エラー出力

KFCA33612-E
ノードリストファイルへのアクセスでエラーが発生しました
標準エラー出力

KFCA33622-E
ノードリストの引き継ぎ機能で使用するファイルへのアクセスに失敗しました
標準エラー出力

namnldsp

名称

ノードリストファイルの内容表示

形式

namnldsp ノードリストファイル名

機能

ノードリストファイルの内容を標準出力に出力します。

コマンド引数

●ノードリストファイル名　　～〈パス名〉

内容表示するノードリストファイル名を完全パス名で指定します。

出力形式

1：登録ノード数分繰り返し出力されます。

2：登録ノードリスト数分繰り返し出力されます。

3：ノードリストの状態を示します。

4：オプションノード数分繰り返します。

5：ノードリストオプションの状態を示します。

aaaa：最大ノード数

bb：最大ノードリスト数

cc：登録ノードリスト数

dd：ノードリスト通番

eeee：登録ノード数

fff.fff.fff.fff：ノードアドレス（IPアドレス）

ggggg：ポート番号

h：動作モード

M…マネジャノード

A…エージェントノード

N…ノーマルノード

*…システム共通定義のname_manager_nodeオペランドに指定されたノードをマネジャノードと認識していない

iiii：ノードID

jjjjj：RPC抑止リスト

INACT…登録

ACT…未登録

k：優先度情報

H…High

-…Low

llll：オプション情報を指定しているノード数

mmm.mmm.mmm.mmm：ノードアドレス(IPアドレス)

nnnnn：ポート番号

o：優先度情報

H…High

-…Low

出力メッセージ

メッセージID
内容
出力先

KFCA00611-E
コマンド引数の指定が誤っています
標準エラー出力

KFCA00620-E
namnldspコマンド実行中にエラーが発生しました
標準エラー出力

KFCA33609-I
ヘルプメッセージ
標準出力
標準エラー出力

KFCA33611-E
メモリ不足が発生しました
標準エラー出力

KFCA33612-E
ノードリストファイルへのアクセスでエラーが発生しました
標準エラー出力

注意事項

このコマンドは，オンライン処理への影響を極力抑えるため，ノードリストファイルの排他処理は行わずに情報を参照します。このため，タイミングによってはノードリスト情報の一部が表示されない場合があります。その際には再度コマンドを実行してください。

namsvinf

名称

OpenTP1のサーバ情報の表示

形式

namsvinf ｛-b｜〔-r〕〔-w 最大応答待ち時間〕｝〔-x〕

機能

システム共通定義のall_nodeオペランド，およびall_node_exオペランドに指定されたOpenTP1ノードに対して起動確認をして，起動結果およびOpenTP1の情報（IPアドレス，およびネームサービスのポート番号）を表示します。

ノード自動追加機能を使用しているノードでは，ノードリストおよびシステム共通定義のall_node_exオペランドに登録されているOpenTP1ノードに対して起動確認をしてから，起動結果およびOpenTP1の情報（IPアドレス，およびネームサービスのポート番号）を表示します。なお，エージェントノードがマネジャノードからノードリストを受信できていない状態では，ノードリスト要求の送信先ノード（システム共通定義のname_manager_nodeオペランドに指定されたノード）に登録されているOpenTP1ノードに対して起動確認をして，起動結果およびOpenTP1の情報（IPアドレス，およびネームサービスのポート番号）を表示します。

オプション

●-b

起動確認のための通信をしないで，共用メモリ上のRPC抑止リストの登録状況を出力します。登録状況に対する出力内容は次のとおりです。

RPC抑止リストに登録：D

RPC抑止リストに未登録：A

このオプションは，-rまたは-wオプションと同時には指定できません。指定した場合はエラーとなります。

このオプションを省略した場合は起動確認のための通信をします。ネームサービス定義のname_global_lookupオペランドにYが指定されているときはグローバル検索の範囲まで起動確認をします。

●-r

起動確認を終えたOpenTP1ノードから順に出力します。

このオプションは，-bオプションと同時には指定できません。指定した場合はエラーとなります。

このオプションを省略した場合，すべてのOpenTP1ノードの起動結果がそろった時点で一括して起動結果を出力します。

●-w　最大応答待ち時間　　～〈符号なし整数〉((0～3600))《8》（単位：秒）

all_nodeオペランドに指定したOpenTP1ノードで起動するOpenTP1にall_node情報取得要求を送信してから，応答が返るまでの待ち時間および起動確認の応答待ち時間の最大値を指定します。-wオプションを指定した場合，最大応答待ち時間の値は省略できません。最大応答待ち時間内に応答が返ってこないOpenTP1ノードの起動状況は「S（送信可能）」となります。

このオプションを-bオプションと同時には指定できません。指定した場合はエラーとなります。

すべてのオプションを省略した場合，起動確認のための通信をして，すべてのノードの起動確認結果がそろった時点で起動結果を一覧表示します。

●-x

ノード自動追加機能に関連する情報を表示します。このオプションは，ノード自動追加機能を使用しているマネジャノード，およびエージェントノードで実行できます。ノード自動追加機能を使用していないOpenTP1ノードで実行した場合はエラーとなり，KFCA33602-Eメッセージが出力されます。

出力形式

●すべてのオプションを省略した場合

1，および2：それぞれ1行で表示します。

2：起動確認の対象となるノードが複数ある場合，ノードの数だけ繰り返し表示します。

情報は，すべてのノードの起動確認が完了した時点で一括して出力します。そのため，出力するまでのノードの状態によっては時間が掛かることがあります。

-bオプションと-rオプションの指定を共に省略すると，起動確認が完了するまでは，確認の進ちょく状況を示すメッセージを標準出力に出力します。コマンド入力からノード情報出力終了までの流れを次に示します。

コマンド入力

「namsvinf:asking node information...」を出力

「namsvinf:checking alive...」を出力

ノード情報出力開始

ノード情報出力終了

a：ネームサービス定義のname_global_lookupオペランドの指定（YまたはN）（1文字）

bb：表示ノード情報識別子（2文字）

EX…コマンドを実行したノードのall_node_exオペランドに指定されたノード情報

空白…all_nodeオペランドに指定されたノード情報

△H…all_nodeオペランドにサービス情報優先度指定キーワードが指定されたノード情報（△：空白）

ccc.ccc.ccc.ccc：ff...ffのIPアドレス（10進ドット記法）
10進ドット記法への変換失敗時は，***.***.***.***を出力します。

ddddd：ff...ffのポート番号（5文字）

yyyy/mm/dd hh:mm:ss.mmmmmm：起動通知時刻（年/月/日/時:分:秒.マイクロ秒）

e：ff...ffの起動状況（1文字）

A…正常稼働

D…未起動

S…送信可能

-bオプション指定時は，all_nodeオペランドに指定されたノードの起動状況としてAまたはDを表示します。all_node_exオペランドに指定されたノードの起動状況は表示しません。

ff...ff：コマンドを実行したノードのall_nodeオペランドに指定されたノード名（255文字以内）

gggg：ff...ffのall_nodeオペランドに指定されたOpenTP1ノードの項番（4文字）
左側に表示されるIPアドレス（ccc.ccc.ccc.ccc）ごとに任意の項番を割り当てます。

hhh.hhh.hhh.hhh：ccc.ccc.ccc.cccに指定されたall_nodeオペランドのIPアドレス（10進ドット記法）
10進ドット記法への変換失敗時は，***.***.***.***を出力します。

iiiii：ccc.ccc.ccc.cccに指定されたall_nodeオペランドに指定されたノードのポート番号（5文字）

j：ccc.ccc.ccc.cccに指定されたall_nodeオペランドのノードの起動状況（1文字）

A…正常稼働

D…未起動

S…送信可能

kk...kk：ccc.ccc.ccc.cccに指定されたall_nodeオペランドのノード名（255文字以内）
ノード名の取得に失敗した場合は，*を64文字出力します。

bb～ff...ffに表示されるノード情報が同一の場合は，2行目以降のbb～ff...ffは空白となります。

gggg～kk...kkは，次のどれかの場合に空白となります。

ff...ffに指定されたall_nodeオペランドにノード名が未指定の場合。

name_global_lookupオペランドにNが指定されている場合。

namsvinfコマンドで表示するノードの起動状況※がD（未起動）またはS（送信可能）の場合。

注※

namsvinfコマンドが表示するノードの起動状況については，表13-10を参照してください。

コマンドを実行したノードのall_nodeオペランドのノード情報を表示したあとにall_node_exオペランドのノード情報を表示します。

namsvinfコマンドが表示するノードの起動状況

namsvinfコマンドが表示する起動状況は，-bオプションの指定の有無によって意味が異なります。それぞれの起動状況を表示する主な要因を-bオプションの指定の有無に分けて，次の表に示します。

表13-10　namsvinfコマンドが表示するノードの起動状況

-bオプションの指定有無
表示する起動状況
起動状況を表示する主な要因

-bオプションの指定を省略した場合
A（正常稼働）
結果表示されたノードがこの機能をサポートしているバージョンのノードであり，起動確認のメッセージの送信が正常に終了し，かつ，応答メッセージの受信が正常に終了したため，正常に稼働している状態と判断できたことを示します。

D（未起動）
結果表示されたノードへの起動確認のメッセージを送信しましたが，通信障害，送信先が未起動などの要因で正しく送信できなかったため，正常に稼働している状態と判断できなかったことを示します。

S（送信可能）
起動確認のメッセージの送信は正常に終了しましたが，応答メッセージが受信できなかったため，送信可能状態と判断したことを示します。
次のどちらかの要因が考えられます。

結果表示されたノード上で動作しているOpenTP1がこの機能をサポートしていないバージョンである。

結果表示されたノードからの応答メッセージが通信障害などの要因で正常に受信できない，または，受信応答待ち時間を満了した状態である。

-bオプションを指定した場合
（起動確認のための通信は行いません）
A（正常稼働）
結果表示されたノードはRPC抑止リストに登録されていません。

D（未起動）
結果表示されたノードがRPC抑止リストに登録されています。

空白
結果表示されたノードはall_node_exオペランドに指定されています。

-rオプションおよび-wオプションの指定の有無によって，起動状況の表示が変わることはありません。ただし，-wオプションの指定値が小さい場合，受信時間を満了したとき起動状況の表示が変わることがあります。

●-rオプションを指定した場合

オプションをすべて省略した場合と出力レコードのフォーマットは同じですが，起動確認の完了のたびにノード情報を表示するため，レコードの表示順序は不定となります。bb～ff...ff部分は全レコード分を表示します。

●-xオプションを指定した場合

1，および2：それぞれ1行で表示します。

2：起動確認の対象となるノードが複数ある場合，ノードの数だけ繰り返し表示します。

a：ネームサービス定義のname_global_lookupオペランドの指定（YまたはN）（1文字）

mm....mm：自ノードの動作モード

MANAGER…マネジャノード

AGENT…エージェントノード

pppp/pp/pp pp:pp:pp：自ノードのノードリストの最終更新時刻（年/月/日 時:分:秒）

nnn：ノードリストに登録されているノード数

bb：表示ノード情報識別子（2文字）

EX…コマンドを実行したノードのall_node_exオペランドに指定されたノード情報

空白…ノードリストに登録されているノードリスト情報

ccc.ccc.ccc.ccc：ff...ffのIPアドレス（10進ドット記法）
10進ドット記法への変換失敗時は，***.***.***.***を出力します。

ddddd：ff...ffのポート番号（5文字）

yyyy/mm/dd hh:mm:ss.mmmmmm：起動通知時刻（年/月/日/時:分:秒.マイクロ秒）

e：ff...ffの起動状況（1文字）

A…正常稼働

D…未起動

S…送信可能

-bオプション指定時は，all_nodeオペランドに指定されたノードの起動状況としてAまたはDを表示します。all_node_exオペランドに指定されたノードの起動状況は表示しません。

o：自ノードのノードリストに登録されているノードの動作モード

M…マネジャノード

A…エージェントノード

N…ノーマルノード

*…システム共通定義のname_manager_nodeオペランドに指定されたノードをマネジャノードと認識していない

空白…コマンドを実行したノードのall_node_exオペランドに指定されたノード

qqqq/qq/qq qq:qq:qq：マネジャノードのノードリストに登録された時刻（年/月/日 時:分:秒）

ff...ff：コマンドを実行したノードのall_nodeオペランドに指定されたノード名（255文字以内）

gggg：ff...ffのall_nodeオペランドに指定されたノードの項番（4文字）
左側に表示されるIPアドレス（ccc.ccc.ccc.ccc）ごとに任意の項番を割り当てます。

hhh.hhh.hhh.hhh：ccc.ccc.ccc.cccに指定されたall_nodeオペランドのIPアドレス（10進ドット記法）
10進ドット記法への変換失敗時は，***.***.***.***を出力します。

iiiii：ccc.ccc.ccc.cccに指定されたall_nodeオペランドに指定されたノードのポート番号（5文字）

j：ccc.ccc.ccc.cccに指定されたall_nodeオペランドのノードの起動状況（1文字）

A…正常稼働

D…未起動

S…送信可能

kk...kk：ccc.ccc.ccc.cccに指定されたall_nodeオペランドのノード名（255文字以内）
ノード名の取得に失敗した場合は，*を64文字出力します。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA33619-E | ネームサービス起動中のため，(namsvinf)コマンドが受け付けられません | 標準エラー出力

注意事項

ノード自動追加機能を使用している場合，エージェントノードがマネジャノードからノードリストを受信できていない状態でnamsvinfコマンドを実行したとき，ノードリスト要求送信先ノード（システム共通定義のall_nodeオペランドに指定されたノード）が表示されます。

namunavl

名称

OpenTP1起動通知情報の強制的無効化

形式

namunavl ｛ -l ｜ 〔-g〕-n "ノード名"〔,"ノード名"…〕｝

機能

このオペランドの引数に指定したノード上で起動するOpenTP1からの起動通知情報を，強制的に無効化します。このコマンドを使用すると，通信先からの起動通知を受け取らない場合でも，コマンド実行後は新たにコネクションを確立し直すため，正常に通信できるようになります。

オプション

●-l

このオプションが指定された場合，OpenTP1起動時に通信障害となって起動通知できなかったIPアドレスを出力します。出力されたIPアドレスには起動通知されていないため，そのIPアドレスで起動するOpenTP1では正常に通信できなくなる場合があります。その場合には，通信できなくなったOpenTP1でnamunavlコマンドを実行する必要があります。

起動通知が通信障害となっているかどうかは，システムログ中のKFCA00642-Wメッセージが出力されているかどうかで判断できます。

●-g

このオプションが指定された場合，再確認メッセージ（KFCA00644-R）の出力を抑止します。

●-n "ノード名"〔,"ノード名"…〕　　～〈1～255文字の識別子〉

起動通知された情報（通知時刻）を無効化するOpenTP1が起動するノード名を指定します。このオプションを省略することはできません。また，繰り返して指定することもできません。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA33619-E | ネームサービス起動中のため，(namunavl)コマンドが受け付けられません | 標準エラー出力

注意事項

namunavlコマンドは，システム共通定義のname_notifyオペランドの値とは関係なく，OpenTP1動作中にだけ実行できます。

namunavlコマンドに指定できるノード名は，実行するノードでのシステム共通定義のall_nodeオペランドまたはall_node_exオペランドに指定されているノードだけです。誤って現在通信しているOpenTP1のノード名を指定した場合には，正常に通信できなくなることがあるので注意してください。

正常に動作中のノード，または正常に通信できるノードをnamunavlコマンドの-nオプションの引数に設定しないでください。ノードA上で正常に動作中のノードBをnamunavlコマンドの-nオプションの引数に指定した場合，ノードB上で，namunavlコマンドの-nオプションにノードAを指定して実行してください。

同じIPアドレスを使用するノードをシステム共通定義のall_nodeオペランド，またはall_node_exオペランドに複数指定している場合，それらのノードをnamunavlコマンドに指定しないでください。

ノード自動追加機能を使用しているノードでnamunavlコマンドに指定できるノード名は，ノードリストに登録されているIPアドレス，およびシステム共通定義のall_node_exオペランドに登録されているノードだけです。

prcdlpath

名称

UAP共用ライブラリのサーチパス名の変更

形式

prcdlpath {-d | 追加パス名〔:追加パス名〕…}

機能

サービス関数動的ローディング機能に使用するUAP共用ライブラリのサーチパスに指定した追加パス名を追加し，サーチパス名を変更します。

このコマンドを実行すると，サーチパス変更前のユーザサーバと，サーチパス変更後に起動されたユーザサーバが併存することになります。このような状態が望ましくない場合は，ユーザが責任を持って，該当するユーザサーバを終了してから，サーチパスを変更してください。

オプション

●-d

prcdlpathコマンドで設定した追加パス名を無効化します。

コマンド引数

●追加パス名　～〈パス名〉

追加パス名を指定します。追加パス名は，絶対パスで指定してください。

追加パス名は，複数指定できます。複数の追加パス名を指定するときは，追加パス名と追加パス名との間を':'で区切ります。

なお，環境変数を使用した場合は，環境変数展開後の追加パス名で最大255文字指定できます。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA00710-E | 共用メモリを使用できません | 標準エラー出力
KFCA00712-E | 予期しないエラーが発生しました | 標準エラー出力
KFCA00735-E | サーチパスの保存に失敗しました | 標準エラー出力
KFCA00750-E | メモリ不足です | 標準エラー出力
KFCA00751-E | コマンドの文法が間違っています | 標準エラー出力
KFCA00755-E | プロセス間通信ができません | 標準エラー出力
KFCA00756-E | 引数が誤っています | 標準エラー出力
KFCA00757-E | ファイルがありません | 標準エラー出力
KFCA00758-E | ディレクトリではありません | 標準エラー出力
KFCA00774-I | メッセージヘルプ | 標準出力

注意事項

prcdlpathコマンドで指定する追加パス名は，OSのライブラリサーチパス（環境変数）の先頭に追加される形で，この環境変数に設定されます。このため，サービス関数動的ローディング機能でUAP共用ライブラリを検索する場合，prcdlpathコマンドで指定した追加パス名が示すディレクトリを最初に検索します。この場合，そのディレクトリにUAP共用ライブラリがなかったとき，サーチパスに元々設定されていたディレクトリに存在する，UAP共用ライブラリが読み込まれることがあります。

prcdlpathコマンドで指定した追加パス名が有効になるUAPは，SPPとMHPだけです。

prcdlpathコマンドで指定した追加パス名が有効になる範囲は，UAPプロセスの起動時から終了時までです。
次に，ライブラリサーチパスを読み込むときの例を示します。この例では，OpenTP1のサービス関数動的ローディング機能を使用してlibusr.soを読み込もうとすると，(b)のlibusr.soが読み込まれます。

（例）

UAP共用ライブラリが存在するディレクトリ：

　　/OpenTP1/aplib/libusr.so　…(a)

　　/usr/aplib/libusr.so　…(b)

OSのライブラリサーチパス（環境変数）：/OpenTP1/aplib

prcdlpathコマンドで設定した追加パス名：/usr/aplib

OpenTP1の誤動作を避けるために，追加パス名が示すディレクトリに存在するライブラリ名が，OpenTP1が提供するライブラリ群（$DCDIR/libの下）のライブラリ名と重複しないようにしてください。

prcdlpathコマンドを繰り返し実行した場合，有効になる追加パス名は最後に実行したprcdlpathコマンドで設定した追加パス名だけです。以前にprcdlpathコマンドで設定した追加パス名に加えて，新たに追加パスを設定したい場合は，prcdlpathlsコマンドで現在設定されているパスを確認し，そのパスを追加パス名に含めた上で，再度prcdlpathコマンドを実行してください。

prcdlpathls

名称

prcdlpathコマンドで指定したサーチパス名の表示

形式

prcdlpathls

機能

prcdlpathコマンドで指定したサーチパス名を表示します。

なお，次のときは，何も表示されません。

prcdlpathコマンドの実行前

prcdlpathコマンドに-dオプションを付けて実行したあと

出力形式

aa...aa

aa...aa：prcdlpathコマンドで指定したサーチパス

出力メッセージ

メッセージID | 内容 | 出力先
KFCA00710-E | 共用メモリを利用できません | 標準エラー出力
KFCA00712-E | 予期しないエラーが発生しました | 標準エラー出力
KFCA00750-E | メモリ不足です | 標準エラー出力
KFCA00751-E | コマンドの文法が間違っています | 標準エラー出力
KFCA00755-E | プロセス間通信ができません | 標準エラー出力
KFCA00756-E | 引数が誤っています | 標準エラー出力
KFCA00775-I | メッセージヘルプ | 標準出力

prckill

名称

OpenTP1のプロセスの強制停止

形式

prckill プロセスID〔プロセスID〕…

機能

プロセスをユーザサービス定義，またはユーザサービスデフォルト定義のprc_abort_signalオペランドで指定したシグナル番号で強制停止します。

コマンド引数

●プロセスID

停止させるプロセスのプロセスIDを指定します。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA00710-E | 共用メモリを使用できません | 標準エラー出力
KFCA00712-E | 予期しないエラーが発生しました | 標準エラー出力
KFCA00750-E | メモリ不足です | 標準エラー出力
KFCA00751-E | prckillコマンドの形式が誤っています | 標準エラー出力
KFCA00760-E | プロセスID，またはステータスが不正です | 標準エラー出力
KFCA00794-I | メッセージヘルプ | 標準出力

注意事項

場合によっては，prc_abort_signalオペランドで指定したシグナル番号以外で，プロセスが異常終了することがあります。

prcls

名称

サーバの状態表示

形式

prcls 〔｛-a
       ｜-g サービスグループ名
       ｜-l 実行形式ファイル名
       ｜-s サーバ名
       ｜-p プロセスID
       ｜-x ｝〕

機能

指定したサーバの状態を標準出力に出力します。

オプション

●-a

すべてのサーバの状態を表示します。

●-g　サービスグループ名　　～〈1～31文字の識別子〉

サービスグループ名で指定したサーバの状態を表示します。

●-l　実行形式ファイル名　　～〈1～14文字の識別子〉

実行形式ファイル名で指定したサーバの状態を表示します。

●-s　サーバ名　　～〈1～8文字の識別子〉

サーバ名で指定したサーバの状態を表示します。

●-p　プロセスID　　～〈符号なし整数〉

プロセスIDで指定したサーバの状態を表示します。

上記オプションの指定をすべて省略すると，プロセスサービスが管理しているユーザサーバの状態が表示されます。

●-x

ユーザサーバのプロセスごとのサービス実行状態を表示します。

出力形式

●-xオプションを指定した場合

aa....aa：プロセスID（10けた以内）

bb...bb：サーバ名（8文字以内）

cc...cc：サービス関数が呼び出されたときの時刻
サービス関数を実行するたびに時刻を更新します。時刻は，1970年1月1日0時0分0秒からの通算秒を，TZ環境変数に合わせて表示しています。このプロセスが1回もサービス関数を実行していない場合，表示は次のようになります。

Thu Jan  1 09:00:00 1970　（TZ環境変数がJST-9の場合）

dd...dd：サービス関数がリターンしたときの時刻
サービス関数を実行するたびに時刻を更新します。時刻は，1970年1月1日0時0分0秒からの通算秒を，TZ環境変数に合わせて表示しています。このプロセスが1回もサービス関数を実行していない場合，表示は次のようになります。

Thu Jan  1 09:00:00 1970　（TZ環境変数がJST-9の場合）

ee...ee：プロセスが起動されてからの，サービス関数の通算実行回数
4294967295回を超えた場合は0に戻ります。

●-xオプション以外を指定した場合

a：サーバの状態

D…サーバ開始処理中，または終了処理中

L…サーバ実行中

＊…デバッガプロセス

bb...bb：プロセスID（10けた以内）

cc...cc：ユーザID（10けた以内）
プロセスサービスから生成された子プロセス以外のプロセスの場合は，'＊'が表示されます。

dd...dd：グループID（10けた以内）
プロセスサービスから生成された子プロセス以外のプロセスの場合は，'＊'が表示されます。

ee...ee：サーバ名（8文字以内）

ff...ff：実行形式ファイル名（14文字以内）

utodbgpp…該当するサーバと連動しているデバッガの実行形式ファイル

gg...gg：サービスグループ名（31文字以内）

出力メッセージ

メッセージID | 内容 | 出力先
KFCA00710-E | 共用メモリを利用できません | 標準エラー出力
KFCA00712-E | 予期しないエラーが発生しました | 標準エラー出力
KFCA00750-E | メモリ不足です | 標準エラー出力
KFCA00751-E | prclsコマンドの形式が誤っています | 標準エラー出力
KFCA00752-E | 実行形式ファイル名が誤っています | 標準エラー出力
KFCA00753-E | サーバ名が誤っています | 標準エラー出力
KFCA00754-E | プロセスIDが誤っています | 標準エラー出力
KFCA00759-E | サービスグループ名が誤っています | 標準エラー出力
KFCA00791-I | ヘルプメッセージ | 標準出力

注意事項

-xオプションの指定は，TP1/Extension 1をインストールしていることが前提です。TP1/Extension 1をインストールしていない場合の動作は保証できませんので，ご了承ください。

prcpath

名称

ユーザサーバ，およびユーザサーバから起動されるコマンドのサーチパス名の変更

形式

prcpath 変更パス名〔:変更パス名〕…

機能

ユーザサーバプロセスを起動するときに使用するサーチパス，およびユーザサーバから起動されるコマンドに使用するサーチパスを，指定した変更パス名に変更します。

prcpathコマンドを実行すると，サーチパス変更前のユーザサーバと，サーチパス変更後に起動されたユーザサーバが併存することになります。このような状態が望ましくない場合は，ユーザが責任を持って，該当するユーザサーバを終了してから，サーチパスを変更してください。

コマンド引数

●変更パス名　～〈パス名〉

サーチパス名を指定します。サーチパス名は，絶対パスで指定してください。

複数のサーチパス名を指定できます。複数のサーチパス名を指定するときは，サーチパス名とサーチパス名との間を':'で区切ります。また，追加する場合は，既存のパスを含めて指定してください。

なお，指定できるサーチパス名の長さは，':'を含めて255文字までです。

補足

現在稼働中のユーザサーバがあるディレクトリとは別のディレクトリ下に，新しいユーザサーバを作る場合の手順を次に示します。

現在稼働中のユーザサーバをdcsvstopコマンドで終了します。

別のディレクトリ下にユーザサーバを設定します。

prcpathコマンドで新しいディレクトリにパスを変更します。

新しいユーザサーバをdcsvstartコマンドで起動します。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA00710-E | 共用メモリを利用できません | 標準エラー出力
KFCA00712-E | 予期しないエラーが発生しました | 標準エラー出力
KFCA00729-E | サーチパスの保存に失敗しました | 標準エラー出力
KFCA00750-E | メモリ不足です | 標準エラー出力
KFCA00755-E | プロセス間通信ができません | 標準エラー出力
KFCA00756-E | 引数が誤っています | 標準エラー出力
KFCA00757-E | ファイルがありません | 標準エラー出力
KFCA00758-E | ディレクトリではありません | 標準エラー出力
KFCA00792-I | ヘルプメッセージ | 標準出力

prcpathls

名称

ユーザサーバ，およびユーザサーバから起動されるコマンドのサーチパス名の表示

形式

prcpathls

機能

ユーザサーバプロセスを起動するときに使用するサーチパス，およびユーザサーバから起動されるコマンドに使用するサーチパスを標準出力に出力します。

出力形式

aa...aa

aa...aa：ユーザサーバのサーチパス名

出力メッセージ

メッセージID | 内容 | 出力先
KFCA00710-E | 共用メモリを利用できません | 標準エラー出力
KFCA00712-E | 予期しないエラーが発生しました | 標準エラー出力
KFCA00750-E | メモリ不足です | 標準エラー出力
KFCA00755-E | プロセス間通信ができません | 標準エラー出力

prctctrl

名称

prcteeプロセスの停止と再開始

形式

prctctrl　｛-e | -s｝〔-i 確認間隔〕 〔-c 確認回数〕

機能

prcteeプロセスの停止や停止後の再開始を行います。prcteeプロセスは，OpenTP1の標準出力，標準エラー出力のリダイレクトを行う常駐プロセスです。$DCDIR/bin/prcoutに定義しているオプションで起動します。

prcteeプロセスを停止したり，再開始したりする場合，-iオプションに指定した確認間隔で，-cオプションに指定した回数だけ，prcteeプロセスが停止または再開始したかどうかを確認します。指定どおりに確認しても停止，または再開始が確認できなかった場合は，KFCA00773-Eメッセージ（要因：TIME_OUT）を出力し，確認を終了します。

prcteeプロセスについては，13章の「prctee」を参照してください。

オプション

●-e

prcteeプロセスを停止します。

●-s

prcteeプロセスを再開始します。

●-i　確認間隔　　～〈符号なし整数〉((1～60))《1》（単位：秒）

prcteeプロセスが停止，または再開始したかどうかを確認する間隔を指定します。

●-c　確認回数　　～〈符号なし整数〉((1～60))《10》

prcteeプロセスが停止，または再開始したかどうかを確認する回数を指定します。

注意事項

このコマンドはスーパユーザで実行してください。なお，実行時には環境変数DCDIR，環境変数DCCONFPATHを設定してください。

このコマンドでprcteeプロセスが出力するOpenTP1の標準出力，および標準エラー出力のファイル出力先を変更できます。詳細については，「3.5　標準出力ファイルに関する運用」を参照してください。

オンライン中でも，このコマンドを実行するとprcteeプロセスを停止できますが，停止中に出力したメッセージはなくなります。したがって，このコマンドは，メッセージが頻繁に出力されないタイミングを選んで実行してください。

このコマンドでprcteeプロセスを停止させたあとに，次に示す操作のどれかを実行すると，prcteeプロセスは再開始されます。

OpenTP1の開始

OpenTP1の停止

dcsetupコマンド

dcresetコマンド

dcsetupコマンドに-dオプションを指定して実行（-nオプションを指定，または問合せにnを指定）したあとの環境で，このコマンドに-sオプションを指定して実行した場合，確認間隔×確認回数経過後にKFCA00773-Eメッセージ（要因：TIME_OUT）を出力してエラーとなります。

prctee

名称

OpenTP1の標準出力，標準エラー出力のリダイレクト

形式

prctee　〔ファイル長　出力ファイル名〕

機能

OpenTP1の標準出力，標準エラー出力をファイル出力し，世代管理します。

コマンド引数

●ファイル長　　～〈符号なし整数〉((10～65535))《1024》

標準出力，標準エラー出力をするファイル長をキロバイト単位で指定します。

指定した出力長を基に2世代管理をします。メッセージの出力内容によっては出力ファイル長が指定値を超える場合があります。0を指定した場合，2世代管理はしないで単調増加ファイルとなります。

●出力ファイル名　　～〈パス名〉

標準出力，標準エラー出力をするファイル名を絶対パス名で指定します。世代管理をする場合は，ファイル名のあとに"1"または"2"が付加されます。

ファイル名を省略すると$DCDIR/spool/prclog1と$DCDIR/spool/prclog2が作成されます。

注意事項

このコマンドは，コマンドラインやシェルから実行しないで，必ず$DCDIR/bin/prcoutに指定し，dcsetupコマンドまたはprctctrlコマンドで実行してください。prcteeコマンドをコマンドラインやシェルから実行した場合，OpenTP1の標準出力および標準エラー出力の欠落など，正しくメッセージが出力されないおそれがあります。$DCDIR/bin/prcoutの詳細な指定方法については，「3.5　標準出力ファイルに関する運用」を参照してください。

dcsetupコマンドまたはprctctrlコマンドを実行すると，$DCDIR/bin/prcoutに定義されたprcteeコマンドが実行され，OpenTP1の標準出力および標準エラー出力をリダイレクトするprcteeプロセス（常駐プロセス）が開始されます。

prcoutファイルを修正する場合は，dcsetupコマンドまたはprctctrlコマンド実行前に/BeTRAN/bin下にあるprcoutファイルを直接変更してください。dcsetupコマンドまたはprctctrlコマンド実行後にOpenTP1ホームディレクトリ/bin下のprcoutファイルを修正しても有効となりません。

コマンド引数のファイル長と出力ファイル名を省略する場合は，両方を省略してください。片方だけ省略することはできません。

標準出力，標準エラー出力は，プロセスでパイプを使用して受け取るため，高負荷で書き込みを繰り返し行うとメッセージが破棄されることがあります。

prfed

名称

トレース情報ファイルの編集出力

形式

prfed 〔-d〕 〔-m〕 〔-v〕 〔-T 〔開始時刻〕〔,終了時刻〕〕 〔-r ランID〕
     〔-p プロセスID〔,プロセスID〕…〕
     〔トレースデータファイル名〔 トレースデータファイル名〕…〕

機能

prfトレース情報を入力し，トレース情報を編集出力します。

オプション

●-d

詳細情報をダンプ形式で出力します。

-vオプションと同時に指定した場合，詳細情報はアスキー文字列および16進数字でそれぞれ出力します。ただし，アスキー文字列はダブルクォーテーション（"）で囲み，印字できない文字はピリオド（.）で表示します。また，詳細情報のアスキー文字列にダブルクォーテーション（"）が現れるごとに，ダブルクォーテーション（"）を１文字追加出力します。

●-m

TP1/Message QueueのイベントIDの情報を出力します。

●-v

編集結果をcsv形式で出力します。

●-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からの西暦を4けたで指定します）

指定を省略できます。※

注※

開始，または終了の「年」の指定を省略した場合は，当年の指定月日時刻と見なされます。「年，月，日」の指定を省略した場合，当年当月当日の指定時刻と見なされます。「月，日」，「月」，または「日」だけを省略することはできません。省略した場合はオプションエラーになります。「月」または「日」を省略したい場合は，「年」，「月」，「日」のすべてを省略してください。

-Tオプションの指定を省略すると，指定したファイル内のすべての情報を編集出力します。

●-r　ランID

指定されたランIDを持つ情報だけ編集出力します。

●-p　プロセスID

指定されたプロセスIDの情報だけ編集出力します。プロセスIDは複数指定できます。

コマンド引数

●トレースデータファイル名　　～〈パス名〉

prfgetコマンドで取り出したトレースデータが格納されているファイルを指定します。トレースデータファイル名を指定しない場合，標準入力からデータを入力します。また，複数のノードで取得されたトレースデータファイルを同時に指定した場合は，取得時刻順に並べ替えて出力することができます。

出力形式

●オプションを省略した場合

各出力項目の説明は，次に示す「-dオプションを指定した場合」を参照してください。

●-dオプションを指定した場合

トレースデータとしてLCK性能検証用トレース情報ファイル，およびTRNイベントトレース情報ファイルを指定した場合の出力形式を次に示します。

LCK性能検証用トレース情報ファイルを指定した場合の出力形式

TRNイベントトレース情報ファイルを指定した場合の出力形式

1，および2：1行で表示します。

aaa：レコード状態（3文字）

Rec…正常レコード

Err…エラーレコード

bbbb：ノードID（4文字以内）

cc....cc：ランID（16進10けた（先頭の0xを含む））

dd....dd：トレース情報を取得したプロセスのプロセスID（10進10けた以内）

eeeee：該当プロセスでのトレース通番（10進5けた以内）

ffffff：イベントID（16進6けた（先頭の0xを含む））

gggg：トレースを取得した時刻（年）

hh：トレースを取得した時刻（月）

ii：トレースを取得した時刻（日）

jj：トレースを取得した時刻（時）

kk：トレースを取得した時刻（分）

ll：トレースを取得した時刻（秒）

mmm：トレースを取得した時刻（ミリ秒）

nnn：トレースを取得した時刻（マイクロ秒）

ooo：トレースを取得した時刻（ナノ秒）

AA....AA：イベントの発生したサーバ名（8文字以内）

pp....pp：リターンコード（10進11けた以内（先頭の符号を含む））

qqqq：クライアントOpenTP1識別子（4文字以内）

rr....rr：クライアント通信番号（16進10けた（先頭の0xを含む））

ssss：サーバOpenTP1識別子（4文字以内）

tttt：ルートOpenTP1識別子（4文字以内）

uu....uu：ルート通信番号（16進10けた（先頭の0xを含む））

vv....vv：サービスグループ名（32文字以内）

ww....ww：サービス名（32文字以内）

xx....xx：グローバルトランザクションID（128文字以内）
該当するイベントIDを取得していない場合は，'＊'で表示されます。

y：ダンプ情報

BB....BB：イベント種別（32文字以内）
trn_prf_event_trace_conditionオペランドにxafuncを指定した場合は，XA関数名が出力されます。trn_prf_event_trace_conditionオペランドにtrnserviceを指定した場合は，次に示すイベント種別が出力されます。

イベント | タイミング | イベント種別
トランザクション管理サービス | 開始中 | trnd starting
開始完了 | trnd started
終了中 | trnd ending
終了完了 | trnd ended
トランザクション回復サービス | 開始中 | trnrvd starting
開始完了 | trnrvd started
回復開始 | trnrvd recovery started
回復終了 | trnrvd recovery ended
終了中 | trnrvd ending
終了完了 | trnrvd ended
リソースマネジャ監視サービス | 開始中 | trnrmd starting
開始完了 | trnrmd started
終了中 | trnrmd ending
終了完了 | trnrmd ended

CCC：取得タイミング（3文字以内）

DD....DD：リソースマネジャ名＋リソースマネジャ拡張子（33文字以内）

EE....EE：OpenTP1がリソースマネジャに対して割り当てたトランザクション識別子（16進80けた）

FF....FF：内部コード1（6文字以内）

GGGG：内部コード2（4文字以内）

HH....HH：リソースマネジャ名（10文字以内）

III：排他要求元種別（3文字）

UAPからの排他要求時：usr

OpenTP1内部での排他要求時：dam，tam，mqaまたはtrn

JJ....JJ：排他資源名称（16文字以内）

KK：排他制御モード（2文字）

LL....LL：要求種別（20文字以内）

MM....MM：オプションフラグ（25文字以内）

NN....NN：内部情報1（16文字）

OO....OO：内部情報2（16文字）

PP....PP：内部情報3（16進10けた（先頭の0xを含む））

注　トレースで取得されていない項目は'＊'で表示されます。

●-mオプションを指定した場合

1，および2：1行で表示します。

aaa：レコード状態（3文字）

Rec…正常レコード

Err…エラーレコード

bbbb：ノードID（4文字以内）

cc....cc：ランID（16進10けた（先頭の0xを含む））

dd....dd：トレース情報を取得したプロセスのプロセスID（10進10けた以内）

eeeee：該当プロセスでのトレース通番（10進5けた以内）

ffffff：イベントID（16進6けた（先頭の0xを含む））

gggg：トレースを取得した時刻（年）

hh：トレースを取得した時刻（月）

ii：トレースを取得した時刻（日）

jj：トレースを取得した時刻（時）

kk：トレースを取得した時刻（分）

ll：トレースを取得した時刻（秒）

mmm：トレースを取得した時刻（ミリ秒）

nnn：トレースを取得した時刻（マイクロ秒）

ooo：トレースを取得した時刻（ナノ秒）

AA....AA：イベントの発生したサーバ名（8文字以内）

pp....pp：リターンコード（10進11けた以内（先頭の符号を含む））

qqqq：クライアントOpenTP1識別子（4文字以内）

rr....rr：クライアント通信番号（16進10けた（先頭の0xを含む））

ssss：サーバOpenTP1識別子（4文字以内）

tttt：ルートOpenTP1識別子（4文字以内）

uu....uu：ルート通信番号（16進10けた（先頭の0xを含む））

vv....vv：サービスグループ名（32文字以内）

ww....ww：サービス名（32文字以内）

xx....xx：グローバルトランザクションID（128文字以内）※

zz....zz：キュー名（48文字以内）※

BB....BB：メッセージ識別子（16進66けた（先頭の0xを含む））※

CC....CC：メッセージトークン（16進18けた（先頭の0xを含む））※

y：ダンプ情報

注　トレースで取得されていない項目は'＊'で表示されます。

注※　該当するイベントIDを取得していない場合は，'＊'で表示されます。

●-vオプションを指定した場合

各出力項目の説明は，あとに示す「-dオプション，-mオプション，および-vオプションを指定した場合」を参照してください。

●-dオプションおよび-vオプションを指定した場合

各出力項目の説明は，あとに示す「-dオプション，-mオプション，および-vオプションを指定した場合」を参照してください。

●-mオプションおよび-vオプションを指定した場合

各出力項目の説明は，あとに示す「-dオプション，-mオプション，および-vオプションを指定した場合」を参照してください。

●-dオプション，-mオプション，および-vオプションを指定した場合

1，および2：1行で表示します。

2：トレースを取得したレコードごとに表示されます。

aaa：レコード状態（3文字）

Rec…正常レコード

Err…エラーレコード

bbbb：ノードID（4文字以内）

cc....cc：ランID（16進10けた（先頭の0xを含む））

dd....dd：トレース情報を取得したプロセスのプロセスID（10進10けた以内）

eeeee：該当プロセスでのトレース通番（10進5けた以内）

ffffff：イベントID（16進6けた（先頭の0xを含む））

gggg：トレースを取得した時刻（年）

hh：トレースを取得した時刻（月）

ii：トレースを取得した時刻（日）

jj：トレースを取得した時刻（時）

kk：トレースを取得した時刻（分）

ll：トレースを取得した時刻（秒）

mm....mm：トレースを取得した時刻（ナノ秒）

nn....nn：イベントの発生したサーバ名（8文字以内）

oo....oo：リターンコード（10進11けた以内（先頭の符号を含む））

pppp：クライアントOpenTP1識別子（4文字以内）

qq....qq：クライアント通信番号（16進10けた（先頭の0xを含む））

rrrr：サーバOpenTP1識別子（4文字以内）

ssss：ルートOpenTP1識別子（4文字以内）

tt....tt：ルート通信番号（16進10けた（先頭の0xを含む））

uu....uu：サービスグループ名（32文字以内）

vv....vv：サービス名（32文字以内）

ww....ww：グローバルトランザクションID（128文字以内）
該当するイベントIDを取得していない場合は，'＊'で表示されます。

xx....xx：キュー名（48文字以内）

yy....yy：メッセージ識別子（16進66けた（先頭の0xを含む））

zz....zz：メッセージトークン（16進18けた（先頭の0xを含む））

AA....AA：詳細情報のアスキー文字列（256文字以内）

BB....BB：詳細情報の16進数字列（8文字ごとの△（半角スペース）を含み，575文字以内）
なお，トレースデータとしてTRNイベントトレース情報ファイルを指定した場合の詳細情報の構成は，次の表に示すとおりです。

項目 | 位置 | 長さ（バイト）
保守情報1 | 0 | 4
保守情報2 | 4 | 4
保守情報3 | 8 | 4
保守情報4 | 12 | 4
保守情報5 | 16 | 4
リソースマネジャ名＋リソースマネジャ拡張子 | 20 | 36
トランザクション識別子 | 56 | 40
イベント種別※ | 96 | 2
取得タイミング0x10：IN，0x20または0x30：OUT | 98 | 1
保守情報6 | 99 | 9
保守情報7 | 108 | 4
保守情報8 | 112 | 16

注※

イベント種別は，次の表に示すとおりです。なお，表に記載されていないイベント種別は，OpenTP1保守情報です。

イベント種別 | イベント名称
0x1001 | trnd starting
0x1002 | trnd started
0x1003 | trnrmd starting
0x1004 | trnrmd started
0x1005 | trnrvd starting
0x1006 | trnrvd started
0x1007 | trn preending
0x1008 | trn preended
0x1009 | trnd ending
0x100a | trnd ended
0x100b | trnrmd ending
0x100c | trnrmd ended
0x100d | trnrvd ending
0x100e | trnrvd ended
0x100f | trnrvd recover started
0x1010 | trnrvd recover ended
0x2001 | xa_open
0x2002 | xa_close
0x2003 | xa_start
0x2004 | xa_end
0x2005 | xa_rollback
0x2006 | xa_prepare
0x2007 | xa_commit
0x2008 | xa_recover
0x2009 | xa_forget
0x200a | xa_complete
0x200b | ax_reg
0x200c | ax_unreg
0x2021 | xa_done
0x2022 | xa_ready
0x2023 | xa_start_2
0x2024 | xa_wait
0x2025 | xa_wait_recovery
0x2041 | ax_add_branch
0x2042 | ax_commit
0x2043 | ax_done
0x2044 | ax_end
0x2045 | ax_forget_branch
0x2046 | ax_get_branch_info
0x2047 | ax_prepare
0x2048 | ax_ready
0x2049 | ax_recover
0x204a | ax_reg_2
0x204b | ax_rollback
0x204c | ax_set_branch_info
0x204d | ax_start
0x204e | ax_start_2
0x3000 | dc_trn_begin
0x3001 | dc_trn_chained_commit
0x3002 | dc_trn_chained_rollback
0x3003 | dc_trn_unchained_commit
0x3004 | dc_trn_unchained_rollback
0x3005 | dc_trn_get_xid
0x3006 | dc_trn_info
0x4000 | tx_begin
0x4001 | tx_commit
0x4002 | tx_open
0x4003 | tx_close
0x4004 | tx_rollback
0x4005 | tx_info
0x4006 | tx_set_commit_return
0x4007 | tx_set_transaction_control
0x4008 | tx_set_transaction_timeout
0x5000 | trncmt
0x5001 | trnrbk
0x5002 | trnfgt
0x5003 | trnstics

注　トレースで取得されていない項目は'＊'で表示されます。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA26750-E | コマンドが実行できませんでした | 標準エラー出力
KFCA26751-E | コマンドの形式が誤っています | 標準エラー出力
KFCA26760-E | prfトレースファイルのオープンに失敗しました | 標準エラー出力
KFCA26761-E | prfトレースファイルをアクセス中に障害が発生しました | 標準エラー出力
KFCA26762-E | prfトレースファイルをアクセス中にデータ不正を検出しました | 標準エラー出力
KFCA26770-I | ヘルプメッセージ | 標準出力

注意事項

このコマンドの使用は，TP1/Extension 1をインストールしていることが前提です。TP1/Extension 1をインストールしていない場合の動作は保証できませんので，ご了承ください。

オプションを省略した場合の出力形式で示されている表示例では，1レコード当たり4行で出力されているように見えますが，実際は2行で出力されています。このため，使用中のターミナルモードによっては表示がずれることがあります。このようなときは，vt100などのカラム数が80けたのターミナルモードで使用してください。

-dオプションを指定した場合の出力形式で示されている表示例のダンプデータ部分は，システムまたはユーザによる固有データが含まれないレコードでは出力されません。

次に示すトレースは，プロセス内で同一のトレース番号を使用します。このため，これらのトレースだけをコマンドで編集すると，「出力形式」に出力される該当プロセスでのトレース通番（eeeee）は連番とならないことがあります。

性能検証用トレース

XAR性能検証用トレース

JNL性能検証用トレース

LCK性能検証用トレース

MCF性能検証用トレース

TRNイベントトレース

NAMイベントトレース

プロセスサービスイベントトレース

FILイベントトレース

トレース情報の詳細については，マニュアル「OpenTP1 解説」を参照してください。

prfedコマンドの引数に，2ギガバイトを超えるトレースデータファイルを指定しないでください。2ギガバイトを超えるトレースデータファイルを編集する場合は，次に示す方法でprfedコマンドを実行してトレースファイルを編集してください。

標準入力からトレースデータを入力する場合

prfget 〔-a〕> prfトレース収集ファイル

cat prfトレース収集ファイル | prfed 〔各オプション〕 > トレース編集結果ファイル

prfトレースファイル取得ディレクトリ（$DCDIR/spool/dcprfinf）下で実行する場合

prfgetコマンドを使用しないで，直接，prfトレースファイルを入力する方法です。直接，prfトレースファイルを入力するため，OpenTP1の停止後に実行してください。OpenTP1の起動中に実行した場合，prfトレースデータの入力でエラーになることがあります。

cd $DCDIR/spool/dcprfinf

prfed 〔各オプション〕 prfトレースファイル〔 prfトレースファイル....〕

prfget

名称

トレース情報ファイルの取り出し

形式

prfget 〔-a〕 〔-f ｛_tr｜_nm｜_xr｜_pr｜_mc｜_fl｜_jl｜_lk｝〕

機能

prfトレースファイルに格納されているトレース情報を取り出します。取り出す範囲は，前回取り出したトレース情報の次のトレース情報からコマンドが入力された時点までになります。

オプション

●-a

prfトレースファイルに格納されているすべてのトレース情報を取り出します。通常は，いちばん新しいランIDで，取り出されていないトレース情報だけが取り出されますが，このオプションを指定することで，古いランIDを持つトレース情報を取り出すことができます。

●-f　｛_tr｜_nm｜_xr｜_pr｜_mc｜_fl｜_jl｜_lk｝

イベントトレース情報を取得します。

　_tr：TRNイベントトレース情報を取得します。

　_nm：NAMイベントトレース情報を取得します。

　_xr：XARイベントトレース情報を取得します。

　_pr：プロセスサービスのイベントトレース情報を取得します。

　_mc：MCF性能検証用トレース情報を取得します。

　_fl：FILイベントトレース情報を取得します。

　_jl：JNL性能検証用トレース情報を取得します。

　_lk：LCK性能検証用トレース情報を取得します。

イベントトレース情報を取り出す場合以外は，このオプションを指定しないでください。また，このオプションには_tr，_nm，_xr，_pr，_mc，_fl，_jlまたは_lk以外は指定しないでください。イベントトレース情報の取り出し方法については，マニュアル「OpenTP1 解説」の，イベントトレースについての説明を参照してください。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA26750-E | コマンドが実行できませんでした | 標準エラー出力
KFCA26751-E | コマンドの形式が誤っています | 標準エラー出力
KFCA26760-E | prfトレースファイルのオープンに失敗しました | 標準エラー出力
KFCA26761-E | prfトレースファイルをアクセス中に障害が発生しました | 標準エラー出力
KFCA26762-E | prfトレースファイルをアクセス中にデータ不正を検出しました | 標準エラー出力
KFCA26771-I | ヘルプメッセージ | 標準出力

注意事項

このコマンドの使用は，TP1/Extension 1をインストールしていることが前提です。TP1/Extension 1をインストールしていない場合の動作は保証できませんので，ご了承ください。

前回取り出した情報の次の情報が失われている場合は，取り出していないいちばん古い情報からコマンドが入力された時点までが対象になります。

prfgetコマンドは，トレース情報の取り出しに成功すると，引き継ぎファイル※を作成することで最終位置を記憶します。そのため，引き継ぎファイルの作成に失敗すると，すでに取り出したトレース情報を取り出すことがあります。

prfgetコマンドが動作中に，並行してprfgetコマンドを動作させることはできません。

注※

引き継ぎファイルの内容は，最後に出力したprfファイルのファイルヘッダと同一の内容になっています。

queinit

名称

メッセージキュー用物理ファイルの割り当て

形式

queinit 〔-r〕 〔-s レコード長〕 〔-n レコード数〕 物理ファイル名

機能

メッセージキューサービスがメッセージキューとして使用する物理ファイルを割り当てます。

queinitコマンドを入力する前にOpenTP1ファイルシステムを初期設定していない場合は，初期設定してください。

オプション

●-r

指定したファイルがすでにあり，再び物理ファイルを割り当てるときに指定します。このオプションの指定を省略すると，指定したファイルがすでにあった場合，エラーになります。

●-s　レコード長

～((ファイルシステム初期設定時に指定したセクタ長～32768（32K）バイトで，セクタ長の倍数))《2048》（単位：バイト）

レコード長を指定します。

●-n　レコード数　　～((1～262144))《4096》

レコード長に指定した長さのレコード領域を，何レコード分確保するかを指定します。

コマンド引数

●物理ファイル名　　～〈パス名〉

物理ファイルとして割り当てるファイル名を完全パス名で指定します。

quels

名称

キューグループの状態表示

形式

quels 〔-f〕 〔-q メッセージキューサービス名〕 〔キューグループID〕

機能

キューグループごとに，物理ファイル，およびキューファイルの状態を標準出力に出力します。ただし，quelsコマンドを入力する前に，メッセージキューサービスが起動されている必要があります。

オプション

●-f

キューグループごとに，キューファイルの状態を表示するときに指定します。

このオプションの指定を省略すると，物理ファイルの状態だけが表示されます。

●-q　メッセージキューサービス名　　～〈識別子〉《que》

状態を表示するキューグループIDを管理しているメッセージキューサービスの名称を指定します。

コマンド引数

●キューグループID　　～〈識別子〉

状態を表示するキューグループIDを指定します。

このコマンド引数の指定を省略すると，-qオプションで指定したメッセージキューサービスが管理するすべてのキューグループの状態が表示されます。

出力形式

1：-fオプションがあるときだけ，キューファイル数分繰り返し表示されます。

aaaaaaaa：キューグループID

bbbb：物理ファイルのレコード長

cccc：物理ファイルのレコード数

dddd：使用中のレコード数

eeee：未使用のレコード数

ff....ff：物理ファイルのパス名

gg：キューファイルのレコード数が物理ファイルのレコード数に占める割合（％）（小数点以下切り捨て）

hhhh：キューファイル中の保持メッセージ数

iii：キューファイル中の取り出し待ちメッセージ数

jjj：キューファイル中の仕掛り中のメッセージ数

kk：キューファイル中のREADY状態のメッセージ数

llllllll：キューファイル名

出力メッセージ

メッセージID
内容
出力先

KFCA01323-E
コマンド引数の指定が誤っています
標準エラー出力

KFCA01324-E
キューグループIDの形式が誤っています
標準エラー出力

KFCA01325-E
指定したキューグループIDはありません
標準エラー出力

KFCA01326-E
メモリ不足です
標準エラー出力

KFCA01329-I
ヘルプメッセージ
標準出力，
標準エラー出力

KFCA01339-E
メッセージキューサービス名の指定が誤っています
標準エラー出力

KFCA01360-E
プログラムに異常が発生しました
標準エラー出力，
メッセージログファイル

KFCA01361-E
実行環境が整っていません
標準エラー出力

querm

名称

メッセージキュー用物理ファイルの削除

形式

querm 物理ファイル名

機能

queinitコマンドで，メッセージキュー用に割り当てた物理ファイルを削除します。

ただし，指定した物理ファイルがオンラインで使用中の場合は，削除できません。この場合，エラーメッセージが出力されます。

コマンド引数

●物理ファイル名　　～〈パス名〉

削除する物理ファイルの名称を完全パス名で指定します。

rapdfgen

名称

リモートAPI機能に使用する定義の自動生成

形式

rapdfgen rapリスナーサービス定義ファイル名 ｜ -m rapクライアントマネジャサービス定義ファイル名

機能

リモートAPI機能を実行するために必要な定義を生成します。

ユーザ作成のrapリスナーサービス定義に対してこのコマンドを実行すると，rapリスナー用ユーザサービス定義とrapサーバ用ユーザサービス定義を，$DCCONFPATH下に出力します。また，ユーザ作成のrapクライアントマネジャサービス定義に対してこのコマンドを実行すると，rapクライアントマネジャ用ユーザサービス定義を$DCCONFPATH下に出力します。rapリスナーサービス定義，およびrapクライアントマネジャサービス定義の詳細については，マニュアル「OpenTP1 システム定義」を参照してください。

それぞれの出力ファイル名を次に示します。

rapリスナー用ユーザサービス定義：rapリスナーサービス定義名

rapサーバ用ユーザサービス定義：rapリスナーサービス定義名+S

rapクライアントマネジャ用ユーザサービス定義：rapクライアントマネジャサービス定義名

オプション

●-m rapクライアントマネジャサービス定義ファイル名　　～〈パス名〉

rapクライアントマネジャサービス定義を格納しているファイル名を指定します。

rapクライアントマネジャサービス定義ファイル名は1から8文字の識別子です。完全パス名で指定されていない場合(先頭が'/'で始まらない場合)の定義ファイルの格納先は，カレントディレクトリであると仮定されます。

コマンド引数

●rapリスナーサービス定義ファイル名　　～〈パス名〉

rapリスナーサービス定義を格納しているファイル名を指定します。

rapリスナーサービス定義ファイル名は1から7文字の識別子です。完全パス名で指定されていない場合(先頭が'/'で始まらない場合)の定義ファイルの格納先は，カレントディレクトリであると仮定されます。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA26911-E | rapdfgenコマンドでエラーが発生しました | 標準エラー出力
KFCA26912-E | 定義の指定値に誤りがあります | 標準エラー出力
KFCA26919-I | rapdfgenコマンドの使用方法 | 標準出力

注意事項

rapリスナーサービス定義およびrapクライアントマネジャサービス定義は，$DCCONFPATH下には置かないでください。これらの定義ファイルは，rapdfgenコマンドの入力となる定義ファイルであり，$DCCONFPATH下に置いた場合，コマンドによって作成されたrapリスナー用ユーザサービス定義またはrapクライアントマネジャ用ユーザサービス定義に上書きされてしまいます。$DCCONFPATH下に置いた場合の動作は保証しません。

rapdfgenコマンドによって作成されたrapリスナー用ユーザサービス定義，rapサーバ用ユーザサービス定義，およびrapクライアントマネジャ用ユーザサービス定義は，$DCCONFPATH下にあることを前提としているため，$DCCONFPATH下から$DCUAPCONFPATH下に移動しないでください。$DCUAPCONFPATH下に移動した場合の動作は保証しません。

rapls

名称

rapリスナーおよびrapサーバの状態表示

形式

rapls rapリスナー名 〔〔rapリスナー名〕…〕

機能

指定したrapリスナーおよびrapサーバの情報を，標準出力に出力します。

コマンド引数

●rapリスナー名

状態を表示したいrapリスナー名を指定します。

出力形式

aa...aa：rapリスナー名（7文字以内）

bbbb：rapリスナーの状態

Init…サービス開始中

Serv…サービス中

Term…サービス終了中

ccccc：ポート番号

ddd：稼働中のサーバ数

eee：稼働中のサーバ数のうち現在サービス実行中のサーバ数

ff...ff：コネクト中のクライアント数

ggg：稼働中のリカバリ用待機サーバ数

hhh：稼働中のリカバリ用待機サーバ数のうち，現在サービス実行中のサーバ数

iiiii：サーバのプロセスID

j：サーバの実行状態

I…サーバ開始中または再開始処理中

F…未スケジュール

S…サービス実行中

T…サーバ終了処理中

k：サーバのトランザクションモード

T…トランザクションモード

－…非トランザクションモード

l：サーバのRPC実行モード

－…通常RPC実行モード

C…連鎖RPC実行モード

mmm.mmm.mmm.mmm：該当するサーバでサービス中のクライアントのIPアドレス

yyyy/mm/dd HH:MM:SS：各処理時刻

なお，サーバの実行状態が'S'（サービス実行中）以外の場合，サーバ割り当て時刻およびサーバ最終要求受付時刻には'----/--/-- --:--:--'が表示されます。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA26911-E | コマンド実行中に障害が発生しました | 標準エラー出力
KFCA26922-I | raplsコマンドの使用方法 | 標準出力
KFCA27750-E | コマンド実行中に障害が発生しました | 標準エラー出力
KFCA27751-W | 指定されたrapリスナーは未起動です | 標準エラー出力

rapsetup

名称

リモートAPI機能の実行環境の設定

形式

rapsetup 〔-d〕 〔ユーザプログラムファイルディレクトリ〕

機能

リモートAPI機能を実行するために必要な環境設定をします。

オプション

●-d

OpenTP1実行環境からリモートAPI機能の実行環境を削除します。

コマンド引数

●ユーザプログラムファイルディレクトリ　　～〈パス名〉

ユーザプログラムファイルを格納するディレクトリを指定します。省略した場合は，$DCDIR/aplibが仮定されます。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA26911-E | rapsetupコマンドでエラーが発生しました | 標準エラー出力
KFCA26918-I | rapsetupコマンドの使用方法 | 標準出力

rpcdump

名称

RPCトレースの出力

形式

rpcdump 〔｛-r｜-m｝〕 〔｛-c｜-f｝〕 〔-d 電文長〕
       〔-t 〔開始〕〔,終了〕〕
       〔-s サービスグループ名〔,サービス名〕…〕
       〔-b ノード識別子〔,ノード識別子〕…〕
       〔-v サーバ名〔,サーバ名〕…〕
       〔-p プロセスID〔,プロセスID〕…〕
       〔-x xid〔,xid〕…〕
       〔-n 〔開始トレース番号〕〔,終了トレース番号〕〕
       〔RPCトレースファイル名〕

機能

指定したRPCトレースファイルのトレース情報を編集して，標準出力に出力します。

オプション

●-r

編集した結果をRPCトレースファイルの形式で出力します。

●-m

RPCトレースの概要情報を出力します。

このオプションを指定すると，-c，-f，および-dオプションの指定は無効になります。

●-c

コール元とコール先のコール関係を抽出して編集し，コール関係にあるトレース情報単位に出力します。トレース情報単位の出力順序は，ほかのオプションの出力条件に従って時系列にソートした順序です。

ほかのオプションを指定して抽出されたトレース情報とコール関係にあるトレース情報は，ほかのオプションの出力条件に合わなくても出力されます。

●-f

RPCの一連のフローを抽出して編集し，ネスト関係にあるトレース情報単位に出力します。トレース情報単位の出力順序は，ほかのオプションの出力条件に従って時系列にソートした順序です。

ほかのオプションを指定して抽出されたトレース情報と同一のフロー内のトレース情報は，ほかのオプションの出力条件に合わなくても出力されます。

-c，および-fオプションを両方とも指定をしないと，RPCトレース情報が時系列に表示されます。

●-d　電文長　　～((0～4096))

指定した長さの電文の内容を出力します。

このオプションの指定を省略すると，すべての電文の内容が出力されます。

●-t　〔開始〕〔，終了〕

トレース情報の出力範囲をトレース取得日時で指定します。

開始には，出力を開始する日時を指定します。終了には出力を終了する日時を指定します。

開始，および終了は，1970年1月1日0時0分0秒から当年当月当日の現在時刻までの範囲で指定します。

開始，または終了のどちらか一方を必ず指定してください。開始の指定を省略すると，RPCトレースファイルの先頭から指定した終了時刻までが出力範囲になります。終了の指定を省略すると，指定した開始時刻からRPCトレースファイルの最後までが出力範囲になります。

開始，および終了は，「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からの西暦を4けたで指定します）

指定を省略できます。※

注※

開始，または終了の「年」の指定を省略した場合は，当年の指定月日時刻と見なされます。「年，月，日」の指定を省略した場合，当年当月当日の指定時刻と見なされます。「月，日」，「月」，または「日」だけを省略することはできません。省略した場合はオプションエラーになります。「月」または「日」を省略したい場合は，「年」，「月」，「日」のすべてを省略してください。

-tオプションの指定を省略すると，指定したファイル内のすべての情報を編集出力します。

●-s　サービスグループ名〔，サービス名〕　　～〈1～31文字の識別子〉

特定のサービスのコール先トレース情報も含めたトレース情報を編集して出力する場合，サービスグループ名，およびサービス名を指定します。

サービスグループに複数のサービスを指定できます。複数のサービスを指定する場合，サービス名とサービス名との間をコンマ（，）で区切ります。

サービス名の指定を省略すると，指定したサービスグループのすべてのサービスのトレース情報が編集されて出力されます。

サービス名だけを指定することはできません。

XATMIリクエスト／レスポンス型通信のサービスを指定する場合，サービスグループ名にはSPPのサービス定義で指定した名称を指定します。XATMI会話型通信のサービス名は指定できません。

●-b　ノード識別子　　～〈4文字の識別子〉

指定したノード識別子のOpenTP1ノードで取得したトレース情報を出力します。システム共通定義に指定したノード識別子を指定してください。

複数のノード識別子を指定する場合は，ノード識別子名とノード識別子名との間をコンマ（，）で区切ります。

●-v　サーバ名　　～〈1～8文字の識別子〉

指定したサーバで取得したトレース情報を出力します。

複数のサーバ名を指定する場合は，サーバ名とサーバ名との間をコンマ（，）で区切ります。

●-p　プロセスID　　～((0～2147483647))

指定したプロセスで取得したトレース情報を出力します。

複数のプロセスを指定する場合は，プロセスIDとプロセスIDとの間をコンマ（，）で区切ります。

●-x　xid　　～〈1～8けたの16進数字〉((0～ffffffff))

指定したグローバルトランザクション識別子のシーケンシャル番号のトレース情報が出力されます。

複数のxidを指定する場合は，xidとxidとの間をコンマ（，）で区切ります。

●-n　〔開始トレース番号〕〔，終了トレース番号〕　　～((1～2147483647))

開始トレース番号から終了トレース番号までのトレース情報を出力します。

トレース番号とは，RPCトレースファイル内のトレース情報の通番です。

開始トレース番号の指定を省略すると，RPCトレースファイルの先頭から指定した終了トレース番号までが出力範囲となります。

終了トレース番号の指定を省略すると，指定した開始トレース番号からRPCトレースファイルの最後までが出力範囲となります。

開始トレース番号，または終了トレース番号のどちらか一方は，必ず指定してください。

コマンド引数

●RPCトレースファイル名　　～〈パス名〉

トレース情報を編集するRPCトレースファイルの名称を指定します。次のどれかの名称を指定してください。

システム共通定義，またはユーザサービス定義のrpc_trace_nameで指定したファイルの名称

rpcmrgコマンドの実行結果を格納したファイルの名称

-rオプション指定のrpcdumpコマンドの実行結果を格納したファイルの名称

このコマンド引数の指定を省略すると，$DCDIR/spool/rpctrから編集されて出力されます。

なお，パス名に含まれるRPCトレースファイルの名称（デフォルト：rpctr）の最大長は，13文字です。

出力形式

●-mオプションを指定した場合

1：ノード識別子，サーバ名，サービスグループ名，サービス名で特定されるRPC電文，またはXATMI会話型の電文ごとに概要情報を編集して出力します。

ff...ff：RPCトレースファイルの名称

oo...oo：編集対象となった最も古いトレース情報の日時

nn...nn：編集対象となった最新のトレース情報の日時

aaaa：RPCトレースを取得したノード識別子（4文字）

bb...bb：RPCトレースを取得したサーバ名（8文字以内）

cc...cc：RPC電文受信先のサービスグループ名（31文字以内）
XATMI会話型の電文の場合は'****'が表示されます。

dd...dd：RPC電文受信先のサービス名（31文字以内）
XATMI会話型の電文の場合は'****'が表示されます。

eee：プロセスID（10進数　左詰め）

ff...ff：RPC要求電文，またはXATMI要求電文の送信電文数（10進数　左詰め）

gg...gg：RPC要求電文，またはXATMI要求電文の受信電文数（10進数　左詰め）

hh...hh：RPC応答電文，またはXATMI応答電文の送信電文数（10進数　左詰め）

ii...ii：RPC応答電文，またはXATMI応答電文の受信電文数（10進数　左詰め）

jj...jj：RPCエラー応答電文，またはXATMIエラー電文の送信電文数（10進数　左詰め）

kk...kk：RPCエラー応答電文，またはXATMIエラー電文の受信電文数（10進数　左詰め）

●-r，および-mオプションを両方とも指定しない場合

1：RPC要求電文の送信時，または受信時にだけ表示します。

2：XATMI会話型通信時には，表示されないことがあります。

3：受信側のトレース情報の場合は送信元の情報を，送信側のトレース情報の場合は受信先の情報を表示します。

4：XATMI関数を使用した通信のときだけ表示されます。ただし，電文種別，電文の送信状態によっては表示されない項目があります。

5：電文が終わるまで繰り返し表示します。

6：-dオプションで指定した電文の長さが0の場合は表示されません。

aa...aa ：RPCトレース種別

Send…RPCの要求電文を送信しました

Receive…RPCの要求電文を受信しました

Send-Reply…RPCの応答電文を送信しました

Recv-Reply…RPCの応答電文を受信しました

Send-Error…RPCのエラー応答電文を送信しました

Recv-Error…RPCのエラー応答電文を受信しました

XATMI-R/R-Send…XATMIリクエスト／レスポンス型の要求電文を送信しました

XATMI-R/R-Recv…XATMIリクエスト／レスポンス型の要求電文を受信しました

XATMI-R/R-Send-Reply…XATMIリクエスト／レスポンス型の応答電文を送信しました

XATMI-R/R-Recv-Reply…XATMIリクエスト／レスポンス型の応答電文を受信しました

XATMI-R/R-Send-Error…XATMIリクエスト／レスポンス型のエラー電文を送信しました

XATMI-R/R-Recv-Error…XATMIリクエスト／レスポンス型のエラー電文を受信しました

XATMI-CNV-Send…XATMI会話型の要求電文を送信しました

XATMI-CNV-Recv…XATMI会話型の要求電文を受信しました

XATMI-CNV-Send-Error…XATMI会話型のエラー電文を送信しました

XATMI-CNV-Recv-Error…XATMI会話型のエラー電文を受信しました

bbb：RPCトレースファイル内のトレース通番（10進数）

ccc：ネスト表示（10進数）
RPCネストコールのルートで1を表示し，ネスト数が増えるごとに1を加えた値を表示します。
CUP，他システム，およびTP1/Server Base 03-00以前のシステムからRPCの電文を受信した場合，またはXATMI会話型の電文の場合は，0を表示します。ただし，CUPからトランザクションを起動した場合は，CUPからの要求を受け付けるシステムプロセスからのRPC要求がルートとなり，1を表示します。

dd...dd：サーバ名（8文字以内）
シェル起動SUPの場合は'****'が表示されます。

eeee：OpenTP1ノードのノード識別子（4文字）

fff.fff：RPCトレース取得元のノードアドレス（10進数　左詰め）

ggggg：RPCトレース取得元のプロセスID（10進数　左詰め）

hhhhh：RPCトレース取得元のBSDソケットのポート番号（10進数　左詰め）

ii...ii：RPCトレースファイルに電文を出力した時刻
（xxx.xxx x hh:mm:ss xxxx yyy:zzz）
出力例：Wed Jan 1 12:34:56 2003 789:012
最後の「yyy:zzz」はそれぞれ次の情報を示しています。
yyy：ミリ秒
zzz：マイクロ秒
出力例では，電文を出力した時刻が2003年1月1日水曜日12時34分56.789012秒であることを示しています。

jj...jj：サービスグループ名（31文字以内）

kk...kk：サービス名（31文字以内）

ll...ll：連鎖RPC表示

Chained…連鎖RPC実行中です

Unchained…連鎖RPCではありません

mmm：グローバルトランザクション識別子のシーケンス番号（16進数　左詰め）

nn...nn ：RPCの形態

Reply…同期応答型RPC

Noreply…非応答型RPC

Nowait…非同期応答型RPC

Chained…連鎖RPC

oo：サービス要求のプライオリティ値（10進数　左詰め）

xx...xx：通信相手の表示

Send　source…通信相手はRPC電文を送信（RPCトレース出力元はRPC電文を受信）

Receive　destination…通信相手はRPC電文を受信（RPCトレース出力元はRPC電文を送信）

ppp.ppp：送信元，受信先のノードアドレス（10進数　左詰め）

q：ネットワークの種類

rrrrr：送信元，受信先のBSDソケットのポート番号（10進数　左詰め）

sss：送信元のスレッドID（10進数　左詰め）

ttttt：電文のロケーション（16進数）

uu...uu：1行につき最大16バイトの電文本体（16進数）

vv...vv：電文本体をASCIIコードに変換した表示（16文字以内）
ただし，変換の結果，印字できない文字は，ピリオド（．）で表示します。

AA...AA：XATMIのサービス名（31文字以内）

BB...BB：バッファのタイプ名
X_OCTET，X_COMMON，またはX_C_TYPEのどれかが表示されます。意味については，XATMIのマニュアルを参照してください。

CC....CC：バッファのサブタイプ名（16文字以内）
バッファのタイプがX_OCTETの場合は表示されません。

DD...DD：XATMI関数で指定したtpflagsの値（16進数）
値が0の場合は表示されません。

EE...EE：XATMI関数で発生したエラーコード（tperror）（16進数）

FF...FF：tprecv関数で発生したイベント
TREV_SENDONLY，TREV_SVCERR，TREV_SVCFAIL，TREV_SVCSUCC，またはTREV_DISCONIMMのどれかが表示されます。意味については，XATMIのマニュアルを参照してください。

GG...GG：XATMI会話型通信時のcall description（16進数）

出力メッセージ

メッセージID | 内容 | 出力先
KFCA00308-E | RPCトレースファイルにデータがありません | 標準エラー出力
KFCA00310-E | 指定したRPCトレースファイルはありません | 標準エラー出力
KFCA00312-E | RPCトレースファイルに対するアクセスエラーが発生しました | 標準エラー出力
KFCA00314-I | ヘルプメッセージ | 標準出力
KFCA00352-E | RPCトレースファイルのデータが正しくありません | 標準エラー出力

注意事項

rpcdumpコマンドでRPCトレースを出力すると，受信情報が送信情報より先に出力されることがあります。これは，電文の送信完了後に，送信情報をRPCトレースファイルに書き込んでいるためです。

-t，-s，-b，-v，-p，-n，および-xオプションで指定した条件は，すべてAND条件となります。

rpcdumpコマンドは，RPCトレースファイルを退避するなどして，RPCトレースの書き込みが行われない状態で入力してください。RPCトレース取得中にrpcdumpコマンドを入力すると，タイミングによってはRPCトレースファイルのアクセスエラーが発生する場合があります。これは，RPCトレース編集中にRPCトレース書き込みファイルが切り替わった時に発生します。

システム共通定義，ユーザサービスデフォルト定義，またはユーザサービス定義に指定したrpc_trace_sizeオペランドの指定値よりも大きい電文が送受信された場合，rpcdumpコマンドが何も出力しなかったり，出力情報に抜けがあったりすることがあります。

rpcmrg

名称

RPCトレースのマージ

形式

rpcmrg RPCトレースファイル名 〔RPCトレースファイル名〕…

機能

指定した複数のRPCトレースファイルのトレース情報は時系列に並べられ，RPCトレースファイルの形式で標準出力に出力されます。

指定した複数のRPCトレースファイルに同じトレース情報がある場合は，重複した情報を削除します。

コマンド引数

●RPCトレースファイル名　　～〈パス名〉

マージするRPCトレースファイルの名称を指定します。次のどれかの名称を指定してください。

システム共通定義，またはユーザサービス定義のrpc_trace_nameで指定したファイルの名称

rpcmrgコマンドの実行結果を格納したファイルの名称

-rオプション指定のrpcdumpコマンドの実行結果を格納したファイルの名称

なお，パス名に含まれるRPCトレースファイルの名称（デフォルト：rpctr）の最大長は，13文字です。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA00308-E | RPCトレースファイルにデータがありません | 標準エラー出力
KFCA00310-E | 指定したRPCトレースファイルはありません | 標準エラー出力
KFCA00312-E | RPCトレースファイルに対するアクセスエラーが発生しました | 標準エラー出力
KFCA00350-I | ヘルプメッセージ | 標準出力
KFCA00352-E | RPCトレースファイルのデータが正しくありません | 標準エラー出力

注意事項

各OpenTP1で管理している時刻がずれている場合，実際に取得した順序と異なる順序にトレース情報が並べられることがあります。

次に示す条件を満たす場合，rpcmrgコマンドが何も出力しない，または出力情報に抜けが発生します。
システム共通定義，ユーザサービスデフォルト定義，またはユーザサービス定義に指定したrpc_trace_sizeオペランドの指定値よりも大きい電文が送受信された場合，または指定した複数のRPCトレースファイルにまたがって電文が出力された場合。

rpcstat

名称

一時クローズ処理の実行状態の表示

形式

rpcstat

機能

OpenTP1管理下のプロセスの一時クローズ処理の実行状況を表示します。このコマンドで表示する情報は，統計情報ではなくコマンド入力時点での一時クローズ処理の実行状況です。

出力形式

aa..aa：プロセスID

bb..bb：サーバ名称

cc..cc：プロセス間通信で使用できるソケットの最大数

dd..dd：ソケットの一時クローズ開始数パーセンテージ（単位：%）

ee..ee：ソケットの一時クローズ非対象数パーセンテージ（単位：%）

ff..ff：プロセス間通信で使用中のソケット数

gg..gg：一時クローズ済みソケット数

hh..hh：一時クローズ要求中ソケット数

ii..ii：一時クローズ送信拒否ソケット数

jj..jj：受信用ポート番号

注意事項

シェル起動のSUPの情報は出力されません。

一時クローズ状態確認機能をサポートしていないOpenTP1でこのコマンドを実行すると，すべての値に0が表示されます。

OpenTP1が起動される前であっても，OpenTP1が使用する共用メモリが存在する場合は，このコマンドを使用して情報を出力できます。

rtsedit

名称

RTSログファイルの編集出力

形式

rtsedit ｛〔-m〕｜〔-e 項目ID〔,項目ID〕…〔-q〕〕
       〔-t〔開始時刻〕〔,終了時刻〕〕
       〔-u 編集単位〔-s サーバ名〕〔-v サービス名〕〕
       〔-i 編集時間間隔〕
       〔-o 出力先ファイル名〔-l 行〕〕｝
         RTSログファイル名〔〔△RTSログファイル名〕…〕

機能

RTSログファイルからリアルタイム統計情報を収集し，編集後，CSV形式でファイルまたは標準出力へ出力します。

オプション

●-m

コマンド引数で指定されるRTSログファイルの管理情報を標準出力に出力します。

-mオプションを指定した場合，ほかのオプションは指定できません。

●-e　項目ID　　～〈符号なし整数〉((1000～2147483647))

編集する項目IDを指定します。

項目IDの詳細については，「付録E.5　リアルタイム統計情報」を参照してください。

●-q

-eオプションで指定した項目IDのリアルタイム統計情報が存在しない区間の，項目数，最大値，最小値および平均値に'-'を出力します。

このオプションは，-eオプションを指定した場合だけ有効です。

このオプションの指定を省略した場合，リアルタイム統計情報が存在しない区間に'-'を出力しません。

●-t　〔開始時刻〕〔,終了時刻〕

編集範囲を指定します。開始時刻には，編集対象とするリアルタイム統計情報の開始時刻を指定します。終了時刻には編集対象とするリアルタイム統計情報の終了時刻を指定します。

開始時刻は，1970年1月1日0時0分0秒から当年当月当日の現在時刻までの範囲で指定します。

開始時刻，または終了時刻のどちらか一方を必ず指定してください。開始時刻の指定を省略すると，RTSログファイルの先頭から指定した終了時刻までが出力範囲になります。終了時刻の指定を省略すると，指定した開始時刻からRTSログファイルの最後までが出力範囲になります。

開始時刻，および終了時刻は，「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からの西暦を4けたで指定します）

指定を省略できます。※

注※

開始時刻，または終了時刻の「年」の指定を省略した場合は，当年の指定月日時刻と見なされます。「年，月，日」の指定を省略した場合，当年当月当日の指定時刻と見なされます。「月，日」，「月」，または「日」だけを省略することはできません。省略した場合はオプションエラーになります。「月」または「日」を省略したい場合は，「年」，「月」，「日」のすべてを省略してください。

-tオプションの指定を省略すると，指定したファイル内のすべての情報を編集出力します。

●-u　編集単位　　～〈all〉

編集単位を指定します。

　sys：システム全体で取得したリアルタイム統計情報を編集します。

　svc：サーバ単位，またはサービス単位で取得したリアルタイム統計情報を編集します。

　all：すべてのリアルタイム統計情報（システム全体，全サーバ，および全サービス）を編集します。

●-s　サーバ名　　～〈1～8文字の文字列〉

リアルタイム統計情報を編集したいサーバ，ポート番号，論理端末，または取得対象名1の名称を指定します。

-sオプションの指定は，-uオプションでsvcを指定した場合に有効です。

●-v　サービス名　　～〈1～63文字の文字列〉

リアルタイム統計情報を編集したいサービス，ポート番号，論理端末，または取得対象名2の名称を指定します。

-vオプションの指定は，-uオプションでsvcを指定した場合に有効です。

-uオプション，-sオプション，および-vオプションと編集対象の組み合わせを，以降の表に示します。

表13-11　rtseditコマンドのオプションと編集対象の組み合わせ

-uオプションの指定 | -sオプションの指定 | -vオプションの指定 | 編集対象となるリアルタイム統計情報
sys | － | － | システム全体の統計情報
svc | サーバ名 | サービス名 | 指定したサーバおよびサービスの統計情報
指定を省略 | 指定したサーバの統計情報
ポート番号※ | IPアドレス※ | 指定したサービス情報参照先ノードの統計情報
論理端末名※ | 指定を省略※ | 指定した論理端末の統計情報
指定を省略 | サービス名 | 指定したサービスの統計情報
サービスグループ名※ | 指定したサービスグループの統計情報
指定を省略 | システム全体を除いた，すべての統計情報
all | － | － | すべての統計情報

（凡例）

－：指定できません。

注※

リアルタイム統計情報サービス定義のrtsput定義コマンド，またはrtsstatsコマンドで，-uオプションにobjを指定して登録した取得対象の統計情報を編集対象とする場合の指定方法です。

●-i　編集時間間隔　　～〈符号なし整数〉((10～31536000))

統計情報を編集し，CSVファイルへ出力する間隔を，秒で指定します。

-iオプションの指定を省略した場合，RTSログファイルにリアルタイム統計情報を取得した際の出力時間間隔（リアルタイム統計情報サービス定義のrts_trcput_intervalオペランドの指定値）が-iオプションに仮定されます。

-iオプションの指定を省略して，かつコマンド引数に複数のRTSログファイルを指定した場合は，複数のRTSログファイルへの出力時間間隔のうち，最大値が-iオプションに仮定されます。

-iオプションの指定値による，有効になるCSVファイルへの編集時間間隔の例を，次の表に示します。

表13-12　有効になるCSVファイルへの編集時間間隔の例

例 | RTSログファイルへの出力時間間隔（秒） | -iオプションの指定値 | 有効になる編集時間間隔（秒）
RTSログファイル1 | RTSログファイル2 | RTSログファイル3
例1 | 600 | 300 | 200 | 1000 | 1000
例2 | 600 | 300 | 200 | 100 | 100
例3 | 100 | 200 | 300 | 指定を省略 | 300

RTSログファイルへの出力時間間隔は，-mオプションを指定したrtseditコマンドを実行すると確認できます。

●-o　出力先ファイル名　　～〈1～65文字のパス名〉

編集結果を出力するCSV形式のファイル名を指定します。

このオプションを省略した場合は，標準出力に出力します。

●-l　行　　～〈符号なし整数〉((1024～65535))

1ファイル（-oオプションに指定したCSV形式のファイル）に出力する行数を指定します。

CSV形式のファイルの世代番号は1から999999までです。-lオプションで指定した行数を出力したあとは，CSV形式のファイルの世代番号を1ずつ増加させて出力を続けます。世代番号が999999のファイルに出力したあとは，出力処理を終了します。

-lオプションの指定は，-oオプションを指定した場合に有効となります。

-lオプションの指定を省略した場合，CSV形式のファイルの世代番号を変更しないで，すべてのデータを1ファイルに出力します。

コマンド引数

●RTSログファイル名　　～〈1～65文字のパス名〉

RTSログファイルの名称を指定します。

出力形式

●-mオプションを指定した場合（標準出力）

1：RTSログファイルごとに繰り返し表示します。

aa...aa：読み込んだRTSログファイルの名称

bbbb：ノード識別子

cccc/cc/cc cc:cc:cc：RTSログファイルの更新時間

dd...dd：出力時間間隔
各RTSログファイルの出力時間間隔を秒単位で出力します。

ee...ee：読み込んだRTSログファイルのバージョン番号
バージョンが07-00のTP1/Server Baseで取得したRTSログファイルの場合は"1"が，バージョンが07-01以降のTP1/Server Baseで取得したRTSログファイルの場合は"2"が出力されます。

●-mオプションを指定しない場合（CSV形式）

1，および2：1行で表示します。

2：リアルタイム統計情報を取得しているサーバまたはサービスごとに，統計情報分繰り返し表示します。

aa...aa：読み込んだRTSログファイル名

bbbb/bb/bb bb:bb:bb：出力ファイルの作成時刻

cccc/cc/cc cc:cc:cc：-tオプションで指定した開始時刻
-tオプションの指定を省略した場合は，'-'を表示します。

dddd/dd/dd dd:dd:dd：-tオプションで指定した終了時刻
-tオプションの指定を省略した場合は，'-'を表示します。

ee...ee：編集時間間隔
RTSログファイルへの出力時間間隔と，-iオプションの指定値に基づいた，有効になるCSVファイルへの編集時間間隔

ffff：ノード識別子

gggg/gg/gg gg:gg:gg：リアルタイム統計情報の編集開始時刻

hhhh/hh/hh hh:hh:hh：リアルタイム統計情報の編集終了時刻

ii...ii：編集するサーバの名称
サーバ名に「_SYSTEM」が表示されて，かつサービス名に「△△△△」が表示された場合は，システム全体の統計情報を示します。「----」が表示された場合は，取得対象名1を指定しないで取得したリアルタイム統計情報を示します。

jj...jj：編集するサービスのサービス名
「****」が表示された場合は，サービス以外の処理単位で取得したリアルタイム統計情報を示します。「△△△△」が表示された場合は，サーバ単位で取得したリアルタイム統計情報を示します。「----」が表示された場合は，取得対象名2を指定しないで取得したリアルタイム統計情報を示します。

kk...kk：リアルタイム統計情報種別

ll...ll：項目名

mm...mm：項目ID

nn...nn：項目数
編集対象となるリアルタイム統計情報がない場合※は'-'を表示します。オーバフローが発生した場合は'****'を表示します。

oo...oo：最大値
編集対象となるデータ値がない場合は'-'を表示します。オーバフローが発生した場合は'****'を表示します。

pp...pp：最小値
編集対象となるデータ値がない場合は'-'を表示します。オーバフローが発生した場合は'****'を表示します。

qq...qq：平均値
編集対象となるデータ値がない場合は'-'を表示します。オーバフローが発生した場合は'****'を表示します。

rr...rr：リアルタイム統計情報の単位

vv-rr：バージョン番号－リビジョン番号

注※

次に示す理由で編集対象となるリアルタイム統計情報がない場合に，-eオプションおよび-qオプションを指定したときは，項目数，最大値，最小値および平均値に'-'を表示します。

-iオプションの指定値（編集時間間隔）が，RTSログファイルの出力時間間隔よりも小さい

-iオプションの指定値（編集時間間隔）とRTSログファイルの出力時間間隔は等しいが，リアルタイム統計情報の取得時に遅延が発生したため，編集時間間隔の区間中に編集対象となるデータが存在しなかった

リアルタイム統計情報の出力の一時的な停止や，取得項目の削除によって，リアルタイム統計情報を取得していない区間が存在する

コマンド引数に，取得時間が連続していない複数のRTSログファイルを指定した

出力メッセージ

メッセージID | 内容 | 出力先
KFCA32714-E | プロセスメモリ不足のため処理を続行できません | 標準エラー出力
KFCA32719-E | コマンドの使用方法が不正です | 標準エラー出力
KFCA32720-E | コマンドのオプションに指定された値が不正です | 標準エラー出力
KFCA32721-E | コマンドのコマンド引数の指定値が不正です | 標準エラー出力
KFCA32725-E | ファイル操作でエラーが発生しました | 標準エラー出力
KFCA32726-E | 指定されたファイルはすでに存在します | 標準エラー出力
KFCA32727-E | 指定されたファイルはRTSログファイルではありません | 標準エラー出力
KFCA32728-E | RTSログファイルのV/Rが誤っています | 標準エラー出力
KFCA32729-E | 出力ファイルの世代数の限度を超えたので終了します | 標準エラー出力
KFCA32730-E | RTSログファイルへアクセス中に不正データを検出しました | 標準エラー出力
KFCA32731-E | 指定されたファイルは存在しません | 標準エラー出力
KFCA32735-I | ヘルプメッセージ | 標準出力
KFCA32744-E | ファイルに対するアクセス権がありません | 標準エラー出力
KFCA32745-E | 指定されたファイル名に誤りがあります | 標準エラー出力
KFCA32759-E | RTSログファイルの内容が重複しているため編集できません | 標準エラー出力

注意事項

バージョンが07-00のTP1/Server Baseで取得したRTSログファイルを指定して編集した場合，ジャーナル情報のwrite（項目ID：1104）およびread（項目ID：1107）の最大値，最小値，および平均値を'-'ではなく0で出力します。

バージョンが07-00のTP1/Server Baseで取得したRTSログファイルとバージョンが07-01以降のTP1/Server Baseで取得したRTSログファイルを混在させ，RTSログファイルの出力時間間隔よりも長い間隔に編集する場合，ジャーナル情報のwrite（項目ID：1104）およびread（項目ID：1107）の最小値は0が出力されます。また，平均値は実際の値よりも小さくなることがあります。

コマンド引数に運用中のRTSログファイルを指定した場合，正しい情報が出力されないことがあります。

KFCA32729-Eメッセージが出力された場合は，-lオプションの指定値を大きくするか，またはコマンド引数に指定したRTSログファイルの個数を減らしたあとで，rtseditコマンドを再実行してください。

異なるOpenTP1システム上で取得したRTSログファイルを複数指定する場合，ノードIDが同一のRTSログファイルは指定しないでください。ノードIDが同一のRTSログファイルを指定すると，ノードIDが同一の統計情報として編集するか，またはKFCA32759-Eメッセージを出力してコマンドの処理を終了します。

次に示す条件での，RTSログファイル，-tオプションおよび-iオプションの指定の関係を次の図に示します。

RTSログファイルの出力時間間隔：30分

-tオプションの指定値：084500,105500

図13-3　RTSログファイルとオプションの指定の関係

rtsls

名称

リアルタイム統計情報の標準出力への出力

形式

rtsls 〔-c〕〔-n 世代番号〕〔-m〕〔-l〕
     〔-e 項目ID〔,項目ID〕…
    ｜ -u 出力単位〔-s サーバ名〕〔-v サービス名〕〕

機能

RTSサービス用の共用メモリ上に取得した，リアルタイム統計情報サービスの管理情報，およびリアルタイム統計情報を，標準出力に出力します。

出力するリアルタイム統計情報については，「付録E.5　リアルタイム統計情報」を参照してください。

オプション

●-c

標準出力へのリアルタイム統計情報の出力をCSV形式で行います。

●-n　世代番号　　～〈符号なし整数〉((1～3))

出力するリアルタイム統計情報の，RTSサービス用の共用メモリの世代番号を指定します。

-nオプションの指定を省略した場合，取得が終了している世代番号の統計情報を出力します。

●-m

リアルタイム統計情報サービスの管理情報を標準出力に出力します。

●-l

リアルタイム統計情報を取得しているサービス名および項目IDの一覧を出力します。

●-e　項目ID　　～〈符号なし整数〉((1000～2147483647))

出力するリアルタイム統計情報の項目IDを指定します。

項目IDについては，「付録E.5　リアルタイム統計情報」を参照してください。

●-u　出力単位　　～〈all〉

出力単位を指定します。

　sys：システム全体で取得したリアルタイム統計情報を出力します。

　svc：サーバ単位，またはサービス単位で取得したリアルタイム統計情報を出力します。

　all：すべてのリアルタイム統計情報（システム全体，全サーバ，および全サービス）を出力します。

●-s　サーバ名　　～〈1～8文字の文字列〉

リアルタイム統計情報を出力したいサーバ，ポート番号，論理端末，または取得対象名1の名称を指定します。

-sオプションの指定は，-uオプションでsvcを指定した場合に有効です。

●-v　サービス名　　～〈1～63文字の文字列〉

リアルタイム統計情報を出力したいサービス，ポート番号，論理端末，または取得対象名2の名称を指定します。

-vオプションの指定は，-uオプションでsvcを指定した場合に有効です。

-uオプション，-sオプション，および-vオプションと出力対象の組み合わせを，以降の表に示します。

表13-13　rtslsコマンドのオプションと出力対象の組み合わせ

-uオプションの指定 | -sオプションの指定 | -vオプションの指定 | 出力対象となるリアルタイム統計情報
sys | － | － | システム全体の統計情報
svc | サーバ名 | サービス名 | 指定したサーバおよびサービスの統計情報
指定を省略 | 指定したサーバの統計情報
ポート番号※ | IPアドレス※ | 指定したサービス情報参照先ノードの統計情報
論理端末名※ | 指定を省略※ | 指定した論理端末の統計情報
指定を省略 | サービス名 | 指定したサービスの統計情報
サービスグループ名※ | 指定したサービスグループの統計情報
指定を省略 | システム全体を除いた，すべての統計情報
all | － | － | すべての統計情報

（凡例）

－：指定できません。

注※

リアルタイム統計情報サービス定義のrtsput定義コマンド，またはrtsstatsコマンドで，-uオプションにobjを指定して登録した取得対象の統計情報を出力対象とする場合の指定方法です。

-eオプション，または-uオプションの指定を省略すると，-uオプションでallを指定したと仮定されます。

出力形式

●-mオプションを指定した場合

出力形式を次に示します。

-mオプションおよび-cオプションを指定したときの出力形式を次に示します（CSV形式）。

aaaa：OpenTP1のノード識別子

bbbbbbbb：RTSサービス用の共用メモリの識別子（10進数）

cccccccccc：RTSサービス用の共用メモリの番号（10進数）

ddddd：リアルタイム統計情報サービスの状態

START：開始状態

eeee：最大取得サービス数（10進数）
リアルタイム統計情報サービス定義のrts_service_maxオペランドで指定した最大取得サービス数を表示します。

ffff：統計情報を取得中のサービス数（10進数）

gggg：未使用のサービス数（10進数）
リアルタイム統計情報サービス定義のrts_service_maxオペランドで指定した最大取得サービス数から，統計情報を取得中のサービス数を引いた値を表示します。

hhhh：最大取得項目数（10進数）
リアルタイム統計情報サービス定義のrts_item_maxオペランドで指定した最大取得項目数を表示します。

iiiiii：取得時間間隔（10進数）

jjj：スワップメッセージの出力要否

YES：スワップメッセージを出力する

NO：スワップメッセージを出力しない

kk：RTSサービス用の共用メモリの，統計情報の取得領域の世代数（10進数）

ll：統計情報を取得中の，RTSサービス用の共用メモリの，統計情報の取得領域の世代番号（10進数）

mmmm/mm/mm mm:mm:mm：統計情報の取得開始時間
統計情報の取得を開始していない場合は，'-'を表示します。

nnnn/nn/nn nn:nn:nn：統計情報の取得終了時間
統計情報取得を終了していない場合は，'-'を表示します。

ooo：RTSログファイルへの出力要否

YES：RTSログファイルに出力する

NO：RTSログファイルに出力しない

ppppppp：RTSログファイルのサイズ（10進数）

qq：RTSログファイルの世代数（10進数）

rr：統計情報を出力中のRTSログファイルの世代番号（10進数）

ss....ss：RTSログファイル名

●-lオプションを指定した場合

出力形式を次に示します。

-lオプションおよび-cオプションを指定したときの出力形式を次に示します（CSV形式）。

1：データのタイトル部分を表示します。

2：リアルタイム統計情報を取得しているサーバまたはサービス分繰り返し表示します。

aaaa：OpenTP1のノード識別

bb....bb：サーバ名
サーバ名に「_SYSTEM」が表示されて，かつサービス名に「△△△△」が表示された場合は，システム全体の統計情報を示します。「----」が表示された場合は，取得対象名1を指定しないで取得したリアルタイム統計情報を示します。

cc....cc：サービス名
「****」が表示された場合は，サービス以外の処理単位で取得したリアルタイム統計情報を示します。「△△△△」が表示された場合は，サーバ単位で取得したリアルタイム統計情報を示します。「----」が表示された場合は，取得対象名2を指定しないで取得したリアルタイム統計情報を示します。

dddd：取得中のリアルタイム統計情報の項目数（10進数）

eeee：未使用項目数（10進数）
リアルタイム統計情報サービス定義のrts_item_maxオペランドで指定した最大取得項目数から，取得中のリアルタイム統計情報の項目数を引いた値を表示します。

ffffffffff：取得中のリアルタイム統計情報の項目ID（10進数）

●-eオプションを指定した場合

出力形式を次に示します。

-eオプションおよび-cオプションを指定したときの出力形式を次に示します（CSV形式）。

1：データのタイトル部分を表示します。

2：項目IDごとにリアルタイム統計情報を取得しているサーバまたはサービス分繰り返し表示します。

aaaa：OpenTP1のノード識別子

bbbb/bb/bb bb:bb:bb：統計情報の取得開始時間

cccc/cc/cc cc:cc:cc：統計情報の取得終了時間

dd....dd：サーバ名
サーバ名に「_SYSTEM」が表示されて，かつサービス名に「△△△△」が表示された場合は，システム全体の統計情報を示します。「----」が表示された場合は，取得対象名1を指定しないで取得したリアルタイム統計情報を示します。

ee....ee：サービス名
「****」が表示された場合は，サービス以外の処理単位で取得したリアルタイム統計情報を示します。「△△△△」が表示された場合は，サーバ単位で取得したリアルタイム統計情報を示します。「----」が表示された場合は，取得対象名2を指定しないで取得したリアルタイム統計情報を示します。

fff：リアルタイム統計情報種別

gg....gg：項目名
CSV形式の場合だけ表示します。

hhhhhhhhhh：項目ID（10進数）

iiiiiiiiii：統計情報の発生件数（10進数）
オーバフローが発生した場合は'****'を表示します。

jjjjjjjjjj：統計情報の最大値（10進数）
データ値がない場合は'-'を表示します。オーバフローが発生した場合は'****'を表示します。

kkkkkkkkkk：統計情報の最小値（10進数）
データ値がない場合は'-'を表示します。オーバフローが発生した場合は'****'を表示します。

llllllllll：統計情報の平均値（10進数）
データ値がない場合は'-'を表示します。オーバフローが発生した場合は'****'を表示します。

mm....mm：リアルタイム統計情報の単位

n：RTSサービス用の共用メモリの，統計情報の取得領域の世代番号

●-uオプションを指定した場合

出力形式を次に示します。

-uオプションおよび-cオプションを指定したときの出力形式を次に示します（CSV形式）。

1：データのタイトル部分を表示します。

2：リアルタイム統計情報を取得しているサーバまたはサービス分繰り返し表示します。

3：サーバまたはサービスで取得しているリアルタイム統計情報分繰り返し表示します。

aaaa：OpenTP1のノード識別子

bbbb/bb/bb bb:bb:bb：統計情報の取得開始時間

cccc/cc/cc cc:cc:cc：統計情報の取得終了時間

dd....dd：サーバ名
サーバ名に「_SYSTEM」が表示されて，かつサービス名に「△△△△」が表示された場合は，システム全体の統計情報を示します。「----」が表示された場合は，取得対象名1を指定しないで取得したリアルタイム統計情報を示します。

ee....ee：サービス名
「****」が表示された場合は，サービス以外の処理単位で取得したリアルタイム統計情報を示します。「△△△△」が表示された場合は，サーバ単位で取得したリアルタイム統計情報を示します。「----」が表示された場合は，取得対象名2を指定しないで取得したリアルタイム統計情報を示します。

fff：リアルタイム統計情報種別

gg....gg：項目名
CSV形式の場合だけ出力します。

hhhhhhhhhh：項目ID（10進数）

iiiiiiiiii：統計情報の発生件数（10進数）
オーバフローが発生した場合は'****'を表示します。

jjjjjjjjjj：統計情報の最大値（10進数）
データ値がない場合は'-'を表示します。オーバフローが発生した場合は'****'を表示します。

kkkkkkkkkk：統計情報の最小値（10進数）
データ値がない場合は'-'を表示します。オーバフローが発生した場合は'****'を表示します。

llllllllll：統計情報の平均値（10進数）
データ値がない場合は'-'を表示します。オーバフローが発生した場合は'****'を表示します。

mm....mm：リアルタイム統計情報の単位

n：RTSサービス用の共用メモリの，統計情報の取得領域の世代番号

出力メッセージ

メッセージID | 内容 | 出力先
KFCA32712-E | リアルタイム統計情報サービスのV/Rが誤っています | 標準エラー出力
KFCA32714-E | プロセスメモリ不足のため処理を続行できません | 標準エラー出力
KFCA32719-E | コマンドの使用方法が不正です | 標準エラー出力
KFCA32720-E | コマンドのオプションに指定された値が不正です | 標準エラー出力
KFCA32722-E | 共用メモリを利用できないため処理を実行できません | 標準エラー出力
KFCA32723-E | リアルタイム統計情報サービスが開始していないため処理を実行できません | 標準エラー出力
KFCA32736-I | ヘルプメッセージ | 標準出力

注意事項

-nオプションで指定した世代番号のリアルタイム統計情報の取得を開始していない場合，リアルタイム統計情報は出力されません。

-nオプションで指定した世代番号のリアルタイム統計情報の取得が終了していない場合は，統計情報取得の開始時間からrtslsコマンドの実行までのリアルタイム統計情報を出力します。

rtssetup

名称

リアルタイム統計情報サービスの実行環境の設定

形式

rtssetup 〔-d 〕〔サーバ格納先パス〕

機能

リアルタイム統計情報サービスを実行するために必要な環境設定をします。

オプション

●-d

OpenTP1実行環境からリアルタイム統計情報サービスの実行モジュール（rtssupおよびrtsspp）および，ユーザサービス定義ファイル（RTSSUPおよびRTSSPP）を削除します。

コマンド引数

●サーバ格納先パス　　～〈パス名〉

リアルタイム統計情報サービスの管理サーバ（RTSSUPおよびRTSSPP）を格納するパスを指定します。

サーバ格納先パスの指定を省略した場合は，$DCDIR/aplibが仮定されます。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA32719-E | コマンドの使用方法が不正です | 標準エラー出力
KFCA32738-I | ヘルプメッセージ | 標準出力
KFCA32739-E | コマンドの実行中にエラーが発生しました | 標準エラー出力

注意事項

次に示すどちらかの場合，rtssetupコマンドは環境設定をしません。

サーバ格納先パスに，rtssetupコマンドが作成する実行モジュール（rtssupおよびrtsspp）と同一名称のファイルやディレクトリがある場合

環境変数$DCCONFPATHで指定したパスに，rtssetupコマンドが作成するユーザサービス定義ファイル（RTSSUPおよびRTSSPP）と同一名称のファイルやディレクトリがある場合

ユーザサービスデフォルト定義のuidオペランドにOpenTP1管理者以外のユーザを指定する場合，リアルタイム統計情報サービス定義のrts_log_file_nameオペランドには，uidオペランドに指定したユーザが書き込み権限を持つパスを指定してください。
リアルタイム統計情報サービスは，どのユーザIDで起動したかには関係なく，RTSログファイルの出力先に対する書き込み権限があれば正常に動作し，権限がなければKFCA32734-Wメッセージを出力してRTSログファイルへの出力機能を停止します。また，rtssetupコマンドで作成する定義ファイル（RTSSUPおよびRTSSPP）にはuidオペランド，およびgroupsオペランドを指定していません。このため，ユーザサービスデフォルト定義にuidオペランド，およびgroupsオペランドが指定されている場合は，指定されたユーザおよびグループでリアルタイム統計情報サービスを起動します。

rtssetupコマンドが作成する実行モジュール（rtssupおよびrtsspp）およびユーザサービス定義ファイル（RTSSUPおよびRTSSPP）は，dcsetupコマンドでは削除できません。dcsetupコマンドを実行して，OpenTP1をOSから削除する前に，rtssetupコマンドで実行モジュールおよびユーザサービス定義ファイルを削除してください。
実行モジュールおよびユーザサービス定義ファイルを残してOpenTP1をOSから削除した場合，再度OpenTP1をOSに登録したあとで，rtssetupコマンドで実行モジュールおよびユーザサービス定義ファイルを削除および作成してください。

rtsstats

名称

リアルタイム統計情報の設定変更

形式

rtsstats｛-a 〔-r〕｜-d ｝
       ｛-u sys｜
         -u srv -s サーバ名｜
         -u svc -s サーバ名 -v サービス名｜
         -u obj 〔-o 取得対象名1〕〔-b 取得対象名2〕｝
        〔-e 項目ID〔,項目ID〕…〕
        〔-f リアルタイム取得項目定義ファイル名〕

機能

リアルタイム統計情報の取得対象および取得項目の設定を変更します。

オプション

●-a

リアルタイム統計情報の取得対象および取得項目を追加します。

●-r

指定したリアルタイム統計情報の取得対象に取得項目を追加する場合に，それまでの取得項目をすべて削除してから新しく取得項目を追加します。

-rオプションの指定を省略すると，それまでの取得項目を継続した上で新しく取得項目を追加します。

●-d

リアルタイム統計情報の取得対象，または取得項目を削除します。

●-u　｛sys｜srv｜svc｜obj｝

設定を変更するリアルタイム統計情報の取得対象の種別を指定します。

sys

システム全体の統計情報として取得する情報を変更します。

sysを指定した場合，リアルタイム統計情報サービス定義で指定したrts_service_maxオペランドの値は消費しません。

srv

指定したサーバの統計情報の設定を変更します。

-sオプションにユーザサーバ名を指定して取得対象を追加した場合，次に示す統計情報を取得します。

サーバ単位での統計情報

指定したユーザサーバのユーザサービス定義のserviceオペランドに定義されているすべてのサービスの統計情報

サービス以外の処理の統計情報

このため，取得対象の数は，serviceオペランドに指定したサービスの数に2を加えたものになります。

システムサーバやSUPなどの，サービスを持たないサーバ名を指定した場合は，サーバ単位の統計情報だけを変更します。

svc

指定したユーザサーバのサービス単位で取得する統計情報を変更します。

obj

-oオプションと-bオプションを組み合わせて，統計情報の取得対象オブジェクトの設定を変更します。

取得対象オブジェクトとオプションの組み合わせについては，-oオプションおよび-bオプションの説明を参照してください。

●-s　サーバ名　　～〈1～8文字で先頭が英字の英数字列〉

設定を変更するサーバの名称を指定します。

-uオプションにsrvまたはsvcを指定した場合，必ず-sオプションを指定してください。-uオプションにsysまたはobjを指定した場合，-sオプションは指定できません。

●-v　サービス名　　～〈1～31文字の識別子〉

設定を変更するサービスの名称を指定します。

-uオプションにsvcを指定した場合，必ず-vオプションを指定してください。-uオプションにsys，srv，またはobjを指定した場合，-vオプションは指定できません。

●-o　取得対象名1　　～〈1～8文字の文字列〉

　-b　取得対象名2　　～〈1～63文字の文字列〉

-uオプションにobjを指定した場合に，設定を変更する取得対象オブジェクト名を指定します。

-oオプションおよび-bオプションで設定を変更できる取得対象オブジェクトを次の表に示します。-uオプションにobjを指定した場合は，必ず次の表に従って指定してください。

表13-14　rtsstatsコマンドのオプションと設定を変更できる取得対象オブジェクト

-oオプションの指定値 | -bオプションの指定値 | 設定を変更できる取得対象オブジェクト
ポート番号※ | IPアドレス※ | 指定したサービス情報の参照先ノード
論理端末名 | 指定を省略 | 指定した論理端末
指定を省略 | サービスグループ名 | 指定したサービスグループ名

注※

システム共通定義のall_nodeオペランド，またはドメイン定義ファイルに指定したノードのIPアドレスとポート番号を指定してください。

-uオプションにsys，srv，またはsvcを指定した場合，-oオプションおよび-bオプションは指定できません。

●-e　項目ID　　～〈1000～9999の10進数〉

追加または削除する項目の項目IDを指定します。

項目IDは64個まで指定できます。項目IDについては，「付録E.5　リアルタイム統計情報」を参照してください。

●-f　リアルタイム取得項目定義ファイル名　　～〈1～8文字の識別子〉

追加または削除する項目を定義したリアルタイム取得項目定義ファイル名を指定します。

項目を追加する場合，指定したリアルタイム取得項目定義でYを指定した項目を追加します。

項目を削除する場合，指定したリアルタイム取得項目定義でYを指定した項目を残して，それ以外の項目を削除します。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA32712-E | リアルタイム統計情報サービスのV/Rが誤っています | 標準エラー出力
KFCA32714-E | プロセスメモリ不足のため処理を続行できません | 標準エラー出力
KFCA32719-E | コマンドの使用方法が不正です | 標準エラー出力
KFCA32720-E | コマンドのオプションに指定された値が不正です | 標準エラー出力
KFCA32722-E | 共用メモリを利用できないため処理を実行できません | 標準エラー出力
KFCA32723-E | リアルタイム統計情報サービスが開始していないため処理を実行できません | 標準エラー出力
KFCA32724-E | 指定したリアルタイム統計情報の取得対象は登録されていません | 標準エラー出力
KFCA32737-I | ヘルプメッセージ | 標準出力
KFCA32742-E | リアルタイム統計情報の取得対象の登録数が最大数に達しているため，取得対象の追加はできません | 標準エラー出力
KFCA32743-E | リアルタイム統計情報の取得項目の登録数が最大数に達しているため，項目の追加はできません | 標準エラー出力
KFCA32752-E | リアルタイム統計情報サービスの拡張機能が開始していないため処理を実行できません | 標準エラー出力
KFCA32754-E | RPCの実行でエラーが発生しました | 標準エラー出力
KFCA32755-E | リアルタイム統計情報サービスの拡張機能からの応答待ちでタイムアウトが発生しました | 標準エラー出力
KFCA32756-E | リアルタイム統計情報サービスの拡張機能のサービス要求格納領域が不足したため，処理を実行できません | 標準エラー出力
KFCA32758-E | 指定された定義ファイルの解析でエラーが発生しました | 標準エラー出力
KFCA32760-E | コマンドのオプションに指定された引数の数が不正です | 標準エラー出力

注意事項

rtsstatsコマンドを使用するためには，リアルタイム統計情報サービスの拡張機能（RTSSPP）を開始している必要があります。

rtsstatsコマンドで追加できるリアルタイム統計情報の取得対象の上限数は，リアルタイム統計情報サービス定義のrts_service_maxオペランドに指定した値までです。rts_service_maxオペランドの指定値は，オンライン中に変更できません。

一つの取得対象で取得できる項目の上限数は，リアルタイム統計情報サービス定義のrts_item_maxオペランドに指定した値までです。rts_item_maxオペランドの指定値は，オンライン中に変更できません。

-aオプションを指定した場合に，-eオプションと-fオプションの指定を共に省略したときは，リアルタイム統計情報を格納する領域の確保だけを行い，取得する項目は設定しません。この場合でも，リアルタイム統計情報の取得対象数は1増加します。

-dオプションを指定した場合に，-eオプションまたは-fオプションを指定したときは，取得する項目がすべて削除されても，リアルタイム統計情報の格納領域を解放しません。
格納領域を解放して取得対象の数を減らしたい場合は，-dオプションを指定し，-eオプションと-fオプションの指定を共に省略したrtsstatsコマンドを実行してください。

リアルタイム統計情報サービス定義のrts_item_maxオペランドには，dc_rts_utrace_put関数での取得項目数分の余裕を持った値を指定してください。dc_rts_utrace_put関数で取得する項目は，rtsstatsコマンドによる取得の追加，および削除ができないためです。

rtsstatsコマンドによる取得対象や取得項目の変更は，すでにリアルタイム統計情報の取得を終了した世代を含めた，RTSサービス用の共用メモリ上のすべての世代に対して行われます。

-uオプションにsrvを指定したrtsstatsコマンドを実行して複数の取得対象を変更する場合，一部の取得対象で，取得対象や取得項目が最大数に達してKFCA32742-EメッセージまたはKFCA32743-Eメッセージが出力されたときでも，それ以外の，正常に変更できる取得対象では処理を続行します。
取得対象または取得項目の最大数を超過したことで，複数の取得対象で取得対象または取得項目の登録ができなかった場合，エラーメッセージには最初にエラーが発生した取得対象名しか表示されません。登録できなかった取得対象または取得項目については，rtslsコマンドを使用して共用メモリの構成を確認してください。

-uオプションにsvcを指定した場合，-sオプションに指定したサーバ名や，-vオプションに指定したサービス名が存在するかどうかのチェックは行いません。また，-uオプションにobjを指定した場合，-oオプションや-bオプションに指定した値が妥当であるかどうかのチェックは行いません。不要な取得対象を登録した場合は，rtslsコマンドを実行して取得対象の構成を確認し，-dオプションを指定したrtsstatsコマンドを実行して削除してください。

-uオプションにsrvを指定してrtsstatsコマンドを実行したあとに，ユーザサービス定義のserviceオペランドにサービスを追加または削除した場合，追加または削除したサービスは，統計情報の取得対象に反映されません。rtsstatsコマンドを実行したあとに追加または削除したサービスを統計情報の取得対象にする場合は，rtsstatsコマンドを再実行してください。
また，rtsstatsコマンドを実行したあとに，サービス関数動的ローディング機能でサービスを追加または削除した場合も，追加または削除したサービスは統計情報の取得対象に反映されません。rtsstatsコマンドを実行したあとに，追加または削除したサービスを統計情報の取得対象にする場合は，rtsstatsコマンドを再実行してください。

scdchprc

名称

プロセス数の変更

形式

scdchprc ｛-a｜-s サーバ名｝ 〔-p 常駐プロセス数〔,最大プロセス数〕〕

機能

ユーザサーバ，および一部のシステムサーバの常駐プロセス数または最大プロセス数を該当サーバ運用中に変更します。変更によってプロセス数の過不足が生じる場合，プロセスを終了または生成します。変更内容の有効期間は該当サーバが終了（強制終了を含む）するまでです。システムの全面回復では引き継がれません。また，現在の設定値の表示だけすることもできます。

オプション

●-a

デバッガと連動しているサーバを除く，すべてのキュー受信型のユーザサーバ，およびMHPをコマンドの対象とします。

●-s　サーバ名　　～〈1～8文字の識別子〉

指定されたサーバをコマンドの対象とします。

システムサービスを指定する場合，このオプションを使用します。

指定できるシステムサービスのサーバ名は次のとおりです。

トランザクショナルRPC実行プロセス

サーバ名：_clttrn

CUP実行プロセス

サーバ名：_cltcon

●-p　常駐プロセス数〔,最大プロセス数〕　　～〈符号なし整数〉((0～1024))

変更後の常駐プロセス数または最大プロセス数を，ユーザサービス定義のparallel_countオペランドの形式で指定します。

常駐プロセス数だけを指定した場合，最大プロセス数も同じ値に変更されます。その他の指定規則については，ユーザサービス定義のparallel_countオペランドと同じです。ユーザサービス定義のparallel_countオペランドについては，マニュアル「OpenTP1 システム定義」を参照してください。

なお，このオプションを省略した場合は，表示形式に従い現在の設定値を表示します。

表示形式

サーバ数    aaaa                       1
サーバ名    起動時    変更後
bb....bb   cccc,dddd   eeee,ffff       2

1：-aオプション指定時だけ表示します。

2：-aオプション指定時は，この行をサーバ数の分だけ繰り返し表示します。

aaaa：表示するサーバ数（10進数4けた以内）

bb....bb：サーバ名称（英数字8けた以内）

cccc：該当サーバ起動時の常駐プロセス数（10進数4けた以内）

dddd：該当サーバ起動時の最大プロセス数（10進数4けた以内）

eeee：scdchprcコマンドによる変更後の常駐プロセス数（10進数4けた以内）
起動時から変更されていないサーバの場合，'****'が表示されます。

ffff：scdchprcコマンドによる変更後の最大プロセス数（10進数4けた以内）
起動時から変更されていないサーバの場合，'****'が表示されます。

出力メッセージ

メッセージID
内容
出力先

KFCA00843-I
コマンド処理を正常に処理しました
メッセージログファイル

KFCA00844-E
コマンド処理に失敗しました
メッセージログファイル，
標準エラー出力

KFCA00883-I
ヘルプメッセージ
標準出力，
標準エラー出力

注意事項

このコマンドの使用は，TP1/Extension 1をインストールしていることが前提です。TP1/Extension 1をインストールしていない場合の動作は保証できませんので，ご了承ください。

このコマンドは，ユーザサービス定義のparallel_countオペランドの指定値を変更するものではありません。

コマンドの終了と実際のプロセス数の増減とは同期しません。また，プロセス数を減少させる場合は，プロセスを正常終了させるので，プロセスの実行状態によってはプロセス数の減少に時間が掛かる場合もあります。

最大プロセス数を起動中プロセス数よりも小さく変更する場合，該当サーバのサービス要求滞留数に関係なく起動中プロセスを減らします（マルチサーバロードバランス機能を無視して減らします）。

常駐プロセス数を大きくした場合，OpenTP1またはシステムの最大プロセス数を超えるときはコマンドエラーとなります。

起動時は常駐サーバ（常駐プロセス数＝最大プロセス数）であるサーバを，非常駐サーバ（常駐プロセス数＜最大プロセス数）に変更した場合でも，非常駐プロセスに関する次の定義オペランドに変更は反映されません。

ユーザサービス定義

termed_after_service

servcie_wait_time

ユーザサービスデフォルト定義

termed_after_service

servcie_wait_time

次のサーバは，scdchprcコマンドの対象外です。-sオプションに指定した場合，KFCA00844-Eメッセージを出力してコマンドがエラーになります。

SUP

ソケット受信型サーバ

デバッガ連動しているサーバ

システムサービス（次のサーバを含む）
・RAPサーバ
・RTSSPP（リアルタイム統計情報サービスの拡張機能のサーバ）

-aオプション指定時は，ユーザサーバプロセスの起動および訂正が集中するため，システムの負荷が増加することがあります。

scdhold

名称

スケジュールの閉塞

形式

scdhold ｛-a｜-s サーバ名 〔-c サービス名〕｜-ap｜-s サーバ名 -p｝

機能

スケジュールサービスの下で動作するサーバ，またはサービスのスケジュールを閉塞します。ただし，サービスのスケジュールは，ユーザサービス定義にservice_hold=Y（サービス単位に閉塞する）と指定した場合だけ閉塞できます。

なお，MHP（ユーザサービス定義でtype=MHPを指定したサーバ，またはユーザサービスデフォルト定義でtype=MHPを指定してある場合にユーザサービス定義のtypeオペランドの指定を省略したサーバ），およびシステムサービスに対するスケジュールは閉塞できません。MHPに対するスケジュールはmcftdctsvコマンドで閉塞してください。

オプション

●-a

スケジュールサービスの下で動作する，MHPおよびシステムサービス以外のすべてのサーバのスケジュールを閉塞します。

●-s　サーバ名　　～〈1～8文字の識別子〉

サーバ名に指定したサーバのスケジュールを閉塞します。

●-c　サービス名　　～〈1～31文字の識別子〉

-sオプションで指定したサーバの，指定したサービスのスケジュールが閉塞されます。

ユーザサービス定義でservice_hold=Y（サービス単位に閉塞する）と指定していないサーバの場合は，エラーメッセージ（KFCA00890-E）が出力されます。

このオプションの指定を省略すると，-sオプションで指定したサーバのスケジュールが閉塞されます。

●-ap

スケジュールサービスの下で動作するすべてのサーバ（MHP，およびシステムサービスは除く）のスケジュールを閉塞します。ただし，クライアントからのサービス要求は受け付けます。

●-s　サーバ名　-p　　～〈1～8文字の識別子〉

サーバ名に指定されたサーバのスケジュールを閉塞します。ただし，該当するサーバへのサービス要求は受け付けます。

出力メッセージ

メッセージID
内容
出力先

KFCA00881-I
ヘルプメッセージ
標準出力，
標準エラー出力

KFCA00890-E
scdholdコマンドの処理でエラーが発生しました
標準エラー出力

KFCA00891-E
scdholdコマンドの使用方法が正しくありません
標準エラー出力

KFCA00892-E
scdholdコマンドの実行環境が整っていません
標準エラー出力

KFCA00893-E
指定したサーバ名が正しくありません
標準エラー出力

KFCA00894-E
バージョン不一致のためscdholdコマンドが実行できません
標準エラー出力

KFCA00895-E
一括閉塞処理に失敗しました
標準エラー出力

KFCA00897-E
指定したサーバは閉塞済みです
標準エラー出力

注意事項

次のサーバは，scdholdコマンドの対象外です。次のサーバを-sオプションに指定した場合，KFCA00893-Eメッセージを出力してコマンドがエラーになります。

SUP

ソケット受信型サーバ

デバッガ連動しているサーバ

システムサービス（次のサーバを含む）

RAPサーバ

RTSSPP（リアルタイム統計情報サービスの拡張機能のサーバ）

scdls

名称

スケジュールの状態表示

形式

scdls 〔｛-a｜-s サーバ名｜-ac｜-s サーバ名 -c｜-ae｜-s サーバ名 -e｜
         -b 〔スケジュールバッファグループ名〕｜ -p｝ [-t]〕

機能

スケジュールサービスの下で動作するサーバのスケジュール状態，またはサービスの状態を標準出力に出力します。

メッセージ格納バッファプールの状態をスケジュールバッファグループ単位で標準出力に出力します。

また，サービス要求を受信するスケジューラデーモンの負荷状態を標準出力に出力します。

オプション

●-a

scdlsコマンド入力時点で起動中のシステムサービス以外のすべてのサーバのスケジュール状態が表示されます。オプションの指定を省略すると，-aが仮定されます。

●-s　サーバ名　　～〈1～8文字の識別子〉

サーバ名を指定します。指定したサーバのスケジュール状態が表示されます。

●-ac

スケジュールサービスの下で動作するすべてのサーバの，すべてのサービスの状態が表示されます。

ユーザサービス定義にservice_hold=N（サービス単位に閉塞しない）と指定したサーバは，サーバの状態だけが表示されます。

●-s　サーバ名　-c　　～〈1～8文字の識別子〉

指定したサーバのサービスの状態が表示されます。

ユーザサービス定義にservice_hold=N（サービス単位に閉塞しない）と指定したサーバは，サーバの状態だけが表示されます。

●-ae

スケジュールサービスの下で動作するすべてのサーバの，すべてのサービスの状態が表示されます。

ユーザサービス定義にサービス単位に閉塞するservice_hold=Y，またはユーザサービス定義にサービス単位の動作を指定するscdsvcdef定義コマンドを指定したサーバの場合だけ，サービスの状態が表示されます。

●-s　サーバ名　-e　　～〈1～8文字の識別子〉

指定したサーバのサービスの状態が表示されます。

ユーザサービス定義にサービス単位に閉塞するservice_hold=Y，またはユーザサービス定義にサービス単位の動作を指定するscdsvcdef定義コマンドを指定したサーバの場合だけ，サービスの状態が表示されます。

●-b　スケジュールバッファグループ名

スケジュールバッファグループの使用するメッセージ格納バッファプールの状態とそのスケジュールバッファグループ内のユーザサーバのスケジュール状態が表示されます。

スケジュールサービス定義で指定したスケジュールバッファグループ名を指定してください。

スケジュールバッファグループ名を省略した場合は，すべてのスケジュールバッファグループが表示の対象になります。

●-p

サービス要求を受信するスケジューラデーモンの負荷状態が表示されます。

●-t

最後にスケジュールキューからサービス要求を取り出した時刻が表示されます。-bオプションまたは-pオプションと併せて指定できません。

出力形式

●スケジュール状態が表示された場合

1：scdls -aの場合だけ表示されます。

3：scdls -aの場合で，スケジュールサービスの下で動作するサーバが複数あるとき，サーバの数だけ繰り返し表示されます。

2および3：1行で表示します。ただし，表示するディスプレイによって途中で改行される場合があります。

4：-tオプションを指定した場合に，サーバの数だけ繰り返し表示します。

aaaa：スケジュールサービスの下で動作するサーバの数（10進数，4けた以内）

bb...bb：サーバ名（8文字以内）

c：該当するサーバの状態

S…サーバ準備中

A…スケジューリングできる状態

E…サーバ終了処理中

H…サーバ閉塞中

P…サービス要求を受け付けられる状態で閉塞中

dd...dd：スケジュールキューに滞留しているサービス要求数（10進数，7けた以内）

ee...ee：スケジュールキューに滞留したサービス要求の最大数（10進数，7けた以内）

ff...ff：メッセージ格納用プールの現在の使用サイズ（10進数，10けた以内）

gg...gg：メッセージ格納用プールの現在の未使用サイズ（10進数，10けた以内）

hh...hh：メッセージ格納用プールの最大使用サイズ（10進数，10けた以内）

ii...ii：メッセージ格納用プールの現在の最大連続未使用サイズ（10進数，10けた以内）

jj...jj：サービスグループ名（31文字以内）

kk...kk：最後にスケジュールキューから取り出した時刻
時刻は，1970年1月1日0時0分0秒からの通算秒を，TZ環境変数に合わせて表示しています。サービス要求を，スケジュールキューから一度も取り出していない場合，表示は次のようになります。

（例）

Thu Jan 1 09:00:00 1970（TZ環境変数がJST-9の場合）

注

該当するサーバの状態がEの場合，dd...dd～ii...iiには0が表示されることがあります。

MHPのスケジュール状態について，サーバ名，サーバの状態，およびサービスグループ名以外はスケジュールサービスの制御情報となるため無視してください。

dd...dd，ee...eeの表示が6けたを超える場合，またはff...ff，gg...gg，hh...hh，ii...iiの表示が8けたを超える場合，ヘッダ情報とデータ情報がずれて表示されるときがあります。

●サービス状態が表示された場合

1：scdls -acの場合だけ出力されます。

2：scdls -acの場合で，スケジュールサービスの下で動作するサーバが複数あるとき，サーバの数だけ繰り返し表示されます。

3：ユーザサービス定義にサービス単位に閉塞する（service_hold=Y）と指定したサーバの場合に，サービスの数だけ繰り返し表示します。-eオプションを指定した場合は，6の形式で表示します。

4および5：1行で表示します。ただし，表示するディスプレイによって途中で改行される場合があります。

6：ユーザサービス定義にサービス単位に閉塞するservice_hold=Y，またはサービス単位でキュー制御するscdsvcdef定義コマンドが指定された場合に，サービスの数だけ繰り返し表示します。2の形式のあとに，改行しないで続けて表示します。-cオプションを指定した場合は，3の形式で表示します。

7：-tオプションを指定した場合に，サービスの数だけ繰り返し表示します。3または6の形式のあとに，改行しないで続けて表示します。

aaaa：スケジュールサービスの下で動作するサーバの数（10進数，4けた以内）

bb...bb ：サーバ名（8文字以内）

c：該当するサーバの状態

S…サーバ準備中

A…スケジューリングできる状態

E…サーバ終了処理中

H…サーバ閉塞中

P…サービス要求を受け付けられる状態で閉塞中

dd...dd ：サービスグループ名（31文字以内）

e：サービスの状態

S…サーバ準備中

A…スケジューリングできる状態

E…サーバ終了処理中

H…サービス閉塞中

P…サービス要求を受け付けられる状態で閉塞中

ff...ff ：サービス名（31文字以内）

gg...gg：該当サービスのスケジュールキューに滞留しているサービス要求数（10進数，7けた以内）※

hh...hh：該当サービスのスケジュールキューに滞留したサービス要求数の最大値（10進数，7けた以内）※

ii...ii：該当サービスが使用しているメッセージ格納バッファプールサイズ（10進数，10けた以内，単位：バイト）※

jj...jj：該当サービスが使用したメッセージ格納バッファプールサイズの最大値（10進数，10けた以内，単位：バイト）※

kk...kk：該当サービスが同時実行しているサービス数（10進数，4けた以内）※

ll...ll：該当サービスが同時実行したサービス数の最大値（10進数，4けた以内）※

mm...mm：該当サービスを最後にスケジュールキューから取り出した時刻※
時刻は，1970年1月1日0時0分0秒からの通算秒を，TZ環境変数に合わせて表示しています。該当サービスのサービス要求を，スケジュールキューから一度も取り出していない場合，表示は次のようになります。

（例）

Thu Jan 1 09:00:00 1970（TZ環境変数がJST-9の場合）

注※

ユーザサービス定義にサービス単位でキュー制御するscdsvcdef定義コマンドが指定されていない場合は，「**...**」が表示されます。

注

gg...gg，hh...hhの表示が6けたを超える場合，またはii...ii，jj...jjの表示が8けたを超える場合，ヘッダ情報とデータ情報がずれて表示されるときがあります。

●メッセージ格納バッファプールの状態が表示された場合

1，2，3，4，および5：1行で表示します。

1：スケジュールバッファグループ名を省略した場合だけ出力します。

5：該当のスケジュールバッファを共用しているサーバの数だけ繰り返して出力します。

スケジュールバッファグループ名を省略したときに，スケジュールバッファグループが複数ある場合は，2～5をスケジュールバッファグループの数だけ繰り返して表示します。

aaaa：スケジュールバッファグループ数（10進数，4けた以内）

bb...bb：スケジュールバッファグループ名（8文字以内の識別子）

cc...cc：スケジュールバッファグループのメッセージ格納バッファプール長（10進数，10けた以内，単位：バイト）

dd...dd：メッセージ格納バッファプールの現在の使用サイズ（10進数，10けた以内，単位：バイト）

ee...ee：メッセージ格納バッファプールの現在の最大使用サイズ（10進数，10けた以内，単位：バイト）
ただし，メッセージをメッセージ格納バッファプールに格納するときに，バッファプール不足が発生した場合は，'********'を表示します。

ff...ff：サーバ名（8文字以内の識別子）

g：サーバの状態（1文字）

S…サーバ準備中

A…スケジューリングできる状態

E…サーバ終了処理中

H…サーバ閉塞中

P…サービス要求を受け付けられる状態で閉塞中

hh...hh：該当サーバのスケジュールキューに滞留しているサービス要求数（10進数，7けた以内）

ii...ii：該当サーバのスケジュールキューに滞留したサービス要求の最大値（10進数，7けた以内）

jj...jj：該当サーバが使用しているメッセージ格納バッファプールサイズ（10進数，10けた以内，単位：バイト）

kk...kk：該当サーバが使用したメッセージ格納バッファプールサイズの最大値（10進数，10けた以内，単位：バイト）

注

hh...hh，ii....iiの表示が6けたを超える場合，またはcc...cc，dd...dd，ee...ee，jj...jj，kk...kkの表示が8けたを超える場合，ヘッダ情報とデータ情報がずれて表示されるときがあります。

●スケジューラデーモンの負荷状態が表示された場合

1，および2：1行で表示します。ただし，表示するディスプレイによって途中で改行される場合があります。

2：マルチスケジューラ機能によってスケジューラデーモンが複数起動される場合は，スケジューラデーモン数だけ繰り返し表示されます。

aa...aa：スケジューラデーモンのサーバ名（8文字以内）

bb...bb：スケジューラデーモンの識別子（14文字以内）
マルチスケジューラグループ名とポート番号を"："で区切った文字列で表示します。マスタスケジューラデーモンの場合，マルチスケジューラグループ名が"********"となり，スケジュールサービス定義のscd_portオペランドを指定していないとポート番号が"*****"となります。

cc...cc：動作している処理スレッド数（10進数，5けた以内）

dd...dd：動作している処理スレッド数の最大値（10進数，5けた以内）

ee:ee:ee：動作している処理スレッド数が最大値となった時刻（8文字）
処理スレッドが動作していない場合には"**:**:**"を表示します。

ff...ff：処理スレッド不足が発生した回数（10進数，10けた以内）

gg...gg：処理スレッド不足が連続発生した回数の最大値（10進数，10けた以内）

hh...hh：処理スレッド不足が連続発生した回数が最大値となった時刻（8文字）
処理スレッド不足が発生していない場合には"**:**:**"を表示します。

ii...ii：処理スレッドがサービス要求を受信してからスケジュール処理が完了するまでに掛かった時間（11けた，うち小数点以下6けた）
OSの時刻を再設定するなどしてスケジュール処理に掛かった時間が0未満となった場合には"*****.******"を表示します。

jj...jj：処理スレッドがサービス要求を受信してからスケジュール処理が完了するまでに掛かった時間の最大値（11けた，うち小数点以下6けた）

kk...kk：処理スレッドがサービス要求を受信してからスケジュール処理が完了するまでに掛かった時間が最大値となった時刻（8文字）
サービス要求を受信していない場合には"**:**:**"を表示します。

ll...ll：単位時間に受信したサービス要求数（10進数，10けた以内）
スケジューラデーモンが10秒ごとに行うインタバル処理間に受信したサービス要求数となります。インタバル処理に時間が掛かった場合には，単位時間が10秒以上となることがあります。

mm...mm：単位時間に受信したサービス要求数の最大値（10進数，10けた以内）

nn...nn：単位時間に受信したサービス要求数が最大値となった時刻（8文字）
サービス要求を受信していない場合には"**:**:**"を表示します。

注

スケジューラデーモンの負荷状態で表示する情報は，処理性能への影響を極力抑えるため，排他処理をしないで更新，参照します。このため，タイミングによっては表示される情報が不正になる可能性があります。その際には再度コマンドを実行してください。このオプションで表示されるサービス要求に関する情報は，スケジューラデーモンを経由したサービス要求が対象となります。サービス要求が自ノードのSPPにスケジュールされた場合にスケジューラデーモンを経由しないことがあるため，情報が更新されないことがあります。

出力メッセージ

メッセージID
内容
出力先

KFCA00880-I
ヘルプメッセージ
標準出力，
標準エラー出力

KFCA00890-E
scdlsコマンドの処理でエラーが発生しました
標準エラー出力

KFCA00891-E
scdlsコマンドの使用方法が正しくありません
標準エラー出力

KFCA00892-E
scdlsコマンドの実行環境が整っていません
標準エラー出力

KFCA00893-E
指定したサーバ名が正しくありません
標準エラー出力

KFCA00894-E
バージョン不一致のためscdlsコマンドが実行できません
標準エラー出力

scdrles

名称

スケジュールの再開始

形式

scdrles ｛-a｜-s サーバ名 〔-c サービス名〕｜-ap｜-s サーバ名 -p｝

機能

スケジュールサービスの下で動作するサーバ，またはサービスのスケジュールを再開始します。ただし，サービスのスケジュールは，ユーザサービス定義にservice_hold=Y（サービス単位に閉塞する）と指定した場合だけ再開始できます。

なお，MHP（ユーザサービス定義でtype=MHPを指定したサーバ，またはユーザサービスデフォルト定義でtype=MHPを指定してある場合にユーザサービス定義のtypeオペランドの指定を省略したサーバ），およびシステムサービスに対するスケジュールの閉塞は解除できません。MHPに対するスケジュールの閉塞はmcftactsvコマンドで解除してください。

オプション

●-a

スケジュールサービスの下で動作するサーバのうち，MHPおよびシステムサービス以外の，閉塞されているすべてのサーバのスケジュールを閉塞解除します。

●-s　サーバ名　　～〈1～8文字の識別子〉

サーバ名に指定したサーバのスケジュールが閉塞解除されます。

●-c　サービス名　　～〈1～31文字の識別子〉

-sオプションで指定したサーバの，指定したサービスのスケジュールが再開始されます。

ユーザサービス定義でservice_hold=Y（サービス単位に閉塞する）と指定されていないサーバの場合は，エラーメッセージ（KFCA00890-E）が出力されます。

このオプションの指定を省略すると，-sオプションで指定したサーバのスケジュールが再開始されます。

●-ap

スケジュールサービスの下で動作するサーバのうち，-pオプション指定のscdholdコマンドで閉塞されているサーバ（MHP，およびシステムサービスは除く）のスケジュールが再開始されます。

●-s　サーバ名　-p　　～〈1～8文字の識別子〉

サーバ名に指定したサーバのスケジュールが再開始されます。ただし，-pオプション指定のscdholdコマンドでスケジュールが閉塞されていない場合は，コマンドエラーとなります。

出力メッセージ

メッセージID
内容
出力先

KFCA00882-I
ヘルプメッセージ
標準出力，
標準エラー出力

KFCA00890-E
scdrlesコマンドの処理でエラーが発生しました
標準エラー出力

KFCA00891-E
scdrlesコマンドの使用方法が正しくありません
標準エラー出力

KFCA00892-E
scdrlesコマンドの実行環境が整っていません
標準エラー出力

KFCA00893-E
指定したサーバ名が正しくありません
標準エラー出力

KFCA00894-E
バージョン不一致のためscdrlesコマンドが実行できません
標準エラー出力

KFCA00896-E
一括閉塞解除処理に失敗しました
標準エラー出力

KFCA00897-E
指定したサーバは閉塞されていません
標準エラー出力

注意事項

scdrlesコマンドで複数のサービスグループを指定したり，scdrlesコマンドを連続して実行したりすると，プロセス起動が多発してCPU利用率が上昇します。このような場合，scdrlesコマンドを実行する間隔を空けるなど，CPU利用率の上昇に伴う弊害を回避するように運用設計してください。

次のサーバは，scdrlesコマンドの対象外です。次のサーバを-sオプションに指定した場合，KFCA00893-Eメッセージを出力してコマンドがエラーになります。

SUP

ソケット受信型サーバ

デバッガ連動しているサーバ

システムサービス（次のサーバを含む）

RAPサーバ

RTSSPP（リアルタイム統計情報サービスの拡張機能のサーバ）

scdrsprc

名称

プロセスの停止および再起動

形式

scdrsprc ｛-s サーバ名 ｜ -a｝

機能

スケジュールサービス下で動作するユーザサーバプロセスを停止および再起動します。

オプション

●-s サーバ名

プロセスを停止および再起動させるユーザサーバ名を指定します。

●-a

スケジュールサービスの下で動作するキュー受信型のユーザサーバ，およびMHPをコマンドの対象とします。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA00884-I | ヘルプメッセージ | 標準エラー出力
KFCA00890-E | scdrsprcコマンドの処理でエラーが発生しました | 標準エラー出力
KFCA00891-E | scdrsprcコマンドの使用方法が正しくありません | 標準エラー出力
KFCA00892-E | スケジューラが動作できないため，scdrsprcコマンドを実行できません | 標準エラー出力
KFCA00893-E | scdrsprcコマンドで指定されたサーバ名，サービスグループ名，またはサービス名が不正です | 標準エラー出力
KFCA00894-E | スケジューラのscdrsprcコマンドとデーモンのプログラムのバージョンが不一致です | 標準エラー出力

注意事項

scdrsprcコマンドの実行は，TP1/Extension 1をインストールしていることが前提です。TP1/Extension 1をインストールしていない場合の動作は保証できませんので，ご了承ください。

scdrsprcコマンドは，正常に要求を受け付けた時点でリターンします。そのため，コマンドがリターンした時点では，対象ユーザサーバのプロセスの入れ替えがすべて完了しているわけではありません。

scdrsprcコマンド実行時に，サービス要求待ち状態のプロセスはすぐに終了しますが，サービス要求実行中のプロセスは，サービスが完了してから終了します。

新しいプロセスの起動は，次のタイミングで行われます。

スケジューラデーモンの一定インタバル処理（間隔は10秒）のタイミング
この場合，全プロセスの入れ替えには時間が掛かるときがあります。

新たなサービス要求を受信したタイミング

サーバの閉塞解除（scdrles：スケジュールの再開始）のタイミング

次のサーバは，scdrsprcコマンドの対象外です。-sオプションに指定した場合，KFCA00893-Eを出力してコマンドがエラーになります。

SUP

ソケット受信型サーバ

ユーザサービス定義およびユーザサービスデフォルト定義に次のオペランドを指定しているサーバ
・termed_after_service = Y
・service_wait_time = ユーザサーバの非常駐プロセスのサービス要求待ち時間

デバッガ連動しているサーバ

システムサービス（次のサーバを含む）
・RAPサーバ
・RTSSPP（リアルタイム統計情報サービスの拡張機能のサーバ）

-aオプション指定時は，ユーザサーバプロセスの停止および再起動が集中するため，システムの負荷が増加することがあります。

stsclose

名称

ステータスファイルのクローズ

形式

stsclose ｛-n 論理ファイル名｜-f 物理ファイル名｝

機能

オープン状態のステータスファイルをクローズします。

現用で使用中のファイルはクローズできません。

ただし，stscloseコマンドでクローズできるファイルは，ステータスサービス定義で指定したステータスファイルだけです。ステータスサービスが動作中のときにクローズできます。

オプション

●-n　論理ファイル名　　～〈1～8文字の識別子〉

クローズする論理ファイルの名称を指定します。指定した論理ファイルを構成するA系ファイルとB系ファイルを両方同時にクローズします。

次の場合に指定できます。

A系ファイル，B系ファイルのどちらかがBLOCKADE，またはSTANDBY状態の場合

A系ファイル，B系ファイルの両方ともBLOCKADE，またはSTANDBY状態の場合

論理ファイル名を指定すると，ステータスファイル実体のパス名を意識する必要はありません。

●-f　物理ファイル名　　～〈パス名〉

クローズする物理ファイルの名称を完全パス名で指定します。

ステータスファイルに障害が発生した場合に，閉塞状態になった系ではなく，STANDBY状態の系をクローズするときに指定します。

なお，「stsclose -f　A系物理ファイル名」，「stsclose -f　B系物理ファイル名」と2回stscloseコマンドを実行するのは，「stsclose -n　論理ファイル名」と実行するのと同じことです。

出力メッセージ

メッセージID
内容
出力先

KFCA01040-E
物理ファイルでエラーが発生しました
標準エラー出力

KFCA01050-E
プロセス間通信でエラーが発生しました
標準エラー出力

KFCA01070-E
stscloseコマンドの処理でエラーが発生しました
標準エラー出力

KFCA01084-I
ヘルプメッセージ
標準出力，
標準エラー出力

KFCA01099-E
OpenTP1関数コールでエラーが発生しました
標準エラー出力

stsfills

名称

ステータスファイルの内容表示

形式

stsfills -f 物理ファイル名 〔-cx〕

機能

ステータスファイルの内容を，オフラインで標準出力に出力します。

オプション

●-f　物理ファイル名　　～〈パス名〉

物理ファイルの名称を，完全パス名で指定します。

●-c

ステータスファイルをチェックします。チェック内容を次に示します。

レコード（先頭，終端）整合性チェック番号によるレコード破壊チェック

stsinitコマンド実行時のファイル管理情報によるレコード長，レコード数チェック

ステータスファイル管理情報によるファイル更新完了チェック

ステータスファイル管理情報内のレコード数，レコード種別チェック

チェック結果が不正の場合，指定したステータスファイルの内容を表示したあとに，エラーメッセージを出力します。

-cオプションの指定を省略すると，ステータスファイルはチェックされません。

●-x

ステータスファイルを排他的にオープンします。そのため，ステータスサービス開始時にstsfillsコマンドを実行すると，OpenTP1が排他エラーで異常終了する場合があります。

-xオプションの指定を省略すると，ステータスファイルは排他的にオープンされません。そのため，指定したステータスファイルをOpenTP1で使用中の場合，正しい状態が表示されない場合があります。

出力形式

aa....aa：物理ファイル名（63けた以内）

bb...bb：初期設定日時
「年/月/日△時:分:秒」の形式で表示します。「年」は西暦の下2けたを表示します。

cc...cc：現用決定日時
「年/月/日△時:分:秒」の形式で表示します。「年」は西暦の下2けたを表示します。
現用ファイルとして使用されていない場合，「--/--/-- --:--:--」を表示します。

ddddd：レコード長（10進数）

ee...ee：レコード数（10進数）

fff：ファイル内のレコード使用率

gg...gg：ファイル内の連続空きレコード数（10進数）

hh...hh：ファイル内の管理レコード数（10進数）

注

障害が発生したファイルや破壊されたファイルに対する表示内容は，不正となる場合があります。

出力メッセージ

メッセージID
内容
出力先

KFCA01040-E
物理ファイルでエラーが発生しました
標準エラー出力

KFCA01070-E
stsfillsコマンドの処理でエラーが発生しました
標準エラー出力

KFCA01088-I
ヘルプメッセージ
標準出力，
標準エラー出力

KFCA01091-E
メモリ不足です
標準エラー出力

KFCA01099-E
OpenTP1関数コールでエラーが発生しました
標準エラー出力

stsinit

名称

ステータスファイルの作成，初期設定

形式

stsinit -f 物理ファイル名 〔-s レコード長〕 〔-c レコード数〕

機能

OpenTP1ファイルを作成し，ステータスサービスが使用できる形式に初期設定します。

ステータスサービスがオンラインで使用中（現用，または予備の状態）のステータスファイルは初期設定できません。

オプション

●-f　物理ファイル名　　～〈パス名〉

初期設定する物理ファイルの名称を完全パス名で指定します。

ステータスサービス定義のステータスファイル名に指定した名称と同じ名称を指定してください。

●-s　レコード長　　～((512～32768))《4608》（単位：バイト）

ステータスファイルのレコード長を指定します。OpenTP1ファイルシステム作成時（filmkfsコマンド）に指定したセクタ長の倍数を指定してください。

●-c　レコード数　　～((32～4194304))《256》

ステータスファイルのレコード数を指定します。

注意事項

ステータスサービスが起動中のときだけ，現用ステータスファイルを管理しています。そのため，オンライン中に使用した現用のステータスファイルを初期設定しないように注意してください。

一つの論理ファイルを構成するA系とB系の物理ファイルは，レコード長とレコード数が同じになるように初期設定してください。

論理ファイルごとであれば，レコード数を変えてもかまいません。ただし，レコード長は変更できません。

レコード長は，仮定値を使用することをお勧めします。レコード長が4608バイトより短いとステータスファイルの入出力回数が増加します。4608バイトより長いとステータスファイルの使用効率が悪くなります。

ステータスファイルのレコード数はOpenTP1のシステム構成に依存します。オンライン中の場合はstslsコマンドで，オフラインの場合はstsfillsコマンドでステータスファイルのレコード使用率を確認できます。レコード使用率を参考にしてレコード数を変更してください。オンライン中にステータスファイルのレコード使用率が高くなった場合，現用のファイルよりレコード数の多いステータスファイルを予備のファイルとして初期設定できます。

stsls

名称

ステータスファイルの状態表示

形式

stsls 〔｛-n 論理ファイル名｜-f 物理ファイル名｜-a｜-l｜-p｝〕

機能

ステータスファイルの状態を，オンライン中に標準出力に出力します。

オプション

●-n　論理ファイル名　　～〈1～8文字の識別子〉

状態を表示する論理ファイルの名称を指定します。

●-f　物理ファイル名　　～〈パス名〉

状態を表示する物理ファイルの名称を完全パス名で指定します。

●-a

ステータスサービスが使用中のすべてのステータスファイルの状態を，短縮形式で表示します。

●-l

ステータスサービスが使用中のすべての論理ファイルの状態を表示します。

●-p

ステータスサービスが使用中のすべての物理ファイルの状態を表示します。

すべてのオプションの指定を省略すると，ステータスサービスが使用中のすべてのステータスファイルの状態が表示されます。

出力形式

オプションの指定を省略した場合の出力形式を次に示します。

1：は物理ファイル状態表示部です。

2：は論理ファイル状態表示部です。

aaaaaaaa：論理ファイル名（8文字以内）

bbbbbbbb：論理ファイル状態

ACTIVE…現用ファイル

BLOCKADE…障害閉塞ファイル

CLOSE…無効ファイル

NONE…ファイル実体がない状態

STANDBY…予備ファイル

ccc：ファイル内のレコード使用率（1～3けたの％表示）

dddddddd：ファイル内の連続空きレコード数（10進数）

eeeeeeee：ファイル内管理レコード数（10進数）

f：物理ファイルがA系かB系かの表示

A…A系

B…B系

gggggggg：物理ファイル状態

a…現用ファイル

b…障害閉塞ファイル

c…クローズファイル

i…初期設定状態

l…論理エラー

n…ファイル実体がない状態

o…オープンファイル

p…物理エラー

r…障害情報によるファイル状態回復

s…予備ファイル

u…使用済みファイル

各状態を示すアルファベットは，物理ファイルの状態によって表示位置が異なります。

hhhhhhhh：レコード長（10進数）

iiiiiiii：レコード数（10進数）

jj...jj ：物理ファイル名（63文字以内）

出力メッセージ

メッセージID
内容
出力先

KFCA01040-E
物理ファイルでエラーが発生しました
標準エラー出力

KFCA01050-E
プロセス間通信でエラーが発生しました
標準出力

KFCA01070-E
stslsコマンドの処理でエラーが発生しました
標準エラー出力

KFCA01085-I
ヘルプメッセージ
標準出力，
標準エラー出力

KFCA01091-E
メモリ不足です
標準エラー出力

KFCA01099-E
OpenTP1関数コールでエラーが発生しました
標準エラー出力

注意事項

ステータスサービスが動作中のときだけ，ステータスファイルの状態を管理しています。

このため，ステータスサービスが動作中に次に示すクローズ状態のファイルに対しstsinitコマンド，またはstsrmコマンドを実行しても，stslsコマンドで表示されるファイル状態は変わりません。

CLOSE

NONE

BLOCKADE

なお，stsinitコマンド，またはstsrmコマンドを実行したあとにstsopenコマンドでステータスファイルをオープンしてから，stslsコマンドを実行すると，現在のファイル状態を表示できます。

stsopen

名称

ステータスファイルのオープン

形式

stsopen ｛-n 論理ファイル名｜-f 物理ファイル名｝

機能

stsinitコマンドで初期設定したステータスファイル，またはstscloseコマンドでクローズしたステータスファイルをオープンします。

ただし，stsopenコマンドでオープンできるステータスファイルは，ステータスサービス定義で指定したステータスファイルだけです。ステータスサービスが動作中のときにオープンできます。

現用のステータスファイルが片系運転の場合，閉塞状態の系の物理ファイルをstsinitコマンドで初期設定したあと，stsopenコマンドを実行すると，現用のステータスファイルとして回復できます。

オプション

●-n　論理ファイル名　　～〈1～8文字の識別子〉

オープンする論理ファイルの名称を指定します。指定した論理ファイルを構成するA系ファイルとB系ファイルを両方同時にオープンします。

次の場合に指定できます。

A系ファイル，B系ファイルのどちらかがCLOSE，NONE，またはBLOCKADEの場合

A系ファイル，B系ファイルの両方とも，CLOSE，NONE，またはBLOCKADEの場合

論理ファイル名を指定すると，ステータスファイル実体のパス名を意識する必要はありません。

●-f　物理ファイル名　　～〈パス名〉

オープンする物理ファイルの名称を完全パス名で指定します。

ステータスファイルに障害が発生し，閉塞状態になったステータスファイルを再作成したあと，および容量を拡張するためにstsinitコマンドで初期設定した物理ファイルをオープンするときに指定します。

なお，「stsopen -f　A系物理ファイル名」，「stsopen -f　B系物理ファイル名」と2回stsopenコマンドを実行するのは，「stsopen -n　論理ファイル名」と実行するのと同じことです。

出力メッセージ

メッセージID
内容
出力先

KFCA01008-E
ステータスファイルでエラーが発生しました
標準エラー出力

KFCA01040-E
物理ファイルでエラーが発生しました
標準エラー出力

KFCA01050-E
プロセス間通信でエラーが発生しました
標準エラー出力

KFCA01070-E
stsopenコマンドの処理でエラーが発生しました
標準エラー出力

KFCA01083-I
ヘルプメッセージ
標準出力，
標準エラー出力

KFCA01091-E
メモリ不足です
標準エラー出力

KFCA01099-E
OpenTP1関数コールでエラーが発生しました
標準エラー出力

stsrm

名称

ステータスファイルの削除

形式

stsrm -f 物理ファイル名

機能

ステータスファイルを削除します。

ステータスサービスがオンラインで使用中（現用，または予備の状態）のステータスファイルは削除できません。

オプション

●-f　物理ファイル名　　～〈パス名〉

削除する物理ファイルの名称を指定します。

出力メッセージ

メッセージID
内容
出力先

KFCA01040-E
物理ファイルでエラーが発生しました
標準エラー出力

KFCA01070-E
stsrmコマンドの処理でエラーが発生しました
標準エラー出力

KFCA01082-I
ヘルプメッセージ
標準出力，
標準エラー出力

KFCA01091-E
メモリ不足です
標準エラー出力

KFCA01099-E
OpenTP1関数コールでエラーが発生しました
標準エラー出力

注意事項

ステータスサービスが起動中のときだけ，現用ステータスファイルを管理しています。そのため，stsrmコマンドを実行する場合，次のことに注意してください。

オンライン中に使用した現用のステータスファイルを削除しないでください。

障害が発生して閉塞状態になったステータスファイルだけを削除してください。

stsswap

名称

ステータスファイルのスワップ

形式

stsswap

機能

ステータスファイルの状態を切り替えます。

現用のステータスファイルを予備とし，両系とも予備のステータスファイルを現用とします。

出力メッセージ

メッセージID
内容
出力先

KFCA01040-E
物理ファイルでエラーが発生しました
標準エラー出力

KFCA01050-E
プロセス間通信でエラーが発生しました
標準エラー出力

KFCA01062-I
stsswapコマンドの処理を開始します
標準出力

KFCA01063-I
stsswapコマンドの処理を完了しました
標準出力

KFCA01064-E
スワップ処理でエラーが発生しました
標準エラー出力

KFCA01070-E
stsswapコマンドの処理でエラーが発生しました
標準エラー出力

KFCA01086-I
ヘルプメッセージ
標準出力，
標準エラー出力

KFCA01091-E
メモリ不足です
標準エラー出力

KFCA01099-E
OpenTP1関数コールでエラーが発生しました
標準エラー出力

tamadd

名称

TAMテーブルの追加

形式

tamadd 〔-o ローディング契機〕 〔-a アクセス形態〕 〔-i〕 〔-j〕
       TAMテーブル名 TAMファイル名

機能

指定したTAMテーブルをオンラインに追加登録します。

追加登録後のTAMテーブル状態は，論理閉塞状態となります。

オプション

●-o　ローディング契機　　～〈英字〉 《start》

TAMテーブルをロードする契機を指定します。

　start：tamaddコマンド実行時にロードします。

　cmd：tamloadコマンド実行時にロードします。

　lib：dc_tam_open関数発行時にロードします。

●-a　アクセス形態　　～〈英字〉 《read》

TAMテーブルのアクセス形態を指定します。

　read：参照型

　rewrite：追加・削除できない更新型

　write：追加・削除できる更新型

　reclck：テーブル排他を確保しない，追加・削除できる更新型

●-i

指定するTAMテーブルを，I/O障害処理続行型テーブルにする場合に指定します。この場合，TAMファイルの更新時に入出力エラーが発生しても，同一オンラインでは該当するTAMファイルを障害閉塞状態にしません。そのため，入出力エラー発生後も該当するTAMファイルをアクセスできます。ただし，オンライン再開始時には，TAMファイルの状態に不整合が生じるのを防ぐ必要があります。そのため，前回のオンラインで障害が発生したままのTAMテーブル（I/O障害処理続行型テーブル）は，オンライン再開始時，オンラインから切り離されます。オンライン再開始後，TAMファイルを回復して，再びオンラインへ追加登録してください。

このオプションの指定を省略すると，TAMファイルの更新時に入出力エラーが発生した場合，該当するTAMファイルは障害閉塞状態となります。

●-j

TAMレコード更新時に，部分ジャーナルを取得します。

更新の部分ジャーナルは，更新前レコードと更新後レコードを比較して，取得されます。32バイト単位でレコードを先頭から比較します。先頭から比較して，比較結果が異なったところが，ジャーナル取得開始位置になります。次にレコードの最後から32バイト単位で比較します。最後から比較して最初に比較結果が異なったところがジャーナル取得終了位置になります。

1レコードで更新する部分が複数ある場合は，ジャーナルの取得範囲が広くなります。

コマンド引数

●TAMテーブル名　　～〈1～32文字の識別子〉

追加登録するTAMテーブルの名称を指定します。

●TAMファイル名　　～〈パス名〉

TAMテーブルに対応するTAMファイルの名称を完全パス名で指定します。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA01700-E | 指定したファイルはTAMファイルではありません | 標準エラー出力
KFCA01701-E | メモリ不足です | 標準エラー出力
KFCA01703-E | TAMサービスのアドレス情報を検索できません | 標準エラー出力
KFCA01704-E | TAMサービスが起動されていません | 標準エラー出力
KFCA01706-E | TAMファイル名の長さが64文字以上です | 標準エラー出力
KFCA01709-E | TAMファイルに対するアクセス権がありません | 標準エラー出力
KFCA01710-E | スペシャルファイルに対するアクセス権がありません | 標準エラー出力
KFCA01712-E | コマンドで指定した引数の数が正しくありません | 標準エラー出力
KFCA01713-E | 指定したファイルはありません | 標準エラー出力
KFCA01715-E | 指定したTAMファイルはスペシャルファイル名ではありません | 標準エラー出力
KFCA01716-E | 指定したファイルはほかのプロセスで使用中です | 標準エラー出力
KFCA01749-I | TAMテーブルの登録を完了しました | メッセージログファイル
KFCA01753-E | タイムアウトとなりました | 標準エラー出力
KFCA01757-E | TAMテーブル名の文字数が32文字を超えています | 標準エラー出力
KFCA01758-E | 指定したTAMテーブル名はすでに登録されています | 標準エラー出力
KFCA01760-E | 指定したTAMファイル名はすでに登録されています | 標準エラー出力
KFCA01761-E | I/Oエラーが発生しました | 標準エラー出力
KFCA01762-E | レコード破壊が発生しました | 標準エラー出力
KFCA01764-E | TAMテーブルのV/Rが誤っています | 標準エラー出力
KFCA01765-E | TAMサーバのV/Rが誤っています | 標準エラー出力
KFCA01767-E | RPCでネットワーク障害が発生しました | 標準エラー出力
KFCA01770-E | TAMサービスが終了処理中です | 標準エラー出力
KFCA01772-E | 指定したスペシャルファイル名はOpenTP1ファイルシステム用に初期化されていません | 標準エラー出力
KFCA01773-E | ファイルシステム作成時のシステムと運用コマンド実行時のシステムのバージョンが異なっています | 標準エラー出力
KFCA01775-E | 定義解析中にエラーが発生しました | 標準エラー出力
KFCA02856-I | ヘルプメッセージ | 標準出力
KFCA02857-E | 指定したTAMテーブルを登録するための空き領域がありません | 標準エラー出力
KFCA02858-E | オープンしてあるOpenTP1ファイルが多過ぎます | 標準エラー出力
KFCA02866-E | 指定したTAMファイルのレコード長が最大レコード長を超えています | 標準エラー出力
KFCA02868-E | ローディング契機の引数が誤っています | 標準エラー出力
KFCA02870-E | アクセス形態の引数が誤っています | 標準エラー出力
KFCA02886-E | 指定したTAMテーブルは，前回とテーブル属性が異なるため登録できません | 標準エラー出力

注意事項

ローディング契機にstartを指定した場合，次回再開始時，該当するTAMテーブルのローディング契機はTAMサービス開始時となります。

オンラインから一度切り離したTAMテーブルを再び追加登録する場合，OpenTP1が次の項目についてチェックします。ファイル属性が異なると，tamaddコマンドはコマンドエラーとなります。

レコード長

キー長

キー開始位置

最大レコード数

インデクス種別

ハッシュエントリ数

レコード内キー領域の有無

UAPでオープンしたままの状態でTAMテーブルをオンラインから切り離したあと，再びオンラインに追加すると，該当するUAPで再びTAMテーブルをオープンし直すまで，オープンしたときの-uオプション指定の有無の状態を引き継ぎます。再びオンラインにTAMテーブルを追加し，オープンし直した場合，再追加時の-uオプション指定の有無の状態が有効になります。そのため，オンライン追加時に-uオプションを指定したTAMテーブルは，TAMテーブルをオープンしたUAPが終了したあと，オンラインから切り離すか，またはTAMテーブルを再びオンラインに追加するときに，前回追加したときと同じオプションを指定することをお勧めします。

オンラインから一度切り離したTAMテーブルを再び追加登録する場合，"-a reclck"で登録されていたTAMテーブルを"-a reclck"以外に変更したり，"-a reclck"以外で登録されていたTAMテーブルを"-a reclck"に変更したりすることはできません。変更した場合，tamaddコマンドはKFCA02886-Eメッセージを出力します。

tambkup

名称

TAMファイルのバックアップ

形式

tambkup 〔-d〕 〔-o〕 ｛TAMファイル名 ファイル名｜-s TAMファイル名｝

機能

指定したTAMファイルの内容を，指定したファイルまたは標準出力にバックアップ出力します。

バックアップしたTAMファイルの内容は，tamrstrコマンドでリストアできます。

また，指定したTAMファイルのレコードを，指定したファイルにTAMデータファイルの形式で出力します。

オプション

●-d

TAMファイル内の有効レコードから，TAMデータファイルを作成します。作成するTAMデータファイルには，キー値を基に昇順にソートされたデータが格納されます。

-dオプションを指定したtambkupコマンドは，オンライン正常終了時，またはtamholdコマンドとtamrmコマンドの実行後に実行してください。

TAMファイル内に有効レコードがない場合は，エラーとなります。

TAMファイル内のレコード破壊を検知した場合は，エラーとなります。

●-o

オンライン中に，バックアップします。

このオプションは，対象となるTAMファイルがオンライン状態のときに有効です。

このオプションの指定を省略すると，オフライン状態でバックアップすることになります。この場合，次に示す手順でバックアップしてください。

tamholdコマンドを実行してTAMテーブルを論理閉塞します。

tamrmコマンドを実行して，論理閉塞したTAMテーブルをオンラインから切り離します。

-oオプションを指定しないtambkupコマンドを実行して，TAMファイルをバックアップします。

●-s

バックアップを標準出力に出力する場合に指定します。

-dオプションと-oオプションは，同時には指定できません。

コマンド引数

●TAMファイル名　　～〈パス名〉

バックアップ元のTAMファイルの名称を完全パス名で指定します。

●ファイル名　　～〈パス名〉

バックアップ先のファイルの名称を指定します。

-dオプションを指定したときは，TAMデータファイル名を指定します。

-sオプションを指定した場合は，このコマンド引数は指定できません。

注意事項

-dオプションを指定したtambkupコマンドを実行してTAMファイルを入れ替えた場合，ジャーナルの世代を合わせておく必要があります。ジャーナルの世代を合わせないで，TAMファイルの回復（tamfrcコマンドの実行），およびオンラインの再開始処理をした場合，動作は保証できません。

次の場合，TAMファイルの内容を入れ替える前の情報は，再開始時にTAMファイルには反映されません。
tamholdコマンドとtamrmコマンドを実行してオンラインから切り離したTAMファイルに対して，-dオプションを指定したtambkupコマンドを実行してTAMファイルの内容を入れ替えたあと，tamaddコマンドでオンラインに追加登録した場合

オンラインで使用中のTAMファイルに対して，-oオプションを指定しないtambkupコマンドは使用できません。

オンラインバックアップが完了すると，KFCA01738-Iメッセージが出力されます。このメッセージは，通常は標準出力に出力されますが，-sオプションを指定した場合は，標準エラー出力に出力されます。出力されたメッセージには，回復対象ジャーナルファイルの世代番号とブロック番号が含まれています。この世代番号とブロック番号からのアンロードジャーナルファイルが，TAMファイルの回復時に必要となります。

tambkupコマンドでは，バックアップするTAMファイルのサイズによってメモリ所要量が異なります。次に示す見積もり式に従って，メモリ所要量を算出してください（単位：バイト）。
400000＋A＋B

（凡例）

A：レコード数×レコード長。-dオプション指定時だけ，Aの値を加算してください。

B：対象のTAMファイルサイズ。TAMファイルサイズの見積もり式については，「付録H.6　TAMファイルのサイズの見積もり式」を参照してください。

tamcre

名称

TAMファイルの初期設定

形式

tamcre -r レコード長 -l キー領域長 -k キー開始位置 -m 最大レコード数
    〔-t〕 〔-u ハッシュエントリ使用率 〔-x〕〔-y〕〕  〔-s〕
    〔-d TAMデータファイル名〕 TAMファイル名

機能

指定したオプションに従ってTAMファイルを初期作成します。

オプション

●-r　レコード長　　～〈符号なし整数〉((1～1000000000))

TAMファイルのレコード長を指定します。

●-l　キー領域長　　～〈符号なし整数〉((1～1000000000))

キーの長さを指定します。

●-k　キー開始位置　　～〈符号なし整数〉((0～1000000000))

レコードの先頭からキーの開始位置までの長さを指定します。

-sオプションを指定する場合は，必ず0を指定してください。

●-m　最大レコード数　　～〈符号なし整数〉((1～1000000000))

TAMテーブル内の最大レコード数を指定します。

●-t

TAMテーブルをツリー形式で作成する場合に指定します。

このオプションの指定を省略すると，TAMテーブルはハッシュ形式で作成されます。省略する場合は，必ず-uオプションを指定してください。

●-u　ハッシュエントリ使用率　　～〈符号なし整数〉((1～100))

ハッシュ域として使用するインデクスの使用率を指定します。

このオプションの指定を省略する場合は，必ず-tオプションを指定してください。

●-x

通常，ハッシュ形式でTAMファイルを作成する場合，初期データがあるときはシノニム領域を最適化してTAMファイルおよび共用メモリ容量を削減しています。

このオプションを指定すると，このシノニム領域を最適化しません。

このオプションは，次の場合に指定してください。

ハッシュ形式で，オンライン中にコマンドで追加および削除をするTAMテーブルとして使用する場合

ハッシュ形式で，UAPがレコードの追加および削除をするTAMテーブルとして使用する場合

●-y

ハッシュ形式のTAMファイルで使用するハッシュ関数を変更します。次のような場合に指定してください。

キー長の割にキー値に変化がないキーを使用する場合

TAMファイル作成後に，tamhslsコマンドで得られるシノニム情報が非常に大きい場合

●-s

レコードの内容からキー領域を削除する場合に指定します。

このオプションを指定した場合，TAMファイルのレコード長は，「オプションで指定したレコード長-キー領域長」となります。

●-d　TAMデータファイル名　　～〈パス名〉

TAMテーブルを作るためのデータを格納するファイルの名称を指定します。

このオプションの指定を省略すると，物理ファイルの割り当てだけが行われます。

コマンド引数

●TAMファイル名　　～〈パス名〉

TAMテーブルを格納するOpenTP1ファイルシステム上に作成する物理ファイルの名称を指定します。

TAMサービス定義の定義コマンドtamtableに指定した物理ファイル名と同じ名称を指定してください。

すでにあるTAMファイル名を指定すると，エラーメッセージ（KFCA02836-E）が出力されます。まだ作成されていないTAMファイル名を指定し直してください。

注意事項

-tオプションと-uオプションを同時に指定するとエラーになります。

tamcreコマンドでハッシュ形式のTAMファイルを初期設定する場合，-mオプションで指定した最大レコード数分のインデクス領域を確保し，-uオプション（ハッシュエントリ使用率）で指定した分をハッシュ領域とします。また，データファイルから読み込むデータからシノニム領域を使用するレコード数を求め，そのレコード数分をシノニム領域として確保します。そのため，レコード数の合計は，-mオプションで指定した最大レコード数を超えます。ただし，領域は増えても，使用できるレコード数は最大レコード数までです。

-yオプションを指定すると，キー値からレコードを検索するためのハッシュ関数が変わり，ハッシュ値が分散する精度が上がることが期待できます。しかし，-yオプションを指定しないで作成したTAMファイルで使用するハッシュ関数と比べると，ハッシュ関数自体の性能は下がることがあります。

tamcreコマンドでは，作成するTAMファイルのサイズによってメモリ所要量が異なります。次に示す見積もり式に従って，メモリ所要量を算出してください（単位：バイト）。
400000＋A＋B＋C

（凡例）

A：レコード数×レコード長。-dオプション指定時だけ，Aの値を加算してください。

B：対象のTAMファイルサイズ。TAMファイルサイズの見積もり式については，「付録H.6　TAMファイルのサイズの見積もり式」を参照してください。

C：32ビット版のOSの場合は「レコード数×8」，64ビット版のOSの場合は「レコード数×16」

tamdel

名称

TAMファイルの削除

形式

tamdel TAMファイル名

機能

指定したTAMファイルを削除します。

コマンド引数

●TAMファイル名　　～〈パス名〉

削除するTAMファイルの名称を完全パス名で指定します。

tamfrc

名称

TAMファイルの回復

形式

tamfrc 〔-s〕 〔-e〕 〔-g〕 〔-k キー〕 〔-m〕 〔-j〕
      ｛-f 回復対象定義ファイル名｜TAMテーブル名 TAMファイル名｝
      ジャーナルファイル名 〔〔△ジャーナルファイル名〕…〕

機能

指定したジャーナルファイルを入力し，TAMファイルを回復します。

オプション

●-s

前回のTAM FRCを引き継ぎません。

このオプションの指定を省略すると，前回のTAM FRCが引き継がれます。

●-e

TAM FRC終了時に引き継ぎファイルを削除します。

このオプションを指定してTAM FRCを実行した場合，次回のTAM FRC実行時には，必ず-sオプションを指定してください。

このオプションの指定を省略すると，引き継ぎファイルは削除されません。

●-g

-sオプションの指定があり，かつジャーナル世代番号が1であるアンロードジャーナルファイルの指定がない場合でも，TAM FRCを実行します。

上記の場合，このオプションの指定を省略すると，処理は中断されます。

-sオプションの指定がない場合，このオプションを指定しても無視されます。

●-k　キー　　～((001～999))《001》

複数のTAM FRCを同時に実行する場合，それぞれ別のキーとなるように指定してください。

また，damfrcコマンド，およびmqafrcコマンドをこのコマンドと同時に，または連続して実行する場合もそれぞれ別のキーとなるように指定してください。

前回のTAM FRCを引き継ぐ場合は，前回指定したキーを指定してください。

●-m

ファイルの回復に必要なジャーナルレコードをファイル上で集積します。

このオプションの指定を省略すると，メモリ上にバッファが確保されて，ジャーナルレコードが集積されます。

●-j

jnlcolcコマンドで集積したジャーナルファイルを使用して，TAM FRCを実行します。

このオプションを指定した場合，-s，-e，および-mオプションを指定してはなりません。

このオプションの指定を省略すると，jnlunlfgコマンドで作成したアンロードジャーナルファイルを使用して，TAM FRCが実行されます。

●-f 回復対象定義ファイル名　　～〈パス名〉

回復するTAMファイルを定義したファイルの名称を指定します。

回復対象定義ファイルは次の形式で，テキストエディタを使用して作成します。

〔△〕TAMテーブル名△TAMファイル名 （改行）
〔〔△〕TAMテーブル名△TAMファイル名 （改行）〕

TAMテーブル名　　～〈1～32文字の識別子〉

回復するTAMテーブル名

TAMファイル名　　～〈1～63文字のパス名〉

回復先のTAMファイル名（完全パス名で指定）

バックアップファイルをリストアしたファイルを指定します。オンラインバックアップファイルをリストアしたファイル，またはオフラインバックアップファイルをリストアしたファイルのどちらかを指定してください。混在はできません。

コマンド引数

●TAMテーブル名　　～〈1～32文字の識別子〉

回復するTAMテーブルの名称を指定します。

●TAMファイル名　　～〈パス名〉

回復するTAMファイルの名称を完全パス名で指定します。

●ジャーナルファイル名　　～〈パス名〉

TAM FRC実行時に使用するジャーナルファイルの名称を指定します。

-jオプションを指定した場合は，集積ジャーナルファイルの名称を，-jオプションの指定を省略した場合は，アンロードジャーナルファイルの名称を指定します。

複数世代のジャーナルを処理する場合，複数のジャーナルファイルを指定します。

ただし，集積ジャーナルファイルの場合は複数指定はできません。

オンラインバックアップしたファイルを回復する場合，すべてのアンロードジャーナルファイルを指定する必要はありません。オンラインバックアップ完了時に出力されたメッセージ（KFCA01738-I）に含まれる，回復対象ジャーナルファイルの世代番号とブロック番号以降のアンロードジャーナルファイルを指定してください。

なお，オフライン状態でバックアップしたファイルを回復する場合は，すべてのアンロードジャーナルファイルを指定してください。

注意事項

tamfrcコマンドの指定が誤っている場合，メッセージIDが付いていないメッセージを出力し，tamfrcコマンドの正しい使用方法を示すことがあります。

TAMファイル名で指定するTAMファイルのファイル属性（テーブル形式，レコード長，最大レコード数，キー値有無など）は，オンラインでアクセスしたTAMテーブルに対応するTAMファイルのファイル属性と一致していなければなりません。一致していないと，tamfrcコマンドの動作は保証できません。

tamfrcコマンドは，jnlcolcコマンドを内部で使用しています。そのため，jnlcolcコマンドに関するエラーメッセージが出力されることがあります。マニュアル「OpenTP1 メッセージ」に従って対処してください。

-dオプションを指定したtambkupコマンドを実行してTAMファイルの内容を入れ替えた場合，ジャーナルの世代を合わせておく必要があります。ジャーナルの世代を合わせないでtamfrcコマンドを実行した場合の動作は保証できません。

-fオプションで回復対象定義ファイル名を指定した場合は，コマンドの引数にTAMテーブル名とTAMファイル名を指定しないでください。

tamfrcコマンドは，条件によってカレントディレクトリにテンポラリファイルを作成します。そのため，カレントディレクトリには書き込み権を設定してください。また，テンポラリファイルのディスク容量は，次のようになります。

回復しようとするTAMファイルがオフラインバックアップ※¹で取得したものをリストアしたファイルであり，tamfrcコマンドに-jオプションを指定していない場合
最大　4096+a　　 (単位：バイト)

回復しようとするTAMファイルがオンラインバックアップ※²で取得したものをリストアしたファイルであり，tamfrcコマンドに-jオプションを指定していない場合
最大　96+4096+a　(単位：バイト)

上記1，2以外の場合（tamfrcコマンドに-jオプションを指定した場合）
テンポラリファイルを作成しません。

（凡例）

a：tamfrc実行時に指定したアンロードジャーナルファイルの総ディスク容量※³

注※1

TAMファイルのバックアップ時，オフラインの状態（-oオプションなし）でtambkupコマンドを実行した場合。

注※2

TAMファイルのバックアップ時，tambkupコマンドに-oオプションを指定した場合。

注※3

アンロードジャーナルファイルの総ディスク容量は，UNIXのlsコマンドで参照できます。複数個指定した場合は，その合計になります。

jnlunlfgコマンドに-tオプションを指定して取得したアンロードジャーナルファイルを指定しないでください。

tamhold

名称

TAMテーブルの論理閉塞

形式

tamhold TAMテーブル名

機能

指定したTAMテーブルを論理閉塞します。

コマンド引数

●TAMテーブル名　　～〈1～32文字の識別子〉

論理閉塞するTAMテーブルの名称を指定します。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA01701-E | メモリ不足です | 標準エラー出力
KFCA01703-E | TAMサービスのアドレス情報を検索できません | 標準エラー出力
KFCA01704-E | TAMサービスが起動されていません | 標準エラー出力
KFCA01707-E | TAMテーブル名が誤っています | 標準エラー出力
KFCA01712-E | コマンドで指定した引数の数が正しくありません | 標準エラー出力
KFCA01750-I | TAMテーブルの論理閉塞を完了しました | メッセージログファイル
KFCA01753-E | タイムアウトとなりました | 標準エラー出力
KFCA01757-E | TAMテーブル名の文字数が32文字を超えています | 標準エラー出力
KFCA01765-E | TAMサーバのV/Rが誤っています | 標準エラー出力
KFCA01767-E | RPCでネットワーク障害が発生しました | 標準エラー出力
KFCA01770-E | TAMサービスが終了処理中です | 標準エラー出力
KFCA01775-E | 定義解析中にエラーが発生しました | 標準エラー出力
KFCA02852-I | ヘルプメッセージ | 標準出力
KFCA02860-E | 指定したTAMテーブルはすでに障害閉塞されています | 標準エラー出力
KFCA02861-E | 指定したTAMテーブルはすでに論理閉塞されています | 標準エラー出力
KFCA02874-W | トランザクション実行中のため，論理閉塞処理を再試行します | 標準エラー出力

tamhsls

名称

ハッシュ形式のTAMファイルおよびTAMテーブルのシノニム情報の表示

形式

tamhsls ｛ -m TAMテーブル名 ｜ TAMファイル名 ｝

機能

指定したハッシュ形式のTAMテーブルおよびTAMファイルのシノニムに関する情報を表示します。

オプション

●-m

OpenTP1オンライン中に，ローディング済みTAMテーブルのシノニムに関する情報を表示します。このオプション指定時は，コマンド引数にローディング済みTAMテーブル名を指定してください。

コマンド引数

●TAMテーブル名　　～〈1～32文字の識別子〉

シノニムに関する情報を表示させたいローディング済みハッシュ形式のTAMテーブルの名称を指定します。ツリー形式のTAMテーブルを指定した場合，情報は表示されません。

●TAMファイル名　　～〈パス名〉

シノニムに関する情報を表示させたいハッシュ形式のTAMファイルの名称を完全パス名で指定します。ツリー形式のTAMファイルを指定した場合，情報は表示されません。

出力形式

HASH FUNCTION NO = a
    RECNO  EFFECT  SYN_COUNT  KEY
   bb...bb  cc...cc     dd...dd  ee...ee

a：使用されているハッシュ関数番号

0…従来のハッシュ関数

1…新しいハッシュ関数

bb...bb：TAMテーブル内レコード番号

cc...cc：有効無効表示

0…未使用

2…使用中

dd...dd：このレコード（ハッシュ領域）につながるシノニム領域のレコード数。UAPでTAMテーブルのレコードにアクセスするとき，まずキー値をハッシュ関数を使用してハッシュ値に変換し，レコード番号とします。次に，変換したレコード番号のキー値ee...eeとUAPが指定したキー値を比較します。ee...eeがUAPが指定したキー値ではない場合，dd...dd個あるシノニム領域のレコードをシーケンシャルサーチします。

ee...ee：このレコード（ハッシュ領域）のキー値（16進数表示）

出力メッセージ

メッセージID | 内容 | 出力先
KFCA01700-E | 指定したファイルはTAMファイルではありません | 標準エラー出力
KFCA01704-E | TAMサービスが起動されていません | 標準エラー出力
KFCA01707-E | TAMテーブル名が誤っています | 標準エラー出力
KFCA01709-E | TAMファイルに対するアクセス権がありません | 標準エラー出力
KFCA01710-E | スペシャルファイルに対するアクセス権がありません | 標準エラー出力
KFCA01711-E | OpenTP1ファイルシステムとして初期化されていません | 標準エラー出力
KFCA01715-E | 指定したTAMファイルはスペシャルファイル名ではありません | 標準エラー出力
KFCA01716-E | 指定したファイルはほかのプロセスで使用中です | 標準エラー出力
KFCA01773-E | バージョン不正 | 標準エラー出力
KFCA02811-E | コマンド実行中にプロセス固有領域のメモリ不足が発生しました | 標準エラー出力
KFCA02812-E | 入出力エラーが発生しました | 標準エラー出力
KFCA02818-E | TAMファイルから入力できません | 標準エラー出力
KFCA02835-E | レコード破壊が発生しました | 標準エラー出力
KFCA26205-E | TAMコマンドの使用方法が誤っています | 標準エラー出力
KFCA26206-I | ヘルプメッセージ | 標準出力
KFCA26207-E | TAMシノニム情報取得時にエラーが発生しました | 標準エラー出力

tamlckls

名称

TAM排他資源名称の変換

形式

tamlckls 資源名称 〔資源名称〕…

機能

テーブル資源の場合：TAMテーブル名称

レコード資源の場合：TAMテーブル名称およびレコードのキー値

コマンド引数

●資源名称　　～〈文字列〉

変換したい資源名称を指定します。資源名称は次のとおりです。

テーブル資源：先頭が'T'で始まる6バイトの文字列

レコード資源：先頭が'R'で始まる16バイトの文字列

どちらもlcklsコマンド，またはデッドロック情報ファイルなどの出力情報です。

出力形式

Resource Name =[aa...aa]
              --> TAM Table name = [bb...bb]
              --> TAM Record Key (Length=[cc])
              [dd...dd] :ee...ee               1

1：この行は16バイトまで出力されます。16バイトを超えた場合は，複数行に出力されます。16バイトに満たない部分は'00'で埋められます。

aa...aa：引数に指定された資源名称

bb...bb：資源名称に対応したTAMテーブル名称

cc：レコード資源の場合のレコードのキー値の長さ

dd...dd：レコード資源の場合のレコードのキー値(16バイトの16進数字)

ee...ee：レコード資源の場合のレコードのキー値。印字可能な文字の場合はキャラクタ，印字不可の文字の場合は' . 'で出力されます。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA20203-E | 排他情報取得処理中にエラーが発生しました | 標準エラー出力
KFCA20204-I | ヘルプメッセージ | 標準出力
KFCA20205-E | コマンドの引数に誤りがあります | 標準エラー出力

tamload

名称

TAMテーブルのロード

形式

tamload TAMテーブル名

機能

指定したTAMテーブルをメモリ上にロードします。

ただし，ロードできるのは，TAMサービス定義でローディング契機にcmdを指定したTAMテーブルだけです。ローディング契機がcmd以外の場合，エラーとなります。

TAMテーブル状態が障害閉塞状態の場合にtamloadコマンドを入力すると，エラーとなります。また，障害閉塞状態以外の場合でも，-fオプション指定のtamrlesコマンドで閉塞を解除したTAMテーブルを，tamloadコマンドでロードしようとすると，エラーになります。

コマンド引数

●TAMテーブル名　　～〈1～32文字の識別子〉

TAMテーブルの名称を指定します。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA01700-E | 指定したファイルはTAMファイルではありません | 標準エラー出力
KFCA01701-E | メモリ不足です | 標準エラー出力
KFCA01703-E | TAMサービスのアドレス情報を検索できません | 標準エラー出力
KFCA01704-E | TAMサービスが起動されていません | 標準エラー出力
KFCA01707-E | TAMテーブル名が誤っています | 標準エラー出力
KFCA01712-E | コマンドで指定した引数の数が正しくありません | 標準エラー出力
KFCA01753-E | タイムアウトとなりました | 標準エラー出力
KFCA01757-E | TAMテーブル名の文字数が32文字を超えています | 標準エラー出力
KFCA01761-E | I／Oエラーが発生しました | 標準エラー出力
KFCA01762-E | レコード破壊が発生しました | 標準エラー出力
KFCA01764-E | TAMテーブルのV／Rが誤っています | 標準エラー出力
KFCA01765-E | TAMサーバのV／Rが誤っています | 標準エラー出力
KFCA01767-E | RPCでネットワーク障害が発生しました | 標準エラー出力
KFCA01770-E | TAMサービスが終了処理中です | 標準エラー出力
KFCA01775-E | 定義解析中にエラーが発生しました | 標準エラー出力
KFCA02851-I | ヘルプメッセージ | 標準出力
KFCA02867-E | ローディング契機が運用コマンド入力時以外です | 標準エラー出力
KFCA02869-E | TAMテーブルはロードされています | 標準エラー出力
KFCA02871-I | TAMテーブルのロードが完了しました | メッセージログファイル
KFCA02882-E | TAMテーブルは障害閉塞状態のためロードできません | 標準エラー出力
KFCA02897-E | 障害回復待ち状態のため処理を続行できません | 標準エラー出力

tamls

名称

TAMテーブルの状態表示

形式

tamls 〔-a〕 〔TAMテーブル名〕

機能

TAMテーブルの状態を標準出力に出力します。

オプション

●-a

次に示す情報を出力する場合に指定します。

TAMファイル名

TAMファイル状態

アクセスタイプ

ローディング契機

TAMレコード長

レコード内キー領域

キー長

セキュリティ

I/O障害処理形態

キー開始位置

コマンド引数

●TAMテーブル名　　～〈1～32文字の識別子〉

TAMテーブルの名称を指定します。

このコマンド引数の指定を省略すると，すべてのTAMテーブルの状態が表示されます。

出力形式

●-aオプションを指定した場合

1：TAMテーブル名の指定を省略すると，TAMテーブルの数だけ繰り返し表示されます。

aa...aa：TAMファイル状態

normal…未閉塞

failure shutdown…障害閉塞

bb...bb：TAMテーブル状態

normal…未閉塞

logical shutdown…論理閉塞

failure shutdown…障害閉塞

failure recovery…障害回復待ち

cc...cc：インデクス種別

tree…ツリー形式

hash…ハッシュ形式

dd...dd：アクセス形態

read …参照型

rewrite…追加・削除できない更新型

write…追加・削除できる更新型

reclck…テーブル排他を確保しない，追加・削除できる更新型

ee...ee：ローディング契機

start…tamaddコマンド実行時

cmd…tamloadコマンド実行時

lib…dc_tam_open関数発行時

f ：アクセス権限のチェック

Y…チェックする

N…チェックしない

gg...gg：入出力エラー時のTAMファイルの障害処理形態

continue…処理を続行

stop…障害閉塞状態として処理を中止

hh...hh：ジャーナルを取得するモード

condense…部分ジャーナルを取得するモード

no　condense…レコード全体をジャーナルに取得するモード

●-aオプションの指定を省略した場合

1：TAMテーブル名の指定を省略すると，TAMテーブルの数だけ繰り返し表示されます。

aa...aa：TAMテーブル状態

normal …未閉塞状態

logical shutdown…論理閉塞状態

failure shutdown…障害閉塞状態

failure recovery…障害回復待ち状態

bb...bb：インデクス種別

tree…ツリー形式

hash…ハッシュ形式

出力メッセージ

メッセージID | 内容 | 出力先
KFCA01701-E | メモリ不足です | 標準エラー出力
KFCA01703-E | TAMサービスのアドレス情報を検索できません | 標準エラー出力
KFCA01704-E | TAMサービスが起動されていません | 標準エラー出力
KFCA01707-E | TAMテーブル名が誤っています | 標準エラー出力
KFCA01712-E | コマンドで指定した引数の数が正しくありません | 標準エラー出力
KFCA01753-E | タイムアウトとなりました | 標準エラー出力
KFCA01757-E | TAMテーブル名の文字数が32文字を超えています | 標準エラー出力
KFCA01761-E | I／Oエラーが発生しました | 標準エラー出力
KFCA01764-E | TAMテーブルのV／Rが誤っています | 標準エラー出力
KFCA01765-E | TAMサーバのV／Rが誤っています | 標準エラー出力
KFCA01767-E | RPCでネットワーク障害が発生しました | 標準エラー出力
KFCA01770-E | TAMサービスが終了処理中です | 標準エラー出力
KFCA01775-E | 定義解析中にエラーが発生しました | 標準エラー出力
KFCA02854-I | ヘルプメッセージ | 標準出力
KFCA02878-E | 指定したテーブルはTAMテーブルではありません | 標準エラー出力

tamrles

名称

TAMテーブルの閉塞解除

形式

tamrles 〔-o〕 〔-f〕 TAMテーブル名

機能

指定したTAMテーブルの閉塞状態を解除します。

tamrmコマンドでオンラインから切り離されているか，またはtamunloadコマンドでアンロードされている場合は，閉塞状態解除後のTAMテーブル状態は未閉塞状態となります。

-fオプション指定のtamrlesコマンドで障害閉塞状態を解除したTAMテーブルに対して，tamholdコマンドを実行後，オプション指定なしのtamrlesコマンドを実行するとエラーとなります。

オプション

●-o

障害閉塞したTAMテーブルの閉塞状態を解除します。その後，オンライン中にアクセスできる状態となります。

TAMテーブルのステータスが障害閉塞状態以外の場合に指定すると，エラーとなります。

TAMサービス開始時，ファイルのオープンからロードまでの間に障害閉塞されたTAMテーブルの閉塞状態は解除できません。

なお，-fオプションと同時に指定できません。

●-f

障害閉塞したTAMテーブルの閉塞状態を解除します。ただし，解除後オンライン中にアクセスしようとしてもエラーとなります。オンライン中にアクセスできるようにするためには，一度オンラインからTAMテーブルを切り離し，ファイルを回復したあと，再びTAMテーブルを追加する必要があります。

TAMテーブルのステータスが障害閉塞状態以外の場合に指定すると，エラーとなります。

TAMサービス開始時，ファイルのオープンからロードまでの間に障害閉塞されたTAMテーブルの閉塞状態は，解除できません。

なお，-oオプションと同時には指定できません。

-fオプション指定のtamrlesコマンド実行後に実行する運用コマンド，および発行する関数と，その後の処理について次に示します。

実行する運用コマンド，
発行する関数
処理

tamls
failure recovery（障害回復待ち状態）を表示

tamrm，tamrles，
tamunload，tamhold
未閉塞状態として扱う

tamload
エラー

tamhold実行後のtamls
failure recovery（障害回復待ち状態）を表示

tamhold実行後のtamrles
エラー

-oオプション指定のtambkup
エラー

dc_tam_get_inf関数
リターン値　DCTAM_STS_OHLD（障害閉塞状態）を返す

tamhold実行後の
dc_tam_get_inf関数
リターン値　DCTAM_STS_LHLD（論理閉塞状態）を返す

コマンド引数

●TAMテーブル名　　～〈1～32文字の識別子〉

閉塞状態を解除するTAMテーブルの名称を指定します。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA01701-E | メモリ不足です | 標準エラー出力
KFCA01703-E | TAMサービスのアドレス情報を検索できません | 標準エラー出力
KFCA01704-E | TAMサービスが起動されていません | 標準エラー出力
KFCA01707-E | TAMテーブル名が誤っています | 標準エラー出力
KFCA01712-E | コマンドで指定した引数の数が正しくありません | 標準エラー出力
KFCA01751-I | TAMテーブルの閉塞解除を完了しました | メッセージログファイル
KFCA01753-E | タイムアウトとなりました | 標準エラー出力
KFCA01757-E | TAMテーブル名の文字数が32文字を超えています | 標準エラー出力
KFCA01765-E | TAMサーバのV／Rが誤っています | 標準エラー出力
KFCA01767-E | RPCでネットワーク障害が発生しました | 標準エラー出力
KFCA01770-E | TAMサービスが終了処理中です | 標準エラー出力
KFCA01775-E | 定義解析中にエラーが発生しました | 標準エラー出力
KFCA02853-I | ヘルプメッセージ | 標準出力
KFCA02859-E | 指定したTAMテーブルは閉塞されていません | 標準エラー出力
KFCA02863-E | 指定したTAMテーブルは障害閉塞状態のため，-o，または-fオプションを指定してください | 標準エラー出力
KFCA02864-E | 指定したTAMテーブルは論理閉塞状態のため，-o，または-fオプションの指定は必要ありません | 標準エラー出力
KFCA02881-E | TAMテーブルは未ロードのため障害閉塞の解除はできません。TAMテーブルを削除してください | 標準エラー出力
KFCA02896-E | 複数のオプションは指定できません | 標準エラー出力
KFCA02897-E | 障害回復待ち状態のため処理を続行できません | 標準エラー出力

tamrm

名称

TAMテーブルの切り離し

形式

tamrm TAMテーブル名

機能

指定したTAMテーブルをオンラインから切り離します。

tamrmコマンドを実行する前に，tamholdコマンドで，TAMテーブルを論理閉塞してください。

障害閉塞状態のTAMテーブルもオンラインから切り離すことができます。

TAMサービス定義のtam_max_tblnumに指定した最大数分のTAMファイルをオンラインで使用した場合は，tamrmコマンドでオンラインから切り離しても，新たにtamaddコマンドでの追加登録はできません。ただし，オンラインから切り離したTAMテーブルとファイル属性が同じTAMテーブルの場合は，追加登録ができます。

コマンド引数

●TAMテーブル名　　～〈1～32文字の識別子〉

削除するTAMテーブルの名称を指定します。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA01701-E | メモリ不足です | 標準エラー出力
KFCA01703-E | TAMサービスのアドレス情報を検索できません | 標準エラー出力
KFCA01704-E | TAMサービスが起動されていません | 標準エラー出力
KFCA01707-E | TAMテーブル名が誤っています | 標準エラー出力
KFCA01712-E | コマンドで指定した引数の数が正しくありません | 標準エラー出力
KFCA01748-I | TAMテーブルの削除を完了しました | メッセージログファイル
KFCA01753-E | タイムアウトとなりました | 標準エラー出力
KFCA01757-E | TAMテーブル名の文字数が32文字を超えています | 標準エラー出力
KFCA01761-E | I／Oエラーが発生しました | 標準エラー出力
KFCA01765-E | TAMサーバのV／Rが誤っています | 標準エラー出力
KFCA01767-E | RPCでネットワーク障害が発生しました | 標準エラー出力
KFCA01770-E | TAMサービスが終了処理中です | 標準エラー出力
KFCA01775-E | 定義解析中にエラーが発生しました | 標準エラー出力
KFCA02855-I | ヘルプメッセージ | 標準出力
KFCA02859-E | 指定したTAMテーブルは閉塞されていません | 標準エラー出力
KFCA02875-W | トランザクション実行中のため，削除処理を再試行します | 標準エラー出力
KFCA02893-E | トランザクションが完了しないため，再試行処理を中断します | 標準エラー出力

注意事項

TAMテーブルをオンラインから切り離した状態で，オンラインダウンなどの要因で，オンラインを再開始した場合，TAMテーブルのファイル属性（レコード長，レコード数など）は引き継がれません。

tamrstr

名称

TAMファイルのリストア

形式

tamrstr ｛ファイル名 TAMファイル名｜-s TAMファイル名｝

機能

tambkupコマンドでバックアップしたファイルの内容を，ファイルまたは標準入力からTAMファイルにリストアします。

オプション

●-s

リストア元が標準入力の場合に指定します。

コマンド引数

●ファイル名　　～〈パス名〉

リストア元のファイルの名称を指定します。

-sオプションを指定した場合は，このコマンド引数は指定できません。

●TAMファイル名　　～〈パス名〉

リストア先のTAMファイルの名称を完全パス名で指定します。

注意事項

tamrtsrコマンドでは，リストアするTAMファイルのサイズによってメモリ所要量が異なります。次に示す見積もり式に従って，メモリ所要量を算出してください（単位：バイト）。

400000＋A×2

（凡例）

A：対象のTAMファイルサイズ。TAMファイルサイズの見積もり式については，「付録H.6　TAMファイルのサイズの見積もり式」を参照してください。

tamunload

名称

TAMテーブルのアンロード

形式

tamunload TAMテーブル名

機能

指定したTAMテーブルをアンロードします。障害閉塞状態のTAMテーブルもアンロードできます。

tamunloadコマンドを実行する前に，tamholdコマンドでTAMテーブルを論理閉塞してください。

コマンド引数

●TAMテーブル名　　～〈1～32文字の識別子〉

TAMテーブルの名称を指定します。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA01701-E | メモリ不足です | 標準エラー出力
KFCA01703-E | TAMサービスのアドレス情報を検索できません | 標準エラー出力
KFCA01704-E | TAMサービスが起動されていません | 標準エラー出力
KFCA01707-E | TAMテーブル名が誤っています | 標準エラー出力
KFCA01712-E | コマンドで指定した引数の数が正しくありません | 標準エラー出力
KFCA01753-E | タイムアウトとなりました | 標準エラー出力
KFCA01757-E | TAMテーブル名の文字数が32文字を超えています | 標準エラー出力
KFCA01765-E | TAMサーバのV／Rが誤っています | 標準エラー出力
KFCA01767-E | RPCでネットワーク障害が発生しました | 標準エラー出力
KFCA01770-E | TAMサービスが終了処理中です | 標準エラー出力
KFCA01771-W | トランザクション実行中のため，アンロードを再試行します | 標準エラー出力
KFCA01775-E | 定義解析中にエラーが発生しました | 標準エラー出力
KFCA02850-I | ヘルプメッセージ | 標準出力
KFCA02859-E | 指定したTAMテーブルは閉塞されていません | 標準エラー出力
KFCA02867-E | ローディング契機が運用コマンド入力時以外です | 標準エラー出力
KFCA02872-I | TAMテーブルのアンロードが完了しました | メッセージログファイル
KFCA02873-E | TAMテーブルはアンロード済です | 標準エラー出力
KFCA02893-E | トランザクションが完了しないため，再試行処理を中断します | 標準エラー出力

tptrnls

名称

OSI TP通信の未決着トランザクション情報の表示

形式

tptrnls

機能

XATMIを使用したOSI TP通信を行う未決着トランザクションのIDおよびそのステータスなどの情報を表示し，OSI TP通信をわたるトランザクションブランチの情報をOSI TP形式で表示します。

出力形式

これは一つのトランザクションブランチに対する形式です。したがって，未決着トランザクションが複数あればこの出力は複数回出力されます。また，一つのトランザクションブランチから複数のOSI TP通信を行っていれば，〔　〕で囲まれた部分は繰り返し出力されます。

aa...aa：グローバルトランザクションID（文字列）※¹

bb...bb：トランザクションブランチID（文字列）※¹

cc...cc：トランザクションブランチのステータス（文字列）※²

dd...dd：トランザクションを処理しているプロセスのプロセスID（10進数）※³

ee...ee：トランザクションブランチを開始したサーバ名（文字列）※³

ff...ff：トランザクションブランチを開始したサービス名（文字列）※³

gg...gg：アトミックアクション識別子のマスタAP名称（16進数字）※⁴

hh...hh：アトミックアクション識別子のマスタAE修飾子（10進数）※⁴

ii...ii：アトミックアクション識別子のサフィックス（アトミックアクション番号）（10進数）

jj...jj：ブランチ識別子のスーペリアAP名称（16進数字）※⁴

kk...kk：ブランチ識別子のスーペリアAE修飾子（10進数）※⁴

ll...ll：ブランチ識別子のサフィックス（ブランチ番号）（10進数）

mm...mm：相手AE名称（16進数字）※⁴

注※1

trnlsコマンドで出力されるTRNGID，TRNBIDと同じです。

注※2

trnlsで出力される第1状態と同じです。

注※3

trnlsコマンドで出力されるPID，サーバ，サービスと同じです。

注※4

TP1/NET/OSI-TP-Extendedに定義した項目と同じです。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA03770-E | XATMIのコマンド実行に失敗しました | 標準エラー出力
KFCA03771-I | XATMIに関連する未決着トランザクションはありません | 標準出力

注意事項

このコマンドはOpenTP1システム起動中にだけ使用できます。

このコマンド実行中にエラーが発生した場合，このコマンドはKFCA03770-Eメッセージを出力して終了します。

このコマンドの実行時，XATMIに関連する未決着トランザクションブランチの情報が一つもない場合，このコマンドはKFCA03771-Iメッセージを出力して終了します。

このコマンドはオプションおよび引数をとりません。このコマンドにオプションや引数を与えても無視されます。

trncmt

名称

トランザクションのコミット

形式

trncmt ｛-t 〔-af〕｜-T トランザクショングローバル識別子 〔-afq〕｝

機能

trnlsコマンドを実行して表示された情報中のステータスがREADY状態のときに，トランザクションブランチを強制的にコミットし，ほかのトランザクションブランチに連絡完了後，トランザクションを終了します。ルートトランザクションブランチがコミットされた場合に実行してください。

trncmtコマンドは，グローバルトランザクションを構成している各トランザクションブランチが何らかの要因（通信障害など）でトランザクションを決着できないときに実行します。

trncmtコマンドを実行してトランザクションをコミットする場合，ほかのトランザクションとの不整合を発生させないために，グローバルトランザクション内のほかのトランザクションブランチもコミットしてください。通信障害が発生している場合，トランザクションブランチ間の連絡が完了するまでトランザクションを終了できません。このとき，-fオプションを指定すると，トランザクションを強制的に終了できます。通信障害が一時的な場合，-fオプションは指定しないでtrncmtコマンドを実行してください。

オプション

●-t

該当する計算機のトランザクションマネジャが管理しているトランザクションで，READY（p，n）状態のすべてのトランザクションのコミットを受け付けます。さらに，コミットするトランザクションに関する情報を標準出力に出力します。

●-a

トランザクションに関する全情報を標準出力に出力します。

このオプションの指定を省略すると，トランザクションに関する情報のうち，OpenTP1のシステムノードIDからサービス名までが標準出力に出力されます。

●-f

トランザクションを強制終了します。

-fオプションの指定を省略すると，トランザクションは強制終了されません。

●-T　トランザクショングローバル識別子　　～〈16文字の英数字〉

指定されたトランザクショングローバル識別子を持つトランザクションが，READY（p，n）状態であればコミットを受け付けます。さらに，コミットするトランザクションに関する情報を標準出力に出力します。

ただし，-qオプションを指定した場合は，トランザクション第1状態がREADYで，トランザクション第2状態がu以外であれば，コミットを受け付けます。

トランザクショングローバル識別子は，trnls -tコマンドで知ることができます。

●-q

トランザクション第1状態がREADYで，トランザクション第2状態がu以外であれば，コミットを受け付けます。

このオプションは，-Tオプションを指定した場合だけ指定できます。また，-tオプションと組み合わせて指定できません。

出力形式

-aオプションを指定した場合，trnlsコマンドの出力形式「「trnls -ta」と指定した場合」と同じです。その他の場合は，trnlsコマンドの出力形式「-a，および-cオプションを指定しない場合」と同じです。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA00970-E | trncmtコマンドの処理エラーです | 標準エラー出力
KFCA00976-I | ヘルプメッセージ | 標準出力
KFCA00978-E | trncmtコマンドの使用方法が正しくありません | 標準エラー出力
KFCA00979-E | trncmtコマンドの実行環境が整っていません | 標準エラー出力

trndlinf

名称

未決着トランザクション情報ファイルの削除

形式

trndlinf -d 日数

機能

未決着トランザクション情報ファイルを削除します。

オプション

●-d　日数　　～((1～24855))

削除する日数を指定します。

trndlinfコマンド実行時刻から起算して，「24時間×日数」以前に作成された未決着トランザクション情報ファイルが削除されます。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA00970-E | trndlinfコマンドの処理でエラーが発生しました | 標準エラー出力
KFCA00972-I | ヘルプメッセージ | 標準出力
KFCA00978-E | trndlinfコマンドの使用方法が正しくありません | 標準エラー出力
KFCA00979-E | trndlinfコマンドの実行環境が整っていません | 標準エラー出力

trnfgt

名称

トランザクションの強制終了

形式

trnfgt ｛-t 〔-a〕｜-T トランザクショングローバル識別子 〔-aq〕｝

機能

トランザクションを強制終了します。

オプション

●-t

該当する計算機のトランザクションマネジャが管理しているトランザクションのうち，HEURISTIC_FORGETTING（p，n）状態のすべてのトランザクションの終了を受け付けます。さらに，終了するトランザクションに関する情報を標準出力に出力します。

●-a

トランザクションに関する全情報を標準出力に出力します。

このオプションの指定を省略すると，トランザクションに関する情報のうち，OpenTP1のシステムノードIDからサービス名までを標準出力に出力します。

●-T　トランザクショングローバル識別子　　～〈16文字の英数字〉

指定したトランザクショングローバル識別子を持つトランザクションのステータスがHEURISTIC_FORGETTING（p，n）状態の場合，トランザクションの終了を受け付けます。さらに，終了するトランザクションに関する情報を標準出力に出力します。

ただし，-qオプションを指定した場合は，トランザクション第1状態がHEURISTIC_FORGETTINGで，トランザクション第2状態がu以外であれば，トランザクションの終了を受け付けます。

トランザクショングローバル識別子は，trnls -tコマンドで知ることができます。

●-q

トランザクション第1状態がHEURISTIC_FORGETTINGで，トランザクション第2状態がu以外であれば，トランザクションの終了を受け付けます。

このオプションは，-Tオプションを指定した場合だけ指定できます。また，-tオプションと組み合わせて指定できません。

出力形式

-aオプションを指定した場合，trnlsコマンドの出力形式「「trnls -ta」と指定した場合」と同じです。その他の場合は，trnlsコマンドの出力形式「-a，および-cオプションを指定しない場合」と同じです。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA00970-E | trnfgtコマンドの処理エラーです | 標準エラー出力
KFCA00974-I | ヘルプメッセージ | 標準出力
KFCA00978-E | trnfgtコマンドの使用方法が正しくありません | 標準エラー出力
KFCA00979-E | trnfgtコマンドの実行環境が整っていません | 標準エラー出力

trnlnkrm

名称

リソースマネジャの登録と削除

形式

trnlnkrm
｛〔-A 追加するOpenTP1提供RM名〔,追加するOpenTP1提供RM名〕…〕
 〔-D 削除するOpenTP1提供RM名〔,削除するOpenTP1提供RM名〕…〕
 〔-a 追加するOpenTP1提供以外のRM名
  〔,追加するOpenTP1提供以外のRM名〕…〕
-s RMスイッチ名〔,RMスイッチ名〕…
-o 'RM関連オブジェクト名〔 RM関連オブジェクト名〕…'
〔,'RM関連オブジェクト名〔 RM関連オブジェクト名〕…'〕…
〔-d 削除するOpenTP1提供以外のRM名
  〔,削除するOpenTP1提供以外のRM名〕…〕
｜〔-n〕｝
〔-C 'コンパイルオプション名〔 コンパイルオプション名〕…'〕
〔-B 'リンケージオプション名〔 リンケージオプション名〕…'〕〔-l〕〔-f〕〔-P〕

機能

OpenTP1で使用するリソースマネジャを追加，または削除し，トランザクションサービス制御用実行形式プログラム，クライアントサービス実行形式プログラム，および標準トランザクション制御用オブジェクトファイル（dc_trn_allrm.o）を再作成します。

OpenTP1のプログラムプロダクトをインストールするとき，トランザクションサービス制御用実行形式プログラム，およびクライアントサービス実行形式プログラムには，リソースマネジャが提供するXAインタフェース用オブジェクトファイルはリンケージされていません。dcsetupコマンド実行時，インストールされているOpenTP1のプログラムプロダクトを判断し，自動的にOpenTP1提供リソースマネジャ（DAM，TAM，MCF，ISAM，およびMQA）のXAインタフェース用オブジェクトファイルをリンケージします（リソースマネジャXATMIはOpenTP1が提供するリソースマネジャですが，自動的にリンケージされません）。OpenTP1下で実行するトランザクションがそのほかのリソースマネジャをアクセスする場合は，dcsetupコマンド実行後，OpenTP1を開始する前にtrnlnkrmコマンドでOpenTP1提供以外のリソースマネジャを登録し，トランザクションサービス制御用実行形式プログラム，およびクライアントサービス実行形式プログラムを再作成する必要があります。なお，OpenTP1以外が提供するリソースマネジャを使用する場合については，マニュアル「OpenTP1 プログラム作成の手引」を参照してください。

OpenTP1は最大32個のリソースマネジャを登録できます。

トランザクションサービス制御用実行形式プログラム，およびクライアントサービス実行形式プログラムには，OpenTP1下で動作するUAPがアクセスする，すべてのリソースマネジャのXAインタフェース用オブジェクトファイルをリンケージしておく必要があります。すべてリンケージしていないと，OpenTP1にリンケージされていないリソースマネジャをアクセスするUAPを起動時，またはそのリソースマネジャが提供する関数発行時にエラーとなることがあります。

trnlnkrmコマンドは，OpenTP1がオンライン中の場合は実行できません。

また，OpenTP1が再開始待ちの場合は，trnlnkrmコマンドに-fオプションを指定してください。ただし，-fオプション指定のtrnlnkrmコマンドが正常終了したあとは，OpenTP1は再開始できません。

trnlnkrmコマンドでリソースマネジャの登録状態を変更した場合，標準トランザクション制御用オブジェクトファイルをリンケージしているUAPは，再びリンケージする必要があります。

trnlnkrmコマンドは，Cコンパイラを次に示す順序で検索します。

/bin/ccおよび/lib/ccom
/bin/ccと/lib/ccomの両方が必要です。

/usr/bin/cc

/usr/vac/bin/cc

上記の検索順序でCコンパイラが見つからない場合には，trnlnkrmコマンドを実行するプロセスの環境変数PATHの指定値に従います。trnlnkrmコマンドを実行するプロセスの環境変数PATHの指定値を優先させたい場合は，-Pオプションを指定してください。

オプション

●-A　追加するOpenTP1提供RM名　　～〈1～31文字の英数字〉

追加するOpenTP1提供のリソースマネジャの名称を指定します。

OpenTP1提供のリソースマネジャ名を次に示します。

　OpenTP1_DAM：TP1/FS/Direct Accessのリソースマネジャ名

　OpenTP1_TAM：TP1/FS/Table Accessのリソースマネジャ名

　OpenTP1_MCF：TP1/Message Controlのリソースマネジャ名

　OpenTP1_MQA：TP1/Message Queueのリソースマネジャ名

　OpenTP1_ISM：ISAM/Bのリソースマネジャ名

　OpenTP1_XATMI：XATMI OSI通信機能のリソースマネジャ名

このオプションで指定したリソースマネジャに対しては，RMスイッチ名，RM関連オブジェクト名を指定する必要はありません。

複数のRM名を指定する場合は，RM名とRM名との間をコンマ（，）で区切ります。

●-D　削除するOpenTP1提供RM名　　～〈1～31文字の英数字〉

削除するOpenTP1提供のリソースマネジャの名称を指定します。

OpenTP1提供のリソースマネジャ名を次に示します。

　OpenTP1_DAM：TP1/FS/Direct Accessのリソースマネジャ名

　OpenTP1_TAM：TP1/FS/Table Accessのリソースマネジャ名

　OpenTP1_MCF：TP1/Message Controlのリソースマネジャ名

　OpenTP1_MQA：TP1/Message Queueのリソースマネジャ名

　OpenTP1_ISM：ISAM/Bのリソースマネジャ名

　OpenTP1_XATMI：XATMI OSI通信機能のリソースマネジャ名

このオプションで指定したリソースマネジャに対しては，RMスイッチ名，RM関連オブジェクト名を指定する必要はありません。

複数のRM名を指定する場合は，RM名とRM名との間をコンマ（，）で区切ります。

●-a　追加するOpenTP1提供以外のRM名　　～〈1～31文字の英数字〉

追加するOpenTP1提供以外のリソースマネジャの名称を指定します。OpenTP1提供のリソースマネジャを指定しないでください。

このオプションで指定したリソースマネジャに対しては，RMスイッチ名，RM関連オブジェクト名を指定する必要があります。

複数のRM名を指定する場合は，RM名とRM名との間をコンマ（，）で区切ります。

●-s　RMスイッチ名

～〈先頭が英字，またはアンダスコアで始まる1～32文字の英数字〉

追加するOpenTP1提供以外のリソースマネジャのスイッチ名を指定します。

スイッチ名は，追加するリソースマネジャの仕様書を参照してください。

複数のRMスイッチ名を指定する場合は，RMスイッチ名とRMスイッチ名との間をコンマ（，）で区切ります。

RMスイッチ名とRM名は指定した順に対応します。

●-o　RM関連オブジェクト名　　～〈英数字〉

追加するOpenTP1提供以外のリソースマネジャに関連のあるオブジェクトファイル（XAインタフェース用オブジェクトファイル）の名称を指定します。

一つのリソースマネジャに対して複数のRM関連オブジェクト名を指定できます。

RM関連オブジェクト名は，追加するリソースマネジャの仕様書を参照してください。

RM関連オブジェクト名にコンマ（，）を指定する必要がある場合は，コンマ（，）の前に'¥'を挿入してください。

複数のRM関連オブジェクト名を指定する場合は，RM関連オブジェクト名とRM関連オブジェクト名との間を空白で区切ります。

複数のリソースマネジャに対するRM関連オブジェクト名を指定する場合は，一つのリソースマネジャに対するRM関連オブジェクト名の集まりをアポストロフィ（’）で囲み，それぞれの集まりの間をコンマ（，）で区切ります。

RM関連オブジェクト名とRM名は指定した順に対応します。

●-d　削除するOpenTP1提供以外のRM名　　～〈1～31文字の英数字〉

削除するOpenTP1提供以外のリソースマネジャの名称を指定します。OpenTP1提供のリソースマネジャを指定しないでください。

このオプションで指定したリソースマネジャに対しては，RMスイッチ名，RM関連オブジェクト名を指定する必要はありません。

複数のRM名を指定する場合は，RM名とRM名との間をコンマ（，）で区切ります。

●-n

OpenTP1に登録しているリソースマネジャは変更しないで，トランザクションサービス制御用実行形式プログラム，およびクライアントサービス実行形式プログラムを再作成します。

●-C　コンパイルオプション名　　～〈1～512文字の文字列〉

コンパイル実行時に使用するコンパイルオプションを指定します。

指定するコンパイルオプション名はアポストロフィ（’）で囲み，コンパイルオプション名にコンマ（，）を指定する必要がある場合は，コンマ（，）の前に'¥'を挿入してください。

複数のコンパイルオプション名を指定する場合は，コンパイルオプション名とコンパイルオプション名との間を空白で区切ります。

通常，このオプションを指定する必要はありません。

●-B　リンケージオプション名　　～〈1～512文字の文字列〉

ライブラリリンケージ実行時に使用するリンケージオプションを指定します。

指定するリンケージオプション名はアポストロフィ（’）で囲み，リンケージオプション名にコンマ（，）を指定する必要がある場合は，コンマ（，）の前に'¥'を挿入してください。

複数のリンケージオプション名を指定する場合は，リンケージオプション名とリンケージオプション名との間を空白で区切ります。trnlnkrmコマンドでは，ccコマンドを使用してリンケージを行っています。このため，指定できるリンケージオプションは，ccコマンドで指定できるオプションとなります。

通常，このオプションを指定する必要はありません。

●-l

trnlnkrmコマンドの実行経過を標準出力に出力します。

●-f

OpenTP1の状態に関係なく，trnlnkrmコマンドを強制的に実行します。ただし，OpenTP1のトランザクションサービス制御用実行形式プログラム，およびクライアントサービス実行形式プログラムを再作成するため，OpenTP1がオンライン中の場合は，実行できません。

このオプションは，OpenTP1を正常終了以外（計画停止A，計画停止B，強制停止，異常終了）で終了したあと，使用するリソースマネジャを変更してOpenTP1を正常開始する場合にだけ指定してください。

このオプションを指定したtrnlnkrmコマンドが正常終了したあとは，OpenTP1は再開始できません。

●-P

trnlnkrmコマンドを実行するプロセスの環境変数PATHの指定値に従って，使用するCコンパイラを決定します。環境変数PATHの指定値の順番に「cc」を探して，最初に見つけた「cc」を使用します。

すべてのオプションの指定を省略すると，trnlnkrmコマンドの指定方法が標準出力に出力されます。

注意事項

trnlnkrmコマンドが正常終了したあとでは，OpenTP1は再開始できません。必ず正常開始してください。

オプションを複数の行に分けて指定する場合は，オプションとオプションとの間に継続符号 '¥'を挿入して改行してください。一つのオプションの指定値の途中（例えば，-oオプションで複数のRM関連オブジェクト名を指定する場合の，RM関連オブジェクト名とRM関連オブジェクト名との間）で改行すると，コマンドが正しく動作しないことがあります。

trnls

名称

トランザクションの状態表示

形式

trnls ｛-t 〔-｛a｜c｝〕
     ｜-T トランザクショングローバル識別子〔-｛a｜c｝〕
     ｜-bc
     ｜-B システムノードID 〔-｛a｜c｝〕
     ｜-rc
     ｜-R RM名+RM拡張子 〔-｛a｜c｝〕｝

機能

トランザクションマネジャが管理しているトランザクションに関する情報，またはトランザクションブランチ数を表示します。

トランザクションに関する情報を次に示します。

トランザクショングローバル識別子
システムノードIDとグローバルトランザクション番号（グローバルトランザクションを管理するためにシステムで一意に付けた番号）を合わせた識別子

トランザクションブランチ識別子
システムノードIDとトランザクションブランチ番号（トランザクションブランチを管理するためにシステムで一意に付けた番号）を合わせた識別子

トランザクション第1状態
トランザクションブランチの処理状態

トランザクション第2状態
トランザクションブランチのプロセスに関する状態

トランザクション第3状態
トランザクションブランチの通信状態

プロセスID
トランザクションブランチが動作しているプロセスのプロセスID

サーバ名
トランザクションブランチを起動しているサーバの名称

サービス名
トランザクションブランチを起動しているサービスの名称

トランザクション記述子
同一トランザクショングローバル識別子を持つトランザクションブランチを区別するためのインデクス番号

ブランチ記述子
一つのトランザクションブランチから分岐したトランザクションブランチを区別するためのインデクス番号

親トランザクション記述子
該当するトランザクションブランチを生成したトランザクションのトランザクション記述子

トランザクションブランチ数の表示内容を次に示します。

トランザクショングローバル識別子
システムノードIDとグローバルトランザクション番号（グローバルトランザクションを管理するためにシステムで一意に設けた番号）を合わせた識別子

システムノードID
OpenTP1のシステムノードID

リソースマネジャ名
トランザクションブランチ下で使用しているリソースマネジャの名称

トランザクションブランチ数
処理中のトランザクションブランチの数

オプション

●-t

すべてのトランザクションに関する情報を表示します。

●-a

トランザクションに関する全情報を表示します。

●-c

同時に指定したオプションに合わせて，トランザクションブランチ数を表示します。

-a，および-cオプションの指定を省略すると，トランザクションに関する情報のうち，1.～8.が表示されます。

●-T　トランザクショングローバル識別子　　～〈16文字の英数字〉

指定したトランザクショングローバル識別子を持つトランザクションに関する情報を表示します。

トランザクショングローバル識別子は，trnls -tコマンドで知ることができます。

●-b

分岐したトランザクションに関する情報を表示します。

●-B　システムノードID　　～〈8文字の英数字〉

指定したシステムノードIDの計算機へブランチしたトランザクションに関する情報を表示します。

●-r

リソースマネジャに接続しているトランザクションに関する情報を表示します。

●-R　RM名＋RM拡張子　　～〈1～33文字の英数字〉

指定した名称のリソースマネジャに接続しているトランザクションに関する情報を表示します。

OpenTP1提供のリソースマネジャ名を次に示します。

　OpenTP1_DAM ：TP1/FS/Direct Accessのリソースマネジャ名

　OpenTP1_TAM ：TP1/FS/Table Accessのリソースマネジャ名

　OpenTP1_MCF ：TP1/Message Controlのリソースマネジャ名

あるMCFに接続しているトランザクションに関する情報を表示させる場合，MCFのRM名＋MCFのRM拡張子（表示させたいMCFのマネジャプロセス識別子）を指定します。

　OpenTP1_MQA：TP1/Message Queueのリソースマネジャ名

　OpenTP1_ISM：ISAM/Bのリソースマネジャ名

「RM拡張子」は，トランザクションサービス定義の定義コマンドtrnstringの-iオプションを指定した場合に付けてください。

出力形式

●「trnls -ta」と指定した場合

1，および2：1行で表示します。

2：トランザクションが複数ある場合，トランザクションの数だけ繰り返し表示します。

aaaaaaaa：OpenTP1のシステムノードID（8文字）

bbbbbbbb：グローバルトランザクション番号（8けた）

cccccccc：トランザクションブランチ番号（8けた）

dd...dd：トランザクション第1状態（20文字以内）

BEGINNING…トランザクションブランチ開始処理中状態

ACTIVE…実行中状態

SUSPENDED…中断中状態

IDLE…同期点処理へ移行状態

PREPARE…コミット（1相目）処理中状態

READY…コミット（2相目）処理待ち状態

HEURISTIC_COMMIT…ヒューリスティック決定コミット処理中状態

HEURISTIC_ROLLBACK…ヒューリスティック決定ロールバック処理中状態

COMMIT…コミット処理中状態

ROLLBACK_ACTIVE…ロールバック処理待ち状態

ROLLBACK…ロールバック処理中状態

HEURISTIC_FORGETTING…ヒューリスティック決定後のトランザクションブランチ終了処理中状態

FORGETTING…トランザクションブランチ終了処理中状態

e：トランザクション第2状態（1文字）

u…ユーザサーバプロセスでのユーザサーバ実行中状態

r…トランザクション回復プロセスでのトランザクションブランチ回復処理実行中状態

p…トランザクション回復プロセスでの他トランザクションブランチの回復処理完了待ち状態
なお，第1状態がREADYでルートトランザクションブランチが同一計算機内にない場合，ユーザの指示待ち状態です。また，XAリソースサービスを使用している場合，XAリソースサービスの指示待ち状態です。

f：トランザクション第3状態（1文字）

s…送信中※

r…受信中※

n…送受信中※ではありません

gg...gg：プロセスID（10進数）

hh...hh：サーバ名（8文字以内）

ii...ii：サービス名（32文字以内）　ただし，SUPの場合は空白

jjjjjjjjjj：トランザクション記述子（10進数）

kkkkkkkkkk：ブランチ記述子（10進数）　ただし，ルートトランザクションブランチの場合は，'**********'が表示されます。

llllllllll：親トランザクション記述子（10進数）　ただし，ルートトランザクションブランチの場合は，'**********'が表示されます。

注※

送信中，受信中とは，トランザクションブランチ間の同期合わせのことです。

●「trnls -tc」，または「trnls -T　トランザクショングローバル識別子 -c」と指定した場合

1：グローバルトランザクションの数だけ繰り返し表示します。

aaaaaaaa：OpenTP1のシステムノードID（8文字）

bbbbbbbb：グローバルトランザクション番号（8けた）

ccccc：グローバルトランザクション内のトランザクションブランチ数（10進数）

●「trnls -bc」，または「trnls -B　システムノードID -c」と指定した場合

1：トランザクションが実行されている計算機の数だけ繰り返し表示します。

aaaaaaaa：OpenTP1のシステムノードID（8文字）

bbbbb：該当する計算機で現在実行されているトランザクションブランチ数（10進数）

●「trnls -rc」，または「trnls　-R　RM名＋RM拡張子　-c」と指定した場合

1：トランザクションを実行中のリソースマネジャの数だけ繰り返し表示します。

aa...aa：リソースマネジャ名＋リソースマネジャ拡張子（33文字以内）

bbbbb：該当するリソースマネジャで，現在実行されているトランザクションブランチ数（10進数）

●-a，および-cオプションを指定しない場合

1：トランザクションの数だけ繰り返し表示します。

aaaaaaaa：OpenTP1のシステムノードID（8文字）

bbbbbbbb：グローバルトランザクション番号（8けた）

cccccccc：トランザクションブランチ番号（8けた）

dd...dd：トランザクション第1状態（20文字以内）
詳細は「「trnls -ta」と指定した場合」を参照してください。

e：トランザクション第2状態（1文字）
詳細は「「trnls -ta」と指定した場合」を参照してください。

f：トランザクション第3状態（1文字）
詳細は「「trnls -ta」と指定した場合」を参照してください。

gg...gg：プロセスID（10進数）

hh...hh：サーバ名（8文字以内）

ii...ii：サービス名（32文字以内）　ただし，SUPの場合は空白

出力メッセージ

メッセージID | 内容 | 出力先
KFCA00970-E | trnlsコマンドの処理エラーです | 標準エラー出力
KFCA00975-I | ヘルプメッセージ | 標準出力
KFCA00978-E | trnlsコマンドの使用方法が正しくありません | 標準エラー出力
KFCA00979-E | trnlsコマンドの実行環境が整っていません | 標準エラー出力

注意事項

CUPから起動するトランザクションは，クライアントサービス定義のparallel_countオペランドで指定した最大プロセス数まで同時に実行できます。このプロセス上で実行しているトランザクションの状態は，trnlsコマンドで確認できます。trnlsコマンドを実行すると，サーバ名は'_clttrn'と表示されます。

trnlsrm

名称

リソースマネジャの情報の表示

形式

trnlsrm 〔-o ファイル名〔,ファイル名〕…〕〔-s〕

機能

OpenTP1，UAP，またはトランザクション制御用オブジェクトに登録されているリソースマネジャの情報を表示します。

オプション

●-o　ファイル名　　～〈完全パス名〉

指定したファイルに登録されているリソースマネジャの情報を標準出力に出力します。

指定できるファイルは，UAPの実行形式プログラムを格納しているファイル，またはトランザクション制御用オブジェクトファイルだけです。

複数のファイルを指定する場合は，ファイル名とファイル名との間をコンマ（，）で区切ってください。

●-s

OpenTP1に登録されているリソースマネジャの情報を標準出力に出力します。

すべてのオプションの指定を省略すると，-sオプションが仮定されます。

出力形式

1，および2：登録されているリソースマネジャの数だけ繰り返し表示します。ただし，同一ファイルに対する表示の場合，ファイル名は先頭行だけに表示します。

2：RM関連オブジェクトが二つ以上ある場合，RM関連オブジェクトの数だけ繰り返し表示します。

aa...aa ：「システム」，または指定したファイル名（パス名は除く）

bb...bb ：リソースマネジャ名（31文字以内）

c ：リソースマネジャの第1属性

B…OpenTP1提供のリソースマネジャ

N…OpenTP1提供以外のリソースマネジャ

d ：リソースマネジャの第2属性

O…1相コミット制御可能

N…1相コミット制御不可能

ee...ee：RMスイッチ名（32文字以内）
OpenTP1提供のリソースマネジャの場合は，'********'が表示されます。

ff...ff：RM関連オブジェクト名
OpenTP1提供のリソースマネジャの場合は，'********'が表示されます。

trnmkobj

名称

トランザクション制御用オブジェクトファイルの作成

形式

trnmkobj -o トランザクション制御用オブジェクト名
      〔-R OpenTP1提供RM名〔,OpenTP1提供RM名〕…〕
      〔-r OpenTP1提供以外のRM名〔,OpenTP1提供以外のRM名〕…〕
      〔-C 'コンパイルオプション名〔△コンパイルオプション名〕…'〕
      〔-l〕〔-P〕

機能

UAPがアクセスするリソースマネジャに従って，$DCDIR/spool/trnrmcmd/userobj下に「トランザクション制御用オブジェクト名.o」という名称でトランザクション制御用オブジェクトファイルを作成します。作成したトランザクション制御用オブジェクトファイルと，リソースマネジャが提供するオブジェクトファイル（XAインタフェース用オブジェクトファイル）をUAPにリンケージしてください。リンケージすると，OpenTP1下でリソースマネジャにアクセスするトランザクションを実行できます。

なお，トランザクション制御用オブジェクトファイルをUAPにリンケージするためのccコマンドを実行するときは，「トランザクション制御用オブジェクト名.o」を-Lオプションの前に指定してください。

OpenTP1下でリソースマネジャにアクセスしないトランザクションを実行するUAPの場合，またはOpenTP1下でトランザクションを実行しないUAPの場合は，trnmkobjコマンドを実行する必要はありません。

ただし，グローバルトランザクションを構成するすべてのUAPに，同じリソースマネジャをリンケージすると，コミット処理を最適化（プロセス間通信を抑止）できて，トランザクション性能が向上します。

また，OpenTP1に登録されているすべてのリソースマネジャから成る標準トランザクション制御用オブジェクトファイル（$DCDIR/spool/trnrmcmd/userobj/dc_trn_allrm.o）を使用する場合は，trnmkobjコマンドを実行する必要はありません。

-R，および-rオプションの指定を両方とも省略した場合，OpenTP1に登録されているリソースマネジャと同一のリソースマネジャを使用して，トランザクション制御用オブジェクトファイルを作成します。

trnlnkrmコマンドでリソースマネジャの登録状態を変更した場合，次のどちらかのファイルをリンケージしているUAPは，再びリンケージする必要があります。

標準トランザクション制御用オブジェクトファイル

-R，および-rオプションの指定を両方とも省略したtrnmkobjコマンドで作成したトランザクション制御用オブジェクトファイル

トランザクション制御用オブジェクトは，同一のリソースマネジャを使用するUAP間で共用できます。そのため，UAPごとにtrnmkobjコマンドを実行する必要はありません。

OpenTP1に登録されていないリソースマネジャは指定できません。

trnmkobjコマンドは，Cコンパイラを次に示す順序で検索します。

/bin/ccおよび/lib/ccom
/bin/ccと/lib/ccomの両方が必要です。

/usr/bin/cc

/usr/vac/bin/cc

上記の検索順序でCコンパイラが見つからない場合には，trnmkobjコマンドを実行するプロセスの環境変数PATHの指定値に従います。trnmkobjコマンドを実行するプロセスの環境変数PATHの指定値を優先させたい場合は，-Pオプションを指定してください。

オプション

●-o　トランザクション制御用オブジェクト名　　～〈1～12文字の英数字〉

トランザクション制御用オブジェクトの名称を指定します。

●-R　OpenTP1提供RM名　　～〈1～31文字の英数字〉

UAPからアクセスするOpenTP1提供のリソースマネジャの名称を指定します。

OpenTP1に登録されていないリソースマネジャは指定できません。

OpenTP1提供のリソースマネジャ名を次に示します。

　OpenTP1_DAM ：TP1/FS/Direct Accessのリソースマネジャ名

　OpenTP1_TAM ：TP1/FS/Table Accessのリソースマネジャ名

　OpenTP1_MCF ：TP1/Message Controlのリソースマネジャ名

　OpenTP1_MQA：TP1/Message Queueのリソースマネジャ名

　OpenTP1_ISM ：ISAM/Bのリソースマネジャ名

複数のRM名を指定する場合は，RM名とRM名との間をコンマ（，）で区切ります。

●-r　OpenTP1提供以外のRM名　　～〈1～31文字の英数字〉

UAPからアクセスするOpenTP1提供以外のリソースマネジャの名称を指定します。

OpenTP1に登録されていないリソースマネジャは指定できません。

複数のRM名を指定する場合は，RM名とRM名との間をコンマ（，）で区切ります。

●-C　コンパイルオプション名　　～〈1～512文字の文字列〉

コンパイル実行時に使用するコンパイルオプションを指定します。

指定するコンパイルオプション名はアポストロフィ（’）で囲み，コンパイルオプション名にコンマ（，）を指定する必要がある場合は，コンマ（，）の前に'¥'を挿入してください。複数のコンパイルオプション名を指定する場合は，コンパイルオプション名とコンパイルオプション名との間を空白で区切ります。

通常，このオプションを指定する必要はありません。

●-l

trnmkobjコマンドの実行経過を標準出力に出力します。

●-P

trnmkobjコマンドを実行するプロセスの環境変数PATHの指定値に従って，使用するCコンパイラを決定します。環境変数PATHの指定値の順番に「cc」を探して，最初に見つけた「cc」を使用します。

すべてのオプションの指定を省略すると，trnmkobjコマンドの指定方法が標準出力に出力されます。

trnrbk

名称

トランザクションのロールバック

形式

trnrbk ｛-t 〔-af〕｜-T トランザクショングローバル識別子〔-afq〕｝

機能

trnlsコマンドを入力して表示された情報中のステータスがREADY状態のときに，トランザクションブランチを強制的にロールバックし，ほかのトランザクションブランチに連絡完了後，トランザクションを終了します。ルートトランザクションブランチがロールバックされた場合に実行してください。

trnrbkコマンドは，グローバルトランザクションを構成している各トランザクションブランチが何らかの要因（通信障害など）でトランザクションを決着できないときに実行します。

trnrbkコマンドを実行してトランザクションをロールバックする場合，ほかのトランザクションとの不整合を発生させないために，グローバルトランザクション内のほかのトランザクションブランチもロールバックしてください。通信障害が発生している場合，トランザクションブランチ間の連絡が完了するまでトランザクションを終了できません。このとき，-fオプションを指定すると，トランザクションを強制的に終了できます。通信障害が一時的な場合，-fオプションは指定しないでtrnrbkコマンドを実行してください。

オプション

●-t

該当する計算機のトランザクションマネジャが管理しているトランザクションで，READY（p，n）状態のすべてのトランザクションのロールバックを受け付けます。さらに，ロールバックするトランザクションに関する情報を標準出力に出力します。

●-a

トランザクションに関する全情報を標準出力に出力します。

このオプションの指定を省略すると，トランザクションに関する情報のうち，OpenTP1のシステムノードIDからサービス名までが標準出力に出力されます。

●-f

トランザクションを強制終了します。

-fオプションの指定を省略すると，トランザクションは強制終了されません。

●-T　トランザクショングローバル識別子　　～〈16文字の英数字〉

指定されたトランザクショングローバル識別子を持つトランザクションが，READY（p，n）状態であればロールバックを受け付けます。さらに，ロールバックするトランザクションに関する情報を標準出力に出力します。

ただし，-qオプションを指定した場合は，トランザクション第1状態がREADYで，トランザクション第2状態がu以外であれば，ロールバックを受け付けます。

トランザクショングローバル識別子は，trnls -tコマンドで知ることができます。

●-q

トランザクション第1状態がREADYで，トランザクション第2状態がu以外であれば，ロールバックを受け付けます。

このオプションは，-Tオプションを指定した場合だけ指定できます。また，-tオプションと組み合わせて指定できません。

出力形式

-aオプションを指定した場合，trnlsコマンドの出力形式「「trnls -ta」と指定した場合」と同じです。その他の場合は，trnlsコマンドの出力形式「-a，および-cオプションを指定しない場合」と同じです。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA00970-E | trnrbkコマンドの処理エラーです | 標準エラー出力
KFCA00977-I | ヘルプメッセージ | 標準出力
KFCA00978-E | trnrbkコマンドの使用方法が正しくありません | 標準エラー出力
KFCA00979-E | trnrbkコマンドの実行環境が整っていません | 標準エラー出力

trnstics

名称

トランザクション統計情報の取得開始，終了

形式

trnstics ｛-s｜-e｝

機能

トランザクション統計情報のジャーナルファイルへの取得の開始，または終了を指示します。

-sオプションを指定すると，trnsticsコマンドが正常終了したあとに開始されるトランザクションから，トランザクション統計情報を取得します。trnsticsコマンドが正常終了する前に，すでに開始されていたトランザクションに関しては，トランザクション統計情報を取得できません。

また，トランザクション統計情報は，ユーザサービス定義のtrn_statistics_itemオペランドにnothing以外を指定したユーザサービスが実行したトランザクションでだけ取得できます。

-eオプションを指定すると，trnsticsコマンドが正常終了したあとに開始されるトランザクションから，トランザクション統計情報を取得しません。

なお，OpenTP1再開始時は，trnsticsコマンドの指定は引き継げません。OpenTP1再開始時は，OpenTP1再開始前のトランザクションサービス定義のtrn_tran_statistics（トランザクションブランチごとの統計情報を取得するかどうか）オペランドの指定に従います。

オプション

●-s

トランザクション統計情報のジャーナルファイルへの取得を開始します。

●-e

トランザクション統計情報のジャーナルファイルへの取得を終了します。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA00970-E | trnsticsコマンドの処理でエラーが発生しました | 標準エラー出力
KFCA00973-I | ヘルプメッセージ | 標準出力
KFCA00978-E | trnsticsコマンドの使用方法が正しくありません | 標準エラー出力
KFCA01099-E | trnsticsコマンドの実行環境が整っていません | 標準エラー出力

注意事項

トランザクション統計情報を取得する場合，取得情報の種類が多くなるほどトランザクションの性能が劣化するので注意してください。

usmdump

名称

共用メモリダンプの出力

形式

usmdump 〔-a〕 〔-i 利用者識別子〕 〔ファイル名〕

機能

OpenTP1稼働中の共用メモリの内容をダンプ退避用ディレクトリ（$DCDIR/spool/save）のUNIXファイルにダンプ出力します。出力したファイルは，compressコマンドで圧縮します。ただし，適用OSがLinuxの場合は，gzipコマンドで圧縮します。

オプション

●-a

確保している共用メモリのすべての情報をダンプ出力します。-aオプションを省略した場合，共用メモリ上で実際に使用されている領域だけをダンプ出力します。

●-i　利用者識別子

ダンプ出力する共用メモリの利用者識別子を指定します。指定する利用者識別子によって，ダンプ出力する共用メモリの情報が異なります。利用者識別子には，次のどれかを指定します。

　all：OpenTP1が管理しているすべての共用メモリの情報をダンプ出力します。

　BTN：静的共用メモリおよび動的共用メモリの情報をダンプ出力します。

　dcshmls -rコマンドを実行した結果OWNERに指定された情報：OWNERに指定されたサービスの共用メモリプールの情報をダンプ出力します。例えば，DAMサービスが確保している共用メモリプールの情報をダンプ出力する場合は，damと指定します。

dcshmls -rコマンドを実行すると，静的共用メモリおよび動的共用メモリの情報のOWNERには，btnが表示されますが，静的共用メモリおよび動的共用メモリの情報をダンプ出力する場合は，-iオプションを省略するか，または-iオプションにBTNを指定してください。

このオプションを省略した場合，BTNが指定された場合と同じ動作になります。

コマンド引数

●ファイル名　～〈31バイト以内の文字列〉《shmdump》

共用メモリの情報をダンプ出力するときの出力先ファイル名を指定します。指定したファイル名で，共用メモリの情報を$DCDIR/spool/saveに出力します。なお，"$DCDIR/spool/save/指定ファイル名"と指定する場合，完全パス名の長さが255バイト以内になるようにしてください。このコマンド引数を省略した場合，shmdumpが指定されたと仮定し，$DCDIR/spoolにshmdumpというファイル名で共用メモリの情報を出力します。

xarevtr

名称

XARイベントトレース情報の表示

形式

xarevtr 〔-a〕〔-f XARイベントトレース情報ファイル〕

機能

指定したXARイベントトレース情報ファイルを編集して，コンソールに表示します。

オプション

●-a

XARイベントトレース情報のコンソール表示を詳細形式で表示します。このオプションを省略した場合，XARイベントトレース情報の6～10行目，および12行目の表示が省略されます。

●-f　XARイベントトレース情報ファイル

コンソールに表示するXARイベントトレース情報ファイルを指定します。このオプションを省略した場合，$DCDIR/spool/dcxarinf/trace/xarevtr1，または$DCDIR/spool/dcxarinf/trace/xarevtr2のうち，更新時刻の新しいファイルが編集対象ファイルとして仮定されます。

出力形式

aa....aa：日時（ctime形式）

bb....bb：マイクロ秒（10進数）

cc....cc：アプリケーションサーバ名称（16文字以内の文字列）

dddd：表示番号（10進数）

ee....ee：プロセスID（10進数）

ff....ff：トランザクション管理テーブル番号（10進数）

gg....gg：内部保守情報（10進数，または20文字以内の文字列）

hh....hh：要求コード名称（32文字以内）

xar_start…トランザクションブランチの開始処理

xar_call…トランザクションブランチ内からのRPCの実行

xar_end…トランザクションブランチの終了処理

xar_prepare…トランザクションブランチのコミット準備処理（2相コミットの1相目）

xar_commit…トランザクションブランチのコミット処理（2相コミットの2相目）

xar_rollback…トランザクションブランチのロールバック処理

xar_recover…Prepared状態，Heuristically Completed状態のトランザクションブランチを通知

xar_forget…Heuristically Completed状態のトランザクションブランチを破棄

xar_tbl_reserve…内部保守情報（テーブル満杯時のエントリ解放を検知）

xar_trnrcvr…内部保守情報（rapコネクション切断，またはrapサーバダウンを検知）

ii：情報取得位置（2文字）

IN…関数の入り口

OK…関数の出口（正常終了時）

ER…関数の出口（異常終了時）

jj....jj：XAリターンコード文字列（20文字以内の文字列），またはリターンコード（10進数）

kk....kk：アプリケーションサーバXID情報　GTRIDの先頭64バイト以内（16進数）

ll....ll：アプリケーションサーバXID情報　BQUALの先頭64バイト以内（16進数）

mm....mm：アプリケーションサーバXID詳細情報　フォーマットID（16進数）

nn....nn：アプリケーションサーバXID詳細情報　GTRIDサイズ（16進数）

oo....oo：アプリケーションサーバXID詳細情報　BQUALサイズ（16進数）

pp....pp：アプリケーションサーバXID　GTRID詳細情報（16進数および文字）

qq....qq：アプリケーションサーバXID　BQUAL詳細情報（16進数および文字）

rr....rr：OpenTP1 XID情報　TRNGID文字列（16文字以内）

ss....ss：OpenTP1 XID情報　TRNBID文字列（16文字以内）

tt....tt：OpenTP1 XID詳細情報（16進数）

出力メッセージ

メッセージID | 内容 | 出力先
KFCA32029-E | プロセス固有領域のメモリ不足のため処理を続行できません | 標準エラー出力
KFCA32100-I | ヘルプメッセージ | 標準出力
KFCA32101-E | XARイベントトレース情報ファイルが見つかりません | 標準エラー出力
KFCA32102-E | ファイル操作でエラーが発生しました | 標準エラー出力
KFCA32103-E | xarevtrコマンドの使用方法が不正です | 標準エラー出力
KFCA32104-E | xarevtrコマンドを実行できません | 標準エラー出力
KFCA32105-E | xarevtrコマンド実行中にエラーが発生しました | 標準エラー出力

xarfills

名称

XARファイルの状態表示

形式

xarfills XARファイル名

機能

XARファイルの状態を標準出力に出力します。

コマンド引数

●XARファイル名　　～〈パス名〉

XARファイル名を指定します。

出力形式

aa....aa：XARファイルのレコード長（単位：バイト）

bb....bb：XARファイルのレコード数

cc....cc：トランザクションブランチ数

dd....dd：XARファイルに格納できる最大RIサイズ（10進数）

ee....ee：XARファイル状態

RUNNING…正常状態

HOLD…閉塞状態

INIT…初期状態

ff....ff：XARファイルを作成した時刻
曜日△月△日△時：分：秒：年（西暦）の形式

gg....gg：オンラインを開始した時刻
曜日△月△日△時：分：秒：年（西暦）の形式

hh....hh：最後にXARファイルをクローズした時刻
曜日△月△日△時：分：秒：年（西暦）の形式

ii....ii：XARファイル名

出力メッセージ

メッセージID | 内容 | 出力先
KFCA32017-E | プロセス固有領域のメモリ不足のため処理を続行できません | 標準エラー出力
KFCA32025-E | 指定したXARファイルのパス名に誤りがあります | 標準エラー出力
KFCA32026-E | 指定したXARファイルのスペシャルファイルに対するアクセス権がありません | 標準エラー出力
KFCA32027-E | XARファイルのオープンでシステムの上限値を超えました | 標準エラー出力
KFCA32028-E | XARファイルに対してI/Oエラーが発生しました | 標準エラー出力
KFCA32029-E | メモリ不足のため処理を続行できません | 標準エラー出力
KFCA32030-E | ファイルシステム作成時のシステムとバージョンが異なっています | 標準エラー出力
KFCA32031-E | XARファイルを割り当てるスペシャルファイルはOpenTP1ファイルシステムとして初期化されていません | 標準エラー出力
KFCA32036-E | 指定したXARファイルは存在しません | 標準エラー出力
KFCA32037-E | 指定したXARファイルはほかのプロセスで使用中です | 標準エラー出力
KFCA32038-E | XARファイルに対するアクセス権がありません | 標準エラー出力
KFCA32103-E | xarfillsコマンドの使用方法が不正です | 標準エラー出力
KFCA32111-E | 指定されたファイルはXARファイルではありません | 標準エラー出力
KFCA32112-I | ヘルプメッセージ | 標準出力

xarforce

名称

XARトランザクション状態の変更

形式

xarforce ｛-c｜-r｜-f｝
        ｛-t OpenTP1トランザクションID｜
          -u クライアントトランザクションID｜
          -n エントリ番号｝

機能

指定したOpenTP1トランザクションID，クライアントトランザクションID，およびエントリ番号に対応するトランザクションの状態を変更します。

オプション

●-c

XAリソースサービスで管理しているトランザクションの状態をヒューリスティックコミットに決着します。このオプションで状態を変更できるトランザクションは，xarlsコマンドで出力されたトランザクション状態が，プリペアのトランザクションです。

●-r

XAリソースサービスで管理しているトランザクションの状態をヒューリスティックロールバックに決着します。このオプションで状態を変更できるトランザクションは，xarlsコマンドで出力されたトランザクション状態が，プリペアのトランザクションです。

●-f

XAリソースサービスで管理しているトランザクションを無効にします。このオプションで無効にできるトランザクションは，xarlsコマンドで出力されたトランザクション状態が，ヒューリスティックハザード，ヒューリスティックコミット，ヒューリスティックロールバック，またはヒューリスティックミックスのトランザクションです。

●-t　OpenTP1トランザクションID　　～〈80文字の16進数〉

状態を変更するOpenTP1トランザクションIDを指定します。OpenTP1トランザクションIDは，xarlsコマンドの-a，または-pオプションで出力されたOpenTP1トランザクションIDを指定します。

●-u　クライアントトランザクションID　　～〈280文字の16進数〉

状態を変更するクライアントトランザクションIDを指定します。クライアントトランザクションIDは，xarlsコマンドの-a，または-pオプションで出力されたIDを指定します。

●-n　エントリ番号　　～〈1～8192の10進数〉

状態を変更するトランザクションのエントリ番号を指定します。エントリ番号はxarlsコマンドの-a，または-pオプションで出力された番号を指定します。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA32029-E | メモリ不足のため処理を続行できません | 標準エラー出力
KFCA32103-E | コマンドの使用方法が不正です | 標準エラー出力
KFCA32123-E | 共用メモリを利用できないため処理を実行できません | 標準エラー出力
KFCA32124-E | XAリソースサービスのV/Rが誤っています | 標準エラー出力
KFCA32126-E | XAリソースサービスが閉塞しています | 標準エラー出力
KFCA32127-E | RPCでタイムアウトが発生しました | 標準エラー出力
KFCA32128-E | RPCでネットワーク障害が発生しました | 標準エラー出力
KFCA32130-I | ヘルプメッセージ | 標準出力
KFCA32133-E | 指定したトランザクションIDのトランザクションは存在しません | 標準エラー出力
KFCA32134-E | 指定したエントリ番号のトランザクションは存在しません | 標準エラー出力
KFCA32135-E | 指定したトランザクションIDのトランザクション状態は変更できません | 標準エラー出力
KFCA32136-E | 指定したエントリ番号のトランザクション状態は変更できません | 標準エラー出力
KFCA32137-I | トランザクションIDのトランザクションをコミットしました | 標準出力
KFCA32138-I | トランザクションIDのトランザクションをロールバックしました | 標準出力
KFCA32139-I | トランザクションIDのトランザクションを無効にしました | 標準出力
KFCA32140-I | エントリ番号のトランザクションをコミットしました | 標準出力
KFCA32141-I | エントリ番号のトランザクションをロールバックしました | 標準出力
KFCA32142-I | エントリ番号のトランザクションを無効にしました | 標準出力
KFCA32143-E | XAリソースサービスが起動していません | 標準エラー出力
KFCA32144-E | OpenTP1システムが起動していません | 標準エラー出力
KFCA32156-E | xarforceコマンド実行中にエラーを検知しました | 標準エラー出力

注意事項

エントリ番号を指定してコマンドを実行する場合，XAリソースサービスに対するアクセスを停止してから実行してください。

各オプションとトランザクション状態の対応を次に示します。

オプション | トランザクション状態
A | I | P | R | H
-c | － | － | ○ | － | －
-r | － | － | ○ | － | －
-f | － | － | － | － | ○

（凡例）

A：Active状態

I：Idle状態

P：Prepared状態

R：Rollback only状態

H：Heuristic complete状態

○：指定できます。

－：指定できません。

xarhold

名称

XAリソースサービスの閉塞

形式

xarhold

機能

XAリソースサービスを閉塞状態にします。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA32007-I | XAリソースサービスを閉塞しました | 標準出力
KFCA32029-E | メモリ不足のため処理を続行できません | 標準エラー出力
KFCA32103-E | xarholdコマンドの使用方法が不正です | 標準エラー出力
KFCA32121-I | ヘルプメッセージ | 標準出力
KFCA32124-E | XAリソースサービスのV/Rが誤っています | 標準エラー出力
KFCA32126-E | XAリソースサービスが閉塞しています | 標準エラー出力
KFCA32127-E | RPCでタイムアウトが発生しました | 標準エラー出力
KFCA32128-E | RPCでネットワーク障害が発生しました | 標準エラー出力
KFCA32143-E | XAリソースサービスが起動していません | 標準エラー出力

注意事項

XAリソースサービスに組み込まれていたXARファイルのクローズ処理で異常が発生しても，強制的にXAリソースサービスを閉塞状態にします。

xarinit

名称

XARファイルの作成

形式

xarinit -f 物理ファイル名 -n レコード数 〔-s レコード長〕

機能

OpenTP1ファイルシステム内にXARファイルを作成し，オンラインで使用できるように初期設定します。

オプション

●-f　物理ファイル名　　～〈パス名〉

作成する物理ファイル名を完全パス名で指定します。すでに存在する物理ファイルを指定するとエラーになります。

●-n　レコード数　　～〈符号なし整数〉((1～8192))

作成するXARファイルのレコード数を指定します。

●-s　レコード長　　～〈符号なし整数〉（単位：バイト）

作成するXARファイルのレコード長を指定します。OpenTP1ファイルシステム作成時（filmkfsコマンド）に指定したセクタ長（UNIX通常ファイルの場合512バイト）の倍数を指定してください。このオプションの指定を省略すると，OpenTP1ファイルシステムのセクタ長がXARファイルのレコード長になります。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA32017-E | プロセス固有領域のメモリ不足で処理を続行できません | 標準エラー出力
KFCA32025-E | 指定したXARファイルのパス名に誤りがあります | 標準エラー出力
KFCA32026-E | 指定したXARファイルのスペシャルファイルに対するアクセス権がありません | 標準エラー出力
KFCA32027-E | XARファイルのオープンでシステムの上限値を超えました | 標準エラー出力
KFCA32028-E | XARファイルに対してI/Oエラーが発生しました | 標準エラー出力
KFCA32029-E | メモリ不足のため処理を続行できません | 標準エラー出力
KFCA32030-E | ファイルシステム作成時のシステムとバージョンが異なっています | 標準エラー出力
KFCA32031-E | XARファイルを割り当てるスペシャルファイルはOpenTP1ファイルシステムとして初期化されていません | 標準エラー出力
KFCA32032-E | 指定されたXARファイル名に誤りがあります | 標準エラー出力
KFCA32033-E | 指定されたXARファイルはすでに存在します | 標準エラー出力
KFCA32034-E | OpenTP1ファイルシステムのファイル容量が不足しました | 標準エラー出力
KFCA32035-E | OpenTP1ファイルシステムのファイル数の上限値を超えました | 標準エラー出力
KFCA32037-E | 指定したXARファイルはほかのプロセスで使用中です | 標準エラー出力
KFCA32103-E | xarinitコマンドの使用方法が不正です | 標準エラー出力
KFCA32106-I | ヘルプメッセージ | 標準出力
KFCA32107-E | レコード数の指定に誤りがあります | 標準エラー出力
KFCA32108-E | 指定されたXARファイル名の長さが64文字以上です | 標準エラー出力
KFCA32162-E | レコード長の指定に誤りがあります | 標準エラー出力

注意事項

MSDTC連携機能を使用する（XAリソースサービス定義でxar_msdtc_use=Yと指定する）場合，-sオプションには1024バイト以上を指定することをお勧めします。

MSDTC連携機能を使用する場合，クライアントの環境によってはXARファイルのレコード長の不足が原因となって，KFCA32045-Eメッセージを出力してトランザクションの決着処理に失敗することがあります。この場合，次に示す手順でXARファイルを再作成してください。

OpenTP1を終了します。

KFCA32045-Eメッセージの「必要なXARファイルのレコード長」に表示された値をxarinitコマンドの-sオプションに指定して，XARファイルを再作成します。

OpenTP1を正常開始します。

バージョンが07-01以降のTP1/Server Baseで作成したXARファイルは，07-00以前のTP1/Server Baseで使用しないでください。TP1/Server Base 07-01から，XARファイルの構成が変更されるためです。07-01以降のTP1/Server Baseで作成したXARファイルを07-00以前のTP1/Server Baseで使用した場合の動作は保証しません。

xarls

名称

XARトランザクション情報の表示

形式

xarls 〔-c｜ 〔-a｜-p プロセスID〕 〔-r〕〕

機能

XAリソースサービスが管理するすべてのトランザクションの状態をコンソールに表示します。

オプション

●-c

XAリソースサービスの管理情報を表示します。

●-a

XAリソースサービスの管理情報と，XAリソースサービスで管理しているすべてのトランザクションの状態を表示します。

●-p　プロセスID　　～〈10進数〉

トランザクションのプロセスIDを指定します。指定したプロセスIDに対応するトランザクションの状態を表示します。

●-r

XAリソースサービスが管理するすべてのトランザクションの状態，RI，およびXID内のトランザクション情報を表示します。

出力形式

●トランザクション情報が表示された場合

AA....AA：エントリ番号（10進数）

BB....BB：トランザクション開始時間（ctime形式）

CC....CC：プロセスID（10進数）

XX....XX：rapリスナーのポート番号（10進数）

DD....DD：トランザクション状態

A…アクティブ

I…アイドル

P…プリペア

HH…ヒューリスティックハザード

HC…ヒューリスティックコミット

HR…ヒューリスティックロールバック

HM…ヒューリスティックミックス

***…初期状態

EE....EE：ロールバックオンリーマーク

INIT…初期状態

RBONLY1…マーク付きトランザクションあり

RBONLY2…トランザクションなし

RBONLY3…マークなしトランザクションあり

FF....FF：ロールバックオンリーになった時間（ctime形式）

GG....GG：OpenTP1トランザクションID（80文字の16進数）

HH....HH：トランザクショングローバル識別子（16文字の文字列）

II....II：トランザクションブランチ識別子（16文字の文字列）

JJ....JJ：クライアントトランザクションID（280文字の16進数）

KK....KK：DID情報（32文字の16進数）
DIDとは，MSDTCで管理するトランザクション識別子です。DID情報を持たないトランザクションブランチの場合は'****'を表示します。

LL....LL：ノードID情報（32文字の16進数）
ノードID情報を持たないトランザクションブランチの場合は'****'を表示します。

MM....MM：MSDTC連携で使用する回復情報（16進数（文字数は可変長））
回復情報を持たないトランザクションブランチの場合は'****'を表示します。

●管理部情報が表示された場合

aa....aa：XARのバージョン（10進数）

bb....bb：XARの閉塞状態（文字列）

RUNNING…正常状態

HOLD…閉塞状態

cc....cc：トランザクションブランチ数（10進数）

dd....dd：アイドル状態のトランザクションブランチ監視時間（10進数）

ee....ee：トレースレコード番号（10進数）

ff....ff：イベントレベル（10進数）

gg....gg：レコード最大数（10進数）

hh....hh：書き込み可能ファイル番号（10進数）

1…オンライン用XARファイル

2…バックアップ用XARファイル

3…書き込み可能ファイルなし

ii....ii：XARファイルに格納できる最大RIサイズ（10進数）

jj....jj：XARファイル状態（文字列）

RUNNING…正常状態

HOLD…閉塞状態

INIT…初期状態

kk....kk：物理ファイル名（文字列）

ll....ll：XARファイルのレコード数（10進数）

mm....mm：XARファイルのレコード長（10進数）

nn....nn：ファイル作成時刻（ctime形式）

oo....oo：オンライン開始時刻（ctime形式）

pp....pp：最終クローズ時刻（ctime形式）

出力メッセージ

メッセージID | 内容 | 出力先
KFCA32029-E | メモリ不足のため処理を続行できません | 標準エラー出力
KFCA32103-E | xarlsコマンドの使用方法が不正です | 標準エラー出力
KFCA32123-E | 共用メモリを利用できないため処理を実行できません | 標準エラー出力
KFCA32124-E | XAリソースサービスのV/Rが誤っています | 標準エラー出力
KFCA32129-I | ヘルプメッセージ | 標準出力
KFCA32131-E | トランザクションは存在しません | 標準エラー出力
KFCA32132-E | 指定したプロセスIDのトランザクションは存在しません | 標準エラー出力
KFCA32143-E | XAリソースサービスが起動していません | 標準エラー出力

注意事項

このコマンドで出力される情報は，処理性能への影響を極力抑えるため，排他処理をしないで情報を参照します。このため，XAリソースサービスで管理しているトランザクションの解放処理中にコマンドを実行した場合は，トランザクション状態に***が表示されます。***が表示されたトランザクションは，10進数および16進数の情報については0が表示されます。

xarrles

名称

XAリソースサービスの閉塞解除

形式

xarrles

機能

定義ファイルに指定したXARファイルをXAリソースサービスに組み込み，XAリソースサービスの閉塞状態を解除します。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA32008-I | XAリソースサービスの閉塞を解除しました | 標準出力
KFCA32029-E | メモリ不足のため処理を続行できません | 標準エラー出力
KFCA32103-E | xarrlesコマンドの使用方法が不正です | 標準エラー出力
KFCA32120-I | ヘルプメッセージ | 標準出力
KFCA32122-E | XAリソースサービスの閉塞解除に失敗しました | 標準エラー出力
KFCA32124-E | XAリソースサービスのV/Rが誤っています | 標準エラー出力
KFCA32125-E | XAリソースサービスが閉塞していません | 標準エラー出力
KFCA32127-E | RPCでタイムアウトが発生しました | 標準エラー出力
KFCA32128-E | RPCでネットワーク障害が発生しました | 標準エラー出力
KFCA32144-E | OpenTP1システムが起動していません | 標準エラー出力

注意事項

定義ファイルに指定するXARファイルには，次の制限があります。

XAリソースサービスが閉塞状態になる前に使用していたXARファイルと同じセクタ長でなければならない。

XAリソースサービスが閉塞状態になる前に使用していたXARファイルと同じレコード数でなければならない。

xarrm

名称

XARファイルの削除

形式

xarrm -f 物理ファイル名

機能

OpenTP1ファイルシステム内のXARファイルを削除します。指定したファイルが使用中の場合は，削除できません。

オプション

●-f　物理ファイル名　　～〈パス名〉

削除する物理ファイル名を完全パス名で指定します。

出力メッセージ

メッセージID | 内容 | 出力先
KFCA32017-E | プロセス固有領域のメモリ不足で処理を続行できません | 標準エラー出力
KFCA32025-E | 指定したXARファイルのパス名に誤りがあります | 標準エラー出力
KFCA32026-E | 指定したXARファイルのスペシャルファイルに対するアクセス権がありません | 標準エラー出力
KFCA32027-E | XARファイルのオープンでシステムの上限値を超えました | 標準エラー出力
KFCA32028-E | XARファイルに対してI/Oエラーが発生しました | 標準エラー出力
KFCA32029-E | メモリ不足のため処理を続行できません | 標準エラー出力
KFCA32030-E | ファイルシステム作成時のシステムとバージョンが異なっています | 標準エラー出力
KFCA32031-E | XARファイルを割り当てるスペシャルファイルはOpenTP1ファイルシステムとして初期化されていません | 標準エラー出力
KFCA32032-E | 指定されたXARファイル名に誤りがあります | 標準エラー出力
KFCA32036-E | 指定したXARファイルは存在しません | 標準エラー出力
KFCA32037-E | 指定したXARファイルはほかのプロセスで使用中です | 標準エラー出力
KFCA32038-E | XARファイルに対するアクセス権がありません | 標準エラー出力
KFCA32103-E | xarrmコマンドの使用方法が不正です | 標準エラー出力
KFCA32108-E | 指定されたXARファイル名の長さが64文字以上です | 標準エラー出力
KFCA32109-I | ヘルプメッセージ | 標準出力
KFCA32111-E | 指定されたファイルはXARファイルではありません | 標準エラー出力

付録

＜この付録の構成＞

付録A　入出力キューのダンプファイルの形式

付録B　OpenTP1のイベント

付録C　監査イベントの出力情報

付録D　メッセージ制御機能で取得するジャーナル情報

付録E　統計情報の詳細

付録F　OpenTP1が出力するファイル一覧

付録G　メッセージキュー用物理ファイルの見積もり式

付録H　OpenTP1ファイルの見積もり式

付録I　レコードロック数の見積もり式

付録J　UNIXのメッセージ送受信関数で使用する資源の見積もり式

付録K　OpenTP1ファイルシステムの見積もり式

付録L　性能検証用トレース情報の取得・解析

付録M　シナリオテンプレートの詳細

付録A　入出力キューのダンプファイルの形式

mcftdmpquコマンドを実行すると，ダンプファイルにはメッセージが連続して出力されます。ダンプファイルの形式を次の図に示します。

図A-1　ダンプファイルの形式

図A-1に示すメッセージの形式を説明します。

アイキャッチャ（4バイト）
出力したメッセージが入力キューのメッセージか，出力キューのメッセージかを示します。
ITQ△：入力キューのメッセージです。
OTQ△：出力キューのメッセージです。

MCF使用領域（960バイト）
MCFが使用する領域です。

メッセージ情報（512バイト）
出力したメッセージについての情報を格納する領域です。
構造体dc_mcf_dump_infoで参照できます。構造体dc_mcf_dump_infoの形式を次に示します。

セグメント長（4バイト），セグメント
セグメントの長さを示す領域と，セグメント長で示される長さのセグメントです。セグメント長とセグメントで一組となり，セグメント数分繰り返します。

メッセージ終了識別子（4バイト）
メッセージの終了を示す領域で，'NULL'が格納されています。

構造体dc_mcf_dump_infoの形式

/*************************************************************/
/*            入出力キューダンプ メッセージ情報              */
/*************************************************************/
struct dc_mcf_dump_info {
 char    le_name[16];               /* 入力元論理端末名称※¹ */
 char    cn_name[16];              /* 入力元コネクションID */
 char    mcf_sid[3];                /* MCF識別子 */
 char    ap_name[9];                /* アプリケーション名※² */
 char    ap_kind[5];              /* アプリケーション種別※² */
                   /* value<"mcf "=システムアプリケーション */
                   /*       "user"=ユーザ アプリケーション> */
 char    sg_name[32];                 /* サービスグループ名 */
 char    sv_name[32];                 /* サービス名 */
 char    map_name[9];                 /* マップ名 */
 char    yobi1[2];                    /* 予備1 */
 struct {                         /* メッセージ書き込み時間 */
   unsigned int  tvsec;     /* 1970年1月1日からの通算秒 */
   int    tvsec;                    /* 秒以下 */
 } write_time;
 struct {                            /* 入力通番構造体 */
   unsigned int  time;              /* 入力通番取得時刻 */
                           /* (1970年1月1日からの通算秒) */
   int    no_in_time;         /* 同時刻での枝番(初期値=1) */
   char    yobi1[8];                /* 予備1 */
 } recv_no;
 struct {                           /* 出力通番構造体※1 */
   int    no;                      /* 出力通番 */
   char    type[2];                 /* 出力通番識別 */
                                    /* value<"n"=一般 */
                                    /*       "p"=優先 */
                                    /*       "o"=応答> */
   char    yobi1[2];                /* 予備1 */
 } send_no;
 char    exec_ap_name[9];   /* 起動先アプリケーション名※¹※³ */
 char    exec_ap_kind[5];   /* 起動先アプリケーション種別※¹※³ */
                            /* value<"mcf "=システムアプリケーション */
                            /*       "user"=ユーザ アプリケーション> */
 char    send_le_name[16];         /* 出力先論理端末名称 */
 char    yobi2[326];               /* 予備2 */
};

注※1

出力キューダンプのときだけ設定されます。

注※2

SPPからメッセージを送信した場合は，アプリケーション名に'*******'，アプリケーション種別に'****'が設定されます。

注※3

アプリケーションを起動しなかった場合は，起動先アプリケーション名に'*******'，起動先アプリケーション種別に'****'が設定されます。

付録B　OpenTP1のイベント

OpenTP1では，開始，終了などのイベントをJP1イベントサービス機能に登録できます。登録したイベントは，JP1ジョブ管理機能で利用できます。JP1イベントサービス機能についてはマニュアル「JP1/Base 運用ガイド」を，JP1ジョブ管理機能については，JP1/AJS関連のマニュアルを参照してください。

＜この節の構成＞

付録B.1　イベント登録の方法

付録B.2　登録できるOpenTP1のイベント

付録B.1　イベント登録の方法

OpenTP1のイベントをJP1イベントサービス機能へ登録するには，システム共通定義でjp1_use=Yと指定します。

付録B.2　登録できるOpenTP1のイベント

JP1イベントサービス機能に登録できるOpenTP1のイベントを次の表に示します。

表B-1　JP1イベントサービス機能に登録できるOpenTP1のイベント

イベント | イベントID（基本コードだけ） | メッセージ | 詳細情報※ | 登録するタイミング
開始 | 0x00010000​ | NULL | "start" | ユーザサーバのスケジューリング開始後
正常終了 | 0x00010001​ | NULL | "end_normal" | システムサービス終了後
計画停止A | 0x00010001​ | NULL | "end_planA" | システムサービス終了後
計画停止B | 0x00010001​ | NULL | "end_planB" | システムサービス終了後
強制停止 | 0x00010001​ | NULL | "end_force" | システムサービス終了後
異常終了 | 0x00010002​ | NULL | "end_error" | 異常終了決定直後，または終了処理開始前
メッセージログ出力 | 0x00010003​ | OpenTP1メッセージ | NULL | メッセージログ出力直後

注※

詳細情報のデータはテキスト形式です。形式を次に示します。

ss△nnnn△mm...mm△¥0

ss：システム識別子（0～2バイト）

nnnn：ノード識別子（4バイト）

mm...mm：上記の詳細情報欄の文字列（5～10バイト）

付録C　監査イベントの出力情報

監査イベントの出力情報を次の表に示します。

表C-1　監査イベントの出力情報

監査イベント
監査イベントの出力情報

出力項目名
出力内容

OpenTP1開始
メッセージID（msgid）
KFCA33400-I

コンポーネント（compid）
adm

監査事象種別（ctgry）
StartStop

監査事象結果（result）
Success

サブジェクト識別情報（subj:（euid，pid））
dcstartの実行ユーザ名またはユーザID

オブジェクト（obj）
ノード識別子

動作情報（op）
Start

オブジェクトロケーション情報（objloc）
－

リクエスト送信元ホスト（from:ipv4）
－

リクエスト送信元ポート番号（from:port）
－

リクエスト送信先ホスト（to:ipv4）
－

リクエスト送信先ポート番号（to:port）
－

ログメッセージサイズ（単位：バイト）
290+2*a

OpenTP1待機状態
メッセージID（msgid）
KFCA33401-I

コンポーネント（compid）
adm

監査事象種別（ctgry）
StartStop

監査事象結果（result）
Success

サブジェクト識別情報（subj:（euid，pid））
スーパユーザのユーザ名またはユーザID

オブジェクト（obj）
ノード識別子

動作情報（op）
Start

オブジェクトロケーション情報（objloc）
－

リクエスト送信元ホスト（from:ipv4）
－

リクエスト送信元ポート番号（from:port）
－

リクエスト送信先ホスト（to:ipv4）
－

リクエスト送信先ポート番号（to:port）
－

ログメッセージサイズ（単位：バイト）
326+2*a

OpenTP1正常終了
メッセージID（msgid）
KFCA33402-I

コンポーネント（compid）
adm

監査事象種別（ctgry）
StartStop

監査事象結果（result）
Success

サブジェクト識別情報（subj:（euid，pid））
dcstopの実行ユーザ名またはユーザID

オブジェクト（obj）
ノード識別子

動作情報（op）
Stop

オブジェクトロケーション情報（objloc）
－

リクエスト送信元ホスト（from:ipv4）
－

リクエスト送信元ポート番号（from:port）
－

リクエスト送信先ホスト（to:ipv4）
－

リクエスト送信先ポート番号（to:port）
－

ログメッセージサイズ（単位：バイト）
289+2*a

OpenTP1異常終了
メッセージID（msgid）
KFCA33403-E

コンポーネント（compid）
adm

監査事象種別（ctgry）
Failure

監査事象結果（result）
Occurrence

サブジェクト識別情報（subj:（euid，pid））
システムダウンにつながったプロセスのPID
（該当プロセスがプロセスサービスの場合は，0を出力）

オブジェクト（obj）
ノード識別子
（ノード識別子が取得できない場合は，"****"を出力）

動作情報（op）
Occur

オブジェクトロケーション情報（objloc）
－

リクエスト送信元ホスト（from:ipv4）
－

リクエスト送信元ポート番号（from:port）
－

リクエスト送信先ホスト（to:ipv4）
－

リクエスト送信先ポート番号（to:port）
－

ログメッセージサイズ（単位：バイト）
321

プロセスサービスの重大なエラー
メッセージID（msgid）
KFCA33404-E

コンポーネント（compid）
prc

監査事象種別（ctgry）
Failure

監査事象結果（result）
Occurrence

サブジェクト識別情報（subj:（euid，pid））
プロセスサービスのPID

オブジェクト（obj）
ノード識別子
（ノード識別子が取得できない場合は，"****"を出力）

動作情報（op）
Occur

オブジェクトロケーション情報（objloc）
－

リクエスト送信元ホスト（from:ipv4）
－

リクエスト送信元ポート番号（from:port）
－

リクエスト送信先ホスト（to:ipv4）
－

リクエスト送信先ポート番号（to:port）
－

ログメッセージサイズ（単位：バイト）
331

ユーザサーバ開始
メッセージID（msgid）
KFCA33405-I

コンポーネント（compid）
adm

監査事象種別（ctgry）
StartStop

監査事象結果（result）
Success

サブジェクト識別情報（subj:（euid，pid））
dcsvstartの実行ユーザ名またはユーザID

オブジェクト（obj）
ユーザサーバ名

動作情報（op）
Start

オブジェクトロケーション情報（objloc）
ノード識別子

リクエスト送信元ホスト（from:ipv4）
－

リクエスト送信元ポート番号（from:port）
－

リクエスト送信先ホスト（to:ipv4）
－

リクエスト送信先ポート番号（to:port）
－

ログメッセージサイズ（単位：バイト）
285+2*(a+b)

備考
次のサーバの開始，終了についても出力する。
rapサーバ，rapリスナー，rapクライアントマネジャ，TP1/EE，RTSSPP，RTSSUP，MQCゲートウェイサーバ，mqrspp，mqrsup

ユーザサーバ正常終了
メッセージID（msgid）
KFCA33406-I

コンポーネント（compid）
adm

監査事象種別（ctgry）
StartStop

監査事象結果（result）
Success

サブジェクト識別情報（subj:（euid，pid））
dcsvstopの実行ユーザ名またはユーザID

オブジェクト（obj）
ユーザサーバ名

動作情報（op）
Stop

オブジェクトロケーション情報（objloc）
ノード識別子

リクエスト送信元ホスト（from:ipv4）
－

リクエスト送信元ポート番号（from:port）
－

リクエスト送信先ホスト（to:ipv4）
－

リクエスト送信先ポート番号（to:port）
－

ログメッセージサイズ（単位：バイト）
284+2*(a+b)

備考
次のサーバの開始，終了についても出力する。
rapサーバ，rapリスナー，rapクライアントマネジャ，TP1/EE，RTSSPP，RTSSUP，MQCゲートウェイサーバ，mqrspp，mqrsup

ユーザサーバ異常終了
メッセージID（msgid）
KFCA33407-E

コンポーネント（compid）
adm

監査事象種別（ctgry）
Failure

監査事象結果（result）
Occurrence

サブジェクト識別情報（subj:（euid，pid））
ダウンしたユーザサーバプロセスのPID

オブジェクト（obj）
ユーザサーバ名

動作情報（op）
Occur

オブジェクトロケーション情報（objloc）
ノード識別子

リクエスト送信元ホスト（from:ipv4）
－

リクエスト送信元ポート番号（from:port）
－

リクエスト送信先ホスト（to:ipv4）
－

リクエスト送信先ポート番号（to:port）
－

ログメッセージサイズ（単位：バイト）
313+2*b

備考
次のサーバの開始，終了についても出力する。
rapサーバ，rapリスナー，rapクライアントマネジャ，TP1/EE，RTSSPP，RTSSUP，MQCゲートウェイサーバ，mqrspp，mqrsup

ユーザサーバ閉塞
メッセージID（msgid）
KFCA33408-I

コンポーネント（compid）
scd

監査事象種別（ctgry）
Failure

監査事象結果（result）
Occurrence

サブジェクト識別情報（subj:（euid，pid））
スケジューラサービスのPID

オブジェクト（obj）
ユーザサーバ名

動作情報（op）
Occur

オブジェクトロケーション情報（objloc）
ノード識別子

リクエスト送信元ホスト（from:ipv4）
－

リクエスト送信元ポート番号（from:port）
－

リクエスト送信先ホスト（to:ipv4）
－

リクエスト送信先ポート番号（to:port）
－

ログメッセージサイズ（単位：バイト）
348+2*b

ユーザサーバのサービス閉塞
メッセージID（msgid）
KFCA33409-I

コンポーネント（compid）
scd

監査事象種別（ctgry）
Failure

監査事象結果（result）
Occurrence

サブジェクト識別情報（subj:（euid，pid））
スケジューラサービスのPID

オブジェクト（obj）
ユーザサーバ名，サービス名

動作情報（op）
Occur

オブジェクトロケーション情報（objloc）
ノード識別子

リクエスト送信元ホスト（from:ipv4）
－

リクエスト送信元ポート番号（from:port）
－

リクエスト送信先ホスト（to:ipv4）
－

リクエスト送信先ポート番号（to:port）
－

ログメッセージサイズ（単位：バイト）
365+2*(b(ユーザサーバ名)+b(サービス名))

クライアントユーザ認証成功
メッセージID（msgid）
KFCA33410-I

コンポーネント（compid）
nam

監査事象種別（ctgry）
Authentication

監査事象結果（result）
Success

サブジェクト識別情報（subj:（euid，pid））
ネームサービスのPID

オブジェクト（obj）
受信したログイン名

動作情報（op）
Login

オブジェクトロケーション情報（objloc）
ノード識別子

リクエスト送信元ホスト（from:ipv4）
○

リクエスト送信元ポート番号（from:port）
○

リクエスト送信先ホスト（to:ipv4）
－

リクエスト送信先ポート番号（to:port）
－

ログメッセージサイズ（単位：バイト）
364+2*b

備考
システム共通定義のclient_uid_checkオペランドにYが指定されたときに出力する。

クライアントユーザ認証失敗
メッセージID（msgid）
KFCA33411-W

コンポーネント（compid）
nam

監査事象種別（ctgry）
Authentication

監査事象結果（result）
Failure

サブジェクト識別情報（subj:（euid，pid））
ネームサービスのPID

オブジェクト（obj）
受信したログイン名

動作情報（op）
Login

オブジェクトロケーション情報（objloc）
ノード識別子

リクエスト送信元ホスト（from:ipv4）
○

リクエスト送信元ポート番号（from:port）
○

リクエスト送信先ホスト（to:ipv4）
－

リクエスト送信先ポート番号（to:port）
－

ログメッセージサイズ（単位：バイト）
360+2*b

備考
システム共通定義のclient_uid_checkオペランドにYが指定されたときに出力する。

サービス関数の実行開始
メッセージID（msgid）
KFCA33412-I

コンポーネント（compid）
rpc

監査事象種別（ctgry）
AccessControl

監査事象結果（result）
Occurrence

サブジェクト識別情報（subj:（euid，pid））
要求先ユーザサーバのPID

オブジェクト（obj）
要求先サービス名

動作情報（op）
Enforce

オブジェクトロケーション情報（objloc）
要求先サービスグループ名

リクエスト送信元ホスト（from:ipv4）
○

リクエスト送信元ポート番号（from:port）
○
（送信元の受信ポート番号を出力）

リクエスト送信先ホスト（to:ipv4）
－

リクエスト送信先ポート番号（to:port）
－

ログメッセージサイズ（単位：バイト）
552+2*(b+c)+FSV+FSVG

備考

XATMIのSPP，およびSPP.NETでは取得されない。

製品間のバージョンによって，次のサーバについても出力される可能性がある。
クライアント拡張サービス，rapサーバ，rapリスナー，rapクライアントマネジャ，TP1/EE，MQCゲートウェイサーバ，mqrspp，mqrsup

サービス関数の実行完了
メッセージID（msgid）
KFCA33413-I

コンポーネント（compid）
rpc

監査事象種別（ctgry）
AccessControl

監査事象結果（result）
Occurrence

サブジェクト識別情報（subj:（euid，pid））
要求先ユーザサーバのPID

オブジェクト（obj）
要求先サービス名

動作情報（op）
Enforce

オブジェクトロケーション情報（objloc）
要求先サービスグループ名

リクエスト送信元ホスト（from:ipv4）
○

リクエスト送信元ポート番号（from:port）
○
（送信元の受信ポート番号を出力）

リクエスト送信先ホスト（to:ipv4）
－

リクエスト送信先ポート番号（to:port）
－

ログメッセージサイズ（単位：バイト）
553+2*(b+c)+FSV+FSVG

備考

XATMIのSPP，およびSPP.NETでは取得されない。

製品間のバージョンによって，次のサーバについても出力される可能性がある。
クライアント拡張サービス，rapサーバ，rapリスナー，rapクライアントマネジャ，TP1/EE，MQCゲートウェイサーバ，mqrspp，mqrsup

不正電文の破棄
メッセージID（msgid）
KFCA33414-W

コンポーネント（compid）
rpc

監査事象種別（ctgry）
AnomalyEvent

監査事象結果（result）
Occurrence

サブジェクト識別情報（subj:（euid，pid））
不正電文を検知したプロセスのPID

オブジェクト（obj）
受信ポート番号

動作情報（op）
Occur

オブジェクトロケーション情報（objloc）
ノード識別子
（ノード識別子が取得できない場合は，"****"を出力）

リクエスト送信元ホスト（from:ipv4）
○

リクエスト送信元ポート番号（from:port）
○
（UNIXドメイン通信の場合は，0を出力）

リクエスト送信先ホスト（to:ipv4）
－

リクエスト送信先ポート番号（to:port）
－

ログメッセージサイズ（単位：バイト）
542

RPC呼び出し完了
メッセージID（msgid）
KFCA33415-I

コンポーネント（compid）
rpc

監査事象種別（ctgry）
AccessControl

監査事象結果（result）
Success/Failure

サブジェクト識別情報（subj:（euid，pid））
要求元ユーザサーバのPID

オブジェクト（obj）
要求先サービス名

動作情報（op）
Enforce

オブジェクトロケーション情報（objloc）
要求先サービスグループ名

リクエスト送信元ホスト（from:ipv4）
○

リクエスト送信元ポート番号（from:port）
○
（送信元の受信ポート番号を出力）

リクエスト送信先ホスト（to:ipv4）
○
（RPC要求先が確定する前にエラーを検知した場合，出力しない）

リクエスト送信先ポート番号（to:port）
○
（RPC要求先が確定する前にエラーを検知した場合，出力しない）

ログメッセージサイズ（単位：バイト）
709+2*(b+c)+FSV+FSVG

備考

dc_rpc_callの戻り値がDCRPCER_PROTO，またはDCRPCER_INVALID_ARGSの場合，監査ログは出力しない。

製品間のバージョンによって，次のサーバについても出力される可能性がある。
クライアント拡張サービス，rapサーバ，rapリスナー，rapクライアントマネジャ，TP1/EE，MQCゲートウェイサーバ，mqrspp，mqrsup

RPC応答の受信（dc_rpc_poll_any_replies関数の使用時）
メッセージID（msgid）
KFCA33416-I

コンポーネント（compid）
rpc

監査事象種別（ctgry）
AccessControl

監査事象結果（result）
Success/Failure

サブジェクト識別情報（subj:（euid，pid））
dc_rpc_poll_any_replies()発行元ユーザサーバのPID

オブジェクト（obj）
要求先サービス名
（非同期応答型RPCの応答を受信する前にエラーを検知した場合は，"********"を出力）

動作情報（op）
Enforce

オブジェクトロケーション情報（objloc）
要求先サービスグループ名
（非同期応答型RPCの応答を受信する前にエラーを検知した場合は，"********"を出力）

リクエスト送信元ホスト（from:ipv4）
－

リクエスト送信元ポート番号（from:port）
－

リクエスト送信先ホスト（to:ipv4）
－

リクエスト送信先ポート番号（to:port）
－

ログメッセージサイズ（単位：バイト）
538+2*(b+c)+FSV+FSVG

備考
製品間のバージョンによって，次のサーバについても出力される可能性がある。
クライアント拡張サービス，rapサーバ，rapリスナー，rapクライアントマネジャ，TP1/EE，MQCゲートウェイサーバ，mqrspp，mqrsup

rapの不正電文の破棄
メッセージID（msgid）
KFCA33417-W

コンポーネント（compid）
scs

監査事象種別（ctgry）
AnomalyEvent

監査事象結果（result）
Occurrence

サブジェクト識別情報（subj:（euid，pid））
不正電文を検知したプロセスのPID

オブジェクト（obj）
受信ポート番号

動作情報（op）
Occur

オブジェクトロケーション情報（objloc）
ノード識別子

リクエスト送信元ホスト（from:ipv4）
○

リクエスト送信元ポート番号（from:port）
○

リクエスト送信先ホスト（to:ipv4）
○

リクエスト送信先ポート番号（to:port）
○

ログメッセージサイズ（単位：バイト）
535

OpenTP1ファイルシステムに対するアクセスエラー
メッセージID（msgid）
KFCA33418-W

コンポーネント（compid）
fil

監査事象種別（ctgry）
ContentAccess

監査事象結果（result）
Failure

サブジェクト識別情報（subj:（euid，pid））
ファイルにアクセス要求を行ったプロセスのユーザ名またはユーザID

オブジェクト（obj）
OpenTP1ファイル名
（OpenTP1ファイルシステム名が取得できない場合，この項目は出力しない）

動作情報（op）
Refer/Add/Update/Delete

オブジェクトロケーション情報（objloc）
OpenTP1ファイルシステム名
（OpenTP1ファイルシステム名が取得できない場合，この項目は出力しない）

リクエスト送信元ホスト（from:ipv4）
－

リクエスト送信元ポート番号（from:port）
－

リクエスト送信先ホスト（to:ipv4）
－

リクエスト送信先ポート番号（to:port）
－

ログメッセージサイズ（単位：バイト）
345+2*a+b+c

コマンドの実行
メッセージID（msgid）
KFCA33419-I

コンポーネント（compid）
cmd

監査事象種別（ctgry）
Maintenance

監査事象結果（result）
Success/Failure/Occurrence

サブジェクト識別情報（subj:（euid，pid））
コマンドを実行したユーザ名またはユーザID

オブジェクト（obj）
コマンド名

動作情報（op）
Maintain

オブジェクトロケーション情報（objloc）
－

リクエスト送信元ホスト（from:ipv4）
－

リクエスト送信元ポート番号（from:port）
－

リクエスト送信先ホスト（to:ipv4）
－

リクエスト送信先ポート番号（to:port）
－

ログメッセージサイズ（単位：バイト）
306+2*(a+b)+CPARM

OpenTP1サービス開始
メッセージID（msgid）
KFCA33420-I

コンポーネント（compid）
nts

監査事象種別（ctgry）
StartStop

監査事象結果（result）
Success

サブジェクト識別情報（subj:（euid，pid））
サービスログオンアカウント

オブジェクト（obj）
サービス名（Windowsのサービス名称）

動作情報（op）
Start

オブジェクトロケーション情報（objloc）
－

リクエスト送信元ホスト（from:ipv4）
－

リクエスト送信元ポート番号（from:port）
－

リクエスト送信先ホスト（to:ipv4）
－

リクエスト送信先ポート番号（to:port）
－

ログメッセージサイズ（単位：バイト）
268+2*(a+b)

備考
Windows版だけ出力する

OpenTP1サービス停止
メッセージID（msgid）
KFCA33421-I

コンポーネント（compid）
nts

監査事象種別（ctgry）
StartStop

監査事象結果（result）
Success

サブジェクト識別情報（subj:（euid，pid））
サービスログオンアカウント

オブジェクト（obj）
サービス名（Windowsのサービス名称）

動作情報（op）
Stop

オブジェクトロケーション情報（objloc）
－

リクエスト送信元ホスト（from:ipv4）
－

リクエスト送信元ポート番号（from:port）
－

リクエスト送信先ホスト（to:ipv4）
－

リクエスト送信先ポート番号（to:port）
－

ログメッセージサイズ（単位：バイト）
259+2*(a+b)

備考
Windows版だけ出力する

UAPからユーザが任意に取得する監査ログの取得
メッセージID（msgid）
KFCA34000-x～KFCA34999-x

コンポーネント（compid）
ユーザ指定値
（「*AA」の形式（AA：監査ログ出力APIで指定した値）で出力）

監査事象種別（ctgry）
ユーザ指定値

監査事象結果（result）
Success/Failure/Occurrence

サブジェクト識別情報（subj:（euid，pid））
監査ログ出力APIを発行したユーザサーバのユーザ名またはユーザID

オブジェクト（obj）
サービス名

動作情報（op）
ユーザ指定値

オブジェクトロケーション情報（objloc）
ユーザサーバ名

リクエスト送信元ホスト（from:ipv4）
○

リクエスト送信元ポート番号（from:port）
－

リクエスト送信先ホスト（to:ipv4）
－

リクエスト送信先ポート番号（to:port）
－

ログメッセージサイズ（単位：バイト）
290+a+b+c+msg

（凡例）

○：出力されます。

－：該当しません。

ログメッセージサイズの計算式の変数の意味

ログメッセージサイズの変数には，各項目に出力される値の文字数を代入してください。なお，FSV，FSVG，CPARM，およびmsgは，自由記述（msg）の出力情報です。各変数の意味を次に示します。

変数 | 意味
a | サブジェクト識別情報に出力される値の文字数
b | オブジェクト情報に出力される値の文字数
c | オブジェクトロケーション情報に出力される値の文字数
FSV | 要求元サービス名に出力される値の文字数
FSVG | 要求元サービスグループ名に出力される値の文字数
CPARM | コマンドのパラメータに出力される値の文字数
msg | 自由記述の文字数

ログメッセージサイズの計算方法

ログメッセージサイズは，各イベントのログメッセージサイズの計算式を基に算出します。計算した結果に「共通部分＝環境変数DCDIRの文字数」を加えた値が，各イベントのログメッセージサイズになります。

（例）

ここでは，OpenTP1開始（メッセージIDはKFCA33400-I）の場合のログメッセージサイズの計算方法について説明します。この例では，dcstartコマンドの実行ユーザ名は「tp1user」とします。また，環境変数DCDIRは「/usr/OpenTP1」で，共通部分は「12」とします。

計算式   = 290＋2*a
        = 290+2*7
        = 304

共通部分 = 12

ログサイズ = 304 + 12

= 316

ログメッセージサイズに関する注意事項

ログのメッセージサイズは多めに見積もられています。このため，実際に出力されるログのサイズは，見積もりの計算結果よりも少なくなる場合があります。

付録D　メッセージ制御機能で取得するジャーナル情報

アンロードジャーナルファイル上でメッセージ制御機能が取得したジャーナル情報（AJ，GJ，IJ，MJ，OJ，CJ）を次に示します。また，メッセージ制御機能のジャーナル取得条件，およびジャーナルの必要量の計算式を示します。

ジャーナルのレコードサイズは，32ビット版で4バイト，64ビット版で8バイトの倍数となるように調整します。レコードのサイズが4バイトまたは8バイト境界になっていない場合，jnleditコマンドによる編集結果の入力・出力メッセージ以降のデータに，無効なデータが出力されます。

MCFジャーナルレコード形式で使用している属性を示す記号を次の表に示します。

表D-1　属性表記記号の意味

属性表記記号
意味

char
文字属性を持つ1バイトの領域を示します。

uchar
符号なし属性を持つ1バイトの領域を示します。

char［＊］
文字属性の領域を示します。
＊の部分に指定がない場合は，可変長であることを示します。
10進数が記述してある場合は，バイト数を示します。
この領域を参照するときは，文字数を指定する文字列操作をしてください。

ulong
符号なし数値属性を持つ4バイトの領域を示します。

＜この節の構成＞

付録D.1　AJレコード形式

付録D.2　GJレコード形式

付録D.3　IJレコード形式

付録D.4　MJレコード形式

付録D.5　OJレコード形式

付録D.6　メッセージ制御機能のジャーナル取得条件

付録D.7　メッセージ制御機能が取得するジャーナルの必要量の計算式

付録D.1　AJレコード形式

項目
位置
（バイト）
属性
説明

予備
0
char［24］
予備領域です。

出力論理端末名
24
char［16］
出力メッセージを送信した出力論理端末名です。

アプリケーション名
40
char［10］
出力論理端末に出力メッセージを送信したアプリケーション名です。
SPPの場合は取得されません。

予備
50
char［18］
予備領域です。

ジャーナル取得時刻
68
ulong
MCFジャーナルバッファに書き出した時刻です。
（1970年1月1日0時0分0秒からの通算秒）

ジャーナル取得時刻
72
ulong
MCFジャーナルバッファに書き出した時刻です。
（1970年1月1日0時0分0秒からの通算秒以下）

予備
76
char［4］
予備領域です。

出力メッセージ種別
80
char
出力メッセージの種別を次の文字で示します。
n：一般一方送信メッセージ
o：問い合わせメッセージ
p：優先一方送信メッセージ

出力通番の有無種別
81
uchar
このメッセージが出力通番を持っているかどうかを次の値で示します。
0x00：出力通番を持たないメッセージ
0x01：出力通番を持つメッセージ

予備
82
char［2］
予備領域です。

メッセージ出力通番
84
ulong
出力メッセージを送信した時の出力通番です。
出力通番の有無種別が0x01のときに有効です。

予備
88
char［24］
予備領域です。

付録D.2　GJレコード形式

項目
位置
（バイト）
属性
説明

予備
0
char［8］
予備領域です。

入力論理端末名
8
char［16］
入力メッセージを受信した入力論理端末名です。

予備
24
char［16］
予備領域です。

アプリケーション名
40
char［10］
入力メッセージを処理するアプリケーション名です。

予備
50
char［2］
予備領域です。

メッセージ入力通番
52
char［12］
入力論理端末から受け取ったメッセージの入力通番です。
この情報は文字列ではありません。12バイトの領域として扱ってください。

予備
64
char［4］
予備領域です。

ジャーナル取得時刻
68
ulong
MCFジャーナルバッファに書き出した時刻です。
（1970年1月1日0時0分0秒からの通算秒）

ジャーナル取得時刻
72
ulong
MCFジャーナルバッファに書き出した時刻です。
（1970年1月1日0時0分0秒からの通算秒以下）

予備
76
char［4］
予備領域です。

マップ名
80
char［9］
NEXTマップがある場合は，そのマップ名を示します。

予備
89
char［15］
予備領域です。

入力メッセージサイズ
104
ulong
入力論理端末から受け取ったメッセージの大きさをバイト単位で示します。

入力メッセージ
108
char［］
入力論理端末から受け取ったメッセージが設定されています。
この情報は可変長で，入力メッセージサイズが示す大きさです。

付録D.3　IJレコード形式

項目
位置
（バイト）
属性
説明

予備
0
char［8］
予備領域です。

入力論理端末名
8
char［16］
入力メッセージを受信した入力論理端末名です。

予備
24
char［16］
予備領域です。

アプリケーション名
40
char［10］
入力メッセージを処理するアプリケーション名です。

予備
50
char［2］
予備領域です。

メッセージ入力通番
52
char［12］
受け取ったメッセージの入力通番です。この情報は文字列ではありません。12バイトの領域として扱ってください。

予備
64
char［4］
予備領域です。

ジャーナル取得時刻
68
ulong
MCFジャーナルバッファに書き出した時刻です（1970年1月1日0時0分0秒からの通算秒）。

ジャーナル取得時刻
72
ulong
MCFジャーナルバッファに書き出した時刻です（1970年1月1日0時0分0秒からの通算秒以下）。

予備
76
char［4］
予備領域です。

マップ名
80
char［9］
NEXTマップがある場合は，そのマップ名を示します。

入力メッセージ種別
89
char
入力メッセージ種別を次の文字で示します。
i：問い合わせメッセージ
n：一方受信メッセージ

順序識別子
90
char
入力メッセージが分割されている場合の順序を示す識別子です。次の文字で示します。
s：入力メッセージは分割されていません。
f：先頭メッセージです。
このあとにメッセージ（m，l）を受け取っています。
m：中間メッセージです。
このあとにメッセージ（m，l）を受け取っています。
l：最終メッセージです。
あとにメッセージを受け取っていません。

予備
91
char［13］
予備領域です。

入力メッセージサイズ
104
ulong
入力論理端末が受け取ったメッセージの大きさをバイト単位で示します。

入力メッセージ
108
char［］
入力論理端末が受け取ったメッセージが設定されています。
この情報は可変長で，入力メッセージサイズが示す大きさです。

付録D.4　MJレコード形式

項目
位置
（バイト）
属性
説明

予備
0
char［8］
予備領域です。

入力論理端末名
8
char［16］
入力時の場合は，メッセージを受信した入力論理端末名を示します。

出力論理端末名
24
char［16］
出力時の場合は，メッセージの送信先の出力論理端末名を示します。

予備
40
char［28］
予備領域です。

ジャーナル取得時刻
68
ulong
MCFジャーナルバッファに書き出した時刻です（1970年1月1日0時0分0秒からの通算秒）。

ジャーナル取得時刻
72
ulong
MCFジャーナルバッファに書き出した時刻です（1970年1月1日0時0分0秒からの通算秒以下）。

予備
76
char［4］
予備領域です。

コネクション名
80
char［16］
メッセージを受信，または送信したコネクション名です。

メッセージジャーナル種別
96
char
メッセージジャーナルの種別を次の文字で示します。
i：入力編集前のメッセージジャーナル
o：出力編集後のメッセージジャーナル

順序識別子
97
char
入力，または出力メッセージが分割されている場合の順序を示す識別子を次の文字で示します。
s：メッセージは分割されていません。
f：先頭メッセージです。
このあとにメッセージ（m，l）を受け取っています。
m：中間メッセージです。
このあとにメッセージ（m，l）を受け取っています。
l：最終メッセージです。
あとにメッセージを受け取っていません。

予備
98
char［14］
予備領域です。

入力または出力メッセージサイズ
112
ulong
入力，または出力メッセージの大きさをバイト単位で示します。

入力または出力メッセージ
116
char［］
入力，または出力論理端末が受け取ったメッセージが設定されています。
この情報は可変長で，入力，または出力メッセージサイズが示す大きさです。

付録D.5　OJレコード形式

項目
位置
（バイト）
属性
説明

予備
0
char［24］
予備領域です。

出力論理端末名，または起動先アプリケーション名
24
char［16］
出力メッセージを送信した先の出力論理端末名，またはアプリケーション起動した，起動先アプリケーション名です。

アプリケーション名
40
char［10］
出力メッセージを送信したアプリケーション名です。
SPPの場合は取得されません。

予備
50
char［18］
予備領域です。

ジャーナル取得時刻
68
ulong
MCFジャーナルバッファに書き出した時刻です（1970年1月1日0時0分0秒からの通算秒）。

ジャーナル取得時刻
72
ulong
MCFジャーナルバッファに書き出した時刻です（1970年1月1日0時0分0秒からの通算秒以下）。

予備
76
char［4］
予備領域です。

マップ名
80
char［9］
出力メッセージを送信した時に指定したマップ名です。

出力メッセージ種別
89
char
出力メッセージの種別を次の文字で示します。
n：一般一方送信メッセージ
o：問い合わせメッセージ
p：優先一方送信メッセージ
△：アプリケーション起動メッセージ

予備
90
char
予備領域です。

出力通番の有無種別
91
char
このメッセージが出力通番を持っているかどうかを次の値で示します。
0x00：出力通番を持たないメッセージ
0x01：出力通番を持つメッセージ

メッセージ出力通番
92
ulong
出力メッセージを送信した時の出力通番です。
出力通番の有無種別が0x01のときに有効です。

予備
96
char［8］
予備領域です。

送信メッセージサイズ
104
ulong
論理端末，または起動先アプリケーションに送信したメッセージの大きさをバイト単位で示します。

送信メッセージ
108
char［］
論理端末，または起動先アプリケーションに送信したメッセージが設定されています。
この情報は可変長で，メッセージサイズが示す大きさです。

付録D.6　メッセージ制御機能のジャーナル取得条件

種別
取得条件
取得プロセス
取得タイミング

AJ
MCF通信構成定義
mcftalcle -o aj=yes
を指定した場合
通信プロセス
メッセージ出力時（送信完了時）

GJ
MCFアプリケーション定義
mcfaalcap -j gj=yes
を指定した場合
UAPプロセス
メッセージ受信時（dc_mcf_receive()関数内で取得）

IJ
MCFアプリケーション定義
mcfaalcap -j ij=yes
を指定した場合
通信プロセス
メッセージ入力時（入力キューへの登録前）

MJ
mcftactmjコマンドを入力した場合
通信プロセス
メッセージ入力時（入力キューへの登録前）
メッセージ出力時（出力キューから読み込み後）

OJ

MHP：MCFアプリケーション定義

mcfaalcap -j oj=yes

を指定した場合

SPP：ユーザサービス定義（またはユーザサービスデフォルト定義）

mcf_spp_oj=Y

を指定した場合

UAPプロセス
メッセージ送信時（dc_mcf_send()関数内で取得），またはアプリケーション起動要求時（dc_mcf_execap()関数内で取得）

CJ
（出力通番）
出力通番を指定してメッセージ送信をした場合
UAPプロセス
メッセージ送信時（dc_mcf_send()関数内で取得）

CJ
（最終出力通番）
出力通番を指定してメッセージ送信をした場合
通信プロセス
メッセージ出力時（送信完了時）

CJ
（無効出力通番）
出力通番指定のメッセージを送信した論理端末がMCF構成変更再開始時に削除されている場合
MCFマネジャプロセス
MCF構成変更再開始時

CJ
（QUE※）
MCFアプリケーション定義
mcfaalcap -g
quekind=disk
を指定した場合
通信プロセス
メッセージ入力時（入力キューへの登録後）

CJ
（QUE※）
MCFアプリケーション定義
mcfaalcap -g quekind=
diskを指定した場合，およびMCF通信構成定義
mcftalcle -k
quekind=disk
を指定した場合
UAPプロセス
同期点

CJ
（QUE※）
MCF通信構成定義
mcftalcle -k
quekind=disk
を指定した場合
通信プロセス
メッセージ出力時（出力キュー消去完了時）

CJ
（QUE※）
MCFアプリケーション定義
mcfaalcap -g
quekind=disk
を指定した場合，およびMCF通信構成定義
mcftalcle -k
quekind=disk
を指定した場合
MCFマネジャプロセス
正常終了時

CJ
（QUE※）
入力キューにメッセージが滞留していたサービスグループ，または出力キューにメッセージが滞留していた論理端末がMCF構成変更再開始時に削除されていた場合
MCFマネジャプロセス
MCF構成変更再開始時

注※

メッセージキューサーバが取得する場合の回復用ジャーナル

付録D.7　メッセージ制御機能が取得するジャーナルの必要量の計算式

種別
計算式（単位：バイト）

AJ
176

GJ
32ビット版の場合：↑（204＋seg）／4↑×4
64ビット版の場合：↑（204＋seg）／8↑×8

IJ
32ビット版の場合：↑（172＋seg）／4↑×4
64ビット版の場合：↑（172＋seg）／8↑×8

MJ
32ビット版の場合：↑（180＋seg）／4↑×4
64ビット版の場合：↑（180＋seg）／8↑×8

OJ
32ビット版の場合：↑（204＋seg）／4↑×4
64ビット版の場合：↑（204＋seg）／8↑×8

CJ
（出力通番）
トランザクション外の場合：128
（アプリケーション定義　mcfaalcap -n　trnmode=nontrnを指定したMHP）
トランザクションの場合：160
（上記以外）

CJ
（最終出力通番）
144

CJ
（無効出力通番）
144

CJ
（QUE※）
32ビット版の場合：↑{88＋(24×(↑msg／ql↑＋↑960／ql↑))＋qio}／4↑×4
64ビット版の場合：↑{88＋(24×(↑msg／ql↑＋↑1072／ql↑))＋qio}／8↑×8
（メッセージ入力時，通信プロセスで取得）

CJ
（QUE※）
32ビット版の場合：↑{260＋Σ{(24×(↑msg／ql↑＋↑960／ql↑))}＋Σqio}／4↑×4
64ビット版の場合：↑{260＋Σ{(24×(↑msg／ql↑＋↑1072／ql↑))}＋Σqio}／8↑×8
（同期点取得時，UAPプロセスで取得）
Σ：該当するトランザクションで，受信または送信したメッセージに対する見積もり（32ビット版の場合，24×（↑msg／ql↑＋↑960／ql↑））の総和

CJ
（QUE※）
32ビット版の場合：↑{88＋(24×(↑msg／ql↑＋↑960／ql↑))＋qio}／4↑×4
64ビット版の場合：↑{88＋(24×(↑msg／ql↑＋↑1072／ql↑))＋qio}／8↑×8
（メッセージ出力時，通信プロセスで取得）

CJ
（QUE※）
32ビット版の場合：260＋（24×hmsg）
64ビット版の場合：↑｛260＋（24×hmsg）｝／8↑×8
（正常終了時，MCFマネジャプロセスで取得）

CJ
（QUE※）
32ビット版の場合：260＋（24×dmsg）
64ビット版の場合：↑｛260＋（24×dmsg）｝／8↑×8
（MCF構成変更再開始時，MCFマネジャプロセスで取得）

（凡例）

↑↑

小数点以下を切り上げます。

seg

セグメント長（メッセージは，複数に分割できます。この分割の単位をセグメントと呼びます。一つのメッセージは，一つのセグメントから構成される場合と複数のセグメントから構成される場合があります。IJ，GJ，MJ，OJは，セグメント単位に取得されます）

msg

受信，または送信したメッセージ長

ql

キューファイル物理レコード長（queinitコマンドの-sで指定した値）

qio

遅延書き込み最大レコード長（メッセージキューサービス定義のque_io_maxrecsizeオペランドの指定値）

hmsg

保持メッセージ数（メッセージキューサービス定義のquegrpコマンドの-mで指定した値）

dmsg

MCF構成変更再開始をする前に削除した，論理端末やアプリケーションに滞留していたメッセージ数

注※

メッセージキューサーバが取得する場合の回復用ジャーナル

付録E　統計情報の詳細

＜この節の構成＞

付録E.1　システム統計情報

付録E.2　トランザクション統計情報

付録E.3　レスポンス統計情報

付録E.4　通信遅延時間統計情報

付録E.5　リアルタイム統計情報

付録E.1　システム統計情報

システム統計情報の詳細を次の表に示します。

表E-1　システム統計情報の詳細

統計情報種別
事象（取得値）
詳細内容
dcreport編集用ID※

RPC情報
RPCコール
（レスポンスタイム）
クライアント側でdc_rpc_callおよびdc_rpc_call_to内でサーバに要求を送信してからサーバから応答を受け取るまでの時間。
dc_rpc_callおよびdc_rpc_call_toが成功した場合に取得します。

同期応答型

dc_rpc_callおよびdc_rpc_call_toの要求開始から応答を受け取るまでの時間。dc_rpc_callおよびdc_rpc_call_to内でサーバへの要求送信が失敗し，サーバへの要求送信をリトライした場合，リトライした時間も含みます。

連鎖

dc_rpc_callおよびdc_rpc_call_toの要求開始から応答を受け取るまでの時間。

＜発生件数＞
dc_rpc_callおよびdc_rpc_call_to発行回数
1

ユーザサービス実行
（実行時間）
dc_rpc_callおよびdc_rpc_call_toで要求したサービス関数の実行開始から，サービス関数でreturnを発行するまでの時間。
dc_rpc_mainloopの中で取得します。
＜発生件数＞
dc_rpc_callおよびdc_rpc_call_to発行回数
2

RPCタイムアウト
RPCの応答待ちの処理で発生したタイムアウトエラー。
＜発生件数＞
上記タイムアウトエラーの発生件数
3

RPC障害
RPCの処理の内部で発生した障害。
＜発生件数＞
上記障害の発生件数
4

スケジュール情報
スケジュール待ち
（待ち行列長）
該当するユーザサーバ（SPP）のスケジュールキューに滞留したサービス要求数。
この値が大きい場合は，ユーザサービス定義のparallel_countオペランドに指定する常駐プロセス数を大きくします。また，非常駐プロセスがある場合は，必要に応じてbalance_countオペランドの指定値を小さくして非常駐プロセスを起動しやすくします。
この値が小さい場合は，必要であればユーザサービス定義のparallel_countオペランドに指定する常駐プロセス数を小さくします。また，非常駐プロセスがある場合は，必要に応じてbalance_countオペランドの指定値を大きくして非常駐プロセスを起動しにくくします。平均値と最大値に差がある場合はparallel_countオペランドに指定する常駐プロセス数と非常駐プロセス数の比率や最大プロセス数を調整します。
＜発生件数＞
クライアントが該当するユーザサーバに対して行ったサービス要求（dc_rpc_call）の回数
11

スケジュール
（メッセージサイズ）
該当するユーザサーバ（SPP）が受信したサービス要求メッセージ長。
メッセージ長にはシステムが付加する制御情報（512バイト）が加算されています。
ユーザサービス定義のmessage_buflenオペランドにはメッセージサイズ（最大）の値を指定することをお勧めします。
ユーザサービス定義のmessage_store_buflenオペランドには，下記の範囲の値を指定することをお勧めします。
　　メッセージサイズ（平均）×待ち行列長（最大）
　　　　≦　　message_store_buflen　　≦
　　メッセージサイズ（最大）×待ち行列長（最大）
＜発生件数＞
クライアントが該当するユーザサーバに対して行ったサービス要求（dc_rpc_call）の回数
12

メッセージ格納バッファプールの使用中サイズ
該当するユーザサーバ（SPP）のメッセージ格納バッファプールの使用中サイズ長。ただし，メッセージ格納バッファプールを共用している場合は所属しているスケジュールバッファグループの共用メッセージ格納バッファプールの値となります。
＜発生件数＞
クライアントが該当するユーザサーバに対して行ったサービス要求（dc_rpc_call）の回数
13

メッセージ格納バッファプール不足によってスケジュールできなかったメッセージサイズ
該当するユーザサーバ（SPP）へのサービス要求のうち，メッセージ格納バッファプール不足によって，スケジュールできなかったサービス要求メッセージ長。
＜発生件数＞
クライアントが該当するユーザサーバに対して行ったサービス要求（dc_rpc_call）のうち，メッセージ格納バッファプール不足でスケジュールできなかったサービス要求の回数
14

ロック情報
ロック取得（待ち時間）
ロック待ちが発生した時の待ち状態になってから待ち状態が解除されるまでの時間。
ここでいうロックとは，dc_lck_getと，DAM，TAM，およびMQAが発行するロックサービスの内部ロックを指します。
＜発生件数＞
ロック待ちの発生件数
21

ロック待ち
（待ち行列長）
ロック待ちが発生した時の待ち行列長。
＜発生件数＞
ロック待ちの発生件数
22

デッドロック
デッドロックの発生件数。
＜発生件数＞
上記に同じ
23

DAM情報
read（入力長）
dc_dam_readを発行した単位でのDAMファイルのデータの入力長。
＜発生件数＞
dc_dam_read発行回数
31

readエラー
dc_dam_readの中でOSとのインタフェース部分で発生した障害。API引数不正などのエラーは発生件数としてカウントされません。
＜発生件数＞
上記の障害発生件数
32

write（出力長）
dc_dam_writeまたはdc_dam_rewriteを発行した単位でのDAMファイルのデータの出力長。
＜発生件数＞
dc_dam_write，dc_dam_rewrite発行回数
33

writeエラー
実際のディスクとのI/O時に発生した出力障害。API引数不正などのエラーは発生件数としてカウントされません。
＜発生件数＞
上記の発生件数
34

更新バッファ使用（更新サイズ）
回復用ジャーナル（FJ）のジャーナル量。DAMを使用した際のジャーナル量を計算することでジャーナルファイルの大きさ，数をチューニングします。
＜発生件数＞
上記ジャーナルの取得回数
35

トランザクションブランチ内最初のDAM　API発行（全トランザクションブランチ数）
DAMを使用するトランザクション数。この最大値はDAMを使用するトランザクションのピークに当たります。この最大値をDAMサービス定義のdam_tran_process_countに指定すると，トランザクション用メモリ（TP1/Server Baseの動的共用メモリ量）が最適になります。
＜発生件数＞
取得しません。
36

共用メモリキャッシュブロック確保要求
リソースマネジャ用共用メモリプール内に確保するDAMファイルのデータ用ブロックを確保した回数。
＜発生件数＞
上記の発生件数
38

共用メモリ確保
（共用メモリプール使用率）
定期的にリソースマネジャ用共用メモリプールの使用率を取得。この値を参考にリソースマネジャ用共用メモリのサイズ（DAMサービス定義のdam_cache_size）を決定することをお勧めします。ただし，この統計情報は，ディファード更新指定のDAMファイルを更新するトランザクションだけを出力します。
最大値が100％に近くなるとUAPがダウンすることが多くなるため，その時はdam_cache_sizeを大きくする必要があります。
＜発生件数＞
ディファード更新指定のDAMファイルを更新したトランザクション数を10で割った回数
39

プロセス情報
UAP異常終了
UAPプロセスの異常終了。
＜発生件数＞
異常終了したUAPプロセスの累積値
41

システムサーバ異常終了
システムサービスプロセスの異常終了。
＜発生件数＞
異常終了したシステムサービスプロセスの累積値
42

プロセス生成
（全プロセス数）
一定間隔でのOpenTP1システムで起動されているシステムサービスとUAPプロセス数。
＜発生件数＞
取得しません。
43

TAM情報
TAMファイル実更新
（書き込みバイト数）
オンライン中にTAMファイルに対して実更新したデータのバイト数（通算値）。
1回当たりの平均実更新バイト数は次の式で求めます。

1回当たりの平均実更新バイト数=(今回の最大値－前回の最大値)÷発生件数

前回取得データがない場合は，次の式で求めます。

1回当たりの平均実更新バイト数=(最大値－最小値)÷（発生件数－1）

＜発生件数＞
TAMファイルにデータを更新した回数の総和。TAMファイルに実更新を行う契機はタイマ起動，cpd，tamholdなどがあります。
51

コミット，ロールバック
（レコード参照件数）
1回のトランザクションで参照したレコード数。この値はTAMサーバコミット処理で統計出力しているため，dc_tam_readの発行有無にかかわらず発生件数はカウントされます。したがって，dc_tam_readを発行しないシステムでは発生件数だけカウントされ，最大値，最小値，および平均値は0となります。
＜発生件数＞
TAMに関するコミット，ロールバックの回数
55

コミット，ロールバック
（レコード更新件数）
1回のトランザクションで更新したレコード数。この値はTAMサーバコミット処理で統計出力しているため，dc_tam_writeの発行有無にかかわらず発生件数はカウントされます。したがって，dc_tam_writeを発行しないシステムでは発生件数だけカウントされ，最大値，最小値，および平均値は0となります。
＜発生件数＞
TAMに関するコミット，ロールバックの回数
56

トランザクション情報
コミット
トランザクションのコミット決着。
＜発生件数＞
トランザクションのコミット決着回数
61

ロールバック
トランザクションのロールバック決着。
＜発生件数＞
トランザクションのロールバック決着回数
62

ネーム情報
キャッシュヒット
サービス情報キャッシュ領域に設定されたサービス情報のそのノードでの参照回数。
サービス情報キャッシュ領域とはネームサービスと異なったノードで起動されたサーバとのサービス情報を設定している領域をいい，サーバとのRPCに必要なアドレス情報をサービス情報といいます。
クライアントからサービス情報の参照が要求され，かつクライアントと同じノードのネームサービスにサービスの情報が設定されていなかった場合に設定されます。
＜発生件数＞
上記の情報の参照回数
71

ローカルヒット
サービス情報ローカル領域に設定されたサービス情報のそのノードでの参照回数。
サービス情報ローカル領域とはネームサービスと同一のノードで起動されたサーバのサービス情報を設定している領域をいいます。サーバが起動された場合に設定されます。
＜発生件数＞
上記の情報の参照回数
72

lookup
そのノードでのサービス情報の参照要求。
サービス情報ローカル領域，サービス情報キャッシュ領域のどちらの場合も，どの領域にもサービス情報が設定されていない場合もカウントされます。
＜発生件数＞
上記の参照要求回数
73

チェックポイントダンプ情報
チェックポイントダンプ取得
（取得間隔）
チェックポイント契機間隔。前回のチェックポイントから今回のチェックポイントまでの時間間隔をいいます。
チェックポイントは，一定のジャーナルブロックの出力数によって発生するため，その頻度を時間で評価します。
＜発生件数＞
チェックポイントダンプ契機数
81

チェックポイントダンプ有効化
（取得時間）
チェックポイントダンプ取得契機発生から有効化までの時間。チェックポイントダンプ取得契機が発生し，各システムサーバで取得処理を開始してから有効化が完了するまでの時間をいいます。
＜発生件数＞
チェックポイントダンプ契機数
82

メッセージキュー情報
readメッセージ
（入力長）
キューファイルから読み込んだメッセージ長。
＜発生件数＞
読み込んだメッセージ長
91

writeメッセージ
（出力長）
キューファイルに書き込んだメッセージ長。
＜発生件数＞
書き込んだメッセージ長
92

readエラー
物理ファイルからの入力でのFILサーバでの障害（異常ケース）。
＜発生件数＞
上記の障害発生件数
93

writeエラー
物理ファイルへの出力でのFILサーバでの障害（異常ケース）。
＜発生件数＞
上記の障害発生件数
94

空きバッファ待ち
該当するキューファイルに要求が集中し，必要な入出力バッファが不足した回数。この値によってメッセージキューサービス定義の入出力バッファ数を見直してください。
＜発生件数＞
上記の発生件数
95

実read
メッセージが入出力バッファにない場合の物理ファイルからの入力。この値を少なくするには，メッセージキューサービス定義の入出力バッファ数を大きくしてください。
＜発生件数＞
上記の入力回数
96

実write
物理ファイルへの出力。
この値と上記のwriteメッセージの回数を比較すると，write要求がどれだけまとめてI/Oされたかがわかります。
I/O回数を少なくする場合は，メッセージキューサービス定義の入出力バッファ数を大きくしてください。
遅延書き込み機能使用時は，物理ファイルへの出力は「遅延書き込み（実write回数）」でカウントされるため，この件数は0にすることが理想的です。
＜発生件数＞
上記の出力回数
97

遅延書き込み
（実write回数）
遅延書き込み機能使用時の遅延書き込みによる物理ファイルへの出力。
＜発生件数＞
上記の出力回数
99

物理ファイル単位の遅延書き込み
（遅延書き込み対象となったレコード数）
メッセージキューサービス定義の入出力バッファ数
（quegrp -nオプション）チューニング用取得値。
＜発生件数＞
遅延書き込み対象となったレコード数
151

物理ファイル単位の遅延書き込み
（遅延書き込み対象となったメッセージの割合）
メッセージキューサービス定義の入出力バッファ数
（quegrp -nオプション）チューニング用取得値。
＜発生件数＞
遅延書き込み対象となったメッセージの割合
152

ジャーナル情報
バッファ満杯
システムでジャーナルバッファは並列ディスクアクセス数×2＋1あり，この内1面がカレントバッファに当たります。
ジャーナルレコードをこのカレントバッファにバッファリングしようとした時にバッファの空きエリアが小さく，該当するバッファにバッファリングできない状態をいいます。
＜発生件数＞
上記事象の発生件数
102

空きバッファ待ち
ジャーナルバッファがすべて満杯，または出力中の場合にジャーナルレコードをすぐにはバッファリングできないで，バッファが空くのを待っている状態。
＜発生件数＞
上記事象の発生件数
103

ジャーナル出力
（ブロック長）
ジャーナルブロックのデータ長。
この値から単位時間に発生したジャーナル量の目安を得ることができます。
＜発生件数＞
ジャーナルブロックの出力回数
104

ジャーナル出力
（非バス部分データ長）
OpenTP1内部情報。
＜発生件数＞
上記事象の発生回数
105

入出力待ち
（待ちバッファ面数）
ジャーナル出力完了時に出力待ちをしているバッファ面数。ただし，平均値の小数点以下が切り捨てられないように，100倍した値を出力しています。
＜発生件数＞
ジャーナル出力完了回数
107

write
ジャーナルデータだけでなく，ジャーナルスワップ時のファイル管理情報も含めたシステムの内部的な出力回数。
＜発生件数＞
上記の出力回数
108

writeエラー
ジャーナルファイルへの出力時に起きた障害。
＜発生件数＞
上記の障害発生回数
109

スワップ（スワップ時間）
ジャーナルファイルをスワップする際のオーバヘッド時間。
＜発生件数＞
ジャーナルファイルをスワップした回数
110

ジャーナル入力
（データ長）
ジャーナルファイルから入力したデータ長。
＜発生件数＞
ジャーナルファイルからデータを入力した回数
111

read
ジャーナルデータだけでなく，ジャーナルスワップ時のファイル管理情報も含めたシステムの内部的な入力回数。
＜発生件数＞
上記の入力回数
113

readエラー
ジャーナルファイルからの入力時に起きた障害。
＜発生件数＞
上記の障害発生回数
114

MCF情報
メモリキューへのメッセージ入力
OpenTP1ノード内のメモリキューに対するメッセージ書き込み。
＜発生件数＞
上記のメッセージ書き込み回数
121

ディスクキューへのメッセージ入力
OpenTP1ノード内のディスクキューに対するメッセージ書き込み。
＜発生件数＞
上記のメッセージ書き込み回数
122

メモリキューからのメッセージ出力
OpenTP1ノード内のメモリキューからのメッセージ取り出し。
＜発生件数＞
上記のメッセージ取り出し回数
123

ディスクキューからのメッセージ出力
OpenTP1ノード内のディスクキューからのメッセージ取り出し。
＜発生件数＞
上記のメッセージ取り出し回数
124

コネクション障害によるコネクション切断
OpenTP1ノード内で発生したコネクション障害。
＜発生件数＞
上記障害の発生件数
125

共用メモリ管理情報
静的共用メモリ使用サイズ
静的共用メモリブロックの確保・解放処理後の静的共用メモリブロックの総使用サイズ。
＜発生件数＞
編集対象時間内に取得した統計情報ジャーナルの件数＋静的共用メモリ確保・解放関数発行回数
131

静的共用メモリプール必要最大サイズ
静的共用メモリブロックの使用サイズの最大値。ブロックの確保・解放処理後にそれ以前のプールサイズを更新した場合に取得します。プールサイズとは，いったん確保した共用メモリを解放したことによってプール内が虫食い状態となった場合のこの虫食い部分を含めた使用中共用メモリのサイズの合計です。
したがって，システム環境定義のstatic_shmpool_sizeに設定する値はこの値以上にしてください。
＜発生件数＞
静的共用メモリ使用サイズと同じ（ただし，それ以前のプールサイズを更新した場合）
132

動的共用メモリ使用サイズ
動的共用メモリブロックの確保・解放処理後の動的共用メモリブロックの総使用サイズ。
＜発生件数＞
編集対象時間内に取得した統計情報ジャーナルの件数＋動的共用メモリ確保・解放関数発行回数
133

動的共用メモリプール必要最大サイズ
動的共用メモリブロックの使用サイズの最大値。
ブロックの確保・解放処理後にそれ以前のプールサイズを更新した場合に取得します。システム環境定義のdynamic_shmpool_sizeに設定する値はこの値以上にしてください。
＜発生件数＞
動的共用メモリ使用サイズと同じ（ただし，それ以前のプールサイズを更新した場合）
134

MQAサービス情報
getメッセージ（入力長）
アプリケーションがキューから読み込んだメッセージ長。
＜発生件数＞
下記事象の発生回数

APからの非検索MQGET命令で取り出しに成功

APからの検索MQGET命令で検索に成功

161

putメッセージ（出力長）
アプリケーションおよびMQTサーバがキューに登録したメッセージ長。
＜発生件数＞
APおよびMQTサーバのキューへのメッセージ登録回数
162

readエラー
メッセージをファイルから入力したときのI/Oエラー。
＜発生件数＞
上記エラーの発生回数
163

writeエラー
メッセージをファイルに出力するときのI/Oエラー。
＜発生件数＞
上記エラーの発生回数
164

空きバッファ待ち
バッファ不足発生回数。
この値がカウントされている場合は入出力バッファ数を大きくしてください。
＜発生件数＞
上記事象の発生回数
165

実read
メッセージをファイルから読み込んだI/O。
この値がカウントされている場合は入出力バッファを大きくし，メッセージGET時，I/Oを減らしてください。
＜発生件数＞
上記事象の発生回数
166

実write
メッセージをファイルに書き込んだI/O。
＜発生件数＞
上記事象の発生回数
167

書き込み依頼時間
メッセージをファイルに書き込む時の書き込み処理時間（I/O時間＋MQAI/Oプロセスへの依頼処理）。
＜発生件数＞
メッセージのファイル書き込み依頼回数
169

1回のトリガ契機の起動メッセージ数
トリガ生成時，キューにたまっていたメッセージ数。
＜発生件数＞
トリガメッセージ生成回数
170

メッセージ転送開始待ち時間
MQPUTを発行してから，メッセージの転送を開始するまでの時間。
＜発生件数＞
転送メッセージ数
171

メッセージ到着待ち時間
MQPUTを発行してから，メッセージの転送が完了するまでの時間。
＜発生件数＞
転送メッセージ数
172

ISTサービス情報
入力長
dc_ist_readを発行した単位でのISTテーブルのデータ入力長についての情報。
＜発生件数＞
dc_ist_read発行回数
191

出力長
dc_ist_writeを発行した単位でのISTテーブルのデータ出力長についての情報。
＜発生件数＞
dc_ist_write発行回数
192

ほかのノードからの更新を受けた回数
ほかのノードが行ったISTテーブルに対する更新を，自ノードに反映させるための更新メッセージを受け取った回数。
＜発生件数＞
上記発生件数
193

ほかのノードへ更新した回数
ISTテーブルを更新してほかのノードへ更新の伝播を行った回数。
＜発生件数＞
上記発生件数
194

XATMIサービス情報
XATMIコール
（レスポンスタイム）
XATMIインタフェースを使用したOSI TP通信で，クライアント側でサービス要求を送信してから応答を受信するまでの時間。

同期応答型

tpcallでサービス要求を送信してから応答を受信するまでの時間。

非同期応答型

tpacallでサービス要求を送信してからtpgetrplyで応答を受信するまでの時間。

非応答型

不正な値となります。

＜発生件数＞
tpcallまたはtpacall発行回数。ただし，サービス要求送信前にエラーリターンした場合は含みません。
211

XATMIユーザサービス実行時間
XATMIインタフェースを使用したOSI TP通信で，サーバ側でサービス関数の実行開始からサービス関数でreturnを発行するまでの時間。
＜発生件数＞
ユーザサービス実行回数
212

XATMIサービス障害回数
XATMIインタフェースを使用したOSI TP通信で発生した障害の件数。

クライアント側

トランザクション内ではサービス要求送信後，トランザクション決着まで，トランザクション外ではサービス要求送信後，サービスからの応答受信までの間に発生した障害。

障害には通信障害，サーバUAP障害，サービスからのエラー応答受信などがあります。

サーバ側

トランザクション内ではサービス要求受信後，トランザクション決着まで，トランザクション外ではサービス要求受信後，サービス関数終了までの間に発生した障害。

障害には通信障害クライアントUAP障害，クライアントからのロールバック指示受信などがあります。

＜発生件数＞
上記障害の発生件数
213

注※

dcreportコマンド実行時に指定する引数です。

システム統計情報の編集内容を次の表に示します。

表中の「単位」は事象の発生件数（取得値がある場合は取得値の単位）です。なお，システム統計情報の発生件数が0の場合，編集値は意味のない値になります。

表E-2　システム統計情報の編集内容

統計情報種別
編集内容
単位
ユーザサーバ単位の編集
dcreport編集用ID※1

事象（取得値）
発生件数
編集値

平均
最大
最小

RPC情報
RPCコール（レスポンスタイム）
○
○
○
○
マイクロ秒
○
1

ユーザサービス実行（実行時間）
○
○
○
○
マイクロ秒
○
2

RPCタイムアウト
○
×
×
×
件数
○
3

RPC障害
○
×
×
×
件数
○
4

スケジュール情報
スケジュール待ち（待ち行列長）
○
○
○
○
要求数
○
11

スケジュール（メッセージサイズ）
○
○
○
○
バイト
○
12

メッセージ格納バッファプールの使用中サイズ
○
○
○
○
バイト
○
13

メッセージ格納バッファプール不足でスケジュールできなかったメッセージサイズ
○
○
○
○
バイト
○
14

ロック情報
ロック取得（待ち時間）
○
○
○
○
ミリ秒
×
21

ロック待ち（待ち行列長）
○
○
○
○
要求数
×
22

デッドロック
○
×
×
×
件数
×
23

DAM情報
read（入力長）
○
○
○
○
バイト
○
31

readエラー
○
×
×
×
件数
○
32

write（出力長）
○
○
○
○
バイト
○
33

writeエラー
○
×
×
×
件数
○
34

更新バッファ使用（更新サイズ）
○
○
○
○
バイト
○
35

トランザクションブランチ内最初のDAM　API発行
（全トランザクションブランチ数）
×※2
○
○
○
トランザクションブランチ数
○
36

共用メモリキャッシュブロック確保要求
○
×
×
×
件数
○
38

共用メモリ確保（共用メモリプール使用率）※³
○
○
○
○
％
×
39

プロセス情報
UAP異常終了
○
×
×
×
件数
×
41

システムサーバ異常終了
○
×
×
×
件数
×
42

プロセス生成（全プロセス数）
×※2
○
○
○
プロセス数
×
43

TAM情報
TAMファイル実更新（書き込みバイト数）
○
○
○
○
バイト
×
51

コミット，ロールバック（レコード参照件数）
○
○
○
○
件数
○
55

コミット，ロールバック（レコード更新件数）
○
○
○
○
件数
○
56

トランザクション情報
コミット
○
×
×
×
件数
○
61

ロールバック
○
×
×
×
件数
○
62

ネーム情報
キャッシュヒット
○
×
×
×
件数
○
71

ローカルヒット
○
×
×
×
件数
○
72

lookup
○
×
×
×
件数
○
73

チェックポイントダンプ情報
チェックポイントダンプ取得（取得間隔）
○
○
○
○
ミリ秒
×
81

チェックポイントダンプ有効化（取得時間）
○
○
○
○
ミリ秒
×
82

メッセージキュー情報
readメッセージ（入力長）
○
○
○
○
バイト
×
91

writeメッセージ（出力長）
○
○
○
○
バイト
×
92

readエラー
○
×
×
×
件数
×
93

writeエラー
○
×
×
×
件数
×
94

空きバッファ待ち
○
×
×
×
件数
×
95

実read
○
×
×
×
件数
×
96

実write
○
×
×
×
件数
×
97

遅延書き込み（実write回数）
○
○
○
○
回数
×
99

物理ファイル単位の遅延書き込み（遅延書き込み対象となったレコード数）
○
○
○
○
レコード数
×
151

物理ファイル単位の遅延書き込み（遅延書き込み対象となったメッセージの割合）
○
○
○
○
％
×
152

ジャーナル情報
バッファ満杯
○
×
×
×
件数
○
102

空きバッファ待ち
○
×
×
×
件数
○
103

ジャーナル出力（ブロック長）
○
○
○
○
バイト
×
104

ジャーナル出力（非バス部分データ長）※⁴
○
○
○
○
バイト
×
105

入出力待ち（待ちバッファ面数）
○
○
○
○
面数×100
×
107

write
○
×
×
×
件数
×
108

writeエラー
○
×
×
×
件数
×
109

スワップ（スワップ時間）
○
○
○
○
マイクロ秒
×
110

ジャーナル入力（データ長）
○
○
○
○
バイト
×
111

read
○
×
×
×
件数
×
113

readエラー
○
×
×
×
件数
×
114

MCF情報
メモリキューへのメッセージ入力
○
×
×
×
件数
×
121

ディスクキューへのメッセージ入力
○
×
×
×
件数
×
122

メモリキューからのメッセージ出力
○
×
×
×
件数
×
123

ディスクキューからのメッセージ出力
○
×
×
×
件数
×
124

コネクション障害によるコネクション切断
○
×
×
×
件数
×
125

共用メモリ管理情報
静的共用メモリ使用サイズ
○
○
○
○
バイト
○
131

静的共用メモリプール必要最大サイズ
○
○
○
○
バイト
○
132

動的共用メモリ使用サイズ
○
○
○
○
バイト
○
133

動的共用メモリプール必要最大サイズ
○
○
○
○
バイト
○
134

MQAサービス情報
getメッセージ（入力長）
○
○
○
○
バイト
○
161

putメッセージ（出力長）
○
○
○
○
バイト
○
162

readエラー
○
－
－
－
件数
○
163

writeエラー
○
－
－
－
件数
○
164

空きバッファ待ち
○
－
－
－
件数
○
165

実read
○
－
－
－
件数
○
166

実write
○
－
－
－
件数
○
167

書き込み依頼時間
○
○
○
○
マイクロ秒
○
169

1回のトリガ契機の起動メッセージ数
○
○
○
○
回数
○
170

メッセージ転送開始待ち時間
○
○
○
○
ミリ秒
○
171

メッセージ到着待ち時間
○
○
○
○
ミリ秒
○
172

ISTサービス情報
入力長
○
○
○
○
バイト
○
191

出力長
○
○
○
○
バイト
○
192

ほかのノードからの更新を受けた回数
○
×
×
×
回数
×
193

ほかのノードへ更新した回数
○
×
×
×
回数
×
194

XATMIサービス情報
XATMIコールレスポンスタイム
○
○
○
○
マイクロ秒
○
211

XATMIユーザサービス実行時間
○
○
○
○
マイクロ秒
○
212

XATMIサービス障害回数
○
×
×
×
回数
○
213

（凡例）

○：システムジャーナルファイルに出力できます。またはユーザサーバ単位に編集できます。

×：システムジャーナルファイルに出力できません。またはユーザサーバ単位に編集できません。

－：編集出力しません。

注※1

dcreportコマンド実行時に指定する引数です。

注※2

dcreportコマンド実行時は出力されます。

注※3

この統計情報は，ディファード更新指定のDAMファイルを更新しない場合は出力されません。また，この統計情報の出力回数は10回のディファード更新処理に1回の割合です。

注※4

OpenTP1内部情報です。

付録E.2　トランザクション統計情報

トランザクション統計情報の詳細を次の表に示します。

表E-3　トランザクション統計情報の詳細

項目
詳細内容

ブランチ実行時間
（同期点処理時間を含む）
サービスをトランザクションとして開始してから，同期点処理が完了するまでの実時間
＜発生件数＞
取得しません。

ブランチ同期点処理実行時間
トランザクションとして実行したサービスの終了後に実行される，同期点処理の実時間（上記ブランチ実行時間に含まれる時間）
＜発生件数＞
取得しません。

ブランチ本体決着方法
サービスで実行したトランザクションブランチの決着方法
＜発生件数＞
コミット決着した件数およびロールバック決着した件数

子ブランチを含む決着方法
サービスから分岐したトランザクションブランチ（子ブランチ）を含めた決着方法
＜発生件数＞
コミット決着，ロールバック決着，およびコマンドによる決着の件数

ブランチ決着プロセス種別
トランザクションの決着処理が行われたプロセス種別
＜発生件数＞
ユーザサーバプロセスで行われた件数およびトランザクション回復プロセスで行われた決着処理件数

付録E.3　レスポンス統計情報

＜この項の構成＞

(1)　レスポンス統計情報の詳細

(2)　レスポンス統計情報の出力結果例

(1)　レスポンス統計情報の詳細

レスポンス統計情報の詳細を次の表に示します。

表E-4　レスポンス統計情報の詳細

項目
詳細内容

RPC種別
ジャーナルを出力したノードから該当するサービスに対して呼び出したRPCの，種別ごとの呼び出し回数

レスポンスタイム※1
dc_rpc_callを呼び出してから応答電文を受け取るまでの時間。ただし，次に示すとおり，時間はフラグによって異なります。
DCNOFLAGS（同期応答型RPC）：dc_rpc_callを呼び出してから応答電文を受け取るまでの時間
DCRPC_CHAINED（連鎖RPC）：dc_rpc_callを呼び出してから応答電文を受け取るまでの時間
DCRPC_NOWAIT（非同期応答型RPC）：dc_rpc_callを呼び出してから応答をout領域に書き込むまでの時間
DCRPC_NOREPLY（非応答型RPC）：取得しません。

サービス実行時間※2
サービス関数の実行時間。非応答型RPCの場合は取得しません。

サービス待ち時間※2
スケジュールキューに要求が入ってから取り出されるまでの時間。非応答型RPCの場合は取得しません。

注※1

レスポンスタイムとは次の時間を表します。

レスポンスタイム=サービス実行時間+サービス待ち時間+通信時間

サービス実行時間とサービス待ち時間には，通信時間は含まれません。

注※2

MHPのサービス実行時間，およびサービス待ち時間は取得されません。

なお，レスポンス統計情報では，成功したRPCについてだけ回数を数えています。タイムアウトなどでエラーになったRPCについては回数に含みません。

(2)　レスポンス統計情報の出力結果例

サービスの実行形態によって，レスポンス統計情報の出力結果が異なります。実行形態ごとの統計情報の例を次に示します。

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

サービスの要求元とは別ノードにサービスがある場合の例を次の図に示します。

図E-1　サービスの要求元とは別ノードにサービスがある場合の例

図E-1の各ホストで取得されたジャーナルを編集すると，ホストごとのレスポンス統計情報の出力結果は次のようになります。

●ホストAのジャーナルを編集した場合

注※1

図E-1のt10－t1の値が入ります。

注※2

図E-1のt9－t3の値が入ります。

注※3

図E-1のt3－t2の値が入ります。

出力項目について説明します。

RPC種別ごとの件数

ホストAからサービスグループAのサービスAに対して，同期応答型で1回呼び出したことを表しています。

レスポンスタイム

ホストAのSUPがdc_rpc_callを呼び出して応答を受け取るまでの時間です。

サービス実行時間

サービスグループAのサービスAが処理を開始してから，応答送信をするまでの時間です。ただし，応答送信をした際の通信時間は含まれません。

サービス待ち時間

ホストAのSUPからの要求が，スケジュールキューに入ってから取り出されるまでの時間です。

●ホストBのジャーナルを編集した場合

注※1

0が入ります。

注※2

図E-1のt9－t3の値が入ります。

注※3

図E-1のt3－t2の値が入ります。

注※4

図E-1のt8－t4の値が入ります。

注※5

図E-1のt7－t6の値が入ります。

注※6

図E-1のt6－t5の値が入ります。

出力項目について説明します。

サービスグループAのサービスA

RPC種別ごとの件数

ホストBからサービスグループAのサービスAを1回も呼び出していないことを表しています。

レスポンスタイム

ホストAのSUPがdc_rpc_callを呼び出して応答を受け取るまでの時間ですが，ホストBのジャーナルを編集しているため，この値は取得できません。そのため0が入ります。

サービス実行時間

サービスグループAのサービスAが処理を開始してから，応答送信をするまでの時間です。ただし，応答送信をした際の通信時間は含まれません。

サービス待ち時間

ホストAのSUPからの要求が，スケジュールキューに入ってから取り出されるまでの時間です。

サービスグループBのサービスB

RPC種別ごとの件数

ホストBからサービスグループBのサービスBに対して，同期応答型で1回呼び出したことを表しています。

レスポンスタイム

ホストBのSPP Aがdc_rpc_callを呼び出して応答を受け取るまでの時間です。

サービス実行時間

サービスグループBのサービスBが処理を開始してから，応答送信をするまでの時間です。ただし，応答送信をした際の通信時間は含まれません。

サービス待ち時間

ホストBのSPP Aからの要求が，スケジュールキューに入ってから取り出されるまでの時間です。

●ホストCのジャーナルを編集した場合

注※1

0が入ります。

注※2

図E-1のt9－t3の値が入ります。

注※3

図E-1のt3－t2の値が入ります。

出力項目について説明します。

RPC種別ごとの件数

ホストCからサービスグループBのサービスBを1回も呼び出していないことを表しています。

レスポンスタイム

ホストBのSPP Aがdc_rpc_callを呼び出して応答を受け取るまでの時間ですが，ホストCのジャーナルを編集しているため，この値は取得できません。そのため0が入ります。

サービス実行時間

サービスグループBのサービスBが処理を開始してから，応答送信をするまでの時間です。ただし，応答送信をした際の通信時間は含まれません。

サービス待ち時間

ホストBのSPP Aからの要求が，スケジュールキューに入ってから取り出されるまでの時間です。

各ホストのジャーナルと，ジャーナルから得られるレスポンス統計情報の関係は次のようになります。

ホストAのジャーナルを編集すると，ホストBで動作したSPP Aの統計情報を得られます。

ホストBのジャーナルを編集すると，ホストCで動作したSPP Bの統計情報を得られます。

ホストBのジャーナルを編集しても，SPP Aの統計情報は得られません。

ホストCのジャーナルを編集しても，SPP Bの統計情報は得られません。

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

自ノード内でサービスを実行する場合の例を次の図に示します。

図E-2　自ノード内でサービスを実行する場合の例

図E-2のホストで取得されたジャーナルを編集すると，レスポンス統計情報の出力結果は次のようになります。

注※1

図E-2のt10－t1の値が入ります。

注※2

図E-2のt9－t3の値が入ります。

注※3

図E-2のt3－t2の値が入ります。

注※4

図E-2のt8－t4の値が入ります。

注※5

図E-2のt7－t6の値が入ります。

注※6

図E-2のt6－t5の値が入ります。

出力項目について説明します。

サービスグループAのサービスA

RPC種別ごとの件数

自ノードからサービスグループAのサービスAに対して，同期応答型で1回呼び出したことを表しています。

レスポンスタイム

SUPがdc_rpc_callを呼び出して応答を受け取るまでの時間です。

サービス実行時間

サービスグループAのサービスAが処理を開始してから，応答送信をするまでの時間です。ただし，応答送信をした際の通信時間は含まれません。

イベント回数は，SUP側とSPP A側の両方にrpc_response_statistics=Yが指定されているため，2となっています。

平均値についても，（最大値+最小値）÷2の値となっています。

サービス待ち時間

SUPからの要求が，スケジュールキューに入ってから取り出されるまでの時間です。

イベント回数は，SUP側とSPP A側の両方にrpc_response_statistics=Yが指定されているため，2となっています。

平均値についても，（最大値+最小値）÷2の値となっています。

サービスグループBのサービスB

RPC種別ごとの件数

自ノードからサービスグループBのサービスBに対して，同期応答型で1回呼び出したことを表しています。

レスポンスタイム

SPP Aがdc_rpc_callを呼び出して応答を受け取るまでの時間です。

サービス実行時間

サービスグループBのサービスBが処理を開始してから，応答送信をするまでの時間です。ただし，応答送信をした際の通信時間は含まれません。

イベント回数は，SPP A側とSPP B側の両方にrpc_response_statistics=Yが指定されているため，2となっています。

平均値についても，（最大値+最小値）÷2の値となっています。

サービス待ち時間

SPP Aからの要求が，スケジュールキューに入ってから取り出されるまでの時間です。

イベント回数は，SPP A側とSPP B側の両方にrpc_response_statistics=Yが指定されているため，2となっています。

平均値についても，（最大値+最小値）÷2の値となっています。

(c)　クライアントから実行する場合

クライアントからサービスを実行する場合の例を次の図に示します。

図E-3　クライアントからサービスを実行する場合の例

図E-3のホストで取得されたジャーナルを編集すると，レスポンス統計情報の出力結果は次のようになります。

注※1

0が入ります。

注※2

図E-3のt9－t3の値が入ります。

注※3

図E-3のt3－t2の値が入ります。

注※4

図E-3のt8－t4の値が入ります。

注※5

図E-3のt7－t6の値が入ります。

注※6

図E-3のt6－t5の値が入ります。

出力項目について説明します。

サービスグループAのサービスA

RPC種別ごとの件数

自ノードからサービスグループAのサービスAを1回も呼び出していないことを表しています。クライアントが同一ノード内であっても，クライアントはレスポンス統計情報を取得できないため，回数として数えられません。

レスポンスタイム

CUPがdc_rpc_callを呼び出して応答を受け取るまでの時間ですが，クライアントはレスポンス統計情報を取得できないため，この値は取得できません。そのため0が入ります。

サービス実行時間

サービスグループAのサービスAが処理を開始してから，応答送信をするまでの時間です。ただし，応答送信をした際の通信時間は含まれません。

サービス待ち時間

CUPからの要求が，スケジュールキューに入ってから取り出されるまでの時間です。

サービスグループBのサービスB

RPC種別ごとの件数

自ノードからサービスグループBのサービスBに対して，同期応答型で1回呼び出したことを表しています。

レスポンスタイム

SPP Aがdc_rpc_callを呼び出して応答を受け取るまでの時間です。

サービス実行時間

サービスグループBのサービスBが処理を開始してから，応答送信をするまでの時間です。ただし，応答送信をした際の通信時間は含まれません。

イベント回数は，SPP A側とSPP B側の両方にrpc_response_statistics=Yが指定されているため，2となっています。

平均値についても，（最大値+最小値）÷2の値となっています。

サービス待ち時間

SPP Aからの要求が，スケジュールキューに入ってから取り出されるまでの時間です。

イベント回数は，SPP A側とSPP B側の両方にrpc_response_statistics=Yが指定されているため，2となっています。

平均値についても，（最大値+最小値）÷2の値となっています。

付録E.4　通信遅延時間統計情報

通信遅延時間統計情報の詳細を次の表に示します。

表E-5　通信遅延時間統計情報の詳細

項目
詳細内容

通信遅延時間
レスポンスタイムからサーバ側の処理時間を引いた値。通信（要求送信＋応答送信）に掛かった時間
＜発生件数＞
同期型RPC（連鎖RPCも含む）の発行回数

付録E.5　リアルタイム統計情報

＜この項の構成＞

(1)　リアルタイム統計情報の詳細

(2)　リアルタイム統計情報の詳細（取得対象を指定した場合）

(1)　リアルタイム統計情報の詳細

リアルタイム統計情報の詳細を次の表に示します。

表E-6　リアルタイム統計情報の詳細

リアルタイム統計情報種別（Type）
編集内容
詳細内容

リアルタイム統計情報の項目名
（Event）
取得情報

チェックポイントダンプ情報
（CPD）
チェックポイントダンプ取得
（Collection of cpd）
件数
チェックポイントダンプ契機数。

時間
前回のチェックポイントから今回のチェックポイントまでの時間間隔（チェックポイント契機間隔）。チェックポイントは，一定のジャーナルブロックの出力数によって発生するため，その頻度を時間で評価します。

チェックポイントダンプ有効化
（Validation of cpd）
件数
チェックポイントダンプ契機数。

時間
チェックポイントダンプ取得契機が発生し，各システムサーバで取得処理を開始してから有効化が完了するまでの時間。

ジャーナル情報
（JNL）
バッファ満杯
（Buffer full occurrences）
件数
ジャーナルレコードをカレントバッファにバッファリングしようとしたときにバッファの空きエリアが小さく，バッファリングできない状態。システムでジャーナルバッファは3面あり，このうち1面がカレントバッファに当たります。

空きバッファ待ち
（Waits for an available buffer）
件数
ジャーナルバッファが3面とも満杯，または出力中の場合にジャーナルをバッファリングができないため，バッファが空くのを待っている状態。

ジャーナル出力（ブロック）
（Journal output）
回数
ジャーナルブロックの出力回数。

データ長
ジャーナルブロックのデータ長。この値から単位時間に発生したジャーナル量の目安が得ることができます。

入出力待ち
（I/O waits）
回数
ジャーナル出力の完了回数。

バッファ面数×100
ジャーナル出力の完了時に出力待ちをしているバッファ面数。ただし，平均値の小数点以下が切り捨てられないように，バッファ面数を100倍した値が出力されます。

write
（Write）
回数
ジャーナルの出力だけではなく，ジャーナルスワップ時のファイル管理情報の出力も含めた出力回数。

時間
ジャーナルファイルの書き込み処理に掛かった時間。

スワップ
（Swap）
回数
ジャーナルファイルをスワップした回数。

時間
ジャーナルファイルのスワップ処理に掛かった時間。

ジャーナル入力
（Journal input）
回数
ジャーナルファイルからデータを入力した回数。

データ長
ジャーナルファイルから入力したデータ長。

read
（Read）
回数
ジャーナルの入力だけではなく，ジャーナルスワップ時のファイル管理情報の入力も含めた入力回数。

時間
ジャーナルファイルの読み込み処理に掛かった時間。

ロック情報（LCK）
ロック取得
（Lock acquisition）
件数
ロック待ちの発生件数。

時間
ロック待ちが発生して，待ち状態になってから待ち状態が解除されるまでの時間。このロックとは，dc_lck_get関数，DAM，TAM，およびMQAが発行するロックサービスの内部ロックを指します。

ロック待ち
（Lock wait）
件数
ロック待ちの発生件数。

行列長
ロック待ちが発生した時の待ち行列長。

デッドロック
（Deadlock）
件数
デッドロックの発生件数。システムサーバが検出したデッドロックは，サービス単位の統計情報としては取得されません。

ネーム情報（NAM）
グローバルキャッシュヒット
（Global Cache hits）
回数
サービスグループの情報を検索したときに，グローバルキャッシュ領域に格納されているサービスグループの情報を参照した回数。ただし，参照した回数と実際に通信した回数は一致しないことがあります。※1

ローカルキャッシュヒット
（Local Cache hits）
回数
サービスグループの情報を検索したとき，ローカルキャッシュ領域に格納されているサービスグループの情報を参照した回数。ただし，参照した回数と実際に通信した回数は一致しないことがあります。※1

サービス情報の検索回数
（Lookup）
回数
UAPでRPCを実行するときに，グローバルキャッシュ領域やローカルキャッシュ領域のサービスグループの情報を検索した回数。
なお，グローバルキャッシュ領域，ローカルキャッシュ領域に該当するサービスグループの情報が格納されていない場合，グローバルキャッシュヒット回数，およびローカルキャッシュヒット回数はカウントされませんが，サービス情報の検索回数はカウントされます。そのため，グローバルキャッシュヒット回数，ローカルキャッシュヒット回数とサービス情報の検索回数の値は一致しないことがあります。

共用メモリ管理情報
（OSL）
静的共用メモリの使用サイズ
（Common static memory(acquired)）
回数
静的共用メモリ確保・解放関数発行回数に1を加算した数。

メモリブロックのサイズ
静的共用メモリブロックの確保・解放処理後の静的共用メモリブロックの総使用サイズ。

静的共用メモリプールの必要最大サイズ（現在使用中の最高位メモリブロックまでのサイズ）
（Common static memory(pool)）
回数
プールサイズを更新した回数に1を加算した数。

メモリブロックのサイズ
静的共用メモリブロックの使用サイズの最大値。ブロックの確保・解放処理後に，それ以前のプールサイズを更新した場合に取得します。
プールサイズとは，いったん確保した共用メモリを解放したことで，プール内が虫食い状態となった場合，この虫食い部分を含めた使用中共用メモリのサイズの合計です。
したがって，システム環境定義のstatic_shmpool_sizeオペランドに設定する値はこの値以上にしてください。
この情報は，リアルタイム統計情報サービス定義のrts_trcput_intervalオペランドで指定した取得間隔ではなく，取得を開始してからの通算で情報を取得します。

動的共用メモリの使用サイズ
（Common dynamic memory(acquired)）
回数
動的共用メモリ確保・解放関数発行回数に1を加算した数。

メモリブロックのサイズ
動的共用メモリブロックの確保・解放処理後の動的共用メモリブロックの総使用サイズ。

動的共用メモリプールの必要最大サイズ（現在使用中の最低位メモリブロックまでのサイズ）
（Common dynamic memory(pool)）
回数
プールサイズを更新した回数に1を加算した数。

メモリブロックのサイズ
動的共用メモリブロックの使用サイズの最大値。ブロックの確保・解放処理後に，それ以前のプールサイズを更新した場合に取得します。システム環境定義のdynamic_shmpool_sizeオペランドにはこの値以上の値を指定してください。
この情報は，リアルタイム統計情報サービス定義のrts_trcput_intervalオペランドで指定した取得間隔ではなく，取得を開始してからの通算で取得します。

プロセス情報（PRC）
プロセス生成
（Process generations）
回数
OpenTP1システムが起動したプロセス数。非常駐サーバのプロセスの起動もカウントされます。
プロセスサービスが起動したプロセス数だけをカウントするため，プロセスサービス自体や，プロセスサービスが起動していないプロセスはカウントしません。

UAP異常終了
（UAP abnormal terminations）
回数
UAPプロセスのユーザサーバごとの異常終了回数。ユーザサーバがダウンした場合はカウントされますが，dc_rpc_closeのあとに異常終了したプロセスはカウントしません。プロセスの終了とカウントされる項目との関係については，表E-7を参照してください。

システムサーバ異常終了
（System server abnormal terminations）
回数
システムサービスプロセスの異常終了回数。システムサービスプロセスが異常終了し，OpenTP1がシステムダウンした場合，この情報は取得されないことがあります。

注

OpenTP1が提供しているサーバのうち，SPPとして動作しているもの（TP1/EE，rapサーバ，RTSSUPなど）がダウンした場合，「システムサーバ異常終了」ではなく，「UAP異常終了」にカウントされます。

プロセスの終了とカウントされる項目との関係については表E-7を参照してください。

プロセス終了
（Process terminations）
回数
正常終了したプロセス，-fオプションを指定したdcsvstopコマンドまたはprckillコマンドで停止したプロセス，および実時間監視タイムアウトで強制停止したプロセスの終了回数。
「UAP異常終了」と「システムサーバ異常終了」の回数は含みません。プロセスの終了とカウントされる項目との関係については，表E-7を参照してください。

起動プロセス数
（Number of processes）
回数
一定間隔での監視回数。通常は60秒ごとに監視しますが，dcstart，dcstop，dcsvstart，dcsvstop，eesvstart，eesvstopコマンドなど実行した場合は2秒ごとに監視します。

プロセス数
OpenTP1システムで起動しているシステムサービスとUAPプロセスの数。プロセスサービスが起動したプロセス数だけをカウントするため，プロセスサービス自体や，プロセスサービスが起動していないプロセスはカウントしません。この情報は，リアルタイム統計情報サービス定義のrts_trcput_intervalオペランドで指定した取得間隔ではなく，取得を開始してからの通算で取得します。

メッセージキュー情報（QUE）
readメッセージ
（Read message）
回数
キューファイルからメッセージを読み込んだ回数。

メッセージ長
キューファイルから読み込んだメッセージ長。

writeメッセージ
（Write message）
回数
キューファイルにメッセージを書き込んだ回数。

メッセージ長
キューファイルに書き込んだメッセージ長。

readエラー
（Read errors）
件数
物理ファイルからの入力で障害が発生した件数（異常ケース）。

writeエラー
（Write errors）
件数
物理ファイルへの出力で障害が発生した件数（異常ケース）。

空きバッファ待ち
（Waits for an available buffer）
件数
該当するキューファイルに要求が集中し，必要な入出力バッファが不足した件数。この値によってメッセージキューサービス定義の入出力バッファ数を見直してください。

実read
（Real reads）
回数
入出力バッファにメッセージがない場合の，物理ファイルからの入力の発生回数。この値を小さくする場合は，メッセージキューサービス定義の入出力バッファ数を大きくしてください。

実write
（Real writes）
回数
物理ファイルへの出力の発生回数。この値と「writeメッセージ」の回数を比較すると，どれだけまとめてwrite要求がI/Oされたかがわかります。I/O回数を少なくする場合は，メッセージキューサービス定義の入出力バッファ数を大きくしてください。遅延書き込み機能を使用する場合，物理ファイルへの出力は「遅延書き込み（実write回数）」でカウントされます。このため，「実write」の値は0にすることが理想的です。

遅延書き込み（回数）
（Number of delay writings）
回数
遅延書き込み機能を使用する場合，遅延書き込み要求が発生した回数。

回数
遅延書き込み機能を使用する場合，遅延書き込み要求1回に対して行われた物理ファイルへの書き込み（実write）回数。

物理ファイル単位の遅延書き込み（レコード）
（Number of delay writing records）
回数
遅延書き込み機能を使用する場合，個々の物理ファイルに対して遅延書き込み要求が発生した回数。

レコード数
遅延書き込み対象となったレコード数。この情報は物理ファイル単位に取得しますが，表示は物理ファイル全体の情報です。物理ファイル単位では表示されません。この値からメッセージキューサービス定義の入出力バッファ数をチューニングできます。

物理ファイル単位の遅延書き込み（メッセージ）
（Delay writing record rate）
回数
遅延書き込み機能を使用する場合，個々の物理ファイルに対して遅延書き込み要求が発生した回数。

メッセージの割合
全体のメッセージ数に対する，遅延書き込み対象となったメッセージの割合。この情報は物理ファイル単位に取得しますが，表示は物理ファイル全体の情報です。物理ファイル単位では表示されません。この値からメッセージキューサービス定義の入出力バッファ数をチューニングできます。

RPC情報（RPC）
RPCコール（同期応答型）
（RPC calls）
回数
同期応答型dc_rpc_callおよび同期応答型dc_rpc_call_toの呼び出し回数。同期応答型dc_rpc_callおよび同期応答型dc_rpc_call_toが成功した場合に取得します。

時間
クライアント側の同期応答型dc_rpc_callおよび同期応答型dc_rpc_call_to内で，サーバに要求を送信してからサーバから応答を受け取るまでの時間。同期応答型dc_rpc_callおよび同期応答型dc_rpc_call_toが成功した場合に取得します。同期応答型dc_rpc_callおよび同期応答型dc_rpc_call_to内でサーバへの要求送信が失敗して，サーバへの要求送信をリトライした場合，リトライした時間も含みます。

RPCコール（連鎖RPC型）
（RPC calls(chained)）
回数
連鎖RPCの開始から連鎖RPC終了までの連鎖dc_rpc_callおよび連鎖dc_rpc_call_toの呼び出し回数。連鎖dc_rpc_callおよび連鎖dc_rpc_call_toが成功した場合に取得します。

時間
クライアント側の連鎖RPCの開始から連鎖RPCの終了までの連鎖dc_rpc_callおよび連鎖dc_rpc_call_to内で，サーバに要求を送信してからサーバから応答を受け取るまでの時間。連鎖dc_rpc_callおよび連鎖dc_rpc_call_toが成功した場合に取得します。

ユーザサービス実行
（Execution of user service）
回数
dc_rpc_callおよびdc_rpc_call_toで要求したサービス関数の実行回数。サービスリトライ機能を使用してサービス関数をリトライした場合，サービス関数をリトライした回数は含みません。

時間
dc_rpc_callおよびdc_rpc_call_toで要求したサービス関数の実行開始から，サービス関数でreturnを発行するまでの時間。dc_rpc_mainloopの中で取得します。サービスリトライ機能を使用してサービス関数をリトライした場合，サービス関数をリトライした時間を含みます。

RPCタイムアウト
（RPC overtimes）
件数
RPCの応答待ちの処理で発生したタイムアウトエラーの発生件数。

スケジュール情報
（SCD）
スケジュール待ち
（Schedule Waits）
回数
クライアントが，該当するユーザサーバに対して行ったサービス要求（dc_rpc_call）の回数。

行列長
該当するユーザサーバ（SPP）のスケジュールキューに滞留したサービス要求数。
この値が大きい場合は，ユーザサービス定義のparallel_countオペランドの指定値を大きくしてください。また，非常駐プロセスがある場合は，必要に応じてbalance_countオペランドの指定値を小さくして非常駐プロセスを起動しやすくしてください。
この値が小さい場合は，必要であればユーザサービス定義のparallel_countオペランドに指定する常駐プロセス数を小さくしてください。また，非常駐プロセスがある場合は，必要に応じてbalance_countオペランドの指定値を大きくして非常駐プロセスを起動しにくくしてください。平均値と最大値に差がある場合はparallel_countオペランドに指定する常駐プロセス数と非常駐プロセス数の比率や最大プロセス数を調整してください。

スケジュール
（Schedule）
回数
クライアントが，該当するユーザサーバに対して行ったサービス要求（dc_rpc_call）の回数。

メッセージ長
該当するユーザサーバ（SPP）が受信したサービス要求メッセージ長。メッセージ長にはシステムが付加する制御情報（512バイト）が加算されています。※2

メッセージ格納バッファプールの使用中サイズ
（Size of using buffer）
回数
クライアントが，該当するユーザサーバに対して行ったサービス要求（dc_rpc_call）の回数。

バッファプールのサイズ
該当するユーザサーバ（SPP）のメッセージ格納バッファプールの使用中サイズ長。ただし，メッセージ格納バッファプールを共用している場合は所属しているスケジュールバッファグループの共用メッセージ格納バッファプールの値となります。

メッセージ格納バッファプールの不足でスケジュールできなかったメッセージサイズ
（Message size in case of lack of buffer）
回数
クライアントが，該当するユーザサーバに対して行ったサービス要求（dc_rpc_call）のうち，メッセージ格納バッファプール不足でスケジュールできなかったサービス要求の回数。

メッセージ長
該当するユーザサーバ（SPP）へのサービス要求のうち，メッセージ格納バッファプールの不足でスケジュールできなかったサービス要求メッセージ長。

スケジュール滞留
（Schedule Stay）
回数
スケジュールキューからサービス要求を取り出した回数。

時間
該当するユーザサーバに対して行ったサービス要求（dc_rpc_call）がスケジュールキューに格納されてから取り出されるまでの時間。

サービス単位のスケジュール待ち
（Schedule Waits of service）
回数
クライアントが，該当するユーザサーバに対して行ったサービス要求（dc_rpc_call）の回数。ユーザサービス定義にscdsvcdef定義コマンドを指定した場合にだけ取得されます。

行列長
該当するユーザサーバ（SPP）のスケジュールに滞留したサービス要求数。ユーザサービス定義にscdsvcdef定義コマンドを指定した場合にだけ取得されます。

サービス単位のメッセージ格納バッファプールの使用中サイズ
（Size of using buffer of service）
回数
クライアントが，該当するユーザサーバに対して行ったサービス要求（dc_rpc_call）の回数。ユーザサービス定義にscdsvcdef定義コマンドを指定した場合にだけ取得されます。

バッファプールのサイズ
該当するユーザサーバ（SPP）のメッセージ格納バッファプールの使用中サイズ長。ただし，メッセージ格納バッファプールを共用している場合は，所属しているスケジュールバッファグループの共用メッセージ格納バッファプールの値となります。ユーザサービス定義にscdsvcdef定義コマンドを指定した場合にだけ取得されます。

同時実行サービス数
（Parallel Service）
回数
スケジュールキューからサービス要求を取り出した回数。ユーザサービス定義にscdsvcdef定義コマンドを指定した場合にだけ取得されます。

サービス数
該当するユーザサーバ（SPP）が同時実行しているサービス要求数。ユーザサービス定義にscdsvcdef定義コマンドを指定した場合にだけ取得されます。

トランザクション情報（TRN）
コミット
（Commits）
件数
トランザクションのコミット決着数。

ロールバック
（Rollbacks）
件数
トランザクションのロールバック決着数。

コマンドによるコミット
（Commit settlement by command）
件数
コマンドによるトランザクションのコミット決着数。

コマンドによるロールバック
（Rollback settlement by command）
件数
コマンドによるトランザクションのロールバック決着数。

コマンドによるハザード
（Hazard settlement by command）
件数
コマンドによるトランザクションのヒューリスティックハザード決着数。

コマンドによるミックス
（Mixed settlement by command）
件数
コマンドによるトランザクションのヒューリスティックミックス決着数。

ブランチ実行時間
（Branch execution time）
回数
トランザクションブランチの実行回数。

時間
サービスをトランザクションとして開始してから，同期点処理が完了するまでの実時間。

ブランチ同期点処理の実行時間
（Branch synchronous point processing time）
回数
同期点処理の実行回数。

時間
トランザクションとして実行したサービスの終了後に実行される，同期点処理の実時間（上記ブランチ実行時間に含まれる時間）。

リアルタイム統計情報（RTS）
任意区間の実行
（Arbitrary section）
回数
dc_rts_utrace_putの呼び出し回数。

時間
DCRTS_STARTフラグを設定したdc_rts_utrace_putの呼び出しからDCRTS_ENDフラグを設定したdc_rts_utrace_putの呼び出しまでの時間。任意区間の情報はシステム全体の統計情報としては取得しません。

DAM情報
（DAM）
read
（Read）
回数
dc_dam_readの呼び出し回数。dc_dam_readが成功した場合に取得します。

データ長
dc_dam_readの引数に指定したバッファ長。

readエラー
（Read errors）
件数
DAMキャッシュブロック，またはディスクから読み込んだDAMブロックに異常を検出した回数，およびディスクからの読み込みでエラーが発生した回数。APIの引数が不正などのエラーは，カウントしません。

write
（Write）
回数
dc_dam_write，dc_dam_rewriteの呼び出し回数。dc_dam_write，dc_dam_rewriteが成功した場合に取得します。

データ長
dc_dam_write，dc_dam_rewriteの引数に指定したバッファ長。

writeエラー
（Write errors）
件数
DAMキャッシュブロックのデータをディスクへ書き込むときにエラーが発生した件数。トランザクションがコミットしたタイミングによっては，サービス単位に取得できない場合もあります。なお，APIの引数が不正などのエラーは，カウントしません。

FJ出力回数
（FJ output frequency）
回数
回復用ジャーナル（FJ）の出力回数。トランザクションがコミットしたタイミングによっては，サービス単位に取得できない場合もあります。

ジャーナルサイズ
回復用ジャーナル（FJ）のジャーナル量。トランザクションがコミットしたタイミングによっては，サービス単位に取得できない場合もあります。

同時実行DAMトランザクションブランチ数
（Number of DAM transaction branches）
回数
DAMに関連するトランザクションブランチ数。

トランザクション数
トランザクション内で最初に実行したDAMサービスの関数が，その時点で動作しているDAMに関連するトランザクションブランチ数。DAMに関連するトランザクションブランチ数が，DAMサービス定義のdam_tran_process_countオペランドの指定値よりも少ない場合は，dam_tran_process_countオペランドの指定値を出力します。この項目の最大値が，同時に実行したDAMに関連するトランザクションブランチ数の最大値になります。この値をDAMサービス定義のdam_tran_process_countオペランドに指定するか，dam_cache_sizeオペランドまたはdam_cache_size_fixオペランドの計算式に用いるとDAMキャッシュ用の共用メモリが最適な値になります。

DAMキャッシュブロックの確保回数
（DAM cache-block securing frequency）
回数
DAMキャッシュブロックを確保した回数。

DAMキャッシュ用の共用メモリの使用率
（Common memory for DAM use rate）
回数
ディファード更新指定のDAMファイルを更新したトランザクション数を10で割った値。

共用メモリプール使用率
DAMキャッシュ用の共用メモリの使用率。ただし，この値はディファード更新指定のDAMファイルを更新するトランザクション内だけで取得します。

TAM情報
（TAM）
TAMファイル実更新
（Table file real renewal）
回数
TAMファイルにデータを更新した回数。TAMファイルに更新する契機はタイマ起動，cpd，tamholdコマンドなどがあります。1回の更新契機で複数のTAMファイルを更新した場合は1回とカウントします。

データのバイト数
オンライン中にTAMファイルに対して実更新したデータのバイト数。バイト数は1回の更新契機で書き込んだ総量であり，複数のTAMファイルを更新した場合はその合計となります。

TAMファイル実更新時間
（Table file real renewal time）
回数
TAMファイルにデータを更新した回数。TAMファイルに更新する契機はタイマ起動，cpd，tamholdコマンドなどがあります。1回の更新契機で複数のTAMファイルを更新した場合は1回とカウントします。

時間
TAMファイル更新の処理時間。1回の更新契機での更新処理時間をマイクロ秒単位で取得します。

コミット，ロールバック（レコード参照）
（Number of tam record references）
回数
TAMに関するコミット，ロールバックの回数。

レコード数
1回のトランザクションで参照したレコード数。この値はTAMサーバのコミット処理で統計出力しているため，dc_tam_readの呼び出し有無に関係なく発生件数をカウントします。したがって，dc_tam_readを呼び出さないシステムでは発生件数だけをカウントして，最大値，最小値，および平均値は0となります。

コミット，ロールバック（レコード更新）
（Number of tam record renewal）
回数
TAMに関するコミット，ロールバックの回数。

レコード数
1回のトランザクションで更新したレコード数。この値はTAMサーバのコミット処理で統計出力しているため，dc_tam_writeの呼び出し有無に関係なく発生件数をカウントします。したがって，dc_tam_writeを呼び出さないシステムでは発生件数だけをカウントして，最大値，最小値，および平均値は0となります。

read
（Read）
回数
dc_tam_readの呼び出し回数。dc_tam_readが成功した場合に取得します。※3

データ長
dc_tam_readを呼び出した単位でTAMファイルのデータの入力長。※3

readエラー
（Read errors）
件数
dc_tam_readの中で，OSとのインタフェース部分で発生した障害の件数。APIの引数が不正などのエラーは発生件数としてカウントしません。※3

write
（Write）
回数
dc_tam_write，dc_tam_rewriteの呼び出し回数。dc_tam_write，dc_tam_rewriteが成功した場合に取得します。※4

データ長
dc_tam_write，dc_tam_rewriteを呼び出した単位でのTAMファイルのデータの出力長。※4

writeエラー
（Write errors）
件数
dc_tam_write，dc_tam_rewriteの中でOSとのインタフェース部分で発生した障害の件数。APIの引数が不正などのエラーは発生件数としてカウントしません。※4

XAリソースサービス情報（XAR）
Start()要求
（Start() request）
回数
アプリケーションサーバからrapサーバへの，トランザクション開始要求の回数。

時間
rapサーバがアプリケーションサーバからのトランザクション開始要求の実行を開始してから，終了するまでの時間。

Start()要求エラー
（Start() request error）
件数
アプリケーションサーバからrapサーバへの，トランザクション開始要求で障害が発生した件数。

Call()要求
（Call() request）
回数
アプリケーションサーバからrapサーバへの，サービス要求の回数。

時間
rapサーバがアプリケーションサーバからのサービス要求の実行を開始してから，終了するまでの時間。

Call()要求エラー
（Call() request error）
件数
アプリケーションサーバからrapサーバへの，サービス要求で障害が発生した件数。

End()要求
（End() request）
回数
アプリケーションサーバからrapサーバへの，トランザクション終了要求の回数。

時間
rapサーバがアプリケーションサーバからのトランザクション終了要求の実行を開始してから，終了するまでの時間。

End()要求エラー
（End() request error）
件数
アプリケーションサーバからrapサーバへの，トランザクション終了要求で障害が発生した件数。

Prepare()要求
（Prepare() request）
回数
アプリケーションサーバからrapサーバへの，トランザクションのプリペア処理要求の回数。

時間
rapサーバがアプリケーションサーバからのトランザクションのプリペア処理要求の実行を開始してから，終了するまでの時間。

Prepare()要求エラー
（Prepare() request error）
件数
アプリケーションサーバからrapサーバへの，トランザクションのプリペア処理要求で障害が発生した件数。

Commit()要求
（Commit() request）
回数
アプリケーションサーバからrapサーバへの，トランザクションのコミット処理要求の回数。

時間
rapサーバがアプリケーションサーバからのトランザクションのコミット処理要求の実行を開始してから，終了するまでの時間。

Commit()要求エラー
（Commit() request error）
件数
アプリケーションサーバからrapサーバへの，トランザクションのコミット処理要求で障害が発生した件数。

Rollback()要求
（Rollback() request）
回数
アプリケーションサーバからrapサーバへの，トランザクションのロールバック処理要求の回数。

時間
rapサーバがアプリケーションサーバからのトランザクションのロールバック処理要求の実行を開始してから，終了するまでの時間。

Rollback()要求エラー
（Rollback() request error）
件数
アプリケーションサーバからrapサーバへの，トランザクションのロールバック処理要求で障害が発生した件数。

Recover()要求
（Recover() request）
回数
アプリケーションサーバからrapサーバへの，プリペア処理済みまたはヒューリスティック決定したトランザクション通知要求の回数。

時間
rapサーバがアプリケーションサーバからのプリペア処理済みまたはヒューリスティック決定したトランザクション通知要求の実行を開始してから，終了するまでの時間。

Recover()要求エラー
（Recover() request error）
件数
アプリケーションサーバからrapサーバへの，プリペア処理済みまたはヒューリスティック決定したトランザクション通知要求で，障害が発生した件数。

Forget()要求
（Forget() request）
回数
アプリケーションサーバからrapサーバへの，トランザクション破棄要求の回数。

時間
rapサーバがアプリケーションサーバからのトランザクション破棄要求の実行を開始してから，終了するまでの時間。

Forget()要求エラー
（Forget() request error）
件数
アプリケーションサーバからrapサーバへの，トランザクション破棄要求で障害が発生した件数。

MCF情報（MCF）
スケジュール待ち
（Schedule Stay）
回数
MHPが入力キューからメッセージを取り出した回数。

時間
MCF通信プロセスが入力キューに登録してからMHPで取り出すまでの処理待ち時間。

ユーザサービス実行（Execution of user service）
回数
MHPがサービスを実行した回数。

時間
サービス関数の実行開始から，サービス関数でreturnを発行するまでの時間。

注※1

ネームサービスでは，システム共通定義のall_nodeオペランドに指定されたノードで稼働しているサービスグループの情報をグローバルキャッシュ領域に，自ノード上で稼働しているサービスグループの情報をローカルキャッシュ領域に格納します。UAPやコマンドでRPCを実行するとき，要求するサービスグループの情報をグローバルキャッシュ領域とローカルキャッシュ領域から検索します。

注※2

ユーザサービス定義のmessage_buflenオペランドにはメッセージサイズ（最大）の値を指定することをお勧めします。ユーザサービス定義のmessage_store_buflenオペランドには，次に示す範囲の値を指定することをお勧めします。

メッセージ長（平均）×スケジュール待ち行列長（最大）<= message_store_buflen <= メッセージ長（最大）×スケジュール待ち行列長（最大）

注※3

TAMテーブルにアクセスするdc_dam_readも含まれます。

注※4

TAMテーブルにアクセスするdc_dam_write，dc_dam_rewriteも含まれます。

プロセスの終了とカウントされるリアルタイム統計情報の項目を次の表に示します。

表E-7　プロセスの終了とカウントされるリアルタイム統計情報の項目

プロセスと終了状態 | カウントされる項目
UAPプロセスがCPU時間監視タイムアウトで終了 | UAP異常終了
OpenTP1が提供しているサーバのうち，SPPとして動作しているもの（TP1/EE，rapサーバ，RTSSUP，RTSSPP）がダウン
UAPプロセスダウン
システムダウンしないシステムサービスダウン（trnrvd（トランザクション回復サービス），clttrnd（トランザクショナルRPC実行プロセス）など） | システムサーバ異常終了
UAPプロセスの正常終了 | プロセス終了
UAPプロセスを-fオプションを指定したdcsvstopコマンド，またはprckillコマンドで強制終了
UAPプロセスが実時間監視タイムアウトで終了

リアルタイム統計情報の編集内容を次の表に示します。

表E-8　リアルタイム統計情報の編集内容

リアルタイム統計情報種別（Type）
編集内容
項目ID
（Event id）
オペランド名
取得単位

リアルタイム統計情報の項目名（Event）
取得情報（Units）
出力単位
SVC
SRV
SYS

累計（Total）
最大（Maximum）
最小（Minimum）
平均（Average）

チェックポイントダンプ情報
（CPD）
チェックポイントダンプ取得
（Collection of cpd）
件数（events）
○
×
1000
rts_cpd_collct_cpd
×
×
○

時間（マイクロ秒）
（microsec）
×
○

チェックポイントダンプ有効化
（Validation of cpd）
件数（events）
○
×
1001
rts_cpd_validt_cpd
×
×
○

時間（マイクロ秒）
（microsec）
×
○

ジャーナル情報
（JNL）
バッファ満杯
（Buffer full occurrences）
件数（events）
○
×
1100
rts_jnl_buf_full
×
×
○

空きバッファ待ち
（Waits for an available buffer）
件数（events）
○
×
1101
rts_jnl_wait_buf
×
×
○

ジャーナル出力（ブロック）
（Journal output）
回数（times）
○
×
1102
rts_jnl_jnl_output
×
×
○

データ長（バイト）
（bytes）
×
○

入出力待ち
（I/O waits）
回数（times）
○
×
1103
rts_jnl_io_wait
×
×
○

バッファ面数×100（面数×100）（surfaces）
×
○

write
（Write）
回数（times）
○
×
1104
rts_jnl_write
×
×
○

時間（マイクロ秒）
（microsec）
×
○
×
×
○

スワップ
（Swap）
回数（times）
○
×
1105
rts_jnl_swap
×
×
○

時間（マイクロ秒）
（microsec）
×
○

ジャーナル入力
（Journal input）
回数（times）
○
×
1106
rts_jnl_jnl_input
×
×
○

データ長（バイト）
（bytes）
×
○

read
（Read）
回数（times）
○
×
1107
rts_jnl_read
×
×
○

時間（マイクロ秒）
（microsec）
×
○
×
×
○

ロック情報
（LCK）
ロック取得
（Lock acquisition）
件数（events）
○
×
1200
rts_lck_lock_acqst
○
○
○

時間（マイクロ秒）（microsec）
×
○

ロック待ち
（Lock wait）
件数（events）
○
×
1201
rts_lck_lock_wait
○
○
○

行列長（events）
×
○

デッドロック
（Deadlock）
件数（events）
○
×
1202
rts_lck_deadlock
○
○
○

ネーム情報
（NAM）
グローバルキャッシュヒット
（Global Cache hits）
回数（times）
○
×
1300
rts_nam_global_cache_hit
○
○
○

ローカルキャッシュヒット
（Local Cache hits）
回数（times）
○
×
1301
rts_nam_local_cache_hit
○
○
○

サービス情報の検索回数
（Lookup）
回数（events）
○
×
1302
rts_nam_lookup
○
○
○

共用メモリ管理情報
（OSL）
静的共用メモリの使用サイズ
（Common static memory (acquired)）
回数（times）
○
×
1400
rts_osl_stamem_acq
×
×
○

メモリブロックのサイズ（バイト）
（bytes）
×
○

静的共用メモリプールの必要最大サイズ（現在使用中の最高位メモリブロックまでのサイズ）
（Common static memory (pool)）
回数（times）
○
×
1401
rts_osl_stamem_pol
×
×
○

メモリブロックのサイズ（バイト）
（bytes）
×
○

動的共用メモリの使用サイズ
（Common dynamic memory (acquired)）
回数（times）
○
×
1402
rts_osl_dynmem_acq
×
×
○

メモリブロックのサイズ（バイト）
（bytes）
×
○

動的共用メモリプールの必要最大サイズ（現在使用中の最低位メモリブロックまでのサイズ）
（Common dynamic memory (pool)）
回数（times）
○
×
1403
rts_osl_dynmem_pol
×
×
○

メモリブロックのサイズ（バイト）
（bytes）
×
○

プロセス情報（PRC）
プロセス生成
（Process generation）
回数（times）
○
×
1500
rts_prc_prc_genert
×
○
○

UAP異常終了
（UAP abnormal terminations）
回数（times）
○
×
1501
rts_prc_uap_abnml
×
○
○

システムサーバ異常終了
（System server abnormal terminations）
回数（times）
○
×
1502
rts_prc_sys_abnml
×
×
○

プロセス終了
（Process terminations）
回数（times）
○
×
1503
rts_prc_prc_term
×
○
○

起動プロセス数
（Number of processes）
回数（times）
○
×
1504
rts_prc_prc_num
×
×
○

プロセス数（Process）
×
○

メッセージキュー情報（QUE）
readメッセージ
（Read message）
回数（times）
○
×
1601
rts_que_read
×
○
○

メッセージ長（バイト）（bytes）
×
○

writeメッセージ
（Write message）
回数（times）
○
×
1602
rts_que_write
×
○
○

メッセージ長（バイト）（bytes）
×
○

readエラー
（Read errors）
件数（events）
○
×
1603
rts_que_read_err
×
○
○

writeエラー
（Write errors）
件数（events）
○
×
1604
rts_que_write_err
×
○
○

空きバッファ待ち
（Waits for an available buffer）
件数（events）
○
×
1605
rts_que_wait_buf
×
○
○

実read
（Real reads）
回数（times）
○
×
1606
rts_que_real_read
×
○
○

実write
（Real writes）
回数（times）
○
×
1607
rts_que_real_write
×
○
○

遅延書き込み
（Number of delay writings）
回数（times）
○
×
1650
rts_que_delay_wrt
×
×
○

回数（times）
×
○

物理ファイル単位の遅延書き込み（レコード）
（Number of delay writing records）
回数（times）
○
×
1651
rts_que_delay_rec
×
×
○

レコード数（レコード）（records）
×
○

物理ファイル単位の遅延書き込み（割合）
（Delay writing record rate）
回数（times）
○
×
1652
rts_que_delay_msg
×
×
○

メッセージの割合（％）
（%）
×
○

RPC情報（RPC）
RPCコール（同期応答型）
（RPC calls）
回数（times）
○
×
1700
rts_rpc_rpc_call
○
○
○

時間（マイクロ秒）（microsec）
×
○

RPCコール（連鎖RPC型）
（RPC calls(chained)）
回数（times）
○
×
1701
rts_rpc_rpc_call_chained
○
○
○

時間（マイクロ秒）（microsec）
×
○

ユーザサービス実行
（Execution of user service）
回数（times）
○
×
1730
rts_rpc_usr_srvc
○
○
○

時間（マイクロ秒）（microsec）
×
○

RPCタイムアウト
（RPC overtimes）
件数（events）
○
×
1731
rts_rpc_rpc_ovrtim
○
○
○

スケジュール情報（SCD）
スケジュール待ち
（Schedule Waits）
回数（times）
○
×
1800
rts_scd_scd_wait
○※
○
○

行列長（events）
×
○

スケジュール
（Schedule）
回数（times）
○
×
1801
rts_scd_schedule
○
○
○

メッセージ長（バイト）（bytes）
×
○

メッセージ格納バッファプールの使用中サイズ
（Size of using buffer）
回数（times）
○
×
1802
rts_scd_using_buf
○※
○
○

バッファプールのサイズ（バイト）（bytes）
×
○

メッセージ格納バッファプールの不足でスケジュールできなかったメッセージサイズ
（Message size in case of lack of buffer）
回数（times）
○
×
1803
rts_scd_lack_buf
○
○
○

メッセージ長（バイト）（bytes）
×
○

スケジュール滞留
（Schedule Stay）
回数（times）
○
×
1804
rts_scd_scd_stay
○
○
○

時間（マイクロ秒）（microsec）
×
○

サービス単位のスケジュール待ち
（Schedule Waits of service）
回数（times）
○
×
1805
rts_scd_svc_scd_wait
○
○
○

行列長（events）
×
○

サービス単位のメッセージ格納バッファプールの使用中サイズ
（Size of using buffer of service）
回数（times）
○
×
1806
rts_scd_svc_using_buf
○
○
○

バッファプールのサイズ（バイト）
（bytes）
×
○

同時実行サービス数
（Parallel Service）
回数（times）
○
×
1807
rts_scd_parallel
○
○
○

サービス数
（counts）
×
○

トランザクション情報（TRN）
コミット
（Commits）
件数（events）
○
×
1900
rts_trn_commit
○
○
○

ロールバック
（Rollbacks）
件数（events）
○
×
1901
rts_trn_rollback
○
○
○

コマンドによるコミット
（Commit settlement by command）
件数（events）
○
×
1902
rts_trn_cmt_cmd
×
×
○

コマンドによるロールバック
（Rollback settlement by command）
件数（events）
○
×
1903
rts_trn_rbk_cmd
×
×
○

コマンドによるハザード
（Hazard settlement by command）
件数（events）
○
×
1904
rts_trn_haz_cmd
×
×
○

コマンドによるミックス
（Mixed settlement by command）
件数（events）
○
×
1905
rts_trn_mix_cmd
×
×
○

ブランチ実行時間
（Branch execution time）
回数（times）
○
×
1906
rts_trn_branch
○
○
○

時間（マイクロ秒）（microsec）
×
○

ブランチ同期点処理の実行時間
（Branch synchronous point processing time）
回数（times）
○
×
1907
rts_trn_sync_point
○
○
○

時間（マイクロ秒）（microsec）
×
○

リアルタイム統計情報（RTS）
任意区間の実行
（Arbitrary section）
回数（times）
○
×
1000000​～2147483647​
－
○
○
×

時間（マイクロ秒）（microsec）
×
○

DAM情報（DAM）
read
（Read）
回数（times）
○
×
2000
rts_dam_read
○
○
○

データ長（バイト）（bytes）
×
○

readエラー
（Read errors）
件数（events）
○
×
2001
rts_dam_read_err
○
○
○

write
（Write）
回数（times）
○
×
2002
rts_dam_write
○
○
○

データ長（バイト）（bytes）
×
○

writeエラー
（Write errors）
件数（events）
○
×
2003
rts_dam_write_err
○
○
○

FJ出力回数
（FJ output frequency）
回数（times）
○
×
2004
rts_dam_fj
○
○
○

ジャーナルサイズ（バイト）（bytes）
×
○

同時実行DAMトランザクションブランチ数
（Number of DAM transaction branches）
回数（times）
○
×
2005
rts_dam_trn_branch
○
○
○

トランザクション数（トランザクション）（transaction）
×
○

DAMキャッシュブロックの確保回数
（DAM cache-block securing frequency）
回数（times）
○
×
2006
rts_dam_cache_block
○
○
○

DAMキャッシュ用の共用メモリの使用率
（Common memory for DAM use rate）
回数（times）
○
×
2007
rts_dam_shm_pool
×
×
○

共用メモリプール使用率（％）（%）
×
○

TAM情報（TAM）
TAMファイル実更新
（Table file real renewal）
回数（times）
○
×
2100
rts_tam_real_renew
×
×
○

データのバイト数（バイト）（bytes）
×
○

TAMファイル実更新時間
（Table file real renewal time）
回数（times）
○
×
2101
rts_tam_real_renew_time
×
×
○

時間（マイクロ秒）（microsec）
×
○

コミット，ロールバック（レコード参照）
（Number of tam record references）
回数（times）
○
×
2102
rts_tam_rec_refer
×
○
○

レコード数（レコード）（records）
×
○

コミット，ロールバック（レコード更新）
（Number of tam record renewal）
回数（times）
○
×
2103
rts_tam_rec_renew
×
○
○

レコード数（レコード）（records）
×
○

read
（Read）
回数（times）
○
×
2104
rts_tam_read
○
○
○

データ長（バイト）（bytes）
×
○

readエラー
（Read errors）
件数（events）
○
×
2105
rts_tam_read_err
○
○
○

write
（Write）
回数（times）
○
×
2106
rts_tam_write
○
○
○

データ長（バイト）（bytes）
×
○

writeエラー
（Write errors）
件数（events）
○
×
2107
rts_tam_write_err
○
○
○

XAリソースサービス情報（XAR）
Start()要求
（Start() request）
回数（times）
○
×
2500
rts_xar_start
×
○
○

時間（マイクロ秒）（microsec）
×
○

Start()要求エラー
（Start() request error）
件数（events）
○
×
2501
rts_xar_start_err
×
○
○

Call()要求
（Call() request）
回数（times）
○
×
2502
rts_xar_call
×
○
○

時間（マイクロ秒）（microsec）
×
○

Call()要求エラー
（Call() request error）
件数（events）
○
×
2503
rts_xar_call_err
×
○
○

End()要求
（End() request）
回数（times）
○
×
2504
rts_xar_end
×
○
○

時間（マイクロ秒）（microsec）
×
○

End()要求エラー
（End() request error）
件数（events）
○
×
2505
rts_xar_end_err
×
○
○

Prepare()要求
（Prepare() request）
回数（times）
○
×
2506
rts_xar_prepare
×
○
○

時間（マイクロ秒）（microsec）
×
○

Prepare()要求エラー
（Prepare() request error）
件数（events）
○
×
2507
rts_xar_prepare_err
×
○
○

Commit()要求
（Commit() request）
回数（times）
○
×
2508
rts_xar_commit
×
○
○

時間（マイクロ秒）（microsec）
×
○

Commit()要求エラー
（Commit() request error）
件数（events）
○
×
2509
rts_xar_commit_err
×
○
○

Rollback()要求
（Rollback() request）
回数（times）
○
×
2510
rts_xar_rollback
×
○
○

時間（マイクロ秒）（microsec）
×
○

Rollback()要求エラー
（Rollback() request error）
件数（events）
○
×
2511
rts_xar_rollback_err
×
○
○

Recover()要求
（Recover() request）
回数（times）
○
×
2512
rts_xar_recover
×
○
○

時間（マイクロ秒）（microsec）
×
○

Recover()要求エラー
（Recover() request error）
件数（events）
○
×
2513
rts_xar_recover_err
×
○
○

Forget()要求
（Forget() request）
回数（times）
○
×
2514
rts_xar_forget
×
○
○

時間（マイクロ秒）（microsec）
×
○

Forget()要求エラー
（Forget() request error）
件数（events）
○
×
2515
rts_xar_forget_err
×
○
○

MCF情報（MCF）
スケジュール待ち（Schedule Stay）
回数（times）
○
×
2300
rts_mcf_ap_scd_stay
○
○
○

時間（マイクロ秒）（microsec）
×
○

ユーザサービス実行（Execution of user service）
回数（times）
○
×
2301
rts_mcf_ap_usr_srvc
○
○
○

時間（マイクロ秒）（microsec）
×
○

（凡例）

SVC：サービス単位

SRV：サーバ単位

SYS：システム全体

○：該当します。

×：該当しません。

注※

サービス単位で取得した情報は，回数だけが有効になります。

(2)　リアルタイム統計情報の詳細（取得対象を指定した場合）

取得対象を指定した場合のリアルタイム統計情報の詳細を次の表に示します。

表E-9　リアルタイム統計情報の詳細（取得対象を指定した場合）

リアルタイム統計情報種別
（Type）
編集内容
詳細内容

リアルタイム統計情報の項目名（Event）
取得情報

ネーム情報（NAM）
指定参照先ノードへのサービス検索の送信回数
（Lookup to specified node）
件数
ノードごとにカウントしたサービス情報検索要求の送信回数。
UAPやコマンドでRPCを実行するとき，要求するサービスグループの情報を検索するため，システム共通定義のall_nodeオペランドに指定したノードにサービス情報検索要求を送信することがあります。

指定参照先ノードからのサービス検索の応答受信回数
（Response of Lookup from specified node）
件数
ノードごとにカウントしたサービス情報検索要求の応答を受信した回数。UAPやコマンドでRPCを実行するとき，要求するサービスグループの情報を検索するため，システム共通定義のall_nodeオペランドに指定したノードにサービス情報検索要求を送信することがあります。

MCF情報（MCF）
受信メッセージの処理待ち（Residence time on input message）※1
回数
MHPが入力キューからメッセージを取り出した回数。

時間
MCF通信プロセスが入力キューに登録してからMHPで取り出すまでの処理待ち時間。

同期型送信メッセージの処理待ち（Residence time on output message of synchronous）※1
回数
MCF通信プロセスが同期型送信メッセージを処理した回数。

時間
UAPが同期型送信メッセージを送信要求してから，MCF通信プロセスで処理するまでの処理待ち時間。

問い合わせ応答型送信メッセージの処理待ち（Residence time on output message of response）※1
回数
MCF通信プロセスが問い合わせ応答型送信メッセージを処理した回数。

時間
UAPが問い合わせ応答型送信メッセージを送信要求し，そのトランザクションがコミット決着した時点から，MCF通信プロセスで処理するまでの処理待ち時間。

優先分岐型送信メッセージの処理待ち（Residence time on output message of priority）※1
回数
MCF通信プロセスが優先分岐型送信メッセージを処理した回数。

時間
UAPが優先分岐型送信メッセージを送信要求し，そのトランザクションがコミット決着した時点から，MCF通信プロセスで処理するまでの処理待ち時間。

一般分岐型送信メッセージの処理待ち（Residence time on output message of normal）※1
回数
MCF通信プロセスが一般分岐型送信メッセージを処理した回数。

時間
UAPが一般分岐型送信メッセージを送信要求し，そのトランザクションがコミット決着した時点から，MCF通信プロセスで処理するまでの処理待ち時間。

入力キュー滞留数（Number on input message queue）※2
回数
MCF通信プロセスが入力キューへメッセージを登録，およびMHPが入力キューからメッセージを取り出した回数。

数
入力キューへ滞留しているメッセージの数。この値が大きい場合は，ユーザサービス定義のparallel_countオペランドの指定値を大きくしてください。

注※1

論理端末単位で取得する場合の情報です。

注※2

サービスグループ単位で取得する場合の情報です。

リアルタイム統計情報の取得対象の指定形式を次の表に示します。

表E-10　リアルタイム統計情報の取得対象の指定形式

リアルタイム統計情報種別（Type）
リアルタイム統計情報の項目名（Event）
情報取得対象の指定形式

取得対象名1※1
取得対象名2※2

ネーム情報
（NAM）
指定参照先ノードへのサービス検索の送信回数
（Lookup to specified node）
ポート番号※3
IPアドレス※3

指定参照先ノードからのサービス検索の応答受信回数
（Response of Lookup from specified node）

MCF情報
（MCF）
受信メッセージの処理待ち
（Residence time on input message）
論理端末名
なし

同期型送信メッセージの処理待ち
（Residence time on output message of synchronous）

問い合わせ応答型送信メッセージの処理待ち
（Residence time on output message of response）

優先分岐型送信メッセージの処理待ち
（Residence time on output message of priority）

一般分岐型送信メッセージの処理待ち
（Residence time on output message of normal）

入力キュー滞留数
（Number on input message queue）
なし
サービスグループ名

注※1

統計情報を取得する場合

-uオプションにobjを指定したrtsput定義コマンド，またはrtsstatsコマンドで，-oオプションに指定します。

統計情報を表示，編集する場合

-uオプションにsvcを指定したrtslsコマンド，またはrtseditコマンドで，-sオプションに指定します。

注※2

統計情報を取得する場合

-uオプションにobjを指定したrtsput定義コマンド，またはrtsstatsコマンドで，-bオプションに指定します。

統計情報を表示，編集する場合

-uオプションにsvcを指定したrtslsコマンド，またはrtseditコマンドで，-vオプションに指定します。

注※3

システム共通定義のall_nodeオペランド，またはドメイン定義ファイルに指定したノードのIPアドレスとポート番号を指定してください。

取得対象を指定した場合のリアルタイム統計情報の編集内容を次の表に示します。

表E-11　リアルタイム統計情報の編集内容（取得対象を指定した場合）

リアルタイム統計情報種別（Type）
編集内容
項目ID
（Event id）
オペランド名
取得単位※

リアルタイム統計情報の項目名（Event）
取得情報（Units）
出力単位
SVC
SRV
SYS

累計（Total）
最大（Maximum）
最小（Minimum）
平均（Average）

ネーム情報
（NAM）
指定参照先ノードへのサービス検索の送信回数
（Lookup to specified node）
件数（events）
○
×
1303
rts_nam_node_lookup
×
×
×

指定参照先ノードからのサービス検索の応答受信回数（Response of Lookup from specified node）
件数（events）
○
×
1304
rts_nam_node_lookup_responce
×
×
×

MCF情報（MCF）
受信メッセージの処理待ち（Residence time on input message）
回数（times）
○
×
2350
rts_mcf_in_msg_scd_wait
×
×
×

時間（マイクロ秒）（microsec）
×
○

同期型送信メッセージの処理待ち（Residence time on output message of synchronous）
回数（times）
○
×
2351
rts_mcf_out_msg_sync_scd_wait
×
×
×

時間（マイクロ秒）（microsec）
×
○

問い合わせ応答型送信メッセージの処理待ち（Residence time on output message of response）
回数（times）
○
×
2352
rts_mcf_out_msg_resp_scd_wait
×
×
×

時間（マイクロ秒）（microsec）
×
○

優先分岐型送信メッセージの処理待ち（Residence time on output message of priority）
回数（times）
○
×
2353
rts_mcf_out_msg_prio_scd_wait
×
×
×

時間（マイクロ秒）（microsec）
×
○

一般分岐型送信メッセージの処理待ち（Residence time on output message of normal）
回数（times）
○
×
2354
rts_mcf_out_msg_norm_scd_wait
×
×
×

時間（マイクロ秒）（microsec）
×
○

入力キュー滞留数（Number on input message queue）
回数（times）
○
×
2380
rts_mcf_que_scd_wait_num
×
×
×

数（num）
×
○

（凡例）

SVC：サービス単位

SRV：サーバ単位

SYS：システム全体

○：該当します。

×：該当しません。

注※

任意オブジェクト指定のリアルタイム統計情報の取得単位は，取得対象名1，2に指定した単位になります。

付録F　OpenTP1が出力するファイル一覧

ここでは，OpenTP1が出力するファイルの一覧を，製品別に示します。

＜この節の構成＞

(1)　TP1/Server Base（UNIX版・Windows版共通）

(2)　TP1/Server Base（UNIX版固有）

(3)　TP1/Server Base（Windows版固有）

(4)　TP1/FS/Direct Access

(5)　TP1/FS/Table Access

(6)　TP1/Online Tester

(7)　TP1/Message Control

(1)　TP1/Server Base（UNIX版・Windows版共通）

TP1/Server Base（UNIX版・Windows版共通）が出力するファイルの一覧を次の表に示します。各ファイルの詳細な説明については，表F-2を参照してください。

表F-1　TP1/Server Base（UNIX版・Windows版共通）が出力するファイル一覧

項番
名称
ファイル名または
ディレクトリ名
バージョン
タイプ
ファイル形式
取得
タイミング
削除可否

1
監査ログファイル
（log_audit_pathオペランドの指定値）/audit.log
デフォルト：
$DCDIR/auditlog/audit.log
07-02
D，F，H
テキスト
監査イベントが発生したとき
○

2
監査ログファイルのバックアップファイル
（log_audit_pathオペランドの指定値）/auditNNN.log
（NNN：001～255）
デフォルト：
$DCDIR/auditlog/auditNNN.log
（NNN：001～255）
07-02
K
テキスト
監査ログファイルのサイズがlog_audit_sizeオペランドの指定値を超えたとき
○

3
OpenTP1自動起動判定ファイル
$DCDIR/spool/.automode
初期
J
バイナリ
OpenTP1を開始したとき
×

4
namdオンラインチェックファイル
$DCDIR/spool/.namonl
07-06
J
空ファイル
OpenTP1を起動したとき
×

5
カレントワークパス制御ファイル1
UNIX版：
$DCDIR/spool/.dccurrent_path
Windows版：
$DCDIR¥spool¥dccurrent_path
UNIX版：
06-02
Windows版：
07-00
J
バイナリ
prcdを起動したとき（dcstartコマンドの実行時ではありません）
×

6
prcdポート情報格納ファイル
$DCDIR/spool/.portid
初期
J
バイナリ
prcdを起動したとき（dcstartコマンドの実行時ではありません）
×

7
prcpathコマンドの引き継ぎファイル
$DCDIR/spool/.prcsvpath
03-02
J
バイナリ
prcpathコマンドを実行したとき
×

8
コマンドログ
$DCDIR/spool/cmdlog/cmdlogN
（N：1または2）
UNIX版：
07-00
Windows版：
06-50
C，E，H
テキスト
取得対象のコマンドを実行したとき
△

9
トレース情報ダンプファイル
ロックファイル（内部用ファイル）
$DCDIR/spool/dcdfmtrN，dcdfmtrl
（N：1または2）
07-00
J
バイナリ
dcdefchkコマンドを実行したとき
×

10
FILイベントトレース情報ファイル
$DCDIR/spool/dcfilinf/_fl_NNN
（NNN：001～003）
07-03
D，F，H
バイナリ
prf_traceオペランドにY，かつfil_prf_trace_optionオペランドに1を設定し，fil_prf_trace_delay_timeオペランドの値以上のファイルアクセス処理時間を必要したとき
△

11
jnlchgfgコマンドの退避コアファイル
$DCDIR/spool/dcjnlinf/errinf/chgfg_N
（N：ダウンしたコマンドのPID）
07-03
A
バイナリ
jnlchgfgコマンドが異常終了したとき
△

12
jnlcuefプロセスの退避コアファイル
$DCDIR/spool/dcjnlinf/errinf/cuef_N
（N：ダウンしたプロセスのPID）
07-03
A
バイナリ
内部コマンドのプロセスが異常終了したとき
△

13
ジャーナルファイルの不正ジャーナル情報ファイル
$DCDIR/spool/dcjnlinf/errinf/cuef_N
（N：不正ジャーナルを検知したコマンドプロセスのPID）
07-03
A
バイナリ
jnlunlfgコマンド，jnlchgfgコマンド，またはjnllsコマンドが不正ジャーナルを検知したとき
△

14
jnllsコマンドの退避コアファイル
$DCDIR/spool/dcjnlinf/errinf/ls_N
（N：ダウンしたコマンドのPID）
07-03
A
バイナリ
jnllsコマンドが異常終了したとき
△

15
被アーカイブジャーナルノードの不正ジャーナル情報ファイル
$DCDIR/spool/dcjnlinf/errinf/r_N
（N：不正なデータを検知したジャーナルの世代番号）
初期
J
テキスト
OpenTP1のリランで起動する際に，読み込んだブロックにエラーがあったとき
×

16
jnlunlfgコマンドの退避コアファイル
$DCDIR/spool/dcjnlinf/errinf/unlfg_N
（N：ダウンしたコマンドのPID）
07-03
A
バイナリ
jnlunlfgコマンドが異常終了したとき
△

17
ジャーナルメッセージキュー管理ファイル
$DCDIR/spool/dcjnlinf/jnlqid
初期
J
バイナリ
ジャーナルサービスがメッセージキューを作成したとき
×

18
JNL性能検証用トレース情報ファイル
$DCDIR/spool/dcjnlinf/prfinf/_jl_NNN
（NNN：001～256）
07-03
D，F，H
バイナリ
prf_traceオペランドにYを設定し，jnl_prf_event_trace_levelオペランドに00000001​または00000002​を設定したとき
△

19
デッドロック，タイムアウト情報ファイル
$DCDIR/spool/dclckinf
初期
B
テキスト
TAM，DAMまたはdc_lck_xxx関数を使用している場合に，デッドロックまたは排他待ちタイムアウトが発生したとき
△

20
LCK性能検証用トレース情報ファイル
$DCDIR/spool/dclckinf/prf/_lk_NNN
（NNN：001～256）
07-03
D，F，H
バイナリ
トランザクション処理を実行しているときや排他処理を実行しているとき
△

21
メッセージログ通知機能用ソケットファイル
$DCDIR/spool/dcloginf/.logntf
03-03
J
バイナリ
メッセージログ通知機能を動作したとき
×

22
メッセージログファイル
$DCDIR/spool/dclogN
（N：1または2）
初期
C，E，H
テキスト
OpenTP1を動作したとき
×

23
NAMイベントトレース情報ファイル
$DCDIR/spool/dcnaminf/_nm_NNN
（NNN：001～003）
07-02
D，F，H
バイナリ
prf_traceオペランドにYを設定し，nam_prf_trace_levelオペランドに00000000​以外を設定したとき
△

24
プロセスサービスイベントトレース情報ファイル
$DCDIR/spool/dcprcinf/_pr_NNN
（NNN：001～003）
07-02
D，F，H
バイナリ
prf_traceオペランドにYを設定し，prc_prf_traceオペランドにYを設定したとき
△

25
prfgetコマンドの引き継ぎファイル
06-01より前，
06-50より前（Windows版）：
$DCDIR/spool/dcprfinf/getinf
06-01～07-02：
$DCDIR/spool/dcprfinf/getinf，_trinf
07-02以降：
$DCDIR/spool/dcprfinf/getinf，_trinf，_nminf，_prinf，_xrinf
初期
J
バイナリ
prfgetコマンドを-aオプションなしで実行したとき
×

26
性能検証用トレース情報ファイル
06-01より前，06-50より前（Windows版）：
$DCDIR/spool/dcprfinf/prf00N
（N：1～3）
06-01以降：
$DCDIR/spool/dcprfinf/prf_NNN
（NNN：001～256）
初期
D，F，H
バイナリ
OpenTP1を動作したとき
△

27
rapのロックファイル
$DCDIR/spool/dcrapinf/（rapリスナー名）
初期
J
バイナリ
リモートAPIサービスを開始するとき
×

28
rap不正メッセージファイル
03-05-/T，03-06-/R，05-03-/J以降：
$DCDIR/spool/dcrapinf/（rapリスナー名）.msg
05-04-/G，06-00以降：
$DCDIR/spool/dcrapinf/（rapリスナー名）.msg，（rapクライアントマネジャ名）.msg
上記以外の06-00より前：
$DCDIR/spool/dcrapinf/（サーバ名）_（プロセスID）
初期
J，E
テキスト
リモートAPIサービスで不正メッセージを受信したとき
△

29
RTSログファイル
（rts_log_file_nameオペランドの指定値）N
（N：1～10）
デフォルト：
$DCDIR/spool/dcrtsinf/rtslogN
（N：1～10）
07-00
D，F，H
バイナリ
rts_log_fileオペランドにYを設定し，RTSSUPを起動したとき
△

30
RTSログファイルのバックアップファイル
（rts_log_file_nameオペランドの指定値）N.bk
（N：1～10）
デフォルト：
$DCDIR/spool/dcrtsinf/rtslogN.bk
（N：1～10）
07-02
K
バイナリ
RTSSUPを起動したとき
△

31
サーバリカバリジャーナル
$DCDIR/spool/dcsjl
初期
J
バイナリ
オンライン中の任意のタイミング
×

32
トランザクションリカバリジャーナル
$DCDIR/spool/dctjlinf
初期
J
バイナリ
オンライン中の任意のタイミング
×

33
未決着トランザクション情報ファイル
$DCDIR/spool/dctrninf/（ファイル名）
初期
B
テキスト
OpenTP1をリランで起動するとき
△

34
TRNイベントトレース情報ファイル（prfトレース）
$DCDIR/spool/dctrninf/trace/prf/_tr_NNN
（NNN：001～256）
UNIX版：
06-01
Windows版：
07-00
D，F，H
バイナリ
トランザクション処理を実行しているとき
△

35
TRNイベントトレースファイル
$DCDIR/spool/dctrninf/trace/trnevtrN
（N：1または2）
初期
D，F，H
バイナリ
XA関数でエラーが発生したとき
×

36
複数ファイル管理ファイル（内部用ファイル）
$DCDIR/spool/dcusmctl
初期
J
バイナリ
OpenTP1システムダウン時，およびdcstopコマンドで-fオプションおよび-dオプションを指定して意図的に資料を取得して強制停止し，共用メモリダンプファイルが出力されたとき
×

37
XAR性能検証用トレース情報ファイル
$DCDIR/spool/dcxarinf/_xr_NNN
（NNN：001～256）
07-02
D，F，H
バイナリ
prf_traceオペランドにYを設定し，xar_prf_trace_levelオペランドに00000000​以外を指定してXAリソースサービスを使用するとき
△

38
XARイベントトレース情報ファイル
$DCDIR/spool/dcxarinf/trace/xarevtrN
（N：1または2）
06-00
D，F，H
バイナリ
XAリソースサービスを動作させたとき
△

39
XARイベントトレース情報ファイルのバックアップファイル
$DCDIR/spool/dcxarinf/trace/xarevtrM.bkN
（M：1または2，N：1～3）
06-00
K
バイナリ
XAリソースサービスを動作させたとき
△

40
エラーログ情報
07-05より前：
$DCDIR/spool/errlog/errlogN
（N：1または2）
07-05以降：
$DCDIR/spool/errlog/errlogN
および
$DCDIR/spool/errlog/errlogN.nam
（N：1または2）
初期
C，E，H
テキスト
OpenTP1を動作したとき
×

41
システム内部排他制御用ディレクトリ
$DCDIR/spool/olkfifs
初期
J
テキスト
dcmakeupコマンドを実行したとき，またはOpenTP1を開始したとき
×

42
システム内部同期制御用ディレクトリ
$DCDIR/spool/olkrsfs
初期
J
テキスト
dcmakeupコマンドを実行したとき，またはOpenTP1を開始したとき
×

43
内部制御用資源（FIFOファイル）の制御ファイル
$DCDIR/spool/oslcntl
初期
J
バイナリ
dcmakeupコマンドを実行したとき，またはOpenTP1を開始したとき
×

44
RPCログファイル
$DCDIR/spool/rpclogN
（N：1または2）
初期
C，E，H
テキスト
通信エラー（内部通信含む）が発生したとき
×

45
RPCトレースファイル
（rpc_trace_nameオペランドの指定値）
デフォルト：
$DCDIR/spool/rpctrN
（N：1または2）
初期
C，E，H
バイナリ
dc_rpc_call関数または，dc_rpc_call_to関数を発行したとき
○

46
FILイベントトレース情報ファイルのバックアップファイル
$DCDIR/spool/save/_fl_MMM.bkN
（MMM：001～003，N：1または2）
07-03
K
バイナリ
OpenTP1を停止したとき
△

47
JNL性能検証用トレース情報ファイルのバックアップファイル
$DCDIR/spool/save/_jl_MMM.bkN
（MMM：001～256，N：1または2）
07-03
K
バイナリ
OpenTP1を停止したとき
△

48
LCK性能検証用トレース情報ファイルのバックアップファイル
$DCDIR/spool/save/_lk_MMM.bkN
（MMM：001～256，N：1または2）
07-03
K
バイナリ
OpenTP1を停止したとき
△

49
NAMイベントトレース情報ファイルのバックアップファイル
$DCDIR/spool/save/_nm_MMM.bkN
（MMM：001～003，N：1または2）
07-02
K
バイナリ
OpenTP1を停止したとき
△

50
プロセスサービスイベントトレース情報ファイルのバックアップファイル
$DCDIR/spool/save/_pr_MMM.bkN
（MMM：001～003，N：1または2）
07-02
K
バイナリ
OpenTP1を停止したとき
△

51
TRNイベントトレース情報ファイル（prfトレース）のバックアップファイル
$DCDIR/spool/save/_tr_MMM.bkN
（MMM：001～256，N：1または2）
UNIX版：
06-01
Windows版：
07-00
K
バイナリ
OpenTP1を停止したとき
△

52
XAR性能検証用トレース情報ファイルのバックアップファイル
$DCDIR/spool/save/_xr_MMM.bkN
（MMM：001～256，N：1または2）
07-02
K
バイナリ
OpenTP1を停止したとき
△

53
退避コアファイル
（prc_coresave_pathオペランドの指定値）/（サーバ名）N
（N：1～3）
デフォルト：
$DCDIR/spool/save/（サーバ名）N
（N：1～3）
初期
C，H
バイナリ
プロセスがダウンしたとき※
△

54
OpenTP1デバッグ情報ファイル1
UNIX版：
（prc_coresave_pathオペランドの指定値）/（サーバ名）N.deb
（N：1～3）
デフォルト：
$DCDIR/spool/save/（サーバ名）N.deb
（N：1～3）
Windows版：
（prc_coresave_pathオペランドの指定値）¥（サーバ名）.Ndb
（N：1～3）
デフォルト：
%DCDIR%¥spool¥save¥（サーバ名）.Ndb
（N：1～3）
初期
C，H
テキスト
プロセスがダウンしたとき※
△

55
OpenTP1デバッグ情報ファイル2
UNIX版：
（prc_coresave_pathオペランドの指定値）/_sysosN.deb
（prc_coresave_pathオペランドの指定値）/_systp1N.deb
（N：1～3）
デフォルト：
$DCDIR/spool/save/_sysosN.deb
$DCDIR/spool/save/_sy_systp1N.deb
（N：1～3）
Windows版：
（prc_coresave_pathオペランドの指定値）¥_sysosN.deb
（N：1～3）
（prc_coresave_pathオペランドの指定値）¥_systp1N.deb
（N：1～3）
デフォルト：
%DCDIR%¥spool¥save¥_sysosN.deb
%DCDIR%¥spool¥_systp1N.deb
（N：1～3）
初期
C，H
テキスト
prcdがダウンしたとき（dcstopコマンドに-fオプションおよび-dオプションを指定して実行したときも含みます）
△

56
トレース情報ダンプファイル
ロックファイル（内部用ファイル）
$DCDIR/spool/save/dcmtrdpN，dcmtrdpl
（N：1または2）
初期
C，E，H
バイナリ
OpenTP1を動作したとき
×

57
性能検証用トレース情報ファイルのバックアップファイル
06-01より前：
$DCDIR/spool/save/prf_MMM.bkN
（MMM：001～003，N：1または2）
06-01以降：
$DCDIR/spool/save/prf_MMM.bkN
（MMM：001～256，N：1または2）
07-00
K
バイナリ
OpenTP1を停止したとき
△

58
スケジュールキュー情報ファイル
$DCDIR/spool/scdqidN
（N：1または2）
初期
C，E，H
バイナリ
キュー受信型サーバを起動，終了，閉塞，および閉塞解除したとき
×

59
共用メモリダンプファイル
$DCDIR/spool/（usmdumpコマンド実行時に指定した出力ファイル名）
デフォルト：
$DCDIR/spool/shmdump
DAM，TAM，IST，RTSまたはTP1/Message Queueを使用し，かつ-iオプション指定時のファイル名を次に示します。
shmdump.dam.Z，shmdump.tam.Z，shmdump.ist.Z，shmdump.rts.Z，shmdump.mXX.Z
（XX：00～ff）
初期
L
バイナリ
usmdumpコマンド実行時に引数でファイル名称を省略したとき
○

60
共用メモリダンプファイル
$DCDIR/spool/shmdumpN
（N：1～3）
DAM，TAM，IST，RTSまたはTP1/Message Queueを使用し，かつ-iオプション指定時のファイル名を次に示します。
shmdump.damN.Z，shmdump.tamN.Z，shmdump.istN.Z，shmdump.rtsN.Z，shmdump.mXXN.Z
（N：1～3，XX：00～ff）
初期
E
バイナリ
システムがダウンしたとき，ならびにdcstopコマンドに-fオプションおよび-dオプションを指定して実行したとき
△

61
トランザクション制御用オブジェクト
$DCDIR/spool/trnrmcmd/userobj
初期
J
バイナリ
dcsetupコマンド，trnlnkrmコマンド，またはtrnmkobjコマンドを実行したとき
▲

62
共用メモリ情報ファイル
$DCDIR/tmp/dcommenv
初期
J
バイナリ
OpenTP1を起動したとき
×

63
内部制御用資源（FIFOファイル）
$DCDIR/tmp/olkmsg
初期
J
テキスト
ユーザサービスデフォルト定義またはユーザサービス定義のschedule_methodオペランドにnamedpipeを設定したとき
×

64
jnlcolcコマンドの引き継ぎファイル
（jnlcolcコマンドを実行したカレントパス）/jnlcolcNNN
（NNN：001～999）
初期
J
バイナリ
jnlcolcコマンドに-lオプションを指定しないで実行したとき
○

65
jnlcolcコマンドの引き継ぎファイルのバックアップファイル
（jnlcolcコマンドを実行したカレントパス）/jnlcolcNNN.bak
（NNN：001～999）
初期
J
バイナリ
jnlcolcコマンドに-lオプションを指定しないで実行し，かつ指定した引き継ぎファイルがすでにあるとき
○

66
jnlrputコマンドの引き継ぎファイル
（jnlrputコマンドを実行したカレントパス）/jnlrputNNN
（NNN：001～999）
初期
J
バイナリ
jnlrputコマンドに-eオプションを指定し，かつ-lオプションを指定しないで実行したとき
○

67
jnlrputコマンドの引き継ぎファイルのバックアップファイル
（jnlrputコマンドを実行したカレントパス）/jnlrputNNN.bak
（NNN：001～999）
初期
J
バイナリ
次の条件を満たしたとき
jnlrputコマンドに-eオプションを指定し，かつ-lオプションを指定しないで実行している
指定した引き継ぎファイルがすでにある
○

68
カレントワークパス制御ファイル2
UNIX版：
（カレントワークパス）/.dcdir_path
Windows版：
（カレントワークパス）/dcdir_pat
UNIX版：
06-02
Windows版：
07-00
J
バイナリ
prcdを起動したとき（dcstartコマンドの実行時ではありません）
×

69
dcrasgetコマンド用ワークファイル
（取得先ディレクトリ）/work
UNIX版：
06-01
Windows版：
06-50
J
バイナリ
dcrasgetコマンドを実行したとき
□
（dcrasget）

（凡例）

A：単調増加（削除機能がないタイプ）

B：単調増加（削除機能があるタイプ）

C：ラウンドロビン（バックアップ取得機能がないタイプ）

D：ラウンドロビン（バックアップ取得機能があるタイプ）

E：ラウンドロビン（一定量に達した直後の出力で，新しいファイルに切り替わるタイプ）

F：ラウンドロビン（一定量に達する直前の出力で，新しいファイルに切り替わるタイプ）

H：ラウンドロビン（切り替わった先のファイルのデータを，削除してから先頭から書き込むタイプ）

Ｊ：制御ファイル，一時ファイル

K：バックアップファイル

L：コマンド実行などで1回ごとに出力し，最大容量が決まっているファイル

○：ユーザ判断で削除できます。

△：削除してはいけません。ただし，障害調査が不要であれば，ユーザ判断で削除できます。

▲：削除してはいけません。ただし，ユーザが作成したファイルであれば，ユーザ判断で削除できます。

□：コマンド終了時に削除します。（　）内は該当するコマンド名です。

×：削除してはいけません。

注※

次の条件でコマンドを実行した場合のプロセスダウンも含みます。

・dcstopコマンドに-fオプションおよび-dオプションを指定

・dcsvstopコマンドに-fオプションおよび-dオプションを指定

TP1/Server Base（UNIX版・Windows版共通）が出力するファイルの説明を次の表に示します。

表F-2　TP1/Server Base（UNIX版・Windows版共通）が出力するファイルの説明

項番
名称
関連する定義
サイズ
最大ファイル数
説明

1
監査ログファイル
＜ログサービス定義＞

log_audit_outオペランド
監査ログ機能を使用するかどうかを指定

log_audit_pathオペランド
監査ログファイルの出力先ディレクトリ

log_audit_sizeオペランド
監査ログファイルの最大サイズ

log_audit_countオペランド
監査ログファイルの最大数

log_audit_messageオペランド
監査ログを取得する項目のメッセージID

＜ユーザサービス定義＞
＜ユーザサービスデフォルト定義＞

log_audit_out_suppressオペランド
このユーザサーバから出力される監査ログを抑止する場合に指定

log_audit_messageオペランド
監査ログを取得する項目のメッセージID

＜rap リスナーサービス定義＞

log_audit_out_suppressオペランド
rapリスナーおよびrapサーバから出力される監査ログを抑止する場合に指定

log_audit_messageオペランド
監査ログを取得する項目のメッセージID

＜rap クライアントマネジャサービス定義＞

log_audit_out_suppressオペランド
rapクライアントマネジャから出力される監査ログを抑止する場合に指定

log_audit_messageオペランド
監査ログを取得する項目のメッセージID

log_audit_sizeオペランドの指定値
1世代
監査ログファイルです。log_audit_outオペランドにYを設定した場合に取得します。
監査ログの取得対象となるイベントの詳細については，マニュアル「OpenTP1 システム定義」の監査イベントを取得する定義についての説明を参照してください。

2
監査ログファイルのバックアップファイル
監査ログファイル（項番1）と同様
log_audit_sizeオペランドの指定値
最大でlog_audit_countオペランドの指定値－1世代
監査ログファイルのバックアップファイルです。

3
OpenTP1自動起動判定ファイル
なし
数バイト（固定）
1ファイル
OpenTP1の動作を制御するファイルです。

4
namdオンラインチェックファイル
＜ネームサービス定義＞

namnlfil定義コマンド
ノードリストファイルの指定

0
1ファイル
OpenTP1の動作を制御するファイルです。ノードリスト引き継ぎ機能を使用する場合に作成する内部ファイルです。

5
カレントワークパス制御ファイル1
なし
数バイト（可変）
1ファイル
OpenTP1の動作を制御するファイルです。

6
prcdポート情報格納ファイル
なし
数バイト（固定）
1ファイル
OpenTP1の動作を制御するファイルです。

7
prcpathコマンドの引き継ぎファイル
＜プロセスサービス定義＞

prc_take_over_svpathオペランド
リラン時にprcpathコマンドでのサーチパスの変更を引き継ぐかどうかを指定

268バイト
1ファイル
OpenTP1の動作を制御するファイルです。prcpathコマンド実行時に，引数に指定したサーチパスを保存するファイルです。

8
コマンドログ
なし
1024キロバイト
2世代
コマンド実行時に取得する，コマンド履歴の情報を出力するファイルです。コマンドログを出力する運用コマンドについては，「12.1.4　運用コマンドの一覧」を参照してください。
なお，MCFのコマンドは，デフォルトでは取得しません。環境変数DCMCFCMDLOGにYを指定して取得します。

9

トレース情報ダンプファイル

ロックファイル（内部用ファイル）

なし
64キロバイト（ダンプファイル），272バイト（ロックファイル）
3ファイル（ダンプファイル：2世代，ロックファイル：1ファイル）
OpenTP1の動作を制御するファイルです。dcdefchkコマンド実行時のモジュールトレースを格納するファイルおよびロックファイルです。

10
FILイベントトレース情報ファイル
＜システム共通定義＞

prf_traceオペランド
性能検証用トレース情報を取得するかどうかを指定

fil_prf_trace_optionオペランド
FILイベントトレースを取得するかどうかを指定

fil_prf_trace_delay_timeオペランド
FILイベントトレース取得条件となるファイルアクセス処理時間のしきい値

＜性能検証用トレース定義＞

prf_trace_backupオペランド
トレースファイルのバックアップ取得

最大1メガバイト
3世代
FILイベントトレース情報ファイルです。prf_traceオペランドにY，fil_prf_trace_optionオペランドに1を設定した場合に，FILイベントトレース情報を取得します。
prf_trace_backupオペランドにNを設定した場合は，バックアップファイルを取得しません。

11
jnlchgfgコマンドの退避コアファイル
なし
プロセスのメモリ使用量※1
単調増加
jnlchgfgコマンドの退避コアファイルです。jnlchgfgコマンドが異常終了した場合に取得します。

12
jnlcuefプロセスの退避コアファイル
なし
プロセスのメモリ使用量※1
単調増加
jnlcuefプロセスの退避コアファイルです。jnlcuefプロセスが異常終了した場合に取得します。

13
ジャーナルファイルの不正ジャーナル情報ファイル
＜システムジャーナルサービス定義＞

jnl_max_datasizeオペランド
最大レコードデータ長

jnl_max_datasizeオペランドの指定値
単調増加
ジャーナルファイルの不正ジャーナル情報ファイルです。jnllsコマンドが不正ジャーナルを検知した場合に取得します。

14
jnllsコマンドの退避コアファイル
なし
プロセスのメモリ使用量※1
単調増加
jnllsコマンドの退避コアファイルです。jnllsコマンドが異常終了した場合に取得します。

15
被アーカイブジャーナルノードの不正ジャーナル情報ファイル
＜システムジャーナルサービス定義＞

jnl_max_datasizeオペランド
最大レコードデータ長

jnl_dualオペランド
ジャーナルファイルを二重化するかどうかを指定

jnl_max_datasizeオペランドの指定値
1ファイル
被アーカイブジャーナルノードの不正ジャーナル情報ファイルです。OpenTP1のリランで起動する際に読み込んだブロックにエラーがあった場合（異常時）に取得します。※2

16
jnlunlfgコマンドの退避コアファイル
なし
プロセスのメモリ使用量※1
単調増加
jnlunlfgコマンドの退避コアファイルです。jnlunlfgコマンドが異常終了した場合に取得します。

17
ジャーナルメッセージキュー管理ファイル
＜システムジャーナルサービス定義＞

jnl_dualオペランド
ジャーナルファイルを二重化するかどうかを指定

jnl_max_file_dispersionオペランド
並列アクセス化する場合の最大分散数

＜アーカイブジャーナルサービス定義＞

jnl_dualオペランド
ジャーナルファイルを二重化するかどうかを指定

jnl_max_file_dispersionオペランド
並列アクセス化する場合の最大分散数

被アーカイブジャーナルノードの場合
16バイト×(jnl_max_file_dispersionオペランドの指定値×n＋1)
（n：jnl_dual=Yの場合は2，Nの場合は1）

アーカイブジャーナルノードの場合
16バイト×(jnl_max_file_dispersionオペランドの指定値×n×r＋1)
（n：jnl_dual=Yの場合は2，Nの場合は1）
（r：グローバルアーカイブジャーナルサービス定義のjnldfsv定義コマンドの-aで指定したリソースグループ数）

1ファイル
OpenTP1の動作を制御するファイルです。

18
JNL性能検証用トレース情報ファイル
＜システム共通定義＞

prf_traceオペランド
性能検証用トレース情報を取得するかどうかを指定

jnl_prf_event_trace_levelオペランド
JNL性能検証用トレースを取得するかどうかを指定

＜JNL性能検証用トレース定義＞

prf_file_sizeオペランド
トレースファイルのサイズ

prf_file_countオペランド
トレースファイルの世代数

prf_trace_backupオペランド
トレースファイルのバックアップ取得

prf_file_sizeオペランドの指定値
prf_file_countオペランドの指定値
JNL性能検証用トレース情報ファイル。prf_traceオペランドにY，jnl_prf_event_trace_levelオペランドに00000001​または00000002​を設定した場合に，JNL性能検証用トレース情報を取得します。
07-03以降の場合は，prf_trace_backupオペランドにNを設定すると，バックアップファイルを取得しません。

19
デッドロック，タイムアウト情報ファイル
＜ロックサービス定義＞

lck_deadlock_infoオペランド
デッドロック情報とタイムアウト情報を出力するかどうかを指定

lck_deadlock_info_removeオペランド
システム開始時にデッドロック情報ファイルとタイムアウト情報ファイルを削除するかどうかを指定

lck_deadlock_info_remove_levelオペランド
デッドロック情報ファイルとタイムアウト情報ファイルの削除レベル

数キロバイト（可変）
可変
デッドロック，タイムアウト情報ファイルです。lck_deadlock_infoオペランドにYを指定した場合に，デッドロック情報，排他待ちタイムアウト情報を取得します。lck_deadlock_info_removeオペランド，lck_deadlock_info_remove_levelオペランドを設定することで，OpenTP1起動時にファイルを削除します。デフォルトでは削除しません。

20
LCK性能検証用トレース情報ファイル
＜システム共通定義＞

prf_traceオペランド
性能検証用トレース情報を取得するかどうかを指定

＜ロックサービス定義＞

lck_prf_trace_levelオペランド
LCK性能検証用トレース情報の取得レベル

＜性能検証用トレース定義＞

prf_trace_backupオペランド
トレースファイルのバックアップ取得

＜LCK性能検証用トレース定義＞

prf_file_sizeオペランド
LCK性能検証用トレース情報ファイルのサイズ

prf_information_levelオペランド
LCK性能検証用トレース関連のメッセージの表示レベルを指定

prf_file_countオペランド
LCK性能検証用トレース情報ファイルの世代数

prf_file_sizeオペランドの指定値
prf_file_countオペランドの指定値
LCK性能検証用トレース情報ファイルです。prf_traceオペランドにYを設定した場合に，トランザクション処理に伴う各種排他制御のトレース情報を取得します。デフォルトで取得します。
07-03以降の場合は，prf_trace_backupオペランドにNを設定すると，バックアップファイルを取得しません。

21
メッセージログ通知機能用ソケットファイル
＜ログサービス定義＞

log_notify_outオペランド
メッセージログ通知機能を使用するかどうかを指定

log_notify_xxxオペランド
log_notify_xxxに対応した情報を付加するかどうかを指定

0
1ファイル
メッセージログ通知機能で使用するソケットファイルです。

22
メッセージログファイル
＜ログサービス定義＞

log_filesizeオペランド
メッセージログファイルの最大サイズ

log_filesizeオペランドの指定値
2世代
OpenTP1のメッセージログファイルです。

23
NAMイベントトレース情報ファイル
＜システム共通定義＞

prf_traceオペランド
性能検証用トレース情報を取得するかどうかを指定

nam_prf_trace_levelオペランド
NAMイベントトレース情報の取得レベル

＜性能検証用トレース定義＞

prf_trace_backupオペランド
トレースファイルのバックアップ取得

最大10メガバイト
3世代
NAMイベントトレース情報ファイルです。prf_traceオペランドにY，nam_prf_trace_levelオペランドに00000000​以外を設定した場合に，NAMイベントトレース情報を取得します。
07-02以降の場合は，prf_trace_backupオペランドにNを設定すると，バックアップファイルを取得しません。

24
プロセスサービスイベントトレース情報ファイル
＜システム共通定義＞

prf_traceオペランド
性能検証用トレース情報を取得するかどうかを指定

＜性能検証用トレース定義＞

prf_trace_backupオペランド
トレースファイルのバックアップ取得

＜プロセスサービス定義＞

prc_prf_traceオペランド
プロセスサービスのイベントトレースを取得するかどうかを指定

最大1メガバイト
3世代
プロセスサービスイベントトレース情報ファイル。prf_traceオペランドにY，prc_prf_traceオペランドにYを設定した場合に，プロセスサービスイベントトレース情報を取得します。
07-02以降の場合は，prf_trace_backupオペランドにNを設定すると，バックアップファイルを取得しません。

25
prfgetコマンドの引き継ぎファイル
なし
128バイト
06-01より前：
1ファイル
06-01～07-02より前：
2ファイル
07-02以降：
5ファイル
OpenTP1の動作を制御するファイルです。prfgetコマンド実行時に，取得済みトレースデータの位置を記録するための内部ファイルです。

26
性能検証用トレース情報ファイル
＜システム共通定義＞

prf_traceオペランド
性能検証用トレース情報を取得するかどうかを指定

＜性能検証用トレース定義＞

prf_file_sizeオペランド
トレースファイルのサイズ

prf_information_levelオペランド
トレースファイル関連のメッセージの出力レベル

prf_file_countオペランド
トレースファイルの世代数

prf_trace_backupオペランド
トレースファイルのバックアップ取得

prf_file_sizeオペランドの指定値
06-01より前：
3世代
06-01以降：
prf_file_countオペランドの指定値
性能検証用トレース情報ファイルです。prf_traceオペランドにYを設定した場合に，性能検証用トレース情報を取得します。デフォルトは取得します。
07-02以降の場合は，prf_trace_backupオペランドにNを設定すると，バックアップファイルを取得しません。

27
rapのロックファイル
なし
16バイト×(1＋rapサーバ数)
rapリスナー数
OpenTP1の動作を制御するファイルです。rapリスナー，rapサーバ間で同期を取るためのロック用ファイルです。

28
rap不正メッセージファイル
なし
03-05-/T，03-06-/R，05-03-/J，05-04-/G，06-00以降：
最大1メガバイト
上記以外の06-00より前：
単調増加
バージョンによって異なります。※3
リモートAPIサービスで不正メッセージを受信したときに作成するトラブルシュート用ファイルです。

29
RTSログファイル
＜リアルタイム統計情報サービス定義＞

rts_log_fileオペランド
取得した統計情報をRTSログファイルに出力するかどうかを指定

rts_log_file_nameオペランド
RTSログファイル名

rts_log_file_sizeオペランド
RTSログファイルのサイズ

rts_log_file_countオペランド
RTSログファイルの世代数

rts_log_file_backupオペランド
RTSログファイルのバックアップファイルを作成するかどうかを指定

最大でrts_log_file_sizeオペランドの指定値
rts_log_file_countオペランドの指定値
リアルタイム統計情報ログファイルです。rts_log_fileオペランドにYを設定した場合に，リアルタイム統計情報を取得します。
07-02以降の場合は，rts_log_file_backupオペランドにYを設定すると，RTSSUPの起動時にバックアップファイルを取得します。

30
RTSログファイルのバックアップファイル
リアルタイム統計情報（RTS）ログファイル（項番29）と同様
最大でrts_log_file_sizeオペランドの指定値
rts_log_file_countオペランドの指定値×1世代
リアルタイム統計情報ログファイルのバックアップファイルです。rts_log_file_backupオペランドにNを設定した場合は，バックアップファイルを取得しません。

31
サーバリカバリジャーナル
なし
数バイト～数キロバイト（可変）
可変
各種のジャーナル情報を，システムサービスごとに取得するファイルです。

32
トランザクションリカバリジャーナル
なし
数バイト～数キロバイト（可変）
可変
トランザクションに関する各種のジャーナル情報を，トランザクションブランチ（UAPプロセス）ごとに取得するファイルです。

33
未決着トランザクション情報ファイル
＜トランザクションサービス定義＞

trn_tran_recovery_listオペランド
全面回復時，未決着トランザクション情報を取得するかどうかを指定

trn_recovery_list_removeオペランド
OpenTP1開始時，未決着トランザクション情報ファイルを削除するかどうかを指定

trn_recovery_list_remove_levelオペランド
未決着トランザクション情報ファイルの削除レベル

数キロバイト（単調増加）
可変
未決着トランザクション情報ファイルです。trn_tran_recovery_listオペランドにYを指定した場合に，未決着トランザクション情報を取得します。trn_recovery_list_removeオペランド，trn_recovery_list_remove_levelオペランドを設定することで，OpenTP1起動時にファイルを削除します。デフォルトでは削除しません。

34
TRNイベントトレース情報ファイル（prfトレース）
＜システム共通定義＞

prf_traceオペランド
性能検証用トレース情報を取得するかどうかを指定

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

trn_prf_event_trace_levelオペランド
TRNイベントトレースの取得レベル

trn_prf_event_trace_conditionオペランド
取得するTRNイベントトレースの種類

＜性能検証用トレース定義＞

prf_trace_backupオペランド
トレースファイルのバックアップ取得

＜TRNイベントトレース定義＞

prf_file_sizeオペランド
TRNイベントトレース情報のトレースファイルのサイズ

prf_information_levelオペランド
TRNイベントトレース関連のメッセージの表示レベルを指定

prf_file_countオペランド
TRNイベントトレース情報のトレースファイルの世代数

prf_file_sizeオペランドの指定値
prf_file_countオペランドの指定値
TRNイベントトレース情報ファイルです。prf_traceオペランドにYを設定した場合に，TRNイベントトレース情報（トランザクションブランチで発行されるXA関数やトランザクションサービスの各種イベント）を取得します。デフォルトで取得します。
07-02以降の場合は，prf_trace_backupオペランドにNを設定すると，バックアップファイルを取得しません。

35
TRNイベントトレースファイル
なし
1024キロバイト
2世代
TRNイベントトレースファイルです。トランザクション処理に関するトレース情報を取得します。内容は非公開です。

36
複数ファイル管理ファイル（内部用ファイル）
なし
16バイト
1ファイル
OpenTP1の動作を制御するファイルです。共用メモリダンプファイルのカレントの世代を記録するための世代管理ファイルです。

37
XAR性能検証用トレース情報ファイル
＜システム共通定義＞

prf_traceオペランド
性能検証用トレース情報を取得するかどうかを指定

＜性能検証用トレース定義＞

prf_trace_backupオペランド
トレースファイルのバックアップ取得

＜XAリソースサービス定義＞

xar_prf_trace_levelオペランド
XAR性能検証用トレース情報の取得レベル

＜XAR性能検証用トレース定義＞

prf_file_sizeオペランド
XAR性能検証用トレース情報ファイルのサイズ

prf_information_levelオペランド
XAR性能検証用トレース関連のメッセージの表示レベルを指定

prf_file_countオペランド
XAR性能検証用トレース情報ファイルの世代数

prf_file_sizeオペランドの指定値
prf_file_countオペランドの指定値
XAR性能検証用トレース情報ファイルです。prf_traceオペランドにY，xar_prf_trace_levelオペランドに00000000​以外を設定した場合に，XAR性能検証用トレース情報を取得します。prf_trace_backupオペランドにNを設定した場合は，バックアップファイルを取得しません。

38
XARイベントトレース情報ファイル
＜トランザクションサービス定義＞

trn_xar_useオペランド
XAリソースサービスを使用するかどうかを指定

＜XAリソースサービス定義＞

xar_eventtrace_levelオペランド
XARイベントトレース情報の出力レベル

xar_eventtrace_recordオペランド
XARイベントトレース情報ファイルの最大出力レコード数

xar_eventtrace_recordオペランドの指定値×224＋8
2世代
XARイベントトレース情報ファイルです。trn_xar_useオペランドにYを設定した場合に，XARイベントトレース情報を取得します。

39
XARイベントトレース情報ファイルのバックアップファイル
XARイベントトレース情報ファイル（項番38）と同様
xar_eventtrace_recordオペランドの指定値×224＋8
2×3世代
XARイベントトレース情報ファイルのバックアップファイルです。

40
エラーログ情報
なし
06-01より前：
64キロバイト
06-01以降から07-05より前：
1メガバイト
07-05以降：
・ファイル名が$DCDIR/spool/errlog/errlogNの場合
1メガバイト
・ファイル名が$DCDIR/spool/errlog/errlogN.namの場合
10メガバイト
（N：1または2）
2世代
OpenTP1の内部トレース情報です。内容については非公開です。

41
システム内部排他制御用ディレクトリ
＜プロセスサービス定義＞

prc_process_countオペランド
最大同時起動サーバプロセス数

0
prc_process_countオペランドの指定値×2
OpenTP1の動作を制御するファイルです。

42
システム内部同期制御用ディレクトリ
＜プロセスサービス定義＞

prc_process_countオペランド
最大同時起動サーバプロセス数

0
prc_process_countオペランドの指定値＋83
OpenTP1の動作を制御するファイルです。

43
内部制御用資源（FIFOファイル）の制御ファイル
なし
32バイト（32ビット，64ビット）
1ファイル
OpenTP1の動作を制御するファイルです。

44
RPCログファイル
なし
1メガバイト
2世代
設計調査用通信トレース情報です。

45
RPCトレースファイル
＜システム共通定義＞

rpc_traceオペランド
RPCトレースを取得するかどうかを指定

rpc_trace_nameオペランド
RPCトレースを取得するファイル名

rpc_trace_sizeオペランド
RPCトレースを取得するファイルのサイズ

最大でrpc_trace_sizeオペランドの指定値
2世代
RPCトレースファイルです。rpc_traceオペランドにYを設定した場合に，RPCのサービス要求情報（dc_rpc_call関数または，dc_rpc_call_to関数発行時の送受信メッセージの内容およびイベント情報）を取得します。

46
FILイベントトレース情報ファイルのバックアップファイル
FILイベントトレース情報ファイル（項番10）と同様
最大1メガバイト
3×2世代
FILイベントトレースファイルのバックアップファイルです。prf_traceオペランドにY，fil_prf_trace_optionオペランドに1を設定した場合に取得します。
prf_trace_backupオペランドにNを設定した場合は，バックアップファイルを取得しません。

47
JNL性能検証用トレース情報ファイルのバックアップファイル
JNL性能検証用トレース情報ファイル（項番18）と同様
prf_file_sizeオペランドの指定値
prf_file_countオペランドの指定値×2世代
JNL性能検証用トレース情報ファイルのバックアップファイルです。prf_traceオペランドにY，jnl_prf_event_trace_levelオペランドに00000001​または00000002​を設定した場合に取得します。
07-03以降の場合は，prf_trace_backupオペランドにNを設定した場合は，バックアップファイルを取得しません。

48
LCK性能検証用トレース情報ファイルのバックアップファイル
LCK性能検証用トレース情報ファイル（項番20）と同様
prf_file_sizeオペランドの指定値
prf_file_countオペランドの指定値×2世代
LCK性能検証用トレース情報ファイルのバックアップファイルです。prf_traceオペランドにYを設定した場合に取得します。
07-03以降の場合は，prf_trace_backupオペランドにNを設定すると，バックアップファイルを取得しません。

49
NAMイベントトレース情報ファイルのバックアップファイル
NAMイベントトレース情報ファイル（項番23）と同様
最大10メガバイト
3×2世代
NAMイベントトレースファイルのバックアップファイルです。prf_traceオペランドにY，nam_prf_trace_levelオペランドに00000000​以外を設定した場合に取得します。
07-02以降の場合は，
prf_trace_backupオペランドにNを設定すると，バックアップファイルを取得しません。

50
プロセスサービスイベントトレース情報ファイルのバックアップファイル
プロセスサービスイベントトレース情報ファイル（項番24）と同様
最大1メガバイト
3×2世代
プロセスサービスイベントトレースファイルのバックアップファイルです。prf_traceオペランドにY，prc_prf_traceオペランドにYを設定した場合に取得します。
07-02以降の場合は，prf_trace_backupオペランドにNを設定すると，バックアップファイルを取得しません。

51
TRNイベントトレース情報ファイル（prfトレース）のバックアップファイル
TRNイベントトレース情報ファイル（prfトレース）（項番34）と同様
prf_file_sizeオペランドの指定値
prf_file_countオペランドの指定値×2世代
TRNイベントトレースファイルのバックアップファイルです。prf_traceオペランドにYを設定した場合に取得します。
07-02以降の場合は，prf_trace_backupオペランドにNを設定すると，バックアップファイルを取得しません。

52
XAR性能検証用トレース情報ファイルのバックアップファイル
XAR性能検証用トレース情報ファイル（項番37）と同様
prf_file_sizeオペランドの指定値
prf_file_countオペランドの指定値×2世代
XAR性能検証用トレース情報ファイルのバックアップファイルです。prf_traceオペランドにYを設定した場合に取得します。prf_trace_backupオペランドにNを設定した場合は，バックアップファイルを取得しません。

53
退避コアファイル
＜プロセスサービス定義＞

prc_coresave_pathオペランド
コアファイル格納パス

prc_corecompressオペランド
コアファイルの格納時にOpenTP1で自動的に圧縮

＜ユーザサービス定義＞
＜ユーザサービスデフォルト定義＞

core_shm_suppressオペランド
コアファイルへの共用メモリダンプの出力を抑止するかどうかを指定

＜環境変数＞

CORE_NOSHM
共用メモリのコアファイル出力抑止（AIX版）
共用メモリのコアファイル出力抑止の詳細については，「リリースノート」を参照してください。

プロセスのメモリ使用量※1
3世代
ダウンしたシステムサーバ，ユーザサーバの退避コアファイルです。なお，dcsvstopコマンドの-fオプションおよび-dオプションまたはprckillコマンドを実行して終了したユーザサーバ，または実時間監視タイムアウトで終了したユーザサーバのコアファイルの場合は世代管理されません。

54
OpenTP1デバッグ情報ファイル1
＜プロセスサービス定義＞

prc_coresave_pathオペランド
コアファイル格納パス

可変
3世代
ダウンしたシステムサーバ，ユーザサーバのデバッグ情報ファイルです。

55
OpenTP1デバッグ情報ファイル2
＜プロセスサービス定義＞

prc_coresave_pathオペランド
コアファイル格納パス

可変
3世代
ダウンしたprcdのデバッグ情報ファイルです。

56
トレース情報ダンプファイル
なし
64キロバイト（モジュールトレース），272バイト（トレース制御用ファイル）
3ファイル（モジュールトレース：2世代，トレース制御用ファイル：1ファイル）
内部調査用のトレース情報ダンプファイルです。

57
性能検証用トレース情報ファイルのバックアップファイル
性能検証用トレース情報ファイル（項番26）と同様
prf_file_sizeオペランドの指定値
06-01より前：
3×2世代
06-01以降：
prf_file_countオペランドの指定値×2世代
性能検証用トレース情報ファイルのバックアップファイルです。prf_traceオペランドにYを設定した場合に取得します。
07-02以降の場合は，prf_trace_backupオペランドにNを設定すると，バックアップファイルを取得しません。バックアップの抑止対象は次のファイルです。

性能検証用トレース情報ファイル

TRNイベントトレースファイル

NAMイベントトレースファイル

XAR性能検証用トレース情報ファイル

プロセスサービスイベントトレース

58
スケジュールキュー情報ファイル
＜スケジュールサービス定義＞

scd_server_countオペランド
最大ユーザサーバ数

(scd_server_countオペランド＋4)×16＋32（バイト，最大）
2世代
OpenTP1の動作を制御するファイルです。

59
共用メモリダンプファイル
なし
マシン状況やOpenTP1システム稼働状況によって可変
1世代※4
OpenTP1が確保した共用メモリのダンプ情報です。

60
共用メモリダンプファイル
なし
マシン状況やOpenTP1システム稼働状況によって可変
3世代※4
OpenTP1が確保した共用メモリのダンプ情報です。

61
トランザクション制御用オブジェクト
なし
数キロバイト～数十キロバイト（可変）
1ファイル以上
OpenTP1の動作を制御するファイルです。trnlnkrmコマンドの延長で作成するオブジェクト（dc_trn_allrm.o）ファイル，またはtrnmkobjコマンドの延長でユーザが作成するオブジェクトファイルです。
ユーザ任意のファイルが作成されるのは，trnmkobjコマンドを実行した場合だけです。

62
共用メモリ情報ファイル
なし
544バイト（32ビット，64ビット）
1ファイル
OpenTP1の動作を制御するファイルです。

63
内部制御用資源（FIFOファイル）
＜スケジュールサービス定義＞

scd_server_countオペランド
最大ユーザサーバ数

0
scd_server_countオペランドの指定値
OpenTP1の動作を制御するファイルです。

64
jnlcolcコマンドの引き継ぎファイル
なし
抽出する回復ジャーナルのサイズに依存
1ファイル
OpenTP1の動作を制御するファイルです。jnlcolcコマンドで複数ジャーナルの回復ジャーナルを抽出する場合に作成する引き継ぎファイルです。

65
jnlcolcコマンドの引き継ぎファイルのバックアップファイル
なし
名称変更前の引き継ぎファイルのサイズ
1ファイル
OpenTP1の動作を制御するファイルです。jnlcolcコマンド実行時，指定した引き継ぎファイルがすでにある場合に既存のファイルを「jnlcolc***.bak」に名称変更して作成するファイルです。

66
jnlrputコマンドの引き継ぎファイル
なし
トランザクション未決着UJのサイズに依存
1ファイル
OpenTP1の動作を制御するファイルです。jnlrputコマンドで複数ジャーナルのトランザクション決着UJを抽出する場合に作成する引き継ぎファイルです。

67
jnlrputコマンドの引き継ぎファイルのバックアップファイル
なし
名称変更前の引き継ぎファイルのサイズ
1ファイル
OpenTP1の動作を制御するファイルです。jnlrput実行時，指定した引き継ぎファイルがすでにある場合に既存のファイルを「jnlrput***.bak」に名称変更して作成するファイルです。

68
カレントワークパス制御ファイル2
なし
DCDIRに依存
1ファイル
OpenTP1の動作を制御するファイルです。

69
dcrasgetコマンド用ワークファイル
なし
収集する情報に依存
収集する情報に依存
OpenTP1の動作を制御するファイルです。

注※1

メモリ使用量はコーディング次第であるため可変です。HP-UX版，およびWindows版以外は共用メモリダンプが付与されるため，さらに容量が大きくなります。

注※2

終端ブロックがない場合にも取得します。そのため，OpenTP1強制停止など終端ブロックを書き込む契機が発生しなかった場合は，ブロックエラーの有無に関係なく出力します。

注※3

製品バージョンごとに，次のように異なります。

03-05-/T，03-06-/R，05-03-/J，05-04-/G，06-00以降：

リモートAPIサービスで不正メッセージを受信したプロセス数（ただし，rapサーバはrapリスナーと同じファイルに出力します）。

上記以外の06-00より前：

リモートAPIサービスで不正メッセージを受信したプロセス数。

注※4

圧縮後に圧縮元ファイルを消去しますが，圧縮直後は圧縮元ファイルと圧縮ファイルの二つが存在します。このため，最大圧縮元ファイルの2倍のディスク容量を必要とします。

(2)　TP1/Server Base（UNIX版固有）

TP1/Server Base（UNIX版固有）が出力するファイルの一覧を次の表に示します。各ファイルの詳細な説明については，表F-4を参照してください。

表F-3　TP1/Server Base（UNIX版固有）が出力するファイル一覧

項番
名称
ファイル名または
ディレクトリ名
バージョン
タイプ
ファイル形式
取得
タイミング
削除可否

1
通信制御ファイル
$DCDIR/.tact/*
初期
J
ローカルソケット
プロセスを起動したとき
×

2
inittabのバックアップファイル
$DCDIR/conf/Inittab/inittabN
（N：1～3）
初期
K
テキスト
dcsetupコマンドを実行したとき※1
○

3
dccspool用制御ファイル
$DCDIR/spool/.dccspool_time
06-02
J
空
dccspoolコマンドを実行したとき
□
（dccspool）

4
prctee用パイプファイル
$DCDIR/spool/.prc_fifo
05-00
J
バイナリ
prcteeプロセスを起動したとき
×

5
prcteeプロセスのpid格納ファイル
$DCDIR/spool/.prc_tee
初期
J
バイナリ
prcteeプロセスを起動したとき
×

6
prcdlpathコマンドの引き継ぎファイル
$DCDIR/spool/.prcdlpath
07-04
J
バイナリ
prcdlpathコマンドを実行したとき
×

7
prcteeプロセス起動エラー時の出力ファイル
$DCDIR/spool/.prcerr.log
07-00
A
テキスト
prcteeプロセスの起動に失敗したとき
△

8
prcdのPAUSE判定ファイル
$DCDIR/spool/.prcnopause
初期
J
バイナリ
OpenTP1を開始したとき
×

9
Linux用prcdのpid格納ファイル
$DCDIR/spool/.prcpid
06-00
J
バイナリ
prcdを起動したとき（dcstartコマンドの実行時ではありません）
×

10
prcteeプロセスのエラー出力ファイル
$DCDIR/spool/.prctee.log
07-00
A
テキスト
betarn.logへの出力エラーが発生したとき
△

11
被アーカイブジャーナルノード接続情報ファイル
$DCDIR/spool/dcjnlinf/coninf
初期
J
テキスト
アーカイブジャーナルノードと接続，または切断したとき
△

12
アーカイブジャーナルノード接続情報ファイル
$DCDIR/spool/dcjnlinf/coninf
初期
J
テキスト
被アーカイブジャーナルノードと接続，または切断したとき
△

13
アーカイブジャーナルノードの不正ジャーナル情報ファイル
$DCDIR/spool/dcjnlinf/errinf/an_X
（n：不正なデータを検知したジャーナルのリソースグループの通番。この通番はグローバルアーカイブジャーナルサービス定義のjnldfsv定義コマンドの-aオプションに指定したリソースグループに，順に割り当てられる値です。
X：不正なデータを検知したジャーナルの世代番号）
初期
J
テキスト
OpenTP1のリランで起動する際に，読み込んだブロックにエラーがあったとき
×

14
アーカイブジャーナルファイルの不正ジャーナル情報ファイル
$DCDIR/spool/dcjnlinf/errinf/cuef_N
（N：不正ジャーナルを検知したコマンドプロセスのPID）
07-03
A
バイナリ
jnlunlfgコマンド，jnlchgfgコマンド，またはjnllsコマンドが不正ジャーナルを検知したとき
△

15
GWFログファイル
$DCDIR/spool/gwflogN
（N：1または2）
初期
C，E，H
テキスト
ゲートウェイサービスに関する内部関数でエラーリターンしたとき
×

16
UAPトレース編集出力ファイル
（prc_coresave_pathオペランドの指定値）/（サーバ名）N.uat
（N：1～3）
デフォルト：
$DCDIR/spool/save/（サーバ名）N.uat
（N：1～3）
初期
C，H
テキスト
プロセスがダウンしたとき※2
△

17
UAPトレースデータファイルのバックアップファイル
$DCDIR/spool/save/trc/（サーバ名）_N.uatmap
（N：1～3）
サーバ異常終了時：
$DCDIR/spool/save/trc/（サーバ名）N.uatmap
（N：1～3）
07-03
K
バイナリ
ユーザサーバがダウンしたとき，またはOpenTP1が起動したとき
△

18
prcd管理プロセスのpidファイル
$DCDIR/tmp/home/（サーバ名）/.prc.PID
初期
J
空
各プロセスを開始したとき
×

19
UAPトレースデータファイル
$DCDIR/tmp/home/（サーバ名）.ID/dcuat.map
07-03
C
バイナリ
UAPプロセスを起動したとき
△

20
同一マシン内DCDIR管理情報
Linux版：
/opt/OpenTP1/etc/.OpenTP1
AIX版またはHI-UX/WE2版：
/usr/etc/BeTRAN
初期
J
テキスト
dcsetupコマンドを実行したとき
×

21
同一マシン内DCDIR管理シェル
Linux版：
/opt/OpenTP1/etc/dcpwon
AIX版またはHI-UX/WE2版：
/usr/bin/dcpwon
初期
J
テキスト
dcsetupコマンドを実行したとき
×

22
通信制御ファイル
1. Linux版の場合：
/opt/OpenTP1/etc/so_unix
2. Solaris版，かつOSのバージョンが10以上，かつZone環境（仮想サーバ）の場合：
/etc/OpenTP1/so_unix
3. 上記以外：
/dev/OpenTP1/so_unix
1.の場合：
05-03
2.の場合：
07-00
3.の場合：
03-02
J
ローカルソケット
プロセスを起動したとき
×

23
dcsetup用バッファファイル1
/tmp/.admdPID/*
初期
J
テキスト
dcsetupコマンドを実行したとき
□
（dcsetup）

24
dcsetup用バッファファイル2
/etc/tp1admtabwk_mdHMS
（mdHMS：ファイル作成時の月日時分秒の時間情報）
07-04
J
テキスト
dcsetupコマンドを実行したとき
△

25
リアルタイム出力機能（betran.log）
HP-UX版，AIX版，またはSolaris版：
/tmp/betran.log
Linux (IPF)版：
$DCDIR/spool/betran.log
Linux (x86)：
$DCDIR/spool/prclogN
（N：1または2）
HI-UX/WE2版：
コンソールに出力しているのでこのファイルはありません。
初期
A
テキスト
OpenTP1を動作したとき
×

26
namdomainsetupコマンド実行時の一時ファイル
/tmp/TP1dmfilwork（PID）
初期
J
テキスト
namdomainsetupコマンドを実行したとき
□
（namdomainsetup）

27
dcsetup用排他ファイル
Linux版：
/var/spool/.OpenTP1.HiRDB/.lock
AIX版またはHI-UX/WE2版：
/usr/spool/.OpenTP1.HiRDB/.lock
初期
J
バイナリ
dcsetupコマンドを実行したとき
×

28
jnlsortコマンド実行時の一時ファイル
（jnlsortコマンドを実行したカレントパス）/sort_I＋プロセスID
（jnlsortコマンドを実行したカレントパス）/sort_o＋プロセスID
初期
J
テキスト
jnlsortコマンドに-gオプションを指定しないで実行したとき
□
（jnlsort）

29
OpenTP1制御ファイル1
hitachi.OpenTP1sb.dcpwon.conf
07-04-01
J
テキスト
dcsetupコマンドを実行したとき※3
×

30
OpenTP1制御ファイル2
hitachi.OpenTP1sb.dcpwon.conf
(XX：通し番号）
07-04-01
J
テキスト
dcsetupコマンドを実行したとき※3
×

（凡例）

A：単調増加（削除機能がないタイプ）

C：ラウンドロビン（バックアップ取得機能がないタイプ）

E：ラウンドロビン（一定量に達した直後の出力で，新しいファイルに切り替わるタイプ）

H：ラウンドロビン（切り替わった先のファイルのデータを，削除してから先頭から書き込むタイプ）

Ｊ：制御ファイル，一時ファイル

K：バックアップファイル

○：ユーザ判断で削除できます。

△：削除してはいけません。ただし，障害調査が不要であれば，ユーザ判断で削除できます。

□：コマンド終了時に削除します。（　）内は該当するコマンド名です。

×：削除してはいけません。

注※1

Red Hat Enterprise Linux Server 6以降で使用する場合，/etc/initディレクトリ下のOpenTP1のファイルのバックアップは実施しないため，$DCDIR/conf/Inittab/inittabN（N：1～3）を取得しません。

注※2

次の条件でコマンドを実行した場合のプロセスダウンも含みます。

・dcstopコマンドに-fオプションおよび-dオプションを指定

・dcsvstopコマンドに-fオプションおよび-dオプションを指定

注※3

Red Hat Enterprise Linux Server 6以降で実行した場合だけとなります。

TP1/Server Base（UNIX版固有）が出力するファイルの説明を次の表に示します。

表F-4　TP1/Server Base（UNIX版固有）が出力するファイルの説明

項番
名称
関連する定義
サイズ
最大ファイル数
説明

1
通信制御ファイル
なし
通信メッセージサイズ
起動プロセス数
ローカルマシン上で通信を実行する際に使用するファイルです。

2
inittabのバックアップファイル
なし
/etc/inittabファイルのサイズ
3世代
/etc/inittabファイルのバックアップです。※1

3
dccspool用制御ファイル
なし
0
1ファイル
OpenTP1の動作を制御するファイルです。

4
prctee用パイプファイル
なし
数バイト（固定）
1ファイル
OpenTP1の動作を制御するファイルです。

5
prcteeプロセスのpid格納ファイル
なし
数バイト（固定）
1ファイル
OpenTP1の動作を制御するファイルです。

6
prcdlpathコマンドの引き継ぎファイル
＜プロセスサービス定義＞

prc_take_over_dlpathオペランド
リラン時にprcdlpathコマンドでのサーチパスの変更を引き継ぐかどうかを指定

268バイト
1ファイル
OpenTP1の動作を制御するファイルです。prcdlpathコマンド実行時に，引数に指定したサーチパスを保存するファイルです。

7
prcteeプロセス起動エラー時の出力ファイル
なし
単調増加
1ファイル
prcteeプロセス起動エラー時のprcdの情報を出力するファイルです。

8
prcdのPAUSE判定ファイル
なし
数バイト（固定）
1ファイル
OpenTP1の動作を制御するファイルです。

9
Linux用prcdのpid格納ファイル
なし
数バイト（固定）
1ファイル
OpenTP1の動作を制御するファイルです。

10
prcteeプロセスのエラー出力ファイル
なし
単調増加
1ファイル
betran.logへの出力エラーに関する情報を出力するファイルです。

11
被アーカイブジャーナルノード接続情報ファイル
＜グローバルアーカイブジャーナルサービス定義＞

jnldfsv定義コマンド
グローバルアーカイブジャーナルサービスのリソースグループ数の指定

124バイト
グローバルアーカイブジャーナルサービス定義のjnldfsv定義コマンドの-aオプションに指定したリソースグループ数
被アーカイブジャーナルノードとの接続情報ファイルです。グローバルアーカイブジャーナル機能を使用した場合に，アーカイブジャーナルノードとの接続情報を取得します。

12
アーカイブジャーナルノード接続情報ファイル
なし
124バイト×アーカイブジャーナルノードに接続する被アーカイブジャーナルノード数
アーカイブジャーナルノードに接続する被アーカイブジャーナルノード数
アーカイブジャーナルノードとの接続情報ファイルです。グローバルアーカイブジャーナル機能を使用した場合に，被アーカイブジャーナルノードとの接続情報を取得します。

13
アーカイブジャーナルノードの不正ジャーナル情報ファイル
＜アーカイブジャーナルサービス定義＞

jnl_arc_max_datasizeオペランド
アーカイブ時の転送データの最大長

jnl_dualオペランド
ジャーナルファイルを二重化するかどうかを指定

jnl_arc_max_datasizeオペランドの指定値
jnl_dual=Nの場合：
アーカイブジャーナルノードに接続する被アーカイブジャーナルノード数
jnl_dual=Yの場合：
アーカイブジャーナルノードに接続する被アーカイブジャーナルノード数×2
アーカイブジャーナルノードの不正ジャーナル情報ファイルです。OpenTP1のリランで起動する際に読み込んだブロックにエラーがあった場合（異常時）に取得します。※2

14
アーカイブジャーナルファイルの不正ジャーナル情報ファイル
＜グローバルアーカイブジャーナルサービス定義＞

jnl_arc_max_datasizeオペランド
アーカイブ時の転送データの最大長

jnl_arc_max_datasizeオペランドの指定値
単調増加
アーカイブジャーナルファイルの不正ジャーナル情報ファイルです。jnllsコマンドが不正ジャーナルを検知した場合に取得します。

15
GWFログファイル
なし
0.1メガバイト
2世代
設計調査用通信トレース情報です。ただし，ゲートウェイサービスはLinux版，およびsolaris版は未サポートです。また，すべてのOSで，07-00以降はサポート対象外です。

16
UAPトレース編集出力ファイル
＜プロセスサービス定義＞

prc_coresave_pathオペランド
コアファイル格納パス

可変
3世代
ダウンしたシステムサーバ，ユーザサーバのUAPトレース情報ファイルです。

17
UAPトレースデータファイルのバックアップファイル
＜ユーザサービス定義＞
＜ユーザサービスデフォルト定義＞
＜システム共通定義＞
＜各システムサービス定義＞

uap_trace_maxオペランド
UAPトレースのレコード数

uap_trace_file_putオペランド
UAPトレースのトレース情報をファイルに出力するか指定

32ビット版の場合：
((uap_trace_maxオペランドの指定値＋1)×256)＋128（バイト）
64ビット版の場合：
((uap_trace_maxオペランドの指定値＋1)×264)＋144（バイト）
6世代（正常終了時・異常終了時は3世代）
システムサーバ，およびユーザサーバのUAPトレース情報を出力する，UAPトレース編集出力ファイルの元データファイルのバックアップファイルです。

18
prcd管理プロセスのpidファイル
なし
0
プロセス数分
OpenTP1の動作を制御するファイルです。

19
UAPトレースデータファイル
＜ユーザサービス定義＞
＜ユーザサービスデフォルト定義＞
＜システム共通定義＞
＜各システムサービス定義＞

uap_trace_maxオペランド
UAPトレースのレコード数

uap_trace_file_putオペランド
UAPトレースのトレース情報をファイルに出力するか指定

32ビット版の場合：
((uap_trace_maxオペランドの指定値＋1)×256)＋128（バイト）
64ビット版の場合：
((uap_trace_maxオペランドの指定値＋1)×264)＋144（バイト）
1世代
システムサーバ，およびユーザサーバのUAPトレース情報を出力する，UAPトレース編集出力ファイルの元データファイルです。

20
同一マシン内DCDIR管理情報
なし
同一マシン上に登録しているDCDIRに依存
1ファイル
OpenTP1の動作を制御するファイルです。

21
同一マシン内DCDIR管理シェル
なし
同一マシン上に登録しているDCDIRに依存
1ファイル
OpenTP1の動作を制御するファイルです。

22
通信制御ファイル
＜システム共通定義＞

rpc_multi_tp1_in_same_hostオペランド
同一ホスト内に複数のOpenTP1を稼働させ，これらを同一グローバルドメイン（システム共通定義のall_nodeオペランドで指定したノード名の集合）として運用するかどうかを指定

通信メッセージサイズ
起動プロセス数
ローカルマシン上で通信を実行する際に使用するファイルです。

23
dcsetup用バッファファイル1
なし
DCDIRの長さや/etc/inittabのサイズに依存します。
12ファイル
OpenTP1の動作を制御するファイルです。※1

24
dcsetup用バッファファイル2
なし
DCDIRの長さや/etc/inittabのサイズに依存します。
1ファイル
OpenTP1の動作を制御するファイルです。※3

25
リアルタイム出力機能（betran.log）
なし
単調増加（ラップアラウンド方式に変更した場合は65535キロバイト）
1世代（ラップアラウンド方式に変更した場合は2世代）
標準出力，標準エラー出力の情報を出力するログファイルです。また，07-00より前の場合では，prcteeプロセスのエラー内容もこのファイルに出力します。ファイル名称，格納ディレクトリ，ファイル容量が変更できます。詳細については，ソフトウェア添付資料または「3.5　標準出力ファイルに関する運用」を参照してください。

26
namdomainsetupコマンド実行時の一時ファイル
なし
ドメインデータファイル名に指定したhostsファイル中のホスト名に指定したホスト名と一致した行数分のサイズ
1ファイル
OpenTP1の動作を制御するファイルです。namdomainsetupコマンドを実行した場合，指定したドメインデータファイル中に指定したホスト名が登録済みかどうかをチェックするときに一時的に作成するファイルです。

27
dcsetup用排他ファイル
なし
0
1ファイル
OpenTP1の動作を制御するファイルです。

28
jnlsortコマンド実行時の一時ファイル
なし

sort_I＋プロセスID
256バイト×ソート対象ブロック件数

sort_o＋プロセスID
256バイト×ソート対象ブロック件数

sort_I＋プロセスID
で1ファイル

sort_o＋プロセスID
で1ファイル

OpenTP1の動作を制御するファイルです。OSのsortコマンドでソートする前後のジャーナルブロック情報ファイルです。

29
OpenTP1制御ファイル1
なし
数バイト。$DCDIRの長さに依存します。
1ファイル
OpenTP1の動作を制御するファイルです。※4

30
OpenTP1制御ファイル2
なし
数バイト。$DCDIRの長さに依存します。
OpenTP1ディレクトリ数分
OpenTP1の動作を制御するファイルです。※4

注※1

Red Hat Enterprise Linux Server 6以降で使用する場合は，/etc/initディレクトリ下のOpenTP1のファイルのバックアップは実施しないため，inittabのバックアップファイルを取得しません。

注※2

終端ブロックがない場合にも取得します。そのため，OpenTP1強制停止など終端ブロックを書き込む契機が発生しなかった場合は，ブロックエラーの有無に関係なく出力します。

注※3

Red Hat Enterprise Linux Server 6以降で使用する場合は，/etc/tp1admtabwk_mdHMS（mdHMS：ファイル作成時の月日時分秒の時間情報）を取得しません。

注※4

Red Hat Enterprise Linux Server 6以降で実行した場合だけとなります。

(3)　TP1/Server Base（Windows版固有）

TP1/Server Base（Windows版固有）が出力するファイルの一覧を次の表に示します。各ファイルの詳細な説明については，表F-6を参照してください。

表F-5　TP1/Server Base（Windows版固有）が出力するファイル一覧

項番
名称
ファイル名または
ディレクトリ名
バージョン
タイプ
ファイル形式
取得
タイミング
削除可否

1
修正パッチログファイル
TP1/Server Base：
%DCDIR%¥patchlogbase.txt
DAM：
%DCDIR%¥patchlogdam.txt
TAM：
%DCDIR%¥patchlogtam.txt
EXT1：
%DCDIR%¥patchlogext1.txt
HAF：
%DCDIR%¥patchloghaf.txt
07-00
A
テキスト
修正パッチの実行の延長で取得します。
△

2
prcteeプロセスのエラー時の出力ファイル
%DCDIR%¥spool¥betran.err
05-00-/E
A
テキスト
OpenTP1を起動したとき
×

3
rawデバイス用ロックファイル
%DCDIR%¥spool¥dcntbinf¥rawlock_N
（N：ドライブ文字）
06-50
J
空
rawデバイスを初回オープンしたとき
×

4
退避モジュール（UMT）トレースファイル
%DCDIR%¥spool¥save¥trc¥_zx.umt
（z：1～8文字のサーバ名，x：通番）
初期
I
バイナリ
OpenTP1を起動したとき
○

5
退避UAPトレースファイル
%DCDIR%¥spool¥save¥trc¥（サーバ名）N.uat
（N：1～10）
初期
C，I
バイナリ
プロセスダウンしたとき※，およびOpenTP1起動時に退避します。
△

6
共用メモリファイル
%DCDIR%¥spool¥shm¥N
（N：1から始まる数字）
初期
J
バイナリ
OpenTP1を起動したとき。次回オンライン時には削除して，再作成します。
×

7
GUI用ロックファイル
%DCDIR%¥tp1_tools¥Control.lck
%DCDIR%¥tp1_tools¥Environment.lck
06-50
J
空
GUI機能を使用したとき。GUI終了時に削除します。
×

8
admshowppログファイル
%temp%¥admshowpp.log
07-01
J
テキスト
dcsetupコマンドの延長で取得します。
×

9
dcsetupログファイル
%temp%¥dcsetup.log
初期
A
テキスト
インストーラ，修正パッチ動作の延長で取得します。
△

10
dcsetupmlログファイル
%temp%¥dcsetupml.log
06-50
A
テキスト
dcsetupmlコマンド，インストーラ動作の延長で取得します。
△

11
trnlnkrmログファイル
%temp%¥trnlnkrm.log
初期
A
テキスト
trnlnkrmコマンドの実行，dcsetupmlコマンドの実行，インストーラ，修正パッチ動作の延長で取得します。
△

12
標準出力リダイレクトファイル
（redirect_file_nameオペランドの指定値）N
（N：1または2）
デフォルト：
%DCDIR%¥spool¥prclogN
（N：1または2）
05-00-/E
C，E，H
テキスト
OpenTP1を動作したとき
○

13
UAPトレースファイル
（カレントワークパス）¥tmp¥home¥_z.x¥_zPPPPP.uat
（z：1～8文字のサーバ名，PPPPP：PID，x：通番）
初期
I
バイナリ
ユーザサーバの起動の延長で作成します。
○

14
モジュール（UMT）トレースファイル
（カレントワークパス）¥tmp¥home¥_z.x¥_zPPPPP.umt
（z：1～8文字のサーバ名，PPPPP：PID，x：通番）
プロセスサーバの場合：
%DCDIR%¥spool¥save¥_prcPPPPP.umt
（PPPPP：PID）
初期
I
バイナリ
OpenTP1の起動，ユーザサーバの起動の延長で作成します。
○

（凡例）

A：単調増加（削除機能がないタイプ）

C：ラウンドロビン（バックアップ取得機能がないタイプ）

E：ラウンドロビン（一定量に達した直後の出力で，新しいファイルに切り替わるタイプ）

H：ラウンドロビン（切り替わった先のファイルのデータを，削除してから先頭から書き込むタイプ）

Ｉ：ラウンドロビン（OpenTP1起動時に新しいファイルに切り替わるタイプ）

Ｊ：制御ファイル，一時ファイル

○：ユーザ判断で削除できます。

△：削除してはいけません。ただし，障害調査が不要であれば，ユーザ判断で削除できます。

×：削除してはいけません。

注※

次の条件でコマンドを実行した場合のプロセスダウンも含みます。

・dcstopコマンドに-fオプションおよび-dオプションを指定

・dcsvstopコマンドに-fオプションおよび-dオプションを指定

TP1/Server Base（Windows版固有）が出力するファイルの説明を次の表に示します。

表F-6　TP1/Server Base（Windows版固有）が出力するファイルの説明

項番
名称
関連する定義
サイズ
最大ファイル数
説明

1
修正パッチログファイル
なし
単調増加。パッチ実行のたびに上書きされます。
5ファイル（BASE：1世代，DAM：1世代，TAM：1世代，EXT1：1世代，HAF：1世代）
修正パッチの実行ログファイルです。修正パッチの実行で取得します。

2
prcteeプロセスのエラー時の出力ファイル
なし
単調増加
1ファイル
prcteeプロセスのエラー時の情報を出力するファイルです。

3
rawデバイス用ロックファイル
なし
0
rawデバイス使用数
OpenTP1の動作を制御するファイルです。OpenTP1ファイルシステムにrawデバイスを使用する場合に作成する内部ファイルです。

4
退避モジュール（UMT）トレースファイル
なし
4160バイト（プロセスサーバの場合は，73696バイト）
10世代×サーバ起動数
モジュール（UMT）トレースファイルのバックアップファイルです。

5
退避UAPトレースファイル
なし
可変
10世代
ダウンしたシステムサーバ，ユーザサーバのUAPトレース情報ファイルです。

6
共用メモリファイル
なし
マシン状況やOpenTP1システム稼働状況によって可変となります。
1世代
OpenTP1の動作を制御するファイルです。OpenTP1が確保した共用メモリのファイルです。

7
GUI用ロックファイル
なし
0
2ファイル
OpenTP1の動作を制御するファイルです。OpenTP1のGUI機能使用時に，重複起動防止のために作成するファイルです。

8
admshowppログファイル
なし
正常時は0バイト。エラー発生時は可変。コマンド実行ごとに上書きします。
1世代
OpenTP1の動作を制御するファイルです。内部コマンドのエラーログです。dcsetupコマンドの延長で動作する内部コマンドが出力します。コマンド内部でエラー発生時にエラー内容を出力します。

9
dcsetupログファイル
なし
単調増加。コマンド実行ごとに上書きします。
1世代
dcsetupコマンドのトレースファイルです。インストーラ動作の延長，修正パッチ動作の延長で取得します。

10
dcsetupmlログファイル
なし
単調増加。コマンド実行ごとに上書きします。
1世代
dcsetupコマンドのトレースファイルです。dcsetupmlコマンドの実行，インストーラ動作の延長で取得します。

11
trnlnkrmログファイル
なし
単調増加。コマンド実行ごとに上書きします。
1世代
trnlnkrmコマンドのトレースファイルです。trnlnkrmコマンド，dcsetupmlコマンドの実行，インストーラ動作の延長，修正パッチ動作の延長で取得します。

12
標準出力リダイレクトファイル
＜システム環境定義＞

redirect_fileオペランド
OpenTP1配下のプロセスの標準出力・標準エラー出力先を指定

redirect_file_nameオペランド
標準出力・標準エラー出力を出力するファイル名を指定

redirect_file_sizeオペランド
標準出力・標準エラー出力をするファイル長を指定

最大でredirect_file_sizeオペランドの指定値（ただし，単調増加ファイルに変更可）
2世代（単調増加ファイルに変更した場合は1世代）
標準出力，標準エラー出力の情報を出力するログファイルです。redirect_fileオペランドにYを設定した場合だけ出力します。また，システム共通定義のprc_portオペランド，rpc_port_baseオペランドを設定した場合は出力しません。

13
UAPトレースファイル
＜ユーザサービス定義＞
＜ユーザサービスデフォルト定義＞

uap_trace_maxオペランド
UAPトレース格納最大数

可変
1世代×サーバ起動数
オンライン中プロセスのUAPトレースファイルです。

14
モジュール（UMT）トレースファイル
なし
4160バイト（プロセスサーバの場合は，73696バイト）
1世代×サーバ起動数
オンライン中プロセスのモジュール（UMT）トレースファイルです。

(4)　TP1/FS/Direct Access

TP1/FS/Direct Accessが出力するファイルの一覧を次の表に示します。各ファイルの詳細な説明については，表F-8を参照してください。

表F-7　TP1/FS/Direct Accessが出力するファイル一覧

項番
名称
ファイル名または
ディレクトリ名
バージョン
タイプ
ファイル形式
取得
タイミング
削除可否

1
damd生存確認ファイル
$DCDIR/tmp/damlive
初期
J
バイナリ
damdが起動したとき
×

2
論理ファイル回復時の一時ファイル
（damfrcコマンド実行ディレクトリ）/.dcdamPPPPPPP
（PPPPPPP：PIDの下7けた）
初期
J
バイナリ
damfrcコマンドの-cオプション未指定かつオンライン中バックアップファイル指定で実行したとき
□
（damfrc）

3
オンラインDAMバックアップ取得時の一時ファイル
（dambkup -o -s実行ディレクトリ）/bkTTTTPPPP
（TTTT：通算秒の下4けた，PPPP：プロセスIDの下4けた）
初期
J
バイナリ
dambkupオプションに-oオプションと-sオプションを指定して実行したとき
□
（dambkup）

（凡例）

Ｊ：制御ファイル，一時ファイル

□：コマンド終了時に削除します。（　）内は該当するコマンド名です。

×：削除してはいけません。

TP1/FS/Direct Accessが出力するファイルの説明を次の表に示します。

表F-8　TP1/FS/Direct Accessが出力するファイルの説明

項番
名称
関連する定義
サイズ
最大ファイル数
説明

1
damd生存確認ファイル
なし

32ビット版の場合：

136バイト

64ビット版の場合：

224バイト

1ファイル
OpenTP1の動作を制御するファイルです。damdが起動しているかどうかを確認するためのファイルです。

2
論理ファイル回復時の一時ファイル
なし
96バイト
1ファイル
OpenTP1の動作を制御するファイルです。damfrcコマンドの-cオプション未指定かつオンライン中バックアップファイル指定で実行したときにコマンドを実行したディレクトリ下に内部情報を一時ファイルに出力します。

3
オンラインDAMバックアップ取得時の一時ファイル
なし
バックアップ対象のDAMファイルサイズ＋128バイト
1ファイル
OpenTP1の動作を制御するファイルです。dambkupコマンドに，-oオプションおよび-sオプションを指定して実行したときに，DAMファイルのバックアップ内容を標準出力へ出力する前に一時的にバックアップデータを格納するファイルです。

(5)　TP1/FS/Table Access

TP1/FS/Table Accessが出力するファイルの一覧を次の表に示します。各ファイルの詳細な説明については，表F-10を参照してください。

表F-9　TP1/FS/Table Accessが出力するファイル一覧

項番
名称
ファイル名または
ディレクトリ名
バージョン
タイプ
ファイル形式
取得
タイミング
削除可否

1
オンラインTAMバックアップ取得時の一時ファイル
$DCDIR/tmp/.dctamdN
（N：1～9999999​）
初期
J
バイナリ
tambkupコマンドに-oオプションを指定して実行したとき
□
（tambkup）

2
共用メモリ情報ファイル（TAM用）
$DCDIR/tmp/tammemfile
初期
J
バイナリ
OpenTP1を起動したとき
×

3
論理ファイル回復時の一時ファイル
（tamfrcコマンド実行ディレクトリ）/.dctamPID
初期
J
バイナリ
tamfrcコマンドの-ｊオプション未指定かつオンライン中バックアップファイル指定で実行したとき
□
（tamfrc）

（凡例）

Ｊ：制御ファイル，一時ファイル

□：コマンド終了時に削除します。（　）内は該当するコマンド名です。

×：削除してはいけません。

TP1/FS/Table Accessが出力するファイルの説明を次の表に示します。

表F-10　TP1/FS/Table Accessが出力するファイルの説明

項番 | 名称 | 関連する定義 | サイズ | 最大ファイル数 | 説明
1 | オンラインTAMバックアップ取得時の一時ファイル | なし | バックアップ対象のTAMファイルサイズ | 1ファイル | OpenTP1の動作を制御するファイルです。tambkupコマンドに-oオプションを指定して実行したときに，TAMファイルのバックアップ内容を一時的に格納するファイルです。
2 | 共用メモリ情報ファイル（TAM用） | なし | 4バイト | 1ファイル | OpenTP1の動作を制御するファイルです。
3 | 論理ファイル回復時の一時ファイル | なし | 96バイト | 1ファイル | OpenTP1の動作を制御するファイルです。tamfrcコマンドの-jオプション未指定かつオンライン中バックアップファイル指定で実行したときにコマンドを実行したディレクトリ下に内部情報を一時ファイルに出力します。

(6)　TP1/Online Tester

TP1/Online Testerが出力するファイルの一覧を次の表に示します。各ファイルの詳細な説明については，表F-12を参照してください。

表F-11　TP1/Online Testerが出力するファイル一覧

項番
名称
ファイル名または
ディレクトリ名
バージョン
タイプ
ファイル形式
取得
タイミング
削除可否

1
XATMI送信データファイル
$DCDIR/spool/uto/（テストユーザID）/（ユーザサーバ名）/xsd（サービス名）
初期
J
バイナリ
クライアントからのtpsend関数によるXATMI要求を受け付けたとき
○

2
MCF送信メッセージファイル
$DCDIR/spool/uto/（テストユーザID）/（ユーザサーバ名）/sendmsg
初期
J
バイナリ
クライアントから表F-12に記載されているMCFの関数発行による要求を受け付けたとき
○

3
UTOトレースファイル
$DCDIR/spool/uto/（テストユーザID）/traceN
（N：1または2）
初期
C，E，H
バイナリ
オンラインテスタを使用して，UAPの動作確認を実行したとき
○

4
一時記憶データファイル
$DCDIR/spool/uto/（テストユーザID）/utotmp（論理端末名称）
初期
J
バイナリ
クライアントからdc_mcf_tempput関数発行によって一時記憶データを受け取ったとき
○

5
テストデータ定義ファイル
utofilcreオペランドの-oオプションに指定したファイルパス
または
utofilcreオペランドの-eオプションに指定したテストデータ定義ファイル内に指定したファイルパス
次のテスタファイルを作成できます。

RPC要求データファイル

RPC応答データファイル

XATMI要求データファイル

XATMI応答データファイル

XATMI受信データファイル

非同期型受信データファイル

同期型受信データファイル

初期
J
バイナリ
utofilcreコマンドを実行したとき
○

6
MCF受信メッセージファイル（非同期型と同期型があります）
utomsgoutコマンドの-rオプションに指定したファイルパス
初期
J
バイナリ
utomsgoutコマンドに-rオプションを指定して実行したとき
○

7
RPC応答データファイル
utosppsvcコマンドのRPC応答データファイル名に指定したファイルパス
初期
J
バイナリ
utosppsvcコマンドにRPC応答データファイル名を指定して実行したとき
○

8
UTOトレースマージファイル
utotrcmrgコマンドの-oオプションに指定したファイルパス
初期
J
バイナリ
utotrcmrgに-oオプションを指定して実行したとき
○

9
XATMI応答データファイル
utoxsppsvcコマンドのXATMI応答データファイル名に指定したファイルパス
初期
J
バイナリ
utoxsppsvcにXATMI応答データファイル名を指定して実行したとき
○

（凡例）

C：ラウンドロビン（バックアップ取得機能がないタイプ）

E：ラウンドロビン（一定量に達した直後の出力で，新しいファイルに切り替わるタイプ）

H：ラウンドロビン（切り替わった先のファイルのデータを，削除してから先頭から書き込むタイプ）

Ｊ：制御ファイル，一時ファイル

○：ユーザ判断で削除できます。

TP1/Online Testerが出力するファイルの説明を次の表に示します。

表F-12　TP1/Online Testerが出力するファイルの説明

項番
名称
関連する定義
サイズ
最大ファイル数
説明

1
XATMI送信データファイル
＜ユーザサービス定義＞
ユーザサーバ名が出力先パスの一部となります。
サービス名がファイル名の一部となります。
＜環境変数＞
テストユーザID（DCUTOKEY）の設定値が出力先パスの一部となります。
XATMI送信データ長＋68バイト
テストユーザID，ユーザサーバ名およびサービス名の組み合わせごとに1ファイル
XATMI送信データファイルです。クライアントがtpsend関数を発行した際の送信データをファイルに格納します。

2
MCF送信メッセージファイル
＜テスタサービス定義＞

max_message_file_sizeオペランド
MCF送信メッセージファイルの最大容量を指定

max_message_file_sizeオペランドの指定値
テストユーザIDごとに1ファイル
MCF送信メッセージを格納するファイルです。MCFシミュレート機能を使用した場合，次の関数を発行したときの送信メッセージを格納します。

dc_mcf_execap関数

dc_mcf_reply関数

dc_mcf_send関数

dc_mcf_sendsync関数

dc_mcf_sendrecv関数

3
UTOトレースファイル
＜テスタサービス定義＞

max_trace_file_sizeオペランド
UAPトレース情報を取得するトレースファイルの最大容量を指定

max_trace_file_sizeオペランドの指定値
2世代
UTOトレースファイルです。UAPトレース情報を取得します。

4
一時記憶データファイル
＜テスタサービス定義＞
utotmp論理端末名称がファイル名となります。
＜環境変数＞
テストユーザID（DCUTOKEY）の設定値が出力先パスの一部となります。
128バイト
テストユーザIDとutotmp論理端末名称の組み合わせごとに1ファイル
OpenTP1の動作を制御するファイルです。クライアントがdc_mcf_tempput関数を発行した際の一時記憶データをファイルに格納します。

5

RPC要求データファイル

RPC応答データファイル

XATMI要求データファイル

XATMI応答データファイル

XATMI受信データファイル

非同期型受信データファイル

同期型受信データファイル

なし
ユーザ任意
1ファイル
オンラインテスタで使用する，テストデータ定義ファイルです。

6
MCF受信メッセージファイル（非同期型と同期型があります）
なし
ユーザ任意
1ファイル
MCF受信メッセージを格納するファイルです。オンラインテスタが出力した送信メッセージ情報を編集して作成するMCF受信メッセージです。

非同期型
MHPのdc_mcf_receive関数に渡すメッセージ。

同期型
UAPのdc_mcf_recvsync関数やdc_mcf_sendrecv関数などに渡すメッセージ。

7
RPC応答データファイル
なし
ユーザ任意
1ファイル
RPC応答データファイルです。RPCインタフェースのサーバUAPシミュレート機能を使用時，サービス要求元へ返す応答データとして使用するファイルです。

8
UTOトレースマージファイル
なし
トレースファイル名に指定したファイルの合計サイズ
1ファイル
UTOトレースマージファイルです。utotrcmrgコマンドで複数のUTOトレースファイルを一つのファイルにマージしたときに作成するファイルです。

9
XATMI応答データファイル
タイプトバッファ定義全般
タイプトバッファ定義ファイルやXATMI要求データファイルを基に作成されるため不定
1ファイル
XATMI応答データファイルです。サービス実行中に受け取る受信データやサービス実行後の応答データとして使用するファイルです。

(7)　TP1/Message Control

TP1/Message Controlが出力するファイルの一覧を次の表に示します。各ファイルの詳細な説明については，表F-14を参照してください。

表F-13　TP1/Message Controlが出力するファイル一覧

項番
名称
ファイル名または
ディレクトリ名
バージョン
タイプ
ファイル形式
取得
タイミング
削除可否

1
システムサービス共通情報定義ファイルのバックアップファイル
$DCDIR/.mcfdef/mcf
05-05
K
テキスト
dcsetupコマンドに-dオプションを指定して実行したとき
×

2
システムサービス情報定義ファイルのバックアップファイル
$DCDIR/.mcfdef/mcfu*
05-05
K
テキスト
dcsetupコマンドに-dオプションを指定して実行したとき
×

3
MCF通信サーバ実行形式プログラムのバックアップファイル
$DCDIR/.mcfserv/mcfu*
05-05
K
バイナリ
dcsetupコマンドに-dオプションを指定して実行したとき
×

4
MCFダンプファイル※1
$DCDIR/spool/mcfdKAXXZZ
（K：プロセス識別子，AXX：MCF識別子，ZZ：01～99）
初期
H，I
バイナリ
TP1/Message ControlやTP1/Messagingで内部矛盾などの障害を検出したとき
△

5
MCFトレースファイル※1
$DCDIR/spool/mcftAXXZZ
（AXX：MCF識別子，ZZ：01～99）
初期
H，I
バイナリ
MCF通信プロセス動作時に共用メモリ上のトレースバッファの一つが満杯になったとき
△

6
MCF性能検証用トレース情報ファイル※1
$DCDIR/spool/dcmcfinf/_mc_NNN
（NNN：000～256）
07-01
D，F
バイナリ
MCF通信プロセスまたはUAPが動作し，トレースバッファが満杯になったとき
△

7
MCF構成変更準備停止時のバックアップファイル※2
システムサービス共通情報定義のDCMCFQUEBAK指定値
デフォルト：$DCDIR/spool/mcf/mcfquebak
07-03
K
バイナリ
MCF構成変更準備停止（dcstop -b -q）を実行したとき
○※3

8
MCF性能検証用トレース情報ファイルのバックアップファイル※1
$DCDIR/spool/save/_mc_MMM.bkN
（MMM：001～256，N：1または2）
07-01
K
バイナリ
OpenTP1が停止したとき
△

9
マッピングエラー情報ファイル※4
$DCDIR/spool/save/dcmap_errXXX
（XXX：TP1/NET/XMAP3のMCF通信プロセスのプロセスID）
初期
H，I
テキスト
マッピング時にエラーが発生したとき
△

（凡例）

D：ラウンドロビン（バックアップ取得機能があるタイプ）

F：ラウンドロビン（一定量に達する直前の出力で，新しいファイルに切り替わるタイプ）

H：ラウンドロビン（切り替わった先のファイルのデータを，削除してから先頭から書き込むタイプ）

Ｉ：ラウンドロビン（OpenTP1起動時に新しいファイルに切り替わるタイプ）

K：バックアップファイル

○：ユーザ判断で削除できます。

△：削除してはいけません。ただし，障害調査が不要であれば，ユーザ判断で削除できます。

×：削除してはいけません。

注※1

TP1/Message Control，TP1/NET/Library，プロトコル製品，およびTP1/Messagingで出力するファイルです。

注※2

TP1/Message Control，TP1/NET/Library，およびプロトコル製品で出力するファイルです。

注※3

MCF構成変更再開始完了後に削除できます。

注※4

TP1/NET/XMAP3で出力するファイルです。

TP1/Message Controlが出力するファイルの説明を次の表に示します。

表F-14　TP1/Message Controlが出力するファイルの説明

項番
名称
関連する定義
サイズ
最大ファイル数
説明

1
システムサービス共通情報定義ファイルのバックアップファイル
システムサービス共通情報定義（$DCDIR/lib/sysconf/mcf）
$DCDIR/lib/sysconf/mcfのファイルサイズになります。
1ファイル
システムサービス共通情報定義のバックアップファイルです。

2
システムサービス情報定義ファイルのバックアップファイル
システムサービス情報定義
システムサービス情報定義ファイルのサイズになります。
システムサービス情報定義ファイルの数
システムサービス情報定義のバックアップファイルです。

3
MCF通信サーバ実行形式プログラムのバックアップファイル
なし
MCF通信プロセスプログラム・MCFアプリケーション起動プロセスプログラム（$DCDIR/lib/servers/mcfu*）のファイルサイズになります。
MCF通信サーバ実行形式プログラムの数
MCF通信サーバ実行形式プログラムのバックアップファイルです。

4
MCFダンプファイル※1
なし
MCFの「リリースノート」に記載されているMCFダンプファイル見積もり計算式のとおり
MCFマネジャプロセス，MCF通信プロセス，UAPが出力するファイル数は次のとおり。
TP1/NET/Library 07-03より前：
99ファイル
TP1/NET/Library 07-04以降：
3ファイル
MCFで障害が発生した場合にメモリの情報を取得するファイルです。トラブルシュートの目的で使用します。正常処理中には出力されません。

5
MCFトレースファイル※1
＜MCF通信構成定義のトレース定義＞
mcfttrc定義コマンドの-tオプション

sizeオペランド
トレースバッファサイズ

bufcntオペランド
トレースバッファ数

trccntオペランド
トレースファイル数

diskオペランド
ディスク出力機能使用有無

mcfttrc定義コマンドの-mオプション
ファイル数の扱い
size指定値×bufcnt指定値
-mオプションにdelを指定しているとき：trccntオペランドの指定値
-mオプションにoffを指定しているとき：99ファイル
MCF内で発生したイベントや送受信データの情報を取得するファイルです。
トラブルシュートの目的で使用します。disk=no（または省略）の場合はトレースファイルは作成されません。07-00以降はdisk=yesがデフォルトです。

6
MCF性能検証用トレース情報ファイル※1
＜システム共通定義＞

prf_traceオペランド
PRFトレースの取得有無

＜ユーザサービスデフォルト定義＞

mcf_prf_traceオペランド

＜ユーザサービス定義＞

mcf_prf_traceオペランド
ユーザサーバごとのPRFトレースの取得有無

＜MCF性能検証用トレース定義＞

prf_file_sizeオペランド
トレースファイルのサイズ

prf_file_countオペランド
トレースファイルの世代数

＜システムサービス定義＞

mcf_prf_traceオペランド
MCF通信プロセスごとのPRFトレースの取得有無

＜システムサービス共通情報定義＞

mcf_prf_trace_levelオペランド
MCF性能検証用トレース情報の取得レベル

prf_file_sizeオペランドの指定値
prf_file_countオペランドの指定値
MCF性能検証用トレース情報ファイルです。性能検証およびトラブルシュートの目的で使用します。システム共通定義のprf_traceオペランドにYを設定し，かつシステムサービス共通情報定義でmcf_prf_trace_levelオペランドに00000001​を設定した場合に性能検証用トレース情報を取得します。デフォルトでは取得しません。

7
MCF構成変更準備停止時のバックアップファイル※2
＜システムサービス共通情報定義＞
putenv DCMCFQUEBAK バックアップファイル名　～ <パス名><<$DCDIR/spool/mcf/mcfquebak>>
296＋キューグループ数×16＋論理端末数×20＋サービスグループ数×44＋未送信/未処理メッセージ数×(平均メッセージ長＋1036)（バイト）
1ファイル
MCF構成変更再開始機能使用時の未送信・未処理メッセージのバックアップファイルです。

8
MCF性能検証用トレース情報ファイルのバックアップファイル※1
MCF性能検証用トレース情報ファイル（項番6）と同様
prf_file_sizeオペランドの指定値
prf_file_countオペランドの指定値×2世代
MCF性能検証用トレース情報ファイルのバックアップファイルです。システム共通定義のprf_traceオペランドにY，mcf_prf_trace_levelオペランドに00000001​を設定した場合に取得します。
07-02以降の場合は，性能検証用トレース定義のprf_trace_backup=Nを設定すると，バックアップファイルを取得しません。

9
マッピングエラー情報ファイル※3
＜マッピングサービス属性定義＞
ERRLOG4=｛YES｜NO｝

YES
エラー情報を取得します。

NO
エラーコード4（軽いエラー）のマッピングエラーが発生した場合は，エラー情報を取得しません。

論理マップの領域サイズと物理マップファイルのサイズに依存します。
MCF通信プロセスの数※4
マッピング時に発生したエラー情報を取得するファイルです。トラブルシュートの目的で使用します。

注※1

TP1/Message Control，TP1/NET/Library，プロトコル製品，およびTP1/Messagingで出力するファイルです。

注※2

TP1/Message Control，TP1/NET/Library，およびプロトコル製品で出力するファイルです。

注※3

TP1/NET/XMAP3で出力するファイルです。

注※4

マッピングエラーが発生したTP1/NET/XMAP3のMCF通信プロセスの数を指します。ただし，OpenTP1の開始で，マッピングサービスプロセスのプロセスIDが変わるたびに増加します。

付録G　メッセージキュー用物理ファイルの見積もり式

UAPは，メッセージ制御機能（TP1/Message Control）を使って論理メッセージをやり取りするとき，入出力キューとしてディスクキューを使用できます。ディスクキューを使用すると，論理メッセージはメッセージキュー用物理ファイル上に書き込まれます。このメッセージキュー用物理ファイルのサイズは，queinitコマンドで指定したレコード長，およびレコード数で決定されます。ここでは，メッセージキュー用物理ファイルの見積もり式について示します。

＜この節の構成＞

付録G.1　レコード長の見積もり式

付録G.2　レコード数の見積もり式

付録G.3　見積もり例

付録G.1　レコード長の見積もり式

レコード長=↑（↑（a+976+8×b+36×c）/c↑）/d↑×d

↑↑：小数点以下を切り上げます。

a：1論理メッセージのサイズ

b：1論理メッセージのセグメント数

c：1論理メッセージを格納するレコード数

d：ファイルシステム初期化時に指定したセクタ長

付録G.2　レコード数の見積もり式

レコード数=e×c＋1

e：該当物理ファイルに格納する論理メッセージの最大数

c：1論理メッセージを格納するレコード数

注意事項

1論理メッセージは，1レコードに格納することも，複数レコードにわたって格納することもできます。ただし，1レコードには1論理メッセージしか格納できません。扱う論理メッセージのサイズが一定でない場合は，1論理メッセージを格納するレコード数を複数レコードに分割して格納できるように，レコード長およびレコード数を見積もることをお勧めします。

付録G.3　見積もり例

メッセージのサイズが4096バイト，セグメント数が3の論理メッセージを，100論理メッセージ格納する場合の物理ファイルのレコード長およびレコード数を見積もります。ただし，1論理メッセージを1レコードに納め，ファイルシステムのセクタ長は512バイトとします。

レコード長=↑（↑（4096+976+8×3+36×1）/1↑）/512↑×512=5632

レコード数=100×1+1=101

（凡例）↑↑：小数点以下を切り上げます。

付録H　OpenTP1ファイルの見積もり式

OpenTP1ファイルの見積もり式について説明します。

＜この節の構成＞

付録H.1　ステータスファイルのサイズの見積もり式

付録H.2　システムジャーナルファイルのサイズの見積もり式

付録H.3　チェックポイントダンプファイルのサイズの見積もり式

付録H.4　アーカイブジャーナルファイルのサイズの見積もり式

付録H.5　DAMファイルのサイズの見積もり式

付録H.6　TAMファイルのサイズの見積もり式

付録H.1　ステータスファイルのサイズの見積もり式

ステータスファイルのサイズを見積もるために必要なステータスファイルのレコード数を，1キー当たりのステータスファイルの使用容量とキー数から算出します。算出したレコード数をほかのサービスが使用するレコード数に加算してください。

1キー当たりのステータスファイルの使用容量とキー数は，被アーカイブノード，アーカイブノード，MCFサービスごとに求めます。算出結果をstsinitコマンド（ステータスファイル初期設定）の-cオプションに指定してください。なお，算出結果は必要最低限の数です。安全のため，算出結果の1.2倍の値を指定してください。

ステータスファイルのレコード数の算出式を次に示します。

各サービスに必要なレコード数の総和＋ステータスファイルの管理に必要なレコード数

（凡例）

各サービスに必要なレコード数

各サービスに必要なレコード数は，次の式で算出できます。

↑（1キー当たりのステータスファイルの使用容量／（レコード長※－40））↑×キー数

↑↑：小数点以下を切り上げます。

ステータスファイルの管理に必要なレコード数

ステータスファイルの管理に必要なレコード数は，次の式で算出できます。

＜レコード長が512以下の場合＞

↑（各サービスに必要なレコード数／472）↑＋23

＜レコード長が513以上の場合＞

↑（各サービスに必要なレコードの総数＋8776＋↑（8192／（レコード長※－40））↑×16）／（レコード長※－40）↑

↑↑：小数点以下を切り上げます。

注※

レコード長の単位：バイト

1キー当たりのステータスファイルの使用容量とキー数について説明します。

●被アーカイブノードの場合

表H-1　各サービスの1キー当たりのステータスファイルの使用容量とキー数（被アーカイブノードの場合）

サービス
1キー当たりのステータスファイルの使用容量
（単位：バイト）
キー数

システムマネジャ
A×128＋2432
1

スケジュールサービス
B×144＋128
1

トランザクションジャーナルサービス
2048
1

トランザクションサービス
1280×（RM数＋RM拡張子）＋2048
1

DAMサービス
（C＋D）×288＋256
1

メッセージキューサービス
E×120＋36
1

（F＋G）×40
1

（G＋H＋1）×48
1

ジャーナルサービス
8192
1

8192
J

17008
L

[図データ]　
L

チェックポイントダンプサービス
90
L

126
L

32
L

TAMサービス
N×136＋64
1

オンラインテスタ
P×160＋132
1

サーバリカバリジャーナルサービス
512×Q＋128
1

ISTサービス
V×8
1

XAリソースサービス
64
1

（凡例）

A：システム環境定義のserver_countオペランドの指定値

B：スケジュールサービス定義のscd_hold_recovery_countオペランドの指定値

C：DAMサービス定義のdamfile定義コマンドに指定した論理ファイルの総数

D：DAMサービス定義dam_added_fileオペランドの指定値

E：メッセージキューサービス定義のquegrp定義コマンドに指定した物理ファイルの総数

F：MCFマネジャ定義のmcfmexpコマンドの-gオプションの指定値

G：MCFマネジャ定義のmcfmexpコマンドの-lオプションの指定値

H：MCFマネジャ定義のmcfmcnameコマンドに指定したMCF通信サービスの総数

J：↑（5＋3×K）／63↑－1（↑↑：小数点以下を切り上げます）

K：システムジャーナルサービス定義のjnladdfg定義コマンドで指定するジャーナルファイルグループの総数

L：ジャーナルサービス定義のjnldfsv -cで指定するチェックポイントダンプサービス定義のファイルの総数

M：チェックポイントダンプサービス定義のjnladdfg定義コマンドで指定するジャーナルファイルグループの総数

N：TAMサービス定義のtam_max_tblnumオペランドの指定値

P：テスタサービス定義に指定するuto_server_countオペランドの指定値

Q：ジャーナルサービス定義のjnldfsv -cで指定するチェックポイントダンプサービス定義のファイルの総数

V：↓（（2347＋Σ（W×Y）＋Σ（16×Y））／8）↓（↓↓：小数点以下を切り捨てます）

W：ISTサービス定義に指定した各ISTテーブルのレコード長（単位：バイト）

Y：ISTサービス定義に指定した各ISTテーブルのレコード数

●アーカイブノードの場合

表H-2　各サービスの1キー当たりのステータスファイルの使用容量とキー数（アーカイブノードの場合）

サービス
1キー当たりのステータスファイルの使用容量
（単位：バイト）
キー数

システムマネジャ
A×128＋2432
1

ジャーナルサービス
8192
1

8192
R

（凡例）

A：システム環境定義のserver_countオペランドの指定値

S：グローバルアーカイブジャーナルサービス定義のjnldfsv -aで指定するアーカイブジャーナルサービス定義のファイルの総数

T：アーカイブジャーナルサービス定義のjnladdfgで指定するジャーナル関係ファイルグループの総数

U：アーカイブジャーナルサービス定義のjnl_max_file_dispersionオペランドの指定値

●MCFサービスの場合

表H-3　 1キー当たりのステータスファイルの使用量とキー数（MCFサービスの場合）

項目
1キー当たりのステータスファイルの使用容量
（単位：バイト）
キー数

MCFサービス
L×128
L

224
L

296+R×16+S×20+T×44※
1

↑（84+68×U）/32↑+↑V/128↑※
1

4※
1

各通信プロセス
80×↑M／1818↑×48
↑（↑M／1818↑）／1363↑

80×↑N／1818↑×48
↑（↑N／1818↑）／1363↑

MIN（48+M×36：65536）
↑M／1818↑

MIN（48+N×36：65536）
↑N／1818↑

80+↑O／4092↑×48
↑（↑O／4092↑）／1363↑

80+↑P／4092↑×48
↑（↑P／4092↑）／1363↑

MIN（48+O×36：65536）
↑O／4092↑

MIN（48+P×36：65536）
↑P／4092↑

4
1

64
1

48+1024×Q
1

（凡例）

L：MCFマネジャ定義の通信サービス定義（mcfmcname定義コマンド）に指定したMCF通信サービス名の数

M：MCFマネジャ定義の状態引き継ぎ定義（mcfmsts定義コマンド）に指定したサービスグループ数の上限値

N：MCFマネジャ定義の状態引き継ぎ定義（mcfmsts定義コマンド）に指定したサービス数の上限値

O：MCF通信構成定義の状態引き継ぎ定義（mcftsts定義コマンド）に指定したアプリケーション数の上限値

P：MCF通信構成定義の状態引き継ぎ定義（mcftsts定義コマンド）に指定した論理端末数の上限値

Q：PATHSTSオペランドにYESを指定したマッピングサービス属性定義に対応するマッピングサービス識別子のマッピングサービス定義中の記述数

R：MCFマネジャ定義の入出力キュー定義（mcfmqgid定義コマンド）に指定したキューグループの総数

S：MCF通信構成定義の論理端末定義（mcftalcle定義コマンド）に指定した論理端末の総数

T：MCFアプリケーション定義のアプリケーション属性定義（mcfaalcap定義コマンド）に指定したサービスグループの総数

U：MCFマネジャ定義のmcfmcomnコマンドの-nオプションの指定値

V：MCFマネジャ定義のmcfmcomnコマンドの-lオプションの指定値

MIN（x：y）：xとyとを比較し，小さい方の値

↑↑：小数点以下を切り上げます。

注

MQAサービスおよびISAMサービスのステータスファイルのサイズについては，マニュアル「TP1/Message Queue 使用の手引」，マニュアル「索引順編成ファイル管理 ISAM」，またはそれぞれの製品の「リリースノート」を参照して，算出してください。

注※

MCF構成変更再開始機能を使用する場合に加算します。

付録H.2　システムジャーナルファイルのサイズの見積もり式

システムジャーナルファイルのサイズを見積もるために，オンライン開始から終了までに発生するジャーナル総量を求めます。オンライン中に発生するジャーナル総量の算出式を次に示します。

（トランザクション当たりの平均ジャーナル量）×（オンライン開始から終了までの総トランザクション数）
＋オンライン開始から終了までにdcstatsコマンドによって取得する統計情報のジャーナル量
＋（UAPのOpenTP1のRPC，1回当たりのジャーナル量）
×（オンライン開始から終了までのUAPから発行するOpenTP1のRPCの回数の総和）（単位：バイト）

算出式で使用する値について次に説明します。

トランザクション当たりの平均ジャーナル量
表H-4に示す条件によって発生するジャーナルレコードの和を使用して次に示す算出式で求めます。

｛↑（j＋240）／4096↑×na＋↑（（a－j×na）＋240）／4096↑｝×4096（単位：バイト）

（凡例）

j：システムジャーナルサービス定義で指定したjnl_max_datasizeオペランドの指定値

a：表H-4に示す各ジャーナルレコードのうち，条件によって発生するものの総和

na：↓a／j↓

↑↑：小数点以下を切り上げます

↓↓：小数点以下を切り捨てます

TP1/Message Queueが使用する1トランザクション当たりのジャーナル量については，マニュアル「TP1/Message Queue 使用の手引」または「リリースノート」を参照してください。

オンライン開始から終了までにdcstatsコマンドによって取得する統計情報のジャーナル量
表H-5に示す値と次に示す算出式で求めます。

（↑（j＋240）／4096↑×nb＋↑（（b－j×nb）＋240）／4096↑）×4096×N（単位：バイト）

（凡例）

j：システムジャーナルサービス定義で指定したjnl_max_datasizeオペランドの指定値

b：表H-5によって求めた1回分の統計情報ジャーナル長

nb：↓b／j↓

N：システム統計情報の取得から終了までの時間をdcstatsコマンドの-mオプションで指定した時間で割った値（統計情報の取得回数）

↑↑：小数点以下を切り上げます

UAPのOpenTP1のRPC，1回当たりのジャーナル量
表H-6に示す値と次の算出式によって求めます。ただし，UAPのRPCでの統計情報を取得しない場合は0になります。

｛↑（j＋240）／4096↑×nc＋↑（（c－j×nc）＋240）／4096↑｝×4096（単位：バイト）

（凡例）

j：システムジャーナルサービス定義で指定したjnl_max_datasizeオペランドの指定値

c：表H-6よって求めた1回分の統計情報ジャーナル長

nc：↓c／j↓

↑↑：小数点以下を切り上げます

↓↓：小数点以下を切り捨てます

実際に用意するジャーナルファイルの総容量は，次の算出式の結果になります。

オンライン中に発生するジャーナル総量×1.2（安全のため）＋81920（単位：バイト）

ただし，一つのジャーナルファイルは次の算出式の容量以上にしてください。

（12＋↑（j＋336）／4096）↑×4096（単位：バイト）

（凡例）

j：システムジャーナルサービス定義で指定したjnl_max_datasizeオペランドの指定値

↑↑：小数点以下を切り上げます

上記で求めたジャーナルファイルの総容量を二つ以上のジャーナルファイルに分けて割り当てた場合，オンラインを終了するまでジャーナルをアンロードする必要はありません。しかし，実際にこのジャーナルファイル総容量を割り当てることができない場合は，この総容量の1／n（n>0）の容量を総容量として，二つ以上のジャーナルファイルに分けて割り当ててください。

ただし，このときも一つのジャーナルファイルの容量は，上記の算出式の容量以上を確保してください。この場合，一つのジャーナルファイルはオンライン終了までにn回再使用されることになり，それだけジャーナルファイルをアンロードする運用が必要になります。

また，ジャーナルファイルの障害に備え，なるべく予約のジャーナルファイルも割り当ててください。予約のジャーナルファイルも上記の算出式に示す容量以上の確保が必要です。

ジャーナルファイルを二重化する場合（システムジャーナルサービス定義のjnl_dualオペランドにYを指定）は，上記に示したジャーナルファイルはすべて二つずつ必要ですので，ジャーナルファイル総容量としては2倍になります。

二重化するジャーナルファイルのペアは，同じ容量にしてください。異なる容量であってもOpenTP1は動作しますが，ジャーナルファイル容量としては小さい方の容量で動作することになり，むだな領域が発生します。

表H-4　1トランザクション当たりのジャーナル量

分類
条件
ジャーナルレコード長
変数の説明
条件に一致したときに取得されるジャーナルレコード種別

固有部
1トランザクションブランチごとに無条件
672＋56×tb＋40×tr＋1216×（tc＋tu）＋8×（ts＋tt＋tu）＋224×tx＋208×ty＋1384×（tz＋tv）
tb：発行済みトランザクショナルRPC数
tr：アクセス済みRM数
tc：発行済みCRM経由RPC数
ts：tb=0の場合0，tb>0の場合1
tt：tr=0の場合0，tr>0の場合1
tu：tc=0でかつCRM経由RPCで呼ばれてトランザクションを開始したブランチでない場合0，tc>0またはCRM経由RPCで呼ばれてトランザクションを開始したブランチの場合1
tx：UJ取得後のRPC発行回数
ty：UJ取得後初めてアクセスするRM数
tz：UJ取得後のCRM経由RPC発行数
tv：tu=1またはtz=0の場合0，tu=0かつtz>0の場合1
cj，hj，pj，tj

UAP履歴情報を取得する場合
UAP履歴情報を取得しているトランザクションブランチの場合，その取得1回
114＋ul
ul：UAP履歴情報長
uj

DAMを使用している場合
トランザクション内でDAMファイルを更新する場合，そのトランザクションブランチごと
128＋Σ（24＋du）
du：DAMファイルのブロック長
Σ：該当トランザクションブランチでの更新の総和
fj

DAMサービス定義のdam_update_block_overオペランドでflushを指定している場合，トランザクション内でDAMファイルを更新するとき，そのトランザクションブランチでDAMファイルの更新件数が一括更新ブロック数（DAMサービス定義のdam_update_blockオペランドの指定値）を超えるごと
128＋Σ（24＋du×2）
du：DAMファイルのブロック長
Σ：該当トランザクションブランチでの更新件数（前回ジャーナル出力後からの更新件数）
fj

DAMサービス定義のdamfile定義コマンドの-dオプションを指定した場合，このオプションを指定したDAMファイルを更新したとき
DAMサービス定義のdam_io_intervalオペランドの指定値の間隔およびチェックポイントダンプの有効化完了時ごと
64×2
－
xj

オンラインバックアップ（dambkupコマンドの-oオプション指定）を実行するごと
64
－
xj

TAMを使用している場合
トランザクション内でTAMファイルを更新する場合，そのトランザクションブランチごと
128＋Σ（64＋tu×2）
tu：TAMファイルのレコード長
Σ：該当トランザクションブランチでの更新の総和
cj

MCFを使用している場合
MCF通信構成定義のmcftalcle -o aj=yesを指定した論理端末にメッセージを送信し，その送信完了するごと（通信プロセスで）
176
－
aj

トランザクション内のUAPプロセスから出力論理端末へ出力通番指定の論理メッセージを送信するごと
160
－
cj

トランザクション外（mcfaalcap -n trnmode=notrnを指定）のUAPプロセスから出力端末へ出力通番指定の論理メッセージを送信するごと
128
－

通信プロセスで論理メッセージを受信するごと
↑｛88＋24×（↑mc／ql↑）＋mc※1｝／4↑×4
mc：受信した論理メッセージの長さ
ql：キューファイル物理レコード長

通信プロセスで論理メッセージを送信するごと
112
－

トランザクションブランチ完結ごと
↑｛260＋24×Sn＋Σ（24×（↑mc／ql↑））＋Σmc※2｝／4↑×4
mc：送信した論理メッセージの長さ
ql：キューファイル物理レコード長
Sn：該当トランザクションで受信した論理メッセージ数
Σ：該当トランザクションで送信した論理メッセージの総和

通信プロセスでDISKキューを使用して出力通番指定の論理メッセージを送信するごと
144
－

mcfallcap -j gj=yesを指定したアプリケーション（MHPサービス）からメッセージ受信を行うごと
↑（204＋mg）／4↑×4
mg：受信するメッセージセグメント長
gj

通信プロセスでmcfallcap -j ij=yesを指定したアプリケーションに対応するメッセージを受信するごと
Σ（↑（172＋si）／4↑×4）
si：単一セグメントの場合は入力メッセージ長と同じ値
複数セグメントの場合はおのおののセグメント長と同じ値
Σ：セグメント対応にジャーナルを取得するためその総和
ij

mcftactmjコマンドが実行された論理端末にmcftdctmjコマンドが実行されるまでの間に通信プロセスでその論理端末にメッセージを受信およびメッセージを送信するごと
Σ（↑（180＋sm）／4↑×4）
sm：単一セグメントの場合は受信または送信メッセージ長と同じ値
複数セグメントの場合はおのおののセグメント長と同じ値
Σ：セグメント対応にジャーナルを取得するためその総和
mj

SPPの場合：アプリケーションプログラムの起動，メッセージの再送，メッセージの送信を行うごと
MHPの場合：mcfallcap -j oj=yesを指定したアプリケーション（MHPサービス）からアプリケーションプログラムの起動，応答メッセージの送信，メッセージの再送，メッセージの送信を行うごと
↑（204＋mo）／4↑×4
mo：送信するメッセージセグメント長
oj

統計情報
トランザクションサービス定義のtrn_tran_statisticsオペランドにYを指定，またはtrnsticsコマンドの-sオプションを実行（統計情報の取得は次のトランザクションから）した場合，ユーザサービス定義のtrn_statistics_itemオペランドにnone以外を指定しているトランザクションごと
276
－
sj

ISAMを使用している場合
トランザクション内でISAMファイルを更新する場合，トランザクションブランチごと
104＋Σ1(52)
＋Σ2(40＋iu×2)
＋Σ3(40)
＋Σ4(32＋iu)
＋Σ5(24)
iu：ISAMファイルのレコード長
Σ1：該当トランザクションブランチでのオープン，クローズ関数の発行の総和
Σ2：該当トランザクションブランチでのレコード更新関数の発行の総和
Σ3：該当トランザクションブランチでのロック関数の発行の総和
Σ4：該当トランザクションブランチでのレコード追加関数の発行の総和
Σ5：該当トランザクションブランチでのレコード削除関数の発行の総和
fj

（凡例）

－：該当しません。

注※1

メッセージキューサービス定義のque_io_maxrecsizeオペランドの指定値がmcよりも大きい場合，加算してください。

注※2

メッセージキューサービス定義のque_io_maxrecsizeオペランドの指定値がΣmcよりも大きい場合，加算してください。

表H-5　dcstatsコマンドによって取得する統計情報のジャーナル量

分類
条件
ジャーナルレコード長
変数の説明
条件に一致したときに取得されるジャーナルレコード種別

統計情報
dcstatsコマンドの実行によって，システム統計情報のジャーナル出力開始から-rオプションを指定したdcstatsコマンドの実行までの間にdcstatsコマンドのmオプションで指定した時間間隔ごと
（80＋ak×24）×as
ak：dcstatsコマンドの-kに指定した統計情報種別を次に示す値に置き換えたときの和（ただし，-kを省略した場合は117）
rpc：4
lck：3
prc：3
nam：3
que：11
scd：4
mcf：5
mqa：12
dam：9
tam：6
trn：2
cpd：2
jnl：21
osl：19
ist：7
xat：3
as：dcstatsコマンドに-aを指定した場合は，全ユーザサーバ数＋1
dcstatsコマンドに-sを指定した場合は，dcstatsコマンドに指定したユーザサーバ数＋1
dcstatsコマンドに-aオプション，または-sオプションを指定しない場合で，dcstatsコマンドにユーザサーバを指定したときは指定したユーザサーバ数，指定しないときは1
sj

表H-6　RPC1回当たりのジャーナル量

分類 | 条件 | ジャーナルレコード長 | 変数の説明 | 条件に一致したときに取得されるジャーナルレコード種別
統計情報 | システム共通定義のrpc_delay_statisticsオペランドにYを指定している場合RPCごと | 80 | － | sj
ユーザサービス定義のrpc_response_statisticsオペランドにYを指定している場合RPCごと | 272×2 | －

（凡例）

－：該当しません。

付録H.3　チェックポイントダンプファイルのサイズの見積もり式

チェックポイントダンプファイルのサイズの見積もり方法を次に示します。

表H-7　チェックポイントダンプファイルのサイズ

項目
チェックポイントダンプファイルのサイズ
（単位：バイト）

MCFサービス
（↑Sz1／4096↑＋3）×4096

トランザクションジャーナルサービス
（↑Sz2／4096↑＋3）×4096

（凡例）

↑↑：小数点以下を切り上げます

Sz2：（640×（rm数＋1）＋64×Br）×Tr

Cn：MCFマネジャ定義のmcfmcomn定義コマンドの-nオプションで指定した出力通番使用論理端末数

Pn：メッセージキューサービス定義で指定した物理ファイルの数

Pr：queinitコマンドの-nオプションで指定したレコード数

Br：トランザクションサービス定義のtrn_max_subordinate_countオペランドで指定した1トランザクション当たりの最大接続分岐数

rm数：リソースマネジャ数（OpenTP1のRMだけ）

Tr：トランザクションサービス定義のtrn_tran_process_countオペランドで指定したトランザクションブランチ数

なお，アーカイブジャーナルノードでは，チェックポイントダンプファイルは必要ありません。

TP1/Message Queueが使用するチェックポイントダンプファイル容量については，マニュアル「TP1/Message Queue 使用の手引」または「リリースノート」を参照してください。

付録H.4　アーカイブジャーナルファイルのサイズの見積もり式

アーカイブジャーナルファイルの容量の見積もり方法を次に示します。

まず，次の算出式でアーカイブジャーナルファイルへアーカイブするジャーナルの総量を求めます。

Σ（個々の被アーカイブノードがオンライン中に発生するジャーナル総量）（単位：バイト）

個々の被アーカイブノードがオンライン中に発生するジャーナル総量については，「付録H.2　システムジャーナルファイルのサイズの見積もり式」を参照してください。各ノードのシステムジャーナルファイルの容量を見積もった値を使用します。

実際に用意するアーカイブジャーナルファイルの総容量の算出式を次に示します。

アーカイブジャーナルファイルへアーカイブするジャーナルの総量×1.2（安全のため）＋16384（単位：バイト）

ただし，一つのアーカイブジャーナルファイルは次に示す算出式に示す容量以上にしてください。

（4＋256×このアーカイブジャーナルファイルへアーカイブする被アーカイブノードの数）×4096（単位：バイト）

上記で求めたジャーナルファイルの総容量を二つ以上のジャーナルファイルに分けて割り当てた場合，オンラインが終了するまでジャーナルをアンロードする必要がなくなります。なお，実際にこのアーカイブジャーナルファイルの総容量を割り当てることができない場合は，この総容量の1／n（n>0）の容量を総容量とし，二つ以上のアーカイブジャーナルファイルに分けて割り当ててください。このとき，一つのアーカイブジャーナルファイルはオンライン終了までにn回使用されることになり，それだけアーカイブジャーナルファイルをアンロードする運用が必要になります。

また，アーカイブジャーナルファイルの障害に備え，なるべく予約してあるアーカイブジャーナルファイルも割り当ててください。予約してあるアーカイブジャーナルファイルも上記の算出式（一つのアーカイブジャーナルファイルの算出式）以上の容量を確保してください。

なお，一つのアーカイブジャーナルファイルはファイルグループになります。すなわち，一つのアーカイブジャーナルファイルの容量とは，ファイルグループの容量を表しています。

アーカイブジャーナルファイルを二重化する場合（アーカイブジャーナルサービス定義のjnl_dualオペランドにYを指定）は，アーカイブジャーナルファイルがすべて二つ必要です。このため，アーカイブジャーナルファイルの総容量は2倍になります。二重化するアーカイブジャーナルファイルのペアは，同じ容量にしてください。それぞれが異なる容量であってもOpenTP1は動作しますが，アーカイブジャーナルファイルとしては小さい方の容量で動作することになり，残りがむだになります。

アーカイブジャーナルファイルの並列アクセス機能を使用しない場合は，ファイルグループの容量がそのまま物理ファイルの容量になります。

アーカイブジャーナルファイルの並列アクセス機能を使用する場合は，ファイルグループの容量を1／m※（m※>1）にしたアーカイブジャーナルファイルが，ファイルグループごとに最小分散数以上必要です。このときの物理ファイルの容量は，要素ファイルの容量になります。

注※

mはアーカイブジャーナルサービス定義のjnl_max_file_dispersionオペランドの指定値（並列アクセス化する場合の最大分散数）です。

付録H.5　DAMファイルのサイズの見積もり式

DAMファイルのサイズの見積もり式について説明します。

DAMファイルの最大サイズは，次に示す計算式を満たす最大値になります。

DAMファイルの最大サイズ=F-D>0を満たす最大値

F=Msize×1048576－［4096＋2×｛↑64×Fnum／Ssize↑×Ssize＋↑（12×Fnum＋28）／Ssize↑×Ssize＋↑16008／Ssize↑×Ssize｝］

D=（Blen＋8）×（Bnum＋1）

（凡例）

Msize：filmkfsコマンドの-nオプションの指定値

Fnum：filmkfsコマンドの-lオプションの指定値

Ssize：filmkfsコマンドの-sオプションの指定値

Blen：作成するDAMファイルブロック長（単位：バイト）

Bnum：作成するDAMファイルブロック数

↑↑：小数点以下を切り上げます

damloadコマンドのコマンド引数には，上記の計算式を満たすBlen（ブロック長），およびBnum（ブロック数）を指定してください。

DAMファイルのうち，ユーザが使用できるサイズは，Blen（ブロック長）×Bnum（ブロック数）（単位：バイト）になります。

付録H.6　TAMファイルのサイズの見積もり式

TAMファイルのサイズの見積もり式について説明します。

TAMファイルは，レコードのデータ部以外に，管理部およびインデクス部が存在します。そのため，TAMファイルのサイズを算出する場合，管理部およびインデクス部のサイズも考慮する必要があります。また，インデクスタイプ（ツリー形式またはハッシュ形式）によってもサイズが異なります。

次にTAMファイルサイズ算出式を示します。

管理部サイズ＋インデクス部サイズ＋データ部サイズ

（凡例）

管理部サイズ

OpenTP1ファイルシステムのセクタ長

インデクス部サイズ（ツリー形式の場合）

↑s（（↑w（152＋キー長）↑w）×最大レコード数）↑s

インデクス部サイズ（ハッシュ形式の場合）

↑s（（↑w（152＋キー長）↑w）×（M＋N））↑s

データ部サイズ（ツリー形式の場合）

↑s（（レコード長※＋5）×最大レコード数）↑s

データ部サイズ（ハッシュ形式の場合）

↑s（（レコード長※＋5）×（M＋N））↑s

M

最大レコード数×ハッシュエントリ使用率の計算結果を整数値に切り下げたもの（ただし，1未満となる場合は1）

N

最大レコード数－1

S

OpenTP1ファイルシステムのセクタ長

↑s↑s

OpenTP1ファイルシステムのセクタ長の整数倍に切り上げた値

↑w↑w

32ビットの場合：4の整数倍に切り上げた値

64ビットの場合：8の整数倍に切り上げた値

注※

レコード長の単位：バイト

付録I　レコードロック数の見積もり式

OpenTP1ではオンラインで使用するファイルの排他管理のため，ロックを行っています。ロックをするとOpenTP1システム内にレコードロックが登録されます。レコードロックに登録できる数については，maxuprc×nofiles×ユーザライセンス数になります。

OpenTP1で登録するレコードロック数の見積もり式を次に示します。

アーカイブジャーナルノードでない場合

ジャーナルファイル数＋ステータスファイル数
＋各ユーザサーバプロセスでオープンするDAMファイルの合計
＋各プロセスでアクセスするキュー物理ファイル数の合計
＋同時実行ユーザサーバ数
＋トランザクションサービス定義のtrn_recovery_process_countオペランドの指定値＋3
＋TAMファイルの合計×2
＋TP1/Message Queueのキューファイル数×2

アーカイブジャーナルノードの場合

ジャーナルファイル数＋ジャーナルサーバリソースグループ数＋ステータスファイル数＋3

（凡例）

ジャーナルファイル数

システムジャーナルサービス定義，またはアーカイブジャーナルサービス定義のどちらか一方，およびチェックポイントダンプサービス定義のjnladdpfコマンドの数の和（二重化の場合は2倍）

ステータスファイル数

ステータスサービス定義のsts_file_name_[1～7]オペランドに指定した数

各ユーザサーバプロセスでオープンするDAMファイルの合計（i：ユーザサーバプロセスの数）

各プロセスでアクセスするキュー物理ファイル数の合計（j：MCF通信サーバの数，k：ユーザサーバの数）

ジャーナルサーバのリソースグループ数

グローバルアーカイブジャーナルサービス定義の定義コマンドjnldfsv -aで指定したリソースグループ数

付録J　UNIXのメッセージ送受信関数で使用する資源の見積もり式

OpenTP1では，ユーザサーバのスケジュール，性能検証用トレースデータの入出力処理，およびジャーナルファイルへのジャーナルデータの入出力処理にUNIXのメッセージ送受信関数（msgsnd関数，msgrcv関数のシステムコールによるプロセス間通信機能）を使用しています。

OpenTP1で使用される各資源の見積式を次に示します。必要に応じて，各資源に対応するシステムパラメタを修正してください。なお，システムパラメタ名については，「リリースノート」，およびOSのマニュアルを参照してください。

資源
被アーカイブノード
アーカイブノード

メッセージIDの数
分散数×JDUAL＋SVMAX＋PRFNUM＋7
マルチOpenTP1環境の場合は，算出結果にOpenTP1環境の数を乗算してください。
[図データ]　

1メッセージのサイズ
56バイト
56バイト

メッセージID当たりの最大待ち合わせメッセージの総バイト数
次に示す計算式Aまたは計算式Bによって求めた値のうち，大きい方の値を設定してください。

計算式A

56×システムジャーナルファイルのファイルグループ数×分散数×JDUAL

計算式B

（PROC＋1サービスグループに対して，同時に発生するサービス要求の最大数＋同時に異常終了するサーバプロセス数＋4）×56

56×アーカイブジャーナルファイルのファイルグループ数×分散数×JDUAL

OpenTP1のすべてのメッセージのうちの最大待ち合わせメッセージ数
（PROC×2＋a＋2＋PRFNUM×8）＋同時に異常終了するサーバプロセス数
マルチOpenTP1環境の場合は，算出結果にOpenTP1環境の数を乗算してください。
アーカイブジャーナルファイルのファイルグループ数×分散数×JDUAL＋19

（凡例）

分散数：システムジャーナルサービス定義，またはアーカイブジャーナルサービス定義のjnl_max_file_dispersionオペランドの指定値

SVMAX：スケジュールサービス定義のscd_server_countオペランドの指定値

PRFNUM：システム共通定義のprf_traceオペランドの指定値がYの場合は9，指定値がNの場合は0

JDUAL：システムジャーナルサービス定義のjnl_dualオペランドの指定値がYの場合は2，指定値がNの場合は1

r：グローバルアーカイブジャーナルサービス定義のjnldfsv定義コマンドの-aオプションで指定したリソースグループ数

PROC：プロセスサービス定義のprc_recovery_residentオペランドの指定値がYの場合は1，指定値がNの場合は起動するユーザサーバ数

a：OpenTP1に対して同時に発生するサービス要求の最大数=（同時に発生するサービス要求の最大数×SPP数）＋（システムジャーナルファイルのファイルグループ数×分散数×JDUAL）

付録K　OpenTP1ファイルシステムの見積もり式

OpenTP1ファイルシステムとして割り当てる容量は，filmkfsコマンドの-nオプションで指定します。OpenTP1ファイルシステムの見積もり式を次に示します。

↑（（T＋（t×2×s）＋4096＋2×（↑s（64×L）↑s＋↑s（12×L＋28）↑s＋↑s（16008）↑s））／（1024×1024））↑

（凡例）

↑↑：小数点以下を切り上げます

T：各OpenTP1ファイルの容量の合計値

t：Tのファイル数

s：filmkfsコマンドの-sオプションで指定する値（UNIXファイルの場合は512）

↑s↑s：filmkfsコマンドの-sオプションで指定する値（UNIXファイルの場合は512）の整数倍に切り上げた値

L：filmkfsコマンドの-lオプションで指定する値

OpenTP1ファイルの容量は，次の表に示す各OpenTP1ファイルの算出式の合計値です。

算出式には，OpenTP1ファイルの作成時に付加される管理情報（2セクタ長分の領域）が含まれていません。したがって，実際に作成されたときのファイル容量は算出結果に2セクタ長分を加えた値になります。

表K-1　OpenTP1ファイル容量の算出式

OpenTP1ファイル名
OpenTP1ファイル容量の算出式
（単位：バイト）

ステータスファイル
stsinitの-sオプションで指定した値×stsinitの-cオプションで指定した値

システムジャーナルファイル

チェックポイントダンプファイル

アーカイブジャーナルファイル

トランザクションリカバリファイル

サーバリカバリジャーナルファイル

jnlinitコマンドの-nオプションで指定した値×4096＋12288

ノードリストファイル
94208（バイト)

DAMファイル
（damloadコマンドで指定したブロック数＋1）×（damloadコマンドで指定したブロック長＋8）

TAMファイル

ツリー形式の場合

S＋↑s（（↑w（152＋L）↑w）×M）↑s＋↑s（（R＋5）×M）↑s

ハッシュ形式の場合

S＋↑s（（↑w（152＋L）↑w）×（T＋M－1））↑s＋↑s（（R＋5）×（T＋M－1））↑s

メッセージキューファイル
queinitコマンドの-sオプションで指定した値×queinitコマンドの-nオプションで指定した値

XARファイル
xarinitコマンドの-nオプションで指定した値×xarinitコマンドの-sオプションで指定した値（xarinitコマンドの-sオプションの指定を省略した場合は，OpenTP1ファイルシステムのセクタ長）

MQAファイル
キューファイル容量の見積もり方法については，マニュアル「TP1/Message Queue 使用の手引」を参照してください。

ISAMファイル
ファイル容量の求め方については，マニュアル「索引順編成ファイル管理 ISAM」を参照してください。

（凡例）

S：OpenTP1ファイルシステムのセクタ長（UNIXファイルの場合512）

↑s↑s：Sの整数倍に切り上げた値

↑w↑w：4の整数倍に切り上げた値

L：tamcreコマンドの-lオプションで指定した値

M：tamcreコマンドの-mオプションで指定した値

R：tamcreコマンドの-rオプションで指定した値

T：M×U／100の計算結果を整数値に切り下げた値（ただし，1未満となる場合はM=1）

U：tamcreコマンドの-uオプションで指定した値

付録L　性能検証用トレース情報の取得・解析

OpenTP1では，性能検証およびトラブルシュートの効率向上を目的として，性能検証用トレース情報を取得しています。

ここでは，性能検証用トレース情報の取得，取得例，および解析例について説明します。

＜この節の構成＞

付録L.1　性能検証用トレースの取得情報

付録L.2　性能検証用トレース情報の取得例

付録L.3　性能検証用トレース情報の解析例

付録L.1　性能検証用トレースの取得情報

ここでは，性能検証用トレース情報とMCF性能検証用トレース情報の取得タイミングと，イベントID別の取得内容について説明します。また，MCF性能検証用トレース情報については，MCF固有のダンプ出力情報についても説明します。

＜この項の構成＞

(1)　性能検証用トレース情報の取得

(2)　MCF性能検証用トレース情報の取得

(1)　性能検証用トレース情報の取得

OpenTP1は，次の表のイベントIDで示すタイミングでトレース情報を取得します。また，次の表には，1トランザクションで必要なトレースデータ長も示しています。

表L-1　性能検証用トレース情報の取得タイミング

イベントID
タイミング
トレースデータ長
（単位：バイト）

0x0001～0x0040
dc_prf_utrace_put関数発行時
320

0x1000
dc_rpc_call関数での，サービス要求の送信直前
192

0x1001
dc_rpc_mainloop関数での，サービス関数を呼び出す前
192

0x1002
dc_rpc_mainloop関数での，サービス関数がリターンしたあと
64

0x1003
dc_rpc_mainloop関数での，クライアントに応答を返信した直後
128

0x1004
dc_rpc_call関数がリターンする直前
同期，非同期，非応答にかかわりなく取得します。
192

0x1005
非同期rpcの応答メッセージを受け付けたとき
192

0x1006
dc_rpc_poll_any_replies関数の入り口
64

0x1007
dc_rpc_poll_any_replies関数のリターン直前
128

0x1008
dc_rpc_discard_further_replies関数の受信メッセージ破棄時
192

0x1009
dc_rpc_discard_specific_reply関数の受信メッセージ破棄時
192

0x2000
サービス関数が同一ノードの場合，サービス関数のプロセスへの連絡（msgsnd）の前
192

0x2001
サービス関数が別ノードの場合，サーバノードへ送信する直前
128

0x2002
送信されたサービス要求を受信するとき
128

0x2003
サービス関数のプロセスへの連絡（msgsnd）の前
192

0x2004
他ノードへ転送する場合
（このノードにサービス要求がありましたが，サービス関数が実行できない状態にあり，別ノードに転送する場合）
128

0x2005
スケジュールキューからサービス要求を取り出した直後
192

0x2007
他ノードから転送されたサービス要求を受信したとき
128

0x4000
プリペアメッセージの送信時
256

0x4001
プリペアメッセージの受信時
192

0x4002
プリペア完了メッセージの送信時
256

0x4003
プリペア完了メッセージの受信時
192

0x4004
コミットメッセージの送信
256

0x4005
コミットメッセージの受信
192

0x4006
コミット完了メッセージの送信
256

0x4007
コミット完了メッセージの受信
192

0x4008
ロールバックメッセージの送信
256

0x4009
ロールバックメッセージの受信
192

0x400a
ロールバック完了メッセージの送信
256

0x400b
ロールバック完了メッセージの受信
192

0x400c
リードオンリーメッセージの送信
256

0x400d
リードオンリーメッセージの受信
192

0x400e
リカバリメッセージの送信
256

0x400f
リカバリメッセージの受信
192

0x4010
リカバリ応答メッセージの送信
256

0x4011
リカバリ応答メッセージの受信
192

0x4012
アドレス解決メッセージの送信
256

0x4013
アドレス解決メッセージの受信
192

0x4014
RMスレッドメッセージの送信
256

0x4015
RMスレッドメッセージの受信
192

0x4016
ヒューリスティックメッセージの送信
256

0x4017
ヒューリスティックメッセージの受信
192

0x4018
リソースマネジャ接続先選択関数（dc_trn_rm_select関数）がリターンする直前
128

0x4100
トランザクションの開始時
192

0x4150
トランザクションの終了時
192

0x4a00
トランザクションブランチの開始要求呼び出し直後
128

0x4a01
トランザクションブランチの開始要求リターン直前
128

0x4a02
トランザクションブランチ内からのRPC実行要求呼び出し直後
128

0x4a03
トランザクションブランチ内からのRPC実行要求リターン直前
128

0x4a04
トランザクションブランチの終了要求呼び出し直後
128

0x4a05
トランザクションブランチの終了要求リターン直前
128

0x4a06
トランザクションブランチのコミット準備要求呼び出し直後
128

0x4a07
トランザクションブランチのコミット準備要求リターン直前
128

0x4a08
トランザクションブランチのコミット要求呼び出し直後
128

0x4a09
トランザクションブランチのコミット要求リターン直前
128

0x4a0a
トランザクションブランチのロールバック要求呼び出し直後
128

0x4a0b
トランザクションブランチのロールバック要求リターン直前
128

0x4a0c
Prepared状態，Heuristically Completed状態のトランザクションブランチ通知要求呼び出し直後
64

0x4a0d
Prepared状態，Heuristically Completed状態のトランザクションブランチ通知要求リターン直前
64

0x4a0e
Heuristically Completed状態のトランザクションブランチ破棄要求呼び出し直後
128

0x4a0f
Heuristically Completed状態のトランザクションブランチ破棄要求リターン直前
128

0x4b00
トランザクションブランチの開始直前
64

0x4b01
トランザクションブランチの開始直後
64

0x4b02
トランザクションブランチ内からのRPC実行直前
64

0x4b03
トランザクションブランチ内からのRPC実行直後
64

0x4b04
トランザクションブランチの終了直前
64

0x4b05
トランザクションブランチの終了直後
64

0x4b06
トランザクションブランチのコミット準備直前
64

0x4b07
トランザクションブランチのコミット準備直後
64

0x4b08
トランザクションブランチのコミット直前
64

0x4b09
トランザクションブランチのコミット直後
64

0x4b0a
トランザクションブランチのロールバック直前
64

0x4b0b
トランザクションブランチのロールバック直後
64

0x4b0c
Prepared状態，Heuristically Completed状態のトランザクションブランチ通知直前
64

0x4b0d
Prepared状態，Heuristically Completed状態のトランザクションブランチ通知直後
64

0x4b0e
Heuristically Completed状態のトランザクションブランチ破棄直前
64

0x4b0f
Heuristically Completed状態のトランザクションブランチ破棄直後
64

0x5001
リモートAPI機能使用時，クライアントからのコネクション確立要求受信時
128

0x5002
リモートAPI機能使用時，rapリスナーからrapサーバへのrapサーバ割り当て要求送信前
128

0x5003
rapリスナーからrapサーバへのコネクション引き継ぎ要求受信後
128

0x5004
リモートAPI機能使用時，クライアントからのAPI代理実行要求受信時
128

0x5005
リモートAPI機能使用時，API代理実行応答送信前
128

0x5006
リモートAPI機能使用時，クライアントからのrapサーバ割り当て解除およびコネクション切断要求受信時
128

0x5007
リモートAPI機能使用時，rapサーバからの rapサーバ割り当て解除応答受信時
128

0x5008
リモートAPI機能使用時，rapリスナーからrapクライアントへのrapサーバ割当解除応答送信時
128

0x5200
リモートAPI機能使用時，rapサーバがRPC代理実行する直前
128

0x5201
リモートAPI機能使用時，rapサーバがRPC代理実行した直後
128

0x6400
資源の排他の要求受付時
256

0x6401
資源の排他の要求リターン時
256

0x6410
排他待ち直前
128

0x6411
排他待ち解除直後
128

0x6420
資源名指定の排他解除要求受付時
256

0x6421
資源名指定の排他解除要求リターン時
256

0x6430
全資源の排他解除要求受付時
256

0x6431
全資源の排他解除要求リターン時
256

0x6805
OpenTP1ファイルからの入力処理が完了したとき
192

0x6807
OpenTP1ファイルへの出力処理が完了したとき
192

0x6905
OpenTP1ファイルに対して，read()システムコールの処理が完了したとき
192

0x6907
OpenTP1ファイルに対して，write()システムコールの処理が完了したとき
192

0x6909
OpenTP1ファイルに対して，lseek()システムコールの処理が完了したとき
192

0xb001
プロセス生成時（子プロセスで取得）
64

0xb002
プロセス消滅時
64

0xb003
プロセス生成時（親プロセスで取得）
64

0xb010
プロセス生成依頼入り口
64

0xb012

0xb011
プロセス生成依頼出口
64

0xb013

0xb014
プロセス情報登録依頼入り口
64

0xb015
プロセス情報登録依頼出口
64

0xb016
プロセス情報登録依頼入り口（TP1/Resource Manager Monitor用）
64

0xb017
プロセス情報登録依頼出口（TP1/Resource Manager Monitor用）
64

0xb018
プロセス起動完了報告入り口
64

0xb019
プロセス起動完了報告出口
64

0xb01a
プロセス起動完了報告待ち合わせ入り口
64

0xb01b
プロセス起動完了報告待ち合わせ出口
64

0xb01c
プロセス終了報告入り口
64

0xb01d
プロセス終了報告出口
64

0xb01e
プロセス終了報告入り口（TP1/Resource Manager Monitor用）
64

0xb01f
プロセス終了報告出口（TP1/Resource Manager Monitor用）
64

0xb020
プロセス終了報告待ち合わせ入り口
64

0xb021
プロセス終了報告待ち合わせ出口
64

0xb022
プロセス強制停止依頼入り口
64

0xb024

0xb023
プロセス強制停止依頼出口
64

0xb025

0xb026
プロセスサービス終了指示入り口
64

0xb027
プロセスサービス終了指示出口
64

0xb110
プロセス生成プロセスサーバ処理入り口
64

0xb111
プロセス生成プロセスサーバ処理出口
64

0xb114
プロセス情報登録プロセスサーバ処理入り口
64

0xb115
プロセス情報登録プロセスサーバ処理出口
64

0xb118
プロセス起動完了報告プロセスサーバ受付入り口
64

0xb119
プロセス起動完了報告プロセスサーバ受付出口
64

0xb11a
プロセス起動完了報告待ち合わせプロセスサーバ処理入り口
64

0xb11b
プロセス起動完了報告待ち合わせプロセスサーバ処理出口
64

0xb11c
プロセス終了報告プロセスサーバ受付入り口
64

0xb11d
プロセス終了報告プロセスサーバ受付出口
64

0xb120
プロセス終了報告待ち合わせプロセスサーバ処理入り口
64

0xb121
プロセス終了報告待ち合わせプロセスサーバ処理出口
64

0xb122
プロセス強制停止プロセスサーバ処理入り口
64

0xb124

0xb123
プロセス強制停止プロセスサーバ処理出口
64

0xb125

0xb126
プロセスサービス終了処理入り口
64

0xb127
プロセスサービス終了処理出口
64

0xb130
プロセスサービスによる一定間隔定期処理入り口
64

0xb131
プロセスサービスによる一定間隔定期処理出口
64

0xb132
プロセスサービスによるプロセス終了検知処理入り口
64

0xb133
プロセスサービスによるプロセス終了検知処理出口
64

0xc001
ジャーナルレコードヘッダ作成後
128

0xc002
ジャーナルブロックヘッダ作成後
128

0xc101
I/Oプロセスへのメッセージ送信直前
128

0xc102
I/Oプロセスからの応答メッセージを受信した直後
64

0xc103
I/OプロセスへのRPCによるサービス要求直前
128

0xc104
I/OプロセスからのRPC応答を受信した直後
64

0xc201
I/O要求のメッセージを受信した直後
128

0xc202
ジャーナルファイルへの出力処理直前
64

0xc203
ジャーナルファイルへの出力処理直後
64

0xc204
I/O要求プロセスへI/O終了のメッセージを通知する直前
64

0xc205
I/O要求のRPCを受信した直後
128

0xc206
I/O要求プロセスへI/O終了のRPC応答を送信する直前
128

0xc301
ジャーナルバッファリング処理開始時
64

0xc302
ジャーナルバッファリング処理終了時
64

0xc401
ジャーナルバッファの空き待ち直前
64

0xc402
ジャーナルバッファの空き待ち直後
64

0xd000
TP1/Message Queue MQPUTリターン直前
256

0xd001
TP1/Message Queue MQGETリターン直前
256

0xd002
TP1/Message Queue 転送メッセージ登録のリターン直前
256

0xd003
TP1/Message Queue 転送メッセージ取り出しのリターン直前
256

0xf000
ネームサーバが自ノードのプロセスからサービス情報送信要求を受信したあと
128

0xf001
ネームサーバが他ノードへサービス情報を送信する前
128

0xf002
ネームサーバが他ノードへサービス情報を送信したあと
128

0xf003
ネームサーバが他ノードからサービス情報を受信したあと
128

0xf004
ネームサーバが自ノードのプロセスからサービス情報削除要求を受信したあと
128

0xf005
ネームサーバが他ノードへサービス情報削除要求を送信する前
128

0xf006
ネームサーバが他ノードへサービス情報削除要求を送信したあと
128

0xf007
ネームサーバが他ノードからサービス情報削除要求を受信したあと
128

0xf008
ネームサーバが自ノードのプロセスからサービス情報削除要求を受信したあと
64

0xf009
ネームサーバが他ノードへサービス情報削除要求を送信する前
128

0xf00a
ネームサーバが他ノードへサービス情報削除要求を送信したあと
128

0xf00b
ネームサーバが自ノードのプロセスからユーザサーバ負荷情報の変更要求を受信したあと
128

0xf00c
ネームサーバが他ノードへユーザサーバ負荷情報の変更要求を送信する前
128

0xf00d
ネームサーバが他ノードへユーザサーバ負荷情報の変更要求を送信したあと
128

0xf00e
ネームサーバが他ノードからユーザサーバ負荷情報の変更要求を受信したあと
128

0xf010
ネームサーバがサービス情報検索要求を受信したあと
128

0xf011
ネームサーバが他ノードへサービス情報検索要求を送信する前
128

0xf012
ネームサーバが他ノードへサービス情報検索要求を送信したあと
128

0xf013
ネームサーバが他ノードからサービス情報検索要求を受信したあと
128

0xf014
ネームサーバが他ノードへサービス情報検索結果を送信する前
128

0xf015
ネームサーバが他ノードからサービス情報検索結果を受信したあと
128

0xf016
ネームサーバがサービス情報検索結果を送信する前
128

0xf017
ネームサーバが他ノードからサービス情報検索結果を受信したあと
128

0xf018
ネームサーバが他ノードへサービス情報検索要求を送信する前
128

0xf019
ネームサーバが他ノードへサービス情報検索要求を送信したあと
128

0xf01a
ネームサーバが他ノードからサービス情報検索結果を受信したあと
128

0xf020
ネームサーバがRPC実行時のサービス情報検索要求を受信したあと
128

0xf021
ネームサーバが他ノードへRPC実行時のサービス情報検索要求を送信する前
128

0xf022
ネームサーバが他ノードへRPC実行時のサービス情報検索要求を送信したあと
128

0xf023
ネームサーバが他ノードからRPC実行時のサービス情報検索要求を受信したあと
128

0xf024
ネームサーバが他ノードへRPC実行時のサービス情報検索結果を送信する前
128

0xf025
ネームサーバが他ノードからRPC実行時のサービス情報検索結果を受信したあと
128

0xf026
ネームサーバがRPC実行時のサービス情報検索結果を送信する前
128

0xf027
name_global_lookupオペランドにYを指定した場合にネームサーバが他ノードへRPC実行時のサービス情報検索要求を送信する前
128

0xf028
name_global_lookupオペランドにYを指定した場合にネームサーバが他ノードへRPC実行時のサービス情報検索要求を送信したあと
128

0xf029
ネームサーバが他ノードへRPC実行時のサービス情報検索結果を送信する前
128

0xf030
ネームサーバが他ノードへノード情報を送信する前
64

0xf031
ネームサーバが他ノードへノード情報を送信したあと
64

0xf032
ネームサーバが他ノードからノード情報を受信したあと
64

0xf033
コマンドが他ノードへマネジャノード変更通知を送信する前
64

0xf034
コマンドが他ノードへマネジャノード変更通知を送信したあと
128

0xf035
ネームサーバが他ノードからマネジャノード変更通知を受信したあと
64

0xf100
RPC抑止リストからノードを削除したあと
64

0xf101
RPC抑止リストへノードを登録したあと
64

0xf102
サービス情報をグローバルキャッシュから削除したあと（ノード停止検出時）
128

0xf103
サービス情報をグローバルキャッシュへ登録したあと
128

0xf104
サービス情報をグローバルキャッシュから削除したあと（ノード停止検出時以外）
128

0xf105
他ノードで動作しているユーザサーバの負荷情報を変更したあと
128

0xf106
サービス情報検索処理を開始したあと
128

0xf107
サービス情報検索処理を終了する前
128

0xf108
RPC実行時に行うサービス情報検索処理を開始したあと
128

0xf109
RPC実行時に行うサービス情報検索処理を終了する前
128

0xf10c
ノード情報をノードリストに登録したあと
64

0xf10d
ノード情報をノードリストから一時削除したあと
64

0xf10e
ノード情報をノードリストから削除したあと
64

0xf10f
ほかの処理でノード情報が参照されていたため，ノード情報をノードリストから削除しなかったとき
64

0xf110
ネームサーバのノードリストファイルの書き込みが完了したあと
128

0xf111
ネームサーバのノードリストファイルからノードリストの引き継ぎ機能が完了したあと
64

0xf112
ネームサーバがノードリストの引き継ぎ機能を無効にしたあと
64

0xf113
ネームサーバのノードリストファイルをオープンしたあと
128

0xf114
namdオンラインチェックファイルをオープンしたあと
64

0xf200
自ノードのネームサーバへサービス情報送信要求を送信する前
128

0xf201
自ノードのネームサーバへサービス情報送信要求を送信したあと
128

0xf202
自ノードのネームサーバへサービス情報削除要求を送信する前
128

0xf203
自ノードのネームサーバへサービス情報削除要求を送信したあと
128

0xf204
自ノードのネームサーバへサービス情報削除要求を送信する前
64

0xf205
自ノードのネームサーバへサービス情報削除要求を送信したあと
64

0xf206
自ノードのネームサーバへユーザサーバの負荷情報変更要求を送信する前
128

0xf207
自ノードのネームサーバへユーザサーバの負荷情報変更要求を送信したあと
128

0xf210
自ノードのネームサーバへサービス情報検索要求を送信する前
128

0xf211
自ノードのネームサーバへサービス情報検索要求を送信したあと
128

0xf212
自ノードのネームサーバからサービス情報検索結果を受信したあと
128

0xf213
自ノードのネームサーバへサービス情報検索要求を送信する前
128

0xf214
自ノードのネームサーバへサービス情報検索要求を送信したあと
128

0xf215
自ノードのネームサーバからサービス情報検索結果を受信したあと
128

0xf216
RPC実行時，自ノードのネームサーバへサービス情報検索要求を送信する前
128

0xf217
RPC実行時，自ノードのネームサーバへサービス情報検索要求を送信したあと
128

0xf218
RPC実行時，自ノードのネームサーバからサービス情報検索結果を受信したあと
128

0xf219
ノードリストファイルをオープンする前
128

0xf21a
ノードリストファイルをオープンしたあと
128

0xf21b
ノードリストファイルを読み込む前
64

0xf21c
ノードリストファイルの読み込みが完了したあと
128

0xf21d
ノードリストファイルの書き込み前
128

0xf21f
ノードリストファイルのクローズ前
64

0xf220
ノードリストファイルのクローズしたあと
64

イベントID別の取得内容を，次の表に示します。

表L-2　イベントID別の取得内容（性能検証用トレース）

イベントID
クライアント
OpenTP1識別子
クライアント通信番号
サーバOpenTP1識別子
ルートOpenTP1識別子
ルート通信番号
サービスグループ名
サービス名
リターンコード
グローバルトランザクション識別子
キュー名
メッセージトークン
メッセージ識別子

0x1000
○
○
○
○
○
○
○
－
－
－
－
－

0x1001
○
○
－
○
○
○
○
－
－
－
－
－

0x1002
○
○
－
○
○
－
－
○
－
－
－
－

0x1003
○
○
－
○
○
－
－
○
－
－
－
－

0x1004
○
○
○
○
○
○
○
○
－
－
－
－

0x1005
○
○
○
○
○
○
○
－
－
－
－
－

0x1006
○
－
－
○
○
－
－
－
－
－
－
－

0x1007
○
○
－
○
○
－
－
○
－
－
－
－

0x1008
○
○
○
○
○
○
○
－
－
－
－
－

0x1009
○
○
○
○
○
○
○
○
－
－
－
－

0x2000
○
○
－
○
○
－
－
－
－
－
－
－

0x2001
○
○
○
○
○
－
－
－
－
－
－
－

0x2002
○
○
－
○
○
○
○
－
－
－
－
－

0x2003
○
○
－
○
○
－
－
－
－
－
－
－

0x2004
○
○
○
○
○
－
－
－
－
－
－
－

0x2005
○
○
－
○
○
－
－
－
－
－
－
－

0x2007
○
○
－
○
○
○
○
－
－
－
－
－

0x4000
○
○
○
○
－
－
－
○
○
－
－
－

0x4001
○
○
－
○
－
－
－
○
○
－
－
－

0x4002
○
○
○
○
－
－
－
○
○
－
－
－

0x4003
○
○
－
○
－
－
－
○
○
－
－
－

0x4004
○
○
○
○
－
－
－
○
○
－
－
－

0x4005
○
○
－
○
－
－
－
○
○
－
－
－

0x4006
○
○
○
○
－
－
－
○
○
－
－
－

0x4007
○
○
－
○
－
－
－
○
○
－
－
－

0x4008
○
○
○
○
－
－
－
○
○
－
－
－

0x4009
○
○
－
○
－
－
－
○
○
－
－
－

0x400a
○
○
○
○
－
－
－
○
○
－
－
－

0x400b
○
○
－
○
－
－
－
○
○
－
－
－

0x400c
○
○
○
○
－
－
－
○
○
－
－
－

0x400d
○
○
－
○
－
－
－
○
○
－
－
－

0x400e
○
○
○
○
－
－
－
○
○
－
－
－

0x400f
○
○
－
○
－
－
－
○
○
－
－
－

0x4010
○
○
○
○
－
－
－
○
○
－
－
－

0x4011
○
○
－
○
－
－
－
○
○
－
－
－

0x4012
○
○
○
○
－
－
－
○
○
－
－
－

0x4013
○
○
－
○
－
－
－
○
○
－
－
－

0x4014
○
○
○
○
－
－
－
○
○
－
－
－

0x4015
○
○
－
○
－
－
－
○
○
－
－
－

0x4016
○
○
○
○
－
－
－
○
○
－
－
－

0x4017
○
○
－
○
－
－
－
○
○
－
－
－

0x4018
－
－
－
－
－
○
－
○
－
－
－
－

0x4100
○
－
－
○
－
－
－
－
○
－
－
－

0x4150
○
－
－
○
－
－
－
○
○
－
－
－

0x4a00
－
－
－
－
－
－
－
－
－
－
－
－

0x4a01
－
－
－
－
－
－
－
○
－
－
－
－

0x4a02
－
－
－
－
－
－
－
－
－
－
－
－

0x4a03
－
－
－
－
－
－
－
○
－
－
－
－

0x4a04
－
－
－
－
－
－
－
－
－
－
－
－

0x4a05
－
－
－
－
－
－
－
○
－
－
－
－

0x4a06
－
－
－
－
－
－
－
－
－
－
－
－

0x4a07
－
－
－
－
－
－
－
○
－
－
－
－

0x4a08
－
－
－
－
－
－
－
－
－
－
－
－

0x4a09
－
－
－
－
－
－
－
○
－
－
－
－

0x4a0a
－
－
－
－
－
－
－
－
－
－
－
－

0x4a0b
－
－
－
－
－
－
－
○
－
－
－
－

0x4a0c
－
－
－
－
－
－
－
－
－
－
－
－

0x4a0d
－
－
－
－
－
－
－
○
－
－
－
－

0x4a0e
－
－
－
－
－
－
－
－
－
－
－
－

0x4a0f
－
－
－
－
－
－
－
○
－
－
－
－

0x4b00
－
－
－
－
－
－
－
－
－
－
－
－

0x4b01
－
－
－
－
－
－
－
○
－
－
－
－

0x4b02
－
－
－
－
－
－
－
－
－
－
－
－

0x4b03
－
－
－
－
－
－
－
○
－
－
－
－

0x4b04
－
－
－
－
－
－
－
－
－
－
－
－

0x4b05
－
－
－
－
－
－
－
○
－
－
－
－

0x4b06
－
－
－
－
－
－
－
－
－
－
－
－

0x4b07
－
－
－
－
－
－
－
○
－
－
－
－

0x4b08
－
－
－
－
－
－
－
－
－
－
－
－

0x4b09
－
－
－
－
－
－
－
○
－
－
－
－

0x4b0a
－
－
－
－
－
－
－
－
－
－
－
－

0x4b0b
－
－
－
－
－
－
－
○
－
－
－
－

0x4b0c
－
－
－
－
－
－
－
－
－
－
－
－

0x4b0d
－
－
－
－
－
－
－
○
－
－
－
－

0x4b0e
－
－
－
－
－
－
－
－
－
－
－
－

0x4b0f
－
－
－
－
－
－
－
○
－
－
－
－

0x5001
－
○
－
○
○
－
－
－
－
－
－
－

0x5002
－
○
－
○
○
－
－
－
－
－
－
－

0x5003
－
○
－
○
○
－
－
－
－
－
－
－

0x5004
－
○
－
○
○
－
－
－
－
－
－
－

0x5005
－
○
－
○
○
－
－
－
－
－
－
－

0x5006
－
○
－
○
○
－
－
－
－
－
－
－

0x5007
－
○
－
○
○
－
－
○
－
－
－
－

0x5008
－
○
－
○
○
－
－
○
－
－
－
－

0x5200
－
－
－
－
－
－
－
－
－
－
－
－

0x5201
－
－
－
－
－
－
－
○
－
－
－
－

0x6400
－
－
－
－
－
－
－
－
○
－
－
－

0x6401
－
－
－
－
－
－
－
○
○
－
－
－

0x6410
－
－
－
－
－
－
－
－
－
－
－
－

0x6411
－
－
－
－
－
－
－
○
－
－
－
－

0x6420
－
－
－
－
－
－
－
－
○
－
－
－

0x6421
－
－
－
－
－
－
－
○
○
－
－
－

0x6430
－
－
－
－
－
－
－
－
○
－
－
－

0x6431
－
－
－
－
－
－
－
○
○
－
－
－

0x6805
－
－
－
－
－
－
－
○
－
－
－
－

0x6807
－
－
－
－
－
－
－
○
－
－
－
－

0x6905
－
－
－
－
－
－
－
○
－
－
－
－

0x6907
－
－
－
－
－
－
－
○
－
－
－
－

0x6909
－
－
－
－
－
－
－
○
－
－
－
－

0xb001
－
－
－
－
－
－
－
－
－
－
－
－

0xb002
－
－
－
－
－
－
－
－
－
－
－
－

0xb003
－
－
－
－
－
－
－
－
－
－
－
－

0xb010
－
－
－
－
－
－
－
－
－
－
－
－

0xb011
－
－
－
－
－
－
－
－
－
－
－
－

0xb012
－
－
－
－
－
－
－
－
－
－
－
－

0xb013
－
－
－
－
－
－
－
－
－
－
－
－

0xb014
－
－
－
－
－
－
－
－
－
－
－
－

0xb015
－
－
－
－
－
－
－
－
－
－
－
－

0xb016
－
－
－
－
－
－
－
－
－
－
－
－

0xb017
－
－
－
－
－
－
－
－
－
－
－
－

0xb018
－
－
－
－
－
－
－
－
－
－
－
－

0xb019
－
－
－
－
－
－
－
－
－
－
－
－

0xb01a
－
－
－
－
－
－
－
－
－
－
－
－

0xb01b
－
－
－
－
－
－
－
－
－
－
－
－

0xb01c
－
－
－
－
－
－
－
－
－
－
－
－

0xb01d
－
－
－
－
－
－
－
－
－
－
－
－

0xb01e
－
－
－
－
－
－
－
－
－
－
－
－

0xb01f
－
－
－
－
－
－
－
－
－
－
－
－

0xb020
－
－
－
－
－
－
－
－
－
－
－
－

0xb021
－
－
－
－
－
－
－
－
－
－
－
－

0xb022
－
－
－
－
－
－
－
－
－
－
－
－

0xb023
－
－
－
－
－
－
－
－
－
－
－
－

0xb024
－
－
－
－
－
－
－
－
－
－
－
－

0xb025
－
－
－
－
－
－
－
－
－
－
－
－

0xb026
－
－
－
－
－
－
－
－
－
－
－
－

0xb027
－
－
－
－
－
－
－
－
－
－
－
－

0xb110
－
－
－
－
－
－
－
－
－
－
－
－

0xb111
－
－
－
－
－
－
－
－
－
－
－
－

0xb114
－
－
－
－
－
－
－
－
－
－
－
－

0xb115
－
－
－
－
－
－
－
－
－
－
－
－

0xb118
－
－
－
－
－
－
－
－
－
－
－
－

0xb119
－
－
－
－
－
－
－
－
－
－
－
－

0xb11a
－
－
－
－
－
－
－
－
－
－
－
－

0xb11b
－
－
－
－
－
－
－
－
－
－
－
－

0xb11c
－
－
－
－
－
－
－
－
－
－
－
－

0xb11d
－
－
－
－
－
－
－
－
－
－
－
－

0xb120
－
－
－
－
－
－
－
－
－
－
－
－

0xb121
－
－
－
－
－
－
－
－
－
－
－
－

0xb122
－
－
－
－
－
－
－
－
－
－
－
－

0xb123
－
－
－
－
－
－
－
－
－
－
－
－

0xb124
－
－
－
－
－
－
－
－
－
－
－
－

0xb125
－
－
－
－
－
－
－
－
－
－
－
－

0xb126
－
－
－
－
－
－
－
－
－
－
－
－

0xb127
－
－
－
－
－
－
－
－
－
－
－
－

0xb130
－
－
－
－
－
－
－
－
－
－
－
－

0xb131
－
－
－
－
－
－
－
－
－
－
－
－

0xb132
－
－
－
－
－
－
－
－
－
－
－
－

0xb133
－
－
－
－
－
－
－
－
－
－
－
－

0xc001
－
－
－
－
－
－
－
－
－
－
－
－

0xc002
－
－
－
－
－
－
－
－
－
－
－
－

0xc101
－
－
－
－
－
－
－
－
－
－
－
－

0xc102
－
－
－
－
－
－
－
－
－
－
－
－

0xc103
－
－
－
－
－
－
－
－
－
－
－
－

0xc104
－
－
－
－
－
－
－
－
－
－
－
－

0xc201
－
－
－
－
－
－
－
－
－
－
－
－

0xc202
－
－
－
－
－
－
－
－
－
－
－
－

0xc203
－
－
－
－
－
－
－
－
－
－
－
－

0xc204
－
－
－
－
－
－
－
－
－
－
－
－

0xc205
－
－
－
－
－
－
－
－
－
－
－
－

0xc206
－
－
－
－
－
－
－
－
－
－
－
－

0xc301
－
－
－
－
－
－
－
－
－
－
－
－

0xc302
－
－
－
－
－
－
－
－
－
－
－
－

0xc401
－
－
－
－
－
－
－
－
－
－
－
－

0xc402
－
－
－
－
－
－
－
－
－
－
－
－

0xd000
－
－
－
－
－
－
－
○
－
○
○
○

0xd001
－
－
－
－
－
－
－
○
－
○
○
○

0xd002
－
－
－
－
－
－
－
○
－
○
○
○

0xd003
－
－
－
－
－
－
－
○
－
○
○
○

0xf000
－
－
－
－
－
－
－
－
－
－
－
－

0xf001
－
－
－
－
－
－
－
－
－
－
－
－

0xf002
－
－
－
－
－
－
－
○
－
－
－
－

0xf003
－
－
－
－
－
－
－
－
－
－
－
－

0xf004
－
－
－
－
－
－
－
－
－
－
－
－

0xf005
－
－
－
－
－
－
－
－
－
－
－
－

0xf006
－
－
－
－
－
－
－
○
－
－
－
－

0xf007
－
－
－
－
－
－
－
－
－
－
－
－

0xf008
－
－
－
－
－
－
－
－
－
－
－
－

0xf009
－
－
－
－
－
－
－
－
－
－
－
－

0xf00a
－
－
－
－
－
－
－
○
－
－
－
－

0xf00b
－
－
－
－
－
－
－
－
－
－
－
－

0xf00c
－
－
－
－
－
－
－
－
－
－
－
－

0xf00d
－
－
－
－
－
－
－
○
－
－
－
－

0xf00e
－
－
－
－
－
－
－
－
－
－
－
－

0xf010
－
－
－
－
－
－
－
－
－
－
－
－

0xf011
－
－
－
－
－
－
－
－
－
－
－
－

0xf012
－
－
－
－
－
－
－
○
－
－
－
－

0xf013
－
－
－
－
－
－
－
－
－
－
－
－

0xf014
－
－
－
－
－
－
－
－
－
－
－
－

0xf015
－
－
－
－
－
－
－
－
－
－
－
－

0xf016
－
－
－
－
－
－
－
－
－
－
－
－

0xf017
－
－
－
－
－
－
－
－
－
－
－
－

0xf018
－
－
－
－
－
－
－
－
－
－
－
－

0xf019
－
－
－
－
－
－
－
○
－
－
－
－

0xf01a
－
－
－
－
－
－
－
－
－
－
－
－

0xf020
－
－
－
－
－
－
－
－
－
－
－
－

0xf021
－
－
－
－
－
－
－
－
－
－
－
－

0xf022
－
－
－
－
－
－
－
○
－
－
－
－

0xf023
－
－
－
－
－
－
－
－
－
－
－
－

0xf024
－
－
－
－
－
－
－
－
－
－
－
－

0xf025
－
－
－
－
－
－
－
－
－
－
－
－

0xf026
－
－
－
－
－
－
－
－
－
－
－
－

0xf027
－
－
－
－
－
－
－
－
－
－
－
－

0xf028
－
－
－
－
－
－
－
○
－
－
－
－

0xf029
－
－
－
－
－
－
－
－
－
－
－
－

0xf030
－
－
－
－
－
－
－
－
－
－
－
－

0xf031
－
－
－
－
－
－
－
○
－
－
－
－

0xf032
－
－
－
－
－
－
－
－
－
－
－
－

0xf033
－
－
－
－
－
－
－
－
－
－
－
－

0xf034
－
－
－
－
－
－
－
○
－
－
－
－

0xf035
－
－
－
－
－
－
－
－
－
－
－
－

0xf100
－
－
－
－
－
－
－
－
－
－
－
－

0xf101
－
－
－
－
－
－
－
－
－
－
－
－

0xf102
－
－
－
－
－
－
－
－
－
－
－
－

0xf103
－
－
－
－
－
－
－
－
－
－
－
－

0xf104
－
－
－
－
－
－
－
－
－
－
－
－

0xf105
－
－
－
－
－
－
－
－
－
－
－
－

0xf106
－
－
－
－
－
－
－
－
－
－
－
－

0xf107
－
－
－
－
－
－
－
○
－
－
－
－

0xf108
－
－
－
－
－
－
－
－
－
－
－
－

0xf109
－
－
－
－
－
－
－
○
－
－
－
－

0xf10c
－
－
－
－
－
－
－
－
－
－
－
－

0xf10d
－
－
－
－
－
－
－
－
－
－
－
－

0xf10e
－
－
－
－
－
－
－
－
－
－
－
－

0xf10f
－
－
－
－
－
－
－
－
－
－
－
－

0xf110
－
－
－
－
－
－
－
○
－
－
－
－

0xf111
－
－
－
－
－
－
－
－
－
－
－
－

0xf112
－
－
－
－
－
－
－
○
－
－
－
－

0xf113
－
－
－
－
－
－
－
○
－
－
－
－

0xf114
－
－
－
－
－
－
－
○
－
－
－
－

0xf200
－
－
－
－
－
－
－
－
－
－
－
－

0xf201
－
－
－
－
－
－
－
○
－
－
－
－

0xf202
－
－
－
－
－
－
－
－
－
－
－
－

0xf203
－
－
－
－
－
－
－
○
－
－
－
－

0xf204
－
－
－
－
－
－
－
－
－
－
－
－

0xf205
－
－
－
－
－
－
－
○
－
－
－
－

0xf206
－
－
－
－
－
－
－
－
－
－
－
－

0xf207
－
－
－
－
－
－
－
○
－
－
－
－

0xf210
－
－
－
－
－
－
－
－
－
－
－
－

0xf211
－
－
－
－
－
－
－
○
－
－
－
－

0xf212
－
－
－
－
－
－
－
○
－
－
－
－

0xf213
－
－
－
－
－
－
－
－
－
－
－
－

0xf214
－
－
－
－
－
－
－
○
－
－
－
－

0xf215
－
－
－
－
－
－
－
○
－
－
－
－

0xf216
－
－
－
－
－
－
－
－
－
－
－
－

0xf217
－
－
－
－
－
－
－
○
－
－
－
－

0xf218
－
－
－
－
－
－
－
○
－
－
－
－

0xf219
－
－
－
－
－
－
－
－
－
－
－
－

0xf21a
－
－
－
－
－
－
－
－
－
－
－
－

0xf21b
－
－
－
－
－
－
－
－
－
－
－
－

0xf21c
－
－
－
－
－
－
－
○
－
－
－
－

0xf21d
－
－
－
－
－
－
－
－
－
－
－
－

0xf21f
－
－
－
－
－
－
－
－
－
－
－
－

0xf220
－
－
－
－
－
－
－
○
－
－
－
－

（凡例）

○：情報を取得します。

－：情報を取得しません。

(2)　MCF性能検証用トレース情報の取得

OpenTP1は，次の表のイベントIDで示すタイミングでメッセージ送受信のトレース情報を取得します。また，次の表には，イベント発生時に必要なトレースデータ長も示しています。

表L-3　MCF性能検証用トレース情報の取得タイミング

イベントID
タイミング
取得プロセス
トレースデータ長
（単位：バイト）

0xa000
メッセージ受信直後
C
128

0xa001
メッセージ送信直前
C
128

0xa020
受信メッセージの入力キューへの格納直前（IJを取得する場合は，IJを取得する直前）
C
128

0xa021
MHPでのメッセージ受信直後（GJを取得する場合は，GJを取得する直前）
U
128

0xa022
送信メッセージの出力キューへの格納直後（OJを取得する場合は，OJを取得する直前）
U
128

0xa023
トランザクションのコミット処理開始直前（PJを取得する直前）
U
256

0xa024
トランザクションのコミット処理準備完了直後（HJを取得する直前）
U
256

0xa025
トランザクションのロールバック直前（BJを取得する直前）
U
256

0xa026
トランザクションの同期点処理終了直後（TJを取得する直前）
U
128

0xa027
メッセージ送信完了直後（AJを取得する場合は，AJを取得する直前）
C
128

0xa050
MHPサービス関数を呼び出す直前
U
320※1

0xa051
MHPサービス関数がリターンした直後
U
320※1

0xa060
関数が呼び出された直後※2
U
128

0xa061
関数がリターンする直前※2
U
128

0xa070
UOCを呼び出す直前
C※3
128

0xa071
UOCがリターンした直後
C※3
128

（凡例）

C：MCF通信サービスプロセスで取得します。

U：ユーザサーバプロセスで取得します。

注※1

非トランザクション属性のMHPの場合には取得されません。このとき，トレースデータ長は192バイトとなります。

注※2

COBOL言語で作成したUAP作成用プログラムの文法に誤りがあると，取得されない場合があります。

注※3

送信メッセージの通番編集UOCの場合は，ユーザサーバプロセスで取得します。

イベントID別の取得内容を，次の表に示します。

表L-4　イベントID別の取得内容（MCF性能検証用トレース）

イベントID
クライアント
OpenTP1識別子
クライアント通信番号
サーバOpenTP1識別子
ルートOpenTP1識別子
ルート通信番号
サービスグループ名
サービス名
リターンコード
グローバルトランザクション識別子
キュー名
メッセージトークン
メッセージ識別子
MCF固有情報※1

0xa000
－
－
－
－
－
－
－
－
－
－
－
－
○

0xa001
－
－
－
－
－
－
－
－
－
－
－
－
○

0xa020
－
－
－
－
－
－
－
－
－
－
－
－
○

0xa021
－
－
－
－
－
－
－
－
－
－
－
－
○

0xa022
－
－
－
－
－
－
－
－
－
－
－
－
○

0xa023
－
－
－
－
－
－
－
－
○
－
－
－
○

0xa024
－
－
－
－
－
－
－
－
○
－
－
－
○

0xa025
－
－
－
－
－
－
－
－
○
－
－
－
○

0xa026
－
－
－
－
－
－
－
－
－
－
－
－
○

0xa027
－
－
－
－
－
－
－
－
－
－
－
－
○

0xa050
－
－
－
－
－
○
○
－
○※1
－
－
－
－

0xa051
－
－
－
－
－
○
○
－
○※1
－
－
－
－

0xa060
－
－
－
－
－
－
－
－
－
－
－
－
○

0xa061
－
－
－
－
－
－
－
○
－
－
－
－
○

0xa070
－
－
－
－
－
－
－
－
－
－
－
－
○

0xa071
－
－
－
－
－
－
－
○※2
－
－
－
－
○

（凡例）

○：情報を取得します。

－：情報を取得しません。

注※1

MCF固有情報の詳細は，表L-5を参照してください。

注※2

送信メッセージの通番編集UOCの場合には取得されません。

MCF固有のイベントID別のダンプ出力情報を，次の表に示します。

表L-5　イベントID別のダンプ出力情報（MCF性能検証用トレース）

イベントID | Offset
0x0000～0x0003 | 0x0004～0x0007 | 0x0008～0x000f | 0x0010～0x0017 | 0x0018～0x001f
0xa000 | MCF識別子 | スレッドID | － | 入力元論理端末名 | プロトコルデータ種別※1
0xa001 | MCF識別子 | スレッドID | － | 出力先論理端末名 | MAP名※2，プロトコルデータ種別※1
0xa020 | MCF識別子 | スレッドID | アプリケーション名 | 入力元論理端末名 | "IJ"
0xa021 | － | － | アプリケーション名 | 入力元論理端末名 | "GJ"
0xa022 | － | － | アプリケーション名 | 出力先論理端末名 | "OJ"
0xa023 | － | － | － | － | "PJ"
0xa024 | － | － | － | － | "HJ"
0xa025 | － | － | － | － | "BJ"
0xa026 | － | － | － | － | "TJ"
0xa027 | MCF識別子 | スレッドID | アプリケーション名 | 出力先論理端末名 | "AJ"
0xa050 | － | － | － | － | －
0xa051 | － | － | － | － | －
0xa060 | MCF識別子 | スレッドID | － | － | API名称※3
0xa061 | MCF識別子 | スレッドID | アプリケーション名 | 論理端末名 | API名称※3
0xa070 | MCF識別子 | スレッドID | － | － | UOC名称※3
0xa071 | MCF識別子 | スレッドID | － | － | UOC名称※3

（凡例）

－：情報を取得しません。

注※1

TP1/NET/OSAS-NIFを使用している場合にだけ，プロトコルデータ種別を取得します。

注※2

TP1/NET/XMAP3を使用している場合にだけ，MAP名（マップ名称）を取得します。

注※3

MCF提供関数別のAPI名称出力情報については表L-6を，UOC別のUOC名称出力情報については表L-7を参照してください。

MCFの関数別API名称の出力情報を，次の表に示します。

表L-6　MCFの関数別のAPI名称出力情報

MCF提供関数 | C言語ライブラリ関数名 | API名称出力情報
アプリケーションに関するタイマ起動要求の削除 | dc_mcf_adltap | "TDLTAP"
アプリケーション情報通知 | dc_mcf_ap_info | "APINFO"
アプリケーション情報通知 | dc_mcf_ap_info_uoc | "APINFO_U"
MHPのコミット | dc_mcf_commit | "COMMIT"
継続問い合わせ応答の終了 | dc_mcf_contend | "CONTEND"
アプリケーションプログラムの起動 | dc_mcf_execap | "EXECAP"
メッセージの受信 | dc_mcf_receive | "RECEIVE"
同期型のメッセージの受信 | dc_mcf_recvsync | "RECVSYNC"
応答メッセージの送信 | dc_mcf_reply | "REPLY"
メッセージの再送 | dc_mcf_resend | "RESEND"
MHPのロールバック | dc_mcf_rollback | "ROLLBACK"
メッセージの送信 | dc_mcf_send | "SEND"
同期型のメッセージの送受信 | dc_mcf_sendrecv | "SENDRECV"
同期型のメッセージの送信 | dc_mcf_sendsync | "SENDSYNC"
コネクションの確立 | dc_mcf_tactcn | "TACTCN"
論理端末の閉塞解除 | dc_mcf_tactle | "TACTLE"
コネクションの解放 | dc_mcf_tdctcn | "TDCTCN"
論理端末の閉塞 | dc_mcf_tdctle | "TDCTLE"
論理端末の出力キュー削除 | dc_mcf_tdlqle | "TDLQLE"
一時記憶データの受け取り | dc_mcf_tempget | "TEMPGET"
一時記憶データの更新 | dc_mcf_tempput | "TEMPPUT"
ユーザタイマ監視の取り消し | dc_mcf_timer_cancel | "TIMERCAN"
ユーザタイマ監視の設定 | dc_mcf_timer_set | "TIMERSET"
コネクションの状態表示 | dc_mcf_tlscn | "TLSCN"
MCF通信サービス情報通知 | dc_mcf_tlscom | "TLSCOM"
論理端末の状態取得 | dc_mcf_tlsle | "TLSLE"
サーバ型コネクションの確立要求の受付状態取得 | dc_mcf_tlsln | "TLSLN"
サーバ型コネクションの確立要求の受付終了 | dc_mcf_tofln | "TOFLN"
サーバ型コネクションの確立要求の受付開始 | dc_mcf_tonln | "TONLN"

MCFのUOC別UOC名称の出力情報を，次の表に示します。

表L-7　MCFのUOC別のUOC名称出力情報

UOCの種類 | UOC名称出力情報
送信メッセージの通番編集UOC | "SEND_UOC"
上記以外のUOC | UOC関数のアドレスを設定するシステム提供変数名称

付録L.2　性能検証用トレース情報の取得例

ここでは，性能検証用トレースの取得例を，使用する製品別に示します。なお，実際のトレースの出力方法は，システム構成によって変わります。

＜この項の構成＞

(1)　TP1/Server Baseの取得例

(2)　TP1/Message Controlの取得例

(3)　TP1/Message Queueの取得例

(1)　TP1/Server Baseの取得例

ノードAからノードBにRPCを行う場合の例，およびその場合のTP1/Server Baseの性能検証用トレースの取得例を次に示します。

図L-1　TP1/Server BaseでノードAからノードBにRPCを行う場合の例

図L-2　TP1/Server Baseの性能検証用トレースの取得例

(2)　TP1/Message Controlの取得例

相手システムからメッセージを受信してメッセージを送信する場合の，TP1/Message Controlの性能検証用トレースの取得例を次に示します。

図L-3　TP1/Message Controlの性能検証用トレースの取得例

(3)　TP1/Message Queueの取得例

相手システムからメッセージを受信して応答メッセージを送信する場合の，TP1/Message Queueの性能検証用トレースの取得例を次に示します。

図L-4　TP1/Message Queueの性能検証用トレースの取得例

付録L.3　性能検証用トレース情報の解析例

＜この項の構成＞

(1)　性能検証用トレースの編集コマンド

(2)　トレース情報の見方

(3)　性能検証用トレースの利用例

(4)　dcalzprfコマンドでの性能検証用トレース解析

(1)　性能検証用トレースの編集コマンド

性能検証用トレースを編集するにはprfedコマンド，またはdcalzprfコマンドを使用します。それぞれのコマンドの利用方法，出力内容については，「13.　運用コマンドの詳細」の「prfed」または「dcalzprf」を参照してください。

性能検証用トレースを編集する際，コマンドにトレース情報を絞り込むための引数を渡せます。性能検証用トレースは，トレース情報を絞り込まないで編集すると，多大な情報が出力され，コマンド処理に時間が掛かる場合があります。そのため，解析作業をスムーズに行えるよう，あらかじめわかっている情報から，トレース情報を極力絞り込むことをお勧めします。特に，トレースが取得された時間帯やプロセスIDで絞り込めると，編集出力される情報量を抑えることができます。

prfedコマンドは，時刻を軸とした一次元での編集結果を出力します。一方，dcalzprfコマンドは出力形式がcsvとなっており，時刻とプロセスを軸とした二次元での編集結果を出力します。また，prfedコマンドに比べてトレース情報の選択オプションが豊富であり，効率の良い絞り込みができます。これらの特長によって，prfedコマンドに比べて，dcalzprfコマンドは容易に性能検証用トレースを解析できます。

(2)　トレース情報の見方

性能検証用トレースを編集出力すると，さまざまな情報が表示されます。各項目の意味を次の表に示します。

表L-8　性能検証用トレースの出力項目

項目
説明

ノードID
トレース情報を取得したプロセスが所属していたOpenTP1システムのノードIDです。複数ノードの性能検証用トレースをまとめて編集した際に，どのノードに所属していたプロセスかを判別するために使用します。

ランID
トレース情報を取得したプロセスが所属していたOpenTP1システムのランIDです。複数回のオンラインの性能検証用トレースをまとめて編集した際に，いつのオンラインの時に取得されたトレース情報なのかを判別するために使用します。

トレース通番
トレース情報を取得したプロセスが取得していた性能検証用トレース情報の通番です。1～65535まで1ずつ，トレース情報を取得するたびに増加します。65535の次は1に戻ります。
同一プロセスのトレースについて，連続性を確認するために使用します。

イベントID
各トレース情報の識別子です。トレースの取得個所ごとに決められており，どこの処理で取得されたトレース情報なのかを判別するために使用します。

サーバ名
トレース情報を取得したプロセスのサーバ名です。

リターンコード
OpenTP1提供関数のリターンコードです。処理の成功・失敗などを判別するために使用します。

クライアントOpenTP1識別子
ノード間の通信でのクライアント側のOpenTP1識別子（ノードID）です。

クライアント通信番号
他ノードや他プロセスに通信するときに，OpenTP1システム が付加する番号です。同一のOpenTP1システムで一意になります。
クライアントOpenTP1識別子とクライアント通信番号をセットにして検索することで，通信の流れを追跡できます。

サーバOpenTP1識別子
ノード間の通信でのサーバ側のOpenTP1識別子（ノードID）です。

ルートOpenTP1識別子
通信が複数のノードにまたがっている場合，その通信のルートとなるノードのOpenTP1識別子（ノードID）です。
ノードを何度またがっても，同じ識別子が使用されます。

ルート通信番号
他ノードや，他プロセスに通信するときにOpenTP1システム が付加する番号です。同一のOpenTP1システムで一意になります。
ノードを何度またがっても，同じ識別子が使用されます。
ルートOpenTP1識別子とルート通信番号をセットにして検索することで，一連の通信の流れを追跡できます。

サービスグループ名
RPC要求先のサービスグループ名です。

サービス名
RPC要求先のサービス名です。

グローバルトランザクションID
グローバルトランザクションを識別するためのIDです。グローバルトランザクションIDをキーに検索することで，一連のトランザクションの流れを追跡できます。

イベント種別
トランザクションサービスが取得しているトレース情報に付加されている情報です。XA関数の出入り口情報や，トランザクションサービスに関係するイベント情報が出力されます。
出力されているイベントによって処理の進行状況がわかり，ボトルネックの調査などに利用できます。

(3)　性能検証用トレースの利用例

性能検証用トレースには，ノード間の通信の際にクライアント・サーバ同士を関連づけるためのキーとして，クライアント通信番号やルート通信番号などが含まれています。ノードをまたがってOpenTP1の処理を追いかける場合，このキーを基に，クライアント・サーバそれぞれで取得したトレースを関連づけることができます。

クライアント・サーバそれぞれのノードで取得されるトレースの内容について次に示します。

なお，OpenTP1識別子と通信番号はセットで比較してください。OpenTP1識別子だけの場合，ノードは特定できますが，どの通信なのかを特定するのは困難です。また，通信番号だけの場合は，ノードの特定が困難です。

(4)　dcalzprfコマンドでの性能検証用トレース解析

dcalzprfコマンドには，性能検証用トレースを編集・解析するためのさまざまな機能があります。

dcalzprfコマンドで出力されたCSVファイルは，表計算ソフトを使用して参照・編集すると，時間とプロセスを軸とした二次元的な情報表示ができます。これによって，トレースデータの流れがわかりやすくなります。また，表計算ソフトのフィルタリング機能を使用すれば，dcalzprfコマンドで絞り込めなかったデータを直接，絞り込めます。

ここでは，dcalzprfコマンドでのトレース解析方法を紹介します。

(a)　イベント間の時刻差算出（-Cオプション，および-Fオプション）

dcalzprfコマンドでは，出力される各イベントとイベントの間の時刻差を，編集出力時に算出できます。時刻差の算出には，-Cオプションおよび-Fオプションを使用します。-Cオプションに時刻差を計算する始点となるイベントIDを指定し，-Fオプションに終点となるイベントIDを指定します。

例えば，「-C 0x4005 -F 0x4006」と指定して編集出力をすると，始点を0x4005（コミット電文の受信イベント）から0x4006（コミット完了電文の送信イベント）までの時刻差，つまりコミット処理に掛かった時間を算出できます。そのほか，「-C 0x4100 -F 0x4150」と指定すると，トランザクション開始から終了までの時間を，「-C 0x1000 -F 0x1004」と指定すると，RPCでサービスの呼び出しに掛かった時間をそれぞれ算出できます。

ただし，時刻差を算出できるのは，同一プロセス上のイベント同士だけです。別プロセス上のレコードに出力されるイベント同士は，-Cオプションおよび-Fオプションでは時刻差を算出できません。

図L-5　通常のprfトレース発行順の場合の編集結果

一部のprfトレースの情報に抜けが発生した場合，抜けたトレースのイベントIDを-Cオプションまたは-Fオプションに指定しても，時刻差を算出できません。

図L-6　トレースの一部に抜けが発生している場合の編集結果

-Cオプションおよび-Fオプションの両方で指定したイベントIDのトレースに連続で抜けが発生した場合，本来よりも長い時刻差で算出されることがあります。

図L-7　トレースに連続で抜けが発生している場合の編集結果

また，始点と終点を-Cオプションおよび-Fオプションにそれぞれ複数指定すれば，複数種類のイベントIDの時刻差を取得できます。しかし，トレースが「始点-始点-終点-終点」の順序になっている場合は，仮にトレースに抜けがないときでも，意図したイベントの時刻差とは異なる時刻差が算出されることがあります。この場合，-Cオプションおよび-Fオプションを一つずつ指定すると，正しい時刻差が算出されます。

図L-8　「始点-始点-終点-終点」の順序になっている場合の編集結果

(b)　別プロセス同士のイベント時刻差算出（-dオプション）

別プロセス同士のイベント時刻差を算出する場合は，-dオプションを使うと便利です。-dオプションは，指定された起点時刻から各レコードまでの時刻差を編集出力時に表示します。起点時刻との時刻差はマイクロ秒で表示されており，レコード同士の時刻を引き算することで，レコード間の時刻を容易に算出できます。

(c)　-Cオプション，-Fオプション，および-dオプションで算出した時刻差の表示について

CSVファイルの参照・編集に表計算ソフトを使用している環境で，-Cオプションおよび-Fオプションで算出される時刻差や，-dオプションで算出される時刻差が大きい値の場合，指数表記で表示されるときがあります。また，けた落ちが発生することもあります。そのため，時刻差が大きくなり過ぎないよう，トレース情報を絞り込むことをお勧めします。-Cオプションおよび-FオプションにイベントIDを指定，また，-dオプションに起点時刻を指定して，トレース情報を絞り込むことで，時刻差の値を小さくできます。

付録M　シナリオテンプレートの詳細

シナリオテンプレートの詳細をアルファベット順に説明します。なお，OpenTP1_ScenarioScaleoutシナリオテンプレートはスケールアウトのサンプルシナリオテンプレートです。

シナリオテンプレートから実行されるOpenTP1コマンドの優先順位を下げないために，シナリオテンプレートの「優先順位」を「3」に設定してください。優先順位の設定については，マニュアル「JP1/Automatic Job Management System 2 - Scenario Operation」を参照してください。

異常時の対処

シナリオ実行時に異常が発生すると，エラーメッセージが出力されることがあります。エラーメッセージに従って対処してください。エラーメッセージの詳細については，マニュアル「OpenTP1 メッセージ」を参照してください。

＜この節の構成＞

付録M.1　OpenTP1_AddNode

付録M.2　OpenTP1_ChangeNodeID

付録M.3　OpenTP1_Deploy

付録M.4　OpenTP1_ScenarioAddNode

付録M.5　OpenTP1_Start

付録M.6　OpenTP1_StartUAP

付録M.7　OpenTP1_Stop

付録M.8　OpenTP1_StopUAP

付録M.9　OpenTP1_Undeploy

付録M.10　OpenTP1_UpdateDomain

付録M.11　OpenTP1_ScenarioScaleout

付録M.1　OpenTP1_AddNode

名称

OpenTP1_AddNode

概要

OpenTP1ノードのドメイン定義ファイルへの追加

機能

ドメイン構成を更新するノードのドメイン定義ファイルに，新しく追加するOpenTP1ノードのホスト名およびポート番号を追加します。

新しく追加したOpenTP1ノードのホスト名およびポート番号を，自ホストのドメイン定義ファイルに追加する場合に，このシナリオテンプレートをシナリオの配下に複写して，シナリオの一部として利用します。

このシナリオテンプレートを実行したあとにOpenTP1_UpdateDomainシナリオテンプレートを実行すると，ドメイン構成が更新されます。

このシナリオテンプレートを実行する場合の前提条件は，システム共通定義のname_domain_file_useオペランドにYを指定していることです。

入力シナリオ変数

●DCDIR　　～〈1～50文字の文字列〉

OpenTP1ディレクトリ名を指定します。

●DCCONFPATH

OpenTP1定義ファイル格納ディレクトリを指定します。

●HOST_NAME

シナリオジョブを実行するOpenTP1ノードのホスト名を指定します。

この入力シナリオ変数は省略できます。省略した場合，シナリオの実行先ホストでシナリオジョブを実行します。

●USER_NAME

シナリオジョブを実行するOpenTP1管理者のユーザ名を指定します。

この入力シナリオ変数は省略できます。省略した場合，JP1/Baseで定義したユーザマッピングのプライマリユーザがシナリオジョブを実行します。

●ADD_HOST_NAME　　～〈1～255文字の文字列〉

OpenTP1システムに新しく追加するOpenTP1ノードのホスト名を指定します。

●PORT_NUMBER　　～（（5001～65535））

新しく追加するOpenTP1ノードのネームサーバが使用するポート番号を指定します。

出力シナリオ変数

なし。

実行ユーザ

入力シナリオ変数USER_NAMEで指定したOpenTP1管理者です。

付録M.2　OpenTP1_ChangeNodeID

名称

OpenTP1_ChangeNodeID

概要

OpenTP1のノードIDの設定

機能

新しく追加するOpenTP1のノードIDを設定します。

このシナリオテンプレートを実行すると，システム共通定義のnode_idオペランドに指定したノードIDを設定します。このシナリオテンプレートを実行する前に，システム共通定義のnode_idオペランドに次のように指定してください。

set node_id = @DCNODE_ID@

スケールアウトやOpenTP1の環境設定でノードIDを変更する場合に，このシナリオテンプレートをシナリオの配下に複写して，シナリオの一部として利用します。

入力シナリオ変数

●DCDIR　　～〈1～50文字の文字列〉

OpenTP1ディレクトリ名を指定します。

●DCCONFPATH

OpenTP1定義ファイル格納ディレクトリを指定します。

●HOST_NAME

シナリオジョブを実行するOpenTP1ノードのホスト名を指定します。

この入力シナリオ変数は省略できます。省略した場合，シナリオの実行先ホストでシナリオジョブを実行します。

●USER_NAME

シナリオジョブを実行するOpenTP1管理者のユーザ名を指定します。

この入力シナリオ変数は省略できます。省略した場合，JP1/Baseで定義したユーザマッピングのプライマリユーザがシナリオジョブを実行します。

●NODE_ID　　～〈4文字の文字列〉

設定するOpenTP1のノードIDを指定します。

OpenTP1システムで一意になるように指定してください。

出力シナリオ変数

なし。

実行ユーザ

入力シナリオ変数USER_NAMEで指定したOpenTP1管理者です。

付録M.3　OpenTP1_Deploy

名称

OpenTP1_Deploy

概要

OpenTP1の登録

機能

指定したOpenTP1ディレクトリ下のOpenTP1を，OSに登録します。

スケールアウト，ローリングアップデートなどでOpenTP1をOSに登録する場合に利用します。このシナリオテンプレートは，シナリオの配下に複写すると，シナリオの一部としても利用できます。

入力シナリオ変数

●DCDIR　　～〈1～50文字の文字列〉

登録するOpenTP1ディレクトリ名を指定します。

OpenTP1システムで一意になるように指定してください。

●DCCONFPATH

OpenTP1定義ファイル格納ディレクトリを指定します。

●HOST_NAME

シナリオジョブを実行するOpenTP1ノードのホスト名を指定します。

この入力シナリオ変数は省略できます。省略した場合，シナリオの実行先ホストでシナリオジョブを実行します。

出力シナリオ変数

なし。

実行ユーザ

スーパユーザです。

付録M.4　OpenTP1_ScenarioAddNode

名称

OpenTP1_ScenarioAddNode

概要

ドメインの新規追加

機能

OpenTP1システムのドメイン構成を更新するノードのドメイン定義ファイルに，新しくOpenTP1ノードを追加します。

新しく追加したOpenTP1ノードを，ドメイン構成を更新するノードに追加する場合に利用します。これによって，クライアントは新しく追加したOpenTP1ノードのサービスを利用できます。

このシナリオテンプレートは，次に示すシナリオテンプレートで構成されています。

OpenTP1_AddNode

OpenTP1_UpdateDomain

このシナリオテンプレートを実行する場合の前提条件を次に示します。

システム共通定義のname_domain_file_useオペランドにYを指定している

ドメイン構成を更新するノードがオンラインである

入力シナリオ変数

●DCDIR　　～〈1～50文字の文字列〉

OpenTP1ディレクトリ名を指定します。

●DCCONFPATH

OpenTP1定義ファイル格納ディレクトリを指定します。

●HOST_NAME

シナリオジョブを実行するOpenTP1ノードのホスト名を指定します。

この入力シナリオ変数は省略できます。省略した場合，シナリオの実行先ホストでシナリオジョブを実行します。

●USER_NAME

シナリオジョブを実行するOpenTP1管理者のユーザ名を指定します。

この入力シナリオ変数は省略できます。省略した場合，JP1/Baseで定義したユーザマッピングのプライマリユーザがシナリオジョブを実行します。

●ADD_HOST_NAME　　～〈1～255文字の文字列〉

OpenTP1システムに新しく追加するOpenTP1のホスト名を指定します。

●PORT_NUMBER　　～（（5001～65535））

OpenTP1システムに新しく追加するOpenTP1ノードのネームサーバが使用するポート番号を指定します。

出力シナリオ変数

なし。

実行ユーザ

入力シナリオ変数USER_NAMEで指定したOpenTP1管理者です。

付録M.5　OpenTP1_Start

名称

OpenTP1_Start

概要

OpenTP1の起動

機能

新しく追加したOpenTP1を起動します。前回の終了モードが正常終了の場合は正常開始，異常終了の場合は再開始します。

スケールアウト，ローリングアップデートなどでOpenTP1を起動する場合に利用します。このシナリオテンプレートは，シナリオの配下に複写すると，シナリオの一部としても利用できます。

入力シナリオ変数

●DCDIR　　～〈1～50文字の文字列〉

OpenTP1ディレクトリ名を指定します。

●DCCONFPATH

OpenTP1定義ファイル格納ディレクトリを指定します。

●HOST_NAME

シナリオジョブを実行するOpenTP1ノードのホスト名を指定します。

この入力シナリオ変数は省略できます。省略した場合，シナリオの実行先ホストでシナリオジョブを実行します。

●USER_NAME

シナリオジョブを実行するOpenTP1管理者のユーザ名を指定します。

この入力シナリオ変数は省略できます。省略した場合，JP1/Baseで定義したユーザマッピングのプライマリユーザがシナリオジョブを実行します。

出力シナリオ変数

なし。

実行ユーザ

入力シナリオ変数USER_NAMEで指定したOpenTP1管理者です。

付録M.6　OpenTP1_StartUAP

名称

OpenTP1_StartUAP

概要

UAPの起動

機能

ユーザサーバを起動します。

スケールアウトなどでユーザサーバを起動する場合に利用します。このシナリオテンプレートは，シナリオの配下に複写すると，シナリオの一部としても利用できます。

入力シナリオ変数

●DCDIR　　～〈1～50文字の文字列〉

OpenTP1ディレクトリ名を指定します。

●DCCONFPATH

OpenTP1定義ファイル格納ディレクトリを指定します。

●HOST_NAME

シナリオジョブを実行するOpenTP1ノードのホスト名を指定します。

この入力シナリオ変数は省略できます。省略した場合，シナリオの実行先ホストでシナリオジョブを実行します。

●USER_NAME

シナリオジョブを実行するOpenTP1管理者のユーザ名を指定します。

この入力シナリオ変数は省略できます。省略した場合，JP1/Baseで定義したユーザマッピングのプライマリユーザがシナリオジョブを実行します。

●USER_SERVER_NAME　　～〈1～8文字の文字列〉

起動するユーザサーバ名を指定します。

出力シナリオ変数

なし。

実行ユーザ

入力シナリオ変数USER_NAMEで指定したOpenTP1管理者です。

付録M.7　OpenTP1_Stop

名称

OpenTP1_Stop

概要

OpenTP1の停止

機能

OpenTP1を停止して，OpenTP1ノードの空いているリソースを解放します。

スケールイン，ローリングアップデートなどでOpenTP1を停止する場合に利用します。このシナリオテンプレートは，シナリオの配下に複写すると，シナリオの一部としても利用できます。

入力シナリオ変数

●DCDIR　　～〈1～50文字の文字列〉

OpenTP1ディレクトリ名を指定します。

●DCCONFPATH

OpenTP1定義ファイル格納ディレクトリを指定します。

●HOST_NAME

シナリオジョブを実行するOpenTP1ノードのホスト名を指定します。

この入力シナリオ変数は省略できます。省略した場合，シナリオの実行先ホストでシナリオジョブを実行します。

●USER_NAME

シナリオジョブを実行するOpenTP1管理者のユーザ名を指定します。

この入力シナリオ変数は省略できます。省略した場合，JP1/Baseで定義したユーザマッピングのプライマリユーザがシナリオジョブを実行します。

出力シナリオ変数

なし。

実行ユーザ

入力シナリオ変数USER_NAMEで指定したOpenTP1管理者です。

付録M.8　OpenTP1_StopUAP

名称

OpenTP1_StopUAP

概要

UAPの停止

機能

ユーザサーバを停止します。

スケールインなどでユーザサーバを停止する場合に利用します。このシナリオテンプレートは，シナリオの配下に複写すると，シナリオの一部としても利用できます。

入力シナリオ変数

●DCDIR　　～〈1～50文字の文字列〉

OpenTP1ディレクトリ名を指定します。

●DCCONFPATH

OpenTP1定義ファイル格納ディレクトリを指定します。

●HOST_NAME

シナリオジョブを実行するOpenTP1ノードのホスト名を指定します。

この入力シナリオ変数は省略できます。省略した場合，シナリオの実行先ホストでシナリオジョブを実行します。

●USER_NAME

シナリオジョブを実行するOpenTP1管理者のユーザ名を指定します。

この入力シナリオ変数は省略できます。省略した場合，JP1/Baseで定義したユーザマッピングのプライマリユーザがシナリオジョブを実行します。

●USER_SERVER_NAME　　～〈1～8文字の文字列〉

停止するユーザサーバ名を指定します。

出力シナリオ変数

なし。

実行ユーザ

入力シナリオ変数USER_NAMEで指定したOpenTP1管理者です。

付録M.9　OpenTP1_Undeploy

名称

OpenTP1_Undeploy

概要

OpenTP1の削除

機能

指定したOpenTP1ディレクトリ下のOpenTP1を，OSから削除します。

ローリングアップデートでOpenTP1をOSから削除する場合に利用します。このシナリオテンプレートは，シナリオの配下に複写すると，シナリオの一部としても利用できます。

入力シナリオ変数

●DCDIR　　～〈1～50文字の文字列〉

削除するOpenTP1ディレクトリ名を指定します。

●DCCONFPATH

OpenTP1定義ファイル格納ディレクトリを指定します。

●HOST_NAME

シナリオジョブを実行するOpenTP1ノードのホスト名を指定します。

この入力シナリオ変数は省略できます。省略した場合，シナリオの実行先ホストでシナリオジョブを実行します。

出力シナリオ変数

なし。

実行ユーザ

スーパユーザです。

付録M.10　OpenTP1_UpdateDomain

名称

OpenTP1_UpdateDomain

概要

ドメイン構成の更新

機能

OpenTP1システムのドメイン構成を，OpenTP1の動作中に更新します。

OpenTP1_AddNodeシナリオテンプレートなどでドメイン定義ファイルに追加した新しいノードをシステムに追加する場合に，このシナリオテンプレートをシナリオの配下に複写して，シナリオの一部として利用します。

このシナリオテンプレートを実行する場合の前提条件を次に示します。

システム共通定義のname_domain_file_useオペランドにYを指定している

OpenTP1がオンラインである

入力シナリオ変数

●DCDIR　　～〈1～50文字の文字列〉

OpenTP1ディレクトリ名を指定します。

●DCCONFPATH

OpenTP1定義ファイル格納ディレクトリを指定します。

●HOST_NAME

シナリオジョブを実行するOpenTP1ノードのホスト名を指定します。

この入力シナリオ変数は省略できます。省略した場合，シナリオの実行先ホストでシナリオジョブを実行します。

●USER_NAME

シナリオジョブを実行するOpenTP1管理者のユーザ名を指定します。

この入力シナリオ変数は省略できます。省略した場合，JP1/Baseで定義したユーザマッピングのプライマリユーザがシナリオジョブを実行します。

出力シナリオ変数

なし。

実行ユーザ

入力シナリオ変数USER_NAMEで指定したOpenTP1管理者です。

付録M.11　OpenTP1_ScenarioScaleout

名称

OpenTP1_ScenarioScaleout

概要

スケールアウトのサンプルシナリオテンプレート

機能

OpenTP1をインストールしたあとに実行すると，OpenTP1の環境設定をして，OpenTP1およびサンプルSPPを起動します。

入力シナリオ変数

●DCDIR　　～〈1～50文字の文字列〉

登録するOpenTP1ディレクトリ名を指定します。

OpenTP1システムで一意になるように指定してください。

●DCCONFPATH

OpenTP1定義ファイル格納ディレクトリを指定します。

●HOST_NAME

シナリオジョブを実行するOpenTP1ノードのホスト名を指定します。

この入力シナリオ変数は省略できます。省略した場合，シナリオの実行先ホストでシナリオジョブを実行します。

●USER_NAME

シナリオジョブを実行するOpenTP1管理者のユーザ名を指定します。

この入力シナリオ変数は省略できます。省略した場合，JP1/Baseで定義したユーザマッピングのプライマリユーザがシナリオジョブを実行します。

●GROUP_NAME

OpenTP1グループ名を指定します。

入力シナリオ変数USER_NAMEを指定した場合は，必ず入力シナリオ変数GROUP_NAMEも指定してください。

●BETRAN_FILE1

A系のOpenTP1ファイルシステムのパスを指定します。

キャラクタ型スペシャルファイルを指定する場合は，シナリオテンプレートを実行する前に，パーティションを割り当ててください。

●BETRAN_FILE2

B系のOpenTP1ファイルシステムのパスを指定します。

キャラクタ型スペシャルファイルを指定する場合は，シナリオテンプレートを実行する前に，パーティションを割り当ててください。

●USER_SERVER_NAME　　～〈1～8文字の文字列〉

起動するユーザサーバ名を指定します。

サンプルシナリオテンプレートを使用する場合は，basesppを指定してください。

●NODE_ID　　～〈4文字の文字列〉

設定するOpenTP1のノードIDを指定します。

OpenTP1システムで一意になるように指定してください。

●PORT_NUMBER　　～（（5001～65535））

OpenTP1システムに新しく追加するOpenTP1ノードのネームサーバが使用するポート番号を指定します。

出力シナリオ変数

なし。

実行ユーザ

環境設定をするOpenTP1のディレクトリを作成するシナリオジョブ，およびOpenTP1をOSに登録するシナリオジョブは，スーパユーザが実行します。それ以外のシナリオジョブは，入力シナリオ変数USER_NAMEで指定したOpenTP1管理者が実行します。

索引

[数字]
[Ａ][Ｃ][Ｄ][Ｆ][Ｇ][Ｉ][Ｊ][Ｌ][Ｍ][Ｎ][Ｏ][Ｐ][Ｑ][Ｒ][Ｓ][Ｔ][Ｕ][Ｘ]
[ア行][カ行][サ行][タ行][ナ行][ハ行][マ行][ヤ行][ラ行]

(数字)

1トランザクションで必要なトレースデータ長

(英字)

(Ａ)

AJレコード形式

(Ｃ)

CPU障害

(Ｄ)

damadd

dambkup

damchdef

damchinf

damdel

DAM FRC

damfrc

DAM FRCを1回で実行するとき

DAM FRCを複数回に分けて実行するとき

damhold

damload

damls

damlsコマンドによる状態表示

damrles

damrm

damrstr

DAMファイルの運用

DAMファイルの回復

DAMファイルのキャッシュブロック数の設定

DAMファイルのサイズの見積もり式

DAMファイルの作成

DAMファイルの状態管理

DAMファイルの状態表示

DAMファイルの追加と削除

DAMファイルの排他

DAMファイルのバックアップ

DAMファイルのバックアップとリストア

DAMファイルのブロック長の拡張

DAMファイルのユーザデータの抽出

DAMファイルのリストア

dcalzprf

dcauditsetup

dccspool

dcdefchk

dcdefchkコマンドのチェック処理の流れ

dcjchconf

dcjcmdex

dcjnamch

dcmakeup

dcmapchg

dcmapls

dcmstart

dcmstop

dcndls

dcpplist

dcrasget

dcreport

dcreset

dcsetup

dcshmls

dcstart

dcstats

dcstop

dcsvstart

dcsvstop

(Ｆ)

filbkup

filchgrp

filchmod

filchown

fills

fillsコマンドによる状態表示

filmkfs

filrstr

filstatfs

FILイベントトレース情報ファイル

FILイベントトレース情報ファイルのバックアップファイル

(Ｇ)

GJレコード形式

(Ｉ)

I/O障害処理続行型テーブル

IJレコード形式

(Ｊ)

jnladdpf

jnlardis

jnlarls

jnlatunl

jnlchgfg

jnlclsfg

jnlcolc

jnlcopy

jnldelpf

jnledit

jnlinit

jnlls

jnlmcst

jnlmcstコマンドで取得できる稼働統計情報

jnlmkrf

jnlopnfg

jnlrinf

jnlrm

jnlrput

jnlrputコマンドで出力できるデータ

jnlsort

jnlstts

jnlsttsコマンドで編集できる稼働統計情報

jnlswpfg

jnlunlfg

JNL性能検証用トレース情報ファイル

JNL性能検証用トレース情報ファイルのバックアップファイル

JP1連携時の運用

(Ｌ)

LAN障害

lckls

lckpool

lckrminf

LCK性能検証用トレース情報ファイル

LCK性能検証用トレース情報ファイルのバックアップファイル

logcat

logcon

(Ｍ)

MCF

mcfaactap

mcfaclcap

mcfadctap

mcfadltap

mcfalsap

mcfalstap

mcfreport

mcfstats

mcfstats，mcfreportで取得できる稼働統計情報

mcftactcn

mcftactle

mcftactmj

mcftactsg

mcftactss

mcftactsv

mcftchcn

mcftdctcn

mcftdctle

mcftdctmj

mcftdctsg

mcftdctss

mcftdctsv

mcftdlqle

mcftdlqsg

mcftdmpqu

mcftedalt

mcftendct

mcfthldiq

mcfthldoq

mcftlsbuf

mcftlscn

mcftlscom

mcftlsle

mcftlsln

mcftlssg

mcftlssv

mcftlstrd

mcftlsutm

mcftofln

mcftonln

mcftrlsiq

mcftrlsoq

mcftspqle

mcftstalt

mcftstart

mcftstop

mcftstptr

mcftstrtr

mcftswptr

mcfuevt

MCFアプリケーション起動プロセスプログラムファイル ,[2]

MCF稼働統計情報 ,[2]

MCF稼働統計情報の出力 ,[2]

MCF稼働統計情報の編集

MCF稼働統計情報の編集内容（jnlmcstコマンド）

MCF稼働統計情報の編集内容（mcfreportコマンド）

MCF稼働統計情報ファイル

MCF共用メモリダンプファイル

MCF構成変更再開始機能使用時のOpenTP1の終了と再開始

MCF構成変更再開始機能使用時の構成変更手順

MCF構成変更再開始機能使用時の準備

MCF構成変更再開始機能使用時の障害対策

MCF構成変更再開始機能使用時の流れ

MCF構成変更再開始機能使用時のメッセージのバックアップとリストア

MCF構成変更再開始機能に関する運用

MCF構成変更準備停止

MCFサービス名の登録

MCF性能検証用トレース情報の取得

MCF性能検証用トレース情報ファイル

MCF性能検証用トレース情報ファイルのバックアップファイル

MCFダンプファイル

MCF通信サービスに関する運用

MCF通信サービスのMCFメイン関数の作成方法

MCF通信サービスの開始の待ち合わせ

MCF通信サービスの状態参照と開始待ち合わせ

MCF通信サービスの状態表示

MCF通信サービスの部分入れ替え

MCF通信サービスの部分開始

MCF通信サービスの部分停止

MCF通信プロセスプログラムファイル ,[2]

MCFトレース取得の開始

MCFトレース取得の終了

MCFトレースの一時出力

MCFトレースのスワップ

MCFトレースファイル

MCFトレースファイルの強制スワップ

MCFメイン関数

MCFメイン関数のディレクトリへの組み込み方法の概要

MJレコード形式

(Ｎ)

namalivechk

namblad

namchgfl

namdomainsetup

nammstr

namndchg

namndopt

namndrm

namnlcre

namnldel

namnldsp

namsvinf

namunavl

NAMイベントトレース情報ファイル

NAMイベントトレース情報ファイルのバックアップファイル

(Ｏ)

OJレコード形式

OpenTP1_AddNode

OpenTP1_ChangeNodeID

OpenTP1_Deploy

OpenTP1_ScenarioAddNode

OpenTP1_ScenarioScaleout

OpenTP1_Start

OpenTP1_StartUAP

OpenTP1_Stop

OpenTP1_StopUAP

OpenTP1_Undeploy

OpenTP1_UpdateDomain

OpenTP1オンラインの運用

OpenTP1が異常終了した場合

OpenTP1が停止しない場合

OpenTP1管理者による環境設定

OpenTP1管理者の環境設定 ,[2]

OpenTP1管理者の設定

OpenTP1管理者の登録 ,[2]

OpenTP1起動確認とキャッシュ削除

OpenTP1起動確認とキャッシュ削除機能

OpenTP1起動通知情報の強制的無効化

OpenTP1グループの設定 ,[2]

OpenTP1実行時に作成されるファイル

OpenTP1実行時に作成されるファイルとディレクトリ

OpenTP1障害

OpenTP1ディレクトリの作成 ,[2] ,[3]

OpenTP1デバッグ情報ファイル

OpenTP1内部処理用のファイル

OpenTP1のOSへの登録 ,[2]

OpenTP1のOSへの登録と削除

OpenTP1のイベント

OpenTP1の運用コマンド一覧

OpenTP1の運用コマンドが応答待ちタイムアウトになる場合

OpenTP1の運用コマンドが正常終了しない場合

OpenTP1ノードのRPC抑止リスト操作

OpenTP1ノードの状態表示 ,[2]

OpenTP1の開始

OpenTP1の開始と終了 ,[2]

OpenTP1の環境設定

OpenTP1の環境設定手順

OpenTP1のサーバ情報の表示

OpenTP1の実行形式ファイル

OpenTP1の終了

OpenTP1のドメイン

OpenTP1のドメインに関する運用

OpenTP1の内部制御用資源の確保と解放

OpenTP1のファイルの運用

OpenTP1の付加機能の運用

OpenTP1のプロセスの強制停止

OpenTP1の連続運転に関する運用

OpenTP1ファイル以外のファイルの作成 ,[2] ,[3]

OpenTP1ファイルグループの変更 ,[2]

OpenTP1ファイルシステムの運用

OpenTP1ファイルシステムのガーベジコレクション

OpenTP1ファイルシステムの作成

OpenTP1ファイルシステムの状態表示 ,[2]

OpenTP1ファイルシステムの初期設定 ,[2] ,[3] ,[4]

OpenTP1ファイルシステムの属性変更の手順

OpenTP1ファイルシステムの内容表示 ,[2]

OpenTP1ファイルシステムのバックアップ ,[2]

OpenTP1ファイルシステムの見積もり式

OpenTP1ファイルシステムのリストア ,[2]

OpenTP1ファイルシステム領域 ,[2] ,[3]

OpenTP1ファイルシステム領域の作成 ,[2]

OpenTP1ファイルシステム領域の所有者とアクセス権 ,[2]

OpenTP1ファイル障害

OpenTP1ファイル所有者の変更 ,[2]

OpenTP1ファイルのアクセス許可モードの変更 ,[2]

OpenTP1ファイルの再作成

OpenTP1ファイルの作成 ,[2] ,[3]

OpenTP1ファイルの見積もり式

OpenTP1プログラムファイル

OpenTP1を開始できない場合

OSI TP通信の未決着トランザクション情報の表示

OSへの登録と削除

(Ｐ)

prcdlpath

prcdlpathls

prcdlpathコマンドで指定したサーチパス名の表示

prckill

prcls

prcpath

prcpathls

prctctrl

prctee

prfed

prfget

(Ｑ)

queinit

quels

querm

(Ｒ)

rapdfgen

rapls

rapsetup

rapクライアントマネジャの起動と停止

rapリスナーおよびrapサーバの起動と停止

rapリスナーおよびrapサーバの状態表示 ,[2]

RI

RMM

rpcdump

rpcmrg

rpcstat

RPCトレースに関する運用

RPCトレースの出力 ,[2]

RPCトレースのマージ ,[2]

RPCトレースファイル

RPC抑止リスト

rtsedit

rtsls

rtssetup

rtsstats

RTSログファイル

RTSログファイルの編集出力

(Ｓ)

scd_announce_server_statusとscd_this_node_firstオペランドの組み合わせ

scdchprc

scdhold

scdls

scdrles

scdrsprc

stsclose

stsfills

stsinit

stsls

stsopen

stsrm

stsswap

(Ｔ)

tamadd

tambkup

tamcre

tamdel

TAM FRC

tamfrc

TAM FRCを1回で実行するとき

TAM FRCを複数回に分けて実行するとき

tamhold

tamhsls

tamlckls

tamload

tamls

tamrles

tamrm

tamrstr

tamunload

TAMデータファイル

TAMデータファイルの形式とTAMファイルのデータ部のレコード形式との関係

TAMデータファイルを作成

TAMテーブルのアンロード

TAMテーブルの切り離し

TAMテーブルの状態管理

TAMテーブルの状態表示 ,[2]

TAMテーブルの追加

TAMテーブルの追加と切り離し

TAMテーブルの閉塞解除

TAMテーブルのロード

TAMテーブルのロードとアンロード

TAMテーブルの論理閉塞

TAMテーブルの論理閉塞と閉塞解除

TAM排他資源名称の変換

TAMファイルからのTAMデータファイルの作成

TAMファイル作成後のシノニム情報の表示

TAMファイルの運用

TAMファイルの回復 ,[2]

TAMファイルのサイズの見積もり式

TAMファイルの削除 ,[2]

TAMファイルの作成

TAMファイルの初期設定

TAMファイルの排他

TAMファイルのバックアップ ,[2]

TAMファイルのバックアップとリストア

TAMファイルのリストア ,[2]

TAMファイルのレコード数の拡張

TP1/Message Control

TP1/Message Control実行のための準備

TP1/Message Controlを使用する場合の環境設定の手順

TP1/Message Queueを使用する場合の環境設定の手順

TP1/Multi

TP1/NET/OSI-TP-Extendedを使用する運用

TP1/NET/OSI-TP-Extendedを使用する場合の環境設定の手順

tptrnls

trncmt

trndlinf

trnfgt

trnlnkrm

trnls

trnlsrm

trnmkobj

trnrbk

trnstics

TRNイベントトレース情報ファイル

TRNイベントトレース情報ファイルのバックアップファイル

(Ｕ)

UAPが異常終了する場合

UAPが終了しない場合

UAP共用ライブラリ

UAP共用ライブラリのサーチパス名の変更

UAP障害

UAPトレースデータファイル

UAPトレースデータファイルのバックアップファイル

UAPトレースの出力

UAPトレース編集出力ファイル

UAPの作成に使うファイル

UAPのデッドロックが発生する場合

UAPを開始できない場合

UNIXのメッセージ送受信関数で使用する資源の見積もり式

usmdump

(Ｘ)

xarevtr

xarfills

xarforce

xarhold

xarinit

xarls

xarrles

xarrm

XARイベントトレース情報の表示

XAR性能検証用トレース情報ファイル

XAR性能検証用トレース情報ファイルのバックアップファイル

XARトランザクション状態の変更

XARトランザクション情報の表示

XARファイルの削除

XARファイルの作成

XARファイルの状態表示

XAリソースサービス使用時のトランザクション統計情報の取得

XAリソースサービスの運用

XAリソースサービスの開始

XAリソースサービスの再開始

XAリソースサービスの終了

XAリソースサービスのトランザクション管理

XAリソースサービスのトレース

XAリソースサービスの閉塞

XAリソースサービスの閉塞解除

XAリソースサービスを使用する運用

(ア行)

(あ)

アーカイブジャーナルノード

アーカイブジャーナルファイル情報の表示

アーカイブジャーナルファイルのアンロード

アーカイブジャーナルファイルのオープンとクローズ

アーカイブジャーナルファイルの構成，および作成と定義

アーカイブジャーナルファイルの再使用

アーカイブジャーナルファイルのサイズの見積もり式

アーカイブジャーナルファイルの状態遷移

アーカイブジャーナルファイルのステータス変更

アーカイブジャーナルファイルのスワップ

アーカイブジャーナルファイルの使い方

アーカイブ状態の表示 ,[2]

アプリケーション異常終了回数の初期化 ,[2]

アプリケーション起動サービスのMCFメイン関数の作成方法

アプリケーション起動サービス用のMCFメイン関数 ,[2]

アプリケーションに関する運用

アプリケーションに関するタイマ起動要求の削除 ,[2]

アプリケーションに関するタイマ起動要求の表示 ,[2]

アプリケーションの状態表示 ,[2]

アプリケーションの閉塞

アプリケーションの閉塞解除

アプリケーションの閉塞と閉塞解除

アプリケーションプログラムの起動 ,[2]

アプリケーション閉塞とサービス閉塞のメッセージ

アプリケーション閉塞のメッセージの扱い

アンロード ,[2]

アンロードジャーナルファイル

アンロードジャーナルファイル，およびグローバルアーカイブアンロードジャーナルファイルの時系列ソート，およびマージ

アンロードジャーナルファイル，またはグローバルアーカイブアンロードジャーナルファイルの編集出力

アンロードジャーナルファイル，またはグローバルアーカイブアンロードジャーナルファイルのレコード出力

アンロードジャーナルファイル格納ディレクトリの運用

アンロードジャーナルファイルの時系列ソート，およびマージ

アンロードジャーナルファイルの複写 ,[2]

アンロードジャーナルファイルの編集出力

アンロードジャーナルファイルのレコード出力

アンロードジャーナルファイルを入力するコマンド一覧 ,[2]

アンロード済み状態 ,[2]

アンロードチェックの抑止 ,[2]

アンロード待ち状態 ,[2]

(い)

異常終了 ,[2]

異常終了時のメッセージ

異常終了時のメッセージの扱い

一時クローズ処理の実行状態の表示

イベント登録の方法

インストール ,[2]

インストール時，またはOSへの登録時に作成されるファイルとディレクトリ ,[2] ,[3]

(う)

上書きできない状態 ,[2]

上書きできる状態 ,[2]

運用コマンド ,[2]

運用コマンド実行時の環境

運用コマンド入力時の注意事項

運用コマンドの一覧

運用コマンドの概要

運用コマンドの記述形式

運用コマンドの詳細

運用コマンドの使用方法の表示

運用コマンドの入力方法

(お)

オープン

オープンとクローズコマンドによる状態の変化（アーカイブジャーナルファイル）

オープンとクローズコマンドによる状態の変化（システムジャーナルファイル）

オープンとクローズコマンドによる状態の変化（チェックポイントダンプファイル）

オプション

オプションフラグ

オンライン中にDAMファイルを追加する手順

オンライン中にTAMファイルを追加する手順

オンライン中のアーカイブジャーナルファイルの状態遷移

オンライン中のアーカイブジャーナルファイルの状態遷移表

オンライン中のシステムジャーナルファイルの状態遷移

オンライン中のステータスファイルの状態遷移

オンライン中のステータスファイルの状態遷移表

オンライン中のチェックポイントダンプファイルの状態遷移表

オンラインテスタ用ディレクトリ

オンラインバックアップ ,[2]

オンライン前トランザクション回復機能

(カ行)

(か)

ガーベジコレクション

開始 ,[2] ,[3]

開始形態

開始形態の決定

開始と終了

開始方法

開始方法の決定

開始モード

回復用ジャーナルの取得

書き込み中の状態

各種定義ファイル ,[2]

各種定義ファイルディレクトリ

片系運転可 ,[2]

片系運転可と片系運転不可の障害時のファイルグループの状態の相違

片系運転可のオンライン中のチェックポイントダンプファイルの状態遷移表

片系運転不可 ,[2]

片系運転不可のオンライン中のチェックポイントダンプファイルの状態遷移表

片系だけのオンライン操作の相違

稼働統計情報の出力 ,[2] ,[3]

環境設定

監査イベントの一覧と出力ポイント

監査イベントの出力情報

監査ログ機能の環境設定 ,[2]

監査ログに出力される情報

監査ログの運用

監査ログの運用例

監査ログの出力方式

監査ログファイルの見積もり例

監視対象リソースマネジャ用コマンド作成時の注意

(き)

起動通知情報の無効化

キャッシュブロック数のしきい値の設定

キャッシュブロック数の取得

キューグループの状態表示 ,[2]

キューに関する運用

強制正常終了

強制停止 ,[2] ,[3]

共用メモリ使用状況の表示 ,[2]

共用メモリダンプの出力

共用メモリダンプファイル

共用メモリに関する運用

共用ライブラリの変更

(く)

クローズ

グローバルアーカイブアンロードジャーナルファイル

グローバルアーカイブアンロードジャーナルファイル，およびアンロードジャーナルファイルの時系列ソート，およびマージ

グローバルアーカイブアンロードジャーナルファイルの編集出力

グローバルアーカイブアンロードジャーナルファイルのレコード出力

グローバルジャーナルサービス機能

グローバルジャーナルに関する運用

(け)

計画系切り替え

計画停止

計画停止A

計画停止B

系切り替え機能

系切り替え機能使用時の運用

系切り替え機能使用時のオンラインタイミング

系切り替え機能使用時の準備

系切り替えの方法

継続問い合わせ応答処理

現用 ,[2] ,[3]

(こ)

構成変更時の注意

構造体dc_mcf_dump_infoの形式

交代用PAGECモジュール読み込みパス

交代用物理マップ読み込みパス

コネクションに関する運用

コネクションの解放

コネクションの確立

コネクションの確立と解放

コネクションの切り替え ,[2]

コネクションの状態表示 ,[2]

コマンド引数

コマンド名

コマンドログ

コマンドログ取得のための準備

コマンドログディレクトリ

(サ行)

(さ)

サーチパスの引き継ぎ

サーチパス名の表示と変更

サーバ型コネクションの確立要求の受付開始

サーバ型コネクションの確立要求の受付終了

サーバに関する運用

サーバの開始

サーバの終了

サーバの状態表示 ,[2]

サーバリカバリジャーナルディレクトリ

サーバリカバリジャーナルファイルの運用

サーバリカバリジャーナルファイルの回復

サービスグループ自動閉塞後に到着したメッセージ

サービスグループに関する運用

サービスグループの状態表示 ,[2]

サービスグループの入力キュー削除 ,[2]

サービスグループの入力キュー処理の保留

サービスグループの入力キュー処理の保留解除

サービスグループの入力キュー処理の保留と保留解除

サービスグループの入力キューの内容出力

サービスグループの入力キューの内容複写

サービスグループの閉塞

サービスグループの閉塞解除

サービスグループの閉塞と閉塞解除

サービスに関する運用

サービスの状態表示 ,[2]

サービスの閉塞

サービスの閉塞解除

サービスの閉塞と閉塞解除

サービス閉塞のメッセージの扱い

再開始

再開始中読み込み済ジャーナル関係のファイル情報の表示

作成，初期設定するOpenTP1ファイルと使用する運用コマンド ,[2]

サンプルシナリオテンプレートのカスタマイズ

サンプルシナリオテンプレートの登録

サンプルシナリオテンプレートの利用

(し)

資源の表示

システム環境変数

システム管理情報ディレクトリ

システム共通定義の変更 ,[2]

システムサービス情報定義ファイルの作成

システムジャーナルファイル情報の表示

システムジャーナルファイルのアンロード

システムジャーナルファイルの運用

システムジャーナルファイルのオープンとクローズ

システムジャーナルファイルの再使用

システムジャーナルファイルのサイズの見積もり式

システムジャーナルファイルの作成と定義

システムジャーナルファイルの状態遷移

システムジャーナルファイルのステータス変更

システムジャーナルファイルのスワップ

システムジャーナルファイルの使い方

システム定義のオペランドの指定

システム定義の作成

システム定義のチェック

システム統計情報

システム統計情報のジャーナル出力

システム統計情報の取得開始，終了

システム統計情報の標準出力へのリアルタイム編集出力

システム統計情報の編集内容

システム内部同期制御用ディレクトリ

システム内部排他制御用ディレクトリ

実行環境の設定

実行系OpenTP1の終了

実行系と待機系のOpenTP1が使用するホスト名称の組み合わせ

自動アンロード機能の制御

自動アンロード機能を使用したアンロード

自動開始

自動系切り替え

シナリオ

シナリオテンプレート

シナリオテンプレートからのOpenTP1コマンドの実行

シナリオテンプレートを利用したシステムの運用

シナリオの登録

シナリオ変数

自ノードの優先

シフト方式

ジャーナルアンロードチェックの抑止 ,[2]

ジャーナル関係のファイル情報の表示

ジャーナル関係のファイルのアンロード

ジャーナル関係のファイルのオープン

ジャーナル関係のファイルの回復

ジャーナル関係のファイルのクローズ

ジャーナル関係のファイルの削除

ジャーナル関係のファイルの初期設定

ジャーナル関係のファイルのステータス変更

ジャーナル関係のファイルのスワップ

ジャーナル関係の物理ファイルの削除

ジャーナル関係の物理ファイルの割り当て

ジャーナル情報ディレクトリ

ジャーナルファイルレス機能

ジャーナルファイルレス機能を使用する運用

ジャーナルファイルレスモード

集積ジャーナルファイル ,[2]

集積ジャーナルファイルを使用してDAM FRCを実行するとき

集積ジャーナルファイルを使用してTAM FRCを実行するとき

終了 ,[2] ,[3]

終了方法 ,[2] ,[3]

終了モード ,[2] ,[3]

受信仕掛り中，または送信仕掛り中にmcftdctleコマンドを入力したときの動作

手動開始

障害時に作成されるファイル

障害時に取得する情報

障害対策

障害発生時の現象と原因

初期設定するOpenTP1ファイル

(す)

スーパユーザによる環境設定

スケールアウトの運用

スケールインの運用

スケジュールキュー上のサービス要求，および入出力キュー上のメッセージの扱い

スケジュールキュー情報ファイル

スケジュールキューの監視

スケジュールキューの滞留監視

スケジュールキューの滞留監視判定式

スケジュールに関する運用

スケジュールの再開始

スケジュールの自動閉塞

スケジュールの状態表示 ,[2]

スケジュールの閉塞

スケジュールの閉塞，および再開始

スケジュールバッファグループ

ステータスファイルの運用

ステータスファイルのオープン

ステータスファイルのオープンとクローズ

ステータスファイルのクローズ

ステータスファイルのサイズの見積もり式

ステータスファイルの削除 ,[2]

ステータスファイルの作成，初期設定

ステータスファイルの作成と定義

ステータスファイルの状態遷移

ステータスファイルの状態表示 ,[2]

ステータスファイルのスワップ

ステータスファイルの使い方

ステータスファイルの内容表示 ,[2]

ステータスファイルの容量が不足したとき

スワップ

スワップ機能

スワップ先のファイルグループがないとき ,[2]

(せ)

正常開始

正常終了 ,[2] ,[3]

性能検証用トレース情報解析

性能検証用トレース情報の解析例

性能検証用トレース情報の取得

性能検証用トレース情報の取得例

性能検証用トレース情報ファイル

性能検証用トレース情報ファイルのバックアップファイル

性能検証用トレースに関する運用

製品情報の表示

セションの開始

セションの開始と終了

セションの終了

全面回復時に引き継がれる情報

全面回復による再開始

(そ)

属性表記記号の意味

属性変更の手順

(タ行)

(た)

待機 ,[2]

待機系OpenTP1の終了

代行送信の開始

代行送信の開始と終了

代行送信の終了

退避コアファイル

退避コアファイルディレクトリ

タイマ起動引き継ぎ決定UOC

ダンプファイルの形式

(ち)

チェックポイントダンプ取得契機のスキップ回数の監視

チェックポイントダンプの取得先がないとき

チェックポイントダンプファイル情報の表示

チェックポイントダンプファイルの運用

チェックポイントダンプファイルのオープンとクローズ

チェックポイントダンプファイルのサイズの見積もり式

チェックポイントダンプファイルの削除

チェックポイントダンプファイルの作成と定義

チェックポイントダンプファイルの自動オープン

チェックポイントダンプファイルの使用順序

チェックポイントダンプファイルの状態遷移

チェックポイントダンプファイルの使い方

チェックポイントダンプファイルの二重化

(つ)

通常作成されるファイル

通信障害

通信制御装置，端末，回線障害

通信遅延時間統計情報

通信遅延時間統計情報の編集内容

(て)

定義オブジェクトファイルの作成

定義オブジェクトファイルの作成方法の概要

定義解析用ファイル

定義の作成

停止ノード情報の削除

ディスクキューのメッセージの扱い

ディファード更新機能 ,[2]

デッドロック，タイムアウト情報ファイル

デッドロック情報ファイルディレクトリ

デッドロック情報ファイルとタイムアウト情報ファイルの削除 ,[2]

(と)

統計情報の詳細

登録できるOpenTP1のイベント

途中の世代のシステムジャーナルファイルを使用してDAM FRCを実行するとき

ドメイン構成の変更

ドメイン構成の変更（システム共通定義使用）

ドメイン構成の変更（ドメイン定義ファイル使用）

ドメイン代表スケジュールサービス ,[2]

ドメイン代表スケジュールサービスの登録

ドメイン代表スケジュールサービスの登録と削除

ドメイン代表スケジュールサービスのポート番号の登録

ドメイン通信の環境設定

ドメイン定義ファイル

ドメイン定義ファイルの更新

ドメインデータファイル ,[2]

トラブルシュート情報の削除

トランザクションジャーナルディレクトリ

トランザクション情報ディレクトリ

トランザクション制御用オブジェクト格納ディレクトリ

トランザクション制御用オブジェクトファイルの作成 ,[2] ,[3]

トランザクション統計情報

トランザクション統計情報の取得開始，終了 ,[2]

トランザクション統計情報の編集内容

トランザクションに関する運用

トランザクションの回復待ち合わせ（Oracle9i RAC機能使用時）

トランザクションの強制決着

トランザクションの強制終了 ,[2]

トランザクションのコミット

トランザクションの状態表示 ,[2]

トランザクションのロールバック

トランザクションリカバリジャーナルファイルの運用

トランザクションリカバリジャーナルファイルの回復

トレース情報ダンプファイル

トレース情報ファイルの取り出し

トレース情報ファイルの編集出力

トレースデータファイル名

トレースに関する運用

(ナ行)

(な)

内部制御用資源の確保 ,[2]

(に)

入出力キューのダンプファイルの形式

入出力キューの内容複写

入出力キューの内容複写ファイル

入力シナリオ変数

入力シナリオ変数から設定する環境変数

(ね)

ネットワークの状態表示

(の)

ノード間負荷バランス

ノード間負荷バランスの拡張機能

ノードのオプション情報の変更

ノードリストファイルの削除

ノードリストファイルの初期設定

ノードリストファイルの内容表示

(ハ行)

(は)

排他情報の表示 ,[2]

排他制御用テーブルのプール情報の表示 ,[2]

排他に関する運用

パス名の変更

ハッシュ形式のTAMファイルおよびTAMテーブルのシノニム情報の表示

バッファグループの使用状況表示 ,[2]

(ひ)

被アーカイブジャーナルノード

被アーカイブジャーナルノードのシステムジャーナルファイルのアンロード

被アーカイブジャーナルノードのファイル回復

ヒューリスティック決定

標準出力，標準エラー出力のリダイレクト

標準出力ファイルに関する運用

標準用PAGECモジュール読み込みパス

標準用物理マップ読み込みパス

(ふ)

ファイル回復用ジャーナルの集積 ,[2] ,[3]

ファイルグループ

ファイルグループがオープン状態 ,[2]

ファイルグループがクローズ状態 ,[2]

ファイルグループが使用可能状態 ,[2]

ファイルグループが使用不可能状態 ,[2]

ファイル障害

付加機能

負荷状態の参照

複数のDAM FRCを同時に実行するとき

不正ジャーナル情報ファイル

物理ファイルと論理ファイルの対応

物理ファイルの削除

物理ファイルの作成

物理ファイルの初期設定

物理ファイルのバックアップ

物理ファイルのリストア

フラグ引数

プロセスサービスイベントトレース情報ファイル

プロセスサービスイベントトレース情報ファイルのバックアップファイル

プロセスサービス情報ディレクトリ

プロセスサービスの再起動および定義の反映

プロセス数の変更 ,[2]

プロセスの停止および再起動

プロトコルとUOCを定義するMCFメイン関数

(へ)

閉塞

並列アクセス機能

(ほ)

保守資料の取得

(マ行)

(ま)

マップファイル

マップファイルのパス名変更

マップファイルのロード済み資源の表示

マネジャノードの変更

マルチOpenTP1の運用

マルチOpenTP1の環境設定

マルチノードエリア，サブエリアの開始

マルチノードエリア，サブエリアの終了

マルチノード機能使用時のOpenTP1障害

マルチノード機能使用時の運用

マルチノード機能使用時の通信障害

(み)

未決着トランザクション情報ファイル

未決着トランザクション情報ファイルの削除 ,[2]

(む)

無効

(め)

メッセージオブジェクトファイル

メッセージ格納バッファプール ,[2]

メッセージキューの滞留監視

メッセージキュー用物理ファイルの削除 ,[2]

メッセージキュー用物理ファイルの見積もり式

メッセージキュー用物理ファイルの割り当て ,[2]

メッセージ制御機能が取得するジャーナルの必要量の計算式

メッセージ制御機能で取得するジャーナル情報

メッセージ制御機能のジャーナル取得条件

メッセージ多重処理状況の表示

メッセージの送受信の運用

メッセージログ

メッセージログのリアルタイム出力機能の切り替え

メッセージログファイル

メッセージログファイルの表示

メッセージログファイルへの出力

メッセージログファイルへの出力，および編集出力機能

メッセージログ編集出力機能

メモリキューのメッセージの扱い

(ヤ行)

(ゆ)

ユーザが作成するファイル

ユーザが作成するファイルとディレクトリ ,[2]

ユーザサーバ，およびユーザサーバから起動されるコマンドのサーチパス

ユーザサーバ，およびユーザサーバから起動されるコマンドのサーチパス名の表示

ユーザサーバ，およびユーザサーバから起動されるコマンドのサーチパス名の変更

ユーザサーバの入れ替え

ユーザサーバの開始

ユーザサーバの終了

ユーザサーバの終了形態とOpenTP1全体の終了形態との関係

ユーザサーバの待機

ユーザサーバのプロセス

ユーザサーバプロセスのリフレッシュ機能

ユーザジャーナルの取得

ユーザタイマ監視の状態表示

ユーザの環境設定

ユーザプログラムファイル ,[2]

ユーザプログラムファイルディレクトリ

(よ)

要素ファイル

要素ファイルがオープン状態 ,[2]

要素ファイルがクローズ状態 ,[2]

要素ファイルが使用可能状態 ,[2]

要素ファイルが使用不可能状態 ,[2]

要素ファイルの状態と物理ファイルの状態の関係 ,[2]

予備

予約 ,[2] ,[3]

(ラ行)

(り)

リアルタイム出力機能

リアルタイム統計情報

リアルタイム統計情報サービスの開始と終了

リアルタイム統計情報サービスの実行環境の設定

リアルタイム統計情報サービスを使用する運用

リアルタイム統計情報サービスを使用するための準備

リアルタイム統計情報のRTSログファイルの編集出力

リアルタイム統計情報のRTSログファイルへの出力

リアルタイム統計情報の出力

リアルタイム統計情報の取得

リアルタイム統計情報の取得情報の設定変更

リアルタイム統計情報の設定変更

リアルタイム統計情報の標準出力への出力 ,[2]

リカバリジャーナルファイルの運用

リカバリジャーナルファイルの回復

リソースグループの接続の強制解除

リソースの扱い

リソースマネジャ起動待ち合わせ機能

リソースマネジャに関する運用

リソースマネジャの情報

リソースマネジャの情報の表示 ,[2]

リソースマネジャの登録

リソースマネジャの登録と削除 ,[2]

リソースマネジャモニタ

リソースマネジャモニタの運用

リモートAPI機能に使用する定義の自動生成 ,[2]

リモートAPI機能の実行環境の設定

リモートAPI機能の性能改善

リモートAPI機能を使用する運用

リモートAPI機能を使用するための準備

(れ)

レコード数の見積もり式

レコード長の見積もり式

レコードロック数の見積もり式

レスポンス統計情報

レスポンス統計情報の編集内容

連動系切り替え

(ろ)

ローリングアップデートの運用

ログ機能

ログ出力量に関する注意事項

論理端末に関する運用

論理端末に関するメッセージジャーナル取得の開始と終了

論理端末に関するメッセージジャーナルの取得開始

論理端末に関するメッセージジャーナルの取得終了

論理端末に対する継続問い合わせ応答処理の強制終了 ,[2]

論理端末の出力キュー削除 ,[2]

論理端末の出力キュー処理の保留

論理端末の出力キュー処理の保留解除

論理端末の出力キュー処理の保留と保留解除

論理端末の出力キューの内容出力

論理端末の出力キューの内容複写

論理端末の状態表示 ,[2]

論理端末の閉塞

論理端末の閉塞解除

論理端末の閉塞と閉塞解除

論理端末のメッセージキューの先頭スキップ ,[2]

論理ファイル

論理ファイルの回復

論理ファイルの切り離し

論理ファイルの状態表示

論理ファイルの追加

論理ファイルの閉塞解除

論理ファイルの論理閉塞

論理ファイルの論理閉塞と閉塞解除

■ 商標類

AIXは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
BSDは，米国Berkeley Software Design, Inc.の商品名称です。
HP-UXは，Hewlett-Packard Development Company, L.P.のオペレーティングシステムの名称です。
Linuxは，Linus Torvalds氏の日本およびその他の国における登録商標または商標です。
OracleとJavaは，Oracle Corporation 及びその子会社，関連会社の米国及びその他の国における登録商標です。
OSFは，Open Software Foundation, Inc.の商標です。
Red Hatは，米国およびその他の国でRed Hat, Inc. の登録商標もしくは商標です。
UNIXは，The Open Groupの米国ならびに他の国における登録商標です。
Windowsは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
X/Openは，The Open Groupの英国ならびに他の国における登録商標です。
XATMIは，X/Open Company Limitedが開発したアプリケーションインタフェースの名称です。
その他記載の会社名，製品名は，それぞれの会社の商標もしくは登録商標です。
プログラムプロダクト「P-9D64-3F31，P-9D64-8531，P-9D64-8931，R-19451-216，R-19452-216，R-19453-216，R-19454-216，R-19455-216，R-19456-216，R-19459-216，R-1945A-216，R-1945C-216，R-1945D-216，R-1945E-216，R-F19456-2156，R-F19456-21C6」には，Oracle Corporationまたはその子会社，関連会社が著作権を有している部分が含まれています。
プログラムプロダクト「P-9D64-3F31，P-9D64-8531，P-9D64-8931，R-19451-216，R-19452-216，R-19453-216，R-19454-216，R-19455-216，R-19456-216，R-19459-216，R-1945A-216，R-1945C-216，R-1945D-216，R-1945E-216，R-F19456-2156，R-F19456-21C6」には，UNIX System Laboratories, Inc.が著作権を有している部分が含まれています。

本書には，X/Openの許諾に基づき X/Open CAE Specification System Interfaces and Headers，Issue4，（C202 ISBN 1-872630-47-2）Copyright (C) July 1992，X/Open Company Limitedの内容が含まれています；
なお，その一部は IEEE Std 1003.1-1990，(C) 1990 Institute of Electrical and Electronics Engineers, Inc.及び IEEE std 1003.2/D12，(C) 1992 Institute of Electrical and Electronics Engineers, Inc.を基にしています。
事前に著作権所有者の許諾を得ずに，本書の該当部分を複製，複写及び転記することは禁じられています。

本書には，X/Openの許諾に基づき X/Open Preliminary Specification Distributed Transaction Processing : The TxRPC Specification（P305 ISBN 1-85912-000-8）Copyright (C) July 1993，X/Open Company Limitedの内容が含まれています；
事前に著作権所有者の許諾を得ずに，本書の該当部分を複製，複写及び転記することは禁じられています。

本書には，Open Software Foundation, Inc.が著作権を有する内容が含まれています。
This document and the software described herein are furnished under a license, and may be used and copied only in accordance with the terms of such license and with the inclusion of the above copyright notice. Title to and ownership of the document and software remain with OSF or its licensors.