Command Reference Guide
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
337