dc_mcf_tlscn − コネクションの状態取得（C言語）

　ANSI C，C++の形式

　#include <dcmcf.h>
　int dc_mcf_tlscn (DCLONG action, dcmcf_tlscnopt *cnopt,
                    char *resv01, DCLONG *resv02,
                    char *resv03, DCLONG *infcnt,
　                  dcmcf_cninf *inf, char *resv04)

　K&R版Cの形式

　#include <dcmcf.h>
　int dc_mcf_tlscn (action, cnopt, resv01, resv02, resv03, infcnt,
                    inf, resv04)
　DCLONG            action;
　dcmcf_tlscnopt    *cnopt;
　char              *resv01;
　DCLONG            *resv02;
　char              *resv03;
　DCLONG            *infcnt;
　dcmcf_cninf       *inf;
　char              *resv04;

●action

状態を取得するコネクションの指定方法を次の形式で設定します。

｛DCMCFLE｜DCMCFCN｝

DCMCFLE

状態を取得するコネクションを論理端末名称で指定するときに設定します。

DCMCFCN

状態を取得するコネクションをコネクションIDで指定するときに設定します。

●cnopt

この関数の対象となったコネクションの情報を，構造体dcmcf_tlscnoptに設定します。

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

typedef struct {
                DCLONG    mcfid;        …MCF通信プロセス識別子
                char      resv01[4];    …予備領域
                char      idnam[9];     …論理端末名称，コネクションID
                char      resv02[7];    …予備領域
                char      resv03[112];  …予備領域
                char      resv04[376];  …予備領域
                } dcmcf_tlscnopt;

• mcfid

  処理対象のコネクションを持つMCF通信サービスのMCF通信プロセス識別子^※を設定します。設定できる範囲は0〜239です。

  論理端末名称を使用してコネクションの状態取得を要求する場合は，無効となります。

  0を指定すると，該当するコネクションIDが属するMCF通信サービスを検索します。MCF通信サービスが多い構成やUAPからこの関数を多数発行する場合は，MCF通信プロセス識別子の指定をお勧めします。

  注※

  MCF環境定義（mcftenv -s）で指定するMCF通信プロセス識別子は16進数と見なしてください。

  例えば，MCF通信プロセス識別子が10の場合，16を設定してください。

• resv01

  領域をヌル文字で埋めます。

• idnam

  状態を取得するコネクションの論理端末名称，またはコネクションIDを設定します。論理端末名称，またはコネクションIDは8バイト以内で設定し，文字列の最後にヌル文字を付けます。

• resv02，resv03，resv04

  領域をヌル文字で埋めます。

●resv01，resv02，resv03

NULLを設定します。

●infcnt

コネクション状態を格納する領域dcmcf_cninfの個数として，1を設定します。

処理終了後は，該当するコネクションの個数が返されます。

●inf

コネクション状態を格納する領域dcmcf_cninfを設定します。

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

●resv04

NULLを設定します。

●infcnt

この関数の対象となったコネクションの個数が返されます。

●inf

この関数の対象となったコネクションの情報が，構造体dcmcf_cninfで返されます。

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

typedef struct {
                char      idnam[9];     …コネクションID
                char      resv01[7];    …予備領域
                char      pnam[4];      …プロトコル名
                DCLONG    status;       …コネクション状態
                char      resv02[40];   …予備領域
                } dcmcf_cninf;

• idnam

  要求したコネクションのコネクションIDが設定されます。

• resv01

  領域をヌル文字で埋めます。

• pnam

  要求したコネクションのプロトコル種別が設定されます。

  TCP

  TCP/IPプロトコル

• status

  要求したコネクションの状態として，次の値が設定されます。

  DCMCF_CNST_ACT

  確立状態

  DCMCF_CNST_ACT_B

  確立処理中状態

  DCMCF_CNST_DCT

  解放状態

  DCMCF_CNST_DCT_B

  解放処理中状態

• resv02

  領域をヌル文字で埋めます。