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.log、SystemErr.log、trace.log、activity.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]]"]')

- WebSphere® Application Server バージョン 8.0 より前のアプリケーション・サーバーにデプロイされたアプリケーションに、 CustomProperties ポリシーを含むポリシー・セットへの関連付けを作成しないでください。 CustomProperties ポリシーは、 WebSphere Application Server バージョン 8.0 以降でのみサポートされています。
- CustomProperties ポリシーを含むポリシー・セットへの関連付けがあるアプリケーションは、 WebSphere Application Server バージョン 8.0 より前のアプリケーション・サーバーにデプロイしないでください。
- クラスター環境にデプロイされたアプリケーションに、 CustomProperties ポリシーを含むポリシー・セットへの関連付けがある場合、 WebSphere Application Server バージョン 8.0 より前のメンバー・アプリケーション・サーバーをクラスターに追加しないでください。