リモートホストへファイルを転送するメソッドです。転送したファイルは常に上書きされます。このメソッドは，処理が終了するかタイムアウトするまで同期実行します。同一のリモートホストに対して，このメソッドおよびほかのメソッドを同時に複数実行した場合，先に受け付けられたメソッドが終了するまで実行は待機します。

表3-23　各プロトコルにおける転送時の仕様

形式

 
public void putFile(String src, String dest)
 

入力

表3-24　入力項目一覧

注※1

英数字，_（半角下線），.（半角ピリオド），△（半角空白），( （半角左括弧），) （半角右括弧），パス区切りの\\（半角円マーク2つ）（Windowsの場合），/（スラッシュ）（Linuxの場合）が使用できます。\\..\\ および \\.\\，*（アスタリスク），ネットワークドライブの指定，UNC形式のパス，ピリオドまたはスペースで終端するディレクトリを含めてはなりません（プログラムガードはされません）。

注※2

転送先がWindowsの場合，パスにリモートホスト上の環境変数を含めることもできます。環境変数は，リモートホストへログインしたユーザの環境変数が適用されます。環境変数を使用する場合，%（パーセント）文字が使用できます。ただし，環境変数の展開後のパスの長さが247文字を超えないようにしてください。超えた場合は，転送に失敗します。

注※3

パスにWindowsおよびMS-DOSの予約語を含めてはなりません。含めた場合，処理に失敗します。予約語については，「表1-8　コマンド形式の構文要素」を参照してください。

出力

入力「転送先フォルダパス」で指定したリモートホスト上のディレクトリの下に，入力「転送元ファイル/フォルダパス」で指定したファイルおよびフォルダがコピーされます。転送先のフォルダが存在しない場合は，自動で作成されます。

例外

表3-25　エラーケース一覧

注　対処方法については，マニュアル「uCosminexus Service Director メッセージ」の「ファイル転送とコマンドのリモート実行時に出力するメッセージの原因コード」を参照してください。

注意事項

同一リモートホストに対して複数のIPアドレスが設定されている場合，異なるIPアドレスを指定して，このメソッドを複数同時実行すると，処理が失敗することがあります。

リモートホストからファイルを取得するメソッドです。転送したファイルは常に上書きされます。このメソッドは，処理が終了するかタイムアウトするまで同期実行します。同一のリモートホストに対して，このメソッドおよびほかのメソッドを同時に複数実行した場合，先に受け付けられたメソッドが終了するまで実行は待機します。

表3-26　各プロトコルにおける取得時の仕様

形式

 
public void getFile(String src, String dest)
 

入力

表3-27　入力項目一覧

注※1

英数字，_（半角下線），.（半角ピリオド），△（半角空白），( （半角左括弧），) （半角右括弧），パス区切りの\\（半角円マーク2つ）（Windowsの場合），/（スラッシュ）（Linuxの場合）が使用できます。\\..\\ および \\.\\，*（アスタリスク），ネットワークドライブの指定，UNC形式のパス，ピリオドまたはスペースで終端するディレクトリを含めてはなりません（プログラムガードはされません）。

注※2

取得元がWindowsの場合，パスにリモートホスト上の環境変数を含めることもできます。環境変数は，リモートホストへログインしたユーザの環境変数が適用されます。環境変数を使用する場合，%（パーセント）が使用できます。ただし，環境変数の展開後のパスの長さが247文字を超えないようにしてください。超えた場合は，取得に失敗します。

注※3

パスにWindowsおよびMS-DOSの予約語を含めてはなりません。含めた場合，処理に失敗します。予約語については，「表1-8　コマンド形式の構文要素」を参照してください。

出力

入力「取得先フォルダパス」で指定したローカルホスト上のフォルダの下に，入力「取得元ファイル/フォルダパス」で指定したファイル/フォルダがコピーされます。取得先のフォルダが存在しない場合は，自動で作成されます。

例外

表3-28　エラーケース一覧

注　対処方法については，マニュアル「uCosminexus Service Director メッセージ」の「ファイル転送とコマンドのリモート実行時に出力するメッセージの原因コード」を参照してください。

注意事項

同一リモートホストに対して複数のIPアドレスが設定されている場合，異なるIPアドレスを指定して，このメソッドを複数同時実行すると，処理が失敗することがあります。

形式

 
public int execCommand(String commandline)
 

入力

表3-29　入力項目一覧

注※1

英数字，_（半角下線），.（半角ピリオド），△（半角空白），( （半角左括弧），) （半角右括弧），パス区切りの\\（半角円マーク2つ）（Windowsの場合），/（スラッシュ）（Linuxの場合）が使用できます。

注※2

リモートホストがWindowsの場合，パスにリモートホスト上の環境変数を含めることもできます。環境変数は，リモートホストへログインしたユーザの環境変数が適用されます。環境変数を使用する場合，%（パーセント）が使用できます。ただし，環境変数の展開後のパスの長さが247文字を超えないようにしてください。超えた場合は，コマンド実行が失敗します。

出力

なし

例外

表3-30　エラーケース一覧

注　対処方法については，マニュアル「uCosminexus Service Director メッセージ」の「ファイル転送とコマンドのリモート実行時に出力するメッセージの原因コード」を参照してください。

注意事項

同一リモートホストに対して複数のIPアドレスが設定されている場合，異なるIPアドレスを指定して，このメソッドを複数同時実行すると，処理が失敗することがあります。