【JP1/AJS3】HULFTファイル転送をジョブネットの一部に！ JP1との連携ポイント解説

HULFT は、サーバー間で確実にファイルを届けるためのファイル転送のデファクトスタンダード製品です。一方 JP1/AJS3 は、各種ジョブを「いつ・どの順番で実行するか」を管理するジョブ管理製品として多くのユーザーに利用されています。

JP1/AJS3 でHULFTによるファイル転送処理をジョブ化することで、ファイル転送の前後処理も併せて
JP1/AJS3 で一元管理できるようになります。

本記事では、HULFT のファイル転送をJP1/AJS3で一元管理する方法と、その設定時のポイントをご紹介します。

HULFTでファイルを転送した後の取り込み処理や、EAIツール・帳票基盤・SaaS などへの連携処理も、すべて
JP1のジョブネットに組み込めます。これにより、「どのシステムに、いつ、どのデータが渡ったのか」をJP1の画面上で追跡でき、システム全体の処理の流れを把握することが可能です。

JP1のカレンダー機能を使うことで、「営業日のみ実行」「月末営業日＋1営業日」など、現場の運用ルールに沿ったきめ細かなスケジュール設定が行えます。HULFTではできない複雑なスケジューリングも、JP1側で実現できるのが大きなポイントです。

HULFTの転送結果をJP1ジョブの終了ステータスとして確認できるため、転送の成否は他の業務ジョブと同様に
JP1/AJS3 で一元的に管理します。

ジョブの異常時の自動リトライ設定やリカバリジョブを組み込むことで、障害発生時の復旧作業や管理者への通知をあらかじめ仕組み化しておくこともできます。

HULFTの転送処理をJP1から実行するためのシステム構成について説明します。

①HULFTがインストールされているサーバーに、JP1/AJS3 - Agent（またはManager）を導入します。
　これにより、そのサーバ上で動作する HULFT の「utlsend / utlrecv」コマンドを、JP1のジョブとして
　実行できるようになります。

②ジョブの定義やスケジュールの情報は、JP1ジョブ管理サーバー（JP1/AJS3 - Manager）が保持しています。

③操作画面を提供する JP1/AJS3 - View で「PCジョブ」または「UNIXジョブ」としてHULFTコマンドを
　実行するジョブを定義します。

JP1/AJS3 - View でHULFT配信ジョブを定義する際の基本的な設定方法をご紹介します。事前に、HULFT側で配信管理情報と集信管理情報を設定します。

JP1/AJS3 では、ジョブのコマンドとしてHULFTコマンド（utlsend / utlrecv）を指定し、パラメータとしてHULFTで設定したファイルIDを設定します。

▼配信（utlsend）を JP1/AJS3 で実行する場合のジョブ設定例

JP1からHULFTの配信・送信コマンド（utlsend / utlrecv）を実行する際は、-sync（同期転送）と-w（タイムアウト時間）の設定が必須です。

なぜ必要なのか？
通常、HULFTのコマンドは「転送要求」を実行した直後に終了します（非同期）。これでは転送が失敗してもJP1側は「正常終了」と判断してしまいます。

-sync（同期転送） の設定：
転送が完了するまでJP1ジョブが「実行中」ステータスを維持します。転送結果がそのままジョブの終了コードに反映されるため、「転送に失敗したのにジョブが正常終了する」事態を防げます。

-w（タイムアウト）の設定：
ファイル転送のタイムアウト値を設定します。ここには転送の所要時間として許容できる時間を秒単位で指定します。なお、-w を省略した場合は、Windowsでは[システム動作環境設定]-[ソケットリードタイムアウト]で指定した時間が適用されます。指定した秒数が経過してもコマンドが終了しない場合はジョブは異常終了しますが、ファイルの転送自体は継続します。

HULFTのファイル配信ジョブが異常終了した場合、JP1/AJS3 では実行したコマンド（utlsend / utlrecv）の終了コードが確認できます。詳細な原因については JP1/AJS3 ではわからないため、HULFTの管理画面を確認する必要があります。

確認の方法は？
JP1で異常を検知したら、HULFT管理画面で対象の配信・集信履歴を突き合わせて問題の特定を行います。

▼JP1/AJS3　ージョブ異常終了時の実行結果詳細画面ー

▼HULFT　ー配信詳細情報画面ー

HULFTのファイルトリガー機能は、ファイル生成や変更、削除を検知して即座に転送できる便利な機能です。

ですが、もし環境の制約で機能が使えなかったり、あるいは「転送の前後にある業務全体」をスムーズに管理したいなら、JP1/AJS3 のファイル監視ジョブがファイルトリガー機能を代替できますので、利用を検討してみてはいかがでしょうか。

設定の概要
1．JP1ファイル監視ジョブを使用して、指定したフォルダ内でのファイル生成を監視します。
2．ファイル生成を検知後、そのファイル名を引き継ぎ情報として後続ジョブへ渡します。
3．後続のジョブにて、HULFTの配信コマンド（utlsend）の引数にそのファイル名を指定し、転送を実行します。

JP1/AJS3 でファイル生成を監視する「ファイル監視ジョブ」を設定します。また、後続ジョブへ作成されたファイル名を渡すため、引き継ぎ情報を設定します。

監視対象ファイル名：監視対象のファイル名をフルパスで指定
引き継ぎ情報 ：作成されたファイル名を取得してマクロ変数「AJS2FILENAME」に格納

utlsendコマンドの-fileパラメータに配信ファイル名としてマクロ変数を指定します。

このように、JP1のファイル監視機能を活用することで、ファイル生成をトリガーとしたHULFTによる自動転送が実現可能です。

冒頭のシステム構成の図のように、配信側と集信側の両方に JP1/AJS3 が導入されていれば、HULFTの配信結果を直接受けて後続ジョブを実行できるため、連携は非常にシンプル、容易に実現できます。

しかし、配信側に JP1/AJS3 が導入されていないなどの理由から、集信側でJP1のファイル監視ジョブで配信されたことを監視して、後続ジョブを起動しなければいけないケースがあります。

この運用の場合ファイル作成の「検知タイミング」に注意が必要です。JP1のファイル監視は、書き込みプロセスがファイルをクローズしたタイミングで条件成立と判定します。しかし、HULFTのファイルクローズのタイミングによっては、全てのデータ転送が完了していないにもかかわらず、ファイル監視ジョブの監視条件が成立してしまうことがあります。

これを防ぐためには、HULFT側で配信が正常終了した時に、ダミーのファイルを作成するように設定し、そのダミーファイルに対してファイル監視ジョブで監視する方法が考えられます。

配信が正常終了した際に、集信後ジョブ（または後続のスクリプト）で「転送完了」を示す空のフラグファイル（例：complete.log）を作成するよう設定します。

ジョブID：「complete」のジョブ起動情報には空のフラグファイル（complete.log）が作成するバッチを設定

1のフラグファイルの作成を監視するファイル監視ジョブを設定します。

後続ジョブ内で実ファイルの処理を行った後、次回の監視に備えてフラグファイルを削除します。

本記事では、JP1/AJS3 とHULFTを連携させる際の具体的な設定方法、運用時の注意点について解説しました。

アシストサポートセンターでは、JP1もHULFTも24時間365日のサポートを提供 しています。
「JP1とHULFTを組み合わせて、より強固な運用基盤を構築したい」「夜間のトラブルにも備えたい」とお考えの方は、両製品の深いノウハウを持つアシストまで、ぜひお気軽にご相談ください。

執筆者情報

• 保木 紗知子

2002年入社、Oracle DatabaseやWebFOCUSをサポート、2023年から
JP1製品のサポートを担当。2024年8月より本ブログ記事を担当することになりました。神戸在住。テーマパークが好きです。