Namespace dump utility for java:, local: and server namespaces
Sometimes it is helpful to dump the java: namespace for a Java EE application. We cannot use the dumpNameSpace command line utility for this purpose because the application's java: namespace is accessible only by that Java EE application. From the product scripting tool, we can invoke a NameServer MBean to dump the java: namespace for any Java EE application running in that same server process.
There is another namespace local to server process which we cannot dump with the dumpNameSpace command line utility. This namespace has the URL scheme of local: and is used by the container to bind objects locally instead of through the name server. The local: namespace contains references to enterprise beans with local interfaces. There is only one local: namespace in a server process. We can dump the local: namespace by invoking the NameServer MBean associated with that server process.
Namespace dump options
Namespace dump options are specified in the MBean invocation as a parameter in character string format. The option descriptions follow.
- -startAt some/subcontext/in/the/tree
- Indicates the path from the namespace root context to the top level context where the dump should begin. The utility recursively dumps subcontexts beneath this point. It defaults to an empty string, that is, the root context.
- -report {short | long}
Option Description short The default. Dumps the binding name and bound object type. This output is also provided by JNDI Context.list(). long Dumps the binding name, bound object type, local object type, and string representation of the local object (that is, the IORs, string values, and other values that are printed).
- -root {tree | host | legacy | cell | node | server | default}
- Specify the root context of where the dump should start. The default value for -root is cell. This option is only valid for server namespace dumps.
Option Description tree Dump the tree starting at the tree root context. host Dump the tree starting at the server host root context (synonymous with "node"). legacy Dump the tree starting at the legacy root context. cell Dump the tree starting at the cell root context. This is the default option. node Dump the tree starting at the node root context (synonymous with "host"). server Dump the tree starting at the server root context. This is -root default. default Dump the tree starting at the initial context which JNDI returns by default for that server type.
- -format {jndi | ins}
Specify the format to display name component as atomic strings or parsed according to INS rules (id.kind). This option is only valid for server namespace dumps.
Option Description jndi Display name components as atomic strings. This is -format default. ins Display name components parsed according to INS rules (id.kind).
View java:, local:, and server namespace dumps View a namespace dump Troubleshoot namespace problems dumpNameSpace tool