9.2. Access Egress QoS Policy Command Reference

This command creates a text description stored in the configuration file for a configuration context.

The description command associates a text string with a configuration context to help identify the context in the configuration file.

The no form of this command removes any description string from the context.

This command enables the context to create or edit an access egress QoS policy. The policy can be applied to multiple access ports. The access egress policy is common to services (SAPs) that are all egressing on a particular port.

Any changes made to an existing policy are applied to all access ports on which the policy is specified.

The remarking parameters and queue parameters are used when port-based queuing is configured

This command is used to create or edit a access egress QoS policy. The egress policy defines the queue parameters (CIR/PIR) for each of the forwarding class traffic as they egress on the access port. Policies in effect are templates that can be applied to multiple access ports as long as the scope of the policy is template. There are 8 queues always available per port for which parameters are configurable.

This command defines the fc node within the access egress QoS policy is used to contain the explicitly defined dot1p marking commands for the fc-name.

Note: When the mapping for the fc-name and marking value is not defined, the node for fc-name is not displayed in the show configuration or save configuration output.

The no form of this command removes the explicit dot1p marking commands for the fc-name.

This command explicitly defines the marking of the DEI bit for fc fc-name according to the in and out of profile status of the packet (fc-name may be used to identify the dot1p-value).

If no de-value is present, the default values are used for the marking of the DEI bit: for example, 0 for in-profile packets, 1 for out-of-profile ones – see IEEE 802.1ad-2005 standard.

If the de-value is specifically mentioned in the command line it means this value is to be used for all the packets of this forwarding class regardless of their in/out of profile status.

This command explicitly defines the egress IEEE 802.1P (dot1p) bits marking for fc-name. When the marking is set, all packets of fc-name that have either an IEEE 802.1Q or IEEE 802.1P encapsulation use the explicitly defined dot1p-value. If the egress packets for fc-name are not IEEE 802.1Q or IEEE 802.1P encapsulated, the dot1p command has no effect.

DEI marking can be enabled using the de-mark command along with this command for the command to take effect. When the de-mark command is configured along with this command, the DEI bit is marked in the packet to indicate the profile of the packet. The DEI bit is marked to 0 to indicate in-profile/green packet and 1 to indicate out-of-profile/yellow packet. If the force de-value parameter is specified then the DEI bit is set to specified value for all packets.

If the no form of this command is executed then software will use the dot1p-in-profile and dot1p-out-profile if configured, else it will use default values.

Note: The following rules are applied by software to determine the Dot1p values to when both dot1p command and dot1p-in-profile and dot1p-out-profile command is specified: If de-mark is not configured, then dot1p [in | out]-profile values are considered. Even if dot1p value is configured, it is configured it is ignored and if ‘dot1p [in | out]-profile’ value is not configured then default values are considered for that FC. If de-mark is configured and if dot1p value is configured then it is considered. Else if ‘dot1p [in | out]-profile’ value is configured it is considered. In this case, dot1p value, has the precedence over ‘dot1p [in | out]-profile’.

The command will add the capability to mark on an egress the in and out of profile status via a certain dot1p combination, similarly with the DEI options. It may be used when the internal in and out of profile status needs to be communicated to an adjacent network/customer device that does not support the DEI bit.

This command explicitly defines the egress IEEE 802.1P (dot1p) bits marking for fc-name. When the marking is set, all packets with in-profile status (or green color) of fc-name that have either an IEEE 802.1Q or IEEE 802.1P encapsulation use the explicitly defined dot1p-value. If the egress packets for fc-name are not IEEE 802.1Q or IEEE 802.1P encapsulated, the dot1p command has no effect.

If DEI marking is enabled using the de-mark command and the command ‘dot1p dot1p-value’ is used to configure the dot1p value, then this command has no effect. In other words, enabling DEI marking has precedence over this command and the system ignores this command.

When this command is used the DEI Bit is left unchanged by the egress processing if a tag exists. If a new tag is added, the related DEI bit is set to 0.

The no form of this command sets the IEEE 802.1P or IEEE 802.1Q priority bits to 0.

Note: The following rules are applied by software to determine the Dot1p values to when both dot1p command and dot1p-in-profile and dot1p-out-profile command is specified: If de-mark is not configured, then dot1p [in|out]-profile values are considered. Even if `dot1p <val>' command is configured it is ignored and if `dot1p [in|out]-profile' value is not configured then default values are considered for that FC. If de-mark is configured and if `dot1p <value>' command is configured then it is considered. Else if `dot1p [in|out]-profile' value is configured it is considered. In this case `dot1p <val>' has the precedence over `dot1p [in|out]-profile'. If marking is enabled and both dot1p <val> and dot1-[in|out]-profile commands are not specified, then the default values for default.

The command will add the capability to mark on an egress the in and out of profile status via a certain dot1p combination, similarly with the DEI options. It may be used when the internal in and out of profile status needs to be communicated to an adjacent network/customer device that does not support the DEI bit.

This command explicitly defines the egress IEEE 802.1P (dot1p) bits marking for fc-name. When the marking is set, all packets with out-of-profile status (or yellow color) of fc-name that have either an IEEE 802.1Q or IEEE 802.1P encapsulation use the explicitly defined dot1p-value. If the egress packets for fc-name are not IEEE 802.1Q or IEEE 802.1P encapsulated, the dot1p command has no effect.

If DEI marking is enabled using the de-mark command and the dot1p-value is configured, then this command has no effect. In other words, enabling DEI marking has precedence over this command and the system ignores this command.

When this command is used the DEI Bit is left unchanged by the egress processing if a tag exists. If a new tag is added, the related DEI bit is set to 0.

The no form of this command sets the IEEE 802.1P or IEEE 802.1Q priority bits to 0.

Note: The following rules are applied by software to determine the Dot1p values to when both dot1p command and dot1p-in-profile and dot1p-out-profile command is specified: If de-mark is not configured, then dot1p [in|out]-profile values are considered. Even if `dot1p <val>' command is configured it is ignored and if `dot1p [in|out]-profile' value is not configured then default values are considered for that FC. If de-mark is configured and if `dot1p <value>' command is configured then it is considered. Else if `dot1p [in|out]-profile' value is configured it is considered. In this case `dot1p <val>', has the precedence over `dot1p [in|out]-profile'. If marking is enabled and both dot1p <val> and dot1-[in|out]-profile commands are not specified, then the default values for default.

This command specifies the out-of-profile DSCP name for the forwarding class. When marking is set, the corresponding DSCP value is used to mark all IP packets with out-of-profile status, on the egress of this forwarding class queue.

When multiple DSCP names are associated with the forwarding class at network egress, the last name entered will overwrite the previous value.

The no form of this command reverts to the factory default out-of-profile dscp-name.

This command specifies the in-profile DSCP name for the forwarding class. When marking is set, the corresponding DSCP value is used to mark all IP packets with out-of-profile status, on the egress of this forwarding class queue.

When multiple DSCP names are associated with the forwarding class at network egress, the last name entered will overwrite the previous value.

The no form of this command reverts to the factory default in-profile dscp-name.

This command creates the context to modify queue parameters associated with a particular queue. The queue is identifiable by queue ID and FCs are mapped into the queues. See Forwarding Class to Queue-ID Map for 7210 SAS-M, 7210 SAS-T, and 7210 SAS-Mxp and Forwarding Class-to-Queue ID Map for 7210 SAS-Sx/S 1/10GE and 7210 SAS-Sx 10/100GE for more information.

This command enables the system to remark egress packets sent out of access ports. The user can specify if dot1p or dscp or both dot1p and dscp to be used for marking the packets sent out of the port.

When 7210 is operated in access-uplink mode, marking support is available as given below:

The no form of this command disables remarking.

This command enables the system to remark egress packets sent out of access ports. The user can specify if dot1p or dscp or both dot1p and dscp are to be used for marking the packets sent out of the port.

When 7210 SAS-M is operated in network mode, marking support is available as given below:

The no form of this command disables remarking.

This command specifies the remarking policy ID to use for marking packets on access egress (also known as, access port egress).

The remarking policy ID must be associated with the appropriate access egress policy and remarking must be enabled in the access egress policy to enable marking of packets sent out of all SAPs configured on the access port.

Only remarking policy of type dot1p, dscp, or dot1p-dscp is allowed to be used when the remark policy is associated with access-egress. See Summary of Remark Policy and Attachment Points for 7210 SAS-T, 7210 SAS-Sx/S 1/10GE, and 7210 SAS-Sx 10/100GE (Network Mode) and Summary of Remark Policy and Attachment Points for 7210 SAS-Mxp, for different remark policies supported on the node and its use.

The no form of this command removes the explicit association of the remark policy and associates the default remark policy. In other words, if remarking is enabled and no remark policy is executed, then the default remark policy is used to mark packets sent out. If no remark policy is executed and remarking is disabled, packets are not remarked.

This command enables the system to remark egress packets sent out of access ports.

When remarking is enabled, the remark policy configured in the QoS policy context is used to determine the FC to QoS bit mapping. For example, when remarking is enabled in the access-egress QoS policy, the remark policy associated with access-egress QoS policy is used to determine the FC to dot1p mapping to use for marking packets sent out of access ports.

See Remark Policies for the remark policy that can be used to configure FC to priority bit markings in different QoS policies associated with different service entities. For more information, see Summary of Remark Policy and Attachment Points for 7210 SAS-T, 7210 SAS-Sx/S 1/10GE, and 7210 SAS-Sx 10/100GE (Network Mode) and Summary of Remark Policy and Attachment Points for 7210 SAS-Mxp

The no form of this command disables remarking.

This command defines the method used by the system to derive the operational CIR and PIR rates when the queue is provisioned in hardware. For the cir and pir parameters, the system attempts to find the best operational rate depending on the defined constraint.

The no form of this command removes any explicitly defined constraints used to derive the operational CIR and PIR created by the application of the policy. When a specific adaptation-rule is removed, the default constraints for cir and pir apply.

This command defines the administrative Peak Information Rate (PIR) and the administrative Committed Information Rate (CIR) parameters for the queue. The PIR defines the maximum rate that the queue can transmit packets through the port. Defining a PIR does not necessarily guarantee that the queue can transmit at the intended rate. The actual rate sustained by the queue can be limited by oversubscription factors or available egress bandwidth. The CIR defines the rate at which the system prioritizes the queue over other queues competing for the same bandwidth.

The rate command can be executed at anytime, altering the PIR and CIR rates for all queues created on the access ports.

The no form of this command reverts all queues created with the queue ID by association with the QoS policy to the default PIR (max) and CIR (0) parameters.

This command configures the scope as exclusive or template. The policy’s scope cannot be changed if the policy is applied to multiple ports.

The no form of this command reverts the scope of the policy to the default.

This command copies existing QoS policy entries for a QoS policy ID to another QoS policy ID.

The copy command is a configuration level maintenance tool used to create new policies using existing policies. It also allows bulk modifications to an existing policy with the use of the overwrite keyword.

This command displays access egress QoS policy information.