分散トランザクション処理機能 OpenTP1 プロトコル TP1/NET/TCP/IP編
TP1/NET/TCP/IPで使用するCOBOL-UAP作成用プログラムインタフェースについて,COBOL言語,およびデータ操作言語に分けて説明します。
なお,UAP作成の詳細については,マニュアル「OpenTP1 プログラム作成の手引」を参照してください。
COBOL言語でUAPを作成する場合,OpenTP1システムの関数に対応しているプログラムを,CALL文で呼び出してUAPを作成します。
COBOL言語のプログラムインタフェースの一覧を次の表に示します。
| プログラム名 | データ名Aに設定する要求コード | 機能 |
|---|---|---|
| CBLDCMCF | 'CONTEND△' | 継続問い合わせ応答の終了 |
| 'RECEIVE△' | メッセージの受信 | |
| 'RECVSYNC' | 同期型メッセージの受信 | |
| 'REPLY△△△' | 応答メッセージの送信 | |
| 'RESEND△△' | メッセージの再送 | |
| 'SEND△△△△' | 一方送信メッセージの送信 | |
| 'SENDRECV' | 同期型メッセージの送受信 | |
| 'SENDSYNC' | 同期型メッセージの送信 | |
| 'TACTCN△△' | コネクションの確立 | |
| 'TACTLE△△' | 論理端末の閉塞解除 | |
| 'TDCTCN△△' | コネクションの解放 | |
| 'TDCTLE△△' | 論理端末の閉塞 | |
| 'TEMPGET△' | 一時記憶データの受け取り | |
| 'TEMPPUT△' | 一時記憶データの更新 | |
| 'TLSCN△△△' | コネクションの状態取得 | |
| 'TLSLE△△△' | 論理端末の状態取得 | |
| 'TLSLN△△△' | サーバ型コネクションの確立要求の受付状態取得 | |
| 'TOFLN△△△' | サーバ型コネクションの確立要求の受付終了 | |
| 'TONLN△△△' | サーバ型コネクションの確立要求の受付開始 |
その他のプログラムについては,マニュアル「OpenTP1 プログラム作成リファレンス COBOL言語編」を参照してください。
データ操作言語(DML)を使用した,通信文について説明します。データ操作言語の形式の詳細については,マニュアル「OpenTP1 プログラム作成リファレンス COBOL言語編」を参照してください。
データ操作言語のプログラムインタフェースの一覧を,次の表に示します。
| 通信文 | 機能 | 対応するC言語のライブラリ関数 | |
|---|---|---|---|
| データコミュニケーション機能 | RECEIVE | メッセージの受信 | 「表4-4 RECEIVE文(データコミュニケーション機能)の指定とC言語のライブラリ関数との対応」,および「表4-5 SEND文(データコミュニケーション機能)の指定とC言語のライブラリ関数との対応」を参照してください。 |
| SEND | メッセージの送信 | ||
| サービス機能 | DISABLE | 継続問い合わせ応答の終了 | dc_mcf_contend |
| RECEIVE | 一時記憶データの受け取り | dc_mcf_tempget | |
| SEND | 一時記憶データの更新 | dc_mcf_tempput | |
そのほかの通信文については,マニュアル「OpenTP1 プログラム作成リファレンス COBOL言語編」を参照してください。
通信記述項について
TP1/NET/TCP/IPのメッセージ送受信の通信文で,通信記述項に指定できる句の指定要否を,次の表に示します。
表4-3 通信記述項に指定できる句の指定要否
| データ名を指定する句 | データ領域の値の設定元 | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| 1. | 2. | 3. | 4. | 5. | 6. | 7. | 8. | 9. | 10. | |
| STATUS KEY | B | B | B | B | B | B | B | B | B | B |
| SYMBOLIC TERMINAL | B | U1※ | U1 | U1 | − | U1 | U1 | × | × | × |
| MESSAGE DATE | B | B | B | − | − | − | − | − | − | − |
| MESSAGE TIME | B | B | B | − | − | − | − | − | − | − |
| SYNCHRONOUS MODE | U2 | U2 | U1 | U2 | U2 | U1 | U1 | − | − | − |
| SWITCHING MODE | − | − | − | U2 | − | − | − | − | − | − |
| NEXT TRANSACTION | − | − | − | − | U2 | − | − | − | − | − |
| DETAIL MODE | − | − | − | U2 | U2 | − | − | − | − | − |
| WAITING TIME | − | − | U2 | − | − | U2 | U2 | − | − | − |
データコミュニケーション機能とC言語のライブラリ関数の対応
RECEIVE文(データコミュニケーション機能)の指定とC言語のライブラリ関数との対応を,次の表に示します。
表4-4 RECEIVE文(データコミュニケーション機能)の指定とC言語のライブラリ関数との対応
| FOR句 | SYNCHRONOUS MODE句 | 対応するC言語のライブラリ関数 | ||
|---|---|---|---|---|
| INPUT | I-O | SYNC,または'1' | ASYNC,'0','△',または省略 | |
| ○ | − | − | ○ | dc_mcf_receive |
| − | ○ | − | ○ | |
| − | ○ | ○ | − | dc_mcf_recvsync |
SEND文(データコミュニケーション機能)の指定とC言語のライブラリ関数との対応を,次の表に示します。
表4-5 SEND文(データコミュニケーション機能)の指定とC言語のライブラリ関数との対応
| FOR句 | SYNCHRONOUS MODE句 | BEFORE句 | 対応するC言語のライブラリ関数 | ||
|---|---|---|---|---|---|
| OUTPUT | I-O | SYNC,または'1' | ASYNC,'0','△',または省略 | ||
| ○ | − | − | ○ | − | dc_mcf_send |
| − | ○ | − | ○ | − | dc_mcf_reply |
| − | ○ | ○ | − | − | dc_mcf_sendsync |
| − | ○ | ○ | − | ○ | dc_mcf_sendrecv |
All Rights Reserved. Copyright (C) 2006, 2013, Hitachi, Ltd.