HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_DIRECTORY_ENTRY
AP_NONE
The real owner is the parent resource.
AP_ENCP_RESOURCE
The real owner is an end node that is not the parent resource. For example, if the resource is owned by
an End Node in the domain of a Branch Network Node (BrNN), the directory of this BrNN’s Network
Node Server includes the BrNN as the parent resource, but the real owning CP is the End Node.
directory_entry_summary.real_owning_cp_name
This parameter applies only if the local node is a Network Node or a Branch Network Node; it is reserved
otherwise.
If the
real_owning_cp_type parameter indicates that the real owner of the resource is not the parent, this
parameter specifies the fully qualified name of the CP that owns the resource; otherwise it is reserved.
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.
directory_entry_detail.overlay_size
The size of the returned
directory_entry_detail
structure, and therefore the offset to the start of the next entry in
the data buffer.
When your application needs to go through the returned buffer to find each
directory_entry_detail structure in
turn, it must use this value to move to the correct offset for the next data structure, and must not use the
C
sizeof() operator. This is because the size of the returned overlay may increase in future releases of
SNAplus2; using the returned overlay size ensures that your application will continue to work with future
releases.
directory_entry_detail.resource_name
Fully qualified name of the resource. 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.
directory_entry_detail.resource_type
Type of the resource. This is one of the following:
AP_ENCP_RESOURCE
End node or LEN node
AP_NNCP_RESOURCE
Network node
AP_LU_RESOURCE
LU
directory_entry_detail.description
A null-terminated text string describing the directory entry, as specified in the definition of the directory entry.
directory_entry_detail.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. This parameter is not used for a
network node resource.
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.
directory_entry_detail.parent_type
Resource type of the parent resource. For a network node resource, this parameter is not used. Otherwise, it
is one of the following:
395