4.1.4.4.1 dts_sndmsg_dcb_tのメンバ一覧

TCP/IPおよびSANの場合
以下の2つの条件を満たすメッセージ転送では、システムの改行コードの違いにより、起動側と応答側でメッセージ長が異なります。そのため、メッセージ長の最大値は、応答側システムのメッセージ長を考慮して指定する必要があります。
- data_typeにDTS_API_TEXTを指定している。
- 改行コードを含むメッセージテキストを転送する。
UNIXシステムからWindows 2000またはWindows XP、Windows 2003システムへのメッセージ転送の場合、指定可能なメッセージ長の最大値は以下のとおりです。

メッセージの最大長=1024-(メッセージテキスト内の改行コード数)
FNA(HICS)の場合
通信バッファ長が1036バイト以下の場合、指定可能なメッセージ長は通信バッファ長-12バイトまでの長さになります。

message_text(メッセージテキスト) *unsigned char型

送信するメッセージを指定します。メッセージテキストは、省略できません。

assoc_cont(コネクション継続) unsigned型

ファイル転送サービスが完了したとき、相手システムとの間のコネクションを継続するかどうかを以下の形式で指定します。値を省略した場合(NULLを指定した場合)は、DTS_API_CUTが採用されます。

DTS_API_CUT : 切断(省略値)

DTS_API_CONT : 継続

DTS_API_CONTを指定した場合に、同一コネクションを継続して転送するには、以下の条件を満たす必要があります。

本関数を発行したプログラムのスレッドと同一スレッドからSNDFILE,RCVFILE,SNDMSGまたはEXEJOBを発行している。
本関数の*appl_name,*system_name,*user_id,*password,*groupと次に発行する関数の*appl_name,*system_name,*user_id,*password,*groupの情報が等しい。

コネクション継続を指定した場合の注意事項を以下に示します。

相手システムとの通信経路に公衆回線が使用されている場合、コネクションの継続時間中、回線使用料が課金されます。
目的のファイル転送が完了した時には、コネクションを切断してください。
コネクションを切断するには、以下の2種類の方法があります。
- 最後の転送でassoc_contにDTS_API_CUTを指定する
- RELEASEを発行する
多重度オーバが発生した時に待ち合わせを行う運用では、Linkexpressが回線制御のためにコネクションの切断/再接続を行うことがあります。なお、この時のコネクション操作は利用者プログラムに意識されません。
多重度オーバについては、「導入ガイド」の「3.4.8 多重度オーバ時の動作の指定方法」を参照してください。
TCP/IP(HTTP系)およびSANの場合、指定値は無効となります。

user_id(相手側利用者名) *unsigned char型

相手システムの利用者名を20文字以内（Linkexpress V4.0L10相当以前の場合は8文字以内）で指定します。省略するときは、NULLを指定します。

FNA(HICS)の場合、指定しても意味を持ちません。

また、相手システムがLinkexpressサーバでLinkexpress V4.0L10相当以前の場合またはグローバルサーバ/PRIMEFORCEの場合は、8文字以内で指定してください。

本オペランドで指定したセキュリティ情報については、「導入ガイド」の「第9章セキュリティの設定（Linkexpress サーバ）」を参照し、目的に合ったセキュリティ情報を指定してください。

password(相手側パスワード) *password_t型

相手システムの利用者パスワードを31文字以内（Linkexpress V4.0L10相当以前の場合は8文字以内）で指定します。省略するときは、NULLを指定します。

FNA(HICS)の場合、指定しても意味を持ちません。

また、相手システムがLinkexpressサーバでLinkexpress V4.0L10相当以前の場合またはグローバルサーバ/PRIMEFORCEの場合は、8文字以内で指定してください。

group(相手側グループ名) *unsigned char型

相手システムがグローバルサーバ/PRIMEFORCEの場合に、利用者グループ名を8文字以内で指定します。相手システムがグローバルサーバ/PRIMEFORCE以外の場合、または省略するときは、NULLを指定します。

相手システムがUNIXサーバの場合には指定しないでください。

なお、通信プロトコルがTCP/IP(FTP+)およびSANかつ、相手システムがPCサーバの場合は、グループ名(ドメイン名)として扱います。

FNA(HICS)の場合、指定しても意味を持ちません。

protocol_msgoption(プロトコルオプション) *protocol_msg_option_t型

FNA(HICS)の場合に、プロトコル固有情報テーブルを指定します。省略するときは、NULLを指定します。

data_type(データタイプ) unsigned型

転送ファイルのデータタイプを以下の形式で指定します。値を省略(NULL)した場合は、DTS_API_BINARYが採用されます。なお、通信プロトコルがTCP/IP(HTTP系)の場合、省略してください。TCP/IP(HTTP系)では指定値にかかわらずDTS_API_TEXTが採用されます。

DTS_API_TEXT : テキスト

DTS_API_BINARY : バイナリ

ret_tid(結果通知スレッド) unsigned型

PCサーバの場合、転送結果を受信するスレッドIDを指定します(ただし、突き放し型の場合だけ有効です)。

値を省略(NULL)した場合は、要求発行スレッドに対して結果が通知されます。なお、スレッドIDに0を指定すると、任意のスレッドで受信可能となります。

ret_tid(結果通知領域) *ret_id_t型

UNIXサーバの場合、結果通知プロセス情報パラメタパケットのアドレスを指定します(ただし、突き放し型の場合だけ有効です)。値を省略(NULL)した場合は、要求発行スレッドに対して結果が通知されます。

lbsession_id（セション識別子）unsigned 型

ロードバランサを使用した環境において、複数ファイル転送で１サービスを実現する利用者プログラムを使用する場合に指定してください。本パラメタを指定することにより複数ファイル転送を同じ相手に対して行えるように保証します。本パラメタには、getinf()または各転送APIで通知されたセション識別子を指定してください。

サービスにおける初回転送の場合は、本パラメタの値にNULL指定（省略）、およびlbsession_contパラメタにDTS_API_LBSESSION_CONTを指定してください。

本指定はTCP/IP(HTTP系)の場合のみ有効です。その他の場合は指定しても意味を持ちません。

また、ネットワーク定義comdef定義命令lbsession_modeにnoを指定している場合、指定しても意味をもちません。

lbsession_cont（セション継続の有無） unsigned型

ロードバランサを使用した環境において、相手システムとの間のセションを維持するかどうかを以下の形式で指定します。値を省略した場合(NULLを指定した場合)は、DTS_API_LBSESSION_CUTが採用されます。

本指定はTCP/IP(HTTP系)の場合のみ有効です。その他の場合は指定しても意味を持ちません。

また、ネットワーク定義comdef定義命令lbsession_modeにnoを指定している場合は指定値

にかかわらずDTS_API_LBSESSION_CUTで動作します。

DTS_API_LBSESSION_CUT: セション非継続(省略値)

DTS_API_LBSESSION_CONT : セション継続

exp_option(拡張機能の利用有無) *extend_option_t型

autorecovery機能を利用する場合、拡張機能情報パラメタパケットのアドレスを指定します。値を省略(NULL)した場合は、ネットワーク定義のautorecoveryおよびautorecoverymsgオペランド指定値が採用されます。

目次索引