CLI usage

This chapter provides information about using the command-line interface (CLI).

CLI structure

The Nokia Operating System (OS) CLI is a command-driven interface accessible through the console, Telnet, and secure shell (SSH). The CLI can be used for configuration and management of routers.

The CLI command tree is a hierarchical inverted tree. At the highest level is the ROOT level. Below this level are other tree levels with the major command groups; for example, configuration commands and show commands are levels below ROOT.

The CLI is organized so related commands with the same scope are at the same level or in the same context. Sublevels or subcontexts have related commands with a more refined scope.

The following figures show the major contexts for router configuration. The figures are sample representations of high-level commands; not all commands are included.

Navigating in the CLI

The following sections describe additional navigational and syntax information.

CLI contexts

Use the CLI to access, configure, and manage Nokia 7210 SAS devices. CLI commands are entered at the command line prompt. Access to specific CLI commands is controlled by the permissions set by your system administrator. Entering a CLI command makes navigation possible from one command context (or level) to another.

When you initially enter a CLI session, you are in the ROOT context. Navigate to another level by entering the name of successively lower contexts. For example, enter either the configure or show commands at the ROOT context to navigate to the config or show context, respectively. For example, at the command prompt, enter config. The active context displays in the command prompt.

A:ALU-7210# config
A:ALU-7210>config#

In a CLI context, you can enter commands at that context level by entering the text. It is also possible to include a command in a lower context as long as the command is formatted in the correct command and parameter syntax.

The following examples show two methods to navigate to a service SAP ingress level.

Method 1

A:ALU-7210# config service epipe 6 sap 1/1/2 ingress

Method 2

A:ALU-7210# configure
A:ALU-7210>config# service
A:ALU-7210>config>service# epipe 6
A:ALU-7210>config>service>epipe# sap 1/1/2
A:ALU-7210>config>service>epipe>sap# ingress
A:ALU-7210>config>service>epipe>sap>ingress#

The CLI returns an error message when the syntax is incorrect.

A:ALU-7210>config>service>epipe# sapp
                                 ^
Error: Bad command.
A:ALU-7210>config>service>epipe#

Basic CLI commands

The console control commands are the commands that are used for navigating within the CLI and displaying information about the console session. Most of these commands are implemented as global commands. They can be entered at any level in the CLI hierarchy with the exception of the password command which must be entered at the ROOT level. The following table describes the console control commands.

Table 1. Console control commands
Command	Description
<Ctrl-c>	Aborts the pending command.
<Ctrl-z>	Terminates the pending command line and returns to the ROOT context.
back	Navigates the user to the parent context.
clear	Clears statistics for a specified entity or clears and resets the entity.
echo	Echos the text that is typed in. Primary use is to display messages to the screen within an exec file.
exec	Executes the contents of a text file as if they were CLI commands entered at the console.
exit	Returns the user to the previous higher context.
exit all	Returns the user to the ROOT context.
help ?	Displays help in the CLI.
history	Displays a list of the most recently entered commands.
info	Displays the running configuration for a configuration context.
logout	Terminates the CLI session.
oam	Provides OAM test suite options. See ‟OAM and SAA” in the 7210 SAS-D, Dxp, K 2F1C2T, K 2F6C4T, K 3SFP+ 8C OAM and Diagnostics Guide for more information about OAM test suite options.
password	Changes the user CLI login password. The password can only be changed at the ROOT level.
ping	Verifies the reachability of a remote host.
pwc	Displays the present or previous working context of the CLI session.
sleep	Causes the console session to pause operation (sleep) for one second or for the specified number of seconds. Primary use is to introduce a pause within the execution of an exec file.
ssh	Opens a secure shell connection to a host.
telnet	Telnet to a host.
traceroute	Determines the route to a destination address.
tree	Displays a list of all commands at the current level and all sublevels.
write	Sends a console message to a specific user or to all users with active console sessions.

The list of all system global commands is displayed by entering help globals in the CLI. For example:

A:ALU-7210>config>service# help globals
      back            - Go back a level in the command tree
      echo            - Echo the text that is typed in
      enable-admin    - Enable the user to become a system administrator
      exec            - Execute a file - use -echo to show the commands and
                        prompts on the screen
      exit            - Exit to intermediate mode - use option all to exit to
                        root prompt
      help            - Display help
      history         - Show command history
      info            - Display configuration for the present node
      logout          - Log off this system
      oam             + OAM Test Suite
      ping            - Verify the reachability of a remote host
      pwc             - Show the present working context
      sleep           - Sleep for specified number of seconds
      ssh             - SSH to a host
      telnet          - Telnet to a host
      traceroute      - Determine the route to a destination address
      tree            - Display command tree structure from the context of
                        execution
      write           - Write text to another user
A:ALU-7210>config>service#

The following table describes command syntax symbols.

Table 2. Command syntax symbols
Symbol	Description
\|	A vertical line indicates that one of the parameters within the brackets or braces is required. tcp-ack {true \| false}
[ ]	Brackets indicate optional parameters. redirects [number seconds]
< >	Angle brackets in the CLI indicate that you must enter text based on the parameter inside the brackets (in the 7210 SAS manuals, italics are used to indicate the same rule. interface <`interface-name`>
{ }	Braces indicate that one of the parameters must be selected. default-action {drop \| forward}
[{ }]	Braces within square brackets indicates that you must choose one of the optional parameters. sdp `sdp-id` [{mpls}] vpls `service-id` [svc-sap-type {null-star\|dot1q\|dot1q-preserve}]
Bold	Commands in bold indicate commands and keywords.
Italic	In the 7210 SAS manuals, commands in italics indicate parameters that you must enter a value for.

CLI environment commands

The CLI environment commands are found in the root>environment context of the CLI tree and control session preferences for a single CLI session. The following table describes the CLI environment commands.

Table 3. CLI environment commands
Command	Description
alias	Enables the substitution of a command line by an alias.
create	Enables or disables the use of a create parameter check.
more	Configures whether CLI output should be displayed one screen at a time awaiting user input to continue.
reduced-prompt	Configures the maximum number of higher-level CLI context nodes to display by name in the CLI prompt for the current CLI session.
saved-ind-prompt	Saves the indicator in the prompt.
terminal	Configures the terminal screen length for the current CLI session.
time-display	Specifies whether time should be displayed in local time or UTC.

CLI monitor commands

Monitor commands display specified statistical information related to the monitor subject (such as filter, port, QoS, router, service) at a configurable interval until a count is reached. The CLI monitor commands are found in the root>monitor context of the CLI tree.

The monitor command output displays a snapshot of the current statistics. The output display refreshes with subsequent statistical information at each configured interval and is displayed as a delta to the previous display.

The <Ctrl-c> keystroke interrupts a monitoring process. Monitor command configurations cannot be saved. You must enter the command for each monitoring session. Note that if the maximum limits are configured, you can monitor the statistical information for a maximum of 60 * 999 sec ~ 1000 minutes.

The following table describes the CLI monitor command contexts.

Table 4. CLI monitor command contexts
Command	Description
filter	Enables IP, IPv6, and MAC filter monitoring at a configurable interval until that count is reached.
lag	Enables Link Aggregation Group (LAG) monitoring to display statistics for individual port members and the LAG.
port	Enables port traffic monitoring. The specified ports statistical information displays at the configured interval until the configured count is reached.
service	Monitors commands for a particular service.

Getting help in the CLI

The help system commands and the ? key display different types of help in the CLI. The following table describes the different help commands.

Table 5. Online help commands
Command	Description
help ?	List all commands in the current context.
string ?	List all commands available in the current context that start with `string`.
command ?	Displays the command syntax and associated keywords.
command keyword ?	List the associated arguments for keyword in command.
string<Tab>	Complete a partial command name (auto-completion) or list available commands that match `string`.

The tree and tree detail system commands are help commands useful when searching for a command in a lower-level context.

The following example shows a partial list of the tree and tree detail command output entered at the config level.

A:ALU-7210>config# tree
configure
+---card
|   +---card-type
|   +---mda
|   |   +---access
|   |   +---mda-type
|   |   +---network
|   |   +---shutdown
|   +---shutdown
+---cron
|   +---action
|   |   +---expire-time
|   |   +---lifetime
|   |   +---max-completed
|   |   +---results
|   |   +---script
|   |   +---shutdown
|   +---schedule
|   |   +---action
|   |   +---count
|   |   +---day-of-month
|   |   +---description
|   |   +---end-time
|   |   +---hour
|   |   +---interval
|   |   +---minute
|   |   +---month
|   |   +---shutdown
|   |   +---type
|   |   +---weekday
|   +---script
|   |   +---description
|   |   +---location
|   |   +---shutdown
|   +---time-range
|   |   +---absolute
|   |   +---daily
|   |   +---description
|   |   +---weekdays
|   |   +---weekend
|   |   +---weekly
|   +---tod-suite
|   |   +---description
|   |   +---egress
|   |   |   +---filter
|   |   |   +---qos
|   |   |   +---scheduler-policy
|   |   +---ingress
|   |   |   +---filter
|   |   |   +---qos
|   |   |   +---scheduler-policy
+---dot1ag
|   +---domain
|   |   +---association
|...

*A:ALA-12>config# tree detail
configure
+---card <slot-number>
|   no card <slot-number>
|   +---card-type <card-type>
|   |   no card-type
|   +---mda <mda-slot>
|   |   no mda <mda-slot>
|   |   +---access
|   |   +---mda-type <mda-type>
|   |   |   no mda-type
|   |   +---network
|   |   +---no shutdown
|   |   |   shutdown
|   +---no shutdown
|   |   shutdown
+---cron
|   +---action <action-name> [owner <action-owner>]
|   |   no action <action-name> [owner <action-owner>]
|   |   +---expire-time {<seconds>|forever}
|   |   +---lifetime {<seconds>|forever}
|   |   +---max-completed <unsigned>
|   |   +---no results
|   |   |   results <file-url>
|   |   +---no script
|   |   |   script <script-name> [owner <script-owner>]
|   |   +---no shutdown
|   |   |   shutdown
|   +---no schedule <schedule-name> [owner <schedule-owner>]
|   |   schedule <schedule-name> [owner <schedule-owner>]
|   |   +---action <action-name> [owner <action-owner>]
|   |   |   no action
|   |   +---count <number>
|   |   |   no count
|   |   +---day-of-month {<day-number> [..<day-number>]|all}
|   |   |   no day-of-month
|   |   +---description <description-string>
|   |   |   no description
|   |   +---end-time [<date>|<day-name>] <time>
|   |   |   no end-time
|   |   +---hour {<hour-number> [..<hour-number>]|all}
|   |   |   no hour
|   |   +---interval <seconds>
|   |   |   no interval
| |   +---minute {<minute-number> [..<minute-number>]|all}
|   |   |   no minute
|   |   +---month {<month-number> [..<month-number>]|<month-name> [..<month-nam>]|all}
|   |   |   no month
|   |   +---no shutdown
|   |   |   shutdown
|   |   +---type <schedule-type>
|   |   +---weekday {<weekday-number> [..<weekday-number>]|<day-name> [..<day-nme>]|all}
|...

The CLI command prompt

By default, the CLI command prompt indicates the device being accessed and the current CLI context. For example, the prompt: A:ALA-1>config>router>if# indicates the active context, the user is on the device with hostname ALA-1 in the configure>router>interface context. In the prompt, the separator used between contexts is the ‟>” symbol.

At the end of the prompt, there is either a pound sign (‟#”) or a dollar sign (‟$”). A ‟#” at the end of the prompt indicates the context is an existing context. A ‟$” at the end of the prompt indicates the context has been newly created. New contexts are newly created for logical entities when the user first navigates into the context.

Because there can be a large number of sublevels in the CLI, the environment command reduced-prompt no of nodes in prompt allows the user to control the number of levels displayed in the prompt.

All special characters (#, $, and so on) must be enclosed within double quotes, otherwise it is seen as a comment character and all characters on the command line following the # are ignored.

*A:ALU-7210>config>router# interface "primary#1"

When changes are made to the configuration file a ‟*” appears in the prompt string (*A:ALU-7210) indicating that the changes have not been saved. When an admin save command is executed the ‟*” disappears. This behavior is controlled in the saved-ind-prompt command in the environment context.

Displaying configuration contexts

The info and info detail commands display configuration for the current level. The info command displays non-default configurations. The info detail command displays the entire configuration for the current level, including defaults.

The following example shows the output that displays using the info command and the output that displays using the info detail command.

*A:ALA>config>service>vpls# info 
----------------------------------------------
            stp
                shutdown
            exit
            sap 1/1/14:100 create
            exit
            sap 1/1/15:100 create
            exit
            no shutdown
----------------------------------------------
*A:ALA>config>service>vpls# info detail 
----------------------------------------------
            no description
            no disable-learning
            no disable-aging
            no discard-unknown
            fdb-table-size 250
            fdb-table-high-wmark 95
            fdb-table-low-wmark 90
            local-age 300
            stp
                shutdown
                priority 32768
                hello-time 2
                forward-delay 15
                max-age 20
                hold-count 6
                mode rstp
            exit
            mac-move
                move-frequency 2
                retry-timeout 10
                shutdown
            exit                      
            sap 1/1/14:100 create
                no description
                no tod-suite
                limit-mac-move blockable
                no disable-aging
                no max-nbr-mac-addr
                no discard-unknown-source
                no mac-pinning
                stp
                    path-cost 10
                    priority 128
                    no edge-port
                    auto-edge
                    link-type pt-pt
                    no root-guard
                    no shutdown
                exit
                dot1ag
                exit
                no authentication-policy
                no l2pt-termination
                no bpdu-translation 
                ingress               
                    qos 1 
                    no match-qinq-dot1p
                    no filter
                exit
                egress
                    no qinq-mark-top-only
                    no filter
                    no agg-rate-limit
                exit
                no collect-stats
                no accounting-policy
                no shutdown
            exit
            sap 1/1/15:100 create
                no description
                no tod-suite
                limit-mac-move blockable
                no disable-aging
                no max-nbr-mac-addr
                no discard-unknown-source
                no mac-pinning
                stp
                    path-cost 10      
                    priority 128
                    no edge-port
                    auto-edge
                    link-type pt-pt
                    no root-guard
                    no shutdown
                exit
                dot1ag
                exit
                no authentication-policy
                no l2pt-termination
                no bpdu-translation 
                ingress
                    qos 1 
                    no match-qinq-dot1p
                    no filter
                exit
                egress
                    no qinq-mark-top-only
                    no filter
                    no agg-rate-limit
                exit
                no collect-stats      
                no accounting-policy
                no shutdown
            exit

EXEC files

The exec command allows you to execute a text file of CLI commands as if it were typed at a console device.

The exec command and the associated exec files can be used to conveniently execute a number of commands that are always executed together in the same order. For example, an exec command can be used by a user to define a set of commonly used standard command aliases.

The echo command can be used within an exec command file to display messages on screen while the file executes.

Entering CLI commands

This section provides information about entering CLI commands and parameters.

Command completion

The CLI supports both command abbreviation and command completion. If the keystrokes entered are enough to match a valid command, the CLI displays the remainder of the command syntax when the <Tab> key or space bar is pressed. When typing a command, the <Tab> key or space bar invokes auto-completion. If the keystrokes entered are definite, auto-completion completes the command. If the letters are not sufficient to identify a specific command, pressing the <Tab> key or space bar displays commands matching the letters entered. System commands are available in all CLI context levels.

Unordered parameters

In a context, the CLI accepts command parameters in any order as long as the command is formatted in the correct command keyword and parameter syntax. Command completion works as long as enough recognizable characters of the command are entered.

The following output shows different static-route command syntax and an example of the command usage.

*A:ALA-1>config>router# static-route 
  - [no] static-route {<ip-prefix/prefix-length>|<ip-prefix> <netmask>}
    [preference <preference>] [metric <metric>] [enable|disable] next-hop
    <gateway>
  - [no] static-route {<ip-prefix/prefix-length>|<ip-prefix> <netmask>}
    [preference <preference>] [metric <metric>] [enable|disable] black-hole

Editing keystrokes

When entering a command, special keystrokes allow for editing of the command. The following table describes the command editing keystrokes.

Table 6. Command editing keystrokes
Editing action	Keystrokes
Delete current character	<Ctrl-d>
Delete text up to cursor	<Ctrl-u>
Delete text after cursor	<Ctrl-k>
Move to beginning of line	<Ctrl-a>
Move to end of line	<Ctrl-e>
Get prior command from history	<Ctrl-p>
Get next command from history	<Ctrl-n>
Move cursor left	<Ctrl-b>
Move cursor right	<Ctrl-f>
Move back one word	<Esc><b>
Move forward one word	<Esc><f>
Convert rest of word to uppercase	<Esc><c>
Convert rest of word to lowercase	<Esc><l>
Delete remainder of word	<Esc><d>
Delete word up to cursor	<Ctrl-w>
Transpose current and previous character	<Ctrl-t>
Enter command and return to root prompt	<Ctrl-z>
Refresh input line	<Ctrl-l>

Absolute paths

CLI commands can be executed in any context by specifying the full path from the CLI root. To execute an out-of-context command, enter a forward slash ‟/” or backward slash ‟\” at the beginning of the command line. The forward slash ‟/” or backward slash ‟\” cannot be used with the environment alias command. The commands are interpreted as absolute path. Spaces between the slash and the first command return an error. Commands that are already global (such as ping, telnet, exit, back, and so on) cannot be executed with a forward slash ‟/” or backward slash ‟\” at the beginning of the command line.

*A:ALA-12# configure router 
*A:ALA-12>config>router# interface system address 1.2.3.4 
*A:ALA-12>config>router# /admin save 
*A:ALA-12>config>router# \clear router interface 
*A:ALA-12>config>router#

The command may or may not change the current context depending on whether it is a leaf command.

This is the same behavior the CLI performs when CLI commands are entered individually, as shown in the following example.

*A:ALA-12# admin 
*A:ALA-12>admin# save

*A:ALA-12# admin save
*A:ALA-12#

An absolute path command behaves the same as manually entering a series of command line instructions and parameters.

Beginning in an IES context service ID 4 (IES 4)

config>service>ies> /clear card 1

behaves the same as the following series of commands.

config>service>ies>exit all
    clear card 1
    configure service ies 4 (returns you to your starting point)
    config>service>ies

If the command takes you to a different context, the following occurs:

config>service>ies>/configure service ies 5 create

becomes

config>service>ies>exit all
    configure service vpls 5 create
    config>service>vpls

History

The CLI maintains a history of the most recently entered commands. The history command displays the most recently entered CLI commands.

*A:ALA-1# history 
   1 environment terminal length 48 
   2 environment no create 
   3 show version 
   4 configure port 1/1/1 
   5 info 
   6 \configure router isis 
   7 \port 1/1/1
   8 con port 1/1/1
   9 \con port 1/1/1
  10 \configure router bgp 
  11 info 
  12 \configure system login-control 
  13 info 
  14 history 
  15 show version 
  16 history 
*A:ALA-1# !3
A:cses-E11#  show version
TiMOS-B-0.0.I2838 both/i386 NOKIA SR 7750 Copyright (c) 2016 Nokia.
All rights reserved. All use subject to applicable license agreements.
Built on Mon Jan 10 18:33:16 PST 2016 by builder in /rel0.0/I2838/panos/main
A:cses-E11#
TiMOS-B-0.0.I232 both/i386 NOKIA SAS-D 7210 Copyright (c) 2016 Nokia.
All rights reserved. All use subject to applicable license agreements.
Built on Sat Oct 11 18:15:40 IST 2016 by panosbld in /panosbld/ws/panos/main
*A:ALU-7210#

Entering numerical ranges

The 7210 SAS CLI allows the use of a single numerical range as an argument in the command line. A range in a CLI command is limited to positive integers and is denoted with two numbers enclosed in square brackets with two periods (‟..”) between the numbers:

[x..y]

where x and y are positive integers and y-x is less than 1000.

For example, it is possible to shut down ports 1 through 10 in Slot 1 on MDA 1. A port is denoted with slot/mda/port, where slot is the slot number, mda is the MDA number and, port is the port number. To shut down ports 1 through 10 on Slot 1 and MDA 1, the command is entered as follows:

configure port 1/1/[1..10] shutdown

<Ctrl-C> can be used to abort the execution of a range command.

The following table describes CLI range use limitations.

Table 7. CLI range use limitations
Limitation	Description
Only a single range can be specified.	It is not possible to shut down ports 1 through 10 on MDA 1 and MDA 2, as the command would look like configure port 1/[1..2]/[1..10] and requires two ranges in the command, [1..2] for the MDA and [1..10] for the port number.
Ranges within quotation marks are interpreted literally.	In the CLI, enclosing a string in quotation marks (‟string”) causes the string to be treated literally and as a single parameter. For example, several commands in the CLI allow the configuration of a descriptive string. If the string is more than one word and includes spaces, it must be enclosed in quotation marks. A range that is enclosed in quotes is also treated literally. For example, configure router interface "A[1..10]" no shutdown creates a single router interface with the name ‟A[1..10]”. However, a command such as: configure router interface A[1..10] no shutdown creates 10 interfaces with names A1, A2 .. A10.
The range cannot cause a change in contexts.	Commands should be formed in such a way that there is no context change upon command completion. For example, configure port 1/1/[1..10] attempts to change ten different contexts. When a range is specified in the CLI, the commands are executed in a loop. On the first loop execution, the command changes contexts, but the new context is no longer valid for the second iteration of the range loop. A ‟Bad Command” error is reported and the command aborts.
Command completion may cease to work when entering a range.	After entering a range in a CLI command, command and key completion, which occurs by pressing the <Tab> or spacebar, may cease to work. If the command line entered is correct and unambiguous, the command works correctly; otherwise, an error is returned.

Pipe/match

The 7210 SAS devices support the pipe feature to search one or more files for a specific character string or pattern.

When using the pipe/match command, the variables and attributes must be spelled correctly. The attributes follow the command and must come before the expression/pattern. The following displays examples of the pipe/match command to complete different tasks:

Task: Capture all the lines that include ‟echo” and redirect the output to a file on the compact flash:

admin display-config | match ‟echo” > cf3cf1:\echo_list.txt
Task: Display all the lines that do not include ‟echo”:

admin display-config | match invert-match ‟echo”
Task: Display the first match of ‟vpls” in the configuration file:

admin display-config | match max-count 1 ‟vpls”
Task: Display everything in the configuration after finding the first instance of ‟interface”:

admin display-config | match post-lines 999999 interface

Command syntax:

match pattern context {parents | children | all} [ignore-case] [max-count lines-count] [expression]

match pattern [ignore-case] [invert-match] [pre-lines pre-lines] [post-lines lines-count] [max-count lines-count] [expression]

where:

pattern         string or regular expression
context         keyword:  display context associated with the matching line
parents         keyword:  display parent context information
children        keyword:  display child context information
all             keyword:  display both parent and child context information
ignore-case     keyword
max-count       keyword:  display only a specific number of instances of 
                matching lines
lines-count     1 — 2147483647
expression      keyword:  pattern is interpreted as a regular expression
invert-match    keyword
pre-lines       keyword:  display some lines prior to the matching line
pre-lines       0 — 100
post-lines      keyword:  display some lines after the matching line
lines-count     1 — 2147483647

For example:

*A:Dut-G# show log log-id 99 | match ignore-case sap
"Processing of an access port state change event is finished and the status of all a
ffected SAPs on port 1/1/21 has been updated."
"Service Id 4001, SAP Id 1/1/21:0.* configuration modified"


A:Dut-C# show log log-id 98 | match max-count 1 "service 1001"
"Status of service 1001 (customer 1) changed to administrative state: up, operationa
l state: up"

*A:Dut-G# admin display-config | match post-lines 4 max-count 2 expression "vpls"
#--------------------------------------------------
...
        vpls 1 customer 1 svc-sap-type null-star create
            description "Default tls description for service id 1"
            stp
                shutdown
            exit
        vpls 2 customer 1 svc-sap-type null-star create
            description "Default tls description for service id 2"
            stp
                shutdown
            exit
...
#--------------------------------------------------

The following table describes regular expression symbols and interpretation (similar to what is used for route policy regexp matching). The following table describes special characters.

Table 8. Regular expression symbols
String	Description
.	Matches any single character.
[ ]	Matches a single character that is contained within the brackets. [abc] matches ‟a”, ‟b”, or ‟c”. [a-z] matches any lowercase letter. [A-Z] matches any uppercase letter. [0-9] matches any number.
[^ ]	Matches a single character that is not contained within the brackets. [^abc] matches any character other than ‟a”, ‟b”, or ‟c”. [^a-z] matches any single character that is not a lowercase letter.
^	Matches the start of the line (or any line, when applied in multiline mode).
$	Matches the end of the line (or any line, when applied in multiline mode).
()	Defines a ‟marked subexpression”. Every matched instance is available to the next command as a variable.
*	A single character expression followed by ‟*” matches zero or more copies of the expression.
{m,n}	Matches at least m and at most n repetitions of the term
{m}	Matches exactly m repetitions of the term
{m,}	Matches m or more repetitions of the term
?	The preceding item is optional and matched once, at most.
+	The preceding item is matched one or more times.
-	Used between start and end of a range.
\	An escape character to indicate that the following character is a match criteria and not a grouping delimiter.
>	Redirect output.

Table 9. Special characters
Options	Similar to	Description
[:upper:]	[A-Z]	uppercase letters
[:lower:]	[a-z]	lowercase letters
[:alpha:]	[A-Za-z]	upper- and lowercase letters
\w	[A-Za-z_]	word characters
[:alnum:]	[A-Za-z0-9]	digits, upper- and lowercase letters
[:digit:]	[0-9]	digits
\d	[0-9]	digits
[:xdigit:]	[0-9A-Fa-f]	hexadecimal digits
[:punct:]	[.,!?:...]	punctuation
[:blank:]	[ \t]	space and Tab
[:space:]	[ \t\n\r\f\v]	blank characters
\s	[ \t\n\r\f\v]	blank characters

Redirection

The 7210 SAS supports redirection (‟>”), which allows the operator to store the output of a CLI command as a local or remote file. Redirection of output can be used to automatically store results of commands in files (both local and remote).

‛ping <customer_ip> > cf3cf1:/ping/result.txt’
‛ping <customer_ip> > ftp://ron@ftp.nokia.com/ping/result.txt’

In some cases only part of the output may be applicable. The pipe/match and redirection commands can be combined, as shown in the following example.

ping 10.0.0.1 | match expression ‟time.\d+” > cf3cf1:/ping/time.txt
This records only the RTT portion (including the word ‟time”).

Basic command reference

Command hierarchies

Global CLI commands

    - back
    - clear 
    - echo [text-to-echo] [extra-text-to-echo] [more-text] 
    - enable-admin
    - exec [-echo] [-syntax] filename | eof-marker-string
    - exit [all]
    - help
    - history
    - info [detail]
    - logout
    - password
    - ping {ip-address | dns-name} [rapid | detail] [ttl time-to-live] [tos type-of-service] [size bytes] [pattern pattern] [source ip-address] [interval seconds] [{next-hop ip-address} | {interface interface-name} |bypass-routing] [count requests] [do-not-fragment] [router router-instance | service-name service-name] [timeout timeout] 
    - pwc [previous]
    - sleep [seconds]
    - ssh [ip-addr | dns-name | username@ip-addr] [-l username] [-v SSH-version]  [router router-instance] 
    - telnet [ip-address| dns-name] [port] [router router-instance] 
    - traceroute {ip-address | dns-name} [ttl value] [wait milliseconds] [no-dns] [source ip-address] [tos type-of-service]
    - tree [detail]
    - write {user | broadcast} message-string

Monitor commands

monitor
    - filter
        - ip ip-filter-id entry entry-id [interval seconds] [repeat repeat] [absolute | rate]
        - ipv6 ipv6-filter-id entry entry-id [interval seconds] [repeat repeat] [absolute|rate]
        - mac mac-filter-id entry entry-id [interval seconds] [repeat repeat]  [absolute | rate]
    - lag lag-id [lag-id...(up to 5 max)] [interval seconds] [repeat repeat] [absolute | rate]
    - port port-id [port-id...(up to 5 max)] [interval seconds] [repeat repeat] [absolute | rate]
    - service
        - id service-id
            - sap sap-id [interval seconds] [repeat repeat] [absolute | rate]
            - sdp sdp-id [far-end] ip-address [interval seconds] [repeat repeat] [absolute | rate]
    - management-access-filter
        - ip entry entry-id [interval seconds] [repeat repeat] [absolute | rate]
        - ipv6 entry entry-id [interval seconds] [repeat repeat] [absolute | rate]

Environment commands

root
    - environment
        - alias alias-name alias-command-name
        - no alias alias-name
        - [no] create
        - [no] more
        - reduced-prompt [no of nodes in prompt]
        - no reduced-prompt
        - [no] saved-ind-prompt
        - terminal 
            - length lines
            - width width
        - time-display {local | utc}
        - [no] time-stamp

Show commands

show
    - alias

Command descriptions

Global commands

enable-admin

Syntax

enable-admin

Context

Description

Note:

See the description for the admin-password command. If the admin-password is configured in the config>system>security>password context, any user can enter a special administrative mode by entering the enable-admin command.

The enable-admin command is in the default profile. By default, all users are granted access to this command.

When the enable-admin command is entered, the user is prompted for a password. If the password is correct, the user is granted unrestricted access to all commands.

The minimum length of the password is determined by the minimum-length command. The complexity requirements for the password is determined by the complexity command.

Password configuration

A:ALA-1>config>system>security# info
----------------------------------------------
...
            password
                aging 365
                minimum-length 8
                attempts 5 time 5 lockout 20
                admin-password "rUYUz9XMo6I" hash
            exit
...
----------------------------------------------
A:ALA-1>config>system>security#

Use one of the following options to verify that a user is in the enable-admin mode.

Administrators can use the show users command to know which users are in this mode.
Enter the enable-admin command again at the root prompt and an error message is returned.

The following is an example output for the show users command.

A:ALA-1# show users
===============================================================================
User Type From Login time Idle time
===============================================================================
admin Console -- 10AUG2006 13:55:24 0d 19:42:22
admin Telnet 10.20.30.93 09AUG2004 08:35:23 0d 00:00:00 A
-------------------------------------------------------------------------------
Number of users : 2
'A' indicates user is in admin mode
===============================================================================
A:ALA-1#
A:ALA-1# enable-admin
MINOR: CLI Already in admin mode.
A:ALA-1#

back

Syntax

back

Context

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command moves the context back one level in the command hierarchy. For example, if the current level is the config router ospf context, the back command moves the cursor to the config router context level.

clear

Syntax

clear

Context

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command clears statistics for a specified entity, or it clears and resets the entity.

Parameters

cron: Clears CRON history.

filter: Clears IPv4, IPv6, MAC, and log filter counters.

lag: Clears LAG-related entities.

log: Closes and reinitializes the log specified by log-id.

port: Clears port statistics.

qos: Clears QoS statistics.

radius: Clears the RADIUS server state.

router

Clears router commands affecting the router instance in which they are entered.

Values: arp, authentication, bfd, dhcp, forwarding-table, icmp-redirect-route, interface, isis, ldp, mpls, ospf, rip, rsvp

saa: Clears the SAA test results.

screen: Clears the console or telnet screen.

service: Clears service ID and statistical entities.

system: Clears or re-enables a previously failed reference.

tacplus: Clears the TACACS+ server state.

trace: Clears the trace log.

echo

Syntax

echo [text-to-echo] [extra-text-to-echo] [more-text]

Context

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command echoes arguments on the command line. The primary use of this command is to allow messages to be displayed to the screen in files executed with the exec command.

Parameters

text-to-echo: Specifies a text string to be echoed, up to 256 characters.

extra-text-to-echo: Specifies more text to be echoed, up to 256 characters.

more-text: Specifies more text to be echoed, up to 256 characters.

exec

Syntax

exec [-echo] [-syntax] {file-name | [eof_string]}

Context

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command executes the contents of a text file as if they were CLI commands entered at the console.

Exec commands do not have no versions.

The following commands are related to the exec command:

boot-bad-exec

Use this command to configure a URL for a CLI script to exec following a failed configuration boot.
boot-good-exec

Use this command to configure a URL for a CLI script to exec following a successful configuration boot.

Parameters

-echo

Keyword to echo the contents of the exec file to the session screen as it executes.

Default: echo disabled

-syntax

Keyword to perform a syntax check of the file without executing the commands. Syntax checking finds invalid commands and keywords, but it is not able to validate erroneous user-configured parameters.

Default: execute file commands

file-name: Specifies the text file, up to 256 characters, with CLI commands to execute.

<<

Stdin can be used as the source of commands for the exec command. When stdin is used as the exec command input, the command list is terminated with <Ctrl-C>, ‟EOF<Return>” or ‟eof_string<Return>”.

If an error occurs entering an exec file sourced from stdin, all commands after the command returning the error are silently ignored. The exec command indicates the command error line number when the stdin input is terminated with an end-of-file input.

eof_string

Specifies the ASCII printable string, up to 254 characters, used to indicate the end of the exec file when stdin is used as the exec file source. <Ctrl-C> and EOF can always be used to terminate an exec file sourced from stdin.

Default: <Ctrl-C>, EOF

exit

Syntax

exit [all]

Context

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command returns to the context from which the current level was entered. For example, if you navigated to the current level on a context by context basis, the exit command only moves the cursor back one level.

A:Dut-G# configure 
A:Dut-G>config# service 
A:Dut-G>config>service# vpls 1 
A:Dut-G>config>service>vpls# exit 
A:Dut-G>config>service# exit 
A:Dut-G>config# exit

If you navigated to the current level by entering a command string, the exit command returns the cursor to the context in which the command was initially entered.

A:Dut-G# configure service vpls 1 
A:Dut-G>config>service>vpls# exit 
A:Dut-G#

The exit all command moves the cursor all the way back to the root level.

A:Dut-G# configure 
A:Dut-G>config# service 
A:Dut-G>config>service# vpls 1 
A:Dut-G>config>service>vpls# exit all
A:Dut-G#

Parameters

all: Keyword to exit back to the root CLI context.

help

Syntax

help

help edit

help global

help special-characters

Context

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command provides a brief description of the help system. The following information is displayed:

Help may be requested at any point by hitting a question mark '?'.
In case of an executable node, the syntax for that node will be displayed with an ex
planation of all parameters.
In case of sub-commands, a brief description is provided.
Global Commands:
Help on global commands can be observed by issuing "help globals" at any time.
Editing Commands:
Help on editing commands can be observed by issuing "help edit" at any time.

Parameters

edit

Keyword to display help on editing. The following output displays available editing keystrokes.

Delete current character.....................Ctrl-d
Delete text up to cursor.....................Ctrl-u
Delete text after cursor.....................Ctrl-k
Move to beginning of line....................Ctrl-a
Move to end of line..........................Ctrl-e
Get prior command from history...............Ctrl-p
Get next command from history................Ctrl-n
Move cursor left.............................Ctrl-b
Move cursor right............................Ctrl-f
Move back one word...........................Esc-b
Move forward one word........................Esc-f
Convert rest of word to uppercase............Esc-c
Convert rest of word to lowercase............Esc-l
Delete remainder of word.....................Esc-d
Delete word up to cursor.....................Ctrl-w
Transpose current and previous character.....Ctrl-t
Enter command and return to root prompt......Ctrl-z
Refresh input line...........................Ctrl-l

global

Keyword to display help on global commands. The following output displays the available global commands.

back            - Go back a level in the command tree
echo            - Echo the text that is typed in
exec            - Execute a file - use -echo to show the commands and
                  prompts on the screen
exit            - Exit to intermediate mode - use option all to exit to
                  root prompt
help            - Display help
history         - Show command history
info            - Display configuration for the present node
logout          - Log off this system
oam             + OAM Test Suite
ping            - Verify the reachability of a remote host
pwc             - Show the present working context
sleep           - Sleep for specified number of seconds
ssh             - SSH to a host
telnet          - Telnet to a host
traceroute      - Determine the route to a destination address
tree            - Display command tree structure from the context of
                  execution
write           - Write text to another user

special-characters: Keyword to display help on special characters. Use the following CLI commands to display more information about commands and command syntax:

?: Lists all commands in the current context.

string?: Lists all commands available in the current context that start with the string.

command ?: Displays command syntax and associated keywords.

string<Tab> or string<Space>: Completes a partial command name (auto-completion) or list available commands that match the string.

history

Syntax

history

Context

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command lists the last 30 commands entered in this session.

Re-execute a command in the history with the !n command, where n is the line number associated with the command in the history output.

A:ALA-1# history
  68 info
  69 exit
  70 info
  71 filter
  72 exit all
  73 configure
  74 router
  75 info
  76 interface "test"
  77 exit
  78 reduced-prompt
  79 info
  80 interface "test"
  81 icmp unreachables exit all
  82 exit all
  83 reduced-prompt
  84 configure router
  85 interface
  86 info
  87 interface "test"
  88 info
  89 reduced-prompt
  90 exit all
  91 configure
  92 card 1
  93 card-type
  94 exit
  95 router
  96 exit
  97 history
A:ALA-1# !91
A:ALA-1# configure
A:ALA-1>config#

info

Syntax

info [detail]

Context

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command displays the running configuration for the configuration context.

The output of this command is similar to the output of a show config command. This command, however, lists the configuration of the context where it is entered and all branches below that context level.

By default, the command only enters the configuration parameters that vary from the default values. The detail keyword causes all configuration parameters to be displayed.

Parameters

detail: Displays all configuration parameters, including parameters at their default values.

logout

Syntax

logout

Context

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command logs out of the router session.

When the logout command is issued from the console, the login prompt is displayed, and any log IDs directed to the console are discarded. When the console session resumes (regardless of the user), the log output to the console resumes.

When a Telnet session is terminated from a logout command, all log IDs directed to the session are removed. When a user logs back in, the log IDs must be recreated.

password

Syntax

password

Context

<ROOT>

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command changes a user CLI login password.

When a user logs in after the administrator forces a new-password-at-login, or the password has expired (aging), this command is automatically invoked.

When this command is invoked, the user is prompted to enter the old password, the new password, and the new password again to verify the correct input.

If a user fails to create a new password after the administrator forces a new-password-at-login or after the password has expired, the user is denied access to the CLI.

ping

Syntax

ping {ip-address | dns-name} [rapid | detail] [ttl time-to-live] [tos type-of-service] [size bytes] [pattern pattern] [source ip-address] [interval seconds] [{next-hop ip-address} | {interface interface-name} | bypass-routing] [count requests] [do-not-fragment] [router router-instance|service-name service-name][timeout timeout]

Context

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command is the TCP/IP utility to verify IP reachability.

Parameters

ip-address | dns-name

Specifies the remote host to ping. The IP address or the DNS name (if DNS name resolution is configured) can be specified.

Values


ipv4-address - a.b.c.d
ipv6-address - x:x:x:x:x:x:x:x[-interface]
	x:x:x:x:x:x:x:x [-interface]
	x:x:x:x:x:x:d.d.d.d
	x: 0 — FFFF H
	d: 0 — 255 D

rapid | detail

The rapid keyword specifies to send ping requests rapidly. The results are reported in a single message, not in individual messages for each ping request. By default, five ping requests are sent before the results are reported. To change the number of requests, include the count option.

The detail keyword includes in the output the interface on which the ping reply was received.

The following is a sample configuration output.


*A:ALU-7210# ping 192.xxx.xxx.xxx
PING 192.xxx.xxx.xxx 56 data bytes
64 bytes from 192.xxx.xxx.xxx: icmp_seq=1 ttl=64 time<10ms.
64 bytes from 1192.xxx.xxx.xxx: icmp_seq=2 ttl=64 time<10ms.
64 bytes from 192.xxx.xxx.xxx: icmp_seq=3 ttl=64 time<10ms.
64 bytes from 192.xxx.xxx.xxx: icmp_seq=4 ttl=64 time<10ms.
64 bytes from 192.xxx.xxx.xxx: icmp_seq=5 ttl=64 time<10ms.

---- 192.xxx.xxx.xxx PING Statistics ----
5 packets transmitted, 5 packets received, 0.00% packet loss
round-trip min < 10ms, avg < 10ms, max < 10ms, stddev < 10ms
*A:ALU-7210#

ttl time-to-live

Specifies the IP Time To Live (TTL) value to include in the ping request, expressed as a decimal integer.

Values: 0 to128

tos type-of-service

Specifies the type-of-service (TOS) bits in the IP header of the ping packets, expressed as a decimal integer.

Values: 0 to 255

size bytes

Specifies the size in bytes of the ping request packets.

Values: 0 to 65507

Default: 56 bytes (actually 64 bytes because 8 bytes of ICMP header data are added to the packet)

pattern pattern

Specifies a 16-bit pattern string to include in the ping packet, expressed as a decimal integer.

Values: 0 to 65535

source ip-address

Specifies the source IP address to use in the ping requests in dotted decimal notation.

Values


ipv4-address - a.b.c.d
ipv6-address - x:x:x:x:x:x:x:x[-interface]
	x:x:x:x:x:x:x:x [-interface]
	x:x:x:x:x:x:d.d.d.d
	x: 0 — FFFF H
	d: 0 — 255 D

Default: the IP address of the egress IP interface

interval seconds

Specifies the interval in seconds between consecutive ping requests, expressed as a decimal integer.

Values: 1 to 10000

Default: 1

next-hop ip-address

Disregards the routing table and sends this packet to the specified next-hop address. This address must be on an adjacent router that is attached to a subnet that is common between this and the next-hop router.

Values


ipv4-address - a.b.c.d
ipv6-address - x:x:x:x:x:x:x:x[-interface]
	x:x:x:x:x:x:d.d.d.d[-interface]
	x - [0..FFFF]H
	d - [0..255]D

Default: per the routing table

interface interface-name: Specifies the interface name.

bypass-routing: Keyword to send the ping request to a host on a directly attached network bypassing the routing table. The host must be on a directly attached network or an error is returned.

count requests

Specifies the number of ping requests to send to the remote host, expressed as a decimal integer.

Values: 1 to 10000

Default: 5

do-not-fragment: Keyword to specify that the request frame should not be fragmented. This option is particularly useful in combination with the size parameter for maximum MTU determination.

router router-instance

Specifies the router name or service ID.

Values


router-name:	Base, management
service-id:	1 to 2147483647

Default: Base

timeout timeout

Specifies the timeout in seconds.

Values: 1 to 10

Default: 5

service-name service-name: Specifies a unique service name, up to 64 characters, to identify the service.

pwc

Syntax

pwc [previous]

Context

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command displays the present or previous working context of the CLI session. The pwc command provides a user who is in the process of dynamically configuring a chassis a way to display the current or previous working context of the CLI session. The pwc command displays a list of the CLI nodes that hierarchically define the current context of the CLI instance of the user.

Configuration output

A:Dut-G>config>service>vpls# pwc 
-------------------------------------------------------------------------------
Present Working Context :
-------------------------------------------------------------------------------
 <root>
  configure  
  service  
  vpls 1  
-------------------------------------------------------------------------------
A:Dut-G>config>service>vpls#

When the previous keyword is specified, the previous context displays. This is the context entered by the CLI parser upon execution of the exit command. The current context of the CLI is not affected by the pwc command.

Parameters

previous: Keyword to display the previous present working context.

sleep

Syntax

sleep [seconds]

Context

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command causes the console session to pause operation (sleep) for 1 second (default) or for the specified number of seconds.

Parameters

seconds

Specifies the number of seconds for the console session to sleep, expressed as a decimal integer.

Values: 1 to 100

Default: 1

ssh

Syntax

ssh [ip-addr | dns-name |username@ip-addr] [-l username] [-v SSH-version] [router router-instance]

Context

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command initiates a client Secure Shell (SSH) session with the remote host and is independent from the administrative or operational state of the SSH server. However, to be the target of an SSH session, the SSH server must be operational.

Quitting SSH while in the process of authentication is accomplished by either executing a Ctrl-c or "~." (tilde and dot), assuming the ‟~” is the default escape character for SSH session.

Parameters

ip-address | host-name: Specifies the remote host for an SSH session. The IP address or the DNS name (if DNS name resolution is configured) can be specified.

-l user: Specifies the username to use when opening the SSH session.

router router-instance

Specify the router name or service ID.

Values: Base, management

Default: Base

telnet

Syntax

telnet [ip-address | dns-name] [port] [router router-instance]

Context

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command opens a Telnet session to a remote host. Telnet servers in 7210 SAS networks limit a Telnet clients to three login attempts. The Telnet server disconnects the Telnet client session after the third attempt has failed. The number of attempts for a Telnet client session is not user-configurable.

Parameters

ip-address

Specifies the IP address or the DNS name (providing DNS name resolution is configured).

Values


ipv4-address	a.b.c.d
ipv6-address	x:x:x:x:x:x:x:x (eight 16-bit pieces)
	x:x:x:x:x:x:d.d.d.d
	x: [0 .. FFFF]H
	d: [0 .. 255]D

dns-name: Specifies the DNS name (if DNS name resolution is configured), up to 128 characters.

port

Specifies the TCP port number to use to Telnet to the remote host, expressed as a decimal integer.

Values: 1 to 65535

Default: 23

router router-instance

Specifies the router name or service ID.

Values: router-name: Base, management

Default: Base

traceroute

Syntax

traceroute {ip-address | dns-name} [ttl ttl] [wait milliseconds] [no-dns] [source ip-address] [tos type-of-service] [router router-instance]

Context

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

The TCP/IP traceroute utility determines the route to a destination address. Aborting a traceroute with Ctrl-c could require issuing a second Ctrl-c before the prompt is returned.

The following is a sample configuration output.

A:ALA-1# traceroute 192.168.xx.xx4
traceroute to 192.168.xx.xx4, 30 hops max, 40 byte packets
 1  192.168.xx.xx4 0.000 ms  0.000 ms  0.000 ms
A:ALA-1#

Parameters

ip-address | dns-name

Specifies the remote address to traceroute. The IP address or the DNS name (if DNS name resolution is configured) can be specified.

Values


ipv4-address	a.b.c.d
ipv6-address	x:x:x:x:x:x:x:x (eight 16-bit pieces)
	x:x:x:x:x:x:d.d.d.d
		x: [0 .. FFFF]H
		d: [0 .. 255]D

ttl ttl

Specifies the maximum Time-To-Live (TTL) value to include in the traceroute request, expressed as a decimal integer.

Values: 1 to 255

wait milliseconds

Specifies the time in milliseconds to wait for a response to a probe, expressed as a decimal integer.

Values: 1 to 60000

Default: 5000

no-dns

Keyword to specify not to perform a DNS lookup for the specified host.

Default: DNS lookups are performed

source ip-address: Specifies the source IP address to use as the source of the probe packets in dotted decimal notation. If the IP address is not one of the device interfaces, an error is returned.

tos type-of-service

Specifies the type-of-service (TOS) bits in the IP header of the probe packets, expressed as a decimal integer.

Values: 0 to 255

router router-instance

Specifies the router name or service ID.

Values


router-name:	Base, management
service-id:	1 to 2147483647

Default: Base

tree

Syntax

tree [detail]

Context

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command displays the command hierarchy structure from the present working context.

Parameters

detail: Keyword to include parameter information for each command displayed in the tree output.

write

Syntax

write {user | broadcast} message-string

Context

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command sends a console message to a specific user or to all users with active console sessions.

Parameters

user

Specifies the name of a user with an active console session to which to send a console message.

Values: any valid CLI username

broadcast: Keyword to send the message-string to all users logged into the router.

message-string: Specifies the message string to send. Allowed values are any string up to 250 characters composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, and so on), the entire string must be enclosed within double quotes.

Environment commands

alias

Syntax

alias alias-name alias-command-line

no alias alias-name

Context

environment

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables the substitution of a command line by an alias.

Use the alias command to create alternative names for an entity or command string that are r easier to remember and understand. If the string contains special characters (#, $, spaces, and others), the entire string must be enclosed within double quotes. Only a single command can be present in the command string.

The alias command can be entered in any context but must be created in the environment context.

For example, to create an alias named soi to display OSPF interfaces, enter:

alias soi ‟show router ospf interface”

Parameters

alias-name: Specifies the alias name. Do not use a valid command string for the alias. If the alias specified is an actual command, this causes the command to be replaced by the alias.

alias-command-line: Specifies the command line to be associated with the alias.

create

Syntax

[no] create

Context

environment

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

By default, the create command is required to create a new OS entity.

The no form of the command disables requiring the create keyword.

Default

create

Syntax

[no] more

Context

environment

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables per-screen CLI output, meaning that the output is displayed on a screen-by-screen basis. The terminal screen length can be modified using the terminal command.

The following prompt appears at the end of each screen of paginated output:

Press any key to continue (Q to quit)

The no form of the command displays the output all at once. If the output length is longer than one screen, the entire output will be displayed, which may scroll the screen.

Default

Syntax

reduced-prompt [no of nodes in prompt]

no reduced-prompt

Context

environment

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the maximum number of higher CLI context levels to display in the CLI prompt for the current CLI session. This command is useful when configuring features that are several node levels deep, causing the CLI prompt to become too long.

By default, the CLI prompt displays the system name and the complete context in the CLI.

The number of nodes specified indicates the number of higher-level contexts that can be displayed in the prompt. For example, if reduced-prompt is set to 2, the two highest contexts from the present working context are displayed by name with the hidden (reduced) contexts compressed into a ellipsis (‟…”).

Configuration output

A:ALA-1>environment# reduced-prompt 2
A:ALA-1>vonfig>router# interface to-103
A:ALA-1>...router>if#

The setting is not saved in the configuration. It must be reset for each CLI session or stored in an exec script file.

The no form of the command reverts to the default.

Default

no reduced-prompt

Parameters

no of nodes in prompt

Specifies the maximum number of higher-level nodes displayed by name in the prompt, expressed as a decimal integer.

Values: 0 to 15

Default: 2

saved-ind-prompt

Syntax

[no] saved-ind-prompt

Context

environment

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables a saved indicator in the prompt. When changes are made to the configuration file a ‟*” appears in the prompt string indicating that the changes have not been saved. When an admin save command is executed, the ‟*” disappears.

The following is a sample configuration output.

*A:ALA-48# admin save
Writing file to ftp://xxx.xxx.xx.xx/./sim48/sim48-config.cfg
Saving configuration .... Completed.
A:ALA-48#

terminal

Syntax

[no] terminal

Context

environment

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

Commands in this context configure the terminal screen length and width for the current CLI session.

length

Syntax

length lines

Context

environment>terminal

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command sets the terminal screen length (number of lines).

Default

Parameters

lines

Specifies the number of lines for the terminal screen length, expressed as a decimal integer.

Values: 1 to 512

width

Syntax

width width

Context

environment>terminal

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command sets the terminal screen width (number of characters).

Default

Parameters

width

Specifies the number of characters for the terminal screen width, expressed as a decimal integer.

Values: 1 to 512

time-display

Syntax

time-display {local | utc}

Context

environment

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command displays timestamps in the CLI session based on local time or Coordinated Universal Time (UTC).

The system keeps time internally in UTC and is capable of displaying the time in either UTC or local time based on the time zone configured.

This configuration command is only valid for times displayed in the current CLI session. This includes displays of event logs, traps and all other places where a timestamp is displayed.

In general all timestamps are shown in the time selected. This includes log entries destined for console/session, memory, or SNMP logs. Log files on compact flash are maintained and displayed in UTC format.

Default

time-display local

time-stamp

Syntax

time-stamp

Context

environment

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command displays timestamps in the CLI session.

Show commands

alias

Syntax

alias

Context

<root>

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command displays a list of existing aliases.

Output

The following output is an example of alias information, and Output fields: alias describes the output fields.

Sample output: show alias

A:ALA-103>config>system# show alias
==============================================================================
Alias-Name                    Alias-command-name
==============================================================================
sri                           show router interface
sse                           show service service-using epipe
ssvpls                        show service service-using vpls
ssi                           show service service-using ies
------------------------------------------------------------------------------
Number of aliases : 5
==============================================================================
A:ALA-103>config>system#

Table 10. Output fields: alias
Label	Description
Alias-Name	Displays the name of the alias
Alias-command-name	The command and parameter syntax that define the alias
Number of aliases	The total number of aliases configured on the router

Monitor commands

filter

Syntax

filter

Context

monitor

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

Commands in this context configure criteria to monitor IP and MAC filter statistics.

ip

Syntax

ip ip-filter-id entry entry-id [interval seconds] [repeat repeat] [absolute | rate]

Context

monitor>filter

monitor>management-access-filter

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables IP filter monitoring. The statistical information for the specified IP filter entry is displayed at the configured interval until the configured count is reached.

The first screen displays the current statistics related to the specified IP filter. The subsequent statistical information listed for each interval is displayed as a delta to the previous screen output.

When the rate keyword is specified, the rate per second for each statistic is displayed instead of the delta.

Monitor commands are similar to show commands, but only statistical information is displayed. Monitor commands display the selected statistics according to the configured number of times at the interval specified.

Parameters

ip-filter-id

Displays detailed information for the specified filter ID and its filter entries.

Values: 1 to 65535

entry-id

Displays information about the specified filter entry ID for the specified filter ID only.

Values: 1 to 65535

seconds

Specifies the interval for each display in seconds.

Values: 3 to 60

Default: 5 seconds

repeat

Specifies how many times the command is repeated.

Values: 1 to 999

Default: 10

absolute: Keyword to display raw statistics, without processing. No calculations are performed on the delta or rate statistics.

rate: The rate per second for each statistic is displayed instead of the delta.

Output

The following output is an example of filter IP statistics.

Sample output

A:ALA-1>monitor# filter ip 10 entry 1 interval 3 repeat 3 absolute
===============================================================================
Monitor statistics for IP filter 10 entry 1
===============================================================================
At time t = 0 sec (Base Statistics)
-------------------------------------------------------------------------------
Ing. Matches: 0                                Egr. Matches    : 0
-------------------------------------------------------------------------------
At time t = 3 sec (Mode: Absolute)
-------------------------------------------------------------------------------
Ing. Matches: 0                                Egr. Matches    : 0
-------------------------------------------------------------------------------
At time t = 6 sec (Mode: Absolute)
-------------------------------------------------------------------------------
Ing. Matches: 0                                Egr. Matches    : 0
-------------------------------------------------------------------------------
At time t = 9 sec (Mode: Absolute)
-------------------------------------------------------------------------------
Ing. Matches: 0                                Egr. Matches    : 0
===============================================================================
A:ALA-1>monitor#


A:ALA-1>monitor# filter ip 10 entry 1 interval 3 repeat 3 rate
===========================================================================
Monitor statistics for IP filter 10 entry 1
===========================================================================
At time t = 0 sec (Base Statistics)
---------------------------------------------------------------------------
Ing. Matches: 0                                Egr. Matches    : 0
---------------------------------------------------------------------------
At time t = 3 sec (Mode: Rate)
---------------------------------------------------------------------------
Ing. Matches: 0                                Egr. Matches    : 0
---------------------------------------------------------------------------
At time t = 6 sec (Mode: Rate)
---------------------------------------------------------------------------
Ing. Matches: 0                                Egr. Matches    : 0
---------------------------------------------------------------------------
At time t = 9 sec (Mode: Rate)
---------------------------------------------------------------------------
Ing. Matches: 0                                Egr. Matches    : 0
===========================================================================
A:ALA-1>monitor#

ipv6

Syntax

ipv6 ipv6-filter-id entry entry-id [interval seconds] [repeat repeat] [absolute | rate]

Context

monitor>filter

monitor>management-access-filter

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables IPv6 filter monitoring. The statistical information for the specified IPv6 filter entry is displayed at the configured interval until the configured count is reached.

The first screen displays the current statistics related to the specified IPv6 filter. The subsequent statistical information listed for each interval is displayed as a delta to the previous display.

When the keyword rate is specified, the rate per second for each statistic is displayed instead of the delta.

Monitor commands are similar to show commands but only statistical information displays. Monitor commands display the selected statistics according to the configured number of times at the interval specified.

Parameters

iv6p-filter-id

Displays detailed information for the specified IPv6 filter ID and its filter entries.

Values: 1 to 65535

entry-id

Displays information about the specified IPv6 filter entry ID for the specified filter ID only.

Values: 1 to 65535

seconds

Specifies the interval for each display in seconds.

Values: 3 to 60

Default: 10 seconds

repeat

Specifies how many times the command is repeated.

Values: 1 to 999

Default: 10

absolute: Keyword to display raw statistics, without processing. No calculations are performed on the delta or rate statistics.

rate: Keyword to display the rate per second for each statistic instead of the delta.

Output

Sample output

*A:7210SAS>monitor>filter# ipv6 10 entry 10 interval 3 repeat 3 absolute

===============================================================================
Monitor statistics for IPv6 filter 10 entry 10
===============================================================================
-------------------------------------------------------------------------------
At time t = 0 sec (Base Statistics)
-------------------------------------------------------------------------------
Ing. Matches : 0 pkts
Egr. Matches : 0 pkts

-------------------------------------------------------------------------------
At time t = 3 sec (Mode: Absolute)
-------------------------------------------------------------------------------
Ing. Matches : 0 pkts
Egr. Matches : 0 pkts

-------------------------------------------------------------------------------
At time t = 6 sec (Mode: Absolute)
-------------------------------------------------------------------------------
Ing. Matches : 0 pkts
Egr. Matches : 0 pkts

-------------------------------------------------------------------------------
At time t = 9 sec (Mode: Absolute)
-------------------------------------------------------------------------------
Ing. Matches : 0 pkts
Egr. Matches : 0 pkts

===============================================================================
*A:7210SAS>monitor>filter#

mac

Syntax

mac mac-filter-id entry entry-id [interval seconds] [repeat repeat] [absolute | rate]

Context

monitor>filter

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables MAC filter monitoring. The statistical information for the specified MAC filter entry is displayed at the configured interval until the configured count is reached.

The first screen displays the current statistics related to the specified MAC filter. The subsequent statistical information listed for each interval is displayed as a delta to the previous display.

When the keyword rate is specified, the rate per second for each statistic is displayed instead of the delta.

Parameters

mac-filter-id

Specifies the MAC filter policy ID.

Values: 1 to 65535

entry-id

Displays information on the specified filter entry ID for the specified filter ID only.

Values: 1 to 65535

seconds

Specifies the interval for each display in seconds.

Values: 3 to 60

Default: 5 seconds

repeat

Specifies how many times the command is repeated.

Values: 1 to 999

Default: 10

absolute: Keyword to display the raw statistics, without processing. No calculations are performed on the delta or rate statistics.

rate: Keyword to display the rate per second for each statistic instead of the delta.

Output

The following output is an example of MAC filter statistics.

Sample output

A:ALA-1>monitor>filter# mac 50 entry 10 interval 3 repeat 3 absolute
===============================================================================
Monitor statistics for Mac filter 50 entry 10
===============================================================================
At time t = 0 sec (Base Statistics)
-------------------------------------------------------------------------------
Ing. Matches: 0                                Egr. Matches    : 0
------------------------------------------------------------------------------
At time t = 3 sec (Mode: Absolute)
-------------------------------------------------------------------------------
Ing. Matches: 0                                Egr. Matches    : 0
-------------------------------------------------------------------------------
At time t = 6 sec (Mode: Absolute)
-------------------------------------------------------------------------------
Ing. Matches: 0                                Egr. Matches    : 0
-------------------------------------------------------------------------------
At time t = 9 sec (Mode: Absolute)
-------------------------------------------------------------------------------
Ing. Matches: 0                                Egr. Matches    : 0
===============================================================================


A:ALA-1>monitor>filter# mac 50 entry 10 interval 3 repeat 3 rate
===============================================================================
Monitor statistics for Mac filter 50 entry 10
===============================================================================
At time t = 0 sec (Base Statistics)
-------------------------------------------------------------------------------
Ing. Matches: 0                                Egr. Matches    : 0
-------------------------------------------------------------------------------
At time t = 3 sec (Mode: Rate)
-------------------------------------------------------------------------------
Ing. Matches: 0                                Egr. Matches    : 0
-------------------------------------------------------------------------------
At time t = 6 sec (Mode: Rate)
-------------------------------------------------------------------------------
Ing. Matches: 0                                Egr. Matches    : 0
-------------------------------------------------------------------------------
At time t = 9 sec (Mode: Rate)
-------------------------------------------------------------------------------
Ing. Matches: 0                                Egr. Matches    : 0
===============================================================================
A:ALA-1>monitor>filter#

lag

Syntax

lag lag-id [lag-id...(up to 5 max)] [interval seconds] [repeat repeat] [absolute | rate]

Context

monitor

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command monitors traffic statistics for Link Aggregation Group (LAG) ports. Statistical information for the specified LAG IDs is displayed at the configured interval until the configured count is reached.

The first screen displays the current statistics related to the specified LAG ID. The subsequent statistical information listed for each interval is displayed as a delta to the previous display.

When the keyword rate is specified, the rate per second for each statistic is displayed instead of the delta.

Parameters

lag-id

Specifies the number of the LAG.

Values: 1 to 6

seconds

Specifies the interval for each display in seconds.

Values: 3 to 60

Default: 5 seconds

repeat

Specifies how many times the command is repeated.

Values: 1 to 999

Default: 10

absolute: Keyword to display the raw statistics, without processing. No calculations are performed on the delta or rate statistics.

rate: Keyword to display the rate per second for each statistic instead of the delta.

Output

The following output is an example of LAG statistics.

Sample output

A:ALA-12# monitor lag 2 
===============================================================================
Monitor statistics for LAG ID 2
===============================================================================
Port-id Input Input Output Output Input Output
Bytes Packets Bytes Packets Errors Errors
-------------------------------------------------------------------------------
At time t = 0 sec (Base Statistics)
-------------------------------------------------------------------------------
1/1/1 2168900 26450 64 1 0 0
1/1/2 10677318 125610 2273750 26439 0 0
1/1/3 2168490 26445 0 0 0 0
-------------------------------------------------------------------------------
Totals 15014708 178505 2273814 26440 0 0 
-------------------------------------------------------------------------------
At time t = 5 sec (Mode: Delta)
-------------------------------------------------------------------------------
1/1/1 0 0 0 0 00
1/1/2 258 3 86 1 0 0
1/1/3 82 1 0 0 0 0
-------------------------------------------------------------------------------
Totals 340 4 86 1 0 0
===============================================================================
A:ALA-12#

management-access-filter

Syntax

management-access-filter

Context

monitor

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

Commands in this context monitor management access filters. These filters are configured in the config>system>security>mgmt-access-filter context.

ip

Syntax

ip entry entry-id [interval seconds] [repeat repeat] [absolute | rate]

Context

monitor>management-access-filter

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command monitors statistics for the MAF IP filter entry.

Parameters

entry entry-id

Specifies an existing IP MAF entry ID.

Values: 1 to 9999

interval seconds

Specifies the interval for each display in seconds.

Values: 3 to 60

Default: 10

repeat repeat

Specifies how many times the command is repeated.

Values: 1 to 999

Default: 10

absolute: Keyword to display the raw statistics, without processing. No calculations are performed on the delta or rate statistics.

rate: Keyword to display the rate per second for each statistic instead of the delta.

ipv6

Syntax

ipv6 entry-id [interval seconds] [repeat repeat] [absolute | rate]

Context

monitor>management-access-filter

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command monitors statistics for the MAF IPv6 filter entry.

Parameters

entry entry-id

Specifies an existing IP MAF entry ID.

Values: 1 to 9999

interval seconds

Configures the interval for each display in seconds.

Values: 3 to 60

Default: 10

repeat repeat

Configures how many times the command is repeated.

Values: 1 to 999

Default: 10

absolute: The raw statistics are displayed, without processing. No calculations are performed on the delta or rate statistics.

rate: The rate-per-second for each statistic is displayed instead of the delta.

port

Syntax

port port-id [port-id...(up to 5 max)] [interval seconds] [repeat repeat] [absolute | rate]

Context

monitor

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables port traffic monitoring. The specified ports statistical information displays at the configured interval until the configured count is reached.

The first screen displays the current statistics related to the specified ports. The subsequent statistical information listed for each interval is displayed as a delta to the previous display.

When the keyword rate is specified, the rate per second for each statistic is displayed instead of the delta.

Parameters

port-id: Specifies up to 5 port IDs.

seconds

Specifies the interval for each display in seconds.

Values: 3 to 60

Default: 5 seconds

repeat

Specifies how many times the command is repeated.

Values: 1 to 999

Default: 10

absolute: Keyword to display the raw statistics, without processing. No calculations are performed on the delta or rate statistics.

rate: Keyword to display the rate per second for each statistic instead of the delta.

Output

The following output is an example of port statistics.

Sample output

A:ALA-12>monitor# port 1/1/4 interval 3 repeat 3 absolute
===============================================================================
Monitor statistics for Port 1/1/4
===============================================================================
                                             Input                      Output
-------------------------------------------------------------------------------
At time t = 0 sec (Base Statistics)
-------------------------------------------------------------------------------
Octets                                           0                           0
Packets                                         39                         175
Errors                                           0                           0
-------------------------------------------------------------------------------
At time t = 3 sec (Mode: Absolute)
-------------------------------------------------------------------------------
Octets                                           0                           0
Packets                                         39                         175
Errors                                           0                           0
-------------------------------------------------------------------------------
At time t = 6 sec (Mode: Absolute)
-------------------------------------------------------------------------------
Octets                                           0                           0
Packets                                         39                         175
Errors                                           0                           0
-------------------------------------------------------------------------------
At time t = 9 sec (Mode: Absolute)
-------------------------------------------------------------------------------
Octets                                           0                           0
Packets                                         39                         175
Errors                                           0                           0
===============================================================================
A:ALA-12>monitor# 


A:ALA-12>monitor# port 1/1/4 interval 3 repeat 3 rate
===============================================================================
Monitor statistics for Port 1/1/4
===============================================================================
                                             Input                      Output
-------------------------------------------------------------------------------
At time t = 0 sec (Base Statistics)
-------------------------------------------------------------------------------
Octets                                           0                           0
Packets                                         39                         175
Errors                                           0                           0
-------------------------------------------------------------------------------
At time t = 3 sec (Mode: Rate)
-------------------------------------------------------------------------------
Octets                                           0                           0
Packets                                          0                           0
Errors                                           0                           0
-------------------------------------------------------------------------------
At time t = 6 sec (Mode: Rate)
-------------------------------------------------------------------------------
Octets                                           0                           0
Packets                                          0                           0
Errors                                           0                           0
-------------------------------------------------------------------------------
At time t = 9 sec (Mode: Rate)
-------------------------------------------------------------------------------
Octets                                           0                           0
Packets                                          0                           0
Errors                                           0                           0
===============================================================================
A:ALA-12>monitor#

service

Syntax

service

Context

monitor

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

Commands in this context configure criteria to monitor specific service SAP criteria.

id

Syntax

id service-id

Context

monitor>service

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command displays statistics for a specific service, specified by the service-id, at the configured interval until the configured count is reached.

The first screen displays the current statistics related to the service-id. The subsequent statistical information listed for each interval is displayed as a delta to the previous display.

When the keyword rate is specified, the rate per second for each statistic is displayed instead of the delta.

Parameters

service-id: Specifies the unique service identification number of the service in the service domain.

sap

Syntax

sap sap-id [interval seconds] [repeat repeat] [absolute | rate]

Context

monitor>service>id

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command monitors statistics for a SAP associated with this service.

This command displays statistics for a specific SAP, identified by the port-id and encapsulation value, at the configured interval until the configured count is reached.

The first screen displays the current statistics related to the SAP. The subsequent statistical information listed for each interval is displayed as a delta to the previous display.

When the keyword rate is specified, the rate per second for each statistic is displayed instead of the delta.

Parameters

sap-id

Specifies the physical port identifier portion of the SAP definition.

Values


sap-id:	null	[port-id \| lag-id]
	dot1q	[`port-id` \| `lag-id`]:* \| `qtag`
	qinq	[`port-id` \| `lag-id`]:qtag1.qtag2
	port-id	`slot/mda/port`
	lag-id	`lag-id`
		lag	keyword
		id	1 to 200
	qtag1	0 to 4094
	qtag2	*, 0 to 4094

port-id

Specifies the physical port ID in the slot/mda/port format.

If the card in the slot has Media Dependent Adapters (MDAs) installed, the port-id must be in the slot_number/MDA_number/port_number format. For example, 1/2/3 specifies port 3 on MDA 2 in slot 1.

qtag1, qtag2

Specifies the encapsulation value used to identify the SAP on the port or sub-port. If this parameter is not specifically defined, the default value is 0.

Values: qtag1: 0 to 4094 qtag2 : * | 0 to 4094

The values depend on the encapsulation type configured for the interface. The following table describes the allowed values for the port and encapsulation types.

Table 11. Encapsulation type values
Port type	Encap-type	Allowed values	Comments
Ethernet	Null	0	The SAP is identified by the port.
Ethernet	Dot1q	0 to 4094	The SAP is identified by the 802.1Q tag on the port. A 0 qtag1 value also accepts untagged packets on the dot1q port.
Ethernet	QinQ	qtag1: 0 to 4094 qtag2: 0 to 4094	The SAP is identified by two 802.1Q tags on the port. A 0 qtag1 value also accepts untagged packets on the dot1q port.

interval seconds

Specifies the interval for each display in seconds.

Values: 11 to 60

Default: 11 seconds

repeat repeat

Specifies how many times the command is repeated.

Values: 1 to 999

Default: 10

absolute: Keyword to display the absolute rate per second value for each statistic.

rate: Keyword to display the rate per second for each statistic instead of the delta.

Output

The following output is an example of SAP statistics.

Sample output

A:7210SAS-D>monitor>service>id# sap 1/1/1:100
===============================================================================
Monitor statistics for Service 10000 SAP 1/1/1:100
===============================================================================
-------------------------------------------------------------------------------
At time t = 110 sec (Mode: Delta)
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
Ingress QoS Classifier Usage
-------------------------------------------------------------------------------
Classifiers Allocated: 16 Meters Allocated : 8
Classifiers Used : 2 Meters Used : 2
-------------------------------------------------------------------------------
Sap Statistics
-------------------------------------------------------------------------------
Packets Octets
Ingress Stats: 1013264 0
Egress Stats: 163674 0
-------------------------------------------------------------------------------
Sap STP Statistics
-------------------------------------------------------------------------------
Forward transitions : 0 Bad BPDUs rcvd : 0
Cfg BPDUs rcvd : 0 Cfg BPDUs tx : 0
TCN BPDUs rcvd : 0 TCN BPDUs tx : 0
RST BPDUs rcvd : 0 RST BPDUs tx : 0
MST BPDUs rcvd : 0 MST BPDUs tx : 0
-------------------------------------------------------------------------------
Sap per Meter Stats
-------------------------------------------------------------------------------
Packets Octets
Ingress Meter 1 (Unicast)
For. InProf : 0 0
For. OutProf :  210645 0
Ingress Meter 11 (Multipoint)
For. InProf :  0 0
For. OutProf :  87238 0
===============================================================================
A:7210SAS-D>monitor>service>id#

sdp

Syntax

sdp {sdp-id | far-end ip-address} [interval seconds] [repeat repeat] [absolute | rate]

Context

monitor>service>id

Platforms

7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C

Description

This command monitors statistics for an SDP binding associated with this service.

Parameters

sdp-id

Specifies the SDP identifier.

Values: 1 to 17407

absolute: Keyword to display the absolute rate per second value for each statistic.

far-end ip-address: Specifies the system address of the far-end 7210 SAS for the SDP in dotted decimal notation.

interval seconds

Specifies the interval for each display in seconds.

Values: 11 to 60

Default: 11 seconds

rate: Keyword to display the rate per second for each statistic instead of the delta.

repeat repeat

Specifies how many times the command is repeated.

Values: 1 to 999

Default: 10

Output

The following output is an example of SDP statistics.

Sample output

A:ALA-12# monitor service id 100 sdp 10 repeat 3
===============================================================================
Monitor statistics for Service 100 SDP binding 10
===============================================================================
At time t = 0 sec (Base Statistics)
-------------------------------------------------------------------------------
I. Fwd. Pkts. : 0 I. Dro. Pkts. : 0
E. Fwd. Pkts. : 0 E. Fwd. Octets : 0
-------------------------------------------------------------------------------
At time t = 11 sec (Mode: Delta)
-------------------------------------------------------------------------------
I. Fwd. Pkts. : 0 I. Dro. Pkts. : 0
E. Fwd. Pkts. : 0 E. Fwd. Octets : 0
-------------------------------------------------------------------------------
At time t = 22 sec (Mode: Delta)
-------------------------------------------------------------------------------
I. Fwd. Pkts. : 0 I. Dro. Pkts. : 0
E. Fwd. Pkts. : 0 E. Fwd. Octets : 0
-------------------------------------------------------------------------------
At time t = 33 sec (Mode: Delta)
-------------------------------------------------------------------------------
I. Fwd. Pkts. : 0 I. Dro. Pkts. : 0
E. Fwd. Pkts. : 0 E. Fwd. Octets : 0
===============================================================================
A:ALA-12#