4.1.4.3.1 dts_exejob_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系)の場合、指定値は無効となります。

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+)かつ、相手システムがPCサーバの場合は、グループ名(ドメイン名)として扱います。

job_type(ジョブ結果通知の有無) unsigned型

ジョブ結果通知を受信するかどうかを指定します。省略する場合は0を指定します。値を省略した場合は、ネットワーク定義の値が採用されます。

DTS_API_JOBNORSP : 受信しない

DTS_API_JOBRSP : 受信する

また、ジョブ結果通知を待ち合わせる場合、job_timeでジョブ結果待ち時間を指定してください。

job_time(ジョブ結果待ち時間) unsigned型

ジョブ実行結果受信を監視する時間を指定します(0～65535秒)。0の場合は、無限を意味します。省略するときは、NULLを指定します。値を省略した場合は、ネットワーク定義の値が採用されます。

ジョブ結果通知未発行など、何らかの理由によりジョブ結果通知できない場合を考慮して、ジョブ結果待ち時間を指定することを推奨します。ジョブの最大実行時間を考慮して時間を設定してください。

また、Linkexpress V5.0L10相当以降では、ジョブ結果の時間監視を行わない場合、ジョブ起動時点から30分以内にジョブ結果通知が通知されないとメッセージ(TRx3014)が出力されます。ジョブ結果待ち時間が指定されている場合は、メッセージは出力されません。

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を指定している場合、指定しても意味をもちません。また、job_typeパラメタがDTS_API_JOBRSPかつネットワーク定義node定義命令polling_kindオペランドの指定値が"yes"でない場合は、指定しても意味を持ちません。

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オペランド指定値が採用されます。

目次索引