MC-MLPPP SAP Egress QoS Policy Commands

mc-mlppp

Syntax

mc-mlppp

Context

config>qos

Description

This command enables the context to configure MC-MLPPP SAP egress QoS commands.

sap-egress

Syntax

[no] sap-egress policy-id [create]

Context

config>qos>mc-mlppp

Description

This command is used to create or edit an MC-MLPPP SAP egress QoS policy. The egress policy defines the Service Level Agreement (SLA) for service packets as they egress on the SAP.

Policies are templates that can be applied to multiple services as long as the scope of the policy is template. The queues defined in the policy are not instantiated until a policy is applied to a service. At egress, the forwarding class and in- or out-of-profile determination is done at the original service ingress SAP. MC-MLPPP egress SAP QoS policies allow the definition of queues and the mapping of forwarding classes to those queues. Each queue must have a PIR defined that forces a hard limit on the packets transmitted through the queue.

The sap-egress policy with policy-id 1 is the default sap-egress QoS policy and is applied to MC-MLPPP egress SAPs when an explicit policy is not specified or is removed.

The default settings for sap-egress policy-id 1 define a single queue with PIR set to the maximum value. The single queue is the default queue and all forwarding classes will map to it. Any changes made to an existing policy, using any of the sub-commands, will be applied immediately to all egress SAPs where this policy is applied. For this reason, when many changes are required on a policy, it is highly recommended that the policy be copied to a work area policy-id. That work-in-progress policy can be modified until complete and then written over the original policy-id. Use the config qos copy command to maintain policies in this manner.

The no form of this command deletes the sap-egress policy. A policy cannot be deleted until it is removed from all service SAPs where it is applied. When a sap-egress policy is removed from a SAP, the SAP will revert to the default sap-egress policy-id 1, which cannot be deleted.

Parameters

policy-id

uniquely identifies the policy. The policy-name cannot be used to create the policy, but it can be used to reference a policy that already exists.

Values

1 to 65535, or policy-name (up to 64 characters)

Default

n/a

create

keyword used to create an MC-MLPPP SAP egress QoS policy

fc

Syntax

[no] fc fc-name [create]

Context

config>qos>mc-mlppp>sap-egress

Description

The fc fc-name mode within the MC-MLPPP SAP egress QoS policy is used to contain the explicitly defined queue mapping for fc-name.

The no form of the command removes the explicit queue mapping for fc-name. The queue mapping reverts to the default queue for fc-name.

Default

n/a

Parameters

fc-name

specifies that the forwarding class queue mapping is to be edited. The value given for fc-name must be one of the predefined forwarding classes in the system.

Values

be, l2, af, l1, h2, ef, h1, nc

create

keyword used to create the context to configure an MC-MLPPP SAP egress forwarding class mapping queue

policy-name

Syntax

policy-name policy-name

no policy-name

Context

config>qos>mc-mlppp>sap-egress

Description

This command configures a policy name for the MC-MLPPP SAP egress policy.

Parameters

policy-name

specifies the name for the policy, up to 64 characters

queue

Syntax

[no] queue queue-id [create]

Context

config>qos>mc-mlppp>sap-egress

Description

This command enables the context to configure an MC-MLPPP SAP egress policy queue. Explicit definition of an egress queue’s hardware scheduler status is supported. A single egress queue allows support for multiple forwarding classes.

The no form of the command removes the queue-id from the MC-MLPPP SAP egress policy. Removing the queue-id also removes it from any existing SAPs using the policy. If any forwarding classes are mapped to the queue, they revert to the default queue.

When a queue is removed, pending accounting information for each SAP egress queue created due to the definition of the queue in the policy is discarded.

Default

n/a

Parameters

queue-id

the queue-id for the MC-MLPPP SAP egress queue, expressed as a decimal integer. The queue-id uniquely identifies the queue within the policy.

Values

1 to 8

create

keyword used to create the context to configure an MC-MLPPP SAP egress policy queue

scope

Syntax

scope {exclusive | template}

no scope

Context

config>qos>mc-mlppp>sap-egress

Description

This command is used to enter the scope of the policy. The scope of the policy cannot be changed if the policy is applied to one or more services.

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

Default

template

Parameters

exclusive

when the scope of a policy is defined as exclusive, the policy can only be applied to a single SAP. Attempting to assign the policy to a second SAP will result in an error message. If the policy is removed from the exclusive SAP, it will become available for assignment to another exclusive SAP.

template

when the scope of a policy is defined as template, the policy can be applied to multiple SAPs