分散トランザクション処理機能 OpenTP1 プロトコル TP1/NET/TCP/IP編

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

COBOL-UAP作成用プログラムインタフェースの一覧

TP1/NET/TCP/IPで使用するCOBOL-UAP作成用プログラムインタフェースについて,COBOL言語,およびデータ操作言語に分けて説明します。

なお,UAP作成の詳細については,マニュアル「OpenTP1 プログラム作成の手引」を参照してください。

COBOL言語のプログラムインタフェース

COBOL言語でUAPを作成する場合,OpenTP1システムの関数に対応しているプログラムを,CALL文で呼び出してUAPを作成します。

COBOL言語のプログラムインタフェースの一覧を次の表に示します。

表4-1 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言語編」を参照してください。

データ操作言語のプログラムインタフェースの一覧を,次の表に示します。

表4-2 データ操作言語のプログラムインタフェースの一覧

通信文 機能 対応するC言語のライブラリ関数
データコミュニケーション機能 RECEIVE メッセージの受信 表4-4 RECEIVE文(データコミュニケーション機能)の指定とC言語のライブラリ関数との対応」,および「表4-5 SEND文(データコミュニケーション機能)の指定とC言語のライブラリ関数との対応」を参照してください。
SEND メッセージの送信
サービス機能 DISABLE 継続問い合わせ応答の終了 dc_mcf_contend
RECEIVE 一時記憶データの受け取り dc_mcf_tempget
SEND 一時記憶データの更新 dc_mcf_tempput
dc_mcf_resend(メッセージの再送)に対応するデータ操作言語のインタフェースはありません。

そのほかの通信文については,マニュアル「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
(凡例)
1.:先頭セグメントの非同期受信(RECEIVE)
2.:中間,最終セグメントの非同期受信(RECEIVE)
3.:単一セグメントの同期受信(RECEIVE)
4.:一方送信メッセージの単一セグメントの非同期送信(SEND)
5.:応答メッセージの単一セグメントの非同期送信(SEND)
6.:単一セグメントの同期送信(SEND)
7.:単一セグメントの同期送受信(SEND)
8.:継続問い合わせ応答の終了(DISABLE)
9.:一時記憶データの受け取り(RECEIVE)
10.:一時記憶データの更新(SEND)
B:OpenTP1から値が返されます。省略できます。
U1:UAPで値を設定します。省略できません。
U2:UAPで値を設定します。省略できます。
−:該当しません。設定しても無効です。
×:空白以外の値を設定するとエラーリターンします。

注※
先頭メッセージ受信時のRECEIVE文と同一のCD句を用いた場合は省略できます。

データコミュニケーション機能と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
(凡例)
○:指定あり
−:指定なし