Tool dumpNameSpace
Mit dem Tool "dumpNameSpace" können Sie den Inhalt eines Namespace, auf den Sie über einen Namensserver zugreifen, ausgeben. Das Tool "dumpNameSpace" basiert auf Java™ Naming and Directory Interface (JNDI).
Beim Ausführen des Tools "dumpNameSpace" muss der Namensservice aktiv sein. Das Tool "dumpNameSpace" kann keine lokalen Namespaces des Serverprozesses ausgeben, wie beispielsweise Namespaces mit den URL-Schemata java: und local:. Der local:-Namespace enthält Referenzen auf Enterprise-Beans mit lokalen Schnittstellen. Verwenden Sie das Speicherauszugsdienstprogramm für java:-, local:- und Server-Namespaces, um einen Speicherauszug für java:- und local:-Namespaces zu erstellen.
Das Tool erstellt einen Speicherauszug mit dem Serverstammkontext für die angegebene Host/Port-Kombination, sofern Sie keinen, den Stammkontext ausschließenden anderen Anfangskontext angeben. Für die Stammkontexte anderer Server wird kein Speicherauszug erstellt.

dumpNameSpace ausführen
Sie können das Tool über die Befehlszeile oder die Programmschnittstelle des Tools ausführen. In diesem Artikel werden Aufrufe über die Befehlszeile beschrieben. Wenn Sie das Tool "dumpNameSpace" über seine eigene Programmschnittstelle aufrufen möchten, lesen Sie die Informationen zur Klasse com.ibm.websphere.naming.DumpNameSpace in der API-Dokumentation zu WebSphere Application Server.
Wenn Sie das Tool über die Befehlszeile aufrufen möchten, müssen Sie den Befehl dumpNameSpace im Verzeichnis Stammverzeichnis_des_Anwendungsservers/bin eingeben.
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[z/OS]](../images/ngzos.gif)
dumpNameSpace.sh [[-keyword Wert]...]
![[Windows]](../images/windows.gif)
![[IBM i]](../images/iseries.gif)
dumpNameSpace [[-keyword Wert]...]
Wenn Sie das Tool "dumpNameSpace" ausführen und die Sicherheit aktiviert und die Eigenschaft "com.ibm.CORBA.loginSource" in der Datei Profilstammverzeichnis/properties/sas.client.props gesetzt ist, wird ein Anmeldedialog angezeigt.
Wenn Sie den Anmeldedialog abbrechen, setzt das Tool "dumpNameSpace" die Verarbeitung für abgehende Anforderungen mit einem Berechtigungsnachweis des Typs "UNAUTHENTICATED" (nicht authentifiziert) fort. Deshalb wird standardmäßig ein Berechtigungsnachweis vom Typ "UNAUTHENTICATED" verwendet, der der Zugriffsberechtigungsrichtlinie "Alle" entspricht. Sie können diese Standardeinstellung ändern, indem Sie den Wert der Eigenschaft com.ibm.CSI.performClientAuthenticationRequired in der Datei Stammverzeichnis_des_Anwendungsservers/properties/sas.client.props in true ändern.
Wenn Sie die Eigenschaft com.ibm.CORBA.loginSource in der Datei sas.client.props nicht definieren, verwendet das Tool "dumpNameSpace" weiterhin den Benutzernamen und das Kennwort aus dem Berechtigungsnachweis für abgehende Anforderungen.
Wenn Kerberos (KRB5) für die Verwaltungsauthentifizierung aktiviert ist, unterstützt authenticationTarget sowohl BasicAuth als auch KRB5. Zur Verwendung der Kerberos-Authentifizierung müssen Sie je nach Connector-Typ die Datei sas.client.props, soap.client.props bzw. ipc.client.props ändern. Bei der Verwendung der Kerberos-Authentifizierung wird das Benutzerkennwort nicht über die Verbindung übertragen. Der Client wird über einen unumkehrbaren Hash-Wert identifiziert.
Parameter
Die Schlüsselwörter und Werte für das Tool dumpNameSpace sind im Folgenden beschrieben:
- -host myhost.company.com
- Zeigt den Bootstrap-Host oder den WebSphere Application Server-Host an, für dessen
Namespace Sie einen Speicherauszug erstellen möchten. Der Standardwert ist localhost.
Geben Sie einen Wert für -host an, wenn das Tool nicht auf der lokalen Maschine ausgeführt wird.
Der Parameter -host weist das Tool an, eine Verbindung zu einem Server auf einer fernen Maschine herzustellen.
Führen Sie beispielsweise
aus, um den Namespace des Servers anzuzeigen, der auf "meinhost.meinecompany.com" ausgeführt wird.dumpNameSpace -host meinhost.meinecompany.com
- -port nnn
- Zeigt den Bootstrap-Port an, der, falls nicht angegeben, den Standardwert 2809 annimmt.
- -root {cell | server | node | host | legacy | tree | default}
- Zeigt den Stammkontext an, der als Ausgangskontext für den Speicherauszug verwendet werden soll.
Die verfügbaren Optionen von -root und der Standardstammkontext sind von dem Namensserver, von dem
der Speicherauszug abgerufen wird, abhängig. Es folgen Beschreibungen der Optionen für -root.
Für Server von WebSphere Application Server:
Tabelle 1. Beschreibungen der Optionen für "-root" für Produktserver. Der Stammkontext wird als Ausgangskontext für den Speicherauszug verwendet. Option für "-root" Beschreibung Zelle DumpNameSpace-Standardwert für Server der Version 5.0 und höher. Gibt die Baumstruktur beginnend beim Zellenstammkontext aus. Server Gibt die Baumstruktur, beginnend beim Serverstammkontext aus. node Gibt die Baumstruktur, beginnend beim Knotenstammkontext aus. tree Gibt die Baumstruktur, beginnend beim Stammkontext der Baumstruktur aus. applications Gibt die Baumstruktur, beginnend beim Anwendungsstammverzeichnis aus. Für alle Namensserver von WebSphere Application Server und andere Namensserver:
Tabelle 2. Beschreibungen der Optionen des Parameters "-root" für Produktserver und andere Server. Der Stammkontext wird als Ausgangskontext für den Speicherauszug verwendet. Option für "-root" Beschreibung Standardwert Gibt die Baumstruktur, beginnend beim Ausgangskontext aus, den JNDI standardmäßig für diesen Servertyp zurückgibt. Dies ist die einzige Option von -root, die mit Namensservern kompatibel ist, die keine Namensserver des Produkts sind. - -url Provider-URL
- Zeigt den Wert für die Eigenschaft "java.naming.provider.url" an, die zum Abrufen des JNDI-Ausgangskontextes verwendet wird. Diese Option kann anstelle der Optionen -host, -port und -root verwendet werden. Wenn die Option -url angegeben ist, werden die Optionen -host, -port und -root ignoriert.
- -factory com.ibm.websphere.naming.WsnInitialContextFactory
- Zeigt die Ausgangskontextfactory an, die zum Abrufen des JNDI-Ausgangskontextes verwendet werden soll. Der Standardwert ist com.ibm.websphere.naming.WsnInitialContextFactory. Im Allgemeinen ist es nicht erforderlich, den Standardwert zu ändern.
- -startAt ein/Subkontext/in/der/Struktur
- Zeigt den Pfad vom Stammkontext des Bootstrap-Host zum Kontext der Ausgangsebene an, bei dem der Speicherauszug beginnen soll. Das Tool erstellt rekursiv Speicherauszüge für Subkontexte, die sich unterhalb dieses Punkts befinden. Standardmäßig wird eine leere Zeichenfolge angenommen. In diesem Fall handelt es sich um den Stammkontext des Bootstrap-Host.
- -format { jndi | ins }
Tabelle 3. Beschreibungen der Optionen für "-format". Die Optionen sind "jndi" und "ins". Option für "-format" Beschreibung jndi Die Standardeinstellung. Zeigt Namenskomponenten in Form von nicht weiter zerlegbaren Zeichenfolgen an. ins Zeigt Namenskomponenten an, die anhand von INS-Regeln (Interoperable Naming Service) (id.kind) syntaktisch analysiert wurden. - -report { short | long }
Tabelle 4. Beschreibungen der Optionen für "-report". Die Optionen sind "short" und "long". Option für "-report" Beschreibung short Die Standardeinstellung. Erstellt einen Speicherauszug für den Bindungsnamen und den gebundenen Objektnamen. Diese Ausgabe wird auch von JNDI Context.list() bereitgestellt. long Erstellt einen Speicherauszug für den Bindungsnamen, den gebundenen Objekttyp, den lokalen Objekttyp und die Zeichenfolge des lokalen Objekts (d. h. die IORs, Zeichenfolgewerte und andere ausgegebene Werte). Damit Objekte benutzerdefinierter Klassen mit der Berichtsoption "long" ordnungsgemäß angezeigt werden, ist es möglicherweise erforderlich, deren übergeordnete Verzeichnisse der Liste der gesuchten Verzeichnisse hinzuzufügen. Setzen Sie über die Befehlszeile die Umgebungsvariable WAS_USER_DIRS. Der Wert kann ein oder mehrere Verzeichnisse enthalten.
WAS_USER_DIRS=/usr/classdir1:/usr/classdir2 export WAS_USER_DIRS
set WAS_USER_DIRS=c:\classdir1;d:\classdir2
Alle .zip-, .jar- und .class-Dateien, die sich in den angegebenen Verzeichnissen befinden, können beim Ausführen des Tools "dumpNameSpace" vom Klassenlader aufgelöst werden.
- -traceString "some.package.name.to.trace.*=all=enabled"
- Gibt die Tracezeichenfolge an, die dasselbe Format wie die von den Servern generierte Zeichenfolge hat. Die Ausgabe wird an die Datei DumpNameSpaceTrace.out gesendet.
Rückkehrcodes
Das Tool "dumpNameSpace" hat die folgenden Rückkehrcodes:
Rückkehrcode | Beschreibung |
---|---|
0 | Normaler Systemexit. Bei der Ausführung von dumpNameSpace ist kein Fehler aufgetreten. |
1 | Fehler beim Abrufen des Startkontextes |
2 | Anderer Fehler mit Ausnahme. Bei der Ausführung von dumpNameSpace ist ein Fehler aufgetreten, der nichts mit dem Abrufen des Startkontextes zu tun hat. |
3 | Nicht unterstützte Option angegeben |