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作成用プログラムです。