HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_DIRECTORY_LU
Each entry in the data buffer consists of the following parameters:
directory_lu_summary.overlay_size
The size of the returned
directory_lu_summary
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_lu_summary
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_lu_summary.lu_name
Fully qualified name of the LU. 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_lu_summary.description
A null-terminated text string describing the directory entry, as specified in the definition of the directory entry.
directory_lu_detail.overlay_size
The size of the returned
directory_lu_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_lu_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_lu_detail.lu_name
Fully qualified name of the LU. 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 net-
work name of 1–8 A-string characters.
directory_lu_detail.description
A null-terminated text string describing the directory entry, as specified in the definition of the directory entry.
directory_lu_detail.server_name
Fully qualified name of the node that serves the LU. 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_lu_detail.lu_owner_name
Fully qualified name of the node that owns the LU. 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_lu_detail.location
Specifies the location of the resource. This is one of the following.
AP_LOCAL
The resource is at the local node.
AP_DOMAIN
The resource belongs to an attached end node.
AP_CROSS_DOMAIN
400