Basic Command Reference

Command Hierarchies

Basic CLI Commands

back
clear
echo [text-to-echo] [extra-text-to-echo] [more-text]
exec [-echo] [-syntax] {filename | <<[eof-marker-string]}
exit [all]
help
help edit
help globals
help special-characters
info [detail]
logout
— mrinfo         [See 7705 SAR OS OAM and Diagnostics Guide for command description] 
— mstat           [See 7705 SAR OS OAM and Diagnostics Guide for command description]  
— mtrace        [See 7705 SAR OS OAM and Diagnostics Guide for command description]  
— oam             [See 7705 SAR OS OAM and Diagnostics Guide for command description]  
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 [timeout timeout]
pwc [previous]
sleep [seconds]
ssh host [-l username] [-v ssh-version] [router router-instance | service-name service-name]
telnet [ip-address | dns-name] [port] [router router-instance]
traceroute {ip-address | dns-name}[ttl ttl] [wait milliseconds] [no-dns] [source ip-address] [tos type-of-service] [router router-instance]
tree [detail]
write {user | broadcast} message-string

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]
length lines
time-display {local | utc}
[no] time-stamp

Monitor Commands

monitor
filter
ip ip-filter-id entry entry-id [interval seconds] [repeat repeat] [absolute | rate]
ipv6 ip-filter-id entry entry-id [interval seconds] [repeat repeat] [absolute | rate]
ip entry entry-id [interval seconds] [repeat repeat] [absolute | rate]
ipv6 entry entry-id [interval seconds] [repeat repeat] [absolute | rate]
port port-id [port-id...(up to 5 max)] [interval seconds] [repeat repeat] [absolute | rate]
router router-instance
— ldp
session ldp-id [ldp-id...(up to 5 max)] [interval seconds] [repeat repeat] [absolute | rate]
statistics [interval seconds] [repeat repeat] [absolute | rate]
— pim
group grp-ip-address [source ip-address] [interval interval] [repeat repeat] [absolute | rate]
— rip
neighbor neighbor [neighbor...(up to 5 max)] [interval seconds] [repeat repeat] [absolute | rate]
— vrrp
instance interface interface-name vr-id virtual-router-id [interval seconds] [repeat repeat] [absolute | rate]
id service-id
sap sap-id [interval seconds] [repeat repeat] [absolute | rate]
sap-aggregation-group group-id [interval seconds] [repeat repeat] [absolute | rate]
sdp {sdp-id | far-end ip-address} [interval seconds] [repeat repeat] [absolute | rate]

Show Commands

show
alias

Command Descriptions

Basic CLI Commands

enable-admin

Syntax 
enable-admin
Context 
<global>
Description 

See the description for the admin-password command. If the admin-password is configured in the config>system>security>password context, then 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 given access to this command.

Once the enable-admin command is entered, the user is prompted for a password. If the password matches, the user is given unrestricted access to all the 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.

The following displays an example of the password command usage.

Example:
config>system>security#password
security>password# admin-password test1234 hash
security>password# aging 365
security>password# minimum-length 8
security>password# attempts 5 time 5 lockout 20
security>password# authentication-order radius tacplus local
security>password# enable-admin
Password: test1234
security>password#

The following example displays the password configuration:

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

There are two ways to verify that a user is in the enable-admin mode:

  1. show users – administrator can learn which users are in this mode
  2. enter the enable-admin command again at the root prompt and an error message will be returned
A:ALU-1# show users
===============================================================================
User              Type    Login time                            Idle time
  From
===============================================================================
admin             Console        --                             0d 19:42:22
  --
admin             Telnet  08APR2008 08:35:23                    0d 00:00:00
  138.120.141.147
-------------------------------------------------------------------------------
Number of users : 2
===============================================================================
A:ALU-1#
A:ALU-1# enable-admin
MINOR: CLI Already in admin mode.
A:ALU-1#

back

Syntax 
back
Context 
<global>
Description 

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

clear

Syntax 
clear
Context 
<global>
Description 

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

Parameters 
card—
reinitializes an I/O module in a specified slot
cron—
clears CRON history
filter—
clears IP filter counters
log—
closes and reinitializes the log specified by log-id
mda—
reinitializes the specified MDA in a particular slot
port—
clears port statistics
radius—
clears the RADIUS server state
router—
clears router commands affecting the router instance in which they are entered
Values—
arp, authentication, bfd, forwarding-table, interface, ldp, mpls, rip
saa—
clears the SAA test results
screen—
clears the console or Telnet screen
service—
clears service ID and statistical entities
system—
clears (re-enables) a previously failed reference
tacplus—
clears the TACACS+ server state
trace—
clears the trace log
vrrp—
clears and resets the VRRP interface and statistical entities

echo

Syntax 
echo [text-to-echo] [extra-text-to-echo] [more-text]
Context 
<global>
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] {filename | <<[eof-marker-string]}
Context 
<global>
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.

Related commands are:

  1. Use this command to configure a URL for a CLI script to exec following a successful configuration boot.
  2. Use this command to configure a URL for a CLI script to exec following a failed configuration boot.
Parameters 
-echo—
echoes the contents of the exec file to the session screen as it executes
Values—
echo disabled
-syntax—
performs a syntax check of the file without executing the commands. Syntax checking will be able to find invalid commands and keywords, but it will not be able to validate erroneous user-supplied parameters.
Values—
execute file commands
filename—
the text file 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 will be silently ignored. The exec command will indicate the command error line number when the stdin input is terminated with an end-of-file input.

eof-marker-string—
The ASCII printable string 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.
Values—
<Ctrl-c>, EOF

exit

Syntax 
exit [all]
Context 
<global>
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, then the exit command only moves the cursor back one level.

ALU-1# configure
ALU-1>config# router
ALU-1>config>router# mpls
ALU-1>config>router>mpls# exit
ALU-1>config>router# exit
ALU-1>config# exit

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

ALU-1# configure router mpls
ALU-1>config>router>mpls# exit
ALU-1#

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

ALU-1# configure
ALU-1>config# router
ALU-1>config>router# mpls
ALU-1>config>router>mpls# exit all
ALU-1#
Parameters 
all—
exits back to the root CLI context

help

Syntax 
help
help edit
help globals
help special-characters
Context 
<global>
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
explanation 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 
help—
displays a brief description of the help system
help edit—
displays help on editing

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
help globals—
displays help on global commands

Available global commands:

back            - Go back a level in the command tree
echo            - Echo the text that is typed in
enable-admin    - Enables 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
help special-characters—
displays 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 ?—
display command’s syntax and associated keywords
string<Tab> or string<Space>—
complete a partial command name (auto-completion) or list available commands that match the string

history

Syntax 
history
Context 
<global>
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.

For example:

ALU-1# history
     68 info
     69 exit
     70 info
     71 filter
     72 exit all
     73 configure
     74 router
     75 info
     76 interface "test"
     77 exit
     79 info
     80 interface "test"
     81 exit all
     82 configure router
     83 interface
     84 info
     85 interface "test"
     86 info
     87 exit all
     88 configure
     89 card 1
     91 exit
     92 router
     93 exit
     94 history
ALU-1# !88
ALU-1# configure
ALU-1>config#

info

Syntax 
info [detail]
Context 
<global>
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.

For example:

ALU-1>config>router>mpls# info
------------------------------------------
mpls
            interface "system"
            exit
            interface "to_1/2/1"
                label-map 131
                    pop
                    no shutdown
                exit
            exit
            static-lsp "to121"
                to 10.8.8.8
                push 121 nexthop 10.1.3.1
                no shutdown
            exit
            no shutdown
        exit
    exit
----------------------------------------------
ALU-1>config>router>mpls#

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 
<global>
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>
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), then this command is automatically invoked.

When invoked, the user is prompted to enter the old password, the new password, and then 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 not allowed 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] [timeout timeout]
Context 
<global>
Description 

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

Parameters 
ip-address—
the IP address of the remote host to ping
Values—
ipv4-address          a.b.c.d (host bits must be 0)
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 to FFFF]H
                                 d:   [0 to 255]D
dns-name—
the DNS name (if DNS name resolution is configured) of the remote host to ping
Values—
128 characters maximum
rapid | detail—
the rapid parameter 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 parameter includes in the output the interface on which the ping reply was received.

ALU-1# ping 192.168.xx.xx4 detail
PING 192.168.xx.xx4: 56 data bytes
64 bytes from 192.168.xx.xx4 via fei0: icmp_seq=0 ttl=64 time=0.000 ms.
64 bytes from 192.168.xx.xx4 via fei0: icmp_seq=1 ttl=64 time=0.000 ms.
64 bytes from 192.168.xx.xx4 via fei0: icmp_seq=2 ttl=64 time=0.000 ms.
64 bytes from 192.168.xx.xx4 via fei0: icmp_seq=3 ttl=64 time=0.000 ms.
64 bytes from 192.168.xx.xx4 via fei0: icmp_seq=4 ttl=64 time=0.000 ms.
---- 192.168.xx.xx4 PING Statistics ----
5 packets transmitted, 5 packets received, 0.00% packet loss
round-trip min/avg/max/stddev = 0.000/0.000/0.000/0.000 ms
ALU-1#
time-to-live
the IP Time To Live (TTL) value to include in the ping request, expressed as a decimal integer
Values—
0 to 128
type-of-service
the type-of-service (TOS) bits in the IP header of the ping packets, expressed as a decimal integer
Values—
0 to 255
bytes—
the size in bytes of the ping request packets
Values—
0 to 65507
Values—
56 bytes (actually 64 bytes because 8 bytes of ICMP header data are added to the packet)
pattern
16-bit pattern string to include in the ping packet, expressed as a decimal integer
Values—
0 to 65535
source ip-address
the source IP address to use in the ping requests in dotted-decimal notation
Values—
0.0.0.0 to 255.255.255.255
Values—
the IP address of the egress IP interface
seconds
the interval in seconds between consecutive ping requests, expressed as a decimal integer
Values—
1 to 10000
Values—
1
next-hop ip-address
this option disregards the routing table and will send 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—
a valid IP next hop IP address
Values—
per the routing table
interface-name
specifies the interface name
bypass-routing—
sends 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.
requests
the number of ping requests to send to the remote host, expressed as a decimal integer
Values—
1 to 10000
Values—
5
do-not-fragment—
specifies that the request frame should not be fragmented. This option is particularly useful in combination with the size parameter for maximum MTU determination.
router-instance
specifies the router name or service ID
Values—
router-name:       Base, management
service-id:          1 to 2147483647
Values—
Base
timeout
specifies the timeout in seconds
Values—
1 to 10
Values—
5

pwc

Syntax 
pwc [previous]
Context 
<global>
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.

For example:

A:ALU>config>router>mpls# pwc
----------------------------------------------
Present Working Context :
----------------------------------------------
 <root> 
  configure
  router “Base”
  mpls
----------------------------------------------
A:ALU>config>router>mpls#

When the previous keyword is specified, the previous context is displayed. 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—
displays the previous working context

sleep

Syntax 
sleep [seconds]
Context 
<global>
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
Values—
1

ssh

Syntax 
ssh host [-l username] [-v ssh-version] [router router-instance | service-name service-name]
Context 
<global>
Description 

This command opens a Secure Shell (SSH) session with another host.

This command initiates a client 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 the SSH session.

Parameters 
host—
the remote host for an SSH session. The IP address, DNS name (if DNS name resolution is configured), or the user name at the IP address can be specified.

For IPv6 addresses, including the “-interface” for the link local address is mandatory; otherwise, “-interface” is omitted. For example, if the user is alu_admin and the IPv6 hostname consists of FE80::9876:DEEF:154D along with the link local interface “ies1_chicago”, then the full command would be (note the “-” between the ipv6-address and the interface):

ssh -l alu_admin FE80::9876:DEEF:154D-ies1_chicago

Values—
[user@]hostname:     255 characters maximum
  user:                         user name, 32 characters maximum
  hostname:             [dns-name | ipv4-address | ipv6-address]
    dns-name:           128 characters maximum
    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
                                interface:  interface name, 32 characters                                             maximum, mandatory for link local                                             addresses
-l username
the user name to use when opening the SSH session
-v ssh-version
the version of the SSH session to use
Values—
1, 2, or 1-2 (for SSH-1 only, SSH-2 only, or SSH-1 and SSH-2)
router-instance—
the router name or service ID
Values—
router-name:          Base, management
service-id:              1 to 2147483647
Values—
Base

telnet

Syntax 
telnet [ip-address | dns-name] [port] [router router-instance]
Context 
<global>
Description 

This command opens a Telnet session to a remote host.

Telnet servers in 7705 SAR networks limit a Telnet client to three retries to log in. The Telnet server disconnects the Telnet client session after three retries. The number of retry attempts for a Telnet client session is not user-configurable.

Parameters 
ip-address —
the IP address of the remote host
Values—
ipv4-address          a.b.c.d (host bits must be 0)
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 to FFFF]H
                                 d:   [0 to 255]D
dns-name—
the DNS name (if DNS name resolution is configured) of the remote host
Values—
128 characters maximum
port—
the TCP port number to use to Telnet to the remote host, expressed as a decimal integer
Values—
1 to 65535
Values—
23
router-instance—
the router name or service ID
Values—
router-name:          Base, management
service-id:              1 to 2147483647
Values—
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 
<global>
Description 

The TCP/IP traceroute utility determines the route to a destination address. Note that aborting a traceroute with the <Ctrl-c> command could require issuing a second <Ctrl-c> command before the prompt is returned.

ALU-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
ALU-1#
Parameters 
ip-address—
the IP address to trace
Values—
ipv4-address           a.b.c.d (host bits must be 0)
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 to FFFF]H
                                  d:   [0 to 255]D
dns-name —
the DNS name (if DNS name resolution is configured)
Values—
128 characters maximum
ttl
the maximum Time-To-Live (TTL) value to include in the traceroute request, expressed as a decimal integer
Values—
1 to 255
milliseconds—
the time in milliseconds to wait for a response to a probe, expressed as a decimal integer
Values—
1 to 60000
Values—
5000
no-dns—
when the no-dns keyword is specified, a DNS lookup for the specified host name will not be performed
Values—
DNS lookups are performed
source ip-address
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’s interfaces, an error is returned.
type-of-service
the type-of-service (TOS) bits in the IP header of the probe packets, expressed as a decimal integer
Values—
0 to 255
router-instance—
the router name or service ID
Values—
router-name:          Base, management
service-id:              1 to 2147483647
Values—
Base

tree

Syntax 
tree [detail]
Context 
<global>
Description 

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

Parameters 
detail—
includes parameter information for each command displayed in the tree output

write

Syntax 
write {user | broadcast} message-string
Context 
<global>
Description 

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

Parameters 
user—
the name of a user with an active console session to which to send a console message
Values—
any valid CLI username
broadcast—
specifies that the message-string is to be sent to all users logged in to the router
message-string—
the message string to send, up to 250 characters long composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, etc.), the entire string must be enclosed within double quotes.

Environment Commands

alias

Syntax 
alias alias-name alias-command-name
no alias alias-name
Context 
environment
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 easier to understand and remember. If the string contains special characters (#, $, spaces, etc.), 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 root>environment context.

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

alias soi “show router mpls interface”

Parameters 
alias-name—
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-name—
the command line to be associated

create

Syntax 
[no] create
Context 
environment
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

more

Syntax 
[no] more
Context 
environment
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 with 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 

more

reduced-prompt

Syntax 
reduced-prompt [no-of-nodes-in-prompt]
no reduced-prompt
Context 
environment
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, which can cause 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 (“…”).

ALU-1>environment# reduced-prompt 2
ALU-1>config>router# interface to-103
ALU-1>...router>if#

Note that 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—
the maximum number of higher-level nodes displayed by name in the prompt, expressed as a decimal integer
Values—
0 to 15
Values—
2

saved-ind-prompt

Syntax 
[no] saved-ind-prompt
Context 
environment
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.

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

terminal

Syntax 
terminal
Context 
environment
Description 

This command enables the context to configure the terminal screen length for the current CLI session.

length

Syntax 
length lines
Context 
environment>terminal
Description 

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

Default 

24 — terminal dimensions are set to 24 lines long by 80 characters wide

Parameters 
lines—
the number of lines for the terminal screen length, expressed as a decimal integer
Values—
1 to 512

time-display

Syntax 
time-display {local | utc}
Context 
environment
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 
[no] time-stamp
Context 
environment
Description 

This command displays timestamps before the CLI prompt, indicating the last time that the command was completed. The date and time are displayed; the time format is either local or UTC, depending on how it was set with the time-display command.

Default 

no time-stamp

Monitor CLI Commands

filter

Syntax 
filter
Context 
monitor
Description 

This command enables the context to configure criteria to monitor IP filter statistics.

ip

Syntax 
ip ip-filter-id entry entry-id [interval seconds] [repeat repeat] [absolute | rate]
Context 
monitor>filter
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 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 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 for the specified filter entry ID
Values—
1 to 65535
seconds
configures the interval for each display in seconds
Values—
3 to 60
Values—
10  
repeat—
configures how many times the command is repeated
Values—
1 to 999
Values—
10
absolute—
displays raw statistics, without processing. No calculations are performed on the delta or rate statistics.
rate —
displays the rate per second for each statistic instead of the delta
Output 

The following output is an example of statistical information for the specified IP filter entry.

Sample Output
ALU-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
===============================================================================
ALU-1>monitor#
ALU-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

ipv6

Syntax 
ipv6 ipv6-filter-id entry entry-id [interval seconds] [repeat repeat] [absolute | rate]
Context 
monitor>filter
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 screen output.

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 is displayed. Monitor commands display the selected statistics according to the configured number of times at the interval specified.

Parameters 
ipv6-filter-id—
displays detailed information for the specified filter ID and its filter entries
Values—
1 to 65535
entry-id—
displays information for the specified filter entry ID
Values—
1 to 65535
seconds
configures the interval for each display in seconds
Values—
3 to 60
Values—
10
repeat—
configures how many times the command is repeated
Values—
1 to 999
Values—
10
absolute—
displays raw statistics, without processing. No calculations are performed on the delta or rate statistics.
rate —
displays the rate per second for each statistic instead of the delta

management-access-filter

Syntax 
management-access-filter
Context 
monitor
Description 

This command enables the context to configure criteria to monitor management access filters. Management access filters control all traffic. They can be used to restrict management of the 7705 SAR by other nodes outside specific (sub)networks or through designated ports.

ip

Syntax 
ip entry entry-id [interval seconds] [repeat repeat] [absolute | rate]
Context 
monitor>management-access-filter
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 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 is displayed. Monitor commands display the selected statistics according to the configured number of times at the interval specified.

Parameters 
entry-id—
displays information for the specified filter entry ID
Values—
1 to 9999
seconds
configures the interval for each display in seconds
Values—
3 to 60
Values—
10
repeat—
configures how many times the command is repeated
Values—
1 to 999
Values—
10
absolute—
displays raw statistics, without processing. No calculations are performed on the delta or rate statistics.
rate —
displays the rate per second for each statistic instead of the delta

ipv6

Syntax 
ipv6 entry entry-id [interval seconds] [repeat repeat] [absolute | rate]
Context 
monitor>management-access-filter
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 screen output.

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 is displayed. Monitor commands display the selected statistics according to the configured number of times at the interval specified.

Parameters 
entry-id—
displays information for the specified filter entry ID
Values—
1 to 9999
seconds
configures the interval for each display in seconds
Values—
3 to 60
Values—
10  
repeat—
configures how many times the command is repeated
Values—
1 to 999
Values—
10
absolute—
displays raw statistics, without processing. No calculations are performed on the delta or rate statistics.
rate —
displays the rate per second for each statistic instead of the delta

port

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

This command enables port traffic monitoring. The specified port(s) statistical information is displayed at the configured interval until the configured count is reached.

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

When the keyword rate is specified, the rate per second for each statistic is displayed instead of the delta. The percentage of the port being used is also displayed. For Ethernet ports, the usage includes inter-frame gap and preamble.

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 
port-id—
specifies up to 5 port IDs
Values—
port-id:              slot/mda/port[.channel]
seconds—
configures the interval for each display in seconds
Values—
3 to 60
Values—
10
repeat—
configures how many times the command is repeated
Values—
1 to 999
Values—
10
absolute—
displays raw statistics, without processing. No calculations are performed on the delta or rate statistics.
rate —
displays the rate per second for each statistic instead of the delta
Output 

The following output is an example of statistical information about the port.

Sample Output
ALU-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
===============================================================================
ALU-12>monitor# 
ALU-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
Utilisation (% of port capacity)              0.00                        0.00
-------------------------------------------------------------------------------
At time t = 6 sec (Mode: Rate)
-------------------------------------------------------------------------------
Octets                                           0                           0
Packets                                          0                           0
Errors                                           0                           0
Utilisation (% of port capacity)              0.00                        0.00
-------------------------------------------------------------------------------
At time t = 9 sec (Mode: Rate)
-------------------------------------------------------------------------------
Octets                                           0                           0
Packets                                          0                           0
Errors                                           0                           0
Utilisation (% of port capacity)              0.00                        0.00
===============================================================================
ALU-12>monitor#

router

Syntax 
router router-instance
Context 
monitor
Description 

This command enables the context to configure criteria to monitor statistical information for LDP and MPLS protocols.

Parameters 
router-instance—
specifies the router name or service ID
Values—
router-name:            Base, management
service-id:                1 to 2147483647
Values—
Base

session

Syntax 
session ldp-id [ldp-id...(up to 5 max)] [interval seconds] [repeat repeat] [absolute | rate]
Context 
monitor>router>ldp
Description 

This command displays statistical information for LDP sessions at the configured interval until the configured count is reached.

The first screen displays the current statistics related to the specified LDP session(s). The subsequent statistical information listed for each interval is displayed as a delta to the previous screen output.

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 is displayed. Monitor commands display the selected statistics according to the configured number of times at the interval specified.

Parameters 
ldp-id—
specifies the IP address of the LDP session to display
Values—
ip-address[:label-space]
ip-address — a.b.c.d
label-space — [0..65535]
seconds
configures the interval for each display in seconds
Values—
3 to 60
Values—
10
repeat—
configures how many times the command is repeated
Values—
1 to 999
Values—
10
absolute—
displays raw statistics, without processing. No calculations are performed on the delta or rate statistics.
rate—
displays the rate per second for each statistic instead of the delta
Output 

The following output is an example of statistical information the LDP session.

Sample Output
ALU-103>monitor>router>ldp# session 10.10.10.104 interval 3 repeat 3 absolute
===============================================================================
Monitor statistics for LDP Session 10.10.10.104
===============================================================================
                              Sent                     Received
-------------------------------------------------------------------------------
At time t = 0 sec (Base Statistics)
-------------------------------------------------------------------------------
FECs                          1                        2
Hello                         5288                     5289
Keepalive                     8225                     8225
Init                          1                        1
Label Mapping                 1                        4
Label Request                 0                        0
Label Release                 0                        0
Label Withdraw                0                        0
Label Abort                   0                        0
Notification                  0                        0
Address                       1                        1
Address Withdraw              0                        0
-------------------------------------------------------------------------------
At time t = 3 sec (Mode: Absolute)
-------------------------------------------------------------------------------
FECs                          1                        2
Hello                         5288                     5289
Keepalive                     8226                     8226
Init                          1                        1
Label Mapping                 1                        4
Label Request                 0                        0
Label Release                 0                        0
Label Withdraw                0                        0
Label Abort                   0                        0
Notification                  0                        0
Address                       1                        1
Address Withdraw              0                        0
-------------------------------------------------------------------------------
At time t = 6 sec (Mode: Absolute)
-------------------------------------------------------------------------------
FECs                          1                        2
Hello                         5288                     5290
Keepalive                     8226                     8226
Init                          1                        1
Label Mapping                 1                        4
Label Request                 0                        0
Label Release                 0                        0
Label Withdraw                0                        0
Label Abort                   0                        0
Notification                  0                        0
Address                       1                        1
Address Withdraw              0                        0
-------------------------------------------------------------------------------
At time t = 9 sec (Mode: Absolute)
-------------------------------------------------------------------------------
FECs                          1                        2
Hello                         5288                     5290
Keepalive                     8226                     8226
Init                          1                        1
Label Mapping                 1                        4
Label Request                 0                        0
Label Release                 0                        0
Label Withdraw                0                        0
Label Abort                   0                        0
Notification                  0                        0
Address                       1                        1
Address Withdraw              0                        0
========================================================================
ALU-12>monitor>router>ldp#
ALU-12>monitor>router>ldp# session 10.10.10.104 interval 3 repeat 3 rate
===============================================================================
Monitor statistics for LDP Session 10.10.10.104
===============================================================================
                              Sent                     Received
-------------------------------------------------------------------------------
At time t = 0 sec (Base Statistics)
-------------------------------------------------------------------------------
FECs                          1                        2
Hello                         5289                     5290
Keepalive                     8227                     8227
Init                          1                        1
Label Mapping                 1                        4
Label Request                 0                        0
Label Release                 0                        0
Label Withdraw                0                        0
Label Abort                   0                        0
Notification                  0                        0
Address                       1                        1
Address Withdraw              0                        0
-------------------------------------------------------------------------------
At time t = 3 sec (Mode: Rate)
-------------------------------------------------------------------------------
FECs                          0                        0
Hello                         0                        0
Keepalive                     0                        0
Init                          0                        0
Label Mapping                 0                        0
Label Request                 0                        0
Label Release                 0                        0
Label Withdraw                0                        0
Label Abort                   0                        0
Notification                  0                        0
Address                       0                        0
Address Withdraw              0                        0
-------------------------------------------------------------------------------
At time t = 6 sec (Mode: Rate)
-------------------------------------------------------------------------------
FECs                          0                        0
Hello                         0                        0
Keepalive                     0                        0
Init                          0                        0
Label Mapping                 0                        0
Label Request                 0                        0
Label Release                 0                        0
Label Withdraw                0                        0
Label Abort                   0                        0
Notification                  0                        0
Address                       0                        0
Address Withdraw              0                        0
-------------------------------------------------------------------------------
At time t = 9 sec (Mode: Rate)
-------------------------------------------------------------------------------
FECs                          0                        0
Hello                         0                        0
Keepalive                     0                        0
Init                          0                        0
Label Mapping                 0                        0
Label Request                 0                        0
Label Release                 0                        0
Label Withdraw                0                        0
Label Abort                   0                        0
Notification                  0                        0
Address                       0                        0
Address Withdraw              0                        0
===============================================================================
ALU-12>monitor>router>ldp#

statistics

Syntax 
statistics [interval seconds] [repeat repeat] [absolute | rate]
Context 
monitor>router>ldp
Description 

This command displays statistics for an LDP instance at the configured interval until the configured count is reached.

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

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 is displayed. Monitor commands display the selected statistics according to the configured number of times at the interval specified.

Parameters 
seconds
configures the interval for each display in seconds
Values—
3 to 60
Values—
10
repeat—
configures how many times the command is repeated
Values—
1 to 999
Values—
10
absolute—
displays raw statistics, without processing. No calculations are performed on the delta or rate statistics.
rate—
displays the rate per second for each statistic instead of the delta
Output 

The following output is an example of statistics for an LDP instance.

Sample Output
ALU-12>monitor>router>ldp# statistics interval 3 repeat 3 absolute
===============================================================================
Monitor statistics for LDP instance
===============================================================================
At time t = 0 sec (Base Statistics)
-------------------------------------------------------------------------------
Addr FECs Sent    : 0                    Addr FECs Recv     : 0
Serv FECs Sent    : 1                    Serv FECs Recv     : 2
...
-------------------------------------------------------------------------------
At time t = 3 sec (Mode: Absolute)
-------------------------------------------------------------------------------
Addr FECs Sent    : 0                    Addr FECs Recv     : 0
Serv FECs Sent    : 1                    Serv FECs Recv     : 2
...
-------------------------------------------------------------------------------
At time t = 6 sec (Mode: Absolute)
-------------------------------------------------------------------------------
Addr FECs Sent    : 0                    Addr FECs Recv     : 0
Serv FECs Sent    : 1                    Serv FECs Recv     : 2
...
-------------------------------------------------------------------------------
At time t = 9 sec (Mode: Absolute)
-------------------------------------------------------------------------------
Addr FECs Sent    : 0                    Addr FECs Recv     : 0
Serv FECs Sent    : 1                    Serv FECs Recv     : 2
...
===============================================================================
ALU-12>monitor>router>ldp#
ALU-12>monitor>router>ldp# statistics interval 3 repeat 3 rate
===============================================================================
Monitor statistics for LDP instance
===============================================================================
At time t = 0 sec (Base Statistics)
-------------------------------------------------------------------------------
Addr FECs Sent    : 0                    Addr FECs Recv     : 0
Serv FECs Sent    : 1                    Serv FECs Recv     : 2
...
-------------------------------------------------------------------------------
At time t = 3 sec (Mode: Rate)
-------------------------------------------------------------------------------
Addr FECs Sent    : 0                    Addr FECs Recv     : 0
Serv FECs Sent    : 0                    Serv FECs Recv     : 0
...
-------------------------------------------------------------------------------
At time t = 6 sec (Mode: Rate)
-------------------------------------------------------------------------------
Addr FECs Sent    : 0                    Addr FECs Recv     : 0
Serv FECs Sent    : 0                    Serv FECs Recv     : 0
...
-------------------------------------------------------------------------------
At time t = 9 sec (Mode: Rate)
-------------------------------------------------------------------------------
Addr FECs Sent    : 0                    Addr FECs Recv     : 0
Serv FECs Sent    : 0                    Serv FECs Recv     : 0
...
===============================================================================

group

Syntax 
group grp-ip-address [source ip-address] [interval interval] [repeat repeat] [absolute | rate]
Context 
monitor>router>pim
Description 

This command monitors statistics for a PIM source group.

Parameters 
grp-ip-address—
specifies the IP address of a multicast group that identifies a set of recipients that are interested in a particular data stream
Values—
multicast group address (IPv4 or IPv6)
ip-address—
specifies the source IP address to use in the ping requests in dotted-decimal notation
Values—
source address (IPv4 or IPv6)
Values—
0.0.0.0 to 255.255.255.255
interval—
specifies the interval for each display, in seconds
Values—
10 | 20 | 30 | 40 | 50 | 60
Values—
10
repeat—
specifies the number of times the command is repeated
Values—
1 to 999
Values—
10
absolute—
displays raw statistics, without processing. No calculations are performed on the delta or rate statistics.
rate—
displays the rate per second for each statistic, instead of the delta

neighbor

Syntax 
neighbor neighbor [neighbor...(up to 5 max)] [interval seconds] [repeat repeat] [absolute | rate]
Context 
monitor>router>rip
Description 

This command displays statistical RIP neighbor information at the configured interval until the configured count is reached.

The first screen displays the current statistics related to the specified RIP neighbor(s). The subsequent statistical information listed for each interval is displayed as a delta to the previous screen output. 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 is displayed. Monitor commands display the selected statistics according to the configured number of times at the interval specified.

Parameters 
neighbor —
the IP address of the neighbor for which to display statistics. Up to 5 neighbors can be specified.
seconds —
configures the interval for each display in seconds
repeat —
specifies how many times to repeat the command
absolute —
displays the raw statistics without processing. No calculations are performed on the delta or rate statistics.
rate —
displays the rate-per-second value for each statistic instead of the delta

instance

Syntax 
instance interface interface-name vr-id virtual-router-id [interval seconds] [repeat repeat] [absolute | rate]
Context 
monitor>router>vrrp
Description 

This command displays statistics for a VRRP instance.

Parameters 
interface-name—
the name of the existing IP interface on which VRRP is configured
virtual-router-id—
the virtual router ID for the existing IP interface, expressed as a decimal integer
seconds
configures the interval for each display in seconds
Values—
3 to 60
Values—
5  
repeat—
configures how many times the command is repeated
Values—
1 to 999
Values—
10
absolute—
displays raw statistics, without processing. No calculations are performed on the delta or rate statistics.
rate—
displays the rate per second for each statistic instead of the delta

service

Syntax 
service
Context 
monitor
Description 

This command enables the context to configure criteria to monitor specific service SAP criteria.

id

Syntax 
id service-id
Context 
monitor>service
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 screen output.

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 is displayed. Monitor commands display the selected statistics according to the configured number of times at the interval specified.

Parameters 
service-id—
identifies the service in the service domain

sap

Syntax 
sap sap-id [interval seconds] [repeat repeat] [absolute | rate]
Context 
monitor>service>id
Description 

This command displays 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 screen output.

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 is displayed. Monitor commands display the selected statistics according to the configured number of times at the interval specified.

Parameters 
sap-id—
identifies the SAP for the service

The sap-id can be configured in one of the formats described in Table 11. The range of values for the parameters follow the table.

Table 11:  SAP ID Configurations   

Type

Syntax

Example

port-id

slot/mda/port[.channel]

1/1/5

bridge

slot/mda/<bridge-id.branch-id>

1/5/16.10

null

[port-id | bundle-id | lag-id | aps-id | mw-link-id]

port-id: 1/1/3

bundle-id: bundle-ppp-1/1.1

lag-id: lag-1

aps-id: aps-1

mw-link-id: mw-link-1

dot1q

[port-id | lag-id | aps-id | mw-link-id]:qtag1

port-id:qtag1: 1/1/3:100

lag-id: lag-1:10

aps-id: aps-1

mw-link-id: mw-link-1

qinq

[port-id | lag-id]:qtag1.qtag2

port-id:qtag1.qtag2: 1/1/3:100.30

lag-id: lag-1:10.10

atm

[port-id | aps-id][:vpi/vci | vpi | vpi1.vpi2] 1

port-id: 1/1/1 or 1/1/1.1 (for T1/E1 channelized ports)

aps-id: aps-1

vpi/vci: 16/26

vpi: 16

vpi1.vpi2: 16.22

lag

lag-id

lag-2

frame

[port-id| aps-id]:dlci

1/1/1

aps-id: aps-1

dlci: 16

frame relay

[port-id]:dlci

1/1/1

dlci: 16

cisco-hdlc

slot/mda/port.channel

1/1/1.3

cem

slot/mda/port.channel

1/1/1.3

ima-grp

bundle-id[:vpi/vci | vpi | vpi1.vpi2]

1/1/3.1

ipcp

slot/mda/port.channel

1/2/2.4

hdlc

slot/mda/port.channel

1/1/3.1

lag-id

lag-id

lag-1

mw-link-id

mw-link-id

mw-link-1

aps-id

aps-group-id[.channel]

aps-1

bundle-id

bundle-[ima | ppp]-slot/mda.bundle-num

bundle-ima-1/1.1

tunnel-id

tunnel-<id>.[private | public]:<tag>

tunnel-1.private:1

    Note:

  1. For Apipes in virtual trunking mode, vpi/vci, vpi, and vpi1.vpi2 are omitted.
Values—
sap-id:

null

[port-id | bundle-id | lag-id | aps-id | mw-link-id]

dot1q

[port-id | lag-id | aps-id | mw-link-id]:qtag1

qinq

[port-id | lag-id]:qtag1.qtag2

atm

[port-id | aps-id][:vpi/vci |vpi | vpi1.vpi2]

frame

[port-id | aps-id]:dlci

cisco-hdlc

slot/mda/port.channel

cem

slot/mda/port.channel

ipcp

slot/mda/port.channel

ima-grp

bundle-id[:vpi/vci | vpi | vpi1.vpi2]

hdlc

slot/mda/port.channel

port-id

slot/mda/port[.channel]

bridge

slot/mda/bridge-id.branch-id

   bridge-id     1 to 16

   branch-id    1 to 32

bundle-id

bundle-type-slot/mda.bundle-num

   bundle            keyword

   type                ima, ppp

   bundle-num   1 to 32

aps-id

aps-group-id[.channel]

   aps                 keyword

   group-id        1 to 24

mw-link-id

mw-link-id

   id   1 to 24

lag-id

lag-id

   lag                  keyword

   id                   1 to 16

qtag1

*, 0 to 4094

qtag2

*, 0 to 4094

vpi

NNI    0 to 4095

UNI    0 to 255

vci

1, 2, 5 to 65535

dlci

16 to 1022

tunnel-id

tunnel-id.[private | public]:tag

   tunnel           keyword

   id                 1 to 16 (1 is the only valid value)

   tag               0 to 4094

port-id—
specifies the physical port ID in the slot/mda/port format

If the card in the slot has an adapter card 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.

The port-id must reference a valid port type. When the port-id parameter represents TDM channels, the port ID must include the channel ID. A period “.” separates the physical port from the channel-id. The port must be configured as an access port.

bridge-id—
specifies an existing bridge that has been configured on an Integrated Services card in the slot/mda/<bridge-id.branch-id> format

bridge-id value range: 1 to 16

branch-id—
specifies an existing branch that has been configured on an Integrated Services card in the slot/mda/<bridge-id.branch-id> format

branch-id value range: 1 to 32

bundle-id—
specifies the multilink (PPP or IMA) bundle identifier. The bundle keyword must be entered at the beginning of the parameter. The command syntax must be configured as follows:

     bundle-id:                 bundle-type-slot/mda.bundle-num

     type:                          ima, ppp

     bundle-num:             1 to 32

For example:

      *A:ALU-12>config# port bundle-ppp-xz5/1.1
      *A:ALU-12>config>port# multilink-bundle
qtag1, qtag2—
specifies the encapsulation value used to identify the SAP on the port or sub-port. For dot1q encapsulation, only qtag1 is used; for qinq encapsulation, both qtag1 and qtag2 are used. If qtag1 or qtag2 is not specifically defined, the value 0 is used. The “*” value represents all qtag values between 0 and 4094 that are not specifically defined within another SAP context under the same port. In addition, the following qtag1.qtag2 values are invalid options:
  1. *.qtag2
  2. *.0
  3. 0.qtag2
Values—
qtag1: *, 0 to 4094
qtag2: *, 0 to 4094
The values depend on the encapsulation type configured for the interface. Table 12 describes the allowed values for the port and encapsulation types.
Table 12:  Port and Encapsulation Values    

Port Type

Encap-Type

Allowed Values

Comments

Ethernet

Null

The SAP is identified by the port.

Ethernet

Dot1q

*, 0 to 4094

The SAP is identified by the 802.1Q tag on the port. Note that a 0 qtag1 value also accepts untagged packets on the dot1q port, and that a * qtag1 value accepts any VLAN ID that is not specifically configured on the port. 1

Ethernet

QinQ

*, 0 to 4094

The SAP is identified by the two 802.1Q tags on the port. Note that a 0 qtag1 or qtag 2 value also accepts untagged packets on the qinq port, and that a * qtag1 or qtag2 value accepts any VLAN ID that is not specifically configured on the port. 1

    Note:

  1. Traffic matching the * qtag value uses VLAN 4095 internally.
seconds
configures the interval for each display in seconds
Values—
11 to 60
Values—
11  
repeat—
configures how many times the command is repeated
Values—
1 to 999
Values—
10
absolute—
displays the absolute rate-per-second value for each statistic
rate—
displays the rate per second for each statistic instead of the delta.

sap-aggregation-group

Syntax 
sap-aggregation-group group-id [interval seconds] [repeat repeat] [absolute | rate]
Context 
monitor>service>id
Description 

This command displays the statistics for the specified SAP aggregation group that is associated with the service.

Parameters 
group-id—
specifies the identifier for the SAP aggregation group
Values—
1 to 32 characters
seconds
configures the interval for each display in seconds
Values—
11 to 60
Values—
11  
repeat—
configures how many times the command is repeated
Values—
1 to 999
Values—
10
absolute—
displays the absolute rate-per-second value for each statistic
rate—
displays the rate per second for each statistic instead of the delta
Output 

The following output is an example of statistics for a SAP aggregation group.

Sample Output
*A:SYS28# monitor service id 1570 sap-aggregation-group SAG repeat 2 
 
===============================================================================
Monitor statistics for Service 1570 SAP Aggregation Group SAG
===============================================================================
-------------------------------------------------------------------------------
At time t = 0 sec (Base Statistics)
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
Sap Aggregation Group Statistics
-------------------------------------------------------------------------------
Last Cleared Time     : N/A                    
 
Dropped Egress Cells (unconfigured vpi/vci): 14
 
                        Packets                 Octets
Forwarding Engine Stats
Dropped               : 0                       n/a                            
Off. HiPrio           : 205557                  n/a                            
Off. LowPrio          : n/a                     n/a                            
 
Queueing Stats(Ingress QoS Policy 1)
Dro. HiPrio           : 0                       n/a                            
Dro. LowPrio          : n/a                     n/a                            
For. InProf           : 0                       0                              
For. OutProf          : 205557                  68605598                       
 
Queueing Stats(Egress QoS Policy 1)
Dro. InProf           : 0                       n/a                            
Dro. OutProf          : n/a                     n/a                            
For. InProf           : 202446                  63083956                       
For. OutProf          : n/a                     n/a                            
-------------------------------------------------------------------------------
Sap Aggregation Group per Queue Stats
-------------------------------------------------------------------------------
                        Packets                 Octets
 
Ingress Queue 1 (Priority)
Off. HiPrio           : 205557                  n/a                            
Off. LoPrio           : n/a                     n/a                            
Dro. HiPrio           : 0                       n/a                            
Dro. LoPrio           : n/a                     n/a                            
For. InProf           : 0                       0                              
For. OutProf          : 205557                  68605598                       
 
Egress Queue 1
For. InProf           : 202446                  63083956                       
For. OutProf          : n/a                     n/a                            
Dro. InProf           : 0                       n/a                            
Dro. OutProf          : n/a                     n/a                            
 
-------------------------------------------------------------------------------
At time t = 11 sec (Mode: Delta)
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
Sap Aggregation Group Statistics
-------------------------------------------------------------------------------
Last Cleared Time     : N/A                    
 
Dropped Egress Cells (unconfigured vpi/vci): 14
 
                        Packets                 Octets
Forwarding Engine Stats
Dropped               : 0                       n/a                            
Off. HiPrio           : 233                     n/a                            
Off. LowPrio          : n/a                     n/a                            
 
Queueing Stats(Ingress QoS Policy 1)
Dro. HiPrio           : 0                       n/a                            
Dro. LowPrio          : n/a                     n/a                            
For. InProf           : 0                       0                              
For. OutProf          : 233                     77822                          
 
Queueing Stats(Egress QoS Policy 1)
Dro. InProf           : 0                       n/a                            
Dro. OutProf          : n/a                     n/a                            
For. InProf           : 232                     72384                          
For. OutProf          : n/a                     n/a                            
-------------------------------------------------------------------------------
Sap Aggregation Group per Queue Stats
-------------------------------------------------------------------------------
                        Packets                 Octets
 
Ingress Queue 1 (Priority)
Off. HiPrio           : 233                     n/a                            
Off. LoPrio           : n/a                     n/a                            
Dro. HiPrio           : 0                       n/a                            
Dro. LoPrio           : n/a                     n/a                            
For. InProf           : 0                       0                              
For. OutProf          : 233                     77822                          
 
Egress Queue 1
For. InProf           : 232                     72384                          
For. OutProf          : n/a                     n/a                            
Dro. InProf           : 0                       n/a                            
Dro. OutProf          : n/a                     n/a                            
 
-------------------------------------------------------------------------------
At time t = 22 sec (Mode: Delta)
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
Sap Aggregation Group Statistics
-------------------------------------------------------------------------------
 
Last Cleared Time     : N/A                    
 
Dropped Egress Cells (unconfigured vpi/vci): 14
 
                        Packets                 Octets
Forwarding Engine Stats
Dropped               : 0                       n/a                            
Off. HiPrio           : 232                     n/a                            
Off. LowPrio          : n/a                     n/a                            
 
Queueing Stats(Ingress QoS Policy 1)
Dro. HiPrio           : 0                       n/a                            
Dro. LowPrio          : n/a                     n/a                            
For. InProf           : 0                       0                              
For. OutProf          : 232                     77488                          
 
Queueing Stats(Egress QoS Policy 1)
Dro. InProf           : 0                       n/a                            
Dro. OutProf          : n/a                     n/a                            
For. InProf           : 233                     72696                          
For. OutProf          : n/a                     n/a                            
-------------------------------------------------------------------------------
Sap Aggregation Group per Queue Stats
-------------------------------------------------------------------------------
                        Packets                 Octets
 
Ingress Queue 1 (Priority)
Off. HiPrio           : 232                     n/a                            
Off. LoPrio           : n/a                     n/a                            
Dro. HiPrio           : 0                       n/a                            
Dro. LoPrio           : n/a                     n/a                            
For. InProf           : 0                       0                              
For. OutProf          : 232                     77488                          
 
Egress Queue 1
For. InProf           : 233                     72696                          
For. OutProf          : n/a                     n/a                            
Dro. InProf           : 0                       n/a                            
Dro. OutProf          : n/a                     n/a                            
 

sdp

Syntax 
sdp {sdp-id | far-end ip-address} [interval seconds] [repeat repeat] [absolute | rate]
Context 
monitor>service>id
Description 

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

Parameters 
sdp-id—
specifies the SDP identifier
Values—
1 to 17407
ip-address—
the system address of the far-end 7705 SAR for the SDP in dotted-decimal notation
seconds
configures the interval for each display in seconds
Values—
11 to 60
Values—
11  
repeat—
configures how many times the command is repeated
Values—
1 to 999
Values—
10
absolute—
displays raw statistics, without processing. No calculations are performed on the delta or rate statistics
rate—
displays the rate per second for each statistic instead of the delta
Output 

The following output is an example of statistics for the SDP binding associated with the service.

Sample Output
ALU-12# monitor service id 100 sdp 10 repeat 2
===============================================================================
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
-------------------------------------------------------------------------------
===============================================================================
ALU-12#

Show Commands

alias

Syntax 
alias
Context 
show
Description 

This command displays a list of existing aliases.

Output 

The following output is an example of alias information, and Table 13 describes the fields.

Sample Output
ALU-103>config>system# show alias
==============================================================================
Alias-Name                    Alias-command-name
==============================================================================
sri                           show router interface
sse                           show service service-using cpipe
ssvll                         show service service-using vll
------------------------------------------------------------------------------
Number of aliases : 3
==============================================================================
ALU-103>config>system#
Table 13:  Show Alias Output Fields  

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