#include "ztc.h"
 
int ZTC_Asyn_trans(char *aite_label,
                   struct change_host_define_t *host_define,
                   struct ztc_tran_label_t *file_labels,
                   struct change_file_define_t *file_define,
                   int count,
                   int *trans_fd);

非同期型の伝送要求を登録します。

aite_label

相手局ラベル名を指定します。

host_define

伝送情報定義の一部を変更して伝送要求を登録する場合は，相手局情報定義の変更内容を格納した構造体を指定します。それ以外の場合は，NULLを指定してください。

file_labels

要素数=count（伝送ファイル数）分のファイルラベル名を格納した配列を指定します。

file_define

再送要求を実行する場合は，ファイル情報定義の変更内容を格納した配列を指定します。サイクル管理をしているファイルの再送の場合は，ファイル情報定義の変更内容を格納した配列を指定します。伝送情報定義の一部を変更して伝送要求を登録する場合は，ファイル情報定義の変更内容を格納した構造体を指定します。それ以外の場合は，NULLを指定してください。

count

file_labelsに指定した配列の要素数（伝送ファイル数）を指定します。1〜99の数値で適切な値を指定してください。

trans_fd

非同期伝送ディスクリプターを格納するための領域へのポインターです。

• ZTC_SUCCESS：正常終了（0）
• その他の番号：「付録D　エラー番号一覧」参照。

• ZTC_Asyn_trans() を使用する際は，必ずZTC_Even() を使用して伝送を終了してください。
• 0件データの扱いがNG指定の場合，ZTC_Asyn_trans() で0件ファイルのファイルラベル名を指定すると，それ以降に指定したファイルラベル名のデータは伝送されません。
• ZTC_Asyn_trans() を使用したプログラムの実行には，スーパーユーザー権限が必要です。
• ZTC_Asyn_trans() の戻り値としてZTC_ERR_COMMAND_REQ_OVER(254) が返ってきた場合は，伝送要求を複数同時に受け付けたためサーバがビジー状態になっているか，サーバが停止しているためにZTC_Syn_trans() による伝送要求が受け付けられなかったことを示しています。ZTC_ERR_COMMAND_REQ_OVER(254) が返ってきた場合は，サーバが停止しているかどうかを調査し，停止している場合はシステム管理者に連絡してください。
• 再送要求を実行する場合は，一つのファイルラベル名しか指定できません。また，ファイル送受信モードが受信モードであるファイルラベル名しか指定できません。
• サイクル管理をしているファイルの再送の場合は，必ず伝送済みのサイクル番号を指定してください。
• サイクル管理をしているファイルの再送の場合，ファイルラベル名は1個しか指定できません。また，サイクル管理をすると定義しているファイルラベル名しか指定できません。
• 再送電文送信モードを指定しているファイルラベルに対して，伝送情報定義の一部を変更して伝送要求を登録した場合，登録自体はエラーになりませんが再送電文送信モードは使用できません。
• 伝送情報定義の一部を変更して伝送要求を登録する場合は，一つのファイルラベル名しか指定できません。