状態のスコープ 

OTD サブノードである State オブジェクトのスコープを定義します。 

このパラメータの有効なオプションは、次のとおりです。 

• 接続レベル: State のライフサイクルは接続と同じになります。

• リソースアダプタレベル: State のライフサイクルはリソースアダプタと同じになります。その寿命は、リソースアダプタのリサイクル時に終了します。

• OTD レベル: State のライフサイクルは OTD オブジェクトと同じになります。このスコープは State のライフサイクルを表します。その寿命は、コラボレーションの終了時に終了します。

  デフォルトは「接続レベル」です。

パケットサイズ 

1 データパケットあたりのバイト数。また、この数値によってバッファーのサイズも決まります。 

有効な数値。デフォルトは 1024 です。 

タイムアウト 

要求送信後にサーバーから応答を受信するまでの一時停止時間をミリ秒で指定します。 

有効な数値。デフォルトは 1000 です。 

会話を初期化 

アダプタがどのようにして SNA 会話を確立するかを指定します。オプションは次のとおりです。 

• true: アダプタは呼び出し元 TP として SNA 会話を初期化します。

• false: アダプタは呼び出し元 TP として SNA 会話を受け付けます。

true または false を選択します。デフォルトは false です。 

割り当て解除タイプ 

シャットダウンが発行された際に会話の最後で必要となる割り当て解除のタイプを指定します。詳細については、使用する SNA のマニュアルを参照してください。 

次の 4 つのオプションのいずれかを選択します。 

• 0 - SYNC_LEVEL.

• 1 - FLUSH

• 2 - CONFIRM

• 3 - ABEND

  デフォルトは「0 - SYNC_LEVEL」です。

同期レベル 

同期レベルパラメータ (CM_SYNC_LEVEL) を指定します。詳細については、使用する SNA のマニュアルを参照してください。 

0 - なし (デフォルト)

1 - 確認

「0 - なし」または「1 - 確認」を選択します。デフォルトは「0 - なし」です。 

カスタムハンドシェーククラス名 

ユーザーの SNA ハンドシェークロジックを定義します (カスタムハンドシェーククラスの配備方法については付録 B を参照)。 

com.abc.MyClass などの完全修飾クラス名。このクラスはインタフェース com.stc.connector.snalu62.api.snaCustomerHandshake を実装している必要があります。値なし (このプロパティーを空のままにすること) は、SNA 会話ハンドシェークロジックが定義されていないことを示します。代わりに、標準の組み込みハンドシェークロジックが使用されます。 

接続の最大再試行回数 

接続の取得に失敗した場合に接続を確立するための再試行の、最大回数を指定します。 

有効な数値。デフォルトは 3 です。 

接続再試行間隔 

SNA LU62 宛先へのアクセスを再度試みる際の一時停止時間をミリ秒で指定します。この設定は、「接続の最大再試行回数」設定と組み合わせて使用されます。 

たとえば、接続再試行回数の値が 3 で、接続再試行間隔が 30000 の場合、アダプタは SNA 宛先への接続に失敗すると、再接続を 30 秒の間隔で 3 回試みます。 

有効な数値。デフォルトは 30000 です。 

最大接続プールサイズ 

指定された SNALU62 宛先に対する特定のリスナー/モニターの最大同時接続数を定義します。0 (ゼロ) は、最大値が存在しないことを示します。 

有効な数値。デフォルトは 50 です。 

接続のスコープ 

アダプタが使用している受け付けられた接続のスコープを定義します。オプションは次のとおりです。 

• コラボレーションレベル: コラボレーションの実行が完了すると、接続が閉じられます。接続のライフサイクルはコラボレーションと同じになります。

• リソースアダプタレベル: クローズ要求が発生すると、リソースアダプタが接続を閉じます。コラボレーションが複数回実行される間、接続がライブ状態に保たれる可能性があります。

「コラボレーションレベル」または「リソースアダプタレベル」を選択します。デフォルトは「リソースアダプタレベル」です。 

スケジューラ 

このインバウンド通信のスケジューラのタイプを指定します。オプションは次のとおりです。 

• タイマーサービス: 「スケジュール型」、「遅延」、「期間」、および「固定レートで」の値に従ってタスクのスケジューリングが行われます。

• 作業マネージャー: 「スケジュール型」、「遅延」、および「期間」の値に従って作業のスケジューリングが行われます。

  使用するコンテナが JCA 作業管理をサポートしていない場合 (JCA 1.5 より前である場合)、「タイマーサービス」を選択します。

「タイマーサービス」または「作業マネージャー」を選択します。デフォルトは「作業マネージャー」です。 

スケジュール型 

インバウンド通信のスケジュールのタイプを定義します。「繰り返し」は、パラメータ「期間」で定義される一定間隔でタスクが繰り返し実行されるようにスケジューリングされることを示します (次を参照)。 

デフォルト設定は「繰り返し」です。 

この値は変更できません。

遅延 

タスクが実行されるまでの遅延をミリ秒で指定します。詳細については、SNA アダプタの Javadoc を参照してください。 

有効な数値。デフォルトは 0 です。 

期間 

連続するタスク実行間の一定間隔をミリ秒で指定します。このパラメータは、「繰り返し」に設定された「スケジュール型」パラメータと組み合わせて使用されます。 

有効な数値。デフォルトは 100 です。 

固定レートで 

「スケジュール型」パラメータの「繰り返し」設定および「スケジューラ」の「タイマーサービス」タイプと組み合わせて使用されます。オプションは次のとおりです。 

• true: 固定レートを示します。初期実行のスケジュール時刻を基準にして各実行のスケジューリングが行われます。ある実行が何らかの理由によって遅れると、すぐに続けて 2 つまたはそれ以上の実行が発生し、事前に設定された実行スケジュールに戻ります。全体として、実行頻度は指定された期間のちょうど逆数になります。

• false: 固定遅延を示します。1 つ前の実行の実際の実行時刻を基準にして各実行のスケジューリングが行われます。ある実行が何らかの理由によって遅れると、後続の実行も遅れます。全体として、実行頻度は通常、指定された期間の逆数よりも低くなります。

true または false を選択します。デフォルトは false です。 

スケジューラ 

このインバウンド通信のスケジューラのタイプを指定します。オプションは次のとおりです。 

• タイマーサービス: 「スケジュール型」、「遅延」、「期間」、および「固定レートで」の値に従ってタスクのスケジューリングが行われます。

• 作業マネージャー: 「スケジュール型」、「遅延」、および「期間」の値に従って作業のスケジューリングが行われます。

  使用するコンテナが JCA 作業管理をサポートしていない場合 (JCA 1.5 より前である場合)、「タイマーサービス」を選択します。

「タイマーサービス」または「作業マネージャー」を選択します。デフォルトは「作業マネージャー」です。 

スケジュール型 

インバウンド通信のスケジュールのタイプを定義します。オプションは次のとおりです。 

• 1 回: タスクが 1 回実行されるようにスケジューリングされます。

• 繰り返し: パラメータ「期間」で定義される一定間隔でタスクが繰り返し実行されるようにスケジューリングされます (次を参照)。

「1 回」または「繰り返し」を選択します。デフォルトは「繰り返し」です。 

遅延 

タスクが実行されるまでの遅延をミリ秒で指定します。詳細については、SNA アダプタの Javadoc を参照してください。 

有効な数値。デフォルトは 0 です。 

期間 

連続するタスク実行間の一定間隔をミリ秒で指定します。このパラメータは、「繰り返し」に設定された「スケジュール型」パラメータと組み合わせて使用されます。 

有効な数値。デフォルトは 100 です。 

固定レートで 

「スケジュール型」パラメータの「繰り返し」設定および「スケジューラ」の「タイマーサービス」タイプと組み合わせて使用されます。オプションは次のとおりです。 

• true: 固定レートを示します。初期実行のスケジュール時刻を基準にして各実行のスケジューリングが行われます。ある実行が何らかの理由によって遅れると、すぐに続けて 2 つまたはそれ以上の実行が発生し、事前に設定された実行スケジュールに戻ります。全体として、実行頻度は指定された期間のちょうど逆数になります。

• false: 固定遅延を示します。1 つ前の実行の実際の実行時刻を基準にして各実行のスケジューリングが行われます。ある実行が何らかの理由によって遅れると、後続の実行も遅れます。全体として、実行頻度は通常、指定された期間の逆数よりも低くなります。

true または false を選択します。デフォルトは false です。 

状態のスコープ 

OTD サブノードである State オブジェクトのスコープを定義します。 

このパラメータの有効なオプションは、次のとおりです。 

• 接続レベル: State のライフサイクルは接続と同じになります。

• リソースアダプタレベル: State のライフサイクルはリソースアダプタと同じになります。その寿命は、リソースアダプタのリサイクル時に終了します。

• OTD レベル: State のライフサイクルは OTD オブジェクトと同じになります。このスコープは State のライフサイクルを表します。その寿命は、コラボレーションの終了時に終了します。

  デフォルトは「接続レベル」です。

パケットサイズ 

1 データパケットあたりのバイト数。また、この数値によってバッファーのサイズも決まります。 

有効な数値。デフォルトは 1024 です。 

タイムアウト 

要求送信後にサーバーから応答を受信するまでの一時停止時間をミリ秒で指定します。 

有効な数値。デフォルトは 1000 です。 

会話を初期化 

アダプタがどのようにして SNA 会話を確立するかを指定します。オプションは次のとおりです。 

• true: アダプタは呼び出し元 TP として SNA 会話を初期化します。

• false: アダプタは呼び出し可能 TP として SNA 会話を受け付けます。

true または false を選択します。デフォルトは true です。 

割り当て解除タイプ 

シャットダウンが発行された際に会話の最後で必要となる割り当て解除のタイプを指定します。詳細については、使用する SNA のマニュアルを参照してください。 

次の 4 つのオプションのいずれかを選択します。 

• 0 - SYNC_LEVEL.

• 1 - FLUSH

• 2 - CONFIRM

• 3 - ABEND

  デフォルトは「0 - SYNC_LEVEL」です。

同期レベル 

同期レベルパラメータ (CM_SYNC_LEVEL) を指定します。詳細については、使用する SNA のマニュアルを参照してください。 

0 - なし (デフォルト)

1 - 確認

次の 2 つのオプションのいずれかを選択します。 

• 0 - なし。

• 1 - 確認。

  デフォルトは「0 - なし」です。

カスタムハンドシェーククラス名 

ユーザーの SNA ハンドシェークロジックを定義します (カスタムハンドシェーククラスの配備方法については付録 B を参照)。 

com.abc.MyClass などの完全修飾クラス名。このクラスはインタフェース com.stc.connector.snalu62.api.snaCustomerHandshake を実装している必要があります。値なし (このプロパティーを空のままにすること) は、SNA 会話ハンドシェークロジックが定義されていないことを示します。代わりに、標準の組み込みハンドシェークロジックが使用されます。 

接続モード 

接続がいつどのようにして使用可能になるかを指定します。オプションは次のとおりです。 

• 自動: アダプタが SNA 会話を自動的に確立します。

• 手動: SNA 会話を使用できるようになるのは、ユーザーが手動でコラボレーションから OTD 関数 startConversation() を呼び出した場合だけです。ユーザーが OTD 関数 endConversation() を呼び出すと、会話が使用できなくなります。

  ---

  注 –

  OTD 関数 startConversation() と endConversation() は、手動モードでのみ使用されることが想定されています。自動モードでは、これらを明示的に呼び出すことはできません。

  ---

「自動」または「手動」を選択します。デフォルトは「自動」です。 

接続の最大再試行回数 

接続の取得に失敗した場合に接続を確立するための再試行の、最大回数を指定します。 

有効な数値。デフォルトは 3 です。 

接続再試行間隔 

SNA LU62 宛先へのアクセスを再度試みる際の一時停止時間をミリ秒で指定します。この設定は、「接続の最大再試行回数」設定と組み合わせて使用されます。 

たとえば、接続再試行回数の値が 3 で、接続再試行間隔が 30000 の場合、アダプタは SNA 宛先への接続に失敗すると、再接続を 30 秒の間隔で 3 回試みます。 

有効な数値。デフォルトは 30000 です。 

新しい接続を常に作成 

接続確立要求に対して新しい接続の作成を常に試みるかどうかを指定します。オプションは次のとおりです。 

• true: アダプタは、既存接続のマッチングを行わないで常に新しい接続の作成を試みます。

• false: アダプタは既存接続のマッチングを試みます。

true または false を選択します。デフォルトは false です。 

マッチングエラー時に自動再接続 

コンテナから条件に一致する接続を取得したあとで再接続を自動的に試みるかどうかを指定します。オプションは次のとおりです。 

• true: アダプタは条件に一致する無効な接続を破棄し、別の接続の確立を自動的に試みます。

• false: アダプタは、新しい接続の確立を自動的には試みません。代わりに、ユーザーのビジネスルールに制御が委ねられ、そのビジネスルールがこのタイプの障害を検出し、必要な処理を実行します。

true または false を選択します。デフォルトは true です。 

接続の自動切り離し 

接続上の作業が完了したあとでアダプタが接続を自動的に切り離すかどうかを指定します。オプションは次のとおりです。 

• true: アダプタの接続は切り離され、再利用されません。

• false: 再利用できるように接続はそのまま残されます。

true または false を選択します。デフォルトは false です。 

解析または作成モード

レコード処理 OTD に対するこのアダプタ接続の使用方法を指定します。このパラメータを次のように設定します。

• 解析: インバウンドペイロードを解析するために OTD を使用する場合。

• 作成: アウトバウンドペイロードを作成するために OTD を使用する場合。

  OTD の 1 つのインスタンスは、インバウンドペイロードの解析専用として使用するか、あるいはアウトバウンドペイロードの作成専用として使用することができます。同一コラボレーション内で単一の OTD を一度に両方の目的に使用することはできません。

「作成」または「解析」を選択します。

デフォルト設定は「解析」です。

同期

旧バージョンのバッチアダプタプロジェクトだけに適用されます。バージョン 5.0.7 以前のバッチアダプタを使って作成されたプロジェクトを、そのアダプタの動作を変更しないでインポートおよび配備できるようにするための下位互換性を提供します。選択肢は次のとおりです。 

• はい: 旧バージョン (5.0.8 より前のバッチアダプタ) のプロジェクトに対する下位互換性を提供します。アダプタが同期モードで実行され、コラボレーションのインスタンスが一度に 1 つずつ作成されます。

• いいえ: 新しいバッチアダプタプロジェクト用。アダプタが並列モードで実行されます。コラボレーションのインスタンスが複数作成され、それらが同時に実行されます。

  ---

  注 –

  1 つのプロジェクト内で使用されるすべての OTD インスタンスで、このプロパティーが同じ値になるようにしてください。

  ---

「はい」または「いいえ」を選択します。

デフォルト設定は「はい」ですが、この場合、バージョン 5.0.7 以前のバッチアダプタを使って作成されたプロジェクトがシミュレートされます。

最後のレコードの区切り文字

最後のレコードで使用される区切り文字を指定できるようにします。「レコードタイプ」が「区切り」に設定されている場合にのみ、このパラメータを使用します。

一部のメッセージ形式では、レコードセット内の最後のメッセージの末尾には区切り文字を付けないことが推奨されています。ただし、ほとんどの場合、このパラメータを「はい」に設定されたままにしても問題ありません。

「はい」または「いいえ」を選択します。

デフォルト設定は「はい」です。

レコード区切り文字

レコードに使用する区切り文字を指定します。「レコードタイプ」が「区切り」に設定されている場合に、このパラメータを使用します。

入力した値は、1 つ以上のバイトから成るシーケンスとして解釈されます。区切り文字に複数のバイトが含まれている場合、それらの各バイトをコンマで区切る必要があります。 区切り文字の入力時に使用できる形式は、次のとおりです。 

• ASCII 文字: アダプタはすべての ASCII 文字をサポートします。例: *,*,* (*** でレコードが区切られる)例: | (| でレコードが区切られる)

• エスケープされた ASCII: アダプタは \r、\n、\t、および \f をサポートします。例: \r,\n (CR NL でレコードが区切られる)例: \n (NL だけでレコードが区切られる)

• 16 進: アダプタは 0x00 から 0x7E までをサポートします。例: \0x0D,\0x0A (CR NL でレコードが区切られる)

• 8 進: アダプタは 000 から 0177 までをサポートします。例: \015,\012 (「\0x0D,\0x0A」と同じ)

  ---

  注 –

  DBCS データで文字区切り文字を使用する場合には、ダブルバイト文字のどのバイトとも衝突しないシングルバイト文字または同等の 16 進値を使用してください。エスケープされた ASCII、16 進、または 8 進を使用する場合、「\」文字が必要になります。

  ---

データレコードの区切り文字として使用する有効な文字。 

レコードサイズ

レコードサイズ (バイト数) を示す数値を指定します。「レコードタイプ」が「固定」に設定されていて、かつ長さを示す数値を提供する必要がある場合に、このパラメータを使用します。

レコードサイズ (バイト数) を示す、1 から 2,147,483,647 までの数値。

レコードタイプ

コラボレーション内のデータペイロードに含まれるレコードの形式を指定します。

各ペイロードには 0 個以上のレコードが含まれます。このパラメータとその関連パラメータを使用すれば、サービスバス内の別のコンポーネントにレコードを個別に渡すことができます。使用可能なオプションは次のとおりです。 

• 区切り: 「レコード区切り文字」パラメータに指定された区切り文字で、レコードが区切られます。

• 固定: レコードのサイズはどれも、「レコードサイズ」パラメータで指定されたサイズになります。

• 単一レコード: ペイロードを「そのまま」処理する場合に、このオプションを選択します。

• ユーザー定義: このオプションはサポートされません。

「区切り」、「固定」、または「単一レコード」。

デフォルト設定は「区切り」です。

転送前ディレクトリ名

ファイルのリネーム先またはコピー先となる、外部システム上のディレクトリの名前 (パス) を指定します。値としては、リテラルまたはパターン名を指定できます。

この設定は、「転送前コマンド」パラメータが「リネーム」または「コピー」処理の場合にのみ使用されます。

アウトバウンド転送の場合、ディレクトリがまだ存在していなければ、ディレクトリが作成されます。 

「転送前ディレクトリ名がパターン」プロパティーを参照してください。

「名前パターンの使用」を参照してください。

ディレクトリの正確な名前 (パスを含む) を入力するか、パターン名を入力するか、あるいは次のいずれかの値を選択します。 

• %f

• %f.%y%y%y%y%M%M%d%d

  .%h%h%m%m%s%s%S%S%S

• %f.copy

• %f.rename

転送前ディレクトリ名がパターン

次のように、ディレクトリ名がリテラル、名前パターンのいずれとして解釈されるかを指定します。

• はい: ユーザーが入力する名前の値が名前パターンとみなされることを示します。

  「転送前ディレクトリ名」プロパティーを参照してください。

• いいえ: 入力される名前がリテラル、つまり正確に一致すべき対象であることを示します。

「はい」または「いいえ」を選択します。

デフォルト設定は「はい」です。

転送前ファイル名

ファイルのリネーム先またはコピー先となる、外部システム上のファイルの名前を指定します。値はファイル名を表します。値としては、リテラルまたはパターン名を指定できます。

この設定は、「転送前コマンド」パラメータが「リネーム」または「コピー」処理の場合にのみ使用されます。

特殊文字を使用できます。たとえば、パターン %f は元の作業ファイル名を示します。

「転送前ディレクトリ名がパターン」プロパティーを参照してください。

「名前パターンの使用」を参照してください。

ファイルの正確な名前を入力するか、パターン名を入力するか、あるいは次のいずれかの値を選択します。 

• %f

• %f%#

• %f.%y%y%y%y%M%M%d%d.%h%h

  %m%m%s%s%S%S%S

• %f.copy

• %f.rename

転送前ファイル名がパターン

次のように、ファイル名がリテラル、名前パターンのいずれを表しているかを指定します。

• はい: ユーザーが入力する名前の値が名前パターンとみなされることを示します。

  「転送前ファイル名」プロパティーを参照してください。

• いいえ: 入力される名前がリテラル、つまり正確に一致すべき対象であることを示します。パターンマッチングや名前の展開は実行されません。

「はい」または「いいえ」を選択します。

デフォルト設定は「はい」です。

転送前コマンド

実際のファイル転送の直前に必要なアクションを実行できるようにします。インバウンド転送の場合、同じディレクトリおよびファイルのパターンまたは名前を使ってターゲットシステムに対するポーリングを行うほかのクライアントがそのファイルを使用するのを禁止できます。アウトバウンド転送の場合、既存のファイルを自動的にバックアップまたはクリーンアップできます。オプションは次のとおりです。

• リネーム: 保護または復旧のためにターゲットファイルの名前を変更します。

• コピー: バックアップまたは復旧のためにターゲットファイルをコピーします。

• なし: 何も行いません。

  適切な保護、バックアップ、または復旧を実現するには、目的に合った適切な設定を選択する必要があります。たとえば、アウトバウンド追加転送時の障害から復旧するには、「コピー」設定を使用します。

  ---

  注 –

  「リネーム」使用時にリネーム後のファイルが存在している場合の動作は、FTP サーバーごとに異なる可能性があります。たとえば、一部の UNIX FTP サーバーでは、ユーザーへの確認なしに宛先のファイルが上書きされます。つまり、エラーまたは警告メッセージが表示されません。ほかの FTP サーバー、たとえば Windows XP サーバーでは、システムによってエラーが生成され、その結果、呼び出された OTD メソッド内で例外がスローされます。対応する FTP サーバーに固有の動作を必ず熟知しておいてください。自信がない場合は、コマンド行からアクションを実行してみてください。アクション実行時にエラーメッセージが表示される場合、そのアクションによっておそらく、コラボレーション内で例外がスローされます。

  ---

「リネーム」、「コピー」、または「なし」を選択します。

デフォルト設定は「なし」です。

「コピー」オプションを使用すると、コピーするファイルのサイズが大きい場合は特に、システムのパフォーマンスが低下する可能性があります。

SOCKS が有効

FTP コマンド接続が SOCKS サーバーを経由するかどうかを指定します。

「いいえ」を選択した場合、アダプタは SOCKS サーバーに接続しません。この場合、「SOCKS」セクションの下にあるその他のパラメータはすべて無視されます。

このパラメータが「はい」に設定されると、「FTP」設定の下のホスト名が localhost や 127.0.0.1 などの一部の名前を正しく解決できない可能性があります。実際の IP またはマシン名を使ってホストを表してください。詳細については、「ホスト名」を参照してください。

「はい」または「いいえ」を選択します。

デフォルト設定は「いいえ」です。

SOCKS バージョン

SOCKS サーバーのバージョンを指定します。「不明」を選択した場合、アダプタがユーザーに代わって実際のバージョンを検出します。

最高のパフォーマンスを得るには、バージョン番号 4 または 5 を指定します。

「4」、「5」、または「不明」を選択します。

デフォルト設定は「不明」です。

コマンド接続タイムアウト

FTP コマンド/制御接続ソケットのタイムアウトを設定できるようにします。通常、転送するファイルのサイズが大きくなるほど、この値を高くする必要があります。もちろん、ネットワーク接続の品質もこの設定に影響を与えます。

値の単位はミリ秒です。ゼロのタイムアウトは、タイムアウトが無限であると解釈されます。 

0 から 2147483647 までの整数。

デフォルト設定は 45000 です。

データ接続タイムアウト

FTP データ接続ソケットのタイムアウトを設定できるようにします。通常、低速または高負荷のネットワーク接続では、タイムアウトの設定を高くする必要があります。

値の単位はミリ秒です。ゼロのタイムアウトは、タイムアウトが無限であると解釈されます。 

コマンド/制御接続ソケットのタイムアウトの設定方法については、パラメータ「コマンド接続タイムアウト」を参照してください。

0 から 2147483647 までの整数。

デフォルト設定は 45000 です。

ディレクトリリストスタイル

リモートホストを表すシステムを指定します。このパラメータは、LIST コマンドがファイルリスト情報を返す際の形式を決定するために使用されます。「ディレクトリリストスタイル」の値には、User Defined1 - User Defined10 の値が含まれます。これらのユーザー定義プロパティーを使えば、ユーザー定義の FTP ヒューリスティック設定を複数個作成し、それらを BatchFTP アダプタのプロパティーから選択できるようにすることができます。

対応するヒューリスティック設定は、FtpHeuristics.cfg ファイル内の「User Defined」セクションの下に作成できます。ユーザー定義 FTP 発見的プロパティーの設定方法の詳細については、「FTP ヒューリスティック設定ファイルを変更するには」を参照してください。

このプロパティーは、「ユーザー定義のディレクトリリストスタイル」プロパティーに指定された任意の値によって上書きされます (「ユーザー定義のディレクトリリストスタイル」プロパティーを参照)。 「ディレクトリリストスタイル」プロパティーを有効にするには、「ユーザー定義のディレクトリリストスタイル」プロパティーの値を空白 (空) にする必要があります。

次のいずれかの値。 

• UNIX

• AS400

• AS400-UNIX

• HCLFTPD 6.0.1.3

• HCLFTPD 5.1

• HP NonStop/Tandem

• MPE

• MSFTPD 2.0

• MSP PDS (Fujitsu)

• MSP PS (Fujitsu)

• MVS GDG

• MVS PDS

• MVS Sequential

• Netware 4.11

• NT 3.5

• NT 4.0

• UNIX

• UNIX (EUC-JP

• UNIX (SJIS)

• User Defined

• User Defined (1-10)

• VM/ESA

• VMS

• VOS3 PDS (Hitachi)

• VOS3 PS (Hitachi)

• VOSK (Hitachi)

「ユーザー定義のディレクトリリストスタイル」

ユーザーによって作成され、Application Server 上に配置された FTP ヒューリスティック設定ファイル内で使用可能なユーザー定義ディレクトリリストスタイル (発見的) の名前を指定します。

このプロパティーは、「ディレクトリリストスタイル」および「ユーザー定義のヒューリスティック設定ファイル」プロパティーと連携して動作します。

ユーザー定義のディレクトリリストスタイルの使用方法の詳細については、「カスタムのヒューリスティック設定ファイルを作成するには」を参照してください

選択された「ユーザー定義のディレクトリリストスタイル」または「ユーザー定義のヒューリスティック設定ファイル」のパスが正しく定義されていないと、BatchFTP OTD から例外が生成されます。「ユーザー定義のディレクトリリストスタイル」を指定した場合、「ユーザー定義のヒューリスティック設定ファイル」プロパティーの対応する値も指定する必要があります。

ユーザーによって提供されたヒューリスティック設定ファイル内に定義されているディレクトリリストスタイル (発見的) の名前を表すテキスト文字列値 (デフォルトは空白)。 

PASV の使用

受動、能動のいずれかのモードに入るようにアダプタに指示できます。

通常、FTP サイトへの接続時にユーザーのコンピュータへのデータ接続を確立するのは、そのサイトです。ただし、一部の FTP サイトでは、受動転送、つまりユーザーのコンピュータによるデータ接続の確立が行えます。 

デフォルトでは、受動モードが使用されます。このモードをサポートする FTP サイトとの間で転送を行う場合には、このモードを使用することをお勧めします。 

受動モードが必要になる可能性のある場合は、次のとおりです。 

• ネットワーク上のユーザーが、一部の種類のルーターベースファイアウォールの背後にいる場合

• ネットワークのユーザーが、受動転送を必要とするゲートウェイの背後にいる場合

• 転送が不安定な場合

• ユーザー環境内のあちこちでデータチャネルエラーが発生する場合

「はい」または「いいえ」を選択します。

デフォルト設定は「はい」です。

モード

FTP サーバーとの間のデータ転送に使用されるモードを指定します (Ascii、Binary、Ebcdic のいずれかのモードを使用)。

Ebcdic を選択する場合には、次の点を確認してください。 

• FTP サーバーが EBCDIC モードをサポートしている。

• ユーザーが EBCDIC データを処理している。

Ascii、Binary、または Ebcdic を選択します。

デフォルト設定は「Binary」です。

転送後 raw コマンド

ファイル転送コマンドの直後に使用される FTP raw コマンドを指定します。たとえば、一部の SITE コマンドでは、次の例に示すように、; (セミコロン) を使って一連のコマンドを区切ります。

SITE RECFM=FB;SITE LRECL=50;SITE BLOCKSIZE=32750;SITE

    TRACKS;SITE PRI=5;SITE SEC=5

これらのコマンドは、指定された順に 1 つずつ送信されます。 

転送後 raw コマンドの組み合わせによっては、FTP サーバーで障害が発生した場合にデータが失われる可能性があります。たとえば、インバウンド転送後コマンドが「削除」の場合に転送後 raw コマンドが失敗すると、その削除されたファイルは復旧できません。

1 つ以上の有効な FTP raw コマンド。 

これらのコマンドは FTP サーバーに直接送信されるため、アダプタがそれらのコマンドを解釈することは一切ありません。

転送前 raw コマンド

ファイル転送コマンドの直前に使用される FTP raw コマンドを指定します。たとえば、一部の SITE コマンドでは、; (セミコロン) を使って一連のコマンドを区切ります。

SITE RECFM=FB;SITE LRECL=50;SITE BLOCKSIZE=32750;SITE

    TRACKS;SITE PRI=5;SITE SEC=5

これらのコマンドは、指定された順に 1 つずつ送信されます。 

1 つ以上の有効な FTP raw コマンド。 

これらのコマンドは FTP サーバーに直接送信されるため、アダプタがそれらのコマンドを解釈することは一切ありません。

最大シーケンス番号

ターゲットのディレクトリまたはファイルの名前にシーケンス番号が含まれるように設定した場合に、このパラメータを使用します。これは、この値 (最大シーケンス番号) に達した際にシーケンス番号を「開始シーケンス番号」の値にリセットするように、アダプタに指示します。

このパラメータは、名前パターン %# で使用されます。

1 から 2147483647 までの整数。最大シーケンス番号の値は開始シーケンス番号の値よりも大きくなければいけません。

開始シーケンス番号

ターゲットのディレクトリまたはファイルの名前にシーケンス番号が含まれるように設定した場合に、このパラメータを使用します。これは、前回実行時のシーケンス番号が存在しない場合にどの値から開始するかを、アダプタに指示します。

このパラメータは、名前パターン %# で使用されます。

この最大シーケンス番号の値に達すると、シーケンス番号が開始シーケンス番号の値にリセットされます。

0 から 2147483647 までの整数。開始シーケンス番号の値は最大シーケンス番号の値よりも小さくなければいけません。

転送後ディレクトリ名

ファイルのリネーム先となる、外部システム上のディレクトリの名前 (パス) を指定します。値としては、リテラルまたはパターン名を指定できます。

(宛先への) アウトバウンド転送の場合、ディレクトリがまだ存在していなければ、ディレクトリが作成されます。この設定は、「転送後 コマンド」パラメータが「リネーム」処理の場合にのみ使用されます。

特殊文字を使用できます。たとえば、パターン %f は元の作業ディレクトリ名を示します。このパラメータが使用されるたびに、あらゆる特殊文字の展開が実行されます。

「転送後ディレクトリ名がパターン」プロパティーを参照してください。

ディレクトリの正確な名前 (パスを含む) を入力するか、パターン名を入力するか、あるいは次のいずれかの値を選択します。 

• %f

• %f%#

• %f.%y%y%y%y%M%M%d

  %d.%h%h%m%m%s%s%S%S%S

• %f.rename

転送後ディレクトリ名がパターン

次のように、ディレクトリに対して入力されたパターンがリテラル、名前パターンのいずれを表すかを指定します。

• はい: ユーザーが入力する名前の値が名前パターンとみなされることを示します。

• いいえ: 入力される名前がリテラル、つまり正確に一致すべき対象であることを示します。

「はい」または「いいえ」を選択します。

デフォルト設定は「はい」です。

転送後ファイル名

外部システム上のファイルのリネーム後のファイル名を指定します。値はファイル名を表します。値としては、リテラルまたはパターン名を指定できます。

この設定は、「転送後 コマンド」パラメータが「リネーム」処理の場合にのみ使用されます。

特殊文字を使用できます。たとえば、パターン %f は元の作業ファイル名を示します。

「転送後ディレクトリ名がパターン」プロパティーを参照してください。

ファイルの正確な名前を入力するか、パターン名を入力するか、あるいは次のいずれかの値を選択します。 

• %f

• %f.%y%y%y%y%M%M%d%d.

  %h%h%m%m%s%s%S%S%S

• %f.rename

転送後ファイル名がパターン

次のように、ファイル名に対して入力されたパターンがリテラル、名前パターンのいずれとして解釈されるかを指定します。

• はい: ユーザーが入力する名前の値が名前パターンであることを示します。

  「転送後ファイル名」プロパティーを参照してください。

• いいえ: 入力される名前がリテラル、つまり正確に一致すべき対象であることを示します。パターンマッチングや名前の展開は実行されません。

「はい」または「いいえ」を選択します。

デフォルト設定は「はい」です。

転送後コマンド

実際のファイル転送の直前または「コミット」フェーズ中に、必要なアクションを実行できるようにします。

インバウンド転送の場合、自動バックアップを行う (リネーム) か転送済みのファイルを永続的に破棄する (削除) ことで、そのファイルを「使用済み」としてマークできます。アウトバウンド転送の場合、転送済みのファイルをリネームすることで、ほかのクライアントからそのファイルを使用できるようにすることができます。オプションは次のとおりです。

• リネーム: 転送済みファイルの名前を変更します。

• 削除: 転送済みファイルを削除します (インバウンド転送の場合のみ)。

• なし: 何も行いません。

  ---

  注 –

  「リネーム」使用時にリネーム後のファイルが存在している場合の動作は、FTP サーバーごとに異なる可能性があります。たとえば、一部の UNIX FTP サーバーでは、ユーザーへの確認なしに宛先のファイルが上書きされます。つまり、エラーまたは警告メッセージが表示されません。ほかの FTP サーバー、たとえば Windows XP サーバーでは、システムによってエラーが生成され、その結果、呼び出された OTD メソッド内で例外がスローされます。対応する FTP サーバーに固有の動作を必ず熟知しておいてください。自信がない場合は、コマンド行からアクションを実行してみてください。アクション実行時にエラーメッセージが表示される場合、そのアクションによっておそらく、コラボレーション内で例外がスローされます。

  ---

「リネーム」、「削除」、または「なし」を選択します。

デフォルト設定は「なし」です。

追加

既存ファイルにデータを上書きするか、あるいはデータを追加するかを指定します。このパラメータを使用するのは、アウトバウンド FTP 転送の場合だけです。次のように適切な設定を選択します。

• ユーザーが「はい」を選択し、かつターゲットファイルがすでに存在していた場合には、その既存ファイルにデータが追加されます。

• ユーザーが「いいえ」を選択した場合、アダプタはリモートシステム上の既存ファイルを上書きします。

  同じ名前のファイルが存在しない場合、「はい」、「いいえ」のいずれの場合も、外部ホスト上で新しいファイルが作成されます。

「はい」または「いいえ」を選択します。

デフォルト設定は「いいえ」です。

ターゲットディレクトリ名

ファイルの取得元または送信先となる、外部システム上のディレクトリを指定します。ディレクトリ名とパスを指定することをお勧めしますが、指定しなかった場合、パスは、FTP サーバーにログオンした際のホームディレクトリから見た相対パスになります。

値としては、リテラル、正規表現 (ソースの場合)、またはパターン名 (宛先の場合) を指定できます。 

アウトバウンド FTP 処理 (宛先) の場合、ディレクトリがまだ存在していなければ、ディレクトリが作成されます。 

「ターゲットディレクトリ名がパターン」プロパティーを参照してください。

ターゲット外部システム上のディレクトリ名とパス。 

ターゲットディレクトリ名がパターン

次のように、ディレクトリ名がリテラルを表すか、あるいは正規表現または名前パターンを表すかを指定します。

• はい: ユーザーが入力する名前の値が名前パターンまたは正規表現とみなされることを示します。

  「ターゲットディレクトリ名」プロパティーを参照してください。

• いいえ: 入力される名前がリテラル、つまり正確に一致すべき対象であることを示します。

「はい」または「いいえ」を選択します。

デフォルト設定は「いいえ」です。

ターゲットファイル名

取得または送信されるリモート FTP ファイルの名前を指定します。値としては、リテラル、正規表現 (受信時)、またはパターン名 (送信時) を指定できます。

MVS GDG システムの場合、ターゲットファイル名としてデータセットのバージョンを指定できます。次に例を示します。 

• ターゲットディレクトリ名 = ”STC.SAMPLE.GDGSET ’

• ターゲットファイル名 = (0) (現在のバージョンを示す)

  「ターゲットディレクトリ名」プロパティーを参照してください。

インバウンドの場合: リテラルファイル名または正規表現。 

アウトバウンドの場合: リテラルファイル名または名前パターン。 

ターゲットファイル名がパターン

次のように、ターゲットファイル名がリテラルを表すか、あるいは正規表現または名前パターンを表すかを指定します。

• はい: ユーザーが入力する名前の値が名前パターンまたは正規表現とみなされることを示します。

  「ターゲットファイル名」プロパティーを参照してください。

• いいえ: 入力される名前がリテラル、つまり正確に一致すべき対象であることを示します。

「はい」または「いいえ」を選択します。

デフォルト設定は「はい」です。

SSH チャネルが確立済み

アダプタが SSH サブプロセスを起動する必要があるかどうかを指定します。

「いいえ」を選択した場合、それは、SSH チャネルがまだ確立されていないことを示します。アダプタは、内部的にサブプロセスを生成したあと、ユーザーに代わってチャネルを確立します。

「いいえ」を選択した場合に設定する必要のあるパラメータは、次のとおりです。

• SSH コマンド行

• SSH 待機ポート (環境プロパティー)

  「いいえ」を選択した場合、次のパラメータの設定は省略可能となります。

• SSH ユーザー名 (環境プロパティー)

• SSH パスワード (環境プロパティー)

  「はい」を選択した場合、それは、すでに確立された SSH チャネルが存在することを示します。つまり、アダプタの外側でチャネルがすでに起動済みであるため、アダプタがチャネルを確立する必要はありません。たとえば、サービスバスの外側でユーザーがコマンドを発行する場合もありますし、このアダプタを実行する前に別の バッチアダプタ インスタンスがすでにチャネルを確立したという情報が得られる場合もあります。

  「はい」を選択した場合に設定する必要のあるパラメータは、次のとおりです。

• SSH 待機ホスト (環境プロパティー)

• SSH 待機ポート (環境プロパティー)

「はい」または「いいえ」を選択します。

デフォルト設定は「いいえ」です。

SSH コマンド行

SSH チャネルの確立に使用されるコマンド行を指定します。このパラメータが必要になるのは、「SSH チャネルが確立済み」パラメータを「いいえ」に設定する場合だけです。

このエントリは、SSH トンネリングをサポートするために使用している追加ソフトウェアアプリケーションが必要とする、完全で正しいコマンド行でなければいけません。このコマンド行はそのまま実行されるため、次のことを確認する必要があります。 

• 必要な引数がすべて含まれている

• 構文が正しい

• ユーザーの SSH 環境に準拠している

  これらの要件を確認するには、サービスバスの外側でこのコマンド行を手動でテストし、このコマンド行が正しく動作することを確認します。このコマンド行をシェルから実行し、追加のユーザー入力がまったく要求されないことを確認します。追加入力が要求される場合は、それが要求されなくなるまで必要な追加パラメータを追加し続けたあと、そのコマンド行をアダプタの設定内で使用します。

  SSH 環境に基づくその他の任意のオプションを指定できます。ただし、そうする場合にはやはり、このコマンド行が正しく完全であることを確認する必要があります。たとえば、次のコマンド行オプションを使ってポート転送を指定できます。

  -L ListenPort:FtpServerHost:FtpServerPort

  この例の ListenPort は、パラメータ 「SSH 待機ポート」に指定されたのと同じ値にする必要があります。FtpServerHost に指定された値は、「FTP」パラメータの下にある「ホスト名」のパラメータ設定を上書きします。FtpServerPort に指定された値は、「FTP」パラメータの下にある「サーバーポート」のパラメータ設定を上書きします。「FTP」パラメータの下にあるその他の設定はすべて、指定された FTP サーバー FtpServerHost:FtpServerPort に対して機能します。

  SSH コマンド行によって確立された SSH チャネルを、異なるクライアントホスト上に配置されたほかの バッチアダプタ インスタンスと共有する必要がある場合には、ほかのホストからの非ローカル接続を許可するように SSH ポート転送を設定する必要があります。一部の SSH クライアントでは、オプション -g を使用できます。

  ---

  注 –

  SSH 設定ファイル内でポート転送を指定することもできます。

  ---

有効な SSH コマンド行。 

SSH コマンド行

コマンド行の構文は、使用する SSH クライアント実装の種類に応じて異なる可能性があります。詳細については、SSH トンネリングサポートソフトウェアのユーザーマニュアルを参照してください。 

例 

ssh -L 3456:ftp.sun.com:21 -o BatchMode=yes apple 

ssh -L 4567:apple:21 -o BatchMode=yes apple 

ssh -L 5678:orange:21 -o BatchMode=yes apple 

ssh -L 6789:orange:21 -g -o BatchMode=yes apple 

plink -L 4567:apple:21 apple 

plink -L 5678:orange:21 apple 

plink -L 6789:orange:21 -g apple 

SSH トンネリングが有効

FTP コマンド接続が SSH トンネル経由でセキュリティー保護されるかどうかを指定します。

「いいえ」を選択すると、このセクション内のその他のパラメータはすべて無視されます。

SSH ポート転送機能を使用するには、使用しているサーバーの種類やその現在の設定内容によっては FTP サーバーを設定し直さなければいけない可能性があります。

「はい」または「いいえ」を選択します。

デフォルト設定は「いいえ」です。

ssh -L 4567:apple:21 -o BatchMode=yes apple

同期

旧バージョンのバッチアダプタプロジェクトだけに適用されます。バージョン 5.0.7 以前のバッチアダプタを使って作成されたプロジェクトを、そのアダプタの動作を変更しないでインポートおよび配備できるようにするための下位互換性を提供します。選択肢は次のとおりです。 

• はい: 旧バージョン (5.0.8 より前のバッチアダプタ) のプロジェクトに対する下位互換性を提供します。アダプタが同期モードで実行され、コラボレーションのインスタンスが一度に 1 つずつ作成されます。

• いいえ: 新しいバッチアダプタプロジェクト用。アダプタが並列モードで実行されます。コラボレーションのインスタンスが複数作成され、それらが同時に実行されます。

  1 つのプロジェクト内で使用されるすべての OTD インスタンスで、このプロパティーが同じ値になるようにしてください。

  ---

  注 –

  シーケンス番号を使用するには、「同期」を「はい」に設定する必要があります。

  ---

「はい」または「いいえ」。

デフォルト設定は「はい」ですが、この場合、バージョン 5.0.7 以前のバッチアダプタを使って作成されたプロジェクトがシミュレートされます。

リモートディレクトリ名

ファイルのリネームまたはコピーの実行場所となる、リモート外部システム上のディレクトリとパスを指定します。これは、「リモート転送前コマンド」が「リネーム」または「コピー」の場合にのみ使用されます。

値としては、リテラル、正規表現 (ソースの場合)、またはパターン名 (宛先の場合) を指定できます。宛先のディレクトリを指定する場合、そのディレクトリがまだ存在していなければ、そのディレクトリが作成されます。 

特殊文字を使用できます。このパラメータが使用されるたびに、 

あらゆる特殊文字の展開 

が実行されます。たとえば、パターン %f は元の作業ディレクトリ名を意味します。

「リモートディレクトリ名がパターン」プロパティーを参照してください。

ターゲットシステム上のディレクトリ名とパス。 

特殊文字を使用できます。 

リモートディレクトリ名がパターン

次のように、ディレクトリに対して入力されたパターンがリテラルを表すのか、あるいは名前パターンまたは正規表現を表すのかを指定します。

• はい: ユーザーが入力する名前の値が名前パターンまたは正規表現とみなされることを示します。

• いいえ: 入力される名前の値がリテラル、つまり正確に一致すべき対象を表していることを示します。パターンマッチングや名前の展開は実行されません。

  「リモートディレクトリ名」プロパティーを参照してください。

「はい」または「いいえ」を選択します。

デフォルト設定は「はい」です。

リモートファイル名

ファイルのリネーム先またはコピー先となる、外部システム上のファイルの名前を指定します。この値は、パスを含まないファイル名を表します。この設定は、「転送前コマンド」パラメータが「リネーム」または「コピー」処理の場合にのみ使用されます。

値としては、リテラル、正規表現 (受信時)、またはパターン名 (送信時) を指定できます。 

特殊文字を使用できます。たとえば、パターン %f は元の作業ファイル名を示します。このパラメータが使用されるたびに、あらゆる特殊文字の展開が実行されます。

「リモートファイル名がパターン」プロパティーを参照してください。

リモートファイル名。 

リモートファイル名がパターン

次のように、ファイル名に対して入力されたパターンがリテラルを表すのか、あるいは名前パターンまたは正規表現を表すのかを指定します。

• はい: ユーザーが入力する名前の値が名前パターンまたは正規表現とみなされることを示します。

• いいえ: 入力される名前の値がリテラル、つまり正確に一致すべき対象であることを示します。パターンマッチングや名前の展開は実行されません。

  「リモートファイル名」プロパティーを参照してください。

「はい」または「いいえ」を選択します。

デフォルト設定は「はい」です。

リモート転送前コマンド

実際のファイル転送の直前に必要なアクションを実行できるようにします。インバウンド転送の場合、同じディレクトリおよびファイルのパターンまたは名前を使ってターゲットシステムに対するポーリングを行うほかのクライアントがそのファイルを使用するのを禁止できます。アウトバウンド転送の場合、既存のファイルを自動的にバックアップ/クリーンアップできます。オプションは次のとおりです。

• リネーム: 保護または復旧のためにターゲットファイルの名前を変更します。

• コピー: バックアップまたは復旧のためにターゲットファイルをコピーします。

• なし: 何も行いません。

  適切な保護、バックアップ、または復旧を実現するには、目的に合った適切な設定を選択する必要があります。たとえば、アウトバウンド追加転送時の障害から復旧するには、「コピー」設定を使用します。

  ---

  注 –

  「リネーム」使用時にリネーム後のファイルが存在している場合の動作は、FTP サーバーごとに異なる可能性があります。たとえば、一部の UNIX FTP サーバーでは、ユーザーへの確認なしに宛先のファイルが上書きされます。つまり、エラーまたは警告メッセージが表示されません。ほかの FTP サーバー、たとえば Windows XP サーバーでは、システムによってエラーが生成され、その結果、呼び出された OTD メソッド内で例外がスローされます。対応する FTP サーバーに固有の動作を必ず熟知しておいてください。自信がない場合は、コマンド行からアクションを実行してみてください。アクション実行時にエラーメッセージが表示される場合、そのアクションによっておそらく、コラボレーション内で例外がスローされます。

  ---

「リネーム」、「コピー」、または「なし」を選択します。

デフォルト設定は「なし」です。

「コピー」オプションを使用すると、コピーするファイルのサイズが大きい場合は特に、システムのパフォーマンスが低下する可能性があります。

ローカルディレクトリ名

「リネーム」または「コピー」で使用されるディレクトリ名 (パス) を指定します。値としては、リテラル、正規表現 (ソースの場合)、またはパターン名 (宛先の場合) を指定できます。

特殊文字を使用できます (名前パターン)。このパラメータが使用されるたびに、あらゆる特殊文字の展開が実行されます。 

「リモートファイル名がパターン」プロパティーを参照してください。

パス区切り文字を入力する際には、バックスラッシュ「\」の代わりにスラッシュ「/」を使用してください。アダプタは、バックスラッシュを特殊文字として解釈します。たとえば、c:/temp/dir を使用します。

ディレクトリ名。 

ローカルディレクトリ名がパターン

次のように、ローカルディレクトリ名がリテラルを表すのか、あるいは正規表現または名前パターンを表すのかを指定します。

• はい: ユーザーが入力する名前の値が名前パターンまたは正規表現とみなされることを示します。

• いいえ: 入力される名前の値がリテラル、つまり正確に一致すべき対象であることを示します。パターンマッチングや名前の展開は実行されません。

  「ローカルディレクトリ名」プロパティーを参照してください。

「はい」または「いいえ」を選択します。

デフォルト設定は「いいえ」です。

ローカルファイル名

「リネーム」または「コピー」で使用されるファイル名を指定します。値としては、リテラル、正規表現 (受信時)、またはパターン名 (送信時) を指定できます。

特殊文字を使用できます。このパラメータが使用されるたびに、あらゆる特殊文字の展開が実行されます。 

「ローカルファイル名がパターン」プロパティーを参照してください。

ファイル名。 

ローカルファイル名がパターン

次のように、ローカルファイル名がリテラルを表すのか、あるいは正規表現または名前パターンを表すのかを指定します。

• はい: ユーザーが入力する名前の値が名前パターンまたは正規表現とみなされることを示します。

• いいえ: 入力される名前の値がリテラル、つまり正確に一致すべき対象であることを示します。

  「ローカルファイル名」プロパティーを参照してください。

「はい」または「いいえ」を選択します。

デフォルト設定は「いいえ」です。

ローカル転送前コマンド

実際のファイル転送の直前に必要なアクションを実行できるようにします。インバウンド転送の場合、同じディレクトリおよびファイルのパターンまたは名前を使ってターゲットシステムに対するポーリングを行うほかのクライアントがそのファイルを使用するのを禁止できます。アウトバウンド転送の場合、既存のファイルを自動的にバックアップできます。オプションは次のとおりです。

• リネーム: 保護または復旧のためにターゲットファイルの名前を変更します。

• コピー: バックアップまたは復旧のためにターゲットファイルをコピーします。

• なし: 何も行いません。

  適切な保護、バックアップ、または復旧を実現するには、目的に合った適切な設定を選択する必要があります。たとえば、アウトバウンド追加転送時の障害から復旧するには、「コピー」設定を使用します。

  ---

  注 –

  「ローカルディレクトリ名」および「ローカルファイル名」プロパティーで指定されるファイルが存在している場合、「リネーム」および「コピー」はそのファイルを上書きします。

  ---

「リネーム」、「コピー」、または「なし」を選択します。

デフォルト設定は「なし」です。

「コピー」オプションを使用すると、コピーするファイルのサイズが大きい場合は特に、システムのパフォーマンスが低下する可能性があります。

セキュリティー保護モード

セキュリティー保護モードを指定します。選択肢は次のとおりです。 

• なし: FTP の形式は平文になります。

• 暗黙的な SSL: ソケット接続の完了直後に SSL ハンドシェークが起動されます。

• 明示的な SSL: AUTH SSL/TLS FTP コマンドを送信するクライアントによって SSL ハンドシェークが起動されます。

「なし」、「暗黙的な SSL」、または「明示的な SSL」を選択します。

「なし」がデフォルト設定になります。

ディレクトリリストスタイル

FTP サーバーのディレクトリリストスタイルを「UNIX」、「NT」、または「MVS」として指定します。これは、FTP サーバーからのディレクトリリスト応答を解析するための「ヒント」を、クライアント側に提供します。

「UNIX」のままにしておきます。現時点でサポートされているオプションは、「UNIX」だけです。

デフォルト設定は「UNIX」です。

受動モードが有効

FTP 受動モードが有効かどうかを指定します。 

「はい」または「いいえ」を選択します。

「はい」は、FTP 受動モードが有効であることを示します。

デフォルト設定は「はい」です。

転送モード

転送の形式がバイナリコード、ASCII テキストのいずれであるかを指定します。 

「BINARY」または「ASCII」を選択します。デフォルト設定は「BINARY」です。

追加

リモートサーバーに新しく転送されるデータを、以前に転送されたデータの末尾に追加するかどうかを指定します。 

「はい」または「いいえ」を選択します。

「はい」は、データが追加されることを示します。

デフォルト設定は「いいえ」です。

サーバー認証が必要

サーバー認証が必要かどうかを指定します。選択肢は次のとおりです。 

• はい: サーバー認証が必要であり、ローカルの信頼できる CA 証明書に対してサーバー証明書を検証できるように、認証に使用されるすべてのパラメータ (「キーストアの場所」、「キーストアパスワード」、「キーストアタイプ」など) を正しく設定する必要があることを示します。

• いいえ: サーバー認証が不要であることを示します。

「はい」または「いいえ」を選択します。

デフォルト設定は「はい」です。

ユーザーの識別名

ログインユーザーの識別名 (DN) を指定します。これは、CSR 返信からインポートされ、クライアント認証の設定に使用されます。 

X.509 の識別名。 

キーストア内の別名

JKS タイプのキーストア内の、ある鍵ペアの別名を指定します。この値は、クライアント認証の設定に使用されます。 

別名。 

別名のパスワード

別名で特定されたキーストア内の鍵ペアエントリを保護するパスワードを指定します。 

別名のパスワード。 

リモートディレクトリ

データの送受信場所となる、FTP サーバー上のディレクトリを指定します。このディレクトリのアクセス可能性は通常、ログインユーザーに依存します。値としては、リテラル、正規表現 (ソースの場合)、またはパターン名 (宛先の場合) を指定できます。 

「リモートディレクトリ名がパターン」プロパティーを参照してください。

リモートディレクトリの名前。 

リモートディレクトリ名がパターン

次のように、リモートディレクトリ名がリテラルを表すのか、あるいは正規表現または名前パターンを表すのかを指定します。 

• はい: ユーザーが入力する名前の値が名前パターンまたは正規表現とみなされることを示します。

• いいえ: 入力される名前の値がリテラル、つまり正確に一致すべき対象であることを示します。

  「リモートディレクトリ」プロパティーを参照してください。

「はい」または「いいえ」を選択します。

デフォルト設定は「いいえ」です。

リモートファイル

リモートサーバー上のファイル名を指定します。 

• 値としては、リテラル、正規表現 (受信時)、またはパターン名 (送信時) を指定できます。

  「リモートディレクトリ名がパターン」プロパティーを参照してください。

リモートファイルの名前。 

リモートファイル名がパターン

次のように、リモートファイル名がリテラルを表すのか、あるいは正規表現または名前パターンを表すのかを指定します。 

• はい: ユーザーが入力する名前の値が名前パターンまたは正規表現とみなされることを示します。

• いいえ: 入力される名前の値がリテラル、つまり正確に一致すべき対象であることを示します。

  「リモートファイル」プロパティーを参照してください。

「はい」または「いいえ」を選択します。

デフォルト設定は「いいえ」です。

ローカルディレクトリ

リモートシステムとの間で送受信されるファイル用のローカルディレクトリ (パス) を指定します。値としては、リテラル、正規表現 (ソースの場合)、またはパターン名 (宛先の場合) を指定できます。 

「ローカルディレクトリ名がパターン」プロパティーを参照してください。

ローカルディレクトリ名。 

ローカルディレクトリ名がパターン

次のように、ローカルディレクトリ名がリテラルを表すのか、あるいは正規表現または名前パターンを表すのかを指定します。 

• はい: ユーザーが入力する名前の値が名前パターンまたは正規表現とみなされることを示します。

• いいえ: 入力される名前の値がリテラル、つまり正確に一致すべき対象であることを示します。パターンマッチングや名前の展開は実行されません。

  「ローカルディレクトリ」プロパティーを参照してください。

「はい」または「いいえ」を選択します。

デフォルト設定は「いいえ」です。

ローカルファイル

ローカルファイル名を指定します。値としては、リテラル、正規表現 (受信時)、またはパターン名 (送信時) を指定できます。 

「ローカルファイル名がパターン」プロパティーを参照してください。

ローカルファイル名。 

ローカルファイル名がパターン

次のように、ローカルファイル名がリテラルを表すのか、あるいは正規表現または名前パターンを表すのかを指定します。 

• はい: ユーザーが入力する名前の値が名前パターンまたは正規表現とみなされることを示します。

• いいえ: 入力される名前の値がリテラル、つまり正確に一致すべき対象であることを示します。パターンマッチングや名前の展開は実行されません。

  「ローカルファイル」プロパティーを参照してください。

「はい」または「いいえ」を選択します。

デフォルト設定は「いいえ」です。

ローカルファイルの上書き

リモートからダウンロードされた新しいデータで既存のデータを上書きするかどうかを指定します。 

「はい」または「いいえ」を選択します。

デフォルト設定は「いいえ」です。

リモートディレクトリ名

ファイルのリネームまたはコピーの実行場所となる、リモート外部システム上のディレクトリの名前 (パス) を指定します。これは、「転送後コマンド」が「リネーム」または「コピー」の場合にのみ使用されます。値としては、リテラル、正規表現 (ソースの場合)、またはパターン名 (宛先の場合) を指定できます。

アウトバウンド (宛先) の場合、ディレクトリがまだ存在していなければ、ディレクトリが作成されます。 

特殊文字を使用できます。たとえば、パターン %f は元の作業ディレクトリ名を意味します。このパラメータが使用されるたびに、あらゆる特殊文字の展開が実行されます。

「リモートディレクトリ名がパターン」プロパティーを参照してください。

外部システム上のディレクトリ名とパス。 

特殊文字を使用できます。 

リモートディレクトリ名がパターン

次のように、リモートディレクトリ名がリテラルを表すのか、あるいは正規表現または名前パターンを表すのかを指定します。

• はい: ユーザーが入力する名前の値が名前パターンまたは正規表現とみなされることを示します。

• いいえ: 入力される名前の値がリテラル、つまり正確に一致すべき対象であることを示します。パターンマッチングや名前の展開は実行されません。

  「リモートディレクトリ名」プロパティーを参照してください。

「はい」または「いいえ」を選択します。

デフォルト設定は「はい」です。

リモートファイル名

ファイルのリネーム先またはコピー先となる、外部システム上のファイルの名前を指定します。この設定は、「転送後コマンド」パラメータが「リネーム」または「コピー」処理の場合にのみ使用されます。

値としては、リテラル、正規表現 (受信時)、またはパターン名 (送信時) を指定できます。 

特殊文字を使用できます。たとえば、パターン %f は元の作業ファイル名を示します。このパラメータが使用されるたびに、あらゆる特殊文字の展開が実行されます。

「リモートファイル名がパターン」プロパティーを参照してください。

ファイル名。 

リモートファイル名がパターン

次のように、リモートファイル名がリテラルを表すのか、あるいは正規表現または名前パターンを表すのかを指定します。

• はい: ユーザーが入力する名前の値が名前パターンまたは正規表現とみなされることを示します。

• いいえ: 入力される名前の値がリテラル、つまり正確に一致すべき対象であることを示します。

  「リモートファイル名」プロパティーを参照してください。

「はい」または「いいえ」を選択します。

デフォルト設定は「はい」です。

リモート転送後コマンド

実際のファイル転送の直後に必要なアクションを実行できるようにします。インバウンド転送の場合にこれを適用すれば、自動バックアップを行う (リネーム) か転送済みのファイルを永続的に破棄する (削除) ことで、そのファイルを「使用済み」としてマークできます。アウトバウンド転送の場合にこれを適用すれば、転送済みのファイルをリネームすることで、ほかのクライアントがそのファイルを使用できるようにすることができます。

• リネーム: 転送済みファイルの名前を変更します。

• 削除: 転送済みのファイルを削除します。

• なし: 何も行いません。

  ---

  注 –

  「リネーム」でリネーム先のファイルが存在していた場合の動作は、FTP サーバーごとに異なる可能性があります。たとえば、一部の UNIX FTP サーバーでは、追加メッセージが表示されずに宛先のファイルが上書きされます。NT FTP サーバーでは、この処理は失敗し、例外が発行されます。これは、統一された動作を定義しておらず、対応する FTP サーバーに固有の動作に従います。

  ---

「リネーム」、「削除」、または「なし」を選択します。

デフォルト設定は「なし」です。

ローカルディレクトリ名

「リネーム」で使用されるディレクトリ名 (パス) を指定します。値としては、リテラル、正規表現 (ソースの場合)、またはパターン名 (宛先の場合) を指定できます。

特殊文字を使用できます。このパラメータが使用されるたびに、あらゆる特殊文字の展開が実行されます。 

パス区切り文字については、バックスラッシュ「\」の代わりにスラッシュ「/」を使用してください。アダプタは、バックスラッシュを特殊文字として解釈します。たとえば、c:/temp/dir を使用します。

「ローカルディレクトリ名がパターン」プロパティーを参照してください。

ローカルディレクトリ名。 

ローカルディレクトリ名がパターン

次のように、ローカルディレクトリ名がリテラルを表すのか、あるいは正規表現または名前パターンを表すのかを指定します。

• はい: ユーザーが入力する名前の値が名前パターンまたは正規表現とみなされることを示します。

• いいえ: 入力される名前の値がリテラル、つまり正確に一致すべき対象であることを示します。パターンマッチングや名前の展開は実行されません。

  「ローカルディレクトリ名」プロパティーを参照してください。

「はい」または「いいえ」を選択します。

デフォルト設定は「いいえ」です。

ローカルファイル名

「リネーム」で使用されるファイル名を指定します。値としては、リテラル、正規表現 (受信時)、またはパターン名 (送信時) を指定できます。

特殊文字を使用できます。このパラメータが使用されるたびに、あらゆる特殊文字の展開が実行されます。 

パス区切り文字については、バックスラッシュ「\」の代わりにスラッシュ「/」を使用してください。アダプタは、バックスラッシュを特殊文字として解釈します。たとえば、c:/temp/dir を使用します。

「ローカルファイル名がパターン」プロパティーを参照してください。

ファイル名。 

ローカルファイル名がパターン

次のように、ローカルファイル名がリテラルを表すのか、あるいは正規表現または名前パターンを表すのかを指定します。

• はい: ユーザーが入力する名前の値が名前パターンまたは正規表現とみなされることを示します。

• いいえ: 入力される名前の値がリテラル、つまり正確に一致すべき対象であることを示します。パターンマッチングや名前の展開は実行されません。

  「ローカルファイル名」プロパティーを参照してください。

「はい」または「いいえ」を選択します。

デフォルト設定は「いいえ」です。

ローカル転送後コマンド

実際のファイル転送の直後に必要なアクションを実行できるようにします。インバウンド転送の場合、

自動バックアップを行う (リネーム) かターゲットファイルを永続的に破棄する (削除) ことで、そのファイルを「使用済み」としてマークできます。

アウトバウンド転送の場合、ターゲットファイルをリネームすることで、ほかのクライアントからそのファイルを使用できるようにすることができます。オプションは次のとおりです。 

• リネーム: ターゲットファイルの名前を変更します。

• 削除: ターゲットファイルを削除します (インバウンド転送の場合のみ)。

• なし: 何も行いません。

  ---

  注 –

  「ローカルディレクトリ名」および「ローカルファイル名」プロパティーで指定されるファイルが存在している場合、「リネーム」はそのファイルを上書きします。

  ---

「リネーム」、「削除」、または「なし」を選択します。

デフォルト設定は「なし」です。

ファイアウォールを使用

ファイアウォールを使用するかどうかを指定します。ファイアウォールを使用する場合、SOCKS 4 と 5 がサポートされます。

「はい」または「いいえ」。「はい」は、ファイアウォールを使用することを示します。

デフォルト設定は「いいえ」です。

SOCKS バージョン

ファイアウォールの SOCKS のバージョンを指定します。サポートされるオプションは、SOCKS version 4 を表す「4」と、SOCKS version 5 を表す「5」です。

SOCKS version 4 の場合は「4」を、SOCKS version 5 の場合は「5」を、それぞれ選択します。

同期

バージョン 5.1 より前のアダプタは同期的に実行されますが、その動作をこのアダプタにシミュレートさせるか、あるいはこのアダプタを並列的に実行するかを指定します。選択肢は次のとおりです。 

• はい: アダプタが同期モードで実行され、コラボレーションのインスタンスが一度に 1 つずつ作成されます。

• いいえ: アダプタが並列モードで実行されます。コラボレーションのインスタンスが複数作成され、それらが同時に実行されます。

  ---

  注 –

  1 つのプロジェクト内で使用されるすべての OTD インスタンスで、このプロパティーが同じ値になるようにしてください。

  ---

「はい」または「いいえ」を選択します。

デフォルト設定は「いいえ」です。

ディレクトリ名

入力ディレクトリ名 (パス) を指定します。 これは、BatchInbound アダプタがトリガーまたはデータファイルを取得するためにポーリングするディレクトリを示します。値としては、リテラルまたは正規表現を指定できます。 

パス区切り文字については、バックスラッシュ「\」の代わりにスラッシュ「/」を使用してください。アダプタは、バックスラッシュを特殊文字として解釈します。たとえば、c:/temp/dir を使用します。

「ディレクトリ名がパターン」プロパティーを参照してください。

ディレクトリ名。 

ディレクトリ名がパターン

次のように、ディレクトリ名がリテラルを表すのか、あるいは正規表現を表すのかを指定します。 

• true: ユーザーが入力する名前の値が正規表現とみなされることを示します。

• false: 入力される名前の値がリテラル、つまり正確に一致すべき対象であることを示します。パターンマッチングや名前の展開は実行されません。

  「ディレクトリ名」プロパティーを参照してください。

  ---

  注 –

  使用方法が不適切だと、再帰的なマッチングが発生する可能性があります。

  ---

true または false を選択します。

デフォルト設定は false です。

ファイル名

入力ファイル名を指定します。値としては、リテラルまたは正規表現を指定できます。 

「ファイル名がパターン」プロパティーを参照してください。

ファイル名。 

ファイル名がパターン

次のように、ターゲットファイル名がリテラルを表すか、あるいは正規表現を表すかを指定します。

• true: ユーザーが入力する名前の値が名前パターンまたは正規表現とみなされることを示します。

• false: 入力される名前の値がリテラル、つまり正確に一致すべき対象であることを示します。パターンマッチングや名前の展開は実行されません。

  「ファイル名」プロパティーを参照してください。

true または false を選択します。

デフォルト設定は true です。 

スケジュール間隔

アダプタが入力ファイルを取得するために入力ディレクトリに対して行う各ポール間のポーリング間隔を、ミリ秒数で指定します。 

アダプタによるディレクトリのポーリング間の時間の長さをミリ秒数で示す数値。 

デフォルト設定は 5000 (つまり 5 秒) です。

転送前ディレクトリ名

ファイルのリネームまたはコピーの実行場所となる、外部システム上のディレクトリの名前 (パス) を指定します。この設定は、「転送前コマンド」パラメータが「リネーム」または「コピー」処理の場合にのみ使用されます。値としては、リテラルまたはパターン名を指定できます。

アウトバウンド転送の場合、ディレクトリがまだ存在していなければ、ディレクトリが作成されます。 

特殊文字を使用できます。たとえば、パターン %f は元の作業ディレクトリ名を示します。このパラメータが使用されるたびに、あらゆる特殊文字の展開が実行されます。参照してください

パス区切り文字については、バックスラッシュ「\」の代わりにスラッシュ「/」を使用してください。アダプタは、バックスラッシュを特殊文字として解釈します。たとえば、c:/temp/dir を使用します。

「転送前ディレクトリ名がパターン」プロパティーを参照してください。

ディレクトリの正確な名前 (パスを含む) を入力するか、パターン名を入力するか、あるいは次のいずれかの値を選択します。 

• %f

• %f.%y%y%y%y%M%M%d%d.

  %h%h%m%m%s%s%S%S%S

• %f.copy

• %f.rename

転送前ディレクトリ名がパターン

次のように、転送前ディレクトリ名がリテラル、名前パターンのいずれを表しているかを指定します。

• はい: ユーザーが入力する名前の値が名前パターンとみなされることを示します。

• いいえ: 入力される名前の値がリテラル、つまり正確に一致すべき対象であることを示します。パターンマッチングや名前の展開は実行されません。

  「転送前ディレクトリ名がパターン」プロパティーを参照してください。

「はい」または「いいえ」を選択します。

デフォルト設定は「いいえ」です。

転送前ファイル名

ファイルのリネーム先またはコピー先となる、外部システム上のファイルの名前を指定します。この設定は、「転送前コマンド」パラメータが「リネーム」または「コピー」処理の場合にのみ使用されます。値としては、リテラルまたはパターン名を指定できます。

特殊文字を使用できます。たとえば、パターン %f は元の作業ファイル名を示します。このパラメータが使用されるたびに、あらゆる特殊文字の展開が実行されます。

「転送前ファイル名がパターン」プロパティーを参照してください。

ファイルの正確な名前を入力するか、パターン名を入力するか、あるいは次のいずれかの値を選択します。 

• %f

• %f%#

• %f.%y%y%y%y%M%M%d%d.%h

  %h%m%m%s%s%S%S%S

• %f.copy

• %f.rename

転送前ファイル名がパターン

次のように、転送前ファイル名がリテラル、名前パターンのいずれを表しているかを指定します。

• はい: ユーザーが入力する名前の値が名前パターンとみなされることを示します。

• いいえ: 入力される名前の値がリテラル、つまり正確に一致すべき対象であることを示します。パターンマッチングや名前の展開は実行されません。

  「転送前ファイル名」プロパティーを参照してください。

「はい」または「いいえ」を選択します。

デフォルト設定は「いいえ」です。

転送前コマンド

実際のファイル転送の直前に実行されるアクションを決定できるようにします。

インバウンドファイル転送の場合、同じディレクトリおよびファイルのパターンまたは名前を使ってターゲットシステムに対するポーリングを行うほかのクライアントがそのファイルを使用するのを禁止できます。アウトバウンド転送の場合、既存ファイルの自動バックアップを行えます。オプションは次のとおりです。 

• リネーム: ターゲットファイルの名前を変更します。

• コピー: ターゲットファイルをコピーします。

• なし: 何も行いません。

「リネーム」、「コピー」、または「なし」を選択します。デフォルトは「なし」です。

「転送前ディレクトリ名」および「転送前の名前」パラメータで指定されるファイルまたはディレクトリが存在している場合、「リネーム」および「コピー」はそれを上書きします。

最大シーケンス番号

ターゲットファイルの名前にシーケンス番号が含まれるように設定した場合に、このパラメータを使用します。これは、この値 (最大シーケンス番号) に達した際にシーケンス番号を「開始シーケンス番号」の値にリセットするように、アダプタに指示します。

このパラメータは、名前パターン %# で使用されます。 

「名前パターンの使用」を参照してください。

1 から 2147483647 までの整数。最大シーケンス番号の値は開始シーケンス番号の値よりも大きくなければいけません。

デフォルト設定値は 999999 です。

開始シーケンス番号

ターゲットファイルの名前にシーケンス番号が含まれるように設定した場合に、このパラメータを使用します。これは、前回実行時のシーケンス番号が存在しない場合にどの値から開始するかを、アダプタに指示します。

また、この最大シーケンス番号の値に達すると、シーケンス番号が開始シーケンス番号の値にリセットされます。

このパラメータは、名前パターン %# で使用されます。 

0 から 2147483647 までの整数。開始シーケンス番号の値は最大シーケンス番号よりも小さくなければいけません。

デフォルト設定値は 1 です。

転送後ディレクトリ名

ファイルのリネームの実行場所となる、外部システム上のディレクトリの名前 (パス) を指定します。この設定は、「転送後 コマンド」パラメータが「リネーム」処理の場合にのみ使用されます。値としては、リテラルまたはパターン名を指定できます。

アウトバウンド転送の場合、ディレクトリがまだ存在していなければ、ディレクトリが作成されます。 

特殊文字を使用できます。たとえば、パターン %f は元の作業ディレクトリ名を示します。このパラメータが使用されるたびに、あらゆる特殊文字の展開が実行されます。

パス区切り文字については、バックスラッシュ「\」の代わりにスラッシュ「/」を使用してください。アダプタは、バックスラッシュを特殊文字として解釈します。たとえば、c:/temp/dir を使用します。

「転送後ディレクトリ名がパターン」プロパティーを参照してください。

ディレクトリの正確な名前 (パスを含む) を入力するか、パターン名を入力するか、あるいは次のいずれかの値を選択します。 

• %f

• %f%#

• %f.%y%y%y%y%M%M%d%d.

  %h%h%m%m%s%s%S%S%S

• %f.copy

• %f.rename

転送後ディレクトリ名がパターン

次のように、転送後ディレクトリ名がリテラル、名前パターンのいずれを表しているかを指定します。

• はい: ユーザーが入力する名前の値が名前パターンとみなされることを示します。

• いいえ: 入力される名前の値がリテラル、つまり正確に一致すべき対象であることを示します。パターンマッチングや名前の展開は実行されません。

  「転送後ディレクトリ名」プロパティーを参照してください。

「はい」または「いいえ」を選択します。

デフォルト設定は「いいえ」です。

転送後ファイル名

転送済みファイルのリネーム後のファイル名 (「リネーム」の場合)、ファイルの移動先となるディレクトリ (「移動」の場合) のいずれかを指定しますが、どちらを指定するかは、パラメータ「転送後コマンド」の設定によって決まります。

値としては、リテラルまたはパターン名を指定できます。 

特殊文字を使用できます。このパラメータが使用されるたびに、あらゆる特殊文字の展開が実行されます。 

「転送後ファイル名がパターン」プロパティーを参照してください。

ファイルの正確な名前を入力するか、パターン名を入力するか、あるいは次のいずれかの値を選択します。 

• %f

• %f.%y%y%y%y%M%M%d%d.

  %h%h%m%m%s%s%S%S%S

• %f.copy

• %f.rename

転送後ファイル名がパターン

次のように、転送後ファイル名がリテラル、名前パターンのいずれを表しているかを指定します。

• はい: ユーザーが入力する名前の値が名前パターンとみなされることを示します。

• いいえ: 入力される名前の値がリテラル、つまり正確に一致すべき対象であることを示します。パターンマッチングや名前の展開は実行されません。

  「転送後ファイル名」プロパティーを参照してください。

「はい」または「いいえ」を選択します。

デフォルト設定は「いいえ」です。

転送後コマンド

実際のファイル転送の直後に必要なアクションを実行できるようにします。インバウンド転送の場合、自動バックアップを行う (リネーム) か転送済みのファイルを永続的に破棄する (削除) ことで、そのファイルを「使用済み」としてマークできます。アウトバウンド転送の場合、転送済みのファイルをリネームすることで、ほかのクライアントからそのファイルを使用できるようにすることができます。オプションは次のとおりです。

• リネーム: ターゲットファイルの名前を変更します。「リネーム」は、「転送後ファイル名」と「転送後ディレクトリ名」で指定されるファイルを上書きします

• コピー: ターゲットファイルをコピーします。

• 削除: ターゲットファイルを削除します (インバウンド転送の場合のみ)。

• なし: 何も行いません。

「リネーム」、「コピー」、「削除」、または「なし」を選択します。

デフォルト設定は「なし」です。

読み取りの再開が有効

次のように、OTD が読み取りの再開機能を処理するかどうかを指定します。

• はい: あとでコラボレーションルールを実行した際に現在のファイルからの読み取りを再開するのに必要なすべての状態情報を、OTD が格納できるようにします。

• いいえ: ストリーミングコンシューマがファイルの最後まで読み取らなかった場合でも、そのファイルが「使用済み」とみなされることを示します。

「はい」または「いいえ」

デフォルト設定は「いいえ」です。

読み取りの再開を使用するには、「同期」を「はい」に設定する必要があります。

同期

旧バージョンのバッチアダプタプロジェクトだけに適用されます。バージョン 5.0.7 以前のバッチアダプタを使って作成されたプロジェクトを、そのアダプタの動作を変更しないでインポートおよび配備できるようにするための下位互換性を提供します。選択肢は次のとおりです。 

• はい: 旧バージョン (5.0.8 より前のバッチアダプタ) のプロジェクトに対する下位互換性を提供します。アダプタが同期モードで実行され、コラボレーションのインスタンスが一度に 1 つずつ作成されます。

• いいえ: 新しいバッチアダプタプロジェクト用。アダプタが並列モードで実行されます。コラボレーションのインスタンスが複数作成され、それらが同時に実行されます。

  ---

  注 –

  1 つのプロジェクト内で使用されるすべての OTD インスタンスで、このプロパティーが同じ値になるようにしてください。

  ---

「はい」または「いいえ」。

デフォルト設定は「はい」ですが、この場合、バージョン 5.0.7 以前のバッチアダプタを使って作成されたプロジェクトがシミュレートされます。

シーケンス番号または読み取りの再開を使用するには、「同期」を「はい」に設定する必要があります。

追加

既存ファイルにデータを上書きするか、あるいはデータを追加するかを指定します。このパラメータを使用するのは、アウトバウンドファイル転送の場合だけです。次のように適切な設定を選択します。

• はい: ターゲットファイルがすでに存在している場合、その既存ファイルにデータが追加されます。

• いいえ: アダプタはリモートシステム上の既存ファイルを上書きします。

  同じ名前のファイルが存在しない場合、「はい」、「いいえ」のいずれの場合も、外部ホスト上で新しいファイルが作成されます。

「はい」または「いいえ」を選択します

デフォルト設定は「いいえ」です。

ターゲットディレクトリ名

ファイルの取得元または送信先となる、ローカルシステム上のディレクトリの名前 (パス) を指定します。値としては、リテラル、正規表現 (ソースの場合)、またはパターン名 (宛先の場合) を指定できます。

アウトバウンド転送 (宛先) の場合、ディレクトリがまだ存在していなければ、ディレクトリが作成されます。 

パス区切り文字については、バックスラッシュ「\」の代わりにスラッシュ「/」を使用してください。アダプタは、バックスラッシュを特殊文字として解釈します。たとえば、c:/temp/dir を使用します。

「ターゲットディレクトリ名がパターン」プロパティーを参照してください。

ディレクトリ名。 

ターゲットディレクトリ名がパターン

次のように、ターゲットディレクトリ名がリテラルを表すのか、あるいは正規表現または名前パターンを表すのかを指定します。

• はい: ユーザーが入力する名前の値が名前パターンまたは正規表現とみなされることを示します。

• いいえ: 入力される名前の値がリテラル、つまり正確に一致すべき対象であることを示します。パターンマッチングや名前の展開は実行されません。

  「ターゲットディレクトリ名」プロパティーを参照してください。

「はい」または「いいえ」を選択します。

デフォルト設定は「はい」です。

ターゲットファイル名

取得または送信対象となる、ローカルシステム上のファイルの名前を指定します。値としては、リテラル、正規表現 (受信時)、またはパターン名 (送信時) を指定できます。

「ターゲットディレクトリ名がパターン」プロパティーを参照してください。

ファイル名。 

ターゲットファイル名がパターン

次のように、ターゲットファイル名がリテラルを表すか、あるいは正規表現または名前パターンを表すかを指定します。

• はい: ユーザーが入力する名前の値が名前パターンまたは正規表現とみなされることを示します。

• いいえ: 入力される名前の値がリテラル、つまり正確に一致すべき対象であることを示します。

  「ターゲットファイル名がパターン」プロパティーを参照してください。

「はい」または「いいえ」を選択します。

デフォルト設定は「いいえ」です。

認証タイプ

クライアント認証タイプを指定します。オプションは次のとおりです。

• PASSWORD

• HOSTBASED

• PUBLICKEY

  使用する認証タイプについては、ユーザー固有の SSH サーバーのマニュアルを参照してください。

「PASSWORD」、「 HOST BASED」、または「PUBLICKEY」を選択します。

デフォルト設定は「PASSWORD」です。

ホスト鍵の検証を行うか

公開鍵の検証による SSH サーバーの認証が有効かどうかを指定します。

「はい」または「いいえ」を選択します。

「はい」を選択すると、公開鍵の検証による SSH サーバーの認証が有効になります。

デフォルト設定は「はい」です。

リモートディレクトリ

データの送受信場所となる、SSH サーバー (SFTP サブシステムを含む) 上のディレクトリを指定します。このディレクトリのアクセス可能性は通常、ログインユーザーに依存します。

リモートディレクトリ。 

リモートファイル

発行されたデータの受信や取得対象データの格納に使用される、リモートサーバー上のファイルの名前を指定します。

リモートファイル。 

ローカルディレクトリ

リモートサーバーとの間で送受信されるファイル用のローカルディレクトリを指定します。

ローカルディレクトリ。 

ローカルファイル

リモートとの間で送受信される、ローカルディレクトリ配下のローカルファイルを指定します。

ローカルファイル。 

コピーを再帰的に行うか

すべてのサブディレクトリをコピーするなど、コピーを再帰的に行うかどうかを指定します。

「はい」または「いいえ」を選択します。「はい」は、コピーを再帰的に行うことを示します。

デフォルト設定は「いいえ」です。 

ファイアウォールを使用

ファイアウォールが使用されるかどうかを指定します。

「はい」または「いいえ」。

「はい」は、ファイアウォールを使用することを示します。

デフォルト設定は「いいえ」です。

SOCKS バージョン

ファイアウォールが必要とする SOCKS のバージョンを指定します。サポートされるオプションは、SOCKS version 4 を表す「4」と、SOCKS version 5 を表す「5」です。

SOCKS version 4 の場合は「4」を、SOCKS version 5 の場合は「5」を、それぞれ選択します。

デフォルト設定は 5 です。

同期

バージョン 5.1 より前のアダプタは同期的に実行されますが、その動作をこのアダプタにシミュレートさせるか、あるいはこのアダプタを並列的に実行するかを指定します。選択肢は次のとおりです。 

• はい: アダプタが同期モードで実行され、コラボレーションのインスタンスが一度に 1 つずつ作成されます。

• いいえ: アダプタが並列モードで実行されます。コラボレーションのインスタンスが複数作成され、それらが同時に実行されます。

  ---

  注 –

  1 つのプロジェクト内で使用されるすべての OTD インスタンスで、このプロパティーが同じ値になるようにしてください。

  ---

「はい」または「いいえ」。

デフォルト設定は、「いいえ」です。

リモートディレクトリ名

ファイルのリネームまたはコピーの実行場所となる、リモート外部システム上のディレクトリの名前 (パス) を指定します。これは、「リモート転送前コマンド」が「リネーム」または「コピー」の場合にのみ使用されます。値としては、リテラル、正規表現 (ソースの場合)、またはパターン名 (宛先の場合) を指定できます。

アウトバウンド (宛先) の場合、ディレクトリがまだ存在していなければ、ディレクトリが作成されます。 

特殊文字を使用できます。このパラメータが使用されるたびに、 

あらゆる特殊文字の展開 

が実行されます。たとえば、パターン %f は元の作業ディレクトリ名を意味します。

「リモートディレクトリ名がパターン」プロパティーを参照してください。

ディレクトリ名。 

リモートディレクトリ名がパターン

次のように、リモートディレクトリ名がリテラルを表すのか、あるいは正規表現または名前パターンを表すのかを指定します。

• はい: ユーザーが入力する名前の値が名前パターンまたは正規表現とみなされることを示します。

• いいえ: 入力される名前の値がリテラル、つまり正確に一致すべき対象であることを示します。パターンマッチングや名前の展開は実行されません。

  「リモートディレクトリ名」プロパティーを参照してください。

「はい」または「いいえ」を選択します。

デフォルト設定は「はい」です。

リモートファイル名

ファイルのリネーム先またはコピー先となる、外部システム上のファイルの名前を指定します。この設定は、「転送前コマンド」パラメータが「リネーム」または「コピー」処理の場合にのみ使用されます。値としては、リテラル、正規表現 (受信時)、またはパターン名 (送信時) を指定できます。

特殊文字を使用できます。たとえば、パターン %f は元の作業ファイル名を示します。このパラメータが使用されるたびに、あらゆる特殊文字の展開が実行されます。

「リモートファイル名がパターン」プロパティーを参照してください。

ファイル名。 

リモートファイル名がパターン

次のように、リモートファイル名がリテラルを表すのか、あるいは正規表現または名前パターンを表すのかを指定します。

• はい: ユーザーが入力する名前の値が名前パターンまたは正規表現とみなされることを示します。

• いいえ: 入力される名前の値がリテラル、つまり正確に一致すべき対象であることを示します。パターンマッチングや名前の展開は実行されません。

  「リモートファイル名」プロパティーを参照してください。

「はい」または「いいえ」を選択します。

デフォルト設定は「はい」です。

リモート転送前コマンド

実際のファイル転送の直前に必要なアクションを実行できるようにします。インバウンド転送の場合、同じディレクトリおよびファイルのパターンまたは名前を使ってターゲットシステムに対するポーリングを行うほかのクライアントがそのファイルを使用するのを禁止できます。アウトバウンド転送の場合、既存のファイルを自動的にバックアップ/クリーンアップできます。オプションは次のとおりです。

• リネーム: 保護または復旧のためにターゲットファイルの名前を変更します。

• コピー: バックアップまたは復旧のためにターゲットファイルをコピーします。

• なし: 何も行いません。

  適切な保護、バックアップ、または復旧を実現するには、目的に合った適切な設定を選択する必要があります。たとえば、アウトバウンド追加転送時の障害から復旧するには、「コピー」設定を使用します。

  ---

  注 –

  「リネーム」使用時にリネーム後のファイルが存在している場合の動作は、FTP サーバーごとに異なる可能性があります。たとえば、一部の UNIX FTP サーバーでは、ユーザーへの確認なしに宛先のファイルが上書きされます。つまり、エラーまたは警告メッセージが表示されません。ほかの FTP サーバー、たとえば Windows XP サーバーでは、システムによってエラーが生成され、その結果、呼び出された OTD メソッド内で例外がスローされます。対応する FTP サーバーに固有の動作を必ず熟知しておいてください。自信がない場合は、コマンド行からアクションを実行してみてください。アクション実行時にエラーメッセージが表示される場合、そのアクションによっておそらく、コラボレーション内で例外がスローされます。

  ---

「リネーム」、「コピー」、または「なし」を選択します。

デフォルト設定は「なし」です。

「コピー」オプションを使用すると、コピーするファイルのサイズが大きい場合は特に、システムのパフォーマンスが低下する可能性があります。

ローカルディレクトリ名

「リネーム」または「コピー」で使用されるローカルディレクトリ名 (パス) を指定します。値としては、リテラル、正規表現 (ソースの場合)、またはパターン名 (宛先の場合) を指定できます。

特殊文字を使用できます。このパラメータが使用されるたびに、あらゆる特殊文字の展開が実行されます。 

「ローカルディレクトリ名がパターン」プロパティーを参照してください。

パス区切り文字を入力する際には、バックスラッシュ「\」の代わりにスラッシュ「/」を使用してください。アダプタは、バックスラッシュを特殊文字として解釈します。たとえば、c:/temp/dir を使用します。

ディレクトリ名。 

ローカルディレクトリ名がパターン

次のように、ローカルディレクトリ名がリテラルを表すのか、あるいは正規表現または名前パターンを表すのかを指定します。

• はい: ユーザーが入力する名前の値が名前パターンまたは正規表現とみなされることを示します。

• いいえ: 入力される名前の値がリテラル、つまり正確に一致すべき対象であることを示します。

  「ローカルディレクトリ名」プロパティーを参照してください。

「はい」または「いいえ」を選択します。

デフォルト設定は「いいえ」です。

ローカルファイル名

「リネーム」または「コピー」で使用されるローカルファイル名を指定します。値としては、リテラル、正規表現 (受信時)、またはパターン名 (送信時) を指定できます。

特殊文字を使用できます。このパラメータが使用されるたびに、あらゆる特殊文字の展開が実行されます。 

「ローカルファイル名がパターン」プロパティーを参照してください。

ファイル名。 

ローカルファイル名がパターン

次のように、ローカルファイル名が

リテラルを表すか、あるいは正規表現または名前パターンを表すかを指定します。 

• はい: ユーザーが入力する名前の値が名前パターンまたは正規表現とみなされることを示します。

• いいえ: 入力される名前の値がリテラル、つまり正確に一致すべき対象であることを示します。パターンマッチングや名前の展開は実行されません。

  「ローカルファイル名」プロパティーを参照してください。

「はい」または「いいえ」を選択します。

デフォルト設定は「いいえ」です。

ローカル転送前コマンド

実際のファイル転送の直前に必要なアクションを実行できるようにします。インバウンド転送の場合、同じディレクトリおよびファイルのパターンまたは名前を使ってターゲットシステムに対するポーリングを行うほかのクライアントがそのファイルを使用するのを禁止できます。アウトバウンド転送の場合、既存のファイルを自動的にバックアップできます。オプションは次のとおりです。

• リネーム: 保護または復旧のためにターゲットファイルの名前を変更します。

• コピー: バックアップまたは復旧のためにターゲットファイルをコピーします。

• なし: 何も行いません。

  適切な保護、バックアップ、または復旧を実現するには、目的に合った適切な設定を選択する必要があります。たとえば、アウトバウンド追加転送時の障害から復旧するには、「コピー」設定を使用します。

  ---

  注 –

  「ローカルディレクトリ名」および「ローカルファイル名」プロパティーで指定されるファイルが存在している場合、「リネーム」および「コピー」はそのファイルを上書きします。

  ---

  「名前パターンの使用」を参照してください。

「リネーム」、「コピー」、または「なし」を選択します。

デフォルト設定は「なし」です。

「コピー」オプションを使用すると、コピーするファイルのサイズが大きい場合は特に、システムのパフォーマンスが低下する可能性があります。

転送モード

転送の形式がバイナリコード、ASCII テキストのいずれであるかを指定します。 

「BINARY」または「ASCII」を選択します。

デフォルト設定は「Binary」です。

リモート EOL

リモートサーバーの行末を指定します。オプションは「CR」、「LF」、「CRLF」です。

「CR」、「LF」、または「CRLF」を選択します。

「CRLF」がデフォルト設定になります。 

転送ブロックサイズ

ファイル転送時に使用されるブロックサイズを指定します。デフォルトを増やさないでください。リモートサーバーがデフォルトよりも大きなブロックサイズをサポートできない可能性があるからです。

ファイル転送時に使用されるブロックサイズを示す整数。 

デフォルト設定は 32768 です。

ローカル読み取りバッファーサイズ

ローカルファイルシステムからの読み取り時に使用されるバッファーのサイズ (バイト) を指定します。

ローカル読み取りバッファーのサイズ (バイト) を示す整数。値 -1 は、ローカルファイルの全体が一度に読み取られることを示します。

認証タイプ

クライアント認証タイプを指定します。オプションは次のとおりです。

• PASSWORD

• HOSTBASED

• PUBLICKEY

  使用する認証タイプについては、ユーザー固有の SSH サーバーのマニュアルを参照してください。

「PASSWORD」、「 HOST BASED」、または「PUBLICKEY」を選択します。

デフォルト設定は「PASSWORD」です。

ホスト鍵の検証を行うか

公開鍵の検証による SSH サーバーの認証が有効かどうかを指定します。

「はい」または「いいえ」を選択します。「はい」を選択すると、公開鍵の検証による SSH サーバーの認証が有効になります。

デフォルト設定は「はい」です。

リモートディレクトリ

データの送受信場所となる、SSH サーバー (SFTP サブシステムを含む) 上のディレクトリ名 (パス) を指定します。このディレクトリのアクセス可能性は通常、ログインユーザーに依存します。値としては、リテラル、正規表現 (ソースの場合)、またはパターン名 (宛先の場合) を指定できます。

「リモートディレクトリ名がパターン」プロパティーを参照してください。

リモートディレクトリ名。 

リモートディレクトリ名がパターン

次のように、リモートディレクトリ名がリテラルを表すのか、あるいは正規表現または名前パターンを表すのかを指定します。 

• はい: ユーザーが入力する名前の値が名前パターンまたは正規表現とみなされることを示します。

• いいえ: 入力される名前の値がリテラル、つまり正確に一致すべき対象であることを示します。パターンマッチングや名前の展開は実行されません。

  「リモートディレクトリ」プロパティーを参照してください。

「はい」または「いいえ」を選択します。

デフォルト設定は「いいえ」です。

リモートファイル

リモートサーバー上のファイルの名前を指定します。値としては、リテラル、正規表現 (受信時)、またはパターン名 (送信時) を指定できます。

「リモートファイル名がパターン」プロパティーを参照してください。

リモートファイル。 

リモートファイル名がパターン

次のように、リモートファイル名がリテラルを表すのか、あるいは正規表現または名前パターンを表すのかを指定します。 

• はい: ユーザーが入力する名前の値が名前パターンまたは正規表現とみなされることを示します。

• いいえ: 入力される名前の値がリテラル、つまり正確に一致すべき対象であることを示します。パターンマッチングや名前の展開は実行されません。

  「リモートファイル」プロパティーを参照してください。

「はい」または「いいえ」を選択します。

デフォルト設定は「いいえ」です。

ローカルディレクトリ

リモートサーバー上のファイルを送受信するためのローカルディレクトリ名 (パス) を指定します。値としては、リテラル、正規表現 (ソースの場合)、またはパターン名 (宛先の場合) を指定できます。

「ローカルディレクトリ名がパターン」プロパティーを参照してください。

ローカルディレクトリ。 

ローカルディレクトリ名がパターン

次のように、「ローカルディレクトリ名」プロパティーの意味を指定します。

• はい: ユーザーが入力する名前の値が名前パターンまたは正規表現とみなされることを示します。

• いいえ: 入力される名前の値がリテラル、つまり正確に一致すべき対象であることを示します。パターンマッチングや名前の展開は実行されません。

  「ローカルディレクトリ」プロパティーを参照してください。

「はい」または「いいえ」を選択します。

デフォルト設定は「いいえ」です。

ローカルファイル

リモートサーバー上で送受信されるローカルファイルを指定します。値としては、リテラル、正規表現 (受信時)、またはパターン名 (送信時) を指定できます。

「ローカルファイル名がパターン」プロパティーを参照してください。

ローカルファイル。 

ローカルファイル名がパターン

次のように、ローカルファイル名がリテラルを表すのか、あるいは正規表現または名前パターンを表すのかを指定します。 

• はい: ユーザーが入力する名前の値が名前パターンまたは正規表現とみなされることを示します。

• いいえ: 入力される名前の値がリテラル、つまり正確に一致すべき対象であることを示します。パターンマッチングや名前の展開は実行されません。

  「ローカルファイル」プロパティーを参照してください。

「はい」または「いいえ」を選択します。

デフォルト設定は「いいえ」です。

リモートディレクトリ名

ファイルのリネームまたはコピーの実行場所となる、リモートシステム上のディレクトリの名前 (パス) を指定します。これは、「転送後コマンド」が「リネーム」または「コピー」の場合にのみ使用されます。値としては、リテラル、正規表現 (ソースの場合)、またはパターン名 (宛先の場合) を指定できます。

アウトバウンド (宛先) の場合、ディレクトリがまだ存在していなければ、ディレクトリが作成されます。 

特殊文字を使用できます。たとえば、パターン %f は元の作業ディレクトリ名を意味します。このパラメータが使用されるたびに、あらゆる特殊文字の展開が実行されます。

「リモートディレクトリ名がパターン」プロパティーを参照してください。

ディレクトリ名。 

リモートディレクトリ名がパターン

次のように、リモートディレクトリ名がリテラルを表すのか、あるいは正規表現または名前パターンを表すのかを指定します。

• はい: ユーザーが入力する名前の値が名前パターンまたは正規表現とみなされることを示します。

• いいえ: 入力される名前の値がリテラル、つまり正確に一致すべき対象であることを示します。パターンマッチングや名前の展開は実行されません。

  「リモートディレクトリ名がパターン」プロパティーを参照してください。

「はい」または「いいえ」を選択します。

デフォルト設定は「はい」です。

リモートファイル名

外部システム上のファイル名を指定します。この設定は、「転送後コマンド」パラメータが「リネーム」または「コピー」処理の場合にのみ使用されます。値としては、リテラル、正規表現 (受信時)、またはパターン名 (送信時) を指定できます。

特殊文字を使用できます。たとえば、パターン %f は元の作業ファイル名を示します。このパラメータが使用されるたびに、あらゆる特殊文字の展開が実行されます。

「リモートファイル名がパターン」プロパティーを参照してください。

ファイル名。 

リモートファイル名がパターン

次のように、リモートファイル名がリテラルを表すのか、あるいは正規表現または名前パターンを表すのかを指定します。

• はい: ユーザーが入力する名前の値が名前パターンまたは正規表現とみなされることを示します。

• いいえ: 入力される名前の値がリテラル、つまり正確に一致すべき対象であることを示します。パターンマッチングや名前の展開は実行されません。

  「リモートファイル名」プロパティーを参照してください。

「はい」または「いいえ」を選択します。

デフォルト設定は「はい」です。

リモート転送後コマンド

実際のファイル転送の直後に必要なアクションを実行できるようにします。インバウンド転送の場合にこれを適用すれば、自動バックアップを行う (リネーム) か転送済みのファイルを永続的に破棄する (削除) ことで、そのファイルを「使用済み」としてマークできます。アウトバウンド転送の場合にこれを適用すれば、転送済みのファイルをリネームすることで、ほかのクライアントがそのファイルを使用できるようにすることができます。

• リネーム: 転送済みファイルの名前を変更します。

• 削除: 転送済みのファイルを削除します。

• なし: 何も行いません。

  ---

  注 –

  「リネーム」でリネーム先のファイルが存在していた場合の動作は、FTP サーバーごとに異なる可能性があります。たとえば、一部の UNIX FTP サーバーでは、追加メッセージが表示されずに宛先のファイルが上書きされます。NT FTP サーバーでは、この処理は失敗し、例外が発行されます。これは、統一された動作を定義しておらず、対応する FTP サーバーに固有の動作に従います。

  ---

「リネーム」、「削除」、または「なし」を選択します。

デフォルト設定は「なし」です。

ローカルディレクトリ名

「リネーム」で使用されるローカルディレクトリ名 (パス) を指定します。値としては、リテラル、正規表現 (ソースの場合)、またはパターン名 (宛先の場合) を指定できます。

特殊文字を使用できます。このパラメータが使用されるたびに、あらゆる特殊文字の展開が実行されます。 

が実行されます。 

「ローカルディレクトリ名がパターン」プロパティーを参照してください。

パス区切り文字を入力する際には、バックスラッシュ「\」の代わりにスラッシュ「/」を使用してください。アダプタは、バックスラッシュを特殊文字として解釈します。たとえば、c:/temp/dir を使用します。

ディレクトリ名。 

ローカルディレクトリ名がパターン

次のように、ローカルディレクトリ名がリテラルを表すのか、あるいは正規表現または名前パターンを表すのかを指定します。

• はい: ユーザーが入力する名前の値が名前パターンまたは正規表現とみなされることを示します。

• いいえ: 入力される名前の値がリテラル、つまり正確に一致すべき対象であることを示します。パターンマッチングや名前の展開は実行されません。

  「ローカルディレクトリ名」プロパティーを参照してください。

「はい」または「いいえ」を選択します。デフォルト設定は「いいえ」です。

ローカルファイル名

「リネーム」で使用されるローカルファイル名を指定します。値としては、リテラル、正規表現 (受信時)、またはパターン名 (送信時) を指定できます。

特殊文字を使用できます。このパラメータが使用されるたびに、あらゆる特殊文字の展開が実行されます。 

「ローカルファイル名がパターン」プロパティーを参照してください。

ファイル名。 

ローカルファイル名がパターン

次のように、ローカルファイル名がリテラルを表すのか、あるいは正規表現または名前パターンを表すのかを指定します。

• はい: ユーザーが入力する名前の値が名前パターンまたは正規表現とみなされることを示します。

• いいえ: 入力される名前の値がリテラル、つまり正確に一致すべき対象であることを示します。パターンマッチングや名前の展開は実行されません。

  「ローカルファイル名」プロパティーを参照してください。

「はい」または「いいえ」を選択します。

デフォルト設定は「いいえ」です。

ローカル転送後コマンド

実際のファイル転送の直後に必要なアクションを実行できるようにします。インバウンド転送の場合、

自動バックアップを行う (リネーム) かターゲットファイルを永続的に破棄する (削除) ことで、そのファイルを「使用済み」としてマークできます。

アウトバウンド転送の場合、ターゲットファイルをリネームすることで、ほかのクライアントからそのファイルを使用できるようにすることができます。オプションは次のとおりです。 

• リネーム: ターゲットファイルの名前を変更します。

• 削除: ターゲットファイルを削除します (インバウンド転送の場合のみ)。

• なし: 何も行いません。

  ---

  注 –

  「ローカルディレクトリ名」および「ローカルファイル名」プロパティーで指定されるファイルが存在している場合、「リネーム」はそのファイルを上書きします。

  ---

「リネーム」、「削除」、または「なし」を選択します。

デフォルト設定は「なし」です。

ファイアウォールを使用

ファイアウォールが使用されるかどうかを指定します。

「はい」または「いいえ」を選択します。

「はい」は、ファイアウォールを使用することを示します。

デフォルト設定は「いいえ」です。

SOCKS バージョン

ファイアウォールの SOCKS のバージョンを指定します。サポートされるオプションは、SOCKS version 4 を表す「4」と、SOCKS version 5 を表す「5」です。

SOCKS version 4 の場合は「4」を、SOCKS version 5 の場合は「5」を、それぞれ選択します。

デフォルト設定は 5 です。

同期

バージョン 5.1 より前のアダプタは同期的に実行されますが、その動作をこのアダプタにシミュレートさせるか、あるいはこのアダプタを並列的に実行するかを指定します。選択肢は次のとおりです。 

• はい: アダプタが同期モードで実行され、コラボレーションのインスタンスが一度に 1 つずつ作成されます。

• いいえ: アダプタが並列モードで実行されます。コラボレーションのインスタンスが複数作成され、それらが同時に実行されます。

  ---

  注 –

  1 つのプロジェクト内で使用されるすべての OTD インスタンスで、このプロパティーが同じ値になるようにしてください。

  ---

「はい」または「いいえ」を選択します。

デフォルト設定は、「いいえ」です。

タイプ

コネクタのタイプを指定します。 

「CICS」と入力します。. CICS 接続の場合、デフォルト値は常に「CICS」になります。

接続トランスポート

CICS アダプタが CICS 領域への要求の送信、および CICS 領域からの応答の取得を行う際に使用する配下の接続トランスポートを指定します。 

次に示す配下の接続トランスポートのいずれかを選択します。

Sun CICS Listener

CICS Transaction Gateway (IBM CICS Transaction Gateway を指定)

「Sun CICS Listener」がデフォルト設定になります。

クラス

CICS クライアントコネクタオブジェクトのクラス名を指定します。 

CICS クライアントコネクタオブジェクトの (クラス) パッケージ名。デフォルトは「com.stc.adapters.cics.CicsClientConnector」です。

プロパティータグ

データソースのアイデンティティーを指定します。このパラメータは、現在の EBobConnectorFactory によって必要とされています。 

データソースのパッケージ名。 

ECI 呼び出しタイプ

ECI 呼び出しタイプが「同期」かどうかを指定します。同期呼び出しは、トランザクションが完了するまで待機したあと、COMMAREA の内容を返します。サポートされているのは同期呼び出しだけです。 

「同期」がデフォルト設定になります。

CICS プログラム

サーバー上で実行される CICS プログラムを指定します。最大長は 8 文字です。 

8 文字以下の CICS プログラム名。 

CICS トランザクション ID

CTG に固有です。CICS トランザクションの ID を指定します。最大長は 4 文字です。属性は次のように、「トランザクション ID を ECI_TPN として使用」で設定される値によって異なります。

「EciTPN」が false に設定されている場合、トランザクション ID の値は、プログラムパラメータで指定されたプログラムへのリンクが持続している間、EIBTRNID 内に格納されます。呼び出されたプログラムは、ミラートランザクション CPMI の下で実行されますが、トランザクション ID のトランザクション名の配下にリンクされます。呼び出されたプログラムは、トランザクション ID のクエリーを行う際にこの名前を使用できます。一部のサーバーはトランザクション ID に基づいて、呼び出されたプログラムのセキュリティー属性やパフォーマンス属性を決定します。

「EciTPN」が true に設定されている場合、トランザクション ID は ECI_TPN トランザクション ID として解釈されます。これは、サーバー内で ECI 要求を処理するために使用されるトランザクションです。このトランザクションは、サーバー内で CICS ミラートランザクションとして定義される必要があります。ECI 要求が拡張される場合、このパラメータが意味を持つのは最初の要求に対してだけです。

4 文字以下の CICS トランザクション ID。 

トランザクション ID を ECI_TPN として使用

CTG に固有です。トランザクション ID が ECI_TPN として解釈されるか、あるいは呼び出されたプログラムがデフォルトミラートランザクション CPMI の下で実行されるかを指定します。オプションは次のとおりです。

true: トランザクション ID が ECI_TPN として解釈されることを示します。

false: 呼び出されたプログラムが、デフォルトミラートランザクション CPMI の下で実行され、トランザクション ID が存在する場合にその配下にリンクされることを示します。

true または false を選択します。false がデフォルト設定になります。

COMMAREA の長さ

ECI に渡される COMMAREA の長さ (バイト) を指定します。 

COMMAREA のバイト長を示す数値。 

CICS Transaction Gateway トランスポートを使用する場合、CICS に送信されるデータは、フルサイズの COMMAREA に一致するように、必要に応じて空白で埋める必要があります。

ECI 拡張モード

呼び出しの最後で作業論理単位が終了されるかどうかを指定します。 

「はい」または「いいえ」。

「はい」は、呼び出しの最後で作業単位が終了されることを示します。

デフォルト設定は「いいえ」です。

ECI LUW トークン

CTG に固有です。呼び出しの所属先となる作業論理単位 (LUW) の識別に使用される整数を指定します。LUW を拡張する場合でも、LUW の開始時にこれを 0 (ゼロ) に設定する必要があります。ECI はこの値を、LUW の最初の (または唯一の) 呼び出しが発生した際に更新します。LUW を拡張する場合、この値は、同じ LUW に関連付けられた後続のすべての呼び出しへの入力として使用されます。

リターンコードが ECI_NO_ERROR でなく、かつ呼び出しが既存の LUW を終了または継続させる場合には、次のようにこのフィールドを使って LUW の状態の報告が行われます。 

• コード 0 (ゼロ) は、LUW が終了し、その更新がバックアウトされたことを示します。

• ゼロ以外のコードは現在の入力値を示します。また、これは、LUW が継続中であり、更新がまだ保留中であることも示します。

  詳細については、『CICS Transaction Gateway: プログラミングガイド』の表「ECI での作業論理単位」を参照してください。

ECI 作業論理単位の識別に使用される整数。 

エンコード

エンコーディングセットの正規名を指定します。 

Sun の Java Runtime Environment 1.1.8 によってサポートされる任意のエンコーディングセット (rt.jar および i18n.jar 内に含まれる) の正規名。例としては、「ASCII」や「Cp500」 (EBCDIC) などが挙げられます。CICS アダプタを z/OS プラットフォーム上で実行している場合は、「エンコード」の値を「Cp500」に設定してください。

CICS 接続モード

外部接続をインスタンス化する際に物理的な接続を確立するかどうかを指定します。オプションは次のとおりです。

自動: 外部接続をインスタンス化する際に物理的な接続を確立します。

手動: 外部接続をインスタンス化する際に物理的な接続を自動的に確立しません。

物理的な接続が自動的に確立されない場合には、コラボレーションから (connect() メソッドを呼び出すなどして) 物理的な接続を確立する必要があります。

「自動」または「手動」。デフォルト設定は「自動」です。

ポーリング間隔

e-Mail ソースファイルのポーリングを行なって新しい受信 e-Mail メッセージの有無を確認する間隔 (ミリ秒) を指定します。 

ポーリング間隔をミリ秒で示す数値。 

デフォルト設定は 5000 (5 秒) です。

入力ファイル名

入力データファイルのファイルマスクを指定します。

ファイルマスク。デフォルトは「input*.txt」です。*.txt のように拡張子とアスタリスク (*) のみを指定すれば、その拡張子を持つすべてのファイルを許可できます。ある入力ファイルが取得されると、その入力ファイルの拡張子が.~in に変更されます。

input1.txt.~in など、リネーム名と同じ名前のファイルが存在していると、入力ファイルの取得に失敗します。ファイルがインバウンドファイルポーラーによって処理される前に、リネーム名を持つファイルが存在しないことを確認する必要があります。

ポーリング間隔

入力ディレクトリに対する複数のポーリング試行間でアダプタが待機するミリ秒数。

受信メッセージの予期されるボリュームや頻度に基づいて、ポーリング間隔と MDB プールサイズを「調整」することができます。  

整数。指定可能な範囲は 2 から 99999 までの整数 (両端を含む) であり、デフォルトは 5000 (5000 ミリ秒つまり 5 秒) です。 5 秒未満の値を入力することはお勧めできません。

不正な値を入力しても、エラーメッセージは表示されません。

入力タイプ

「バイト」など、入力ファイルのタイプを指定します。

ファイルのタイプ。デフォルトは、唯一の有効な値である「バイト」です。

EOL を削除

アダプタが、サブスクライバに送信されるレコード( メッセージ) から末尾の End-Of-Line (EOL) 文字を除外するかどうかを指定します。このプロパティーが適用されるのは、「ファイルごとに複数レコード」プロパティーが true に設定されている場合だけです。

true または false

• true の場合、機能が有効になります。

• false の場合、機能が無効になります。

  デフォルトは false です。

ファイルごとに複数レコード

ファイルごとに複数のレコード (メッセージ) を取得するかどうかを指定します。このプロパティーが true に設定されていると、「1 レコードあたりの最大バイト数」プロパティーに指定されたバイト数まで、行ごとに複数のレコード (メッセージ) が生成されます。1 レコードあたりの最大バイト数のサイズを超えたデータはすべて、後続のメッセージとして送信されます。

true または false。

• true の場合、機能が有効になります。

• false の場合、機能が無効になります。

  デフォルトは false です。

1 レコードあたりの最大バイト数

サブスクライバに送信されるレコード (メッセージ) ごとの最大バイト数を指定します。このプロパティーが適用されるのは、「ファイルごとに複数レコード」プロパティーが true に設定されている場合だけです。

整数。指定可能な範囲は 2 から 99999 までの整数 (両端を含む) であり、デフォルトは 4096 です。

不正な値を入力しても、エラーメッセージは表示されません。

エンコード

有効なエンコーディング名を指定します。Java のエンコーディングの詳細については、次のサイトを参照してください。 

http://java.sun.com/j2se/1.3/ja/docs/ja/api/java/lang/package-summary.html

エンコーディング名。 

シリアルモード

メッセージがシリアルモードで (一度に 1 つずつ) 処理されるか、あるいは並行的に処理されるかを指定します。 

true または false。

• true: メッセージがシリアルモードで処理されることを示します。

• false: メッセージが並行的に処理されることを示します。

  デフォルト設定は true です。

出力ファイル名

出力データファイルのファイルマスクを指定します。

適切なファイル名。デフォルトは「output%d.dat」です。ファイル名に含まれる %d はカウンタであり、新しいファイルごとに増分されます。

%d の代わりに、整数か long 値を取るその他の任意の printf スタイルを使用できます。たとえば、1%d や %012d などを指定できます

「ファイルごとに複数レコード」プロパティーが false に設定されていると、次のようになります。

• 最初の実行を行う時点で出力ファイルが存在していなかった場合、レコードごとに新しい出力ファイルが作成されます。

• 最初の実行を行う時点で出力ファイルがすでに存在していた場合、その末尾にメッセージが追加されます。

  ---

  注 –

  printf 機能の詳細については、対応する C 言語のドキュメントを参照してください。

  ---

EOL を追加

アダプタが出力ファイルに送信する各レコードにシステムが行末文字を追加するかどうかを指定します。 

true または false。

• true は、システムが各レコードに EOL を追加することを示します。

• false は、その反対を示します。

  デフォルト設定は false です。

ファイルごとに複数レコード

出力ファイルに複数のレコード (メッセージ) を書き込めるかどうかを指定します。新しいメッセージは出力ファイルの末尾に追加されます。 

true または false。

• true は、出力ファイルに複数のレコード (メッセージ) が含まれることを示します。

• false は、各出力ファイルに単一のレコード (メッセージ) が含まれることを示します。

  デフォルト設定は true です。

エンコード

有効なエンコーディング名を指定します。有効なすべてのエンコーディングを確認するには、次のサイトを参照してください。http://java.sun.com/j2se/1.3/ja/docs/ja/api/java/lang/package-summary.html

エンコーディング名。 

Cookie を許可 

サーバーから送信されてきた Cookie を格納したり、後続の要求受信時にその Cookie を送信したりできるようにするかどうかを指定します。Cookie を許可しないとセッションがサポートされません。 

true または false。デフォルトは true です。

受け付けタイプ 

サーバーへの要求送信時に含める、受け付けタイプヘッダーのデフォルトの値。

文字列。次に例を示します。 

text/html、text/plain、text/xml など。

デフォルトは「text/*」です。

servlet-url 

HTTPS サーバーサーブレット URL の最後のパス要素を指定します。クライアントはこの URL 値を使ってサーバーにアクセスします。 

このプロパティー値は、HttpServerServlet などのサーブレット名である必要があります。有効なサーブレット URL の例として、http://localhost:18001/Deployment1_servlet_HttpServerServlet/HttpServerServlet が挙げられます。この場合、URL 値は次のようないくつかの要素から構成されています。

• App Server: 現在の Application Server が稼働しているマシンの名前。

• 18001: ポート番号 (ここでは Sun サーバーのポート番号)。

• Deployment1_servlet_HttpServerServlet: 現在のプロジェクトの配備プロファイルの名前と _servlet_HttpServerServlet とを結合したもの。

• HttpServerServlet: サーブレット名 (servlet_url プロパティーに相当)。

  ---

  注 –

  ポート番号は、Sun Enterprise Service Bus のプロパティーに基づいて設定してください。これはデフォルトで 18001 になっていますが、その値はユーザーが変更できます。Sun Enterprise Service Bus のプロパティーを設定するには、エンバイロメントエクスプローラを使用します。詳細については、『Enterprise Service Bus User’s Guide』を参照してください。

  ---

有効な URL。 

タイプ

コネクタのタイプを指定します。 

IMSClientETD 接続の場合はデフォルトで IMSClientETD。 

クラス

ETD コネクタオブジェクトのクラス名を指定します。 

有効なパッケージ名。デフォルトは「com.stc.adapters.ims.IMSClientETDConnector」です。 

IMS 接続モード 

外部システムとの接続の確立とクローズを行う方法を指定します。 

• 「自動」は、コラボレーションの起動時に接続が自動的に確立され、その接続が必要に応じてライブ状態に維持されることを示します。「オンデマンド」は、外部システムへの接続を必要とするビジネスルールの実行時に接続がオンデマンドで確立されることを示します。メソッドの実行が完了すると接続が閉じられます。

• 「手動」は、ユーザーがコラボレーション内で connect および disconnect 接続メソッドをビジネスルールとして明示的に呼び出すことを示します。デフォルトは「自動」です。

「手動」、「自動」のいずれかの設定。デフォルト設定は「手動」です。 

コネクタタイプ 

コネクタのタイプを表示します 

デフォルトは「LDAP コネクタ」です。

コネクタクラス 

コネクタクラスを表示します。 

デフォルトのコネクタクラスは、com.stc.connector.ldapadapter.LDAPadapterConnection です。 

認証 

使用する認証 (「なし」または「シンプル」) を選択できるようにします。次のように目的の認証を選択します。 

• なし: 認証なし。つまり、匿名ログオン。この設定を使用する場合は、LDAP サーバーが匿名ログオンをサポートしていることを確認してください。

• シンプル: 認証がユーザー名とパスワードに基づきます。ユーザー名とパスワードを対応するフィールド (「主体」と「資格」) に指定する必要があります。

「なし」または「シンプル」を選択します。デフォルトは「なし」です。

資格 

匿名ログイン (「認証」が「なし」の場合) 以外の認証機構を使用する際に必要となる資格を入力できるようにします。

有効なパスワードとしての適切な資格。 

初期コンテキストファクトリ 

LDAP サーバーの初期コンテキストを作成するために使用されるファクトリを入力できるようにします。デフォルトでは、Sun が Java Software Developers’ Kit (SDK) の一部として提供する LDAP サービスプロバイダが使用されます。 

有効な Java ファクトリ名。デフォルトは次のとおりです。 

com.sun.jndi.ldap.LdapCtxFactory。 

Sun が提供する LDAP サービスプロバイダ以外のプロバイダを使用する必要がある場合を除き、この値を変更しないことをお勧めします。 

主体 

匿名ログイン (「認証」が「なし」の場合) 以外の認証機構を使用する際に必要となる主体を指定できるようにします。

ユーザーの完全修飾識別名 (DN)。次に例を示します。 

CN=Administrator,CN=Users,DC=stc,dc=com

プロバイダ URL 

LDAP サーバーの URL を指定できるようにします。 

有効な URL。プロトコルとして ldap を含めます。

資格 

ディレクトリで任意のリフェラルを追跡する際に使用する資格ファイルを指定できるようにします。資格ファイルは RCF コマンド行ユーティリティーを使って作成されます。 

サービスバスから使用できる有効なファイルとパス名。 

追跡 

LDAP サーバーから返されたリフェラルを追跡する必要があるかどうかを選択できるようにします。 

「はい」または「いいえ」を選択します。デフォルトは「はい」です。次のように目的の値を入力します。

• はい: リフェラルを追跡します。

• いいえ: リフェラルは追跡されません。

「追跡」が「はい」に設定されている。

資格ファイルが提供されていない。

アダプタは、初期サーバーで入力された元の資格 (ユーザー名とパスワード) を使用して、参照先システムへの接続を試みます。参照先システムが同じ資格を持たない場合、接続が失敗する可能性があります。 

資格ファイルが提供され、そのファイル内に参照先ホストの資格エントリが含まれている。 

リフェラル検出時に LdapReferralException をスローするように、初期サーバーへの接続が設定されます。この例外はその後、アダプタによってキャッチされます。続いて、アダプタは、資格ファイル内に指定された資格情報を使って参照先システムへの接続を確立します。

提供された資格ファイル内に、参照先ホストの資格エントリが含まれていない。

リフェラル検出時に LdapReferralException をスローするように、初期サーバーへの接続が設定されます。この例外はその後、アダプタによってキャッチされます。続いて、アダプタは、匿名ログインを使って参照先システムへの接続を確立します。参照先システムが匿名ログインを許可していない場合、接続が失敗する可能性があります。

「追跡」が「いいえ」に設定されている。

資格ファイルが存在しない。 

リフェラルは追跡されません。つまり、アダプタはリフェラルを無視します。 

JSSE プロバイダクラス 

JSSE プロバイダクラスの完全修飾名を指定します。詳細については、Sun Microsystems の次の Java サイトを参照してください。 

http://java.sun.com

有効な JSSE プロバイダクラスの名前。デフォルトは次のとおりです。 

com.sun.net.ssl.internal.ssl.Provider 

AIX 上でインテグレーションサーバーを実行している場合は、次の名前を指定します。 

com.ibm.jsse.IBMJSSEProvider 

キーストア 

デフォルトのキーストアファイルを指定します。キーストアは、SSL 接続確立時の鍵/証明書管理に使用されます。 

有効なパッケージの場所。デフォルト値はありません。次のファイルを使用することをお勧めします。 

c:\JavaCAPS\appserver\is\domainsMyDomain
\config\keystore.jks

項目の意味を次に示します。 

c:\JavaCAPS
 is the directory where the Sun Java Composite 
Application Platform Suite is installed and 
MyDomain
 is the name of your domain.

キーストアパスワード 

デフォルトのキーストアパスワードを指定します。このパスワードは、SSL 接続確立時の鍵/証明書管理に使用されるキーストアにアクセスする際に使用されます。デフォルトはありません。 

有効なキーストアパスワード。デフォルト値はありません。

キーストアタイプ 

デフォルトのキーストアタイプを指定できるようにします。キーストアタイプは、SSL 接続確立時の鍵/証明書管理に使用されます。キーストアタイプが指定されなかった場合、デフォルトのキーストアタイプである JKS が使用されます。 

有効なキーストアタイプ。

キーストアユーザー名 

SSL 接続確立時の鍵/証明書管理に使用されるキーストアにアクセスするためのユーザー名。 

キーストアタイプが PKCS12 または JKS の場合、キーストアユーザー名のプロパティーは使用されません。PKCS12 および JKS のキーストアタイプでは、アクセス時にパスワードが必要になりますが、ユーザー名は必要ありません。このプロパティーに値を入力しても、PKCS12 および JKS ではその値は無視されます。

有効なキーストアユーザー名。 

SSL 接続タイプ 

使用される SSL 接続のタイプを指定できるようにします。 

「なし」、「SSL を有効化」、または「TLS オンデマンド」を選択します。次のように目的の値を入力します。 

なし: SSL を使用しない、単純なプレーン接続。

SSL を有効化: SSL が有効化されます。LDAP サーバーへのすべての通信で、セキュリティー保護された通信チャネルが使用されます。

「SSL の有効化」オプションを使用する場合、「プロバイダ URL」プロパティーが、セキュリティー保護された LDAP ポート (デフォルトは 636) を指している必要があります。

このプロパティーの必要な値に関する追加情報については、「SSL 接続タイプ」を参照してください。

SSL プロトコル 

LDAP サーバーとの SSL 接続を確立する際に使用する SSL プロトコル。アプリケーションサーバーのプラットフォームについては、JSSE のマニュアルを参照してください。 

「TLS」、「TLSv1」、「SSLv3」、「SSLv2」、または「SSL」を選択します。

トラストストア 

デフォルトのトラストストアを指定します。トラストストアは、SSL 接続確立時の CA 証明書管理に使用されます。 

有効なトラストストアファイル。デフォルトはありません。 

トラストストアパスワード 

デフォルトのトラストストアパスワードを指定できるようにします。このパスワードは、SSL 接続確立時の CA 証明書管理に使用されるトラストストアにアクセスするためのものです。 

有効なトラストストアパスワード。デフォルトはありません。 

トラストストアタイプ 

SSL 接続確立時の CA 証明書管理に使用されるトラストストアのトラストストアタイプを指定できるようにします。トラストストアタイプが指定されなかった場合、デフォルトのトラストストアタイプである JKS が使用されます。 

有効なトラストストアタイプ。 

ホスト名の検証 

SSL ハンドシェーク中にサーバー証明書に対してホスト名検証を行うかどうかを判定します。 

このプロパティーを使えば、要求 URL 内のサーバーホスト名と受信されたサーバー証明書内のホスト名について、厳格なチェックを行えます。 

true または false。デフォルトは false です。

このプロパティーの必要な値に関する追加情報については、「ホスト名の検証」を参照してください。

X509 アルゴリズム名 

信頼マネージャーファクトリと鍵マネージャーファクトリで使用する X509 アルゴリズムの名前を指定します。 

有効な X509 アルゴリズム名前。デフォルトは「SunX509」です。AIX 上でインテグレーションサーバーを実行している場合は、「IbmX509」を指定します。

   startTLS();
   performAddEntry();
   stopTLS();
   
   performRename();
   

MSMQ キューエイリアス

キューエイリアスを指定します。キューエイリアスは、AD パスとユーザー定義文字列 (エイリアス) を、公開、非公開、または直接の単一要素形式名に関連付けます。 

キューエイリアスを使ってメッセージの送受信を行うには、MSMQ および Active Directory サービスが Application Server と同じコンピュータ上にインストールされている必要があります。

キューエイリアス。 

詳細については、「MSMQ キューの識別」を参照してください。

MSMQ 形式名

キューの形式名を指定します。形式名とは、いくつかの接続詳細情報やキューのパスを指定することでキューを一意に識別する文字列のことです。さまざまなタイプの形式名を使用することで、メッセージのルーティング方法、デスティネーションのタイプ、およびキューのオープン対象となる処理のタイプを指定できます。 

TCP および HTTP プロトコルを受け付けるように MQ のセキュリティー属性を設定してください。 

次の形式の公開または非公開の形式名。 

• 公開キューの場合は次の形式を使用します。

  DIRECT=TCP:

  IPAddress\QueueName

  DIRECT=OS:

  ComputerName\QueueName

  DIRECT=HTTP:

  //Host/msmq/QueueName

• 非公開キューの場合は次の形式を使用します。

  DIRECT=TCP:

  IPAddress\private$\QueueName

  DIRECT=OS:ComputerName\

  private$\QueueName

  TCP および HTTP プロトコルを受け付けるように MQ のセキュリティー属性を設定してください。

  公開と非公開の両方の MSMQ 形式名の例については、「転送前 (BatchFTP の接続マップ)」を参照してください。

  ---

  注 –

  ComputerName または Host の名前に含まれる文字が 15 文字を超えている場合、MSMQ はその名前を切り詰めます。その場合、その切り詰められた ComputerName を使用する必要があります。システムの具体的な ComputerName を確認するには、キューの「プロパティ」、「全般」タブを参照してください。詳細については、「転送前 (BatchFTP の接続マップ)」を参照してください。

  ---

  詳細については、「MSMQ キューの識別」を参照してください。

MSMQ キュー名

Microsoft メッセージキューの名前を指定します。 

キューを識別する文字列名。これはホスト名に関連付けられているため、queuename のように値を入力します。ここで、queuename はキュー名です。

詳細については、「MSMQ キューの識別」を参照してください。

MSMQ 共有モード

MSMQ 共有モード (DENY_NONE または DENY_RECEIVE_SHARE) を指定します。

DENY_NONE または DENY_RECEIVE_SHARE を選択します。

DENY_NONE がデフォルト設定になります。

MSMQ アクセスモード

MSMQ アクセスモードを指定します。 

インバウンドモードでサポートされているのは、RECEIVE_ACCESS だけです。 

RECEIVE_ACCESS 

MSMQ 受信間隔

ポーリング間隔、つまりアダプタがキュー内に受信メッセージがないか確認する頻度、をミリ秒で指定します。 

ポーリング間隔をミリ秒で示す数値。 

デフォルト設定は 5000 (5 秒) です。

MSMQ 受信アクションコード

MSMQ 受信アクションコードを指定します。 

インバウンドモードでサポートされているのは、ACTION_RECEIVE だけです。 

ACTION_RECEIVE 

MSMQ トランザクションタイプ

Microsoft メッセージトランザクションタイプを指定します。 

キューを識別する文字列名。これはホスト名に関連付けられているため、queuename のように値を入力します。ここで、queuename はキュー名です。

MSMQ キューエイリアス

キューエイリアスを指定します。キューエイリアスは、AD パスとユーザー定義文字列 (エイリアス) を、公開、非公開、または直接の単一要素形式名に関連付けます。 

キューエイリアスを使ってメッセージの送受信を行うには、MSMQ および Active Directory サービスが Application Server と同じコンピュータ上にインストールされている必要があります。

キューエイリアス。 

詳細については、「SOCKS (BatchFTP の接続マップ)」を参照してください。

MSMQ 形式名

キューの形式名を指定します。形式名とは、接続詳細情報やキューのパスを使ってキューを一意に識別する文字列のことです。さまざまなタイプの形式名を使用することで、メッセージのルーティング方法、デスティネーションのタイプ、およびキューのオープン対象となる処理のタイプを指定できます。 

TCP および HTTP プロトコルを受け付けるように MQ のセキュリティー属性を設定してください。 

次の形式の公開または非公開の形式名。 

• 公開キューの場合は次の形式を使用します。

  DIRECT=TCP:

  IPAddress\QueueName

  DIRECT=OS:

  ComputerName\QueueName

  DIRECT=HTTP:

  //Host/msmq/QueueName

• 非公開キューの場合は次の形式を使用します。

  DIRECT=TCP:

  IPAddress\

  private$\QueueName

  DIRECT=OS:

  ComputerName\private$\QueueName

  TCP および HTTP プロトコルを受け付けるように MQ のセキュリティー属性を設定してください。

  公開と非公開の両方の MSMQ 形式名の例については、「転送前 (BatchFTP の接続マップ)」を参照してください。

  ComputerName または Host の名前に含まれる文字が 15 文字を超えている場合、MSMQ はその名前を切り詰めます。その場合、その切り詰められた ComputerName を使用する必要があります。システムの具体的な ComputerName を確認するには、キューの「プロパティ」、「全般」タブを参照してください。詳細については、「転送前 (BatchFTP の接続マップ)」を参照してください。

  詳細については、「SOCKS (BatchFTP の接続マップ)」を参照してください。

MSMQ キュー名

Microsoft メッセージキューの名前を指定します。 

キューを識別する文字列名。これはホスト名に関連付けられているため、host/queue のように値を入力します。ここで、host はホスト名、queue はキュー名です。

詳細については、「SOCKS (BatchFTP の接続マップ)」を参照してください。

MSMQ トランザクションタイプ

アウトバウンドのトランザクションタイプを指定します。オプションは次のとおりです。 

• MQ_NO_TRANSACTION: 非トランザクションキューへのメッセージ送信時にこの値を選択します。

• MQ_XA_TRANSACTION: XA トランザクションキューへのメッセージ送信時にこの値を選択します。

• MQ_SINGLE_MESSAGE: トランザクションキューへのメッセージ送信時にこの値を選択します。

  この値がトランザクションキューからのインバウンドメッセージに適用されたりそのメッセージに影響を与えたりすることはありません。

MQ_NO_TRANSACTION、MQ_XA_TRANSACTION、または MQ_SINGLE_MESSAGE をトランザクションタイプとして選択します。

デフォルト値 MQ_NO_TRANSACTION を使用します。

詳細については、MSMQ のユーザーマニュアルを参照してください。 

MSMQ 共有モード

次のいずれかを使って MSMQ 共有モードを指定します。 

• DENY_NONE: キューが開いている間にキューに対してメッセージの送信、peek、または取得を行える完全なアクセス権を、すべてのユーザーに許可します。

• DENY_RECEIVE_SHARE: キューが閉じられるまで、このユーザーだけがメッセージの peek または取得を行えます。ほかのアプリケーションは、キューへのメッセージの送信は依然として行えますが、このユーザーがキューを開いている間はメッセージの削除を行えません。

DENY_NONE または DENY_RECEIVE_SHARE を選択します。

DENY_NONE がデフォルト設定になります。

エラー条件

Message Queuing がキューを開いたあとで、このユーザーかほかのだれかが RECEIVE_ACCESS または PEEK_ACCESS を使ってそのキューを開こうとすると、エラーメッセージが表示されます。

RECEIVE_ACCESS または PEEK_ACCESS を使ってキューがすでに開かれている状態で、DENY_RECEIVE_SHARE を使ってそのキューを開こうとすると、その呼び出しは失敗します。

メッセージ優先度

すべてのメッセージに対するメッセージ優先レベルを指定します。優先度の範囲は、レベル 0 (低い優先度) から 7 (高い優先度) までです。メッセージはキュー内で降順に格納され、優先度の高いメッセージが先にきます。優先度が有効になるのは、「MSMQ アクセスモード」が SEND_ACCESS に設定されている場合だけです。

メッセージの優先度を示す、0 から 7 までの数値。デフォルト設定は 3 です。

MSMQ 受信アクションコード

次のいずれかを使って MSMQ 受信アクションコードを指定します。 

ACTION_RECEIVE: 現在のカーネル位置にあるメッセージを読み取り、それをキューから削除します。

ACTION_PEEK_CURRENT: キュー内の最後のメッセージを「peek」します。いくつかのメッセージがキューを出入りしていて、最後のメッセージを peek (確認) して取得する必要がある場合に、この機能を使用できます。

ACTION_RECEIVE または ACTION_PEEK_CURRENT を選択します。

ACTION_RECEIVE がデフォルト設定になります。

MSMQ アクセスモード

Message Queuing が peek、送信、受信のいずれのアクセス権を使ってキューを開くかを指定します。 

• RECEIVE_ACCESS: メッセージの読み取り時にそのメッセージをキューから取得できるようにします。これは、受信アプリケーションがメッセージを削除するためにキューを開く場合に使用されます。

• SEND_ACCESS: メッセージをキューに送信できるようにします。これは、送信アプリケーションがメッセージを送信するためにキューを開く場合に使用されます。

• PEEK_ACCESS: メッセージを削除することなしにキューからメッセージを読み取れるようにします。これは、受信アプリケーションがメッセージを読み取るためにキューを開く場合に使用されます。

RECEIVE_ACCESS、SEND_ACCESS、または PEEK_ACCESS を選択します。

メッセージ優先度を使用するには、このアクセスモードを SEND_ACCESS に設定する必要があります。

接続モード

外部接続をインスタンス化する際に物理的な接続を確立するかどうかを指定します。オプションは次のとおりです。 

• 自動: 外部接続をインスタンス化する際に物理的な接続を確立します。

• 手動: 起動時に外部システムへの接続を行わず、代わりに connect() メソッドを呼び出すなどの方法でユーザーがコラボレーションから接続を起動するものと予期します。

「自動」または「手動」 (動的) を選択します。

デフォルト設定は「自動」です。

最大データサイズ

プログラムの内部に格納できるデータの最大量を指定します。有効な範囲は、1 から 2G バイト (Java の整数の最大値) までです。

データの最大量を示す数値。有効な範囲は、1 から 2147483647 (バイト) までです。

デフォルト設定は 2147483647 です。

状態のスコープ

OTD ノードである State オブジェクトのスコープを定義します。このパラメータのオプションは、次のとおりです。 

• リソースアダプタレベル: State のライフサイクルはリソースアダプタと同じになります。

• 接続レベル: State のライフサイクルは接続と同じになります。

• OTD レベル: State のライフサイクルは OTD オブジェクトと同じになります。

  このスコープは State のライフサイクルを表します。

次のいずれかを選択します。 

リソースアダプタレベル

接続レベル

OTD レベル

デフォルト設定は「リソースアダプタレベル」です。

専用セッションモード

サーバーの専用セッションモードが有効、無効のいずれであるかを指定します。サーバーの専用セッションモードが有効な場合、現在のクライアントの要求が接続先のサーバーポートを占有します。同じポートに対する次のクライアントの要求は、その前の要求が完了して接続を解放するまで、ブロックまたは拒否されます。 

true または false を選択します。true は、専用セッションモードが有効であることを示します。

デフォルト設定は false です。

接続タイプ

アダプタによる TCP/IP 接続の確立方法を指定します。 

• クライアント: アダプタは、外部サーバー (ホスト/ポート) に接続して接続を確立します。アダプタは能動モードになります。

• サーバー: アダプタは、外部クライアントからの接続要求が受信されるまで特定のポート上で待機します。要求が受信されると、アダプタはその要求を受け付け、接続を確立します。アダプタは受動モードになります。

「クライアント」または「サーバー」。「サーバー」がデフォルト設定です。「クライアント」モードが特に必要でないかぎり、この値はデフォルトの「サーバー」のままにしておいてください。

ServerSO タイムアウト

ServerSocket の SO_TIMEOUT の値を、ミリ秒で設定または取得します。ServerSocket.accept() で使用されます。このオプションをゼロ以外のタイムアウトに設定すると、この ServerSocket 上で accept() を呼び出した際に、その設定された時間の長さだけブロックが発生します。タイムアウトの期限が切れると、java.net.SocketTimeoutException (または java.net.InterruptedIOException) がスローされますが、ServerSocket は有効なままです。ブロック動作に入る前に、このオプションを有効にしてください。このパラメータが使用されるのは、「接続タイプ」が「サーバー」に設定されている場合だけです

ServerSO タイムアウトを示す数値 (ミリ秒)。

このタイムアウトはゼロ (0) より大きくする必要があります。ゼロのタイムアウトは、タイムアウトが無限であると解釈されます。

デフォルト設定は 60000 (60 秒) です。

サーバーソケットファクトリ実装クラス名

サーバーソケットファクトリを実装した Java クラスの名前を指定します。このクラスは、サーバーソケットを作成するために使用されます。ユーザー独自のサーバーソケット実装を用意した場合には、その実装を含む Java クラスの名前をここで入力します。ファクトリ実装クラスは、次のインタフェースを実装する必要があります。 

com.stc.connector.tcpip.model.factory.TCPIPSocketFactory

有効な Java クラス名。デフォルトは次のとおりです。 

com.stc.connector.tcpip.model.
factory.TCPIPSocketFactoryIm
pl

キープアライブ

クライアントの SO_KEEPALIVE オプションが有効、無効のいずれであるかを指定します。ある TCP ソケットでこのオプションが設定されており、そのソケット経由で2 時間、どちらの方向にもデータがまったく交換されなかった場合、TCP は自動的に KEEPALIVE プローブをピアに送信します (実際の値は実装に依存する)。このプローブは TCP セグメントであり、ピアはこれに応答する必要があります。次の 3 つの応答のいずれかが予期されます。 

1. ピアが期待どおりの ACK で応答する。アプリケーションへの通知は行われません (何も問題がないため)。その後さらに 2 時間非活動状態が続くと、TCP は再度プローブを送信します。

2. ピアが RST で応答する。これは、ピアのホストがクラッシュしてリブートしたことをことを、ローカルの TCP に通知します。ソケットが閉じられます。

3. ピアからの応答がない。ソケットが閉じられます。このオプションの目的は、ピアのホストがクラッシュしたかどうかを検出することです。これは、受け付けられたクライアント Socket で使用されます。

true または false。true は、サーバーの SO_KEEPALIVE オプションが有効であることを示します。

一部のプロパティーについては、その設定がサーバーソケット自体には直接関連付けられません。代わりに、それらのプロパティーは受け付けられたクライアントソケットにマップされます。

受信バッファーサイズ

現在のソケットの SO_RCVBUF オプションの値を設定または取得します。これは、オペレーティングシステムがこのソケットの入力用に使用するバッファーのサイズです。これは、プラットフォームが受信ネットワーク入出力用に使用する配下のバッファーの概算サイズを提供します。これを設定に使用すると、その値は、このソケット経由で受信されるデータ用に使用するバッファーのサイズに関する、アプリケーションからカーネルへの提案値になります。これを取得に使用すると、プラットフォームがこのソケット上でのデータ受信時に使用するバッファーの実際のサイズが返されます。

受信バッファーサイズを示す数値。 

デフォルト設定は 8192 です。

送信バッファーサイズ

現在のソケットの SO_SNDBUF オプションの値を設定または取得します。これは、オペレーティングシステムがこのソケットの出力用に使用するバッファーのサイズです。これは、プラットフォームが送信ネットワーク入出力用に使用する配下のバッファーの概算サイズを提供します。これを設定に使用すると、その値は、このソケット経由で送信されるデータ用に使用するバッファーのサイズに関する、アプリケーションからカーネルへの提案値になります。これを取得に使用すると、プラットフォームがこのソケット上でのデータ送信時に使用するバッファーの実際のサイズが返されます。

送信バッファーサイズを示す数値。 

デフォルト設定は 8192 です。

SoLinger

アダプタが linger-on-close タイムアウトを実行するかどうかを指定します。このオプションは、TCP Socket の close() からの即時リターンを無効化/有効化します。このパラメータは「SoLinger タイムアウト」と組み合わせて使用されます。

• true で、かつ「SoLinger タイムアウト」がゼロ以外の整数タイムアウトに設定された場合: これは、ピアに書き込まれたすべてのデータの送信と肯定応答が完了するまで、close() がブロックされることを意味します。それが完了した時点で、ソケットは正常に閉じられます。linger タイムアウトに達すると、ソケットは TCP RST で強制的に閉じられます。

• true で、かつ「SoLinger タイムアウト」がゼロのタイムアウトに設定された場合: 強制的なクローズが即時に行われることを示します。「SoLinger タイムアウト」プロパティーを参照してください。

true または false。true の場合、SO_Linger オプションが有効になります。

SoLinger タイムアウト

サーバーの SoLinger タイムアウトを秒で指定します。「SoLinger タイムアウト」は「linger-on-close」タイムアウトを設定するために、「SoLinger」 (「SoLinger」プロパティー値を参照) と組み合わせて使用されます。

「SoLinger」が true (有効) に設定された場合、「SoLinger タイムアウト」値の意味は、次のようになります。

• ゼロ以外の整数は、ピアに書き込まれたすべてのデータの送信と肯定応答が完了するまで、close() 呼び出しがブロックされることを意味します。それが完了した時点で、ソケットは正常に閉じられます。linger タイムアウトに達すると、ソケットは TCP RST で強制的に閉じられます。指定したタイムアウト値が 65,535 を超えていると、その値は 65,535 に減らされます。

• 整数ゼロは、強制的なクローズが即時に行われることを示します。

-1 から 65535 までの整数。デフォルトは -1 秒ですが、これは、「SoLinger」オプションが無効化される (false に設定される) ことを示します。

ゼロ (0) は、SoLinger が即時に強制的なクローズを実行することを示します。整数 1 から 65535 までは、タイムアウトの秒数を示します。

SoTimeout

SoTimeout の値をミリ秒で設定または取得します。受け付けられたクライアントソケットで使用されます。このオプションをゼロ以外のタイムアウトに設定すると、このソケットに関連付けられた InputStream 上で read() を呼び出した際に、設定された時間だけブロックが発生します。タイムアウトの期限が切れると、java.io.InterruptedIOException (または java.net.SocketTimeoutException) がスローされますが、Socket は有効なままです。

ブロック動作に入る前に、このオプションを有効にしてください。 

SoTimeout の値 (ミリ秒)。デフォルト設定は 10000 (10 秒) です。

このタイムアウトは 0 (ゼロ) より大きくする必要があります。ゼロのタイムアウトは、タイムアウトが無限であると解釈されます。

TcpNoDelay

サーバーの TcpNoDelay オプション (つまり、Nagle のアルゴリズム) が有効、無効のいずれであるかを指定します。

• true: 最大転送単位 (MTU) のサイズより小さいデータパケットがネットワーク経由で即時に送信されるのを、サーバーが許可することを示します。高速ネットワークでは、true を設定するとパフォーマンスが改善される可能性があります。

• false: MTU サイズより小さいデータパケットがネットワーク経由で即時に送信されるのを、サーバーが許可しないことを示します。

  これは、受け付けられたクライアントソケットで使用されます。

true または false。

デフォルト設定は false です。

バインディングの最大再試行回数

localhost 上の指定された TCP/IP ポートへのバインドをアダプタが試みる最大回数を指定します。 

バインドの試行回数を示す整数。 

デフォルト設定は 3 です。

バインディングの再試行間隔

localhost 上の指定された TCP/IP ポートへの複数のバインド試行間でのアダプタの待機時間の長さ (ミリ秒) を指定します。 

複数の試行間でのアダプタの待機時間の長さをミリ秒で示す整数。 

デフォルト設定は 30000 (30 秒) です。

接続試行までの待機時間

外部システムへの接続を試みるまでにアダプタが待機する時間の長さ (ミリ秒) を指定します。 

外部システムへの接続を試みるまでの待機時間の長さ (ミリ秒) を示す数値。 

デフォルト設定は 30000 (30 秒) です。

最大接続プールサイズ

指定された TCP/IP ポート上で待機しているかそのポートを監視している特定のリスナー/モニターに許可される、同時接続の最大数を指定します。これは、このサーバーのサービスの能力または可用性を表します。クライアントからの接続要求ごとに 1 つの同時接続が割り当てられます。また、このパラメータは、このサーバーのサービスに同時に接続し、特定のリスナー/モニターのサービスを同時に受けることができるクライアントの最大数も表します。 

特定の TCP/IP ポートで 1 つのリスナー/モニターから使用可能な同時接続の最大数を示す数値。0 は、制限がないことを示します。

デフォルト設定は 50 です。

接続のスコープ

アダプタが使用している受け付けられた接続のスコープを指定します。次の 2 つのオプションがあります。 

• リソースアダプタレベル: リソースアダプタが (ClosureCommandMessage 経由で) クローズ要求を受け取ると、リソースアダプタは接続を閉じます。したがって、コラボレーションが複数回実行される間、接続が「キープアライブ」状態に保たれる可能性があります。

  コラボレーションレベル: コラボレーションの実行が完了すると接続が閉じられます。したがって、接続のライフサイクルはコラボレーションと同じになります。

「リソースアダプタレベル」または「コラボレーションレベル」を選択します。

デフォルト設定値は「リソースアダプタレベル」です。

クローズ通知

クローズ通知の値を指定します。サーバーは、このパラメータの値に一致する内容を含む通知を受け取ると、接続を安全に閉じ、対応するすべてのスケジュールを取り消します。 

接続を閉じるようにサーバーに通知するトリガー値を示す文字列。 

デフォルト設定は「QUIT」です。

アイドルタイムアウト

リクエスタ (クライアント) の非活動時間の長さ (ミリ秒) を指定します。アダプタは、クライアント側 (接続の反対側) の活動状態の検出を試みます。指定された期間中にクライアントの活動がなかった場合 (その接続経由でクライアントから入出力要求が到着しなかった場合)、その接続はサーバー側から閉じられ、リソースが解放されます。値の単位はミリ秒です。このアイドルタイムアウトチェック機能を無効にするには、このパラメータに 0 を指定します。 

時間の長さをミリ秒で示す整数。値 0 を指定すると、アイドルタイムアウトは無効になります。

デフォルト設定は 60000 です。

スケジューラ

このインバウンド通信のスケジューラのタイプを指定します。次の 2 つのオプションがあります。 

• タイマーサービス: J2EE のタイマーサービス経由でタスクのスケジューリングが行われます。タイマーサービスは J2EE でサポートされます。

• 作業マネージャー: J2EE の作業マネージャー経由でタスクのスケジューリングが行われます。作業マネージャーは J2EE (JCA 1.5 以上) でサポートされます。

「タイマーサービス」または「作業マネージャー」を選択します。使用するコンテナが JCA 作業マネージャーをサポートしていない場合は、「タイマーサービス」を選択します。

スケジュール型

このプロパティーの設定は、プロパティーエディタから確認はできるものの、無効になっています。使用できるスケジュール型は「繰り返し」だけですが、これは、このセクションの「期間」プロパティー (「期間」プロパティーを参照) で定義される一定間隔でタスクが繰り返し実行されるようにスケジューリングされることを示します。

このフィールドは有効化されません。 

遅延

タイマーサービスと作業マネージャーの両方に適用されます。タスクが実行されるまでの遅延時間の長さをミリ秒で指定します。

タスクが実行されるまでの時間の長さをミリ秒で示す整数。 

期間

タイマーサービスと作業マネージャーの両方に適用されます。連続するタスク実行間の一定間隔をミリ秒で指定します。

連続するタスク実行間の時間の長さをミリ秒で示す整数。 

固定レートで

タイマーサービスだけに固有です。固定レート実行、固定遅延実行のいずれを使用するかを指定します。

• 固定レート: 固定レート実行は、初期実行のスケジュール時刻を基準にして各実行のスケジューリングが行われることを意味します。ある実行が、ガベージコレクションやその他のバックグラウンドアクティビティーなど、何らかの理由によって遅れると、その遅れを取り戻すために、すぐに続けて 2 つまたはそれ以上の実行が発生します。長期的には、実行頻度は指定された期間のちょうど逆数になります (ただし、Object.wait(long) の配下のシステムクロックが正確である場合)。

• 固定遅延: 固定遅延実行は、1 つ前の実行の実際の時刻を基準にして各実行のスケジューリングが行われることを意味します。ある実行が、ガベージコレクションやその他のバックグラウンドアクティビティーなど、何らかの理由によって遅れると、後続の実行も遅れませす。その結果、Object.wait(long) の配下のシステムクロックが正確であると仮定すると、実行頻度は通常、指定された期間の逆数よりもやや低くなります。

true または false。true は、固定レート実行が使用されることを示します。false は、固定遅延実行が使用されることを示します。

スケジューラ

このインバウンド通信のスケジューラのタイプを指定します。次の 2 つのオプションがあります。 

• タイマーサービス: J2EE のタイマーサービス経由でタスクのスケジューリングが行われます。タイマーサービスは J2EE でサポートされます。

• 作業マネージャー: J2EE の作業マネージャー経由でタスクのスケジューリングが行われます。作業マネージャーは J2EE (JCA 1.5 以上) でサポートされます。

「タイマーサービス」または「作業マネージャー」を選択します。使用するコンテナが JCA 作業マネージャーをサポートしていない場合は、「タイマーサービス」を選択します。

スケジュール型

タイマーサービスと作業マネージャーの両方に適用されます。タスクが 1 回実行されるようにスケジューリングするか、あるいは繰り返し実行されるようにスケジューリングするかを指定します。

• 1 回: タスクが 1 回実行されるようにスケジューリングされます。

• 繰り返し: 「期間」プロパティー (表 1–62 の表の「期間」プロパティーを参照) で定義される一定間隔でタスクが繰り返し実行されるようにスケジューリングされます。

「1 回」または「繰り返し」を選択します。

遅延

タイマーサービスと作業マネージャーの両方に適用されます。タスクが実行されるまでの遅延時間の長さをミリ秒で指定します。

タスクが実行されるまでの時間の長さをミリ秒で示す整数。 

期間

タイマーサービスと作業マネージャーの両方に適用されます。連続するタスク実行間の一定間隔をミリ秒で指定します。これは、スケジュール型が「繰り返し」の場合に使用されます (表 1–62 の表の「スケジュール型」プロパティーを参照)

連続するタスク実行間の時間の長さをミリ秒で示す整数。 

固定レートで

タイマーサービスだけに固有です。固定レート実行、固定遅延実行のいずれを使用するかを指定します。これは、「タイマーサービス」スケジューラの「繰り返し」スケジュール型で使用されます。

• 固定レート: 固定レート実行は、初期実行のスケジュール時刻を基準にして各実行のスケジューリングが行われることを意味します。ある実行が、ガベージコレクションやその他のバックグラウンドアクティビティーなど、何らかの理由によって遅れると、その遅れを取り戻すために、すぐに続けて 2 つまたはそれ以上の実行が発生します。長期的には、実行頻度は指定された期間のちょうど逆数になります (ただし、Object.wait(long) の配下のシステムクロックが正確である場合)。

• 固定遅延: 固定遅延実行は、1 つ前の実行の実際の時刻を基準にして各実行のスケジューリングが行われることを意味します。ある実行が、ガベージコレクションやその他のバックグラウンドアクティビティーなど、何らかの理由によって遅れると、後続の実行も遅れませす。その結果、Object.wait(long) の配下のシステムクロックが正確であると仮定すると、実行頻度は通常、指定された期間の逆数よりもやや低くなります。

true または false。true は、固定レート実行が使用されることを示します。false は、固定遅延実行が使用されることを示します。

肯定応答レベル

外部アプリケーションが HL7 アプリケーション肯定応答を、メッセージの受信に成功したあとで送信するか、あるいはアプリケーションデータベースにメッセージが正常にコミットされたあとで送信するかを指定します。オプションは次のとおりです。 

• A: アプリケーション肯定応答。この肯定応答は、メッセージが 1 つの受信システムによって正常かつ機能的に処理されたあとで送信されます。

• C: コミット (受け付け) 肯定応答。この肯定応答は、メッセージの受信に成功した際に送信されます。

「A」または「C」。

デフォルト設定は「A」です。

eGate がアプリケーション ACK を送信

外部システムに送信される HL7 アプリケーション肯定応答が、アダプタで生成されるか、あるいはアプリケーションサーバーから転送されるかを指定します。 

• true は、アプリケーションサーバーが HL7 アプリケーション肯定応答を受信または作成してアダプタに送信し、アダプタがそれを外部システムに転送することを示します。

• false は、アダプタが直接 HL7 アプリケーション肯定応答を作成して外部システムに送信することを示します。

  このパラメータは、インバウンドコラボレーションコードで使用されます。

true または false。

デフォルト設定は false です。

外部 ACK を転送

HL7 アプリケーション肯定応答をアプリケーションサーバーに転送するかどうかを指定します。HL7 アプリケーション肯定応答を受信した場合、HL7 アプリケーション肯定応答の内容を、アプリケーションサーバーに (データとして) 転送する必要がある場合があります。 

• true は、アダプタが外部システムからの HL7 アプリケーション肯定応答を処理対象としてアプリケーションサーバーに転送することを示します。

• false は、外部システムからの HL7 アプリケーション肯定応答がアダプタからアプリケーションサーバーに転送されないことを示します。

  このパラメータは、インバウンドコラボレーションコードで使用されます。

true または false。

デフォルト設定は false です。

遅延 ACK のタイムアウト

遅延 ACK のタイムアウト値をミリ秒で指定します。 

このパラメータは、インバウンドコラボレーションコードで使用されます。 

タイムアウトをミリ秒で示す数値。 

デフォルト設定は 30000 (30 秒) です。

LLP タイプ

LLP (Lower Layer Protocol) のタイプを指定します。有効なタイプは次のとおりです。 

• MLLP (Minimal Lower Layer Protocol)

• HLLP (Hybrid Lower Layer Protocol)

  使用可能なエンベロープタイプの詳細については、「TCP/IP HL7 アダプタ動作における下位層プロトコル」を参照してください。

• MLLP v2.0(Minimal Lower Layer Protocol v2.0)

「MLLP」、「HLLP」、または「MLLP v2.0」。

「MLLP」がデフォルト設定値になります。

開始ブロック文字

開始ブロック文字 (HL7 エンベロープ内の最初のエンベロープマーカー文字) を、10 進 ASCII 番号として指定します。

1 から 127 までの範囲内の 10 進数。競合が存在するのでないかぎり、値は ASCII の VT (10 進の 11) にすべきです。

デフォルト値は 11 です。

終了データ文字

終了データ文字 (HL7 エンベロープ内の最後のエンベロープマーカー文字の 1 つ前の文字) を、10 進 ASCII 番号として指定します。指定可能な範囲は、1 から 127 までです。

1 から 127 までの範囲内の 10 進数。競合が存在するのでないかぎり、値は ASCII の FS (10 進の 28) にすべきです。

デフォルト値は 28 です。

終了ブロック文字

終了ブロック文字 (HL7 エンベロープ内の最後のエンベロープマーカー文字) を、10 進 ASCII 番号として指定します。

1 から 127 までの範囲内の 10 進数。HL7 標準に厳格に準拠するには、このパラメータをキャリッジリターン (10 進の 13) に設定する必要があります。

デフォルト値は 13 です。

HLLP チェックサムが有効

HLLP (Hybrid Lower Level Protocol) チェックサムが有効、無効のいずれであるかを指定します。

true または false。true は、HLLP チェックサムが有効であることを示します。 

最大再試行回数

アダプタがピアから MLLP v2.0 コミット否定応答を受信した際にメッセージの送信を試みる回数の最大値。この回数のあと、アダプタは送信をあきらめます。 

このパラメータは、アウトバウンドモードの HL7 アダプタによって使用されます。 

アダプタがピアから MLLP v2.0 コミット否定応答を受信した際にメッセージの送信を試みる回数を示す整数。  

デフォルト設定値は 5 です。

シーケンス番号が有効

シーケンス番号プロトコルが有効、無効のいずれであるかを指定します。HL7 のシーケンス番号付けは、データの重複を回避しやすくするために使用されます。true は、シーケンス番号が有効であることを示します。

true または false。

デフォルト設定は true です。

フィールド区切り文字

セグメント ID と実際の先頭フィールドとの間の区切り文字を指定します。この値は、メッセージの残りの部分の区切り文字として使用される文字を定義します。 

これは、HL7 MSH セグメント内の 1 番目のフィールド (MSH-01) です。 

10 進 ASCII 番号としてのフィールド区切り文字値。指定可能な範囲は、1 から 127 までです。

デフォルト設定は 124 ですが、これは文字「|」です。

エンコーディング文字

4 つのエンコーディング文字を次の順番で指定します。 

• コンポーネント区切り文字

• 繰り返し区切り文字

• エスケープ文字

• サブコンポーネント区切り文字

  これは、HL7 MSH セグメント内の 2 番目のフィールド (MSH-02) です。

対応する順番に並べられた HL7 エンコーディング文字。 

デフォルト設定は「^~\& (それぞれ ASCII の 94、126、92、38)」です。

送信アプリケーション

ネットワークエンタープライズ内の各種アプリケーションの中で、送信アプリケーションを指定します。ネットワークエンタープライズは、企業内での HL7 メッセージの交換に参加するアプリケーションから構成されます。 

これは、HL7 MSH セグメント内の 3 番目のフィールド (MSH-03) です。 

HL7 送信アプリケーション用のユーザー定義値。 

デフォルト設定は「Sun HL7 adapter」です。

送信施設

さまざまな組織の代わりに動作する同一アプリケーションの複数インスタンスの中で、送信アプリケーションを指定 (さらに特定) します。 

これは、HL7 MSH セグメント内の 4 番目のフィールド (MSH-04) です。 

HL7 送信施設用のユーザー定義値。 

デフォルト設定は「Sun HL7 adapter」です。

受信アプリケーション

ネットワークエンタープライズ内の各種アプリケーションの中で、受信アプリケーションを指定します。ネットワークエンタープライズは、企業内での HL7 メッセージの交換に参加するアプリケーションから構成されます。 

これは、HL7 MSH セグメント内の 5 番目のフィールド (MSH-05) です。 

HL7 受信アプリケーション用のユーザー定義値。 

デフォルト設定は「Sun HL7 adapter」です。

受信施設

さまざまな組織の代わりに動作する同一アプリケーションの複数インスタンスの中で、受信アプリケーションを指定 (さらに特定) します。 

これは、HL7 MSH セグメント内の 6 番目のフィールド (MSH-06) です。 

HL7 受信施設用のユーザー定義値。 

デフォルト設定は「Sun HL7 adapter」です。

セキュリティー

実装されたアプリケーションレベルのセキュリティー機能を指定します。 

これは、HL7 MSH セグメント内の 8 番目のフィールド (MSH-08) です。 

HL7 で開発中です。 

処理 ID

MSH-11 のサブコンポーネント「処理 ID」を指定します。MSH-11 は、HL7 アプリケーション (レベル 7) 処理規則の定義に従ってメッセージが処理されるかどうかを示すために使用されます。 

次のいずれかが必要です。 

• D - デバッグ用

• P - 本番用

• T - トレーニング用

  場合によっては、追加のサブコンポーネント「処理モード」が初期値のあとに存在している可能性があります。

  デフォルト設定は「P」です。

バージョン ID

受信側のシステムが自身のバージョンと照合すべき特定の HL7 バージョンを指定します。 

これは、HL7 MSH セグメント内の 12 番目のフィールド (MSH-12) です。 

HL7 表 0104 - Version ID に表示される、HL7 標準のバージョン値。 

デフォルト設定値は 2.5 です。

国番号

メッセージが作成された国を示すコードを指定します (HL7 表 0399 を参照)。通貨など、メッセージ内のデフォルト要素を指定するために使用されます。 

これは、HL7 MSH セグメント内の 17 番目のフィールド (MSH-17) です。 

国番号の値として、ISO 3166 の 3 文字 (アルファベット) 形式が使用されます。 

デフォルト値は「USA」です。

文字セット

メッセージで使用される文字セットを指定します (HL7 表 0211 を参照)。このフィールドを空白のままにすると、使用されている文字セットは 7 ビット ASCII セットであるとみなされます。 

これは、HL7 MSH セグメント内の 18 番目のフィールド (MSH-18) です。 

デフォルト設定は、「8859/1」 (印刷可能な 7 ビット ASCII 文字セット) です。

使用可能な値とその説明については、HL7 表 0211 を参照してください。 

メッセージの主な言語

メッセージの主な言語を指定します。コードは ISO 639 のものを使用します。 

これは、HL7 MSH セグメント内の 19 番目のフィールド (MSH-19) です。 

2 文字の ISO 639 アルファベットコード。 

代替文字セット処理方式

任意の代替文字セットが使用されるために特殊な処理方式が必要になった場合に使用すべき、代替文字セット処理方式の値を指定します (HL7 表 0356 を参照)。 

これは、HL7 MSH セグメント内の 20 番目のフィールド (MSH-20) です。 

使用可能な値は「ISO 2022-1994」、「2.3」、および「<null>」(空) です。このフィールドを空白のままにすると、文字セットの切り替えが行われなくなります。

適合性ステートメント ID

適合性ステートメント ID (V2.5 のメッセージプロファイル識別子) は、クエリーの適合性ステートメントに適用される一意の識別子であるか、あるいはメッセージプロファイル識別子として、あるメッセージプロファイルへの準拠 (文法、構文、使用方法など) を主張します。 

これは、HL7 MSH セグメント内の 21 番目のフィールド (MSH-21) です。 

HL7 適合性ステートメント ID の値。あるいは空白のままにします。 

MSH の検証

インバウンドの場合はデータメッセージの MSH セグメント、アウトバウンドの場合は ACK の MSH セグメントを検証するかどうかを指定します。 

このパラメータは、インバウンドコラボレーションコードで使用されます。 

このプロパティーは、HL7 メッセージ自身の全体の構造検証には影響を与えません。構造検証は常に実行されます。

true または false。true は、コラボレーションが MSH セグメントを検証することを示します。

デフォルト設定は true です。

有効化

省略可能な SFT セグメントを ACK 内で有効にするかどうかを指定します。 

「有効化」を true に設定した場合、HL7 のバージョンが 2.5 として設定されていなければ、アダプタの起動時にエラーが発生します。