Administration Commands
query_directory_entry
When the command is issued to a running node, it returns information about the resources that have been explicitly defined (using define_directory_entry or define_adjacent_len_node) and the resources that have been located dynamically in the directory database. If the node is not running, only explicitly defined entries are returned.
When the command is issued to an end node, it returns information only about the end node and its resources, but not about other nodes contained in the directory database. The first entry returned is for the end node, followed by its LUs. (No entry is returned for the end node’s network node server.)
When the command is issued to a network node, it returns information about multiple network nodes and their associated end nodes and LUs contained in the directory. For each network node, the information returned is in the following order:
1.The network node.
2.The LUs owned by this node.
3.The first end node associated with the network node.
4.The LUs owned by this end node.
5.Any other end nodes associated with the network node, each followed by its LUs.
2.118.1 Supplied Parameters
Parameter name | Type | Length | Default |
[query_directory_entry] |
|
|
|
num_entries | decimal | 1 |
|
list_options | constant |
| SUMMARY + LIST_INCLUSIVE |
resource_name | character | 17 | (null string) |
resource_type | constant |
| NONE |
parent_name | character | 17 | (null string) |
parent_type | constant |
| NONE |
Supplied parameters are:
num_entries
Maximum number of resources for which data should be returned. You can specify 1 to return data for a specific resource, a number greater than 1 to return data for multiple resources, or 0 (zero) to return data for all resources.
list_options
The level of information required for each entry and the position in the list of resources from which SNAplus2 begins to return data. The list is ordered by parent_name, then by resource_name, and finally by resource_type.
Specify the level of information required with one of the following values:
SUMMARY
Summary information only
DETAIL
Detailed information
Use a + character to combine this value with one of the following values:
FIRST_IN_LIST
Start at the first entry in the list
LIST_INCLUSIVE
Start at the entry specified by the combination of the parent_name, resource_name, and resource_type parameters
