分散トランザクション処理機能 OpenTP1 使用の手引 Windows(R)編

[目次][索引][前へ][次へ]

3.1 関数の一覧

Windows版OpenTP1は,UNIX版OpenTP1と比べて,使用できるOpenTP1の関数が異なります。また,一部の関数では,引数や設定値をサポートしていないなどの制限事項があります。Windows版OpenTP1を初めて使用する場合は,ここで示す一覧表でUNIX版OpenTP1との差異があるかどうかを確認してください。

この一覧表の内容を確認した上で,関数の詳細については,マニュアル「OpenTP1 プログラム作成リファレンス」の該当する言語編を参照してください。

注意
この一覧表では,メッセージキューイング機能(TP1/Message Queue)の関数について説明していません。マニュアル「TP1/Message Queue 使用の手引」を参照してください。

一覧表で使用している記号の凡例を次に示します。

(凡例)
◎:UNIX版OpenTP1と同じ機能をサポートしています。
△:UNIX版OpenTP1との機能差異やWindows版OpenTP1での制限事項があります。
×:サポートしていません。
−:該当しません。

Windows版OpenTP1とUNIX版OpenTP1の関数の差異を,次に示します。

表3-1 Windows版OpenTP1とUNIX版OpenTP1の関数の差異

機能 関数名 Windows版OpenTP1でのサポートの有無 UNIX版OpenTP1との差異
リモートプロシジャコール アプリケーションプログラムの開始 dc_rpc_open
CBLDCRPC('OPEN ')
SPPのサービス開始 dc_rpc_mainloop
CBLDCRSV('MAINLOOP')
遠隔サービスの要求 dc_rpc_call
CBLDCRPC('CALL ')
flagsのDCRPC_DOMAINの設定はサポートしていません。
通信先を指定した遠隔サービスの呼び出し dc_rpc_call_to
処理結果の非同期受信 dc_rpc_poll_any_replies
CBLDCRPC('POLLANYR')
エラーが発生した非同期RPC要求の記述子の取得 dc_rpc_get_error_descriptor
CBLDCRPC('GETERDES')
処理結果の受信の拒否 dc_rpc_discard_further_replies
CBLDCRPC('DISCARDF')
非同期応答型RPCの特定応答電文廃棄 dc_rpc_discard_specific_reply
CBLDCRPC('DISCARDS')
サービス関数のリトライ dc_rpc_service_retry
CBLDCRPC('SVRETRY')
サービス要求のスケジュールプライオリティの設定 dc_rpc_set_service_prio
CBLDCRPC('SETSVPRI')
サービス要求のスケジュールプライオリティの参照 dc_rpc_get_service_prio
CBLDCRPC('GETSVPRI')
サービスの応答待ち時間の参照 dc_rpc_get_watch_time
CBLDCRPC('GETWATCH')
サービスの応答待ち時間の更新 dc_rpc_set_watch_time
CBLDCRPC('SETWATCH')
クライアントUAPのノードアドレスの取得 dc_rpc_get_callers_address
CBLDCRPC('GETCLADR')
ゲートウェイのノードアドレスの取得 dc_rpc_get_gateway_address
CBLDCRPC('GETGWADR')
CUPへの一方通知 dc_rpc_cltsend
CBLDCRPC('CLTSEND ')
アプリケーションプログラムの終了 dc_rpc_close
CBLDCRPC('CLOSE ')
リモートAPI機能 rapリスナーとのコネクション確立 dc_rap_connect
CBLDCRAP('CONNECT ')
CBLDCRAP('CONNECTX')
rapリスナーとのコネクション解放 dc_rap_disconnect
CBLDCRAP('DISCNCT ')
トランザクション制御 トランザクションの開始 dc_trn_begin
CBLDCTRN('BEGIN ')
連鎖モードのコミット dc_trn_chained_commit
CBLDCTRN('C-COMMIT')
連鎖モードのロールバック dc_trn_chained_rollback
CBLDCTRN('C-ROLL ')
非連鎖モードのコミット dc_trn_unchained_commit
CBLDCTRN('U-COMMIT')
非連鎖モードのロールバック dc_trn_unchained_rollback
CBLDCTRN('U-ROLL ')
現在のトランザクションに関する情報の報告 dc_trn_info
CBLDCTRN('INFO ')
リソースマネジャ接続先選択 dc_trn_rm_select
CBLDCTRN('RMSELECT')
システム運用の管理 運用コマンドの実行 dc_adm_call_command
CBLDCADM('COMMAND ')

  • flagsのDCADM_DELAYの設定はサポートしていません。
  • 指定した文字列中に'/',または'$'を含む場合,指定した文字列に対してOpenTP1内部で独自の文字列変換処理を実行します。OpenTP1が行う文字列変換処理を無効にして,指定したとおりにコマンドを実行したい場合は,ユーザサービス定義,またはユーザサービスデフォルト定義に次の環境変数を設定してください。
    putenv DCADMCONVSEP 1
  • 文字列の末尾に'&'を指定した場合のコマンドの非同期実行は,サポートしていません。
  • dc_adm_call_command関数の第1引数comに指定できる文字列の長さは500バイト以下です。501バイト以上指定するとdc_adm_call_command関数はDCADMER_PARAMをリターンします。
  • CBLDCADM('COMMAND ')のデータ名Gに指定できる文字列の長さは500バイト以下です。501バイト以上指定するとCBLDCADM('COMMAND ')はステータスコードに01802を設定します。
  • DMLインタフェースのSEND(運用コマンドの実行)の一意名1のデータ名4に指定できる文字列の長さは500バイト以下です。501バイト以上指定するとSENDはステータスコードに01802を設定します。
ユーザサーバの開始処理完了の報告 dc_adm_complete
CBLDCADM('COMPLETE')
ユーザサーバの状態の報告 dc_adm_status
CBLDCADM('STATUS ')
監査ログの出力 監査ログの出力 dc_log_audit_print
CBLDCADT('PRINT ')
メッセージログの出力 メッセージログの出力 dc_logprint
CBLDCLOG('PRINT ')
colorの設定はサポートしていません。
メッセージログの通知 メッセージログ通知の受信の終了 dc_log_notify_close
メッセージログ通知の受信の開始 dc_log_notify_open
メッセージログ通知の受信 dc_log_notify_receive
ユーザ作成メッセージログの送信 dc_log_notify_send
ユーザジャーナルの取得 ユーザジャーナルの取得 dc_jnl_ujput
CBLDCJNL('UJPUT ')
ジャーナルデータの編集 jnlrput出力ファイルのクローズ
CBLDCJUP('CLOSERPT')
jnlrput出力ファイルのオープン
CBLDCJUP('OPENRPT ')
jnlrput出力ファイルからジャーナルデータの入力
CBLDCJUP('RDGETRPT')
メッセージ送受信 MCF環境のオープン dc_mcf_open
CBLDCMCF('OPEN ')
MHPのサービス開始 dc_mcf_mainloop
CBLDCMCF('MAINLOOP')
メッセージの受信 dc_mcf_receive
CBLDCMCF('RECEIVE ')
応答メッセージの送信 dc_mcf_reply
CBLDCMCF('REPLY ')
メッセージの送信 dc_mcf_send
CBLDCMCF('SEND ')
メッセージの再送 dc_mcf_resend
CBLDCMCF('RESEND ')
同期型のメッセージ受信 dc_mcf_recvsync
CBLDCMCF('RECVSYNC')
同期型のメッセージ送信 dc_mcf_sendsync
CBLDCMCF('SENDSYNC')
同期型のメッセージ送受信 dc_mcf_sendrecv
CBLDCMCF('SENDRECV')
一時記憶データの受け取り dc_mcf_tempget
CBLDCMCF('TEMPGET ')
一時記憶データの更新 dc_mcf_tempput
CBLDCMCF('TEMPPUT ')
継続問い合わせ応答の終了 dc_mcf_contend
CBLDCMCF('CONTEND ')
アプリケーションプログラムの起動 dc_mcf_execap
CBLDCMCF('EXECAP ')
アプリケーション情報通知 dc_mcf_ap_info
CBLDCMCF('APINFO ')
UOCへのアプリケーション情報通知 dc_mcf_ap_info_uoc
ユーザタイマ監視の設定 dc_mcf_timer_set
CBLDCMCF('TIMERSET')
ユーザタイマ監視の取り消し dc_mcf_timer_cancel
CBLDCMCF('TIMERCAN')
MHPのコミット dc_mcf_commit
CBLDCMCF('COMMIT ')
MHPのロールバック dc_mcf_rollback
CBLDCMCF('ROLLBACK')
MCF環境のクローズ dc_mcf_close
CBLDCMCF('CLOSE ')
MCF通信サービスの状態取得 dc_mcf_tlscom
CBLDCMCF('TLSCOM ')
コネクションの状態取得 dc_mcf_tlscn
CBLDCMCF('TLSCN ')
コネクションの確立 dc_mcf_tactcn
CBLDCMCF('TACTCN ')
コネクションの解放 dc_mcf_tdctcn
CBLDCMCF('TDCTCN ')
サーバ型コネクションの確立要求の受付状態取得 dc_mcf_tlsln
CBLDCMCF('TLSLN ')
サーバ型コネクションの確立要求の受付開始 dc_mcf_tonln
CBLDCMCF('TONLN ')
サーバ型コネクションの確立要求の受付終了 dc_mcf_tofln
CBLDCMCF('TOFLN ')
アプリケーションに関するタイマ起動要求の削除 dc_mcf_adltap
CBLDCMCF('ADLTAP ')
論理端末の状態取得 dc_mcf_tlsle
CBLDCMCF('TLSLE ')
論理端末の閉塞 dc_mcf_tdctle
CBLDCMCF('TDCTLE ')
論理端末の閉塞解除 dc_mcf_tactle
CBLDCMCF('TACTLE ')
論理端末の出力キュー削除 dc_mcf_tdlqle
CBLDCMCF('TDLQLE ')
DAMファイルサービス 論理ファイルのオープン dc_dam_open
CBLDCDAM('DCDAMSVC','OPEN')
論理ファイルからブロックの入力 dc_dam_read
CBLDCDAM('DCDAMSVC','READ')
論理ファイルのブロックの更新 dc_dam_rewrite
CBLDCDAM('DCDAMSVC','REWT')
論理ファイルへブロックの出力 dc_dam_write
CBLDCDAM('DCDAMSVC','WRIT')
論理ファイルのクローズ dc_dam_close
CBLDCDAM('DCDAMSVC','CLOS')
論理ファイルの閉塞 dc_dam_hold
CBLDCDAM('DCDAMSVC','HOLD')
論理ファイルの閉塞の解除 dc_dam_release
CBLDCDAM('DCDAMSVC','RLES')
論理ファイルの状態の参照 dc_dam_status
CBLDCDAM('DCDAMSVC','STAT')
回復対象外DAMファイル使用の開始 dc_dam_start
CBLDCDAM('DCDAMSVC','STRT')
回復対象外DAMファイル使用の終了 dc_dam_end
CBLDCDAM('DCDAMSVC','END ')
物理ファイルの割り当て dc_dam_create
CBLDCDMB('DCDAMINT','CRAT')
物理ファイルのオープン dc_dam_iopen
CBLDCDMB('DCDAMINT','OPEN')
物理ファイルからブロックの入力 dc_dam_get
CBLDCDMB('DCDAMINT','GET ')
物理ファイルへブロックの出力 dc_dam_put
CBLDCDMB('DCDAMINT','PUT ')
物理ファイルのブロックの検索 dc_dam_bseek
CBLDCDMB('DCDAMINT','BSEK')
物理ファイルからブロックの直接入力 dc_dam_dget
CBLDCDMB('DCDAMINT','DGET')
物理ファイルへブロックの直接出力 dc_dam_dput
CBLDCDMB('DCDAMINT','DPUT')
物理ファイルのクローズ dc_dam_iclose
CBLDCDMB('DCDAMINT','CLOS')
TAMファイルサービス TAMテーブルのオープン dc_tam_open
TAMテーブルからレコードの入力 dc_tam_read
CBLDCTAM('FxxR')('FxxU')
TAMテーブルのレコード入力を前提の更新 dc_tam_rewrite
CBLDCTAM('MFY ')('MFYS')('STR ')
TAMテーブルのレコードの更新/追加 dc_tam_write
CBLDCTAM('MFY ')('MFYS')('STR ')
TAMテーブルのレコードの削除 dc_tam_delete
CBLDCTAM('ERS ')('ERSR')
TAMテーブルのレコードの入力取り消し dc_tam_read_cancel
TAMテーブルの状態の取得 dc_tam_get_inf
CBLDCTAM('GST ')
TAMテーブルの情報の取得 dc_tam_status
CBLDCTAM('INFO')
TAMテーブルのクローズ dc_tam_close
ISTサービス ISTテーブルのオープン dc_ist_open
CBLDCIST('DCISTSVC','OPEN')
× ISTサービスはサポートしていません。
ISTテーブルからレコードの入力 dc_ist_read
CBLDCIST('DCISTSVC','READ')
×
ISTテーブルへレコードの出力 dc_ist_write
CBLDCIST('DCISTSVC','WRIT')
×
ISTテーブルのクローズ dc_ist_close
CBLDCIST('DCISTSVC','CLOS')
×
資源の排他制御 資源の排他 dc_lck_get
CBLDCLCK('GET ')
全資源の排他の解除 dc_lck_release_all
CBLDCLCK('RELALL ')
資源名称を指定した排他の解除 dc_lck_release_byname
CBLDCLCK('RELNAME ')
XATMIインタフェース リクエスト/レスポンス型サービスの呼び出しと応答の受信 tpcall()
TPCALL
× XATMIインタフェースはサポートしていません。
リクエスト/レスポンス型サービスの呼び出し tpacall()
TPACALL
×
リクエスト/レスポンス型サービスからの非同期応答の受信 tpgetrply()
TPGETRPLY
×
リクエスト/レスポンス型サービスのキャンセル tpcancel()
TPCANCEL
×
会話型サービスとのコネクションの確立 tpconnect()
TPCONNECT
×
会話型サービスとのコネクションの切断 tpdiscon()
TPDISCON
×
会話型サービスからのメッセージの受信 tprecv()
TPRECV
×
会話型サービスへのメッセージの送信 tpsend()
TPSEND
×
型付きバッファの割り当て tpalloc()
×
型付きバッファの解放 tpfree()
×
型付きバッファのサイズの変更 tprealloc()
×
型付きバッファの情報の取得 tptypes()
×
サービス名の広告 tpadvertise()
TPADVERTISE
×
サービス名の広告の取り消し tpunadvertise()
TPUNADVERTISE
×
サービス関数のテンプレート tpservice()
TPSVCSTART
×
サービス関数からのリターン tpreturn()
TPRETURN
×
TXインタフェース トランザクションの開始 tx_begin()
TXBEGIN
トランザクションのコミット tx_commit()
TXCOMMIT
現在のトランザクションに関する情報の返却 tx_info()
TXINFORM
リソースマネジャ集合のオープン tx_open()
TXOPEN
トランザクションのロールバック tx_rollback()
TXROLLBACK
リソースマネジャ集合のクローズ tx_close()
TXCLOSE
commit_return特性の設定 tx_set_commit_return()
TXSETCOMMITRET
transaction_control特性の設定 tx_set_transaction_control()
TXSETTRANCTL
transaction_timeout特性の設定 tx_set_transaction_timeout()
TXSETTIMEOUT
マルチノード機能 OpenTP1ノードのステータス取得の開始 dc_adm_get_nd_status_begin
× マルチノード機能(TP1/Multi)はサポートしていません。
OpenTP1ノードのステータスの取得 dc_adm_get_nd_status_next
×
指定したOpenTP1ノードのステータスの取得 dc_adm_get_nd_status
×
OpenTP1ノードのステータス取得の終了 dc_adm_get_nd_status_done
×
ノード識別子の取得の開始 dc_adm_get_nodeconf_begin
×
ノード識別子の取得 dc_adm_get_nodeconf_next
×
ノード識別子の取得の終了 dc_adm_get_nodeconf_done
×
指定したノード識別子の取得 dc_adm_get_node_id
×
ユーザサーバのステータス取得の開始 dc_adm_get_sv_status_begin
×
ユーザサーバのステータスの取得 dc_adm_get_sv_status_next
×
指定したユーザサーバのステータスの取得 dc_adm_get_sv_status
×
ユーザサーバのステータス取得の終了 dc_adm_get_sv_status_done
×
オンラインテスタの管理 ユーザサーバのテスト状態の報告 dc_uto_test_status
CBLDCUTO('T-STATUS')
× オンラインテスタ機能(TP1/Online Tester)はサポートしていません。
性能検証用トレース ユーザ固有の性能検証用トレースの取得 dc_prf_utrace_put
CBLDCPRF('PRFPUT ')
性能検証用トレース取得通番の通知 dc_prf_get_trace_num
CBLDCPRF('PRFGETN ')
リアルタイム統計情報サービス 任意区間でのリアルタイム統計情報の取得 dc_rts_utrace_put
CBLDCRTS('RTSPUT ')
注※
上段がC言語の関数,下段がCOBOL-UAP作成用プログラムです。