Hitachi

OpenTP1 Version 7 分散トランザクション処理機能 OpenTP1 プログラム作成リファレンス C言語編


dc_mcf_tlscom

〈このページの構成〉

名称

MCF通信サービスの状態取得

形式

ANSI C,C++の形式

#include <dcmcf.h>
int dc_mcf_tlscom (DCLONG action, char *resv01, DCLONG *infcnt, 
                   dcmcf_svinf *inf, char *resv02)

K&R版Cの形式

#include <dcmcf.h>
int dc_mcf_tlscom (action, resv01, infcnt, inf, resv02)
DCLONG             action;
char               *resv01;
DCLONG             *infcnt;
dcmcf_svinf        *inf;
char               *resv02;

機能

MCF通信サービスまたはアプリケーション起動サービスの状態を取得します。

UAPで値を設定する引数

●action

DCNOFLAGSを設定します。

●resv01

NULLを設定します。

●infcnt

MCF通信サービスまたはアプリケーション起動サービスの状態を格納する領域dcmcf_svinfの個数を設定します。

処理終了後は,該当するMCF通信サービスの個数が返されます。

●inf

MCF通信サービスまたはアプリケーション起動サービスの状態を格納する領域dcmcf_svinfを設定します。

「構造体dcmcf_svinfのサイズ×infcnt」バイト数分の領域が必要です。

●resv02

NULLを設定します。

OpenTP1から値が返される引数

●infcnt

MCFサービスに登録されているMCF通信サービスまたはアプリケーション起動サービスの個数が返されます。

●inf

MCFサービスに登録されているMCF通信サービスまたはアプリケーション起動サービスの情報が構造体dcmcf_svinfで返されます。

構造体の形式を次に示します。

typedef struct {
                DCLONG    mcfid;        …MCF通信プロセス識別子,
                                          アプリケーション起動
                                          プロセス識別子
                char      svname[9];    …MCF通信サービス名
                char      resv01[7];    …予備領域
                char      pnam[20];     …プロトコル種別
                DCLONG    status;       …MCF通信サービスの状態
                char      resv02[20];   …予備領域
                } dcmcf_svinf;
  • mcfid

    MCF通信プロセス識別子またはアプリケーション起動プロセス識別子が設定されます。

  • svname

    MCF通信サービス名が設定されます。

  • resv01

    領域がヌル文字で埋められます。

  • pnam

    プロトコル種別が設定されます。

    'MCF△△△△△△△△△△△△△△△△△'

    TP1/Message Controlのアプリケーション起動サービス

    'User△Agent△△△△△△△△△△'

    TP1/NET/User Agent(OSAS/UAプロトコル)

    'TP△△△△△△△△△△△△△△△△△△'

    TP1/NET/OSI-TP(OSI TPプロトコル)

    'XMAP3△△△△△△△△△△△△△△△'

    TP1/NET/XMAP3

    'OSAS-NIF△△△△△△△△△△△△'

    TP1/NET/OSAS-NIF(NIF/OSIプロトコル)

    'NET/SLUP2△△△△△△△△△△△'

    TP1/NET/SLU - TypeP2(SLUTYPE-Pプロトコル(2次局))

    'TCP/IP△△△△△△△△△△△△△△'

    TP1/NET/TCP/IP(TCP/IPプロトコル)

    'UDP/IP△△△△△△△△△△△△△△'

    TP1/NET/UDP(UDPプロトコル)

  • status

    MCF通信サービスまたはアプリケーション起動サービスの状態として,次の値が設定されます。

    DCMCF_SVST_OFLN

    サービスが停止されていることを示します。

    DCMCF_SVST_START

    サービスが準備中であることを示します。

    DCMCF_SVST_ONLN

    サービスが開始されている,または終了準備中であることを示します。

    DCMCF_SVST_PREEND

    サービスが部分停止の終了準備中であることを示します。

    DCMCF_SVST_END

    サービスが終了中であることを示します。

  • resv02

    領域がヌル文字で埋められます。

リターン値

リターン値

リターン値(数値)

意味

DCMCFRTN_00000

0

正常に終了しました。

DCMCFRTN_71001

-12001

MCFが開始処理中のため,dc_mcf_tlscom関数が受け付けられません。

DCMCFRTN_71004

-12004

dc_mcf_tlscom関数の処理中にメモリ不足が発生しました。

DCMCFRTN_71005

-12005

通信障害が発生しました。原因については,メッセージログファイルを参照してください。

DCMCFRTN_71006

-12006

内部障害が発生しました。原因については,メッセージログファイルを参照してください。

DCMCFRTN_72013

-13013

MCF通信サービスまたはアプリケーション起動サービスの数がinfcntの指定値を超えました。infcntの指定値を超えたMCF通信サービスまたはアプリケーション起動サービスの情報は切り捨てられました。

DCMCFRTN_72050

-13050

actionにDCNOFLAGSが設定されていません。

DCMCFRTN_72052

-13052

resv01にNULLが設定されていません。

DCMCFRTN_72053

-13053

resv02にNULLが設定されていません。

DCMCFRTN_72056

-13056

infcntにNULLが設定されています。

DCMCFRTN_72057

-13057

infにNULLが設定されています。

DCMCFRTN_72076

-13076

infcntに0以下の値が設定されています。