Hitachi

OpenTP1 Version 7 分散トランザクション処理機能 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作成用プログラムです。