Shelf Operations Commands

Table Of Contents

Shelf Operations Commands

Command Summaries

addapsln

addlmiloop

addtrapmgr

adduser

bootChange

bye

cc

clrallcnf

clrbecnt

clrerr

clrerrhist

clrlmistats

clrlog

clrscrn

cmdhistory

cnfapsln

cnfdate

cnfname

cnfpasswd

cnfsnmp

cnfstatsmgr

cnftime

cnftmzn

cnftmzngmt

cnftrapip

cnfuser

copy

delapsln

delete

dellmiloop

deltrapmgr

deluser

dspapscfg

dspapsln

dspbecnt

dspcd

dspcdalms

dspcderrs

dspcds

dspcdstatus

dspcwmrole

dspdisk

dspenvalms

dsperr

dsperrhist

dspif

dspipif

dspipifcache

dsplmilink

dsplmiloop

dsplmistats

dsplog

dsplogs

dspndalms

dspndstatus

dspred

dspslotalms

dspsnmp

dspswalms

dsptrapmgr

dspusers

dspversion

exit

Help

ipifconfig

ifShow

logout

memShow

resetcd

resetsys

restoreallcnf

routeShow

routestatShow

saveallcnf

sesntimeout

setrev

switchapsln

switchcc

timeout

who

whoami

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
addtrapmgr	Set up a new user name	1	active	yes
bootChange	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
cnfuser	Configure user information.	1	active	yes
copy	Copy files.	any	any	no
delete	Delete files	1	any	yes
dellmiloop	Remove a user name from the configured user list associated with the shelf	1	active	yes
dspsnmp	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
timeout	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
addtrapmgr	Sets up an SNMP manager to receive traps.	super user	any	no
bootChange	Specifies the boot IP address and gateway address of a PXM card.	service	any	yes
cc	Navigates between different cards within the shelf.	any	any	no
cnfpasswd	Configures a user password.	Superuser	active	yes
cnfsnmp	Configures SNMP strings.	Superuser	active	yes
deltrapmgr	Deletes a trap manager.	Superuser	active	yes
dspcd	View specified card information Run this command on the BPX and the SES.	any	any	no
dspdisk	Displays disk utilization.	any	any	no
dspcderrs	View card information for all installed cards	any	active	no
dspsnmp	Displays the SNMP strings.	any	any	no
dsptrapmgr	Displays details about all trap managers.	any	any	no
dspversion	View version information about the selected card.	any	any	no
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 slot.	super user	any	yes
sesntimeout	Specifies the number of seconds of idle time for the current user-session.	Service	active	yes
timeout	Display or change the maximum time a user can be idle before the system terminates that user's session.	Service	active	yes
Node Level Commands
addapsln	Enables APS on a specified line for the PXM	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
	Clears log of errors and failures	super user	any	no
clrerrhist	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
cnfdate	Set system date.	Super user	active	yes	yes
cnfname	Set node name.	super user	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 timezone.	super user	active	yes
cnftmzngmt	Set the system time zone. Run this command on the BPX and SES.	super user	active	yes
	Configure the trap ip	super user	active	yes
delapsln	Remove APS configuration for a specified PXM line.	super user	active	yes
dellmiloop	Removes LMI loopback state for a line.	super user	active	no
dspapscfg	Display APS configuration for PXM lines.	any	any	no
dspbecnt	Display APS bit-error count statistics	super user	active	no
dspcderrs	Displays information about card errors.	any	any	no
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
	Display a log of errors and failures.	any	any	no
dsperrhist	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
dsplmilink	Displays LMI links on a line.	any	active	no
dsplmiloop	Displays LMI loopback state for a line.	any	active	no
dsplmilink	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
dspslotalms	Display slot alarms.	any	any	no
dspswalms	Displays switching alarms.	any	any	no
ipifconfig	Set IP address information for a specified IP interface on the PXM	any	any	yes
restoreallcnf	Restores all configuration files saved in the CNF directory on the harddrive.	service	active	yes
saveallcnf	Saves all the configuration files to the CNF directory on the harddrive.	Service	active	yes
switchapsln	Control APS line switch functions.	super user	active	yes
Redundancy Commands
dspred	Displays redundant information.	any	any	no
switchcc	Switch core card. Run this command on the BPX and SES.	service group	active	yes

addapsln

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

Syntax Description

addapsln <work-line><work-slot><prot-line><prot-slot><mode>

work-line	Working line number. Enter the value 1.
work-slot	Enter value 1 or 2. •1 = slot 1 •2 = slot 2
prot-line	Protection line number. Enter the value 1.
prot-slot	Protection slot number. Enter the value 1 or 2.
mode	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-1 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

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-2 To add lmi loopback line to the current PXM.

addlmiloop 1.1

addtrapmgr

Use the addtrapmgr command to set up an SNMP manager to receive traps. Trap managers you add through addtrapmgr and trap managers that are added by the SNMP manager (Cisco WAN Manager or other application) do not age and are not deleted. To delete a trap manager, use either the deltrapmgr command or an SNMP Set on the intended object.

Syntax Description

addtrapmgr <ip_addr> <portnum>

ip_addr	IP address in dotted decimal format: nnn.nnn.nnn.nnn, n=0-9 and nnn < 256
portnum	Port number on the workstation that receives traps. The range is 0-65535. If you add a trap manager through SNMP, the default portnum is 162

Examples

Add a trap manager with IP address 161.10.144.56 to port 50.

spirit11.1.1.PXM.a > addtrapmgr 161.10.144.56 50

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-3 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 >

bootChange

Use the bootChange command to specify the boot IP address and gateway address of a PXM card. The IP address you define with bootChange is used only when the PXM is in the boot state.

In the current release, the only parameters you should enter are "inet on ethernet (e)" and "gateway inet (g)." The bootChange command presents one parameter at a time. Therefore, press the Return (or Enter) key at each prompt execept for these two. The example in this description shows the two fields where you need to enter an IP address and the fields you skip.

Note Run this command in boot-mode only.

Syntax Description

bootChange

Examples

Specify an IP address of 170.11.52.61 for the Ethernet port and 170.11.52.2 for the gateway IP address. The display shows all the fields that the node presents. For all fields except the ethernet and gateway prompts, press Return or Enter.

spirit11.1.1.PXM.a > bootChange

'.' = clear field;  '-' = go to previous field;  ^D = quit

boot device          : lnPci

processor number     : 0

host name            : winter

file name            : /users/joloughl/pxm45_002.000.014-A1.fw

inet on ethernet (e) : 170.11.52.61

inet on backplane (b):

host inet (h)        : 170.11.25.42

gateway inet (g)     : 170.11.52.2

user (u)             : rli

ftp password (pw) (blank = use rsh):

flags (f)            : 0x0

target name (tn)     : pxm45-71

startup script (s)   :

other (o)            :

bye

Use the bye command to exit the current CLI shell.

Syntax Description

bye

Examples

Example C-4 To exit the current CLI shell:

spirit.1.2.PXM.a > bye

(session ended)

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

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>

line	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-5 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 > 

clrerrhist

Use the clrerrhist command to display a log of errors and failures.

Syntax Description

clrerrhist <slot>

slot number

Optional. The number of the slot that contains the card you want to work on. Use this object to clear the log of errors and failures only on a specific slot.

Examples

spirit11.1.1.PXM.a > clrerrhist

10      0x301f   syncRam DB Reset Init from STBY failed  09/07/2000-20:44:25

-----------------------------------------------------------------------------

spirit11.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-6 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-7 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 > 

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-8 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-9 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 > 

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 > 

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 >

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-10 To modify your own password:

spirit4.1.2.PXM.a > cnfpasswd

Enter existing password:

Enter new password:

Re-enter new password:

spirit4.1.2.PXM.a >

cnfsnmp

Use the cnfsnmp command to configure SNMP Strings. You can configure only one of these strings with a single execution of cnfsnmp.

Syntax Description

cnfsnmp <-community [string <ro | rw>]> <-contact [string]> <-location [string]>

-

-community	Keyword that establishes the community access string to permit access to SNMPv1 protocol. The string acts like a password and permits access to the SNMP Protocol. Further, the access of either read-only or read-write allows operations on MIB Objects according to the setting. The setting can be either "ro" for read-only or "rw" for read-write. The default is read-only With read-only, authorized management stations are only able to retrieve MIB objects. With read-write access, authorized management stations are able to retrieve and modify MIB objects.
-contact	Keyword that specifies the system contact string for sysContact MIB object in MIB-II. The string in this case is text that describes the contact. For example, the contact could be an administrator's email address. The default is no text.
-location	Keyword that specifies the location of the system. The default is no text. The system location string is used for sysLocation MIB object in MIB-II.

Examples

Configure various community strings.

spirit11.1.1.PXM.a > cnfsnmp community ro

spirit11.1.1.PXM.a >cnfsnmp community comaccess 

spirit11.1.1.PXM.a >community string "comaccess" , read-only access

spirit11.1.1.PXM.a >cnfsnmp community comaccess ro

spirit11.1.1.PXM.a >community string "comaccess" read-only access

spirit11.1.1.PXM.a >cnfsnmp community superaccess rw 

spirit11.1.1.PXM.a >community string "superaccess" , read-write access

Give an email address for t he system contact

spirit11.1.1.PXM.a > cnfsnmp contact Dial System, Email : 

Specify the location of the system as Building 3, Room 214.

node19.8.PXM.a >cnfsnmp location Building 3/Room 214

cnfstatsmgr

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

Syntax Description

cnfstatsmgr <IP Address>

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

Hour, month, and seconds.

Examples

Example C-11 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-12 To set system time zone to minus eight hours of GMT:

wilco.1.1.PXM.a > cnftmzngmt -8

cnftrapip

Use the cnftrapip command to configure the trap ip.

Syntax Description

cnftrapip <ip address>

ip address

ip address where traps will be configured.

pirit11.1.1.PXM.a > cnftrapip

usage:cnftrapip <ipaddress>

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][-a 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

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 

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>

dellmiloop

Use the dellmiloop command to remove LMI loopback state for a line.

---

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

---

Syntax Description

dellmiloop <slot.port>

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

To delete lmi loopback line from the current PXM.

spirit11.1.1.PXM.a > dellmiloop 1.1

deltrapmgr

Use the deltrapmgr command to delete a trap manager. . The deltrapmgr command requires an IP address for deletion. To see existing trap managers, use dsptrapmgr.

Syntax Description

deltrapmgr <ip_addr>

ip_addr

IP address in dotted decimal format: nnn.nnn.nnn.nnn, n=0-9 and nnn =< 256

Examples

Delete trap manager with IP address 161.10.144.56.

spirit11.1.1.PXM.a > deltrapmgr 161.10.144.56

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

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

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

dspbecnt

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

Syntax Description

dspbecnt <line>

line	Working line number. Enter the value 1.

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

spirita.2

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:

spirita.2

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 

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

dspcderrs

Use the dspcderrs command to display information about card errors.

Syntax Description

dspcderrs

Examples

spirit11.1.1.PXM.a > dspcderrs

dspcderrs

08/05/95-18:53:05 tRootTask    3 Task failed          : scm                     

09/05/95-09:14:08 tRootTask    3 Task failed          : scm  

value = 0 = 0x0spirit11.1.1.PXM.a >

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 >

dspcdstatus

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

Syntax Description

dspcdstatus <slotnumber>

slot number

Command delineator that preceeds the slot number entry

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-13 To view the IP address for the primary CWM associated with this node:

dspcwmrole primary

dspdisk

Use the dspdisk command to display disk utilization. A likely application of dspdisk is a routine check of disk utilization by running a script that includes this command.

---

Note The capacity of the disk is very large relative to typical usage and therefore does not present potential restrictions. The output shows the allocated space rather than the physical capacity of the drive.

---

Syntax Description

dspdisk <disk partition>

disk partition

Optional. Displays the space utilization by each directory under that partition or directory in addition to the disk summary information. The disk partition can be one of the following: •name of the disk partition (for example, C:) •directory name (for example, C:/LOG) Note If you do not state the disk partition, only the summary of total and free space on each disk partition is displayed.

---

Note dspdisk will not handle multiple partitions/directories on the command-line.

---

Examples

Example 1

spirit11.1.1.PXM.a > dspdisk

==========================================================

 Partition C: Allocated Size:  800 MB Free Space:  574 MB

 Partition D: Allocated Size:  600 MB Free Space:  564 MB

 Partition E: Allocated Size:  100 MB Free Space:   99 MB

 Partition F: Allocated Size:  800 MB Free Space:  799 MB

==========================================================

Example 2

spirit11.1.1.PXM.a> dspdisk c:

==========================================================

 Partition C: Allocated Size:  800 MB Free Space:  634 MB

 Partition D: Allocated Size:  200 MB Free Space:  175 MB

 Partition E: Allocated Size:  100 MB Free Space:   99 MB

 Partition F: Allocated Size: 1000 MB Free Space:  999 MB

==========================================================

 Disk usage for c:

==========================================================

Error: could not stat() c:

spirit11.1.1.PXM.a> 

dspenvalms

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

Syntax Description

dspenvalmsalms [temp|psu|fan|vnom]

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

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-14 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

dsperrhist

Use the dsperrhist command to display a log of errors and failures.

Syntax Description

dsperrhist

slot number

Optional. The number of the slot that contains the card you want to work on. Use this object to disaply the log of errors and failures only on a specific slot.

Examples

Example 1

spirit11.1.1.PXM.a > dsperrhist

Log of Errors and Failures:

Entry#--Event#---EventName-------------------------------TimeStamp-----------

01      0x1000   RAM sync error                          08/11/2000-16:50:34

02      0x1000   RAM sync error                          08/11/2000-16:51:54

03      0x301f   syncRam DB Reset Init from STBY failed  08/11/2000-16:53:12

04      0x0007   SHM_CDF_MAX_RESETS_REACHED              08/11/2000-16:54:28

05      0x301f   syncRam DB Reset Init from STBY failed  08/11/2000-16:58:16

06      0x1000   RAM sync error                          08/11/2000-16:59:36

07      0x301f   syncRam DB Reset Init from STBY failed  08/11/2000-17:00:56

08      0x301f   syncRam DB Reset Init from STBY failed  08/11/2000-17:01:35

09      0x1000   RAM sync error                          09/07/2000-20:43:05

Type <CR> to continue, Q<CR> to stop: 

Example 2

spirit11.1.1.PXM.aspirit11.1.1.PXM.a> dsperrhist 2

Log of Errors and Failures:

Entry#--Event#---EventName-------------------------------TimeStamp-----------

01      0x1000   RAM sync error                          07/07/2000-09:29:31

02      0x1000   RAM sync error                          07/07/2000-09:30:51

03      0x301f   syncRam DB Reset Init from STBY failed  07/07/2000-09:32:11

04      0x0007   SHM_CDF_MAX_RESETS_REACHED              07/07/2000-09:33:19

05      0x1000   RAM sync error                          07/07/2000-22:25:06

06      0x1000   RAM sync error                          07/07/2000-22:26:26

07      0x301f   syncRam DB Reset Init from STBY failed  07/07/2000-22:27:46

08      0x0007   SHM_CDF_MAX_RESETS_REACHED              07/07/2000-22:28:54

09      0x1000   RAM sync error                          07/08/2000-04:29:58

Type <CR> to continue, Q<CR> to stop: 

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

dsplmilink

Use the dsplmilink command to display LMI links on a line.

Syntax Description

dsplmilink

Examples

spirit11.1.1.PXM.a > dsplmilink

dsplmiloop

Use the dsplmiloop command to display LMI loopback state for a line.

Syntax Description

dsplmiloop

Examples

spirit11.1.1.PXM.a > dsplmiloop

TRK     LMI LOOP STATUS

-----------------------

2.1      Disabled

dsplmistats

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

Syntax Description

dspilmistats

Examples

spirit3.1.1.PXM.a > dspilmistats

Polling Enabled:          1

Port Status    :          1

VPI.VCI        :        3.31

T393           :         10

N394           :          5

T394           :         10

N395           :          5

WaitStatus     :          0

WaitStAck      :          0

Retry Timer    :          0

Retry Count    :          1

Poll Timer     :          1

Trans Num      :        210

Status     Rx  :      55762

Status     Tx  :      53550

UpdtStatus Rx  :          0

UpdtStatus Tx  :          0

Status Enq Rx  :      53550

Status Enq Tx  :      55762

Status Ack Rx  :          0

Status Ack Tx  :          0

NodeStatus Rx  :      43918

Type <CR> to continue, Q <CR> to stop:

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-15 To view all log files:

spirit3.1.1.PXM.a > dsplog

02-12037 09/22/2000-17:31:09 FTPD-7-FTPDLIB3

         FtpdServ1  0x8027e204

 EVNT:ftp user logged OFF:username=   superuser

02-12036 09/22/2000-17:31:09 FTPD-7-FTPDLIB3

         FtpdServ1  0x8027d3b8

 EVNT:ftp user logged ON:username=   superuser

02-12035 09/22/2000-17:31:09 FTPD-7-FTPDLIB3

         FtpdServ1  0x8027e204

 EVNT:ftp user logged OFF:username=   superuser

02-12034 09/22/2000-17:31:09 FTPD-7-FTPDLIB3

         FtpdServ1  0x8027d3b8

 EVNT:ftp user logged ON:username=   superuser

02-12033 09/22/2000-17:31:09 FTPD-7-FTPDLIB3

         FtpdServ1  0x8027e204

 EVNT:ftp user logged OFF:username=   superuser

02-12032 09/22/2000-17:31:09 FTPD-7-FTPDLIB3

         FtpdServ1  0x8027d3b8

 EVNT:ftp user logged ON:username=   superuser

02-12031 09/22/2000-17:31:09 FTPD-7-FTPDLIB3

         FtpdServ1  0x8027e204

 EVNT:ftp user logged OFF:username=   superuser

02-12030 09/22/2000-17:31:09 FTPD-7-FTPDLIB3

dsplogs

Use the dsplogs command to view PXM log files.

Syntax Description

dsplogs

Example C-16 To view all log files:

spirit11.1.1.PXM.a > dsplogs

Current Event log number: 20

Event log 20:  C:/LOG/event20.log

   starting timestamp: 09/22/2000-12:31:04

Event log 19:  C:/LOG/event19.log

   starting timestamp: 09/22/2000-00:21:01

Event log 18:  C:/LOG/event18.log

   starting timestamp: 09/20/2000-22:42:11

Event log 17:  C:/LOG/event17.log

   starting timestamp: 09/19/2000-16:05:52

Event log 16:  C:/LOG/event16.log

   starting timestamp: 09/19/2000-01:35:08

Event log 15:  C:/LOG/event15.log

   starting timestamp: 09/18/2000-16:32:47

Event log 14:  C:/LOG/event14.log

   starting timestamp: 09/18/2000-07:20:02

Event log 13:  C:/LOG/event13.log

   starting timestamp: 09/17/2000-17:50:13

Event log 12:  C:/LOG/event12.log

   starting timestamp: 09/16/2000-22:24:37

Event log 11:  C:/LOG/event11.log

   starting timestamp: 09/16/2000-01:35:50

Event log 10:  C:/LOG/event10.log

   starting timestamp: 09/15/2000-22:05:42

Type <CR> to continue, Q<CR> to stop: 

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

dspred

Use the dspred command to view redundancy information.

Syntax Description

dspred

Examples

Example C-17

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           

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

dspsnmp

Use the dspsnmp command to display disk utilization.

Syntax Description

dspsnmp

Examples

spirit11.1.1.PXM.a > dspsnmp

Unknown                          System Rev:01.00   Sep. 27, 2000 06:25:35 PST

SES-CNTL                                             Node Alarm:MAJOR

Community:                                              ro

System Location:                                                

System Contact 

dspswalms

Use the dspswalms command to display alarms for circuits on the PXM.

Syntax Description

dspswalms

Examples

spirit11.1.1.PXM.a > dspswalms

Node Switching Alarm Summary

Card Crossbar              Critical    0   Major    0   Minor    0

Crossbar Fabric            Critical    0   Major    0   Minor    0

Humvee Alarm               Critical    0   Major    0   Minor    0

espses3.2.PXM.a > 

dsptrapmgr

Use the dsptrapmgr command to display all the details about a trap manager.

Display details about all existing trap managers. The dsptrapmgr output shows:

•IP address of each trap manager

•Port number on the connected work station

•Row status

•Read trap flag stats

•Next trap sequence number

Of these elements, the IP address and port number result from addtrapmgr.

Syntax Description

dsptrapmgr

Examples

spirit11.1.1.PXM.a > dsptrapmgr

node19.8.PXM.a > dsptrapmgr

     ipAddress     PortNum  RowStatus   ReadTrapFlag  NextTrapSeqNum

  ---------------  -------  ----------  ------------  --------------

  171.71.55.21      2500       Add           Off       0

  172.29.65.87      2500       Add           Off       348

  172.71.59.21      2500       Add           Off       0

  LastTrapSeqNum:     385

NumOfValidEntries: 3

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 [-u -userid]

-u <user id>

User id. principle string length of 1-12..

Examples

Example C-18 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 > 

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   -

exit

Use the exit command to exit the current CLI shell.

Syntax Description

exit

Examples

Example C-19 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:

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. Net_mask is decided by type of IP address entered Note The mask value should be identical to the net_mask value. When set to different values, netmask becomes a sub_netmask by default. Do not set netmask unless you want to build a complicated SNMP network by using a subnet.
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

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 >

logout

Use the logout command to exit the current CLI shell.

Syntax Description

logout

Examples

Example C-20 To log out of the current CLI shell

spirit4.1.2.PXM.a > logout

(session ended)

memShow

Use the memShow command to view the current memory map.

Syntax Description

memShow

Examples

Example C-21 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 number> [-f]

slot	Slot number of the installed PXM, either 1 or 2.
-f	(optional) Clears the fail state on the slot.

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)

restoreallcnf

Use the restoreallcnf command to restore all configuration files saved in the CNF directory on the harddrive.

Syntax Description

restoreallcnf <-f filename>

-f (filename)	Zip file for configuration.
-v	Optional. Prints out the files restored. ( default: not ).

Examples

spirita.1.PXM.a > restoreallcnf

Usage :restoreallcnf -f FILENAME [-v]

  -f:FILENAME is the zip file for configuration

  option  -v:print out the files restored ( default:not )

spirita.1.PXM.a > restoreallcnf -f Unknown_01_200009270622

The current configuration will be replaced with the contents

of the specified file and the shelf will be rebooted.

Do you want to proceed (Yes/No)? y

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-22 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-23 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 >

saveallcnf

Use the saveallcnf command to saves all the configuration files to the CNF directory on the harddrive.The 'saveallcnf' command can be time-consuming. The shelf must not provision new circuits while this command is running. Do not run this command unless the shelf configuration is stableor you risk corrupting the saved configuration file.

Syntax Description

saveallcnf

Examples

spirit11.1.1.PXM.a > saveallcnf

Do you want to proceed (Yes/No)? y

saveallcnf:shelf configuration saved in C:/CNF/Unknown_01_200009270622.zip.

sesntimeout

Use the sesntimeout command to specify the number of seconds of idle time for the current user-session. If you do not specify a timeout period, the system displays the current timeout. At the end of the session, the system logs you out.

To disable the session timeout function, specify 0 seconds.

Syntax Description

sesntimeout [time_out]

time_out

Number of idle seconds time allowed for the session.

Examples

spirit11.1.1.PXM.a > sesntimeout 300

The timeout period for this session is now set to 300 second(s)

spirit11.1.1.PXM.a >

setrev

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

Syntax Description

setrev <slot><primaryversion><secondaryversion>

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)

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 <slot>

Syntax Description

switchapsln 1 f

switchapsln s 2

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 

Do you want to proceed (Yes/No)? 

timeout

Use the timeout command to display or change the maximum time a user can be idle before the system terminates that user's session. The units of measure are seconds. To change the timeout period, type a number that is less than or equal to 600 after the timeout command.

Syntax Description

timeout [timeout_period]

timeout_period

(Optional) Number of seconds for the new timeout period. The maximum is 600. If you do not enter a timeout_period, the system displays the current timeout period. To disable the session timeout function, enter 0.

Examples

spirit11.1.1.PXM.a > timeout 0

The timeout period for this session is now set to 0 second(s)

espses3.2.PXM.a > timeout 40000

The timeout period for this session is now set to 40000 second(s)

espses3.2.PXM.a > timeout 22

The timeout period for this session is now set to 22 second(s)

espses3.2.PXM.a > timeout 5

Err:input timed out

(session ended)

who

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

Syntax Description

who

Examples

Example C-24 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-25 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 >