Shelf Operations Commands

Available Languages

Download Options

PDF (555.5 KB)
View with Adobe Reader on a variety of devices

Updated:November 2, 2007

Bias-Free Language

The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.

Shelf Operations Commands

Table Of Contents

Shelf Operations Commands

Command Summaries

Shelf Management Commands

User Commands

adduser

bye

clrscrn

cmdhistory

cnfpasswd

cnfuser

copy

delete

deluser

dspusers

exit

Help

logout

timeout

who

whoami

Shelf Commands

addshelf

cc

dspcd

dspcds

dspversion

ifShow

memShow

resetcd

resetsys

routeShow

routestatShow

setrev

Node-level Commands

addapsln

addctrlr

addlmiloop

clrallcnf

clrbecnt

clrerr

clrlmistats

clrlog

cnfapsln

cnfclksrc

cnfdate

cnfname

cnfrsrc

cnfstatsmgr

cnftime

cnftmzn

cnftmzngmt

delapsln

dspapsln

dspapscfg

delclksrc

dspclkinfo

dspbecnt

dspndalms

dspndstatus

dspcdalms

dspcdstatus

dspcwmrole

dspenvalms

dspslotalms

dsperr

dspif

dspipif

dspipifcache

dsplmistats

dsplog

dsplogs

dsppvcif

dspsvcif

ipifconfig

pvcifconfig

setipconndebug

svcifconfig

switchapsln

Redundancy Commands

switchcc

dspred

Shelf Operations Commands

This appendix describes the SES PNNI controller commands that are specific to management of the SES PNNI Controller shelf.

These commands use the same conventions as described in "SVC, SPVC, and PNNI Commands."

Command Summaries

Shelf operation commands consist of the following command suites:

Command

Usage

Access Level

State

Log

SNMP Support

User Commands

adduser

Set up a new user name

1

active

yes

bye

Exit the CLI shell

any

any

yes

clrscrn

Clear the terminal screen

any

any

no

cmdhistory

View recent commands executed on the current card

any

any

no

cnfpasswd

Set password for a specified user name

any

active

yes

cnfuser

Configure user information.

1

active

yes

copy

Copy files.

any

any

no

delete

Delete files

1

any

yes

deluser

Remove a user name from the configured user list associated with the shelf

1

active

yes

dspusers

View user IDs that have been configured on the PXM

any

any

no

exit

Exit the CLI shell

any

any

yes

Help

View commands associated with the selected card

any

any

no

logout

Exit the CLI shell

any

any

yes

timeout

Set maximum idle time, in seconds, for a PXM session

super
user

any

no

who

View details associated with user IDs currently active on the PXM

any

any

no

whoami

View the current login ID, access level and associated terminal port

any

any

no

Shelf Commands

addshelf

Adds the SES PNNI Controller to the BPX and to enables AnnexG protocol to run between the BPX and the SES PNNI Controller.

Run this command on the BPX only

any

any

yes

cc

Navigates between different cards within the shelf.

any

any

no

dspcd

View specified card information

Run this command on the BPX and the SES.

any

any

no

dspcds

View card information for all installed cards

Run this command on the BPX and the SES.

any

active

no

dspversion

View version information about the selected card.

any

any

no

memShow

View the memory map

any

any

no

resetcd

Reset a card.

Run this command on the BPX and the SES.

super
user

active

yes

resetsys

Reset the entire shelf

Run this command on the BPX and the SES.

super
user

active

yes

routeShow

View the IP routing of the network layer of the operating system.

any

any

no

routestatShow

View the IP routing statistics for the network layer of the operating system

any

any

no

setrev

Sets the primary and secondary revisions of the specified slolt.

super user

any

yes

Node Level Commands

addapsln

Enables APS on a specified line for the PXM

super
user

active

yes

addctrlr

Enables VSI capabilities on the trunk interface.

Run this command on the BPX only.

super
user

active

yes

addlmiloop

Enables LMI loopback line on the current card.

super
user

active

no

clrallcnf

Clear all configurations and restart system, using a default configuration.

Run this command on the BPX and SES.

super
user

active

yes

clrbecnt

Remove all statistics for APS bit-error counts.

service
group

active

no

clrerr

Remove specified or all error log files.

super
user

any

no

clrlmistats

Clear the LMI (Local Management Interface) statistics on the current PXM.

any

any

no

clrlog

Clear specified or all event log files.

Run this command on the BPX and SES.

super
user

any

yes

cnfapsln

Set APS parameters for a line on the PXM.

super
user

active

yes

cnfclksrc

Configure clock sources.

super
user

active

yes

cnfdate

Set system date.

Run this command on the BPX and SES.

Super
user

active

yes

yes

cnfname

Set node name.

Run this command on the BPX and SES.

super
user

active

yes

cnfrsrc

Configure resource partitions.

Run this command on the BPX only.

1

active

yes

cnfstatsmgr

Set the IP address of statistics manager.

service

group

active

no

cnftime

Set system time.

super

user

active

yes

cnftmzn

Set the system time.

Run this command on the BPX and SES.

super user

active

yes

cnftmzngmt

Set the system time zone.

Run this command on the BPX and SES.

super user

active

yes

delapsln

Remove APS configuration for a specified PXM line.

super user

active

yes

delclksrc

Remove clock source configuration.

super user

active

yes

dspapscfg

Display APS configuration for PXM lines.

any

any

no

dspapsln

Display the status of APS for PXM lines.

any

active

no

dspbecnt

Display APS bit-error count statistics

super
user

active

no

dspclkinfo

View all configured clock sources in the node.

3

active

yes

dspcdalms

Display card alarms.

any

any

no

dspcdstatus

Display card status.

any

any

no

dspcwmrole

View primary, secondary, tertiary, or statistics manager CWM for this node.

any

active

no

dspdate

View current system time.

any

and

no

yes

dspenvalms

Display environment alarms.

any

any

no

dsperr

View the contents of either all error log files or a specific error log file

any

any

no

dspif

View configuration and state information for a broadband interface

any

any

no

dspipif

View IP configuration and statistics for one or all IP interfaces

any

any

no

no

dspipifcache

View interface cache translation table for one or all IP interfaces

any

any

no

no

dsplmistats

View the current local management interface (LMI) configurations

any

any

no

dsplog

View events and messages logged by the current PXM.

In this case, this command should be run on the SES. However, it is also a command in the BPX CLI.

any

any

no

dsplogs

View information from all event log files

any

any

no

dspndalms

Display node alarms.

any

any

no

dspndparms

Display node parameters.

any

any

no

dspndstatus

Display node status.

any

any

no

dsppvcif

View PVC address information for one or all IP interfaces that support PVCs.

any

any

no

no

dspslotalms

Display slot alarms.

any

any

no

dspsvcif

View SVC address information for all IP interfaces that support SVCs

any

any

no

no

ipifconfig

Set interface IP address

super user

active

yes

no

pvcifconfig

Set PVC address information for an IP interface

super user

active

yes

no

setipconndebug

Set debug level for IP connectivity task

super user

any

no

no

svcifconfig

Set SVC address for an IP interface

super user

active

yes

no

switchapsln

Control APS line switch functions.

super user

active

yes

Redundancy Commands

dspred

Displays redundant information.

any

any

no

switch cc

Switch core card.

Run this command on the BPX and SES.

service group

active

yes

Shelf Management Commands

The shelf management commands described in this section are categorized as follows:

•User Commands

•Shelf Commands

•Node-level Commands

•Redundancy Commands

User Commands

This section lists the commands with which to set parameters for users, and perform basic tasks such as view command history, get system help, clear the terminal screen, and exit the system.

adduser

Use the adduser command to configure a user name and associated access level on the PXM.

Syntax Description

adduser <user ID> <accessLevel>

user ID

Case-sensitive name to be used as the login at the PXM.

The name can consist of up to 12 characters composed of alpha and numeric characters, special characters "_" and "-".

The name must begin with an alpha character and cannot contain spaces.

accessLevel

System privilege level to be allocated for the user ID, using one of the following options:

•SERVICE_GP

•SUPER_GP

•GROUP1 (highest level)

•GROUP2

•GROUP3

•GROUP4

•GROUP5

•ANYUSER (lowest level)

The new user that you configure cannot be configured for an accessLevel that is higher than that defined for the current login ID.

Examples

Example C-1 To add a user named fin with privilege level ANYUSER:
spirit.1.1.PXM.a > adduser fin ANYUSER
Enter password:
Re-enter password: 
 
spirit.1.1.PXM.a >
bye

Use the bye command to exit the current CLI shell.

Syntax Description

bye

Examples

Example C-2 To exit the current CLI shell:
spirit.1.2.PXM.a > bye
 
(session ended)
clrscrn

Use the clrscrn command to remove the contents of the control terminal screen. After this command executes, only the current command line prompt displays on the terminal screen.

Syntax Description

clrscrn

Examples

Example C-3 To clear the screen:
flyers01.1.17.AUSM.a > clrscrn
flyers01.1.17.AUSM.a > 
cmdhistory

Use the cmdhistory command to view the last 10 commands executed on the current card.

Syntax Description

cmdhistory

Examples

Example C-4 To view the previous 10 commands executed on the PXM card:
spirit4.1.2.PXM.a > cmdhistory
Size of cmdHistory is currently 10 line(s)
  1 dspconcnt 2.39.45
  2 dsplmistats
  3 dsplmiloop
  4 dsplm
  5 clrportcnt
  6 dspportcnts
  7 dspportcnt
  8 dspportcnt 1
  9 dsplmistats
 10 cmdhistory
spirit4.1.2.PXM.a > 
cnfpasswd

Use the cnfpasswd command to set the password for a specified User ID or type the command without arguments to change your own password.

Syntax Description

cnfpasswd [<user_id>]

user_id

User name

Examples

Example C-5 To modify your own password:
spirit4.1.2.PXM.a > cnfpasswd
Enter password:
Re-enter password:
spirit4.1.2.PXM.a >
cnfuser

Use the cnfuser command to add or change user information.

Syntax Description

cnfuser -u<user id>

user id

User name

password

User password

accessLevel

System privilege level to be allocated for the user ID, using one of the following options:

•SERVICE_GP

•SUPER_GP

•GROUP1 (highest level)

•GROUP2

•GROUP3

•GROUP4

•GROUP5

•ANYUSER (lowest level)

The new user that you configure cannot be configured for an accessLevel that is higher than that defined for the current login ID.

[-p<password>][-l<access level>]

Examples

spirita.1.PXM.a > cnfuser -u myname -p passw123 -l ANYUSER
copy

Use the copy command to copy files.

Syntax Description

copy <source file>

source file

Source file to be copied.

destination file

Destination file.

<destination file>

Examples
spirita.1.PXM.a > copy version vers
spirita.1.PXM.a > ll
  size          date       time       name
--------       ------     ------    --------
     512    MAR-22-2000  19:37:56   SM                <DIR>
     512    MAR-22-2000  19:37:56   FW                <DIR>
     512    MAR-22-2000  19:37:56   DIAG              <DIR>
     512    MAR-22-2000  19:37:56   STATS             <DIR>
     512    MAR-22-2000  19:37:56   TMP               <DIR>
     512    MAR-22-2000  19:37:56   CNF               <DIR>
     512    MAR-22-2000  19:37:56   RPM               <DIR>
     512    MAR-22-2000  19:37:56   SCT               <DIR>
      36    MAY-21-2000  03:31:34   version
     512    MAR-22-2000  11:40:52   LOG               <DIR>
     512    MAR-22-2000  11:40:58   CUT               <DIR>
     512    MAY-09-2000  10:45:04   SHMDB             <DIR>
 1749807    MAY-16-2000  07:10:14   pxm_diag_1.1.04.o
      36    MAY-21-2000  04:41:28   vers
In the file system :
    total space :  819200 K bytes
    free  space :  808145 K bytes
delete

Use the delete command to remove any files on the disk.

Syntax Description

delete <file name>

file name

Name of the file to be removed.

Examples

spirita.1.PXM.a > delete <any_file>

deluser

Use the deluser command to remove a user from the list of users on the SES node. The system does not allow you to delete a user with a privilege level higher than the level at which you execute the command. For example, if the current user privilege is 2, you cannot delete a user at level 1. No screen output appears unless an error occurs.

Syntax Description

deluser <user ID>

user ID

User name, consisting of up to 12 characters

Examples

spirita.1.PXM.a > deluser myname

dspusers

Use the dspusers command to view the user IDs that have been added to the PXM configuration. The screen shows the user name and highest privilege level and displays the number of those levels above user-privilege.

Syntax Description

dspusers

Examples

Example C-6 To view the users configured for this shelf:
wilco.1.1.PXM.a > dspusers
UserId        AccessLevel
-------------------------
cisco         CISCO_GP
service       SERVICE_GP
superuser     SUPER_GP
raoul         GROUP3
duke          GROUP1
wilco.1.1.PXM.a > 
exit

Use the exit command to exit the current CLI shell.

Syntax Description

exit

Examples

Example C-7 To exit from the current CLI shell
spirit4.1.2.PXM.a > exit
(session ended)
Help

Use the Help command to view commands associated with the current card. The Help command also takes arguments and filters the commands based on the argument string.

Syntax Description

Help

Examples
spirita.1.PXM.a > Help
    Available commands
    ------------------
    ?
    abortofflinediag
    abortrev
    addaddr
    addapsln
    addchan
    addcon
    addfltset
    addlmiloop
    addmaster
    addpnni-node
    addpnni-summary-addr
    addpnport
    addprfx
    addred
    addserialif
    addslave
    addtrapmgr
    adduser
Type <CR> to continue, Q<CR> to stop:
logout

Use the logout command to exit the current CLI shell.

Syntax Description

logout

Examples

Example C-8 To log out of the current CLI shell
spirit4.1.2.PXM.a > logout
(session ended)
timeout

Use the timeout command to set maximum idle time, in seconds, for the current session on the PXM. If you do not specify a timeout period in seconds, the system displays the current timeout. To disable the session timeout function, enter a 0.

Syntax Description

timeout [time_out]

time_out

Number of idle time seconds allowed prior to automatically logging off the current user.

Examples

Example C-9 To view the current setting for timeout:
spirit.1.1.PXM.a > timeout
The timeout period for this session is currently 600 second(s)
spirit.1.1.PXM.a >  
 
Example C-10 To set the session timeout threshold to 12 minutes (720 seconds):
spirit.1.1.PXM.a > timeout 720
The timeout period for this session is now set to 720 second(s)
spirit.1.1.PXM.a >
who

Use the who command to view details associated with user IDs currently active on the PXM.

Syntax Description

who

Examples

Example C-11 To view the users logged into the current card:
spirit.1.1.PXM.a > who
Port        Slot      Idle       UserId       From
-------------------------------------------------------------
telnet.01 *    7     0:00:00     cisco        171.71.25.240
 
spirit.1.1.PXM.a >
whoami

Use the whoami command to view the current login ID, access level and associated terminal port.

Syntax Description

whoami

Examples

Example C-12 To view information about the user of the current terminal session:
spirit.1.1.PXM.a > whoami
User ID:        cisco
Access Level:   CISCO_GP
Terminal Port:  telnet.01
spirit.1.1.PXM.a > 
Shelf Commands

This section lists commands with which to perform tasks on the SES PNNI shelf.

addshelf

Use the addshelf command to add the SES PNNI Controller to the BPX and to enable AnnexG protocol to run between the BPX and the SES PNNI Controller.

Note Run this command on the BPX shelf only.

.

Syntax Description

addshelf <slot.port>

slot.port

Slot and Port numbers corresponding to the feeder.

feeder type

Type of feeder when you execute addshelf.

<feeder type>

Examples

addshelf <slot.port>

cc

Use the cc command to navigate from card to card on the shelf.

Syntax Description

cc <slot number>

slot number

The number of the slot that contains the card you want to work on, either 1 or 2.

Examples
spirita.1.PXM.a > cc 2
dspcd

Use the dspcd command to view hardware and firmware information about the selected PXM.

Syntax Description

dspcd <slot number>

slot number

Slot number of the installed PXM, either 1 or 2.

Examples
spirita.2.PXM.s > dspcd
espses3                          System Rev:01.00   Jul. 17, 2000
16:31:25 PST
SES-CNTL                                             Node Alarm:NONE
Slot Number    1    Redundant Slot: 2
                    Front Card          Upper Card          Lower Card
                    ----------          ----------          ----------
Inserted Card:     PXM1_OC3            UIA BackCard        MMF_4_OC3          
Reserved Card:     PXM1_OC3            UIA BackCard        MMF_4_OC3          
State:             Active              Active              Active         
Serial Number:     SBK033300F8         SBK033000QP         SBK03340075 
Prim SW Rev:       1.0(231)A1          ---                 ---
Sec SW Rev:        1.0(231)A1          ---                 ---
Cur SW Rev:        1.0(231)A1          ---                 ---
Boot FW Rev:       1.0(1)              ---                 ---
800-level Rev:     A0                  A0                  A0   
Orderable Part#:   800-05610-02        800-03688-01        800-05053-01
CLEI Code:         BAA4HCZAAA          BAI9Y00AAA          BA2IKNJBAA 
Reset Reason:      On Reset From Shell
Card Alarm:        NONE                
Failed Reason:     None                
Miscellaneous Information:
espses3                          System Rev:01.00   Jul. 17, 2000
16:31:25 PST
SES-CNTL                                             Node Alarm:NONE
Crossbar Slot Status:     No Crossbar
Alarm Causes
------------
    NO ALARMS 
dspcds

Use the dspcds command to view status of all installed cards in the SES PNNI Controller.

Syntax Description

dspcds

Examples
spirita.1.PXM.a > dspcds
spirita                          System Rev: 01.00   May. 21, 2000 05:34:12 PST
Backplane Serial No: 12345       Bp HW Rev:  00.00   GMT Offset: -8
                                                     Node Alarm: CRITICAL
Card  Front/Back       Card           Alarm      Redundant  Redundancy
Slot  Card State       Type           Status     Slot       Type
---   ----------       --------       --------   -------    -----
01    Active/Active   PXM1_OC3        NONE       02         PRIMARY SLOT
02    Standby/Active  PXM1_OC3        NONE       01         SECONDARY SLOT
03    Empty            ---            ---        ---         ---
04    Empty            ---            ---        ---         ---
05    Empty            ---            ---        ---         ---
06    Empty            ---            ---        ---         ---
07    Empty            ---            ---        ---         ---
spirita.1.PXM.a >
dspversion

Use the dspversion command to view version information about the selected card.

Syntax Description

dspversion

Examples
spirita.1.PXM.a > dspversion
  Image Type   Shelf Type    Card Type         Version   Built On
  ----------   ----------   ----------    ------------   ------------
     Runtime          MGX         PXM1          1.0(0)   May 17 2000, 19:36:59
        Boot          MGX         PXM1       1.0(39)B1   -
ifShow

Use the ifShow command to view the contents of all the currently configured interfaces.

Syntax Description

ifShow

Examples
spirit4.1.2.PXM.a > ifShow
lnPci (unit number 0):
     Flags: (0x63) UP BROADCAST ARP RUNNING
     Internet address: 172.29.23.149
     Broadcast address: 172.29.23.255
     Netmask 0xffff0000 Subnetmask 0xffffff00
     Ethernet address is 00:c0:43:00:2d:c7
     Metric is 0
     Maximum Transfer Unit size is 1500
     599468 packets received; 34476 packets sent
     0 input errors; 0 output errors
     0 collisions
lo (unit number 0):
     Flags: (0x69) UP LOOPBACK ARP RUNNING
     Internet address: 127.0.0.1
     Netmask 0xff000000 Subnetmask 0xff000000
     Metric is 0
     Maximum Transfer Unit size is 4096
     4 packets received; 4 packets sent
     0 input errors; 0 output errors
     0 collisions
sl (unit number 0):
     Flags: (0x71) UP POINT-TO-POINT ARP RUNNING
     Internet address: 0.0.0.0
     Destination Internet address: 0.0.0.0
     Netmask 0xff000000 Subnetmask 0xff000000
     Metric is 0
     Maximum Transfer Unit size is 576
     0 packets received; 0 packets sent
     0 input errors; 0 output errors
     0 collisions
atm (unit number 0):
     Flags: (0x43) UP BROADCAST TRAILERS ARP RUNNING
     Internet address: 172.1.1.149
     Broadcast address: 172.1.1.255
     Netmask 0xffff0000 Subnetmask 0xffffff00
     Ethernet address is 00:00:00:00:00:00
     Metric is 0
     Maximum Transfer Unit size is 1500
     0 packets received; 47272 packets sent
     0 input errors; 47272 output errors
     0 collisions
spirit4.1.2.PXM.a >
memShow

Use the memShow command to view the current memory map.

Syntax Description

memShow

Examples

Example C-13 To view current memory allocation on the PXM:
spirit4.1.2.PXM.a > memShow
status    bytes       blocks   avg block  max block
------  ---------    -------- ---------- ----------
current
free      2967104         37      80192   2879008
alloc     2561600       1774       1443        -
cumulative
alloc     241511616  1019558        236        -
 
spirit4.1.2.PXM.a >
resetcd

Use the resetcd command to reset the selected PXM, and to gracefully terminate all current applications on the card.

Syntax Description

resetcd <slot>

slot

Slot number of the installed PXM, either 1 or 2.

Examples
spirita.1.PXM.a > resetcd
The card in slot number 1, will be reset. Please confirm action
Do you want to proceed (Yes/No)? n
(command not executed)
resetsys

Use the resetsys command to reset the SES shelf.

Syntax Description

resetsys

Examples
spirita.1.PXM.a > resetsys
This command resets the entire shelf, a destructive command.
Please confirm now!
Do you want to proceed (Yes/No)? y
Syncing ... C:
Syncing ... D:
Syncing ... E:
Syncing ... F:
Warning: firmware reset on active PXM card by cisco@console
(session ended)
routeShow

Use the routeShow command to view the current IP routing of the network layer of the operating system.

Syntax Description

routeShow

Examples

Example C-14 To view the current IP routing of the network layer of the operating system:
spirit4.1.2.PXM.a > routeShow
 
ROUTE NET TABLE
destination      gateway          flags  Refcnt  Use           Interface
------------------------------------------------------------------------
0.0.0.0          172.29.23.149    1      1       21778         lnPci0
0.0.0.0          172.29.23.1      3      0       2755          lnPci0
172.1.1.0        172.1.1.149      1      0       0             atm0
172.29.23.0      172.29.23.149    1      2       5275          lnPci0
------------------------------------------------------------------------
 
ROUTE HOST TABLE
destination      gateway          flags  Refcnt  Use           Interface
------------------------------------------------------------------------
0.0.0.0          0.0.0.0          5      0       0             sl0
127.0.0.1        127.0.0.1        5      1       0             lo0
172.29.23.3      172.1.1.149      5      0       3555          atm0
172.29.23.5      172.1.1.149      5      0       3304          atm0
172.29.23.7      172.1.1.149      5      0       3335          atm0
171.71.29.18     172.1.1.149      5      0       3304          atm0
172.29.23.18     172.1.1.149      5      0       3304          atm0
172.29.23.28     172.1.1.149      5      0       6127          atm0
172.29.23.29     172.1.1.149      5      1       6065          atm0
171.71.29.32     172.1.1.149      5      0       5842          atm0
171.71.29.44     172.1.1.149      5      0       3304          atm0
172.29.23.53     172.1.1.149      5      0       3304          atm0
171.71.29.59     172.1.1.149      5      0       3304          atm0
171.71.28.126    172.1.1.149      5      0       3309          atm0
------------------------------------------------------------------------
 
spirit4.1.2.PXM.a >
routestatShow

Use the routestatShow command to view the current IP routing statistics for the network layer of the operating system.

Syntax Description

routestatShow

Examples

Example C-15 To view the current IP routing statistics for the network layer of the operating system
spirit4.1.2.PXM.a > routestatShow
  
routing:
        0 bad routing redirect
        0 dynamically created route
        0 new gateway due to redirects
        0 destination found unreachable
        11095 uses of a wildcard route
 
spirit4.1.2.PXM.a >
setrev

Use the setrev command to set the primary and secondary revisions of the slot specified.

Syntax Description

setrev <slot><primary version><secondary version>

slot

Slot number of the card for which the version will be set.

primary version

The primary version number to which the card will be set.

primary version

The secondary version number to which the card will be set

Note Use the revision number for both primary and secondary versions to start a new version.

Examples
spirita.1.PXM.a > setrev 1.0(0) 1.0(0)
one or more card(s) in logical slot 1 will be reset.
Do you want to proceed (Yes/No)? n
(command not executed)
Node-level Commands

This section lists commands with which to perform tasks for controlling the BPX PNNI node.

addapsln

Use the addapsln command to set APS on a specified line for a PXM.

Syntax Description

addapsln <workingline><workslot><protectline><protectslot><archmode>

workingline

Working line number. Enter the value 1.

workslot

Enter value 1 or 2.

•1 = slot 1

•2 = slot 2

protectline

Protection line number. Enter the value 1.

protectslot

Protection slot number. Enter the value 1 or 2.

archmode

Value to set APS architecture mode to be used on the working/protection line pair, as defined for 1+1 two backcards. Enter the value 2.

Examples

Example C-16 To add APS with line 1 of slot 1 as a Working line , and to add line 1 on slot 2 as a protection line. Set the APS architecture mode on the working/protection line pair to 1+1
addapsln 1 1 1 2 2
addctrlr

Use the addctrlr command to enable VSI capabilities on the trunk interface.

Note Run this command on the BPX shelf only.

Syntax Description

addctrlr <slot.port> <Cntl_Id> <Part_Id ><Control_VC_VPI> <Control_VC_VCI>

slot.port

Slot and Port numbers corresponding to the feeder trunk

Cntl_Id

Controller ID corresponding to the PNNI controller. 2 for PNN Controller.

Part_Id

Partition ID of the VSI partition controlled by the PNNI controller. 1 for partition #1.

Control_VC_VPI

Starting VPI of the control VCs. Valid values for this parameter are: 0-4095. The default value is 0.

Control_VC_VCI

Starting VCI of the control VCs. The value is 40 to reserve VCI Range 40 to 54 for control VCs.

Examples

Example C-17 To add controller to port 4 on slot 10, partition ID of 1, and controller ID of 2.

addctrlr 10.4 2 1 0 40

System Response

night TN StrataCom BPX 8600 9.2.00 Apr. 11 1998 14:31 GMT
                                                                                
addlmiloop

Use the addlmiloop command to add an LMI loopback line to the current card.

Syntax Description

addlmiloop <slot> <port>

slot

Slot number, in the range 1 - 2

port

Port number

Note You can activate only one PXM line on the feeder implementation of an SES node.

To add an LMI loopback line numbered 1 to the current card (the PXM in slot [?])

Examples

Example C-18 To add lmi loopback line to the current PXM.

addlmiloop 1.1

clrallcnf

Use the clrallcnf command to remove all configuration databases from the shelf, including configuration stored in BRAM by the shelf manager, and other configuration files currently stored on disk.

Warning This is a destructive command.

Syntax Description

clrallcnf

Examples
spirita.1.PXM.a > clrallcnf
All SM's config will be deleted, and
        the shelf will be reset.
Do you want to proceed (Yes/No)? n
(command not executed)
clrbecnt

Use the clrbecnt command to remove all the statistics for the (APS) bit-error counts

Syntax Description

clrbecnt <Line Number>

Line Number

Enter the value 1.

clrerr

Use the clrerr command to remove specified or all error log files. This command queries for confirmation prior to clearing the error log files from the system.

Syntax Description

clrerr [-en <error number>]

-en

Command delineator that precedes the error number entry.

error number

Number of the log file to clear.

-sl

Command delivered that proceeds the slot number entry.

slot number

Number of the slot in which the selected card resides.

[-sl <slot number>]

Related Commands

dsperr

Examples

Example C-19 To clear the error log in the PXM:
wilco.1.1.PXM.a > clrerr
Do you want to proceed (Yes/No)? No
(command not executed) 
wilco.1.1.PXM.a > 
clrlmistats

Use the clrlmistats command to clear the LMI (Local Management Interface) related statistics on the current PXM.

Syntax Description

clrlmistats

Examples

Example C-20 To clear the LMI statistics on the PXM card
penguin.1.1.PXM.a > clrlmistats
Enabled        :          1   Port Status    :          1
VPI.VCI        :        3.31
Polling enable :          1
T393           :         10   N394           :          5
T394           :         10   N395           :          5
WaitStatus     :          0   WaitStAck      :          0
Retry Timer    :          0   Retry Count    :          1
Poll Timer     :          6   Trans Num      :         86
Status     Rx  :          0   Status     Tx  :          0
UpdtStatus Rx  :          0   UpdtStatus Tx  :          0
Status Enq Rx  :          0   Status Enq Tx  :          0
Status Ack Rx  :          0   Status Ack Tx  :          0
NodeStatus Rx  :          0   NodeStatus Tx  :          0
NodeStaAck Rx  :          0   NodeStaAck Tx  :          0
Bad PDU Rx     :          0   Bad PDU Len Rx :          0
Unknown PDU Rx :          0   Invalid I.E. Rx:          0
Invalid Trans  :          0
BPX IP Addr    :  172.3.3.62
penguin.1.1.PXM.a > 
clrlog

Use the clrlog command to clear specified or all event log files.

Syntax Description

clrlog [-log <log slot>]

-log

Command delineator that precedes the log slot entry.

log slot

Number of the file that you want to clear from the event log file.

Related Commands

dsplog

Examples

Example C-21 To clear all event log files on the PXM card:
wilco.1.1.PXM.a > clrlog
Do you want to proceed (Yes/No)? Yes 
wilco.1.1.PXM.a > 
cnfapsln

Use the cnfapsln command to set APS parameters for a specified line on the PXM card.

Syntax Description

cnfapsln <line> <SFBER> <SDBER> <Revertive> <WTR> <Direction> <KIK2>

line

OC-3 line number. Enter the value 1.

SFBER

Signal failure BER threshold, in the range 3-5.

5 = signal failure BER threshold = 10 ^^ -5.

SDBER

Signal degrade BER threshold, in the range 5-9.

5 = signal degrade BER threshold = 10 ^^ -5.

WTR

Number of minutes to wait before attempting to switch back to the working line, in the range 1-12. This setting is not applicable if the line is configured in non-revertive mode (Revertive set to 1).

Direction

Value to set the switching direction for either unidirectional or bidirectional.

•1 = Unidirectional: This APS line supports switching only one end of the line.

2 = Bidirectional: This APS line supports switching both ends of the line.

Revertive

Value to set the APS revertive or non-revertive function.

•1 = Non-revertive

•2 = Revertive
This setting allows the line to switch back to the working line after the Wait-To-restore interval has expired and the working line SF/SD has been cleared.

K1K2

To to enable or disable the K1/K2 inband protocol on the protection line.

•1 = enable

•2 = disable

Examples

To set the APS working line 1 on the active PXM card in slot 1 to have a signal failure BER threshold of 10^^-5, a signal degrade BER threshold of 10^^-5, to enable switch back after signal failure or degradation has cleared, to wait 2 minutes before attempting to switch back, to make switching bidirectional, and to enable the K1/K2 inband protocol on the protection line
flyers01.1.1.PXM.a > cnfapsln 1 5 5 2 2 2 1
flyers01.1.1.PXM.a > 
\

cnfclksrc

Use the cnfclksrc command to configure clock sources.

Syntax Description

cnfclksrc <priority> <portid> [revertive {enable/disable}]

priority

Determines whether this Clock source is the primary or secondary clock.

portid

Clocksource information in the form of [shelf.]slot[:subslot].port[:subport]

revertive

Enables or disables revertive behavior.

bits

Type of bits. Can be e1 or t1.

[bits {e1/t1}]

Examples
cnfclksrc <priority> <portid>
cnfdate

Use the cnfdate command to set the system date.

Syntax Description

cnfdate <mm/dd/yyyy>

mm/dd/yyyy

Examples
wilso.1.1.PXM.a> cnfdate 12/17/1999
cnfname

Use the cnfname command to set the name of the SES PNNI node. This namewill not be propagated throughout the network.

Syntax Description

cnfname <name>

name

Name of this SES PNNI node, consisting of up to 8 alpha-numeric characters.

Examples
spirita.1.PXM.a > cnfname NewName
cnfname: Configured this node name to NewName Successfully.
NewName.1.PXM.a >
cnfrsrc

Use the cnfrsrc command to configure resource partitions.

Note Run this command on the BPX shelf only.

Syntax Description

cnfrsrc <slot.port>

<slot.port>

Slot and port numbers corresponding to the feeder.

cnfstatsmgr

Use the cnfstatsmgr command to set the IP address of the CWM that manages statistics for this node.

Syntax Description

cnfstatsmgr <ip-address-in-dotted-decimal-notation>

Examples
cnfstatsmgr 172.29.4.50
cnftime

Use the cnftime command to set the system time.

Syntax Description

cnftime <hh:mm:ss>

hh:mm:ss

Examples

Example C-22 To set time for 11:20 a.m. and 30 seconds:
wilco.1.1.PXM.a > cnftime 11:20:30
cnftmzn

Use the cnftmzn command to set the system time zone.

Syntax Description

cnftmzn <timezone>

timezone

•GMT

•EST

•CST

•MST

•PST

Examples
wilco.1.1.PXM.a > cnftmzn PST
cnftmzngmt

Use the cnftmzngmt command to set the system time zone offset value.

Syntax Description

cnftmzngmt <gmtoffset>

gmtoffset

-12, -11, -10

10, 11, 12

Examples

Example C-23 To set system time zone to minus eight hours of GMT:
wilco.1.1.PXM.a > cnftmzngmt -8
delapsln

Use the delapsln command to delete APS from a line on the PXM card.

Syntax Description

delapsln <workingline>

workingline

Working line number. Enter the value 1.

Examples
delapsln 1 
dspapsln

Use the dspapsln command to view the current APS line parameters on the PXM card.

Syntax Description

dspapsln

Examples
spirita.1.PXM.a > dspapsln
 SlotLine Type  Act W_LINE P_LINE APS_ST CDType Dir  Revt LastUsrSwReq
------------------------------------------------------------------------
 1.1&2.1  1+1_2 2.1 ALM    YEL    OK     OC-3   UNI  NRV  NO_REQUEST
dspapscfg

Use the dspapscfg command to view aps configuration information.

Syntax Description

dspapscfg

Examples
spirita.1.PXM.a > dspapscfg
 SlotLine  Type   SFBER  SDBER  WTR  Dir  Revert  K1K2
 -----------------------------------------------------
 1.1&2.1   1+1_2  3      5      1    UNI  NRV     ENA
delclksrc

Use the delclksrc command to remove a configured clock source.

Syntax Description

delclksrc

Examples
spirita.1.PXM.a > delclksrc <priority> <portid>
dspclkinfo

Use the dspclkinfo command to view detailed information about all the configured clock sources in the node.

Syntax Description

dspclkinfo

Examples

Example C-24 To view the detailed clock information for the SES PNNI shelf:
spirit3.1.1.PXM.a > dspclkinfo
 
 ****** Clock HW registers ********
SEL_T1 = t1      SEL100 = ON     SEL120 = ON     SEL120 = ON
NOEXTCLK = ON
 
 priMuxClockSource = INTERNAL_OSC
 prevPriMuxClockSource = INTERNAL_OSC
 primaryInbandClockSourceLineNum = 0
 secMuxClockSource = EXTERNAL_CLOCK
 prevSecMuxClockSource = EXTERNAL_CLOCK
 secondaryInbandClockSourceLineNumber = 1
 currentClockSetReq = primary
 currentClockHwStat = primary
 PreviousClockHwStat = internal
 extClockPresent = No
 extClkConnectorType = RJ45
 extClkSrcImpedance = 100 Ohms
 Internal Clock Status=1, Primary Clock Status=1
 
                 Secondary Clock Status=0, Last inband Clock State=0
last Inband Clock state= 0, Last External Clock Present = 1
spirit3.1.1.PXM.a > 
dspbecnt

Use the dspbecnt command to view the APS bit-error information for a generic line.

Syntax Description

dspbecnt <line>

line

Line number. Enter the value 1.

dspndalms

Use the dspndalms command to view the node alarms. This includes clock alarms, switching alarms, shelfslot alarms, environment alarms, and card alarms.

Syntax Description

dspndalms

Examples
spirita.1.PXM.a > dspndalms
Node Alarm Summary
Alarm Type                     Critical        Major          Minor
Clock Alarms                      0              0              0
Switching Alarms                  0              0              0
Shelf Slot Alarms                 0              0              0
Environment Alarms                0              0              0
Alarms From Cards                 2              0              0
dspndstatus

Use the dspndstatus command to view the status of the node alarms.

Syntax Description

dspndstatus

Examples
spirita.1.PXM.a > dspndstatus
 Total Alarms =   2
Node Alarm Status - Type LINE ALARM        Severity CRITICAL
dspcdalms

Use the dspcdalms command to view the summary of node card alarms. This includes line alarms, port alarms, and channel alarms.

Syntax Description

dspcdalms

Examples
spirita.1.PXM.a > dspcdalms
Node Card Alarm Summary
Line Alarm       Slot   1  Critical    2   Major    0   Minor    0
Port Alarm       Slot   1  Critical    0   Major    0   Minor    0
Channel Alarm    Slot   1  Critical    0   Major    0   Minor    0
dspcdstatus

Use the dspcdstatus command to view the status of the card alarms.

Syntax Description

dspcdstatus

Examples
spirita.1.PXM.a > dspcdstatus
Defaulting to logical slot   1.
Logical Slot   1    Physical Slot   1
Card Alarm Status - Type LINE              Severity CRITICAL
dspcwmrole

Use the dspcwmrole command to view the IP address of the CWM in the primary, secondary, tertiary, or statistics master for this node.

Syntax Description

dspcwmrole <primary | secondary | tertiary | statsmaster>

Examples

Example C-25 To view the IP address for the primary CWM associated with this node:
dspcwmrole primary
dspenvalms

Use the dspenvalms command to view environment alarms. This includes line alarms, port alarms, and channel alarms.

Syntax Description

dspenvalmsalms

Examples
spirita.1.PXM.a > dspenvalms
spirita                          System Rev: 01.00   May. 21, 2000 08:26:56 PST
SES-CNTL                                             Node Alarm: CRITICAL
ENVIRONMENTAL ALARM STATE INFO   ^Notification Disabled
   Alarm Type      Unit   Threshold      DataType   Value       State
 ----------------  ---- --------------   -------- ---------- -------------
 Temperature             <= 50            Celsius   26       Normal
 Power Supply       A1   none             None      none     Normal
 Power Supply       A2   none             None      none     Missing
 Power Supply       A3   none             None      none     Missing
 DC Voltage         A    42  to 54        VoltsDC   49       Normal
 Power Supply       B1   none             None      none     Missing
 Power Supply       B2   none             None      none     Missing
 Power Supply       B3   none             None      none     Missing
 DC Voltage         B    42  to 54        VoltsDC   0        Normal
 Fan Tray           1    >= 2000          RPM       2790     Normal
 Fan Tray           2    >= 2000          RPM       2754     Normal
 Fan Tray           3    >= 2000          RPM       2700     Normal
 Fan Tray           4    >= 2000          RPM       2652     Normal
 Fan Tray           5    >= 2000          RPM       2676     Normal
Type <CR> to continue, Q<CR> to stop: dsp
dspslotalms

Use the dspslotalms command to view the slot alarms. This includes card alarms, card hardware alarms, disk alarms, and interface card alarms.

Syntax Description

dspslotalms

Examples
spirita.1.PXM.a > dspslotalms
Node Slot Alarm Summary
Card Alarm                 Critical    0   Major    0   Minor    0
Card Hardware              Critical    0   Major    0   Minor    0
Disk Alarm                 Critical    0   Major    0   Minor    0
Interface Card             Critical    0   Major    0   Minor    0
dsperr

Use the dsperr command to view the contents of either all error log files or a specific error log file.

Syntax Description.

dsperr [-en <error slot>

-en

Command delineator that precedes the error slot entry.

error slot

Number of the error log file.

-sl

Command delineator that preceeds the slot number entry

slot number

Command delineator that preceeds the slot number entry

] [-sl<slot number>]

Examples

Example C-26 To view all error log files:
spirit3.1.1.PXM.a > dsperr
----------
Stack Trace:
    0x801e5714 vxTaskEntry              +  c: sysTaskSetup()
    0x80024d2c sysTaskSetup             + 58: rmm_main()
    0x800dff7c rmm_main                 +624: rmm_process_message()
    0x800df764 rmm_process_message      + 98: rmm_delete_seat()
    0x800e0f54 rmm_delete_seat          + ac: ipc_remove_seat()
    0x800d1140 ipc_remove_seat          + 50: ipc_renumber_as_slave()
    0x800d0a10 ipc_renumber_as_slave    +208: my_free()
    0x800d3430 my_free                  +  8: ssiFree()
    0x8001c378 ssiFree                  + 8c: ssiEvent()
    0x800274dc ssiEvent                 +11c: ssiEvent()
    0x800277bc ssiEvent                 +3fc: sysStackTrace()
----------
No Dump Trace before the event
spirit3.1.1.PXM.a >                                
spirita.1.PXM.a > dsperr
Error Log for Slot 01: Error Num 42
    Firmware version: 001.000.000.000_swtools Product Id: 3
    Timestamp: 05/21/2000-04:41:33 Node name: spirita
Section Number 0:
Event Logged:
 01-00124 05/21/2000-04:41:33 DB2S-4-DBSYNC_NULLPARA
 E:00042 tDbgCmdTsk 0x800e9f58
 ssiFRIsDirReplicated: Invalid Parameter: NULL pointer or NULL string for Path Name
Section Number 1:
Stack Trace:
0x805ce684 vxTaskEntry              +00c: sysTaskSetup+0()
0x800720e4 sysTaskSetup             +09c: cliCmdTask+0()
0x80197924 cliCmdTask               +478: cliCmdExec+0()
0x80197098 cliCmdExec               +270: cliRemove+0()
0x8019841c cliRemove                +184: ssiFRIsDirReplicated+0()
0x800e9f58 ssiFRIsDirReplicated     +068: ssiEvent+0()
0x8005e0dc ssiEvent                 +24c: ssiEventMsgReport+0()
0x8005e618 ssiEventMsgReport        +284: ssiStackTrace+0()
--------------
Type <CR> to continue, Q<CR> to stop: q
dspif

Use the dspif command to view configuration and state information for the selected broadband interface.

Syntax Description

dspif <if_num>

if_num

Interface number, in the range 1-32.

Examples

To view configuration and state information for broadband interface number 1:
spirit3.1.1.PXM.a > dspif 1
 ifNum  Status  Line  ingrPctBw egrPctBw minVpi maxVpi
------------------------------------------------------
  1     Ena       1       10       10        0     19
 spirit3.1.1.PXM.a > 
dspipif

Use the dspipif command to view configuration and statistics information associated with one or all IP interfaces.

Syntax Description

dspipif [interface]

interface

Optional interface name, using one of the following terms:

•atm0

•lnfci0

•sl0

Examples

spirita.1.PXM.a > dspipif

dspipifcache

Use the dspipifcache command to view interface cache translation table for one or all interfaces.

Syntax Description

dspipifcache [interface]

interface

Optional interface type, stated as atm0.

Examples
spirita.1.PXM.a > dspipifcache
spirita                          System Rev: 01.00   May. 21, 2000 06:03:36 PST
SES-CNTL                                             Node Alarm: CRITICAL
IP CONNECTIVITY INTERFACE CACHE
Interface         IpAddress       VcId    Age(Flush@120000)    Flags
--------------------------------------------------------------------------
    No Entries
dsplmistats

Use the dsplmistats command to view the current local management interface (LMI) configurations.

Syntax Description

dspilmistats

Examples

spirit3.1.1.PXM.a > dspilmistats
dsplog

Use the dsplog command to view events and messages logged by the selected PXM. The most recent events appear at the top of the list. You can display the entire list of logged messages by typing the dsplog command without arguments, or you can specify the individual card for which you want to view log information.

Note This document describes the dsplog command on the SES. This command is also in BPX CLI.

dsplog -log <EventLog# > -mod <ModuleName> -sev <Severity#> -sl <Slot# > -task <TaskName>
-tge <MM/DD/YYYY-HH:MM:SS> -tle <MM/DD/YYYY -HH:MM:SS>

-log

Command delineator that precedes the EventLog# entry

EventLog#

Number of the event log item

-mod

Command delineator that precedes the Module Name entry

Module Name

Module name

-sev

Command delineator that precedes the Severity # entry

Severity #

Severity number

-sl

Command delineator that precedes the Slot# entry

Slot#

Slot number that contains the card associated with the event log

-task

Command delineator that precedes the TaskName entry

TaskName

Task name

-tge

Command delineator that precedes the MM/DD/YYYY-HH:MM:SS entry, to define time greater than, or equal.

MM/DD/YYYY-HH:MM:SS

Month, day, year, hour, minute, second

-tle

Command delineator that precedes the MM/DD/YYYY-HH:MM:SS entry, to define time less than, or equal.

MM/DD/YYYY-HH:MM:SS

Month, day, year, hour, minute, second.

Examples

Example C-27 To view all log files:
spirit3.1.1.PXM.a > dsplog
dsplog
04/01/70-13:10:03 tRootTask    2 Illegal msg received
04/01/70-13:10:07 aum        1312 local IP address not programmed
03/01/70-20:11:31 smm        1207 slave ack timeout  
spirit3.1.1.PXM.a > 
dsplogs

Use the dsplogs command to view PXM log files.

Syntax Description

dsplogs

Examples

Example C-28 To view all log files:
spirit11.1.1.PXM.a > dsplogs
spirit11.1.1.PXM.a > dsplogs
log_file:   C:/LOG/event04.log
    created when 11/08/1998-19:19:58
    error sequence # :     0
 
log_file:   C:/LOG/event03.log
    created when 11/04/1998-03:34:38
    error sequence # :     0
 
log_file:   C:/LOG/event02.log
    created when 11/04/1998-03:18:26
    error sequence # :     0
 
log_file:   C:/LOG/event01.log
    created when 11/04/1998-03:15:22
    error sequence # :     0
spirit11.1.1.PXM.a > 
dsppvcif

Use the dsppvcif command to view PVC address information for one or all IP interface that support PVC.

Syntax Description.

dsppvcif <interface>

interface

Interface type, specified as atm0.

Examples
spirita.1.PXM.a > dsppvcif
spirita                          System Rev: 01.00   May. 21, 2000 06:04:26 PST
SES-CNTL                                             Node Alarm: CRITICAL
IP CONNECTIVITY PVC CACHE
--------------------------------------------------------------------
atm (unit number 0):
    Feeder VPI.VCI: 3.8
        Flags:           (0x38) VCMUX,PVC,FEEDER
        State:           (0x1) UP
        RxLCN:           722           TxLCN:            32776
        LCNindex:        0             Feeder Name:
        Input Frames:    0             Output Frames:    0
Input Errors: 0 Output Errors: 0

dspsvcif

Use the dspsvcif command to view SVC address information for one or all IP interfaces that support SVC.

Syntax Description.

dspsvcif <interface>

interface

Interface type, specified as atm0.

Examples

spirita.1.PXM.a > dspsvcif

ipifconfig

.Use the ipifconfig command to set IP address information for a specified IP interface on the PXM.

Syntax Description

ipifconfig <interface> [<ip_address>] [up|down] [netmask <mask>] [broadcast <broad_addr>]
[arp | noarp] [svc|nosvc] [pvc | nopvc] [default|nodefault] [clrstats]

interface

Interface type, as associated with one of the following entries:

•atm0

•lnpci0

•sl0

ip_address

IP address of the interface.

This setting is mandatory if the interface has never been configured.

up | down

Optional: sets interface status as either active (up) or deactive (down).

netmask <mask>

Optional: network mask value for the interface.

broad_addr

Optional: broadcast address for the interface.

arp | noarp

Optional: Enable (arp) or disable (noarp) ARP on the interface.

Default = enabled if the interface supports ARP.

svc | nosvc

Optional: Enable (svc) or disable (nosvc) SVC on the interface.

Default = enabled if the interface supports SVC.

pvc | nopvc

Optional: enable (pvc) or disable (nopvc) PVC on the interface.

Default = disabled

default | nodefault

Optional: Set this interface as either the default route or disable default route on this interface.

clrstats

Optional: Remove all interface and SVC/PVC statistics for this interface.

Examples

ipifconfig atm0 10.1.2.95

pvcifconfig

Use the pvcifconfig command to set PVC address information for a selected IP interface.

Syntax Description

pvcifconfig <interface> router | feeder <PVC> [arp | noarp] [llcencap \ vcmux] [default | nodefault] [up] [reset] [delete]

interface

Interface type, specified as atm0.

router | feeder <PVC>

The interface (either router or feeder) to be used with the PVC address.

PVC = PVC address in the form VPI.VCI, as used by the router or feeder interface.

arp | noarp

Either enable (arp) or disable (noarp) ARP on this PVC.

Note This parameter is valid for router AESA configuration only.

llcsnap | vcmux

Encapsulation method to use on the PVC, either LLC Snap encapsulation (llcsnap) or VC-based multiplexing (vcmux).

Note This parameter is valid for router AESA configuration only.

default | nodefault

Either enable default routing (default), or disable default routing (nodefault) on this PVC interface.

up

Place this PVC in an UP state and attempt to bind associated lcns.

reset

Force reset on this PVC, and place PVC in setup state.

delete

Remove specified PVC settings.

clrstats

Remove all PVC statistics on this interface.

Examples

pvcifconfig atm0 feeder 3.8 up

setipconndebug

Use the setipconndebug command to set the debug level for IP connectivity task.

Syntax Description

setipconndebug [debuglevel]

debuglevel

A value to set level, as follows:

•0x0 = no logging

•0x1 = task errors

•0x2 = task debug

•0x4 = ATM protocol

•0x8 = task startup

•0x10 = task events

•0x20 = SIGAPI

•0x40 = ATMARP protocol

•0x80 = Task timers

•0x100 = interface cache

•0x200 = subtask events

•0x400 = diskDB events

•0x800 = RAMDB events

•0xffffffff = All logging

svcifconfig

Use the svcifconfig command to set SVC address information on an IP interface.

Syntax Description

svcifconfig <interface> router | local <AESA> [arp | noarp] [llcencap | vcmux] [default | nodefault] [reset] [delete] [clrstats]

interface

Interface type, specified as atm0.

router | local <AESA>

AESA address associated with either a router or local PXM.

arp | noarp

Enable (arp) or disable (noarp) ARP on this SVC.

Note This parameter is valid for router AESA configuration only.

llcsnap | vcmux

Encapsulation method to be used on this SVC, either LLC Snap encapsulation (llcsnap) or VC-based multiplexing (vcmux).

Note This parameter is valid for router AESA configuration only.

default | nodefault

Either enable default routing (default), or disable default routing (nodefault) on this SVC interface.

reset

Force reset on this SVC: the SVC call is released, then attempted again.

delete

Remove the specified AESA configuration.

clrstats

Remove all SVC statistics on this interface.

Examples

svcifconfig atm0 router 47.0091.8100.0000.0010.7665.f258.0010.7665.ffff.f1

switchapsln

Use the switchapsln command to control APS switching actions. This function applies to OC-3 lines.

Syntax Description

switchapsln <line number> <operation>

line number

OC-3 line number on which to apply APS. Enter the value 1.

operation

Alpha character to set type of APS switch functionality to use on the PXM line.

•c= clear

•f= forced

•m= manual

•l= lock-out

or switchapsln s <slot>

Syntax Description

switchapsln 1 f

switchapsln s 2

Redundancy Commands

This section lists the commands with which to perform tasks for controlling system redundancy.

switchcc

Use the switchcc command to reverse the roles of the active and the standby PXM. After you use this command, the PXM previously designated as the active PXM becomes the standby, and the PXM previously designated as the standby becomes the active PXM.

Syntax Description

switchcc

Examples
spirit11.1.1.PXM.a > switchcc 
dspred

Use the dspred command to view redundancy information.

Syntax Description

dspred

Examples

Example C-29
spirit11.1.1.PXM.a > dspred
spirita                          System Rev: 02.00   May. 22, 2000 11:25:02 GMT
SES-CNTL                                             Node Alarm: NONE
Primary  Primary  Primary  Secondary  Secondary  Secondary  Redundancy  
SlotNum   Type     State    SlotNum     Type       State       Type  
-------  -------  -------  ---------  ---------  ---------  ----------  
  1      PXM1      Active      2        PXM1       Standby   1-1           

Command	Usage	Access Level	State	Log	SNMP Support
User Commands
adduser	Set up a new user name	1	active	yes
bye	Exit the CLI shell	any	any	yes
clrscrn	Clear the terminal screen	any	any	no
cmdhistory	View recent commands executed on the current card	any	any	no
cnfpasswd	Set password for a specified user name	any	active	yes
cnfuser	Configure user information.	1	active	yes
copy	Copy files.	any	any	no
delete	Delete files	1	any	yes
deluser	Remove a user name from the configured user list associated with the shelf	1	active	yes
dspusers	View user IDs that have been configured on the PXM	any	any	no
exit	Exit the CLI shell	any	any	yes
Help	View commands associated with the selected card	any	any	no
logout	Exit the CLI shell	any	any	yes
timeout	Set maximum idle time, in seconds, for a PXM session	super user	any	no
who	View details associated with user IDs currently active on the PXM	any	any	no
whoami	View the current login ID, access level and associated terminal port	any	any	no
Shelf Commands
addshelf	Adds the SES PNNI Controller to the BPX and to enables AnnexG protocol to run between the BPX and the SES PNNI Controller. Run this command on the BPX only	any	any	yes
cc	Navigates between different cards within the shelf.	any	any	no
dspcd	View specified card information Run this command on the BPX and the SES.	any	any	no
dspcds	View card information for all installed cards Run this command on the BPX and the SES.	any	active	no
dspversion	View version information about the selected card.	any	any	no
memShow	View the memory map	any	any	no
resetcd	Reset a card. Run this command on the BPX and the SES.	super user	active	yes
resetsys	Reset the entire shelf Run this command on the BPX and the SES.	super user	active	yes
routeShow	View the IP routing of the network layer of the operating system.	any	any	no
routestatShow	View the IP routing statistics for the network layer of the operating system	any	any	no
setrev	Sets the primary and secondary revisions of the specified slolt.	super user	any	yes
Node Level Commands
addapsln	Enables APS on a specified line for the PXM	super user	active	yes
addctrlr	Enables VSI capabilities on the trunk interface. Run this command on the BPX only.	super user	active	yes
addlmiloop	Enables LMI loopback line on the current card.	super user	active	no
clrallcnf	Clear all configurations and restart system, using a default configuration. Run this command on the BPX and SES.	super user	active	yes
clrbecnt	Remove all statistics for APS bit-error counts.	service group	active	no
clrerr	Remove specified or all error log files.	super user	any	no
clrlmistats	Clear the LMI (Local Management Interface) statistics on the current PXM.	any	any	no
clrlog	Clear specified or all event log files. Run this command on the BPX and SES.	super user	any	yes
cnfapsln	Set APS parameters for a line on the PXM.	super user	active	yes
cnfclksrc	Configure clock sources.	super user	active	yes
cnfdate	Set system date. Run this command on the BPX and SES.	Super user	active	yes	yes
cnfname	Set node name. Run this command on the BPX and SES.	super user	active	yes
cnfrsrc	Configure resource partitions. Run this command on the BPX only.	1	active	yes
cnfstatsmgr	Set the IP address of statistics manager.	service group	active	no
cnftime	Set system time.	super user	active	yes
cnftmzn	Set the system time. Run this command on the BPX and SES.	super user	active	yes
cnftmzngmt	Set the system time zone. Run this command on the BPX and SES.	super user	active	yes
delapsln	Remove APS configuration for a specified PXM line.	super user	active	yes
delclksrc	Remove clock source configuration.	super user	active	yes
dspapscfg	Display APS configuration for PXM lines.	any	any	no
dspapsln	Display the status of APS for PXM lines.	any	active	no
dspbecnt	Display APS bit-error count statistics	super user	active	no
dspclkinfo	View all configured clock sources in the node.	3	active	yes
dspcdalms	Display card alarms.	any	any	no
dspcdstatus	Display card status.	any	any	no
dspcwmrole	View primary, secondary, tertiary, or statistics manager CWM for this node.	any	active	no
dspdate	View current system time.	any	and	no	yes
dspenvalms	Display environment alarms.	any	any	no
dsperr	View the contents of either all error log files or a specific error log file	any	any	no
dspif	View configuration and state information for a broadband interface	any	any	no
dspipif	View IP configuration and statistics for one or all IP interfaces	any	any	no	no
dspipifcache	View interface cache translation table for one or all IP interfaces	any	any	no	no
dsplmistats	View the current local management interface (LMI) configurations	any	any	no
dsplog	View events and messages logged by the current PXM. In this case, this command should be run on the SES. However, it is also a command in the BPX CLI.	any	any	no
dsplogs	View information from all event log files	any	any	no
dspndalms	Display node alarms.	any	any	no
dspndparms	Display node parameters.	any	any	no
dspndstatus	Display node status.	any	any	no
dsppvcif	View PVC address information for one or all IP interfaces that support PVCs.	any	any	no	no
dspslotalms	Display slot alarms.	any	any	no
dspsvcif	View SVC address information for all IP interfaces that support SVCs	any	any	no	no
ipifconfig	Set interface IP address	super user	active	yes	no
pvcifconfig	Set PVC address information for an IP interface	super user	active	yes	no
setipconndebug	Set debug level for IP connectivity task	super user	any	no	no
svcifconfig	Set SVC address for an IP interface	super user	active	yes	no
switchapsln	Control APS line switch functions.	super user	active	yes
Redundancy Commands
dspred	Displays redundant information.	any	any	no
switch cc	Switch core card. Run this command on the BPX and SES.	service group	active	yes

user ID	Case-sensitive name to be used as the login at the PXM. The name can consist of up to 12 characters composed of alpha and numeric characters, special characters "_" and "-". The name must begin with an alpha character and cannot contain spaces.
accessLevel	System privilege level to be allocated for the user ID, using one of the following options: •SERVICE_GP •SUPER_GP •GROUP1 (highest level) •GROUP2 •GROUP3 •GROUP4 •GROUP5 •ANYUSER (lowest level) The new user that you configure cannot be configured for an accessLevel that is higher than that defined for the current login ID.

user_id	User name

user id	User name
password	User password
accessLevel	System privilege level to be allocated for the user ID, using one of the following options: •SERVICE_GP •SUPER_GP •GROUP1 (highest level) •GROUP2 •GROUP3 •GROUP4 •GROUP5 •ANYUSER (lowest level) The new user that you configure cannot be configured for an accessLevel that is higher than that defined for the current login ID.

source file	Source file to be copied.
destination file	Destination file.

file name	Name of the file to be removed.

user ID	User name, consisting of up to 12 characters

time_out	Number of idle time seconds allowed prior to automatically logging off the current user.

slot.port	Slot and Port numbers corresponding to the feeder.
feeder type	Type of feeder when you execute addshelf.

slot number	The number of the slot that contains the card you want to work on, either 1 or 2.

slot number	Slot number of the installed PXM, either 1 or 2.

slot	Slot number of the installed PXM, either 1 or 2.

slot	Slot number of the card for which the version will be set.
primary version	The primary version number to which the card will be set.
primary version	The secondary version number to which the card will be set

workingline	Working line number. Enter the value 1.
workslot	Enter value 1 or 2. •1 = slot 1 •2 = slot 2
protectline	Protection line number. Enter the value 1.
protectslot	Protection slot number. Enter the value 1 or 2.
archmode	Value to set APS architecture mode to be used on the working/protection line pair, as defined for 1+1 two backcards. Enter the value 2.

slot.port	Slot and Port numbers corresponding to the feeder trunk
Cntl_Id	Controller ID corresponding to the PNNI controller. 2 for PNN Controller.
Part_Id	Partition ID of the VSI partition controlled by the PNNI controller. 1 for partition #1.
Control_VC_VPI	Starting VPI of the control VCs. Valid values for this parameter are: 0-4095. The default value is 0.
Control_VC_VCI	Starting VCI of the control VCs. The value is 40 to reserve VCI Range 40 to 54 for control VCs.

slot	Slot number, in the range 1 - 2
port	Port number

Line Number	Enter the value 1.

-en	Command delineator that precedes the error number entry.
error number	Number of the log file to clear.
-sl	Command delivered that proceeds the slot number entry.
slot number	Number of the slot in which the selected card resides.

-log	Command delineator that precedes the log slot entry.
log slot	Number of the file that you want to clear from the event log file.

line	OC-3 line number. Enter the value 1.
SFBER	Signal failure BER threshold, in the range 3-5. 5 = signal failure BER threshold = 10 ^^ -5.
SDBER	Signal degrade BER threshold, in the range 5-9. 5 = signal degrade BER threshold = 10 ^^ -5.
WTR	Number of minutes to wait before attempting to switch back to the working line, in the range 1-12. This setting is not applicable if the line is configured in non-revertive mode (Revertive set to 1).
Direction	Value to set the switching direction for either unidirectional or bidirectional. •1 = Unidirectional: This APS line supports switching only one end of the line. 2 = Bidirectional: This APS line supports switching both ends of the line.
Revertive	Value to set the APS revertive or non-revertive function. •1 = Non-revertive •2 = Revertive This setting allows the line to switch back to the working line after the Wait-To-restore interval has expired and the working line SF/SD has been cleared.
K1K2	To to enable or disable the K1/K2 inband protocol on the protection line. •1 = enable •2 = disable

priority	Determines whether this Clock source is the primary or secondary clock.
portid	Clocksource information in the form of [shelf.]slot[:subslot].port[:subport]
revertive	Enables or disables revertive behavior.
bits	Type of bits. Can be e1 or t1.

mm/dd/yyyy

name	Name of this SES PNNI node, consisting of up to 8 alpha-numeric characters.

<slot.port>	Slot and port numbers corresponding to the feeder.

hh:mm:ss

timezone	•GMT •EST •CST •MST •PST

gmtoffset	-12, -11, -10 10, 11, 12

workingline	Working line number. Enter the value 1.

line	Line number. Enter the value 1.

-en	Command delineator that precedes the error slot entry.
error slot	Number of the error log file.
-sl	Command delineator that preceeds the slot number entry
slot number	Command delineator that preceeds the slot number entry

if_num	Interface number, in the range 1-32.

interface	Optional interface name, using one of the following terms: •atm0 •lnfci0 •sl0

interface	Optional interface type, stated as atm0.

-log	Command delineator that precedes the EventLog# entry
EventLog#	Number of the event log item
-mod	Command delineator that precedes the Module Name entry
Module Name	Module name
-sev	Command delineator that precedes the Severity # entry
Severity #	Severity number
-sl	Command delineator that precedes the Slot# entry
Slot#	Slot number that contains the card associated with the event log
-task	Command delineator that precedes the TaskName entry
TaskName	Task name
-tge	Command delineator that precedes the MM/DD/YYYY-HH:MM:SS entry, to define time greater than, or equal.
MM/DD/YYYY-HH:MM:SS	Month, day, year, hour, minute, second
-tle	Command delineator that precedes the MM/DD/YYYY-HH:MM:SS entry, to define time less than, or equal.
MM/DD/YYYY-HH:MM:SS	Month, day, year, hour, minute, second.

interface	Interface type, specified as atm0.

interface	Interface type, specified as atm0.

interface	Interface type, as associated with one of the following entries: •atm0 •lnpci0 •sl0
ip_address	IP address of the interface. This setting is mandatory if the interface has never been configured.
up \| down	Optional: sets interface status as either active (up) or deactive (down).
netmask <mask>	Optional: network mask value for the interface.
broad_addr	Optional: broadcast address for the interface.
arp \| noarp	Optional: Enable (arp) or disable (noarp) ARP on the interface. Default = enabled if the interface supports ARP.
svc \| nosvc	Optional: Enable (svc) or disable (nosvc) SVC on the interface. Default = enabled if the interface supports SVC.
pvc \| nopvc	Optional: enable (pvc) or disable (nopvc) PVC on the interface. Default = disabled
default \| nodefault	Optional: Set this interface as either the default route or disable default route on this interface.
clrstats	Optional: Remove all interface and SVC/PVC statistics for this interface.

interface	Interface type, specified as atm0.
router \| feeder <PVC>	The interface (either router or feeder) to be used with the PVC address. PVC = PVC address in the form VPI.VCI, as used by the router or feeder interface.
arp \| noarp	Either enable (arp) or disable (noarp) ARP on this PVC. Note This parameter is valid for router AESA configuration only.
llcsnap \| vcmux	Encapsulation method to use on the PVC, either LLC Snap encapsulation (llcsnap) or VC-based multiplexing (vcmux). Note This parameter is valid for router AESA configuration only.
default \| nodefault	Either enable default routing (default), or disable default routing (nodefault) on this PVC interface.
up	Place this PVC in an UP state and attempt to bind associated lcns.
reset	Force reset on this PVC, and place PVC in setup state.
delete	Remove specified PVC settings.
clrstats	Remove all PVC statistics on this interface.

debuglevel	A value to set level, as follows: •0x0 = no logging •0x1 = task errors •0x2 = task debug •0x4 = ATM protocol •0x8 = task startup •0x10 = task events •0x20 = SIGAPI •0x40 = ATMARP protocol •0x80 = Task timers •0x100 = interface cache •0x200 = subtask events •0x400 = diskDB events •0x800 = RAMDB events •0xffffffff = All logging

interface	Interface type, specified as atm0.
router \| local <AESA>	AESA address associated with either a router or local PXM.
arp \| noarp	Enable (arp) or disable (noarp) ARP on this SVC. Note This parameter is valid for router AESA configuration only.
llcsnap \| vcmux	Encapsulation method to be used on this SVC, either LLC Snap encapsulation (llcsnap) or VC-based multiplexing (vcmux). Note This parameter is valid for router AESA configuration only.
default \| nodefault	Either enable default routing (default), or disable default routing (nodefault) on this SVC interface.
reset	Force reset on this SVC: the SVC call is released, then attempted again.
delete	Remove the specified AESA configuration.
clrstats	Remove all SVC statistics on this interface.

line number	OC-3 line number on which to apply APS. Enter the value 1.
operation	Alpha character to set type of APS switch functionality to use on the PXM line. •c= clear •f= forced •m= manual •l= lock-out

Was this Document Helpful?

Feedback

Contact Cisco

Open a Support Case
(Requires a Cisco Service Contract)