![]() |
![]() |
|
|
TPCONNECT(3cbl)
名前
TPCONNECT()- 会話接続の確立
形式
01 TPSVCDEF-REC.
COPY TPSVCDEF.
01 TPTYPE-REC.
COPY TPTYPE.
01 DATA-REC.
COPY User data.
01 TPSTATUS-REC.
COPY TPSTATUS.
CALL "TPCONNECT" USING TPSVCDEF-REC TPTYPE-REC DATA-REC TPSTATUS-REC.
機能説明
TPCONNECT() により、プログラムは会話サービス、TPSVDEF-REC 内の SERVICE-NAME との半二重接続をセットアップできます。 この名前は、会話サーバがポストした会話サービス名の1つでなければなりません。
呼び出し元は、接続セットアップ処理の一部として、アプリケーション定義データを受信サービス・ルーチンに渡すことができます。呼び出し元がデータを渡すことを選択した場合には、DATA-REC にはデータが入り、TPTYPE-REC 内の LEN は送信するレコードの大きさを指定します。 ただし、DATA-REC が長さの指定を必要としないタイプのレコードである場合 LEN は無視されます (0 でかまいません)。 TPTYPE-REC 内の REC-TYPE が SPACES である場合、DATA-REC および LEN は無視されます (アプリケーション・データは会話サービスに渡されません)。 REC-TYPE および TPTYPE-REC 内の SUB-TYPE は、SERVICE-NAME が認識するタイプおよびサブタイプと一致しなければなりません。
TPSVCSTART() の正常終了時には会話サービスは DATA-REC および LEN を受け取るので、TPCONNECT() が送信したデータを獲得するために、会話サービスが TPRECV() を呼び出すことはありません。
次に、TPSVCDEF-REC の有効な設定の一覧を示します。
戻り値
TPCONNECT() は正常終了時には、TP-STATUS に [TPOK] を設定し、TPSVDEF-REC 内の COMM-HANDLE に通信ハンドルを返します。このハンドルは、以降の呼び出しにおいて接続を参照するために使用されます。
エラー
次の条件が発生すると、TPCONNECT() は異常終了し、TP-STATUS に次の値を設定します。 特に説明がなければ、この障害は呼び出し元のトランザクションには影響しません。
関連項目
TPDISCON(3cbl)、TPRECV(3cbl)、TPSEND(3cbl)
![]() |
![]() |
![]() |
|
Copyright © 2001 BEA Systems, Inc. All rights reserved.
|