Open System Services Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

HBA_GetDiscoveredPortAttributes(3) OSS Library Calls Reference Manual
NAME
HBA_GetDiscoveredPortAttributes - Retrieves attributes of a specified HBA port discovered
in the network
LIBRARY
H-series OSS processes: /usr/lib/libcmnapi.a
SYNOPSIS
#include <snia_common.h>
HBA_STATUS HBA_GetDiscoveredPortAttributes (
HBA_HANDLE handle,
HBA_UINT32 port_index,
HBA_UINT32 discovered_port_index,
PHBA_ADAPTERATTRIBUTES *adapter_attributes
);
PARAMETERS
handle Handle to an adapter that has been opened by a call to the
HBA_OpenAdapter( ) function.
port_index Index of the port. The port index value ranges from 0 (zero) to 1 less than the
NumberOfPorts returned from the HBA_GetAdapterAttributes( ) function.
_discovered_port_index
Index of the discovered port for which port attributes are desired. The port index
value ranges from 0 (zero) to 1 less than the NumberOfDiscoveredPorts returned
from the HBA_GetAdapterPortAttributes( ) function.
port_attributes Used for returning the adapter port attributes.
DESCRIPTION
The HBA_GetAdapterPortAttributes( ) function retrieves the attributes for the specified port
on an adapter. The handle parameter is of type HBA_HANDLE (defined in the Fibre Channel -
Methodologies for Interconnects (FC-MI) Revision 1.6) and is obtained through a call to the
HBA_OpenAdapter( ) function. The port_attributes parameter is a pointer to a structure of type
HBA_PORTATTRIBUTES, which is defined in the Fibre Channel - Methodologies for Intercon-
nects (FC-MI) Revision 1.6.
NumberOfDiscoveredPorts is always 0 for discovered port attributes.
This implementation returns HBA_PORTSPEED_UNKNOWN for PortSpeed and
PortSupportedSpeed attributes for all remote ports.
If a string variable is not supported, the string attribute is set to the value Not Supported.
Calling Order
You must call the HBA_GetAdapterAttributes( ) function for an adapter before you can call the
HBA_GetAdapterPortAttributes( ) function or the HBA_GetPortStatistics( ) function for the
same adapter.
You must call the HBA_GetAdapterPortAttributes( ) function for an adapter and port before
you can call the HBA_DiscoveredPortAttributes( ) function for the same adapter and port.
EXAMPLES
HBA_STATUS status;
HBA_PORTATTRIBUTES port_attributes;
/* Get the attributes for the first discovered port on first
adapter port */
status = HBA_GetDiscoveredPortAttributes(handle, 0, 0,
3−178 Hewlett-Packard Company 527187-017