COBOL-UAP作成用プログラムインタフェースの一覧
TP1/NET/OSAS-NIFで使用するCOBOL-UAP作成用プログラムインタフェースについて，COBOL言語，およびデータ操作言語に分けて説明します。
なお，UAP作成の詳細については，マニュアル「OpenTP1 プログラム作成の手引」を参照してください。
- 〈このページの構成〉
COBOL言語のプログラムインタフェース
COBOL言語でUAPを作成する場合，OpenTP1システムの関数に対応しているプログラムを，CALL文で呼び出してUAPを作成します。
COBOL言語のプログラムインタフェースの一覧を，次の表に示します。
|
プログラム名 |
データ名Aに設定する要求コード |
機能 |
|---|---|---|
|
CBLDCMCF |
'EXECAP△△' |
アプリケーションプログラムの起動 |
|
'RECEIVE△' |
メッセージの受信 |
|
|
'RECVSYNC' |
同期型メッセージの後続セグメント受信 |
|
|
'REPLY△△△' |
応答メッセージの送信 |
|
|
'RESEND△△' |
メッセージの再送 |
|
|
'SEND△△△△' |
メッセージの送信 |
|
|
'SENDRECV' |
同期型メッセージの送受信 |
|
|
'TACTCN△△' |
コネクションの確立 |
|
|
'TACTLE△△' |
論理端末の閉塞解除 |
|
|
'TDCTCN△△' |
コネクションの解放 |
|
|
'TDCTLE△△' |
論理端末の閉塞 |
|
|
'TLSCN△△△' |
コネクションの状態取得 |
|
|
'TLSLE△△△' |
論理端末の状態取得 |
その他のプログラムについては，マニュアル「OpenTP1 プログラム作成リファレンス COBOL言語編」を参照してください。
データ操作言語のプログラムインタフェース
データ操作言語（DML）を使用した，通信文について説明します。データ操作言語の形式の詳細については，マニュアル「OpenTP1 プログラム作成リファレンス COBOL言語編」を参照してください。
データ操作言語のプログラムインタフェースの一覧を，次の表に示します。
なお，TP1/NET/OSAS-NIFでは，通信相手システムのアプリケーションプログラムを起動することも，メッセージの送信に該当します。
|
通信文 |
機能 |
対応するCALLインタフェース |
|
|---|---|---|---|
|
データコミュニケーション機能 |
メッセージの受信 |
「表4-4 RECEIVE文（データコミュニケーション機能）の指定とC言語のライブラリ関数との対応」，および「表4-5 SEND文（データコミュニケーション機能）の指定とC言語のライブラリ関数との対応」を参照してください。 |
|
|
メッセージの送信 |
|||
- 注
-
dc_mcf_resend（メッセージの再送）に対応するデータ操作言語のインタフェースはありません。
その他の通信文については，マニュアル「OpenTP1 プログラム作成リファレンス COBOL言語編」を参照してください。
通信記述項について
TP1/NET/OSAS-NIFのメッセージ送受信の通信文で，通信記述項に指定できる句の指定要否を，次の表に示します。
|
データ名を指定する句 |
データ領域の値の設定元 |
|||||||
|---|---|---|---|---|---|---|---|---|
|
1. |
2. |
3. |
4. |
5. |
6. |
7. |
8. |
|
|
STATUS KEY |
B |
B |
B |
B |
B |
B |
B |
B |
|
SYMBOLIC TERMINAL |
B |
U1※ |
U1 |
U1 |
− |
− |
U1 |
U1 |
|
MESSAGE DATE |
B |
B |
− |
− |
− |
− |
− |
− |
|
MESSAGE TIME |
B |
B |
− |
− |
− |
− |
− |
− |
|
SYNCHRONOUS MODE |
U2 |
U2 |
U2 |
U2 |
U2 |
U2 |
U1 |
− |
|
SWITCHING MODE |
− |
− |
U2 |
U2 |
− |
− |
− |
− |
|
DETAIL MODE |
− |
− |
U2 |
U2 |
U2 |
U2 |
− |
− |
- （凡例）
-
1.：先頭セグメントの非同期受信（RECEIVE）
2.：中間，最終セグメントの非同期受信（RECEIVE）
3.：一方送信メッセージの先頭，中間セグメントの非同期送信（SEND）
4.：一方送信メッセージの単一，最終セグメントの非同期送信（SEND）
5.：応答メッセージの先頭，中間セグメントの非同期送信（SEND）
6.：応答メッセージの単一，最終セグメントの非同期送信（SEND）
7.：単一セグメントの同期送受信（SEND）
8.：アプリケーションプログラムの起動（SEND）
B：OpenTP1から値が返されます。省略できます。
U1：UAPで値を設定します。省略できません。
U2：UAPで値を設定します。省略できます。
−：該当しません。設定しても無効です。
- 注※
-
先頭メッセージ受信時のRECEIVE文と同一のCD句を用いた場合は省略できます。
データコミュニケーション機能とC言語のライブラリ関数の対応
RECEIVE文（データコミュニケーション機能）の指定とC言語のライブラリ関数との対応を，次の表に示します。
|
FOR句 |
SYNCHRONOUS MODE句 |
対応するC言語のライブラリ関数 |
||
|---|---|---|---|---|
|
INPUT |
I-O |
SYNC，または'1' |
ASYNC，'0'，'△'，または省略 |
|
|
○ |
− |
− |
○ |
dc_mcf_receive |
|
− |
○ |
− |
○ |
|
|
− |
○ |
○ |
− |
dc_mcf_recvsync※ |
- （凡例）
-
○：指定あり
−：指定なし
- 注※
-
TP1/NET/OSAS-NIFのデータ操作言語ではサポートしていない関数です。
SEND文（データコミュニケーション機能）の指定とC言語のライブラリ関数との対応を，次の表に示します。
|
FOR句 |
SYNCHRONOUS MODE句 |
BEFORE句 |
対応するC言語のライブラリ関数 |
|||
|---|---|---|---|---|---|---|
|
OUTPUT PROGRAM |
OUTPUT |
I-O |
SYNC，または'1' |
ASYNC，'0'，'△'，または省略 |
||
|
○ |
− |
− |
− |
− |
− |
dc_mcf_execap |
|
− |
○ |
− |
− |
○ |
− |
dc_mcf_send |
|
− |
− |
○ |
− |
○ |
− |
dc_mcf_reply |
|
− |
− |
○ |
○ |
− |
− |
dc_mcf_sendsync※ |
|
− |
− |
○ |
○ |
− |
○ |
dc_mcf_sendrecv |
- （凡例）
-
○：指定あり
−：指定なし
- 注※
-
TP1/NET/OSAS-NIFではサポートしていない関数です。