Report Target Port Groups (A3h)

Report Target Port Groups (A3h) returns the Target Port Group data for all ports.

Service Action

0Ah

Allocation Length

The length of the parameter list the library returns. The library transfers either the number of bytes specified by the Allocation Length field or all of the available Report Target Port Group data, whichever is less.

The minimum allocation length required to return all data depends on the number of FC ports and the redundant control paths activation file.

If the library has the redundant control paths (multi-port) activation file:

  • 14h (20d) = The library has two active FC ports (1 and 2).
  • 1Ch (28d) = The library has four active FC ports (1, 2, 3 and 4).

If the library does not have the redundant control paths (multi-port) activation file:

  • 1Ch (28d) = The library has one active FC ports (1) and one unavailable port (2).
  • 24h (36d) = The library has two active FC ports (1 and 3) and two unavailable ports (2 and 4).

For more information on port activation, see Behavior of Unavailable Fibre Channel Ports.

Report Target Port Group Data

Returned Data Length

The number of bytes of Report Target Port Group data available. The length depends on the number of ports in the library and the redundant control paths (multi-port) activation file.

Target Port Group Descriptor Data

PREF

0 = The target port group is not a preferred target port

1 = The target port group is a preferred target port. All ports in the Active/Optimized group are preferred.

Asymmetric Access State

0h = Active/Optimized — the ports in the group are fully operational.

3h = Unavailable — The library does not have the redundant control paths (multi-port) activation file installed.

T_Sup

0 = The library does not support the transitioning asymmetric access state.

U_Sup

1 = The library supports the unavailable asymmetric access state.

S_Sup

0 = The library does not support the standby asymmetric access state.

AN_Sup

0 = The library does not support the active/non-optimized asymmetric access state.

AO_Sup

1 = The library supports the active/optimized asymmetric access state.

Target Port Group

01h = Target Port Group 1

02h = Target Port Group 2

Status Code

2 = The target port group asymmetric access state is altered by implicit asymmetrical logical unit access behavior.

Target Port Group Count

The number of target ports that are in the target port group and the number of target port descriptors in the target port group descriptor. This can range from 1 to 4.

Target Port Descriptor Data

Relative Target Port Identifier

The port number. This can range from 1 to 4.