Download SmartLib User Guide

HGRemovePortIdFromGroup
Description
This command can be used to remove individual hub/slot/port designations
from a currently configured group which has been set up using
HGSetGroup.
Syntax
int HGRemovePortIdFromGroup (int iPortId)
Parameters
iPortId
Return
Value
The return value is >= 0 if the function executed successfully. A failure
code, which is less than zero, is returned if the function failed. See
Appendix A.
Comments
The first hub in the daisy chain from the control section would contain the
first set of ports to be identified. The port in the left-most (lowest
numbered) slot in the first hub is identified as iPortId=1, the next port in
the sequence going left to right across the slots, would be identified as
iPortId=2, and so on until all existing ports in the first hub have been
identified. Any empty slots are skipped over for the purposes of assigning
PortId numbers. The next hub in the daisy chain connection (at the back
of the test bay) would then continue with the next counting number as the
iPortId identifier.
int Identifies the port which is to be removed from the
currently configured group. The value used for the
iPortId is determined from the ordinal counting number
of existing ports in the test bay.
Example 1: Assume you have a 4 hub test bay with 20 ports in each hub.
Then the ports in the first hub are identified left to right as ports 1
through 20. The second hub ports are identified left to right as ports 21
through 40. The third hub ports are identified left to right as ports 41
through 60. And the fourth hub ports are identified left to right as ports 61
through 80.
Example 2: Assume you have a four hub test bay with 7 ports in the first
hub, 4 ports in the second hub, no ports in the third hub and 3 ports in the
fourth hub. The first hub ports are identified left to right as ports 1
through 7. The second hub ports are identified left to right as ports 8
through 11. The third hub is skipped over as any other empty slots are
and the counting continues at the next port, which happens to be in the
fourth hub. The ports in the fourth hub are then identified left to right as
ports 12 through 15.
120
SmartLib User Guide