Broadband Network Gateway Command Reference for Cisco ASR 9000 Series Routers

activate

To activate the dynamic template in the class map sub-configuration mode, use the activate command. To deactivate the dynamic template, use the deactivate command.

activate dynamic-template {name aaa list {list_name | default} | service-from-line}

Syntax Description


dynamic-template	Specifies the actions related to dynamic templates.
`name`	Specifies the name of the dynamic template.
aaa	Specifies the AAA parameters.
list	Specifies the AAA method list that identifies the radius server from which to acquire the service definition.
default	Specifies the default AAA method list.
`list_name`	(Optional) Specifies the name of the AAA method list. If provided, the template is downloaded from radius. If not provided, then the template is expected to be locally configured.
service-from-line	Activates the service encoded in the DHCP Remote-Id parameter.

Command Default

None

Command Modes

Class map sub-configuration

Command History


Release	Modification
Release 4.2.0	This command was introduced.
Release 6.2.1	Modified the command to include service-from-line option.

Usage Guidelines

You must configure decode command to decode (as per the defined AAA attribute format) the service encoded in the DHCP Remote-Id parameter. This particular service is the one referred as service-from-line in this context.

Task ID


Task ID	Operation
qos	read, write

Examples

This is an example of configuring the activate command in the Global Configuration mode:


RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# policy-map type control subscriber PL1
RP/0/RSP0/CPU0:router(config-pmap)# event session-activate match-first
RP/0/RSP0/CPU0:router(config-pmap-e)# class type control subscriber CL2
RP/0/RSP0/CPU0:router(config-pmap-c)# 1 activate dynamic-template DL1 aaa list default

This is an example of activating the service that was encoded in the DHCP Remote-Id parameter:


RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# policy-map type control subscriber PL1
RP/0/RSP0/CPU0:router(config-pmap)# event session-start match-first
RP/0/RSP0/CPU0:router(config-pmap-e)# class type control subscriber CL2 do-until-failure
RP/0/RSP0/CPU0:router(config-pmap-c)# 1 decode remote-id format my-format
RP/0/RSP0/CPU0:router(config-pmap-c)# 2 activate dynamic-template service-from-line
RP/0/RSP0/CPU0:router(config-pmap-c)# 3 authorize aaa list default identifier remote-id password blank

Related Commands


Command	Description
deactivate	Deactivates the dynamic template mode in the class map sub-configuration mode.
decode	Decodes DHCP parameter based on the defined AAA attribute format.

authenticate (BNG)

To authenticate and specify the AAA method list that authentication should be made with in the class map sub-configuration mode, use the authenticate command in the Global Configuration mode. To disable the AAA method list authentication, use the no form of this command.

authenticate aaa list {list_name | default}

Syntax Description


aaa	Specifies the AAA parameters.
list	Specifies AAA method list that authentication should be made with.
default	Specifies the default AAA method list.
`list_name`	Specifies the name of the AAA method list.

Command Default

None

Command Modes

Global Configuration mode

Command History


Release	Modification
Release 4.2.0	This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID


Task ID	Operation
qos	read, write

Examples

This is an example of configuring the authenticate command in the Global Configuration mode:


RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# policy-map type control subscriber PL1
RP/0/RSP0/CPU0:router(config-pmap)# event session-start match-first
RP/0/RSP0/CPU0:router(config-pmap-e)# class type control subscriber CL2
RP/0/RSP0/CPU0:router(config-pmap-c)# 1 authenticate aaa list default

authorize

To authenticate and specify the AAA method list that authorization should be made with in the class map sub-configuration mode, use the authorize command in the Global Configuration mode. To disable the AAA method list authorization, use the no form of this command.

authorize aaa list {list_name | default} { format format_name}|identifier {circuit-id | remote-id | source-address-ipv4 | source-address-mac | username} {password | {use-from-line | password}}

Syntax Description


aaa	Specifies the AAA parameters.
list	Specifies AAA method list that authorization should be made with.
default	Specifies the default AAA method list.
`list_name`	Specifies the name of the AAA method list.
format	Specifies an authorize format name.
`format_name`	Specifies to use format_name, which was defined using CLI 'aaa attribute format'. The result of format is used as user name in authorization request.
password	Specifies a password to be used for AAA request.
use-from-line	Specifies the line from which the password needs to be used.
`password`	Specifies a clear text password.
identifier	Specifies an authorize identifier.
circuit-id	Specifies to use circuit-id as the username in authorize request.
remote-id	Specifies to use remote-id as the username in authorize request. .
source-address-ipv4	Specifies to use source-address-ipv4 as the username in authorize request.
source-address-mac	Specifies to use source-address-mac as the username in authorize request.
username	Specifies an authorize username.

Command Default

None

Command Modes

Global Configuration mode

Command History


Release	Modification
Release 4.2.0	This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID


Task ID	Operation
qos	read, write

Examples

This is an example of configuring the authorize command in the Global Configuration mode:


RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# policy-map type control subscriber PL1
RP/0/RSP0/CPU0:router(config-pmap)# event session-start match-first
RP/0/RSP0/CPU0:router(config-pmap-e)# class type control subscriber CL2
RP/0/RSP0/CPU0:router(config-pmap-c)# 1 authorize aaa list default password DdjkkWE

class-map type control subscriber

To determine the list of actions to be executed for the class and to enter the class-map configuration mode, use the class-map type control subscriber command in Global Configuration mode. To disable the class map type control subscriber and exit the class-map configuration mode, use the no form of this command.

class-map type control subscriber{match-all|match-any}class-map name

Syntax Description


`class-map name`	Specifies the class map name.
match-all	Configures the match all criteria for this class.
match-any	Configures the match any criteria for this class.

Command Default

None

Command Modes

Global Configuration mode

Command History


Release	Modification
Release 4.2.0	This command was introduced.

Usage Guidelines

Use the class-map type control subscriber command to enter class-map configuration mode.

From Cisco IOS XR Software Release 5.2.2 and later, you can edit the class associated with the subscriber policy even while the sessions are active. Prior to this, new class map actions were not editable if the sessions were up, and any such dynamic policy-map changes resulted in clearing off the subscriber sessions.

Task ID


Task ID	Operation
qos	read, write

Examples

This is an example of configuring the class-map type control subscriber command in Global Configuration mode:


RP/0/RSP0/CPU0:router(config)# class-map type control subscriber match-any class1
RP/0/RSP0/CPU0:router(config-cmap)# match protocol ppp
RP/0/RSP0/CPU0:router(config-cmap)# end-class-map

Related Commands


Command	Description
policy-map type control subscriber	Enables the policy-map.
event	Enables the event in a policy-map.

deactivate

To deactivate the dynamic template mode, use the deactivate command in the class map sub-configuration mode. To disable this feature, use the no form of this command.

deactivate dynamic-template {name aaa list {list_name | default} | service-from-line}

Syntax Description


dynamic-template	Specifies the actions related to dynamic templates.
`name`	Specifies the name of the dynamic template.
aaa	Specifies the AAA parameters.
list	Specifies AAA method list that authentication should be made with.
default	Specifies the default AAA method list.
`list_name`	Specifies the name of the AAA method list.
service-from-line	Deactivates the service encoded in the DHCP Remote-Id parameter.

Command Default

None

Command Modes

Global Configuration mode

Command History


Release	Modification
Release 4.2.0	This command was introduced.
Release 6.2.1	Modified the command to include service-from-line option.

Usage Guidelines

You must configure decode command to decode (as per the defined AAA attribute format) the service encoded in the DHCP Remote-Id parameter. This particular service is the one referred as service-from-line in this context.

Task ID


Task ID	Operation
qos	read, write

Examples

This is an example of configuring the deactivate command in the class map sub-configuration mode:


RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# policy-map type control subscriber PL1
RP/0/RSP0/CPU0:router(config-pmap)# event session-start match-first
RP/0/RSP0/CPU0:router(config-pmap-e)# class type control subscriber CL2
RP/0/RSP0/CPU0:router(config-pmap-c)# 1 deactivate dynamic-template DL1 aaa list default

This is an example of deactivating an old service and activating the new service that was encoded in the DHCP Remote-id parameter:


RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# policy-map type control subscriber PL1
RP/0/RSP0/CPU0:router(config-pmap)# event session-identity-change match-first
RP/0/RSP0/CPU0:router(config-pmap-e)# class type control subscriber CL2 do-until-failure
RP/0/RSP0/CPU0:router(config-pmap-c)# 1 decode remote-id format my-format
RP/0/RSP0/CPU0:router(config-pmap-c)# 2 deactivate dynamic-template service-from-line
RP/0/RSP0/CPU0:router(config-pmap-c)# 3 activate dynamic-template service-from-line
RP/0/RSP0/CPU0:router(config-pmap-c)# 4 authorize aaa list default identifier remote-id password blank

Related Commands


Command	Description
activate	Activates the dynamic template mode in the class map sub-configuration mode.
decode	Decodes DHCP Remote-Id parameter based on the defined AAA attribute format.

decode

To decode the DHCP parameter based on the defined AAA attribute format, use the decode command in policy-map event class configuration mode. To disable this feature, use the no form of this command.

decode identity format format-name

Syntax Description

identity

Specifies the DHCP parameter to be decoded.

Note

Currently, only Remote-Id or Circuit-Id parameter is supported for decoding.

format format-name

Specifies the AAA attribute format based on the which the DHCP parameter is to be decoded.

Command Default

None

Command Modes

Policy-map event class configuration

Command History


Release	Modification
Release 6.2.1	This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID


Task ID	Operation
qos	read, write

Examples

This example shows how to decode the DHCP Remote-Id parameter based on the defined AAA attribute format:


RP/0/RSP0/CPU0:router#configure
RP/0/RSP0/CPU0:router(config)#aaa attribute format my-format format-string length 253 "%[^|]|%[^|]|" username service-name
RP/0/RSP0/CPU0:router(config)#policy-map type control subscriber S1
RP/0/RSP0/CPU0:router(config-pmap)#event session-start match-first
RP/0/RSP0/CPU0:router(config-pmap-e)#class type control subscriber CL1 do-until-failure
RP/0/RSP0/CPU0:router(config-pmap-c)#1 decode remote-id format my-format
RP/0/RSP0/CPU0:router(config-pmap-c)#2 activate dynamic-template service-from-line
RP/0/RSP0/CPU0:router(config-pmap-c)#3 authorize aaa list default identifier remote-id password blank

event

To configure a policy event, use the event command in policy-map configuration mode. To disable an event and exit the policy-map configuration mode, use the no form of this command.

event{ account-logoff | account-logon | authenticate-dhcp-renew | authentication-failure | authentication-no-response | authorization-failure | authorization-no-response | exception [ match-all | match-first] | idle-timeout | service-start | service-stop | session-activate | session-identity-change | session-start | session-stop | timer-expiry }

Syntax Description


account-logoff	Specifies an account logoff event.
account-logon	Specifies an account logon event.
authenticate-dhcp-renew	Specifies the session renewal event.
authentication-failure	Specifies an authentication failure event.
authentication-no-response	Specifies an authentication no response event.
authorization-failure	Specifies an authorization failure event.
authorization-no-response	Specifies an authorization no response event.
exception	Specifies a service rollback failure event due to a multi-action CoA (MA - CoA) request failure.
idle-timeout	Specifies an idle timeout event.
service-start	Specifies a service start event.
service-stop	Specifies a service stop event.
session-activate	Specifies session activate event.
session-identity-change	Specifies an identity change event.
session-start	Specifies session start event.
session-stop	Specifies session start event.
timer-expiry	Specifies the timer expiry event.

Command Default

None

Command Modes

Policy-map configuration

Command History


Release	Modification
Release 4.2.0	This command was introduced.
Release 5.1	The idle-timeout event was added.
Release 5.2.0	The exception event was added for service rollback failure due to multi-action CoA request failure.
Release 6.2.1	The command was modified to include session-identity-change event, for controlling subscriber plans using protocol options.
Release 6.4.1	The command was modified to include authenticate-dhcp-renew event, that enables AAA authorization feature at the time of session lease renewal.

Usage Guidelines

Use the policy-map type control subscriber command to enter policy-map configuration mode.

For idle-timeout event, you can configure the policy action as monitor under the idle timeout event for a subscriber policy, to prevent the termination of the session.

The exception event with the action as disconnect , specifies that the subscriber sessions be removed when a service rollback fails due to a multi-action Coa (MA-CoA) request failure. The default action is to retain the session.

For more details on authenticate-dhcp-renew event, see the Establishing Subscriber Sessions chapter in the Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Configuration Guide.

Task ID


Task ID	Operation
qos	read, write

Examples

This example shows how to configure the event command in policy configuration mode:


RP/0/RSP0/CPU0:router(config)# policy-map type control subscriber pol1
RP/0/RSP0/CPU0:router(config-pmap)# event session-start match-first
RP/0/RSP0/CPU0:router(config-pmap-e)# class type control subscriber ip_dhcp do-until-failure
RP/0/RSP0/CPU0:router(config-cmap-c)# 1 activate dynamic-template ip_temp
RP/0/RSP0/CPU0:router(config-cmap-c)# 10 authorize aaa list default identifier format dhcp_id_format password xya
RP/0/RSP0/CPU0:router(config-cmap-c)# end-policy-map

This example shows how to configure the idle-timeout event in policy configuration mode, with the action as monitor for the subscriber policy:


RP/0/RSP0/CPU0:router(config)# policy-map type control subscriber pol1
RP/0/RSP0/CPU0:router(config-pmap)# event idle-timeout
RP/0/RSP0/CPU0:router(config-pmap-e)# class type control subscriber ip_dhcp
RP/0/RSP0/CPU0:router(config-cmap-c)# 1 monitor

This example shows how to configure the exception event in policy configuration mode, with the action as disconnect :


RP/0/RSP0/CPU0:router(config)# policy-map type control subscriber PL1
RP/0/RSP0/CPU0:router(config-pmap)# event exception match-first
RP/0/RSP0/CPU0:router(config-pmap-e)# class type control subscriber coa-rollback-failure do-all
RP/0/RSP0/CPU0:router(config-cmap-c)# 10 disconnect

This example shows how to handle identity change of DHCP Remote-id parameter, to enable modification of subscriber service. For more details, refer the section on controlling subscriber plans using protocol options, in Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Configuration Guide.


RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# policy-map type control subscriber PL1
RP/0/RSP0/CPU0:router(config-pmap)# event session-identity-change match-first
RP/0/RSP0/CPU0:router(config-pmap-e)# class type control subscriber CL2 do-until-failure
RP/0/RSP0/CPU0:router(config-pmap-c)# 1 decode remote-id format my-format
RP/0/RSP0/CPU0:router(config-pmap-c)# 2 deactivate dynamic-template service-from-line
RP/0/RSP0/CPU0:router(config-pmap-c)# 3 activate dynamic-template service-from-line
RP/0/RSP0/CPU0:router(config-pmap-c)# 4 authorize aaa list default identifier remote-id password blank

This example shows how to enable AAA authorization on DHCP RENEW or REBIND:


RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# policy-map type control subscriber dhcpv4_policy
RP/0/RSP0/CPU0:router(config-pmap)# event authenticate-dhcp-renew match-all
RP/0/RSP0/CPU0:router(config-pmap-e)# 1 authorize aaa list default format username password example
RP/0/RSP0/CPU0:router(config-pmap-e)# commit

RP/0/RSP0/CPU0:router(config-)# subscriber featurette dhcp-renew-author
RP/0/RSP0/CPU0:router(config-pmap-c)# commit

Related Commands


Command	Description
class-map type control subscriber	Enables the class-map.
policy-map type control subscriber	Enables the policy-map.

match (class-map)

To configure match criteria for the corresponding class, use the match command in class-map configuration mode. To disable the match feature and exit the policy-map configuration mode, use the no form of this command.

match {authen-status {authenticated | unathenticated} | domain {domain_name | regexp string} format format_name | not | protocol {dhcpv4 | dhcpv6} | service-name {service-name | regexp string} | source-address {ipv4 | mac} | timer {string | regexp string} | username {string | regexp string}}

Syntax Description


authen-status	Specified the authentication status.
authenticated	Specified the authenticated status.
unauthenticated	Specified the unauthenticated status.
domain	Specifies the domain type.
`domain_name`	Specifies the name of the domain.
format	Specifies the format type.
`format_name`	Specifies the name of the format.
regexp	Specifies the regular expression.
`string`	Specifies the regular expression of a string.
not	Negates the match criteria.
protocol	Specifies the protocol type.
service-name	Specifies the service name.
`service-name`	Service name as a string.
source-address	Specifies the source address.
timer	Specifies the timer.
username	Specifies the name of the user.

Command Default

None

Command Modes

Class-map configuration mode

Command History


Release	Modification
Release 4.2.0	This command was introduced.
Release 5.2.2	The command was modified to add new keyword, service-name .

Usage Guidelines

Use the class-map type control subscriber command to enter class-map configuration mode.

These are the usage guidelines for match service-name :

It works only for service activations through CoA. For services defined in dynamic-template and activated by action in policy-maps, the service-activate event is not enabled, and a class map with match service-name is not useful in that case.
It does not work in multi-action CoA (MA-CoA) where multiple services are enabled by a single CoA request.
The order of configuration must be such that, the match service-name is configured in a class-map and then the class-map is linked in the policy-map. The class-map must ideally be placed to match during a service-start or service-stop event, where the service being started or stopped matches to the service names configured in the class-map. With other events, the class-map with match service-name is irrelevant.

Task ID


Task ID	Operation
qos	read, write

Examples

This is an example of configuring the class-map type control subscriber command in the class-map configuration mode:


RP/0/RSP0/CPU0:router(config)# class-map type control subscriber CL1
RP/0/RSP0/CPU0:router(config-pmap)# match authen-status authenticated
RP/0/RSP0/CPU0:router(config-pmap-e)# match domain d1 format f1
RP/0/RSP0/CPU0:router(config-cmap-c)# match protocol ppp
RP/0/RSP0/CPU0:router(config-cmap-c)# match source-address ipv4 1.3.4.5 12.334.55.2
RP/0/RSP0/CPU0:router(config-cmap-c)# match timer time1

This is an example of configuring the service-name matching in the class-map (type subscriber) configuration mode:


RP/0/RSP0/CPU0:router(config)# class-map type control subscriber match-any match-svc
RP/0/RSP0/CPU0:router(config-cmap)# match service-name idle-to
RP/0/RSP0/CPU0:router(config-cmap)# match service-name regexp id*
RP/0/RSP0/CPU0:router(config-cmap)# match service-name regexp .*

match option (DHCPv6)

To enable DHCP option 16 filtering feature in BNG, use the match option enterprise-id or match option vendor-class or both commands in DHCP IPv6 server profile configuration mode. To disable this feature, use the no form of this command.

match option enterprise-id {default | hex hex-string} action {allow | drop}

match option enterprise-id {default | string string-value} action {allow | drop}

Syntax Description


default	Defines a default behavior for incoming DHCP SOLICIT packets.
hex `hex-string`	Specifies the hexadecimal pattern of enterprise-ID in the DHCP option 16 to be matched.
string `string-value`	Specifies the string value of vendor-class data in the DHCP option 16 to be matched.
action	Specifies the action to be performed on DHCP SOLICIT packets.
allow	Allows the DHCP SOLICIT packets based on the DHCP option 16 information.
drop	Drops the DHCP SOLICIT packets based on the DHCP option 16 information.

Command Default

None

Command Modes

DHCP IPv6 server profile configuration

Command History


Release	Modification
Release 6.4.1	This command was introduced.

Usage Guidelines

These configurations are invalid and are not supported:


match vendor-class-data default action drop
match enterprise-ID default action allow


match vendor-class-data default action allow
match enterprise-ID default action drop


match vendor-class-data default action drop


match enterprise-ID default action drop

Task ID


Task ID	Operation
ip-services	read, write

Examples

This example shows how to enable DHCPv6 option 16 filtering feature in BNG. In this example, the BNG router drops all the DHCP SOLICIT packets by default, except the ones that are explicitly configured to be allowed.


RP/0/RSP0/CPU0:router(configure)# dhcp ipv6
RP/0/RSP0/CPU0:router(config-dhcpv6)# profile server_profile server
RP/0/RSP0/CPU0:router(config-dhcpv6-server-profile)# match vendor-class-data string "ABC*" action allow
RP/0/RSP0/CPU0:router(config-dhcpv6-server-profile)# match enterprise-ID hex FFF action allow
RP/0/RSP0/CPU0:router(config-dhcpv6-server-profile)# match vendor-class-data default action drop
RP/0/RSP0/CPU0:router(config-dhcpv6-server-profile)# match enterprise-ID default  action drop

Related Commands

Command	Description
duid allowed-type	Specifies the permitted DUID type for the incoming DHCP SOLICIT packets, as part of enabling DHCP option 16 filtering feature in BNG.

policy-map type control subscriber

To determine the list of events that are applicable to the subscriber lifecycle and to enter the policy-map configuration mode, use the policy-map type control subscriber command in Global Configuration mode. To disable the policy map type control subscriber and exit the policy-map configuration mode, use the no form of this command.

policy-map type control subscriber policy-map name

Syntax Description


`policy-map name`	Represents the policy map name.

Command Default

None

Command Modes

Global Configuration mode

Command History


Release	Modification
Release 4.2.0	This command was introduced.

Usage Guidelines

From Cisco IOS XR Software Release 5.2.2 and later, you can edit the class associated with the subscriber policy even while the sessions are active. Prior to this, new class map actions were not editable if the sessions were up, and any such dynamic policy-map changes resulted in clearing off the subscriber sessions.

Task ID


Task ID	Operation
qos	read, write

Examples

This is an example of configuring the policy-map type control subscriber command in the Global Configuration mode:


RP/0/RSP0/CPU0:router(config)# policy-map type control subscriber pol1
RP/0/RSP0/CPU0:router(config-cmap-c)# end-policy-map

Related Commands


Command	Description
class-map type control subscriber	Enables the class-map.
event	Enables the event in the policy-map.

policy-map type pbr

To create or modify a policy map of type policy based routing that can be attached to one or more interfaces, use the policy-map type pbr command in Global Configuration mode. To disable this feature, use the no form of this command.

policy-map type pbr name

Syntax Description


`policy-map name`	Represents the policy map name.

Command Default

None

Command Modes

Global Configuration mode

Command History


Release	Modification
Release 4.3.0	This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID


Task ID	Operation
qos	read, write

Examples

This is an example of configuring the policy-map type pbr command in the Global Configuration mode:


RP/0/RSP0/CPU0:router(config)# policy-map type pbr pbr_policy
RP/0/RSP0/CPU0:router(config-pmap)# end-policy-map

Related Commands


Command	Description
class-map type control subscriber	Enables the class-map.
event	Enables the event in the policy-map.

service-policy type control subscriber

To associate a subscriber control service policy to the interface, use the service-policy type control subscriber command in interface configuration mode. To disable the service-policy type control subscriber, use the no form of this command.

service-policy type control subscriber name

Syntax Description


`name`	Represents the policy map name.

Command Default

None

Command Modes

Interface configuration mode

Command History


Release	Modification
Release 4.2.0	This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID


Task ID	Operation
config-services	read, write

Examples

This is an example of configuring the service-policy type control subscriber command in interface configuration mode:


RP/0/RSP0/CPU0:router(config)# interface Bundle-Ether 344
RP/0/RSP0/CPU0:router(config-if)# service-policy type control subscriber sub1

Related Commands


Command	Description
class-map type control subscriber	Enables the class-map.
event	Enables the event in the policy-map.

show class-map

To show the class-map related information, use the show class-map command in the EXEC mode.

show class-map type control subscriber name

Syntax Description


type	Displays the type of classmap.
control	Displays all the control class maps.
subscriber	Displays all the subscriber control class maps.
`name`	Displays the class map name.

Command Default

None

Command Modes

EXEC mode

Command History


Release	Modification
Release 4.2.0	This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID


Task ID	Operation
qos	read

Examples

This is a sample output of the show class-map command in the EXEC mode:


RP/0/RSP0/CPU0:router# show class-map type control subscriber PTA_CLASS

The show class-map output is as follows:


Wed Jan 23 08:55:15.027 GMT
1) ClassMap: PTA_CLASS    Type: subscriber_control
    Referenced by 1 Policymaps

This table describes the significant fields shown in the display.

Table 1. show class-map Field Descriptions
Field	Description
ClassMap	Specifies the class map name.
Type	Specifies the type of the class map.

Related Commands


Command	Description
class-map type control subscriber	Determines the list of actions to be executed for the class and enters the class-map configuration mode.

show policy-map

To show the policy-map related information, use the show policy-map command in the EXEC mode.

show policy-map type control subscriber pmap-name name

Syntax Description


type	Displays the type of policy-map.
control	Displays the control type policy-map.
subscriber	Displays the subscriber control type policy-map.
pmap_name	Specifies the policy-map name.
`name`	Displays the policy map name.

Command Default

None

Command Modes

EXEC mode

Command History


Release	Modification
Release 4.2.0	This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID


Task ID	Operation
qos	read

Examples

This is a sample output of the show policy-map command in the EXEC mode:


RP/0/RSP0/CPU0:router# show policy-map control subscriber pmap-name POLICY1

The show policy-map output is as follows:


Wed Jan 23 08:56:13.794 GMT
policy-map type control subscriber POLICY1
 event session-start match-all
  class type control subscriber PTA_CLASS do-all
   1 activate dynamic-template PPP_PTA_TEMPLATE
  !
 !
 end-policy-map
!

This table describes the significant fields shown in the display.

Table 2. show policy-map Field Descriptions
Field	Description
policy-map	Specifies the policy map name.
Type	Specifies the type of the class type control subscriber.

Related Commands


Command	Description
policy-map type control subscriber	Determines the list of events that are applicable to the subscriber lifecycle and to enter the policy-map configuration mode.

Bias-Free Language

Results

Chapter: Control Policy Commands

Control Policy Commands

activate

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Task ID

Examples

Related Commands

authenticate (BNG)

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Task ID

Examples

authorize

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Task ID

Examples

class-map type control subscriber

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Task ID

Examples

Related Commands

deactivate

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Task ID

Examples

Related Commands

decode

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Task ID

Examples

event

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Task ID

Examples

Related Commands

match (class-map)

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Task ID

Examples

match option (DHCPv6)

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Task ID