extendedLinkServices
extendedLinkServices-inserts Extended Link Services (ELS) protocols in a fibre channel module
SYNOPSIS
extendedLinkServices sub-command options
DESCRIPTION
An Extended Link Service (ELS) request solicits a destination Nx_Port to perform a function. An ELS reply is transmitted in response to an ELS request, unless otherwise specified. Each request or reply is composed of a single Sequence with the ELS_Command code being specified in the first word of the Payload of the first frame of the Sequence.
STANDARD OPTIONS
fcElsProtocolType
The Extended Link Services protocol types are as follows:
Option |
Usage |
---|---|
ElsFlogi |
Sets Fabric Login (FLOGI) ELS Service Parameters. |
ElsPlogi |
Sets Process Login (PLOGI) ELS Service Parameters. |
ElsFdisc |
Sets the Discover F_Port Service (FDISC) ELS Service Parameters. |
ElsLsAcc |
Sets the Link Service Accept (LS_ACC) ELS Service Parameters. |
ElsLogo |
Sets the Link Service Accept (LS_ACC) ELS Service Parameters. |
ElsScr |
Sets the State Change Registration (SCR) ELS Service Parameters. |
ElsLsRjt |
Sets the Link Service Reject (LS_RJT) ELS Service Parameters. |
ElsRscn |
Sets the Registered State Change Notification (RSCN) ELS Service Parameters. |
elsFlogi
The Fabric Login (FLOGI) ELS transfers Service Parameters from the initiating Nx_Port to the FC_Port associated with the D_ID. The FLOGI frame provides the means by which an Nx_Port requests Login with the Fabric. Login with the Fabric is required for all Nx_Ports, regardless of the class supported. Communication with other Nx_Ports is not attempted until the Fabric Login procedure is complete.
The options are as follows:
Option |
Usage |
---|---|
bufferToBufferCredit |
It is the limiting value for BB_Credit_CNT in the buffer-to-buffer flow control model. If a Fabric is present, FLOGI initializes the buffer-to-buffer Credit. |
bbScNumber |
The Buffer-to-buffer State Change Number (BB_SC_N) field specifies the Buffer-to-buffer State Change Number. It indicates that the sender of the FLOGI frame is requesting 2BB_SC_N number of frames to be sent between two consecutive BB_SCs primitives, and 2BB_SC_N number of R_RDY primitives to be sent between two consecutive BB_SCr primitives. |
receiveDataFieldSize |
The field size of the data received from the FC_Port. |
portWWN |
The eight-byte field that identifies an FC_Port. |
nodeWWN |
The eight-byte name identifier associated with a node. |
eDTOV |
The EDTOV value. |
elsPlogi
The PLOGI ELS transfers Service Parameters from the initiating Nx_Port to the FC_Port associated with the D_ID. The PLOGI frame provides the means by which an Nx_Port requests Login with another Nx_Port prior to other Data frame transfers.
The options are as follows:
Option |
Usage |
---|---|
bufferToBufferCredit |
It is the limiting value for BB_Credit_CNT in the buffer-to-buffer flow control model. If a Fabric is present, FLOGI initializes the buffer-to-buffer Credit. |
bbScNumbe |
The Buffer-to-buffer State Change Number (BB_SC_N) field specifies the Buffer-to-buffer State Change Number. It indicates that the sender of the PLOGI frame is requesting 2BB_SC_N number of frames to be sent between two consecutive BB_SCs primitives, and 2BB_SC_N number of R_RDY primitives to be sent between two consecutive BB_SCr primitives. |
receiveDataFieldSize |
The field size of the data received from the FC_Port. |
portWWN |
The eight-byte field that identifies an FC_Port. |
nodeWWN |
The eight-byte name identifier associated with a node. |
eDTOV |
The EDTOV value. |
elsFdisc
The Discover F_Port Service Parameters (FDISC) ELS transfers Service Parameters from the initiating Nx_Port to the Fx_Port at well-known F_Port_ID. This provides the means for the exchange of Service Parameters and the assignment of an additional N_Port_IDs without changing service parameters.
The options are as follows:
Option |
Usage |
---|---|
bufferToBufferCredit |
It is the limiting value for BB_Credit_CNT in the buffer-to-buffer flow control model. If a Fabric is present, FLOGI initializes the buffer-to-buffer Credit. |
bbScNumber |
The Buffer-to-buffer State Change Number (BB_SC_N) field specifies the Buffer-to-buffer State Change Number. It indicates that the sender of the PLOGI frame is requesting 2BB_SC_N number of frames to be sent between two consecutive BB_SCs primitives, and 2BB_SC_N number of R_RDY primitives to be sent between two consecutive BB_SCr primitives. |
receiveDataFieldSize |
The field size of the data received from the FC_Port. |
portWWN |
The eight-byte field that identifies an FC_Port. |
nodeWWN |
The eight-byte name identifier associated with a node. |
eDTOV |
The EDTOV value. |
elsLsAcc
The Link Service Accept (LS_ACC) ELS reply Sequence notifies the originator of an ELS request that the ELS request Sequence has been completed. The Responder terminates the Exchange by setting the Last Sequence bit (Bit 20) in F_CTL on the last Data frame of the reply Sequence. The first byte of the Payload contains 02h. The remainder of the Payload is unique to the ELS request.
The options are as follows:
Option |
Usage |
---|---|
bufferToBufferCredit |
It is the limiting value for BB_Credit_CNT in the buffer-to-buffer flow control model. If a Fabric is present, FLOGI initializes the buffer-to-buffer Credit. |
bbScNumber |
The Buffer-to-buffer State Change Number (BB_SC_N) field specifies the Buffer-to-buffer State Change Number. It indicates that the sender of the PLOGI frame is requesting 2BB_SC_N number of frames to be sent between two consecutive BB_SCs primitives, and 2BB_SC_N number of R_RDY primitives to be sent between two consecutive BB_SCr primitives. |
receiveDataFieldSize |
The field size of the data received from the FC_Port. |
portWWN |
The eight-byte field that identifies an FC_Port. |
nodeWWN |
The eight-byte name identifier associated with a node. |
eDTOV |
The EDTOV value. |
elsLogo
The LOGO ELS provides a method for explicitly removing service between two Nx_Port_IDs or between an N_Port_ID and a Fabric. Logout releases resources, identifiers, and relationships associated with maintaining service between an Nx_Port_ID and a destination Nx_Port_ID or Fabric.
The options are as follows:
Option |
Usage |
---|---|
portId |
The unique address identifier of the FC Port. |
portName |
The eight-byte field that identifies the FC Port. |
elsScr
The State Change Registration (SCR) ELS requests the Fabric Controller or Nx_Port to add the Nx_Port that is sending the SCR Request to the list of Nx_Ports registered to receive the RSCN ELS.
The options are as follows:
Option |
Usage |
---|---|
registrationFunction |
The Registration Functions for SCR. |
fcElsScrRegFunction
The Registration Functions for SCR ELS.
The options are as follows:
Option |
Usage |
---|---|
elsScrReserved |
The reserved format with value 0. |
elsScrFabricDetectedRegistration |
Register to receive all RSCN Requests issued by the Fabric Controller for events detected by the Fabric. |
elsScrNxPortDetectedRegistration |
Register to receive all RSCN Requests issued for events detected by the affected Nx_Port. |
elsScrFullRegistration |
Register to receive all RSCN Requests issued. The RSCN Request returns all affected N_Port_ID pages. |
elsScrClearRegistration |
Removes any current RSCN registrations. |
elsLsRjt
The Link Service Reject (LS_RJT) notifies the transmitter of a Link Service request that the Link Service request Sequence has been rejected. A four-byte reason code is contained in the Data Field. Link Service Reject is transmitted for a variety of conditions that are unique to a specific Link Service request. For example, if the Service Parameters specified in a Login frame were logically inconsistent or in error, a P_RJT frame would not be transmitted in response, but rather a Link Service Reject.
The options are as follows:
Option |
Usage |
---|---|
FcElsRjtReasonCode |
The ELS LS_RJT reason codes. |
FcElsRjtReasonCode
The ELS LS_RJT reason codes.
The options are as follows:
Option |
Usage |
---|---|
elsRjtInvalidELSCommandcode |
The ELS_Command code in the Sequence being rejected is invalid. |
elsRjtLogicalError |
The request identified by the ELS_Command code and Payload content is invalid or logically inconsistent for the conditions present. |
elsRjtLogicalbusy |
The Link Service is logically busy and unable to process the request at this time. |
elsRjtProtocolError |
This indicates that an error has been detected that violates the rules of the ELS Protocol that are not specified by other error codes. |
elsRjtUnableToPerformCommand |
The Recipient of a Link Service command is unable to perform the request at this time. |
elsRjtCommandNotSupported |
The Recipient of a Link Service command does not support the command requested. |
elsRjtCommandAlreadyInProgress |
The command progress is tracked. |
elsRjtVendorSpecificError |
The Vendor specific error bits may be used by Vendors to specify additional reason codes. |
elsRscn
The Registered State Change Notification (RSCN) ELS is sent to registered Nx_Ports when an event occurs that may have affected the state of one or more Nx_Ports, or the ULP state within the Nx_Port. The term, state, is used here to refer to any condition of an Nx_Port that is considered important enough to notify other Nx_Ports of a change in that state. The RSCN provides an indication of the change of state that is being reported.
The options are as follows:
Option |
Usage |
---|---|
pageLength |
The length in bytes of an affected Port_ID page. This value is fixed at 04h. |
payLoadLength |
The length in bytes of the entire Payload, inclusive of the word 0. This value is a multiple of 4 bytes. The minimum value of this field is 8 bytes. The maximum value of this field is 1024 bytes. |
COMMANDS
The extendedLinkServices command is invoked with the following sub-commands. If no sub-command is specified, returns a list of all sub-commands available.
extendedLinkServices setDefault option
Sets to IxTclHal default values for all configuration options.
extendedLinkServices set option
Sets the current configuration of the extendedLinkServices for the indicated port. Call this command before calling extendedLinkServices get option value to get the value of the configuration option.
extendedLinkServices get option
Gets the current configuration of the extendedLinkServices for the indicated port.
EXAMPLES
See under fibreChannel