HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_DIRECTORY_ENTRY
AP_FIRST_IN_LIST
Start at the first entry in the list.
AP_LIST_INCLUSIVE
Start at the entry specified by the combination of the parent_name, resource_name, and resource_type
parameters.
AP_LIST_FROM_NEXT
Start at the entry immediately following the entry specified by the combination of the parent_name,
resource_name, and resource_type parameters.
The list is ordered by parent_name, then by resource_name, and lastly by resource_type. For more information
about how the list is ordered and how the application can obtain specific entries from it, see Section 2.7, List
Options For QUERY_* Verbs.
resource_name
Fully qualified name of the resource for which information is required, or the name to be used as an index
into the list of resources. This value is ignored if list_options is set to
AP_FIRST_IN_LIST.
The name is a 17-byte EBCDIC string, right-padded with EBCDIC spaces. It consists of a network ID of
up to 8 A-string characters, an EBCDIC dot (period) character, and a network name of up to 8 A-string
characters.
resource_type
Type of resource for which information is required. This value is ignored if list_options is set to
AP_FIRST_IN_LIST. Possible values are:
AP_ENCP_RESOURCE
End node or LEN node
AP_NNCP_RESOURCE
Network node
AP_LU_RESOURCE
LU
parent_name
Fully qualified resource name of the parent resource; for an LU the parent resource is the owning Control
Point, and for an end node or LEN node it is the network node server. To return only entries belonging to
the specified parent, set this parameter to the name of the parent resource and parent_type to the parent’s
resource type; to return all entries, set both parameters to binary zeros.
The name is a 17-byte EBCDIC string, padded on the right with EBCDIC spaces. It consists of a network ID
of 1–8 A-string characters, an EBCDIC dot (period) character, and a network name of 1–8 A-string characters.
parent_type
Resource type of the parent resource. To return only entries belonging to the specified parent, set this
parameter to the type of the parent resource; to return all entries, set this parameter to zero. Possible values
are:
AP_ENCP_RESOURCE
End node (for an LU resource owned by an end node)
AP_NNCP_RESOURCE
Network node (for an LU resource owned by a network node, or for an EN or LEN resource)
393