About the PCLI
The PCLI (an acronym for Programmable Command Line Interface) is one of the two primary human interfaces on the 128T router; this document will use the terms PCLI and CLI interchangeably. This document describes the set of PCLI commands supported by the 128T router. Each command listed below will show all mandatory and optional arguments, representative output from the PCLI where applicable, and version history.
Note that all of the examples in this document will be run as the admin role (as denoted by the prompt in this and other examples); however, each command will also indicate which user roles – either user or admin at the time of this writing – are eligible to run the command based upon that command's privileges. Note that unprivileged user accounts will not only be unable to execute these commands, they will not "see" them in the PCLI as part of the help text, etc.
Optional arguments are written in brackets (
]), and users may include or omit them as needed. Variable arguments (where users need to supply a value, rather than entering in the literal string shown in the syntax) are written in angle brackets (
In this example, a user may include core information1. If including core, the user must supply the literal string "core" and a value for the core, such as "0".
Braces, brackets, and pipes are often combined and nested to describe the complete grammar of the command line syntax for any given command.
The PCLI Prompt
The PCLI will indicate that there are uncommitted configuration changes via a change to the prompt. When uncommitted changes exist, the prompt is prefixed with an asterisk ("*"):
Cisco CLI implements
<ctrl>+z, which is a shortcut for
<ctrl>+z on the 128T is an improvement over Cisco's CLI and is the equivalent to the following two actions:
<enter>execute whatever is currently on the prompt line (if any)
top<enter>exit the current menu and go to the root of the PCLI tree
When the buffer is empty:
With a valid command
With an invalid command
! (run previous command)
! can be used to execute a previously executed command from the PCLI's history.
PCLI history can be seen by running
! command offers three options:
- !! to re-run the last command run
- !<number> to re-run a specific command from the PCLI history. Negative numbers are supported to perform a reverse search of the history. (i.e.,
- !<string> to re-run the most recent substring match from the PCLI history (reverse search of history).
When working across multiple systems, it is convenient to cut-and-paste snippets of one configuration and paste it directly into another 128T router. The PCLI detects configuration entered in bulk and accepts input in either
show config native format or flat format. Invalid configuration is handled in the same fashion as it would be as if it were entered line by line.
An example of copying a service from one system and pasting it to another can be seen below.
- forwarding plan metrics are stored uniquely per worker