Hitachi

OpenTP1 Version 7 分散トランザクション処理機能 OpenTP1 プロトコル TP1/NET/User Datagram Protocol編


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

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

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

〈このページの構成〉

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

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

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

表4‒1 COBOL言語のプログラムインタフェースの一覧

プログラム名

データ名Aに設定する要求コード

機能

CBLDCMCF

'RECEIVE△'

一方送信メッセージの受信

'RESEND△△'

メッセージの再送

'SEND△△△△'

一方送信メッセージの送信

'SENDSYNC'

同期型メッセージの送信

'TACTLE△△'

論理端末の閉塞解除

'TDCTLE△△'

論理端末の閉塞

'TLSLE△△△'

論理端末の状態取得

その他のプログラムについては,マニュアル「OpenTP1 プログラム作成リファレンス COBOL言語編」を参照してください。

データ操作言語のプログラムインタフェース

データ操作言語(DML)を使用した,通信文について説明します。データ操作言語の形式の詳細については,マニュアル「OpenTP1 プログラム作成リファレンス COBOL言語編」を参照してください。

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

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

通信文

機能

対応するCALLインタフェース

データコミュニケーション機能

RECEIVE

メッセージの受信

表4-4 RECEIVE文(データコミュニケーション機能)の指定とC言語のライブラリ関数との対応」,および「表4-5 SEND文(データコミュニケーション機能)の指定とC言語のライブラリ関数との対応」を参照してください。

SEND

メッセージの送信

dc_mcf_resend(メッセージの再送)に対応するデータ操作言語のインタフェースはありません。

そのほかの通信文については,マニュアル「OpenTP1 プログラム作成リファレンス COBOL言語編」を参照してください。

通信記述項について

TP1/NET/UDPのメッセージ送受信の通信文で,通信記述項に指定できる句の指定要否を,次の表に示します。

表4‒3 通信記述項に指定できる句の指定要否

データ名を指定する句

データ領域の値の設定元

1.

2.

3.

4.

STATUS KEY

B

B

B

B

SYMBOLIC TERMINAL

B

U1※1

U1※2

U1

MESSAGE DATE

B

B

MESSAGE TIME

B

B

SYNCHRONOUS MODE

U2

U2

U2

U1

SWITCHING MODE

U2

DETAIL MODE

U2

(凡例)

1.:先頭セグメントの非同期受信(RECEIVE)

2.:中間,最終セグメントの非同期受信(RECEIVE)

3.:一方送信メッセージの単一セグメントの非同期送信(SEND)

4.:単一セグメントの同期送信(SEND)

B:OpenTP1から値が返されます。省略できます。

U1:UAPで値を設定します。省略できません。

U2:UAPで値を設定します。省略できます。

−:該当しません。設定しても無効です。

注※1

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

注※2

FOR句にI-Oを設定し,UAP共通定義(mcfmuap -c)のnoansreplyオペランドにyesを指定した場合は省略できます。

データコミュニケーション機能とC言語のライブラリ関数の対応

RECEIVE文(データコミュニケーション機能)の指定とC言語のライブラリ関数との対応を,次の表に示します。

表4‒4 RECEIVE文(データコミュニケーション機能)の指定とC言語のライブラリ関数との対応

FOR句

SYNCHRONOUS MODE句

対応するC言語のライブラリ関数

INPUT

I-O

SYNC,または'1'

ASYNC,'0','△',または省略

dc_mcf_receive

dc_mcf_recvsync

(凡例)

○:指定あり

−:指定なし

注※

TP1/NET/UDPではサポートしていない関数です。

SEND文(データコミュニケーション機能)の指定とC言語のライブラリ関数との対応を,次の表に示します。

表4‒5 SEND文(データコミュニケーション機能)の指定とC言語のライブラリ関数との対応

FOR句

SYNCHRONOUS MODE句

BEFORE句

対応するC言語のライブラリ関数

OUTPUT

I-O

SYNC,または'1'

ASYNC,'0','△',または省略

dc_mcf_send

dc_mcf_reply※1※2

dc_mcf_sendsync

dc_mcf_sendrecv※1

(凡例)

○:指定あり

−:指定なし

注※1

TP1/NET/UDPではサポートしていない関数です。

注※2

UAP共通定義(mcfmuap -c)のnoansreplyオペランドにyesを指定した場合はdc_mcf_send関数に対応します。