saa commands

configure 
   —  saa 
      —  apply-groups reference
      —  apply-groups-exclude reference
      —  owner named-item test named-item 
         —  accounting-policy reference
         —  admin-state keyword
         —  apply-groups reference
         —  apply-groups-exclude reference
         —  continuous boolean
         —  description description
         —  jitter-event keyword threshold-type keyword 
            —  apply-groups reference
            —  apply-groups-exclude reference
            —  threshold number
         —  latency-event keyword threshold-type keyword 
            —  apply-groups reference
            —  apply-groups-exclude reference
            —  threshold number
         —  loss-event keyword threshold-type keyword 
            —  apply-groups reference
            —  apply-groups-exclude reference
            —  threshold number
         —  probe-history keyword
         —  type 
            —  dns 
               —  apply-groups reference
               —  apply-groups-exclude reference
               —  count number
               —  interval number
               —  name-server (ipv4-address-no-zone | ipv6-address-no-zone)
               —  record-type keyword
               —  router-instance string
               —  source-address (ipv4-address-no-zone | ipv6-address-no-zone)
               —  target-address string-not-all-spaces
               —  timeout number
               —  trap-generation 
                  —  probe-fail boolean
                  —  probe-fail-threshold number
                  —  test-complete boolean
                  —  test-fail boolean
                  —  test-fail-threshold number
            —  eth-cfm-loopback 
               —  apply-groups reference
               —  apply-groups-exclude reference
               —  count number
               —  destination (mac-unicast-address-no-zero | number)
               —  interval number
               —  ma-admin-name (named-item-64 | admin-name)
               —  md-admin-name (named-item-64 | admin-name)
               —  mep number
               —  qos 
                  —  fc keyword
                  —  profile keyword
               —  size number
               —  timeout number
               —  trap-generation 
                  —  probe-fail boolean
                  —  probe-fail-threshold number
                  —  test-complete boolean
                  —  test-fail boolean
                  —  test-fail-threshold number
            —  icmp-ping 
               —  apply-groups reference
               —  apply-groups-exclude reference
               —  bypass-routing boolean
               —  count number
               —  destination-address (ipv4-address-no-zone | ipv6-address-no-zone | string-not-all-spaces)
               —  do-not-fragment boolean
               —  interface interface-name
               —  interval (number | decimal-number)
               —  next-hop-address (ipv4-address-no-zone | ipv6-address-no-zone)
               —  pattern (keyword | number)
               —  qos 
                  —  fc keyword
                  —  tos number
               —  router-instance string
               —  size number
               —  source-address (ipv4-address-no-zone | ipv6-address-no-zone)
               —  timeout number
               —  trap-generation 
                  —  probe-fail boolean
                  —  probe-fail-threshold number
                  —  test-complete boolean
                  —  test-fail boolean
                  —  test-fail-threshold number
               —  ttl number
            —  lsp-ping 
               —  apply-groups reference
               —  apply-groups-exclude reference
               —  interval number
               —  qos 
                  —  fc keyword
                  —  profile keyword
               —  send-count number
               —  size number
               —  source-ip-address (ipv4-address-no-zone | ipv6-address-no-zone)
               —  sub-type 
                  —  bgp-label 
                     —  path-destination 
                        —  interface interface-name
                        —  ip-address (ipv4-address-no-zone | ipv6-address-no-zone)
                        —  next-hop (ipv4-address-no-zone | ipv6-address-no-zone)
                     —  prefix (ipv4-prefix | ipv6-prefix)
                  —  ldp 
                     —  path-destination 
                        —  interface interface-name
                        —  ip-address (ipv4-address-no-zone | ipv6-address-no-zone)
                        —  next-hop (ipv4-address-no-zone | ipv6-address-no-zone)
                     —  prefix (ipv4-prefix | ipv6-prefix)
                  —  rsvp-te 
                     —  lsp-name named-item-64
                     —  path named-item-64
                  —  sr-isis 
                     —  igp-instance number
                     —  path-destination 
                        —  interface interface-name
                        —  ip-address (ipv4-address-no-zone | ipv6-address-no-zone)
                        —  next-hop (ipv4-address-no-zone | ipv6-address-no-zone)
                     —  prefix (ipv4-prefix | ipv6-prefix)
                  —  sr-ospf 
                     —  igp-instance number
                     —  path-destination 
                        —  interface interface-name
                        —  ip-address (ipv4-address-no-zone | ipv6-address-no-zone)
                        —  next-hop (ipv4-address-no-zone | ipv6-address-no-zone)
                     —  prefix (ipv4-prefix | ipv6-prefix)
                  —  sr-ospf3 
                     —  igp-instance number
                     —  path-destination 
                        —  interface interface-name
                        —  ip-address (ipv4-address-no-zone | ipv6-address-no-zone)
                        —  next-hop (ipv4-address-no-zone | ipv6-address-no-zone)
                     —  prefix (ipv4-prefix | ipv6-prefix)
                  —  sr-policy 
                     —  color number
                     —  endpoint (ipv4-address-no-zone | ipv6-address-no-zone)
                     —  path-destination 
                        —  interface interface-name
                        —  ip-address (ipv4-address-no-zone | ipv6-address-no-zone)
                        —  next-hop (ipv4-address-no-zone | ipv6-address-no-zone)
                     —  segment-list number
                  —  sr-te 
                     —  lsp-name named-item-64
                     —  path named-item-64
                     —  path-destination 
                        —  interface interface-name
                        —  ip-address (ipv4-address-no-zone | ipv6-address-no-zone)
                        —  next-hop (ipv4-address-no-zone | ipv6-address-no-zone)
               —  timeout number
               —  trap-generation 
                  —  probe-fail boolean
                  —  probe-fail-threshold number
                  —  test-complete boolean
                  —  test-fail boolean
                  —  test-fail-threshold number
               —  ttl number
            —  sdp-ping 
               —  apply-groups reference
               —  apply-groups-exclude reference
               —  count number
               —  interval number
               —  originating-sdp-identifier number
               —  qos 
                  —  fc keyword
                  —  profile keyword
               —  responder-sdp-identifier number
               —  size number
               —  timeout number
               —  trap-generation 
                  —  probe-fail boolean
                  —  probe-fail-threshold number
                  —  test-complete boolean
                  —  test-fail boolean
                  —  test-fail-threshold number
            —  vccv-ping 
               —  apply-groups reference
               —  apply-groups-exclude reference
               —  count number
               —  interval number
               —  qos 
                  —  fc keyword
                  —  profile keyword
               —  size number
               —  sub-type 
                  —  fec-128 
                     —  pseudowire 
                        —  destination-ip-address ipv4-address
                        —  pw-id number
                        —  source-ip-address ipv4-address
                     —  reply-mode keyword
                     —  sdp-bind-id sdp-bind-id
               —  timeout number
               —  trap-generation 
                  —  probe-fail boolean
                  —  probe-fail-threshold number
                  —  test-complete boolean
                  —  test-fail boolean
                  —  test-fail-threshold number
               —  ttl number

saa command descriptions

saa


	Synopsis	Enter the saa context
	Context	configure saa
	Tree	saa
	Description	Commands in this context configure the Service Assurance Agent (SAA) tests.
	Introduced	16.0.R4
	Platforms	All

owner [owner-name] named-item test named-item


	Synopsis	Enter the owner list instance
	Context	configure saa owner named-item test named-item
	Tree	owner
	Introduced	16.0.R4
	Platforms	All

[owner-name] named-item


	Synopsis	Optional owner name of the SAA operation
	Context	configure saa owner named-item test named-item
	Tree	owner
	Description	This command configures the owner associated with the SAA operation.
	String length	1 to 32
	MD-CLI default	TiMOS CLI
	Notes	This element is part of a list key.
	Introduced	16.0.R4
	Platforms	All

test named-item


	Synopsis	SAA test name
	Context	configure saa owner named-item test named-item
	Tree	owner
	String length	1 to 32
	Notes	This element is part of a list key.
	Introduced	16.0.R4
	Platforms	All

accounting-policy reference


Warning: Modifying this element toggles the admin-state of the parent element automatically for the new value to take effect.
	Synopsis	Accounting policy associated with the SAA test
	Context	configure saa owner named-item test named-item accounting-policy reference
	Tree	accounting-policy
	Reference	configure log accounting-policy number
	Introduced	16.0.R4
	Platforms	All

admin-state keyword


	Synopsis	Administrative state of the SAA test
	Context	configure saa owner named-item test named-item admin-state keyword
	Tree	admin-state
	Options	enable, disable
	Default	disable
	Introduced	16.0.R4
	Platforms	All

continuous boolean


Warning: Modifying this element toggles the admin-state of the parent element automatically for the new value to take effect.
	Synopsis	Execute the SAA tests as continuous
	Context	configure saa owner named-item test named-item continuous boolean
	Tree	continuous
	Description	When configured to true, the SAA test execution is continuous, that is, it cannot be started or stopped with the oam saa test start or stop commands. The SAA test types supported by this command include the following: cpe-ping dns eth-cfm-loopback eth-cfm-two-way-delay eth-cfm-two-way-slm icmp-ping (not applicable to rapid type) lsp-ping mac-ping sdp-ping vccv-ping vprn-ping
	Default	false
	Introduced	16.0.R4
	Platforms	All

description description


	Synopsis	Text description
	Context	configure saa owner named-item test named-item description description
	Tree	description
	String length	1 to 80
	Introduced	16.0.R4
	Platforms	All

jitter-event [direction] keyword threshold-type keyword


	Synopsis	Enter the jitter-event list instance
	Context	configure saa owner named-item test named-item jitter-event keyword threshold-type keyword
	Tree	jitter-event
	Description	Commands in this context configure the jitter event thresholds used to evaluate the jitter event value at the termination of an SAA test probe. The system generates SAA threshold events as required.
	Introduced	16.0.R4
	Platforms	All

[direction] keyword


	Synopsis	Direction for OAM ping responses for OAM ping test run
	Context	configure saa owner named-item test named-item jitter-event keyword threshold-type keyword
	Tree	jitter-event
	Options	inbound, outbound, round-trip
	Notes	This element is part of a list key.
	Introduced	16.0.R4
	Platforms	All

threshold-type keyword


	Synopsis	Threshold type
	Context	configure saa owner named-item test named-item jitter-event keyword threshold-type keyword
	Tree	jitter-event
	Options	rising, falling
	Notes	This element is part of a list key.
	Introduced	16.0.R4
	Platforms	All

threshold number


	Synopsis	Threshold jitter value
	Context	configure saa owner named-item test named-item jitter-event keyword threshold-type keyword threshold number
	Tree	threshold
	Description	This command specifies the threshold jitter value. The system generates an SAA threshold event when the jitter value of the test run crosses the threshold value.
	Range	0 to 2147483647
	Units	microseconds
	Notes	This element is mandatory.
	Introduced	16.0.R4
	Platforms	All

latency-event [direction] keyword threshold-type keyword


	Synopsis	Enter the latency-event list instance
	Context	configure saa owner named-item test named-item latency-event keyword threshold-type keyword
	Tree	latency-event
	Description	Commands in this context configure the latency event thresholds used to evaluate the latency event value at the termination of an SAA test probe. The system generates SAA threshold events as required.
	Introduced	16.0.R4
	Platforms	All

[direction] keyword


	Synopsis	Direction for OAM ping responses for OAM ping test run
	Context	configure saa owner named-item test named-item latency-event keyword threshold-type keyword
	Tree	latency-event
	Options	inbound, outbound, round-trip
	Notes	This element is part of a list key.
	Introduced	16.0.R4
	Platforms	All

threshold-type keyword


	Synopsis	Threshold type
	Context	configure saa owner named-item test named-item latency-event keyword threshold-type keyword
	Tree	latency-event
	Options	rising, falling
	Notes	This element is part of a list key.
	Introduced	16.0.R4
	Platforms	All

threshold number


	Synopsis	Threshold latency value
	Context	configure saa owner named-item test named-item latency-event keyword threshold-type keyword threshold number
	Tree	threshold
	Description	This command specifies the threshold latency value. The system generates an SAA threshold event when the latency value of the test run crosses the threshold value.
	Range	0 to 2147483647
	Units	microseconds
	Notes	This element is mandatory.
	Introduced	16.0.R4
	Platforms	All

loss-event [direction] keyword threshold-type keyword


	Synopsis	Enter the loss-event list instance
	Context	configure saa owner named-item test named-item loss-event keyword threshold-type keyword
	Tree	loss-event
	Description	Commands in this context configure the loss event thresholds used to evaluate the loss event value at the termination of an SAA test probe. The system generates SAA threshold events as required.
	Introduced	16.0.R4
	Platforms	All

[direction] keyword


	Synopsis	Direction for OAM ping responses for OAM ping test run
	Context	configure saa owner named-item test named-item loss-event keyword threshold-type keyword
	Tree	loss-event
	Options	inbound, outbound, round-trip
	Notes	This element is part of a list key.
	Introduced	16.0.R4
	Platforms	All

threshold-type keyword


	Synopsis	Threshold type
	Context	configure saa owner named-item test named-item loss-event keyword threshold-type keyword
	Tree	loss-event
	Options	rising, falling
	Notes	This element is part of a list key.
	Introduced	16.0.R4
	Platforms	All

threshold number


	Synopsis	Threshold loss event value
	Context	configure saa owner named-item test named-item loss-event keyword threshold-type keyword threshold number
	Tree	threshold
	Description	This command specifies the threshold loss value. The system generates an SAA threshold event when the loss value of the test run crosses the threshold value.
	Range	0 to 2147483647
	Units	packets
	Notes	This element is mandatory.
	Introduced	16.0.R4
	Platforms	All

probe-history keyword


Warning: Modifying this element toggles the admin-state of the parent element automatically for the new value to take effect.
	Synopsis	History probe behavior
	Context	configure saa owner named-item test named-item probe-history keyword
	Tree	probe-history
	Options	keep, drop, auto
	Default	auto
	Introduced	16.0.R4
	Platforms	All

type


	Synopsis	Enter the type context
	Context	configure saa owner named-item test named-item type
	Tree	type
	Introduced	16.0.R4
	Platforms	All

dns


	Synopsis	Enable the dns context
	Context	configure saa owner named-item test named-item type dns
	Tree	dns
	Notes	The following elements are part of a choice: dns, eth-cfm-loopback, icmp-ping, lsp-ping, sdp-ping, or vccv-ping.
	Introduced	22.10.R1
	Platforms	All

count number


	Synopsis	Number of messages to send in a sample window
	Context	configure saa owner named-item test named-item type dns count number
	Tree	count
	Description	This command specifies the number of messages to send. Each message request must either time out or receive a reply before the next message request is sent.
	Range	1 to 100
	Units	packets
	Default	1
	Introduced	22.10.R1
	Platforms	All

interval number


	Synopsis	Minimum time before the next message request is sent
	Context	configure saa owner named-item test named-item type dns interval number
	Tree	interval
	Range	1 to 10
	Units	seconds
	Default	1
	Introduced	22.10.R1
	Platforms	All

name-server (ipv4-address-no-zone | ipv6-address-no-zone)


	Synopsis	IP address of the DNS name server used for the test
	Context	configure saa owner named-item test named-item type dns name-server (ipv4-address-no-zone \| ipv6-address-no-zone)
	Tree	name-server
	Notes	This element is mandatory.
	Introduced	22.10.R1
	Platforms	All

record-type keyword


	Synopsis	Record type
	Context	configure saa owner named-item test named-item type dns record-type keyword
	Tree	record-type
	Options	ipv4-a-record, ipv6-aaaa-record
	Default	ipv4-a-record
	Introduced	22.10.R1
	Platforms	All

router-instance string


	Synopsis	Router name or VPRN service name
	Context	configure saa owner named-item test named-item type dns router-instance string
	Tree	router-instance
	Default	_Base_and_management
	Introduced	22.10.R1
	Platforms	All

source-address (ipv4-address-no-zone | ipv6-address-no-zone)


	Synopsis	IP address on the local system
	Context	configure saa owner named-item test named-item type dns source-address (ipv4-address-no-zone \| ipv6-address-no-zone)
	Tree	source-address
	Description	This command configures the IP address on the local system. If unconfigured, the router uses a system selected local IP address.
	Introduced	22.10.R1
	Platforms	All

target-address string-not-all-spaces


	Synopsis	DNS name to be resolved to an IP address
	Context	configure saa owner named-item test named-item type dns target-address string-not-all-spaces
	Tree	target-address
	String length	1 to 255
	Notes	This element is mandatory.
	Introduced	22.10.R1
	Platforms	All

timeout number


	Synopsis	Maximum time to wait for a reply message
	Context	configure saa owner named-item test named-item type dns timeout number
	Tree	timeout
	Description	This command specifies the maximum time the router waits for a message response after sending the message request. When the timeout expires, the requesting router assumes the message response is not received. Any response received after the request times out is silently discarded.
	Range	1 to 120
	Units	seconds
	Default	5
	Introduced	22.10.R1
	Platforms	All

trap-generation


	Synopsis	Enter the trap-generation context
	Context	configure saa owner named-item test named-item type dns trap-generation
	Tree	trap-generation
	Introduced	22.10.R1
	Platforms	All

probe-fail boolean


	Synopsis	Enable the generation of probe fail notifications
	Context	configure saa owner named-item test named-item type dns trap-generation probe-fail boolean
	Tree	probe-fail
	Description	When configured to true, the system generates an SNMP trap if the consecutive probe failure threshold is reached during the execution of the SAA ping test. This command is not applicable to SAA traceroute tests.
	Default	false
	Introduced	22.10.R1
	Platforms	All

probe-fail-threshold number


	Synopsis	Consecutive probe failure count
	Context	configure saa owner named-item test named-item type dns trap-generation probe-fail-threshold number
	Tree	probe-fail-threshold
	Description	This command configures the number of consecutive ping probe failures required to generate a trap. This command has no effect if the probe-fail command is set to false. This command is not applicable to SAA traceroute tests.
	Range	0 to 15
	Default	1
	Introduced	22.10.R1
	Platforms	All

test-complete boolean


	Synopsis	Enable generation of test complete notifications
	Context	configure saa owner named-item test named-item type dns trap-generation test-complete boolean
	Tree	test-complete
	Default	false
	Introduced	22.10.R1
	Platforms	All

test-fail boolean


	Synopsis	Enable the generation of test fail notifications
	Context	configure saa owner named-item test named-item type dns trap-generation test-fail boolean
	Tree	test-fail
	Description	When configured to true, the system generates a trap if a test fails. In the case of a ping test, the test is considered to have failed (for trap generation) if the number of failed probes is at least the value of the test-fail-threshold setting.
	Default	false
	Introduced	22.10.R1
	Platforms	All

test-fail-threshold number


	Synopsis	Total probe failures for trap generation
	Context	configure saa owner named-item test named-item type dns trap-generation test-fail-threshold number
	Tree	test-fail-threshold
	Description	This command configures the number of consecutive test failures required to generate a trap. This command has no effect when test-fail is set to false. This command is not applicable to SAA traceroute tests.
	Range	0 to 15
	Default	1
	Introduced	22.10.R1
	Platforms	All

eth-cfm-loopback


	Synopsis	Enable the eth-cfm-loopback context
	Context	configure saa owner named-item test named-item type eth-cfm-loopback
	Tree	eth-cfm-loopback
	Description	Commands in this context configure an Ethernet CFM loopback test in SAA.
	Notes	The following elements are part of a choice: dns, eth-cfm-loopback, icmp-ping, lsp-ping, sdp-ping, or vccv-ping.
	Introduced	24.10.R1
	Platforms	All

count number


	Synopsis	Number of packets to send
	Context	configure saa owner named-item test named-item type eth-cfm-loopback count number
	Tree	count
	Range	1 to 100
	Units	packets
	Default	1
	Introduced	24.10.R1
	Platforms	All

destination (mac-unicast-address-no-zero | number)


	Synopsis	Destination MAC address or remote MEP ID of the peer
	Context	configure saa owner named-item test named-item type eth-cfm-loopback destination (mac-unicast-address-no-zero \| number)
	Tree	destination
	Description	This command specifies the Layer 2 unicast MAC address of the destination MEP or, alternatively, the remote MEP ID. When the remote MEP ID option is used instead of the MAC address, the domain and association information of the source MEP for the test is used to check for a locally stored unicast MAC address for the peer. The local MEP must be administratively enabled.
	Range	1 to 8191
	Notes	This element is mandatory.
	Introduced	24.10.R1
	Platforms	All

interval number


	Synopsis	Interval between packets sent
	Context	configure saa owner named-item test named-item type eth-cfm-loopback interval number
	Tree	interval
	Range	1 to 10
	Units	seconds
	Default	5
	Introduced	24.10.R1
	Platforms	All

ma-admin-name (named-item-64 | admin-name)


	Synopsis	Source Ethernet Maintenance Association (MA) name
	Context	configure saa owner named-item test named-item type eth-cfm-loopback ma-admin-name (named-item-64 \| admin-name)
	Tree	ma-admin-name
	String length	1 to 64
	Notes	This element is mandatory.
	Introduced	24.10.R1
	Platforms	All

md-admin-name (named-item-64 | admin-name)


	Synopsis	Source Ethernet Maintenance Domain (MD) name
	Context	configure saa owner named-item test named-item type eth-cfm-loopback md-admin-name (named-item-64 \| admin-name)
	Tree	md-admin-name
	String length	1 to 64
	Notes	This element is mandatory.
	Introduced	24.10.R1
	Platforms	All

mep number


	Synopsis	Source Ethernet MEP ID
	Context	configure saa owner named-item test named-item type eth-cfm-loopback mep number
	Tree	mep
	Range	1 to 8191
	Notes	This element is mandatory.
	Introduced	24.10.R1
	Platforms	All

qos


	Synopsis	Enter the qos context
	Context	configure saa owner named-item test named-item type eth-cfm-loopback qos
	Tree	qos
	Introduced	24.10.R1
	Platforms	All

fc keyword


	Synopsis	FC for the sent echo request packets
	Context	configure saa owner named-item test named-item type eth-cfm-loopback qos fc keyword
	Tree	fc
	Options	be – Best effort l2 – Low 2 (best effort) af – Assured forwarding (assured) l1 – Low 1 (assured) h2 – High 2 (high priority) ef – Expedited forwarding (high priority) h1 – High 1 (high priority) nc – Network control (high priority)
	Default	nc
	Introduced	24.10.R1
	Platforms	All

profile keyword


	Synopsis	QoS profile for the sent echo request packets
	Context	configure saa owner named-item test named-item type eth-cfm-loopback qos profile keyword
	Tree	profile
	Options	in – In profile out – Out of profile
	Default	in
	Introduced	24.10.R1
	Platforms	All

size number


	Synopsis	Size of the value field in the sent frames
	Context	configure saa owner named-item test named-item type eth-cfm-loopback size number
	Tree	size
	Range	0 to 1500
	Units	bytes
	Default	0
	Introduced	24.10.R1
	Platforms	All

timeout number


	Synopsis	Maximum time to wait for a reply packet
	Context	configure saa owner named-item test named-item type eth-cfm-loopback timeout number
	Tree	timeout
	Description	This command configures the maximum time the router waits for a reply packet after sending the last probe for the test. When the timeout expires, the test is marked complete and no more packets are processed.
	Range	1 to 10
	Units	seconds
	Default	5
	Introduced	24.10.R1
	Platforms	All

trap-generation


	Synopsis	Enter the trap-generation context
	Context	configure saa owner named-item test named-item type eth-cfm-loopback trap-generation
	Tree	trap-generation
	Introduced	24.10.R1
	Platforms	All

probe-fail boolean


	Synopsis	Enable the generation of probe fail notifications
	Context	configure saa owner named-item test named-item type eth-cfm-loopback trap-generation probe-fail boolean
	Tree	probe-fail
	Description	When configured to true, the system generates an SNMP trap if the consecutive probe failure threshold is reached during the execution of the SAA ping test. This command is not applicable to SAA traceroute tests.
	Default	false
	Introduced	24.10.R1
	Platforms	All

probe-fail-threshold number


	Synopsis	Consecutive probe failure count
	Context	configure saa owner named-item test named-item type eth-cfm-loopback trap-generation probe-fail-threshold number
	Tree	probe-fail-threshold
	Description	This command configures the number of consecutive ping probe failures required to generate a trap. This command has no effect if the probe-fail command is set to false. This command is not applicable to SAA traceroute tests.
	Range	0 to 15
	Default	1
	Introduced	24.10.R1
	Platforms	All

test-complete boolean


	Synopsis	Enable generation of test complete notifications
	Context	configure saa owner named-item test named-item type eth-cfm-loopback trap-generation test-complete boolean
	Tree	test-complete
	Default	false
	Introduced	24.10.R1
	Platforms	All

test-fail boolean


	Synopsis	Enable the generation of test fail notifications
	Context	configure saa owner named-item test named-item type eth-cfm-loopback trap-generation test-fail boolean
	Tree	test-fail
	Description	When configured to true, the system generates a trap if a test fails. In the case of a ping test, the test is considered to have failed (for trap generation) if the number of failed probes is at least the value of the test-fail-threshold setting.
	Default	false
	Introduced	24.10.R1
	Platforms	All

test-fail-threshold number


	Synopsis	Total probe failures for trap generation
	Context	configure saa owner named-item test named-item type eth-cfm-loopback trap-generation test-fail-threshold number
	Tree	test-fail-threshold
	Description	This command configures the number of consecutive test failures required to generate a trap. This command has no effect when test-fail is set to false. This command is not applicable to SAA traceroute tests.
	Range	0 to 15
	Default	1
	Introduced	24.10.R1
	Platforms	All

icmp-ping


	Synopsis	Enable the icmp-ping context
	Context	configure saa owner named-item test named-item type icmp-ping
	Tree	icmp-ping
	Description	Commands in this context configure an ICMP ping test.
	Notes	The following elements are part of a choice: dns, eth-cfm-loopback, icmp-ping, lsp-ping, sdp-ping, or vccv-ping.
	Introduced	16.0.R4
	Platforms	All

bypass-routing boolean


	Synopsis	Bypass routing table for directly connected interfaces
	Context	configure saa owner named-item test named-item type icmp-ping bypass-routing boolean
	Tree	bypass-routing
	Default	false
	Notes	The following elements are part of a choice: bypass-routing, interface, or next-hop-address.
	Introduced	16.0.R4
	Platforms	All

count number


	Synopsis	ICMP Echo Request packets to send in a sample window
	Context	configure saa owner named-item test named-item type icmp-ping count number
	Tree	count
	Range	1 to 100000
	Units	packets
	Default	5
	Introduced	16.0.R4
	Platforms	All

destination-address (ipv4-address-no-zone | ipv6-address-no-zone | string-not-all-spaces)


	Synopsis	Destination IP address or DNS name to send ping request
	Context	configure saa owner named-item test named-item type icmp-ping destination-address (ipv4-address-no-zone \| ipv6-address-no-zone \| string-not-all-spaces)
	Tree	destination-address
	String length	1 to 128
	Notes	This element is mandatory.
	Introduced	16.0.R4
	Platforms	All

do-not-fragment boolean


	Synopsis	Do not fragment echo request packets (valid for IPv4)
	Context	configure saa owner named-item test named-item type icmp-ping do-not-fragment boolean
	Tree	do-not-fragment
	Description	This command sets the Do Not Fragment (DF) bit in the IPv4 header. This prevents packet fragmentation along the path when there is an MTU mismatch.
	Default	false
	Introduced	16.0.R4
	Platforms	All

interface interface-name


	Synopsis	Interface name
	Context	configure saa owner named-item test named-item type icmp-ping interface interface-name
	Tree	interface
	String length	1 to 32
	Notes	The following elements are part of a choice: bypass-routing, interface, or next-hop-address.
	Introduced	16.0.R4
	Platforms	All

interval (number | decimal-number)


	Synopsis	Minimum time to expire before message request is sent
	Context	configure saa owner named-item test named-item type icmp-ping interval (number \| decimal-number)
	Tree	interval
	Range	1 to 10000
	Units	seconds
	Default	1
	Introduced	16.0.R4
	Platforms	All

next-hop-address (ipv4-address-no-zone | ipv6-address-no-zone)


	Synopsis	Next-hop IP address to reach destination
	Context	configure saa owner named-item test named-item type icmp-ping next-hop-address (ipv4-address-no-zone \| ipv6-address-no-zone)
	Tree	next-hop-address
	Notes	The following elements are part of a choice: bypass-routing, interface, or next-hop-address.
	Introduced	16.0.R4
	Platforms	All

pattern (keyword | number)


	Synopsis	Pattern to fill the data portion in a ping packet
	Context	configure saa owner named-item test named-item type icmp-ping pattern (keyword \| number)
	Tree	pattern
	Range	0 to 65535
	Options	sequential
	Default	sequential
	Introduced	16.0.R4
	Platforms	All

qos


	Synopsis	Enter the qos context
	Context	configure saa owner named-item test named-item type icmp-ping qos
	Tree	qos
	Introduced	16.0.R4
	Platforms	All

fc keyword


	Synopsis	Forwarding class
	Context	configure saa owner named-item test named-item type icmp-ping qos fc keyword
	Tree	fc
	Options	be – Best effort l2 – Low 2 (best effort) af – Assured forwarding (assured) l1 – Low 1 (assured) h2 – High 2 (high priority) ef – Expedited forwarding (high priority) h1 – High 1 (high priority) nc – Network control (high priority)
	Default	nc
	Introduced	16.0.R4
	Platforms	All

tos number


	Synopsis	Type of service
	Context	configure saa owner named-item test named-item type icmp-ping qos tos number
	Tree	tos
	Range	0 to 255
	Default	0
	Introduced	16.0.R4
	Platforms	All

router-instance string


	Synopsis	Router name or VPRN service name
	Context	configure saa owner named-item test named-item type icmp-ping router-instance string
	Tree	router-instance
	Default	Base
	Introduced	16.0.R4
	Platforms	All

size number


	Synopsis	Packet padding size
	Context	configure saa owner named-item test named-item type icmp-ping size number
	Tree	size
	Description	This command configures the number of bytes in the combined ICMP Header (8 bytes) and ICMP Payload (variable size) of the ICMP Echo Request packets.
	Range	0 to 16384
	Units	bytes
	Default	56
	Introduced	16.0.R4
	Platforms	All

source-address (ipv4-address-no-zone | ipv6-address-no-zone)


	Synopsis	Source IP address
	Context	configure saa owner named-item test named-item type icmp-ping source-address (ipv4-address-no-zone \| ipv6-address-no-zone)
	Tree	source-address
	Description	This command configures the source IP address to be loaded into the IP header of the ICMP Echo Request packet. If unconfigured, the router uses a system-selected local address.
	Introduced	16.0.R4
	Platforms	All

timeout number


	Synopsis	Time router waits for a reply after sending last probe
	Context	configure saa owner named-item test named-item type icmp-ping timeout number
	Tree	timeout
	Range	1 to 10
	Units	seconds
	Default	5
	Introduced	16.0.R4
	Platforms	All

trap-generation


	Synopsis	Enter the trap-generation context
	Context	configure saa owner named-item test named-item type icmp-ping trap-generation
	Tree	trap-generation
	Introduced	22.10.R1
	Platforms	All

probe-fail boolean


	Synopsis	Enable the generation of probe fail notifications
	Context	configure saa owner named-item test named-item type icmp-ping trap-generation probe-fail boolean
	Tree	probe-fail
	Description	When configured to true, the system generates an SNMP trap if the consecutive probe failure threshold is reached during the execution of the SAA ping test. This command is not applicable to SAA traceroute tests.
	Default	false
	Introduced	22.10.R1
	Platforms	All

probe-fail-threshold number


	Synopsis	Consecutive probe failure count
	Context	configure saa owner named-item test named-item type icmp-ping trap-generation probe-fail-threshold number
	Tree	probe-fail-threshold
	Description	This command configures the number of consecutive ping probe failures required to generate a trap. This command has no effect if the probe-fail command is set to false. This command is not applicable to SAA traceroute tests.
	Range	0 to 15
	Default	1
	Introduced	22.10.R1
	Platforms	All

test-complete boolean


	Synopsis	Enable generation of test complete notifications
	Context	configure saa owner named-item test named-item type icmp-ping trap-generation test-complete boolean
	Tree	test-complete
	Default	false
	Introduced	22.10.R1
	Platforms	All

test-fail boolean


	Synopsis	Enable the generation of test fail notifications
	Context	configure saa owner named-item test named-item type icmp-ping trap-generation test-fail boolean
	Tree	test-fail
	Description	When configured to true, the system generates a trap if a test fails. In the case of a ping test, the test is considered to have failed (for trap generation) if the number of failed probes is at least the value of the test-fail-threshold setting.
	Default	false
	Introduced	22.10.R1
	Platforms	All

test-fail-threshold number


	Synopsis	Total probe failures for trap generation
	Context	configure saa owner named-item test named-item type icmp-ping trap-generation test-fail-threshold number
	Tree	test-fail-threshold
	Description	This command configures the number of consecutive test failures required to generate a trap. This command has no effect when test-fail is set to false. This command is not applicable to SAA traceroute tests.
	Range	0 to 15
	Default	1
	Introduced	22.10.R1
	Platforms	All

ttl number


	Synopsis	Time to live in the IP header
	Context	configure saa owner named-item test named-item type icmp-ping ttl number
	Tree	ttl
	Range	1 to 128
	Default	64
	Introduced	16.0.R4
	Platforms	All

lsp-ping


	Synopsis	Enable the lsp-ping context
	Context	configure saa owner named-item test named-item type lsp-ping
	Tree	lsp-ping
	Description	Commands in this context configure the command options to perform in-band LSP connectivity tests. LSP ping uses the protocol and data structures defined in RFC 8029, Detecting Multiprotocol Label Switched (MPLS) Data-Plane Failures.
	Notes	The following elements are part of a choice: dns, eth-cfm-loopback, icmp-ping, lsp-ping, sdp-ping, or vccv-ping.
	Introduced	22.10.R1
	Platforms	All

interval number


	Synopsis	Minimum time before the next lsp-ping request is sent
	Context	configure saa owner named-item test named-item type lsp-ping interval number
	Tree	interval
	Range	1 to 10
	Units	seconds
	Default	1
	Introduced	22.10.R1
	Platforms	All

qos


	Synopsis	Enter the qos context
	Context	configure saa owner named-item test named-item type lsp-ping qos
	Tree	qos
	Introduced	22.10.R1
	Platforms	All

fc keyword


	Synopsis	Forwarding class
	Context	configure saa owner named-item test named-item type lsp-ping qos fc keyword
	Tree	fc
	Options	be – Best effort l2 – Low 2 (best effort) af – Assured forwarding (assured) l1 – Low 1 (assured) h2 – High 2 (high priority) ef – Expedited forwarding (high priority) h1 – High 1 (high priority) nc – Network control (high priority)
	Default	be
	Introduced	22.10.R1
	Platforms	All

profile keyword


	Synopsis	Profile
	Context	configure saa owner named-item test named-item type lsp-ping qos profile keyword
	Tree	profile
	Options	in – In profile out – Out of profile
	Default	out
	Introduced	22.10.R1
	Platforms	All

send-count number


	Synopsis	Number of request packets to send in a sample window
	Context	configure saa owner named-item test named-item type lsp-ping send-count number
	Tree	send-count
	Range	1 to 100
	Units	packets
	Default	1
	Introduced	22.10.R1
	Platforms	All

size number


	Synopsis	Packet pad size
	Context	configure saa owner named-item test named-item type lsp-ping size number
	Tree	size
	Range	1 to 9786
	Units	bytes
	Default	1
	Introduced	22.10.R1
	Platforms	All

source-ip-address (ipv4-address-no-zone | ipv6-address-no-zone)


	Synopsis	Source IP address
	Context	configure saa owner named-item test named-item type lsp-ping source-ip-address (ipv4-address-no-zone \| ipv6-address-no-zone)
	Tree	source-ip-address
	Introduced	22.10.R1
	Platforms	All

sub-type


	Synopsis	Enter the sub-type context
	Context	configure saa owner named-item test named-item type lsp-ping sub-type
	Tree	sub-type
	Introduced	22.10.R1
	Platforms	All

bgp-label


	Synopsis	Enable the bgp-label context
	Context	configure saa owner named-item test named-item type lsp-ping sub-type bgp-label
	Tree	bgp-label
	Notes	The following elements are part of a choice: bgp-label, ldp, rsvp-te, sr-isis, sr-ospf, sr-ospf3, sr-policy, or sr-te.
	Introduced	22.10.R1
	Platforms	All

path-destination


	Synopsis	Enter the path-destination context
	Context	configure saa owner named-item test named-item type lsp-ping sub-type bgp-label path-destination
	Tree	path-destination
	Introduced	22.10.R1
	Platforms	All

interface interface-name


	Synopsis	Egress router interface used with the path destination
	Context	configure saa owner named-item test named-item type lsp-ping sub-type bgp-label path-destination interface interface-name
	Tree	interface
	String length	1 to 32
	Notes	The following elements are part of a choice: interface or next-hop.
	Introduced	22.10.R1
	Platforms	All

ip-address (ipv4-address-no-zone | ipv6-address-no-zone)


	Synopsis	IP address of the path destination
	Context	configure saa owner named-item test named-item type lsp-ping sub-type bgp-label path-destination ip-address (ipv4-address-no-zone \| ipv6-address-no-zone)
	Tree	ip-address
	Introduced	22.10.R1
	Platforms	All

next-hop (ipv4-address-no-zone | ipv6-address-no-zone)


	Synopsis	Egress IP next hop address used with path destination
	Context	configure saa owner named-item test named-item type lsp-ping sub-type bgp-label path-destination next-hop (ipv4-address-no-zone \| ipv6-address-no-zone)
	Tree	next-hop
	Notes	The following elements are part of a choice: interface or next-hop.
	Introduced	22.10.R1
	Platforms	All

prefix (ipv4-prefix | ipv6-prefix)


	Synopsis	Destination IP prefix for the test
	Context	configure saa owner named-item test named-item type lsp-ping sub-type bgp-label prefix (ipv4-prefix \| ipv6-prefix)
	Tree	prefix
	Notes	This element is mandatory.
	Introduced	22.10.R1
	Platforms	All

ldp


	Synopsis	Enable the ldp context
	Context	configure saa owner named-item test named-item type lsp-ping sub-type ldp
	Tree	ldp
	Notes	The following elements are part of a choice: bgp-label, ldp, rsvp-te, sr-isis, sr-ospf, sr-ospf3, sr-policy, or sr-te.
	Introduced	22.10.R1
	Platforms	All

path-destination


	Synopsis	Enter the path-destination context
	Context	configure saa owner named-item test named-item type lsp-ping sub-type ldp path-destination
	Tree	path-destination
	Introduced	22.10.R1
	Platforms	All

interface interface-name


	Synopsis	Egress router interface used with the path destination
	Context	configure saa owner named-item test named-item type lsp-ping sub-type ldp path-destination interface interface-name
	Tree	interface
	String length	1 to 32
	Notes	The following elements are part of a choice: interface or next-hop.
	Introduced	22.10.R1
	Platforms	All

ip-address (ipv4-address-no-zone | ipv6-address-no-zone)


	Synopsis	IP address of the path destination
	Context	configure saa owner named-item test named-item type lsp-ping sub-type ldp path-destination ip-address (ipv4-address-no-zone \| ipv6-address-no-zone)
	Tree	ip-address
	Introduced	22.10.R1
	Platforms	All

next-hop (ipv4-address-no-zone | ipv6-address-no-zone)


	Synopsis	Egress IP next hop address used with path destination
	Context	configure saa owner named-item test named-item type lsp-ping sub-type ldp path-destination next-hop (ipv4-address-no-zone \| ipv6-address-no-zone)
	Tree	next-hop
	Notes	The following elements are part of a choice: interface or next-hop.
	Introduced	22.10.R1
	Platforms	All

prefix (ipv4-prefix | ipv6-prefix)


	Synopsis	Destination IP prefix for the test
	Context	configure saa owner named-item test named-item type lsp-ping sub-type ldp prefix (ipv4-prefix \| ipv6-prefix)
	Tree	prefix
	Notes	This element is mandatory.
	Introduced	22.10.R1
	Platforms	All

rsvp-te


	Synopsis	Enable the rsvp-te context
	Context	configure saa owner named-item test named-item type lsp-ping sub-type rsvp-te
	Tree	rsvp-te
	Notes	The following elements are part of a choice: bgp-label, ldp, rsvp-te, sr-isis, sr-ospf, sr-ospf3, sr-policy, or sr-te.
	Introduced	22.10.R1
	Platforms	All

lsp-name named-item-64


	Synopsis	Name of the LSP to be tested
	Context	configure saa owner named-item test named-item type lsp-ping sub-type rsvp-te lsp-name named-item-64
	Tree	lsp-name
	String length	1 to 64
	Notes	This element is mandatory.
	Introduced	22.10.R1
	Platforms	All

path named-item-64


	Synopsis	Name of the MPLS path to be tested
	Context	configure saa owner named-item test named-item type lsp-ping sub-type rsvp-te path named-item-64
	Tree	path
	String length	1 to 64
	Introduced	22.10.R1
	Platforms	All

sr-isis


	Synopsis	Enable the sr-isis context
	Context	configure saa owner named-item test named-item type lsp-ping sub-type sr-isis
	Tree	sr-isis
	Notes	The following elements are part of a choice: bgp-label, ldp, rsvp-te, sr-isis, sr-ospf, sr-ospf3, sr-policy, or sr-te.
	Introduced	22.10.R1
	Platforms	All

igp-instance number


	Synopsis	IGP instance for the SR IS-IS test
	Context	configure saa owner named-item test named-item type lsp-ping sub-type sr-isis igp-instance number
	Tree	igp-instance
	Range	0 to 127
	Default	0
	Introduced	22.10.R1
	Platforms	All

path-destination


	Synopsis	Enter the path-destination context
	Context	configure saa owner named-item test named-item type lsp-ping sub-type sr-isis path-destination
	Tree	path-destination
	Introduced	22.10.R1
	Platforms	All

interface interface-name


	Synopsis	Egress router interface used with the path destination
	Context	configure saa owner named-item test named-item type lsp-ping sub-type sr-isis path-destination interface interface-name
	Tree	interface
	String length	1 to 32
	Notes	The following elements are part of a choice: interface or next-hop.
	Introduced	22.10.R1
	Platforms	All

ip-address (ipv4-address-no-zone | ipv6-address-no-zone)


	Synopsis	IP address of the path destination
	Context	configure saa owner named-item test named-item type lsp-ping sub-type sr-isis path-destination ip-address (ipv4-address-no-zone \| ipv6-address-no-zone)
	Tree	ip-address
	Introduced	22.10.R1
	Platforms	All

next-hop (ipv4-address-no-zone | ipv6-address-no-zone)


	Synopsis	Egress IP next hop address used with path destination
	Context	configure saa owner named-item test named-item type lsp-ping sub-type sr-isis path-destination next-hop (ipv4-address-no-zone \| ipv6-address-no-zone)
	Tree	next-hop
	Notes	The following elements are part of a choice: interface or next-hop.
	Introduced	22.10.R1
	Platforms	All

prefix (ipv4-prefix | ipv6-prefix)


	Synopsis	Destination IP prefix for the test
	Context	configure saa owner named-item test named-item type lsp-ping sub-type sr-isis prefix (ipv4-prefix \| ipv6-prefix)
	Tree	prefix
	Notes	This element is mandatory.
	Introduced	22.10.R1
	Platforms	All

sr-ospf


	Synopsis	Enable the sr-ospf context
	Context	configure saa owner named-item test named-item type lsp-ping sub-type sr-ospf
	Tree	sr-ospf
	Notes	The following elements are part of a choice: bgp-label, ldp, rsvp-te, sr-isis, sr-ospf, sr-ospf3, sr-policy, or sr-te.
	Introduced	22.10.R1
	Platforms	All

igp-instance number


	Synopsis	IGP instance for the SR OSPF test
	Context	configure saa owner named-item test named-item type lsp-ping sub-type sr-ospf igp-instance number
	Tree	igp-instance
	Range	0 to 31
	Default	0
	Introduced	22.10.R1
	Platforms	All

path-destination


	Synopsis	Enter the path-destination context
	Context	configure saa owner named-item test named-item type lsp-ping sub-type sr-ospf path-destination
	Tree	path-destination
	Introduced	22.10.R1
	Platforms	All

interface interface-name


	Synopsis	Egress router interface used with the path destination
	Context	configure saa owner named-item test named-item type lsp-ping sub-type sr-ospf path-destination interface interface-name
	Tree	interface
	String length	1 to 32
	Notes	The following elements are part of a choice: interface or next-hop.
	Introduced	22.10.R1
	Platforms	All

ip-address (ipv4-address-no-zone | ipv6-address-no-zone)


	Synopsis	IP address of the path destination
	Context	configure saa owner named-item test named-item type lsp-ping sub-type sr-ospf path-destination ip-address (ipv4-address-no-zone \| ipv6-address-no-zone)
	Tree	ip-address
	Introduced	22.10.R1
	Platforms	All

next-hop (ipv4-address-no-zone | ipv6-address-no-zone)


	Synopsis	Egress IP next hop address used with path destination
	Context	configure saa owner named-item test named-item type lsp-ping sub-type sr-ospf path-destination next-hop (ipv4-address-no-zone \| ipv6-address-no-zone)
	Tree	next-hop
	Notes	The following elements are part of a choice: interface or next-hop.
	Introduced	22.10.R1
	Platforms	All

prefix (ipv4-prefix | ipv6-prefix)


	Synopsis	Destination IP prefix for the test
	Context	configure saa owner named-item test named-item type lsp-ping sub-type sr-ospf prefix (ipv4-prefix \| ipv6-prefix)
	Tree	prefix
	Notes	This element is mandatory.
	Introduced	22.10.R1
	Platforms	All

sr-ospf3


	Synopsis	Enable the sr-ospf3 context
	Context	configure saa owner named-item test named-item type lsp-ping sub-type sr-ospf3
	Tree	sr-ospf3
	Notes	The following elements are part of a choice: bgp-label, ldp, rsvp-te, sr-isis, sr-ospf, sr-ospf3, sr-policy, or sr-te.
	Introduced	22.10.R1
	Platforms	All

igp-instance number


	Synopsis	IGP instance for the SR OSPFv3 test
	Context	configure saa owner named-item test named-item type lsp-ping sub-type sr-ospf3 igp-instance number
	Tree	igp-instance
	Range	0 to 31 \| 64 to 95
	Default	0
	Introduced	22.10.R1
	Platforms	All

path-destination


	Synopsis	Enter the path-destination context
	Context	configure saa owner named-item test named-item type lsp-ping sub-type sr-ospf3 path-destination
	Tree	path-destination
	Introduced	22.10.R1
	Platforms	All

interface interface-name


	Synopsis	Egress router interface used with the path destination
	Context	configure saa owner named-item test named-item type lsp-ping sub-type sr-ospf3 path-destination interface interface-name
	Tree	interface
	String length	1 to 32
	Notes	The following elements are part of a choice: interface or next-hop.
	Introduced	22.10.R1
	Platforms	All

ip-address (ipv4-address-no-zone | ipv6-address-no-zone)


	Synopsis	IP address of the path destination
	Context	configure saa owner named-item test named-item type lsp-ping sub-type sr-ospf3 path-destination ip-address (ipv4-address-no-zone \| ipv6-address-no-zone)
	Tree	ip-address
	Introduced	22.10.R1
	Platforms	All

next-hop (ipv4-address-no-zone | ipv6-address-no-zone)


	Synopsis	Egress IP next hop address used with path destination
	Context	configure saa owner named-item test named-item type lsp-ping sub-type sr-ospf3 path-destination next-hop (ipv4-address-no-zone \| ipv6-address-no-zone)
	Tree	next-hop
	Notes	The following elements are part of a choice: interface or next-hop.
	Introduced	22.10.R1
	Platforms	All

prefix (ipv4-prefix | ipv6-prefix)


	Synopsis	Destination IP prefix for the test
	Context	configure saa owner named-item test named-item type lsp-ping sub-type sr-ospf3 prefix (ipv4-prefix \| ipv6-prefix)
	Tree	prefix
	Notes	This element is mandatory.
	Introduced	22.10.R1
	Platforms	All

sr-policy


	Synopsis	Enable the sr-policy context
	Context	configure saa owner named-item test named-item type lsp-ping sub-type sr-policy
	Tree	sr-policy
	Notes	The following elements are part of a choice: bgp-label, ldp, rsvp-te, sr-isis, sr-ospf, sr-ospf3, sr-policy, or sr-te.
	Introduced	22.10.R1
	Platforms	All

color number


	Synopsis	Segment Routing color for the test
	Context	configure saa owner named-item test named-item type lsp-ping sub-type sr-policy color number
	Tree	color
	Range	0 to 4294967295
	Notes	This element is mandatory.
	Introduced	22.10.R1
	Platforms	All

endpoint (ipv4-address-no-zone | ipv6-address-no-zone)


	Synopsis	Segment Routing endpoint for the test
	Context	configure saa owner named-item test named-item type lsp-ping sub-type sr-policy endpoint (ipv4-address-no-zone \| ipv6-address-no-zone)
	Tree	endpoint
	Notes	This element is mandatory.
	Introduced	22.10.R1
	Platforms	All

path-destination


	Synopsis	Enter the path-destination context
	Context	configure saa owner named-item test named-item type lsp-ping sub-type sr-policy path-destination
	Tree	path-destination
	Introduced	22.10.R1
	Platforms	All

interface interface-name


	Synopsis	Egress router interface used with the path destination
	Context	configure saa owner named-item test named-item type lsp-ping sub-type sr-policy path-destination interface interface-name
	Tree	interface
	String length	1 to 32
	Notes	The following elements are part of a choice: interface or next-hop.
	Introduced	22.10.R1
	Platforms	All

ip-address (ipv4-address-no-zone | ipv6-address-no-zone)


	Synopsis	IP address of the path destination
	Context	configure saa owner named-item test named-item type lsp-ping sub-type sr-policy path-destination ip-address (ipv4-address-no-zone \| ipv6-address-no-zone)
	Tree	ip-address
	Introduced	22.10.R1
	Platforms	All

next-hop (ipv4-address-no-zone | ipv6-address-no-zone)


	Synopsis	Egress IP next hop address used with path destination
	Context	configure saa owner named-item test named-item type lsp-ping sub-type sr-policy path-destination next-hop (ipv4-address-no-zone \| ipv6-address-no-zone)
	Tree	next-hop
	Notes	The following elements are part of a choice: interface or next-hop.
	Introduced	22.10.R1
	Platforms	All

segment-list number


	Synopsis	Segment Routing segment list for the test
	Context	configure saa owner named-item test named-item type lsp-ping sub-type sr-policy segment-list number
	Tree	segment-list
	Range	1 to 32
	Introduced	22.10.R1
	Platforms	All

sr-te


	Synopsis	Enable the sr-te context
	Context	configure saa owner named-item test named-item type lsp-ping sub-type sr-te
	Tree	sr-te
	Notes	The following elements are part of a choice: bgp-label, ldp, rsvp-te, sr-isis, sr-ospf, sr-ospf3, sr-policy, or sr-te.
	Introduced	22.10.R1
	Platforms	All

lsp-name named-item-64


	Synopsis	Name of the LSP to be tested
	Context	configure saa owner named-item test named-item type lsp-ping sub-type sr-te lsp-name named-item-64
	Tree	lsp-name
	String length	1 to 64
	Notes	This element is mandatory.
	Introduced	22.10.R1
	Platforms	All

path named-item-64


	Synopsis	Name of the MPLS path to be tested
	Context	configure saa owner named-item test named-item type lsp-ping sub-type sr-te path named-item-64
	Tree	path
	String length	1 to 64
	Introduced	22.10.R1
	Platforms	All

path-destination


	Synopsis	Enter the path-destination context
	Context	configure saa owner named-item test named-item type lsp-ping sub-type sr-te path-destination
	Tree	path-destination
	Introduced	22.10.R1
	Platforms	All

interface interface-name


	Synopsis	Egress router interface used with the path destination
	Context	configure saa owner named-item test named-item type lsp-ping sub-type sr-te path-destination interface interface-name
	Tree	interface
	String length	1 to 32
	Notes	The following elements are part of a choice: interface or next-hop.
	Introduced	22.10.R1
	Platforms	All

ip-address (ipv4-address-no-zone | ipv6-address-no-zone)


	Synopsis	IP address of the path destination
	Context	configure saa owner named-item test named-item type lsp-ping sub-type sr-te path-destination ip-address (ipv4-address-no-zone \| ipv6-address-no-zone)
	Tree	ip-address
	Introduced	22.10.R1
	Platforms	All

next-hop (ipv4-address-no-zone | ipv6-address-no-zone)


	Synopsis	Egress IP next hop address used with path destination
	Context	configure saa owner named-item test named-item type lsp-ping sub-type sr-te path-destination next-hop (ipv4-address-no-zone \| ipv6-address-no-zone)
	Tree	next-hop
	Notes	The following elements are part of a choice: interface or next-hop.
	Introduced	22.10.R1
	Platforms	All

timeout number


	Synopsis	Time router waits for a reply to an echo request
	Context	configure saa owner named-item test named-item type lsp-ping timeout number
	Tree	timeout
	Range	1 to 10
	Units	seconds
	Default	5
	Introduced	22.10.R1
	Platforms	All

trap-generation


	Synopsis	Enter the trap-generation context
	Context	configure saa owner named-item test named-item type lsp-ping trap-generation
	Tree	trap-generation
	Introduced	22.10.R1
	Platforms	All

probe-fail boolean


	Synopsis	Enable the generation of probe fail notifications
	Context	configure saa owner named-item test named-item type lsp-ping trap-generation probe-fail boolean
	Tree	probe-fail
	Description	When configured to true, the system generates an SNMP trap if the consecutive probe failure threshold is reached during the execution of the SAA ping test. This command is not applicable to SAA traceroute tests.
	Default	false
	Introduced	22.10.R1
	Platforms	All

probe-fail-threshold number


	Synopsis	Consecutive probe failure count
	Context	configure saa owner named-item test named-item type lsp-ping trap-generation probe-fail-threshold number
	Tree	probe-fail-threshold
	Description	This command configures the number of consecutive ping probe failures required to generate a trap. This command has no effect if the probe-fail command is set to false. This command is not applicable to SAA traceroute tests.
	Range	0 to 15
	Default	1
	Introduced	22.10.R1
	Platforms	All

test-complete boolean


	Synopsis	Enable generation of test complete notifications
	Context	configure saa owner named-item test named-item type lsp-ping trap-generation test-complete boolean
	Tree	test-complete
	Default	false
	Introduced	22.10.R1
	Platforms	All

test-fail boolean


	Synopsis	Enable the generation of test fail notifications
	Context	configure saa owner named-item test named-item type lsp-ping trap-generation test-fail boolean
	Tree	test-fail
	Description	When configured to true, the system generates a trap if a test fails. In the case of a ping test, the test is considered to have failed (for trap generation) if the number of failed probes is at least the value of the test-fail-threshold setting.
	Default	false
	Introduced	22.10.R1
	Platforms	All

test-fail-threshold number


	Synopsis	Total probe failures for trap generation
	Context	configure saa owner named-item test named-item type lsp-ping trap-generation test-fail-threshold number
	Tree	test-fail-threshold
	Description	This command configures the number of consecutive test failures required to generate a trap. This command has no effect when test-fail is set to false. This command is not applicable to SAA traceroute tests.
	Range	0 to 15
	Default	1
	Introduced	22.10.R1
	Platforms	All

ttl number


	Synopsis	TTL value for the echo request MPLS label
	Context	configure saa owner named-item test named-item type lsp-ping ttl number
	Tree	ttl
	Range	1 to 255
	Default	255
	Introduced	22.10.R1
	Platforms	All

sdp-ping


	Synopsis	Enable the sdp-ping context
	Context	configure saa owner named-item test named-item type sdp-ping
	Tree	sdp-ping
	Description	Commands in this context configure tests on SDPs for unidirectional or round-trip connectivity, as well as for performing SDP MTU path tests.
	Notes	The following elements are part of a choice: dns, eth-cfm-loopback, icmp-ping, lsp-ping, sdp-ping, or vccv-ping.
	Introduced	24.10.R1
	Platforms	All

count number


	Synopsis	Number of SDP echo request packets to send
	Context	configure saa owner named-item test named-item type sdp-ping count number
	Tree	count
	Description	This command specifies the number of echo request packets to send. Each request must either time out or receive a reply before the next message request is sent. The interval value must expire before the next message request is sent.
	Range	1 to 100
	Units	packets
	Default	1
	Introduced	24.10.R1
	Platforms	All

interval number


	Synopsis	Interval between SDP echo request packets sent
	Context	configure saa owner named-item test named-item type sdp-ping interval number
	Tree	interval
	Range	1 to 10
	Units	seconds
	Default	1
	Introduced	24.10.R1
	Platforms	All

originating-sdp-identifier number


	Synopsis	SDP ID used to send packets
	Context	configure saa owner named-item test named-item type sdp-ping originating-sdp-identifier number
	Tree	originating-sdp-identifier
	Description	This command specifies the SDP ID that is used by SDP ping. The far-end address of the specified SDP ID is the expected responder ID within each reply received. The SDP ID defines the SDP tunnel encapsulation used to reach the far end. This can be IP/GRE or MPLS. If this ID is invalid, administratively down, or otherwise unavailable, the SDP echo request message is not sent, and an error message is displayed. After the interval timer expires, the SDP ping attempts to send the next request, if required.
	Range	1 to 32767
	Notes	This element is mandatory.
	Introduced	24.10.R1
	Platforms	All

qos


	Synopsis	Enter the qos context
	Context	configure saa owner named-item test named-item type sdp-ping qos
	Tree	qos
	Introduced	24.10.R1
	Platforms	All

fc keyword


	Synopsis	FC for the transmitted SDP echo request packets
	Context	configure saa owner named-item test named-item type sdp-ping qos fc keyword
	Tree	fc
	Options	be – Best effort l2 – Low 2 (best effort) af – Assured forwarding (assured) l1 – Low 1 (assured) h2 – High 2 (high priority) ef – Expedited forwarding (high priority) h1 – High 1 (high priority) nc – Network control (high priority)
	Default	be
	Introduced	24.10.R1
	Platforms	All

profile keyword


	Synopsis	QoS profile for transmitted SDP echo request packets
	Context	configure saa owner named-item test named-item type sdp-ping qos profile keyword
	Tree	profile
	Options	in – In profile out – Out of profile
	Default	out
	Introduced	24.10.R1
	Platforms	All

responder-sdp-identifier number


	Synopsis	SDP ID used by the far-end to reply to the request
	Context	configure saa owner named-item test named-item type sdp-ping responder-sdp-identifier number
	Tree	responder-sdp-identifier
	Description	This command configures the return SDP ID to be used by the far-end router for the message reply for round-trip SDP connectivity testing. If this ID does not exist on the far-end router, or terminates on a different router from the originating router, or another issue prevents the far-end router from using this ID, the SDP echo reply is sent using generic IP or GRE OAM encapsulation. The received FC (as mapped on the ingress network interface for the far end) defines the FC encapsulation for the reply message.
	Range	1 to 32767
	Introduced	24.10.R1
	Platforms	All

size number


	Synopsis	Size of the SDP echo request packets
	Context	configure saa owner named-item test named-item type sdp-ping size number
	Tree	size
	Description	This command configures the size of the SDP echo request packets, which includes the SDP header and payload. The size does not include the SDP encapsulation, VC label (if applied), or any DLC headers or trailers.
	Range	72 to 9786
	Units	bytes
	Default	72
	Introduced	24.10.R1
	Platforms	All

timeout number


	Synopsis	Maximum time to wait for SDP echo reply packets
	Context	configure saa owner named-item test named-item type sdp-ping timeout number
	Tree	timeout
	Description	This command configures the time the router waits for a message reply after sending the last probe for a specific test. When the timeout expires, the test is marked complete and no more packets are processed.
	Range	1 to 10
	Units	seconds
	Default	5
	Introduced	24.10.R1
	Platforms	All

trap-generation


	Synopsis	Enter the trap-generation context
	Context	configure saa owner named-item test named-item type sdp-ping trap-generation
	Tree	trap-generation
	Introduced	24.10.R1
	Platforms	All

probe-fail boolean


	Synopsis	Enable the generation of probe fail notifications
	Context	configure saa owner named-item test named-item type sdp-ping trap-generation probe-fail boolean
	Tree	probe-fail
	Description	When configured to true, the system generates an SNMP trap if the consecutive probe failure threshold is reached during the execution of the SAA ping test. This command is not applicable to SAA traceroute tests.
	Default	false
	Introduced	24.10.R1
	Platforms	All

probe-fail-threshold number


	Synopsis	Consecutive probe failure count
	Context	configure saa owner named-item test named-item type sdp-ping trap-generation probe-fail-threshold number
	Tree	probe-fail-threshold
	Description	This command configures the number of consecutive ping probe failures required to generate a trap. This command has no effect if the probe-fail command is set to false. This command is not applicable to SAA traceroute tests.
	Range	0 to 15
	Default	1
	Introduced	24.10.R1
	Platforms	All

test-complete boolean


	Synopsis	Enable generation of test complete notifications
	Context	configure saa owner named-item test named-item type sdp-ping trap-generation test-complete boolean
	Tree	test-complete
	Default	false
	Introduced	24.10.R1
	Platforms	All

test-fail boolean


	Synopsis	Enable the generation of test fail notifications
	Context	configure saa owner named-item test named-item type sdp-ping trap-generation test-fail boolean
	Tree	test-fail
	Description	When configured to true, the system generates a trap if a test fails. In the case of a ping test, the test is considered to have failed (for trap generation) if the number of failed probes is at least the value of the test-fail-threshold setting.
	Default	false
	Introduced	24.10.R1
	Platforms	All

test-fail-threshold number


	Synopsis	Total probe failures for trap generation
	Context	configure saa owner named-item test named-item type sdp-ping trap-generation test-fail-threshold number
	Tree	test-fail-threshold
	Description	This command configures the number of consecutive test failures required to generate a trap. This command has no effect when test-fail is set to false. This command is not applicable to SAA traceroute tests.
	Range	0 to 15
	Default	1
	Introduced	24.10.R1
	Platforms	All

vccv-ping


	Synopsis	Enable the vccv-ping context
	Context	configure saa owner named-item test named-item type vccv-ping
	Tree	vccv-ping
	Description	Commands in this context configure a Virtual Circuit Connectivity Verification (VCCV) ping test. A VCCV-ping test checks connectivity of a VLL inband. It verifies that the destination (target) PE is the egress for the Layer 2 FEC and provides for a cross-check between the data plane and the control plane. Because it is inband, the VCCV-ping message is sent using the same encapsulation and along the same path as user packets in that VLL. The VCCV-ping test is the equivalent of the LSP-ping test for a VLL service. The VCCV-ping test reuses an LSP-ping message format and can be used to test a VLL configured over both an MPLS and a GRE SDP.
	Notes	The following elements are part of a choice: dns, eth-cfm-loopback, icmp-ping, lsp-ping, sdp-ping, or vccv-ping.
	Introduced	23.10.R1
	Platforms	All

count number


	Synopsis	Number of echo request packets to send
	Context	configure saa owner named-item test named-item type vccv-ping count number
	Tree	count
	Range	1 to 100
	Units	packets
	Default	1
	Introduced	23.10.R1
	Platforms	All

interval number


	Synopsis	Interval between packets sent
	Context	configure saa owner named-item test named-item type vccv-ping interval number
	Tree	interval
	Range	1 to 10
	Units	seconds
	Default	1
	Introduced	23.10.R1
	Platforms	All

qos


	Synopsis	Enter the qos context
	Context	configure saa owner named-item test named-item type vccv-ping qos
	Tree	qos
	Introduced	23.10.R1
	Platforms	All

fc keyword


	Synopsis	QoS FC for the sent echo request packets
	Context	configure saa owner named-item test named-item type vccv-ping qos fc keyword
	Tree	fc
	Options	be – Best effort l2 – Low 2 (best effort) af – Assured forwarding (assured) l1 – Low 1 (assured) h2 – High 2 (high priority) ef – Expedited forwarding (high priority) h1 – High 1 (high priority) nc – Network control (high priority)
	Default	be
	Introduced	23.10.R1
	Platforms	All

profile keyword


	Synopsis	QoS profile for the sent echo request packets
	Context	configure saa owner named-item test named-item type vccv-ping qos profile keyword
	Tree	profile
	Options	in – In profile out – Out of profile
	Default	out
	Introduced	23.10.R1
	Platforms	All

size number


	Synopsis	Echo request packet pad size
	Context	configure saa owner named-item test named-item type vccv-ping size number
	Tree	size
	Range	1 to 9786
	Units	bytes
	Default	1
	Introduced	23.10.R1
	Platforms	All

sub-type


	Synopsis	Enter the sub-type context
	Context	configure saa owner named-item test named-item type vccv-ping sub-type
	Tree	sub-type
	Description	Commands in this context configure the FEC type for a remote PW segment targeted by a VCCV-ping echo request.
	Introduced	23.10.R1
	Platforms	All

fec-128


	Synopsis	Enable the fec-128 context
	Context	configure saa owner named-item test named-item type vccv-ping sub-type fec-128
	Tree	fec-128
	Description	Commands in this context configure the FEC-128 sub-type.
	Introduced	23.10.R1
	Platforms	All

pseudowire


	Synopsis	Enable the pseudowire context
	Context	configure saa owner named-item test named-item type vccv-ping sub-type fec-128 pseudowire
	Tree	pseudowire
	Description	Commands in this context configure the PW that is used for performing a VCCV-ping operation.
	Introduced	23.10.R1
	Platforms	All

destination-ip-address ipv4-address


	Synopsis	PW destination IP address
	Context	configure saa owner named-item test named-item type vccv-ping sub-type fec-128 pseudowire destination-ip-address ipv4-address
	Tree	destination-ip-address
	Notes	This element is mandatory.
	Introduced	23.10.R1
	Platforms	All

pw-id number


	Synopsis	PW identifier
	Context	configure saa owner named-item test named-item type vccv-ping sub-type fec-128 pseudowire pw-id number
	Tree	pw-id
	Range	1 to 4294967295
	Notes	This element is mandatory.
	Introduced	23.10.R1
	Platforms	All

source-ip-address ipv4-address


	Synopsis	PW source IP address
	Context	configure saa owner named-item test named-item type vccv-ping sub-type fec-128 pseudowire source-ip-address ipv4-address
	Tree	source-ip-address
	Notes	This element is mandatory.
	Introduced	23.10.R1
	Platforms	All

reply-mode keyword


	Synopsis	In-band or out-of-band reply
	Context	configure saa owner named-item test named-item type vccv-ping sub-type fec-128 reply-mode keyword
	Tree	reply-mode
	Options	ip-routed, control-channel
	Default	control-channel
	Introduced	23.10.R1
	Platforms	All

sdp-bind-id sdp-bind-id


	Synopsis	SDP bind ID to test
	Context	configure saa owner named-item test named-item type vccv-ping sub-type fec-128 sdp-bind-id sdp-bind-id
	Tree	sdp-bind-id
	String length	3 to 16
	Notes	This element is mandatory.
	Introduced	23.10.R1
	Platforms	All

timeout number


	Synopsis	Wait time for a reply after sending an echo request
	Context	configure saa owner named-item test named-item type vccv-ping timeout number
	Tree	timeout
	Range	1 to 10
	Units	seconds
	Default	5
	Introduced	23.10.R1
	Platforms	All

trap-generation


	Synopsis	Enter the trap-generation context
	Context	configure saa owner named-item test named-item type vccv-ping trap-generation
	Tree	trap-generation
	Introduced	23.10.R1
	Platforms	All

probe-fail boolean


	Synopsis	Enable the generation of probe fail notifications
	Context	configure saa owner named-item test named-item type vccv-ping trap-generation probe-fail boolean
	Tree	probe-fail
	Description	When configured to true, the system generates an SNMP trap if the consecutive probe failure threshold is reached during the execution of the SAA ping test. This command is not applicable to SAA traceroute tests.
	Default	false
	Introduced	23.10.R1
	Platforms	All

probe-fail-threshold number


	Synopsis	Consecutive probe failure count
	Context	configure saa owner named-item test named-item type vccv-ping trap-generation probe-fail-threshold number
	Tree	probe-fail-threshold
	Description	This command configures the number of consecutive ping probe failures required to generate a trap. This command has no effect if the probe-fail command is set to false. This command is not applicable to SAA traceroute tests.
	Range	0 to 15
	Default	1
	Introduced	23.10.R1
	Platforms	All

test-complete boolean


	Synopsis	Enable generation of test complete notifications
	Context	configure saa owner named-item test named-item type vccv-ping trap-generation test-complete boolean
	Tree	test-complete
	Default	false
	Introduced	23.10.R1
	Platforms	All

test-fail boolean


	Synopsis	Enable the generation of test fail notifications
	Context	configure saa owner named-item test named-item type vccv-ping trap-generation test-fail boolean
	Tree	test-fail
	Description	When configured to true, the system generates a trap if a test fails. In the case of a ping test, the test is considered to have failed (for trap generation) if the number of failed probes is at least the value of the test-fail-threshold setting.
	Default	false
	Introduced	23.10.R1
	Platforms	All

test-fail-threshold number


	Synopsis	Total probe failures for trap generation
	Context	configure saa owner named-item test named-item type vccv-ping trap-generation test-fail-threshold number
	Tree	test-fail-threshold
	Description	This command configures the number of consecutive test failures required to generate a trap. This command has no effect when test-fail is set to false. This command is not applicable to SAA traceroute tests.
	Range	0 to 15
	Default	1
	Introduced	23.10.R1
	Platforms	All

ttl number


	Synopsis	TTL value for the echo request MPLS label
	Context	configure saa owner named-item test named-item type vccv-ping ttl number
	Tree	ttl
	Range	1 to 255
	Default	1
	Introduced	23.10.R1
	Platforms	All