---
title: "y1564"
slug: "cli-sc-y1564"
updated: 2025-07-03T08:29:22Z
published: 2025-09-03T14:11:33Z
canonical: "docs.crossworkassurance.cisco.com/cli-sc-y1564"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crossworkassurance.cisco.com/llms.txt
> Use this file to discover all available pages before exploring further.

# y1564

## y1564 add test

y1564 add test - Create an instance of Y.1564 test

**Description:** With y1564 add test, you can create a new Y.1564 test and set its parameters.

**Syntax:**

```
  y1564 add test <test-name> {
                {description <string>} |
                {configuration {enable | disable}} |
                {step-duration {1-60} |
                {performance {enable | disable}} |
                {test-duration {1-1440} |
                {parallel {enable | disable}} |
                {port <port-name>} |
                {delay-type {two-way-delay}} |
                {time-sync-mandatory {disable}} |
                {packet-type {layer-2 | layer-3 | l2-accedian | l2-generic}} |
                {dst-ipv4-addr <ip-addr>} |
                {dst-ip-addr <ip-addr>} |
                {destination-port <0-65535>} |
                {source-port <0-65535>} |
                {dscp <0-63>} |
                {dst-mac-addr <mac-addr>} |
                {y1731-level <0-7>}}+
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| description | Short description of the Y.1564 test. |
| configuration | Enable Y.1564 configuration test. |
| step-duration | Duration of each step during the configuration test in seconds. |
| performance | Enable Y.1564 performance test. |
| test-duration | Duration of each step during the performance test in minutes. |
| parallel | Enable Y.1564 parallel service configuration test. |
| port | Name of the port to which to send the test traffic. |
| delay-type | Type of delay measurement, two-way only for the Sensor Control. |
| time-sync-mandatory | Enable time synchronization verification. Only disable supported in the Sensor Control. |
| packet-type | Used to define specific fields in the test packet. |
| dst-ipv4-addr | The IPv4 destination address. |
| dst-ip-addr | The IPv4 or IPv6 destination address. |
| destination-port | The destination port for UDP protocol (0 - 65535). |
| source-port | The source port for UDP protocol (0 - 65535). |
| dscp | The Diff-Serv CodePoint value (0 - 63). |
| dst-mac-addr | This is the Ethernet MAC destination address. |
| y1731-level | Y.1731 Maintenance Entity Group level (0-7). |

## y1564 delete report

y1564 delete report - Delete an instance of Y.1564 test report

**Description:** Delete an instance of Y.1564 test report.

**Syntax:**

```
  y1564 delete report <report-name>

  <report-name> = <string>
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| <report-name> | A unique name to identify an instance of Y.1564 test report. |

## y1564 delete test

y1564 delete test - Delete an instance of Y.1564 test

**Description:** Delete an instance of Y.1564 test.

**Syntax:**

```
  y1564 delete test <test-name>

  <test-name> = <string>
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| <test-name> | A unique name to identify an instance of Y.1564 test. |

## y1564 edit report

y1564 edit report - Change Y.1564 test activation information

**Description:** After a Y.1564 test has completed, the report can be edited to modify or add information such as: name, description, note, technician's name.

**Syntax:**

```
  y1564 edit report <filename> {
                    {description <desc>} |
                    {note <note>} |
                    {technician <tech. name>} |
                    {filename <filename>}}+

  <filename>       - <string> Unique filename associated with the activation.
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| description | <string> Information about test being described. |
| note | <string> Additional Information about test being described. |
| technician | <string> Name of technician executing test. |
| filename | <string> New filename associated with the activation. |

## y1564 edit service

y1564 edit service - Change Y.1564 service configuration

**Description:** With y1564 edit service, you change the configuration of a service under a specific test.

**Syntax:**

```
  y1564 edit service <test-name> <service-id> {
                        {name <service-name>} |
                        {state {enable | disable}} |
                        {policing {enable | disable}} |
                        {step {enable | disable}} |
                        {availability {enable | disable}} |
                        {cir <0 to max-port-speed>} |
                        {cbs <8>} |
                        {eir <0 to max-port-speed>} |
                        {ebs <8>}|
                        {size-type {fixed | emix}} |
                        {packet-size <64 to 10240>} |
                        {sequence-of-sizes <sequence>} |
                        {user-packet-size <64 to 10240>} |
                        {ftd <decimal>} |
                        {ftd-type {max | avg}} |
                        {fdv <decimal>} |
                        {fdv-type {max | avg}} |
                        {flr <exponent>}  |
                        {m-factor <decimal>} |
                        {dst-ipv4-overwrite {enable | disable}} |
                        {dst-ipv4-addr <ip-addr>} |
                        {dst-ip-overwrite {enable | disable}} |
                        {dst-ip-addr <ip-addr>} |
                        {dscp-overwrite {enable | disable}} |
                        {dscp <0-63>} |
                        {dst-mac-addr-overwrite {enable | disable}} |
                        {dst-mac-addr <mac-addr> } |
                        {y1731-level-overwrite {enable | disable}} |
                        {y1731-level <0-7>} |
                        {vlan1-header {enable | disable}} |
                        {vlan1-ethertype {c-vlan | s-vlan | t-vlan}} |
                        {vlan1-priority <0-7>} |
                        {vlan1-id <0-4095>} |
                        {vlan1-cfi <0-1>} |
                        {vlan2-header {enable | disable}} |
                        {vlan2-ethertype {c-vlan | s-vlan | t-vlan}} |
                        {vlan2-priority <0-7>} |
                        {vlan2-cfi <0-1>} |
                        {vlan2-id <0-4095>} |
                        {fe-no-vlan1-check {disable}} |
                        {fe-vlan1-priority-check {disable}} |
                        {fe-vlan1-dei-check {disable}} |
                        {fe-vlan1-id-check {disable}} |
                        {fe-no-vlan2-check {disable}} |
                        {fe-vlan2-priority-check {disable}} |
                        {fe-vlan2-dei-check {disable}} |
                        {fe-vlan2-id-check {disable}} |
                        {fe-vlan1-priority <0-7> {disable}} |
                        {fe-vlan1-dei <0-1> {disable}} |
                        {fe-vlan1-id <0-4095> {disable}} |
                        {fe-vlan2-priority <0-7> {disable}} |
                        {fe-vlan2-dei <0-1> {disable}} |
                        {fe-vlan2-id <0-4095> {disable}} |
                        {fe-dscp-check {disable}} |
                        {fe-dscp <0-63> {disable}}} |
                        {ooo-percentage-state {disable | enable}} |
                        {ooo-percentage <0-100> }}+

  <test-name>  = A unique name used to identify a Y.1564 test in the system.
  <service-id> = A unique id used to identify a service in this test.
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| name | The name of a service. |
| disable \| enable | To enable or disable the field in the check. |
| state | Enable this service for this specific test. |
| policing | Enable policing testing. |
| step | Enable step testing. |
| availability | Enable Availability measurement. |
| cir | Committed information rate in Mbps. |
| cbs | Committed burst size in KiB (1024 bytes), allowed value 8. |
| eir | Excess information rate in Mbps. |
| ebs | Excess burst size in KiB (1024 bytes), allowed value 8. |
| size-type | Packet sizes may be fixed or EMIX. For EMIX, specify the user-defined size and the packet size values. The size of the test packets will follow the sequence based on frame sizes a, b, c, d, e, f, g, and u, where: a=64Bytes; b=128Bytes; c=256Bytes; d=512Bytes; e=1024Bytes; f=1280Bytes; g=1518Bytes; u is the user-defined size. |
| packet-size | Specify packet size when size-type is "fixed". Maximum packet size is 10240. |
| sequence-of-sizes | Specify the sequence of packet sizes for the test. |
| user-packet-size | For a user-defined packet, specify the packet size. |
| ftd | Maximum/average two-way Frame Transfer Delay (FTD) allowed (in micro-seconds). |
| ftd-type | Determines whether the Frame Transfer Delay (FTD) parameter is a maximum or average value. |
| fdv | Maximum/average two-way Frame Delay Variation (FDV) allowed (in micro-seconds). |
| fdv-type | Determines whether the Frame Delay Variation (FDV) parameter is a maximum or average value. |
| flr | Maximum Frame Loss Ratio (FLR) allowed. |
| m-factor | The M factor is added to the Service Acceptance Criteria in the policing test to take into account the effect of the CBS and EBS on the total rate. The policing test will pass if IR-T=<CIR+EIR+M Where: IR-T: Total Information Rate CIR: Committed Information Rate EIR: Excess Information Rate M: M factor (default value = 1 Mbps). |
| dst-ipv4-overwrite | Overwrite the test IPv4 address with the service address. |
| dst-ipv4-addr | The IPv4 destination address. |
| dst-ip-overwrite | Overwrite the test IPv4 or IPv6 address with the service address. |
| dst-ip-addr | The IPv4 or IPv6 destination address. |
| dscp-overwrite | Overwrite the test DSCP value with the service value. |
| dscp | The Diff-Serv CodePoint value (0 - 63). |
| mac-addr-overwrite | Enable/Disable the overwrite of the test destination MAC address. |
| mac-addr | The destination MAC address to overwrite. |
| y1731-level-overwrite | Enable/Disable the overwrite of the Y.1731 MEG level. |
| y1731-level | Y.1731 MEG level value to overwrite. |
| vlan1-header | Enable the presence of the first VLAN header. |
| vlan1-ethertype | First VLAN protocol ID set to c-vlan (0x8100) for 802.1Q network, t-vlan (0x9100) for 802.1Q tunneling network, or s-vlan (0x88A8) for 802.1AD network. |
| vlan1-cfi | First VLAN CFI/DEI may be 0 or 1. It is usually set to 0. |
| vlan1-id | First VLAN ID may be any value between 0 and 4095. |
| vlan1-priority | First VLAN priority can be between 0 and 7, 7 being the highest priority. Normal traffic has priority 0. |
| vlan2-header | Enable the presence of the second VLAN header. |
| vlan2-ethertype | Second VLAN protocol ID set to c-vlan (0x8100) for 802.1Q network, t-vlan (0x9100) for 802.1Q tunneling network, or s-vlan (0x88A8) for 802.1AD network. |
| vlan2-cfi | Second VLAN CFI/DEI may be 0 or 1. It is usually set to 0. |
| vlan2-id | Second VLAN ID may be any value between 0 and 4095. |
| vlan2-priority | Second VLAN priority can be between 0 and 7, 7 being the highest priority. Normal traffic has priority 0. |
| fe-no-vlan1-check | Only disable supported in Sensor Control. |
| fe-vlan1-priority-check | Only disable supported in Sensor Control. |
| fe-vlan1-dei-check | Only disable supported in Sensor Control. |
| fe-vlan1-id-check | Only disable supported in Sensor Control. |
| fe-no-vlan2-check | Only disable supported in Sensor Control. |
| fe-vlan2-priority-check | Only disable supported in Sensor Control. |
| fe-vlan2-dei-check | Only disable supported in Sensor Control. |
| fe-vlan2-id-check | Only disable supported in Sensor Control. |
| fe-vlan1-priority | Only disable supported in Sensor Control. |
| fe-vlan1-dei | Only disable supported in Sensor Control. |
| fe-vlan1-id | Only disable supported in Sensor Control. |
| fe-vlan2-priority | Only disable supported in Sensor Control. |
| fe-vlan2-dei | Only disable supported in Sensor Control. |
| fe-vlan2-id | Only disable supported in Sensor Control. |
| fe-dscp-check | Only disable supported in Sensor Control. |
| fe-dscp | Only disable supported in Sensor Control. |
| ooo-percentage-state | Enable the Out-Of-Order Percentage Service Acceptance Criteria. |
| ooo-percentage | Maximum Out-Of-Order Percentage allowed. |

## y1564 edit test

y1564 edit test - Change an Y.1564 test configuration

**Description:** With y1564 edit test, you can change the parameters of an existing test.

**Syntax:**

```
  y1564 edit test <test-name> {
                {name <test-name>} |
                {description <string>} |
                {configuration {enable | disable}} |
                {step-duration {1-60} |
                {performance {enable | disable}} |
                {test-duration {1-1440} |
                {parallel {enable | disable}} |
                {port <port-name>} |
                {delay-type {two-way-delay}} |
                {time-sync-mandatory {disable}} |
                {packet-type {layer-2 | layer-3 | l2-accedian | l2-generic}} |
                {dst-ipv4-addr <ip-addr>} |
                {dst-ip-addr <ip-addr>} |
                {destination-port <0-65535>} |
                {source-port <0-65535>} |
                {dscp <0-63>} |
                {dst-mac-addr <mac-addr>} |
                {y1731-level <0-7>}}+
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| name | The name of the test. |
| description | Short description of the Y.1564 test. |
| configuration | Enable Y.1564 configuration test. |
| step-duration | Duration of each step during the configuration test in seconds. |
| performance | Enable Y.1564 performance test. |
| test-duration | Duration of each step during the performance test in minutes. |
| parallel | Enable Y.1564 parallel service configuration test. |
| port | Name of the port to which to send the test traffic. |
| delay-type | Type of delay measurement, two-way only for the Sensor Control. |
| time-sync-mandatory | Enable time synchronization verification. Only disable supported in the Sensor Control. |
| packet-type | Used to define specific fields in the test packet. |
| dst-ipv4-addr | The IPv4 destination address. |
| dst-ip-addr | The IPv4 or IPv6 destination address. |
| destination-port | The destination port for UDP protocol (0 - 65535). |
| source-port | The source port for UDP protocol (0 - 65535). |
| dscp | The Diff-Serv CodePoint value (0 - 63). |
| dst-mac-addr | This is the Ethernet MAC destination address. |
| y1731-level | Y.1731 Maintenance Entity Group level (0-7). |

## y1564 generate report

y1564 generate report - Generate a Y.1564 report file

**Description:** This command allows you to generate a Y.1564 test report.

**Syntax:**

```
  y1564 generate report <filename> [report-type {report-type-txt |
                                                 report-type-xml}]
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| filename | <string> Unique filename associated with the report. |
| report-type | Report type (XML, TXT) to generate. |

## y1564 show activation

y1564 show activation - Show the Y.1564 test activation

**Description:** This command displays the Y.1564 test activation. i.e. its name, status and description. If a specific test name is specified, a full test activation will be displayed (name, status, service name, and progression of each test step).

**Syntax:**

```
  y1564 show activation <filename>
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| <filename> | <string> Unique filename associated with the activation. |

## y1564 show service configuration

y1564 show service configuration - Show Y.1564 service configuration

**Description:** The command displays the configuration for a specific service.

**Syntax:**

```
  y1564 show service configuration <test-name> <service-id>
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| <test-name> | A unique name used to identify a Y.1564 in the system. |
| <service-id> | A unique id used to identify a service in this test. |

## y1564 show test configuration

y1564 show test configuration - Show Y.1564 test configuration

**Description:** This command displays the Y.1564 test configuration. Specifying a test name provides detailed configuration about this test. Otherwise, the command provides a summary of the configured test.

**Syntax:**

```
  y1564 show test configuration <test-name>
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| <test-name> | <string> Name of the specific test to display the configuration. |

## y1564 start activation

y1564 start activation - Starts a Y.1564 test

**Description:** This command starts the specified Y.1564 test and creates a new report.

**Syntax:**

```
  y1564 start activation filename <filename> test <report-test>
                                             { {description <report-desc>} |
                                               {technician <report-tech>} |
                                               {note <report-note>} }+
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| filename | <string> Unique filename for the report. |
| test | <string> Name for the Y.1564 test to run. |
| description | <string> Description for this report. |
| technician | <string> Name of the technician running this test. |
| note | <string> Note associated to this test. This note will be included in the report. |

## y1564 stop activation

y1564 stop activation - Stop a Y.1564 test

**Description:** This command stops the execution of the specified test.

**Syntax:**

```
  y1564 stop activation <filename>
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| filename | <string> Unique filename where the report will be stored. |

## y1564 upload report

y1564 upload report - Upload a Y.1564 report file

**Description:** This command allows to upload a Y.1564 test report to a remote location.

**Syntax:**

```
  y1564 upload report <filename> <url> [report-type {report-type-txt |
                                                     report-type-xml}]
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| filename | <string> Unique filename associated with the report. |
| url | URL to reach the server and directory, e.g. - `ftp://username:password@mypc.com` - `sftp://username:password@192.168.10.10` - `tftp://192.168.1.5` - `scp://username:password@192.168.10.10:/target_directory` The filename of the report will be automatically appended to the specified URL. The URL host subcomponent consists of a name or an IP address. IPv4 addresses must be in dot-decimal notation, and IPv6 addresses must be enclosed in brackets ([]). |
| report-type | Report type (XML, TXT) to upload to server. |

**© 2026 Cisco and/or its affiliates. All rights reserved.** For more information about trademarks, please visit: [Cisco trademarks](https://www.cisco.com/c/en/us/about/legal/trademarks.html)[](https://www.cisco.com/c/en/us/about/legal/trademarks.html) For more information about legal terms, please visit: [Cisco legal terms](https://www.cisco.com/c/en/us/about/legal/terms-conditions.html)