CustomProperties ポリシーおよびバインディング・プロパティー

setBinding コマンドの -attributes パラメーターを使用して、 CustomProperties ポリシー・セット・バインディングに追加構成情報を指定します。 アプリケーションおよびシステム・ポリシー・セットで、CustomProperties ポリシーおよびバインディングを使用することができます。

この製品では、CustomProperties ポリシーおよびバインディングを使用して、 他のポリシー・タイプでサポートされていない汎用プロパティーを設定することがサポートされます。 追加のプロパティーはバインディングで設定されます。 ポリシーでは、使用可能属性など、既存のプロパティーのみを更新してください。 CustomProperties ポリシーは、JAX-WS プログラミング・モデルを使用して BindingProvider オブジェクトの プロパティーを設定する方法に代わるバインディング・プロパティーの 設定方法を提供します。CustomProperties バインディングは、サービス・クライアントの場合のみサポートされます。

AdminTask オブジェクトの PolicySetManagement グループにある以下のコマンドとパラメーターを使用して、ポリシー・セットの構成をカスタマイズします。
  • ポリシーおよびバインディング構成のプロパティーを表示するには、getPolicyType コマンドおよび getBinding コマンドの -attributes パラメーターを使用します。属性を取得するには、プロパティー名を getPolicyType コマンドまたは getBinding コマンドに渡します。
  • ポリシーおよびバインディング構成にプロパティーを追加したり、更新したり、プロパティーを除去するには、setPolicyType コマンドおよび setBinding コマンドの -attributes パラメーターを使用します。属性を追加したり、更新したりするには、プロパティーの名前と値を指定します。 setPolicyType コマンドおよび setBinding コマンドは、その属性が存在する場合は値を更新します。また、その属性が存在しない場合は属性と値を追加します。 属性を除去するには、空ストリング ("") で値を指定します。-attributes パラメーターがプロパティー・オブジェクトを受け入れます。
注: -attributes パラメーターに提供されたプロパティーの名前または値が無効な場合は、例外が発行されて setPolicyType コマンドと setBinding コマンドは失敗します。無効なプロパティーは、エラーまたは警告として SystemOut.log ファイルに記録されます。ただし、コマンドの例外に、その例外の原因となったプロパティーの詳細情報が含まれない場合があります。 setPolicyType コマンドと setBinding コマンドが失敗した場合は、SystemOut.log ファイルを調べて、-attributes パラメーターの入力に 1 つまたは複数の無効なプロパティーがあることを示す、エラー・メッセージまたは警告メッセージを探します。
注: このトピックでは、 1 つ以上のアプリケーション・サーバー・ログ・ファイルを参照します。推奨される代替案として、分散システムや IBM® i システムの SystemOut.logSystemErr.logtrace.logactivity.log ファイルではなく、High Performance Extensible Logging (HPEL) ログおよびトレース・インフラストラクチャーを使用するようにサーバーを構成できます。また HPEL は、ネイティブ z/OS® ロギング機能と連携させて使用することができます。HPEL を使用する場合、LogViewer コマンド・ライン・ツールを サーバー・プロファイルの bin ディレクトリーから使用して、すべてのログ・ファイルにアクセスし、 情報をトレースできます。HPEL の使用について詳しくは、HPEL を使用してのアプリケーションの トラブルシューティングに関する情報を参照してください。
次の setBinding のコマンド例は、CustomProperties バインディングを使用して、WSADDRESSING_DESTINATION_EPR エンドポイント参照バインディング・プロパティーに値を設定する方法を示しています。
AdminTask.setBinding('[-bindingLocation "" -bindingName generalCellWideBind1 -attachmentType client
 -policyType CustomProperties -attributes "[[WSADDRESSING_DESTINATION_EPR addressValue]]"]')
混合バージョン環境 (Mixed-version environment) 混合バージョン環境 (Mixed-version environment): 混合セル環境内では、CustomProperties ポリシーを含むポリシー・セットへの関連付けに対して、以下の制限が適用されます。
  • WebSphere® Application Server バージョン 8.0 より前のアプリケーション・サーバーにデプロイされたアプリケーションに、 CustomProperties ポリシーを含むポリシー・セットへの関連付けを作成しないでください。 CustomProperties ポリシーは、 WebSphere Application Server バージョン 8.0 以降でのみサポートされています。
  • CustomProperties ポリシーを含むポリシー・セットへの関連付けがあるアプリケーションは、 WebSphere Application Server バージョン 8.0 より前のアプリケーション・サーバーにデプロイしないでください。
  • クラスター環境にデプロイされたアプリケーションに、 CustomProperties ポリシーを含むポリシー・セットへの関連付けがある場合、 WebSphere Application Server バージョン 8.0 より前のメンバー・アプリケーション・サーバーをクラスターに追加しないでください。
mixv

トピックのタイプを示すアイコン 参照トピック



タイム・スタンプ・アイコン 最終更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_customproperties_policybind
ファイル名:rxml_customproperties_policybind.html