dc_mcf_tactcn − コネクションの確立（C言語）

　ANSI C，C++の形式

　#include <dcmcf.h>
　int dc_mcf_tactcn (DCLONG action, dcmcf_tactcnopt *cnopt,
                     char *proinf, DCLONG *resv02, char *resv03,
                     char *resv04)

　K&R版Cの形式

　#include <dcmcf.h>
　int dc_mcf_tactcn (action, cnopt, proinf, resv02, resv03, resv04)
　DCLONG             action;
　dcmcf_tactcnopt    *cnopt;
　char               *proinf;
　DCLONG             *resv02;
　char               *resv03;
　char               *resv04;

●action

確立するコネクションの指定方法を次の形式で設定します。

｛DCMCFLE｜DCMCFCN｝〔｜DCMCFPRO〕

DCMCFLE

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

DCMCFCN

確立するコネクションをコネクションIDで指定するときに設定します。

DCMCFPRO

TP1/NET/TCP/IP固有の機能を使用するときに設定します。

●cnopt

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

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

typedef struct {
                DCLONG        mcfid;          …MCF通信プロセス識別子
                char          resv01[4];      …予備領域
                char          idnam[9];       …論理端末名称，
                                                コネクションID
                char          resv02[7];      …予備領域
                char          resv03[112];    …予備領域
                char          scnnam[9];      …MCF使用領域
                char          resv04[7];      …予備領域
                char          yournam[9];     …MCF使用領域
                char          resv05[7];      …予備領域
                char          hostnam[143];   …MCF使用領域
                char          resv06[17];     …予備領域
                char          resv07[184];    …予備領域
                } dcmcf_tactcnopt;

• 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，scnnam，resv04，yournam，resv05，hostnam，resv06，resv07

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

●proinf

プロトコル固有領域として，構造体dcmtcp_tactcnを設定します。

TP1/NET/TCP/IP固有の機能を使用しない場合は，NULLを設定します。

プロトコル固有領域の形式を次に示します。

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

typedef struct {
                char              pnam[4];         …プロトコルの名称
                char              resv01[4];       …予備領域
                DCULONG           i_ipaddr;        …自システムの
                                                     IPアドレス
                unsigned short    i_portno;        …自システムの
                                                     ポート番号
                char              resv02[2];       …予備領域
                DCULONG           o_ipaddr;        …相手システムの
                                                     IPアドレス
                unsigned short    o_portno;        …相手システムの
                                                     ポート番号
                char              resv03[2];       …予備領域
                char              i_pathname[128]; …予備領域
                char              o_pathname[128]; …予備領域
                char              resv04[744];     …予備領域
                } dcmtcp_tactcn;

• pnam

  プロトコル固有領域のプロトコル名称を設定します。

  "TCP△"

  TCP/IPプロトコル

• resv01

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

• i_ipaddr

  自システムのIPアドレスを16進形式（ビッグエンディアン）で設定します。

  

  dotted-decimal形式では指定できません。

  自システムのIPアドレスの割り当てをOSに任せる場合は，0を設定してください。

  IPアドレス255.255.255.255は設定できません。

• i_portno

  自システムのポート番号を16進形式（ビッグエンディアン）で設定します。

  

  設定できる範囲は0，または1024〜65535です。

  自システムのポート番号の割り当てをOSに任せる場合は，0を設定してください。

• resv02

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

• o_ipaddr

  相手システムのIPアドレスを16進形式（ビッグエンディアン）で設定します。

  dotted-decimal形式では指定できません。

  IPアドレス0.0.0.0，および255.255.255.255は設定できません。

• o_portno

  相手システムのポート番号を16進形式（ビッグエンディアン）で設定します。

  設定できる範囲は1〜65535です。

• resv03，i_pathname，o_pathname，resv04

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

●resv02，resv03，resv04

NULLを設定します。