NAMING Shell Commands

Use

This section contains the Shell commands used for the AS Java JNDI Registry Service administration. They are added to the Shell environment by executing ADD NAMING on the command line.

More information about working with Shell commands: Administration Using Telnet

You can browse the naming tree, modify objects, modify contexts and use attributes with the following Shell commands:

Browsing the Naming Tree

Syntax	`CD <location>`
Arguments
`<location>`	The path of contexts starting from the current context, plus the name of the targeted context.
Description	Changes the current context.

Syntax	`FIND <location> <filter> [-s <scope>] [-c <count>]`
Arguments
`<location>`	The path to the location.
`<filter>`	Filter to use. The search filters and their syntax are described in RFC 2254.
`-s <scope>`	Scope to search with (OBJECT, ONELEVEL, SUBTREE).
`-c <count>`	Number of the returned items.
Description	Searches a location for matches with the attributes from ATTR.

Syntax	`LOOKUP <location>`
Argument
`<location>`	The whole path of contexts, starting from the root context of the naming system, plus the atomic name of the object.
Description	Returns the object associated with the specified location.

Syntax	`RLOOKUP <url> [<user> <password>] <location>`
Arguments
`<url> [<user> <password>] <location>`	The provider URL ( host:port ) of the naming service to be used; login credentials if needed; the path to the location (object, context) to be looked up.
Description	Performs a remote look up, according to the specified parameters.

Syntax	`LS [-l [-a] [-f]] [location]`
Arguments
`[-l]`	Lists details.
`[-a]`	Shows the attributes. Can be used only with -l parameter.
`[-f]`	Shows the full names. Can be used only with -l parameter.
`[location]`	The path to the location.
Description	Lists the contents of the current context. If no parameters are specified, the current context is listed.

Syntax	`LSN [location] [-c]`
Arguments
`[location]`	The path to print.
`[-c]`	Output class names and object values.
Description	Displays the naming system as a tree. If location is not specified, prints the working context.

Syntax	`LSR`
Description	Displays the containers in the naming repository as a tree.

Syntax	`PWD`
Description	Displays the name of the current context.

Syntax	`SEARCH <location>`
Arguments
`<location>`	The path of contexts, starting from the current context of the naming system, specifying the search location.
Description	Searches the location for matches with the attributes from `ATTR` .

Modifying Objects

Syntax	`BIND <location> <string>`
Arguments
`<location>`	The whole path of contexts, starting from the root context of the naming system, plus the atomic name of the object.
`<string>`	The text to bind.
Description	Binds a string to the specified location. If there are objects set with the ATTR command, they will be assigned as attributes to the bound object.

Syntax	`REBIND <location> <string>`
Arguments
`<location>`	The whole path of contexts, starting from the root context of the naming system, plus the atomic name of the object.
`<string>`	The text to bind.
Description	Rebind the specified parameters to the specified location. If there are objects set with the ATTR command, they will be assigned as attributes to the rebound object.

Syntax	`UNBIND <location>`
Arguments
`<location>`	The path of contexts starting from the current context of the naming system, plus the atomic name of the object to be removed.
Description	Unbinds the specified location. Note Only objects can be unbound. Caution Unbinding permanently removes objects.

Modifying Context

Syntax	`DELTREE <location>`
Arguments
`<location>`	The whole path of contexts, starting from the root context of the naming system, plus the atomic name of the object.
Description	Deletes all entities under the specified context. Caution Use this command with extreme care. Permanently deleting context content may cause undesired behavior of your application.

Syntax	`MSUB <location>`
Arguments
`<location>`	The name of the new subcontext.
Description	Creates a subcontext with the specified name in the current context.

Syntax	`RSUB <location>`
Arguments
`<location>`	The path of contexts, starting from the current context of the naming system, plus the atomic name of the subcontext to be removed.
Description	Removes the specified subcontext.

Using Attributes

Syntax	`ATTR [<attribute><-a\|-r attribute [value]>\|<-r>]`
Arguments
`-a`	Sets attribute, or adds value to an attribute.
`-r`	Removes value/attribute/all attributes.
`<attribute>`	Attribute to modify or print.
`<value>`	Value to set/add/remove.
Description	Creates a combination of attributes that can be further used in bind, rebind, search, find, and mattr operations. The attributes that are created can only be used together, that is, no matter if you have created 1 or 10 attributes, they will be used as one during the operations.

Syntax	`MATTR <-a\|-rp\|-rm> <location>`
Arguments
`<-a>`	Adds the attributes. Default.
`<-rp>`	Replaces the attributes.
`<-rm>`	Removes the attributes.
`<location>`	The name of the item.
Description	Modifies attributes using the attributes from `ATTR` .

Syntax	`MENV [<-a\|-r> <entry> [text]]`
Arguments
`-a`	Adds the entry.
`-r`	Removes the entry.
`<entry>`	The name of the item.
`<text>`	The value of the entry.
Description	Modifies or prints the JNDI environment properties.