ZTC_Syn_trans_Ex()−伝送要求を登録する(同期型)−
形式
#include "ztc.h" int ZTC_Syn_trans_Ex(struct ztc_tran_reqdata_t *reqdata, struct ztc_tran_rtndata_t *rtndata);
機能
伝送要求を登録し,伝送の終了を待って終了結果を返します。
引数
reqdata
伝送登録情報格納用構造体のアドレスを指定します。
rtndata
伝送結果格納用構造体のアドレスを指定します。伝送の終了結果を返します。
戻り値
-
ZTC_SUCCESS:正常終了(0)
-
その他の番号:「付録D エラー番号一覧」参照。
注意事項
-
ZTC_Syn_trans_Ex()の戻り値として,次の値が返ってきた場合,伝送結果格納用構造体に格納されている値は保証されません。
-
ZTC_ERR_INVAL(61)
-
ZTC_ERR_SYSCALL(63)
-
ZTC_ERR_CYCLE_REQ_OVER(250)
-
ZTC_ERR_CHANGE_DEF_REQ_OVER(251)
-
ZTC_ERR_RESND_REQ_OVER(252)
-
ZTC_ERR_USER_ID(253)
-
ZTC_ERR_COMMAND_REQ_OVER(254)
-
ZTC_ERR_NO_MOVE(255)
-
-
0件データの扱いがNG指定の場合,伝送登録情報格納用構造体で0件ファイルのファイルラベル名を指定すると,それ以降に指定したファイルラベル名のデータは伝送されません。
-
ZTC_Syn_trans_Ex() の戻り値としてZTC_ERR_COMMAND_REQ_OVER(254) が返ってきた場合は,伝送要求を複数同時に受け付けたためサーバがビジー状態になっているか,サーバが停止しているためにZTC_Syn_trans_Ex() による伝送要求が受け付けられなかったことを示しています。ZTC_ERR_COMMAND_REQ_OVER(254) が返ってきた場合は,サーバが停止しているかどうかを調査し,停止している場合はシステム管理者に連絡してください。
-
再送要求を実行する場合は,伝送登録情報格納用構造体には1つのファイルラベル名しか指定できません。また,ファイル送受信モードが受信モードであるファイルラベル名しか指定できません。
-
サイクル管理をしているファイルの再送の場合は,必ず伝送済みのサイクル番号を指定してください。
-
サイクル管理をしているファイルの再送の場合,伝送登録情報格納用構造体にはファイルラベル名は1個しか指定できません。また,サイクル管理をすると定義しているファイルラベル名しか指定できません。
-
再送電文送信モードを指定しているファイルラベルに対して,伝送情報定義の一部を変更して伝送要求を登録した場合,登録自体はエラーになりませんが再送電文送信モードは使用できません。
-
伝送情報定義の一部を変更して伝送要求を登録する場合は,伝送登録情報格納用構造体には1つのファイルラベル名しか指定できません。