10.3. Command descriptions

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 creates or edits an access-egress QoS policy. The policy can be applied to multiple access ports. The access-egress policy is common to services (SAPs) all configured on that access 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 defines the fc node within the access-egress QoS policy is used to contain the explicitly defined dot1p marking commands for the fc-name.

If 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 the 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 FC 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 de-mark command is configured along with this command, then 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 the 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 the 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, the dot1p [in|out]-profile values are considered. Even if dot1p dot1p-value is configured, it is ignored. If the dot1p [in|out]-profile value is not configured, the default values are considered for that FC. If de-mark is configured and if dot1p dot1p-value is configured then it is considered. Else if the dot1p [in|out]-profile value is configured it is considered. In this case dot1p dot1p-value has the precedence over dot1p [in|out]-profile.

The command enables the context 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 the software to determine the dot1p values to when both the dot1p command and the dot1p-in-profile and dot1p-out-profile command is specified. If de-mark is not configured, the dot1p [in|out]-profile values are considered. Even if dot1p dot1p-value is configured it is ignored. If the dot1p [in|out]-profile value is not configured, the default values are considered for that FC. If de-mark is configured, and if the dot1p 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 dot1p-value has the precedence over dot1p [in|out]-profile. If marking is enabled and both dot1p and dot1-[in|out]-profile commands are not specified, then the value reverts to the default.

The command enables the context 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, the dot1p [in|out]-profile values are considered. Even if dot1p dot1p-value command is configured, it is ignored. If the dot1p [in|out]-profile value is not configured, the default values are considered for that FC. If de-mark is configured and if dot1p 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 dot1p-value, has the precedence over dot1p [in|out]-profile. If marking is enabled and both dot1p dot1p-value and dot1-[in|out]-profile commands are not specified, the value revert to the default.

This command specifies the out-of-profile DSCP name for the FC. 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 FC queue.

When multiple DSCP names are associated with the FC 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 FC. 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 FC queue.

When multiple DSCP names are associated with the FC 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 specifies a queue for which to modify queue parameters.

This command remarks egress packets sent out of access ports and access-uplink ports. For 7210 SAS-D, remarking can be enabled or disabled.

Note: If remarking is enabled without specifying one of the options, by default 'use-dot1p' is used for access-egress and “all” is used for network-egress.

The no form of this command disables remarking, which is the default behavior.

This command defines the method used by the system to derive the operational CIR and PIR settings when the queue is provisioned in hardware. For the CIR and PIR parameters individually, 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 PIR and 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 over subscription 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 any time, altering the PIR and CIR rates for all queues created on the access ports.

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

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 sets the scope of the policy to the default of template.

This command displays access-egress QoS policy information.