MFT とともに Ant スクリプトの使用を開始する

Managed File Transfer で Ant スクリプトを使用すると、解釈されたスクリプト言語から複雑なファイル転送操作を調整することができます。

Ant スクリプト

Ant スクリプト (またはビルド・ファイル) は、1 つ以上のターゲットを定義している XML 文書です。これらのターゲットには、実行するタスク・エレメントが含まれます。 Managed File Transfer には、ファイル転送機能を Apache Antに統合するために使用できるタスクが用意されています。 Ant スクリプトについて詳しくは、 Apache Ant プロジェクト Web ページ ( https://ant.apache.org/ ) を参照してください。

Managed File Transfer タスクを使用する Ant スクリプトの例は、ディレクトリー MQ_INSTALLATION_PATH/mqft/samples/fteant の製品のインストールとともに提供されます。

プロトコル・ブリッジ・エージェントでは、 Ant スクリプトはプロトコル・ブリッジ・エージェント・システムで実行されます。これらの Ant スクリプトは、FTP または SFTP サーバー上のファイルに直接アクセスできません。

名前空間

名前空間は、ファイル転送 Ant タスクを、同じ名前を共有する可能性がある他の Ant タスクと区別するために使用されます。 Ant スクリプトのプロジェクト・タグで名前空間を定義します。

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns:fte="antlib:com.ibm.wmqfte.ant.taskdefs" default="do_ping">
 
  <target name="do_ping">
     <fte:ping cmdqm="qm@localhost@1414@SYSTEM.DEF.SVRCONN" agent="agent1@qm1" 
      rcproperty="ping.rc" timeout="15"/>
  </target>

</project>

属性 xmlns:fte="antlib:com.ibm.wmqfte.ant.taskdefs" は、ライブラリー com.ibm.wmqfte.ant.taskdefs内で接頭部 fte が付いたタスクの定義を探すように Ant に指示します。

fte を名前空間の接頭部として使用する必要はなく、どの値でも使用できます。名前空間接頭部 fte は、すべての例およびサンプル Ant スクリプトで使用されています。

Ant スクリプトの実行

ファイル転送 Ant タスクを含む Ant スクリプトを実行するには、 fteAnt コマンドを使用します。以下に例を示します。

fteAnt -file ant_script_location/ant_script_name

詳しくは、 fteAnt: MFTでの Ant タスクの実行を参照してください。

戻りコード

ファイル転送 Ant タスクは、Managed File Transfer コマンドと同じ戻りコードを戻します。詳しくは、 MFTの戻りコードを参照してください。