NAMING Shell Commands
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
CD
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. |
FIND
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. |
LOOKUP
Syntax |
LOOKUP <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 |
Returns the object associated with the specified location. |
RLOOKUP
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. |
LS
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. |
LSN
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. |
LSR
Syntax |
LSR |
Description |
Displays the containers in the naming repository as a tree. |
PWD
Syntax |
PWD |
Description |
Displays the name of the current context. |
SEARCH
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
BIND
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. |
REBIND
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 rebind. |
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. |
UNBIND
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.
Only objects can be unbound.
Unbinding permanently removes objects.
|
Modifying Contexts
DELTREE
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.
Use this command with extreme care. Permanently deleting context content may cause undesired behavior of your application. |
MSUB
Syntax |
MSUB <location> |
Arguments |
|
<location> |
The name of the new subcontext. |
Description |
Creates a subcontext with the specified name in the current context. |
RSUB
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
ATTR
Syntax |
ATTR [<attribute>|<-a|-r attibute [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. |
MATTR
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. |
MENV
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. |