[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]

Technical Reference: Base Operating System and Extensions, Volume 1

HBA_SetRNIDMgmtInfo Subroutine


Sends a SCSI SET RNID command to a remote port of the end device.


Common Host Bus Adapter Library (libHBAAPI.a)


#include <hbaapi.h>

HBA_STATUS HBA_SetRNIDMgmtInfo (handle, pInfo)
HBA_HANDLE handle;


The HBA_SetRNIDMgmtInfo subroutine sends a SCSI SET RNID (Request Node Identification Data) command with the SCIOLCHBA operation as its argument. This is done through a call to ioctl. The arg parameter for the SCIOLCHBA operation is the address of a scsi_chba structure. This structure is defined in the /usr/include/sys/scsi_buf.h file. The scsi_chba parameter block allows the caller to select the SET RNID command to be sent to the adapter. The pInfo structure stores the RNID data to be set. The pInfo structure is defined in the /usr/include/sys/hbaapi.h file. The structure includes:

If successful, the SET RNID data in pInfo is sent to the adapter.


handle Specifies the open file descriptor obtained from a successful call to the open subroutine.
pInfo Specifies the structure containing the information to be set or received from the RNID command

Return Values

Upon successful completion, the HBA_SetRNIDMgmtInfo subroutine returns a value of HBA_STATUS_OK, or a value of 0. If unsuccessful, a value of HBA_STATUS_ERROR, or a 1 is returned.

Error Codes

The Storage Area Network Host Bus Adapter API subroutines return the following error codes:

HBA_STATUS_OK A value of 0 on successful completion.
HBA_STATUS_ERROR A value of 1 if an error occurred.
HBA_STATUS_ERROR_INVALID_HANDLE A value of 3 if there was an invalid file handle.

Related Information

HBA_SendScsiInquiry Subroutine, HBA_SendReadCapacity Subroutine, HBA_SendCTPassThru Subroutine, HBA_SendReportLUNs Subroutine, HBA_SendRNID Subroutine, and HBA_GetRNIDMgmtInfo Subroutine.

SCSI Adapter Device Driver in AIX 5L Version 5.2 Technical Reference: Kernel and Subsystems Volume 2.

Special Files in AIX 5L Version 5.2 Files Reference.

SCSI Subsystem Overview, A Typical Initiator-Mode SCSI Driver Transaction Sequence, Required SCSI Adapter Device Driver ioctl Commands, Understanding the Execution of Initiator I/O Requests, SCSI Error Recovery, and Understanding the sc_buf Structure in AIX 5L Version 5.2 Kernel Extensions and Device Support Programming Concepts.

[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]