OpenTP1 Version 7　分散トランザクション処理機能　OpenTP1 システム定義

文法書

3000-3-D52-D0

前書き

対象製品

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

輸出時の注意

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

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

商標類

HITACHI，Cosminexus，HAモニタ，HiRDB，JP1，OpenTP1，OSAS，uCosminexus，XMAPは，株式会社 日立製作所の商標または登録商標です。

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

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

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

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

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

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

本書には，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.

発行

2024年4月　3000-3-D52-D0

著作権

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

変更内容

変更内容（3000-3-D52-D0） uCosminexus TP1/Server Base 07-60，uCosminexus TP1/Server Base(64) 07-60，uCosminexus TP1/Message Control 07-60，uCosminexus TP1/Message Control(64) 07-60，uCosminexus TP1/Message Control 07-52，uCosminexus TP1/Message Control(64) 07-52

追加・変更内容

変更個所

jnl_max_datasizeオペランドのMCFで取得するCJの計算式について，凡例の説明を変更した。

3.　システムサービス定義の詳細

システムジャーナルサービス定義

mcfmcomn定義コマンドの-jの計算式について，凡例の説明を変更した。

5.　ネットワークコミュニケーション定義の詳細

mcfmcomn

プロセスサーバの共用メモリの見積もり式を変更した。

付録B.1(1)(b)

MCF通信プロセスおよびアプリケーション起動プロセスで使用する共用メモリの算出式について，凡例の説明を変更した。

付録B.2(1)(b)

MCFマネジャプロセスで使用する共用メモリの算出式について，凡例の説明を変更した。

付録B.2(2)(a)

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

変更内容（3000-3-D52-C0） uCosminexus TP1/Server Base 07-60，uCosminexus TP1/Server Base(64) 07-60

追加・変更内容

マニュアル訂正の内容を反映した。

次のオペランドの説明順序をアルファベット順に変更した。

性能検証用トレース定義

prf_buff_size

prf_file_count

prf_file_size

prf_information_level

prf_trace_backup

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

prf_file_count

prf_file_size

prf_information_level

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

prf_file_count

prf_file_size

prf_information_level

prf_trace_backup

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

prf_file_count

prf_file_size

prf_information_level

TRNイベントトレース定義

prf_file_count

prf_file_size

prf_information_level

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

prf_file_count

prf_file_size

prf_information_level

次のオペランドに応答電文受信用IPアドレス通知機能の説明を追加した。

システム共通定義

ipc_notify_response_host

次のオペランドにsocketが使用できないことを記載した。

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

receive_from

ユーザサービス定義

receive_from

また，表3-24のreceive_fromオペランドのSPPに関する注釈を削除した。

変更内容（3000-3-D52-B0） uCosminexus TP1/Server Base 07-57，uCosminexus TP1/Server Base(64) 07-57，uCosminexus TP1/Server Base 07-56，uCosminexus TP1/Server Base(64) 07-56，uCosminexus TP1/Server Base 07-54，uCosminexus TP1/Server Base(64) 07-54，uCosminexus TP1/Server Base 07-53，uCosminexus TP1/Server Base(64) 07-53

追加・変更内容

マニュアル訂正の内容を反映した。

記号の説明を追加した。

次のオペランドに説明を追加および変更した。

システム共通定義

ipc_notify_response_host

ipc_response_host

システムジャーナルサービス定義

jnl_arc_buff_size

性能検証用トレース定義

prf_buff_size

ネームサービス定義

watch_time

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

prf_information_level

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

prf_file_count

prf_trace_backup

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

prf_information_level

TRNイベントトレース定義

prf_information_level

ユーザサービス定義

core_shm_suppress

trn_expiration_time_suspendオペランドと各種タイマ値の関係の説明を変更した。

変更内容（3000-3-D52-A1） uCosminexus TP1/Server Base 07-54，uCosminexus TP1/Server Base(64) 07-54，uCosminexus TP1/Server Base 07-53，uCosminexus TP1/Server Base(64) 07-53

追加・変更内容

マニュアル訂正の内容を反映した。

構文要素記号のパス名の説明を変更した。

次のオペランドに説明を追加および変更した。

システム共通定義

ipc_backlog_count

ネームサービス定義

name_total_size

トランザクションサービス定義

trn_expiration_time

trn_completion_limit_time

DAMサービス定義

dam_max_block_size

rapリスナーサービス定義

rap_listen_backlog

ユーザサービス定義

trn_expiration_time

service_expiration_time

ipc_backlog_count

trn_completion_limit_time

ユーザサービスデフォルト定義の機能について，説明を追加した。

mcftenv定義コマンドの-aの指定値の説明を変更した。

diskitqオペランドの指定値の説明を変更した。

mcftenv定義コマンドの-q

name_total_sizeの算出式の説明を変更した。

変更内容（3000-3-D52-A0） uCosminexus TP1/Server Base 07-53，uCosminexus TP1/Server Base(64) 07-53

追加・変更内容

環境変数を設定する場合の注意事項を追加した。

次のオペランドを追加した。

システム環境定義

redirect_file_name

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

stack_size_unlimited

ユーザサービス定義

stack_size_unlimited

販売終了製品に関連する機能の記載（次のオペランド記載個所など）を削除した。

log_netm_out，

log_netm_allno，

log_netm_prcid，

log_netm_prcno，

log_netm_sysid，

log_netm_date，

log_netm_time，

log_netm_hostname，

log_netm_pgmid

次のオペランドに説明を追加した。

システム環境定義

static_shmpool_size

dynamic_shmpool_size

システム共通定義

my_host

dcbindht

変更内容（3000-3-D52-90） uCosminexus TP1/Server Base 07-53，uCosminexus TP1/Server Base(64) 07-53，uCosminexus TP1/Server Base 07-52，uCosminexus TP1/Server Base(64) 07-52

追加・変更内容

系切り替え構成で待機系の起動をリトライできるようにした（待機系OpenTP1起動失敗時のリトライ機能）。

これに伴い，次のオペランドを追加した。

システム環境定義

ha_switch_error_retry_count

ha_switch_error_retry_interval

実行系OpenTP1システムが，dcstop -f（-fd）コマンドによる強制停止処理中に異常終了したとき，系切り替えを抑止するかどうかを指定できるようにした。

これに伴い，次のオペランドを追加した。

システム共通定義

dc_deter_restart_on_stop_fail

プロセスサービスを無応答状態から自動で復帰できるよう変更した（OpenTP1監視機能）。

これに伴い，次のオペランドを追加した。

システム共通定義

tp1_monitor_time

tp1_monitor_kill_signal

HiRDBとトランザクション連携をしているキュー受信型SPP使用時にHitachi System Information Captureのサーバ間連携機能を使用して，OpenTP1のprfトレースとHiRDBのSQLを関連付けできるように変更した。

これに伴い，次のオペランドの指定値を追加した。

トランザクションサービス定義のtrn_extend_function

00000002

自動アンロード機能使用時にディスク満杯や障害が発生した場合でも自動アンロード機能を継続できるようにした（自動アンロード継続機能）。

これに伴い，次のオペランドを追加した。

システムジャーナルサービス定義

jnl_auto_unload_continue

プロセスサービス定義のprcsvpathオペランドの説明に，複数パス名を指定した場合の注意事項を追加した。

システムサービス共通情報定義の次のオペランドを削除した。

thread_stack_size

mcf_stack_size

サービス応答の待ち時間の図の説明を変更した。

共用メモリの見積もり式にMCFサービスとTP1/Message Queueの見積もりを追加した。

共用メモリの見積もり式に監査ログ機能で使用する共用メモリの所要量の説明を追加した。

OpenTP1監視機能用の共用メモリの所要量の説明を追加した。

待機系OpenTP1起動失敗時のリトライ機能に関連した定義チェックの詳細を追加した。

自動アンロード継続機能に関連した定義チェックの詳細を追加した。

変更内容（3000-3-D52-80） uCosminexus TP1/Server Base 07-51，uCosminexus TP1/Server Base(64) 07-51，uCosminexus TP1/Message Control 07-51，uCosminexus TP1/Message Control(64) 07-51，uCosminexus TP1/NET/Library 07-51，uCosminexus TP1/NET/Library(64) 07-51

追加・変更内容

マニュアル訂正の内容を反映した。

メッセージログ出力時に，要求元のプロセスのプロセスIDを従来フォーマットの5けたで表示するかどうかを指定できるようにした。

これに伴い，次のオプションを追加した。

ログサービス定義

DCLOGDEFPID環境変数

変更内容（3000-3-D52-70） uCosminexus TP1/Server Base 07-51，uCosminexus TP1/Server Base(64) 07-51，uCosminexus TP1/Message Control 07-51，uCosminexus TP1/Message Control(64) 07-51，uCosminexus TP1/NET/Library 07-51，uCosminexus TP1/NET/Library(64) 07-51

追加・変更内容

次のオペランドに指定できる値の説明を変更した。

システム環境定義

static_shmpool_size

dynamic_shmpool_size

システム共通定義

prc_coredump_filter

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

prc_coredump_filter

ユーザサービス定義

prc_coredump_filter

共用メモリにLinuxのHugepage機能を適用できるようにした。

これに伴い，次のオプションを追加した。

システム環境定義

shmpool_attributeのhugepage

DAMサービス定義

dam_cache_attributeのhugepage

TAMサービス定義

tam_pool_attriのhugepage

ノード間通信で確立したコネクションを保持したままにするか，ノード間通信が終了するたびにコネクションを切断するかどうかを指定できるようにした。

これに伴い，次のオペランドを追加した。

システム共通定義

rpc_close_after_send

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

rpc_close_after_send

ユーザサービス定義

rpc_close_after_send

Hugepage機能を適用するときに，使用可能なグループ識別子を指定できるようにした。

これに伴い，次のオペランドを追加した。

プロセスサービス定義

prc_hugepage_group_id

次のオペランドの説明に，指定値の範囲の説明を追加した。

システム共通定義

max_socket_descriptors

ネームサービス定義

max_socket_descriptors

プロセスサービス定義

max_socket_descriptors

スケジュールサービス定義

max_socket_descriptors

トランザクションサービス定義

max_socket_descriptors

ジャーナルサービス定義

max_socket_descriptors

グローバルアーカイブジャーナルサービス定義

max_socket_descriptors

XATMI通信サービス定義

max_socket_descriptors

rapリスナーサービス定義

max_socket_descriptors

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

max_socket_descriptors

ユーザサービス定義

max_socket_descriptors

次のオペランドの説明に，指定値の範囲の説明を追加した。

スケジュールサービス定義

max_open_fds

XATMI通信サービス定義

max_open_fds

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

max_open_fds

ユーザサービス定義

max_open_fds

MHPの再スケジュール時に受信メッセージを入力キューに格納する位置を指定できるようにした。

これに伴い，次のオペランドを追加した。

mcfmuap定義コマンドの-cオプション

itqretryorder

次のオペランドの時間監視の設定時間と所要時間の誤差に関する説明を追加した。

mcfmuap定義コマンドの-tオプション

sndtim

sndrcvtim

recvtim

mcfmuap定義コマンドの-uオプション

ntmetim

mcfttim定義コマンドの-tオプション

mtim

rmtim

mcfaalcap定義コマンドの-vオプション

ntmetim

定義のコーディング例を変更した。

システムマネージャの静的共用メモリの計算式を変更した。

スケジューラの静的共用メモリの計算式を変更した。

DAMサービス定義のdam_cache_attributeオペランドにhugepageを指定した場合の説明を追加した。

TAMサービス用の共用メモリの算出式を変更した。

TAMサービス定義のtam_pool_attriオペランドにhugepageを指定した場合の説明を追加した。

システム環境定義のshmpool_attributeオペランドにhugepageを指定した場合の説明を追加した。

定義チェック時に出力されるメッセージおよび問題識別コードを追加，変更した。

変更内容（3000-3-D52-60） uCosminexus TP1/Server Base 07-50，uCosminexus TP1/Server Base(64) 07-50，uCosminexus TP1/Message Control 07-50，uCosminexus TP1/Message Control(64) 07-50，uCosminexus TP1/NET/Library 07-50，uCosminexus TP1/NET/Library(64) 07-50

追加・変更内容

次のオペランドおよびオプションの指定値の上限を変更した。

システム環境定義

server_count

スケジュールサービス定義

scd_server_count

システムサービス共通情報定義

max_socket_descriptors

max_open_fds

MCFマネジャ定義のmcfmexp定義コマンドの-gオプション

MCFマネジャ定義のmcfmexp定義コマンドの-lオプション

MCFマネジャ定義のmcfmsts定義コマンドの-gオプション

MCF通信構成定義のmcftsts定義コマンドの-aオプション

MCF通信構成定義のmcftsts定義コマンドの-lオプション

システム定義のデフォルト値を選択できるようにした。

これに伴い，次のオペランドを追加した。

システム環境定義

default_value_option

次のオペランドおよびオプションのデフォルト値の説明を変更した。

システム共通定義

trn_prf_trace_level

ipc_listen_sockbufset

fil_prf_trace_delay_time

ロックサービス定義

lck_deadlock_info

スケジュールサービス定義

ipc_tcpnodelay

ログサービス定義log_filesize

性能検証用トレース定義

prf_file_size

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

ipc_tcpnodelay

scd_refresh_process

MCFマネジャ定義のmcfmcomn定義コマンドの-iオプション

MCFマネジャ定義のmcfmuap定義コマンドの-eオプション

segsize

MCFマネジャ定義のmcfmuap定義コマンドの-cオプション

order

noansreply

システムサービス共通情報定義

mcf_prf_trace_level

スケジュールサービスプロセスで使用するファイルおよびパイプの最大数を指定できるようにした。

これに伴い，次のオペランドを追加した。

スケジュールサービス定義

max_open_fds

また，次のオペランドに説明を追加した。

ユーザサービス定義

max_open_fds

ジャーナルサービス，チェックポイントダンプサービス，およびグローバルアーカイブジャーナルサービスが出力するメッセージの種別を変更できるようにした。

これに伴い，次のオペランドを追加した。

ジャーナルサービス定義

jnl_message_id_change_level

チェックポイントダンプサービス定義

cpd_message_id_change_level

グローバルアーカイブジャーナルサービス定義

jnl_message_id_change_level

性能検証用トレースバッファを拡張できるようにした。

これに伴い，次のオペランドを追加した。

性能検証用トレース定義

prf_buff_size

また，バッファの拡張に伴い，使用する共用メモリが増加するため，静的共用メモリの算出式を変更した。

このサービスグループ下のサーバプロセスが異常終了した場合に，サーバプロセスの再起動を抑止するかどうかを指定できるようにした。

これに伴い，次のオペランドを追加した。

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

scd_process_ctl_opt

ユーザサービス定義

scd_process_ctl_opt

常設コネクションを使用し，かつオートコネクトモードの場合に，リモートAPI機能を使用してdc_rpc_call関数を呼び出すrapクライアント（SUP，SPP，MHP）で問い合わせ間隔最大時間をチェックするかどうかを指定できるようにした。

これに伴い，次のオペランドを追加した。

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

rpc_rap_inquire_time_check

ユーザサービス定義

rpc_rap_inquire_time_check

次のオペランドで指定する値が，同一OpenTP1ノード内での値であることを明確にした。

システム環境定義

server_count

プロセスサービス定義

prc_process_count

システムサービス構成定義のclt_confオペランドに，CUPからクライアント拡張サービスを使用する場合の説明を追加した。

dcsvstartコマンドの説明に，ユーザサーバの起動順序の説明を追加した。

システム共通定義のname_notifyオペランドの注意事項に，起動通知機能が使用できない理由の説明を追加した。

システムサービス共通情報定義でもthdlock_sleep_timeオペランドが指定できることの説明を追加した。

システム共通定義のprc_current_work_pathオペランドに，tmpディレクトリを削除する場合の説明を追加した。

ネームサービス定義のname_audit_confオペランドの注意事項に，ノード監視機能が使用できない理由の説明を追加した。

ステータスデーモンへのRPC要求電文の拡張に伴い，スケジュールサービス定義のscd_hold_recovery_countオペランドの説明を変更した。

TCP_NODELAYオプションを使用することで，ネットワーク帯域の負荷が大きくなる場合の対処の説明を変更した。

次のオプションの説明に，指定可能な文字の説明を追加した。

trnstring定義コマンドの-o

trnstring定義コマンドの-c

trnstring定義コマンドの-O

trnstring定義コマンドの-C

チェックポイントダンプサービス定義のjnl_reduced_modeオペランドに，縮退運転時はassurance_countオペランドの指定が無視される説明を追加した。

次のオペランドで指定する値について説明を追加した。

TAM サービス定義

tam_max_tblnum

tam_max_filesize

rapリスナーサービス定義の注意事項の説明を変更した。

ユーザサービス定義のterm_watch_timeオペランドについて，holdオペランド，term_watch_timeオペランドの指定値と，サーバの閉塞の関係に関する説明を追加した。

ユーザサービス定義のterm_watch_timeオペランドについて，連続異常終了限界経過時間が解除される契機の説明を追加した。

ユーザサービス定義のauto_restartオペランドの説明を変更した。

次の定義コマンドの指定数の上限を拡張した。

mcfmsvg

mcfaalcap

出力キューの入力保留中にUAPがメッセージを送信したときの動作を指定できるようにした。

これに伴い，次のオペランドを追加した。

mcfmuap定義コマンドの-cオプション

otqinhold

OpenTP1再開始時のエラーイベントを引き継ぐかどうかを指定できるようにした。

これに伴い，次のオペランドを追加した。

mcfmuap定義コマンドの-cオプション

errevt_recovery

OpenTP1の正常開始または再開始で，MCFのプロセス間で互いの状態を監視する際の時間間隔を指定できるようにした。

これに伴い，次のオペランドを追加した。

システムサービス共通情報定義

mcf_start_watch_interval

定義オブジェクトファイルの出力先にファイルがすでに存在していたとしても，定義オブジェクトファイルを上書きできるようにした。

これに伴い，次のオプションを追加した。

mcfmngrの-r

mcfcomnの-r

mcfpsvrの-r

mcfapliの-r

mcflinkの-r

MCF定義オブジェクト解析コマンドの解析結果での省略値の扱いについて，説明を追加した。

MCFマネジャ定義のmcfmexp定義コマンドの-gオプションについて，指定値の説明を変更した。また，同コマンドの-lオプションについても，指定値と注意事項の説明を変更した。

閉塞されている論理端末のメッセージが未処理送信メッセージ滞留時間の対象とならないことを追加した。

ユーザサーバの多重度を変更する場合に見直しが必要な定義の一覧に，rapリスナーサービス定義のrap_parallel_serverオペランドを追加した。

チェックポイントダンプの有効化チェック間隔の変更に伴い，チェックポイントダンプの静的共用メモリの算出式を変更した。

TP1/Server Baseの共用メモリの拡張に伴い，静的共用メモリおよび動的共用メモリの算出式を変更した。

MCFサービス用の共用メモリの見積もり式を変更した。

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

追加・変更内容

メッセージキューサービス定義の定義ファイル数を0〜1に変更した。

ノード構成の変更（ノードの追加や削除）に自動的に対応できるようにした（ノード自動追加機能）。

これに伴い，次のオペランド，またはコマンドを追加した。

システム共通定義

name_service_mode

name_manager_node

name_remove_down_node

name_node_add_policy

ネームサービス定義

name_start_watch_time

name_start_retry_count

name_start_retry_interval

name_start_error

name_sync_ready_time

namnlfil

また，次のオペランドに説明を追加した。

システム共通定義

all_node

name_notify

all_node_ex

ネームサービス定義

name_total_size

name_cache_size

name_audit_conf

name_audit_interval

name_audit_watch_time

name_cache_validity_time

TCP/IPの送信バッファサイズ，および受信バッファサイズに，OSの送信バッファサイズを適用できるようにした。

これに伴い，次のオペランドで0を指定できるようにした。

システム共通定義

ipc_recvbuf_size

ipc_sendbuf_size

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

ipc_recvbuf_size

ipc_sendbuf_size

ユーザサービス定義

ipc_recvbuf_size

ipc_sendbuf_size

また，定義チェック時に出力される問題識別コードに「RPC-0027」を追加した。

ユーザサーバごとに，共有化したバッファの使用サイズを制限できるようにした。

これに伴い，次のオプションを追加した。

スケジュールサービス定義

scdbufgrp定義コマンドの-e，-s，-p

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

scdbufgrp定義コマンドの-s，-p

ユーザサービス定義

scdbufgrp定義コマンドの-s，-p

また，次のオプションの最大値を変更した。

スケジュールサービス定義

scdbufgrp定義コマンドの-n

次のオプション，およびオペランドの説明を変更した。

スケジュールサービス定義

scdbufgrp定義コマンドの-l

ユーザサービス定義

message_store_buflen

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

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

システム環境定義のuser_commandオペランド，およびuser_command_onlineオペランドの，実行タイミング，および標準出力について説明を変更した。

システム環境定義のserver_countオペランドに指定するユーザサーバ数の説明を追加した。

システム共通定義のmax_socket_descriptorsオペランドについて説明を追加した。

自OpenTP1内のシステムサービスプロセスの数の具体的な求め方をmax_socket_descriptorsオペランドの説明に追加した。

システム共通定義のmy_hostオペランドについて，hostnameコマンドが返す名称がIPアドレスとマッピングできる環境設定が必要である説明を追加した。

性能検証用トレースの情報をCSV形式で出力し，トレース解析できるようにした。

メッセージ格納バッファプール長（message_store_buflenオペランドの指定値）の計算について，説明を追加した。

selectシステムコールの待ち時間の一覧表からバージョン情報を削除した。

ネームサービス定義のmax_socket_descriptorsオペランドの計算式を変更した。

非常駐プロセスを指定しているユーザサーバやscdrsprcコマンドを使用している場合に，一時的にプロセス数が増加するタイミングについて説明を追加した。

ログサービス定義のTZオペランドを変更する際に，dcsetupの実行が必要である説明を追加した。

DAMサービス定義のdam_update_blockオペランドの指定値の算出例を追加した。

DAMサービス定義のdam_update_block_overオペランドのflushの説明を追加した。

TAMサービス定義のtam_max_filesizeオペランドの説明を変更した。

uap_trace_maxオペランドの説明にUAPトレースの説明を追加した。

leveldown_queue_countオペランドのリンク誤りを修正した。

プロセス強制停止で，設定時間と所要時間に誤差が発生することをオペランドの説明に追加した。

使用するOSがWindowsの場合は，次のオプションを指定できない旨を追加した。

mcfmcomn定義コマンドの-w

mcftenv定義コマンドの-q

mcftpsvr定義コマンドの-oオプションの説明を変更した。

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

追加・変更内容

coreファイルに共有メモリを含めるかどうかを設定できるようにした。

これに伴い，次のオペランドを追加した。

システム共通定義

prc_coredump_filter

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

prc_coredump_filter

ユーザサービス定義

prc_coredump_filter

リモートAPI機能における性能検証用トレースの取得レベル，およびリモートAPI機能の拡張レベルを指定できるようにした。

これに伴い，次のオペランドを追加した。

rapリスナーサービス定義

scs_prf_trace_level

rap_extend_function

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

rap_extend_function

ユーザサービス定義

rap_extend_function

一つのサービス要求ごとに実行するプロセスを起動し直せるようにした（非常駐UAPプロセスのリフレッシュ機能）。

これに伴い，次のオペランドを追加した。

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

scd_refresh_process

ユーザサービス定義

scd_refresh_process

一つのリソースマネジャを複数の制御単位に分け，接続するユーザ名称などを変更してリソースマネジャに接続できるようにした（リソースマネジャ接続先選択機能）。

これに伴い，次のオプションを追加した。

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

trnrmid定義コマンドの-k

ユーザサービス定義

trnrmid定義コマンドの-k

次のオペランドの指定値について，HP-UX版の32ビット版のOpenTP1を使用する場合の，注意事項を追加した。

システム環境定義

static_shmpool_size

dynamic_shmpool_size

jnl_max_datasizeオペランドの指定値を求める計算式で，MCFサービスを使用する場合の計算式を変更した。

ログサービスにおける，メッセージ量に関する注意事項を追加した。

max_open_fdsオペランドに指定する，UAPプロセスでオープンするファイルディスクリプタの最大数に関する説明を追加した。

mcfmcomn定義コマンドの-pオプションの指定値の上限を変更した。

次のオプションの指定値を求める計算式を変更し，かつ64ビット版の説明を追加した。

mcfmcomn定義コマンドの-j

mcfmuap定義コマンドの-j

mcftcomn定義コマンドの-j

mcfmexp定義コマンドの-lオプションについて，指定する論理端末数に関する説明を追加した。

次のオプションのrescheduleintオペランドについて，異常終了したMHPを自動的に再スケジュールするまでの所要量に関する説明を追加した。

mcfmuap定義コマンドの-r

mcfaalcap定義コマンドの-d

MCFトレースファイルの大きさと，MCFトレースバッファの大きさを求める計算式を追加した。

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

追加・変更内容

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

これに伴い，システムサービス共通情報定義のputenv形式にDCMCFQUEBAKオペランドを追加した。

また，MCFマネジャプロセスで使用する共用メモリの算出式を変更した。

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

追加・変更内容

リモートMCFサービスに関する記述を削除した。

これに伴い，次のオペランドを削除した。

システムサービス構成定義

mrs_conf

MCFアプリケーション定義

mcfaalcap定義コマンドのtype

また次のコマンドのオプションを削除した。

MCFマネジャ定義

mcfmcomn定義コマンドの-r，-c

変更内容（3000-3-D52-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

追加・変更内容

トランザクションの回復処理で，XA関数の発行順序を変更できるようにした。

これに伴い，次のオペランドとオプションを追加した。

トランザクションサービス定義

trn_rcv_open_close_scope

trnstring定義コマンドの-s

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

これに伴い，次のオペランドを追加した。

チェックポイントダンプサービス定義

jnl_cdskip_limit

jnl_cdskip_msg

拡張RM登録定義で，コンパイルオプションとリンケージオプションを指定できるようにした。

これに伴い，trnlnkrm定義コマンドに次のオプションを追加した。

-C

-B

ユーザサービス構成定義のdcsvstart定義コマンドの指定例を追加した。

システム共通定義のall_nodeオペランドに無効IPアドレスを指定した場合の注意事項を追加した。

システム共通定義のname_notifyオペランドの注意書きを変更した。

システム共通定義のrpc_port_baseオペランドの説明で，使用するポート番号の数は，プロセスサービス定義のprc_process_countオペランドで指定した値（最大同時起動サーバプロセス数）に128を加えた値である旨に変更した。

オペランドの指定値の優先順位の説明を追加した。

プロセスサービス定義のprc_process_countオペランドで指定するプロセス数に含まれるコマンドについて，説明を追加した。

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

これに伴い，次のオペランドを追加した。

プロセスサービス定義

prc_take_over_dlpath

また，次のオペランドの説明を変更した。

ユーザサービス定義

service

指定値を論理和で指定する場合の説明を追加した。

MQAサービスを使用する場合の，ジャーナルに取得するレコードデータの最大長を求める計算式を変更した。

syslogに出力できるメッセージ長に関する注意事項を変更した。

英語環境でのsyslogへのメッセージ出力可否を追加した。

rapリスナーサービス定義のmax_socket_descriptorsオペランドの，最大数の計算式の説明を追加した。

異常終了したMHPを，自動的に再スケジュールできるようにした。

これに伴い，次のオプションとオペランドを追加した。

MCFマネジャ定義のmcfmuap定義コマンドの-rオプション

reschedulecnt

rescheduleint

reschedulelog

MCFアプリケーション定義のmcfaalcap定義コマンドの-dオプション

reschedulecnt

rescheduleint

reschedulelog

非応答型のMHPからの問い合わせ応答をできるようにした。

これに伴い，次のオペランドを追加した。

mcfmuap定義コマンドの-cオプション

noansreply

データ操作言語で，MHPをコミットできるようにした。

これに伴い，次のオペランドを追加した。

mcfmuap定義コマンドの-cオプション

commitdml

mcfcomn定義コマンドの-oオプションは，OSがWindowsの場合は指定できない旨を追加した。

mcfaalcap定義コマンドの次のオペランドの説明に，dc_mcf_rollback関数にDCMCFRTRYを指定（ROLLBACK文にRTRYを指定）した場合の説明を追加した。

-nオプションのaplihold

-gオプションのsrvghold

-vオプションのservhold

-dオプションのholdlimit

mcftlsbufコマンドで，送受信バッファの最大使用量を表示できるようにした。

プロセスサービス定義のprc_take_over_svpathオペランドを，再開始時に変更できるシステムサービス定義の一覧に追加した。

XATMI通信サービスの静的共用メモリの所要量の説明を追加した。

32ビットでトランザクションアクセス種別がグローバルアクセスの場合のDAMの動的共用メモリの算出式を変更した。

mcftlsleコマンドで，最大未送信メッセージ数を表示できるようにした。

MCFサービス用の動的共用メモリの見積もり式を変更した。

トランザクションサービス定義のtrn_optimum_itemオペランドに対応するバージョン5以前のオペランドの説明を追加した。

変更内容（3000-3-D52-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

追加・変更内容

ジャーナルサービスで性能検証用トレース（JNL性能検証用トレース）を出力できるようにした。

これに伴い，次の定義およびオペランドを追加した。

システム共通定義

jnl_prf_event_trace_level

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

また，次のオペランドの説明を変更した。

性能検証用トレース定義

prf_trace_backup

ロックサービスを使用した排他制御の各種イベントの性能検証用トレース（LCK性能検証用トレース）を出力できるようにした。

これに伴い，次の定義およびオペランドを追加した。

ロックサービス定義

lck_prf_trace_level

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

また，次のオペランドの説明を変更した。

性能検証用トレース定義

prf_trace_backup

定義作成時の注意事項を追加した。

定義の1行の最大長の説明を変更した。

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

これに伴い，次のオペランドを追加した。

システム共通定義

uap_trace_file_put

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

uap_trace_file_put

ユーザサービス定義

uap_trace_file_put

特定のノードのサービス情報を優先的に使用する機能（サービス情報優先度指定機能）を追加した。

これに伴い，次のオペランドの説明を変更した。

システム共通定義

all_node

name_domain_file_use

また，次のオペランドを追加した。

ネームサービス定義

name_cache_validity_time

次のオペランドで，RPCの処理のリトライを行うタイミングの説明を追加した。

システム共通定義

rpc_retry

rpc_retry_count

rpc_retry_interval

OpenTP1ファイルへのアクセス要求で，イベントトレース（FILイベントトレース）を出力できるようにした。

これに伴い，次のオペランドを追加した。

システム共通定義

fil_prf_trace_option

fil_prf_trace_delay_time

また，次のオペランドの説明を変更した。

性能検証用トレース定義

prf_trace_backup

次のオペランドのデフォルト値の説明を変更した。

トランザクションサービス定義

thread_stack_size

TAMサービス定義

tam_pool_attri

次のオペランドの説明を追加した。

システム共通定義

ipc_sockctl_highwater

ipc_sockctl_watchtime

rapリスナーサービス定義

ipc_sockctl_highwater

ipc_sockctl_watchtime

次のオペランドのfixedを指定する場合の説明を変更した。

システム環境定義

shmpool_attribute

DAMサービス定義

dam_cache_attribute

TAMサービス定義

tam_pool_attri

次のオペランドの，グローバルドメインの説明を変更した。

システム共通定義

rpc_multi_tp1_in_same_host

次のオペランドの説明に，MQAサービスを使用する場合のジャーナルに取得するレコードデータの最大長の計算式を追加した。

システムジャーナルサービス定義

jnl_max_datasize

次のオペランドでYを指定した場合の説明を追加した。

システムジャーナルサービス定義

jnl_unload_check

アーカイブジャーナルサービス定義

jnl_unload_check

ユーザサービス定義

service_hold

service_priority_control

次のオペランドの，syslog出力の説明を変更した。

ログサービス定義

log_syslog_out

DCSYSLOGOUT

次のオペランドの，バッファ領域長の仮定値計算式を変更した。

DAMサービス定義

dam_cache_size

dam_cache_size_fix

rapリスナーサービス定義で，注意事項を追加，および変更した。

rtsput定義コマンドのオプションと指定できる取得対象オブジェクトの説明を変更した。

次のオペランドの指定を省略した場合の説明を追加した。

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

rpc_trace

rpc_trace_name

rpc_trace_size

ユーザサービス定義

rpc_trace

trnrmid定義コマンドで-iオプションを指定する場合の注意事項を追加した。

次のオペランドの説明に，status_change_when_termingオペランドを指定する場合の説明を追加した。

ユーザサービス定義

node_down_restart

次の定義コマンドで，-jオプションの指定値の上限を拡張した。

mcfmcomn

mcfmuap

mcftcomn

mcfttim定義コマンドの-tオプションに，タイマ起動要求メッセージについての説明を追加した。

mcftalcle定義コマンドで，-mオプションに0を指定，または指定を省略した場合の出力メッセージ数を変更した。

mcfaalcap定義コマンドの-nオプションに，アプリケーション起動機能使用時の定義方法の説明を追加した。

mcfaalcap定義コマンドの-gオプション，および-vオプションに，指定時の注意と定義例を追加した。

定義の変更手順，注意事項の説明を変更した。

OpenTP1システムの変更に影響する定義として，状態引き継ぎ定義に次の定義を追加した。

mcfmsts定義コマンドの-gオプション

mcfmsts定義コマンドの-vオプション

OpenTP1システムの変更に影響する定義に，scdのscd_hold_recovery_countを追加した。

ホスト名またはIPアドレスの変更手順を追加した。

TP1/Server Base用の静的共用メモリの算出式を変更した。

共用メモリプールのサイズの算出式を追加した。

MCFサービス用の静的共用メモリの算出式と，定義指定値の関係についての説明を追加した。

MCFサービス用の静的共用メモリの算出式を変更した。

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

定義チェック時に出力されるメッセージ，および問題識別コードを追加，変更した。

バージョン5以前からバージョン7に移行する場合の注意事項についての説明を追加した。

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

追加・変更内容

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

これに伴い，次のオペランドの説明を変更した。

ユーザサービス定義

service

MCF静的共用メモリが不足した場合，未使用領域から自動的に追加確保できるようにした。

これに伴い，次のオプションを追加した。

mcfmcomn定義コマンドの-iオプション

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

追加・変更内容

メッセージ送受信での主なイベントで，性能検証用トレース（MCF性能検証用トレース）を出力できるようにした。

これに伴い，次の定義およびオペランドを追加した。

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

mcf_prf_trace

ユーザサービス定義

mcf_prf_trace

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

システムサービス情報定義

mcf_prf_trace

システムサービス共通情報定義

mcf_prf_trace_level

また，次のオペランドの説明を変更した。

性能検証用トレース定義

prf_trace_backup

リアルタイム統計情報の取得項目として，MCFの情報も取得できるようにした。

これに伴い，次の定義およびオペランドを追加した。

リアルタイム取得項目定義

rts_mcf_ap_scd_stay

rts_mcf_ap_usr_srvc

rts_mcf_in_msg_scd_wait

rts_mcf_out_msg_sync_scd_wait

rts_mcf_out_msg_resp_scd_wait

rts_mcf_out_msg_prio_scd_wait

rts_mcf_out_msg_norm_scd_wait

rts_mcf_que_scd_wait_num

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

追加・変更内容

XAリソースサービスで性能検証用トレース（prfトレース）を出力できるようにした。

これに伴い，次の定義およびオペランドを追加した。

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

XARリソースサービス定義

xar_prf_trace_levelオペランド

定義の1行の最大長の説明を変更した。

システムジャーナルファイルを使用しないでシステムを運用する機能（ジャーナルファイルレス機能）を追加した。

これに伴い，次の内容を追加した。

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

ジャーナルサービス定義，およびシステムジャーナルサービス定義の注意事項

システムサービス定義を登録する定義ファイル数

ユーザサービス定義のatomic_updateオペランドの注意事項

ジャーナルファイルレス機能を使用するノードでの共用メモリの見積もり式

また，ジャーナルファイルレス機能が有効になっている場合に，XAリソースサービスは使用できないことを追加した。

スレッド間で排他が競合した場合のスレッドの待ち時間を設定する機能を拡張した。

これに伴い，次の定義のthdlock_sleep_timeオペランドの指定範囲を変更した。

システム共通定義

システムサービス共通情報定義

また，指定時の注意事項を追加した。

さらに，ユーザサービス定義，およびユーザサービスデフォルト定義のthdlock_sleep_timeオペランドを削除した。

LinuxおよびAIXでユーザ認証機能を使用できるようにした。

これに伴い，システム共通定義のclient_uid_checkオペランドの省略値を変更した。

ネームサービスでイベントトレースを出力できるようにした。

これに伴い，システム共通定義にnam_prf_trace_levelオペランドを追加した。

プロセスサービスでイベントトレースを出力できるようにした。

これに伴い，プロセスサービス定義のprc_prf_traceオペランドの説明を変更した。

トランザクションサービス定義のtrn_tran_process_countオペランドに，MCFサービスを使用する場合の指定範囲を追加した。

システムジャーナルファイルの並列アクセス機能を追加した。

これに伴い，システムジャーナルサービス定義に次のオペランドおよびオプションを追加した。

jnl_max_file_dispersionオペランド

jnl_min_file_dispersionオペランド

jnladdpf定義コマンドの-eオプション

また，アーカイブジャーナルサービス定義の次のオペランドおよびオプションの説明を変更した。

jnl_max_file_dispersionオペランド

jnl_min_file_dispersionオペランド

jnladdpf定義コマンドの-eオプション

監査ログを出力する機能を追加した。

これに伴い，次のオペランドを追加した。

ログサービス定義

log_audit_out

log_audit_path

log_audit_size

log_audit_count

log_audit_message

rapリスナーサービス定義

log_audit_out_suppress

log_audit_message

rapクライアントマネジャサービス定義

log_audit_out_suppress

log_audit_message

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

log_audit_out_suppress

log_audit_message

ユーザサービス定義

log_audit_out_suppress

log_audit_message

リモートAPI機能に関する次の説明を追加した。

rapリスナーサービス定義

rap_term_disconnect_time

rap_stay_watch_time

rap_stay_warning_interval

watch_time

再開始時に変更できるシステムサービス定義

rapリスナーサービス定義

rapクライアントマネジャサービス定義

また，次の説明を変更した。

rapリスナーサービス定義

rap_connect_interval

rap_recovery_server

rapリスナーサービス定義の注意事項

PRFトレースファイルのバックアップ抑止機能を追加した。

これに伴い，性能検証用トレース定義にprf_trace_backupオペランドを追加した。

リアルタイム統計情報サービスで，RTSログファイルをバックアップする機能を追加した。

これに伴い，リアルタイム統計情報サービス定義にrts_log_file_backupオペランドを追加した。

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

これに伴い，リアルタイム取得項目定義に次のオペランドを追加した。

rts_scd_svc_scd_waitオペランド

rts_scd_svc_using_bufオペランド

rts_scd_parallelオペランド

スケジュールサービスの動作をサービス単位で指定できるようになった。

これに伴い，次の定義にscdsvcdef定義コマンドを追加した。

ユーザサービス定義

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

また，ユーザサービス定義の次のオペランドにscdsvcdef定義コマンドを指定した場合の留意点を追加した。

message_store_buflenオペランド

message_cell_sizeオペランド

さらに，TP1/Server Base用の静的共用メモリの算出式で，スケジューラのメモリ算出式を変更した。

サービス関数を動的にローディングできる機能を追加した。

これに伴い，ユーザサービス定義のserviceオペランドの指定値に，「UAP共用ライブラリ名」を追加した。

また，リアルタイム統計情報サービス定義のrtsput定義コマンドの注意事項を追加した。

Linux版で，syslogメッセージの出力を失敗した場合に，syslogメッセージの出力をリトライできるようにした。

これに伴い，次に示すオペランドの説明を変更した。

log_syslog_elist

log_syslog_elist_rint

タイムゾーンの指定についての注意事項を追加した。

リアルタイム統計情報の取得項目の定義例を追加した。

typeオペランドで指定できるサービスグループの種別からRAPを削除した。

入力キューに滞留するメッセージキューを監視する機能を追加した。

これに伴い，MCFマネジャ定義にサービスグループ属性定義を追加した。

mcfmsmsg定義コマンドの指定範囲を変更した。

アプリケーション属性定義を指定するとき，モデルとする定義の指定内容を流用できる機能を追加した。

これに伴い，MCFアプリケーション定義のmcfaalcap定義コマンドに-Nオプションを追加した。

MCF定義オブジェクト生成ユティリティ起動コマンドの-oオプションの説明を変更した。

次に示すオプションを指定した場合の引き継ぐ対象の説明を変更した。

mcfmsts定義コマンドの-gオプション

mcfmsts定義コマンドの-vオプション

mcftsts定義コマンドの-aオプション

OpenTP1システムの変更に伴って見直す必要のある定義の一覧を追加した。

システム共通定義のprf_traceオペランドを指定した場合の共用メモリの所要量を追加した。

TP1/Server Base用の動的共用メモリの算出式で，メモリキューだけの構成の場合の算出方法を追加した。

定義チェック時に出力されるメッセージおよび問題識別コードを追加，変更した。

はじめに

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

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

次に示す製品，および各製品に示したバージョン以降で，ソケット受信型サーバに関する機能はすべて廃止しました。そのため，ユーザサービス定義とユーザサービスデフォルト定義のreceive_fromオペランドでsocketは使用できません。

P-1M64-2141 uCosminexus TP1/Server Base：07-53-01以降

P-1M64-1121 uCosminexus TP1/Server Base(64)：07-53-01以降

P-1J64-2171 uCosminexus TP1/Server Base：07-51-02以降

P-1J64-1171 uCosminexus TP1/Server Base(64)：07-51-01以降

P-8164-2111 uCosminexus TP1/Server Base：07-57以降

P-8264-2111 uCosminexus TP1/Server Base(64)：07-57以降

P-2464-2294 uCosminexus TP1/Server Base：07-60以降

P-2964-2234 uCosminexus TP1/Server Base(64)：07-60以降

なお，該当する機能を使用した場合の動作は保証できないため，ご注意ください。

対象読者

システム管理者，およびシステム設計者を対象としています。

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

KB（キロバイト）などの単位表記について

1KB（キロバイト），1MB（メガバイト），1GB（ギガバイト），1TB（テラバイト）はそれぞれ1,024バイト，1,024²バイト，1,024³バイト，1,024⁴バイトです。

その他の前提条件

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

1　概要

OpenTP1のシステム定義の体系，定義の構成，定義の作成手順，および定義の規則について説明します。

1.1　定義の体系

OpenTP1の定義には，次の四つがあります。

システムサービス定義

TP1/Server Baseに関する情報を定義します。

システムで動作するサービス群の構成や，システム共通の実行環境の定義です。

ネットワークコミュニケーション定義

TP1/Message Controlに関する情報を定義します。

TP1/Message Controlのメッセージ制御機能を使って他システムと通信する場合の，システム論理構成や，使用する業務プログラム，サービスなどの実行環境の定義です。

プロトコル部分の詳細については，マニュアル「OpenTP1 プロトコル」の該当するプロトコル編を参照してください。

なお，このマニュアルでは，以後メッセージ制御機能をMCF（Message Control Facility）と呼びます。

メッセージキュー定義

TP1/Message Queueに関する情報を定義します。

TP1/Message Queueのメッセージキューイング機能を使って，他システムと通信する場合の実行環境の定義です。

なお，このマニュアルでは，メッセージキュー定義の詳細（MQT通信構成定義）は説明しません。MQT通信構成定義については，マニュアル「TP1/Message Queue 使用の手引」を参照してください。

ネットワークライブラリ定義

TP1/NET/Libraryに関する情報を定義します。

TP1/NET/OSI-TP-Extendedを使ってXATMIインタフェースでOSI TP通信をする場合の実行環境の定義です。

なお，このマニュアルでは，ネットワークライブラリ定義の詳細（TP1/NET/OSI-TP-Extendedの定義）は説明しません。TP1/NET/OSI-TP-Extendedの定義については，マニュアル「OpenTP1 プロトコル TP1/NET/OSI-TP-Extended編」を参照してください。

OpenTP1のシステム定義の体系を，次の図に示します。また，各定義の概要を以降の表に示します。

図1‒1　OpenTP1システム定義の体系

表1‒1　システムサービス定義の概要

項番

定義名

内容

1

システム環境定義

OpenTP1システムの実行環境を定義します。

2

システムサービス構成定義

同一マシンで一つのOpenTP1システムとしてシステム起動時に一緒に開始するサービス群の構成を定義します。

3

ユーザサービス構成定義

同一マシンで一つのOpenTP1システムとしてシステム起動時に一緒に開始するユーザサーバ群の構成を定義します。

4

システム共通定義

OpenTP1システム共通の実行環境を定義します。

5

ロックサービス定義

OpenTP1で排他制御機能を使用するための実行環境を定義します。

6

タイマサービス定義

時間監視サービスを行うための実行環境を定義します。

7

ネームサービス定義

RPCを可能にするサービス名とアドレスの対を管理するための実行環境を定義します。

8

プロセスサービス定義

OpenTP1環境下で実行するサーバプロセスを管理するための実行環境を定義します。

9

スケジュールサービス定義

OpenTP1環境下で動作するサーバへのサービス要求のスケジューリングをするための実行環境を定義します。

10

トランザクションサービス定義

トランザクション管理をするための実行環境を定義します。

11

XAリソースサービス定義

XAリソースサービスを使用してトランザクション管理をするための実行環境を定義します。

12

インタバルサービス定義

各システムサーバへ提供するインタバルタイマ機能の実行環境を定義します。

13

ステータスサービス定義

OpenTP1環境下で動作する各システムサービスの状態を管理するための実行環境を定義します。

14

ジャーナルサービス定義

システムジャーナルサービスとチェックポイントダンプサービスを使用するための実行環境を定義します。

15

システムジャーナルサービス定義

システムジャーナルファイルにジャーナルを取得するための実行環境を定義します。

16

チェックポイントダンプサービス定義

チェックポイントダンプファイルにチェックポイントダンプを取得するための実行環境を定義します。

17

ログサービス定義

メッセージログの出力環境を定義します。

18

マルチノード構成定義

マルチノードエリアまたはマルチノードサブエリアの構成を定義します。

19

マルチノード物理定義

OpenTP1ノードがあるホスト名とプロセスサーバデーモン（prcd）のポート番号を定義します。

20

グローバルアーカイブジャーナルサービス定義

グローバルアーカイブジャーナルサービスを使用するための実行環境を定義します。

21

アーカイブジャーナルサービス定義

アーカイブジャーナルファイルのファイルグループ名と属性を定義します。

22

DAMサービス定義

ファイル回復機能付き直接アクセスファイルを管理するための実行環境を定義します。

23

TAMサービス定義

TAMテーブルを管理するための実行環境を定義します。

24

クライアントサービス定義

OpenTP1のクライアント機能を支援するためのサーバの実行環境を定義します。

25

ISTサービス定義

ISTサービスを使用するための実行環境を定義します。

26

RMMサービス定義

RMMサービスを使用するリソースマネジャを定義します。

27

監視対象RM定義

RMMサービスのコマンドを定義します。

28

拡張RM登録定義

OpenTP1提供以外のリソースマネジャを登録するための実行環境を定義します。

29

XATMI通信サービス定義

TP1/NET/OSI-TP-Extendedを使ったXATMIインタフェースでのOSI TP通信の実行環境を定義します。

30

メッセージキューサービス定義

入出力メッセージのキューイングを管理するための実行環境を定義します。

31

ユーザサービスネットワーク定義

通信相手のサービス情報を定義します。

32

rapリスナーサービス定義

リモートAPI機能を使用する場合のrapリスナーを定義します。

33

rapクライアントマネジャサービス定義

リモートAPIクライアントマネジャ機能を使用するための実行環境を定義します。

34

性能検証用トレース定義

性能検証用トレース情報を取得する場合のファイルを定義します。

35

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

XAR性能検証用トレース情報を取得する場合の実行環境を定義します。

36

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

JNL性能検証用トレース情報を取得する場合の実行環境を定義します。

37

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

LCK性能検証用トレース情報を取得する場合の実行環境を定義します。

38

TRNイベントトレース定義

TRNイベントトレース情報を取得する場合の実行環境を定義します。

39

リアルタイム統計情報サービス定義

リアルタイム統計情報サービスの実行環境を定義します。

40

リアルタイム取得項目定義

リアルタイム統計情報を取得する項目を定義します。

41

MQAサービス定義

TP1/Message Queueのキューを管理するMQAサーバを定義します。

42

MQTサービス定義

TP1/Message Queueの通信を制御するMQTサーバを定義します。

43

テスタサービス定義

オンライン上でUAPをテストするための実行環境を定義します。

44

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

ユーザサービス定義の省略時解釈値を定義します。

45

ユーザサービス定義

ユーザサーバの実行環境を定義します。

表1‒2　ネットワークコミュニケーション定義の概要

項番

定義名

内容

1

MCFマネジャ定義

各MCF間で共用するリソースの実行環境を定義します。

2

MCF通信構成定義

個々のMCFの接続端末と，送受信メッセージの入出力キューなどの実行環境を定義します。

3

MCFアプリケーション定義

ユーザアプリケーション名およびMCFイベント名に対応するサービス名などの実行環境を定義します。

4

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

MCF性能検証用トレース情報を取得する場合の実行環境を定義します。

5

システムサービス情報定義

MCF通信サービスを起動するための環境を定義します。

6

システムサービス共通情報定義

複数のMCF通信サービスに共通する情報を定義します。

表1‒3　メッセージキュー定義の概要

項番

定義名

内容

1

MQT通信構成定義

TP1/Message Queueのメッセージキューイング形態で通信するMQTサーバを定義します。

表1‒4　ネットワークライブラリ定義の概要

項番

定義名

内容

1

TP1/NET/OSI-TP-Extendedの定義

TP1/NET/OSI-TP-Extendedの実行環境を定義します。

1.2　定義の構成

OpenTP1システム定義では，OpenTP1システムの動作する環境をマシンごとに定義します。個々のマシンで，そのマシンの動作環境を定義します。

OpenTP1システム定義の構成を次の図に示します。

図1‒2　OpenTP1システム定義の構成

1.2.1　システムサービス定義の構成

システムサービス定義には，OpenTP1システム全体の構成と実行環境を定義するものとして，システム環境定義，システムサービス構成定義，ユーザサービス構成定義などがあります。

また，OpenTP1システム全体に共通な項目で，そのノード内のシステムサービス，およびユーザサーバの実行環境などを定義するシステム共通定義とユーザサービスデフォルト定義があります。

そのほかの定義は，個々のシステムサービスごとに，そのシステムサービスが使用するリソースや実行オプションを記述するものです。OpenTP1システムの各システムサービスは，独立したプロセス（空間）として動作します。ジャーナルサービス，スケジュールサービスなど，OpenTP1のシステムサービスに対応した実行環境を定義するのが各システムサービス定義です。

マルチノードサービスを使用する場合，各ノードでグローバルアーカイブジャーナルサービスの有無によって，定義する必要があるものとないものがあります。グローバルアーカイブジャーナルサービスと各定義の関係を次の表に示します。

表1‒5　グローバルアーカイブジャーナルサービスと各定義の関係

項番

定義名

グローバルジャーナルサービスのないノード

グローバルジャーナルサービスのあるノード

1

システム環境定義

○

△

2

システムサービス構成定義

○

○

3

ユーザサービス構成定義

○

×

4

システム共通定義

○

○

5

ロックサービス定義

△

×

6

タイマサービス定義

△

△

7

ネームサービス定義

△

△

8

プロセスサービス定義

○

△

9

スケジュールサービス定義

△

×

10

トランザクションサービス定義

○

×

11

XAリソースサービス定義

△

×

12

インタバルサービス定義

△

×

13

ステータスサービス定義

○

○

14

ジャーナルサービス定義

○

×

15

システムジャーナルサービス定義

○

×

16

チェックポイントダンプサービス定義

○

×

17

ログサービス定義

○

○

18

マルチノード構成定義

○※

○※

19

マルチノード物理定義

○※

○※

20

グローバルアーカイブジャーナルサービス定義

×

○

21

アーカイブジャーナルサービス定義

×

○

22

DAMサービス定義

○※

×

23

TAMサービス定義

○※

×

24

クライアントサービス定義

○※

×

25

ISTサービス定義

○※

×

26

RMMサービス定義

○※

×

27

監視対象RM定義

○※

×

28

拡張RM登録定義

△

×

29

XATMI通信サービス定義

○※

×

30

メッセージキューサービス定義

△

×

31

ユーザサービスネットワーク定義

△

×

32

rapリスナーサービス定義

○

×

33

rapクライアントマネジャサービス定義

○

×

34

性能検証用トレース定義

△

△

35

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

△

△

36

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

△

△

37

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

△

△

38

TRNイベントトレース定義

△

△

39

リアルタイム統計情報サービス定義

△

×

40

リアルタイム取得項目定義

△

×

41

MQAサービス定義

○※

×

42

MQTサービス定義

○※

×

43

テスタサービス定義

○※

×

44

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

○

×

45

ユーザサービス定義

○

×

（凡例）

○：定義ファイル必要。

△：定義ファイル不要。

　・システム内部は省略時解釈値で動作します。

　・定義ファイルがある場合は，それに従って動作します。

×：定義ファイル不要。定義ファイルがあっても無視します。

注※

該当するプログラムプロダクトを使用している場合は，必要です。

ユーザサーバでも同様に，ユーザサーバごとに使用するリソースや実行オプションを定義します。MCFを使用する場合は，一つのサービスに一つのアプリケーションが対応します。ユーザサーバは複数のサービスを提供できます。このサービスの集合体をサービスグループといい，一つのサービスグループは一つのユーザサーバに対応します。このサービスグループの実行環境を定義するのがユーザサービス定義です。

1.2.2　ネットワークコミュニケーション定義の構成

ネットワークコミュニケーション定義は六つの定義から構成され，次の用途で作成します。

MCFマネジャ定義…MCFを管理・運用するための環境を定義します。

MCF通信構成定義…個々の通信サービスの環境を定義します。

MCFアプリケーション定義…アプリケーションの属性を定義します。

MCF性能検証用トレース定義…MCF性能検証用トレースを取得するための環境を定義します。

システムサービス情報定義…MCF通信サービスを起動するための環境を定義します。

システムサービス共通情報定義…複数のMCF通信サービスに共通する情報を定義します。

プロトコル部分の詳細については，マニュアル「OpenTP1 プロトコル」の該当するプロトコル編を参照してください。

1.2.3　メッセージキュー定義の構成

メッセージキュー定義は，MQT通信構成定義だけで構成されています。MQT通信構成定義については，マニュアル「TP1/Message Queue 使用の手引」を参照してください。

1.2.4　ネットワークライブラリ定義の構成

ネットワークライブラリ定義は，TP1/NET/OSI-TP-Extendedの定義だけで構成されています。TP1/NET/OSI-TP-Extendedの定義については，マニュアル「OpenTP1 プロトコル TP1/NET/OSI-TP-Extended編」を参照してください。

1.3　定義の作成手順

システムサービス定義およびネットワークコミュニケーション定義を作成する場合は，テキストエディタを使用して定義ファイルを作成します。

ネットワークコミュニケーション定義の場合は，オンライン開始前にオブジェクトファイルを生成しておく必要があります。オブジェクトファイルは，テキストエディタによって作成したソースファイルを，ユティリティで変換して生成します。

MCFマネジャ定義，MCF通信構成定義，およびMCFアプリケーション定義は，個別のソースファイルに作成し，個別のオブジェクトファイルを生成します。ただし，MCF通信構成定義は共通定義とデータコミュニケーション定義から構成されているため，ソースファイルが二つ必要です。

なお，ネットワークコミュニケーション定義で，プロトコル部分の詳細については，マニュアル「OpenTP1 プロトコル」の該当するプロトコル編を参照してください。

メッセージキュー定義（MQT通信構成定義）の作成手順については，マニュアル「TP1/Message Queue 使用の手引」を参照してください。

ネットワークライブラリ定義（TP1/NET/OSI-TP-Extendedの定義）の作成手順については，マニュアル「OpenTP1 プロトコル TP1/NET/OSI-TP-Extended編」を参照してください。

注

$DCDIR/lib/sysconf以下の定義ファイルは，OpenTP1のシステムサービスで使用する定義ファイルです。このため，$DCDIR/lib/sysconf以下のファイルをコピーして定義を作成しないでください。コピーして作成した場合，OpenTP1が正常に動作しなくなるおそれがあります。

定義の作成手順とオンライン開始時の処理の流れを次の図に示します。

なお，定義を作成してから，OpenTP1システムをOSへ登録してください。

図1‒3　定義の作成手順とオンライン開始時の処理の流れ

1.4　定義の規則

定義の基本事項と記述形式について説明します。

1.4.1　基本事項

(1)　システムサービス定義について

システムサービス定義の，定義間の記述順序は任意です。

システムサービス定義にはset形式，コマンド形式，putenv形式，およびdcputenv形式があります。

どの定義形式も同一定義ファイルに格納します。

同一定義内では，set形式を定義してからコマンド形式，putenv形式，またはdcputenv形式の順に定義してください。

set形式ではOpenTP1システム開始時に値が決定します。

コマンド形式ではOpenTP1システム開始時に値が決定しても，オンライン中に運用コマンドを入力するとOpenTP1システム開始時に決定した値を変更できます。

putenv形式，dcputenv形式では環境変数を設定できます。

なお，システムサービス定義のコマンドは定義として記載しています。

このため，実際の運用コマンドとオプションや使用上の制限が異なります。

運用コマンドとして使用する場合は，マニュアル「OpenTP1 運用と操作」で使用できるコマンドかどうかを確認してください。

(2)　ネットワークコミュニケーション定義について

ネットワークコミュニケーション定義では，各定義間の記述順序は任意ですが，各定義内での記述順序が決まっています。詳しくは，「5.　ネットワークコミュニケーション定義の詳細」を参照してください。

なお，プロトコル部分の詳細については，マニュアル「OpenTP1 プロトコル」の該当するプロトコル編を参照してください。

(3)　メッセージキュー定義について

メッセージキュー定義（MQT通信構成定義）の規則については，マニュアル「TP1/Message Queue 使用の手引」を参照してください。

(4)　ネットワークライブラリ定義について

ネットワークライブラリ定義（TP1/NET/OSI-TP-Extendedの定義）の規則については，マニュアル「OpenTP1 プロトコル TP1/NET/OSI-TP-Extended編」を参照してください。

(5)　定義情報のメンテナンスについて

定義情報はテキストエディタでメンテナンスできます。

ただし，オンラインで使用中の定義を変更または削除しないでください。

定義を変更または削除した場合，そのオンラインの動作は保証できません。

定義を変更する手順については，「7.1　定義の変更手順」を参照してください。

(6)　同一のオペランドが複数のシステム定義に存在する場合

システム共通定義，ユーザサービスデフォルト定義，ユーザサービス定義に同一のオペランドを指定できる場合の優先順位を次に示します（1.＞2.＞3.）。

ユーザサービス定義

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

システム共通定義

1.4.2　記述形式

(1)　set形式

set形式で指定する定義をオペランドと呼びます。set形式では，オペランドに値を設定します。

形式

set　オペランド=値

(2)　コマンド形式

コマンド形式で指定する定義を定義コマンドと呼びます。コマンド形式では，次の形式に従ってオプションおよび引数を設定します。

形式

コマンド名　オプション　コマンド引数

用語の定義

コマンド名：コマンド名称です。

オプション：マイナス記号で始まる文字列です。

引数を取らない形式1と引数を必要とする形式2の二つがあります。

形式1　-オプションフラグ

形式2　-オプションフラグ　フラグ引数

（凡例）

オプションフラグ：マイナス記号に続く1文字の英数字です。英大文字と英小文字とは区別します。

フラグ引数：オプションフラグに対する文字列です。

コマンド引数：マイナス記号以外で始まる引数でコマンドの操作対象です。

(3)　putenv形式

putenv形式ではユーザの環境変数を設定します。環境変数値に環境変数名を設定した場合，その環境変数は展開しません。

形式

putenv　環境変数名　環境変数値

(4)　dcputenv形式

dcputenv形式ではユーザの環境変数を設定します。環境変数値に環境変数名を設定した場合，その環境変数を展開した値で，ユーザの環境変数を設定します。

形式

dcputenv　環境変数名　環境変数値

(5)　コメント

コメントを記入する場合は，コメントの先頭に「#」を記述してください。

行の先頭に「#」を記述すると1行全体がコメント扱いになります。

形式1　定義の記述　　　#コメント・・・・・・

形式2　#コメント・・・・・・・

(6)　制限事項

複数の項目をコンマで区切る定義があります。このような定義を記述する場合，項目の直後にコンマを記述してください。項目とコンマの間に空白を入れないでください。

定義の1行の最大長は次のとおりです。

システムサービス定義：定義1行の長さはコメントを含め最大80バイトです。

ネットワークコミュニケーション定義※：定義1行の長さはコメントを含め最大1,024バイトです。

注※

システムサービス情報定義，またはシステムサービス共通情報定義の場合はコメントを含め最大80バイトです。

1行の最大長を超えて定義を指定すると，OpenTP1の開始に失敗したり，エラーメッセージを出力したりする場合があります。

定義が1行の最大長を超える場合は，複数行に分けて記述してください。このとき，行の末尾に継続符号'¥'を記述します。継続符号'¥'の後ろには何も記述しないでください。また，複数の項目をコンマで区切りながら複数行に分けて記述する場合，継続符号'¥'を記述する行にある項目の末尾にコンマを記述してください。

ネットワークコミュニケーション定義で，引用符（"）を使って囲むオペランドを指定するオプションに，次の行にほかのオプションを記述する場合，引用符（"）と継続符号'¥'の間に一つ以上の空白を入れてください。次に指定例を示します（△は半角スペースを示します）。

-y "mode=client"△¥
-r "portno=10002"

なお，コメントを記述した行に継続行を続ける場合の制限事項は，次のとおりです。

システムサービス定義の場合

コメントを記述した行に継続行を続けることはできません。'#'を記述すると，その行の終わりまでがコメントと見なされるため，'¥'を記述しても行の継続はできなくなります。

ネットワークコミュニケーション定義の場合

コメントを記述した行に継続行を続ける場合は，コメントを'#'で囲んだあと，その行の末尾に'¥'を記述してください。

(7)　環境変数を設定する場合の注意事項

dcputenv形式では，環境変数値に設定した環境変数名もgetenv関数によって展開します。展開する環境変数名の先頭には'$'を記述してください。環境変数名として指定できるのは，英数字，およびアンダスコアです。

環境変数値に環境変数名を指定する場合の注意事項

展開した環境変数値にさらに環境変数名がある場合，その環境変数名については展開しません。

環境変数名を展開しないで文字列と見なす場合は，環境変数値全体をダブルクォーテーションで囲ってください。

環境変数値の途中にダブルクォーテーションを指定した場合，そのダブルクォーテーションは，環境変数値の一部として扱います。

環境変数値には，設定したい環境変数名を指定できません。

（指定できない例）dcputenv SETPATH $SETPATH:/OpenTP1/file

（例）環境変数$DCDIRにディレクトリ/OpenTP1が設定されている場合

putenv TMPPATH $DCDIR/tmp                 …1
dcputenv FILEPATH $DCDIR/tmp              …2
dcputenv TEMPDIR $TMPPATH/file            …3
dcputenv REALPATH $FILEPATH:$DCDIR/file   …4
dcputenv ENVPATH "$TMPPATH/file"          …5
dcputenv DIRTMP $DCDIR:"$FILEPATH":/tmp   …6

TMPPATHに"$DCDIR/tmp"という文字列が設定されます（$DCDIRは展開しません）。

FILEPATHに"/OpenTP1/tmp"が設定されます（$DCDIRを展開し，"/OpenTP1"とします）。

TEMPDIRに"$DCDIR/tmp/file"が設定されます（TMPPATHは'$DCDIR/tmp'に展開されますが，$DCDIRは展開しません）。

REALPATHに"/OpenTP1/tmp:/OpenTP1/file"が設定されます（$FILEPATH:と指定されている場合，コロンの直前までの文字列が環境変数名として認識されます）。

ENVPATHに"$TMPPATH/file"が設定されます（$TMPPATHは展開しません）。

DIRTMPに'/OpenTP1:"/OpenTP1/tmp":/tmp'が設定されます（ダブルクォーテーションを環境変数値の一部として扱うため，ダブルクォーテーションも環境変数値として設定されます。さらに，環境変数名を展開しないためのダブルクォーテーションとしては扱わないため，$FILEPATHを展開します）。

同じ環境変数をputenv形式とdcputenv形式の両方で設定している場合は，あとに設定したものが有効になります。

1.4.3　記号の説明

定義の説明に使用する各種の記号を説明します。

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

(1)　文法記述記号

オプションおよびコマンド引数を説明する記号です。

各記号の意味を次の表に示します。

表1‒6　文法記述記号一覧

文法記述記号

意味

｛　　｝

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

（例）｛-m　マルチエリアノード識別子｜-g　マルチノードサブエリア識別子｝

これは，-m　マルチエリアノード識別子と-g　マルチノードサブエリア識別子の二つの項目のうち，どちらかを指定することを示します。

〔　　〕

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

（例）〔prcsvpath　パス名〕

これはprcsvpath　パス名と指定するか，何も指定しないことを示します。

（例）〔-c cid〕

これは何も指定しないか，または-cオプションで指定された項目はcidという値を取ることを示します。

｛｛　　｝｝

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

（例）｛｛dcsvstart -u　サーバ名〔，サーバ名〕…｝｝

これは，次のように指定できることを示します。

dcsvstart -u　サーバ名〔，サーバ名〕…

dcsvstart -u　サーバ名〔，サーバ名〕…

｜

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

（例）set hold＝Y｜N

これは，YかNを指定できることを示します。

＿

（下線）

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

（例）set type＝other｜MHP

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

…

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

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

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

（例）-l　"le1 le2…len"

これは，-lオプションの中の指定を空白で区切った文字列を繰り返すことを示します。

(2)　属性表示記号

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

各記号の意味を次の表に示します。

表1‒7　属性表示記号一覧

属性表示記号

意味

〜

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

《　　》

ユーザが指定を省略したときの値を示します。

〈　　〉

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

((　　))

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

(3)　構文要素記号

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

各記号の意味を次の表に示します。

表1‒8　構文要素記号一覧

構文要素記号

意味

英字

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

英字記号

英字と#，@，¥，$，%

英数字

英字と数字（0〜9）

英数字記号

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

符号なし整数

数字列（0〜9）

16進数

数字（0〜9）と（A〜F，a〜f）

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

識別子

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

記号名称

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

文字列

英数字記号の配列

パス名

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

ホスト名

先頭が英数字または-（ハイフン）で，先頭以外が英数字，-（ハイフン），または.（ピリオド）

使用上の注意

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

パス名は使用しているOSに依存します。

2　システムサービス定義の概要

システムサービス定義の概要と定義の種類について説明します。

2.1　概要

2.1.1　システムサービス定義とファイル名

システムサービス定義を登録するファイル名とファイル数を，次の表に示します。

なお，次の表で示すノードとは，OpenTP1システムを指します。

表2‒1　システムサービス定義を登録するファイル名とファイル数

定義名

定義ファイル名（絶対パス名）

定義ファイル数（1ノード当たり）

システム環境定義

$DCDIR/conf/env

0〜1

システムサービス構成定義

$DCCONFPATH/sysconf

1

ユーザサービス構成定義

$DCCONFPATH/usrconf

1

システム共通定義

$DCCONFPATH/betranrc

1

ロックサービス定義

$DCCONFPATH/lck

0〜1

タイマサービス定義

$DCCONFPATH/tim

0〜1

ネームサービス定義

$DCCONFPATH/nam

0〜1

プロセスサービス定義

$DCCONFPATH/prc

0〜1

スケジュールサービス定義

$DCCONFPATH/scd

0〜1

$DCCONFPATH/dcscdmlt※1

0〜1

$DCCONFPATH/マルチスケジューラグループ名※1

0〜マルチスケジューラグループ数

トランザクションサービス定義

$DCCONFPATH/trn

1

XAリソースサービス定義

$DCCONFPATH/xar

0〜1

インタバルサービス定義

$DCCONFPATH/itv

0〜1

ステータスサービス定義

$DCCONFPATH/sts

1

ジャーナルサービス定義

$DCCONFPATH/jnl

0〜1※2

システムジャーナルサービス定義

$DCCONFPATH/任意※3

0〜1※2

チェックポイントダンプサービス定義

$DCCONFPATH/任意※3

0〜チェックポイントダンプを取得するシステムサービス数※2※4

ログサービス定義

$DCCONFPATH/log

0〜1

マルチノード構成定義

$DCCONFPATH/nodeconf

0〜1

マルチノード物理定義

$DCCONFPATH/nodeaddr

0〜1

グローバルアーカイブジャーナルサービス定義

$DCCONFPATH/jar

0〜1

アーカイブジャーナルサービス定義

$DCCONFPATH/任意※5

1〜16※6

DAMサービス定義

$DCCONFPATH/dam

0〜1

TAMサービス定義

$DCCONFPATH/tam

0〜1

クライアントサービス定義

$DCCONFPATH/cltsrv

0〜1※7

ISTサービス定義

$DCCONFPATH/ist

0〜1

RMMサービス定義

$DCCONFPATH/rmm

0〜1

監視対象RM定義

$DCCONFPATH/任意※8

0〜1

拡張RM登録定義

$DCDIR/conf/extendRM

0〜1

XATMI通信サービス定義

$DCCONFPATH/_xatc

0〜1

メッセージキューサービス定義

$DCCONFPATH/que

0〜1

ユーザサービスネットワーク定義

$DCCONFPATH/usrnet

0〜1

rapリスナーサービス定義

任意※9

rapリスナー数

rapクライアントマネジャサービス定義

任意※9

0〜1

性能検証用トレース定義

$DCCONFPATH/prf

0〜1

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

$DCCONFPATH/_xr

0〜1

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

$DCCONFPATH/_jl

0〜1

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

$DCCONFPATH/_lk

0〜1

TRNイベントトレース定義

$DCCONFPATH/_tr

0〜1

リアルタイム統計情報サービス定義

$DCCONFPATH/rts

0〜1

リアルタイム取得項目定義

$DCCONFPATH/任意※10

rtsput定義コマンドの指定数※11

MQAサービス定義※12

$DCCONFPATH/mqa

0〜1

MQTサービス定義※12

$DCCONFPATH/mqt

0〜1

テスタサービス定義※13

$DCCONFPATH/uto

0〜1

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

$DCCONFPATH/usrrc

0〜1

ユーザサービス定義

$DCCONFPATH/ユーザサーバ名※14

ユーザサーバ数※15

注※1

マルチスケジューラ機能を使用する場合，マルチスケジューラデーモン独自に動作環境に関する定義を指定する必要があるときだけ，この定義ファイルを作成します。

dcscdmlt

このファイル名で示す定義ファイルを，すべてのマルチスケジューラデーモンが解析します。

ただし，マルチスケジューラグループ名の定義ファイルが存在する場合は，その定義内容を優先します。

マルチスケジューラグループ名

このファイル名で示す定義ファイルを，ファイル名と同一のマルチスケジューラグループに属するマルチスケジューラデーモンが解析します。

スケジュールサービス定義のscdmulti定義コマンドの-gオプションで指定した名称です。

dcscdmltで示す定義ファイルに同じ定義を指定した場合，マルチスケジューラグループ名で示す定義ファイルの指定値が有効になります。

注※2

システム共通定義のjnl_fileless_optionオペランドにYを指定している場合，定義ファイルを省略できます。

注※3

ノード内で一意になる名称を指定してください。

ここで指定したファイル名を，ジャーナルサービス定義（jnldfsv）に定義します。

なお，ほかの定義ファイルで使用しているファイル名は指定できません。

注※4

対象サービスごとに作成してください。

注※5

ノード内で一意になる名称を指定してください。

ここで指定したファイル名を，グローバルアーカイブジャーナルサービス定義（jnldfsv）に定義します。

なお，ほかの定義ファイルで使用しているファイル名は指定できません。

注※6

アーカイブジャーナルサービス定義を指定した場合にだけ作成してください。

注※7

0の場合，警告メッセージが出力されますが，省略値で動作します。

注※8

同一マシン内で一意になる名称を指定してください。

ここで指定したファイル名を，RMMサービス定義（rmm_check_services）に指定します。

なお，ほかの定義ファイルで使用しているファイル名は指定できません。

注※9

$DCCONFPATH以外の名称を指定してください。

注※10

リアルタイム統計情報サービス定義のrtsput定義コマンドで-fオプションに指定した名称です。

注※11

リアルタイム統計情報サービス定義のrtsput定義コマンドで-fオプションに指定した定義ファイルの数だけ作成してください。

注※12

MQAサービス定義とMQTサービス定義の詳細については，マニュアル「TP1/Message Queue 使用の手引」を参照してください。

注※13

テスタサービス定義の詳細については，マニュアル「OpenTP1 テスタ・UAPトレース使用の手引」を参照してください。

注※14

システム開始時に一緒に起動するユーザサーバの場合は，ユーザサービス構成定義（dcsvstart定義コマンド）で指定するユーザサーバ名と同じ名称を指定してください。

必要に応じて起動するユーザサーバの場合は，サーバ起動コマンド（dcsvstart）で指定するユーザサーバ名と同じ名称を指定してください。

なお，ほかの定義ファイルで使用しているファイル名は指定できません。

注※15

ユーザサーバごとに作成してください。

2.2　定義の種類

2.2.1　システム環境定義の内容

システム環境定義の内容を，次の表に示します。

表2‒2　システム環境定義の内容

形式

オペランド／パス

定義内容

指定値

set

mode_conf

システムの開始方法

AUTO|MANUAL1|

《MANUAL2》

static_shmpool_size

静的共用メモリの総量

〈符号なし整数〉

32ビット版の場合：((0〜1945600))《4096》

64ビット版の場合：((0〜67108864))《4096》

（単位：キロバイト）

dynamic_shmpool_size

動的共用メモリの最大使用時の総量

〈符号なし整数〉

32ビット版の場合：((0〜1945600))《4096》

64ビット版の場合：((0〜67108864))《4096》

（単位：キロバイト）

shmpool_attribute

共用メモリプールのメモリ固定の要否

《free》|fixed|hugepage

user_command

ユーザ環境設定コマンド

〈パス名〉

server_count

最大サーバ数

〈符号なし整数〉

((32〜9999))《64》

user_server_ha

システムサーバ起動後，ユーザサーバを起動するかどうかを指定

Y|《N》

system_terminate_watch_time

システム終了監視時間

〈符号なし整数〉

((0〜65535))《3600》

（単位：秒）

start_scheduling_timing

システム開始時にRPCの受け付けの開始時期

BEFORE|《AFTER》

system_init_watch_time

システム初期化の待ち時間

〈符号なし整数〉

((0〜65535))

（単位：秒）

user_command_online

システム開始完了コマンド

〈パス名〉

preend_warning_watch_time

終了準備警告監視時間

〈符号なし整数〉

((0〜65535))《180》

（単位：秒）

user_command_online_tp1mngr_id

user_command_onlineに指定したシステム開始完了コマンドをOpenTP1管理者のUID/GIDで実行するかどうか

Y|《N》

default_value_option

システム定義のデフォルト値変更オプション

〈符号なし整数〉

((0〜1))《1》

ha_switch_error_retry_count

待機系OpenTP1起動失敗時のリトライ回数

〈符号なし整数〉

((0〜3))《0》

ha_switch_error_retry_interval

待機系OpenTP1起動失敗時のリトライ間隔

〈符号なし整数〉

((1〜60))《10》

（単位：秒）

redirect_file_name

標準エラー出力の出力先ファイル名

〈1〜255文字のパス名〉

putenv

DCCONFPATH

定義ファイルの格納ディレクトリ

〈パス名〉

《$DCDIR/conf》

DCADMDEBUG

デバッグ情報を取得するかどうか

《0》|1

DCUAPCONFPATH

ユーザサービス定義ファイルまたはユーザサービスデフォルト定義ファイルをDCCONFPATHとは別のディレクトリに格納したい場合に格納するディレクトリ

〈パス名〉

dcputenv

DCCONFPATH

定義ファイルの格納ディレクトリ

〈パス名〉

DCUAPCONFPATH

ユーザサービス定義ファイルまたはユーザサービスデフォルト定義ファイルをDCCONFPATHとは別のディレクトリに格納したい場合に格納するディレクトリ

〈パス名〉

2.2.2　システムサービス構成定義の内容

システムサービス構成定義の内容を，次の表に示します。

表2‒3　システムサービス構成定義の内容

形式

オペランド／コマンド

オプション

定義内容

指定値

set

uap_conf

このノードでユーザサーバを実行するかどうかを指定

Y|《N》

dam_conf

このノードでDAMサービスを使用するかどうかを指定

Y|《N》

tam_conf

このノードでTAMサービスを使用するかどうかを指定

Y|《N》

que_conf

このノードでメッセージキューサービス（MCFサービス）を使用するかどうかを指定

Y|《N》

ha_conf

このノードで系切り替えをするかどうかを指定

Y|《N》

jar_conf

このノードでグローバルアーカイブジャーナルサービスを使用するかどうかを指定

Y|《N》

clt_conf

このノードでクライアント拡張サービスを使用するかどうかを指定

Y|《N》

ist_conf

このノードでISTサービスを使用するかどうかを指定

Y|《N》

rmm_conf

このノードでRMMサービスを使用するかどうかを指定

Y|《N》

xat_conf

このノードでXATMI通信サービスを使用するかどうかを指定

Y|《N》

mqa_conf

このノードでMQAサービスを使用するかどうかを指定

Y|《N》

コマンド

dcsvstart

-m

MCFサービスの起動

〈1〜8文字の英数字〉

2.2.3　ユーザサービス構成定義の内容

ユーザサービス構成定義の内容を，次の表に示します。

表2‒4　ユーザサービス構成定義の内容

形式

コマンド

オプション

定義内容

指定値

コマンド

dcsvstart

-u

ユーザサーバの起動

〈1〜8文字の識別子〉

2.2.4　システム共通定義の内容

システム共通定義の内容を，次の表に示します。

表2‒5　システム共通定義の内容

形式

オペランド／コマンド／パス

オプション

定義内容

指定値

set

rpc_trace

RPCトレースを取得するかどうかを指定

Y|《N》

rpc_trace_name

RPCトレースを取得するファイル名

〈パス名〉

《$DCDIR/spool/rpctr》

rpc_trace_size

RPCトレースを取得するファイルのサイズ

〈符号なし整数〉

((1024〜2147483648))《4096》

（単位：バイト）

name_port

ネームサービスのポート番号

〈符号なし整数〉

((5001〜65535))

《10000》

system_id

OpenTP1識別子

〈1〜2文字の識別子〉

all_node

ネームサービスの存在するすべてのノード名

〈1〜255文字の識別子〉

ネームサーバのポート番号

〈符号なし整数〉

((5001〜65535))《10000》

サービス情報優先度指定機能を使用するかどうかを指定

:high

node_id

ノード識別子

〈4文字の識別子〉

rpc_retry

RPCをリトライするかどうかを指定

Y|《N》

rpc_retry_count

RPC処理のリトライ回数の最大値

〈符号なし整数〉

((1〜3600))《18》

rpc_retry_interval

RPC処理のリトライ間隔

〈符号なし整数〉

((1〜3600))《10》

（単位：秒）

multi_node_option

マルチノード機能を使用するかどうかを指定

Y|《N》

prc_port

マルチノード連携制御機能で使用するポート番号

〈符号なし整数〉

((5001〜49999))

rpc_delay_statistics

通信遅延時間統計情報を取得するかどうかを指定

Y|《N》

my_host

使用するネットワークアダプタのホスト名

〈1〜255文字の識別子〉

jp1_use

JP1/Baseにイベントを登録するかどうかを指定

Y|《N》

rpc_message_level

RPCのトラブルシュートメッセージの表示レベル

〈符号なし整数〉

((0〜2))《2》

rpc_multi_tp1_in_same_host

同一ホスト内の複数OpenTP1を同一グローバルドメインとして運用するかどうかを指定

Y|《N》

max_socket_descriptors

ソケット用ファイル記述子の最大数

〈符号なし整数〉

((32〜2032))《64》

rpc_datacomp

サービス要求時とサービス要求応答時にユーザデータを圧縮して送信するかどうかを指定

Y|《N》

domain_masters_addr

通信先のドメイン名

〈1文字以上の識別子〉

ドメイン代表スケジュールサービスのホスト名1（第1優先）

〈1〜255文字の識別子〉

ドメイン代表スケジュールサービスのポート番号1（第1優先）

〈符号なし整数〉

((5001〜65535))

ドメイン代表スケジュールサービスのホスト名2（第2優先）

〈1〜255文字の識別子〉

ドメイン代表スケジュールサービスのポート番号2（第2優先）

〈符号なし整数〉

((5001〜65535))

ドメイン代表スケジュールサービスのホスト名3（第2優先）

〈1〜255文字の識別子〉

ドメイン代表スケジュールサービスのポート番号3（第2優先）

〈符号なし整数〉

((5001〜65535))

domain_masters_port

ドメイン代表スケジュールサービスのポート番号

〈符号なし整数〉

((5001〜65535))

domain_use_dns

ドメイン指定のRPCを発行した際にドメインネームサービスに問い合わせるかどうかを指定

《Y》|N

client_uid_check

TP1/Client/WまたはTP1/Client/Pに対するユーザ認証機能を使用するかどうかを指定

HP-UXまたはWindowsの場合：《Y》|N

AIX，LinuxまたはSolarisの場合：Y|《N》

rpc_port_base

最小ポート番号

〈符号なし整数〉

((5001〜65535))

prf_trace

性能検証用トレース情報を取得するかどうかを指定

《Y》|N

trn_prf_trace_level

トレースの取得レベル

((00000001〜00000003))《00000003》

core_suppress_watch_time

実時間監視タイムアウトプロセスのコアダンプ出力を抑止する時間間隔

〈符号なし整数〉

((0〜3600))《0》

（単位：秒）

rpc_netmask

TCP/IPのネットワーク定義ファイルに指定したサブネットマスク値

〈「.」語法の文字列のインターネットアドレス〉

ipc_sockctl_highwater

ソケットの一時クローズ処理開始数パーセンテージ／ソケットの一時クローズ処理非対象数パーセンテージ

〈符号なし整数〉

((0〜100))《100，0》

ipc_sockctl_watchtime

ソケット再利用可能監視時間

〈符号なし整数〉

((0〜65535))《180》

（単位：秒）

ipc_conn_interval

コネクション確立監視時間

〈符号なし整数〉

((8〜65535))《8》

（単位：秒）

ipc_send_interval

データ送信監視間隔

〈符号なし整数〉

((5〜32767))《5》

（単位：秒）

ipc_send_count

データ送信監視回数

〈符号なし整数〉

((1〜32767))《5》

ipc_header_recv_time

通信制御データの受信監視時間

〈符号なし整数〉

((5〜32767))《10》

（単位：秒）

rpc_close_after_send

ノード間通信で確立したコネクションを保持したままにするか，ノード間通信が終了するたびにコネクションを切断するかどうかを指定

Y|《N》

name_notify

起動通知を行うかどうかを指定

Y|《N》

all_node_ex

ネームサービスの存在するすべてのノード名

〈1〜255文字の識別子〉

ネームサーバのポート番号

〈符号なし整数〉

((5001〜65535))

《10000》

rpc_server_busy_count

KFCA00356-Wメッセージを出力するバンドル回数

〈符号なし整数〉

((0〜32767))《20》

rpc_send_retry_count

TCP/IPコネクションの接続時にエラーが発生した場合のリトライ回数

〈符号なし整数〉

((0〜65535))《0》

rpc_send_retry_interval

TCP/IPコネクションの接続時にエラーが発生した場合のリトライ間隔

〈符号なし整数〉

((0〜300000))《0》

（単位：ミリ秒）

thdlock_sleep_time

スレッド間で排他が競合した場合のスレッドの待ち時間

〈符号なし整数〉

((1〜32767))《15》

（単位：ミリ秒）

ipc_recvbuf_size

TCP/IPの受信バッファサイズ

〈符号なし整数〉

((0，8192〜1048576))《8192》

（単位：バイト）

ipc_sendbuf_size

TCP/IPの送信バッファサイズ

〈符号なし整数〉

((0，8192〜1048576))《8192》

（単位：バイト）

ipc_listen_sockbufset

TCP/IPの送受信バッファサイズをlistenソケットに設定するかどうかを指定

《Y》|N

rpc_router_retry_count

ENOBUFS，ENOMEM発生時のリトライ回数

〈符号なし整数〉

((0〜65535))《30》

rpc_router_retry_interval

ENOBUFS，ENOMEM発生時のリトライ間隔

〈符号なし整数〉

((0〜3600000))《0》

（単位：ミリ秒）

ipc_backlog_count

コネクション確立要求を格納するキューの長さ

〈符号なし整数〉

((0〜4096))《0》

statistics

共用メモリ上にシステム統計情報を取得するかどうかを指定

Y|《N》

name_domain_file_use

OpenTP1起動時および再開始（リラン）時に有効にするドメイン構成を指定

Y|《N》

all_node_extend_number

ドメイン変更時の最大ノード数

〈符号なし整数〉

((0〜65535))《64》

all_node_ex_extend_number

ドメイン定義ファイルを使用したドメイン変更時の最大ノード数

〈符号なし整数〉

((0〜65535))《64》

prc_current_work_path

カレントワーキングディレクトリ作成用のディレクトリパス

〈パス名〉《$DCDIR》

rpc_max_message_size

RPC送受信電文の最大長

〈符号なし整数〉

((1〜8))《1》

（単位：メガバイト）

uap_trace_file_put

UAPトレース情報をファイルに取得するかどうかを指定

Y|《N》

dcstart_wakeup_retry_count

起動通知エラーリトライ回数

〈符号なし整数〉

((0〜60))《0》

dcstart_wakeup_retry_interval

起動通知エラーリトライ間隔

〈符号なし整数〉

((1〜60))《10》

（単位：秒）

nam_prf_trace_level

NAMイベントトレースの取得レベル

((00000000〜00000007))《00000003》

fil_prf_trace_option

FILイベントトレースを取得するかどうかを指定

0|《1》

fil_prf_trace_delay_time

FILイベントトレース取得条件となるファイルアクセス処理時間のしきい値

〈符号なし整数〉

((1〜65535))《3》

（単位：秒）

jnl_prf_event_trace_level

JNL性能検証用トレースの取得レベル

((00000000〜00000002))《00000001》

jnl_fileless_option

ジャーナルファイルレス機能を使用するかどうかを指定

Y|《N》

prc_coredump_filter

coreファイルに共有メモリを含めるかの判断値

〈符号なし整数〉

((1，3，65，67))

name_service_mode

ノード自動追加機能使用時の動作モード

manager|agent|《normal》

name_manager_node

マネジャノードのノード名

〈1〜255文字の識別子〉

マネジャノードのネームサーバのポート番号

〈符号なし整数〉

((5001〜65535))

name_remove_down_node

停止ノード情報の削除要否

Y|《N》

name_node_add_policy

エージェントノードのノードリストにノーマルノードを登録するかどうかを指定

《using_only》|all

dc_deter_restart_on_stop_fail

実行系OpenTP1システムが，dcstop -f（-fd）コマンドによる強制停止処理中に異常終了したとき，系切り替えを抑止するかどうかを指定

Y|《N》

tp1_monitor_time

OpenTP1監視機能の無応答監視時間

〈符号なし整数〉

((1〜60))《15》

（単位：分）

tp1_monitor_kill_signal

OpenTP1監視機能の無応答監視時間満了時の動作

〈符号なし整数〉

0|《3》|9

ipc_notify_response_host

サービス要求元が応答電文を受信するために使用するIPアドレスを通知するかどうかを指定

Y|《N》

ipc_response_host

サービス要求元が応答電文を受信するために使用するIPアドレスを通知する場合のホスト名

〈1〜255文字のホスト名〉

watch_time

最大応答待ち時間

〈符号なし整数〉

((0〜65535))《180》

（単位：秒）

コマンド

dcbindht

-h

ネットワークアダプタに対応するホスト名

〈1〜255文字の識別子〉

-n

ネットワークアダプタを経由して通信するネットワーク名

〈1〜64文字の識別子〉

putenv

LANG

環境変数LANG

〈文字列〉

2.2.5　ロックサービス定義の内容

ロックサービス定義の内容を，次の表に示します。

表2‒6　ロックサービス定義の内容

形式

オペランド

定義内容

指定値

set

lck_limit_foruser

ユーザサーバの最大同時排他要求数

〈符号なし整数〉

((0〜327670))《512》

lck_limit_fordam

DAMサービスの最大同時排他要求数

〈符号なし整数〉

((0〜655340))《512》

lck_limit_fortam

TAMサービスの最大同時排他要求数

〈符号なし整数〉

((0〜327670))《512》

lck_limit_formqa

MQAサービスの最大同時排他要求数

〈符号なし整数〉

((0〜327670))《0》

lck_wait_timeout

排他待ち限界経過時間

〈符号なし整数〉

((0〜32767))《0》

（単位：秒）

lck_deadlock_info

デッドロック情報とタイムアウト情報を出力するかどうかを指定

《Y》|N

lck_deadlock_info_remove

システム開始時にデッドロック情報ファイルとタイムアウト情報ファイルを削除するかどうかを指定

normal|force|《no》

lck_deadlock_info_remove_level

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

〈符号なし整数〉

((0〜24855))《0》

（単位：日）

lck_release_detect

プロセスがいつ排他解除したかを調べる方法

interval|《pipe》

lck_release_detect_interval

排他解除検知インタバル最大時間

〈符号なし整数〉

((10〜60000))《250》

（単位：ミリ秒）

lck_prf_trace_level

LCK性能検証用トレース情報の取得レベル

((00000000〜00000001))《00000000》

2.2.6　タイマサービス定義の内容

タイマサービス定義の内容を，次の表に示します。

表2‒7　タイマサービス定義の内容

形式

オペランド

定義内容

指定値

set

tim_watch_count

最大時間監視サービス数

〈符号なし整数〉

((0〜65535))《128》

2.2.7　ネームサービス定義の内容

ネームサービス定義の内容を，次の表に示します。

表2‒8　ネームサービス定義の内容

形式

オペランド／コマンド

オプション

定義内容

指定値

set

name_total_size

サービス情報領域の大きさ

〈符号なし整数〉

((1〜32767))《64》

（単位：キロバイト）

name_cache_size

サービス情報キャッシュ領域の大きさ

〈符号なし整数〉

((1〜32767))《16》

（単位：キロバイト）

max_socket_descriptors

ソケット用ファイル記述子の最大数

〈符号なし整数〉

((32〜2032))

name_global_lookup

グローバル検索機能を使用するかどうかを指定

Y|《N》

name_service_extend

ネームサービスで管理するサーバUAPの取得数を拡張するかどうかを指定

1|《0》

name_audit_conf

ノード監視機能を使用するかどうかを指定

2|1|《0》

name_audit_interval

監視サービスのノード監視が終了したあと，次の監視を開始するまでの時間

〈符号なし整数〉

((1〜65535))《60》

（単位：秒）

name_audit_watch_time

ノードダウンを検知するまでの最大待ち時間

〈符号なし整数〉

((8〜65535))《8》

（単位：秒）

name_rpc_control_list

ネームサービスのRPC抑止リストの監視機能を使用するかどうかを指定

《Y》|N

name_nodeid_check_message

自ノードと同じノード識別子を指定したノードから通信を受信した場合に，KFCA00677-Wメッセージを出力するかどうかを指定

《Y》|N

name_cache_validity_time

他ノードのサービス情報の有効時間

〈符号なし整数〉

((０〜65535))《1800》

（単位：秒）

name_start_watch_time

OpenTP1起動時のノードリスト要求応答待ち時間

〈符号なし整数〉

((0〜1800))《8》

（単位：秒）

name_start_retry_count

OpenTP1起動時のノードリスト要求リトライ回数

〈符号なし整数〉

((0〜60))《0》

name_start_retry_interval

OpenTP1起動時のノードリスト要求リトライ間隔

〈符号なし整数〉

((1〜60))《10》

（単位：秒）

name_start_error

ノードリスト要求でエラーが発生した回数が，ネームサービス定義のname_start_retry_countオペランドに指定した値を超えた場合の処理

stop|《continue》

name_sync_ready_time

ノードリスト同期待ち時間

〈符号なし整数〉

((0〜65535))《60》

（単位：秒）

watch_time

最大応答待ち時間

〈符号なし整数〉

((0〜65535))

（単位：秒）

コマンド

namnlfil

-r

再開始時だけノードリストファイルを読み込む

なし。

-n

再開始時および（強制）正常開始時にノードリストファイルを読み込む

なし。

引数

ノードリストファイル名

〈1〜63文字のパス名〉

2.2.8　プロセスサービス定義の内容

プロセスサービス定義の内容を，次の表に示します。

表2‒9　プロセスサービス定義の内容

形式

オペランド／コマンド

定義内容

指定値

set

prc_process_count

最大同時起動サーバプロセス数

〈符号なし整数〉

((1〜10000))《64》

prc_recovery_resident

部分回復するプロセスの起動方法として常駐か非常駐かを指定

《Y》|N

prc_take_over_svpath

リラン時にユーザサーバおよびコマンドのパスを引き継ぐかどうかを指定

Y|《N》

term_watch_time

連続異常終了限界経過時間

〈符号なし整数〉

((0〜32767))《10》

（単位：分）

max_socket_descriptors

ソケット用ファイル記述子の最大数

〈符号なし整数〉

((32〜2032))

term_watch_count

連続異常終了限界回数

〈符号なし整数〉

((1〜3))《3》

prc_prf_trace

プロセスサービスのイベントトレースを取得するかどうかを指定

《Y》|N

prc_coresave_path

コアファイル格納パス

〈パス名〉《$DCDIR/spool/save》

prc_corecompress

コアファイルの格納時にOpenTP1で自動的に圧縮

Y|《N》

watch_time

最大応答待ち時間

〈符号なし整数〉

((0〜65535))

（単位：秒）

prc_hugepage_group_id

グループ識別子

〈符号なし整数〉

((0〜4294967294))

コマンド

prcsvpath

プロセスサービスが起動するユーザサーバのパス名

〈パス名〉《$DCDIR/aplib:$DCDIR/bin》

2.2.9　スケジュールサービス定義の内容

スケジュールサービス定義の内容を，次の表に示します。

表2‒10　スケジュールサービス定義の内容

形式

オペランド／コマンド

オプション

定義内容

指定値

set

scd_server_count

スケジュールサービスを利用して動作する最大ユーザサーバ数

〈符号なし整数〉

((0〜8192))《32》

scd_hold_recovery

ユーザサーバの閉塞状態を引き継ぐかどうかを指定

《Y》|F

scd_hold_recovery_count

閉塞状態の引き継ぎが必要なサーバ，およびサービスの合計数

〈符号なし整数〉

((0〜58240))《64》

scd_port

スケジュールサービスのポート番号

〈符号なし整数〉

((5001〜65535))

scd_this_node_first

要求サーバが自ノードにある場合，自ノードのサーバを優先してスケジュールするかどうかを指定

Y|《N》

scd_announce_server_status

自ノードのサーバの状態をすべての他ノードに不定期で通知するかどうかを指定

《Y》|N

max_socket_descriptors

ソケット用ファイル記述子の最大数

〈符号なし整数〉

((32〜2032))

max_open_fds

スケジュールサービスプロセスでアクセスするファイル，およびパイプの最大数

〈符号なし整数〉

((16〜2016))《50》

schedule_rate

サーバの負荷レベルがLEVEL0のノードのスケジュール比率

〈符号なし整数〉

((50〜100))

（単位：％）

scd_retry_of_comm_error

障害ノード以外へのスケジューリングのリトライ回数

〈符号なし整数〉

((0〜128))《0》

scd_advertise_control

システム共通定義のall_nodeオペランドに指定されたノードに対し，ユーザサーバ起動時にネーム情報を通知するタイミングを変更

《BEFORE》|AFTER

scd_message_level

メッセージ格納バッファプールのメモリ不足が発生した場合に出力されるKFCA00854-Eメッセージ出力を抑止

1|《2》

ipc_tcpnodelay

Nagleアルゴリズムを無効にするかどうかを指定

《Y》|N

watch_time

最大応答待ち時間

〈符号なし整数〉

((0〜65535))

（単位：秒）

コマンド

scdbufgrp

-g

スケジュールバッファグループ名

〈1〜8文字の識別子〉

-e

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

〈符号なし整数〉

((512〜1610612736))《512》

（単位：バイト）

-n

メッセージ格納バッファセル数

〈符号なし整数〉

((1〜3145728))《16》

-l

メッセージ格納バッファセル長

〈符号なし整数〉

((512〜31457280))《512》

（単位：バイト）

-s

メッセージ格納バッファ使用制限サイズ

〈符号なし整数〉

((512〜1610612736))

（単位：バイト）

-p

メッセージ格納バッファ使用制限率

〈符号なし整数〉

((1〜100))

（単位：％）

scdmulti

-m

マルチスケジューラデーモン数

〈符号なし整数〉

((1〜4096))《1》

-p

ポート番号

〈符号なし整数〉

((5001〜65535))

-g

マルチスケジューラグループ名

〈1〜8文字の識別子〉

《scdmltgp》

-t

ほかのノードのユーザサーバに，サービス要求を負荷分散するかどうかを指定

なし。

2.2.10　トランザクションサービス定義の内容

トランザクションサービス定義の内容を，次の表に示します。

表2‒11　トランザクションサービス定義の内容

形式

オペランド／コマンド

オプション

定義内容

指定値

set

trn_tran_process_count

同時に起動するトランザクションブランチの数

〈符号なし整数〉

((0〜8192))

MCFサービスを使用する場合は，次に示す指定範囲になります。

32ビットの場合：((1〜7484))

64ビットの場合：((1〜6893))

trn_recovery_process_count

トランザクションブランチの回復処理を並行して行うプロセス数

〈符号なし整数〉

((1〜128))《4》

trn_expiration_time

トランザクションブランチの限界経過時間

〈符号なし整数〉

((0〜65535))《0》

（単位：秒）

trn_expiration_time_suspend

トランザクションブランチの時間監視の範囲

Y|《N》|F

trn_tran_statistics

トランザクションブランチごとの統計情報を取得するかどうかを指定

Y|《N》

trn_tran_recovery_list

全面回復時，未決着トランザクション情報を取得するかどうかを指定

Y|《N》

trn_cpu_time

トランザクションブランチが同期点処理までに使用できるCPU時間

〈符号なし整数〉

((0〜65535))《0》

（単位：秒）

trn_statistics_item

トランザクションブランチの統計情報項目

nothing|base|

《executiontime》|cputime

trn_max_subordinate_count

一つのトランザクションブランチから生成する子トランザクションブランチの最大数

〈符号なし整数〉

((0〜1024))《32》

trn_rm_open_close_scope

xa_open関数およびxa_close関数の発行タイミング

《process》|transaction

trn_optimum_item

トランザクションの最適化項目

《base》|asyncprepare

trn_processing_in_rm_error

トランザクション回復時，リソースマネジャに対して発行したXA関数が処理を続行できないコードでエラーリターンした場合の処置

《down》|retry|force

trn_recovery_list_remove

OpenTP1開始時，未決着トランザクション情報ファイルを削除するかどうかを指定

normal|force|《no》

trn_recovery_list_remove_level

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

〈符号なし整数〉

((0〜24855))《0》

（単位：日）

trn_crm_use

CRMを使用するかどうかを指定

Y|《N》

trn_max_crm_subordinate_count

CRM経由の子トランザクションブランチの最大数

〈符号なし整数〉

((0〜1024))《8》

trn_watch_time

トランザクション同期点処理時の最大通信待ち時間

〈符号なし整数〉

((1〜65535))《120》

（単位：秒）

trn_rollback_information_put

トランザクションブランチロールバック時にロールバック情報を取得するかどうかを指定

《no》|self|remote|all

trn_limit_time

トランザクションブランチ最大実行可能時間

〈符号なし整数〉

((0〜65535))《0》

（単位：秒）

trn_rollback_response_receive

ロールバック完了通知を受信するかどうかを指定

《Y》|N

trn_partial_recovery_type

UAP障害時のトランザクション同期点処理方式

《type1》|type2|type3

max_socket_descriptors

ソケット用ファイル記述子の最大数

〈符号なし整数〉

((32〜2032))

trn_recovery_failmsg_interval

仕掛り中トランザクション情報メッセージ間隔最小時間

〈符号なし整数〉

((0〜65535))《1800》

（単位：秒）

trn_wait_rm_open

リソースマネジャのオープン処理（xa_open関数）でエラーが発生したときの処置

《continue》|stop|retry_continue|retry_stop

trn_retry_interval_rm_open

xa_open関数発行リトライインタバル時間

〈符号なし整数〉

((1〜3600))《10》

（単位：秒）

trn_retry_count_rm_open

xa_open関数発行リトライ回数

〈符号なし整数〉

((1〜65535))《18》

thread_stack_size

OpenTP1内部で使用するスレッドスタック領域のサイズ

〈符号なし整数〉

((1024〜524288))《49152※1》

（単位：バイト）

polling_control_data

一時クローズ処理要求が到着していないかどうかを検査

Y|《N》

thread_yield_interval

ソケットの再利用指示を受信できる契機を与えるインタバル時間

〈符号なし整数〉

((1〜86400))《90》

（単位：秒）

groups

サービスグループのグループアクセスリストを設定

〈符号なし整数〉

((0〜4294967294))

trn_xar_use

XAリソースサービスを使用するかどうかを指定

Y|《N》

trn_start_recovery_mode

OpenTP1開始処理の回復処理モードを指定

《stop》|wait|continue

trn_start_recovery_watch_time

オンライン前回復処理が完了するまでのリトライ上限時間

〈符号なし整数〉

((0〜65535))《600》

（単位：秒）

trn_start_recovery_interval

オンライン前回復処理が完了するまでのリトライ間隔時間

〈符号なし整数〉

((0〜65535))《3》

（単位：秒）

trn_xa_commit_error

複数のリソースをアクセスするトランザクションがコミットに決定したあと，コミットできなくなったリソースマネジャが発生した場合の処理を指定

《down》|force

trn_prf_event_trace_level

TRNイベントトレースの取得レベル

((00000000〜00000007))《00000007》

trn_prf_event_trace_condition

取得するTRNイベントトレースの種類

《xafunc》|trnservice

trn_completion_limit_time

トランザクション完了限界時間

〈符号なし整数〉

((0〜65535))《0》

（単位：秒）

trn_extend_function

トランザクションサービスの機能の拡張レベル

〈16進数字〉

((00000000〜00000003))《00000000》

trn_rcv_open_close_scope

すべてのリソースマネジャ※2に対するXA関数の発行順序を変更するかどうかを指定

Y|《N》

watch_time

最大応答待ち時間

〈符号なし整数〉

((0〜65535))

（単位：秒）

コマンド

trnstring

-n

リソースマネジャ名

〈1〜31文字の識別子〉

-i

リソースマネジャ拡張子

〈1〜2文字の識別子〉

-o

トランザクションサービス用xa_open関数用文字列

〈1〜256文字の文字列〉

-c

トランザクションサービス用xa_close関数用文字列

〈1〜256文字の文字列〉

-O

ユーザサーバ用xa_open関数用文字列

〈1〜256文字の文字列〉

-C

ユーザサーバ用xa_close関数用文字列

〈1〜256文字の文字列〉

-d

このリソースマネジャがコミット最適化およびプリペア最適化に対応していない場合に指定

なし。

-e

xa_start関数でエラーが発生した場合に，リソースマネジャに対してxa_close関数，xa_open関数，xa_start関数の順にリトライ処理を行うときに指定

なし。

-m

OpenTP1の開始処理で，OpenTP1がオンラインになる前に，リソースマネジャのトランザクション回復処理を行うときに指定

なし。

-r

OpenTP1の開始処理，またはオンライン処理で，リソースマネジャに障害が発生した場合，リソースマネジャから未決着トランザクション情報の通知があるまで，トランザクションの回復処理を待ち合わせるときに指定

なし。

-s

特定のリソースマネジャ※2に対するXA関数の発行順序を変更するかどうかを指定

なし。

putenv

任意

環境変数名　環境変数値

〈文字列〉

dcputenv

任意

環境変数名　環境変数値

〈文字列〉

注※1

AIX版のuCosminexus TP1/Server Base(64)の場合，デフォルト値は65536となります。

注※2

OpenTP1が提供するリソースマネジャは対象外です。

2.2.11　XAリソースサービス定義の内容

XAリソースサービス定義の内容を，次の表に示します。

表2‒12　XAリソースサービス定義の内容

形式

オペランド／コマンド

オプション

定義内容

指定値

set

xar_eventtrace_level

XARイベントトレース情報の出力レベル

《ERR》|INF|ALL

xar_eventtrace_record

XARイベントトレース情報ファイルの最大出力レコード数

〈符号なし整数〉

((1〜65535))《8192》

xar_session_time

アイドル状態のトランザクションブランチの監視時間

〈符号なし整数〉

((10〜65535))《180》

（単位：秒）

xar_msdtc_use

MSDTC連携機能を使用するかどうかを指定

Y|《N》

xar_prf_trace_level

XAR性能検証用トレース情報の取得レベル

((00000000〜00000003))《00000003》

コマンド

xarfile

-t

XARファイルのタイプ

online|backup

-a

物理XARファイル名

〈1〜63文字のパス名〉

2.2.12　インタバルサービス定義の内容

インタバルサービス定義の内容を，次の表に示します。

表2‒13　インタバルサービス定義の内容

形式

オペランド

定義内容

指定値

set

watch_time

最大応答待ち時間

〈符号なし整数〉

((0〜65535))

（単位：秒）

2.2.13　ステータスサービス定義の内容

ステータスサービス定義の内容を，次の表に示します。

表2‒14　ステータスサービス定義の内容

形式

オペランド

定義内容

指定値

set

sts_file_name_1

ステータスファイルの論理ファイル名

〈1〜8文字の識別子〉

A系ステータスファイル名

〈パス名〉

B系ステータスファイル名

〈パス名〉

sts_file_name_2

ステータスファイルの論理ファイル名

〈1〜8文字の識別子〉

A系ステータスファイル名

〈パス名〉

B系ステータスファイル名

〈パス名〉

sts_file_name_3

ステータスファイルの論理ファイル名

〈1〜8文字の識別子〉

A系ステータスファイル名

〈パス名〉

B系ステータスファイル名

〈パス名〉

sts_file_name_4

ステータスファイルの論理ファイル名

〈1〜8文字の識別子〉

A系ステータスファイル名

〈パス名〉

B系ステータスファイル名

〈パス名〉

sts_file_name_5

ステータスファイルの論理ファイル名

〈1〜8文字の識別子〉

A系ステータスファイル名

〈パス名〉

B系ステータスファイル名

〈パス名〉

sts_file_name_6

ステータスファイルの論理ファイル名

〈1〜8文字の識別子〉

A系ステータスファイル名

〈パス名〉

B系ステータスファイル名

〈パス名〉

sts_file_name_7

ステータスファイルの論理ファイル名

〈1〜8文字の識別子〉

A系ステータスファイル名

〈パス名〉

B系ステータスファイル名

〈パス名〉

sts_initial_error_switch

ステータスサービスの障害時の処置（ステータスファイルの実体がない，またはステータスファイル障害を検知した場合）

《stop》

|continue|excontinue

sts_single_operation_switch

ステータスサービスの障害時の処置（現用ステータスファイル片系に入出力障害が発生し，かつスワップできない場合）

《stop》|continue

sts_last_active_file

前回のオンラインの最新現用論理ファイル名

〈1〜8文字の識別子〉

sts_last_active_side

前回オンラインで片系障害運転の場合に正常だった系

A|B

watch_time

最大応答待ち時間

〈符号なし整数〉

((0〜65535))

（単位：秒）

2.2.14　ジャーナルサービス定義の内容

ジャーナルサービス定義の内容を，次の表に示します。

表2‒15　ジャーナルサービス定義の内容

形式

オペランド／コマンド

オプション

定義内容

指定値

set

jnl_tran_optimum_level

ジャーナルの出力方式に対する最適化レベル

〈符号なし整数〉

((2〜3))《2》

jnl_arc_terminate_timeout

ノード終了時にアーカイブジャーナルサービスの終了を待ち合わせる最大時間

〈符号なし整数〉

((0〜3600))《0》

（単位：秒）

max_socket_descriptors

ソケット用ファイル記述子の最大数

〈符号なし整数〉

((32〜2032))

jnl_arc_ipc_buff_size

TCP/IPの送受信バッファサイズ

〈符号なし整数〉

((8192〜1048576))《61440》

（単位：バイト）

jnl_watch_time

ジャーナルサービスの通信応答待ち時間

〈符号なし整数〉

((0〜65535))《180》

（単位：秒）

jnl_message_id_change_level

メッセージIDの変更レベル

〈符号なし整数〉

((0〜1))《0》

watch_time

最大応答待ち時間

〈符号なし整数〉

((0〜65535))

（単位：秒）

コマンド

jnldfsv

-r

システムジャーナルサービス定義のファイル名

〈1〜8文字の識別子〉

-c

チェックポイントダンプサービス定義のファイル名（必要なシステムサービスを複数指定可）

〈1〜8文字の識別子〉

2.2.15　システムジャーナルサービス定義の内容

システムジャーナルサービス定義の内容を，次の表に示します。

表2‒16　システムジャーナルサービス定義の内容

形式

オペランド／コマンド

オプション

定義内容

指定値

set

jnl_max_datasize

最大レコードデータ長

〈符号なし整数〉

((32000〜4000000))《32000》

（単位：バイト）

jnl_cdinterval

ジャーナルブロック数

〈符号なし整数〉

((100〜32000))《1000》

jnl_rerun_swap

システム再開始時にジャーナルをスワップするかどうかを指定

Y|《N》

jnl_dual

ジャーナルファイルを二重化するかどうかを指定

Y|《N》

jnl_singleoperation

ジャーナルファイルが片系しか使用できない場合にスワップするかどうかを指定

Y|《N》

jnl_rerun_reserved_file_open

全面回復時に予約ファイルをオープンするかどうかを指定

Y|《N》

jnl_arc_name

グローバルアーカイブジャーナルサービスのリソースグループ名@ノード識別名

〈1〜8文字の識別子〉@〈4文字の識別子〉

jnl_arc_buff_size

アーカイブするための共用メモリバッファの容量

〈符号なし整数〉

((2〜80))《10》

（単位：メガバイト）

jnl_arc_max_datasize

アーカイブ時の転送データの最大長

〈符号なし整数〉

((1020〜8188))《1020》

（単位：キロバイト）

jnl_arc_terminate_check

ジャーナルサービスの正常終了および計画停止時，アーカイブ対象ジャーナルをすべてアーカイブするかどうかを指定

《Y》|N

jnl_arc_rec_kind

アーカイブ対象になるジャーナルレコード種別

《a|c|f|g|i|m|o|s|u》

jnl_arc_uj_code

アーカイブするUJコード

〈符号なし整数〉

((0〜255))《0-255》

jnl_arc_check_level

グローバルアーカイブジャーナル使用時にファイルグループがスワップ先として割り当てられる条件

《1》|2

jnl_arc_trn_stat

同期点ジャーナルおよびトランザクション管理サービスの回復用ジャーナルをアーカイブの対象とするかどうかを指定

《Y》|N

jnl_unload_check

スワップ先のファイルグループを決定する時にアンロード待ち状態をチェックするかどうかを指定

《Y》|N

jnl_auto_unload

自動アンロード機能を使用するかどうかを指定

Y|《N》

jnl_auto_unload_continue

自動アンロード継続機能を使用するかどうかを指定

Y|《N》

jnl_auto_unload_path

アンロードジャーナルファイルの格納ディレクトリ名

〈パス名〉

《$DCDIR/spool/dcjnlinf/unload》

jnl_max_file_dispersion

並列アクセス化する場合の最大分散数

〈符号なし整数〉

((1〜8))《1》

jnl_min_file_dispersion

並列アクセス化する場合の最小分散数

〈符号なし整数〉

((1〜8))《1》

watch_time

最大応答待ち時間

〈符号なし整数〉

((0〜65535))

（単位：秒）

コマンド

jnladdfg

-g

システムジャーナルを構成するファイルグループ名

〈1〜8文字の識別子〉

ONL

オンライン開始時にこのファイルグループを使用するかどうかを指定

なし。

jnladdpf

-g

対応するファイルグループ名

〈1〜8文字の識別子〉

-e

要素ファイル名

〈1〜8文字の識別子〉

-a

物理ファイルのパス名

〈パス名〉

-b

物理ファイルのパス名

〈パス名〉

2.2.16　チェックポイントダンプサービス定義の内容

チェックポイントダンプサービス定義の内容を，次の表に示します。

表2‒17　チェックポイントダンプサービス定義の内容

形式

オペランド／コマンド

オプション

定義内容

指定値

set

jnl_objservername

対象になるシステムサービス名

〈1〜8文字の識別子〉

jnl_max_datasize

チェックポイントダンプ取得用バッファ長

〈符号なし整数〉

((32000〜4000000))《32768》

（単位：バイト）

assurance_count

有効保証世代数

〈符号なし整数〉

((1〜2))《1》

（単位：世代ファイル）

jnl_reduced_mode

縮退運転オプション

〈符号なし整数〉

((0〜2))《0》

jnl_reserved_file_auto_open

予約ファイルを自動的にオープンするかどうかを指定

Y|《N》

jnl_dual

チェックポイントダンプファイルを二重化するかどうかを指定

Y|《N》

jnl_singleoperation

チェックポイントダンプファイル二重化の際，片系しか上書きできなくなった場合に上書きできるファイルグループとして割り当てるかどうかを指定

Y|《N》

jnl_cdskip_limit

チェックポイントダンプ取得契機のスキップ回数の上限値

〈符号なし整数〉

((1〜32767))（単位：回）

jnl_cdskip_msg

チェックポイントダンプ取得契機をスキップする要因となった，トランザクションの情報を表示するかどうかを指定

Y|《N》

cpd_message_id_change_level

メッセージIDの変更レベル

〈符号なし整数〉

((0〜1))《0》

watch_time

最大応答待ち時間

〈符号なし整数〉

((0〜65535))（単位：秒）

コマンド

jnladdfg

-j

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

〈1〜8文字の識別子〉

-g

チェックポイントダンプまたはサーバリカバリジャーナルを構成するファイルグループ名

〈1〜8文字の識別子〉

ONL

オンライン開始時にこのファイルグループを使用するかどうかを指定

なし。

jnladdpf

-j

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

〈1〜8文字の識別子〉

-g

対応するファイルグループ名

〈1〜8文字の識別子〉

-a

物理ファイルのパス名

〈パス名〉

-b

物理ファイルのパス名

〈パス名〉

2.2.17　ログサービス定義の内容

ログサービス定義の内容を，次の表に示します。

表2‒18　ログサービス定義の内容

形式

オペランド／パス

定義内容

指定値

set

log_filesize

メッセージログファイルの最大サイズ

〈符号なし整数〉

((1〜32767))《10240》

（単位：キロバイト）

log_msg_console

メッセージログをリアルタイム出力機能を使用して出力するかどうかを指定

《Y》|N

log_msg_allno

メッセージログのシステム内のメッセージ通番を付けるかどうかを指定

Y|《N》

log_msg_prcid

要求元のプロセスIDを付けるかどうかを指定

Y|《N》

log_msg_prcno

メッセージログのプロセス内のメッセージ通番を付けるかどうかを指定

Y|《N》

log_msg_sysid

OpenTP1識別子を付けるかどうかを指定

《Y》|N

log_msg_date

メッセージログの出力要求時の日付を付けるかどうかを指定

《Y》|N

log_msg_time

メッセージログの出力要求時の時刻を付けるかどうかを指定

《Y》|N

log_msg_hostname

メッセージログの出力要求元のホスト名を付けるかどうかを指定

《Y》|N

log_msg_pgmid

メッセージログの出力要求元のプログラムIDを付けるかどうかを指定

《Y》|N

log_jp1_allno

メッセージログのシステム内の通番を付けるかどうかを指定

Y|《N》

log_jp1_prcid

要求元のプロセスIDを付けるかどうかを指定

Y|《N》

log_jp1_prcno

メッセージログのプロセス内の通番を付けるかどうかを指定

Y|《N》

log_jp1_sysid

OpenTP1識別子を付けるかどうかを指定

《Y》|N

log_jp1_date

メッセージログの出力要求時の日付を付けるかどうかを指定

《Y》|N

log_jp1_time

メッセージログの出力要求時の時刻を付けるかどうかを指定

《Y》|N

log_jp1_hostname

メッセージログの出力要求元のホスト名を付けるかどうかを指定

《Y》|N

log_jp1_pgmid

メッセージログの出力要求元のプログラムIDを付けるかどうかを指定

《Y》|N

log_notify_out

メッセージログ通知機能を使用するかどうかを指定

Y|《N》

log_notify_allno

メッセージログのシステム内の通番を付けるかどうかを指定

Y|《N》

log_notify_prcid

要求元のプロセスIDを付けるかどうかを指定

Y|《N》

log_notify_prcno

メッセージログのプロセス内の通番を付けるかどうかを指定

Y|《N》

log_notify_sysid

OpenTP1識別子を付けるかどうかを指定

《Y》|N

log_notify_date

メッセージログの出力要求時の日付を付けるかどうかを指定

《Y》|N

log_notify_time

メッセージログの出力要求時の時刻を付けるかどうかを指定

《Y》|N

log_notify_hostname

メッセージログの出力要求元のホスト名を付けるかどうかを指定

《Y》|N

log_notify_pgmid

メッセージログの出力要求元のプログラムIDを付けるかどうかを指定

《Y》|N

log_jerr_rint

メッセージログ出力中にエラーが発生した場合のメッセージログ出力抑止回数

〈符号なし整数〉

((1〜65536))《32》

log_syslog_out

メッセージをsyslogに出力するレベル

〈符号なし整数〉

((0〜2))《1》

log_syslog_allno

メッセージログのシステム内の通番を付けるかどうかを指定

Y|《N》

log_syslog_prcid

要求元のプロセスIDを付けるかどうかを指定

Y|《N》

log_syslog_prcno

メッセージログのプロセス内の通番を付けるかどうかを指定

Y|《N》

log_syslog_sysid

OpenTP1識別子を付けるかどうかを指定

Y|《N》

log_syslog_date

メッセージログの出力要求時の日付を付けるかどうかを指定

Y|《N》

log_syslog_time

メッセージログの出力要求時の時刻を付けるかどうかを指定

Y|《N》

log_syslog_hostname

メッセージログの出力要求元のホスト名を付けるかどうかを指定

Y|《N》

log_syslog_pgmid

メッセージログの出力要求元のプログラムIDを付けるかどうかを指定

Y|《N》

log_syslog_append_nodeid

ノード識別子を付けるかどうかを指定

Y|《N》

log_syslog_elist

syslog失敗リストのエレメント数

〈符号なし整数〉

((0〜65536))《0》

log_syslog_elist_rint

syslog失敗リストを定期的に出力する間隔

〈符号なし整数〉

((0〜65536))《0》

（単位：秒）

log_syslog_synchro

メッセージログの出力失敗時，syslogに出力するメッセージログのフォーマットを関連オペランドに同期させるかどうかを指定

Y|《N》

log_audit_out

監査ログ機能を使用するかどうかを指定

Y|《N》

log_audit_path

監査ログファイルの出力先ディレクトリ

〈1〜63文字のパス名〉

《$DCDIR/auditlog》

log_audit_size

監査ログファイルの最大サイズ

〈符号なし整数〉

((1〜2047))《10》

（単位：メガバイト）

log_audit_count

監査ログファイルの最大数

〈符号なし整数〉

((1〜256))《2》

log_audit_message

監査ログを取得する項目のメッセージID

〈符号なし整数〉

((33400〜99999))

watch_time

最大応答待ち時間

〈符号なし整数〉

((0〜65535))

（単位：秒）

putenv

TZ

タイムゾーン

〈文字列〉

DCSYSLOGOUT

syslogへメッセージを出力するかどうかを指定

1|1以外の文字列

DCLOGDEFPID

メッセージログ出力時に，要求元のプロセスのプロセスIDを従来フォーマットの5けたで表示するかどうかを指定

1|1以外の文字列

2.2.18　マルチノード構成定義の内容

マルチノード構成定義の内容を，次の表に示します。

表2‒19　マルチノード構成定義の内容

形式

オペランド／コマンド

オプション

定義内容

指定値

set

dcmstart_watch_time

dcmstartコマンド打ち切り時間

〈符号なし整数〉

((0〜65535))《600》

（単位：秒）

dcmstop_watch_time

dcmstopコマンド打ち切り時間

〈符号なし整数〉

((0〜65535))《600》

（単位：秒）

watch_time

最大応答待ち時間

〈符号なし整数〉

((0〜65535))《180》

（単位：秒）

コマンド

dcmarea

-m

マルチノードエリア識別子

〈1〜8文字の識別子〉

-g

マルチノードサブエリア識別子

〈1〜8文字の識別子〉

-w

ノード識別子

〈4文字の識別子〉

2.2.19　マルチノード物理定義の内容

マルチノード物理定義の内容を，次の表に示します。

表2‒20　マルチノード物理定義の内容

形式

コマンド

オプション

定義内容

指定値

コマンド

dcprcport

-w

ノード識別子

〈4文字の識別子〉

-h

OpenTP1ノードがあるホスト名

〈1〜64文字の識別子〉

-p

対応するOpenTP1ノードのprc_portオペランドの指定値

〈符号なし整数〉

((5001〜49999))

2.2.20　グローバルアーカイブジャーナルサービス定義の内容

グローバルアーカイブジャーナルサービス定義の内容を，次の表に示します。

表2‒21　グローバルアーカイブジャーナルサービス定義の内容

形式

オペランド／コマンド

オプション

定義内容

指定値

set

jnl_arc_terminate_timeout

ノード終了時にすべての被アーカイブジャーナルノードの接続を解除するまでの最大待ち合わせ時間

〈符号なし整数〉

((0〜3600))《0》

（単位：秒）

max_socket_descriptors

ソケット用ファイル記述子の最大数

〈符号なし整数〉

((32〜2032))

jnl_arc_ipc_buff_size

TCP/IPの送受信バッファサイズ

〈符号なし整数〉

((8192〜1048576))《61440》

（単位：バイト）

jnl_watch_time

グローバルアーカイブジャーナルサービスの通信応答待ち時間

〈符号なし整数〉

((0〜65535))《180》

（単位：秒）

jnl_message_id_change_level

メッセージIDの変更レベル

〈符号なし整数〉

((0〜1))《0》

コマンド

jnldfsv

-a

アーカイブジャーナルサービス定義のファイル名

〈1〜8文字の識別子〉

2.2.21　アーカイブジャーナルサービス定義の内容

アーカイブジャーナルサービス定義の内容を，次の表に示します。

表2‒22　アーカイブジャーナルサービス定義の内容

形式

オペランド／コマンド

オプション

定義内容

指定値

set

jnl_dual

アーカイブを二重化するかどうかを指定

Y|《N》

jnl_singleoperation

片系クローズ状態のファイルグループを使用するかどうかを指定

Y|《N》

jnl_rerun_swap

グローバルアーカイブジャーナルサービスのリラン時にスワップするかどうかを指定

Y|《N》

jnl_max_file_dispersion

並列アクセス化する場合の最大分散数

〈符号なし整数〉

((1〜8))《1》

jnl_min_file_dispersion

並列アクセス化する場合の最小分散数

〈符号なし整数〉

((1〜8))《1》

jnl_unload_check

スワップ先のファイルグループを決定する時にアンロード待ち状態をチェックするかどうかを指定

《Y》|N

jnl_arc_max_datasize

アーカイブ時の転送データの最大長

〈符号なし整数〉

((1020〜8188))《1020》

（単位：キロバイト）

コマンド

jnladdfg

-g

アーカイブジャーナルファイルのファイルグループ名

〈1〜8文字の識別子〉

ONL

グローバルアーカイブジャーナルサービス開始時にこのグループを指定するかどうかを指定

なし。

jnladdpf

-g

アーカイブジャーナルファイルのファイルグループ名

〈1〜8文字の識別子〉

-e

要素ファイル名

〈1〜8文字の識別子〉

-a

物理ファイルのパス名

〈パス名〉

-b

物理ファイルのパス名

〈パス名〉

2.2.22　DAMサービス定義の内容

DAMサービス定義の内容を，次の表に示します。

表2‒23　DAMサービス定義の内容

形式

オペランド／コマンド

オプション

定義内容

指定値

set

dam_update_block

更新する最大ブロック数

〈符号なし整数〉

((1〜32768))《8》

dam_added_file

オンライン中に追加する最大論理ファイル数

〈符号なし整数〉

((1〜128))《8》

dam_update_block_over

トランザクションの途中で最大ブロック数を超えたときにエラーリターンするかどうかを指定

flush|《error》

dam_message_level

DAMサービスが出力するメッセージのレベル

《1》|0

dam_tran_process_count

同時に実行するトランザクションブランチの数

〈符号なし整数〉

((0〜8192))

dam_cache_size

参照・更新ブロックをスタックしておくバッファ領域長（固定値として設定しない場合）

〈符号なし整数〉

((10〜1000000))

（単位：キロバイト）

dam_cache_size_fix

参照・更新ブロックをスタックしておくバッファ領域長（固定値として設定する場合）

〈符号なし整数〉

((10〜1000000))

（単位：キロバイト）

dam_cache_attribute

バッファ領域のメモリ固定要否

《free》|fixed

dam_io_interval

ディファード更新機能使用時の出力専用プロセス実行間隔

〈符号なし整数〉

((1〜60))（単位：秒）

《1》

dam_transaction_access

DAMファイルのデータ管理，および排他管理をするトランザクションの範囲

global|《branch》

dam_io_error_occur

ディスク障害時のDAMサービスの処置

stop|《continue》

dam_cache_reuse_from

再利用するキャッシュブロックの検索

《last》｜first

dam_default_cache_num

キャッシュブロック再利用境界デフォルト値の指定

〈符号なし整数〉

((0〜4000000))《0》

dam_ex_refer_read

排他あり参照指定で読み込むブロックを，トランザクション決着までキャッシュバッファ領域上に残すかどうかを指定

《none》｜stay

dam_max_block_size

システム内のDAMファイルの最大ブロック長

〈符号なし整数〉

((504〜32760))※《504》

（単位：バイト）

dam_kb_size

dam_cache_sizeオペランドの指定値（単位：キロバイト）を1キロバイト当たり1,000バイトで換算するか，1,024バイトで換算するかを指定

《1000》|1024

watch_time

最大応答待ち時間

〈符号なし整数〉

((0〜65535))

（単位：秒）

コマンド

damcache

引数

キャッシュブロック再利用処理の境界値を有効とする論理ファイル名

〈1〜8文字の識別子〉

キャッシュブロック再利用境界値

〈符号なし整数〉

((0〜4000000))

damchlmt

引数

キャッシュブロック数のしきい値を有効とする論理ファイル名

〈1〜8文字の識別子〉

キャッシュブロック数のしきい値

〈符号なし整数〉

((0〜4000000))

damfile

-d

ファイルのディファード更新処理の要否

なし。

-n

回復対象外ファイルとするかどうかを指定

なし。

-f

回復対象外ファイルをキャッシュレスアクセスとするかどうかを指定

なし。

-c

DAMファイルに障害が発生しても，DAMサービスの正常開始処理を続行する場合に指定

なし。

引数

オンライン中にアクセスする論理ファイル名

〈1〜8文字の識別子〉

オンライン中にアクセスする物理ファイル名

〈1〜63文字のパス名〉

注※

セクタ長×n−8を満たす値を指定してください（nは正の整数）。

2.2.23　TAMサービス定義の内容

TAMサービス定義の内容を，次の表に示します。

表2‒24　TAMサービス定義の内容

形式

オペランド／コマンド

オプション

定義内容

指定値

set

tam_max_tblnum

オンライン中に使用するTAMテーブルの最大数

〈符号なし整数〉

((1〜65535))

tam_max_filesize

オンライン中に使用するTAMテーブルの最大容量

〈符号なし整数〉

((136〜1000000000))

（単位：バイト）

tam_max_recsize

TAMテーブルの最大レコード長

〈符号なし整数〉

((1〜1000000000))

（単位：バイト）

tam_jnl_err_flag

ジャーナルの読み込み障害時にTAMサービスを停止するかどうかを指定

《STOP》|CONTINUE

tam_pool_attri

共用メモリプールのメモリ固定要否

HP-UXまたはSolarisの場合：《fixed》|free

AIX，LinuxまたはWindowsの場合：fixed|《free》

tam_tbl_lock_mode

アクセス時にテーブルを排他するかどうかを指定

《LOCK》|NOLOCK

tam_cbl_level

COBOL　APIの排他レベル

〈符号なし整数〉

((0〜2))《0》

tam_max_trnnum

同時走行最大トランザクションブランチ数

〈符号なし整数〉

((1〜8192))《20》

tam_max_trnfilnum

トランザクション内最大アクセステーブル数

〈符号なし整数〉

((1〜1024))《5》

watch_time

最大応答待ち時間

〈符号なし整数〉

((0〜65535))

（単位：秒）

コマンド

tamtable

-o

ローディング契機

《start》|cmd|lib

-a

アクセス形態

《read》|rewrite|write

-i

TAMテーブル更新時に入出力障害が発生してもアクセスを続行するかどうかを指定

なし。

-j

TAMレコード更新時に部分ジャーナルを取得するかどうかを指定

なし。

引数

オンライン中にアクセスするTAMテーブル名

〈1〜32文字の識別子〉

オンライン中にアクセスする物理ファイル名

〈1〜63文字のパス名〉

2.2.24　クライアントサービス定義の内容

クライアントサービス定義の内容を，次の表に示します。

表2‒25　クライアントサービス定義の内容

形式

オペランド

定義内容

指定値

set

parallel_count

常駐プロセス数と最大プロセス数

〈符号なし整数〉

((1〜1024))《1》

balance_count

1プロセスが処理するサービス要求数

〈符号なし整数〉

((0〜512))《3》

trn_expiration_time

トランザクションブランチ限界経過時間

〈符号なし整数〉

((0〜65535))《0》

（単位：秒）

trn_expiration_time_suspend

トランザクションブランチの時間監視の範囲

Y|《N》|F

trn_cpu_time

トランザクションブランチが同期点処理までに使用できるCPU時間

〈符号なし整数〉

((0〜65535))《0》

（単位：秒）

open_rm

トランザクショナルRPC機能使用時にクライアントサービス実行プログラムがオープンするリソースマネジャ名

OpenTP1_ALL|《OpenTP1_NONE》

clt_inquire_time

常設コネクション問い合わせ間隔最大時間

〈符号なし整数〉

((0〜1048575))《180》

（単位：秒）

clt_port

クライアント拡張サービスのポート番号

〈符号なし整数〉

((5001〜65535))

clt_trn_conf

トランザクショナルRPC実行プロセスを起動するかどうかを指定

《Y》|N

clt_cup_conf

CUP実行プロセスを起動するかどうかを指定

Y|《N》

cup_parallel_count

CUP実行プロセスの常駐プロセス数と最大プロセス数

〈符号なし整数〉

((1〜1024))《1》

cup_balance_count

CUP実行プロセスのサービス要求滞留値

〈符号なし整数〉

((0〜512))《3》

clttrn_port

トランザクショナルRPC実行プロセスのポート番号

〈符号なし整数〉

((5001〜65535))

cltcon_port

CUP実行プロセスのポート番号

〈符号なし整数〉

((5001〜65535))

trn_statistics_item

トランザクションブランチの統計情報項目

nothing|base|

《executiontime》|cputime

trn_optimum_item

トランザクションの最適化項目

《base》|asyncprepare

trn_watch_time

トランザクション同期点処理時の最大通信待ち時間

〈符号なし整数〉

((1〜65535))《120》

（単位：秒）

trn_rollback_information_put

トランザクションブランチロールバック時にロールバック情報を取得するかどうかを指定

《no》|self|remote|all

trn_limit_time

トランザクションブランチ最大実行可能時間

〈符号なし整数〉

((0〜65535))《0》

（単位：秒）

trn_rollback_response_receive

ロールバック完了通知を受信するかどうかを指定

《Y》|N

trn_partial_recovery_type

UAP障害時のトランザクション同期点処理方式

《type1》|type2|type3

trn_completion_limit_time

トランザクション完了限界時間

〈符号なし整数〉

((0〜65535))《0》

（単位：秒）

message_store_buflen

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

〈符号なし整数〉

((1024〜31457280))《8196》

（単位：バイト）

watch_time

最大応答待ち時間

〈符号なし整数〉

((0〜65535))（単位：秒）

2.2.25　ISTサービス定義の内容

ISTサービス定義の内容を，次の表に示します。

表2‒26　ISTサービス定義の内容

形式

オペランド／コマンド

定義内容

指定値

set

ist_node

ISTテーブルを操作するノード

〈4文字の識別子〉

ist_node_group

ISTテーブルを操作するノードグループ

〈1〜8文字の識別子〉

コマンド

istdef

テーブル名

〈1〜8文字の識別子〉

レコード長

〈符号なし整数〉

((4〜65536))

（単位：バイト）

レコード数

〈符号なし整数〉

((1〜16384))

（単位：個）

2.2.26　RMMサービス定義の内容

RMMサービス定義の内容を，次の表に示します。

表2‒27　RMMサービス定義の内容

形式

オペランド

定義内容

指定値

set

rmm_check_services

監視対象リソースマネジャ名

〈1〜7文字の識別子〉

rmm_system_behavior

監視対象リソースマネジャ開始失敗時のシステムの処置

《down》|giveup

rmm_down_with_system

OpenTP1ダウン時に，監視対象リソースマネジャも同時にダウンさせるかどうかを指定

《Y》|N

rmm_sysdown_with_rm

監視対象リソースマネジャダウン時に，OpenTP1も同時にダウンさせるかどうかを指定

Y|《N》

2.2.27　監視対象RM定義の内容

監視対象RM定義の内容を，次の表に示します。

表2‒28　監視対象RM定義の内容

形式

オペランド

定義内容

指定値

set

rmm_start_command

監視対象リソースマネジャ開始コマンド

〈1〜127バイトのパス名〉

rmm_stop_command

監視対象リソースマネジャ終了コマンド

〈1〜127バイトのパス名〉

rmm_abort_command

監視対象リソースマネジャ強制終了コマンド

〈1〜127バイトのパス名〉

rmm_get_pid_command

監視対象プロセスID取得コマンド

〈1〜127バイトのパス名〉

rmm_command_watch_time

監視対象リソースマネジャコマンド監視時間

〈符号なし整数〉

((0〜7200))《1800》

（単位：秒）

rmm_command_uid

監視対象リソースマネジャの実行権限を持つユーザID

〈符号なし整数〉

((0〜59999))

rmm_command_gid

監視対象リソースマネジャの実行権限を持つグループID

〈符号なし整数〉

((0〜59999))

rmm_start_watch_time

監視対象リソースマネジャの開始処理を監視する時間

〈符号なし整数〉

((0〜7200))《300》

（単位：秒）

2.2.28　拡張RM登録定義の内容

拡張RM登録定義の内容を，次の表に示します。

表2‒29　拡張RM登録定義の内容

形式

コマンド

オプション

定義内容

指定値

コマンド

trnlnkrm

-a

追加するOpenTP1提供以外のリソースマネジャ名

〈1〜31文字の英数字〉

-s

追加するリソースマネジャのスイッチ名

〈先頭が英字，またはアンダスコアで始まる1〜32文字の英数字〉

-o

追加するリソースマネジャに関連のあるオブジェクトファイル名

〈英数字〉

-C

コンパイル実行時に使用するコンパイルオプション名

〈1〜512文字の文字列〉

-B

ライブラリリンケージ実行時に使用するリンケージオプション名

〈1〜512文字の文字列〉

-l

trnlnkrmコマンドの実行経過を標準出力に出力する場合に指定

なし。

-f

OpenTP1の状態に関係なくtrnlnkrmコマンドを強制的に実行する場合に指定

なし。

2.2.29　XATMI通信サービス定義の内容

XATMI通信サービス定義の内容を，次の表に示します。

表2‒30　XATMI通信サービス定義の内容

形式

オペランド／コマンド

オプション

定義内容

指定値

set

xatinitapt

システムごとの自AP名称

〈1〜24文字の16進数字〉

xatinitaeq

システムごとの自AE修飾子

〈符号なし整数〉

((0〜2147483647))

xat_aso_con_event_svcname

アソシエーションの確立通知を受信するSPPのサービスグループ名

〈1〜31文字の識別子〉

アソシエーションの確立通知を受信するSPPのサービス名

〈1〜31文字の識別子〉

xat_aso_discon_event_svcname

アソシエーションの正常解放通知を受信するSPPのサービスグループ名

〈1〜31文字の識別子〉

アソシエーションの正常解放通知を受信するSPPのサービス名

〈1〜31文字の識別子〉

xat_aso_failure_event_svcname

アソシエーションの異常解放通知を受信するSPPのサービスグループ名

〈1〜31文字の識別子〉

アソシエーションの異常解放通知を受信するSPPのサービス名

〈1〜31文字の識別子〉

max_open_fds

OSI TP通信のアソシエーションによって使用されるFDSの最大値

〈符号なし整数〉

((16〜2016))《50》

max_socket_descriptors

XATMI通信サービスとUAPとの通信で使用されるFDSの最大値

〈符号なし整数〉

((4〜2047))《64》

コマンド

xatsrvadd

-p

他AP名称

〈1〜24文字の16進数字〉

-q

他AE修飾子

〈符号なし整数〉

((0〜2147483647))

-s

他システムで提供されるサービス名

〈1〜15文字の16進数字〉

2.2.30　メッセージキューサービス定義の内容

メッセージキューサービス定義の内容を，次の表に示します。

表2‒31　メッセージキューサービス定義の内容

形式

オペランド／コマンド

オプション

定義内容

指定値

set

que_xidnum

同時に実行するトランザクションの最大数

〈符号なし整数〉

((1〜4096))《256》

que_io_maxrecsize

遅延書き込み最大レコード長

〈符号なし整数〉

((0〜32000))《0》

（単位：バイト）

コマンド

quegrp

-g

物理ファイルに割り当てるキューグループID

〈1〜8文字の識別子〉

-f

物理ファイルのパス名

〈パス名〉

-n

バッファキャッシュ用の入出力バッファ数

〈符号なし整数〉

((2〜1024))《128》

-m

キューファイルの保持メッセージ数

〈符号なし整数〉

((0〜1024))《10》

-w

物理ファイルの使用容量警告率

〈符号なし整数〉

((0〜95))《80》

（単位：％）

-c

物理ファイルの使用容量に対する警告解除使用率

〈符号なし整数〉

((0〜95))《0》

（単位：％）

2.2.31　ユーザサービスネットワーク定義の内容

ユーザサービスネットワーク定義の内容を，次の表に示します。

表2‒32　ユーザサービスネットワーク定義の内容

形式

コマンド

オプション

定義内容

指定値

コマンド

dcsvgdef

-g

サービスグループ名

〈1〜31文字の識別子〉

-h

ホスト名

〈1〜255文字の識別子〉

-p

ポート番号

〈符号なし整数〉

((1〜65535))

-t

あて先再選択間隔

〈符号なし整数〉

((0〜65534))（単位：秒）

-w

リモートAPI機能を使用する場合に指定

なし。

2.2.32　rapリスナーサービス定義の内容

rapリスナーサービス定義の内容を，次の表に示します。

表2‒33　rapリスナーサービス定義の内容

形式

オペランド

定義内容

指定値

set

rap_listen_port

rapリスナーポート番号

〈符号なし整数〉

((5001〜65535))

rap_parallel_server

rapサーバ数

〈符号なし整数〉

((1〜1024))《1》

rap_watch_time

メッセージ送受信最大監視時間

〈符号なし整数〉

((0〜65535))《180》

（単位：秒）

rap_inquire_time

問い合わせ間隔最大時間

〈符号なし整数〉

((0〜1048575))《180》

（単位：秒）

nice

プロセスの優先順位の変更

〈符号なし整数〉

((0〜39))《0》

uap_trace_max

UAPトレース格納最大数

〈符号なし整数〉

((0〜4095))《32》

uid

OpenTP1管理者のユーザ識別子

〈符号なし整数〉

((0〜4294967294))

rpc_response_statistics

レスポンス統計情報を取得するかどうかを指定

Y|《N》

rpc_trace

RPCトレースを取得するかどうかを指定

Y|N

rpc_trace_name

RPCトレースを取得するファイル名

〈パス名〉

rpc_trace_size

RPCトレースを取得するファイルのサイズ

〈符号なし整数〉

((1024〜2147483648))

（単位：バイト）

trn_expiration_time

トランザクションブランチの限界経過時間

〈符号なし整数〉

((0〜65535))

（単位：秒）

trn_expiration_time_suspend

トランザクションブランチの時間監視の範囲

Y|N|F

trn_cpu_time

トランザクションブランチが同期点処理までに使用できるCPU時間

〈符号なし整数〉

((0〜65535))

（単位：秒）

trf_put

トランザクションが出力したジャーナルをトランザクションリカバリジャーナルファイルへ出力するかどうかを指定

Y|N

trn_statistics_item

トランザクションブランチの統計情報項目

nothing|base|

executiontime|cputime

trn_optimum_item

トランザクションの最適化項目

base|asyncprepare

trn_watch_time

トランザクション同期点処理時の最大通信待ち時間

〈符号なし整数〉

((1〜65535))

（単位：秒）

trn_rollback_information_put

トランザクションブランチロールバック時にロールバック情報を取得するかどうかを指定

no|self|remote|all

trn_limit_time

トランザクションブランチ最大実行可能時間

〈符号なし整数〉

((0〜65535))

（単位：秒）

trn_rollback_response_receive

ロールバック完了通知を受信するかどうかを指定

《Y》|N

trn_partial_recovery_type

UAP障害時のトランザクション同期点処理方式

type1|type2|type3

rap_inquire_timeout_message

クライアントからの要求最大待ち時間が満了したことを検知したとき，エラーメッセージを出力するかどうかを指定

《Y》|N

rap_connection_assign_type

ダイナミックコネクションスケジュール機能を使用するかどうかを指定

dynamic|《static》

rap_max_client

rapリスナーに同時接続する最大クライアント数

〈符号なし整数〉

((128〜1024))

《256》

rap_notify

rapクライアントマネジャに対する起動通知を行うかどうかを指定

Y|《N》

rap_client_manager_node

rapクライアントが存在するOpenTP1システムのホスト名

〈1〜255文字の識別子〉

rapクライアントの存在するOpenTP1システムのrapクライアントマネジャのポート番号

〈符号なし整数〉

((1〜65535))

rap_max_buff_size

ソケットウィンドウサイズ

〈符号なし整数〉

((4〜2147483647))《4》

（単位：キロバイト）

rap_io_retry_interval

電文送受信時のリトライ間隔

〈符号なし整数〉

((1〜999))《35》

（単位：ミリ秒）

rap_sock_count

ソケット生成処理のリトライ回数

〈符号なし整数〉

((0〜65535))《1》

rap_sock_interval

ソケット生成処理のリトライ間隔

〈符号なし整数〉

((15〜500))《30》

（単位：ミリ秒）

rap_connect_retry_count

コネクション確立処理のリトライ回数

〈符号なし整数〉

((8〜2147483647))《8》

rap_connect_retry_interval

コネクション確立処理のリトライ間隔

〈符号なし整数〉

((10〜999))《100》

（単位：ミリ秒）

rap_listen_backlog

接続待ちキューに保留できる最大要求数

〈符号なし整数〉

((SOMAXCONN〜2147483647))

《SOMAXCONN》

rap_msg_output_interval

クライアント数表示メッセージの出力間隔

〈符号なし整数〉

((0〜32767))《0》

（単位：分）

rap_recovery_server

リカバリ要求用待機rapサーバ数

〈符号なし整数〉

((0〜rap_parallel_serverオペランドの指定値-1))《0》

rap_connect_interval

コネクション確立処理の間隔

〈符号なし整数〉

((0〜999))《40》

（単位：ミリ秒）

rpc_extend_function

RPCサービスの機能拡張レベル

〈16進数字〉

((00000000〜0000000F))《00000000》

max_socket_descriptors

ソケット用ファイル記述子の最大数

〈符号なし整数〉

((32〜2032))

trn_completion_limit_time

トランザクション完了限界時間

〈符号なし整数〉

((0〜65535))

（単位：秒）

rap_message_id_change_level

メッセージIDの変更レベルを指定して，エラーメッセージの種類のEをWに変更

〈符号なし整数〉

((0〜2))

rap_term_disconnect_time

rapリスナー終了時のコネクション切断待ち時間

〈符号なし整数〉

((0〜3600))《0》

（単位：秒）

rap_stay_watch_time

rapサーバ割り当て待ち要求の滞留監視時間

〈符号なし整数〉

((0〜65535))《30》

（単位：秒）

rap_stay_warning_interval

滞留警告メッセージの出力間隔

〈符号なし整数〉

((3〜65535))《180》

（単位：秒）

log_audit_out_suppress

rapリスナーおよびrapサーバから出力される監査ログを抑止するかどうかを指定

Y|《N》

log_audit_message

監査ログを取得する項目のメッセージID

〈符号なし整数〉

((33400〜99999))

ipc_sockctl_highwater

ソケットの一時クローズ処理開始数パーセンテージ

〈符号なし整数〉

((0〜100))

ソケットの一時クローズ処理非対象数パーセンテージ

〈符号なし整数〉

((0〜100))

ipc_sockctl_watchtime

ソケット再利用可能監視時間

〈符号なし整数〉

((0〜65535))

（単位：秒）

scs_prf_trace_level

リモートAPI機能における性能検証用トレース取得レベル

〈符号なし整数〉

((00000000〜00000009))《00000001》

rap_extend_function

リモートAPI機能の機能拡張レベル

〈16進数字〉

((00000000〜00000001)) 《00000000》

watch_time

最大応答待ち時間

〈符号なし整数〉

((0〜65535))

（単位：秒）

2.2.33　rapクライアントマネジャサービス定義の内容

rapクライアントマネジャサービス定義の内容を，次の表に示します。

表2‒34　rapクライアントマネジャサービス定義の内容

形式

オペランド

定義内容

指定値

set

rap_client_manager_port

rapクライアントマネジャのポート番号

〈符号なし整数〉

((5001〜65535))

rap_listen_inf

rapリスナーを起動するOpenTP1ノードのノード識別子

〈4文字の識別子〉

rapリスナーのポート番号

〈符号なし整数〉

((5001〜65535))

リモートAPI機能によるサービスの受信口になるホスト名

〈1〜255文字の英数字，ピリオドおよびハイフン〉

リモートAPI機能によるサービスの受信口になるポート番号

〈符号なし整数〉

((1〜65535))

uid

OpenTP1管理者のユーザ識別子

〈符号なし整数〉

((0〜4294967294))

log_audit_out_suppress

rapクライアントマネジャから出力する監査ログを抑止するかどうかを指定

Y|《N》

log_audit_message

監査ログを取得する項目のメッセージID

〈符号なし整数〉

((33400〜99999))

rap_watch_time

メッセージ送受信最大監視時間

〈符号なし整数〉

((0〜65535))《180》

（単位：秒）

2.2.34　性能検証用トレース定義の内容

性能検証用トレース定義の内容を，次の表に示します。

表2‒35　性能検証用トレース定義の内容

形式

オペランド

定義内容

指定値

set

prf_buff_size

性能検証用トレースバッファサイズ

〈符号なし整数〉

((96〜131072))《1024》

（単位：キロバイト）

prf_file_count

性能検証用トレース情報ファイルの世代数

〈符号なし整数〉

((3〜256))《3》

prf_file_size

性能検証用トレース情報ファイルのサイズ

〈符号なし整数〉

((1024〜1048576))《10240》

（単位：キロバイト）

prf_information_level

トレースファイル関連のメッセージの出力レベル

《1》|0

prf_trace_backup

トレースファイルのバックアップを取得するかどうかを指定

《Y》|N

2.2.35　XAR性能検証用トレース定義の内容

XAR性能検証用トレース定義の内容を，次の表に示します。

表2‒36　XAR性能検証用トレース定義の内容

形式

オペランド

定義内容

指定値

set

prf_file_count

XAR性能検証用トレース情報ファイルの世代数

〈符号なし整数〉

((3〜256))《3》

prf_file_size

XAR性能検証用トレース情報ファイルのサイズ

〈符号なし整数〉

((1024〜1048576))《10240》

（単位：キロバイト）

prf_information_level

XAR性能検証用トレース関連のメッセージの表示レベル

1|0

2.2.36　JNL性能検証用トレース定義の内容

JNL性能検証用トレース定義の内容を，次の表に示します。

表2‒37　JNL性能検証用トレース定義の内容

形式

オペランド

定義内容

指定値

set

prf_file_count

JNL性能検証用トレース情報ファイルの世代数

〈符号なし整数〉

((3〜256))

prf_file_size

JNL性能検証用トレース情報ファイルのサイズ

〈符号なし整数〉

((1024〜1048576))《1024》

（単位：キロバイト）

prf_information_level

JNL性能検証用トレース関連のメッセージの表示レベル

1|0

prf_trace_backup

JNL性能検証用トレース情報ファイルのバックアップを取得するかどうかを指定

Y|N

2.2.37　LCK性能検証用トレース定義の内容

LCK性能検証用トレース定義の内容を，次の表に示します。

表2‒38　LCK性能検証用トレース定義の内容

形式

オペランド

定義内容

指定値

set

prf_file_count

LCK性能検証用トレース情報ファイルの世代数

〈符号なし整数〉

((3〜256))《3》

prf_file_size

LCK性能検証用トレース情報ファイルのサイズ

〈符号なし整数〉

((1024〜1048576))《5120》

（単位：キロバイト）

prf_information_level

LCK性能検証用トレース関連のメッセージの表示レベル

1|0

2.2.38　TRNイベントトレース定義の内容

TRNイベントトレース定義の内容を，次の表に示します。

表2‒39　TRNイベントトレース定義の内容

形式

オペランド

定義内容

指定値

set

prf_file_count

TRNイベントトレース情報ファイルの世代数

〈符号なし整数〉

((3〜256))《3》

prf_file_size

TRNイベントトレース情報ファイルのサイズ

〈符号なし整数〉

((1024〜1048576))《10240》

（単位：キロバイト）

prf_information_level

TRNイベントトレース関連のメッセージの表示レベル

1|0

2.2.39　リアルタイム統計情報サービス定義の内容

リアルタイム統計情報サービス定義の内容を，次の表に示します。

表2‒40　リアルタイム統計情報サービス定義の内容

形式

オペランド／コマンド

オプション

定義内容

指定値

set

rts_trcput_interval

統計情報の取得間隔

〈符号なし整数〉

((10〜86400))《600》

（単位：秒）

rts_service_max

最大取得サービス数

〈符号なし整数〉

((1〜1000))《64》

rts_item_max

最大取得項目数

〈符号なし整数〉

((1〜1000))《64》

rts_log_file

取得した統計情報をRTSログファイルに出力するかどうかを指定

《Y》|N

rts_log_file_name

RTSログファイル名

〈1〜63文字のパス名〉

《$DCDIR/spool/dcrtsinf/rtslog》

rts_log_file_size

RTSログファイルのサイズ

〈符号なし整数〉

((1024〜1048576))《1024》

（単位：キロバイト）

rts_log_file_count

RTSログファイルの世代数

〈符号なし整数〉

((1〜10))《3》

rts_log_file_backup

RTSログファイルのバックアップファイルを作成するかどうかを指定

《Y》|N

rts_swap_message

RTSログファイルのスワップメッセージ（KFCA32740-Iメッセージ）を出力するかどうかを指定

Y|《N》

コマンド

rtsput

-u

取得するリアルタイム統計情報の取得対象種別を設定

sys|srv|svc|obj

-s

サーバ名

〈1〜8文字で先頭が英字の英数字〉

-v

サービス名

〈1〜31文字の識別子〉

-o

取得対象名1

〈1〜8文字の文字列〉

-b

取得対象名2

〈1〜63文字の文字列〉

-e

項目ID

〈符号なし整数〉

((1000〜9999))

-f

リアルタイム取得項目定義ファイル名

〈1〜8文字の識別子〉

2.2.40　リアルタイム取得項目定義の内容

リアルタイム取得項目定義の内容を，次の表に示します。

表2‒41　リアルタイム取得項目定義の内容

形式

オペランド

定義種別

定義内容

指定値

set

rts_cpd_collct_cpd

チェックポイントダンプ情報

チェックポイントダンプ取得イベントを取得するかどうかを指定

Y|《N》

rts_cpd_validt_cpd

チェックポイントダンプ有効化イベントを取得するかどうかを指定

Y|《N》

rts_jnl_buf_full

ジャーナル情報

バッファ満杯イベントを取得するかどうかを指定

Y|《N》

rts_jnl_wait_buf

空きバッファ待ちイベントを取得するかどうかを指定

Y|《N》

rts_jnl_jnl_output

ジャーナル出力（ブロック）イベントを取得するかどうかを指定

Y|《N》

rts_jnl_io_wait

入出力待ちイベントを取得するかどうかを指定

Y|《N》

rts_jnl_write

writeイベントを取得するかどうかを指定

Y|《N》

rts_jnl_swap

スワップイベントを取得するかどうかを指定

Y|《N》

rts_jnl_jnl_input

ジャーナル入力イベントを取得するかどうかを指定

Y|《N》

rts_jnl_read

readイベントを取得するかどうかを指定

Y|《N》

rts_lck_lock_acqst

ロック情報

ロック取得イベントを取得するかどうかを指定

Y|《N》

rts_lck_lock_wait

ロック待ちイベントを取得するかどうかを指定

Y|《N》

rts_lck_deadlock

デッドロックイベントを取得するかどうかを指定

Y|《N》

rts_nam_global_cache_hit

ネーム情報

グローバルキャッシュヒットイベントを取得するかどうかを指定

Y|《N》

rts_nam_local_cache_hit

ローカルキャッシュヒットイベントを取得するかどうかを指定

Y|《N》

rts_nam_lookup

サービス情報の検索回数イベントを取得するかどうかを指定

Y|《N》

rts_nam_node_lookup

指定参照先ノードへのサービス検索の送信回数イベントを取得するかどうかを指定

Y|《N》

rts_nam_node_lookup_responce

指定参照先ノードへのサービス検索の応答受信回数イベントを取得するかどうかを指定

Y|《N》

rts_osl_stamem_acq

共用メモリ管理情報

静的共用メモリの使用サイズイベントを取得するかどうかを指定

Y|《N》

rts_osl_stamem_pol

静的共用メモリプールの必要最大サイズイベントを取得するかどうかを指定

Y|《N》

rts_osl_dynmem_acq

動的共用メモリの使用サイズイベントを取得するかどうかを指定

Y|《N》

rts_osl_dynmem_pol

動的共用メモリプールの必要最大サイズイベントを取得するかどうかを指定

Y|《N》

rts_prc_prc_genert

プロセス情報

プロセス生成イベントを取得するかどうかを指定

Y|《N》

rts_prc_uap_abnml

UAP異常終了イベントを取得するかどうかを指定

Y|《N》

rts_prc_sys_abnml

システムサーバ異常終了イベントを取得するかどうかを指定

Y|《N》

rts_prc_prc_term

プロセス終了イベントを取得するかどうかを指定

Y|《N》

rts_prc_prc_num

起動プロセス数の監視イベントを取得するかどうかを指定

Y|《N》

rts_que_read

メッセージキュー情報

readメッセージイベントを取得するかどうかを指定

Y|《N》

rts_que_write

writeメッセージイベントを取得するかどうかを指定

Y|《N》

rts_que_read_err

readエラーイベントを取得するかどうかを指定

Y|《N》

rts_que_write_err

writeエラーイベントを取得するかどうかを指定

Y|《N》

rts_que_wait_buf

空きバッファ待ちイベントを取得するかどうかを指定

Y|《N》

rts_que_real_read

実readイベントを取得するかどうかを指定

Y|《N》

rts_que_real_write

実writeイベントを取得するかどうかを指定

Y|《N》

rts_que_delay_wrt

遅延書き込み（回数）イベントを取得するかどうかを指定

Y|《N》

rts_que_delay_rec

物理ファイル単位の遅延書き込み（レコード）イベントを取得するかどうかを指定

Y|《N》

rts_que_delay_msg

物理ファイル単位の遅延書き込み（メッセージ）イベントを取得するかどうかを指定

Y|《N》

rts_rpc_rpc_call

RPC情報

RPCコール（同期応答型）イベントを取得するかどうかを指定

Y|《N》

rts_rpc_rpc_call_chained

RPCコール（連鎖RPC型）イベントを取得するかどうかを指定

Y|《N》

rts_rpc_usr_srvc

ユーザサービス実行イベントを取得するかどうかを指定

Y|《N》

rts_rpc_rpc_ovrtim

RPCタイムアウトイベントを取得するかどうかを指定

Y|《N》

rts_scd_scd_wait

スケジュール情報

スケジュール待ちイベントを取得するかどうかを指定

Y|《N》

rts_scd_schedule

スケジュールイベントを取得するかどうかを指定

Y|《N》

rts_scd_using_buf

メッセージ格納バッファプールの使用中サイズイベントを取得するかどうかを指定

Y|《N》

rts_scd_lack_buf

メッセージ格納バッファプールの不足でスケジュールできなかったメッセージサイズイベントを取得するかどうかを指定

Y|《N》

rts_scd_scd_stay

スケジュール滞留イベントを取得するかどうかを指定

Y|《N》

rts_scd_svc_scd_wait

サービス単位のスケジュール待ちイベントを取得するかどうかを指定

Y|《N》

rts_scd_svc_using_buf

サービス単位のメッセージ格納バッファプールの使用中サイズイベントを取得するかどうかを指定

Y|《N》

rts_scd_parallel

同時実行サービス数イベントを取得するかどうかを指定

Y|《N》

rts_trn_commit

トランザクション情報

コミットイベントを取得するかどうかを指定

Y|《N》

rts_trn_rollback

ロールバックイベントを取得するかどうかを指定

Y|《N》

rts_trn_cmt_cmd

コマンドによるコミットイベントを取得するかどうかを指定

Y|《N》

rts_trn_rbk_cmd

コマンドによるロールバックイベントを取得するかどうかを指定

Y|《N》

rts_trn_haz_cmd

コマンドによるハザードイベントを取得するかどうかを指定

Y|《N》

rts_trn_mix_cmd

コマンドによるミックスイベントを取得するかどうかを指定

Y|《N》

rts_trn_branch

ブランチ実行時間イベントを取得するかどうかを指定

Y|《N》

rts_trn_sync_point

ブランチ同期点処理の実行時間イベントを取得するかどうかを指定

Y|《N》

rts_dam_read

DAM情報

readイベントを取得するかどうかを指定

Y|《N》

rts_dam_read_err

readエラーイベントを取得するかどうかを指定

Y|《N》

rts_dam_write

writeイベントを取得するかどうかを指定

Y|《N》

rts_dam_write_err

writeエラーイベントを取得するかどうかを指定

Y|《N》

rts_dam_fj

FJ出力回数イベントを取得するかどうかを指定

Y|《N》

rts_dam_trn_branch

同時実行DAMトランザクションブランチ数イベントを取得するかどうかを指定

Y|《N》

rts_dam_cache_block

DAMキャッシュブロックの確保回数イベントを取得するかどうかを指定

Y|《N》

rts_dam_shm_pool

DAMキャッシュ用の共用メモリの使用率イベントを取得するかどうかを指定

Y|《N》

rts_tam_real_renew

TAM情報

TAMファイル実更新イベントを取得するかどうかを指定

Y|《N》

rts_tam_real_renew_time

TAMファイル実更新時間イベントを取得するかどうかを指定

Y|《N》

rts_tam_rec_refer

コミット，ロールバック（レコード参照）イベントを取得するかどうかを指定

Y|《N》

rts_tam_rec_renew

コミット，ロールバック（レコード更新）イベントを取得するかどうかを指定

Y|《N》

rts_tam_read

readイベントを取得するかどうかを指定

Y|《N》

rts_tam_read_err

readエラーイベントを取得するかどうかを指定

Y|《N》

rts_tam_write

writeイベントを取得するかどうかを指定

Y|《N》

rts_tam_write_err

writeエラーイベントを取得するかどうかを指定

Y|《N》

rts_xar_start

XAリソースサービス情報

アプリケーションサーバからRAPサーバへのトランザクション開始要求の回数イベントを取得するかどうかを指定

Y|《N》

rts_xar_start_err

アプリケーションサーバからRAPサーバへのトランザクション開始要求でのエラーイベントを取得するかどうかを指定

Y|《N》

rts_xar_call

アプリケーションサーバからRAPサーバへのサービス要求の回数イベントを取得するかどうかを指定

Y|《N》

rts_xar_call_err

アプリケーションサーバからRAPサーバへのサービス要求でのエラーイベントを取得するかどうかを指定

Y|《N》

rts_xar_end

アプリケーションサーバからRAPサーバへのトランザクション終了要求の回数イベントを取得するかどうかを指定

Y|《N》

rts_xar_end_err

アプリケーションサーバからRAPサーバへのトランザクション終了要求でのエラーイベントを取得するかどうかを指定

Y|《N》

rts_xar_prepare

アプリケーションサーバからRAPサーバへのトランザクションのプリペア処理要求の回数イベントを取得するかどうかを指定

Y|《N》

rts_xar_prepare_err

アプリケーションサーバからRAPサーバへのトランザクションのプリペア処理要求でのエラーイベントを取得するかどうかを指定

Y|《N》

rts_xar_commit

アプリケーションサーバからRAPサーバへのトランザクションのコミット処理要求の回数イベントを取得するかどうかを指定

Y|《N》

rts_xar_commit_err

アプリケーションサーバからRAPサーバへのトランザクションのコミット処理要求でのエラーイベントを取得するかどうかを指定

Y|《N》

rts_xar_rollback

アプリケーションサーバからRAPサーバへのトランザクションのロールバック処理要求の回数イベントを取得するかどうかを指定

Y|《N》

rts_xar_rollback_err

アプリケーションサーバからRAPサーバへのトランザクションのロールバック処理要求でのエラーイベントを取得するかどうかを指定

Y|《N》

rts_xar_recover

アプリケーションサーバからRAPサーバへのプリペア済み，またはヒューリスティック完了したトランザクション通知要求の回数イベントを取得するかどうかを指定

Y|《N》

rts_xar_recover_err

アプリケーションサーバからRAPサーバへのプリペア済み，またはヒューリスティック完了したトランザクション通知要求でのエラーイベントを取得するかどうかを指定

Y|《N》

rts_xar_forget

アプリケーションサーバからRAPサーバへのトランザクション破棄要求の回数イベントを取得するかどうかを指定

Y|《N》

rts_xar_forget_err

アプリケーションサーバからRAPサーバへのトランザクション破棄要求でのエラーイベントを取得するかどうかを指定

Y|《N》

rts_mcf_ap_scd_stay

MCF情報

スケジュール待ち情報を取得するかどうかを指定

Y|《N》

rts_mcf_ap_usr_srvc

ユーザサービス実行情報を取得するかどうかを指定

Y|《N》

rts_mcf_in_msg_scd_wait

論理端末単位に受信メッセージの処理待ち情報を取得するかどうかを指定

Y|《N》

rts_mcf_out_msg_sync_scd_wait

同期型送信メッセージの処理待ち情報を取得するかどうかを指定

Y|《N》

rts_mcf_out_msg_resp_scd_wait

問い合わせ応答型送信メッセージの処理待ち情報を取得するかどうかを指定

Y|《N》

rts_mcf_out_msg_prio_scd_wait

優先分岐型送信メッセージの処理待ち情報を取得するかどうかを指定

Y|《N》

rts_mcf_out_msg_norm_scd_wait

一般分岐型送信メッセージの処理待ち情報を取得するかどうかを指定

Y|《N》

rts_mcf_que_scd_wait_num

入力キューの滞留数の情報を取得するかどうかを指定

Y|《N》

2.2.41　ユーザサービスデフォルト定義の内容

ユーザサービスデフォルト定義の内容を，次の表に示します。

表2‒42　ユーザサービスデフォルト定義の内容

形式

オペランド／コマンド／パス

オプション

定義内容

指定値

set

nice

プロセスの優先順位の変更

〈符号なし整数〉

((0〜39))《0》

parallel_count

常駐プロセス数と最大プロセス数

〈符号なし整数〉

((0〜1024))《1》

hold

UAPが異常終了した場合にサービスグループまたはサービスを閉塞するかどうかを指定

《Y》|N

hold_recovery

サービスグループまたはサービスの閉塞状態を全面回復時に引き継ぐかどうかを指定

《Y》|N

deadlock_priority

UAPのデッドロックの優先順位

〈符号なし整数〉

((1〜127))《64》

schedule_priority

このサービスグループのスケジュールの優先順位

〈符号なし整数〉

((1〜16))《8》

message_buflen

最大メッセージ長

〈符号なし整数〉

((1024〜31457280))《4096》

（単位：バイト）

message_store_buflen

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

〈符号なし整数〉

((1024〜31457280))《4096》

（単位：バイト）

trn_expiration_time

トランザクションブランチの限界経過時間

〈符号なし整数〉

((0〜65535))

（単位：秒）

trn_expiration_time_suspend

トランザクションブランチの時間監視の範囲

Y|N|F

watch_next_chain_time

連鎖RPC間隔監視時間

〈符号なし整数〉

((0〜65535))《180》

（単位：秒）

atomic_update

サービスをトランザクションとして実行するかどうかを指定

《Y》|N

receive_from

スケジュールキュー，UNIXドメイン，またはインターネットドメインを使用するかどうかを指定

《queue》|socket|none

uap_trace_max

UAPトレース格納最大数

〈符号なし整数〉

((0〜4095))《32》

uap_trace_file_put

UAPトレース情報をファイルに取得するかどうかを指定

Y|N

term_watch_time

連続異常終了限界経過時間

〈符号なし整数〉

((0〜32767))《30》

（単位：分）

mcf_jnl_buff_size

MCFのジャーナルバッファの大きさ

〈符号なし整数〉

((4096〜131072))

（単位：バイト）

type

このサービスグループの種別

《other》|MHP|RAP

balance_count

1プロセスが処理するサービス要求数

〈符号なし整数〉

((0〜512))《3》

uid

ユーザ識別子

〈符号なし整数〉

((0〜4294967294))

auto_restart

UAPが異常終了した場合のサービスグループの処置

Y|《N》

critical

UAPが異常終了した場合のシステムの処置

Y|《N》

lck_wait_priority

排他待ちの優先順位

〈符号なし整数〉

((0〜127))《0》

mcf_psv_id

アプリケーション起動プロセス識別子

〈16進数〉

((01〜ff))

trn_cpu_time

トランザクションブランチが同期点処理までに使用できるCPU時間

〈符号なし整数〉

((0〜65535))

（単位：秒）

service_hold

サービス単位に閉塞管理するかどうかを指定

Y|《N》

service_priority_control

サービス要求単位の優先順位に従ってスケジュールするかどうかを指定

Y|《N》

message_cell_size

スケジュールメッセージ格納セルサイズ

〈符号なし整数〉

((512〜31457280))《512》

（単位：バイト）

max_socket_msg

ソケット受信型サーバが受信するメッセージ数の最大値

〈符号なし整数〉

((1〜500))《100》

max_socket_msglen

ソケット受信型サーバが受信するメッセージ長の最大値

〈符号なし整数〉

((1〜30270))《10240》

（単位：キロバイト）

trf_put

トランザクションが出力したジャーナルをトランザクションリカバリジャーナルファイルへ出力するかどうかを指定

Y|《N》

mcf_mgrid

アプリケーション起動プロセスの属するMCFマネジャ識別子

〈識別子〉

((A〜Z，a〜z))《A》

mcf_service_max_count

MCF通信関数発行回数上限値

〈符号なし整数〉

((0〜65535))

trn_statistics_item

トランザクションブランチの統計情報項目

nothing|base|

executiontime|cputime

node_down_restart

ユーザサーバを自動起動するかどうかを指定

《Y》|N

rpc_response_statistics

レスポンス統計情報を取得するかどうかを指定

Y|《N》

server_type

サービス関数の呼び出し時に従うパラダイム

《"betran"》

|"xatmi"|"xatmi_cbl"

trn_rm_open_close_scope

xa_open関数およびxa_close関数の発行タイミング

process|transaction

trn_optimum_item

トランザクションの最適化項目

base|asyncprepare

purge_msgget

サービスグループに割り当てたOSのメッセージキューを解放するかどうかを指定

Y|《N》

cancel_normal_terminate

dcsvstopコマンドによる正常終了を抑止するかどうかを指定

Y|《N》

prc_abort_signal

サーバのアボート用シグナル番号

〈符号なし整数〉

((1〜128))《3》

rpc_service_retry_count

サービスリトライ機能でサービス関数をリトライする回数の最大値

〈符号なし整数〉

((0〜65535))《0》

rpc_extend_function

RPCサービスの機能拡張レベル

〈16進数字〉

((00000000〜0000000F))《00000000》

max_socket_descriptors

ソケット用ファイル記述子の最大数

〈符号なし整数〉

((32〜2032))

max_open_fds

UAPプロセスでアクセスするファイルおよびパイプの最大数

〈符号なし整数〉

((16〜2016))《50》

service_term_watch_time

連続サービス異常終了限界経過時間

〈符号なし整数〉

((0〜32767))《0》

（単位：分）

termed_after_service

サービス終了時に負荷が減少している場合に非常駐プロセスを終了させるかどうかを指定

Y|《N》

xat_trn_expiration_time

他システムとの同期点処理の限界経過監視時間

〈符号なし整数〉

((1〜2147483647))《180》

（単位：秒）

xat_osi_usr

OSI　TP通信用のスタブを使用するかどうかを指定

Y|《N》

rpc_trace

RPCトレースを取得するかどうかを指定

Y|N

rpc_trace_name

RPCトレースを取得するファイル名

〈パス名〉

rpc_trace_size

RPCトレースを取得するファイルのサイズ

〈符号なし整数〉

((1024〜2147483648))

（単位：バイト）

trn_rollback_information_put

トランザクションブランチロールバック時にロールバック情報を取得するかどうかを指定

no|self|remote|all

schedule_method

ユーザサーバのスケジューリング方式

《msgque》|namedpipe

service_wait_time

ユーザサーバの非常駐プロセスのサービス要求待ち時間

〈符号なし整数〉

((1〜4096))（単位：秒）

mcf_spp_oj

SPPでのOJの履歴情報を取得するかどうかを指定

《Y》|N

adm_message_option

メッセージ出力指定

〈1けたの16進数〉

《F》

trn_watch_time

トランザクション同期点処理時の最大通信待ち時間

〈符号なし整数〉

((1〜65535))（単位：秒）

trn_limit_time

トランザクションブランチ最大実行可能時間

〈符号なし整数〉

((0〜65535))（単位：秒）

trn_rollback_response_receive

ロールバック完了通知を受信するかどうかを指定

Y|N

trn_partial_recovery_type

UAP障害時のトランザクション同期点処理方式

type1|type2|type3

rpc_destination_mode

サービスの送信先を決定する方法

namdonly|namd|

《definition》

rpc_rap_auto_connect

UAPとリモートAPI制御プロセスの間のコネクションを自動的に管理するかどうかを指定

《Y》|N

rpc_rap_inquire_time

リモートAPI機能を使用して要求するサービスの問い合わせ間隔最大時間

〈符号なし整数〉

((0〜1048575))《0》

（単位：秒）

rpc_request_cancel_for_timedout

クライアントUAPの応答待ち時間をサーバに意識させるかどうかを指定

《Y》|N

status_change_when_terming

次回再開始時に最終的な状態の変化を反映するかどうかを指定

《Y》|N

service_expiration_time

サービス関数開始から終了までの実行監視時間

〈符号なし整数〉

((0〜65535))《0》

（単位：秒）

multi_schedule

マルチスケジューラ機能を使用してスケジューリングするかどうかを指定

Y|《N》

make_queue_on_starting

非常駐のサービスグループに割り当てるスケジュールキューをサーバ起動時に割り当てるかどうかを指定

Y|《N》

loadcheck_interval

このサービスグループの負荷レベルを監視するインタバル

〈符号なし整数〉

((0〜65535))

levelup_queue_count

このサービスグループの負荷レベルを判断するサービス要求滞留数（up）

〈符号なし整数〉

((0〜32767))

leveldown_queue_count

このサービスグループの負荷レベルを判断するサービス要求滞留数（down）

〈符号なし整数〉

((0〜32767))

ipc_sockctl_highwater

ソケットの一時クローズ処理開始数パーセンテージ／ソケットの一時クローズ処理非対象数パーセンテージ

〈符号なし整数〉

((0〜100))《100，0》

ipc_sockctl_watchtime

ソケット再利用可能監視時間

〈符号なし整数〉

((0〜65535))《180》

（単位：秒）

ipc_conn_interval

コネクション確立監視時間

〈符号なし整数〉

((8〜65535))《8》

（単位：秒）

ipc_send_interval

データ送信監視間隔

〈符号なし整数〉

((5〜32767))《5》

（単位：秒）

ipc_send_count

データ送信監視回数

〈符号なし整数〉

((1〜32767))《5》

ipc_header_recv_time

通信制御データの受信監視時間

〈符号なし整数〉

((5〜32767))《10》

（単位：秒）

rpc_close_after_send

ノード間通信で確立したコネクションを保持したままにするか，ノード間通信が終了するたびにコネクションを切断するかどうかを指定

Y|《N》

rpc_send_retry_count

TCP/IPコネクションの接続時にエラーが発生した場合のリトライ回数

〈符号なし整数〉

((0〜65535))《0》

rpc_send_retry_interval

TCP/IPコネクションの接続時にエラーが発生した場合のリトライ間隔

〈符号なし整数〉

((0〜300000))《0》

（単位：ミリ秒）

ipc_recvbuf_size

TCP/IPの受信バッファサイズ

〈符号なし整数〉

((0，8192〜1048576))《8192》

（単位：バイト）

ipc_sendbuf_size

TCP/IPの送信バッファサイズ

〈符号なし整数〉

((0，8192〜1048576))《8192》

（単位：バイト）

ipc_listen_sockbufset

TCP/IPの送受信バッファサイズをlistenソケットに設定するかどうかを指定

Y|《N》

polling_control_data

一時クローズ処理要求が到着していないかどうかを検査

Y|《N》

thread_yield_interval

ソケットの再利用指示を受信できる契機を与えるインタバル時間

〈符号なし整数〉

((1〜86400))《90》

（単位：秒）

groups

サービスグループのグループアクセスリストを設定

〈符号なし整数〉

((0〜4294967294))

loadlevel_message

負荷レベル通知メッセージを出力するかどうかを指定

Y|《N》|A

ipc_backlog_count

コネクション確立要求を格納するキューの長さ

〈符号なし整数〉

((0〜4096))《0》

rpc_buffer_pool_max

プーリングするバッファ数

〈符号なし整数〉

((1〜64))《64》

schedule_delay_limit

スケジュール遅延限界経過時間

〈符号なし整数〉

((0〜32767))《0》

（単位：秒）

schedule_delay_abort

スケジュール遅延時にシステムダウンするかどうかを指定

Y|《N》

rap_autoconnect_con_error_msg

APIの代理実行要求時，rapサーバとのコネクションの切断を検知した場合に，エラーメッセージを出力するかどうかを指定

《Y》|N

core_shm_suppress

コアファイルへの共用メモリダンプの出力を抑止するかどうかを指定

Y|《N》

xat_connect_resp_time

通信イベント処理用SPPのアソシエーション確立の最大応答待ち時間

〈符号なし整数〉

((0〜65535))《180》

（単位：秒）

scd_poolfull_check_interval

メッセージ格納バッファプールのメモリ不足が連続して発生した場合に，KFCA00853-Eを出力するインタバル時間

〈符号なし整数〉

((0〜32767))《0》

（単位：秒）

scd_poolfull_check_count

メッセージ格納バッファプールのメモリ不足が連続して発生した場合に，KFCA00853-Eメッセージを出力する判断値

〈符号なし整数〉

((1〜32767))《10》

（単位：回）

scd_pool_warning_use_rate

警告メッセージを出力する判断値になるメッセージ格納バッファプールの使用率の上限値

〈符号なし整数〉

((0〜99))《0》

（単位：%）

scd_pool_warning_interval

メッセージ格納バッファプール使用率が超過したときの警告メッセージ出力インタバル時間

〈符号なし整数〉

((0〜32767))《0》

（単位：秒）

ipc_tcpnodelay

Nagleアルゴリズムを無効にするかどうかを指定

《Y》|N

stay_watch_queue_count

スケジュールキューの滞留監視判定を開始する際の判断になるサービス要求滞留数

〈符号なし整数〉

((0〜32767))《0》

stay_watch_check_rate

スケジュールキューの滞留監視判定処理で使用するサービス要求の処理率

〈符号なし整数〉

((1〜100))

（単位：%）

stay_watch_abort

スケジュールキューの滞留監視判定式を満たした場合に，OpenTP1をシステムダウンさせるかどうかを指定

Y|《N》

stay_watch_start_interval

スケジュールキューの滞留監視インタバル時間

〈符号なし整数〉

((1〜32767))《10》

（単位：秒）

stay_watch_check_interval

スケジュールキューの滞留監視判定インタバル時間

〈符号なし整数〉

((1〜65534))《10》

（単位：秒）

trn_completion_limit_time

トランザクション完了限界時間

〈符号なし整数〉

((0〜65535))

（単位：秒）

rap_message_id_change_level

メッセージIDの変更レベルを指定して，エラーメッセージの種類のEをWに変更

〈符号なし整数〉

((0〜2))

log_audit_out_suppress

監査ログを抑止するかどうかを指定

Y|《N》

log_audit_message

監査ログを取得する項目のメッセージID

〈符号なし整数〉

((33400〜99999))

mcf_prf_trace

ユーザサーバごとにMCF性能検証用トレース情報を取得するかどうかを指定

《Y》|N

scd_refresh_process

一つのサービス要求ごとに実行するプロセスを起動し直すかどうかを指定

Y|《N》

rap_extend_function

リモートAPI機能の機能拡張レベル

〈16進数字〉

((00000000〜00000001)) 《00000000》

prc_coredump_filter

coreファイルに共有メモリを含めるかの判断値

〈符号なし整数〉

((1，3，65，67))

watch_time

最大応答待ち時間

〈符号なし整数〉

((0〜65535))

（単位：秒）

scd_process_ctl_opt

このサービスグループ下のサーバプロセスが異常終了した場合に，サーバプロセスの再起動を抑止するかどうかを指定

《0》|1

rpc_rap_inquire_time_check

常設コネクションを使用し，かつオートコネクトモードの場合に，リモートAPI機能を使用してdc_rpc_call関数を呼び出すrapクライアント（SUP，SPP，MHP）で問い合わせ間隔最大時間をチェックするかどうかを指定

《Y》|N

stack_size_unlimited

プロセス起動時にプロセスが使用するスタックサイズを無制限（unlimited）に設定するかどうかを指定

Y|《N》

コマンド

trnrmid

-n

リソースマネジャ名

〈1〜31文字の識別子〉

-i

リソースマネジャ拡張子

〈1〜2文字の識別子〉

-k

リソースマネジャをリソースマネジャ接続先選択機能の対象とする場合に指定するかどうかを指定

なし。

scdbufgrp

-g

スケジュールバッファグループ名

〈1〜8文字の識別子〉

-s

共用メッセージ格納バッファ使用制限サイズ

〈符号なし整数〉

((512〜1610612736))

（単位：バイト）

-p

共用メッセージ格納バッファ使用制限率

〈符号なし整数〉

((1〜100))

（単位：％）

scdmulti

-g

マルチスケジューラグループ名

〈1〜8文字の識別子〉

《scdmltgp》

scdsvcdef

-c

サービス名

〈1〜31文字の識別子〉

-p

同時実行可能なサービス数

〈符号なし整数〉

((1〜1024))

-n

キューイング可能なサービス要求数

〈符号なし整数〉

((1〜65535))

-l

キューイング可能なメッセージ格納バッファプール長

〈符号なし整数〉

((512〜31457280))

（単位：バイト）

putenv

任意

環境変数名　環境変数値

〈文字列〉

XAT_CONNECT_RESP_TIME

通信イベント処理用SPPのアソシエーション確立の最大応答待ち時間

〈符号なし整数〉

((0〜65535))《180》

（単位：秒）

dcputenv

任意

環境変数名　環境変数値

〈文字列〉

2.2.42　ユーザサービス定義の内容

ユーザサービス定義の内容を，次の表に示します。

表2‒43　ユーザサービス定義の内容

形式

オペランド／コマンド／パス

オプション

定義内容

指定値

set

service_group

サービスグループ名

〈1〜31文字の識別子〉

module

このサービスグループを実行する実行形式プログラム名

〈1〜14文字の識別子〉

service

このサービスグループに属するサービス名とそのサービスを提供するエントリポイント名の組

〈1〜31文字の識別子〉

UAP共用ライブラリ名

〈1〜255文字のパス名〉

nice

プロセスの優先順位の変更

〈符号なし整数〉((0〜39))

parallel_count

常駐プロセス数と最大プロセス数

〈符号なし整数〉

((0〜1024))

hold

UAPが異常終了した場合にサービスグループまたはサービスを閉塞するかどうかを指定

Y|N

hold_recovery

サービスグループまたはサービスの閉塞状態を全面回復時に引き継ぐかどうかを指定

Y|N

deadlock_priority

UAPのデッドロックの優先順位

〈符号なし整数〉((1〜127))

schedule_priority

このサービスグループのスケジュールの優先順位

〈符号なし整数〉((1〜16))

message_buflen

最大メッセージ長

〈符号なし整数〉

((1024〜31457280))

（単位：バイト）

message_store_buflen

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

〈符号なし整数〉

((1024〜31457280))

（単位：バイト）

trn_expiration_time

トランザクションブランチの限界経過時間

〈符号なし整数〉

((0〜65535))（単位：秒）

trn_expiration_time_suspend

トランザクションブランチの時間監視の範囲

Y|N|F

watch_next_chain_time

連鎖RPC間隔監視時間

〈符号なし整数〉

((0〜65535))（単位：秒）

atomic_update

サービスをトランザクションとして実行するかどうかを指定

Y|N

receive_from

スケジュールキュー，またはUNIXドメインもしくはインターネットドメインを使用するかどうかを指定

queue|socket|none

uap_trace_max

UAPトレース格納最大数

〈符号なし整数〉

((0〜4095))

uap_trace_file_put

UAPトレース情報をファイルに取得するかどうかを指定

Y|N

term_watch_time

連続異常終了限界経過時間

〈符号なし整数〉

((0〜32767))

（単位：分）

mcf_jnl_buff_size

MCFのジャーナルバッファの大きさ

〈符号なし整数〉

((4096〜131072))

（単位：バイト）

type

このサービスグループの種別

other|MHP

balance_count

1プロセスが処理するサービス要求数

〈符号なし整数〉

((0〜512))

uid

ユーザ識別子

〈符号なし整数〉

((0〜4294967294))

auto_restart

UAPが異常終了した場合のサービスグループの処置

Y|N

critical

UAPが異常終了した場合のシステムの処置

Y|N

lck_wait_priority

排他待ちの優先順位

〈符号なし整数〉

((0〜127))

mcf_psv_id

アプリケーション起動プロセス識別子

〈16進数〉

((01〜ff))

trn_cpu_time

トランザクションブランチが同期点処理までに使用できるCPU時間

〈符号なし整数〉

((0〜65535))（単位：秒）

service_hold

サービス単位に閉塞管理するかどうかを指定

Y|N

service_priority_control

サービス要求単位の優先順位に従ってスケジュールするかどうかを指定

Y|N

message_cell_size

スケジュールメッセージ格納セルサイズ

〈符号なし整数〉

((512〜31457280))

（単位：バイト）

max_socket_msg

ソケット受信型サーバが受信するメッセージ数の最大値

〈符号なし整数〉((1〜500))

max_socket_msglen

ソケット受信型サーバが受信するメッセージ長の最大値

〈符号なし整数〉

((1〜30270))

（単位：キロバイト）

trf_put

トランザクションが出力したジャーナルをトランザクションリカバリジャーナルファイルへ出力するかどうかを指定

Y|N

mcf_mgrid

アプリケーション起動プロセスの属するMCFマネジャ識別子

〈識別子〉((A〜Z，a〜z))

mcf_service_max_count

MCF通信関数発行回数上限値

〈符号なし整数〉

((0〜65535))

trn_statistics_item

トランザクションブランチの統計情報項目

nothing|base|

executiontime|cputime

node_down_restart

ユーザサーバを自動起動するかどうかを指定

Y|N

rpc_response_statistics

レスポンス統計情報を取得するかどうかを指定

Y|N

server_type

サービス関数の呼び出し時に従うパラダイム

"betran"|"xatmi"|

"xatmi_cbl"

trn_rm_open_close_scope

xa_open関数およびxa_close関数の発行タイミング

process|transaction

trn_optimum_item

トランザクションの最適化項目

base|asyncprepare

purge_msgget

サービスグループに割り当てたOSのメッセージキューを解放するかどうかを指定

Y|N

cancel_normal_terminate

dcsvstopコマンドによる正常終了を抑止するかどうかを指定

Y|N

prc_abort_signal

サーバのアボート用シグナル番号

〈符号なし整数〉((1〜128))

rpc_service_retry_count

サービスリトライ機能でサービス関数をリトライする回数の最大値

〈符号なし整数〉

((0〜65535))

rpc_extend_function

RPCサービスの機能拡張レベル

〈16進数字〉

((00000000〜0000000F))

max_socket_descriptors

ソケット用ファイル記述子の最大数

〈符号なし整数〉

((32〜2032))

max_open_fds

UAPプロセスでアクセスするファイルおよびパイプの最大数

〈符号なし整数〉

((16〜2016))

service_term_watch_time

連続サービス異常終了限界経過時間

〈符号なし整数〉

((0〜32767))（単位：分）

termed_after_service

サービス終了時に負荷が減少している場合に非常駐プロセスを終了させるかどうかを指定

Y|N

xat_trn_expiration_time

他システムとの同期点処理の限界経過監視時間

〈符号なし整数〉

((1〜2147483647))（単位：秒）

xat_osi_usr

OSI　TP通信用のスタブを使用するかどうかを指定

Y|N

rpc_trace

RPCトレースを取得するかどうかを指定

Y|N

rpc_trace_name

RPCトレースを取得するファイル名

〈パス名〉

rpc_trace_size

RPCトレースを取得するファイルのサイズ

〈符号なし整数〉

((1024〜2147483648))

（単位：バイト）

trn_rollback_information_put

トランザクションブランチロールバック時にロールバック情報を取得するかどうかを指定

no|self|remote|all

schedule_method

ユーザサーバのスケジューリング方式

msgque|namedpipe

service_wait_time

ユーザサーバの非常駐プロセスのサービス要求待ち時間

〈符号なし整数〉

((1〜4096))（単位：秒）

mcf_spp_oj

SPPでのOJの履歴情報を取得するかどうかを指定

Y|N

adm_message_option

メッセージ出力指定

〈1けたの16進数〉

trn_watch_time

トランザクション同期点処理時の最大通信待ち時間

〈符号なし整数〉

((1〜65535))（単位：秒）

trn_limit_time

トランザクションブランチ最大実行可能時間

〈符号なし整数〉

((0〜65535))（単位：秒）

trn_rollback_response_receive

ロールバック完了通知を受信するかどうかを指定

Y|N

trn_partial_recovery_type

UAP障害時のトランザクション同期点処理方式

type1|type2|type3

rpc_destination_mode

サービスの送信先を決定する方法

namdonly|namd|definition

rpc_rap_auto_connect

UAPとリモートAPI制御プロセスの間のコネクションを自動的に管理するかどうかを指定

Y|N

rpc_rap_inquire_time

リモートAPI機能を使用して要求するサービスの問い合わせ間隔最大時間

〈符号なし整数〉

((0〜1048575))（単位：秒）

rpc_request_cancel_for_timedout

クライアントUAPの応答待ち時間をサーバに意識させるかどうかを指定

Y|N

status_change_when_terming

次回再開始時に最終的な状態の変化を反映するかどうかを指定

Y|N

service_expiration_time

サービス関数開始から終了までの実行監視時間

〈符号なし整数〉

((0〜65535))（単位：秒）

multi_schedule

マルチスケジューラ機能を使用してスケジューリングするかどうかを指定

Y|N

make_queue_on_starting

非常駐のサービスグループに割り当てるスケジュールキューをサーバ起動時に割り当てるかどうかを指定

Y|N

loadcheck_interval

このサービスグループの負荷レベルを監視するインタバル

〈符号なし整数〉

((0〜65535))

（単位：秒）

levelup_queue_count

このサービスグループの負荷レベルを判断するサービス要求滞留数（up）

〈符号なし整数〉

((0〜32767))

leveldown_queue_count

このサービスグループの負荷レベルを判断するサービス要求滞留数（down）

〈符号なし整数〉

((0〜32767))

ipc_sockctl_highwater

ソケットの一時クローズ処理開始数パーセンテージ／ソケットの一時クローズ処理非対象数パーセンテージ

〈符号なし整数〉

((0〜100))

ipc_sockctl_watchtime

ソケット再利用可能監視時間

〈符号なし整数〉

((0〜65535))

（単位：秒）

ipc_conn_interval

コネクション確立監視時間

〈符号なし整数〉

((8〜65535))

（単位：秒）

ipc_send_interval

データ送信監視間隔

〈符号なし整数〉

((5〜32767))

（単位：秒）

ipc_send_count

データ送信監視回数

〈符号なし整数〉

((1〜32767))

ipc_header_recv_time

通信制御データの受信監視時間

〈符号なし整数〉

((5〜32767))

（単位：秒）

rpc_close_after_send

ノード間通信で確立したコネクションを保持したままにするか，ノード間通信が終了するたびにコネクションを切断するかどうかを指定

Y|N

rpc_send_retry_count

TCP/IPコネクションの接続時にエラーが発生した場合のリトライ回数

〈符号なし整数〉

((0〜65535))

rpc_send_retry_interval

TCP/IPコネクションの接続時にエラーが発生した場合のリトライ間隔

〈符号なし整数〉

((0〜300000))

（単位：ミリ秒）

ipc_recvbuf_size

TCP/IPの受信バッファサイズ

〈符号なし整数〉

((0，8192〜1048576))

（単位：バイト）

ipc_sendbuf_size

TCP/IPの送信バッファサイズ

〈符号なし整数〉

((0，8192〜1048576))

（単位：バイト）

ipc_listen_sockbufset

TCP/IPの送受信バッファサイズをlistenソケットに設定するかどうかを指定

Y|N

polling_control_data

一時クローズ処理要求が到着していないかどうかを検査

Y|N

thread_yield_interval

ソケットの再利用指示を受信できる契機を与えるインタバル時間

〈符号なし整数〉

((1〜86400))

（単位：秒）

groups

サービスグループのグループアクセスリストを設定

〈符号なし整数〉

((0〜4294967294))

loadlevel_message

負荷レベル通知メッセージを出力するかどうかを指定

Y|N|A

ipc_backlog_count

コネクション確立要求を格納するキューの長さ

〈符号なし整数〉

((0〜4096))

rpc_buffer_pool_max

プーリングするバッファ数

〈符号なし整数〉

((1〜64))

schedule_delay_limit

スケジュール遅延限界経過時間

〈符号なし整数〉

((0〜32767))

（単位：秒）

schedule_delay_abort

スケジュール遅延時にシステムダウンするかどうかを指定

Y|N

rap_autoconnect_con_error_msg

APIの代理実行要求時，rapサーバとのコネクションが切断されていた場合に，エラーメッセージを出力するかどうかを指定

Y|N

core_shm_suppress

コアファイルへの共用メモリダンプの出力を抑止するかどうかを指定

Y|N

xat_connect_resp_time

通信イベント処理用SPPのアソシエーション確立の最大応答待ち時間

〈符号なし整数〉

((0〜65535))

（単位：秒）

scd_poolfull_check_interval

メッセージ格納バッファプールのメモリ不足が連続して発生した場合に，KFCA00853-Eを出力するインタバル時間

〈符号なし整数〉

((0〜32767))

（単位：秒）

scd_poolfull_check_count

メッセージ格納バッファプールのメモリ不足が連続して発生した場合に，KFCA00853-Eメッセージを出力する判断値

〈符号なし整数〉

((1〜32767))

（単位：回）

scd_pool_warning_use_rate

警告メッセージを出力する判断値になるメッセージ格納バッファプールの使用率の上限値

〈符号なし整数〉

((0〜99))

（単位：%）

scd_pool_warning_interval

メッセージ格納バッファプール使用率が超過したときの警告メッセージ出力インタバル時間

〈符号なし整数〉

((0〜32767))

（単位：秒）

ipc_tcpnodelay

Nagleアルゴリズムを無効にするかどうかを指定

Y|N

stay_watch_queue_count

スケジュールキューの滞留監視判定を開始する際の判断になるサービス要求滞留数

〈符号なし整数〉

((0〜32767))

stay_watch_check_rate

スケジュールキューの滞留監視判定処理で使用するサービス要求の処理率

〈符号なし整数〉

((1〜100))

（単位：%）

stay_watch_abort

スケジュールキューの滞留監視判定式を満たした場合に，OpenTP1をシステムダウンさせるかどうかを指定

Y|N

stay_watch_start_interval

スケジュールキューの滞留監視インタバル時間

〈符号なし整数〉

((1〜32767))

（単位：秒）

stay_watch_check_interval

スケジュールキューの滞留監視判定インタバル時間

〈符号なし整数〉

((1〜65534))

（単位：秒）

trn_completion_limit_time

トランザクション完了限界時間

〈符号なし整数〉

((0〜65535))

（単位：秒）

rap_message_id_change_level

メッセージIDの変更レベルを指定して，エラーメッセージの種類のEをWに変更

〈符号なし整数〉

((0〜2))

log_audit_out_suppress

監査ログを抑止するかどうかを指定

Y|N

log_audit_message

監査ログを取得する項目のメッセージID

〈符号なし整数〉

((33400〜99999))

mcf_prf_trace

ユーザサーバごとにMCF性能検証用トレース情報を取得するかどうかを指定

Y|N

scd_refresh_process

一つのサービス要求ごとに実行するプロセスを起動し直すかどうかを指定

Y|N

rap_extend_function

リモートAPI機能の機能拡張レベル

〈16進数字〉

((00000000〜00000001))

prc_coredump_filter

coreファイルに共有メモリを含めるかの判断値

〈符号なし整数〉

((1，3，65，67))

watch_time

最大応答待ち時間

〈符号なし整数〉

((0〜65535))

（単位：秒）

scd_process_ctl_opt

このサービスグループ下のサーバプロセスが異常終了した場合に，サーバプロセスの再起動を抑止するかどうかを指定

0|1

rpc_rap_inquire_time_check

常設コネクションを使用し，かつオートコネクトモードの場合に，リモートAPI機能を使用してdc_rpc_call関数を呼び出すrapクライアント（SUP，SPP，MHP）で問い合わせ間隔最大時間をチェックするかどうかを指定

Y|N

stack_size_unlimited

プロセス起動時にプロセスが使用するスタックサイズを無制限（unlimited）に設定するかどうかを指定

Y|N

コマンド

trnrmid

-n

リソースマネジャ名

〈1〜31文字の識別子〉

-i

リソースマネジャ拡張子

〈1〜2文字の識別子〉

-k

リソースマネジャをリソースマネジャ接続先選択機能の対象とするかどうかを指定

なし。

scdbufgrp

-g

スケジュールバッファグループ名

〈1〜8文字の識別子〉

-s

共用メッセージ格納バッファ使用制限サイズ

〈符号なし整数〉

((512〜1610612736))

（単位：バイト）

-p

共用メッセージ格納バッファ使用制限率

〈符号なし整数〉

((1〜100))

（単位：％）

scdmulti

-g

マルチスケジューラグループ名

〈1〜8文字の識別子〉

《scdmltgp》

scdsvcdef

-c

サービス名

〈1〜31文字の識別子〉

-p

同時実行可能なサービス数

〈符号なし整数〉

((1〜1024))

-n

キューイング可能なサービス要求数

〈符号なし整数〉

((1〜65535))

-l

キューイング可能なメッセージ格納バッファプール長

〈符号なし整数〉

((512〜31457280))

（単位：バイト）

putenv

任意

環境変数名　環境変数値

〈文字列〉

DCFPL_CONNECT_RETRY_COUNT

コネクション確立処理をリトライする回数

〈符号なし整数〉

((8〜2147483647))

DCFPL_CONNECT_RETRY_INTERVAL

コネクション確立処理のリトライ間隔

〈符号なし整数〉

((10〜999))

（単位：ミリ秒）

XAT_CONNECT_RESP_TIME

通信イベント処理用SPPのアソシエーション確立の最大応答待ち時間

〈符号なし整数〉

((0〜65535))

（単位：秒）

dcputenv

任意

環境変数名　環境変数値

〈文字列〉

3　システムサービス定義の詳細

システムサービス定義の詳細について，それぞれの定義ごとに説明します。

システム環境定義

形式

set形式

〔set mode_conf=AUTO|MANUAL1|MANUAL2〕
〔set static_shmpool_size=静的共用メモリの総量〕
〔set dynamic_shmpool_size=動的共用メモリの最大使用時の総量〕
〔set shmpool_attribute=free|fixed|hugepage〕
〔set user_command=ユーザ環境設定コマンド〕
〔set server_count=最大サーバ数〕
〔set user_server_ha=Y|N〕
〔set system_terminate_watch_time=システム終了監視時間〕
〔set start_scheduling_timing=BEFORE|AFTER〕
〔set system_init_watch_time=システム初期化の待ち時間〕
〔set user_command_online=システム開始完了コマンド〕
〔set preend_warning_watch_time=終了準備警告監視時間〕
〔set user_command_online_tp1mngr_id=Y|N〕
〔set default_value_option=システム定義のデフォルト値変更オプション〕
〔set ha_switch_error_retry_count=待機系OpenTP1起動失敗時のリトライ回数〕
〔set ha_switch_error_retry_interval=待機系OpenTP1起動失敗時のリトライ間隔〕
〔set redirect_file_name=出力先ファイル名〕

コマンド形式

なし。

putenv形式

〔putenv DCCONFPATH　定義ファイルの格納ディレクトリ〕
〔putenv DCADMDEBUG 0|1〕
〔putenv DCUAPCONFPATH　ユーザサービス定義ファイルまたはユーザサービスデフォルト定義ファイルの格納ディレクトリ〕

dcputenv形式

〔dcputenv DCCONFPATH　定義ファイルの格納ディレクトリ〕
〔dcputenv DCUAPCONFPATH　ユーザサービス定義ファイルまたはユーザサービスデフォルト定義ファイルの格納ディレクトリ〕

機能

OpenTP1システムの実行環境を定義します。

プロセスサービスがOpenTP1システム開始時にシステム環境定義を読み込みます。

システム環境定義を変更した場合，OpenTP1を正常終了してdcresetコマンドを実行してください。

説明

set形式のオペランド

●mode_conf=AUTO|MANUAL1|MANUAL2

　〜《MANUAL2》

OpenTP1システムの開始方法を指定します。

AUTO

自動開始になります。

MANUAL1

手動開始になります。ただし，前回のOpenTP1システムが異常終了した場合は，自動的に再開始します。

MANUAL2

手動開始になります。

前回の終了モード（正常終了・強制正常終了・計画停止A・計画停止B・強制停止・異常終了）とここで指定する開始方法の組み合わせによって開始形態が決まります。

前回の終了モードと，mode_confオペランドの指定値の組み合わせによる開始形態の違いを，次に示します。

開始形態の決定条件

開始形態

前回の終了モード

mode_confオペランドの指定値

開始方法

開始モード

正常終了

AUTO

手動※1

正常開始

MANUAL1

手動

MANUAL2

強制正常終了

AUTO

手動※1

正常開始

MANUAL1

手動

MANUAL2

計画停止A

AUTO

手動※1

再開始

MANUAL1

手動

再開始※3

MANUAL2

計画停止B

AUTO

手動※1

再開始

MANUAL1

手動

再開始※3

MANUAL2

強制停止

AUTO

手動※1

再開始

MANUAL1

手動

再開始※3

MANUAL2

異常終了

AUTO

自動

再開始

MANUAL1

自動※2

MANUAL2

手動

再開始※3

注

系切り替え構成の際のmode_confの指定内容については，マニュアル「OpenTP1 解説」の系切り替えの手順に関する記述を参照してください。

注※1

OS起動時は自動開始となります。

注※2

OS起動時は手動開始となります。

注※3

dcstart -nコマンドで強制的な正常開始もできます。ただし，強制的に正常開始すると，前回仕掛り中の情報は失われます。

●static_shmpool_size=静的共用メモリの総量

　〜〈符号なし整数〉（単位：キロバイト）

32ビット版の場合：((0〜1945600))《4096》

64ビット版の場合：((0〜67108864))《4096》

OpenTP1システムで，システムサービスがシステム開始から終了までの間，占有する共用メモリ（以後，静的共用メモリといいます）の総量を指定します。

必要に応じて起動するシステムサービスがある場合は，その起動に必要な容量も含めて指定します。

静的共用メモリの総量は，dynamic_shmpool_size指定値との合計が，次の値を超えないように指定してください。

32ビット版の場合は1945600

64ビット版の場合は67108864

このオペランドの指定値とdynamic_shmpool_size指定値との合計が上限値以下でも，共用メモリを確保またはマッピングできずにOpenTP1が起動できないことがあります。指定した共用メモリサイズで実際にOpenTP1を起動できるかどうかは，OSの共用メモリに関するパラメタに依存します。

共用メモリを確保またはマッピングできなかった場合，システムサービスプロセスやユーザサーバプロセスがKFCA00100-EまたはKFCA00107-Eメッセージを出力してダウンします。この場合は，OSの共用メモリに関するパラメタが適切か，共用メモリサイズを過大に見積もっていないか，または不要なライブラリをローディングしていないかを見直してください。OSの共用メモリに関するパラメタ，共用メモリサイズの見積もり，およびローディングするライブラリが適切である場合は，64ビット版への移行を検討してください。

なお，HP-UX版の32ビット版のOpenTP1を使用する場合，次の点に注意してください。

上限値は1038336です。

32ビット版のHP-UXでは，共用メモリのセグメントサイズの上限値が1ギガバイトです。OpenTP1は，内部的に必要とするサイズ（最大10メガバイト）を指定したサイズに加算して共用メモリの確保要求をします。そのため，静的共用メモリと動的共用メモリの合計値が上限の1,038,336キロバイトを超えると，OpenTP1システムの起動に失敗することがあります。これは，共用メモリの確保要求をするサイズが1ギガバイトを超えてしまうからです。

マルチOpenTP1での運用や，共用メモリを確保するほかのプログラムを同一マシン上で実行する場合は，共用メモリの合計サイズに注意してください。

システム全体で使用できる共用メモリのサイズは，HP-UX（IPF）の場合2ギガバイトです。

また，64ビット版のOpenTP1を使用する場合は，次の点に注意してください。

OpenTP1が動作するために必要なサイズの共用メモリを確保してください。

このオペランド指定値を増やすことによって，システムダウン時に出力されるコアファイルサイズが増大します。そのため，次の問題が発生することがあります。

コアファイル出力時のI/O占有によるマシン負荷の増大

ディスク容量の圧迫

また，再開始の時間や保守資料の取得コマンド（dcrasget）が長くなるおそれがあります。OSがAIXおよびLinuxの場合は，コアファイルに通常含まれている共用メモリを取り除くことができます。OSがHP-UXおよびWindowsの場合は，コアファイルに共用メモリは含まれていません。

＜OSがAIXの場合のコアファイルから共用メモリを取り除く方法＞

環境変数CORE_NOSHMをプロセスに設定することで，そのプロセスがコアファイルを出力する際に，コアファイルに通常含まれている共用メモリを取り除くことができます。OpenTP1のプロセスに対してこの機能を有効にする場合，環境変数CORE_NOSHMを表3-1に示す定義ファイルに指定します。

putenv CORE_NOSHM ""

例えば，巨大な共用メモリを使用している環境でコアファイルのサイズを極力抑えたい場合，この環境変数を設定してください。この設定によって，コアファイルにその巨大な共用メモリが含まれなくなるため，コアファイルの大きさを抑えることができます。ただし，コアファイルに含まれている共用メモリというのは，そのコアファイルを出力したプロセスがその瞬間参照していた共用メモリであり，トラブルシュートに大変有益な情報です。「コアファイルを出力する」という状態自体に何らかの問題があります。また，このときに出力されたコアファイルに含まれている共用メモリ情報には，問題を解決するのに必要な情報が含まれています。この環境変数を設定することによって，そのトラブルシュートに必要な情報が一部失われます。そのため，障害の問題解決に時間が掛かることがあります。特に，システムサーバがコアファイルを出力する事態は，システム的に異常な状態になっている可能性が高く，その瞬間の共用メモリがトラブルシュートに不可欠な場合があります。このことを踏まえた上で，設定してください。

表3‒1　環境変数CORE_NOSHMを定義するファイル

coreに共用メモリを含ませたくない対象

定義するファイル

ユーザサーバ

すべてのユーザサーバを無効にする場合：ユーザサービスデフォルト定義

特定のユーザサーバを無効にする場合：各ユーザサービス定義

システムサーバ

すべてのシステムサーバ※1を無効にする場合：システム共通定義※2

注※1

プロセスサーバに対しては有効になりません。

注※2

この設定をすると，ユーザサーバも自動的に対象となります。

この設定が有効なのは，システムサーバおよびユーザサーバです。OpenTP1が提供するコマンドでは有効にならない場合があります。この環境変数が適用可能かどうかは，使用しているAIXのバージョンに依存します。この環境変数が利用可能かどうかは，OSのサポートに問い合わせてください。

＜OSがLinuxの場合のコアファイルから共用メモリを取り除く方法＞

コアファイルに共用メモリを含めるかどうかを設定するprc_coredump_filterオペランドで，コアファイルに通常含まれている共用メモリを取り除くことができます。詳細は，システム共通定義，ユーザサービスデフォルト定義，またはユーザサービス定義のprc_coredump_filterオペランドの説明を参照してください。

64ビット版で，dynamic_shmpool_sizeオペランドの指定値との合計が1945600を超える場合，dcshmlsコマンドの出力形式が変わるので注意してください。詳細はマニュアル「OpenTP1 運用と操作」のdcshmlsコマンドの説明を参照してください。また，Hugepage機能を適用することをおすすめします。Hugepage機能の適用については，shmpool_attributeオペランドの説明を参照してください。

●dynamic_shmpool_size=動的共用メモリの最大使用時の総量

　〜〈符号なし整数〉（単位：キロバイト）

32ビット版の場合：((0〜1945600))《4096》

64ビット版の場合：((0〜67108864))《4096》

OpenTP1システムで，システムサービスがワークエリアイメージで動的にアクセスする共用メモリ（以後，動的共用メモリといいます）の最大使用時の総量を指定します。必要に応じて起動するシステムサービスがある場合は，その起動に必要な容量も含めて指定します。

動的共用メモリの最大使用時の総量は，static_shmpool_size指定値との合計が，次の値を超えないように指定してください。

32ビット版の場合は1945600

64ビット版の場合は67108864

このオペランドの指定値とstatic_shmpool_size指定値との合計が上限値以下でも，共用メモリを確保またはマッピングできずにOpenTP1が起動できないことがあります。詳細については，システム環境定義のstatic_shmpool_sizeオペランドの説明を参照してください。

なお，HP-UX版の32ビット版のOpenTP1を使用する場合，上限値は1038336です。また，システム全体で使用できる共用メモリサイズに制限があります。詳細については，システム環境定義のstatic_shmpool_sizeオペランドの説明を参照してください。

また，64ビット版のOpenTP1を使用する場合は，次の点に注意してください。

OpenTP1が動作するために必要なサイズの共用メモリを確保してください。

このオペランド指定値を増やすことによって，システムダウン時に出力されるコアファイルサイズが増大します。そのため，次の問題が発生することがあります。

コアファイル出力時のI/O占有によるマシン負荷の増大

ディスク容量の圧迫

また，再開始の時間や保守資料の取得コマンド（dcrasget）が長くなるおそれがあります。次のOSでは，コアファイルに通常含まれている共用メモリを取り除くことができます。なお，OSがHP-UXおよびWindowsの場合は，コアファイルに共用メモリは含まれていません。

＜OSがAIXの場合＞

環境変数CORE_NOSHMをプロセスに設定することで，そのプロセスがコアファイルを出力する際に，コアファイルに通常含まれている共用メモリを取り除くことができます。OpenTP1のプロセスに対してこの機能を有効にする場合，環境変数CORE_NOSHMを表3-2に示す定義ファイルに指定します。

putenv CORE_NOSHM ""

例えば，巨大な共用メモリを使用している環境でコアファイルのサイズを極力抑えたい場合，この環境変数を設定してください。この設定によって，コアファイルにその巨大な共用メモリが含まれなくなるため，コアファイルの大きさを抑えることができます。ただし，コアファイルに含まれている共用メモリというのは，そのコアファイルを出力したプロセスがその瞬間参照していた共用メモリであり，トラブルシュートに大変有益な情報です。「コアファイルを出力する」という状態自体に何らかの問題があります。また，このときに出力されたコアファイルに含まれている共用メモリ情報には，問題を解決するのに必要な情報が含まれています。この環境変数を設定することによって，そのトラブルシュートに必要な情報が一部失われます。そのため，障害の問題解決に時間が掛かることがあります。特に，システムサーバがコアファイルを出力する事態は，システム的に異常な状態になっている可能性が高く，その瞬間の共用メモリがトラブルシュートに不可欠な場合があります。このことを踏まえた上で，設定してください。

表3‒2　環境変数CORE_NOSHMを定義するファイル

coreに共用メモリを含ませたくない対象

定義するファイル

ユーザサーバ

すべてのユーザサーバを無効にする場合：ユーザサービスデフォルト定義

特定のユーザサーバを無効にする場合：各ユーザサービス定義

システムサーバ

すべてのシステムサーバ※1を無効にする場合：システム共通定義※2

注※1

プロセスサーバに対しては有効になりません。

注※2

この設定をすると，ユーザサーバも自動的に対象となります。

この設定が有効なのは，システムサーバおよびユーザサーバです。OpenTP1が提供するコマンドでは有効にならない場合があります。この環境変数が適用可能かどうかは，使用しているAIXのバージョンに依存します。この環境変数が利用可能かどうかは，OSのサポートに問い合わせてください。

＜OSがLinuxの場合＞

コアファイルに共用メモリを含めるかどうかを設定するprc_coredump_filterオペランドを定義することで，コアファイルに通常含まれている共用メモリを取り除くことができます。詳細は，システム共通定義，ユーザサービスデフォルト定義，またはユーザサービス定義のprc_coredump_filterオペランドを参照してください。

64ビット版の場合，static_shmpool_sizeオペランドの指定値との合計が1945600を超える場合，dcshmlsコマンドの出力形式が変わるので注意してください。詳細はマニュアル「OpenTP1 運用と操作」のdcshmlsコマンドの説明を参照してください。また，Hugepage機能を適用することをおすすめします。Hugepage機能の適用については，shmpool_attributeの説明を参照してください。

●shmpool_attribute=free|fixed|hugepage

　〜《free》

OpenTP1システムでは，静的共用メモリと動的共用メモリを合わせて，システムサービス用共用メモリプールとして確保します。このシステムサービス用共用メモリプールの属性を指定します。

free

システムサービス用共用メモリプールをメモリ上に固定しません。

実装するメモリ容量によっては，共用メモリのページングが発生するため，性能に悪影響を及ぼす場合があります。

fixed

システムサービス用共用メモリプールをメモリ上に固定します。

共用メモリのページングが発生しないため，共用メモリのアクセスによる性能への悪影響を防止できます。

ただし，実装するメモリ容量によっては，共用メモリ以外（テキストやデータセグメントなど）でページングが頻繁に発生する場合があります。そのため，実装するメモリや全使用容量に対する共用メモリプールの占める割合を検討してください。

この指定値はHP-UX版，およびSolaris版の場合だけ指定できます。なお，Solarisの場合，ご使用の環境によってはfixedを指定できないことがあります。詳細については，「リリースノート」を参照してください。

hugepage

システムサービス用共用メモリプールにLinuxのHugepage機能を適用して，OS管理領域のメモリ使用効率を向上します。

これによって，システムサービス用共用メモリプールを使用するプロセス数増加時にメモリ消費量を軽減できる場合があります。

この指定値はLinux版の64ビット版の場合だけ指定できます。

＜事前設定＞

この機能はLinuxのHugepage機能を使っているため，OpenTP1を起動する前に，LinuxのHugepage機能を有効にしておく必要があります。Hugepage機能については，OSのマニュアルを参照してください。Hugepage機能を有効にするときに設定するOSのカーネルパラメタの詳細については，マニュアル「OpenTP1 運用と操作」のHugepage機能の適用（Linux限定）の説明を参照してください。

また，プロセスサービス定義のprc_hugepage_group_idオペランドに，カーネルパラメタのvm.hugetlb_shm_groupに指定したグループIDを指定してください。

＜注意事項＞

この指定をした場合の注意事項を次に示します。

システムサービス用共用メモリプールがメモリ上に固定されます。

確保するシステムサービス用共用メモリプールの大きさがページサイズ※の大きさに切り上げられます。

OSの設定によっては，coreファイルにHugepage機能を適用した共用メモリが含まれません。coreファイルに共用メモリを含める場合は，システム共通定義，ユーザサービスデフォルト定義，またはユーザサービス定義のprc_coredump_filterオペランドを変更する必要があります。

注※

ページサイズは，「grep Hugepagesize /proc/meminfo」を実行して確認できます。ページサイズを確認する際は単位に注意してください。

＜指定の目安＞

システムサービス用共用メモリプールが実メモリ上に固定化された場合に，次のどちらにも該当しない場合は，この指定を推奨します。

残りの物理メモリの容量で他プロセスを含む固定化されないメモリのページングが頻繁に発生する

システム性能に影響する

●user_command=ユーザ環境設定コマンド

　〜〈パス名〉

OpenTP1の開始処理の最初に，実行するユーザ環境設定コマンドをパス名で指定します。ユーザ環境設定コマンドを指定すると，共用メモリの確保やファイルの初期化など，UAP全体の環境をOpenTP1の開始処理の最初に設定できます。

user_commandオペランド，およびuser_command_onlineオペランドに指定されたコマンドの，実行タイミングを次に示します。

ユーザ環境設定コマンドの実行環境は次のとおりです。

ユーザ環境設定コマンドは，系切り替え機能の使用の有無，および実行系，待機系に関係なく，OpenTP1の開始処理の最初に実行します。

ユーザID/グループIDはスーパユーザのUID/GID（0/0）です。

スーパユーザで実行される可能性があるので，システム環境定義ファイル（$DCDIR/conf/env）およびuser_commandオペランドで指定したファイルが変更されないように，それぞれのファイルの書き込み権限を削除しておくことをお勧めします。

シェルを使用する場合は，ボーンシェルだけ使用できます。

標準入力，標準出力，および標準エラー出力は，OpenTP1によってリダイレクトされます。

オンラインで使用する機能は，使用できません。

ユーザ環境設定コマンドの起動が失敗した場合，および0以外でexitした場合は，システムダウンします。

コアファイルは，_usrcmdN（N：1〜3）に退避されます。ただし，ユーザ環境設定コマンドでカレントワーキングディレクトリを変更した場合，コアファイルは退避されません。

標準入力，標準出力，標準エラー出力はO_NONBLOCK属性でopenされています。

●server_count=最大サーバ数

　〜〈符号なし整数〉((32〜9999))《64》

同一OpenTP1ノード内でシステム終了までに起動するサーバ数を指定します。

サーバ数は，OpenTP1システムで動作する全システムサービス，およびdcsvstartコマンドで指定するユーザサーバの数の合計値を指定します。同一名称のユーザサーバを複数回起動しても1として数えます。マルチサーバの場合は，サーバ数1と見なします。

server_countの指定値は，OSリソース（メモリ，ディスク容量，ポート番号など）に影響を与えます。このオペランドを変更した場合，「7.3.1　ユーザサーバの追加」を参照し，定義の見直しやOpenTP1ファイルの再見積もりの必要有無を確認してください。

なお，多くのユーザサーバを起動する場合，dcsvstartコマンドで起動すると，ユーザサーバの起動時間が長くなります。ユーザサービス構成定義を使用して，並列にユーザサーバを起動することを推奨します。

また，多くのユーザサーバを起動している場合，OpenTP1の停止までに時間が掛かるため，システム環境定義のsystem_terminate_watch_timeオペランドの指定値を見直してください。

server_countの値を変更した場合は，OpenTP1が停止した状態でdcsetupコマンドまたはdcresetコマンドを実行して定義の変更をOpenTP1に反映してください。

●user_server_ha=Y|N

　〜《N》

系切り替え時，システムサーバの起動を待たないで，待機系のユーザサーバを起動するかどうかを指定します。

Y

システムサーバの起動を待たないで，ユーザサーバを起動します。

N

システムサーバの起動を待って，ユーザサーバを起動します。

●system_terminate_watch_time=システム終了監視時間

　〜〈符号なし整数〉((0〜65535))《3600》（単位：秒）

dcstopコマンドでOpenTP1を終了する時の監視時間を指定します。指定した監視時間内にOpenTP1が終了しない場合は，OpenTP1は強制停止します。

0を指定した場合，終了時間は監視されません。

システムジャーナルサービス定義のjnl_auto_unloadオペランドにYを指定して自動アンロード機能を使用する場合は，アンロードに掛かる時間を考慮して，system_terminate_watch_timeオペランドの値を指定してください。

●start_scheduling_timing=BEFORE|AFTER

　〜《AFTER》

システム開始時に，RPCの受け付けの開始時期を指定します。

BEFORE

全ユーザサーバの起動前に，RPCの受け付けを開始します。BEFOREを指定した場合，RPCがユーザサーバ未起動のためにエラーになることがあります。

AFTER

全ユーザサーバの起動後に，RPCの受け付けを開始します。AFTERを指定した場合，全ユーザサーバが起動されるまでRPCはエラーになります。

このオペランドにBEFOREを指定した場合，ユーザサービス定義，ユーザサービスデフォルト定義のhold_recoveryオペランドの指定に関係なく，システム全面回復時にユーザサーバの閉塞状態は引き継がれません。システム全面回復時にユーザサーバの閉塞状態を引き継ぐ場合は，スケジュールサービス定義のscd_hold_recoveryオペランドにFを指定してください。各オペランドの指定による閉塞状態の引き継ぎについては，スケジュールサービス定義のscd_hold_recoveryオペランドを参照してください。

●system_init_watch_time=システム初期化の待ち時間

　〜〈符号なし整数〉((0〜65535))（単位：秒）

OpenTP1のシステム開始処理のうち，user_commandの実行を含めたシステム初期化処理（システムサービス開始前の初期化処理）の待ち時間の最大値を指定します。

0を指定した場合は，システム初期化処理が終わるまで無限に待ち続けます。

省略した場合は，システム共通定義のwatch_timeオペランドの値を仮定します。

●user_command_online=システム開始完了コマンド

　〜〈パス名〉

OpenTP1が起動を完了するときに実行するシステム開始完了コマンドをパス名で指定します。システム開始完了コマンドを指定すると，dcstatsコマンドなどの再開始で引き継がれないプロセスをOpenTP1の起動が完了するときに起動できます。

dcstartコマンドは，システム開始完了コマンドの完了を待ち合わせます。非同期に実行することで，dcstartコマンドを先に進めたい場合は，コマンドの最後に'&'を付けてください。

user_command_onlineオペランドに指定したプログラムが環境変数を必要とする場合，シェルスクリプトファイルに，プログラムが必要とする環境変数を宣言しておき，そのシェルスクリプトファイルをuser_command_onlineオペランドに指定することをお勧めします。シェルスクリプトファイルに，プログラムが必要とする環境変数を宣言していないと，システム構成を変更するなどの要因で，環境変数が引き継がれなくなったとき，OpenTP1の動作に影響を及ぼすことがあります。

システム開始完了コマンドの実行環境を次に示します。

ユーザIDおよびグループIDは次のIDで実行されます。なお，常にOpenTP1管理者で実行したい場合は，システム環境定義のuser_command_online_tp1mngr_idオペランドをYに指定してください。

OpenTP1管理者でdcstartコマンド実行した場合：OpenTP1管理者のUID/GID

開始方法を自動開始で起動した場合※：スーパユーザのUID/GID（0/0）

dcmstartコマンドで開始した場合：スーパユーザのUID/GID（0/0）

待機系が系切り替えによって起動した場合：OpenTP1管理者のUID，スーパユーザのGID（0）

注※

開始方法を自動開始にする方法については，マニュアル「OpenTP1 運用と操作」を参照してください。

スーパユーザで実行される可能性があるので，システム環境定義ファイル（$DCDIR/conf/env）およびuser_command_onlineオペランドで指定したファイルが変更されないように，それぞれのファイルの書き込み権限を削除しておくことをお勧めします。

シェルを使用する場合はボーンシェルだけ使用できます。

このオペランドに指定したコマンドの標準出力および標準エラー出力の出力先は次のとおりです。

＜mode_confオペランドの指定値がAUTOの場合＞

prcteeコマンドの引数で指定したファイルにリダイレクトされます。

＜mode_confオペランドの指定値がMANUAL1またはMANUAL2の場合＞

dcstartコマンドの実行環境に出力されます。ユーザ任意のファイルに出力する場合は，このオペランドに指定したコマンド内でリダイレクトして任意のファイルに出力してください。

オンラインで使用する機能が使用できます。

システム開始完了コマンドの起動が失敗した場合，および0以外でexitした場合はシステムダウンします。系切り替え機能を使用した場合，システムダウンによって系切り替えが発生します。

ただし，システム開始完了コマンドを非同期に実行した場合はコマンドが0以外でexitしてもシステムダウンしません。

コアファイルは_usrcmdonN（N：1〜3）に退避されます。ただし，システム開始完了コマンドでカレントワーキングディレクトリを変更した場合，コアファイルは退避されません。

●preend_warning_watch_time=終了準備警告監視時間

　〜〈符号なし整数〉((0〜65535))《180》（単位：秒）

dcstopコマンドの終了準備処理で警告メッセージKFCA01859-Wを出力するまでの時間を指定します。0を指定した場合は時間監視をしません。

●user_command_online_tp1mngr_id=Y|N

　〜《N》

user_command_onlineオペランドに指定したシステム開始完了コマンドをOpenTP1管理者のUID/GIDで実行するかどうかを指定します。

Y

システム開始完了コマンドをOpenTP1管理者のUID/GIDで実行します。

N

システム開始完了コマンドのUID/GIDは，次に示すUID/GIDで実行されます。

OpenTP1管理者でdcstartコマンド実行した場合：OpenTP1管理者のUID/GID

開始方法を自動開始で起動した場合※：スーパユーザのUID/GID（0/0）

dcmstartコマンドで開始した場合：スーパユーザのUID/GID（0/0）

待機系が系切り替えによって起動した場合：OpenTP1管理者のUID，スーパユーザのGID（0）

注※

開始方法を自動開始にする方法については，マニュアル「OpenTP1 運用と操作」を参照してください。

●default_value_option=システム定義のデフォルト値選択オプション

　〜〈符号なし整数〉((0〜1))《1》

システム定義オペランドのうち，次に示すオペランドについて07-50以降のデフォルト値で動作するか，07-50より前のデフォルト値で動作するか指定します。

0

07-50より前のバージョンでのデフォルト値で動作します。

1

07-50以降のバージョンで推奨するデフォルト値で動作します。

この指定値によってデフォルト値が変更されるのは次に示すオペランドだけです。

デフォルト値が変更されるオペランド

採用されるデフォルト値

default_value_optionオペランドの指定値

0

1

システム共通定義

（betranrc）

trn_prf_trace_level

00000001

00000003

ipc_listen_sockbufset

N

Y

fil_prf_trace_delay_time

10

3

ロックサービス定義

（lck）

lck_deadlock_info

N

Y

スケジュールサービス定義

（scd）

ipc_tcpnodelay

N

Y

ログサービス定義

（log）

log_filesize

1024

10240

性能検証用トレース定義

（prf）

prf_file_size

1024

10240

prf_buff_size

96

1024

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

（usrrc）

ipc_tcpnodelay

N

Y

MCFマネジャ定義

mcfmcomn -i

inc

msg

mcfmuap -e segsize

512

32768

mcfmuap -c order

function

commit

mcfmuap -c noansreply

no

yes

mcfmuap -c errevt_recovery

no

yes

MCF通信構成定義

（プロトコル固有定義（TP1/NET/TCP/IP））

mcftalccn -f releaselog

1

2

mcftalccn -f cnerrlog

1

2

システムサービス共通情報定義

mcf_prf_trace_level

00000000

00000001

TCP構成定義

mqttcp -t disk

no

yes

mqttcp -t bufcnt

100

2500

クラスタセンダTCP構成定義

mqttcpcs -t disk

no

yes

mqttcpcs -t bufcnt

100

2500

クラスタレシーバTCP構成定義

mqttcpcr -t disk

no

yes

mqttcpcr -t bufcnt

100

2500

●ha_switch_error_retry_count=待機系OpenTP1起動失敗時のリトライ回数

　〜〈符号なし整数〉((0〜3))《0》

待機系の系切り替え起動処理が失敗した際に，待機系の起動処理をリトライする回数を指定します。1以上を指定する場合は，HAモニタのサーバ対応の環境設定（servers）のfunction定義文のswitch_errorオペランドにretryを指定してください。なお，switch_errorオペランドの指定は実行系と待機系で同じにする必要があります。

リトライ回数を超えても，待機系の系切り替え起動処理が失敗した場合は，KFCA01888-Iメッセージを出力してリトライを終了します。

OpenTP1システム連続異常終了限界回数（term_watch_countオペランド）までOpenTP1がシステムダウンした場合，待機系の系切り替え起動処理のリトライを終了します。

省略した場合，または0を指定した場合はリトライしません。

●ha_switch_error_retry_interval=待機系OpenTP1起動失敗時のリトライ間隔

　〜〈符号なし整数〉((1〜60))《10》（単位：秒）

待機系の系切り替え起動処理が失敗した際に，待機系の起動処理をリトライする間隔を指定します。このオペランドを有効にするには，ha_switch_error_retry_countオペランドに1以上を指定する必要があります。リトライの間隔は，待機系の系切り替え起動処理が失敗してから，起動処理をリトライするまでの間隔時間です。

●redirect_file_name=出力先ファイル名

　〜〈1〜255文字のパス名〉

OpenTP1配下のプロセスの標準出力，標準エラー出力の出力先ファイル名を絶対パス名で指定します。

注意事項

このオペランドを指定しなかった場合

OpenTP1配下のプロセスの標準出力および標準エラー出力は，パイプファイルを経由して，prcteeコマンドに指定した出力ファイル名に出力されます。パイプファイルに対して高負荷で書き込みが頻発すると，メッセージが破棄されることがあります。

このオペランドを指定した場合

prcteeコマンドに出力ファイル名を指定していても，このオペランドに指定した出力先ファイル名に出力先を切り替えます。ただし，出力先ファイル名に指定したファイルサイズが無制限に増加しディスクを圧迫するおそれがあるため，定期的に出力先ファイルを削除して使用してください。

指定した出力先ファイルは，prcdプロセスを起動したときにオープンします。そのため，ファイルを削除する場合は，dcsetupコマンドを実行してprcdプロセスの常駐を停止したあと，rmコマンドで削除してください。次にコマンドの形式を示します。

# dcsetup -d OpenTP1ディレクトリ
（問い合わせメッセージには"n"を入力してください。）
# rm -f 出力先ファイル名

コマンド形式

なし。

putenv形式のオペランド

●DCCONFPATH　定義ファイルの格納ディレクトリ

　〜〈パス名〉《$DCDIR/conf》

各定義ファイルが格納されているディレクトリの絶対パス名を246バイト以下で指定します。ただし，環境変数は指定できません。

標準とは別のディレクトリ下にある定義ファイルのディレクトリを変更するときなどに使用します。

ただし，システム環境定義ファイル'env'を格納するディレクトリは変更できません。DCCONFPATHを指定する場合でも，システム環境定義ファイル'env'だけは$DCDIR/confになければなりません。

●DCADMDEBUG 0|1

　〜《0》

デバッグ情報を取得するかどうかを定義します。

OpenTP1ではUAPがダウンした場合，OpenTP1の障害情報を取得するためにnetstatコマンドを発行します。netstatコマンドはUAPが連続ダウンした場合には複数投入されるので，構成によってはCPUを使い過ぎてマシン負荷が大きくなることがあります。CPU利用率を抑えたいときは，このオペランドの指定を1にしてください。

0

サーバダウン時に取得するnetstatの情報を出力します。

1

サーバダウン時に取得するnetstatの情報を出力しません。

●DCUAPCONFPATH　ユーザサービス定義ファイルまたはユーザサービスデフォルト定義ファイルの格納ディレクトリ

　〜〈パス名〉

特定のユーザサービス定義ファイルまたはユーザサービスデフォルト定義ファイルだけを，DCCONFPATH環境変数で指定したディレクトリ以外のディレクトリに格納したい場合，そのディレクトリの絶対パス名を246バイト以下で指定します。ただし，環境変数は指定できません。

DCCONFPATH環境変数とDCUAPCONFPATH環境変数で指定したディレクトリの両方にユーザサービスデフォルト定義ファイルを格納していた場合，DCCONFPATH環境変数で指定したディレクトリに格納しているユーザサービスデフォルト定義が優先されます。

dcputenv形式のオペランド

●DCCONFPATH　定義ファイルの格納ディレクトリ

　〜〈パス名〉

各定義ファイルが格納されているディレクトリの絶対パス名を指定します。環境変数を指定した場合，その値も取得します。指定するパス名は，環境変数の値も含め246バイト以下としてください。

標準とは別のディレクトリ下にある定義ファイルのディレクトリを変更するときなどに使用します。

●DCUAPCONFPATH　ユーザサービス定義ファイルまたはユーザサービスデフォルト定義ファイルの格納ディレクトリ

　〜〈パス名〉

特定のユーザサービス定義ファイルまたはユーザサービスデフォルト定義ファイルだけを，DCCONFPATH環境変数で指定したディレクトリ以外のディレクトリに格納したい場合，そのディレクトリを絶対パス名で指定します。

ディレクトリ名に環境変数を指定した場合，その値も取得します。指定するパス名は，環境変数の値も含め246バイト以下としてください。

DCCONFPATH環境変数とDCUAPCONFPATH環境変数で指定したディレクトリの両方にユーザサービスデフォルト定義ファイルを格納していた場合，DCCONFPATH環境変数で指定したディレクトリに格納しているユーザサービスデフォルト定義が優先されます。

注意事項

従来どおり，ユーザサービス定義ファイルがDCCONFPATH環境変数に指定したディレクトリにある場合，そのディレクトリのユーザサービス定義ファイルが有効となります。

ログイン環境に，DCCONFPATH環境変数およびDCUAPCONFPATH環境変数を定義している場合は，ここで定義したものと同じ定義値にしてください。

システムサービス構成定義

形式

set形式

〔set uap_conf=Y|N〕
〔set dam_conf=Y|N〕
〔set tam_conf=Y|N〕
〔set que_conf=Y|N〕
〔set ha_conf=Y|N〕
〔set jar_conf=Y|N〕
〔set clt_conf=Y|N〕
〔set ist_conf=Y|N〕
〔set rmm_conf=Y|N〕
〔set xat_conf=Y|N〕
〔set mqa_conf=Y|N〕

コマンド形式

〔dcsvstart -m　システムサービス名〕

機能

同一マシンで一つのOpenTP1システムとしてシステム起動時に一緒に開始するサービス群の構成を定義します。

説明

set形式のオペランド

●uap_conf=Y|N

　〜《N》

このノードでOpenTP1システム起動時に，一緒にユーザサーバを起動するかどうかを指定します。

Y

このノードでOpenTP1システム起動時に，一緒にユーザサーバを起動します。

N

このノードでOpenTP1システム起動時に，一緒にユーザサーバを起動しません。

このオペランドにYを指定した場合，一緒に起動するユーザサーバをユーザサービス構成定義に定義しておく必要があります。

●dam_conf=Y|N

　〜《N》

このノードでDAMサービスを使用するかどうかを指定します。

Y

このノードでDAMサービスを使用します。

N

このノードでDAMサービスを使用しません。

●tam_conf=Y|N

　〜《N》

このノードでTAMサービスを使用するかどうかを指定します。

Y

このノードでTAMサービスを使用します。

N

このノードでTAMサービスを使用しません。

●que_conf=Y|N

　〜《N》

このノードでメッセージキューサービス（MCFサービス）を使用するかどうかを指定します。

Y

このノードでメッセージキューサービスを使用します。

N

このノードでメッセージキューサービスを使用しません。

●ha_conf=Y|N

　〜《N》

このノードで系切り替え機能を使用するかどうかを指定します。

Y

このノードで系切り替え機能を使用します。

N

このノードで系切り替え機能を使用しません。

●jar_conf=Y|N

　〜《N》

このノードでグローバルアーカイブジャーナルサービスを実行するかどうかを指定します。

Y

グローバルアーカイブジャーナルサービスを実行します。

N

グローバルアーカイブジャーナルサービスを実行しません。

このオペランドでYを指定する場合は，TP1/Multiが必要です。

●clt_conf=Y|N

　〜《N》

このノードでクライアント拡張サービスを使用するかどうかを指定します。

Y

クライアント拡張サービスを使用します。

N

クライアント拡張サービスを使用しません。

CUPからクライアント拡張サービスを使用する場合は，Yを指定してください。

Yを指定する場合，クライアントサービス定義が必要となります。

クライアント拡張サービスは，CUPからトランザクションを起動したり，常設コネクションを確立したりする場合に指定します。

リモートAPI機能を使用する場合には，このオペランドにYを指定する必要はありません。

注

Yを指定する場合，ユーザサービスデフォルト定義のtrnrmid定義コマンドでリソースマネジャ拡張子を定義しないでください。定義すると，OpenTP1が起動できなくなります。

●ist_conf=Y|N

　〜《N》

このノードでISTサービスを使用するかどうかを指定します。

Y

このノードでISTサービスを使用します。

N

このノードでISTサービスを使用しません。

●rmm_conf=Y|N

　〜《N》

このノードでRMMサービスを使用するかどうかを指定します。

Y

このノードでRMMサービスを使用します。

N

このノードでRMMサービスを使用しません。

●xat_conf=Y|N

　〜《N》

このノードでXATMI通信サービスを使用するかどうかを指定します。

Y

このノードでXATMI通信サービスを使用します。

N

このノードでXATMI通信サービスを使用しません。

TP1/NET/OSI-TP-Extendedを使用して，XATMIインタフェースでOSI TP通信を実行する場合は，Yを指定してください。TCP/IP通信だけを実行する場合は，Nを指定してください。

●mqa_conf=Y|N

　〜《N》

このノードでMQAサービスを使用するかどうかを指定します。

Y

このノードでMQAサービスを使用します。

N

このノードでMQAサービスを使用しません。

コマンド形式

次ページ以降に記述しています。

dcsvstart

名称

システムサービスの起動

形式

〔dcsvstart -m　システムサービス名〕

機能

このノードで使用するMCFサービスを起動します。

オプション

●-m　システムサービス名

　〜〈1〜8文字の英数字〉

このノードで使用するMCFサービスの名称を指定します。

これによって，MCFサービスが起動します。

MCFサービス名には，先頭3文字が'_mu'で始まる名称を指定します。

このMCFサービス名は，MCF定義オブジェクト生成ユティリティ（mcfmngr）で生成するMCFマネジャ定義の出力オブジェクトファイル名です。

ユーザサービス構成定義

形式

set形式

なし。

コマンド形式

{{dcsvstart -u　ユーザサーバ名〔，ユーザサーバ名〕…}}

機能

同一マシンで一つのOpenTP1システムとしてシステム起動時に一緒に開始するユーザサーバ群の構成を定義します。

説明

set形式

なし。

コマンド形式

次ページ以降に記述しています。

dcsvstart

名称

ユーザサーバの起動

形式

{{dcsvstart -u　ユーザサーバ名〔，ユーザサーバ名〕…}}

機能

このノードで使用するユーザサーバを起動します。

ユーザサーバの開始がOpenTP1システムの開始と一緒に行われます。また，ユーザサーバの起動順序を制御できます。OpenTP1の開始モードが正常開始の場合は，ユーザサービス構成定義の指定に従い，OpenTP1開始時にユーザサーバを起動します。再開始時は，前回のオンラインの終了状態を引き継いで開始するため，ユーザサービス構成定義の指定は無視します。

ユーザサービス定義でサービスグループの常駐・非常駐の指定に関係なく，ユーザサーバを起動しなければこのサービスグループをコールできません。

なお，運用コマンドで起動するユーザサーバは指定しません。

オプション

●-u　ユーザサーバ名〔，ユーザサーバ名〕…

　〜〈1〜8文字の識別子〉

このノードに起動するユーザサーバの名称を指定します。ユーザサービス定義のファイル名がユーザサーバ名になります。

一つのdcsvstart定義コマンドで指定できるユーザサーバ名の最大数は50です。

指定したユーザサーバ群は並列に起動され，すべて起動されてから次のコマンドを実行します。指定例を次に示します。

サーバAとサーバBを並列に起動する場合

dcsvstart -u サーバA,サーバB

サーバAの起動後に，サーバBを起動する場合

dcsvstart -u サーバA

dcsvstart -u サーバB

注

サーバ内で次の関数を発行したタイミングで起動完了とします。

dc_adm_complete関数

dc_mcf_mainloop関数

dc_rpc_mainloop関数

システム共通定義

形式

set形式

〔set rpc_trace=Y|N〕
〔set rpc_trace_name="RPCトレースを取得するファイル名"〕
〔set rpc_trace_size=RPCトレースを取得するファイルのサイズ〕
〔set name_port=ネームサービスのポート番号〕
〔set system_id=OpenTP1識別子〕
〔set all_node="ノード名〔:ポート番号〕〔:high〕"
            〔,"ノード名〔:ポート番号〕〔:high〕"…〕〕
  set node_id=ノード識別子
〔set rpc_retry=Y|N〕
〔set rpc_retry_count=RPC処理のリトライ回数最大値〕
〔set rpc_retry_interval=RPC処理のリトライ間隔〕
〔set multi_node_option=Y|N〕
〔set prc_port=マルチノード連携制御機能で使用するポート番号〕
〔set rpc_delay_statistics=Y|N〕
〔set my_host="ホスト名"|MYHOST〕
〔set jp1_use=Y|N〕
〔set rpc_message_level=RPCのトラブルシュートメッセージの表示レベル〕
〔set rpc_multi_tp1_in_same_host=Y|N〕
〔set max_socket_descriptors=ソケット用ファイル記述子の最大数〕
〔set rpc_datacomp=Y|N〕
〔set domain_masters_addr="ドメイン名=ホスト名1〔:ポート番号1〕
                            〔,ホスト名2〔:ポート番号2〕
                            〔,ホスト名3〔:ポート番号3〕〕〕"
                            〔,"ドメイン名=ホスト名1〔:ポート番号1〕
                            〔,ホスト名2〔:ポート番号2〕
                            〔,ホスト名3〔:ポート番号3〕〕〕"…〕〕
〔set domain_masters_port=
                    ドメイン代表スケジュールサービスのポート番号〕
〔set domain_use_dns=Y|N〕
〔set client_uid_check=Y|N〕
〔set rpc_port_base=最小ポート番号〕
〔set prf_trace=Y|N〕
〔set trn_prf_trace_level=トレースの取得レベル〕
〔set core_suppress_watch_time=実時間監視タイムアウトプロセスの
                               コアダンプ出力を抑止する時間間隔〕
〔set rpc_netmask=TCP/IPのネットワーク定義ファイルに指定した
                  サブネットマスク値〕
〔set ipc_sockctl_highwater=
                      ソケットの一時クローズ処理開始数パーセンテージ
                   〔,ソケットの一時クローズ処理非対象数パーセンテージ〕〕
〔set ipc_sockctl_watchtime=ソケット再利用可能監視時間〕
〔set ipc_conn_interval=コネクション確立監視時間〕
〔set ipc_send_interval=データ送信監視間隔〕
〔set ipc_send_count=データ送信監視回数〕
〔set ipc_header_recv_time=通信制御データの受信監視時間〕
〔set rpc_close_after_send=Y|N〕
〔set name_notify=Y|N〕
〔set all_node_ex="ノード名〔:ポート番号〕"
               〔,"ノード名〔:ポート番号〕"…〕〕
〔set rpc_server_busy_count=KFCA00356-Wメッセージを出力する
                            バンドル回数〕
〔set rpc_send_retry_count=TCP/IPコネクションの接続時にエラーが発生した
                           場合のリトライ回数〕
〔set rpc_send_retry_interval=TCP/IPコネクションの接続時にエラーが
                              発生した場合のリトライ間隔〕
〔set thdlock_sleep_time=スレッド間で排他が競合した場合のスレッドの
                         待ち時間〕
〔set ipc_recvbuf_size=TCP/IPの受信バッファサイズ〕
〔set ipc_sendbuf_size=TCP/IPの送信バッファサイズ〕
〔set ipc_listen_sockbufset=Y|N〕
〔set rpc_router_retry_count=ENOBUFS，ENOMEM発生時のリトライ回数〕
〔set rpc_router_retry_interval=ENOBUFS，ENOMEM発生時のリトライ間隔〕
〔set ipc_backlog_count=コネクション確立要求を格納するキューの長さ〕
〔set statistics=Y|N〕
〔set name_domain_file_use=Y|N〕
〔set all_node_extend_number=ドメイン変更時の最大ノード数〕
〔set all_node_ex_extend_number=ドメイン定義ファイルを使用したドメイン変更
                                時の最大ノード数〕
〔set prc_current_work_path=カレントワーキングディレクトリ作成用のディレク
                            トリパス〕
〔set rpc_max_message_size=RPC送受信電文の最大長〕
〔set uap_trace_file_put=Y|N〕
〔set dcstart_wakeup_retry_count=OpenTP1起動通知エラーリトライ回数〕
〔set dcstart_wakeup_retry_interval=OpenTP1起動通知エラーリトライ間隔〕
〔set nam_prf_trace_level=NAMイベントトレースの取得レベル〕
〔set fil_prf_trace_option=0|1〕
〔set fil_prf_trace_delay_time=FILイベントトレース取得条件となる
                               ファイルアクセス処理時間のしきい値〕
〔set jnl_prf_event_trace_level=JNL性能検証用トレースの取得レベル〕
〔set jnl_fileless_option=Y|N〕
〔set prc_coredump_filter=coreファイルに共有メモリを含めるかの判断値〕
〔set name_service_mode=manager|agent|normal〕
〔set name_manager_node=ノード名〔:ポート番号〕〕
〔set name_remove_down_node=Y|N〕
〔set name_node_add_policy=using_only|all〕
〔set dc_deter_restart_on_stop_fail=Y|N〕
〔set tp1_monitor_time=OpenTP1監視機能の無応答監視時間〕
〔set tp1_monitor_kill_signal=0|3|9〕
〔set ipc_notify_response_host=Y|N〕
〔set ipc_response_host=ホスト名〕
〔set watch_time=最大応答待ち時間〕

コマンド形式

{{dcbindht  -h　ホスト名
          〔-n　ネットワーク名〔,ネットワーク名〕…〕}}

putenv形式

〔putenv LANG LANG設定値〕

機能

OpenTP1システム共通の実行環境を定義します。

説明

set形式のオペランド

●rpc_trace=Y|N

　〜《N》

RPCトレースを取得するかどうかを指定します。

Y

RPCトレースを取得します。

N

RPCトレースを取得しません。

RPCトレースを取得した場合，処理速度が低下し，RPCがタイムアウトでエラーリターンすることがあります。その場合は，状況に応じて次の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.の最大応答待ち時間を使用してください。

リモートAPI機能を使用する場合，このオペランドにYを指定しても，rapクライアントのRPCトレースは取得されません。

このオペランドは，ユーザサービス定義またはrapリスナーサービス定義，およびユーザサービスデフォルト定義でも指定できます。

指定値の優先順位は次のとおりです（1.＞2.＞3.）。

ユーザサービス定義またはrapリスナーサービス定義

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

システム共通定義

●rpc_trace_name="RPCトレースを取得するファイル名"

　〜〈パス名〉《$DCDIR/spool/rpctr》

RPCトレースを取得するファイルのパス名を指定します。

パス名のうち，RPCトレースを取得するファイル名（デフォルトはrpctr）の最大長は，13文字です。

パス名に環境変数を指定する場合，パス名の先頭に環境変数を指定してください（指定例：$DCDIR/tmp/ファイル名）。

このオペランドは，ユーザサービス定義またはrapリスナーサービス定義，およびユーザサービスデフォルト定義でも指定できます。

指定値の優先順位は次のとおりです（1.＞2.＞3.）。

ユーザサービス定義またはrapリスナーサービス定義

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

システム共通定義

●rpc_trace_size=RPCトレースを取得するファイルのサイズ

　〜〈符号なし整数〉((1024〜2147483648))《4096》（単位：バイト）

RPCトレースを取得するファイルのサイズを指定します。

このオペランドは，ユーザサービス定義またはrapリスナーサービス定義，およびユーザサービスデフォルト定義でも指定できます。

指定値の優先順位は次のとおりです（1.＞2.＞3.）。

ユーザサービス定義またはrapリスナーサービス定義

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

システム共通定義

システム共通定義，ユーザサービスデフォルト定義，またはユーザサービス定義で，このオペランドに4096以下を指定していても，送受信された電文長がこの指定値を上回る場合，このオペランドで指定した値よりも大きなトレースファイルが作成されることがあります。

●name_port=ネームサービスのポート番号

　〜〈符号なし整数〉((5001〜65535))《10000》

ネームサービスのアドレスとなるポート番号を指定します。

マルチOpenTP1システムを作成する場合は，OpenTP1システムごとにネームサービスのポート番号を変えてください。

マルチOpenTP1システムではない場合でも，OpenTP1システム以外のプログラムが特定のポート番号を使用しているときは，その特定のポート番号と異なるポート番号をネームサービスに指定してください。

このオペランドで指定するポート番号は，ほかのプログラムと重複しないようにしてください。

また，OSには任意に割り当てる番号がありますが，この番号も使用しないでください。OSが任意に割り当てる番号は，OSの種別やバージョンによって異なります。詳細については，使用しているOSのマニュアルを参照してください。

●system_id=OpenTP1識別子

　〜〈1〜2文字の識別子〉

OpenTP1識別子を指定します。

このオペランドの指定値を変更した場合，チェックポイントダンプファイルの初期化が必要です。

●all_node="ノード名〔:ポート番号〕〔:high〕"〔,"ノード名〔:ポート番号〕〔:high〕"…〕

OpenTP1システムのすべてのノード名，およびそのネームサーバがウェルノウンポート番号として使用するポート番号を指定します。この指定を省略した場合は，自ノードだけで構成するOpenTP1システムが仮定されます。

サービス情報優先度指定機能を使用する場合，サービス情報を優先して選択するノード（優先選択ノード）の指定の後ろに，サービス情報優先度指定キーワードである":high"を指定します。ポート番号を省略する場合は，ノード名の後ろに指定してください。このキーワードは必ず指定値の最後に指定してください。キーワードの区切り文字':'を省略した場合や，間違った位置にキーワードを指定した場合は，定義不正となります。定義不正となった場合，KFCA00606-E（ホスト未定義）またはKFCA00607-E（ポート番号不正）のメッセージを出力し，OpenTP1の起動は失敗します。

システムをマルチOpenTP1構成にしていない場合は，このオペランドのノード名に，自ホストを示すホスト名（またはIPアドレス）や，ループバックアドレス（127で始まるIPアドレス）を指定しないでください。指定した場合，トランザクションの性能に悪影響を与えたり，OpenTP1がシステムダウンしたりするおそれがあります。

システムをマルチOpenTP1構成にしている場合は，このオペランドのノード名に，自ホストを示すホスト名（またはIPアドレス）を指定できます。ただし，ポート番号は重複しないようにして指定してください。なお，ループバックアドレスなどのIPアドレスが127で始まるホスト名（例：127.0.0.1）は指定しないでください。指定した場合，グローバル検索機能などに影響を与えます。

name_notifyオペランドにYを指定して起動通知機能を使用する場合は，このオペランドに指定したノードで起動するOpenTP1へ起動通知を行います。起動通知機能を使用すると，コネクション確立時期を管理でき，確実に送信できるようになります。

また，グローバルアーカイブジャーナルサービス機能を使用する場合は，このオペランドを次のように指定してください。

被アーカイブジャーナルノードには，アーカイブジャーナルノードのノード名を含むように指定する

アーカイブジャーナルノードには，すべての被アーカイブジャーナルノードのノード名を含むように指定する

ノード名　〜〈1〜255文字の識別子〉

OpenTP1システムのすべてのノード名を指定します。識別子に使用できる文字は英数字，ピリオド，およびハイフンです。ノード名とは，/etc/hostsなどで定まるホスト名のことです。ノード名に256文字以上指定した場合，指定した文字列の先頭から255文字までをノード名として扱います。

ポート番号　〜〈符号なし整数〉((5001〜65535))《10000》

ネームサーバがウェルノウンポート番号として使用するポート番号を指定します。

ポート番号を省略した場合は，name_portオペランドで指定したネームサービスのポート番号が仮定されます。

サービス情報優先度指定キーワード　〜:high

サービス情報優先度指定機能を使用する場合に，サービス情報を優先して選択するノード（優先選択ノード）に指定します。サービス情報優先度指定機能については，マニュアル「OpenTP1 解説」を参照してください。

ノード自動追加機能とサービス情報優先度指定機能を併用する場合，システム共通定義のname_service_modeオペランドにmanagerまたはagentを指定し，このオペランドに属性情報（優先度オプション）を指定します。

このオペランドに指定した属性情報は，ノードリストに登録されているノードに付与されます。

なお，このオペランドに指定したノードが，マネジャノードから受け取ったノードリストに登録されていない場合，指定したノードはRPCの実行範囲にはなりません。

指定できるノード数は，最大512です。

注意事項

このオペランドに指定したノードがall_node_exオペランドにも指定されていたり，このオペランド内に重複して指定されていたりする場合，OpenTP1が最初に解析したオペランドに対してKFCA00604-Wメッセージが出力されます。この場合，最初に解析したノードが有効となります。解析の優先順位は次のとおりです（優先順位が高い＞優先順位が低い）。

・all_nodeオペランド，all_node_exオペランド両方に同一ノードが指定されている場合

　all_nodeオペランド＞all_node_exオペランド

・all_node（all_node_ex）オペランドに同一ノードが複数指定されている場合

　先行指定ノード＞後続指定ノード

通信できないIPアドレス（以降，無効IPアドレスと記載します）や無効IPアドレスに変換されるホスト名をこのオペランドに指定し，かつname_notifyオペランドにYを指定した場合，OpenTP1起動時にこのオペランドに指定したノードに対して起動通知メッセージを送信します。無効IPアドレスに対して起動通知メッセージを送信すると，処理が完了するまでに，1ノードごとにコネクション確立監視時間（ipc_conn_intervalオペランドの指定値×2）が必要です。このため，OpenTP1の起動処理に時間が掛かることがあります。このオペランドに無効IPアドレスを指定する場合は，OpenTP1の起動処理時間が増加することを考慮した上で運用してください。

なお，この現象は，次の方法で回避できます。

・name_notifyオペランドにNを指定し，自ノードとこのオペランドに指定したノードで，互いにノード監視機能を使用する。

・このオペランドから無効IPアドレスの指定を削除する。

ノード監視機能の使用方法および注意事項については，マニュアル「OpenTP1 解説」の，OpenTP1のノード管理のノード監視機能の説明を参照してください。

●node_id=ノード識別子

　〜〈4文字の識別子〉

自ノードの識別子を指定します。

OpenTP1システム内で一意となる識別子を指定してください。

このオペランドの指定値を変更した場合，ジャーナルファイルの初期化が必要です。

●rpc_retry=Y|N

　〜《N》

OpenTP1のRPCでは，サービス要求時に相手サーバが起動していない場合があるため（系切り替え中，相手サーバ起動中など），サービス要求がエラーになるおそれがあります。このとき，RPCの処理をリトライするかどうかを指定します。

Y

RPCの処理をリトライします。

N

RPCの処理をリトライしません。

RPCの処理をリトライする種類を次に示します。

ユーザサーバでの要求先検索のリトライ

ネームサービスを使用するRPCは，ネームサービスから要求先の情報を取得します。要求先サーバが未起動状態で，ネームサービスから要求先の情報が取得できない場合は，rpc_retry_intervalオペランドに指定された間隔で，rpc_retry_countオペランドに指定された回数分，要求先検索をリトライします。

ユーザサーバでの要求送信のリトライ

RPCは要求先を決定したあと，相手サーバへサービス要求を送信します。次の場合，rpc_retry_intervalオペランドに指定された間隔を待たないで，rpc_retry_countオペランドに指定された回数分，要求送信をリトライします。

相手サーバのサービス開始の関数（dc_rpc_mainloopまたはCBLDCRSV('MAINLOOP')）が完了していないため，サービス提供できないなど，サービス要求の受け付けができない場合

サービス要求送信直前に相手サーバがダウンしたなど，通信障害が発生した場合

なお，サービス要求の受け付けができない，通信障害の発生などの問題がすぐに取り除かれないと，rpc_retry_countオペランドに指定された回数分リトライしても，サービス要求がエラーとなるおそれがあります。

システムサーバでの要求送信のリトライ

OpenTP1のシステムサーバは，システムサーバ間で通信を行います。通信障害が発生した場合は，rpc_retry_intervalオペランドに指定された間隔で，rpc_retry_countオペランドに指定された回数分，要求送信をリトライします。

RPCの処理をリトライする種類と，rpc_retry_countオペランド，およびrpc_retry_intervalオペランドの指定の関係を次に示します。

リトライの種類

rpc_retry_countオペランドの指定

rpc_retry_intervalオペランドの指定

ユーザサーバでの要求先検索のリトライ

○

○

ユーザサーバでの要求送信のリトライ

○

−

システムサーバでの要求送信のリトライ

○

○

（凡例）

○：オペランドの指定は有効となります。

−：オペランドの指定は無効となります。

●rpc_retry_count=RPC処理のリトライ回数最大値

　〜〈符号なし整数〉((1〜3600))《18》

要求先検索，および要求送信のリトライを行う場合のリトライ回数の最大値を指定します。

要求先検索のリトライ：ネームサービスを使用するRPCで，ネームサービスから要求先の情報が取得できない場合

要求送信のリトライ：サービス要求送信時に，サービス要求が受け付けられない場合，または通信障害が発生した場合

この指定は，rpc_retryオペランドにYを指定した場合に有効です。

●rpc_retry_interval=RPC処理のリトライ間隔

　〜〈符号なし整数〉((1〜3600))《10》（単位：秒）

要求先検索，および要求送信のリトライを行う場合のリトライ間隔を指定します。

この指定は，rpc_retryオペランドにYを指定した場合に有効です。

●multi_node_option=Y|N

　〜《N》

該当するOpenTP1ノードでマルチノード機能を使用するかどうかを指定します。

Y

マルチノード機能を使用します。

N

マルチノード機能を使用しません。

TP1/Multiが組み込まれていないのにYを指定した場合は，警告メッセージを出力し，OpenTP1を停止します。

●prc_port=マルチノード連携制御機能で使用するポート番号

　〜〈符号なし整数〉((5001〜49999))

マルチノード連携制御機能で使用するポート番号を指定します。

multi_node_optionオペランドにNを指定した場合は，このオペランドを指定する必要はありません。

マルチOpenTP1システムを作成する場合は，OpenTP1システムごとにポート番号を変えてください。

マルチOpenTP1システムではない場合でも，OpenTP1システム以外のプログラムが特定のポート番号を使用しているときは，その特定のポート番号と異なるポート番号を指定してください。

name_portオペランドで指定するネームサービスのポート番号と異なるポート番号を指定してください。

また，マルチノード物理定義で指定するポート番号には，ここで指定した値を指定してください。

このオペランドの指定値を変更した場合は，OpenTP1を再度セットアップしてください。

このオペランドで指定するポート番号は，ほかのプログラムと重複しないようにしてください。

また，OSには任意に割り当てる番号がありますが，この番号も使用しないでください。OSが任意に割り当てる番号は，OSの種別やバージョンによって異なります。詳細については，使用しているOSのマニュアルを参照してください。

●rpc_delay_statistics=Y|N

　〜《N》

通信遅延時間統計情報を取得するかどうかを指定します。

通信遅延時間とは，dc_rpc_call関数のレスポンスタイムのうち，実際の通信（要求送信および応答送信）に掛かった時間のことです。

通信遅延時間統計情報は同期応答型RPCの場合だけ取得します。

Y

通信遅延時間統計情報を取得します。

N

通信遅延時間統計情報を取得しません。

●my_host="ホスト名"|MYHOST

　〜〈1〜255文字の識別子〉

OpenTP1が使用するネットワークアダプタをホスト名として指定します。識別子に使用できる文字は英数字，ピリオド，およびハイフンです（ただし，IPアドレス形式は除く）。ホスト名は，/etc/hostsファイルまたはDNSなどで，IPアドレスとのマッピングができなければなりません。なお，ホスト名にlocalhostまたはIPアドレスが127で始まるホスト（例：127.0.0.1）は指定しないでください。

ホスト名は，1個だけ指定できます。

このオペランドを省略，またはMYHOSTを指定した場合は，hostnameコマンドが返す名称が指定されたと解釈されます。

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

OpenTP1は，次の判断をするためにこのオペランドを使用します。

OpenTP1がRPCを行う際，通信相手が同一マシン上に存在するのか，または別マシン上に存在するのかを判断するため。

複数のIPアドレスを持つマシンの場合，使用するホスト名をmy_hostとdcbindhtに指定することで自OpenTP1が使用するIPアドレスを判断し，通信相手に自OpenTP1のIPアドレスを通知するため。

64文字以上のホスト名を指定した場合，TP1/Client/WまたはTP1/Client/Pのブロードキャストによるユーザ認証の使用に注意が必要です。詳細はマニュアル「クライアント使用の手引き TP1/Client/W，TP1/Client/P編」を参照してください。

●jp1_use=Y|N

　〜《N》

JP1イベントサービス機能にイベント登録をするかどうかを指定します。

Y

イベント登録をします。

N

イベント登録をしません。

JP1イベントサービス機能へ登録するイベントについては，マニュアル「OpenTP1 運用と操作」を参照してください。

●rpc_message_level=RPCのトラブルシュートメッセージの表示レベル

　〜〈符号なし整数〉((0〜2))《2》

RPCトラブルシュートメッセージの表示レベルを指定します。

0

トラブルシュートメッセージを表示しません。

1

表示レベル1以下のトラブルシュートメッセージを表示します。

2

表示レベル2以下のトラブルシュートメッセージを表示します。

RPCトラブルシュートメッセージ（KFCA00325-E〜KFCA00332-W）と表示レベルの関係を，次に示します。

メッセージ

表示レベル

KFCA00325-E

0

KFCA00326-W

2

KFCA00327-W

1

KFCA00328-W

2

KFCA00329-E

0

KFCA00330-E

0

KFCA00331-W

−

KFCA00332-W

1

（凡例）

−：表示されません。

RPCトラブルシュートメッセージは，標準エラー出力に出力されます。

●rpc_multi_tp1_in_same_host=Y|N

　〜《N》

同一ホスト内に複数のOpenTP1を稼働させ，これらを同一グローバルドメイン※として運用するかどうかを指定します。

注※

ここでのグローバルドメインとは，次のノード名の集合を指します。

システム共通定義のname_domain_file_useオペランドにNを指定している場合

システム共通定義のall_nodeオペランド，およびall_node_exオペランドで指定したノード名の集合です。

システム共通定義のname_domain_file_useオペランドにYを指定している場合

ドメイン定義ファイルに指定したノード名の集合です。なお，ドメイン定義ファイルは次の場所に格納します。

all_nodeのドメイン定義ファイル

$DCCONFPATH/dcnamndディレクトリ下

all_node_exのドメイン定義ファイル

$DCCONFPATH/dcnamndexディレクトリ下

Y

同一ホスト内の複数のOpenTP1を，同一グローバルドメインとして運用します。

N

同一ホスト内の複数のOpenTP1を，同一グローバルドメインとして運用しません。

このオペランドの指定は，OpenTP1を停止してから変更してください。変更後は，dcsetupコマンドを入力してからOpenTP1を起動してください。

●max_socket_descriptors=ソケット用ファイル記述子の最大数

　〜〈符号なし整数〉((32〜2032))《64》

OpenTP1制御下のプロセス※で，ソケット用に使用するファイル記述子の最大値を指定します。

指定値の範囲は，適用OSがAIX，HP-UXまたはWindowsの場合は32〜2032，適用OSがSolarisまたはLinuxの場合は32〜1008です。

OpenTP1制御下のプロセス※では，システムサービスやユーザサーバとの間で，ソケットを使用したTCP/IP通信でプロセス間の情報交換をしています。そのため，同時に稼働するUAPプロセスの数によって，ソケット用のファイル記述子の最大数を変更する必要があります。

注※

MCFサービス（MCFマネジャサービス，MCF通信サービス，アプリケーション起動サービス，マッピングサービス，およびオンラインコマンドサービス）は対象外です。MCFサービスの場合は，「システムサービス共通情報定義」を参照してください。

ソケット用ファイル記述子の最大数の計算式を，次に示します。

↑（自ノード内UAPプロセス数※1　＋　システムサービスプロセス数※2）／0.8↑

↑↑：小数点以下を切り上げます。

注※1

自ノード内UAPプロセス数は，次に示す値の合計です。

自OpenTP1内のUAPプロセス数

CUPから同時に起動するトランザクション数（クライアントサービス定義のparallel_countオペランドの指定値）

注※2

システムサービスプロセス数とは，自OpenTP1内のシステムサービスプロセスの数です。自OpenTP1内のシステムサービスプロセスは，rpcstatコマンドで表示されるサーバ名をカウントすることで求められます。rpcstatコマンドで表示されるサーバ名のうち，マニュアル「OpenTP1　解説」のOpenTP1のプロセス構造に記載されているシステムサービスプロセスをカウントしてください。

このオペランドの指定値が小さいと，OpenTP1制御下の他プロセスとのコネクションが設定できなくなるため，プロセスがKFCA00307-Eメッセージを出力して異常終了します。

このオペランドは，ユーザサービス定義とユーザサービスデフォルト定義の中でも指定できます。

指定値の優先順位は次のとおりです。

システムサーバの場合（1.＞2.）

各システムサービス定義

システム共通定義

ユーザサーバの場合（1.＞2.＞3.）

ユーザサービス定義

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

システム共通定義

max_socket_descriptorsオペランドの算出式はシステムサーバごとに異なります。そのため，システムサーバごとのmax_socket_descriptorsオペランドの値は，各システムサービス定義の計算式で算出した値を設定してください。

●rpc_datacomp=Y|N

　〜《N》

OpenTP1システムで，クライアント側からのサービス要求時，およびサーバ側からのサービス要求応答時に，ユーザデータを圧縮して送信するかどうかを指定します。

このオペランドの指定は，dc_rpc_call関数でサービスを要求するクライアント側で有効になります。したがって，クライアント側のノードでrpc_datacomp=Yを指定していれば，サービスを受け付けるサーバのあるノードでrpc_datacomp=Yが指定されていなくても，サービス要求メッセージおよび応答メッセージのユーザデータを圧縮して送信します。ただし，サーバ側のシステムがユーザデータの圧縮機能をサポートしている場合に限ります。逆に，クライアント側でrpc_datacomp=Yを指定していなければ，サービスを受け付けるサーバのあるノードでrpc_datacomp=Yが指定されていても，サービス要求メッセージおよび応答メッセージのユーザデータを圧縮しません。

また，クライアント側のノードでrpc_datacomp=Yを指定しても，ユーザデータの圧縮効果がない場合，ユーザデータを圧縮しないでサービス要求を送信します。しかし，それに対する応答メッセージに圧縮効果がある場合は，応答のユーザデータは圧縮して返送します。

なお，rpc_datacomp=Yを指定した場合でも，サービス要求を受信するSPPのメッセージ格納バッファプール長（message_store_buflenオペランド）は，圧縮前のユーザデータ長でサイズを計算してください。

Y

サービス要求時とサービス要求応答時にユーザデータを圧縮して送信します。

N

サービス要求時とサービス要求応答時にユーザデータを圧縮しないで送信します。

●domain_masters_addr="ドメイン名=ホスト名1〔：ポート番号1〕〔，ホスト名2〔：ポート番号2〕〔，ホスト名3〔：ポート番号3〕〕〕"〔，"ドメイン名=ホスト名1〔：ポート番号1〕〔，ホスト名2〔：ポート番号2〕〔，ホスト名3〔：ポート番号3〕〕〕"…〕

ドメイン指定のRPCを発行した際の，通信先のドメイン名とドメイン代表スケジュールサービスのホスト名（およびポート番号）を指定します。この定義を指定すると，ドメイン指定のRPCを発行した際にドメインネームサービスを検索しないで通信ができるため，RPCの応答時間が短縮できます。

ポート番号の指定を省略した場合は，domain_masters_portオペランドの値を仮定します。

ドメイン名　〜〈1文字以上の識別子〉

通信先のドメイン名を指定します。

ホスト名1，ホスト名2，ホスト名3　〜〈1〜255文字の識別子〉

スケジュールサービスのホスト名を指定します。

ホスト名1には第1優先のホスト名を，ホスト名2以降には第2優先のホスト名を指定します。

ホスト名に256文字以上指定した場合，指定した文字列の先頭から255文字までをホスト名として扱います。

ポート番号1，ポート番号2，ポート番号3　〜〈符号なし整数〉((5001〜65535))

スケジュールサービスのポート番号を指定します。

ポート番号1には第1優先のポート番号を，ポート番号2以降には第2優先のポート番号を指定します。

●domain_masters_port=ドメイン代表スケジュールサービスのポート番号

　〜〈符号なし整数〉((5001〜65535))

ドメイン指定のRPCを発行した際に，ドメインネームサービスを検索しないで通信するために必要な，通信先のドメイン代表スケジュールサービスのポート番号を指定します。

●domain_use_dns=Y|N

　〜《Y》

ドメイン指定のRPCを発行した際，domain_masters_addrオペランドに指定していないドメインへの検索をする場合に，ドメインネームサービスに問い合わせるかどうかを指定します。

Y

ドメインネームサービスに問い合わせます。

N

ドメインネームサービスに問い合わせません。

●client_uid_check=Y|N

　〜《HP-UXまたはWindowsの場合：Y　AIX，LinuxまたはSolarisの場合：N》

TP1/Client/WまたはTP1/Client/Pに対するユーザ認証機能を使用するかどうかを指定します。

Y

TP1/Client/WまたはTP1/Client/Pに対するユーザ認証機能を使用します。なお，適用OSがHP-UXで「高信頼性システム」，または「HP-UX Shadow Passwords」を適用する場合は，Sを指定してください。適用OSがHP-UX以外の場合にSを指定すると定義不正になります。

N

TP1/Client/WまたはTP1/Client/Pに対するユーザ認証機能を使用しません。

Nを指定した場合，TP1/Client/WまたはTP1/Client/Pからの認証要求は，どのようなログイン名を指定しても認証されます。このオペランドにY（HP-UXの場合はS）を指定した場合に，適用OSがAIX，Linux，Solaris，またはHP-UXのときは，namdプロセスのユーザIDがrootになります。

●rpc_port_base=最小ポート番号

　〜〈符号なし整数〉((5001〜65535))

OpenTP1制御下のウェルノウンポート化されていないプロセスが用いる受信用ポート番号を，特定の範囲内の値に限定したい場合に，その最小値を指定します。

使用するポート番号の数は，プロセスサービス定義のprc_process_countオペランドで指定した値（最大同時起動サーバプロセス数）に128を加えた値になります。したがってこのオペランドを指定すると，受信用のポート番号は，指定された範囲内の値になります。このオペランドは，OpenTP1のシステムサーバ，SUP，SPP，およびMHPで有効です。

このオペランドは，プロセスサービス定義のprc_process_countオペランドの指定値に128を加えた値と合わせて，65535を超えないように指定してください。65535を超えた場合は，このオペランドの指定値から65535までの範囲のポート番号と，OSが任意に割り当てるポート番号が使用されます。

次に示す場合，このオペランドの指定は無視され，OpenTP1制御下のウェルノウンポート化されていないプロセスのポート番号は，OSが任意に割り当てた番号になります。

このオペランドを省略した場合

プロセス起動時に，最小ポート番号から，最小ポート番号と最大同時起動サーバプロセス数に128を加えた値の合計値までの範囲から任意に選択したポート番号が使用中の場合

最小ポート番号から，最小ポート番号と最大同時起動サーバプロセス数に128を加えた値の合計値まで，またはこのオペランドの省略によってOSが任意に割り当てるポート番号の範囲に，OpenTP1のウェルノウンポート，および他プログラムのウェルノウンポートを定義しないでください。

●prf_trace=Y|N

　〜《Y》

性能検証用トレース情報を取得するかどうかを指定します。

Y

性能検証用トレース情報を取得します。

N

性能検証用トレース情報を取得しません。

●trn_prf_trace_level=トレースの取得レベル

　〜((00000001〜00000003))《00000003》

性能検証用トレース情報の取得で，トランザクション関係のトレースの取得レベルを指定します。トランザクション関係のトレースのイベントIDは0x4000から0x4150です。イベントIDの詳細については，マニュアル「OpenTP1 運用と操作」を参照してください。

00000001

性能検証用トレース情報（イベントID：0x4000〜0x4017）を取得します。

00000002

トランザクションの開始時および終了時のイベントの性能検証用トレース情報（イベントID：0x4100，0x4150）を取得します。

00000003

00000001および00000002両方の性能検証用トレース情報を取得します。

●core_suppress_watch_time=実時間監視タイムアウトプロセスのコアダンプ出力を抑止する時間間隔

　〜〈符号なし整数〉((0〜3600))《0》（単位：秒）

実時間監視でタイムアウトを検知して強制停止させるプロセスについて，コアダンプの出力を抑止する時間間隔を秒単位で指定します。

以前に実時間監視タイムアウトを検知しコアダンプを出力してプロセスを停止させてから，このオペランドで指定した時間を経過するまでは，実時間監視タイムアウトでプロセスを強制停止させる際にコアダンプを出力しません。

このオペランドに0を指定した場合は，コアダンプ出力を抑止しないで，実時間監視タイムアウトで強制停止させるプロセスは，すべてコアダンプを出力します。

●rpc_netmask=TCP/IPのネットワーク定義ファイルに指定したサブネットマスク値

OpenTP1が稼働する環境のネットワークでサブネットを使用している場合， TCP/IPのネットワーク定義ファイルに指定したサブネットマスク値を，「.」記法の文字列のインターネットアドレスで指定します（例：「rpc_netmask=255.255.255.0」）。なお，インターネットアドレスの「.」と数字の間にスペースを挿入すると，スペース以降の値は解釈されないので注意してください。

TCP/IPのネットワーク定義ファイルにサブネットマスクを指定していない場合は，このオペランドを指定する必要はありません。

このオペランドは，dcbindht定義コマンドを指定している場合に有効です。サブネットを使用したネットワーク上で稼働させ，かつdcbindht定義コマンドを指定している場合は，必ず指定しなければなりません。サブネットを使用したネットワーク上で稼働させている場合に，このオペランドを指定しなかったときは，dcbindht定義コマンドに指定したネットワーク名とOpenTP1の認識するネットワークアドレスが一致しないため，dcbindht定義コマンドの指定値が有効になりません。

dcbindht定義コマンドを使用したシステムを，サブネットを使用したネットワーク環境で運用する場合，OpenTP1のグローバルドメイン下のネットワークはすべて同一サブネットマスクを使用していることが前提となります。OpenTP1のグローバルドメイン下で，異なるサブネットマスクを使用したネットワークが存在する場合，dcbindht定義コマンドの機能が正常に動作しないことがあります。

●ipc_sockctl_highwater=ソケットの一時クローズ処理開始数パーセンテージ〔,ソケットの一時クローズ処理非対象数パーセンテージ〕

　〜〈符号なし整数〉((0〜100))《100，0》

max_socket_descriptorsオペランドの指定値に対して，ソケットの一時クローズ処理開始数パーセンテージを指定します。

OpenTP1は，プロセス内のソケット用に使用しているファイル記述子の数が，次の値を超えた時点で，一時クローズ処理を開始します。

max_socket_descriptorsオペランドの指定値
×（ソケットの一時クローズ開始数パーセンテージ／100）

ソケットの一時クローズ処理開始数パーセンテージに0を指定した場合，コネクションを確立するたびに一時クローズ処理が実行されます。一時クローズ処理については，マニュアル「OpenTP1 解説」を参照してください。

また，一時クローズ処理の対象外とするコネクション数のパーセンテージも指定できます。一時クローズ処理の対象外とするコネクション数は，次の値です。

max_socket_descriptorsオペランドの指定値
×（ソケットの一時クローズ非対象数パーセンテージ／100）

ソケットの一時クローズ非対象数パーセンテージには，ソケットの一時クローズ処理開始数パーセンテージ以下の値を指定してください。ソケットの一時クローズ処理開始数パーセンテージより大きい値を指定した場合は，ソケットの一時クローズ処理開始数パーセンテージと同じ値が指定されたものとして動作します。

OpenTP1は，プロセス内で確立したコネクションを，確立した順に管理しています。ソケットの一時クローズ処理非対象数パーセンテージを指定した場合，最も古く確立されたコネクションから順に，一時クローズ処理要求が送信されます。

max_socket_descriptorsオペランドの指定値が大きくなく，かつソケットの一時クローズ処理開始数パーセンテージに小さい値が指定されていると，一時クローズ要求が多発し，性能に影響を与えたり，通信障害になったりすることがあります。

このオペランドは，rapリスナーサービス定義，ユーザサービスデフォルト定義，またはユーザサービス定義でも指定できます。

指定値の優先順位は次のとおりです（1.＞2.＞3.）。

ユーザサービス定義，またはrapリスナーサービス定義

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

システム共通定義

●ipc_sockctl_watchtime=ソケット再利用可能監視時間

　〜〈符号なし整数〉((0〜65535))《180》（単位：秒）

プロセス内のソケット用に使用しているファイル記述子の数が，max_socket_descriptorsオペランドの指定値になった時点から，一時クローズ処理によってソケットが再利用できるようになるまでの監視時間（秒）を指定します。

UAPが異常終了した場合に閉塞するかどうかはholdオペランド，term_watch_timeオペランドの指定によります。詳細については，ユーザサービス定義のholdオペランドおよびterm_watch_timeオペランドの説明を参照してください。

一時クローズ処理は，コネクションを確立したプロセス間の合意によってコネクションを切断するため，一時クローズ処理の要求を送信したプロセスはその応答を受けるまではコネクションを切断できません。応答を受信したあと，コネクションは切断され，ソケットが再利用できるようになります。

ipc_sockctl_watchtimeオペランドの指定値を経過しても，どのプロセスからも一時クローズ処理要求に対する応答が返らない場合，プロセスは強制停止されます。ipc_sockctl_watchtimeオペランドに0を指定した場合，無限に待ちます。

このオペランドは，rapリスナーサービス定義，ユーザサービスデフォルト定義，またはユーザサービス定義でも指定できます。

指定値の優先順位は次のとおりです（1.＞2.＞3.）。

ユーザサービス定義，またはrapリスナーサービス定義

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

システム共通定義

●ipc_conn_interval=コネクション確立監視時間

　〜〈符号なし整数〉((8〜65535))《8》（単位：秒）

データ送信時のコネクション確立監視時間を秒単位で指定します。

ノンブロッキングモードで呼び出したconnect()システムコールに対する応答を受信するまでの監視時間を指定します。

このオペランドは，ユーザサービス定義，ユーザサービスデフォルト定義でも指定できます。

指定値の優先順位は次のとおりです（1.＞2.＞3.）。

ユーザサービス定義

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

システム共通定義

●ipc_send_interval=データ送信監視間隔

　〜〈符号なし整数〉((5〜32767))《5》（単位：秒）

データ送信時のデータ送信監視間隔を指定します。

このオペランドは，ユーザサービス定義，ユーザサービスデフォルト定義でも指定できます。

指定値の優先順位は次のとおりです（1.＞2.＞3.）。

ユーザサービス定義

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

システム共通定義

●ipc_send_count=データ送信監視回数

　〜〈符号なし整数〉((1〜32767))《5》

データ送信時の送信完了監視回数を指定します。

OpenTP1のデータ送信監視時間は，次に示す秒数で監視します。

ipc_send_intervalオペランドの指定値×ipc_send_countオペランドの指定値

このオペランドは，ユーザサービス定義，ユーザサービスデフォルト定義でも指定できます。

指定値の優先順位は次のとおりです（1.＞2.＞3.）。

ユーザサービス定義

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

システム共通定義

●ipc_header_recv_time=通信制御データの受信監視時間

　〜〈符号なし整数〉((5〜32767))《10》（単位：秒）

OpenTP1が，データの受信が始まったことをTCP/IPから通知されてから，通信制御データを受信するまでの監視時間を指定します。

このオペランドは，ユーザサービス定義，ユーザサービスデフォルト定義でも指定できます。

指定値の優先順位は次のとおりです（1.＞2.＞3.）。

ユーザサービス定義

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

システム共通定義

●rpc_close_after_send=Y|N

　〜《N》

ノード間通信で確立したコネクションを保持したままにするか，ノード間通信が終了するたびにコネクションを切断するかどうかを指定します。このオペランドは，データの送信元に設定するオペランドです。

Y

ノード間通信が終了するたびにコネクションを切断する。

N

ノード間通信で確立したコネクションを保持する。

このオペランドにYを指定すると，次の状態を即時に検知できます。

ノード間で通信を行うOpenTP1で発生したハード障害によってコネクションが切断された

ノード間に設置されている無通信監視をする通信機器によってコネクションが切断された

ただし，ノード間通信が発生するたびにコネクションを確立し，通信が終了するとコネクションを切断するため，OSのコネクション確立と解放を繰り返す分だけオーバーヘッドが増加します。

このオペランドは，ユーザサービス定義とユーザサービスデフォルト定義にも指定できます。

指定値の優先順位は次のとおりです。

システムサーバの場合（1.＞2.）

各システムサービス定義

システム共通定義

ユーザサーバの場合（1.＞2.＞3.）

ユーザサービス定義

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

システム共通定義

注意事項

OpenTP1で使用する通信で，毎回コネクション確立・切断を実施するため，性能が低下するおそれがあります。性能に関しては，十分に検討したあと，この機能を使用してください。

OpenTP1で使用する通信で，毎回コネクション確立・切断を実施するため，OSのポートを大量に消費するおそれがあります。ポートに関してのOS資源見積もり，設定を十分に検討したあと，このオペランドを使用してください。ポートに関するOSの設定の詳細は，OSのマニュアルを参照してください。

次に示す機能では，ノード間のTCP/IP通信であっても，このオペランドは適用されません。

・OpenTP1クライアント製品とTP1/Server Base間の通信

・リモートAPI機能を使用し，rapクライアントからTP1/Server Baseのrapリスナー，rapサーバへの通信

・XAリソースサービスを使用したトランザクション連携機能

・TP1/Message Queueのチャネルを使用した，他のMQシステム（メッセージキューイング機能のキューマネジャがあるシステム）とTP1/Message Queueとのチャネル通信

・TP1/Message Queueのクライアント製品（TP1/Message Queue - Access）であるMQCクライアント機能とTP1/Message QueueのMQCサーバ機能との通信

・メッセージ制御機能（TP1/Message Control）を使用した，相手システムとの通信

●name_notify=Y|N

　〜《N》

自ノードのOpenTP1起動時に，all_nodeおよびall_node_exオペランドで指定したノードで起動するOpenTP1に対し起動通知を行うかどうか，または自ノードのOpenTP1が他ノードのOpenTP1からの起動通知を受け付けるかどうかを指定します。

Y

起動通知機能を使用します。

N

起動通知機能を使用しません。

なお，このオペランドに指定した値に関係なく，namunavlコマンドは動作します。

ノード自動追加機能を使用する場合の，このオペランドの動作を次に示します。

オペランドにYを指定した場合

ノードリストに登録されているノード，およびall_node_exオペランドで指定したノードのOpenTP1に対して起動通知を行います。また，起動通知を受け付けます。

マネジャノードでは，起動通知の送信元ノードがノードリストに登録されていないときは，送信元ノードをノードリストに追加します。

オペランドにNを指定した場合

他ノードのOpenTP1に対して起動通知をしません。また，他ノードのOpenTP1からの起動通知を受け付けません。ただし，マネジャノードでは，起動通知の送信元ノードがノードリストに登録されていないときは，送信元ノードをノードリストに追加します。

なお，マネジャノードでは，新たに起動したエージェントノードからのノードリスト要求を起動通知と解釈します。

注

この機能は，ノードごとにユニークなIPアドレスが割り振られていることを前提としているため，同一IPアドレスで複数のOpenTP1が起動する（1LANボードだけ使用時など）システムでは，起動通知機能を使用しないでください。

起動通知機能を使用する場合，自ノードのall_nodeオペランドまたはall_node_exオペランドで指定した起動通知の通知先ノードでは，all_nodeオペランドまたはall_node_exオペランドに，自ノードを指定してください。

●all_node_ex="ノード名〔:ポート番号〕"〔,"ノード名〔:ポート番号〕"…〕

あて先指定のRPCによって，all_nodeオペランドに指定したノード名以外に通信する可能性のあるOpenTP1システムのノード名およびそのネームサーバがウェルノウンポート番号として使用するポート番号を指定します。自ノードのOpenTP1起動時に，all_node_exオペランドおよびall_nodeオペランドで指定したノードで起動するOpenTP1へ起動通知を行います。起動通知機能を使用すると，コネクション確立時期を管理でき，確実に送信できるようになります。

ノード名　〜〈1〜255文字の識別子〉

OpenTP1システムのノード名を指定します。識別子に使用できる文字は英数字，ピリオド，およびハイフンです。ノード名とは，/etc/hostsなどで定まるホスト名のことです。ノード名に256文字以上指定した場合，指定した文字列の先頭から255文字までをノード名として扱います。なお，IPアドレスを指定する場合，ループバックアドレスなどIPアドレスが127で始まるホスト名（例：127.0.0.1）は指定しないでください。このオペランドには，自ホストを示すホスト名（またはIPアドレス）を指定しないでください。

ポート番号　〜〈符号なし整数〉((5001〜65535))《10000》

ネームサーバがウェルノウンポート番号として使用するポート番号を指定します。

ポート番号を省略した場合は，name_portオペランドで指定したネームサービスのポート番号が仮定されます。

注意事項

このオペランドに指定したノードがall_nodeオペランドにも指定されていたり，このオペランド内に重複して指定されていたりする場合，OpenTP1が最初に解析したオペランドに対してKFCA00604-Wメッセージが出力されます。この場合，最初に解析したノードが有効となります。解析の優先順位は次のとおりです（優先順位が高い＞優先順位が低い）。

　・all_nodeオペランド，all_node_exオペランド両方に同一ノードが指定されている場合

　　all_nodeオペランド＞all_node_exオペランド

　・all_node（all_node_ex）オペランドに同一ノードが複数指定されている場合

　　先行指定ノード＞後続指定ノード

ノード自動追加機能を使用する場合，次の点に注意してください。

システム共通定義のname_service_modeオペランドにmanagerまたはagentを指定したとき，このオペランドに指定したノードはノードリストに登録されません。ノードリストに登録するノードはこのオペランドに指定しないでください。

マネジャノードでは，このオペランドに指定したノードの情報をエージェントノードへ配布しません。ノードリストに登録するノードは，このオペランドに指定しないでください。

●rpc_server_busy_count=KFCA00356-Wメッセージを出力するバンドル回数

　〜〈符号なし整数〉((0〜32767))《20》

スケジュールサービスは，受け付けたサービス要求をスケジュールキューに登録します。スケジュールキュー登録処理は，スレッドを使用し，複数のサービス要求を並列にスケジュールキューに登録します。しかし，スケジュールキュー登録に使用するスレッドが不足したためスケジュールサービスがサービス要求を受け付けられない場合，KFCA00356-Wメッセージを出力します。

このオペランドには，KFCA00356-Wメッセージを出力するバンドル回数を指定します。KFCA00356-Wメッセージを出力する契機は，初めてスケジュールサービスがサービス要求を受け付けられなかった場合，または，KFCA00356-Wメッセージ出力後，スケジュールサービスがサービス要求を受け付けられなかった回数がこのオペランドの値以上になった場合にKFCA00356-Wメッセージを出力します。

このオペランドに0を指定した場合は，スケジュールサービスがサービス要求を受け付けられなかった回数に関係なく，KFCA00356-Wメッセージを出力しません。また，1を指定した場合は，スケジュールサービスがサービス要求を受け付けられないたびにKFCA00356-Wメッセージを出力します。

●rpc_send_retry_count=TCP/IPコネクションの接続時にエラーが発生した場合のリトライ回数

　〜〈符号なし整数〉((0〜65535))《0》

サーバの応答送信時のTCP/IPコネクションの接続で，ECONNREFUSED（239），EHOSTUNREACH（242），ENETUNREACH（229）のどれかのエラーが発生した場合，このオペランドでリトライ回数を指定することによって，エラーを回避できることがあります。

0を指定した場合は，TCP/IPコネクションの接続時に上記のエラーが発生しても接続をリトライしません。

このオペランドに1〜65535を指定し，TCP/IPコネクションの接続時に上記のエラーが発生した場合，rpc_send_retry_intervalオペランドに指定した時間を待ったあと，接続をリトライします。

このオペランドは，ユーザサービス定義，ユーザサービスデフォルト定義でも指定できます。

指定値の優先順位は次のとおりです（1.＞2.＞3.）。

ユーザサービス定義

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

システム共通定義

●rpc_send_retry_interval=TCP/IPコネクションの接続時にエラーが発生した場合のリトライ間隔

　〜〈符号なし整数〉((0〜300000))《0》（単位：ミリ秒）

サーバの応答送信時のTCP/IPコネクションの接続で，ECONNREFUSED，EHOSTUNREACH，ENETUNREACHのどれかのエラーが発生した場合，このオペランドでリトライ間隔をミリ秒単位で指定することによって，エラーを回避できることがあります。

0を指定した場合は，間隔を空けずにTCP/IPコネクションの接続をリトライします。1〜19は指定できません。1〜19を指定した場合は，20を仮定します。

このオペランドは，rpc_send_retry_countオペランドに1〜65535を指定した場合に有効になります。

このオペランドは，ユーザサービス定義，ユーザサービスデフォルト定義，各システムサービス定義でも指定できます。

指定値の優先順位は次のとおりです（1.＞2.＞3.＞4.）。

ユーザサービス定義

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

各システムサービス定義

システム共通定義

●thdlock_sleep_time=スレッド間で排他が競合した場合のスレッドの待ち時間

　〜〈符号なし整数〉((1〜32767))《15》（単位：ミリ秒）

OpenTP1制御下のプロセスが内部で用いる排他制御関数が，スレッド間で排他の競合が発生したため排他を獲得できなかった場合のスレッドの待ち時間を，ミリ秒単位で指定します。

このオペランドにデフォルト値（15）より小さい値を指定すると，selectシステムコールの発行頻度が高くなり，CPU利用率が増加します。

注

スレッドで排他の競合が発生した結果，排他を獲得できなかったスレッドが待つ場合，このオペランドの指定値に従い，OSのselectシステムコールを発行します。ただし，OSやマシン環境によってselectシステムコールの待ち時間精度は異なるため，実際の待ち時間がこのオペランドに指定された値より長くなるおそれがあります。

各OSでのこのオペランドの指定値による待ち時間の測定結果の例を次の表に示します。

なお，マシン環境（OSのバージョンやパッチ適用の有無など）によっては，待ち時間が次に示す表と異なる場合があります。selectシステムコールの待ち時間精度については，OSの仕様を確認してください。

OS名

thdlock_sleep_timeオペランドの指定値

待ち時間

AIX

指定値

指定値

Linux

指定値

指定値＋約1ミリ秒

HP-UX

1〜9

約10ミリ秒

10〜19

約20ミリ秒

Solaris

1〜9

約10ミリ秒

10〜19

約20ミリ秒

Windows

1〜15

約16ミリ秒

16〜31

約31ミリ秒

このオペランドは，各システムサービス定義およびシステムサービス共通情報定義でも指定できます。

指定値の優先順位は次のとおりです（1.＞2.）。

各システムサービス定義およびシステムサービス共通情報定義

システム共通定義

●ipc_listen_sockbufset=Y|N

　〜《Y》

OpenTP1がプロセス間通信で使用するlistenソケットの生成時に，ipc_sendbuf_sizeオペランド，およびipc_recvbuf_sizeオペランドに指定したTCP/IPの送受信バッファサイズをlistenソケットに設定するかどうかを指定します。

Y

listenソケットに，TCP/IPの送受信バッファサイズを設定します。

N

listenソケットに，TCP/IPの送受信バッファサイズを設定しません。

ipc_sendbuf_sizeオペランド，およびipc_recvbuf_sizeオペランドに指定したTCP/IPの送受信バッファサイズは，OpenTP1プロセスがコネクション確立要求を受信し，コネクションを確立したあとに設定します。コネクションを確立したあとにTCP/IPの送受信バッファサイズを変更するため，コネクションの接続元と接続先の間でTCP/IPのバッファサイズの値が異なり，通信の遅延が発生することがあります。

同一ノード内にTP1/Server BaseとTP1/Clientがあり，TP1/Clientから同一ノード内のTP1/Server Baseに対して通信を行う場合は，このオペランドにYを指定することをお勧めします。

このオペランドは，ユーザサービス定義，ユーザサービスデフォルト定義でも指定できます。

指定値の優先順位は次のとおりです（1.＞2.＞3.）。

ユーザサービス定義

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

システム共通定義

●ipc_recvbuf_size=TCP/IPの受信バッファサイズ

　〜〈符号なし整数〉((0，8192〜1048576))《8192》（単位：バイト）

コネクションごとに確保されるソケットの受信バッファのサイズを指定します。高速な通信媒体やMTUの大きな通信媒体を使用している場合，この値を大きくすることによって性能向上を図れます。

0を指定した場合は，OSの受信バッファサイズを適用します。受信データサイズが8,192バイトを超える場合，このオペランドに0を指定することで受信バッファのサイズが拡張され，性能向上を図れることがあります。

なお，0を指定する場合，このノードと通信するすべてのノードで同じ値を指定してください。同じ値を指定しない場合，通信するノードとバッファサイズに差異が生じ，通信性能が劣化するおそれがあります。また，1〜8191は指定できません。1〜8191を指定した場合，0を仮定します。

ipc_recvbuf_sizeオペランドに指定した値よりも小さいデータをやり取りし合う通信処理の場合，ipc_tcpnodelayオペランドにYを指定することを推奨します。

注

TCPは，受信したデータに対し，送達確認(ACK)パケットを返信します。

受信バッファのサイズに対し，受信したデータが小さいと，データを受信しても直ちにACKを返信しません(遅延ACK)。

このオペランドに大きな値を指定し，小さいデータをやり取りし合うような通信処理の場合，遅延ACKの影響によって性能が悪くなるおそれがあります。遅延ACKの詳細については，TCP/IPの文献を参照してください。

このオペランドの値は，OSで使用できるTCP/IPの受信バッファのサイズ以下の値を指定してください。指定するTCP/IPの受信バッファのサイズは，グローバルアーカイブジャーナル機能では有効になりません。グローバルアーカイブジャーナル機能の場合は，次のシステムサービス定義にTCP/IPの送受信バッファのサイズを指定してください。

ジャーナルサービス定義のjnl_arc_ipc_buff_sizeオペランド

グローバルアーカイブジャーナルサービス定義のjnl_arc_ipc_buff_sizeオペランド

このオペランドは，ユーザサービスデフォルト定義，ユーザサービス定義，各システムサービス定義でも指定できます。

指定値の優先順位は次のとおりです。

システムサーバの場合（1.＞2.）

各システムサービス定義

システム共通定義

ユーザサーバの場合（1.＞2.＞3.）

ユーザサービス定義

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

システム共通定義

●ipc_sendbuf_size=TCP/IPの送信バッファサイズ

　〜〈符号なし整数〉((0，8192〜1048576))《8192》（単位：バイト）

コネクションごとに確保されるソケットの送信バッファのサイズを指定します。高速な通信媒体やMTUの大きな通信媒体を使用している場合，この値を大きくすることによって性能向上を図れます。

0を指定した場合は，OSの送信バッファサイズを適用します。送信データサイズが8,192バイトを超える場合，このオペランドに0を指定することで送信バッファのサイズが拡張され，性能向上を図れることがあります。

RPCは，送信バッファにデータ送信する段階で4キロバイト単位で送信しており，ネットワークの状態によっては送信バッファ内のデータがネットワーク上に出力しきれないで，送信処理に失敗することがあります。例えば，rpc_max_message_sizeオペランドに8を指定して8メガバイトのメッセージを送信する場合，ネットワークの状態次第では4キロバイトの送信処理で35ミリ秒の待ちが無視できない回数発生し，通信性能に大きな影響を与えるおそれがあります。送信処理に失敗する場合の例を，次の図に示します。

図3‒1　送信バッファ内のデータがネットワーク上に出力しきれていないため，送信処理に失敗する場合の例

このような場合は，このオペランドに0を指定し，送信バッファサイズを調整することを推奨します。

なお，0を指定する場合，このノードと通信するすべてのノードで同じ値を指定してください。同じ値を指定しない場合，通信するノードとバッファサイズに差異が生じ，通信性能が劣化するおそれがあります。また，1〜8191は指定できません。1〜8191を指定した場合，0を仮定します。

ipc_sendbuf_sizeオペランドに指定した値よりも小さいデータをやり取りし合う通信処理の場合，ipc_tcpnodelayオペランドにYを指定することを推奨します。

注

このオペランドの値は，OSで使用できるTCP/IPの送信バッファのサイズ以下の値を指定してください。指定するTCP/IPの送信バッファのサイズは，グローバルアーカイブジャーナル機能では有効になりません。グローバルアーカイブジャーナル機能の場合は，次のシステムサービス定義にTCP/IPの送受信バッファのサイズを指定してください。

ジャーナルサービス定義のjnl_arc_ipc_buff_sizeオペランド

グローバルアーカイブジャーナルサービス定義のjnl_arc_ipc_buff_sizeオペランド

このオペランドは，ユーザサービス定義，ユーザサービスデフォルト定義，各システムサービス定義でも指定できます。

指定値の優先順位は次のとおりです。

システムサーバの場合（1.＞2.）

各システムサービス定義

システム共通定義

ユーザサーバの場合（1.＞2.＞3.）

ユーザサービス定義

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

システム共通定義

●rpc_router_retry_count=ENOBUFS，ENOMEM発生時のリトライ回数

　〜〈符号なし整数〉((0〜65535))《30》

TP1/Server Baseの内部で発行するacceptシステムコールでENOBUFSが発生した場合，またはメッセージ受信処理でENOMEMが発生した場合，メッセージ受信処理（acceptシステムコールも含む）のリトライ処理回数を指定します。

●rpc_router_retry_interval=ENOBUFS，ENOMEM発生時のリトライ間隔

　〜〈符号なし整数〉((0〜3600000))《0》（単位：ミリ秒）

TP1/Server Baseの内部で発行するacceptシステムコールでENOBUFSが発生した場合，またはメッセージ受信処理でENOMEMが発生した場合，メッセージ受信処理（acceptシステムコールも含む）のリトライ処理間隔を指定します。0を指定した場合は，リトライ処理間隔を空けないで，メッセージ受信処理のリトライ処理を実行します。

なお，このオペランドに1〜9を指定した場合は，10を仮定します。

●ipc_backlog_count=コネクション確立要求を格納するキューの長さ

　〜〈符号なし整数〉((0〜4096))《0》

コネクション確立要求を格納するキューの長さ（listenシステムコールのバックログ数）を指定します。

0（デフォルト値）を指定した場合，listenシステムコールのバックログ数に設定する実数値はOSによって異なります。デフォルト値を指定した場合の実数値については，「リリースノート」を参照してください。

実際のキューの長さは，指定した値より長くなる場合があります。

キューの長さの上限値，下限値は，各OSによって異なります。OSによって，キューの長さの上限値，下限値が制限されている場合，設定した値が有効にならないことがあります。コネクション確立要求を格納するキューの詳細については，OSのマニュアル，または，TCP/IPの文献を参照してください。

このオペランドで指定した値より多くの接続要求が瞬間的に発生すると，キューからあふれた接続要求は破棄されます。瞬間的に発生する接続要求の数を考慮した値を設定してください。

このオペランドは，ユーザサービス定義，ユーザサービスデフォルト定義でも指定できます。

指定値の優先順位は次のとおりです（1.＞2.＞3.）。

ユーザサービス定義

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

システム共通定義

●statistics=Y|N

　〜《N》

共用メモリ上にシステム統計情報を取得するかどうかを指定します。

Y

共用メモリ上にシステム統計情報を取得します。

N

共用メモリ上にシステム統計情報を取得しません。

取得されるシステム統計情報を見るためには，dcstatsコマンドでジャーナルファイルに出力するか，dcreportコマンドで標準出力に出力してください。

取得されるシステム統計情報は，dcstatsコマンドの-sオプション指定時に取得されるシステム統計情報と同じです。

●name_domain_file_use=Y|N

　〜《N》

OpenTP1起動時および再開始（リラン）時に有効にするドメイン構成を指定します。

namchgflコマンドを使用してドメイン構成を変更する場合の定義ファイルの指定方法および注意事項については，マニュアル「OpenTP1 運用と操作」を参照してください。

Y

ドメイン定義ファイルに指定したドメイン構成を有効にします。

N

システム共通定義に指定したドメイン構成を有効にします。

ドメイン定義ファイルには，all_nodeを指定するファイルと，all_node_exを指定するファイル，さらに優先選択ノードを指定する定義ファイルがあります。優先選択ノードの定義ファイルの指定方法は，all_nodeまたはall_node_exを指定するファイルと同じです。ファイル名称は任意の名称です。このオペランドを有効にするには，それぞれのファイルを次の場所に格納してください。

all_nodeを指定するファイル

$DCCONFPATH/dcnamndディレクトリ下

all_node_exを指定するファイル

$DCCONFPATH/dcnamndexディレクトリ下

優先選択ノードを指定する定義ファイル

$DCCONFPATH/dcnamprディレクトリ下

これらのファイルのノード名やポート番号に不正があった場合は，KFCA00656-E（ノード名不正），KFCA00657-E（ポート番号不正）またはKFCA00666-E（ホスト未定義）のメッセージを出力し，OpenTP1の起動に失敗します。

また，優先選択ノードの定義ファイルに指定したノードがall_nodeのドメイン定義ファイルに指定されていなかった場合は，KFCA00603-W（all_nodeに未定義）のメッセージを出力し，優先選択ノードの指定を無効としてOpenTP1を起動します。なお，同一ファイル内のほかの行で正しく定義されているノードについては，優先選択ノードの指定は有効となります。

それぞれのディレクトリ下に，複数のドメイン定義ファイルを格納した場合，同じディレクトリ下に格納されているすべてのドメイン定義ファイルを合わせて一つのドメイン（OpenTP1システム）を構成します。次の場合，自ノードだけのドメインとしてOpenTP1システムを構成します。

ドメイン定義ファイルが正しい場所に存在しない場合

ドメイン定義ファイルを格納するディレクトリが存在しない場合

ドメイン定義ファイルにノードが指定されていない場合

OpenTP1の起動中にこのオペランドを変更した場合の動作は保証できません。

Yを指定した場合，namndchgコマンドがエラーリターンします。Nを指定した場合，namchgflコマンドがエラーリターンします。

name_domain_file_useオペランドの指定による機能差について次の表に示します。

OpenTP1

の状態

name_domain_file_useオペランドの指定値

Y

N

正常開始

システム共通定義のall_nodeオペランド，およびall_node_exオペランドを無視して，ドメイン定義ファイルの指定でOpenTP1システムを構成する。

システム共通定義のall_nodeオペランド，およびall_node_exオペランドの指定でOpenTP1システムを構成する。

再開始

（リラン）

再開始が発生した時点の，all_nodeオペランド，およびall_node_exオペランドを無視して，ドメイン定義ファイルの指定でOpenTP1システムを構成する。

再開始時点の，all_nodeオペランド，およびall_node_exオペランドの指定でOpenTP1システムを構成する。

稼働中

namchgflコマンドでドメイン構成を変更できる。コマンド実行時点のドメイン定義ファイルの指定でドメイン構成を変更する。

namchgflコマンドでドメイン構成を変更できない。OpenTP1起動時点のname_domain_file_useオペランドの指定（N）が環境不正となり，コマンドがエラーリターンする。

namndchgコマンドでドメイン構成を変更できない。OpenTP1起動時点のname_domain_file_useオペランドの指定（Y）が環境不正となり，コマンドがエラーリターンする。

namndchgコマンドでドメイン構成を変更できる。コマンド実行時点のシステム共通定義のall_nodeオペランドおよび，all_node_exオペランドの指定でOpenTP1システムを構成する。

●all_node_extend_number=ドメイン変更時の最大ノード数

　〜〈符号なし整数〉((0〜65535))《64》

namndchgコマンドまたはnamchgflコマンドでドメイン構成を変更する場合，変更後のドメインを構成する最大ノード数を指定します。

namndchgコマンドを使用する場合は，システム共通定義のall_nodeオペランドに指定するノードの最大数を指定してください。namchgflコマンドを使用する場合は，all_nodeのドメイン定義ファイル中に指定するノードの最大数を指定してください。

このオペランドに指定されたノード数と，all_nodeオペランドに指定されたノード数またはall_nodeのドメイン定義ファイル中に指定されたノード数とを合計した分の共用メモリの領域を確保します。

このオペランドに指定した値を超えるノード数を，システム共通定義またはドメイン定義ファイルに指定した場合，namndchgコマンドまたはnamchgflコマンドはエラーリターンし，KFCA00616-EおよびKFCA00654-Eメッセージを出力します。この場合，ドメインは変更されないで，コマンド実行前のドメイン構成のままになります。

●all_node_ex_extend_number=ドメイン定義ファイルを使用したドメイン変更時の最大ノード数

　〜〈符号なし整数〉((0〜65535))《64》

namchgflコマンドに-eオプションを指定してドメイン構成を変更する場合，変更後のドメインを構成する最大ノード数を指定します。

all_node_exのドメイン定義ファイル中に指定するノードの最大数を指定してください。

このオペランドに指定されたノード数と，all_node_exのドメイン定義ファイル中に指定されたノード数とを合計した分の共用メモリの領域を確保します。

このオペランドに指定した値を超えるノード数をドメイン定義ファイルに指定した場合，namchgflコマンドはエラーリターンし，KFCA00655-Eメッセージを出力します。この場合，ドメインは変更されないで，コマンド実行前のドメイン構成のままになります。

●prc_current_work_path=カレントワーキングディレクトリ作成用のディレクトリパス

　〜〈パス名〉《$DCDIR》

OpenTP1プロセスのカレントワーキングディレクトリ作成用のディレクトリを絶対パスで指定します。実際のプロセスのカレントワーキングディレクトリは「このオペランドで指定したパス/tmp/home/プロセスごとに作成されたディレクトリ」になります。

このオペランドで指定したパスに誤りがある場合，またはこのオペランドの指定を省略した場合，カレントワーキングディレクトリ作成用のディレクトリは$DCDIRになります。したがって，実際のプロセスのカレントワーキングディレクトリは「$DCDIR/tmp/home/プロセスごとに作成されたディレクトリ」になります。

パス名に指定できる文字数は，最大50文字です。

OpenTP1起動時，およびdcresetコマンド実行時に，このオペランドで指定したディレクトリにtmpディレクトリが存在する場合，いったんtmpディレクトリが削除されたあと，再作成されます（コアファイルが存在する場合は，$DCDIR/spool/saveまたはプロセスサービス定義のprc_coresave_pathオペランドで指定したディレクトリに退避されます）。

なお，このオペランドで指定したディレクトリのtmpディレクトリを削除の際，削除するディレクトリ下にユーザが作成したデータが多数存在すると，ディレクトリの削除に時間が掛かり，OpenTP1の起動やdcresetコマンドの完了が遅くなります。

このため，ユーザプログラムから多数のデータを作成する環境の場合，次の対策を検討してください。

このオペランドで指定したディレクトリ，およびOpenTP1ディレクトリ以外の場所にデータを作成する。

OpenTP1の停止前，およびdcresetコマンド実行前に，このオペランドで指定したディレクトリのサーバ名下にある，ユーザプログラムが作成したデータを削除する。

このオペランドで指定するディレクトリには，次の権限が必要です。

OpenTP1管理者がディレクトリを作成できる権限

OpenTP1グループが上記のディレクトリにファイル（コアファイルなど）を作成できる権限

同一マシン上で複数のOpenTP1を使用する場合，複数のOpenTP1のprc_current_work_pathオペランドに同じディレクトリを指定しないでください。指定したディレクトリが，ほかのOpenTP1で使用されている場合，そのディレクトリは使用しないで，デフォルトのディレクトリを使用します。

このオペランドの指定を変更する場合，まずOpenTP1を正常終了させてください。オペランドの変更後はdcresetコマンドを実行する必要があります。

このオペランドの指定を変更した場合，変更前にこのオペランドで指定していたディレクトリに，変更前に作成されたディレクトリが残っている場合があります。残っているディレクトリは，削除しても問題ありません。削除する場合は，OpenTP1を正常終了させてから削除してください。その後，削除したディレクトリを再作成して再度使用する場合は，dcresetコマンドを実行する必要があります。

このオペランドとプロセスサービス定義のprc_coresave_pathオペランドは，同じパーティション上に設定することをお勧めします。

このオペランドを指定する場合，オンラインテスタ機能は使用しないでください。

●rpc_max_message_size=RPC送受信電文の最大長

　〜〈符号なし整数〉((1〜8))《1》（単位：メガバイト）

RPCコールで送受信できるメッセージ（ユーザ電文）の最大長を指定します。

このオペランドを指定する場合は，システム共通定義のall_nodeオペランドに指定したすべてのノードで同じ値を指定してください。同じ値を指定しない場合，送信先ノードのノード間負荷バランス機能が実行されたときに，RPCコール（dc_rpc_call，dc_rpc_call_to）がDCRPCER_NET_DOWNでエラーリターンするおそれがあります。

このオペランドを指定して1メガバイトより大きなメッセージを送信する場合は，次のことに注意してください。

SPPが起動しているOpenTP1ノードのバージョンは，このオペランドを使用できるバージョンにしてください。

SPPが起動しているすべてのOpenTP1ノードのバージョンが，このオペランドを使用できないバージョンの場合は，RPCコール（dc_rpc_call，dc_rpc_call_to）はDCRPCER_NO_SUCH_SERVICE_GROUPまたはDCRPCER_TRNCHKでエラーリターンします。

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

サービス要求元のOpenTP1ノード開始前にSPPを起動した場合は，RPCコール（dc_rpc_call，dc_rpc_call_to）がDCRPCER_NO_SUCH_SERVICE_GROUPでエラーリターンするおそれがあります。

このオペランドを指定した場合，RPCコールで送信できるメッセージの最大長は，DCRPC_MAX_MESSAGE_SIZEの値（1メガバイト）ではなく，このオペランドに指定した値になります。ただし，rpc_max_message_sizeオペランドの値の指定を省略した場合，またはrpc_max_message_sizeオペランドに1を指定した場合は，メッセージの最大長は，DCRPC_MAX_MESSAGE_SIZEの値（1メガバイト）になります。

このオペランドを指定しないで動作していた環境で，このオペランドの値に2以上を指定し，1メガバイト以上のメッセージを送信した場合，メモリ不足が発生するおそれがあります。そのため，このオペランドを指定する場合は，実装するメモリ量やプロセスで使用できる最大メモリ量を考慮して指定してください。スケジュールサービスを使用した場合のメモリ量の最大値は次の式で求められます。

最大使用メモリ量 = rpc_max_message_sizeオペランド指定値×64×2（単位：メガバイト）

このオペランドを指定すると，UAPプロセスでもメモリ使用量が増加する可能性があります。UAPプロセスのメモリ使用量に，このオペランドで指定したサイズを加算してください。また，RPCトレースを取得する場合，すべてのユーザ電文を取得しますので，UAPプロセスのRPCトレース取得処理に時間が掛かるおそれがあります。

このオペランドを指定して次の機能を使用した場合の動作は保証できません。

通信先を指定した遠隔サービス（dc_rpc_call_to）のスケジューラデーモンのポート指定

ネームサービスを使わない通信（dcsvgdef定義コマンド）

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

XATMIインタフェースを使用した通信

ゲートウェイプログラムを使用した通信

UAPテスタ機能（オンラインテスタ機能，オフラインテスタ機能，MCFオンラインテスタ機能）

このオペランドを指定して，1メガバイト以上のメッセージをCUPへ一方通知する場合は，1メガバイト以上のメッセージを受信できるバージョンのTP1/Clientを使用してください。

このオペランドを指定して，データ圧縮機能を使用する場合は，圧縮後のメッセージ長が1メガバイト以下でも，RPCコール（dc_rpc_call，dc_rpc_call_to）のin_lenの値が1メガバイトより大きければ，1メガバイト以上のメッセージを送信すると判断します。

●uap_trace_file_put=Y|N

　〜《N》

UAPトレースのトレース情報を，ファイルに取得するかどうかを指定します。

Y

トレース情報をUAPトレースデータファイルに取得します。この場合，ユーザサーバを終了させないで，UAPトレースの編集出力ができるようになります。UAPトレースデータファイルについては，マニュアル「OpenTP1 運用と操作」を参照してください。

トレース情報をファイルに取得できなかった場合，プロセス固有領域にトレース情報を取得します。

N

トレース情報をプロセス固有領域に取得します。この場合，ユーザサーバをアボートしたときにだけ，UAPトレースの編集出力ができます。

Yを指定した場合，ユーザサーバダウン時，またはOpenTP1終了後の再開始時に，UAPトレースデータファイルのバックアップファイルを各サーバで最大6世代取得します。バックアップファイルの内訳は，該当するサーバの正常終了時に3世代，コアファイルの出力を伴う異常終了時に3世代です。バックアップファイルの格納先は，プロセスサービス定義のprc_coresave_pathオペランドに指定した，コアファイルの格納先です。

Windowsの場合，UAPトレースの編集出力はuatdumpコマンドで行います。uatdumpコマンドについては，マニュアル「OpenTP1 テスタ・UAPトレース使用の手引」を参照してください。

このオペランドは，ユーザサービス定義，ユーザサービスデフォルト定義でも指定できます。

指定値の優先順位は次のとおりです（1.＞2.＞3.）。

ユーザサービス定義

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

システム共通定義

●dcstart_wakeup_retry_count=OpenTP1起動通知エラーリトライ回数

　〜〈符号なし整数〉((0〜60))《0》

OpenTP1の起動通知に失敗した場合に，リトライする回数を指定します。

dcstartコマンドでOpenTP1を起動する場合，プロセスサーバにOpenTP1の起動開始が通知されます。プロセスサーバへの起動通知に失敗すると，dcstartコマンドの機能によって，自動的にこのオペランドの指定回数分，起動通知をリトライします。

省略した場合，または0を指定した場合はリトライしません。

●dcstart_wakeup_retry_interval=OpenTP1起動通知エラーリトライ間隔

　〜〈符号なし整数〉((1〜60))《10》（単位：秒）

OpenTP1の起動通知に失敗した場合に，リトライする間隔を指定します。

このオペランドを有効にするには，dcstart_wakeup_retry_countオペランドに1以上を指定する必要があります。

リトライの間隔は，プロセスサーバへの起動通知に失敗してから，次に起動通知が行われるまでの待ち時間になります。

●nam_prf_trace_level=NAMイベントトレースの取得レベル

　〜((00000000〜00000007))《00000003》

性能検証用トレース情報の取得で，ネームサービス関係のトレース（NAMイベントトレース）の取得レベルを指定します。NAMイベントトレースのイベントIDは0xf000から0xffffです。イベントIDの詳細については，マニュアル「OpenTP1 運用と操作」を参照してください。なお，次の値以外を指定した場合は，00000003を指定したと仮定されます。

00000000

NAMイベントトレースを取得しません。

00000001

サービスグループ情報の登録，削除などのNAMイベントトレース（イベントID：0xf100〜0xf1ff）を取得します。

00000002

ネームサーバ（namd）が行う他ノードとの通信処理に関するNAMイベントトレース（イベントID：0xf000〜0xf0ff）を取得します。

00000003

00000001および00000002のNAMイベントトレースを取得します。

00000004

UAPおよび運用コマンドのプロセスとネームサーバ（namd）との通信処理に関するNAMイベントトレース（イベントID：0xf200〜0xf2ff）を取得します。

00000005

00000001および00000004のNAMイベントトレースを取得します。

00000006

00000002および00000004のNAMイベントトレースを取得します。

00000007

すべてのNAMイベントトレース（00000001，00000002および00000004のNAMイベントトレース情報）を取得します。

取得したトレースをファイル出力または編集出力するには，prfgetコマンド，prfedコマンド，またはdcalzprfコマンドを使用します。これらのコマンドの詳細については，マニュアル「OpenTP1 運用と操作」を参照してください。

このオペランドの使用は，TP1/Extension 1をインストールしていることが前提です。TP1/Extension 1をインストールしていない場合の動作は保証できません。

●fil_prf_trace_option=0|1

　〜《1》

FILイベントトレースを取得するかどうかを指定します。

0

FILイベントトレースを取得しません。

1

OpenTP1ファイルへのアクセス要求で，fil_prf_trace_delay_timeオペランドの指定値以上の処理時間が掛かった場合，遅延情報としてFILイベントトレースを取得します。

このオペランドに0または1以外の値を指定しないでください。0または1以外の値を指定した場合の動作は保証できません。

FILイベントトレースで取得されるイベントIDは，0x6805，0x6807，0x6905，0x6907，および0x6909です。

取得したトレースをファイル出力または編集出力するには，prfgetコマンド，prfedコマンド，またはdcalzprfコマンドを使用します。イベントIDの詳細，これらのコマンドの詳細については，マニュアル「OpenTP1 運用と操作」を参照してください。

このオペランドの使用は，TP1/Extension 1をインストールしていることが前提です。TP1/Extension 1をインストールしていない場合の動作は保証できません。

●fil_prf_trace_delay_time=FILイベントトレース取得条件となるファイルアクセス処理時間のしきい値

　〜〈符号なし整数〉((1〜65535))《3》（単位：秒）

FILイベントトレースの取得条件となるファイルアクセス処理時間のしきい値を指定します。

注

しきい値を監視する時間精度は秒単位です。そのため，タイミングによっては，このオペランドに指定した値よりも短いファイルアクセス処理時間でFILイベントトレースが取得されることがあります。しきい値が小さくなるほど，誤差の影響を受けやすくなりますので注意してください。

●jnl_prf_event_trace_level=JNL性能検証用トレースの取得レベル

　〜((00000000〜00000002))《00000001》

性能検証用トレース情報の取得で，JNL性能検証用トレースの取得レベルを指定します。JNL性能検証用トレースのイベントIDは0xc000から0xcfffまでです。イベントIDの詳細については，マニュアル「OpenTP1 運用と操作」を参照してください。なお，次の値以外を指定した場合は，00000001を指定したと仮定されます。

00000000

JNL性能検証用トレースを取得しません。

00000001

JNL性能検証用トレース（イベントID：0xc202，0xc203，0xc401，および0xc402）を取得します。

00000002

JNL性能検証用トレース（イベントID：0xc001〜0xc402）を取得します。

なお，取得レベルに00000002を指定した場合，すべてのトレース情報を取得できますが，オンライン性能に影響を与えるため，デバッグ時以外はデフォルトの出力レベルで運用することをお勧めします。

取得したトレースをファイル出力または編集出力するには，prfgetコマンド，prfedコマンド，またはdcalzprfコマンドを使用します。これらのコマンドの詳細については，マニュアル「OpenTP1 運用と操作」を参照してください。

このオペランドの使用は，TP1/Extension 1をインストールしていることが前提です。TP1/Extension 1をインストールしていない場合の動作は保証できません。

●jnl_fileless_option=Y|N

　〜《N》

該当するOpenTP1ノードでジャーナルファイルレス機能を使用するかどうかを指定します。

Y

ジャーナルファイルレス機能を使用します。

N

ジャーナルファイルレス機能を使用しません。

ジャーナルファイルレス機能を使用する場合，次の機能は使用できません。

システムジャーナル機能

グローバルアーカイブジャーナル機能

トランザクション機能

XAリソースサービスによるトランザクション機能

DAM，TAMなどのOpenTP1提供の各種リソースマネジャ機能

各種統計情報取得機能

統計情報取得機能を使用してもエラーにはなりませんが，ジャーナルファイルレス機能を使用する場合は，統計情報が取得されません。

統計情報取得機能以外の機能を使用した場合は，OpenTP1の開始処理がエラーになります。

トランザクション機能が使用できないため，ユーザサービス定義，またはユーザサービスデフォルト定義のatomic_updateオペランドにYを指定できません。Yを指定しても，Nを指定したものとして動作します。

また，トランザクション機能が使用できないため，XA連携機能も使用できません。このため，trnlnkrmコマンドによるOpenTP1に対するリソースマネジャの登録は不要です。

ジャーナルファイルレス機能を使用する場合に，使用できなくなる機能とコマンドなどの詳細については，マニュアル「OpenTP1 運用と操作」を参照してください。

●prc_coredump_filter=コアファイルに共用メモリを含めるかの判断値

　〜〈符号なし整数〉((1，3，65，67))

コアファイルに共用メモリを含めるかどうかを設定します。このオペランドは，適用OSがLinuxの場合に指定できます。

このオペランドを省略した場合は，OpenTP1の該当プロセスに対して有効になっているOSの設定（/proc/[pid]/coredump_filter）に従います。

[pid]

該当プロセスのプロセスID

1

共用メモリを含めません。

3

共用メモリを含めます。ただし，Hugepage機能が適用されている共用メモリは含みません。

65

Hugepage機能が適用されている共用メモリだけ含めます。

67

すべての共用メモリを含めます。

コアファイルに共用メモリを含めると，コアファイルのサイズが大きくなります。コアファイル出力時にディスクを圧迫するおそれがありますので，注意してください。コアファイルが出力されるディレクトリは，システム共通定義のprc_current_work_pathオペランドを参照してください。

コアファイルのサイズが大きくなると，次の処理時間に影響がありますので，注意してください。

dcsetupコマンドの実行時間

dcresetコマンドの実行時間

dccspoolコマンドの実行時間

dcrasgetコマンドの実行時間

また，コアファイルの出力に時間が掛かると，次の処理時間に影響がありますので，注意してください。

OpenTP1の再開始時間

系切り替え時間

dcstopコマンドの-fdオプション実行時間

dcsvstopコマンドの-fdオプション実行時間

OpenTP1が使用する共用メモリのHugepage機能に関しては，マニュアル「OpenTP1 運用と操作」のHugepage機能の適用（Linux限定）の説明を参照してください。

UAPが使用するOpenTP1以外の他製品で，共用メモリにHugepage機能が適用されているかどうかは，各製品のマニュアルや設定を確認してください。

共用メモリの属性と，このオペランドの関係は次のとおりです。

共用メモリのHugepage属性

prc_coredump_filter指定値

1

3

65

67

指定なし

×

○

×

○

指定あり

×

×

○

○

（凡例）

○：共用メモリがコアファイルに含まれます

×：共用メモリがコアファイルに含まれません

このオペランドはシステム共通定義，ユーザサービスデフォルト定義，およびユーザサービス定義に指定できます。OpenTP1システム全体に有効にする場合は，システム共通定義に指定します。

指定値の優先順位は次のとおりです（1.＞2.＞3.）。

ユーザサービス定義

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

システム共通定義

システム共通定義内のこのオペランドを変更した場合は，dcresetコマンドを実行してください。

このオペランドの指定値に従い，プロセス生成直後にOpenTP1がLinuxのコアファイルのフィルタリング（coredump_filter）へ設定します。指定値に誤りがあると，意図したとおりに動作しません。また，対応OS以外の環境で指定した場合は無視されます。

OpenTP1が提供する次のサービスでは，ユーザサービスデフォルト定義に指定した定義内容が有効になります。

MQCゲートウェイサービス

リポジトリ管理サーバ

リアルタイム統計情報サービス

rapクライアントマネジャ，rapリスナー，およびrapサーバ

注意事項

例えば，巨大な共用メモリを使用している環境で，コアファイルのサイズを極力抑えたい場合，このオペランドに67以外を指定することでコアファイルに共用メモリが含まれなくなり，コアファイルの大きさを抑えることができます。ただし，コアファイルに含まれている共用メモリは，そのコアファイルを出力したプロセスがその瞬間参照していた共用メモリであって，トラブルシュートに大変有益な情報です。コアファイルを出力する状態自体が何か問題がある場合であり，このコアファイルに含まれている共用メモリ情報はその問題を解決するのに必要な情報です。

このオペランドに67以外を設定することで，そのトラブルシュートに必要な情報が一部失われ，問題解決に時間が掛かるおそれがあります。特に，システムサーバがコアファイルを出力する状態は，システム的に異常な状態になっているおそれが高く，その瞬間の共用メモリがトラブルシュートに不可欠なケースがあります。

これらのことを踏まえた上で，このオペランドの指定値を決めてください。

●name_service_mode=manager|agent|normal

　〜《normal》

ノード自動追加機能を使用する場合の，ノードの動作モードを指定します。

このオペランドは，ノード自動追加機能を使用する場合に指定します。

manager

マネジャノードとして動作します。

agent

エージェントノードとして動作します。

normal

ノード自動追加機能を使用しません。ノーマルノードとして動作します。

dcbindht定義コマンドを指定する場合は，ノード自動追加機能を使用できません。normalを指定するか，このオペランドを省略してください。

managerを指定した場合，ネームサービス定義のname_audit_confオペランドの指定を無視して，送受信型ノード監視機能によってエージェントノードとノーマルノードの稼働状況を監視します。そのため，同一ホストで複数のエージェントノードやノーマルノードを動作させる場合は，一つのホストに複数の異なるIPアドレスを設定し，それぞれのノードに異なるIPアドレスを設定してください。

agentを指定した場合，システム共通定義のname_manager_nodeオペランドにマネジャノードを指定してください。また，ネームサービス定義のname_audit_confオペランドの指定内容によって，次の動作をします。

name_audit_confオペランドを省略，または0を指定した場合

送受信型ノード監視機能によって，マネジャノードの稼働状況を監視します。同時にノードリストの整合性を確保します。

name_audit_confオペランドに1，または2を指定した場合

指定値を無視して送受信型ノード監視機能によって，マネジャノードの稼働状況を監視します。同時にノードリストの整合性を確保します。エージェントノード，およびノーマルノードとのノード監視は指定値に従って監視します。

managerまたはagentを指定した場合，ネームサービス定義のname_rpc_control_listオペランドにNが指定されたものとして動作します。

同一ホストで複数のマネジャノードを動作させる場合は，一つのホストに複数の異なるIPアドレスを設定し，それぞれのマネジャノードに異なるIPアドレスを設定してください。

ノードリストを引き継ぐ場合，OpenTP1の開始は，ノードリストファイル中に格納された動作モードに従います。nammstrコマンドで動作モードを変更したとき，このオペランドに指定した動作モードと一致しないことがあります。OpenTP1システムの現在の動作モードは，次のコマンドで確認できます。

OpenTP1のオフライン時：namnldspコマンド

OpenTP1のオンライン時：namsvinfコマンドに-xオプションを指定

namnldspコマンド，およびnamsvinfコマンドの詳細については，マニュアル「OpenTP1 運用と操作」を参照してください。

●name_manager_node=ノード名〔:ポート番号〕

　〜〈1〜255文字の識別子〉|〈符号なし整数〉((5001〜65535))

OpenTP1システム内で稼働するマネジャノードのノード名，およびそのネームサーバがウェルノウンポート番号として使用するポート番号を指定します。

ポート番号を省略した場合は，name_portオペランドで指定したネームサービスのポート番号が仮定されます。

このオペランドは，ノード自動追加機能を使用する場合に，システム共通定義のname_service_modeオペランドにagentを指定したノード（エージェントノード）で指定します。agent以外を指定したノードでこのオペランドを指定した場合は，無効になります。

エージェントノードは，OpenTP1起動時に，このオペランドに指定したノードに対してノードリスト要求を送信します。ノードリストを正常に受信できた場合だけ，このオペランドで指定したノードをマネジャノードとして認識します。なお，このオペランドにマネジャノード以外のノード※を指定した場合は，ノードリストを正常に受信できないため，指定したノードをマネジャノードとして認識しません。また，マネジャノードからのノードリストを受信できないため，RPCの要求範囲は，オペランドを指定したノードに限定されます。

エージェントノードの開始時に，マネジャノードが起動していない場合や，ネットワークなどの障害によって，通信ができない状態の場合も，RPCの要求範囲がオペランドを指定したノードに限定されることがあります。

注※

name_service_modeオペランドに，manager以外を指定しているノード，またはname_service_modeオペランドをサポートしていないノード

参考

ノードリストを引き継ぐと，このようなマネジャノードとの通信障害などの影響を受けないで，前回オンラインの終了時と同等のノードリストが使用でき，RPCの要求範囲を確保できます。

●name_remove_down_node=Y|N

　〜《N》

マネジャノードが停止を検知したエージェントノード，およびノーマルノードのノード情報を，ノードリストから削除するかどうかを指定します。

このオペランドは，ノード自動追加機能を使用する場合に，マネジャノードで指定します。

Y

停止を検知したノードのノード情報をノードリストから削除し，マネジャノードの管理対象から除外します。

N

停止を検知したノードのノード情報をノードリストから削除しません。停止を検知したノードのノード情報をRPC抑止リストへ登録します。

ノード情報をノードリストから削除したい場合は，マネジャノードでnamndrmコマンドを実行してください。

次の場合は，ノードリストを削除しないで，次回のノードリストの整合性を確保するときに削除します。

マネジャノードがノードリストからノード情報を削除する際に，サービスグループ情報の検索など，ノードリストを参照する処理が並行して動作している場合

エージェントノードでノードリストの整合性を確保する際に，サービスグループ情報の検索など，ノードリストを参照する処理が並行して動作している場合

ノーマルノードを混在させて使用する運用の場合，このオペランドにはNを指定してください。Yを指定すると，ノーマルノードの停止によって，マネジャノードのノードリストからノーマルノードの情報が削除されます。ノーマルノードの再開始後も，マネジャノードとのコネクションが切断されているため，ノーマルノードのノード情報がノードリストに登録されません。また，マネジャノードやほかのエージェントノードのサービスグループ情報（起動，停止，負荷状態の変更）に関する通知がノーマルノードへ送信されません。ノード間の負荷バランスを保つために，このオペランドにはNを指定してください。

●name_node_add_policy=using_only|all

　〜《using_only》

エージェントノードのノードリストに，ノーマルノードのノードの情報を登録するかどうかを指定します。

このオペランドは，ノード自動追加機能を使用する場合に，エージェントノードで指定します。

using_only

ノーマルノードの情報をノードリストに登録しません。

all

ノーマルノードの情報をノードリストに登録します。

このオペランドを省略，またはusing_onlyを指定したエージェントノードのノードリストには，ノーマルノードが登録されません。このエージェントノードとノーマルノード間では，サービスグループ情報（起動，停止，負荷状態の変更）に関する連携が行われません。ノーマルノードを使用し，かつOpenTP1システム内のノード間の負荷バランスを保つために，このオペランドにallを指定してください。

●dc_deter_restart_on_stop_fail=Y|N

　〜《N》

実行系OpenTP1システムが，dcstop -f（-fd）コマンドによる強制停止処理中に異常終了したとき，系切り替えを抑止するかどうかを指定します。

Y

系切り替えを抑止します。

N

系切り替えを抑止しません。

●tp1_monitor_time=OpenTP1監視機能の無応答監視時間

　〜〈符号なし整数〉((1〜60))《15》（単位：分）

OpenTP1監視機能の，プロセスサービスの無応答監視時間を指定します。このオペランドに指定した時間を過ぎてもプロセスサービスの稼働が確認できなかった場合，無応答状態と判断します。その後のOpenTP1監視機能の動作は，tp1_monitor_kill_signalオペランドの指定に従います。なお，OpenTP1監視機能の無応答監視時間は，OpenTP1監視サービスに対する監視にも適用されます。

OpenTP1監視機能の無応答監視時間は，業務システムの要件に応じて指定してください。

注意事項

HAモニタを併用する場合，HAモニタのサーバ対応の環境設定（serversファイル）のpatrolオペランドで指定する，サーバ障害監視時間よりも1分以上長い値を設定してください。

●tp1_monitor_kill_signal=0|3|9

　〜《3》

OpenTP1監視機能の無応答監視時間満了時の動作を指定します。このオペランドの指定値ごとの無応答監視時間満了時の動作を次に示します。

tp1_monitor_kill_signalオペランドの指定値

無応答監視時間満了時の動作

KFCA33309-Eメッセージの出力

プロセスサービスの強制停止

プロセスサービスのコアファイルの出力

0

あり※

なし

なし

3（デフォルト値）

あり

あり

あり

9

あり

あり

なし

注※

KFCA33309-Eメッセージを出力後，無応答監視満了時点から無応答監視時間を過ぎても稼働報告がなければ，そのつどメッセージを出力します。

通常，このオペランドはデフォルト値で使用してください。

0を指定した場合，OpenTP1監視サービスは無応答状態を検知しても，自動で復帰しません。OpenTP1を無応答状態から復帰させるには，KFCA33309-Eメッセージの出力を契機に，プロセスサービスを手動で強制停止してください。なお，プロセスサービスを強制停止するには，スーパユーザで実行する必要があります。

●ipc_notify_response_host=Y|N

　〜《N》

応答電文受信用IPアドレス通知機能を使用するかどうかを指定します。

OpenTP1システム内にKubernetesノードで起動するTP1/Server Baseが存在する場合，各TP1/Server BaseでこのオペランドにYを指定してください。

このオペランドにYを指定することで，サービス要求先のTP1/Server Baseに，ipc_response_hostで指定した応答電文受信用IPアドレスを通知します。

これによりKubernetesノードを含むOpenTP1システム内で通信が可能となります。

Y

応答電文受信用IPアドレス通知機能を使用します。サービス要求先のTP1/Server Baseに，応答電文受信用IPアドレスを通知します。

次のRPC通信に対して有効になります。

ネームサービスを使用したRPC

スケジューラダイレクト機能を使用したRPC

通信先を指定したRPC

N

応答電文受信用IPアドレス通知機能を使用しません。サービス要求先のTP1/Server Baseに，応答電文受信用IPアドレスを通知しません。

注意事項

この定義でYを指定した場合，ipc_response_hostの指定が必要です。

マルチホームドホストの環境でこのオペランドにYを指定する場合は，システム共通定義のdcbindht定義コマンドにRPC通信に使用するホスト名を指定してください。

●ipc_response_host=ホスト名

　〜〈1〜255文字のホスト名〉

OpenTP1システム内にKubernetesノードで起動するTP1/Server Baseが存在する場合，各TP1/Server Baseでこのオペランドの指定が必要です。各TP1/Server Baseが応答電文を受信するために使用する，ホスト名またはIPアドレスを指定します。

このオペランドを指定することで，サービス要求先のTP1/Server Baseに応答電文受信用IPアドレスが通知され，Kubernetesノードを含むOpenTP1システム内で通信が可能となります。

ホスト名は，/etc/hostsファイルまたはDNSなどで，IPアドレスとのマッピングができなければなりません。なお，localhostまたは名前解決した結果が127で始まるIPアドレス（例：127.0.0.1）になるホスト名は指定しないでください。

ホスト名は，1個だけ指定できます。

ホスト名またはIPアドレスは，自ノードのTP1/Server Base環境により以下を指定してください。

自ノードのTP1/Server BaseがKubernetesクラスタ外の場合

自ノードのTP1/Server Baseが起動するマシンのホスト名またはIPアドレス

自ノードのTP1/Server BaseがKubernetesクラスタ内の場合

Kubernetesクラスタ内のどれかのKubernetesノードのホスト名またはIPアドレス

ここで指定するIPアドレスは，OpenTP1システム内の他ノードのTP1/Server Baseで指定する次のIPアドレスと一致させる必要があります。

システム共通定義のall_nodeオペランド，all_node_exオペランドに指定するノード名

ドメイン定義ファイルに指定するノード名

ユーザサービスネットワーク定義のdcsvgdefコマンドに指定するホスト名またはIPアドレス

dc_rpc_call_to関数の引数directionに指定するホスト名またはIPアドレス

なお，Kubernetesクラスタ内の同一ホスト上で，ホストOS上のTP1/Server Baseと，コンテナ内のTP1/Server Baseを連携する場合，マニュアル「OpenTP1 解説」を参照してください。

注意事項

ホスト名に256文字以上指定した場合，定義解析エラーでOpenTP1開始処理を停止します。

この指定は，ipc_notify_response_hostオペランドにYを指定した場合に有効です。

ipc_notify_response_hostオペランドにYを指定した場合，このオペランドは省略できません。

指定したホスト名の名前解決はOpenTP1起動時に実施します。そのためホスト名にマッピングしているIPアドレスの変更は，OpenTP1を正常停止後に実施してください。

ホスト名またはIPアドレスの変更手順

ホスト名またはIPアドレスは，次の手順で変更してください。

OpenTP1を正常停止します。Kubernetesを使用している場合はコンテナの停止になります。

システム共通定義のipc_response_hostに指定するホスト名またはIPアドレスを変更します。

dcresetコマンドを実行します。Kubernetesを使用している場合は実行不要です。

●watch_time=最大応答待ち時間

　〜〈符号なし整数〉((0〜65535))《180》（単位：秒）

RPCによってプロセス間で通信する場合，サービス要求を送信してからサービスの応答が返るまでの待ち時間の最大値を指定します。

OpenTP1の終了処理で，このオペランドで指定した時間だけ終了処理を待ち合わせる場合があります。したがって，大きな値を指定した場合，OpenTP1の終了処理に時間が掛かるときがあります。

指定時間を過ぎても応答がない場合は，RPCは送受信タイムアウトとしてエラーリターンします。

0を指定した場合は，応答を受信するまで待ち続けます。0を指定した場合，OpenTP1が終了しないときがあります。

このオペランドは，システム共通定義以外の幾つかのシステムサービス定義の中でも指定できます。各システムサービス定義で指定した場合は，各システムサービス定義で指定した値が優先されます。

このオペランドは，デフォルト値で使用してください。

システム共通定義だけにこのオペランドを指定すると，指定した定義値がOpenTP1システム全体に有効となります。そのため，特別なチューニングを必要とする場合以外は，このオペランドの内容を変更しないことをお勧めします。チューニングを必要とする場合でも，ユーザサービスに対する設定は，ユーザサービスデフォルト定義で設定してください。

このオペランドのデフォルト値よりも，極端に小さな値または大きな値を指定すると，OpenTP1ダウンに至る障害が発生する場合がありますので，ご注意ください。

コマンド形式

次ページ以降に記述しています。

putenv形式のオペランド

●LANG　LANG設定値

　〜〈文字列〉

環境変数LANGを設定します。

LANG設定値には，適用するOSで規定されている，言語種別を設定します。未設定の場合，または不当な値が設定された場合は，英語が設定されたものとします。

dcbindht

名称

OpenTP1通信時または系切り替え機能使用時のホスト名の指定

形式

{{dcbindht -h ホスト名
         〔-n ネットワーク名〔,ネットワーク名〕…〕}}

機能

OpenTP1が動作するホストが複数のネットワークアダプタで接続されている場合は，OpenTP1がどのネットワークアダプタを使用して通信するかを指定してください。一つのネットワークアダプタに複数のIPアドレスを付加できる場合は，OpenTP1がどのIPアドレスを使用して通信するかを指定してください。

また，IPアドレスを引き継ぐ系切り替えを行うホストの場合も指定する必要があります。

この機能は，dcbindht定義コマンドで指定されたホスト名に対応するIPアドレスで，OpenTP1が動作しているということを，通信先のOpenTP1に明示的に通知します。

ネットワークアダプタが一つで，かつIPアドレスを一つしか持っていないマシンの場合，OpenTP1が通信に使用するIPアドレスも物理的に一つに決まりますので，このコマンドを指定する必要ありません。

2：1系切り替え構成や，相互系切り替え構成のように，IPアドレスを引き継ぐ系切り替えで，1ホスト内に複数のOpenTP1が稼働することがある場合，このコマンドを指定してください。なお，ルータなどを経由してネットワーク間を接続している場合は，ここで指定するネットワークアダプタを経由して通信するすべてのネットワークを指定しなければなりません。マルチホームドホストの形態で複数のOpenTP1を使用する場合の注意事項については，マニュアル「OpenTP1 解説」のマルチホームドホストの形態での注意事項の説明を参照してください。

このコマンドの指定を省略した場合，複数のネットワークアダプタ，または複数のIPアドレスのどれを使用してOpenTP1がアクセスするかは，TCP/IPの制御で決定されます。TCP/IPの制御によって，期待していないIPアドレスが通信先のOpenTP1に通知されると，通信先のOpenTP1からの応答送信時に通信障害（ファイアウォールを通過できないなど）が発生するおそれがあります。このため，通信先のOpenTP1に通知する送信元IPアドレスをこのコマンドで決定してください。

次に示すように，この定義のネットワーク名の指定を省略した場合は，OpenTP1はすべての通信で，指定されたホスト名に対応するIPアドレスを使用します。この定義にネットワーク名の指定を省略した値を複数指定することはできません。複数指定した場合，先に定義された値が有効になり，あとに定義された値は無視されます。また，ネットワーク名が指定されている値とネットワーク名が省略されている値が混在する場合，ネットワーク名称が指定されている値が優先されます。

<システム共通定義>
dcbindht -h HOST_A -n NET_A,NET_B  # 送信先ネットワークアドレスが
                                   # NET_A,NET_Bの場合，ホスト名称
                                   # HOST_Aをbindし，送信します。

dcbindht -h HOST_B                 # 送信先ネットワークアドレスが
                                   # NET_A,NET_B以外の場合，ホスト
                                   # 名称HOST_Bをbindし，送信します。

dcbindht -h HOST_C                 # この定義が指定されても，先に定義
                                   # されたホスト名称HOST_Bが有効に
                                   # なります。

サブネットを使用したネットワーク環境でこの定義を指定する場合は，システム共通定義のrpc_netmaskオペランドも指定する必要があります。

サブネットを使用したネットワーク上で稼働させている場合，rpc_netmaskオペランドを指定しないときには，dcbindht定義コマンドに指定したネットワーク名とOpenTP1の認識するネットワークアドレスが一致しないため，dcbindht定義コマンドの指定値が有効になりません。なお，rpc_netmaskに指定するサブネットマスクは，OpenTP1のグローバルドメイン下のネットワークですべて同一でなければなりません。

オプション

●-h　ホスト名

　〜〈1〜255文字の識別子〉

OpenTP1の通信に使用する，ホスト名，またはネットワークアダプタに対応したホスト名を指定します。一つのネットワークアダプタに複数のIPアドレスを付加できる場合に，IPアドレスを引き継ぐ系切り替えを行うときは，引き継ぎたいIPアドレスに対応したホスト名を指定します。識別子に使用できる文字は英数字，ピリオド，およびハイフンです（ただし，IPアドレス形式は除く）。ホスト名は，/etc/hostsファイルまたはDNSなどで，IPアドレスとのマッピングができなければなりません。ホスト名にlocalhostまたはIPアドレスが127で始まるホスト（例：127.0.0.1）を指定した場合，通信時に通信障害が発生するおそれがあります。

なお，dc_rpc_call_to()を使用する場合，このオプションに指定したホスト名とmy_hostオペランドに指定したホスト名が異なるときは，動作を保証しません。

●-n　ネットワーク名

　〜〈1〜64文字の識別子〉

-hオプションで指定したネットワークアダプタまたはIPアドレスを経由して通信するネットワーク名を指定します。ネットワーク名は，/etc/networksファイルまたはNISなどで，ネットワーク番号とのマッピングができなければなりません。

このオプションは省略できます。省略した場合，OpenTP1はすべての通信で-hオプションで指定されたホスト名に対応したネットワークアダプタまたはIPアドレスを使用します。

注意事項

複数のIPアドレスを持っているホストで，複数のIPアドレスを同一ネットワークに接続する場合，dcbindht定義コマンドの-hオプションで指定するホスト名をmy_hostオペランドにも指定してください。

-hオプションに指定するホスト名は，-nオプションに指定したネットワーク上のノードで指定する次の値と一致させてください。一致していない場合，複数のコネクションを使用したり，不要な通信が発生したりするおそれがあります。

システム共通定義のall_nodeオペランド，all_node_exオペランドに指定するノード名

ドメイン定義ファイルに指定するノード名

ユーザサービスネットワーク定義のdcsvgdefコマンドに指定するホスト名

dc_rpc_call_to関数の引数directionに指定するホスト名

ノード自動追加機能を使用する場合，-hオプションにすべて同じホスト名を指定してください。また，指定したホスト名をmy_hostオペランドにも指定してください。-hオプションに異なるホスト名を指定したときや，my_hostオペランドの指定値と異なるとき，ノード自動追加機能が正しく機能しないことがあります。

1ホスト内で複数のOpenTP1が稼働し，IPアドレスを引き継ぐ系切り替え構成の場合は，必ずこの指定を定義してください。指定を省略した場合，目的のOpenTP1と通信できないことがあります。

図3-2で示す構成では，OpenTP1 BからOpenTP1 Aへの通信にはIPアドレスip=aまたはip=xを使用します。

OpenTP1は，サービスの要求を受けると，サービスのアドレス情報を取得するために使用したIPアドレスを記憶します。

IPアドレスip=xを使用してアドレス情報を取得したあとに，系切り替えが発生すると，IPアドレスip=xはOpenTP1 XからOpenTP1 X’に引き継がれますが，一方で，OpenTP1 Bはアドレス情報を取得した時に使用したIPアドレスをip=xと記憶したままです。この状態でサービス要求を送信すると，OpenTP1 Aに送信したはずのサービス要求が，OpenTP1 X’に送信されてしまうことがあります（図3-3）。

目的のOpenTP1と通信するためには，次のように定義して通信に使用するネットワークアダプタを特定してください。

OpenTP1 Aでは

dcbindht　-h　HOST_A　-n　NETL

OpenTP1 Xでは

dcbindht　-h　HOST_X　-n　NETL

図3‒2　系切り替え前の通信形態

dcbindht定義コマンドを指定すると，OpenTP1 Aへの通信にはIPアドレスip=aを使い，OpenTP1 Xへの通信にはIPアドレスip=xを使って通信します。

図3‒3　系切り替え後の通信形態

ロックサービス定義

形式

set形式

〔set lck_limit_foruser=ユーザサーバの最大同時排他要求数〕
〔set lck_limit_fordam=DAMサービスの最大同時排他要求数〕
〔set lck_limit_fortam=TAMサービスの最大同時排他要求数〕
〔set lck_limit_formqa=MQAサービスの最大同時排他要求数〕
〔set lck_wait_timeout=排他待ち限界経過時間〕
〔set lck_deadlock_info=Y|N〕
〔set lck_deadlock_info_remove=normal|force|no〕
〔set lck_deadlock_info_remove_level=デッドロック情報ファイルとタイム
                                     アウト情報ファイルの削除レベル〕
〔set lck_release_detect=interval|pipe〕
〔set lck_release_detect_interval=排他解除検知インタバル最大時間〕
〔set lck_prf_trace_level=LCK性能検証用トレース情報の取得レベル〕

コマンド形式

なし。

機能

OpenTP1システムで排他制御機能を使用するための実行環境を定義します。

説明

set形式のオペランド

●lck_limit_foruser=ユーザサーバの最大同時排他要求数

　〜〈符号なし整数〉((0〜327670))《512》

このノード上にあるユーザサーバから同時に発生する排他要求数の最大値を指定します。0を指定した場合は，排他制御機能は使用できません。

●lck_limit_fordam=DAMサービスの最大同時排他要求数

　〜〈符号なし整数〉((0〜655340))《512》

このノード上にあるDAMサービスから同時に発生する排他要求数の最大値を指定します。排他要求数の計算式を次に示します。

注※

damrmコマンドで使用します。

t：同時に実行するトランザクションの数

p：回復対象外アクセスで同時に実行するプロセスの数

T：1トランザクションブランチでオープンするファイル数＋参照，更新するブロック数

P：回復対象外アクセス処理の1プロセスでオープンするファイル数＋参照，更新するブロック数

●lck_limit_fortam=TAMサービスの最大同時排他要求数

　〜〈符号なし整数〉((0〜327670))《512》

このノード上にあるTAMサービスから発生する排他要求数の最大値を指定します。排他要求数の計算式を次に示します。

t：同時に実行するトランザクションの数

T：1トランザクションで参照，更新をするテーブル数

R：1トランザクションで参照，更新をするレコード数

●lck_limit_formqa=MQAサービスの最大同時排他要求数

　〜〈符号なし整数〉((0〜327670))《0》

このノード上にあるMQAサービスから同時に発生する排他要求数の最大値を指定します。排他要求数の計算式については，マニュアル「TP1/Message Queue 使用の手引」の定義情報の作成手順に関する記述を参照してください。

●lck_wait_timeout=排他待ち限界経過時間

　〜〈符号なし整数〉((0〜32767))《0》（単位：秒）

排他要求が待ち状態になってから解除されるまでの排他待ち時間を監視する限界経過時間を指定します。

指定時間を経過しても待ち状態が解除されない場合，ロックサービスは待ち時間の超過として，排他要求をエラーリターンします。

0を指定した場合は，排他待ちの時間監視をしません。

●lck_deadlock_info=Y|N

　〜《Y》

デッドロック情報とタイムアウト情報を出力するかどうかを指定します。

OpenTP1はデッドロック，またはタイムアウトが発生するたびに$DCDIR/spool/dclckinfの下にファイルを作成して，情報を出力します。不要となったファイルは削除してください。

Y

デッドロック情報とタイムアウト情報を出力します。

N

デッドロック情報とタイムアウト情報を出力しません。

●lck_deadlock_info_remove=normal|force|no

　〜《no》

OpenTP1開始時に，デッドロック情報ファイルとタイムアウト情報ファイルを削除するかどうかを指定します。

normal

OpenTP1正常開始時に，削除します。

force

OpenTP1開始時に，削除します。

no

OpenTP1開始時に，削除しません。

●lck_deadlock_info_remove_level=デッドロック情報ファイルとタイムアウト情報ファイルの削除レベル

　〜〈符号なし整数〉((0〜24855))《0》（単位：日）

デッドロック情報ファイルとタイムアウト情報ファイルの削除レベルを指定します。

lck_deadlock_info_removeオペランドでnormalかforceを指定した場合に有効です。

0

全ファイルを削除します。

1〜24855

ロックサービス開始時刻から起算して「指定値×24」時間以前に作成されたファイルを削除します。

●lck_release_detect=interval|pipe

　〜《pipe》

排他が競合した場合，占有しているプロセスがいつ排他を解除したかを調べる方法を指定します。プロセスが排他待ちとなった場合に有効です。

interval

共用メモリの排他管理用領域を一定間隔で調べます。

50ミリ秒からlck_release_detect_intervalオペランドの指定値まで，徐々に間隔を大きくして占有プロセスが排他を解除したかを調べます。

排他占有プロセスが排他を解除しても，次のインタバルまで検索できないため，排他待ち時間が長くなる場合があります。

pipe

pipeファイルを使用して排他解除を調べます。

占有プロセスから排他待ちプロセスに，排他解除が通知されます。したがって，排他占有プロセスが排他を解除したとき，排他待ちプロセスは排他解除を検知できます。

排他が競合したトランザクションのダイナミックステップ数は，interval指定時より増加します。

OpenTP1では，次の計算式の値分のpipeファイルを同時に使用する場合がありますので，ファイル記述子の見積もりに次の計算式の値を加えてください。

同時に排他を占有するプロセス数＋同時に排他待ちになるプロセス数＋トランザクション回復プロセス数

●lck_release_detect_interval=排他解除検知インタバル最大時間

　〜〈符号なし整数〉((10〜60000))《250》（単位：ミリ秒）

排他待ちプロセスが，排他解除を調べるインタバルの最大時間を指定します。lck_release_detectオペランドにintervalを指定した場合に有効です。

50より大きな値を指定すると，50ミリ秒からこの指定値になるまで徐々に間隔を大きくして，プロセスの排他解除を調べます。50以下の値を指定すると，指定された時間間隔でプロセスの排他解除を調べます。統計情報を基に指定値を決定してください。

●lck_prf_trace_level=LCK性能検証用トレース情報の取得レベル

　〜((00000000〜00000001))《00000000》

LCK性能検証用トレースの取得レベルを指定します。

LCK性能検証用トレースの詳細については，マニュアル「OpenTP1 解説」の障害の原因解析の説明を参照してください。

00000000

LCK性能検証用トレースを取得しません。

00000001

LCK性能検証用トレースを取得します。

取得したトレースをファイル出力または編集出力するには，prfgetコマンド，prfedコマンド，またはdcalzprfコマンドを使用します。ファイルの出力結果は，$DCDIR/spool/dclckinf/prfに保存されます。これらのコマンドの詳細については，マニュアル「OpenTP1 運用と操作」を参照してください。

このオペランドの使用は，TP1/Extension 1をインストールしていることが前提です。TP1/Extension 1をインストールしていない場合の動作は保証できません。

コマンド形式

なし。

タイマサービス定義

形式

set形式

〔set tim_watch_count=最大時間監視サービス数〕

コマンド形式

なし。

機能

時間監視サービスを行うための実行環境を定義します。

説明

set形式のオペランド

●tim_watch_count=最大時間監視サービス数

　〜〈符号なし整数〉((0〜65535))《128》

最大時間監視サービス数を指定します。

OpenTP1システムでは，トランザクションブランチ処理内，およびMHP内で時間監視をします。また，サービス関数の実行時間を監視します。最大時間監視サービス数の計算式を次に示します。

最大時間監視サービス数＝A＋B＋C＋D

A：同時に起動するトランザクションブランチ数

トランザクションサービス定義のtrn_tran_process_countオペランドの指定値。

B：非トランザクションMHP限界経過時間の監視を指示したMHPプロセス数

次に示す条件を両方とも満たすMHPを同時に実行する数。

アプリケーション属性定義（mcfaalcap）の-nオプションで，trnmodeオペランドにnontrnを指定

アプリケーション属性定義（mcfaalcap）の-vオプションまたはUAP共通定義（mcfmuap）の-uオプションで，ntmetimオペランドに0以外の値を指定

C：サービス関数実行時間の監視を指示したSPPプロセス数

ユーザサービス定義，ユーザサービスデフォルト定義のservice_expiration_timeオペランドが有効になるSPPプロセス数。SPPをマルチサーバで運用する場合は，ユーザサービス定義，またはユーザサービスデフォルト定義のparallel_countオペランドの指定値を加算してください。

D：トランザクション完了限界時間の監視を指示したプロセス数

trn_completion_limit_timeオペランド※が有効となる，次に示すプロセス数の合計値。

トランザクションを実行するSUP，SPPおよびMHPのプロセス数。SPPおよびMHPをマルチサーバで運用する場合は，ユーザサービス定義，またはユーザサービスデフォルト定義のparallel_countオペランドの指定値を加算してください。

トランザクショナルRPC実行プロセス数。クライアントサービス定義のparallel_countオペランドの指定値を加算してください。

トランザクションを実行するCUP実行プロセス数。クライアントサービス定義のcup_parallel_countオペランドの指定値を加算してください。

トランザクションを実行するrapサーバ数。rapサーバをマルチサーバで運用する場合は，rapリスナーサービス定義のrap_parallel_serverオペランドの指定値を加算してください。

注※

ユーザサービス定義，ユーザサービスデフォルト定義，rapリスナーサービス定義，クライアントサービス定義，またはトランザクションサービス定義のtrn_completion_limit_timeオペランドです。

同一ノード内にトランザクションサービス，MCF，およびサービス関数実行時間の監視を指定したSPPがない場合は，0を指定します。

0を指定した場合，タイマサービスは時間監視サービスをしません。

ここで指定した値を超えて時間監視サービスを要求された場合，タイマサービスはサービスを提供できなくなります。トランザクションブランチ処理時間を監視できない場合はトランザクション開始を要求するAPIをエラーリターンさせます。また，サービス関数の実行時間またはトランザクション完了限界時間を監視できない場合は，エラーメッセージを出力して処理を続行します。

コマンド形式

なし。

ネームサービス定義

形式

set形式

〔set name_total_size=サービス情報領域の大きさ〕
〔set name_cache_size=サービス情報キャッシュ領域の大きさ〕
〔set max_socket_descriptors=ソケット用ファイル記述子の最大数〕
〔set name_global_lookup=Y|N〕
〔set name_service_extend=1|0〕
〔set name_audit_conf=2|1|0〕
〔set name_audit_interval=監視間隔時間〕
〔set name_audit_watch_time=ノードダウンを検知するまでの最大待ち時間〕
〔set name_rpc_control_list=Y|N〕
〔set name_nodeid_check_message=Y|N〕
〔set name_cache_validity_time=他ノードのサービス情報の有効時間〕
〔set watch_time=最大応答待ち時間〕
〔set name_start_watch_time=OpenTP1起動時のノードリスト要求応答待ち時間〕
〔set name_start_retry_count=OpenTP1起動時のノードリスト要求リトライ回数〕
〔set name_start_retry_interval=OpenTP1起動時のノードリスト要求リトライ間隔〕
〔set name_start_error= stop|continue〕
〔set name_sync_ready_time=ノードリスト同期待ち時間〕

コマンド形式

〔namnlfil　‐{r|n}　ノードリストファイル名〕

機能

RPCを可能にするサービス名とアドレスの対を管理するための実行環境を定義します。

ネームサービスは，ここで指定するサービス情報領域とサービス情報キャッシュ領域の大きさを加算した領域を，システム環境定義で指定した静的共用メモリの中から確保します。

説明

set形式のオペランド

●name_total_size=サービス情報領域の大きさ

　〜〈符号なし整数〉((1〜32767))《64》（単位：キロバイト）

自ノードのネームサービスが確保するサービス情報領域の大きさを指定します。ノード自動追加機能を使用する場合は，必ず指定します。

サービス情報領域の大きさは，システムサービスとユーザサーバで登録するサービス情報の数を基に計算します。計算式については，「付録B.1　TP1/Server Base用の共用メモリの見積もり式」を参照してください。

ノード自動追加機能を使用する場合の計算式を次に示します。

システム共通定義のname_service_modeオペランドにmanager，またはagentを指定した場合

name_total_size=↑(7936＋all_node_exのノード数×284
                 ＋all_node_ex_extend_numberオペランドの指定値※1
                    ×284
                 ＋163840
                 ＋((SPP数※2＋rapサーバ数※3＋XATMI数※4)×264)
                 ＋MCF※5＋DAM※6＋TAM※7＋CLT※8)／1024↑

システム共通定義のname_service_modeオペランドを省略，またはnormalを指定した場合

name_total_size=↑(7616＋(all_nodeのノード数×384
                 ＋all_node_exオペランドの指定値
                    ×284
                 ＋all_node_extend_numberオペランドの指定値※9×384
                 ＋all_node_ex_extend_numberオペランドの指定値※1
                    ×284)
                 ＋((SPP数※2＋rapサーバ数※3＋XATMI数※4)×264)
                 ＋MCF※5＋DAM※6＋TAM※7＋CLT※8)／1024↑

（凡例）

↑↑：小数点以下を切り上げます。

注※1

システム共通定義のall_node_ex_extend_numberオペランドを省略した場合は64になります。

注※2

サービスグループの数になります。

注※3

rapサーバを起動する場合は，rapサービス数を指定します。

注※4

XATMIインタフェースの関数を使用する場合は，XATMIのSPPで定義したサービスの総数になります。

注※5

TP1/Message Controlを使用する場合は，次の算出式で求めた値になります。

（1＋MCF通信サービスの数
＋アプリケーション起動サービスの数
＋マッピングサービスの数
（TP1/NET/XMAP3を使用する場合は，1になります。使用しない場合は，0になります。）
＋MCFオンラインコマンドサービスの数
（TP1/NET/XMAP3を使用する場合は，1になります。使用しない場合は，0になります。）
＋MHPのサービスグループ数）×264

注※6

TP1/FS/Direct Accessを使用する場合は，936になります。

注※7

TP1/FS/Table Accessを使用する場合は，1424になります。

注※8

クライアント拡張サービス機能を使用する場合は，936になります。

注※9

システム共通定義のall_node_extend_numberオペランドを省略した場合は64になります。

●name_cache_size=サービス情報キャッシュ領域の大きさ

　〜〈符号なし整数〉((1〜32767))《16》（単位：キロバイト）

自ノードのネームサービスが確保するサービス情報キャッシュ領域の大きさを指定します。

サービス情報キャッシュ領域の大きさは，他ノードに登録されているサービス情報のうち，自ノードから検索を要求するサービス情報の数を基に計算します。計算式については，「付録B.1　TP1/Server Base用の共用メモリの見積もり式」を参照してください。

ノード自動追加機能を使用する場合の計算式を次に示します。

システム共通定義のname_service_modeオペランドにmanager，またはagentを指定した場合

name_cache_size=↑(ノードリストに登録されているノードおよび
                 all_node_exオペランドに指定したノード※1で起動する
                 SPP数※2の総計
                ×224）／1024↑

システム共通定義のname_service_modeオペランドを省略，またはnormalを指定した場合

name_cache_size=↑(all_nodeオペランドおよび
                 all_node_exオペランドに指定したノード※3で起動する
                 SPP数※2の総計
                ×224）／1024↑

（凡例）

↑↑：小数点以下を切り上げます。

注※1

システム共通定義のall_node_exオペランドに指定したノードか，またはドメイン定義ファイルに指定したノードです。

注※2

サービスグループの数になります。

注※3

システム共通定義のall_nodeオペランド，およびall_node_exオペランドに指定したノードか，またはドメイン定義ファイルに指定したノードです。

ネームサービスは，サービス情報領域が不足したとき，サービス情報キャッシュ領域をサービス情報領域として使用することがあります。逆に，サービス情報領域をサービス情報キャッシュ領域として使用することはありません。

サービス情報キャッシュ領域を大きくすると，他ノードのサービス情報を検索するときの応答性能が向上します。

ただし，必要以上に大きくすると，OpenTP1システム全体のメモリを圧迫します。

●max_socket_descriptors=ソケット用ファイル記述子の最大数

　〜〈符号なし整数〉((32〜2032))

OpenTP1制御下のプロセスでのソケット用に使用するファイル記述子の最大数を指定します。

指定値の範囲は，適用OSがAIX，HP-UXまたはWindowsの場合は32〜2032，適用OSがSolarisまたはLinuxの場合は32〜1008です。

ネームサーバは，システムサーバやユーザサーバとの間で，ソケットを使用したTCP/IP通信でプロセス間の情報交換をしています。そのため，同時に稼働するUAPプロセスの数，および通信する他ノードの数によって，このオペランドを変更する必要があります。

ソケット用ファイル記述子の最大数の算出式を，次に示します。

システム共通定義のname_service_modeオペランドにmanager，またはagentを指定した場合

適用OSがAIX，HP-UXまたはWindowsの場合は2032を指定してください。

適用OSがSolarisまたはLinuxの場合は1008を指定してください。

システム共通定義のname_service_modeオペランドを省略，またはnormalを指定した場合

↑（A＋B×2＋C×2＋D＋E）／0.8↑

計算式の凡例を次に示します。

↑↑：小数点以下を切り上げます。

A：自ノードのOpenTP1システム内で，次の1.〜5.の合計値

OpenTP1の開始から終了までに起動するUAPのプロセス数

クライアントサービス定義のparallel_countオペランド指定値（最大プロセス数）

システムサービスプロセス数

システムサービスプロセス数については，マニュアル「OpenTP1 解説」のOpenTP1のプロセス構造の記述を参照してください。

次のどちらかの値

システム共通定義のname_domain_file_useオペランドにNを指定している場合

システム共通定義のall_nodeオペランドとall_node_exオペランドに指定しているノードの数

システム共通定義のname_domain_file_useオペランドにYを指定している場合

ドメイン定義ファイル（$DCCONFPATH/dcnamnd，および$DCCONFPATH/dcnamndexディレクトリ下のファイル）に指定しているノードの数

自ノードで稼働するUAPで，dc_rpc_call_to関数を実行する場合のあて先に指定しているノード数

ただし，Aの4.の指定と重複したノードは除きます。

B：システム共通定義のname_domain_file_useオペランドにNを指定した他ノードで，自ノード名をシステム共通定義のall_nodeオペランドまたはall_node_exオペランドに指定しているノードの合計数

C：システム共通定義のname_domain_file_useオペランドにYを指定した他ノードで，自ノード名をドメイン定義ファイル（$DCCONFPATH/dcnamnd，および$DCCONFPATH/dcnamndexディレクトリ下のファイル）に指定しているノードの合計数

D：自ノード名をdc_rpc_call_to関数のあて先に指定したUAPが稼働する他ノード数

ただし，Aの4.，5.，およびBの指定値と重複したノードを除きます。

E：自ノードのネームサービスのポート番号に接続するCUPプロセス数，およびスレッド数の合計値

このオペランドの指定が小さいと，OpenTP1制御下の他プロセスとのコネクションが設定できなくなるため，ネームサービスがKFCA00307-Eメッセージを出力して異常終了（システムダウン）します。

指定値の優先順位は次のとおりです（1.＞2.）。

ネームサービス定義

システム共通定義

ここで指定を省略した場合，システム共通定義の値を仮定します。

●name_global_lookup=Y|N

　〜《N》

グローバル検索機能を使用するかどうかを指定します。

グローバル検索機能とは，all_nodeオペランドで指定された各ノード上のネームサービスがキャッシュしている他ノードのサービス情報を取得する機能です。

Y

グローバル検索機能を使用します。

N

グローバル検索機能を使用しません。

グローバル検索機能使用時のシステム構成例を次の図に示します。

図3‒4　グローバル検索機能使用時のシステム構成

この図で示したシステム構成例の場合に，各OpenTP1ノードで指定するオペランドの値を次の表に示します。

表3‒3　グローバル検索機能を使用したシステムのオペランドの指定値

OpenTP1ノード名

all_nodeオペランドの指定値

name_global_lookupオペランドの指定値

OpenTP1-A

B，C

Y

OpenTP1-B

A，C，D，E

N

OpenTP1-C

A，B，F，G

N

OpenTP1-D

B，E

N

OpenTP1-E

B，D

N

OpenTP1-F

C，G

N

OpenTP1-G

C，F

N

OpenTP1-Aからの検索範囲は，OpenTP1-B〜OpenTP1-Gとなります。つまり，OpenTP1システム1だけでなく，OpenTP1システム2および3までのサービスと通信できるようになります。

グローバル検索機能を使用した環境では，DCRPC_BINDTBL_SET関数の引数portnoにネームサービスのポート番号を指定した，dc_rpc_call_to関数は使用できません。

DCRPC_BINDTBL_SET関数の引数nidにノード識別子を指定した，dc_rpc_call_to関数を使用する場合は，必ずグローバル検索機能の検索範囲（図のOpenTP1システム1〜3）内のすべてのOpenTP1ノードのノード識別子を一意に定義してください。

サービス情報（閉塞，負荷状態など）は，検索元OpenTP1（図のOpenTP1-A）まで通知されないため，図のように水平分散を利用したサービス要求を行うことをお勧めします。

ネームサービス定義のname_cache_sizeオペランドの指定値は，自ノードから検索を要求するサービス情報の数に，all_nodeオペランドで指定されたノードにキャッシュされるサービス情報の数まで含めて算出する必要があります。

グローバル検索機能を使用したOpenTP1（図のOpenTP1-A）に対し，TP1/Client/P，TP1/Client/WまたはTP1/Client/Jからサービス要求が送信された場合，OpenTP1システム1だけでなく，OpenTP1システム2および3のサービス情報まで取得します。

グローバル検索機能の詳細については，マニュアル「OpenTP1 解説」を参照してください。

●name_service_extend=1|0

　〜《0》

ネームサービスで管理するサーバUAPの取得数を拡張します。このオペランドに1を指定した場合，RPC先の各ノードで起動する同一サービスグループ名のサーバUAPに対し，RPC先の対象を最大512にできます。ただし，RPC先の各ノードは，all_nodeオペランドで指定したOpenTP1システムに含まれている必要があります。このオペランドに0を指定した場合，または指定を省略した場合，RPC先の対象は，最大128のままになります。

●name_audit_conf=2|1|0

　〜《0》

ノード監視機能を使用するかどうかを指定します。ノード監視機能の詳細については，マニュアル「OpenTP1 解説」を参照してください。

2

送受信型ノード監視機能を使用します。

1

一方送信型ノード監視機能を使用します。

0

ノード監視機能を使用しません。

このオペランドを指定する場合，次の点に注意してください。

この機能は，ノードごとにユニークなIPアドレスが割り振られていることを前提としているため，同じIPアドレスを使用するノードをシステム共通定義のall_nodeオペランドまたはall_node_exオペランドに複数指定しているノードや，系切り替え後に同一のIPアドレスで複数のOpenTP1が起動する（1LANボードだけ使用時など）ノードに対しては，ノード監視機能は使用できません。

ノード監視機能の監視用通信処理で，ノードダウン検知の感度をチューニングする場合，次の定義オペランドを変更してください。

name_audit_confに1を指定した場合

システム共通定義のipc_conn_intervalを変更してください。

name_audit_confに2を指定した場合

ネームサービス定義のname_audit_watch_timeを変更してください。

ノード監視機能で同時に監視できるノード数は60ノードまでです。システム共通定義のall_nodeオペランド，およびall_node_exオペランドに指定したノード数が60を超える場合，60ノード単位で監視を繰り返します。

システム共通定義のall_nodeオペランド，およびall_node_exオペランドに多くのノードを指定している場合，ノード監視機能を使用するとUAPで実行するRPCに影響を及ぼす場合があります。この場合，name_audit_intervalオペランドに小さい値を指定しないでください。

name_rpc_control_listオペランドを省略するか，Yを指定した場合，name_audit_intervalオペランドに指定した時間が経過していなくても，障害から復旧したノードがRPC抑止リストから削除されることがあります。この場合，KFCA00651-Iメッセージは出力されません。

name_rpc_control_listオペランドを省略するか，Yを指定した場合でname_audit_confオペランドに2を指定しているとき，KFCA00650-Iメッセージが定期的に出力されることがあります。

name_audit_confオペランドに1または2を指定し，かつname_audit_intervalオペランドに180以下を指定した場合，name_rpc_control_listオペランドにNを指定することをお勧めします。

name_audit_confオペランドを省略するか，または0を指定した場合，name_rpc_control_listオペランドにNを指定したときは，ノード監視機能およびRPC抑止リストへの監視機能は無効になるので次に示す状態になります。

RPC抑止リストに登録したノードから自ノードに対して通信が発生しないかぎり，RPC抑止リストから該当ノードは削除されません。

RPC抑止リストに登録したノードのall_nodeオペランドに自ノードを指定していない場合，自ノードのOpenTP1を再起動しないかぎり，RPC抑止リストから該当ノードが削除されません。

上記の状態を防ぐためには，name_audit_confオペランドを省略するか，または0を指定した場合，name_rpc_control_listオペランドを省略するか，Yを指定することをお勧めします。

ノード自動追加機能を使用する場合，次の点に注意してください。

システム共通定義のname_service_modeオペランドにmanagerを指定した場合，このオペランドの指定を無視して，送受信型ノード監視機能によって，エージェントノードとノーマルノードの稼働状況を監視します。そのため，同一ホストで複数のエージェントノードやノーマルノードを動作させる場合は，一つのホストに複数の異なるIPアドレスを設定し，それぞれのノードに異なるIPアドレスを設定してください。

システム共通定義のname_service_modeオペランドにagentを指定した場合，システム共通定義のname_manager_nodeオペランドにマネジャノードを指定してください。また，ネームサービス定義のname_audit_confオペランドの指定内容によって，次の動作をします。

name_audit_confオペランドを省略した場合，または0を指定したとき

送受信型ノード監視機能によって，マネジャノードの稼働状況を監視します。同時にノードリストの整合性を確保します。

name_audit_confオペランドに1，または，2を指定したとき

送受信型ノード監視機能によって，指定値を無視してマネジャノードの稼働状況を監視します。同時にノードリストの整合性を確保します。エージェントノード，およびノーマルノードとのノード監視は指定値に従って監視します。

同一ホストで複数のマネジャノードを動作させる場合は，一つのホストに複数の異なるIPアドレスを設定し，それぞれのマネジャノードに異なるIPアドレスを設定してください。

●name_audit_interval=監視間隔時間

　〜〈符号なし整数〉((1〜65535))《60》（単位：秒）

監視サービスのノード監視が終了したあと，次の監視を開始するまでの時間を指定します。

ノード自動追加機能を使用する場合の動作は次のとおりです。

マネジャノードの場合，このオペランドの指定間隔でエージェントノードおよびノーマルノードの稼働状況を監視します。

エージェントノードの場合，このオペランドの指定間隔で，次の動作をします。

マネジャノードの稼働状況を監視します。

1.と同時にマネジャノードに対してノードリスト要求を行い，マネジャノードとの間でノードリストの整合性を取ります。

ほかのエージェントノードおよびノーマルノードの稼働状況の監視は，name_audit_confオペランドの指定に従って行います。

このオペランドには，マネジャノードのネームサービス定義のname_sync_ready_timeオペランドの指定値と同じ値を指定してください。指定値が異なると，エージェントノードのノードリストから不当にノード情報が削除されることがあります。また，マネジャノードとエージェントノードとの間で，ノードリストの整合性が取られるまでに時間が掛かるおそれがあります。

●name_audit_watch_time=ノードダウンを検知するまでの最大待ち時間

　〜〈符号なし整数〉((8〜65535))《8》（単位：秒）

name_audit_confオペランドに2（送受信型ノード監視）を指定した場合，監視対象のノードから応答が返るまでの待ち時間の最大値を指定します。なお，name_audit_confオペランドに1を指定した場合，システム共通定義のipc_conn_intervalオペランドに指定した値がノードダウンを検知するまでの時間となります。

ノード自動追加機能を使用する場合は，次の動作をします。

マネジャノードでは，監視対象のノードから応答が返るまでの待ち時間の最大値となります。

エージェントノードでは，次の動作をします。

マネジャノードを認識するまでは，name_manager_nodeオペランドに指定したノードから応答が返るまでの応答待ち時間の最大値となります。

マネジャノード認識後は，監視対象のノードから応答が返るまでの待ち時間の最大値となります。

●name_rpc_control_list=Y|N

　〜《Y》

RPC抑止リストに登録されたノードの監視機能を使用するかどうかを指定します。

Y

RPC抑止リストに登録されたノードの監視機能を使用します。監視する時間の間隔は180秒です。

N

RPC抑止リストに登録されたノードの監視機能を使用しません。

ネームサービスでは，ノード監視機能とは別に180秒ごとにRPC抑止リストに登録されたノードの起動状況を確認できます。この機能の使用有無を，このオペランドで指定します。

ノードの監視機能の設定を考慮して，この機能を使用してください。例えば，次に示す状態の場合，RPC抑止リストに登録されたノードの監視機能を無効にする必要があります。

name_audit_intervalオペランドに指定した時間が経過していなくても，障害から復旧したノードがRPC抑止リストから削除されることがあります。この場合，KFCA00651-Iメッセージは出力されません。

name_audit_confオペランドに2を指定している場合，KFCA00650-Iメッセージが定期的に出力されることがあります。

RPC抑止リストに登録されたノードの監視機能を無効にした場合で，name_audit_intervalオペランドに指定した時間が180秒以上のとき，障害から復旧したノードがRPC抑止リストから削除されるまでの時間は，RPC抑止リストに登録されたノードの監視機能を使用した場合よりも長くなります。

次に示す条件を満たす場合は，このオペランドにNを指定することをお勧めします。

name_audit_confオペランドに1または2を指定

name_audit_intervalオペランドに180以下を指定

name_audit_confオペランドを省略するか，または0を指定した場合，name_rpc_control_listオペランドにNを指定したときは，ノード監視機能およびRPC抑止リストへの監視機能は無効になるので次に示す状態になります。

RPC抑止リストに登録したノードから自ノードに対して通信が発生しないかぎり，RPC抑止リストから該当ノードは削除されません。

RPC抑止リストに登録したノードのall_nodeオペランドに自ノードを指定していない場合，自ノードのOpenTP1を再起動しないかぎり，RPC抑止リストから該当ノードが削除されません。

上記の状態を防ぐためには，name_audit_confオペランドを省略するか，または0を指定した場合，name_rpc_control_listオペランドを省略するか，Yを指定することをお勧めします。

●name_nodeid_check_message=Y|N

　〜《Y》

自ノードと同じノード識別子を指定したノードから通信を受信した場合に，KFCA00677-Wメッセージを出力するかどうかを指定します。

Y

KFCA00677-Wメッセージを出力します。

N

KFCA00677-Wメッセージを出力しません。

●name_cache_validity_time=他ノードのサービス情報の有効時間

　〜〈符号なし整数〉((0〜65535))《1800》（単位：秒）

他ノードから取得したサーバUAPのサービス情報の有効時間を指定します。ネームサービスでは，次に示す場合に，他ノードで起動しているサーバUAPのサービス情報を取得します。

RPC先となるサービスグループに対して，そのノードで初めてRPCを実行した場合

他ノードでサーバUAPが起動された場合

他ノードからサービス情報を取得した時点からこのオペランドに指定した時間内は，他ノードに対してサービス情報を検索しないでRPCを実行します。RPC実行時に，サービス情報の有効時間がこのオペランドに指定した時間を超過していた場合，システム共通定義のall_nodeオペランドに指定したノードからサービス情報を新たに取得し，すでに登録されているサービス情報を更新します。また，サービス情報の有効時間内でも，他ノードからサービス情報の更新通知を受けると，サービス情報は更新されます。

name_cache_validity_timeオペランドの指定値を変更する場合の注意事項を次に示します。

0を指定した場合

サービス情報の有効時間満了時でもサービス情報を取得しません。

デフォルト値より小さい値（1〜1799）を指定した場合

サービス情報の有効時間が短くなるため，RPC実行時に他ノードのネームサービスとのサービス情報のやり取りが多くなり，他ノードとの通信トラフィックが高くなります。この場合，グローバルキャッシュを更新する間隔を短くすることで，システム共通定義のall_nodeオペランドで指定されたノードのサービス情報変化の検知が早まります。

極端に小さい値を指定した場合，各ノードのネームサービスの負荷が上がり，サービス情報の検索などネームサービスの機能が利用できなくなることがあります。

デフォルト値より大きい値（1801〜65535）を指定した場合

サービス情報の有効時間が長くなるため，RPC実行時に他ノードのネームサービスとのサービス情報のやり取りが少なくなり，他ノードとの通信トラフィックが低くなります。他ノードで起動しているサーバUAPのサービス情報を取得する契機が少なくなるため，任意のノードで起動しているサーバUAPへRPCが実行されないなどの現象が発生することがあります。

ノード自動追加機能の使用時に，このオペランドに小さな値を指定すると，ノードリストの参照が頻繁に動作します。このとき，ノードリストからの削除が実行されないことが多くなります。

●watch_time=最大応答待ち時間

　〜〈符号なし整数〉((0〜65535))（単位：秒）

RPCによってプロセス間で通信する場合，サービス要求を送信してからサービスの応答が返るまでの待ち時間の最大値を指定します。

クライアントUAPが他ノードのサーバUAPにサービスを要求する形態の場合，このオペランドを指定してください。他ノードのサーバUAPへサービスを要求する概要と，このオペランドが適用されるRPC通信個所を次の図に示します。

図3‒5　他ノードのサーバUAPへのサービス要求概要

このオペランドには，クライアントUAPの最大応答待ち時間よりも小さい値を指定してください。クライアントUAPの最大応答待ち時間と同じか，それよりも大きい値を指定した場合，他ノードのネームサービスの処理遅延によって，先にクライアントUAPプロセスのサービスの検索要求が送受信タイムアウトになります。

クライアントUAPに指定する最大応答待ち時間（図中A）には，他ノードへのサービス検索要求の送受信時間（図中B）も含める必要があります。

このオペランドの指定値とOpenTP1に登録しているノード数で，クライアントUAPに指定する最大応答待ち時間（図中A）を算出してください。

クライアントUAPに指定した最大応答待ち時間（図中A） ＞ ネームサービス定義のwatch_time（図中B） × OpenTP1に登録しているノード数※

注※　OpenTP1に登録しているノード数

ノード自動追加機能を使用する場合

マネージャノードが認識するエージェントノード，ノーマルノードの合計数

ノード自動追加機能を使用しない場合

all_nodeまたはドメイン定義ファイルに指定したノード数

OpenTP1の終了処理で，このオペランドで指定した時間だけ終了処理を待ち合わせる場合があります。したがって，大きな値を指定した場合，OpenTP1の終了処理に時間が掛かるときがあります。

指定時間を過ぎても応答がない場合は，RPCは送受信タイムアウトとしてエラーリターンします。

0を指定した場合は，応答を受信するまで待ち続けます。0を指定した場合，OpenTP1が終了しないときがあります。

省略した場合は，システム共通定義のwatch_timeオペランドの値を仮定します。

システム共通定義のwatch_timeオペランドのデフォルト値よりも，極端に小さな値または大きな値を指定すると，OpenTP1ダウンに至る障害が発生する場合がありますので，ご注意ください。

●name_start_watch_time=OpenTP1起動時のノードリスト要求応答待ち時間

　〜〈符号なし整数〉((0〜1800))《8》（単位：秒）

エージェントノードはOpenTP1の起動時に，マネジャノードに対してノードリスト要求をします。ノードリスト要求を送信してから，応答を受信するまでの待ち時間の最大値を指定します。指定時間を過ぎても応答がない場合は，ノードリスト要求はエラーとなります。エラー発生後の動作は，name_start_errorオペランドの指定値に従います。

このオペランドは，ノード自動追加機能を使用する場合に，エージェントノードで指定します。

0を指定した場合，応答を受信するまで無限に待ち続けます。

大きな値を指定した場合，マネジャノードの動作状況によっては，OpenTP1の開始処理に時間が掛かるおそれがあります。

●name_start_retry_count=OpenTP1起動時のノードリスト要求リトライ回数

　〜〈符号なし整数〉((0〜60))《0》

エージェントノードはOpenTP1の起動時に，マネジャノードに対してノードリスト要求をします。このノードリスト要求でエラーが発生した場合のリトライ回数を指定します。発生したエラーの回数が，指定した値を超えたときは，name_start_errorオペランドの指定に従った処理を実行します。

このオペランドは，ノード自動追加機能を使用する場合に，エージェントノードで指定します。

0を指定した場合，リトライしません。

大きな値を指定した場合，マネジャノードの動作状況によっては，OpenTP1の開始処理に時間が掛かるおそれがあります。

●name_start_retry_interval=OpenTP1起動時のノードリスト要求リトライ間隔

　〜〈符号なし整数〉((1〜60))《10》（単位：秒）

エージェントノードはOpenTP1の起動時に，マネジャノードに対するノードリスト要求をします。このノードリスト要求でエラーが発生した場合のリトライ間隔を指定します。

このオペランドは，ノード自動追加機能を使用する場合に，エージェントノードで指定します。また，ネームサービス定義のname_start_retry_countオペランドに1以上を指定した場合に有効となります。

大きな値を指定した場合，マネジャノードの動作状況によっては，OpenTP1の開始処理に時間が掛かるおそれがあります。

●name_start_error=stop|continue

　〜《continue》

エージェントノードがOpenTP1の起動時に，マネジャノードからノードリストを正常に受信できなかった場合の処理を指定します。

stop

OpenTP1の開始処理を中止します。

このとき，アボートコードnamdmnUを出力します。ただし，再開始（リラン）時は，OpenTP1の開始処理を続行します。

continue

OpenTP1の開始処理を続行します。

OpenTP1開始完了後，ネームサービス定義のname_audit_intervalオペランドに指定した間隔で，定期的にノードリスト要求を送信します。このときの応答待ち時間は，ネームサービス定義のname_audit_watch_timeオペランドに指定した値となります。マネジャノードからノードリストを受信するまでの間は，オペランドを指定したノードだけで動作します。

このオペランドは，ノード自動追加機能を使用する場合に，エージェントノードで指定します。

●name_sync_ready_time=ノードリスト同期待ち時間

　〜〈符号なし整数〉((0〜65535))《60》（単位：秒）

エージェントノードからRPCメッセージが受信できる状態になってから，エージェントノードとノードリストの整合性を取るまでの待ち時間を指定します。

このオペランドは，ノード自動追加機能を使用する場合に，マネジャノードで指定します。ただし，ノードリストを引き継ぐ場合，このオペランドの指定は無視します。

マネジャノードは，このオペランドに指定した時間が経過するまで，エージェントノードとノードリストの整合性を取りません。ただし，OpenTP1システム内に新たに追加されたエージェントノードに対してはノードリストを返します。

このオペランドには，エージェントノードのネームサービス定義のname_audit_intervalオペランド指定値と同じ値を指定してください。指定値が異なると，エージェントノードのノードリストから不当にノード情報が削除されることがあります。また，マネジャノードとエージェントノードとの間で，ノードリストの整合性が取られるまでに時間が掛かるおそれがあります。

コマンド形式

次ページ以降に記述しています。

namnlfil

名称

ノードリストファイルの指定

形式

〔namnlfil　‐{r|n}　ノードリストファイル名〕

機能

ノード自動追加機能を使用する場合に，ノードリストの引き継ぎ機能で使用するノードリストファイルを指定します。

OpenTP1の起動時に，ネームサービスは指定されたノードリストファイルに登録されているノードリストを採用してサービスを開始します。OpenTP1のオンライン中は，一定間隔で使用中のノードリストをノードリストファイルへ書き込みます。

なお，次の場合は，ノードリストの引き継ぎ機能は無効として，OpenTP1を起動します。

この定義を省略した場合

この定義に指定したノードリストファイルがない場合

この定義に指定したノードリストファイルへのアクセスに失敗した場合

この定義コマンドは，システム共通定義のname_service_modeオペランドの指定がmanagerまたはagentの場合だけ有効となります。

オプション

●-r

再開始時だけノードリストファイルを読み込みます。ただし，システム共通定義のname_service_modeオペランドの指定がagentの場合は，再開始時にマネジャノードからのノードリストの取得に失敗したときだけ，ノードリストファイルを読み込みます。

●-n

再開始時および（強制）正常開始時にノードリストファイルを読み込みます。ただし，システム共通定義のname_service_modeオペランドの指定がagentの場合は，再開始時および（強制）正常開始時にマネジャノードからのノードリストの取得に失敗したときだけ，ノードリストファイルを読み込みます。

コマンド引数

●ノードリストファイル名

　〜〈1〜63文字のパス名〉

ノードリストを格納するノードリストファイルのファイル名を完全パスで指定します。

プロセスサービス定義

形式

set形式

〔set prc_process_count=最大同時起動サーバプロセス数〕
〔set prc_recovery_resident=Y|N〕
〔set prc_take_over_svpath=Y|N〕
〔set prc_take_over_dlpath=Y|N〕
〔set term_watch_time=連続異常終了限界経過時間〕
〔set max_socket_descriptors=ソケット用ファイル記述子の最大数〕
〔set term_watch_count=連続異常終了限界回数〕
〔set prc_prf_trace=Y|N〕
〔set prc_coresave_path=コアファイル格納パス〕
〔set prc_corecompress=Y|N〕
〔set watch_time=最大応答待ち時間〕
〔set prc_hugepage_group_id=グループ識別子〕

コマンド形式

〔prcsvpath　パス名〕

機能

OpenTP1システム環境下で実行するサーバプロセスを管理するための実行環境を定義します。

プロセスサービス定義を変更した場合，OpenTP1を正常終了してdcresetコマンドを実行してください。

説明

set形式のオペランド

●prc_process_count=最大同時起動サーバプロセス数

　〜〈符号なし整数〉((1〜10000))《64》

同一OpenTP1ノード内で同時に起動するサーバプロセス数の最大値を指定します。ただし，実際に起動できる最大プロセス数は，OpenTP1を起動しているマシンに依存します。

なお，このオペランドを指定する場合は，実装するメモリ量やマシンで起動できる最大プロセスを考慮して，指定してください。

ここで指定するプロセス数は，OpenTP1システムで動作する常駐，および非常駐の全サーバ（ユーザサーバ，およびシステムサービス）プロセス数を指定します。プロセス数には，次のコマンドが含まれます。

dcstart

dcstop

dcsvstart

dcsvstop

dcstats

なお，ユーザサービス構成定義のdcsvstart定義コマンドは含まれません。

マルチサーバの場合は，起動する本数を加算します。

非常駐プロセスを指定しているユーザサーバやscdrsprcコマンドを使用すると，一時的に最大でユーザサービス定義のparallel_countオペランドの指定値の倍のプロセス数（常駐プロセス数と最大プロセス数を指定している場合は最大プロセス数の倍，常駐プロセス数だけを指定している場合は常駐プロセス数の倍）が起動されることがあります。

非常駐プロセスを指定しているユーザサーバ，およびscdrsprcコマンドで，倍のプロセス数が起動されるタイミングを次に示します。

非常駐プロセスを指定しているユーザサーバの場合

終了しようとしているプロセスが，dc_rpc_mainloop関数またはdc_mcf_mainloop関数の終了後からdc_rpc_close関数終了までの区間にある場合で，新たなサービス要求を受け付けたタイミング

scdrsprcコマンドで再起動するユーザサーバの場合

終了しようとしているプロセスが，dc_rpc_mainloop関数またはdc_mcf_mainloop関数の終了後からdc_rpc_close関数終了までの区間にある場合で，新たなプロセス起動を行ったタイミング

新たなプロセスが起動する契機については，マニュアル「OpenTP1 運用と操作」のscdrsprcコマンドの説明を参照してください。

システムサービスの場合は，ログサービス，ジャーナル関連（チェックポイントダンプ，システムジャーナルなど），MCF，およびMQシステムの数を指定します。

●prc_recovery_resident=Y|N

　〜《Y》

UAPが異常終了したときに部分回復するプロセスを常駐にするか，非常駐にするかを指定します。非常駐にすると，UAPがダウンするたびに部分回復するプロセスが起動されます。OpenTP1を動作させるときにメモリに余裕がない場合は，Yを指定，またはこのオペランドを省略してください。Yを指定，またはこのオペランドを省略した場合は，部分回復する常駐プロセスの数は一つです。

Y

部分回復するプロセスを常駐化します。

N

部分回復するプロセスを非常駐化します。

●prc_take_over_svpath=Y|N

　〜《N》

ノード内で，ユーザサーバおよびコマンドのパスをリラン時に引き継ぐかどうかを指定します。

Y

リラン時にユーザサーバおよびコマンドのパスを引き継ぎます。

N

リラン時にユーザサーバおよびコマンドのパスを引き継ぎません。

Yを指定すると，ユーザサーバおよびコマンドのパスを変更したあと，OpenTP1が正常開始するまでその変更が引き継がれます。

ユーザサーバおよびコマンドのパスの引き継ぎは，ノード内に限定されるので，系切り替え機能で切り替わった系には引き継がれません。

ユーザサーバおよびコマンドのパスの引き継ぎに失敗した場合は，警告メッセージを出力し，前回のオンライン中のユーザサーバおよびコマンドのパスの変更を引き継がないで処理を続行します。

●prc_take_over_dlpath=Y|N

　〜《N》

ノード内で，prcdlpathコマンドで設定したUAP共用ライブラリのサーチパスをリラン時に引き継ぐかどうかを指定します。

Y

リラン時にUAP共用ライブラリのサーチパスを引き継ぎます。

N

リラン時にUAP共用ライブラリのサーチパスを引き継ぎません。

Yを指定すると，prcdlpathコマンドでUAP共用ライブラリのサーチパスを変更したあと，OpenTP1が正常開始するまでその変更が引き継がれます。prcdlpathコマンドを複数回実行した場合は，最後に実行したprcdlpathコマンドで設定されたサーチパスだけが引き継がれます。

UAP共用ライブラリのサーチパスを変更したあと，OpenTP1を正常開始した場合は，その変更は引き継がれません。そのため，正常開始後に変更後のサーチパスに指定したディレクトリからUAP共用ライブラリを読み込みたい場合は，環境変数でライブラリサーチパスを設定してください。

UAP共用ライブラリのサーチパスの引き継ぎは，ノード内に限定されるので，系切り替え機能で切り替わった系には引き継がれません。

UAP共用ライブラリのサーチパスの引き継ぎに失敗した場合は，KFCA00734-Wメッセージを出力し，前回のオンライン中に行ったUAP共用ライブラリのパスの変更を引き継がないで処理を実行します。

前回のオンライン中に，何度もprcdlpathコマンドでサーチパスを変更しながらユーザサーバを開始していた場合，サーチパスは引き継がれていても，リラン時にユーザサーバが正常に開始できないことがあります。

●term_watch_time=連続異常終了限界経過時間

　〜〈符号なし整数〉((0〜32767))《10》（単位：分）

OpenTP1が異常終了した回数を監視する限界経過時間を指定します。0を指定した場合は，時間監視をしません。

指定時間内に3回連続してOpenTP1がシステムダウンした場合，プロセスサービスはKFCA00715-Eメッセージを出力して，システムの開始または再開始を中断します。この場合は，システムダウンをした要因を取り除いてから，dcsetupコマンドで一度OSへの登録を削除，再度登録するか，またはdcresetコマンドを入力してください。

システム環境定義のmode_confオペランドが「MANUAL2」の場合，プロセスサービスの連続ダウン以外はこのオペランドの指定は無効となります。

●max_socket_descriptors=ソケット用ファイル記述子の最大数

　〜〈符号なし整数〉((32〜2032))

OpenTP1制御下のプロセス※でのソケット用に使用するファイル記述子の最大数を指定します。

指定値の範囲は，適用OSがAIX，HP-UXまたはWindowsの場合は32〜2032，適用OSがSolarisまたはLinuxの場合は32〜1008です。

OpenTP1制御下のプロセス※は，システムサーバやユーザサーバとの間で，ソケットを使用したTCP/IP通信でプロセス間の情報交換をしています。そのため，同時に稼働するUAPプロセスの数，および通信する他ノードの数によって，このオペランドを変更する必要があります。

注※

MCFサービス（MCFマネジャサービス，MCF通信サービス，およびアプリケーション起動サービス）以外のOpenTP1プロセスが対象です。MCFサービスの場合は，「システムサービス情報定義」および「システムサービス共通情報定義」を参照してください。

ソケット用ファイル記述子の最大数の算出式を，次に示します。

↑(自ノード内UAPプロセス数※1＋プロセスサービスに対してサービスを要求してくるノード数※2＋システムサービスプロセス数※3)／0.8↑

↑↑：小数点以下を切り上げます。

注※1

自ノード内UAPプロセス数は，次に示す値の合計です。

自OpenTP1内のUAPプロセス数

CUPから同時に起動するトランザクション数（クライアントサービス定義のparallel_countオペランドの指定値）

注※2

プロセスサービスに対してサービスを要求してくるプロセス数とは，TP1/Multiを使用した場合だけ加算してください。このノード数は，次に示す値の合計です。

自ノードに対してdc_adm_get〜関数を呼び出す，他ノード内UAPプロセス数

自ノードを構成要素とするマルチノードエリアおよびマルチノードサブエリアに対して入力するdcmstart，dcmstop，dcndlsコマンドの数

注※3

システムサービスプロセス数とは，自OpenTP1内のシステムサービスプロセスの数です。自OpenTP1内のシステムサービスプロセスは，rpcstatコマンドで表示されるサーバ名をカウントすることで求められます。rpcstatコマンドで表示されるサーバ名のうち，マニュアル「OpenTP1　解説」のOpenTP1のプロセス構造に記載されているシステムサービスプロセスをカウントしてください。

このオペランドの指定が小さいと，OpenTP1制御下の他プロセスとのコネクションが設定できなくなるため，プロセスがKFCA00307-Eメッセージを出力して異常終了します。

指定値の優先順位は次のとおりです（1.＞2.）。

プロセスサービス定義

システム共通定義

ここで指定を省略した場合，システム共通定義の値を仮定します。

●term_watch_count=連続異常終了限界回数

　〜〈符号なし整数〉((1〜3))《3》

このオペランドに1〜3の値を指定すると，OpenTP1システム連続異常終了限界回数指定機能を使用できます。

term_watch_timeオペランドは，このオペランドの指定値が3，または省略された場合に有効となります。このオペランドとterm_watch_timeオペランドの関係を次の表に示します。

表3‒4　term_watch_countオペランドとterm_watch_timeオペランドの関係

term_watch_count

オペランドの指定値

term_watch_timeオペランドの指定値

0

0以外

1または2

term_watch_timeオペランドの指定値に関係なく，term_watch_countオペランドの指定値で開始，再開始を中断します。

term_watch_timeオペランドの指定値に関係なく，term_watch_countオペランドの指定値で開始，再開始を中断します。

3または省略

開始，再開始を中断しません。

term_watch_timeオペランドの指定値に従い，3回で開始，再開始を中断します。

このオペランドで指定した回数まで連続してOpenTP1がシステムダウンした場合，プロセスサービスはKFCA00715-Eメッセージを出力して，システムの開始または再開始を中断します。この場合は，システムダウンした要因を取り除いてから，dcsetupコマンドで一度OSへの登録を削除して再登録するか，またはdcresetコマンドを入力してください。

システム環境定義のmode_confオペランドが「MANUAL2」の場合，プロセスサービスの連続ダウン以外はこのオペランドの指定は無効となります。

●prc_prf_trace=Y|N

　〜《Y》

プロセスサービスのイベントトレースを取得するかどうかを指定します。

Y

プロセスサービスのイベントトレースを取得します。

N

プロセスサービスのイベントトレースを取得しません。

このオペランドでYを指定した場合，プロセスサービスの動作を検証するためのイベントトレースが取得されます。イベントIDの詳細については，マニュアル「OpenTP1 運用と操作」を参照してください。

イベントトレースは次に示すファイルに取得されます。

0xb001〜0xb003：$DCDIR/spool/dcprfinfの下のトレースファイル

0xb010以降：$DCDIR/spool/dcprcinfの下のトレースファイル

イベントトレースのうち，プロセスの生成と消滅については次に示すタイミングで情報が取得されます。

プロセス生成時に子プロセスで取得（イベントIDは0xb001）

プロセス消滅時に取得（イベントIDは0xb002）

プロセス生成時に親プロセスで取得（イベントIDは0xb003）

prfedコマンド実行時に-dオプションを指定すると，1.では生成したプロセスのサーバ名を，2.では消滅したIDとその終了状態を，また3.では生成したプロセスIDを，表示されるデータとして取得します。したがって，取得したトレース情報をprfedコマンドで出力する場合は，-dオプションを指定してください。-dオプションを指定すると次のようにトレース情報が出力されます。

1.の場合

Offset  +0 +1 +2 +3 +4 +5 +6 +7 +8 +9 +a +b +c +d +e +f  ASCII_code
 +0000  aa aa aa aa aa aa aa aa                          AAAAAAAA

aa：生成したプロセスのサーバ名（16進数字）

AA：生成したプロセスのサーバ名（ASCIIコード）

2.の場合

Offset  +0 +1 +2 +3 +4 +5 +6 +7 +8 +9 +a +b +c +d +e +f  ASCII_code
 +0000  bb bb bb bb cc cc cc cc                          BBBBCCCC

bb：消滅したプロセスID（16進数字）

BB：消滅したプロセスID（ASCIIコード）

cc：消滅したプロセスの終了状態（16進数字）

CC：消滅したプロセスの終了状態（ASCIIコード）

3.の場合

Offset  +0 +1 +2 +3 +4 +5 +6 +7 +8 +9 +a +b +c +d +e +f  ASCII_code
 +0000  dd dd dd dd                                      DDDD

dd：生成したプロセスID（16進数字）

DD：生成したプロセスID（ASCIIコード）

prfedコマンドの詳細については，マニュアル「OpenTP1 運用と操作」を参照してください。

なお，システム共通定義のprf_traceオペランドにNを指定した場合，このオペランドの指定は無効となります。

●prc_coresave_path=コアファイル格納パス

　〜〈パス名〉《$DCDIR/spool/save》

OpenTP1プロセスのコアファイルを格納するディレクトリを絶対パス名で指定します。

ユーザサーバの場合は，UAPトレース編集結果もこのオペランドで指定したディレクトリに格納されます。

パス名に指定できる文字数は，最大63文字です。

このオペランドで指定したパス名に誤りがある場合や，このオペランドの指定を省略した場合は，コアファイルの格納先に$DCDIR/spool/saveを仮定します。

OpenTP1管理者は，このオペランドで指定したディレクトリにコアファイルを書き込める権限を持っている必要があります。そうでない場合は，コアファイルが書き込まれないことがあります。

プロセスサーバのコアファイルの場合は，このオペランドの指定に関係なく，$DCDIR/spool/saveに出力されることがあります。

このオペランドの指定値を変更した場合は，dcresetコマンドを実行する必要があります。

●prc_corecompress=Y|N

　〜《N》

OpenTP1プロセスのコアファイルの格納時にOpenTP1で自動的に圧縮するかどうかを指定します。

Y

OpenTP1プロセスのコアファイルの格納時に，OpenTP1で自動的に圧縮します。

N

OpenTP1プロセスのコアファイルの格納時に，OpenTP1で自動的に圧縮しません。

このオペランドの指定を省略した場合は，圧縮しません。

圧縮処理は，OSが標準提供するコマンドを使用して，OpenTP1がオンライン中にUAPがダウンした場合などに行います。そのため，このオペランドでYを指定した場合で，UAPがダウンしたときは，OSが標準提供する圧縮処理用コマンドの性能に依存して，全体の性能が低下することがあります。

このオペランドでYを指定した場合，コアファイルを格納するディレクトリに，圧縮処理前のファイル名が付いた0バイトのファイルが作成されます。このファイルは，退避した情報ファイルの世代管理に使用することがあるため，削除しないでください。

このオペランドの指定値を変更した場合は，dcresetコマンドを実行する必要があります。

●watch_time=最大応答待ち時間

　〜〈符号なし整数〉((0〜65535))（単位：秒）

RPCによってプロセス間で通信する場合，サービス要求を送ってからサービスの応答が返るまでの待ち時間の最大値を指定します。

OpenTP1の終了処理で，このオペランドで指定した時間だけ終了処理を待ち合わせる場合があります。したがって，大きな値を指定した場合，OpenTP1の終了処理に時間が掛かるときがあります。

指定時間を過ぎても応答がない場合は，RPCは送受信タイムアウトとしてエラーリターンします。

0を指定した場合は，応答を受信するまで待ち続けます。0を指定した場合，OpenTP1が終了しないときがあります。

省略した場合は，システム共通定義のwatch_timeオペランドの値を仮定します。

このオペランドは，システム共通定義のwatch_timeオペランドのデフォルト値で使用してください。

特別なチューニングを必要とする場合以外は，このオペランドの内容を変更しないことをお勧めします。

システム共通定義のwatch_timeオペランドのデフォルト値よりも，極端に小さな値または大きな値を指定すると，OpenTP1ダウンに至る障害が発生する場合がありますので，ご注意ください。

●prc_hugepage_group_id=グループ識別子

　〜〈符号なし整数〉((0〜4294967294))

Hugepage機能を適用するときに，使用可能なグループ識別子を指定します。

このオペランドには，カーネルパラメタvm.hugetlb_shm_groupに指定する値と同じ値を指定してください。

OpenTP1が使用する共用メモリにHugepage機能を適用する場合，このオペランドを必ず指定してください。

共用メモリにHugepage機能を適用するのは，次に示すオペランドにhugepageを指定している場合です。

システム環境定義のshmpool_attributeオペランド

DAMサービス定義のdam_cache_attributeオペランド

TAMサービス定義のtam_pool_attriオペランド

この指定値はLinux版の64ビット版の場合だけ指定できます。

＜注意事項＞

このオペランドの指定値が適切でなくても，OSのバージョンによってはOpenTP1の共用メモリにHugepage機能を適用できる場合があります。ただし，OSのアップデートなどによりHugepage機能を適用できなくなる場合があるため，適切な値を指定してください。

コマンド形式

次ページ以降に記述しています。

prcsvpath

名称

ユーザサーバのパスの指定

形式

〔prcsvpath　パス名〕

機能

ユーザサーバおよびコマンドのパス名を指定します。

オプション

●パス名

　〜〈パス名〉《$DCDIR/aplib:$DCDIR/bin》

プロセスサービスが起動するユーザサーバおよびユーザサーバから起動されるコマンドの絶対パス名を指定します。

ユーザサーバを入れ替えるときに，ユーザサーバが格納されているディレクトリのパス名をオンライン中にprcpathコマンドで変更できます。prcpathコマンドの詳細については，マニュアル「OpenTP1 運用と操作」を参照してください。

パス名は，複数指定できます。複数のパス名を指定する場合は，コロン':'で区切って指定してください。また，追加する場合は，既存のパスを含めて指定してください。なお，パス名には環境変数は指定できません。

パス名に指定できる文字数は，最大255文字です。ただし，定義の1行の長さは最大80バイトです。80バイトを超える場合については，「1.4　定義の規則」を参照してください。

注意事項

複数指定したパスのうち，1つでも誤りがある場合はすべてのパスが無効になります。OpenTP1起動時にKFCA00757-Eメッセージが出力される場合は，指定した値を見直してからOpenTP1を再起動してください。

スケジュールサービス定義

形式

set形式

〔set scd_server_count=最大ユーザサーバ数〕
〔set scd_hold_recovery=Y|F〕
〔set scd_hold_recovery_count=閉塞状態の引き継ぎが必要なサーバ，および
                              サービスの合計数〕
〔set scd_port=スケジュールサービスのポート番号〕
〔set scd_this_node_first=Y|N〕
〔set scd_announce_server_status=Y|N〕
〔set max_socket_descriptors=ソケット用ファイル記述子の最大数〕
〔set max_open_fds=スケジュールサービスプロセスでアクセスするファイル，およびパイプの最大数〕
〔set schedule_rate=スケジュール比率〕
〔set scd_retry_of_comm_error=リトライ回数〕
〔set scd_advertise_control=BEFORE|AFTER〕
〔set scd_message_level=1|2〕
〔set ipc_tcpnodelay=Y|N〕
〔set watch_time=最大応答待ち時間〕

コマンド形式

{{scdbufgrp -g  スケジュールバッファグループ名
         {〔-e  メッセージ格納バッファプール長〕｜
          〔-n  メッセージ格納バッファセル数〕}
          〔-l  メッセージ格納バッファセル長〕
         {〔-s  メッセージ格納バッファ使用制限サイズ〕｜
          〔-p  メッセージ格納バッファ使用制限率〕}}}
{{scdmulti 〔-m  マルチスケジューラデーモン数〕
           〔-p  ポート番号〕
           〔-g  マルチスケジューラグループ名〕
           〔-t〕}}

機能

OpenTP1システム環境下で動作するサーバへのサービス要求のスケジューリングをするための実行環境を定義します。

スケジュールサービスはOSのメッセージ機能を使用して，スケジュールキューをサービスグループ単位に作成します。

説明

set形式のオペランド

●scd_server_count=最大ユーザサーバ数

　〜〈符号なし整数〉((0〜8192))《32》

スケジュールサービスを利用して動作するユーザサーバ数の最大値を指定します。

オンライン時に，サーバ起動コマンド（dcsvstart）で起動するユーザサーバの数も含めて指定します。

ユーザサーバ数に含めるサーバはキュー受信型SPP，MHP，rapサーバ，RTSSPP，mqrsppです。

このオペランドを変更する場合は「7.3.1　ユーザサーバの追加」を参照し，定義の見直しやOpenTP1ファイルの再見積もりの必要有無を確認してください。

●scd_hold_recovery=Y|F

　〜《Y》

システムを全面回復する場合に，ユーザサーバの閉塞状態を引き継ぐかどうかを指定します。

Y

ユーザサービス定義，ユーザサービスデフォルト定義のhold_recoveryオペランドの指定によって，サーバまたはサービスの閉塞状態を引き継ぎます。ただし，システム環境定義のstart_scheduling_timingオペランドにBEFOREを指定した場合は，ユーザサービス定義のhold_recoveryオペランドの指定に関係なく，閉塞状態は引き継ぎません。

F

ユーザサービス定義，ユーザサービスデフォルト定義のhold_recoveryオペランドの指定によって，サーバまたはサービスの閉塞状態を引き継ぎます。

閉塞状態のサーバまたはサービスの数がスケジュールサービス定義のscd_hold_recovery_countオペランドの指定値を超えた場合，超えた分のサーバまたはサービスの閉塞状態は引き継ぎません。またscd_hold_recovery_countオペランドに0を指定した場合も引き継ぎません。

SPPのソケット受信型サーバ，SUP，およびMHPの場合は，指定する必要はありません。scd_hold_recoveryオペランドの指定と，ユーザサービス定義，ユーザサービスデフォルト定義のhold_recoveryオペランド，システム環境定義のstart_scheduling_timingオペランド，スケジュールサービス定義のscd_hold_recovery_countオペランドの指定の関係を，次の表に示します。

各オペランドの指定値

OpenTP1の閉塞引き継ぎ処理

start_scheduling_timing

hold_recovery

scd_hold_recovery_count

scd_hold_recovery

AFTER

Y

0

−

×

0以外

−

○

N

0

−

×

0以外

−

×

BEFORE

Y

0

−

×

0以外

Y

×

F

○

N

0

−

×

0以外

−

×

（凡例）

○：閉塞状態を引き継ぎます。

×：閉塞状態を引き継ぎません。

−：指定できません。指定しても無視されます。

●scd_hold_recovery_count=閉塞状態の引き継ぎが必要なサーバ，およびサービスの合計数

　〜〈符号なし整数〉((0〜58240))《64》

システムを全面回復するときに，閉塞状態を引き継ぐことが必要なサーバ，およびサービスの合計数を指定します（指定値は，偶数になるように切り上げられます）。

ユーザサービス定義でservice_holdオペランドにNが指定されたサーバは，一つのサーバとして数えます。service_holdオペランドにYが指定されたサーバは，そのサーバが持つサービス数を数えて合計数を指定してください。ただし，service_holdオペランドにYが指定されていても，ユーザサービス定義でholdオペランドにNが指定され，かつservice_term_watch_timeオペランドに0が指定された場合は，一つのサーバとして数えます。

閉塞状態のサーバ，またはサービスの数がこの指定値を超えた場合，超えた分のサーバ，またはサービスの閉塞状態は引き継がれません。0を指定した場合も引き継がれません。

システムを全面回復するとき，前回のオンライン処理のときに指定した値が引き継がれます。ただし，前回，または今回の指定値が0の場合は，指定値は引き継がれません。

0以外を指定した場合は，閉塞情報がステータスファイルに格納されるので，指定値に応じてステータスファイルの容量を見積もる必要があります。指定値が小さいと，ステータスファイル内で閉塞情報の書き換え処理が多く発生します。

TP1/Server Baseのバージョンが07-07以前の場合は，このオペランドの指定値によって，システム共通定義のrpc_max_message_sizeオペランドの指定値を変更する必要がある場合があります。次の計算式の算出値が1より大きい場合（2〜8の場合）は，算出値以上の値をrpc_max_message_sizeオペランドに指定してください。

↑scd_hold_recovery_countオペランドの指定値／7280↑

↑↑：小数点以下を切り上げます。

rpc_max_message_sizeオペランドの指定値を変更する場合は，rpc_max_message_sizeオペランドの説明を参照してください。

●scd_port=スケジュールサービスのポート番号

　〜〈符号なし整数〉((5001〜65535))

スケジュールサービスのポート番号を指定します。

このオペランドの指定を省略した場合，システムが任意に割り当てたポート番号で起動します。

このオペランドで指定するポート番号は，ほかのプログラムと重複しないようにしてください。

また，OSには任意に割り当てる番号がありますが，この番号も使用しないでください。OSが任意に割り当てる番号は，OSの種別やバージョンによって異なります。詳細については，使用しているOSのマニュアルを参照してください。

●scd_this_node_first=Y|N

　〜《N》

要求されたサーバが自ノードにある場合に，自ノードのサーバを優先してスケジュールするかどうかを指定します。

Y

要求されたサーバが自ノードにある場合には，自ノードのサーバを優先してスケジュールします。

サーバが自ノードにない場合や，スケジュールできない状態（過負荷状態や閉塞状態など）の場合には，他ノードのサーバをスケジュールします。

N

要求されたサーバが自ノードにある場合でも，自ノードのサーバを優先しないで，ランダムにノードを選択してスケジュールします。

このオペランドでYを指定し，scd_announce_server_statusオペランドでNを指定すると，自ノードのサーバがスケジュールできる状態なら，負荷状態に関係なく，必ず自ノードでスケジュールします。

●scd_announce_server_status=Y|N

　〜《Y》

自ノードのサーバの状態を，すべての他ノードに不定期で通知するかどうかを指定します。ノード間で負荷バランスを取る場合に指定します。

Y

自ノードのサーバの状態を，すべての他ノードに不定期（30秒以上の任意の間隔）で通知します。

N

自ノードのサーバの状態を，他ノードに通知しません。

このオペランドでYを指定すると，同一サービスグループが複数ノードにある場合に，サーバの状態をノード間で通知し合うことで，負荷を考慮したノード間の負荷バランスが取れます。ただし，次のような場合には，Nを指定してください。

サービスグループが一つのノードで起動している場合

負荷を考慮しないで，ランダム選択でノード間の負荷バランスを取る場合

なお，このオペランドの指定は，分散処理するすべてのノードで同じにしてください。指定が異なるノードがあると，負荷が集中することがあります。

●max_socket_descriptors=ソケット用ファイル記述子の最大数

　〜〈符号なし整数〉((32〜2032))

OpenTP1制御下のプロセス※1でのソケット用に使用するファイル記述子の最大数を指定します。

指定値の範囲は，適用OSがAIX，HP-UXまたはWindowsの場合は32〜2032，適用OSがSolarisまたはLinuxの場合は32〜1008です。

OpenTP1制御下のプロセス※1は，システムサーバやユーザサーバとの間で，ソケットを使用したTCP/IP通信でプロセス間の情報交換をしています。そのため，同時に稼働するUAPプロセスの数，および通信する他ノードの数によって，このオペランドを変更する必要があります。

このオペランドには，次の条件を満たす値を指定してください。

（「このオペランドの指定値」＋同定義内の「max_open_fdsオペランドの指定値」）≦2048※2

条件を満たさない値を指定した場合は，このオペランドの指定値は次に示すように強制的に補正されます。

（「このオペランドの指定値」＋同定義内の「max_open_fdsオペランドの指定値」）=2048※2

注※1

MCFサービス（MCFマネジャサービス，MCF通信サービス，およびアプリケーション起動サービス）以外のOpenTP1プロセスが対象です。MCFサービスの場合は，「システムサービス情報定義」および「システムサービス共通情報定義」を参照してください。

注※2

適用OSがAIX，HP-UXまたはWindowsの場合は2048，適用OSがSolarisまたはLinuxの場合は1024です。

ソケット用ファイル記述子の最大数の算出式を，次に示します。

（全UAPプロセス数※1＋スケジュールサービスを要求してくるノード数※2＋システムサービスプロセス数※3）／0.8

↑↑：小数点以下を切り上げます。

注※1

全UAPプロセス数は，次に示す値の合計です。

自OpenTP1内のUAPプロセス数

自OpenTP1内のサービスを利用する，他ノード内のUAPプロセス数

CUPから同時に起動するトランザクション数（クライアントサービス定義のparallel_countオペランドの指定値）

注※2

スケジュールサービスを要求してくるノード数とは，次に示す値の合計です。ただし，重複する場合は一つ分だけ加算してください。

自OpenTP1のall_nodeオペランドに指定したノード名の数

自ノード名を，OpenTP1のall_nodeオペランドに指定している，他ノードの数

注※3

システムサービスプロセス数とは，自OpenTP1内のシステムサービスプロセスの数です。自OpenTP1内のシステムサービスプロセスは，rpcstatコマンドで表示されるサーバ名をカウントすることで求められます。rpcstatコマンドで表示されるサーバ名のうち，マニュアル「OpenTP1　解説」のOpenTP1のプロセス構造に記載されているシステムサービスプロセスをカウントしてください。

このオペランドの指定が小さいと，OpenTP1制御下の他プロセスとのコネクションが設定できなくなるため，プロセスがKFCA00307-Eメッセージを出力して異常終了します。

指定値の優先順位は次のとおりです（1.＞2.）。

スケジュールサービス定義

システム共通定義

ここで指定を省略した場合，システム共通定義の値を仮定します。

●max_open_fds=スケジュールサービスプロセスでアクセスするファイル，およびパイプの最大数

　〜〈符号なし整数〉((16〜2016))《50》

スケジュールサービスプロセスで使用するファイルおよびパイプの最大数を指定します。

指定値の範囲は，適用OSがAIX，HP-UXまたはWindowsの場合は16〜2016，適用OSがSolarisまたはLinuxの場合は16〜992です。

スケジュールサービスでアクセスするファイルおよびパイプの最大数の計算式を，次に示します。

ステータスサービス定義で指定したOpenTP1ファイルシステム数＋20＋N
（N：ユーザサービス定義のschedule_methodにnamedpipeを指定したユーザサーバ数）

このオペランドには，次の条件を満たす値を指定してください。

（「max_open_fdsオペランドの指定値」＋「max_socket_descriptorsオペランドの指定値」）≦2048※

注※

適用OSがAIX，HP-UXまたはWindowsの場合は2048，適用OSがSolaris またはLinuxの場合は1024です。

●schedule_rate=スケジュール比率

　〜〈符号なし整数〉((50〜100))（単位：％）

TP1/Client/WまたはTP1/Client/Pのクライアント環境定義のDCSCDDIRECTオペランドにYを指定して，RPCをスケジューリングする際，サーバの負荷レベルがLEVEL0，およびLEVEL1のノードのうち，LEVEL0のノードへのスケジュール比率を指定します。

なお，この機能は，TP1/Extension 1をインストールしていることが前提です。TP1/Extension 1をインストールしていない場合の動作は保証できませんので，ご了承ください。

●scd_retry_of_comm_error=リトライ回数

　〜〈符号なし整数〉((0〜128))《0》

サービス要求のスケジューリング時に通信障害が発生したとき，障害ノード以外へスケジューリングするリトライ回数を指定します。ただし，このオペランドの指定値が，サービス要求の対象となるサービスグループが起動しているノード数を上回っている場合は，サービス要求の対象となるサービスグループが起動しているノード数をリトライ回数の上限値とします。

0を指定した場合は，リトライしません。

なお，この機能は，TP1/Extension 1をインストールしていることが前提です。TP1/Extension 1をインストールしていない場合の動作は保証できませんので，ご了承ください。

●scd_advertise_control=BEFORE|AFTER

　〜《BEFORE》

システム共通定義のall_nodeオペランドに指定されたノードに対し，ユーザサーバ起動時にネーム情報を通知するタイミングを変更します。

BEFORE

ユーザサーバの起動処理中（オンライン前）に，システム共通定義のall_nodeオペランドに指定されたOpenTP1ノードに対してネーム情報を通知します。

AFTER

ユーザサーバ起動完了直後に，システム共通定義のall_nodeオペランドに指定されたOpenTP1ノードに対してネーム情報を通知します。

また，OpenTP1の開始処理，または再開始処理で起動されるユーザサーバについては，スケジュールサービスが開始されるタイミングで起動されているユーザサーバのネーム情報をまとめて通知します。ただし，システム環境定義のstart_scheduling_timingオペランドにBEFOREを指定すると，OpenTP1の開始処理，または再開始処理では，ユーザサーバが起動される前にスケジュールサービスが開始されるため，通知されるネーム情報はなくなります。

注

このオペランドにAFTERを指定した場合，OpenTP1の開始処理，または再開始処理で起動されるユーザサーバ数が多いと，システム共通定義のall_nodeオペランドに指定されたOpenTP1ノードに対してまとめて通知するネーム情報量が増え，マシンおよびネットワークの負荷が一時的に高くなることがあります。

●scd_message_level=1|2

　〜《2》

このオペランドに1を指定すると，メッセージ格納バッファプールのメモリ不足が発生した場合に出力されるKFCA00854-Eメッセージの出力を抑止できます。

●ipc_tcpnodelay=Y|N

　〜《Y》

OpenTP1がノード間で使用する通信ソケット（INETドメイン）に，TCP_NODELAYオプションを使用するかどうかを指定します。

TCP_NODELAYオプションを使用すると（このオペランドにYを指定すると），Nagleアルゴリズムが無効になるので，送信済みデータの応答待ちの状態でも遅延させることなくデータを送信できます。ただし，TCP_NODELAYオプションを使用することで，INETドメイン通信時の送信効率が低下し，ネットワークの負荷が大きくなる場合があります。この場合は，ネットワークの帯域などを考慮してipc_sendbuf_sizeオペランド，ipc_recvbuf_sizeオペランドのチューニングを検討するか，このオペランドにNを指定してTCP_NODELAYオプションを無効にするかを検討してください。

●watch_time=最大応答待ち時間

　〜〈符号なし整数〉((0〜65535))（単位：秒）

RPCによってプロセス間で通信する場合，サービス要求を送信してからサービスの応答が返るまでの待ち時間の最大値を指定します。

OpenTP1の終了処理で，このオペランドで指定した時間だけ終了処理を待ち合わせる場合があります。したがって，大きな値を指定した場合，OpenTP1の終了処理に時間が掛かる場合があります。

指定時間を過ぎても応答がない場合は，RPCは送受信タイムアウトとしてエラーリターンします。

0を指定した場合は，応答を受信するまで待ち続けます。0を指定した場合，OpenTP1が終了しない場合があります。

省略した場合は，システム共通定義のwatch_timeオペランドの値を仮定します。

このオペランドは，システム共通定義のwatch_timeオペランドのデフォルト値で使用してください。

特別なチューニングを必要とする場合以外は，このオペランドの内容を変更しないことをお勧めします。

システム共通定義のwatch_timeオペランドのデフォルト値よりも，極端に小さな値または大きな値を指定すると，OpenTP1ダウンに至る障害が発生する場合がありますので，ご注意ください。

コマンド形式

次ページ以降に記述しています。

scdbufgrp

名称

共用するメッセージ格納バッファプールの指定

形式

{{scdbufgrp  -g  スケジュールバッファグループ名
          {〔-e  メッセージ格納バッファプール長〕｜
           〔-n  メッセージ格納バッファセル数〕}
           〔-l  メッセージ格納バッファセル長〕
          {〔-s  メッセージ格納バッファ使用制限サイズ〕｜
           〔-p  メッセージ格納バッファ使用制限率〕}}}

機能

一つのメッセージ格納バッファプールを共用するユーザサーバの集合をスケジュールバッファグループといいます。ユーザサーバは，スケジュールバッファグループごとにメッセージ格納バッファプールを共用します。

スケジュールサービス定義では，スケジュールバッファグループごとに，作成するメッセージ格納バッファプールを指定します。

オプション

●-g　スケジュールバッファグループ名

　〜〈1〜8文字の識別子〉

メッセージ格納バッファプールを共用する，スケジュールバッファグループの名称を指定します。

スケジュールバッファグループ名は，ノード内で一意になるようにしてください。同じスケジュールバッファグループ名を複数指定した場合は，エラーとなります。

●-e　メッセージ格納バッファプール長

　〜〈符号なし整数〉((512〜1610612736))（単位：バイト）

共用するメッセージ格納バッファプールの長さを指定します。-nオプションとは同時に指定できません。-nオプションと同時に指定した場合，および指定可能範囲外の値を指定した場合は，OpenTP1の起動エラーとなります。

このオペランドの指定値には，-lオプションで指定するメッセージ格納バッファセル長（省略時は512バイト）の整数倍となる値を指定します。指定した値が-lオプションの指定値の整数倍でない場合は，-lオプションの指定値の整数倍に切り上げた値が仮定されます。ただし，切り上げた結果が最大値（1,610,612,736バイト）を超える場合は，OpenTP1の起動エラーとなります。

メッセージ格納バッファプール長とメッセージ格納バッファセル数，およびメッセージ格納バッファセル長の関係を次に示します。

メッセージ格納バッファセル数（端数は切り上げ）

=メッセージ格納バッファプール長÷メッセージ格納バッファセル長

メッセージ格納バッファプールは静的共用メモリ上に確保されるため，システム環境定義のstatic_shmpool_sizeオペランドの指定値を考慮してください。

-eオプションで定義エラーが発生した場合，KFCA00803-Eメッセージを出力し，OpenTP1の起動を中止します。

●-n　メッセージ格納バッファセル数

　〜〈符号なし整数〉((1〜3145728))《16》

共用するメッセージ格納バッファプールを構成する，セルの数を指定します。-eオプションとは同時に指定できません。-eオプションと同時に指定した場合，および指定可能範囲外の値を指定した場合は，OpenTP1の起動エラーとなります。

●-l　メッセージ格納バッファセル長

　〜〈符号なし整数〉((512〜31457280))《512》（単位：バイト）

共用するメッセージ格納バッファプールを構成する，セルの長さを指定します。

各セルには，16バイトのセル管理テーブルを作成します。また，バッファプールサイズが31,457,280バイトを超えた場合，またはメッセージ格納バッファプールの使用サイズを制限する（-s，-pオプションを指定）場合，各セルに32バイトのセル管理テーブルを作成します。このため，指定するメッセージ格納バッファセル長にはこれらのセル管理テーブルサイズを考慮してください。指定可能範囲外の値を指定した場合は，OpenTP1の起動エラーとなります。

このオペランドの指定値には，8の整数倍となる値を指定してください。指定した値が8の整数倍でない場合は，その値を8の整数倍に切り上げた値が仮定されます。

メッセージ格納バッファプール長とメッセージ格納バッファセル数，およびメッセージ格納バッファセル長の関係を，次に示します。

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

=メッセージ格納バッファセル長×メッセージ格納バッファセル数

メッセージ格納バッファプールとして確保できるバッファプールの最大長は，1,610,612,736バイトになります。そのため，「メッセージ格納バッファセル数×メッセージ格納バッファセル長」の値がこれを超えると，エラーとなります。また，メッセージ格納バッファプールは静的共用メモリ上に確保されるため，システム環境定義のstatic_shmpool_sizeオペランドの指定値を考慮してください。

●-s　メッセージ格納バッファ使用制限サイズ

　〜〈符号なし整数〉((512〜1610612736))（単位：バイト）

このスケジュールバッファグループに属するユーザサーバのメッセージ格納バッファ使用制限サイズの省略時解釈値を指定します。-pオプションとは同時に指定できません。同時に指定した場合，OpenTP1の起動エラーとなります。MHPがスケジュールバッファグループを利用する場合，この指定は無視されます。

このオペランドの指定値には，-lオプションで指定したメッセージ格納バッファセル長の整数倍となる値を指定します。指定した値がメッセージ格納バッファセル長の整数倍でない場合は，整数倍に切り下げた値になります。

切り下げた結果，値が0になった場合はOpenTP1の起動を中止します。

-sオプションで定義エラーが発生した場合，KFCA00803-Eメッセージを出力し，OpenTP1の起動を中止します。

●-p　メッセージ格納バッファ使用制限率

　〜〈符号なし整数〉((1〜100))（単位：％）

このスケジュールバッファグループに属するユーザサーバのメッセージ格納バッファ使用制限サイズの省略時解釈値を指定します。-sオプションとは同時に指定できません。同時に指定した場合，OpenTP1の起動エラーとなります。MHPがスケジュールバッファグループを利用する場合，この指定は無視されます。

このオペランドの指定値によって計算されたメッセージ格納バッファ使用制限サイズの値が，-lオプションで指定したメッセージ格納バッファセル長の整数倍でない場合は，メッセージ格納バッファ使用制限サイズは整数倍に切り下げた値になります。切り下げた結果，値が0になった場合はOpenTP1の起動を中止します。

-pオプションで定義エラーが発生した場合，KFCA00803-Eメッセージを出力し，OpenTP1の起動を中止します。

scdmulti

名称

マルチスケジューラデーモンの情報の指定

形式

{{scdmulti 〔-m  マルチスケジューラデーモン数〕
           〔-p  ポート番号〕
           〔-g  マルチスケジューラグループ名〕
           〔-t〕}}

機能

マルチスケジューラ機能を提供するマルチスケジューラデーモンに関する情報を指定します。

マルチスケジューラ機能を使用する場合，この定義コマンドとともに次の定義コマンドおよびオペランドを指定する必要があります。

RPC受信側：ユーザサービス定義のscdmulti定義コマンド

RPC送信側：ユーザサービス定義のmulti_scheduleオペランド

オプション

●-m　マルチスケジューラデーモン数

　〜〈符号なし整数〉((1〜4096))《1》

マルチスケジューラデーモンのプロセス数を指定します。

このオプションで起動するプロセスは，-pオプションの指定値から順にポート番号が割り当てられます。

● -p　ポート番号

　〜〈符号なし整数〉((5001〜65535))

マルチスケジューラデーモンのベースとなるポート番号を指定します。

マルチスケジューラ機能では，このオプション指定値から「（-pオプション指定値）＋（-mオプション指定値）−1」までのポート番号を，順にマルチスケジューラデーモンに割り当てて起動します。

このオプションは，scdmulti定義コマンドを複数指定する場合，またはスケジュールサービス定義のscd_portオペランドを指定する場合には省略できます。その場合はscdmulti定義コマンドがすでに実行されていれば，「直前のscdmulti定義コマンドで使用したポート番号＋1」がこのオプションの指定値となります。 scdmulti定義コマンドがまだ実行されてなく，スケジュールサービス定義のscd_portオペランドが指定されていれば，「scd_portオペランドの指定値＋1」の値をこのオプションの指定値とします。そのほかの場合は定義エラーとなります。

このオプションの指定値によって決定した各マルチスケジューラデーモンのポート番号が，他スケジューラデーモンのポート番号と重複した場合は，定義エラーとなります。

●-g　マルチスケジューラグループ名

　〜〈1〜8文字の識別子〉《scdmltgp》

scdmulti定義コマンドで起動されたマルチスケジューラデーモンのグループ名を指定します。

マルチスケジューラデーモンを複数グループに分け，グループ間のサービス要求メッセージ受信処理が競合しないようにする場合にだけ指定する必要があります。

このオプションを指定した場合，このscdmulti定義コマンドで起動されたマルチスケジューラデーモンにサービス要求をスケジューリングさせたいユーザサーバのユーザサービス定義で，scdmulti定義コマンドの-gオプションに，このオプションに指定したマルチスケジューラグループ名を指定する必要があります。

このオプションを省略した場合，"scdmltgp"が指定されたものとします。したがって，"scdmltgp"はマルチスケジューラグループ名として使用しないでください。

●-t

マルチスケジューラデーモンがサービス要求を受信したとき，かつ，自ノードのユーザサーバが高負荷状態のときに，マルチスケジューラ機能を使用していないほかのノードのユーザサーバ（ユーザサービス定義のscdmulti定義コマンドで，マルチスケジューラ機能を指定していないユーザサーバ）にサービス要求を一部，転送し負荷分散するかどうかを指定します。

自ノードのユーザサーバの閉塞などによって，スケジュールできない場合には，このオプションを指定しなくても，サービス要求が負荷分散されます。

このオプションを指定すると，マルチスケジューラ機能を使用していないユーザサーバへの負荷分散処理はマスタスケジューラデーモン経由になるため，マスタスケジューラデーモンに負荷が集中することがあります。

サービス要求の負荷分散が行われる条件を次の表に示します。

表3‒5　サービス要求の負荷分散が行われる条件

scdmulti定義コマンドの-tオプションの指定

サーバの状態

サービス要求の負荷分散

ノードA

（サービス要求の転送元）

（マルチスケジューラ機能の指定あり）

ノードB

（サービス要求の転送先）

（マルチスケジューラ機能の指定なし）

指定あり

通常状態

通常状態

×

高負荷状態

×

スケジュールできない状態

×

高負荷状態

通常状態

○

高負荷状態

×

スケジュールできない状態

×

スケジュールできない状態

通常状態

○

高負荷状態

○

スケジュールできない状態

×※

指定なし

通常状態

通常状態

×

高負荷状態

×

スケジュールできない状態

×

高負荷状態

通常状態

×

高負荷状態

×

スケジュールできない状態

×

スケジュールできない状態

通常状態

○

高負荷状態

○

スケジュールできない状態

×※

（凡例）

○：サービス要求を負荷分散します。

×：サービス要求を負荷分散しません。

注※

ユーザサーバの閉塞が原因で，スケジュールできない状態の場合だけ，スケジュールサービスは，ユーザサーバがスケジュールできない状態であることを把握できます。

ユーザサーバの閉塞以外の原因（例：メッセージ格納バッファ不足）で，スケジュールできない状態の場合は，サービス要求の転送先からサービス要求元にエラーが通知されます。

注意事項

TP1/Clientからマルチスケジューラ機能を使用してサービスを要求する場合については，マニュアル「OpenTP1 クライアント使用の手引」を参照してください。

マルチスケジューラデーモンが使用するポート番号は，必ず割り当て可能としてください。

-pオプションに指定するポート番号は，他プログラムで使用するウェルノウンポート番号と重複しない値で，かつ，OSが他プロセスに自動的に割り当てない値を指定してください。

マルチスケジューラデーモン起動時に，指定されたポート番号が割り当てられない場合は，スケジュールサービス開始処理をエラーとし，OpenTP1システムの起動を中止します。

マルチスケジューラデーモンは，OpenTP1のシステムサーバとして起動するため， 全scdmulti定義コマンドの-mオプションの指定値の合計を，システム環境定義のserver_countオペランド，およびプロセスサービス定義のprc_process_countオペランドに加える必要があります。 server_countオペランドの指定値が不足した場合は，マスタスケジューラデーモンが「hm02102」，または「hm02301」でアボートします。

この定義コマンドは複数指定できます。ただし，-gオプションを省略したこの定義コマンドを複数指定した場合，または-gオプションに同一名称を指定したこの定義コマンドを複数指定した場合は，定義エラーとし，OpenTP1システムの起動を中止します。

OpenTP1システム内の同一サービスグループに，マルチスケジューラ機能を使用しているユーザサーバと，マルチスケジューラ機能を使用していないユーザサーバが混在する場合，マルチスケジューラ機能を使用したサービス要求は，マルチスケジューラ機能を使用しているユーザサーバに優先して負荷分散されます。

この定義コマンドの使用は，TP1/Extension 1をインストールしていることが前提です。TP1/Extension 1をインストールしていない場合の動作は保証できませんので，ご了承ください。

トランザクションサービス定義

形式

set形式

  set trn_tran_process_count=同時に起動するトランザクションブランチの数
〔set trn_recovery_process_count=並行回復プロセス数〕
〔set trn_expiration_time=トランザクションブランチ限界経過時間〕
〔set trn_expiration_time_suspend=Y|N|F〕
〔set trn_tran_statistics=Y|N〕
〔set trn_tran_recovery_list=Y|N〕
〔set trn_cpu_time=トランザクションブランチCPU監視時間〕
〔set trn_statistics_item=統計情報項目〔,統計情報項目〕…〕
〔set trn_max_subordinate_count=最大子トランザクションブランチ数〕
〔set trn_rm_open_close_scope=process|transaction〕
〔set trn_optimum_item=トランザクション最適化項目
                    〔,トランザクション最適化項目〕…〕
〔set trn_processing_in_rm_error=down|retry|force〕
〔set trn_recovery_list_remove=normal|force|no〕
〔set trn_recovery_list_remove_level=未決着トランザクション情報
                                     ファイルの削除レベル〕
〔set trn_crm_use=Y|N〕
〔set trn_max_crm_subordinate_count=最大CRM経由
                                    子トランザクションブランチ数〕
〔set trn_watch_time=トランザクション同期点処理時の最大通信待ち時間〕
〔set trn_rollback_information_put=no|self|remote|all〕
〔set trn_limit_time=トランザクションブランチ最大実行可能時間〕
〔set trn_rollback_response_receive=Y|N〕
〔set trn_partial_recovery_type=type1|type2|type3〕
〔set max_socket_descriptors=ソケット用ファイル記述子の最大数〕
〔set trn_recovery_failmsg_interval=仕掛中トランザクション情報
                                    メッセージ間隔最小時間〕
〔set trn_wait_rm_open=continue|stop|retry_continue|retry_stop〕
〔set trn_retry_interval_rm_open=xa_open関数発行リトライ
                                 インタバル時間〕
〔set trn_retry_count_rm_open=xa_open関数発行リトライ回数〕
〔set thread_stack_size=OpenTP1内部で使用するスレッドスタック領域
                        のサイズ〕
〔set polling_control_data=Y|N〕
〔set thread_yield_interval=ソケットの再利用指示を受信できる契機を
                            与えるインタバル時間〕
〔set groups=グループ識別子〔,グループ識別子〕…〕
〔set trn_xar_use=Y|N〕
〔set trn_start_recovery_mode=stop|wait|continue〕
〔set trn_start_recovery_watch_time=リトライ経過時間〕
〔set trn_start_recovery_interval=リトライ間隔時間〕
〔set trn_xa_commit_error=down|force〕
〔set trn_prf_event_trace_level=TRNイベントトレースの取得レベル〕
〔set trn_prf_event_trace_condition=トレース取得種類
                                 〔,トレース取得種類〕〕
〔set trn_completion_limit_time=トランザクション完了限界時間〕
〔set trn_extend_function=トランザクションサービスの機能の拡張レベル〕
〔set trn_rcv_open_close_scope=Y|N〕
〔set watch_time=最大応答待ち時間〕

コマンド形式

trnstring -n  リソースマネジャ名
         〔-i  リソースマネジャ拡張子〔,リソースマネジャ拡張子〕…〕
         〔-o  "トランザクションサービス用xa_open関数用文字列"〕
         〔-c  "トランザクションサービス用xa_close関数用文字列"〕
         〔-O  "ユーザサーバ用xa_open関数用文字列"〕
         〔-C  "ユーザサーバ用xa_close関数用文字列"〕〔-d〕
         〔-e〕〔-m〕〔-r〕〔-s〕

putenv形式

{{〔putenv  環境変数名  環境変数値〕}}

dcputenv形式

{{〔dcputenv  環境変数名  環境変数値〕}}

機能

トランザクション管理をするための実行環境を定義します。

説明

set形式のオペランド

●trn_tran_process_count=同時に起動するトランザクションブランチの数

　〜〈符号なし整数〉((1〜8192※))

注※

MCFサービスを使用する場合の指定範囲は，次のとおりです。

32ビットの場合：((1〜7484))

64ビットの場合：((1〜6893))

同時に起動するトランザクションブランチの数を指定します。

トランザクション処理を実行するユーザサーバプロセス数，回復プロセス数，および回復処理を待っているトランザクションブランチ数の総数を指定します。

トランザクションブランチを発生させたユーザサーバプロセスが異常終了した場合，回復プロセスがほかのトランザクションブランチの決着を処理中のとき，このトランザクションブランチは回復処理を待っている状態になります。この状態が長く続くと起動できるトランザクションブランチ数が少なくなることがあります。

このため，異常終了後にトランザクションブランチを発生できるユーザサーバプロセスの扱いや，異常発生の頻度などを考慮してトランザクションブランチ数を設定する必要があります。指定数の目安を次に示します。

（トランザクション実行するユーザサーバプロセス数＋回復プロセス数）
＜指定するトランザクションブランチ数
≦（トランザクション実行するユーザサーバプロセス数×2＋回復プロセス数）

なお，指定数が多くなればなるほどメモリ資源の効率が悪くなるので注意してください。

●trn_recovery_process_count=並行回復プロセス数

　〜〈符号なし整数〉((1〜128))《4》

トランザクションブランチが異常終了した時に，トランザクションブランチの回復処理を並行してできる数を指定します。

トランザクションブランチが異常終了した場合は，ここで指定した数だけ並行してトランザクションブランチの回復処理をします。

●trn_expiration_time=トランザクションブランチ限界経過時間

　〜〈符号なし整数〉((0〜65535))《0》（単位：秒）

トランザクションブランチの処理を監視する限界経過時間を指定します。指定時間を超えた場合は，このトランザクションブランチのプロセスは異常終了して，ロールバックされます。0を指定した場合は，時間監視しません。

UAPが異常終了した場合に閉塞するかどうかはholdオペランド，term_watch_timeオペランドの指定によります。詳細については，ユーザサービス定義のholdオペランドおよびterm_watch_timeオペランドの説明を参照してください。

なお，このオペランドは，ユーザサービス定義またはrapリスナーサービス定義，およびユーザサービスデフォルト定義でも指定できます。

指定値の優先順位は次のとおりです（1.＞2.＞3.）。

ユーザサービス定義またはrapリスナーサービス定義

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

トランザクションサービス定義

また，これらの定義のほかに関数を発行して監視時間を指定することもできます。

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

トランザクショナルRPC実行プロセス（clttrnd）またはCUP実行プロセス（cltcond）で，この機能を有効にするには，クライアント環境定義またはクライアントサービス定義のtrn_expiration_timeオペランドを指定する必要があります。

注

トランザクションブランチ限界経過時間の精度は秒単位です。そのため，タイミングによっては，このオペランドに指定した値よりも最大約1秒長い時間でプロセスを強制停止することがあります。

●trn_expiration_time_suspend=Y|N|F

　〜《N》

トランザクションブランチの処理を監視するとき，次の処理時間も監視時間に含むかどうかを指定します。

監視対象のトランザクションブランチが，RPC機能を使ってほかのトランザクションブランチを呼び出し，その処理が終わるのを待つ時間

連鎖RPCで呼び出されたサーバUAPが，次のサービス要求を待つ時間

監視対象のトランザクションブランチが，非同期RPCを使用してほかのトランザクションブランチを呼び出したあと，処理結果受信処理を行っている時間

Y

1.，2.，3.のすべてを監視時間に含みます。

N

3.だけを監視時間に含みます。

F

1.，2.，3.のどれも監視時間に含みません。

なお，このオペランドは，ユーザサービス定義またはrapリスナーサービス定義，およびユーザサービスデフォルト定義でも指定できます。

指定値の優先順位は次のとおりです（1.＞2.＞3.）。

ユーザサービス定義またはrapリスナーサービス定義

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

トランザクションサービス定義

このオペランドと各種タイマ監視との関係については，「付録A.2　トランザクションの時間監視」を参照してください。

トランザクショナルRPC実行プロセス（clttrnd）またはCUP実行プロセス（cltcond）で，この機能を有効にするには，クライアント環境定義またはクライアントサービス定義のtrn_expiration_time_suspendオペランドを指定する必要があります。

●trn_tran_statistics=Y|N

　〜《N》

トランザクションブランチごとの統計情報を取得するかどうかを指定します。

Y

統計情報を取得します。

N

統計情報を取得しません。

Yを指定した場合，OpenTP1システムの起動後から停止までの間，ユーザサービス定義のtrn_statistics_itemオペランドで，nothing以外を指定されたユーザサーバが実行したトランザクションブランチの統計情報を取得します。

統計情報の取得開始または終了は，trnsticsコマンドでも指示できます。その場合このオペランドの指定は無効となります。

統計情報を取得する場合，取得情報の種類が多くなるほど，トランザクション性能が低下します。そのため，統計情報の取得は，システムチューニング時やトラブル調査時など，トランザクション性能に影響を与えてもかまわない場合だけにしてください。

●trn_tran_recovery_list=Y|N

　〜《N》

OpenTP1システムの全面回復時に，未決着トランザクション情報を取得するかどうかを指定します。OpenTP1は，システムの全面回復のたびに$DCDIR/spool/dctrninfの下にファイルを作成して，この情報を出力します。不要となったファイルは削除してください。

Y

未決着トランザクション情報を取得します。

N

未決着トランザクション情報を取得しません。

●trn_cpu_time=トランザクションブランチCPU監視時間

　〜〈符号なし整数〉((0〜65535))《0》（単位：秒）

トランザクションブランチが同期点処理までに使用できるCPU時間を指定します。0を指定した場合は，時間監視しません。指定時間を超えた場合は，該当するトランザクションブランチのプロセスを異常終了し，ロールバックします。

UAPが異常終了した場合に閉塞するかどうかはholdオペランド，term_watch_timeオペランドの指定によります。詳細については，ユーザサービス定義のholdオペランドおよびterm_watch_timeオペランドの説明を参照してください。

なお，このオペランドは，ユーザサービス定義またはrapリスナーサービス定義，およびユーザサービスデフォルト定義でも指定できます。

指定値の優先順位は次のとおりです（1.＞2.＞3.）。

ユーザサービス定義またはrapリスナーサービス定義

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

トランザクションサービス定義

トランザクショナルRPC実行プロセス（clttrnd）またはCUP実行プロセス（cltcond）で，この機能を有効にするには，クライアント環境定義またはクライアントサービス定義のtrn_cpu_timeオペランドを指定する必要があります。

●trn_statistics_item=統計情報項目〔，統計情報項目〕…

　〜《executiontime》

トランザクションブランチの統計情報を取得する項目を指定します。

nothing

統計情報を取得しません。

base

基本情報として，次の情報を取得します。

トランザクションブランチの識別子

トランザクションブランチの決着結果

トランザクションブランチの実行プロセス種別

トランザクションブランチの実行サーバ名

トランザクションブランチの実行サービス名

executiontime

基本情報とトランザクションブランチの実行時間情報を取得します。

cputime

基本情報とトランザクションブランチのCPU時間情報を取得します。

nothingの指定は，一つしかできません。また，nothingとほかの統計情報項目を同時に指定した場合，nothingの指定は無効になります。

トランザクションに関する統計情報を取得するときは次のどれかを指定してください。

trn_tran_statisticsオペランドにYを指定

trnsticsコマンドで-sオプションを指定

なお，このオペランドは，ユーザサービス定義またはrapリスナーサービス定義，およびユーザサービスデフォルト定義でも指定できます。

指定値の優先順位は次のとおりです（1.＞2.＞3.）。

ユーザサービス定義またはrapリスナーサービス定義

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

トランザクションサービス定義

トランザクショナルRPC実行プロセス（clttrnd）またはCUP実行プロセス（cltcond）で，この機能を有効にするには，クライアント環境定義またはクライアントサービス定義のtrn_statistics_itemオペランドを指定する必要があります。

●trn_max_subordinate_count=最大子トランザクションブランチ数

　〜〈符号なし整数〉((0〜1024))《32》

OpenTP1下の一つのトランザクションブランチから生成する子トランザクションブランチの最大数を指定します。この最大数は，一つのトランザクションブランチから発行するdc_rpc_call関数（ただし，呼び先で更新処理，またはUJ出力する）の最大数です。

●trn_rm_open_close_scope=process|transaction

　〜《process》

OpenTP1以外が提供しているリソースマネジャに対して，XAインタフェースである二つの関数（xa_open関数とxa_close関数）の発行タイミングを指定します。

process

dc_rpc_open関数発行時にxa_open関数を発行し，dc_rpc_close関数発行時にxa_close関数を発行します。

transaction

トランザクション開始時にxa_open関数を発行し，トランザクション終了時にxa_close関数を発行します。

processを指定した場合は，dc_rpc_open関数の発行からdc_rpc_close関数の発行まで，リソースマネジャの資源を占有します。したがって，トランザクションの性能を重視する場合はprocessを指定してください。

また，transactionを指定した場合は，トランザクションの開始と終了ごとにxa_open関数，xa_close関数を発行します。したがって，リソースマネジャの資源を有効利用したい場合は，transactionを指定してください。

なお，このオペランドは，ユーザサービス定義およびユーザサービスデフォルト定義にも指定できます。

指定値の優先順位は次のとおりです（1.＞2.＞3.）。

ユーザサービス定義

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

トランザクション定義

●trn_optimum_item=トランザクション最適化項目〔，トランザクション最適化項目〕…

　〜《base》

複数のユーザサーバで構成されるグローバルトランザクションの性能を向上させるための最適化項目を，次の文字列で指定します。

base

同期点処理全体（プリペア処理，コミット処理，およびロールバック処理）を最適化します。OpenTP1のトランザクション制御は2相コミット方式で実行しているため，二つのトランザクションブランチ間のコミット制御には，4回のプロセス間通信が必要となります。

次の条件をすべて満たす場合，親トランザクションブランチが子トランザクションブランチのコミット処理を代わりに実行することで，コミット制御で必要な4回のプロセス間通信を削減します。

親トランザクションブランチと，子トランザクションブランチが同一OpenTP1下にあること。

親トランザクションブランチが，子トランザクションブランチを同期応答型RPCで呼び出していること。

子トランザクションブランチでアクセスしたリソースマネジャのXAインタフェース用オブジェクトが，親トランザクションブランチにもリンケージされていること。

asyncprepare

baseの指定条件を満たしていないため同期点処理全体の最適化ができない場合に，プリペア処理を最適化します。

次の条件をすべて満たす場合，親トランザクションブランチから発行されたRPCによって子トランザクションブランチがサービス要求を実行したときに，RPCのリターン前にプリペア処理を実行することで，2回のプロセス間通信を削減します。

baseを指定した最適化ができないこと。

親トランザクションブランチが，子トランザクションブランチを同期応答型RPCで呼び出していること。

ただし，この最適化を実行した場合，親トランザクションブランチが発行した同期応答型RPCの応答時間が遅くなります。また，子トランザクションブランチは，プリペア処理からコミット処理までの間隔（親トランザクションブランチからの指示がないとトランザクションを決着できない状態）が大きくなります。そのため，親トランザクションブランチのOpenTP1がシステムダウンし，トランザクションブランチ間の連絡ができなくなると，ジャーナルファイルのスワップやチェックポイントダンプファイルの有効化が遅れ，子トランザクションブランチのOpenTP1もシステムダウンする場合があります。

トランザクション最適化項目は，重複して指定できます。ただし，優先順位は次のようになります（1.＞2.）。

base

asyncprepare

なお，このオペランドは，ユーザサービス定義またはrapリスナーサービス定義，およびユーザサービスデフォルト定義でも指定できます。

指定値の優先順位は次のとおりです（1.＞2.＞3.）。

ユーザサービス定義またはrapリスナーサービス定義

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

トランザクションサービス定義

トランザクショナルRPC実行プロセス（clttrnd）またはCUP実行プロセス（cltcond）で，この機能を有効にするには，クライアント環境定義またはクライアントサービス定義のtrn_optimum_itemオペランドを指定する必要があります。

●trn_processing_in_rm_error=down|retry|force

　〜《down》

トランザクション回復サービスによるトランザクションの回復時に，リソースマネジャに対して発行したXA関数（xa_commit関数，xa_forget関数，xa_rollback関数）が処理を続行できないコード（XAER_INVAL（-5），XAER_PROTO（-6））でエラーリターンした場合のOpenTP1の処置を指定します。

このような障害は，次のような場合に発生し，ほかのリソースと不整合になっているおそれがあります。

リソースマネジャに障害が発生した場合

OpenTP1のトランザクション制御下で，XA連携しているリソースマネジャが提供するトランザクション制御機能を使用した場合

XA連携時にリソースマネジャが禁止している機能を使用した場合

このような障害が発生した場合は，KFCA00907-EおよびKFCA00908-Eのメッセージを出力します。

down

OpenTP1システムをダウンさせます。

システムダウン後は，すべてのリソースを正常な状態に回復し，OpenTP1システムを強制正常開始してください。

retry

トランザクションが決着できるまで，障害となったリソースマネジャに対して一定間隔でトランザクションの決着を指示します。

この指定は，リソースマネジャの障害を何らかの方法で回復できる場合，または指定をforceに変更する前にリソースマネジャの状態を確認し，アクセス禁止などを処置する場合に指定します。

force

障害となったリソースマネジャを無視して，トランザクションを強制的に決着させます。

この指定は，トランザクション強制決着後，障害となったリソースマネジャをほかのトランザクションがアクセスしてもかまわない場合に指定してください。

このオペランドは，障害発生時に処置を決定できるよう，オンライン中に変更できます。そのため，システム開始時にはretryを指定しておき，障害発生時に障害となったリソースマネジャに必要な処置をしたあと，指定をforceに変更するというような運用ができます。

●trn_recovery_list_remove=normal|force|no

　〜《no》

OpenTP1開始時に，未決着トランザクション情報ファイルを削除するかどうかを指定します。

normal

OpenTP1正常開始時に削除します。

force

OpenTP1開始時に削除します。

no

OpenTP1開始時に削除しません。

●trn_recovery_list_remove_level=未決着トランザクション情報ファイルの削除レベル

　〜〈符号なし整数〉((0〜24855))《0》（単位：日）

未決着トランザクション情報ファイルの削除レベルを指定します。このオペランドは，trn_recovery_list_removeオペランドでnormalまたはforceを指定した場合に有効です。

0

全ファイルを削除します。

1〜24855

トランザクションサービス開始時刻から起算して，「指定値×24」時間より前に作成されたファイルを削除します。

●trn_crm_use=Y|N

　〜《N》

通信リソースマネジャ（CRM）を使用するかどうかを指定します。

Y

CRMを使用します。

N

CRMを使用しません。

●trn_max_crm_subordinate_count=最大CRM経由子トランザクションブランチ数

　〜〈符号なし整数〉((0〜1024))《8》

OpenTP1下の一つのトランザクションブランチから生成される，CRM経由のRPCの最大数を指定します。

●trn_watch_time=トランザクション同期点処理時の最大通信待ち時間

　〜〈符号なし整数〉((1〜65535))《120》（単位：秒）

トランザクションの同期点処理で，トランザクションブランチ間で行う通信（プリペア，コミット，ロールバック指示，または応答など）の受信待ち時間の最大値を指定します。

指定時間を過ぎても指示または応答がない場合は，該当するトランザクションブランチが2相コミットの1相目完了前であればロールバックさせ，1相目完了後であればトランザクションサービスのシステムプロセスでトランザクション決着処理を再試行します。

このオペランドは，ユーザサービス定義またはrapリスナーサービス定義，およびユーザサービスデフォルト定義でも指定できます。

指定値の優先順位は次のとおりです（1.＞2.＞3.）。

ユーザサービス定義またはrapリスナーサービス定義

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

トランザクションサービス定義

これらのすべての定義でこのオペランドを省略した場合，トランザクションを行ったユーザサーバのwatch_timeの値を仮定します。ただし，trn_watch_timeには0秒を指定できないため，ユーザサーバのwatch_timeに0秒を指定した場合はtrn_watch_timeのデフォルト値である120秒を仮定します。

トランザクショナルRPC実行プロセス（clttrnd）またはCUP実行プロセス（cltcond）で，この機能を有効にするには，クライアント環境定義またはクライアントサービス定義のtrn_watch_timeオペランドを指定する必要があります。

●trn_rollback_information_put=no|self|remote|all

　〜《no》

トランザクションブランチがロールバックした場合に，ロールバック要因に関する情報をログに取得するかどうかを指定します。

no

ロールバック情報を取得しません。

self

ロールバック要因が発生したトランザクションブランチでだけ，ログにロールバック情報を取得します。

remote

selfに加え，他ノードのトランザクションブランチからロールバック要求されたトランザクションブランチでも，ログにロールバック情報を取得します。

all

remoteに加え，自ノードのトランザクションブランチからロールバック要求されたトランザクションブランチでも，ログにロールバック情報を取得します。

このオペランドは，ユーザサービス定義またはrapリスナーサービス定義，およびユーザサービスデフォルト定義でも指定できます。

指定値の優先順位は次のとおりです（1.＞2.＞3.）。

ユーザサービス定義またはrapリスナーサービス定義

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

トランザクションサービス定義

トランザクショナルRPC実行プロセス（clttrnd）またはCUP実行プロセス（cltcond）で，この機能を有効にするには，クライアント環境定義またはクライアントサービス定義のtrn_rollback_information_putオペランドを指定する必要があります。

このオペランドによって得たログを使用することで障害調査が容易になります。したがって，このオペランドにnoを指定しているか，または何も指定していない場合は，このオペランドにallを指定することをお勧めします。

●trn_limit_time=トランザクションブランチ最大実行可能時間

　〜〈符号なし整数〉((0〜65535))《0》（単位：秒）

トランザクションブランチの最大実行可能時間を指定します。

トランザクションブランチを開始してから同期点処理が終了するまでの時間が，このオペランド指定時間を超えないようにdc_rpc_call関数，dc_rpc_poll_any_replies関数および同期点処理内で行う通信のタイムアウト時間を次のように自動設定します。

dc_rpc_call関数およびdc_rpc_poll_any_replies関数のタイムアウト時間

「K≧このオペランド指定時間」の場合は，要求処理を実行しないで，タイムアウトでエラーリターンします。

「K＜このオペランド指定時間」でかつ「（このオペランド指定時間−K）≧W」の場合は，Wをタイムアウト時間とします。

「K＜このオペランド指定時間」でかつ「（このオペランド指定時間−K）＜W」の場合は，（このオペランド指定時間−K）をタイムアウト時間とします。

K

現時刻−トランザクションブランチ開始時刻

W

dc_rpc_call関数の場合はwatch_timeオペランド指定時間

dc_rpc_poll_any_replies関数の場合は引数timeout指定時間

同期点処理内で行う通信のタイムアウト時間

「K≧このオペランド指定時間」の場合は，タイムアウト時間を1秒とします。

「K＜このオペランド指定時間」でかつ「（このオペランド指定時間−K）≧W」の場合は，Wをタイムアウト時間とします。

「K＜このオペランド指定時間」でかつ「（このオペランド指定時間−K）＜W」の場合は，（このオペランド指定時間−K）をタイムアウト時間とします。

K

現時刻−トランザクションブランチ開始時刻

W

trn_watch_timeオペランド指定時間

trn_watch_timeオペランドを省略した場合はwatch_timeオペランド指定時間

上記の受信待ち以外の処理で時間が掛かった場合は，このオペランド指定時間以内にトランザクションブランチが終了しないことがあります。

同期点処理開始前にこのオペランドの指定時間が経過した場合，そのトランザクションはロールバックします。

0を指定した場合は，時間監視をしません。

なお，このオペランドは，ユーザサービス定義またはrapリスナーサービス定義，およびユーザサービスデフォルト定義でも指定できます。指定値の優先順位は次のとおりです（1.＞2.＞3.）。

ユーザサービス定義またはrapリスナーサービス定義

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

トランザクションサービス定義

トランザクショナルRPC実行プロセス（clttrnd）またはCUP実行プロセス（cltcond）で，この機能を有効にするには，クライアント環境定義またはクライアントサービス定義のtrn_limit_timeオペランドを指定する必要があります。

●trn_rollback_response_receive=Y|N

　〜《Y》

RPC先トランザクションブランチにロールバック指示を送信したあと，ロールバック完了通知を受信するかどうかを指定します。

Nを指定した場合，RPC先トランザクションブランチからのロールバック完了通知を受信しないで（RPC先トランザクションブランチのロールバック処理の完了を待たないで）自トランザクションブランチを終了します。

なお，このオペランドは，ユーザサービス定義またはrapリスナーサービス定義，およびユーザサービスデフォルト定義でも指定できます。

指定値の優先順位は次のとおりです（1.＞2.＞3.）。

ユーザサービス定義またはrapリスナーサービス定義

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

トランザクションサービス定義

トランザクショナルRPC実行プロセス（clttrnd）またはCUP実行プロセス（cltcond）で，この機能を有効にするには，クライアント環境定義またはクライアントサービス定義のtrn_rollback_response_receiveオペランドを指定する必要があります。

●trn_partial_recovery_type=type1|type2|type3

　〜《type1》

UAP障害時のトランザクション同期点処理方式を指定します。

RPCがタイムアウトし，RPC発行先プロセスのアドレスが未解決の場合やトランザクション実行中のUAPがダウンした場合に，トランザクションブランチ間の連絡がスムーズにできないで，トランザクションの決着に時間が掛かることがあります。

このオペランドでは，次に示す障害が発生した場合のトランザクション同期点処理方式を，指定値に示す三つの方式から選択して指定します。

（障害1）RPCがタイムアウトした場合

この場合，RPC発行元トランザクションブランチは，サービス要求がどのプロセスで実行されているかがわからないため，RPC発行先トランザクションブランチにトランザクション同期点メッセージを送信できないで，RPC発行元トランザクションブランチおよびRPC発行先トランザクションブランチがトランザクション同期点メッセージ待ちとなり，トランザクションの決着に時間が掛かります。

（障害2）RPC発行元UAPがRPCの応答受信前にダウンした場合

この場合，RPC発行元トランザクションブランチは，サービス要求がどのプロセスで実行されているかがわからないため，RPC発行先トランザクションブランチにトランザクション同期点メッセージを送信できないで，RPC発行先トランザクションブランチはトランザクション同期点メッセージ待ちとなり，トランザクションの決着に時間が掛かります。

（障害3）RPC発行先UAPからの応答受信後にRPC発行元UAPとRPC発行先UAPがほぼ同時にダウンした場合

この場合，それぞれのトランザクションブランチを引き継いだトランザクション回復プロセスは，相手UAPプロセスのダウンを知らないため，すでに存在しないUAPプロセスにトランザクション同期点メッセージを送信してしまい，トランザクションの決着に時間が掛かることがあります。

type1

（障害1）が発生した場合，RPC発行元トランザクションブランチおよびRPC発行先トランザクションブランチは，トランザクション同期点メッセージ受信処理がタイムアウトすることによって，トランザクションを決着します。

（障害2）が発生した場合，RPC発行元トランザクションブランチは，RPC発行先トランザクションブランチにトランザクション同期点メッセージを送信しないでトランザクションを決着します。RPC発行先トランザクションブランチは，トランザクション同期点メッセージ受信処理がタイムアウトすることによって，トランザクションを決着します。

（障害3）が発生した場合，RPC発行元トランザクションブランチおよびRPC発行先トランザクションブランチは，トランザクション同期点メッセージ受信処理がタイムアウトすることによって，トランザクションを決着します。

type2

（障害1）が発生してトランザクションをコミットする場合はtype1と同じです。

（障害1）が発生してトランザクションをロールバックする場合，または（障害2）が発生した場合は，RPC発行元トランザクションブランチは，RPC発行先トランザクションブランチが存在するノードのトランザクションサービスプロセスにトランザクション同期点メッセージを送信後，トランザクションを決着します。トランザクション同期点メッセージを受信したトランザクションサービスプロセスは，該当するトランザクションブランチを処理中のプロセスに，トランザクション同期点指示を送信します。

（障害3）が発生した場合，RPC発行元トランザクションブランチおよびRPC発行先トランザクションブランチは，トランザクション同期点メッセージ受信処理がタイムアウトすることによって，トランザクションを決着します。

type3

（障害1）が発生してトランザクションをコミットする場合は，type1と同じです。

（障害1）が発生してトランザクションをロールバックする場合，（障害2）が発生した場合，または（障害3）が発生した場合，相手トランザクションブランチが存在するノードのトランザクションサービスプロセスに，トランザクション同期点メッセージを送信します。トランザクション同期点メッセージを受信したトランザクションサービスプロセスは，該当するトランザクションブランチを処理中のプロセスに，トランザクション同期点指示を送信します。

次に示す場合，このオペランドにtype2またはtype3を指定しても，トランザクションの決着に時間が掛かることがあります。

RPC実行中に，RPC発行先UAPの状態が変更となり（負荷増加，UAP終了，UAP閉塞など），ほかのノードの同一UAPにサービス要求が再転送された場合

相手先のOpenTP1がこのオプションをサポートしていないバージョンの場合

相手先トランザクションブランチがトランザクション同期点メッセージ受信処理以外で時間が掛かっている場合

TP1/Server BaseまたはTP1/LiNK以外とトランザクション連携をする場合，このオペランドにはtype1を指定または省略してください。

なお，このオペランドは，ユーザサービス定義またはrapリスナーサービス定義，およびユーザサービスデフォルト定義でも指定できます。

指定値の優先順位は次のとおりです（1.＞2.＞3.）。

ユーザサービス定義またはrapリスナーサービス定義

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

トランザクションサービス定義

トランザクショナルRPC実行プロセス（clttrnd）またはCUP実行プロセス（cltcond）で，この機能を有効にするには，クライアント環境定義またはクライアントサービス定義のtrn_partial_recovery_typeオペランドを指定する必要があります。

●max_socket_descriptors=ソケット用ファイル記述子の最大数

　〜〈符号なし整数〉((32〜2032))

OpenTP1制御下のプロセス※でのソケット用に使用するファイル記述子の最大数を指定します。

指定値の範囲は，適用OSがAIX，HP-UXまたはWindowsの場合は32〜2032，適用OSがSolarisまたはLinuxの場合は32〜1008です。

OpenTP1制御下のプロセス※は，システムサーバやユーザサーバとの間で，ソケットを使用したTCP/IP通信でプロセス間の情報交換をしています。そのため，同時に稼働するUAPプロセスの数，および通信する他ノードの数によって，このオペランドを変更する必要があります。

注※

MCFサービス（MCFマネジャサービス，MCF通信サービス，およびアプリケーション起動サービス）以外のOpenTP1プロセスが対象です。MCFサービスの場合は，「システムサービス情報定義」および「システムサービス共通情報定義」を参照してください。

ソケット用ファイル記述子の最大数の算出式を，次に示します。

↑(自ノード内UAPプロセス数※1＋トランザクションサービスを要求してくるノード内のtrnシステムプロセス数※2＋システムサービスプロセス数※3)／0.8↑

↑↑：小数点以下を切り上げます。

注※1

自ノード内UAPプロセス数は，次に示す値の合計です。

自OpenTP1内のUAPで，トランザクショナルRPCでサービス要求を送信するUAPプロセス数

自OpenTP1内のサービスに対し，トランザクショナルRPCでサービスを要求してくる他ノード内のUAPプロセス数

CUPから同時に起動するトランザクション数（クライアントサービス定義のparallel_countオペランドの指定値）

注※2

トランザクションサービスを要求してくるノードのtrnシステムプロセス数とは，次に示す値の合計です。

自OpenTP1のall_nodeオペランドに指定したノードのうち，自OpenTP1からトランザクショナルRPCでトランザクションを拡張するノードの，トランザクションサービス定義のtrn_recovery_process_countオペランドの値に1を加えた数

自ノード名を，OpenTP1のall_nodeオペランドに指定している他ノードのうち，トランザクショナルRPCで自OpenTP1にトランザクションを拡張しているノードの，トランザクションサービス定義のtrn_recovery_process_countオペランドの値に1を加えた数

注※3

システムサービスプロセス数とは，自OpenTP1内のシステムサービスプロセスの数です。自OpenTP1内のシステムサービスプロセスは，rpcstatコマンドで表示されるサーバ名をカウントすることで求められます。rpcstatコマンドで表示されるサーバ名のうち，マニュアル「OpenTP1　解説」のOpenTP1のプロセス構造に記載されているシステムサービスプロセスをカウントしてください。

このオペランドの指定が小さいと，OpenTP1制御下の他プロセスとのコネクションが設定できなくなるため，プロセスがKFCA00307-Eメッセージを出力して異常終了します。

ここで指定を省略した場合，システム共通定義の値を仮定します。

●trn_recovery_failmsg_interval=仕掛中トランザクション情報メッセージ間隔最小時間

　〜〈符号なし整数〉((0〜65535))《1800》（単位：秒）

KFCA00960-Iメッセージを出力する間隔を指定します。

トランザクションを回復できなかった際，以前にKFCA00960-Iメッセージを出力してからこのオペランドの指定時間が経過した場合には，再びメッセージを出力します。ただし次の場合はすぐに出力します。

トランザクション開始後，最初に回復に失敗したとき

OpenTP1終了処理開始後，最初に回復に失敗したとき

OpenTP1再開始後，最初に回復に失敗したとき

指定値が0の場合にはKFCA00960-Iメッセージを出力しません。

複数のトランザクションブランチを回復している場合は，このオペランドはそれぞれのトランザクションブランチに適用されます。同一のトランザクションブランチのメッセージだけが，このオペランドで指定された間隔で出力されます。

なお，1回のトランザクションの回復失敗で，KFCA00960-Iメッセージが2個以上出力される場合があります。これは，回復失敗の要因が複数存在するためです。KFCA00960-Iメッセージは，KFCA00990-Iメッセージよりもあとに出力される場合があります。

●trn_wait_rm_open=continue|stop|retry_continue|retry_stop

　〜《continue》

OpenTP1起動時に，OpenTP1以外が提供するリソースマネジャのオープン処理(xa_open関数)でエラーが発生したときの処置を指定します。

continue

xa_open関数エラーを無視してOpenTP1開始処理を続行します。

stop

xa_open関数エラーが発生した場合，OpenTP1開始処理を中止します。

retry_continue

xa_open関数エラーが発生した場合，OpenTP1開始処理を中断し，trn_retry_interval_rm_openオペランドで指定したインタバルでtrn_retry_count_rm_openオペランドで指定した回数だけxa_open関数発行をリトライします。 xa_open関数エラーが解消されなかったときは，エラーを無視してOpenTP1開始処理を続行します。

retry_stop

xa_open関数エラーが発生した場合， OpenTP1開始処理を中断し， trn_retry_interval_rm_openオペランドで指定したインタバルでtrn_retry_count_rm_openオペランドで指定した回数だけxa_open関数発行をリトライします。 xa_open関数エラーが解消されなかったときは，OpenTP1開始処理を中止します。

●trn_retry_interval_rm_open=xa_open関数発行リトライインタバル時間

　〜〈符号なし整数〉((1〜3600))《10》（単位：秒）

trn_wait_rm_openオペランドでretry_continueかretry_stopを指定したときのxa_open関数発行リトライをする間隔を指定します。

●trn_retry_count_rm_open=xa_open関数発行リトライ回数

　〜〈符号なし整数〉((1〜65535))《18》

trn_wait_rm_openオペランドでretry_continueかretry_stopを指定したときのxa_open関数発行リトライをする回数を指定します。

●thread_stack_size=OpenTP1内部で使用するスレッドスタック領域のサイズ

　〜〈符号なし整数〉((1024〜524288))《49152※》（単位：バイト）

注※

AIX版のuCosminexus TP1/Server Base(64)の場合は，デフォルト値が65536となります。

OpenTP1の内部で使用するスレッドスタック領域のサイズを指定します。リソースマネジャ監視サービスのスレッドスタック領域は262,144バイトに拡張されているため，XA連携するリソースマネジャで262,144バイト以上のスレッドスタック領域が必要な場合だけ指定してください。このオペランドを指定した場合のメモリ使用量の算出式を次に示します。

スレッドスタック領域のサイズ（単位：バイト）=トランザクションサービス定義のtrn_recovery_process_countオペランドの指定値に2を加えた数×thread_stack_sizeオペランドの指定値×2

●polling_control_data=Y|N

　〜《N》

トランザクションリカバリデーモンで，トランザクション回復要求の受信待ちの状態のときに，定期的に待ち状態に割り込んで，一時クローズ処理要求が到着していないかどうかを検査することを指示します。

Y

トランザクション回復要求の受信待ち状態に定期的に割り込み，一時クローズ処理要求が到着していないかどうかを検査します。

N

トランザクション回復要求の受信待ち状態に割り込まないで，トランザクション回復要求が到着するまで待ち状態を継続します。

●thread_yield_interval=ソケットの再利用指示を受信できる契機を与えるインタバル時間

　〜〈符号なし整数〉((1〜86400))《90》（単位：秒）

トランザクションリカバリデーモンで，トランザクション回復要求の受信待ちの状態のときに，定期的に待ち状態に割り込んで，一時クローズ処理要求が到着していないかどうかを検査する場合の検査インタバル時間を秒単位で指定します。

また，トランザクション回復要求を待つことなく次々にトランザクション回復要求を受け付けている場合には，連続してトランザクション回復要求を受け付けた時間が一定時間を超えたところで，一時クローズ処理要求が到着していないかどうかを検査します。このオペランドは，このインタバル値としても使用されます（連続してトランザクション回復要求を受け付けた時間がこのオペランド指定値を超えたときの一時クローズ処理要求到着検査には，シグナルによる割り込みは発生しません）。

このオペランドの指定値は，一時クローズ処理要求を送信したプロセスが応答を待つ時間（180秒：ipc_sockctl_watchtimeオペランドのデフォルト値）よりも小さい値を設定する必要があります。

トランザクション回復要求待ち状態に割り込んで，一時クローズ処理要求受信を検査する機能は，polling_control_dataオペランドにYを指定した場合にだけ動作します。連続してトランザクション回復要求を受け付けたときに一時クローズ処理要求受信を検査する機能は，polling_control_dataオペランドの指定に関係なく，動作します。

このオペランドに最大値を指定した場合は，polling_control_dataオペランドの指定に関係なく，一時クローズ処理要求が到着していないかどうかの検査を実行しません。

●groups=グループ識別子〔,グループ識別子〕

　〜〈符号なし整数〉((0〜4294967294))

このサービスグループのグループアクセスリストを設定します。

OSに登録されているグループIDを指定してください。このオペランドには16個まで指定できます。

このオペランドの指定に関係なく，OpenTP1管理者のグループIDはsetgid()システムコールによって自動的に設定されます。

最大値はOSに依存するので，使用しているOSのマニュアルを参照してください。

●trn_xar_use=Y|N

　〜《N》

XAリソースサービスを使用するかどうかを指定します。XAリソースサービスを使用する場合，XAリソースサービス定義で実行環境を定義する必要があります。また，システム共通定義のjnl_fileless_optionオペランドにYを指定している場合は，XAリソースサービスを使用できません。

Y

XAリソースサービスを使用します。

N

XAリソースサービスを使用しません。

●trn_start_recovery_mode=stop|wait|continue

　〜《stop》

trnstring定義コマンドで-mオプションを指定したリソースマネジャのOpenTP1開始処理でのトランザクション回復処理方式を指定します。このオペランドは再開始時に変更または削除できます。

stop

一定時間（trn_start_recovery_watch_timeオペランドの指定値）以上のリトライ処理で回復処理を行っても，回復処理が完了しない場合，OpenTP1の開始処理を中止します。このとき，アボートコード「t860004」を出力します。

wait

trnstring定義コマンドの-mオプションで指定したリソースマネジャの中で，OpenTP1に関連するすべてのトランザクション回復処理が完了するまで，リトライ処理が実行されます。このリトライ処理を中断するには，dcstopコマンドでOpenTP1を強制停止してください。

continue

一定時間（trn_start_recovery_watch_timeオペランドの指定値）以上のリトライ処理で回復処理を行っても，回復処理が完了しない場合，回復処理を中断し，OpenTP1の開始処理を続行します。

●trn_start_recovery_watch_time=リトライ経過時間

　〜〈符号なし整数〉((0〜65535))《600》（単位：秒）

trnstring定義コマンドで-mオプションを指定した場合の，オンライン前回復処理が完了するまでのリトライ上限時間を指定します。0を指定した場合は，リトライをしません。このオペランドは，trn_start_recovery_modeオペランドでwait以外を指定した場合に有効です。このオペランドは再開始時に変更または削除できます。

●trn_start_recovery_interval=リトライ間隔時間

　〜〈符号なし整数〉((0〜65535))《3》（単位：秒）

trnstring定義コマンドで-mオプションを指定した場合の，オンライン前回復処理が完了するまでのリトライ間隔時間を指定します。0を指定した場合は，すぐに次のリトライ処理を行います。trn_start_recovery_watch_timeオペランドで0を指定した場合は，このオペランドで指定した値は無効になります。このオペランドは再開始時に変更または削除できます。

●trn_xa_commit_error=down|force

　〜《down》

複数のリソースをアクセスするトランザクションがコミットに決定したあと，コミットできなくなったリソースマネジャが発生した場合※の処理を指定します。

この現象が発生した場合，該当トランザクションでアクセスしたリソース間の整合性は失われているおそれがあります。

注※

リソースマネジャに対して発行したxa_commit関数がロールバックした際のコード（XAER_RMERR，またはXA_RBから始まるコード）でリターンした場合

down

OpenTP1システムをダウンさせます。

システムダウン後に，リソースの整合性を回復し，OpenTP1を強制正常開始してください。

force

リソースの不整合を無視してシステムを続行します。

この場合，コミットを行う関数（dc_trn_chained_commit，dc_trn_unchained_commit()，tx_commit()）は正常終了します。不整合が発生しても問題がないリソースの場合，またはテスト中の場合などに指定します。

●trn_prf_event_trace_level=TRNイベントトレースの取得レベル

　〜((00000000〜00000007))《00000007》

TRNイベントトレースの取得レベルを指定します。このオペランドは，イベントトレースの取得機能を制御します。このオペランドの指定を省略した場合は，入口情報，正常出口情報，およびエラー出口情報をトレースとして取得します。TRNイベントトレースの詳細については，マニュアル「OpenTP1 解説」のトレース機能の記述を参照してください。

00000000

TRNイベントトレースを取得しません。

00000001

イベントの入口でトレースを取得します（入口情報）。

00000002

イベントの出口でトレースを取得します（正常出口情報）。

trn_prf_event_trace_conditionオペランドに，xafuncを指定した場合は，XA関数のリターン値が0以上のときにトレースを取得します。

00000004

イベントの出口で障害が発生したときにトレースを取得します（エラー出口情報）。

00000007

イベントの入口，および出口（障害発生時を含む）でトレースを取得します（入口情報，正常出口情報，およびエラー出口情報）。

これらの指定値は，論理和でも指定できます。例えば，00000003を指定すると，00000001と00000002の両方を指定したときと同じ動作になります。

取得したトレースをファイル出力または編集出力するには，prfgetコマンド，prfedコマンド，またはdcalzprfコマンドを使用します。ファイルの出力結果は，$DCDIR/spool/dctrninf/trace/prfに保存されます。これらのコマンドの詳細については，マニュアル「OpenTP1 運用と操作」を参照してください。

このオペランドの使用は，TP1/Extension 1をインストールしていることが前提です。TP1/Extension 1をインストールしていない場合の動作は保証できません。

●trn_prf_event_trace_condition=トレース取得種類〔，トレース取得種類〕

　〜《xafunc》

取得するTRNイベントトレースの種類を指定します。取得したいトレースによって，複数の種類を指定できます。このオペランドの指定を省略した場合は，XA関数についてのトレースを取得します。

xafunc

XA関数についてのトレースを取得します。

trnservice

トランザクションサービスの動作状況についてのトレースを取得します。

なお，このオペランドは，TP1/Extension 1をインストールしていることが前提です。TP1/Extension 1をインストールしていない場合の動作は保証できませんので，ご了承ください。

●trn_completion_limit_time=トランザクション完了限界時間

　〜〈符号なし整数〉((0〜65535))《0》（単位：秒）

トランザクションブランチの開始から終了までの最大実行時間を指定します。指定時間を超えた場合，このトランザクションブランチのプロセスが異常終了したあとに，トランザクションブランチが回復プロセスによってコミットまたはロールバックのどちらかに決着して終了します。0を指定した場合は，トランザクションブランチの最大実行時間を監視しません。

UAPが異常終了した場合に閉塞するかどうかはholdオペランド，term_watch_timeオペランドの指定によります。詳細については，ユーザサービス定義のholdオペランドおよびterm_watch_timeオペランドの説明を参照してください。

このオペランドの監視対象区間は，dc_trn_begin関数などの呼び出しやサービス関数の開始によるトランザクションの開始から，トランザクションの同期点処理終了情報（TJ）の取得後であるトランザクションブランチの終了までです。ただし，トランザクションの最適化が行われた場合，サーバ側のトランザクションブランチに対する監視が終了するのは，クライアント側に応答を返したあとです。このオペランドの監視対象区間の詳細および各種タイマ監視との関係については，「付録A.2　トランザクションの時間監視」を参照してください。

なお，このオペランドは，ユーザサービス定義またはrapリスナーサービス定義，およびユーザサービスデフォルト定義でも指定できます。

指定値の優先順位は次のとおりです（1.＞2.＞3.）。

ユーザサービス定義またはrapリスナーサービス定義

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

トランザクションサービス定義

トランザクショナルRPC実行プロセス（clttrnd）またはCUP実行プロセス（cltcond）で，この機能を有効にするには，クライアントサービス定義のtrn_completion_limit_timeオペランドを指定する必要があります。

また，子トランザクションブランチを処理しているプロセスが，サービス関数処理以外のタイミングでこのオペランドの指定時間を超えて異常終了した場合，RPCコールの呼び出し元は，応答待ち時間が満了するまで待ち合わせることがあります。

注

トランザクション完了限界時間の精度は秒単位です。そのため，タイミングによっては，このオペランドに指定した値よりも最大約1秒長い時間でプロセスを強制停止することがあります。

●trn_extend_function=トランザクションサービスの機能の拡張レベル

　〜〈16進数字〉((00000000〜00000003))《00000000》

トランザクションサービスの機能の拡張レベルを，次の中から指定します。

次の指定値で示す機能の拡張レベルを複数指定する場合，それぞれの指定値の論理和を指定してください。

00000000

トランザクションサービスの機能を拡張しません。

00000001

00000001は，トランザクションブランチが関連するすべてのOpenTP1ノードのトランザクションサービス定義で指定してください。

トランザクションブランチが関連するすべてのOpenTP1ノードのうち，このオペランドの指定がないノードが一つ以上ある場合，1相コミットでリソースマネジャからXAER_NOTAが返されたときは，ルートトランザクションブランチのリターン値は変更されません。

1相コミットで，リソースマネジャからXAER_NOTAが返された場合の関数のリターン値を次の表に示します。

関数

リターン値

trn_extend_function=00000000の場合

trn_extend_function=00000001の場合

dc_trn_chained_commit

（CBLDCTRN('C-COMMIT')）

DC_OK（00000）

DCTRNER_HAZARD（00904），DCTRNER_HAZARD_NO_BEGIN（00927）

dc_trn_unchained_commit

（CBLDCTRN('U-COMMIT')）

DC_OK（00000）

DCTRNER_HAZARD（00904）

tx_commit

（TXCOMMIT）

TX_OK（TX-OK）

TX_HAZARD（TX-HAZARD），TX_HAZARD_NO_BEGIN（TX-HAZARD-NO-BEGIN）

dc_mcf_commit

（CBLDCMCF('COMMIT')）

DCMCFRTN_00000（00000）

DCMCFRTN_HAZARD（70908）

注

括弧内の英数字は，COBOL言語を使用した場合の関数名およびステータスコードです。

00000002

00000002は，Hitachi System Information Captureのサーバ間連携機能を使用して，OpenTP1のprfトレースとHiRDBのSQLを関連付ける場合に指定してください。

この指定が有効となるのは，HiRDBとトランザクション連携をしているキュー受信型SPPの場合だけです。

この機能を使用する場合は次のことに注意してください。

HiRDBとXA連携する際に使用するHiRDBのRM関連オブジェクト名はシングルスレッド用（複数接続機能対応）のライブラリを使用してください。このライブラリはUAPへのリンケージだけでなく，trnlnkrmコマンドで指定するRM関連オブジェクト名にも指定してください。

ライブラリ名の詳細は，マニュアル「HiRDB システム導入・設計ガイド」を参照してください。

trnstring定義コマンドに指定する，HiRDBのxa_open関数用文字列は，複数接続機能に対応した文字列形式としてください。

複数接続機能対応のライブラリを使用するため，UAPで接続先のHiRDBを指定する必要があります。接続先の指定方法は，マニュアル「HiRDB UAP開発ガイド」を参照してください。

この機能を使用する場合は，ユーザサービス定義のuidオペランドは指定できません。

●trn_rcv_open_close_scope=Y|N

　〜《N》

複数のリソースマネジャにアクセスしていたトランザクションの回復処理で，XA関数（xa_open()，xa_commit()，xa_rollback()，xa_close()）の発行順序を変更するかどうかを指定します。発行順序の変更は，OpenTP1システムに登録されたOpenTP1が提供するリソースマネジャを除く，すべてのリソースマネジャに対して行われます。一部のリソースマネジャの回復処理で発行されるxa_open()がエラーとなり，回復処理が正常に実行されない場合に指定します。

Y

XA関数の発行順序を変更します。

N

XA関数の発行順序を変更しません。

このオペランドの指定による，XA関数の発行順序の例を示します。

例：

次の条件を満たす例で説明します。

同一ノード内のSUPでトランザクションを開始し，SUPからSPPにRPCコールでサービスを要求し，同一リソースマネジャに拡張子（-i）を使用してアクセスするグローバルトランザクションを構成した。

次のように定義している。

トランザクションサービス定義：

　trnstring -n TEST_RM -i _A

　trnstring -n TEST_RM -i _B

ユーザサービス定義（SUP）：trnrmid -n TEST_RM -i _A

ユーザサービス定義（SPP）：trnrmid -n TEST_RM -i _B

この例での，グローバルトランザクションの回復処理を次に示します。

図3‒6　グローバルトランザクションの回復処理の例

この例の場合の，オペランドの指定によるXA関数の発行順序の違いを次に示します。

trn_rcv_open_close_scopeオペランドを省略，またはNを指定

トランザクション回復プロセス（trnrvd）

1.　xa_open(TEST_RM_A)

2.　xa_open(TEST_RM_B)

3.　xa_commit(TEST_RM_A)またはxa_rollback(TEST_RM_A)

4.　xa_commit(TEST_RM_B)またはxa_rollback(TEST_RM_B)

5.　xa_close(TEST_RM_A)

6.　xa_close(TEST_RM_B)

trnstring定義コマンドで-sオプションを省略した場合も，発行順序は同様になります。

trn_rcv_open_close_scopeオペランドにYを指定

トランザクション回復プロセス（trnrvd）

1.　xa_open(TEST_RM_A)

2.　xa_commit(TEST_RM_A)またはxa_rollback(TEST_RM_A)

3.　xa_close(TEST_RM_A)

4.　xa_open(TEST_RM_B)

5.　xa_commit(TEST_RM_B)またはxa_rollback(TEST_RM_B)

6.　xa_close(TEST_RM_B)

trnstring定義コマンドに-sオプションを指定した場合も，発行順序は同様になります。

複数のリソースマネジャが登録されている状態で，特定のリソースマネジャにだけこの機能を使用したい場合は，trnstring定義コマンドの-sオプションを使用してください。詳細については，trnstring定義コマンドの説明を参照してください。

●watch_time=最大応答待ち時間

　〜〈符号なし整数〉((0〜65535))（単位：秒）

RPCによってプロセス間で通信する場合，サービス要求を送信してからサービスの応答が返るまでの待ち時間の最大値を指定します。

OpenTP1の終了処理で，このオペランドで指定した時間だけ終了処理を待ち合わせる場合があります。したがって，大きな値を指定した場合，OpenTP1の終了処理に時間が掛かる場合があります。

指定時間を過ぎても応答がない場合は，RPCは送受信タイムアウトとしてエラーリターンします。

0を指定した場合は，応答を受信するまで待ち続けます。0を指定した場合，OpenTP1が終了しない場合があります。

省略した場合は，システム共通定義のwatch_timeオペランドの値を仮定します。

このオペランドは，システム共通定義のwatch_timeオペランドのデフォルト値で使用してください。

特別なチューニングを必要とする場合以外は，このオペランドの内容を変更しないことをお勧めします。

システム共通定義のwatch_timeオペランドのデフォルト値よりも，極端に小さな値または大きな値を指定すると，OpenTP1ダウンに至る障害が発生する場合がありますので，ご注意ください。

コマンド形式

次ページ以降に記述しています。

putenv形式のオペランド

●環境変数名　環境変数値

　〜〈文字列〉

XAインタフェースでリソースマネジャと連携する場合に，トランザクション回復サービスおよびリソースマネジャ監視サービスがリソースマネジャにアクセスするために必要な環境変数を指定します。

指定する必要のある環境変数名と環境変数値はリソースマネジャによって異なります。

なお，OpenTP1では，'dc'で始まる環境変数名は使用しないでください。

dcputenv形式のオペランド

●環境変数名　環境変数値

　〜〈文字列〉

XAインタフェースでリソースマネジャと連携する場合に，トランザクション回復サービスおよびリソースマネジャ監視サービスがリソースマネジャにアクセスするために必要な環境変数を指定します。環境変数を指定した場合，その値も取得します。

指定する必要のある環境変数名と環境変数値はリソースマネジャによって異なります。

なお，OpenTP1では，'dc'で始まる環境変数名は使用しないでください。

trnstring

名称

リソースマネジャのアクセス用文字列または拡張子の指定

形式

trnstring  -n  リソースマネジャ名
         〔-i  リソースマネジャ拡張子〔,リソースマネジャ拡張子〕…〕
         〔-o  "トランザクションサービス用xa_open関数用文字列"〕
         〔-c  "トランザクションサービス用xa_close関数用文字列"〕
         〔-O  "ユーザサーバ用xa_open関数用文字列"〕
         〔-C  "ユーザサーバ用xa_close関数用文字列"〕〔-d〕
         〔-e〕〔-m〕〔-r〕〔-s〕

機能

リソースマネジャにアクセスするための文字列または拡張子を定義します。

OpenTP1のトランザクションサービスでは，X/OpenのXAインタフェースに準拠し，リソースマネジャと連携してトランザクションを実行します。XAインタフェースでは，リソースマネジャが規定したxa_open関数用文字列，およびxa_close関数用文字列を通知する必要があります。

ユーザサーバが，OpenTP1下のトランザクション内で，OpenTP1以外が提供するリソースマネジャをアクセスする場合（トランザクション制御用オブジェクトファイルをユーザサーバにリンケージした場合），そのリソースマネジャのxa_open関数用文字列，およびxa_close関数用文字列を指定します。xa_open関数，およびxa_close関数は，このコマンドで指定された文字列を引数として，ユーザサーバ起動，および終了時にトランザクションサービスが発行します。

トランザクションサービスは，ユーザサーバ異常終了時，またはOpenTP1再開始時に，ユーザサーバが行っていたトランザクションを回復します。その際xa_open関数およびxa_close関数を使用するため，トランザクションサービスには，ユーザサーバがアクセスする，すべてのリソースマネジャのxa_open関数用，xa_close関数用文字列を定義する必要があります。

-iオプションは，一つのリソースマネジャに複数の拡張子を割り当てて，複数の制御単位としてアクセスする場合にだけ指定してください。OpenTP1は，このオプションを指定したリソースマネジャに対して，リソースマネジャ名を「リソースマネジャ名＋リソースマネジャ拡張子」に修飾して管理します。そのため，リソースマネジャ名だけではアクセスできません。ユーザサービス定義，またはユーザサービスデフォルト定義でtrnrmid定義コマンドを指定する必要があります。

-iオプションに指定するリソースマネジャを識別するための文字列は，すべてのtrnstring定義コマンドで重複しないように指定してください。一つの定義ファイル内に同一リソースマネジャ名で，同一リソースマネジャ拡張子のtrnstring定義コマンドを複数指定した場合，最後に指定した定義が有効となります。

-o，-cオプションには，トランザクションサービスプロセスからxa_open関数，xa_close関数を発行する場合に使用する文字列を指定してください。-O，-Cオプションには，ユーザサーバプロセスからxa_open関数，xa_close関数を発行する場合に使用する文字列を指定してください。

-eオプションは，静的リソースマネジャに対するトランザクションブランチ開始時にxa_start関数でエラーが発生した場合，リソースマネジャに対してxa_close関数，xa_open関数，xa_start関数の順にリトライ処理を行うときに指定します。なお，-eオプションを指定しない場合，xa_open関数，xa_start関数の順にリトライ処理を行います。

指定する文字列は，各リソースマネジャのマニュアルを参照してください。

NULL文字列を通知する必要がある場合は，-o，-c，-O，または-Cオプションを省略してください。

次の両方の条件を満たす場合は，このコマンドを定義する必要はありません。

一つのリソースマネジャに対して，複数のリソースマネジャ拡張子を割り当てて，複数の制御単位としてアクセスする必要がない場合

xa_open関数用文字列とxa_close関数用文字列の両方がNULL文字列を通知する必要がある場合

必要な文字列を定義しなかった場合，または不当な文字列を指定した場合は，ユーザサーバの起動，終了，またはトランザクションの回復がエラーとなります。

オプション

●-n　リソースマネジャ名

　〜〈1〜31文字の識別子〉

OpenTP1下のトランザクションでアクセスするリソースマネジャ名を指定します。

OpenTP1が提供するリソースの場合，OpenTP1_MCFだけ指定が必要です。ただし，OpenTP1_MCFでも次の場合には指定を省略できます。

MCFマネジャ環境定義mcfmenvのidオペランドを省略した場合，またはAを指定した場合

●-i　リソースマネジャ拡張子

　〜〈1〜2文字の識別子〉

一つのリソースマネジャを複数の制御単位としてアクセスする場合，リソースマネジャ名を「リソースマネジャ名＋リソースマネジャ拡張子」に修飾するための文字列を指定します。

複数の拡張子が同じxa_open関数用文字列，またはxa_close関数用文字列を使用する場合は，このオプションに複数の拡張子を指定できます。その場合は，拡張子と拡張子の間をコンマ'，'で区切ります。

すべてのtrnstring定義コマンドで指定した拡張子は重複しないようにしてください。

トランザクションに関係するMCFを管理するために，MCFに対してのリソースマネジャ拡張子を指定しなければなりません。このオプションに指定するMCFのリソースマネジャ拡張子は，ユーザサーバがアクセスできるプロセス識別子と，該当するノードで動作するMCFのマネジャ定義で指定したMCFマネジャプロセス識別子をすべて指定してください。

●-o　"トランザクションサービス用xa_open関数用文字列"

　〜〈1〜256の文字列〉

OpenTP1のトランザクションサービスプロセスからxa_open関数を発行する場合に使用する文字列を指定します。

文字列に指定可能な文字として「ASCII印字可能文字（ASCIIコード32〜126）」を使用できます。

ただし，「"（ASCIIコード33）」は引用符以外には使用できません。

指定する文字列は，各リソースマネジャのマニュアルを参照してください。

NULL文字列を通知する必要がある場合は，このオプションを省略してください。

●-c　"トランザクションサービス用xa_close関数用文字列"

　〜〈1〜256の文字列〉

OpenTP1のトランザクションサービスプロセスからxa_close関数を発行する場合に使用する文字列を指定します。

文字列に指定可能な文字として「ASCII印字可能文字（ASCIIコード32〜126）」を使用できます。

ただし，「"（ASCIIコード33）」は引用符以外には使用できません。

指定する文字列は，各リソースマネジャのマニュアルを参照してください。

NULL文字列を通知する必要がある場合は，このオプションを省略してください。

●-O　"ユーザサーバ用xa_open関数用文字列"

　〜〈1〜256の文字列〉

ユーザサーバプロセスからxa_open関数を発行する場合に使用する文字列を指定します。

文字列に指定可能な文字として「ASCII印字可能文字（ASCIIコード32〜126）」を使用できます。

ただし，「"（ASCIIコード33）」は引用符以外には使用できません。

指定する文字列は，各リソースマネジャのマニュアルを参照してください。

NULL文字列を通知する必要がある場合は，このオプションを省略してください。

●-C　"ユーザサーバ用xa_close関数用文字列"

　〜〈1〜256の文字列〉

ユーザサーバプロセスからxa_close関数を発行する場合に使用する文字列を指定します。

文字列に指定可能な文字として「ASCII印字可能文字（ASCIIコード32〜126）」を使用できます。

ただし，「"（ASCIIコード33）」は引用符以外には使用できません。

指定する文字列は，各リソースマネジャのマニュアルを参照してください。

NULL文字列を通知する必要がある場合は，このオプションを省略してください。

●-d

このリソースマネジャが，コミット最適化およびプリペア最適化に対応していない場合に，必ず指定します。コミット最適化およびプリペア最適化に対応していないリソースマネジャでこの指定を省略すると，トランザクションが決着できなかったり，リソースマネジャがダウンしたりすることがあります。

このオプションを指定したリソースマネジャがトランザクションに参加した場合，トランザクションブランチはコミット最適化およびプリペア最適化をしません。

●-e

-nオプションで指定したリソースマネジャに対するトランザクションブランチ開始時にxa_start関数でエラーが発生した場合，リソースマネジャに対してxa_close関数，xa_open関数，xa_start関数の順にリトライ処理を行うときに指定します。このオプションを指定しない場合，xa_start関数でエラーが発生したとき，xa_open関数，xa_start関数の順にリトライ処理を行います。

●-m

このリソースマネジャ内の未決着トランザクションの回復処理を，OpenTP1がオンラインになる前に行う場合に指定します。

このオプションを指定すると，OpenTP1開始時にリソースマネジャ監視サービスがリソースマネジャに対してxa_recover関数を発行し，取得した未決着トランザクション情報を基に，trn_start_recovery_mode，trn_start_recovery_watch_timeおよびtrn_start_recovery_intervalオペランドに従ってトランザクション回復処理を行います。

●-r

OpenTP1の開始処理，またはオンライン処理で，リソースマネジャから未決着トランザクション情報の通知があるまで，トランザクションの回復処理を待ち合わせるときに指定します。トランザクション回復プロセスからリソースマネジャに対して発行するxa_recover関数が未決着トランザクション情報を取得するまで，トランザクションの回復処理は行われません。このオプションを指定したときは，指定したリソースマネジャの数分のトランザクション並行回復プロセスを確保してください（トランザクション並行回復プロセス数は，trn_recovery_process_countオペランドで指定します）。このオプションは再開始時に変更または削除できます。

なお，このオプションを有効にするには，オープン文字列※を指定する必要があります。

注※

Oracle9iまでは，OPS_FAILOVER=Tをオープン文字列に指定してください。

Oracle 10gでは，RAC_FAILOVER=Tをオープン文字列に指定してください。

Oracle 11g，Oracle 12cでは，指定する必要はありません。

●-s

特定のリソースマネジャにアクセスしていたトランザクションの回復処理で，XA関数（xa_open()，xa_commit()，xa_rollback()，xa_close()）の発行順序を変更するかどうかを指定します。発行順序の変更は，OpenTP1システムに登録されたOpenTP1が提供するリソースマネジャを除く，特定のリソースマネジャに対してだけ行われます。一部のリソースマネジャの回復処理で発行されるxa_open()がエラーとなり，回復処理が正常に実行されない場合に指定します。

OpenTP1システムに登録されているすべてのリソースマネジャ（OpenTP1が提供するリソースマネジャは対象外）にこの機能を使用したい場合は，trn_rcv_open_close_scopeオペランドにYを指定してください。オペランドの詳細，およびオプションの指定によるXA関数の発行順序の例については，trn_rcv_open_close_scopeオペランドの説明を参照してください。

XAリソースサービス定義

形式

set形式

〔set xar_eventtrace_level=ERR|INF|ALL〕
〔set xar_eventtrace_record=XARイベントトレース情報ファイルの
                            最大出力レコード数〕
〔set xar_session_time=アイドル状態のトランザクションブランチの監視時間〕
〔set xar_msdtc_use=Y|N〕
〔set xar_prf_trace_level=XAR性能検証用トレース情報の取得レベル〕

コマンド形式

xarfile  -t　online|backup
         -a　物理ファイル名

機能

XAリソースサービスを使用してトランザクション管理をするための実行環境を定義します。

説明

set形式のオペランド

●xar_eventtrace_level=ERR|INF|ALL

　〜《ERR》

XARイベントトレース情報の出力レベルを指定します。

ERR

エラー出口情報をXARイベントトレースに出力します。

INF

エラー情報出口および正常出口情報をXARイベントトレースに出力します。

ALL

エラー出口情報，正常出口情報およびそのほかの情報を含めた，すべてのXARイベントトレース情報をXARイベントトレースに出力します。

本番環境では，ERRを指定することをお勧めします。ERR以外を指定した場合，I/O回数が増加するため，処理速度が低下します。

●xar_eventtrace_record=XARイベントトレース情報ファイルの最大出力レコード数

　〜〈符号なし整数〉((1〜65535))《8192》

XARイベントトレース情報ファイルの最大出力レコード数を指定します。

●xar_session_time=アイドル状態のトランザクションブランチの監視時間

　〜〈符号なし整数〉((10〜65535))《180》（単位：秒）

End()からPrepare()までのアイドル状態のトランザクションブランチを監視する時間を指定します。指定された時間を超えた場合は，メッセージを出力してトランザクションブランチをロールバックします。アイドル状態を監視するインタバル時間は，10秒です。そのため，検知するのに時間が掛かる場合があります。

●xar_msdtc_use=Y|N

　〜《N》

MSDTC連携機能を使用するかどうかを指定します。

Y

MSDTC連携機能を使用します。

N

MSDTC連携機能を使用しません。

●xar_prf_trace_level=XAR性能検証用トレース情報の取得レベル

　〜((00000000〜00000003))《00000003》

XAR性能検証用トレースの取得レベルを指定します。複数の取得レベルを指定したい場合は，それぞれの指定値の論理和を指定してください。

XAR性能検証用トレースの詳細については，マニュアル「OpenTP1 解説」の障害の原因解析の説明を参照してください。

00000000

XAR性能検証用トレースを取得しません。

00000001

アプリケーションサーバからのトランザクション要求の入口，および出口でトレース（イベントID：0x4a00〜0x4a0f）を取得します。

00000002

OpenTP1のトランザクション処理の入口，および出口でトレース（イベントID：0x4b00〜0x4b0f）を取得します。

取得したトレースをファイル出力または編集出力するには，prfgetコマンド，prfedコマンド，またはdcalzprfコマンドを使用します。ファイルの出力結果は，$DCDIR/spool/dcxarinfに保存されます。これらのコマンドの詳細については，マニュアル「OpenTP1 運用と操作」を参照してください。

このオペランドの使用は，TP1/Extension 1をインストールしていることが前提です。TP1/Extension 1をインストールしていない場合の動作は保証できません。

コマンド形式

次ページ以降に記述しています。

xarfile

名称

XARファイルの指定

形式

xarfile  -t　online|backup
         -a　物理XARファイル名

機能

XAリソースサービスで使用する物理XARファイル名を指定します。

物理XARファイルには，オンライン用XARファイルとバックアップ用XARファイルの二つがあり，両方指定する必要があります。

オンライン用XARファイルとバックアップ用XARファイルを，それぞれ複数指定することはできません。

オンライン用XARファイルとバックアップ用XARファイルに指定するファイルは，同一のレコード数，同一のレコード長である必要があります。また，レコード数は，トランザクションサービス定義のtrn_tran_process_countオペランドで指定した値よりも大きいファイルを指定する必要があります。

オプション

●-t online|backup

XARファイルのタイプを指定します。

online

オンライン用XARファイルとして使用します。

backup

バックアップ用XARファイルとして使用します。

●-a　物理XARファイル名

　〜〈1〜63文字のパス名〉

物理XARファイル名を指定します。

インタバルサービス定義

形式

set形式

〔set  watch_time=最大応答待ち時間〕

コマンド形式

なし。

機能

各システムサーバへ提供するインタバルタイマ機能の実行環境を定義します。

説明

set形式のオペランド

●watch_time=最大応答待ち時間

　〜〈符号なし整数〉((0〜65535))（単位：秒）

RPCによってプロセス間で通信する場合，サービス要求を送信してからサービスの応答が返るまでの待ち時間の最大値を指定します。

OpenTP1の終了処理で，このオペランドで指定した時間だけ終了処理を待ち合わせる場合があります。したがって，大きな値を指定した場合，OpenTP1の終了処理に時間が掛かる場合があります。

指定時間を過ぎても応答がない場合は，RPCは送受信タイムアウトとしてエラーリターンします。

0を指定した場合は，応答を受信するまで待ち続けます。0を指定した場合，OpenTP1が終了しない場合があります。

省略した場合は，システム共通定義のwatch_timeオペランドの値が仮定されます。

このオペランドは，システム共通定義のwatch_timeオペランドのデフォルト値で使用してください。

特別なチューニングを必要とする場合以外は，このオペランドの内容を変更しないことをお勧めします。

システム共通定義のwatch_timeオペランドのデフォルト値よりも，極端に小さな値または大きな値を指定すると，OpenTP1ダウンに至る障害が発生する場合がありますので，ご注意ください。

コマンド形式

なし。

ステータスサービス定義

形式

set形式

  set sts_file_name_1="論理ファイル名","A系ステータスファイル名"
                     ,"B系ステータスファイル名"
〔set sts_file_name_2="論理ファイル名","A系ステータスファイル名"
                     ,"B系ステータスファイル名"〕
〔set sts_file_name_3="論理ファイル名","A系ステータスファイル名"
                     ,"B系ステータスファイル名"〕
〔set sts_file_name_4="論理ファイル名","A系ステータスファイル名"
                     ,"B系ステータスファイル名"〕
〔set sts_file_name_5="論理ファイル名","A系ステータスファイル名"
                     ,"B系ステータスファイル名"〕
〔set sts_file_name_6="論理ファイル名","A系ステータスファイル名"
                     ,"B系ステータスファイル名"〕
〔set sts_file_name_7="論理ファイル名","A系ステータスファイル名"
                     ,"B系ステータスファイル名"〕
〔set sts_initial_error_switch=stop|continue|excontinue〕
〔set sts_single_operation_switch=stop|continue〕
〔set sts_last_active_file="論理ファイル名"〕
〔set sts_last_active_side=A|B〕
〔set watch_time=最大応答待ち時間〕

コマンド形式

なし。

機能

OpenTP1システム環境下で動作する各システムサービスの状態管理をするための実行環境を定義します。一つのノードに一つのステータスサービスがあります。

ステータスサービス定義ではステータスファイルの名称を最大7個指定できます。

OpenTP1システムの正常開始時に，ステータスサービス定義で最初に指定したステータスファイルが現用になります。残りのステータスファイルは予備になります。

再開始時には，前回の現用ファイルを引き継ぎます。

ステータスファイルは，信頼性を高めるためにA系とB系の二重で管理します。

現用のステータスファイルには，A系とB系で同じ内容が書き込まれます。

このため，ステータスファイルの実体は，すべて同じレコード長のファイルを指定します。また，一つの論理ファイルごとに同じ容量のファイルを指定します。

A系またはB系の物理ファイルは，複数のディスクに分散させて作成してください。一つのディスク上に同じ系のすべての物理ファイルを作成すると，ディスクの全面障害が発生した場合，その系は使用できません。例えば，一つのディスク上に同じ系の物理ファイルを作成した場合，ディスク障害発生時にA系，B系の二重書きできる世代がなくなるため，OpenTP1を緊急停止させるか，または片系運転状態となり危険です。

OpenTP1システムの正常開始時，再開始時またはオンライン中にステータスファイル障害が発生した場合，OpenTP1システムを停止させないために，ステータスサービスがステータスファイルをスワップします。

ステータスファイルをスワップするには，現用ファイルのほかに，予備用のステータス論理ファイルを定義する必要があります。

説明

set形式のオペランド

●sts_file_name_1〜sts_file_name_7="論理ファイル名"，"A系ステータスファイル名"，"B系ステータスファイル名"

最大7個のステータスファイルを指定できます。

1個を現用ファイルとして，残り6個を予備ファイルとして作成します。

それぞれのステータスファイルでは，信頼性を高めるために，A系ステータスファイルとB系ステータスファイルの二つの同一ファイルを作成します。

なお，sts_file_name_1からsts_file_name_7に指定する論理ファイル名，A系ステータスファイル名，およびB系ステータスファイル名は重複して指定できません。

"論理ファイル名"　〜〈1〜8文字の識別子〉

ステータスファイルの論理ファイル名を指定します。

"A系ステータスファイル名"　〜〈パス名〉

論理ファイルを構成するA系のステータスファイル名を絶対パス名で指定します。

"B系ステータスファイル名"　〜〈パス名〉

論理ファイルを構成するB系のステータスファイル名を絶対パス名で指定します。

なお，このB系ステータスファイルには，A系ステータスファイルと同じレコード長，およびレコード数のファイルを指定します。

A系ステータスファイル名，およびB系ステータスファイル名の絶対パス名には，環境変数は使用できません。

また，ステータスファイルには，絶対パス名が異なっていても，同じファイル名を指定できません。

●sts_initial_error_switch=stop|continue|excontinue

　〜《stop》

ステータスサービス開始時に，定義で指定したステータスファイルに次に示す異常を検知した場合の，ステータスサービスの処置を指定します。

ステータスファイルの実体がありません。

ステータスファイル障害を検知しました。

stop

OpenTP1システムの再開始を保証するため，ステータスサービスを開始しないでOpenTP1システムを停止させる場合に指定します。

stopを指定した場合，次の処理をします。

定義に指定したステータスファイルのうち，一つでも異常を検知すると，OpenTP1システムは停止します。異常が発生したステータスファイルの対策を実施したあと，OpenTP1システムを再起動してください。

前回のオンラインで現用だったステータス論理ファイルの両系に異常が発生した場合は，OpenTP1システムの再開始はできません。

continue

定義に指定したステータス論理ファイルに異常が発生しても，ステータスサービスを開始させる場合に指定します。

continueを指定した場合，次の処理をします。

前回のオンラインで現用だったステータス論理ファイルの片系に異常が発生すると，正常な系のファイルの内容を予備のA系，B系ファイルに複写します。その後，予備ファイルを現用に切り替えて，ステータスサービスを開始します。複写できる予備ファイルがない場合，sts_single_operation_switchオペランドの指定に従い，ステータスサービスを停止するか，継続するかを決定します。

ステータスサービスの開始時，OpenTP1システムが現用に選択したステータスファイルが，前回のオンラインの最新現用ファイルかどうか確定できない場合，sts_last_active_fileオペランドに指定された論理ファイル名と比較します。

ファイル名が一致した場合：ステータスサービスを開始します。

ファイル名が一致しない場合：ステータスサービスを停止します。

なお，sts_last_active_fileオペランドの指定がなく，最新の現用ファイルが確定できない場合は，ステータスサービスを開始しません。

最新の現用ファイルかどうか確定できない場合とは，定義した論理ファイルが，ステータスサービスの開始時に，一つでも次の表に示す状態になった場合のことです。

表3‒6　現用ファイルが確定できないときの論理ファイルの状態（continueの場合）

項番

A系の状態

B系の状態

1

BLOCKADE

BLOCKADE

2

BLOCKADE

OPEN（INIT）

3

BLOCKADE

NONE

4

OPEN（INIT）

BLOCKADE

5

OPEN（INIT）

NONE

6

NONE

OPEN（INIT）

7

NONE

BLOCKADE

8

NONE

NONE

A系，B系ともに正常なステータス論理ファイルが一つもない場合，ステータスサービスは開始しないで，OpenTP1システムは停止します。

excontinue

このオペランドでcontinueを指定した場合と同じ処理をします。ただし，sts_single_operation_switchオペランドでstopを指定，または省略した場合，片方の系が異常で，他方の系が初期化状態である論理ファイルについては現用決定対象ファイルから除き，現用ファイル決定処理をします。

最新の現用ファイルかどうか確定できない場合とは，定義した論理ファイルが，ステータスサービスの開始時に，一つでも次の表に示す状態になった場合のことです。

表3‒7　現用ファイルが確定できないときの論理ファイルの状態（excontinueの場合）

項番

A系の状態

B系の状態

1

BLOCKADE

BLOCKADE

2

BLOCKADE

NONE

3

NONE

BLOCKADE

4

NONE

NONE

OpenTP1開始前に前回のオンライン時に現用だった論理ファイルの片系をstsinitコマンドで初期化した場合，現用ファイルの決定が正しくできなくなるので，注意してください。

なお，異常の発生したステータスファイルの対策については，マニュアル「OpenTP1 運用と操作」を参照してください。

●sts_single_operation_switch=stop|continue

　〜《stop》

ステータスサービス開始中または開始後に，現用ステータスファイルの片系に入出力障害が発生し，かつスワップできる両系そろった論理ファイルが存在しない場合のステータスサービスの処置を指定します。

stop

ステータスサービスを停止する場合に指定します。

continue

現用ステータスファイルの正常な系だけで，ステータスサービスを継続する場合に指定します。

片系運転状態になると，KFCA01044-Iが出力されます。片系運転中に次のような障害が発生すると，OpenTP1を再開始できなくなります。そのため，片系運転状態になった場合は，すぐに障害について対策してください。

片系運転中に，正常な系に障害が発生した場合

片系運転中で，ファイルを更新するときに，システムダウンが発生した場合

●sts_last_active_file="論理ファイル名"

　〜〈1〜8文字の識別子〉

前回までのオンラインで最新の現用ファイルだったものを論理ファイル名で指定します。このオペランドは，sts_initial_error_switchオペランドにcontinueまたはexcontinueを指定したときだけ指定できます。また，OpenTP1システムが選択した現用ファイルが前回までのオンラインで最新の現用ファイルかどうか確定できない場合に有効となります。

このオペランドは，次のように指定してください。

現用ファイルが変更されるたびにオペランドを修正できる場合

全ステータスファイルの初期化直後にOpenTP1システムを開始したときは，最も小さい番号のsts_file_nameオペランドに指定した論理ファイル名を指定してください。

そのあと，現用ファイルがスワップによって変更された場合は，この定義を新しい現用ファイル名に変更してください。

現用ファイルが変更されてもオペランドを修正できない場合

システムを開始したときに，KFCA01011-IおよびKFCA01005-E（理由コード=0000000015または0000000016）が出力され，システム起動エラーとなったときは，前回のオンラインの最新現用ファイルをログファイルで調査します。

KFCA01011-Iで出力された論理ファイル名と一致するときは，その論理ファイル名をこのオペランドに指定し，OpenTP1を再開始してください。

●sts_last_active_side=A|B

前回のオンライン時，現用ステータスファイルの片系に障害が発生して閉塞状態になった場合，正常だった系を指定します。

この指定は，OpenTP1再開始時に，前回のオンライン中に障害が発生した系を現用に選択して誤動作するのを防ぐために使用します。

片系に障害が発生して閉塞状態になった場合は，必ず指定してください。

この指定は，sts_single_operation_switchオペランドにcontinueを指定したときだけ有効です。

●watch_time=最大応答待ち時間

　〜〈符号なし整数〉((0〜65535))（単位：秒）

RPCによってプロセス間で通信する場合，サービス要求を送信してからサービスの応答が返るまでの待ち時間の最大値を指定します。

OpenTP1の終了処理で，このオペランドで指定した時間だけ終了処理を待ち合わせる場合があります。したがって，大きな値を指定した場合，OpenTP1の終了処理に時間が掛かる場合があります。

指定時間を過ぎても応答がない場合は，RPCは送受信タイムアウトとしてエラーリターンします。

0を指定した場合は，応答を受信するまで待ち続けます。0を指定した場合，OpenTP1が終了しない場合があります。

省略した場合は，システム共通定義のwatch_timeオペランドの値を仮定します。

このオペランドは，システム共通定義のwatch_timeオペランドのデフォルト値で使用してください。

特別なチューニングを必要とする場合以外は，このオペランドの内容を変更しないことをお勧めします。

システム共通定義のwatch_timeオペランドのデフォルト値よりも，極端に小さな値または大きな値を指定すると，OpenTP1ダウンに至る障害が発生する場合がありますので，ご注意ください。

コマンド形式

なし。

ジャーナルサービス定義

形式

set形式

〔set jnl_tran_optimum_level=ジャーナルの出力方式に対する
                             最適化レベル〕
〔set jnl_arc_terminate_timeout=待ち合わせ最大時間〕
〔set max_socket_descriptors=ソケット用ファイル記述子の最大数〕
〔set jnl_arc_ipc_buff_size=TCP/IPの送受信バッファサイズ〕
〔set jnl_watch_time=ジャーナルサービスの通信応答待ち時間〕
〔set jnl_message_id_change_level=メッセージIDの変更レベル〕
〔set watch_time=最大応答待ち時間〕

コマンド形式

jnldfsv -r  システムジャーナルサービス定義のファイル名
        -c  チェックポイントダンプサービス定義のファイル名
      〔〔, チェックポイントダンプサービス定義のファイル名〕…〕

機能

システムジャーナルサービスとチェックポイントダンプサービスを使用するための実行環境を定義します。

なお，システム再開始時に定義の変更はできません。

説明

set形式のオペランド

●jnl_tran_optimum_level=ジャーナルの出力方式に対する最適化レベル

　〜〈符号なし整数〉((2〜3))《2》

トランザクション実行時に，ジャーナルファイルに取得するトランザクションの回復に必要なジャーナルの出力方式に対する最適化レベルを指定します。レベル3は，業務形態に注意して指定してください。

2

グローバルトランザクション単位の最適化

次の場合にジャーナルを同期出力します。次に示すジャーナル以外は，非同期出力します。

グローバルトランザクション内のルートトランザクションブランチでPJを出力する場合

他ノードに分岐したトランザクションブランチでPJとHJを出力する場合

これらのジャーナル以外を非同期出力すると，トランザクション実行時のジャーナル入出力数が減り，性能が上がります。

なお，システム異常終了後の再開始処理時，非同期出力でファイルに出力されなかったジャーナルは，トランザクションを回復するとき，システムが再度出力します。

3

条件付きジャーナル非同期出力

実行中のトランザクションが次の条件を含んでいない場合，すべてのジャーナルを非同期出力します。これによって，トランザクション実行時のジャーナル入出力がなくなるので，性能が上がります。

なお，実行中のトランザクションが次の場合は，レベル2でジャーナルを取得します。

DAMを使用するグローバルトランザクションで，ディファード更新機能を使っていないDAMファイルを更新した場合

複数ノードにわたるグローバルトランザクションを実行した場合

ISAMを使用するグローバルトランザクションで更新した場合

MCFを使用するグローバルトランザクションで更新した場合

非同期出力を要求されたトランザクションジャーナルは，ジャーナルファイルに出力されます。出力される時期を次に示します。

トランザクション内でアクセスしたリソースマネジャ（DAM，TAM，MCF）がファイルを実更新するとき（一定間隔で行われます）

チェックポイントダンプ取得時

ジャーナルバッファがいっぱいになったとき

ただし，システム異常終了後の再開始時，ジャーナルファイルにジャーナルが出力されなかったトランザクションはロールバックします。システム異常終了前にトランザクションが正常（コミット完了済み）に終了していてもロールバックします。トランザクションのコミットAPIが正常リターンしたことを期待して，ユーザ処理するUAPを実行すると，その実行中にOpenTP1が異常終了した場合，トランザクションとユーザ処理の状態不一致が発生することがあります。そのため，システム再開始後にロールバックしては困る場合は，レベル3を指定しないようにする必要があります。

●jnl_arc_terminate_timeout=待ち合わせ最大時間

　〜〈符号なし整数〉((0〜3600))《0》（単位：秒）

ジャーナルサービスを終了させてから，アーカイブサービスが停止するまで，最大待ち時間を秒単位で指定します。指定時間が過ぎても使用中のアーカイブサービスがある場合は，サービスは中断されます。また，ジャーナルサービスも終了します。

0を指定した場合は，被アーカイブノードの終了処理が完了するまで，アーカイブサービスとジャーナルサービスは終了されません。

●max_socket_descriptors=ソケット用ファイル記述子の最大数

　〜〈符号なし整数〉((32〜2032))

OpenTP1制御下のプロセス※でのソケット用に使用するファイル記述子の最大数を指定します。

指定値の範囲は，適用OSがAIX，HP-UXまたはWindowsの場合は32〜2032，適用OSがSolarisまたはLinuxの場合は32〜1008です。

OpenTP1制御下のプロセス※は，システムサーバやユーザサーバとの間で，ソケットを使用したTCP/IP通信でプロセス間の情報交換をしています。そのため，同時に稼働するUAPプロセスの数，および通信する他ノードの数によって，このオペランドを変更する必要があります。

注※

MCFサービス（MCFマネジャサービス，MCF通信サービス，およびアプリケーション起動サービス）以外のOpenTP1プロセスが対象です。MCFサービスの場合は，「システムサービス情報定義」および「システムサービス共通情報定義」を参照してください。

ソケット用ファイル記述子の最大数の算出式を，次に示します。

↑(自ノード内UAPプロセス数※1＋ジャーナルサービスに対してサービスを要求してくるノード数※2＋システムサービスプロセス数※3)／0.8↑

↑↑：小数点以下を切り上げます。

注※1

自ノード内UAPプロセス数は，次に示す値の合計です。

自OpenTP1内のUAPプロセス数

CUPから同時に起動するトランザクション数（クライアントサービス定義のparallel_countオペランドの指定値）

注※2

ジャーナルサービスに対してサービスを要求してくるノード数は，ジャーナルのアーカイブ機能を使用する場合だけ加算してください。このノード数は，次に示す値の合計です。

自OpenTP1のall_nodeオペランドに指定したノード名の数

自ノード名を，OpenTP1のall_nodeオペランドに指定している，他ノードの数

注※3

システムサービスプロセス数とは，自OpenTP1内のシステムサービスプロセスの数です。自OpenTP1内のシステムサービスプロセスは，rpcstatコマンドで表示されるサーバ名をカウントすることで求められます。rpcstatコマンドで表示されるサーバ名のうち，マニュアル「OpenTP1　解説」のOpenTP1のプロセス構造に記載されているシステムサービスプロセスをカウントしてください。

このオペランドの指定が小さいと，OpenTP1制御下の他プロセスとのコネクションが設定できなくなるため，プロセスがKFCA00307-Eメッセージを出力して異常終了します。

指定値の優先順位は次のとおりです（1.＞2.）。

ジャーナルサービス定義

システム共通定義

ここで指定を省略した場合，システム共通定義の値を仮定します。

●jnl_arc_ipc_buff_size=TCP/IPの送受信バッファサイズ

　〜〈符号なし整数〉((8192〜1048576))《61440》（単位：バイト）

アーカイブ機能を使用して，ジャーナルをアーカイブノードに転送するジャーナル転送プロセスが使用するTCP/IPの送受信バッファのサイズを指定します。

高速な通信媒体を使用する場合，値を大きくすることで性能が向上できます。このオペランドの値には，各OSで指定できるTCP/IPのバッファサイズの上限値以下の値を指定してください。また，このオペランドの値は，アーカイブノード側のグローバルアーカイブジャーナルサービス定義のjnl_arc_ipc_buff_sizeオペランドの指定値と合わせてください。

●jnl_watch_time=ジャーナルサービスの通信応答待ち時間

　〜〈符号なし整数〉((0〜65535))《180》（単位：秒）

ジャーナルサービスがRPCによってプロセス間で通信する場合の，サービス要求を送信してからサービスの応答が返るまでの待ち時間の最大値を指定します。指定時間を過ぎても応答がない場合，RPCは送受信タイムアウトとしてエラーリターンします。

0を指定した場合は，応答を受信するまで待ち続けます。この場合，OpenTP1が終了しないことがあります。

特別なチューニングが不要な場合は，このオペランドの内容を変更しないでください。

jnl_watch_timeオペランドが有効になる範囲を次に示します。

jnlopnfgコマンド

jnlclsfgコマンド

jnlchgfgコマンド

jnlunlfgコマンド

jnlswpfgコマンド※

ジャーナルファイル障害，満杯時のスワップ要求通信応答待ち時間

注※

jnlswpfgコマンドの通信応答待ち時間は，jnl_watch_timeオペランドに指定した値の2倍になります。

●jnl_message_id_change_level=メッセージIDの変更レベル

　〜〈符号なし整数〉((0〜1))《0》

ジャーナルサービスが出力するメッセージで，重要な情報となるメッセージの種別を変更します。

メッセージログを監視し，メッセージの種類によって管理方法を区別したい場合にこのオペランドを使用してください。

このオペランドによって変更されるのはメッセージIDだけであり，メッセージの内容は変更されません。

0

メッセージIDを変更しないで，従来どおりのメッセージIDで出力します。

1

メッセージIDを変更し，出力します。

このオペランドの指定値と出力されるメッセージの関係を次に示します。

jnl_message_id_change_level

オペランドの指定値

0

1

出力されるメッセージID

KFCA01224-I

KFCA01230-W

KFCA01250-I

KFCA01231-W

●watch_time=最大応答待ち時間

　〜〈符号なし整数〉((0〜65535))（単位：秒）

RPCによってプロセス間で通信する場合，サービス要求を送信してからサービスの応答が返るまでの待ち時間の最大値を指定します。

OpenTP1の終了処理で，このオペランドで指定した時間だけ終了処理を待ち合わせる場合があります。したがって，大きな値を指定した場合，OpenTP1の終了処理に時間が掛かる場合があります。

指定時間を過ぎても応答がない場合は，RPCは送受信タイムアウトとしてエラーリターンします。

0を指定した場合は，応答を受信するまで待ち続けます。0を指定した場合，OpenTP1が終了しない場合があります。

省略した場合は，システム共通定義のwatch_timeオペランドの値を仮定します。

このオペランドは，システム共通定義のwatch_timeオペランドのデフォルト値で使用してください。

特別なチューニングを必要とする場合以外は，このオペランドの内容を変更しないことをお勧めします。

システム共通定義のwatch_timeオペランドのデフォルト値よりも，極端に小さな値または大きな値を指定すると，OpenTP1ダウンに至る障害が発生する場合がありますので，ご注意ください。

コマンド形式

次ページ以降に記述しています。

jnldfsv

名称

ジャーナル関係のファイルの指定

形式

jnldfsv -r  システムジャーナルサービス定義のファイル名
        -c  チェックポイントダンプサービス定義のファイル名
     〔〔,  チェックポイントダンプサービス定義のファイル名〕…〕

機能

ジャーナルサービスを構成する各システムサービス定義のファイル名を指定します。

ファイル名は，OpenTP1システム内で一意でなければなりません。

オプション

●-r　システムジャーナルサービス定義のファイル名

　〜〈1〜8文字の識別子〉

システムジャーナルサービス定義のファイル名を指定します。

●-c　チェックポイントダンプサービス定義のファイル名〔,チェックポイントダンプサービス定義のファイル名〕…

　〜〈1〜8文字の識別子〉

チェックポイントダンプサービス定義のファイル名を指定します。

チェックポイントダンプを取得するシステムサービスごとにファイルを作成します。このコマンドの対象となるシステムサービスを次に示します。

MCFサービス

トランザクションサービス

MQAサービス

なお，ファイル名として，cpdN（N：整数）は使用できません。

注意事項

システム共通定義のjnl_fileless_optionオペランドにYを指定している場合，jnldfsv定義コマンドは省略できます。

システムジャーナルサービス定義

形式

set形式

〔set jnl_max_datasize=最大レコードデータ長〕
〔set jnl_cdinterval=ジャーナルブロック数〕
〔set jnl_rerun_swap=Y|N〕
〔set jnl_dual=Y|N〕
〔set jnl_singleoperation=Y|N〕
〔set jnl_rerun_reserved_file_open=Y|N〕
〔set jnl_arc_name=グローバルアーカイブジャーナルサービスの
                   リソースグループ名@ノード識別子〕
〔set jnl_arc_buff_size=アーカイブ用バッファサイズ〕
〔set jnl_arc_max_datasize=アーカイブ時の転送データの最大長〕
〔set jnl_arc_terminate_check=Y|N〕
〔set jnl_arc_rec_kind=ジャーナルレコード種別
                     〔ジャーナルレコード種別〕…〕
〔set jnl_arc_uj_code="UJコード〔,UJコード〕…"〕
〔set jnl_arc_check_level=1|2〕
〔set jnl_arc_trn_stat=Y|N〕
〔set jnl_unload_check=Y|N〕
〔set jnl_auto_unload=Y|N〕
〔set jnl_auto_unload_continue=Y|N〕
〔set jnl_auto_unload_path=
        "アンロードジャーナルファイルの格納ディレクトリ名"
      〔,"アンロードジャーナルファイルの格納ディレクトリ名",…〕〕
〔set jnl_max_file_dispersion=並列アクセス化する場合の最大分散数〕
〔set jnl_min_file_dispersion=並列アクセス化する場合の最小分散数〕
〔set watch_time=最大応答待ち時間〕

コマンド形式

{{{{jnladdfg -g  ファイルグループ名  〔ONL〕}}
  {{jnladdpf -g  ファイルグループ名
           〔-e  要素ファイル名〕
             -a  物理ファイル名
           〔-b  物理ファイル名〕}}}}

機能

システムジャーナルファイルにジャーナルを取得するための実行環境を定義します。

説明

set形式のオペランド

●jnl_max_datasize=最大レコードデータ長

　〜〈符号なし整数〉((32000〜4000000))《32000》（単位：バイト）

ジャーナルに取得するレコードデータの最大長を指定します。

計算式を次に示します。次の条件のうちの最大値を指定してください。

UJを取得する場合

取得するUAP履歴情報の最大の長さ＋8　の計算値以上

DAMサービスを使用する場合

（i）dam_update_block_overオペランドにflushを指定したとき

a×{(b×2)＋24}＋128　の計算値以上

（ii）（i）以外のとき

a×(b＋24)＋128　の計算値以上

a：DAMサービス定義のdam_update_blockオペランドの指定値

b：damloadコマンド，またはdc_dam_create関数で作成したDAMファイルのうち，最大のブロック長＋8(damloadコマンド，またはdc_dam_create関数のblksizeの値＋8)

（iii）（i）または（ii）で算出した値が4000000を超えるとき

4000000以内のなるべく大きな値

DAMサービスで出力しようとするジャーナルレコード長がjnl_max_datasizeオペランドの指定値を超える場合，ジャーナルレコードをjnl_max_datasizeオペランドの指定値内のサイズに分割して出力します。ただし，ジャーナルレコードが分割されるとディスクへのジャーナル入出力が増加するおそれがありますので，4000000以内のなるべく大きな値としてください。

TAMサービスを使用する場合

TAMで取得するCJのデータ長以上

a×2＋96　の計算値以上

a：TAMサービス定義のtam_max_recsizeオペランドの指定値を4で切り上げた値

MCFサービスを使用する場合

MCFで取得するGJ，IJ，MJ，OJ，CJのデータ長のうちの最大値以上

（i）GJのデータ長

MCFアプリケーション定義のmcfaalcapの-jオプションのgjオペランドにyesを指定したときに取得します。

●32ビット版のとき

↑(204＋seg)／4↑×4

●64ビット版のとき

↑(204＋seg)／8↑×8

（ii）IJのデータ長

MCFアプリケーション定義のmcfaalcapの-jオプションのijオペランドにyesを指定したときに取得します。

●32ビット版のとき

↑(172＋seg)／4↑×4

●64ビット版のとき

↑(172＋seg)／8↑×8

（iii）MJのデータ長

mcftactmjコマンドを実行したときに取得します。

●32ビット版のとき

↑(180＋seg)／4↑×4

●64ビット版のとき

↑(180＋seg)／8↑×8

（iv）OJのデータ長

MHPからメッセージ送信をした場合，MCFアプリケーション定義のmcfaalcapの-jオプションのojオペランドにyesを指定したときに取得します。SPPからメッセージ送信をした場合，ユーザサービス定義のmcf_spp_ojオペランドにYを指定したときに取得します。

●32ビット版のとき

↑(204＋seg)／4↑×4

●64ビット版のとき

↑(204＋seg)／8↑×8

（v）CJ（メッセージキューサーバ）のデータ長

ITQ，OTQにディスクキューを使用した場合に取得します。

次に示す三つの計算式のうち最大の値をデータ長としてください。

・計算式1（MCF通信プロセスやアプリケーション起動プロセスで送受信するメッセージ単位で取得するCJ）

●32ビット版のとき

↑{88＋(24×(↑msg／ql↑＋↑960／ql↑))＋qio}／4↑×4

●64ビット版のとき

↑{88＋(24×(↑msg／ql↑＋↑1276／ql↑))＋qio}／8↑×8

・計算式2（トランザクション単位で取得するCJ）

●32ビット版のとき

↑{260＋Σ{24×(↑msg／ql↑＋↑960／ql↑)}＋qio}／4↑×4

●64ビット版のとき

↑{260＋Σ{24×(↑msg／ql↑＋↑1276／ql↑)}＋qio}／8↑×8

・計算式3（論理端末やサービスグループ単位で取得するCJ）

●32ビット版のとき

260＋（24×rmsg）

●64ビット版のとき

↑{260＋24×rmsg}／8↑×8

（凡例）

↑↑：小数点以下を切り上げます。

seg：セグメント長

msg：ディスクキューを使用した受信メッセージ長または送信メッセージ長

ql：キューファイル物理レコード長

qio：メッセージキューサービス定義のque_io_maxrecsizeオペランドの指定値

Σ：該当するトランザクションで，受信または送信したメッセージに対する見積もりの総和

rmsg：すべての論理端末およびサービスグループのうちの構成変更準備停止時における滞留メッセージ数の最大値※

注※

滞留メッセージ数の最大値は，構成変更準備停止を行う直前に次のコマンドを実行することで取得できます。

論理端末の場合：-mオプションを指定したmcftlsleコマンド，またはmcfalspsvコマンド

サービスグループの場合：-mオプションを指定したmcftlssgコマンド

MQAサービスを使用する場合

（i）32ビットのとき

j≧716＋4×m

（ii）64ビットのとき

j≧744＋4×m

（凡例）

j：jnl_max_datasizeオペランドの指定値

m：mqa_max_msg_recnumオペランドの指定値

TP1/Message Queueを使用する場合は，マニュアル「TP1/Message Queue 使用の手引」のmqa_max_msg_recnumオペランドの説明を参照してください。

●jnl_cdinterval=ジャーナルブロック数

　〜〈符号なし整数〉((100〜32000))《1000》

チェックポイントダンプを取得する間隔を，ジャーナルブロック数で指定します。

ここで指定した数のジャーナルをジャーナルファイルに格納した時点で，チェックポイントダンプが取得されます。

ここで指定するブロック数以上の容量がジャーナルファイルに必要です。

●jnl_rerun_swap=Y|N

　〜《N》

OpenTP1システム再開始時にジャーナルをスワップするかどうかを指定します。

スワップすることで，物理的にジャーナルを分けられます。

Y

ジャーナルをスワップします。

N

ジャーナルをスワップしません。

●jnl_dual=Y|N

　〜《N》

ジャーナルファイルを二重化するかどうかを指定します。

Y

ジャーナルファイルを二重化します。

N

ジャーナルファイルを二重化しません。

●jnl_singleoperation=Y|N

　〜《N》

ジャーナルファイルを二重化する場合，片系しかスワップ先として使用できなくなったときに，スワップ先として割り当てるかどうかを指定します。

Y

片系しかスワップ先として使用できない場合でもスワップ先として割り当てます（片系運転可）。

N

片系しかスワップ先として使用できない場合はスワップ先として割り当てません（片系運転不可）。

●jnl_rerun_reserved_file_open=Y|N

　〜《N》

全面回復時にオープンされたファイルグループがすべて上書き禁止の状態で，スワップ先がない場合，予約ファイルがあれば予約ファイルをオープンするかどうかを指定します。

Yを指定しても，上書きできるファイルグループがある場合は，スワップ先がなくても予約ファイルをオープンしません。

Y

予約ファイルをオープンします。

全面回復のとき，スワップ先がないためにシステムが再度停止することを防ぎます。

N

予約ファイルをオープンしません。

●jnl_arc_name=グローバルアーカイブジャーナルサービスのリソースグループ名@ノード識別子　

　〜〈1〜8文字の識別子〉@〈4文字の識別子〉

該当するジャーナルをアーカイブする先の「ノード識別子（システム共通定義のnode_idで指定する名称）」と，そのノードで定義された「グローバルアーカイブジャーナルサービスのリソースグループ名（アーカイブジャーナルサービス定義のファイル名）」を，@で連結したものを指定します。

●jnl_arc_buff_size=アーカイブ用バッファサイズ

　〜〈符号なし整数〉((2〜80))《10》（単位：メガバイト）

該当するジャーナルをアーカイブするための，共用メモリバッファの容量を指定します。ここで指定する値は，グローバルアーカイブジャーナルサービスが異常終了と再開始に掛かる時間の間に発生するジャーナル量から求めます。また，ここで指定する値は，次の計算式で求められた値以上の値を指定してください。

jnl_arc_buff_sizeオペランドの値 = ↑(jnl_arc_max_datasize×1024) / 1048576↑×3

この計算式で求められた値よりjnl_arc_buff_sizeオペランドの指定値が小さい場合は，OpenTP1の開始時にKFCA01113-Eの理由コード427を出力し，OpenTP1の開始処理を中止します。

このオペランドは，jnl_arc_nameオペランドを定義している場合にだけ有効です。

●jnl_arc_max_datasize=アーカイブ時の転送データの最大長

　〜〈符号なし整数〉((1020〜8188))《1020》（単位：キロバイト）

アーカイブノードにジャーナルデータをアーカイブする場合の最大転送データ長を指定します。このオペランドの値は，次の計算式で求めた値以上の値を指定してください。

jnl_arc_max_datasize ≧ ↑(↑(jnl_max_datasize＋336) / 4096↑×4096) / 1024↑

計算式で求められた値よりjnl_arc_max_datasizeの指定値が小さい場合は，OpenTP1の開始時にKFCA01113-Eメッセージの理由コード424を出力してOpenTP1の開始処理を中止します。

また，このオペランドに1020より大きな値を指定する場合は，次の計算式で求められた値以上の値をシステム共通定義のrpc_max_message_sizeオペランドに指定してください。

rpc_max_message_size ≧ ↑(jnl_arc_max_datasize×1024＋4096) / 1048576↑

計算式で求められた値よりrpc_max_message_sizeが小さい場合は，OpenTP1の開始時にKFCA01113-Eの理由コード425を出力してOpenTP1の開始処理を中止します。このオペランドは，jnl_arc_nameオペランドを定義している場合にだけ有効です。また，このオペランドの指定値以上の値を，アーカイブジャーナルサービス定義のjnl_arc_max_datasizeオペランドに指定してください。

アーカイブジャーナルサービス定義のjnl_arc_max_datasizeオペランドの値がこのオペランドの指定値より小さく，かつ次の計算値で求めた値より小さい場合は，アーカイブノードとのコネクションの確立時に，KFCA04133-Wの理由コード427を出力し，アーカイブ機能を停止します。

アーカイブジャーナルサービス定義のjnl_arc_max_datasize
≧ ↑(↑(jnl_max_datasize＋336) / 4096↑×4096) / 1024↑

●jnl_arc_terminate_check=Y|N

　〜《Y》

該当するジャーナルサービスが正常終了および計画停止するとき，アーカイブ対象ジャーナルをすべてアーカイブするかどうかを指定します。

Y

すべてアーカイブして終了します。

N

アーカイブを中断して終了します。

このオペランドは，jnl_arc_nameオペランドを定義している場合にだけ有効です。

●jnl_arc_rec_kind=ジャーナルレコード種別〔ジャーナルレコード種別〕…

　〜《acfgimosu》

アーカイブ対象となるジャーナルレコード種別を指定します。

ジャーナルレコード種別の指定値と内容を次に示します。

レコード種別

指定値

内　　　容

ジャーナルの種類

FJ

f

DAMファイルの更新情報

回復用ジャーナル

CJ

c

回復対象テーブルの更新情報

SJ

s

システム統計情報

統計用ジャーナル

AJ

a

送信完了情報

IJ

i

入力キュー登録メッセージ

OJ

o

出力キュー登録メッセージ

MJ

m

メッセージジャーナル

GJ

g

receive情報

UJ

u

ユーザ任意の情報

ユーザジャーナル

このオペランドの指定を省略した場合，すべてのジャーナルレコード種別がアーカイブ対象となります。

また，jnl_arc_trn_statオペランドでYを指定した場合，同期点ジャーナルおよびトランザクション管理サービスの回復用ジャーナルは，このオペランドの指定に関係なく，すべてアーカイブの対象となります。

このオペランドを指定した場合は，jnl_arc_check_levelオペランドの指定に注意してください。詳細は，jnl_arc_check_levelオペランドの説明を参照してください。

このオペランドは，jnl_arc_nameオペランドを指定している場合にだけ有効です。

●jnl_arc_uj_code="UJコード〔，UJコード〕…"

　〜〈符号なし整数〉((0〜255))《0-255》

UJがアーカイブ対象となっている場合に，アーカイブするUJコードを指定します。コンマ'，'で区切ると，複数のUJコードを指定できます。

UJコードの先頭に「0x」を指定した場合は16進数，「0」を指定した場合は8進数として指定できます。また，UJコードをハイフン'-'でつなぐと，範囲指定できます。

（例）

15：10進数で「15」

0x15：16進数で「21」

015：8進数で「13」

0-255：「0」から「255」までのすべての値

このオペランドの指定を省略した場合，すべてのUJコードがアーカイブ対象となります。

このオペランドは，jnl_arc_nameオペランドを指定していて，かつjnl_arc_rec_kindオペランドを省略またはuを指定している場合にだけ有効です。

●jnl_arc_check_level=1|2

　〜《1》

グローバルアーカイブジャーナル機能を使用した場合に，ファイルグループがスワップ先に割り当てられる条件を指定します。

1

アンロード済みまたはアーカイブ済み状態のファイルグループをスワップ先に割り当てます。

2

アンロード済みかつアーカイブ済み状態のファイルグループをスワップ先に割り当てます。

このオペランドで1を指定し，jnl_arc_rec_kindオペランドにアーカイブするジャーナル種別を指定した場合は，オンラインの回復に必要なジャーナルファイルが失われることがあります。そのため，jnl_arc_rec_kindオペランドでアーカイブするジャーナル種別を選択した場合には，jnl_arc_check_levelオペランドで2を指定してください。この時，アーカイブ済みのファイルグループをスワップ先として割り当てるには，jnlunlfgコマンドでアンロードするか，jnlchgfgコマンドでファイルグループを強制的にアンロード済み状態に変更してください。また，アーカイブ機能の障害時には，jnlchgfgコマンドでファイルグループを強制的にアンロード済み状態に変更してください。

このオペランドは，jnl_arc_nameオペランドを指定している場合にだけ有効です。

●jnl_arc_trn_stat=Y|N

　〜《Y》

同期点ジャーナルおよびトランザクション管理サービスの回復用ジャーナルを，アーカイブの対象とするかどうかを指定します。

Y

アーカイブの対象とします。

N

アーカイブの対象としません。

Nを指定した場合，アーカイブジャーナルファイルを使った次の運用コマンドの動作は保証しません。

damfrcコマンド（DAM論理ファイルの回復）

tamfrcコマンド（TAMファイルの回復）

jnlcolcコマンド（ファイル回復用ジャーナルの集積）

jnlmkrfコマンド（ジャーナル関係のファイル回復）

jnlrputコマンド（グローバルアーカイブアンロードジャーナルファイルのレコード出力）の-eオプション

このオペランドは，jnl_arc_nameオペランドおよびjnl_arc_rec_kindオペランドを指定している場合にだけ有効です。

●jnl_unload_check=Y|N

　〜《Y》

スワップ先のファイルグループを決定する時に，アンロード待ち状態をチェックするかどうかを指定します。

Y

アンロード待ち状態をチェックします。

N

アンロード待ち状態をチェックしません。

Yを指定した場合，OpenTP1が強制終了，または異常終了したあとにOpenTP1を強制正常開始したとき，前回のオンラインで現用として使用されていたジャーナルファイルはクローズ状態となります。jnlunlfgコマンドまたはjnlchgfgコマンドでファイルグループのステータスを変更するまで，ジャーナルファイルは使用できません。

Nを指定した場合，アンロードしていないジャーナルは失われます。そのため，通常は，テストなどでジャーナルの運用（ユーザファイルの回復や稼働統計情報の編集など）を必要としない場合に指定します。また，ジャーナルが失われるため，アンロードジャーナルファイルを指定するコマンドが，一部使用できなくなります。詳細は，マニュアル「OpenTP1 運用と操作」を参照してください。

グローバルアーカイブジャーナルサービス機能を使用して，被アーカイブノードとして動作させる環境でNを指定した場合，転送が完了していないジャーナルが上書きされ，アーカイブノード側で世代抜けエラーが発生する場合があります。被アーカイブノードとして起動する場合は，Nを指定しないでください。

●jnl_auto_unload=Y|N

　〜《N》

自動アンロード機能を使用するかどうかを指定します。自動アンロード機能の詳細については，マニュアル「OpenTP1 運用と操作」を参照してください。

Y

自動アンロード機能を使用します。

N

自動アンロード機能を使用しません。

jnl_unload_checkオペランドにNが指定されている場合は，jnl_auto_unloadオペランドにYを指定しても自動アンロード機能を使用できません。

●jnl_auto_unload_continue=Y|N

　〜《N》

自動アンロード継続機能を使用するかどうかを指定します。自動アンロード継続機能の詳細については，マニュアル「OpenTP1 運用と操作」を参照してください。

Y

自動アンロード継続機能を使用します。

N

自動アンロード継続機能を使用しません。

jnl_auto_unloadオペランドにYを指定している場合にだけ有効です。また，OpenTP1再開始時に指定値を変更できます。

●jnl_auto_unload_path="アンロードジャーナルファイルの格納ディレクトリ名"〔,"アンロードジャーナルファイルの格納ディレクトリ名",…〕

　〜〈パス名〉《$DCDIR/spool/dcjnlinf/unload》

自動アンロード機能を使用する場合に，アンロードジャーナルファイルを格納するディレクトリを絶対パス名で指定します。パス名に指定できる文字数は，最大80バイトです。複数のディレクトリを指定できます。指定できるディレクトリの最大数は32です。

このオペランドは，jnl_unload_checkオペランドおよびjnl_auto_unloadオペランドにYを指定した場合にだけ有効です。

このオペランドで指定したパス名に誤りがある場合は，自動アンロード機能を使用できません。また，このオペランドの指定を省略した場合は，$DCDIR/spool/dcjnlinf/unloadを仮定します。

このオペランドに指定するディレクトリには，アンロードジャーナルファイルを格納できるディスク容量が必要です。アンロードジャーナルファイルを格納するディレクトリに必要なディスク容量の算出式を次に示します。

ディスク容量（単位：バイト）＝ジャーナルファイルレコード数
　　　×ジャーナルファイルレコード長
　　　×格納するアンロードジャーナルファイル数
　　　×1.2

●jnl_max_file_dispersion=並列アクセス化する場合の最大分散数

　〜〈符号なし整数〉((1〜8))《1》

システムジャーナルを並列アクセス化する場合の最大分散数を指定します。

一つのファイルグループで使用する最大要素ファイル数を指定してください。1を指定した場合，または指定を省略した場合は，jnl_min_file_dispersionオペランドの指定値は無効になります。

●jnl_min_file_dispersion=並列アクセス化する場合の最小分散数

　〜〈符号なし整数〉((1〜8))《1》

システムジャーナルを並列アクセス化する場合の最小分散数を指定します。

ファイルグループを構成する要素ファイルが障害などで使用できなくなった場合でも，現用として使用できる最小要素ファイル数を指定してください。使用できる要素ファイル数が最小要素ファイル数未満になった場合，ファイルグループは使用できなくなります。

並列アクセス化する場合の最小分散数は次の範囲で指定してください。

最大分散数≧最小分散数≧1

●watch_time=最大応答待ち時間

　〜〈符号なし整数〉((0〜65535))（単位：秒）

RPCによってプロセス間で通信する場合，サービス要求を送信してからサービスの応答が返るまでの待ち時間の最大値を指定します。

OpenTP1の終了処理で，このオペランドで指定した時間だけ終了処理を待ち合わせる場合があります。したがって，大きな値を指定した場合，OpenTP1の終了処理に時間が掛かる場合があります。

指定時間を過ぎても応答がない場合は，RPCは送受信タイムアウトとしてエラーリターンします。

0を指定した場合は，応答を受信するまで待ち続けます。0を指定した場合，OpenTP1が終了しない場合があります。

省略した場合は，システム共通定義のwatch_timeオペランドの値を仮定します。

このオペランドは，システム共通定義のwatch_timeオペランドのデフォルト値で使用してください。

特別なチューニングを必要とする場合以外は，このオペランドの内容を変更しないことをお勧めします。

システム共通定義のwatch_timeオペランドのデフォルト値よりも，極端に小さな値または大きな値を指定すると，OpenTP1ダウンに至る障害が発生する場合がありますので，ご注意ください。

コマンド形式

次ページ以降に記述しています。

jnladdfg

名称

システムジャーナルファイルのファイルグループ名と属性の定義

形式

{{jnladdfg -g  ファイルグループ名  〔ONL〕}}

機能

システムジャーナルファイルのファイルグループ名と属性を定義します。

jnladdfg定義コマンドは，システムジャーナルサービス定義内に最低2個，最大256個指定できます。

ただし，ONLを指定したjnladdfg定義コマンドの場合は，最低2個必要です。

なお，ファイルグループ名は，システムジャーナルサービス定義内で一意でなければなりません。

オプション

●-g　システムジャーナルファイルのファイルグループ名

　〜〈1〜8文字の識別子〉

システムジャーナルファイルのファイルグループ名を指定します。

このオプションの指定値を変更した場合は，システムジャーナルファイルの初期化が必要です。

●ONL

このファイルグループを，オンライン開始と同時にオープン状態にする場合に指定します。

省略した場合は，オンライン開始時にはクローズ状態の予約のファイルグループになります。

注意事項

システム共通定義のjnl_fileless_optionオペランドにYを指定している場合，jnladdfg定義コマンドは省略できます。

jnladdpf

名称

システムジャーナルファイルのファイルグループを構成する物理ファイルの定義

形式

{{jnladdpf -g  ファイルグループ名
         〔-e  要素ファイル名〕
           -a  物理ファイル名
         〔-b  物理ファイル名〕}}

機能

システムジャーナルファイルのファイルグループを構成する物理ファイルを定義します。

jnladdpf定義コマンドは，ファイルグループに対して最低1個，最大8個指定できます。

なお，物理ファイル名は，OpenTP1システム内で一意でなければなりません。

オプション

●-g　システムジャーナルファイルのファイルグループ名

　〜〈1〜8文字の識別子〉

システムジャーナルファイルのファイルグループ名を指定します。

ここで指定するファイルグループ名は，あらかじめjnladdfg定義コマンドで定義しておきます。なお，このオプションの指定値を変更した場合は，システムジャーナルファイルの初期化が必要です。

●-e　要素ファイル名

　〜〈1〜8文字の識別子〉

ファイルグループを構成する要素ファイル名を指定します。

要素ファイル名はシステムジャーナルサービス定義内で一意でなければなりません。

並列アクセス化（jnl_max_file_dispersionオペランドに2以上を指定）をする場合は，必ずこのオプションを指定してください。並列アクセス化をしない場合は，指定する必要はありません。

並列アクセス化をする場合に-eオプションを省略すると，定義解析でエラーになります。一つのファイルグループに指定する要素ファイル数は次の範囲で指定してください。

jnl_max_file_dispersionオペランドの指定値≧要素ファイル数≧jnl_min_file_dispersionオペランドの指定値

ここで指定する要素ファイル数がjnl_max_file_dispersionオペランドの指定値を超えた場合，超えた分はオンラインでは使用されません。また，ここで指定する要素ファイル数がjnl_min_file_dispersionオペランドの指定値に満たない場合，そのファイルグループは使用できません。

●-a　物理ファイル名

　〜〈パス名〉

このファイルグループを構成する物理ファイル名を絶対パス名で指定します。ただし，環境変数は使用できません。

この物理ファイルはジャーナル関係のファイル用として作成したOpenTP1ファイルを使用します。

set形式のjnl_dualオペランドでファイルの二重化を指定した場合は，ここにA系ファイルの物理ファイル名を指定してください。

二重化を指定しても-aの物理ファイル名しか指定しない場合は，コマンド全体が無視されます。

●-b　物理ファイル名

　〜〈パス名〉

set形式のjnl_dualオペランドでファイルの二重化を指定した場合に，B系ファイルの物理ファイル名を絶対パス名で指定します。ただし，環境変数は使用できません。この物理ファイルはジャーナル関係のファイル用として作成したOpenTP1ファイルを使用します。

二重化の指定をしていない場合に-aおよび-bの物理ファイル名を指定すると，-bの方が無効となります。また，二重化する場合もしない場合も，-bの物理ファイル名だけを指定すると，コマンド全体が無視されます。

注意事項

システム共通定義のjnl_fileless_optionオペランドにYを指定している場合，jnladdpf定義コマンドは省略できます。

チェックポイントダンプサービス定義

形式

set形式

  set jnl_objservername="対象となるシステムサービス名"
〔set jnl_max_datasize=チェックポイントダンプ取得用バッファ長〕
〔set assurance_count=有効保証世代数〕
〔set jnl_reduced_mode=縮退運転オプション〕
〔set jnl_reserved_file_auto_open=Y|N〕
〔set jnl_dual=Y|N〕
〔set jnl_singleoperation=Y|N〕
〔set jnl_cdskip_limit=チェックポイントダンプ取得契機の
                       スキップ回数の上限値〕
〔set jnl_cdskip_msg=Y|N〕
〔set cpd_message_id_change_level=メッセージIDの変更レベル〕
〔set watch_time=最大応答待ち時間〕

コマンド形式

{{{{jnladdfg 〔-j  srf〕
               -g  ファイルグループ名  〔ONL〕}}
  {{jnladdpf 〔-j  srf〕
               -g  ファイルグループ名  -a  物理ファイル名
             〔-b  物理ファイル名〕}}}}

機能

チェックポイントダンプファイルにチェックポイントダンプを取得するための実行環境を定義します。トランザクションサービスについては必ず定義します。そのほかのサービスについては，そのサービスを使用する場合にだけ定義します。

説明

set形式のオペランド

●jnl_objservername="対象となるシステムサービス名"

　〜〈1〜8文字の識別子〉

対象となるシステムサービス名を指定します。

MCFサービスの場合

システムサービス構成定義のdcsvstart -mで指定した名称を指定します。

トランザクションサービスの場合

常に_tjlを指定します。

MQAサービスの場合

常に_mqaを指定します。

●jnl_max_datasize=チェックポイントダンプ取得用バッファ長

　〜〈符号なし整数〉((32000〜4000000))《32768》（単位：バイト）

チェックポイントダンプ情報をチェックポイントダンプファイルに書き出したり，読み込んだりするバッファの大きさを指定します。

チェックポイントダンプファイルの入出力回数を制御できます。

指定するバッファの大きさが大きいほどチェックポイントダンプファイルに対する入出力回数が少なくなります。

●assurance_count=有効保証世代数

　〜〈符号なし整数〉((1〜2))《1》

システム回復時のチェックポイントダンプファイルの入力障害などに備え，オンライン中に保存しておくチェックポイントダンプファイルの世代数を指定します。ここで指定した世代数のファイルは，上書きされません。

これによって，最新世代のチェックポイントダンプファイルに障害が発生しても，残りの有効保証世代を使って回復ができ，システムの信頼性が向上します。

チェックポイントダンプファイルを取得するには，有効保証世代数+1のファイルグループが必要です。

複数の有効保証世代を指定する場合，上書きできないジャーナルが増えることによって，ジャーナルの次回取得先ファイルが不足することがあります。これを防ぐため，ジャーナルファイルのブロック数は，次の値を目安にして設定してください。

チェックポイントダンプを取得する間隔となるジャーナルブロック数×（有効保証世代数＋1）

●jnl_reduced_mode=縮退運転オプション

　〜〈符号なし整数〉((0〜2))《0》

チェックポイントダンプの縮退機能を使用するかどうかを指定します。

オンライン中，または再開始処理中のファイル障害等によって，運用に必要なファイル数を下回った場合でも，最低二つのファイルが使用できれば処理を続行します。この場合，assurance_countオペランドの指定は無視されます。

0

縮退機能を使用しません。

1

縮退機能を使用します。

2

縮退機能を使用し，縮退状態でチェックポイントダンプ取得契機が発生するたびに，警告メッセージを出力します。

●jnl_reserved_file_auto_open=Y|N

　〜《N》

オンライン中にファイル障害等によって，運用に必要なファイル数を下回った場合，未使用の予約ファイルを自動的にオープンして処理を続行するかどうかを指定します。

Y

予約ファイルを自動的にオープンします。

N

予約ファイルを自動的にオープンしません。

この指定は，縮退運転オプションより優先されます。

●jnl_dual=Y|N

　〜《N》

チェックポイントダンプファイルを二重化するかどうかを指定します。

二重化する場合は，一つのファイルグループに二つの物理ファイル（A系とB系）を指定してください。

Y

チェックポイントダンプファイルを二重化します。

N

チェックポイントダンプファイルを二重化しません。

●jnl_singleoperation=Y|N

　〜《N》

チェックポイントダンプファイルを二重化している際，上書きできる物理ファイルが片系だけになった場合に，上書きできるファイルグループとして割り当てるかどうかを指定します。

Y

上書きできる物理ファイルが片系だけの場合は，上書きできるファイルグループとして割り当てます（片系運転可）。

N

上書きできる物理ファイルが片系だけの場合でも，上書きできるファイルグループとして割り当てません（片系運転不可）。

ファイルグループは予約状態となります。

●jnl_cdskip_limit=チェックポイントダンプ取得契機のスキップ回数の上限値

　〜〈符号なし整数〉((1〜32767))（単位：回）

チェックポイントダンプ取得契機のスキップ回数の上限値を指定します。チェックポイントダンプ取得契機のスキップ回数がこのオペランドで指定した回数に達すると，スキップ要因となっているトランザクションの情報をKFCA32550-Iメッセージで出力し，そのトランザクションを実行しているプロセスを強制停止します。

このオペランドは，チェックポイントダンプサービス定義のjnl_objservernameオペランドに_tjlを指定した場合に有効です。_tjl以外を指定した場合，このオペランドの指定は無視されます。

このオペランドの指定を省略した場合は，チェックポイントダンプ取得契機のスキップ回数を監視しません。

このオペランドの指定値が大き過ぎると，チェックポイントダンプの取得処理が完了できないため，使用（上書き）できるシステムジャーナルファイルが不足してしまいます。この場合，OpenTP1は異常終了します。また，指定値が小さ過ぎると，プロセスの強制停止によるトランザクションのロールバックが増加することがあります。

スキップ回数の上限値の見積もり式については，マニュアル「OpenTP1 運用と操作」のチェックポイントダンプ取得契機のスキップ回数の監視の説明を参照してください。

●jnl_cdskip_msg=Y|N

　〜《N》

チェックポイントダンプ取得契機をスキップする要因となった，トランザクションの情報を出力するかどうかを指定します。

このオペランドは，チェックポイントダンプサービス定義のjnl_objservernameオペランドに_tjlを指定した場合に有効です。_tjl以外を指定した場合，このオペランドの指定は無視されます。

Y

スキップ要因となっているトランザクションの情報として，KFCA32550-Iメッセージを出力します。

N

スキップ要因となっているトランザクションの情報を出力しません。

●cpd_message_id_change_level=メッセージIDの変更レベル

　〜〈符号なし整数〉((0〜1))《0》

チェックポイントダンプサービスが出力するメッセージで，重要な情報となるメッセージの種別を変更します。

メッセージログを監視し，メッセージの種類によって管理方法を区別したい場合にこのオペランドを使用してください。

このオペランドは，チェックポイントダンプサービス定義のjnl_objservernameオペランドに_tjlを指定した場合に有効です。_tjl以外を指定した場合，このオペランドの指定は無視されます。

0

メッセージIDを変更しないで，従来どおりのメッセージIDで出力します。

1

メッセージIDを変更し，出力します。

このオペランドの指定値と出力されるメッセージの関係を次に示します。

cpd_message_id_change_level

オペランドの指定値

0

1

出力されるメッセージID

KFCA02179-I

KFCA02161-W

●watch_time=最大応答待ち時間

　〜〈符号なし整数〉((0〜65535))（単位：秒）

RPCによってプロセス間で通信する場合，サービス要求を送信してからサービスの応答が返るまでの待ち時間の最大値を指定します。

OpenTP1の終了処理で，このオペランドで指定した時間だけ終了処理を待ち合わせる場合があります。したがって，大きな値を指定した場合，OpenTP1の終了処理に時間が掛かる場合があります。

指定時間を過ぎても応答がない場合は，RPCは送受信タイムアウトとしてエラーリターンします。

0を指定した場合は，応答を受信するまで待ち続けます。0を指定した場合，OpenTP1が終了しない場合があります。

省略した場合は，システム共通定義のwatch_timeオペランドの値を仮定します。

このオペランドは，システム共通定義のwatch_timeオペランドのデフォルト値で使用してください。

特別なチューニングを必要とする場合以外は，このオペランドの内容を変更しないことをお勧めします。

システム共通定義のwatch_timeオペランドのデフォルト値よりも，極端に小さな値または大きな値を指定すると，OpenTP1ダウンに至る障害が発生する場合がありますので，ご注意ください。

コマンド形式

次ページ以降に記述しています。

jnladdfg

名称

チェックポイントダンプファイルのファイルグループ名と属性の定義

形式

{{jnladdfg〔-j  srf〕
            -g  ファイルグループ名〔ONL〕}}

機能

チェックポイントダンプファイルとサーバリカバリジャーナルファイルのファイルグループ名と属性を定義します。ただし，サーバリカバリジャーナルファイルをOpenTP1ファイルで作成しない場合，-jオプションを指定したjnladdfg定義コマンドとjnladdpf定義コマンドは指定してはなりません。また，-jオプションを指定したjnladdfg定義コマンドは，定義内に一つしか指定できません。

jnladdfg定義コマンドは，チェックポイントダンプサービス定義内に最低2個，最大60個指定できます。チェックポイントダンプファイルのONLを指定したjnladdfg定義コマンドの場合は，最低2個，最大30個指定できます。

なお，ファイルグループ名は，すべてのチェックポイントダンプサービス定義内で一意でなければなりません。

オプション

●-j　srf

　〜〈1〜8文字の識別子〉

系切り替え構成で，サーバリカバリジャーナルファイルを使用する場合には，サーバリカバリジャーナルファイルを，共有ディスク装置上のOpenTP1ファイルとして作成する必要があります。その際，必ずこのオプションを指定してください。

マニュアル「OpenTP1 解説」のサーバリカバリジャーナルファイルについての記述もあわせて参照してください。

●-g　チェックポイントダンプファイルのファイルグループ名

　〜〈1〜8文字の識別子〉

チェックポイントダンプファイルのファイルグループ名を指定します。

●ONL

このファイルグループを，オンライン開始と同時にオープン状態にする場合に指定します。

省略した場合は，オンライン開始時にはクローズ状態の予約のファイルグループになります。

サーバリカバリジャーナルファイルの場合，この指定を省略してもオンライン開始と同時にオープン状態になります。

jnladdpf

名称

チェックポイントダンプファイルのファイルグループを構成する物理ファイルの定義

形式

{{jnladdpf〔-j  srf〕
            -g  ファイルグループ名  -a  物理ファイル名
          〔-b  物理ファイル名  〕}}

機能

チェックポイントダンプファイルのファイルグループを構成する物理ファイルを定義します。

jnladdpf定義コマンドを定義する場合，このコマンドで指定するファイルグループ名を指定したjnladdfg定義コマンドを定義しなければなりません。

jnladdpf定義コマンドは，ファイルグループに対して1個だけ指定します。

なお，物理ファイル名は，OpenTP1システム内で一意でなければなりません。

また，ONLを指定していないjnladdfg定義コマンドに対するjnladdpf定義コマンドは，省略できます。省略した場合は，運用コマンドのjnladdpf定義コマンドで物理ファイルを割り当てます。ただし，サーバリカバリジャーナルファイルの場合は，省略できません。

オプション

●-j　srf

　〜〈1〜8文字の識別子〉

系切り替え構成で，サーバリカバリジャーナルファイルを使用する場合には，サーバリカバリジャーナルファイルを，共有ディスク装置上のOpenTP1ファイルとして作成する必要があります。その際，必ずこのオプションを指定してください。

マニュアル「OpenTP1 解説」のサーバリカバリジャーナルファイルについての記述もあわせて参照してください。

●-g　チェックポイントダンプファイルのファイルグループ名

　〜〈1〜8文字の識別子〉

チェックポイントダンプファイルのファイルグループ名を指定します。

ここで指定するファイルグループ名は，あらかじめjnladdfg定義コマンドで定義しておきます。

●-a　物理ファイル名

　〜〈パス名〉

-gオプションで指定した，ファイルグループを構成する物理ファイル名を絶対パス名で指定します。ただし，環境変数は使用できません。

チェックポイントダンプファイルを二重化して運用する場合は，ファイルグループのA系を構成する物理ファイル名を指定します。

なお，この物理ファイルはジャーナル関係のファイル用として作成したOpenTP1ファイルを指定します。

●-b　物理ファイル名

　〜〈パス名〉

-gオプションで指定した，ファイルグループのB系を構成する物理ファイル名を絶対パス名で指定します。チェックポイントダンプファイルを二重化して運用する場合だけ指定します。

なお，この物理ファイルはジャーナル関係のファイル用として作成したOpenTP1ファイルを指定します。

また，-jオプションと-bオプションを同時に指定した場合，-bオプションは無効になります。

ログサービス定義

形式

set形式

〔set log_filesize=メッセージログファイルの最大サイズ〕
〔set log_msg_console=Y|N〕
〔set log_msg_allno=Y|N〕
〔set log_msg_prcid=Y|N〕
〔set log_msg_prcno=Y|N〕
〔set log_msg_sysid=Y|N〕
〔set log_msg_date=Y|N〕
〔set log_msg_time=Y|N〕
〔set log_msg_hostname=Y|N〕
〔set log_msg_pgmid=Y|N〕
〔set log_jp1_allno=Y|N〕
〔set log_jp1_prcid=Y|N〕
〔set log_jp1_prcno=Y|N〕
〔set log_jp1_sysid=Y|N〕
〔set log_jp1_date=Y|N〕
〔set log_jp1_time=Y|N〕
〔set log_jp1_hostname=Y|N〕
〔set log_jp1_pgmid=Y|N〕
〔set log_notify_out=Y|N〕
〔set log_notify_allno=Y|N〕
〔set log_notify_prcid=Y|N〕
〔set log_notify_prcno=Y|N〕
〔set log_notify_sysid=Y|N〕
〔set log_notify_date=Y|N〕
〔set log_notify_time=Y|N〕
〔set log_notify_hostname=Y|N〕
〔set log_notify_pgmid=Y|N〕
〔set log_jerr_rint=メッセージログ出力抑止回数〕
〔set log_syslog_out=syslog出力レベル〕
〔set log_syslog_allno=Y|N〕
〔set log_syslog_prcid=Y|N〕
〔set log_syslog_prcno=Y|N〕
〔set log_syslog_sysid=Y|N〕
〔set log_syslog_date=Y|N〕
〔set log_syslog_time=Y|N〕
〔set log_syslog_hostname=Y|N〕
〔set log_syslog_pgmid=Y|N〕
〔set log_syslog_append_nodeid=Y|N〕
〔set log_syslog_elist=syslog失敗リストのエレメント数〕
〔set log_syslog_elist_rint=syslog失敗リストを定期的に出力する間隔〕
〔set log_syslog_synchro=Y|N〕
〔set log_audit_out=Y|N〕
〔set log_audit_path=監査ログファイルの出力先ディレクトリ〕
〔set log_audit_size=監査ログファイルの最大サイズ〕
〔set log_audit_count=監査ログファイルの最大数〕
〔set log_audit_message=監査ログを取得する項目のメッセージID
                     〔,監査ログを取得する項目のメッセージID〕…〕
〔set watch_time=最大応答待ち時間〕

コマンド形式

なし。

putenv形式

〔putenv TZ タイムゾーン〕
〔putenv DCSYSLOGOUT 1|1以外の文字列〕
〔putenv DCLOGDEFPID 1|1以外の文字列〕

機能

メッセージログの出力など，次に示すログサービス機能に関する環境を定義します。

メッセージログ出力機能：メッセージログをメッセージログファイルに出力します。

リアルタイム出力機能：メッセージログを標準出力に出力します。

JP1イベントサービスへの登録機能：JP1イベントサービス機能にイベントを登録します。

メッセージログ通知機能：メッセージログを専用のアプリケーションプログラムへ通知します。

syslog出力機能：メッセージログをsyslogへ出力します。

監査ログ機能：監査ログを監査ログファイルへ出力します。

説明

set形式のオペランド

●log_filesize=メッセージログファイルの最大サイズ

　〜〈符号なし整数〉((1〜32767))《10240》（単位：キロバイト）

メッセージログファイルの最大サイズを指定します。ログサービスごとに二つのメッセージログファイルがあります。指定した最大サイズに達したら，メッセージログファイルを切り替えます。

●log_msg_console=Y|N

　〜《Y》

リアルタイム出力機能を使用するかどうかを指定します。

Y

リアルタイム出力機能を使用します。

N

リアルタイム出力機能を使用しません。

Yを指定したときだけ，以下のオペランド（log_msg_xxxx）の指定が有効になります。

●log_msg_allno=Y|N

　〜《N》

リアルタイム出力機能を使用する時に，メッセージログのシステム内のメッセージ通番を付けるかどうかを指定します。

Y

メッセージログのシステム内のメッセージ通番を付けます。

N

メッセージログのシステム内のメッセージ通番を付けません。

●log_msg_prcid=Y|N

　〜《N》

リアルタイム出力機能を使用する時に，要求元のプロセスのプロセスIDを付けるかどうかを指定します。

Y

要求元のプロセスのプロセスIDを付けます。

N

要求元のプロセスのプロセスIDを付けません。

●log_msg_prcno=Y|N

　〜《N》

リアルタイム出力機能を使用する時に，メッセージログのプロセス内のメッセージ通番を付けるかどうかを指定します。

Y

メッセージログのプロセス内のメッセージ通番を付けます。

N

メッセージログのプロセス内のメッセージ通番を付けません。

●log_msg_sysid=Y|N

　〜《Y》

リアルタイム出力機能を使用する時に，OpenTP1識別子を付けるかどうかを指定します。

Y

OpenTP1識別子を付けます。

N

OpenTP1識別子を付けません。

●log_msg_date=Y|N

　〜《Y》

リアルタイム出力機能を使用する時に，メッセージログの出力要求時の日付を付けるかどうかを指定します。

Y

メッセージログの出力要求時の日付を付けます。

N

メッセージログの出力要求時の日付を付けません。

●log_msg_time=Y|N

　〜《Y》

リアルタイム出力機能を使用する時に，メッセージログの出力要求時の時刻を付けるかどうかを指定します。

Y

メッセージログの出力要求時の時刻を付けます。

N

メッセージログの出力要求時の時刻を付けません。

●log_msg_hostname=Y|N

　〜《Y》

リアルタイム出力機能を使用する時に，メッセージログの出力要求元のホスト名を付けるかどうかを指定します。

Y

メッセージログの出力要求元のホスト名を付けます。

N

メッセージログの出力要求元のホスト名を付けません。

●log_msg_pgmid=Y|N

　〜《Y》

リアルタイム出力機能を使用する時に，メッセージログの出力要求元のプログラムIDを付けるかどうかを指定します。

Y

メッセージログの出力要求元のプログラムIDを付けます。

N

メッセージログの出力要求元のプログラムIDを付けません。

●log_jp1_allno=Y|N

　〜《N》

JP1イベントサービス機能に出力する場合，メッセージログのシステム内の通番を付けるかどうかを指定します。

Y

メッセージログのシステム内の通番を付けます。

N

メッセージログのシステム内の通番を付けません。

●log_jp1_prcid=Y|N

　〜《N》

JP1イベントサービス機能に出力する場合，メッセージログのプロセスIDを付けるかどうかを指定します。

Y

メッセージログのプロセスIDを付けます。

N

メッセージログのプロセスIDを付けません。

●log_jp1_prcno=Y|N

　〜《N》

JP1イベントサービス機能に出力する場合，メッセージログのプロセス内の通番を付けるかどうかを指定します。

Y

メッセージログのプロセス内の通番を付けます。

N

メッセージログのプロセス内の通番を付けません。

●log_jp1_sysid=Y|N

　〜《Y》

JP1イベントサービス機能に出力する場合，OpenTP1識別子を付けるかどうかを指定します。

Y

OpenTP1識別子を付けます。

N

OpenTP1識別子を付けません。

●log_jp1_date=Y|N

　〜《Y》

JP1イベントサービス機能に出力する場合，メッセージログの出力要求時の日付を付けるかどうかを指定します。

Y

メッセージログの出力要求時の日付を付けます。

N

メッセージログの出力要求時の日付を付けません。

●log_jp1_time=Y|N

　〜《Y》

JP1イベントサービス機能に出力する場合，メッセージログの出力要求時の時刻を付けるかどうかを指定します。

Y

メッセージログの出力要求時の時刻を付けます。

N

メッセージログの出力要求時の時刻を付けません。

●log_jp1_hostname=Y|N

　〜《Y》

JP1イベントサービス機能に出力する場合，メッセージログの出力要求元のホスト名を付けるかどうかを指定します。

Y

メッセージログの出力要求元のホスト名を付けます。

N

メッセージログの出力要求元のホスト名を付けません。

●log_jp1_pgmid=Y|N

　〜《Y》

JP1イベントサービス機能に出力する場合，メッセージログの出力要求元のプログラムIDを付けるかどうかを指定します。

Y

メッセージログの出力要求元のプログラムIDを付けます。

N

メッセージログの出力要求元のプログラムIDを付けません。

●log_notify_out=Y|N

　〜《N》

メッセージログ通知機能を使用するかどうかを指定します。

Y

メッセージログ通知機能を使用します。

N

メッセージログ通知機能を使用しません。

Yを指定したときだけ，以下のオペランド（log_notify_xxxx）の指定が有効になります。

●log_notify_allno=Y|N

　〜《N》

メッセージログ通知機能を使用するときに，メッセージログのシステム内の通番を付けるかどうかを指定します。

Y

メッセージログのシステム内の通番を付けます。

N

メッセージログのシステム内の通番を付けません。

●log_notify_prcid=Y|N

　〜《N》

メッセージログ通知機能を使用するときに，要求元のプロセスのプロセスIDを付けるかどうかを指定します。

Y

要求元のプロセスのプロセスIDを付けます。

N

要求元のプロセスのプロセスIDを付けません。

●log_notify_prcno=Y|N

　〜《N》

メッセージログ通知機能を使用するときに，メッセージログのプロセス内の通番を付けるかどうかを指定します。

Y

メッセージログのプロセス内の通番を付けます。

N

メッセージログのプロセス内の通番を付けません。

●log_notify_sysid=Y|N

　〜《Y》

メッセージログ通知機能を使用するときに，OpenTP1識別子を付けるかどうかを指定します。

Y

OpenTP1識別子を付けます。

N

OpenTP1識別子を付けません。

●log_notify_date=Y|N

　〜《Y》

メッセージログ通知機能を使用するときに，メッセージログの出力要求時の日付を付けるかどうかを指定します。

Y

メッセージログの出力要求時の日付を付けます。

N

メッセージログの出力要求時の日付を付けません。

●log_notify_time=Y|N

　〜《Y》

メッセージログ通知機能を使用するときに，メッセージログの出力要求時の時刻を付けるかどうかを指定します。

Y

メッセージログの出力要求時の時刻を付けます。

N

メッセージログの出力要求時の時刻を付けません。

●log_notify_hostname=Y|N

　〜《Y》

メッセージログ通知機能を使用するときに，メッセージログの出力要求元のホスト名を付けるかどうかを指定します。

Y

メッセージログの出力要求元のホスト名を付けます。

N

メッセージログの出力要求元のホスト名を付けません。

●log_notify_pgmid=Y|N

　〜《Y》

メッセージログ通知機能を使用するときに，メッセージログの出力要求元のプログラムIDを付けるかどうかを指定します。

Y

メッセージログの出力要求元のプログラムIDを付けます。

N

メッセージログの出力要求元のプログラムIDを付けません。

●log_jerr_rint=メッセージログ出力抑止回数

　〜〈符号なし整数〉((1〜65536))《32》

JP1イベントサービス機能へメッセージログ出力中に，エラーが発生した場合のメッセージログ出力抑止回数を指定します。

JP1イベントサービス機能へメッセージログ出力中に，エラーが発生した場合，エラー発生後のメッセージログ出力は，log_jerr_rintオペランドに指定した回数分抑止し，再び出力を試みます。

●log_syslog_out=syslog出力レベル

　〜〈符号なし整数〉((0〜2))《1》

ログファイルへ出力される全メッセージについて，syslogへ出力要求するレベル（種類）を指定します。

0

メッセージをsyslogへ出力要求しません。

1

メッセージの種類が-Eおよび-Wの場合だけsyslogへ出力要求します。

2

全メッセージをsyslogへ出力要求します。

1または2の指定は，環境変数DCSYSLOGOUTに1が指定されている場合に有効となります。

以降に指定するlog_syslog_xxxxオペランドは，log_syslog_outオペランドに1または2を指定した場合に有効となります。

このオペランドを指定することで，UAPから発行されるdc_logprint関数で出力するメッセージを制御できます。ただし，それ以外のメッセージについては完全には制御できません。そのため，環境変数DCSYSLOGOUTに1を指定した場合，このオペランドに0または1を指定しても，抑止対象のメッセージがsyslogへ出力されることがあります。

また，次のメッセージIDは，log_syslog_outオペランドの指定値に関係なくsyslogへ出力します。

性能検証用トレース取得サービスが出力するメッセージ

KFCA26700-W

KFCA26705-W

KFCA26710-I

性能検証用トレース取得サービスが出力するメッセージの表示レベルについては，性能検証用トレース定義のprf_information_levelオペランドの説明を参照してください。

OpenTP1監視サービスが出力するメッセージ

KFCA33309-E

KFCA33310-W

KFCA33311-I

KFCA33312-I

KFCA33313-W

KFCA33314-W

KFCA33315-W

syslogに出力されるメッセージを完全に制御する場合，syslogdの構成ファイルの設定を変更する必要があります。

OpenTP1では，次の情報を付加してsyslogへ出力要求を行います。syslogへの出力を完全に制御する場合は，これらの情報を基にsyslogdの構成ファイルの設定を変更してください。

syslogのfacility：LOG_USER

syslogのlevel

メッセージの種類が-Eの場合：LOG_ERR

メッセージの種類が-Wの場合：LOG_WARNING

メッセージの種類が-Iの場合：LOG_INFO

メッセージの種類が-Rの場合：LOG_NOTICE

syslogへのメッセージ出力可否を，OS別に次に示します。

OS

syslogへの出力

日本語環境

英語環境

AIX

○

○

HP-UX (IPF)

○

○

HP-UX (PA-RISC)

×

○

Linux

○

○

Solaris

×

○

Windows

−

−

（凡例）

○：出力できます。

×：出力できません。

−：対象外です。

●log_syslog_allno=Y|N

　〜《N》

syslog出力機能を使用するときに，メッセージログのシステム内の通番を付けるかどうかを指定します。

Y

メッセージログのシステム内の通番を付けます。

N

メッセージログのシステム内の通番を付けません。

●log_syslog_prcid=Y|N

　〜《N》

syslog出力機能を使用するときに，要求元のプロセスのプロセスIDを付けるかどうかを指定します。

Y

要求元のプロセスのプロセスIDを付けます。

N

要求元のプロセスのプロセスIDを付けません。

●log_syslog_prcno=Y|N

　〜《N》

syslog出力機能を使用するときに，メッセージログのプロセス内の通番を付けるかどうかを指定します。

Y

メッセージログのプロセス内の通番を付けます。

N

メッセージログのプロセス内の通番を付けません。

●log_syslog_sysid=Y|N

　〜《N》

syslog出力機能を使用するときに，OpenTP1識別子を付けるかどうかを指定します。

Y

OpenTP1識別子を付けます。

N

OpenTP1識別子を付けません。

●log_syslog_date=Y|N

　〜《N》

syslog出力機能を使用するときに，メッセージログの出力要求時の日付を付けるかどうかを指定します。

Y

メッセージログの出力要求時の日付を付けます。

N

メッセージログの出力要求時の日付を付けません。

●log_syslog_time=Y|N

　〜《N》

syslog出力機能を使用するときに，メッセージログの出力要求時の時刻を付けるかどうかを指定します。

Y

メッセージログの出力要求時の時刻を付けます。

N

メッセージログの出力要求時の時刻を付けません。

●log_syslog_hostname=Y|N

　〜《N》

syslog出力機能を使用するときに，メッセージログの出力要求元のホスト名を付けるかどうかを指定します。

Y

メッセージログの出力要求元のホスト名を付けます。

N

メッセージログの出力要求元のホスト名を付けません。

●log_syslog_pgmid=Y|N

　〜《N》

syslog出力機能を使用するときに，メッセージログの出力要求元のプログラムIDを付けるかどうかを指定します。

Y

メッセージログの出力要求元のプログラムIDを付けます。

N

メッセージログの出力要求元のプログラムIDを付けません。

●log_syslog_append_nodeid=Y|N

　〜《N》

syslog出力機能を使用するときに，ノード識別子を付けるかどうかを指定します。

Y

ノード識別子を付けます。

N

ノード識別子を付けません。

●log_syslog_elist=syslog失敗リストのエレメント数

　〜〈符号なし整数〉((0〜65536))《0》

ログサービスがsyslogファイルへの出力に失敗した場合に，該当するメッセージをリトライタイミングまで保管するメモリキューのエレメント数を指定します。

syslog失敗リストが満杯になった状態で，新たにメッセージを保管する必要が生じた場合は，保管されている最も古いメッセージを削除したあと，新しいメッセージを保管します。

1エレメントのサイズは512バイトです。

このオペランドは，1以上の値を指定し，log_syslog_outオペランドでも1以上の値を指定した場合だけ，有効になります。

syslog失敗リストに保管されているメッセージを定期的に出力する間隔は，log_syslog_elist_rintオペランドで指定します。

この機能は，AIXおよびLinuxで使用できます。なお，Linuxでこの機能を使用する場合は，拡張SYSLOG機能※が必要となります。拡張SYSLOG機能がインストールされていない場合や，拡張SYSLOG機能が動作しない環境では，この機能は使用できません。

注※

拡張SYSLOG機能はサポートサービス（SD-LS100-FR1N1またはSD-LS200-FR1N1）で提供するプログラムです。

●log_syslog_elist_rint=syslog失敗リストを定期的に出力する間隔

　〜〈符号なし整数〉((0〜65536))《0》（単位：秒）

syslog失敗リストに保管されているメッセージを，定期的にsyslogファイルに出力するための間隔を指定します。

このオペランドで0を指定した場合，syslog失敗リストに保管されているメッセージをsyslogファイルに定期的に出力することはできません。

このオペランドは，log_syslog_outオペランドおよびlog_syslog_elistオペランドで1以上の値を指定した場合だけ有効になります。

この機能は，AIXおよびLinuxで使用できます。なお，Linuxでこの機能を使用する場合は，拡張SYSLOG機能※が必要となります。拡張SYSLOG機能をインストールしていない場合や，拡張SYSLOG機能が動作しない環境では，この機能は使用できません。

注※

拡張SYSLOG機能はサポートサービス（SD-LS100-FR1N1またはSD-LS200-FR1N1）で提供するプログラムです。

●log_syslog_synchro=Y|N

　〜《N》

syslog出力機能を使用しているときにログサーバへの通信に失敗した場合，該当するメッセージログを関連オペランド(log_syslog_xxxx)に従ったフォーマットでsyslogに出力するかどうかを指定します。

ただし，log_syslog_allnoオペランドに限り無効であり，指定した場合は空白になります。

Y

関連オペランドに従ったフォーマットで出力します。

N

関連オペランドに従ったフォーマットで出力しません。

●log_audit_out=Y|N

　〜《N》

監査ログ機能を使用するかどうかを指定します。

Y

監査ログ機能を使用します。

N

監査ログ機能を使用しません。

Yを指定したときだけ，以降のオペランド（log_audit_xxxx）の指定が有効になります。

●log_audit_path=監査ログファイルの出力先ディレクトリ

　〜〈1〜63文字のパス名〉《$DCDIR/auditlog》

監査ログ機能を使用する場合に，監査ログファイルを出力するディレクトリを絶対パスで指定します。ただし，共有ディスク上のディレクトリは指定しないでください。なお，最下層のディレクトリは，dcauditsetupコマンドによって作成されますが，上位ディレクトリは事前に準備しておく必要があります。

このオペランドで指定したパスを構成する各ディレクトリのアクセス権限は，ユーザ，グループ，およびその他のユーザのすべてに実行権限が必要です。実行権限がない場合，監査ログの出力でエラーになることがあります。

このオペランドに指定するディレクトリには，監査ログファイルを格納できるディスク容量が必要です。監査ログファイルを格納するディレクトリに必要なディスク容量の計算式を次に示します。

ディスク容量（単位：メガバイト）=監査ログファイルの最大サイズ×監査ログファイルの最大数

このオペランドは，log_audit_outオペランドにYを指定した場合に有効です。

●log_audit_size=監査ログファイルの最大サイズ

　〜〈符号なし整数〉((1〜2047))《10》（単位：メガバイト）

監査ログ機能を使用する場合に，監査ログファイルの最大サイズを指定します。監査ログファイルのサイズが指定値に達した場合には，出力先ファイルの切り替えを行います。

このオペランドは，log_audit_outオペランドにYを指定した場合に有効です。

●log_audit_count=監査ログファイルの最大数

　〜〈符号なし整数〉((1〜256))《2》

監査ログ機能を使用する場合に，監査ログファイルの最大数を指定します。

監査ログの出力先ファイルを切り替える時点で，ファイル数（ログファイル数＋バックアップログファイル数）がこのオペランドの指定値を超える場合は，最も古いファイルを削除します。

このオペランドの指定値とバックアップログファイル名の対応を次の表に示します。

表3‒8　log_audit_countオペランドの指定値とバックアップログファイル名

log_audit_countオペランドの指定値

バックアップログファイル名

1

バックアップログファイルは作成されません。

2〜256

audit001.log〜audit255.log

このオペランドの指定値が大きいほど出力先ファイル切り替え時のオーバヘッドが大きくなるため注意してください。

このオペランドは，log_audit_outオペランドにYを指定した場合に有効です。

●log_audit_message=監査ログを取得する項目のメッセージID〔,監査ログを取得する項目のメッセージID〕…

　〜〈符号なし整数〉((33400〜99999))

監査ログを取得する項目のメッセージIDを33400〜99999の範囲で指定します。指定できるメッセージIDは最大2,048個です。

このオペランドで指定できるメッセージIDについては，「付録C　監査イベントを取得する定義」を参照してください。

なお，このオペランドは，ユーザサービス定義，rapリスナーサービス定義，およびユーザサービスデフォルト定義でも指定できます。指定値の優先順位は次のとおりです（1.＞2.＞3.）。

ユーザサービス定義またはrapリスナーサービス定義

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

ログサービス定義

このオペランドは，log_audit_outオペランドにYを指定した場合に有効です。

●watch_time=最大応答待ち時間

　〜〈符号なし整数〉((0〜65535))（単位：秒）

RPCによってプロセス間で通信する場合，サービス要求を送信してからサービスの応答が返るまでの待ち時間の最大値を指定します。

OpenTP1の終了処理で，このオペランドで指定した時間だけ終了処理を待ち合わせる場合があります。したがって，大きな値を指定した場合，OpenTP1の終了処理に時間が掛かることがあります。

指定時間を過ぎても応答がない場合は，RPCは送受信タイムアウトとしてエラーリターンします。

0を指定した場合は，応答を受信するまで待ち続けます。0を指定した場合，OpenTP1が終了しないことがあります。

省略した場合は，システム共通定義のwatch_timeオペランドの値を仮定します。

このオペランドは，システム共通定義のwatch_timeオペランドのデフォルト値で使用してください。

特別なチューニングを必要とする場合以外は，このオペランドの内容を変更しないことをお勧めします。

システム共通定義のwatch_timeオペランドのデフォルト値よりも，極端に小さな値または大きな値を指定すると，OpenTP1ダウンに至る障害が発生する場合がありますので，ご注意ください。

コマンド形式

なし。

putenv形式のオペランド

●TZ　タイムゾーン

　〜〈文字列〉

環境変数TZを設定します。

タイムゾーンとは，時刻などを表示する場合の環境を設定するものです。

日本の標準時間を表示する場合は，タイムゾーンにJST-9を指定します。

このオペランドで指定したタイムゾーンと，コマンドを実行する環境のタイムゾーンは一致させてください。一致していない場合，syslogの時刻が正しく出力されません。

このオペランドを変更する場合は，dcsetupコマンド（-dn）※で一度OSへの登録を削除し，dcsetupコマンド※で再度登録してください。

注※

dcresetコマンドでは変更が反映されません。

●DCSYSLOGOUT　1|1以外の文字列

syslogへメッセージを出力するかどうかを指定します。

syslogへメッセージを出力する場合は，環境変数DCSYSLOGOUTに1を指定します。1以外の文字列を指定した場合や，このオペランドの指定を省略した場合は，syslogへメッセージを出力しません。

出力制御については，log_syslog_outオペランドの説明を参照してください。

ただし，次のメッセージIDは，DCSYSLOGOUTの指定値に関係なくsyslogへ出力します。

性能検証用トレース取得サービスが出力するメッセージ

KFCA26700-W

KFCA26705-W

KFCA26710-I

性能検証用トレース取得サービスが出力するメッセージの表示レベルについては，性能検証用トレース定義のprf_information_levelオペランドの説明を参照してください。

OpenTP1監視サービスが出力するメッセージ

KFCA33309-E

KFCA33310-W

KFCA33311-I

KFCA33312-I

KFCA33313-W

KFCA33314-W

KFCA33315-W

●DCLOGDEFPID　1|1以外の文字列

メッセージログ出力時に，要求元のプロセスのプロセスIDを従来フォーマットで表示するかどうかを指定します。

従来フォーマットで表示する場合は，環境変数DCLOGDEFPIDに1を指定します。1以外の文字列を指定した場合や，このオペランドの指定を省略した場合は，従来フォーマットで表示しません。

バージョン07-51からヘッダ情報として付けるプロセスIDは半角数字10けたで右詰め表示となります。

従来フォーマットである半角数字5けたで表示したいときは，このオペランドに1を指定してください。

なお，このオペランドはログサービス定義以外には指定しないでください。

この機能を有効にしてプロセスIDを従来フォーマットに戻すと，6けた以上のプロセスIDを持つプロセスからのメッセージ出力でメッセージの付加情報がずれて表示されるなど，従来バージョンと同様の影響があります。

ただし，LinuxやHP-UXの場合は，カーネルパラメタ※でプロセスIDの上限を設定することで，この影響を防止できます。なお，カーネルパラメタでの対応ができない場合は，プロセス数の上限が全体で5けた以内に収まるような環境下で運用することを推奨します。

この機能は，OSがAIXの場合は無効となります（AIX版のOpenTP1では旧バージョンよりプロセスIDの上限は10けたです）。

注※

割り当てられるプロセスIDの上限を設定するカーネルパラメタの有無や仕様は，OSの種別によって異なります。詳細については，使用しているOSのマニュアルを参照してください。

注意事項

syslogに出力できるメッセージ長は，511バイトまでです。512バイト以降のメッセージは切り捨てられます。なお，HP-UX(PA-RISC)版およびSolaris版については，255バイトまでです。

ログサービス定義のオペランドによってはYを指定すると，ユーザメッセージの前にヘッダ情報が付きます。このため，ヘッダ情報の分，syslogに出力できるユーザメッセージのデータ量は少なくなります。

Yを指定した場合にヘッダ情報が付与されるオペランドと，ヘッダ情報として付与されるバイト数を次の表に示します。なお，バイト数には区切りのスペースを含みます。さらにヘッダ情報には，メッセージIDの12バイトが付与されます。

オペランド

ヘッダ情報として付与されるバイト数

log_syslog_allno

8

log_syslog_prcid

11または6※

log_syslog_prcno

8

log_syslog_sysid

3

log_syslog_date

11

log_syslog_time

9

log_syslog_hostname

9

log_syslog_pgmid

4

log_syslog_append_nodeid

5

注※

ログサービス定義の環境変数DCLOGDEFPIDに1を指定した場合，6バイトが付与されます。

512バイト以降のメッセージが切リ捨てられた場合，syslogに出力されている最後の文字が複数バイトのときは，正しく表示されないことがあります。

ログサービスに対して一度に大量のメッセージの出力を要求すると，出力先のファイル種別や関連製品の特性※によっては，一時的にバッファ不足などのエラーとなり，メッセージが出力できない場合があります。この場合，ログサービスとしては，一時的に出力先を標準エラー出力に切り替えたり，メッセージの出力を抑止したりするなどの制御をします。このため，一定期間，目的のファイルにメッセージが出力されないことがあります。

一方，メッセージの出力頻度や全体のメッセージ量は，システムのスループットにも依存します。このため，一般的に，CPUや関連するハードウェアの性能が上がると単位時間当たりのメッセージ出力量も増えることがあります。

また，運用面では，一度に起動または停止するユーザサーバの数が非常に多い場合や，UAPからのメッセージが多量に出力されたり一時期に集中して出力されたりするような場合は，メッセージの量が問題になることがあります。

このような場合は，メッセージの出力量を削減したり，メッセージの出力先を変更したりしてください。

注※

製品によっては，処理できる最大の処理件数が明示されているものもあります。出力先に応じ，関連製品の仕様を確認してください。

メッセージログ通知機能を使用する場合も，4.の注意事項と同様ですのでご注意ください。ログサービスからUAPへのメッセージログの送信で一時的にバッファ不足などのエラーが発生した場合，ログサービスとしてはメッセージを再送しないで次のメッセージを処理します。このため，UAPで受信できる処理能力を超えて一度に多量のメッセージ出力要求がログサービスに対して行われるような場合は，メッセージが消失するおそれがあります。

マルチノード構成定義

形式

set形式

〔set dcmstart_watch_time=dcmstart打ち切り時間〕
〔set dcmstop_watch_time=dcmstop打ち切り時間〕
〔set watch_time=最大応答待ち時間〕

コマンド形式

{{dcmarea  {-m  マルチノードエリア識別子|-g  マルチノードサブエリア識別子}
            -w  ノード識別子  〔,ノード識別子〕…}}

機能

マルチノードエリアまたはマルチノードサブエリアの構成を定義します。

マルチノード連携制御機能のうち，次の機能に関するサービス要求の最大応答待ち時間を定義します。

dcmstartコマンド

dcmstopコマンド

dcndlsコマンド

説明

set形式のオペランド

●dcmstart_watch_time=dcmstart打ち切り時間

　〜〈符号なし整数〉((0〜65535))《600》（単位：秒）

dcmstartコマンドの実行から処理を打ち切るまでの時間を指定します。

指定時間を過ぎても開始処理中のOpenTP1ノードがある場合は，メッセージを出力してそのOpenTP1ノードの監視とdcmstartコマンドは打ち切られます。

0を指定した場合は，すべてのOpenTP1ノードが開始処理を完了するか，開始できないことを確認するまで監視が続きます。

1〜59を指定した場合は，60を仮定します。

●dcmstop_watch_time=dcmstop打ち切り時間

　〜〈符号なし整数〉((0〜65535))《600》（単位：秒）

dcmstopコマンドの実行から処理を打ち切るまでの時間を指定します。

指定時間を過ぎても開始中のOpenTP1ノードがある場合は，メッセージを出力してそのOpenTP1ノードの監視とdcmstopコマンドは打ち切られます。

0を指定した場合は，すべてのOpenTP1ノードが開始処理を完了するか，開始できないことを確認するまで監視が続きます。

●watch_time=最大応答待ち時間

　〜〈符号なし整数〉((0〜65535))《180》（単位：秒）

RPCによってプロセス間で通信する場合，サービス要求を送信してからサービスの応答が返るまでの待ち時間の最大値を指定します。

OpenTP1の終了処理で，このオペランドで指定した時間だけ終了処理を待ち合わせる場合があります。したがって，大きな値を指定した場合，OpenTP1の終了処理に時間が掛かる場合があります。

指定時間を過ぎても応答がない場合は，RPCは送受信タイムアウトとしてエラーリターンします。

0を指定した場合は，応答を受信するまで待ち続けます。0を指定した場合，OpenTP1が終了しない場合があります。

省略した場合は，システム共通定義のwatch_timeオペランドの値を仮定します。

このオペランドは，マルチノード連携制御機能を使用するOpenTP1ノード以外は指定する必要はありません。

このオペランドは，デフォルト値で使用してください。

特別なチューニングを必要とする場合以外は，このオペランドの内容を変更しないことをお勧めします。

このオペランドのデフォルト値よりも，極端に小さな値または大きな値を指定すると，OpenTP1ダウンに至る障害が発生する場合がありますので，ご注意ください。

コマンド形式

次ページ以降に記述しています。

dcmarea

名称

マルチノードエリア／サブエリアに属するノード識別子を指定する

形式

{{dcmarea  {-m  マルチノードエリア識別子|-g  マルチノードサブエリア識別子}
            -w  ノード識別子  〔,ノード識別子〕…}}

機能

同一のマルチノードエリアまたはマルチノードサブエリアに属するOpenTP1ノードの構成を定義します。

次のことはオンライン中にできません。

マルチノードエリアまたはマルチノードサブエリアの設定

マルチノードエリアまたはマルチノードサブエリアへのOpenTP1ノードの追加および削除

次に示す前提条件に従ってください。この条件を満たしていない場合は，マルチノード機能の動作を保証しません。

（前提条件）

マルチノードエリア識別子は1個指定します。

マルチノードエリアに属するOpenTP1ノードの個数は128以下です。

同一マルチノードエリア（サブエリア）識別子に対して複数のコマンドを指定した場合，それら複数のコマンドの論理和とします。

ノード識別子は，システム共通定義に指定したものを指定します。

ホストとホスト名が1対1に対応しているホストを，マルチOpenTP1構成にする場合，そのホスト内の各OpenTP1ノードは，別々のマルチノードエリアおよびマルチノードサブエリアに属します。

マルチノードサブエリアに属するOpenTP1ノードは，必ずマルチノードエリアに属します。

マルチノード構成定義には，全マルチノードサブエリアの構成を記述します。

マルチノードエリアまたはマルチノードサブエリアを構成する各OpenTP1ノードのマルチノード構成定義は一致させます。

コマンド引数

●-m　マルチノードエリア識別子

　〜〈1〜8文字の識別子〉

マルチノードエリア識別子を指定します。

●-g　マルチノードサブエリア識別子

　〜〈1〜8文字の識別子〉

マルチノードサブエリア識別子を指定します。

●-w　ノード識別子〔，ノード識別子〕…

　〜〈4文字の識別子〉

マルチノードエリアまたはマルチノードサブエリアに属するOpenTP1ノードのノード識別子を指定します。各OpenTP1ノードのシステム共通定義に指定したノード識別子でなくてはなりません。

マルチノード物理定義

形式

set形式

なし。

コマンド形式

{{dcprcport -w  ノード識別子
            -h  ホスト名
            -p  ポート番号}}

機能

マルチノード構成定義に定義した各OpenTP1ノードについて，OpenTP1ノードがあるホスト名と，そのノードでマルチノード連携制御機能が使用するポート番号を定義します。

説明

set形式

なし。

コマンド形式

次ページ以降に記述しています。

dcprcport

名称

マルチノードのホスト名とポート番号を指定する

形式

{{dcprcport -w  ノード識別子
            -h  ホスト名
            -p  ポート番号}}

機能

マルチノード構成定義に定義した各OpenTP1ノードについて，OpenTP1ノードがあるホスト名と，そのノードでマルチノード連携制御機能が使用するポート番号を定義します。

系切り替え機能を使用しているOpenTP1ノードは，実行系と待機系を別に定義してください。

系切り替え機能を使用していないOpenTP1ノードは，ノード識別子を重複しないように指定してください。

マルチノード構成定義で定義したOpenTP1ノードは，必ずこの定義に指定してください。また，この定義に指定できるOpenTP1ノードは，最大128個です。

オプション

●-w　ノード識別子

　〜〈4文字の識別子〉

マルチノード構成定義で定義したノード識別子を指定します。

●-h　ホスト名

　〜〈1〜64文字の識別子〉

ノード識別子に対応するOpenTP1ノードがあるホスト名を指定します。

ホスト名は，/etc/hostsに登録されていなければなりません。

保守用LANがあるときは，保守用LANのホスト名を指定してください。保守用LANがないときは，システム共通定義のmy_hostオペランドで指定したホスト名（省略時は標準ホスト名）を指定してください。

●-p　ポート番号

　〜〈符号なし整数〉((5001〜49999))

ノード識別子に対応するマルチノード連携制御機能で使用するポート番号を指定します。

マルチノード連携制御機能で使用するポート番号は，システム共通定義のprc_portオペランドで指定した値を設定してください。

グローバルアーカイブジャーナルサービス定義

形式

set形式

〔set jnl_arc_terminate_timeout=待ち合わせ最大時間〕
〔set max_socket_descriptors=ソケット用ファイル記述子の最大数〕
〔set jnl_arc_ipc_buff_size=TCP/IPの送受信バッファサイズ〕
〔set jnl_watch_time=グローバルアーカイブジャーナルサービスの通信応答待ち時間〕
〔set jnl_message_id_change_level=メッセージIDの変更レベル〕

コマンド形式

jnldfsv -a  グローバルアーカイブジャーナルサービスのリソースグループ名
       〔〔，グローバルアーカイブジャーナルサービスの
             リソースグループ名〕…〕

機能

グローバルアーカイブジャーナルサービスを使用するための実行環境を定義します。この機能を使用するには，TP1/Multiが必要です。

set形式のオペランド

●jnl_arc_terminate_timeout=待ち合わせ最大時間

　〜〈符号なし整数〉((0〜3600))《0》（単位：秒）

アーカイブノードを終了させてから，接続しているすべての被アーカイブノードの接続を解除するまでの最大待ち時間を秒単位で指定します。指定時間内に接続が解除された場合は，アーカイブノードは終了します。指定時間を過ぎても接続している被アーカイブノードがある場合は，アーカイブノードは終了しません。

0を指定した場合は，すべての被アーカイブノードの接続が解除されるまでアーカイブノードの終了処理が続行されます。

●max_socket_descriptors=ソケット用ファイル記述子の最大数

　〜〈符号なし整数〉((32〜2032))

OpenTP1制御下のプロセス※でのソケット用に使用するファイル記述子の最大数を指定します。

指定値の範囲は，適用OSがAIX，HP-UXまたはWindowsの場合は32〜2032，適用OSがSolarisまたはLinuxの場合は32〜1008です。

OpenTP1制御下のプロセス※は，システムサーバやユーザサーバとの間で，ソケットを使用したTCP/IP通信でプロセス間の情報交換をしています。そのため，同時に稼働するUAPプロセスの数，および通信する他ノードの数によって，このオペランドを変更する必要があります。

注※

MCFサービス（MCFマネジャサービス，MCF通信サービス，およびアプリケーション起動サービス）以外のOpenTP1プロセスが対象です。MCFサービスの場合は，「システムサービス情報定義」および「システムサービス共通情報定義」を参照してください。

ソケット用ファイル記述子の最大数の算出式を，次に示します。

↑(グローバルアーカイブジャーナルサービスに対してサービスを要求してくるノード数※1＋システムサービスプロセス数※2)／0.8↑

↑↑：小数点以下を切り上げます。

注※1

グローバルアーカイブジャーナルサービスに対してサービスを要求してくるノード数とは，次に示す値の合計です。

自OpenTP1のall_nodeオペランドに指定したノード名の数

自ノード名を，OpenTP1のall_nodeオペランドに指定している，他ノードの数

注※2

システムサービスプロセス数とは，自OpenTP1内のシステムサービスプロセスの数です。自OpenTP1内のシステムサービスプロセスは，rpcstatコマンドで表示されるサーバ名をカウントすることで求められます。rpcstatコマンドで表示されるサーバ名のうち，マニュアル「OpenTP1　解説」のOpenTP1のプロセス構造に記載されているシステムサービスプロセスをカウントしてください。

このオペランドの指定が小さいと，OpenTP1制御下の他プロセスとのコネクションが設定できなくなるため，プロセスがKFCA00307-Eメッセージを出力して異常終了します。

指定値の優先順位は次のとおりです（1.＞2.）。

グローバルアーカイブジャーナルサービス定義

システム共通定義

ここで指定を省略した場合，システム共通定義の値を仮定します。

●jnl_arc_ipc_buff_size=TCP/IPの送受信バッファサイズ

　〜〈符号なし整数〉((8192〜1048576))《61440》（単位：バイト）

被アーカイブノードから転送されるジャーナルを受信するアーカイブジャーナル受信プロセスが使用するTCP/IPの送受信バッファのサイズを指定します。

高速な通信媒体を使用する場合，値を大きくすることで性能を向上できます。このオペランドの値は，各OSで指定できるTCP/IPのバッファサイズの上限値以下の値を指定してください。また，このオペランドの値は，被アーカイブノード側のジャーナルサービス定義のjnl_arc_ipc_buff_sizeオペランドの指定値と合わせてください。

●jnl_watch_time=グローバルアーカイブジャーナルサービスの通信応答待ち時間

　〜〈符号なし整数〉((0〜65535))《180》（単位：秒）

グローバルアーカイブジャーナルサービスがRPCによってプロセス間で通信する場合の，サービス要求を送信してからサービスの応答が返るまでの待ち時間の最大値を指定します。指定時間を過ぎても応答がない場合，RPCは送受信タイムアウトとしてエラーリターンします。

0を指定した場合は，応答を受信するまで待ち続けます。この場合，OpenTP1が終了しないことがあります。

特別なチューニングが不要な場合は，このオペランドの内容を変更しないでください。

jnl_watch_timeオペランドが有効になる範囲を次に示します。

jnlopnfgコマンド

jnlclsfgコマンド

jnlchgfgコマンド

jnlunlfgコマンド

jnlswpfgコマンド※

jnlardisコマンド

ジャーナルファイル障害，満杯時のスワップ要求通信応答待ち時間

注※

jnlswpfgコマンドの通信応答待ち時間は，jnl_watch_timeオペランドに指定した値の2倍になります。

●jnl_message_id_change_level=メッセージIDの変更レベル

　〜〈符号なし整数〉((0〜1))《0》

グローバルアーカイブジャーナルサービスが出力するメッセージで，重要な情報となるメッセージの種別を変更します。

メッセージログを監視し，メッセージの種類によって管理方法を区別したい場合にこのオペランドを使用してください。

このオペランドによって変更されるのはメッセージIDだけであり，メッセージの内容は変更されません。

0

メッセージIDを変更しないで，従来どおりのメッセージIDで出力します。

1

メッセージIDを変更し，出力します。

このオペランドの指定値と出力されるメッセージの関係を次に示します。

jnl_message_id_change_level

オペランドの指定値

0

1

出力されるメッセージID

KFCA01224-I

KFCA01230-W

KFCA01250-I

KFCA01231-W

コマンド形式

次ページ以降に記述しています。

jnldfsv

名称

グローバルアーカイブジャーナルサービスのリソースグループ名の指定

形式

jnldfsv -a  グローバルアーカイブジャーナルサービスのリソースグループ名
      〔〔，グローバルアーカイブジャーナルサービスの
            リソースグループ名〕…〕

機能

グローバルアーカイブジャーナルサービスのリソースグループ名を指定します。

オプション

●-a　グローバルアーカイブジャーナルサービスのリソースグループ名

　〜〈1〜8文字の識別子〉

グローバルアーカイブジャーナルサービスのリソースグループ名（アーカイブジャーナルサービス定義のファイル名）を指定します。

リソースグループ名は16個まで指定できます。リソースグループ名は重複するとエラーとなります。

アーカイブジャーナルサービス定義

形式

set形式

〔set jnl_dual=Y|N〕
〔set jnl_singleoperation=Y|N〕
〔set jnl_rerun_swap=Y|N〕
〔set jnl_max_file_dispersion=並列アクセス化する場合の最大分散数〕
〔set jnl_min_file_dispersion=並列アクセス化する場合の最小分散数〕
〔set jnl_unload_check=Y|N〕
〔set jnl_arc_max_datasize=アーカイブ時の転送データの最大長〕

コマンド形式

{{{{jnladdfg  -g  アーカイブジャーナルファイル
                  のファイルグループ名  〔ONL〕}}
  {{jnladdpf  -g  アーカイブジャーナルファイルの
                  ファイルグループ名
            〔-e  要素ファイル名〕
              -a  物理ファイル名
            〔-b  物理ファイル名〕}}}}

機能

グローバルアーカイブジャーナルサービスを使用するための実行環境を定義します。この機能を使用するには，TP1/Multiが必要です。

set形式のオペランド

●jnl_dual=Y|N

　〜《N》

アーカイブジャーナルファイルを二重化するかどうかを指定します。

Y

二重化します。

N

二重化しません。

●jnl_singleoperation=Y|N

　〜《N》

jnl_dualオペランドにYを指定した場合に，片系クローズ状態のファイルグループを使用するかどうかを指定します。

Y

片系クローズのファイルグループでも使用します。

N

片系クローズのファイルグループは使用しません。

●jnl_rerun_swap=Y|N

　〜《N》

グローバルアーカイブジャーナルサービスのあるノードがリランしたとき，アーカイブジャーナルファイルをスワップするかどうかを指定します。

Y

スワップします。

N

スワップしません。

●jnl_max_file_dispersion=並列アクセス化する場合の最大分散数

　〜〈符号なし整数〉((1〜8))《1》

アーカイブジャーナルを並列アクセス化する場合の最大分散数を指定します。

一つのファイルグループで使用する最大要素ファイル数を指定してください。1を指定した場合，または指定を省略した場合は，jnl_min_file_dispersionオペランドの指定値は無効になります。

●jnl_min_file_dispersion=並列アクセス化する場合の最小分散数

　〜〈符号なし整数〉((1〜8))《1》

アーカイブジャーナルを並列アクセス化する場合の最小分散数を指定します。

ファイルグループを構成する要素ファイルが障害などで使用できなくなった場合でも，現用として使用可能とする最小要素ファイル数を指定してください。

使用可能な要素ファイル数が最小要素ファイル数未満になった場合，ファイルグループは使用できなくなります。並列アクセス化する場合の最小分散数は次の範囲で指定してください。

最大分散数≧最小分散数≧1

●jnl_unload_check=Y|N

　〜《Y》

スワップ先のファイルグループを決定する時に，アンロード待ち状態をチェックするかどうかを指定します。

Y

アンロード待ち状態をチェックします。

N

アンロード待ち状態をチェックしません。

Yを指定した場合，OpenTP1が強制終了，または異常終了したあとにOpenTP1を強制正常開始したとき，前回のオンラインで現用として使用されていたジャーナルファイルはクローズ状態となります。jnlunlfgコマンドまたはjnlchgfgコマンドでファイルグループのステータスを変更するまで，ジャーナルファイルは使用できません。

Nを指定した場合，アンロードしていないアーカイブジャーナルは失われます。そのため，通常は，テストなどでジャーナルの運用（稼働統計情報の編集など）を必要としない場合に指定します。また，ジャーナルが失われるため，アンロードジャーナルファイルを指定するコマンドが，一部使用できなくなります。詳細は，マニュアル「OpenTP1 運用と操作」を参照してください。

●jnl_arc_max_datasize=アーカイブ時の転送データの最大長

　〜〈符号なし整数〉((1020〜8188))《1020》（単位：キロバイト）

被アーカイブノードからアーカイブされるジャーナルデータの最大転送データ長を指定します。このオペランドの指定値は，該当するリソースグループに接続する被アーカイブノードの内で最も大きな転送データ長の値を指定してください。

また，このオペランドに1020より大きな値を指定する場合は，次の計算式によって求めた値より大きな値をシステム共通定義のrpc_max_message_sizeオペランドに指定してください。

rpc_max_message_size ≧ ↑(jnl_arc_max_datasize×1024＋4096) / 1048576↑

計算式で求められた値よりrpc_max_message_sizeの指定値が小さい場合は，OpenTP1の開始時にKFCA01113-Eメッセージの理由コード425を出力してOpenTP1の開始処理を中止します。

コマンド形式

次ページ以降に記述しています。

jnladdfg

名称

アーカイブジャーナルファイルのファイルグループ名と属性の定義

形式

{{jnladdfg  -g  アーカイブジャーナルファイルのファイルグループ名
           〔ONL〕                                              }}

機能

アーカイブジャーナルファイルのファイルグループ名と属性を定義します。

jnladdfg定義コマンドは，アーカイブジャーナルサービス定義内に最低2個，最大256個指定できます。

ただし，ONLを指定したjnladdfg定義コマンドの場合は，最低2個必要です。

なお，ファイルグループ名は，アーカイブジャーナルサービス定義内で一意でなければなりません。

オプション

●-g　アーカイブジャーナルファイルのファイルグループ名

　〜〈1〜8文字の識別子〉

アーカイブジャーナルファイルのファイルグループ名を指定します。

●ONL

このファイルグループを，グローバルアーカイブジャーナルサービスの開始と同時にオープン状態にする場合に指定します。

省略した場合は，グローバルアーカイブジャーナルサービスの開始時点には，クローズ状態の予約のファイルグループになります。このファイルグループを使用する場合は，jnlopnfgコマンドでオープンしなければなりません。

jnladdpf

名称

アーカイブジャーナルファイルのファイルグループを構成する物理ファイルの定義

形式

{{jnladdpf  -g  アーカイブジャーナルファイルのファイルグループ名
          〔-e  要素ファイル名〕
            -a  物理ファイル名
          〔-b  物理ファイル名〕}}

機能

アーカイブジャーナルファイルのファイルグループを構成する，要素ファイルおよび物理ファイルを定義します。

jnladdpf定義コマンドは，ファイルグループに対して最低1個，最大8個指定できます。

なお，物理ファイル名は，OpenTP1システム内で一意でなければなりません。

オプション

●-g　アーカイブジャーナルファイルのファイルグループ名

　〜〈1〜8文字の識別子〉

アーカイブジャーナルファイルのファイルグループの名称を指定します。

ここで指定するファイルグループ名は，あらかじめjnladdfg定義コマンドで定義しておきます。

●-e　要素ファイル名

　〜〈1〜8文字の識別子〉

このファイルグループを構成する要素ファイル名を指定します。

要素ファイル名はアーカイブジャーナルサービス定義内で一意でなければなりません。

並列アクセス化（jnl_max_file_dispersionオペランドに2以上を指定）をする場合は，必ずこのオプションを指定してください。並列アクセス化をしない場合は，指定する必要はありません。

並列アクセス化をする場合に-eオプションを省略すると，定義解析でエラーになります。一つのファイルグループに指定する要素ファイル数は次の範囲で指定してください。

jnl_max_file_dispersionオペランドの指定値≧要素ファイル数≧jnl_min_file_dispersionオペランドの指定値

ここで指定する要素ファイル数がjnl_max_file_dispersionオペランドの指定値を超えた場合，超えた分はオンラインでは使用されません。また，ここで指定する要素ファイル数がjnl_min_file_dispersionオペランドの指定値に満たない場合，そのファイルグループは使用できません。

●-a　物理ファイル名

　〜〈パス名〉

この要素ファイルを構成する物理ファイル名を絶対パス名で指定します。ただし，環境変数は使用できません。この物理ファイルはジャーナル関係のファイル用として作成したOpenTP1ファイルを使用します。

set形式のjnl_dualでファイルの二重化を指定した場合は，ここにA系ファイルの物理ファイル名を指定してください。

●-b　物理ファイル名

　〜〈パス名〉

set形式のjnl_dualでファイルの二重化を指定した場合に，B系ファイルの物理ファイル名を絶対パス名で指定します。ただし，環境変数は使用できません。この物理ファイルはジャーナル関係のファイル用として作成したOpenTP1ファイルを使用します。

二重化の指定をしていない場合に-aおよび-bの物理ファイル名を指定すると，-aの方が有効となります。また，二重化する場合もしない場合も，-bの物理ファイル名だけを指定すると，コマンド全体が無視されます。

DAMサービス定義

形式

set形式

〔set dam_update_block=更新する最大ブロック数〕
〔set dam_added_file=オンライン中に追加する最大論理ファイル数〕
〔set dam_update_block_over=flush|error〕
〔set dam_message_level=1|0〕
〔set dam_tran_process_count=同時に実行するトランザクション
                             ブランチの数〕
〔set dam_cache_size｜dam_cache_size_fix=バッファ領域長〕
〔set dam_cache_attribute=free|fixed|hugepage〕
〔set dam_io_interval=実行間隔時間〕
〔set dam_transaction_access=global|branch〕
〔set dam_io_error_occur=stop|continue〕
〔set dam_cache_reuse_from=last|first〕
〔set dam_default_cache_num=キャッシュブロック再利用境界デフォルト値〕
〔set dam_ex_refer_read=none|stay〕
〔set dam_max_block_size=最大ブロック長〕
〔set dam_kb_size=1000|1024〕
〔set watch_time=最大応答待ち時間〕

コマンド形式

〔damcache 論理ファイル名 キャッシュブロック再利用境界値〕
〔damchlmt 論理ファイル名 キャッシュブロック数のしきい値〕
{{damfile〔-{d|n〔-f〕}〕〔-c〕論理ファイル名  物理ファイル名}}

機能

ファイル回復機能付き直接アクセスファイルを管理するための実行環境を定義します。

説明

set形式のオペランド

●dam_update_block=更新する最大ブロック数

　〜〈符号なし整数〉((1〜32768))《8》

更新するブロックの最大値を指定します。DAMサービスは，この指定値によってシステムサービス用共用メモリプール（動的共用メモリ）上にDAMサービス分のメモリを確保します。そのため，算出式で求めた値よりも大きな値を指定した場合は，システムサービス用共用メモリプール（動的共用メモリ）を圧迫することがあります。

このオペランドに指定する値の算出方法を次に示します。

回復対象のDAMファイルにアクセスする場合

同一のトランザクション内で発生する次のA，B，およびCを合計した値をトランザクションごとに算出し，その中で最大の値をこのオペランドに指定します。

A：dc_dam_read関数で更新目的で入力するブロック数

B：dc_dam_write関数で出力するブロック数

C：dc_dam_read関数で排他あり参照指定で入力するブロック数（ただし，DAMサービス定義のdam_ex_refer_readオペランドにstayを指定した場合だけ）

トランザクションの開始から完了まで更新目的で入出力する場合の算出方法を次に示します

表3‒9　トランザクションの開始から完了まで更新目的で入出力する場合の算出方法

アクセス関数の実行順序

アクセスブロック数

A

B

C

算出値（A+B+C）

トランザクション開始

−

0

0

0

0

dc_dam_read関数（更新目的）

2

2

0

0

2

dc_dam_rewrite関数

2

0

0

0

0

dc_dam_write関数

3

0

3

0

5

トランザクション完了

−

0

0

0

0

最終値

2

3

0

5

（凡例）

−：該当しません

この例では，算出値（A+B+C）が5となるため，dam_update_blockオペランドに5以上の値を指定してください。

回復対象外のDAMファイルにアクセスする場合

一つのUAPで発生する次のDの値，または一つのUAPで発生する次のEおよびFを合計した値からGを引いた値をUAPごとに算出し，その中で最大の値をこのオペランドに指定します。

D：UAPで実行する一つのDAMアクセス関数でアクセスするブロック数の最大値

E：dc_dam_read関数で更新目的で入力するブロック数

F：Eに示すdc_dam_read関数を実行したあとに，dc_dam_write関数で出力するブロック数

G：Fに示すdc_dam_write関数を実行するまでに，Eに示したdc_dam_read関数で更新目的で入力したブロックに対して，dc_dam_rewrite関数を実行したブロック数

dc_dam_write関数だけ実行する場合の算出方法を次に示します。

表3‒10　dc_dam_write関数だけ実行する場合の算出方法

アクセス関数の実行順序

アクセスブロック数

D

E

F

G

算出値（E+F-G）

dc_dam_start関数

−

0

0

0

0

0

dc_dam_write関数

3

3

0

0

0

0

dc_dam_write関数

5

5

0

0

0

0

dc_dam_end関数

−

0

0

0

0

0

最終値

5

0

0

0

0

（凡例）

−：該当しません

この例では，Dが5となり，算出値（E+F-G）はDよりも小さい0になるため，dam_update_blockオペランドには5以上の値を指定してください。

dc_dam_read関数（更新目的）とdc_dam_write関数を実行した場合の算出方法を次に示します。

表3‒11　dc_dam_read関数（更新目的）とdc_dam_write関数を実行した場合の算出方法

アクセス関数の実行順序

アクセスブロック数

D

E

F

G

算出値（E+F-G）

dc_dam_start関数

−

0

0

0

0

0

dc_dam_read関数（更新目的）

3

3

3

0

0

3

dc_dam_write関数

5

5

0

5

0

8

dc_dam_end関数

−

0

0

0

0

0

最終値

5

3

5

0

8

（凡例）

−：該当しません

この例では，Dが5となり，算出値（E+F-G）がDよりも大きい8になるため，dam_update_blockオペランドには8以上の値を指定してください。

dc_dam_read関数（更新目的）実行前にdc_dam_write関数を実行した場合の算出方法を次に示します。

表3‒12　dc_dam_read関数（更新目的）実行前にdc_dam_write関数を実行した場合の算出方法

アクセス関数の実行順序

アクセスブロック数

D

E

F

G

算出値（E+F-G）

dc_dam_start関数

−

0

0

0

0

0

dc_dam_write関数

8

8

0

0

0

0

dc_dam_read関数（更新目的）

4

0

4

0

0

3

dc_dam_write関数

5

0

0

5

0

9

dc_dam_end関数

−

0

0

0

0

0

最終値

8

4

5

0

9

（凡例）

−：該当しません

この例では，Dが8となり，算出値（E+F-G）がDよりも大きい9になるため，dam_update_blockオペランドには9以上の値を指定してください。

dc_dam_read関数（更新目的）実行後，一部のブロックに対してdc_dam_rewrite関数を実行した場合の算出方法を次に示します。

表3‒13　dc_dam_read関数（更新目的）実行後，一部のブロックに対してdc_dam_rewrite関数を実行した場合の算出方法

アクセス関数の実行順序

アクセス

ブロック数

D

E

F

G

算出値（E+F-G）

dc_dam_start関数

−

0

0

0

0

0

dc_dam_read関数（更新目的）

4

4

4

0

0

4

dc_dam_rewrite関数

3

0

0

0

3

1

dc_dam_write関数

5

5

0

5

0

6

dc_dam_end関数

−

0

0

0

0

0

最終値

5

4

5

3

6

（凡例）

−：該当しません

この例では，Dが5となり，算出値（E+F-G）がDよりも大きい6になるため，dam_update_blockオペランドには6以上の値を指定してください。

更新するブロック数が最大ブロック数を超えた場合，アクセス関数（dc_dam_read関数，dc_dam_write関数，dc_dam_rewrite関数）は，DCDAMER_JNLOV※1またはDCDAMER_ACSOV※2でエラーリターンします。

注※1

COBOL-UAP作成用プログラムの場合は，ステータスコードに「01613」を設定します。

注※2

COBOL-UAP作成用プログラムの場合は，ステータスコードに「01648」を設定します。

●dam_added_file=オンライン中に追加する最大論理ファイル数

　〜〈符号なし整数〉((1〜128))《8》

オンライン中に追加する論理ファイルの最大値を指定します。

オンライン実行中には，指定した数まで論理ファイルを追加できます。

●dam_update_block_over=flush|error

　〜《error》

トランザクションの途中で更新するブロック数が，dam_update_blockオペランドで指定した最大ブロック数を超える場合に，アクセス関数をエラーリターンするかどうかを指定します。

flush

アクセス関数をエラーリターンしないで，処理を続行します。ただし，ブロックを更新（dc_dam_rewrite関数）しないで更新目的を入力（dc_dam_read関数）したブロックが最大ブロックに達している場合は，エラーリターンします。

flushを指定した場合の注意を次に示します。

最大ブロック数を超えたときに，一時的にDAMファイルへ出力します。このため，アクセス関数の処理時間が増加します。

DAMファイルを一時的に更新するため，当該トランザクションがロールバックした場合，一時的な更新を無効にする必要があります。このため，一時的な出力をする直前のブロック情報をDAMの回復用ジャーナル（FJ）に取得します。これによって，取得するジャーナルの量が多くなります。

回復用ジャーナル（FJ）に一時的な出力をする直前のブロック情報を設定するため，dc_dam_write関数に指定したブロックの入力が起こります。ただし，dc_dam_write関数に指定したブロックが，すでにDAMサービス用共用メモリに存在する場合，ブロックの入力は起こりません。

error

アクセス関数をエラーリターンします。

●dam_message_level=1|0

　〜《1》

DAMサービスが出力するメッセージのレベルを指定します。

0

すべてのメッセージを出力します。

1

排他エラーのメッセージ（KFCA01610-W）を出力しません。

●dam_tran_process_count=同時に実行するトランザクションブランチの数

　〜〈符号なし整数〉((0〜8192))

DAMファイルにアクセスするトランザクションブランチを同時に実行する数を指定します。ここで指定した数に合わせて領域が確保されます。

1以上を指定した場合

オンラインシステムを開始するときに，指定した数の領域を確保します。指定した数の領域を確保できない場合は，確保できた領域だけでオンラインシステムを開始します。

確保した領域は，オンラインシステムが終了すると解放されます。

0を指定した場合

トランザクションを実行するときに領域を確保します。

確保した領域は，トランザクションが決着すると解放されます。

定義を省略した場合

UAPを起動するときに領域を確保します。

確保した領域は，UAPが終了すると解放されます。

0を指定した場合や領域が足りなくなった場合は，トランザクションを実行するときに領域を確保するため，処理が遅くなります。

なお，この指定値を大きくすると，共用メモリを圧迫します。使用できるメモリの容量を考えて指定してください。

●dam_cache_size｜dam_cache_size_fix=バッファ領域長

　〜〈符号なし整数〉((10〜1000000))（単位：キロバイト）

システム起動時にオンラインで参照・更新したブロックをスタックしておくためのバッファ領域の大きさを，dam_cache_sizeオペランドまたはdam_cache_size_fixオペランドに指定します。dam_cache_size_fixオペランドの指定は，dam_cache_sizeオペランドの指定より優先されます。

dam_cache_sizeを指定する場合は，次の「バッファ領域長の仮定値計算式」で示す値より大きい値を指定します。

バッファ領域長の仮定値計算式

バッファ領域長 = A＋B

A：（Mb／64＋1）×128×n×Tr

B：｛↓（A／576）↓｝×32＋64

Mb：次のどちらか大きい値に8を加えた値

DAMサービス定義で定義した論理ファイルの中で，最大のブロック長を持つファイルのブロック長（damloadコマンド，dc_dam_create関数に指定したブロック長）

DAMサービス定義のdam_max_block_sizeオペランドで指定した最大ブロック長

ｎ：DAMサービス定義のdam_update_blockオペランドで指定した最大更新ブロック数

Tr：DAMサービス定義のdam_tran_process_countオペランドで指定したトランザクションブランチ数

↓↓：小数点以下を切り捨てます。

注

DAMサービス定義のdamfile定義コマンドに-fオプションを指定して，キャッシュレスアクセスのDAMファイルを使用する場合は，Mbに次のどちらか大きい値に8を加えた値を指定してバッファ領域長を計算し，その算出値をdam_cache_size_fixオペランドに指定してください。

DAMサービス定義で定義したキャッシュレスアクセスではない論理ファイルの中で，最大のブロック長を持つファイルのブロック長（damloadコマンド，dc_dam_create関数に指定したブロック長）

DAMサービス定義のdam_max_block_sizeオペランドの指定値

すべてのDAMファイルをキャッシュレスアクセスとして指定する場合は，dam_cache_size_fixオペランドに10を指定してください。

dam_tran_process_countオペランドに0を指定した場合は，同時に実行するトランザクションブランチの数として「8」を仮定して計算します。dam_tran_process_countオペランドの指定を省略した場合は，同時に実行するトランザクションブランチの数としてトランザクションサービス定義のtrn_tran_process_countオペランドの指定値で計算します。

dam_cache_sizeオペランドを省略した場合や，DAMサービスが「バッファ領域長の仮定値計算式」を基に自動的に算出した値より小さい値を指定した場合は，DAMサービスが算出した値でバッファ領域を確保します。

「バッファ領域長の仮定値計算式」で求める値は，DAMサービス定義に指定した各オペランドを基に，最も大きいバッファ領域サイズを算出します。したがって，「バッファ領域長の仮定値計算式」で算出した値ではバッファを確保できない場合があります。その場合，DAMサービス内部でバッファ領域が確保できるまで，確保する値を1/2にしながら確保処理を実行します。

dam_cache_sizeオペランドおよびdam_cache_size_fixオペランドの指定値が指定範囲内でない場合には，ともにKFCA01644-Iメッセージが出力されます。

容量不足のためdam_cache_sizeオペランドおよびdam_cache_size_fixオペランドの指定値でバッファ領域を確保できない場合には，ともにKFCA01648-Eメッセージが出力されDAMサービスやUAPがダウンします。

なお，ディファード更新処理指定のDAMファイルを指定している場合は，仮定値計算式で算出したバッファ領域長の値に加えて次の見積もり式に示す容量が必要です。

見積もり式

実行間隔時間内※に実行され遅延書き込み処理に滞留するトランザクション数×おのおののトランザクションで更新されるDAMファイルのブロック長の総和

注※

DAMサービス定義のdam_io_intervalオペランドに指定した実行間隔時間

次に，dam_cache_sizeオペランドとdam_cache_size_fixオペランドの違いについて説明します。

dam_cache_sizeを指定した場合

dam_cache_sizeを指定した場合，dam_cache_sizeの指定値，または前述の「バッファ領域長の仮定値計算式」の値のどちらか大きい方の値が採用されます。dam_cache_sizeオペランドの指定を省略した場合，およびdam_cache_sizeオペランドの指定値が指定範囲内でない場合は，KFCA02530-Iメッセージが出力され仮定値計算式の値が採用されます。dam_cache_size_fixオペランドを指定した場合は，優先的にdam_cache_size_fixオペランドの指定値が採用されます。

dam_cache_size_fixを指定した場合

優先的にdam_cache_size_fixオペランドの指定値を採用します。dam_cache_size_fixオペランドの指定を省略した場合，およびdam_cache_size_fixオペランドの指定値が指定範囲内でない場合は，dam_cache_sizeオペランドが指定されていればそれを採用し，指定されていなければKFCA02530-Iメッセージを出力して仮定値計算式の値を採用します。

dam_cache_size_fixを指定することの利点

dam_cache_sizeオペランドに指定する値や，「バッファ領域長の仮定値計算式」で算出される値は，次の値を基に算出します。

DAMサービス定義に指定したDAMファイルの最大ブロック長(damfile定義コマンドで指定したファイルの最大ブロック長)

同時実行トランザクション数(dam_tran_process_countオペランド指定値)

トランザクション内で更新する最大ブロック数(dam_update_blockオペランド指定値)

計算式では，上記の各値を掛け合わせることで求めています。つまり，最大ブロック長を持つDAMファイルが一つのトランザクションで1ブロックだけ更新される場合でも，上記計算式を用いて算出するため，十分に動作できるバッファサイズよりもさらに大きい値でバッファを確保することになります。

このような場合，最適なバッファ領域長をdam_cache_size_fixオペランドに指定することで，最適なバッファを確保できます。ただし，dam_cache_size_fixオペランドを使用する場合は，その指定値に十分注意してください。dam_cache_size_fixオペランドに指定した値が，実際に必要となるバッファ長より小さかった場合，オンライン処理中にバッファ領域不足が発生し，処理が続行できなくなります。また，使用するDAMファイルのうち，ディファード更新指定ファイルがある場合，実行間隔時間(dam_io_intervalオペランドの指定値)内に滞留する量(滞留するブロック数とそのブロック長の総和)も考慮して，バッファ領域長を見積もる必要があります。

dam_cache_sizeオペランドおよびdam_cache_size_fixオペランドの相互指定関係での採用値について次の表に示します。

dam_cache_size_fixの指定

dam_cache_sizeの指定

指定が正しい場合

指定を省略した場合

指定を誤った場合（KFCA01644-I出力）

指定が正しい場合

（2）

（2）

（2）

指定を省略した場合

（1）

（3）

（3）

指定を誤った場合（KFCA01644-I出力）

（1）

（3）

（3）

（凡例）

（1）：dam_cache_sizeへの指定値を採用

（2）：dam_cache_size_fixへの指定値を採用

（3）：仮定値計算式の値を採用，かつ，KFCA02530-Iメッセージ出力

バッファ領域不足が発生し処理が続行できなくなった場合，アボートコードが出力されるので，アボートコードに対する対策方法に従ってください。アボートコードについては，マニュアル「OpenTP1 メッセージ」を参照してください。

なお，DAMファイルの構成を変更するなど，システムの定義および環境を変更する場合にも，再度指定値を見直してください。

リソースマネジャ用共用メモリの所要量は，dam_cache_size_fixオペランドで指定したキャッシュサイズになります。

●dam_cache_attribute=free|fixed|hugepage

　〜《free》

共用メモリに確保したバッファ領域の属性を指定します。このオペランドを指定する場合は，実装するメモリの容量や，全使用量に対するバッファ領域の割合などを考慮してください。この指定値は，ディファード更新機能に関係なく指定してください。

free

バッファ領域をメモリ上に固定しません。実装する実メモリの容量が少ない場合，共用メモリのページングが発生して処理速度が低下することがあります。

fixed

バッファ領域をメモリ上に固定します。共用メモリのページングによって処理速度が低下することはありません。ただし，実装するメモリの容量が少ない場合，共用メモリ以外（テキストやデータセグメントなど）でページングが発生することがあります。

fixedは，OSがHP-UXまたはSolarisの場合だけ指定できます。なお，Solarisの場合，ご使用の環境によってはfixedを指定できないことがあります。詳細については，「リリースノート」を参照してください。

hugepage

バッファ領域をLinuxのHugepage機能を適用して，OS管理領域のメモリ使用効率を向上します。

これによって，バッファ領域を使用するプロセス数増加時にメモリ消費量を軽減できる場合があります。

この指定値は，Linux版の64ビット版の場合だけ指定できます。

＜事前設定＞

この機能はLinuxのHugepage機能を使っているため，OpenTP1を起動する前に，LinuxのHugepage機能を有効にしておく必要があります。Hugepage機能については，OSのマニュアルを参照してください。Hugepage機能を有効にするときに設定するOSのカーネルパラメタの詳細については，マニュアル「OpenTP1 運用と操作」のHugepage機能の適用（Linux限定）の説明を参照してください。

また，プロセスサービス定義のprc_hugepage_group_idオペランドに，カーネルパラメタのvm.hugetlb_shm_groupに指定したグループIDを指定してください。

＜注意事項＞

この指定を行った場合の注意事項を次に示します。

バッファ領域がメモリ上に固定されます。

確保するバッファ領域の大きさがページサイズ※の大きさに切り上げられます。

OSの設定によっては，coreファイルにHugepage機能を適用したバッファ領域が含まれません。coreファイルにバッファ領域を含める場合は，次のどれかを変更する必要があります。

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

・ユーザサービスデフォルト定義のprc_coredump_filterオペランド

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

注※

ページサイズは，「grep Hugepagesize /proc/meminfo」を実行して確認できます。ページサイズを確認する際は単位に注意してください。

＜指定の目安＞

バッファ領域がメモリ上に固定化された場合に，次のどちらにも該当しない場合は，この指定を推奨します。

残りの物理メモリの容量で他プロセスを含む固定化されないメモリのページングが頻繁に発生する

システム性能に影響する

●dam_io_interval=実行間隔時間

　〜〈符号なし整数〉((1〜60))《1》（単位：秒）

ディファード更新機能を使用するとき，出力専用プロセスを実行する間隔を指定します。この指定値は，ディファード更新機能を使用しないときは，指定する必要はありません。

出力専用プロセスの実行間隔を大きくし過ぎるとバッファ領域不足が発生し，ほかのトランザクションで更新または出力しようとしたブロックの書き込みができなくなって，メモリ不足でUAPがダウンすることがあります。この値は動作するトランザクションがピークに達した場合を想定したときの実行間隔時間内に終了するトランザクションの数と各トランザクションで更新，および出力するブロック数（バッファ所要量）で決めてください。

●dam_transaction_access=global|branch

　〜《branch》

DAMファイルのデータ管理および排他管理をするトランザクションの単位を指定します。

global

グローバルトランザクション単位で，ファイルデータ管理および排他管理をします。globalを指定すると，論理ファイルのオープン時にファイル排他を指定できません。

branch

トランザクションブランチ単位で，ファイルデータ管理および排他管理をします。

トランザクションブランチが異なれば，同一グローバルトランザクションでもアクセスはエラーとなります。

●dam_io_error_occur=stop|continue

　〜《continue》

ディスク更新時にディスク障害（入出力エラー）が発生した場合のDAMサービスの処置を指定します。

DAMサービスでは，トランザクションの同期点処理時にディスク更新をします。または，トランザクションの途中更新機能を使用している場合のDAMサービスアクセス関数の延長で，ディスク更新をします。ここでは，ディスク更新時に障害が発生した場合のDAMサービスの処置を指定します。

ディファード更新時および回復対象外ファイル更新時の，ディスク障害が発生した場合の処置については，指定値による違いはありません。ディファード更新時にディスク障害が発生した場合は，KFCA01646-E，KFCA01642-Iのメッセージを出力して障害ファイル以外のファイルについて処理を続行します。回復対象外ファイル更新時にディスク障害が発生した場合は，KFCA01646-E，KFCA01642-Iのメッセージを出力してdc_dam_rewrite関数，dc_dam_write関数がDCDAMER_IOERをリターンします。

stop

DAMアクセスを行っているUAPを異常終了します。このとき，クリティカル状態であるため，システムを停止します。KFCA01622-EまたはKFCA01646-Eのメッセージで示される障害が起きたファイルに対して，障害要因を取り除くかまたは新しい別のボリュームを割り当て，damfrcコマンドを実行してファイルを回復させてください。

ファイルの回復手順を次に示します。

damfrcコマンドの実行

OpenTP1の再開始を行う前に，必ずバックアップしてあったデータをdamrstrコマンドでリストアし，damfrcコマンドを実行してください。システムダウン時点までのジャーナル情報を基にファイルを回復します。

OpenTP1の再開始

OpenTP1を再開始します。

ファイルの閉塞解除

OpenTP1を再開始しても，障害が起きたファイルは障害閉塞状態になっています。そのため，damrlesコマンドを実行して閉塞を解除してください。

トランザクションの決着

damrlesコマンド実行後，ファイルへのアクセスが可能となり，OpenTP1ではトランザクションの回復(決着)処理が行われ，そこでトランザクションが完了し，データの整合性が取られます。

なお，damrlesコマンドが実行されるまでは，KFCA01623-E（ファイル切り離し中）またはKFCA01624-E（ファイル閉塞中）のメッセージが出力され続け，トランザクションの回復ができない理由をユーザに知らせます。

continue

ディスク障害の発生がDAMアクセス中の場合，KFCA01618-E，KFCA01622-E，およびKFCA01642-Iのメッセージを出力後，UAPを異常終了させます。

また，トランザクションの同期点処理中の場合は，KFCA01622-EおよびKFCA01642-Iのメッセージを出力したあと，トランザクションを完了させます（コミット決着：OpenTP1ログ上は正常に終了し，関数のリターン値もDC_OKに見えます）。この場合，トランザクションは正常に完了していますが，障害の起きたファイルはトランザクションで更新したデータが反映されていません。

このため，業務処理を続行するとデータの不整合となりますので，必ず，障害の起きたファイルをいったんオンラインから切り離し，damrstrコマンド，およびdamfrcコマンドによる論理的なファイル回復を行い，回復したファイルをdamaddコマンドで追加後，damrlesコマンドで閉塞を解除してください。ファイルの切り離し，回復，追加をする場合には，UAPを停止させてください。

●dam_cache_reuse_from=last｜first

　〜《last》

DAMファイルをアクセスするトランザクションで，新たにキャッシュブロック用領域が必要となった場合，どのブロックから優先的に再利用対象として検索するかを指定します。なお，DAMサービスではブロックを新しく更新し，参照用キャッシュチェインにつなぐ場合，参照用キャッシュチェインの先頭につないでいます。

last

再利用するキャッシュブロックを，DAMサービス内部で管理している参照用キャッシュチェインの後ろにあるキャッシュブロックから優先して検索します。lastを指定すると，最も古く参照用キャッシュチェインにつながれたキャッシュブロックが再利用されます。

first

再利用するキャッシュブロックを，DAMサービス内部で管理している参照用キャッシュチェインの先頭にあるキャッシュブロックから優先して検索します。firstを指定すると，最も新しくキャッシュチェインにつながれたキャッシュブロックが再利用されます。

lastを指定した場合でも，キャッシュブロックの検索のタイミングでトランザクションによってアクセスされているキャッシュブロックは，再利用対象外として扱われます。したがって，その次に古いキャッシュブロックが再利用対象として検索されます。また，最も古くからキャッシュチェインに残っているかどうかを判断していて，LRU方式のように最近アクセスされたもののチェインの並べ替えはしていません。あくまで，アクセスされ，キャッシュチェインにつながれた時期が古いものから検索されます。

●dam_default_cache_num=キャッシュブロック再利用境界デフォルト値

　〜〈符号なし整数〉((0〜4000000))《0》

キャッシュブロック再利用処理の境界値のデフォルト値を指定します。このオペランドに指定した値が，damcache定義コマンドでキャッシュブロック再利用境界値を指定しなかった場合の論理ファイルの境界値となります。

●dam_ex_refer_read=none｜stay

　〜《none》

DAMファイルをアクセスするトランザクションで，排他あり参照指定で読み込むブロックを，トランザクション決着までキャッシュバッファ領域上に残すかどうかを指定します。

このオペランドを使用する場合，次のことに注意してください。

DAMサービス定義のdam_update_blockオペランド（一つのトランザクションで更新できるブロック数）には，排他あり参照readを実行するブロック数を加算してください。

トランザクションの途中更新機能を使用している場合，この機能を使用した排他あり参照目的の入力後に，更新目的の入力をし，ブロックの更新（dc_dam_rewrite関数）を実行すると，トランザクションの途中で更新ブロックのデータ実更新が発生することがあります。更新ブロックのデータ実更新が発生した場合は，トランザクション決着時までキャッシュバッファ領域上に必ず残すとは保証されません。更新しないキャッシュブロックについてはトランザクション決着時まで残ります。

排他あり参照目的の入力は，トランザクション決着まで排他を解放することはできません。

none

排他あり参照指定で入力したキャッシュブロックは，ユーザプログラムにデータを返却したあと，再利用可能なブロックとして扱います。ただし，キャッシュバッファ領域に余裕がある場合，すぐに再利用されることはありません。キャッシュバッファ領域の空き領域が少なくなった場合に再利用される可能性があります。

次のような場合は，noneを指定してください。

アクセスするDAMブロックに特定性がない場合

stay

排他あり参照指定で入力したキャッシュブロックでも，更新指定のときと同じようにトランザクション決着時までキャッシュバッファ領域上に残します。

次のような場合にstayを指定し，排他あり参照readを実行すると，キャッシュヒット率が向上しやすくなります。

特定のDAMブロックに対して，頻繁に排他あり参照readを実行する場合

なお，stayを指定した場合，次のことに注意してください。

DAMサービス定義に指定したdam_update_blockオペランドに，排他あり参照目的の入力を実行するブロック数を加算する必要があります。また，dam_update_blockオペランドの値を加算して，OpenTP1の動的共用メモリサイズを大きくする必要があります。

dam_update_blockオペランドの値を加算しなかった場合，次のような影響があります。

トランザクションの途中更新機能を使用している場合

一つのトランザクション内で，排他あり参照目的の入力，更新目的の入力，ブロックの更新(dc_dam_write関数)を実行したブロック数の合計が，dam_update_blockオペランドの指定値を超えると，途中更新処理が実行され，データ実更新が発生します。したがって，排他あり参照目的の入力ブロック数が多い場合，途中更新処理を実行する回数が多くなり，その結果，データの実更新が頻繁に発生します。

DAMサービス定義のdam_update_block_overオペランドにerrorを指定している場合

一つのトランザクション内で，排他あり参照目的の入力，更新目的の入力，ブロックの更新(dc_dam_write())を実行したブロック数の合計が，dam_update_blockオペランドの指定値を超えると，そのときに実行したAPIがDCDAMER_JNLOVでエラーリターンします。したがって，排他あり参照目的の入力ブロック数が多い場合，DCDAMER_JNLOVでエラーリターンする回数が多くなります。

●dam_max_block_size=最大ブロック長

　〜〈符号なし整数〉((504〜32760))※《504》（単位：バイト）

注※

セクタ長×n−8を満たす値を指定してください（nは正の整数）。

セクタ長は次のとおりです。

キャラクタ型スペシャルファイルの場合：filmkfsコマンドの-sオプション指定値

通常ファイルの場合：512バイト

システム内のDAMファイルの最大ブロック長を指定します。ただし，条件によって，指定値と異なる値が最大ブロック長に採用されることがあります。条件と採用される最大ブロック長の関係を次の表に示します。

dam_max_block_sizeオペランド

damfile定義コマンド

指定あり

指定なし

指定が正しい場合

aまたはbのうち，大きい値を採用

aの値を採用

指定を省略した場合

bの値を採用

504を仮定

指定を誤った場合

（504〜32760の範囲外）

bの値を採用※1

504を仮定※1

指定を誤った場合

（セクタ長×n-8以外（nは正の整数））

bの値を採用※2

504を仮定※2

（凡例）

a：DAMサービス定義のdam_max_block_sizeオペランドの値

b：DAMサービス定義に定義されている論理ファイルの中で最大ブロック長を持つファイルのブロック長

注※1

KFCA00216-EおよびKFCA01644-Iを出力します。

注※2

KFCA02565-Iを出力します。

●dam_kb_size=1000|1024

　〜《1000》

DAMサービス用共用メモリとして確保されるバッファ領域のサイズをDAMサービス定義（$DCDIR/conf/dam）のdam_cache_sizeオペランド（単位：キロバイト）に指定した場合，自動的にバイト換算されます。そのときに，1キロバイト当たり1,000バイトで換算するか，1,024バイトで換算するかを指定します。

1000

1キロバイト当たり1,000バイトで換算します。

1024

1キロバイト当たり1,024バイトで換算します。

●watch_time=最大応答待ち時間

　〜〈符号なし整数〉((0〜65535))（単位：秒）

RPCによってプロセス間で通信する場合，サービス要求を送信してからサービスの応答が返るまでの待ち時間の最大値を指定します。

OpenTP1の終了処理で，このオペランドで指定した時間だけ終了処理を待ち合わせる場合があります。したがって，大きな値を指定した場合，OpenTP1の終了処理に時間が掛かる場合があります。

指定時間を過ぎても応答がない場合は，RPCは送受信タイムアウトとしてエラーリターンします。

0を指定した場合は，応答を受信するまで待ち続けます。0を指定した場合，OpenTP1が終了しない場合があります。

省略した場合は，システム共通定義のwatch_timeオペランドの値を仮定します。

このオペランドは，システム共通定義のwatch_timeオペランドのデフォルト値で使用してください。

特別なチューニングを必要とする場合以外は，このオペランドの内容を変更しないことをお勧めします。

システム共通定義のwatch_timeオペランドのデフォルト値よりも，極端に小さな値または大きな値を指定すると，OpenTP1ダウンに至る障害が発生する場合がありますので，ご注意ください。

コマンド形式

次ページ以降に記述しています。

damcache

名称

キャッシュブロックの再利用境界値の指定

形式

〔damcache 論理ファイル名 キャッシュブロック再利用境界値〕

機能

DAMファイルのための共用メモリが不足したとき，DAMファイルのキャッシュブロックのうち，未使用状態のキャッシュブロックを再利用するときの，再利用境界値を指定します。

コマンド引数

●論理ファイル名

　〜〈1〜8文字の識別子〉

キャッシュブロック再利用処理の境界値を有効とする論理ファイル名を指定します。ここで指定する論理ファイル名は，あらかじめdamfile定義コマンドで定義しておく必要があります。

●キャッシュブロック再利用境界値

　〜〈符号なし整数〉((0〜4000000))

キャッシュブロック再利用処理の境界値を指定します。キャッシュブロック再利用境界値の指定を省略した場合は，DAMサービス定義のdam_default_cache_numオペランドに指定された値をデフォルト値とします。

ここで指定するキャッシュブロック再利用境界値に達していない間は，アクセスするDAMファイルではなく，ほかのDAMファイルのキャッシュブロックを優先して再利用します。キャッシュブロック数が再利用境界値を超えた場合は，アクセスするDAMファイルのキャッシュブロックから再利用します。0を指定した場合は，従来の処理と同じように，アクセスするDAMファイルのキャッシュブロックチェインにつながっているキャッシュブロックから再利用します。

注意事項

damcache定義コマンドは，damfile定義コマンドで定義した論理ファイルに対して有効です。そのため，damcache定義コマンドの指定前に，あらかじめdamfile定義コマンドで対象となる論理ファイル名を定義する必要があります。damfile定義コマンドで対象となる論理ファイルを指定する前にキャッシュブロック再利用境界値を指定しても，値は有効となりません。

damcache定義コマンドでキャッシュブロック再利用境界値を指定しなかった論理ファイルのキャッシュブロック再利用境界値は，dam_default_cache_numオペランドで指定した値が採用されます。

一つの論理ファイル名に対して，damcache定義コマンドを複数回指定した場合は，動作は保証されません。

damchlmt

名称

キャッシュブロック数のしきい値の指定

形式

〔damchlmt 論理ファイル名 キャッシュブロック数のしきい値〕

機能

一つのDAMファイルで管理するキャッシュブロック数の上限を指定します。

コマンド引数

●論理ファイル名

　〜〈1〜8文字の識別子〉

キャッシュブロック数のしきい値を有効とする論理ファイル名を指定します。ここで指定する論理ファイル名は，あらかじめdamfile定義コマンドで定義しておく必要があります。

●キャッシュブロック数のしきい値

　〜〈符号なし整数〉((0〜4000000))

指定した論理ファイルが管理する，キャッシュブロック数のしきい値を指定します。この指定を省略した場合は，共用メモリ資源がなくなるまでキャッシュブロックを確保します。

注意事項

このコマンドは，damfile定義コマンドで定義した論理ファイルに対して有効です。そのため，このコマンドの指定前に，あらかじめdamfile定義コマンドで対象となる論理ファイル名を定義しておく必要があります。damfile定義コマンドで対象となる論理ファイルを指定する前に，このコマンドでキャッシュブロック数のしきい値を指定しても，その値は有効になりません。

一つの論理ファイル名に対して，このコマンドを複数回指定した場合，動作は保証されません。

damfile

名称

論理ファイルの指定

形式

{{damfile  〔-{d|n〔-f〕}〕〔-c〕論理ファイル名  物理ファイル名}}

機能

オンライン中にDAMサービスを使用してアクセスするファイルを論理ファイル名と物理ファイル名の対で指定します。

DAMサービスは，指定された論理ファイル名によってアクセスを制御します。

オプション

●-d

指定されたファイルをディファード更新処理します。

省略した場合は，ディファード更新処理しません（同期点でDAMファイルを実更新します）。

ディファード更新指定のDAMファイルと通常更新のDAMファイルを，一つのトランザクションから更新出力した場合には，どちらのDAMファイルも同期点で実更新します。

●-n

指定されたファイルを回復対象外ファイルとして処理する場合に指定します。

●-f

指定されたファイルをキャッシュレスアクセスとして処理する場合に指定します。このオプションは，必ず-nオプションと同時に指定してください。

●-c

指定されたDAMファイルに障害が発生しても，DAMサービスの正常開始処理を続行する場合に指定します。ただし，正常開始処理を続行できない場合は，DAMサービスの正常開始処理を終了します。DAMサービス開始後，このDAMファイルは障害閉塞状態になります。dc_dam_open関数でアクセスした場合，DCDAMER_OHOLDでエラーリターンします。障害が発生したDAMファイルをUAPで使用する場合は，いったん，damrmコマンドでオンラインから切り離したあと，障害要因を取り除き，再度，damaddコマンドでオンラインに登録してください。

コマンド引数

●論理ファイル名

　〜〈1〜8文字の識別子〉

論理ファイル名を指定します。

●物理ファイル名

　〜〈1〜63文字のパス名〉

論理ファイル名に対応する物理ファイル名を絶対パス名で指定します。ただし，環境変数は使用できません。

注意事項

DAMサービスでは，次の二つの値を比較して，大きい方の値をDAMファイルの最大ブロック長とします。

damfile定義コマンドで定義されている論理ファイルの中で，最大のブロック長を持つファイルのブロック長の値

dam_max_block_sizeオペランドに指定した値

damfile定義コマンドで論理ファイルが定義されていなく，かつ，dam_max_block_sizeオペランドが指定されていない場合は，DAMファイルの最大ブロック長は，504バイトになります。

DAMサービスでは，OpenTP1システムでのDAMファイルの最大ブロック長を，DAMサービス定義にdamfile定義コマンドで定義されている論理ファイルの中で，最大のブロック長を持つファイルのブロック長としています。DAMサービス定義に論理ファイルがまったく定義されていない場合は，最大ブロック長は504バイトになります。

-fオプションを指定した場合，DAMサービス専用共用メモリのDAMファイルデータ領域を使用しないで，必ずファイルのI/Oを実行します。したがって，システムがオンラインの間にアクセスするDAMファイルのブロック数によっては，性能が低下することがあります。また，オンラインで使用するDAMファイルがすべてキャッシュレスアクセス指定の場合，dam_cache_size_fixオペランドで10を指定すると，最小限のDAMキャッシュメモリでシステムを開始できます。この場合の注意事項については，dam_cache_size_fixオペランドを参照してください。

damfile定義コマンドの指定数とdam_added_fileオペランドに指定した値の合計が3600を超える場合，DAMサービスが起動できないことがあります。

TAMサービス定義

形式

set形式

  set tam_max_tblnum=オンライン中に使用するTAMテーブルの最大数
  set tam_max_filesize=オンライン中に使用するTAMテーブルの最大容量
  set tam_max_recsize=TAMテーブルの最大レコード長
〔set tam_jnl_err_flag=STOP|CONTINUE〕
〔set tam_pool_attri=fixed|free|hugepage〕
〔set tam_tbl_lock_mode=LOCK|NOLOCK〕
〔set tam_cbl_level=COBOL APIの排他レベル〕
〔set tam_max_trnnum=同時走行最大トランザクションブランチ数〕
〔set tam_max_trnfilnum=トランザクション内最大アクセステーブル数〕
〔set watch_time=最大応答待ち時間〕

コマンド形式

{{tamtable  〔-o  ローディング契機〕〔-a  アクセス形態〕〔-i〕〔-j〕
              TAMテーブル名  物理ファイル名}}

機能

TAMテーブルを管理するための実行環境を定義します。

説明

set形式のオペランド

●tam_max_tblnum=オンライン中に使用するTAMテーブルの最大数

　〜〈符号なし整数〉((1〜65535))

オンライン中に使用するTAMテーブルの最大数を指定します。オンライン中は，ここで指定した数までテーブルを追加できます。

tamtable定義コマンドで指定したTAMテーブル数に，tamaddコマンドでオンライン中に動的に追加するTAMテーブル数を加算したものを，ここで指定します。

●tam_max_filesize=オンライン中に使用するTAMテーブルの最大容量

　〜〈符号なし整数〉((136〜1000000000))（単位：バイト）

オンライン中に使用するTAMテーブルの中で，最大のTAMテーブルサイズ※を指定します。

tamtable定義コマンドで指定したTAMテーブルだけでなく，tamaddコマンドでオンライン中に動的に追加するTAMテーブルのサイズも含めて，それらの中で最大の値を指定してください。

なお，初期データがある状態でtamcreコマンドに-uオプションを指定し，かつ-xオプションを指定しないで実行してTAMファイルを作成した場合，シノニム領域の最適化によって見積もり式から算出されたTAMテーブルの容量よりも実際に作成されるTAMテーブルの最大容量が小さくなります。ただし，この削減量は事前に見積もることができないため，tam_max_filesizeオペランドには，見積もり式から算出されたTAMテーブルの容量の最大値以上の値を指定して下さい。

TAMの共用メモリ量を削減したいなどで，tam_max_filesizeオペランドの指定値を実際の値に近づけたい場合はfillsコマンドの結果から作成されたTAMテーブルの容量をレコード長×レコード数で確認し，TAMテーブルの容量の最大値以上の値を指定して下さい。

注※

TAMテーブルのサイズについては，マニュアル「OpenTP1 運用と操作」にある，TAMファイルのサイズの見積もり式の説明を参照してください。

●tam_max_recsize=TAMテーブルの最大レコード長

　〜〈符号なし整数〉((1〜1000000000))（単位：バイト）

オンライン中に使用するTAMテーブルの最大レコード長を指定します。

●tam_jnl_err_flag=STOP|CONTINUE

　〜《STOP》

TAMサービスの再開始時にジャーナルの読み込み障害が発生した場合，TAMサービスを停止するかどうかを指定します。

STOP

TAMサービスを停止します。

CONTINUE

TAMテーブルをすべて閉塞状態にしてTAMサービスを開始します。

●tam_pool_attri=fixed|free|hugepage

　〜《HP-UXまたはSolarisの場合：fixed　AIX，LinuxまたはWindowsの場合：free》

共用メモリにTAMサービス専用のメモリプールを指定します。TAMサービスのメモリプールは，TAMテーブルのロードや，アクセスするテーブルの管理などに使用されます。

このオペランドを指定する場合には，実装するメモリの容量や，全使用容量に対する共用メモリプールの割合などを考慮してください。

fixed

TAMサービス用メモリプールを固定します。

共用メモリのページングによって処理速度が低下することはありません。ただし，実装するメモリの容量が少ない場合，共用メモリ以外（テキストやデータセグメントなど）でページングが発生することがあります。

fixedは，OSがHP-UXまたはSolarisの場合だけ指定できます。なお，Solarisの場合，ご使用の環境によってはfixedを指定できないことがあります。詳細については，「リリースノート」を参照してください。

free

TAMサービス用メモリプールを固定しません。

実装するメモリの容量が少ない場合，共用メモリのページングが発生して処理速度が低下することがあります。

hugepage

TAMサービス用メモリプールにLinuxのHugepage機能を適用して，OS管理領域のメモリ使用効率を向上します。

これによって，TAMサービス用メモリプールを使用するプロセス数増加時にメモリ消費量を軽減できる場合があります。

この指定値は，Linux版の64ビット版の場合だけ指定できます。

＜事前設定＞

この機能はLinuxのHugepage機能を使っているため，OpenTP1を起動する前に，LinuxのHugepage機能を有効にしておく必要があります。Hugepage機能については，OSのマニュアルを参照してください。Hugepage機能を有効にするときに設定するOSのカーネルパラメタの詳細については，マニュアル「OpenTP1 運用と操作」のHugepage機能の適用（Linux限定）の説明を参照してください。

また，プロセスサービス定義のprc_hugepage_group_idオペランドに，カーネルパラメタのvm.hugetlb_shm_groupに指定したグループIDを指定してください。

＜注意事項＞

この指定をした場合の注意事項を次に示します。

TAMサービス用メモリプールがメモリ上に固定されます。

確保するTAMサービス用メモリプールの大きさがページサイズ※の大きさに切り上げられます。

OSの設定によっては，coreファイルにHugepage機能を適用したTAMサービス用メモリプールが含まれません。coreファイルにTAMサービス用メモリプールを含める場合は，次のどれかを変更する必要があります。

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

・ユーザサービスデフォルト定義のprc_coredump_filterオペランド

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

注※

ページサイズは，「grep Hugepagesize /proc/meminfo」を実行して確認できます。ページサイズを確認する際は単位に注意してください。

＜指定の目安＞

TAMサービス用共用メモリプールが実メモリ上に固定化された場合に，次のどちらにも該当しない場合は，この指定を推奨します。

残りの物理メモリの容量で他プロセスを含む固定化されないメモリのページングが頻繁に発生する

システム性能に影響する

●tam_tbl_lock_mode=LOCK|NOLOCK

　〜《LOCK》

TAMテーブルアクセス形態が’参照型’または’追加・削除できない更新型’のテーブルのテーブル排他モードを指定します。

LOCK

アクセス時のテーブルを排他します。

NOLOCK

アクセス時のテーブルを排他しません。

この指定をした場合は，アクセス時の性能は向上します。また，UAPで排他する指定をしても，テーブル排他はしません。

●tam_cbl_level=COBOL APIの排他レベル

　〜〈符号なし整数〉((0〜2))《0》

COBOL APIの排他が競合した場合の，排他レベルを指定します。

なお，この指定はCOBOL APIだけに有効です。

0

無条件に排他が解除されるのを待ちます。

COBOL APIのデータ名Iの指定は無効になります。

1

排他が解除されるのを待たないで，エラーリターンします。

COBOL APIのデータ名Iの指定は無効になります。

2

COBOL APIのデータ名Iの排他解除の指定に従います。

●tam_max_trnnum=同時走行最大トランザクションブランチ数

　〜〈符号なし整数〉((1〜8192))《20》

TAMテーブルをアクセスするトランザクションブランチの同時走行数を指定します。

この指定値が大きいと，TAMサーバの共用メモリも大きくなります。共用メモリが確保できない場合はTAMサーバを開始できない場合があります。また，指定値が小さいと，API関数でメモリ不足が発生する場合があります。

●tam_max_trnfilnum=トランザクション内最大アクセステーブル数

　〜〈符号なし整数〉((1〜1024))《5》

1トランザクションブランチでアクセスする最大TAMテーブル数を指定します。

この指定値が大きいと，TAMサーバの共用メモリも大きくなります。共用メモリが確保できない場合はTAMサーバを開始できない場合があります。また，指定値が小さいと，API関数でメモリ不足が発生する場合があります。

●watch_time=最大応答待ち時間

　〜〈符号なし整数〉((0〜65535))（単位：秒）

RPCによってプロセス間で通信する場合，サービス要求を送信してからサービスの応答が返るまでの待ち時間の最大値を指定します。

OpenTP1の終了処理で，このオペランドで指定した時間だけ終了処理を待ち合わせる場合があります。したがって，大きな値を指定した場合，OpenTP1の終了処理に時間が掛かる場合があります。

指定時間を過ぎても応答がない場合は，RPCは送受信タイムアウトとしてエラーリターンします。

0を指定した場合は，応答を受信するまで待ち続けます。0を指定した場合，OpenTP1が終了しない場合があります。

このオペランドは，システム共通定義のwatch_timeオペランドのデフォルト値で使用してください。

特別なチューニングを必要とする場合以外は，このオペランドの内容を変更しないことをお勧めします。

システム共通定義のwatch_timeオペランドのデフォルト値よりも，極端に小さな値または大きな値を指定すると，OpenTP1ダウンに至る障害が発生する場合がありますので，ご注意ください。

省略した場合の指定値は，次のようになります。

システム共通定義のwatch_timeオペランドの指定も省略した場合は，0を仮定します。

システム共通定義のwatch_timeオペランドを指定した場合は，その指定値を仮定します。

システム共通定義，TAMサービス定義の両方に指定した場合の指定値の優先順位は，次のとおりです（1.＞2.）。

TAMサービス定義

システム共通定義

コマンド形式

次ページ以降に記述しています。

tamtable

名称

TAMテーブルの属性の指定

形式

{{tamtable  〔-o  ローディング契機〕  〔-a  アクセス形態〕〔-i〕〔-j〕
              TAMテーブル名  物理ファイル名}}

機能

オンライン中にTAMサービスを使用してアクセスするテーブル名と属性を指定します。

オプション

●-o　ローディング契機

　〜《start》

TAMテーブルをロードする契機を指定します。

start

TAMサービスを開始するときにロードします。

cmd

tamloadコマンドを入力したときにロードします。

lib

dc_tam_open関数を発行し，TAMテーブルをオープンしたときにロードします。

●-a　アクセス形態

　〜《read》

TAMテーブルのアクセス形態を指定します。

read

参照型

rewrite

追加・削除できない更新型

write

追加・削除できる更新型

reclck

テーブル排他を確保しない，追加・削除できる更新型

●-i

TAMテーブルの実更新時に，入出力エラーが発生してもアクセスを続行する場合に指定します。このオプションを指定すると，入出力エラーが発生しても同一オンラインでは，そのTAMテーブルは障害閉塞状態にはなりません。したがって，アクセスできます。

ただし，入出力エラーが発生後にオンラインダウンした場合，そのテーブルをオンラインから切り離してTAMサービスを再開始します。

●-j

TAMレコード更新時に，更新された部分だけのジャーナルを取得します。

このオプションを指定すると，TAMレコード更新時のジャーナルの取得量を低減できます。

●TAMテーブル名

　〜〈1〜32文字の識別子〉

TAMテーブル名を指定します。

●物理ファイル名

　〜〈1〜63文字のパス名〉

TAMテーブルを格納する物理ファイルを絶対パス名で指定します。ただし，環境変数は使用できません。

クライアントサービス定義

形式

set形式

〔set parallel_count=常駐プロセス数〔,最大プロセス数〕〕
〔set balance_count=1プロセスが処理するサービス要求数〕
〔set trn_expiration_time=トランザクションブランチ限界経過時間〕
〔set trn_expiration_time_suspend=Y|N|F〕
〔set trn_cpu_time=トランザクションブランチCPU監視時間〕
〔set open_rm=OpenTP1_ALL|OpenTP1_NONE〕
〔set clt_inquire_time=常設コネクション問い合わせ間隔最大時間〕
〔set clt_port=クライアント拡張サービスのポート番号〕
〔set clt_trn_conf=Y|N〕
〔set clt_cup_conf=Y|N〕
〔set cup_parallel_count=常駐プロセス数〔,最大プロセス数〕〕
〔set cup_balance_count=サービス要求滞留値〕
〔set clttrn_port=トランザクショナルRPC実行プロセスのポート番号〕
〔set cltcon_port=CUP実行プロセスのポート番号〕
〔set trn_statistics_item=統計情報項目〔,統計情報項目〕…〕
〔set trn_optimum_item=トランザクション最適化項目
                    〔,トランザクション最適化項目〕…〕
〔set trn_watch_time=トランザクション同期点処理時の最大通信待ち時間〕
〔set trn_rollback_information_put=no|self|remote|all〕
〔set trn_limit_time=トランザクションブランチ最大実行可能時間〕
〔set trn_rollback_response_receive=Y|N〕
〔set trn_partial_recovery_type=type1|type2|type3〕
〔set trn_completion_limit_time=トランザクション完了限界時間〕
〔set message_store_buflen=メッセージ格納バッファプール長〕
〔set watch_time=最大応答待ち時間〕

コマンド形式

なし。

機能

OpenTP1のクライアント機能を支援するためのサーバの実行環境を定義します。

CUPからトランザクションを起動するときに次のオペランドを指定します。

説明

set形式のオペランド

●parallel_count=常駐プロセス数〔，最大プロセス数〕

　〜〈符号なし整数〉((1〜1024))《1》

CUP（サーバ側で同時に処理される）から起動するトランザクションの数を指定します。常駐プロセス数を指定すると，OpenTP1起動時に指定した数の実行プロセスが一緒に起動され，常にCUPからのトランザクションの開始要求を受け付ける状態になります。複数のCUPからトランザクションの開始要求を受け付けたときは，並行して処理するので処理性能が向上します。

最大プロセス数を指定すると，常駐プロセス数を超える処理は非常駐プロセスを動的に起動して処理します。指定した最大プロセス数以内でサーバプロセスの起動を制御するため，OpenTP1システムの性能が低下するのを防ぎます。

プロセス数の指定条件を次に示します。

常駐プロセス数と最大プロセス数は1以上の値を指定します。

最大プロセス数を指定する場合は，常駐プロセス数以上の値を指定します。

最大プロセス数を省略した場合は，すべてのプロセスが常駐プロセスとなります。

すべてのプロセスを非常駐プロセス（必要に応じて起動）とすることはできません。

●balance_count=1プロセスが処理するサービス要求数

　〜〈符号なし整数〉((0〜512))《3》

このユーザサーバに対応するスケジュールキューに，処理されないで残っているサービス要求を，1プロセスで幾つ処理させるかを指定します。サービス要求が，（このオペランドの指定値）×（起動プロセス数）を超えてスケジュールキューに残っている場合には，非常駐プロセスを起動してサービス要求を処理させます。このオペランドは，parallel_countオペランドで非常駐プロセスを起動するように指定したサービスグループにだけ有効です。

0を指定すると，サービス要求のあった時点で起動されているすべてのプロセスがサービス処理中の場合，非常駐プロセスが起動されます。

●trn_expiration_time=トランザクションブランチ限界経過時間

　〜〈符号なし整数〉((0〜65535))《0》（単位：秒）

トランザクションブランチの処理を監視する限界経過時間を指定します。CUPからトランザクションを起動したあとに，指定時間を経過してもトランザクションのコミットまたはロールバックの指示がない場合は，このトランザクションブランチのプロセスが異常終了して，ロールバックします。

なお，このオペランドは，クライアント環境定義のDCCLTTREXPTMオペランドでも指定できます。クライアント環境定義については，マニュアル「OpenTP1 クライアント使用の手引 TP1/Client/W，TP1/Client/P編」を参照してください。

指定値の優先順位は次のとおりです（1.＞2.）。

クライアント環境定義

クライアントサービス定義

なお，RPC機能を使用した場合に，他プロセスで実行するトランザクションブランチの処理時間も監視時間に含むかどうかは，trn_expiration_time_suspendオペランドで指定してください。

●trn_expiration_time_suspend=Y|N|F

　〜《N》

トランザクションブランチの処理を監視するとき，次の処理時間も監視時間に含むかどうかを指定します。

監視対象のトランザクションブランチが，RPC機能を使ってほかのトランザクションブランチを呼び出し，その処理が終わるのを待つ時間

連鎖RPCで呼び出されたサーバUAPが次のサービス要求を待つ時間

監視対象のトランザクションブランチが，非同期RPCを使用してほかのトランザクションブランチを呼び出したあと，処理結果受信処理を行っている時間

Y

1.，2.，3.のすべてを監視時間に含みます。

N

3.だけを監視時間に含みます。

F

1.，2.，3.のどれも監視時間に含みません。

なお，このオペランドは，クライアント環境定義のDCCLTTREXPSPオペランドでも指定できます。クライアント環境定義については，マニュアル「OpenTP1 クライアント使用の手引 TP1/Client/W，TP1/Client/P編」を参照してください。

指定値の優先順位は次のとおりです（1.＞2.）。

クライアント環境定義

クライアントサービス定義

このオペランドと各種タイマ監視との関係については，「付録A.2　トランザクションの時間監視」を参照してください。

●trn_cpu_time=トランザクションブランチCPU監視時間

　〜〈符号なし整数〉((0〜65535))《0》（単位：秒）

トランザクションブランチが同期点処理までに使用できるCPU時間を指定します。0を指定した場合は，時間監視しません。指定時間を超えた場合は，該当するトランザクションブランチのプロセスを異常終了し，ロールバックします。

なお，このオペランドは，クライアント環境定義のDCCLTTRCPUTMオペランドでも指定できます。クライアント環境定義については，マニュアル「OpenTP1 クライアント使用の手引 TP1/Client/W，TP1/Client/P編」を参照してください。

指定値の優先順位は次のとおりです（1.＞2.）。

クライアント環境定義

クライアントサービス定義

●open_rm=OpenTP1_ALL|OpenTP1_NONE

　〜《OpenTP1_NONE》

CUPからのトランザクショナルRPC機能を使用した場合に，クライアントサービス実行プログラムがオープンするリソースマネジャの名称を指定します。これによって，CUPからのトランザクショナルRPC機能で同期点処理が最適化できるようになり，トランザクションの性能が向上します。

このオペランドを指定すると，parallel_countオペランドに指定したプロセス数の分だけ，リソースマネジャの資源を占有します。

指定できるリソースマネジャ名を次に示します。

OpenTP1_ALL

OpenTP1開始時，クライアントサービス実行形式プログラムで，OpenTP1が提供するリソースマネジャのうち，OpenTP1に登録されているすべてのリソースマネジャに対してオープン処理を実行します。

OpenTP1_NONE

OpenTP1開始時，クライアントサービス実行形式プログラムで，リソースマネジャに対してオープン処理を実行しません（同期点処理が最適化できません）。

●clt_inquire_time=常設コネクション問い合わせ間隔最大時間

　〜〈符号なし整数〉((0〜1048575))《180》（単位：秒）

CUPがサーバに対して問い合わせをしてから，次の問い合わせをするまでの間隔の最大時間を指定します。

常設コネクション問い合わせ間隔最大時間は，CUP実行プロセスで監視するタイマであり，指定時間を超えても問い合わせがない場合，CUP実行プロセス側で強制的に常設コネクションを解放します。

また，トランザクション内で常設コネクション問い合わせ間隔最大時間の満了を検出した場合は，該当するトランザクションをロールバックします。

0を指定すると，CUPからの問い合わせを無限に待ちます。

なお，このオペランドは，クライアント環境定義のDCCLTINQUIRETIMEオペランドでも指定できます。クライアント環境定義については，マニュアル「OpenTP1 クライアント使用の手引 TP1/Client/W，TP1/Client/P編」を参照してください。

指定値の優先順位は次のとおりです（1.＞2.）。

クライアント環境定義

クライアントサービス定義

●clt_port=クライアント拡張サービスのポート番号

　〜〈符号なし整数〉((5001〜65535))

クライアント拡張サービスのポート番号を指定します。

他システムサーバで使用しているウェルノウンポート番号と異なるポート番号を指定してください。

このオペランドを省略した場合，システム共通定義のrpc_port_baseオペランドが指定されていれば，rpc_port_baseの指定値から「rpc_port_baseの指定値＋prc_process_countの値」の範囲のポート番号が任意に割り当てられます。rpc_port_baseオペランドの指定がない場合には，システムが任意に割り当てたポート番号を使用します。

このオペランドで指定するポート番号は，ほかのプログラムと重複しないようにしてください。

また，OSには任意に割り当てる番号がありますが，この番号も使用しないでください。OSが任意に割り当てる番号は，OSの種別やバージョンによって異なります。詳細については，使用しているOSのマニュアルを参照してください。

●clt_trn_conf=Y|N

　〜《Y》

自OpenTP1ノードで，トランザクショナルRPC実行プロセスを起動するかどうかを指定します。このオペランドを省略，またはYを指定した場合，parallel_countで指定されたプロセス数分のトランザクショナルRPC実行プロセスが起動されます。

●clt_cup_conf=Y|N

　〜《N》

自OpenTP1ノードで，CUP実行プロセスを起動するかどうかを指定します。このオペランドでYを指定した場合，cup_parallel_countで指定されたプロセス数分のCUP実行プロセスが起動されます。

CUPからdc_clt_connect関数，またはdc_clt_connect_s関数などで常設コネクションを確立したい場合は，Yを指定してください。

●cup_parallel_count=常駐プロセス数〔，最大プロセス数〕

　〜〈符号なし整数〉((1〜1024))《1》

CUP（サーバ側で同時に処理される）から確立される常設コネクションの数を指定します。

常駐プロセス数を指定すると，OpenTP1起動時に指定した数のCUP実行プロセスが一緒に起動され，常にCUPからの常設コネクション確立要求を受け付ける状態になります。複数のCUPから常設コネクション確立要求を受け付けた時は，並行して処理するので，処理性能が向上します。

最大プロセス数を指定すると，常駐プロセス数を超える処理は非常駐プロセスを動的に起動して処理します。指定した最大プロセス数以内でサーバプロセスの起動を制御するため，OpenTP1システムの性能が低下するのを防ぎます。

プロセス数の指定条件を次に示します。

常駐プロセス数と最大プロセス数は1以上の値を指定します。

最大プロセス数を指定する場合，常駐プロセス数以上の値を指定します。

最大プロセス数を省略した場合，すべてのプロセスが常駐プロセスとなります。

すべてのプロセスを非常駐プロセス（必要に応じて起動）とすることはできません。

一方，クライアントサービス定義のparallel_countオペランドは，トランザクショナルRPC実行プロセスの常駐プロセス数および最大プロセス数を指定します。

●cup_balance_count=サービス要求滞留値

　〜〈符号なし整数〉((0〜512))《3》

処理されないで残っている常設コネクション確立要求数の滞留値を指定します。

CUPから常設コネクション確立要求を受け付け，その要求をスケジュールキューに登録後，コネクション確立要求がこのオペランドの指定値を超えると，スケジュール機能が非常駐プロセスを起動して，常設コネクション確立要求を処理します。このオペランドは，cup_parallel_countオペランドで最大プロセス数を指定した場合だけ有効です。

0を指定すると，常設コネクション確立要求のあった時点で起動されているすべてのプロセスがCUPとの常設コネクションを確立していた場合，非常駐プロセスが起動されます。

一方，クライアントサービス定義のbalance_countオペランドは，トランザクショナルRPC実行プロセスのサービス要求滞留値を指定します。

●clttrn_port=トランザクショナルRPC実行プロセスのポート番号

　〜〈符号なし整数〉((5001〜65535))

トランザクショナルRPC実行プロセスのポート番号を指定します。

他システムサーバで使用しているウェルノウンポート番号と異なるポート番号を指定してください。

このオペランドを省略した場合，システム共通定義のrpc_port_baseオペランドが指定されていれば，rpc_port_baseの指定値から「rpc_port_baseの指定値＋prc_process_countの値」の範囲のポート番号が任意に割り当てられます。

rpc_port_baseオペランドの指定がない場合には，システムが任意に割り当てたポート番号を使用します。

ここで指定したポート番号から，parallel_countオペランドで指定した数がポート番号として割り当てられます。したがって，このオペランドの指定値とparallel_countオペランドの指定値の和が，65535を超えないように注意してください。

このオペランドで指定するポート番号は，ほかのプログラムと重複しないようにしてください。

また，OSには任意に割り当てる番号がありますが，この番号も使用しないでください。OSが任意に割り当てる番号は，OSの種別やバージョンによって異なります。詳細については，使用しているOSのマニュアルを参照してください。

●cltcon_port=CUP実行プロセスのポート番号

　〜〈符号なし整数〉((5001〜65535))

CUP実行プロセスのポート番号を指定します。

他システムサーバで使用しているウェルノウンポート番号と異なるポート番号を指定してください。

このオペランドを省略した場合，システム共通定義のrpc_port_baseオペランドが指定されていれば，rpc_port_baseの指定値から「rpc_port_baseの指定値＋prc_process_countの値」の範囲のポート番号が任意に割り当てられます。

rpc_port_baseオペランドの指定がない場合には，システムが任意に割り当てたポート番号を使用します。

ここで指定したポート番号から，cup_parallel_countオペランドで指定した数がポート番号として割り当てられます。したがって，このオペランドの指定値とcup_parallel_countオペランドの指定値の和が，65535を超えないように注意してください。

このオペランドで指定するポート番号は，ほかのプログラムと重複しないようにしてください。

また，OSには任意に割り当てる番号がありますが，この番号も使用しないでください。OSが任意に割り当てる番号は，OSの種別やバージョンによって異なります。詳細については，使用しているOSのマニュアルを参照してください。

●trn_statistics_item=統計情報項目〔，統計情報項目〕…

　〜《executiontime》

トランザクションブランチの統計情報を取得する項目を指定します。

nothing

統計情報を取得しません。

base

基本情報として，次の情報を取得します。

トランザクションブランチの識別子

トランザクションブランチの決着結果

トランザクションブランチの実行プロセス種別

トランザクションブランチの実行サーバ名

トランザクションブランチの実行サービス名

executiontime

基本情報とトランザクションブランチの実行時間情報を取得します。

cputime

基本情報とトランザクションブランチのCPU時間情報を取得します。

nothingの指定は，一つしかできません。また，nothingとほかの統計情報項目を同時に指定した場合，nothingの指定は無効になります。

トランザクションに関する統計情報を取得するときは次のどれかを指定してください。

トランザクションサービス定義のtrn_tran_statisticsオペランドにYを指定

trnsticsコマンドで-sオプションを指定

なお，このオペランドは，クライアント環境定義のDCCLTTRSTATISITEMオペランドでも指定できます。クライアント環境定義については，マニュアル「OpenTP1 クライアント使用の手引 TP1/Client/W，TP1/Client/P編」を参照してください。

指定値の優先順位は次のとおりです（1.＞2.）。

クライアント環境定義

クライアントサービス定義

●trn_optimum_item=トランザクション最適化項目〔，トランザクション最適化項目〕…

　〜《base》

複数のユーザサーバで構成されるグローバルトランザクションの性能を向上させるための最適化項目を，次の文字列で指定します。

base

同期点処理全体（プリペア処理，コミット処理，およびロールバック処理）を最適化します。OpenTP1のトランザクション制御は2相コミット方式で実行しているため，二つのトランザクションブランチ間のコミット制御には，4回のプロセス間通信が必要となります。

次の条件をすべて満たす場合，親トランザクションブランチが子トランザクションブランチのコミット処理を代わりに実行することで，コミット制御で必要な4回のプロセス間通信を削減します。

親トランザクションブランチと，子トランザクションブランチが同一OpenTP1下にあること。

親トランザクションブランチが，子トランザクションブランチを同期応答型RPCで呼び出していること。

子トランザクションブランチでアクセスしたリソースマネジャのXAインタフェース用オブジェクトが，親トランザクションブランチにもリンケージされていること。

asyncprepare

baseの指定条件を満たしていないため同期点処理全体の最適化ができない場合に，プリペア処理を最適化します。

次の条件をすべて満たす場合，親トランザクションブランチから発行されたRPCによって子トランザクションブランチがサービス要求を実行したときに，RPCのリターン前にプリペア処理を実行することで，2回のプロセス間通信を削減します。

baseを指定した最適化ができないこと。

親トランザクションブランチが，子トランザクションブランチを同期応答型RPCで呼び出していること。

ただし，この最適化を実行した場合，親トランザクションブランチが発行した同期応答型RPCの応答時間が遅くなります。また，子トランザクションブランチは，プリペア処理からコミット処理までの間隔（親トランザクションブランチからの支持がないとトランザクションを決着できない状態）が大きくなります。そのため，親トランザクションブランチのOpenTP1がシステムダウンし，トランザクションブランチ間の連絡ができなくなると，ジャーナルファイルのスワップやチェックポイントダンプファイルの有効化が遅れ，子トランザクションブランチのOpenTP1もシステムダウンする場合があります。

トランザクション最適化項目は，重複して指定できます。ただし，優先順位は次のようになります（1.＞2.）。

base

asyncprepare

なお，このオペランドは，クライアント環境定義のDCCLTTROPTIITEMオペランドでも指定できます。クライアント環境定義については，マニュアル「OpenTP1 クライアント使用の手引 TP1/Client/W，TP1/Client/P編」を参照してください。

指定値の優先順位は次のとおりです（1.＞2.）。

クライアント環境定義

クライアントサービス定義

●trn_watch_time=トランザクション同期点処理時の最大通信待ち時間

　〜〈符号なし整数〉((1〜65535))《120》（単位：秒）

トランザクションの同期点処理で，トランザクションブランチ間で行う通信（プリペア，コミット，ロールバック指示，または応答など）の受信待ち時間の最大値を指定します。

指定時間を過ぎても指示または応答がない場合は，該当するトランザクションブランチが2相コミットの1相目完了前であればロールバックさせ，1相目完了後であればトランザクションサービスのシステムプロセスでトランザクション決着処理を再試行します。

なお，このオペランドは，クライアント環境定義のDCCLTTRWATCHTIMEオペランドでも指定できます。クライアント環境定義については，マニュアル「OpenTP1 クライアント使用の手引 TP1/Client/W，TP1/Client/P編」を参照してください。

指定値の優先順位は次のとおりです（1.＞2.）。

クライアント環境定義

クライアントサービス定義

●trn_rollback_information_put=no|self|remote|all

　〜《no》

トランザクションブランチがロールバックした場合に，ロールバック要因に関する情報をログに取得するかどうかを指定します。

no

ロールバック情報を取得しません。

self

ロールバック要因が発生したトランザクションブランチでだけ，ログにロールバック情報を取得します。

remote

selfに加え，他ノードのトランザクションブランチからロールバック要求されたトランザクションブランチでも，ログにロールバック情報を取得します。

all

remoteに加え，自ノードのトランザクションブランチからロールバック要求されたトランザクションブランチでも，ログにロールバック情報を取得します。

なお，このオペランドは，クライアント環境定義のDCCLTTRRBINFOオペランドでも指定できます。クライアント環境定義については，マニュアル「OpenTP1 クライアント使用の手引 TP1/Client/W，TP1/Client/P編」を参照してください。

指定値の優先順位は次のとおりです（1.＞2.）。

クライアント環境定義

クライアントサービス定義

●trn_limit_time=トランザクションブランチ最大実行可能時間

　〜〈符号なし整数〉((0〜65535))《0》（単位：秒）

トランザクションブランチの最大実行可能時間を指定します。

トランザクションブランチを開始してから同期点処理が終了するまでの時間が，このオペランド指定時間を超えないようにdc_rpc_call関数，dc_rpc_poll_any_replies関数および同期点処理内で行う通信のタイムアウト時間を次のように自動設定します。

dc_rpc_call関数およびdc_rpc_poll_any_replies関数のタイムアウト時間

「K≧このオペランド指定時間」の場合は，要求処理を実行しないで，タイムアウトでエラーリターンします。

「K＜このオペランド指定時間」でかつ「（このオペランド指定時間−K）≧W」の場合は，Wをタイムアウト時間とします。

「K＜このオペランド指定時間」でかつ「（このオペランド指定時間−K）＜W」の場合は，（このオペランド指定時間−K）をタイムアウト時間とします。

K

現時刻−トランザクションブランチ開始時刻

W

dc_rpc_call関数の場合はwatch_timeオペランド指定時間

dc_rpc_poll_any_replies関数の場合は引数timeout指定時間

同期点処理内で行う通信のタイムアウト時間

「K≧このオペランド指定時間」の場合は，タイムアウト時間を1秒とします。

「K＜このオペランド指定時間」でかつ「（このオペランド指定時間−K）≧W」の場合は，Wをタイムアウト時間とします。

「K＜このオペランド指定時間」でかつ「（このオペランド指定時間−K）＜W」の場合は，（このオペランド指定時間−K）をタイムアウト時間とします。

K

現時刻−トランザクションブランチ開始時刻

W

trn_watch_timeオペランド指定時間

trn_watch_timeオペランドを省略した場合はwatch_timeオペランド指定時間

上記の受信待ち以外の処理で時間が掛かった場合は，このオペランド指定時間以内にトランザクションブランチが終了しないことがあります。

同期点処理開始前にこのオペランドの指定時間が経過した場合，そのトランザクションはロールバックします。

0を指定した場合は，時間監視をしません。

なお，このオペランドは，クライアント環境定義のDCCLTTRLIMITTIMEオペランドでも指定できます。クライアント環境定義については，マニュアル「OpenTP1 クライアント使用の手引 TP1/Client/W，TP1/Client/P編」を参照してください。

指定値の優先順位は次のとおりです（1.＞2.）。

クライアント環境定義

クライアントサービス定義

●trn_rollback_response_receive=Y|N

　〜《Y》

RPC先トランザクションブランチにロールバック指示を送信したあと，ロールバック完了通知を受信するかどうかを指定します。Nを指定した場合，RPC先トランザクションブランチからのロールバック完了通知を受信しないで（RPC先トランザクションブランチのロールバック処理の完了を待たないで）自トランザクションブランチを終了します。

なお，このオペランドは，クライアント環境定義のDCCLTTRRBRCVオペランドでも指定できます。クライアント環境定義については，マニュアル「OpenTP1 クライアント使用の手引 TP1/Client/W，TP1/Client/P編」を参照してください。

指定値の優先順位は次のとおりです（1.＞2.）。

クライアント環境定義

クライアントサービス定義

●trn_partial_recovery_type=type1|type2|type3

　〜《type1》

UAP障害時のトランザクション同期点処理方式を指定します。

クライアントサービス定義でこのオペランドを指定する場合は，CUPからトランザクションを開始する場合だけに有効です。

RPCがタイムアウトし，RPC発行先プロセスのアドレスが未解決の場合やトランザクション実行中のUAPがダウンした場合に，トランザクションブランチ間の連絡がスムーズにできないで，トランザクションの決着に時間が掛かることがあります。

このオペランドでは，次に示す障害が発生した場合のトランザクション同期点処理方式を，指定値に示す三つの方式から選択して指定します。

（障害1）RPCがタイムアウトした場合

この場合，RPC発行元トランザクションブランチは，サービス要求がどのプロセスで実行されているかがわからないため，RPC発行先トランザクションブランチにトランザクション同期点メッセージを送信できないで，RPC発行元トランザクションブランチおよびRPC発行先トランザクションブランチがトランザクション同期点メッセージ待ちとなり，トランザクションの決着に時間が掛かります。

（障害2）RPC発行元UAPがRPCの応答受信前にダウンした場合

この場合，RPC発行元トランザクションブランチは，サービス要求がどのプロセスで実行されているかがわからないため，RPC発行先トランザクションブランチにトランザクション同期点メッセージを送信できないで，RPC発行先トランザクションブランチはトランザクション同期点メッセージ待ちとなり，トランザクションの決着に時間が掛かります。

（障害3）RPC発行先UAPからの応答受信後にRPC発行元UAPとRPC発行先UAPがほぼ同時にダウンした場合

この場合，それぞれのトランザクションブランチを引き継いだトランザクション回復プロセスは，相手UAPプロセスのダウンを知らないため，すでに存在しないUAPプロセスにトランザクション同期点メッセージを送信してしまい，トランザクションの決着に時間が掛かることがあります。

type1

（障害1）が発生した場合，RPC発行元トランザクションブランチおよびRPC発行先トランザクションブランチは，トランザクション同期点メッセージ受信処理がタイムアウトすることによって，トランザクションを決着します。

（障害2）が発生した場合，RPC発行元トランザクションブランチは，RPC発行先トランザクションブランチにトランザクション同期点メッセージを送信しないでトランザクションを決着します。RPC発行先トランザクションブランチは，トランザクション同期点メッセージ受信処理がタイムアウトすることによって，トランザクションを決着します。

（障害3）が発生した場合，RPC発行元トランザクションブランチおよびRPC発行先トランザクションブランチは，トランザクション同期点メッセージ受信処理がタイムアウトすることによって，トランザクションを決着します。

type2

（障害1）が発生してトランザクションをコミットする場合はtype1と同じです。

（障害1）が発生してトランザクションをロールバックする場合，または（障害2）が発生した場合は，RPC発行元トランザクションブランチは，RPC発行先トランザクションブランチが存在するノードのトランザクションサービスプロセスにトランザクション同期点メッセージを送信後，トランザクションを決着します。トランザクション同期点メッセージを受信したトランザクションサービスプロセスは，該当するトランザクションブランチを処理中のプロセスに，トランザクション同期点指示を送信します。

（障害3）が発生した場合，RPC発行元トランザクションブランチおよびRPC発行先トランザクションブランチは，トランザクション同期点メッセージ受信処理がタイムアウトすることによって，トランザクションを決着します。

type3

（障害1）が発生してトランザクションをコミットする場合は，type1と同じです。

（障害1）が発生してトランザクションをロールバックする場合，（障害2）が発生した場合，または（障害3）が発生した場合，相手トランザクションブランチが存在するノードのトランザクションサービスプロセスに，トランザクション同期点メッセージを送信します。トランザクション同期点メッセージを受信したトランザクションサービスプロセスは，該当するトランザクションブランチを処理中のプロセスに，トランザクション同期点指示を送信します。

次に示す場合，このオペランドにtype2またはtype3を指定しても，トランザクションの決着に時間が掛かることがあります。

RPC実行中に，RPC発行先UAPの状態が変更となり（負荷増加，UAP終了，UAP閉塞など），ほかのノードの同一UAPにサービス要求が再転送された場合

相手先のOpenTP1がこのオプションをサポートしていないバージョンの場合

相手先トランザクションブランチがトランザクション同期点メッセージ受信処理以外で時間が掛かっている場合

TP1/Server BaseまたはTP1/LiNK以外とトランザクション連携をする場合，このオペランドにはtype1を指定または省略してください。

なお，このオペランドは，クライアント環境定義のDCCLTTRRECOVERYTYPEオペランドでも指定できます。クライアント環境定義については，マニュアル「OpenTP1 クライアント使用の手引 TP1/Client/W，TP1/Client/P編」を参照してください。

指定値の優先順位は次のとおりです（1.＞2.）。

クライアント環境定義

クライアントサービス定義

●trn_completion_limit_time=トランザクション完了限界時間

　〜〈符号なし整数〉((0〜65535))《0》（単位：秒）

トランザクションブランチの開始から終了までの最大実行時間を指定します。指定時間を超えた場合，このトランザクションブランチのプロセスが異常終了したあとに，トランザクションブランチが回復プロセスによってコミットまたはロールバックのどちらかに決着して終了します。0を指定した場合は，トランザクションブランチの最大実行時間を監視しません。

UAPが異常終了した場合に閉塞するかどうかはholdオペランド，term_watch_timeオペランドの指定によります。詳細については，ユーザサービス定義のholdオペランドおよびterm_watch_timeオペランドの説明を参照してください。

このオペランドの監視対象区間は，dc_trn_begin関数などの呼び出しやサービス関数の開始によるトランザクションの開始から，トランザクションの同期点処理終了情報（TJ）の取得後であるトランザクションブランチの終了までです。ただし，トランザクションの最適化が行われた場合，サーバ側のトランザクションブランチに対する監視が終了するのは，クライアント側に応答を返したあとです。このオペランドの監視対象区間の詳細および各種タイマ監視との関係については，「付録A.2　トランザクションの時間監視」を参照してください。

●message_store_buflen=メッセージ格納バッファプール長

　〜〈符号なし整数〉((1024〜31457280))《8196》（単位：バイト）

CUPからのトランザクショナルRPC要求，常設コネクション要求を，トランザクショナルRPC実行プロセス，CUP実行プロセスに渡す前にいったん格納しておく共用メモリのプールの大きさを指定します。

次の計算式で求めた値を指定してください。

メッセージ格納バッファプール長＝D×C

D：制御データ長（256バイト）

C：同時に発生するトランザクショナルRPC要求数，常設コネクション要求数のうち大きい値

なお，この計算式の算出結果が8196より小さい場合は，指定する必要はありません。

●watch_time=最大応答待ち時間

　〜〈符号なし整数〉((0〜65535))（単位：秒）

CUPから，トランザクションを開始した場合や，常設コネクションを確立した場合，CUPから発行されるRPCはクライアント拡張サービスの実行プロセスが代理実行します。このオペランドでは，実行プロセスが代理実行するRPCによってプロセス間で通信する場合，サービス要求を送信してからサービスの応答が返るまでの待ち時間の最大値を指定します。

指定時間を過ぎても応答がない場合は，受信タイムアウトとしてCUPにエラーリターンします。

0を指定した場合は，応答を受信するまで待ち続けます。

クライアント環境定義にDCWATCHTIMINHERIT=Yと定義されている場合は，CUP側のタイマ値が有効になり，このオペランドに指定されたタイマ値は無視されます。

このオペランドの指定を省略した場合，システム共通定義のwatch_timeオペランドに指定した値を仮定します。

特別なチューニングを必要とする場合以外は，このオペランドの内容を変更しないことをお勧めします。

システム共通定義のwatch_timeオペランドのデフォルト値よりも，極端に小さな値または大きな値を指定すると，OpenTP1ダウンに至る障害が発生する場合がありますので，ご注意ください。

コマンド形式

なし。

注意事項

CUPから起動するトランザクションは，parallel_countオペランドで指定したプロセス数だけ同時に並行実行します。このプロセスのサーバ名は_clttrnです。trnlsコマンドでこのプロセスのトランザクション状態を表示できます。

また，トランザクションブランチ限界経過時間に達した場合などの要因によって，プロセスがキャンセルされた場合に表示するメッセージにも，このサーバ名が表示されます。

ISTサービス定義

形式

set形式

〔set ist_node=ノード名〔,ノード名〕…〕
〔set ist_node_group=ノードグループ名〕

コマンド形式

istdef  テーブル名  レコード長  レコード数

機能

ISTサービスを使用するための実行環境を定義します。

説明

set形式のオペランド

●ist_node=ノード名〔，ノード名〕…

　〜《4文字の識別子》

ISTテーブルを操作するノード名を指定します。

各ノードのシステム共通定義のnode_idオペランドで指定した，ノード識別子を指定します。ISTテーブルに更新が発生した場合，ここで指定したノードに反映されます。

ノード名は最大128個指定できます。

なお，ist_node_groupオペランドを指定しない場合は，ist_nodeオペランドに一つ以上のノード名を必ず指定してください。

●ist_node_group=ノードグループ名

　〜《1〜8文字の識別子》

ISTテーブルを操作するノードグループ名を指定します。

マルチノード構成定義のdcmarea -mオプションで指定したマルチノードエリア識別子，または-gオプションで指定したマルチノードサブエリア識別子を指定します。

ist_nodeオペランドとist_node_groupオペランドの両方を指定した場合は，ist_node_groupオペランドを優先します。

なお，ist_nodeオペランドを指定しない場合は，ist_node_groupオペランドを必ず指定してください。

コマンド形式

次ページ以降に記述しています。

istdef

名称

ISTサービスのテーブル名の定義

形式

istdef  テーブル名  レコード長  レコード数

機能

ISTサービスを使用してアクセスするISTテーブル名を指定します。

テーブル名，レコード長，レコード数はすべて指定してください。また，ISTサービス定義内にISTテーブルを，最低一つ定義してください。

1ノードに定義できるテーブル数は，最大64です。ただし，定義したすべてのISTテーブルのテーブル長の合計を64キロバイト以下にしてください。計算式を次に示します。

 n
Σ（各テーブルの1レコード長×レコード数）≦64キロバイト
 1

n：定義したテーブル数

オプション

●テーブル名

　〜〈1〜8文字の識別子〉

すべてのISTテーブル内で一意となる名称を指定します。

●レコード長

　〜〈符号なし整数〉((4〜65536))（単位：バイト）

ISTテーブルのレコード長を4の倍数で指定します。

ISTテーブルの全レコードは固定長です。

●レコード数

　〜〈符号なし整数〉((1〜16384))（単位：個）

ISTテーブルが持つレコード数を指定します。

RMMサービス定義

形式

set形式

  set rmm_check_services=監視対象RM名
〔set rmm_system_behavior=down|giveup〕
〔set rmm_down_with_system=Y|N〕
〔set rmm_sysdown_with_rm=Y|N〕

コマンド形式

なし。

機能

RMMサービスを使用するリソースマネジャ（監視対象RM）を定義します。

説明

set形式のオペランド

●rmm_check_services=監視対象RM名

　〜〈1〜7文字の識別子〉

RMMサービスで監視するリソースマネジャを指定します。監視対象リソースマネジャの定義ファイルと同じ名称を指定します。

●rmm_system_behavior=down|giveup

　〜《down》

RMMサービスが監視対象リソースマネジャの開始，または再開始に失敗した場合，システム全体の開始処理を続行するかどうかを指定します。

down

OpenTP1を開始しません。

giveup

OpenTP1開始処理を続行します。

●rmm_down_with_system=Y|N

　〜《Y》

OpenTP1のダウン時，またはdcstop -fコマンド実行時に，監視対象リソースマネジャも同時にダウンさせるかどうかを指定します。

Y

ダウンさせます。

N

ダウンさせません。

システムサービス構成定義のha_confオペランドにYを指定した場合は，このオペランドの指定を省略するか，またはYを指定してください。

●rmm_sysdown_with_rm=Y|N

　〜《N》

監視対象リソースマネジャのダウン時に，OpenTP1も同時にダウンさせるかどうかを指定します。

Y

ダウンさせます。

N

ダウンさせません。監視対象リソースマネジャは再起動します。

システムサービス構成定義のha_confオペランドにYを指定した場合は，このオペランドの指定を省略するか，またはNを指定してください。

コマンド形式

なし。

監視対象RM定義

形式

set形式

  set rmm_start_command=監視対象RM開始コマンド
  set rmm_stop_command=監視対象RM終了コマンド
  set rmm_abort_command=監視対象RM強制終了コマンド
  set rmm_get_pid_command=監視対象プロセスID取得コマンド
〔set rmm_command_watch_time=監視対象RMコマンド監視時間〕
  set rmm_command_uid=コマンド実行用ユーザID
  set rmm_command_gid=コマンド実行用グループID
〔set rmm_start_watch_time=監視対象RM開始処理監視時間〕

コマンド形式

なし。

機能

RMMサービスのコマンドを定義します。

コマンドの作成については，マニュアル「OpenTP1 運用と操作」を参照してください。

説明

set形式のオペランド

●rmm_start_command=監視対象RM開始コマンド

　〜〈1〜127バイトのパス名〉

監視対象リソースマネジャを開始するためのコマンド名を指定します。

コマンド名は，ルートディレクトリからの絶対パス名で指定してください。

●rmm_stop_command=監視対象RM終了コマンド

　〜〈1〜127バイトのパス名〉

監視対象リソースマネジャを終了するためのコマンド名を指定します。

コマンド名は，ルートディレクトリからの絶対パス名で指定してください。

●rmm_abort_command=監視対象RM強制終了コマンド

　〜〈1〜127バイトのパス名〉

監視対象リソースマネジャを強制終了するためのコマンド名を指定します。

コマンド名は，ルートディレクトリからの絶対パス名で指定してください。

●rmm_get_pid_command=監視対象プロセスID取得コマンド

　〜〈1〜127バイトのパス名〉

監視対象プロセスのプロセスIDを取得するためのコマンド名を指定します。

コマンド名は，ルートディレクトリからの絶対パス名で指定してください。

●rmm_command_watch_time=監視対象RMコマンド監視時間

　〜〈符号なし整数〉((0〜7200))《1800》（単位：秒）

監視対象リソースマネジャの各コマンドの監視時間を指定します。指定した時間を過ぎてもコマンドが終了しなかった場合，RMMサービスはコマンド失敗と判断してコマンドを無効にします。

0を指定した場合，監視時間は無限となります。

このオペランドを指定する場合は，dcstopコマンドで指定した監視時間内になるように指定してください。

●rmm_command_uid=コマンド実行用ユーザID

　〜〈符号なし整数〉((0〜59999))

各監視対象リソースマネジャのコマンド（開始コマンド，終了コマンド，強制終了コマンド，プロセスID取得コマンド）を実行するユーザのIDを指定します。

RMMサービスでは，この指定に従って各コマンドのユーザIDを設定して実行します。このユーザIDは，各コマンド中で実行されるコマンドや，子プロセスにも引き継がれます。

●rmm_command_gid=コマンド実行用グループID

　〜〈符号なし整数〉((0〜59999))

各監視対象リソースマネジャのコマンド（開始コマンド，終了コマンド，強制終了コマンド，プロセスID取得コマンド）を実行するグループのIDを指定します。

RMMサービスでは，この指定に従って各コマンドのグループIDを設定して実行します。このグループIDは，各コマンド中で実行されるコマンドや，子プロセスにも引き継がれます。

●rmm_start_watch_time=監視対象RM開始処理監視時間

　〜〈符号なし整数〉((0〜7200))《300》（単位：秒）

RMMサービスが，監視対象リソースマネジャの再開始を待つ時間を指定します。0を指定した場合は，監視対象リソースマネジャが再開始されるまで待ち続けます。

このオペランドは，監視対象リソースマネジャを自動再開始機能で再開始する場合に有効です。詳細については，マニュアル「OpenTP1 運用と操作」を参照してください。

コマンド形式

なし。

拡張RM登録定義

形式

set形式

なし。

コマンド形式

trnlnkrm 〔〔-a  追加するOpenTP1提供以外のRM名
           〔, 追加するOpenTP1提供以外のRM名〕…〕
           -s  RMスイッチ名〔,RMスイッチ名〕…
           -o  'RM関連オブジェクト名〔 RM関連オブジェクト名〕…'
           〔, 'RM関連オブジェクト名〔 RM関連オブジェクト名〕…'〕…〕
         〔-C  'コンパイルオプション名〔 コンパイルオプション名〕…'〕
         〔-B  'リンケージオプション名〔 リンケージオプション名〕…'〕
         〔-l〕〔-f〕

機能

dcsetupコマンド内でOpenTP1提供のリソースマネジャを登録したあと，OpenTP1提供以外のリソースマネジャを登録するための実行環境を定義します。

拡張RM登録定義がない場合，OpenTP1提供以外のリソースマネジャを登録しません。

拡張RM登録定義は，ボーンシェル（/bin/sh）の書式で記述してください。

説明

set形式

なし。

コマンド形式

次ページ以降に記述しています。

trnlnkrm

名称

OpenTP1提供以外のリソースマネジャの登録

形式

trnlnkrm 〔〔-a  追加するOpenTP1提供以外のRM名
           〔, 追加するOpenTP1提供以外のRM名〕…〕
           -s  RMスイッチ名〔,RMスイッチ名〕…
           -o  'RM関連オブジェクト名〔 RM関連オブジェクト名〕…'
           〔, 'RM関連オブジェクト名〔 RM関連オブジェクト名〕…'〕…〕
         〔-C  'コンパイルオプション名〔 コンパイルオプション名〕…'〕
         〔-B  'リンケージオプション名〔 リンケージオプション名〕…'〕
         〔-l〕〔-f〕

機能

dcsetupコマンド内でOpenTP1提供のリソースマネジャを登録したあと，OpenTP1提供以外のリソースマネジャを登録します。

オプション

●-a　追加するOpenTP1提供以外のRM名〔，追加するOpenTP1提供以外のRM名〕…

　〜〈1〜31文字の英数字〉

追加するOpenTP1提供以外のリソースマネジャの名称を指定します。OpenTP1提供のリソースマネジャは指定しないでください。

このオプションで指定したリソースマネジャに対しては，RMスイッチ名，およびRM関連オブジェクト名を指定してください。

複数のRM名を指定する場合は，RM名とRM名との間をコンマ（,）で区切ります。

●-s　RMスイッチ名〔,RMスイッチ名〕…

　〜〈先頭が英字，またはアンダスコアで始まる1〜32文字の英数字〉

追加するOpenTP1提供以外のリソースマネジャのスイッチ名を指定します。

スイッチ名については，追加するリソースマネジャの仕様書を参照してください。複数のRMスイッチ名を指定する場合は，RMスイッチ名とRMスイッチ名との間をコンマ（,）で区切ります。

RMスイッチ名とRM名は，指定した順に対応します。

●-o　'RM関連オブジェクト名〔 RM関連オブジェクト名〕…'〔, 'RM関連オブジェクト名〔 RM関連オブジェクト名〕…'〕…

　〜〈英数字〉

追加するOpenTP1提供以外のリソースマネジャに関連のある，オブジェクトファイル（XAインタフェース用オブジェクトファイル）の名称を指定します。

一つのリソースマネジャに対して複数のRM関連オブジェクト名を指定できます。RM関連オブジェクト名については，追加するリソースマネジャの仕様書を参照してください。

RM関連オブジェクト名の中にコンマ（,）を記述する必要がある場合は，コンマ（,）の前に'¥'を記述してください。

複数のRM関連オブジェクト名を指定する場合は，RM関連オブジェクト名とRM関連オブジェクト名との間を空白で区切ります。

複数のリソースマネジャに対するRM関連オブジェクト名を指定する場合は，一つのリソースマネジャに対するRM関連オブジェクト名の集まりをアポストロフィ（'）で囲み，それぞれの集まりの間をコンマ（,）で区切ります。

RM関連オブジェクト名とRMは，指定した順に対応します。

●-C　'コンパイルオプション名〔 コンパイルオプション名〕…'

　〜〈1〜512文字の文字列〉

コンパイル実行時に使用するコンパイルオプションを指定します。

指定するコンパイルオプション名はアポストロフィ（'）で囲み，コンパイルオプション名にコンマ（,）を指定する必要がある場合は，コンマ（,）の前に'¥'を記述してください。

複数のコンパイルオプション名を指定する場合は，コンパイルオプション名とコンパイルオプション名との間を空白で区切ります。

通常，このオプションを指定する必要はありません。

●-B　'リンケージオプション名〔 リンケージオプション名〕…'

　〜〈1〜512文字の文字列〉

ライブラリリンケージ実行時に使用するリンケージオプションを指定します。

指定するリンケージオプション名はアポストロフィ（'）で囲み，リンケージオプション名にコンマ（,）を指定する必要がある場合は，コンマ（,）の前に'¥'を記述してください。

複数のリンケージオプション名を指定する場合は，リンケージオプション名とリンケージオプション名との間を空白で区切ります。trnlnkrmコマンドでは，ccコマンドを使用してリンケージを行っています。このため，指定できるリンケージオプションは，ccコマンドで指定できるオプションとなります。

通常，このオプションを指定する必要はありません。

●-l

trnlnkrmコマンドの実行経過を，標準出力に出力します。

●-f

OpenTP1の状態に関係なく，trnlnkrmコマンドを強制的に実行します。ただし，OpenTP1のトランザクションサービス制御プログラム，およびクライアントサービス実行形式プログラムを再作成するため，OpenTP1がオンライン中の場合は実行できません。

このオプションは，OpenTP1を正常終了以外（計画停止A，計画停止B，強制停止，および異常終了）で終了したあと，使用するリソースマネジャを変更してOpenTP1を正常開始する場合にだけ指定してください。

このオプションを指定したtrnlnkrmコマンドが正常終了したあとは，OpenTP1は再開始できません。

注意事項

拡張RM登録定義は，ボーンシェル（/bin/sh）の書式で記述してください。

複数のtrnlnkrmコマンドを記述した場合は，先頭から順に実行します。

trnlnkrmコマンドが正常終了したあとは，OpenTP1は再開始できません。必ず正常開始してください。

オプションを複数の行に分けて指定する場合は，オプションとオプションとの間に継続符号'¥'を挿入して改行してください。一つのオプションの指定値の途中（例えば，-oオプションで複数のRM関連オブジェクト名を指定する場合の，RM関連オブジェクト名とRM関連オブジェクト名との間）で改行すると，コマンドが正しく実行されない場合があります。

XATMI通信サービス定義

形式

set形式

〔set xatinitapt="自AP名称"〕
〔set xatinitaeq=自AE修飾子〕
〔set xat_aso_con_event_svcname="サービスグループ名",
                                "サービス名"〕
〔set xat_aso_discon_event_svcname="サービスグループ名",
                                   "サービス名"〕
〔set xat_aso_failure_event_svcname="サービスグループ名",
                                    "サービス名"〕
〔set max_open_fds=OSI TP通信のアソシエーションによって使用される
                   FDSの最大値〕
〔set max_socket_descriptors=XATMI通信サービスとUAPとの通信で使用
                             されるFDSの最大値〕

コマンド形式

xatsrvadd -p "他AP名称" -q 他AE修飾子
          -s "サービス名"〔,"サービス名"〕…

機能

TP1/NET/OSI-TP-Extendedを使った，XATMIインタフェースでのOSI TP通信の実行環境を定義します。

説明

set形式のオペランド

●xatinitapt="自AP名称"

　〜〈1〜24文字の16進数字〉

OpenTP1システムごとに付ける自AP名称を指定します。

TP1/NET/OSI-TP-Extendedのプロトコル固有定義で指定した，自システムが発呼側となる場合の，発呼側のAP名称と同じ名称を指定してください。

TP1/NET/OSI-TP-Extendedのプロトコル固有定義については，マニュアル「OpenTP1 プロトコル TP1/NET/OSI-TP-Extended編」を参照してください。

●xatinitaeq=自AE修飾子

　〜〈符号なし整数〉((0〜2147483647))

OpenTP1システムごとに付ける自AE修飾子を指定します。

TP1/NET/OSI-TP-Extendedのプロトコル固有定義で指定した，自システムが発呼側となる場合の，発呼側のAE修飾子と同じ修飾子を指定してください。

TP1/NET/OSI-TP-Extendedのプロトコル固有定義については，マニュアル「OpenTP1 プロトコル TP1/NET/OSI-TP-Extended編」を参照してください。

●xat_aso_con_event_svcname="サービスグループ名"，"サービス名"

アソシエーションの確立通知を受信するSPPのサービスグループ名とサービス名を指定します。

サービスグループ名　〜〈1〜31文字の識別子〉

アソシエーションの確立通知を受信する，SPPのサービスグループ名を指定します。

サービス名　〜〈1〜31文字の識別子〉

アソシエーションの確立通知を受信する，SPPのサービス名を指定します。

このオペランドで指定するサービスグループ名とサービス名は，xat_aso_discon_event_svcnameオペランドおよびxat_aso_failure_event_svcnameオペランドで指定した，サービスグループ名およびサービス名と同じでもかまいません。同じサービスグループ名とサービス名を指定すると，アソシエーションの確立通知と解放通知を一つのサービス関数で受信できます。

このオペランドの指定を省略すると，通信イベントは通知されません。

●xat_aso_discon_event_svcname="サービスグループ名"，"サービス名"

アソシエーションの正常解放通知を受信するSPPのサービスグループ名とサービス名を指定します。

サービスグループ名　〜〈1〜31文字の識別子〉

アソシエーションの正常解放通知を受信する，SPPのサービスグループ名を指定します。

サービス名　〜〈1〜31文字の識別子〉

アソシエーションの正常解放通知を受信する，SPPのサービス名を指定します。

このオペランドで指定するサービスグループ名とサービス名は，xat_aso_con_event_svcnameオペランドおよびxat_aso_failure_event_svcnameオペランドで指定した，サービスグループ名およびサービス名と同じでもかまいません。同じサービスグループ名とサービス名を指定すると，アソシエーションの確立通知と解放通知を一つのサービス関数で受信できます。

このオペランドの指定を省略すると，通信イベントは通知されません。

●xat_aso_failure_event_svcname="サービスグループ名"，"サービス名"

アソシエーションの異常解放通知を受信するSPPのサービスグループ名とサービス名を指定します。

サービスグループ名　〜〈1〜31文字の識別子〉

アソシエーションの異常解放通知を受信する，SPPのサービスグループ名を指定します。

サービス名　〜〈1〜31文字の識別子〉

アソシエーションの異常解放通知を受信する，SPPのサービス名を指定します。

このオペランドで指定するサービスグループ名とサービス名は，xat_aso_con_event_svcnameオペランドおよびxat_aso_discon_event_svcnameオペランドで指定した，サービスグループ名およびサービス名と同じでもかまいません。同じサービスグループ名とサービス名を指定すると，アソシエーションの確立通知と解放通知を一つのサービス関数で受信できます。

このオペランドの指定を省略すると，通信イベントは通知されません。

●max_open_fds=OSI TP通信のアソシエーションによって使用されるFDSの最大値

　〜〈符号なし整数〉((16〜2016))《50》

OSI TP通信のアソシエーションで使われるFDSの最大値を指定します。TP1/NET/OSI-TP-Extendedのアソシエーション(コネクション)の数に依存します。指定値の範囲は，適用OSがAIX，HP-UXまたはWindowsの場合は16〜2016，適用OSがSolarisまたはLinuxの場合は16〜992です。

●max_socket_descriptors=XATMI通信サービスとUAPとの通信で使用されるFDSの最大値

　〜〈符号なし整数〉((4〜2047))《64》

XATMI通信サーバとOSI TP通信を利用するUAPとの間の通信で使用されるFDSの最大値を指定します。

指定値の範囲は，適用OSがAIX，HP-UXまたはWindowsの場合は32〜2032，適用OSがSolarisまたはLinuxの場合は32〜1008です。

次に示す計算式以上の値が適切です。

↑OSI TP通信を利用するUAPの数/0.8↑

↑↑：小数点以下を切り上げます。

コマンド形式

次ページ以降に記述しています。

xatsrvadd

名称

他システムが提供するサービス名の指定

形式

xatsrvadd -p "他AP名称" -q 他AE修飾子
          -s "サービス名"〔,"サービス名"〕…

機能

TP1/NET/OSI-TP-Extendedを使った，XATMIインタフェースでのOSI　TP通信を実行する場合に，他AP名称と他AE修飾子で示す他システムが提供するサービス名を指定します。

オプション

●-p　"他AP名称"

　〜〈1〜24文字の16進数字〉

TP1/NET/OSI-TP-Extendedのプロトコル固有定義で指定した，自システムが発呼側となる場合の，着呼側のAP名称を指定します。

TP1/NET/OSI-TP-Extendedのプロトコル固有定義については，マニュアル「OpenTP1 プロトコル TP1/NET/OSI-TP-Extended編」を参照してください。

●-q　他AE修飾子

　〜〈符号なし整数〉((0〜2147483647))

TP1/NET/OSI-TP-Extendedのプロトコル固有定義で指定した，自システムが発呼側となる場合の，着呼側のAE修飾子を指定します。

TP1/NET/OSI-TP-Extendedのプロトコル固有定義については，マニュアル「OpenTP1 プロトコル TP1/NET/OSI-TP-Extended編」を参照してください。

●-s　"サービス名"〔，"サービス名"〕…

　〜〈1〜31文字の識別子〉

他AP名称と他AE修飾子で示した他システムで提供される，サービス名を指定します。16文字を超える名称を指定できますが，先頭から15文字までが有効となります。

先頭15文字がシステム内で一意となる名称を指定してください。

複数のサービス名を指定する場合は，サービス名とサービス名との間をコンマ（,）で区切ります。

メッセージキューサービス定義

形式

set形式

〔set que_xidnum=同時実行トランザクション数〕
〔set que_io_maxrecsize=遅延書き込み最大レコード長〕

コマンド形式

{{quegrp -g  キューグループID  -f  物理ファイル名
       〔-n  入出力バッファ数〕〔-m  保持メッセージ数〕
       〔-w  使用容量警告率〕〔-c  警告解除使用率〕}}

機能

入出力メッセージのキューイングを管理するための実行環境を定義します。

ここでは，物理ファイルに関する情報だけを定義します。

キューファイルに関する情報は，MCFからの要求によってメッセージキューサービスが動的に追加します。

キューファイルとは，メッセージキューサービスが物理ファイル上に割り当てる論理的なファイルのことです。この論理的なファイルには，入力キュー用のキューファイルおよび出力キュー用のキューファイルの二つがあります。入力キュー用のキューファイルはサービスグループ単位に作成し，出力キュー用のキューファイルは論理端末単位に作成します。ただし，入力キューおよび出力キューを同一の物理ファイルに割り当てることはできません。

同一物理ファイル上に割り当てられた入力キューまたは出力キューは，同一定義下の環境（入出力バッファ数，保持メッセージ数など）を使用します。

説明

set形式のオペランド

●que_xidnum=同時実行トランザクション数

　〜〈符号なし整数〉((1〜4096))《256》

同時に実行するトランザクションの最大数を指定します。

メッセージキューを使用するMCFのメッセージ送受信を同時に実行するトランザクション数として，不足が発生しない数を指定します。

●que_io_maxrecsize=遅延書き込み最大レコード長

　〜〈符号なし整数〉((0〜32000))《0》（単位：バイト）

入出力メッセージを，物理ファイルへ遅延書き込みする場合，そのメッセージの最大レコード長を指定します。

0を指定した場合は，遅延書き込みをしません。

遅延書き込み要求を実行するためには，1トランザクションのメッセージの合計長より大きい値を指定する必要があります。

メッセージの合計長の計算式を次に示します。

メッセージの合計長=送受信メッセージ長＋ユーザ情報長＋セグメント数×16＋物理ファイル上のレコード数×36

ユーザ情報長とは，MCFがメッセージ単位に付加する情報の合計のことです。32ビットの場合，960バイト×メッセージ数，64ビットの場合，1,276バイト×メッセージ数で計算してください。

物理ファイル上のレコード数=↑（送受信メッセージ長＋ユーザ情報長＋メッセージ数×16）／物理ファイルのレコード長−36↑

↑↑：小数点以下を切り上げます。

コマンド形式

次ページ以降に記述しています。

quegrp

名称

メッセージキューファイルの指定

形式

{{quegrp -g  キューグループID   -f  物理ファイル名
       〔-n  入出力バッファ数〕〔-m  保持メッセージ数〕
       〔-w  使用容量警告率〕〔-c  警告解除使用率〕}}

機能

物理ファイルと物理ファイルに対応する環境（入出力バッファ数，保持メッセージ数など）の組をキューグループといい，キューグループごとに同一資源を使用します。キューグループに割り当てたIDをキューグループIDといいます。

キューグループIDと物理ファイル名は，ほかのキューグループと重複した指定はできません。

物理ファイル名は，ほかのメッセージキューサービス定義と重複した指定はできません。

オプション

●-g　キューグループID

　〜〈1〜8文字の識別子〉

物理ファイルに割り当てるキューグループIDを指定します。

MCFが，どの物理ファイルを使用するかを識別するために使用します。

入出力キュー定義（mcfmqgid -q）のquegrpidオペランド，論理端末定義（mcftalcle -k）のquegrpidオペランド（出力キューの場合），およびアプリケーション属性定義（mcfaalcap -g）のquegrpidオペランド（入力キューの場合）にこのキューグループIDを指定します。

●-f　物理ファイル名

　〜〈パス名〉

キューグループを構成する物理ファイル名を絶対パス名で指定します。ただし，環境変数は使用できません。

●-n　入出力バッファ数

　〜〈符号なし整数〉((2〜1024))《128》

キューグループを構成するバッファキャッシュ用の入出力バッファの個数を指定します。物理ファイルに複数のキューファイルを割り当てて，バッファキャッシュを行います。バッファキャッシュ用の入出力バッファは共用メモリを使用します。入出力バッファ数の指定が大きいほどディスクに対する入出力回数が少なくなります。

入出力バッファ数の計算式を次に示します。

NとMのうち，どちらか小さい方の値を指定します。

L=↑平均メッセージ長/物理ファイルのレコード長↑×1トランザクションの平均メッセージ数×同じ物理ファイルに割り当てているキューファイルを同時にアクセスするトランザクション数
N=L＋遅延書き込み時間間隔で，メッセージ有効化時遅延書き込み対象となるレコード数※
M=L＋↑遅延書き込み対象メッセージ長/物理ファイルのレコード長↑×保持メッセージ数×遅延書き込み対象となるメッセージの割合※×物理ファイルに割り当てているキューファイル数

↑↑：小数点以下を切り上げます。

注※

統計情報で値を取得しています。

●-m　保持メッセージ数

　〜〈符号なし整数〉((0〜1024))《10》

メッセージ送信後，UAPのdc_mcf_resend関数を使用して，ユーザがメッセージを再送したい場合に備えてキューファイルに残しておくメッセージの数を，キューグループごとに指定します。キューグループには最大で「指定した保持メッセージ数×キューファイル数（このキューグループを使用するサービスグループ数または論理端末数）」分のメッセージが保持されます。

MCF通信サービスがキューファイルからメッセージを読み出して送信したあとに，通信障害（相手システムとの回線および相手システム内でメッセージを失う）などが発生した場合，メッセージの再送が必要になるときがあります。再送するために再読み出しできるメッセージ数は，論理端末単位にここで指定した保持メッセージ数の範囲内です。

送信したメッセージ数がこのオペランドの指定数を超えた場合は，古いメッセージから再読み出しおよびメッセージの再送ができなくなります。

保持メッセージ数は，キューグループを出力キューとして使用する場合にだけ有効です。また，メッセージの再送を使用しない場合，メッセージを保持する必要はありません。キューグループを入力キューとして使用する場合，またはメッセージの再送を使用しない場合は，0を指定してください。

●-w　使用容量警告率

　〜〈符号なし整数〉((0〜95))《80》（単位：％）

物理ファイルの使用容量に対して警告を出すときの警告率を物理ファイルごとに指定します。

物理ファイルの使用容量（取り出し待ちメッセージと保持メッセージの容量）が，物理ファイルの容量のある一定の割合を超えた場合に，警告メッセージを出力します。

●-c　警告解除使用率

　〜〈符号なし整数〉((0〜95))《0》（単位：％）

物理ファイルの使用容量（取り出し待ちメッセージと保持メッセージの容量）に対して警告された状態を解除する使用率を，物理ファイルごとに指定します。

物理ファイルの使用率が，このオペランドに指定した値を下回った場合に，警告状態を解除します。解除後，再び使用容量警告率を超えたときは，警告メッセージを出力します。このオペランドに使用容量警告率以上の値を指定した場合，このオペランド値には使用容量警告率を仮定します。

ユーザサービスネットワーク定義

形式

set形式

なし。

コマンド形式

{{dcsvgdef  -g  サービスグループ名〔,サービスグループ名〕…
           {-h  ホスト名〔:ポート番号〕〔,ホスト名〔:ポート番号〕〕…
          〔-p  ポート番号〕
          〔-t  あて先再選択間隔〕〔-w〕}                    }}

機能

他ノードのTP1/Server Base管理下のSPPのサービスを，リモートAPI機能を介して利用する場合に，そのSPPのサービスグループ名とリモートAPI機能によるサービスの受信口となるホスト名およびポート番号を指定します。

または，all_nodeオペランドに指定していないノードのTP1/Server Base管理下のSPPのサービスを利用する場合に，そのSPPのサービスグループ名とそのSPPの存在するグローバルドメイン内の任意のノードのホスト名，およびスケジュールサービス定義のscd_portオペランドに指定したポート番号を指定します。複数のホスト名，ポート番号を指定することもできます（リモートAPI機能を利用する場合は複数を指定できません）。

ユーザサービス定義のrpc_destination_modeオペランドにnamd，またはdefinitionが指定されたUAPから呼び出されるdc_rpc_callのサービス要求を，ネームサーバへのあて先検索要求なしで実行します。

rpc_destination_modeオペランドにnamdが指定されたUAPは，ネームサーバへのあて先検索要求がエラーになった場合，この定義コマンドで指定された情報を基にサービス要求を実施します。rpc_destination_modeオペランドにdefinitionが指定され，かつこの定義コマンドで複数のホストが指定されたUAPは，この定義コマンドで指定された情報を基にサービス要求を実施し，エラーになった場合，ネームサーバへのあて先検索要求を実施します。この定義コマンドに指定されているホストが一つだけの場合は，ネームサーバへのあて先検索要求は実施しません。

OpenTP1は，ユーザサービス定義のrpc_destination_modeオペランドにnamdまたはdefinitionが指定されたUAPから呼び出されるdc_rpc_callについて，第1引数に指定されたサービスグループ名を，ユーザサービスネットワーク定義に指定されたサービスグループ名の中から検索します。サービスグループ名が一致する定義が見つかった場合，その定義に指定されているホストとポート番号へサービス要求を送信します。

複数のホスト名を指定した場合，OpenTP1はランダムにホストを選択してサービス要求を送信します。サービス要求の送信で障害が発生すると，残りのホスト名から再度ランダムにホストを選択します。すべてのホストへのサービス要求の送信が障害になると，dc_rpc_callはエラーリターンします。サービス要求が成功すると，UAP内で以降に呼び出す同じサービスグループ名へのdc_rpc_callは，あて先再選択間隔を指定していなければ，障害が発生するまで同じホストにサービス要求の送信を継続します。継続中のサービス要求の送信で障害になった場合，今回障害になったホストを除いたすべてのホスト名からランダムに選んだホストに対してサービス要求の送信を試みます。

なお，次の条件が成立する場合，次回に呼び出したdc_rpc_callで，OpenTP1はランダムにホストを選択してサービス要求を送信します。

rpc_destination_modeオペランドの指定をdefinition，または省略した場合

すべてのホストへのサービス要求の送信が障害になり，ネームサーバへのあて先検索要求もエラーとなったためdc_rpc_callがエラーリターンしたとき

すべてのホストへのサービス要求の送信が障害になり，ネームサーバへのあて先検索要求が成功してdc_rpc_callが成功したとき

rpc_destination_modeオペランドの指定がnamdで，次の条件をすべて満たす場合

ネームサーバへのあて先検索要求がエラー

すべてのホストへのサービス要求の送信が障害

dc_rpc_callがエラーリターン

次回に呼び出したdc_rpc_callでネームサーバへのあて先検索要求がエラー

複数のdcsvgdef定義コマンドに同じサービスグループ名を指定した場合，ユーザサービスネットワーク定義ファイルで先に記述されているdcsvgdef定義コマンドの指定が有効になります。リモートAPI機能を介して要求するサービスの情報か，all_nodeオペランドに指定していないノード上のサービスの情報かの区別は，-wオプションの指定の有無によって判断します。

dcsvgdef定義コマンドのサービスグループ名に対し，XATMIインタフェースでサービスを要求しないでください。この制限に反した場合の動作は保証されません。

-wオプションを指定しないdcsvgdef定義コマンドのサービスグループ（SPP）が，atomic_update=Nであり，このサービスグループに対して，トランザクション内からdc_rpc_callを発行した場合，dc_rpc_callはDCRPCER_TRNCHKでエラーリターンします。この場合，SPPのatomic_updateオペランドに'Y'を指定するか，dc_rpc_callのflagsにDCRPC_TPNOTRANを指定する必要があります。

-wオプションを指定しないdcsvgdef定義コマンドのサービスグループ名に対して，dc_rpc_callを実行し，性能検証用トレースを取得していた場合，サーバ側の性能検証用トレース情報とリンクしません。つまり，クライアントUAPで取得した性能検証用トレースの通番は，サーバ側に引き継がれないため，サーバ側で取得した性能検証用トレースには，新たに採番した通番が出力されます。

-wオプションを指定したdcsvgdef定義コマンドのサービスグループ名に対し，非同期RPCを要求した場合は，このユーザサービスネットワーク定義を無効とし，従来どおりネーム情報検索によって処理します。また，-wオプションを指定したdcsvgdef定義コマンドのサービスグループに対し，トランザクションとしてサービス要求しても，無条件に非トランザクションモードで処理します。

-wオプションを指定したdcsvgdef定義コマンドのサービスグループ名に対して，dc_rpc_callを実行した場合，RPCトレースは取得しません。ユーザサービスネットワーク定義でリモートAPI機能を介したノード上のサービスとして定義したサービスグループへのdc_rpc_callについては，クライアントUAPのシステム定義でRPCトレースの取得を指定しても，クライアントのトレース情報を取得しません。

-wオプションを指定したdcsvgdef定義コマンドのサービスグループ名に対して，dc_rpc_callを実行した場合，レスポンス統計情報／通信遅延時間統計情報は取得しません。ユーザサービスネットワーク定義によってリモートAPI機能を介したノード上のサービスとして，定義したサービスグループへのdc_rpc_callは，システム定義でレスポンス統計情報／通信遅延時間統計情報の取得を指定しても，統計情報を取得しません。

-wオプションを指定し，TP1/Server Base間でリモートAPI機能を使用する場合（例えば，アプリケーションゲートウェイ型ファイアウォールなどのゲートウェイを介してRPCをする場合など），トランザクション属性でdc_rpc_call関数を発行してもトランザクションにはなりません。したがって，トランザクション内から連鎖RPCを開始し，同期点処理で連鎖RPCを終了させる運用は，リモートAPI機能を使用した場合には正しく動作しません。flags引数にDCNOFLAGSを指定したdc_rpc_call関数で，明示的に連鎖RPCを終了するようにしてください。

説明

set形式

なし。

コマンド形式

次ページ以降に記述しています。

dcsvgdef

名称

通信相手のサービス情報の指定

形式

{{dcsvgdef  -g  サービスグループ名〔,サービスグループ名〕…
           {-h  ホスト名〔:ポート番号〕〔,ホスト名〔:ポート番号〕〕…
          〔-p  ポート番号〕
          〔-t  あて先再選択間隔〕〔-w〕}                    }}

機能

他ノードのTP1/Server Base管理下のSPPのサービスを，リモートAPI機能を介して利用する場合に，そのSPPのサービスグループ名とリモートAPI機能によるサービスの受信口となるホスト名およびポート番号を指定します。また，リモートAPI機能を使用するかどうかも指定します。

または，all_nodeオペランドに指定していないノードのTP1/Server Base管理下のSPPのサービスを利用する場合に，そのSPPのサービスグループ名とそのSPPの存在するグローバルドメイン内の任意のノードのホスト名，およびスケジュールサービス定義のscd_portオペランドに指定したポート番号を指定します。複数のホスト名，ポート番号を指定することもできます（リモートAPI機能を利用する場合は複数を指定できません）。

なお，SPPが稼働するサーバ側のTP1/Server Baseのバージョンは，03-03以降でなければなりません。

ユーザサービス定義のrpc_destination_modeオペランドにnamd，またはdefinitionが指定されたUAPから呼び出されるdc_rpc_callのサービス要求を，ネームサーバへのあて先検索要求なしで実行します。

rpc_destination_modeオペランドにnamdが指定されたUAPは，ネームサーバへのあて先検索要求がエラーになった場合，この定義コマンドで指定された情報を基にサービス要求を実施します。rpc_destination_modeオペランドにdefinitionが指定され，かつこの定義コマンドで複数のホストが指定されたUAPは，この定義コマンドで指定された情報を基にサービス要求を実施し，エラーになった場合，ネームサーバへのあて先検索要求を実施します。この定義コマンドに指定されているホストが一つだけの場合は，ネームサーバへのあて先検索要求は実施しません。

OpenTP1は，ユーザサービス定義のrpc_destination_modeオペランドにnamdまたはdefinitionが指定されたUAPから呼び出されるdc_rpc_callについて，第1引数に指定されたサービスグループ名を，ユーザサービスネットワーク定義に指定されたサービスグループ名の中から検索します。サービスグループ名が一致する定義が見つかった場合，その定義に指定されているホストとポート番号へサービス要求を送信します。

複数のホスト名を指定した場合，OpenTP1はランダムにホストを選択してサービス要求を送信します。サービス要求の送信で障害が発生すると，残りのホスト名から再度ランダムにホストを選択します。すべてのホストへのサービス要求の送信が障害になると，dc_rpc_callはエラーリターンします。サービス要求が成功すると，UAP内で以降に発行する同じサービスグループ名へのdc_rpc_callは，あて先再選択間隔を指定していなければ，障害が発生するまで同じホストにサービス要求の送信を継続します。継続中のサービス要求の送信で障害になった場合，障害になったホストを除いたすべてのホスト名からランダムに選んだホストに対してサービス要求の送信を試みます。

なお，次の条件が成立する場合，次回に呼び出したdc_rpc_callで，OpenTP1はランダムにホストを選択してサービス要求を送信します。

rpc_destination_modeオペランドの指定をdefinition，または省略した場合

すべてのホストへのサービス要求の送信が障害になり，ネームサーバへのあて先検索要求もエラーとなったためdc_rpc_callがエラーリターンしたとき

すべてのホストへのサービス要求の送信が障害になり，ネームサーバへのあて先検索要求が成功してdc_rpc_callが成功したとき

rpc_destination_modeオペランドの指定がnamdで，次の条件をすべて満たす場合

ネームサーバへのあて先検索要求がエラー

すべてのホストへのサービス要求の送信が障害

dc_rpc_callがエラーリターン

次回に呼び出したdc_rpc_callでネームサーバへのあて先検索要求がエラー

複数のホスト名を指定した場合の，dc_rpc_callの動作例を次の図に示します。

図3‒7　dcsvgdef定義コマンドで複数のホスト名を指定した場合のdc_rpc_callの動作例

複数のdcsvgdef定義コマンドに同じサービスグループ名を指定した場合，ユーザサービスネットワーク定義ファイルで先に記述されているdcsvgdef定義コマンドの指定が有効になります。リモートAPI機能を介して要求するサービスの情報か，all_nodeオペランドに指定していないノード上のサービスの情報かの区別は，-wオプションの指定の有無によって判断します。

dcsvgdef定義コマンドのサービスグループ名に対し，XATMIインタフェースでサービスを要求しないでください。この制限に反した場合の動作は保証されません。

-wオプションを指定しないdcsvgdef定義コマンドのサービスグループ（SPP）が，atomic_update=Nであり，このサービスグループに対して，トランザクション内からdc_rpc_callを発行した場合，dc_rpc_callはDCRPCER_TRNCHKでエラーリターンします。この場合，SPPのatomic_updateオペランドに'Y'を指定するか，dc_rpc_callのflagsにDCRPC_TPNOTRANを指定する必要があります。

-wオプションを指定しないdcsvgdef定義コマンドのサービスグループ名に対して，dc_rpc_callを実行し，性能検証用トレースを取得していた場合，サーバ側の性能検証用トレース情報とリンクしません。つまり，クライアントUAPで取得した性能検証用トレースの通番は，サーバ側に引き継がれないため，サーバ側で取得した性能検証用トレースには，新たに採番した通番が出力されます。

-wオプションを指定したdcsvgdef定義コマンドのサービスグループ名に対して，非同期RPCを要求した場合は，このユーザサービスネットワーク定義を無効とし，従来どおりネーム情報検索によって処理します。また，-wオプションを指定したdcsvgdef定義コマンドのサービスグループに対し，トランザクションとしてサービス要求しても，無条件に非トランザクションモードで処理します。

-wオプションを指定したdcsvgdef定義コマンドのサービスグループ名に対して，dc_rpc_callを実行した場合，RPCトレースは取得しません。ユーザサービスネットワーク定義でリモートAPI機能を介したノード上のサービスとして定義したサービスグループへのdc_rpc_callについては，クライアントUAPのシステム定義でRPCトレースの取得を指定しても，クライアントのトレース情報を取得しません。

-wオプションを指定したdcsvgdef定義コマンドのサービスグループ名に対して，dc_rpc_callを実行した場合，レスポンス統計情報／通信遅延時間統計情報は取得しません。ユーザサービスネットワーク定義によってリモートAPI機能を介したノード上のサービスとして，定義したサービスグループへのdc_rpc_callは，システム定義でレスポンス統計情報／通信遅延時間統計情報の取得を指定しても，統計情報を取得しません。

-wオプションを指定し，TP1/Server Base間でリモートAPI機能を使用する場合（例えば，アプリケーションゲートウェイ型ファイアウォールなどのゲートウェイを介してRPCをするなど），トランザクション属性でdc_rpc_call関数を発行してもトランザクションにはなりません。したがって，トランザクション内から連鎖RPCを開始し，同期点処理で連鎖RPCを終了させる運用は，リモートAPI機能を使用した場合には正しく動作しません。flags引数にDCNOFLAGSを指定したdc_rpc_call関数で，明示的に連鎖RPCを終了するようにしてください。

オプション

●-g　サービスグループ名

　〜〈1〜31文字の識別子〉

リモートAPI機能を介して利用するサービス，またはシステム共通定義のall_nodeオペランドで指定していないノード上のサービスの，サービスグループ名を指定します。このオプションは，「サービスグループ名の先頭にある文字（1文字以上）　＋　＊」の形式で，複数のサービスグループを一括して指定できます。

なお，all_nodeオペランドで指定していないノード上のサービスのサービスグループ名を指定する場合，このサービスはユーザサービス定義のreceive_fromオペランドでqueueを指定したSPPでなければなりません。

●-h　ホスト名:ポート番号

　〜〈1〜255文字の識別子〉

リモートAPI機能によるサービスの受信口となるホスト名，またはシステム共通定義のall_nodeオペランドで指定していないノードのOpenTP1の通信に使用するホスト名を指定します。識別子に使用できる文字は英数字ピリオド，およびハイフンです（ただし，IPアドレス形式は除く）。ホスト名は，/etc/hostsファイルまたはDNSなどで，IPアドレスとのマッピングができなければなりません。

ホスト名の後ろにコロンで区切ってポート番号を指定できます。ポート番号の有効範囲は5001〜65535です。ポート番号を省略した場合，-pオプションに指定したポート番号が仮定されます。-hオプションと-pオプションの両方のポート番号を省略することはできません。両方のポート番号を省略した場合，KFCA00340-Wのメッセージが出力されます。

コンマで区切り，複数のホスト名を指定できます。リモートAPI機能を利用する場合（-wオプションを指定した場合），複数のホスト名を指定することはできません。リモートAPI機能を利用する場合に，複数のホスト名を指定したときは， KFCA00340-Wのメッセージが出力されます。

このオプションにホスト名を一つだけ指定した場合，ユーザサービス定義のrpc_destination_modeオペランドにdefinitionを指定しても，ネームサーバへのあて先検索要求は実行されません。

●-p　ポート番号

　〜〈符号なし整数〉((1〜65535))

リモートAPI機能によるサービスの受信口となるポート番号，またはシステム共通定義のall_nodeオペランドで指定していないノード上のOpenTP1のスケジュールサービス定義のscd_portオペランドで指定したポート番号を指定します。

-wオプションを指定し，リモートAPI機能によるサービスの受信口となるポート番号を指定する場合は，1から65535の範囲のポート番号を指定できます。-wオプションを指定しないでスケジュールサービス定義のscd_portオペランドに指定したポート番号を指定する場合は，5001から65535の範囲のポート番号を指定できます。指定できない範囲のポート番号を指定した場合，KFCA00340-Wのメッセージが出力されます。

●-t　あて先再選択間隔

　〜〈符号なし整数〉((0〜65534))（単位：秒）

-hオプションに複数のホスト名を指定し，サービス要求の送信を継続しているとき，あて先をランダムに再選択する時間間隔を秒単位で指定します。

-hオプションにホスト名を一つだけ指定した場合，このオプションで指定した値は有効になりません。-hオプションに指定したあて先へのサービス要求の送信が成功し，あて先との通信を開始したあと，あて先へのサービス要求の送信ごとに，このオプションに指定した時間以上経過しているかどうか判定します。このオプションに指定した時間以上経過していた場合，あて先をランダムに再選択します。このオプションに指定した時間以上経過していても，あて先へのサービス要求の送信が行われていなければ再選択は行いません。

なお，あて先の再選択で，再選択前と同一のあて先を選択する場合があります。このオプションに0を指定した場合，サービス要求の送信ごとにあて先をランダムに再選択します。このオプションを省略した場合，サービス要求が成功した送信先で障害が発生するまで同じあて先にサービス要求の送信を継続します。

あて先と通信を開始したあとの経過時間を次に示します。

ユーザサービス定義のrpc_destination_modeオペランドにdefinitionを指定した場合

経過時間の開始は，-hオプションに指定されたあて先にサービス要求の送信が成功した時刻です。サービス要求の送信で障害が発生した場合，経過時間の開始は，残りのホスト名からランダムにあて先を選択し，サービス要求の送信が成功した時刻になります。ネームサーバのあて先検索で取得したあて先にサービス要求の送信が成功した場合，この時間は経過時間に含まれません。

ユーザサービス定義のrpc_destination_modeオペランドにdefinitionを指定した場合の経過時間について次に示します。

図3‒8　ユーザサービス定義のrpc_destination_modeオペランドにdefinitionを指定した場合の経過時間

ユーザサービス定義のrpc_destination_modeオペランドにnamdを指定した場合

経過時間の開始は，-hオプションに指定されたあて先にサービス要求の送信が成功した時刻です。サービス要求の送信を継続し，ネームサーバのあて先検索で取得したあて先にサービス要求の送信が成功した場合，この時間も経過時間に含みます。

ユーザサービス定義のrpc_destination_modeオペランドにnamdを指定した場合の経過時間について次に示します。

図3‒9　ユーザサービス定義のrpc_destination_modeオペランドにnamdを指定した場合の経過時間

連鎖RPCを使用した場合

経過時間の開始は，-hオプションに指定されたあて先に連鎖RPC開始サービス要求の送信が成功した時刻です。あて先をランダムに再選択するかどうかの判定は，新たな連鎖RPC開始サービス要求の送信で行います。連鎖RPC中のサービス要求の送信，連鎖RPC終了サービス要求の送信では，判定を行いません。

連鎖RPCを使用した場合の経過時間について次に示します。

図3‒10　連鎖RPCを使用した場合の経過時間

●-w

リモートAPI機能を使用する場合に指定します。このオプションを指定すると，-hおよび-pオプションで指定した値が，リモートAPI機能によるサービスの受信口の情報であることを示します。

rapリスナーサービス定義

形式

set形式

  set rap_listen_port=rapリスナーポート番号
〔set rap_parallel_server=rapサーバ数〕
〔set rap_watch_time=メッセージ送受信最大監視時間〕
〔set rap_inquire_time=問い合わせ間隔最大時間〕
〔set nice=プロセスの優先順位の変更〕
〔set uap_trace_max=UAPトレース格納最大数〕
  set uid=OpenTP1管理者のユーザ識別子
〔set rpc_response_statistics=Y|N〕
〔set rpc_trace=Y|N〕
〔set rpc_trace_name="RPCトレースを取得するファイル名"〕
〔set rpc_trace_size=RPCトレースを取得するファイルのサイズ〕
〔set trn_expiration_time=トランザクションブランチ限界経過時間〕
〔set trn_expiration_time_suspend=Y|N|F〕
〔set trn_cpu_time=トランザクションブランチCPU監視時間〕
〔set trf_put=Y|N〕
〔set trn_statistics_item=統計情報項目〔,統計情報項目〕…〕
〔set trn_optimum_item=トランザクション最適化項目
                    〔,トランザクション最適化項目〕…〕
〔set trn_watch_time=トランザクション同期点処理時の最大通信待ち時間〕
〔set trn_rollback_information_put=no|self|remote|all〕
〔set trn_limit_time=トランザクションブランチ最大実行可能時間〕
〔set trn_rollback_response_receive=Y|N〕
〔set trn_partial_recovery_type=type1|type2|type3〕
〔set rap_inquire_timeout_message=Y|N〕
〔set rap_connection_assign_type=dynamic|static〕
〔set rap_max_client=rapリスナーに同時接続する最大クライアント数〕
〔set rap_notify=Y|N〕
〔set rap_client_manager_node="ホスト名:ポート番号"
                           〔,"ホスト名:ポート番号"〕…〕
〔set rap_max_buff_size=ソケットウィンドウサイズ〕
〔set rap_io_retry_interval=電文送受信時のリトライ間隔〕
〔set rap_sock_count=ソケット生成処理のリトライ回数〕
〔set rap_sock_interval=ソケット生成処理のリトライ間隔〕
〔set rap_connect_retry_count=コネクション確立処理のリトライ回数〕
〔set rap_connect_retry_interval=コネクション確立処理のリトライ間隔〕
〔set rap_listen_backlog=接続待ちキューに保留できる最大要求数〕
〔set rap_msg_output_interval=クライアント数表示メッセージの出力間隔〕
〔set rap_recovery_server=リカバリ要求用待機rapサーバ数〕
〔set rap_connect_interval=コネクション確立処理の間隔〕
〔set rpc_extend_function=RPCサービスの機能拡張レベル〕
〔set max_socket_descriptors=ソケット用ファイル記述子の最大数〕
〔set trn_completion_limit_time=トランザクション完了限界時間〕
〔set rap_message_id_change_level=メッセージIDの変更レベル〕
〔set rap_term_disconnect_time=
                         rapリスナー終了時のコネクション切断待ち時間〕
〔set rap_stay_watch_time=rapサーバ割り当て待ち要求の滞留監視時間〕
〔set rap_stay_warning_interval=滞留警告メッセージの出力間隔〕
〔set log_audit_out_suppress=Y|N〕
〔set log_audit_message=監査ログを取得する項目のメッセージID
                     〔,監査ログを取得する項目のメッセージID〕…〕
〔set ipc_sockctl_highwater=
                       ソケットの一時クローズ処理開始数パーセンテージ
                    〔,ソケットの一時クローズ処理非対象数パーセンテージ〕〕
〔set ipc_sockctl_watchtime=ソケット再利用可能監視時間〕
〔set scs_prf_trace_level=リモートAPI機能における性能検証用トレース取得レベル〕
〔set rap_extend_function=リモートAPI機能の機能拡張レベル〕
〔set watch_time=最大応答待ち時間〕

コマンド形式

なし。

機能

リモートAPI機能を使用する場合のrapリスナーサービスを指定します。この定義を指定してから，rapdfgenコマンドを実行すると，リモートAPI機能を使用するのに必要なrapリスナー用ユーザサービス定義およびrapサーバ用ユーザサービス定義が自動的に作成されます。

説明

set形式のオペランド

●rap_listen_port=rapリスナーポート番号

　〜〈符号なし整数〉((5001〜65535))

rapリスナーおよびrapサーバが使用するウェルノウンポート番号を指定します。rapリスナーを複数起動する場合はそれぞれのポート番号が重複しないように指定してください。

このオペランドで指定するポート番号は，ほかのプログラムと重複しないようにしてください。

また，OSには任意に割り当てる番号がありますが，この番号も使用しないでください。OSが任意に割り当てる番号は，OSの種別やバージョンによって異なります。詳細については，使用しているOSのマニュアルを参照してください。

●rap_parallel_server=rapサーバ数

　〜〈符号なし整数〉((1〜1024))《1》

該当するrapリスナーが管理するrapサーバのサーバ数を指定します。

●rap_watch_time=メッセージ送受信最大監視時間

　〜〈符号なし整数〉((0〜65535))《180》（単位：秒）

rapリスナーおよびrapサーバがメッセージの送受信を開始し始めてから，送受信が完了するまでの監視時間を指定します。監視時間が経過してもメッセージの送受信が完了しない場合はメッセージを出力し，ネットワーク障害と同様の処理を行います。

0を指定した場合は，時間監視をしません。

●rap_inquire_time=問い合わせ間隔最大時間

　〜〈符号なし整数〉((0〜1048575))《180》（単位：秒）

クライアントがrapリスナーおよびrapサーバに問い合わせ応答をしてから次の問い合わせが来るまでの間隔の最大待ち時間を指定します。この値はrapリスナーまたはrapサーバ側で監視するタイマであり，指定時間を超えても問い合わせがない場合，クライアントがダウンしたとして処理します。

0を指定した場合は，無限に待ちます。

常駐SPPからリモートAPI機能を使用している場合，このオペランドまたはユーザサービス定義のrpc_rap_inquire_timeオペランドに0を指定しないでください。指定した場合，rapリスナーが存在するノードのOpenTP1システムを終了させようとしても，rapリスナーが終了できないため，常駐SPPが終了するまで無限に待ち続けます。

SPPまたはSUPのユーザサービス定義でrpc_rap_inquire_timeオペランドの指定を省略した場合，このオペランドで指定した値が最大待ち時間となります。どちらも省略した場合は，180秒を仮定します。

●nice=プロセスの優先順位の変更

　〜〈符号なし整数〉((0〜39))《0》

このサービスグループプロセスのnice値に加える値を指定します。プロセスのnice値は正の整数で，この値が大きくなるとCPUの優先順位は低くなります。niceの詳細については，ユーザの使用するOSの，該当するマニュアルを参照してください。

●uap_trace_max=UAPトレース格納最大数

　〜〈符号なし整数〉((0〜4095))《32》

UAPトレースの最大格納数を指定します。

0を指定した場合

UAPトレースを取得しません。

1以上を指定した場合

指定値+1のUAPトレースを取得します。

UAPトレースデータファイルまたは退避コアファイルに，UAPトレースの情報として次の情報を取得します。

サービス関数の開始

サービス関数の終了

OpenTP1のライブラリ関数の入り口または出口※

注※

OpenTP1のライブラリ関数がリターンするときは，入り口情報を取得した領域を出口情報で上書きするため，UAPトレースの格納数は1となります。ただし，TP1/Message Queue，およびオンラインテスタ（TP1/Online Tester）を使用している場合は，OpenTP1のライブラリ関数の入り口情報と出口情報で別の領域となるため，UAPトレースの格納数は2となります。

UAPトレースを参照することで，次に示す処理の流れを解析できます。

UAPが正常終了までに行った処理の流れ

UAPの異常終了時，障害が発生するまでにUAPが行った処理の流れ

この解析によって，ユーザはUAPに障害が起こった原因を解析でき，UAPを修正したり，システムを再構築したりする目安にできます。

UAPトレースの詳細については，マニュアル「OpenTP1　テスタ・UAPトレース使用の手引」を参照してください。

●uid=OpenTP1管理者のユーザ識別子

　〜〈符号なし整数〉((0〜4294967294))

このサービスグループのプロセス所有者となるユーザIDを指定します。

この場合，OpenTP1管理者のユーザ識別子を指定してください。

最大値はOSに依存するので，使用しているOSのマニュアルを参照してください。

●rpc_response_statistics=Y|N

　〜《N》

レスポンス統計情報を取得するかどうかを指定します。

Y

レスポンス統計情報を取得します。

N

レスポンス統計情報を取得しません。

レスポンス統計情報は，RPCコールのレスポンスタイム，サービスの実行時間，およびサーバのCPU時間などを取得します。

●rpc_trace=Y|N

RPCトレースを取得するかどうかを指定します。

Y

RPCトレースを取得します。

N

RPCトレースを取得しません。

このオペランドは，システム共通定義，またはユーザサービスデフォルト定義でも指定できます。

指定値の優先順位は次のとおりです（1.＞2.＞3.）。

rapリスナーサービス定義

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

システム共通定義

RPCトレースを取得した場合，処理速度が低下し，RPCがタイムアウトでエラーリターンすることがあります。その場合は，状況に応じて次の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.の最大応答待ち時間を使用してください。

また，rapリスナーサービス定義のrpc_traceオペランドを指定した場合，rapサーバが代理実行したサービス要求の送受信電文だけを取得でき，rapクライアントからrapサーバが受信した電文は取得できません。

●rpc_trace_name="RPCトレースを取得するファイル名"

　〜〈パス名〉

RPCトレースを取得するファイルのパス名を指定します。

パス名のうち，RPCトレースを取得するファイル名（デフォルトはrpctr）の最大長は，13文字です。

パス名に環境変数を指定する場合，パス名の先頭に環境変数を指定してください（指定例：$DCDIR/tmp/ファイル名）。

このオペランドは，システム共通定義でも指定できます。rapリスナーサービス定義で指定した場合は，rapリスナーサービス定義で指定した値が優先されます。

●rpc_trace_size=RPCトレースを取得するファイルのサイズ

　〜〈符号なし整数〉((1024〜2147483648))（単位：バイト）

RPCトレースを取得するファイルのサイズを指定します。

このオペランドは，システム共通定義でも指定できます。rapリスナーサービス定義で指定した場合は，rapリスナーサービス定義で指定した値が優先されます。

●trn_expiration_time=トランザクションブランチ限界経過時間

　〜〈符号なし整数〉((0〜65535))（単位：秒）

トランザクションブランチの処理を監視する限界経過時間を指定します。指定時間を超えた場合は，このトランザクションブランチのプロセスは異常終了して，ロールバックされます。0を指定した場合は，時間監視しません。

なお，このオペランドは，トランザクションサービス定義またはユーザサービスデフォルト定義でも指定できます。

指定値の優先順位は次のとおりです（1.＞2.＞3.）。

rapリスナーサービス定義

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

トランザクションサービス定義

また，これらの定義のほかに関数を発行して監視時間を指定することもできます。

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

●trn_expiration_time_suspend=Y|N|F

トランザクションブランチの処理を監視するとき，次の処理時間も監視時間に含むかどうかを指定します。

監視対象のトランザクションブランチが，RPC機能を使ってほかのトランザクションブランチを呼び出し，その処理が終わるのを待つ時間

連鎖RPCで呼び出されたサーバUAPが，次のサービス要求を待つ時間

監視対象のトランザクションブランチが，非同期RPCを使用してほかのトランザクションブランチを呼び出したあと，処理結果受信処理を行っている時間

Y

1.，2.，3.のすべてを監視時間に含みます。

N

3.だけを監視時間に含みます。

F

1.，2.，3.のどれも監視時間に含みません。

このオペランドは，トランザクションサービス定義，またはユーザサービスデフォルト定義でも指定できます。

指定値の優先順位は次のとおりです（1.＞2.＞3.）。

rapリスナーサービス定義

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

トランザクションサービス定義

このオペランドと各種タイマ監視との関係については，「付録A.2　トランザクションの時間監視」を参照してください。

●trn_cpu_time=トランザクションブランチCPU監視時間

　〜〈符号なし整数〉((0〜65535))（単位：秒）

トランザクションブランチが同期点処理までに使用できるCPU時間を指定します。0を指定した場合は，時間監視しません。指定時間を超えた場合は，該当するトランザクションブランチのプロセスを異常終了し，ロールバックします。

なお，このオペランドは，トランザクションサービス定義またはユーザサービスデフォルト定義でも指定できます。

指定値の優先順位は次のとおりです（1.＞2.＞3.）。

rapリスナーサービス定義

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

トランザクションサービス定義

●trf_put=Y|N

該当するサーバで起動されたトランザクションが出力したジャーナルをトランザクションリカバリジャーナルに出力するかどうかを指定します。

Y

トランザクションリカバリジャーナルファイルに出力します。

N

トランザクションリカバリジャーナルファイルに出力しません。

トランザクションリカバリジャーナルファイルを作成すると，長時間トランザクションによって発生するジャーナル障害を防止でき，またリラン時間を短縮できます。ただし，この機能は，性能，およびメモリへのオーバヘッドがあるので，長時間トランザクションを使用するサーバの場合に指定してください。

系切り替え機能を使用するOpenTP1システムでは，この機能を使用できないため，rapリスナーサービス定義およびユーザサービス定義のtrf_putオペランドにはNを指定してください。

●trn_statistics_item=統計情報項目〔，統計情報項目〕…

トランザクションブランチの統計情報を取得する項目を指定します。

nothing

統計情報を取得しません。

base

基本情報として，次の情報を取得します。

トランザクションブランチの識別子

トランザクションブランチの決着結果

トランザクションブランチの実行プロセス種別

トランザクションブランチの実行サーバ名

トランザクションブランチの実行サービス名

executiontime

基本情報とトランザクションブランチの実行時間情報を取得します。

cputime

基本情報とトランザクションブランチのCPU時間情報を取得します。

nothingの指定は，一つしかできません。また，nothingとほかの統計情報項目を同時に指定した場合，nothingの指定は無効になります。

トランザクションに関する統計情報を取得するときは次のどれかを指定してください。

trn_tran_statisticsオペランドにYを指定

trnsticsコマンドで-sオプションを指定

なお，このオペランドは，トランザクションサービス定義またはユーザサービスデフォルト定義でも指定できます。

指定値の優先順位は次のとおりです（1.＞2.＞3.）。

rapリスナーサービス定義

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

トランザクションサービス定義

●trn_optimum_item=トランザクション最適化項目〔，トランザクション最適化項目〕…

複数のユーザサーバで構成されるグローバルトランザクションの性能を向上させるための最適化項目を，次の文字列で指定します。

base

同期点処理全体（プリペア処理，コミット処理，およびロールバック処理）を最適化します。OpenTP1のトランザクション制御は2相コミット方式で実行しているため，二つのトランザクションブランチ間のコミット制御には，4回のプロセス間通信が必要となります。

次の条件をすべて満たす場合，親トランザクションブランチが子トランザクションブランチのコミット処理を代わりに実行することで，コミット制御で必要な4回のプロセス間通信を削減します。

親トランザクションブランチと，子トランザクションブランチが同一OpenTP1下にあること。

親トランザクションブランチが，子トランザクションブランチを同期応答型RPCで呼び出していること。

子トランザクションブランチでアクセスしたリソースマネジャのXAインタフェース用オブジェクトが，親トランザクションブランチにもリンケージされていること。

asyncprepare

baseの指定条件を満たしていないため同期点処理全体の最適化ができない場合に，プリペア処理を最適化します。

次の条件をすべて満たす場合，親トランザクションブランチから発行されたRPCによって子トランザクションブランチがサービス要求を実行したときに，RPCのリターン前にプリペア処理を実行することで，2回のプロセス間通信を削減します。

baseを指定した最適化ができないこと。

親トランザクションブランチが，子トランザクションブランチを同期応答型RPCで呼び出していること。

ただし，この最適化を実行した場合，親トランザクションブランチが発行した同期応答型RPCの応答時間が遅くなります。また，子トランザクションブランチは，プリペア処理からコミット処理までの間隔（親トランザクションブランチからの指示がないとトランザクションを決着できない状態）が大きくなります。そのため，親トランザクションブランチのOpenTP1がシステムダウンし，トランザクションブランチ間の連絡ができなくなると，ジャーナルファイルのスワップやチェックポイントダンプファイルの有効化が遅れ，子トランザクションブランチのOpenTP1もシステムダウンする場合があります。

トランザクション最適化項目は，重複して指定できます。ただし，優先順位は次のようになります（1.＞2.）。

base

asyncprepare

なお，このオペランドは，トランザクションサービス定義またはユーザサービスデフォルト定義でも指定できます。

指定値の優先順位は次のとおりです（1.＞2.＞3.）。

rapリスナーサービス定義

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

トランザクションサービス定義

●trn_watch_time=トランザクション同期点処理時の最大通信待ち時間

　〜〈符号なし整数〉((1〜65535))（単位：秒）

トランザクションの同期点処理で，トランザクションブランチ間で行う通信（プリペア，コミット，ロールバック指示，または応答など）の受信待ち時間の最大値を指定します。

指定時間を過ぎても指示または応答がない場合は，該当するトランザクションブランチが2相コミットの1相目完了前であればロールバックさせ，1相目完了後であればトランザクションサービスのシステムプロセスでトランザクション決着処理を再試行します。

このオペランドは，トランザクションサービス定義またはユーザサービスデフォルト定義でも指定できます。

指定値の優先順位は次のとおりです（1.＞2.＞3.）。

rapリスナーサービス定義

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

トランザクションサービス定義

これらのすべての定義でこのオペランドを省略した場合，トランザクションを行ったユーザサーバのwatch_timeの値を仮定します。ただし，trn_watch_timeには0秒を指定できないため，ユーザサーバのwatch_timeに0秒を指定した場合はtrn_watch_timeのデフォルト値である120秒を仮定します。

●trn_rollback_information_put=no|self|remote|all

トランザクションブランチがロールバックした場合に，ロールバック要因に関する情報をログに取得するかどうかを指定します。

no

ロールバック情報を取得しません。

self

ロールバック要因が発生したトランザクションブランチでだけ，ログにロールバック情報を取得します。

remote

selfに加え，他ノードのトランザクションブランチからロールバック要求されたトランザクションブランチでも，ログにロールバック情報を取得します。

all

remoteに加え，自ノードのトランザクションブランチからロールバック要求されたトランザクションブランチでも，ログにロールバック情報を取得します。

このオペランドは，トランザクション定義またはユーザサービスデフォルト定義でも指定できます。

指定値の優先順位は次のとおりです（1.＞2.＞3.）。

rapリスナーサービス定義

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

トランザクションサービス定義

●trn_limit_time=トランザクションブランチ最大実行可能時間

　〜〈符号なし整数〉((0〜65535))（単位：秒）

トランザクションブランチの最大実行可能時間を指定します。

トランザクションブランチを開始してから同期点処理が終了するまでの時間が，このオペランド指定時間を超えないようにdc_rpc_call関数，dc_rpc_poll_any_replies関数および同期点処理内で行う通信のタイムアウト時間を次のように自動設定します。

dc_rpc_call関数およびdc_rpc_poll_any_replies関数のタイムアウト時間

「K≧このオペランド指定時間」の場合は，要求処理を実行しないで，タイムアウトでエラーリターンします。

「K＜このオペランド指定時間」でかつ「（このオペランド指定時間−K）≧W」の場合は，Wをタイムアウト時間とします。

「K＜このオペランド指定時間」でかつ「（このオペランド指定時間−K）＜W」の場合は，（このオペランド指定時間−K）をタイムアウト時間とします。

K

現時刻−トランザクションブランチ開始時刻

W

dc_rpc_call関数の場合はwatch_timeオペランド指定時間

dc_rpc_poll_any_replies関数の場合は引数timeout指定時間

同期点処理内で行う通信のタイムアウト時間

「K≧このオペランド指定時間」の場合は，タイムアウト時間を1秒とします。

「K＜このオペランド指定時間」でかつ「（このオペランド指定時間−K）≧W」の場合は，Wをタイムアウト時間とします。

「K＜このオペランド指定時間」でかつ「（このオペランド指定時間−K）＜W」の場合は，（このオペランド指定時間−K）をタイムアウト時間とします。

K

現時刻−トランザクションブランチ開始時刻

W

trn_watch_timeオペランド指定時間

trn_watch_timeオペランドを省略した場合はwatch_timeオペランド指定時間

上記の受信待ち以外の処理で時間が掛かった場合は，このオペランド指定時間以内にトランザクションブランチが終了しないことがあります。

同期点処理開始前にこのオペランドの指定時間が経過した場合，そのトランザクションはロールバックします。

0を指定した場合は，時間監視をしません。

なお，このオペランドは，トランザクションサービス定義またはユーザサービスデフォルト定義でも指定できます。指定値の優先順位は次のとおりです（1.＞2.＞3.）。

rapリスナーサービス定義

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

トランザクションサービス定義

●trn_rollback_response_receive=Y|N

　〜《Y》

RPC先トランザクションブランチにロールバック指示を送信したあと，ロールバック完了通知を受信するかどうかを指定します。Nを指定した場合，RPC先トランザクションブランチからのロールバック完了通知を受信しないで（RPC先トランザクションブランチのロールバック処理の完了を待たないで）自トランザクションブランチを終了します。

ここで指定を省略し，ユーザサービスデフォルト定義でも省略した場合，トランザクションサービス定義の値を仮定します。

●trn_partial_recovery_type=type1|type2|type3

UAP障害時のトランザクション同期点処理方式を指定します。

RPCがタイムアウトし，RPC発行先プロセスのアドレスが未解決の場合やトランザクション実行中のUAPがダウンした場合に，トランザクションブランチ間の連絡がスムーズにできないで，トランザクションの決着に時間が掛かることがあります。

このオペランドでは，次に示す障害が発生した場合のトランザクション同期点処理方式を，指定値に示す三つの方式から選択して指定します。

（障害1）RPCがタイムアウトした場合

この場合，RPC発行元トランザクションブランチは，サービス要求がどのプロセスで実行されているかがわからないため，RPC発行先トランザクションブランチにトランザクション同期点メッセージを送信できません。そのため，RPC発行元トランザクションブランチおよびRPC発行先トランザクションブランチがトランザクション同期点メッセージ待ちとなり，トランザクションの決着に時間が掛かります。

（障害2）RPC発行元UAPがRPCの応答受信前にダウンした場合

この場合，RPC発行元トランザクションブランチは，サービス要求がどのプロセスで実行されているかがわからないため，RPC発行先トランザクションブランチにトランザクション同期点メッセージを送信できません。そのため，RPC発行先トランザクションブランチはトランザクション同期点メッセージ待ちとなり，トランザクションの決着に時間が掛かります。

（障害3）RPC発行先UAPからの応答受信後にRPC発行元UAPとRPC発行先UAPがほぼ同時にダウンした場合

この場合，それぞれのトランザクションブランチを引き継いだトランザクション回復プロセスは，相手UAPプロセスのダウンを知らないため，すでに存在しないUAPプロセスにトランザクション同期点メッセージを送信してしまい，トランザクションの決着に時間が掛かることがあります。

type1

（障害1）が発生した場合，RPC発行元トランザクションブランチおよびRPC発行先トランザクションブランチは，トランザクション同期点メッセージ受信処理がタイムアウトすることによって，トランザクションを決着します。

（障害2）が発生した場合，RPC発行元トランザクションブランチは，RPC発行先トランザクションブランチにトランザクション同期点メッセージを送信しないでトランザクションを決着します。RPC発行先トランザクションブランチは，トランザクション同期点メッセージ受信処理がタイムアウトすることによって，トランザクションを決着します。

（障害3）が発生した場合，RPC発行元トランザクションブランチおよびRPC発行先トランザクションブランチは，トランザクション同期点メッセージ受信処理がタイムアウトすることによって，トランザクションを決着します。

type2

（障害1）が発生してトランザクションをコミットする場合はtype1と同じです。

（障害1）が発生してトランザクションをロールバックする場合，または（障害2）が発生した場合は，RPC発行元トランザクションブランチは，RPC発行先トランザクションブランチが存在するノードのトランザクションサービスプロセスにトランザクション同期点メッセージを送信後，トランザクションを決着します。トランザクション同期点メッセージを受信したトランザクションサービスプロセスは，該当するトランザクションブランチを処理中のプロセスに，トランザクション同期点指示を送信します。

（障害3）が発生した場合，RPC発行元トランザクションブランチおよびRPC発行先トランザクションブランチは，トランザクション同期点メッセージ受信処理がタイムアウトすることによって，トランザクションを決着します。

type3

（障害1）が発生してトランザクションをコミットする場合は，type1と同じです。

（障害1）が発生してトランザクションをロールバックする場合，（障害2）が発生した場合，または（障害3）が発生した場合，相手トランザクションブランチが存在するノードのトランザクションサービスプロセスに，トランザクション同期点メッセージを送信します。トランザクション同期点メッセージを受信したトランザクションサービスプロセスは，該当するトランザクションブランチを処理中のプロセスに，トランザクション同期点指示を送信します。

次に示す場合，このオペランドにtype2またはtype3を指定しても，トランザクションの決着に時間が掛かることがあります。

RPC実行中に，RPC発行先UAPの状態が変更となり（負荷増加，UAP終了，UAP閉塞など），ほかのノードの同一UAPにサービス要求が再転送された場合

相手先のOpenTP1がこのオプションをサポートしていないバージョンの場合

相手先トランザクションブランチがトランザクション同期点メッセージ受信処理以外で時間が掛かっている場合

TP1/Server BaseまたはTP1/LiNK以外とトランザクション連携をする場合，このオペランドにはtype1を指定または省略してください。

なお，このオペランドは，トランザクションサービス定義またはユーザサービスデフォルト定義でも指定できます。

指定値の優先順位は次のとおりです（1.＞2.＞3.）。

rapリスナーサービス定義

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

トランザクションサービス定義

●rap_inquire_timeout_message=Y|N

　〜《Y》

クライアントからの要求最大待ち時間が満了したことを検知したとき，エラーメッセージを出力するかどうかを指定します。このオペランドにYを指定するか，省略した場合は，エラーメッセージを出力します。

Y

クライアントからの要求最大待ち時間が満了したことを検知したとき，エラーメッセージを出力します。

N

クライアントからの要求最大待ち時間が満了したことを検知したとき，エラーメッセージを出力しません。

なお，このオペランドで抑止されるメッセージは次のとおりです。

KFCA26956-Wメッセージの理由コード=71

KFCA26965-Eメッセージの理由コード=71

●rap_connection_assign_type=dynamic|static

　〜《static》

ダイナミックコネクションスケジュール機能を使用するかどうかを指定します。

dynamic

ダイナミックコネクションスケジュール機能を使用します。

static

ダイナミックコネクションスケジュール機能を使用しません。

ダイナミックコネクションスケジュール機能を使用しサーバ負荷が高くなると，スタティックコネクションスケジュール機能に比べてレスポンス性能が劣化する場合があります。また，ダイナミックコネクションスケジュール機能を使用している場合，コネクト要求以外の要求はrapサーバで処理します(コネクト要求だけrapリスナーが受け持ちます)。したがって，クライアントが要求を行ったとき割り当てられるrapサーバがない場合，その要求はrapリスナーで保留されたままになります。rapサーバから代理実行要求されるdc_rpc_callに長い時間が掛かる場合や，トランザクション状態で走行するクライアントがある場合などは，起動するrapサーバ数に注意してください。起動するrapサーバが少ない場合，クライアントからの要求はタイムアウトでエラーリターンすることがあります。

●rap_max_client=rapリスナーに同時接続する最大クライアント数

　〜〈符号なし整数〉((128〜1024))《256》

rapリスナーに同時接続する最大クライアント数を指定します。

●rap_notify=Y|N

　〜《N》

自ノードのrapリスナー起動時に，rap_client_manager_nodeオペランドで指定したノードで起動するrapクライアントマネジャに対し起動通知を行うかどうかを指定します。

Y

起動通知します。

N

起動通知しません。

Yを指定した場合，rap_client_manager_nodeオペランドの指定を省略できません。

●rap_client_manager_node="ホスト名:ポート番号"〔,"ホスト名:ポート番号"〕…

rap_notifyオペランドにYを指定して起動通知機能を使用する場合は，このオペランドに指定したノードで起動するOpenTP1のrapクライアントマネジャへ起動通知を行います。起動通知機能を使用すると，コネクション確立時期を管理でき，確実に送信できるようになります。

rap_notifyオペランドにYを指定した場合，このオペランドの指定を省略できません。

ホスト名

　〜〈1〜255文字の英数字，ピリオド，およびハイフン〉

自ノードのrapリスナーに接続するrapクライアントを持つ，OpenTP1システムのホスト名を指定します。ホスト名とは，/etc/hostsに定義したホスト名のことです。

ポート番号

　〜〈符号なし整数〉((1〜65535))

自ノードのrapリスナーに接続するrapクライアントを持つ，OpenTP1システムのrapクライアントマネジャのポート番号を指定します。

●rap_max_buff_size=ソケットウィンドウサイズ

　〜〈符号なし整数〉((4〜2147483647))《4》（単位：キロバイト）

ソケットのウィンドウサイズを指定します。

●rap_io_retry_interval=電文送受信時のリトライ間隔

　〜〈符号なし整数〉((1〜999))《35》（単位：ミリ秒）

電文送受信時のリトライ間隔を指定します。

●rap_sock_count=ソケット生成処理のリトライ回数

　〜〈符号なし整数〉((0〜65535))《1》

ソケット生成処理でEAGAIN，EWOULDBLOCKエラーが発生した場合，ソケット生成処理のリトライ回数を指定します。

●rap_sock_interval=ソケット生成処理のリトライ間隔

　〜〈符号なし整数〉((15〜500))《30》（単位：ミリ秒）

ソケット生成処理でEAGAIN，EWOULDBLOCKエラーが発生した場合，ソケット生成処理のリトライ間隔を指定します。

●rap_connect_retry_count=コネクション確立処理のリトライ回数

　〜〈符号なし整数〉((8〜2147483647))《8》

通信制御部のコネクション確立処理で，ECONNREFUSEDエラーが発生した場合，コネクション確立処理のリトライ回数を指定します。

●rap_connect_retry_interval=コネクション確立処理のリトライ間隔

　〜〈符号なし整数〉((10〜999))《100》（単位：ミリ秒）

通信制御部のコネクション確立処理で，ECONNREFUSEDエラーが発生した場合，コネクション確立処理のリトライ間隔を指定します。

●rap_listen_backlog=接続待ちキューに保留できる最大要求数

　〜〈符号なし整数〉((SOMAXCONN〜2147483647))《SOMAXCONN》

接続待ちキューに保留できる最大要求数を指定します。

ここで最小値およびデフォルト値にしているSOMAXCONN（listenキュー数）はOpenTP1をコンパイルした環境の値です。詳細については，「リリースノート」を参照してください。

なお，このオペランドの設定が有効になるのは次の場合だけです。

オペランドの設定値 ≦ 実際の動作環境のキューの最大数

このオペランドの設定は，rapリスナーが発行するlisten()システムコールのバックログ数に設定するだけで，バックログの実際の制御はOSにゆだねられます。

キューの長さの上限値，下限値は，各OSによって異なります。OSによって，キューの長さの上限値，下限値が制限されている場合，設定した値が有効にならないことがあります。コネクション確立要求を格納するキューの詳細については，OSのマニュアル，または，TCP/IPの文献を参照してください。

このオペランドで指定した値より多くの接続要求が瞬間的に発生すると，キューからあふれた接続要求は破棄されます。瞬間的に発生する接続要求の数を考慮した値を設定してください。

●rap_msg_output_interval=クライアント数表示メッセージの出力間隔　

　〜〈符号なし整数〉((0〜32767))《0》（単位：分）

rapリスナー終了時に接続中のクライアントがあった場合に出力される，クライアント数表示メッセージの出力間隔を指定します。クライアント数表示メッセージの出力後，このオペランドで指定した時間が経過してもまだ接続中のクライアントがあった場合は，再びクライアント数表示メッセージが出力されます。

このオペランドに0を指定した場合は，クライアント数表示メッセージを一度だけ出力します。

また，rapリスナーは3秒ごとにイベントを監視しています。

●rap_recovery_server=リカバリ要求用待機rapサーバ数

　〜〈符号なし整数〉((0〜rap_parallel_serverオペランドの指定値-1))《0》

XAリソースサービスを使用する場合，クライアントからのリカバリ要求用待機rapサーバ数を指定します。このオペランドに指定した数のrapサーバは，通常のサービス要求を受け付けないで，リカバリ要求だけを実行するために待機します。リカバリ要求用待機rapサーバの必要数は，J2EEサーバ単位に1サーバを目安としてください。

●rap_connect_interval=コネクション確立処理の間隔

　〜〈符号なし整数〉((0〜999))《40》（単位：ミリ秒）

リモートAPIサービス開始時のrapリスナーとrapサーバとの間のコネクション確立処理で，コネクション確立処理の間隔を指定します。

コネクション確立処理は，接続待ちキューに保留できる最大要求数ごとに，このオペランドで指定した値の間隔で行います。

●rpc_extend_function=RPCサービスの機能拡張レベル

　〜〈16進数字〉((00000000〜0000000F))《00000000》

RPCサービスの機能の拡張レベルを，次の中から指定します。

次の指定値で示す機能の拡張レベルを複数指定する場合，それぞれの指定値の論理和を指定してください。

00000000

RPCサービスの機能を拡張しません。

00000001

サービス要求実行中のSPPが異常終了した場合に，dc_rpc_call関数，dc_rpc_call_to関数およびdc_rpc_poll_any_replies関数で，リターン値「DCRPCER_SERVICE_TERMINATED（00378）」を返します。

00000002

トランザクション内で開始した非トランザクション（flagsにDCRPC_TPNOTRANを指定したdc_rpc_call関数，およびdc_rpc_call_to関数）の連鎖RPCを，同期点処理で終了しないで，flagsにDCNOFLAGSを指定したdc_rpc_call関数，およびdc_rpc_call_to関数で明示的に終了するまで継続します。

00000004

非同期応答型RPCの応答メッセージを受け取っていない状態で，トランザクションの同期点処理をした場合に，非トランザクション属性の非同期応答型RPCの応答メッセージは破棄しないで，トランザクション属性の非同期応答型RPCの応答メッセージだけを削除します。

00000008

SPPプロセスで，dc_rpc_call関数，およびdc_rpc_call_to関数の呼び出し元の応答受信タイムアウトを検出したため，処理を中断してサービス要求を破棄した場合に，KFCA00339-Wのメッセージを出力します。

●max_socket_descriptors=ソケット用ファイル記述子の最大数

　〜〈符号なし整数〉((32〜2032))

OpenTP1制御下のプロセス※で，ソケット用に使用するファイル記述子の最大値を指定します。

指定値の範囲は，適用OSがAIX，HP-UXまたはWindowsの場合は32〜2032，適用OSがSolarisまたはLinuxの場合は32〜1008です。

OpenTP1制御下のプロセス※では，システムサーバやユーザサーバとの間で，ソケットを使用したTCP/IP通信でプロセス間の情報交換をしています。そのため，同時に稼働するUAPプロセスの数および通信する他ノードの数によって，ソケット用のファイル記述子の最大数を変更する必要があります。

注※

MCFサービス（MCFマネジャサービス，MCF通信サービス，およびアプリケーション起動サービス）以外のOpenTP1プロセスが対象です。MCFサービスの場合は，「システムサービス情報定義」および「システムサービス共通情報定義」を参照してください。

ソケット用ファイル記述子の最大数の計算式を，次に示します。

↑（このユーザサーバが通信するUAPプロセス数※1＋システムサービスプロセス数※2）／0.8↑

↑↑：小数点以下を切り上げます。

注※1

rapリスナーは，rapリスナーが管理するrapサーバと通信します。rapリスナーが通信するrapサーバ数とrapサーバが通信するUAPプロセス数の，どちらか大きい値を採用してください。

rapサーバが通信するUAPプロセス数は，次に示す値の合計です。

rapサーバが通信する自OpenTP1内のUAPプロセス数

rapサーバが通信する他ノード内のUAPプロセス数

注※2

システムサービスプロセス数とは，自OpenTP1内のシステムサービスプロセスの数です。自OpenTP1内のシステムサービスプロセスは，rpcstatコマンドで表示されるサーバ名をカウントすることで求められます。rpcstatコマンドで表示されるサーバ名のうち，マニュアル「OpenTP1　解説」のOpenTP1のプロセス構造に記載されているシステムサービスプロセスをカウントしてください。

このオペランドの指定値が小さいと，OpenTP1制御下の他プロセスとのコネクションが設定できなくなるため，プロセスがKFCA00307-Eメッセージを出力して異常終了します。

指定値の優先順位は次のとおりです（1.＞2.＞3.）。

rapリスナーサービス定義

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

システム共通定義

ここで指定を省略し，ユーザサービスデフォルト定義でも省略した場合，システム共通定義の値を仮定します。

●trn_completion_limit_time=トランザクション完了限界時間

　〜〈符号なし整数〉((0〜65535))（単位：秒）

トランザクションブランチの開始から終了までの最大実行時間を指定します。指定時間を超えた場合，このトランザクションブランチのプロセスが異常終了したあとに，トランザクションブランチが回復プロセスによってコミットまたはロールバックのどちらかに決着して終了します。0を指定した場合は，トランザクションブランチの最大実行時間を監視しません。

このオペランドの監視対象区間は，rapサーバがdc_trn_begin関数などのAPIを代理実行することによるトランザクションの開始から，トランザクションの同期点処理終了情報（TJ）の取得後であるトランザクションブランチの終了までです。このオペランドの監視対象区間の詳細および各種タイマ監視との関係については，「付録A.2　トランザクションの時間監視」を参照してください。

なお，このオペランドは，トランザクションサービス定義またはユーザサービスデフォルト定義でも指定できます。

指定値の優先順位は次のとおりです（1.＞2.＞3.）。

rapリスナーサービス定義

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

トランザクションサービス定義

●rap_message_id_change_level=メッセージIDの変更レベル

　〜〈符号なし整数〉((0〜2))

リモートAPI機能を使用する場合に出力される可能性の高いエラーメッセージでは，メッセージの種類のEをWに変更するために，メッセージIDを変更できます。変更する内容によって変更レベルを指定してください。

メッセージログを監視し，メッセージの種類がEであるかWであるかによって管理方法を区別したい場合にこのオペランドを使用してください。

このオペランドによって変更されるのはメッセージIDだけであり，メッセージの内容は変更されません。

0

メッセージIDを変更しないで，従来どおりのメッセージIDで出力します。

1

特定の理由コードが出力される条件で，メッセージの種類のEをWに変更するために，メッセージIDを変更できます。

2

1を指定した場合に加え，メッセージの種類のEをWに変更するために，メッセージIDを変更できます。

このオペランドの指定値と出力されるメッセージの関係を次の表に示します。

表3‒14　rap_message_id_change_levelオペランドの指定値と出力されるメッセージの関係

変更できるメッセージID

KFCA26965-Eを

KFCA27790-Wに変更

KFCA26970-Eを

KFCA27791-Wに変更

KFCA26971-Eを

KFCA27792-Wに変更

rap_message_id_change_levelオペランドの指定値

0

1

2

0

1

2

0

1

2

理由コード

8

−

−

−

E

W

W

−

−

−

22

E

E

E

E

E

E

E

E

E

24

−

−

−

E

E

E

−

−

−

31

E

E

W

E

E

W

E

E

W

32

E

E

W

E

E

W

E

E

W

35

E

E

W

−

−

−

E

E

E

36

E

W

W

E

W

W

E

W

W

37

E

E

E

E

E

E

E

E

E

38

−

−

−

E

W

W

−

−

−

71

E

W

W

−

−

−

−

−

−

81

−

−

−

E

E

E

−

−

−

82

−

−

−

E

W

W

−

−

−

83

−

−

−

E

E

E

−

−

−

91

E

W

W

−

−

−

−

−

−

（凡例）

Ｅ：メッセージの種類がEのメッセージが出力されます。

Ｗ：メッセージの種類がWのメッセージが出力されます。

−：該当しません。

このオペランドの指定を省略した場合は，ユーザサービスデフォルト定義の値が仮定されます。

●rap_term_disconnect_time=rapリスナー終了時のコネクション切断待ち時間

　〜〈符号なし整数〉((0〜3600))《0》（単位：秒）

rapリスナー終了時のrapクライアントとのコネクション切断待ち時間を指定します。rapリスナー終了時，このオペランドに指定した時間が経過したら，コネクションを切断してKFCA27763-WまたはFCA27765-Wメッセージを出力します。ただし，rapサーバがAPIを代理実行中は，コネクションを切断しません。このオペランドを省略または0を指定した場合，rapクライアントからコネクション切断要求が到着するか，または問い合わせ間隔最大待ち時間が満了するまで，コネクションを切断しません。

このオペランドには，システム環境定義のsystem_terminate_watch_timeオペランドの指定値より小さい値を指定することをお勧めします。次の場合，rapリスナーの終了待ちが原因で，dcstopコマンドがタイムアウトすることがあります。

このオペランドにsystem_terminate_watch_timeオペランドの指定値より大きい値を指定した場合

このオペランドに0を指定した場合

このオペランドを省略した場合

なお，rapリスナーは3秒ごとにイベントを監視しているため，この待ち時間には最大で3秒の誤差が発生することがあります。

●rap_stay_watch_time=rapサーバ割り当て待ち要求の滞留監視時間

　〜〈符号なし整数〉((0〜65535))《30》（単位：秒）

rapクライアントの要求が滞留した場合の監視時間を指定します。rapクライアントの要求を実行するための空きrapサーバがないとき，要求はrapサーバが空くのを待ちます。この割り当て待ち要求の滞留時間がこのオペランド指定値を超えた場合，KFCA27764-Wメッセージを出力します。このオペランドに0を指定した場合は，滞留時間を監視しません。

このオペランドには，rapクライアント側で指定する最大応答待ち時間より小さい値を指定することをお勧めします。このオペランドにrapクライアント側の最大応答待ち時間より大きい値を指定した場合，クライアント側がすでにタイムアウトと判断した要求に対しても，KFCA27764-Wメッセージを出力することがあります。

なお，rapリスナーは3秒ごとにイベントを監視しているため，この監視時間には最大で3秒の誤差が発生することがあります。

●rap_stay_warning_interval=滞留警告メッセージの出力間隔

　〜〈符号なし整数〉((3〜65535))《180》（単位：秒）

rapクライアントの要求が滞留した場合に，KFCA27764-Wメッセージが出力される間隔を指定します。KFCA27764-Wメッセージが一度出力されたあと，このオペランドの指定値を経過するまでの間，KFCA27764-Wメッセージは出力されません。rap_stay_watch_timeオペランドに0を指定した場合，このオペランドは無視されます。

なお，rapリスナーは3秒ごとにイベントを監視しているため，この出力間隔には最大で3秒の誤差が発生することがあります。

●log_audit_out_suppress=Y|N

　〜《N》

rapリスナーおよびrapサーバから出力される監査ログを抑止する場合に指定します。

Y

rapリスナーおよびrapサーバから出力される監査ログを抑止します。

N

rapリスナーおよびrapサーバから出力される監査ログを抑止しません。

このオペランドは，ログサービス定義のlog_audit_outオペランドにYを指定した場合だけ有効です。

●log_audit_message=監査ログを取得する項目のメッセージID〔,監査ログを取得する項目のメッセージID〕…

　〜〈符号なし整数〉((33400〜99999))

OpenTP1が取得する監査ログのうち，rapリスナーサービス定義に指定できる監査ログのメッセージIDを指定します。指定できるメッセージIDは，最大2,048個です。

このオペランドで指定できるメッセージIDについては，「付録C　監査イベントを取得する定義」を参照してください。

このオペランドを省略し，ユーザサービスデフォルト定義でも指定を省略した場合，ログサービス定義の値を仮定します。このオペランドは，ログサービス定義のlog_audit_outオペランドにYを指定し，rapリスナーサービス定義のlog_audit_out_suppressオペランドにNを指定した場合に有効です。

●ipc_sockctl_highwater=ソケットの一時クローズ処理開始数パーセンテージ〔,ソケットの一時クローズ処理非対象数パーセンテージ〕

　〜〈符号なし整数〉((0〜100))

max_socket_descriptorsオペランドの指定値に対して，ソケットの一時クローズ処理開始数パーセンテージを指定します。

OpenTP1は，プロセス内のソケット用に使用しているファイル記述子の数が，次の値を超えた時点で，一時クローズ処理を開始します。

max_socket_descriptorsオペランドの指定値
×（ソケットの一時クローズ開始数パーセンテージ／100）

ソケットの一時クローズ処理開始数パーセンテージに0を指定した場合，コネクションを確立するたびに一時クローズ処理が実行されます。一時クローズ処理については，マニュアル「OpenTP1 解説」を参照してください。

また，一時クローズ処理の対象外とするコネクション数のパーセンテージも指定できます。一時クローズ処理の対象外とするコネクション数は，次の値です。

max_socket_descriptorsオペランドの指定値
×（ソケットの一時クローズ非対象数パーセンテージ／100）

ソケットの一時クローズ非対象数パーセンテージには，ソケットの一時クローズ処理開始数パーセンテージ以下の値を指定してください。ソケットの一時クローズ処理開始数パーセンテージより大きい値を指定した場合は，ソケットの一時クローズ処理開始数パーセンテージと同じ値が指定されたものとして動作します。

OpenTP1は，プロセス内で確立したコネクションを，確立した順に管理しています。ソケットの一時クローズ処理非対象数パーセンテージを指定した場合，最も古く確立されたコネクションから順に，一時クローズ処理要求が送信されます。

max_socket_descriptorsオペランドの指定値が大きくなく，かつソケットの一時クローズ処理開始数パーセンテージに小さい値が指定されていると，一時クローズ要求が多発し，性能に影響を与えたり，通信障害になったりすることがあります。

ここで指定を省略し，ユーザサービスデフォルト定義でも省略した場合，システム共通定義の値を仮定します。

●ipc_sockctl_watchtime=ソケット再利用可能監視時間

　〜〈符号なし整数〉((0〜65535))（単位：秒）

プロセス内のソケット用に使用しているファイル記述子の数が，max_socket_descriptorsオペランドの指定値になった時点から，一時クローズ処理によってソケットが再利用できるようになるまでの監視時間（秒）を指定します。

一時クローズ処理は，コネクションを確立したプロセス間の合意によってコネクションを切断するため，一時クローズ処理の要求を送信したプロセスはその応答を受けるまではコネクションを切断できません。応答を受信したあと，コネクションは切断され，ソケットが再利用できるようになります。

ipc_sockctl_watchtimeオペランドの指定値を経過しても，どのプロセスからも一時クローズ処理要求に対する応答が返らない場合，プロセスは強制停止されます。ipc_sockctl_watchtimeオペランドに0を指定した場合，無限に待ちます。

ここで指定を省略し，ユーザサービスデフォルト定義でも省略した場合，システム共通定義の値を仮定します。

●scs_prf_trace_level=リモートAPI機能における性能検証用トレース取得レベル

　〜〈符号なし整数〉((00000000〜00000009))《00000001》

リモートAPI機能における性能検証用トレースの取得レベルを指定します。指定した値が次に示すビットを含む場合，情報を取得します。性能検証用トレースの取得レベルを複数指定する場合，それぞれの指定値の論理和を指定してください。

00000000

リモートAPI機能における性能検証用トレースを取得しません。

00000001

イベントIDが0x5001〜0x5008の性能検証用トレースを取得します。

00000008

イベントIDが0x5200，または0x5201の性能検証用トレースを取得します。

イベントIDの詳細については，マニュアル「OpenTP1 運用と操作」を参照してください。

●rap_extend_function=リモートAPI機能の機能拡張レベル

　〜〈16進数字〉((00000000〜00000001)) 《00000000》

リモートAPI機能の機能拡張レベルを指定します。機能の拡張レベルを複数指定する場合，それぞれの指定値の論理和を指定してください。

00000000

リモートAPI機能を機能拡張しません。

00000001

rapクライアントとrapサーバ間のdc_rpc_call関数の処理でタイムアウト事象が発生した場合のdc_rpc_call関数のリターン値を，DCRPCER_NET_DOWN（-306）からDCRPCER_TIMED_OUT（-307）に変更します。

リターン値が変更となるのは次の場合です。

rapクライアントに指定されたwatch_timeオペランドの指定時間内に，サービス要求先サーバからの応答が返らなかった場合

rapクライアントからトランザクショナルRPCを実行した時点でrapクライアントに指定されたtrn_limit_timeオペランドの指定値を満たした場合

このオペランドの指定は，rapサーバがrapクライアントとして動作した場合に有効となります。SUP，SPPまたはMHPがrapクライアントとなる場合は，ユーザサービス定義またはユーザサービスデフォルト定義に指定してください。

●watch_time=最大応答待ち時間

　〜〈符号なし整数〉((0〜65535))（単位：秒）

rapサーバがRPCを代理実行する場合，サービス要求を送信してからサービスの応答が返るまでの最大待ち時間を指定します。

OpenTP1の終了処理で，このオペランドで指定した時間だけ終了処理を待ち合わせる場合があります。したがって，大きな値を指定した場合，OpenTP1の終了処理に時間が掛かるときがあります。

指定時間を過ぎても応答がない場合は，RPCは送受信タイムアウトとしてエラーリターンします。0を指定した場合は，応答を受信するまで待ち続けます。また，0を指定した場合，OpenTP1が終了しないときがあります。

このオペランドは，システム共通定義のwatch_timeオペランドのデフォルト値で使用してください。

特別なチューニングを必要とする場合以外は，このオペランドの内容を変更しないことをお勧めします。

システム共通定義のwatch_timeオペランドのデフォルト値よりも，極端に小さな値または大きな値を指定すると，OpenTP1ダウンに至る障害が発生する場合がありますので，ご注意ください。

このオペランドを省略し，ユーザサービスデフォルト定義でも指定を省略した場合，システム共通定義の値を仮定します。ただし，rapクライアント側で最大応答待ち時間を引き継ぐ設定にした場合は，rapクライアント側で設定した値が有効になります。

コマンド形式

なし。

注意事項

rapリスナーサービス定義は，rapdfgenコマンドの入力となる定義ファイルであり，$DCCONFPATHの下に置いた場合，新たに作成されたrapリスナー用ユーザサービス定義に上書きされるので，$DCCONFPATHの下には置かないでください。$DCCONFPATHの下に置いた場合の動作は保証しません。

rapリスナー用ユーザサービス定義およびrapサーバ用ユーザサービス定義は，$DCCONFPATHの下にあることを前提としているので，$DCCONFPATHの下から$DCUAPCONFPATHの下に移動しないでください。$DCUAPCONFPATHの下に移動した場合の動作は保証しません。

リモートAPI機能を使用する場合，次に示すシステムサービス定義の指定値に注意してください。

システム環境定義

server_countオペランドにrapリスナー数とrapサーバ数を加算してください。また，system_terminate_watch_timeオペランドの指定値はrapサービスの終了時間を考慮して見直してください。

ユーザサービス構成定義

TP1/Server Baseと同期して起動するrapリスナーサービスは，dcsvstart定義コマンドで定義してください。この場合のユーザサーバ名は，rapリスナーサービス名を指定してください。

システム共通定義

all_nodeオペランドで指定するノード名に，クライアントホスト名を指定する必要はありません。また，name_portオペランドおよびprc_portオペランドで指定するポート番号とrapリスナーが使用するポート番号は重複しないようにしてください。重複した場合の動作は保証できません。

プロセスサービス定義

prc_process_countオペランドに，rapサーバのプロセス数を考慮して見直してください。

スケジュールサービス定義

scd_server_countオペランドに，rapサーバ数を考慮して見直してください。

次に示すオペランドは，rapリスナーサービス定義で指定を省略した場合，ユーザサービスデフォルト定義の値が有効になります。

rpc_trace

rpc_trace_name

rpc_trace_size

rpc_extend_function

trn_expiration_time

trn_expiration_time_suspend

trn_cpu_time

trn_statistics_item

trn_optimum_item

trn_rollback_information_put

trn_watch_time

trn_limit_time

trn_rollback_response_receive

trn_partial_recovery_type

trn_completion_limit_time

max_socket_descriptors

log_audit_message

watch_time

次に示すオペランドは，rapリスナーサービス定義に指定しても無効となります。

rapリスナーの場合

module

type

atomic_update

receive_from

auto_restart

critical

trf_put

node_down_restart

term_watch_time

max_open_fds

rpc_destination_mode

status_change_when_terming

rapサーバの場合

module

atomic_update

type

hold

hold_recovery

server_security

service

balance_count

auto_restart

critical

service_hold

service_priority_control

node_down_restart

server_type

term_watch_time

max_open_fds

message_store_buflen

schedule_delay_limit

schedule_delay_abort

scd_pool_warning_use_rate

scd_pool_warning_interval

rapリスナーおよびrapサーバは，これら以外のオペランドに関して，ユーザサービスデフォルト定義のデフォルト値が指定されているものとして動作します。

OpenTP1の制限のため，次に示す場合は，各オペランドの指定値を調整してください。

rap_connection_assign_typeオペランドでdynamicを指定する場合

rap_parallel_serverオペランド，rap_max_clientオペランドおよびmax_socket_descriptorsオペランドの指定値の合計は，次に示す値以下にしてください。

・適用OSがAIX，HP-UXまたはWindowsの場合：1993

・適用OSがSolarisまたはLinuxの場合：969

rap_connection_assign_typeオペランドでstaticを指定する場合

rap_max_clientオペランドおよびmax_socket_descriptorsオペランドの指定値の合計は，次に示す値以下にしてください。

・適用OSがAIX，HP-UXまたはWindowsの場合：1993

・適用OSがSolarisまたはLinuxの場合：969

TP1/Client/Jを使用する場合は，rpc_extend_functionオペランドの00000002ビットをオンにしないでください。00000002ビットがオンになっている場合の動作は保証できません。

rapリスナーサービス定義に，ユーザサービス定義のrpc_rap_auto_connectオペランドを指定しないでください。rapサーバはrpc_rap_auto_connectオペランドにYが指定されたものとして動作していますが，rpc_rap_auto_connectオペランドにNが指定された場合のrapサーバの動作は保証できません。

rapリスナーの開始処理中に，1プロセス当たりでオープンできるファイル数を超えると，rapリスナーがKFCA00105-E（アボートコードはr902109）のメッセージを出力して異常終了します。1プロセス当たりでオープンできるファイル数を超えないように，max_open_fdsオペランドおよびmax_socket_descriptorsオペランドの値を見積もってください。

OpenTP1のプロセスでオープンするファイル数の最大値は，ユーザサービス定義のmax_open_fdsオペランドとmax_socket_descriptorsオペランドの指定値の合計になります。なお，max_socket_descriptorsオペランドの値は，指定値がそのまま適用されますが，max_open_fdsオペランドの値は，rapdfgenコマンドで定義を生成したときに，次の計算式によって値が自動的に設定されます。

rapリスナー用ユーザサービス定義

max_open_fds = rap_parallel_server＋rap_max_client＋23

rapサーバ用ユーザサービス定義

max_open_fds = 22

1プロセス当たりでオープンできるファイル数については，「リリースノート」または使用しているOSのマニュアルを参照してください。

rapクライアントマネジャサービス定義

形式

set形式

  set rap_client_manager_port=rapクライアントマネジャのポート番号
  set rap_listen_inf="ノード識別子:ポート番号=ホスト名:ポート番号"
                  〔,"ノード識別子:ポート番号=ホスト名:ポート番号"〕…
  set uid=OpenTP1管理者のユーザ識別子
〔set log_audit_out_suppress=Y|N〕
〔set log_audit_message=監査ログを取得する項目のメッセージID
                     〔,監査ログを取得する項目のメッセージID〕…〕
〔set rap_watch_time=メッセージ送受信最大監視時間〕

コマンド形式

なし。

機能

リモートAPIクライアントマネジャ機能を使用するための実行環境を定義します。

説明

set形式のオペランド

●rap_client_manager_port=rapクライアントマネジャのポート番号

　〜〈符号なし整数〉((5001〜65535))

rapリスナーの起動を監視するrapクライアントマネジャのポート番号を指定します。

このオペランドで指定するポート番号は，ほかのプログラムと重複しないようにしてください。

また，OSには任意に割り当てる番号がありますが，この番号も使用しないでください。OSが任意に割り当てる番号は，OSの種別やバージョンによって異なります。詳細については，使用しているOSのマニュアルを参照してください。

●rap_listen_inf="ノード識別子:ポート番号=ホスト名:ポート番号"〔,"ノード識別子:ポート番号=ホスト名:ポート番号"〕…

監視するrapリスナーを指定します。コンマで区切り，最大1024のrapリスナーを指定できます。

"ノード識別子:ポート番号1=ホスト名:ポート番号2"

●uid=OpenTP1管理者のユーザ識別子

　〜〈符号なし整数〉((0〜4294967294))

このサービスグループのプロセス所有者となるユーザIDを指定します。

この場合，OpenTP1管理者のユーザ識別子を指定してください。

最大値はOSに依存するので，使用しているOSのマニュアルを参照してください。

●log_audit_out_suppress=Y|N

　〜《N》

rapクライアントマネジャから出力される監査ログを抑止する場合に指定します。

Y

rapクライアントマネジャから出力される監査ログの出力を抑止します。

N

rapクライアントマネジャから出力される監査ログの出力を抑止しません。

このオペランドは，ログサービス定義のlog_audit_outオペランドにYを指定した場合だけ有効です。

●log_audit_message=監査ログを取得する項目のメッセージID〔,監査ログを取得する項目のメッセージID〕…

　〜〈符号なし整数〉((33400〜99999))

OpenTP1が取得する監査ログのうち，rapクライアントマネジャサービス定義に指定できる監査ログのメッセージIDを指定します。指定できるメッセージIDは，最大2,048個です。

このオペランドで指定できるメッセージIDについては，「付録C　監査イベントを取得する定義」を参照してください。

このオペランドを省略し，ユーザサービスデフォルト定義でも指定を省略した場合，ログサービス定義の値を仮定します。このオペランドは，ログサービス定義のlog_audit_outオペランドにYを指定し，rapクライアントマネジャサービス定義のlog_audit_out_suppressオペランドにNを指定した場合に有効です。

●rap_watch_time=メッセージ送受信最大監視時間

　〜〈符号なし整数〉((0〜65535))《180》（単位：秒）

rapクライアントマネジャがメッセージの送受信を開始してから，送受信が完了するまでの監視時間を指定します。監視時間が経過してもメッセージの送受信が完了しない場合は，メッセージを出力し，ネットワーク障害と同様の処理を行います。

0を指定した場合は，時間監視をしません。

コマンド形式

なし。

注意事項

rapクライアントマネジャサービス定義は，rapdfgenコマンドの入力となる定義ファイルであり，$DCCONFPATHの下に置いた場合，新たに作成されたrapクライアントマネジャ用ユーザサービス定義に上書きされるので，$DCCONFPATHの下には置かないでください。$DCCONFPATHの下に置いた場合の動作は保証しません。

rapクライアントマネジャ用ユーザサービス定義は，$DCCONFPATHの下にあることを前提としているので，$DCCONFPATHの下から$DCUAPCONFPATHの下に移動しないでください。$DCUAPCONFPATHの下に移動した場合の動作は保証しません。

rapクライアントマネジャサービス定義の指定値を変更する場合は，rapクライアントマネジャが正常終了したあとに変更してください。

性能検証用トレース定義

形式

set形式

〔set prf_buff_size=性能検証用トレースバッファサイズ〕
〔set prf_file_count=性能検証用トレース情報ファイルの世代数〕
〔set prf_file_size=性能検証用トレース情報ファイルのサイズ〕
〔set prf_information_level=1|0〕
〔set prf_trace_backup=Y|N〕

コマンド形式

なし。

機能

性能検証用トレース情報を取得する場合の実行環境を定義します。

説明

set形式のオペランド

●prf_buff_size=性能検証用トレースバッファサイズ

　〜〈符号なし整数〉((96〜131072))《1024》（単位：キロバイト）

性能検証用トレース情報を格納するバッファのサイズを指定します。

OpenTP1のシステムサービスプロセスやUAPプロセスからの性能検証用トレース情報は，いったん共用メモリ上のバッファに格納された上でトレースファイルに出力されます。このとき，一時的な負荷の増大などで，一度に大量のトレース情報取得が行われたりファイルへの出力が滞ると，バッファが満杯になることがあります。バッファが満杯になるとその状態が解消するまで以降のトレース情報は捨てられることになります。

このオペランドは，バッファのサイズを大きくすることでバッファあふれによるトレース情報抜けの発生を低減できます。

●prf_file_count=性能検証用トレース情報ファイルの世代数

　〜〈符号なし整数〉((3〜256))《3》

性能検証用トレース情報ファイルの世代数を指定します。

●prf_file_size=性能検証用トレース情報ファイルのサイズ

　〜〈符号なし整数〉((1024〜1048576))《10240》（単位：キロバイト）

性能検証用トレース情報ファイルのサイズを指定します。

トレース情報は，通常ファイルに出力します。このファイルは性能検証用トレース定義のprf_file_countオペランドの指定値分の世代を用意し，すべての世代を使用したらオーバラップして上書きします。このため，ある程度時間が経つと古いトレース情報がなくなります。prf_file_sizeオペランドの指定値を大きくすることで，ファイルを上書きする時間を延長できます。

トレースファイルの1ファイルサイズの算出式を，次に示します（単位：バイト）。

1ファイルサイズ=128＋（1トランザクションで必要なトレースデータ長※×実行トランザクション数）

注※

1トランザクションで必要なトレースデータ長は，マニュアル「OpenTP1 運用と操作」を参照して計算してください。

●prf_information_level=1|0

　〜《1》

性能検証用トレース関連のメッセージの表示レベルを指定します。

0

表示レベル0の性能検証用トレース関連のメッセージ（警告および障害メッセージ）をsyslogに出力します。

1

表示レベル1以下の性能検証用トレース関連のメッセージをsyslogに出力します。

性能検証用トレース関連のメッセージと表示レベルの関係を次に示します。

メッセージ

表示レベル

KFCA26700-W

0

KFCA26705-W

0

KFCA26710-I

1

●prf_trace_backup=Y|N

　〜《Y》

OpenTP1の終了時にprfトレースファイルのバックアップを取得するかどうかを指定します。

Y

prfトレースファイルのバックアップを取得します。

N

prfトレースファイルのバックアップを取得しません。

バックアップファイルを取得する場合，バックアップファイルは，$DCDIR/spool/save下に作成されます。

バックアップする対象ファイルを次の表に示します。

トレースファイル名称

ファイル名

バックアップファイル名※1

性能検証用トレース情報ファイル

prf_nnn※2

prf_nnn.bk1，prf_nnn.bk2

XAR性能検証用トレース情報ファイル

_xr_nnn※2

_xr_nnn.bk1，_xr_nnn.bk2

JNL性能検証用トレース情報ファイル

_jl_nnn※2

_jl_nnn.bk1，_jl_nnn.bk2

LCK性能検証用トレース情報ファイル

_lk_nnn※2

_lk_nnn.bk1，_lk_nnn.bk2

MCF性能検証用トレース情報取得ファイル

_mc_nnn※2

_mc_nnn.bk1，_mc_nnn.bk2

TRNイベントトレース情報ファイル

_tr_nnn※2

_tr_nnn.bk1，_tr_nnn.bk2

NAMイベントトレース情報ファイル

_nm_001，_nm_002，_nm_003

_nm_nnn.bk1，_nm_nnn.bk2

プロセスサービスイベントトレース情報ファイル

_pr_001，_pr_002，_pr_003

_pr_nnn.bk1，_pr_nnn.bk2

FILイベントトレース情報ファイル

_fl_001，_fl_002，_fl_003

_fl_nnn.bk1，_fl_nnn.bk2

注※1

nnn：各トレースファイルのファイル名に対応した値です。

注※2

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

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

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

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

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

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

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

各トレースファイルの詳細については，マニュアル「OpenTP1 解説」を参照してください。

prfトレースファイルはトラブルシュートとして有効な情報です。バックアップを取得していなかったために，障害発生時の情報が残っていなかった場合，問題解決に時間が掛かるおそれがあります。バックアップを取得しない場合は，prf_file_sizeオペランドの拡張，およびprf_file_countオペランドの拡張を検討してください。

なお，JNL性能検証用トレース情報ファイルの場合，このオペランドは，JNL性能検証用トレース定義でも指定できます。指定値の優先順位は次のとおりです（1.＞2.）。

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

性能検証用トレース定義

コマンド形式

なし。

注意事項

この定義の使用は，TP1/Extension 1をインストールしていることが前提です。TP1/Extension 1をインストールしていない場合の動作は保証できませんので，ご了承ください。

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

形式

set形式

〔set prf_file_count=XAR性能検証用トレース情報ファイルの世代数〕
〔set prf_file_size=XAR性能検証用トレース情報ファイルのサイズ〕
〔set prf_information_level=1|0〕

コマンド形式

なし。

機能

XAR性能検証用トレース情報を取得する場合の実行環境を定義します。

説明

set形式のオペランド

●prf_file_count=XAR性能検証用トレース情報ファイルの世代数

　〜〈符号なし整数〉((3〜256))《3》

XAR性能検証用トレース情報ファイルの世代数を指定します。

●prf_file_size=XAR性能検証用トレース情報ファイルのサイズ

　〜〈符号なし整数〉((1024〜1048576))《10240》（単位：キロバイト）

XAR性能検証用トレース情報ファイルのサイズを指定します。

トレース情報は，通常ファイルに出力します。このファイルはXAR性能検証用トレース定義のprf_file_countオペランドの指定値分の世代を用意し，すべての世代を使用したらオーバラップして上書きします。このため，ある程度時間が経つと古いトレース情報がなくなります。このオペランドの指定値を大きくすることで，ファイルを上書きする時間を延長できます。

トランザクション実行中に取得するトレースファイルの1ファイルサイズの算出式を，次に示します（単位：バイト）。

1ファイルサイズ※=128＋（384×（4＋1トランザクションで実行するRPCコール回数）×実行トランザクション数）

注※

トレース量は，トランザクションの最適化などの条件によって異なります。

●prf_information_level=1|0

XAR性能検証用トレース関連のメッセージの表示レベルを指定します。

0

表示レベル0のXAR性能検証用トレース関連のメッセージ（警告および障害メッセージ）をsyslogに出力します。

1

表示レベル1以下のXAR性能検証用トレース関連のメッセージをsyslogに出力します。

XAR性能検証用トレース関連のメッセージと表示レベルの関係を次に示します。ここで指定を省略した場合，性能検証用トレース定義の値を仮定します。

メッセージ

表示レベル

KFCA26700-W

0

KFCA26705-W

0

KFCA26710-I

1

コマンド形式

なし。

注意事項

この定義の使用は，TP1/Extension 1をインストールしていることが前提です。TP1/Extension 1をインストールしていない場合の動作は保証できませんので，ご了承ください。

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

形式

set形式

〔set prf_file_count=JNL性能検証用トレース情報ファイルの世代数〕
〔set prf_file_size=JNL性能検証用トレース情報ファイルのサイズ〕
〔set prf_information_level=1|0〕
〔set prf_trace_backup=Y|N〕

コマンド形式

なし。

機能

JNL性能検証用トレース情報を取得する場合の実行環境を定義します。

説明

set形式のオペランド

●prf_file_count=JNL性能検証用トレース情報ファイルの世代数

　〜〈符号なし整数〉((3〜256))

JNL性能検証用トレース情報ファイルの世代数を指定します。ここで指定を省略した場合，性能検証用トレース定義の値を仮定します。

●prf_file_size=JNL性能検証用トレース情報ファイルのサイズ

　〜〈符号なし整数〉((1024〜1048576))《1024》（単位：キロバイト）

JNL性能検証用トレース情報ファイルのサイズを指定します。

トレース情報は，通常ファイルに出力します。このファイルはJNL性能検証用トレース定義のprf_file_countオペランドの指定値分の世代を用意し，すべての世代を使用したらオーバラップして上書きします。このため，ある程度時間が経つと古いトレース情報がなくなります。このオペランドの指定値を大きくすることで，ファイルを上書きする時間を延長できます。

トレースファイルの1ファイルサイズの算出式を次に示します（単位：バイト）。

システム共通定義のjnl_prf_event_trace_levelオペランドに00000001を指定した場合

1ファイルサイズ=128×a＋128×b

システム共通定義のjnl_prf_event_trace_levelオペランドに00000002を指定した場合

適用OSがUNIXの場合

1ファイルサイズ=512×a＋128×b＋256×c

適用OSがWindowsの場合

1ファイルサイズ=576×a＋128×b＋256×c

（凡例）

a：1トランザクション内で発生するジャーナルライト処理回数

b：1トランザクション内で発生するバッファ空き待ち回数

c：1トランザクションで取得されるジャーナルレコード数

●prf_information_level=1|0

JNL性能検証用トレース関連のメッセージの表示レベルを指定します。

0

表示レベル0のJNL性能検証用トレース関連のメッセージ（警告および障害メッセージ）をsyslogに出力します。

1

表示レベル1以下のJNL性能検証用トレース関連のメッセージをsyslogに出力します。

JNL性能検証用トレース関連のメッセージと表示レベルの関係を次に示します。ここで指定を省略した場合，性能検証用トレース定義の値を仮定します。

メッセージ

表示レベル

KFCA26700-W

0

KFCA26705-W

0

KFCA26710-I

1

●prf_trace_backup=Y|N

OpenTP1の終了時にJNL性能検証用トレース情報ファイルのバックアップを取得するかどうかを指定します。

Y

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

N

JNL性能検証用トレース情報ファイルのバックアップを取得しません。

バックアップファイルを取得する場合，バックアップファイルは，$DCDIR/spool/save下に作成されます。

バックアップする対象ファイルを次に示します。

トレースファイル名称

ファイル名

バックアップファイル名※1

JNL性能検証用トレース情報ファイル

_jl_nnn※2

_jl_nnn.bk1，_jl_nnn.bk2

注※1

nnn：トレースファイルのファイル名に対応した値です。

注※2

nnn：JNL性能検証用トレース定義のprf_file_countオペランドで指定した値を上限とした001から始まる値です。

JNL性能検証用トレース情報ファイルの詳細については，マニュアル「OpenTP1 解説」を参照してください。

JNL性能検証用トレース情報ファイルはトラブルシュートとして有効な情報です。バックアップを取得していなかったために，障害発生時の情報が残っていなかった場合，問題解決に時間が掛かるおそれがあります。バックアップを取得しない場合は，prf_file_sizeオペランドの拡張，およびprf_file_countオペランドの拡張を検討してください。

ここで指定を省略した場合，性能検証用トレース定義の値を仮定します。

コマンド形式

なし。

注意事項

この定義の使用は，TP1/Extension 1をインストールしていることが前提です。TP1/Extension 1をインストールしていない場合の動作は保証できませんので，ご了承ください。

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

形式

set形式

〔set prf_file_count=LCK性能検証用トレース情報ファイルの世代数〕
〔set prf_file_size=LCK性能検証用トレース情報ファイルのサイズ〕
〔set prf_information_level=1|0〕

コマンド形式

なし。

機能

LCK性能検証用トレース情報を取得する場合の実行環境を定義します。

説明

set形式のオペランド

●prf_file_count=LCK性能検証用トレース情報ファイルの世代数

　〜〈符号なし整数〉((3〜256))《3》

LCK性能検証用トレース情報ファイルの世代数を指定します。

●prf_file_size=LCK性能検証用トレース情報ファイルのサイズ

　〜〈符号なし整数〉((1024〜1048576))《5120》（単位：キロバイト）

LCK性能検証用トレース情報ファイルのサイズを指定します。

トレース情報は，通常ファイルに出力します。このファイルはLCK性能検証用トレース定義のprf_file_countオペランドの指定値分の世代を用意し，すべての世代を使用したらオーバラップして上書きします。このため，ある程度時間が経つと古いトレース情報がなくなります。このオペランドの指定値を大きくすることで，ファイルを上書きする時間を延長できます。

トランザクション実行中に取得するトレースファイルの1ファイルサイズの算出式を次に示します（単位：バイト）。

1ファイルサイズ=128＋（（1024×（D＋T＋M）＋R×128）×実行トランザクション数）

D：1トランザクションブランチでのDAMサービスへのアクセス数（参照・更新）

T：1トランザクションブランチでのTAMサービスへのアクセス数（参照・更新）

M：1トランザクションブランチでのMQAサービスへのアクセス数（参照・更新）

R：1トランザクションブランチ当たりの排他制御関数実行回数

なお，算出式で取得したファイルサイズはおおよそのサイズです。UAPの構成などによっては，算出値以上となる場合があります。

●prf_information_level=1|0

LCK性能検証用トレース関連のメッセージの表示レベルを指定します。

0

表示レベル0のLCK性能検証用トレース関連のメッセージ（警告および障害メッセージ）をsyslogに出力します。

1

表示レベル1以下のLCK性能検証用トレース関連のメッセージをsyslogに出力します。

LCK性能検証用トレース関連のメッセージと表示レベルの関係を次に示します。ここで指定を省略した場合，性能検証用トレース定義の値を仮定します。

メッセージ

表示レベル

KFCA26700-W

0

KFCA26705-W

0

KFCA26710-I

1

コマンド形式

なし。

注意事項

この定義の使用は，TP1/Extension 1をインストールしていることが前提です。TP1/Extension 1をインストールしていない場合の動作は保証できませんので，ご了承ください。

TRNイベントトレース定義

形式

set形式

〔set prf_file_count=TRNイベントトレース情報ファイルの世代数〕
〔set prf_file_size=TRNイベントトレース情報ファイルのサイズ〕
〔set prf_information_level=1|0〕

コマンド形式

なし。

機能

TRNイベントトレース情報を取得する場合の実行環境を定義します。

説明

set形式のオペランド

●prf_file_count=TRNイベントトレース情報ファイルの世代数

　〜〈符号なし整数〉((3〜256))《3》

TRNイベントトレース情報ファイルの世代数を指定します。

●prf_file_size=TRNイベントトレース情報ファイルのサイズ

　〜〈符号なし整数〉((1024〜1048576))《10240》（単位：キロバイト）

TRNイベントトレース情報ファイルのサイズを指定します。

トレース情報は，通常ファイルに出力します。このファイルはTRNイベントトレース定義のprf_file_countオペランドの指定値分の世代を用意し，すべての世代を使用したらオーバラップして上書きします。このため，ある程度時間が経つと古いトレース情報がなくなります。prf_file_sizeオペランドの指定値を大きくすることで，ファイルを上書きする時間を延長できます。

トランザクション実行中に取得するトレースファイルの1ファイルサイズの算出式を，次に示します（単位：バイト）。

1ファイルサイズ※=128＋（12×アクセスするリソースマネジャ数×320×実行トランザクション数）

注※

2相コミットのトランザクションの場合，1トランザクションブランチ当たりに取得するトレース量は「12×アクセスするリソースマネジャ数」となります。ただし，トレース量は，ユーザサーバにリンケージされているXAインタフェースオブジェクトファイルや，トランザクションの最適化などの条件によって異なります。

●prf_information_level=1|0

TRNイベントトレース関連のメッセージの表示レベルを指定します。

0

表示レベル0のTRNイベントトレース関連のメッセージ（警告および障害メッセージ）をsyslogに出力します。

1

表示レベル1以下のTRNイベントトレース関連のメッセージをsyslogに出力します。

TRNイベントトレース関連のメッセージと表示レベルの関係を次に示します。ここで指定を省略した場合，性能検証用トレース定義の値を仮定します。

メッセージ

表示レベル

KFCA26700-W

0

KFCA26705-W

0

KFCA26710-I

1

コマンド形式

なし。

注意事項

この定義の使用は，TP1/Extension 1をインストールしていることが前提です。TP1/Extension 1をインストールしていない場合の動作は保証できませんので，ご了承ください。

リアルタイム統計情報サービス定義

形式

set形式

〔set rts_trcput_interval=統計情報の取得間隔〕
〔set rts_service_max=最大取得サービス数〕
〔set rts_item_max=最大取得項目数〕
〔set rts_log_file=Y|N〕
〔set rts_log_file_name=RTSログファイル名〕
〔set rts_log_file_size=RTSログファイルのサイズ〕
〔set rts_log_file_count=RTSログファイルの世代数〕
〔set rts_log_file_backup=Y|N〕
〔set rts_swap_message=Y|N〕

コマンド形式

〔rtsput  -u｛sys|srv|svc|obj｝
        〔-s サーバ名〕〔-v サービス名〕
        〔-o 取得対象名1〕〔-b 取得対象名2〕
        〔-e 項目ID〔,項目ID〕...〕
        〔-f リアルタイム取得項目定義ファイル名〕〕

機能

リアルタイム統計情報サービスで，統計情報を取得するための実行環境を定義します。

説明

set形式のオペランド

●rts_trcput_interval=統計情報の取得間隔

　〜〈符号なし整数〉((10〜86400))《600》（単位：秒）

リアルタイム統計情報を取得し編集する時間間隔を，秒単位で指定します。

●rts_service_max=最大取得サービス数

　〜〈符号なし整数〉((1〜1000))《64》

リアルタイム統計情報サービスで，統計情報を取得する対象の最大数を指定します。

●rts_item_max=最大取得項目数

　〜〈符号なし整数〉((1〜1000))《64》

リアルタイム統計情報サービスが，一つの取得対象で統計情報を取得できるイベントの最大数を指定します。

●rts_log_file=Y|N

　〜《Y》

RTSサービス用の共用メモリに取得した統計情報をRTSログファイルに出力するかどうかを指定します。

Y

取得した統計情報をRTSログファイルに出力します。

N

取得した統計情報をRTSログファイルに出力しません。

●rts_log_file_name=RTSログファイル名

　〜〈1〜63文字のパス名〉《$DCDIR/spool/dcrtsinf/rtslog》

統計情報を出力するRTSログファイル名を絶対パスで指定します。

このオペランドで指定したパスに，すでに同名のファイルが存在する場合は，RTSログファイルを作り直して使用します。

RTSログファイルの出力先にRTSログファイル名と同じ名称のファイル，またはディレクトリを作成しないでください。同じ名称のファイル，またはディレクトリを作成した場合の動作は保証できません。

ユーザサービスデフォルト定義のuidオペランドにOpenTP1管理者以外のユーザを指定する場合，rts_log_file_nameオペランドには，uidオペランドに指定したユーザが書き込み権限を持つパスを指定してください。

リアルタイム統計情報サービスは，どのユーザIDで起動したかには関係なく，RTSログファイルの出力先に対する書き込み権限があれば正常に動作し，権限がなければKFCA32734-Wメッセージを出力してRTSログファイルへの出力機能を停止します。また，rtssetupコマンドで作成する定義ファイル（RTSSUPおよびRTSSPP）にはuidオペランド，およびgroupsオペランドを指定していません。このため，ユーザサービスデフォルト定義にuidオペランド，およびgroupsオペランドが指定されている場合は，指定されたユーザおよびグループでリアルタイム統計情報サービスを起動します。

●rts_log_file_size=RTSログファイルのサイズ

　〜〈符号なし整数〉((1024〜1048576))《1024》（単位：キロバイト）

統計情報を出力するRTSログファイルのサイズを指定します。

RTSログファイルは，rts_log_file_countオペランドで指定した値分の世代を用意します（rts_log_file_sizeオペランドの指定値×rts_log_file_countオペランドの指定値分のディスク容量が必要です）。すべての世代を使用した場合は，オーバラップして上書きします。このため，ある程度の時間が経過すると，古いリアルタイム統計情報はなくなります。RTSログファイルを上書きする時間を延長したい場合は，rts_log_file_sizeオペランドに大きい値を指定してください。

また，rts_log_file_sizeオペランドには，一度の契機で出力するリアルタイム統計情報のサイズより大きな値を指定してください。一度の契機で出力するリアルタイム統計情報のサイズは次に示す計算式で求めます。

一度の契機で出力するリアルタイム統計情報のサイズ
＝（96＋（40×rts_item_maxオペランドの値））×リアルタイム統計情報の取得対象の数※

注※

リアルタイム統計情報の取得対象の数は，リアルタイム統計情報サービス定義のrtsput定義コマンドで指定した取得対象の数です。

ただし，-uオプションにsrvを指定した場合，-sオプションの引数にユーザサーバを指定したときのリアルタイム統計情報の取得対象の数は，「serviceオペランドに定義したサービス数＋2」になります。rtsstatsコマンドで取得対象を変更する場合は，その数も考慮してください。

rtsput定義コマンドは同じサービスやサーバに対して重複して指定できます。重複して指定した場合，リアルタイム統計情報サービスは，各rtsput定義コマンドで指定した取得項目をマージして取得します。重複して指定している場合，取得対象の数は，重複した取得対象ごとに一つと数えられるため，増加しません。

システム全体の統計情報は，リアルタイム統計情報の動作上，取得対象としてカウントしませんが，RTSログファイルの出力に関してはカウントする必要があります。そのため，システム全体の統計情報を取得している場合は，上記の計算式の「リアルタイム統計情報の取得対象の数」に1を加算して計算してください。

●rts_log_file_count=RTSログファイルの世代数

　〜〈符号なし整数〉((1〜10))《3》

統計情報を出力するRTSログファイルの世代数を指定します。

●rts_log_file_backup=Y|N

　〜《Y》

リアルタイム統計情報サービスの開始時に，RTSログファイルのバックアップファイルを作成するかどうかを指定します。

Y

RTSログファイルのバックアップファイルを作成します。

バックアップファイルは，RTSログファイル名に「.bk」を付与した名称で，RTSログファイルの出力先ディレクトリに作成します。

N

RTSログファイルのバックアップファイルを作成しません。

RTSログファイルのバックアップファイルを作成する場合，出力先ディレクトリに最大で次のディスク容量が必要になります。

RTSログファイルの出力先ディレクトリのディスク容量=rts_log_file_sizeオペランドの指定値×rts_log_file_countオペランドの指定値×2

RTSログファイルの出力先ディレクトリのディスク容量に余裕があることを確認してください。

RTSログファイルの出力先に，バックアップファイルと同じ名称のファイル，またはバックアップファイルと同じ名称のディレクトリを作成しないでください。同じ名称のファイルを作成した場合は，バックアップファイルで上書きします。同じ名称のディレクトリを作成した場合は，RTSログファイルのバックアップを作成できません。

●rts_swap_message=Y|N

　〜《N》

リアルタイム統計情報を出力するRTSログファイルを切り替える場合に，RTSログファイルのスワップメッセージ（KFCA32740-Iメッセージ）を出力するかどうかを指定します。

Y

RTSログファイルのスワップメッセージを出力します。

N

RTSログファイルのスワップメッセージを出力しません。

コマンド形式

次ページ以降に記述しています。

注意事項

rts_service_maxオペランド，およびrts_item_maxオペランドの値は，一度リアルタイム統計情報サービスを開始したあと，OpenTP1のオンライン中に値を変更しても反映されません。定義を変更したい場合は，一度OpenTP1を終了させてください。

RTSログファイルの統計情報の出力処理に時間が掛かった場合，rts_trcput_intervalオペランドに指定した時間間隔を超えて統計情報を取得する場合があります。

環境変数DCDIRの設定値が41文字を超えた場合，rts_log_file_nameオペランドを省略しないでください。定義解析時にエラーになります。

rtsput

名称

統計情報取得サービスの指定

形式

〔rtsput   -u｛sys|srv|svc|obj｝
         〔-s サーバ名〕〔-v サービス名〕
         〔-o 取得対象名1〕〔-b 取得対象名2〕
         〔-e 項目ID〔,項目ID〕...〕
         〔-f リアルタイム取得項目定義ファイル名〕〕

機能

リアルタイム統計情報サービスで統計情報を取得する対象と項目を指定します。

オプション

●-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文字の識別子〉

統計情報を取得するサービスの名称を指定します。

-sオプションで指定したサーバの指定したサービスの統計情報を取得します。

-uオプションにsvcを指定した場合，必ず-vオプションを指定してください。-uオプションにsys，srv，またはobjを指定した場合，-vオプションは指定できません。

●-o　取得対象名1

　〜〈1〜8文字の文字列〉

●-b　取得対象名2

　〜〈1〜63文字の文字列〉

-uオプションにobjを指定した場合に，リアルタイム統計情報を取得する取得対象オブジェクト名を指定します。

-oオプションおよび-bオプションで指定できる取得対象オブジェクトを次の表に示します。-uオプションにobjを指定した場合は，必ず次の表に従って指定してください。

表3‒15　rtsput定義コマンドのオプションと指定できる取得対象オブジェクト

-oオプションの指定値

-bオプションの指定値

指定できる取得対象オブジェクト

ポート番号※

IPアドレス※

指定したサービス情報の参照先ノード

論理端末名

指定を省略

指定した論理端末

指定を省略

サービスグループ名

指定したサービスグループ

注※

システム共通定義のall_nodeオペランド，またはドメイン定義ファイルに指定したノードのIPアドレスとポート番号を指定してください。

-uオプションにsys，srv，またはsvcを指定した場合，-oオプションおよび-bオプションは指定できません。

●-e　項目ID

　〜〈符号なし整数〉((1000〜9999))

統計情報を取得する項目の項目IDを指定します。

項目IDについては，マニュアル「OpenTP1 運用と操作」を参照してください。

●-f　リアルタイム取得項目定義ファイル名

　〜〈1〜8文字の識別子〉

取得する統計情報の項目を定義したリアルタイム取得項目定義ファイルを指定します。

注意事項

-uオプションにsrvを，-sオプションにユーザサーバ名を指定した場合，指定されたサーバのユーザサービス定義ファイルを解析してサービス名を取得します。-sオプションにユーザサーバ名を指定する場合は，必ず対応するユーザサービス定義ファイルを準備してください。

rtsput定義コマンドで指定できる統計情報の取得対象は，リアルタイム統計情報サービス定義のrts_service_maxオペランドに指定した数までです。また，一つの取得対象で取得できるイベントの数は，リアルタイム統計情報サービス定義のrts_item_maxオペランドに指定した数までです。

-fオプションおよび-eオプションの指定を省略した場合，統計情報を取得するための領域を確保します。ただし，取得する統計情報は任意区間でのユーザサーバ実行時間の情報だけです。

rtsput定義コマンドは，同じサービスやサーバに対して重複して指定できます。重複して指定した場合，リアルタイム統計情報サービスは，各定義で指定した取得項目をマージして取得します。rtsput定義コマンドおよびリアルタイム取得項目定義ファイルの指定例を表3-16に，表3-16のとおりに指定した場合のリアルタイム統計情報サービスで取得する項目を表3-17に示します。

rtsput定義コマンドの定義例の詳細については，「8.2　リアルタイム統計情報の取得項目の定義例」を参照してください。

表3‒16　rtsput定義コマンドおよびリアルタイム取得項目定義ファイルの指定例

rtsput定義コマンドの指定

定義ファイルで指定した取得項目

rtsput -u srv -s SERVER_A　-f 定義ファイル1

項目A，項目C

rtsput -u svc -s SERVER_A　-v SERVICE_B　-f 定義ファイル2

項目B

rtsput -u svc -s SERVER_A　-v SERVICE_C　-f 定義ファイル3

項目A，項目D

表3‒17　リアルタイム統計情報サービスで取得する項目

サーバ名

サービス名

項目A

項目B

項目C

項目D

SRVER_A

サービス全体

○

×

○

×

サービス外

○

×

○

×

SRVICE_A

○

×

○

×

SRVICE_B

○

○

○

×

SRVICE_C

○

×

○

○

（凡例）

○：取得します。

×：取得しません。

-uオプションにsvcを指定した場合，-sオプションに指定したサーバ名や，-vオプションに指定したサービス名が存在するかのチェックは行いません。また，-uオプションにobjを指定した場合，-oオプションや-bオプションに指定した値が妥当であるかどうかのチェックは行いません。不要な取得対象を登録した場合は，rtslsコマンドを実行して取得対象の構成を確認し，-dオプションを指定したrtsstatsコマンドを実行して削除してください。

リアルタイム統計情報サービスの開始後にユーザサービス定義に追加または削除したサービスは，rtsput定義コマンドの-uオプションにsrvを指定している場合でも，リアルタイム統計情報の取得対象に反映されません。リアルタイム統計情報サービスの開始後に取得対象の設定を変更するには，rtsstatsコマンドを使用するか，またはリアルタイム統計情報サービス（RTSSUP）を再起動してください。

また，リアルタイム統計情報サービスの開始後に，サービス関数動的ローディング機能で追加または削除したサービスも，リアルタイム統計情報の取得対象に反映されません。リアルタイム統計情報サービスの開始後に取得対象の設定を変更するには，rtsstatsコマンドを使用するか，またはリアルタイム統計情報サービス（RTSSUP）を再起動してください。

リアルタイム取得項目定義

形式

set形式

〔set rts_cpd_collct_cpd=Y|N〕
〔set rts_cpd_validt_cpd=Y|N〕
〔set rts_jnl_buf_full=Y|N〕
〔set rts_jnl_wait_buf=Y|N〕
〔set rts_jnl_jnl_output=Y|N〕
〔set rts_jnl_io_wait=Y|N〕
〔set rts_jnl_write=Y|N〕
〔set rts_jnl_swap=Y|N〕
〔set rts_jnl_jnl_input=Y|N〕
〔set rts_jnl_read=Y|N〕
〔set rts_lck_lock_acqst=Y|N〕
〔set rts_lck_lock_wait=Y|N〕
〔set rts_lck_deadlock=Y|N〕
〔set rts_nam_global_cache_hit=Y|N〕
〔set rts_nam_local_cache_hit=Y|N〕
〔set rts_nam_lookup=Y|N〕
〔set rts_nam_node_lookup=Y|N〕
〔set rts_nam_node_lookup_responce=Y|N〕
〔set rts_osl_stamem_acq=Y|N〕
〔set rts_osl_stamem_pol=Y|N〕
〔set rts_osl_dynmem_acq=Y|N〕
〔set rts_osl_dynmem_pol=Y|N〕
〔set rts_prc_prc_genert=Y|N〕
〔set rts_prc_uap_abnml=Y|N〕
〔set rts_prc_sys_abnml=Y|N〕
〔set rts_prc_prc_term=Y|N〕
〔set rts_prc_prc_num=Y|N〕
〔set rts_que_read=Y|N〕
〔set rts_que_write=Y|N〕
〔set rts_que_read_err=Y|N〕
〔set rts_que_write_err=Y|N〕
〔set rts_que_wait_buf=Y|N〕
〔set rts_que_real_read=Y|N〕
〔set rts_que_real_write=Y|N〕
〔set rts_que_delay_wrt=Y|N〕
〔set rts_que_delay_rec=Y|N〕
〔set rts_que_delay_msg=Y|N〕
〔set rts_rpc_rpc_call=Y|N〕
〔set rts_rpc_rpc_call_chained=Y|N〕
〔set rts_rpc_usr_srvc=Y|N〕
〔set rts_rpc_rpc_ovrtim=Y|N〕
〔set rts_scd_scd_wait=Y|N〕
〔set rts_scd_schedule=Y|N〕
〔set rts_scd_using_buf=Y|N〕
〔set rts_scd_lack_buf=Y|N〕
〔set rts_scd_scd_stay=Y|N〕
〔set rts_scd_svc_scd_wait=Y|N〕
〔set rts_scd_svc_using_buf=Y|N〕
〔set rts_scd_parallel=Y|N〕
〔set rts_trn_commit=Y|N〕
〔set rts_trn_rollback=Y|N〕
〔set rts_trn_cmt_cmd=Y|N〕
〔set rts_trn_rbk_cmd=Y|N〕
〔set rts_trn_haz_cmd=Y|N〕
〔set rts_trn_mix_cmd=Y|N〕
〔set rts_trn_branch=Y|N〕
〔set rts_trn_sync_point=Y|N〕
〔set rts_dam_read=Y|N〕
〔set rts_dam_read_err=Y|N〕
〔set rts_dam_write=Y|N〕
〔set rts_dam_write_err=Y|N〕
〔set rts_dam_fj=Y|N〕
〔set rts_dam_trn_branch=Y|N〕
〔set rts_dam_cache_block=Y|N〕
〔set rts_dam_shm_pool=Y|N〕
〔set rts_tam_real_renew=Y|N〕
〔set rts_tam_real_renew_time=Y|N〕
〔set rts_tam_rec_refer=Y|N〕
〔set rts_tam_rec_renew=Y|N〕
〔set rts_tam_read=Y|N〕
〔set rts_tam_read_err=Y|N〕
〔set rts_tam_write=Y|N〕
〔set rts_tam_write_err=Y|N〕
〔set rts_xar_start=Y|N〕
〔set rts_xar_start_err=Y|N〕
〔set rts_xar_call=Y|N〕
〔set rts_xar_call_err=Y|N〕
〔set rts_xar_end=Y|N〕
〔set rts_xar_end_err=Y|N〕
〔set rts_xar_prepare=Y|N〕
〔set rts_xar_prepare_err=Y|N〕
〔set rts_xar_commit=Y|N〕
〔set rts_xar_commit_err=Y|N〕
〔set rts_xar_rollback=Y|N〕
〔set rts_xar_rollback_err=Y|N〕
〔set rts_xar_recover=Y|N〕
〔set rts_xar_recover_err=Y|N〕
〔set rts_xar_forget=Y|N〕
〔set rts_xar_forget_err=Y|N〕
〔set rts_mcf_ap_scd_stay=Y|N〕
〔set rts_mcf_ap_usr_srvc=Y|N〕
〔set rts_mcf_in_msg_scd_wait=Y|N〕
〔set rts_mcf_out_msg_sync_scd_wait=Y|N〕
〔set rts_mcf_out_msg_resp_scd_wait=Y|N〕
〔set rts_mcf_out_msg_prio_scd_wait=Y|N〕
〔set rts_mcf_out_msg_norm_scd_wait=Y|N〕
〔set rts_mcf_que_scd_wait_num=Y|N〕

コマンド形式

なし。

機能

リアルタイム統計情報サービスで取得する統計情報の項目を定義します。

説明

set形式のオペランド

チェックポイントダンプ情報

●rts_cpd_collct_cpd=Y|N

　〜《N》

チェックポイントダンプ取得イベントを取得するかどうかを指定します。

Y

チェックポイントダンプ取得イベントを取得します。

N

チェックポイントダンプ取得イベントを取得しません。

●rts_cpd_validt_cpd=Y|N

　〜《N》

チェックポイントダンプ有効化イベントを取得するかどうかを指定します。

Y

チェックポイントダンプ有効化イベントを取得します。

N

チェックポイントダンプ有効化イベントを取得しません。

ジャーナル情報

●rts_jnl_buf_full=Y|N

　〜《N》

バッファ満杯イベントを取得するかどうかを指定します。

Y

バッファ満杯イベントを取得します。

N

バッファ満杯イベントを取得しません。

●rts_jnl_wait_buf=Y|N

　〜《N》

空きバッファ待ちイベントを取得するかどうかを指定します。

Y

空きバッファ待ちイベントを取得します。

N

空きバッファ待ちイベントを取得しません。

●rts_jnl_jnl_output=Y|N

　〜《N》

ジャーナル出力（ブロック）イベントを取得するかどうかを指定します。

Y

ジャーナル出力（ブロック）イベントを取得します。

N

ジャーナル出力（ブロック）イベントを取得しません。

●rts_jnl_io_wait=Y|N

　〜《N》

入出力待ちイベントを取得するかどうかを指定します。

Y

入出力待ちイベントを取得します。

N

入出力待ちイベントを取得しません。

●rts_jnl_write=Y|N

　〜《N》

ジャーナル情報のwriteイベントを取得するかどうかを指定します。

Y

writeイベントを取得します。

N

writeイベントを取得しません。

●rts_jnl_swap=Y|N

　〜《N》

スワップイベントを取得するかどうかを指定します。

Y

スワップイベントを取得します。

N

スワップイベントを取得しません。

●rts_jnl_jnl_input=Y|N

〜《N》

ジャーナル入力イベントを取得するかどうかを指定します。

Y

ジャーナル入力イベントを取得します。

N

ジャーナル入力イベントを取得しません。

●rts_jnl_read=Y|N

　〜《N》

ジャーナル情報のreadイベントを取得するかどうかを指定します。

Y

readイベントを取得します。

N

readイベントを取得しません。

ロック情報

●rts_lck_lock_acqst=Y|N

　〜《N》

ロック取得イベントを取得するかどうかを指定します。

Y

ロック取得イベントを取得します。

N

ロック取得イベントを取得しません。

●rts_lck_lock_wait=Y|N

　〜《N》

ロック待ちイベントを取得するかどうかを指定します。

Y

ロック待ちイベントを取得します。

N

ロック待ちイベントを取得しません。

●rts_lck_deadlock=Y|N

　〜《N》

デッドロックイベントを取得するかどうかを指定します。

Y

デッドロックイベントを取得します。

N

デッドロックイベントを取得しません。

ネーム情報

●rts_nam_global_cache_hit=Y|N

　〜《N》

グローバルキャッシュヒットイベントを取得するかどうかを指定します。

Y

グローバルキャッシュヒットイベントを取得します。

N

グローバルキャッシュヒットイベントを取得しません。

●rts_nam_local_cache_hit=Y|N

　〜《N》

ローカルキャッシュヒットイベントを取得するかどうかを指定します。

Y

ローカルキャッシュヒットイベントを取得します。

N

ローカルキャッシュヒットイベントを取得しません。

●rts_nam_lookup=Y|N

　〜《N》

サービス情報の検索回数イベントを取得するかどうかを指定します。

Y

サービス情報の検索回数イベントを取得します。

N

サービス情報の検索回数イベントを取得しません。

●rts_nam_node_lookup=Y|N

　〜《N》

指定参照先ノードへのサービス検索の送信回数イベントを取得するかどうかを指定します。

Y

指定参照先ノードへのサービス検索の送信回数イベントを取得します。

N

指定参照先ノードへのサービス検索の送信回数イベントを取得しません。

●rts_nam_node_lookup_responce=Y|N

　〜《N》

指定参照先ノードへのサービス検索の応答送信回数イベントを取得するかどうかを指定します。

Y

指定参照先ノードへのサービス検索の応答受信回数イベントを取得します。

N

指定参照先ノードへのサービス検索の応答受信回数イベントを取得しません。

共用メモリ管理情報

●rts_osl_stamem_acq=Y|N

　〜《N》

静的共用メモリの使用サイズイベントを取得するかどうかを指定します。

Y

静的共用メモリの使用サイズイベントを取得します。

N

静的共用メモリの使用サイズイベントを取得しません。

●rts_osl_stamem_pol=Y|N

　〜《N》

静的共用メモリプールの必要最大サイズイベントを取得するかどうかを指定します。

Y

静的共用メモリプールの必要最大サイズイベントを取得します。

N

静的共用メモリプールの必要最大サイズイベントを取得しません。

●rts_osl_dynmem_acq=Y|N

　〜《N》

動的共用メモリの使用サイズイベントを取得するかどうかを指定します。

Y

動的共用メモリの使用サイズイベントを取得します。

N

動的共用メモリの使用サイズイベントを取得しません。

●rts_osl_dynmem_pol=Y|N

　〜《N》

動的共用メモリプールの必要最大サイズイベントを取得するかどうかを指定します。

Y

動的共用メモリプールの必要最大サイズイベントを取得します。

N

動的共用メモリプールの必要最大サイズイベントを取得しません。

プロセス情報

●rts_prc_prc_genert=Y|N

　〜《N》

プロセス生成イベントを取得するかどうかを指定します。

Y

プロセス生成イベントを取得します。

N

プロセス生成イベントを取得しません。

●rts_prc_uap_abnml=Y|N

　〜《N》

UAP異常終了イベントを取得するかどうかを指定します。

Y

UAP異常終了イベントを取得します。

N

UAP異常終了イベントを取得しません。

●rts_prc_sys_abnml=Y|N

　〜《N》

システムサーバ異常終了イベントを取得するかどうかを指定します。

Y

システムサーバ異常終了イベントを取得します。

N

システムサーバ異常終了イベントを取得しません。

●rts_prc_prc_term=Y|N

　〜《N》

プロセス終了イベントを取得するかどうかを指定します。

Y

プロセス終了イベントを取得します。

N

プロセス終了イベントを取得しません。

●rts_prc_prc_num=Y|N

　〜《N》

起動プロセス数の監視イベントを取得するかどうかを指定します。

Y

起動プロセス数の監視イベントを取得します。

N

起動プロセス数の監視イベントを取得しません。

メッセージキュー情報

●rts_que_read=Y|N

　〜《N》

readメッセージイベントを取得するかどうかを指定します。

Y

readメッセージイベントを取得します。

N

readメッセージイベントを取得しません。

●rts_que_write=Y|N

　〜《N》

writeメッセージイベントを取得するかどうかを指定します。

Y

writeメッセージイベントを取得します。

N

writeメッセージイベントを取得しません。

●rts_que_read_err=Y|N

　〜《N》

メッセージキュー情報のreadエラーイベントを取得するかどうかを指定します。

Y

readエラーイベントを取得します。

N

readエラーイベントを取得しません。

●rts_que_write_err=Y|N

　〜《N》

メッセージキュー情報のwriteエラーイベントを取得するかどうかを指定します。

Y

writeエラーイベントを取得します。

N

writeエラーイベントを取得しません。

●rts_que_wait_buf=Y|N

　〜《N》

メッセージキュー情報の空きバッファ待ちイベントを取得するかどうかを指定します。

Y

空きバッファ待ちイベントを取得します。

N

空きバッファ待ちイベントを取得しません。

●rts_que_real_read=Y|N

　〜《N》

メッセージキュー情報の実readイベントを取得するかどうかを指定します。

Y

実readイベントを取得します。

N

実readイベントを取得しません。

●rts_que_real_write=Y|N

　〜《N》

メッセージキュー情報の実writeイベントを取得するかどうかを指定します。

Y

実writeイベントを取得します。

N

実writeイベントを取得しません。

●rts_que_delay_wrt=Y|N

　〜《N》

遅延書き込み（回数）イベントを取得するかどうかを指定します。

Y

遅延書き込み（回数）イベントを取得します。

N

遅延書き込み（回数）イベントを取得しません。

●rts_que_delay_rec=Y|N

　〜《N》

物理ファイル単位の遅延書き込み（レコード）イベントを取得するかどうかを指定します。

Y

物理ファイル単位の遅延書き込み（レコード）イベントを取得します。

N

物理ファイル単位の遅延書き込み（レコード）イベントを取得しません。

●rts_que_delay_msg=Y|N

　〜《N》

物理ファイル単位の遅延書き込み（メッセージ）イベントを取得するかどうかを指定します。

Y

物理ファイル単位の遅延書き込み（メッセージ）イベントを取得します。

N

物理ファイル単位の遅延書き込み（メッセージ）イベントを取得しません。

RPC情報

●rts_rpc_rpc_call=Y|N

　〜《N》

RPCコール（同期応答型）イベントを取得するかどうかを指定します。

Y

RPCコール（同期応答型）イベントを取得します。

N

RPCコール（同期応答型）イベントを取得しません。

●rts_rpc_rpc_call_chained=Y|N

　〜《N》

RPCコール（連鎖RPC型）イベントを取得するかどうかを指定します。

Y

RPCコール（連鎖RPC型）イベントを取得します。

N

RPCコール（連鎖RPC型）イベントを取得しません。

●rts_rpc_usr_srvc=Y|N

　〜《N》

ユーザサービス実行イベントを取得するかどうかを指定します。

Y

ユーザサービス実行イベントを取得します。

N

ユーザサービス実行イベントを取得しません。

●rts_rpc_rpc_ovrtim=Y|N

　〜《N》

RPCタイムアウトイベントを取得するかどうかを指定します。

Y

RPCタイムアウトイベントを取得します。

N

RPCタイムアウトイベントを取得しません。

スケジュール情報

●rts_scd_scd_wait=Y|N

　〜《N》

スケジュール待ちイベントを取得するかどうかを指定します。

Y

スケジュール待ちイベントを取得します。

N

スケジュール待ちイベントを取得しません。

●rts_scd_schedule=Y|N

　〜《N》

スケジュールイベントを取得するかどうかを指定します。

Y

スケジュールイベントを取得します。

N

スケジュールイベントを取得しません。

●rts_scd_using_buf=Y|N

　〜《N》

メッセージ格納バッファプールの使用中サイズイベントを取得するかどうかを指定します。

Y

メッセージ格納バッファプールの使用中サイズイベントを取得します。

N

メッセージ格納バッファプールの使用中サイズイベントを取得しません。

●rts_scd_lack_buf=Y|N

　〜《N》

メッセージ格納バッファプールの不足で，スケジュールできなかったメッセージサイズイベントを取得するかどうかを指定します。

Y

メッセージ格納バッファプールの不足で，スケジュールできなかったメッセージサイズイベントを取得します。

N

メッセージ格納バッファプールの不足で，スケジュールできなかったメッセージサイズイベントを取得しません。

●rts_scd_scd_stay=Y|N

　〜《N》

スケジュール滞留イベントを取得するかどうかを指定します。

Y

スケジュール滞留イベントを取得します。

N

スケジュール滞留イベントを取得しません。

●rts_scd_svc_scd_wait=Y|N

　〜《N》

サービス単位のスケジュール待ちイベントを取得するかどうかを指定します。

Y

サービス単位のスケジュール待ちイベントを取得します。

N

サービス単位のスケジュール待ちイベントを取得しません。

●rts_scd_svc_using_buf=Y|N

　〜《N》

サービス単位のメッセージ格納バッファプールの使用中サイズイベントを取得するかどうかを指定します。

Y

サービス単位のメッセージ格納バッファプールの使用中サイズイベントを取得します。

N

サービス単位のメッセージ格納バッファプールの使用中サイズイベントを取得しません。

●rts_scd_parallel=Y|N

　〜《N》

同時実行サービス数イベントを取得するかどうかを指定します。

Y

同時実行サービス数イベントを取得します。

N

同時実行サービス数イベントを取得しません。

トランザクション情報

●rts_trn_commit=Y|N

　〜《N》

コミットイベントを取得するかどうかを指定します。

Y

コミットイベントを取得します。

N

コミットイベントを取得しません。

●rts_trn_rollback=Y|N

　〜《N》

ロールバックイベントを取得するかどうかを指定します。

Y

ロールバックイベントを取得します。

N

ロールバックイベントを取得しません。

●rts_trn_cmt_cmd=Y|N

　〜《N》

コマンドによるコミットイベントを取得するかどうかを指定します。

Y

コマンドによるコミットイベントを取得します。

N

コマンドによるコミットイベントを取得しません。

●rts_trn_rbk_cmd=Y|N

　〜《N》

コマンドによるロールバックイベントを取得するかどうかを指定します。

Y

コマンドによるロールバックイベントを取得します。

N

コマンドによるロールバックイベントを取得しません。

●rts_trn_haz_cmd=Y|N

　〜《N》

コマンドによるハザードイベントを取得するかどうかを指定します。

Y

コマンドによるハザードイベントを取得します。

N

コマンドによるハザードイベントを取得しません。

●rts_trn_mix_cmd=Y|N

　〜《N》

コマンドによるミックスイベントを取得するかどうかを指定します。

Y

コマンドによるミックスイベントを取得します。

N

コマンドによるミックスイベントを取得しません。

●rts_trn_branch=Y|N

　〜《N》

ブランチ実行時間イベントを取得するかどうかを指定します。

Y

ブランチ実行時間イベントを取得します。

N

ブランチ実行時間イベントを取得しません。

●rts_trn_sync_point=Y|N

　〜《N》

ブランチ同期点処理の実行時間イベントを取得するかどうかを指定します。

Y

ブランチ同期点処理の実行時間イベントを取得します。

N

ブランチ同期点処理の実行時間イベントを取得しません。

DAM情報

●rts_dam_read=Y|N

　〜《N》

DAM情報のreadイベントを取得するかどうかを指定します。

Y

readイベントを取得します。

N

readイベントを取得しません。

●rts_dam_read_err=Y|N

　〜《N》

DAM情報のreadエラーイベントを取得するかどうかを指定します。

Y

readエラーイベントを取得します。

N

readエラーイベントを取得しません。

●rts_dam_write=Y|N

　〜《N》

DAM情報のwriteイベントを取得するかどうかを指定します。

Y

writeイベントを取得します。

N

writeイベントを取得しません。

●rts_dam_write_err=Y|N

　〜《N》

DAM情報のwriteエラーイベントを取得するかどうかを指定します。

Y

writeエラーイベントを取得します。

N

writeエラーイベントを取得しません。

●rts_dam_fj=Y|N

　〜《N》

FJ出力回数イベントを取得するかどうかを指定します。

Y

FJ出力回数イベントを取得します。

N

FJ出力回数イベントを取得しません。

●rts_dam_trn_branch=Y|N

　〜《N》

同時実行DAMトランザクションブランチ数イベントを取得するかどうかを指定します。

Y

同時実行DAMトランザクションブランチ数イベントを取得します。

N

同時実行DAMトランザクションブランチ数イベントを取得しません。

●rts_dam_cache_block=Y|N

　〜《N》

DAMキャッシュブロックの確保回数イベントを取得するかどうかを指定します。

Y

DAMキャッシュブロックの確保回数イベントを取得します。

N

DAMキャッシュブロックの確保回数イベントを取得しません。

●rts_dam_shm_pool=Y|N

　〜《N》

DAMキャッシュ用の共用メモリの使用率イベントを取得するかどうかを指定します。

Y

DAMキャッシュ用の共用メモリの使用率イベントを取得します。

N

DAMキャッシュ用の共用メモリの使用率イベントを取得しません。

TAM情報

●rts_tam_real_renew=Y|N

　〜《N》

TAMファイル実更新イベントを取得するかどうかを指定します。

Y

TAMファイル実更新イベントを取得します。

N

TAMファイル実更新イベントを取得しません。

●rts_tam_real_renew_time=Y|N

　〜《N》

TAMファイル実更新時間イベントを取得するかどうかを指定します。

Y

TAMファイル実更新時間イベントを取得します。

N

TAMファイル実更新時間イベントを取得しません。

●rts_tam_rec_refer=Y|N

　〜《N》

コミット，ロールバック（レコード参照）イベントを取得するかどうかを指定します。

Y

コミット，ロールバック（レコード参照）イベントを取得します。

N

コミット，ロールバック（レコード参照）イベントを取得しません。

●rts_tam_rec_renew=Y|N

　〜《N》

コミット，ロールバック（レコード更新）イベントを取得するかどうかを指定します。

Y

コミット，ロールバック（レコード更新）イベントを取得します。

N

コミット，ロールバック（レコード更新）イベントを取得しません。

●rts_tam_read=Y|N

　〜《N》

TAM情報のreadイベントを取得するかどうかを指定します。

Y

readイベントを取得します。

N

readイベントを取得しません。

●rts_tam_read_err=Y|N

　〜《N》

TAM情報のreadエラーイベントを取得するかどうかを指定します。

Y

readエラーイベントを取得します。

N

readエラーイベントを取得しません。

●rts_tam_write=Y|N

　〜《N》

TAM情報のwriteイベントを取得するかどうかを指定します。

Y

writeイベントを取得します。

N

writeイベントを取得しません。

●rts_tam_write_err=Y|N

　〜《N》

TAM情報のwriteエラーイベントを取得するかどうかを指定します。

Y

writeエラーイベントを取得します。

N

writeエラーイベントを取得しません。

XAリソースサービス情報

●rts_xar_start=Y|N

　〜《N》

アプリケーションサーバからRAPサーバへのトランザクション開始要求の回数イベントを取得するかどうかを指定します。

Y

アプリケーションサーバからRAPサーバへのトランザクション開始要求の回数イベントを取得します。

N

アプリケーションサーバからRAPサーバへのトランザクション開始要求の回数イベントを取得しません。

●rts_xar_start_err=Y|N

　〜《N》

アプリケーションサーバからRAPサーバへのトランザクション開始要求でのエラーイベントを取得するかどうかを指定します。

Y

アプリケーションサーバからRAPサーバへのトランザクション開始要求でのエラーイベントを取得します。

N

アプリケーションサーバからRAPサーバへのトランザクション開始要求でのエラーイベントを取得しません。

●rts_xar_call=Y|N

　〜《N》

アプリケーションサーバからRAPサーバへのサービス要求の回数イベントを取得するかどうかを指定します。

Y

アプリケーションサーバからRAPサーバへのサービス要求の回数イベントを取得します。

N

アプリケーションサーバからRAPサーバへのサービス要求の回数イベントを取得しません。

●rts_xar_call_err=Y|N

　〜《N》

アプリケーションサーバからRAPサーバへのサービス要求でのエラーイベントを取得するかどうかを指定します。

Y

アプリケーションサーバからRAPサーバへのトランザクション開始要求のエラーイベントを取得します。

N

アプリケーションサーバからRAPサーバへのトランザクション開始要求のエラーイベントを取得しません。

●rts_xar_end=Y|N

　〜《N》

アプリケーションサーバからRAPサーバへのトランザクション終了要求の回数イベントを取得するかどうかを指定します。

Y

アプリケーションサーバからRAPサーバへのトランザクション終了要求の回数イベントを取得します。

N

アプリケーションサーバからRAPサーバへのトランザクション終了要求の回数イベントを取得しません。

●rts_xar_end_err=Y|N

　〜《N》

アプリケーションサーバからRAPサーバへのトランザクション終了要求でのエラーイベントを取得するかどうかを指定します。

Y

アプリケーションサーバからRAPサーバへのトランザクション終了要求でのエラーイベントを取得します。

N

アプリケーションサーバからRAPサーバへのトランザクション終了要求でのエラーイベントを取得しません。

●rts_xar_prepare=Y|N

　〜《N》

アプリケーションサーバからRAPサーバへのトランザクションのプリペア処理要求の回数イベントを取得するかどうかを指定します。

Y

アプリケーションサーバからRAPサーバへのトランザクションのプリペア処理要求の回数イベントを取得します。

N

アプリケーションサーバからRAPサーバへのトランザクションのプリペア処理要求の回数イベントを取得しません。

●rts_xar_prepare_err=Y|N

　〜《N》

アプリケーションサーバからRAPサーバへのトランザクションのプリペア処理要求でのエラーイベントを取得するかどうかを指定します。

Y

アプリケーションサーバからRAPサーバへのトランザクションのプリペア処理要求でエラーイベントを取得します。

N

アプリケーションサーバからRAPサーバへのトランザクションのプリペア処理要求でのエラーイベントを取得しません。

●rts_xar_commit=Y|N

　〜《N》

アプリケーションサーバからRAPサーバへのトランザクションのコミット処理要求の回数イベントを取得するかどうかを指定します。

Y

アプリケーションサーバからRAPサーバへのトランザクションのコミット処理要求の回数イベントを取得します。

N

アプリケーションサーバからRAPサーバへのトランザクションのコミット処理要求の回数イベントを取得しません。

●rts_xar_commit_err=Y|N

　〜《N》

アプリケーションサーバからRAPサーバへのトランザクションのコミット処理要求でのエラーイベントを取得するかどうかを指定します。

Y

アプリケーションサーバからRAPサーバへのトランザクションのコミット処理要求でのエラーイベントを取得します。

N

アプリケーションサーバからRAPサーバへのトランザクションのコミット処理要求でのエラーイベントを取得しません。

●rts_xar_rollback=Y|N

　〜《N》

アプリケーションサーバからRAPサーバへのトランザクションのロールバック処理要求の回数イベントを取得するかどうかを指定します。

Y

アプリケーションサーバからRAPサーバへのトランザクションのロールバック処理要求の回数イベントを取得します。

N

アプリケーションサーバからRAPサーバへのトランザクションのロールバック処理要求の回数イベントを取得しません。

●rts_xar_rollback_err=Y|N

　〜《N》

アプリケーションサーバからRAPサーバへのトランザクションのロールバック処理要求でのエラーイベントを取得するかどうかを指定します。

Y

アプリケーションサーバからRAPサーバへのトランザクションのロールバック処理要求でのエラーイベントを取得します。

N

アプリケーションサーバからRAPサーバへのトランザクションのロールバック処理要求でのエラーイベントを取得しません。

●rts_xar_recover=Y|N

　〜《N》

アプリケーションサーバからRAPサーバへのプリペア済み，またはヒューリスティック完了したトランザクション通知要求の回数イベントを取得するかどうかを指定します。

Y

アプリケーションサーバからRAPサーバへのプリペア済み，またはヒューリスティック完了したトランザクション通知要求の回数イベントを取得します。

N

アプリケーションサーバからRAPサーバへのプリペア済み，またはヒューリスティック完了したトランザクション通知要求の回数イベントを取得しません。

●rts_xar_recover_err=Y|N

　〜《N》

アプリケーションサーバからRAPサーバへのプリペア済み，またはヒューリスティック完了したトランザクション通知要求でのエラーイベントを取得するかどうかを指定します。

Y

アプリケーションサーバからRAPサーバへのプリペア済み，またはヒューリスティック完了したトランザクション通知要求でのエラーイベントを取得します。

N

アプリケーションサーバからRAPサーバへのプリペア済み，またはヒューリスティック完了したトランザクション通知要求でのエラーイベントを取得しません。

●rts_xar_forget=Y|N

　〜《N》

アプリケーションサーバからRAPサーバへのトランザクション破棄要求の回数イベントを取得するかどうかを指定します。

Y

アプリケーションサーバからRAPサーバへのトランザクション破棄要求の回数イベントを取得します。

N

アプリケーションサーバからRAPサーバへのトランザクション破棄要求の回数イベントを取得しません。

●rts_xar_forget_err=Y|N

　〜《N》

アプリケーションサーバからRAPサーバへのトランザクション破棄要求でのエラーイベントを取得するかどうかを指定します。

Y

アプリケーションサーバからRAPサーバへのトランザクション破棄要求でのエラーイベントを取得します。

N

アプリケーションサーバからRAPサーバへのトランザクション破棄要求でのエラーイベントを取得しません。

MCF情報

●rts_mcf_ap_scd_stay=Y|N

　〜《N》

スケジュール待ち情報を取得するかどうかを指定します。

Y

スケジュール待ち情報を取得します。

N

スケジュール待ち情報を取得しません。

●rts_mcf_ap_usr_srvc=Y|N

　〜《N》

ユーザサービス実行情報を取得するかどうかを指定します。

Y

ユーザサービス実行情報を取得します。

N

ユーザサービス実行情報を取得しません。

●rts_mcf_in_msg_scd_wait=Y|N

　〜《N》

論理端末単位に受信メッセージの処理待ち情報を取得するかどうかを指定します。

Y

論理端末単位に受信メッセージの処理待ち情報を取得します。

N

論理端末単位に受信メッセージの処理待ち情報を取得しません。

●rts_mcf_out_msg_sync_scd_wait=Y|N

　〜《N》

同期型送信メッセージの処理待ち情報を取得するかどうかを指定します。

Y

同期型送信メッセージの処理待ち情報を取得します。

N

同期型送信メッセージの処理待ち情報を取得しません。

●rts_mcf_out_msg_resp_scd_wait=Y|N

　〜《N》

問い合わせ応答型送信メッセージの処理待ち情報を取得するかどうかを指定します。

Y

問い合わせ応答型送信メッセージの処理待ち情報を取得します。

N

問い合わせ応答型送信メッセージの処理待ち情報を取得しません。

●rts_mcf_out_msg_prio_scd_wait=Y|N

　〜《N》

優先分岐型送信メッセージの処理待ち情報を取得するかどうかを指定します。

Y

優先分岐型送信メッセージの処理待ち情報を取得します。

N

優先分岐型送信メッセージの処理待ち情報を取得しません。

●rts_mcf_out_msg_norm_scd_wait=Y|N

　〜《N》

一般分岐型送信メッセージの処理待ち情報を取得するかどうかを指定します。

Y

一般分岐型送信メッセージの処理待ち情報を取得します。

N

一般分岐型送信メッセージの処理待ち情報を取得しません。

●rts_mcf_que_scd_wait_num=Y|N

　〜《N》

入力キューの滞留数の情報を取得するかどうかを指定します。

Y

入力キューの滞留数の情報を取得します。

N

入力キューの滞留数の情報を取得しません。

コマンド形式

なし。

注意事項

rtsput定義コマンドやrtsstatsコマンドで指定した対象では取得できない項目の定義にYを指定した場合，統計情報を取得するための領域は確保しますが，リアルタイム統計情報は取得されません。

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

形式

set形式

〔set nice=プロセスの優先順位の変更〕
〔set parallel_count=常駐プロセス数〔,最大プロセス数〕〕
〔set hold=Y|N〕
〔set hold_recovery=Y|N〕
〔set deadlock_priority=デッドロックの優先順位〕
〔set schedule_priority=スケジュールの優先順位〕
〔set message_buflen=最大メッセージ長〕
〔set message_store_buflen=メッセージ格納バッファプール長〕
〔set trn_expiration_time=トランザクションブランチ限界経過時間〕
〔set trn_expiration_time_suspend=Y|N|F〕
〔set watch_next_chain_time=連鎖RPC間隔監視時間〕
〔set atomic_update=Y|N〕
〔set receive_from=queue|socket|none〕
〔set uap_trace_max=UAPトレース格納最大数〕
〔set uap_trace_file_put=Y|N〕
〔set term_watch_time=連続異常終了限界経過時間〕
〔set mcf_jnl_buff_size=MCFのジャーナルバッファの大きさ〕
〔set type=other|MHP〕
〔set balance_count=1プロセスが処理するサービス要求数〕
〔set uid=ユーザ識別子〕
〔set auto_restart=Y|N〕
〔set critical=Y|N〕
〔set lck_wait_priority=排他待ちの優先順位〕
〔set mcf_psv_id=アプリケーション起動プロセス識別子〕
〔set trn_cpu_time=トランザクションブランチCPU監視時間〕
〔set service_hold=Y|N〕
〔set service_priority_control=Y|N〕
〔set message_cell_size=スケジュールメッセージ格納セル長〕
〔set max_socket_msg=ソケット受信型サーバ受信メッセージ数の最大値〕
〔set max_socket_msglen=ソケット受信型サーバ受信メッセージ長の最大値〕
〔set trf_put=Y|N〕
〔set mcf_mgrid=アプリケーション起動プロセスの属するMCFマネジャ識別子〕
〔set mcf_service_max_count=MCF通信関数発行回数上限値〕
〔set trn_statistics_item=統計情報項目〔,統計情報項目〕…〕
〔set node_down_restart=Y|N〕
〔set rpc_response_statistics=Y|N〕
〔set server_type="betran"|"xatmi"|"xatmi_cbl〕
〔set trn_rm_open_close_scope=process|transaction〕
〔set trn_optimum_item=トランザクション最適化項目
                    〔,トランザクション最適化項目〕…〕
〔set purge_msgget=Y|N〕
〔set cancel_normal_terminate=Y|N〕
〔set prc_abort_signal=アボート用シグナル番号〕
〔set rpc_service_retry_count=サービスのリトライ回数の最大値〕
〔set rpc_extend_function=RPCサービスの機能拡張レベル〕
〔set max_socket_descriptors=ソケット用ファイル記述子の最大数〕
〔set max_open_fds=UAPプロセスでアクセスするファイルおよびパイプの最大数〕
〔set service_term_watch_time=連続サービス異常終了限界経過時間〕
〔set termed_after_service=Y|N〕
〔set xat_trn_expiration_time=同期点処理の限界経過監視時間〕
〔set xat_osi_usr=Y|N〕
〔set rpc_trace=Y|N〕
〔set rpc_trace_name="RPCトレースを取得するファイル名"〕
〔set rpc_trace_size=RPCトレースを取得するファイルのサイズ〕
〔set trn_rollback_information_put=no|self|remote|all〕
〔set schedule_method=msgque|namedpipe〕
〔set service_wait_time=ユーザサーバの非常駐プロセスのサービス
                        要求待ち時間〕
〔set mcf_spp_oj=Y|N〕
〔set adm_message_option=メッセージ出力指定〕
〔set trn_watch_time=トランザクション同期点処理時の最大通信待ち時間〕
〔set trn_limit_time=トランザクションブランチ最大実行可能時間〕
〔set trn_rollback_response_receive=Y|N〕
〔set trn_partial_recovery_type=type1|type2|type3〕
〔set rpc_destination_mode=namdonly|namd|definition〕
〔set rpc_rap_auto_connect=Y|N〕
〔set rpc_rap_inquire_time=リモートAPI機能を使用して要求するサービス
                           の問い合わせ間隔最大時間〕
〔set rpc_request_cancel_for_timedout=Y|N〕
〔set status_change_when_terming=Y|N〕
〔set service_expiration_time=サービス関数開始から終了までの
                              実行監視時間〕
〔set multi_schedule=Y|N〕
〔set make_queue_on_starting=Y|N〕
〔set loadcheck_interval=負荷監視インタバル時間〕
〔set levelup_queue_count=U1,U2〕
〔set leveldown_queue_count=D0,D1〕
〔set ipc_sockctl_highwater=
                      ソケットの一時クローズ処理開始数パーセンテージ
                   〔,ソケットの一時クローズ処理非対象数パーセンテージ〕〕
〔set ipc_sockctl_watchtime=ソケット再利用可能監視時間〕
〔set ipc_conn_interval=コネクション確立監視時間〕
〔set ipc_send_interval=データ送信監視間隔〕
〔set ipc_send_count=データ送信監視回数〕
〔set ipc_header_recv_time=通信制御データの受信監視時間〕
〔set rpc_close_after_send=Y|N〕
〔set rpc_send_retry_count=TCP/IPコネクションの接続時にエラーが発生した
                           場合のリトライ回数〕
〔set rpc_send_retry_interval=TCP/IPコネクションの接続時にエラーが発生し
                              た場合のリトライ間隔〕
〔set ipc_recvbuf_size=TCP/IPの受信バッファサイズ〕
〔set ipc_sendbuf_size=TCP/IPの送信バッファサイズ〕
〔set ipc_listen_sockbufset=Y|N〕
〔set polling_control_data=Y|N〕
〔set thread_yield_interval=ソケットの再利用指示を受信できる契機を
                            与えるインタバル時間〕
〔set groups=グループ識別子〔,グループ識別子〕…〕
〔set loadlevel_message=Y|N|A〕
〔set ipc_backlog_count=コネクション確立要求を格納するキューの長さ〕
〔set rpc_buffer_pool_max=プーリングするバッファ数〕
〔set schedule_delay_limit=スケジュール遅延限界経過時間〕
〔set schedule_delay_abort=Y|N〕
〔set rap_autoconnect_con_error_msg=Y|N〕
〔set core_shm_suppress=Y|N〕
〔set xat_connect_resp_time=通信イベント処理用SPPのアソシエーション確立の
                            最大応答待ち時間〕
〔set scd_poolfull_check_interval=KFCA00853-Eメッセージ出力インタバル
                                  時間〕
〔set scd_poolfull_check_count=KFCA00853-Eメッセージ出力判断値〕
〔set scd_pool_warning_use_rate=警告メッセージの出力判断値になるメッセージ
                                格納バッファプール使用率の上限値〕
〔set scd_pool_warning_interval=メッセージ格納バッファプール使用率超過時の
                                警告メッセージ出力インタバル時間〕
〔set ipc_tcpnodelay=Y|N〕
〔set stay_watch_queue_count=スケジュールキューの滞留監視判定を開始する際
                             の判断になるサービス要求滞留数〕
〔set stay_watch_check_rate=スケジュールキューの滞留監視判定処理で使用する
                            サービス要求の処理率〕
〔set stay_watch_abort=Y|N〕
〔set stay_watch_start_interval=スケジュールキューの滞留監視インタバル
                                時間〕
〔set stay_watch_check_interval=スケジュールキューの滞留監視判定インタバル
                                時間〕
〔set trn_completion_limit_time=トランザクション完了限界時間〕
〔set rap_message_id_change_level=メッセージIDの変更レベル〕
〔set log_audit_out_suppress=Y|N〕
〔set log_audit_message=監査ログを取得する項目のメッセージID
                     〔,監査ログを取得する項目のメッセージID〕…〕
〔set mcf_prf_trace=Y|N〕
〔set scd_refresh_process=Y|N〕
〔set rap_extend_function=リモートAPI機能機能拡張レベル〕
〔set prc_coredump_filter=coreファイルに共有メモリを含めるかの判断値〕
〔set watch_time=最大応答待ち時間〕
〔set scd_process_ctl_opt=0|1〕
〔set rpc_rap_inquire_time_check=Y|N〕
〔set stack_size_unlimited=Y|N〕

コマンド形式

〔trnrmid  -n  リソースマネジャ名
           -i  リソースマネジャ拡張子〔,リソースマネジャ拡張子〕…
         〔-k〕〕
〔scdbufgrp  -g  スケジュールバッファグループ名
           {〔-s  メッセージ格納バッファ使用制限サイズ〕｜
            〔-p  メッセージ格納バッファ使用制限率〕}〕
〔scdmulti  〔-g  マルチスケジューラグループ名〕〕
〔scdsvcdef 〔-c  サービス名〕
            〔-p  同時実行可能なサービス数〕
            〔-n  キューイング可能なサービス要求数〕
            〔-l  キューイング可能なメッセージ格納バッファプール長〕〕

putenv形式

{{〔putenv  環境変数名  環境変数値〕}}
〔putenv  XAT_CONNECT_RESP_TIME  通信イベント処理用SPPのアソシエーション
                                 確立の最大応答待ち時間〕

dcputenv形式

{{〔dcputenv  環境変数名  環境変数値〕}}

機能

ユーザサービス定義の省略時解釈値を定義します。

ユーザサービス定義で指定を省略した場合は，ユーザサービスデフォルト定義の指定が有効となります。

ユーザサービスデフォルト定義を変更すると，変更したオペランドを省略しているユーザサーバの動作に影響します。

また，rapリスナーサービス定義の省略時解釈値を定義します。ただし，rapリスナーサービス定義に反映されないオペランドおよび指定値がありますので，詳細は「rapリスナーサービス定義」の注意事項を参照してください。

説明

set形式のオペランド

●nice=プロセスの優先順位の変更

　〜〈符号なし整数〉((0〜39))《0》

ユーザサービス定義のniceオペランドの省略時解釈値を指定します。

●parallel_count=常駐プロセス数〔，最大プロセス数〕

　〜〈符号なし整数〉((0〜1024))《1》

ユーザサービス定義のparallel_countオペランドの省略時解釈値を指定します。

●hold=Y|N

　〜《Y》

ユーザサービス定義のholdオペランドの省略時解釈値を指定します。

●hold_recovery=Y|N

　〜《Y》

ユーザサービス定義のhold_recoveryオペランドの省略時解釈値を指定します。

システム環境定義のstart_scheduling_timingオペランドにBEFOREを指定した場合，このオペランドの指定に関係なく，閉塞状態は引き継がれません。閉塞状態を引き継ぐ場合は，スケジュールサービス定義のscd_hold_recoveryオペランドにFを指定してください。各オペランド指定による閉塞状態の引き継ぎについては，スケジュールサービス定義のscd_hold_recoveryオペランドを参照してください。

●deadlock_priority=デッドロックの優先順位

　〜〈符号なし整数〉((1〜127))《64》

ユーザサービス定義のdeadlock_priorityオペランドの省略時解釈値を指定します。

●schedule_priority=スケジュールの優先順位

　〜〈符号なし整数〉((1〜16))《8》

ユーザサービス定義のschedule_priorityオペランドの省略時解釈値を指定します。

●message_buflen=最大メッセージ長

　〜〈符号なし整数〉((1024〜31457280))《4096》（単位：バイト）

ユーザサービス定義のmessage_buflenオペランドの省略時解釈値を指定します。

●message_store_buflen=メッセージ格納バッファプール長

　〜〈符号なし整数〉((1024〜31457280))《4096》（単位：バイト）

ユーザサービス定義のmessage_store_buflenオペランドの省略時解釈値を指定します。

●trn_expiration_time=トランザクションブランチ限界経過時間

　〜〈符号なし整数〉((0〜65535))（単位：秒）

ユーザサービス定義のtrn_expiration_timeオペランドの省略時解釈値を指定します。

ここで指定を省略し，ユーザサービス定義でも省略した場合，トランザクションサービス定義の値を仮定します。

●trn_expiration_time_suspend=Y|N|F

ユーザサービス定義のtrn_expiration_time_suspendオペランドの省略時解釈値を指定します。

このオペランドと各種タイマ監視との関係については，「付録A.2　トランザクションの時間監視」を参照してください。

ここで指定を省略し，ユーザサービス定義でも省略した場合，トランザクションサービス定義の値を仮定します。

●watch_next_chain_time=連鎖RPC間隔監視時間

　〜〈符号なし整数〉((0〜65535))《180》（単位：秒）

ユーザサービス定義のwatch_next_chain_timeオペランドの省略時解釈値を指定します。

このオペランドと各種タイマ監視との関係については，「付録A.2　トランザクションの時間監視」を参照してください。

●atomic_update=Y|N

　〜《Y》

ユーザサービス定義のatomic_updateオペランドの省略時解釈値を指定します。

●receive_from=queue|socket|none

　〜《queue》

ソケット受信型サーバは廃止したため，socketは使用できません。

ユーザサービス定義のreceive_fromオペランドの省略時解釈値を指定します。

●uap_trace_max=UAPトレース格納最大数

　〜〈符号なし整数〉((0〜4095))《32》

ユーザサービス定義のuap_trace_maxオペランドの省略時解釈値を指定します。

●uap_trace_file_put=Y|N

ユーザサービス定義のuap_trace_file_putオペランドの省略時解釈値を指定します。ここで指定を省略し，ユーザサービス定義でも省略した場合，システム共通定義の値を仮定します。

●term_watch_time=連続異常終了限界経過時間

　〜〈符号なし整数〉((0〜32767))《30》（単位：分）

ユーザサービス定義のterm_watch_timeオペランドの省略時解釈値を指定します。

●mcf_jnl_buff_size=MCFのジャーナルバッファの大きさ

　〜〈符号なし整数〉((4096〜131072))（単位：バイト）

ユーザサービス定義のmcf_jnl_buff_sizeオペランドの省略時解釈値を指定します。

●type=other|MHP

　〜《other》

ユーザサービス定義のtypeオペランドの省略時解釈値を指定します。

●balance_count=1プロセスが処理するサービス要求数

　〜〈符号なし整数〉((0〜512))《3》

ユーザサービス定義のbalance_countオペランドの省略時解釈値を指定します。

●uid=ユーザ識別子

　〜〈符号なし整数〉((0〜4294967294))

ユーザサービス定義のuidオペランドの省略時解釈値を指定します。

省略した場合，OpenTP1管理者のユーザIDを仮定します。

最大値はOSに依存するので，使用しているOSのマニュアルを参照してください。

●auto_restart=Y|N

　〜《N》

ユーザサービス定義のauto_restartオペランドの省略時解釈値を指定します。

●critical=Y|N

　〜《N》

ユーザサービス定義のcriticalオペランドの省略時解釈値を指定します。

●lck_wait_priority=排他待ちの優先順位

　〜〈符号なし整数〉((0〜127))《0》

ユーザサービス定義のlck_wait_priorityオペランドの省略時解釈値を指定します。

●mcf_psv_id=アプリケーション起動プロセス識別子

　〜〈16進数字〉((01〜ff))

ユーザサービス定義のmcf_psv_idオペランドの省略時解釈値を指定します。

●trn_cpu_time=トランザクションブランチCPU監視時間

　〜〈符号なし整数〉((0〜65535))（単位：秒）

ユーザサービス定義のtrn_cpu_timeオペランドの省略時解釈値を指定します。

ここで指定を省略し，ユーザサービス定義でも省略した場合，トランザクションサービス定義の値を仮定します。

●service_hold=Y|N

　〜《N》

ユーザサービス定義のservice_holdオペランドの省略時解釈値を指定します。

●service_priority_control=Y|N

　〜《N》

ユーザサービス定義のservice_priority_controlオペランドの省略時解釈値を指定します。

●message_cell_size=スケジュールメッセージ格納セル長

　〜〈符号なし整数〉((512〜31457280))《512》（単位：バイト）

ユーザサービス定義のmessage_cell_sizeオペランドの省略時解釈値を指定します。

●max_socket_msg=ソケット受信型サーバ受信メッセージ数の最大値

　〜〈符号なし整数〉((1〜500))《100》

ユーザサービス定義のmax_socket_msgオペランドの省略時解釈値を指定します。

●max_socket_msglen=ソケット受信型サーバ受信メッセージ長の最大値

　〜〈符号なし整数〉((1〜30270))《10240》（単位：キロバイト）

ユーザサービス定義のmax_socket_msglenオペランドの省略時解釈値を指定します。

●trf_put=Y|N

　〜《N》

ユーザサービス定義のtrf_putオペランドの省略時解釈値を指定します。

●mcf_mgrid=アプリケーション起動プロセスの属するMCFマネジャ識別子

　〜〈識別子〉((A〜Z，a〜z))《A》

ユーザサービス定義のmcf_mgridオペランドの省略時解釈値を指定します。

●mcf_service_max_count=MCF通信関数発行回数上限値

　〜〈符号なし整数〉((0〜65535))

ユーザサービス定義のmcf_service_max_countオペランドの省略時解釈値を指定します。

●trn_statistics_item=統計情報項目〔，統計情報項目〕…

ユーザサービス定義のtrn_statistics_itemオペランドの省略時解釈値を指定します。

ここで指定を省略し，ユーザサービス定義でも省略した場合，トランザクションサービス定義の値を仮定します。

●node_down_restart=Y|N

　〜《Y》

ユーザサービス定義のnode_down_restartオペランドの省略時解釈値を指定します。

●rpc_response_statistics=Y|N

　〜《N》

ユーザサービス定義のrpc_response_statisticsオペランドの省略時解釈値を指定します。

●server_type="betran"|"xatmi"|"xatmi_cbl"

　〜《"betran"》

ユーザサービス定義のserver_typeオペランドの省略時解釈値を指定します。

●trn_rm_open_close_scope=process|transaction

ユーザサービス定義のtrn_rm_open_close_scopeオペランドの省略時解釈値を指定します。

ここで指定を省略し，ユーザサービス定義でも省略した場合，トランザクションサービス定義の値を仮定します。

●trn_optimum_item=トランザクション最適化項目〔，トランザクション最適化項目〕…

ユーザサービス定義のtrn_optimum_itemオペランドの省略時解釈値を指定します。

ここで指定を省略し，ユーザサービス定義でも省略した場合，トランザクションサービス定義の値を仮定します。

●purge_msgget=Y|N

　〜《N》

ユーザサービス定義のpurge_msggetオペランドの省略時解釈値を指定します。

●cancel_normal_terminate=Y|N

　〜《N》

ユーザサービス定義のcancel_normal_terminateオペランドの省略時解釈値を指定します。

●prc_abort_signal=アボート用シグナル番号

　〜〈符号なし整数〉((1〜128))《3》

ユーザサービス定義のprc_abort_signalオペランドの省略時解釈値を指定します。

●rpc_service_retry_count=サービスのリトライ回数の最大値

　〜〈符号なし整数〉((0〜65535))《0》

ユーザサービス定義のrpc_service_retry_countオペランドの省略時解釈値を指定します。

●rpc_extend_function=RPCサービスの機能拡張レベル

　〜〈16進数字〉((00000000〜0000000F))《00000000》

ユーザサービス定義のrpc_extend_functionオペランドの省略時解釈値を指定します。

●max_socket_descriptors=ソケット用ファイル記述子の最大数

　〜〈符号なし整数〉((32〜2032))

ユーザサービス定義のmax_socket_descriptorsオペランドの省略時解釈値を指定します。

指定値の範囲は，適用OSがAIX，HP-UXまたはWindowsの場合は32〜2032，適用OSがSolarisまたはLinuxの場合は32〜1008です。

ここで指定を省略し，ユーザサービス定義でも省略した場合，システム共通定義の値を仮定します。

●max_open_fds=UAPプロセスでアクセスするファイルおよびパイプの最大数

　〜〈符号なし整数〉((16〜2016))《50》

ユーザサービス定義のmax_open_fdsオペランドの省略時解釈値を指定します。

指定値の範囲は，適用OSがAIX，HP-UXまたはWindowsの場合は16〜2016，適用OSがSolarisまたはLinuxの場合は16〜992です。

●service_term_watch_time=連続サービス異常終了限界経過時間

　〜〈符号なし整数〉((0〜32767))《0》（単位：分）

ユーザサービス定義のservice_term_watch_timeオペランドの省略時解釈値を指定します。

●termed_after_service=Y|N

　〜《N》

ユーザサービス定義のtermed_after_serviceオペランドの省略時解釈値を指定します。

●xat_trn_expiration_time=同期点処理の限界経過監視時間

　〜〈符号なし整数〉((1〜2147483647))《180》（単位：秒）

ユーザサービス定義のxat_trn_expiration_timeオペランドの省略時解釈値を指定します。

●xat_osi_usr=Y|N

　〜《N》

ユーザサービス定義のxat_osi_usrオペランドの省略時解釈値を指定します。

●rpc_trace=Y|N

ユーザサービス定義のrpc_traceオペランドの省略時解釈値を指定します。

ここで指定を省略し，rapリスナーサービス定義およびユーザサービス定義でも省略した場合，システム共通定義の値を仮定します。

●rpc_trace_name="RPCトレースを取得するファイル名"

　〜〈パス名〉

ユーザサービス定義のrpc_trace_nameオペランドの省略時解釈値を指定します。

パス名のうち，RPCトレースを取得するファイル名（デフォルトはrpctr）の最大長は，13文字です。

パス名に環境変数を指定する場合，パス名の先頭に環境変数を指定してください（指定例：$DCDIR/tmp/ファイル名）。

ここで指定を省略し，rapリスナーサービス定義およびユーザサービス定義でも省略した場合，システム共通定義の値を仮定します。

●rpc_trace_size=RPCトレースを取得するファイルのサイズ

　〜〈符号なし整数〉((1024〜2147483648))（単位：バイト）

ユーザサービス定義のrpc_trace_sizeオペランドの省略時解釈値を指定します。

ここで指定を省略し，rapリスナーサービス定義およびユーザサービス定義でも省略した場合，システム共通定義の値を仮定します。

●trn_rollback_information_put=no|self|remote|all

ユーザサービス定義のtrn_rollback_information_putオペランドの省略時解釈値を指定します。

ここで指定を省略し，ユーザサービス定義でも省略した場合，トランザクションサービス定義の値を仮定します。

●schedule_method=msgque|namedpipe

　〜《msgque》

ユーザサービス定義のschedule_methodオペランドの省略時解釈値を指定します。

●service_wait_time=ユーザサーバの非常駐プロセスのサービス要求待ち時間

　〜〈符号なし整数〉((1〜4096))（単位：秒）

ユーザサービス定義のservice_wait_timeオペランドの省略時解釈値を指定します。

●mcf_spp_oj=Y|N

　〜《Y》

ユーザサービス定義のmcf_spp_ojオペランドの省略時解釈値を指定します。

●adm_message_option=メッセージ出力指定

　〜〈1けたの16進数〉《F》

ユーザサービス定義のadm_message_optionオペランドの省略時解釈値を指定します。

●trn_watch_time=トランザクション同期点処理時の最大通信待ち時間

　〜〈符号なし整数〉((1〜65535))（単位：秒）

ユーザサービス定義のtrn_watch_timeオペランドの省略時解釈値を指定します。

ここで指定を省略し，ユーザサービス定義でも省略した場合，トランザクションサービス定義の値を仮定します。さらに，トランザクションサービス定義でも省略した場合，トランザクションを行ったユーザサーバのwatch_timeの値を仮定します。ただし，watch_timeに0を指定した場合は120秒を仮定します。

●trn_limit_time=トランザクションブランチ最大実行可能時間

　〜〈符号なし整数〉((0〜65535))（単位：秒）

ユーザサービス定義のtrn_limit_timeオペランドの省略時解釈値を指定します。

ここで指定を省略し，ユーザサービス定義でも省略した場合，トランザクションサービス定義の値を仮定します。

●trn_rollback_response_receive=Y|N

ユーザサービス定義のtrn_rollback_response_receiveオペランドの省略時解釈値を指定します。

ここで指定を省略し，ユーザサービス定義でも省略した場合，トランザクションサービス定義の値を仮定します。

●trn_partial_recovery_type=type1|type2|type3

ユーザサービス定義のtrn_partial_recovery_typeオペランドの省略時解釈値を指定します。

ここで指定を省略し，ユーザサービス定義でも省略した場合，トランザクションサービス定義の値を仮定します。

●rpc_destination_mode=namdonly|namd|definition

　〜《definition》

ユーザサービス定義のrpc_destination_modeオペランドの省略時解釈値を指定します。

●rpc_rap_auto_connect=Y|N

　〜《Y》

ユーザサービス定義のrpc_rap_auto_connectオペランドの省略時解釈値を指定します。

●rpc_rap_inquire_time=リモートAPI機能を使用して要求するサービスの問い合わせ間隔最大時間

　〜〈符号なし整数〉((0〜1048575))《0》（単位：秒）

ユーザサービス定義のrpc_rap_inquire_timeオペランドの省略時解釈値を指定します。

●rpc_request_cancel_for_timedout=Y|N

　〜《Y》

ユーザサービス定義のrpc_request_cancel_for_timedoutオペランドの省略時解釈値を指定します。

●status_change_when_terming=Y|N

　〜《Y》

ユーザサービス定義のstatus_change_when_termingオペランドの省略時解釈値を指定します。

●service_expiration_time=サービス関数開始から終了までの実行監視時間

　〜〈符号なし整数〉((0〜65535))《0》（単位：秒）

ユーザサービス定義のservice_expiration_timeオペランドの省略時解釈値を指定します。

●multi_schedule=Y|N

　〜《N》

ユーザサービス定義のmulti_scheduleオペランドの省略時解釈値を指定します。

●make_queue_on_starting=Y|N

　〜《N》

ユーザサービス定義のmake_queue_on_startingオペランドの省略時解釈値を指定します。

●loadcheck_interval=負荷監視インタバル時間

　〜〈符号なし整数〉((0〜65535))

ユーザサービス定義のloadcheck_intervalオペランドの省略時解釈値を指定します。

●levelup_queue_count=U1,U2

　〜〈符号なし整数〉((0〜32767))

ユーザサービス定義のlevelup_queue_countオペランドの省略時解釈値を指定します。

●leveldown_queue_count=D0,D1

　〜〈符号なし整数〉((0〜32767))

ユーザサービス定義のleveldown_queue_countオペランドの省略時解釈値を指定します。

U1

サーバの負荷レベルがLEVEL1に上がったと判断するサービス要求滞留数

U2

サーバの負荷レベルがLEVEL2に上がったと判断するサービス要求滞留数

D0

サーバの負荷レベルがLEVEL0に下がったと判断するサービス要求滞留数

D1

サーバの負荷レベルがLEVEL1に下がったと判断するサービス要求滞留数

●ipc_sockctl_highwater=ソケットの一時クローズ処理開始数パーセンテージ〔,ソケットの一時クローズ処理非対象数パーセンテージ〕

　〜〈符号なし整数〉((0〜100))《100，0》

ユーザサービス定義のipc_sockctl_highwaterオペランドの省略時解釈値を指定します。

ここで指定を省略し，ユーザサービス定義でも省略した場合，システム共通定義の値を仮定します。

●ipc_sockctl_watchtime=ソケット再利用可能監視時間

　〜〈符号なし整数〉((0〜65535))《180》（単位：秒）

ユーザサービス定義のipc_sockctl_watchtimeオペランドの省略時解釈値を指定します。

ここで指定を省略し，ユーザサービス定義でも省略した場合，システム共通定義の値を仮定します。

●ipc_conn_interval=コネクション確立監視時間

　〜〈符号なし整数〉((8〜65535))《8》（単位：秒）

ユーザサービス定義のipc_conn_intervalオペランドの省略時解釈値を指定します。

ここで指定を省略し，ユーザサービス定義でも省略した場合，システム共通定義の値を仮定します。

●ipc_send_interval=データ送信監視間隔

　〜〈符号なし整数〉((5〜32767))《5》（単位：秒）

ユーザサービス定義のipc_send_intervalオペランドの省略時解釈値を指定します。

ここで指定を省略し，ユーザサービス定義でも省略した場合，システム共通定義の値を仮定します。

●ipc_send_count=データ送信監視回数

　〜〈符号なし整数〉((1〜32767))《5》

ユーザサービス定義のipc_send_countオペランドの省略時解釈値を指定します。

ここで指定を省略し，ユーザサービス定義でも省略した場合，システム共通定義の値を仮定します。

●ipc_header_recv_time=通信制御データの受信監視時間

　〜〈符号なし整数〉((5〜32767))《10》（単位：秒）

ユーザサービス定義のipc_header_recv_timeオペランドの省略時解釈値を指定します。

ここで指定を省略し，ユーザサービス定義でも省略した場合，システム共通定義の値を仮定します。

●rpc_close_after_send=Y|N

ユーザサービス定義のrpc_close_after_sendオペランドの省略時解釈値を指定します。

ここで指定を省略し，ユーザサービス定義でも省略した場合，システム共通定義の値を仮定します。

●rpc_send_retry_count=TCP/IPコネクションの接続時にエラーが発生した場合のリトライ回数

　〜〈符号なし整数〉((0〜65535))《0》

ユーザサービス定義のrpc_send_retry_countオペランドの省略時解釈値を指定します。

ここで指定を省略し，ユーザサービス定義でも省略した場合，システム共通定義の値を仮定します。

●rpc_send_retry_interval=TCP/IPコネクションの接続時にエラーが発生した場合のリトライ間隔

　〜〈符号なし整数〉((0〜300000))《0》（単位：ミリ秒）

ユーザサービス定義のrpc_send_retry_intervalオペランドの省略時解釈値を指定します。

ここで指定を省略し，ユーザサービス定義でも省略した場合，システム共通定義の値を仮定します。

●ipc_listen_sockbufset=Y|N

　〜《N》

ユーザサービス定義のipc_listen_sockbufsetオペランドの省略時解釈値を指定します。

ここで指定を省略し，ユーザサービス定義でも省略した場合，システム共通定義の値を仮定します。

●ipc_recvbuf_size=TCP/IPの受信バッファサイズ

　〜〈符号なし整数〉((0，8192〜1048576))《8192》（単位：バイト）

ユーザサービス定義のipc_recvbuf_sizeオペランドの省略時解釈値を指定します。

●ipc_sendbuf_size=TCP/IPの送信バッファサイズ

　〜〈符号なし整数〉((0，8192〜1048576))《8192》（単位：バイト）

ユーザサービス定義のipc_sendbuf_sizeオペランドの省略時解釈値を指定します。

●polling_control_data=Y|N

　〜《N》

ユーザサービス定義のpolling_control_dataオペランドの省略時解釈値を指定します。

●thread_yield_interval=ソケットの再利用指示を受信できる契機を与えるインタバル時間

　〜〈符号なし整数〉((1〜86400))《90》（単位：秒）

ユーザサービス定義のthread_yield_intervalオペランドの省略時解釈値を指定します。

●groups=グループ識別子〔,グループ識別子〕

　〜〈符号なし整数〉((0〜4294967294))

ユーザサービス定義のgroupsオペランドの省略時解釈値を指定します。

最大値はOSに依存するので，使用しているOSのマニュアルを参照してください。

●loadlevel_message=Y|N|A

　〜《N》

ユーザサービス定義のloadlevel_messageオペランドの省略時解釈値を指定します。

●ipc_backlog_count=コネクション確立要求を格納するキューの長さ

　〜〈符号なし整数〉((0〜4096))《0》

ユーザサービス定義のipc_backlog_countオペランドの省略時解釈値を指定します。

●rpc_buffer_pool_max=プーリングするバッファ数

　〜〈符号なし整数〉((1〜64))《64》

ユーザサービス定義のrpc_buffer_pool_maxオペランドの省略時解釈値を指定します。

●schedule_delay_limit=スケジュール遅延限界経過時間

　〜〈符号なし整数〉((0〜32767))《0》（単位：秒）

ユーザサービス定義のschedule_delay_limitオペランドの省略時解釈値を指定します。

●schedule_delay_abort=Y|N

　〜《N》

ユーザサービス定義のschedule_delay_abortオペランドの省略時解釈値を指定します。

●rap_autoconnect_con_error_msg=Y|N

　〜《Y》

ユーザサービス定義のrap_autoconnect_con_error_msgオペランドの省略時解釈値を指定します。

●core_shm_suppress=Y|N

　〜《N》

ユーザサービス定義のcore_shm_suppressオペランドの省略時解釈値を指定します。

●xat_connect_resp_time=通信イベント処理用SPPのアソシエーション確立の最大応答待ち時間

　〜〈符号なし整数〉((0〜65535))《180》（単位：秒）

ユーザサービス定義のset形式のxat_connect_resp_timeオペランドの省略時解釈値を指定します。このオペランドとputenv形式のXAT_CONNECT_RESP_TIMEオペランドの両方を指定した場合は，このオペランドの指定が優先され，putenv形式のXAT_CONNECT_RESP_TIMEオペランドの指定は無視されます。

●scd_poolfull_check_interval=KFCA00853-Eメッセージ出力インタバル時間

　〜〈符号なし整数〉((0〜32767))《0》（単位：秒）

ユーザサービス定義のscd_poolfull_check_intervalオペランドの省略時解釈値を指定します。

●scd_poolfull_check_count=KFCA00853-Eメッセージ出力判断値

　〜〈符号なし整数〉((1〜32767))《10》（単位：回）

ユーザサービス定義のscd_poolfull_check_countオペランドの省略時解釈値を指定します。

●scd_pool_warning_use_rate=警告メッセージの出力判断値になるメッセージ格納バッファプール使用率の上限値

　〜〈符号なし整数〉((0〜99))《0》（単位：%）

ユーザサービス定義のscd_pool_warning_use_rateオペランドの省略時解釈値を指定します。

●scd_pool_warning_interval=メッセージ格納バッファプール使用率超過時の警告メッセージ出力インタバル時間

　〜〈符号なし整数〉((0〜32767))《0》（単位：秒）

ユーザサービス定義のscd_pool_warning_intervalオペランドの省略時解釈値を指定します。

●ipc_tcpnodelay=Y|N

　〜《Y》

ユーザサービス定義のipc_tcpnodelayオペランドの省略時解釈値を指定します。

●stay_watch_queue_count=スケジュールキューの滞留監視判定を開始する際の判断になるサービス要求滞留数

　〜〈符号なし整数〉((0〜32767))《0》

ユーザサービス定義のstay_watch_queue_countオペランドの省略時解釈値を指定します。ここで0を指定または指定を省略し，ユーザサービス定義でも指定を省略した場合，スケジュールキューの滞留監視をしません。

●stay_watch_check_rate=スケジュールキューの滞留監視判定処理で使用するサービス要求の処理率

　〜〈符号なし整数〉((1〜100))（単位：%）

ユーザサービス定義のstay_watch_check_rateオペランドの省略時解釈値を指定します。このオペランドにデフォルト値はありません。ユーザサービス定義を省略する場合は，このオペランドを必ず指定してください。指定を省略した場合，定義不正のためサーバ起動処理が中止されます。

●stay_watch_abort=Y|N

　〜《N》

ユーザサービス定義のstay_watch_abortオペランドの省略時解釈値を指定します。

●stay_watch_start_interval=スケジュールキューの滞留監視インタバル時間

　〜〈符号なし整数〉((1〜32767))《10》（単位：秒）

ユーザサービス定義のstay_watch_start_intervalオペランドの省略時解釈値を指定します。

●stay_watch_check_interval=スケジュールキューの滞留監視判定インタバル時間

　〜〈符号なし整数〉((1〜65534))《10》（単位：秒）

ユーザサービス定義のstay_watch_check_intervalオペランドの省略時解釈値を指定します。

●trn_completion_limit_time=トランザクション完了限界時間

　〜〈符号なし整数〉((0〜65535))（単位：秒）

ユーザサービス定義のtrn_completion_limit_timeオペランドの省略時解釈値を指定します。

ここで指定を省略し，ユーザサービス定義でも省略した場合，トランザクションサービス定義の値を仮定します。

●rap_message_id_change_level=メッセージIDの変更レベル

　〜〈符号なし整数〉((0〜2))《0》

ユーザサービス定義またはrapリスナーサービス定義のrap_message_id_change_levelオペランドの省略時解釈値を指定します。このオペランドの指定値と出力されるメッセージの対応についてはrapリスナーサービス定義のrap_message_id_change_levelオペランドを参照してください。

●log_audit_out_suppress=Y|N

　〜《N》

ユーザサービス定義のlog_audit_out_suppressオペランドの省略時解釈値を指定します。

●log_audit_message=監査ログを取得する項目のメッセージID〔,監査ログを取得する項目のメッセージID〕…

　〜〈符号なし整数〉((33400〜99999))

ユーザサービス定義のlog_audit_messageオペランドの省略時解釈値を指定します。

●mcf_prf_trace=Y|N

　〜《Y》

ユーザサービス定義のmcf_prf_traceオペランドの省略時解釈値を指定します。

●scd_refresh_process=Y|N

ユーザサービス定義のscd_refresh_processオペランドの省略時解釈値を指定します。

●rap_extend_function=リモートAPI機能の機能拡張レベル

　〜〈16進数字〉((00000000〜00000001)) 《00000000》

ユーザサービス定義のrap_extend_functionオペランドの省略時解釈値を指定します。

●prc_coredump_filter=コアファイルに共用メモリを含めるかの判断値

　〜〈符号なし整数〉((1，3，65，67))

ユーザサービス定義のprc_coredump_filterオペランドの省略時解釈値を指定します。

●watch_time=最大応答待ち時間

　〜〈符号なし整数〉((0〜65535))（単位：秒）

ユーザサービス定義のwatch_timeオペランドの省略時解釈値を指定します。

ここで指定を省略し，ユーザサービス定義でも省略した場合，システム共通定義の値を仮定します。

●scd_process_ctl_opt=0|1

　〜《0》

ユーザサービス定義のscd_process_ctl_optオペランドの省略時解釈値を指定します。

●rpc_rap_inquire_time_check=Y|N

　〜《Y》

ユーザサービス定義のrpc_rap_inquire_time_checkオペランドの省略時解釈値を指定します。

●stack_size_unlimited=Y|N

　〜《N》

ユーザサービス定義のstack_size_unlimitedオペランドの省略時解釈値を指定します。

コマンド形式

次のページに記述しています。

putenv形式のオペランド

●環境変数名　環境変数値

　〜〈文字列〉

ユーザサービス定義の環境変数名の省略時解釈値を指定します。

●XAT_CONNECT_RESP_TIME　通信イベント処理用SPPのアソシエーション確立の最大応答待ち時間

　〜〈符号なし整数〉((0〜65535))《180》（単位：秒）

ユーザサービス定義のputenv形式のXAT_CONNECT_RESP_TIMEオペランドの省略時解釈値を指定します。このオペランドとset形式のxat_connect_resp_timeオペランドの両方を指定した場合は，このオペランドの指定は無視され，set形式のxat_connect_resp_timeオペランドの指定が優先されます。

dcputenv形式のオペランド

●環境変数名　環境変数値

　〜〈文字列〉

ユーザサービス定義の環境変数名の省略時解釈値を指定します。

trnrmid

名称

リソースマネジャ拡張子の指定

形式

〔trnrmid  -n  リソースマネジャ名
           -i  リソースマネジャ拡張子〔,リソースマネジャ拡張子〕…
         〔-k〕〕

機能

ユーザサービス定義のtrnrmid定義コマンドの省略時解釈値を指定します。

オプション

●-n　リソースマネジャ名

　〜〈1〜31文字の識別子〉

ユーザサービス定義のリソースマネジャ名の省略時解釈値を指定します。

●-i　リソースマネジャ拡張子

　〜〈1〜2文字の識別子〉

ユーザサービス定義のリソースマネジャ拡張子の省略時解釈値を指定します。

●-k

ユーザサービス定義の省略時解釈値を指定します。

注意事項

ユーザサービス定義とユーザサービスデフォルト定義の両方で，trnrmid定義コマンドに-iオプションを指定する場合は注意してください。例えば，次のように指定した場合，ユーザサービス定義とユーザサービスデフォルト定義の両方の指定が有効となります。

ユーザサービス定義の指定：trnrmid -n RM名称 -i s1

ユーザサービスデフォルト定義の指定：trnrmid -n RM名称 -i s2

scdbufgrp

名称

スケジュールバッファグループの指定

形式

scdbufgrp  -g  スケジュールバッファグループ名
        {〔-s  メッセージ格納バッファ使用制限サイズ〕｜
         〔-p  メッセージ格納バッファ使用制限率〕}

機能

ユーザサービス定義のscdbufgrp定義コマンドの省略時解釈値を指定します。

オプション

●-g　スケジュールバッファグループ名

　〜〈1〜8文字の識別子〉

ユーザサービス定義のスケジュールバッファグループ名の省略時解釈値を指定します。

●-s　メッセージ格納バッファ使用制限サイズ

　〜〈符号なし整数〉((512〜1610612736))（単位：バイト）

ユーザサービス定義のメッセージ格納バッファ使用制限サイズの省略時解釈値を指定します。

●-p　メッセージ格納バッファ使用制限率

　〜〈符号なし整数〉((1〜100))（単位：％）

ユーザサービス定義のメッセージ格納バッファ使用制限率の省略時解釈値を指定します。

注意事項

ユーザサービスデフォルト定義にscdbufgrp定義コマンドを指定した場合，すべてのユーザサービス定義のmessage_store_buflenオペランドの指定値（メッセージ格納バッファプール長）が無視されます。

ユーザサービス定義のmessage_store_buflenオペランドとユーザサービスデフォルト定義の指定とメッセージ格納バッファプール長の関係については，ユーザサービス定義のscdbufgrp定義コマンドを参照してください。

scdmulti

名称

マルチスケジューラ機能の指定

形式

scdmulti  〔-g  マルチスケジューラグループ名〕

機能

ユーザサービス定義のscdmulti定義コマンドの省略時解釈値を指定します。

オプション

●-g　マルチスケジューラグループ名

　〜〈1〜8文字の識別子〉《scdmltgp》

ユーザサービス定義のマルチスケジューラグループ名の省略時解釈値を指定します。

scdsvcdef

名称

サービス単位にスケジュールサービスの動作を指定

形式

〔scdsvcdef 〔-c  サービス名〕
            〔-p  同時実行可能なサービス数〕
            〔-n  キューイング可能なサービス要求数〕
            〔-l  キューイング可能なメッセージ格納バッファプール長〕〕

機能

ユーザサービス定義のscdsvcdef定義コマンドの省略時解釈値を指定します。

オプション

●-c　サービス名

　〜〈1〜31文字の識別子〉

ユーザサービス定義のサービス名の省略時解釈値を指定します。

●-p　同時実行可能なサービス数

　〜〈符号なし整数〉((1〜1024))

ユーザサービス定義の同時実行可能なサービス数の省略時解釈値を指定します。

●-n　キューイング可能なサービス要求数

　〜〈符号なし整数〉((1〜65535))

ユーザサービス定義のキューイング可能なサービス要求数の省略時解釈値を指定します。

●-l　キューイング可能なメッセージ格納バッファプール長

　〜〈符号なし整数〉((512〜31457280))（単位：バイト）

ユーザサービス定義のキューイング可能なメッセージ格納バッファプール長の省略時解釈値を指定します。

ユーザサービス定義

形式

set形式

  set service_group="サービスグループ名"
  set module="実行形式プログラム名"
  set service="サービス名=エントリポイント名〔;UAP共用ライブラリ名〕"
           〔,"サービス名=エントリポイント名〔;UAP共用ライブラリ名〕"〕…
〔set nice=プロセスの優先順位の変更〕
〔set parallel_count=常駐プロセス数〔,最大プロセス数〕〕
〔set hold=Y|N〕
〔set hold_recovery=Y|N〕
〔set deadlock_priority=デッドロックの優先順位〕
〔set schedule_priority=スケジュールの優先順位〕
〔set message_buflen=最大メッセージ長〕
〔set message_store_buflen=メッセージ格納バッファプール長〕
〔set trn_expiration_time=トランザクションブランチ限界経過時間〕
〔set trn_expiration_time_suspend=Y|N|F〕
〔set watch_next_chain_time=連鎖RPC間隔監視時間〕
〔set atomic_update=Y|N〕
〔set receive_from=queue|socket|none〕
〔set uap_trace_max=UAPトレース格納最大数〕
〔set uap_trace_file_put=Y|N〕
〔set term_watch_time=連続異常終了限界経過時間〕
〔set mcf_jnl_buff_size=MCFのジャーナルバッファの大きさ〕
〔set type=other|MHP〕
〔set balance_count=1プロセスが処理するサービス要求数〕
〔set uid=ユーザ識別子〕
〔set auto_restart=Y|N〕
〔set critical=Y|N〕
〔set lck_wait_priority=排他待ちの優先順位〕
〔set mcf_psv_id=アプリケーション起動プロセス識別子〕
〔set trn_cpu_time=トランザクションブランチCPU監視時間〕
〔set service_hold=Y|N〕
〔set service_priority_control=Y|N〕
〔set message_cell_size=スケジュールメッセージ格納セル長〕
〔set max_socket_msg=ソケット受信型サーバ受信メッセージ数の最大値〕
〔set max_socket_msglen=ソケット受信型サーバ受信メッセージ長の最大値〕
〔set trf_put=Y|N〕
〔set mcf_mgrid=アプリケーション起動プロセスの属するMCFマネジャ識別子〕
〔set mcf_service_max_count=MCF通信関数発行回数上限値〕
〔set trn_statistics_item=統計情報項目〔,統計情報項目〕…〕
〔set node_down_restart=Y|N〕
〔set rpc_response_statistics=Y|N〕
〔set server_type="betran"|"xatmi"|"xatmi_cbl"〕
〔set trn_rm_open_close_scope=process|transaction〕
〔set trn_optimum_item=トランザクション最適化項目
                    〔,トランザクション最適化項目〕…〕
〔set purge_msgget=Y|N〕
〔set cancel_normal_terminate=Y|N〕
〔set prc_abort_signal=アボート用シグナル番号〕
〔set rpc_service_retry_count=サービスのリトライ回数の最大値〕
〔set rpc_extend_function=RPCサービスの機能拡張レベル〕
〔set max_socket_descriptors=ソケット用ファイル記述子の最大数〕
〔set max_open_fds=UAPプロセスでアクセスするファイルおよびパイプの最大数〕
〔set service_term_watch_time=連続サービス異常終了限界経過時間〕
〔set termed_after_service=Y|N〕
〔set xat_trn_expiration_time=同期点処理の限界経過監視時間〕
〔set xat_osi_usr=Y|N〕
〔set rpc_trace=Y|N〕
〔set rpc_trace_name="RPCトレースを取得するファイル名"〕
〔set rpc_trace_size=RPCトレースを取得するファイルのサイズ〕
〔set trn_rollback_information_put=no|self|remote|all〕
〔set schedule_method=msgque|namedpipe〕
〔set service_wait_time=ユーザサーバの非常駐プロセスのサービス
                        要求待ち時間〕
〔set mcf_spp_oj=Y|N〕
〔set adm_message_option=メッセージ出力指定〕
〔set trn_watch_time=トランザクション同期点処理時の最大通信待ち時間〕
〔set trn_limit_time=トランザクションブランチ最大実行可能時間〕
〔set trn_rollback_response_receive=Y|N〕
〔set trn_partial_recovery_type=type1|type2|type3〕
〔set rpc_destination_mode=namdonly|namd|definition〕
〔set rpc_rap_auto_connect=Y|N〕
〔set rpc_rap_inquire_time=リモートAPI機能を使用して要求するサービスの
                           問い合わせ間隔最大時間〕
〔set rpc_request_cancel_for_timedout=Y|N〕
〔set status_change_when_terming=Y|N〕
〔set service_expiration_time=サービス関数開始から終了までの
                              実行監視時間〕
〔set multi_schedule=Y|N〕
〔set make_queue_on_starting=Y|N〕
〔set loadcheck_interval=負荷監視インタバル時間〕
〔set levelup_queue_count=U1,U2〕
〔set leveldown_queue_count=D0,D1〕
〔set ipc_sockctl_highwater=
                      ソケットの一時クローズ処理開始数パーセンテージ
                    〔,ソケットの一時クローズ処理非対象数パーセンテージ〕〕
〔set ipc_sockctl_watchtime=ソケット再利用可能監視時間〕
〔set ipc_conn_interval=コネクション確立監視時間〕
〔set ipc_send_interval=データ送信監視間隔〕
〔set ipc_send_count=データ送信監視回数〕
〔set ipc_header_recv_time=通信制御データの受信監視時間〕
〔set rpc_close_after_send=Y|N〕
〔set rpc_send_retry_count=TCP/IPコネクションの接続時にエラーが発生した
                           場合のリトライ回数〕
〔set rpc_send_retry_interval=TCP/IPコネクションの接続時にエラーが発生し
                              た場合のリトライ間隔〕
〔set ipc_recvbuf_size=TCP/IPの受信バッファサイズ〕
〔set ipc_sendbuf_size=TCP/IPの送信バッファサイズ〕
〔set ipc_listen_sockbufset=Y|N〕
〔set polling_control_data=Y|N〕
〔set thread_yield_interval=ソケットの再利用指示を受信できる契機を
                            与えるインタバル時間〕
〔set groups=グループ識別子〔,グループ識別子〕…〕
〔set loadlevel_message=Y|N|A〕
〔set ipc_backlog_count=コネクション確立要求を格納するキューの長さ〕
〔set rpc_buffer_pool_max=プーリングするバッファ数〕
〔set schedule_delay_limit=スケジュール遅延限界経過時間〕
〔set schedule_delay_abort=Y|N〕
〔set rap_autoconnect_con_error_msg=Y|N〕
〔set core_shm_suppress=Y|N〕
〔set xat_connect_resp_time=通信イベント処理用SPPのアソシエーション確立の
                            最大応答待ち時間〕
〔set scd_poolfull_check_interval=KFCA00853-Eメッセージ出力インタバル
                                  時間〕
〔set scd_poolfull_check_count=KFCA00853-Eメッセージ出力判断値〕
〔set scd_pool_warning_use_rate=警告メッセージの出力判断値になるメッセージ
                                格納バッファプール使用率の上限値〕
〔set scd_pool_warning_interval=メッセージ格納バッファプール使用率超過時の
                                警告メッセージ出力インタバル時間〕
〔set ipc_tcpnodelay=Y|N〕
〔set stay_watch_queue_count=スケジュールキューの滞留監視判定を開始する際
                             の判断になるサービス要求滞留数〕
〔set stay_watch_check_rate=スケジュールキューの滞留監視判定処理で使用する
                            サービス要求の処理率〕
〔set stay_watch_abort=Y|N〕
〔set stay_watch_start_interval=スケジュールキューの滞留監視インタバル
                                時間〕
〔set stay_watch_check_interval=スケジュールキューの滞留監視判定インタバル
                                時間〕
〔set trn_completion_limit_time=トランザクション完了限界時間〕
〔set rap_message_id_change_level=メッセージIDの変更レベル〕
〔set log_audit_out_suppress=Y|N〕
〔set log_audit_message=監査ログ取得メッセージID
                      〔,監査ログ取得メッセージID〕…〕
〔set mcf_prf_trace=Y|N〕
〔set scd_refresh_process=Y|N〕
〔set rap_extend_function=リモートAPI機能機能拡張レベル〕
〔set prc_coredump_filter=coreファイルに共有メモリを含めるかの判断値〕
〔set watch_time=最大応答待ち時間〕
〔set scd_process_ctl_opt=0|1〕
〔set rpc_rap_inquire_time_check=Y|N〕
〔set stack_size_unlimited=Y|N〕

コマンド形式

〔trnrmid  -n  リソースマネジャ名
           -i  リソースマネジャ拡張子〔,リソースマネジャ拡張子〕…
         〔-k〕〕
〔scdbufgrp  -g  スケジュールバッファグループ名
           {〔-s  メッセージ格納バッファ使用制限サイズ〕｜
            〔-p  メッセージ格納バッファ使用制限率〕}〕
〔scdmulti  〔-g  マルチスケジューラグループ名〕〕
〔scdsvcdef 〔-c  サービス名〕
            〔-p  同時実行可能なサービス数〕
            〔-n  キューイング可能なサービス要求数〕
            〔-l  キューイング可能なメッセージ格納バッファプール長〕〕

putenv形式

{{〔putenv  環境変数名  環境変数値〕}}
〔putenv  DCFPL_CONNECT_RETRY_COUNT  コネクション確立処理をリトライする
                                     回数〕
〔putenv  DCFPL_CONNECT_RETRY_INTERVAL  コネクション確立処理のリトライ
                                        間隔〕
〔putenv  XAT_CONNECT_RESP_TIME  通信イベント処理用SPPのアソシエーション
                                 確立の最大応答待ち時間〕

dcputenv形式

{{〔dcputenv  環境変数名  環境変数値〕}}

機能

ユーザサーバの実行環境をユーザサーバごとに定義します。

RPCでサービスを要求する場合は，「サービスグループ名＋サービス名」を指定します。サービスグループ名はUAP（SPP，MHP）の実行形式プログラムに対応します。また，サービス名は実行形式プログラムを構成する個々の関数（サービス関数）に対応します。

OpenTP1は，指定されたサービスグループ名ごとに対応するスケジュールキューへサービス要求を登録します。

ユーザサービス定義の項目を省略した場合は，ユーザサービスデフォルト定義の値を省略時解釈値とします。

ユーザサービス定義のファイル名がユーザサーバ名になります。

このユーザサーバ名をユーザサービス構成定義で指定します。

説明

set形式のオペランド

●service_group="サービスグループ名"

　〜〈1〜31文字の識別子〉

サービスグループ名を指定します。

サービスグループ名は，ネットワークで接続されるすべてのOpenTP1システムの中で一意になるように指定してください。

SUPの場合は，指定する必要はありません。

●module="実行形式プログラム名"

　〜〈1〜14文字の識別子〉

このサービスグループを実行する実行形式プログラム名を指定します。

この実行形式プログラムはプロセスサービス定義で指定したディレクトリにあります。

OSがHP-UXの場合に，リンケージの際のバインドモードが"immediate"でない実行形式ファイルを指定すると，OpenTP1の動作は保証しません。アプリケーションのバインドモードが"immediate"かどうかは，OSのchatrコマンドを使用して確認してください。

●service="サービス名=エントリポイント名〔;UAP共用ライブラリ名〕"〔，"サービス名=エントリポイント名〔;UAP共用ライブラリ名〕"〕…

サービス名，およびエントリポイント名　〜〈1〜31文字の識別子〉

このサービスグループに属するサービス名とそのサービスを提供するエントリポイント名の組をすべてのサービスについて指定します。なお，サービス名とエントリポイント名の間にある「=」の前後に，空白，タブコードなどを指定しないでください。

エントリポイント名とは，Cの関数名であり，COBOLのプログラム名，または入り口名のことです。スタブを使うサービスの場合は，エントリポイント名にRPCインタフェース定義に指定する名称と同じ指定をします。

サービス名とエントリポイント名は，1対1で対応させてください。複数のサービス名に一つのエントリポイント名を対応させることはできません。なお，「サービス名=エントリポイント名」の指定回数に上限はありません。

UAP共用ライブラリ名　〜〈1〜255文字のパス名〉

サービス関数動的ローディング機能を使うサービスの場合，UAP共用ライブラリのパス名を指定します。UAP共用ライブラリ名に，空白，タブコードなどを指定しないでください。

なお，定義チェックでは，UAP共用ライブラリ名に空白やタブコードなどを指定していないかどうかだけが対象とされます。空白やタブコードを指定していないときは，無条件にUAP共用ライブラリのローディングが実行されます。

サービス関数動的ローディング機能を使う場合は，RPCインタフェース定義にはエントリポイント名の指定は不要です。UAP共用ライブラリを省略した場合，スタブを使うサービスとします。

AIX版OpenTP1で，サービス関数動的ローディング機能を使う場合，SPPのリンケージライブラリにはlibbetran2.aを，MHPのリンケージライブラリにはlibbetran2.aおよびlibmcf2.aを使用してください。これらのライブラリが使用されなかった場合は，動作を保証しません。ただし，AIX版のuCosminexus TP1/Server Base(64)の場合には，libbetran.aとlibbetran2.aが使用できます。

スタブだけを使うサービスの場合

次の指定例のとおりに指定した場合，サービスはRPCインタフェース定義に指定したエントリポイント名の順で検索されます。

指定例：

set service = "serviceA=serviceA"

サービス関数動的ローディング機能だけを使うサービスの場合

このオペランドにサービス関数動的ローディング機能を使うサービスを指定した場合，サービスはこのオペランドに指定したサービスの順で検索されます。

UAPライブラリに環境変数を使用する場合

指定例：

set service = "serviceA=serviceA; $USRDIR/lib/usrlib.so"

putenv USRDIR /OLTP1/usrdir

UAP共用ライブラリ名のパス名に環境変数を指定する場合，パス名の先頭だけ指定できます。また，ここで指定する環境変数は，ユーザサービスデフォルト定義またはユーザサービス定義に指定できます。

このオペランドに限り，使用する環境変数がこのオペランドの指定値より下位に設定されていても有効となります。なお，環境変数を指定した場合は，環境変数展開後のパス名で最大255文字指定できます。

UAPライブラリに名称を絶対パスで指定する場合

指定例：

set service = "serviceA=serviceA;/OLTP1/usrdir/lib/usrlib.so"

UAP共用ライブラリ名に，UAP共用ライブラリ名称の絶対パスを指定した場合，OpenTP1は指定したUAP共用ライブラリを検索して使用します。

UAPライブラリにライブラリ名称だけを指定する場合

指定例：

set service = "serviceA=serviceA;usrlib.so"

UAPライブラリにライブラリ名称だけを指定した場合，OpenTP1は指定したUAP共用ライブラリをOSのライブラリサーチパス（環境変数）を基に検索して使用します。

OSのライブラリサーチパス（環境変数）は，prcdlpathコマンドで変更できます。prcdlpathコマンドについては，マニュアル「OpenTP1 運用と操作」を参照してください。

UAP共用ライブラリ名称だけを指定する場合は，次の指定例のように，ユーザサービス定義またはユーザサービスデフォルト定義のどちらかで，UAP共用ライブラリが格納されているディレクトリパスをOSのライブラリサーチパス（環境変数）に指定してください。

指定例：

この例では，UAP共用ライブラリが格納されているディレクトリパスを/usr/local/libとします。

putenv形式の場合：putenv OSのライブラリサーチパス（環境変数） OpenTP1ホームディレクトリ/lib:/usr/local/lib

dcputenv形式の場合：dcputenv OSのライブラリサーチパス（環境変数） $DCDIR/lib:/usr/local/lib

スタブおよびサービス関数動的ローディング機能を使用するサービスを併用する場合

このオペランドに，スタブおよびサービス関数動的ローディング機能を使用するサービスを指定した場合，サービスはこのオペランドに指定したサービスの順で検索されます。

指定例：

set service = "serviceA=serviceA","serviceB=serviceB;/OLTP1/usrdir/lib/usrlib.so"

RPCのサービス関数，およびRPCインタフェース定義の詳細については，マニュアル「OpenTP1 プログラム作成の手引」を参照してください。

SUPの場合は，指定する必要はありません。

●nice=プロセスの優先順位の変更

　〜〈符号なし整数〉((0〜39))

このサービスグループプロセスのnice値に加える値を指定します。プロセスのnice値は正の整数で，この値が大きくなるとCPUの優先順位は低くなります。niceの詳細については，ユーザの使用するOSの，該当するマニュアルを参照してください。

●parallel_count=常駐プロセス数〔，最大プロセス数〕

　〜〈符号なし整数〉((0〜1024))

このサービスグループ内のサービスを並行処理するプロセス数を指定します。

常駐プロセス数を指定すると，同じサービスグループ内のサービスを処理するサーバプロセスを同時に複数起動するマルチサーバ機能が使用できます。マルチサーバ機能を使用することで，サービス要求に対する処理性能が向上します。なお，常駐プロセス数が0でも最大プロセス数が指定されていれば，マルチサーバ機能は使用できます。

最大プロセス数を指定すると，常駐プロセス数を超える処理は非常駐プロセス数を動的に増減して処理されます。指定した最大プロセス数以内でサーバプロセスの起動を制御するため，OpenTP1システムの性能が低下するのを防げます。

プロセス数の指定条件を次に示します。

常駐プロセス数と最大プロセス数の両方に0を指定することはできません。

最大プロセス数を指定する場合は，常駐プロセス数以上の値を指定します。

最大プロセス数を省略した場合は，すべてのプロセスが常駐プロセスとなります。

すべてのプロセスを非常駐プロセス（必要に応じて起動）とする場合は，常駐プロセス数に0を指定し，最大プロセス数に非常駐プロセス数を指定します。

なお，常駐プロセス数に0を指定し，最大プロセス数を省略した場合は，定義エラーになります。

このサービスグループ内のサービスでトランザクション処理をする場合，サービスを処理するプロセスは，トランザクションが終了するまで次のサービスを処理できません。したがって，最大プロセス数に1を指定した場合，一つのトランザクション内では，このサービスグループ内の複数のサービスを呼び出すことはできません。

非常駐プロセスを指定しているユーザサーバやscdrsprcコマンドを使用すると，一時的に最大でユーザサービス定義のparallel_countオペランドの指定値の倍のプロセス数（常駐プロセス数と最大プロセス数を指定している場合は最大プロセス数の倍，常駐プロセス数だけを指定している場合は常駐プロセス数の倍）が起動されることがあります。

非常駐プロセスを指定しているユーザサーバ，およびscdrsprcコマンドで，倍のプロセス数が起動されるタイミングを次に示します。

非常駐プロセスを指定しているユーザサーバの場合

終了しようとしているプロセスが，dc_rpc_mainloop関数またはdc_mcf_mainloop関数の終了後からdc_rpc_close関数終了までの区間にある場合で，新たなサービス要求を受け付けたタイミング

scdrsprcコマンドで再起動するユーザサーバの場合

終了しようとしているプロセスが，dc_rpc_mainloop関数またはdc_mcf_mainloop関数の終了後からdc_rpc_close関数終了までの区間にある場合で，新たなプロセス起動を行ったタイミング

新たなプロセスが起動する契機については，マニュアル「OpenTP1 運用と操作」のscdrsprcコマンドの説明を参照してください。

SPPのソケット受信型サーバ，およびSUPの場合は，指定する必要はありません。

●hold=Y|N

このサービスグループ下のサービスを実行中にサーバプロセスが異常終了した場合，このサービスグループ，またはサービスを閉塞するかどうかを指定します。

Y

サービスグループ，またはサービスを閉塞します。

N

サービスグループ，またはサービスを閉塞しません。

サービスグループを閉塞するか，サービスを閉塞するかは，service_holdオペランドの指定に従います。

サービスグループの閉塞とは，対象となるサービスグループのスケジュール要求を受けてもサーバプロセスを起動しないことです。ただし，サービスの閉塞の場合は，同じサービスグループ内のほかのサービスが閉塞していなければ，サーバプロセスを起動します。このとき，サービス要求はサービス要求元にエラーリターンします。

SPPのソケット受信型サーバ，およびSUPの場合は，指定する必要はありません。MHPの場合，サービス開始前に異常終了したときに，このオペランドの指定に従った動作になります。サービス開始後の動作はアプリケーション属性定義（mcfaalcap定義コマンド）の指定に従います。

●hold_recovery=Y|N

全面回復時にサービスグループ，およびサービスの閉塞状態を引き継ぐかどうかを指定します。

Y

サービスグループ，およびサービスの閉塞状態を引き継ぎます。

N

サービスグループ，およびサービスの閉塞状態を引き継ぎません。

SPPのソケット受信型サーバ，SUP，およびMHPの場合は，指定する必要はありません。

システム環境定義のstart_scheduling_timingオペランドにBEFOREを指定した場合，このオペランドの指定に関係なく，閉塞状態は引き継がれません。閉塞状態を引き継ぐ場合には，スケジュールサービス定義のscd_hold_recoveryオペランドにFを指定してください。各オペランド指定による閉塞状態の引き継ぎについては，スケジュールサービス定義のscd_hold_recoveryオペランドを参照してください。

●deadlock_priority=デッドロックの優先順位

　〜〈符号なし整数〉((1〜127))

UAPのデッドロックの優先順位を指定します。

指定する値が小さいほど優先順位は高くなります。デッドロックが発生すると，優先順位のいちばん低いUAPの排他要求をエラーリターンします。

●schedule_priority=スケジュールの優先順位

　〜〈符号なし整数〉((1〜16))

サービスグループのスケジュールの優先順位を指定します。

指定する値が小さいほど優先順位は高くなります。

プロセスサービス定義で指定した最大同時サーバプロセス数の上限までサーバプロセスが起動された状態で，新たなサービス要求が発生したときに優先順位を比較します。

優先順位が最も低いサービスグループのサーバプロセスを順次停止して，これより高い優先順位を持つサービスグループのサーバプロセスを起動します。

SPPのソケット受信型サーバ，およびSUPの場合は，指定する必要はありません。

●message_buflen=最大メッセージ長

　〜〈符号なし整数〉((1024〜31457280))（単位：バイト）

共用メモリにあるクライアントからのメッセージをユーザサーバが受信するためのユーザデータ格納領域の大きさを指定します。プロセス固有の領域です。

OpenTP1システムは各メッセージに512バイトの制御情報を付加するため，その値を加算した大きさを指定してください。

ソケット受信型サーバを除くSPPの場合は，dc_rpc_call関数のin_len設定値＋512バイトを指定してください。

MHPの場合は，1,024バイトを指定してください。

ソケット受信型サーバ，およびSUPの場合は，指定する必要はありません。

●message_store_buflen=メッセージ格納バッファプール長

　〜〈符号なし整数〉((1024〜31457280))（単位：バイト）

クライアントからのメッセージをいったん格納しておく共用メモリのプールの大きさを指定します。

クライアントからのメッセージをユーザサーバに渡す前にためておく領域です。

クライアントから送信されるメッセージの中で最大値以上を指定します。

また，OpenTP1システムは各メッセージに512バイトの制御情報を付加するため，その値を加算した大きさを指定してください。

プールに格納されたメッセージは，FIFO方式でスケジュールされてユーザサーバに渡されます。ユーザサーバのメッセージの取り出しが遅れると，このプールにメッセージがたまり，以後クライアントからのサービス要求は受け付けられません。このため余裕のある値を指定してください。

次の機能を使用する場合は，message_cell_sizeオペランドで指定した値の整数倍になる値を指定してください。

プライオリティスケジューリング機能（service_priority_controlオペランドにYを指定する）

サービス単位の閉塞機能（service_holdオペランドにYを指定する）

サービス単位のスケジュール制御機能（scdsvcdef定義コマンドを指定する）

整数倍になっていない場合，ここで指定した値をmessage_cell_sizeオペランドの整数倍に切り上げて，スケジュールメッセージ格納バッファプールサイズとして使用します。

次の計算式で求めた値を指定してください。算出値が1024より小さい場合は，1024を指定してください。

ソケット受信型サーバを除くSPPの場合

メッセージ格納バッファプール長=(M+C)×S

M：該当するユーザサーバで受信する最大メッセージ長

ユーザデータの圧縮（rpc_datacompオペランド）を使用している場合でも，圧縮前のメッセージ（ユーザデータ）長を使用してください。

C：制御情報の付加分（512バイト）

S：滞留の数

MHPの場合

MHPプロセスがすべて常駐，またはbalance_countオペランドで0を指定しているとき

メッセージ格納バッファプール長=C×P

それ以外のとき

メッセージ格納バッファプール長=C×P×B

C：制御情報の付加分（512バイト）

P：parallel_countオペランドで指定する最大プロセス数

B：balance_countオペランドの指定値

SPPのソケット受信型サーバ，およびSUPの場合は，指定する必要はありません。

なお，ユーザサービス定義またはユーザサービスデフォルト定義に，scdbufgrp定義コマンドを指定した場合，message_store_buflenオペランドの指定値は無視されます。

●trn_expiration_time=トランザクションブランチ限界経過時間

　〜〈符号なし整数〉((0〜65535))（単位：秒）

トランザクションブランチの処理を監視する限界経過時間を指定します。指定時間を超えた場合は，このトランザクションブランチのプロセスを異常終了させて，ロールバックします。0を指定した場合は，時間監視をしません。

UAPが異常終了した場合に閉塞するかどうかはholdオペランド，term_watch_timeオペランドの指定によります。詳細については，ユーザサービス定義のholdオペランドおよびterm_watch_timeオペランドの説明を参照してください。

ここで指定を省略し，ユーザサービスデフォルト定義でも省略した場合，トランザクションサービス定義の値を仮定します。

これらの定義のほかに関数を発行して監視時間を指定することもできます。関数の詳細については，マニュアル「OpenTP1 プログラム作成の手引」を参照してください。

なお，RPC機能を使用した場合に，他プロセスで実行するトランザクションブランチの処理時間も監視時間に含むかどうかは，trn_expiration_time_suspendオペランドで指定してください。

また，メッセージ制御機能（TP1/Message Control）を使用した同期型のメッセージ処理を行う場合，メッセージ送受信時間を監視時間に含むかどうかは，trn_expiration_time_suspendオペランドで指定してください。

注

トランザクションブランチ限界経過時間の精度は秒単位です。そのため，タイミングによっては，このオペランドに指定した値よりも最大約1秒長い時間でプロセスを強制停止することがあります。

●trn_expiration_time_suspend=Y|N|F

トランザクションブランチの処理を監視するとき，次の処理時間も監視時間に含むかどうかを指定します。

監視対象のトランザクションブランチが，RPC機能を使ってほかのトランザクションブランチを呼び出し，その処理が終わるのを待つ時間

連鎖RPCで呼び出されたサーバUAPが，次のサービス要求を待つ時間

監視対象のトランザクションブランチが，非同期RPCを使用してほかのトランザクションブランチを呼び出したあと，処理結果受信処理を行っている時間

監視対象のトランザクションブランチが，メッセージ制御機能（TP1/Message Control）を使用した同期型のメッセージ処理を行う場合のメッセージ送受信時間

Y

1.，2.，3.，4.のすべてを監視時間に含みます。

N

3.だけを監視時間に含みます。

F

1.，2.，3.，4.のどれも監視時間に含みません。

ここで指定を省略し，ユーザサービスデフォルト定義でも省略した場合，トランザクションサービス定義の値を仮定します。

このオペランドと各種タイマ監視との関係については，「付録A.2　トランザクションの時間監視」を参照してください。

●watch_next_chain_time=連鎖RPC間隔監視時間

　〜〈符号なし整数〉((0〜65535))（単位：秒）

サーバUAPが連鎖RPCで呼び出された場合，前回のサービス要求に応答を返してから次のサービス要求を受けるまで，またはトランザクションが終了するまでの最大時間間隔を秒単位で指定します。指定した時間を超えると，UAPは異常終了します。

UAPが異常終了した場合に閉塞するかどうかはholdオペランド，term_watch_timeオペランドの指定によります。詳細については，ユーザサービス定義のholdオペランドおよびterm_watch_timeオペランドの説明を参照してください。

この指定値は，サーバとなるUAPだけに有効です。0を指定すると，連鎖RPCでの次の要求が来るまで，またはトランザクションが終了するまで待ちます。

このオペランドと各種タイマ監視との関係については，「付録A.2　トランザクションの時間監視」を参照してください。

●atomic_update=Y|N

このサービスグループのプロセスでトランザクションを発生させるかどうかを指定します。

Y

このプロセスはトランザクションの範囲に入れます。

トランザクションの範囲に入る方法には次の二つがあります。

このプロセスでdc_trn_begin関数を新たに発行した場合

ほかのUAPからのサービス要求を受けて，OpenTP1システムが自動的に行う場合

N

このプロセスはトランザクションの範囲に入れません。

dc_trn_begin関数やdc_trn_unchained_commit関数などのトランザクションサービス関数は使用できません。また，ジャーナル出力もできません。

なお，システム共通定義のjnl_fileless_optionオペランドにYを指定している場合，atomic_updateオペランドにYを指定してもNとして動作します。

●receive_from=queue|socket|none

ソケット受信型サーバは廃止したため，socketは使用できません。

サービス関数が受け取るメッセージを何を使って受信するかを指定します。

queue

スケジュールサービスのスケジュールキューを使用します。

SPPおよびMHPの場合に指定します。

スケジュールキューを使用することで，dc_rpc_call関数を発行したときには起動されていないサーバプロセスを新たに起動して呼んだり，同じサーバプロセスを複数起動してロードバランスを測ったりする機能が使用できます。

socket

UNIXドメイン，またはインターネットドメインを使用します。

SPPの場合に指定します。

このサーバはオンデマンド起動，およびノード間負荷バランス機能を使用できません。

none

スケジュールサービスのスケジュールキュー，UNIXドメイン，およびインターネットドメインのどれも使用しません。

SUPの場合に指定します。

●uap_trace_max=UAPトレース格納最大数

　〜〈符号なし整数〉((0〜4095))

UAPトレースの最大格納数を指定します。

0を指定した場合

UAPトレースを取得しません。

1以上を指定した場合

指定値+1のUAPトレースを取得します。

UAPトレースデータファイルまたは退避コアファイルに，UAPトレースの情報として次の情報を取得します。

サービス関数の開始

サービス関数の終了

OpenTP1のライブラリ関数の入り口または出口※

注※

OpenTP1のライブラリ関数がリターンするときは，入り口情報を取得した領域を出口情報で上書きするため，UAPトレースの格納数は1となります。ただし，TP1/Message Queue，およびオンラインテスタ（TP1/Online Tester）を使用している場合は，OpenTP1のライブラリ関数の入り口情報と出口情報で別の領域となるため，UAPトレースの格納数は2となります。

UAPトレースを参照することで，次に示す処理の流れを解析できます。

UAPが正常終了までに行った処理の流れ

UAPの異常終了時，障害が発生するまでにUAPが行った処理の流れ

この解析によって，ユーザはUAPに障害が起こった原因を解析でき，UAPを修正したり，システムを再構築したりする目安にできます。

UAPトレースの詳細については，マニュアル「OpenTP1　テスタ・UAPトレース使用の手引」を参照してください。

●uap_trace_file_put=Y|N

UAPトレースのトレース情報を，ファイルに取得するかどうかを指定します。

Y

トレース情報をUAPトレースデータファイルに取得します。この場合，ユーザサーバを終了させないで，UAPトレースの編集出力ができるようになります。UAPトレースデータファイルについては，マニュアル「OpenTP1 運用と操作」を参照してください。

トレース情報をファイルに取得できなかった場合，プロセス固有領域にトレース情報を取得します。

N

トレース情報をプロセス固有領域に取得します。この場合，ユーザサーバをアボートしたときにだけ，UAPトレースの編集出力ができます。

Yを指定した場合，ユーザサーバダウン時，またはOpenTP1終了後の再開始時に，UAPトレースデータファイルのバックアップファイルを各サーバ最大で6世代取得します。バックアップファイルの内訳は，該当するサーバの正常終了時に3世代，コアファイルの出力を伴う異常終了時に3世代です。バックアップファイルの格納先は，プロセスサービス定義のprc_coresave_pathオペランドに指定した，コアファイルの格納先です。

Windowsの場合，UAPトレースの編集出力はuatdumpコマンドで行います。uatdumpコマンドについては，マニュアル「OpenTP1 テスタ・UAPトレース使用の手引」を参照してください。

このオペランドは，ユーザサービス定義，ユーザサービスデフォルト定義でも指定できます。指定値の優先順位は次のとおりです（1.＞2.＞3.）。

ユーザサービス定義

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

システム共通定義

ここで指定を省略し，ユーザサービスデフォルト定義でも省略した場合，システム共通定義の値を仮定します。

●term_watch_time=連続異常終了限界経過時間

　〜〈符号なし整数〉((0〜32767))（単位：分）

このユーザサーバのサーバプロセスが異常終了した回数を監視する限界経過時間を指定します。0を指定した場合は，時間監視をしません。

ソケット受信型サーバを除くSPPは，holdオペランドにNを指定した場合に有効です。

SPPのソケット受信型サーバ，およびSUPはauto_restartオペランドにYを指定した場合に有効です。

MHPは，holdオペランドにNを指定し，サービス開始前にユーザサーバのサーバプロセスが異常終了した場合に有効です。

OpenTP1では，時間監視によってUAPプロセスを停止させることがあります。時間監視によってUAPプロセスが停止したとき，サーバの閉塞する条件を次の表に示します。

表3‒18　holdオペランド，term_watch_timeオペランドの指定値と，サーバの閉塞の関係

ユーザサーバの種類

holdオペランドの指定値

term_watch_timeオペランドの指定値

サーバが閉塞するかどうか

SPP

MHP（サービス開始前）

Y

すべて

（holdオペランドにYを指定した場合は，term_watch_timeオペランドの指定に関係なく，無条件で閉塞します）

要因に関係なく無条件で閉塞します。

N

0

閉塞しません。

0以外

term_watch_timeオペランドに指定した時間内に，3回異常終了すると閉塞します（要因によっては異常終了回数に数えない場合があります）。

MHP（サービス開始後）

すべて

すべて

holdオペランドおよびterm_watch_timeオペランドの指定に関係なく，アプリケーション属性定義（mcfaalcap定義コマンド）の指定で閉塞するかどうかが決まります。

holdオペランドにNを指定し，term_watch_timeオペランドに0を指定しているときに，UAPの問題による異常終了があると，UAPプロセスの再起動とUAPプロセスの異常終了を繰り返します。例えば，非常駐プロセスだけのユーザサーバ（parallel_countオペランドの常駐プロセス数に0を指定）でholdオペランドにNを指定し，term_watch_timeオペランドに0を指定した場合，実行形式プログラム名に指定誤りがあると，サービス実行時にKFCA00713-Eメッセージを繰り返し出力します。これを防ぐため，term_watch_timeオペランドには0以外の値を指定することをお勧めします。

オペランドの異常終了回数のカウント条件を，次の表に示します。

表3‒19　オペランドの異常終了回数のカウント条件

異常終了要因

異常終了回数のカウント

UAPの問題による異常終了

カウントする

ipc_sockctl_watchtime満了による異常終了

カウントする

trn_cpu_time満了による異常終了

カウントする

watch_next_chain_time満了による異常終了

カウントする

xat_trn_expiration_time満了による異常終了

カウントする

service_expiration_time満了による異常終了

カウントしない

trn_expiration_time満了による異常終了

カウントしない

trn_completion_limit_time満了による異常終了

カウントしない

mcfaalcap -v ntmetim満了による異常終了

カウントしない

prckill，dcsvstop -fdコマンドによる異常終了

カウントしない

なお，term_watch_timeオペランドの指定時間内に3回連続してこのユーザサーバのサーバプロセスが異常終了した場合，ソケット受信型サーバを除くSPPは，holdオペランドの指定に関係なく，このサービスグループを閉塞し，SPPのソケット受信型サーバおよびSUPはauto_restartオペランドの指定に関係なく強制停止します。

MHPの場合は，サービス開始前，term_watch_timeオペランドの指定時間内に3回以上連続してユーザサーバのサーバプロセスが異常終了すると，このサービスグループのスケジュールを閉塞し，ユーザサーバを強制停止します。

ユーザサーバが，holdオペランドにNを，term_watch_timeオペランドに0以外を指定した場合に異常終了したときの例を，次に示します。

trn_cpu_timeオペランドの指定値を超えて異常終了した。

異常終了1回目です。閉塞しません。

trn_expiration_timeオペランドの指定値を超えて異常終了した。

異常終了回数にはカウントしません。閉塞しません。

UAPの問題によって異常終了した。

異常終了2回目です。閉塞しません。

trn_cpu_timeオペランドの指定値を超えて異常終了した。

異常終了3回目です。閉塞します。

term_watch_timeオペランドで指定した連続異常終了限界経過時間が解除される契機を，次に示します。

term_watch_timeオペランドの指定値の時間が経過したとき。

ユーザサーバの閉塞を解除したとき。

ユーザサーバを正常停止したあと，正常開始したとき。

OpenTP1を正常開始，再開始したとき。

●mcf_jnl_buff_size=MCFのジャーナルバッファの大きさ

　〜〈符号なし整数〉((4096〜131072))（単位：バイト）

MCFの実行によって取得されるジャーナルデータを蓄えておく領域の大きさを指定します。

指定する値の計算については，「MCFマネジャ定義」のmcfmuap定義コマンドの-jオプションの説明を参照してください。

指定する値が大きいほどジャーナルを取得するときのディスクに対する入出力回数が少なくなります。

ここで指定を省略し，ユーザサービスデフォルト定義でも省略した場合，MCFマネジャ定義のmcfmuap定義コマンドの-jオプションの値を仮定します。

MHPおよびTP1/Message Controlの機能を使用するSPPだけ有効です。

SUPの場合は，指定する必要はありません。

●type=other|MHP

このサービスグループの種別を指定します。

other：キュー受信型SPPに指定します。

MHP：MHPに指定します。

SUPの場合は，指定する必要はありません。

●balance_count=1プロセスが処理するサービス要求数

　〜〈符号なし整数〉((0〜512))

このユーザサーバに対応するスケジュールキューに，処理されないで残っているサービス要求を，1プロセスで幾つ処理させるかを指定します。サービス要求が，（このオペランドの指定値）×（起動プロセス数）を超えてスケジュールキューに残っている場合には，非常駐プロセスを起動してサービス要求を処理させます。このオペランドは，parallel_countオペランドで非常駐プロセスを起動するように指定したサービスグループにだけ有効です。

次の場合には，必ずこのオペランドに0を指定してください。

非常駐プロセスだけで構成される（常駐プロセス数に0を，最大プロセス数に2以上を指定する）サーバで，リカーシブコールを使用する場合

一つの常駐プロセスと，ほかの非常駐プロセスで構成される（常駐プロセス数に1を，最大プロセス数に2以上を指定する）サーバで，リカーシブコールを使用する場合

0を指定すると，サービス要求のあった時点で起動されているすべてのプロセスがサービスを処理中の場合，非常駐プロセスが起動されます。

SPPのソケット受信型サーバおよびSUPの場合は，このオペランドを指定する必要はありません。

●uid=ユーザ識別子

　〜〈符号なし整数〉((0〜4294967294))

このサービスグループのプロセスの所有者となるユーザIDを指定します。

OSに登録されているユーザIDを指定してください。

最大値はOSに依存するので，使用しているOSのマニュアルを参照してください。

●auto_restart=Y|N

UAPが異常終了した場合の処置を指定します。

Y

UAPが異常終了した場合，プロセスを再起動します。

N

UAPが異常終了した場合，プロセスを再起動しません。

ソケット受信型サーバを除くSPPおよびMHPの場合は，指定する必要はありません。

●critical=Y|N

このサービスグループを実行中にUAPが異常終了した場合のOpenTP1システムの処置を指定します。

Y

UAPが異常終了した場合，OpenTP1システムを停止します。

N

UAPが異常終了した場合，OpenTP1システムを続行します。

●lck_wait_priority=排他待ちの優先順位

　〜〈符号なし整数〉((0〜127))

ユーザサーバがwait型の排他要求を発行して，排他待ちの状態となる場合の優先順位を指定します。

指定する値が小さいほど優先順位は高くなり，優先順位の低い排他要求より先に排他待ちが解除されます。0を指定した場合は，待ち行列の最後に登録されます。

優先順位を低く設定すると，あとから発行された優先順位の高い排他要求に追い越されることがあるので注意してください。

●mcf_psv_id=アプリケーション起動プロセス識別子

　〜〈16進数字〉((01〜ff))

アプリケーション起動を実行する場合の，アプリケーション起動プロセス識別子を指定します。アプリケーション起動を実行するSPPには必ず指定してください。SUP，MHP，およびアプリケーション起動を実行しないSPPには，指定する必要はありません。

●trn_cpu_time=トランザクションブランチCPU監視時間

　〜〈符号なし整数〉((0〜65535))（単位：秒）

トランザクションブランチが同期点処理までに使用できるCPU時間を指定します。0を指定した場合は，監視しません。指定時間を超えた場合は，該当するトランザクションブランチのプロセスを異常終了し，ロールバックします。ここで指定を省略し，ユーザサービスデフォルト定義でも省略した場合，トランザクションサービス定義の値を仮定します。

UAPが異常終了した場合に閉塞するかどうかはholdオペランド，term_watch_timeオペランドの指定によります。詳細については，ユーザサービス定義のholdオペランドおよびterm_watch_timeオペランドの説明を参照してください。

●service_hold=Y|N

このサービスグループ下のサービスについて，サービス単位の閉塞管理をするかどうかを指定します。

Y

サービス単位に閉塞管理します。

N

サービス単位の閉塞管理はしません。

このオペランドにYを指定した場合，message_cell_sizeオペランドの指定が有効になります。

サービス単位の閉塞管理をすることによって，サービス単位にサーバ異常終了時の閉塞や，運用コマンドでの閉塞ができます。ただし，サーバ異常終了時のサービス単位の閉塞は，holdオペランドにYを指定，またはservice_term_watch_timeオペランドを指定したときだけできます。

対象となるサービスのスケジュール要求を受けた場合，サービス要求をサービス要求元にエラーリターンします。

SPPのソケット受信型サーバ，SUP，およびMHPの場合は，指定する必要はありません。

●service_priority_control=Y|N

サービス要求単位に指定された優先順位に従ってスケジューリングするかどうかを指定します。

Y

サービス要求単位に指定された優先順位に従ってスケジューリングします。

N

サービス要求単位に指定された優先順位に従ってスケジューリングしません。

このオペランドにYを指定した場合，message_cell_sizeオペランドの指定が有効になります。SPPのソケット受信型サーバ，SUP，およびMHPの場合は，指定する必要はありません。

●message_cell_size=スケジュールメッセージ格納セル長

　〜〈符号なし整数〉((512〜31457280))（単位：バイト）

次の場合は，message_store_buflenオペランドで指定したスケジュールメッセージ格納バッファプールをセル分割してメッセージを格納します。そのときのセルサイズをここで指定します。

service_priority_controlオペランドにYを指定した場合

service_holdオペランドにYを指定した場合

scdsvcdef定義コマンドを指定した場合

スケジュールメッセージ格納バッファプールをセル分割した各セルには，セル管理テーブル（16バイト）を作成するため，そのサイズを考慮する必要があります。

また，このオペランドの指定値には，8の整数倍となる値を指定してください。指定した値が8の整数倍でない場合は，その値を8の整数倍に切り上げた値が指定されます。

message_store_buflenオペランドで指定した値が，この指定値の整数倍になっていない場合，message_store_buflenオペランドの値をこの指定値の整数倍に切り上げて，スケジュールメッセージ格納バッファプールサイズとして使用します。

service_priority_controlオペランド，およびservice_holdオペランドにNを指定し，かつscdsvcdef定義コマンドを省略した場合は，ここで指定する必要はありません。

また，SPPのソケット受信型サーバ，SUP，MHPの場合にも，指定をする必要はありません。

●max_socket_msg=ソケット受信型サーバ受信メッセージ数の最大値

　〜〈符号なし整数〉((1〜500))

ソケット受信型サーバが受信するメッセージの最大数を指定します。

ソケット受信型サーバは，サービス受け付け状態ではないとき（トランザクションのコミット，ロールバック指示待ち，連鎖RPC中，またはRPCネストコールの応答待ちなど），新たなサービス要求を即時処理しないで，サービス受け付け状態に戻るまで保存します。

サーバが受信するメッセージ数がこのオペランドの指定を超えた場合，dc_rpc_call関数は，DCRPCER_SERVER_BUSYでエラーリターンします。

ソケット受信型サーバを除くSPP，SUP，およびMHPの場合は，指定する必要はありません。

●max_socket_msglen=ソケット受信型サーバ受信メッセージ長の最大値

　〜〈符号なし整数〉((1〜30270))（単位：キロバイト）

ソケット受信型サーバが受信するメッセージ長の合計の最大値を指定します。

サーバが受信するメッセージ長の合計がこのオペランドの指定値を超えた場合，dc_rpc_call関数は，DCRPCER_SERVER_BUSYでエラーリターンします。

指定値は，サーバへ送信するメッセージの最大値以上にする必要があります。

また，指定値には，メッセージに付ける制御情報の大きさ（約0.3キロバイト）を加える必要があります。

ソケット受信型サーバを除くSPP，SUP，およびMHPの場合は，指定する必要はありません。

●trf_put=Y|N

該当するサーバで起動されたトランザクションが出力したジャーナルをトランザクションリカバリジャーナルに出力するかどうかを指定します。

Y

トランザクションリカバリジャーナルファイルに出力します。

N

トランザクションリカバリジャーナルファイルに出力しません。

トランザクションリカバリジャーナルファイルを作成すると，長時間トランザクションによって発生するジャーナル障害を防止でき，またリラン時間を短縮できます。ただし，この機能は，性能，およびメモリへのオーバヘッドがあるので，長時間トランザクションを使用するサーバの場合に指定してください。

系切り替え機能を使用するOpenTP1システムでは，この機能を使用できないため，ユーザサービス定義およびrapリスナーサービス定義のtrf_putオペランドにはNを指定してください。

●mcf_mgrid=アプリケーション起動プロセスの属するMCFマネジャ識別子

　〜〈識別子〉((A〜Z，a〜z))

アプリケーション起動を実行する場合，アプリケーション起動プロセスが属しているMCFマネジャのMCFマネジャプロセス識別子を指定します。

SUP，MHP，およびアプリケーションを起動しないSPPの場合は，指定する必要はありません。

●mcf_service_max_count=MCF通信関数発行回数上限値

　〜〈符号なし整数〉((0〜65535))

UAPの暴走を防止するために，MHPまたはSPPが発行するMCF通信関数※の発行回数上限値を指定します。

対象となる関数は，サービス関数の開始から終了までの間に該当プロセスで発行するMCF通信関数です。

指定回数を超えてMCF通信関数を発行した場合，該当プロセスを異常終了させます。

0を指定した場合は，MCF通信関数の発行回数に制限はありません。

指定値が有効となる優先順位は次のとおりです（1.＞2.）。

ユーザサービス定義

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

ユーザサービス定義およびユーザサービスデフォルト定義を省略した場合，MHPに限りMCFマネジャ定義のmcfmuap定義コマンドの-dオプションの値を仮定し，SPPでは0を仮定します。

注※

対象となる関数は次のとおりです。これらの関数に対応したDMLインタフェースについては，マニュアル「OpenTP1 プログラム作成リファレンス COBOL言語編」を参照してください。

dc_mcf_commit関数　【CBLDCMCF('COMMIT ')】

dc_mcf_contend関数　【CBLDCMCF('CONTEND ')】

dc_mcf_execap関数　【CBLDCMCF('EXECAP ')】

dc_mcf_receive関数　【CBLDCMCF('RECEIVE ')】

dc_mcf_recvsync関数　【CBLDCMCF('RECVSYNC')】

dc_mcf_reply関数　【CBLDCMCF('REPLY ')】

dc_mcf_resend関数　【CBLDCMCF('RESEND ')】

dc_mcf_rollback関数　【CBLDCMCF('ROLLBACK')】

dc_mcf_send関数　【CBLDCMCF('SEND ')】

dc_mcf_sendrecv関数　【CBLDCMCF('SENDRECV')】

dc_mcf_sendsync関数　【CBLDCMCF('SENDSYNC')】

dc_mcf_tempget関数　【CBLDCMCF('TEMPGET ')】

dc_mcf_tempput関数　【CBLDCMCF('TEMPPUT ')】

●trn_statistics_item=統計情報項目〔，統計情報項目〕…

トランザクションブランチの統計情報を取得する項目を指定します。

nothing

トランザクションブランチの統計情報を取得しません。

base

基本情報として，次のトランザクションブランチの情報を取得します。

トランザクションブランチの識別子

トランザクションブランチの決着結果

トランザクションブランチの実行プロセス種別

トランザクションブランチの実行サーバ名

トランザクションブランチの実行サービス名

executiontime

基本情報とトランザクションブランチの実行時間情報を取得します。

cputime

基本情報とトランザクションブランチのCPU時間情報を取得します。

nothingの指定は，一つしかできません。また，nothingとほかの統計情報項目を同時に指定した場合，nothingの指定は無効になります。

トランザクションに関する統計情報を取得するときは次のどれかを指定してください。

トランザクションサービス定義のtrn_tran_statisticsオペランドにYを指定

trnsticsコマンドで-sオプションを指定

ここで指定を省略し，ユーザサービスデフォルト定義でも省略した場合，トランザクション定義の値を仮定します。

統計情報を取得する場合，取得情報の種類が多くなるほど，トランザクション性能が悪くなります。このため，統計情報は，システムチューニング時やトラブル調査時など，トランザクションの性能が悪くなってもかまわない場合に取得してください。

●node_down_restart=Y|N

OpenTP1再開始時，該当するユーザサーバを自動起動するかどうかを指定します。

該当するユーザサーバがdcstopコマンド実行前に正常終了した場合，この指定は無効となります。なお，次に示す場合は，status_change_when_termingオペランドの指定によって，正常終了したユーザサーバを起動するかどうかを決定します。

システム正常終了中に，ユーザサーバが正常終了したあとにシステムダウンが発生した場合

システム計画終了中に，dcstopコマンドで終了処理をする前にSUPが正常終了した場合

Y

OpenTP1再開始時，自動起動します。

N

OpenTP1再開始時，自動起動しません。

OpenTP1の異常終了後に再開始（リラン）でOpenTP1を起動させた場合，node_down_restartオペランドにNを指定しているユーザサーバは，リラン時の起動対象にならないで異常終了のままとなります。異常終了したままのユーザサーバがある場合にOpenTP1を正常停止させようとすると，OpenTP1が停止します。OpenTP1が停止した場合は，次に示すどちらかの対処をしてください。

該当ユーザサーバを一度正常開始または正常停止させたあとに，dcstopコマンドを実行してOpenTP1を正常停止させる。

-nオプションを指定したdcstopコマンドを実行してOpenTP1を強制正常停止させる。

●rpc_response_statistics=Y|N

レスポンス統計情報を取得するかどうかを指定します。

Y

レスポンス統計情報を取得します。

N

レスポンス統計情報を取得しません。

レスポンス統計は，RPCコールのレスポンスタイム，サービスの実行時間，およびサーバのCPU時間などを取得します。

このオペランドは，dc_rpc_call関数のクライアント・サーバで個別に指定できます。レスポンス統計情報は，同期応答型RPC（連鎖RPCを含む）および非同期応答型RPCで取得します。

●server_type="betran"|"xatmi"|"xatmi_cbl"

サービス関数の呼び出し時，OpenTP1のパラダイムに従うか，XATMIのパラダイムに従うかを指定します。

"betran"

OpenTP1のパラダイムに従います。

サービス関数は，XATMIの関数を使用できません。

"xatmi"

XATMIのパラダイムに従います。

"xatmi_cbl"

XATMIのCOBOL言語のサービスパラダイムに従います。

SUP，およびMHPの場合は，指定する必要はありません。

●trn_rm_open_close_scope=process|transaction

OpenTP1以外が提供しているリソースマネジャに対して，XAインタフェースである二つの関数（xa_open関数とxa_close関数）の発行タイミングを指定します。

process

dc_rpc_open関数発行時にxa_open関数を発行し，dc_rpc_close関数発行時にxa_close関数を発行します。

transaction

トランザクション開始時にxa_open関数を発行し，トランザクション終了時にxa_close関数を発行します。

processを指定した場合は，dc_rpc_open関数の発行からdc_rpc_close関数の発行までリソースマネジャの資源を占有します。したがって，トランザクションの性能を重視する場合はprocessを指定してください。

transactionを指定した場合は，トランザクションの開始終了ごとにxa_open関数，xa_close関数を発行します。したがって，リソースマネジャの資源を有効利用したい場合は，transactionを指定してください。

ここで指定を省略し，ユーザサービスデフォルト定義でも省略した場合，トランザクションサービス定義の値を仮定します。

●trn_optimum_item=トランザクション最適化項目〔，トランザクション最適化項目〕…

複数のユーザサーバで構成されるグローバルトランザクションの性能を向上させるための最適化項目を，次の文字列で指定します。

base

同期点処理全体（プリペア処理，コミット処理，およびロールバック処理）を最適化します。OpenTP1のトランザクション制御は2相コミット方式で行っているため，二つのトランザクションブランチ間のコミット制御には，4回のプロセス間通信が必要となります。

次の条件をすべて満たす場合，親トランザクションブランチが子トランザクションブランチのコミット処理を代わりに行うことで，コミット制御で必要な4回のプロセス間通信を削減します。

親トランザクションブランチと，子トランザクションブランチが同一OpenTP1下にあること。

親トランザクションブランチが，子トランザクションブランチを同期応答型RPCで呼び出していること。

子トランザクションブランチでアクセスしたリソースマネジャのXAインタフェース用オブジェクトが，親トランザクションブランチにもリンケージされていること。

asyncprepare

baseの指定条件を満たしていないため同期点処理全体の最適化ができない場合に，プリペア処理を最適化します。

次の条件をすべて満たす場合，親トランザクションブランチから発行されたRPCによって子トランザクションブランチがサービス要求を実行したときに，RPCのリターン前にプリペア処理を実行することで，2回のプロセス間通信を削減します。

baseを指定した最適化ができないこと。

親トランザクションブランチが，子トランザクションブランチを同期応答型RPCで呼び出していること。

ただし，この最適化を実行した場合，親トランザクションブランチが発行した同期応答型RPCの応答時間が遅くなります。また，子トランザクションブランチは，プリペア処理からコミット処理までの間隔（親トランザクションブランチからの指示がないとトランザクションを決着できない状態）が大きくなります。そのため，親トランザクションブランチのOpenTP1がシステムダウンし，トランザクションブランチ間の連絡ができなくなると，ジャーナルファイルのスワップやチェックポイントダンプファイルの有効化が遅れ，子トランザクションブランチのOpenTP1もシステムダウンする場合があります。

トランザクション最適化項目は，重複して指定できます。ただし，優先順位は次のようになります（1.＞2.）。

base

asyncprepare

ここで指定を省略し，ユーザサービスデフォルト定義でも省略した場合，トランザクションサービス定義の値を仮定します。

●purge_msgget=Y|N

非常駐サーバについて，サーバプロセスがない場合に，OpenTP1がこのサービスグループに割り当てたOSのメッセージキュー（msggetシステムコールでの割り当て）を解放するかどうかを指定します。

Y

サーバプロセス消滅時，OSのメッセージキューを解放します。

N

サーバプロセス消滅時，OSのメッセージキューを解放しません。

このオペランドでYを指定すると，OSのメッセージキューをむだに占有しなくなります。解放は，サーバプロセス消滅後，約10秒間サービス要求が発生しない場合に行います。OSのメッセージキュー解放後にサービス要求が発生した場合，OSのメッセージキューを再度割り当ててサービス要求を処理します。

このオペランドでYを指定する場合は，ほかのサービスグループでもYを指定してください。これは，OSのメッセージキューが，一つのサービスグループに対して一つあるためです。そのため，ユーザサービスデフォルト定義のpurge_msggetオペランドにも，Yを指定してください。

このオペランドは，ユーザサービス定義のreceive_fromオペランドでqueueを指定し，かつparallel_countオペランドの常駐プロセス数に0を指定したサービスグループに対して有効です。それ以外のサービスグループは無視されます。

なお，OSのメッセージキューの再割り当てには数10ミリ秒掛かるため，このレベルで性能を重視するシステムでは注意してください。

●cancel_normal_terminate=Y|N

このユーザサーバで，dcsvstopコマンドでの正常終了を抑止するかどうかを指定します。

Y

このユーザサーバでdcsvstopコマンドでの正常終了を抑止します。

N

このユーザサーバでdcsvstopコマンドでの正常終了を抑止しません。

Yを指定した場合，このユーザサーバはdcsvstopコマンドでの強制停止，およびdcstopコマンドでの停止しか受け付けません。

●prc_abort_signal=アボート用シグナル番号

　〜〈符号なし整数〉((1〜128))

OpenTP1下のサーバをアボートさせる際に使用する，シグナル番号を指定します。アボート用シグナル番号には，必ずコアファイル出力の動作をするシグナル番号を指定してください。コアファイル出力の動作をするシグナル番号を指定しないと，dcstopコマンドおよびdcsvstopコマンドでの強制終了時に，-dオプションを指定していてもコアファイルが生成されません。

prc_abort_signalオペランドで指定したシグナル番号は，次の表に示すとおりにサーバに送信されます。

表3‒20　シグナル番号が送信されるタイミングとサーバ

シグナル番号が送信されるタイミング

シグナル番号が送信されるサーバ

次に示す時間の満了時

トランザクションブランチ限界経過時間（trn_expiration_timeオペランドで指定）

サービス関数開始から終了までの実行監視時間（service_expiration_timeオペランドで指定）

トランザクション完了限界時間（trn_completion_limit_timeオペランドで指定）

非トランザクションMHP限界経過時間（mcfaalcapコマンドの-vオプションのntmetimオペランドで指定）

時間監視が満了したサーバ

次に示す方法でサーバを強制停止した時

prckillコマンドを実行

-dfオプションを指定したdcsvstopコマンドを実行

-fdオプションを指定したdcstopコマンドを実行

強制停止させるサーバ

●rpc_service_retry_count=サービスのリトライ回数の最大値

　〜〈符号なし整数〉((0〜65535))

サービスリトライ機能で，サービス関数をリトライする最大回数を指定します。

0を指定すると，サービスリトライ機能を使用しません。そのため，dc_rpc_service_retry関数はエラーリターンし，サービス関数はリトライされません。

0以外を指定すると，指定された回数だけ連続してサービス関数がリトライされます。指定された回数を超えて呼び出されたdc_rpc_service_retry関数はエラーリターンし，サービス関数はリトライされません。

なお，サービスリトライ機能を使用できるのは，SPPだけになります。

●rpc_extend_function=RPCサービスの機能拡張レベル

　〜〈16進数字〉((00000000〜0000000F))

RPCサービスの機能の拡張レベルを，次の中から指定します。

次の指定値で示す機能の拡張レベルを複数指定する場合，それぞれの指定値の論理和を指定してください。

00000000

RPCサービスの機能を拡張しません。

00000001

サービス要求実行中のSPPが異常終了した場合に，dc_rpc_call関数，dc_rpc_call_to関数およびdc_rpc_poll_any_replies関数で，リターン値「DCRPCER_SERVICE_TERMINATED（00378）」を返します。

00000002

トランザクション内で開始した非トランザクション（flagsにDCRPC_TPNOTRANを指定したdc_rpc_call関数，およびdc_rpc_call_to関数）の連鎖RPCを，同期点処理で終了しないで，flagsにDCNOFLAGSを指定したdc_rpc_call関数，およびdc_rpc_call_to関数で明示的に終了するまで継続します。

00000004

非同期応答型RPCの応答メッセージを受け取っていない状態で，トランザクションの同期点処理をした場合に，非トランザクション属性の非同期応答型RPCの応答メッセージは破棄しないで，トランザクション属性の非同期応答型RPCの応答メッセージだけを削除します。

00000008

SPPプロセスで，dc_rpc_call関数，およびdc_rpc_call_to関数の呼び出し元の応答受信タイムアウトを検出したため，処理を中断してサービス要求を破棄した場合に，KFCA00339-Wのメッセージを出力します。

●max_socket_descriptors=ソケット用ファイル記述子の最大数

　〜〈符号なし整数〉((32〜2032))

OpenTP1制御下のプロセス※1で，ソケット用に使用するファイル記述子の最大値を指定します。

指定値の範囲は，適用OSがAIX，HP-UXまたはWindowsの場合は32〜2032，適用OSがSolarisまたはLinuxの場合は32〜1008です。

OpenTP1制御下のプロセス※1では，システムサーバやユーザサーバとの間で，ソケットを使用したTCP/IP通信でプロセス間の情報交換をしています。そのため，同時に稼働するUAPプロセスの数および通信する他ノードの数によって，ソケット用のファイル記述子の最大数を変更する必要があります。

このオペランドには，次の条件を満たす値を指定してください。

（「このオペランドの指定値」＋同定義内の「max_open_fdsオペランドの指定値」）≦2048※2

条件を満たさない値を指定した場合は，このオペランドの指定値は次に示すように強制的に補正されます。

（「このオペランドの指定値」＋同定義内の「max_open_fdsオペランドの指定値」）=2048※2

注※1

MCFサービス（MCFマネジャサービス，MCF通信サービス，およびアプリケーション起動サービス）以外のOpenTP1プロセスが対象です。MCFサービスの場合は，「システムサービス情報定義」および「システムサービス共通情報定義」を参照してください。

注※2

適用OSがAIX，HP-UXまたはWindowsの場合は2048，適用OSがSolarisまたはLinuxの場合は1024です。

ソケット用ファイル記述子の最大数の計算式を，次に示します。

↑（A＋B＋C＋D＋E×5＋F）／0.8↑

↑↑：小数点以下を切り上げます。

A：このユーザサーバが通信する自ノード内のUAPプロセス数

B：このユーザサーバが通信する他ノード内のUAPプロセス数

C：自ノード内のシステムサービスプロセス数

自ノード内のプロセス数は，rpcstatコマンドで表示されるサーバ名をカウントすることで求められます。rpcstatコマンドで表示されるサーバ名のうち，マニュアル「OpenTP1 解説」のOpenTP1のプロセス構造に記載されているシステムサービスプロセスの実行形式ファイル名と一致する行数をカウントしてください。

D：ユーザサービスネットワーク定義のdcsvgdef定義コマンドに指定したrapサーバの数

E：システム共通定義のall_nodeオペランドとall_node_exオペランドに指定したノード数の総和，またはドメイン定義ファイルに指定したノード数の総和

F：通信先ノードのスケジュールサービス定義のscdmulti定義コマンドで指定したマルチスケジューラデーモン数（-mオプション）の総和

n：通信先ノード数

このオペランドの指定値が小さいと，OpenTP1制御下の他プロセスとのコネクションが設定できなくなるため，プロセスがKFCA00307-Eメッセージを出力して異常終了します。

指定値の優先順位は次のとおりです（1.＞2.＞3.）。

ユーザサービス定義

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

システム共通定義

ここで指定を省略し，ユーザサービスデフォルト定義でも省略した場合，システム共通定義の値を仮定します。

●max_open_fds=UAPプロセスでアクセスするファイルおよびパイプの最大数

　〜〈符号なし整数〉((16〜2016))

ユーザサーバのプロセスでアクセスする，ファイルおよびパイプの最大数を指定します。

指定値の範囲は，適用OSがAIX，HP-UXまたはWindowsの場合は16〜2016，適用OSがSolarisまたはLinuxの場合は16〜992です。

ファイルおよびパイプのアクセスには，ファイル記述子が使われます。

ユーザサーバのプロセスで多くのファイルをアクセスすると，システムサーバやユーザサーバとの間でプロセス間の情報交換に使用するソケット用のファイル記述子が不足します。そのため，アクセスするファイルおよびパイプの数を事前に設定しておく必要があります。

ユーザサーバのプロセスでアクセスするファイルおよびパイプの最大数の計算式を，次に示します。

（DAMサービス，TAMサービス，MQAサービス，ジャーナルサービス，およびステータスサービスの各システム定義で指定した全OpenTP1ファイルシステム数※1）＋（ISAMのキー数）＋20※2＋（ユーザファイル数※3）＋（自ノード内でRPC先となるschedule_methodにnamedpipeを指定したユーザサーバ数※4）

注※1

オンラインで使用する，OpenTP1ファイルシステム領域数

注※2

リモートAPI機能を使用してサービスを要求する場合は，固定数20にさらに16を加えてください。

注※3

OpenTP1の制御下にない，ユーザが独自に使用するファイル

注※4

このユーザサーバから，自ノード内でRPC先となるユーザサーバのうちschedule_methodにnamedpipeを指定しているユーザサーバの数

このオペランドの指定値が小さいと，OpenTP1制御下の他プロセスとのコネクションが設定できなくなるため，プロセスがKFCA00307-Eメッセージを出力して異常終了します。

max_open_fdsオペランドに指定した値は，dc_rpc_open関数を発行することでUAPの動作環境に設定されます。OpenTP1は，UAPプロセス実行中にUAPプロセスでオープンするファイルディスクリプタの最大数の超過を検出すると，UAPプロセスを異常終了させます。

dc_rpc_open関数発行後にUAPプロセスでオープンするファイルディスクリプタの最大数をOSに対して再設定（変更）した場合，OpenTP1の認識する最大数と一致しなくなり，UAPプロセスがオープンするファイルディスクリプタの最大数の超過を検出できないため，OpenTP1がエラーを処理できません。このため，dc_rpc_open関数を呼び出したあとにUAPプロセスでオープンするファイルディスクリプタの最大数を変更しないでください。変更した場合の動作は保証できません。

●service_term_watch_time=連続サービス異常終了限界経過時間

　〜〈符号なし整数〉((0〜32767))（単位：分）

このユーザサーバのサーバプロセスが，同一サービス実行中に異常終了した回数を監視する限界経過時間を指定します。0を指定した場合は，このオペランドを指定しなかったと見なし，時間監視をしません。

このオペランドを指定すると，指定した時間内にサーバプロセスが同一サービス実行中（dc_rpc_mainloop関数内）で3回異常終了した場合は，そのサービスを閉塞します。また，サーバプロセスがサービス実行中以外（dc_rpc_mainloop関数外）で3回異常終了した場合は，サービスグループを閉塞します。

このオペランドは，サーバプロセスが異常終了しても，サービスグループを閉塞しないでサービス単位で閉塞管理する場合（holdオペランドにNを指定し，service_holdオペランドにYを指定した場合）に有効となります。また，SPPのソケット受信型サーバ，SUP，およびMHPでは，指定しても無視されます。

このオペランドに0以外の値を指定すると，サービス単位で異常終了した回数を監視するため，term_watch_timeオペランドは，指定しても無視されます。

service_term_watch_timeオペランドの指定と，holdオペランド，service_holdオペランド，およびterm_watch_timeオペランドの指定の関係を，次に示します。

各オペランドの指定値

サーバプロセスが異常終了した回数とOpenTP1の処理

hold

service

_hold

term

_watch

_time

service

_term

_watch

_time

1回目

2回目

3回目

Y

Y

×

×

サービス閉塞

−

−

N

×

×

サービスグループ閉塞

−

−

N

Y

0

指定なし

プロセス再起動

プロセス再起動

プロセス再起動

0以外

指定なし

プロセス再起動

プロセス再起動

サービスグループ閉塞

0

0

プロセス再起動

プロセス再起動

プロセス再起動

0以外

0

プロセス再起動

プロセス再起動

サービスグループ閉塞

×

0以外

プロセス再起動

プロセス再起動

サービス閉塞※

N

0

×

プロセス再起動

プロセス再起動

プロセス再起動

0以外

×

プロセス再起動

プロセス再起動

サービスグループ閉塞

（凡例）

×：指定できません（指定しても無視されます）。

−：何もしません。

注※

サーバプロセスがサービス実行中以外（dc_rpc_mainloop関数外）で3回異常終了した場合は，サービスグループを閉塞します。

●termed_after_service=Y|N

このユーザサーバで，サービス終了時に負荷が減少している場合に，非常駐プロセスを終了させるかどうかを指定します。

Y

サービス終了時に負荷が減少している場合に，非常駐プロセスを終了させます。

N

スケジュールサービスが，一定の間隔で不要な非常駐プロセスを終了させます。

通常OpenTP1では，一定の間隔（10秒）でプロセスの状態をチェックして，不要な非常駐プロセスを終了させています。しかし，サーバが非常に多いシステムでは一度に終了させるプロセス数が増え，プロセスの終了処理と同時に発生したサービス要求の処理性能が悪くなることがあります。

このオペランドにYを指定すると，サービス終了時にプロセスの状態をチェックします。そのため，一度に終了させるプロセス数が減り，プロセスの終了処理と同時に発生したサービス要求の処理性能が悪くなるのを防げます。また，システムで起動しているプロセス数を減らすことで，システムへの負荷を減らせます。

ただし，サービスが終了するたびにプロセスの状態をチェックするため，1回ごとのサービス要求の処理性能は悪くなります。また，システム形態によっては，非常駐プロセスの起動・終了が頻繁に発生するようになり，サービス要求の処理性能が悪くなることがあります。

SPPのソケット受信型サーバ，およびSUPの場合は，指定しても無視されます。

●xat_trn_expiration_time=同期点処理の限界経過監視時間

　〜〈符号なし整数〉((1〜2147483647))（単位：秒）

TP1/NET/OSI-TP-Extendedを使った，XATMIインタフェースでのOSI TP通信を実行する場合に，他システムとの同期点処理の限界経過監視時間を指定します。

UAPが異常終了した場合に閉塞するかどうかはholdオペランド，term_watch_timeオペランドの指定によります。詳細については，ユーザサービス定義のholdオペランドおよびterm_watch_timeオペランドの説明を参照してください。

TP1/NET/OSI-TP-Extendedの仕様については，マニュアル「OpenTP1 プロトコル TP1/NET/OSI-TP-Extended編」を参照してください。

MHPの場合は，指定しても無視されます。

●xat_osi_us=Y|N

このサーバで，TP1/NET/OSI-TP-Extendedを使った，XATMIインタフェースでのOSI TP通信用のスタブを使用するかどうかを指定します。

Y

このサーバでXATMIインタフェースでのOSI　TP通信用のスタブを使用します。

N

このサーバでXATMIインタフェースでのOSI　TP通信用のスタブを使用しません。

Nを指定すると，TP1/NET/OSI-TP-Extendedを使った，XATMIインタフェースでのOSI　TP通信ができません。

TP1/NET/OSI-TP-Extendedの仕様については，マニュアル「OpenTP1 プロトコル TP1/NET/OSI-TP-Extended編」を参照してください。

MHPの場合は，指定しても無視されます。

●rpc_trace=Y|N

RPCトレースを取得するかどうかを指定します。

Y

RPCトレースを取得します。

N

RPCトレースを取得しません。

RPCトレースを取得した場合，処理速度が低下し，RPCがタイムアウトでエラーリターンすることがあります。その場合は，状況に応じて次の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.の最大応答待ち時間を使用してください。

リモートAPI機能を使用する場合，このオペランドにYを指定しても，rapクライアントのRPCトレースは取得されません。

このオペランドは，ユーザサービスデフォルト定義，およびシステム共通定義でも指定できます。

指定値の優先順位は次のとおりです（1.＞2.＞3.）。

ユーザサービス定義

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

システム共通定義

●rpc_trace_name=RPCトレースを取得するファイル名

　〜〈パス名〉

RPCトレースを取得するファイルのパス名を指定します。

パス名のうち，RPCトレースを取得するファイル名（デフォルトはrpctr）の最大長は，13文字です。

パス名に環境変数を指定する場合，パス名の先頭に環境変数を指定してください（指定例：$DCDIR/tmp/ファイル名）。

●rpc_trace_size=RPCトレースを取得するファイルのサイズ

　〜〈符号なし整数〉((1024〜2147483648))（単位：バイト）

RPCトレースを取得するファイルのサイズを指定します。

このオペランドに4096以下を指定していても，送受信された電文長がこの指定値を上回る場合，このオペランドで指定した値よりも大きなトレースファイルが作成されることがあります。

●trn_rollback_information_put=no|self|remote|all

トランザクションブランチがロールバックした場合に，ロールバック要因に関する情報をログに取得するかどうかを指定します。

no

ロールバック情報を取得しません。

self

ロールバック要因が発生したトランザクションブランチでだけ，ログにロールバック情報を取得します。

remote

selfに加え，他ノードのトランザクションブランチからロールバック要求されたトランザクションブランチでも，ログにロールバック情報を取得します。

all

remoteに加え，自ノードのトランザクションブランチからロールバック要求されたトランザクションブランチでも，ログにロールバック情報を取得します。

ここで指定を省略し，ユーザサービスデフォルト定義でも省略した場合，トランザクションサービス定義の値を仮定します。

●schedule_method=msgque|namedpipe

ユーザサーバのスケジューリング方式を指定します。

msgque

OSのメッセージ機能を使用して，サービス要求のスケジューリングをする方式です。

namedpipe

OSの名前付きパイプを使用して，サービス要求のスケジューリングをする方式です。

ユーザサービス定義のservice_wait_timeオペランドを指定する場合に，namedpipeを指定してください。

このオペランドでnamedpipeを指定した場合の注意事項を次に示します。

msgqueを指定した場合に比べ，処理性能が劣化します。

スケジュールサービスで使用するファイルディスクリプタの数が，このオペランドを指定したユーザサーバ数だけ増加します。

このオペランドは，SPPのソケット受信型サーバおよびSUPの場合は指定する必要はありません。

●service_wait_time=ユーザサーバの非常駐プロセスのサービス要求待ち時間

　〜〈符号なし整数〉((1〜4096))（単位：秒）

ユーザサーバの非常駐プロセスのサービス要求待ち時間を指定します。

このオペランドを指定したユーザサーバの非常駐プロセスは，このオペランドで指定した時間だけサービス要求を待ち，サービス要求がない場合に終了させます。このオペランドを省略した場合，一定間隔でスケジュールサービスが，サーバの負荷状態を監視して非常駐プロセスを終了させます。

このオペランドは，ユーザサービス定義のschedule_methodオペランドでnamedpipeを指定した場合に有効です。また，このオペランドを指定すると，ユーザサービス定義のtermed_after_serviceオペランドの指定が無効になります。

このオペランドは，SPPのソケット受信型サーバおよびSUPの場合は指定する必要はありません。

●mcf_spp_oj=Y|N

SPPからの分岐メッセージ送信，アプリケーション起動，およびメッセージ再送要求時に，履歴情報（ジャーナル：OJ）を取得するかどうかを指定します。

Y

履歴情報を取得します。

N

履歴情報を取得しません。

●adm_message_option=メッセージ出力指定

　〜〈1けたの16進数〉

次のメッセージを出力するかどうかをビットマスクの論理和で指定します。ビットマスクがオンのメッセージは出力され，ビットマスクがオフのメッセージは出力されません。

メッセージID

ビットマスク（16進数）

メッセージ内容

KFCA01811-I

1

サーバ開始中メッセージ

KFCA01813-I

2

サーバオンラインメッセージ

KFCA01842-I

4

サーバ終了中メッセージ

KFCA01843-I

8

サーバ停止メッセージ

（例）

KFCA01813-IとKFCA01843-Iを出力したい場合は，「set adm_message_option=A」と指定します。

●trn_watch_time=トランザクション同期点処理時の最大通信待ち時間

　〜〈符号なし整数〉((1〜65535))（単位：秒）

トランザクションの同期点処理で，トランザクションブランチ間で行う通信（プリペア，コミット，ロールバック指示，または応答など）の受信待ち時間の最大値を指定します。

指定時間を過ぎても指示または応答がない場合は，該当するトランザクションブランチが2相コミットの1相目完了前であればロールバックさせ，1相目完了後であればトランザクションサービスのシステムプロセスでトランザクション決着処理を再試行します。

ここで指定を省略し，ユーザサービスデフォルト定義でも省略した場合，トランザクションサービス定義の値を仮定します。さらに，トランザクションサービス定義でも省略した場合，トランザクションを行ったユーザサーバのwatch_timeの値を仮定します。ただし，watch_timeに0を指定した場合は120秒を仮定します。

●trn_limit_time=トランザクションブランチ最大実行可能時間

　〜〈符号なし整数〉((0〜65535))（単位：秒）

トランザクションブランチの最大実行可能時間を指定します。

トランザクションブランチを開始してから同期点処理が終了するまでの時間が，このオペランド指定時間を超えないようにdc_rpc_call関数，dc_rpc_poll_any_replies関数および同期点処理内で行う通信のタイムアウト時間を，次のように自動設定します。

dc_rpc_call関数およびdc_rpc_poll_any_replies関数のタイムアウト時間

「K≧このオペランド指定時間」の場合は，要求処理を実行しないで，タイムアウトでエラーリターンします。

「K＜このオペランド指定時間」でかつ「（このオペランド指定時間−K）≧W」の場合は，Wをタイムアウト時間とします。

「K＜このオペランド指定時間」でかつ「（このオペランド指定時間−K）＜W」の場合は，（このオペランド指定時間−K）をタイムアウト時間とします。

K

現時刻−トランザクションブランチ開始時刻

W

dc_rpc_call関数の場合はwatch_timeオペランド指定時間

dc_rpc_poll_any_replies関数の場合は引数timeout指定時間

同期点処理内で行う通信のタイムアウト時間

「K≧このオペランド指定時間」の場合は，タイムアウト時間を1秒とします。

「K＜このオペランド指定時間」でかつ「（このオペランド指定時間−K）≧W」の場合は，Wをタイムアウト時間とします。

「K＜このオペランド指定時間」でかつ「（このオペランド指定時間−K）＜W」の場合は，（このオペランド指定時間−K）をタイムアウト時間とします。

K

現時刻−トランザクションブランチ開始時刻

W

trn_watch_timeオペランド指定時間

trn_watch_timeオペランドを省略した場合はwatch_timeオペランド指定時間

上記の受信待ち以外の処理で時間が掛かった場合は，このオペランド指定時間以内にトランザクションブランチが終了しないことがあります。

同期点処理開始前にこのオペランド指定時間が経過した場合，そのトランザクションはロールバックします。

0を指定した場合は，残り時間の監視をしません。

ここで指定を省略し，ユーザサービスデフォルト定義でも省略した場合，トランザクションサービス定義の値を仮定します。

●trn_rollback_response_receive=Y|N

RPC先トランザクションブランチにロールバック指示を送信したあと，ロールバック完了通知を受信するかどうかを指定します。Nを指定した場合，RPC先トランザクションブランチからのロールバック完了通知を受信しないで（RPC先トランザクションブランチのロールバック処理の完了を待たないで）自トランザクションブランチを終了します。

ここで指定を省略し，ユーザサービスデフォルト定義でも省略した場合，トランザクションサービス定義の値を仮定します。

●trn_partial_recovery_type=type1|type2|type3

UAP障害時のトランザクション同期点処理方式を指定します。

RPCがタイムアウトし，RPC発行先プロセスのアドレスが未解決の場合やトランザクション実行中のUAPがダウンした場合に，トランザクションブランチ間の連絡がスムーズにできないで，トランザクションの決着に時間が掛かることがあります。

このオペランドでは，次に示す障害が発生した場合のトランザクション同期点処理方式を，指定値に示す三つの方式から選択して指定します。

（障害1）RPCがタイムアウトした場合

この場合，RPC発行元トランザクションブランチは，サービス要求がどのプロセスで実行されているかがわからないため，RPC発行先トランザクションブランチにトランザクション同期点メッセージを送信できません。そのため，RPC発行元トランザクションブランチおよびRPC発行先トランザクションブランチはトランザクション同期点メッセージ待ちとなり，トランザクションの決着に時間が掛かります。

（障害2）RPC発行元UAPがRPCの応答受信前にダウンした場合

この場合，RPC発行元トランザクションブランチは，サービス要求がどのプロセスで実行されているかがわからないため，RPC発行先トランザクションブランチにトランザクション同期点メッセージを送信できません。そのため，RPC発行先トランザクションブランチはトランザクション同期点メッセージ待ちとなり，トランザクションの決着に時間が掛かります。

（障害3）RPC発行先UAPからの応答受信後にRPC発行元UAPとRPC発行先UAPがほぼ同時にダウンした場合

この場合，それぞれのトランザクションブランチを引き継いだトランザクション回復プロセスは，相手UAPプロセスのダウンを知らないため，すでに存在しないUAPプロセスにトランザクション同期点メッセージを送信してしまい，トランザクションの決着に時間が掛かることがあります。

type1

（障害1）が発生した場合，RPC発行元トランザクションブランチおよびRPC発行先トランザクションブランチは，トランザクション同期点メッセージ受信処理がタイムアウトすることによって，トランザクションを決着します。

（障害2）が発生した場合，RPC発行元トランザクションブランチは，RPC発行先トランザクションブランチにトランザクション同期点メッセージを送信しないでトランザクションを決着します。RPC発行先トランザクションブランチは，トランザクション同期点メッセージ受信処理がタイムアウトすることによって，トランザクションを決着します。

（障害3）が発生した場合，RPC発行元トランザクションブランチおよびRPC発行先トランザクションブランチは，トランザクション同期点メッセージ受信処理がタイムアウトすることによって，トランザクションを決着します。

type2

（障害1）が発生してトランザクションをコミットする場合はtype1と同じです。

（障害1）が発生してトランザクションをロールバックする場合，または（障害2）が発生した場合は，RPC発行元トランザクションブランチは，RPC発行先トランザクションブランチが存在するノードのトランザクションサービスプロセスにトランザクション同期点メッセージを送信後，トランザクションを決着します。トランザクション同期点メッセージを受信したトランザクションサービスプロセスは，該当するトランザクションブランチを処理中のプロセスに，トランザクション同期点指示を送信します。

（障害3）が発生した場合，RPC発行元トランザクションブランチおよびRPC発行先トランザクションブランチは，トランザクション同期点メッセージ受信処理がタイムアウトすることによって，トランザクションを決着します。

type3

（障害1）が発生してトランザクションをコミットする場合は，type1と同じです。

（障害1）が発生してトランザクションをロールバックする場合，（障害2）が発生した場合，または（障害3）が発生した場合，相手トランザクションブランチが存在するノードのトランザクションサービスプロセスに，トランザクション同期点メッセージを送信します。トランザクション同期点メッセージを受信したトランザクションサービスプロセスは，該当するトランザクションブランチを処理中のプロセスに，トランザクション同期点指示を送信します。

次に示す場合，このオペランドにtype2またはtype3を指定しても，トランザクションの決着に時間が掛かることがあります。

RPC実行中に，RPC発行先UAPの状態が変更となり（負荷増加，UAP終了，UAP閉塞など），ほかのノードの同一UAPにサービス要求が再転送された場合

相手先のOpenTP1がこのオプションをサポートしていないバージョンの場合

相手先トランザクションブランチがトランザクション同期点メッセージ受信処理以外で時間が掛かっている場合

TP1/Server BaseまたはTP1/LiNK以外とトランザクション連携をする場合，このオペランドにはtype1を指定または省略してください。

ここで指定を省略し，ユーザサービスデフォルト定義でも省略した場合，トランザクションサービス定義の値を仮定します。

●rpc_destination_mode=namdonly|namd|definition

dc_rpc_call関数で要求したサービスの送信先を決定する際に，ネームサービスから得た情報と，ユーザサービスネットワーク定義の指定値のどちらを優先させるかを指定します。

namdonly

従来どおり，ネームサービスの情報から選択したあて先へサービスを送信し，ユーザサービスネットワーク定義の指定値の検索は一切しません。

namd

ネームサービスの情報から選択したあて先へサービスを送信します。

ネームサービスの情報内に該当するサービスが見つからない場合だけ，ユーザサービスネットワーク定義の指定値を検索します。

definition

ユーザサービスネットワーク定義の指定値から検索したあて先へサービスを送信します。ユーザサービスネットワーク定義に該当するサービスがない場合だけ，ネームサービスにあて先検索を要求します。

このオペランドは，dc_rpc_call関数を呼び出すSUP，SPP，MHPの場合に指定します。

このオペランドにnamdまたはdefinitionを指定した場合，ユーザサービスネットワーク定義の指定値を検索して，サービス要求を送信します。ユーザサービスネットワーク定義に，システム共通定義のall_nodeオペランドに指定していないノードのサービス情報を定義している場合，このノードのOpenTP1がダウンして再開始したあとに要求したサービスが，タイムアウトエラーになることがあります。

●rpc_rap_auto_connect=Y|N

リモートAPI機能の常設コネクションを使用してサービスを要求する場合に，UAPとリモートAPI制御プロセスとの間のコネクションを，OpenTP1が自動的に管理するかどうかを指定します。

Y

UAPとリモートAPI制御プロセスとの間のコネクションを，OpenTP1が自動的に管理します（オートコネクトモード）。

N

UAPとリモートAPI制御プロセスとの間のコネクションを，dc_rap_connect関数またはdc_rap_disconnect関数を使ってユーザが管理します（非オートコネクトモード）。

●rpc_rap_inquire_time=リモートAPI機能を使用して要求するサービスの問い合わせ間隔最大時間

　〜〈符号なし整数〉((0〜1048575))（単位：秒）

リモートAPI機能を使用してサービスを要求する場合に，リモートAPI制御プロセスがUAPからのサービス要求を処理してから，次のサービス要求を処理するまでの間隔の，最大待ち時間を指定します。この指定値は，リモートAPI制御プロセス側で監視するタイマです。指定時間を超えても次のサービス要求がない場合，リモートAPI制御プロセスはUAPがダウンしたものと見なして次のサービス要求を処理します。

このオペランドに0を指定した場合，リモートAPI制御プロセス側の定義で指定した値が有効になります。

このオペランドは，リモートAPI機能を使用してdc_rpc_call関数を呼び出すSUP，SPP，MHPの場合に指定します。

常駐SPPからリモートAPI機能を使用している場合，このオペランドまたはrapリスナーサービス定義のrap_inquire_timeオペランドに0を指定しないでください。指定した場合，常駐SPPが終了するまで無限に待ち続けます。これは，rapリスナーが存在するノードのOpenTP1システムを終了させようとしても，rapリスナーが終了できないためです。

ユーザサービス定義でこのオペランドの指定を省略した場合，rapリスナーサービス定義のrap_inquire_timeオペランドで指定した値が最大待ち時間となります。どちらも省略した場合は，180秒を仮定します。

このオペランドに"0"以外を指定し，オートコネクトモードでdc_rpc_call関数を呼び出した場合，rapクライアント側でも問い合わせ間隔最大時間をチェックします。

rapクライアント側で問い合わせ間隔最大時間をチェックするかどうかは，ユーザサービス定義またはユーザサービスデフォルト定義のrpc_rap_inquire_time_checkオペランドの指定値に従います。

詳細はrpc_rap_inquire_time_checkオペランドの説明を参照してください。

●rpc_request_cancel_for_timedout=Y|N

クライアントUAPで設定した，サービス要求を送信してからサービスの応答が返るまでの待ち時間を，サーバ側に引き継ぎ，サーバにクライアントが待ち状態であることを意識させるかどうかを指定します。

クライアントUAPの応答待ち時間をサーバに引き継ぐと，クライアントUAPがタイムアウトしても，サーバ側でサービスを実行したり，同期点処理の実行を待ち続けたりすることを防止できます。

Y

クライアントUAPの応答待ち時間をサーバに意識させます。

N

クライアントUAPの応答待ち時間をサーバに意識させません。

ただし，サーバ側のTP1/Server Baseのバージョンが03-02で，かつドメイン指定の同期型dc_rpc_call関数の場合は，RPCがエラーとなりますので，Nを指定してください。

●status_change_when_terming=Y|N

システム正常終了中にユーザサーバが正常終了したあとにシステムダウンが発生した時，またはシステム計画終了中にdcstopコマンドによる終了処理前にSUPが正常終了した時などのサーバの状態の変化を，次回再開始時に反映させるかどうかを指定します。

Y

最終的な状態の変化を反映させます。

正常終了したユーザサーバは，次回のOpenTP1の再開始時に再起動されません。

N

最終的な状態の変化を反映させません。

正常終了したユーザサーバは，次回のOpenTP1の再開始時に再起動されます。

●service_expiration_time=サービス関数開始から終了までの実行監視時間

　〜〈符号なし整数〉((0〜65535))（単位：秒）

SPPプロセスでの，サービス関数開始から終了までの実行監視時間を指定します。この時間を満了してもサービス関数がリターンしない場合，このプロセスを強制停止します。

0を指定した場合，時間監視はしません。

UAPが異常終了した場合に閉塞するかどうかはholdオペランド，term_watch_timeオペランドの指定によります。詳細については，ユーザサービス定義のholdオペランドおよびterm_watch_timeオペランドの説明を参照してください。

注

サービス関数開始から終了までの実行監視時間の精度は秒単位です。そのため，タイミングによっては，このオペランドに指定した値よりも最大約1秒長い時間でプロセスを強制停止することがあります。

●multi_schedule=Y|N

サービス要求をマルチスケジューラ機能を使用してスケジューリングするかどうかを指定します。

このオペランドは，マルチスケジューラ機能を使用する場合，RPC送信側ユーザサーバで指定します。

Y

サービス要求をマルチスケジューラ機能を使用してスケジューリングします。

N

サービス要求をマルチスケジューラ機能を使用してスケジューリングしません。

マルチスケジューラ機能を使用する場合に，OpenTP1システム内の同一サービスグループに，マルチスケジューラ機能を使用しているユーザサーバと，マルチスケジューラ機能を使用していないユーザサーバが混在していると，マルチスケジューラ機能を使用しているユーザサーバに優先して負荷分散されます。マルチスケジューラ機能を使用しているユーザサーバが起動されていなかったり，スケジュールできない状態（閉塞，メッセージ格納バッファ不足など）になっていたりする場合は，マルチスケジューラ機能を使用していないユーザサーバに負荷分散されます。

マルチスケジューラ機能を使用する場合，このオペランドとともに，スケジュールサービス定義およびユーザサービス定義のscdmulti定義コマンドを，RPC受信側で指定する必要があります。

なお，この機能は，TP1/Extension 1をインストールしていることが前提です。TP1/Extension 1をインストールしていない場合の動作は保証できませんので，ご了承ください。

●make_queue_on_starting=Y|N

OpenTP1が非常駐のサービスグループに割り当てるスケジュールキューを，サーバ起動時に割り当てるかどうかを指定します。

Y

サーバ起動時にスケジュールキューを割り当てます。

N

サーバ起動時にスケジュールキューを割り当てません。

このオペランドを指定すると，非常駐サーバがシステムの資源不足によってスケジューリングできない状態をサーバ起動時に検出できます。

ただし，スケジュールキューの割り当てに失敗した場合でも，サーバの起動処理は続行します。

このオペランドは，ユーザサービス定義，またはユーザサービスデフォルト定義のpurge_msggetオペランドでYを指定した場合，およびparallel_countオペランドの常駐プロセス数に0以外を指定した場合は無視されます。

●loadcheck_interval=負荷監視インタバル時間

　〜〈符号なし整数〉((0〜65535))（単位：秒）

このサービスグループの負荷レベルを監視するインタバル時間を指定します。負荷監視時に負荷レベルに変更がある場合は，各ノードのネームサービスにサーバ情報が通知されます。そのため，最悪のケースでは，負荷監視インタバルごとにサーバ情報がネットワーク上に送信されるおそれがあるので，必要以上に短い値を指定しないでください。なお，スケジュールサービス定義にscd_announce_server_status=Nを指定した場合は，このオペランドを指定しても無視されます。また，0を指定した場合は，負荷レベルの監視をしません。

このオペランドを指定しない場合，負荷監視インタバルは30秒となります。また，負荷監視の要否のチェックなどについては10秒のインタバルで実行されます。つまり，負荷監視の要否のチェックなどの3回目には，負荷監視が実行されます。

しかし，このオペランドを指定する場合，負荷監視インタバルはオペランドの指定値となり，負荷監視の要否のチェックなどについては，10と各ユーザサーバのこのオペランドの指定値との最大公約数から求めたインタバルで実行されます。例えば，SPP1のloadcheck_intervalオペランドに3を，SPP2のloadcheck_intervalオペランドに5を指定する場合，10と3と5の最大公約数の1（秒）が負荷監視の要否のチェックなどを実行するインタバルとなります。負荷監視の要否のチェックなどの3回目には，SPP1の負荷監視が実行されます。5回目には，SPP2の負荷監視が実行されます。

したがって，システムに与える影響を少なくするために，loadcheck_intervalオペランドに指定する値は，5の倍数にすることをお勧めします。

MHP，ソケット受信型SPP，およびSUPの場合は，このオペランドを指定する必要はありません。指定しても無視されます。

なお，この機能は，TP1/Extension 1をインストールしていることが前提です。TP1/Extension 1をインストールしていない場合の動作は保証できませんので，ご了承ください。

●levelup_queue_count=U1,U2，およびleveldown_queue_count=D0,D1

　〜〈符号なし整数〉((0〜32767))

このサービスグループの負荷レベルを判断するサービス要求滞留数を指定します。

U1

サーバの負荷レベルがLEVEL1に上がったと判断するサービス要求滞留数

U2

サーバの負荷レベルがLEVEL2に上がったと判断するサービス要求滞留数

D0

サーバの負荷レベルがLEVEL0に下がったと判断するサービス要求滞留数

D1

サーバの負荷レベルがLEVEL1に下がったと判断するサービス要求滞留数

levelup_queue_countオペランド，leveldown_queue_countオペランドの各指定値は，次の条件を満たすように指定する必要があります。

（条件）　0≦D0＜U1≦D1＜U2

指定値が条件を満たしていない場合，サーバ起動時に定義エラーとなり起動が失敗となります。

なお，スケジュールサービス定義にscd_announce_server_status=Nを指定した場合は，このオペランドを指定しても無視されます。また，leveldown_queue_countオペランドは，levelup_queue_countオペランドが指定されている場合だけ有効とし，levelup_queue_countオペランドを指定しないで指定した場合は無視されます。逆に，levelup_queue_countオペランドを指定した場合でもleveldown_queue_countオペランドは省略できます。この場合，leveldown_queue_countオペランドの各指定値は，次のように決定されます。

D0＝U1／2
D1＝U1＋（U2−U1）／2　（D0，D1共に小数点以下は切り捨て）

MHP，ソケット受信型SPP，およびSUPの場合は，このオペランドを指定する必要はありません。指定しても無視されます。

なお，この機能は，TP1/Extension 1をインストールしていることが前提です。TP1/Extension 1をインストールしていない場合の動作は保証できませんので，ご了承ください。

●ipc_sockctl_highwater=ソケットの一時クローズ処理開始数パーセンテージ〔,ソケットの一時クローズ処理非対象数パーセンテージ〕

　〜〈符号なし整数〉((0〜100))

max_socket_descriptorsオペランドの指定値に対して，ソケットの一時クローズ処理開始数パーセンテージを指定します。

OpenTP1は，プロセス内のソケット用に使用しているファイル記述子の数が，次の値を超えた時点で，一時クローズ処理を開始します。

max_socket_descriptorsオペランドの指定値
×（ソケットの一時クローズ開始数パーセンテージ／100）

ソケットの一時クローズ処理開始数パーセンテージに0を指定した場合，コネクションを確立するたびに一時クローズ処理が実行されます。一時クローズ処理については，マニュアル「OpenTP1 解説」を参照してください。

また，一時クローズ処理の対象外とするコネクション数のパーセンテージも指定できます。一時クローズ処理の対象外とするコネクション数は，次の値です。

max_socket_descriptorsオペランドの指定値
×（ソケットの一時クローズ非対象数パーセンテージ／100）

ソケットの一時クローズ非対象数パーセンテージには，ソケットの一時クローズ処理開始数パーセンテージ以下の値を指定してください。ソケットの一時クローズ処理開始数パーセンテージより大きい値を指定した場合は，ソケットの一時クローズ処理開始数パーセンテージと同じ値が指定されたものとして動作します。

OpenTP1は，プロセス内で確立したコネクションを，確立した順に管理しています。ソケットの一時クローズ処理非対象数パーセンテージを指定した場合，最も古く確立されたコネクションから順に，一時クローズ処理要求が送信されます。

max_socket_descriptorsオペランドの指定値が大きくなく，かつソケットの一時クローズ処理開始数パーセンテージに小さい値が指定されていると，一時クローズ要求が多発し，性能に影響を与えたり，通信障害になったりすることがあります。

ここで指定を省略し，ユーザサービスデフォルト定義でも省略した場合，システム共通定義の値を仮定します。

●ipc_sockctl_watchtime=ソケット再利用可能監視時間

　〜〈符号なし整数〉((0〜65535))（単位：秒）

プロセス内のソケット用に使用しているファイル記述子の数が，max_socket_descriptorsオペランドの指定値になった時点から，一時クローズ処理によってソケットが再利用できるようになるまでの監視時間（秒）を指定します。

UAPが異常終了した場合に閉塞するかどうかはholdオペランド，term_watch_timeオペランドの指定によります。詳細については，ユーザサービス定義のholdオペランドおよびterm_watch_timeオペランドの説明を参照してください。

一時クローズ処理は，コネクションを確立したプロセス間の合意によってコネクションを切断するため，一時クローズ処理の要求を送信したプロセスはその応答を受けるまではコネクションを切断できません。応答を受信したあと，コネクションは切断され，ソケットが再利用できるようになります。

ipc_sockctl_watchtimeオペランドの指定値を経過しても，どのプロセスからも一時クローズ処理要求に対する応答が返らない場合，プロセスは強制停止されます。ipc_sockctl_watchtimeオペランドに0を指定した場合，無限に待ちます。

ここで指定を省略し，ユーザサービスデフォルト定義でも省略した場合，システム共通定義の値を仮定します。

●ipc_conn_interval=コネクション確立監視時間

　〜〈符号なし整数〉((8〜65535))（単位：秒）

データ送信時のコネクション確立監視時間を秒単位で指定します。

ノンブロッキングモードで呼び出したconnect()システムコールに対する応答を受信するまでの監視時間を指定します。

ここで指定を省略し，ユーザサービスデフォルト定義でも省略した場合，システム共通定義の値を仮定します。

●ipc_send_interval=データ送信監視間隔

　〜〈符号なし整数〉((5〜32767))（単位：秒）

データ送信時のデータ送信監視間隔を指定します。

ここで指定を省略し，ユーザサービスデフォルト定義でも省略した場合，システム共通定義の値を仮定します。

●ipc_send_count=データ送信監視回数

　〜〈符号なし整数〉((1〜32767))

データ送信時の送信完了監視回数を指定します。

OpenTP1のデータ送信監視時間は，次に示す秒数で監視します。

ipc_send_intervalオペランドの指定値　×　ipc_send_countオペランドの指定値

ここで指定を省略し，ユーザサービスデフォルト定義でも省略した場合，システム共通定義の値を仮定します。

●ipc_header_recv_time=通信制御データの受信監視時間

　〜〈符号なし整数〉((5〜32767))（単位：秒）

OpenTP1が，データの受信が始まったことをTCP/IPから通知されてから，通信制御データを受信するまでの監視時間を指定します。

ここで指定を省略し，ユーザサービスデフォルト定義でも省略した場合，システム共通定義の値を仮定します。

●rpc_close_after_send=Y|N

ノード間通信で確立したコネクションを保持したままにするか，ノード間通信が終了するたびにコネクションを切断するかどうかを指定します。このオペランドは，データの送信元に設定するオペランドです。

Y

ノード間通信が終了するたびにコネクションを切断する。

N

ノード間通信で確立したコネクションを保持する。

このオペランドにYを指定すると，次の状態を即時に検知できます。

ノード間で通信を行うOpenTP1で発生したハード障害によってコネクションが切断された

ノード間に設置されている無通信監視をする通信機器によってコネクションが切断された

ただし，ノード間通信が発生するたびにコネクションを確立し，通信が終了するとコネクションを切断するため，OSのコネクション確立と解放を繰り返す分だけオーバーヘッドが増加します。

指定値の優先順位は次のとおりです。（1.＞2.＞3.）

ユーザサービス定義

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

システム共通定義

ここで指定を省略し，ユーザサービスデフォルト定義でも省略した場合，システム共通定義の値を仮定します。

注意事項

OpenTP1で使用する通信で，毎回コネクション確立・切断を実施するため，性能が低下する可能性があります。性能に関しては，十分に検討したあと，この機能を使用してください。

OpenTP1で使用する通信で，毎回コネクション確立・切断を実施するため，OSのポートを大量に消費する可能性があります。ポートに関してのOS資源見積もり，設定を十分に検討したあと，このオペランドを使用してください。ポートに関するOSの設定の詳細は，OSのマニュアルを参照してください。

次に示す機能では，ノード間のTCP/IP通信であっても，このオペランドは適用されません。

・OpenTP1 クライアント製品とTP1/Server Base間の通信

・リモートAPI機能を使用し，rapクライアントからTP1/Server Baseのrapリスナー，rapサーバへの通信

・XAリソースサービスを使用したトランザクション連携機能

・TP1/Message Queueのチャネルを使用した，他のMQシステム（メッセージキューイング機能のキューマネジャがあるシステム）とTP1/Message Queueとのチャネル通信

・TP1/Message Queue のクライアント製品（TP1/Message Queue - Access）であるMQCクライアント機能とTP1/Message QueueのMQCサーバ機能との通信

・メッセージ制御機能（TP1/Message Control）を使用した，相手システムとの通信

●rpc_send_retry_count=TCP/IPコネクションの接続時にエラーが発生した場合のリトライ回数

　〜〈符号なし整数〉((0〜65535))

サーバの応答送信時のTCP/IPコネクションの接続で，ECONNREFUSED（239），EHOSTUNREACH（242），ENETUNREACH（229）のどれかのエラーが発生した場合，このオペランドでリトライ回数を指定することによって，エラーを回避できることがあります。

0を指定した場合は，TCP/IPコネクションの接続時に上記のエラーが発生しても接続をリトライしません。

このオペランドに1〜65535を指定し，TCP/IPコネクションの接続時に上記のエラーが発生した場合，rpc_send_retry_intervalオペランドに指定した時間を待ったあと，接続をリトライします。

ここで指定を省略し，ユーザサービスデフォルト定義でも省略した場合，システム共通定義の値を仮定します。

●rpc_send_retry_interval=TCP/IPコネクションの接続時にエラーが発生した場合のリトライ間隔

　〜〈符号なし整数〉((0〜300000))（単位：ミリ秒）

サーバの応答送信時のTCP/IPコネクションの接続で，ECONNREFUSED（239），EHOSTUNREACH（242），ENETUNREACH（229）のどれかのエラーが発生した場合，このオペランドでリトライ間隔をミリ秒単位で指定することによって，エラーを回避できることがあります。

0を指定した場合は，間隔を空けずにTCP/IPコネクションの接続をリトライします。1〜19は指定できません。1〜19を指定した場合は，20ミリ秒間隔を空けてからTCP/IPコネクションの接続をリトライします。

このオペランドは，rpc_send_retry_countオペランドに1〜65535を指定した場合に有効になります。

ここで指定を省略し，ユーザサービスデフォルト定義でも省略した場合，システム共通定義の値を仮定します。

●ipc_listen_sockbufset=Y|N

OpenTP1がプロセス間通信で使用するlistenソケットの生成時に，ipc_sendbuf_sizeオペランド，およびipc_recvbuf_sizeオペランドに指定したTCP/IPの送受信バッファサイズをlistenソケットに設定するかどうかを指定します。

Y

listenソケットに，TCP/IPの送受信バッファサイズを設定します。

N

listenソケットに，TCP/IPの送受信バッファサイズを設定しません。

ipc_sendbuf_sizeオペランド，およびipc_recvbuf_sizeオペランドに指定したTCP/IPの送受信バッファサイズは，OpenTP1プロセスがコネクション確立要求を受信し，コネクションを確立したあとに設定します。

コネクションを確立したあとにTCP/IPの送受信バッファサイズを変更するため，コネクションの接続元と接続先の間でTCP/IPのバッファサイズの値が異なり，通信の遅延が発生することがあります。

同一ノード内にTP1/Server BaseとTP1/Clientがあり，TP1/Clientから同一ノード内のTP1/Server Baseに対して通信を行う場合は，このオペランドにYを指定することをお勧めします。

ここで指定を省略し，ユーザサービスデフォルト定義でも省略した場合，システム共通定義の値を仮定します。

●ipc_recvbuf_size=TCP/IPの受信バッファサイズ

　〜〈符号なし整数〉((0，8192〜1048576))（単位：バイト）

コネクションごとに確保されるソケットの受信バッファのサイズを指定します。高速な通信媒体やMTUの大きな通信媒体を使用している場合，この値を大きくすることによって性能向上を図れます。

0を指定した場合は，OSの受信バッファサイズを適用します。受信データサイズが8,192バイトを超える場合，このオペランドに0を指定することで受信バッファのサイズが拡張され，性能向上を図れることがあります。

なお，0を指定する場合，このノードと通信するすべてのノードで同じ値を指定してください。同じ値を指定しない場合，通信するノードとバッファサイズに差異が生じ，通信性能が劣化するおそれがあります。また，1〜8191は指定できません。1〜8191を指定した場合，0を仮定します。

ipc_recvbuf_sizeオペランドに指定した値よりも小さいデータをやり取りし合う通信処理の場合，ipc_tcpnodelayオペランドにYを指定することを推奨します。

注

TCPは，受信したデータに対し，送達確認(ACK)パケットを返信します。

受信バッファのサイズに対し，受信したデータが小さいと，データを受信しても直ちにACKを返信しません(遅延ACK)。

このオペランドに大きな値を指定し，小さいデータをやり取りし合うような通信処理の場合，遅延ACKの影響によって性能が悪くなるおそれがあります。遅延ACKの詳細については，TCP/IPの文献を参照してください。

このオペランドの値は，OSで使用できるTCP/IPの受信バッファのサイズ以下の値を指定してください。

ユーザサーバの場合，ここで指定を省略し，ユーザサービスデフォルト定義でも省略したときは，システム共通定義の値を仮定します。

●ipc_sendbuf_size=TCP/IPの送信バッファサイズ

　〜〈符号なし整数〉((0，8192〜1048576))（単位：バイト）

コネクションごとに確保されるソケットの送信バッファのサイズを指定します。高速な通信媒体やMTUの大きな通信媒体を使用している場合，この値を大きくすることによって性能向上を図れます。

0を指定した場合は，OSの送信バッファサイズを適用します。送信データサイズが8,192バイトを超える場合，このオペランドに0を指定することで送信バッファのサイズが拡張され，性能向上を図れることがあります。

0を指定することを推奨する場合については，「3.　システム共通定義」のipc_sendbuf_sizeオペランドの説明を参照してください。

なお，0を指定する場合，このノードと通信するすべてのノードで同じ値を指定してください。同じ値を指定しない場合，通信するノードとバッファサイズに差異が生じ，通信性能が劣化するおそれがあります。また，1〜8191は指定できません。1〜8191を指定した場合，0を仮定します。

ipc_sendbuf_sizeオペランドに指定した値よりも小さいデータをやり取りし合う通信処理の場合，ipc_tcpnodelayオペランドにYを指定することを推奨します。

注

このオペランドの値は，OSで使用できるTCP/IPの送信バッファのサイズ以下の値を指定してください。

ユーザサーバの場合，ここで指定を省略し，ユーザサービスデフォルト定義でも省略したときは，システム共通定義の値を仮定します。

●polling_control_data=Y|N

OpenTP1制御下のSPP，MHPで，サービス要求の受信待ちの状態のときに，定期的に待ち状態に割り込んで，一時クローズ処理要求が到着していないかどうかを検査することを指示します。

Y

サービス要求の受信待ち状態に定期的に割り込み，一時クローズ処理要求が到着していないかどうかを検査します。

また，このほかにも，相手先のUAPプロセスとのコネクションが切断されているかどうかを監視できます。

コネクション切断監視の詳細については，マニュアル「OpenTP1 運用と操作」の障害対策の説明を参照してください。

N

サービス要求の受信待ち状態に割り込まないで，サービス要求が到着するまで待ち状態を継続します。

クライアントからのサービス要求が長時間発生しない常駐UAPには，このオペランドにYを指定する必要があります。

また，時間帯によって業務トラフィックにばらつきのあるシステムでは，常駐UAPのユーザサービス定義のこのオペランドにYを指定する必要があります。

●thread_yield_interval=ソケットの再利用指示を受信できる契機を与えるインタバル時間

　〜〈符号なし整数〉((1〜86400))（単位：秒）

OpenTP1制御下のSPP，MHPで，サービス要求の受信待ちの状態のときに，定期的に待ち状態に割り込んで，一時クローズ処理要求が到着していないかどうかを検査する場合の検査インタバル時間を秒単位で指定します。

また，サービス要求を待つことなく次々にサービスを受け付けている場合には，連続してサービス要求を受け付けた時間が一定時間を超えたところで，一時クローズ処理要求が到着していないかどうかを検査します。このオペランドは，このインタバル値としても使用されます（連続してサービス要求を受け付けた時間がこのオペランド指定値を超えたときの，一時クローズ処理要求到着検査には，シグナルによる割り込みは発生しません）。

なお，このオペランドに指定するインタバル時間を極端に短くすると，検査のための割り込みが多発し性能が低下するおそれがあります。そのため，指定するインタバル時間については，性能への影響を十分に検討してください。

このオペランドの指定値は，一時クローズ処理要求を送信したプロセスが応答を待つ時間（180秒：ipc_sockctl_watchtimeオペランドのデフォルト値）よりも小さい値を設定します。

サービス要求待ち状態に割り込んで，一時クローズ処理要求受信を検査する機能は，polling_control_dataオペランドにYを指定した場合にだけ動作します。連続してサービス要求を受け付けたときに一時クローズ処理要求受信を検査する機能は，polling_control_dataオペランドの指定に関係なく，動作します。

このオペランドに最大値を指定した場合は，polling_control_dataオペランドの指定に関係なく，一時クローズ処理要求が到着していないかどうかの検査を実行しません。

●groups=グループ識別子〔,グループ識別子〕

　〜〈符号なし整数〉((0〜4294967294))

このサービスグループのグループアクセスリストを設定します。

OSに登録されているグループIDを指定してください。このオペランドには16個まで指定できます。

最大値はOSに依存するので，使用しているOSのマニュアルを参照してください。

なお，このオペランドの指定値に関係なく，ユーザサーバプロセスの実効グループIDは，OpenTP1ディレクトリのグループIDと同じ値に設定されます。

●loadlevel_message=Y|N|A

サーバの負荷レベルを変更した場合に，KFCA00849-Wの負荷レベル通知メッセージを出力するかどうかを指定します。

Y

サーバの負荷レベルが高負荷状態（LEVEL2）に上がった場合，および通常状態（LEVEL0）に下がった場合に，通知メッセージを出力します。

N

サーバの負荷レベルを変更しても通知メッセージを出力しません。

A

サーバの負荷レベルを変更した場合に，通知メッセージを出力します。

通知メッセージの出力タイミングは，loadcheck_intervalオペランドによって指定する負荷監視インタバルの値によって異なります。負荷監視インタバルを指定していない場合は，30秒を仮定します。

●ipc_backlog_count=コネクション確立要求を格納するキューの長さ

　〜〈符号なし整数〉((0〜4096))

コネクション確立要求を格納するキューの長さ（listenシステムコールのバックログ数）を指定します。

0（デフォルト値）を指定した場合，listenシステムコールのバックログ数に設定する実数値はOSによって異なります。デフォルト値を指定した場合の実数値については，「リリースノート」を参照してください。

実際のキューの長さは，指定した値より長くなる場合があります。

キューの長さの上限値，下限値は，各OSによって異なります。OSによって，キューの長さの上限値，下限値が制限されている場合，設定した値が有効にならないことがあります。コネクション確立要求を格納するキューについての詳細は，OSのマニュアル，または，TCP/IPの文献を参照してください。

このオペランドで指定した値より多くの接続要求が瞬間的に発生すると，キューからあふれた接続要求は破棄されます。瞬間的に発生する接続要求の数を考慮した値を設定してください。

ここで指定を省略し，ユーザサービスデフォルト定義でも省略した場合，システム共通定義の値を仮定します。

●rpc_buffer_pool_max=プーリングするバッファ数

　〜〈符号なし整数〉((1〜64))

RPCによるメッセージ受信処理で，メッセージ組み立てなどでプーリングするバッファの数を指定します。

メッセージ受信処理で使用するバッファは，プロセス固有領域に確保し，バッファが不要となった時点でプーリングします。このとき，バッファプール内のプーリング数が，このオペランドで指定した数を超える場合は，新たにプーリングするバッファも含め，サイズのいちばん小さいバッファを解放します。

このオペランドにデフォルト値より小さな値を指定すると，メッセージ受信処理で使用するバッファの数が，このオペランドで指定した数を超えることになります。その場合の注意事項を次に示します。

不足分のバッファの確保／解放を行うため，メッセージ受信処理性能が低下するおそれがあります。

不足分のバッファの確保時にエラーが発生し，メッセージ受信処理が失敗するおそれがあります。

このオペランドは，ユーザサービスデフォルト定義でも指定できます。

ここで指定を省略した場合，ユーザサービスデフォルト定義の値を仮定します。

●schedule_delay_limit=スケジュール遅延限界経過時間

　〜〈符号なし整数〉((0〜32767))（単位：秒）

スケジュールキューによるスケジューリングの遅延限界経過時間を指定します。

スケジュールキューにサービス要求が登録されているにもかかわらず，サービス要求が取り出されない状態が，このオペランドに指定した時間を超えた場合，該当サーバごとにKFCA00838-Wメッセージを出力します。この際，schedule_delay_abortオペランドでYを指定している場合には，SCDデーモンが異常終了してOpenTP1がシステムダウンします。

このオペランドを省略，または0を指定した場合，スケジュール遅延を監視しません。

スケジュールサービスは，10秒のインタバルでスケジュール遅延を監視するため，スケジュール遅延を検知するのに最大10秒掛かることがあります。

このオペランドには，該当サーバの起動処理時間およびサービス処理時間よりも大きい値を指定してください。

このオペランドは，MHP，ソケット受信型SPP，SUPに指定しても無視されます。

●schedule_delay_abort=Y|N

スケジュール遅延時にシステムダウンするかどうかを指定します。

Y

スケジュール遅延時にシステムダウンします。

N

スケジュール遅延時にシステムダウンしません。

スケジュールキューにサービス要求が登録されているにもかかわらず，サービス要求が取り出されない状態が，schedule_delay_limitオペランドに指定した時間を超えた場合，このオペランドでYを指定すると，KFCA00839-Eメッセージを出力したあと，SCDデーモンが異常終了してシステムダウンします。

schedule_delay_limitオペランドを省略，または0を指定した場合，このオペランドの指定は無視されます。

このオペランドは，MHP，ソケット受信型SPP，SUPに指定しても無視されます。

●rap_autoconnect_con_error_msg=Y|N

rapクライアントでオートコネクトモードを使用していて，一度rapサーバとのコネクションが確立されていても，以降のAPIの代理実行要求時，rapサーバとのコネクションの切断を検知した場合に，エラーメッセージを出力するかどうかを指定します。

このオペランドでYを指定するか，省略した場合は，メッセージを出力します。

Y

APIの代理実行要求時，rapサーバとのコネクションが切断されていた場合に，エラーメッセージを出力します。

N

APIの代理実行要求時，rapサーバとのコネクションが切断されていた場合に，エラーメッセージを出力しません。

なお，このオペランドで抑止されるメッセージは次のとおりです。

KFCA26971-Eメッセージの理由コード=36

●core_shm_suppress=Y|N

コアファイルへの共用メモリダンプの出力を抑止するかどうかを指定します。

Y

コアファイルへのOpenTP1共用メモリダンプの出力を抑止します。

N

コアファイルへのOpenTP1共用メモリダンプの出力を抑止しません。

KFCA00105-Eメッセージを出力して，プロセスが異常終了した場合，OSによっては，コアファイルにアタッチ中の共用メモリダンプを出力します。

このオペランドにYを指定すると，OSによるコアファイルへのOpenTP1共用メモリダンプの出力を抑止します。これによって，次の問題を回避できます。

コアファイルのサイズ増大によるディスク容量の圧迫

コアファイル出力時のI/O占有によるマシン負荷の増大

このオペランドが有効になる前に，KFCA00105-Eメッセージを出力して，プロセスが異常終了した場合は，コアファイルに，アタッチ中のOpenTP1共用メモリダンプが出力されます（コアファイルに，共用メモリダンプの出力が行われるOSだけが該当）。

また，このオペランドにYを指定した場合でも，KFCA00105-Eメッセージ（アボートコード=iprfex1）を出力してプロセスが異常終了したときは，コアファイルにアタッチ中のOpenTP1共用メモリダンプが出力されます（コアファイルに，共用メモリダンプが出力されるOSだけが該当）。Linux版OpenTP1では，このケースでもprc_coredump_filterオペランドに1を指定することで，コアファイルへの共用メモリダンプの出力を抑止できます。このため，Linux版OpenTP1でコアファイルへの共用メモリダンプの出力を抑止する場合は，core_shm_suppressオペランドではなく，prc_coredump_filterオペランドを指定することをお勧めします。prc_coredump_filterオペランドの詳細については，システム共通定義またはユーザサービス定義の説明を参照してください。

注

OpenTP1の共用メモリダンプは，システムダウン時にだけ出力されます。そのため，UAPが異常を検知し，終了した場合，共用メモリダンプは出力されません。OSがコアファイルに共用メモリダンプを出力する場合，コアファイルに出力された共用メモリダンプが有効な資料になります。このオペランドにYを指定すると，共用メモリダンプが出力されないため，トラブルシュートが困難になることがあります。

●xat_connect_resp_time=通信イベント処理用SPPのアソシエーション確立の最大応答待ち時間

　〜〈符号なし整数〉((0〜65535))（単位：秒）

プロトコルにOSI TPを使用する通信で，通信イベント処理用SPP内のアソシエーション確立要求（dc_xat_connect関数）の最大応答待ち時間を指定します。0を指定した場合は，応答を無限に待ちます。

putenv形式のXAT_CONNECT_RESP_TIMEオペランドでも同じ内容を指定できます。このオペランドとputenv形式のXAT_CONNECT_RESP_TIMEオペランドの関係を次の表に示します。

表3‒21　set形式のxat_connect_resp_timeオペランドとputenv形式のXAT_CONNECT_RESP_TIMEオペランドの関係

set形式のxat_connect_resp_timeオペランドの指定

putenv形式のXAT_CONNECT_RESP_TIMEオペランドの指定

有効になる値

（単位：秒）

○

×

set形式のxat_connect_resp_timeオペランドの指定値

×

○

putenv形式のXAT_CONNECT_RESP_TIMEオペランドの指定値

○

○

set形式のxat_connect_resp_timeオペランドの指定値

×

×

180※

（凡例）

○：指定します。

×：指定しません。

注※

set形式のxat_connect_resp_timeオペランド，およびputenv形式のXAT_CONNECT_RESP_TIMEオペランドの両方の指定を省略した場合は，180秒が仮定されます。

●scd_poolfull_check_interval=KFCA00853-Eメッセージ出力インタバル時間

　〜〈符号なし整数〉((0〜32767))（単位：秒）

メッセージ格納バッファプールのメモリ不足が連続して発生した場合，KFCA00853-Eメッセージを出力するインタバル時間を指定します。

メッセージ格納バッファプールのメモリ不足がscd_poolfull_check_intervalオペランドで指定したインタバル時間中にscd_poolfull_check_countオペランドで指定した回数に達すると，KFCA00853-Eメッセージが1回出力されます。

このオペランドで指定したインタバルは，メッセージ格納バッファプールのメモリ不足が発生した時点で開始されます。また，メッセージ格納バッファプールのメモリ不足がこのオペランドの指定値以上経過して発生した時点で再設定されます。

このオペランドに0を指定した場合は，メッセージKFCA00853-Eの出力を抑止します。

このオペランドは，キュー受信型SPPにだけ指定できます。キュー受信型SPP以外のユーザサーバに指定しても無視されます。

●scd_poolfull_check_count=KFCA00853-Eメッセージ出力判断値

　〜〈符号なし整数〉((1〜32767))（単位：回）

メッセージ格納バッファプールのメモリ不足が連続して発生した場合，KFCA00853-Eメッセージを出力する判断値を指定します。

メッセージ格納バッファプールのメモリ不足がscd_poolfull_check_intervalオペランドで指定したインタバル時間中にscd_poolfull_check_countオペランドで指定した回数に達すると，KFCA00853-Eメッセージが出力されます。

このオペランドは，キュー受信型SPPにだけ指定できます。キュー受信型SPP以外のユーザサーバに指定しても無視されます。

●scd_pool_warning_use_rate=警告メッセージの出力判断値になるメッセージ格納バッファプール使用率の上限値

　〜〈符号なし整数〉((0〜99))（単位：%）

警告メッセージを出力する判断値になるメッセージ格納バッファプールの使用率の上限値を指定します。

ユーザサービス定義のmessage_store_buflenオペランド，またはscdbufgrp定義コマンドで指定したメッセージ格納バッファプール長に占めるメモリの使用率を指定します。

警告メッセージ（KFCA00829-W）はサービス要求をスケジュールキューにキューイングした時点のメッセージ格納バッファプールの使用率を基に出力されます。一度表示されると使用率がこのオペランドの指定値を下回り，再びこのオペランドの指定値を上回らないかぎり出力されません。

このオペランドに0を指定した場合，または省略した場合には警告メッセージは出力されません。

スケジュールバッファグループによってメッセージ格納バッファプールを複数のユーザサーバで共用している場合は，共用している全ユーザサーバの使用中サイズで使用率が計算されます。したがって，ある特定のユーザサーバの使用中サイズがこのオペランドで指定した使用率を超えていない場合にも警告メッセージ（KFCA00829-W）が出力されることがあります。

このオペランドの指定に関係なく，メッセージ格納バッファプールが不足した場合は，警告メッセージ（KFCA00829-W）は出力されないで，エラーメッセージ（KFCA00854-E）が出力されます。

このオペランドは，キュー受信型SPPにだけ指定できます。キュー受信型SPP以外のユーザサーバに指定しても無視されます。

●scd_pool_warning_interval=メッセージ格納バッファプール使用率超過時の警告メッセージ出力インタバル時間

　〜〈符号なし整数〉((0〜32767))（単位：秒）

メッセージ格納バッファプール使用率（scd_pool_warning_use_rateオペランドで指定）が超過したときの警告メッセージ（KFCA00829-W）を出力するインタバル時間を指定します。

このオペランドを指定した場合，警告メッセージ（KFCA00829-W）が出力された時点からこのオペランドの指定時間が経過するまでの間は，メッセージ格納バッファプール使用率が，scd_pool_warning_use_rateオペランドの指定値を超えても警告メッセージ（KFCA00829-W）は出力されません。

●ipc_tcpnodelay=Y|N

OpenTP1がノード間で使用する通信ソケット（INETドメイン）に，TCP_NODELAYオプションを使用するかどうかを指定します。

TCP_NODELAYオプションを使用すると（このオペランドにYを指定すると），Nagleアルゴリズムが無効になるので，送信済みデータの応答待ちの状態でも遅延させることなくデータを送信できます。ただし，TCP_NODELAYオプションを使用することで，INETドメイン通信時の送信効率が低下し，ネットワークの負荷が大きくなる場合があります。この場合は，ネットワークの帯域などを考慮してipc_sendbuf_sizeオペランド，ipc_recvbuf_sizeオペランドのチューニングを検討するか，このオペランドにNを指定してTCP_NODELAYオプションを無効にするかを検討してください。

●stay_watch_queue_count=スケジュールキューの滞留監視判定を開始する際の判断になるサービス要求滞留数

　〜〈符号なし整数〉((0〜32767))

スケジュールキューの滞留監視判定を開始する際の判断になるサービス要求滞留数を指定します。

このオペランドの指定値以上のサービス要求がスケジュールキューに滞留している場合，スケジュールキューの滞留監視判定が始まります。スケジュールキューの滞留監視を開始するサービス要求滞留数をチェックする間隔は，stay_watch_start_intervalオペランドで指定します。スケジュールキューの滞留監視判定の開始以降は，stay_watch_check_intervalオペランドで指定した間隔でサービス要求の滞留監視をします。サービス要求滞留数がこのオペランドの指定値よりも少なくなった場合，いったんスケジュールキューの滞留監視判定は終了します。サービス要求滞留数がこのオペランドで指定した値以上になると，再びスケジュールキューの滞留監視判定が始まります。

このオペランドに0を指定した場合，スケジュールキューの滞留監視をしません。また，このオペランドを，RAP，MHP，ソケット受信型SPP，およびSUPに指定しても無視されます。

スケジュールキューの滞留監視機能の詳細については，マニュアル「OpenTP1 運用と操作」を参照してください。

●stay_watch_check_rate=スケジュールキューの滞留監視判定処理で使用するサービス要求の処理率

　〜〈符号なし整数〉((1〜100))（単位：%）

スケジュールキューの滞留監視判定で使用する，サーバが処理できるサービス要求の処理率を指定します。

スケジュールキューの滞留監視判定で，次の判定式を満たす場合には，該当サーバごとにKFCA00833-Wメッセージを出力します。

スケジュールキューの滞留監視判定式

サービス要求の処理件数 < このオペランドの指定値 × スケジュールキューに滞留しているサービス要求数

スケジュールキューの滞留監視判定式を満たし，かつstay_watch_abortオペランドでYを指定している場合は，SCDデーモンが異常終了（アボートコードhclen001を出力）してOpenTP1が停止します。

stay_watch_queue_countオペランドを省略，または0を指定した場合，このオペランドの指定は無視されます。

このオペランドを，RAP，MHP，ソケット受信型SPP，およびSUPに指定しても無視されます。

スケジュールキューの滞留監視機能の詳細については，マニュアル「OpenTP1 運用と操作」を参照してください。

●stay_watch_abort=Y|N

スケジュールキューの滞留監視判定式を満たした場合に，OpenTP1システムをダウンさせるかどうかを指定します。

Y

スケジュールキュー滞留監視判定式を満たした場合に，KFCA00833-Wメッセージ，およびKFCA00834-Eメッセージを出力します。そして，該当するユーザサーバを強制終了し，SCDデーモンを強制終了（アボートコードhclen001を出力）させてOpenTP1を停止させます。

N

スケジュールキュー滞留監視判定式を満たした場合に，KFCA00833-Wメッセージを出力します。OpenTP1システムはダウンしません。

stay_watch_queue_countオペランドを省略，または0を指定した場合，このオペランドの指定は無視されます。また，このオペランドを，RAP，MHP，ソケット受信型SPP，およびSUPに指定しても無視されます。

スケジュールキューの滞留監視機能の詳細については，マニュアル「OpenTP1 運用と操作」を参照してください。

●stay_watch_start_interval=スケジュールキューの滞留監視インタバル時間

　〜〈符号なし整数〉((1〜32767))（単位：秒）

スケジュールキューに滞留しているサービス要求数を監視するインタバル時間を指定します。

stay_watch_queue_countオペランドを省略，または0を指定した場合，このオペランドの指定は無視されます。また，このオペランドを，RAP，MHP，ソケット受信型SPP，およびSUPに指定しても無視されます。

通常，SCDデーモンは10秒間隔で負荷監視をしています。このオペランドを指定した場合，SCDデーモンは，10，各ユーザサーバのstay_watch_start_intervalオペランドの指定値，および各ユーザサーバのstay_watch_check_intervalオペランドの指定値の最大公約数で負荷監視をします。OpenTP1システムに与える影響を少なくするために，このオペランドには5の倍数を指定することをお勧めします。

スケジュールキューの滞留監視機能の詳細については，マニュアル「OpenTP1 運用と操作」を参照してください。

●stay_watch_check_interval=スケジュールキューの滞留監視判定インタバル時間

　〜〈符号なし整数〉((1〜65534))（単位：秒）

スケジュール滞留監視判定式を基に判定処理を行うインタバル時間を指定します。

スケジュール滞留監視判定式による判定処理は，stay_watch_queue_countオペランドの指定値以上のサービス要求数がスケジュールキューに滞留した場合に開始されます。

stay_watch_queue_countオペランドを省略，または0を指定した場合，このオペランドの指定は無視されます。また，このオペランドを，RAP，MHP，ソケット受信型SPP，およびSUPに指定しても無視されます。

通常，SCDデーモンは10秒間隔で負荷監視をしています。このオペランドを指定した場合，SCDデーモンは，10，各ユーザサーバのstay_watch_start_intervalオペランドの指定値，および各ユーザサーバのstay_watch_check_intervalオペランドの指定値の最大公約数で負荷監視をします。OpenTP1システムに与える影響を少なくするために，このオペランドには5の倍数を指定することをお勧めします。

スケジュールキューの滞留監視機能の詳細については，マニュアル「OpenTP1 運用と操作」を参照してください。

●trn_completion_limit_time=トランザクション完了限界時間

　〜〈符号なし整数〉((0〜65535))（単位：秒）

トランザクションブランチの開始から終了までの最大実行時間を指定します。指定時間を超えた場合，このトランザクションブランチのプロセスが異常終了したあとに，トランザクションブランチが回復プロセスによってコミットまたはロールバックのどちらかに決着して終了します。0を指定した場合は，トランザクションブランチの最大実行時間を監視しません。

UAPが異常終了した場合に閉塞するかどうかはholdオペランド，term_watch_timeオペランドの指定によります。詳細については，ユーザサービス定義のholdオペランドおよびterm_watch_timeオペランドの説明を参照してください。

このオペランドの監視対象区間は，dc_trn_begin関数などの呼び出しやサービス関数の開始によるトランザクションの開始から，トランザクションの同期点処理終了情報（TJ）の取得後であるトランザクションブランチの終了までです。ただし，トランザクションの最適化が行われた場合，サーバ側のトランザクションブランチに対する監視が終了するのは，クライアント側に応答を返したあとです。このオペランドの監視対象区間の詳細および各種タイマ監視との関係については，「付録A.2　トランザクションの時間監視」を参照してください。

ここで指定を省略し，ユーザサービスデフォルト定義でも省略した場合，トランザクションサービス定義の値を仮定します。

注

トランザクション完了限界時間の精度は秒単位です。そのため，タイミングによっては，このオペランドに指定した値よりも最大約1秒長い時間でプロセスを強制停止することがあります。

●rap_message_id_change_level=メッセージIDの変更レベル

　〜〈符号なし整数〉((0〜2))

リモートAPI機能を使用する場合に出力される可能性の高いエラーメッセージでは，メッセージの種類のEをWに変更するために，メッセージIDを変更できます。変更する内容によってレベルを指定してください。

メッセージログを監視し，メッセージの種類がEであるかWであるかによって管理方法を区別したい場合にこのオペランドを使用してください。

このオペランドによって，変更されるのはメッセージIDだけであり，メッセージの内容は変更されません。

0

メッセージIDを変更しないで，従来どおりのメッセージIDで出力します。

1

特定の理由コードが出力される条件で，メッセージの種類のEをWに変更するために，メッセージIDを変更できます。

2

1を指定した場合に加え，メッセージの種類のEをWに変更するために，メッセージIDを変更できます。

このオペランドの指定値と出力されるメッセージの対応についてはrapリスナーサービス定義のrap_message_id_change_levelオペランドを参照してください。

●log_audit_out_suppress=Y|N

このユーザサーバから出力される監査ログを抑止する場合に指定します。

Y

このユーザサーバから出力される監査ログを抑止します。

N

このユーザサーバから出力される監査ログを抑止しません。このオペランドはログサービス定義のlog_audit_outオペランドにYを指定した場合に有効です。

●log_audit_message=監査ログ取得メッセージID〔,監査ログ取得メッセージID〕…

　〜〈符号なし整数〉((33400〜99999))

監査ログを取得する項目のメッセージIDの番号を33400〜99999の範囲で指定します。指定できるメッセージIDは最大2,048個です。

次に示す監査ログのメッセージIDを指定できます。

OpenTP1が取得する監査ログのうちユーザサービス定義に指定できる監査ログのメッセージID

UAPで任意に取得する監査ログのメッセージID

このオペランドで指定できるメッセージIDについては，「付録C　監査イベントを取得する定義」を参照してください。

ここで指定を省略し，ユーザサービスデフォルト定義でも指定を省略した場合，ログサービス定義の値を仮定します。

このオペランドは，ログサービス定義のlog_audit_outオペランドにYを指定し，ユーザサービス定義のlog_audit_out_suppressオペランドにNを指定した場合に有効です。

●mcf_prf_trace=Y|N

ユーザサーバごとに，MCF性能検証用トレース情報を取得するかどうかを指定します。このオペランドの指定値を有効にするには，システムサービス共通情報定義のmcf_prf_trace_levelオペランドに00000001を指定してください。

Y

MCF性能検証用トレース情報を取得します。

N

MCF性能検証用トレース情報を取得しません。

このオペランドは，ユーザサービスデフォルト定義でも指定できます。

指定値の優先度は，次のとおりです（1.>2.）。

ユーザサービス定義

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

オペランドの指定，または指定値に誤りがある場合は，ユーザサーバの開始処理中にユーザサーバが異常終了します。

ユーザサーバでのMCF性能検証用トレース情報取得有無とオペランドの指定値の関係を，次の表に示します。

表3‒22　ユーザサーバでのMCF性能検証用トレース情報取得有無とオペランドの指定値の関係

システムサービス共通情報定義

mcf_prf_trace_levelオペランドの指定値

ユーザサービス定義

mcf_prf_traceオペランドの指定値

Y

N

00000000

取得しない

取得しない

00000001

取得する

取得しない

このオペランドの使用は，TP1/Extension 1をインストールしていることが前提です。TP1/Extension 1をインストールしていない場合の動作は保証できません。

●scd_refresh_process=Y|N

このサービスグループのプロセスを，一つのサービス要求を処理するごとに起動し直すかどうか（非常駐UAPプロセスのリフレッシュ機能を使用するかどうか）を指定します。

Y

一つのサービス要求を処理するごとに新たなプロセスを起動します。既存のプロセスは終了します。

このオペランドにYを指定すると，1回のサービス要求で1つのプロセスを使用します。そのため，リエントラント構造ではないUAPでもサービスを要求できます。ただし，複数のサービス要求を処理する場合にプロセスの起動と停止がサービス要求数分発生するため，システム形態によってはサービス要求の処理性能が低下することがあります。

また，ユーザサービス定義のtermed_after_serviceオペランド，およびservice_wait_timeオペランドの指定は無視されます。

N

スケジュールキューにサービス要求が存在する場合は，同一プロセスで続けてサービス要求を処理します。

次の場合，このオペランドの指定は無視されます。

ユーザサービス定義，またはユーザサービスデフォルト定義のparallel_countオペランドの常駐プロセス数に0以外を指定した場合

ユーザサービス定義，またはユーザサービスデフォルト定義のbalance_countオペランドに0以外を指定した場合

SPPのソケット受信型サーバ，およびSUPの場合

●rap_extend_function=リモートAPI機能の機能拡張レベル

　〜〈16進数字〉((00000000〜00000001))

リモートAPI機能の機能拡張レベルを指定します。機能の拡張レベルを複数指定する場合，それぞれの指定値の論理和を指定してください。

00000000

リモートAPI機能を機能拡張しません。

00000001

rapクライアントとrapサーバ間のdc_rpc_call関数の処理でタイムアウト事象が発生した場合のdc_rpc_call関数のリターン値を，DCRPCER_NET_DOWN（-306）からDCRPCER_TIMED_OUT（-307）に変更します。

リターン値が変更となるのは次の場合です。

rapクライアントに指定されたwatch_timeオペランドの指定時間内に，サービス要求先サーバからの応答が返らなかった場合

rapクライアントからトランザクショナルRPCを実行した時点でrapクライアントに指定されたtrn_limit_timeオペランドの指定値を満たした場合

●prc_coredump_filter=コアファイルに共用メモリを含めるかの判断値

　〜〈符号なし整数〉((1，3，65，67))

コアファイルに共用メモリを含めるかどうかを設定します。このオペランドは，適用OSがLinuxの場合に指定できます。

1

共用メモリを含めません。

3

共用メモリを含めます。ただし，Hugepage機能が適用されている共用メモリは含みません。

65

Hugepage機能が適用されている共用メモリだけ含めます。

67

すべての共用メモリを含めます。

コアファイルに共用メモリを含めると，コアファイルのサイズが大きくなります。コアファイル出力時にディスクを圧迫するおそれがありますので，注意してください。コアファイルが出力されるディレクトリは，システム共通定義のprc_current_work_pathオペランドを参照してください。

コアファイルのサイズが大きくなると，次の処理時間に影響がありますので，注意してください。

dcsetupコマンドの実行時間

dcresetコマンドの実行時間

dccspoolコマンドの実行時間

dcrasgetコマンドの実行時間

また，コアファイルの出力に時間が掛かると，次の処理時間に影響がありますので，注意してください。

OpenTP1の再開始時間

系切り替え時間

dcstopコマンドの-fdオプション実行時間

dcsvstopコマンドの-fdオプション実行時間

OpenTP1が使用する共用メモリのHugepage機能に関しては，マニュアル「OpenTP1 運用と操作」のHugepage機能の適用（Linux限定）の説明を参照してください。

UAPが使用するOpenTP1以外の他製品で，共用メモリにHugepage機能が適用されているかどうかは，各製品のマニュアルや設定を確認してください。

共用メモリの属性と，このオペランドの関係は次のとおりです。

共用メモリのHugepage属性

prc_coredump_filter指定値

1

3

65

67

指定なし

×

○

×

○

指定あり

×

×

○

○

（凡例）

○：共用メモリがコアファイルに含まれます

×：共用メモリがコアファイルに含まれません

このオペランドはシステム共通定義，ユーザサービスデフォルト定義，およびユーザサービス定義に指定できます。OpenTP1システム全体に有効にする場合は，システム共通定義に指定します。

指定値の優先順位は次のとおりです（1.＞2.＞3.）。

ユーザサービス定義

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

システム共通定義

システム共通定義内のこのオペランドを変更した場合は，dcresetコマンドを実行してください。

このオペランドの指定値に従い，プロセス生成直後にOpenTP1がLinuxのコアファイルのフィルタリング（coredump_filter）へ設定します。指定値に誤りがあると，意図したとおりに動作しません。また，対応OS以外の環境で指定した場合は無視されます。

OpenTP1が提供する次のサービスでは，ユーザサービスデフォルト定義に指定した定義内容が有効になります。

MQCゲートウェイサービス

リポジトリ管理サーバ

リアルタイム統計情報サービス

rapクライアントマネジャ，rapリスナー，およびrapサーバ

注意事項

例えば，巨大な共用メモリを使用している環境で，コアファイルのサイズを極力抑えたい場合，このオペランドに67以外を指定することでコアファイルに共用メモリが含まれなくなり，コアファイルの大きさを抑えることができます。ただし，コアファイルに含まれている共用メモリは，そのコアファイルを出力したプロセスがその瞬間参照していた共用メモリであって，トラブルシュートに大変有益な情報です。コアファイルを出力する状態自体が何か問題がある場合であり，このコアファイルに含まれている共用メモリ情報はその問題を解決するのに必要な情報です。

このオペランドに67以外を設定することで，そのトラブルシュートに必要な情報が一部失われ，問題解決に時間が掛かるおそれがあります。特に，システムサーバがコアファイルを出力する状態は，システム的に異常な状態になっているおそれが高く，その瞬間の共用メモリがトラブルシュートに不可欠なケースがあります。

これらのことを踏まえた上で，このオペランドの指定値を決めてください。

●watch_time=最大応答待ち時間

　〜〈符号なし整数〉((0〜65535))（単位：秒）

RPCによってプロセス間で通信する場合，サービス要求を送信してからサービスの応答が返るまでの待ち時間の最大値を指定します。

OpenTP1の終了処理で，このオペランドで指定した時間だけ終了処理を待ち合わせる場合があります。したがって，大きな値を指定した場合，OpenTP1の終了処理に時間が掛かる場合があります。

指定時間を過ぎても応答がない場合は，RPCは送受信タイムアウトとしてエラーリターンします。

0を指定した場合は，応答を受信するまで待ち続けます。0を指定した場合，OpenTP1が終了しない場合があります。

このオペランドは，システム共通定義のwatch_timeオペランドのデフォルト値で使用してください。

特別なチューニングを必要とする場合以外は，このオペランドの内容を変更しないことをお勧めします。

システム共通定義のwatch_timeオペランドのデフォルト値よりも，極端に小さな値または大きな値を指定すると，OpenTP1ダウンに至る障害が発生する場合がありますので，ご注意ください。

●scd_process_ctl_opt=0|1

このサービスグループ下のサーバプロセスが異常終了した場合に，サーバプロセスの再起動を抑止するかどうかを指定します。

サーバプロセスが異常終了した場合，サービスグループまたはサービスが閉塞する前に，タイミングによっては新たに起動されたプロセスが次のサービス要求を取り出してしまうことがあります。

これを抑止するには，このオペランドに1を指定します。

このオペランドが有効となるのは1回目のダウンでサービスグループ閉塞またはサービス閉塞となる（holdオペランドにYが指定された）ユーザサーバだけです。

0

サーバプロセスが異常終了してからサービスグループ，またはサービスが閉塞するまでの間，サーバプロセスの再起動を可能とします。

1

サーバプロセスが異常終了してからサービスグループ，またはサービスが閉塞するまでの間，サーバプロセスの再起動を抑止します。

この指定値は次の条件を満たすユーザサーバにだけ有効です。

holdオペランドにYを指定したキュー受信型SPP，またはMHP

parallel_countオペランドで最大プロセス数に1を指定

SPPのソケット受信型サーバ，およびSUPの場合は，指定する必要はありません。

●rpc_rap_inquire_time_check=Y|N

常設コネクションを使用し，かつオートコネクトモード※1の場合に，リモートAPI機能を使用してdc_rpc_call関数を呼び出すrapクライアント（SUP，SPP，MHP）で問い合わせ間隔最大時間をチェックするかどうかを指定します。

rapサーバが常設コネクションを解放するタイミングと，rapクライアントがRPCを実行するタイミングが重なった場合，RPCの実行に失敗してDCRPCER_NET_DOWNを返すことがあります。

この現象を回避するためには，rpc_rap_inquire_time_checkオペランドを指定します。

ユーザサービス定義やユーザサービスデフォルト定義への指定によって，rpc_rap_inquire_time_checkオペランドがYとなる場合は問い合わせ間隔最大時間に0以外を指定してください。

Y

rapクライアントで，問い合わせ間隔最大時間をチェックします。

N

rapクライアントで，問い合わせ間隔最大時間をチェックしません。

ユーザサービス定義とユーザサービスデフォルト定義の両方でrpc_rap_inquire_time_checkオペランドの指定を省略した場合は，rapクライアントでも問い合わせ間隔最大時間をチェックします。

rapクライアントで問い合わせ間隔をチェックするタイミングは，dc_rpc_call関数（サービス呼び出し処理）※2で行います。

問い合わせ間隔のチェックは次の計算式で求めた時間を使用します。この時間を超過した場合は，常設コネクションを解放して再接続しRPCを実行します。

チェック時間＝問い合わせ間隔最大時間−T

T：問い合わせ間隔最大時間の2%の値

ただし，250ミリ秒≦Ｔ≦3秒となります。

注※1

rpc_rap_auto_connect=Yの場合にオートコネクトモードとなります。rpc_rap_auto_connectオペランドはユーザサービス定義もしくはユーザサービスデフォルト定義で指定可能です。

注※2

連鎖型RPCの処理区間は対象外となります。ただし，連鎖型RPCの初回のdc_rpc_call関数は対象となります。

●stack_size_unlimited=Y|N

プロセス起動時にプロセスが使用するスタックサイズを無制限（unlimited）に設定するかどうかを指定します。

Y

プロセススタックサイズを無制限（unlimited）に設定します。

N

プロセススタックサイズを設定しません。OSに設定されているスタックサイズを使用します。

ユーザサーバプロセスでスタック領域をOSの設定値以上に使用する場合は，このオペランドにYを指定する必要があります。

OpenTP1が提供する次のサービスでは，ユーザサービスデフォルト定義に指定した定義内容が有効になります。

MQCゲートウェイサービス

リポジトリ管理サーバ

リアルタイム統計情報サービス

rapクライアントマネジャ，rapリスナー，rapサーバ

コマンド形式

次ページ以降に記述しています。

putenv形式

●環境変数名　環境変数値

　〜〈文字列〉

このサービスグループのプロセスで，指定した環境変数に値を設定します。

COBOLの動作環境をOpenTP1が起動するため，COBOL環境の設定などに使用します。UAPの実行形式プログラムごとに，任意の環境変数を与えることができます。標準Cライブラリ'putenv'を参照してください。

ここで，PATHを設定するとプロセスサービス定義のprcsvpathオペランドおよび運用コマンドprcpathの指定は，このサービスグループに限り無効になり，PATHの値となります。PATHを設定する場合は，このサービスグループのロードモジュールが置かれているディレクトリも含めて設定してください。

なお，OpenTP1では，'dc'で始まる環境変数名は使用しないでください。

●DCFPL_CONNECT_RETRY_COUNT　コネクション確立処理をリトライする回数

　〜〈符号なし整数〉((8〜2147483647))

リモートAPI機能使用時の通信制御部のコネクション確立処理で，ECONNREFUSEDエラーが発生した場合，コネクション確立処理をリトライする回数を指定します。

このオペランドに8以上の値を指定し，通信制御部のコネクション確立処理でECONNREFUSEDエラーが発生した場合，DCFPL_CONNECT_RETRY_INTERVALオペランドに指定した時間を待ったあと，コネクション確立処理をリトライします。

なお，このオペランドの指定を省略した場合，または，8より小さい値を指定した場合は，8を仮定します。

●DCFPL_CONNECT_RETRY_INTERVAL　コネクション確立処理のリトライ間隔

　〜〈符号なし整数〉((10〜999))（単位：ミリ秒）

リモートAPI機能使用時の通信制御部のコネクション確立処理で，ECONNREFUSEDエラーが発生した場合，コネクション確立処理のリトライ間隔をミリ秒単位で指定します。

なお，このオペランドの指定を省略した場合，または，10〜999の範囲外の値を指定した場合は，100を仮定します。

●XAT_CONNECT_RESP_TIME　通信イベント処理用SPPのアソシエーション確立の最大応答待ち時間

　〜〈符号なし整数〉((0〜65535))（単位：秒）

プロトコルにOSI TPを使用する通信で，通信イベント処理用SPP内のアソシエーション確立要求（dc_xat_connect関数）の最大応答待ち時間を指定します。0を指定した場合は，応答を無限に待ちます。

set形式のxat_connect_resp_timeオペランドでも同じ内容を指定できます。このオペランドとset形式のxat_connect_resp_timeオペランドの関係については，表3-21を参照してください。

dcputenv形式

●環境変数名　環境変数値

　〜〈文字列〉

このサービスグループのプロセスで，指定した環境変数に値を設定します。さらに，値に環境変数名を指定した場合，この環境変数の値も取得します。

なお，OpenTP1では，'dc'で始まる環境変数名は使用しないでください。

trnrmid

名称

リソースマネジャ拡張子の指定

形式

〔trnrmid  -n  リソースマネジャ名
           -i  リソースマネジャ拡張子〔,リソースマネジャ拡張子〕…
         〔-k〕〕

機能

一つのリソースマネジャに対して，複数のリソースマネジャ拡張子を割り当てて，複数の制御単位としてアクセスする場合（トランザクションサービス定義の該当するリソースマネジャに対するtrnstring定義コマンドで-iオプションを指定した場合），該当するユーザサーバからアクセスするリソースマネジャの拡張子を定義します。

トランザクションサービス定義のtrnstring定義コマンドで-iオプションを指定した場合，OpenTP1は該当するリソースマネジャ名を「リソースマネジャ名＋リソースマネジャ拡張子」に修飾して管理します。そのため，リソースマネジャ名だけでのアクセスはできません。必ずこのコマンドを定義してください。

OpenTP1のトランザクションサービスでは，X/OpenのXAインタフェースでリソースマネジャと連携してトランザクションを実行します。XAインタフェースではリソースマネジャが規定したxa_open関数用，xa_close関数用文字列を通知しなければなりません。

ユーザサーバが，OpenTP1下のトランザクション内でリソースマネジャをアクセスする場合（トランザクション制御用オブジェクトをユーザサーバにリンケージした場合），そのリソースマネジャのxa_open関数用文字列，およびxa_close関数用文字列を指定する必要があります。xa_open関数，xa_close関数は，トランザクションサービス定義のtrnstring定義コマンドで指定された該当するリソースマネジャ拡張子の文字列を引数として，ユーザサーバ起動・終了時，およびトランザクション回復処理時にOpenTP1のトランザクションサービスが発行します。

-iオプションに指定するリソースマネジャ拡張子は，トランザクションサービス定義で指定した拡張子と同一の拡張子を指定してください。

一つのリソースマネジャに対して，複数のリソースマネジャ拡張子を割り当てて，複数の制御単位としてアクセスする必要がない場合（トランザクションサービス定義の該当するリソースマネジャに対するtrnstring定義コマンドで，-iオプションを省略した場合）は，このコマンドを定義する必要はありません。

一つの定義ファイル内に同一リソースマネジャ名で，同一リソースマネジャ拡張子のtrnrmid定義コマンドを複数指定した場合，最後に指定した定義が有効となります。

この定義は，OpenTP1が提供するリソースの場合，OpenTP1_MCFだけ指定してください。

オプション

●-n　リソースマネジャ名

　〜〈1〜31文字の識別子〉

このユーザサーバがアクセスするリソースマネジャ名（トランザクションサービス定義のtrnstring定義コマンドで指定したリソースマネジャ名）を指定します。OpenTP1が提供するリソースの場合，OpenTP1_MCFだけ指定が必要です。ただし，OpenTP1_MCFでも次の場合には指定を省略できます。

MCFマネジャ環境定義mcfmenvのidオペランドを省略した場合，またはAを指定した場合

●-i　リソースマネジャ拡張子

　〜〈1〜2文字の識別子〉

このユーザサーバがアクセスするリソースマネジャ拡張子（トランザクションサービス定義のtrnstring定義コマンドで指定したリソースマネジャ拡張子）を指定します。

複数の拡張子を指定する場合は，拡張子と拡張子の間をコンマ（，）で区切ります。

トランザクションに関係するMCFを管理するために，MCFに対してのリソースマネジャ拡張子を指定しなければなりません。このオプションに指定するMCFのリソースマネジャ拡張子は，該当するユーザサーバがアクセスできるMCFのトランザクションサービス定義で指定したMCFのリソースマネジャ拡張子と同じ拡張子を指定してください。

●-k

-nオプションと-iオプションで指定したリソースマネジャ（リソースマネジャ名＋リソースマネジャ拡張子）をリソースマネジャ接続先選択機能の対象とする場合に指定します。

このオプションを指定した場合は，トランザクションを開始する前にdc_trn_rm_select関数を使用して接続対象となるリソースマネジャ（リソースマネジャ名＋リソースマネジャ拡張子）を決定してください。dc_trn_rm_select関数で接続対象のリソースマネジャを決定しないままトランザクションを開始すると，このオプションを指定したリソースマネジャへの接続はできません。

このオプションはSUPまたはSPPにだけ指定できます。MHPでは指定できません。MHPに指定した場合は，該当するリソースマネジャに接続できなくなるため，注意してください。また，このオプションはOpenTP1が提供するリソースには指定できません。指定した場合の動作は保証できません。

一つのユーザサーバの同一リソースマネジャでは，-kオプションの指定の有無を混在させないでください。

注意事項

ユーザサービス定義とユーザサービスデフォルト定義の両方で，trnrmid定義コマンドに-iオプションを指定する場合は注意してください。例えば，次のように指定した場合，ユーザサービス定義とユーザサービスデフォルト定義の両方の指定が有効となります。

ユーザサービス定義の指定：trnrmid -n RM名称 -i s1

ユーザサービスデフォルト定義の指定：trnrmid -n RM名称 -i s2

scdbufgrp

名称

スケジュールバッファグループの指定

形式

scdbufgrp  -g  スケジュールバッファグループ名
        {〔-s  メッセージ格納バッファ使用制限サイズ〕｜
         〔-p  メッセージ格納バッファ使用制限率〕}

機能

メッセージ格納バッファプールを共用するユーザサーバの集合をスケジュールバッファグループといいます。ユーザサーバは，スケジュールバッファグループごとにメッセージ格納バッファプールを共用します。

ユーザサービス定義では，このユーザサーバを所属させるスケジュールバッファグループを指定します。

また，このユーザサーバがメッセージ格納バッファプール内で使用するバッファサイズの上限を設定できます。

なお，ソケット受信型のユーザサーバでは，このコマンドを指定しても無視されます。また，キュー受信型のユーザサーバでは，ユーザサービス定義のmessage_store_buflenオペランド，およびmessage_cell_sizeオペランドを指定しても無視されます。

オプション

●-g　スケジュールバッファグループ名

　〜〈1〜8文字の識別子〉

このユーザサーバを所属させる，スケジュールバッファグループの名称を指定します。

スケジュールバッファグループ名は，スケジュールサービス定義のscdbufgrp定義コマンドで指定した名称を指定してください。

●-s　メッセージ格納バッファ使用制限サイズ

　〜〈符号なし整数〉((512〜1610612736))（単位：バイト）

このユーザサーバが使用するメッセージ格納バッファの使用制限サイズを指定します。-pオプションとは同時に指定できません。MHPの場合，この指定は無視されます。

この指定値を超えてメッセージをメッセージ格納バッファに格納しようとした場合，dc_rpc_call関数はDCRPCER_NO_BUFS（バッファ不足）でエラーリターンします。

スケジュールバッファグループのメッセージ格納バッファサイズを超過した値は指定しないでください。超過した値を指定した場合，または指定可能範囲外の値を指定した場合，ユーザサービス起動時にエラーとなります。

スケジュールバッファグループに属するユーザサーバの，メッセージ格納バッファ使用制限サイズの総計が，スケジュールバッファグループのメッセージ格納バッファサイズを超えても問題ありません。

このオペランドの指定値には，スケジュールサービス定義のscdbufgrp定義コマンドの-lオプションで指定するメッセージ格納バッファセル長（省略時は512バイト）の整数倍となる値を指定します。指定した値が-lオプションでの指定値の整数倍でない場合は，-lオプションでの指定値の整数倍に切り下げた値が仮定されます。切り下げた結果，値が0になった場合はユーザサーバの起動を中止します。

-s オプションで定義エラーが発生した場合，KFCA00830-Eメッセージを出力し，ユーザサーバの起動を中止します。

●-p　メッセージ格納バッファ使用制限率

　〜〈符号なし整数〉((1〜100))（単位：％）

このユーザサーバが使用するメッセージ格納バッファ使用制限率を指定します。このユーザサーバが所属する，スケジュールバッファグループのメッセージ格納バッファプール全体のサイズのうち，何％まで使用できるかを指定します。

-sオプションとは同時に指定できません。MHPの場合，この指定は無視されます。

この指定値を超えてメッセージをメッセージ格納バッファに格納しようとした場合，dc_rpc_call関数はDCRPCER_NO_BUFS（バッファ不足）でエラーリターンします。

指定範囲外の値を指定した場合，ユーザサービス起動時にエラーとなります。

このオペランドの指定値により計算されたメッセージ格納バッファ使用制限サイズの値が，所属するスケジュールバッファグループのメッセージ格納バッファセル長の整数倍でない場合は，メッセージ格納バッファ使用制限サイズは整数倍に切り下げた値になります。切り下げた結果，値が0になった場合はユーザサーバの起動を中止します。

-pオプションで定義エラーが発生した場合，KFCA00830-Eメッセージを出力し，ユーザサーバの起動を中止します。

注意事項

-ｓオプションおよび-ｐオプションの指定値によって，メッセージ格納バッファにサービス要求が登録できない場合には，KFCA00879-Wの警告メッセージを出力してほかのTP1ノードへの再スケジュールを試みます。再スケジュール先が存在しない場合は，RPC発行元にDCRPCER_NO_BUFS(-304)がリターンされます。

ユーザサービスデフォルト定義にscdbufgrp定義コマンドを指定した場合，すべてのユーザサービス定義のmessage_store_buflenオペランドの指定値（メッセージ格納バッファプール長）が無視されます。

ユーザサービス定義のmessage_store_buflenオペランドとユーザサービスデフォルト定義の指定とメッセージ格納バッファプール長の関係を次に示します。

表3‒23　ユーザサービス定義のmessage_store_buflenオペランドとユーザサービスデフォルト定義の指定とメッセージ格納バッファプール長の関係

ユーザサービス定義

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

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

message_store_buflen

scdbufgrp

message_store_buflen

scdbufgrp

○

−

○

−

ユーザサービス定義のmessage_store_buflenオペランドの指定値

−

○

ユーザサービスデフォルト定義に指定した，scdbufgrp定義コマンドの共用バッファグループのメッセージ格納バッファプール長

−

○

○

−

ユーザサービス定義に指定した，scdbufgrp定義コマンドの共用バッファグループのメッセージ格納バッファプール長

−

○

−

−

−

−

ユーザサービス定義のmessage_store_buflenオペランドのデフォルト値

（凡例）

○：指定あり

−：指定なし

scdmulti

名称

マルチスケジューラ機能の指定

形式

scdmulti  〔-g  マルチスケジューラグループ名〕

機能

マルチスケジューラ機能を使用するOpenTP1システムで，該当するユーザサーバが使用するマルチスケジューラに関する情報を指定します。

マルチスケジューラ機能を使用する場合，この定義コマンドとともに次の定義コマンドおよびオペランドを指定する必要があります。

RPC受信側：スケジュールサービス定義のscdmulti定義コマンド

RPC送信側：ユーザサービス定義のmulti_scheduleオペランド

オプション

●-g　マルチスケジューラグループ名

　〜〈1〜8文字の識別子〉《scdmltgp》

該当するユーザサーバが使用するマルチスケジューラグループの名称を指定します。

スケジュールサービス定義のscdmulti定義コマンドの-gオプションに指定したマルチスケジューラグループ名を指定します。指定された名称がスケジュールサービス定義のscdmulti定義コマンドの-gオプションで指定されていない場合は，ユーザサーバの起動を中止します。

このオプションを省略した場合，およびユーザサービスデフォルト定義のscdmulti定義コマンドの-gオプションの指定を省略した場合，"scdmltgp"が指定されたものとします。したがって，"scdmltgp"はマルチスケジューラグループ名として使用しないでください。

注意事項

TP1/Clientからマルチスケジューラ機能を使用してサービスを要求する場合については，マニュアル「OpenTP1 クライアント使用の手引」を参照してください。

この定義コマンドの使用は，TP1/Extension 1をインストールしていることが前提です。TP1/Extension 1をインストールしていない場合の動作は保証できませんので，ご了承ください。

scdsvcdef

名称

サービス単位にスケジュールサービスの動作を指定

形式

〔scdsvcdef 〔-c  サービス名〕
            〔-p  同時実行可能なサービス数〕
            〔-n  キューイング可能なサービス要求数〕
            〔-l  キューイング可能なメッセージ格納バッファプール長〕〕

機能

SPPがスケジュールキューにサービス要求を登録，または取り出す場合の動作をサービス単位に指定できます。

SPPのソケット受信型サーバ，SUP，およびMHPの場合は指定する必要はありません。指定しても無視されます。

オプション

●-c　サービス名

　〜〈1〜31文字の識別子〉

サービス単位での動作を指定するサービス名称を指定します。

ユーザサービス定義のserviceオペランドに指定したサービス名を指定してください。serviceオペランドに指定されていないサービス名を指定した場合は，サービス単位のスケジュール制御は行いません。

このオプションを省略した場合は，すべてのサービスに対してサービス単位での動作を指定します。なお，サービス名称を指定した定義オペランドと重複して指定された場合は，サービス名称を指定した定義オペランドが優先されます。このオプションで指定したサービス名称が重複している場合は，最後に指定された定義オペランドが優先されます。

●-p　同時実行可能なサービス数

　〜〈符号なし整数〉((1〜1024))

-cオプションで指定したサービス名に対するサービス要求について，同時実行可能なサービス数の上限値を指定します。

このオプションは，SPPの最大プロセス数（ユーザサービス定義のparallel_countオペランドまたはscdchprcコマンドで指定）よりも小さい値の場合に有効になります。このオプションを省略した場合，同時実行可能なサービス数の上限値はチェックしません。

●-n　キューイング可能なサービス要求数

　〜〈符号なし整数〉((1〜65535))

-cオプションで指定したサービス名に対するサービス要求について，スケジュールキューにキューイング可能なサービス要求数を指定します。

このオプションは，SPPのメッセージ格納バッファプールにキューイング可能なサービス要求数よりも小さい値の場合に有効になります。このオプションを省略した場合，キューイング可能なサービス要求数はチェックしません。

●-l　キューイング可能なメッセージ格納バッファプール長

　〜〈符号なし整数〉((512〜31457280))（単位：バイト）

-cオプションで指定したサービス名に対するサービス要求について，スケジュールキューにキューイング可能なメッセージ格納バッファプール長を指定します。

このオプションは，SPPのメッセージ格納バッファプール長（ユーザサービス定義のmessage_store_buflenオペランドまたはscdbufgrp定義コマンドで指定）よりも小さい値の場合に有効になります。このオプションを省略した場合，キューイング可能なメッセージ格納バッファプール長はチェックしません。

注意事項

-nオプションおよび-lオプションの指定値によって，スケジュールキューにサービス要求が登録できない場合には，KFCA00831-Wのエラーメッセージを出力してほかのTP1ノードへの再スケジュールを試みます。再スケジュール先が存在しない場合は，RPC発行元にDCRPCER_NO_BUFS(-304)がリターンされます。

ユーザサービス定義の指定値とUAPとの関係

ユーザサービス定義の指定値とSPP，SUP，およびMHPとの関係を次の表に示します。

表3‒24　ユーザサービス定義の指定値とSPP，SUP，およびMHPとの関係

オペランド

SPP

SUP

MHP

service_group

○

×

○

module

○

○

○

service

○

×

○

nice

○

○

○

parallel_count

○※1

×

○

hold

○※1

×

×

hold_recovery

○※1

×

×

deadlock_priority

○

○

○

schedule_priority

○※1

×

○

message_buflen

○※1

×

○

message_store_buflen

○※1

×

○

trn_expiration_time

○

○

○

trn_expiration_time_suspend

○

○

○

watch_next_chain_time

○

○

○

atomic_update

○

○

Y

receive_from

queue

none

queue

uap_trace_max

○

○

○

uap_trace_file_put

○

○

○

term_watch_time

○※2

○※3

○

mcf_jnl_buff_size

○※4

×

○

type

other

×

MHP

balance_count

○※1

×

○

uid

○

○

○

auto_restart

×※5

○

×

critical

○

○

○

lck_wait_priority

○

○

○

mcf_psv_id

○※6

×

×

trn_cpu_time

○

○

○

service_hold

○※1

×

×

service_priority_control

○※1

×

×

message_cell_size

○※1

×

×

max_socket_msg

×※5

×

×

max_socket_msglen

×※5

×

×

trf_put

○

○

○

mcf_mgrid

○※6

×

×

mcf_service_max_count

○※4

×

○

trn_statistics_item

○

○

○

node_down_restart

○

○

○

rpc_response_statistics

○

○

○

server_type

○

×

×

trn_rm_open_close_scope

○

○

○

trn_optimum_item

○

○

○

purge_msgget

○※7

×

○※7

cancel_normal_terminate

○

○

○

prc_abort_signal

○

○

○

rpc_service_retry_count

○

×

×

rpc_extend_function

○

○

○

max_socket_descriptors

○

○

○

max_open_fds

○

○

○

service_term_watch_time

○※1

×

×

termed_after_service

○※1

×

○

xat_trn_expiration_time

○

○

×

xat_osi_usr

○

○

×

rpc_trace

○

○

○

rpc_trace_name

○

○

○

rpc_trace_size

○

○

○

trn_rollback_information_put

○

○

○

schedule_method

○※1

×

○

service_wait_time

○※1

×

○

mcf_spp_oj

○

×

×

adm_message_option

○

○

○

trn_watch_time

○

○

○

trn_limit_time

○

○

○

trn_rollback_response_receive

○

○

○

trn_partial_recovery_type

○

○

○

rpc_destination_mode

○

○

○

rpc_rap_auto_connect

○

○

○

rpc_rap_inquire_time

○

○

○

rpc_request_cancel_for_timedout

○

○

○

status_change_when_terming

○

○

○

service_expiration_time

○

×

×

multi_schedule

○

○

×

make_queue_on_starting

○※7

×

○※7

loadcheck_interval

○※1

×

×

levelup_queue_count

○※1

×

×

leveldown_queue_count

○※1

×

×

ipc_sockctl_highwater

○

○

○

ipc_sockctl_watchtime

○

○

○

ipc_conn_interval

○

○

○

ipc_send_interval

○

○

○

ipc_send_count

○

○

○

ipc_header_recv_time

○

○

○

rpc_close_after_send

○

○

○

rpc_send_retry_count

○

○

○

rpc_send_retry_interval

○

○

○

ipc_recvbuf_size

○

○

○

ipc_sendbuf_size

○

○

○

ipc_listen_sockbufset

○

○

○

polling_control_data

○

○

○

thread_yield_interval

○

○

○

groups

○

○

○

loadlevel_message

○※1

×

×

ipc_backlog_count

○

○

○

rpc_buffer_pool_max

○

○

○

schedule_delay_limit

○

×

×

schedule_delay_abort

○

×

×

rap_autoconnect_con_error_msg

○

○

×

core_shm_suppress

○

○

○

xat_connect_resp_time

○※8

×

×

scd_poolfull_check_interval

○※1

×

×

scd_poolfull_check_count

○※1

×

×

scd_pool_warning_use_rate

○※1

×

×

scd_pool_warning_interval

○※1

×

×

ipc_tcpnodelay

○

○

○

stay_watch_queue_count

○※1

×

×

stay_watch_check_rate

○※1

×

×

stay_watch_abort

○※1

×

×

stay_watch_start_interval

○※1

×

×

stay_watch_check_interval

○※1

×

×

trn_completion_limit_time

○

○

○

rap_message_id_change_level

○

○

×

log_audit_out_suppress

○

○

○

log_audit_message

○

○

○

mcf_prf_trace

○※4

×

○

scd_refresh_process

○

×

○

rap_extend_function

○

○

○

prc_coredump_filter

○

○

○

watch_time

○

○

○

putenv

○

○

○

putenv DCFPL_CONNECT_RETRY_COUNT

○

○

×

putenv DCFPL_CONNECT_RETRY_INTERVAL

○

○

×

XAT_CONNECT_RESP_TIME

○※8

×

×

dcputenv

○

○

○

trnrmid

○※9

○※9

○

scdbufgrp

○※10

×

○

scdmulti

○

×

×

scdsvcdef

○※1

×

×

（凡例）

○：指定できます。

×：指定する必要はありません。

Y：Yを指定します。

queue：queueを指定します。

none：noneを指定します。

other：otherを指定します。

MHP：MHPを指定します。

注※1

SPPのソケット受信型サーバでは，指定する必要はありません。

注※2

holdオペランドにNを指定した場合だけ有効です。

SPPのソケット受信型サーバでは，holdオペランドの指定には関係なく，auto_restartオペランドにYを指定した場合だけ有効です。

注※3

auto_restartオペランドにYを指定した場合だけ有効です。

注※4

TP1/Message Controlの機能を使用するSPPにだけ有効です。

注※5

SPPのソケット受信型サーバでは，指定できます。

注※6

アプリケーション起動機能を使用するSPPにだけ有効です。

注※7

parallel_countオペランドの常駐プロセス数に0を指定した場合だけ有効です。

注※8

通信イベント処理用SPPにだけ有効です。

注※9

-kオプションはSUPまたはSPPにだけ有効です。

注※10

-sオプション，および-pオプションはSPPにだけ有効です。

4　ネットワークコミュニケーション定義の概要

ネットワークコミュニケーション定義の概要と定義の種類について説明します。

4.1　概要

4.1.1　ネットワークコミュニケーション定義とファイル名

ネットワークコミュニケーション定義は，テキストエディタを使用して定義ソースファイルを作成し，定義ソースファイルから定義オブジェクトファイルを生成します。この定義オブジェクトファイルをOpenTP1システムに登録します。

定義オブジェクトファイルの名称は，表4-1および表4-2の形式に従って指定します。そのファイル名を，表4-1および表4-2の定義コマンドであらかじめ登録しておきます。

定義ソースファイルの詳細については，「5.　ネットワークコミュニケーション定義の詳細」を参照してください。

定義オブジェクトファイルの生成については，「4.3　定義オブジェクトファイルの生成」を参照してください。

表4‒1　ネットワークコミュニケーション定義を登録するファイル名（その1）

定義名

定義ソースファイルの数

定義オブジェクトファイル名※1

指定する定義コマンド名

（定義名）

MCFマネジャ定義

各定義につき一つ

$DCCONFPATH/_mu……※2

dcsvstart -m（システムサービス構成定義）

MCF通信構成定義

各定義につき二つ

$DCCONFPATH/_mu……※2

mcfmcname -s（MCFマネジャ定義）

MCFアプリケーション定義

各定義につき一つ

$DCCONFPATH/任意

mcftenv -a（MCF通信構成定義）

注※1

ノード内で一意となる名称を指定してください。

注※2

先頭3文字が'_mu'で始まるファイル名を指定してください。

表4‒2　ネットワークコミュニケーション定義を登録するファイル名（その2）

定義名

定義ファイル名（完全パス名）

指定する定義コマンド名（定義名）

システムサービス情報定義

$DCDIR/lib/sysconf/定義ファイル名※1

mcfmcname -s（MCFマネジャ定義）

システムサービス共通情報定義

$DCDIR/lib/sysconf/mcf※2

指定する定義コマンドはありません。

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

$DCCONFPATH/_mc

指定する定義コマンドはありません。

注※1

定義ファイル名には，システムサービス情報定義のmoduleオペランドで指定する実行形式プログラム名（先頭4文字が'mcfu'で始まる定義ファイル名）を指定してください。

注※2

標準値が定義されているファイルが，あらかじめ用意されています。必要に応じて定義値を変更してください。

4.1.2　MCFサービスと定義との関係

MCFサービスを構成するプロセスを次に示します。

MCFマネジャプロセス：

MCF通信プロセスとアプリケーション起動プロセスを管理します。

OpenTP1ノードで一つだけ起動するプロセスです。

MCF通信プロセス：

MCF通信のために必要なプロセスで，プロトコルに依存するメッセージを制御します。

プロトコルごとに1プロセス必要です。一つのプロトコルに対して複数起動することもできます。

アプリケーション起動プロセス：

次の場合に必要なプロセスです。システム構成に応じて複数起動することもできます。

アプリケーション起動機能を使用する場合

エラーイベント処理用MHPを起動する場合

リトライ指示のロールバック要求をする場合

MCF通信プロセスまたはアプリケーション起動プロセスのうち少なくともどちらか一つを起動する必要があります。

ネットワークコミュニケーション定義とMCFサービスのプロセスの関係を次に示します。

MCFマネジャ定義：

OpenTP1ノードに一つ作成します。

MCFマネジャ定義のオブジェクトファイル名は，システムサービス構成定義のdcsvstart -mに指定します。

MCF通信構成定義：

MCF通信プロセスおよびアプリケーション起動プロセスそれぞれで，プロセスごとに作成します。

MCF通信構成定義のオブジェクトファイル名は，MCFマネジャ定義のmcfmcname -sに指定します。

MCFアプリケーション定義：

MCF通信プロセスおよびアプリケーション起動プロセスそれぞれで，プロセスごとに作成します。

なお，MCF通信プロセス，アプリケーション起動プロセスの任意の組み合わせで共通して作成することもできます。

各プロセスで使用するMCFアプリケーション定義のオブジェクトファイル名は，それぞれのMCF通信構成定義のmcftenv -aに指定します。

各ネットワークコミュニケーション定義とその出力オブジェクトファイル名を次の表に示します。

表4‒3　各ネットワークコミュニケーション定義とその出力オブジェクトファイル名

定義名

出力オブジェクトファイル名

MCFマネジャ定義

MCFサービス名

MCF通信構成定義

MCF通信サービス名

アプリケーション起動サービス名

4.1.3　MCFの運用形態と定義との関係

MCFアプリケーション定義は，次のどちらかの方法で作成してください。

アプリケーションを一元的に管理したい場合

MCFアプリケーション定義ファイルを共通のファイルとするために，MCFアプリケーション定義と各MCF通信構成定義を1対n（nは2以上の整数）の関係（図4-1の上図）で定義します。

アプリケーションをプロセスごとに分けて管理したい場合

MCFアプリケーション定義と各MCF通信構成定義を1対1の関係（図4-1の下図）で定義します。

なお，アプリケーション起動機能を使用するシステムでは，MCF通信プロセスのMCFアプリケーション定義に次のアプリケーションを指定してください。

MCF通信プロセス自身が起動するアプリケーション

上記1.がアプリケーション起動機能で起動するアプリケーション

例：

アプリケーション起動プロセス識別子：a1のMCFアプリケーション定義

−定義内容−

アプリケーション属性定義：App1

アプリケーション属性定義：App2

　　：

MCF通信プロセスのMCFアプリケーション定義

−定義内容−

アプリケーション環境定義：a1 … アプリケーション起動プロセス識別子

アプリケーション属性定義：App3 … MCF通信プロセス自身が起動するアプリケーション

アプリケーション属性定義：App1 … App3がアプリケーション起動機能で起動するアプリケーション

図4‒1　MCFの運用形態と定義ファイルとの関係

4.1.4　ネットワークコミュニケーション定義とシステムサービス定義との関連

(1)　システム環境定義

全MCFプロセスで使用する共用メモリの大きさを算出し，システム環境定義であらかじめ指定しておきます。

(2)　メッセージキューサービス定義

MCFの入出力キュー定義コマンドのキューグループIDは，メッセージキューサービス定義のキューグループIDと同じ指定をします。

(3)　ユーザサービス定義

MCFのアプリケーション属性定義コマンドのサービスグループ名およびサービス名は，ユーザサービス定義のサービスグループ名およびサービス名と同じ指定をします。

(4)　システムサービス構成定義

MCFサービス名は，OpenTP1が管理するMCF識別名です。

MCFサービス名は，MCF定義オブジェクト生成ユティリティ（mcfmngr）で生成するMCFマネジャ定義の出力オブジェクトファイル名です。

システムサービス構成定義のMCFサービス名にこの名称を指定します。

(5)　ネームサービス定義

ネームサービスに登録できるサービス数を，論理端末数，UAP数などを考慮して，ネームサービス定義であらかじめ指定しておきます。

4.1.5　アプリケーション名とサービス名との関係

MCFは，入力メッセージに入っているアプリケーション名を基に，MCFアプリケーション定義で指定した「サービスグループ名＋サービス名」への変換を行います。

アプリケーション名は，業務を識別するコードに相当します。

サービスグループ名は，同系統の仕事の単位（サービス）をまとめたものです。

サービス名は，UAPの入り口点名です。

アプリケーション名は，ノード内で一意となる名称を指定します。

一つのアプリケーション名に対して，複数のサービス名を指定できません。逆に，一つのサービス名に対して，複数のアプリケーション名を指定できます。

4.1.6　ネットワークコミュニケーション定義のコマンド

ネットワークコミュニケーション定義のコマンド一覧と指定数を，次の表に示します。

表4‒4　ネットワークコミュニケーション定義のコマンド一覧と指定数

定義名

コマンド名

指定数

MCFマネジャ定義

mcfmenv（MCFマネジャ環境定義）

1

mcfmcomn（MCFマネジャ共通定義）

1

mcfmcname（通信サービス定義）

1〜239

mcfmuap（UAP共通定義）

1

mcfmqgid（入出力キュー定義）

0〜4096

mcfmexp（拡張予約定義）

1または0※1

mcfmsts（状態引き継ぎ定義）

0〜1

mcfmsmsg（ログメッセージ出力抑止定義）

0〜1

mcfmsvg（サービスグループ属性定義）

0〜8192

MCF通信構成定義

共通定義

mcftenv（MCF環境定義）

1

mcftcomn（MCF通信構成共通定義）

1

mcfttred（最大処理多重度定義）

0〜1

mcfttim（タイマ定義）

0〜1

mcfttrc（トレース環境定義）

1

mcftsts（状態引き継ぎ定義）

0〜1

mcftbuf（バッファグループ定義）

1〜512または0※2

プロトコル固有定義

省略※3

省略※3

アプリケーション起動定義

mcftpsvr（アプリケーション起動環境定義の開始）

1

mcftalcle（アプリケーション起動用論理端末定義）

0〜2048

mcftped（アプリケーション起動環境定義の終了）

1

MCFアプリケーション定義

mcfaenv（アプリケーション環境定義）

1

mcfaalcap（アプリケーション属性定義）

1〜8192

注※1

mcfmqgidの定義がある場合は1，ない場合は0になります。

注※2

MCF通信プロセスの場合は1〜512，アプリケーション起動プロセスの場合は0になります。

注※3

プロトコル固有定義については，マニュアル「OpenTP1 プロトコル」の該当するプロトコル編を参照してください。

4.2　定義の種類

4.2.1　MCFマネジャ定義の内容

MCFマネジャ定義の内容を，次の表に示します。

表4‒5　MCFマネジャ定義の内容

形式

コマンド

オプション

オペランド

定義内容

指定値

コマンド

mcfmenv

-m

id

MCFマネジャプロセス識別子

〈英字〉

((A〜Z，a〜z))《A》

name

MCFマネジャ名

〈1〜8文字の識別子〉

mcfmcomn

-n

出力通番を使用する論理端末数

〈符号なし整数〉

((0〜2048))《0》

-p

MCF作業領域長

〈符号なし整数〉

((100〜1945599))

（単位：キロバイト）

-i

MCF作業領域を追加確保した場合に，KFCA10242-Iメッセージを出力するかどうかを指定

inc｜《msg》

-j

MCFマネジャプロセスのジャーナルバッファの大きさ

〈符号なし整数〉

((4096〜4000000の4の倍数))《4096》

（単位：バイト）

-o

cmdsvname

MCFオンラインコマンドサービス名

〈1〜8文字の英数字〉

-w

stats

MCF稼働統計情報を取得するかどうかを指定

yes｜《no》

mcfmcname

-s

mcfsvname

MCF通信サービス名

〈1〜8文字の英数字〉

syssvname

システムサービス情報定義ファイル名

〈1〜8文字の識別子〉

mcfmuap

-d

通信関数の発行回数の上限値

〈符号なし整数〉

((0〜65535))《0》

（単位：回）

-t

sndtim

同期型送信監視時間

〈符号なし整数〉

((0〜65535))《0》

（単位：秒）

sndrcvtim

同期型送受信監視時間

〈符号なし整数〉

((0〜65535))《0》

（単位：秒）

recvtim

同期型受信監視時間

〈符号なし整数〉

((0〜65535))《0》

（単位：秒）

-j

ユーザサービスのジャーナルバッファの大きさ

〈符号なし整数〉

((4096〜4000000の4の倍数))《32768》

（単位：バイト）

-e

segsize

エラーイベント処理用MHP起動時，またはアプリケーション起動機能使用時の最大セグメント長

〈符号なし整数〉

((512〜2147483647))《32768》

（単位：バイト）

-l

initseq

出力通番の初期値

〈符号なし整数〉

((0〜2147483647))《1》

maxseq

ラップ時の出力通番の最大値

〈符号なし整数〉

((0〜2147483647))《65535》

minseq

ラップ後の出力通番の開始値

〈符号なし整数〉

((0〜1))《1》

-u

ntmetim

非トランザクションMHP限界経過時間

〈符号なし整数〉

((0〜65535))《0》

（単位：秒）

-a

delaytim

アプリケーション起動時の遅延許容時間

〈符号なし整数〉

((0〜360))《0》

（単位：分）

-c

order

メッセージ送信順序および再送順序ならびにアプリケーション起動順序の選択

function｜《commit》

noansreply

非応答型のMHPからの問い合わせ応答をするかどうかを指定

《yes》｜no

commitdml

データ操作言語のCOMMIT文を使用するかどうかを指定

yes｜《no》

otqinhold

出力キューの入力保留中の動作を指定

《commit》｜function

errevt_recovery

OpenTP1再開始時のエラーイベントを引き継ぐかどうかを指定

《yes》｜no

itqretryorder

MHPの再スケジュール時に受信メッセージを入力キューに格納する位置

first｜《last》

-r

reschedulecnt

アプリケーション異常終了時の再スケジュール回数

〈符号なし整数〉

((0〜3))《0》

（単位：回）

rescheduleint

アプリケーション異常終了時の再スケジュール間隔

〈符号なし整数〉

((0〜3))《0》

（単位：秒）

reschedulelog

異常終了したアプリケーションを再スケジュールするときに，ログメッセージを出力するかどうかを指定

yes｜《no》

mcfmqgid

-q

quekind

キュー種別

itq｜otq

quegrpid

キューグループID

〈1〜8文字の識別子〉

mcfmexp

-g

サービスグループの登録数

〈符号なし整数〉

((1〜8192))

-l

論理端末の登録数

〈符号なし整数〉

((1〜16380))

-i

入力用ディスクキューが使用できないときに縮退運転するかどうかを指定

dg｜《ndg》

-o

出力用ディスクキューが使用できないときに縮退運転するかどうかを指定

dg｜《ndg》

mcfmsts

-g

サービスグループ数上限値

〈符号なし整数〉

((1〜8192))

-v

サービス数上限値

〈符号なし整数〉

((1〜1044480))

mcfmsmsg

-m

ログファイルへの出力を抑止するメッセージID

〈符号なし整数〉

((10000〜19999，28000〜29999))

mcfmsvg

-g

servgrpn

サービスグループ名

〈1〜31文字の識別子〉

-w

watchcnt

入力キューの滞留監視数

〈符号なし整数〉

((0〜65535))《0》

watchint

入力キューの滞留監視インタバル時間

〈符号なし整数〉

((5〜3600))《10》

（単位：秒）

expectcnt

MHPに期待するサービス要求の処理数

〈符号なし整数〉

((1〜65535))

abort

MHPの処理能力不足時のOpenTP1システムのダウン可否

yes｜《no》

4.2.2　MCF通信構成定義の内容

MCF通信構成定義の内容を，次の表に示します。

表4‒6　MCF通信構成定義の内容

形式

コマンド

オプション

オペランド

定義内容

指定値

コマンド

mcftenv

-s

MCF通信プロセス識別子，またはアプリケーション起動プロセス識別子

〈数字（0〜9），a〜f〉

((01〜ef))

-m

MCFマネジャ識別子

〈英字〉

((A〜Z，a〜z))《A》

-a

MCFアプリケーション定義オブジェクトファイル名

〈1〜8文字の英数字〉

-q

diskitq

入力キューにディスクキューを使用するかどうかを指定

《yes》｜no

mcftcomn

-j

MCF通信プロセス，またはアプリケーション起動プロセスのジャーナルバッファの大きさ

〈符号なし整数〉

((4096〜4000000の4の倍数))《32768》

（単位：バイト）

mcfttred

-m

最大処理多重度

〈符号なし整数〉

((1〜1000))《10》

mcfttim

-t

btim

時間監視間隔

〈符号なし整数〉

((1〜60))《1》

（単位：秒）

mtim

未処理送信メッセージ滞留時間

〈符号なし整数〉

((60〜65535))《180》

（単位：秒）

rmtim

未処理受信メッセージ滞留時間

〈符号なし整数〉

((0〜65535))《0》

（単位：秒）

-p

usertime

ユーザタイマ監視機能を使用するかどうかを指定

yes｜《no》

timereqno

最大タイマ監視要求数

〈符号なし整数〉

((1〜10000))《16》

msgsize

最大メッセージ長

〈符号なし整数〉

((0〜256))《0》

（単位：バイト）

msgout

メッセージを出力するかどうかを指定

yes｜《no》

mcfttrc

-t

size

MCFトレースバッファの大きさ

〈符号なし整数〉

((4096〜15728640の4の倍数))《204800》

（単位：バイト）

disk

MCFトレースディスク出力機能を使用するかどうかを指定

《yes》｜no

bufcnt

MCFトレースバッファの数

〈符号なし整数〉

((10〜2147483647))《100》

trccnt

MCFトレースファイルの数

〈符号なし整数〉

((3〜99))《3》

msgsize

トレースとして取得する送受信メッセージの最大サイズ

〈符号なし整数〉

((0〜1073741824))《128》

（単位：バイト）

-m

MCFトレースファイルの数を超えたときの処置

《del》｜off

mcftsts

-a

アプリケーション数上限値

〈符号なし整数〉

((1〜8192))

-l

論理端末数上限値

〈符号なし整数〉

((1〜2048))

mcftbuf

-g

groupno

メッセージ送受信用，およびメッセージ編集用バッファグループ番号

〈符号なし整数〉

((1〜512))

length

メッセージ送受信用，およびメッセージ編集用バッファ長

〈符号なし整数〉

((512〜1073741824))

（単位：バイト）

count

メッセージ送受信用，およびメッセージ編集用バッファ数

〈符号なし整数〉

((1〜65535))

extend

拡張するバッファ数

〈符号なし整数〉

((0〜65535))《0》

mcftpsvr

-c

内部通信路名

〈1〜8文字の識別子〉

-o

reruntm

リラン時のタイマ起動を引き継ぐかどうかを指定

yes｜《no》

mcftalcle

-l

論理端末名称

〈1〜8文字の識別子〉

-t

論理端末の端末タイプ

send｜request

-m

mmsgcnt

メモリ出力メッセージ最大格納数

〈符号なし整数〉

((0〜65535))《0》

dmsgcnt

ディスク出力メッセージ最大格納数

〈符号なし整数〉

((0〜65535))《0》

-k

quekind

出力メッセージの割り当て先

《memory》｜disk

quegrpid

キューグループID

〈1〜8文字の識別子〉

mcftped

アプリケーション起動環境定義の終了

なし

4.2.3　MCFアプリケーション定義の内容

MCFアプリケーション定義の内容を，次の表に示します。

表4‒7　MCFアプリケーション定義の内容

形式

コマンド

オプション

オペランド

定義内容

指定値

コマンド

mcfaenv

-a

MCFアプリケーション定義識別子

〈1〜8文字の識別子〉

-p

アプリケーション起動プロセス識別子

〈数字（0〜9），a〜f〉

((01〜ef))

mcfaalcap

-n

name

アプリケーション名，またはMCFイベント名

〈1〜8文字の識別子〉

kind

アプリケーション種別

《user》｜mcf

type

アプリケーションの型

ans｜《noans》｜cont

aplihold

アプリケーション異常終了時のアプリケーションの処置

《m》｜a｜s

msgcnt

入力メッセージ最大格納数

〈符号なし整数〉

((0〜65535))《0》

lname

論理端末名称

〈1〜8文字の識別子〉

cname

内部通信路名

〈1〜8文字の識別子〉

tempsize

継続問い合わせ応答用一時記憶データ格納用領域サイズ

〈符号なし整数〉

((1〜32000))《4096》

（単位：バイト）

trnmode

アプリケーションのトランザクション属性

《trn》｜nontrn

errevt

通信イベント障害時のエラーイベントを通知するかどうかを指定

yes｜《no》

-N

modelname

モデルアプリケーション名，またはモデルMCFイベント名

〈1〜8文字の識別子〉

-g

servgrpn

アプリケーション名に対応するサービスグループ名

〈1〜31文字の識別子〉

quegrpid

キューグループID

〈1〜8文字の識別子〉

quekind

入力メッセージの割り当て先

《memory》｜disk

srvghold

アプリケーション異常終了時のサービスグループの処置

《m》｜s

recvmsg

異常終了したUAPの受信メッセージの扱い

《e》｜r

-v

servname

アプリケーション名に対応するサービス名

〈1〜31文字の識別子〉

servhold

アプリケーション異常終了時のサービスの処置

《m》｜a｜s

ntmetim

非トランザクションMHP限界経過時間

〈符号なし整数〉

((0〜65535))

（単位：秒）

-d

holdlimit

アプリケーション異常終了限界回数

〈符号なし整数〉

((1〜65535))《1》

（単位：回）

holdlmtyp

アプリケーション異常終了回数のカウント方法

sum｜《cont》

reschedulecnt

アプリケーション異常終了時の再スケジュール回数

〈符号なし整数〉

((0〜3))

（単位：回）

rescheduleint

アプリケーション異常終了時の再スケジュール間隔

〈符号なし整数〉

((0〜3))

（単位：秒）

reschedulelog

異常終了したアプリケーションを再スケジュールするときに，ログメッセージを出力するかどうかを指定

yes｜no

-j

ij

他システムから受信したメッセージの入力キュー登録時に，履歴情報を取得するかどうかを指定

yes｜《no》

oj

UAPからのメッセージ送信要求時に，履歴情報を取得するかどうかを指定

yes｜《no》

gj

UAPからのメッセージ受信要求時に，履歴情報を取得するかどうかを指定

yes｜《no》

-e

evtlogout

ERREVT1〜ERREVT4を起動するとき，ログメッセージを出力するかどうかを指定

yes｜《no》

4.2.4　MCF性能検証用トレース定義の内容

MCF性能検証用トレース定義の内容を，次の表に示します。

表4‒8　MCF性能検証用トレース定義の内容

形式

オペランド

定義内容

指定値

set

prf_file_count

MCF性能検証用トレース情報ファイルの世代数

〈符号なし整数〉

((3〜256))《3》

prf_file_size

MCF性能検証用トレース情報ファイルのサイズ

〈符号なし整数〉

((1024〜1048576))《1024》

（単位：キロバイト）

prf_information_level

MCF性能検証用トレース関連のメッセージの表示レベル

1|0

4.2.5　システムサービス情報定義の内容

システムサービス情報定義の内容を，次の表に示します。

表4‒9　システムサービス情報定義の内容

形式

オペランド

定義内容

指定値

set

module

MCF通信サービスを起動するためのMCF実行形式プログラム名

〈1〜8文字の識別子〉

mcf_prf_trace

MCF通信サービスごとにMCF性能検証用トレース情報を取得するかどうかを指定

《Y》｜N

4.2.6　システムサービス共通情報定義の内容

システムサービス共通情報定義の内容を，次の表に示します。

表4‒10　システムサービス共通情報定義の内容

形式

オペランド

定義内容

指定値

set

max_socket_descriptors

ソケット用ファイル記述子の最大数

〈符号なし整数〉

((64〜3596))

max_open_fds

MCF通信プロセスでアクセスするファイルの最大数

〈符号なし整数〉

((500〜4032))《500》

thdlock_sleep_time

スレッド間で排他が競合した場合のスレッドの待ち時間

〈符号なし整数〉

((1〜32767))

（単位：ミリ秒）

mcf_prf_trace_level

MCF性能検証用トレース情報の取得レベル

((00000000〜00000001))

《00000001》

mcf_start_watch_interval

MCF開始時プロセス間監視時間間隔

〈符号なし整数〉

((10〜3000))《3000》

（単位：ミリ秒）

putenv

DCMCFQUEBAK

MCF構成変更準備停止時のバックアップファイル名

〈パス名〉

《$DCDIR/spool/mcf/mcfquebak》

4.3　定義オブジェクトファイルの生成

ネットワークコミュニケーション定義の各ソースファイルから定義オブジェクトファイルを生成する方法について説明します。

定義オブジェクトファイルの生成には，次の二つのユティリティを使用します。

MCF定義オブジェクト生成ユティリティ

MCF定義結合ユティリティ

MCF定義オブジェクト生成ユティリティは，ソースファイルからオブジェクトファイルを生成するときに使用します。MCF定義オブジェクト生成ユティリティを起動するコマンドは，定義の種類によって異なります。

MCF定義結合ユティリティは，二つのオブジェクトファイルを結合するときに使用します。MCF定義結合ユティリティは，MCF通信構成定義にだけ使用します。

MCFのバージョンアップに伴って，定義オブジェクトの形式が異なることがあります。定義オブジェクトのバージョンが異なると，開始処理が続行できません。この場合は，MCFと同じバージョンのユティリティで，定義オブジェクトを生成し直してください。

ユティリティ起動コマンドを次の表に示します。

表4‒11　定義オブジェクトファイル生成に使用するユティリティ起動コマンド

定義ソースファイル

ユティリティ起動コマンド

定義オブジェクトファイル名

MCFマネジャ定義

mcfmngr

$DCCONFPATH/_mu……

MCF通信構成定義

共通定義

mcfcomn

mcflink

$DCCONFPATH/_mu……

データコミュニケーション定義

プロトコル固有定義1

プロトコル固有定義2

　　：

　　：

　　：

mcf××××※1

mcf××××※1

　　：

　　：

　　：

一つ選択※2

アプリケーション起動定義

mcfpsvr

MCFアプリケーション定義

mcfapli

$DCCONFPATH/任意

注※1

プロトコル種別に対応したユティリティ起動コマンドがあります。コマンド名については，マニュアル「OpenTP1 プロトコル」の該当するプロトコル編を参照してください。

注※2

MCF通信サービスの通信方式によって，使用するユティリティ起動コマンドが決まります。

各定義では，次のようにオブジェクトファイルを生成します。

MCFマネジャ定義

MCF定義オブジェクト生成ユティリティ（mcfmngrコマンド）を使用します。

MCF通信構成定義

MCF定義オブジェクト生成ユティリティとMCF定義結合ユティリティを使用します。

次の手順でオブジェクトファイルを生成します。

MCF定義オブジェクト生成ユティリティを使用して，共通定義オブジェクトファイルとデータコミュニケーション定義オブジェクトファイルを，それぞれ生成します。ユティリティ起動コマンドについては，表4-11，およびマニュアル「OpenTP1 プロトコル」の該当するプロトコル編を参照してください。

MCF定義結合ユティリティ（mcflinkコマンド）を使用して，1.で生成した二つの定義オブジェクトを結合し，MCF通信構成定義のオブジェクトファイルを出力します。

MCFアプリケーション定義

MCF定義オブジェクト生成ユティリティ（mcfapliコマンド）を使用します。

なお，対応する定義ソースが不明となったMCF定義オブジェクトファイルの内容を知りたい場合は，「4.3.3　mcf××××（MCF定義オブジェクト解析コマンド）」を参照してください。

4.3.1　mcf××××（MCF定義オブジェクト生成ユティリティ起動コマンド）

(1)　形式

mcf××××  -i  〔パス名〕入力ファイル名
             -o  〔パス名〕出力ファイル名
           〔-r  ｛no｜rep｝〕

定義名

起動コマンド

MCFマネジャ定義

mcfmngr

MCF通信構成定義（共通定義）

mcfcomn

MCF通信構成定義（プロトコル固有定義）

mcf××××※

MCF通信構成定義（アプリケーション起動定義）

mcfpsvr

MCFアプリケーション定義

mcfapli

注

各定義ごとに，専用の起動コマンド（mcf××××）があります。上表の起動コマンドを使用してください。

注※

マニュアル「OpenTP1 プロトコル」の該当するプロトコル編を参照してください。

(2)　機能

定義ソースファイルを入力して，構文をチェックし，定義オブジェクトファイルを生成します。

ただし，開始から再開始の間に定義オブジェクトファイルを変更しないでください。変更した場合，再開始時に正常に動作しないことがありますのでご注意ください。

(3)　オプション

-i　〔パス名〕入力ファイル名　　〜〈パス名〉〈1〜8文字の識別子〉

定義のソースファイル名を指定します。

-o　〔パス名〕出力ファイル名　　〜〈パス名〉〈1〜8文字の英数字〉

定義のオブジェクトファイル名を指定します。

MCFマネジャ定義の場合，先頭3文字が'_mu'で始まるファイル名を指定してください。

システム定義ファイルの指定値をチェックするdcdefchkコマンドのチェック対象からMCFアプリケーション定義を外す場合は，先頭1文字が'_'で始まるファイル名を指定してください。

-r　｛no｜rep｝　　〜《no》

定義オブジェクトファイルの出力先に読み取り権限を持つファイルがすでに存在する場合，定義オブジェクトファイルを上書きするかどうかを指定します。

no：定義オブジェクトファイルを上書きしないで，KFCA10332-Eメッセージを出力します。

rep：定義オブジェクトファイルを上書きします。

4.3.2　mcflink（MCF定義結合ユティリティ起動コマンド）

(1)　形式

mcflink  -i  〔パス名〕入力ファイル名  〔パス名〕入力ファイル名
         -o  〔パス名〕出力ファイル名
       〔-r  ｛no｜rep｝〕

(2)　機能

共通定義とデータコミュニケーション定義のオブジェクトファイルを入力し，定義コマンド間の関連をチェックし，一つのオブジェクトファイルに結合します。

ただし，開始から再開始の間にオブジェクトファイルを変更しないでください。変更した場合，再開始時に正常に動作しないことがありますのでご注意ください。

(3)　オプション

-i　〔パス名〕入力ファイル名　　〔パス名〕入力ファイル名

〜〈パス名〉〈1〜8文字の英数字〉〈パス名〉〈1〜8文字の英数字〉

入力オブジェクトファイル名を指定します。次のファイルを一つずつ指定してください。どちらを先に指定してもかまいません。

共通定義のオブジェクトファイル

データコミュニケーション定義のオブジェクトファイル

-o　〔パス名〕出力ファイル名　　〜〈パス名〉〈1〜8文字の英数字〉

出力オブジェクトファイル名を指定します。先頭3文字が'_mu'で始まるファイル名を指定してください。

-r　｛no｜rep｝　　〜《no》

オブジェクトファイルの出力先に読み取り権限を持つファイルがすでに存在する場合，オブジェクトファイルを上書きするかどうかを指定します。

no：オブジェクトファイルを上書きしないで，KFCA10332-Eメッセージを出力します。

rep：オブジェクトファイルを上書きします。

4.3.3　mcf××××（MCF定義オブジェクト解析コマンド）

(1)　形式

mcf××××　-i　〔パス名〕解析対象オブジェクトファイル名

定義オブジェクト名

解析コマンド

MCFマネジャ定義オブジェクト

mcfmngrr

MCFアプリケーション定義オブジェクト

mcfaplir

MCF通信構成定義の共通定義オブジェクト（または，これとMCF通信構成定義のプロトコル固有定義オブジェクトを結合したオブジェクト）

mcfcomnr

MCFアプリケーション起動定義オブジェクト（または，これと共通定義を結合したオブジェクト）

mcfpsvrr

MCF通信構成定義のプロトコル固有定義オブジェクト（または，これとMCF通信構成定義の共通定義オブジェクトを結合したオブジェクト）

mcf××××※

注※

プロトコル製品によっては，サポートしていない場合もあります。マニュアル「OpenTP1 プロトコル」の該当するプロトコル編を参照してください。

(2)　機能

MCFの定義オブジェクトファイルであるMCFマネジャ定義オブジェクトファイル，MCFアプリケーション定義オブジェクトファイル，MCF通信構成定義の共通定義オブジェクトファイル，MCFアプリケーション起動定義オブジェクトファイル，およびMCF通信構成定義のプロトコル固有定義オブジェクトファイルの定義オブジェクトを解析し，定義ソースの形式で標準出力します。

(3)　オプション

-i　〔パス名〕解析対象オブジェクトファイル名　〜〈1〜8文字の英数字〉

定義オブジェクトが格納されているファイル名を指定します。

(4)　出力形式

定義オブジェクトの解析後の出力例を次に示します。

#############################################################
                   MCF manager definition

#############################################################
   OBJECT FILE NAME : xxxxxxxx
   VV-RR            : vv-rr
   DATE             : yyyy-mm-dd hh:mm:ss
#############################################################

 mcfmenv
   -m id         = A
   -m name       = mng01

 mcfmcomn
   -n            = 10
   -p            = 300
   -j            = 4096
  *-t delayed    = no
   -c            = 255
   -w stats      = no
  @-i            = msg
  *-d mcfdump    = yes
  *-d dumpcount  = 3
  *-d pdebug     = 00000000
   -l            = 0
  *-J pj_put     = yes
  *-J mj_select  = no
  *-J mcf_buffer = yes

 mcfmcname
   -s mcfsvname  = _muua01
   -s syssvname  = mcfu01

 mcfmcname
   -s mcfsvname  = _mups01
   -s syssvname  = mcfu02

・
・
・

######################## End Of File ########################

（凡例）

xxxxxxxx：解析する定義オブジェクトファイル名

vv-rr：解析する定義オブジェクトのバージョン・リビジョン番号

yyyy-mm-dd hh:mm:ss：解析する定義オブジェクトのファイル生成日時

(5)　解析結果

定義オブジェクト解析コマンドは，その解析結果を定義ソースの形式で出力します。しかし，それは解析結果であり記述形式は元の定義ソースの記述形式とは一致しません。定義ソースと定義オブジェクト解析結果の差異を次に示します。

項目

定義ソース

定義オブジェクト解析結果

注釈文

書き込みできる

出力しない

省略値の扱い

省略できる

限定公開部分も含めて，省略値を出力する

システム環境定義のdefault_value_optionオペランドの指定値で省略値が変更となるオペランドの場合，行の先頭に"@"を付与する

限定公開部分の表記方法

一般公開部分と差異なし

OpenTP1 Version 7での限定公開機能の行の先頭に"*"を付与する

定義コマンド名とオプションの表記方法

1行に表記できる

（例）mcfmcomn -n 10

定義コマンド名を表記後，改行する。また，オプションに"="を付記する

（例）mcfmcomn

　　　　-n = 10

1定義コマンドが複数の行にわたる場合

継続記号"￥"を付与する

（例）mcfmcomn -n 10　￥

　　　　　　　　 -p 300

継続記号は出力しない

（例）mcfmcomn

　　　　-n = 10

　　　　-p = 300

1定義オプションに複数のオペランドを指定する場合

複数のオペランドをまとめて二重引用符(")で囲む

（例）

mcfmenv -m "id=A name=mng01"

個々のオペランドに対してオプションを付記する

（例）mcfmenv

　　　-m id=A

　　　-m name = mng01

その他

なし

ファイル名などを記したタイトルが出力される

定義オブジェクト生成時の補正によって，実際の指定値とは異なる内容が出力される場合がある

定義ソースと該当コマンドのバージョンの差異によって，解析結果にサポート内容の過不足がある場合がある

(6)　注意事項

解析対象が不正であった場合の動作は保証しません。

5　ネットワークコミュニケーション定義の詳細

ネットワークコミュニケーション定義の詳細について，それぞれの定義ごとに説明します。

MCFマネジャ定義

MCFマネジャ定義は，MCFマネジャプロセスに対して，実行環境を設定するものです。定義ソースファイルを一つ作成してください。

MCFサービスで使用する通信サービスの種類によっては，通信サービス固有の環境情報を設定する必要があります。この場合，このマニュアルで記述する定義のほかに，通信サービス固有の定義を加えてください。その定義コマンドのオプションなどについては，マニュアル「OpenTP1 プロトコル」の該当するプロトコル編を参照してください。

MCFマネジャ定義コマンドの指定順序を次の図に示します。

図5‒1　MCFマネジャ定義コマンドの指定順序

mcfmenv

名称

MCFマネジャ環境定義

形式

mcfmenv  -m  "〔id=MCFマネジャプロセス識別子〕
                name=MCFマネジャ名"

機能

MCFマネジャに関する環境を定義します。

オプション

●-m

（オペランド）

id=MCFマネジャプロセス識別子　〜〈英字〉((A〜Z，a〜z))《A》

MCFマネジャ識別子を指定します。

MCFマネジャプロセス識別子とMCF通信構成定義のMCF通信プロセス識別子とを組み合わせて3文字の文字列が作成されます。この文字列が運用コマンドやMCFが出力するメッセージログなどでMCF通信プロセスを特定するためのキーとなります。

このオプションで指定したMCFマネジャプロセス識別子は，次に示すコマンドの-iオプション（リソースマネジャ拡張子）で指定してください。

トランザクションサービス定義のtrnstringコマンド

ユーザサービスデフォルト定義のtrnrmidコマンド

ユーザサービス定義のtrnrmidコマンド

name=MCFマネジャ名　〜〈1〜8文字の識別子〉

MCFマネジャ名を指定します。

MCFマネジャ名は，MCF起動時に表示されるメッセージでMCFマネジャ定義を識別するために使用します。

mcfmcomn

名称

MCFマネジャ共通定義

形式

mcfmcomn  〔-n  出力通番使用論理端末数〕
            -p  MCF作業領域長
          〔-i  inc｜msg〕
          〔-j  MCFマネジャプロセスのジャーナルバッファの大きさ〕
          〔-o  "〔cmdsvname=MCFオンラインコマンドサービス名〕"〕
          〔-w  "〔stats=yes｜no〕"〕

機能

MCFマネジャに共通する環境を定義します。

オプション

●-n　出力通番使用論理端末数

　〜〈符号なし整数〉((0〜2048))《0》

一つのMCFシステムでメッセージ出力通番を使用する論理端末の最大数を指定します。

0を指定した場合は，メッセージ出力通番を使用しません。

指定値に応じて静的共用メモリ，ステータスファイル，およびチェックポイントダンプファイルの容量を見積もる必要があります。静的共用メモリの見積もりは，「付録B.2　MCFサービス用の共用メモリの見積もり式」を参照してください。ステータスファイルの見積もりは，マニュアル「OpenTP1 運用と操作」の「ステータスファイルのサイズの見積もり式」の説明を参照してください。チェックポイントダンプファイルの見積もりは，マニュアル「OpenTP1 運用と操作」の「チェックポイントダンプファイルのサイズの見積もり式」の説明を参照してください。

●-p　MCF作業領域長

　〜〈符号なし整数〉((100〜1945599))（単位：キロバイト）

MCFプロセス間で使用する共用メモリの大きさを指定します。静的に確保されるテーブルおよびバッファプールの共用メモリの大きさを指定してください。詳細については，「付録B.2　MCFサービス用の共用メモリの見積もり式」を参照してください。

ここで設定したMCF作業領域長をシステム環境定義（$DCDIR/conf/env）のstatic_shmpool_sizeに加えてください。MCF作業領域長の設定値が足りないと，static_shmpool_sizeの値が十分でもメモリ不足が発生する場合があります。

MCF静的共用メモリが不足した場合，静的共用メモリ（システム環境定義のstatic_shmpool_sizeオペランドの指定値）の未使用領域から，このオプションで指定したサイズの1/2のサイズ分を自動的に追加確保します。メモリの自動確保は最大254回行います。それでもメモリが不足した場合は，ログメッセージとしてKFCA10230-Eを出力し，障害情報を出力します。

メモリの自動確保回数が254回以内であっても，静的共用メモリ不足を検出した場合は，ログメッセージとしてKFCA10240-Eを出力して，障害情報を出力します。メモリ追加確保時に，ログメッセージとしてKFCA10242-Iを出力するかどうかは，-iオプションで指定します。静的共用メモリ不足の発生を検知したい場合は，-iオプションにmsgを指定し，メッセージを出力するように指定してください。

●-i　inc｜msg

　〜《msg》

-pオプションで指定するMCF作業領域長の静的共用メモリが不足し，自動的に追加確保したときに，ログメッセージとしてKFCA10242-Iを出力するかどうかを指定します。

inc

静的共用メモリの追加確保時に，ログメッセージを出力しません。

msg

静的共用メモリの追加確保時に，ログメッセージとしてKFCA10242-Iを出力します。

●-j　MCFマネジャプロセスのジャーナルバッファの大きさ

　〜〈符号なし整数〉((4096〜4000000の4の倍数))《4096》（単位：バイト）

プロセス回復用のジャーナルデータを蓄えておく領域の大きさを指定します。

MCFマネジャプロセスが，ジャーナルサービスに対して次の要求を出すまで，この領域にジャーナルデータを蓄えておきます。

ジャーナルファイルへの出力要求

ジャーナルサービスのバッファへの格納要求

ジャーナルバッファの大きさには，CJのデータ長のうち最大値以上の値を指定してください。

CJ（メッセージキューサーバ）のデータ長

ITQ，OTQにディスクキューを使用した場合に取得します。

次に示す二つの計算式のうち，最大の値をデータ長としてください。

計算式1：

●32ビット版のとき

260＋（24×m）

●64ビット版のとき

↑{260＋（24×m）}／8↑×8

計算式2：

●32ビット版のとき

↑{88＋(24×(↑msg／ql↑＋↑960／ql↑))＋qio}／4↑×4

●64ビット版のとき

↑{88＋(24×(↑msg／ql↑＋↑1276／ql↑))＋qio}／8↑×8

（凡例）

↑↑：小数点以下を切り上げます。

m：次のメッセージ数のうちの最大値

保持メッセージ数（メッセージキューサービス定義のquegrp定義コマンドの-mオプションで指定した値）

すべての論理端末のうちの構成変更準備停止時の滞留メッセージ数※

すべてのサービスグループのうちの構成変更準備停止時の滞留メッセージ数※

msg：ディスクキューを使用した受信メッセージ長または送信メッセージ長

ql：キューファイル物理レコード長

qio：メッセージキューサービス定義のque_io_maxrecsizeオペランドの指定値

注※

滞留メッセージ数の最大値は，構成変更準備停止を行う直前に次のコマンドを実行することで取得できます。

論理端末の場合：-mオプションを指定したmcftlsleコマンド，またはmcfalspsvコマンド

サービスグループの場合：-mオプションを指定したmcftlssgコマンド

ユーザが指定した値によって，MCFは次の処理をします。

指定した値がMCFで定めた下限値より小さい場合，その値をMCFで定めた下限値に補正します。

指定した値がMCFで定めた上限値より大きい場合，その値をMCFで定めた上限値に補正します。

指定した値が4の倍数でない場合，その値を4の倍数になるように切り上げます。

●-o　cmdsvname=MCFオンラインコマンドサービス名

　〜〈1〜8文字の英数字〉

MCFオンラインコマンドサービス名を指定します。

ここで指定する値は，先頭が'_mcs'で始まる8文字以内の英数字を指定します。

なお，ご使用のOSがWindowsの場合，このオプションは指定できません。

●-w

(オペランド)

stats=yes｜no　〜《no》

MCF稼働統計情報を取得するかどうかを指定します。

なお，ご使用のOSがWindowsの場合，このオプションは指定できません。

yes

静的共用メモリ上にMCF稼働統計情報を取得します。

取得したMCF稼働統計情報を参照するには，mcfstatsコマンドおよびmcfreportコマンドを実行します。

no

MCF稼働統計情報を取得しません。

mcfmcname

名称

通信サービス定義

形式

{{  mcfmcname  -s  "mcfsvname=MCF通信サービス名
                    syssvname=システムサービス情報定義ファイル名"}}

機能

MCF通信サービスに関する環境を定義します。

指定数に応じて静的共用メモリ，およびステータスファイルの容量を見積もる必要があります。静的共用メモリの見積もりは，「付録B.2　MCFサービス用の共用メモリの見積もり式」を参照してください。ステータスファイルの見積もりは，マニュアル「OpenTP1 運用と操作」の「ステータスファイルのサイズの見積もり式」の説明を参照してください。

オプション

●-s

（オペランド）

mcfsvname=MCF通信サービス名　〜〈1〜8文字の英数字〉

MCF通信サービス名を指定します。

MCF通信サービス名には，先頭3文字が'_mu'で始まる名称を指定します。

このMCF通信サービス名は，MCF通信構成定義のオブジェクトファイル名です。

なお，MCF通信サービス名は，ほかのmcfmcnameコマンドで指定するMCF通信サービス名と通信プロセス単位で重複して指定できません。

syssvname=システムサービス情報定義ファイル名　〜〈1〜8文字の識別子〉

システムサービス情報定義ファイルの名称を指定します。

システムサービス情報定義ファイル名称には，先頭4文字が'mcfu'で始まる名称を指定します。

このシステムサービス情報定義ファイルは，MCF通信サービスを起動するために使用する実行形式プログラムを指定するファイルです。

mcfmuap

名称

UAP共通定義

形式

mcfmuap    〔-d  通信関数発行回数上限値〕
           〔-t  "〔sndtim=同期型送信監視時間〕
                  〔sndrcvtim=同期型送受信監視時間〕
                  〔recvtim=同期型受信監視時間〕"〕
           〔-j  ユーザサーバのジャーナルバッファの大きさ〕
           〔-e  "segsize=最大セグメント長"〕
           〔-l  "〔initseq=出力通番の初期値〕
                  〔maxseq=ラップ時の出力通番最大値〕
                  〔minseq=ラップ後の出力通番開始値〕"〕
           〔-u  "〔ntmetim=非トランザクションMHP限界経過時間〕"〕
           〔-a  "delaytim=アプリケーション起動時の遅延許容時間"〕
           〔-c  "〔order=function｜commit〕
                  〔noansreply=yes｜no〕
                  〔commitdml=yes｜no〕
                  〔otqinhold=commit｜function〕
                  〔errevt_recovery=yes｜no〕
                  〔itqretryorder=first｜last〕"〕
           〔-r  "〔reschedulecnt=アプリケーション異常終了時の
                                  再スケジュール回数〕
                  〔rescheduleint=アプリケーション異常終了時の
                                  再スケジュール間隔〕
                  〔reschedulelog=yes｜no〕"〕

機能

UAPに共通する環境を定義します。

オプション

●-d　通信関数発行回数上限値

　〜〈符号なし整数〉((0〜65535))《0》（単位：回）

MHPの暴走を防止するために，MHPが発行するMCF通信関数※の発行回数上限値を指定します。

対象となる関数は，サービス関数の開始から終了までの間に該当プロセスで発行するMCF通信関数です。

指定回数を超えてMCF通信関数を発行した場合，該当プロセスを異常終了させます。

0を指定した場合は，MCF通信関数の発行回数に制限はありません。

指定値が有効となる優先順位は次のとおりです（1.＞2.＞3.）。

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

ユーザサービスデフォルト定義のmcf_service_max_countオペランド

MCFマネジャ定義のmcfmuap定義コマンドの-dオプション

注※

対象となる関数は次のとおりです。これらの関数に対応したDMLインタフェースについては，マニュアル「OpenTP1 プログラム作成リファレンス COBOL言語編」を参照してください。

dc_mcf_commit関数　【CBLDCMCF('COMMIT ')】

dc_mcf_contend関数　【CBLDCMCF('CONTEND ')】

dc_mcf_execap関数　【CBLDCMCF('EXECAP ')】

dc_mcf_receive関数　【CBLDCMCF('RECEIVE ')】

dc_mcf_recvsync関数　【CBLDCMCF('RECVSYNC')】

dc_mcf_reply関数　【CBLDCMCF('REPLY ')】

dc_mcf_resend関数　【CBLDCMCF('RESEND ')】

dc_mcf_rollback関数　【CBLDCMCF('ROLLBACK')】

dc_mcf_send関数　【CBLDCMCF('SEND ')】

dc_mcf_sendrecv関数　【CBLDCMCF('SENDRECV')】

dc_mcf_sendsync関数　【CBLDCMCF('SENDSYNC')】

dc_mcf_tempget関数　【CBLDCMCF('TEMPGET ')】

dc_mcf_tempput関数　【CBLDCMCF('TEMPPUT ')】

●-t

（オペランド）

sndtim=同期型送信監視時間　〜〈符号なし整数〉((0〜65535))《0》（単位：秒）

同期型メッセージ送信の仕掛り開始時から，仕掛り終了時までの限界経過時間を指定します。

相手システムの処理完了報告までの時間を監視します。

0を指定した場合は，時間監視をしません。

注意事項

監視時間の精度は秒単位です。また，タイマ定義（mcfttim -t）のbtimオペランドで指定する時間監視間隔でタイムアウトが発生したかどうかを監視しています。このため，このオペランドで指定した監視時間と実際にタイムアウトを検出する時間には秒単位の誤差が生じます。そのため，タイミングによっては，指定した監視時間よりも短い時間でタイムアウトすることがあります。監視時間が小さくなるほど，誤差の影響を受けやすくなりますので，監視時間は3（単位：秒）以上の値の設定を推奨します。

sndrcvtim=同期型送受信監視時間　〜〈符号なし整数〉((0〜65535))《0》（単位：秒）

同期型メッセージ送受信の仕掛り開始時から，仕掛り終了時までの限界経過時間を指定します。

相手システムからの応答時間を監視します。

0を指定した場合は，時間監視をしません。

注意事項

監視時間の精度は秒単位です。また，タイマ定義（mcfttim -t）のbtimオペランドで指定する時間監視間隔でタイムアウトが発生したかどうかを監視しています。このため，このオペランドで指定した監視時間と実際にタイムアウトを検出する時間には秒単位の誤差が生じます。そのため，タイミングによっては，指定した監視時間よりも短い時間でタイムアウトすることがあります。監視時間が小さくなるほど，誤差の影響を受けやすくなりますので，監視時間は3（単位：秒）以上の値の設定を推奨します。

recvtim=同期型受信監視時間　〜〈符号なし整数〉((0〜65535))《0》（単位：秒）

同期型メッセージ受信の仕掛り開始時から，仕掛り終了時までの限界経過時間を指定します。

相手システムからの処理完了報告までの時間を監視します。

0を指定した場合は，時間監視をしません。

注意事項

監視時間の精度は秒単位です。また，タイマ定義（mcfttim -t）のbtimオペランドで指定する時間監視間隔でタイムアウトが発生したかどうかを監視しています。このため，このオペランドで指定した監視時間と実際にタイムアウトを検出する時間には秒単位の誤差が生じます。そのため，タイミングによっては，指定した監視時間よりも短い時間でタイムアウトすることがあります。監視時間が小さくなるほど，誤差の影響を受けやすくなりますので，監視時間は3（単位：秒）以上の値の設定を推奨します。

●-j　ユーザサーバのジャーナルバッファの大きさ

　〜〈符号なし整数〉((4096〜4000000の4の倍数))《32768》（単位：バイト）

ジャーナルデータを蓄えておく領域の大きさを指定します。

UAPプロセスが，ジャーナルに対して次の要求を出すまで，この領域にジャーナルデータを蓄えておきます。

ジャーナルファイルへの出力要求

ジャーナルサービスのバッファへの格納要求

ジャーナルバッファの大きさには，GJ，OJ，CJのデータ長のうち最大値以上の値を指定してください。

GJのデータ長

MCFアプリケーション定義のmcfaalcap定義コマンドの-jオプションのgjオペランドにyesを指定したときに取得します。

●32ビット版のとき

↑(204＋seg)／4↑×4

●64ビット版のとき

↑(204＋seg)／8↑×8

OJのデータ長

MHPからメッセージ送信をした場合は，MCFアプリケーション定義のmcfaalcapの-jオプションのojオペランドにyesを指定したときに取得します。SPPからメッセージ送信をした場合は，ユーザサービス定義のmcf_spp_ojオペランドにYを指定したときに取得します。

●32ビット版のとき

↑(204＋seg)／4↑×4

●64ビット版のとき

↑(204＋seg)／8↑×8

CJ（メッセージキューサーバ）のデータ長

ITQ，OTQにディスクキューを使用した場合に取得します。

●32ビット版のとき

↑{260＋Σ{(24×(↑msg／ql↑＋↑960／ql↑))}＋qio}／4↑×4

●64ビット版のとき

↑{260＋Σ{(24×(↑msg／ql↑＋↑1276／ql↑))}＋qio}／8↑×8

（凡例）

↑↑：小数点以下を切り上げます。

seg：セグメント長

msg：ディスクキューを使用した受信メッセージ長または送信メッセージ長

ql：キューファイル物理レコード長

qio：メッセージキューサービス定義のque_io_maxrecsizeオペランドの指定値

Σ：該当するトランザクションで，受信または送信したメッセージに対する見積もりの総和

ユーザが指定した値によって，MCFは次の処理をします。

指定した値がMCFで定めた下限値より小さい場合，その値をMCFで定めた下限値に補正します。

指定した値がMCFで定めた上限値より大きい場合，その値をMCFで定めた上限値に補正します。

指定した値が4の倍数でない場合，その値を4の倍数になるように切り上げます。

なお，このオペランドは，ユーザサービス定義，およびユーザサービスデフォルト定義のmcf_jnl_buff_sizeオペランドでも指定できます。

指定値の優先順位は次のとおりです（1.＞2.＞3.）。

ユーザサービス定義

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

MCFマネジャ定義

ただし，ジャーナルのデータ長が131072を超える場合は，データ長をMCFマネジャ定義に指定し，ユーザサービス定義，およびユーザサービスデフォルト定義のmcf_jnl_buff_sizeオペランドは省略してください。

●-e　segsize=最大セグメント長

　〜〈符号なし整数〉((512〜2147483647))《32768》（単位：バイト）

次の場合に送受信するメッセージの最大セグメント長を指定します。最も大きい方の値を，最大セグメント長として指定してください。

エラーイベント処理用MHPを起動する場合（エラーイベント処理用MHPが送受信するメッセージの最大セグメント長）

アプリケーション起動機能を使用する場合（dc_mcf_execap関数で起動するアプリケーションに渡すメッセージの最大セグメント長）

メッセージ再送機能を使用する場合

mcftdmpquコマンドで入出力キューの内容を複写する場合（内容を複写するキュー内のメッセージの最大セグメント長）

●-l

（オペランド）

initseq=出力通番の初期値　〜〈符号なし整数〉((0〜2147483647))《1》

メッセージ出力通番の初期値を指定します。

maxseq=ラップ時の出力通番最大値　〜〈符号なし整数〉((0〜2147483647))《65535》

出力通番をラップさせる時の，最大値を指定します。

指定した値の次は，開始値になります。

指定した値が小さいと，出力通番のラップアラウンドが発生したあとに，同一キューファイル内に同一の出力通番が存在して，メッセージの出力通番のユニーク性が保証されない場合があります。

このため，次の計算式を満たす値を指定してください。

ラップ時の出力通番最大値　＞　Q×（1＋R）

Q：ディスクメッセージ最大格納数

R：ロールバック率

ただし，ロールバック率は最悪のケースを考慮した値を指定してください。

minseq=ラップ後の出力通番開始値　〜〈符号なし整数〉((0〜1))《1》

出力通番をラップさせる時の，ラップ後の開始値を指定します。

ラップ後の出力通番開始値は，接続相手のオンラインコントロールプログラムによって異なります。

●-u　ntmetim=非トランザクションMHP限界経過時間

　〜〈符号なし整数〉((0〜65535))《0》（単位：秒）

アプリケーション属性定義（mcfaalcap）の-vオプションに指定するntmetimオペランドの省略値を指定します。

非トランザクションMHPの処理のループ，およびハングアップを監視するために，非トランザクションMHPの処理に掛かる限界経過時間を指定します。

0を指定した場合は，時間監視しません。

指定時間を超えても非トランザクションMHPの処理が終了しない場合，非トランザクションMHPを異常終了します。

注意事項

サービス関数開始から終了までの実行監視時間の精度は秒単位です。そのため，タイミングによっては，このオペランドに指定した値よりも短い時間でプロセスを強制停止することがあります。サービス関数開始から終了までの実行監視時間が小さくなるほど，誤差の影響を受けやすくなりますので，このオペランドには3（単位：秒）以上の値の指定を推奨します。

●-a　delaytim=アプリケーション起動時の遅延許容時間

　〜〈符号なし整数〉((0〜360))《0》（単位：分）

起動時刻指定のアプリケーション起動で，指定時刻が現在時刻の前の場合の遅延許容時間を指定します。

指定した時刻が現在時刻より前で，遅延許容時間の範囲内の時間の場合，MCFはすぐに該当するアプリケーションを起動します。遅延許容時間外の時刻の場合，翌日の指定時刻に起動します。

●-c

(オペランド)

order=function｜commit　〜《commit》

複数のUAPによる次に示す処理順序を指定します。

同一の論理端末（mcftalcle -l）を使用するメッセージの送信順序および再送順序

同一の論理端末（mcfaalcap -n lname）または内部通信路（mcfaalcap -n cname）を使用するUAPの起動順序

function

UAPからの関数※の呼び出し順に処理します。

commit

UAPによるトランザクションのコミット順に処理します。

論理端末の出力キュー（ディスクキュー）にメッセージが滞留している状態で，OpenTP1を再開始した場合でも，トランザクションのコミット順に処理します。

注※

関数とは，メッセージ送信関数，メッセージ再送関数およびアプリケーション起動関数を示します。

noansreply=yes｜no　〜《yes》

非応答型のMHPからの問い合わせ応答をするかどうかを指定します。

yes

非応答型のMHPからの問い合わせ応答をします。

非応答型MHPから応答メッセージを送信した場合，一般一方送信メッセージとして扱います。

なお，出力通番は付けられません。

no

非応答型のMHPからの問い合わせ応答をしません。

非応答型MHPから応答メッセージを送信した場合，エラーになります。

commitdml=yes｜no　〜《no》

データ操作言語のCOMMIT文を発行するかどうかを指定します。

yes

COMMIT文を使用します。

データ操作言語のCOMMIT文を発行してエラーが発生した場合，KFCA11199-Eメッセージを出力し，MHPが異常終了します。

no

COMMIT文を使用しません。

データ操作言語のCOMMIT文を発行してエラーが発生しても，UAPでエラーを検出できません。

otqinhold=commit｜function　〜《commit》

出力キューの入力保留中にUAPがメッセージを送信したときの動作を指定します。

commit

トランザクションの同期点処理でUAPの処理を待ち合わせます。

同期点処理で待ち合わせる場合の例を次に示します。

function

メッセージの送信関数でUAPの処理を待ち合わせます。

メッセージの送信関数で待ち合わせる場合の例を次に示します。

出力キューの入力保留中にUAPの処理を待ち合わせる関数を次の表に示します。

言語

関数名称

C言語

dc_mcf_send関数

dc_mcf_resend関数

dc_mcf_reply関数

COBOL言語

CALLインタフェース

CBLDCMCF('SEND ')

CBLDCMCF('RESEND ')

CBLDCMCF('REPLY ')

DMLインタフェース

SEND − メッセージの送信※

注※

非同期型のメッセージ送信（SYNCHRONOUS MODE句を指定していない，またはASYNC，'0'もしくは空白が設定されているデータ項目を指定）の場合だけです。

注意事項

同期点処理で待ち合わせる場合とメッセージの送信関数で待ち合わせる場合の動作の違いを次の表に示します。

UAP共通定義（mcfmuap -c）のotqinholdオペランドの指定値

dcsvstop -fコマンドによる強制停止

service_expiration_timeオペランドによる実時間監視タイムアウト※

trn_expiration_timeオペランド，mcfmuap -u ntmetimオペランド，mcfaalcap -v ntmetimオペランドの監視対象該否

UAP強制停止前に送信したメッセージの扱い

commitまたは省略

入力保留を解除するまで待ち合わせる

入力保留を解除するまでUAPの異常終了を待ち合わせる

該当しない

（監視区間の範囲外）

有効

（出力キューに残留）

function

即時に受け付ける

即時にUAPが異常終了する

該当する

（監視区間の範囲内）

無効

（出力キューから削除）

注※

SPPだけ有効です。MHPでは監視しません。

errevt_recovery=yes｜no　〜《yes》

OpenTP1再開始時のエラーイベント（ERREVT1，ERREVT2，ERREVT3，ERREVT4，ERREVTA）を引き継ぐかどうかを指定します。

yes

OpenTP1再開始時のエラーイベントを引き継ぎます。

no

OpenTP1再開始時のエラーイベントを引き継ぎません。すべてのエラーイベントを破棄します。

注意事項

引き継ぎ対象となるのは，ディスクキューに割り当てられている（アプリケーション属性定義（mcfaalcap -g）のquekindオペランドにdiskを指定）エラーイベントです。メモリキューに割り当てられているエラーイベントはこのオペランドの指定値に関係なく，破棄します。

エラーイベントが発生したメッセージがOpenTP1再開始時に破棄されるメッセージの場合，このオペランドの指定値に関係なく，OpenTP1の再開始時にエラーイベントを破棄します。

itqretryorder=first｜last　〜《last》

MHPの再スケジュール時※に，受信メッセージを入力キューに格納する位置を指定します。

注※

次の場合が該当します。

トランザクション処理を実行しているMHPからRETRYを設定したロールバック（C言語の場合，actionにDCMCFRTRYを設定したdc_mcf_rollback関数を発行する，COBOL言語の場合，データ名Cに'RTRY'を設定したCBLDCMCF('ROLLBACK')を発行する）を行った場合

アプリケーション異常終了時の再スケジュール回数（アプリケーション属性定義（mcfaalcap -d）のreschedulecntオペランドまたはUAP共通定義（mcfmuap -r）のreschedulecntオペランドの指定値）が1以上のとき，トランザクション処理を実行しているMHPがサービス実行中に異常終了してロールバックした場合

first

受信メッセージを入力キューの最初に格納します。

firstを指定する場合，次の指定をする必要があります。

システム共通定義のwatch_timeオペランドを省略するか，180以上を指定する。

プロセスサービス定義のprc_recovery_residentオペランドを省略するか，Yを指定する。

MHPのユーザサービス定義またはユーザサービスデフォルト定義のscd_process_ctl_optオペランドに1を指定する。

MHPの多重度が1の場合，MHPの再スケジュールが発生したときにあとから受信したメッセージが前に受信したメッセージを追い越すことはありません。

last

受信メッセージを入力キューの最後に格納します。

MHPの多重度を1としていたとしても，MHPの再スケジュールが発生したときにあとから受信したメッセージが前に受信したメッセージを追い越すことがあります。

●-r

(オペランド)

reschedulecnt=アプリケーション異常終了時の再スケジュール回数　〜〈符号なし整数〉((0〜3))《0》（単位：回）

トランザクション処理を実行しているMHPがサービス実行中に異常終了してロールバックした場合の，再スケジュール回数を指定します。

アプリケーション属性定義（mcfaalcap）に指定する-dオプションのreschedulecntオペランドの省略時解釈値となります。

このオペランドに1〜3の値を指定すると，受信したメッセージを該当する入力キューの最後に格納し，異常終了したMHPを自動的にスケジュールし直します。

0を指定した場合は，再スケジュールしません。

指定した回数を超えてMHPが異常終了した場合，再スケジュールしません。この場合，KFCA11163-Eメッセージを出力し，エラーイベントを通知します。

rescheduleint=アプリケーション異常終了時の再スケジュール間隔　〜〈符号なし整数〉((0〜3))《0》（単位：秒）

異常終了してロールバックしたMHPを自動的に再スケジュールするまでの所要時間※に加算する時間を，秒単位で指定します。

アプリケーション属性定義（mcfaalcap）に指定する-dオプションのrescheduleintオペランドの省略時解釈値となります。

この指定は，reschedulecntオペランドに1〜3の値を指定した場合に有効となります。

注※

異常終了したプロセス以外に空きプロセスが存在する場合，間隔を空けないで再スケジュールします。

異常終了したプロセス以外に空きプロセスが存在しない，かつユーザサービス定義，またはユーザサービスデフォルト定義のholdオペランドにYを指定した場合，再スケジュールするまでに最大10秒掛かります。

異常終了したプロセス以外に空きプロセスが存在しない，かつユーザサービス定義，またはユーザサービスデフォルト定義のholdオペランドにNを指定した場合，ユーザサービス定義，またはユーザサービスデフォルト定義のterm_watch_timeオペランドの指定時間内で，異常終了したMHPの3回目の再スケジュールに最大10秒掛かります。2回目までは間隔を空けないで再スケジュールします。

reschedulelog=yes｜no　〜《no》

異常終了してロールバックしたMHPを自動的に再スケジュールするときに，ログメッセージを出力するかどうかを指定します。

アプリケーション属性定義（mcfaalcap）に指定する-dオプションのreschedulelogオペランドの省略時解釈値となります。

この指定は，reschedulecntオペランドに1〜3の値を指定した場合に有効となります。

yes

KFCA11810-Iメッセージを出力します。

no

KFCA11810-Iメッセージを出力しません。

mcfmqgid

名称

入出力キュー定義

形式

〔{{mcfmqgid  -q  "quekind=itq|otq
                   quegrpid=キューグループID"}}〕

機能

入出力キューに関する環境を定義します。

ディスクキューを指定する場合は必ず定義してください。メモリキューの場合は定義する必要はありません。

入力キューおよび出力キューに対応する物理ファイルをそれぞれ複数個作成できます。

入力キューおよび出力キューに対応する物理ファイルはMCF通信サービス間で共用できます。

ただし，入力キューおよび出力キューを同一の物理ファイルに割り当てることはできません。

入力キューは，サービスグループに対応します。また，出力キューは論理端末に対応します。

指定数に応じて静的共用メモリ，およびステータスファイルの容量を見積もる必要があります。静的共用メモリの見積もりは，「付録B.2　MCFサービス用の共用メモリの見積もり式」を参照してください。ステータスファイルの見積もりは，マニュアル「OpenTP1 運用と操作」の「ステータスファイルのサイズの見積もり式」の説明を参照してください。

オプション

●-q

（オペランド）

quekind=itq|otq

キュー（ディスク）の種別を指定します。

itq

入力キュー用

otq

出力キュー用

quegrpid=キューグループID　〜〈1〜8文字の識別子〉

quekindオペランドで指定したディスクキューを使用するキューグループIDを指定します。

このMCFマネジャ定義下のMCFで使用するキューグループIDをすべて指定します。キューグループIDはメッセージキューサービス定義で指定したキューグループIDを指定します。

このキューグループIDはほかのmcfmqgidコマンドで指定するキューグループIDと通信プロセス単位で重複して指定できません。

mcfmexp

名称

拡張予約定義

形式

〔mcfmexp  -g  サービスグループの登録数
           -l  論理端末の登録数
         〔-i  dg|ndg〕
         〔-o  dg|ndg〕〕

機能

拡張機能に関する環境を定義します。mcfmqgidコマンドを定義したとき，必ずこのmcfmexpコマンドを定義してください。また，mcfmqgidコマンドを省略したときは，mcfmexpコマンドを定義できません。

オプション

●-g　サービスグループの登録数

　〜〈符号なし整数〉((1〜8192))

このMCFマネジャ管理下のMCFで使用するMCFアプリケーション定義中のサービスグループの総数を含む予約最大数を指定します。

MCFアプリケーション定義のmcfaalcap定義コマンドの-gオプションのquekindオペランドに，diskを指定したアプリケーションが属するMHPのサービスグループの総数を指定してください。なお，条件に該当するサービスグループの総数が0になった場合は，1を指定してください。

●-l　論理端末の登録数

　〜〈符号なし整数〉((1〜16380))

このMCFマネジャ管理下のMCFで使用する論理端末の総数を含む予約最大数を指定します。

指定する論理端末数には，MCF通信プロセスまたはアプリケーション起動プロセスごとに，それぞれ次の条件を満たす論理端末の総数を指定してください。なお，条件に該当する論理端末の総数が0になった場合は，1を指定してください。

MCF環境定義（mcftenv）の-qオプションのdiskitqオペランドにyesを指定，または指定を省略している場合

論理端末定義（mcftalcle）の-kオプションのquekindオペランドの指定に関係なく，このMCF通信プロセスまたはアプリケーション起動プロセスに定義している論理端末の総数を指定してください。

MCF環境定義（mcftenv）の-qオプションのdiskitqオペランドにnoを指定している場合

論理端末定義（mcftalcle）の-kオプションのquekindオペランドにdiskを指定した論理端末の総数を指定してください。

注意事項

mcfmexp定義コマンドの-gオプションとmcfmexp定義コマンドの-lオプションには次の条件を満たす値を指定してください。

32767≧サービスグループの登録数（mcfmexp定義コマンドの-gオプションの指定値）
　　＋論理端末の登録数（mcfmexp定義コマンドの-lオプションの指定値）×2
　　＋MCF通信サービスの数（mcfmcname定義コマンド指定数）×5

条件を満たさない値を指定した場合，OpenTP1開始時にメッセージKFCA11033-Wを出力します。

mcfmexp定義コマンドの-gオプションおよびmcfmexp定義コマンドの-lオプションの指定値に応じて，静的共用メモリおよびステータスファイルの容量を見積もる必要があります。

静的共用メモリの見積もりは，「付録B.1　TP1/Server Base用の共用メモリの見積もり式」を参照してください。ステータスファイルの見積もりは，マニュアル「OpenTP1 運用と操作」の「ステータスファイルのサイズの見積もり式」の説明を参照してください。

mcfmexp定義コマンドの-gオプションおよびmcfmexp定義コマンドの-lオプションの指定値は，オンラインの開始および終了の所要時間に影響しますので，必要以上に大きな値を指定しないでください。

●-i　dg|ndg

　〜《ndg》

システム開始時に入力用ディスクキューが使用できない場合，メモリキューを代用して縮退運転をするかどうかを指定します。

dg：縮退運転をします。

ndg：縮退運転をしません。

●-o　dg|ndg

　〜《ndg》

システム開始時に出力用ディスクキューが使用できない場合，メモリキューを代用して縮退運転をするかどうかを指定します。

dg：縮退運転をします。

ndg：縮退運転をしません。

mcfmsts

名称

状態引き継ぎ定義

形式

mcfmsts  〔-g  サービスグループ数上限値〕
         〔-v  サービス数上限値〕

機能

再開始時の状態引き継ぎについて定義します。

状態を引き継ぐリソース数の上限値を指定します。このMCFサービスで使用するリソースに関して指定します。

オプション

●-g　サービスグループ数上限値

　〜〈符号なし整数〉((1〜8192))

状態を引き継ぐサービスグループの数を指定します。引き継ぐ対象は，mcftdctsgコマンドによる閉塞の状態，およびmcfthldiqコマンドによる保留の状態です。アプリケーションの異常終了に伴う閉塞状態は引き継がれません。このMCFサービスで使用するサービスグループの総数以上を指定してください。

サービスグループの状態を引き継がない場合，このオプションを省略します。

指定値に応じてステータスファイルの容量を見積もる必要があります。ステータスファイルの見積もりは，マニュアル「OpenTP1 運用と操作」の「ステータスファイルのサイズの見積もり式」の説明を参照してください。

●-v　サービス数上限値

　〜〈符号なし整数〉((1〜1044480))

状態を引き継ぐサービスの数を指定します。引き継ぐ対象は，mcftdctsvコマンドによる閉塞の状態です。アプリケーションの異常終了に伴う閉塞状態は引き継がれません。このMCFサービスで使用するサービスの総数以上を指定してください。

サービスの状態を引き継がない場合，このオプションを省略します。

指定値に応じてステータスファイルの容量を見積もる必要があります。ステータスファイルの見積もりは，マニュアル「OpenTP1 運用と操作」の「ステータスファイルのサイズの見積もり式」の説明を参照してください。

mcfmsmsg

名称

ログメッセージ出力抑止定義

形式

mcfmsmsg  〔-m  "〔抑止メッセージID 〔抑止メッセージID〕…〕"〕

機能

ログメッセージの出力を抑止するときに定義します。

-mオプションで指定したメッセージIDのログメッセージ出力（出力先：標準出力，標準エラー出力，およびメッセージログファイル）を抑止します。ログメッセージ出力要求が頻繁に発生すると，ログサービスに負担が掛かり，業務処理が遅延することがあります。このような場合に-mオプションを指定してログサービスへの負担を軽減してください。

オプション

●-m　"〔抑止メッセージID 〔抑止メッセージID〕…〕"

　〜〈符号なし整数〉((10000〜19999，28000〜29999))

ログファイルへの出力を抑止するメッセージのIDを指定します。

指定する抑止メッセージIDはメッセージ通番（整数5けた）だけとします。

抑止メッセージIDは最大50個指定できます。

なお，抑止対象外のメッセージIDを指定した場合，そのメッセージは抑止できません。抑止対象外のメッセージを次に示します。

MCF以外が出力しているメッセージ

MCF開始中のメッセージ

メッセージ出力時ログファイルに出力されないメッセージ

定義コマンド，および運用コマンドが出力するメッセージ

mcfmsvg

名称

サービスグループ属性定義

形式

〔{{mcfmsvg  -g "servgrpn=サービスグループ名"
           〔-w  "〔watchcnt=入力キューの滞留監視数〕
                  〔watchint=入力キューの滞留監視インタバル時間〕
                  〔expectcnt=MHPに期待するサービス要求の処理数〕
                  〔abort=yes｜no〕"〕}}〕

機能

サービスグループの属性について定義します。

オプション

●-g

（オペランド）

servgrpn=サービスグループ名　〜〈1〜31文字の識別子〉

入力キューの滞留監視を行うサービスグループ名を指定します。

サービスグループ名は，ユーザサービス定義に指定してあるサービスグループ名を指定します。

●-w

（オペランド）

watchcnt=入力キューの滞留監視数　〜〈符号なし整数〉((0〜65535))《0》

滞留数監視区間から処理能力判定区間に遷移する際の判断になる入力キューのメッセージ滞留数（しきい値）を指定します。

このオペランドの指定値以上のメッセージが入力キューに滞留している場合，処理能力判定区間に遷移します（watchintオペランドで指定した間隔でMHPの処理能力の判定を行います）。

このオペランドを省略した場合，または0を指定した場合は，入力キューの滞留監視は行いません。

watchint=入力キューの滞留監視インタバル時間　〜〈符号なし整数〉((5〜3600))《10》（単位：秒）

入力キューに滞留しているメッセージ数およびMHPの処理能力を監視するインタバル時間を指定します。

watchcntオペランドを省略した場合，または0を指定した場合は，このオペランドの指定値は無効です。

expectcnt=MHPに期待するサービス要求の処理数　〜〈符号なし整数〉((1〜65535))

次回のMHPの処理能力判定時までに処理完了を期待するサービス要求の処理数を指定します。

watchcntオペランドに1以上を指定した場合に，このオペランドを省略したときは定義エラーになります。watchcntオペランドを省略した場合，または0を指定した場合は，このオペランドの指定値は無効です。

このオペランドで指定する値は，次に示す算出式で見積もってください。

MHPに期待するサービス要求の処理数=入力キューの滞留監視インタバル時間÷サービス要求1件当たりのMHPの処理時間×利用率

abort=yes｜no　〜《no》

MHPの処理能力の不足を検出した場合，OpenTP1システムをダウンさせるかどうかを指定します。

watchcntオペランドを省略した場合，または0を指定した場合は，このオペランドの指定値は無効です。

yes

MHPの処理能力の不足を検出した場合に，KFCA11821-Eメッセージを出力し，MHPおよびMCFマネジャプロセスを強制停止します。

no

MHPの処理能力の不足を検出した場合に，KFCA11820-Wメッセージを出力し，処理を続行します。

MCF通信構成定義

MCF通信構成定義は，MCF通信サービスに対して，実行環境を設定するものです。また，MCF通信構成定義を作成することによって，MCF通信サービスの起動を宣言します。複数の通信サービスを使用する場合，その数だけMCF通信構成定義を作成してください。

MCF通信構成定義は，次の二つの定義から構成されます。

共通定義

データコミュニケーション定義

共通定義とデータコミュニケーション定義は，別々のファイルに作成します。最終的には二つの定義を結合して，一つの定義オブジェクトファイルを生成します。定義オブジェクトファイルの生成については，「4.3　定義オブジェクトファイルの生成」を参照してください。

定義内容の概略は次のとおりです。

共通定義

各MCF通信サービスで共通して必要な環境情報を定義します。共通の定義コマンドを使用します。ただし，識別子などの指定値は，定義間で重複して指定できません。通信サービスごとに，別々の共通定義ソースファイルを作成してください。ただし，通信サービスの種類によっては，固有のオプションがあります。これについては，マニュアル「OpenTP1 プロトコル」の該当するプロトコル編を参照してください。

データコミュニケーション定義

各MCF通信サービスに固有の環境情報を定義します。通信サービスに固有の定義コマンドを使用します。

データコミュニケーション定義は，通信サービスの性格によって次の2種類に分けられます。

プロトコル固有定義

アプリケーション起動定義

外部通信のための通信サービス（MCF通信プロセス）に対してMCF通信構成定義を作成する場合，プロトコル固有定義コマンドを使用します。プロトコル固有定義コマンドの詳細については，マニュアル「OpenTP1 プロトコル」の該当するプロトコル編を参照してください。

ノード内通信のための通信サービス（アプリケーション起動プロセス）に対してMCF通信構成定義を作成する場合，アプリケーション起動定義コマンドを使用します。

各データコミュニケーション定義で共通する定義コマンドがありますが，指定するオプションなどが多少異なります。適切な通信サービスの定義コマンドを参照してください。

次の図に，MCF通信構成定義のファイル構成を示します。

図5‒2　MCF通信構成定義のファイル構成

共通定義コマンドの指定順序

共通定義コマンドの指定順序を次の図に示します。

図5‒3　共通定義コマンドの指定順序

アプリケーション起動定義コマンドの指定順序

アプリケーション起動定義コマンドの指定順序を次の図に示します。

図5‒4　アプリケーション起動定義コマンドの指定順序

mcftenv

名称

MCF環境定義

形式

mcftenv  -s  MCF通信プロセス識別子|アプリケーション起動プロセス識別子
       〔-m  MCFマネジャプロセス識別子〕
         -a  MCFアプリケーション定義オブジェクトファイル名
         -q  〔diskitq=yes|no〕

機能

MCFに共通する環境を定義します。

オプション

●-s　MCF通信プロセス識別子|アプリケーション起動プロセス識別子

　〜〈数字（0〜9），a〜f〉((01〜ef))

MCF通信プロセスの識別子，またはアプリケーション起動プロセスの識別子を指定します。ここで指定する識別子は，ほかのmcftenvコマンドで指定する識別子と重複してはいけません。

MCF通信プロセス識別子

このMCF通信構成定義がMCF通信プロセスに対応するとき，MCF通信プロセス識別子を指定します。MCF通信プロセス識別子は，MCFが出力するメッセージログなどで，MCF通信プロセスを特定する場合に使用します。また，運用コマンドを入力するときの，MCF通信プロセスの指定に使用します。

アプリケーション起動プロセス識別子

このMCF通信構成定義がアプリケーション起動プロセスに対応するとき，アプリケーション起動プロセス識別子を指定します。ここで指定したアプリケーション起動プロセス識別子を，対応するMCFアプリケーション定義のmcfaenvコマンドの-pオプションで指定します。

●-m　MCFマネジャプロセス識別子

　〜〈英字〉((A〜Z，a〜z))《A》

該当するMCF通信プロセスを管理するMCFマネジャプロセスの識別子を指定します。MCFマネジャプロセス識別子は，該当するMCFマネジャ定義内のmcfmenvコマンドで指定した値を指定します。

●-a　MCFアプリケーション定義オブジェクトファイル名

　〜〈1〜8文字の英数字〉

このMCF通信構成定義に対応するMCFアプリケーション定義オブジェクトファイル名を指定します。

このMCFアプリケーション定義オブジェクトファイル名は，MCF定義オブジェクト生成ユティリティ（mcfapli）で生成するMCFアプリケーション定義の出力オブジェクトファイル名を指定します。

●-q

（オペランド）

diskitq=yes|no　〜《yes》

該当するMCF通信サーバから起動されるアプリケーションが，入力キューにディスクキューを使用するかどうかを指定します。

入力キューにディスクキューを使用しない（diskitq=no）と指定した場合，MCFの開始処理が速くなります。

なお，ご使用のOSがWindowsの場合，このオプションは指定できません。

yes

該当するMCF通信サーバで入力キューにディスクキューを使用します。

各アプリケーションが入力キューにディスクキューを使用するかどうかは，MCFアプリケーション定義mcfaalcapの-gオプションのquekindオペランドの指定値に従います。

no

該当するMCF通信サーバで入力キューにディスクキューを使用しません。

MCFアプリケーション定義mcfaalcapの-gオプションのquekindオペランドの指定値に関係なく，すべてのアプリケーションで入力キューにメモリキューを使用します。

mcftcomn

名称

MCF通信構成共通定義

形式

mcftcomn  〔-j  MCF通信プロセスまたはアプリケーション起動プロセスのジャー
                ナルバッファの大きさ〕

機能

MCF通信プロセスまたはアプリケーション起動プロセスのジャーナルバッファの大きさを定義します。

オプション

●-j　MCF通信プロセスまたはアプリケーション起動プロセスのジャーナルバッファの大きさ

　〜〈符号なし整数〉((4096〜4000000の4の倍数))《32768》（単位：バイト）

ジャーナルデータを蓄えておく領域の大きさを指定します。

MCF通信プロセスまたはアプリケーション起動プロセスが，ジャーナルサービスに対して次の要求を出すまで，この領域にジャーナルデータを蓄えておきます。

ジャーナルファイルへの出力要求

ジャーナルサービスのバッファへの格納要求

ジャーナルバッファの大きさには，IJ，MJ，CJのデータ長のうち，最大値以上の値を指定してください。

IJのデータ長

MCFアプリケーション定義のmcfaalcap定義コマンドの-jオプションのijオペランドにyesを指定したときに取得します。

●32ビット版のとき

↑(172＋seg)／4↑×4

●64ビット版のとき

↑(172＋seg)／8↑×8

MJのデータ長

mcftactmjコマンドを実行したときに取得します。

●32ビット版のとき

↑(180＋seg)／4↑×4

●64ビット版のとき

↑(180＋seg)／8↑×8

CJ（メッセージキューサーバ）のデータ長

ITQ，OTQにディスクキューを使用した場合に取得します。

次に示す二つの計算式のうち最大の値をデータ長としてください。

計算式1：

●32ビット版のとき

↑{88＋(24×(↑msg／ql↑＋↑960／ql↑))＋qio}／4↑×4

●64ビット版のとき

↑{88＋(24×(↑msg／ql↑＋↑1276／ql↑))＋qio}／8↑×8

計算式2：

●32ビット版のとき

260＋（24×m）

●64ビット版のとき

↑{260＋（24×m）}／8↑×8

（凡例）

↑↑：小数点以下を切り上げます。

seg：セグメント長

msg：ディスクキューを使用した受信メッセージ長または送信メッセージ長

ql：キューファイル物理レコード長

qio：メッセージキューサービス定義のque_io_maxrecsizeオペランドの指定値

m：保持メッセージ数（メッセージキューサービス定義のquegrp定義コマンドの-mオプションで指定した値）

ユーザが指定した値によって，MCFは次の処理をします。

指定した値がMCFで定めた下限値より小さい場合，その値をMCFで定めた下限値に補正します。

指定した値がMCFで定めた上限値より大きい場合，その値をMCFで定めた上限値に補正します。

指定した値が4の倍数でない場合，その値を4の倍数になるように切り上げます。

mcfttred

名称

最大処理多重度定義

形式

〔mcfttred  〔-m  最大処理多重度〕〕

機能

MCF通信プロセスの最大処理多重度を定義します。アプリケーション起動プロセスの場合は，この定義コマンドは省略してください。

オプション

●-m　最大処理多重度

　〜〈符号なし整数〉((1〜1000))《10》

MCF通信プロセスで，並行してメッセージ受信およびメッセージ送信を処理するコネクション数の最大値を指定します。

MCF通信プロセスは，複数のコネクションから同時期に受信したメッセージおよびUAPから，複数のコネクションに対して同時期に送信要求されたメッセージを，並行して処理できます。並行して処理できる多重度の上限値は，このオプションで指定します。ただし，高トラフィック状態でも，システムの環境によっては，定義で指定した値まで並行処理しない場合があります。この場合，むだにローカルメモリを使用していることになり，かえって性能に悪影響を与えていることがあります。最大処理多重度定義の指定値を1増すごとに，MCF通信プロセスが使用するローカルメモリが約32キロバイト（AIX 5Lの場合は約64キロバイト）増加します。

このオプションのチューニングは，メッセージ多重処理状況の表示コマンド（mcftlstrd）を実行した結果，またはMCF稼働統計情報を取得した結果から，現状の多重処理状況を把握してから行ってください。

なお，最大処理多重度定義の指定値よりコネクション定義の指定数が小さい場合，最大処理多重度は，コネクション定義の指定数になります。

mcfttim

名称

タイマ定義

形式

〔mcfttim  〔-t  "〔btim=時間監視間隔〕
                  〔mtim=未処理送信メッセージ滞留時間〕
                  〔rmtim=未処理受信メッセージ滞留時間〕"〕
           〔-p  "〔usertime=yes|no〕
                  〔timereqno=最大タイマ監視要求数〕
                  〔msgsize=最大メッセージ長〕
                  〔msgout=yes|no〕"〕〕

機能

MCFの時間監視に関する環境を定義します。

オプション

●-t

(オペランド)

btim=時間監視間隔　〜〈符号なし整数〉((1〜60))《1》（単位：秒）

MCF通信サービスで使用する時間監視間隔を指定します。

MCFの一部の時間監視では，指定した時間が経過したかどうか，この間隔ごとに調べます。監視時間の誤差は，時間監視間隔の大きさに影響して大きくなります。

mtim=未処理送信メッセージ滞留時間　〜〈符号なし整数〉((60〜65535))《180》（単位：秒）

未処理送信メッセージの滞留時間を指定します。

MCFの終了処理時に閉塞解除されている論理端末の出力キューに残っている未処理送信メッセージの滞留時間を監視します。終了処理が長時間終了しないのを防止できます。ただし，正常終了のときだけ有効です。

指定時間を超えても未処理送信メッセージが残っている場合は，送信されたものと見なして，終了処理を続行します。この場合，未処理送信メッセージを破棄して，未処理送信メッセージ廃棄通知イベント（ERREVTA）が通知されます。

ただし，dc_mcf_execap関数によるタイマ起動要求メッセージや閉塞されている論理端末の出力キューに残っている未処理送信メッセージは，未処理送信メッセージ滞留時間の監視対象とはなりません。OpenTP1の正常終了コマンド実行時にメッセージが残っていた場合は，すぐにメッセージが破棄され，ERREVTAが通知されます。

注意事項

監視時間の精度は秒単位です。また，タイマ定義（mcfttim -t）のbtimオペランドで指定する時間監視間隔でタイムアウトが発生したかどうかを監視しています。このため，このオペランドで指定した監視時間と実際にタイムアウトを検出する時間には秒単位の誤差が生じます。そのため，タイミングによっては，指定した監視時間よりも短い時間でタイムアウトすることがあります。

rmtim=未処理受信メッセージ滞留時間　〜〈符号なし整数〉((0〜65535))《0》（単位：秒）

未処理受信メッセージの滞留時間を指定します。

MCFの終了処理時に入力キューに残っている未処理受信メッセージの滞留時間を監視します。終了処理が長時間終了しないのを防止できます。ただし，正常終了，計画停止Aのときだけ有効です。

指定時間を超えても未処理受信メッセージが残っている場合，MCFは異常終了します。

ここで0を指定した場合，時間を監視しません。入力キューに残っている未処理受信メッセージがなくなるまで待ちます。

注意事項

監視時間の精度は秒単位です。また，タイマ定義（mcfttim -t）のbtimオペランドで指定する時間監視間隔でタイムアウトが発生したかどうかを監視しています。このため，このオペランドで指定した監視時間と実際にタイムアウトを検出する時間には秒単位の誤差が生じます。そのため，タイミングによっては，指定した監視時間よりも短い時間でタイムアウトすることがあります。監視時間が小さくなるほど，誤差の影響を受けやすくなりますので，監視時間は5（単位：秒）以上の値の設定を推奨します。

●-p

(オペランド)

usertime=yes|no　〜《no》

ユーザタイマ監視機能を使用するかどうかを指定します。

yes

ユーザタイマ監視機能を使用します。

no

ユーザタイマ監視機能を使用しません。

timereqno=最大タイマ監視要求数　〜〈符号なし整数〉((1〜10000))《16》

ユーザタイマ監視の要求数の最大値を指定します。

指定値に応じて静的共用メモリの容量を見積もる必要があります。静的共用メモリの見積もりは，「付録B.2　MCFサービス用の共用メモリの見積もり式」を参照してください。

msgsize=最大メッセージ長　〜〈符号なし整数〉((0〜256))《0》（単位：バイト）

指定した時間を超えた場合に，起動するMHPに渡すメッセージのセグメントの最大長を指定します。

指定値に応じて静的共用メモリの容量を見積もる必要があります。静的共用メモリの見積もりは，「付録B.2　MCFサービス用の共用メモリの見積もり式」を参照してください。

msgout=yes|no　〜《no》

次に示す場合のメッセージを出力するかどうかを指定します。

ユーザタイマ監視の取り消し関数が，DCMCFER_PARAM_TIM_ID（C言語），または70910（COBOL言語）でエラーリターンした場合にKFCA16518-Iを出力します。

タイムアウト発生時にKFCA16519-Iを出力します。

yes

メッセージを出力します。

no

メッセージを出力しません。

mcfttrc

名称

トレース環境定義

形式

mcfttrc  〔-t  "〔size=トレースバッファの大きさ〕
                〔disk=yes|no〕
                〔bufcnt=トレースバッファの数〕
                〔trccnt=トレースファイルの数〕
                〔msgsize=トレースとして取得する送受信メッセージ
                          の最大サイズ〕"〕
         〔-m  del|off〕

機能

MCFのトレースに関する環境を定義します。

MCFトレースは，MCFに関する情報を取得し，トラブル解析用に使用します。

オプション

●-t

(オペランド)

size=トレースバッファの大きさ　〜〈符号なし整数〉((4096〜15728640の4の倍数))《204800》（単位：バイト）

MCFトレースを格納するためのバッファの大きさを指定します。

通常は省略値を使ってください。

ユーザが指定した値によって，MCFは次の処理をします。

指定した値がMCFで定めた下限値より小さい場合，その値をMCFで定めた下限値に補正します。

指定した値がMCFで定めた上限値より大きい場合，その値をMCFで定めた上限値に補正します。

指定した値が4の倍数でない場合，その値を4の倍数になるように切り上げます。

指定値に応じて静的共用メモリの容量を見積もる必要があります。静的共用メモリの見積もりは，「付録B.2　MCFサービス用の共用メモリの見積もり式」を参照してください。

disk=yes|no　〜《yes》

MCFトレースのディスク出力機能を使用するかどうかを指定します。

yes

ディスク出力機能を使用します。MCFトレース情報でトレースバッファが満杯になった時に，バッファの内容をディスクに出力（スワップ）します。

MCFトレースファイルは，$DCDIR/spool/ディレクトリの下に，mcftXXXnn（XXXはMCF識別子，nnは通し番号）というファイル名で出力されます。

MCFトレースファイルの詳細については，マニュアル「OpenTP1 運用と操作」の「MCFトレースに関する運用」および「OpenTP1が出力するファイル一覧」の説明を参照してください。

なお，MCF通信プロセスおよびアプリケーション起動プロセスが異常終了したとき，最新トレース情報をmcftXXX0というファイルに出力する場合があります。このファイルは，trccntオペランドで指定するトレースファイルの数に含まれません。

no

ディスク出力機能を使用しません。メモリにだけ出力します。

diskオペランドを省略した場合は，MCFトレースファイルを生成しません。メモリ上の2面バッファを交互に使用します。

また，diskオペランドを省略した場合は，次のbufcntオペランド，trccntオペランド，および-mオプションの指定は無効になります。

bufcnt=トレースバッファの数　〜〈符号なし整数〉((10〜2147483647))《100》

トレースバッファの数を指定します。

MCFトレースファイルにトレースバッファを何面分格納するかを指定します。

なお，MCFトレースファイルの大きさが次の条件を満たすようにトレースバッファの大きさ（mcfttrc -t sizeの指定値）とトレースバッファの数（mcfttrc -t bufcntの指定値）を指定してください。

MCFトレースファイルの大きさ=トレースバッファの数（mcfttrc -t bufcntの指定値）×トレースバッファの大きさ（mcfttrc -t sizeの指定値）＜2,147,483,648バイト

trccnt=トレースファイルの数　〜〈符号なし整数〉((3〜99))《3》

MCFトレースファイルの数を指定します。

スワップ済みトレースファイル（bufcntオペランドで指定した数のスワップを終了したトレースファイル）とスワップ用トレースファイルの合計を指定します。

msgsize=トレースとして取得する送受信メッセージの最大サイズ　〜〈符号なし整数〉((0〜1073741824))《128》（単位：バイト）

MCFはメッセージ受信時およびメッセージ送信時に，そのメッセージの一部またはすべてをトレースとして取得します。メッセージの先頭からどれだけの内容をトレースに取得するか，その最大サイズを指定します。

0を指定した場合，メッセージの内容をトレースに取得しません。メッセージのサイズがこの指定値より小さい場合は，メッセージのすべての内容をトレースとして取得します。

このオペランドは，TP1/NET/TCP/IPを使用したMCF通信サービスに対して有効です。

●-m　del|off

　〜《del》

スワップ済みトレースファイルの数と，trccntオペランドの指定値との関係を指定します。

del

スワップ済みトレースファイルの数と，trccntオペランドの指定値が一致した場合，いちばん古いスワップ済みトレースファイルを削除し，そのファイル名でスワップ用トレースファイルを作成します。

off

trccntオペランドの指定値を無視します。スワップ済みトレースファイルの数が99になった場合，いちばん古いスワップ済みトレースファイルを削除し，そのファイル名でスワップ用トレースファイルを作成します。

ディスクの空き容量を圧迫しますので，スワップ済みトレースファイルは，運用者の責任で処理したあと，削除してください。

mcftsts

名称

状態引き継ぎ定義

形式

〔mcftsts  〔-a  アプリケーション数上限値〕
           〔-l  論理端末数上限値〕〕

機能

再開始時の状態引き継ぎについて定義します。

状態を引き継ぐリソース数の上限値を指定します。このMCF通信サービスで使用するリソースに関して指定します。

オプション

●-a　アプリケーション数上限値

　〜〈符号なし整数〉((1〜8192))

状態を引き継ぐアプリケーションの数を指定します。引き継ぐ対象は，mcfadctapコマンドによる閉塞の状態です。アプリケーションの異常終了に伴う閉塞状態は引き継がれません。このMCF通信サービスで使用するアプリケーションの総数以上を指定してください。

アプリケーションの状態を引き継がない場合，このオプションを省略します。

指定値に応じてステータスファイルの容量を見積もる必要があります。ステータスファイルの見積もりは，マニュアル「OpenTP1 運用と操作」の「ステータスファイルのサイズの見積もり式」の説明を参照してください。

●-l　論理端末数上限値

　〜〈符号なし整数〉((1〜2048))

状態を引き継ぐ論理端末の数を指定します。引き継ぐ対象は，出力キューの入力，および出力の保留／保留解除状態です。このMCF通信サービスで使用する論理端末の総数以上を指定してください。

論理端末の状態を引き継がない場合，このオプションを省略します。

指定値に応じてステータスファイルの容量を見積もる必要があります。ステータスファイルの見積もりは，マニュアル「OpenTP1 運用と操作」の「ステータスファイルのサイズの見積もり式」の説明を参照してください。

mcftbuf

名称

バッファグループ定義

形式

{{mcftbuf  -g  "groupno=バッファグループ番号
                length=バッファ長
                count=バッファ数
              〔extend=拡張バッファ数〕"}}

機能

メッセージ送受信用，およびメッセージ編集用のバッファに関する環境を定義します。

アプリケーション起動プロセスに対応するMCF通信構成定義では，このmcftbufコマンドは省略します。

オプション

●-g

（オペランド）

groupno=バッファグループ番号　〜〈符号なし整数〉((1〜512))

メッセージ送受信用，およびメッセージ編集用のバッファグループ番号を指定します。

バッファグループ番号は，ほかのmcftbufコマンドのgroupnoオペランドで指定するバッファグループ番号と通信プロセス単位で重複して指定できません。

length=バッファ長　〜〈符号なし整数〉((512〜1073741824))（単位：バイト）

メッセージ送受信用，およびメッセージ編集用のバッファ長を指定します。

詳細は，マニュアル「OpenTP1 プロトコル」の該当するプロトコル編の，mcftalccn定義コマンド（TP1/NET/UDPの場合はmcftalcle定義コマンド）の注意事項を参照してください。

count=バッファ数　〜〈符号なし整数〉((1〜65535))

メッセージ送受信用，およびメッセージ編集用のバッファ数を指定します。

詳細は，マニュアル「OpenTP1 プロトコル」の該当するプロトコル編の，mcftalccn定義コマンド（TP1/NET/UDPの場合はmcftalcle定義コマンド）の注意事項を参照してください。

なお，mcftlsbufコマンドに-mオプションを指定して実行すると，最大バッファ使用数を確認できます。mcftlsbufコマンドについては，マニュアル「OpenTP1 運用と操作」を参照してください。

extend=拡張バッファ数　〜〈符号なし整数〉((0〜65535))《0》

countオペランドで指定したバッファがいっぱいになった場合に拡張するバッファの数を指定します。

mcftpsvr

名称

アプリケーション起動環境定義の開始

形式

mcftpsvr  -c  内部通信路名
        〔-o  "reruntm=yes|no"〕

機能

アプリケーションプログラムの起動に関する環境を定義します。

オプション

●-c　内部通信路名

　〜〈1〜8文字の識別子〉

アプリケーション起動プロセスで使用する内部通信路名を指定します。

内部通信路とは，同一ノード内のアプリケーション間でメッセージを受け渡すための，仮想的な通信路のことです。

ほかのアプリケーション起動プロセスで使用する内部通信路名と重複しないように指定してください。重複している場合は，プロセスが異常終了します。

●-o

（オペランド）

reruntm=yes|no　〜《no》

リラン時のタイマ起動を引き継ぐかどうかを指定します。

タイムアウトが発生する前（指定した時間が過ぎる前）のタイマ起動要求が残った状態でOpenTP1のリランが発生した場合，タイマ起動要求を引き継ぐかどうかを指定してください。

タイムアウトが発生したあとのタイマ起動要求の場合，このオプション指定に該当しません。タイムアウトが発生したあとのタイマ起動要求は，このオプションの指定に関係なく引き継がれます。

yes

リラン時のタイマ起動を引き継ぎます。また，アプリケーション起動サービスのメイン関数でタイマ起動引き継ぎ決定UOCを組み込んだ場合，yesを指定してください。

なお，引き継ぎ対象となるのは，次の条件を満たしているアプリケーションです。

アプリケーション属性定義（mcfaalcap -g quekind）でdiskを指定している

内部通信路（mcfaalcap -n cname），または内部通信路上の論理端末（mcfaalcap -n lname）に対応するアプリケーション起動用論理端末定義（mcftalcle -k quekind）でdiskを指定している

no

リラン時のタイマ起動を引き継ぎません。すべてのタイマ起動を破棄します。

アプリケーション起動サービスのメイン関数で，タイマ起動引き継ぎ決定UOCを組み込んでも，noを指定した場合は，タイマ起動引き継ぎ決定UOCをコールしません。

mcftalcle

名称

アプリケーション起動用論理端末定義

形式

{{mcftalcle  -l  論理端末名称
             -t  send|request
           〔-m  "〔mmsgcnt=メモリ出力メッセージ最大格納数〕
                  〔dmsgcnt=ディスク出力メッセージ最大格納数〕"〕
           〔-k  "〔quekind=memory|disk〕
                  〔quegrpid=キューグループID〕"〕}}

機能

アプリケーション起動用の論理端末に関する環境を定義します。

エラーイベント処理用MHPおよびリトライ指示のロールバック要求のための論理端末は，MCFで自動的に生成します。ここで定義する必要はありません。アプリケーション起動機能を使用する場合は，論理端末を一つ以上定義する必要があります。

指定数に応じて静的共用メモリ，およびステータスファイルの容量を見積もる必要があります。静的共用メモリの見積もりは，「付録B.2　MCFサービス用の共用メモリの見積もり式」を参照してください。ステータスファイルの見積もりは，マニュアル「OpenTP1 運用と操作」の「ステータスファイルのサイズの見積もり式」の説明を参照してください。

オプション

●-l　論理端末名称

　〜〈1〜8文字の識別子〉

論理端末名称を指定します。

OpenTP1システム内で一意となる論理端末名称を指定してください。

●-t　send|request

この論理端末の端末タイプを指定します。

send

一方送信型論理端末

非応答型のアプリケーションを起動するとき，この端末タイプを使用します。

request

問い合わせ型論理端末

応答型のアプリケーションを起動するとき，この端末タイプを使用します。

●-m

（オペランド）

mmsgcnt=メモリ出力メッセージ最大格納数　〜〈符号なし整数〉((0〜65535))《0》

メモリで待ち合わせをする出力メッセージの最大格納数を指定します。

出力メッセージの待ち合わせ数が指定した最大数になると，それ以後UAPからの送信要求（SEND）はエラーリターンとなります。

0を指定，または指定を省略した場合，メモリで待ち合わせをする出力メッセージ数は指定可能な最大数（65535）になります。

dmsgcnt=ディスク出力メッセージ最大格納数　〜〈符号なし整数〉((0〜65535))《0》

ディスクで待ち合わせをする出力メッセージの最大格納数を指定します。

出力メッセージの待ち合わせ数が指定した最大数になると，それ以後UAPからの送信要求（SEND）はエラーリターンとなります。

0を指定，または指定を省略した場合，ディスクで待ち合わせをする出力メッセージ数は指定可能な最大数（65535）になります。

●-k

（オペランド）

quekind=memory|disk　〜《memory》

出力メッセージの割り当て先（メモリキューまたはディスクキュー）を指定します。

memory

メモリキューだけに割り当てます。

disk

ディスクキューおよびメモリキューに割り当てます。

diskを指定した場合，必ずquegrpidオペランドを指定してください。

quegrpid=キューグループID　〜〈1〜8文字の識別子〉

ディスクで待ち合わせをする出力メッセージに使用するキューグループIDを指定します。MCFマネジャ定義のmcfmqgidコマンドで指定するキューグループID（キューグループ種別はotq）のどれかを指定します。

このquegrpidオペランドは，quekindオペランドでdiskを指定した場合だけ指定します。

mcftped

名称

アプリケーション起動環境定義の終了

形式

mcftped

機能

アプリケーション起動環境定義の終了を示します。

オプション

なし。

MCFアプリケーション定義

MCFアプリケーション定義は，アプリケーションを定義し，その実行環境を設定するものです。一つのMCFアプリケーション定義に対し，一つのソースファイルを作成してください。

アプリケーションとは，一つの業務のことです。同じサービスでも，使用する通信サービスの違いによって，別々のアプリケーションとして定義できます。

MCFアプリケーション定義コマンドの指定順序を次の図に示します。

図5‒5　MCFアプリケーション定義コマンドの指定順序

アプリケーション属性定義を指定するとき，mcfaalcap定義コマンドの-Nオプションのmodelnameオペランドを使用すると，モデルとする定義の指定内容を流用できます。

このとき，モデルとするアプリケーション属性定義の一部だけを流用して，新しい定義を作成することもできます。例えば，アプリケーション名称「ex01」の属性定義の一部を流用してアプリケーション名称「ex02」の属性定義をする場合，次の図に示すように定義できます。

図5‒6　モデルアプリケーション属性定義の指定例

mcfaenv

名称

アプリケーション環境定義

形式

mcfaenv  -a  MCFアプリケーション定義識別子
       〔-p  アプリケーション起動プロセス識別子〕

機能

アプリケーションに関する環境を定義します。

オプション

●-a　MCFアプリケーション定義識別子

　〜〈1〜8文字の識別子〉

このMCFアプリケーション定義の識別子を指定します。

MCFアプリケーション定義識別子は，MCF起動時に表示されるMCFアプリケーション定義の識別子として使用します。

●-p　アプリケーション起動プロセス識別子

　〜〈数字（0〜9），a〜f〉((01〜ef))

このMCFアプリケーション定義に対応するアプリケーション起動プロセス識別子を指定します。ただし，次の場合に指定します。

アプリケーション起動機能を使用する場合

エラーイベントを起動する場合

リトライ指示のロールバック要求をする場合

アプリケーション起動プロセス識別子は，MCF通信構成定義のmcftenvコマンドの-sオプションで指定したものを指定します。

注意事項

このオプションに，MCF通信プロセス識別子を指定しないでください。指定した場合，エラーが発生します。

mcfaalcap

名称

アプリケーション属性定義

形式

mcfaalcap  -n  "  name=アプリケーション名|MCFイベント名
                〔kind=user|mcf〕
                〔type=ans|noans|cont〕
                〔aplihold=m|a|s〕
                〔msgcnt=入力メッセージ最大格納数〕
                〔lname=論理端末名称〕
                〔cname=内部通信路名〕
                〔tempsize=継続問い合わせ応答用一時記憶データ格納用
                           領域サイズ〕
                〔trnmode=trn|nontrn〕
                〔errevt=yes|no〕"
         〔-N  "  modelname=モデルアプリケーション名|モデルMCFイベント名"〕
           -g  "  servgrpn=サービスグループ名
                〔quegrpid=キューグループID〕
                〔quekind=memory|disk〕
                〔srvghold=m|s〕
                〔recvmsg=e|r〕"
           -v  "  servname=サービス名
                〔servhold=m|a|s〕
                〔ntmetim=非トランザクションMHP限界経過時間〕"
         〔-d  "〔holdlimit=アプリケーション異常終了限界回数〕
                〔holdlmtyp=sum|cont〕
                〔reschedulecnt=アプリケーション異常終了時の
                                再スケジュール回数〕
                〔rescheduleint=アプリケーション異常終了時の
                                再スケジュール間隔〕
                〔reschedulelog=yes|no〕"〕
         〔-j  "〔ij=yes|no〕
                〔oj=yes|no〕
                〔gj=yes|no〕"〕
         〔-e  "  evtlogout=yes|no"〕

機能

アプリケーションに関する属性を定義します。

指定数に応じて静的共用メモリの容量を見積もる必要があります。静的共用メモリの見積もりは，「付録B.2　MCFサービス用の共用メモリの見積もり式」を参照してください。

オプション

●-n

（オペランド）

name=アプリケーション名|MCFイベント名　〜〈1〜8文字の識別子〉

使用するアプリケーション名，またはMCFイベント名を指定します。

nameオペランドの指定値はkindオペランドで指定するアプリケーションの種別内で，ほかのmcfaalcapコマンドのnameオペランドの指定値とは異なる指定をします。

mcfuevtコマンドで直接MHPを起動したい場合は，UCMDEVTを指定してください。

ERREVT2の一部，およびERREVT3を起動する場合，アプリケーション起動プロセスが必要です。アプリケーション起動プロセス用のMCF通信構成定義を作成してください。

kind=user|mcf　〜《user》

アプリケーションの種別を指定します。

user

ユーザのアプリケーション

mcf

MCFイベント

nameオペランドにUCMDEVTを指定した場合は，userを指定するか，指定を省略してください。誤って指定すると，MCF定義オブジェクト生成ユティリティ起動コマンド（mcfapli）は，KFCA11513-Eメッセージを表示し，異常終了します。

type=ans|noans|cont　〜《noans》

アプリケーションの型を指定します。

ans：応答型

noans：非応答型

cont：継続問い合わせ応答型

nameオペランドでMCFイベント名を指定した場合，このtypeオペランドの指定は無効になります。

MCFはMCFイベントに対して次のように自動的に設定します。

次のMCFイベントの場合，要求元となった論理端末の端末タイプに応じて，reply型論理端末の場合はansを，reply型以外の論理端末の場合はnoansを設定します。

・不正アプリケーション名検出通知イベント（ERREVT1）

次のMCFイベントの場合，それを起動する要因となったアプリケーションの型をそのまま引き継ぎます。

・メッセージ廃棄通知イベント（ERREVT2）

・UAP異常終了通知イベント（ERREVT3）

・タイマ起動メッセージ廃棄通知イベント（ERREVT4）

上記以外のMCFイベントの場合は，noansを設定します。

異常が発生した場合，起動元通信プロセスに対応するMCFイベントが起動されます。アプリケーション起動機能を使用して複数のMCFアプリケーション定義を経由した場合も，最初の起動元通信プロセスに対応するMCFイベントが起動されます。

SPPからアプリケーションを起動し，起動元通信プロセスがない場合は，アプリケーション起動プロセスに対応するMCFイベントが起動されます。

mcfuevtコマンドで直接MHPを起動したい場合は，noansを指定するか，指定を省略してください。誤って指定すると，MCF定義オブジェクト生成ユティリティ起動コマンド（mcfapli）は，KFCA11513-Eメッセージを表示し，異常終了します。

aplihold=m|a|s　　〜《m》

アプリケーションが異常終了した場合のアプリケーションの処置を指定します。

m

アプリケーションを閉塞しません。

a

アプリケーションを閉塞します。入力およびスケジュールを禁止します。

s

アプリケーションを閉塞します。スケジュールを禁止します。

次の場合には，この定義の指定値に関係なく，アプリケーションを閉塞しません。

dc_mcf_rollback関数にDCMCFRTRYを指定（CBLDCMCF('ROLLBACK')にRTRYを指定）してロールバックした場合

アプリケーション属性定義（mcfaalcap）またはUAP共通定義（mcfmuap）のreschedulecntオペランドの指定値が1以上の場合に，MHPが異常終了したとき

アプリケーションに対応するサービス開始前にユーザサービスが異常終了した場合

msgcnt=入力メッセージ最大格納数　　〜〈符号なし整数〉((0〜65535))《0》

入力するメッセージの最大格納数を指定します。

0を指定した場合，メモリまたはディスクに入力するメッセージの数は無制限になります。

lname=論理端末名称　　〜〈1〜8文字の識別子〉

アプリケーション起動機能を使用するときの，内部通信路上の論理端末名称を指定します。-nオプションのtypeオペランドでnoansを指定した場合だけ指定できます。

この論理端末名称は，アプリケーション起動プロセスに対応するMCF通信構成定義の，mcftalcleコマンドで登録したものを指定します。ここでは，一方送信型論理端末を指定します。

ほかのアプリケーションからこのアプリケーションを起動するとき，ここで指定した論理端末を使用してメッセージが受け渡されます。

アプリケーション起動機能使用時の定義方法については，cnameオペランドの説明を参照してください。

cname=内部通信路名　　〜〈1〜8文字の識別子〉

アプリケーション起動機能を使用するときの，内部通信路名を指定します。ただし，typeオペランドでans，またはcontを指定したときだけ指定できます。

この内部通信路名は，MCF通信構成定義のmcftpsvrコマンドで登録したものを指定します。

ほかのアプリケーションからこのアプリケーションを起動するとき，ここで指定した内部通信路上の適当な問い合わせ型論理端末を使用して，メッセージが受け渡されます。論理端末定義で，一つ以上，問い合わせ型論理端末を定義しておく必要があります。

アプリケーション起動機能使用時の定義方法を次の表に示します。

表5‒1　アプリケーション起動機能使用時の定義方法

起動元のアプリケーションプログラム

起動先のアプリケーションプログラム

noans型MHP

ans型MHP

cont型MHP

noans型MHP

LNAME

×

×

ans型MHP

LNAME

CNAME

×

cont型MHP

LNAME

×

CNAME

SPP

LNAME

×

×

（凡例）

LNAME：起動先のmcfaalcap定義コマンドのlnameオペランドに，内部通信路上のsend型論理端末名称を指定します。

CNAME：起動先のmcfaalcap定義コマンドのcnameオペランドに，request型論理端末が一つ以上定義されている内部通信路名を指定します。

×：アプリケーション起動機能を使用できないため，指定できません。

tempsize=継続問い合わせ応答用一時記憶データ格納用領域サイズ　〜〈符号なし整数〉((1〜32000))《4096》（単位：バイト）

継続問い合わせ応答で使用する一時記憶データ格納用領域サイズを指定します。ただし，typeオペランドでcontを指定した場合だけ有効です。

指定値に応じて動的共用メモリの容量を見積もる必要があります。動的共用メモリの見積もりは，「付録B.2　MCFサービス用の共用メモリの見積もり式」を参照してください。

trnmode=trn|nontrn　〜《trn》

アプリケーションのトランザクション属性を指定します。

trn

MHPの処理をトランザクションとして管理します。

trnを指定した場合，該当MHPのユーザサービス定義のatomic_updateオペランドにYを指定してください。

nontrn

MHPの処理をトランザクションとして管理しません。

送受信にはメモリキューが使用されます。

errevt=yes|no　〜《no》

通信イベントの受信メッセージを破棄した場合，および通信イベント処理用MHPが異常終了した場合の，エラーイベント通知（通信イベント障害時のエラーイベント通知機能の使用）の有無を指定します。

yes

エラーイベントを通知します。

no

エラーイベントを通知しません。

このオペランドは，nameオペランドで通信イベントを指定した場合に有効になります。

nameオペランドにエラーイベント（ERREVT1，ERREVT2，ERREVT3，ERREVT4，ERREVTA）を指定した場合，このオペランドの指定は無効になります。また，-nオプションのkindオペランドを省略またはuserを指定した場合は指定できません。

●-N

（オペランド）

modelname=モデルアプリケーション名|モデルMCFイベント名　〜〈1〜8文字の識別子〉

このアプリケーション属性定義で使用する定義情報を持つ（モデルとする）アプリケーション属性定義のアプリケーション名，またはMCFイベント名を指定します。ただし，指定したアプリケーション名，またはMCFイベント名に対する，アプリケーション属性定義が先に定義されていなければなりません。

このオペランドを指定したときは，-nオプションのnameオペランド以外のオプション，またはオペランドを省略できます。

-nオプションのnameオペランド以外のオプション，またはオペランドを省略した場合，modelnameオペランドに指定したアプリケーション名，またはMCFイベント名の定義指定値がすべて流用されます。

アプリケーション属性定義に-Nオプション以外のオプション，またはオペランドを指定した場合は，指定したオプション，またはオペランドの指定値が適用されます。

このオペランドは2回以上指定できません。また，モデルとしたアプリケーション名，またはMCFイベント名と，-Nオプション以外に指定したオペランドの組み合わせによっては，相関チェックによってエラーになる場合があります。そのため，次に示すオペランドには，モデル定義と異なる指定をしないでください。

-nオプションのtypeオペランド

-gオプションのquekindオペランド

●-g

（オペランド）

servgrpn=サービスグループ名　〜〈1〜31文字の識別子〉

アプリケーション名に対応するサービスグループ名を指定します。

サービスグループ名は，ユーザサービス定義に指定してあるサービスグループ名を指定します。

指定したサービスグループの数に応じて静的共用メモリ，およびステータスファイルの容量を見積もる必要があります。静的共用メモリの見積もりは，「付録B.2　MCFサービス用の共用メモリの見積もり式」を参照してください。ステータスファイルの見積もりは，マニュアル「OpenTP1 運用と操作」の「ステータスファイルのサイズの見積もり式」の説明を参照してください。

quegrpid=キューグループID　〜〈1〜8文字の識別子〉

入力メッセージのキューグループIDを指定します。MCFマネジャ定義のmcfmqgidコマンドで指定するキューグループID（キュー種別はitq）のどれかを指定します。

このオペランドは，quekindオペランドでdiskを指定した場合だけ指定します。

注

一つのサービスグループに対して，異なるキューグループを定義することはできません。異なるキューグループを定義した場合，KFCA11008-Wメッセージが出力されます。一つのサービスグループに対して，異なるキューグループを定義しても，MCF開始時にすでに定義されたキューグループで登録し直します。

quekind=memory|disk　〜《memory》

入力メッセージの割り当て先（メモリキューまたはディスクキュー）を指定します。

memory

メモリキューに割り当てます。

disk

ディスクキューに割り当てます。

diskを指定した場合，必ずquegrpidオペランドを指定してください。

mcfuevtコマンドで直接MHPを起動する場合に，diskを指定すると，リラン後にUCMDEVTが再スケジュールされることがあります。

-nオプションのtrnmodeオペランドでnontrnを指定した場合，diskを指定できません。

srvghold=m|s　〜《m》

アプリケーションが異常終了した場合のサービスグループの処置を指定します。

m

サービスグループを閉塞しません。

s

サービスグループを閉塞します。スケジュールを禁止します。

次の場合には，この定義の指定値に関係なく，サービスグループを閉塞しません。

dc_mcf_rollback関数にDCMCFRTRYを指定（CBLDCMCF('ROLLBACK')にRTRYを指定）してロールバックした場合

アプリケーション属性定義（mcfaalcap）またはUAP共通定義（mcfmuap）のreschedulecntオペランドの指定値が1以上の場合に，MHPが異常終了したとき

アプリケーションに対応するサービス開始前にユーザサービスが異常終了した場合，この定義の指定値に関係なく，ユーザサービス定義またはユーザサービスデフォルト定義のholdオペランドおよびterm_watch_timeオペランドの指定値によって，サービスグループを閉塞するかどうかが決まります。

recvmsg=e|r　〜《e》

異常終了したUAPの受信メッセージの扱いを指定します。

このオペランドは，srvgholdオペランドでsを指定したサービスグループが閉塞されたときに有効となります。

e

処理途中のメッセージをエラーイベントに切り替えます。

r

自動閉塞時に処理途中のメッセージを，スケジュールキューの先頭に再登録し，スケジュール待ち状態にします。ただし，-gオプションのquekindオペランドでdiskを指定したときだけ有効です。memoryを指定した場合は，閉塞時に発生するERREVT2としてスケジュールします。

なお，このオペランドはスケジュールの順序性を保証するものではありません。

●-v

（オペランド）

servname=サービス名　〜〈1〜31文字の識別子〉

アプリケーション名に対応するサービス名を指定します。

サービス名は，ユーザサービス定義に指定してあるサービス名を指定します。

指定したサービスの数に応じて静的共用メモリの容量を見積もる必要があります。静的共用メモリの見積もりは，「付録B.2　MCFサービス用の共用メモリの見積もり式」を参照してください。

servhold=m|a|s　〜《m》

アプリケーションが異常終了した場合のサービスの処置を指定します。

m

サービスを閉塞しません。

a

サービスを閉塞します。入力およびスケジュールを禁止します。

s

サービスを閉塞します。スケジュールを禁止します。

次の場合には，この定義の指定値に関係なく，サービスを閉塞しません。

dc_mcf_rollback関数にDCMCFRTRYを指定（CBLDCMCF('ROLLBACK')にRTRYを指定）してロールバックした場合

アプリケーション属性定義（mcfaalcap）またはUAP共通定義（mcfmuap）のreschedulecntオペランドの指定値が1以上の場合に，MHPが異常終了したとき

アプリケーションに対応するサービス開始前にユーザサービスが異常終了した場合

ntmetim=非トランザクションMHP限界経過時間　〜〈符号なし整数〉((0〜65535))（単位：秒）

非トランザクションMHPの処理のループ，およびハングアップを監視するために，非トランザクションMHPの処理に掛かる限界経過時間を指定します。

0を指定した場合は，時間監視をしません。

指定時間を超えても非トランザクションMHPの処理が終了しない場合，非トランザクションMHPを異常終了します。

指定を省略した場合は，UAP共通定義（mcfmuap）の-uオプションに指定したntmetimオペランドの値を仮定します。

このオペランドは，-nオプションのtrnmodeオペランドでnontrnを指定したときに有効となります。

注意事項

サービス関数開始から終了までの実行監視時間の精度は秒単位です。そのため，タイミングによっては，このオペランドに指定した値よりも短い時間でプロセスを強制停止することがあります。サービス関数開始から終了までの実行監視時間が小さくなるほど，誤差の影響を受けやすくなりますので，このオペランドには3（単位：秒）以上の値の指定を推奨します。

●-d

（オペランド）

holdlimit=アプリケーション異常終了限界回数　〜〈符号なし整数〉((1〜65535))《1》（単位：回）

アプリケーションの異常終了限界回数を指定します。ここで指定した回数分の異常終了が起こると，そのアプリケーション，サービス，またはサービスグループを閉塞します。ただし，-nオプションのapliholdオペランドまたは-vオプションのservholdオペランドで，aまたはsを指定した場合，および-gオプションのsrvgholdオペランドでsを指定した場合だけ有効です。

-dオプションにreschedulecntオペランドを指定している場合，reschedulecntオペランドの指定値を超えるまでの異常終了回数は，ここで指定した回数に含まれません。また，dc_mcf_rollback関数にDCMCFRTRYを指定（CBLDCMCF('ROLLBACK')にRTRYを指定）して異常終了した場合も，アプリケーション異常終了限界回数にカウントしません。

holdlmtyp=sum|cont　〜《cont》

holdlimitオペランドを指定した場合のアプリケーション異常終了回数のカウント方法を指定します。

sum

アプリケーションが異常終了した累積回数をカウントします。

次に示すとき，カウントリセットします※。

mcfaactapコマンドを実行したとき

mcfaclcapコマンドを実行したとき

OpenTP1の終了／開始時

cont

アプリケーションが連続して異常終了した場合にカウントします。

次に示すとき，カウントリセットします※。

mcfaactapコマンドを実行したとき

mcfaclcapコマンドを実行したとき

MHPサービス関数が正常終了したとき

OpenTP1の終了／開始時

注※

dcsvstopコマンド，dcsvstartコマンド，mcftactsgコマンド，またはmcftactsvコマンドではカウント値はリセットされません。

reschedulecnt=アプリケーション異常終了時の再スケジュール回数　〜〈符号なし整数〉((0〜3))（単位：回）

トランザクション処理を実行しているMHPがサービス実行中に異常終了してロールバックした場合の，再スケジュール回数を指定します。

このオペランドに1〜3の値を指定すると，受信したメッセージを該当する入力キューの最後に格納し，異常終了したMHPを自動的にスケジュールし直します。

0を指定した場合は，再スケジュールしません。

指定を省略した場合は，UAP共通定義（mcfmuap）の-rオプションに指定したreschedulecntオペランドの値を仮定します。

指定した回数を超えてMHPが異常終了した場合，再スケジュールしません。この場合，KFCA11163-Eメッセージを出力し，エラーイベントを通知します。

なお，異常終了したMHPを再スケジュールするには，アプリケーション起動プロセスが必要です。アプリケーション起動プロセス用のMCF通信構成定義を作成してください。

また，指定した回数を超えるまでは，-dオプションのholdlimitオペランドで指定したアプリケーション異常終了回数をカウントしません。このため，アプリケーション，サービス，およびサービスグループは閉塞されません。

rescheduleint=アプリケーション異常終了時の再スケジュール間隔　〜〈符号なし整数〉((0〜3))（単位：秒）

異常終了してロールバックしたMHPを自動的に再スケジュールするまでの所要時間※に加算する時間を，秒単位で指定します。

指定を省略した場合は，UAP共通定義（mcfmuap）の-rオプションに指定したrescheduleintオペランドの値を仮定します。

この指定は，reschedulecntオペランドに1〜3の値を指定した場合に有効となります。

注※

異常終了したプロセス以外に空きプロセスが存在する場合，間隔を空けないで再スケジュールします。

異常終了したプロセス以外に空きプロセスが存在しない，かつユーザサービス定義，またはユーザサービスデフォルト定義のholdオペランドにYを指定した場合，再スケジュールするまでに最大10秒掛かります。

異常終了したプロセス以外に空きプロセスが存在しない，かつユーザサービス定義，またはユーザサービスデフォルト定義のholdオペランドにNを指定した場合，ユーザサービス定義，またはユーザサービスデフォルト定義のterm_watch_timeオペランドの指定時間内で，異常終了したMHPの3回目の再スケジュールに最大10秒掛かります。2回目までは間隔を空けないで再スケジュールします。

reschedulelog=yes｜no

異常終了してロールバックしたMHPを自動的に再スケジュールするときに，ログメッセージを出力するかどうかを指定します。

指定を省略した場合は，UAP共通定義（mcfmuap）の-rオプションに指定したreschedulelogオペランドの値を仮定します。

この指定は，reschedulecntオペランドに1〜3の値を指定した場合に有効となります。

yes

KFCA11810-Iメッセージを出力します。

no

KFCA11810-Iメッセージを出力しません。

●-j

（オペランド）

ij=yes|no　〜《no》

他システムから受信したメッセージを入力キューに登録する場合に，履歴情報（IJ）を取得するかどうかを指定します。

-nオプションのkindオペランドでmcfを指定した場合，ijオペランドの指定は無効になります。

入力キューを経由しない同期送受信関数（dc_mcf_sendrecv関数）による受信メッセージは，履歴情報の取得対象外になります。

yes

取得します。

no

取得しません。

oj=yes|no　〜《no》

UAPからのメッセージ送信要求時に，履歴情報（OJ）を取得するかどうかを指定します。

-nオプションのkindオペランドでmcfを指定した場合，ojオペランドの指定は無効になります。

出力キューを経由しない同期送受信関数（dc_mcf_sendrecv関数）による送信メッセージは，履歴情報の取得対象外になります。

yes

取得します。

no

取得しません。

gj=yes|no　〜《no》

UAPからのメッセージ受信要求時に，履歴情報（GJ）を取得するかどうかを指定します。

-nオプションのkindオペランドでmcfを指定した場合，gjオペランドの指定は無効になります。

yes

取得します。

no

取得しません。

●-e

（オペランド）

evtlogout=yes|no　〜《no》

ERREVT1〜ERREVT4を起動するとき，ログメッセージを出力するかどうかを指定します。

このオペランドは，-nオプションのkindオペランドでmcfを指定し，-nオプションのnameオペランドでERREVT1〜ERREVT4を指定した場合だけ有効です。

yes

ログメッセージを出力します。

ログメッセージとして，KFCA11194-Iメッセージとともに，次の内容が出力されます。

・MCF識別子

・エラーイベント名

・理由コード

・エラーイベント起動の原因となったアプリケーション名

KFCA11194-Iメッセージの詳細については，マニュアル「OpenTP1 メッセージ」を参照してください。

なお，trnmodeオペランドにtrnを指定した場合は，ユーザサービス定義のtrn_rollback_information_putオペランドでロールバック要因のログを取得するように指定することをお勧めします。ERREVT3の発生要因を調査する際に必要になることがあります。

no

ログメッセージを出力しません。

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

形式

set形式

〔set prf_file_count=MCF性能検証用トレース情報ファイルの世代数〕
〔set prf_file_size=MCF性能検証用トレース情報ファイルのサイズ〕
〔set prf_information_level=1|0〕

機能

MCF性能検証用トレース情報を取得する場合の実行環境を定義します。

説明

set形式のオペランド

●prf_file_count=MCF性能検証用トレース情報ファイルの世代数

　〜<符合なし整数>((3〜256))《3》

MCF性能検証用トレース情報ファイルの世代数を指定します。

値を小さくすると，新しい世代数の範囲で制御するため，範囲外のトレースファイルが使用されないで残ることになります。その場合は，必要に応じて範囲外のファイルを削除してください。

●prf_file_size=MCF性能検証用トレース情報ファイルのサイズ

　〜<符合なし整数>((1024〜1048576))《1024》（単位：キロバイト）

MCF性能検証用トレース情報ファイルのサイズを指定します。

トレース情報は，通常ファイルに出力します。このファイルはMCF性能検証用トレース定義のprf_file_countオペランドの指定値分の世代を用意し，すべての世代を使用したらオーバラップして上書きします。このため，ある程度時間が経つと古いトレース情報がなくなります。このオペランドの指定値を大きくすることで，ファイルを上書きする時間を延長できます。

トレースファイルの1ファイルサイズの算出式を，次に示します（単位：バイト）。

1ファイルサイズ=128＋（1トランザクションで必要なトレースデータ長※×実行トランザクション数）

注※

1トランザクションで必要なトレースデータ長は，マニュアル「OpenTP1 運用と操作」を参照して計算してください。

●prf_information_level=1|0

MCF性能検証用トレース関連のメッセージの表示レベルを指定します。

0

表示レベル0のMCF性能検証用トレース関連のメッセージ（警告および障害メッセージ）をsyslogに出力します。

1

表示レベル1以下のMCF性能検証用トレース関連のメッセージをsyslogに出力します。

MCF性能検証用トレース関連のメッセージと表示レベルの関係を次に示します。ここで指定を省略した場合，性能検証用トレース定義の値を仮定します。

メッセージ

表示レベル

KFCA26700-W

0

KFCA26705-W

0

KFCA26710-I

1

注意事項

この定義の使用は，TP1/Extension 1をインストールしていることが前提です。TP1/Extension 1をインストールしていない場合の動作は保証できませんので，ご了承ください。

システムサービス情報定義

MCFサービスはユーザが作るシステムサービスです。OpenTP1のシステムサービスと同じ位置づけになります。

システムサービス情報定義では，MCF通信サービスおよびアプリケーション起動サービスを起動するための環境を定義します。ユーザがMCFサービスを作成するときに定義する必要があります。

形式

set形式

  set module="MCF実行形式プログラム名"
〔set mcf_prf_trace=Y|N〕

機能

プロセスサービスがMCF通信サービスを起動するための環境を定義します。

各MCF通信サービスに対して一つ，システムサービス情報定義を作成できます。また，複数のMCF通信サービスで一つのシステムサービス情報定義を共用することもできます。

説明

set形式のオペランド

●module="MCF実行形式プログラム名"

　〜〈1〜8文字の識別子〉

MCF通信サービスを起動するための実行形式プログラム名を指定します。

MCF実行形式プログラムには，MCF通信プロセスのためのものとアプリケーション起動プロセスのためのものがあります。

MCF実行形式プログラムは，MCF通信プロセス同士，アプリケーション起動プロセス同士で共用できます。

MCF実行形式プログラム名には，先頭4文字が'mcfu'で始まる最大8文字の名称を指定します。

●mcf_prf_trace=Y|N

　〜《Y》

MCF通信サービスごとに，MCF性能検証用トレース情報を取得するかどうかを指定します。このオペランドの指定値を有効にするには，システムサービス共通情報定義のmcf_prf_trace_levelオペランドに00000001を指定してください。

Y

MCF性能検証用トレース情報を取得します。

N

MCF性能検証用トレース情報を取得しません。

MCF通信サービスでのMCF性能検証用トレース情報取得有無とオペランドの指定値の関係を，次の表に示します。

表5‒2　MCF通信サービスでのMCF性能検証用トレース情報の取得有無とオペランドの指定値の関係

システムサービス共通情報定義

mcf_prf_trace_levelオペランドの指定値

システムサービス情報定義

mcf_prf_traceオペランドの指定値

Y

N

00000000

取得しない

取得しない

00000001

取得する

取得しない

このオペランドの使用は，TP1/Extension 1をインストールしていることが前提です。TP1/Extension 1をインストールしていない場合の動作は保証できません。

システムサービス共通情報定義

システム構成によっては，システムサービス共通情報定義を指定する必要があります。システムサービス共通情報定義では，複数のMCF通信サービスに共通する情報を定義します。この定義ファイルは，標準値を定義した状態で製品に含まれています。必要に応じて，テキストエディタを使用して定義値を変更してください。

形式

set形式

  set max_socket_descriptors=ソケット用ファイル記述子の最大数
  set max_open_fds=MCF通信プロセスでアクセスするファイルの最大数
〔set thdlock_sleep_time=スレッド間で排他が競合した場合のスレッドの待ち時間〕
〔set mcf_prf_trace_level=MCF性能検証用トレース情報の取得レベル〕
〔set mcf_start_watch_interval=MCF開始時プロセス間監視時間間隔〕

putenv形式

〔putenv DCMCFQUEBAK MCF構成変更準備停止時のバックアップファイル名〕

機能

システムサービス共通情報定義では，複数のMCF通信サービスに共通する情報を定義します。この定義ファイルは，標準値を定義した状態で製品に含まれています。次に示すオペランドについては，必要に応じて，テキストエディタを使用して定義値を変更してください。ほかのオペランドについては，変更しないでください。

説明

set形式のオペランド

●max_socket_descriptors=ソケット用ファイル記述子の最大数

　〜〈符号なし整数〉((64〜3596))

各MCF通信プロセスでソケット用に使用するファイル記述子数の中の最大値を指定します。

OpenTP1制御下のプロセスでは，システムサーバやユーザサーバとの間で，ソケットを使用したTCP/IP通信でプロセス間の情報交換をしています。そのため，同時に稼働するUAPプロセスの数などによって，ソケット用のファイル記述子の最大数を変更する必要があります。

各MCF通信プロセスまたはアプリケーション起動プロセスが使用するソケット用ファイル記述子の最大数を求める計算式を次に示します。

↑（このMCF通信プロセスに対してメッセージ送信要求を行うUAPプロセス数※1
＋システムサービスプロセス数※2＋このMCF通信プロセスまたはアプリケーション起動プロセスに対して同時に処理要求を行う運用コマンド数）／0.8↑

（凡例）

↑↑：小数点以下を切り上げます。

注※1

アプリケーション起動プロセスに対するアプリケーション起動要求を行うUAPプロセス数も含みます。

注※2

システムサービスプロセス数とは，自OpenTP1内のシステムサービスプロセス数です。自OpenTP1内のシステムサービスプロセスは，rpcstatコマンドで表示されるサーバ名をカウントすることで求められます。rpcstatコマンドで表示されるサーバ名のうち，マニュアル「OpenTP1　解説」のOpenTP1のプロセス構造に記載されているシステムサービスプロセスをカウントしてください。

自OpenTP1内の各MCF通信プロセスおよびアプリケーション起動プロセスごとに計算し，その結果の中で最大値が64より大きい場合は，その値を指定します。64以下の場合は，64を指定します。

このオペランドの指定値が小さいと，OpenTP1制御下の他プロセスとのコネクションが設定できなくなるため，プロセスがKFCA00307-Eメッセージを出力して異常終了します。

マッピングサービス，およびオンラインコマンドサービスでは，このオペランドの指定に関係なくソケット用ファイル記述子の最大数は64です。

●max_open_fds=MCF通信プロセスでアクセスするファイルの最大数

　〜〈符号なし整数〉((500〜4032))《500》

各MCF通信プロセスでアクセスするファイル数の中の最大値を指定します。

MCF通信プロセスが行うメッセージの送受信にもファイル記述子が使われます。この数が不足すると，コネクションの確立ができないなどの障害が発生するため，事前に必要となるファイル記述子の数を設定しておく必要があります。

各MCF通信プロセスが使用するファイル記述子の最大数を求める計算式を次に示します。

（プロトコル制御で使用するファイル記述子数※1）
＋MCFメイン関数でユーザが使用するファイル記述子数
＋30※2

注※1

使用するプロトコル制御によって値が異なります。マニュアル「OpenTP1 プロトコル」の該当するプロトコル編を参照してください。

注※2

MCF通信プロセスが扱う定義ファイルなどの数の最大値です。

自OpenTP1内のMCF通信プロセスごとに計算し，その結果の中で最大値が500より大きい場合は，その値を指定します。500以下の場合は，500を指定します。指定値を超えてファイルのアクセスが発生した場合，その超過分はソケット用ファイル記述子使用数として扱われます。この場合，「max_socket_descriptorsオペランドの指定値−max_open_fdsオペランドの指定値の超過分」が，実際のソケット用ファイル記述子の最大数になりますので，ご注意ください。

max_socket_descriptorsオペランドとmax_open_fdsオペランドには次の条件を満たす値を指定してください。

（「max_socket_descriptorsオペランドの指定値」＋「max_open_fdsオペランドの指定値」）≦4096

TP1/NET/TCP/IPのMCF通信プロセス以外のプロセスで，max_socket_descriptorsオペランドとmax_open_fdsオペランドの和が1プロセスで使用できるファイル記述子の最大数を超えている場合，各プロセスで使用できるファイル記述子数は，4096よりも小さい値に強制的に補正されます。

1プロセスで使用できるファイル記述子の最大数を次の表に示します。

プロセス

OS

1プロセスで使用できるファイル記述子の最大数

TP1/NET/TCP/IPのMCF通信プロセス

すべて

4096

上記以外

AIX，HP-UX，Windows

2048

Linux，Solaris

1024

max_socket_descriptorsオペランドとmax_open_fdsオペランドの和が1プロセス当たりでオープンできるファイル数の物理限界値（ハードリミット）を超えていたとき，MCFの開始を中断します。

●thdlock_sleep_time=スレッド間で排他が競合した場合のスレッドの待ち時間

　〜〈符号なし整数〉((1〜32767))（単位：ミリ秒）

MCF通信プロセスが内部で用いる排他制御関数が，スレッド間で排他の競合が発生したため排他を獲得できなかった場合のスレッドの待ち時間を，ミリ秒単位で指定します。

指定を省略した場合は，システム共通定義のthdlock_sleep_timeオペランドの値を仮定します。

このオペランドの詳細については，システム共通定義のthdlock_sleep_timeオペランドの説明を参照してください。

●mcf_prf_trace_level=MCF性能検証用トレース情報の取得レベル

　〜((00000000〜00000001))《00000001》

MCF性能検証用トレース情報の取得レベルを指定します。MCF性能検証用トレースを取得する場合は，システム共通定義のprf_traceオペランドにYを指定するか，または省略してください。

00000000

MCF性能検証用トレース情報を取得しません。

00000001

MCF性能検証用トレース情報（イベントID：0xa000〜0xa0ff）を取得します。イベントIDの詳細については，マニュアル「OpenTP1 運用と操作」を参照してください。また，プロトコル固有の出力情報や取得タイミングについては，マニュアル「OpenTP1 プロトコル」の該当するプロトコル編を参照してください。

オペランドの指定に誤りがある場合は，OpenTP1開始処理中にOpenTP1が異常終了します。

このオペランドの使用は，TP1/Extension 1をインストールしていることが前提です。TP1/Extension 1をインストールしていない場合の動作は保証できません。

●mcf_start_watch_interval=MCF開始時プロセス間監視時間間隔

　〜〈符号なし整数〉((10〜3000))《3000》（単位：ミリ秒）

OpenTP1の正常開始または再開始で，MCFのプロセス間で互いの状態を監視する際の時間間隔を指定します。

注意事項

このオペランドの指定値を小さくすると，MCFの各プロセスの状態の変化を早期に検出できるため，OpenTP1の正常開始または再開始の所要時間を短縮できることがあります。

このオペランドの指定値が小さ過ぎると，OpenTP1の正常開始または再開始時にCPUが高負荷状態になることがあります。その場合はこのオペランドの指定値を大きくしてください。

putenv形式のオペランド

●DCMCFQUEBAK MCF構成変更準備停止時のバックアップファイル名

　〜〈パス名〉《$DCDIR/spool/mcf/mcfquebak》

MCF構成変更準備停止による終了中に作成するバックアップファイルの，絶対パス名を255バイト以内で指定します。

このオペランドは，再開始時に変更できます。MCF構成変更準備停止を実行する前にこのオペランドを変更しても，MCF構成変更準備停止時のバックアップファイルの格納先は変わりません。

このオペランドに$DCDIR/spool/mcf/mcfquebak以外の値を指定する場合，$DCDIR/spool配下を指定しないでください。指定した場合，dccspoolコマンドによって，MCF構成変更準備停止時のバックアップファイルが削除されることがあります。

6　マルチOpenTP1システムの定義

マルチOpenTP1システムの定義について説明します。

6.1　定義のしかた

一つのマシン上で複数のOpenTP1システムが，互いに独立して動作するシステムをマルチOpenTP1システムといいます。

マルチOpenTP1システムでは，異なるOpenTP1システムごとに異なるパーティション，または異なるファイルをOpenTP1ファイルシステム用に割り当てます。

定義ファイル格納ディレクトリを，OpenTP1システムごとに異なったディレクトリとして作成します。

それぞれのディレクトリ下に各OpenTP1システムの定義ファイルを作成します。

ただし，OpenTP1システム間で，定義内容を重複して指定できません。

OpenTP1システムごとに異なる必要がある定義内容を次の表に示します。

ディレクトリなどの詳細は，マニュアル「OpenTP1 運用と操作」を参照してください。

表6‒1　OpenTP1システムごとに異なる必要がある定義内容

項番

定義ファイル名

定義名

内容

1

システム共通定義

name_port

ネームサービスのウェルノウンポートの番号

system_id

OpenTP1識別子

all_node

OpenTP1システムのすべてのノード名およびネームサービスのウェルノウンポート番号※

prc_port

マルチノード連携制御機能で使うポート番号

2

ステータスサービス定義

sts_file_name

ステータスファイルの物理ファイルのパス名

3

ジャーナル関係定義

システムジャーナルサービス定義

チェックポイントダンプサービス定義

アーカイブジャーナルサービス定義

jnladdpf

ジャーナル関係ファイルの物理ファイルのパス名

4

DAMサービス定義

damfile

DAMファイルの物理ファイルのパス名

5

TAMサービス定義

tamtable

TAMテーブルの物理ファイルのパス名

6

メッセージキューサービス定義

quegrp

キューファイルの物理ファイルのパス名

注※

ノード名に，自ホストを示すホスト名（またはIPアドレス）を指定する場合に，ポート番号が重複しないようにしてください。

マルチOpenTP1システム環境で，各OpenTP1間でリモートプロシジャコールを行う場合には，各OpenTP1ノードのシステム共通定義で，all_nodeオペランドに自ノード以外のOpenTP1ノードのホスト名を定義した上で，rpc_multi_tp1_in_same_hostオペランドにYを指定してください。

7　OpenTP1システムの定義の変更

OpenTP1システムの定義の変更方法について説明します。

7.1　定義の変更手順

定義内容を変更する場合は，OpenTP1システムを正常終了させてから行ってください。定義内容の変更後は，OpenTP1の正常開始から始めます。

ただし，ユーザサービス定義については，OpenTP1システムを正常終了させなくても，ユーザサーバを正常終了させることで定義内容を変更できます。ユーザサービスデフォルト定義については，OpenTP1システムを正常終了させてから定義内容を変更してください。

また，次に示すどれかの定義を変更する場合は，注意が必要です。

システム環境定義

システム共通定義

プロセスサービス定義

次に示す手順で定義内容を変更してください。

OpenTP1を正常終了させます。

定義内容を変更します。

次に示すどれかの方法で，定義内容の変更を反映します。※

dcresetコマンドを入力します。

dcsetup -dコマンドを入力してから，再度dcsetupコマンドを入力して，OpenTP1をOSに登録します。

マシンをリブートします。

注※

Windows版OpenTP1では，3.の手順は不要です。

各コマンドの使用方法については，マニュアル「OpenTP1 運用と操作」を参照してください。

OpenTP1を正常開始させます。

定義内容を変更する場合の注意事項を次に示します。

システム環境定義のmode_confオペランドにAUTOが指定されている場合，dcresetコマンドを実行するとOpenTP1が自動開始します。

OpenTP1システムが再開始する場合でも，変更できるシステムサービス定義があります。システムの再開始時に変更できる定義については，「7.2　再開始時に変更できる定義」を参照してください。

定義内容は，OpenTP1システムへの影響について十分検討してから変更してください。

ネットワークコミュニケーション定義の定義内容を変更する場合には，ユティリティを使用して定義オブジェクトファイルを再生成する必要があります。定義オブジェクトファイルの生成方法については，「4.3　定義オブジェクトファイルの生成」を参照してください。

7.2　再開始時に変更できる定義

OpenTP1システム再開始時に変更できるシステムサービス定義の一覧を次の表に示します。そのほかの定義の指定値は変更できません。

表7‒1　再開始時に変更できるシステムサービス定義の一覧

項番

定義名

オペランド名または定義コマンド名

変更方法

1

システム環境定義

mode_conf

○

static_shmpool_size

○※1

dynamic_shmpool_size

○※1

shmpool_attribute

○

user_command

○

dcstart_wakeup_retry_count

○（dcstart実行前の場合）

dcstart_wakeup_retry_interval

○（dcstart実行前の場合）

putenv DCCONFPATH

○

putenv DCUAPCONFPATH

○

dcputenv DCCONFPATH

○

dcputenv DCUAPCONFPATH

○

2

システム共通定義

all_node

■

nam_prf_trace_level

○

fil_prf_trace_option

○

fil_prf_trace_delay_time

○

jnl_prf_event_trace_level

○

name_service_mode

○

name_manager_node

■

name_remove_down_node

○

name_node_add_policy

○

3

ロックサービス定義

lck_prf_trace_level

○

4

ネームサービス定義

name_total_size

●

name_cache_size

○

name_nodeid_check_message

○

name_cache_validity_time

○

name_start_watch_time

○

name_start_retry_count

○

name_start_retry_interval

○

name_start_error

○

name_sync_ready_time

○

namnlfil

○

5

プロセスサービス定義

prc_process_count

○

prc_recovery_resident

○

prc_take_over_svpath

○

prc_take_over_dlpath

○

prcsvpath

○

6

スケジュールサービス定義

scd_hold_recovery_count

○（ただし，0からの変更，または0への変更の場合だけです）

scd_hold_recovery

○

7

ステータスサービス定義

sts_initial_error_switch

○

sts_single_operation_switch

○

sts_last_active_file

○

sts_last_active_side

○

8

ジャーナルサービス定義

jnl_watch_time

○

jnl_message_id_change_level

○

9

システムジャーナルサービス定義

jnl_cdinterval

○

jnl_rerun_swap

○

jnl_arc_terminate_check

○

jnl_auto_unload

○

jnl_auto_unload_path

○

jnladdfg

△

jnladdpf

△

10

チェックポイントダンプサービス定義

cpd_message_id_change_level

○

11

ログサービス定義

log_filesize

○

log_msg_console

○

log_msg_allno

○

log_msg_prcid

○

log_msg_prcno

○

log_msg_sysid

○

log_msg_date

○

log_msg_time

○

log_msg_hostname

○

log_msg_pgmid

○

log_audit_out

○

log_audit_path

○

log_audit_size

○

log_audit_count

○

log_audit_message

○

putenv TZ

○

12

トランザクションサービス定義

trn_rm_open_close_scope

○

trn_optimum_item

○

trn_processing_in_rm_error

○

trn_recovery_list_remove

○

trn_recovery_list_remove_level

○

trn_watch_time

○

trn_rollback_information_put

○

trn_limit_time

○

trn_rollback_response_receive

○

trn_partial_recovery_type

○

max_socket_descriptors

○

trn_recovery_failmsg_interval

○

trn_wait_rm_open

○

trn_retry_interval_rm_open

○

trn_retry_count_rm_open

○

thread_stack_size

○

polling_control_data

○

groups

○

trn_xa_commit_error

○

trn_prf_event_trace_level

○

trn_prf_event_trace_condition

○

watch_time

○

thread_yield_interval

○

trn_start_recovery_mode

○

trn_start_recovery_watch_time

○

trn_start_recovery_interval

○

trn_extend_function

○

trnstring -m

○

trnstring -r

○

putenv

○※2

dcputenv

○※2

13

XAリソースサービス定義

xar_eventtrace_level

○

xar_eventtrace_record

○

xar_session_time

○

xar_prf_trace_level

○

xarfile

○

14

グローバルアーカイブジャーナルサービス定義

jnl_watch_time

○

15

アーカイブジャーナルサービス定義

jnl_rerun_swap

○

jnladdfg

△

jnladdpf

△

16

ユーザサービスネットワーク定義

dcsvgdef

○

17

rapリスナーサービス定義

rap_listen_port

○

rap_parallel_server

○

rap_watch_time

○

rap_inquire_time

○

nice

○

uap_trace_max

○

uid

○

rpc_response_statistics

○

rpc_trace

○

rpc_trace_name

○

rpc_trace_size

○

trn_expiration_time

○

trn_expiration_time_suspend

○

trn_cpu_time

○

trf_put

○

trn_statistics_item

○

trn_optimum_item

○

trn_watch_time

○

trn_rollback_information_put

○

trn_limit_time

○

trn_rollback_response_receive

○

trn_partial_recovery_type

○

rap_inquire_timeout_message

○

rap_connection_assign_type

○

rap_max_client

○

rap_notify

○

rap_client_manager_node

○

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

○

rap_msg_output_interval

○

rap_recovery_server

○

rap_connect_interval

○

rpc_extend_function

○

max_socket_descriptors

○

trn_completion_limit_time

○

rap_message_id_change_level

○

rap_term_disconnect_time

○

rap_stay_watch_time

○

rap_stay_warning_interval

○

log_audit_out_suppress

○

log_audit_message

○

ipc_sockctl_highwater

○

ipc_sockctl_watchtime

○

watch_time

○

18

rapクライアントマネジャサービス定義

rap_client_manager_port

○

rap_listen_inf

○

uid

○

log_audit_out_suppress

○

log_audit_message

○

rap_watch_time

○

19

性能検証用トレース定義

prf_file_size

○

prf_information_level

○

prf_file_count

○※3

prf_trace_backup

○

20

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

prf_file_size

○

prf_information_level

○

prf_file_count

○※3

21

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

prf_file_size

○

prf_file_count

○※3

prf_trace_backup

○

22

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

prf_file_size

○

prf_information_level

○

prf_file_count

○※3

23

リアルタイム統計情報サービス定義

rts_trcput_interval

○

rts_service_max

○※4

rts_item_max

○※4

rts_log_file

○

rts_log_file_name

○

rts_log_file_size

○

rts_log_file_count

○

rts_log_file_backup

○

rts_swap_message

○

rtsput

○

24

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

watch_next_chain_time

○

max_socket_msg

○

max_socket_msglen

○

rpc_response_statistics

○

rpc_service_retry_count

○

rpc_extend_function

○

max_socket_descriptors

○

max_open_fds

○

watch_time

○

rpc_destination_mode

○

rpc_rap_auto_connect

○

rpc_rap_inquire_time

○

rpc_request_cancel_for_timedout

○

service_expiration_time

○

ipc_sockctl_highwater

○

ipc_sockctl_watchtime

○

ipc_conn_interval

○

ipc_send_interval

○

ipc_send_count

○

ipc_header_recv_time

○

rpc_send_retry_count

○

rpc_send_retry_interval

○

ipc_recvbuf_size

○

ipc_sendbuf_size

○

thread_yield_interval

○

ipc_backlog_count

○

rpc_buffer_pool_max

○

message_buflen

○

message_store_buflen

○

trn_expiration_time

○

trn_limit_time

○

trn_cpu_time

○

trn_completion_limit_time

○

rap_autoconnect_con_error_msg

○

rap_message_id_change_level

○

log_audit_out_suppress

○

log_audit_message

○

mcf_prf_trace

○

scdsvcdef

○

stack_size_unlimited

○

25

ユーザサービス定義

watch_next_chain_time

○

uid

○

max_socket_msg

○

max_socket_msglen

○

rpc_response_statistics

○

rpc_service_retry_count

○

rpc_extend_function

○

max_socket_descriptors

○

max_open_fds

○

watch_time

○

rpc_destination_mode

○

rpc_rap_auto_connect

○

rpc_rap_inquire_time

○

rpc_request_cancel_for_timedout

○

service_expiration_tim

○

ipc_sockctl_highwater

○

ipc_sockctl_watchtime

○

ipc_conn_interval

○

ipc_send_interval

○

ipc_send_count

○

ipc_header_recv_time

○

rpc_send_retry_count

○

rpc_send_retry_interval

○

ipc_recvbuf_size

○

ipc_sendbuf_size

○

thread_yield_interval

○

ipc_backlog_count

○

rpc_buffer_pool_max

○

message_buflen

○

message_store_buflen

○

trn_expiration_time

○

trn_limit_time

○

trn_cpu_time

○

trn_completion_limit_time

○

rap_autoconnect_con_error_msg

○

rap_message_id_change_level

○

log_audit_out_suppress

○

log_audit_message

○

mcf_prf_trace

○

scdsvcdef

○

stack_size_unlimited

○

putenv

○

dcputenv

○

26

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

prf_file_size

○

prf_file_count

○

27

システムサービス情報定義

mcf_prf_trace

○

28

システムサービス共通情報定義

mcf_prf_trace_level

○

mcf_start_watch_interval

○

（凡例）

○：値を変更できます。

△：追加だけできます。変更，削除はできません。

■：値を変更できます。ただし，再開始時に実際にある値を指定してください。

●：値を変更できます。ただし，指定する値はシステムサービスとユーザサーバで登録するサービス情報の数を基に，計算して求めてください。

注※1

メモリサイズを小さくすると，再起動できない場合があります。

注※2

変更できる環境変数名および環境変数値については，リソースマネジャの仕様書を参照してください。

注※3

値を小さくすると，新しい世代数の範囲で制御するため，範囲外のトレースファイルが使用されないで残ることになります。その場合は，必要に応じて範囲外のファイルを削除してください。

注※4

値を大きくすると，リアルタイム統計情報サービスが開始できない場合があります。

7.3　OpenTP1システムの変更に影響する定義

OpenTP1システムの変更に伴って見直す必要のある定義およびOpenTP1ファイルについて説明します。

7.3.1　ユーザサーバの追加

ユーザサーバを追加する場合，ユーザサービス定義を新規に追加してください。

ユーザサーバを追加する場合に見直す必要のある定義の一覧，および再見積もりが発生する条件を次の表に示します。

表7‒2　ユーザサーバを追加する場合に見直しが必要な定義の一覧

定義ファイル名

定義

再見積もりが発生する条件

betranrc

jnl

nam

prc

scd

trn

max_socket_descriptors

無条件に再見積もりが必要

cltsrv

cup_parallel_count

TP1/Client/PまたはTP1/Client/Wから常設コネクション経由のRPCを受信する場合

parallel_count

TP1/Client/PまたはTP1/Client/WからトランザクショナルRPCを受信する場合

dam

dam_cache_size

DAMファイルにアクセスする場合

dam_cache_size_fix

DAMファイルにアクセスする場合

dam_tran_process_count

DAMファイルにアクセスする場合

env

dynamic_shmpool_size

次に示すどちらかの条件の場合，再見積もりが必要

DAMファイルまたはTP1/Message QueueもしくはMCFのキューファイルにアクセスする場合

MCF通信プロセスに対してメッセージ送信または受信を行うUAP数が増える場合

server_count

無条件に再見積もりが必要

static_shmpool_size

無条件に再見積もりが必要

lck

lck_limit_fordam

DAMファイルにアクセスする場合

lck_limit_formqa

TP1/Message Queueファイルにアクセスする場合

lck_limit_fortam

TAMファイルにアクセスする場合

lck_limit_foruser

dc_lck_get関数を使用する場合

nam

name_cache_size

次に示すどちらかの条件の場合，再見積もりが必要

parallel_countオペランドの変更を行うユーザサーバがSPPの場合

all_nodeオペランドに他ノードを設定している場合は，他ノードのname_cache_sizeオペランドの再見積もりが必要

name_total_size

parallel_countオペランドの変更を行うユーザサーバがSPPの場合

prc

prc_process_count

無条件に再見積もりが必要

scd

scd_server_count

SPPまたはMHPの場合

scd_hold_recovery_count

追加するユーザサーバについて閉塞状態を引き継ぐ場合

scdbufgrp

スケジュールバッファグループを利用する場合

scdmulti

マルチスケジューラ経由のRPCコールを受信する場合

tam

tam_max_trnnum

TAMファイルにアクセスする場合

tim

tim_watch_count

次に示すどれかの条件の場合，再見積もりが必要

service_expiration_timeオペランドの監視対象

trn_completion_limit_timeオペランドの監視対象

非トランザクションMHP限界経過時間が監視対象

trn_expiration_timeオペランドの監視対象

trn

trn_max_subordinate_count

トランザクション処理を行う場合

trn_tran_process_count

トランザクション処理を行う場合

usrrc

ユーザサービス定義

message_store_buflen

追加するユーザサーバがRPCコールをする場合，RPCコール先のユーザサーバのmessage_store_buflenオペランドの再見積もりが必要

ユーザサービス定義

max_socket_descriptors

追加するユーザサーバが他ノードのユーザサーバとRPCコールで通信する場合，他ノードのユーザサーバのmax_socket_descriptorsオペランドの再見積もりが必要

$DCDIR/lib/sysconf/mcf

max_socket_descriptors

MCF通信プロセスに対してメッセージ送信要求を行うUAP数，および同時に処理要求を行う運用コマンド数が増える場合

MCFマネジャ共通定義

mcfmcomn -p

MHPを追加する場合，再見積もりが必要

増分はシステム環境定義（env）のstatic_shmpool_sizeオペランドに加算

拡張予約定義

mcfmexp -g

拡張予約定義を定義していて新たなMHPのサービスグループを追加する場合

状態引き継ぎ定義

mcfmsts -g

状態を引き継ぐサービスグループが増える場合

mcfmsts -v

状態を引き継ぐサービスが増える場合

mcftsts -a

状態を引き継ぐMHPが増える場合

アプリケーション起動用論理端末定義

mcftalcle -m

アプリケーション起動を行うユーザサーバを追加する場合

見直す必要のあるOpenTP1ファイルの一覧，および再見積もりが発生する条件を次の表に示します。

表7‒3　ユーザサーバを追加する場合に見直しが必要なOpenTP1ファイルの一覧

OpenTP1ファイル

再見積もりが発生する条件

ステータスファイル

無条件に再見積もりが必要

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

次に示すどちらかの条件の場合，再見積もりが必要

トランザクション処理を行う場合

統計情報を取得する場合

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

トランザクション処理を行う場合

XARファイル

トランザクション処理を行い，かつXAリソースサービス機能を使用している場合

7.3.2　ユーザサーバの多重度の変更

ユーザサーバの多重度を変更する場合，ユーザサービス定義のparallel_countオペランドの指定の変更が必要です。

この場合に見直す必要のある定義の一覧，および再見積もりが発生する条件を次の表に示します。

表7‒4　ユーザサーバの多重度を変更する場合に見直しが必要な定義の一覧

定義ファイル名

定義

再見積もりが発生する条件

betranrc

jnl

nam

prc

scd

trn

max_socket_descriptors

無条件に再見積もりが必要

cltsrv

cup_parallel_count

クライアントとなるユーザサーバを増やし，TP1/Client/PまたはTP1/Client/Wから常設コネクション経由のRPCを受信する場合

parallel_count

クライアントとなるユーザサーバを増やし，TP1/Client/PまたはTP1/Client/WからトランザクショナルRPCを受信する場合

rapリスナーサービス定義

rap_parallel_server

クライアントとなるユーザサーバを増やし，rapクライアントからの要求を代理実行する場合

dam

dam_cache_size

DAMファイルにアクセスする場合

dam_cache_size_fix

DAMファイルにアクセスする場合

dam_tran_process_count

DAMファイルにアクセスする場合

env

dynamic_shmpool_size

次に示すどちらかの条件の場合，再見積もりが必要

DAMファイルまたはTP1/Message QueueもしくはMCFのキューファイルにアクセスする場合

MCF通信プロセスに対してメッセージ送信または受信を行うUAP数が増える場合

static_shmpool_size

無条件に再見積もりが必要

lck

lck_limit_fordam

DAMファイルにアクセスする場合

lck_limit_formqa

TP1/Message Queueファイルにアクセスする場合

lck_limit_fortam

TAMファイルにアクセスする場合

lck_limit_foruser

dc_lck_get関数を使用する場合

prc

prc_process_count

無条件に再見積もりが必要

scd

scd_hold_recovery_count

多重度を変更するユーザサーバについて閉塞状態を引き継ぐ場合

scdbufgrp

スケジュールバッファグループを利用する場合

scdmulti

マルチスケジューラ経由のRPCコールを受信する場合

scdsvcdef -p

scdsvcdef定義コマンドの-pオプションを指定している場合

tam

tam_max_trnnum

TAMファイルにアクセスする場合

tim

tim_watch_count

次に示すどれかの条件の場合，再見積もりが必要

service_expiration_timeオペランドの監視対象

trn_completion_limit_timeオペランドの監視対象

非トランザクションMHP限界経過時間が監視対象

trn_expiration_timeオペランドの監視対象

trn

trn_max_subordinate_count

トランザクション処理を行う場合

trn_tran_process_count

トランザクション処理を行う場合

usrrc

ユーザサービス定義

message_store_buflen

追加するユーザサーバがRPCコールをする場合，RPCコール先のユーザサーバのmessage_store_buflenオペランドの再見積もりが必要

ユーザサービス定義

max_socket_descriptors

追加するユーザサーバが他ノードのユーザサーバとRPCコールで通信する場合，他ノードのユーザサーバのmax_socket_descriptorsオペランドの再見積もりが必要

$DCDIR/lib/sysconf/mcf

max_socket_descriptors

MCF通信プロセスに対してメッセージ送信要求を行うUAP数，および同時に処理要求を行う運用コマンド数が増える場合

MCFマネジャ共通定義

mcfmcomn -p

出力キューに滞留するメッセージが増える場合，再見積もりが必要

増分はシステム環境定義（env）のstatic_shmpool_sizeオペランドに加算する

見直す必要のあるOpenTP1ファイルの一覧，および再見積もりが発生する条件を次の表に示します。

表7‒5　ユーザサーバの多重度を変更する場合に見直しが必要なOpenTP1ファイルの一覧

OpenTP1ファイル

再見積もりが発生する条件

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

次に示すどちらかの条件の場合，再見積もりが必要

トランザクション処理を行う場合

統計情報を取得する場合

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

トランザクション処理を行う場合

XARファイル

トランザクション処理を行い，かつXAリソースサービス機能を使用している場合

7.3.3　ノードの追加

ノードを追加する場合，次の作業が必要です。

システム共通定義のall_nodeオペランドの変更

ただし，ノード自動追加機能を使用している場合は不要です。

ドメイン定義ファイルの変更

この場合に見直す必要のある定義の一覧，および再見積もりが発生する条件を次の表に示します。

表7‒6　ノードを追加する場合に見直しが必要な定義の一覧

定義ファイル名

定義

再見積もりが発生する条件

betranrc

all_node_extend_number

無条件に再見積もりが必要

env

static_shmpool_size

無条件に再見積もりが必要

ist

ist_node

ISTテーブルにアクセスする場合，見直しが必要

jnl

max_socket_descriptors

グローバルアーカイブジャーナル機能を使用している場合

nam

scd

trn

ユーザサービス定義

max_socket_descriptors

無条件に再見積もりが必要

nam

name_cache_size

無条件に再見積もりが必要

name_total_size

無条件に再見積もりが必要

7.3.4　ジャーナルファイルグループの追加

ジャーナルファイルグループを追加する場合，次の作業が必要です。

システムジャーナルサービス定義ファイルのjnladdfg定義コマンドの変更

システムジャーナルサービス定義ファイルのjnladdpf定義コマンドの変更

この場合に見直す必要のある定義の一覧，および再見積もりが発生する条件を次の表に示します。

表7‒7　ジャーナルファイルグループを追加する場合に見直しが必要な定義の一覧

定義ファイル名

定義

再見積もりが発生する条件

env

static_shmpool_size

無条件に再見積もりが必要

見直す必要のあるOpenTP1ファイルの一覧，および再見積もりが発生する条件を次の表に示します。

表7‒8　ジャーナルファイルグループを追加する場合に見直しが必要なOpenTP1ファイルの一覧

OpenTP1ファイル

再見積もりが発生する条件

ステータスファイル

無条件に再見積もりが必要

7.3.5　ホスト名またはIPアドレスの変更

ホスト名またはIPアドレスを変更する場合に，見直しが必要な定義と，変更手順について説明します。

(1)　ホスト名またはIPアドレスを変更する場合に見直しが必要な定義

ホスト名またはIPアドレスを変更する場合，見直す必要のある定義の一覧と発生する条件を次の表に示します。

注意事項

自ノードおよび他ノードともに変更前のホスト名称，IPアドレスを指定している個所があればすべて見直しが必要です。

表7‒9　ホスト名またはIPアドレスを変更する場合に見直しが必要な定義の一覧

定義ファイル名

定義

見直しが必要な条件

betranrc

all_node

ノード自動追加機能を使用していない場合，見直しが必要

all_node_ex

無条件に見直しが必要

dcbindht -h

無条件に見直しが必要

my_host

無条件に見直しが必要

name_manager_node

ノード自動追加機能を使用している場合，見直しが必要

nodeaddr

dcprcport -h

TP1/Multiを使用している場合，見直しが必要

usrnet

dcsvgdef -h

無条件に見直しが必要

rapクライアントマネジャサービス定義

rap_listen_inf

無条件に見直しが必要

rapリスナーサービス定義

rap_client_manager_node

無条件に見直しが必要

ドメイン定義ファイル

−

name_domain_file_useオペランドにYを指定している場合，見直しが必要

（凡例）

−：該当しません。

TP1/Message QueueまたはMCFを使用している場合は，それぞれマニュアル「TP1/Message Queue 使用の手引」またはマニュアル「OpenTP1 プロトコル」の該当するプロトコル編を参照して見直す必要のある定義を確認してください。

(2)　ホスト名またはIPアドレスの変更手順

ホスト名またはIPアドレスは，次の手順で変更してください。

OpenTP1を正常停止します。

$DCDIR/conf，および$DCCONFPATH配下について，変更前のホスト名またはIPアドレスを検索します。

OSがUNIXの場合はgrepコマンド，Windowsの場合はfindstrコマンドを使用して検索します。

検索の結果，変更前のホスト名またはIPアドレスが見つかった場合には，変更します。

システム共通定義ファイル（$DCCONFPATH/betranrc）を変更している場合には，dcresetコマンドを実行します。

8　定義例

OpenTP1システム定義の作成例を示します。

8.1　OpenTP1システムを構成する定義例

定義例の通信環境とUAP構成を次の図に示します。

図8‒1　定義例の通信環境とUAP構成

定義のコーディング例を次に示します。

#############################################
# システム環境定義
# ファイル名:env
#
#############################################

set mode_conf            = AUTO   # システムの開始方法
set static_shmpool_size  = 6000   # 静的共用メモリの総量
set dynamic_shmpool_size = 500    # 動的共用メモリの最大使用時の総量
set shmpool_attribute    = free   # 共用メモリプールのメモリ固定の要否
putenv DCCONFPATH /qa3d/qa4g10/makai3g  # 定義ファイルの格納ディレクトリ
putenv SHELL /bin/sh              # ユーザ環境設定コマンド起動時のシェル

### システム環境定義の終わり ################

#############################################
# システムサービス構成定義
# ファイル名:sysconf
#
#############################################

set uap_conf = Y            # ユーザサーバを実行するかどうか
set dam_conf = Y            # DAMサービスを使用するかどうか
set que_conf = Y            # メッセージキューサービスを使用するかどうか
set tam_conf = Y            # TAMサービスを使用するかどうか

#----------システムサービスの起動------------#
dcsvstart -m _mutest1       # 起動するMCFサービスの名称

### システムサービス構成定義の終わり ########

#############################################
# ユーザサービス構成定義
# ファイル名:usrconf
#
#############################################

#-----------ユーザサーバの起動---------------#
dcsvstart -u exuap02        # 起動するシステムサービス名

dcsvstart -u exuap03        # 起動するシステムサービス名

###  ユーザサービス構成定義の終わり##########

#############################################
# システム共通定義
# ファイル名:betranrc
#
#############################################

set watch_time = 240               # RPCの応答に対する最大応答待ち時間
set name_port  = 10004             # ネームサービスのポート番号
set system_id  = o1                # OpenTP1識別子
set all_node   = ft6101,ft6102     # ネームサービスが存在する全ノード名
set node_id    = n d01             # ノード識別子
putenv LANG ja_JP.SJIS             # LANG設定値

### システム共通定義の終わり ################

#############################################
# ロックサービス定義
# ファイル名:lck
#
#############################################

set lck_limit_foruser = 64         # ユーザサーバの最大同時排他要求数
set lck_limit_fordam  = 64         # DAMサービスの最大同時排他要求数
set lck_limit_fortam  = 64         # TAMサービスの最大同時排他要求数
set lck_wait_timeout  = 30         # 排他待ち限界経過時間
set lck_deadlock_info = Y          # デッドロック情報を出力するかどうか

### ロックサービス定義の終わり ##############

#############################################
# タイマサービス定義
# ファイル名:tim
#
#############################################

set tim_watch_count = 128          # 最大時間監視サービス数

### タイマサービス定義の終わり ##############

#############################################
# ネームサービス定義
# ファイル名:nam
#
#############################################

set name_total_size = 64           # サービス情報領域の大きさ
set name_cache_size = 16           # サービス情報キャッシュ領域の大きさ

### ネームサービス定義の終わり ##############

#############################################
# プロセスサービス定義
# ファイル名:prc
#
#############################################

set prc_process_count = 100        # 最大同時起動サーバプロセス数

#---------ユーザサーバパスの指定-------------#
prcsvpath /BeTRAN/aplib            # ユーザサーバおよびコマンドのパス名

### プロセスサービス定義の終わり ############

#############################################
# スケジュールサービス定義
# ファイル名:scd
#
#############################################

set scd_server_count = 32          # 最大ユーザサーバ数

### スケジュールサービス定義の終わり ########

#############################################
# トランザクションサービス定義
# ファイル名:trn
#
#############################################

set trn_tran_process_count = 20 # 同時起動トランザクションブランチ数
set trn_recovery_process_count = 2
                                # 並行回復プロセス数
set trn_expiration_time    = 60 # トランザクションブランチ限界経過時間
set trn_tran_statistics    = N  # 統計情報を取得するかどうか

### トランザクションサービス定義の終わり ####

#############################################
# ステータスサービス定義
# ファイル名:sts
#
#############################################

set sts_file_name_1 = "stsfil01","/dev/rdsk/rhd111/stsfil01", ¥
                                 "/dev/rdsk/rhd112/stsfil02"
        # 論理ファイル名,A系ステータスファイル名,B系ステータスファイル名
set sts_file_name_2 = "stsfil02","/dev/rdsk/rhd111/stsfil03", ¥
                                "/dev/rdsk/rhd112/stsfil04"
        # 論理ファイル名,A系ステータスファイル名,B系ステータスファイル名
set sts_initial_error_switch = stop   # ステータスサービスの障害時の処置

### ステータスサービス定義の終わり ##########

#############################################
# ジャーナルサービス定義
# ファイル名:jnl
#
#############################################

#------ジャーナル関係のファイルの指定--------#
jnldfsv   -r sjs -c cdtjl,cdmcf
                     # -r システムジャーナルサービス定義のファイル名
                     # -c チェックポイントダンプサービス定義のファイル名

### ジャーナルサービス定義の終わり ##########

#############################################
# システムジャーナルサービス定義
# ファイル名:sjs
#
#############################################

set jnl_max_datasize   = 32000        # 最大レコードデータ長
set jnl_cdinterval     = 1000         # ジャーナルブロック数
set jnl_rerun_swap     = N
                    # システム再開始時にジャーナルをスワップするかどうか
set jnl_dual           = Y    # ジャーナルファイルを二重化するかどうか
set jnl_singleoperation = N   # 片系使用できないときスワップするかどうか
set jnl_rerun_reserved_file_open = N
                    # 全面回復時に予約ファイルをオープンするかどうか

#-ジャーナル関係のファイルグループの指定(1)--#
jnladdfg  -g jnlgrp01 ONL
                    # システムジャーナルを構成するファイルグループ名

#---ジャーナル関係の物理ファイルの指定(1)----#
jnladdpf  -g jnlgrp01                        ¥
          -a /dev/rdsk/rhd111/jnlf011        ¥
          -b /dev/rdsk/rhd112/jnlf012
                                      # -g 対応するファイルグループ名
                                      # -a 物理ファイル名
                                      # -b 物理ファイル名

#-ジャーナル関係のファイルグループの指定(2)-#
jnladdfg  -g jnlgrp02 ONL

#--ジャーナル関係の物理ファイルの指定(2)----#
jnladdpf  -g jnlgrp02                       ¥
          -a /dev/rdsk/rhd111/jnlf021       ¥
          -b /dev/rdsk/rhd112/jnlf022

#-ジャーナル関係のファイルグループの指定(3)-#
jnladdfg  -g jnlgrp03 ONL

#--ジャーナル関係の物理ファイルの指定(3)----#
jnladdpf  -g jnlgrp03                       ¥
          -a /dev/rdsk/rhd111/jnlf031       ¥
          -b /dev/rdsk/rhd112/jnlf032

#-ジャーナル関係のファイルグループの指定(4)-#
jnladdfg  -g jnlgrp04 ONL

#--ジャーナル関係の物理ファイルの指定(4)----#
jnladdpf  -g jnlgrp04                       ¥
          -a /dev/rdsk/rhd111/jnlf041       ¥
          -b /dev/rdsk/rhd112/jnlf042

### システムジャーナルサービス定義の終わり ##

#############################################
# チェックポイントダンプサービス定義
# ファイル名:cdtjl
#
#############################################

set jnl_objservername = "_tjl"  # 対象となるシステムサービス名
set jnl_max_datasize  = 32768   # チェックポイントダンプ取得用バッファ長
set assurance_count   = 2       # 有効保証世代数を2とする

#-ジャーナル関係のファイルグループの指定(1)-#
jnladdfg  -g cpdgrp01 ONL
                    # チェックポイントダンプを構成するファイルグループ名
#--ジャーナル関係の物理ファイルの指定(1)----#
jnladdpf  -g cpdgrp01                       ¥
          -a /dev/rdsk/rhd111/cpdf01
                                # -g 対応するファイルグループ名
                                # -a 物理ファイル名

#-ジャーナル関係のファイルグループの指定(2)-#
jnladdfg  -g cpdgrp02 ONL

#--ジャーナル関係の物理ファイルの指定(2)----#
jnladdpf  -g cpdgrp02                       ¥
          -a /dev/rdsk/rhd111/cpdf02

#-ジャーナル関係のファイルグループの指定(3)-#
jnladdfg -g cpdgrp03 ONL

#--ジャーナル関係の物理ファイルの指定(3)----#
jnladdpf -g cpdgrp03                        ¥
         -a /dev/rdsk/rhd111/cpdf03

## チェックポイントダンプサービス定義の終わり

#############################################
# チェックポイントダンプサービス定義
# ファイル名:cdmcf
#
#############################################

set jnl_objservername = "_mutest1"     # 対象となるシステムサービス名
set jnl_max_datasize  = 32768   # チェックポイントダンプ取得用バッファ長
set assurance_count = 2                # 有効保証世代数を2とする

#-ジャーナル関係のファイルグループの指定(1)--#
jnladdfg  -g cpdgrp04 ONL
                    # チェックポイントダンプを構成するファイルグループ名

#--ジャーナル関係の物理ファイルの指定(1)----#
jnladdpf  -g cpdgrp04                       ¥
          -a /dev/rdsk/rhd111/cpdf04
                                       # -g 対応するファイルグループ名
                                       # -a 物理ファイル名

#-ジャーナル関係のファイルグループの指定(2)--#
jnladdfg  -g cpdgrp05 ONL

#--ジャーナル関係の物理ファイルの指定(2)----#
jnladdpf  -g cpdgrp05                       ¥
          -a /dev/rdsk/rhd111/cpdf05

#-ジャーナル関係のファイルグループの指定(3)-#
jnladdfg -g cpdgrp06 ONL

#--ジャーナル関係の物理ファイルの指定(3)----#
jnladdpf -g cpdgrp06                        ¥
         -a /dev/rdsk/rhd111/cpdf06

## チェックポイントダンプサービス定義の終わり

#############################################
# ログサービス定義
# ファイル名:log
#
#############################################

set log_filesize        = 100   # メッセージログファイルの最大容量
set log_msg_console     = Y     # リアルタイム出力機能を使用するかどうか
set log_msg_allno       = N     # システム内の通番を付加するかどうか
set log_msg_prcid       = N     # 要求元のプロセスIDを付加するかどうか
set log_msg_prcno       = N     # プロセス内の通番を付加するかどうか
set log_msg_sysid       = Y     # OpenTP1識別子を付加するかどうか
set log_msg_date        = Y     # 出力要求時の日付を付加するかどうか
set log_msg_time        = Y     # 出力要求時の時刻を付加するかどうか
set log_msg_hostname    = Y     # 要求元のホスト名を付加するかどうか
set log_msg_pgmid       = Y     # 要求元プログラムIDを付加するかどうか
putenv TZ JST-9                 # タイムゾーン指定

### ログサービス定義の終わり #################

#############################################
# マルチノード構成定義
# ファイル名:nodeconf
#
#############################################

#--マルチノードエリアの指定-----------------#
dcmarea -m area1 -w nd01,nd02 # マルチノードエリアに属するノードを指定する
dcmarea -m area1 -w nd03,nd04

#--マルチノードサブエリアの指定-------------#
dcmarea -g sub1 -w nd01,nd02
                          # マルチノードサブエリアに属するノードを指定する

### マルチノード構成定義の終わり ############

############################################
# マルチノード物理定義
# ファイル名:nodeaddr
#
############################################

dcprcport -w nd01 -h ft6101 -p 20000 # 各OpenTP1ノードについてOpenTP1
dcprcport -w nd02 -h ft6102 -p 20000 # ノードがあるホスト名とマルチ
dcprcport -w nd03 -h ft6103 -p 20000 # ノード連携制御機能が使用する
dcprcport -w nd04 -h ft6104 -p 20000 # ポート番号を指定する

### マルチノード物理定義の終わり ############

############################################
# DAMサービス定義
# ファイル名:dam
#
############################################

set dam_update_block = 32      # 更新する最大ブロック数
set dam_added_file = 8         # オンライン中に追加する最大論理ファイル数

#-----------論理ファイルの指定---------------#
damfile DAMFILE /dev/rdsk/rhd112/damfile0
               # オンライン中にアクセスする論理ファイル名と物理ファイル名

### DAMサービス定義の終わり  ################

#############################################
# TAMサービス定義
# テーブル名:tam
#
#############################################

set tam_max_tblnum = 100       # オンライン中に使用するテーブルの最大数
set tam_max_filesize = 50000   # オンライン中に使用する最大テーブルサイズ
set tam_max_recsize = 200      # TAMテーブル最大レコード長
set tam_jnl_err_flag = STOP    # ジャーナル障害時の処理形態
set tam_pool_attri = fixed     # 共用メモリプールを固定するかどうか

#------------TAMファイルの属性の指定---------#

tamtable  TAMTABLE /dev/rdsk/rhd112/tamfile0
                               # TAMテーブル名 物理ファイル名

### TAMサービス定義の終わり  ################

#############################################
# ISTサービス定義
# ファイル名:ist
#
#############################################

set ist_node =node1,node2,node3             # テーブル操作をするノード名

istdef isttbl1 32 100     # アクセスするテーブル名,レコード長,レコード数
istdef isttbl2 128 10     # アクセスするテーブル名,レコード長,レコード数
istdef isttbl3 1024 10    # アクセスするテーブル名,レコード長,レコード数

### ISTサービス定義の終わり ##################

#############################################
# メッセージキューサービス定義
# ファイル名:que
#
#############################################

set que_xidnum = 100       # 同時に実行するトランザクションの最大数

#-------メッセージキューファイルの指定-------#
quegrp -g otqgrp01 -f /dev/rdsk/rhd112/quef01 -n 128 -m 10 -w 80
                           # -g 物理ファイルに割り当てるキューグループID
                           # -f 物理ファイル名
                           # -n バッファキャッシュ用の入出力バッファ数
                           # -m キューファイルの保持メッセージ数
                           # -w 物理ファイルの使用容量警告率

quegrp -g itqgrp01 -f /dev/rdsk/rhd112/quef02 -n 128 -m 10 -w 80

### メッセージキューサービス定義の終わり ####

#############################################
# ユーザサービスデフォルト定義
# ファイル名:usrrc
#
#############################################

set nice                 = 10    # プロセスの実行優先度
set parallel_count       = 1     # 常駐プロセス数
set hold                 = Y     # UAP異常終了時，閉塞するかどうか
set hold_recovery        = N     # 全面回復時，閉塞状態を引き継ぐか
set deadlock_priority    = 64    # UAPのデッドロックの優先順位
set schedule_priority    = 8     # スケジュールの優先順位
set message_buflen       = 4096  # メッセージ長
set message_store_buflen = 12288 # メッセージ格納プール長
set atomic_update        = Y     # トランザクションを発生させるかどうか
set receive_from         = queue # スケジュールキューを使用するかどうか
set uap_trace_max        = 32    # UAPトレース格納最大数
set term_watch_time      = 30    # 連続異常終了限界経過時間
set type                 = other # サービスグループの種別
set balance_count        = 3     # サービス要求滞留値
set auto_restart         = N     # UAP異常終了時のサービスグループの処置
set critical             = N     # UAP異常終了時のシステムの処置
set lck_wait_priority    = 0     # 排他待ちの優先順位

### ユーザサービスデフォルト定義の終わり #####

#############################################
# ユーザサービス定義1
# ファイル名:exuap01
# クライアントUAP(SUP)の定義
#
#############################################

set module                  = "upout1"            # 実行形式プログラム名
set receive_from            = none
                    # メッセージ送受信にスケジュールキューを使うかどうか
### ユーザサービス定義の終わり ##############

#############################################
# ユーザサービス定義2
# ファイル名:exuap02
# サーバUAP(SPP)の定義
#
#############################################

set service_group   = "uap02"         # サービスグループ名
set module          = "upout2"        # 実行形式ファイル名
set parallel_count  = 2 , 4           # 常駐プロセス数と非常駐プロセス数
set service         = "serv02=serv02" # サービス名 = エントリポイント名

### ユーザサービス定義の終わり ##############

#############################################
# ユーザサービス定義3
# ファイル名:exuap03
# メッセージ処理プログラム(MHP)の定義
#
#############################################

set service_group  = "uap03"        # サービスグループ名
set module         = "upout3"       # 実行形式ファイル名
set parallel_count = 1 , 2          # 常駐プロセス数と非常駐プロセス数
set hold           = N              # サービスグループを閉塞するかどうか
set service        = "serv031=serv031",  ¥
                     "serv032=serv032"
                                    # サービス名 = エントリポイント名
set type           = MHP            # サービスグループの種別

### ユーザサービス定義の終わり ###############

#############################################
# MCFマネジャ定義
# ファイル名:abc_mngr
# オブジェクトファイル名:_mutest1
# 対応するMCF通信構成定義オブジェクトファイル名:_muua01,_mups01
#
#############################################

#----------MCFマネジャ環境定義--------------#
mcfmenv   -m "name = mng01"         # MCFマネジャ名

#----------MCFマネジャ共通定義--------------#
mcfmcomn  -n 10                     # 出力通番使用論理端末数 # ¥
          -p 300                    # MCF作業領域長 # ¥

#-------------通信サービス定義--------------#
mcfmcname -s "mcfsvname = _muua01   # MCF通信サービス名 # ¥
              syssvname = mcfu01"   # システムサービス情報定義ファイル名

mcfmcname -s "mcfsvname = _mups01   # MCF通信サービス名 # ¥
              syssvname = mcfu02"   # システムサービス情報定義ファイル名

#--------------UAP共通定義------------------#
mcfmuap   -d 65535                  # 通信関数発行回数上限値 # ¥
          -l "maxseq  = 9999"       # ラップ時の出力通番最大値 # ¥

#-------------入出力キュー定義--------------#
mcfmqgid  -q "quekind  = otq        # キューの種別 # ¥
              quegrpid = otqgrp01"  # キューグループID

mcfmqgid  -q "quekind  = itq        # キューの種別 # ¥
              quegrpid = itqgrp01"  # キューグループID

#--------------拡張予約定義-----------------#
mcfmexp   -g 20                     # サービスグループの登録数 # ¥
          -l 10                     # 論理端末の登録数 # ¥
          -i dg   # 入力キューが使用できないとき縮退運転するかどうか # ¥
          -o dg   # 出力キューが使用できないとき縮退運転するかどうか

#-------------状態引き継ぎ定義--------------#
mcfmsts   -g 20                     # サービスグループ数上限値 # ¥
          -v 100                    # サービス数上限値

#########MCFマネジャ定義の終わり#############

#############################################
# MCF通信構成定義(ua) 共通定義
# ファイル名:abc_ua_c
# オブジェクトファイル名:obj_ua_c
# 対応するデータコミュニケーション定義オブジェクトファイル名:obj_ua_d
# MCF通信構成定義オブジェクトファイル名:_muua01
# 対応するMCFアプリケーション定義オブジェクトファイル名:_aplipt1
#
#
#############################################

#----------------MCF通信環境定義-------------#
mcftenv   -s 01                 # MCF通信プロセス識別子 # ¥
          -a _aplipt1  # MCFアプリケーション定義オブジェクトファイル名

#--------------MCF通信構成共通定義----------#
mcftcomn

#---------------タイマ定義------------------#
mcfttim   -t "rmtim  = 180"     # 未処理受信メッセージ滞留時間

#-------------トレース環境定義--------------#
mcfttrc

#-------------状態引き継ぎ定義--------------#
mcftsts   -a 10                 # アプリケーション数上限値

#-----------バッファグループ定義------------#
###(送信用)
mcftbuf   -g "groupno = 1       # バッファグループ番号 # ¥
              length  = 4096    # バッファ長 # ¥
              count   = 256"    # バッファ数 # ¥
###(受信用)
mcftbuf   -g "groupno = 2       # バッファグループ番号 # ¥
              length  = 4096    # バッファ長 # ¥
              count   = 256"    # バッファ数 # ¥

###(編集用)
mcftbuf   -g "groupno = 3       # バッファグループ番号 # ¥
              length  = 4096    # バッファ長 # ¥
              count   = 256"    # バッファ数 # ¥

### MCF通信構成定義(共通定義)の終わり ####

#############################################
# MCF通信構成定義(ua)
#   データコミュニケーション定義(プロトコル固有定義)
# ファイル名:abc_ua_d
# オブジェクトファイル名:obj_ua_d
# 対応する共通定義オブジェクトファイル名:obj_ua_c
# MCF通信構成定義オブジェクトファイル名:_muua01
# 対応するMCFアプリケーション定義オブジェクトファイル名:_aplipt1
#
#    OSAS/UAプロトコル固有定義のため
# 詳細は プロトコル TP1/NET/User Agent編 参照のこと
#
#############################################

#=============コネクション定義==============#
#----------コネクション定義の開始-----------#
mcftalccn -c coua01           # コネクションID # ¥
          -p ua               # プロトコルの種別 # ¥
          -n x'0a81008202001283020012' ¥
                              # 自システムのPSAPアドレス # ¥
          -g "sndbuf = 1      # メッセージ送信用バッファグループ番号 # ¥
              rcvbuf = 2"     # メッセージ受信用バッファグループ番号 # ¥
          -e "msgbuf = 3      # メッセージ編集用バッファグループ番号 # ¥
              count  = 5"     # メッセージ編集用バッファ数 # ¥
          -m "mode   = xnfas" # 通信管理の接続モード #   ¥
          -i auto     # 再開始時にコネクションを自動確立するかどうか # ¥
          -o old              # OSAS/UA プロトコルの種別 # ¥
          -u ht               # 通信相手システムの種別 # ¥
          -y e'T1000'         # 制御UAの端末識別子 # ¥
          -q x'16810082008302ffff840c540072872203192066024001'  ¥
                              # 通信相手システムのPSAPアドレス # ¥
          -z "slot   = 1"     # 自システムで使用するスロット番号 ¥
          -l 0                # TLクラス

#----------論理端末定義/UA定義(1)-----------#
mcftalcle -l lotr01                       # 論理端末名称 # ¥
          -t reply                        # 端末タイプ # ¥
          -m "mmsgcnt  = 20       # メモリ出力メッセージ最大格納数 # ¥
              dmsgcnt  = 10"      # ディスク出力メッセージ最大格納数 # ¥
          -k "quekind  = disk             # 出力キューの媒体の種類 # ¥
              quegrpid = otqgrp01"        # キューグループID
mcftalcua -u 1                            # UA番号  # ¥
          -y e'T1001'                     # UA端末識別子

#----------論理端末定義/UA定義(2)-----------#
mcftalcle -l lotr02                       # 論理端末名称 # ¥
          -t send                         # 端末タイプ # ¥
          -m "mmsgcnt  = 20       # メモリ出力メッセージ最大格納数 # ¥
              dmsgcnt  = 10"      # ディスク出力メッセージ最大格納数 # ¥
          -k "quekind  = disk             # 出力キューの媒体の種類 # ¥
              quegrpid = otqgrp02"        # キューグループID
mcftalcua -u 2                            # UA番号 # ¥
          -y e'T1002'                     # UA端末識別子

#----------コネクション定義の終了-----------#
mcftalced                                 # 引数なし

## MCF通信構成定義(データコミュニケーション定義)の終わり

#############################################
# MCF通信構成定義(psvr) 共通定義
# ファイル名:psvr_cmn
# オブジェクトファイル名:psvr_c_o
# 対応するデータコミュニケーション定義オブジェクトファイル名:psvr_d_o
# MCF通信構成定義オブジェクトファイル名:_mups01
# 対応するMCFアプリケーション定義オブジェクトファイル名:_aplipt1
#
#
#############################################

#-------------MCF通信環境定義----------------#
mcftenv   -s 02          # アプリケーション起動プロセス識別子 # ¥
          -a _aplipt1    # MCFアプリケーション定義オブジェクトファイル名

#-----------MCF通信構成共通定義-------------#
mcftcomn

#----------------タイマ定義-----------------#
mcfttim   -t "rmtim = 180"      # 未処理受信メッセージ滞留時間

#--------------トレース環境定義-------------#
mcfttrc

#--------------状態引き継ぎ定義-------------#
mcftsts   -a 10                 # アプリケーション数上限値

##### MCF通信構成定義(共通定義)の終わり #####

#############################################
# MCF通信構成定義(psvr)
#   データコミュニケーション定義(アプリケーション起動定義)
# ファイル名:psvr_dta
# オブジェクトファイル名:psvr_d_o
# 対応する共通定義オブジェクトファイル名:psvr_c_o
# MCF通信構成定義オブジェクトファイル名:_mups01
# 対応するMCFアプリケーション定義オブジェクトファイル名:_aplipt1
#
#
#############################################

#----アプリケーション起動環境定義の開始-----#
mcftpsvr  -c copsvr01                     # 内部通信路名

#---------------論理端末定義----------------#
mcftalcle -l lotr03                       # 論理端末名称 # ¥
          -t request                      # 端末タイプ # ¥
          -m "mmsgcnt  = 20       # メモリ出力メッセージ最大格納数 # ¥
              dmsgcnt  = 10"      # ディスク出力メッセージ最大格納数 # ¥
          -k "quekind  = disk             # 出力キューの媒体の種類 # ¥
              quegrpid = otqgrp01"        # キューグループID

#----アプリケーション起動環境定義の終了-----#
mcftped                                   # 引数なし
## MCF通信構成定義(データコミュニケーション定義)の終わり

#############################################
# MCFアプリケーション定義
# ファイル名:abc_apli
# オブジェクトファイル名:_aplipt1
#
#############################################
#---------MCFアプリケーション環境定義--------#
mcfaenv   -a apli01                 # MCFアプリケーション定義識別子 # ¥
          -p 02                     # アプリケーション起動プロセス識別子

#--------MCFアプリケーション属性定義(1)------#
mcfaalcap -n "name      = WORK1     # アプリケーション名 # ¥
              type      = ans       # アプリケーションの型 # ¥
              aplihold  = a     # アプリケーションを閉塞するかどうか # ¥
              msgcnt    = 600"      # 入力メッセージ最大格納数 # ¥
          -g "servgrpn  = uap03     # サービスグループ名 # ¥
              quegrpid  = itqgrp01  # キューグループID # ¥
              quekind   = disk"     # 入力キューの媒体の種類 # ¥
          -v "servname  = serv031"  # 対応するサービス名 # ¥
          -j "ij        = yes       # 履歴情報を取得するかどうか # ¥
                                    #     (入力メッセージ登録時) # ¥
              oj        = yes       # 履歴情報を取得するかどうか # ¥
                                    #     (メッセージ送信要求時) # ¥
              gj        = yes"      # 履歴情報を取得するかどうか
                                    #     (メッセージ受信要求時)

#--------MCFアプリケーション属性定義(2)------#
mcfaalcap -n "name      = WORK2     # アプリケーション名 # ¥
              type      = ans       # アプリケーションの型 # ¥
              aplihold  = a     # アプリケーションを閉塞するかどうか # ¥
              msgcnt    = 600       # 入力メッセージ最大格納数 # ¥
              cname     = copsvr01" # 内部通信路名 # ¥
          -g "servgrpn  = uap03     # サービスグループ名 # ¥
              quegrpid  = itqgrp01  # キューグループID # ¥
              quekind   = disk"     # 入力キューの媒体の種類 # ¥
          -v "servname  = serv032"  # 対応するサービス名 # ¥
          -j "ij        = yes       # 履歴情報を取得するかどうか # ¥
                                    #     (入力メッセージ登録時) # ¥
              oj        = yes       # 履歴情報を取得するかどうか # ¥
                                    #     (メッセージ送信要求時) # ¥
              gj        = yes"      # 履歴情報を取得するかどうか
                                    #     (メッセージ受信要求時)
###### MCFアプリケーション定義の終わり #######

#############################################
# システムサービス情報定義(ua)
# ファイル名:mcfu01
#
#############################################

set module = "mcfu01"
# ユーザが作成したMCFのメイン関数の実行形式プログラム名(=定義ファイル名)

### システムサービス情報定義の終わり ########

#############################################
# システムサービス情報定義(psvr)
# ファイル名:mcfu02
#
#############################################

set module = "mcfu02"
# ユーザが作成したMCFのメイン関数の実行形式プログラム名(=定義ファイル名)

### システムサービス情報定義の終わり ########

8.2　リアルタイム統計情報の取得項目の定義例

リアルタイム統計情報サービスが取得する統計情報の取得対象および取得項目は，rtsput定義コマンドの指定方法によって変更できます。

ここでは，リアルタイム統計情報サービス定義の定義例と，その場合に取得される情報を示します。さらに，rts_service_maxオペランド（最大取得サービス数）およびrts_item_maxオペランド（最大取得項目数）の指定値による取得情報の違いもあわせて示します。

8.2.1　リアルタイム統計情報サービス定義の定義例

#############################################################
# リアルタイム統計情報サービス定義
# ファイル名:rts
#
#############################################################

set rts_service_max = 7
set rts_item_max   = 6

rtsput -u sys -f File1                                 ※1
rtsput -u srv -s supA -e 項目4,項目5 -f File1          ※2
rtsput -u srv -s sppA -f File1                         ※3
rtsput -u svc -s sppA -v update -e 項目4,項目5,項目6   ※4
rtsput -u svc -s sppB -v refer -e 項目4,項目5          ※5
rtsput -u obj -o ポート番号 -b IPアドレス -e 項目6     ※6

### リアルタイム統計情報サービス定義の終わり ################

#############################################################
# リアルタイム取得項目定義
# ファイル名:File1
#
#############################################################

set 項目1 = Y
set 項目2 = Y
set 項目3 = Y

### リアルタイム取得項目定義の終わり ########################

#############################################################
# ユーザサービス定義1
# ファイル名:supA
#
#############################################################

set module = "supA"
set receive_from = none

###  ユーザサービス定義1の終わり#############################

#############################################################
# ユーザサービス定義2
# ファイル名:sppA
#
#############################################################

set service_group = "sppA_svg"
set module = "sppA"
set service = "refer=refer","update=update"

###  ユーザサービス定義2の終わり#############################

#############################################################
# ユーザ サービス定義3
# ファイル名:sppB
#
#############################################################

set service_group = "sppB_svg"
set module = "sppB"
set service = "refer=refer","update=update"

###  ユーザサービス定義3の終わり#############################

注※1

rts_service_maxオペランドに指定した値に関係なく，表8-1の項番1のようにシステム全体の統計情報を取得対象として登録します。

注※2

-uオプションにsrvを指定し，ユーザサービス定義内にserviceオペランドを定義していない場合，表8-1の項番2のようにサービス全体の統計情報を取得対象として登録します。

注※3

-uオプションにsrvを指定し，ユーザサービス定義内にserviceオペランドを定義した場合，表8-1の項番3〜項番6のように，サーバ単位およびサービス以外の処理単位の統計情報，ならびにserviceオペランドに定義したサービスを統計情報の取得対象として登録します。

注※4

すでに登録されている取得対象に対してrtsput定義コマンドで定義した場合，表8-1の項番6のように取得項目をまとめて登録します。

注※5

-sオプションに指定したサーバ名と-vオプションに指定したサービス名を組み合わせて表8-1の項番7のように一つの取得対象として登録します。

注※6

-oオプションおよび-bオプションの引数に指定した値を組み合わせて表8-1の項番8のように一つの取得対象として登録します。

上記のようにrtsput定義コマンドを指定する場合，rts_service_maxオペランドには7以上の値を指定し，rts_item_maxオペランドには6以上の値を指定する必要があります。

この定義例に基づいてリアルタイム統計情報サービスを開始した場合の取得対象および取得項目を次の表に示します。

表8‒1　定義例に基づいて取得できる内容

項番

取得対象

取得項目

1

_SYSTEM

△△△△

項目1

項目2

項目3

−

−

−

2

supA

△△△△

項目1

項目2

項目3

項目4

項目5

−

3

sppA

△△△△

項目1

項目2

項目3

−

−

−

4

sppA

****

項目1

項目2

項目3

−

−

−

5

sppA

refer

項目1

項目2

項目3

−

−

−

6

sppA

update

項目1

項目2

項目3

項目4

項目5

項目6

7

sppB

refer

項目4

項目5

−

−

−

−

8

ポート番号

IPアドレス

項目6

−

−

−

−

−

（凡例）

△△△△：サーバ単位で取得したリアルタイム統計情報

****：サービス以外の処理単位で取得したリアルタイム統計情報

−：該当なし

8.2.2　オペランドの指定値による取得情報の違い

リアルタイム統計情報サービスは，最大で「rts_service_maxオペランドの指定値+1」（システム全体の統計情報）分の取得対象の統計情報を取得できます。各取得対象は，rts_item_maxオペランドの指定値分の取得項目を取得できます。

また，rtsput定義コマンドに，rts_service_maxオペランドおよびrts_item_maxオペランドの指定値より多くの取得対象および取得項目を指定した場合，リアルタイム統計情報サービスは，登録できる分だけを登録して，統計情報を取得します。

次に，rts_service_maxオペランドおよびrts_item_maxオペランドの指定値より多くの取得対象および取得項目をrtsput定義コマンドに指定した場合の定義例を示します。

#############################################################
# リアルタイム統計情報サービス定義
# ファイル名:rts
#
#############################################################

set rts_service_max = 6
set rts_item_max   = 5

rtsput -u sys -f File1                                 ※1
rtsput -u srv -s supA -e 項目4,項目5 -f File1          ※2
rtsput -u srv -s sppA -f File1                         ※3
rtsput -u svc -s sppA -v update -e 項目4,項目5,項目6   ※4
rtsput -u svc -s sppB -v refer -e 項目4,項目5          ※5
rtsput -u obj -o ポート番号 -b IPアドレス -e 項目6     ※6

### リアルタイム統計情報サービス定義の終わり ################

#############################################################
# リアルタイム取得項目定義
# ファイル名:File1
#
#############################################################

set 項目1 = Y
set 項目2 = Y
set 項目3 = Y

### リアルタイム取得項目定義の終わり ########################

#############################################################
# ユーザ サービス定義1
# ファイル名:supA
#
#############################################################

set module = "supA"
set receive_from = none

###  ユーザサービス定義1の終わり#############################

#############################################################
# ユーザ サービス定義2
# ファイル名:sppA
#
#############################################################

set service_group = "sppA_svg"
set module = "sppA"
set service = "refer=refer","update=update"

###  ユーザサービス定義2の終わり#############################

#############################################################
# ユーザ サービス定義3
# ファイル名:sppB
#
#############################################################

set service_group = "sppB_svg"
set module = "sppB"
set service = "refer=refer","update=update"

###  ユーザサービス定義3の終わり#############################

注※1

rts_service_maxオペランドに指定した値に関係なく，表8-2の項番1のようにシステム全体の統計情報を取得対象として登録します。

注※2

-uオプションにsrvを指定し，ユーザサービス定義内にserviceオペランドを定義していない場合，表8-2の項番2のようにサービス全体の統計情報を取得対象として登録します。

注※3

-uオプションにsrvを指定し，ユーザサービス定義内にserviceオペランドを定義した場合，表8-2の項番3〜項番6のように，サーバ単位およびサービス以外の処理単位の統計情報，ならびにserviceオペランドに定義したサービスを統計情報の取得対象として登録します。

注※4

取得項目を三つ登録した場合に-eオプションに指定した項目のうち二つを登録すると，rts_item_maxオペランドの指定値に達するため，表8-2の項番6のように項目6を取得項目として登録しません。

注※5

-sオプションに指定したサーバ名と-vオプションに指定したサービス名を組み合わせて表8-2の項番7のように一つの取得対象として登録します。

注※6

表8-2の項番1を除いた取得対象の登録数がrts_service_maxオペランドの指定値に達しているので，取得対象として登録しません。

「8.2.1　リアルタイム統計情報サービス定義の定義例」で示した定義例ではrts_service_maxオペランドに7を，rts_item_maxオペランドに6を指定しているのに対し，この定義例ではrts_service_maxオペランドに6を，rts_item_maxオペランドに5を指定しています。この指定値の違いによって，取得対象および取得項目は，次の表のように「8.2.1　リアルタイム統計情報サービス定義の定義例」の場合とは異なります。

表8‒2　指定値より多くの取得対象および取得項目を指定した場合に取得できる内容

項番

取得対象

取得項目

1

_SYSTEM

△△△△

項目1

項目2

項目3

−

−

2

supA

△△△△

項目1

項目2

項目3

項目4

項目5

3

sppA

△△△△

項目1

項目2

項目3

−

−

4

sppA

****

項目1

項目2

項目3

−

−

5

sppA

refer

項目1

項目2

項目3

−

−

6

sppA

update

項目1

項目2

項目3

項目4

項目5

7

sppB

refer

項目5

項目6

−

−

−

（凡例）

△△△△：サーバ単位で取得したリアルタイム統計情報

****：サービス以外の処理単位で取得したリアルタイム統計情報

−：該当なし

付録

付録A　アプリケーションプログラムとシステム環境設定の関連

UAPとシステム環境設定の関係について説明します。システム環境設定の方法は，OpenTP1の基本機能によって異なります。

TP1/Server Baseの場合

テキストエディタで，必要なシステム定義ファイルを作成します。

TP1/LiNKの場合

OSがUNIXの場合は，対話形式のコマンドで実行環境を設定します。OSがWindowsの場合は，GUI画面で実行環境を設定します。

TP1/Server Baseの場合には，システム定義が必要です。

付録A.1　アプリケーションプログラムに関連するOpenTP1のシステム定義

UAPに関連するOpenTP1のシステム定義について説明します。システム定義は，OpenTP1の基本機能がTP1/Server Baseの場合にだけ必要です。以降の記述は，TP1/Server Baseの場合に該当します。

(1)　UAPに必要な定義

UAPに必要なシステム定義は次のとおりです。

(a)　システム共通定義

OpenTP1システム共通の実行環境を決定する定義です。RPCの最大応答待ち時間などを指定します。

(b)　ユーザサービス構成定義

OpenTP1システムの開始時に，一緒に開始するUAPを決定する定義です。

(c)　ユーザサービス定義

オンラインで起動されたUAPの，実行環境を決定する定義です。UAPごとに作成します。

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

ユーザサービス定義の項目のうち，省略した項目のデフォルト値を指定する定義です。

(e)　MCFアプリケーション定義

メッセージ制御機能（MCF）を使うときに，UAPのアプリケーション名を決定する定義です。ユーザサービス定義で実行環境を設定したUAPを，MCFで認識するために定義します。

UAPに関連するOpenTP1のシステム定義を次の表に示します。

表A‒1　UAPに関連するOpenTP1のシステム定義

区分

システム定義

システム共通定義

ユーザサービス構成定義

ユーザサービス定義

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

MCFアプリケーション定義

定義を作成する単位

一つのノード単位

サービスグループ単位

一つのノード単位

複数のMCF通信プロセスで一つ，またはMCF通信プロセス単位

使用する時期

SUP，SPP，MHPの起動時

システム正常開始時

SUP，SPP，MHPの起動時

SUP，SPP，MHPの起動時

MHPの起動時

定義の変更方法（set形式の場合※）

定義を変更して，変更前のノードのOpenTP1を終了させて，新しい定義でノードのOpenTP1を起動します。

定義を変更して変更前の定義のプロセスを終了させて，新しい定義で再びUAPを起動します。

注※

コマンド形式の定義項目は，オンライン中に変更できます。

(2)　UAPに関連するOpenTP1のシステム定義のファイル名

OpenTP1のシステム定義ファイルは，$DCCONFPATHの下に作成されます。UAPに関連するOpenTP1のシステム定義のファイル名を次の表に示します。

表A‒2　UAPに関連するOpenTP1のシステム定義のファイル名

UAPに関連するシステム定義

定義ファイル名（完全パス名）

システム共通定義

$DCCONFPATH/betranrc

ユーザサービス構成定義

$DCCONFPATH/usrconf

ユーザサービス定義

$DCCONFPATH/ユーザサービス構成定義で指定するユーザサーバ名または，サーバの開始コマンド（dcsvstart）で指定するユーザサーバ名

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

$DCCONFPATH/usrrc

MCFアプリケーション定義

$DCCONFPATH/ノード内で一意となる任意の名称

(3)　サービス名とアプリケーション名（set service，mcfaalcap）

MHPのサービスは，MCFで受信したメッセージの先頭セグメントの先頭8文字のアプリケーション名を基にスケジュールされます。システム定義では，ユーザサービス定義で指定したMHPのサービスグループ名とサービス名を，MCFアプリケーション定義にも指定して，二つの定義を対応付けます。MCFアプリケーション定義のアプリケーション属性定義のサービスグループ名とサービス名は，ユーザサービス定義で指定されている名称を指定してください。

付録A.2　トランザクションの時間監視

トランザクションの開始から同期点の取得までの間の限界経過時間に，他プロセスで実行するトランザクションブランチの処理時間（同期応答型RPCの処理時間）を含めることも含めないこともできます。

トランザクションの限界経過時間の監視方法は，ユーザサービス定義，ユーザサービスデフォルト定義，トランザクションサービス定義のtrn_expiration_time_suspendで指定します。

タイマ監視機能の運用について，trn_expiration_time_suspendオペランドの指定と各種タイマ値との関係を説明します。

(1)　trn_expiration_time_suspendオペランドと各種タイマ監視値の関係

trn_expiration_time_suspendオペランドの指定値と各種タイマ監視値の関係を図A-1に示します。

trn_expiration_time_suspendオペランドは図A-1のSPP1に指定します。このオペランドは，ユーザサービス定義，ユーザサービスデフォルト定義，またはトランザクションサービス定義に指定できます。指定値の優先順位は次のとおりです（1.＞2.＞3.）。

ユーザサービス定義

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

トランザクションサービス定義

このオペランドにYを指定した場合と，NまたはFを指定した場合とでは，トランザクションブランチ限界経過時間にRPCの処理時間を含めるかどうか（図A-1のt3で表す監視対象区間）が異なります。

図A‒1　trn_expiration_time_suspendオペランドと各種タイマ値の関係

図中のt1〜t10について次に説明します。

t1：watch_time（最大応答待ち時間）

RPCを発行してから応答が返ってくるまでの時間を監視します。

タイムアウト発生時にはdc_rpc_call()がDCRPCER_TIMED_OUT（-307）でエラーリターンします。

次に示すどれかの値が監視時間の最大値となります。

SUPのユーザサービス定義のwatch_timeオペランドの指定値

SUPのユーザサービス定義でwatch_timeオペランドの指定を省略した場合は，ユーザサービスデフォルト定義のwatch_timeオペランドの指定値

SUPのユーザサービス定義およびユーザサービスデフォルト定義でwatch_timeオペランドの指定を省略した場合は，システム共通定義のwatch_timeオペランドの指定値

すべての定義でwatch_timeオペランドの指定を省略した場合は180秒

t2：service_expiration_time（サービス関数開始から終了までの実行監視時間）

RPCを受け取ってサービス関数を開始してから，サービス関数終了までの時間を監視します。

タイムアウト時には，KFCA00502-Iメッセージが種別コード=3で出力され，SPP1がダウンします。

次に示すどれかの値が監視時間の最大値となります。

SPP1のユーザサービス定義のservice_expiration_timeオペランドの指定値

SPP1のユーザサービス定義でservice_expiration_timeオペランドの指定を省略した場合は，ユーザサービスデフォルト定義のservice_expiration_timeオペランドの指定値

すべての定義でservice_expiration_timeオペランドの指定を省略した場合は0（時間監視しない）

t3：trn_expiration_time（トランザクションブランチ限界経過時間）

トランザクション開始から，同期点処理を開始するまでの時間を監視します。

SPP1のtrn_expiration_time_suspendオペランドの指定によって，監視対象区間が異なります。監視区間は次のとおりです。

trn_expiration_time_suspendオペランドの指定がYの場合

t3(Y)で示す区間

trn_expiration_time_suspendオペランドの指定がNまたはFの場合

t3(N1)とt3(N2)で示す区間の合計

タイムアウト時には，KFCA00502-Iメッセージが種別コード=1で出力され，SPP1がダウンします。

次に示すどれかの値が監視時間の最大値となります。

SPP1のユーザサービス定義のtrn_expiration_timeオペランドの指定値

SPP1のユーザサービス定義でtrn_expiration_timeオペランドの指定を省略した場合は，ユーザサービスデフォルト定義のtrn_expiration_timeオペランドの指定値

SPP1のユーザサービス定義およびユーザサービスデフォルト定義でtrn_expiration_timeオペランドの指定を省略した場合は，トランザクションサービス定義のtrn_expiration_timeオペランドの指定値

すべての定義でtrn_expiration_timeオペランドの指定を省略した場合は0（時間監視しない）

t4：watch_time（最大応答待ち時間）

RPCを発行してから応答が返ってくるまでの時間を監視します。

タイムアウト時にはdc_rpc_call()がDCRPCER_TIMED_OUT（-307）でエラーリターンします。

次に示すどれかの値が監視時間の最大値となります。

SPP1のユーザサービス定義のwatch_timeオペランドの指定値

SPP1のユーザサービス定義でwatch_timeオペランドの指定を省略した場合は，ユーザサービスデフォルト定義のwatch_timeオペランドの指定値

SPP1のユーザサービス定義およびユーザサービスデフォルト定義でwatch_timeオペランドの指定を省略した場合は，システム共通定義のwatch_timeオペランドの指定値

すべての定義でwatch_timeオペランドの指定を省略した場合は180秒

t5：service_expiration_time（サービス関数開始から終了までの実行監視時間）

RPCを受け取ってサービス関数を開始してから，サービス関数終了までの時間を監視します。

タイムアウト時には，KFCA00502-Iメッセージが種別コード=3で出力され，SPP2がダウンします。

次に示すどれかの値が監視時間の最大値となります。

SPP2のユーザサービス定義のservice_expiration_timeオペランドの指定値

SPP2のユーザサービス定義でservice_expiration_timeオペランドの指定を省略した場合は，ユーザサービスデフォルト定義のservice_expiration_timeオペランドの指定値

すべての定義でservice_expiration_timeオペランドの指定を省略した場合は0（時間監視しない）

t6：trn_expiration_time（トランザクションブランチ限界経過時間）

トランザクション開始から，同期点処理を開始するまでの時間を監視します。

タイムアウト時には，KFCA00502-Iメッセージが種別コード=1で出力され，SPP2がダウンします。

次に示すどれかの値が監視時間の最大値となります。

SPP2のユーザサービス定義のtrn_expiration_timeオペランドの指定値

SPP2のユーザサービス定義でtrn_expiration_timeオペランドの指定を省略した場合は，ユーザサービスデフォルト定義のtrn_expiration_timeオペランドの指定値

SPP2のユーザサービス定義およびユーザサービスデフォルト定義でtrn_expiration_timeオペランドの指定を省略した場合は，トランザクションサービス定義の指定値

すべての定義でtrn_expiration_timeオペランドの指定を省略した場合は0（時間監視しない）

t7：trn_watch_time（トランザクション同期点処理時の最大通信待ち時間）

トランザクションの同期点処理で，トランザクションブランチ間の通信（プリペア，コミット，ロールバック指示，または応答など）の受信待ち時間です。

次に示すどれかの値が待ち時間の最大値となります。

SPP1のユーザサービス定義のtrn_watch_timeオペランドの指定値

SPP1のユーザサービス定義でtrn_watch_timeオペランドの指定を省略した場合は，ユーザサービスデフォルト定義のtrn_watch_timeオペランドの指定値

SPP1のユーザサービス定義およびユーザサービスデフォルト定義でtrn_watch_timeオペランドの指定を省略した場合は，トランザクションサービス定義のtrn_watch_timeオペランドの指定

SPP1のすべての定義でtrn_watch_timeオペランドの指定を省略した場合は，SPP1のwatch_timeオペランドの指定値

t8：trn_watch_time（トランザクション同期点処理時の最大通信待ち時間）

トランザクションの同期点処理で，トランザクションブランチ間の通信（プリペア，コミット，ロールバック指示，または応答など）の受信待ち時間です。

次に示すどれかの値が待ち時間の最大値となります。

SPP2のユーザサービス定義のtrn_watch_timeオペランドの指定値

SPP2のユーザサービス定義でtrn_watch_timeオペランドの指定を省略した場合は，ユーザサービスデフォルト定義のtrn_watch_timeオペランドの指定値

SPP2のユーザサービス定義およびユーザサービスデフォルト定義でtrn_watch_timeオペランドの指定を省略した場合は，トランザクションサービス定義のtrn_watch_timeオペランドの指定値

SPP2のすべての定義でtrn_watch_timeオペランドの指定を省略した場合は，SPP2のwatch_timeオペランドの指定値

t9：trn_completion_limit_time（トランザクション完了限界時間）

トランザクション開始から，終了までの時間を監視します。

タイムアウト時には，KFCA00502-Iメッセージが種別コード=4で出力され，SPP1がダウンします。

次に示すどれかの値が監視時間の最大値となります。

SPP1のユーザサービス定義のtrn_completion_limit_timeオペランドの指定値

SPP1のユーザサービス定義でtrn_completion_limit_timeオペランドの指定を省略した場合は，ユーザサービスデフォルト定義のtrn_completion_limit_timeオペランドの指定値

SPP1のユーザサービス定義およびユーザサービスデフォルト定義でtrn_completion_limit_timeオペランドの指定を省略した場合は，トランザクションサービス定義のtrn_completion_limit_timeオペランドの指定値

SPP1のすべての定義でtrn_completion_limit_timeオペランドの指定を省略した場合は0（時間監視しない）

t10：trn_completion_limit_time（トランザクション完了限界時間）

トランザクション開始から，終了までの時間を監視します。

タイムアウト時には，KFCA00502-Iメッセージが種別コード=4で出力され，SPP2がダウンします。

次に示すどれかの値が監視時間の最大値となります。

SPP2のユーザサービス定義のtrn_completion_limit_timeオペランドの指定値

SPP2のユーザサービス定義でtrn_completion_limit_timeオペランドの指定を省略した場合は，ユーザサービスデフォルト定義のtrn_completion_limit_timeオペランドの指定値

SPP2のユーザサービス定義およびユーザサービスデフォルト定義でtrn_completion_limit_timeオペランドの指定を省略した場合は，トランザクションサービス定義のtrn_completion_limit_timeオペランドの指定値

SPP2のすべての定義でtrn_completion_limit_timeオペランドの指定を省略した場合は0（時間監視しない）

(2)　trn_expiration_time_suspendオペランドと各種タイマ監視値の関係（連鎖RPCを使用した場合）

連鎖RPCを使用した場合の，trn_expiration_time_suspendオペランドの指定値と各種タイマ監視値の関係を，図A-2に示します。

trn_expiration_time_suspendオペランドは図A-2のSPP1に指定します。このオペランドは，ユーザサービス定義，ユーザサービスデフォルト定義，またはトランザクションサービス定義に指定できます。指定値の優先順位は次のとおりです（1.＞2.＞3.）。

ユーザサービス定義

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

トランザクションサービス定義

このオペランドにYを指定した場合と，NまたはFを指定した場合とでは，トランザクションブランチ限界経過時間にRPCの処理時間を含めるかどうか（図A-2のt3で表す監視対象区間）が異なります。

図A‒2　連鎖RPCを使用した場合の各種タイマ値の関係（連鎖RPCを使用した場合）

図中のt1，t2，t4〜t10については，図A-1の説明を参照してください。t3およびt11について，次に説明します。

t3：trn_expiration_time（トランザクションブランチ限界経過時間）

トランザクション開始から，コミットされるまでの時間を監視します。

SPP1のtrn_expiration_time_suspendオペランドの指定によって，監視対象区間が異なります。監視区間は次のとおりです。

trn_expiration_time_suspendオペランドの指定がYの場合

t3(Y)で示す区間

trn_expiration_time_suspendオペランドの指定がNまたはFの場合

t3(N1)，t3(N2)およびt3(N3)で示す区間の合計

タイムアウト時には，KFCA00502-Iメッセージが種別コード=1で出力され，SPP1がダウンします。

次に示すどれかの値が監視時間の最大値となります。

SPP1のユーザサービス定義のtrn_expiration_timeオペランドの指定値

SPP1のユーザサービス定義でtrn_expiration_timeオペランドの指定を省略した場合は，ユーザサービスデフォルト定義のtrn_expiration_timeオペランドの指定値

SPP1のユーザサービス定義およびユーザサービスデフォルト定義でtrn_expiration_timeオペランドの指定を省略した場合は，トランザクションサービス定義のtrn_expiration_timeオペランドの指定値

すべての定義でtrn_expiration_timeオペランドの指定を省略した場合は0（時間監視しない）

t11：watch_next_chain_time（連鎖RPC間隔監視時間）

連鎖RPCの応答を返してから，次の要求が来るまでの時間を監視します。

タイムアウト時にはKFCA00315-Eメッセージを出力し，SPP2がダウンします。

次に示すどれかの値が監視時間の最大値となります。

SPP2のユーザサービス定義のwatch_next_chain_timeオペランドの指定値

SPP2のユーザサービス定義でwatch_next_chain_timeオペランドを省略した場合は，ユーザサービスデフォルト定義のwatch_next_chain_timeオペランドの指定値

すべての定義でwatch_next_chain_timeオペランドの指定を省略した場合は180秒

(3)　trn_completion_limit_timeオペランドの監視区間

trn_completion_limit_timeオペランドの監視区間には，XAインタフェース処理，サーバUAP呼び出し処理，およびすべてのユーザ処理が監視対象として含まれます。ただし，トランザクションの最適化（コミット最適化，およびプリペア最適化）が行われた場合は，SPPプロセスで実行中のトランザクション処理が終了した時点で時間監視を終了します。トランザクションの最適化の詳細については，マニュアル「OpenTP1 プログラム作成の手引」を参照してください。

trn_expiration_timeオペランドとtrn_completion_limit_timeオペランドの監視区間の差異を次の図に示します。

図A‒3　trn_expiration_timeオペランドとtrn_completion_limit_timeオペランドの監視区間の差異

図中のTおよびNについて次に説明します。

T1：SUPでのtrn_expiration_timeオペランドの監視区間（トランザクションブランチ限界経過時間）

T2：SPPでのtrn_expiration_timeオペランドの監視区間（トランザクションブランチ限界経過時間）

N1：SUPでのtrn_completion_limit_timeオペランドの監視区間（トランザクション完了限界時間）

N2：SPPでのtrn_completion_limit_timeオペランドの監視区間（トランザクション完了限界時間）

SPPプロセスのサービス関数が開始してから，コミット完了のメッセージを送信したあとまでの時間を監視します。

N2(a)：コミット最適化が行われた場合のtrn_completion_limit_timeオペランドの監視区間（トランザクション完了限界時間）

SPPプロセスのサービス関数が開始してから，プリペア完了のメッセージを送信したあとまでの時間を監視します。

N2(b)：プリペア最適化が行われた場合trn_completion_limit_timeオペランドの監視区間（トランザクション完了限界時間）

SPPプロセスのサービス関数が開始してから，サービス関数完了の応答を送信したあとまでの時間を監視します。

付録A.3　サービス応答の待ち時間

クライアントがサービス要求を送ってから，サービスの応答が返るまでの待ち時間について，図A-4に示します。

rapサーバがdc_rpc_call()を発行してから，サービスの応答が返るまでの待ち時間の最大値は，クライアント環境定義のDCWATCHTIMINHERITオペランドの指定によって異なります。

図A‒4　サービス応答の待ち時間

図中のt1〜t3について次に説明します。

t1

クライアントがdc_rpc_call()を発行してサービス要求してから，クライアントにサービスの応答が返るまでの待ち時間です。クライアント環境定義のDCWATCHTIMオペランドの指定値が待ち時間の最大値となります。

クライアント環境定義のDCCLTRAPAUTOCONNECTにYを指定している場合は，dc_rpc_call()内部でrapサーバとの間で常設コネクションを確立するため，コネクション確立の時間も含まれます。コネクション確立に時間が掛かる場合は，指定値を超えた時間でタイムアウトが発生することがあります。

t2

rapサーバがdc_rpc_call()を発行してサービス要求してから，rapサーバにサービスの応答が返るまでの待ち時間です。クライアント環境定義のDCWATCHTIMINHERITオペランドの指定によって最大値が異なります。

DCWATCHTIMINHERIT=Yの場合

クライアント環境定義のdcwatchtimオペランドの指定値からクライアント環境定義のdccltdelayオペランドの指定値を引いた値が待ち時間の最大値となります。

DCWATCHTIMINHERIT=Nの場合

rapリスナーサービス定義のwatch_timeオペランドの指定値が待ち時間の最大値となります。rapリスナーサービス定義でwatch_timeオペランドを省略した場合は，ユーザサービスデフォルト定義のwatch_timeオペランドの指定値が待ち時間の最大値となります。

t3

SPP1がdc_rpc_call()を発行してサービス要求してから，SPP1にサービスの応答が返るまでの待ち時間です。SPP1のユーザサービス定義のwatch_timeオペランドの指定値が待ち時間の最大値となります。ユーザサービス定義でwatch_timeオペランドを省略した場合は，ユーザサービスデフォルト定義のwatch_timeオペランドの指定値が待ち時間の最大値となります。

付録A.4　常設コネクション問い合わせ間隔最大時間の適用範囲

常設コネクション問い合わせ間隔最大時間は，クライアント環境定義のdccltinquretimeオペランドで指定します。クライアント環境定義でdccltinquretimeオペランドを省略した場合は，rapリスナーサービス定義のrap_inquire_timeオペランドの指定値が常設コネクション問い合わせ間隔最大時間となります。

常設コネクション問い合わせ間隔最大時間とは，CUPがrapサーバに対して問い合わせてから，次の問い合わせをするまでの間隔の最大値です。常設コネクション問い合わせ間隔最大時間は，CUP実行プロセスまたはrapサーバで監視します。

図A‒5　常設コネクション問い合わせ間隔最大時間の適用範囲

図中のt1〜t3は，常設コネクション問い合わせ間隔最大時間が適用される範囲でのrapサーバの監視時間です。

付録A.5　アプリケーションプログラムが閉塞する場合

UAPが異常終了すると，OpenTP1はUAPのプロセスを自動的に再起動させます。ただし，異常終了と再起動の繰り返しでシステムの処理がループしないように，OpenTP1は指定した回数を超えて異常終了したUAPを閉塞します。また，異常終了したUAPを閉塞することで，クライアントからのサービス要求に意図的にエラーを返して不要な再実行を防ぐようにしています。

閉塞の対象になるUAPは，SPP（ただし，キュー受信型サーバのSPP）です。SUP，オフラインの業務をするUAP，およびソケット受信型サーバのSPPは，閉塞の対象になりません。

以降の説明は，SPPについてのものです。MHPについては該当しません。

(1)　閉塞と監視時間の関係

異常終了したUAPをいつ閉塞するかは，監視時間と異常終了した回数で決まります。

TP1/Server Baseの場合，システム定義に指定した監視時間内にUAPが3回異常終了すると，OpenTP1は3回目の異常終了時にUAPを閉塞させます。TP1/LiNKの場合は，1回目の異常終了時にUAPを閉塞させます。閉塞の時間監視はしません。

監視時間内の異常終了回数が2回以内の場合は，UAPのプロセスをOpenTP1が再起動します。

時間の監視は，1回目の異常終了から開始します。異常終了回数が2回以内の場合でも，2回目の異常終了からさらに異常終了回数の監視が始まっています。

監視時間と異常終了回数の関係を次の図に示します。

図A‒6　監視時間と異常終了回数の関係

(2)　サービスグループ単位の閉塞とサービス単位の閉塞

UAPを閉塞する単位では，サービスグループ単位の閉塞とサービス単位の閉塞があります。サービス単位の閉塞を指定しておくと，監視時間内にUAPが3回異常終了しても，該当するサービスだけを閉塞します。そのため，同じサービスグループのほかのサービスは処理を続けられます。

サービス単位の閉塞を指定できるのは，キュー受信型サーバのSPPだけです。また，サービスグループ単位の閉塞を指定できるのは，OpenTP1の基本機能がTP1/Server Baseの場合だけです。TP1/LiNKのSPPの場合は，サービス単位の閉塞だけです。

(3)　アプリケーションプログラムの閉塞に関係するユーザサービス定義

UAPの閉塞に関係するユーザサービス定義を次に示します。ユーザサービス定義は，OpenTP1の基本機能がTP1/Server Baseの場合だけ指定できます。TP1/LiNKのSPPの場合は，UAPが異常終了した時点でサービス単位にすぐに閉塞します。

holdオペランド（SPP，MHPで有効）

UAPが異常終了した場合，すぐに閉塞するか，時間監視して閉塞するかを指定します。すぐに閉塞する場合はYを，時間監視して閉塞する場合はNを指定します。

service_holdオペランド（SPPで有効）

閉塞する単位をサービスグループ単位にするかサービス単位にするかを指定します。サービスグループ単位にする場合はNを，サービス単位にする場合はYを指定します。

term_watch_timeオペランド（SPP，MHPで有効）

時間監視して閉塞する場合の，サービスグループ単位の閉塞の監視時間を指定します。term_watch_timeオペランドの値は，service_term_watch_timeオペランドを指定した場合は無視されます。

service_term_watch_timeオペランド（SPPで有効）

時間監視して閉塞する場合の，サービス単位の閉塞の監視時間を指定します。service_term_watch_timeオペランドを指定した場合，term_watch_timeオペランドの値は無視されます。

閉塞に関するオペランドは，それぞれに指定した値の組み合わせによって，UAPが異常終了したあとに再起動するかまたは閉塞するかが決まります。オペランドの組み合わせと閉塞の有無の関係については，それぞれのオペランドの説明を参照してください。

付録B　共用メモリの見積もり式

TP1/Server Base用およびMCFサービス用の共用メモリの見積もり式について説明します。

付録B.1　TP1/Server Base用の共用メモリの見積もり式

TP1/Server Base用の共用メモリの見積もり式について説明します。ここで説明する見積もり式の単位はバイトです。

(1)　静的共用メモリの算出式（アーカイブジャーナルノードでないノードの場合）

システム環境定義のstatic_shmpool_sizeオペランドに指定する静的共用メモリの算出式について説明します。ここで説明する算出式に従って静的共用メモリを算出してください。

(a)　システムマネジャ

32ビットの場合

128×（システム環境定義のserver_countオペランドの指定値＋3）
＋6024＋dcstatsコマンドで統計情報のジャーナル出力を指定するユーザサーバの最大数×1024

64ビットの場合

128×（システム環境定義のserver_countオペランドの指定値＋3）＋8000
＋dcstatsコマンドで統計情報のジャーナル出力を指定するユーザサーバの最大数×1280

(b)　プロセスサーバ

Linux版32ビットの場合

960×prc_process_countオペランドの指定値＋62672

Linux版64ビットの場合

976×prc_process_countオペランドの指定値＋64720

AIX版32ビット，HP-UX版32ビットの場合

944×prc_process_countオペランドの指定値＋60624

AIX版64ビット，HP-UX版64ビットの場合

960×prc_process_countオペランドの指定値＋62672

Windows版(32ビット/64ビット)の場合

960×prc_process_countオペランドの指定値＋62672

(c)　タイマサーバ

32×tim_watch_countオペランドの指定値＋1440

(d)　スケジューラ

（凡例）

i：スケジュールバッファグループの定義数

j：scdbufgrp定義コマンドを指定しないサービスグループの定義数

k：ユーザサービス定義のservice_holdオペランドにYを指定したサービスグループの定義数

L：ユーザサービス定義のschedule_methodオペランドにnamedpipeを指定したサービスグループの定義数

M：マルチスケジューラグループ数

N：マルチスケジューラデーモン数

o：ユーザサービス定義にscdsvcdef定義コマンドを指定したサービスグループの定義数（キュー受信型サーバのSPPが対象です）

(e)　ロックサーバ

32ビットの場合

（lck_limit_foruserオペランドの指定値＋lck_limit_fordamオペランドの指定値
  ＋lck_limit_fortamオペランドの指定値＋lck_limit_formqaオペランドの指定値）
×544＋62016＋128

64ビットの場合

（lck_limit_foruserオペランドの指定値＋lck_limit_fordamオペランドの指定値
  ＋lck_limit_fortamオペランドの指定値＋lck_limit_formqaオペランドの指定値）
×544＋62432＋128

(f)　トランザクションマネジャ

32ビットの場合

2048＋1280×（RM名＋RM拡張子）数＋（816＋128×（RM名＋RM拡張子）数
＋128×trn_max_subordinate_countオペランドの指定値
＋↓（63＋4×（RM名＋RM拡張子）数）／32↓×32）
×trn_tran_process_countオペランドの指定値
＋（C×（trn_max_crm_subordinate_countオペランドの指定値＋1）
×trn_tran_process_countオペランドの指定値×1216）＋128

（凡例）

↓↓：小数点以下を切り捨てます。

C：trn_crm_useオペランドにYを指定した場合は1，Nを指定した場合は0になります。

64ビットの場合

2048＋1280×（RM名＋RM拡張子）数＋（816＋128×（RM名＋RM拡張子）数
＋128×trn_max_subordinate_countオペランドの指定値
＋↓（63＋4×（RM名＋RM拡張子）数）／32↓×32）
×trn_tran_process_countオペランドの指定値
＋（C×（trn_max_crm_subordinate_countオペランドの指定値＋1）
×trn_tran_process_countオペランドの指定値×1248）＋128

（凡例）

↓↓：小数点以下を切り捨てます。

C：trn_crm_useオペランドにYを指定した場合は1，Nを指定した場合は0になります。

(g)　ジャーナルサーバ

アーカイブジャーナルノードにはアーカイブされないノードの場合

4864＋256×jnladdfg定義コマンドの定義数
＋480×m×jnladdfg定義コマンドの定義数
＋64×m
＋128×（m×2＋1）
＋4096×m×i
＋↑(128×（34＋2×jnladdfg定義コマンドの定義数×2×m）／8064)↑×8192
＋↑（jnl_max_datasizeオペランドの指定値＋336）／4096↑×4096×(m×2＋1)
＋↑（jnl_max_datasizeオペランドの指定値＋336）／4096↑×4096×16×m
＋↑(388＋192×m)／4096↑×4096
＋n

（凡例）

↑↑：小数点以下を切り上げます。

i：システムジャーナルサービス定義のjnl_dualオペランドにYを指定した場合は2，Nを指定した場合は1になります。

m：システムジャーナルサービス定義のjnl_max_file_dispersionオペランドの指定値です。

n：システムジャーナルサービス定義のjnl_auto_unloadオペランドにYを指定した場合は128，Nを指定した場合は0になります。

アーカイブジャーナルノードによってアーカイブされるノードの場合

4864＋256×jnladdfg定義コマンドの定義数
＋480×m×jnladdfg定義コマンドの定義数
＋64×m
＋128×（m×2＋1）
＋4096×m×i
＋↑(128×（34＋2×jnladdfg定義コマンドの定義数×2×m）/8064)↑×8192
＋↑（jnl_max_datasizeオペランドの指定値＋336）／4096↑×4096×(m×2＋1)
＋↑（jnl_max_datasizeオペランドの指定値＋336）／4096↑×4096×16×m
＋↑(388＋192×m)／4096↑×4096
＋n
＋512
＋128×↓（j×1024×1024／（k×1024））↓
＋k×1024×↓（j×1024×1024／（k×1024））↓

（凡例）

↑↑：小数点以下を切り上げます。

↓↓：小数点以下を切り捨てます。

i：システムジャーナルサービス定義のjnl_dualオペランドにYを指定した場合は2，Nを指定した場合は1になります。

m：システムジャーナルサービス定義のjnl_max_file_dispersionオペランドの指定値です。

n：システムジャーナルサービス定義のjnl_auto_unloadオペランドにYを指定した場合は128，Nを指定した場合は1になります。

j：jnl_arc_buff_sizeオペランドに指定した値です。

k：jnl_arc_max_datasizeオペランドに指定した値です。

ジャーナルファイルレス機能を使用するノードの場合

共用メモリの所要量は，10,496バイトです。

(h)　チェックポイントダンプ

32ビットの場合

17872＋チェックポイントダンプサービス定義の定義数×1024
＋（チェックポイントダンプサービス定義のjnladdfgオペランドの定義数）×400

64ビットの場合

18640＋チェックポイントダンプサービス定義の定義数×1024
＋（チェックポイントダンプサービス定義のjnladdfgオペランドの定義数）×400

ジャーナルファイルレス機能を使用するノードの場合

共用メモリの所要量は，0バイトです。

(i)　サーバリカバリジャーナル

32ビットの場合

1376＋6272×n＋（↑（a＋336）／4096↑＋1）×4096×n

（凡例）

↑↑：小数点以下を切り上げます。

n：TP1/Message Queueを使用しない場合は，OpenTP1が提供するRM数＋2になります。TP1/Message Queueを使用する場合は，内部RM数＋3になります。

a：システムジャーナルサービス定義で指定する最大レコードデータ長になります。

64ビットの場合

4448＋6856×n＋（↑（a＋336）／4096↑＋1）×4096×n

（凡例）

↑↑：小数点以下を切り上げます。

n：TP1/Message Queueを使用しない場合は，OpenTP1が提供するRM数＋2になります。TP1/Message Queueを使用する場合は，内部RM数＋3になります。

a：システムジャーナルサービス定義で指定する最大レコードデータ長になります。

(j)　トランザクションジャーナル

ジャーナルファイルレス機能を使用しないノードの場合

13472＋1200×trn_tran_process_countオペランドの指定値
＋64×（trn_tran_process_countオペランドの指定値
        ×trn_max_subordinate_countオペランドの指定値）
＋（↑（J＋336）／4096↑）×4096
＋DAM＋TAM＋MCF＋MQ

（凡例）

↑↑

小数点以下を切り上げます。

J

システムジャーナルサービス定義で指定したjnl_max_datasizeオペランドの指定値になります。

DAM

TP1/FS/Direct Accessを使用しない場合は，0になります。

TP1/FS/Direct Accessを使用する場合は，次の算出式で求めた値になります。

128＋128×trn_tran_process_countオペランドの指定値
＋（4160＋（↑（J＋336）／4096↑×4096））
×（trn_recovery_process_countオペランドの指定値）
＋56×（trn_tran_process_countオペランドの指定値×2＋2）

TAM

TP1/FS/Table Accessを使用しない場合は，0になります。

TP1/FS/Table Accessを使用する場合は，次の算出式で求めた値になります。

4288＋240×trn_tran_process_countオペランドの指定値
＋（↑（J＋336）／4096↑）×4096

MCF

TP1/Message Controlを使用しない場合は，0になります。

TP1/Message Controlを使用する場合は，次の算出式で求めた値になります。

128＋240×trn_tran_process_countオペランドの指定値
＋（4160＋（↑（J＋336）／4096↑×4096））
×（trn_recovery_process_countオペランドの指定値）

MQ

TP1/Message Queueを使用しない場合は，0になります。

TP1/Message Queueを使用する場合は，次の算出式で求めた値になります。

4288＋240×trn_tran_process_countオペランドの指定値
＋（↑（J＋336）／4096↑）×4096

ジャーナルファイルレス機能を使用するノードの場合

共用メモリの所要量は，0バイトです。

(k)　ステータスサーバ

共用メモリの所要量は，64バイトです。

(l)　ネームサーバ

（name_total_sizeオペランドの指定値＋name_cache_sizeオペランドの指定値）
×1024

name_total_size，およびname_cache_sizeの算出式を次に示します。

ノード自動追加機能を使用しない場合

name_total_size=↑(7616＋(all_nodeのノード数×384
                ＋all_node_exのノード数×284
                ＋all_node_extend_numberオペランドの指定値※1×384
                ＋all_node_ex_extend_numberオペランドの指定値※2×284)
                ＋((SPP数※3＋rapサーバ数※4＋XATMI数※5)×264)
                ＋MCF※6＋DAM※7＋TAM※8＋CLT※9)／1024↑

name_cache_size=↑（all_nodeオペランドおよびall_node_exオペランド
                に指定したノード※10で起動するSPP数※3の総計×224）／1024↑

（凡例）

↑↑：小数点以下を切り上げます。

注※1

システム共通定義のall_node_extend_numberオペランドを省略した場合は64になります。

注※2

システム共通定義のall_node_ex_extend_numberオペランドを省略した場合は64になります。

注※3

サービスグループの数になります。

注※4

rapサーバを起動する場合は，rapサービス数を指定します。

注※5

XATMI-APIを使用する場合は，XATMIのSPPで定義したサービスの総数になります。

注※6

TP1/Message Controlを使用する場合は，次の算出式で求めた値になります。

（1＋MCF通信サービスの数
＋アプリケーション起動サービスの数
＋マッピングサービスの数
（TP1/NET/XMAP3を使用する場合は，1になります。使用しない場合は，0になります。）
＋MCFオンラインコマンドサービスの数
（TP1/NET/XMAP3を使用する場合は，1になります。使用しない場合は，0になります。）
＋MHPのサービスグループ数）×264

注※7

TP1/FS/Direct Accessを使用する場合は，936になります。

注※8

TP1/FS/Table Accessを使用する場合は，1424になります。

注※9

クライアント拡張サービス機能を使用する場合は，936になります。

注※10

システム共通定義のall_nodeオペランドおよびall_node_exオペランドに指定したノードか，またはドメイン定義ファイルに指定したノードです。

ノード自動追加機能を使用する場合

name_total_size=↑(7936＋(all_node_exのノード数×284)
                ＋all_node_ex_extend_numberオペランドの指定値※1×284
                ＋163840
                ＋((SPP数※2＋rapサーバ数※3＋XATMI数※4)×264)
                ＋MCF※5＋DAM※6＋TAM※7＋CLT※8)／1024↑

name_cache_size=↑（ノードリストに登録されるノード
                およびall_node_exオペランドに指定したノード※9で起動する
                SPP数※2の総計×224）／1024↑

（凡例）

↑↑：小数点以下を切り上げます。

注※1

システム共通定義のall_node_ex_extend_numberオペランドを省略した場合は64になります。

注※2

サービスグループの数になります。

注※3

rapサーバを起動する場合は，rapサービス数を指定します。

注※4

XATMI-APIを使用する場合は，XATMIのSPPで定義したサービスの総数になります。

注※5

TP1/Message Controlを使用する場合は，次の算出式で求めた値になります。

（1＋MCF通信サービスの数
＋アプリケーション起動サービスの数
＋マッピングサービスの数
（TP1/NET/XMAP3を使用する場合は，1になります。使用しない場合は，0になります。）
＋MCFオンラインコマンドサービスの数
（TP1/NET/XMAP3を使用する場合は，1になります。使用しない場合は，0になります。）
＋MHPのサービスグループ数）×264

注※6

TP1/FS/Direct Accessを使用する場合は，936になります。

注※7

TP1/FS/Table Accessを使用する場合は，1424になります。

注※8

クライアント拡張サービス機能を使用する場合は，936になります。

注※9

システム共通定義のall_nodeオペランドおよびall_node_exオペランドに指定したノードか，またはドメイン定義ファイルに指定したノードです。

(m)　キューサーバ

ディスクキューを使用する場合，次に示す算出式に従って算出します（メモリキューだけの構成のときは見積もり不要です）。

32ビットの場合

（凡例）

↑↑：小数点以下を切り上げます。

n：メッセージキューサービス定義のquegrp定義コマンドの定義数

注※1

quegrp定義コマンドで定義したそれぞれの物理ファイルのレコード数の合計値。物理ファイルのレコード数は，queinitコマンドの-nオプションで指定します。

注※2

queinitコマンドの-nオプションに指定したレコード数。

注※3

queinitコマンドの-sオプションに指定したレコード長。

64ビットの場合

（凡例）

↑↑：小数点以下を切り上げます。

n：メッセージキューサービス定義のquegrp定義コマンドの定義数

注※1

quegrp定義コマンドで定義したそれぞれの物理ファイルのレコード数の合計値。物理ファイルのレコード数は，queinitコマンドの-nオプションで指定します。

注※2

queinitコマンドの-nオプションに指定したレコード数。

注※3

queinitコマンドの-sオプションに指定したレコード長。

(n)　性能検証用トレース取得サービス

prf_traceオペランドにNを指定した場合

共用メモリの所要量は，1,024バイトです。

prf_traceオペランドにYを指定した場合

1553440＋prf_buff_sizeオペランドの指定値×1024＋MCF

（凡例）

MCF

・TP1/Message Controlを使用しない場合：0

・TP1/Message Controlを使用する場合：98304

(o)　rapリスナーおよびrapサーバ

1024＋148×A＋↑（A／8）↑＋260×B

（凡例）

↑↑：小数点以下を切り上げます。

A：rap_parallel_serverオペランドの指定値になります。

B：rap_max_clientオペランドの指定値になります。

(p)　XAリソースサービス

672＋A×trn_tran_process_countオペランドの指定値

（凡例）

A：xar_msdtc_useオペランドにNを指定するか，または指定を省略した場合は，288です。xar_msdtc_useオペランドにYを指定した場合は，xarfile定義コマンドで指定したXARファイルのレコード長です。

(q)　DAM

32ビットの場合

288×（damfile定義コマンドの定義数＋dam_added_fileオペランドの指定値）
＋288＋512

64ビットの場合

320×（damfile定義コマンドの定義数＋dam_added_fileオペランドの指定値）
＋304＋512

(r)　IST

2336＋（48×ISTサービス定義に定義したテーブル数）＋512

(s)　メッセージキュー（Windows版）

16＋（72＋12×n1）×n2

（凡例）

n1：すべてのユーザサービス定義の中で次の算出式が最大となる値です。

↑message_store_buflenオペランドの指定値／message_cell_sizeオペランドの指定値↑

rapリスナーサービス定義の場合は，rap_parallel_serverオペランドの指定値が3以下のとき，8になります。

rap_parallel_serverオペランドの指定値が4以上のときは次の算出式になります。

↑rap_parallel_serverオペランドの指定値×2.1↑

n2：スケジュールサービス定義のscd_server_countオペランドの指定値＋5になります。

↑↑：小数点以下を切り上げます。

(t)　リアルタイム統計情報サービス

共用メモリの所要量は，64バイトです。

(u)　クライアント拡張サービス

M×N

（凡例）

M：クライアントサービス定義のmessage_store_buflenオペランドの指定値

N：トランザクションRPC実行プロセス，およびCUP実行プロセスをあわせて使用する場合は2です。トランザクションRPC実行プロセス，またはCUP実行プロセスのどちらかを使用する場合は1です。

(v)　XATMI通信サービス

共用メモリの所要量は，32バイトです。

(w)　MCFサービス

MCFサービス用の共用メモリの算出式については，「付録B.2　MCFサービス用の共用メモリの見積もり式」を参照してください。

(x)　TP1/Message Queue

TP1/Message Queue用の共用メモリの算出式については，マニュアル「TP1/Message Queue使用の手引」の共用メモリの見積もり式について説明している個所を参照してください。

(2)　静的共用メモリの算出式（アーカイブジャーナルノードの場合）

システム環境定義のstatic_shmpool_sizeオペランドに指定する静的共用メモリの算出式について説明します。ここで説明する算出式に従って静的共用メモリを算出してください。

(a)　システムマネジャ

128×（システム環境定義のserver_countオペランドの指定値＋3）＋5487
＋dcstatsコマンドで統計情報のジャーナル出力を指定するユーザサーバの最大数×1024

(b)　プロセスサーバ

共用メモリの所要量は，251,648バイトです。

(c)　タイマサーバ

32×tim_watch_countオペランドの指定値＋1440

(d)　ジャーナルサーバ

（凡例）

↑↑：小数点以下を切り上げます。

r：グローバルアーカイブジャーナルサービス定義のjnldfsv -aで指定したリソースグループ数になります。

d：リソースグループiの二重化係数になります。

・jnl_dualオペランドがNの場合：1

・jnl_dualオペランドがYの場合：2

m：リソースiで指定したjnl_max_file_dispersionオペランドの指定値になります。

(e)　ネームサーバ

ノード自動追加機能を使用しない場合

（name_total_sizeオペランドの指定値＋name_cache_sizeオペランドの指定値）×1024

name_total_size，およびname_cache_sizeの算出式を次に示します。

name_total_size=↑（7616＋all_nodeオペランドのノード数×384
                ＋all_node_exオペランドのノード数×284
                ＋all_node_extend_numberオペランドの指定値※1×384
                ＋all_node_ex_extend_numberオペランドの指定値※2×284）
                 ／1024↑
name_cache_size=↑（該当アーカイブジャーナルノードに接続する被アーカイブ
                 ジャーナルノード数×224）／1024↑

ノード自動追加機能を使用する場合

（name_total_sizeオペランドの指定値＋name_cache_sizeオペランドの指定値）×1024

name_total_size，およびname_cache_sizeの算出式を次に示します。

name_total_size=↑（7936＋all_node_exオペランドのノード数×284
                ＋all_node_ex_extend_numberオペランドの指定値※2×284
                ＋163840）／1024↑
name_cache_size=↑（該当アーカイブジャーナルノードに接続する被アーカイブ
                 ジャーナルノード数×224）／1024↑

（凡例）

↑↑：小数点以下を切り上げます。

注※1

システム共通定義のall_node_extend_numberオペランドを省略した場合は64になります。

注※2

システム共通定義のall_node_ex_extend_numberオペランドを省略した場合は64になります。

(f)　性能検証用トレース取得サービス

prf_traceオペランドにNを指定した場合

共用メモリの所要量は，1,024バイトです。

prf_traceオペランドにYを指定した場合

1553440＋prf_buff_sizeオペランドの指定値×1024＋MCF

（凡例）

MCF

・TP1/Message Controlを使用しない場合：0

・TP1/Message Controlを使用する場合：98304

(3)　動的共用メモリの算出式

システム環境定義のdynamic_shmpool_sizeオペランドに指定する動的共用メモリの算出式について説明します。ここで説明する算出式に従って動的共用メモリを算出してください。

なお，ここで説明する算出式は，アーカイブジャーナルノードでないノードの場合です。アーカイブジャーナルノードの場合は動的共用メモリの値に0を指定してください。

(a)　トランザクションジャーナル

ジャーナルファイルレス機能を使用しないノードの場合

（（（1＋（↑（システムジャーナルサービス定義で指定したjnl_max_datasizeオペランドの指定値＋512）／4096↑））×4096）＋32）×trn_tran_process_countオペランドの指定値

（凡例）

↑↑：小数点以下を切り上げます。

このノードに，trf_put=Yを指定したユーザサーバがない場合，共用メモリの所要量は，0バイトです。

ジャーナルファイルレス機能を使用するノードの場合

共用メモリの所要量は，0バイトです。

(b)　キューサーバ

ディスクキューを使用する場合，次に示す算出式に従って算出します（メモリキューだけの構成のときは見積もり不要です）。

32ビットの場合

↑（複数のトランザクションで同期点処理までに，同時に要求するメッセージ数×48＋32）／8192↑×（8192＋512）

（凡例）

↑↑：小数点以下を切り上げます。

64ビットの場合

↑（複数のトランザクションで同期点処理までに，同時に要求するメッセージ数×64＋56）／8192↑×（8192＋512）

（凡例）

↑↑：小数点以下を切り上げます。

(c)　DAM

32ビットの場合

トランザクションアクセス種別がブランチアクセスの場合

（484×↑1トランザクションブランチでオープンしているファイル数／10↑＋72×dam_update_blockオペランドの指定値＋692）
×同時実行トランザクションブランチ数

トランザクションアクセス種別がグローバルアクセスの場合

（484×↑1トランザクションブランチでオープンしているファイル数／10↑＋72×dam_update_blockオペランドの指定値＋692）
×同時実行トランザクションブランチ数
＋（128＋52×↑1グローバルトランザクションで発生するトランザクションブランチ数／10↑）
×同時実行グローバルトランザクション数

（凡例）

↑↑：小数点以下を切り上げます。

64ビットの場合

トランザクションアクセス種別がブランチアクセスの場合

（488×↑1トランザクションブランチでオープンしているファイル数／10↑＋72×dam_update_blockオペランドの指定値＋728）
×同時実行トランザクションブランチ数

トランザクションアクセス種別がグローバルアクセスの場合

（488×↑1トランザクションブランチでオープンしているファイル数／10↑＋72×dam_update_blockオペランドの指定値＋728）
×同時実行トランザクションブランチ数
＋（160＋96×↑1グローバルトランザクションで発生するトランザクションブランチ数／10↑）
×同時実行グローバルトランザクション数

（凡例）

↑↑：小数点以下を切り上げます。

(d)　TAM

32ビットの場合

↑（128＋32×tam_max_tblnumオペランドの指定値＋24）／512↑×512

64ビットの場合

↑（192＋48×tam_max_tbl_numオペランドの指定値＋40）／512↑×512

（凡例）

↑↑：小数点以下を切り上げます。

(e)　MCFサービス

MCFサービス用の共用メモリの算出式については，「付録B.2　MCFサービス用の共用メモリの見積もり式」を参照してください。

(f)　TP1/Message Queue

TP1/Message Queue用の共用メモリの算出式については，マニュアル「TP1/Message Queue使用の手引」の共用メモリの見積もり式について説明している個所を参照してください。

(4)　DAMサービス用の共用メモリの算出式

DAMブロックを退避するためのバッファ領域用の共用メモリの算出式について説明します。次に示すD1またはD2のうち，どちらか大きい値に1024を加えた値が算出結果になります。

D1=DAMサービス定義のdam_cache_sizeオペランドで指定したバッファ領域長
D2=A＋B

（凡例）

A：（Mb／64＋1）×128×n×Tr

B：｛↓（A／576）↓｝×32＋64

↓↓：小数点以下を切り捨てます。

Mb：DAMサービス定義で定義した論理ファイルの中で最大ブロック長を持つファイルのブロック長＋8（セクタ長の倍数）

n：DAMサービス定義のdam_update_blockオペランドで指定した最大更新ブロック数

Tr：DAMサービス定義のdam_tran_process_countオペランドで定義したトランザクションブランチ数

DAMサービス用の共用メモリとして確保されるバッファ領域長をDAMサービス定義のdam_cache_sizeオペランドまたはdam_cache_size_fixオペランドに指定した場合，自動的にバイトに換算されます。そのときに，1キロバイト当たり1,000バイトで換算するか，1,024バイトで換算するかをdam_kb_sizeオペランドで指定できます。詳細については，DAMサービス定義のdam_kb_sizeオペランドを参照してください。

DAMサービス定義のdam_cache_attributeオペランドにhugepageを指定した場合，上記算出値をページサイズ（単位：バイト）※で切り上げてください。

注※

ページサイズは，「grep Hugepagesize /proc/meminfo」を実行して確認できます。ページサイズを確認する際は単位に注意してください。

(5)　TAMサービス用の共用メモリの算出式

オンライン中に使用するTAMテーブルはすべて共用メモリ上にロードされるため，共用メモリ所要量はTAMファイルの容量に依存します。TAMテーブル用の共用メモリは次に示す算出式に従って算出してください。

(a)　32ビットの場合

（凡例）

n：TAMサービス定義で指定したtamtable定義コマンドの数（tamtable数）

Fa：TAMサービス定義で定義したトランザクション内最大アクセステーブル数（tam_max_trnfilnum）

Fb：TAMサービス定義で定義した同時走行最大トランザクションブランチ数（tam_max_trnnum）

Fc：TAMサービス定義で定義したオンライン中に使用するTAMファイルの最大数（tam_max_tblnum）

Fd：↑（320＋256×Fb）／Fe↑×2＋Fb×2

Fe：（72＋128×Fa）を32の整数倍に切り上げた値

Fg：（210＋Fd×4）を16の整数倍に切り上げた値

Fm：TAMサービス定義で定義したオンライン中に使用するTAMファイルの最大容量（tam_max_filesize）を16の整数倍に切り上げた値

Fs：tamtable定義コマンドで指定したTAMファイル個々のファイル容量（TAMファイルの容量は，マニュアル「OpenTP1 運用と操作」を参照）

TAMテーブル用の共用メモリ量は，使用するTAMファイルの合計サイズの2倍以上必要です。なお，TAMテーブル用の共用メモリとして確保できるサイズは，全体として2ギガバイト未満です。ただし，2ギガバイト未満であっても，動作環境（OSの制限値など）によっては確保できない場合があります。

(b)　64ビットの場合

（凡例）

n：TAMサービス定義で指定したtamtable定義コマンドの数（tamtable数）

Fa：TAMサービス定義で定義したトランザクション内最大アクセステーブル数（tam_max_trnfilnum）

Fb：TAMサービス定義で定義した同時走行最大トランザクションブランチ数（tam_max_trnnum）

Fc：TAMサービス定義で定義したオンライン中に使用するTAMファイルの最大数（tam_max_tblnum）

Fd：↑（320＋256×Fb）／Fe↑×2＋Fb×2

Fe：（72＋128×Fa）を32の整数倍に切り上げた値

Fg：（234＋Fd×4）を16の整数倍に切り上げた値

Fm：TAMサービス定義で定義したオンライン中に使用するTAMファイルの最大容量（tam_max_filesize）を16の整数倍に切り上げた値

Fs：tamtable定義コマンドで指定したTAMファイル個々のファイル容量（TAMファイルの容量は，マニュアル「OpenTP1 運用と操作」を参照）

TAMテーブル用の共用メモリ量は，使用するTAMファイルの合計サイズの2倍以上必要です。なお，TAMテーブル用の共用メモリとして確保できるサイズは，全体として16ギガバイト未満です。ただし，16ギガバイト未満であっても，動作環境（OSの制限値など）によっては確保できない場合があります。

TAMサービス定義のtam_pool_attriオペランドにhugepageを指定した場合，上記算出値をページサイズ（単位：バイト）※で切り上げてください。

注※

ページサイズは，「grep Hugepagesize /proc/meminfo」を実行して確認できます。ページサイズを確認する際は単位に注意してください。

(6)　ISTサービス用の共用メモリの算出式

ISTテーブル用の共用メモリは次に示す算出式に従って算出してください。

(7)　リアルタイム統計情報サービス用の共用メモリの算出式

リアルタイム統計情報サービス用の共用メモリは次に示す算出式に従って算出してください。

304＋（↑（4×rts_service_maxオペランドの指定値）／8↑×8）
＋（104×（rts_service_maxオペランドの指定値＋1））
＋（144×rts_item_maxオペランドの指定値×（rts_service_maxオペランドの指定値＋1））

(8)　監査ログ機能で使用する共用メモリの所要量

監査ログ機能を使用する場合（log_audit_outオペランドにYを指定した場合），監査ログを取得するためのバッファ領域として共用メモリを使用します。監査ログの取得で使用する共用メモリの所要量は1,024バイトです。

(9)　共用メモリプールのサイズの算出式

共用メモリプールのサイズは次に示す算出式に従って算出してください。

OpenTP1制御用共用メモリ（約10,240キロバイト）
＋システム環境定義のstatic_shmpool_sizeオペランドの指定値
＋システム環境定義のdynamic_shmpool_sizeオペランドの指定値

システム環境定義のshmpool_attributeオペランドにhugepageを指定した場合は，上記算出値をページサイズ（単位：KB）※で切り上げてください。

注※

ページサイズは，「grep Hugepagesize /proc/meminfo」を実行して確認できます。ページサイズを確認する際は単位に注意してください。

(10)　OpenTP1監視機能用の共用メモリの所要量

OpenTP1監視機能用の共用メモリの所要量は，4,096バイトです。

付録B.2　MCFサービス用の共用メモリの見積もり式

MCFサービス用の共用メモリの算出式について説明します。ここで説明するサイズの単位はバイトです。

(1)　静的共用メモリ

ここで説明する算出結果の合計値がMCFサービスで使用する静的共用メモリのサイズです。

ほかのOpenTP1のサービスが使用する静的共用メモリにMCFサービスで使用する静的共用メモリを加え，システム環境定義のstatic_shmpool_sizeオペランドに指定してください。また，「付録B.2(1)(a)　MCFマネジャプロセス」の算出式2，および「付録B.2(1)(b)　MCF通信プロセスおよびアプリケーション起動プロセス」の算出式2を除いた算出結果の合計値をMCFマネジャ定義のmcfmcomn定義コマンドの-pオプションに指定してください。

MCFサービス用の静的共用メモリの算出式と定義指定値の関係を，次に示します。

図B‒1　MCFサービス用の静的共用メモリの算出式と定義指定値の関係

以降，図中の(a)から(d)について説明します。

(a)　MCFマネジャプロセス

MCFマネジャプロセスで使用する共用メモリのサイズは，それぞれ次に示す二つの算出式の結果の合計値です。MCFマネジャプロセスは，OpenTP1システム内で一つのプロセスを使用します。

算出式1：

32ビットの場合

21000＋2000×A＋600×B＋400×C＋1000×D＋400×E＋400×F＋500×G＋400×H＋400×I

64ビットの場合

29000＋2800×A＋800×B＋400×C＋1300×D＋500×E＋500×F＋700×G＋400×H＋500×I

（凡例）

A：MCF通信プロセスおよびアプリケーション起動プロセス数（mcfmcname定義コマンドの指定数）

B：論理端末総数（すべてのmcftalcle定義コマンドの指定数）

C：アプリケーション総数（すべてのmcfaalcap定義コマンドの指定数）

D：MHPサービスグループ数

E：MHPサービス総数（各MHPサービスグループ内のサービス数の合計）

F：キューグループ数（mcfmqgid定義コマンドの指定数）

G：メッセージ送信を行うUAPプロセス数

H：MCF構成変更再開始機能を使用しない場合は，0になります。MCF構成変更再開始機能を使用する場合は，1になります。

I：同時に実行するタイマ起動によるアプリケーション起動要求数

算出式2：

106000＋200×A＋B

（凡例）

A：メッセージ出力通番使用論理端末数（mcfmcomn定義コマンドの-nオプションの指定値）

B：MCFメッセージ回復用作業領域長（mcfmcomn定義コマンドの-lオプションの指定値）

(b)　MCF通信プロセスおよびアプリケーション起動プロセス

MCF通信プロセスおよびアプリケーション起動プロセスで使用する共用メモリのサイズは，次に示す二つの算出式の結果の合計値です。MCF通信プロセスおよびアプリケーション起動プロセスは，OpenTP1システム内でmcfmcname定義コマンドの定義数分のプロセスを使用します。

算出式1：

32ビットの場合

4000＋A×B＋C×D＋800×E＋800×F＋（100＋G）×H＋600×I

64ビットの場合

5500＋A×B＋C×D＋900×E＋900×F＋（100＋G）×H＋800×I

（凡例）

A，C：プロセスおよび使用する通信プロトコル対応製品によって次のように値が異なります。

プロセス

通信プロトコル対応製品

A

C

アプリケーション起動プロセス

−

32ビットの場合

1200

64ビットの場合

1500

32ビットの場合

3300

64ビットの場合

4000

MCF通信プロセス

TP1/NET/OSAS-NIF

1000

4500

TP1/NET/UDP

−

32ビットの場合

3500

64ビットの場合

4200

上記以外

32ビットの場合

500

64ビットの場合

600

32ビットの場合

3000

64ビットの場合

3600

（凡例）

−：該当しない

B：コネクション数（mcftalccn定義コマンドの指定数）

アプリケーション起動プロセスの場合は1です。TP1/NET/UDPのMCF通信プロセスの場合は0です。

D：論理端末数（mcftalcle定義コマンドの指定数）

E：出力キューにたまる送信メッセージの最大数※（ディスクキューおよびメモリキューの両方を含みます）

F：アプリケーション数（mcfaalcap定義コマンドの指定数）

G：ユーザタイマ監視機能の最大メッセージ長（mcfttim定義コマンドのmsgsizeオペランドの指定値）

H：最大タイマ監視要求数（mcfttim定義コマンドのtimereqnoオペランドの指定値）

I：コネクショングループ数（mcftgrpcn定義コマンドの指定数）

注※

システムとして想定する論理端末ごとの滞留数の総和を指定してください。なお，少なくとも同時に送信する論理端末の最大数を指定してください。

指定した数が正しいかどうかは，-mオプションを指定したmcftlsleコマンド，またはmcfalspsvコマンドを実行し，最大未送信メッセージ数を確認してください。

算出式2：

21000＋2×A

（凡例）

A：MCFのトレースバッファサイズ（mcfttrc定義コマンドのsizeオペランドの指定値）

(c)　MCFオンラインコマンドプロセス

MCFオンラインコマンドプロセスで使用する共用メモリのサイズは，512バイトです。MCFオンラインコマンドプロセスは，TP1/NET/XMAP3を使用する場合に，一つのプロセスを使用します。TP1/NET/XMAP3を使用しない場合，プロセスは発生しません。

(d)　MCFマッピングプロセス

MCFマッピングプロセスで使用する共用メモリのサイズは，次に示す算出式の算出結果です。MCFマッピングプロセスは，TP1/NET/XMAP3を使用する場合に，一つのプロセスを使用します。TP1/NET/XMAP3を使用しない場合，プロセスは発生しません。

1300＋10000×A＋Σ（32×B＋300×C）＋D＋E＋F×G

（凡例）

Σ（）：各マッピングサービス属性定義について括弧内を計算した結果のすべての定義総計

A：マッピングサービス識別子（マッピングサービス定義に記述したマッピングサービス識別子の数）

B：常駐管理をする物理マップ数（マッピングサービス属性定義のMAPNAMEの指定数）

C：LRU管理をする物理マップ数（マッピングサービス属性定義のMAPCNTの指定数）

D：全常駐させる物理マップサイズの合計

E：LRU管理をする64キロバイト以下の全非常駐物理マップのサイズの合計

F：LRU管理をする64キロバイトを超える全非常駐物理マップ中，サイズの最大値

G：LRU管理をする64キロバイトを超える全非常駐物理マップ数

(2)　動的共用メモリ

ここで説明する算出結果の合計値がMCFサービスで使用する動的共用メモリのサイズです。ほかのOpenTP1のサービスが使用する動的共用メモリにMCFサービスで使用する動的共用メモリを加え，システム環境定義のdynamic_shmpool_sizeオペランドに指定してください。

(a)　MCFマネジャプロセス

MCFマネジャプロセスで使用する共用メモリは，次に示す算出式の算出結果です。MCFマネジャプロセスは，OpenTP1システム内で一つのプロセスを使用します。

（（600＋A）×B＋1600）×C＋2000×D＋1600×E＋（600＋F）×G×H＋2×（1600×H）＋1600×I＋2×（600＋J）×K

（凡例）

A：最大受信メッセージ長

B：最大受信セグメント数

C：すべての入力キュー（メモリキュー）にたまる受信メッセージの最大数※1（ディスクキューの場合は0です）

D：メッセージの受信，または送信を行うUAPプロセス数

E：すべての入力キューにたまる受信メッセージの最大数※1（ディスクキューおよびメモリキューの両方を含みます）

F：最大送信メッセージ長

G：最大送信セグメント数

H：すべての出力キュー（メモリキュー）にたまる送信メッセージの最大数※2（ディスクキューの場合は0です）

I：すべての出力キューにたまる送信メッセージの最大数※2（ディスクキューおよびメモリキューの両方を含みます）

J：継続問い合わせ応答用一時記憶データ格納用領域サイズの最大値（すべてのcont型のアプリケーションのmcfaalcap定義コマンドのtempsizeオペランドの指定値の最大値）

K：継続問い合わせ応答形態の通信を行う論理端末数

注※1

システムとして想定するサービスグループごとの滞留数の総和を指定してください。

指定した数が正しいかどうかは，-mオプションを指定したmcftlssgコマンドを実行し，最大未処理受信メッセージ数を確認してください。

注※2

システムとして想定する論理端末ごとの滞留数の総和を指定してください。なお，少なくとも同時に送信する論理端末の最大数を指定してください。

指定した数が正しいかどうかは，-mオプションを指定したmcftlsleコマンド，またはmcfalspsvコマンドを実行し，最大未送信メッセージ数を確認してください。

(b)　MCFオンラインコマンドプロセス

MCFオンラインコマンドプロセスで使用する共用メモリは，14,000バイトです。MCFオンラインコマンドプロセスは，OpenTP1システム内にプロセスは発生しません。TP1/NET/XMAP3を使用する場合に，一つのプロセスを使用します。

付録C　監査イベントを取得する定義

監査イベントに対応するメッセージIDと，それぞれのメッセージを出力するために指定する定義を次の表に示します。

表C‒1　監査ログのメッセージIDと指定する定義

監査イベント

log_audit_messageオペランドを指定する定義

メッセージID

ログサービス定義

ユーザサービス定義

rapリスナーサービス定義

rapクライアントマネジャサービス定義

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※1

OpenTP1サービスの停止

○

−

−

−

KFCA33421-I※1

UAPからユーザが任意に取得する監査ログの取得

○

○

−

−

KFCA34000-x〜KFCA34999-x※2

（凡例）

○：log_audit_messageオペランドにメッセージIDを指定することで監査イベントが発生したときに該当メッセージが出力されます。

−：log_audit_messageオペランドにメッセージIDを指定しても無効です（該当メッセージは出力されません）。

注※1

Windows版だけで出力されるメッセージIDです。

注※2

KFCA34000-x〜KFCA34999-xは，UAPで任意の監査ログを取得する場合に，監査ログに対して割り当てられるメッセージIDです。xにはdc_log_audit_print関数で指定したメッセージの種類（E，WまたはI）が入ります。

付録D　定義チェックの詳細

定義チェック時に出力されるメッセージおよび問題識別コードと，それらに対応するチェック対象の定義ファイル名，オペランド名，定義コマンド名などを表D-1に示します。

表D-1のヘッダで使用する用語の意味を次に示します。

「コード」：問題識別コード

「ID」：出力されるメッセージID

「区分」：メッセージ区分

メッセージ区分の記号の意味を次に示します。

C：CHECK（オペランド値の妥当性について確認を促す場合に出力されます）

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

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

「ファイル名」：チェック対象の定義ファイル名（定義ファイル名を任意に指定できる場合は定義名）

「定義」：チェック対象のオペランド名，定義コマンド名など

「関連ファイル名」：チェック時に比較対象となる定義ファイル名

「関連定義」：チェック時に比較対象となるオペランド名，定義コマンド名など

「条件式または判断根拠」：チェックの条件，またはチェック結果に至る判断根拠

表D‒1　定義チェックの詳細

項番

コード

ID

区分

ファイル名

定義

関連ファイル名

関連定義

条件式または判断根拠

備考

1

ADM-0001

KFCA00268-W

E

env

user_command

−

−

ファイルが存在しない

ADM#1

ADM#2

2

ADM-0002

KFCA00268-W

E

env

user_command

−

−

ファイルにアクセスできない

ADM#1

ADM#2

3

ADM-0003

KFCA00268-W

E

env

user_command

−

−

ファイルパスが長過ぎる

ADM#1

ADM#2

4

ADM-0004

KFCA00268-W

E

env

user_command

−

−

実行可能なファイルではない

ADM#1

ADM#2

ADM#3

5

ADM-0005

KFCA00268-W

E

env

user_command

−

−

ファイルではない

ADM#1

ADM#2

6

ADM-0006

KFCA00268-W

E

env

user_command_online

−

−

ファイルが存在しない

ADM#1

ADM#2

7

ADM-0007

KFCA00268-W

E

env

user_command_online

−

−

ファイルにアクセスできない

ADM#1

ADM#2

8

ADM-0008

KFCA00268-W

E

env

user_command_online

−

−

ファイルパスが長過ぎる

ADM#1

ADM#2

9

ADM-0009

KFCA00268-W

E

env

user_command_online

−

−

実行可能なファイルではない

ADM#1

ADM#2

ADM#3

10

ADM-0010

KFCA00268-W

E

env

user_command_online

−

−

ファイルではない

ADM#1

ADM#2

11

ADM-0011

KFCA00270-W

C

env

user_command_online_tp1mngr_id

env

user_command_online

(user_command_online_tp1mngr_id指定あり) && (user_command_online指定なし)

OSがWindows以外の場合だけチェック対象です。

12

ADM-0012

KFCA00276-W

C

env

user_server_ha

sysconf

ha_conf

(user_server_ha == Y) && (ha_conf != Y)

−

13

ADM-0013

KFCA00269-W

C

betranrc

dcstart_wakeup_retry_interval

betranrc

dcstart_wakeup_retry_count

(dcstart_wakeup_retry_interval指定あり)

&& (dcstart_wakeup_retry_count == 0)

−

14

ADM-0014

KFCA00270-W

C

betranrc

dcstart_wakeup_retry_interval

betranrc

dcstart_wakeup_retry_count

(dcstart_wakeup_retry_interval指定あり)

&& (dcstart_wakeup_retry_count指定なし)

−

15

ADM-0015

KFCA00286-W

E

betranrc

node_id

−

−

betranrc定義ファイルが存在しない

−

16

ADM-0016

KFCA00285-W

E

betranrc

node_id

−

−

node_id指定なし

−

17

ADM-0017

KFCA01880-W

W

betranrc

dcbindht

sysconf

ha_conf

(ha_conf == Y) && (dcbindht指定なし)

−

18

ADM-0018

KFCA00266-W

C

betranrc

prc_port

−

−

prc_port指定あり

−

19

ADM-0019

KFCA00282-W

C

betranrc

multi_node_option

−

−

multi_node_option指定あり

OSがWindowsまたはLinuxの場合，チェック対象の定義はサポートしていません。

20

ADM-0020

KFCA33301-E

E

sysconf

dam_conf

tam_conf

mqa_conf

jar_conf

dcsvstart -m

betranrc

jnl_fileless_option

(jnl_fileless_option==Y&&dam_conf==Y)

|| (jnl_fileless_option==Y&&tam_conf==Y)

|| (jnl_fileless_option==Y&&mqa_conf==Y)

|| (jnl_fileless_option==Y&&jar_conf==Y)

|| (jnl_fileless_option==Y&&dcsvstart -m指定あり)

−

21

ADM-0021

KFCA00280-W

C

sysconf

ha_conf

env

ha_switch_error_retry_count

(ha_conf==N) && (ha_switch_error_retry_count指定あり)

−

22

ADM-0022

KFCA00278-W

C

env

ha_switch_error_retry_count

env

ha_switch_error_retry_interval

(ha_switch_error_retry_count ==0) && (ha_switch_error_retry_interval指定あり)

−

23

−

KFCA01868-E

−

sysconf

dcsvstart

−

−

先頭が_muではない

−

24

−

KFCA01866-E

−

sysconf

dcsvstart

−

−

重複したサーバ名が存在する

−

25

−

KFCA01868-E

−

usrconf

dcsvstart

−

−

先頭が_である

−

26

−

KFCA01866-E

−

usrconf

dcsvstart

−

−

重複したサーバ名が存在する

−

27

CLT-0001

KFCA25160-W

C

cltsrv

clt_trn_conf

clt_cup_conf

−

−

(clt_trn_conf == N && clt_cup_conf == N)

|| (clt_trn_conf == N && clt_cup_conf指定なし)

クライアントサービス定義の論理チェックは行いません（clt_portを除く）。

28

CLT-0002

KFCA00278-W

C

cltsrv

parallel_count

cltsrv

clt_trn_conf

(parallel_count指定あり) && (clt_trn_conf == N)

−

29

CLT-0003

KFCA25161-W

E

cltsrv

parallel_count

−

−

(clt_trn_conf == Y) &&

(parallel_countの常駐プロセス数 ＞

parallel_countの最大プロセス数)

−

30

CLT-0004

KFCA00262-W

E

cltsrv

parallel_count

prc

prc_process_count

(clt_trn_conf == Y) &&

(parallel_countの常駐プロセス数

＞= prc_process_count指定値)

−

31

CLT-0005

KFCA00262-W

W

cltsrv

parallel_count

trn

trn_tran_process_count

(clt_trn_conf == Y) &&

(parallel_countの最大プロセス数 ＞

trn_tran_process_count指定値)

−

32

CLT-0006

KFCA00278-W

C

cltsrv

balance_count

cltsrv

clt_trn_conf

((balance_count指定あり) && (clt_trn_conf == N))

−

33

CLT-0007

KFCA25162-W

C

cltsrv

balance_count

cltsrv

parallel_count

(clt_trn_conf == Y) &&

(parallel_countの常駐プロセス数 == parallel_countの最大プロセス数) && (balance_count指定あり)

−

34

CLT-0008

KFCA00262-W

C

cltsrv

trn_expiration_time

cltsrv

trn_completion_limit_time

(trn_expiration_time ＞ 0)

&& (trn_completion_limit_time ＞ 0)

&& (trn_expiration_time

＞ trn_completion_limit_time)

−

35

CLT-0009

KFCA00282-W

C

cltsrv

trn_statistics_item

−

−

trn_statistics_itemにcputime指定あり

OSがWindowsの場合，チェック対象の定義はサポートしていません。

36

CLT-0010

KFCA00278-W

C

cltsrv

trn_expiration_time_suspend

cltsrv

trn_expiration_time

(trn_expiration_time == 0)

&& (trn_expiration_time_suspend指定あり)

trn_expiration_time（省略時：0）

37

CLT-0011

KFCA00282-W

C

cltsrv

trn_cpu_time

−

−

trn_cpu_time指定あり

ただし，0を指定した場合だけ

OSがWindowsの場合，チェック対象の定義はサポートしていません。

38

CLT-0012

KFCA00264-W

C

cltsrv

clt_inquire_time

cltsrv

trn_expiration_time

(clt_cup_conf == Y)

&& (trn_expiration_time ＞ 0)

&& (clt_inquire_time ＞ trn_expiration_time)

−

39

CLT-0013

KFCA00264-W

C

cltsrv

clt_inquire_time

cltsrv

trn_limit_time

(clt_cup_conf == Y) &&

(trn_limit_time ＞ 0) && (clt_inquire_time ＞ trn_limit_time)

−

40

CLT-0014

KFCA00264-W

C

cltsrv

clt_inquire_time

cltsrv

trn_completion_limit_time

(clt_cup_conf == Y) &&

(trn_completion_limit_time ＞ 0)

&& (clt_inquire_time ＞ trn_completion_limit_time)

−

41

CLT-0015

KFCA00266-W

C

cltsrv

clt_port

−

−

clt_port指定あり

clt_portの指定がある場合はclt_trn_confやclt_cup_confの指定に関係なく論理チェックを実施します。

42

CLT-0016

KFCA00278-W

C

cltsrv

cup_parallel_count

cltsrv

clt_cup_conf

(cup_parallel_count指定あり) && (clt_cup_conf == N)

−

43

CLT-0017

KFCA00279-W

C

cltsrv

cup_parallel_count

cltsrv

clt_cup_conf

(cup_parallel_count指定あり) && (clt_cup_conf指定なし)

−

44

CLT-0018

KFCA00262-W

E

cltsrv

cup_parallel_count

prc

prc_process_count

(clt_cup_conf == Y) &&

(cup_parallel_countの常駐プロセス数 ＞= prc_process_count指定値)

−

45

CLT-0019

KFCA00278-W

C

cltsrv

cup_balance_count

cltsrv

clt_cup_conf

(cup_balance_count指定あり) && (clt_cup_conf == N)

−

46

CLT-0020

KFCA00279-W

C

cltsrv

cup_balance_count

cltsrv

clt_cup_conf

(cup_balance_count指定あり) && (clt_cup_conf指定なし)

−

47

CLT-0021

KFCA25162-W

C

cltsrv

cup_balance_count

cltsrv

cup_parallel_count

(clt_cup_conf == Y) &&

(cup_balance_count指定あり)

&& (cup_parallel_countの常駐プロセス数 == cup_parallel_countの最大プロセス数)

−

48

CLT-0022

KFCA00278-W

C

cltsrv

clttrn_port

cltsrv

clt_trn_conf

(clttrn_port指定あり) && (clt_trn_conf == N)

−

49

CLT-0023

KFCA00266-W

C

cltsrv

clttrn_port

−

−

(clt_trn_conf == Y) && (clttrn_port指定あり)

−

50

CLT-0024

KFCA25163-W

C

cltsrv

clttrn_port

cltsrv

parallel_count

(clt_trn_conf == Y) &&

(clttrn_port ＋ parallel_countの最大プロセス数 - 1) ＞ 65535

−

51

CLT-0025

KFCA00278-W

C

cltsrv

cltcon_port

cltsrv

clt_cup_conf

(cltcon_port指定あり) && (clt_cup_conf == N)

−

52

CLT-0026

KFCA00279-W

C

cltsrv

cltcon_port

cltsrv

clt_cup_conf

(cltcon_port指定あり) && (clt_cup_conf指定なし)

−

53

CLT-0027

KFCA00266-W

C

cltsrv

cltcon_port

−

−

(clt_cup_conf == Y) && (cltcon_portの指定あり)

−

54

CLT-0028

KFCA25163-W

C

cltsrv

cltcon_port

cltsrv

cup_parallel_count

(clt_cup_conf == Y) &&

(cltcon_port ＋ cup_parallel_countの最大プロセス数 - 1) ＞ 65535

−

55

CLT-0029

KFCA00272-W

C

cltsrv

trn_optimum_item

−

−

trn_optimum_item != base

−

56

CLT-0030

KFCA00262-W

C

cltsrv

trn_watch_time

cltsrv

trn_limit_time

(trn_limit_time ＞ 0) && (trn_watch_time ＞ trn_limit_time)

−

57

CLT-0031

KFCA00262-W

C

cltsrv

trn_watch_time

cltsrv

trn_completion_limit_time

(trn_completion_limit_time ＞ 0)

&& (trn_watch_time ＞ trn_completion_limit_time)

−

58

CLT-0032

KFCA00272-W

C

cltsrv

trn_rollback_information_put

−

−

trn_rollback_information_put != all

−

59

CLT-0033

KFCA00265-W

C

cltsrv

message_store_buflen

−

−

message_store_buflen指定あり

−

60

CLT-0034

KFCA00262-W

C

cltsrv

parallel_count

prc

prc_process_count

(clt_trn_conf == Y) &&

(parallel_countの常駐プロセス数 ＜ prc_process_count指定値)

&& (parallel_countの最大プロセス数 ＞= prc_process_count指定値)

−

61

CLT-0035

KFCA00262-W

C

cltsrv

cup_parallel_count

prc

prc_process_count

(clt_cup_conf == Y) &&

(cup_parallel_countの常駐プロセス数 ＜ prc_process_count指定値)

&& (cup_parallel_countの最大プロセス数 ＞= prc_process_count指定値)

−

62

CLT-0036

KFCA25161-W

E

cltsrv

cup_parallel_count

−

−

(clt_cup_conf == Y) &&

(cup_parallel_countの常駐プロセス数 ＞ cup_parallel_countの最大プロセス数)

−

63

CLT-0037

KFCA00261-W

C

cltsrv

trn_expiration_time

cltsrv

trn_cpu_time

(trn_expiration_time ＞ 0)

&& (trn_cpu_time ＞ 0)

&& (trn_expiration_time ＜ trn_cpu_time)

OSがWindowsの場合はチェックしません。

64

CLT-0038

KFCA00262-W

C

cltsrv

trn_cpu_time

cltsrv

trn_completion_limit_time

(trn_cpu_time ＞ 0)

&& (trn_completion_limit_time ＞ 0)

&& (trn_cpu_time ＞ trn_completion_limit_time)

OSがWindowsの場合はチェックしません。

65

CPD-0001

KFCA00286-W

E

チェックポイントダンプサービス定義

全体

jnl

jnldfsv

jnldfsvの-cオプションに指定したチェックポイントダンプサービス定義ファイルが存在しない

JNL#1

CPD#1

66

CPD-0002

KFCA00285-W

E

チェックポイントダンプサービス定義

jnl_objservername

−

−

jnl_objservernameの指定がない

JNL#1

CPD#1

67

CPD-0003

KFCA26030-W

E

チェックポイントダンプサービス定義

jnl_objservername

−

−

サーバ名が「_tjl」，「_mqa」，または先頭3文字が「_mu」で始まるファイル名以外である

JNL#1

CPD#1

68

CPD-0004

KFCA00272-W

C

チェックポイントダンプサービス定義

jnl_reduced_mode

−

−

jnl_reduced_mode != 0

JNL#1

CPD#1

69

CPD-0005

KFCA26031-I

C

チェックポイントダンプサービス定義

jnl_reserved_file_auto_open

チェックポイントダンプサービス定義

jnladdfg

(jnl_reserved_file_auto_open == Y) && (すべてのjnladdfgにONL指定あり)

JNL#1

CPD#1

70

CPD-0006

KFCA00278-W

C

チェックポイントダンプサービス定義

jnl_singleoperation

チェックポイントダンプサービス定義

jnl_dual

(jnl_singleoperation == Y) && (jnl_dual == N)

JNL#1

CPD#1

71

CPD-0007

KFCA00279-W

C

チェックポイントダンプサービス定義

jnl_singleoperation

チェックポイントダンプサービス定義

jnl_dual

(jnl_singleoperation == Y) && (jnl_dual指定なし)

JNL#1

CPD#1

72

CPD-0008

KFCA26032-W

E

チェックポイントダンプサービス定義

jnladdfg

−

−

jnladdfg -j srfが複数指定されている

JNL#1

CPD#1

73

CPD-0009

KFCA26033-W

E

チェックポイントダンプサービス定義

jnladdpf

−

−

指定したファイルシステムがキャラクタ型スペシャルファイルではない，またはこのファイルシステムに対応する装置がない

JNL#1

CPD#1

74

CPD-0010

KFCA26034-W

E

チェックポイントダンプサービス定義

jnladdpf

−

−

指定したファイルがfilmkfsコマンドでOpenTP1ファイルシステム用に初期化されていない

JNL#1

CPD#1

75

CPD-0011

KFCA26035-W

E

チェックポイントダンプサービス定義

jnladdpf

−

−

チェックポイントダンプファイルがない

JNL#1

CPD#1

76

CPD-0012

KFCA26036-W

E

チェックポイントダンプサービス定義

jnladdpf

−

−

OpenTP1ファイルシステムのバージョン不一致

JNL#1

CPD#1

77

CPD-0013

KFCA26037-W

E

チェックポイントダンプサービス定義

jnladdpf

−

−

チェックポイントダンプファイルのオープンで上限値オーバが発生

JNL#1

CPD#1

78

CPD-0014

KFCA26038-W

E

チェックポイントダンプサービス定義

jnladdpf

−

−

該当するスペシャルファイルのアクセス権限なし

JNL#1

CPD#1

79

CPD-0015

KFCA26039-W

E

チェックポイントダンプサービス定義

jnladdpf

−

−

該当するチェックポイントダンプファイルのアクセス権限なし

JNL#1

CPD#1

80

CPD-0016

KFCA26040-W

E

チェックポイントダンプサービス定義

jnladdpf

−

−

チェックポイントダンプファイルに対してI/Oエラーが発生

JNL#1

CPD#1

81

CPD-0017

KFCA26041-W

E

チェックポイントダンプサービス定義

jnladdpf

−

−

チェックポイントダンプファイルのオープンでメモリ不足が発生

JNL#1

CPD#1

82

CPD-0018

KFCA26042-W

E

チェックポイントダンプサービス定義

jnladdpf

−

−

指定されたファイルはチェックポイントダンプファイルとして使用できない

JNL#1

CPD#1

83

CPD-0019

KFCA26043-W

E

チェックポイントダンプサービス定義

jnladdpf

−

−

チェックポイントダンプファイルの読み込みエラーが発生

JNL#1

CPD#1

84

CPD-0020

KFCA26032-W

E

チェックポイントダンプサービス定義

jnladdpf

−

−

jnladdfg -j srfが複数指定されている

JNL#1

CPD#1

85

CPD-0021

KFCA00265-W

C

チェックポイントダンプサービス定義

jnl_cdskip_limit

チェックポイントダンプサービス定義

jnl_objservername

jnl_objservername == _tjl &&

jnl_cdskip_limitの指定あり

JNL#1

CPD#1

86

CPD-0022

KFCA00280-W

C

チェックポイントダンプサービス定義

jnl_cdskip_limit

チェックポイントダンプサービス定義

jnl_objservername

jnl_objservername != _tjl &&

jnl_cdskip_limitの指定あり

JNL#1

CPD#1

87

CPD-0023

KFCA00280-W

C

チェックポイントダンプサービス定義

jnl_cdskip_msg

チェックポイントダンプサービス定義

jnl_objservername

jnl_objservername != _tjl &&

jnl_cdskip_msgの指定あり

JNL#1

CPD#1

88

−

KFCA02175-E

−

チェックポイントダンプサービス定義

jnl_objservername

ほかのチェックポイントダンプサービス定義

jnl_objservername

ほかのチェックポイントダンプサービス定義に指定したjnl_objservernameと同じサーバ名を指定している

JNL#1

CPD#1

89

−

KFCA02135-E

−

チェックポイントダンプサービス定義

jnladdfg

−

−

ほかのチェックポイントダンプサービス定義のjnladdfgで指定したファイルグループ名と重複している

JNL#1

CPD#1

90

−

KFCA02149-E

−

チェックポイントダンプサービス定義

jnladdfg

−

−

jnladdfg(ONL指定あり && -j srf指定なし)の指定が(assurance_count指定値 + 1)より少ない

JNL#1

CPD#1

91

−

KFCA02153-E

−

チェックポイントダンプサービス定義

jnladdfg

−

−

jnladdfgの指定が最大指定可能数の60個を超えている

JNL#1

CPD#1

92

−

KFCA02156-E

−

チェックポイントダンプサービス定義

jnladdfg

−

−

-gオプションに指定されたファイルグループ用のjnladdpfがない

JNL#1

CPD#1

93

−

KFCA02190-E

−

チェックポイントダンプサービス定義

jnladdfg

−

−

jnladdfg(ONL指定あり && -j srf指定なし)の指定が最大指定可能数の30個を超えている

JNL#1

CPD#1

94

−

KFCA02141-E

−

チェックポイントダンプサービス定義

jnladdfg

−

−

ほかのjnladdfgで指定したファイルグループ名と重複している

JNL#1

CPD#1

95

−

KFCA02137-E

−

チェックポイントダンプサービス定義

jnladdpf

−

−

ほかのチェックポイントダンプサービス定義のjnladdpfで指定した物理ファイル名と重複している

JNL#1

CPD#1

96

−

KFCA02148-E

−

チェックポイントダンプサービス定義

jnladdpf

チェックポイントダンプサービス定義

jnladdfg

-gオプションに指定されたファイルグループ用のjnladdfg定義がない

JNL#1

CPD#1

97

−

KFCA02154-E

−

チェックポイントダンプサービス定義

jnladdpf

−

−

ほかのjnladdpfで指定したファイルグループ名と重複している

JNL#1

CPD#1

98

−

KFCA02155-E

−

チェックポイントダンプサービス定義

jnladdpf

−

−

jnladdpfの指定が最大指定可能数の60個を超えている

JNL#1

CPD#1

99

−

KFCA26004-E

−

チェックポイントダンプサービス定義

jnladdpf

チェックポイントダンプサービス定義

jnl_dual

(jnl_dual == Y指定あり)

&& ((jnladdpfの-aオプション指定なし) || (jnladdpfの-bオプション指定なし))

JNL#1

CPD#1

100

−

KFCA26005-E

−

チェックポイントダンプサービス定義

jnladdpf

チェックポイントダンプサービス定義

jnl_dual

(jnladdpfの-bオプション指定あり) && (jnl_dual == N)

JNL#1

CPD#1

101

−

KFCA26005-E

−

チェックポイントダンプサービス定義

jnladdpf

チェックポイントダンプサービス定義

jnl_dual

(jnladdpfの-bオプション指定あり) && (jnl_dual指定なし)

JNL#1

CPD#1

102

DAM-0001

KFCA02751-W

W

dam

dam_update_block

−

−

dam_update_block ＞ 5000

−

103

DAM-0002

KFCA02752-W

C

dam

dam_message_level

−

−

(dam_message_level指定なし) || (dam_message_level == 1)

−

104

DAM-0003

KFCA00264-W

C

dam

dam_tran_process_count

trn

trn_tran_process_count

(dam_tran_process_count指定あり)

&& (dam_tran_process_count ＞ trn_tran_process_count)

−

105

DAM-0004

KFCA02753-W

C

dam

dam_cache_size

−

−

(dam_cache_size指定あり)

&& (dam_cache_size ＜ DAM起動時計算式)

−

106

DAM-0005

KFCA00277-W

C

dam

dam_cache_size

dam

dam_cache_size_fix

(dam_cache_size_fix指定あり)

&& (dam_cache_size指定あり)

−

107

DAM-0006

KFCA02754-W

C

dam

dam_cache_size_fix

−

−

(dam_cache_size_fix指定あり)

−

108

DAM-0007

KFCA00282-W

C

dam

dam_cache_attribute

−

−

(OS == AIX || OS == Linux)

&& (dam_cache_attribute == fixed)

OSがAIXまたはLinuxの場合だけチェック対象です。

109

DAM-0008

KFCA00272-W

C

dam

dam_cache_attribute

−

−

(OS == HP-UX || OS == Solaris )

&& (dam_cache_attribute == fixed)

OSがHP-UXまたはSolarisの場合だけチェック対象です。

110

DAM-0013

KFCA00285-W

E

dam

dam_cache_attribute

prc

prc_hugepage_group_id

(OS == Linux) && (OpenTP1 == 64ビット版) && (dam_cache_attribute == hugepage) && (prc_hugepage_group_id指定なし)

OSがLinuxで，64ビット版のOpenTP1の場合だけチェック対象です。

dam:dam_cache_attributeにhugepageを指定している場合，prc:prc_hugepage_group_idの指定が必須です。

111

DAM-0009

KFCA02755-W

W

dam

dam_io_error_occur

−

−

dam_io_error_occur == stop

−

112

DAM-0010

KFCA00271-W

W

dam

dam_cache_reuse_from

−

−

dam_cache_reuse_from == first

−

113

DAM-0011

KFCA02756-W

W

dam

damchlmtコマンド

−

−

(DAMファイルブロック数 ＞ 5000)

&& (damchlmt指定なし)

−

114

DAM-0012

KFCA02757-W

W

dam

damfileコマンド

−

−

(damfileコマンド指定数＋dam_added_file指定値) ＞ 3600

−

115

−

KFCA02566-E

−

dam

damcacheコマンド

−

−

damfileでDAMファイルの指定なし

−

116

−

KFCA02566-E

−

dam

damchlmtコマンド

−

−

damfileでDAMファイルの指定なし

−

117

−

KFCA01636-E

−

dam

damfileコマンド

−

−

DAMファイルパス名が正しく指定されていない

−

118

−

KFCA01636-E

−

dam

damfileコマンド

−

−

OpenTP1ファイルシステムのある装置が未初期化

−

119

−

KFCA01636-E

−

dam

damfileコマンド

−

−

DAMファイルがない

−

120

−

KFCA01636-E

−

dam

damfileコマンド

−

−

オープンファイル数がシステムの上限値を超過

−

121

−

KFCA01636-E

−

dam

damfileコマンド

−

−

OpenTP1ファイルシステムへのアクセス権がない

−

122

−

KFCA01636-E

−

dam

damfileコマンド

−

−

OpenTP1ファイルシステムへのアクセス権がない

−

123

−

KFCA01636-E

−

dam

damfileコマンド

−

−

DAMファイルのバージョンが正しくない

−

124

−

KFCA01646-E

−

dam

damfileコマンド

−

−

DAMファイルに対してI/Oエラーが発生

−

125

−

KFCA01627-E

−

dam

damfileコマンド

−

−

メモリ不足が発生

−

126

−

KFCA01637-E

−

dam

damfileコマンド

−

−

指定したDAMファイルが正しいDAMファイルではない

−

127

−

KFCA01617-E

−

システムジャーナルサービス定義

jnl_max_datasize

−

−

(dam_update_block_over == flush) && (jnl_max_datasize ＜ 152 ＋ 最大ブロック長×2)

||

(dam_update_block_over == error) && (jnl_max_datasize ＜ 152 ＋ 最大ブロック長)

JNL#1

CPD#1

128

JNL-0001

KFCA00262-W

W

jnl

jnl_arc_terminate_timeout

env

system_terminate_watch_time

!(OS == Windows || OS == Linux) && system_terminate_watch_time ＜= jnl_arc_terminate_timeout

JNL#1

CPD#1

129

JNL-0005

KFCA32800-W

E

jnl

jnldfsv

−

−

-rオプションの指定なし

JNL#1

CPD#1

130

JNL-0006

KFCA32801-W

E

jnl

jnldfsv

−

−

-rオプションの引数の指定なし

JNL#1

CPD#1

131

JNL-0007

KFCA32802-W

W

jnl

jnldfsv

−

−

jnldfsvの定義数 ＞ 1

JNL#1

CPD#1

132

JNL-0010

KFCA00272-W

C

システムジャーナルサービス定義

jnl_cdinterval

−

−

jnl_cdinterval ＜ 1000

JNL#1

CPD#1

133

JNL-0011

KFCA00272-W

C

システムジャーナルサービス定義

jnl_cdinterval

−

−

jnl_cdinterval ＞ 1000

JNL#1

CPD#1

134

JNL-0014

KFCA00269-W

C

システムジャーナルサービス定義

jnl_singleoperation

−

jnl_dual

(jnl_dual == N) && (jnl_singleoperation==Y)

JNL#1

CPD#1

135

JNL-0015

KFCA00270-W

C

システムジャーナルサービス定義

jnl_arc_buff_size

−

jnl_arc_name

!(OS == Windows || OS == Linux) && jnl_arc_name指定なし && jnl_arc_buff_size指定あり

JNL#1

CPD#1

136

JNL-0016

KFCA00273-W

E

システムジャーナルサービス定義

jnl_arc_buff_size

−

jnl_arc_max_datasize

!(OS == Windows || OS == Linux) && (jnl_arc_buff_size ＜ ↑(jnl_arc_max_datasize×1024) / 1048576↑×3)

JNL#1

CPD#1

137

JNL-0017

KFCA00270-W

C

システムジャーナルサービス定義

jnl_arc_max_datasize

−

jnl_arc_name

!(OS == Windows || OS == Linux) && jnl_arc_name指定なし && jnl_arc_max_datasize指定あり

JNL#1

CPD#1

138

JNL-0018

KFCA00273-W

E

システムジャーナルサービス定義

jnl_arc_max_datasize

−

jnl_max_datasize

!(OS == Windows || OS == Linux) && (jnl_arc_max_datasize ＜ ↑(↑(jnl_max_datasize＋336) / 4096↑×4096) / 1024↑)

JNL#1

CPD#1

139

JNL-0019

KFCA00274-W

E

システムジャーナルサービス定義

jnl_arc_max_datasize

betranrc

rpc_max_message_size

!(OS == Windows || OS == Linux) && (rpc_max_message_size ＜ ↑(jnl_arc_max_datasize×1024＋4096) / 1048576↑)

JNL#1

CPD#1

140

JNL-0020

KFCA00270-W

C

システムジャーナルサービス定義

jnl_arc_terminate_check

−

jnl_arc_name

!(OS == Windows || OS == Linux) && jnl_arc_name指定なし && jnl_arc_terminate_check指定あり

JNL#1

CPD#1

141

JNL-0021

KFCA00270-W

C

システムジャーナルサービス定義

jnl_arc_rec_kind

−

jnl_arc_name

!(OS == Windows || OS == Linux) && jnl_arc_name指定なしの場合，jnl_arc_rec_kind指定値は有効にならない

JNL#1

CPD#1

142

JNL-0022

KFCA00270-W

C

システムジャーナルサービス定義

jnl_arc_uj_code

−

jnl_arc_name

!(OS == Windows || OS == Linux) && jnl_arc_name指定なしの場合，jnl_arc_uj_code指定値は有効にならない

JNL#1

CPD#1

143

JNL-0023

KFCA00270-W

C

システムジャーナルサービス定義

jnl_arc_check_level

−

jnl_arc_name

!(OS == Windows || OS == Linux) && jnl_arc_name指定なしの場合，jnl_arc_check_level指定値は有効にならない

JNL#1

CPD#1

144

JNL-0024

KFCA00270-W

C

システムジャーナルサービス定義

jnl_arc_trn_stat

−

jnl_arc_name

!(OS == Windows || OS == Linux) && jnl_arc_name指定なしの場合，jnl_arc_trn_stat指定値は有効にならない

JNL#1

CPD#1

145

JNL-0025

KFCA00269-W

C

システムジャーナルサービス定義

jnl_auto_unload

−

jnl_unload_check

jnl_unload_check=Nを指定している場合，jnl_auto_unload=Yの指定は無効

JNL#1

CPD#1

146

JNL-0026

KFCA00280-W

C

システムジャーナルサービス定義

jnl_auto_unload_path

−

jnl_auto_unload

jnl_auto_unload=Nを指定している場合，jnl_auto_unload_pathの指定は無効

JNL#1

CPD#1

147

JNL-0027

KFCA32804-W

W

システムジャーナルサービス定義

jnl_auto_unload_path

−

−

ディレクトリへのアクセス権がない

JNL#1

CPD#1

148

JNL-0028

KFCA32804-W

W

システムジャーナルサービス定義

jnl_auto_unload_path

−

−

ディレクトリが存在しない

JNL#1

CPD#1

149

JNL-0029

KFCA32804-W

W

システムジャーナルサービス定義

jnl_auto_unload_path

−

−

指定パスがディレクトリではない

JNL#1

CPD#1

150

JNL-0030

KFCA32805-W

W

システムジャーナルサービス定義

jnl_auto_unload_path

−

−

指定ディレクトリにアンロードジャーナルファイルが存在する

JNL#1

CPD#1

151

JNL-0031

KFCA00264-W

C

システムジャーナルサービス定義

jnl_max_file_dispersion

−

jnl_min_file_dispersion

jnl_min_file_dispersion ＞ jnl_max_file_dispersion

JNL#1

CPD#1

152

JNL-0050

KFCA32810-W

E

システムジャーナルサービス定義

jnladdfg

−

−

-gオプションの指定なし

JNL#1

CPD#1

153

JNL-0051

KFCA32811-W

E

システムジャーナルサービス定義

jnladdfg

−

−

-gオプションの引数の指定なし

JNL#1

CPD#1

154

JNL-0052

KFCA32812-W

E

システムジャーナルサービス定義

jnladdfg

−

−

jnladdfgの指定数 ＞ 256

JNL#1

CPD#1

155

JNL-0053

KFCA32813-W

E

システムジャーナルサービス定義

jnladdfg

−

−

jnladdfgの指定数 ＜ 2

JNL#1

CPD#1

156

JNL-0054

KFCA32814-W

E

システムジャーナルサービス定義

jnladdfg

−

−

ONL指定のjnladdfgの指定数 ＜ 2

JNL#1

CPD#1

157

JNL-0055

KFCA32815-W

W

システムジャーナルサービス定義

jnladdfg

−

−

同一ファイルグループ名のjnladdfgの指定数 ＞ 1

JNL#1

CPD#1

158

JNL-0056

KFCA32816-W

E

システムジャーナルサービス定義

jnladdfg

−

jnladdpf

jnladdpfが定義されていないファイルグループがある

JNL#1

CPD#1

159

JNL-0057

KFCA32820-W

E

システムジャーナルサービス定義

jnladdpf

−

−

-gオプションの指定なし

JNL#1

CPD#1

160

JNL-0058

KFCA32821-W

E

システムジャーナルサービス定義

jnladdpf

−

−

-gオプションの引数の指定なし

JNL#1

CPD#1

161

JNL-0059

KFCA32822-W

E

システムジャーナルサービス定義

jnladdpf

−

−

-aオプションの指定なし

JNL#1

CPD#1

162

JNL-0060

KFCA32823-W

E

システムジャーナルサービス定義

jnladdpf

−

−

-aオプションまたは-bオプションの引数の指定なし

JNL#1

CPD#1

163

JNL-0061

KFCA32824-W

E

システムジャーナルサービス定義

jnladdpf

−

jnl_dual

(jnl_dual == Y) && (jladdpfの-bオプションの指定なし)

JNL#1

CPD#1

164

JNL-0062

KFCA32825-W

C

システムジャーナルサービス定義

jnladdpf

−

jnl_dual

(jnl_dual == N) && (jnladdpfの-bオプションの指定あり)

JNL#1

CPD#1

165

JNL-0063

KFCA32826-W

E

システムジャーナルサービス定義

jnladdpf

−

jnladdfg

jnladdfgに定義されていないファイルグループ名がjnladdpfに定義されている

JNL#1

CPD#1

166

JNL-0064

KFCA32827-W

W

システムジャーナルサービス定義

jnladdpf

−

jnl_max_file_dispersion

jnl_max_file_dispersion = 1 && 同一ファイルグループ名のjnladdpf定義コマンドの指定数 ＞ jnl_max_file_dispersion

JNL#1

CPD#1

167

JNL-0065

KFCA32828-W

E

システムジャーナルサービス定義

jnladdpf

−

−

ジャーナルファイル名の重複

JNL#1

CPD#1

168

JNL-0066

KFCA32829-W

E

システムジャーナルサービス定義

jnladdpf

−

−

物理ファイルはジャーナルファイルではない

JNL#1

CPD#1

169

JNL-0067

KFCA32830-W

W

システムジャーナルサービス定義

jnladdpf

−

−

ジャーナルファイルが他ノードのジャーナルファイルである

JNL#1

CPD#1

170

JNL-0068

KFCA32831-W

E

システムジャーナルサービス定義

jnladdpf

−

−

ジャーナルファイルのレコード数 ＜ ↑((jnl_max_datasize値) ＋ 336) ／ 4096↑＋12

JNL#1

CPD#1

171

JNL-0069

KFCA32832-W

E

システムジャーナルサービス定義

jnladdpf

−

−

次に示すどちらかの条件

指定したファイルシステムがキャラクタ型スペシャルファイルではない

指定したファイルシステムに対応する装置がない

JNL#1

CPD#1

172

JNL-0070

KFCA32833-W

E

システムジャーナルサービス定義

jnladdpf

−

−

OpenTP1ファイルシステムのある装置が未初期化

JNL#1

CPD#1

173

JNL-0071

KFCA32834-W

E

システムジャーナルサービス定義

jnladdpf

−

−

OpenTP1ファイルシステムのバージョン不一致

JNL#1

CPD#1

174

JNL-0072

KFCA32835-W

E

システムジャーナルサービス定義

jnladdpf

−

−

メモリ不足の発生

JNL#1

CPD#1

175

JNL-0073

KFCA32836-W

E

システムジャーナルサービス定義

jnladdpf

−

−

オープンファイル数がシステムの上限値を超過

JNL#1

CPD#1

176

JNL-0074

KFCA32837-W

E

システムジャーナルサービス定義

jnladdpf

−

−

指定したOpenTP1ファイルシステムまたはジャーナルファイルに対するアクセス権限がない

JNL#1

CPD#1

177

JNL-0075

KFCA32838-W

E

システムジャーナルサービス定義

jnladdpf

−

−

ファイルが存在しない

JNL#1

CPD#1

178

JNL-0076

KFCA32839-W

E

システムジャーナルサービス定義

jnladdpf

−

−

ロックセグメント不足が発生

JNL#1

CPD#1

179

JNL-0077

KFCA32840-W

E

システムジャーナルサービス定義

jnladdpf

−

−

指定されたファイルはジャーナルファイルとして使用できない

JNL#1

CPD#1

180

JNL-0078

KFCA32841-W

E

システムジャーナルサービス定義

jnladdpf

−

−

次に示すどちらかの条件

物理ファイルの管理情報の読み込み失敗

管理情報が破壊されている

JNL#1

CPD#1

181

JNL-0079

KFCA32842-W

W

システムジャーナルサービス定義

jnladdpf

−

−

jnl_unload_check=Yの場合，ファイルグループがアンロードされていない

JNL#1

CPD#1

182

JNL-0080

KFCA32843-W

C

システムジャーナルサービス定義

jnladdpf

−

−

物理ファイル上の状態が現用である

JNL#1

CPD#1

183

JNL-0081

KFCA32844-W

C

システムジャーナルサービス定義

jnladdpf

−

jnl_max_file_dispersion

同一ファイルグループに指定する要素ファイル数 ＞ jnl_max_file_dispersion

JNL#1

CPD#1

184

JNL-0082

KFCA32845-W

C

システムジャーナルサービス定義

jnladdpf

−

jnl_min_file_dispersion

同一ファイルグループに指定する要素ファイル数 ＜ jnl_min_file_dispersion

JNL#1

CPD#1

185

JNL-0083

KFCA32846-W

C

システムジャーナルサービス定義

jnladdpf

−

jnl_max_file_dispersion

jnl_max_file_dispersion ＞ 1 && jnladdpfの-eオプション指定なし

JNL#1

CPD#1

186

JNL-0084

KFCA32847-W

W

システムジャーナルサービス定義

jnladdpf

−

−

同一要素ファイル名のjnladdpf定義コマンドの指定数 ＞ 1

JNL#1

CPD#1

187

JNL-0086

KFCA32849-W

E

システムジャーナルサービス定義

jnladdpf

−

−

-eオプション引数が指定されていない。

JNL#1

CPD#1

188

JNL-0090

KFCA00282-W

C

jnl

jnl_arc_terminate_timeout

−

−

(OS == Windows || OS == Linux)

&& jnl_arc_terminate_timeout指定あり

JNL#1

CPD#1

189

JNL-0090

KFCA00282-W

C

jnl

jnl_arc_ipc_buff_size

−

−

(OS == Windows || OS == Linux)

&& jnl_arc_ipc_buff_size指定あり

JNL#1

CPD#1

190

JNL-0090

KFCA00282-W

C

システムジャーナルサービス定義

jnl_arc_name

−

−

(OS == Windows || OS == Linux)

&& jnl_arc_name指定あり

JNL#1

CPD#1

191

JNL-0090

KFCA00282-W

C

システムジャーナルサービス定義

jnl_arc_buff_size

−

−

(OS == Windows || OS == Linux)

&& jnl_arc_buff_size指定あり

JNL#1

CPD#1

192

JNL-0090

KFCA00282-W

C

システムジャーナルサービス定義

jnl_arc_max_datasize

−

−

(OS == Windows || OS == Linux)

&& jnl_arc_max_datasize指定あり

JNL#1

CPD#1

193

JNL-0090

KFCA00282-W

C

システムジャーナルサービス定義

jnl_arc_terminate_check

−

−

(OS == Windows || OS == Linux)

&& jnl_arc_terminate_check指定あり

JNL#1

CPD#1

194

JNL-0090

KFCA00282-W

C

システムジャーナルサービス定義

jnl_arc_rec_kind

−

−

OSがWindowsまたはLinuxの場合で指定されている

JNL#1

CPD#1

195

JNL-0090

KFCA00282-W

C

システムジャーナルサービス定義

jnl_arc_uj_code

−

−

OSがWindowsまたはLinuxの場合で指定されている

JNL#1

CPD#1

196

JNL-0090

KFCA00282-W

C

システムジャーナルサービス定義

jnl_arc_check_level

−

−

OSがWindowsまたはLinuxの場合で指定されている

JNL#1

CPD#1

197

JNL-0090

KFCA00282-W

C

システムジャーナルサービス定義

jnl_arc_trn_stat

−

−

OSがWindowsまたはLinuxの場合で指定されている

JNL#1

CPD#1

198

JNL-0100

KFCA00285-W

E

jnl

jnldfsv

−

−

jnldfsv指定なし

JNL#1

CPD#1

199

JNL-0101

KFCA00285-W

E

システムジャーナルサービス定義

jnladdfg

−

−

jnladdfg指定なし

JNL#1

CPD#1

200

JNL-0102

KFCA00285-W

E

システムジャーナルサービス定義

jnladdpf

−

−

jnladdpf指定なし

JNL#1

CPD#1

201

JNL-0103

KFCA00286-W

E

jnl

−

betranrc

jnl_fileless_option

jnl_fileless_option=N && ジャーナルサービス定義ファイル(jnl)が存在しない

JNL#1

CPD#1

202

JNL-0104

KFCA00286-W

E

システムジャーナルサービス定義

−

betranrc

jnl_fileless_option

jnl_fileless_option=N && システムジャーナルサービス定義ファイルが存在しない

JNL#1

CPD#1

203

JNL-0110

KFCA32850-W

E

システムジャーナルサービス定義

jnl_arc_name

−

−

!(OS == Windows || OS == Linux) && (リソースグループ名の文字数 ＜ 1 || リソースグループ名の文字数 ＞ 8) || (ノード識別子の文字数 != 4)

JNL#1

CPD#1

204

JNL-0111

KFCA32851-W

E

システムジャーナルサービス定義

jnl_arc_rec_kind

−

−

!(OS == Windows || OS == Linux) && ( !(a) || !(c) || !(f) || !(g) || !(i) || !(m) || !(o) || !(s) || !(u) )

JNL#1

CPD#1

205

JNL-0112

KFCA32852-W

E

システムジャーナルサービス定義

jnl_arc_uj_code

−

−

!(OS == Windows || OS == Linux) && (ujコード ＜ 0) || (ujコード ＞ 255)

JNL#1

CPD#1

206

JNL-0120

KFCA32806-W

W

システムジャーナルサービス定義

jnl_auto_unload_path

−

−

指定ディレクトリのパスが絶対パスではない

JNL#1

CPD#1

207

JNL-0121

KFCA32807-W

W

システムジャーナルサービス定義

jnl_auto_unload_path

−

−

指定ディレクトリのパス文字列 ＞ 80バイト

JNL#1

CPD#1

208

JNL-0122

KFCA32808-W

W

システムジャーナルサービス定義

jnl_auto_unload_path

−

−

すべての指定ディレクトリが使用不可能

JNL#1

CPD#1

209

JNL-0123

KFCA00272-W

C

betranrc

jnl_prf_event_trace_level

−

−

(jnl_prf_event_trace_level & 00000001) != 00000001

JNL#1

210

JNL-0124

KFCA26780-W

C

_jl

prf_file_size

−

−

prf_file_size == 1024

JNL#1

211

JNL-0125

KFCA00272-W

C

_jl

prf_trace_backup

−

−

prf_trace_backup == N

JNL#1

212

JNL-0126

KFCA00280-W

C

システムジャーナルサービス定義

jnl_auto_unload_continue

システムジャーナルサービス定義

jnl_auto_unload

(jnl_auto_unload == N) &&

(jnl_auto_unload_continue= = Y)

−

213

−

KFCA00216-E

−

システムジャーナルサービス定義

jnl_auto_unload_continue

−

−

jnl_auto_unload_continueに不正な値を指定(YおよびN以外を指定)

−

214

LCK-0001

KFCA00421-W

C

lck

全体

lck

lck_limt_for*

(lck_limit_foruser指定値 ＋

lck_limit_fordam指定値 ＋

lck_limit_fortam指定値 ＋

lck_limit_formqa指定値) == 0

ただし，dam_conf==Nの場合はlck_limit_fordam=0

tam_conf==Nの場合はlck_limit_fortam=0

ロックサービス定義の論理チェックは行いません。

215

LCK-0002

KFCA00265-W

C

lck

lck_limit_foruser

−

−

lck_limit_foruser指定あり

−

216

LCK-0003

KFCA00272-W

C

lck

lck_limit_fordam

sysconf

dam_conf

((dam_conf == N) || (dam_conf指定なし))

&& ((lck_limit_fordam ＞ 0)

|| (lck_limit_fordam指定なし))

−

217

LCK-0004

KFCA00265-W

C

lck

lck_limit_fordam

sysconf

dam_conf

(dam_conf == Y)

&& (lck_limit_fordam指定あり)

−

218

LCK-0005

KFCA00272-W

C

lck

lck_limit_fortam

sysconf

tam_conf

((tam_conf == N) || (tam_conf指定なし))

&& ((lck_limit_fortam ＞ 0)

|| (lck_limit_fortam指定なし))

−

219

LCK-0006

KFCA00265-W

C

lck

lck_limit_fortam

sysconf

tam_conf

(tam_conf == Y)

&& (lck_limit_fortam指定あり)

−

220

LCK-0007

KFCA00278-W

C

lck

lck_limit_formqa

sysconf

mqa_conf

((mqa_conf == N) || (mqa_conf指定なし))

&& (lck_limit_formqa ＞ 0)

−

221

LCK-0008

KFCA00265-W

C

lck

lck_limit_formqa

sysconf

mqa_conf

mqa_conf == Y

−

222

LCK-0009

KFCA00265-W

C

lck

lck_wait_timeout

−

−

lck_wait_timeout指定あり

−

223

LCK-0010

KFCA00272-W

C

lck

lck_deadlock_info

env

default_value_option

(lck_deadlock_info == N)

|| ((default_value_option ==0) && (lck_deadlock_info指定なし))

−

224

LCK-0011

KFCA00278-W

C

lck

lck_deadlock_info_remove

lck

lck_deadlock_info

(lck_deadlock_info_remove指定あり)

&& (lck_deadlock_info == N)

−

225

LCK-0012

KFCA00279-W

C

lck

lck_deadlock_info_remove

lck

env

lck_deadlock_info

default_value_option

(lck_deadlock_info_remove指定あり)

&& ((default_value_option ==0) && (lck_deadlock_info指定なし))

−

226

LCK-0013

KFCA00272-W

C

lck

lck_deadlock_info_remove

−

−

(lck_deadlock_info == Y)

&& ((lck_deadlock_info_remove == no)

|| (lck_deadlock_info_remove指定なし))

−

227

LCK-0014

KFCA00278-W

C

lck

lck_deadlock_info_remove_level

lck

lck_deadlock_info

(lck_deadlock_info_remove_level指定あり)

&& (lck_deadlock_info == N)

−

228

LCK-0015

KFCA00279-W

C

lck

lck_deadlock_info_remove_level

lck

env

lck_deadlock_info

default_value_option

(lck_deadlock_info_remove_level指定あり)

&&((default_value_option ==0) && (lck_deadlock_info指定なし))

−

229

LCK-0016

KFCA00278-W

C

lck

lck_deadlock_info_remove_level

lck

lck_deadlock_info_remove

(lck_deadlock_info_remove_level指定あり)

&& (lck_deadlock_info_remove == no)

−

230

LCK-0017

KFCA00279-W

C

lck

lck_deadlock_info_remove_level

lck

lck_deadlock_info_remove

(lck_deadlock_info_remove_level指定あり)

&& (lck_deadlock_info_remove指定なし)

−

231

LCK-0018

KFCA00272-W

W

lck

lck_release_detect

−

−

(lck_release_detect == interval)

−

232

LCK-0019

KFCA00278-W

C

lck

lck_release_detect_interval

lck

lck_release_detect

(lck_release_detect_interval指定あり)

&& (lck_release_detect == pipe)

−

233

LCK-0020

KFCA00279-W

C

lck

lck_release_detect_interval

lck

lck_release_detect

(lck_release_detect_interval指定あり)

&& (lck_release_detect 指定なし)

−

234

LCK-0021

KFCA00422-W

C

ユーザサービス定義

deadlock_priority

lck

lck_limit_foruser

lck_limit_fordam

lck_limit_fortam

lck_limit_formqa

(lck_limit_foruser指定値 ＋

lck_limit_fordam指定値 ＋

lck_limit_fortam指定値 ＋

lck_limit_formqa指定値) == 0

ただし，dam_conf==Nの場合は，lck_limit_fordam=0

tam_conf==Nの場合は，lck_limit_fortam=0

−

235

LCK-0022

KFCA00422-W

C

ユーザサービス定義

lck_wait_priority

lck

lck_limit_foruser

lck_limit_fordam

lck_limit_fortam

lck_limit_formqa

(lck_limit_foruser指定値 ＋

lck_limit_fordam指定値 ＋

lck_limit_fortam指定値 ＋

lck_limit_formqa指定値) == 0

ただし，dam_conf==Nの場合はlck_limit_fordam=0

tam_conf==Nの場合はlck_limit_fortam=0

−

236

LCK-0023

KFCA00272-W

C

lck

lck_prf_trace_level

−

−

(lck_prf_trace_level & 00000001) != 00000001

−

237

LCK-0024

KFCA00423-W

C

_lk

prf_file_size

−

−

prf_file_size ＜ デフォルト値（5120）

−

238

LOG-0001

KFCA00272-W

C

log

log_msg_console

log

−

log_msg_console == N

−

239

LOG-0002

KFCA00278-W

C

log

log_msg_allno

log

log_msg_console

(log_msg_console == N)

&& (log_msg_allno指定あり)

&& (log_msg_allno == Y)

−

240

LOG-0002

KFCA00278-W

C

log

log_msg_prcid

log

log_msg_console

(log_msg_console == N)

&& (log_msg_prcid指定あり)

&& (log_msg_prcid == Y)

−

241

LOG-0002

KFCA00278-W

C

log

log_msg_prcno

log

log_msg_console

(log_msg_console == N)

&& (log_msg_prcno指定あり)

&& (log_msg_prcno == Y)

−

242

LOG-0002

KFCA00278-W

C

log

log_msg_sysid

log

log_msg_console

(log_msg_console == N)

&& (log_msg_sysid指定あり)

&& (log_msg_sysid == Y)

−

243

LOG-0002

KFCA00278-W

C

log

log_msg_date

log

log_msg_console

(log_msg_console == N)

&& (log_msg_date指定あり)

&& (log_msg_date == Y)

−

244

LOG-0002

KFCA00278-W

C

log

log_msg_time

log

log_msg_console

(log_msg_console == N)

&& (log_msg_time指定あり)

&& (log_msg_time == Y)

−

245

LOG-0002

KFCA00278-W

C

log

log_msg_hostname

log

log_msg_console

(log_msg_console == N)

&& (log_msg_hostname)

&& (log_msg_hostname == Y)

−

246

LOG-0002

KFCA00278-W

C

log

log_msg_pgmid

log

log_msg_console

(log_msg_console == N)

&& (log_msg_pgmid指定あり)

&& (log_msg_pgmid == Y)

−

247

LOG-0003

KFCA00272-W

C

log

log_msg_date

log

log_msg_console

(log_msg_console == Y)

&& (log_msg_date指定あり)

&& (log_msg_date == N)

−

248

LOG-0003

KFCA00272-W

C

log

log_msg_time

log

log_msg_console

(log_msg_console == Y)

&& (log_msg_time指定あり)

&& (log_msg_time == N)

−

249

LOG-0006

KFCA00282-W

C

log

log_jp1_allno

−

−

log_jp1_allno指定あり

OSがWindowsの場合だけチェック対象です。

250

LOG-0006

KFCA00282-W

C

log

log_jp1_prcid

−

−

log_jp1_prcid指定あり

OSがWindowsの場合だけチェック対象です。

251

LOG-0006

KFCA00282-W

C

log

log_jp1_prcno

−

−

log_jp1_prcno指定あり

OSがWindowsの場合だけチェック対象です。

252

LOG-0006

KFCA00282-W

C

log

log_jp1_sysid

−

−

log_jp1_sysid指定あり

OSがWindowsの場合だけチェック対象です。

253

LOG-0006

KFCA00282-W

C

log

log_jp1_date

−

−

log_jp1_date指定あり

OSがWindowsの場合だけチェック対象です。

254

LOG-0006

KFCA00282-W

C

log

log_jp1_time

−

−

log_jp1_time指定あり

OSがWindowsの場合だけチェック対象です。

255

LOG-0006

KFCA00282-W

C

log

log_jp1_hostname

−

−

log_jp1_hostname指定あり

OSがWindowsの場合だけチェック対象です。

256

LOG-0006

KFCA00282-W

C

log

log_jp1_pgmid

−

−

log_jp1_pgmid指定あり

OSがWindowsの場合だけチェック対象です。

257

LOG-0006

KFCA00282-W

C

log

log_jerr_rint

−

−

log_jerr_rint指定あり

OSがWindowsの場合だけチェック対象です。

258

LOG-0007

KFCA00280-W

C

log

log_jp1_allno

betranrc

jp1_use

(jp1_use == N)

&& (log_jp1_allno指定あり)

&& (log_jp1_allno == Y)

OSがWindowsの場合はチェック対象外です。

259

LOG-0007

KFCA00280-W

C

log

log_jp1_prcid

betranrc

jp1_use

(jp1_use == N)

&& (log_jp1_prcid指定あり)

&& (log_jp1_prcid == Y)

OSがWindowsの場合はチェック対象外です。

260

LOG-0007

KFCA00280-W

C

log

log_jp1_prcno

betranrc

jp1_use

(jp1_use == N)

&& (log_jp1_prcno)

&& (log_jp1_prcno == Y)

OSがWindowsの場合はチェック対象外です。

261

LOG-0007

KFCA00280-W

C

log

log_jp1_sysid

betranrc

jp1_use

(jp1_use == N)

&& (log_jp1_sysid指定あり)

&& (log_jp1_sysid == Y)

OSがWindowsの場合はチェック対象外です。

262

LOG-0007

KFCA00280-W

C

log

log_jp1_date

betranrc

jp1_use

(jp1_use == N)

&& (log_jp1_date指定あり)

&& (log_jp1_date == Y)

OSがWindowsの場合はチェック対象外です。

263

LOG-0007

KFCA00280-W

C

log

log_jp1_time

betranrc

jp1_use

(jp1_use == N)

&& (log_jp1_time指定あり)

&& (log_jp1_time == Y)

OSがWindowsの場合はチェック対象外です。

264

LOG-0007

KFCA00280-W

C

log

log_jp1_hostname

betranrc

jp1_use

(jp1_use == N)

&& (log_jp1_hostname指定あり)

&& (log_jp1_hostname == Y)

OSがWindowsの場合はチェック対象外です。

265

LOG-0007

KFCA00280-W

C

log

log_jp1_pgmid

betranrc

jp1_use

(jp1_use == N)

&& (log_jp1_pgmid指定あり)

&& (log_jp1_pgmid == Y)

OSがWindowsの場合はチェック対象外です。

266

LOG-0007

KFCA00280-W

C

log

log_jerr_rint

betranrc

jp1_use

(jp1_use == N)

&& (log_jerr_rint指定あり)

&& (log_jerr_rint ＞= 1)

OSがWindowsの場合はチェック対象外です。

267

LOG-0008

KFCA00280-W

C

log

log_notify_allno

log

log_notify_out

(log_notify_out == N)

&& (log_notify_allno指定あり)

&& (log_notify_allno == Y)

OSがLinuxの場合はチェック対象外です。

268

LOG-0008

KFCA00280-W

C

log

log_notify_prcid

log

log_notify_out

(log_notify_out == N)

&& (log_notify_prcid指定あり)

&& (log_notify_prcid == Y)

OSがLinuxの場合はチェック対象外です。

269

LOG-0008

KFCA00280-W

C

log

log_notify_prcno

log

log_notify_out

(log_notify_out == N)

&& (log_notify_prcno指定あり)

&& (log_notify_prcno == Y)

OSがLinuxの場合はチェック対象外です。

270

LOG-0008

KFCA00280-W

C

log

log_notify_sysid

log

log_notify_out

(log_notify_out == N)

&& (log_notify_sysid指定あり)

&& (log_notify_sysid == Y)

OSがLinuxの場合はチェック対象外です。

271

LOG-0008

KFCA00280-W

C

log

log_notify_date

log

log_notify_out

(log_notify_out == N)

&& (log_notify_date)

&& (log_notify_date == Y)

OSがLinuxの場合はチェック対象外です。

272

LOG-0008

KFCA00280-W

C

log

log_notify_time

log

log_notify_out

(log_notify_out == N)

&& (log_notify_time指定あり)

&& (log_notify_time == Y)

OSがLinuxの場合はチェック対象外です。

273

LOG-0008

KFCA00280-W

C

log

log_notify_hostname

log

log_notify_out

(log_notify_out == N)

&& (log_notify_hostname指定あり)

&& (log_notify_hostname == Y)

OSがLinuxの場合はチェック対象外です。

274

LOG-0008

KFCA00280-W

C

log

log_notify_pgmid

log

log_notify_out

(log_notify_out == N)

&& (log_notify_pgmid指定あり)

&& (log_notify_pgmid == Y)

OSがLinuxの場合はチェック対象外です。

275

LOG-0009

KFCA00282-W

C

log

log_syslog_out

−

−

log_syslog_out指定あり

OSがWindowsの場合だけチェック対象です。

276

LOG-0009

KFCA00282-W

C

log

log_syslog_allno

−

−

log_syslog_allno指定あり

OSがWindowsの場合だけチェック対象です。

277

LOG-0009

KFCA00282-W

C

log

log_syslog_prcid

−

−

log_syslog_prcid指定あり

OSがWindowsの場合だけチェック対象です。

278

LOG-0009

KFCA00282-W

C

log

log_syslog_prcno

−

−

log_syslog_prcno指定あり

OSがWindowsの場合だけチェック対象です。

279

LOG-0009

KFCA00282-W

C

log

log_syslog_sysid

−

−

log_syslog_sysid指定あり

OSがWindowsの場合だけチェック対象です。

280

LOG-0009

KFCA00282-W

C

log

log_syslog_date

−

−

log_syslog_date指定あり

OSがWindowsの場合だけチェック対象です。

281

LOG-0009

KFCA00282-W

C

log

log_syslog_time

−

−

log_syslog_time指定あり

OSがWindowsの場合だけチェック対象です。

282

LOG-0009

KFCA00282-W

C

log

log_syslog_hostname

−

−

log_syslog_hostname指定あり

OSがWindowsの場合だけチェック対象です。

283

LOG-0009

KFCA00282-W

C

log

log_syslog_pgmid

−

−

log_syslog_pgmid指定あり

OSがWindowsの場合だけチェック対象です。

284

LOG-0009

KFCA00282-W

C

log

log_syslog_append_nodeid

−

−

log_syslog_append_nodeid指定あり

OSがWindowsの場合だけチェック対象です。

285

LOG-0009

KFCA00282-W

C

log

log_syslog_synchro

−

−

log_syslog_synchro指定あり

OSがWindowsの場合だけチェック対象です。

286

LOG-0009

KFCA00282-W

C

log

log_syslog_elist

−

−

log_syslog_elist指定あり

OSがWindowsの場合だけチェック対象です。

287

LOG-0009

KFCA00282-W

C

log

log_syslog_elist_rint

−

−

log_syslog_elist_rint指定あり

OSがWindowsの場合だけチェック対象です。

288

LOG-0010

KFCA00272-W

C

log

log_syslog_out

log

−

log_syslog_out == 0

OSがWindowsの場合はチェック対象外です。

289

LOG-0011

KFCA00280-W

C

log

log_syslog_out

log

DCSYSLOGOUT

(log_syslog_out ＞= 1) && (DCSYSLOGOUT ==1指定なし)

OSがWindowsの場合はチェック対象外です。

290

LOG-0011

KFCA00278-W

C

log

log_syslog_allno

log

log_syslog_out

(log_syslog_out == 0) && (log_syslog_allno == Y)

OSがWindowsの場合はチェック対象外です。

291

LOG-0011

KFCA00278-W

C

log

log_syslog_prcid

log

log_syslog_out

(log_syslog_out == 0) && (log_syslog_prcid == Y)

OSがWindowsの場合はチェック対象外です。

292

LOG-0011

KFCA00278-W

C

log

log_syslog_prcno

log

log_syslog_out

(log_syslog_out == 0) && (log_syslog_prcno == Y)

OSがWindowsの場合はチェック対象外です。

293

LOG-0011

KFCA00278-W

C

log

log_syslog_sysid

log

log_syslog_out

(log_syslog_out == 0) && (log_syslog_sysid == Y)

OSがWindowsの場合はチェック対象外です。

294

LOG-0011

KFCA00278-W

C

log

log_syslog_date

log

log_syslog_out

(log_syslog_out == 0) && (log_syslog_date == Y)

OSがWindowsの場合はチェック対象外です。

295

LOG-0011

KFCA00278-W

C

log

log_syslog_time

log

log_syslog_out

(log_syslog_out == 0) && (log_syslog_time == Y)

OSがWindowsの場合はチェック対象外です。

296

LOG-0011

KFCA00278-W

C

log

log_syslog_hostname

log

log_syslog_out

(log_syslog_out == 0) && (log_syslog_hostname == Y)

OSがWindowsの場合はチェック対象外です。

297

LOG-0011

KFCA00278-W

C

log

log_syslog_pgmid

log

log_syslog_out

(log_syslog_out == 0) && (log_syslog_pgmid == Y)

OSがWindowsの場合はチェック対象外です。

298

LOG-0011

KFCA00278-W

C

log

log_syslog_append_nodeid

log

log_syslog_out

(log_syslog_out == 0) && (log_syslog_append_nodeid == Y)

OSがWindowsの場合はチェック対象外です。

299

LOG-0011

KFCA00278-W

C

log

log_syslog_synchro

log

log_syslog_out

(log_syslog_out == 0) && (log_syslog_synchro == Y)

OSがWindowsの場合はチェック対象外です。

300

LOG-0011

KFCA00278-W

C

log

log_syslog_elist

log

log_syslog_out

(log_syslog_out == 0) && (log_syslog_elist ＞ 0)

OSがAIXまたはLinuxの場合だけチェック対象です。

301

LOG-0011

KFCA00278-W

C

log

log_syslog_elist

log

log_syslog_elist_rint

(log_syslog_elist_rint == 0) && (log_syslog_elist ＞ 0)

OSがAIXまたはLinuxの場合だけチェック対象です。

302

LOG-0011

KFCA00278-W

C

log

log_syslog_elist_rint

log

log_syslog_out

(log_syslog_out == 0) && (log_syslog_elist_rint ＞ 0)

OSがAIXまたはLinuxの場合だけチェック対象です。

303

LOG-0011

KFCA00278-W

C

log

log_syslog_elist_rint

log

log_syslog_elist

(log_syslog_elist == 0) && (log_syslog_elist_rint ＞ 0)

OSがAIXまたはLinuxの場合だけチェック対象です。

304

LOG-0011

KFCA00278-W

C

log

DCSYSLOGCTYPE

log

log_syslog_out

(log_syslog_out == 0) && (DCSYSLOGCTYPE == sjis)

OSがLinuxの場合だけチェック対象です。

305

LOG-0012

KFCA00282-W

C

log

log_notify_out

−

−

log_notify_out指定あり

OSがLinuxの場合だけチェック対象です。

306

LOG-0012

KFCA00282-W

C

log

log_notify_allno

−

−

log_notify_allno指定あり

OSがLinuxの場合だけチェック対象です。

307

LOG-0012

KFCA00282-W

C

log

log_notify_prcid

−

−

log_notify_prcid指定あり

OSがLinuxの場合だけチェック対象です。

308

LOG-0012

KFCA00282-W

C

log

log_notify_prcno

−

−

log_notify_prcno指定あり

OSがLinuxの場合だけチェック対象です。

309

LOG-0012

KFCA00282-W

C

log

log_notify_sysid

−

−

log_notify_sysid指定あり

OSがLinuxの場合だけチェック対象です。

310

LOG-0012

KFCA00282-W

C

log

log_notify_date

−

−

log_notify_date指定あり

OSがLinuxの場合だけチェック対象です。

311

LOG-0012

KFCA00282-W

C

log

log_notify_time

−

−

log_notify_time指定あり

OSがLinuxの場合だけチェック対象です。

312

LOG-0012

KFCA00282-W

C

log

log_notify_hostname

−

−

log_notify_hostname指定あり

OSがLinuxの場合だけチェック対象です。

313

LOG-0012

KFCA00282-W

C

log

log_notify_pgmid

−

−

log_notify_pgmid指定あり

OSがLinuxの場合だけチェック対象です。

314

LOG-0013

KFCA00280-W

C

log

log_audit_path

log

log_audit_out

(log_audit_out == N) && (log_audit_path指定あり)

−

315

LOG-0013

KFCA00280-W

C

log

log_audit_size

log

log_audit_out

(log_audit_out == N) && (log_audit_size指定あり)

−

316

LOG-0013

KFCA00280-W

C

log

log_audit_count

log

log_audit_out

(log_audit_out == N) && (log_audit_count指定あり)

−

317

LOG-0013

KFCA00280-W

C

log

usrrc

ユーザサービス定義

rapリスナーサービス定義

rapクライアントマネジャサービス定義

log_audit_message

log

log_audit_out

(log_audit_out == N) && (log_audit_message指定あり)

−

318

LOG-0014

KFCA00267-W

W

log

log_audit_path

log

log_audit_out

(log_audit_out == Y)

&&(log_audit_path指定あり)

&&(log_audit_pathに指定したディレクトリが存在しない)

−

319

LOG-0014

KFCA00267-W

W

log

log_audit_path

log

log_audit_out

(log_audit_out == Y)

&&(log_audit_path指定あり)

&&(log_audit_pathに指定したパスがディレクトリではない)

−

320

LOG-0014

KFCA00267-W

W

log

log_audit_path

log

log_audit_out

(log_audit_out == Y)

&&(log_audit_path指定あり)

&&(log_audit_pathに指定したディレクトリのアクセス権限が不正)

dcauditsetupコマンドで作成するアクセス権の属性と異なっています。

321

NAM-0001

KFCA00266-W

C

betranrc

name_port

−

−

name_port指定あり

−

322

NAM-0002

KFCA00692-W

C

betranrc

name_port

−

−

name_port指定なし

−

323

NAM-0003

KFCA00699-W

E

betranrc

all_node

−

−

(IPアドレス == 127.x.x.x)

|| (ホスト名を変換したIPアドレス == 127.x.x.x)

xは0〜255の任意の値です。

324

NAM-0004

KFCA00691-W

W

betranrc

all_node

−

−

((all_node指定ホスト名 == 自ホスト名)

|| (all_node指定IP == 自IP))

&& (all_node指定ポート番号 == name_port)

−

325

NAM-0005

KFCA00690-W

E

betranrc

all_node

betranrc

rpc_multi_tp1_in_same_host

(OS != Windows)

&& ((rpc_multi_tp1_in_same_host != Y)

&& ((自ホスト名) | (自IPアドレス)))

OSがWindowsの場合はチェック対象外です。

326

NAM-0006

KFCA00278-W

C

betranrc

all_node

betranrc

name_domain_file_use

(name_domain_file_use == Y) && all_node指定あり

−

327

NAM-0008

KFCA00693-W

C

betranrc

name_notify

−

−

name_notify == Y

−

328

NAM-0009

KFCA00694-W

E

betranrc

name_notify

−

−

(name_notify == Y)

&& (all_node，all_node_exに同一IPが複数指定)

−

329

NAM-0010

KFCA00699-W

E

betranrc

all_node_ex

−

−

(IPアドレス == 127.x.x.x) || (ホスト名を変換したIP == 127.x.x.x)

xは0〜255の任意の値です。

330

NAM-0011

KFCA00691-W

W

betranrc

all_node_ex

−

−

((all_node_ex指定ホスト名 == 自ホスト名) || (all_node_ex指定IP == 自IP))

&& (all_node_ex指定ポート番号 == name_port)

−

331

NAM-0012

KFCA00690-W

E

betranrc

all_node_ex

betranrc

rpc_multi_tp1_in_same_host

(OS != Windows)

&& ((rpc_multi_tp1_in_same_host != Y)

&& ((自ホスト名) | (自IPアドレス)))

OSがWindowsの場合はチェック対象外です。

332

NAM-0013

KFCA00278-W

C

betranrc

all_node_ex

betranrc

name_domain_file_use

(name_domain_file_use == Y) && all_node_ex指定あり

−

333

NAM-0014

KFCA00265-W

C

nam

name_total_size

−

−

name_total_size指定あり

−

334

NAM-0015

KFCA00265-W

C

nam

name_cache_size

−

−

name_cache_size指定あり

−

335

NAM-0016

KFCA00695-W

C

nam

name_global_lookup

−

−

name_global_lookup == Y

−

336

NAM-0017

KFCA00696-W

W

nam

name_service_extend

betranrc

all_node

((name_service_extend指定なし)

|| (name_service_extend == 0))

&& (all_node数 ＞ 128)

−

337

NAM-0018

KFCA00694-W

E

nam

name_audit_conf

−

−

((name_audit_conf == 1)

|| (name_audit_conf == 2))

&& (all_node，all_node_exに同一IPが複数指定)

−

338

NAM-0019

KFCA00261-W

W

nam

name_audit_interval

nam

betranrc

name_audit_watch_time

ipc_conn_interval

(name_audit_conf == 1) && (ipc_conn_interval ＞ name_audit_interval)

|| (name_audit_conf == 2) && (name_audit_watch_time ＞ name_audit_interval)

−

339

NAM-0020

KFCA00276-W

C

nam

name_audit_interval

nam

name_audit_conf

((name_audit_conf指定なし)

|| (name_audit_conf == 0)) && name_audit_interval指定あり

−

340

NAM-0021

KFCA00276-W

C

nam

name_audit_watch_time

nam

name_audit_conf

(name_audit_conf != 2) && name_audit_watch_time指定あり

−

341

NAM-0022

KFCA00697-W

W

nam

name_rpc_control_list

nam

name_audit_conf

(name_rpc_control_list == N) && ((name_audit_conf == 0)

|| (name_audit_conf指定なし))

−

342

NAM-0023

KFCA00698-W

C

nam

name_rpc_control_list

nam

name_audit_interval

((name_rpc_control_list指定なし)

|| (name_rpc_control_list != N)) && ((name_audit_conf != 0) && (name_audit_interval ＜= 180))

−

343

NAM-0024

KFCA00689-W

E

ドメイン定義ファイル

dcnamnd

−

−

(name_domain_file_use == Y)

&& (IPアドレス == 127.x.x.x)

|| (ホスト名を変換したIP == 127.x.x.x)

xは0〜255の任意の値です。

344

NAM-0025

KFCA00688-W

W

ドメイン定義ファイル

dcnamnd

−

−

(name_domain_file_use == Y) && ((指定ホスト名 == 自ホスト名)

|| (指定IP == 自IP)) && (指定ポート番号 == name_port)

−

345

NAM-0026

KFCA00687-W

E

ドメイン定義ファイル

dcnamnd

betranrc

rpc_multi_tp1_in_same_host

(name_domain_file_use == Y) && ((OS != Windows) && ((rpc_multi_tp1_in_same_host != Y) && ((自ホスト名) | (自IPアドレス))))

OSがWindowsの場合はチェック対象外です。

346

NAM-0027

KFCA00689-W

E

ドメイン定義ファイル

dcnamndex

−

−

(name_domain_file_use == Y) && (IPアドレス == 127.x.x.x)

|| (ホスト名を変換したIP == 127.x.x.x)

xは0〜255の任意の値です。

347

NAM-0028

KFCA00688-W

W

ドメイン定義ファイル

dcnamndex

−

−

(name_domain_file_use == Y) && ((指定ホスト名 == 自ホスト名)

|| (指定IP == 自IP)) && (指定ポート番号 == name_port)

−

348

NAM-0029

KFCA00687-W

E

ドメイン定義ファイル

dcnamndex

betranrc

rpc_multi_tp1_in_same_host

(name_domain_file_use == Y) && ((OS != Windows) && ((rpc_multi_tp1_in_same_host != Y) && ((自ホスト名) | (自IPアドレス))))

OSがWindowsの場合はチェック対象外です。

349

NAM-0030

KFCA00282-W

C

betranrc

domain_masters_addr

−

−

(OS == Windws) && (domain_masters_addr指定あり)

OSがWindowsの場合，チェック対象の定義はサポートしていません。

350

NAM-0031

KFCA00282-W

C

betranrc

domain_masters_port

−

−

(OS == Windws) && (domain_masters_port指定あり)

OSがWindowsの場合，チェック対象の定義はサポートしていません。

351

NAM-0032

KFCA00282-W

C

betranrc

domain_use_dns

−

−

(OS == Windws) && (domain_use_dns指定あり)

OSがWindowsの場合，チェック対象の定義はサポートしていません。

352

NAM-0033

KFCA00272-W

W

nam

name_nodeid_check_message

−

−

name_nodeid_check_message == N

−

353

NAM-0034

KFCA00272-W

C

betranrc

nam_prf_trace_level

−

−

((nam_prf_trace_level & 00000001) != 00000001)

&& ((nam_prf_trace_level & 00000002) != 00000002)

−

354

NAM-0035

KFCA00686-W

W

優先選択ノードの定義ファイル

dcnampr

−

−

(name_domain_file_use==Y) && (all_nodeに指定のないノードが優先選択ノード定義ファイルに指定されている)

−

355

NAM-0036

KFCA00278-W

C

nam

namnlfil

nam

name_service_mode

(name_service_mode != manager)

&& (name_service_mode != agent)

&& namnlfil指定あり

−

356

NAM-0037

KFCA00279-W

C

nam

namnlfil

nam

name_service_mode

(name_savice_mode指定なし)

&& (namlfil指定あり)

−

357

−

KFCA33623-E

E

nam

namnlfil

−

−

(引数指定誤り) || (ノードリストファイル名指定誤り)

−

358

−

KFCA00218-E

E

nam

namnlfil

−

−

(!= -n)

&& (!= -r)

−

359

−

KFCA33615-E

−

nam

namnlfil

−

−

パスの指定に誤りがある

−

360

−

KFCA33615-E

−

nam

namnlfil

−

−

ノードリストファイルが存在しない

−

361

−

KFCA33615-E

−

nam

namnlfil

−

−

OpenTP1ファイルシステム用に初期化されていない

−

362

−

KFCA33615-E

−

nam

namnlfil

−

−

OpenTP1ファイルシステムのバージョンが一致しない

−

363

−

KFCA33615-E

−

nam

namnlfil

−

−

指定したファイルはノードリストファイルとして使用できない

−

364

−

KFCA33615-E

−

nam

namnlfil

−

−

ノード情報格納数が共用メモリとノードリストファイルで一致しない

−

365

−

KFCA33615-E

−

nam

namnlfil

−

−

ノードリストファイルのバージョンが一致しない

−

366

−

KFCA33615-E

−

nam

namnlfil

−

−

ファイルに対するアクセス権がない

−

367

−

KFCA33615-E

−

nam

namnlfil

−

−

メモリ不足が発生

−

368

−

KFCA33615-E

−

nam

namnlfil

−

−

入出力エラーが発生

−

369

−

KFCA33615-E

−

nam

namnlfil

−

−

ロックセグメント不足が発生

−

370

−

KFCA33615-E

−

nam

namnlfil

−

−

OpenTP1ファイルシステムのオープンの上限値を超えた

−

371

−

KFCA00216-E

E

betranrc

name_service_mode

−

−

(!= manager)

&& (!= agent)

&& (!= normal)

−

372

NAM-0038

KFCA00691-W

E

betranrc

name_manager_node

−

−

((name_manager_node指定ホスト名 = 自ホスト名)

|| (name_manager_node指定IP = 自IP))

&& (name_manager_node指定ポート番号 = neme_port)

−

373

NAM-0039

KFCA00690-W

E

betranrc

name_manager_node

betranrc

rpc_multi_tpl_in_same_host

(OS != Windows)

&& (rpc_multi_tpl_in_same_host = Y)

&& ((自ホスト名) | (自IPアドレス))

−

374

NAM-0040

KFCA00699-W

E

betranrc

name_manager_node

−

−

(IPアドレス = 127.0.0.1)

|| (ホスト名を変換したIP = 127.0.0.1)

−

375

NAM-0041

KFCA00278-W

C

betranrc

name_remove_down_node

betranrc

name_service_mode

(name_remove_down_node指定あり)

&& (name_service_mode != manager)

−

376

−

KFCA00216-E

E

betranrc

name_remove_down_node

−

−

(!= Y)

&& (!=N)

−

377

NAM-0042

KFCA00279-W

C

betranrc

name_remove_down_node

betranrc

name_service_mode

(name_remove_down_node指定あり)

&& (name_service_mode指定なし)

−

378

NAM-0043

KFCA00278-W

C

betranrc

name_node_add_policy

betranrc

name_service_mode

(name_node_add_policy指定あり)

&& (name_service_mode != agent)

−

379

−

KFCA00216-E

E

betranrc

name_node_add_policy

−

−

(!= using_only)

&& (!= all)

−

380

NAM-0044

KFCA00279-W

C

betranrc

name_node_add_policy

betranrc

name_service_mode

(name_node_add_policy指定あり)

&& (name_service_mode指定なし)

−

381

NAM-0045

KFCA00278-W

C

betranrc

name_manager_node

betranrc

name_service_mode

(name_manager_node指定あり)

&& (name_service_mode != agent)

−

382

−

KFCA00606-E

E

betranrc

name_manager_node

−

−

(!ホスト名) || (!IPアドレス)

−

383

−

KFCA00607-E

E

betranrc

name_manager_node

−

−

(指定ポート< 5001)

&& (指定ポート> 65535)

−

384

NAM-0046

KFCA00279-W

C

betranrc

name_manager_node

betranrc

name_service_mode

(name_manager_node指定あり)

&& (name_service_mode指定なし)

−

385

NAM-0047

KFCA00278-W

C

nam

name_start_watch_time

nam

name_service_mode

(name_start_watch_time指定あり)

&& (name_service_mode != agent)

−

386

−

KFCA00216-E

E

nam

name_start_watch_time

−

−

(<0) || (>1800)

−

387

NAM-0048

KFCA00279-W

C

nam

name_start_watch_time

nam

name_service_mode

(name_start_watch_time指定あり)

&& (name_service_mode指定なし)

−

388

NAM-0049

KFCA00278-E

C

nam

name_start_retry_count

nam

name_service_mode

(name_start_retry_count指定あり)

&& (name_service_mode != agent)

−

389

−

KFCA00216-E

E

nam

name_start_retry_count

−

−

(<0) || (>60)

−

390

NAM-0050

KFCA00279-E

C

nam

name_start_retry_count

nam

name_service_mode

(name_start_retry_count指定あり)

&& (name_service_mode指定なし)

−

391

NAM-0051

KFCA00278-E

C

nam

name_start_retry_interval

nam

name_service_mode

(name_start_retry_interval指定あり)

&& (name_service_mode != agent)

−

392

−

KFCA00216-E

E

nam

name_start_retry_interval

−

−

(<1) || (>60)

−

393

NAM-0052

KFCA00279-E

C

nam

name_start_retry_interval

nam

name_service_mode

(name_start_retry_interval指定あり)

&& (name_service_mode指定なし)

−

394

NAM-0053

KFCA00278-W

C

nam

name_start_error

nam

name_service_mode

(name_start_error指定あり)

&& (name_service_mode != agent)

−

395

−

KFCA00216-E

E

nam

name_start_error

−

−

(!= continue)

&& (!= stop)

−

396

NAM-0054

KFCA00279-W

C

nam

name_start_error

nam

name_service_mode

(name_start_error指定あり)

&& (name_service_mode指定なし)

−

397

NAM-0055

KFCA00278-W

C

nam

name_sync_ready_time

nam

name_service_mode

(name_sync_ready_time指定あり)

&& (name_service_mode != manager)

−

398

−

KFCA00216-E

E

nam

name_sync_ready_time

−

−

(<0) || (>65535)

−

399

NAM-0056

KFCA00279-W

C

nam

name_sync_ready_time

nam

name_service_mode

(name_sync_ready_time指定あり)

&& (name_service_mode指定なし)

−

400

NTS-0001

KFCA00277-W

W

env

redirect_file

betranrc

rpc_port_base

prc_port

(redirect_file == Y) && (rpc_port_base指定あり || prc_port指定あり)

OSがWindowsの場合だけ，チェック対象の定義をサポートしています。

401

NTS-0002

KFCA00280-W

C

env

redirect_file_size

env

redirect_file

(redirect_file != Y ) && ( redirect_file_size指定あり )

OSがWindowsの場合だけ，チェック対象の定義をサポートしています。

402

NTS-0003

KFCA26531-W

C

env

redirect_file_size

−

−

redirect_file_size ＜ 1024

OSがWindowsの場合だけ，チェック対象の定義をサポートしています。

403

NTS-0004

KFCA26532-W

C

env

redirect_file_size

−

−

redirect_file_size = 0

OSがWindowsの場合だけ，チェック対象の定義をサポートしています。

404

NTS-0005

KFCA00280-W

C

env

redirect_file_name

env

redirect_file

(redirect_file != Y) && (redirect_file_name指定あり)

OSがWindowsの場合だけ，チェック対象の定義をサポートしています。

405

NTS-0006

KFCA26533-W

C

env

redirect_file_name

−

−

無効なファイル名

OSがWindowsの場合だけ，チェック対象の定義をサポートしています。

406

NTS-0007

KFCA00269-W

W

env

console_output

env

redirect_file

(redirect_file == Y) && (console_output == Y) && (rpc_port_base指定なし) && (prc_port指定なし)

OSがWindowsの場合だけ，チェック対象の定義をサポートしています。

407

NTS-0008

KFCA26534-W

W

env

console_output

−

−

(console_output == Y) && (OpenTP1のサービスログオンアカウントがユーザアカウントである) && (OSがWindows Server 2003以前)

OSがWindowsの場合だけ，チェック対象の定義をサポートしています。

問題識別コードがNTS-0007の条件を満たす場合は出力されません。

408

NTS-0009

KFCA26535-W

W

env

console_output

−

−

(console_output == Y) && (OSがWindows Vista以降)

OSがWindowsの場合だけ，チェック対象の定義をサポートしています。

問題識別コードがNTS-0007の条件を満たす場合は出力されません。

409

NTS-0010

KFCA26536-W

W

env

console_output

−

−

(console_output == Y) && (「デスクトップとの対話をサービスに許可する」チェックボックスがOFF) && (OSがWindows Server 2003以前)

OSがWindowsの場合だけ，チェック対象の定義をサポートしています。

問題識別コードがNTS-0007の条件を満たす場合は出力されません。

410

NTS-0020

KFCA26537-W

W

ユーザサービス定義

process_privilege_name

−

−

有効な特権名称ではない

OSがWindowsの場合だけ，チェック対象の定義をサポートしています。

411

NTS-0021

KFCA00280-E

C

ユーザサービス定義

process_privilege_name

−

process_privilege_restrict

(process_privilege_restrict != Y) && (process_privilege_name指定あり)

OSがWindowsの場合だけ，チェック対象の定義をサポートしています。

412

OSL-0001

KFCA00265-W

C

env

static_shmpool_size

env

−

条件なし

−

413

OSL-0002

KFCA00265-W

C

env

dynamic_shmpool_size

env

−

条件なし

−

414

OSL-0003

KFCA00272-W

W

env

shmpool_attribute

−

−

((OS == HP-UX) || (OS == Solaris)) && (shmpool_attribute != free)

OSがHP-UXまたはSolarisの場合だけチェック対象です。

415

OSL-0004

KFCA00272-W

W

betranrc

thdlock_sleep_time

−

−

thdlock_sleep_time != 15

−

416

OSL-0005

KFCA00282-W

C

usrrc

ユーザサービス定義

core_shm_suppress

−

−

((OS == WINDOWS)

|| (OS == HP-UX)) && (core_shm_suppress指定あり)

OSがWindowsまたはHP-UXの場合，チェック対象の定義はサポートしていません。

417

OSL-0006

KFCA00272-W

C

usrrc

ユーザサービス定義

core_shm_suppress

−

−

((OS != WINDOWS) && (OS != HP-UX)) && (core_shm_suppress != N)

OSがWindowsまたはHP-UXの場合以外だけチェック対象です。

418

OSL-0007

KFCA00129-W

W

env

shmpool_attribute

env

static_shmpool_size

dynamic_shmpool_size

(OS == Linux) && (OpenTP1 == 64ビット版) && ((static_shmpool_size + dynamic_shmpool_size) ＞ 1945600) && (shmpool_attribute != hugepage)

OSがLinuxで，64ビット版のOpenTP1の場合だけチェック対象です。

419

OSL-0008

KFCA00285-W

E

env

shmpool_attribute

prc

prc_hugepage_group_id

(OS == Linux) && (OpenTP1 == 64ビット版) && (shmpool_attribute == hugepage) && (prc_hugepage_group_id指定なし)

OSがLinuxで，64ビット版のOpenTP1の場合だけチェック対象です。

env:shmpool_attributeにhugepageを指定している場合，prc:prc_hugepage_group_idの指定が必須です。

420

−

KFCA00122-E

−

env

dynamic_shmpool_size

env

static_shmpool_size

((OS != HP-UX) && (OpenTP1 == 32ビット版) && (1992294400 - (static_shmpool_size×1024)) ＜ (dynamic_shmpool_size×1024)) || ((OS == HP-UX) && (OpenTP1 == 32ビット版) && (1063256064＜static_shmpool_size×1024) || (1063256064 ＜ dynamic_shmpool_size×1024) || (1063256064 ＜ dynamic_shmpool_size×1024 + static_shmpool_size×1024))

32ビット版のOpenTP1の場合だけチェック対象です。

421

−

KFCA00127-E

−

env

dynamic_shmpool_size

env

static_shmpool_size

(OpenTP1 == 64ビット版) && (68719476736 - (static_shmpool_size×1024) ＜ (dynamic_shmpool_size×1024))

64ビット版のOpenTP1の場合だけチェック対象です。

422

PRC-0001

KFCA00272-W

C

prc

prc_recovery_resident

−

−

prc_recovery_resident == N

−

423

PRC-0002

KFCA00269-W

C

prc

term_watch_time

prc

term_watch_count

(term_watch_time指定あり) && (term_watch_count == 1 or 2)

−

424

PRC-0003

KFCA00278-W

C

prc

prc_prf_trace

betranrc

prf_trace

(prc_prf_trace==Y && prf_trace==N) || (prc_prf_trace指定なし && prf_trace==N)

−

425

PRC-0004

KFCA00272-W

C

prc

prc_prf_trace

−

−

prc_prf_trace == N

−

426

PRC-0005

KFCA00267-W

W

prc

prc_coresave_path

−

−

パスの先頭が'/'ではない

PRC#1

427

PRC-0006

KFCA00267-W

W

prc

prc_coresave_path

−

−

ディレクトリではない

−

428

PRC-0007

KFCA00267-W

W

prc

prc_coresave_path

−

−

ディレクトリが存在しない

−

429

PRC-0008

KFCA00267-W

W

prc

prc_coresave_path

−

−

アクセスできない

−

430

PRC-0009

KFCA00267-W

W

prc

prc_coresave_path

−

−

OpenTP1管理者に書き込み権限がない

−

431

PRC-0010

KFCA00771-W

W

prc

prcsvpath

−

−

prcsvpathに$DCDIR/binと$DCDIR/aplibが含まれていない

PRC#3

432

PRC-0011

KFCA00282-W

C

trn

groups

−

−

groups指定あり

OSがWindowsの場合，チェック対象の定義はサポートしていません。

433

PRC-0012

KFCA00267-W

W

betranrc

prc_current_work_path

−

−

パスの先頭が'/'ではない

PRC#1

434

PRC-0013

KFCA00267-W

W

betranrc

prc_current_work_path

−

−

ディレクトリが存在しない

−

435

PRC-0014

KFCA00267-W

W

betranrc

prc_current_work_path

−

−

ディレクトリではない

−

436

PRC-0015

KFCA00267-W

W

betranrc

prc_current_work_path

−

−

アクセスできない

−

437

PRC-0016

KFCA00267-W

W

betranrc

prc_current_work_path

−

−

OpenTP1管理者に書き込み権限がない

−

438

PRC-0017

KFCA00267-W

W

betranrc

prc_current_work_path

−

−

prc_current_work_path==ほかのOpenTP1環境のOpenTP1ディレクトリ

−

439

PRC-0018

KFCA00267-W

W

betranrc

prc_current_work_path

−

−

prc_current_work_path==ほかのOpenTP1環境のprc_current_work_pathに指定したディレクトリ

−

440

PRC-0019

KFCA00285-W

E

ユーザサービス定義

module

−

−

module指定なし

−

441

PRC-0020

KFCA00268-W

W

ユーザサービス定義

module

prc

prcsvpath

prcsvpathに指定された各パス上でmoduleに指定されたファイルを検索したところ，ファイルが存在しない

PRC#4

442

PRC-0021

KFCA00268-W

W

ユーザサービス定義

module

prc

prcsvpath

prcsvpathに指定された各パス上でmoduleに指定されたファイルを検索したところ，ファイルパスが長過ぎる

PRC#4

443

PRC-0022

KFCA00268-W

W

ユーザサービス定義

module

prc

prcsvpath

prcsvpathに指定された各パス上でmoduleに指定されたファイルを検索したところ，実行可能ファイルではない

PRC#4

444

PRC-0023

KFCA00272-W

C

ユーザサービス定義

nice

−

−

nice != 0

−

445

PRC-0024

KFCA00282-W

C

ユーザサービス定義

uid

−

−

uid指定あり

OSがWindowsの場合，チェック対象の定義はサポートしていません。

446

PRC-0025

KFCA00282-W

C

ユーザサービス定義

groups

−

−

groups指定あり

OSがWindowsの場合，チェック対象の定義はサポートしていません。

447

PRC-0026

KFCA00267-W

W

prc

prc_coresave_path

−

−

ファイルパスが長過ぎる

−

448

PRC-0027

KFCA00267-W

W

betranrc

prc_current_work_path

−

−

ファイルパスが長過ぎる

−

449

−

KFCA00756-E

KFCA00708-E

−

prc

prcsvpath

−

−

(パス名 ＜ 1) || (255 ＜ パス名)

−

450

−

KFCA00756-E

KFCA00708-E

−

prc

prcsvpath

−

−

指定パス名の先頭が':'から始まっていないか，最後が':'で終わっていない

PRC#2

451

−

KFCA00757-E

KFCA00708-E

−

prc

prcsvpath

−

−

ディレクトリが存在しない

−

452

−

KFCA00758-E

KFCA00708-E

−

prc

prcsvpath

−

−

ディレクトリではない

−

453

PRF-0001

KFCA26780-W

C

prf

prf_file_size

env

default_value_option

(default_value_option == 0) &&

(prf_file_size == 1024) ||

(default_value_option == 1) &&

(prf_file_size == 10240)

−

454

PRF-0002

KFCA00272-W

W

betranrc

prf_trace

−

−

prf_trace == N

−

455

PRF-0004

KFCA00272-W

C

prf

prf_trace_backup

−

−

prf_trace_backup == N

−

456

PRF-0005

KFCA26781-W

C

prf

prf_file_size

env

default_value_option

(default_value_option == 1) &&

(prf_file_size < 10240)

−

457

QUE-0001

KFCA00286-W

C

que

−

sysconf

que_conf

(que_conf == Y) && (que定義ファイルなし)

−

458

QUE-0002

KFCA00264-W

C

que

que_xidnum

trn

trn_tran_process_count

que_xidnum ＞ trn_tran_process_count

−

459

QUE-0003

KFCA00264-W

C

que

quegrp

que

quegrpの-wオプション

警告解除使用率 ＞ 使用容量警告率

−

460

−

KFCA01303-E

−

que

quegrp

−

−

キューグループIDが重複

−

461

−

KFCA01304-E

−

que

quegrp

−

−

物理ファイルパス名が重複

−

462

−

KFCA01300-E

−

que

quegrp

−

−

有効なquegrpが存在しない，またはquegrpの指定なし

−

463

−

KFCA01301-E

−

que

quegrp

−

−

次に示すどれかの条件に該当

物理ファイルが存在しない

キュー物理ファイルではない

キュー物理ファイルに対するアクセス権がない

キュー物理ファイルのバージョンとOpenTP1のバージョンが不一致

−

464

RPC-0001

KFCA00370-W

C

betranrc

jnl

scd

trn

nam

prc

usrrc

ユーザサービス定義

max_socket_descriptors

−

−

システムサーバの論理チェック，およびユーザサーバの論理チェックによって無条件で一回出力される

JNL#1

CPD#1

出力メッセージの「定義ファイル名」に次に示す文字列が出力されます。

betranrc：システムサーバの論理チェック実行時

usrrc：ユーザサーバの論理チェック実行時

465

RPC-0002

KFCA00265-W

C

betranrc

jnl

scd

trn

nam

prc

usrrc

ユーザサービス定義

max_socket_descriptors

−

−

max_socket_descriptors指定あり

JNL#1

CPD#1

466

RPC-0003

KFCA00262-W

C

betranrc

usrrc

ユーザサービス定義

ipc_sockctl_highwater

−

−

ipc_sockctl_highwater = a，b指定の場合，b ＞ a

−

467

RPC-0004

KFCA00377-W

E

betranrc

my_host

−

−

hostnameコマンドによるホスト名の取得ができない

hostsファイル，DNSなどによるホスト名とIPアドレスのマッピングができない

hostnameコマンドでホスト名が取得できない場合，出力メッセージの「指定されたホスト名」に"********"が出力されることがあります。

468

RPC-0005

KFCA00372-W

E

betranrc

my_host

−

−

ホスト名を変換したIP == 127.x.x.x

xは0〜255の任意の値です。

469

RPC-0007

KFCA00373-W

E

betranrc

rpc_netmask

−

−

指定値がネットワークアドレス形式に変換できない

−

470

RPC-0008

KFCA00374-W

C

betranrc

rpc_netmask

betranrc

dcbindht

(dcbindht指定あり) && (rpc_netmask指定なし)

−

471

RPC-0009

KFCA00371-W

C

betranrc

rpc_port_base

prc

prc_process_count

(rpc_port_base ＋ prc_process_count ＋ 128) ＞ 65535

−

472

RPC-0010

KFCA00266-W

C

betranrc

rpc_port_base

prc

prc_process_count

(rpc_port_base ＋ prc_process_count ＋ 128) ＜= 65535

−

473

RPC-0011

KFCA00280-W

C

betranrc

rpc_retry_count

betranrc

rpc_retry

(rpc_retry == N) && (rpc_retry_count指定あり)

−

474

RPC-0012

KFCA00280-W

C

betranrc

rpc_retry_interval

betranrc

rpc_retry

(rpc_retry == N) && (rpc_retry_interval指定あり)

−

475

RPC-0013

KFCA00376-W

C

betranrc

rpc_router_retry_interval

−

−

(0 ＜ rpc_router_retry_interval ) && (rpc_router_retry_interval ＜ 10)

−

476

RPC-0014

KFCA00278-W

C

betranrc

rpc_router_retry_interval

betranrc

rpc_router_retry_count

(rpc_router_retry_count == 0) && (rpc_router_retry_interval指定あり)

−

477

RPC-0015

KFCA00376-W

C

betranrc

usrrc

ユーザサービス定義

rpc_send_retry_interval

−

−

(0 ＜ rpc_send_retry_interval ) && (rpc_send_retry_interval ＜20)

−

478

RPC-0016

KFCA00278-W

C

betranrc

usrrc

ユーザサービス定義

rpc_send_retry_interval

betranrc

usrrc

ユーザサービス定義

rpc_send_retry_count

(rpc_send_retry_count == 0) && (rpc_send_retry_interval指定あり)

RPC#1

479

RPC-0017

KFCA00370-W

C

usrrc

ユーザサービス定義

max_open_fds

−

−

ユーザサーバの論理チェックで無条件に一回出力される

ユーザサーバの論理チェックが実行された場合，出力メッセージの「定義ファイル名」にusrrcが出力されます。

480

RPC-0018

KFCA00265-W

C

usrrc

ユーザサービス定義

max_open_fds

−

−

max_open_fds指定あり

−

481

RPC-0019

KFCA00371-W

E

usrrc

ユーザサービス定義

max_open_fds

betranrc

usrrc

ユーザサービス定義

max_socket_descriptors

((OS != Solaris) && (OS != Linux)) && ((max_socket_descriptors＋max_open_fds) ＞ 2048)

|| ((OS == Solaris)

|| (OS == Linux)) && ((max_socket_descriptors＋max_open_fds) ＞ 1024)

RPC#1

482

RPC-0020

KFCA00375-W

E

ユーザサービス定義

service

usrrc

ユーザサービス定義

receive_from

( (receive_from == queue )

|| (receive_from == socket ) ) && (service指定なし)

RPC#1

483

RPC-0021

KFCA00278-W

C

ユーザサービス定義

service

usrrc

ユーザサービス定義

receive_from

(receive_from == none) && (service指定あり)

−

484

RPC-0022

KFCA00275-W

E

ユーザサービス定義

service

−

−

次に示す条件のどれかに該当する場合

UAP共用ライブラリ名に空白文字の指定あり

UAP共用ライブラリ名にタブコードの指定あり

UAP共用ライブラリ名のパス名に環境変数を指定する場合で，環境変数をパス名の先頭以外に指定している

−

485

RPC-0024

KFCA00372-W

E

betranrc

dcbindht

−

−

-hオプションに指定されたホスト名を変換したIP == 127.x.x.x

xは0〜255の任意の値です。

486

RPC-0025

KFCA00378-W

C

ユーザサービス定義

service

−

−

UAP共用ライブラリ名指定あり

−

487

RPC-0026

KFCA00269-W

C

usrrc

ユーザサービス定義

atomic_update

betranrc

jnl_fileless_option

(jnl_fileless_option == Y) && (atomic_update == Y)

RPC#1

atomic_update（省略時はY）

488

RPC-0027

KFCA00376-W

C

betranrc

jnl

scd

trn

nam

prc

usrrc

ユーザサービス定義

ipc_sendbuf_size

−

−

(1<= ipc_sendbuf_size <= 8191)

−

489

RPC-0028

KFCA00376-W

C

betranrc

jnl

scd

trn

nam

prc

usrrc

ユーザサービス定義

ipc_recvbuf_size

−

−

(1 <= ipc_recvbuf_size <= 8191)

−

490

RPC-0029

KFCA00276-W

C

betranrc

ipc_response_host

−

−

(ipc_notify_response_host=Nまたは指定なし) && (ipc_response_host指定あり)

−

491

RPC-0030

KFCA00372-W

E

betranrc

ipc_response_host

−

−

ホスト名を変換したIPアドレス == 127.x.x.x

xは0〜255の任意の値です。

492

RPC-0031

KFCA00375-W

E

betranrc

ipc_response_host

−

−

(ipc_notify_response_host=Y) && (ipc_response_host指定なし)

−

493

RPC-0032

KFCA00377-W

E

betranrc

ipc_response_host

−

−

次に示すどれかの条件に該当

hostsファイルやDNSなどでホスト名とIPアドレスをマッピングできない

hostsファイルのアクセス権限がないため，参照できない

OpenTP1からDNSサーバへの問い合わせが一時的なエラーにより失敗

−

494

−

KFCA00216-E

−

betranrc

ipc_notify_response_host

−

−

(ipc_notify_response_host != Y) && (ipc_notify_response_host != N)

−

495

−

KFCA00216-E

−

betranrc

ipc_response_host

−

−

ホスト名 ＞ 255

−

496

−

KFCA00323-E

−

betranrc

dcbindht

−

−

-hオプションに指定されたホスト名がhostsファイル，DNSなどでホスト名とIPアドレスのマッピングができない

−

497

−

KFCA00324-E

−

betranrc

dcbindht

−

−

-nオプションに指定されたネットワーク名がnetworksファイル，NISなどでネットワーク名とネットワーク番号をマッピングできない

−

498

−

KFCA00340-W

（エラー要因コード：3）

−

usrnet

dcsvgdef

−

−

-hオプションに指定されたホスト名がhostsファイル，DNSなどでホスト名とIPアドレスのマッピングができない

−

499

−

KFCA00340-W

（エラー要因コード：7）

−

usrnet

dcsvgdef

−

−

(-wオプション指定あり) && (-tオプション指定あり)

−

500

−

KFCA00340-W

（エラー要因コード：7）

−

usrnet

dcsvgdef

−

−

(-hオプション指定ホスト1個) && (-tオプション指定あり)

−

501

RTS-0001

KFCA00267-W

E

rts

rts_log_file_name

−

−

( rts_log_file == Y )

&& ( RTSログファイルの出力先ディレクトリが存在しない )

−

502

RTS-0002

KFCA00272-W

C

rts

rts_log_file_count

−

−

( rts_log_file == Y ) && ( rts_log_file_count ＜ 3)

−

503

RTS-0003

KFCA00280-W

C

rts

rts_log_file_name

rts

rts_log_file

( rts_log_file == N ) && ( rts_log_file_name指定あり)

−

504

RTS-0004

KFCA00280-W

C

rts

rts_log_file_size

rts

rts_log_file

( rts_log_file == N ) && ( rts_log_file_size指定あり)

−

505

RTS-0005

KFCA00280-W

C

rts

rts_log_file_count

rts

rts_log_file

( rts_log_file == N ) && ( rts_log_file_count指定あり)

−

506

RTS-0006

KFCA00280-W

C

rts

rts_swap_message

rts

rts_log_file

( rts_log_file == N ) && ( rts_swap_message == Y)

−

507

RTS-0007

KFCA32765-W

C

rts

rtsput

rts

rts_service_max

取得対象の登録数 ＞ rts_service_max

−

508

RTS-0008

KFCA00275-W

W

ユーザサービス定義

type

−

−

( ( type == RTS ) && ( 定義ファイル名がRTSSUPではない ) )

|| ( ( type == RTS ) && ( 定義ファイル名がRTSSPPではない ) )

−

509

RTS-0009

KFCA00275-W

W

ユーザサービス定義

module

−

−

( ( type != RTS ) && ( module == rtssup ) && ( 定義ファイル名がRTSSUPではない ) ) ||

( ( type != RTS ) && ( module == rtsspp ) && ( 定義ファイル名がRTSSPPではない ) )

−

510

RTS-0010

KFCA32763-W

W

ユーザサービス定義

（RTSSUPまたはRTSSPP）

type

ユーザサービス定義

module

( ( type != RTS ) && ( module == rtssup ) && ( 定義ファイル名がRTSSUP ) )

||

( ( type != RTS ) && ( module == rtsspp ) && ( 定義ファイル名がRTSSPP ) )

−

511

RTS-0011

KFCA32764-W

W

ユーザサービス定義

（RTSSUPまたはRTSSPP）

−

−

−

RTSSUPまたはRTSSPPの内容が，rtssetupコマンドで作成したときと異なっている

−

512

RTS-0012

KFCA00267-W

E

rts

rts_log_file_name

−

−

( rts_log_file == Y ) && (( RTSログファイルの出力先ディレクトリにOpenTP1管理者の書き込み権限がない )

|| ( RTSログファイルの出力先ディレクトリにOpenTP1管理者の実行権限がない ))

−

513

RTS-0013

KFCA00268-W

E

rts

rts_log_file_name

−

−

( rts_log_file == Y ) && ( rts_log_file_nameに指定したRTSログファイルにOpenTP1管理者の書き込み権限がない )

RTS#1

514

RTS-0014

KFCA00268-W

E

rts

rts_log_file_name

−

−

( rts_log_file == Y ) && ( rts_log_file_nameに指定したRTSログファイルがファイルではない )

RTS#1

515

RTS-0015

KFCA00272-W

C

rts

rts_log_file

−

−

rts_log_file == N

−

516

RTS-0016

KFCA00280-W

C

rts

rts_log_file_backup

−

rts_log_file

( rts_log_file == N ) && ( rts_log_file_backup == Y )

−

517

RTS-0017

KFCA00268-W

C

rts

rts_log_file_backup

−

rts_log_file

rts_log_file_name

( rts_log_file == Y ) && ( rts_log_file_backup == Y ) && (バックアップファイルと同じ名称のディレクトリが存在する)

RTS#2

518

−

KFCA00242-E

−

rts

rtsput

−

−

( ( -u srv ) && ( -s 存在しないユーザサービス定義ファイル名 ) )

|| ( -f 存在しないリアルタイム取得項目定義ファイル名 )

−

519

−

KFCA32710-W

−

rts

rtsput

rts

rts_item_max

取得する項目の登録数 ＞ rts_item_max

−

520

−

KFCA32709-W

−

rts

rtsput

rts

rts_service_max

取得対象の登録数 ＞ rts_service_max

−

521

SCD-0001

KFCA00262-W

C

scd

scd_server_count

env

server_count

scd_server_count ＞ server_count

−

522

SCD-0002

KFCA00279-W

C

scd

scd_hold_recovery

env

start_scheduling_timing

(scd_hold_recovery指定あり) && (start_scheduling_timing指定なし)

−

523

SCD-0003

KFCA00278-W

C

scd

scd_hold_recovery

env

start_scheduling_timing

(scd_hold_recovery指定あり) && (start_scheduling_timing == AFTER)

−

524

SCD-0004

KFCA00278-W

C

scd

scd_hold_recovery

scd

scd_hold_recovery_count

(scd_hold_recovery指定あり) && (scd_hold_recovery_count == 0))

−

525

SCD-0005

KFCA33200-W

E

scd

scd_hold_recovery_count

betranrc

rpc_max_message_size

↑(scd_hold_recovery_count / 7280)↑

＞ (rpc_max_message_size指定値(省略値：1))

−

526

SCD-0006

KFCA00266-W

C

scd

scd_port

−

−

scd_port指定あり

−

527

SCD-0007

KFCA00272-W

C

scd

scd_announce_server_status

−

−

scd_announce_server_status == N

−

528

SCD-0008

KFCA00278-W

C

scd

scd_advertise_control

env

start_scheduling_timing

(scd_advertise_control == AFTER) && (start_scheduling_timing == BEFORE)

−

529

SCD-0009

KFCA00272-W

C

scd

scd_message_level

−

−

scd_message_level == 1

−

530

SCD-0010

KFCA00259-W

E

scd

scdbufgrp

scd

scdbufgrp

ほかのscdbufgrpに指定したスケジュールバッファグループ名と重複

−

531

SCD-0011

KFCA00274-W

E

scd

scdbufgrp

−

−

(scdbufgrpの-nオプション指定値 × scdbufgrpの-lオプション指定値)

＞ 31457280

推奨値：31457280 / -nオプション指定値

−

532

SCD-0012

KFCA00259-W

E

scd

scdmulti

scd

scdmulti

ほかのscdmultiに指定したマルチスケジューラグループ名と重複（-gオプション指定なしのscdmultiが複数指定された場合）

−

533

SCD-0013

KFCA33201-W

E

scd

scdmulti

prc

prc_process_count

(scdmultiの-mオプション指定値の総和) ＞ (prc_process_count指定値)

−

534

SCD-0014

KFCA33201-W

E

scd

scdmulti

env

server_count

(scdmultiの-mオプション指定値の総和) ＞ (server_count指定値)

−

535

SCD-0015

KFCA33202-W

E

scd

scdmulti

scd

scd_port

(scd_port指定なし) && (最初に指定したscdmultiに-pオプション指定なし)

−

536

SCD-0016

KFCA33203-W

E

scd

scdmulti

−

−

(scdmultiの-pオプション指定値

＋ scdmultiの-mオプション指定値(省略値は1) − 1) ＞ 65535)

−

537

SCD-0017

KFCA33203-W

E

scd

scdmulti

scd

scd_port

(scdmultiの-pオプション指定なし) && ((scdmultiの-mオプション指定値(省略値は1) ＋ scd_port指定値) ＞ 65535)

−

538

SCD-0018

KFCA00266-W

C

scd

scdmulti

−

−

ほかのscdmultiの論理チェックがエラーではない場合

−

539

SCD-0019

KFCA00285-W

E

scd

scdbufgrp

scd

scdbufgrp

scdbufgrpのスケジュールバッファグループ名を省略

−

540

SCD-0027

KFCA00274-W

E

scd

scdbufgrp

−

−

↑(scdbufgrpの-eオプション指定値 / scdbufgrpの-lオプション指定値)↑×scdbufgrpの-lオプション指定値 ＞ 1610612736

推奨値：-lオプション指定値の整数倍

−

541

SCD-0028

KFCA00262-W

E

scd

scdbufgrp

−

−

(scdbufgrp指定あり)

&& (scdbufgrp -s 指定あり)

&& (scdbufgrpの-sオプション指定値 > (scdbufgrpの-lオプション×-nオプション指定値))

−

542

SCD-0029

KFCA00262-W

E

scd

scdbufgrp

−

−

(scdbufgrp指定あり)

&& (scdbufgrp -s 指定あり)

&& (scdbufgrpの-sオプション指定値 > scdbufgrpの-eオプション指定値)

−

543

SCD-0030

KFCA00263-W

E

scd

scdbufgrp

−

−

(scdbufgrp指定あり)

&& (scdbufgrp -s 指定あり)

&& (scdbufgrpの-sオプション指定値 < scdbufgrpの-lオプション指定値)

−

544

SCD-0031

KFCA33210-W

E

scd

scdbufgrp

−

−

(scdbufgrp指定あり)

&& (scdbufgrp -p 指定あり)

&& (セル数＊scdbufgrpの-pオプション指定値÷100 < 1)

セル数：

scdbufgrp -nオプション指定値　または

scdbufgrp -eオプション指定値÷-lオプション指定値

−

545

SCD-1001

KFCA00285-W

E

ユーザサービス定義

service_group

ユーザサービス定義

receive_from

(receive_from == socket) && (service_group指定なし)

−

546

SCD-1002

KFCA00285-W

E

ユーザサービス定義

service_group

ユーザサービス定義

receive_from

(receive_from == queue) && (service_group指定なし)

−

547

SCD-1003

KFCA33204-W

E

ユーザサービス定義

parallel_count

−

−

(receive_from == queue) && (parallel_countの常駐プロセス数が == 0) && (parallel_countの最大プロセス数が == 0)

SCD#1

parallel_countが次に示す指定値の場合

・set parallel_count = 0，0

・set parallel_count = 0

548

SCD-1004

KFCA33205-W

E

ユーザサービス定義

parallel_count

−

−

(receive_from == queue) && (parallel_countの常駐プロセス数 ＞ parallel_countの最大プロセス数)

SCD#1

549

SCD-1005

KFCA00262-W

E

ユーザサービス定義

parallel_count

prc

prc_process_count

(receive_from == queue) && (parallel_countの常駐プロセス数 ＞= prc_process_count)

SCD#1

550

SCD-1006

KFCA00262-W

C

ユーザサービス定義

parallel_count

prc

prc_process_count

(receive_from == queue) && (parallel_countの常駐プロセス数 ＜ prc_process_count) && (parallel_countの最大プロセス数 ＞= prc_process_count)

SCD#1

551

SCD-1007

KFCA00278-W

C

ユーザサービス定義

hold_recovery

scd

scd_hold_recovery_count

(receive_from == queue)

&& (type == other)

&& (hold_recovery指定あり)

&& (hold_recovery == Y)

&& (scd_hold_recovery_count == 0)

SCD#1

552

SCD-1008

KFCA00280-W

C

ユーザサービス定義

hold_recovery

env

scd

start_scheduling_timing

scd_hold_recovery

(receive_from == queue)

&& (type == other)

&& (hold_recovery指定あり)

&& (hold_recovery == Y)

&& (start_scheduling_timing == BEFORE)

&& (scd_hold_recovery != F)

SCD#1

553

SCD-1009

KFCA00281-W

C

ユーザサービス定義

message_store_buflen

ユーザサービス定義

scdbufgrp

(receive_from == queue)

&& (message_store_buflen指定あり)

&& (scdbufgrp指定あり)

SCD#1

554

SCD-1010

KFCA00265-W

C

ユーザサービス定義

message_store_buflen

ユーザサービス定義

type

(receive_from == queue)

&& (type == other)

&& (scdbufgrp指定なし)

SCD#1

555

SCD-1011

KFCA00273-W

KFCA00265-W

C

ユーザサービス定義

message_store_buflen

ユーザサービス定義

type

(receive_from == queue)

&& (type == MHP)

&& ((parallel_countの常駐プロセス数 == 最大プロセス数)

|| balance_count == 0)

&& (message_store_buflenの指定値

＜ (512 × parallel_countの最大プロセス数))

SCD#1

SCD#2

556

SCD-1012

KFCA00273-W

KFCA00265-W

C

ユーザサービス定義

message_store_buflen

ユーザサービス定義

type

(receive_from == queue)

&& (type == MHP)

&& ((parallel_countの常駐プロセス数 != 最大プロセス数)

&& balance_count ＞ 0)

&& (message_store_buflenの指定値

＜ (512 × parallel_countの最大プロセス数 × balance_countの指定値))

SCD#1

SCD#2

557

SCD-1013

KFCA33209-W

C

ユーザサービス定義

balance_count

ユーザサービス定義

parallel_count

(receive_from == queue)

&& (balance_count指定あり)

&& (parallel_countの常駐プロセス数 == 最大プロセス数)

SCD#1

558

SCD-1014

KFCA00281-W

C

ユーザサービス定義

message_cell_size

ユーザサービス定義

scdbufgrp

(receive_from == queue)

&& (message_cell_size指定あり)

&& (scdbufgrp指定あり)

SCD#1

559

SCD-1015

KFCA33206-W

C

ユーザサービス定義

message_cell_size

ユーザサービス定義

service_priority_control

service_hold

(receive_from == queue)

&& (type == other)

&& (message_cell_size指定あり)

&& ((service_priority_control == N)

&& (service_hold == N))

SCD#1

560

SCD-1016

KFCA33207-W

C

ユーザサービス定義

purge_msgget

ユーザサービス定義

parallel_count

(receive_from == queue)

&& (purge_msgget指定あり)

&& (parallel_countの常駐プロセス数 ＞ 0)

SCD#1

561

SCD-1017

KFCA00278-W

C

ユーザサービス定義

service_term_watch_time

ユーザサービス定義

hold

(receive_from == queue)

&& (type == other)

&& (service_term_watch_time ＞ 0)

&& (hold == Y)

SCD#1

562

SCD-1018

KFCA00279-W

C

ユーザサービス定義

service_term_watch_time

ユーザサービス定義

hold

(receive_from == queue)

&& (type == other)

&& (service_term_watch_time ＞ 0)

&& (hold指定なし)

SCD#1

563

SCD-1019

KFCA00278-W

C

ユーザサービス定義

service_term_watch_time

ユーザサービス定義

service_hold

(receive_from == queue)

&& (type == other)

&& (service_term_watch_time ＞ 0)

&& (service_hold指定あり)

&& (service_hold == N)

SCD#1

564

SCD-1020

KFCA00279-W

C

ユーザサービス定義

service_term_watch_time

ユーザサービス定義

service_hold

(receive_from == queue)

&& (type == other)

&& (service_term_watch_time ＞ 0)

&& (service_hold指定なし)

SCD#1

565

SCD-1021

KFCA33209-W

C

ユーザサービス定義

termed_after_service

ユーザサービス定義

parallel_count

(receive_from == queue)

&& (parallel_countの常駐プロセス数 == 最大プロセス数)

&& (termed_after_service == Y)

SCD#1

566

SCD-1023

KFCA00282-W

C

ユーザサービス定義

schedule_method

−

−

schedule_method指定あり

SCD#1

567

SCD-1024

KFCA00282-W

C

ユーザサービス定義

service_wait_time

−

−

service_wait_time指定あり

SCD#1

568

SCD-1027

KFCA00278-W

C

ユーザサービス定義

make_queue_on_starting

ユーザサービス定義

purge_msgget

(receive_from == queue)

&& (make_queue_on_starting == Y)

&& (purge_msgget == Y)

SCD#1

569

SCD-1028

KFCA33207-W

C

ユーザサービス定義

make_queue_on_starting

ユーザサービス定義

parallel_count

(receive_from == queue)

&& (make_queue_on_starting == Y)

&& (parallel_countの常駐プロセス数 ＞ 0)

SCD#1

570

SCD-1029

KFCA00278-W

C

ユーザサービス定義

scd_poolfull_check_count

ユーザサービス定義

scd_poolfull_check_interval

(receive_from == queue)

&& (scd_poolfull_check_count指定あり)

&& (scd_poolfull_check_interval == 0)

SCD#1

571

SCD-1030

KFCA00279-W

C

ユーザサービス定義

scd_poolfull_check_count

ユーザサービス定義

scd_poolfull_check_interval

(receive_from == queue)

&& (scd_poolfull_check_count指定あり)

&& (scd_poolfull_check_interval指定なし)

SCD#1

572

SCD-1031

KFCA00278-W

C

ユーザサービス定義

loadcheck_interval

scd

scd_announce_server_status

(receive_from == queue)

&& (type == other)

&& (loadcheck_interval ＞ 0)

&& (scd_announce_server_status == N)

SCD#1

573

SCD-1032

KFCA00278-W

C

ユーザサービス定義

levelup_queue_count

scd

scd_announce_server_status

(receive_from == queue)

&& (type == other)

&& (levelup_queue_count指定あり)

&& (scd_announce_server_status == N)

SCD#1

levelup_queue_countとleveldown_queue_countの指定値が次に示す条件に当てはまるように指定します。

条件式：0≦D0＜U1≦D1＜U2

574

SCD-1033

KFCA00261-W

E

ユーザサービス定義

levelup_queue_count

ユーザサービス定義

leveldown_queue_count

(receive_from == queue)

&& (type == other)

&& (levelup_queue_count指定あり)

&& ((scd_announce_server_status == Y)

||(scd_announce_server_status指定なし))

&& (U1 ＜ 1)

SCD#1

levelup_queue_countとleveldown_queue_countの指定値が次に示す条件に当てはまるように指定します。

条件式：0≦D0＜U1≦D1＜U2

575

SCD-1034

KFCA00262-W

E

ユーザサービス定義

levelup_queue_count

−

−

(receive_from == queue)

&& (type == other)

&& (levelup_queue_count指定あり)

&& ((scd_announce_server_status == Y)

||(scd_announce_server_status指定なし))

&& (U1 ＞ 0)

&& (U2 ≦ U1)

SCD#1

576

SCD-1035

KFCA00279-W

C

ユーザサービス定義

leveldown_queue_count

ユーザサービス定義

levelup_queue_count

(receive_from == queue)

&& (type == other)

&& (leveldown_queue_count指定あり)

&& (levelup_queue_count指定なし)

SCD#1

levelup_queue_countとleveldown_queue_countの指定値が次に示す条件に当てはまるように指定します。

条件式：0≦D0＜U1≦D1＜U2

577

SCD-1036

KFCA00262-W

E

ユーザサービス定義

leveldown_queue_count

ユーザサービス定義

levelup_queue_count

(receive_from == queue)

&& (type == other)

&& (leveldown_queue_count指定あり)

&& (levelup_queue_count指定あり)

&& ((scd_announce_server_status == Y)

|| (scd_announce_server_status指定なし))

&& (D0 ≧ U1)

SCD#1

levelup_queue_countとleveldown_queue_countの指定値が次に示す条件に当てはまるように指定します。

条件式：0≦D0＜U1≦D1＜U2

578

SCD-1037

KFCA00262-W

E

ユーザサービス定義

leveldown_queue_count

ユーザサービス定義

levelup_queue_count

(receive_from == queue)

&& (type == other)

&& (leveldown_queue_count指定あり)

&& (levelup_queue_count指定あり)

&& ((scd_announce_server_status == Y)

|| (scd_announce_server_status指定なし))

&& (D1 ≧ U2)

SCD#1

579

SCD-1038

KFCA00278-W

C

ユーザサービス定義

schedule_delay_abort

ユーザサービス定義

schedule_delay_limit

(receive_from == queue)

&& (type == other)

&& schedule_delay_abort指定あり

&& (schedule_delay_limit == 0)

SCD#1

580

SCD-1039

KFCA00279-W

C

ユーザサービス定義

schedule_delay_abort

ユーザサービス定義

schedule_delay_limit

(receive_from == queue)

&& (type == other)

&& schedule_delay_abort指定あり

&& (schedule_delay_limit指定なし)

SCD#1

581

SCD-1040

KFCA00278-W

C

ユーザサービス定義

scd_pool_warning_interval

ユーザサービス定義

scd_pool_warning_use_rate

(receive_from == queue)

&& (type == other)

&& (scd_pool_warning_interval ＞ 0)

&& (scd_pool_warning_use_rate == 0)

SCD#1

582

SCD-1041

KFCA00279-W

C

ユーザサービス定義

scd_pool_warning_interval

ユーザサービス定義

scd_pool_warning_use_rate

(receive_from == queue)

&& (type == other)

&& (scd_pool_warning_interval ＞ 0)

&& (scd_pool_warning_use_rate指定なし)

SCD#1

583

SCD-1042

KFCA00278-W

C

ユーザサービス定義

stay_watch_check_rate

ユーザサービス定義

stay_watch_queue_count

(receive_from == queue)

&& (type == other)

&& (stay_watch_queue_count == 0)

&& (stay_watch_check_rate指定あり)

SCD#1

584

SCD-1043

KFCA00279-W

C

ユーザサービス定義

stay_watch_check_rate

ユーザサービス定義

stay_watch_queue_count

(receive_from == queue)

&& (type == other)

&& (stay_watch_queue_count指定なし)

&& (stay_watch_check_rate指定あり)

SCD#1

585

SCD-1044

KFCA00278-W

C

ユーザサービス定義

stay_watch_abort

ユーザサービス定義

stay_watch_queue_count

(receive_from == queue)

&& (type == other)

&& (stay_watch_abort指定あり)

&& (stay_watch_queue_count == 0)

SCD#1

586

SCD-1045

KFCA00279-W

C

ユーザサービス定義

stay_watch_abort

ユーザサービス定義

stay_watch_queue_count

(receive_from == queue)

&& (type == other)

&& (stay_watch_abort指定あり)

&& (stay_watch_queue_count指定なし)

SCD#1

587

SCD-1046

KFCA00278-W

C

ユーザサービス定義

stay_watch_start_interval

ユーザサービス定義

stay_watch_queue_count

(receive_from == queue)

&& (type == other)

&& (stay_watch_start_interval指定あり)

&& (stay_watch_queue_count == 0)

SCD#1

588

SCD-1047

KFCA00279-W

C

ユーザサービス定義

stay_watch_start_interval

ユーザサービス定義

stay_watch_queue_count

(receive_from == queue)

&& (type == other)

&& (stay_watch_start_interval指定あり)

&& (stay_watch_queue_count指定なし)

SCD#1

589

SCD-1048

KFCA00278-W

C

ユーザサービス定義

stay_watch_check_interval

ユーザサービス定義

stay_watch_queue_count

(receive_from == queue)

&& (type == other)

&& (stay_watch_check_interval指定あり)

&& (stay_watch_queue_count == 0)

SCD#1

590

SCD-1049

KFCA00279-W

C

ユーザサービス定義

stay_watch_check_interval

ユーザサービス定義

stay_watch_queue_count

(receive_from == queue)

&& (type == other)

&& (stay_watch_check_interval指定あり)

&& (stay_watch_queue_count指定なし)

SCD#1

591

SCD-1050

KFCA00276-W

E

ユーザサービス定義

scdbufgrp

scd

scdbufgrp

指定されたバッファグループがスケジュールサービス定義に指定されていない

−

592

SCD-1051

KFCA33208-W

E

ユーザサービス定義

scdmulti

ユーザサービス定義

scdmulti

scdmultiが一つのユーザサービス定義に複数指定されている

−

593

SCD-1052

KFCA00276-W

E

ユーザサービス定義

scdmulti

scd

scdmulti

指定されたマルチスケジューラグループがスケジュールサービス定義のscdmultiで指定されていない

−

594

SCD-1053

KFCA00281-W

C

ユーザサービス定義

termed_after_service

ユーザサービス定義

service_wait_time

(receive_from == queue)

&& (termed_after_service == Y)

&& (schedule_method == namedpipe)

&& (service_wait_time指定あり)

OSがWindowsの場合はチェックしません。

595

SCD-1054

KFCA00278-W

C

ユーザサービス定義

service_wait_time

ユーザサービス定義

schedule_method

(receive_from == queue)

&& ((schedule_method == msgque)

|| (schedule_method指定なし))

&& (service_wait_time指定あり)

SCD#1

OSがWindowsの場合はチェックしません。

596

SCD-1055

KFCA00259-W

W

ユーザサービス定義

scdsvcdef

ユーザサービス定義

scdsvcdef

次に示すどちらかの条件

指定されたサービス名がほかのscdsvcdef定義コマンドで指定されている

サービス名を省略したscdsvcdef定義コマンドが重複して指定されている

−

597

SCD-1056

KFCA00276-W

W

ユーザサービス定義

scdsvcdef

ユーザサービス定義

service

指定されたサービス名がservice定義コマンドに指定されていない

−

598

SCD-1057

KFCA00262-W

W

ユーザサービス定義

scdsvcdef

ユーザサービス定義

message_store_buflen

(receive_from == queue)

&& (type == other)

&& (scdbufgrp指定なし)

&& (scdsvcdef -l指定値 ＞= message_store_buflen)

SCD#1

599

SCD-1058

KFCA00262-W

W

ユーザサービス定義

scdsvcdef

ユーザサービス定義

scdbufgrp

(receive_from == queue)

&& (type == other)

&& (scdbufgrp指定あり)

&& (scdsvcdef -l指定値 ＞= (scdbufgrp -n指定値 × scdbufgrp -l指定値))

−

600

SCD-1059

KFCA00262-W

W

ユーザサービス定義

scdsvcdef

ユーザサービス定義

parallel_count

(receive_from == queue)

&& (type == other)

&& (scdsvcdef -p指定値 ＞= parallel_count)

SCD#1

601

SCD-1060

KFCA00262-W

E

ユーザサービス定義

scdbufgrp

ユーザサービス定義

scdbufgrp

(receive_from == queue) && (type == other)

&& (scdbufgrp指定あり)

&& (scdbufgrp -s 指定あり)

&& (scdbufgrpの-sオプション指定値 > (スケジュールサービス定義 scdbufgrpの-lオプション×-nオプション指定値))

−

602

SCD-1061

KFCA00262-W

E

ユーザサービス定義

scdbufgrp

ユーザサービス定義

scdbufgrp

(receive_from == queue) && (type == other)

&& (scdbufgrp指定あり)

&& (scdbufgrp -s 指定あり)

&& (scdbufgrpの-sオプション指定値 > スケジュールサービス定義 scdbufgrpの-eオプション指定値)

−

603

SCD-1062

KFCA00263-W

E

ユーザサービス定義

scdbufgrp

ユーザサービス定義

scdbufgrp

(receive_from == queue) && (type == other)

&& (scdbufgrp指定あり)

&& (scdbufgrp -s 指定あり)

&& (scdbufgrpの-sオプション指定値 < スケジュールサービス定義 scdbufgrpの-lオプション指定値)

−

604

SCD-1063

KFCA00269-W

E

ユーザサービス定義

scdbufgrp

ユーザサービス定義

scdbufgrp

(receive_from == queue) && (type == MHP)

&& (scdbufgrp指定あり)

&& (scdbufgrp -s または -p 指定あり)

−

605

SCD-1064

KFCA33210-W

E

ユーザサービス定義

scdbufgrp

ユーザサービス定義

scdbufgrp

(receive_from == queue) && (type == other)

&& (scdbufgrp指定あり)

&& (scdbufgrp -p 指定あり)

&& (セル数＊scdbufgrpの-pオプション指定値÷100 < 1)

セル数：スケジュールサービス定義のscdbufgrp -nオプション指定値またはscdbufgrp -eオプション指定値÷-lオプション指定値

−

606

SCS-0001

KFCA27770-W

C

rapリスナー用ユーザサービス定義

rap_client_manager_node

−

−

(rap_client_manager_node == my_host指定値) || (rap_client_manager_nodeのホスト名 == ローカルループバックアドレス)

−

607

SCS-0002

KFCA27772-W

E

rapリスナー用ユーザサービス定義

rap_client_manager_node

−

−

rap_client_manager_node != "ホスト名:port"

−

608

SCS-0002

KFCA27772-W

E

rapリスナー用ユーザサービス定義

module

−

−

(DCSCSLNAME値 == 定義ファイル名)

&& (module != raplisnr)

−

609

SCS-0002

KFCA27772-W

E

rapリスナー用ユーザサービス定義

atomic_update

−

−

atomic_update != N

−

610

SCS-0002

KFCA27772-W

E

rapリスナー用ユーザサービス定義

receive_from

−

−

receive_from != none

−

611

SCS-0002

KFCA27772-W

E

rapリスナー用ユーザサービス定義

auto_restart

−

−

auto_restart != Y

−

612

SCS-0002

KFCA27772-W

E

rapリスナー用ユーザサービス定義

critical

−

−

critical != N

−

613

SCS-0002

KFCA27772-W

E

rapリスナー用ユーザサービス定義

trf_put

−

−

trf_put != N

−

614

SCS-0002

KFCA27772-W

E

rapリスナー用ユーザサービス定義

node_down_restart

−

−

node_down_restart != Y

−

615

SCS-0002

KFCA27772-W

E

rapリスナー用ユーザサービス定義

term_watch_time

−

−

term_watch_time != 0

−

616

SCS-0002

KFCA27772-W

E

rapリスナー用ユーザサービス定義

max_open_fds

−

−

max_open_fds != rapdfgen生成値

−

617

SCS-0002

KFCA27772-W

E

rapリスナー用ユーザサービス定義

rpc_destination_mode

−

−

rpc_destination_mode != namdonly

−

618

SCS-0002

KFCA27772-W

E

rapリスナー用ユーザサービス定義

status_change_when_terming

−

−

status_change_when_terming != N

−

619

SCS-0002

KFCA27772-W

E

rapリスナー用ユーザサービス定義

DCSCSPARA

（rap_parallel_server）

任意

（rapサーバ）

parallel_count

DCSCSPARA値 != parallel_count

−

620

SCS-0003

KFCA00266-W

C

rapリスナー用ユーザサービス定義

rap_client_manager_node

−

−

rap_client_manager_node指定あり

−

621

SCS-0004

KFCA27771-W

E

rapリスナー用ユーザサービス定義

module

−

−

(type != RAP) && (module == raplisnr)

−

622

SCS-0005

KFCA00278-W

C

rapリスナー用ユーザサービス定義

rap_client_manager_node

−

−

(rap_notify == N) && (rap_client_manager_node指定あり)

−

623

SCS-0006

KFCA00266-W

C

rapリスナー用ユーザサービス定義

DCSCSPORT

（rap_listen_port）

−

−

DCSCSPORT指定あり

−

624

SCS-0007

KFCA27777-W

W

rapリスナー用ユーザサービス定義

max_socket_descriptors

betranrc

usrrc

max_open_fds

((OS != Solaris) && (OS != Linux)) && ( (max_socket_descriptors＋max_open_fds ) ＞ 2048)||((OS == Solaris)

||

(OS == Linux)) && ( (max_socket_descriptors＋max_open_fds ) ＞ 1024)

−

625

SCS-0008

KFCA27778-W

E

rapリスナー用ユーザサービス定義

−

任意

（rapサーバ）

−

rapサーバの定義ファイルなし

−

626

SCS-0009

KFCA27775-W

E

rapリスナー用ユーザサービス定義

rap_client_manager_node

−

−

ホスト名がアドレス解決できない

−

627

SCS-0010

KFCA00279-W

C

rapリスナー用ユーザサービス定義

rap_client_manager_node

−

−

(rap_notify == Y) && (rap_client_manager_node指定なし)

−

628

SCS-0011

KFCA00262-W

C

rapリスナー用ユーザサービス定義

rap_term_disconnect_time

env

system_terminate_watch_time

(system_terminate_watch_time != 0) && ((rap_term_disconnect_time == 0) || (rap_term_disconnect_time >= system_terminate_watch_time))

−

629

SCS-0012

KFCA00274-W

C

rapリスナー用ユーザサービス定義

rap_stay_watch_time

−

−

rap_stay_watch_time > 30

−

630

SCS-0013

KFCA00278-W

C

rapリスナー用ユーザサービス定義

rap_stay_warning_interval

rapリスナー用ユーザサービス定義

rap_stay_watch_time

(rap_stay_watch_time == 0) && rap_stay_warning_interval指定あり

−

631

SCS-0101

KFCA27772-W

E

rapサーバ用ユーザサービス定義

service_group

−

−

(type == RAP) && (service_group != 定義ファイル名)

−

632

SCS-0101

KFCA27772-W

E

rapサーバ用ユーザサービス定義

module

−

−

(type == RAP) && (module != rapservr)

−

633

SCS-0101

KFCA27772-W

E

rapサーバ用ユーザサービス定義

atomic_update

−

−

atomic_update != Y

−

634

SCS-0101

KFCA27772-W

E

rapサーバ用ユーザサービス定義

hold

−

−

hold != N

−

635

SCS-0101

KFCA27772-W

E

rapサーバ用ユーザサービス定義

hold_recovery

−

−

hold_recovery != N

−

636

SCS-0101

KFCA27772-W

E

rapサーバ用ユーザサービス定義

service

−

−

service != "rapexec=scs_service_exec"

−

637

SCS-0101

KFCA27772-W

E

rapサーバ用ユーザサービス定義

balance_count

−

−

balance_count != 0

−

638

SCS-0101

KFCA27772-W

E

rapサーバ用ユーザサービス定義

auto_restart

−

−

auto_restart != Y

−

639

SCS-0101

KFCA27772-W

E

rapサーバ用ユーザサービス定義

critical

−

−

critical != N

−

640

SCS-0101

KFCA27772-W

E

rapサーバ用ユーザサービス定義

service_hold

−

−

service_hold != N

−

641

SCS-0101

KFCA27772-W

E

rapサーバ用ユーザサービス定義

service_priority_control

−

−

service_priority_control != N

−

642

SCS-0101

KFCA27772-W

E

rapサーバ用ユーザサービス定義

node_down_restart

−

−

node_down_restart != N

−

643

SCS-0101

KFCA27772-W

E

rapサーバ用ユーザサービス定義

server_type

−

−

server_type != betran

−

644

SCS-0101

KFCA27772-W

E

rapサーバ用ユーザサービス定義

term_watch_time

−

−

term_watch_time != 0

−

645

SCS-0101

KFCA27772-W

E

rapサーバ用ユーザサービス定義

max_open_fds

−

−

max_open_fds != rapdfgen生成値

−

646

SCS-0101

KFCA27772-W

E

rapサーバ用ユーザサービス定義

server_security

−

−

server_security != N

−

647

SCS-0101

KFCA27772-W

E

rapサーバ用ユーザサービス定義

message_store_buflen

−

−

message_store_buflen != rapdfgen生成値

−

648

SCS-0101

KFCA27772-W

E

rapサーバ用ユーザサービス定義

schedule_delay_limit

−

−

schedule_delay_limit != 0

−

649

SCS-0101

KFCA27772-W

E

rapサーバ用ユーザサービス定義

schedule_delay_abort

−

−

schedule_delay_abort != N

−

650

SCS-0102

KFCA27777-W

W

rapサーバ用ユーザサービス定義

max_socket_descriptors

betranrc

usrrc

max_open_fds

((OS != Solaris) && (OS != Linux)) && ( (max_socket_descriptors＋max_open_fds ) ＞ 2048)

||

((OS == Solaris)

|| (OS == Linux)) && ( (max_socket_descriptors＋max_open_fds ) ＞ 1024)

−

651

SCS-0103

KFCA27771-W

E

rapサーバ用ユーザサービス定義

module

−

−

(type != RAP) && (module == rapservr)

−

652

SCS-0201

KFCA27772-W

E

rapクライアントマネジャ用ユーザサービス定義

module

−

−

(type == RAP) && (module != rapclman)

−

653

SCS-0201

KFCA27772-W

E

rapクライアントマネジャ用ユーザサービス定義

atomic_update

−

−

atomic_update != N

−

654

SCS-0201

KFCA27772-W

E

rapクライアントマネジャ用ユーザサービス定義

receive_from

−

−

receive_from != none

−

655

SCS-0201

KFCA27772-W

E

rapクライアントマネジャ用ユーザサービス定義

auto_restart

−

−

auto_restart != Y

−

656

SCS-0201

KFCA27772-W

E

rapクライアントマネジャ用ユーザサービス定義

critical

−

−

critical != N

−

657

SCS-0201

KFCA27772-W

E

rapクライアントマネジャ用ユーザサービス定義

trf_put

−

−

trf_put != N

−

658

SCS-0201

KFCA27772-W

E

rapクライアントマネジャ用ユーザサービス定義

node_down_restart

−

−

node_down_restart != Y

−

659

SCS-0201

KFCA27772-W

E

rapクライアントマネジャ用ユーザサービス定義

term_watch_time

−

−

term_watch_time != 0

−

660

SCS-0201

KFCA27772-W

E

rapクライアントマネジャ用ユーザサービス定義

max_open_fds

−

−

max_open_fds != rapdfgen生成値

−

661

SCS-0201

KFCA27772-W

E

rapクライアントマネジャ用ユーザサービス定義

rpc_destination_mode

−

−

rpc_destination_mode != namdonly

−

662

SCS-0201

KFCA27772-W

E

rapクライアントマネジャ用ユーザサービス定義

status_change_when_terming

−

−

status_change_when_terming != N

−

663

SCS-0201

KFCA27772-W

E

rapクライアントマネジャ用ユーザサービス定義

rap_listen_inf

−

−

rap_listen_inf != "ノード名:port=ホスト名:port"

−

664

SCS-0202

KFCA00266-W

C

rapクライアントマネジャ用ユーザサービス定義

rap_client_manager_port

−

−

rap_client_manager_port指定あり

−

665

SCS-0203

KFCA27777-W

W

rapクライアントマネジャ用ユーザサービス定義

max_socket_descriptors

betranrc

usrrc

max_open_fds

((OS != Solaris) && (OS != Linux)) && ( (max_socket_descriptors＋max_open_fds ) ＞ 2048)

||

((OS == Solaris)

|| (OS == Linux)) && ( (max_socket_descriptors＋max_open_fds ) ＞ 1024)

−

666

SCS-0204

KFCA27771-W

E

rapクライアントマネジャ用ユーザサービス定義

module

−

−

(type!=RAP) && (module==rapclman)

−

667

SCS-0205

KFCA27770-W

C

rapクライアントマネジャ用ユーザサービス定義

rap_listen_inf

−

−

(rap_listen_inf == my_host指定値) || (rap_listen_inf == ローカルループバックアドレス)

−

668

SCS-0206

KFCA27775-W

E

rapクライアントマネジャ用ユーザサービス定義

rap_listen_inf

−

−

ホスト名がアドレス解決できない

−

669

SCS-0300

KFCA00269-W

C

ユーザサービス定義

usrrc

rpc_rap_inquire_time_check

ユーザサービス定義

usrrc

type

rpc_rap_inquire_time

(type==other || type==MHP) && rpc_rap_inquire_time_check==Yの指定あり

&& rpc_rap_inquire_time== 0の指定あり

−

670

SCS-0301

KFCA00270-W

C

ユーザサービス定義

usrrc

rpc_rap_inquire_

time_check

ユーザサービス定義

usrrc

type

rpc_rap_inquire_time

(type==other || type==MHP) && rpc_rap_inquire_time_check==Yの指定あり

&& rpc_rap_inquire_time== 0の指定なし

SCS#1

671

SCS-0501

KFCA00260-W

C

usrnet

dcsvgdef

−

−

次に示すどちらかの条件

-hのホスト名 == my_host指定値

-hのホスト名==ローカルループバックアドレス

−

672

STS-0001

KFCA00286-W

E

sts

全体

−

−

ステータスサービス定義ファイル（sts）が存在しない

−

673

STS-0002

KFCA00285-W

E

sts

sts_file_name_1〜sts_file_name_7

−

−

sts_file_name_1指定なし

−

674

STS-0003

KFCA01020-W

E

sts

sts_file_name_1〜sts_file_name_7

−

−

次に示すどちらかの条件

指定したファイルシステムがキャラクタ型スペシャルファイルではない

このファイルシステムに対応する装置がない

−

675

STS-0004

KFCA01021-W

E

sts

sts_file_name_1〜sts_file_name_7

−

−

指定したファイルがfilmkfsコマンドでOpenTP1ファイルシステム用に初期化されていない

−

676

STS-0005

KFCA01022-W

E

sts

sts_file_name_1〜sts_file_name_7

−

−

ステータスファイルがない

−

677

STS-0006

KFCA01023-W

E

sts

sts_file_name_1〜sts_file_name_7

−

−

OpenTP1ファイルシステムのバージョン不一致

−

678

STS-0007

KFCA01024-W

E

sts

sts_file_name_1〜sts_file_name_7

−

−

ステータスファイルのオープンで上限値オーバが発生

−

679

STS-0008

KFCA01025-W

E

sts

sts_file_name_1〜sts_file_name_7

−

−

該当するスペシャルファイルのアクセス権限がない

−

680

STS-0009

KFCA01026-W

E

sts

sts_file_name_1〜sts_file_name_7

−

−

該当するステータスファイルのアクセス権限がない

−

681

STS-0010

KFCA01027-W

E

sts

sts_file_name_1〜sts_file_name_7

−

−

ステータスファイルに対してI/Oエラーが発生

−

682

STS-0011

KFCA01028-W

E

sts

sts_file_name_1〜sts_file_name_7

−

−

ステータスファイルのオープンでメモリ不足が発生

−

683

STS-0012

KFCA01029-W

E

sts

sts_file_name_1〜sts_file_name_7

−

−

指定されたファイルはステータスファイルとして使用できない

−

684

STS-0013

KFCA01030-W

E

sts

sts_file_name_1〜sts_file_name_7

−

−

A系の物理ファイルとB系の物理ファイルでレコード長が異なっている

−

685

STS-0014

KFCA01031-W

E

sts

sts_file_name_1〜sts_file_name_7

−

−

A系の物理ファイルとB系の物理ファイルでレコード数が異なっている

−

686

STS-0015

KFCA01032-W

E

sts

sts_file_name_1〜sts_file_name_7

sts

sts_file_name_1〜sts_file_name_7

sts_file_name_1〜sts_file_name_7に指定された論理ファイル名と物理ファイル名が重複している

−

687

STS-0016

KFCA01033-W

W

sts

sts_last_active_file

−

−

sts_last_active_file指定あり

−

688

STS-0017

KFCA01034-W

C

sts

sts_last_active_file

sts

sts_file_name_1〜sts_file_name_7

指定された論理ファイルがsts_file_name_1〜sts_file_name_7に存在しない

−

689

STS-0018

KFCA00278-W

C

sts

sts_last_active_file

sts

sts_initial_error_switch

(sts_last_active_file指定があり)

&& (sts_initial_error_switch == stop)

−

690

STS-0019

KFCA00279-W

C

sts

sts_last_active_file

sts

sts_initial_error_switch

(sts_last_active_file指定あり)

&& (sts_initial_error_switch指定なし)

−

691

STS-0020

KFCA01033-W

W

sts

sts_last_active_side

−

−

sts_last_active_side指定あり

−

692

STS-0021

KFCA00278-W

C

sts

sts_last_active_side

sts

sts_single_operation_switch

(sts_last_active_side指定あり)

&& (sts_single_operation_switch != continue)

−

693

STS-0022

KFCA00279-W

C

sts

sts_last_active_side

sts

sts_single_operation_switch

(sts_last_active_side指定あり)

&& (sts_single_operation_switch指定なし)

−

694

STS-0023

KFCA00278-W

C

sts

sts_last_active_side

sts

sts_initial_error_switch

(sts_last_active_side指定あり)

&& (sts_initial_error_switch == stop)

−

695

STS-0024

KFCA00279-W

C

sts

sts_last_active_side

sts

sts_initial_error_switch

(sts_last_active_side指定あり)

&& (sts_initial_error_switch指定なし)

−

696

TAM-0001

KFCA00285-W

E

tam

tam_max_tblnum

−

−

tam_max_tblnum指定なし

−

697

TAM-0002

KFCA26208-W

E

tam

tam_max_tblnum

tam

tamtable

tam_max_tblnum ＜ tamtable数

−

698

TAM-0003

KFCA00285-W

E

−

tam_max_recsize

−

−

tam_max_recsize指定なし

−

699

TAM-0004

KFCA00285-W

E

−

tam_max_filesize

−

−

tam_max_filesize指定なし

−

700

TAM-0005

KFCA00264-W

C

tam

tam_max_trnnum

trn

trn_tran_process_count

tam_max_trnnum ＞ trn_tran_process_count

−

701

TAM-0006

KFCA00264-W

C

tam

tam_max_trnfilnum

tam

tam_max_tblnum

tam_max_tblnum ＜ tam_max_trnfilnum

−

702

TAM-0007

KFCA00286-W

E

tam

−

−

−

(TAMがセットアップされている) && (TAMサービス定義がない)

−

703

TAM-0008

KFCA00285-W

E

tam

tam_pool_attri

prc

prc_hugepage_group_id

(OS == Linux) && (OpenTP1 == 64ビット版) && (tam_pool_attri == hugepage) && (prc_hugepage_group_id指定なし)

OSがLinuxで，64ビット版のOpenTP1の場合だけチェック対象です。

tam_pool_attriにhugepageを指定している場合，prc:prc_hugepage_group_idの指定が必須です。

704

−

KFCA01719-E

−

tam

tam_max_recsize

システムジャーナルサービス定義

jnl_max_datasize

(tam_max_recsizeを4の整数倍に切り上げた値)×2＋96＜jnl_max_datasize

JNL#1

OSがLinux（IPF）の場合は8の整数倍に切り上げられます。

705

−

KFCA01734-E

−

tam

tamtable

−

−

テーブル名が重複している

−

706

−

KFCA01733-E

−

tam

tamtable

−

−

ファイル名が重複している

−

707

−

KFCA01740-E

−

tam

tamtable

−

−

定義ファイルで指定したTAMファイルはスペシャルファイル名ではない

−

708

−

KFCA01741-E

−

tam

tamtable

−

−

定義ファイルで指定したTAMファイルを割り当てるディスクパーティションはOpenTP1ファイルシステムとして初期化されていない

−

709

−

KFCA01742-E

−

tam

tamtable

−

−

定義ファイルで指定したファイルが存在しない

−

710

−

KFCA01743-E

−

tam

tamtable

−

−

定義ファイルで指定したTAMファイルはほかのプロセスで使用中であるため，使用できない

−

711

−

KFCA01747-E

−

tam

tamtable

−

−

定義ファイルで指定したTAMファイルのキャラクタ型スペシャルファイルのオープンでシステムによって上限値オーバのエラーが報告された

−

712

−

KFCA01744-E

−

tam

tamtable

−

−

定義ファイルで指定したTAMファイルのスペシャルファイルに対するアクセス権がない

−

713

−

KFCA01745-E

−

tam

tamtable

−

−

定義ファイルで指定したTAMファイルに対するアクセス権がない

−

714

−

KFCA01701-E

−

tam

tamtable

−

−

メモリ不足で処理を続行できない

−

715

−

KFCA01736-E

−

tam

tamtable

−

−

定義ファイルに指定されたTAMファイルで入出力エラーが発生

−

716

−

KFCA01746-E

−

tam

tamtable

−

−

定義ファイルで指定したTAMファイルでファイルシステム作成時のシステムと実行時のシステムのバージョンが異なっている

−

717

−

KFCA01786-E

−

tam

tamtable

−

−

TAMファイルサイズ ＞ 1000000000

−

718

−

KFCA01787-E

−

tam

tamtable

−

−

tamcreコマンドで作成されたTAMファイルではない

−

719

−

KFCA01764-E

−

tam

tamtable

−

−

現在使用中のTAMとは互換性のないTAMファイルを使用している

−

720

−

KFCA01786-E

−

tam

tamtable

tam

tam_max_filesize

TAMファイルサイズ ＞ tam_max_filesize

−

721

−

KFCA02883-E

−

tam

tamtable

tam

tam_max_recsize

TAMファイルのレコードサイズ ＞ tam_max_recsize

−

722

TIM-0001

KFCA00265-W

C

tim

tim_watch_count

−

−

tim_watch_count指定あり

−

723

TRN-0001

KFCA00285-W

E

trn

trn_tran_process_count

−

−

trn_tran_process_count指定なし

−

724

TRN-0002

KFCA00265-W

C

trn

trn_tran_process_count

trn

trn_recovery_process_count

trn_tran_process_count指定あり

−

725

TRN-0003

KFCA00262-W

C

trn

trn_recovery_process_count

trn

trn_tran_process_count

trn_recovery_process_count指定値 ＞ trn_tran_process_count指定値

−

726

TRN-0004

KFCA00262-W

E

trn

trn_recovery_process_count

prc

prc_process_count

trn_recovery_process_count指定値 ＞ prc_process_count指定値

−

727

TRN-0005

KFCA32523-W

C

trn

ユーザサービス定義

trn_expiration_time

trn

trn_completion_limit_time

(trn_expiration_time ＞ 0)

&& (trn_completion_limit_time > 0)

&& (trn_expiration_time指定値 ＞ trn_completion_limit_time指定値)

−

728

TRN-0006

KFCA00282-W

C

trn

ユーザサービス定義

trn_statistics_item

−

−

trn_statistics_itemにcputime指定あり

OSがWindowsの場合，チェック対象の定義はサポートしていません。

729

TRN-0007

KFCA00278-W

C

trn

ユーザサービス定義

trn_expiration_time_suspend

trn

trn_expiration_time

(trn_expiration_time_suspend指定あり)

&& (trn_expiration_time == 0)

−

730

TRN-0008

KFCA00279-W

C

trn

ユーザサービス定義

trn_expiration_time_suspend

trn

trn_expiration_time

(trn_expiration_time_suspend指定あり)

&& (trn_expiration_time指定なし)

−

731

TRN-0009

KFCA00272-W

C

trn

trn_tran_recovery_list

−

−

trn_tran_recovery_list != Y

−

732

TRN-0010

KFCA00282-W

C

trn

ユーザサービス定義

trn_cpu_time

−

−

trn_cpu_time指定あり（ただし0を指定した場合だけ）

OSがWindowsの場合，チェック対象の定義はサポートしていません。

733

TRN-0011

KFCA00265-W

C

trn

trn_max_subordinate_count

−

−

trn_max_subordinate_count指定あり

−

734

TRN-0012

KFCA00272-W

C

trn

ユーザサービス定義

trn_rm_open_close_scope

−

−

trn_rm_open_close_scope != process

−

735

TRN-0013

KFCA00272-W

C

trn

ユーザサービス定義

trn_optimum_item

−

−

trn_optimum_itemにbase指定なし

−

736

TRN-0014

KFCA00272-W

C

trn

trn_processing_in_rm_error

−

−

(trn_processing_in_rm_error != down)

&& (trn_processing_in_rm_error != retry)

−

737

TRN-0015

KFCA00278-W

C

trn

trn_recovery_list_remove

trn

trn_tran_recovery_list

(trn_recovery_list_remove指定あり)

&& (trn_tran_recovery_list == N)

−

738

TRN-0016

KFCA00279-W

C

trn

trn_recovery_list_remove

trn

trn_tran_recovery_list

(trn_recovery_list_remove指定あり)

&& (trn_tran_recovery_list指定なし)

−

739

TRN-0017

KFCA00272-W

C

trn

trn_recovery_list_remove

trn

trn_tran_recovery_list

(trn_tran_recovery_list == Y) &&

((trn_recovery_list_remove == no)

|| (trn_recovery_list_remove指定なし))

−

740

TRN-0018

KFCA00278-W

C

trn

trn_recovery_list_remove_level

trn

trn_tran_recovery_list

(trn_recovery_list_remove_level指定あり)

&& (trn_tran_recovery_list == N)

−

741

TRN-0019

KFCA00279-W

C

trn

trn_recovery_list_remove_level

trn

trn_tran_recovery_list

(trn_recovery_list_remove_level指定あり)

&& (trn_tran_recovery_list指定なし)

−

742

TRN-0020

KFCA00282-W

C

trn

trn_crm_use

−

−

trn_crm_use指定あり

−

743

TRN-0021

KFCA00282-W

C

trn

trn_max_crm_subordinate_count

−

−

trn_max_crm_subordinate_count指定あり

−

744

TRN-0022

KFCA00262-W

C

trn

ユーザサービス定義

trn_watch_time

trn

trn_limit_time

(trn_limit_time != 0) &&

(trn_watch_time指定値 ＞ trn_limit_time指定値)

TRN#1

すべての定義でtrn_watch_timeを省略した場合はwatch_timeの指定値を採用します。watch_timeに0を指定した場合はtrn_watch_timeのデフォルト値として120を採用します。

745

TRN-0023

KFCA00262-W

C

trn

ユーザサービス定義

trn_watch_time

trn

trn_completion_limit_time

(trn_completion_limit_time != 0) &&

((trn_watch_time指定値 ＞ trn_completion_limit_time指定値))

TRN#1

すべての定義でtrn_watch_timeを省略した場合はwatch_timeの指定値を採用します。watch_timeに0を指定した場合はtrn_watch_timeのデフォルト値として120を採用します。

746

TRN-0024

KFCA00272-W

C

trn

ユーザサービス定義

trn_rollback_information_put

−

−

trn_rollback_information_put != all

|| trn_rollback_information_put指定なし

−

747

TRN-0025

KFCA00272-W

C

trn

trn_recovery_failmsg_interval

−

−

trn_recovery_failmsg_interval == 0

−

748

TRN-0026

KFCA00278-W

C

trn

trn_retry_interval_rm_open

trn

trn_wait_rm_open

(trn_retry_interval_rm_open指定あり)

&& (trn_wait_rm_open != retry_continue)

&& (trn_wait_rm_open != retry_stop)

−

749

TRN-0027

KFCA00278-W

C

trn

trn_retry_count_rm_open

trn

trn_wait_rm_open

(trn_retry_count_rm_open指定あり)

&& (trn_wait_rm_open != retry_continue)

&& (trn_wait_rm_open != retry_stop)

−

750

TRN-0028

KFCA32521-W

C

trn

thread_stack_size

−

−

thread_stack_size指定あり

−

751

TRN-0029

KFCA00279-W

C

trn

trn_start_recovery_mode

trn

trnstring

(trn_start_recovery_mode指定あり)

&& (trnstring指定なし)

−

752

TRN-0030

KFCA00279-W

C

trn

trn_start_recovery_mode

trn

trnstring

(trn_start_recovery_mode指定あり)

&& (trnstringの-mオプション指定なし)

−

753

TRN-0031

KFCA00279-W

C

trn

trn_start_recovery_watch_time

trn

trnstring

(trn_start_recovery_watch_time指定あり)

&& (trnstring指定なし)

−

754

TRN-0032

KFCA00279-W

C

trn

trn_start_recovery_watch_time

trn

trnstring

(trn_start_recovery_watch_time指定あり)

&& (trnstringの-mオプション指定なし)

−

755

TRN-0033

KFCA00279-W

C

trn

trn_start_recovery_interval

trn

trnstring

(trn_start_recovery_interval指定あり)

&& (trnstring指定なし)

−

756

TRN-0034

KFCA00279-W

C

trn

trn_start_recovery_interval

trn

trnstring

(trn_start_recovery_interval指定あり)

&& (trnstringの-mオプション指定なし)

−

757

TRN-0035

KFCA00278-W

C

trn

trn_start_recovery_interval

trn

trn_start_recovery_watch_time

(trn_start_recovery_interval指定あり)

&& (trnstringの-mオプション指定あり)

&& (trn_start_recovery_watch_time == 0)

−

758

TRN-0036

KFCA00272-W

C

trn

trn_xa_commit_error

−

−

trn_xa_commit_error != down

−

759

TRN-0037

KFCA00272-W

C

trn

trn_prf_event_trace_level

−

−

(trn_prf_event_trace_level & 00000007) != 00000007

−

760

TRN-0038

KFCA00272-W

C

trn

trn_prf_event_trace_condition

−

−

xafunc指定なし

−

761

TRN-0039

KFCA00259-W

C

trn

trnstring

trn

trnstring

ほかのtrnstringの-nオプション，または-nオプションと-iオプションを同時に指定したリソースマネジャ名と重複

−

762

TRN-0040

KFCA32524-W

E

ユーザサービス定義

trnrmid

trn

trnstring

trnrmidの-nオプションと-iオプションの組み合わせがtrnstringに指定されていない

−

763

TRN-0041

KFCA32522-W

C

_tr

prf_file_size

−

−

prf_file_size ＜ デフォルト値（10240）

−

764

TRN-0043

KFCA00286-W

E

trn

全体

−

−

トランザクションサービス定義ファイル（trn）が存在しない

−

765

TRN-0044

KFCA00261-W

C

trn

ユーザサービス定義

trn_expiration_time

trn

ユーザサービス定義

trn_cpu_time

(trn_expiration_time ＞ 0)

&& (trn_cpu_time ＞ 0)

&& (trn_expiration_time ＜ trn_cpu_time)

OSがWindowsの場合はチェックしません。

766

TRN-0045

KFCA00262-W

C

trn

ユーザサービス定義

trn_cpu_time

trn

ユーザサービス定義

trn_completion_limit_time

(trn_cpu_time ＞ 0)

&& (trn_completion_limit_time ＞ 0)

&& (trn_cpu_time ＞ trn_completion_limit_time)

OSがWindowsの場合はチェックしません。

767

TRN-0046

KFCA00278-W

C

trn

trn_max_crm_subordinate_count

trn

trn_crm_use

(trn_max_crm_subordinate_count指定あり)

&& (trn_crm_use == N)

OSがWindowsの場合はチェックしません。

768

TRN-0047

KFCA00279-W

C

trn

trn_max_crm_subordinate_count

trn

trn_crm_use

(trn_max_crm_subordinate_count指定あり)

&& (trn_crm_use省略)

OSがWindowsの場合はチェックしません。

769

TRN-0048

KFCA00265-W

C

trn

trn_max_crm_subordinate_count

trn

trn_crm_use

trn_max_crm_subordinate_count指定あり

&& (trn_crm_use == Y)

OSがWindowsの場合はチェックしません。

770

UTL-0001

KFCA00271-W

W

betranrc

usrrc

ユーザサービス定義

rpc_trace

−

−

rpc_trace == Y

−

771

UTL-0002

KFCA00268-W

W

betranrc

usrrc

ユーザサービス定義

rpc_trace_name

−

−

(rpc_trace_name指定あり) &&

(rpc_trace_nameに指定したRPCトレースファイルがファイルではない)

UTL#1

UTL#2

772

UTL-0003

KFCA00268-W

W

betranrc

usrrc

ユーザサービス定義

rpc_trace_name

−

−

(rpc_trace_name指定あり) &&

(rpc_trace_nameに指定したRPCトレースファイルに書き込み権限がない)

UTL#1

UTL#2

773

UTL-0004

KFCA00268-W

W

betranrc

usrrc

ユーザサービス定義

rpc_trace_name

−

−

(OS == Windows) && ((rpc_trace_name指定あり) && (rpc_trace_name指定値 ＞ 259))

||

(OS != Windows) && ((rpc_trace_name指定あり) && (rpc_trace_name指定値 ＞ 1023))

UTL#1

UTL#3

774

UTL-0005

KFCA00267-W

W

betranrc

usrrc

ユーザサービス定義

rpc_trace_name

−

−

(rpc_trace_name指定あり) &&

(RPCトレースファイルの出力先ディレクトリが存在しない)

UTL#1

775

UTL-0006

KFCA00267-W

W

betranrc

usrrc

ユーザサービス定義

rpc_trace_name

−

−

(rpc_trace_name指定あり) &&

(RPCトレースファイルの出力先ディレクトリがディレクトリではない)

UTL#1

776

UTL-0007

KFCA00267-W

W

betranrc

usrrc

ユーザサービス定義

rpc_trace_name

−

−

(rpc_trace_name指定あり) &&

((RPCトレースファイルの出力先ディレクトリの書き込み権限がない)

||

(RPCトレースファイルの出力先ディレクトリの実行権限がない))

UTL#1

777

UTL-0008

KFCA00287-W

W

betranrc

usrrc

ユーザサービス定義

rpc_trace_name

−

−

(rpc_trace_name指定あり) &&

(rpc_tarce_name指定値のファイル名長 ＞ 13byte)

メッセージに出力するrpc_trace_nameに指定したファイル名長が長い場合，371バイト以降は省略されます。

778

UTL-0009

KFCA00276-W

C

betranrc

usrrc

ユーザサービス定義

rpc_trace_name

ユーザサービス定義

rpc_trace

(rpc_trace != Y) && (rpc_trace_name指定あり)

UTL#4

メッセージに出力するrpc_trace_nameに指定したファイルパス名長が長い場合，346バイト以降は省略されます。

779

UTL-0010

KFCA00276-W

C

betranrc

usrrc

ユーザサービス定義

rpc_trace_size

ユーザサービス定義

rpc_trace

(rpc_trace != Y) && (rpc_trace_size指定あり)

UTL#4

780

UTL-0011

KFCA00272-W

W

Usrrc

ユーザサービス定義

uap_trace_max

−

−

(uap_trace_max ＜ 32)

−

781

UTL-0012

KFCA00288-W

W

betranrc

usrrc

ユーザサービス定義

rpc_trace_name

−

−

(rpc_trace_name指定値内に'$'がある)

&& (先頭ではない位置に'$'が指定されている)

−

782

XAR-0001

KFCA00271-W

W

Xar

xar_eventtrace_level

−

−

xar_eventtrace_level != ERR

−

783

XAR-0002

KFCA32164-W

W

Xar

xarfile

xar

xar_msdtc_use

(xar_msdtc_use == Y)

&& (XARファイルのレコード長 ＜ 1024)

−

784

XAR-0003

KFCA00286-W

E

Xar

−

trn

trn_xar_use

(trn_xar_use == Y)

&& (XAリソースサービス定義がない)

−

785

XAR-0004

KFCA32172-W

E

−

−

trn

betranrc

trn_xar_use

jnl_fileless_option

( trn_xar_use == Y ) && ( jnl_fileless_option == Y )

−

786

XAR-0005

KFCA00272-W

C

Xar

xar_prf_trace_level

−

−

(xar_prf_trace_level & 00000003) != 00000003

−

787

XAR-0006

KFCA32163-W

C

_xr

prf_file_size

−

−

prf_file_size ＜ デフォルト値（10240）

−

788

−

KFCA32019-E

−

Xar

xarfile

−

−

xarfile -t online -a XARファイル，xarfile -t backup -a XARファイルの組み合わせで指定していない

−

789

−

KFCA32025-E

−

Xar

xarfile

−

−

XARファイルパス名が正しくない

−

790

−

KFCA32026-E

−

Xar

xarfile

−

−

OpenTP1ファイルシステムへのアクセス権がない

−

791

−

KFCA32027-E

−

Xar

xarfile

−

−

オープンファイル数がシステムの上限値を超過

−

792

−

KFCA32028-E

−

Xar

xarfile

−

−

XARファイルに対してI/Oエラーが発生

−

793

−

KFCA32029-E

−

Xar

xarfile

−

−

メモリ不足が発生

−

794

−

KFCA32030-E

−

Xar

xarfile

−

−

XARファイルのバージョンが正しくない

−

795

−

KFCA32031-E

−

Xar

xarfile

−

−

OpenTP1ファイルシステムのある装置が未初期化

−

796

−

KFCA32032-E

−

Xar

xarfile

−

−

XARファイル名が正しくない

−

797

−

KFCA32036-E

−

Xar

xarfile

−

−

XARファイルが存在しない

−

798

−

KFCA32038-E

−

Xar

xarfile

−

−

XARファイルに対するアクセス権がない

−

799

−

KFCA32111-E

−

Xar

xarfile

−

−

定義に指定したファイルがXARファイルではない

−

800

−

KFCA32044-E

−

Xar

xarfile

−

−

定義で指定したXARファイルのバージョンが不正

−

801

−

KFCA32021-E

KFCA32024-E

−

Xar

xarfile

trn

trn_tran_process_count

XARファイルのレコード数

＜ trn_tran_process_count

−

802

−

KFCA32014-W

−

Xar

xarfile

−

−

定義で指定したXARファイルをクローズできない

−

803

−

KFCA32022-E

KFCA32024-E

−

Xar

xarfile

−

−

オンライン系XARファイルのレコード数 != バックアップ系XARファイルのレコード数

−

804

−

KFCA32023-E

KFCA32024-E

−

Xar

xarfile

−

−

オンライン系XARファイルのレコード長 != バックアップ系XARファイルのレコード長

−

805

−

KFCA32048-E

−

Xar

xarfile

−

−

オンライン系XARファイル名 == バックアップ系XARファイル名

−

（凡例）

−：該当しません。

↑↑：小数点以下を切り上げます。

ADM#1：絶対パスで指定された場合だけチェックします。

ADM#2：OSがWindowsの場合で，拡張子が指定されていないときは，"*.bat"，"*.exe"，"*.com"の三つの拡張子を自動的に付与してチェックします。

ADM#3：ファイルそのものが実行可能なファイルであるかどうかのチェックを試みます。

CPD#1：システム共通定義のjnl_fileless_optionオペランドにYを指定した場合はチェックしません。

JNL#1：システム共通定義のjnl_fileless_optionオペランドにYを指定した場合はチェックしません。

PRC#1：OSがWindowsの場合はドライブ文字を含めて'¥'であるかどうかをチェックします。

PRC#2：OSがWindowsの場合は';'でチェックします。

PRC#3：OSがWindowsの場合は$DCDIR/binはチェックしません。

PRC#4：OSがWindowsの場合は指定された名称に".exe"の拡張子を付与してチェックします。また，prcsvpathの指定に関係なく自動的に$DCDIR/binに関してもチェックします。

RPC#1：指定可能な定義ファイルがすべて省略されている場合は，出力メッセージの「定義ファイル名」に"********"が出力されることがあります。

RTS#1：rts_log_file_nameの指定値に1からrts_log_file_countの指定値までの値を付与したファイルパス名でチェックします。

RTS#2：RTSログファイルのパス名に".bk"の拡張子を付与したファイルパス名でチェックします。

SCD#1：指定可能な定義ファイルがすべて省略されている場合は，出力メッセージの「定義ファイル名」に"********"が出力されることがあります。

SCD#2：KFCA00265-Wメッセージが出力された場合は，MHPとして起動するすべてのユーザサービス定義を見直してください。

TRN#1：指定可能な定義ファイルがすべて省略されている場合は，出力メッセージの「定義ファイル名」に"********"が出力されることがあります。

UTL#1：絶対パスで指定された場合だけチェックします。

UTL#2：rpc_trace_nameで指定したファイルパス名称に1，2およびlを付与してチェックします。

UTL#3：rpc_trace_nameの指定値の長さをチェックします。

UTL#4：指定可能な定義ファイルがすべて省略されている場合は，出力メッセージの「定義ファイル名」に"********"が出力されることがあります。

SCS#1：指定可能な定義ファイルがすべて省略されている場合は，出力メッセージの「定義ファイル名」に"********"が出力されることがあります。

注

出力メッセージの「定義ファイル名」に"********"が出力された場合は，チェック対象の定義が指定できるすべての定義ファイルを見直してください。

付録E　旧製品からの移行に関する注意事項

ここでは，バージョン5以前からバージョン7に移行する場合の注意事項について説明します。

付録E.1　バージョン5以前からの移行

バージョン5以前からバージョン7に移行する場合の注意事項について説明します。

バージョン5以前とバージョン7では，オペランドのデフォルト値が変更されています。オペランドのデフォルト値の変更点を，次の表に示します。

表E‒1　オペランドのデフォルト値の変更点

定義名／

定義コマンド名

オプション

オペランド名／

コマンド引数

バージョン5以前のデフォルト値

バージョン7のデフォルト値

システム共通定義

−

thdlock_sleep_time

300（単位：ミリ秒）

15（単位：ミリ秒）

ロックサービス定義

−

lck_release_detect

interval

pipe

mcfttim

-t

btim

5（単位：秒）

1（単位：秒）

mcfttrc

-t

size

20480（単位：バイト）

204800（単位：バイト）

システムサービス共通情報定義

−

max_open_fds

100

500

−

thdlock_sleep_time

300（単位：ミリ秒）

15（単位：ミリ秒）

（凡例）

−：該当しません。

また，バージョン5以前とバージョン7では，オペランドと指定値の対応に変更があります。対応するオペランドの変更点を，次の表に示します。

表E‒2　オペランドと指定値の対応の変更点

定義名／

定義コマンド名

オペランド名／

コマンド引数

バージョン7の指定値

バージョン5以前の指定値

トランザクションサービス定義

trn_optimum_item

asyncprepare

rpc_prepare_in_advanceオペランドにYを指定

base

rpc_prepare_in_advanceオペランドにNを指定

バージョン5以前からバージョン7に移行する場合は，バージョン6からバージョン7での変更点についても注意する必要があります。

バージョン6からバージョン7での変更点については，マニュアル「OpenTP1 解説」のバージョンアップ時の変更点について説明している個所を参照してください。

索引

数字

1プロセスが処理するサービス要求数[1]、[2]、[3]

A

abort[1]

adm_message_option[1]、[2]

all_node[1]

all_node_ex[1]

all_node_ex_extend_number[1]

all_node_extend_number[1]

APIの代理実行要求時，rapサーバとのコネクションの切断を検知した場合に，エラーメッセージを出力[1]

aplihold[1]

assurance_count[1]

atomic_update[1]、[2]

auto_restart[1]、[2]

A系ステータスファイル名[1]

B

balance_count[1]、[2]、[3]

btim[1]

bufcnt[1]

B系ステータスファイル名[1]

C

cancel_normal_terminate[1]、[2]

client_uid_check[1]

clt_conf[1]

clt_cup_conf[1]

clt_inquire_time[1]

clt_port[1]

clt_trn_conf[1]

cltcon_port[1]

clttrn_port[1]

cname[1]

COBOL APIの排他レベル[1]

commitdml[1]

core_shm_suppress[1]、[2]

core_suppress_watch_time[1]

count[1]

cpd_message_id_change_level[1]

critical[1]、[2]

CRM[1]

CRMを使用[1]

cup_balance_count[1]

cup_parallel_count[1]

CUP実行プロセスのポート番号[1]

CUP実行プロセスを起動[1]

D

dam_added_file[1]

dam_cache_attribute[1]

dam_cache_reuse_from[1]

dam_cache_size[1]

dam_cache_size_fix[1]

dam_conf[1]

dam_default_cache_num[1]

dam_ex_refer_read[1]

dam_io_error_occur[1]

dam_io_interval[1]

dam_kb_size[1]

dam_max_block_size[1]

dam_message_level[1]

dam_tran_process_count[1]

dam_transaction_access[1]

dam_update_block[1]

dam_update_block_over[1]

damcache[1]

damchlmt[1]

damfile[1]

DAMキャッシュブロックの確保回数イベントを取得[1]

DAMキャッシュ用の共用メモリの使用率イベントを取得[1]

DAMサービスが出力するメッセージのレベル[1]

DAMサービス定義[1]

DAMサービスの最大同時排他要求数[1]

DAMサービスの処置[1]

DAMサービスを使用[1]

DAM情報のreadイベントを取得[1]

DAM情報のreadエラーイベントを取得[1]

DAM情報のwriteイベントを取得[1]

DAM情報のwriteエラーイベントを取得[1]

dc_deter_restart_on_stop_fail[1]

DCADMDEBUG[1]

dcbindht[1]

DCCONFPATH[1]、[2]

DCFPL_CONNECT_RETRY_COUNT[1]

DCFPL_CONNECT_RETRY_INTERVAL[1]

DCLOGDEFPID[1]

dcmarea[1]

DCMCFQUEBAK[1]

dcmstart_watch_time[1]

dcmstart打ち切り時間[1]

dcmstop_watch_time[1]

dcmstop打ち切り時間[1]

dcprcport[1]

dcputenv形式[1]

dcresetコマンド[1]

dcsetupコマンド[1]

dcsetup -dコマンド[1]

dcstart_wakeup_retry_count[1]

dcstart_wakeup_retry_interval[1]

dcstop -f（-fd）コマンドによる強制停止処理中に異常終了したとき，系切り替えを抑止するかどうか[1]

dcsvgdef[1]

dcsvstart[1]、[2]

dcsvstopコマンドでの正常終了を抑止[1]

DCSYSLOGOUT[1]

DCUAPCONFPATH[1]、[2]

deadlock_priority[1]、[2]

default_value_option[1]

delaytim[1]

disk[1]

diskitq[1]

dmsgcnt[1]

domain_masters_addr[1]

domain_masters_port[1]

domain_use_dns[1]

dynamic_shmpool_size[1]

E

ENOBUFS，ENOMEM発生時のリトライ回数[1]

ENOBUFS，ENOMEM発生時のリトライ間隔[1]

errevt[1]

errevt_recovery[1]

ERREVT1[1]

ERREVT2[1]

ERREVT3[1]

ERREVT4[1]

ERREVTA[1]

evtlogout[1]

expectcnt[1]

extend[1]

F

fil_prf_trace_delay_time[1]

fil_prf_trace_option[1]

FILイベントトレース取得条件となるファイルアクセス処理時間のしきい値[1]

FJ出力回数イベントを取得[1]

G

gj[1]

groupno[1]

groups[1]、[2]、[3]

H

ha_conf[1]

ha_switch_error_retry_count[1]

ha_switch_error_retry_interval[1]

hold[1]、[2]

hold_recovery[1]、[2]

holdlimit[1]

holdlmtyp[1]

I

ij[1]

initseq[1]

ipc_backlog_count[1]、[2]、[3]

ipc_conn_interval[1]、[2]、[3]

ipc_header_recv_time[1]、[2]、[3]

ipc_listen_sockbufset[1]、[2]、[3]

ipc_notify_response_host[1]

ipc_recvbuf_size[1]、[2]、[3]

ipc_response_host[1]

ipc_send_count[1]、[2]、[3]

ipc_send_interval[1]、[2]、[3]

ipc_sendbuf_size[1]、[2]、[3]

ipc_sockctl_highwater[1]、[2]、[3]、[4]

ipc_sockctl_watchtime[1]、[2]、[3]、[4]

ipc_tcpnodelay[1]、[2]、[3]

ist_conf[1]

ist_node[1]

ist_node_group[1]

istdef[1]

ISTサービス定義[1]

ISTサービスのテーブル名の定義[1]

ISTサービスを使用[1]

itqretryorder[1]

J

jar_conf[1]

jnl_arc_buff_size[1]

jnl_arc_check_level[1]

jnl_arc_ipc_buff_size[1]、[2]

jnl_arc_max_datasize[1]、[2]

jnl_arc_name[1]

jnl_arc_rec_kind[1]

jnl_arc_terminate_check[1]

jnl_arc_terminate_timeout[1]、[2]

jnl_arc_trn_stat[1]

jnl_arc_uj_code[1]

jnl_auto_unload[1]

jnl_auto_unload_continue[1]

jnl_auto_unload_path[1]

jnl_cdinterval[1]

jnl_cdskip_limit[1]

jnl_cdskip_msg[1]

jnl_dual[1]、[2]、[3]

jnl_fileless_option[1]

jnl_max_datasize[1]、[2]

jnl_max_file_dispersion[1]、[2]

jnl_message_id_change_level[1]、[2]

jnl_min_file_dispersion[1]、[2]

jnl_objservername[1]

jnl_prf_event_trace_level[1]

jnl_reduced_mode[1]

jnl_rerun_reserved_file_open[1]

jnl_rerun_swap[1]、[2]

jnl_reserved_file_auto_open[1]

jnl_singleoperation[1]、[2]、[3]

jnl_tran_optimum_level[1]

jnl_unload_check[1]、[2]

jnl_watch_time[1]、[2]

jnladdfg[1]、[2]、[3]

jnladdpf[1]、[2]、[3]

jnldfsv[1]、[2]

JNL性能検証用トレース関連のメッセージの表示レベル[1]

JNL性能検証用トレース情報ファイルの世代数[1]

JNL性能検証用トレース情報ファイルのバックアップを取得[1]

JNL性能検証用トレース定義[1]

JNL性能検証用トレースの取得レベル[1]

jp1_use[1]

JP1イベントサービスへの登録機能[1]

K

KFCA00356-Wメッセージを出力するバンドル回数[1]

KFCA00853-Eメッセージ出力インタバル時間[1]、[2]

KFCA00853-Eメッセージ出力判断値[1]、[2]

kind[1]

L

LANG[1]

LANG設定値[1]

lck_deadlock_info[1]

lck_deadlock_info_remove[1]

lck_deadlock_info_remove_level[1]

lck_limit_fordam[1]

lck_limit_formqa[1]

lck_limit_fortam[1]

lck_limit_foruser[1]

lck_prf_trace_level[1]

lck_release_detect[1]

lck_release_detect_interval[1]

lck_wait_priority[1]、[2]

lck_wait_timeout[1]

LCK性能検証用トレース関連のメッセージの表示レベル[1]

LCK性能検証用トレース情報の取得レベル[1]

LCK性能検証用トレース情報ファイルのサイズ[1]

LCK性能検証用トレース情報ファイルの世代数[1]

LCK性能検証用トレース定義[1]

length[1]

leveldown_queue_count[1]、[2]

levelup_queue_count[1]、[2]

lname[1]

loadcheck_interval[1]、[2]

loadlevel_message[1]、[2]

log_audit_count[1]

log_audit_message[1]、[2]、[3]、[4]、[5]

log_audit_out[1]

log_audit_out_suppress[1]、[2]、[3]、[4]

log_audit_path[1]

log_audit_size[1]

log_filesize[1]

log_jerr_rint[1]

log_jp1_allno[1]

log_jp1_date[1]

log_jp1_hostname[1]

log_jp1_pgmid[1]

log_jp1_prcid[1]

log_jp1_prcno[1]

log_jp1_sysid[1]

log_jp1_time[1]

log_msg_allno[1]

log_msg_console[1]

log_msg_date[1]

log_msg_hostname[1]

log_msg_pgmid[1]

log_msg_prcid[1]

log_msg_prcno[1]

log_msg_sysid[1]

log_msg_time[1]

log_notify_allno[1]

log_notify_date[1]

log_notify_hostname[1]

log_notify_out[1]

log_notify_pgmid[1]

log_notify_prcid[1]

log_notify_prcno[1]

log_notify_sysid[1]

log_notify_time[1]

log_syslog_allno[1]

log_syslog_append_nodeid[1]

log_syslog_date[1]

log_syslog_elist[1]

log_syslog_elist_rint[1]

log_syslog_hostname[1]

log_syslog_out[1]

log_syslog_pgmid[1]

log_syslog_prcid[1]

log_syslog_prcno[1]

log_syslog_synchro[1]

log_syslog_sysid[1]

log_syslog_time[1]

M

make_queue_on_starting[1]、[2]

max_open_fds[1]、[2]、[3]、[4]、[5]

max_socket_descriptors[1]、[2]、[3]、[4]、[5]、[6]、[7]、[8]、[9]、[10]、[11]、[12]

max_socket_msg[1]、[2]

max_socket_msglen[1]、[2]

maxseq[1]

MCF[1]

mcf_jnl_buff_size[1]、[2]

mcf_mgrid[1]、[2]

mcf_prf_trace[1]、[2]、[3]

mcf_prf_trace_level[1]

mcf_psv_id[1]、[2]

mcf_service_max_count[1]、[2]

mcf_spp_oj[1]、[2]

mcf_start_watch_interval[1]

mcfaalcap[1]

mcfaenv[1]

mcfapli[1]

mcfaplir[1]

mcfapliコマンド[1]

mcfcomn[1]

mcfcomnr[1]

mcflink[1]

mcflinkコマンド[1]

mcfmcname[1]

mcfmcomn[1]

mcfmenv[1]

mcfmexp[1]

mcfmngr[1]

mcfmngrr[1]

mcfmngrコマンド[1]

mcfmqgid[1]

mcfmsmsg[1]

mcfmsts[1]

mcfmsvg[1]

mcfmuap[1]

mcfpsvr[1]

mcfpsvrr[1]

mcfsvname[1]

mcftalcle[1]

mcftbuf[1]

mcftcomn[1]

mcftenv[1]

mcftped[1]

mcftpsvr[1]

mcftsts[1]

mcfttim[1]

mcfttrc[1]

mcfttred[1]

MCFアプリケーション定義[1]、[2]、[3]

MCFアプリケーション定義オブジェクトファイル名[1]

MCFアプリケーション定義コマンドの指定順序[1]

MCFアプリケーション定義識別子[1]

MCFイベント名[1]

MCFオンラインコマンドサービス名[1]

MCF開始時プロセス間監視時間間隔[1]

MCF稼働統計情報を取得[1]

MCF環境定義[1]

MCF構成変更準備停止時のバックアップファイル名[1]

MCFサービスと定義との関係[1]

MCFサービス用の共用メモリの見積もり式[1]

MCF作業領域長[1]

MCF実行形式プログラム名[1]

MCF性能検証用トレース情報の取得レベル[1]

MCF性能検証用トレース定義[1]

MCF通信関数発行回数上限値[1]、[2]

MCF通信構成共通定義[1]

MCF通信構成定義[1]、[2]

MCF通信構成定義のファイル構成[1]

MCF通信サービス名[1]

MCF通信プロセス[1]

MCF通信プロセス識別子[1]

MCF通信プロセスでアクセスするファイルの最大数[1]

MCF通信プロセスまたはアプリケーション起動プロセスのジャーナルバッファの大きさ[1]

MCF定義オブジェクト解析コマンド[1]

MCF定義オブジェクト生成ユティリティ[1]

MCF定義オブジェクト生成ユティリティ起動コマンド[1]

MCF定義結合ユティリティ[1]

MCF定義結合ユティリティ起動コマンド[1]

MCFの運用形態と定義との関係[1]

MCFのジャーナルバッファの大きさ[1]、[2]

MCFマネジャ環境定義[1]

MCFマネジャ共通定義[1]

MCFマネジャ定義[1]、[2]

MCFマネジャ定義コマンドの指定順序[1]

MCFマネジャプロセス[1]

MCFマネジャプロセス識別子[1]、[2]

MCFマネジャプロセスのジャーナルバッファの大きさ[1]

MCFマネジャ名[1]

mcf××××[1]、[2]

message_buflen[1]、[2]

message_cell_size[1]、[2]

message_store_buflen[1]、[2]、[3]

MHPに期待するサービス要求の処理数[1]

minseq[1]

mmsgcnt[1]

mode_conf[1]

modelname[1]

module[1]、[2]

mqa_conf[1]

MQAサービスの最大同時排他要求数[1]

MQAサービスを使用[1]

MQT通信構成定義[1]

MSDTC連携機能を使用[1]

msgcnt[1]

msgout[1]

msgsize[1]、[2]

mtim[1]

multi_node_option[1]

multi_schedule[1]、[2]

my_host[1]

N

nam_prf_trace_level[1]

name[1]

name_audit_conf[1]

name_audit_interval[1]

name_audit_watch_time[1]

name_cache_size[1]

name_cache_validity_time[1]

name_domain_file_use[1]

name_global_lookup[1]

name_manager_node[1]

name_node_add_policy[1]

name_nodeid_check_message[1]

name_notify[1]

name_port[1]

name_remove_down_node[1]

name_rpc_control_list[1]

name_service_extend[1]

name_service_mode[1]

name_start_error[1]

name_start_retry_count[1]

name_start_retry_interval[1]

name_start_watch_time[1]

name_sync_ready_time[1]

name_total_size[1]

namnlfil[1]

NAMイベントトレースの取得レベル[1]

nice[1]、[2]、[3]

noansreply[1]

node_down_restart[1]、[2]

node_id[1]

ntmetim[1]、[2]

O

oj[1]

open_rm[1]

OpenTP1監視機能の無応答監視時間[1]

OpenTP1監視機能の無応答監視時間満了時の動作[1]

OpenTP1管理者のユーザ識別子[1]、[2]

OpenTP1起動時および再開始（リラン）時に有効にするドメイン構成を指定[1]

OpenTP1起動時のノードリスト要求応答待ち時間[1]

OpenTP1起動時のノードリスト要求リトライ回数[1]

OpenTP1起動時のノードリスト要求リトライ間隔[1]

OpenTP1起動通知エラーリトライ回数[1]

OpenTP1起動通知エラーリトライ間隔[1]

OpenTP1識別子[1]

OpenTP1識別子を付ける[1]、[2]、[3]、[4]

OpenTP1システムごとに異なる必要がある定義内容[1]

OpenTP1システム定義の構成[1]

OpenTP1システム定義の体系[1]

OpenTP1システム内で稼働するマネジャノードのノード名[1]

OpenTP1システムの処置[1]

OpenTP1システムの定義の変更[1]

OpenTP1システムの変更に影響する定義[1]

OpenTP1通信時または系切り替え機能使用時のホスト名の指定[1]

OpenTP1提供以外のリソースマネジャの登録[1]

OpenTP1内部で使用するスレッドスタック領域のサイズ[1]

OpenTP1のパラダイム[1]

OpenTP1のパラダイムに従うか，XATMIのパラダイムに従うかを指定[1]

OpenTP1も同時にダウン[1]

order[1]

OSI TP通信のアソシエーションによって使用されるFDSの最大値[1]

OSI TP通信用のスタブを使用[1]

otqinhold[1]

P

parallel_count[1]、[2]、[3]

polling_control_data[1]、[2]、[3]

prc_abort_signal[1]、[2]

prc_corecompress[1]

prc_coredump_filter[1]、[2]、[3]

prc_coresave_path[1]

prc_current_work_path[1]

prc_hugepage_group_id[1]

prc_port[1]

prc_prf_trace[1]

prc_process_count[1]

prc_recovery_resident[1]

prc_take_over_dlpath[1]

prc_take_over_svpath[1]

prcsvpath[1]

preend_warning_watch_time[1]

prf_buff_size[1]

prf_file_count[1]、[2]、[3]、[4]、[5]、[6]

prf_file_size[1]、[2]、[3]、[4]、[5]、[6]

prf_information_level[1]、[2]、[3]、[4]、[5]、[6]

prf_trace[1]

prf_trace_backup[1]、[2]

purge_msgget[1]、[2]

putenv形式[1]

Q

que_conf[1]

que_io_maxrecsize[1]

que_xidnum[1]

quegrp[1]

quegrpid[1]、[2]、[3]

quekind[1]、[2]、[3]

R

rap_autoconnect_con_error_msg[1]、[2]

rap_client_manager_node[1]

rap_client_manager_port[1]

rap_connect_interval[1]

rap_connect_retry_count[1]

rap_connect_retry_interval[1]

rap_connection_assign_type[1]

rap_extend_function[1]、[2]、[3]

rap_inquire_time[1]

rap_inquire_timeout_message[1]

rap_io_retry_interval[1]

rap_listen_backlog[1]

rap_listen_inf[1]

rap_listen_port[1]

rap_max_buff_size[1]

rap_max_client[1]

rap_message_id_change_level[1]、[2]、[3]

rap_msg_output_interval[1]

rap_notify[1]

rap_parallel_server[1]

rap_recovery_server[1]

rap_sock_count[1]

rap_sock_interval[1]

rap_stay_warning_interval[1]

rap_stay_watch_time[1]

rap_term_disconnect_time[1]

rap_watch_time[1]、[2]

rapクライアントマネジャサービス定義[1]

rapクライアントマネジャに対し起動通知を行う[1]

rapクライアントマネジャのポート番号[1]

rapクライアントマネジャへ起動通知[1]

rapサーバ数[1]

rapサーバ用ユーザサービス定義[1]

rapサーバ割り当て待ち要求の滞留監視時間[1]

rapリスナーおよびrapサーバから出力される監査ログを抑止[1]

rapリスナーサービス定義[1]

rapリスナー終了時のコネクション切断待ち時間[1]

rapリスナーに同時接続する最大クライアント数[1]

rapリスナーポート番号[1]

rapリスナー用ユーザサービス定義[1]

readメッセージイベントを取得[1]

receive_from[1]、[2]

recvmsg[1]

recvtim[1]

redirect_file_name[1]

reruntm[1]

reschedulecnt[1]、[2]

rescheduleint[1]、[2]

reschedulelog[1]、[2]

rmm_abort_command[1]

rmm_check_services[1]

rmm_command_gid[1]

rmm_command_uid[1]

rmm_command_watch_time[1]

rmm_conf[1]

rmm_down_with_system[1]

rmm_get_pid_command[1]

rmm_start_command[1]

rmm_start_watch_time[1]

rmm_stop_command[1]

rmm_sysdown_with_rm[1]

rmm_system_behavior[1]

RMMサービス定義[1]

RMMサービスを使用[1]

rmtim[1]

rpc_buffer_pool_max[1]、[2]

rpc_close_after_send[1]、[2]、[3]

rpc_datacomp[1]

rpc_delay_statistics[1]

rpc_destination_mode[1]、[2]

rpc_extend_function[1]、[2]、[3]

rpc_max_message_size[1]

rpc_message_level[1]

rpc_multi_tp1_in_same_host[1]

rpc_netmask[1]

rpc_port_base[1]

rpc_rap_auto_connect[1]、[2]

rpc_rap_inquire_time[1]、[2]

rpc_rap_inquire_time_check[1]、[2]

rpc_request_cancel_for_timedout[1]、[2]

rpc_response_statistics[1]、[2]、[3]

rpc_retry[1]

rpc_retry_count[1]

rpc_retry_interval[1]

rpc_router_retry_count[1]

rpc_router_retry_interval[1]

rpc_send_retry_count[1]、[2]、[3]

rpc_send_retry_interval[1]、[2]、[3]

rpc_server_busy_count[1]

rpc_service_retry_count[1]、[2]

rpc_trace[1]、[2]、[3]、[4]

rpc_trace_name[1]、[2]、[3]、[4]

rpc_trace_size[1]、[2]、[3]、[4]

RPCコール（同期応答型）イベントを取得[1]

RPCコール（連鎖RPC型）イベントを取得[1]

RPCサービスの機能拡張レベル[1]、[2]、[3]

RPC処理のリトライ回数最大値[1]

RPC処理のリトライ間隔[1]

RPC送受信電文の最大長[1]

RPCタイムアウトイベントを取得[1]

RPCトレースを取得[1]、[2]、[3]

RPCトレースを取得するファイルのサイズ[1]、[2]、[3]、[4]

RPCトレースを取得するファイル名[1]、[2]、[3]、[4]

RPCの受け付けの開始時期[1]

RPCの処理をリトライ[1]

RPCのトラブルシュートメッセージの表示レベル[1]

RPC抑止リストに登録されたノードの監視機能を使用[1]

rts_cpd_collct_cpd[1]

rts_cpd_validt_cpd[1]

rts_dam_cache_block[1]

rts_dam_fj[1]

rts_dam_read[1]

rts_dam_read_err[1]

rts_dam_shm_pool[1]

rts_dam_trn_branch[1]

rts_dam_write[1]

rts_dam_write_err[1]

rts_item_max[1]

rts_jnl_buf_full[1]

rts_jnl_io_wait[1]

rts_jnl_jnl_input[1]

rts_jnl_jnl_output[1]

rts_jnl_read[1]

rts_jnl_swap[1]

rts_jnl_wait_buf[1]

rts_jnl_write[1]

rts_lck_deadlock[1]

rts_lck_lock_acqst[1]

rts_lck_lock_wait[1]

rts_log_file[1]

rts_log_file_backup[1]

rts_log_file_count[1]

rts_log_file_name[1]

rts_log_file_size[1]

rts_mcf_ap_scd_stay[1]

rts_mcf_ap_usr_srvc[1]

rts_mcf_in_msg_scd_wait[1]

rts_mcf_out_msg_norm_scd_wait[1]

rts_mcf_out_msg_prio_scd_wait[1]

rts_mcf_out_msg_resp_scd_wait[1]

rts_mcf_out_msg_sync_scd_wait[1]

rts_mcf_que_scd_wait_num[1]

rts_nam_global_cache_hit[1]

rts_nam_local_cache_hit[1]

rts_nam_lookup[1]

rts_nam_node_lookup[1]

rts_nam_node_lookup_responce[1]

rts_osl_dynmem_acq[1]

rts_osl_dynmem_pol[1]

rts_osl_stamem_acq[1]

rts_osl_stamem_pol[1]

rts_prc_prc_genert[1]

rts_prc_prc_num[1]

rts_prc_prc_term[1]

rts_prc_sys_abnml[1]

rts_prc_uap_abnml[1]

rts_que_delay_msg[1]

rts_que_delay_rec[1]

rts_que_delay_wrt[1]

rts_que_read[1]

rts_que_read_err[1]

rts_que_real_read[1]

rts_que_real_write[1]

rts_que_wait_buf[1]

rts_que_write[1]

rts_que_write_err[1]

rts_rpc_rpc_call[1]

rts_rpc_rpc_call_chained[1]

rts_rpc_rpc_ovrtim[1]

rts_rpc_usr_srvc[1]

rts_scd_lack_buf[1]

rts_scd_parallel=Y|N[1]

rts_scd_scd_stay[1]

rts_scd_scd_wait[1]

rts_scd_schedule[1]

rts_scd_svc_scd_wait[1]

rts_scd_svc_using_buf=Y|N[1]

rts_scd_using_buf[1]

rts_service_max[1]

rts_swap_message[1]

rts_tam_read[1]

rts_tam_read_err[1]

rts_tam_real_renew[1]

rts_tam_real_renew_time[1]

rts_tam_rec_refer[1]

rts_tam_rec_renew[1]

rts_tam_write[1]

rts_tam_write_err[1]

rts_trcput_interval[1]

rts_trn_branch[1]

rts_trn_cmt_cmd[1]

rts_trn_commit[1]

rts_trn_haz_cmd[1]

rts_trn_mix_cmd[1]

rts_trn_rbk_cmd[1]

rts_trn_rollback[1]

rts_trn_sync_point[1]

rts_xar_call[1]

rts_xar_call_err[1]

rts_xar_commit[1]

rts_xar_commit_err[1]

rts_xar_end[1]

rts_xar_end_err[1]

rts_xar_forget[1]

rts_xar_forget_err[1]

rts_xar_prepare[1]

rts_xar_prepare_err[1]

rts_xar_recover[1]

rts_xar_recover_err[1]

rts_xar_rollback[1]

rts_xar_rollback_err[1]

rts_xar_start[1]

rts_xar_start_err[1]

rtsput[1]

RTSログファイルのサイズ[1]

RTSログファイルのスワップメッセージ（KFCA32740-Iメッセージ）を出力[1]

RTSログファイルの世代数[1]

RTSログファイルのバックアップファイルを作成[1]

RTSログファイル名[1]

S

scd_advertise_control[1]

scd_announce_server_status[1]

scd_hold_recovery[1]

scd_hold_recovery_count[1]

scd_message_level[1]

scd_pool_warning_interval[1]、[2]

scd_pool_warning_use_rate[1]、[2]

scd_poolfull_check_count[1]、[2]

scd_poolfull_check_interval[1]、[2]

scd_port[1]

scd_process_ctl_opt[1]、[2]

scd_refresh_process[1]、[2]

scd_retry_of_comm_error[1]

scd_server_count[1]

scd_this_node_first[1]

scdbufgrp[1]、[2]、[3]

scdmulti[1]、[2]、[3]

scdsvcdef[1]、[2]

schedule_delay_abort[1]、[2]

schedule_delay_limit[1]、[2]

schedule_method[1]、[2]

schedule_priority[1]、[2]

schedule_rate[1]

scs_prf_trace_level[1]

segsize[1]

server_count[1]

server_type[1]、[2]

servgrpn[1]、[2]

servhold[1]

service[1]

service_expiration_time[1]、[2]

service_group[1]

service_hold[1]、[2]

service_priority_control[1]、[2]

service_term_watch_time[1]、[2]

service_wait_time[1]、[2]

servname[1]

set形式[1]

shmpool_attribute[1]

size[1]

sndrcvtim[1]

sndtim[1]

srvghold[1]

stack_size_unlimited[1]、[2]

start_scheduling_timing[1]

static_shmpool_size[1]

statistics[1]

stats[1]

status_change_when_terming[1]、[2]

stay_watch_abort[1]、[2]

stay_watch_check_interval[1]、[2]

stay_watch_check_rate[1]、[2]

stay_watch_queue_count[1]、[2]

stay_watch_start_interval[1]、[2]

sts_file_name_1[1]

sts_file_name_7[1]

sts_initial_error_switch[1]

sts_last_active_file[1]

sts_last_active_side[1]

sts_single_operation_switch[1]

syslog失敗リストのエレメント数[1]

syslog失敗リストを定期的に出力する間隔[1]

syslog出力機能[1]、[2]

syslog出力レベル[1]

syssvname[1]

system_id[1]

system_init_watch_time[1]

system_terminate_watch_time[1]

T

tam_cbl_level[1]

tam_conf[1]

tam_jnl_err_flag[1]

tam_max_filesize[1]

tam_max_recsize[1]

tam_max_tblnum[1]

tam_max_trnfilnum[1]

tam_max_trnnum[1]

tam_pool_attri[1]

tam_tbl_lock_mode[1]

tamtable[1]

TAMサービス定義[1]

TAMサービスの最大同時排他要求数[1]

TAMサービスを使用[1]

TAMサービスを停止[1]

TAM情報のreadイベントを取得[1]

TAM情報のreadエラーイベントを取得[1]

TAM情報のwriteイベントを取得[1]

TAM情報のwriteエラーイベントを取得[1]

TAMテーブルアクセス形態[1]

TAMテーブルの最大レコード長[1]

TAMテーブルの属性の指定[1]

TAMファイル実更新イベントを取得[1]

TAMファイル実更新時間イベントを取得[1]

TCP_NODELAYオプションを使用[1]

TCP/IPコネクションの接続時にエラーが発生した場合のリトライ回数[1]、[2]、[3]

TCP/IPコネクションの接続時にエラーが発生した場合のリトライ間隔[1]、[2]、[3]

TCP/IPの受信バッファサイズ[1]、[2]、[3]

TCP/IPの送受信バッファサイズ[1]、[2]

TCP/IPの送受信バッファサイズをlistenソケットに設定[1]、[2]

TCP/IPの送信バッファサイズ[1]、[2]、[3]

TCP/IPのネットワーク定義ファイルに指定したサブネットマスク値[1]

tempsize[1]

term_watch_count[1]

term_watch_time[1]、[2]、[3]

termed_after_service[1]、[2]

thdlock_sleep_time[1]、[2]

thread_stack_size[1]

thread_yield_interval[1]、[2]、[3]

tim_watch_count[1]

timereqno[1]

tp1_monitor_kill_signal[1]

tp1_monitor_time[1]

TP1/NET/OSI-TP-Extendedの定義[1]

TP1/Server Base用の共用メモリの見積もり式[1]

trccnt[1]

trf_put[1]、[2]、[3]

trn_completion_limit_time[1]、[2]、[3]、[4]、[5]

trn_cpu_time[1]、[2]、[3]、[4]、[5]

trn_crm_use[1]

trn_expiration_time[1]、[2]、[3]、[4]、[5]

trn_expiration_time_suspend[1]、[2]、[3]、[4]、[5]

trn_extend_function[1]

trn_limit_time[1]、[2]、[3]、[4]、[5]

trn_max_crm_subordinate_count[1]

trn_max_subordinate_count[1]

trn_optimum_item[1]、[2]、[3]、[4]、[5]

trn_partial_recovery_type[1]、[2]、[3]、[4]、[5]

trn_prf_event_trace_condition[1]

trn_prf_event_trace_level[1]

trn_prf_trace_level[1]

trn_processing_in_rm_error[1]

trn_rcv_open_close_scope[1]

trn_recovery_failmsg_interval[1]

trn_recovery_list_remove[1]

trn_recovery_list_remove_level[1]

trn_recovery_process_count[1]

trn_retry_count_rm_open[1]

trn_retry_interval_rm_open[1]

trn_rm_open_close_scope[1]、[2]、[3]

trn_rollback_information_put[1]、[2]、[3]、[4]、[5]

trn_rollback_response_receive[1]、[2]、[3]、[4]、[5]

trn_start_recovery_interval[1]

trn_start_recovery_mode[1]

trn_start_recovery_watch_time[1]

trn_statistics_item[1]、[2]、[3]、[4]、[5]

trn_tran_process_count[1]

trn_tran_recovery_list[1]

trn_tran_statistics[1]

trn_wait_rm_open[1]

trn_watch_time[1]、[2]、[3]、[4]、[5]

trn_xa_commit_error[1]

trn_xar_use[1]

trnlnkrm[1]

trnmode[1]

trnrmid[1]、[2]

trnstring[1]

TRNイベントトレース関連のメッセージの表示レベル[1]

TRNイベントトレース情報ファイルのサイズ[1]

TRNイベントトレース情報ファイルの世代数[1]

TRNイベントトレース定義[1]

TRNイベントトレースの取得レベル[1]

type[1]、[2]、[3]

TZ[1]

U

uap_conf[1]

uap_trace_file_put[1]、[2]、[3]

uap_trace_max[1]、[2]、[3]

UAP異常終了イベントを取得[1]

UAP異常終了通知イベント[1]

UAP共通定義[1]

UAP共用ライブラリ[1]

UAP共用ライブラリのサーチパスをリラン時に引き継ぐ[1]

UAPトレース格納最大数[1]、[2]、[3]

UAPトレースのトレース情報を，ファイルに取得[1]

UAPプロセスでアクセスするファイルおよびパイプの最大数[1]、[2]

uid[1]、[2]、[3]、[4]

UJコード[1]

user_command[1]

user_command_online[1]

user_command_online_tp1mngr_id[1]

user_command_onlineオペランドに指定したシステム開始完了コマンドをOpenTP1管理者のUID/GIDで実行[1]

user_server_ha[1]

usertime[1]

W

watch_next_chain_time[1]、[2]

watch_time[1]、[2]、[3]、[4]、[5]、[6]、[7]、[8]、[9]、[10]、[11]、[12]、[13]、[14]、[15]、[16]、[17]、[18]

watchcnt[1]

watchint[1]

writeメッセージイベントを取得[1]

X

xa_open関数発行リトライインタバル時間[1]

xa_open関数発行リトライ回数[1]

xar_eventtrace_level[1]

xar_eventtrace_record[1]

xar_msdtc_use[1]

xar_prf_trace_level[1]

xar_session_time[1]

xarfile[1]

XARイベントトレース情報の出力レベル[1]

XARイベントトレース情報ファイルの最大出力レコード数[1]

XAR性能検証用トレース関連のメッセージの表示レベル[1]

XAR性能検証用トレース情報の取得レベル[1]

XAR性能検証用トレース情報ファイルのサイズ[1]

XAR性能検証用トレース情報ファイルの世代数[1]

XAR性能検証用トレース定義[1]

XARファイルの指定[1]

xat_aso_con_event_svcname[1]

xat_aso_discon_event_svcname[1]

xat_aso_failure_event_svcname[1]

xat_conf[1]

xat_connect_resp_time[1]、[2]

XAT_CONNECT_RESP_TIME[1]、[2]

xat_osi_us[1]

xat_osi_usr[1]

xat_trn_expiration_time[1]、[2]

xatinitaeq[1]

xatinitapt[1]

XATMI通信サービス定義[1]

XATMI通信サービスとUAPとの通信で使用されるFDSの最大値[1]

XATMI通信サービスを使用[1]

XATMIのパラダイム[1]

xatsrvadd[1]

XA関数（xa_open()，xa_commit()，xa_rollback()，xa_close()）の発行順序を変更する[1]

XAリソースサービス定義[1]

XAリソースサービスを使用する[1]

あ

アーカイブ時の転送データの最大長[1]、[2]

アーカイブジャーナルサービス定義[1]

アーカイブジャーナルファイルのファイルグループ名と属性の定義[1]

アーカイブジャーナルファイルのファイルグループを構成する物理ファイルの定義[1]

アーカイブジャーナルファイルをスワップ[1]

アーカイブジャーナルファイルを二重化[1]

アーカイブ対象ジャーナルをすべてアーカイブ[1]

アーカイブの対象とする[1]

アーカイブ用バッファサイズ[1]

アイドル状態のトランザクションブランチの監視時間[1]

空きバッファ待ちイベントを取得[1]

アクセス関数をエラーリターン[1]

アソシエーションの異常解放通知を受信[1]

アソシエーションの確立通知を受信[1]

アソシエーションの正常解放通知を受信[1]

アプリケーション異常終了回数のカウント方法[1]

アプリケーション異常終了限界回数[1]

アプリケーション異常終了時の再スケジュール回数[1]、[2]

アプリケーション異常終了時の再スケジュール間隔[1]、[2]

アプリケーション環境定義[1]

アプリケーション起動環境定義の開始[1]

アプリケーション起動環境定義の終了[1]

アプリケーション起動機能[1]

アプリケーション起動時の遅延許容時間[1]

アプリケーション起動定義[1]

アプリケーション起動定義コマンドの指定順序[1]

アプリケーション起動プロセス[1]

アプリケーション起動プロセス識別子[1]、[2]、[3]、[4]

アプリケーション起動プロセスの属するMCFマネジャ識別子[1]、[2]

アプリケーション起動用論理端末定義[1]

アプリケーション数上限値[1]

アプリケーション属性定義[1]

アプリケーションの型[1]

アプリケーションの種別[1]

アプリケーションの処置[1]

アプリケーションプログラムが閉塞する場合[1]

アプリケーションプログラムとシステム環境設定の関連[1]

アプリケーションプログラムに関連するOpenTP1のシステム定義[1]

アプリケーション名[1]、[2]

アプリケーション名とサービス名との関係[1]

アボート用シグナル番号[1]、[2]

アンロード待ち状態をチェック[1]、[2]

い

一時クローズ処理要求が到着していない[1]、[2]

一般分岐型送信メッセージの処理待ち情報を取得[1]

一方送信型論理端末[1]

イベント登録[1]

インタバルサービス定義[1]

う

上書きできるファイルグループとして割り当てる[1]

え

エージェントノードのノードリストに，ノーマルノードのノードの情報を登録するかどうか[1]

エラーイベント処理用MHP[1]

エラーが発生したときの処置[1]

エラーリターンした場合のOpenTP1の処置[1]

エントリポイント名[1]

お

オートコネクトモード[1]

オープン状態[1]、[2]、[3]

オンライン中に使用するTAMテーブルの最大数[1]

オンライン中に使用するTAMテーブルの最大容量[1]

オンライン中に追加する最大論理ファイル数[1]

か

回復対象外ファイル[1]

拡張RM登録定義[1]

拡張バッファ数[1]

拡張予約定義[1]

各ネットワークコミュニケーション定義とその出力オブジェクトファイル名[1]

片系運転[1]

片系クローズ状態のファイルグループを使用[1]

カレントワーキングディレクトリ作成用のディレクトリパス[1]

環境変数LANG[1]

環境変数TZ[1]

環境変数値[1]、[2]、[3]、[4]、[5]、[6]

環境変数名[1]、[2]、[3]、[4]、[5]、[6]

監査イベントを取得する定義[1]

監査ログ機能[1]

監査ログ機能を使用[1]

監査ログ取得メッセージID[1]

監査ログファイルの最大サイズ[1]

監査ログファイルの最大数[1]

監査ログファイルの出力先ディレクトリ[1]

監査ログを取得する項目のメッセージID[1]、[2]、[3]、[4]

監視間隔時間[1]

監視時間[1]、[2]、[3]、[4]

監視するrapリスナーを指定[1]

監視対象RM開始コマンド[1]

監視対象RM開始処理監視時間[1]

監視対象RM強制終了コマンド[1]

監視対象RMコマンド監視時間[1]

監視対象RM終了コマンド[1]

監視対象RM定義[1]

監視対象RM名[1]

監視対象プロセスID取得コマンド[1]

監視対象リソースマネジャも同時にダウン[1]

き

記号の説明[1]

記述形式[1]

起動通知機能を使用[1]、[2]

起動通知を行う[1]

起動プロセス数の監視イベントを取得[1]

基本事項[1]

キャッシュブロック再利用境界デフォルト値[1]

キャッシュブロック数のしきい値の指定[1]

キャッシュブロックの再利用境界値の指定[1]

キャッシュブロック用領域[1]

キュー（ディスク）の種別[1]

キューグループ[1]

キューグループID[1]、[2]、[3]、[4]

キューファイル[1]

共通定義[1]

共通定義コマンドの指定順序[1]

共用メモリ上にシステム統計情報を取得[1]

共用メモリプール[1]

く

クライアントUAPの応答待ち時間をサーバに意識[1]

クライアント拡張サービスのポート番号[1]

クライアント拡張サービスを使用[1]

クライアントからの要求最大待ち時間が満了したことを検知したとき，エラーメッセージを出力[1]

クライアントサービス定義[1]

クライアント数表示メッセージの出力間隔[1]

グループ識別子[1]

グローバルアーカイブジャーナルサービス定義[1]

グローバルアーカイブジャーナルサービスの通信応答待ち時間[1]

グローバルアーカイブジャーナルサービスのリソースグループ名[1]

グローバルアーカイブジャーナルサービスのリソースグループ名の指定[1]

グローバルアーカイブジャーナルサービスを実行[1]

グローバルキャッシュヒットイベントを取得[1]

グローバル検索機能を使用[1]

グローバルドメイン[1]

グローバルトランザクション単位の最適化[1]

け

系切り替え機能を使用[1]

警告メッセージの出力判断値になるメッセージ格納バッファプール使用率の上限値[1]、[2]

継続問い合わせ応答用一時記憶データ格納用領域サイズ[1]

現用ファイルが確定できないときの論理ファイルの状態（continueの場合）[1]

現用ファイルが確定できないときの論理ファイルの状態（excontinueの場合）[1]

こ

コアファイル格納パス[1]

コアファイルに共用メモリを含めるかの判断値[1]

コアファイルに共用メモリを含めるかの判断値[1]、[2]

コアファイルの格納時にOpenTP1で自動的に圧縮[1]

更新する最大ブロック数[1]

構文要素記号[1]

コネクション確立監視時間[1]、[2]、[3]

コネクション確立処理の間隔[1]

コネクション確立処理のリトライ回数[1]

コネクション確立処理のリトライ間隔[1]、[2]

コネクション確立処理をリトライする回数[1]

コネクション確立要求を格納するキューの長さ[1]、[2]、[3]

コネクションを，OpenTP1が自動的に管理[1]

コマンド形式[1]

コマンド実行用グループID[1]

コマンド実行用ユーザID[1]

コマンドによるコミットイベントを取得[1]

コマンドによるハザードイベントを取得[1]

コマンドによるミックスイベントを取得[1]

コマンドによるロールバックイベントを取得[1]

コミット，ロールバック（レコード更新）イベントを取得[1]

コミット，ロールバック（レコード参照）イベントを取得[1]

コミットイベントを取得[1]

コメント[1]

さ

サーバの状態の変化を，次回再開始時に反映させる[1]

サーバリカバリジャーナルファイル[1]、[2]

サービス応答の待ち時間[1]

サービス関数開始から終了までの実行監視時間[1]、[2]

サービスグループ，およびサービスの閉塞状態を引き継ぐ[1]

サービスグループ，またはサービスを閉塞[1]

サービスグループ数上限値[1]

サービスグループ属性定義[1]

サービスグループのグループアクセスリストを設定[1]、[2]

サービスグループの種別[1]

サービスグループの処置[1]

サービスグループの登録数[1]

サービスグループ名[1]、[2]、[3]、[4]

サービス情報キャッシュ領域の大きさ[1]

サービス情報の検索回数イベントを取得[1]

サービス情報領域の大きさ[1]

サービス数上限値[1]

サービス単位にスケジュールサービスの動作を指定[1]、[2]

サービス単位のスケジュール待ちイベントを取得[1]

サービス単位の閉塞管理[1]

サービス単位のメッセージ格納バッファプールの使用中サイズイベントを取得[1]

サービス定義ファイルまたはユーザサービスデフォルト定義ファイルの格納ディレクトリ[1]、[2]

サービスの合計数[1]

サービスの処置[1]

サービスの送信先を決定[1]

サービスのリトライ回数の最大値[1]、[2]

サービス名[1]、[2]、[3]

サービス要求滞留数[1]、[2]

サービス要求滞留値[1]

サービス要求でのエラーイベントを取得[1]

サービス要求の回数イベントを取得[1]

再開始時に変更できるシステムサービス定義の一覧[1]

再開始時に変更できる定義[1]

最小ポート番号[1]

最新の現用ファイル[1]

最大CRM経由子トランザクションブランチ数[1]

最大応答待ち時間[1]、[2]、[3]、[4]、[5]、[6]、[7]、[8]、[9]、[10]、[11]、[12]、[13]、[14]、[15]、[16]、[17]

最大子トランザクションブランチ数[1]

最大サーバ数[1]

最大時間監視サービス数[1]

最大取得項目数[1]

最大取得サービス数[1]

最大処理多重度[1]

最大処理多重度定義[1]

最大セグメント長[1]

最大同時起動サーバプロセス数[1]

最大プロセス数[1]、[2]、[3]、[4]

最大ブロック長[1]

最大メッセージ長[1]、[2]

最大ユーザサーバ数[1]

最大レコードデータ長[1]

作成手順[1]

し

自AE修飾子[1]

自AP名称[1]

仕掛中トランザクション情報メッセージ間隔最小時間[1]

時間監視間隔[1]

システム開始完了コマンド[1]

システム環境設定の関係[1]

システム環境定義[1]

システム共通定義[1]、[2]

システムサーバ異常終了イベントを取得[1]

システムサービス共通情報定義[1]

システムサービス構成定義[1]

システムサービス情報定義[1]

システムサービス情報定義ファイル名[1]

システムサービス定義[1]

システムサービス定義とファイル名[1]

システムサービス定義の概要[1]

システムサービス定義の構成[1]

システムサービス定義の詳細[1]

システムサービスの起動[1]

システムジャーナルサービス定義[1]

システムジャーナルファイルのファイルグループ名と属性の定義[1]

システムジャーナルファイルのファイルグループを構成する物理ファイルの定義[1]

システム終了監視時間[1]

システム初期化の待ち時間[1]

システム全体の開始処理を続行[1]

システム定義[1]

システム定義のデフォルト値選択オプション[1]

システム定義のファイル名[1]

システム内の通番を付ける[1]、[2]、[3]

システム内のメッセージ通番を付ける[1]

システムの開始方法[1]

実行間隔時間[1]

実行形式プログラム名[1]

実時間監視タイムアウトプロセスのコアダンプ出力を抑止する時間間隔[1]

指定参照先ノードへのサービス検索の応答送信回数イベントを取得[1]

指定参照先ノードへのサービス検索の送信回数イベントを取得[1]

自動アンロード機能を使用[1]

自動アンロード継続機能を使用[1]

自ノードと同じノード識別子を指定したノードから通信を受信した場合に，KFCA00677-Wメッセージを出力[1]

自ノードのサーバの状態を，他ノードに通知[1]

自ノードのサーバを優先してスケジュール[1]

ジャーナル関係のファイルの指定[1]

ジャーナルサービス定義[1]

ジャーナルサービスの通信応答待ち時間[1]

ジャーナル出力（ブロック）イベントを取得[1]

ジャーナル情報のreadイベントを取得[1]

ジャーナル情報のwriteイベントを取得[1]

ジャーナル入力イベントを取得[1]

ジャーナルの出力方式に対する最適化レベル[1]

ジャーナルファイルグループの追加[1]

ジャーナルファイルレス機能を使用[1]

ジャーナルファイルを二重化[1]

ジャーナルブロック数[1]

ジャーナルレコード種別[1]

ジャーナルをスワップ[1]

終了準備警告監視時間[1]

縮退運転[1]、[2]

縮退運転オプション[1]

受信メッセージの扱い[1]

出力キュー[1]

出力先ファイル名[1]

出力通番使用論理端末数[1]

出力通番の初期値[1]

出力メッセージの割り当て先[1]

出力要求時の時刻を付ける[1]、[2]、[3]、[4]

出力要求時の日付を付ける[1]、[2]、[3]、[4]

出力要求元のプログラムIDを付ける[1]

出力要求元のホスト名を付ける[1]、[2]、[3]、[4]

取得した統計情報をRTSログファイルに出力[1]

条件付きジャーナル非同期出力[1]

常設コネクション問い合わせ間隔最大時間[1]

常設コネクション問い合わせ間隔最大時間の適用範囲[1]

状態引き継ぎ定義[1]、[2]

常駐プロセス数[1]、[2]、[3]、[4]

す

スケジューリングする[1]

スケジュールイベントを取得[1]

スケジュールキュー[1]

スケジュールキューの滞留監視インタバル時間[1]、[2]

スケジュールキューの滞留監視判定インタバル時間[1]、[2]

スケジュールキューの滞留監視判定式[1]

スケジュールキューの滞留監視判定式を満たした場合に，OpenTP1システムをダウンさせる[1]

スケジュールキューの滞留監視判定処理で使用するサービス要求の処理率[1]、[2]

スケジュールキューの滞留監視判定を開始する際の判断になるサービス要求滞留数[1]、[2]

スケジュールキューを，サーバ起動時に割り当てる[1]

スケジュールサービス定義[1]

スケジュールサービスのポート番号[1]

スケジュール滞留イベントを取得[1]

スケジュール遅延限界経過時間[1]、[2]

スケジュール遅延時にシステムダウン[1]

スケジュールできなかったメッセージサイズイベントを取得[1]

スケジュールの優先順位[1]、[2]

スケジュールバッファグループ[1]、[2]

スケジュールバッファグループの指定[1]、[2]

スケジュール比率[1]

スケジュール待ちイベントを取得[1]

スケジュール待ち情報を取得[1]

スケジュールメッセージ格納セル長[1]、[2]

ステータスサービス定義[1]

ステータスサービスの処置[1]、[2]

スレッド間で排他が競合した場合のスレッドの待ち時間[1]、[2]

スワップイベントを取得[1]

スワップ先として割り当てる[1]

せ

制限事項[1]

正常だった系を指定[1]

静的共用メモリの使用サイズイベントを取得[1]

静的共用メモリの総量[1]

静的共用メモリプールの必要最大サイズイベントを取得[1]

性能検証用トレース関連のメッセージの表示レベル[1]

性能検証用トレース情報ファイルのサイズ[1]

性能検証用トレース情報ファイルの世代数[1]

性能検証用トレース情報を取得[1]

性能検証用トレース定義[1]

接続待ちキューに保留できる最大要求数[1]

前回の終了モード[1]

そ

属性表示記号[1]

ソケットウィンドウサイズ[1]

ソケット再利用可能監視時間[1]、[2]、[3]、[4]

ソケット受信型サーバ受信メッセージ数の最大値[1]、[2]

ソケット受信型サーバ受信メッセージ長の最大値[1]、[2]

ソケット生成処理のリトライ回数[1]

ソケット生成処理のリトライ間隔[1]

ソケットの一時クローズ処理開始数パーセンテージ[1]、[2]、[3]、[4]

ソケットの一時クローズ処理非対象数パーセンテージ[1]、[2]、[3]、[4]

ソケットの再利用指示を受信できる契機を与えるインタバル時間[1]、[2]、[3]

ソケット用ファイル記述子の最大数[1]、[2]、[3]、[4]、[5]、[6]、[7]、[8]、[9]、[10]、[11]

た

待機系OpenTP1起動失敗時のリトライ回数[1]

待機系OpenTP1起動失敗時のリトライ間隔[1]

待機系のユーザサーバを起動[1]

対象となるシステムサービス名[1]

ダイナミックコネクションスケジュール機能を使用[1]

タイマ起動メッセージ廃棄通知イベント[1]

タイマサービス定義[1]

タイマ定義[1]

タイムアウト情報ファイルの削除レベル[1]

タイムアウト情報を出力[1]

タイムゾーン[1]

滞留警告メッセージの出力間隔[1]

他システムが提供するサービス名の指定[1]

他ノードのサービス情報の有効時間[1]

端末タイプ[1]

ち

チェックポイントダンプサービス定義[1]

チェックポイントダンプ取得イベントを取得[1]

チェックポイントダンプ取得契機のスキップ回数の上限値[1]

チェックポイントダンプ取得用バッファ長[1]

チェックポイントダンプファイルのファイルグループ名と属性の定義[1]

チェックポイントダンプファイルのファイルグループを構成する物理ファイルの定義[1]

チェックポイントダンプファイルを二重化[1]

チェックポイントダンプ有効化イベントを取得[1]

遅延書き込み（回数）イベントを取得[1]

遅延書き込み最大レコード長[1]

つ

通信相手のサービス情報の指定[1]

通信イベント障害時のエラーイベント通知機能[1]

通信イベント処理用SPPのアソシエーション確立の最大応答待ち時間[1]、[2]、[3]、[4]

通信関数発行回数上限値[1]

通信サービス定義[1]

通信制御データの受信監視時間[1]、[2]、[3]

通信遅延時間[1]

通信遅延時間統計情報を取得[1]

通信リソースマネジャ[1]

て

定義オブジェクトファイル[1]

定義オブジェクトファイル生成に使用するユティリティ起動コマンド[1]

定義オブジェクトファイルの生成[1]

定義ソースファイル[1]

定義の規則[1]

定義の構成[1]

定義の作成手順[1]

定義のしかた[1]

定義の種類[1]、[2]

定義の体系[1]

定義の変更手順[1]

定義ファイルの格納ディレクトリ[1]、[2]

定義例[1]

ディスク出力機能を使用[1]

ディスク出力メッセージ最大格納数[1]

ディファード更新機能[1]

ディファード更新処理[1]

データコミュニケーション定義[1]

データ送信監視回数[1]、[2]、[3]

データ送信監視間隔[1]、[2]、[3]

テーブル排他モードを指定[1]

デッドロックイベントを取得[1]

デッドロック情報とタイムアウト情報を出力[1]

デッドロック情報ファイルとタイムアウト情報ファイルの削除レベル[1]

デッドロック情報ファイルとタイムアウト情報ファイルを削除[1]

デッドロックの優先順位[1]、[2]

デバッグ情報を取得[1]

電文送受信時のリトライ間隔[1]

と

問い合わせ応答型送信メッセージの処理待ち情報を取得[1]

問い合わせ型論理端末[1]

問い合わせ間隔最大時間[1]

同一グローバルドメインとして運用[1]

同期型受信監視時間[1]

同期型送受信監視時間[1]

同期型送信監視時間[1]

同期型送信メッセージの処理待ち情報を取得[1]

同期点処理全体の最適化[1]、[2]

同期点処理の限界経過監視時間[1]、[2]

統計情報[1]

統計情報項目[1]、[2]、[3]、[4]、[5]

統計情報取得サービスの指定[1]

統計情報の取得間隔[1]

同時実行DAMトランザクションブランチ数イベントを取得[1]

同時実行サービス数イベントを取得[1]

同時実行トランザクション数[1]

同時走行最大トランザクションブランチ数[1]

同時に起動するトランザクションブランチの数[1]

同時に実行するトランザクションブランチの数[1]

動的共用メモリの最大使用時の総量[1]

動的共用メモリの使用サイズイベントを取得[1]

動的共用メモリプールの必要最大サイズイベントを取得[1]

ドメイン代表スケジュールサービスのポート番号[1]

ドメイン定義ファイルを使用したドメイン変更時の最大ノード数[1]

ドメインネームサービスに問い合わせる[1]

ドメイン変更時の最大ノード数[1]

ドメイン名[1]

トランザクショナルRPC実行プロセスのポート番号[1]

トランザクショナルRPC実行プロセスを起動[1]

トランザクション開始要求でのエラーイベントを取得[1]

トランザクション開始要求の回数イベントを取得[1]

トランザクション回復処理方式[1]

トランザクション完了限界時間[1]、[2]、[3]、[4]、[5]

トランザクションサービス定義[1]

トランザクションサービスの機能の拡張レベル[1]

トランザクション最適化項目[1]、[2]、[3]、[4]、[5]

トランザクション終了要求でのエラーイベントを取得[1]

トランザクション終了要求の回数イベントを取得[1]

トランザクション通知要求でのエラーイベントを取得[1]

トランザクション通知要求の回数イベントを取得[1]

トランザクション同期点処理時の最大通信待ち時間[1]、[2]、[3]、[4]、[5]

トランザクション同期点処理方式を指定[1]、[2]、[3]、[4]

トランザクション内最大アクセステーブル数[1]

トランザクションのコミット処理要求でのエラーイベントを取得[1]

トランザクションのコミット処理要求の回数イベントを取得[1]

トランザクションの時間監視[1]

トランザクションの単位を指定[1]

トランザクションのプリペア処理要求でのエラーイベントを取得[1]

トランザクションのプリペア処理要求の回数イベントを取得[1]

トランザクションのロールバック処理要求でのエラーイベントを取得[1]

トランザクションのロールバック処理要求の回数イベントを取得[1]

トランザクション破棄要求でのエラーイベントを取得[1]

トランザクション破棄要求の回数イベントを取得[1]

トランザクションブランチCPU監視時間[1]、[2]、[3]、[4]、[5]

トランザクションブランチ限界経過時間[1]、[2]、[3]、[4]、[5]

トランザクションブランチごとの統計情報を取得[1]

トランザクションブランチ最大実行可能時間[1]、[2]、[3]、[4]、[5]

トランザクションブランチの最大数[1]

トランザクションブランチの処理を監視するとき，次の処理時間も監視時間に含む[1]、[2]、[3]、[4]

トランザクションブランチの統計情報[1]

トランザクションブランチの統計情報を取得[1]

トランザクションリカバリジャーナルに出力[1]、[2]

トランザクションを発生[1]

トレース環境定義[1]

トレース取得種類[1]

トレースとして取得する送受信メッセージの最大サイズ[1]

トレースの取得レベル[1]

トレースバッファの大きさ[1]

トレースバッファの数[1]

トレースファイルの数[1]

な

内部通信路名[1]、[2]

名前付きパイプ[1]

に

入出力キュー定義[1]

入出力待ちイベントを取得[1]

入力キュー[1]

入力キューの滞留監視インタバル時間[1]

入力キューの滞留監視数[1]

入力キューの滞留数の情報を取得[1]

入力メッセージ最大格納数[1]

入力メッセージの割り当て先[1]

ね

ネームサービス定義[1]

ネームサービスで管理するサーバUAPの取得数[1]

ネームサービスのポート番号[1]

ネットワークコミュニケーション定義[1]

ネットワークコミュニケーション定義とシステムサービス定義との関連[1]

ネットワークコミュニケーション定義とファイル名[1]

ネットワークコミュニケーション定義の概要[1]

ネットワークコミュニケーション定義の構成[1]

ネットワークコミュニケーション定義のコマンド[1]

ネットワークコミュニケーション定義の詳細[1]

ネットワークコミュニケーション定義を登録するファイル名[1]

ネットワークライブラリ定義[1]

ネットワークライブラリ定義の構成[1]

の

ノード監視機能を使用[1]

ノードグループ名[1]

ノード識別子[1]、[2]

ノード識別子を付ける[1]

ノードの追加[1]

ノードの動作モード[1]

ノード名[1]、[2]、[3]

ノードリスト同期待ち時間[1]

ノードリストファイルの指定[1]

は

排他あり参照指定で読み込むブロックを，トランザクション決着までキャッシュバッファ領域上に残す[1]

排他解除検知インタバル最大時間[1]

排他待ち限界経過時間[1]

排他待ちの優先順位[1]、[2]

排他待ちプロセス[1]

発行タイミング[1]、[2]

バッファグループ定義[1]

バッファグループ番号[1]

バッファ数[1]

バッファ長[1]

バッファ満杯イベントを取得[1]

バッファ領域[1]

バッファ領域長[1]

ひ

非オートコネクトモード[1]

非常駐プロセスを終了[1]

非トランザクションMHP限界経過時間[1]、[2]

ふ

ファイルグループがスワップ先に割り当てられる条件[1]

プーリングするバッファ数[1]、[2]

負荷監視インタバル時間[1]、[2]

負荷レベル通知メッセージを出力[1]

不正アプリケーション名検出通知イベント[1]

物理ファイル単位の遅延書き込み（メッセージ）イベントを取得[1]

物理ファイル単位の遅延書き込み（レコード）イベントを取得[1]

ブランチ実行時間イベントを取得[1]

ブランチ同期点処理の実行時間イベントを取得[1]

プログラムIDを付ける[1]、[2]、[3]

プロセスIDを付ける[1]、[2]、[3]、[4]

プロセスがいつ排他を解除したかを調べる方法[1]

プロセスサービス定義[1]

プロセスサービスのイベントトレースを取得[1]

プロセス終了イベントを取得[1]

プロセス数の指定条件[1]、[2]、[3]

プロセス生成イベントを取得[1]

プロセス内の通番を付ける[1]、[2]、[3]

プロセス内のメッセージ通番を付ける[1]

プロセスの優先順位の変更[1]、[2]、[3]

プロセスを常駐にするか，非常駐にするか[1]

プロトコル固有定義[1]

文法記述記号[1]

へ

並行回復プロセス数[1]

閉塞[1]

閉塞状態の引き継ぎが必要なサーバ，およびサービスの合計数[1]

並列アクセス化する場合の最小分散数[1]、[2]

並列アクセス化する場合の最大分散数[1]、[2]

ほ

ポート番号[1]、[2]、[3]

ホスト名[1]、[2]、[3]

ホスト名またはIPアドレスの変更[1]

ま

待ち合わせ最大時間[1]、[2]

マネジャノードが停止を検知したエージェントノード，およびノーマルノードのノード情報を，ノードリストから削除するかどうか[1]

マルチOpenTP1システム[1]

マルチOpenTP1システムの定義[1]

マルチサーバ機能[1]

マルチスケジューラ機能の指定[1]、[2]

マルチスケジューラ機能を使用してスケジューリングする[1]

マルチスケジューラデーモンの情報の指定[1]

マルチノードエリア／サブエリアに属するノード識別子を指定する[1]

マルチノード機能を使用[1]

マルチノード構成定義[1]

マルチノードのホスト名とポート番号を指定する[1]

マルチノード物理定義[1]

マルチノード連携制御機能で使用するポート番号[1]

み

未決着トランザクション情報ファイルの削除レベル[1]

未決着トランザクション情報ファイルを削除[1]

未決着トランザクション情報を取得[1]

未処理受信メッセージ滞留時間[1]

未処理送信メッセージ滞留時間[1]

未処理送信メッセージ廃棄通知イベント[1]

め

メッセージIDの変更レベル[1]、[2]、[3]、[4]、[5]

メッセージ格納バッファプール使用率超過時の警告メッセージ出力インタバル時間[1]、[2]

メッセージ格納バッファプール長[1]、[2]、[3]

メッセージ格納バッファプールの指定[1]

メッセージ格納バッファプールの使用中サイズイベントを取得[1]

メッセージキューサービス（MCFサービス）を使用[1]

メッセージキューサービス定義[1]

メッセージキュー情報のreadエラーイベントを取得[1]

メッセージキュー情報のwriteエラーイベントを取得[1]

メッセージキュー情報の空きバッファ待ちイベントを取得[1]

メッセージキュー情報の実readイベントを取得[1]

メッセージキュー情報の実writeイベントを取得[1]

メッセージキュー定義[1]

メッセージキュー定義の構成[1]

メッセージキューファイルの指定[1]

メッセージキューを解放[1]

メッセージ出力指定[1]、[2]

メッセージ制御機能[1]

メッセージ送受信最大監視時間[1]、[2]

メッセージ送受信用，およびメッセージ編集用のバッファ[1]

メッセージ廃棄通知イベント[1]

メッセージログ出力機能[1]

メッセージログ出力抑止回数[1]

メッセージログ通知機能[1]

メッセージログ通知機能を使用[1]

メッセージログファイルの最大サイズ[1]

メッセージログを関連オペランド(log_syslog_xxxx)に従ったフォーマットでsyslogに出力[1]

メッセージを何を使って受信するかを指定[1]

メモリ出力メッセージ最大格納数[1]

メモリプール[1]

メンテナンス[1]

も

モデルアプリケーション属性定義の指定例[1]

ゆ

有効保証世代数[1]

ユーザ環境設定コマンド[1]

ユーザサーバおよびコマンドのパスをリラン時に引き継ぐ[1]

ユーザサーバの起動[1]

ユーザサーバの最大同時排他要求数[1]

ユーザサーバのジャーナルバッファの大きさ[1]

ユーザサーバのスケジューリング方式を指定[1]

ユーザサーバの多重度の変更[1]

ユーザサーバの追加[1]

ユーザサーバのパスの指定[1]

ユーザサーバの非常駐プロセスのサービス要求待ち時間[1]、[2]

ユーザサーバの閉塞状態を引き継ぐ[1]

ユーザサーバを起動[1]

ユーザサーバを自動起動[1]

ユーザサービス構成定義[1]、[2]

ユーザサービス実行イベントを取得[1]

ユーザサービス実行情報を取得[1]

ユーザサービス定義[1]、[2]

ユーザサービス定義の指定値とSPP，SUP，およびMHPとの関係[1]

ユーザサービス定義の指定値とUAPとの関係[1]

ユーザサービスデフォルト定義[1]、[2]

ユーザサービスネットワーク定義[1]

ユーザ識別子[1]、[2]

ユーザデータを圧縮[1]

ユーザ認証機能を使用[1]

優先分岐型送信メッセージの処理待ち情報を取得[1]

ユティリティ起動コマンド[1]

よ

抑止メッセージID[1]

予約ファイルをオープン[1]

予約ファイルを自動的にオープン[1]

ら

ラップ後の出力通番開始値[1]

ラップ時の出力通番最大値[1]

り

リアルタイム出力機能[1]

リアルタイム出力機能を使用[1]

リアルタイム取得項目定義[1]

リアルタイム統計情報サービス定義[1]

リカバリ要求用待機rapサーバ数[1]

リソースマネジャ拡張子の指定[1]、[2]

リソースマネジャのアクセス用文字列または拡張子の指定[1]

リトライ回数[1]

リトライ間隔時間[1]

リトライ経過時間[1]

リトライ指示のロールバック要求[1]

リモートAPI機能[1]、[2]

リモートAPI機能における性能検証用トレース取得レベル[1]

リモートAPI機能の機能拡張レベル[1]、[2]、[3]

リモートAPI機能を使用して要求するサービスの問い合わせ間隔最大時間[1]、[2]

リモートAPI機能を使用する[1]

リラン時のタイマ起動を引き継ぐかどうか[1]

履歴情報（GJ）[1]

履歴情報（IJ）[1]

履歴情報（OJ）[1]

履歴情報を取得[1]

れ

レスポンス統計情報を取得[1]、[2]

連鎖RPC間隔監視時間[1]、[2]

連続異常終了限界回数[1]

連続異常終了限界経過時間[1]、[2]、[3]

連続サービス異常終了限界経過時間[1]、[2]

ろ

ローカルキャッシュヒットイベントを取得[1]

ロールバックイベントを取得[1]

ロールバック完了通知を受信[1]、[2]、[3]、[4]

ロールバック情報を取得[1]、[2]、[3]、[4]

ログサービス定義[1]

ログに取得[1]、[2]、[3]

ログメッセージ出力抑止定義[1]

ロックサービス定義[1]

ロック取得イベントを取得[1]

ロック待ちイベントを取得[1]

論理端末数上限値[1]

論理端末単位に受信メッセージの処理待ち情報を取得[1]

論理端末の登録数[1]

論理端末名称[1]、[2]

論理ファイルの指定[1]

論理ファイル名[1]、[2]