4.1.4.1.1 dts_sndfile_dcb_tのメンバ一覧

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

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

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

local_filename(自側ファイル名) *unsigned char型

自システムのファイル名を255文字以内の絶対パスで指定します。

なお、ネットワークドライブ上のファイルは指定できません。ショートカットファイルを指定した場合は、ショートカット自体をファイルとして使用します。

また、ファイル名のワイルドカード指定によって複数ファイルを指定することが可能です。複数ファイル名が指定された場合、一括ファイル転送を行います。

一括ファイル転送機能はTCP/IPの場合のみ有効です。

指定方法の記述例を以下に示します。

/TEMP/sndfileディレクトリ配下の全てのファイルを送信する場合

/TEMP/sndfile/*
/TEMP/sndfileディレクトリ配下のsndから始まるファイルを送信する場合

/TEMP/sndfile/snd*

ディレクトリ名指定の場合で、そのディレクトリにサブディレクトリが存在する場合、サブディレクトリ配下のファイルは一括転送の対象外となります。

UNIXサーバの場合、相対パスで指定すると自側利用者情報で指定した利用者のホームディレクトリが基準となります。

remote_filename(仮想ファイル名) *unsigned char型

相手システムのファイル名を255文字以内で指定します。仮想ファイル名は省略できません。詳細は「運用ガイド」の「1.2.3 仮想ファイル名の指定方法」を参照してください。相手システムがグローバルサーバ/PRIMEFORCEの場合は、「運用ガイド」の「1.2.4 相手システムがグローバルサーバ/PRIMEFORCEの場合の仮想ファイル名指定方法」を参照してください。

また、local_filenameに複数ファイルを指定した場合、複数ファイルを束ねるアーカイブファイル名を指定します。アーカイブファイル名は、ネットワーク定義に指定した拡張子名を使用する必要があります。アーカイブファイル名は、絶対パスまたは相対パスで指定してください。

相対パスで指定した場合、送信ファイルは相手システムの以下のディレクトリに展開されます。

UNIXの場合
サーバ側利用者のホームディレクトリあるいはルートディレクトリ
Windowsの場合
Linkexpressのインストールディレクトリ

なお、相手システムが仮想ファイル名の対応づけを行う場合、相手システムで指定したディレクトリに展開されます。

以下に、一括ファイル転送依頼時の仮想ファイル名の記述例を示します。

ネットワーク定義のarc_identにfarと指定し、相手システムの/TEMP/rcvfileディレクトリ配下に送信する場合

/TEMP/rcvfile/rcvfile.far

一括ファイル転送機能はTCP/IPの場合のみ有効です。

storage_form(相手側格納形態) unsigned型

仮想ファイルに転送データを格納する際の置換モードを以下の形式で指定します。値を省略(NULL)した場合は、DTS_API_REPが採用されます。また、DTS_API_ADDを指定した場合、途中再送はできません。なお、通信プロトコルがTCP/IP(HTTP系)の場合、省略してください。TCP/IP(HTTP系)では指定値にかかわらずDTS_API_REPが採用されます。

DTS_API_REP : ファイル置換え(省略値)

DTS_API_ADD : ファイル追加書き

access_password(相手アクセスパスワード) *password_t型

仮想ファイルへのアクセスパスワードを8文字以内で指定します。省略する場合は、NULLを指定します。

TCP/IPおよびSANの場合 : 指定しても意味を持ちません。

FNAの場合 : 4文字以内で指定します。

data_type(データタイプ) unsigned型

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

DTS_API_TEXT : テキスト

DTS_API_BINARY : バイナリ

file_attr(仮想ファイル属性) *file_attr_t型

仮想ファイル属性領域を指定します。ただし、通信プロトコルがTCP/IP(FTP)、TCP/IP(FTPM)、TCP/IP(HTTP系)、SANの場合は、指定しても意味がありません。値を省略した場合は、レコード形式:固定長、レコード長:80バイトのファイル属性が採用されます。

protocol_option(プロトコルオプション) *protocol_option_t型

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

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

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

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

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

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

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

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

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

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

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

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

TCP/IP(HTTP系)の場合は指定されても無効となります。

local_user(自側利用者情報) *local_user_t型

自側利用者情報を指定します。この情報は、自側ファイルアクセス時の認証に使います。値を省略(NULL)した場合の利用者認証は以下のとおりです。

PCサーバ:利用者認証を行いません。

UNIXサーバ:自側利用者名:lnkexp、自側パスワード:lnkexp0の資格で利用者認証を行います。

speed(転送速度上限値) unsigned型

転送速度上限値を転送するファイルごとに指定します(1～2097152)。ただし、通信プロトコルがSANの場合は、指定しても意味がありません。指定する単位は、Kbyte/Secです。転送速度上限値を省略する場合は、0を指定します。値を省略した場合は、ネットワーク定義の値が採用されます。

[備考]

Linkexpress for Windows NT V2.1L20相当以前のサーバでは、転送速度上限値は1～1024(キロバイト/秒)の範囲です。

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

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

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

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

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

ckrtn(途中再送の有無) unsigned型

途中再送機能の利用の有無を指定します。値を省略(NULL)した場合は、ネットワーク定義の指定値が採用されます。なお、途中再送機能を利用する場合、応答側システムがネットワーク定義で途中再送機能利用ありを指定している必要があります。

DTS_API_INFO : 途中再送機能を利用する

DTS_API_NOINFO : 途中再送機能を利用しない

本指定はTCP/IP(FTP+)の場合のみ有効です。

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

ロードバランサを使用した環境において、複数ファイル転送で1サービスを実現する利用者プログラムを使用する場合に指定してください。本パラメタを指定することにより複数ファイル転送を同じ相手に対して行えるように保証します。本パラメタには、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オペランド指定値が採用されます。

目次索引