cc/td/doc/product/wanbu/mgx8240/rel22
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Command Reference

Command Reference

This chapter gives the complete command set for the VCLI. The commands are hierarchical. Each level in the hierarchy is represented graphically by the indentation level. For example, one command is "save," which is a complete command. An example of a command with two levels is "delete connection." A command with three levels is "add system operator."

The commands are as follows:

add (add an element to the network)

change (change or modify an existing network element)

delete (remove an element from the network)

download (downloads current software image to switch)

exit (exit the VCLI program)

reboot (can reboot a card, or entire switch)

save (save the configuration into a card's non-volatile storage)

show (displays information about configuration, status or statistics)

add connection pl

Purpose

Add a Private Line connection. This can be either a local (within the same card) connection, or may be remote (on different cards), as long as:

Attributes

DS1 port to terminate connection on. [mandatory]

DS0s to use [required if NxDS0 w/N < 24]

Endpoint 2 DS1 port

Endpoint 2 DS0s to use [required if NxDS0 w/N < 24]

Admin Status (3 values: up, down, test)

Signaling Mode (2 values: None, Robbed Bit Signaling)

Partial Fill (integer 20 to 47, 0 for no partial fill)

Reassembly CDVT (integer 4 to 140)

Max Resassembly buffer size factor (integer 20 to 40)

CGA Mode (3 values: voice nontransparent, voice transparent, dataport transparent)

On-hook Robbed Bit Signaling towards endpoint 1 service interface (integer 0 to 15)

Off-hook Robbed Bit Signaling towards endpoint 1 service interface (integer 0 to 15)

On-hook Robbed Bit Signaling towards endpoint 2 service interface (integer 0 to 15)

Off-hook Robbed Bit Signaling towards endpoint 2 service interface (integer 0 to 15)

Unique Circuit Id [mandatory]

Other non-unique identifiers (string and number)

9 different TCA thresholds (if Dave can implement in this release?) (integers)

ATM VPI (applies to remote connections only) [optional - can be autogenerated]

(integer 0 to 2VPI Bits-1) - VPI bits currently 2 -> 0 to 3

ATM VCI (applies to remote connections only) [optional - can be autogenerated]

(integer 0 to 2VCI Bits) - VCI bits currently 12 -> 0 to 4095

Loss of Cell Alarm enable/disable

Options

-sname SwitchName Name of switch endpoint 1 of the connection will be added to

-card CardNum Number of the card (2 to 16) endpoint 1 of the connection will be added to

-ds3 DS3Num Number of the DS3 port containing the DS1 endpoint 1 of the connection will be added to

-ds1 DS1Num Number of the DS1 port endpoint 1 of the connection will be added to

-ds0 DS0s List of DS0 timeslots (1 to 24) to terminate endpoint 1 of the connection on the DS1 interfaces of the connections. For example: "(1,3,6-10)". Default = "(1-24)"

-e2sname SwitchName Name of switch endpoint 2 of the connection will be added to. Defaults to same value as -sname

-e2card CardNum Number of the card (2 to 16) endpoint 2 of the connection will be added to. Defaults to same values as -card.

-e2ds3 DS3Num Number of the DS3 port containing the DS1 endpoint 2 of the connection will be added to

-e2ds1 DS1Num Number of the DS1 port endpoint 2 of the connection will be added to

-e2ds0 DS0s List of DS0 timeslots (1 to 24) to terminate endpoint 2 of the connection. For example: "(1,3,6-10)". Default = "(1-24)"

-cktid CircuitIdString 64-character ASCII string identifying the connection. This ID must be unique within the network because it is also used to identify the ATM PVC. [mandatory]

-cname NameString 64-character ASCII string associated with the connection

-cnum Value 32-bit integer associated with the connection

-as up | down | test Admin Status of connection. Default = up.

sigmode none | robbed Channel Associated Signaling mode. Must be none if DS1 is Clear Channel. Default = none.

-pf Integer Partial cell fill (range 20 to 47, 0 for no partial fill). Only applies if DS1 is in Channelized mode. Default = 0.

-mrbf Integer Maximum Reassembly Buffer size Factor (in tenths) (range 20 to 40). Default = 20.

-rcdvt Integer Reassembly Cell Delay Variation Tolerance (in tenths of a millisecond) (range 4 to 140). Default = 30.

-cgamode vt | vn | dt Carrier Group Alarm mode. Only applies if DS1 is in Channelized mode.

vt = voice transparent, vn = voice non-transparent, dt = dataport transparent. This can only be set to "vn" when sigmode = robbed. This can only be set to "vt" or "dt" when sigmode = none. Default = vt.

-onhktc Integer On-Hook Trunk Conditioning Robbed Bit Signaling bits sent out the endpoint 1 DS1 interface (range 0 to 15). A bit is LSB, D bit is MSB. This only applies when cgamode = vn. Default = 0.

-offhktc Integer Off-Hook Trunk Conditioning Robbed Bit Signaling bits sent out the endpoint 1 DS1 interface (range 0 to 15). A bit is LSB, D bit is MSB. This only applies when cgamode = vn. Default = 3.

-e2onhktc Integer On-Hook Trunk Conditioning Robbed Bit Signaling bits sent out the endpoint 2 DS1 interface (range 0 to 15). A bit is LSB, D bit is MSB. This only applies when cgamode = vn. Default = 0.

-e2offhktc Integer Off-Hook Trunk Conditioning Robbed Bit Signaling bits sent out the endpoint 2 DS1 interface (range 0 to 15). A bit is LSB, D bit is MSB. This only applies when cgamode = vn. Default = 3.

-vpi Value VPI for ATM VCC on endpoint 1 card's trunk port (only if remote connection). Default = autogenerated.

-vci Value VCI for ATM VCC on endpoint 1 card's trunk port (only if remote connection). Default = autogenerated.

-e2vpi Value VPI for ATM VCC on endpoint 2 card's trunk port (only if remote connection). Default = autogenerated.

-e2vci Value VCI for ATM VCC on endpoint 2 card's trunk port (only if remote connection). Default = autogenerated.

-loc disable|enable Disable or enable an alarm when a circuit goes into a Loss of Cell condition. Disable = 1. Enable = 2. Default = enabled.

-tche15 Value Cells with Header Errors 15 minute TCA threshold setting value

-tche24 Value Cells with Header Errors 24 hour TCA threshold setting value

-tpr15 Value Pointer Reframes 15 minute TCA threshold setting value

-tpr24 Value Pointer Reframes 24 hour TCA threshold setting value

-tppe15 Value Pointer Parity Errors 15 minute TCA threshold setting value

-tppe24 Value Pointer Parity Errors 24 hour TCA threshold setting value

-tse15 Value Sequence Errors 15 minute TCA threshold setting value

-tse24 Value Sequence Errors 24 hour TCA threshold setting value

-tlc15 Value Lost Cells 15 minute TCA threshold setting value

-tlc24 Value Lost Cells 24 hour TCA threshold setting value

-tmc15 Value Misinserted Cells 15 minute TCA threshold setting value

-tmc24 Value Misinserted Cells 24 hour TCA threshold setting value

-tbu15 Value Buffer Underflows 15 minute TCA threshold setting value

-tbu24 Value Buffer Underflows 24 hour TCA threshold setting value

-tbo15 Value Buffer Overflows 15 minute TCA threshold setting value

-tbo24 Value Buffer Overflows 24 hour TCA threshold setting value

-tdc15 Value Dropped Cells 15 minute TCA threshold setting value

-tdc24 Value Dropped Cells 24 hour TCA threshold setting value

Example
    VCLI>>add connection pl -sname tulsa1 -card 3 -ds3 1 -ds1 5 -ds0 (1-6) -e2sname boston08 -e2card 5 -e2ds3 2 -e2ds1 13 -e2ds0 (7-12) -sigmode robbed
    -cgamode vn -cktid TU1315 Connection with endpoint 1 EPID = 279, endpoint 2 EPID = 362 created.

add connection segpl

Purpose

Add a local (within a single card) Private Line segment between a DS1 interface and the ATM trunk.

Attributes

DS1 port to terminate connection on. [mandatory]

DS0s to use if DS1 is configured for Channelized mode

Admin Status (3 values: up, down, test)

Signaling Mode (2 values: None, Robbed Bit Signaling)

Partial Fill (integer 20 to 47, or 0 for no partial fill)

Reassembly CDVT (integer 4 to 140)

Max Resassembly buffer size factor (integer 20 to 40)

CGA Mode (3 values: voice nontransparent, voice transparent, dataport transparent)

On-hook Robbed Bit Signaling towards service interface (integer 0 to 15)

Off-hook Robbed Bit Signaling towards service interface (integer 0 to 15)

On-hook Robbed Bit Signaling towards ATM interface (integer 0 to 15)

Off-hook Robbed Bit Signaling towards ATM interface (integer 0 to 15)

Unique Circuit ID [mandatory]

Other non-unique identifiers (string and number)

9 different TCA thresholds

ATM VPI [optional - can be autogenerated]


(integer 0 to 2VPI Bits-1) - VPI bits currently 2 -> 0 to 3

ATM VCI [optional - can be autogenerated]


(integer 0 to 2VCI Bits) - VCI bits currently 12 -> 0 to 4095

Loss of Cell Alarm enable/disable

Options

-sname SwitchName Name of switch the connection will be added to

-card CardNum Number of the card (2 to 16) the connection will be added to

-ds3 DS3Num Number of the DS3 port containing the DS1 the connection will be added to

-ds1 DS1Num Number of the DS1 port the connection will be added to

-ds0 DS0s List of DS0 timeslots (1 to 24) to terminate the connection on the DS1 interface of the PL segment. For example: "(1,3,6-10)".
Default = "(1-24)"

-cktid CircuitIdString 64-character ASCII string identifying the connection. This ID must be unique within the network because it is also used to identify the Ascent ATM PVC. [mandatory]

-cname NameString 64-character ASCII string associated with the connection

-cnum Value 32-bit integer associated with the connection

-as up | down | test Admin Status of connection. Default = up.

-sigmode none | robbed Channel Associated Signaling mode. Must be none if DS1 is Clear Channel. Default = none.

-pf Integer Partial cell fill (range 20 to 47, 0 for no partial fill). Only applies if DS1 is in Channelized mode. Default = 0.

-mrbf Integer Maximum Reassembly Buffer size Factor (in tenths) (range 20 to 40). Default = 20.

-rcdvt Integer Reassembly Cell Delay Variation Tolerance (in tenths of a millisecond) (range 4 to 140). Default = 30.

-cgamode vt | vn | dt Carrier Group Alarm mode. Only applies if DS1 is in Channelized mode. vt = voice transparent, vn = voice non-transparent, dt = dataport transparent. This can only be set to "vn" when sigmode = robbed. This can only be set to "vt" or "dt" when sigmode = none. Default = vt.

-onhktc Integer On-Hook Trunk Conditioning Robbed Bit Signaling bits sent out the DS1 interface (range 0 to 15). A bit is LSB, D bit is MSB. This only applies when cgamode = vn. Default = 0.

-offhktc Integer Off-Hook Trunk Conditioning Robbed Bit Signaling bits sent out the CES interface (range 0 to 15). A bit is LSB, D bit is MSB. This only applies when cgamode = vn. Default = 3.

-e2onhktc Integer On-Hook Trunk Conditioning Robbed Bit Signaling bits sent out the ATM interface (range 0 to 15). A bit is LSB, D bit is MSB. This only applies when cgamode = vn. Default = 0.

-e2offhktc Integer Off-Hook Trunk Conditioning Robbed Bit Signaling bits sent out the ATM interface (range 0 to 15). A bit is LSB, D bit is MSB. This only applies when cgamode = vn. Default = 3.

-vpi VPI for ATM VCC. Default = autogenerated.

-vci VCI for ATM VCC. Default = autogenerated.

-loc disable|enable Disable or enable an alarm when a circuit goes into a Loss of Cell condition. Disable = 1. Enable = 2. Default = enabled.

-tche15 Value Cells with Header Errors 15 minute TCA threshold setting value

-tche24 Value Cells with Header Errors 24 hour TCA threshold setting value

-tpr15 Value Pointer Reframes 15 minute TCA threshold setting value

-tpr24 Value Pointer Reframes 24 hour TCA threshold setting value

-tppe15 Value Pointer Parity Errors 15 minute TCA threshold setting value

-tppe24 Value Pointer Parity Errors 24 hour TCA threshold setting value

-tse15 Value Sequence Errors 15 minute TCA threshold setting value

-tse24 Value Sequence Errors 24 hour TCA threshold setting value

-tlc15 Value Lost Cells 15 minute TCA threshold setting value

-tlc24 Value Lost Cells 24 hour TCA threshold setting value

-tmc15 Value Misinserted Cells 15 minute TCA threshold setting value

-tmc24 Value Misinserted Cells 24 hour TCA threshold setting value

-tbu15 Value Buffer Underflows 15 minute TCA threshold setting value

-tbu24 Value Buffer Underflows 24 hour TCA threshold setting value

-tbo15 Value Buffer Overflows 15 minute TCA threshold setting value

-tbo24 Value Buffer Overflows 24 hour TCA threshold setting value

-tdc15 Value Dropped Cells 15 minute TCA threshold setting value

-tdc24 Value Dropped Cells 24 hour TCA threshold setting value

Example
    VCLI>>add conn segpl -sname tulsa1 -card 3 -ds3 1 -ds1 5 -ds0 (1-6) -sigmode robbed -cgamode vn -cktid TU1315 Connection with EPID = 279 created.

add system cescard

Purpose

Add a CES Processing Engine card (within a switch) to the VCLI system.

Attributes

Card Number (2 to 16) [mandatory]

In-band IP Address - using decimal dot notation (e.g. 209.50.172.45) [optional] -only needed if the autogenerated in-band IP address was overridden on the card.

Uplink logical port identifier (e.g. switch.100.101.102.103.card.6.pport.4.lport.2) [optional] If not supplied, remote Private Line connections will require manual configuration of the intermediate ATM PVC.

Options

-sname SwitchName Name of switch to add this card to

-card CardNumber Slot number of card to add

-ipaddr IPAddress In-band management IP address

-uplinklp logPortId Logical port identifier of connected port

-m131ip IP address of the m13 for ds3 #1

-m132ip IP address of the m13 for ds3 #2

-m133ip IP address of the m13 for ds3 #3

-m131com community string of the m13 for ds3 #1

-m132com community string of the m13 for ds3 #2

-m133com community string of the m13 for ds3 #3

Example
    VCLI>>add sys cescard -sname tulsa1 -card 2 -ipaddr 192.63.145.18 -uplinklp switch.100.101.102.103.card.6.pport.4.lport.2

add system operator

Purpose

This adds an operator to the VCLI system.

Atributes

Operator Name [mandatory]

Privilege Level (3 values: admin, change, show) [mandatory]

Options

-name OperatorName Name of the operator to add

-priv admin | change | show Privilege Level

Usage

This command requires "admin" privilege level.

Example
    VCLI>>add system operator -name jdsmith -priv change

add system switch

Purpose

Add a switch to the VCLI system. This associates a switch name with its out-of-band (ethernet) IP address.

Attributes

Switch Name - used to identify the switch in all commands with the switch name identifier -sname. Can only be alphanumeric and underscore characters; length limit is 64 characters [mandatory]

Out-of-band IP Address using decimal dot notation (e.g. 206.14.150.201)[mandatory]

SNMP Community String for reading and writing to the switch [mandatory]

Chassis ID number - assigned at the factory, can be read from the barcode sticker under the power input on the back of the chassis [mandatory]

Usage

This command requires "admin" privilege level.

Options

-sname SwitchName Name of the switch to add

-ipaddr IPAddress Out-of-band management IP address

-community String ASCII string to be used as the SNMP community string in all Set and Get SNMP PDUs sent to the cards in this switch

-chassisid ChassisID An integer number indicated on the back of the chassis

-ftppass password For downloading software images; use up to 8 characters

Example
    VCLI>>add sys switch -sname tulsa1 -ipaddr 206.14.150.201 -community borg19e
    -chassisid 23

change cescard aps

Purpose

Change SONET Automatic Protection Switching attributes for a CES Processing Engine card.

Attributes

Administrative Status (2 values: enabled, disabled)

Directional Mode (2 values: unidirectional, bidirectional)

BER Threshold (6 values: 10-4, 10-5, 10-6, 10-7, 10-8, 10-9)

Commands (6 values: clear, lockout, forced switch to protection, forced switch to working, manual switch to protection, manual switch to working)

Options

-sname SwitchName Name of containing switch to change card APS for

-card CardNum Number of the card (2 to 16) to change APS for

- side access | trunk User specifies where to change APS on TDM access or ATM Trunk. Only applies to CS3 blades with 4 OC3 ports.

-as enabled | disabled Administrative status of APS function

-dir unidir | bidir Directional mode. Can only be modified when APS is disabled.

-berthresh

minus4 | minus5 |

minus6 |-minus7 |

minus8 | minus9 Exponent of 10 of Bit Error Rate threshold for switching

Can only be modified when APS is disabled

-cmd

clear | lock |

force2prot |force2work

| man2prot | man2work

clear APS control command:

Clears any existing command (normal case)
lock - Lockout all protection switching
force2prot - Forces switchout of working line to protection
force2work - Forces switchout of protection line to working (only for 1+1 per spec)
man2prot - causes switchout of working line to protection if no higher priority request is in effect
man2work - causes switchout of protection line to working if no higher priority request is in effect (only for 1+1 per spec)

If '-side' argID is specified on a CES card that only supports Trunk side OC3 interfaces, this option is to be ignored.

Example
    VCLI>>change cescard aps -sname tulsa1 -card 3 -as enabled

If the componentType attribute of the CES card is CS3 blade type (value=29) and the componentType of the I/O card is 4OC3 ports (value=28), this card is capable of supporting APS on both the Access and Trunk side. The user must specify which side in this case. If neither of the ComponentType values described above is true, APS is supported on the Trunk side only.


Note   The side (Access or Trunk) determines what the index into the APS mib tables will be. The Trunk side uses an index of 0 and the access side uses an index of 1.

change cescard config

Purpose

Change the following card information:

Options

-sname SwitchName Name of containing switch to change card config for

-card CardNum Number of the card (2 to 16) to change config for

-name NameString An identifier string for the card

-location LocationString A location string for the card

-contact ContactString A contact string for the card

-fanmon ena | dis Controls fan tray monitoring

-chasip IP Address Chassis external IP address used during transmission of SNMP traps

Example
    VCLI>>change cescard config -sname tulsa1 -card 2 -name Tulsa1_card2 -fanman ena

change cescard image

Prompts the user to verify the command.

Options

-network 1 Change all known cards in the network.

-sname SwitchName Name of containing switch to change card config for.

-card CardNum Number of the logical card (may not be actual card in some redundancy).

-physcard CardNum Number of the actual card (overrides redundancy status).

-swcmd command Optional command to allow the user to force the behavior of the switch during download.

-noconfirm Execute this command without prompting user for confirmation.

-wait yes/no Setting this allows user to wait for the completion of the command. Values: yes=1, no=2, default: yes.

Example
    VCLI>>change cescard image -sname tulsal -card 3 -swcmmd 2 Are you sure [NO]? Switch Name: Tulsa Command sent to switch tulsa card(s) 3 Update in progress... ..................... Card 3 successful

The argId '-physcard' tells the vcli to communicate with the CPE card located in physical slot 3. This bypasses the logic that will be in effect should the primary CPE card be switched out. Using the '-card' option will not bypass vcli redundancy logic, and if the CPE card in slot 3 is switched out, the VCLI will communicate with the switched in backup.

If the -swcmd option is not specified, the VCLI will use 'contents' file in the relevant image directory to find the line with swdwnld command and use its value. This line is usually the very first non-comment line in the 'contents' file.

This command shows the progress of the upgrade/downgrade procedure on the CES card. The VCLI shows if the upgrade/downgrade was successful as reported by the CES card. This way, users are alerted to an upgrade/downgrade failure and can take action.

change cescard inband

Purpose

Change the attributes of a CES Processing Engine card's in-band management ATM PVC.

Attributes

IP Address of inband interface

Subnet mask for inband interface

Default Gateway address to go out the inband interface

VPI for inband ATM PVC

VCI for inband ATM PVC

Sustained Cell Rate (SCR) for ATM PVC

Peak Cell Rate (PCR) for ATM PVC

OAM Loopback testing

Disable inband default route

Options

-sname SwitchName Name of containing switch to change card inband management for

-card CardNum Number of the card (2 to 16) to change inband management for

-ipaddr IPAddress IP address of inband management interface (in decimal dot notation)

-ipdefault 1 Sets the inband IP interface address back to the auto-generated default

-submask SubnetMask Subnet mask for inband management interface (in decimal dot notation)

-gateway IPAddress IP Address of default gateway when inband interface is working (in decimal dot notation)

-vpi VPIValue VPI value for inband management ATM PVC

-vci VCIValue VCI value for inband management ATM PVC

-scr CellRate Sustained Cell Rate for shaping of inband management traffic (in cells per seconds)

-pcr CellRate Peak Cell Rate for shaping inband management traffic (in cells per second)

-oamlr end | segment Type of ATM OAM loopback to request, end-to-end or segment. View the results of this test using the "show cescard inband statistics" command.

-ethforce ena | dis force use of the ethernet default gateway (regardless of inband connection state)

Only one of the options, either -ipaddr or -ipdefault may be specified in the same command.

Example
    VCLI>>change cescard inband -sname tulsa1 -card 3 -gateway 10.128.0.18

change cescard redundancy

Change a CES Processing Engine card's redundancy configuration/behavior.

The following action can be performed on a card that is not a member of a redundancy group (Role = None):

The following actions can be performed for a card that is a backup:

The following action can be performed for a card that is a primary member of a redundancy group:

Usage

Actions vary depending on whether the card is a primary, backup, or neither.

Options

Only one of the attributes "role" or "force" may be used in a single command.

-sname SwitchName Name of containing switch to change card redundancy for

-card CardNum Number of the card (2 to 16) to change redundancy for (mandatory)

-role prim | back | none Change redundancy role of the card

-force over Force backup to switch in for the card specified by -card

-force back Force the backup indicated by -card to switch the primary it is currently protecting back into service

-override ena Force redundancy command to be set regardless of the state of the target cards

Example

Command examples to create a redundancy group with two primaries in it:

    VCLI>>change cescard redundancy -sname tulsa1 -card 2 -role back VCLI>>change cescard redundancy -card 3 -role prim VCLI>>change cescard redundancy -card 4 -role prim

Command example to force backup to switch in for card 4:

    VCLI>>change cescard redundancy -sname tulsa1 -card 4 -force over

Command example to force backup to switch the primary it is currently switched in for back:

    VCLI>>change cescard redundancy -sname tulsa1 -card 2 -force back

Command examples to remove a redundancy group with two primaries in it:

    VCLI>>change cescard redundancy -sname tulsa1 -card 3 -role none VCLI>>change cescard redundancy -card 4 -role none VCLI>>change cescard redundancy -card 2 -role none

change cescard refclock

Purpose

Change the reference clock control attributes for a CES Processing Engine card.

Attributes

Primary Timing Reference (5 values: none, BITS A, BITS B, OC3 1, OC3 2)

Secondary Timing Reference (5 values: none, BITS A, BITS B, OC3 1, OC3 2)

Revertive Switching (2 values: disabled, enabled)

Force Free Run (2 values: off, on)

Switch To (2 values: primary, secondary)

Options

-sname SwitchName Name of containing switch to change card refclock for

-card CardNum Number of the card (2 to 16) to change refclock for

-prim bitsa | bitsb

| oc31 | oc32 | none New primary timing source (optional)

-second bitsa | bitsb

| oc31 | oc32 | none New secondary timing source (optional)

-revert disable | enable New value for revertive switching (optional)

-forcefr off | on New value for forcing timing to free run (optional)

-swto prim | second Controls switching to a different timing reference (optional)

Example
    VCLI>>change cescard refclock -sname tulsa1 -card 3 -second oc31 -revert enable

change connection pl

Purpose

Change the attributes of a Private Line connection. This will only change one endpoint of the Private Line Connection. This can be a local (within the same card) connection or a remote (on different cards). Nothing can be changed about the ATM PVC (if it is a remote connection).

Attributes

Admin Status (3 values: up, down, test)

OAM Loopback Request (2 values: end-to-end, segment) - only applies to remote connections.

Reassembly CDVT (integer 4 to 140)

Max Resassembly buffer size factor (integer 20 to 40)

CGA Mode (2 values: voice transparent, dataport transparent)

On-hook Robbed Bit Signaling towards endpoint 1 service interface (integer 0 to 15)

Off-hook Robbed Bit Signaling towards endpoint 1 service interface (integer 0 to 15)

On-hook Robbed Bit Signaling towards endpoint 2 service interface (integer 0 to 15)

Off-hook Robbed Bit Signaling towards endpoint 2 service interface (integer 0 to 15)

Loss of Cell Alarm (2 values: disable, enable)

9 different TCA thresholds

BERT parameters

Options

-sname SwitchName Name of switch containing the connection.

-card CardNum Number of the card (2 to 16) containing the connection.

-epid EndpointId Endpoint Identifier of the connection endpoint to be changed.

-as up | down | test Admin Status of connection.

-oamlr end | segment Type of ATM OAM loopback to request, end-to-end or segment. This only applies for remote PL's. View the results of this test using the "show connection pl summary" command.

-loop Specifies the loopback mode for the connecting Values. 0 = none. 1 = out.

2 = in. This value applies only to "change connection."

-mrbf Integer Maximum Reassembly Buffer size Factor (in tenths) (range 20 to 40). Changing this parameter will cause temporary data loss on the connection.

-rcdvt Integer Reassembly Cell Delay Variation Tolerance (in tenths of a millisecond) (range 4 to 140). Changing this parameter will cause temporary data loss on the connection.

-cgamode vt | dt Carrier Group Alarm mode. This is only changeable when the containing DS1 is set for Channelized mode, and the sigmode = none for the connection.

-onhktc Integer On-Hook Trunk Conditioning Robbed Bit Signaling bits sent out the DS1 interface (range 0 to 15). A bit is LSB, D bit is MSB. This is only changeable when cgamode = vn.

-offhktc Integer Off-Hook Trunk Conditioning Robbed Bit Signaling bits sent out the DS1 interface (range 0 to 15). A bit is LSB, D bit is MSB. This is only changeable when cgamode = vn.

-e2onhktc Integer On-Hook Trunk Conditioning Robbed Bit Signaling bits sent out the other endpoint's interface (range 0 to 15). A bit is LSB, D bit is MSB. This is only changeable when cgamode = vn.

-e2offhktc Integer Off-Hook Trunk Conditioning Robbed Bit Signaling bits sent out the other endpoint's interface (range 0 to 15). A bit is LSB, D bit is MSB. This is only changeable when cgamode = vn.

-name NameString 64 character ASCII string associated with the connection.

-cnum Value 32 bit integer associated with the connection.

loc disable|enable Turns off the generation of an alarm went he circuit goes into Loss of Cell condition. Disable = 1. Enable = 2.

-tche15 Value Cells with Header Errors 15 minute TCA threshold setting.

-tche24 Value Cells with Header Errors 24 hour TCA threshold setting.

-tpr15 Value Pointer Reframes 15 minute TCA threshold setting.

-tpr24 Value Pointer Reframes 24 hour TCA threshold setting.

-tppe15 Value Pointer Parity Errors 15 minute TCA threshold setting.

-tppe24 Value Pointer Parity Errors 24 hour TCA threshold setting.

-tse15 Value Sequence Errors 15 minute TCA threshold setting.

-tse24 Value Sequence Errors 24 hour TCA threshold setting.

-tlc15 Value Lost Cells 15 minute TCA threshold setting.

-tlc24 Value Lost Cells 24 hour TCA threshold setting.

-tmc15 Value Misinserted Cells 15 minute TCA threshold setting.

-tmc24 Value Misinserted Cells 24 hour TCA threshold setting.

-tbu15 Value Buffer Underflows 15 minute TCA threshold setting.

-tbu24 Value Buffer Underflows 24 hour TCA threshold setting.

-tbo15 Value Buffer Overflows 15 minute TCA threshold setting.

-tbo24 Value Buffer Overflows 24 hour TCA threshold setting.

-tdc15 Value Dropped Cells 15 minute TCA threshold setting.

-tdc24 Value Dropped Cells 24 hour TCA threshold setting.

-bertdir tdm or atm Direction to send the BERT pattern. Towards the Access (tdm), or towards ATM network. Can't change while test is running.

-bertpatt allones | 511

|2047 | qrss | 2^23-1

| 3 in 24 | user BERT pattern. Can't change while test is running.

-userpatt hexPattern User defined BERT pattern. A 32 bit pattern represented by an 8 character hexadecimal number. Can't change while test is running.

-userpattlen Value User defined BERT pattern length. A number from 1 to 32. Can't change while test is running.

-txpattinv off | on BERT transmit pattern bit inversion control. Can't change while test is running.

-rxpattinv off | on BERT receive pattern bit inversion control. Can't change while test is running.

-bert on | off Controls the running of the integrated BER test for this DS1.

-bertrestart no | yes Restarts the running BERT test. Only applies when "-bert on".

-1bitinsert no | yes Inserts a single bit error into the transmitted BERT pattern. Only applies when "-bert on"

.

-conterrinsert none | Continously inserts bit errors into the transmitted BERT pattern at a rate of 10 to the minus 1 through 7. Can be modified while the test is running.

minus1 | minus2 |

minus3 | minus4 |

minus5 | minus6 |

minus7

Example
    VCLI>>change conn pl -sname tulsa1 -card 3 -epid 283 -oamlr end

change connection segpl

Purpose

Change the attributes of a local Private Line segment.

Attributes

Admin Status (3 values: up, down, test)

OAM Loopback Request (2 values: end-to-end, segment)

Reassembly CDVT (integer 4 to 140)

Max Resassembly buffer size factor (integer 20 to 40)

CGA Mode (2 values: voice transparent, dataport transparent)

On-hook Robbed Bit Signaling towards service interface (integer 0 to 15)

Off-hook Robbed Bit Signaling towards service interface (integer 0 to 15)

On-hook Robbed Bit Signaling towards ATM interface (integer 0 to 15)

Off-hook Robbed Bit Signaling towards ATM interface (integer 0 to 15)

Loss of Cell Alarm (2 values: disable, enable)

9 different TCA thresholds

BERT parameters

Options

-sname SwitchName Name of switch containing the connection.

-card CardNum Number of the card (2 to 16) containing the connection.

-epid EndpointId Endpoint Identifier of the connection to be changed.

-as up | down | test Admin Status of connection.

-oamlr end | segment Type of ATM OAM loopback to request, end-to-end or segment. View the results of this test using the "show connection segpl summary" command.

-loop Specifies the loopback mode for the connection. 0 = none. 1 = out. 2 = in. This option applies only to "change connection."

-mrbf Integer Maximum Reassembly Buffer size Factor (in tenths) (range 20 to 40). Changing this parameter will cause temporary data loss on the connection.

-rcdvt Integer Reassembly Cell Delay Variation Tolerance (in tenths of a millisecond) (range 4 to 140). Changing this parameter will cause temporary data loss on the connection.

-cgamode vt | dt Carrier Group Alarm mode. This is only changeable when the containing DS1 is set for Channelized mode, and the sigmode = none for the connection.

-onhktc Integer On-Hook Trunk Conditioning Robbed Bit Signaling bits sent out the DS1 interface (range 0 to 15). A bit is LSB, D bit is MSB. This is only changeable when cgamode = vn.

-offhktc Integer Off-Hook Trunk Conditioning Robbed Bit Signaling bits sent out the DS1 interface (range 0 to 15.. A bit is LSB, D bit is MSB. This is only changeable when cgamode = vn.

-e2onhktc Integer On-Hook Trunk Conditioning Robbed Bit Signaling bits sent out the ATM interface (range 0 to 15). A bit is LSB, D bit is MSB. This is only changeable when cgamode = vn.

-e2offhktc Integer Off-Hook Trunk Conditioning Robbed Bit Signaling bits sent out the ATM interface (range 0 to 15). A bit is LSB, D bit is MSB. This is only changeable when cgamode = vn.

-cname NameString 64 character ASCII string associated with the connection.

-cnum Value 32 bit integer associated with the connection.

-loc disable | enable Turns off/on the generation of an alarm when the circuit goes in the Loss of Cell condition. Disable = 1. Enable = 2.

-tche15 Value Cells with Header Errors 15 minute TCA threshold setting value.

-tche24 Value Cells with Header Errors 24 hour TCA threshold setting value.

-tpr15 Value Pointer Reframes 15 minute TCA threshold setting value.

-tpr24 Value Pointer Reframes 24 hour TCA threshold setting value.

-tppe15 Value Pointer Parity Errors 15 minute TCA threshold setting value.

-tppe24 Value Pointer Parity Errors 24 hour TCA threshold setting value.

-tse15 Value Sequence Errors 15 minute TCA threshold setting value.

-tse24 Value Sequence Errors 24 hour TCA threshold setting value.

-tlc15 Value Lost Cells 15 minute TCA threshold setting value.

-tlc24 Value Lost Cells 24 hour TCA threshold setting value.

-tmc15 Value Misinserted Cells 15 minute TCA threshold setting value.

-tmc24 Value Misinserted Cells 24 hour TCA threshold setting value.

-tbu15 Value Buffer Underflows 15 minute TCA threshold setting value.

-tbu24 Value Buffer Underflows 24 hour TCA threshold setting value.

-tbo15 Value Buffer Overflows 15 minute TCA threshold setting value.

-tbo24 Value Buffer Overflows 24 hour TCA threshold setting value.

-tdc15 Value Dropped Cells 15 minute TCA threshold setting value.

-tdc24 Value Dropped Cells 24 hour TCA threshold setting value.

-bertdir tdm or atm Direction to send the BERT pattern. Towards the Access (tdm), or towards ATM network. Can't change while test is running.

-bertpatt allones | 511

|2047 | qrss | 2^23-1

|3 in 24 | user BERT pattern. Can't change while test is running.

-userpatt hexPattern User defined BERT pattern. A 32 bit pattern represented by an 8 character hexadecimal number. Can't change while test is running.

-userpattlen Value User defined BERT pattern length. A number from 1 to 32. Can't change while test is running.

-txpattinv off | on BERT transmit pattern bit inversion control. Can't change while test is running.

-rxpattinv off | on BERT receive pattern bit inversion control. Can't change while test is running.

-bert on | off Controls the running of the integrated BER test for this DS1.

-bertrestart no | yes Restarts the running BERT test. Only applies when "-bert on".

-1bitinsert no | yes Inserts a single bit error into the transmitted BERT pattern. Only applies when "-bert on".

-conterrinsert none |

minus1 | minus2 |

minus3 | minus4 |

minus5 | minus6 |

  minus7 Continously inserts bit errors into the transmitted BERT pattern at a rate of 10 to the minus 1 through 7. Can be modified while the test is running.

Example
    VCLI>>change conn segpl -sname tulsa1 -card 3 -epid 279 -oamlr end

change delaytest

Purpose

Measure delay across the network using OAM loopback cells. Use this command to configure one of the tests, or change the status of an ongoing test. Each card can run up to 30 simultaneous delay tests.

Use of the '-testnum' argId is optional when configuring a new test. If the '-testnum' argId is not given, then the VCLI will use the first ATM OAM delay test that has a 'disabled' state and has remaining test time of 0. If there is no test which has a state of 'disabled' and remaining time of 0, VCLI will select the first test with state of 'disabled'. If you wish to avoid having the VCLI pick the test number, then enter it on the command line using -testnum argId.

Attributes

connection id of the circuit to run the test on (integer 257-4096)

test state (enabled / disabled)

test duration given in seconds (integer 1-604800) max is 1 week

test number to run the test (integer 1-30)

Options

-sname SwitchName Name of switch containing the connection endpoint to be tested.

-card CardNum Number of the card (2 to 16) containing the connection endpoint to be tested.

-epid EndpointId Endpoint Identifier of the connection endpoint to be tested.

-tstate disable/enable State of the test. Disable == 0, Enable == 1.

-dur Integer Test duration given in seconds. (1-604800) Max is 1 week.

-testnum Integer The number which defines which of the available 30 tests to configure.

Example
    VCLI>>change delaytest -sname tulsa1 -card 3 -epid 283 -tstate enable -dur 60

change environment

Purpose

Changes environment variables for the current login session.

Attributes

Autosave (enable or disable).The Autosave feature is used to save the configuration into a card's non-volatile storage after every change command. This should be disabled if doing mass configuration using scripts. To manually save changes to non-volatile storage when the Autosave feature is disable, use the "save" command.

Timeout — (time in minutes). The controls how long before the VCLI program will automatically terminate when idle (no commands are issued). Setting the timeout value to zero will disable the timeout feature.

Paging — (page length in lines). The paging feature causes the VCLI to output only a single page of output before giving the option to either "quit" (terminate the command), or output another page of information. Setting the paging value to 0 will disable the feature.

Ascendpro — (enable or disable). This controls the automatic creation of ATM PVCs across the ATM network when a Private Line connection is added that has endpoints on two different CES cards.

Provisioning Client CLI Directory — The directory to find the Provisioning Client CLI commands.

SNMP Timeout— (seconds). The number of seconds the VCLI should wait for an SNMP response before deciding that an SNMP PDU was lost.

Software Image — (directory). The directory to get a software image from that is to be downloaded to a switch. This defaults to $VCLI_DIR/image.

Logging — (loglevel). Log levels are from 0 to 4. 0 = disabled; 1 = add/delete commands logged; 4 = all commands logged including those that generate errors.

Options

-autosave ena | dis Controls the autosave feature.

-timeout Minutes Idle time before session termination (0=never).

-paging Lines Number of lines per page (0=no paging).

-ascendpro ena | dis Controls PVC auto-provisioning.

-provdir DirPath Path to the Provisioning CLI directory.

-snmptimeout Seconds The number of seconds to wait for SNMP command completion.

-imagedir DirPath Path to the download image directory.

-logging loglevel Current level of logging.

Example
    VCLI>>change environment -autosave ena -timeout 30 -paging 40

change imccard config

Purpose

Changes the following card information:

Options

-sname SwitchName Name of containing switch for which to change card config

-name NameString An identifier string for the card

-location LocationString A location string for the card

-contact ContactString ContactString A contact string for the card

Example
    VCLI>>change imccard config -sname tulsa1 -name Tulsa1_IMC -location Tulsa_pop

change imccard image

Purpose

Changes the active software image running on the IMC card.

Options

-network Change all known cards in the network.

-sname SwitchName Name of containing switch for which to change card config.

-swcmd command Optional command to allow the user to force the behavior of the switch during download.

-noconfirm 1 Execute this command without prompting user for confirmation.

-wait yes|no Setting this allows user to wait for the completion of the command. Values: yes=1, no=2. Default: yes.

Example
    VCLI>>change imccard image -sname tulsa1 -swcmd 2 Are you sure [NO]? Switch Name: tulsa Command sent to switch tulsa card(s) 1 Update in progress.............................. Card 1 successful

This command will prompt the user to verify the command.

If the -swcmd option is not specified, the VCLI will use 'contents' file in the relevant image directory to find the line with swdwnldCommand and use it's value. This line is usually the very first non-comment line in the 'contents' file.

This command will show the progress of the upgrade/downgrade procedure on the IMC card. The VCLI will show if the upgrade/downgrade was successful as reported by the IMC card. The intention is for the user to be alerted to a upgrade/downgrade failure and to act upon it.

change imccard redundancy

Purpose

This command will force a switch over to the existing backup card if it exists. The user will be queried to verify the command before the VCLI forces a switchover to the backup IMC. Force a switch-over to the backup IMC card that is waiting in hot standby mode.

Options

-sname SwitchName Name of containing switch for which to change card redundancy.

-force over Force backup to switch in for the primary IMC.

Example
    VCLI>>change imccard redundancy -sname tulsa1 -force over Are You Sure [No]?

change logicalport atm

Purpose

Change the attributes of the ATM logical port.

Attributes

Admin Status (2 values: up, down)

Identifier String

Options

-sname SwitchName Name of switch containing the ATM BC

-card CardNum Number of the card (2 to 16) containing the ATM BC

-as up | down Admin Status ATM BC

-name NameString Name string for ATM BC

Example
    VCLI>>change logicalport atm -sname tulsa1 -card 3 -as down

change physicalport ds1

Purpose

Change the attributes of a DS1 port.

Attributes

Admin Status (3 values: up, down, test)

Channelization Mode (Channelized, Clear Channel)

Timing Mode (Internal, Through)

Framing Mode (ESF, SF, Other)

Facilities Data Link (2 values: none, T1.403)

Bit-Oriented Send Code (3 values: None, Line Loop Request, Payload Loop Request)

Loopback Control (2 values: disabled, payload loop, line loop if managed M1:3 Multiplexor configured)

Line build-out (if managed M1:3 Multiplexor is configured)

Line Coding (if managed M1:3 Multiplexor is configured)

Identifier String

15 TCA Thresholds (integer)

BERT parameters

Options

-sname SwitchName Name of switch containing the DS1

-card CardNum Number of the card (2 to 16) containing the DS1

-ds3 DS3Num Number of the DS3 containing the DS1

-ds1 DS1Num Number of the DS1

-as up | down | test Admin Status of DS1 Port

-chanmode clear | chan Channelization mode, Clear Channel or Channelized

-timing int | thru Timing, Internal or Through

-frm esf | sf | other DS1 framing type, ESF, SF(D4), or Other (unknown)

-fdl ansi | none DS1 Facilities Data Link

-sc none | lineloop

| payloop DS1 Send Code

-loop none | payload

| line DS1 Near End loopback control

-lbo 133 | 266 | 399

| 533 | 665 DS1 Line Build-out upper range

-lcode ami | b8zs DS1 line coding

-name Ds1Name DS1 Physical line Description or Identifier String

-cfgs 1 DS1 Port Configuration save to non volatile memory, any integer saves

-tes15 Value Errored Seconds 15 minute TCA threshold setting value

-tes24 Value Errored Seconds 24 hour TCA threshold setting value

-tses15 Value Severely Errored Seconds 15 minute TCA threshold setting value

-tses24 Value Severely Errored Seconds 24 hour TCA threshold setting value

-tsefs15 Value Severely Errored Framing Seconds 15 minute TCA threshold setting value

-tsefs24 Value Severely Errored Framing Seconds 24 hour TCA threshold setting value

-tpcv15 Value Path Coding Violations 15 minute TCA threshold setting value

-tpcv24 Value Path Coding Violations 24 hour TCA threshold setting value

-tuas15 Value Unavailable Seconds 15 minute TCA threshold setting value

-tuas24 Value Unavailable Seconds 24 hour TCA threshold setting value

-taiss15 Value Alarm Indication Signal Seconds 15 minute TCA threshold setting value

-taiss24 Value Alarm Indication Signal Seconds 24 hour TCA threshold setting value

-tcss15 Value Controlled Slip Seconds 15 minute TCA threshold setting value

-tcss24 Value Controlled Slip Seconds 24 hour TCA threshold setting value

-toof15 Value Out of Frame Events 15-minute TCA threshold setting value

-toof24 Value Out of Frame Events 24-hour TCA threshold setting value

-tfeles15 Value Far End Line Errored Seconds 15 minute TCA threshold setting value

-tfeles24 Value Far End Line Errored Seconds 24 hour TCA threshold setting value

-tfees15 Value Far End Errored Seconds 15 minute TCA threshold setting value

-tfees24 Value Far End Errored Seconds 24 hour TCA threshold setting value

-tfeses15 Value Far End Severely Errored Seconds 15 minute TCA threshold setting value

-tfeses24 Value Far End Severely Errored Seconds 24 hour TCA threshold setting value

-tfesefs15 Value Far End Severely Errored Framing Seconds 15 minute TCA threshold setting value

-tfesefs24 Value Far End Severely Errored Framing Seconds 24 hour TCA threshold setting value

-tfepcv15 Value Far End Path Coding Violations 15 minute TCA threshold setting value

-tfepcv24 Value Far End Path Coding Violations 24 hour TCA threshold setting value

-tfeuas15 Value Far End Unavailable Seconds 15 minute TCA threshold setting value

-tfeuas24 Value Far End Unavailable Seconds 24 hour TCA threshold setting value

-tfecss15 Value Far End Controlled Slip Seconds 15 minute TCA threshold setting value

-tfecss24 Value Far End Controlled Slip Seconds 24 hour TCA threshold setting value

-bertframe esf | sf

| none DS1 framing to use when performing a BER test. Can't change while test is running

-bertpatt allones | 511

|2047 | qrss | 2^23-1

| 3in24 | user

BERT pattern. Can't change while test is running.

-userpatt hexPattern User defined BERT pattern. A 32 bit pattern represented by an 8 character hexadecimal number. Can't change while test is running.

-userpattlen Value User defined BERT pattern length. A number from 1 to 32. Can't change while test is running.

-txpattinv off | on BERT transmit pattern bit inversion control. Can't change while test is running.

-rxpattinv off | on BERT receive pattern bit inversion control. Can't change while test is running.

-bert on | off Controls the running of the integrated BER test for this DS1.

-bertrestart yes | no Restarts the running BERT test. Only applies when "-bert on". Yes = 2.

No = 1.

-1bitinsert yes | no Inserts a single bit error into the transmitted BERT pattern. Only applies when "-bert on". Yes = 2. No = 1.

-conterrinsert none | Continously inserts bit errors into the transmitted BERT pattern at a rate of 10 to the minus 1 through 7. Can be modified while the test is running. minus1 | minus2 | minus3 | minus4 | minus5 | minus6 | minus7

If either of chanmode, timing, or frm attributes are being changed, all three of these attributes must be specified. Neither of these attributes may be changed when Private Line connections exist on the DS1 port being modified.

Example
    VCLI>>change phys ds1 -sname tulsa1 -card 3 -ds3 1 -ds1 8 -as up -name DS1_3_8

change physicalport ds3

Purpose

Change the attributes of a DS3 port.

Attributes

Admin Status (3 values: up, down, test)

Line Type (2 values: M23, C-bit Parity)

FEAC Send Code (3 values: None, Line Loop Request, Payload Loop Request)

Loopback Control (3 values: none, in, out)

AIS to Yellow (2 values: no, yes)

Line Length (2 values: short, long)

Optional Managed M1:3 Multiplexor IP address (in decimal dot notation)

Identifier String

16 TCA Thresholds (integer)

Options

-sname SwitchName Name of switch containing the DS3

-card CardNum Number of the card (2 to 16) containing the DS3

-ds3 DS3Num Number of the DS3 port

-as up | down | test Admin Status of DS3 Port

-lt m23 | cbit DS3 Line Type

-sc none | lineloop

| payloop DS3 Send Code

-name DS3Name DS3 Physical line Description or Identifier String

-loop none | out | in DS3 Near End loopback control

-aistoy no | yes DS3 AIS to Yellow, Send Yellow signal on Rxed AIS

-ll short | long DS3 Line Length

-cfgs 1 DS3 Port Configuration save to non volatile memory, any integer saves

-tpes15 Value P-bit Errored Seconds 15 minute TCA threshold setting value

-tpes24 Value P-bit Errored Seconds 24 hour TCA threshold setting value

-tpses15 Value P-bit Severely Errored Seconds 15 minute TCA threshold setting value

-tpses24 Value P-bit Severely Errored Seconds 24 hour TCA threshold setting value

-tpcv15 Value P-bit Coding Violations 15 minute TCA threshold setting value

-tpcv24 Value P-bit Coding Violations 24 hour TCA threshold setting value

-tsefs15 Value Severely Errored Framing Seconds 15 minute TCA threshold setting value

-tsefs24 Value Severely Errored Framing Seconds 24 hour TCA threshold setting value

-tles15 Value Line Errored Seconds 15 minute TCA threshold setting value

-tles24 Value Line Errored Seconds 24 hour TCA threshold setting value

-tlses15 Value Line Severely Errored Seconds 15 minute TCA threshold setting value

-tlses24 Value Line Severely Errored Seconds 24 hour TCA threshold setting value

-tlcv15 Value Line Coding Violations 15 minute TCA threshold setting value

-tlcv24 Value Line Coding Violations 24 hour TCA threshold setting value

-tuas15 Value Unavailable Seconds 15 minute TCA threshold setting value

-tuas24 Value Unavailable Seconds 24 hour TCA threshold setting value

-taiss15 Value Alarm Indication Signal Seconds 15 minute TCA threshold setting value

-taiss24 Value Alarm Indication Signal Seconds 24 hour TCA threshold setting value

-tces15 Value C-bit Errored Seconds 15 minute TCA threshold setting value

-tces24 Value C-bit Errored Seconds 24 hour TCA threshold setting value

-tcses15 Value C-bit Severely Errored Seconds 15 minute TCA threshold setting value

-tcses24 Value C-bit Severely Errored Seconds 24 hour TCA threshold setting value

-tccv15 Value C-bit Coding Violations 15 minute TCA threshold setting value

-tccv24 Value C-bit Coding Violations 24 hour TCA threshold setting value

-tfeces15 Value Far End C-bit Errored Seconds 15 minute TCA threshold setting value

-tfeces24 Value Far End C-bit Errored Seconds 24 hour TCA threshold setting value

-tfecses15 Value Far End C-bit Severely Errored Seconds 15 minute TCA threshold setting value

-tfecses24 Value Far End C-bit Severely Errored Seconds 24 hour TCA threshold setting value

-tfeccv15 Value Far End C-bit Coding Violations 15 minute TCA threshold setting value

-tfeccv24 Value Far End C-bit Coding Violations 24 hour TCA threshold setting value

-tfeuas15 Value Far End Unavailable Seconds 15 minute TCA threshold setting value

-tfeuas24 Value Far End Unavailable Seconds 24 hour TCA threshold setting value

Example
    VCLI>>change phys ds3 -sname tulsa1 -card 3 -ds3 1 -as up -ll short -name Card_3_DS3_1

change physicalport oc3

Purpose

Change the attributes of an OC3 port. Some attributes can only be set on OC3 port 1 and 3, but will also be reflected on OC3c ports 2 and 4. Because ports 1 and 2 are an APS pair as well as ports 3 and 4, setting configurable items on ports 1 and 3 are set on ports 2 and 4 automatically.

Attributes

Admin Status (3 values: up, down, test) — applies to all ports independently

Transmit Clock Source (2 values: local, loop)— applies to port3 1 and 3 only

Cell Payload Scrambling (2 values: enabled, disabled)— applies to port3 1 and 3 only

Loopback Control (3 values: none, in, out)—applies to port 1 and 2 independently

AIS to yellow (2 values: no and yes)

Identifier String—applies to port 1 and 2 independently

22 TCA Thresholds (integer)

Options

-sname SwitchName Name of switch containing the OC3

-card CardNum Number of the card (2 to 16) containing the OC3

-oc3 OC3Num Number of the OC3 port

-as up | down | test Admin Status of OC3 Port (1-4)

-tclk loop | local OC3 Transmit Clock source

-scram disable | enable Cell payload scrambling

-loop none | in | out OC3 loopback control

-name OC3Name OC3 Physical line Description or Identifier String

-aistoy no | yes OC3 AIS to yellow, sends yellow signal on Rxed AIS

-cfgs 1 OC3 Port Configuration save to non volatile memory, any integer saves.

-accesspath (1-3) Identify the Path layer on the access side. Needed only for CS3 blade types with 4 OC3 ports on the I/O card.

-tses15 Value Section Errored Seconds 15 minute threshold

-tses24 Value Section Errored Seconds 24 hour threshold

-tsses15 Value Section Severely Errored Seconds 15 minute threshold

-tsses24 Value Section Severely Errored Seconds 24 hour threshold

-tssefs15 Value Section Severely Errored Framing Seconds 15 minute threshold

-tssefs24 Value Section Severely Errored Framing Seconds 24 hour threshold

-tscv15 Value Section Coding Violations 15 minute threshold

-tscv24 Value Section Coding Violations 24 hour threshold

-tles15 Value Line Errored Seconds 15 minute threshold

-tles24 Value Line Errored Seconds 24 hour threshold

-tlses15 Value Line Severely Errored Seconds 15 minute threshold

-tlses24 Value Line Severely Errored Seconds 24 hour threshold

-tlcv15 Value Line Coding Violations 15 minutethreshold

-tlcv24 Value Line Coding Violations 24 hour threshold

-tluas15 Value Line Unavailable Seconds 15 minute threshold

-tluas24 Value Line Unavailable Seconds 24 hour threshold

-tlais15 Value Line Alarm Indication Signal Seconds 15 minutethreshold

-tlais24 Value Line Alarm Indication Signal Seconds 24 hour threshold

-tfeles15 Value Far End Line Errored Seconds 15 minute threshold

-tfeles24 Value Far End Line Errored Seconds 24 hour threshold

-tfelses15 Value Far End Line Severely Errored Seconds 15 minute threshold

-tfelses24 Value Far End Line Severely Errored Seconds 24 hour threshold

-tfelcv15 Value Far End Line Coding Violations 15 minute threshold

-tfelcv24 Value Far End Line Coding Violations 24 hour threshold

-tfeluas15 Value Far End Line Unavailable Seconds 15 minute threshold

-tfeluas24 Value Far End Line Unavailable Seconds 24 hour threshold

-tpes15 Value Path Errored Seconds 15 minute threshold

-tpes24 Value Path Errored Seconds 24 hourthreshold

-tpses15 Value Path Severely Errored Seconds 15 minute threshold

-tpses24 Value Path Severely Errored Seconds 24 hour threshold

-tpcv15 Value Path Coding Violations 15 minute threshold

-tpcv24 Value Path Coding Violations 24 hour threshold

-tpuas15 Value Path Unavailable Seconds 15 minute threshold

-tpuas24 Value Path Unavailable Seconds 24 hour threshold

-tpais15 Value Path Alarm Indication Signal Seconds 15 minute threshold

-tpais24 Value Path Alarm Indication Signal Seconds 24 hour threshold

-tfepes15 Value Far End Path Errored Seconds 15 minute threshold

-tfepes24 Value Far End Path Errored Seconds 24 hour threshold

-tfepses15 Value Far End Path Severely Errored Seconds 15 minute threshold

-tfepses24 Value Far End Path Severely Errored Seconds 24 hour threshold

-tfepcv15 Value Far End Path Coding Violations 15 minute threshold

-tfepcv24 Value Far End Path Coding Violations 24 hour threshold

-tfepuas15 Value Far End Path Unavailable Seconds 15 minute threshold

-tfepuas24 Value Far End Path Unavailable Seconds 24 hour threshold

Example
    VCLI>>change phys oc3 -sname tulsa1 -card 3 -oc3 1 -tclk local -name tulsa1_3_OC3_1

change system cescard

Purpose

Change the attributes (within the VCLI system) of a CES Processing Engine card.

Attributes

In-band IP Address— using decimal dot notation (e.g. 209.50.172.45) [optional]

uplink logical port identifier (e.g., switch.100.101.102.103.card.6.pport.4.lport.2) (optional)

Options

-sname SwitchName Name of switch containing the card

-card CardNumber Slot number of card to change

-ipaddr IPAddress New In-band management IP address to change to

-uplinklp logPortId New logical port identifier of connected port to change to

-m131ip IP address of the m13 for ds3 #1

-m132ip IP address of the m13 for ds3 #2

-m133ip IP address of the m13 for ds3 #3

-m131com community string of the m13 for ds3 #1

-m132com community string of the m13 for ds3 #2

-m133com community string of the m13 for ds3 #3

Example
    VCLI>>change sys cescard -sname tulsa1 -card 2 -uplinklp switch.100.101.102.103.card.3.pport.2.lport.9

change system operator

Purpose

Change the attributes for a VCLI operator account.

Attributes

Privilege Level (this can only be changed by an operator with admin privilege)

Options

-name OperatorName Name of operator to change.

-priv PrivilegeLevel New privilege level (Optional)

Example
    VCLI>>change system operator -name jdsmith -priv change

change system switch

Purpose

Change the attributes (within the VCLI system) of an MGX 8240 switch.

Attributes

Switch Name - Used to identify the switch in all commands with the switch name identifier -sname. Can only be alphanumeric and underscore characters; length limit is 64 characters.

Out-of-band IP Address of switch—Using decimal dot notation (e.g., 206.14.150.201) [optional]

Community String for reading and writing to the switch [optional]

Chassis ID number—Factory assigned chassis ID number (on barcode sticker below power input) [optional]

Usage

This command requires "admin" privilege level.

Options

-sname SwitchName Name of the existing switch to be changed (mandatory)

-newname NewSwitchName New name to change the switch to (optional)

-ipaddr IPAddress New out-of-band management IP address (optional)

-community String ASCII string to be used as the SNMP community string in all Set and Get SNMP PDUs sent to the cards in this switch

-chassisid ChassisId Chassis Id number for the switch

-ftppass password For downloading software images; use up to 8 characters

Example
    VCLI>>change system switch -sname tulsa1 -community linear93

delete connection

Purpose

Deletes a connection. This can be either a local (within a single card) Private Line segment (between DS1 interface and the ATM Trunk), or a local Private Line (within the same card) (between two DS1 interfaces). It may also be a remote Private Line (between two DS1 interfaces on different cards), as long as:

Option

-epid EndpointId Endpoint ID of connection to be deleted.

Example
    VCLI>>del connection -sname tulsa1 -card 3 -epid 279

delete system cescard

Purpose

Deletes a CES Processing Engine card (within a switch) from the VCLI system.

Options

-sname SwitchName Name of switch to remove this card from

-card CardNumber Slot number of card to remove

Example
    VCLI>>del sys cescard -sname tulsa1 -card 2

delete system operator

Purpose

Deletes an operator from the VCLI system.

Usage

This command requires "admin" privilege level.

Option

-name OperatorName Name of the operator to delete

Example
    VCLI>>del sys operator -name jdsmith

delete system switch

Purpose

Deletes a switch from the VCLI system.

Usage

This command requires "admin" privilege level.

Option

-sname SwitchName Name of the switch to delete

Example
    VCLI>>del sys switch -sname tulsa1

download

Purpose

Takes the software from the workstation directory pointed to by ImageDir and downloads it to all of the cards specified in the command, if a single card was not identified on the command line with either the '-card' or '-physcard' argIds. If either argId is specified, the software is downloaded to that card only.

The image directory will have two subdirectories: software and firmware. The directory files from the workstation (including subdirectories) will be downloaded to the individual card's directory pointed to by the following:

    swdwnldInActiveSwDirName (for software) swdwnldInActiveDwDirName (for firmware)

If -swcmd is specified, the swdwnld command will be set on the switch after the image is downloaded. See change cescard image section. This is an optional arg ID.

This command will prompt the user to verify the command.

Options

-network 1 All switches in the network

-snamme SwitchName A specific switch

-card CardNumber Number of the logical card; may not be the actual card in some redundancy situations

-physcard CardNumber To the actual card; overrides any redundancy situations

-swcmd Cmd Optional command to force a software switch upon download

-noconfirm 1 Execute this command without prompting user for confirmation

-verbose 1 Provides feedback during the download process

-cardtype cs3|imc Downloads cards of the same card type. Options are imc =1, cs3 = 2.

Example
    VCLI>>download -sname demoroom -physcard6 -swcmmd 3 Are you sure [NO]?
Purpose

Show an operator or list of all operators configured to use the VCLI system. The following information is shown:

Example
    VCLI>>show system operator Operator Name Privilege Level atjones Admin jdsmith Change wallym Show

show alarms detail

Purpose

Shows the details of every currently active alarm in the network, a single switch, or a single card. The details include:

Options

-network Show all alarms in the network

-sname SwitchName Name of switch to display alarms for

-card CardNum Number of the card (2 to 16) to display alarms for

Example
    VCLI>>show alarms detail -sname tulsa1 -card 3 Severity Date Time Description Critical 09/28/98 03:00:57 Receiving AIS Alarm, Failure on DS3/DS1=1/2

show alarms summary

Purpose

Shows which network components have currently active alarms.

For -network, lists all switches that have an alarm.

For -sname, lists all cards that have an alarm.

For -card, show if the card has an alarm or not.

Options

-network Lists all switches that have an alarm

-sname SwitchName Lists all cards that have an alarm

-card CardNumber Show if the card has an alarm or not

Example
    VCLI>>show alarms summary -sname tulsa1 Alarming Switch: tulsa2 Alarming Card(s): 2,4,9

show cescard aps detail

Purpose

Shows all SONET APS information (configuration, status, statistics). The following is shown:

Options

-network Show APS for every card in the network

-sname SwitchName Name of containing switch to show card APS for

-card CardNum Number of the card (2 to 16) to show APS for (optional)

Example
    VCLI>>show cescard aps summary -sname tulsa1 -card 4 AdminSts: Enabled ProtocolState: NoRequest LineInUse: Working SwitchCount: 0 Failures: None Arch: 1+1 RemoteArch: 1+1 DirMode: BiDirectional RemDirMode: BiDirectional RevertiveMode: NonRevertive BERThresh: 1e-4 WTRPeriod: 360 LastCommand: Clear

For those CS3 blade types with an OC3 I/O card, the APS information is displayed for both ATM Trunk OC3 and Channelized Access OC3.

show cescard aps summary

Purpose

Shows the following summary information about the SONET APS status of a card's OC3c trunk port:

Options

-network Show APS for every card in the network

-sname SwitchName Name of containing switch to show card APS for

-card CardNum Number of the card (2 to 16) to show APS for (optional)

Example
    VCLI>>show cescard aps summary -sname tulsa1
Card Side AdminSts Protocol State LineInUse Failures 2 Trunk Enabled Signal Degrade Protection ProtSwitched 3 Trunk Enabled No Request Working 4 Trunk Disabled No Request Working 4 Side Enabled No Request Working

show cescard config

Purpose

Shows the following configuration information about a card:

Options

-network Show all cards in the network

-sname SwitchName Name of switch to display cards for

-card CardNum Number of the card (2 to 16) to display information for

Example
    VCLI>>show cescard config -sname tulsa1 -card 3 Name: tulsa1_card3 Location: tulsa_pop_rack5_chassis2_slot2 Contact: Jose_Montoya_(772)555-1212 Fan Monitoring: Enabled Chassis IP address: 10.100.0.254

show cescard inband config

Purpose

Shows the following in-band management PVC configuration:

Attributes

Loopback Type: None Loopback State: Inactive

Alarm Status = IN-BAND CIRCUIT TIMEOUT

Options

-network Show inband management configuration for every card in the network

-sname SwitchName Name of containing switch to show card inband management for

-card CardNum Number of the card (2 to 16) to show inband management for (optional)

Example
    VCLI>>show cescard inband config -sname tulsa1 -card 3 IP Address: 10.128.14.3 Subnet Mask: 255.192.0.0 Default Gateway Address: 10.128.0.1 VPI: 0 VCI: 4095 SCR: 300 PCR: 300 Force to Ethernet: Disabled

show cescard inband statistics

Purpose

Shows the following statistics/status related to the in-band management ATM PVC:

Options

-network Show inband management statistics for every card in the network

-sname SwitchName Name of containing switch to show card inband management stats for

-card CardNum Number of the card (2 to 16) to show inband management stats for (optional)

Example
    VCLI>>show cescard inband statistics -sname tulsa1 -card 3 xxxCell Transmit Count: 35711256 Cell Receive Count: 35710018 Unassigned Cells: 0 AAL5 Cells Discarded: 0 Queue Overflows: 0 Packets Dscrd Q Overflw: 0 Times Switch toOOB:5 Total Time in Out of Band:Days:H:Min:Sec 000:07:14:27 Packets Received: 14508749 Packets Transmitted: 14508873 Packets Discarded: 0
    Over Last Length: 0 Over Mid Length: 0 PAD Errors: 0 CPI Errors: 0 CRC Errors: 0 Full FIFO: 0 Early Discards: 0 Buffer Pool Empties: 0 Reassembly timeOuts: 0 AAL5 Aborts: 0 Encapsulation Fails: 0

show cescard info

Purpose

The following information about the card is displayed:

Options

-network Show all cards in the network

-sname SwitchName Name of switch to display cards for

-card CardNum Number of the card (2 to 16) to display information for

Example
    VCLI>>show cescard info -sname tulsa1 -card 3 Software Version: Cisco, MGX 8420, Release 1.0.0.1 Current Date/Time: 10/12/98 15:33:07 GMT Part Number: 205a000102revb Serial Number: 0001a00134 CLEI Code: BATHFHZ0DAA Date of Manufacture: 10/03/98 Card Type: CES I/O Card Type: 3 3DS3s, 2 OC3s

show cescard redundancy

Purpose

Show the redundancy configuration and status for the card, i.e. whether the card is a primary, backup, or neither. For any type of card, the following is shown:

If the Redundancy Role is not "None", the following is also shown:

For a card with a Redundancy State of "Switched-in", the following is shown:

Options

-network Show all cards in the network

-sname SwitchName Name of switch to display cards for

-card CardNum Number of the card (2 to 16) to display information for

Example

Command example for a non-redundant card:

    VCLI>>show cescard redundancy -sname tulsa1 -card 6 Redundancy Role: None Redundancy State: Non-redundant

Command example for a switched-out primary card:

    VCLI>>show cescard redundancy -sname tulsa1 -card 4 Redundancy Role: Primary Redundancy State: Switched-out/Self-failure Backup Card Number: 2

Command example for a switched-in backup card:

    VCLI>>show cescard redundancy -sname tulsa1 -card 2 Redundancy Role: Backup Redundancy State: Switched-in Backup Card Number:2 Switched-in For Card:4 Reason: 100 Info String: Force switch over

show cescard refclock config

Purpose

Show how the reference clock control attributes for a CES Processing Engine card are currently configured:

Options

-network Show refclock conig for every cescard in the network

-sname SwitchName Name of switch to show refclock config for

-card CardNum Number of the card (2 to 16) to show refclock config for

Example
    VCLI>>show cescard refclock config -sname tulsa1 -card 3 PriRef: BITS-A SecRef: OC3-1 RevSwitch: Enabled ForceFreeRun: Off

For CS3 card types and for I/O cards with 4OC3 ports, there are two APS sides. Card 4 in the previous example is such a card. When the 'show cescard aps summary' command is entered, the card's componentType attribute described above must be queried to determine if APS on the access side is available. If it is, this command must make two reads of the APS table.

show cescard refclock status

Purpose

The following card reference clock summary information is displayed:

Options

-network Show refclock status for every cescard in the network

-sname SwitchName Name of switch to show refclock status for

-card CardNum Number of the card (2 to 16) to show refclock status for

Example
    VCLI>>show cescard refclock status -sname tulsa1 -card 3 CurrRefClk: BITS-A BITS-A-Sts: Good BITS-B-Sts: LOS OC3-1-Sts: Good OC3-2-Sts: LOS

show cescard summary

Purpose

Shows the following summary information about a card:

Options

-network Show all cards in the network

-sname SwitchName Name of switch to display cards for

-card CardNum Number of the card (2 to 16) to display information for

Example
    VCLI>>show cescard summary -sname tulsa1 -card 3 In-band Reachability: Down Out-of-band Reachability: Up Redundancy Role: None Redundancy State: Non-redundant Up Time: 45 days, 17:45:09 hours Alarms: None

show connection (all | segpl | pl) bertconfig

Purpose

Shows the following Bit Error Rate Testing configuration for the circuit:

Options

-network Show every DS1 port in the network

-sname SwitchName Name of switch containing the DS1

-card CardNum Number of the card (2 to 16) containing the circuit(s)

-epid EndPointId Requests display of a specific circuit within a card

Example
    VCLI show connection segpl bertconfig -sname tulsa1 -card 3 -epid 279 DS3: 1 DS1: 12 EPID: 279 TestingState: Stopped ErrorInsert: None Pattern: QRSS UserPattern: 0xAA55AA55 UserPatternLen: 32 TxPatternInvert: Off RxPatternInvert: Off Direction: ATM

show connection (all | segpl | pl) bertstatus

Purpose

Shows the status of either a currently running circuit BER test, or the results from the last run circuit BER test. Status and statistics shown are:

Options

-network Show every DS1 port in the network

-sname SwitchName Name of switch containing the DS1

-card CardNum Number of the card (2 to 16) containing the DS1

-epid EndpointId Requests display of a specific circuit within a card

Example
    VCLI>>show connection segpl bertstatus -sname tulsa1 -card 3 -epid 279 DS3: 1 DS1: 12 EPID: 279 TestingState: Stopped ElapsedTime: 01:34:58 BER: 1.23e-10 PatternSync: InSync RxedPattern: 0xAA55AA55 BitErrors: 3 ErrorFreeSecs: 01:34:57 ErroredSecs: 00:00:01 SevErroredSecs: 00:00:00 PercentErrorFreeSecs: 99.2% PatternLossSecs: 00:00:00

show connection (segpl | pl | all) config

Purpose

Shows the following information:

Options

-network Show every connection in the network

-sname SwitchName Name of switch containing the connection(s)

-card CardNum Number of the card (2 to 16) containing the connection(s)

-ds3 DS3Num Number of the DS3 port containing the connection(s)

-ds1 DS1Num Number of the DS1 port containing the connection(s)

-epid EndpointId Requests display of a specific connection within a particular card

Example
    VCLI>>show conn all config -sname tulsa1 -card 3 -ds3 3 DS3: 3 DS1: 1 EPID: 279 ChanMode: Chan CktId: twc-1234567-pl CktNum: 1234567890 CustName: Bobs_nifty_stuff Type: PL-segment AdminSts: Up PartFill: 0 CellRate: 4185 SigMode: Robbed Loopback: None ReassemCDVT (0.1 ms): 30 MaxReassemBufSizFac: 20 CGAMode: Voice-NonTransp OnHookServTC: 0 OffHookServTC: 3 OnHookATMTC: 0 OffHookATMTC: 3 VPI: 0 VCI: 497 Created: 10/21/98 12:34:08 Modified: 10/21/98 12:46:34 Generate LOC Alarm: Enabled TCA Thresholds 15 Min 24 Hour Cells w/Hdr Errors 24 240 Pointer Reframes 4 40 Pointer Parity Errors 12 120 Sequence Errors 24 240 Lost Cells 36 360 Misinserted Cells 12 120 Buffer Underflows 6 60 Buffer Overflows 6 60 Dropped Cells 48 480 DS3: 3 DS1: 2 EPID: 280 ChanMode: Chan CktId: twc-2345678-pl CktNum: 1972476202 CustName: Jimmys_cool_stuff Type: remote-PL AdminSts: Up CellRate: 4107 Loopback: none ReassemCDVT (0.1 ms): 30 MaxReassemBufSizFac: 20 VPI: 0 VCI: 498 Created: 10/21/98 12:57:08 Modified: 10/21/98 12:57:08 EP2Card: 11 EP2EPID: 269 EP2SwName: boston22 Generate LOC Alarm: Enabled TCA Thresholds 15 Min 24 Hour Cells w/Hdr Errors 24 240 Pointer Reframes 4 40 Pointer Parity Errors 12 120 Sequence Errors 24 240 Lost Cells 36 360 Misinserted Cells 12 120 Buffer Underflows 6 60 Buffer Overflows 6 60 Dropped Cells 48 480

show connection (segpl | pl | all) statistics

Purpose

Show the following statistics for a Private Line or Private Line segment:

Options

-network Show every connection in the network

-sname SwitchName Name of switch containing the connection(s)

-card CardNum Number of the card (2 to 16) containing the connection(s)

-ds3 DS3Num Number of the DS3 port containing the connection(s)

-ds1 DS1Num Number of the DS1 port containing the connection(s)

-epid EndpointId Requests display of a specific connection within a particular card.

-15m IntervalNum Requests display of a requested 15 minute interval number. IntervalNum ranges from 0 to 96. 0 indicates current interval, 1 is previous 15 minute interval, 96 is the 96th interval into the past.

-24h IntervalNum Requests display of a requested 24 hour interval number. IntervalNum ranges from 0 to 1. 0 indicates current interval, 1 is previous 24 hour interval. Default: -15m 0

Example
    VCLI>>show conn segpl statistics -sname tulsa1 -card 3 -epid 279 DS3: 1 DS1: 12 EPID: 279 CktId: twc-1234567-pl Current 15 Minute Interval Elapsed Time (min:sec) 10:09 Cells Reassembled 0 Cells w/Hdr Errors 0 Pointer Reframes 0 Pointer Parity Errors 0 Sequence Errors 0 Lost Cells 0 Misinserted Cells 0 Buffer Underflows 0 Buffer Overflows 0 Dropped Cells 0 Payload Cells Txed 0 Trunk Cond. Cells Txed 0 Suppressed Tx Cells 0

show connection (all | segpl | pl) summary

Purpose

When all is specified, this command lists both local and remote Private Line connections as well as local Private Line segments. The following is shown:

Options

-network Show every connection in the network

-sname SwitchName Name of switch containing the connection(s)

-card CardNum Number of the card (2 to 16) containing the connection(s)

-ds3 DS3Num Number of the DS3 port containing the connection(s)

-ds1 DS1Num Number of the DS1 port containing the connection(s)

-epid EndpointId Requests display of a specific connection within a particular card.

Example
    CVCLI>>show conn all summary -sname tulsa1 -card 3 -ds3 3 -ds1 5 DS3 DS1 EPID CktId Type AdminSts OamLoopSts OperStatus DS3 DS1 EPID CktId Type AdminSts OamLoopSts OperStatus

show delaytest config

Purpose

Show the following config items for max tests (or 1 test). Maximum tests on the system is 30 per blade.

Options

-sname SwitchName Name of switch containing the delay tests.

-card CardNum Number of the card (2 to 16) containing the tests.

-testnum Integer A number from 1-30 that identifies a particular test.

Example
    VCLI>>show delaytest config -sname tulsa1 -card 3 Test EPID Testing Duration Remaining Time Number State (secs) (days:hr:min:sec) 1 0 Disabled 0 000:00:00:00 2 0 Disabled 0 000:00:00:00 3 0 Disabled 0 000:00:00:00 . . 30 0 Disabled 0 000:00:00:00

If the '-testnum' argId is specified, then the configuration of that test only will be displayed. If the '-testnum' is not specified, then the configuration of all 30 tests will be displayed.

show delaytest status

Purpose

Show the following status items for max tests (or 1 test). Maximum tests on the system is 30 per blade.

Options

-sname SwitchName Name of switch containing the delay tests

-card CardNum Number of the card (2 to 16) containing the tests

-testnum Integer Number from 1-30 that identifies a particular test.

Example
    VCLI>>show delaytest status -sname tulsa1 -card 3 Test EPID Testing Duration Elapsed Remain. Min. Max. Avg. Xmitted Expect.Unexp. Num. State (secs) secs time Dly. Dly. Dly. Cells Rcvd. Rcvd. 1 0 Disabled 0 0 0 0 0 0 0 0 0 2 0 Disabled 0 0 0 0 0 0 0 0 0 3 0 Disabled 0 0 0 0 0 0 0 0 . . . 30 0 Disabled 0 0 0 0 0 0 0 0

show environment

Purpose

Shows the environment settings for the session.

Example
    VCLI>>show environment Autosave: Enabled Paging: 24 Timeout: Disabled AscendPro: Enabled SNMPTimeout: 5 AscendProDir: /opt/APS/toolkit/CLI ImageDir:/home/fischer/vcli/image

show imccard config

Purpose

Shows the following configuration information about a card:

Options

-network Show all IMC cards in the network

-sname SwitchName Name of switch to display cards for

Example
    VCLI>>show imccard config -sname tulsa1 Name: tulsa1_imc Location: tulsa_pop_rack5_chassis2_slot2 Contact: Jose_Montoya_(772)555-1212 Switch IP address: 10.100.0.254

show imccard info

Purpose

The following information about the card is displayed:

Options

-network Show all IMC cards in the network

-sname SwitchName Name of switch to display card for

Example
    VCLI>>show imccard info -sname tulsa1 Card Type: IMC Software Version: Cisco, MGX 8240, Release 1.0.0.1 Up Time: 33 days, 17:45.21 hours Alarms: None Part Number: 205a000102revb Serial Number: 0001a00134 CLEI Code: BATFHZ0DZZ Date of Manufacture: 06/03/99 Current Date/Time: 07/12/99 23:33:07 GMT

show imccard redundancy

Purpose

Shows the redundancy configuration and status for each IMC card present. The following is shown for each IMC card present:

Options

-network Show all IMC cards in the network

-sname SwitchName Name of switch to display card for

Example
    VCLI>>show imccard redundancy -sname tulsa1 IMC Card 1A (top) Role: Backup State: Unavailable, Self Failure IMC Card 1B (bottom) Role: Primary State: Active

show logicalport atm config

Purpose

Show the following ATM logical port configuration:

Options

-network Show every ATM BC in the network

-sname SwitchName Name of switch containing the ATM BC

-card CardNum Number of the card (2 to 16) containing the ATM BC

Example
    VCLI>>show log atm config -sname tulsa1 -card 3 AdminSts: Up Name: wc_993_er98

show logicalport atm statistics

Purpose

Show the following ATM logical port statistics:

Options

-network Show every ATM BC in the network

-sname SwitchName Name of switch containing the ATM BC

-card CardNum Number of the card (2 to 16) containing the ATM BC

-15m IntervalNum Requests display of a requested 15 minute interval number. IntervalNum ranges from 0 to 2. 0 indicates current interval, 1 is previous 15 minute interval, 2 is the 2nd interval into the past.

-24h IntervalNum Requests display of a requested 24 hour interval number. IntervalNum ranges from 0 to 1. 0 indicates current 24 hour interval. 1 is previous 24 hour interval. Default: -15m 0

Example
    VCLI>>show log atm statistics -sname tulsa1 -card 3 -15m 0 OC3: 1 Current 15 Minute Interval Elapsed Time (min:sec) 10:09 Valid Cells Ingress 4      Cells w/HEC Errors: 2 Cells Egress        4

show logicalport atm summary

Purpose

Shows a summary of the ATM logical port status, including:

Options

-network Show every ATM BC in the network

-sname SwitchName Name of switch containing the ATM BC

-card CardNum Number of the card (2 to 16) containing the ATM BC

Example
    VCLI>>show log atm summary -sname tulsa1 -card 3 AdminSts ConfigVCCs AvailIBW AvailEBW OperStatus Up 4 340000 340000 PhysDown OutCellD

show physicalport ds0allocation

Purpose

Shows how DS0 timeslots within a DS1 are allocated to CES connections. Connections are identified by their Endpoint ID (EPID).

Options

-network Show every DS1 port in the network

-sname SwitchName Name of switch containing the DS1

-card CardNum Number of the card (2 to 16) containing the DS1

-ds3 DS3Num Number of the DS3 port containing the DS1

-ds1 DS1Num Number of the DS1 port

Example
    VCLI>>show ds0allocation -sname tulsa1 -card 3 -ds3 3 -ds1 1 DS0 Timeslot allocation by Endpoint ID (EPID) on DS3 3, DS1 1 DS0# EPID DS0# EPID DS0# EPID DS0# EPID 1 258 7 0 13 0 19 0 2 259 8 0 14 0 20 0 3 0 9 0 15 0 21 0 4 0 10 0 16 0 22 0 5 0 11 0 17 0 23 0 6 0 12 0 18 0 24 0

show physicalport ds1 bertconfig

Purpose

Shows the following Bit Error Rate Testing configuration information for the DS1 port:

Options

-network Show every DS1 port in the network

-sname SwitchName Name of switch containing the DS1

-card CardNum Number of the card (2 to 16) containing the DS1

-ds3 DS3Num Number of the DS3 port containing the DS1

-ds1 DS1Num Number of the DS1 port

Example
    VCLI>>show phys ds1 bertconfig -sname tulsa1 -card 3 -ds3 1 -ds1 12 DS3: 1 DS1: 12 TestingState: Stopped Framing: ESF ErrorInsert: None Pattern: QRSS UserPattern: 0xAA55AA55 UserPatternLen: 32 TxPatternInvert: Off RxPatternInvert: Off

show physicalport ds1 bertstatus

Purpose

Shows the status of either a currently running BER test, or the results from the last run BER test. Status and statistics shown are

Options

-network Show every DS1 port in the network

-sname SwitchName Name of switch containing the DS1

-card CardNum Number of the card (2 to 16) containing the DS1

-ds3 DS3Num Number of the DS3 port containing the DS1

-ds1 DS1Num Number of the DS1 port

Example
    VCLI>>show phys ds1 bertstatus -sname tulsa1 -card 3 -ds3 1 -ds1 12 DS3: 1 DS1: 12 TestingState: Stopped ElapsedTime: 01:34:58 BER: 1.23e-10 PatternSync: InSync RxedPattern: 0xAA55AA55 BitErrors: 3 ErrorFreeSecs: 01:34:57 ErroredSecs: 00:00:01 SevErroredSecs: 00:00:00 PercentErrorFreeSecs: 99.2% PatternLossSecs: 00:00:00

show physicalport ds1 config

Purpose

Shows the following configuration information for the DS1 port:

Options

-network Show every DS1 port in the network

-sname SwitchName Name of switch containing the DS1

-card CardNum Number of the card (2 to 16) containing the DS1

-ds3 DS3Num Number of the DS3 port containing the DS1

-ds1 DS1Num Number of the DS1 port

Example
    VCLI>>show phys ds1 config -sname tulsa1 -card 3 -ds3 1 -ds1 12 DS3: 1 DS1: 12 Name: WC2344_22s Admin Status: Up Frame: ESF Timing: Internal Channelization: Channelized Line Coding: B8ZS FDL: ANSI Loopback: None Last Send Code: PayloadLoop TCA Thresholds NE 15 Min NE 24 Hour FE 15 Min FE 24 Hour Errored Secs 12 121 12 121 Sev Err Secs 10 100 10 100 Sev ERR Framing Secs 2 17 2 17 Unavailable Secs 10 10 10 10 Path Coding Violations 14 134 14 134 AIS Seconds 2 17 Line Errored Secs 12 21 Controlled Slip Secs 10 100 10 100 Out of Frame Events 72 691

show physicalport ds1 statistics

Purpose

Shows the values of the statistics below. Can optionally request the statistics for the current 15 minute interval, or one of the last 32 15 minute intervals, or the current 24 hour interval. If the current 15 minute interval is requested, the time (in minutes and seconds) within the current 15 minute interval is also displayed.

Options

-network Show every DS1 port in the network.

-sname SwitchName Name of switch containing the DS1.

-card CardNum Number of the card (2 to 16) containing the DS1.

-ds3 DS3Num Number of the DS3 port containing the DS1.

-ds1 DS1Num Number of the DS1 port.

-15m IntervalNum Requests display of a requested 15 minute interval number. IntervalNum ranges from 0 to 32. 0 indicates current interval, 1 is previous 15 minute interval, 32 is the 32nd interval into the past.

-24h Requests display of current 24 hour interval. Default: -15m 0.

Example
    VCLI>>show phys ds1 statistics -sname tulsa1 -card 3 -ds3 1 -ds1 12 -15m 0 DS3: 1 DS1: 12 Near End Far End Current Interval Elapsed Time (min:sec) 10:09 Errored Secs 463 453 Severely Errored Secs 12 45522 Sev Err Framing Secs 123 4 Unavailable Secs 4432234 334455 Path Coding Violations 1234567890 1234567890 AIS Seconds 4444 Controlled Slip Secs 5 7 Line Errored Secs 21 2093 Line Code Violations 29 Out of Frame Events 21

show physicalport ds1 summary

Purpose

Shows a summary of DS3 port(s) status, including:

Options

-network Show every DS1 port in the network

-sname SwitchName Name of switch containing the DS1

-card CardNum Number of the card (2 to 16) containing the DS1

-ds3 DS3Num Number of the DS3 port containing the DS1

-ds1 DS1Num Number of the DS1 port

Example
    VCLI>>show phys ds1 sum -sname tulsa1 -card 3 -ds3 1 DS3 DS1 Frame Timing Chan Coding AdminSts OperStatus 1 1 ESF Int Chan B8ZS Up 1 2 Other Thru Clear AMI Up LOF RcvAIS RcvYellow XmitYellow DS3down 1 2 SF Int Clear B8ZS Down AdminDown ...

show physicalport ds3 config

Purpose

Shows the following configuration information for the DS3 port:

Options

-network Show every DS3 port in the network

-sname SwitchName Name of switch containing the DS3

-card CardNum Number of the card (2 to 16) containing the DS3

-ds3 DS3Num Number of the DS3 port

Example
    VCLI>>show phys ds3 config -sname tulsa1 -card 3 -ds3 1 DS3: 1 Name: WC2344_22s Admin Status: Up Line Type: C-bit Line Length: Short Loopback: None Last Send Code: PayloadLoop AIS to Yellow: Enabled TCA Thresholds NE 15 Min NE 24 Hour FE 15 Min FE 24 Hour Line Errored Secs 86 864 Line Sev Errored Secs 4 40 Line Coding Violations 387 3865 Sev Err Framing Secs 2 8 P-Bit Errored Secs 86 864 P-Bit Sev Errored Secs 4 40 P-Bit Coding Violations 382 3820 C-Bit Errored Secs 86 864 86 864 C-Bit Sev Errored Secs 4 40 4 40 C-Bit Coding Violations 387 3820 387 3820 Unavailable Secs 10 10 10 10 AIS Secs 2 8

show physicalport ds3 statistics

Purpose

Shows the values of the statistics below. Can optionally request the statistics for the current 15 minute interval, or one of the previous 32 15 minute intervals, or the current 24 hour interval.

Options

-network Show every DS3 port in the network

-sname SwitchName Name of switch containing the DS3

-card CardNum Number of the card (2 to 16) containing the DS3

-ds3 DS3Num Number of the DS3 port

-15m IntervalNum Requests display of a requested 15 minute interval number. IntervalNum ranges from 0 to 32. 0 indicates current interval, 1 is previous 15 minute interval, 32 is the 32nd interval into the past.

-24h Requests display of current 24 hour interval. Default: -15m 0

Example
    VCLI>>show phys ds3 statistics -sname tulsa1 -card 3 -ds3 2 DS3: 2 Current Interval Elapsed Time (min:sec) 10:09 Near End Far End P-bit Errored Secs 0 P-bit Severely Errored Secs 0 P-bit Coding Violations 0 Severely Errored Framing Secs 0 Line Errored Secs 0 Line Severely Errored Secs 0 Line Coding Violations 0 AIS Seconds 0 Unavailable Secs 0 0 C-bit Errored Secs 0 0 C-bit Severely Errored Secs 0 0 C-bit Coding Violations 0 0

show physicalport ds3 summary

Purpose

Shows a summary of DS3 port(s) status, such as:

Options

-network Show every DS3 port in the network

-sname SwitchName Name of switch containing the DS3

-card CardNum Number of the card (2 to 16) containing the DS3

-ds3 DS3Num Number of the DS3 port

Example
    VCLI>>show phys ds3 sum -sname tulsa1 -card 3 DS3 LineType AdminSts OperStatus 1 M23 Up Up 2 C-Bit Up LOS LOF RcvAIS RcvYellow XmitYellow InLoop 3 C-Bit Down AdminDown

show physicalport oc3 config

Purpose

Shows the following configuration information for the OC3 port:

Admin Status (3 values: up, down, test)—applies to ports 1, 2, 3, and 4 independently

Transmit Clock Source (2 values: local, loop)—applies to both port pairs 1 and 2, and 3 and 4 simultaneously

Cell Payload Scrambling (2 values: enabled, disabled)—applies to both port pairs 1 and 2, and 3 and 4 simultaneously

Loopback Control (3 values: none, out, in)—applies to ports 1, 2, 3, and 4 independently

Identifier String—applies to ports 1, 2, 3, and 4 independently

22 TCA Thresholds (integer)

Options

-network Show every OC3 port in the network

-sname SwitchName Name of switch containing the OC3

-card CardNum Number of the card (2 to 16) containing the OC3

-oc3 OC3Num Number of the OC3 port (1-4)

Example
    VCLI>>show phys oc3 config -sname tulsa1 -card 3 -oc3 1 OC3: 1 Name: WC2984_01t Admin Status: Up Oper Status: Up Transmit Clock Source: Loop Loopback: None Cell Payload Scrambling: Enabled TCA Thresholds NE 15 Min NE 24 Hour FE 15 Min FE 24 Hour Section Errored Secs 86 864 Section Sev Errored Secs 4 40 Section Sev Err Framing Secs 2 8 Section Coding Violations 387 3865 Line Errored Seconds86 864 86 864 Line Sev Errored Secs 4 40 4 40 Line Coding Violations 387 3865 387 3865 Line Unavailable Secs 10 10 10 10 Line AIS Secs 2 8 Trunk Path #1 Path Errored Secs 86 864 86 864 Path Sev Errored Secs 4 40 4 40 Path Coding Violations 387 3865 387 3865 Path Unavailable Secs 10 10 10 10 Path AIS Secs 2 10

show physicalport oc3 statistics

Purpose

Shows the values of the statistics below. Can optionally request the statistics for the current 15 minute interval, or one of the previous 32 15 minute intervals, or the current 24 hour interval, or the previous 24 hour interval.

Options

-network Show every OC3 port in the network

-sname SwitchName Name of switch containing the OC3

-card CardNum Number of the card (2 to 16) containing the OC3

-oc3 OC3Num Number of the OC3 port (1-4)

-15m IntervalNum Requests display of a requested 15 minute interval number. IntervalNum ranges from 0 to 32. 0 indicates current interval, 1 is previous 15 minute interval, 32 is the 32nd interval into the past.

-24h IntervalNum Requests display of a requested 24 hour interval number. IntervalNum ranges from 0 to 1. 0 indicates the current 24 hour interval. 1 indicates the previous 24 hour interval.
Default: -15m 0

Example
    VCLI>>show phys oc3 statistics -sname tulsa1 -card 3 -oc3 1 -15m 0 Switch Name: tulsa1, Card: 3 OC3: 1 Current Interval Elapsed Time (min:sec) 14:05 Near End Far End Section Errored Secs 0 Section Severely Errored Secs 0 Section Sev Err Framing Secs 0 Section Coding Violations 0 Line Errored Seconds 0 0 Line Severely Errored Secs 0 0 Line Coding Violations 0 0 Line Unavailable Secs 0 0 Line AIS Secs 0 Trunk Path #1 Path Errored Secs 0 0 Path Severely Errored Secs 0 0 Path Coding Violations 0 0 Path Unavailable Secs 0 0 Path AIS Secs 0

show physicalport oc3 summary

Purpose

Shows a summary of OC3c port(s) status, such as:

Options

-network Show every OC3 port in the network

-sname SwitchName Name of switch containing the OC3 port

-card CardNum Number of the card (2 to 16) containing the OC3 port

-oc3 OC3Num Number of the OC3 port (1-4)

Example
    VCLI>>show phys oc3 sum -sname tulsa1 -card 3 OC3 Side TxClk CellScrm AdminSts OperStatus 1 Trunk Loop Enabled Up SctnLOS SctnLOF LineAIS PathLOP PathAIS 2 Trunk Local Disabled Test InLoop LineRDI PathRDI LabelMis 3 Access Local NA Up No Alarm 4 Access Local NA Down No Alarm Access Side SonetPath SonetPath # Operational State PathLOP, PathAIS No Alarm PathLOP, PathAIS

show switch redundancy

Purpose

Shows all redundancy groups within a switch, the redundancy role and status of each card.

The following abbreviations are used for the redundancy role:

P = Primary

B = Backup

N = None (neither primary nor backup)

UNK = Unknown

- = No card

The following abbreviations are used for the redundancy state:

NR = non-redundant

SB = Standby

F = failed

SI = Switched-in

SO = Switched-out

SIP = Switch-in In Progress

FBP = Force Back InProgress

UNP = Unprotected

PRO = Protected

UNK = unknown

Options

-network Show all switches in the network

-sname SwitchName Name of switch to display redundancy information for

Example
    VCLI>>show switch redundancy -sname tulsa1 Phys Slot 1A 1B 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 Group 1 1 2 2 2 2 2 7 7 0 7 7 0 UNK - - - Role P B B P P P P B P N P P N UNK - - - State PRO SB SB PRO PRO PRO PRO SI PRO NR SO PRO NR UNK - - - Log Slot 1 1 2 3 4 5 6 10 8 9 10 11 12 UNK - - -

show system cescard

Purpose

Show the configuration information within the VCLI system for a card or list of cards. The following information is shown:

Options

-network Show all CES cards in the network

-sname SwitchName Name of the switch containing the card(s) to show

-card CardNumber Slot number of the card to show

Example
    VCLI>>show system cescard -sname tulsa3 Card: 2 In-band IP Addr: 192.63.145.22 Ascend Uplink Lport: switch.100.101.102.103.card.8.pport.1.lport.1 Card: 3 In-band IP Addr: 192.63.145.23 Ascend Uplink Lport: switch.100.101.102.103.card.8.pport.2.lport.2 DS3-1 MI3 IP Addr:

show system status

Purpose

Show the status of the in-band and out-of-band interfaces that the VCLI string is using. The following information is shown:

Options

-network Show all CES cards in the network

-sname SwitchName Name of the switch containing the card(s) to show

Example
    VCLI>>show system status -sname tulsa3 Phys Slot 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 In-Band NA U U D U U NA U U U D U U U U U Out-of-Band U U U D U U NA U U U U U U U U U Current Xface O I I NA I I NA I I I I I I I I I

This command will show the status of the in-band and out-of-band interfaces as the VCLI currently knows them. It does not talk to the switch to ascertain this information; the information is from the internal database of the VCLI.

If a card is not in the switch database, the status and the current xface lines show NA. If the VCLI knows an interface to be up, a U is displayed. If the VCLI knows an interface to be down, a D is displayed. The current xface line shows the interface that the VCLI is currently using to communication with the card: I for In-band, O for out-of-band.

show system switch

Purpose

Show the configuration information within the VCLI system for a switch or list of all switches. The following information is shown:

Options

-network Show all switches in the network

-sname SwitchName Name of the switch to show

Example
    VCLI>>show system switch -sname tulsa1 Switch Name: tulsa1 Out-of-band IP Address: 206.14.150.201 Community String: borg19e Configured Cards: 2,3,4,5,6,7,8,9,10,11,12,13,14,15

show version

Purpose

Shows the version of the VCLI application.

Example
    VCLI>>show version VCLI version: 2.2.9


hometocprevnextglossaryfeedbacksearchhelp
Posted: Sun Sep 29 05:16:59 PDT 2002
All contents are Copyright © 1992--2002 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.