HITACHI Inspire The Next

OpenTP1 Version 7

分散トランザクション処理機能

OpenTP1 クライアント使用の手引 TP1/Client/W，TP1/Client/P編

解説・手引・文法・操作書

3000-3-D58-20

目　　次

前書き
変更内容
はじめに
1.　概要
1.1　クライアント機能の特長
1.2　TP1/Clientの動作の仕組み
2.　機能
2.1　ユーザ認証機能
2.1.1　ユーザ認証の実現方法
2.1.2　認証要求先のTP1/Serverの指定
2.1.3　ユーザ認証の抑止
2.1.4　TP1/Server以外のサーバとの通信
2.2　常設コネクション
2.2.1　常設コネクションの確立・解放
2.2.2　常設コネクションを使用する場合に関連する定義
2.2.3　DCCM3論理端末に端末識別情報を通知する
2.2.4　常設コネクションを使用するときの注意事項
2.3　リモートプロシジャコール
2.3.1　RPCの実現方法
2.3.2　RPCでのデータの受け渡し
2.3.3　RPCの形態
2.3.4　連鎖RPC
2.3.5　スケジュール機能
2.3.6　ノード間負荷バランス機能
2.3.7　RPCの時間監視
2.3.8　認証RPC
2.3.9　OpenTP1以外のサーバへのRPC
2.3.10　ネームサービスを使用したRPC
2.3.11　マルチスケジューラ機能を使用したRPC
2.3.12　窓口となるTP1/Serverの切り替え機能
2.3.13　窓口となるTP1/Serverの負荷分散
2.3.14　データ圧縮機能
2.3.15　リモートAPI機能
2.3.16　同期応答型RPCタイムアウト時のサーバ負荷軽減
2.4　トランザクション制御
2.4.1　トランザクションの開始と同期点取得
2.4.2　同期点取得
2.4.3　リモートプロシジャコールの形態と同期点の関係
2.4.4　現在のトランザクションに関する識別子の取得
2.4.5　現在のトランザクションに関する情報の報告
2.4.6　障害発生時のトランザクションの同期点を検証する方法
2.4.7　トランザクションを制御するときの注意事項
2.5　TCP/IP通信機能
2.5.1　メッセージの一方送信
2.5.2　メッセージの一方受信
2.5.3　メッセージの送受信
2.5.4　メッセージの組み立て機能と送達確認機能
2.5.5　TCP/IP通信機能を使用するときの注意事項
2.6　サーバからの一方通知受信機能
2.6.1　サーバからの一方通知受信機能の概要
2.6.2　一方通知連続受信機能の概要
2.6.3　一方通知連続受信機能を使用するときの注意事項
2.7　XATMIインタフェース機能
2.7.1　会話型サービス
2.7.2　会話型サービスの時間監視
2.7.3　イベントの受信
2.7.4　通信データの型
2.7.5　XATMIインタフェース機能を使用するときの注意事項
2.8　文字コード変換機能
2.8.1　コードマッピングテーブルを使用しない場合
2.8.2　コードマッピングテーブルを使用する場合
2.9　マルチスレッド機能
2.9.1　マルチスレッドに対応したCUPの処理の概要
2.9.2　マルチスレッドに対応しない関数の実行
2.9.3　マルチスレッド機能を使用するときの注意事項
2.10　オンラインテスタ機能
2.11　トラブルシュート機能
2.11.1　エラーログ機能
2.11.2　UAPトレース機能
2.11.3　ソケットトレース機能
2.11.4　モジュールトレース機能
2.11.5　TP1/Serverの性能検証用トレース
2.11.6　トラブルシュート機能を使用するときの注意事項
2.12　ホスト名拡張機能
2.12.1　C言語の関数の引数に指定できるホスト名長およびホスト名格納領域長
2.12.2　ホスト名拡張機能使用時のCOBOL-UAP作成用プログラム
2.12.3　クライアント環境定義のオペランドで指定できる文字数
2.12.4　ホスト名拡張機能を使用するときの注意事項
2.13　送信元ホスト指定機能
2.14　受信ポート固定機能
3.　ユーザアプリケーションプログラムの作成（C言語編）
3.1　関数インタフェース
3.1.1　関数の一覧
3.1.2　関数の記述形式
3.2　ユーザアプリケーションプログラムの翻訳と結合
3.2.1　UNIX環境の場合の翻訳と結合
3.2.2　Windows環境の場合の翻訳と結合
3.3　ユーザアプリケーションプログラムの作成例
3.3.1　CUPとSPPの作成
3.3.2　マルチスレッド対応のユーザアプリケーションプログラムの作成
4.　TP1/Clientで使用できる関数（C言語編）
4.1　関数を使用するときの注意事項
4.2　ユーザ認証機能
4.2.1　dc_clt_cltin_s － クライアントユーザの認証要求
4.2.2　dc_clt_cltout_s － クライアントユーザの認証解除
4.3　リモートプロシジャコール
4.3.1　dc_rpc_open_s － UAPの開始
4.3.2　dc_rpc_close_s － UAPの終了
4.3.3　dc_rpc_call_s － 遠隔サービスの要求
4.3.4　dc_rpc_call_to_s － 通信先を指定した遠隔サービスの要求
4.3.5　dc_rpc_set_watch_time_s － サービス応答待ち時間の更新
4.3.6　dc_rpc_get_watch_time_s － サービス応答待ち時間の参照
4.3.7　DCRPC_DIRECT_SCHEDULE － DCRPC_BINDING_TBL構造体の作成
4.4　常設コネクション
4.4.1　dc_clt_connect_s － 常設コネクションの確立
4.4.2　dc_clt_disconnect_s － 常設コネクションの解放
4.4.3　dc_clt_set_raphost_s － 常設コネクション確立要求先の指定
4.4.4　dc_clt_get_raphost_s － 常設コネクション確立要求先の取得
4.4.5　dc_clt_set_connect_inf_s － 端末識別情報の設定
4.5　トランザクション制御
4.5.1　dc_trn_begin_s － トランザクションの開始
4.5.2　dc_trn_chained_commit_s － 連鎖モードのコミット
4.5.3　dc_trn_chained_rollback_s － 連鎖モードのロールバック
4.5.4　dc_trn_unchained_commit_s － 非連鎖モードのコミット
4.5.5　dc_trn_unchained_rollback_s － 非連鎖モードのロールバック
4.5.6　dc_clt_get_trnid_s － 現在のトランザクションに関する識別子の取得
4.5.7　dc_trn_info_s － 現在のトランザクションに関する情報の報告
4.6　TCP/IP通信機能
4.6.1　dc_clt_send_s － メッセージの送信
4.6.2　dc_clt_receive_s － メッセージの受信
4.6.3　dc_clt_receive2_s － メッセージの受信（障害時メッセージ受信）
4.6.4　dc_clt_assem_send_s － 組み立てメッセージの送信
4.6.5　dc_clt_assem_receive_s － 組み立てメッセージの受信
4.7　サーバからの一方通知受信機能
4.7.1　dc_clt_accept_notification_s － 一方通知メッセージの受信
4.7.2　dc_clt_cancel_notification_s － 一方通知待ち状態のキャンセル
4.7.3　dc_clt_open_notification_s － 一方通知受信の開始
4.7.4　dc_clt_close_notification_s － 一方通知受信の終了
4.7.5　dc_clt_chained_accept_notification_s － 一方通知受信
4.8　XATMIインタフェース機能
4.8.1　tpalloc － 型付きバッファの割り当て
4.8.2　tpfree － 型付きバッファの解放
4.8.3　tpconnect － 会話型サービスとのコネクションの確立
4.8.4　tpdiscon － 会話型サービスとのコネクションの切断
4.8.5　tpsend － 会話型サービスへのメッセージの送信
4.8.6　tprecv － 会話型サービスからのメッセージの受信
4.9　文字コード変換機能（コードマッピングテーブルを使用しない場合）
4.9.1　dc_clt_code_convert － 文字コード変換
4.10　文字コード変換機能（コードマッピングテーブルを使用する場合）
4.10.1　dc_clt_codeconv_open － 文字コード変換の開始
4.10.2　dc_clt_codeconv_close － 文字コード変換の終了
4.10.3　dc_clt_codeconv_exec － 文字コード変換の実行
5.　ユーザアプリケーションプログラムの作成（COBOL言語編）
5.1　COBOL-UAP作成用プログラムの機能
5.1.1　各UAPと機能の対応
5.1.2　COBOL-UAP作成用プログラムの記述形式
5.2　ユーザアプリケーションプログラムの翻訳と結合
5.2.1　UNIX環境の場合の翻訳と結合
5.2.2　Windows環境の場合の翻訳と結合
5.3　COBOL言語用テンプレート
5.3.1　COBOL言語用テンプレートのファイル
5.3.2　COBOL言語用テンプレートの使用方法
5.3.3　COBOL言語用テンプレートについての使用上の注意
5.4　ユーザアプリケーションプログラムの作成例
5.4.1　CUPとSPPの作成
5.4.2　マルチスレッド対応のユーザアプリケーションプログラムの作成
6.　TP1/Clientで使用できる要求文（COBOL言語編）
6.1　要求文を使用するときの注意事項
6.2　ユーザ認証機能
6.2.1　CBLDCCLS('CLTIN ') － クライアントユーザの認証要求
6.2.2　CBLDCCLS('EXCLTIN ') － クライアントユーザの認証要求（ホスト名長の拡張時）
6.2.3　CBLDCCLS('CLTOUT ') － クライアントユーザの認証解除
6.3　リモートプロシジャコール
6.3.1　CBLDCRPS('OPEN ') － UAPの開始
6.3.2　CBLDCRPS('CLOSE ') － UAPの終了
6.3.3　CBLDCRPS('CALL ') － 遠隔サービスの要求
6.3.4　CBLDCRPS('SETWATCH') － サービス応答待ち時間の更新
6.3.5　CBLDCRPS('GETWATCH') － サービス応答待ち時間の参照
6.4　常設コネクション
6.4.1　CBLDCCLS('CONNECT ') － 常設コネクションの確立
6.4.2　CBLDCCLS('DISCNCT ') － 常設コネクションの解放
6.4.3　CBLDCCLS('STRAPHST') － 常設コネクション確立要求先の指定
6.4.4　CBLDCCLS('GTRAPHST') － 常設コネクション確立要求先の取得
6.4.5　CBLDCCLS('STCONINF') － 端末識別情報の設定
6.5　トランザクション制御
6.5.1　CBLDCTRS('BEGIN ') － トランザクションの開始
6.5.2　CBLDCTRS('C-COMMIT') － 連鎖モードのコミット
6.5.3　CBLDCTRS('C-ROLL ') － 連鎖モードのロールバック
6.5.4　CBLDCTRS('U-COMMIT') － 非連鎖モードのコミット
6.5.5　CBLDCTRS('U-ROLL ') － 非連鎖モードのロールバック
6.5.6　CBLDCTRS('INFO ') － 現在のトランザクションに関する情報の報告
6.5.7　CBLDCCLS('GETTRNID') － 現在のトランザクションに関する識別子の取得
6.6　TCP/IP通信機能
6.6.1　CBLDCCLS('SEND ') － メッセージの送信
6.6.2　CBLDCCLS('EXSEND ') － メッセージの送信（ホスト名長の拡張時）
6.6.3　CBLDCCLS('RECEIVE ') － メッセージの受信
6.6.4　CBLDCCLS('RECEIVE2') － メッセージの受信（障害時メッセージ受信）
6.6.5　CBLDCCLS('ASMSEND ') － 組み立てメッセージの送信
6.6.6　CBLDCCLS('ASMRECV ') － 組み立てメッセージの受信
6.7　サーバからの一方通知受信機能
6.7.1　CBLDCCLS('NOTIFY ') － 一方通知メッセージの受信
6.7.2　CBLDCCLS('EXNACPT ') － 一方通知メッセージの受信（ホスト名長の拡張時）
6.7.3　CBLDCCLS('CANCEL ') － 一方通知待ち状態のキャンセル
6.7.4　CBLDCCLS('EXNCANCL') － 一方通知待ち状態のキャンセル（ホスト名長の拡張時）
6.7.5　CBLDCCLS('O-NOTIFY') － 一方通知受信の開始
6.7.6　CBLDCCLS('C-NOTIFY') － 一方通知受信の終了
6.7.7　CBLDCCLS('A-NOTIFY') － 一方通知受信
6.7.8　CBLDCCLS('EXNCACPT') － 一方通知受信（ホスト名長の拡張時）
6.8　文字コード変換機能（コードマッピングテーブルを使用しない場合）
6.8.1　CBLDCUTL('CODECNV ') － 文字コード変換
6.9　文字コード変換機能（コードマッピングテーブルを使用する場合）
6.9.1　CBLDCUTL('CNVOPN ') － 文字コード変換の開始
6.9.2　CBLDCUTL('CNVCLS ') － 文字コード変換の終了
6.9.3　CBLDCUTL('CNVEXEC ') － 文字コード変換の実行
7.　定義
7.1　定義の概要
7.1.1　クライアント環境定義の一覧
7.1.2　定義の規則
7.2　クライアント環境定義の詳細
7.2.1　TP1/Client/Wの形式
7.2.2　TP1/Client/Pの形式
7.2.3　TP1/Client/Wの機能
7.2.4　TP1/Client/Pの機能
7.2.5　TP1/Client/WとTP1/Client/Pで共通のオペランド
7.2.6　TP1/Client/W固有のオペランド
7.2.7　TP1/Client/P固有のオペランド
7.2.8　TP1/Client/Wの注意事項
7.2.9　TP1/Client/Pの注意事項
8.　運用コマンド
8.1　運用コマンドの記述形式
8.2　運用コマンドの詳細
8.2.1　cltdump（トレースの編集出力）
9.　障害対策
9.1　通信障害
9.2　クライアント側の障害
9.3　XDM/DCCM3へ遠隔操作要求時の障害
10.　メッセージ
10.1　メッセージの出力形式
10.2　メッセージの記述形式
10.3　メッセージ一覧
付録
付録A　コード変換の仕様
付録A.1　TP1/Client/Pでサポートするコード範囲
付録A.2　シフトJISコードとKEISコードの変換
付録A.3　コード変換例
付録A.4　コード変換をするときの注意事項
付録B　バージョンアップ時の変更点
付録B.1　07-02での変更点
付録B.2　07-01での変更点
付録B.3　07-00での変更点
索引

[他社商品名称に関する表示]

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