分散トランザクション処理機能 OpenTP1 プログラム作成リファレンス C言語編
OpenTP1のライブラリ関数と機能の対応を次の表に示します。
| 機能 | OpenTP1のライブラリ関数名と機能 | |
|---|---|---|
| システム運用の管理 | dc_adm_call_command | 運用コマンドの実行 |
| dc_adm_complete | ユーザサーバの開始処理完了の報告 | |
| dc_adm_status | ユーザサーバの状態の報告 | |
| マルチノード機能 | dc_adm_get_nd_status | 指定したOpenTP1ノードのステータスの取得 |
| dc_adm_get_nd_status_begin | OpenTP1ノードのステータス取得の開始 | |
| dc_adm_get_nd_status_done | OpenTP1ノードのステータス取得の終了 | |
| dc_adm_get_nd_status_next | OpenTP1ノードのステータスの取得 | |
| dc_adm_get_nodeconf_begin | ノード識別子の取得の開始 | |
| dc_adm_get_nodeconf_done | ノード識別子の取得の終了 | |
| dc_adm_get_nodeconf_next | ノード識別子の取得 | |
| dc_adm_get_node_id | 自ノードのノード識別子の取得 | |
| dc_adm_get_sv_status | 指定したユーザサーバのステータスの取得 | |
| dc_adm_get_sv_status_begin | ユーザサーバのステータス取得の開始 | |
| dc_adm_get_sv_status_done | ユーザサーバのステータス取得の終了 | |
| dc_adm_get_sv_status_next | ユーザサーバのステータスの取得 | |
| DAMファイルサービス | dc_dam_bseek | 物理ファイルのブロックの検索 |
| dc_dam_close | 論理ファイルのクローズ | |
| dc_dam_create | 物理ファイルの割り当て | |
| dc_dam_dget | 物理ファイルからブロックの直接入力 | |
| dc_dam_dput | 物理ファイルへブロックの直接出力 | |
| dc_dam_end | 回復対象外DAMファイル使用の終了 | |
| dc_dam_get | 物理ファイルからブロックの入力 | |
| dc_dam_hold | 論理ファイルの閉塞 | |
| dc_dam_iclose | 物理ファイルのクローズ | |
| dc_dam_iopen | 物理ファイルのオープン | |
| dc_dam_open | 論理ファイルのオープン | |
| dc_dam_put | 物理ファイルへブロックの出力 | |
| dc_dam_read | 論理ファイルからブロックの入力 | |
| dc_dam_release | 論理ファイルの閉塞の解除 | |
| dc_dam_rewrite | 論理ファイルのブロックの更新 | |
| dc_dam_start | 回復対象外DAMファイル使用の開始 | |
| dc_dam_status | 論理ファイルの状態の参照 | |
| dc_dam_write | 論理ファイルへブロックの出力 | |
| ISTサービス | dc_ist_close | ISTテーブルのクローズ |
| dc_ist_open | ISTテーブルのオープン | |
| dc_ist_read | ISTテーブルからレコードの入力 | |
| dc_ist_write | ISTテーブルへレコードの出力 | |
| ユーザジャーナルの取得 | dc_jnl_ujput | ユーザジャーナルの取得 |
| 資源の排他制御 | dc_lck_get | 資源の排他 |
| dc_lck_release_all | 全資源の排他の解除 | |
| dc_lck_release_byname | 資源名称を指定した排他の解除 | |
| 監査ログの出力 | dc_log_audit_print | 監査ログの出力 |
| メッセージログの出力 | dc_logprint | メッセージログの出力 |
| メッセージ送受信 | dc_mcf_adltap | アプリケーションに関するタイマ起動要求の削除 |
| dc_mcf_ap_info | アプリケーション情報通知 | |
| dc_mcf_ap_info_uoc | UOCへのアプリケーション情報通知 | |
| dc_mcf_close | MCF環境のクローズ | |
| dc_mcf_commit | MHPのコミット | |
| dc_mcf_contend | 継続問い合わせ応答の終了 | |
| dc_mcf_execap | アプリケーションプログラムの起動 | |
| dc_mcf_mainloop | MHPのサービス開始 | |
| dc_mcf_open | MCF環境のオープン | |
| dc_mcf_receive | メッセージの受信 | |
| dc_mcf_recvsync | 同期型のメッセージの受信 | |
| dc_mcf_reply | 応答メッセージの送信 | |
| dc_mcf_resend | メッセージの再送 | |
| dc_mcf_rollback | MHPのロールバック | |
| dc_mcf_send | メッセージの送信 | |
| dc_mcf_sendrecv | 同期型のメッセージの送受信 | |
| dc_mcf_sendsync | 同期型のメッセージの送信 | |
| dc_mcf_tactcn | コネクションの確立 | |
| dc_mcf_tactle | 論理端末の閉塞解除 | |
| dc_mcf_tdctcn | コネクションの解放 | |
| dc_mcf_tdctle | 論理端末の閉塞 | |
| dc_mcf_tdlqle | 論理端末の出力キュー削除 | |
| dc_mcf_tempget | 一時記憶データの受け取り | |
| dc_mcf_tempput | 一時記憶データの更新 | |
| dc_mcf_timer_set | ユーザタイマ監視の設定 | |
| dc_mcf_timer_cancel | ユーザタイマ監視の取り消し | |
| dc_mcf_tlscn | コネクションの状態取得 | |
| dc_mcf_tlscom | MCF通信サービスの状態取得 | |
| dc_mcf_tlsle | 論理端末の状態取得 | |
| dc_mcf_tlsln | サーバ型コネクションの確立要求の受付状態取得 | |
| dc_mcf_tofln | サーバ型コネクションの確立要求の受付終了 | |
| dc_mcf_tonln | サーバ型コネクションの確立要求の受付開始 | |
| 性能検証用トレース | dc_prf_get_trace_num | 性能検証用トレース取得通番の通知 |
| dc_prf_utrace_put | ユーザ固有の性能検証用トレースの取得 | |
| リモートAPI機能 | dc_rap_connect | rapリスナーとのコネクションの確立 |
| dc_rap_disconnect | rapリスナーとのコネクションの解放 | |
| リモートプロシジャコール | dc_rpc_call | 遠隔サービスの要求 |
| dc_rpc_call_to | 通信先を指定した遠隔サービスの呼び出し | |
| dc_rpc_close | アプリケーションプログラムの終了 | |
| dc_rpc_cltsend | CUPへの一方通知 | |
| dc_rpc_discard_further_replies | 処理結果の受信の拒否 | |
| dc_rpc_discard_specific_reply | 特定の処理結果の受信の拒否 | |
| dc_rpc_get_callers_address | クライアントUAPのノードアドレスの取得 | |
| dc_rpc_get_error_descriptor | エラーが発生した非同期応答型RPC要求の記述子の取得 | |
| dc_rpc_get_gateway_address | ゲートウェイのノードアドレスの取得 | |
| dc_rpc_get_service_prio | サービス要求のスケジュールプライオリティの参照 | |
| dc_rpc_get_watch_time | サービスの応答待ち時間の参照 | |
| dc_rpc_mainloop | SPPのサービス開始 | |
| dc_rpc_open | アプリケーションプログラムの開始 | |
| dc_rpc_poll_any_replies | 処理結果の非同期受信 | |
| dc_rpc_service_retry | サービス関数のリトライ | |
| dc_rpc_set_service_prio | サービス要求のスケジュールプライオリティの設定 | |
| dc_rpc_set_watch_time | サービスの応答待ち時間の更新 | |
| リアルタイム統計情報サービス | dc_rts_utrace_put | 任意区間でのリアルタイム統計情報の取得 |
| TAMファイルサービス | dc_tam_close | TAMテーブルのクローズ |
| dc_tam_delete | TAMテーブルのレコードの削除 | |
| dc_tam_get_inf | TAMテーブルの状態の取得 | |
| dc_tam_open | TAMテーブルのオープン | |
| dc_tam_read | TAMテーブルのレコードの入力 | |
| dc_tam_read_cancel | TAMテーブルのレコードの入力取り消し | |
| dc_tam_rewrite | TAMテーブルのレコード入力を前提の更新 | |
| dc_tam_status | TAMテーブルの情報の取得 | |
| dc_tam_write | TAMテーブルのレコードの更新/追加 | |
| トランザクション制御 | dc_trn_begin | トランザクションの開始 |
| dc_trn_chained_commit | 連鎖モードのコミット | |
| dc_trn_chained_rollback | 連鎖モードのロールバック | |
| dc_trn_info | 現在のトランザクションに関する情報の報告 | |
| dc_trn_unchained_commit | 非連鎖モードのコミット | |
| dc_trn_unchained_rollback | 非連鎖モードのロールバック | |
| dc_trn_rm_select | リソースマネジャ接続先選択 | |
| オンラインテスタの管理 | dc_uto_test_status | ユーザサーバのテスト状態の報告 |
SUPで使える機能と関数を次の表に示します。
表1-2 SUPで使える機能と関数
| SUPで使える機能 | OpenTP1の関数 | SUPが稼働している条件 | ||
|---|---|---|---|---|
| トランザクションの処理の範囲でない | トランザクションの処理の範囲 | |||
| システム運用の管理 | 運用コマンドの実行 | dc_adm_call_command | ○ | ○ |
| ユーザサーバの開始処理完了の報告 | dc_adm_complete | ○ | − | |
| ユーザサーバの状態の報告 | dc_adm_status | ○ | ○ | |
| マルチノード機能 | 指定したOpenTP1ノードのステータスの取得 | dc_adm_get_nd_status | ○ | ○ |
| OpenTP1ノードのステータス取得の開始 | dc_adm_get_nd_status_begin | ○ | ○ | |
| OpenTP1ノードのステータス取得の終了 | dc_adm_get_nd_status_done | ○ | ○ | |
| OpenTP1ノードのステータスの取得 | dc_adm_get_nd_status_next | ○ | ○ | |
| ノード識別子の取得の開始 | dc_adm_get_nodeconf_begin | ○ | ○ | |
| ノード識別子の取得の終了 | dc_adm_get_nodeconf_done | ○ | ○ | |
| ノード識別子の取得 | dc_adm_get_nodeconf_next | ○ | ○ | |
| 自ノードのノード識別子の取得 | dc_adm_get_node_id | ○ | ○ | |
| 指定したユーザサーバのステータスの取得 | dc_adm_get_sv_status | ○ | ○ | |
| ユーザサーバのステータス取得の開始 | dc_adm_get_sv_status_begin | ○ | ○ | |
| ユーザサーバのステータス取得の終了 | dc_adm_get_sv_status_done | ○ | ○ | |
| ユーザサーバのステータスの取得 | dc_adm_get_sv_status_next | ○ | ○ | |
| DAMファイルサービス | 論理ファイルのクローズ | dc_dam_close | ○ | ○ |
| 回復対象外DAMファイル使用の終了 | dc_dam_end | ○ | ○ | |
| 論理ファイルの閉塞 | dc_dam_hold | ○ | ○ | |
| 論理ファイルのオープン | dc_dam_open | ○ | ○ | |
| 論理ファイルからブロックの入力 | dc_dam_read | ○ | ○ | |
| 論理ファイルの閉塞の解除 | dc_dam_release | ○ | ○ | |
| 論理ファイルのブロックの更新 | dc_dam_rewrite | (○) | ○ | |
| 回復対象外DAMファイル使用の開始 | dc_dam_start | ○ | ○ | |
| 論理ファイルの状態の参照 | dc_dam_status | ○ | ○ | |
| 論理ファイルへブロックの出力 | dc_dam_write | (○) | ○ | |
| ISTサービス | ISTテーブルのクローズ | dc_ist_close | ○ | ○ |
| ISTテーブルのオープン | dc_ist_open | ○ | ○ | |
| ISTテーブルからレコードの入力 | dc_ist_read | ○ | ○ | |
| ISTテーブルへレコードの出力 | dc_ist_write | ○ | ○ | |
| ユーザジャーナルの取得 | ユーザジャーナルの取得 | dc_jnl_ujput | ○ | ○ |
| 資源の排他制御 | 資源の排他 | dc_lck_get | − | ○ |
| 全資源の排他の解除 | dc_lck_release_all | − | ○ | |
| 資源名称を指定した排他の解除 | dc_lck_release_byname | − | ○ | |
| 監査ログの出力 | 監査ログの出力 | dc_log_audit_print | ○ | ○ |
| メッセージログの出力 | メッセージログの出力 | dc_logprint | ○ | ○ |
| 性能検証用トレース | 性能検証用トレース取得通番の通知 | dc_prf_get_trace_num | ○ | ○ |
| ユーザ固有の性能検証用トレースの取得 | dc_prf_utrace_put | ○ | ○ | |
| リモートAPI機能 | rapリスナーとのコネクションの確立 | dc_rap_connect | ○ | − |
| rapリスナーとのコネクションの解放 | dc_rap_disconnect | ○ | − | |
| リモートプロシジャコール | 遠隔サービスの要求 | dc_rpc_call | ○ | ○ |
| 通信先を指定した遠隔サービスの呼び出し | dc_rpc_call_to | ○ | ○ | |
| アプリケーションプログラムの終了 | dc_rpc_close | ○ | − | |
| 処理結果の受信の拒否 | dc_rpc_discard_further_replies | ○ | ○ | |
| 特定の処理結果の受信の拒否 | dc_rpc_discard_specific_reply | ○ | ○ | |
| エラーが発生した非同期応答型RPC要求の記述子の取得 | dc_rpc_get_error_descriptor | ○ | ○ | |
| サービス要求のスケジュールプライオリティの参照 | dc_rpc_get_service_prio | ○ | ○ | |
| サービス要求の応答待ち時間の参照 | dc_rpc_get_watch_time | ○ | ○ | |
| アプリケーションプログラムの開始 | dc_rpc_open | ○ | − | |
| 処理結果の非同期受信 | dc_rpc_poll_any_replies | ○ | ○ | |
| サービス要求のスケジュールプライオリティの設定 | dc_rpc_set_service_prio | ○ | ○ | |
| サービス要求の応答待ち時間の更新 | dc_rpc_set_watch_time | ○ | ○ | |
| リアルタイム統計情報サービス | 任意区間でのリアルタイム統計情報の取得 | dc_rts_utrace_put | ○ | ○ |
| TAMファイルサービス | TAMテーブルのクローズ | dc_tam_close | ○ | ○ |
| TAMテーブルのレコードの削除 | dc_tam_delete | − | ○ | |
| TAMテーブルの状態の取得 | dc_tam_get_inf | ○ | ○ | |
| TAMテーブルのオープン | dc_tam_open | ○ | ○ | |
| TAMテーブルのレコードの入力 | dc_tam_read | − | ○ | |
| TAMテーブルのレコードの入力取り消し | dc_tam_read_cancel | − | ○ | |
| TAMテーブルのレコード入力を前提の更新 | dc_tam_rewrite | − | ○ | |
| TAMテーブルの情報の取得 | dc_tam_status | ○ | ○ | |
| TAMテーブルのレコードの更新/追加 | dc_tam_write | − | ○ | |
| トランザクション制御 | トランザクションの開始 | dc_trn_begin | ○ | − |
| 連鎖モードのコミット | dc_trn_chained_commit | − | ○ | |
| 連鎖モードのロールバック | dc_trn_chained_rollback | − | ○ | |
| 現在のトランザクションに関する情報の出力 | dc_trn_info | ○ | ○ | |
| 非連鎖モードのコミット | dc_trn_unchained_commit | − | ○ | |
| 非連鎖モードのロールバック | dc_trn_unchained_rollback | − | ○ | |
| リソースマネジャ接続先選択 | dc_trn_rm_select | ○ | − | |
| オンラインテスタの管理 | ユーザサーバのテスト状態の報告 | dc_uto_test_status | ○ | ○ |
SPPで使える機能と関数を次の表に示します。
表1-3 SPPで使える機能と関数
| SPPで使える機能 | OpenTP1の関数 | SPPが稼働している条件 | |||
|---|---|---|---|---|---|
| トランザクションの処理の 範囲でない |
トランザクションの範囲 | ||||
| ルート | ルート以外 | ||||
| システム運用の管理 | 運用コマンドの実行 | dc_adm_call_command | ○ | ○ | ○ |
| ユーザサーバの状態の報告 | dc_adm_status | ○ | ○ | ○ | |
| マルチノード機能 | 指定したOpenTP1ノードのステータスの取得 | dc_adm_get_nd_status | ○ | ○ | ○ |
| OpenTP1ノードのステータス取得の開始 | dc_adm_get_nd_status_begin | ○ | ○ | ○ | |
| OpenTP1ノードのステータス取得の終了 | dc_adm_get_nd_status_done | ○ | ○ | ○ | |
| OpenTP1ノードのステータスの取得 | dc_adm_get_nd_status_next | ○ | ○ | ○ | |
| ノード識別子の取得の開始 | dc_adm_get_nodeconf_begin | ○ | ○ | ○ | |
| ノード識別子の取得の終了 | dc_adm_get_nodeconf_done | ○ | ○ | ○ | |
| ノード識別子の取得 | dc_adm_get_nodeconf_next | ○ | ○ | ○ | |
| 自ノードのノード識別子の取得 | dc_adm_get_node_id | ○ | ○ | ○ | |
| 指定したユーザサーバのステータスの取得 | dc_adm_get_sv_status | ○ | ○ | ○ | |
| ユーザサーバのステータス取得の開始 | dc_adm_get_sv_status_begin | ○ | ○ | ○ | |
| ユーザサーバのステータス取得の終了 | dc_adm_get_sv_status_done | ○ | ○ | ○ | |
| ユーザサーバのステータスの取得 | dc_adm_get_sv_status_next | ○ | ○ | ○ | |
| DAMファイルサービス | 論理ファイルのクローズ | dc_dam_close | ○ | ○ | ○ |
| 回復対象外DAMファイル使用の終了 | dc_dam_end | ○ | ○ | ○ | |
| 論理ファイルの閉塞 | dc_dam_hold | ○ | ○ | ○ | |
| 論理ファイルのオープン | dc_dam_open | ○ | ○ | ○ | |
| 論理ファイルからブロックの入力 | dc_dam_read | ○ | ○ | ○ | |
| 論理ファイルの閉塞の解除 | dc_dam_release | ○ | ○ | ○ | |
| 論理ファイルのブロックの更新 | dc_dam_rewrite | (○) | ○ | ○ | |
| 回復対象外DAMファイル使用の開始 | dc_dam_start | ○ | ○ | ○ | |
| 論理ファイルの状態の参照 | dc_dam_status | ○ | ○ | ○ | |
| 論理ファイルへブロックの出力 | dc_dam_write | (○) | ○ | ○ | |
| ISTサービス | ISTテーブルのクローズ | dc_ist_close | ○ | ○ | ○ |
| ISTテーブルのオープン | dc_ist_open | ○ | ○ | ○ | |
| ISTテーブルからレコードの入力 | dc_ist_read | ○ | ○ | ○ | |
| ISTテーブルへレコードの出力 | dc_ist_write | ○ | ○ | ○ | |
| ユーザジャーナルの取得 | ユーザジャーナルの取得 | dc_jnl_ujput | ○ | ○ | ○ |
| 資源の排他制御 | 資源の排他 | dc_lck_get | − | ○ | ○ |
| 全資源の排他の解除 | dc_lck_release_all | − | ○ | ○ | |
| 資源名称を指定した排他の解除 | dc_lck_release_byname | − | ○ | ○ | |
| 監査ログの出力 | 監査ログの出力 | dc_log_audit_print | ○ | ○ | ○ |
| メッセージログの出力 | メッセージログの出力 | dc_logprint | ○ | ○ | ○ |
| メッセージ送受信 | アプリケーションに関するタイマ起動要求の削除 | dc_mcf_adltap | ○ | ○ | ○ |
| MCF環境のクローズ | dc_mcf_close | ○M | − | − | |
| アプリケーションプログラムの起動 | dc_mcf_execap | − | ○ | ○ | |
| MCF環境のオープン | dc_mcf_open | ○M | − | − | |
| 同期型のメッセージの受信 | dc_mcf_recvsync | ○ | ○ | ○ | |
| メッセージの再送 | dc_mcf_resend | − | ○ | ○ | |
| メッセージの送信 | dc_mcf_send | − | ○ | ○ | |
| 同期型のメッセージの送受信 | dc_mcf_sendrecv | ○ | ○ | ○ | |
| 同期型のメッセージの送信 | dc_mcf_sendsync | ○ | ○ | ○ | |
| コネクションの確立 | dc_mcf_tactcn | ○ | ○ | ○ | |
| 論理端末の閉塞解除 | dc_mcf_tactle | ○ | ○ | ○ | |
| コネクションの解放 | dc_mcf_tdctcn | ○ | ○ | ○ | |
| 論理端末の閉塞 | dc_mcf_tdctle | ○ | ○ | ○ | |
| 論理端末の出力キュー削除 | dc_mcf_tdlqle | ○ | ○ | ○ | |
| ユーザタイマ監視の設定 | dc_mcf_timer_set | ○ | ○ | ○ | |
| ユーザタイマ監視の取り消し | dc_mcf_timer_cancel | ○ | ○ | ○ | |
| コネクションの状態取得 | dc_mcf_tlscn | ○ | ○ | ○ | |
| MCF通信サービスの状態取得 | dc_mcf_tlscom | ○ | ○ | ○ | |
| 論理端末の状態取得 | dc_mcf_tlsle | ○ | ○ | ○ | |
| サーバ型コネクションの確立要求の受付状態取得 | dc_mcf_tlsln | ○ | ○ | ○ | |
| サーバ型コネクションの確立要求の受付終了 | dc_mcf_tofln | ○ | ○ | ○ | |
| サーバ型コネクションの確立要求の受付開始 | dc_mcf_tonln | ○ | ○ | ○ | |
| 性能検証用トレース | 性能検証用トレース取得通番の通知 | dc_prf_get_trace_num | ○ | ○ | ○ |
| ユーザ固有の性能検証用トレースの取得 | dc_prf_utrace_put | ○ | ○ | ○ | |
| リモートAPI機能 | rapリスナーとのコネクションの確立 | dc_rap_connect | ○ | − | − |
| rapリスナーとのコネクションの解放 | dc_rap_disconnect | ○ | − | − | |
| リモートプロシジャコール | 遠隔サービスの要求 | dc_rpc_call | ○ | ○ | ○ |
| 通信先を指定した遠隔サービスの呼び出し | dc_rpc_call_to | ○ | ○ | ○ | |
| アプリケーションプログラムの終了 | dc_rpc_close | ○M | − | − | |
| CUPへの一方通知 | dc_rpc_cltsend | ○ | ○ | ○ | |
| 処理結果の受信の拒否 | dc_rpc_discard_further_replies | ○ | ○ | ○ | |
| 特定の処理結果の受信の拒否 | dc_rpc_discard_specific_reply | ○ | ○ | ○ | |
| クライアントUAPのノードアドレスの取得 | dc_rpc_get_callers_address | ○ | ○ | ○ | |
| エラーが発生した非同期応答型RPC要求の記述子の取得 | dc_rpc_get_error_descriptor | ○ | ○ | ○ | |
| ゲートウェイのノードアドレスの取得 | dc_rpc_get_gateway_address | ○ | ○ | ○ | |
| サービス要求のスケジュールプライオリティの参照 | dc_rpc_get_service_prio | ○ | ○ | ○ | |
| サービス要求の応答待ち時間の参照 | dc_rpc_get_watch_time | ○ | ○ | ○ | |
| SPPのサービス開始 | dc_rpc_mainloop | ○M | − | − | |
| アプリケーションプログラムの開始 | dc_rpc_open | ○M | − | − | |
| 処理結果の非同期受信 | dc_rpc_poll_any_replies | ○ | ○ | ○ | |
| サービス関数のリトライ | dc_rpc_service_retry | ○ | − | − | |
| サービス要求のスケジュールプライオリティの設定 | dc_rpc_set_service_prio | ○ | ○ | ○ | |
| サービス要求の応答待ち時間の更新 | dc_rpc_set_watch_time | ○ | ○ | ○ | |
| リアルタイム統計情報サービス | 任意区間でのリアルタイム統計情報の取得 | dc_rts_utrace_put | ○ | ○ | ○ |
| TAMファイルサービス | TAMテーブルのクローズ | dc_tam_close | ○ | ○ | ○ |
| TAMテーブルのレコードの削除 | dc_tam_delete | − | ○ | ○ | |
| TAMテーブルの状態の取得 | dc_tam_get_inf | ○ | ○ | ○ | |
| TAMテーブルのオープン | dc_tam_open | ○ | ○ | ○ | |
| TAMテーブルのレコードの入力 | dc_tam_read | − | ○ | ○ | |
| TAMテーブルのレコードの入力取り消し | dc_tam_read_cancel | − | ○ | ○ | |
| TAMテーブルのレコード入力を前提の更新 | dc_tam_rewrite | − | ○ | ○ | |
| TAMテーブルの情報の取得 | dc_tam_status | ○ | ○ | ○ | |
| TAMテーブルのレコードの更新/追加 | dc_tam_write | − | ○ | ○ | |
| トランザクション制御 | トランザクションの開始 | dc_trn_begin | ○ | − | − |
| 連鎖モードのコミット | dc_trn_chained_commit | − | ○ | − | |
| 連鎖モードのロールバック | dc_trn_chained_rollback | − | ○ | − | |
| 現在のトランザクションに関する情報の報告 | dc_trn_info | ○ | ○ | ○ | |
| 非連鎖モードのコミット | dc_trn_unchained_commit | − | ○ | − | |
| 非連鎖モードのロールバック | dc_trn_unchained_rollback | − | ○ | ○ | |
| リソースマネジャ接続先選択 | dc_trn_rm_select | ○ | − | − | |
| オンラインテスタの管理 | ユーザサーバのテスト状態の報告 | dc_uto_test_status | ○ | ○ | ○ |
MHPで使える機能と関数を次の表に示します。
表1-4 MHPで使える機能と関数
| MHPで使える機能 | OpenTP1の関数 | MHPが稼働している条件 | ||
|---|---|---|---|---|
| トランザクションの処理の範囲でない | トランザクションの処理の範囲 | |||
| システム運用の管理 | 運用コマンドの実行 | dc_adm_call_command | ○ | ○ |
| ユーザサーバの状態の報告 | dc_adm_status | ○ | ○ | |
| マルチノード機能 | 指定したOpenTP1ノードのステータスの取得 | dc_adm_get_nd_status | ○ | ○ |
| OpenTP1ノードのステータス取得の開始 | dc_adm_get_nd_status_begin | ○ | ○ | |
| OpenTP1ノードのステータス取得の終了 | dc_adm_get_nd_status_done | ○ | ○ | |
| OpenTP1ノードのステータスの取得 | dc_adm_get_nd_status_next | ○ | ○ | |
| ノード識別子の取得の開始 | dc_adm_get_nodeconf_begin | ○ | ○ | |
| ノード識別子の取得の終了 | dc_adm_get_nodeconf_done | ○ | ○ | |
| ノード識別子の取得 | dc_adm_get_nodeconf_next | ○ | ○ | |
| 自ノードのノード識別子の取得 | dc_adm_get_node_id | ○ | ○ | |
| 指定したユーザサーバのステータスの取得 | dc_adm_get_sv_status | ○ | ○ | |
| ユーザサーバのステータス取得の開始 | dc_adm_get_sv_status_begin | ○ | ○ | |
| ユーザサーバのステータス取得の終了 | dc_adm_get_sv_status_done | ○ | ○ | |
| ユーザサーバのステータスの取得 | dc_adm_get_sv_status_next | ○ | ○ | |
| DAMファイルサービス | 論理ファイルのクローズ | dc_dam_close | ○ | ○ |
| 回復対象外DAMファイル使用の終了 | dc_dam_end | ○ | ○ | |
| 論理ファイルの閉塞 | dc_dam_hold | ○ | ○ | |
| 論理ファイルのオープン | dc_dam_open | ○ | ○ | |
| 論理ファイルからブロックの入力 | dc_dam_read | ○ | ○ | |
| 論理ファイルの閉塞の解除 | dc_dam_release | ○ | ○ | |
| 論理ファイルのブロックの更新 | dc_dam_rewrite | (○) | ○ | |
| 回復対象外DAMファイル使用の開始 | dc_dam_start | ○ | ○ | |
| 論理ファイルの状態の参照 | dc_dam_status | ○ | ○ | |
| 論理ファイルへブロックの出力 | dc_dam_write | (○) | ○ | |
| ISTサービス | ISTテーブルのクローズ | dc_ist_close | ○ | ○ |
| ISTテーブルのオープン | dc_ist_open | ○ | ○ | |
| ISTテーブルからレコードの入力 | dc_ist_read | ○ | ○ | |
| ISTテーブルへレコードの出力 | dc_ist_write | ○ | ○ | |
| ユーザジャーナルの取得 | ユーザジャーナルの取得 | dc_jnl_ujput | ○ | ○ |
| 資源の排他制御 | 資源の排他 | dc_lck_get | − | ○ |
| 全資源の排他の解除 | dc_lck_release_all | − | ○ | |
| 資源名称を指定した排他の解除 | dc_lck_release_byname | − | ○ | |
| 監査ログの出力 | 監査ログの出力 | dc_log_audit_print | ○ | ○ |
| メッセージログの出力 | メッセージログの出力 | dc_logprint | ○ | ○ |
| メッセージ送受信 | アプリケーションに関するタイマ起動要求の削除 | dc_mcf_adltap | ○ | ○ |
| アプリケーション情報通知 | dc_mcf_ap_info | ○NO | ○ | |
| MCF環境のクローズ | dc_mcf_close | ○M | ○M | |
| MHPのコミット | dc_mcf_commit | − | ○ | |
| 継続問い合わせ応答の終了 | dc_mcf_contend | ○NO | ○ | |
| アプリケーションプログラムの起動 | dc_mcf_execap | ○NO | ○ | |
| MHPのサービス開始 | dc_mcf_mainloop | ○M | − | |
| MCF環境のオープン | dc_mcf_open | ○M | ○M | |
| メッセージの受信 | dc_mcf_receive | ○NO | ○ | |
| 同期型のメッセージの受信 | dc_mcf_recvsync | ○ | ○ | |
| 応答メッセージの送信 | dc_mcf_reply | ○NO | ○ | |
| メッセージの再送 | dc_mcf_resend | − | ○ | |
| MHPのロールバック | dc_mcf_rollback | − | ○ | |
| メッセージの送信 | dc_mcf_send | ○NO | ○ | |
| 同期型のメッセージの送受信 | dc_mcf_sendrecv | ○ | ○ | |
| 同期型のメッセージの送信 | dc_mcf_sendsync | ○ | ○ | |
| コネクションの確立 | dc_mcf_tactcn | ○ | ○ | |
| 論理端末の閉塞解除 | dc_mcf_tactle | ○ | ○ | |
| コネクションの解放 | dc_mcf_tdctcn | ○ | ○ | |
| 論理端末の閉塞 | dc_mcf_tdctle | ○ | ○ | |
| 論理端末の出力キュー削除 | dc_mcf_tdlqle | ○ | ○ | |
| 一時記憶データの受け取り | dc_mcf_tempget | ○NO | ○ | |
| 一時記憶データの更新 | dc_mcf_tempput | ○NO | ○ | |
| ユーザタイマ監視の設定 | dc_mcf_timer_set | ○ | ○ | |
| ユーザタイマ監視の取り消し | dc_mcf_timer_cancel | ○ | ○ | |
| コネクションの状態取得 | dc_mcf_tlscn | ○ | ○ | |
| MCF通信サービスの状態取得 | dc_mcf_tlscom | ○ | ○ | |
| 論理端末の状態取得 | dc_mcf_tlsle | ○ | ○ | |
| サーバ型コネクションの確立要求の受付状態取得 | dc_mcf_tlsln | ○ | ○ | |
| サーバ型コネクションの確立要求の受付終了 | dc_mcf_tofln | ○ | ○ | |
| サーバ型コネクションの確立要求の受付開始 | dc_mcf_tonln | ○ | ○ | |
| 性能検証用トレース | 性能検証用トレース取得通番の通知 | dc_prf_get_trace_num | ○ | ○ |
| ユーザ固有の性能検証用トレースの取得 | dc_prf_utrace_put | ○ | ○ | |
| リモートAPI機能 | rapリスナーとのコネクションの確立 | dc_rap_connect | ○ | − |
| rapリスナーとのコネクションの解放 | dc_rap_disconnect | ○ | − | |
| リモートプロシジャコール | 遠隔サービスの要求 | dc_rpc_call | ○ | ○ |
| 通信先を指定した遠隔サービスの呼び出し | dc_rpc_call_to | ○ | ○ | |
| アプリケーションプログラムの終了 | dc_rpc_close | ○M | − | |
| CUPへの一方通知 | dc_rpc_cltsend | ○ | ○ | |
| 処理結果の受信の拒否 | dc_rpc_discard_further_replies | ○ | ○ | |
| 特定の処理結果の受信の拒否 | dc_rpc_discard_specific_reply | ○ | ○ | |
| エラーが発生した非同期応答型RPC 要求の記述子の取得 |
dc_rpc_get_error_descriptor | ○ | ○ | |
| サービス要求のスケジュールプライオリティの参照 | dc_rpc_get_service_prio | ○ | ○ | |
| サービス要求の応答待ち時間の参照 | dc_rpc_get_watch_time | ○ | ○ | |
| アプリケーションプログラムの開始 | dc_rpc_open | ○M | − | |
| 処理結果の非同期受信 | dc_rpc_poll_any_replies | ○ | ○ | |
| サービス要求のスケジュールプライオリティの設定 | dc_rpc_set_service_prio | ○ | ○ | |
| サービス要求の応答待ち時間の更新 | dc_rpc_set_watch_time | ○ | ○ | |
| リアルタイム統計情報サービス | 任意区間でのリアルタイム統計情報の取得 | dc_rts_utrace_put | ○ | ○ |
| TAMファイルサービス | TAMテーブルのクローズ | dc_tam_close | ○ | ○ |
| TAMテーブルのレコードの削除 | dc_tam_delete | − | ○ | |
| TAMテーブルの状態の取得 | dc_tam_get_inf | ○ | ○ | |
| TAMテーブルのオープン | dc_tam_open | ○ | ○ | |
| TAMテーブルのレコードの入力 | dc_tam_read | − | ○ | |
| TAMテーブルのレコードの入力取り消し | dc_tam_read_cancel | − | ○ | |
| TAMテーブルのレコード入力を前提の更新 | dc_tam_rewrite | − | ○ | |
| TAMテーブルの情報の取得 | dc_tam_status | ○ | ○ | |
| TAMテーブルのレコードの更新/追加 | dc_tam_write | − | ○ | |
| トランザクション制御 | トランザクションの開始 | dc_trn_begin | ○M | − |
| 現在のトランザクションに関する情報の出力 | dc_trn_info | ○ | ○ | |
| 非連鎖モードのコミット | dc_trn_unchained_commit | − | ○M | |
| 非連鎖モードのロールバック | dc_trn_unchained_rollback | − | ○M | |
| リソースマネジャ接続先選択 | dc_trn_rm_select | − | − | |
| オンラインテスタの管理 | ユーザサーバのテスト状態の報告 | dc_uto_test_status | ○ | ○ |
オフラインの業務をするUAPで使える機能と関数を次の表に示します。
表1-5 オフラインの業務をするUAPで使える機能と関数
| オフラインの業務をするUAPで使える機能 | OpenTP1の関数 | |
|---|---|---|
| DAMファイルサービス | 物理ファイルのブロックの検索 | dc_dam_bseek |
| 物理ファイルの割り当て | dc_dam_create | |
| 物理ファイルからブロックの直接入力 | dc_dam_dget | |
| 物理ファイルへブロックの直接出力 | dc_dam_dput | |
| 物理ファイルからブロックの入力 | dc_dam_get | |
| 物理ファイルのクローズ | dc_dam_iclose | |
| 物理ファイルのオープン | dc_dam_iopen | |
| 物理ファイルへブロックの出力 | dc_dam_put | |
| 性能検証用トレース | 性能検証用トレース取得通番の通知 | dc_prf_get_trace_num |
| ユーザ固有の性能検証用トレースの取得 | dc_prf_utrace_put | |
All Rights Reserved. Copyright (C) 2006, 2012, Hitachi, Ltd.