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

SEE ALSO

fibreChannel