Hitachi

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


CBLDCMCF('SENDSYNC') − 同期型メッセージの送信(COBOL言語)

〈このページの構成〉

形式

PROCEDURE DIVISIONの指定

CALL 'CBLDCMCF' USING 一意名1 一意名2 一意名3

DATA DIVISIONの指定

01  一意名1.
    02  データ名A    PIC X(8)  VALUE 'SENDSYNC'.
    02  データ名B    PIC X(5).
    02  FILLER        PIC X(3).
    02  データ名C    PIC X(4)  VALUE SPACE.
    02  データ名D    PIC X(4)  VALUE SPACE.
    02  データ名E    PIC 9(8).
    02  データ名F    PIC 9(8).
    02  データ名G    PIC 9(9)  COMP VALUE ZERO.
    02  データ名H    PIC X(4)  VALUE 'EMI '.
    02  データ名I    PIC X(4)  VALUE SPACE.
    02  データ名J    PIC X(4)  VALUE SPACE.
    02  データ名K    PIC X(4)  VALUE SPACE.
    02  データ名L    PIC X(8)  VALUE SPACE.
    02  データ名M1   PIC X(4)  VALUE SPACE.
    02  データ名M2   PIC X(8)  VALUE SPACE.
    02  データ名M3   PIC X(4)  VALUE SPACE.
    02  データ名M4   PIC 9(9)  COMP VALUE ZERO.
    02  データ名M5   PIC S9(9)  COMP.
    02  データ名M6   PIC X(1)  VALUE SPACE.
    02  データ名M7   PIC X(1).
    02  データ名N    PIC X(14)  VALUE LOW-VALUE.
01  一意名2.
    02  データ名O    PIC X(4)  VALUE SPACE.
    02  データ名P    PIC X(8).
    02  データ名Q    PIC X(8)  VALUE SPACE.
    02  データ名R    PIC X(8)  VALUE SPACE.
    02  データ名T    PIC X(28)  VALUE LOW-VALUE.
01  一意名3.
    02  データ名U    PIC 9(x)  COMP.
    02  データ名V    PIC X(x).
    02  データ名W1   PIC X(12)  VALUE LOW-VALUE.
    02  データ名W2   PIC X(4).
    02  データ名W3   PIC X(2)  VALUE LOW-VALUE.
    02  データ名W4   PIC X(2).
    02  データ名W5   PIC X(4)  VALUE LOW-VALUE.
    02  データ名W6   PIC X(n).

機能

相手システムへ同期型でメッセージを送信します。メッセージは,一つのセグメントで構成されます。

送信できるメッセージの一つのセグメントの最大長は,制御ヘッダの24バイトを含めて32000バイトまでです。

セグメントを送信する領域(一意名3で示す領域)の形式を次に示します。

[図データ]

相手IPアドレスと相手ポート番号の設定方法については,「2.1.3 通信相手のアドレスの指定」を参照してください。

UAPで値を設定するデータ領域

●データ名A

同期型メッセージの送信を示す要求コードを「VALUE 'SENDSYNC'」と設定します。

●データ名C,データ名D

空白を設定します。

●データ名E,データ名F

MCFで使用する領域です。

●データ名G

0を設定します。

●データ名H

単一セグメントの送信を示す「VALUE 'EMI△'」を設定します。

●データ名I,データ名J,データ名K,データ名L,データ名M1,データ名M2,データ名M3

空白を設定します。

●データ名M4

0を設定します。

●データ名M5

CBLDCMCF('SENDSYNC')を呼び出しから終了するまでの監視時間を設定します。TP1/NET/UDPでは時間監視を行わないため,負の値を設定してください。

●データ名M6

空白を設定します。

●データ名M7

使用するバッファ形式を指定します。

VALUE '1'

バッファ形式1を使用する場合に設定します。

VALUE '2'

バッファ形式2を使用する場合に設定します。

空白

省略されたものとして,VALUE '1'(バッファ形式1)が設定されます。

●データ名N

MCFで使用する領域です。

●データ名O

空白を設定します。

●データ名P

出力先の論理端末名称を設定します。論理端末名称は最大8バイトの長さです。8バイトに満たない場合,論理端末名称の後ろを空白で埋めてください。

●データ名Q,データ名R

空白を設定します。

●データ名T

MCFで使用する領域です。

●データ名U

【バッファ形式1の場合】 PIC 9(9)

送信するセグメントの長さ+24(制御ヘッダ)を設定します。

【バッファ形式2の場合】 PIC9(4)

送信するセグメントの長さ+28(制御ヘッダ,データ名U,データ名V)を設定します。

●データ名V

【バッファ形式1の場合】 PICX(8)

【バッファ形式2の場合】 PICX(2)

MCFで使用する領域です。

●データ名W1,W3,W5

0を設定します。

●データ名W2

送信相手のIPアドレスを設定します。

設定方法については,「2.1.3 通信相手のアドレスの指定」を参照してください。

●データ名W4

送信相手のポート番号を設定します。

設定方法については,「2.1.3 通信相手のアドレスの指定」を参照してください。

●データ名W6

送信するセグメントの内容を設定します。一つのセグメントで31976バイトまで送信できます。

OpenTP1から値が返されるデータ領域

●データ名B

ステータスコードが,5けたの数字で返されます。

ステータスコード

ステータスコード

意味

00000

正常に終了しました。

71002

バッファ形式1の場合はデータ名Uに32000バイトを超える値を設定しています。バッファ形式2の場合はデータ名Uに32004バイトを超える値を設定しています。

MCFが終了処理中のため,メッセージの送信を受け付けられません。

71003

メッセージキューが満杯です。

71004

メッセージを格納するバッファをメモリ上に確保できませんでした。

71108

メッセージを送信しようとしましたが,送信先の管理テーブルが確保できませんでした。

プロセスのローカルメモリが不足しています。

72000

先頭セグメントを受信するCBLDCMCF('RECEIVE△')を呼び出す前に,CBLDCMCF('SENDSYNC')を呼び出しています。

72001

データ名Pに設定した論理端末名称が間違っています。

データ名Pに設定した論理端末名称は,定義されていません。

CBLDCMCF('SENDSYNC')を呼び出せない論理端末を設定しています。

72016

データ名M1に設定した値が間違っています。

データ名M7に設定した値が間違っています。

データ名Nまたはデータ名Tに設定した値が間違っています。

72019

データ名M6に設定した値が間違っています。

72024

データ名Oに設定した値が間違っています。

72026

データ名Hに設定した値が間違っています。

72028

データ名Aに設定した値が間違っています。

72041

バッファ形式1の場合はデータ名Uに0バイト,またはマイナス値を設定しています。バッファ形式2の場合はデータ名Uに0から4バイト,またはマイナス値を設定しています。

73001

出力先の論理端末で障害が発生しました。

73010

出力メッセージ編集UOCで障害が発生しました。

メッセージの読み込み時に障害が発生しました。

73011

バッファ形式1の場合はデータ名Uに1以上24以下の値を設定しています。バッファ形式2の場合はデータ名Uに5以上28以下の値を設定しています。

73019

システムに対する送信時に障害が発生しました。

73020

出力先の論理端末は閉塞しています。

上記以外

プログラムの破壊などによる,予期しないエラーが発生しました。

注意事項

同一論理端末上で,同期型メッセージの送信と一方送信メッセージの送信を併用するのは避けてください。詳細は,3章の「dc_mcf_send − 一方送信メッセージの送信(C言語)」を参照してください。