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

HBA_GetAdapterPortAttributes(3) OSS Library Calls Reference Manual

NAME

HBA_GetAdapterPortAttributes - Retrieves attributes of a port of a Fibre Channel Host Bus

Adapter

LIBRARY

H-series OSS processes: /usr/lib/libcmnapi.a

SYNOPSIS

#include <snia_common.h>

HBA_STATUS HBA_GetAdapterPortAttributes (

HBA_HANDLE handle,

HBA_UINT32 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 to be queried. The port index value ranges from 0 (zero) to 1

less than the NumberOfPorts returned from the HBA_GetAdapterAttributes( )

function.

port_attributes Used for returning the adapter port attributes.

DESCRIPTION

The HBA_GetAdapterPortAttributes( ) function retrieves the attributes for the speciﬁed port

on an adapter. The handle parameter is of type HBA_HANDLE (deﬁned 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 deﬁned in the Fibre Channel - Methodologies for Intercon-

nects (FC-MI) Revision 1.6.

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.

3−176 Hewlett-Packard Company 527187-017