Linkexpress 運用ガイド

1.2.5 ファイル転送のリトライ

Linkexpressを利用したファイル転送では、次のエラーが発生した場合に起動側システムによるファイル転送、およびメッセージ転送のリトライ処理が可能です。

autorecovery機能を利用することで、ファイル転送がエラー終了した場合に自動リトライすることが可能です。autorecovery機能については、「導入ガイド」の「3.5 autorecovery機能の設計」を参照してください。

業務定義では、起動側ファイル転送と相手側ジョブ起動イベントの場合に自動リトライの定義ができます。自動リトライが定義されている場合は、リトライ可能なエラーが発生した時に、指定された間隔で自動的にリトライを行います。なお、autorecovery機能と業務定義の自動リトライの関係については、「導入ガイド」の「3.5 autorecovery機能の設計」を参照してください。
起動側ファイル転送 : lxdworkまたはlxdevent定義命令のretryオペランド
相手側ジョブ起動 : lxdwork定義命令のretryオペランド
業務定義ウィンドウの設定では、[イベントリトライ回数]と[イベントリトライ間隔]の項目欄が自動リトライの設定に相当します。

ファイル転送コマンドでは、lxsndflコマンド、lxrcvflコマンド、lxsndmsgコマンド、およびlxexejobコマンドで自動リトライの定義ができます。拡張オペランド記述ファイルのretryオペランドで自動リトライが指定されている場合、リトライ可能なエラーが発生した時に、指定された間隔で自動的にリトライを行います。拡張オペランド記述ファイルのretyryオペランドについては、「コマンドリファレンス」の「8.5.5.17 retryオペランド」を参照してください。
なお、autorecovery機能と業務定義の自動リトライの関係については、「導入ガイド」の「3.5 autorecovery機能の設計」を参照してください。

利用者プログラムの場合は、エラーコードからリトライの可否を判断して利用者がリトライ処理を作成する必要があります。

• 転送APIの場合、関数の処理結果を示す診断コードはdts_diagnostic_tのメンバとして設定されます。dts_diagnostic_tについては、「利用者プログラム開発ガイド」の「4.1.4 転送APIのパラメタパケット一覧」を参照してください。

  エラー分類 : category_code
  エラーコード : error_code
  詳細エラーコード : detail_code

• 転送コントロールの場合、メソッドの処理結果を示す診断コードは以下のプロパティに設定されます。

  エラー分類 : CategoryCodeプロパティ
  CategoryCodeプロパティについては「利用者プログラム開発ガイド」の「4.2.6.4 CategoryCode(エラー分類コード)」を参照してください。

  エラーコード : ErrorCodeプロパティ
  ErrorCodeプロパティについては「利用者プログラム開発ガイド」の「4.2.6.16 ErrorCode(エラー原因コード)」を参照してください。

  詳細エラーコード : DetailCodeプロパティ
  DetailCodeプロパティ、「利用者プログラム開発ガイド」の「4.2.6.12 DetailCode(詳細エラーコード)」を参照してください。

備考. エラー分類、エラーコードの詳細については、「メッセージ集」の「5.1 診断コードの説明」を参照してください。