CustomProperties-Richtlinie und -Bindungseigenschaften

Verwenden Sie den Parameter "-attributes" für den Befehl "setBinding", um weitere Konfigurationsdaten für die Richtliniensatzbindung CustomProperties anzugeben. Anwendungs- und Systemrichtliniensätze können die CustomProperties-Richtlinie und -Bindung verwenden.

Dieses Produkt unterstützt die Verwendung der CustomProperties-Richtlinie und -Bindung, um generische Eigenschaften, die nicht in anderen Richtlinientypen unterstützt werden, zu definieren. Die zusätzlichen Eigenschaften werden in der Bindung definiert. Sie müssen nur vorhandene Eigenschaften, wie z. B. das aktivierte Attribut, in der Richtlinie aktualisieren. Normalerweise wird eine Bindungseigenschaft mit dem Programmiermodell JAX-WS BindingProvider-Objekt definiert. Die CustomProperties-Richtlinie bietet eine alternative Methode zum Definieren einer Bindungseigenschaft. Die Bindung "CustomProperties" wird nur für Service-Clients unterstützt.

Verwenden Sie die folgenden Befehle und Parameter aus der Gruppe "PolicySetManagement" des Objekts "AdminTask", um Ihre Richtliniensatzkonfiguration anzupassen.
  • Verwenden Sie den Parameter -attributes für die Befehle "getPolicyType" und "getBinding", um die Eigenschaften Ihrer Richtlinien- und Bindungskonfiguration anzuzeigen. Wenn Sie ein Attribut abrufen möchten, übergeben Sie den Eigenschaftsnamen an den Befehl "getPolicyType" bzw. "getBinding".
  • Verwenden Sie den Parameter -attributes für die Befehle "setPolicyType" und "setBinding", wenn Sie Eigenschaften in Ihren Richtlinien- und Bindungskonfigurationen hinzufügen, aktualisieren oder entfernen möchten. Zum Hinzufügen oder Aktualisieren eines Attributs geben Sie den Eigenschaftsnamen und den Eigenschaftswert an. Die Befehle "setPolicyType" und "setBinding" aktualisieren den Wert, wenn das Attribut vorhanden ist, bzw. fügen Attribut und Wert hinzu, falls das Attribut nicht vorhanden ist. Wenn Sie ein Attribut entfernen möchten, geben Sie für den Wert eine leere Zeichenfolge ("") an. Der Parameter -attributes akzeptiert ein Eigenschaftenobjekt.
Anmerkung: Wenn ein mit dem Parameter -attributes angegebener Eigenschaftsname oder -wert nicht gültig ist, schlagen die Befehle "setPolicyType" und "setBinding" mit einer Ausnahme fehl. Die nicht gültige Eigenschaft wird in einer Fehlernachricht oder Warnung in der Datei SystemOut.log protokolliert. Die Ausnahme zum Befehl enthält möglicherweise keine detaillierten Informationen zu der Eigenschaft, die die Ausnahme ausgelöst hat. Wenn die Befehle "setPolicyType" und "setBinding" fehlschlagen, suchen Sie in der Datei SystemOut.log nach Fehlernachrichten oder Warnungen, die anzeigen, dass die Eingabe für den Parameter -attributes ungültige Eigenschaften enthält.
Anmerkung: Dieser Artikel referenziert eine oder mehrere Protokolldateien des Anwendungsservers. Alternativ dazu wird empfohlen, den Server so zu konfigurieren, dass er die HPEL-Protokoll- und -Traceinfrastruktur (High Performance Extensible Logging) verwendet und nicht die Dateien SystemOut.log , SystemErr.log, trace.log und activity.log auf verteilten oder IBM® i-Systemen. Sie können HPEL auch in Verbindung mit Ihren nativen z/OS-Protokolleinrichtungen verwenden. Wenn Sie HPEL verwenden, können Sie mit dem Befehlszeilentool LogViewer im Verzeichnis "bin" des Serverprofils auf alle Ihre Protokoll- und Tracedaten zugreifen. Weitere Informationen zur Verwendung von HPEL finden Sie in der Dokumentation zum Einsatz von HPEL für die Fehlerbehebung in Anwendungen.
Das folgende Beispiel für den Befehl "setBinding veranschaulicht, wie Sie mit der CustomProperties-Bindung einen Wert für die Bindungseigenschaft der Endpunktreferenz WSADDRESSING_DESTINATION_EPR definieren können:
AdminTask.setBinding('[-bindingLocation "" -bindingName generalCellWideBind1 -attachmentType client
 -policyType CustomProperties -attributes "[[WSADDRESSING_DESTINATION_EPR addressValue]]"]')
Heterogene Umgebung Heterogene Umgebung: In einer heterogenen Zellenumgebung gelten für Richtliniensatzzuordnungen, die die CustomProperties-Richtlinie enthalten, die folgenden Einschränkungen:
  • Für Anwendungen, die auf einem Anwendungsserver einer älteren Version als WebSphere Application Server Version 8.0 implementiert sind, dürfen Sie keine Zuordnungen für Richtliniensätze erstellen, die die CustomProperties-Richtlinie enthalten. Die CustomProperties-Richtlinie wird nur in WebSphere Application Server Version 8.0 und höher unterstützt.
  • Eine Anwendung, die eine Zuordnung zu einem Richtliniensatz enthält, in dem die CustomProperties-Richtlinie enthalten ist, darf nicht auf einem Anwendungsserver mit einer älteren Version als WebSphere Application Server Version 8.0 implementiert werden.
  • Wenn eine Anwendung, die in einer Clusterumgebung implementiert ist, eine Zuordnung für einen Richtliniensatz enthält, der wiederum die CustomProperties-Richtlinie enthält, dürfen Sie keinen Anwendungsserver mit einer älteren Version als WebSphere Application Server Version 8.0 als Member zum Cluster hinzufügen.
mixv

Symbol, das den Typ des Artikels anzeigt. Referenzartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_customproperties_policybind
Dateiname:rxml_customproperties_policybind.html