P Commands

packet latency threshold

To configure the latency threshold value on an interface, use the packet latency threshold command. To remove the threshold value, use the no form of this command.

packet latency threshold threshold-value

no packet latency threshold

Syntax Description

threshold-value

Module number. The range is from 8 to 536870904 nano seconds.

Command Default

None

Command Default

Interface configuration (config-if)

Command History

Release

Modification

7.0(0)N1(1)

This command was introduced.

Usage Guidelines

This command does not require a license.

You apply this command to egress interfaces where SPAN-on-Latency functionality is needed. When latency on the egress interface exceeds the configured threshold, packets are spanned on the interface configured as the destination port for the SPAN-on-Latency session. Only one SPAN-on-Latency session is supported at a time.

Examples

This example shows how to set the latency threshold value to 530000000 nano seconds: 


switch(config)# interface ethernet 1/1
switch(config-if)# packet latency threshold 530000000

Related Commands

Command

Description

monitor session

Creates a SPAN or an ERSPAN session.

periodic-inventory (Call Home)

To configure the switch to periodically send a message with an inventory of all software services currently enabled and running on the device with hardware inventory information, use the periodic-inventory command. To disable the periodic messages, use the no form of this command.

periodic-inventory notification [interval time-period | timeofday time-of-day]

no periodic-inventory notification [interval time-period | timeofday time-of-day]

Syntax Description

notification

Enables sending periodic software inventory messages.

interval time-period

(Optional) Specifies the time period for periodic inventory notification. The time period range is from 1 to 30 days, and the default is 7 days.

timeofday time-of-day

(Optional) Specifies the time of day for periodic inventory notification. The time of day is in HH:MM format.

Command Default

Interval: 7 days

Command Modes

Callhome configuration mode

Command History

Release

Modification

This command was introduced.

Usage Guidelines

The switch generates two Call Home notifications: periodic configuration messages and periodic inventory messages.

Examples

This example shows how to configure a periodic inventory notification to generate every 5 days: 


switch(config-callhome)# periodic-inventory notification interval 5 
switch(config-callhome)#

This example shows how to disable a periodic inventory notification for Call Home: 


switch(config-callhome)# no periodic-inventory notification interval 5 
switch(config-callhome)#

Related Commands

Command

Description

copy running-config startup-config

Saves this configuration change.

show callhome

Displays Call Home configuration information.

show running-config callhome

Displays the running configuration information for Call Home.

phone-contact (Call Home)

To configure the phone number for the primary person responsible for the device, use the phone-contact command. To remove a phone contact, use the no form of this command.

phone-contact phone-no

no phone-contact

Syntax Description

phone-no

Phone number in international phone number format, such as +1-800-123-4567. The phone number can be a maximum of 17 alphanumeric characters and cannot contain spaces.

Note 
You must use the + prefix before the number.

Command Default

None

Command Modes

Callhome configuration mode

Command History

Release

Modification

This command was introduced.

Examples

This example shows how to configure a phone number for the primary person responsible for the device: 


switch(config-callhome)# phone-contact +1-800-123-4567
 
switch(config-callhome)#

Related Commands

Command

Description

copy running-config startup-config

Saves this configuration change.

show callhome

Displays a summary of the Call Home configuration.

streetaddress

Configures the street address for the primary person responsible for the switch.

poweroff module

To power off a module, use the poweroff module command. To return power to the module, use the no form of this command.

poweroff module module

no poweroff module module

Syntax Description

module

Module number. The range is from 1 to 18.

Command Default

None

Command Default

Global configuration (config)

Command History

Release

Modification

6.0(2)N1(1)

This command was introduced.

Usage Guidelines

This command does not require a license.

Examples

This example shows how to power off module 2: 


switch# poweroff module 2

Related Commands

Command

Description

show module

Displays information about modules.

ptp announce

To configure the interval between PTP announcement messages on an interface or the number of PTP intervals before a timeout occurs on an interface, use the ptp announce command. To disable this feature, use the no form of this command.

ptp announce {interval log-seconds | timeout count}

no ptp announce

Syntax Description

interval log-seconds

The number of log seconds between PTP announcement messages. The range is from 0 to 4 seconds.

timeout count

The number of PTP intervals before a timeout occurs on the interface. The range is from 2 to 10.

Command Default

The default interval is 1 log second.

The default timeout is 3 announce intervals.

Command Modes

Interfaces configuration mode

Command History

Release

Modification

6.0(2)N1(1)

This command was introduced.

Examples

This example shows how to set the announcement interval on interface 5/1 to 1: 


switch# configure terminal
switch(config) # interface ethernet
 5/1
switch(config-if)# ptp announce interval 1
switch(config-if)

Related Commands

Command

Description

feature ptp

Enables or disables PTP on the device.

ptp delay request minimum interval

Configures the minimum interval allowed between PTP delay-request messages when the port is in the master state.

ptp sync interval

Configures the interval between PTP synchronization messages on an interface.

ptp vlan

Configures the VLAN for the interface where PTP is being enabled.

show ptp brief

Displays the PTP status.

show ptp port interface ethernet

Displays the status of the PTP port on the switch.

ptp delay request minimum interval

To configure the minimum interval allowed between PTP delay request messages when the port is in the master state, use the ptp delay request minimum interval command. To disable this feature, use the no form of this command.

ptp delay request minimum interval log-seconds

no ptp delay request minimum interval

Syntax Description

log-seconds

The number of log seconds between PTP delay request messages. The range is from -1 to 6 seconds.

Command Default

0 log seconds

Command Modes

Interface configuration mode

Command History

Release

Modification

6.0(2)N1(1)

This command was introduced.

Examples

This example shows how to set the minimum delay request interval to 3: 


switch# configure terminal
switch(config) # interface ethernet 5/1
switch(config-if) # ptp delay request minimum interval 3

Related Commands

Command

Description

feature ptp

Enables or disables PTP on the device.

ptp announce

Configures the interval between PTP announce messages on an interface or the number of PTP intervals before a timeout occurs on an interface.

ptp sync interval

Configures the interval between PTP synchronization messages on an interface.

ptp vlan

Configures the VLAN for the interface where PTP is being enabled.

show ptp brief

Displays the PTP status.

show ptp port interface ethernet

Displays the status of the PTP port on the switch.

ptp domain

To configure the domain number to use for this clock, use the ptp domain command. PTP domains allow you choose multiple independent PTP clocking subdomains on a single network.

ptp domain number

no ptp domain number

Syntax Description

number

Configures the domain number to use for this clock. The range is from 0 to 128.

Command Default

0

Command Modes

Global configuration mode

Command History

Release

Modification

6.0(2)N1(1)

This command was introduced.

Examples

This example shows how to configure the domain number for use with a clock: 


switch(config)# ptp domain 1

Related Commands

Command

Description

feature ptp

Enables or disables PTP on the device.

ptp source

Configures the source IP address for all PTP packets.

ptp priority1

Configures the priority 1 value to use when advertising this clock.

ptp priority2

Configures the priority 1 value to use when advertising this clock.

show ptp brief

Displays the PTP status.

show ptp clock

Displays the properties of the local clock.

ptp priority1

To configure the priority1 value to use when advertising this clock, use the ptp priority1 command.

ptp priority1 value

no ptp priority1 value

Syntax Description

value

The configured value overrides the default criteria (clock quality, clock class, etc.) for best master clock selection. Lower values take precedence. The range is from 0 to 255.

Command Default

255 when advertising the clock

Command Modes

Global configuration mode

Command History

Release

Modification

6.0(2)N1(1)

This command was introduced.

Examples

This example shows how to set the priority1 value used to advertise this clock: 


switch(config)# ptp priority1 10

Related Commands

Command

Description

feature ptp

Enables or disables PTP on the device.

ptp source

Configures the source IP address for all PTP packets.

ptp domain

Configures the domain number to use for this clock.

ptp priority2

Configures the priority2 value to use when advertising this clock.

show ptp brief

Displays the PTP status.

show ptp clock

Displays the properties of the local clock.

ptp priority2

To configure the priority2 value to use when advertising this clock, use the ptp priority2 command.

ptp priority2 value

no ptp priority2 value

Syntax Description

value

The configured value is used to decide between two devices that are otherwise equally matched in the default criteria. For example, you can use the priority2 value to give a specific switch priority over other identical switches. The range is from 0 to 255.

Command Default

255 when advertising the clock

Command Modes

Global configuration mode

Command History

Release

Modification

6.0(2)N1(1)

This command was introduced.

Examples

This example shows how to set the priority2 value used to advertise this clock: 


switch(config)# ptp priority2 20

Related Commands

Command

Description

feature ptp

Enables or disables PTP on the device.

ptp source

Configures the source IP address for all PTP packets.

ptp domain

Configures the domain number to use for this clock.

ptp priority1

Configures the priority1 value to use when advertising this clock.

show ptp brief

Displays the PTP status.

show ptp clock

Displays the properties of the local clock.

ptp source

To configure the source IP address for all PTP packets, use the ptp source command. To unconfigure the source IP address for all PTP packets, use the no form of this command.

ptp source ip-address [vrf vrf]

no ptp source ip-address [vrf vrf]

Syntax Description

ip-address

Specifies the source IP address for all PTP packets. The IP address can be in IPv4 or IPv6 format.

vrf vrf

Specifies the VRF.

Command Default

None

Command Modes

Global configuration mode

Command History

Release

Modification

6.0(2)N1(1)

This command was introduced.

Examples

This example shows how to configure the source IP address for all PTP packets: 


switch(config)# ptp source 192.0.2.1

Related Commands

Command

Description

feature ptp

Enables or disables PTP on the device.

ptp domain

Configures the domain number to use for this clock.

ptp priority1

Configures the priority 1 value to use when advertising this clock.

ptp priority2

Configures the priority 1 value to use when advertising this clock.

show ptp brief

Displays the PTP status.

show ptp clock

Displays the properties of the local clock.

ptp sync interval

To configure the interval between PTP synchronization messages, use the ptp sync interval command. To disable this feature, use the no form of this command.

ptp sync interval log-seconds

no ptp sync interval

Syntax Description

log-seconds

The number of log seconds between PTP synchronization messages on an interface. The range is from -3 seconds to 1 second.

Command Default

None

Command Modes

Interface configuration mode

Command History

Release

Modification

6.0(2)N1(1)

This command was introduced.

Examples

This example shows how to set the PTP synchronization interval to -3: 


switch# configure terminal
switch(config) # interface ethernet
 5/1
switch(config-if) # ptp sync interval -3

Related Commands

Command

Description

feature ptp

Enables or disables PTP on the device.

ptp announce

Configures the interval between PTP announce messages on an interface or the number of PTP intervals before a timeout occurs on an interface.

ptp delay request minimum interval

Configures the minimum interval allowed between PTP delay-request messages when the port is in the master state.

ptp vlan

Configures the VLAN for the interface where PTP is being enabled.

show ptp brief

Displays the PTP status.

show ptp port interface ethernet

Displays the status of the PTP port on the switch.

ptp vlan

To specify the VLAN for the interface where PTP is being enabled, use the ptp vlan command. To disable this feature, use the no form of this command.

ptp vlan vlan-id

no ptp vlan

Syntax Description

vlan-id

The VLAN ID for the interface where PTP is being enabled. The range is from 1 to 4094.

Command Default

1

Command Modes

Interface configuration mode

Command History

Release

Modification

6.0(2)N1(1)

This command was introduced.

Usage Guidelines

PTP can only be enabled on one VLAN on an interface.

Examples

This example shows how to specify VLAN 10 as the interface where PTP is being enabled: 


switch# configure terminal
switch(config) # interface ethernet 5/1
switch(config-if) # ptp vlan 10

Related Commands

Command

Description

feature ptp

Enables or disables PTP on the device.

ptp announce

Configures the interval between PTP announce messages on an interface or the number of PTP intervals before a timeout occurs on an interface.

ptp delay request minimum interval

Configures the minimum interval allowed between PTP delay-request messages when the port is in the master state.

ptp sync interval

Configures the interval between PTP synchronization messages on an interface.

show ptp brief

Displays the PTP status.

show ptp port interface ethernet

Displays the status of the PTP port on the switch.