Hitachi

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


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

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

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

〈このページの構成〉

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

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

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

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

プログラム名

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

機能

CBLDCMCF

'RECEIVE△'

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

'RECVSYNC'

同期型メッセージの受信

'SENDRECV'

同期型メッセージの送受信

'SENDSYNC'

同期型メッセージの送信

'TACTCN△△'

コネクションの確立

'TDCTCN△△'

コネクションの解放

'TLSCN△△△'

コネクションの状態取得

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

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

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

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

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

通信文

機能

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

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

DISABLE

同期型メッセージの送信

CBLDCMCF('SENDSYNC')

ENABLE

同期型メッセージの送信

CBLDCMCF('SENDSYNC')

RECEIVE

メッセージの受信

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

SEND

メッセージの送信

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

通信記述項について

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

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

データ名を指定する句

データ領域の値の設定元

1.

2.

3.

4.

5.

6.

7.

STATUS KEY

B

B

B

B

B

B

B

SYMBOLIC TERMINAL

U1

U1

B

U1

U1

U1

U1

MESSAGE DATE

B

B

B

MESSAGE TIME

B

B

B

SYNCHRONOUS MODE

U1

U2

U2

U1

U1

U1

WAITING TIME

U2

U2

U2

(凡例)

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

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

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

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

5.:単一セグメントの同期受信(RECEIVE)

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

7.:単一セグメントの同期送受信(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

(凡例)

○:指定あり

−:指定なし

注※

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