Comandos Malc-830-00506-23
Comandos Malc-830-00506-23
Comandos Malc-830-00506-23
Zhone Technologies
@Zhone Way
7001 Oakport Street
Oakland, CA 94621
USA
510.777.7000
www.zhone.com
info@zhone.com
COPYRIGHT 2000-2007 Zhone Technologies, Inc. All rights reserved.
This publication is protected by copyright law. No part of this publication may be copied,
distributed, displayed, modified, transmitted, stored in a retrieval system, or translated without
express written permission from Zhone Technologies, Inc.
Acculink, ADSL/R, Bitstorm, Comsphere, DSL the Easy Way, Etherloop, FrameSaver,
GigMux, GranDSLAM, GrandVIEW, Hotwire, the Hotwire logo, iMarc, JetFusion, Jetstream,
JetVision, MALC, NextEDGE, Net to Net Technologies, Paradyne, the Paradyne logo, Quick
Channel, Raptor, ReachDSL, SLMS, StormPort, TruePut, Z-Edge, Zhone, ZMS, and the Zhone
logo are trademarks owned by Zhone Technologies, Inc., which may be registered in some
jurisdictions.
Zhone Technologies makes no representation or warranties with respect to the contents hereof
and specifically disclaims any implied warranties of merchantability, noninfringement, or
fitness for a particular purpose. Further, Zhone Technologies reserves the right to revise this
publication and to make changes from time to time in the contents hereof without obligation of
Zhone Technologies to notify any person of such revision or changes.
CONTENTS
About This Guide ...............................................................................................................................7
Style and notation conventions..............................................................................7
Typographical conventions.......................................................................................7
Acronyms......................................................................................................................8
Related documents ....................................................................................................9
Contacting Global Service and Support...............................................................9
Technical support......................................................................................................9
Service requirements...............................................................................................10
Chapter 1
Contents
Chapter 2
Commands ...............................................................................................................27
A ....................................................................................................................................27
B ....................................................................................................................................32
C ....................................................................................................................................48
D ....................................................................................................................................65
E ....................................................................................................................................79
F.....................................................................................................................................82
G ....................................................................................................................................96
H ..................................................................................................................................100
I ....................................................................................................................................105
L...................................................................................................................................123
M..................................................................................................................................133
N ..................................................................................................................................136
P ..................................................................................................................................137
R ..................................................................................................................................140
S ..................................................................................................................................150
T...................................................................................................................................190
U ..................................................................................................................................193
V ..................................................................................................................................198
W .................................................................................................................................215
Z...................................................................................................................................215
Parameters .............................................................................................................225
ADSL ..........................................................................................................................225
ATM ............................................................................................................................237
Bridging.....................................................................................................................255
Card ............................................................................................................................259
Channel Emulation Service (CES) .....................................................................267
Clocking ....................................................................................................................269
DHCP..........................................................................................................................272
DNS.............................................................................................................................285
DS1 .............................................................................................................................287
DS3 .............................................................................................................................295
DSL .............................................................................................................................301
ELCP .........................................................................................................................307
Ethernet.....................................................................................................................310
FXS/FXO ....................................................................................................................315
GR303 ........................................................................................................................321
IfIndex ........................................................................................................................327
IMA..............................................................................................................................330
IP .................................................................................................................................335
ISDN............................................................................................................................343
MTAC/Ring................................................................................................................345
Network Time Protocol..........................................................................................346
PON ............................................................................................................................349
PPPoA........................................................................................................................350
RIP ..............................................................................................................................363
RS232.........................................................................................................................367
SHDSL........................................................................................................................370
Sechtor 100A environmental ...............................................................................375
SNMP..........................................................................................................................376
SONET .......................................................................................................................378
Subscriber ................................................................................................................384
System.......................................................................................................................386
V5.2.............................................................................................................................389
VDSL ..........................................................................................................................402
Voice .........................................................................................................................403
User ............................................................................................................................412
VOIP............................................................................................................................414
ZMS.............................................................................................................................422
Index ....................................................................................................................................................425
Contents
Typographical conventions
The following typographical styles are used in this guide to represent specific
types of information.
Bold
Fixed
Fixed Bold
Fixed Bold
Italic
Italic
Used for book titles, chapter titles, file path names, notes in
body text requiring special attention, section titles,
emphasized terms, and variables.
PLAIN UPPER
CASE
Command Syntax
Acronyms
The following acronyms appear throughout this manual:
Table 1: Acronyms and their descriptions
Acronym
Description
ARP
ATM
BAN
DSL
GSS
HDSL2
IAD
MALC
MIB
PBX
RIP
SDSL
SLMS
Related documents
Description
SNMP
TFTP
VCI
VCL
VPI
ZMS
Related documents
Refer to the documentation that came with your Zhone device for information
about configuring the device.
System configuration
Technical support
If you require assistance with the installation or operation of your product, or
if you want to return a product for repair under warranty, contact GSS. The
contact information is as follows:
E-mail
support@zhone.com
877-ZHONE20
Telephone (International)
510-777-7133
Internet
www.zhone.com/support
Service requirements
If the product malfunctions, all repairs must be performed by the
manufacturer or a Zhone-authorized agent. It is the responsibility of users
requiring service to report the need for service to GSS.
10
Terminology, page 11
ifTypes, page 21
Terminology
The following terms are used throughout this document:
Term
Description
Access levels
Address
CLI
11
Term
Description
Command
Parameter
Profile
Profile index
Record
Subscriber
User
Logging in
You can access the CLI through a local serial craft connection or through a
telnet session.
To access the serial port, configure your terminal interface software with the
following settings:
9600bps
8 data bits
No parity
1 stop bit
No flow control
Connect a serial crossover cable to the DE-9 port on the unit labeled Serial
Craft. At the prompt, enter default username (admin) and password (zhone):
login:admin
password: *****
zSH>
12
Profile indexes
Profile indexes
This section describes profile indexes.
Virtual
All non-physical (virtual) if-translate records have their shelf, slot, port,
subport fields set to zero. These interfaces are accessible by name only.
Physical interfaces have both names and shelf-slot-port-subport values.
Examples of a physical interface types include hdsl2, adsl, sonet, atmima,
and ethernetcsmacd. Examples of virtual interfaces types include atm, aal5,
rfc1483 and ip.
Physical interfaces
For physical interfaces the name is a dash (-) separated string of shelf, slot,
port, subport (shelf-slot-port-subport). For example: 1-2-1-0.
Virtual interfaces
For virtual interfaces, the profile address is the same with the addition of the
name of the physical interface type on the end (shelf-slot-port-subport/
physicaltype).
For example, for a virtual interface stacked on an hdsl2 interface, the index
would be 1-2-1-0-hdsl2.
Basic commands
The CLI contains profiles, which are templates for configuring the system;
records, which are specific instances of profiles; and commands, which
manipulate records or perform system functions (such as displaying line
status).
The following table describes the most important CLI commands.
13
Command
Description
delete
Deletes a record.
Syntax:
delete profile-type [ index | * ]
where profile-type is the type of profile and * is a
wildcard character.
get
help
list
new
14
Viewing profiles
Command
Description
show
update
Viewing profiles
To view the profiles on the system, use the list command. After each profile is
the format of the address or profile index for the profile. For example, the
card-profile requires a shelf/slot/port address:
card-profile: shelf/slot/type/
Where shelf and slot are the physical location of the device and type is the
type of the card.
Note: The profiles on your system may vary, depending on the
configuration of your unit.
For example:
zSH> list
aal2-audio-profile: audioProfileIdentifier/apIndex
aal2-cid-profile: ifIndex/vpi/vci/cid
aal2-vcl-profile: ifIndex/vpi/vci
adsl-co-profile: shelf/slot/port
adsl-cpe-profile: shelf/slot/port
adsl-profile: shelf/slot/port
atm-cc: atmVcCrossConnectIndex
atm-if: ifIndex
atm-if-stats: ifIndex
atm-traf-descr: index
atm-traf-descr-idx-next: index
atm-traf-descr-stats: index
atm-vcl: ifIndex/vpi/vci
atm-vcl-param: index
atm-vcl-stats: ifIndex/vpi/vci
atm-vpi: ifIndex/vpi
atm-vpl: ifIndex/vpi
bulk-statistic: index
15
Viewing records
To view the configured records of a particular type, enter list command then
the name of the profile. For example:
zSH> list atm-vcl
atm-vcl 1-6-1-0-sonet/atm/0/35
atm-vcl 1-6-1-0-sonet/atm/0/36
atm-vcl 1-6-1-0-sonet/atm/0/37
atm-vcl 1-6-2-0-sonet/atm/0/35
atm-vcl 1-6-2-0-sonet/atm/0/36
atm-vcl 1-6-2-0-sonet/atm/0/37
To view all configured records on the system, use the list command with the
wildcard character (*):
zSH> list *
aal2-audio-profile 7/1
aal2-audio-profile 7/2
aal2-audio-profile 7/3
aal2-audio-profile 8/1
aal2-audio-profile 8/2
aal2-audio-profile 9/1
aal2-audio-profile 10/1
aal2-audio-profile 10/2
aal2-audio-profile 11/1
aal2-audio-profile 11/2
aal2-audio-profile 12/1
aal2-audio-profile 12/2
aal2-audio-profile 12/3
atm-cc 14
atm-cc 5
atm-cc 6
atm-cc 7
atm-cc 8
atm-cc 1
<SPACE> for next page, <CR> for next line, A for all, Q to
quit
Viewing commands
To see a list of all the commands available, along with a short description of
their use, enter the help command without arguments:
zSH>
1
2
3
16
help
help [commands]
adduser
ata - initialize/show ATA flash partitions.
Viewing commands
Finding a command
The find command allows you to search through the available commands.
The command uses the following syntax:
find [-s(ubSearch) | -d(etailed)] stringToSearch
-s
Search the previous search results for the specified string.
-d
Search the online help for each command for the specified string.
17
-ds or -sd
Search the online help of the commands in the previous search for the
specified string.
substring
The string to search for.
For example, the following command finds all commands containing the
string show:
zSH> find show
eeshow
show
showlinestatus
showresolver
showzhonecpe
msgtrafficshow
showdatetime
showlogo
showuser
Modifying records
The new, update, and delete commands are the primary commands to modify
records.
new command
The new command creates new profiles. Some profiles, such as those
associated with physical devices, can only be created if the device is installed
in the system.
The following example creates a new ip-interface-record. Press Enter to
accept the default value:
zSH> new ip-interface-record 1-1-1-0/ip
Please provide the following: [q]uit.
vpi: ---------------> {0}:
vci: ---------------> {0}:
rdindex: -----------> {1}:
dhcp: --------------> {none}: ** read-only **
addr: --------------> {0.0.0.0}: 192.168.8.21
netmask: -----------> {0.0.0.0}: 255.255.255.0
bcastaddr: ---------> {0.0.0.0}: 192.168.8.255
destaddr: ----------> {0.0.0.0}:
farendaddr: --------> {0.0.0.0}:
mru: ---------------> {1500}:
reasmmaxsize: ------> {0}:
ingressfiltername: -> {}:
egressfiltername: --> {}:
pointtopoint: ------> {no}:
mcastenabled: ------> {yes}:
ipfwdenabled: ------> {yes}:
mcastfwdenabled: ---> {yes}:
natenabled: --------> {no}:
bcastenabled: ------> {yes}:
ingressfilterid: ---> {0}:
18
Modifying records
After entering the values the system displays the values youve entered and
prompts you to save the record. If you want to save the changes, press s. If
you want to make changes, press c to re-enter values. Press q at any time to
quit without saving changes.
Note: The CLI accepts abbreviated or complete input to modify
records: You can enter s or save to save changes, enter c or change to
make more changes, enter q or quit to stop without saving changes.
19
To use view the valid enumerated values while updating the record, enter a
question mark (?) when prompted for a value:
zSH> update ip-interface-record 1-2-1-0/ip
Please provide the following: [q]uit.
vpi: ---------------> {0}: ?
Invalid entry: vpi range: [0 to 4095]
vpi: ---------------> {0}:
vci: ---------------> {0}:
rdindex: -----------> {1}:
dhcp: --------------> {none}: ** read-only **
addr: --------------> {192.168.80.190}: ?
Invalid IP address format. Try "n.n.n.n", where n is 0 to
255
addr: --------------> {192.168.80.190}:
netmask: -----------> {255.255.252.0}:
bcastaddr: ---------> {192.168.83.255}:
destaddr: ----------> {0.0.0.0}:
farendaddr: --------> {0.0.0.0}:
mru: ---------------> {1500}:
reasmmaxsize: ------> {0}:
ingressfiltername: -> {}:
egressfiltername: --> {}:
pointtopoint: ------> {no}:
mcastenabled: ------> {yes}:
ipfwdenabled: ------> {yes}:
mcastfwdenabled: ---> {yes}:
natenabled: --------> {no}:
bcastenabled: ------> {yes}:
ingressfilterid: ---> {0}:
egressfilterid: ----> {0}:
ipaddrdynamic: -----> {static}:
dhcpserverenable: --> {false}:
update command
The update command changes an existing record. The command uses the
following syntax:
The following example updates an ip-interface-record:
zSH> update ip-interface-record 1-1-1-0/ip
Please provide the following: [q]uit.
vpi: ---------------> {0}:
vci: ---------------> {0}:
rdindex: -----------> {1}:
dhcp: --------------> {none}: ** read-only **
addr: --------------> {192.168.8.21}: 192.168.8.23
netmask: -----------> {255.255.255.0}:
bcastaddr: ---------> {192.168.8.255}:
destaddr: ----------> {0.0.0.0}:
farendaddr: --------> {0.0.0.0}:
mru: ---------------> {1500}:
reasmmaxsize: ------> {0}:
20
ifTypes
delete command
The delete command deletes an existing record. You can delete a single
record by specifying the address or the index, or multiple records by using a
wildcard (*).
Some records, such a card-profiles, delete all associated records when you
delete them.
ifTypes
Table 2 lists the ifTypes used in Zhone devices.
Tip: When entering an record address, you can specify either the
ifType name or its number.
Table 2: ifTypes
ifType
Number
Description
EthernetCsmacd
Ethernet
ds1
18
DS1 or E1
basicISDN
20
ISDN BRI
primaryISDN
21
ISDN PRI
ppp
23
Point-to-point protocol
DS3
30
DS3
rs232
33
RS-232
atm
37
ATM cells
sonet
39
SONET or SDH
21
Number
Description
V35
45
V.35
AAL5
49
ISDN
63
ISDN or X.25
Async
84
Asynchronous protocols
ADSL
94
radsl
95
voiceEM
100
voiceFXO
101
voiceFXS
102
voiceEncap
103
Voice encapsulation
voiceOverIp
104
atmima
107
IP
126
Internet Protocol
voiceOverATM
152
rfc1483
159
hdsl2
168
shdsl
169
Multirate HDSL2
CLI shortcuts
This section describes the following CLI shortcuts:
Command completion
Command completion provides a shortcut to entering commands and profile
names at the CLI. If you type part of a command or profile name and then
press the TAB key, the CLI will present you with either the remaining portion
of the command/profile name or a list of possible completions.
22
CLI shortcuts
If there is one option to complete the line, the CLI will provide the complete
command or profile name (as in the following command and profile
examples).
zSH> sw <TAB>
zSH> swversion
If there is more than one option to complete the line, the CLI will display a list
of options that could complete command or profile (as in the following
command and profile examples).
zSH> show <TAB>
show
showdatetime
showhost
showinetstat
showipstat
showlinestatus
showmem
showresolver
showuser
showzhonecpe
zSH> show
zSH> list atm <TAB>
atm-if
atm-if-stats
atm-traf-descr
atm-traf-descr-idx-next
atm-traf-descr-stats
atm-vcl
atm-vcl-stats
zSH> list atm-
Command shortcuts
The Zhone CLI supports vi-like commands. This section describes the CLI
command shortcuts.
Description
ESC
ENTER
CTRL + H
23
Description
CTRL + U
CTRL + L
CTRL + S
Suspend output.
CTRL + Q
Resume output.
Description
nG
Go to command n.
/string
?string
nk or n-
nj or n+
nh
nl or SPACE.
nw
nW
ne
nE
Move the cursor to the end of the next nth large word.
(Large words are separated by blanks only.)
nb
nB
24
CLI shortcuts
Description
fc
Fc
Description
Append text.
Insert text.
ns
Change n characters.
nc SPACE
Change n characters.
cw
Change word.
cc or S
c$ or C
c0
nrc
Delete commands
Table 6 describes the delete commands.
Table 6: Delete commands
Command
Description
nx
nX
dw
Delete word.
dd
25
Description
d$ or D
d0
26
Command
Description
COMMANDS
This chapter describes each of the CLI commands.
A
adduser
Creates a new user account and adds it to the database. The command also
generates a random password which the user can change with the changepass
command.
Syntax adduser
100A, Z-Edge 64
See Also changepass, deleteuser
27
Commands
alarm
Displays all active alarms since the last system reboot.
Syntax alarm show [summary]
Options show
Displays the alarm totals and lists alarm details, such as resource ID and
alarm type and alarm severity.
summary
Displays only alarm totals.
Example zSH> alarm show
zSH> alarm show
************
Central Alarm Manager
ActiveAlarmCurrentCount
ActiveAlarmTotalCount
ClearAlarmTotalCount
OverflowAlarmTableCount
ResourceId
1-1-1-0/sonet
1-3-1-0/adsl
1-3-4-0/adsl
1-3-5-0/adsl
1-3-6-0/adsl
1-3-12-0/adsl
1-3-13-0/adsl
1-1-1-0/sonet
************
:8
:9
:1
:0
AlarmType
linkDown
linkDown
linkDown
linkDown
linkDown
linkDown
linkDown
sonetSectionStatusChange
AlarmSeverity
critical
minor
minor
minor
minor
minor
minor
major
ata
Initializes, formats, or displays the contents of the system flash cards.
Caution: Formatting or initializing a PC card destroys all existing
data on the card.
Syntax ata [ show | format | init ] slot
Options show
28
slot
The slot that contains the PC card.
Access Level admin
Products BAN, MALC, Raptor 319, Raptor 719, Raptor 723
atmping
Sends an ATM OAM F4 and F5 loopback cell to a VCL.
Note: You must turn on logging before issuing the atmping
command.
Syntax atmping [ifindex/vpi/vci] | [name/type/vpi/vci] | [shelf/
slot/port/subport/type/vpi/vci] [segmentF4/F5 |
endtoendF4/F5]
Options ifindex
The ifindex of the interface Use the lineGroup command to find the
ifindex.
vpi
The virtual path identifier of the ATM interface.
vci
The virtual path identifier of the ATM interface.
name
The name of the interface (for example, uplink1, or a user-defined name
configured in the if-translate profile for the interface).
shelf/slot/port/subport
The physical location of the interface. For the Sechtor 100A and the
Z-Edge, shelf and slot are always 1.
type
IANA type for the interface. For example, adsl, ds1, ds3, hdsl2, sonet.
segmentF4/F5
Sends the ping to the next ATM interface using either F4 (VP) or F5 (VC)
loopback cells. This option is currently unsupported.
endtoendF4/F5
Sends the ping to the far-end ATM interface.
Example Enable logging before issuing a atmping command.
zSH> log serial on
Serial port logging enabled.
29
Commands
100A, Z-Edge
atmvclshow
The atmvclshow command provides the administrative user with the ability
to view Virtual Channel Link (VCL) status information, as well as audit
members in a traffic descriptor group.
Syntax atmvclshow
Options
[port
[vpi vci]]
(no option)
Displays global information of all ATM VCL records on the system.
port
Displays all ATM VCL records on the specified port.
port vpi vci
Displays the ATM VCL record on a singular occurrence of a VCL.
Example 1 This first example displays a global ATM VCL record which includes the task
30
by the port, VCI, and VPI. In this instance, the ATM VCL record displays port
1, VPI of 4, and VCI of 202.
31
Commands
100A
B
bond add
Enables bond groups to be added on a device.
Syntax bond add group groupinterface [static|dynamic] [name] |
member groupinterface | link interface
Options group groupinterface
Specifies the name and type of the bond group to be added, for example
1-2-103-0/n2nbond.
static | dynamic
For EFM bond groups, specifies whether group members will participate
in OAM discovery.
member groupinterface
Name and type of bond group, for example 1-2-103-0/n2nbond.
link interface
Name and type of the physical interfae, for example 1-2-1-0/shds1.
Example
To add a single N2N or EFM bond group and verify bond group. If the bond
group already exists, adding an identical group with a different bond type
changes the bond group type.
zSH> bond add group 1-1-101-0/n2nbond
zSH> list if-translate
.....
if-translate 1-1-101-0/n2nbond
if-translate 1-1-101-0-n2nbond/linegroup
32
bond delete
Remove the configured bond group by link interface, group interface or a link
interface.
Syntax bond delete group groupName | member groupinterface |
linkinterface
Options group groupinterface
Specifies the name and type of the bond group to be deleted, for example
1-2-103-0/n2nbond.
member groupinterface
Name and type of bond group, for example 1-2-103-0/n2nbond.
linkinterface
Name and type of the physical interfae, for example 1-2-1-0/shds1.
Example Bond groups can be deleted or individual members removed.
zSH> bond delete member 1-1-101-0/n2nbond 1-1-3-0/shdsl
bond modify
Modifies the configured bond group.
Syntax bond modify efm|n2n slot slotnumber | group
groupinterface [static|dynamic] [name] | link interface
Options efm | n2n
33
Commands
slot slotnumber
Specifies the slot number for which bond groups are modified.
group groupinterface
Specifies the name and type of the bond group to be added, for example
1-2-103-0/n2nbond.
static | dynamic
For EFM bond groups, specifies whether group members will participate
in OAM discovery.
link interface
Name and type of the physical interfae, for example 1-2-1-0/shds1.
Example zSH> bond modify n2n group 1-1-101-0/efmbond
zSH> bond modify efm slot 1
bond move
Moves the configured bond group member to a different bond group.
Syntax bond move group groupinterface | member groupinterface |
link interface
Options group groupinterface
Specifies the name and type of the bond group to be moved, for example
1-2-103-0/n2nbond.
member groupinterface
Name and type of bond group, for example 1-2-103-0/n2nbond.
link interface
Name and type of the physical interfae, for example 1-2-1-0/shds1.
Example zSH> bond move 1-1-102-0/efmbond 1-1-101-0/n2nbond
1-1-2-0/shdsl
bond show
Display the configured bond groups by link interface, bond group, slot
number, or a bond groups on a device.
Syntax bond show all | slot slotNum | group groupName | link
interface
Options all
34
link interface
Displays all bond groups and group members for the specified interface
and type, for example 1-2-1-0/ds1.
Example 1 zSH> bond show all
Bond Groups
Name
1-8-207-0
1-8-201-0
1-8-203-0
Type
n2nbond
n2nbond
n2nbond
State
ACT
OOS
ACT
Type
n2nbond
n2nbond
n2nbond
State
ACT
OOS
ACT
State
ACT
Slot
8
8
8
GrpId
207
201
203
Example 3 zSH>
Slot
8
8
8
Port
3
4
5
Group Members
Name
1-8-3-0
1-8-4-0
1-8-5-0
Type
ds1
ds1
ds1
State
ACT
ACT
ACT
Type
n2nbond
State
ACT
Type
ds1
ds1
State
ACT
ACT
bootstate
Displays the boot state of a card in the system.
Syntax bootstate slotcard
Options slotcard
its image.
zSH> bootstate 8
Boot State: Loading Image over backplane
35
Commands
Example 2 The following example shows the output of the bootstate command if there is
bridge
The bridge command can add, delete, or show bridges. A flush option is also
available to purge bridge filters of learned MAC entries, either separately or
for a specified interface. The MALC supports a maximum of 1024 bridges.
Note: Only learned bridge entries are purged with this command.
Static bridge entries are not removed with this command.
Ethernet interfaces can be addressed as either eth or ethernetcsmacd.
The eth abbreviation is used in command output.
add
Add a bridge interface on the specified physical interface.
interface/type
Name and type of the physical interface.
Note: In the bridge add command, <slot> and <port> may be replaced
with brackets containing numbers in series and/or (dash-separated)
ranges; <port> may be replaced with wildcard '*' for all ports on the
card.
Examples:
36
vc vpi/vci
Used to specify the VPI and VCI values for ATM circuits. For example:
0/23. This is a mandatory field if you are creating a bridge on an ATM
logical interface. This is field is not required if you are creating a bridge
on an Ethernet interface.
tc tcvalue
Traffic container information. This is a mandatory field if you are creating
a bridge on a PON physical interface. This field is not required for
non-PON interfaces.
td tdvalue | rxtd rxtdvalue | txtd txtdvalue
Used to specify the traffic descriptor index to be used. Optionally,
separate rxtd rxtdvalue and txtd txtdvalue values may be specified for
ADSL connections, where separate traffic descriptors are used for the
upstream and downstream traffic due to the asymmetric nature. This is a
mandatory field if you are creating a bridge on an ATM logical interface.
This is field is not required if you are creating a bridge on an Ethernet
interface.
other | llc
The type of AAL5 data encapsulation used: llc sets logical link control
encapsulation over AAL5, which is commonly used with routers; other
sets RFC 1483 multiprotocol encapsulation over AAL5, which is
commonly used with bridges. If no value is given, the AAL5
encapsulation type default is llc.
uplink | downlink | intralink
Indicates bridging behavior of the interface. This field is omitted when
creating transparent bridges.
Uplink
Causes the interface to forward packets to the network. Uplink
interfaces support one or more bridging domains and allow VLANs
that terminate on a MALC IP interface. Broadcasts received on an
uplink port are not sent to any downlink port, except for ARP and
DHCP when customARP and customDHCP options are enabled.
Unicast packets received on an uplink are forwarded to the downlink
where the MAC address was learned. Uplink ports do not learn MAC
addresses and do not strip or insert VLAN tags.
downlink
Causes the interface to send packets to the customer interface. Requires
a specific VLAN ID or VLAN tagging.
Downlink interfaces with a specific VLAN ID perform strip and insert
function for outgoing and incoming traffic and learn MAC addresses.
All traffic (unicast and broadcast) received on a downlink is sent to the
default interface as specified in the bridge-path default command.
37
Commands
Tagged downlink interfaces do not strip and insert VLAN tags. Other
downlink interface functions are identical.
Intralink
Causes the interface to forward all traffic from the uplink that is not
local.
No value creates a transparent bridge. Transparent bridges send
broadcasts to all ports, learn an unlimited number of MAC addresses on
a port, and allow any port to send traffic to any other port.
vlan vlan_id
VLAN identifier associated with the interface. This is a mandatory field
for downlink interfaces that do not use the tagged option.
slan slan_id
SLAN or secondary VLAN identifier associated with the interface.
tagged | untagged
The tagged/untagged status of the bridge. The tagged option is a
mandatory field if you are creating a VLAN on a downlink interface and
do not specify a specific LAN ID.
cos cos_value
Class of Service level associated with the interface.
outgoingCOSOption
Specifies whether to overwrite the VLAN priority bits on packets bridged
out this interface with the value specified in the outgoingCOSValue
parameter. Values are disable and all. Disable indicates the VLAN priority
bit is untouched. All overwrites all the VLAN priority bits on packets
bridged out this interface with the value specified in the
outgoingCOSValue parameter. The default is disable.
outgoingCOSValue
For tagged packets, specifies the value loaded into the priority field of the
VLAN header. Values are 0 to 7 with 0 the lowest priority and 7 the
highest. The default value is 0.
video m/n
Specifies the multicast control list and the maxvideostreams for the video
signal.
Maxvideostreams specifies the maximum number of allowed video
streams. To enable this setting, the multicast control list must be used.
This option is only available when for bridge video configuration.
Mcastctrl specifies the multicast control list to use. This option is only
available when for bridge video configuration.
config configGroupIndex
Specifies the bridge config group for this bridge interface. A
bridge-config-record with this group index must exist.
pppoa
Specifies this is a PPPoA port.
38
name ifname
The name for the interface. This is an optional field.
secure | nonsecure
Secure restricts packets allowed through the bridge to only IP packets that
have received successful DHCP negotiations.
Nonsecure allows packets allowed through the bridge with both static and
dynamic IP addresses.
Syntax bridge modify interface/type uplink | downlink |
intralink | tpid tpid value| vlan vlan_id | slan slan
value | tagged | untagged] [cos cosvalue] [outcosall
outcos value] scos scos value | soutcosall soutcos value
| video mcastctrl/maxvideostreams | config confGroupIndex
| pppoa |name ifname secure | non-secure
interface/type
Name and type of the physical interface.
Note:
zSH> bridge modify 1-5-*-0/shdsl vc 0/35 maxUnicast
9
zSH> bridge modify 1-5-[1,2]-0/shdsl vc 0/35 vlan 3
39
Commands
40
Secure restricts packets allowed through the bridge to only IP packets that
have received successful DHCP negotiations.
Non-secure allows packets allowed through the bridge with both static
and dynamic IP addresses.
Syntax bridge delete Interface/type vc vpi/vci [vlan vlanID]
delete
Delete a bridge interface from the specified physical interface.
Interface/type
Name and type of the physical interface, such as 1-4-3-0/adsl.
Note: In the bridge delete command, <slot> and <port> may be
replaced with brackets containing numbers in series and/or
(dash-separated) ranges; <port> may be replaced with wildcard '*' for
all ports on the card.
Examples:
1-[10-13]-[1,3-5,21]-0/ds3 for DS3 ports 1,3,4,5,21 on cards
10,11,12, and 13.
1-[6,7,9]-*-0/adsl for all ADSL ports on cards 6, 7, and 9.
vc vpi/vci
ATM layer information for bridge over ATM (for example, vc 0/35).
Omitted for bridge over Ethernet
vlan vlanID
For downlink bridges with VLANS, to delete the bridge the VLAN ID
must be specified.
Syntax bridge show vlan vlan_id | interfaceName/bridge
show
The bridge show command displays a truncated record for the bridge.
vlan vlan_id
List all bridge interfaces for the specified VLAN. This includes tagged
interfaces, but only the bridge filter table information for the specified
VLAN is displayed.
interfaceName/bridge
List only the information for specified bridge interface.
Syntax bridge showall vlan vlan_id | interfaceName/bridge
showall
The bridge showall command displays the entire contents of bridge
record.
Syntax bridge flush <<interface> <ifIndex>|<name>/<type>> | mac
<vlan> <MAC addr>> | all
ifIndex
41
Commands
42
value is inserted into the priority field of the VLAN header when an untagged
packet received on this interface is tagged (VLAN ID inserted) for bridging.
bridge add 1-8-22-0/adsl vc 0/35 td 20000 downlink vlan 100 tagged COS 7
Example 9 This example adds interface 1-8-22-0/adsl with a vlanIDCOS value of 7 and
enables the overwriting of the VLAN ID in all outgoing packets with the
value of 7.
bridge add 1-8-22-0/adsl vc 0/35 td 20000 downlink vlan 100 tagged COS 7 outCOS
all 7
Example 10 Purges the learned MAC entries and IGMP client tables for the specified
bridge interface.
zSH> bridge showall
VLAN
Bridge
State Table Data
----------------------------------------------------------------0
1-3-1-0-adsl-0-35/bridge
UP
D 00:00:00:00:00:01
D00:02:b9:72:9d:41
D 10.1.1.2
0
ethernet2/bridge
UP
S Global default [3600 sec]
0
1-3-2-0-adsl-0-35/bridge
UP
D 00:00:00:00:00:02
D 223.30.2.130
zSH> bridge flush interface 1-3-1-0-adsl-0-35/bridge
zSH> bridge showall
VLAN
Bridge
State Table Data
----------------------------------------------------------------0
1-3-1-0-adsl-0-35/bridge
UP
0
ethernet2/bridge
UP
S Global default [3600 sec]
0
1-3-2-0-adsl-0-35/bridge
UP
D 00:00:00:00:00:02
D 223.30.2.130
Example 11 Purges the learned MAC entries for the specified VLAN and MAC address.
43
Commands
Received Packets
UCast MCast BCast
0
0
1
0
0
0
0
0
0
Transmitted Packets
UCast MCast Bcast
0
0
0
0
0
0
0
0
0
Error
0
0
1
Received Packets
UCast MCast BCast
0
0
1
0
0
0
Transmitted Packets
UCast MCast Bcast
0
0
0
0
0
0
Error
0
1
44
999
999
999
999
999
999
999
999
999
999
01:00:5e:02:7f:fe
01:00:5e:02:7f:fe
01:00:5e:02:7f:fe
01:00:5e:02:7f:fe
01:00:5e:02:7f:fe
01:00:5e:02:7f:fe
01:00:5e:02:7f:fe
01:00:5e:02:7f:fe
01:00:5e:02:7f:fe
01:00:5e:02:7f:fe
224.2.127.254
224.2.127.254
224.2.127.254
224.2.127.254
224.2.127.254
224.2.127.254
224.2.127.254
224.2.127.254
224.2.127.254
224.2.127.254
928
929
930
931
932
933
934
935
936
937
00:02:02:0b:44:cd
00:02:02:0b:4c:ca
00:02:02:0b:47:bd
00:02:02:0b:47:c7
00:02:02:0b:4d:35
00:02:02:0b:4d:5b
00:02:02:0b:4a:a5
00:02:02:0b:4c:9e
00:02:02:09:c1:78
00:02:02:0a:c0:ca
71
61
7
177
181
144
59
3
6
131
Access Level admin for bridge add, delete, and show. user for bridge flush.
Products MALC, Raptor 319, Raptor 719, Raptor 723
bridge-path
Use this command to add, modify, delete, or show static-bridge profiles.
Note: Ethernet interfaces can be addressed as either eth or
ethernetcsmacd. The eth abbreviation is used in command output.
Syntax bridge-path add interface/type
global
global-intralink
intralink
vlan vlan_id
45
Commands
add
Add a static-bridge assignment between an existing MAC address and an
interface.
interface/type
Name and type of the physical interface.
global
Global default route for the whole network. If global is specified, no
further parameters are required.
global-intralink
Global intralink. All traffic that cannot be resolved will be forwarded out
this interface. If global is specified, no further parameters are required.
intralink
A type of bridge that receives forwarded traffic from the uplink that is not
local traffic.
vlan vlan_id
VLAN identifier associated with the interface.
age value
The AgingPeriod measured in seconds. This is an optional field.
default
The specified interface is the default destination for bridge packets with
the specified vlan_id. If default is specified, no other parameters are
required.
[mac] mac_address
Use this option to associate a specific MAC address and VLAN with an
interface. The [mac] argument is optional. The mac_address is in
hexadecimal notation (for example, 00:01:02:03:04:05).
ip ip_address
Use this option to associate a specific IP address and VLAN with an
interface.
flap
Controls how the MALC handles frames when frames with a MAC
address that has been previously recorded on a different port in the
learning bridge table. If flap enable is false, then the entry will not be
learned, and will be dropped instead. If flap enable is true, then the older
entry will be flushed from the learning table, and the new port will be
recorded with the MAC address. Possible values are:
default
The default setting disables flap control and allows other static
bridge-paths to settings to have priority.
46
enable
If flap enable is enabled, then the older entry will be flushed from the
learning table after a 60 second wait, and the new port will be recorded
with the MAC address.
disable
If flap enable is disabled, then the entry will not be learned, and will be
dropped instead.
fast
If flap enable is set to fast, then the older entry will be immediately
flushed from the learning table, and the new port will be recorded with
the MAC address.
mcastage
Specifies the multicast aging period per VLAN or as a global setting.
igmpquesryinterval
Specifies the IGMP query injection interval per VLAN or as a global
setting. Appears for only devices with bridge video configurations. This
parameter cannot be specified on bridge intralinks. If this parameter is set,
but mcastage is not specified, the MALC sets the mcastage parameter to 2
times the IGMP query interval, plus 1
Syntax bridge-path delete interface/type
global | global-intralink | vlan vlan_id
default | [mac] mac_address | ip ip_address
delete
Delete a static-bridge assignment thus breaking an association between an
IP address and an interface.
Syntax bridge-path
show
show
List all static-bridge assignments.
Example 1 Create a static bridge between an interface and a specific MAC address and
VLAN.
zSH> bridge-path add 1-1-1-0/ds3 vlan 22 00:10:c0:ad:79:22
Example 2 Create a static bridge between an interface and a specific IP address and
VLAN.
zSH> bridge-path add 1-1-4-0/ds3 vlan 3 ip 192.16.80.1
Example 3 Create a static bridge between an interface and a default destination (specified
by the vlan_id).
zSH> bridge-path add 1-1-3-0/ds3 vlan 2 age 1000 default
Example 4 Delete a static bridge between an interface and a specific MAC address and
VLAN.
47
Commands
VLAN.
zSH> bridge-path delete 1-1-4-0/ds3 vlan 3 ip 192.16.80.1
Access Level user
Products MALC, Raptor 319, Raptor 719, Raptor 723
bridge rates
Show statistics for bridge interfaces as rates.
If the clear keyword is provided the statistics are cleared
rather than displayed.
If the reset keyword is provided the statistics are cleared
after being displayed.
Syntax bridge rates <>|<clear>|<reset>
<|<vlan <vlanId>>|<interfaceName/bridge>
Options VLAN or interface
Received Packets/Sec
UCast MCast BCast
2356
2
1
2385
0
1
Transmitted Packets/Sec
UCast MCast Bcast Error
2339
0
1
0
2402
2
1
1
C
card add
Adds card profiles for specified card settings. Optional parameters are
available software load filename, card group ID, linetype, line card voltage
(ISDN cards only), and status. By default, new card profiles are enabled..
48
49
Commands
card change
Update card profiles for new card types. By default, validation is performed to
match the software load file and the card type. An optional parameter is
available to override validation to use a software load file that does not match
the card type.
Syntax card change [-f] card-profile-address new-card-type
[sw-file-name]
Options -f
50
card delete
Remove card profiles for the specified card.
Syntax card delete card-profile-address
Options card-profile-address
card update
Updates card profiles for specified card settings.
Syntax card update card-profile-address [load sw-file-name]
[adminstatus admin-status] [upgradeload
upgrade-sw-file-name] [upgrade upgrade-vers]
[adminstatusenable enable|disable] [upgradeadmin
sw-upgrade-admin] [swenable true|false] [swupgradeenable
true|false] [group card-group-id] [holdactive true|false]
[weight weight] [linetype card-line-type] [atmconfig
card-atm-configuration] [voltage card-line-voltage]
[maxvivci maxvpi-maxvci]
Options card-profile-address
51
Commands
swenable true|false
Optionally, specifies the software enable state of the card. By default, the
software enable state is true.
swupgradeenable true|false
Optionally, specifies the software upgrade enable state of the card. By
default, the software upgrade enable state is true.
group card-group-id
Optionally, specifies a the card-group-id assigned to the card profile. If no
card-group-id is provided, the default group ID for the specified card type
is used.
holdactive true/false
Optionally, specifies the software load file to be configure for the card. By
default, the system determines the software load based on the card type.
weight weight
Optionally, specifies the software load file to be configure for the card. By
default, the system determines the software load based on the card type.
linetype card-line-type
Optional, specifies a the card-line-type assigned to the card profile. If no
card-line-type is provided, the default card-line-type for the specified card
type is used.
voltage card-line-voltage
Optional, specifies a the card-line-voltage for ISDN cards assigned to the
card profile. If no line voltage is provided, the default line voltage for the
specified ISDN card is used.
maxvpivci maxvpi-maxvci
Optional, specifies maximum VPI and VCI for the card.
Example
card update 1/21/5049 adminstatusenable disable
card update 1/21/5049 linetype isdn-pv
card update 1/20/5036 load malc.bin adminstatus operational upgradeload foof
upgradeversion 99 adminstatusenable disable upgradeadmin upgradenow swenable
false swupgradeenable true group 9 holdactive true weight nopreference
linetype adsl-splitter atmconfig notapplicable voltage 95 maxvp vpi15-vci63
Access Level admin
Products MALC
See Also
ccshow
The ccshow command shows associated connections and call state
information given a range and type of endpoint.
52
Displays call related information for the given address(es). Note that the
format of the address depends on the type of endpoint.
AAL2 | GR303 | V52 | POTS | ELCPAAL2
The type of endpoint to display.
address
The address for the type of endpoint.
*
Use an asterisk after the endpoint type to display all of the endpoints.
Syntax ccshow AAL2 lgid [/vpi[/vci[/cid]]]
lgid
The line group ID of the AAL2 interface. Use the lineGroup command to
find this number.
vpi/vci/cid
Depending upon the level of detail required, enter the VPI or the VPI/VCI
or the VPI/VCI/CID.
Syntax ccshow V52 ifname [|userid [ / POTS|ISDND|ISDNB [/
bchanid]]]
ifname
The V5.2 interface name (V52).
userid
The V5.2 user port number. List the v52-user-port profiles to display the
user port number. For example, if the profile has the following address:
v52-user-port
1/192/2
igname
The name of the GR-303 Interface Group (IG).
crv
The GR-303 endpoint Call Reference Value (CRV).
Syntax ccshow POTS lgid [/potsnumber]
lgid
The line group ID of the POTS interface. Use the lineGroup command to
find this number.
53
Commands
potsnumber
The number of the POTS interface.
Example 1 The following example displays call state information for all the AAL2 calls
*
UP V52:ZTL1/29/P UP CallState:ACTV
UP V52:ZTL1/30/P UP CallState:ACTV
UP V52:ZTL1/31/P UP CallState:ACTV
UP V52:ZTL1/32/P UP CallState:ACTV
UP V52:ZTL1/25/P UP CallState:IDLE
UP V52:ZTL1/26/P UP CallState:IDLE
UP V52:ZTL1/27/P UP CallState:IDLE
UP V52:ZTL1/28/P UP CallState:IDLE
UP V52:ZTL1/33/P UP CallState:ACTV
UP V52:ZTL1/34/P UP CallState:ACTV
UP V52:ZTL1/35/P UP CallState:ACTV
UP V52:ZTL1/36/P UP CallState:ACTV
UP V52:ZTL1/37/P UP CallState:ACTV
UP V52:ZTL1/38/P UP CallState:ACTV
UP V52:ZTL1/39/P UP CallState:ACTV
page, <CR> for next line, A for all, Q to
Example 2 The following example displays call state information for all the V52 calls in
UP CallState:ACTV
UP CallState:ACTV
UP CallState:ACTV
UP CallState:ACTV
UP CallState:ACTV
UP CallState:ACTV
UP CallState:ACTV
UP CallState:IDLE
UP CallState:IDLE
UP CallState:IDLE
UP CallState:ACTV
UP CallState:ACTV
line, A for all, Q to
Example 3 The following example displays detailed call state information (using the -d
Then use the linegroup to display detailed information about AAL2 calls on
the interface (note the output is abbreviated):
54
PVC-AAL2:36:VPI-0:VCI-304:CID-21
UP
V52:Link-ZTL1:UserID-30:UserType -POTS_USER
UP
ACTIVE
Term Address:
Term State:
Sibling Address:
Sibling State:
Call state:
PVC-AAL2:36:VPI-0:VCI-304:CID-22
UP
V52:Link-ZTL1:UserID-31:UserType -POTS_USER
UP
ACTIVE
PVC-AAL2:36:VPI-0:VCI-304:CID-17
UP
V52:Link-ZTL1:UserID-26:UserType -POTS_USER
UP
IDLE
page, <CR> for next line, A for all, Q to quit
Example 4 The following example shows AAL2 call information for a particular VPI and
CallState:ACTV
CallState:ACTV
CallState:ACTV
CallState:ACTV
CallState:ACTV
CallState:ACTV
CallState:ACTV
CallState:ACTV
Example 5 The following example shows detailed AAL2 call information for a particular
55
Commands
number 192 in the interface group ZTL1. List the v52-user-port profiles to
view the userID.
zSH> ccshow -d V52 ZTL1/192/POTS ifname/userid/call-type
Term Address: V52:Link-ZTL1:UserID-192:UserType -POTS_USER
Term State: UP
Sibling Address: PVC-AAL2:36:VPI-0:VCI-324:CID-23
Sibling State: UP
Call state: ACTIVE
1 out of 384 records match
Products MALC, Raptor 319, Raptor 719, Raptor 723, Sechtor 100A
See Also crossconnect
cd
Changes the current directory on the flash card file system.
Syntax cd directory [ options ]
Options directory
56
changepass
Changes password for the current user.
Syntax changepass
Example zSH> changepass
Current Password:
New Password :
Confirm New Password :
Password change successful.
Access Level user
Products BAN, MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723, Sechtor
100A, Z-Edge 64
See Also resetpass, adduser
clkmgrshow
To view the clock information on the system, use the clkmgrshow command.
Syntax clkmgrshow [current | eligible | list ]
Options current
: T1 : LOOP
DS3 : LOOP
DS3 : LOOP
DS3 : LOOP
DS3 : LOOP
The asterisk (*) on a clock source indicates it the active clock source.
Example 2 The following example displays the current primary and secondary clock
sources:
zSH> clkmgrshow current
Primary system clock is 1/21/1/0 (10) : T1
Secondary system clock is 1/1/1/0 (1) : DS3
57
Commands
Products BAN, MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723, Sechtor
100A
commit
This command is only used by the configuration restore process.
Syntax N/A
Products BAN, MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723, Sechtor
100A, Z-Edge 64
configsync
Manages the config sync process. Config sync is used to keep the
configuration of a device and ZMS in sync.
In some situations a device may stop sending config sync files to ZMS and the
config sync status becomes stuck in a syncpending state. A audit process
monitors the config sync process.
The config sync audit runs every six minutes and checks whether the config
sync process has been in a syncpending state for more than 5 minutes
without performing an FTP transfer to ZMS (which indicates that the config
sync process has stalled).
In this case, the config sync process is restarted, the config sync status is set to
syncerror, and a configSyncReset trap is sent.
Note: Zhone recommends that you perform a config sync update
from ZMS. For more information, refer to the documentation that
came with the ZMS software.
Syntax configsync stat reg | change | V5.2NameID | GR-303NameID
reg
Displays detailed config sync statistics, including the registered
information for the config sync process.
change
Displays state of change lists and status of FTP transfers.
V5.2NameID
Displays the V5.2 config sync cache list for the specified interface group.
GR-303NameID
Displays the GR-303 config sync cache list for the specified interface
group.
Syntax configsync initiate full | partial
full
58
reset
Resets the config sync process.
Caution: Do not use this command unless requested to do so by
GSS. Resetting the config sync process may cause a system reboot.
Example To show the status of the config sync process:
zSH> configsync stat change
Config Sync Status:
---------------FTP Transfer Stats:
Last Time The Timer Popped (seconds) = 947898179
Current Time (seconds) = 947898485
Last Ftp Time (seconds) = 0
ConfigSync Status = SYNC_INITIALIZING
copy
Copies a file on the flash card file system to another location on the same
flash card or to another flash card (BAN only).
Syntax copy source destination
Options source
create
This command is used only by the configuration restore process.
Syntax N/A
59
Commands
Products BAN, MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723, Sechtor
100A, Z-Edge 64
crossconnect
Add, delete, or show cross connects on the system.
For the T1/E1 CES card, add, delete, or show cross connects for CES circuits.
Syntax crossconnect add interface1/type1 vc vpi1/vci1 tc tc1
interface2/type2 vc vpi2/vci2 tc tc2 td_value | txtd
txtd_value rxtd rxtd_value
60
61
Commands
To delete a cross connect, specify either one of the VCLs in the cross connect
or the cross connect index.
delete
Delete an ATM crossconnect and the VCLs it connects.
interface/type
The name and type of one side of the crossconnect. For example, 1-1-1-0/
ds1.
vc vpi/vci
62
ATM layer information for bridge over ATM. For example, vc 0/35. If
the interface is supplied it can be either end of the connect. If an interface
is supplied the cc index is omitted
cc index
The cross connect index. If the cc index is supplied, the interface/type
and vc are omitted.
Syntax cc vp delete interface1/type1 vp vpi1/vci1 interface2/
type2 vc vpi2/vci2
Delete atm-vpls, atm-vcls and all related cross connections for the VP-VC.
interface1/type1
Name and type of the first physical interface (for example, uplink1/atm)
in the connection.
vpi1/vci1
ATM layer information for the first VP in the connection (for example,
20/35).
interface2/type2
Name and type of the second physical interface (for example, 1-9-4-0/
cellrelayproxy/atm) in the connection.
vpi2/vci2
ATM layer information for the second VP in the connection (for example,
21/36).
Syntax cc vpi delete interface1/type1 vp vpi1/0 interface2/type2
vc vpi2/0
To show a cross connect, specify either one of the VCLs in the cross connect
or the cross connect index.
63
Commands
(no arguments)
Displays all crossconnects in the system.
cc index
Displays the cross connect indicated by the index number.
interface/type
The name and type of one side of the crossconnect. For example, 1-1-1-0/
ds1.
vc vpi/vci
List the connection that contains the indicated VCL.
ces
List the ces connection that contains the indicated VCL.
Example 1
zSH> crossconnect add 1-1-1-0-adsl/atm vc 0/37 uplink1/atm vc 1/101 td 1
Example 2
zSH> crossconnect delete 1-1-1-0-adsl/atm vc 0/37
Example 3
zSH> crossconnect show
ATM VCL
CC
ATM VCL
HANDLE ID
---------------------------------------------------------------------------1-1-1-0-propvirtual/atm 0/32 Up 1 Up
1-6-1-0-adsl/atm 0/32 Up handle_1
1-1-1-0-propvirtual/atm 0/33 Up 2 Up
1-6-2-0-adsl/atm 0/32 Up handle_2
1-1-1-0-propvirtual/atm 0/34 Up 3 Up
1-6-3-0-adsl/atm 0/32 Up handle_3
1-1-1-0-propvirtual/atm 0/35 Up 4 Up
1-6-4-0-adsl/atm 0/32 Up handle_4
1-1-1-0-propvirtual/atm 0/36 Up 5 Up
1-6-5-0-adsl/atm 0/32 Up handle_5
1-1-1-0-propvirtual/atm 0/37 Up 6 Up
1-6-6-0-adsl/atm 0/32 Up handle_6
1-1-1-0-propvirtual/atm 0/38 Up 7 Up
1-6-7-0-adsl/atm 0/32 Up handle_7
1-1-1-0-propvirtual/atm 0/39 Up 8 Up
1-6-8-0-adsl/atm 0/32 Up handle_8
1-1-1-0-propvirtual/atm 0/40 Up 9 Up
1-6-9-0-adsl/atm 0/32 Up handle_9
1-1-1-0-propvirtual/atm 0/41 Up 10 Up
1-6-10-0-adsl/atm 0/32 Up handle_10
1-1-1-0-propvirtual/atm 0/42 Up 11 Up
1-6-11-0-adsl/atm 0/32 Up handle_11
1-1-1-0-propvirtual/atm 0/43 Up 12 Up
1-6-12-0-adsl/atm 0/32 Up handle_12
1-1-1-0-propvirtual/atm 0/44 Up 13 Up
1-6-13-0-adsl/atm 0/32 Up handle_13
1-1-1-0-propvirtual/atm 0/45 Up 14 Up
1-6-14-0-adsl/atm 0/32 Up handle_14
1-1-1-0-propvirtual/atm 0/46 Up 15 Up
1-6-15-0-adsl/atm 0/32 Up handle_15
1-1-1-0-propvirtual/atm 0/47 Up 16 Up
1-6-16-0-adsl/atm 0/32 Up handle_16
1-1-1-0-propvirtual/atm 0/49 Up 18 Up
1-6-18-0-adsl/atm 0/32 Up handle_17
<SPACE> for next page, <CR> for next line, A for all, Q to quit
64
Description
ATM VCL
CC
Handle ID
Example 4
zSH> cc add uplink2/atm 0/53 1/12/2/0/ds1 vc 1/33 ds0 1/24 unstr td 1
Example 5
zSH> cc delete uplink2/atm 0/53
Example 6
zSH> cc show
ATM VCL
CC
ATM VCL
HANDLE ID
-------------------------------------------------------------------------uplink2/atm 0/53 Up
1 Up
1-12-2-0-ds1/atm 1/33 Up handle_1
Access Level admin
Products MALC, Raptor 319, Raptor 719, Raptor 723
D
datastorestats
The DataStore is a configuration database containing all the provisioning data
of the system The datastorestats command provides information about the
use of the DataStore configuration database.
Syntax datastorestats
Example
zSH> datastorestats
Data Store AVL Tree Stats
------------------------Inserts
:
Deletes
:
0
Records in Data Store
:
509
Current DataStore Size is
348628 bytes used out of
HashStats:
finds: 4
509
65
Commands
misses: 0
addressSearchExcludes: 0
indexSearchExcludes: 156
slowSearch: 156
slowFind: 156
inserts: 293
dups: 1362
Products Raptor 100, Sechtor 100A
del
Deletes a file from the flash card file system as well as directories and
multiple files..
Syntax del -rv filename|directoryname|*
Options -rv
delete
Deletes a record from the system. Note that for some types of records, such as
card profiles, the delete command also deletes associated records. For
example, if you delete a DSL card-profile, the system deletes all the ATM
VCLs, VPLs, and cross connects configured on that card. It also deletes any
VCLs/VPLs configured on the trunking card if they are part of a cross connect
between the DSL card and the trunking card.
Syntax delete profile-type [index | * ] [-orphan]
Options profile-type
66
y
: y
: y
: y
Example 3 The following example deletes multiple atm traffic descriptors using the
67
Commands
Example 4 On a BAN, MALC, or Raptor, the delete command can also be used to delete
a card-profile and all profiles associated with the card. After the profiles have
been deleted, the card reboots.
Caution: Before deleting card profiles, remove the card from the
system as explained in the hardware documentation that came with
your unit.
Caution: Back up the system configuration before deleting card
profiles. Refer to the release notes that came with your unit for
details.
The following example deletes a SHDSL card profile in shelf 1, slot 16:
zSH> delete card-profile 1/16/5006 shelf/slot/type
Delete card-profile 1/16/5006? [y]es, [n]o, [q]uit : y
card-profile 1/16/5006 deleted.
Access Level admin
Notes You can only delete one card-profile at a time. Wildcards are not supported
100A, Z-Edge 64
See Also get, list, new, update, show
deleteuser
Deletes a user account from system.
Syntax deleteuser username
Options username
100A, Z-Edge 64
See Also adduser, updateuser
delt
The MALC supports the DELT commands for Dual-End Loop Tests:
Syntax delt start <interface>
68
interface
The <interface> can be in the form of ifIndex (432), name/type (1-4-1-0/
adsl) or shelf/slot/port/subport/type (1/4/1/0/adsl0.
start-index
(0..511) is the tone index with which to start. 0 is 4.3125 kHz, 1 is 8.625
kHz, up to 511 which is 2208.0000 kHz.. The noise command displays
the loop noise floor results of a delt test. There is one noise measurement
per ADSL tone. Each noise value has units of dBm/Hz.
num-val
The number of tones to display.
Notes Note that it may take some time (perhaps as much as a minute) for the DELT
test to abort.
dhcp-relay
Add, delete, modify or show dhcp-server-subnet profiles configured with an
enternal DHCP server address:
Syntax dhcp-relay add [<subnetgroup>] <ip-address> [<interface>/
<type>|NULL]
subnetgroup
Add a dhcp-server-subnet profile with indicated subnetgroup and
external-server ip-address. The index of the dhcp-server-subnet will be
the subnetgroup.
ip-address
The subnet address/mask is derived from the system's floating IP address,
if present, or may be specified NULL for use only with bridged interfaces.
If multiple floating IP records are present, the desired <name>/<type>
may be specified.
interface/type|NULL
The network address/mask is derived from the floating ip-interface-record
for the system; if there is none and NULL is not specified, an error will be
returned; if there are more than one, specify the desired one in
<interface>/<type>. If NULL is specified, the network address/mask will
each be 0, and only bridges may be provisioned to use the external server.
dhcp-relay delete
Delete the dhcp-server-subnet profile with indicated index.
dhcp-relay modify <subnetgroup> <ip-address>
Change the external-server address for the indicated index.
69
Commands
dhcp-relay show
Display the list of external-server addresses with subnetgroup and subnet
address/mask.
dir
Displays the contents of the directory on the device file system.
Syntax dir
Example
zSH> dir
Listing Directory .:
-rwxrwxrwx 1 0
-rwxrwxrwx 1 0
-rwxrwxrwx 1 0
-rwxrwxrwx 1 0
-rwxrwxrwx 1 0
-rwxrwxrwx 1 0
-rwxrwxrwx 1 0
drwxrwxrwx 1 0
drwxrwxrwx 1 0
-rwxrwxrwx 1 0
-rwxrwxrwx 1 0
-rwxrwxrwx 1 0
-rwxrwxrwx 1 0
drwxrwxrwx 1 0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
668932
5776033
4197357
4117051
392308
1563843
1206836
2048
2048
668296
1855714
1030717
2368132
2048
27384184
ds1relay
The ds1relay command controls the DS1 relay settings. The relays can be set
to terminate individual or all of the DS1 circuits on the primary 64-pin
connector or on the secondary, redundant 64-pin connector (on the Sechtor
100A) or on the T1/E1 Uplink interface (on the Raptor 100):
Note: The ds1relay command does not persist across system
reboots.
Syntax ds1relay [ all | circuit-number ] [ passthru | terminate ]
circuit-number
A DS1 circuit number from 1 to 8 (Sechtor 100A) or 1-4 (Raptor 100).
all
All of the DS1 circuits that terminate on the system.
70
passthru
The DS1 circuit or circuits that terminate on the Sechtor 100A primary
connector are electrically connected to the secondary (redundant)
connector. Internal Sechtor 100A hardware that was connected to the DS1
circuit or circuits is connected to a loopback path.
terminate
Terminate the specified DS1 circuit or circuits on the primary 64-pin
connector (Sechtor 100A) or the 50-pin Uplink connector (Raptor 100).
Example 1 zSH> ds1relay all terminate
All of the DS1 circuits terminate on the primary 64-pin connector (Sechtor
100A) or the 50-pin Uplink connector (Raptor 100).
Example 2 zSH> ds1relay all passthru
All of the DS1 circuits are connected to the secondary 64-pin connector.
Example 3 zSH> ds1relay 1 passthru
The first DS1 circuit is connected to the secondary 64-pin connector, the other
circuits remain unchanged.
Access Level admin
Products Raptor 100, Sechtor 100A
ds1rpshow
Displays information about the T1 interface resource providers on the system.
Syntax ds1rpshow [linenumbers]
Options
************
tDS1RP
01:01:106
0x022b0000_0000004e
0x022b0000_0000004f
0x022b0000_0000004f
0x022b0000_0000004f
0x022b0000_0000004f
0x022b0000_0000004f
8
0
0
71
Commands
0 1 2 3 4 5 6 7
Example 2
zSH> ds1rpshow 1
************
DS1 RP Debug Information
name:
address:
lineRRLeaseId:
ds1XlatProfLeaseId:
ds1LineProfLeaseId:
ds1GroupProfLeaseId:
ds1CfgProfLeaseId:
systemProfLeaseId:
numUnits:
clkStatus:
clkSrc:
Attached units:
0 1 2 3 4 5 6 7
************ Debug Information for Line 1
state:
ifIndex:
shelf:
slot:
port:
subPort:
xlatProf.ifIndex:
xlatProf.ifType:
xlatProf.adminStatus:
groupProf.groupId:
groupProf.groupName:
groupProf.primaryName:
groupProf.secondaryName:
groupProf.primaryWeight:
groupProf.secondaryWeight:
groupProf.adminStatus:
alarms
loopback
************
tDS1RP
01:01:106
0x022b0000_0000004e
0x022b0000_0000004f
0x022b0000_0000004f
0x022b0000_0000004f
0x022b0000_0000004f
0x022b0000_0000004f
8
0
0
************
3
3
1
1
2
0
3
18
1
3
1/1/2
3
0
0
0
2
1
-> No Alarm
1
Products Raptor 100, Raptor 319, Raptor 719, Raptor 723, MALC
ds3rpshow
Displays information about the T1 interface resource providers on the system.
Syntax ds3rpshow [linenumbers]
Options
72
Example 1
zSH> ds3rpshow
************
DS3ATM RP Debug Information
name:
address:
lineRRLeaseId:
ds3AtmXlatProfLeaseId:
ds3AtmCfgProfLeaseId:
lineRRClientLeaseId:
ds3AtmRpCardGroupId:
iamActiveCard:
Redundancy Mode
PeerCardAvailable
PeerCardShelf
PeerCardSlot
requestLineRRNotification:
numUnits:
Attached units:
1 2 3 4
************
tDS3ATMRP
01:01:1091
0x022b0000_0000006a
0x022b0000_0000006c
0x022b0000_0000006c
0x022b0000_0000006b
1
TRUE
CARD
FALSE
0
0
TRUE
4
Example 2
zSH> ds3rpshow 1
************
DS3ATM RP Debug Information
************
name:
tDS3ATMRP
address:
01:01:1091
lineRRLeaseId:
0x022b0000_0000006a
ds3AtmXlatProfLeaseId:
0x022b0000_0000006c
ds3AtmCfgProfLeaseId:
0x022b0000_0000006c
lineRRClientLeaseId:
0x022b0000_0000006b
ds3AtmRpCardGroupId:
1
iamActiveCard:
TRUE
Redundancy Mode
CARD
PeerCardAvailable
FALSE
PeerCardShelf
0
PeerCardSlot
0
requestLineRRNotification:
TRUE
numUnits:
4
Attached units:
1 2 3 4
************ Debug Information for Line 1 ************
iamActiveLine:
TRUE
state:
4
ifIndex:
4
primaryClock:
FALSE
shelf:
1
slot:
1
port:
1
subPort:
0
xlatProf.ifIndex:
4
xlatProf.ifType:
30
xlatProf.adminStatus:
1
cnfgProf.lineType:
4
73
Commands
cnfgProf.lineCoding:
cnfgProf.sendCode:
cnfgProf.circuitId:
cnfgProf.loopbackConfig:
cnfgProf.transmitClockSource:
cnfgProf.lineLengthMeters:
cnfgProf.lineStatusChangeTrapEnable:
cnfgProf.channelization:
cnfgProf.mediumScrambleConfig:
Ds3_Stats_Profile.timeElapsed:
Ds3_Stats_Profile.validIntervals:
Ds3_Stats_Profile.lineStatus:
2
1
''
1
1
0
1
1
1
0
0
0x840
-> LOS
-> Net-Equip-OOS
Ds3_Stats_Profile.plcpAlarmStatus:
1
-> No Alarm
Ds3_Stats_Profile.ifTCAlarmStatus:
2
-> LCD Failure
Ds3_Stats_Profile.invalidIntervals:
0
Ds3_Stats_Profile.lineStatusLastChange: 951806042
Ds3_Stats_Profile.loopbackStatus:
0x1
-> None
Products Raptor 100, Raptor 319, Raptor 719, Raptor 723, MALC
dslstat
Displays the DSL training rates for the DSL cards in a system.
Syntax dslstat [ifIndex] | [name/type] | [shelf/slot/port/
subport/type] [-v]
Options ifIndex
74
subport
Used to identify multiple logical subports on a physical port.
-v
Indicates the verbose option to display additional VDSL data.
Example 1 zSH> dslstat 1-15-1-0/adsl
General Stats:
------------AdminStatus..................................UP
Line uptime (DD:HH:MM:SS)....................0:02:27:52
DslUpLineRate (bitsPerSec)...................512000
DslDownLineRate (bitsPerSec).................8064000
DslMaxAttainableUpLineRate (bitsPerSec)......565333
DslMaxAttainableDownLineRate (bitsPerSec)....856000
Out Octets...................................286571
Out Discards.................................0
Out Errors...................................0
In Octets....................................286571
In Discards..................................0
In Errors....................................0
ATM OCD Count................................0
ATM NCD Count................................0
ATM HEC Count................................0
ATM far-end OCD Count........................0
ATM far-end NCD Count........................0
ATM far-end HEC Count........................0
ADSL Physical Stats:
-----------------Actual Transmission connection standard......G.dmt
AdslAtucCurrLineSnrMgn (tenths dB)...........310
AdslAtucCurrLineAtn (tenths dB)..............135
AdslAtucCurrOutputPwr (tenths dB)............70
AdslAturCurrLineSnrMgn (tenths dB)...........90
AdslAturCurrLineAtn (tenths dB)..............135
AdslAturCurrOutputPwr (tenths dB)............103
LOFS.........................................0
LOLS.........................................0
LOSS.........................................0
ESS..........................................0
Inits........................................1
Adsl connects................................1
Adsl disconnects.............................5407
near-end statistics:
------------------blocks received..............................147087
errored blocks received......................0
CRC errors on interleaved buffer.............0
CRC errors on fast buffer....................0
FEC corrected errors on interleaved buffer...0
FEC corrected errors on fast buffer..........0
background errored blocks received...........0
75
Commands
76
LOFS.........................................1
LOLS.........................................1
LOSS.........................................1
ESS..........................................9
CRC Errors...................................0
Inits........................................65
Example 3 zSH> dslstat 1-6-3-0/vdsl -v
General Stats:
------------AdminStatus..................................UP
DslUpLineRate (bitsPerSec)...................1115
DslDownLineRate (bitsPerSec).................1115
DslMaxAttainableUpLineRate (bitsPerSec)......26523
DslMaxAttainableDownLineRate (bitsPerSec)....41857
Out Octets...................................0
Out Pkts/Cells...............................0
Out Discards.................................0
Out Errors...................................0
In Octets....................................0
In Pkts/Cells................................0
In Discards..................................0
In Errors....................................0
DSL Physical Stats:
-----------------DslLineSnrMgn (tenths dB)....................317
DslLineAtn (tenths dB).......................0
DslCurrOutputPwr (tenths dB).................39
LOFS.........................................0
LOLS.........................................0
LOSS.........................................0
ESS..........................................0
CRC Errors...................................0
Inits........................................0
VDSL PHY VTUC Stats:
------------------serialNumber.................................(co-0123456)
vendorId.....................................GSPN
versionNumber................................1.66.35
curSnrMargin.................................317
currAtn......................................0
currStatus...................................NO DEFECT
currOutputPwr................................39
currAttainableRate...........................41861
currLineRate.................................1115
VDSL CHAN VTUC Stats:
-------------------interleaveDelay..............................66
crcBlockLength...............................40
currTxRate...................................992
currTxSlowBurstProt..........................9
currTxFastFec................................0
77
Commands
dump
Saves the Zhone system configuration.
Syntax dump [console] | [file filename ] [network host filename]
Options console
78
Set the TFTP server time-out value to at least 5 seconds, and 5 retries to
help prevent TFTP time-out or retry errors.
The Z-Edge 64 and the Sechtor 100A do not support saving the
configuration to a local file.
Products BAN, MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723, Sechtor
100A, Z-Edge 64
See Also restore
E
eeset
Sets values in the device EEPROM. This command is only used to configure
Sechtor 100A redundancy.
Syntax eeset slot [1 | 2] card [1 | 2]
slot [1 | 2]
The slot number to set the device to. For the Sechtor 100A this is always 1
for the active unit and 2 for the standby unit.
card [1 | 2]
The card number to set the device to. For the Sechtor 100A this is always
1 for the active unit and 2 for the standby unit.
Syntax eeset failover on card 1
Sets the MAC address of the redundant peer on the primary device
(always card 1).
Access Level user
Products Sechtor 100A
See Also eeshow
eeshow
Displays the contents of the specified electrically erasable programmable
read-only memory (EEPROM). The information include the serial number of
the device, the CLEI code (if any), the Zhone card type, and the type of I/O
cards installed.
Syntax eeshow eeprom-name slot
79
Commands
Options eeprom-name
Name of the EEPROM contents you want to display. Possible values are:
1daughter | 2daughter | 3daughter: up to 3 daughter cards are supported
on MALC or Raptor cards
card
iocard: slots 1 through 17 (BAN only)
mezz
shelfme: slot 0 only
shelfmon: slot 0 only
backplane: slot 0 only
fantray: slot 0 only
For the Z-Edge 64 card is the only valid eeprom-name. For the Sechtor
100A and Raptor 100, card and mezz are the only valid eeprom-names.
slot
Slot number containing the eeprom. If you do not specify a slot number,
the eeprom on the current card or on slot 0 (the system EEPROM).
Example 1 To display the Zhone card type, use the eeshow card command:
zSH> eeshow card 1
EEPROM contents:
EEPROM_ID
: 00 -- CARD
Version
: 01
Size
: 054
CardType
: 05035 -- MALC_GIGE
CardVersion : 800-01322-02-A
SerialNum
: 04440120
ShelfNumber : 00001
CLEI Code
: No CLEI
Cksum
: 0x4D60
MAC Address are enabled for 2 address(es) starting at:
00:01:47:43:C0:38
Example 2 (BAN only) To display the type of I/O card installed in a slot, use the eeshow
iocard command:
zSH> eeshow iocard 1
EEPROM contents:
EEPROM_ID
: 03 -- MEZZ
Version
: 01
Size
: 018
CardType
: 00013 -- OC3ATM_SM indicates an OC3-c/STM1 interface
CardVersion : 00001
SerialNum
: 02610001
ShelfNumber : 00001
CLEI Code
: No CLEI
Cksum
: 0x0531
Feature bits modification date: 0/0/2000 00:00:00
Example 3 zSH> eeshow 1d 5
80
EEPROM contents:
EEPROM_ID
: 01 -- 1DAUGHTER
Version
: 01
Size
: 022
CardType
: 05050 -- MALC_ULCS_ISDN_2B1Q
CardVersion : 00001
SerialNum
: 00210003
ShelfNumber : 00001
CLEI Code
: No CLEI
Cksum
: 0x92A6
Access Level admin
Products BAN, MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723, Sechtor
100A, Z-Edge 64
See Also eeset
eth-oam add
Configures and enables OAM interface on a physical interface.
Syntax eth-oam interface/type [active | passive]
Options interface/type
eth-oam delete
Deletes and disables the OAM configuration on the specified physical
interface. This command does not delete any other configurations on this
interface such as bond groups and bridge interfaces.
Syntax eth-oam delete interface/type
Options interface/type
eth-oam modify
Modifies a configured eth-oam interface.
Syntax eth-oam modify interface/type [active | passive]
Options interface/type
81
Commands
eth-oam show
Displays configured OAM parameters for the specified interface. If no
interface is specified, configured OAM parameters are displayed for all OAM
enabled interfaces.
Syntax eth-oam show interface/type [peer]
Options interface/type
eth-oam stats
Displays OAM statistics for the specified interface. If no option is specified,
statistics are displayed for all OAM interfaces.
Syntax eth-oam stats interface/type
Options interface/type
F
featurebitdisplay
Displays the features enabled on the system.
Syntax featurebitdisplay featurenumber
Options (no option)
100A, Z-Edge 64
See Also featurebitset
featurebitset
Enables certain features on Zhone systems. You must obtain a hash code from
Zhone GSS before using this command.
82
100A, Z-Edge 64
See Also featurebitdisplay
fhrameping
Pings a specified location within the device. You can only ping slot cards, you
cannot ping I/O cards.
Syntax fhrameping shelf slot [ port ]
Options shelf
card.
zSH> fhrameping 1 14
Pinging Shelf 1, slot 14
FhramePing Timeout with Shelf 1, Slot 14
Example 2 The next example shows the fhrameping response received from an active
card.
zSH> fhrameping 1 3 1
Pinging Shelf 1, slot 3 port 1
Shelf 1, Slot 3, Port 1, is Alive!
Access Level user
Products BAN, MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723, Sechtor
100A, Z-Edge 64
See Also ping
83
Commands
file
Transfers files to or from a TFTP server without verifying the image header.
This command can be used to download a dump file previously made to the
network or upload one that was made to a local file.
Note: The file command should be used only for general purpose file
transfer, not for upgrading system software. To upgrade software, use
the image command.
Syntax file [download | upload] tftphost sourcefilepath
targetfilepath
Options download
Downloads the file to the flash card on the device. This option is typically
used to restore a configuration created using the dump command.
upload
Uploads the specified file to the TFTP server. This option is typically
used to save a copy of the software image files.
sourcefile
The full path name of the source file. On the BAN Infoservice card flash
cards, the path is /card1/file or /card2/file, depending on the flash cards
installed. On a MALC or Raptor, do not specify the card.
targetfile
The full path name of the target file. On the BAN Infoservice card flash
cards, the path is /card1/file or /card2/file, depending on the flash cards
installed. On a MALC or Raptor, do not specify the card.
If you are transferring a file to a TFTP server, the file must exist and be
writable.
Example The following example downloads a file to the host 192.168.9.55 named
savedump and writes it to the file named localdump on the first Infoservices
flash card (/card1).
zSH> file download 192.168.9.55 saveddump localdump
Access Level admin
Notes Set the TFTP server time-out value to at least 5 seconds, and 5 retries to help
filter
IP filtering is typically performed to enhance network security by limiting
access between two networks. IP filtering is based on the recognition and
selective transmission or blocking of individual IP packets. Packets meeting
84
some criterion are forwarded, and those that fail are dropped. On BAN, IP
filtering is used to block inbound traffic to the management network.
Syntax The following command adds a rule to the currently loaded filter. If the rule
rule
A user-defined value for the filtering rule.
from | to
Defines incoming or outgoing.
IP address
The interface address.
permit | deny
Permit or deny traffic flow.
Syntax The following command deletes the specified line (also known as rule) from
line
The filter identifier.
Syntax The following command sets the description field of the currently loaded
filter.
filter description description_string
description_string
A string of text and spaces describing the purpose of the filter.
Syntax The following command deletes the specified filter.
filter destroy specIndex
specIndex
The user-defined value for the filter.
Syntax The following command discards the currently loaded filter along with any
uncommitted changes.
filter discard
Syntax The following command displays help for the specified filter command.
85
Commands
[command]
The specific argument to the filter command.
Syntax The following command lists all defined filters showing specIndex, name,
Syntax The following command loads a filter into the CLI for modification.
filter load specIndex
specIndex
The index value for the filter.
Syntax The following command replaces rule in the currently loaded filter with
newrule.
filter modify line newrule
line
The user-defined value for the filter.
newrule
A number value defining the new rule.
Syntax The following command sets the name field of the currently loaded filter.
filter name name
name
An arbitrary string, containing no spaces, that is considered a name for
this filter. While it is desirable, it is not required that this name be unique.
Syntax The following command locates a new specIndex, and establishes a new filter
[name]
An arbitrary string, containing no spaces, that is considered a name for
this filter. While it is desirable, it is not required that this name be unique.
[description_string]
A string of text and spaces describing the purpose of the filter.
Syntax The following command lists each interface that is configured to use the
86
[specIndex]
The index value for the filter.
Syntax The following command renumbers all rules in the currently loaded filter with
renumber [stride]
The range between rule numbers.
Syntax The following command commits the currently loaded filter for modification.
filter save
Syntax The following command displays the filter currently committed to Infostore.
[specIndex]
The user-defined value for the filter.
Products BAN, MALC, Raptor 319, Raptor 719, Raptor 723
find
Searches through available commands.
Syntax find [-s(ubSearch) | -d(etailed)] stringToSearch
Options -s
string show:
zSH> find show
eeshow
showdatetime
showinetstat
showlinestatus
show
showhost
showipstat
showmem
87
Commands
showresolver
showzhonecpe
showuser
example, the following command searches all the online help for the
commands for the word profile:
zSH> find -d profile
delete
new
get
show
list
update
Example 4 After you have performed a command search, the lst command lists only the
get
show
list
update
Example 5 To reset the lst command so it displays all the available commands, use the -m
ata
cd
commit
create
delete
dir
eeshow
featurebitset
file
get
history
image
list
log
lst
msg
ping
pwd
resetpass
rip
route
setdatetime
88
Products BAN, MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723, Sechtor
100A, Z-Edge 64
See Also get, show
find-matching-data
The find-matching-data command displays the provisioned data path
through the system which includes the specified ATM VCL.
Syntax find-matching-data ATM interface/type vpi vci
ATM
Keyword
interface/type
Name and type of the physical interface.
vpi
Virtual path indicator.
vci
Virtual channel indicator
Example
zSH> find-matching-data ATM 1-3-1-0-adsl/atm 0 35
VCL 1-3-1-0-adsl/atm 0 35 is used in atm-cc 1
The far end of this cross connect is 1-1-1-0-aal5proxy/atm 0 32
Products MALC, Raptor 319, Raptor 719, Raptor 723
find-matching-subvoice
The find-matching-subvoice command displays the other endpoint of a
subscriber-voice connection, given one endpoint. You can find endpoints for
the following voice connections:
AAL2
CLASS5
DS1
ELCPAAL2
GR-303
ISDN
POTS
V52
VOIP
89
Commands
AAL2
The type of voice endpoint.
LGID
The line group identifier (also known as the ifIndex). Use the linegroup
command to find the line group ID for an interface.
VPI
Virtual Path Identifier of the AAL2 connection. You can find this in the
aal2-vcl profile.
VCI
Virtual Channel Identifier of the AAL2 connection. You can find this in
the aal2-vcl-profile.
CID
Channel Identifier. You can find this in the aal2-cid-profile.
Syntax find-matching-subvoice CLASS5 ID/EndPointIndex
CLASS5
The type of voice endpoint.
ID
ID for the Class5 switch.
EndPointIndex
Index of the voice connection endpoint.
Syntax find-matching-subvoice DS1 LGID/ChannelID
DS1
The type of voice endpoint.
LGID
The line group identifier (also known as the ifIndex). Use the linegroup
command to find the line group ID for an interface.
ChannelID
Matching channel ID of the DS0 signal.
Syntax find-matching-subvoice ELCPAAL2 LGID/VPI/VCI/PortID/
PortType/ChannelID
ELCPAAL2
The type of voice endpoint.
LGID
90
The line group identifier (also known as the ifIndex). Use the linegroup
command to find the line group ID for an interface.
VPI
Virtual Path Identifier of the ELCP AAL2 connection.
VCI
Virtual Channel Identifier of the AAL2 connection.
PortID
The port Identifier.
PortType
Port type.
ChannelID
Matching channel ID of the AAL2 signal.
Syntax find-matching-subvoice GR303 IG name/CRV
GR303
The type of voice endpoint.
IG name
Interface Group name.
CRV
Call Reference Value.
Syntax find-matching-subvoice ISDN groupID/portType/channelID
ISDN
The type of voice endpoint.
Group ID
The line group identifier (also known as the ifIndex). Use the linegroup
command to find the line group ID for an interface.
port type
The ISDN D or B channel. Values are isdndchannel or isdnbchannel.
channel id
The channel identifier. Values are 1 (D channel), 2 (B channel) or 3 (B
channel).
Syntax find-matching-subvoice POTS LGID
POTS
The type of voice endpoint.
LGID
The line group identifier (also known as the ifIndex). Use the linegroup
command to find the line group ID for an interface.
Syntax find-matching-subvoice VOIP LGID/EndPointIndex
CLASS5
91
Commands
V52
The type of voice endpoint.
Interface name
Name of the V5.2 interface group.
portId
The port ID of the V5.2 connection. This is the local-interface-id from
the v52-interface-group profile.
user type
The type of voice connection. Value can be POTS or ISDN.
channel id
The channel identifier. For POTS this is 0.
Example 1 In this example, the AAL2 voice connection is associated with a V5.2
interface.
zSH> list subscriber-voice-aal2
subscriber-voice-aal2 5
subscriber-voice-aal2 7
subscriber-voice-aal2 9
...
zSH> get subscriber-voice-aal2 5
voice-aal2-line-group-id: -> {134}
voice-aal2-vpi: -----------> {2}
voice-aal2-vci: -----------> {701}
voice-aal2-cid: -----------> {16}
zSH> find-matching-subvoice AAL2 134/2/701/16
INPUT:
profile type: subscriber-voice-aal2
logical address: LGID: 134 VPI: 2 VCI: 701 CID: 16
profile address: 5
subscriber-voice INFO:
voice-connection-type
= AAL2TOV52
voice-endpoint1-addr-index = 5
voice-endpoint2-addr-index = 6
voice-admin-status
= Enabled
subscriber-voice addr: subId: 2 LGId: 134
subVoiceId: 1
MATCHING:
92
profile
logical
IsdnBChannelId:
profile
type: subscriber-voice-v52
address: IfName: rtl UserId: 1
0
address: 6
not found. The following example asks for the other endpoint of an AAL2
subscriber-voice-aal2 profile that has an undefined CID of 232:
zSH> find-matching-subvoice AAL2 1/1/1/232
INPUT:
profile type: subscriber-voice-aal2
logical address: LGID: 1 VPI: 1 VCI: 1 CID: 232
profile address: Address not found
93
Commands
If there is more than one endpoint with the same address, the system returns a
message that includes the duplicate end point address:
zSH> find-matching-subvoice AAL2 1/1/1/25
INPUT:
profile type: subscriber-voice-aal2
logical address: LGID: 1 VPI: 1 VCI: 1 CID: 25
profile address: 11
subscriber-voice INFO:
More than 1 subscriber-voice have the same end point
address: 11
Example 4 If the AAL2 address exists, but is not configured as part of a subscriber-voice
profile, the system will display an error message as in the following example:
zSH> find-matching-subvoice AAL2 1/1/1/33
INPUT:
profile type: subscriber-voice-aal2
logical address: LGID: 1 VPI: 1 VCI: 1 CID: 33
profile address: 33
subscriber-voice INFO:
No subscriber-voice has end point address: 33
Example 5 If the subscriber-voice-aal2 endpoint does not have a second endpoint
configured, the system will return an error that the other endpoint can not be
found:
zSH> find-matching-subvoice AAL2 1/1/1/44
INPUT:
profile type: subscriber-voice-aal2
l ogical address: LGID: 1 VPI: 1 VCI: 1 CID: 44
profile address: 44
subscriber-voice INFO:
voice-connection-type
= AAL2TOGR303
voice-endpoint1-addr-index = 44
voice-endpoint2-addr-index = 1111
voice-admin-status
= Disabled
subscriber-voice addr: subId: 1 LGId: 1 subVoiceId: 44
MATCHING:
profile address: Matching subscriber-voice endpoint with
address 1111 not found
Example 6 ISDN
94
voice-isdn-channel-id: ---->
{2}
This example finds the AAL2 endpoint that is associated with a POTS
interface.
zSH> list subscriber-voice-pots
subscriber-voice-pots 3001
subscriber-voice-pots 3002
subscriber-voice-pots 3003
...
zSH> get subscriber-voice-pots 3001
voice-pots-line-group-id: -> {33}
zSH> find-matching-subvoice POTS 33
INPUT:
profile type: subscriber-voice-pots
logical address: LGId: 33 PotsNumber: 1
profile address: 3001
subscriber-voice INFO:
voice-connection-type
= POTSTOAAL2
voice-endpoint1-addr-index = 3001
voice-endpoint2-addr-index = 301
voice-admin-status
= Enabled
subscriber-voice addr: subId: 33 LGId: 5
subVoiceId: 1
MATCHING:
profile type: subscriber-voice-aal2
logical address: LGID: 5 VPI: 0 VCI: 301 CID: 17
profile address: 301
Example 8 V52
95
Commands
This example finds the AAL2 endpoint that is associated with a V5.2 user
port.
zSH> list subscriber-voice-v52
subscriber-voice-v52 6
subscriber-voice-v52 8
subscriber-voice-v52 10
subscriber-voice-v52 34
...
zSH> get subscriber-voice-v52 6
voice-V52-interface-name: --> {rtl}
voice-V52-user-port-id: ----> {1}
voice-V52-user-type: -------> {pots}
voice-V52-isdn-channel-id: -> {0}
zSH> find-matching-subvoice V52 rtl/1/pots/0
INPUT:
profile type: subscriber-voice-v52
logical address: IfName: rtl UserId: 1
IsdnBChannelId: 0
profile address: 6
subscriber-voice INFO:
voice-connection-type
= AAL2TOV52
voice-endpoint1-addr-index = 5
voice-endpoint2-addr-index = 6
voice-admin-status
= Enabled
subscriber-voice addr: subId: 2 LGId: 134
subVoiceId: 1
MATCHING:
profile type: subscriber-voice-aal2
logical address: LGID: 134 VPI: 2 VCI: 701 CID: 16
profile address: 5
Products BAN, MALC, Sechtor 100A, Z-Edge 64
G
get
The get command displays the contents of record and its configured
parameters.
Syntax get profile-type index
Options profile-type
Shows the parameters in the specified profile with the parameter value
ranges.
index
Record to display.
96
Example To view the configuration of a particular record, use the get command and
100A, Z-Edge 64
See Also list, show
gpononu
For GPON configurations, sets and displays ONU and serial number
associations. The default bandwidth is 1 Mbps.
Syntax gpononu clear slot/onu | set [bw] slot/onu [bandwidth|
show slot/onu | showall [slot/onu] [enabled] [free]
Example
zSH> gpononu show 8/1
Free ONUs for slot 8 olt 1:
1
2
4
5
6
7
14
15
16
17
18
19
26
27
28
29
30
31
8
20
32
9
21
33
10
22
34
11
23
35
12
24
36
13
25
37
97
Commands
38
39
40
50
51
52
62
63
64
Discovered serial
sernoID
Vendor
1
ZNTS
2
ZNTS
41
53
42
54
43
55
44
56
45
57
46
58
47
59
48
60
Vendor
49
61
Serial Number
1-8-1-2
Yes
4.5
GponPorts
1-8-1-502/gponport
98
BW(Mb) GponPorts
1
1-8-1-501/gponport
18.5
1-8-1-502/gponport
gr303showcrv
The gr303showcrv command displays information about GR-303 call
reference values (CRVs). This command is available when T1/E1 uplink and
voicegateway cards are installed.
Syntax gr303showcrv igName crvNumber
Options igName
99
Commands
H
help
Displays help text for a command.
Syntax help [ -p ][ command ]
Options (no option)
100
100A, Z-Edge 64
history
Displays the commands stored in the command buffer.
Syntax history [ size ]
Options
100A, Z-Edge 64
host
The host command is used to add, delete, or show hosts in a
point-to-multipoint network.
Note: Ethernet interfaces can be addressed as either eth or
ethernetcsmacd. The eth abbreviation is used in command output.
Syntax zSH> host add interface/type vc vpi/vci [tc tcvalue] td
tdvalue | txtd tdvalue rxtd tdvalue other | llc static
x.x.x.x | dynamic SubnetGroup count [video
MulticastControlList/NumberofVideoStreams] vlan vlanid
101
Commands
add
Add hosts to an IP multi-point subnet. Hosts may be given static IP
addresses or dynamically assigned addresses using DHCP.
interface/type
Name and type of the physical interface, such as 1-4-3-0/adsl.
Note: In the host add command, <slot> and <port> may be replaced
with brackets containing numbers in series and/or (dash-separated)
ranges; <port> may be replaced with wildcard '*' for all ports on the
card.
Examples:
1-[10-13]-[1,3-5,21]-0/ds3 for DS3 ports 1,3,4,5,21 on cards
10,11,12, and 13.
1-[6,7,9]-*-0/adsl for all ADSL ports on cards 6, 7, and 9.
vc vpi/vci
Used to specify the VPI and VCI values for ATM circuits. For example:
vc 0/23.
tc tcval
Used to specify the traffic container index to be used. This is a mandatory
field if the physical interface type is PON.
td tdvalue | rxtd rxtdvalue txtd txtdvalue
Used to specify the traffic descriptor index to be used. Optionally,
separate rxtd rxtdvalue and txtd txtdvalue values may be specified for
ADSL connections, where separate traffic descriptors are used for the
upstream and downstream traffic due to the asymmetric nature.
other | llc
The type of AAL5 data encapsulation used: other sets RFC 1483
multiprotocol encapsulation over AAL5, which is commonly used with
bridges; llc sets logical link control encapsulation over AAL5, which is
commonly used with routers. If no value is given, the default other is the
AAL5 encapsulation type.
static x.x.x.x
Add a host to the given subnet with the static IP addresses of x.x.x.x.
dynamic subnetgroup count
Add count number of hosts to the given subnet and have their IP
addresses assigned dynamically using DHCP from IP addresses that are in
the subnet group as specified by subnetgroup.
video MulticastControlList/NumberofVideoStreams
Adds a video client connection using the specified multicast control list
entry and maximum number of video streams. By default, the multicast
control list enables subscriptions up to the number of maximum video
streams on the interface without control list checking. Video streams can
be configured on 10/100 and GigE interfaces.
102
When the video argument is specified, the VCL cast type for the
subscriber interface (vcl_cast_type) is set to p2mpleaf.
vlan
Specifies the VLAN ID to apply to this interface.
slan
Specifies the SLAN (second VLAN) ID to apply to this interface.
cos
For tagged packets, specifies the value loaded into the priority field of the
VLAN header. Values are 0 to 7 with 0 the lowest priority and 7 the
highest. The default value is 0.
scos
For SLAN packets, specifies the value loaded into the priority field of the
VLAN header. Values are 0 to 7 with 0 the lowest priority and 7 the
highest. The default value is 0.
tosDisable/tosOrig//tosAll
modify
Modify hosts to an IP multi-point subnet. Hosts may be given static IP
addresses or dynamically assigned addresses using DHCP.
interfacename/type
Name and type of the physical interface, such as 1-4-3-0/adsl.
Note: In the host modify command, <slot> and <port> may be
replaced with brackets containing numbers in series and/or
(dash-separated) ranges; <port> may be replaced with wildcard '*' for
all ports on the card.
Examples:
1-[10-13]-[1,3-5,21]-0/ds3 specifies DS3 ports 1,3,4,5,21 on cards
10,11,12, and 13.
1-[6,7,9]-*-0/adsl specifies all ADSL ports on cards 6, 7, and 9
vc vpi/vci
Used to specify the VPI and VCI values for ATM circuits. For example:
vc 0/23.
vlan vlanID
Specifies that VLAN ID that was assigned to the host. If a VLAN ID was
assigned to the host when it was configured, the VLAN ID must be
specified when deleting the host.
Syntax host delete interface/type vc vpi/vci ip x.x.x.x | unused
count | all vlan vlanID
delete
Delete a host or hosts from an IP multi-point subnet.
103
Commands
interfacename/type
Name and type of the physical interface, such as 1-4-3-0/adsl.
Note: In the host delete command, <slot> and <port> may be
replaced with brackets containing numbers in series and/or
(dash-separated) ranges; <port> may be replaced with wildcard '*' for
all ports on the card.
Examples:
1-[10-13]-[1,3-5,21]-0/ds3 for DS3 ports 1,3,4,5,21 on cards
10,11,12, and 13.
1-[6,7,9]-*-0/adsl for all ADSL ports on cards 6, 7, and 9.
vc vpi/vci
Used to specify the VPI and VCI values for ATM circuits. For example:
vc 0/23.
ip x.x.x.x
Delete the host with the IP address of x.x.x.x. This host may have been
assigned its address either via DHCP or statically.
unused count
Delete up to count number of DHCP host entries that have not yet been
assigned an IP address.
all
Delete all hosts on this subnet and the subnet itself.
video MulticastControlList/NumberofVideoStreams
Deletes the video client connection using the specified multicast control
list entry and maximum number of video streams.
vlan
Specifies that VLAN ID that was assigned to the host. If a VLAN ID was
assigned to the host when it was configured, the VLAN ID must be
specified when deleting the host.
Syntax host show interface interface/type vc vpi/vci | addr
x.x.x.x | host x.x.x.x
show
Show hosts that are part of an IP multi-point subnet.
interface interfacename/type
Show only hosts on this physical interface.
vc vpi/vci
Must be used with interface keyword. Show only hosts on given interface
with this VCL value.
addr x.x.x.x
Show only hosts with on the interface with the address of x.x.x.x.
host x.x.x.x
Show only the host with the address of x.x.x.x.
104
Example 1
zSH> host add 1-11-1-0/adsl vc 0/35 td 1 llc dynamic 1 3
Example 2
zSH> host delete 1-11-1-0/adsl vc 0/35 all
Example 3
zSH> host show interface 1-11-1-0/adsl vc 0/35
Example 4
zSH> host add 1-11-1-0/adsl vc 0/35 td 1 llc dynamic 1 3 video 1/4
Example 5
host add 1-6-9-0/adsl vc 0/37 td 1 tpid 0x8200 vlan 100 slan 10 cos 2 scos 3
dynamic 1 3
Products MALC, Raptor 319, Raptor 719, Raptor 723
I
ifxlate
Translates between ifindex values and physical interfaces (of the form
shelf-slot-port-subport-type).
Syntax ifxlate ifindex
Options ifindex
the interface:
zSH> ifxlate 1
ifIndex: ---------->
shelf: ------------>
slot: ------------->
port: ------------->
subport: ---------->
type: ------------->
adminstatus: ------>
physical-flag: ---->
iftype-extension: ->
ifName: ----------->
redundancy-param1: ->
{1}
{1}
{3}
{1}
{0}
{ethernetcsmacd}
{up}
{true}
{none}
{1-3-1-0}
{0}
105
Commands
Products BAN, MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723, Sechtor
100A, Z-Edge 64
image
Downloads software to the system from a TFTP server, updates the boot
partition, or verifies the flash card file system.
Note: The image command should be used to download software
image files, because it verifies the image header as part of the
download process.
Syntax image download tftphost file_path [destination]
106
imalink
The imalink command enables you to move, add, delete, or view IMA
(inverse multiplexing over ATM) links.
Syntax imalink move SourceIMAGroup DestinationIMAGroup
ds1Interface
Displays information about or IMA groups or only the specified IMA group.
IMAgroup
The IMA group to view, in the form shelf-slot-port-subport/atmima.
Syntax imalink mkuni ds1Interface
107
Commands
Adds an IMA link. Do not use this command unless requested to by GSS.
IMAgroup
The IMA group to remove, in the form shelf-slot-port-subport/atmima.
ds1Interface
The link group to add, in the form shelf-slot-port-subport/ds1.
Syntax imalink remove IMAgroup ds1Interface
108
000006
000007
000008
000009
000010
DS1 Links
If Index
--------000011
IMA Group
IMA Group
DS1 Links
If Index
--------000090
DS1 Links
If Index
--------000091
000092
000093
000094
000089
DS1 Links
If Index
--------000095
000096
000097
000098
DS1 Links
If Index
1-1-3-0
1-1-4-0
1-1-5-0
1-1-6-0
1-1-7-0
for IMA Group 1-1-2-0/atmima:
If Name
--------------1-1-8-0
1-1-3-0/atmima has no assigned links.
1-1-4-0/atmima has no assigned links.
for IMA Group 1-6-1-0/atmima:
If Name
--------------1-6-4-0
for IMA Group 1-6-2-0/atmima:
If Name
--------------1-6-5-0
1-6-6-0
1-6-7-0
1-6-8-0
1-6-3-0
for IMA Group 1-6-3-0/atmima:
If Name
--------------1-6-9-0
1-6-10-0
1-6-11-0
1-6-12-0
for IMA Group 1-6-4-0/atmima:
If Name
imarpshow
The imarpshow command displays resource provider information about the
MALC IMA group. This command is available only when an uplink card with
IMA support is installed. The command uses the following syntax:
Syntax imarpshow [index]
Options index
The IMA group number (currently, 1 (one) is the only supported value).
Example 1 zSH> imarpshow
RP Info:
rp state -------------------> RP_INITIALIZED
address --------------------> 01:01:113
rp shelf -------------------> 1
109
Commands
rp slot -------------------->
rp ima core started -------->
imaGrpProfLeaseId ---------->
LineRRProvLeaseId ---------->
LineRRClientLeaseId -------->
numImaGroups --------------->
ImaGroupIndecies: 1
1
TRUE
0x02070000_00000057
0x02070000_00000055
0x02070000_00000056
1
Example 2 To display complete information about an IMA group, specify the group
number:
zSH> imarpshow 1
RP Info:
rp state -------------------> RP_INITIALIZED
address --------------------> 01:01:113
rp shelf -------------------> 1
rp slot --------------------> 1
rp ima core started --------> TRUE
imaGrpProfLeaseId ----------> 0x02070000_00000057
LineRRProvLeaseId ----------> 0x02070000_00000055
LineRRClientLeaseId --------> 0x02070000_00000056
numImaGroups ---------------> 1
ImaGroupIndecies: 1
IMA Group Index =1
..............................................
group status ==========> OOS
.........................
group ne state -------->
INSUFFICIENTLINKS
group fe state --------> OPERATIONAL
.........................
group ctlr state ------> GRP_INITIALIZED
group ifIndex ---------> 11
group in service ------> TRUE
driver attached -------> TRUE
driver unit -----------> 0
auto-created ----------> FALSE
ifxLeaseId ------------> 0x02070000_00000057
lineProfLeaseId -------> 0x02070000_00000057
lineGrpLeaseId --------> 0x02070000_00000057
ifStackLeaseId --------> 0x02070000_00000057
ds1LeaseId ------------> 0x00000000_00000000
.........................
ifxlateProfValid ----------------> TRUE
ifxlatProf.ifIndex --------------> 11
ifxlatProf.shelf ----------------> 1
ifxlatProf.slot -----------------> 1
ifxlatProf.port -----------------> 2
ifxlatProf.ifType ---------------> ATMIMA
ifxlatProf.adminStatus ----------> UP
.........................
lineProfValid -------------------> TRUE
lineProf.profileName ------------> Atm IMA Group default line profile
lineProf.physicalAddress.shelf --> 1
lineProf.physicalAddress.slot ---> 1
110
lineProf.physicalAddress.port ---> 2
lineProf.lineGroupName ----------> 11
.........................
lineGrpProfValid ----------------> TRUE
lineGrpProf.groupName -----------> 1/1/1
lineGrpProf.primaryName ---------> 11
lineGrpProf.secondaryName -------> 0
lineGrpProf.primaryWeight -------> 0
lineGrpProf.secondaryWeight -----> 0
lineGrpProf.adminState ----------> UP
.........................
imaGrpProfValid -----------------> TRUE
imaGrpProf.groupSymmetry --------> SYMMETRICAL
imaGrpProf.minNumTxLinks --------> 1
imaGrpProf.minNumRxLinks --------> 1
imaGrpProf.txClkMode ------------> CTC
imaGrpProf.txImaId --------------> 1
imaGrpProf.txFrameLength --------> M128
imaGrpProf.diffDelayMax ---------> 75
imaGrpProf.alphaValue -----------> 1
imaGrpProf.betaValue ------------> 1
imaGrpProf.gammaValue -----------> 1
imaGrpProf.testLinkIfIndex ------> 0
imaGrpProf.testPattern ----------> -1
imaGrpProf.testProcStatus -------> DISABLED
imaGrpProf.txTimingRefLink ------> 0
imaGrpProf.rxTimingRefLink ------> 0
.........................
Link#1
linkType -----------> DS1_PROFILE_LINETYPE_ESF
ifIndex ------------> 2
framerstatus -------> OOS
netxlinkstatus -----> NOT-IN-GROUP
nerxlinkstatus -----> NOT-IN-GROUP
..........................
...
...
...
Products MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723
imatppshow
Displays the status of an IMA test pattern procedure.This command is
available only when an uplink card with IMA support is installed.
Syntax imatppshow [group]
Options group
111
Commands
TestLink .....................: 2
imaGroupTestPattern ..........: 23
imaGroupTestProcStatus .......: OPERATING
Example 2 If the test fails (if, for example, the remote link is down),
DISABLED:
zSH> imatppshow 1
TestLink .....................: 2
imaGroupTestPattern ..........: 23
imaGroupTestProcStatus .......: DISABLED
Products MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723
initiateconfigsync
Initiates a manual update of the ZMS database with the devices
configuration. Config sync updates are performed automatically whenever a
change is made to the device via the CLI. During a restore, however, the
updating process is suspended. After a restore, a full config sync update is
required.
Note: Zhone recommends that you perform a config sync update
from ZMS. For more information, refer to the documentation that
came with the ZMS software.
Syntax initiateconfigsync [full | partial]
Options full
Sends all profiles to ZMS. This option could cause significant processing
by ZMS.
partial
Sends only the new or updated profiles to ZMS.
Access Level admin
Products BAN, MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723, Sechtor
100A, Z-Edge 64
interface
The interface command can add, delete, or show numbered and unnumbered
(floating) interfaces in different subnets.
112
float
Adds a floating or unnumbered IP interface with the specified IP address
and network mask.
add
Provides one-line configuration of IP interfaces, including the creation of
the ip-interface-record, if-translate, and atm-vcl records.
interfacename/type
Name and type of the physical interface.
vc vpi/vci
Used to specify the VPI and VCI values for ATM circuits. For example:
0/23.
td tdvalue | rxtd rxtdvalue txtd txtdvalue
Used to specify the traffic descriptor index to be used. Optionally,
separate rxtd rxtdvalue and txtd txtdvalue values may be specified for
ADSL connections, where separate traffic descriptors are used for the
upstream and downstream traffic due to the asymmetric nature.
tc tcvalue
Used only for PON interfaces to specify the traffic container index to be
used.
llc | other
The type of AAL5 data encapsulation used: llc sets logical link control
encapsulation over AAL5, which is commonly used with routers; other
sets RFC 1483 multiprotocol encapsulation over AAL5, which is
commonly used with bridges. If no value is given, the default llc is the
AAL5 encapsulation type.
vlan
Specifies the VLAN ID to apply to this interface.
slan
Specifies the SLAN (second VLAN) ID to apply to this interface.
cos
For tagged packets, specifies the value loaded into the priority field of the
VLAN header. Values are 0 to 7 with 0 the lowest priority and 7 the
highest. The default value is 0.
113
Commands
scos
For SLAN packets, specifies the value loaded into the priority field of the
VLAN header. Values are 0 to 7 with 0 the lowest priority and 7 the
highest. The default value is 0.
tosDisable/tosOrig//tosAll
delete
Removes all of the configuration done by the interface add command.
physicalInterface
Name and type of the physical interface, such as 1-4-3-0/hdsl2.
vpi/vci
Used to specify the VPI and VCI values for ATM circuits. For example:
0/23.
Syntax interface delete physicalInterface vpi/vci
a
Displays all provisioned interfaces, including floating (unnumbered)
interfaces and internal interfaces such as the loopback interface.
l
Displays the interface IfIndex values and flag information.
i
Displays just the specified interface.
114
Syntax
float
Removes the floating interface associated with the specified interface
name, IP address, and network mask.
Example 1
zSH> interface add 1-11-1-0/adsl vc 0/35 td 1 10.0.0.1 netmask 255.255.255.0
Example 2
zSH> interface delete 1-11-1-0/adsl vc 0/35
Example 3
zSH> interface show
579 interfaces
Interface
Status Rd/Address
Media/Dest Address
IfName
-------------------------------------------------------------------------------1/1/1/0/ip
UP
1 192.24.200.223/24
00:01:47:43:c0:38
ethernet1
1/1/1/0/ip
DOWN
1 [10.223.8.1]
0/772 multipoint
1-10-21-0-adsl-0-35
1/1/1/0/ip
DOWN
1 [10.223.8.1]
0/764 multipoint
1-10-13-0-adsl-0-35
1/1/1/0/ip
DOWN
1 [10.223.8.1]
0/756 multipoint
1-10-5-0-adsl-0-35
1/1/1/0/ip
DOWN
1 [10.223.8.1]
0/614 multipoint
1-9-4-0-adsl-0-35
1/1/1/0/ip
DOWN
1 [10.223.8.1]
0/530 multipoint
1-8-10-0-adsl-0-35
1/1/1/0/ip
DOWN
1 [10.223.8.1]
0/472 multipoint
1-7-29-0-adsl-0-35
1/1/1/0/ip
DOWN
1 [10.223.8.1]
0/446 multipoint
1-7-16-0-adsl-0-35
1/1/1/0/ip
DOWN
1 [10.223.8.1]
0/388 multipoint
1-6-35-0-adsl-0-35
1/1/1/0/ip
DOWN
1 [10.223.8.1]
0/304 multipoint
1-5-41-0-adsl-0-35
1/1/1/0/ip
DOWN
1 [10.223.8.1]
0/240 multipoint
1-5-9-0-adsl-0-35
1/1/1/0/ip
DOWN
1 [10.223.8.1]
0/220 multipoint
1-4-47-0-adsl-0-35
1/1/1/0/ip
DOWN
1 [10.223.8.1]
0/156 multipoint
1-4-15-0-adsl-0-35
1/1/1/0/ip
DOWN
1 [10.223.8.1]
0/72 multipoint
1-3-21-0-adsl-0-35
1/1/1/0/ip
DOWN
1 [10.223.8.1]
0/1092 multipoint
1-14-44-0-adsl-0-35
1/1/1/0/ip
DOWN
1 [10.223.8.1]
0/1044 multipoint
1-13-27-0-adsl-0-35
1/1/1/0/ip
DOWN
1 [10.223.8.1]
0/960 multipoint
1-12-33-0-adsl-0-35
<SPACE> for next page, <CR> for next line, A for all, Q to quit
Example 4 This example adds interface 1-8-13-0/adsl with a COS value of 7.
interface add 1-8-13-0/adsl vc 0/35 td 20000 other vlan 1 cos 7 23.23.23.23
255.255.255.0
Example 5 This example adds interface 1-8-13-0/adsl with a COS value of 1 and
specifies to add this value to all packets originating from this interface.
interface add 1-8-13-0/adsl vc 0/35 td 20000 other vlan 1 cos 1 tosOrig 1
23.23.23.23 255.255.255.0
Example 6 This example adds interface 1-8-13-0/adsl with a COS value of 5 and
115
Commands
Example 7 This example adds interface 1-8-13-0/adsl and disables the TOS feature.
interface add 1-8-13-0/adsl vc 0/35 td 20000 other tosDisable 23.23.23.23
255.255.255.0
Example 8 This example adds a floating (unnumbered) interface using the name IP210
ip igmpstat
Displays the IGMP statistics.
Syntax ip igmpstat active | summary
Options active
100A, Z-Edge 64
ip ifstat
Displays the interface statistics. The statistics are complete only for the
interfaces that exist on the card. Virtual or non-local interfaces will not show
received packets.
116
rxpkt
14392
56187
txpkt
14392
13742
rxmc
0
42460
sqdp
0
0
100A, Z-Edge 64
ip ifsum
Displays a summarized list of interfaces known to the card.
Syntax ip ifsum [ifname]
Options ifname
100A, Z-Edge 64
117
Commands
ip inetstat
Displays the active TCP/UDP/RAW endpoints terminating on this card.
Syntax ip inetstat [-s]
Options -s
MAMADom
-------0
0
0
0
0
0
0
0
0
0
0
100A, Z-Edge 64
ip ipstat
Displays the IP statistics.
Syntax ip ipstat [clear]
118
Options clear
100A, Z-Edge 64
ipsla
Add, modify, display, and delete IPSLA features.
Syntax ipsla add | modify | delete | show | stats
119
Commands
Add, modify, show, and delete the global IPSLA settings for state and
polling interval.
cos-action cosactionindex index [name | trap | timeouts | latency | jitter |
pktsize]
Add, mode, show, and delete cosactionindex settings. Index values are
1-8. The following cosactionindex values can be set: name, traps,
timeouts, latency, jitter, pktsize.
cos-map dscpindex index cosactionindex index
Add, modify, show, and delete the cosactionindex and DSCP index
mapping. Values are 1-64.
path ipaddress ipadress [forwarding enable|disabled] [state state]
Add, modify, show, and delete IPSLA paths for the specified IP address.
stats [path ipaddress] [ipaddress ipaddress] | [cos cosactionindex index|
ipaddress ipaddress] [history cosactionindex index | ipaddress ipaddress |
index index]
Display statistics for all paths, paths for a specified IP address,
cosactionidex or cos index.
ip tcpstat
Displays the TCP statistics.
Syntax ip tcpstat
Example The following example displays the current TCP statistics:
zSH> ip tcpstat
TCP:
20071 packets sent
10457 data packets (4305315 bytes)
1 data packet (7 bytes) retransmitted
9531 ack-only packets (1 delayed)
0 URG only packet
0 window probe packet
47 window update packets
35 control packets
20103 packets received
10366 acks (for 4305330 bytes)
43 duplicate acks
0 ack for unsent data
9817 packets (4150800 bytes) received in-sequence
3 completely duplicate packets (6 bytes)
0 packet with some dup. data (0 byte duped)
5 out-of-order packets (0 byte)
0 packet (0 byte) of data after window
0 window probe
49 window update packets
0 packet received after close
0 discarded for bad checksum
0 discarded for bad header offset field
120
100A, Z-Edge 64
ip udpstat
Displays the UDP statistics.
Syntax ip udpstat
Example The following example displays the current UPD statistics:
zSH> ip udpstat
UDP:
20323 total packets
12221 input packets
8102 output packets
0 incomplete header
0 bad data length field
0 bad checksum
4116 broadcasts received with no ports
0 full socket
0 allocated but not bound drops
8100 pcb cache lookups failed
0 pcb hash lookup failed
0 mama cache lookup failed
0 packets flung to other card
zSH>
Access Level admin
Products BAN, MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723, Sechtor
100A, Z-Edge 64
121
Commands
ip arpdelete
Deletes an entry from the ARP table.
Syntax ip arpdelete ipaddress
Options ipaddress
100A, Z-Edge 64
ip arpflush
Flushes the ARP table of all entries.
Syntax ip arpflush
Example The following example flushes the ARP table of all entries:
zSH> ip arpflush
QQQ
zSH>
Access Level admin
Products BAN, MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723, Sechtor
100A, Z-Edge 64
ip arpshow
Displays the ARP table.
Syntax ip arpshow
Example The following example displays the ARP table:
zSH> ip arpshow
LINK LEVEL ARP TABLE
destination
gateway
flags Refcnt Use
Interface
-------------------------------------------------------------------------172.16.80.201
08:00:20:b1:9a:ab
405
0
8102
1-2-1-00
172.16.80.252
08:00:20:b8:f8:20
405
0
2089
1-2-1-00
172.16.80.254
00:02:16:75:3b:e1
405
1
0
1-2-1-00
-------------------------------------------------------------------------7 routes, 3 arp routes
122
100A, Z-Edge 64
L
lineGroup
Displays the line group number of the interface.
Syntax linegroup index
Options index
100A, Z-Edge 64
line-red
Sets the redundancy behavior of Ethernet lines so Ethernet uplink cards, such
as GigE card, will switchover from an active to a standby card when the active
link goes down. The standby card must be in a running state for the
switchover to occur.
Syntax line-red set | clear | show ifname/type [timeout seconds]
[revertive | nonrevertive] [timeout seconds]
Options set
123
Commands
timeout seconds
Specifies the amount of time to wait after a failure occurs before
performing the switchover. If no timeout value is specified, a value of 0 is
used.
revertive
After a redundancy switchover occurs and the failure is resolved, this
setting forces the currently active card to wait the specified timeout period
and then reboot to return traffic back to the other card.
nonrevertive
After a redundancy switchover occurs and the failure is resolved, this
setting allows the currently active card to remain active, until another
redundancy switchover occurs.
timeout seconds
Specifies the amount of time to wait after a failure is resolved before the
revertive switch is performed. If no timeout value is specified, a value of
0 is used.
Example 1 This example enables redundancy on the ethernet1 physical interface with
list
Displays system profiles or records.
Syntax list [ profile-type ] [ * ]
Options (no options)
124
*
A wildcard that can be added anywhere in the command line after the list
command:
If it is the only option, it lists all records in the system, along with their
index values.
When added after profile-type, it lists all the records of that type, along
with their indexes.
When added as part of the profile-index, it lists all the profiles matching
the specified index elements.
Example 1 The following example displays the available profiles:
zSH> list
aal2-audio-profile: audioProfileIdentifier/apIndex
aal2-cid-profile: ifIndex/vpi/vci/cid
aal2-vcl-profile: ifIndex/vpi/vci
adsl-co-profile: shelf/slot/port
adsl-cpe-profile: shelf/slot/port
adsl-profile: shelf/slot/port
atm-cc: atmVcCrossConnectIndex
atm-if: ifIndex
atm-if-stats: ifIndex
atm-traf-descr: index
atm-traf-descr-idx-next: index
atm-traf-descr-stats: index
atm-vcl: ifIndex/vpi/vci
atm-vcl-param: index
atm-vcl-stats: ifIndex/vpi/vci
atm-vpi: ifIndex/vpi
atm-vpl: ifIndex/vpi
bulk-statistic: index
bulk-statistics-config: index
<SPACE> for next page, <CR> for next line, A for all, Q to
quit
Example 2 The following example displays the atm-vcls configured on the system:
zSH> list atm-vcl
atm-vcl 1-7-4-0-ds3/atm/0/101
atm-vcl 1-7-4-0-ds3/atm/0/102
atm-vcl 1-9-2-0-hdsl2/atm/0/35
atm-vcl 1-9-4-0-hdsl2/atm/0/35
atm-vcl 1-5-1-0-sonet/atm/0/301
atm-vcl 1-7-4-0-ds3/atm/0/301
atm-vcl 1-7-4-0-ds3/atm/0/103
atm-vcl 1-15-1-0-ds3/atm/0/103
atm-vcl 1-15-1-0-ds3/atm/0/104
atm-vcl 1-9-6-0-hdsl2/atm/0/36
atm-vcl 1-9-6-0-hdsl2/atm/0/35
atm-vcl 1-15-1-0-ds3/atm/1/104
atm-vcl 1-7-4-0-ds3/atm/0/104
atm-vcl 1-15-1-0-ds3/atm/1/105
atm-vcl 1-9-6-0-hdsl2/atm/0/37
125
Commands
atm-vcl 1-7-4-0-ds3/atm/1/201
atm-vcl 1-5-1-0-sonet/atm/1/201
atm-vcl 1-7-4-0-ds3/atm/1/202
atm-vcl 1-5-1-0-sonet/atm/1/202
<SPACE> for next page, <CR> for next line, A for all, Q to
quit
Example 3 The following example displays all the records configured on the system:
zSH> list *
aal2-audio-profile 7/1
aal2-audio-profile 7/2
aal2-audio-profile 7/3
aal2-audio-profile 8/1
aal2-audio-profile 8/2
aal2-audio-profile 9/1
aal2-audio-profile 10/1
aal2-audio-profile 10/2
aal2-audio-profile 11/1
aal2-audio-profile 11/2
aal2-audio-profile 12/1
aal2-audio-profile 12/2
aal2-audio-profile 12/3
atm-cc 14
atm-cc 5
atm-cc 6
atm-cc 7
atm-cc 8
atm-cc 1
<SPACE> for next page, <CR> for next line, A for all, Q to
quit
Example 4 The following example displays all the if-translate profiles associated with
shelf 1, slot 1:
zSH> list if-translate 1/1/*
if-translate 1-1-1-0/ethernetcsmacd
if-translate 1-1-1-0/rs232
if-translate 1-1-1-0/ip
3 entries found.
Access Level admin
Products BAN, MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723, Sechtor
100A, Z-Edge 64
See Also get, show
load
Loads new software onto the system.
126
log
Configures logging levels for messages on the system. The system sends log
messages to a management session (either on the console or over a telnet
session), a log file on the device, and, optionally, a syslog server.
The log command configures the type of information sent in these messages.
By default, the system sends the same type of information to all log message
destinations, and logging is disabled on both the serial craft port and over
telnet sessions.
If the messages sent to the syslog server are configured the same as the log
messages sent to the console or the persistent storage (the default) the log
command also configures the syslog message contents. If the syslog messages
have been modified (using the log-module profile or the syslog command),
use the syslog command to modify syslog levels.
Syntax log help
help
Displays the help menu.
127
Commands
show
Displays the currently configured logging levels for each software
module.
Syntax log level module level
module
The system module to set the level for. Use the log show command to
display all the system modules.
level
Sets the logging level for the specified module. Logging levels are:
1 emergency
2 alert
3 critical
4 error
5 warning
6 notice
7 information
8 debug
You can specify either the name of the level or the number.
Syntax log option type [ on | off ]
enable module
Enables logging for the specified module. Use the log show command to
display all the system modules and whether they are enabled or not.
disable module
Disables logging for the specified module.
Syntax log session [on | off]
on
Enables logging for the current session only.
off
128
on
Enables logging on the serial craft port. This setting persists across
reboots.
off
Disables logging on the serial craft port. This setting persists across
reboots.
Syntax log display
Note: The cache option is only supported on the BAN, MALC, and
Raptor.
log cache
Displays the log cache.
log cache max length
Sets the maximum number of log messages to store. The maximum log
cache size is 2147483647, depending in the amount of memory available.
log cache grep pattern
Searches through the log cache for the specified regular expression.
log cache clear
Clears the log cache.
log cache size
Sets the maximum amount of memory for the log cache. Without options,
displays the current log size.
log cache help
Displays help on the log cache command.
Example 1 The following example displays the logging levels and enabled status for the
system modules:
zSH> log show
MODULE
message
taskclock
card
bds_client
alarm_mgr
tnsxmgt
leaseapi
vcs-client
LEVEL
error
error
error
error
error
error
error
error
STATUS
enabled
enabled
enabled
enabled
enabled
enabled
enabled
enabled
129
Commands
dirserclient
rebootserver
pcmciadiag
...
...
...
error
error
error
enabled
enabled
enabled
Example 2 The following example sets the logging level for the card module to
information:
zSH> log level card info
Module: card at level: information
Example 3 zSH> log option ticks on
time: date: level: address: log: port: category: system:
ticks: (0xf07)
Example 4 The following example shows how to configure what information to include
in log messages.
zSH> log option all on
time:date:level:address:log:taskname:taskid:file:function
:line:(0xff)
Example 5 To return the log messages to their default format, enter the following
command:
zSH> log option default on
time: date: level: address: log: taskname:
(0xf)
100A, Z-Edge 64
See Also syslog
log filter
Restrict the display of log messages to only the log messages for a specified
entity. Enables users to create, show, and delete log filters.
130
logout
Terminates the current session. If a previous user is still connected as an
inactive user of the current session, the previous user becomes the active user
of the session. If there is only one user connected in current session, the
logout command terminates the connection. If the session is over the local
serial port, the current user is logged out and the system prompts appears.
Syntax logout
Example The following example shows logging out from a local serial port session:
zSH> logout
Connecting...........
Tips:(`lst' 2 list)(`find' 2 search)(`s' 2 skip)
User Name:
Access Level user
Products BAN, MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723, Sechtor
100A, Z-Edge 64
131
Commands
lst
Lists available commands.
Syntax lst [ -m ]
Options
With no option, displays all the available commands for the current user.
If a search has been performed using the find command, and the -m
option has not been specified since the search was performed, the lst
command displays only the results of the most recent search.
-m
Lists all commands, not just the results of the previous search.
Example The following example shows the lst command with no search results:
zSH> lst
?
ata
cd
commit
create
delete
dir
eeset
featurebitdisplay
fhrameping
filter
find-matching-subvoice
help
ifxlate
initiateconfigsync
list
log
lst
msg
ping
pwd
resetpass
Type A<CR> to print all, <CR> to
adduser
bootstate
changepass
copy
del
deleteuser
dump
eeshow
featurebitset
file
find
get
history
image
interface
load
logout
mkdir
new
pollzhonecpe
resetcliprov
restore
continue, Q<CR> to stop:
100A, Z-Edge 64
See Also find
132
M
mcast
Displays multicast control lists.
Syntax mcast show mcl [ entry | precedence ]
Options entry
224.10.10.11
224.10.10.12
control lists.
Products MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723
mkdir
Creates a directory on the system card flash card file system.
Syntax mkdir directoryname
Access Level admin
Products BAN, MALC
See Also rmdir
msg
Enables users to send text messages to a specific user, or to all users currently
logged into the system.
Syntax msg [ username | all ]
message
133
Commands
Options username
Results in the following message being sent to every user logged into the
system:
Msg: root: please log off.
Access Level user
Products BAN, MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723, Sechtor
100A, Z-Edge 64
134
135
Commands
ILG1=0.000034 A
ILG2=0.000077 A
Voltage Saturation=Yes
CMC Degradation=No
-----------------------------------------------------Successful - Returned to operational state
zSH>
Access Level user
Products MALC
N
new
Creates new records of the specified profile type.
Syntax new profile-type index
Options profile-type
136
After entering the values, the system displays the values you have entered and
prompts you to save the record. If you want to save the changes, press s. If
you want to make changes, press c to re-enter values. Press q to quit without
saving changes.
Access Level admin
Products BAN, MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723, Sechtor
100A, Z-Edge 64
See Also delete, update
P
ping
The ping command uses an ICMP ECHO_REQUEST datagram to elicit an
ICMP ECHO_RESPONSE from the specified host or network gateway. The
ping command can be interrupted by pressing any key during its operation.
Syntax ping [-c rxcount] [-i txwait ] [ -s packetsize ]
[-w timeout] [-t] [-h] host [-l] ip address
Options -c rxcount
137
Commands
-t
Continue the ping until it is interrupted by the user.
-h
Display the hostname of the source for any returned ICMP packet instead
of the network address.
host
Host name or IP address of destination host.
-l
Use source based routing to determine the interface to send ping out on.
Example 1 The following example shows the ping command able to successfully reach
the destination:
zSH> ping ietf.org
PING ietf.org (132.151.1.19): 64 data bytes
!!!!!
----ietf.org PING Statistics---5 packets transmitted, 5 packets received
round-trip (ms) min/avg/max = 80/99/160
Example 2 The following example shows the ping command unable to reach the
destination:
zSH> ping 192.168.211.2
PING 192.168.211.2: 64 data bytes
UUUUU
----192.168.211.2 PING Statistics---5 packets transmitted, 0 packets received, 100% packet
loss
Example 3 zSH> ping -l 10.10.203.2 10.10.203.1
PING 10.10.203.1: 64 data bytes
!!!!!
----10.10.203.1 PING Statistics---5 packets transmitted, 5 packets received
round-trip (ms) min/avg/max = 10/10/10
zSH>
Access Level user
Products BAN, MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723, Sechtor
100A, Z-Edge 64
See Also Telnet, traceroute
pollzhonecpe
The pollzhonecpe command polls attached Zhone customer premises
equipment (CPE) devices to determine their status.
Syntax pollzhonecpe
Example zSH> pollzhonecpe
138
powermon
Displays the power monitoring status for the ZRG. Command output strings
are:
No battery
No UPS
Low Charge
Bad Battery
Normal Power
(Normal power)
zSH> powermon
Power Status:
(No Battery)
zSH> powermon
Power Status:
(On battery)
zSH> powermon
Power Status:
pwd
Displays the current directory on the system flash card file system.
Syntax pwd
139
Commands
R
resetcliprov
Enables provisioning from a CLI session. Provisioning using the CLI is
usually enabled, except when the device is being managed by ZMS.
Syntax resetcliprov [ index | all ]
Options index
Re-enables CLI provisioning for the specified CLI session. CLI session
indexes are displayed in the output of the who command.
all
Re-enables CLI provisioning for all active CLI sessions.
Access Level admin
Notes CLI provisioning is automatically disabled after logging out of the session.
Products BAN, MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723, Sechtor
100A, Z-Edge 64
See Also setcliprov
resethold
The resethold command puts a card into a persistent non-operational state.
The physical card, card profiles and provisioning are retained.
Syntax resethold shelf slot-list, [slot-range]
Options shelf
140
resetpass
Resets a user password.
Syntax resetpass username
Options username
(newpassword):
zSH> resetpass jjsmith
Password: newpassword the password is not displayed on the screen
Access Level useradmin
Products BAN, MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723, Sechtor
100A, Z-Edge 64
See Also changepass
resetrelease
Release a card from hold status, after the resethold command was used.
Syntax resetrelease shelf slot
Options shelf
restore
Restores a previously saved Zhone system configuration.
Syntax restore [console] | [ network host filename ] | [ file
filename ] | [validate filename]
Options console
141
Commands
file filename
Restores the configuration from specified file on the flash card. You must
specify the full path to the file. This option is only available on the BAN
and the MALC.
validate filename
Parses the specified restore file to check for syntax errors. When an error
is encountered, it prints out error information including line number of the
error. This command does not write any information to the database.
Example restore validate /card1/onreboot/restore
Access Level useradmin
Products MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723
See Also dump
rip
Administers how routing information protocol (RIP) operates on Zhone
devices.
Syntax The following command enables or disables RIP for the entire system.
rip [domain domain-spec] enable|disable
domain domain-spec
Specifies the routing domain. Only domain 1 is supported.
enable
Enables RIP.
disable
Disables RIP (the default).
Syntax The following command displays the administrative and operational status of
RIP.
rip domain domain-spec show
domain domain-spec
The domain spec identifies the IP address range of the subnet. One (1) is
the only supported value.
show
Displays RIP information for the system.
Syntax The following command specifies the interval between RIP advertisements.
rip domain domain-spec timer seconds
domain domain-spec
Specifies the routing domain. Only domain 1 is supported.
timer seconds
142
an interface.
rip [domain domain-spec] interface interface-address talk
v1 | v1compat | v2 | disabled
domain domain-spec
Specifies the routing domain. Only domain 1 is supported.
interface interface-address
Interface address to transmit RIP advertisements on.
talk v1 | v2 | v1v2 | disabled
The type of RIP packets to transmit:
v1: RIP version 1 advertisements
v1v2: RIP version 2 advertisements using RFC 1058 subsumption rules
v2: RIP version 2 advertisements
disabled: RIP advertisements disabled (default)
Syntax The following command specifies the type of interface to receive on an
interface.
rip [domain domain-spec] interface interface-address
listen v1 | v1v2 | v2 | disable
domain domain-spec
Specifies the routing domain. Only domain 1 is supported.
interface interface-address
Interface address to receive RIP advertisements on.
listen v1 | v2 | v1v2 | disabled
The type of RIP packets to receive:
v1: RIP version 1 advertisements
v1v2: RIP version 1 and version 2 advertisements
v2: RIP version 2 advertisements
disabled: RIP advertisements disabled (the default)
Syntax The following command specifies whether poison-reverse updates are
transmitted on an interface.
rip [domain domain-spec] interface interface-address
poison on | off
domain domain-spec
Specifies the routing domain. Only domain 1 is supported.
interface interface-address
Interface address to transmit poison-reverse RIP advertisements on.
poison on | off
On enables poison reverse updates.
143
Commands
Off disables poison reverse updates. In this case, the system uses
split-horizon updates. The default is off.
Syntax The following command specifies the default metric value to be advertised for
an interface.
rip [domain domain-spec]
metric metric-number
interface interface-address
domain domain-spec
Specifies the routing domain. Only domain 1 is supported.
interface interface-address
Interface address to assign a metric to.
metric metric-number
Metric number for an interface.
Access Level admin
Products BAN, MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723, Z-Edge 64
See Also route
rmdir
Removes a directory.
Syntax rmdir directory
Options directory
romversion
Displays the read-only memory (ROM) version of a slot card.
Syntax romversion 1-17
Example 1 The following example displays the ROM version of an Ethernet card in slot
17:
Example 2 zSH> romversion 4
MALC CAN 1.10.0.6
Jun 21 2004, 13:11:49
Access Level user
Products BAN, MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723
See Also swversion
144
route
Administers the routing information base (RIB). The route add and route
delete commands take a keyword called source which indicates that a source
route is used and must to added or removed from the source routing table. The
user must also specify the IP interfaces of the next hop.The route show
command now accepts an optional keyword of either source or destination
which specifies the type of routing table is to be displayed. If the keyword is
not used, both source and destination routing tables are displayed.
Syntax The following command displays the forwarding information base.
route [domain domain-spec] [list] show
[source|destination]
domain domain-spec
Specifies the routing domain. Only domain 1 is supported.
list
Displays all provisioned static routes.
show
Displays the routes in the route domain for source and destination routing.
Syntax The following command adds a high-preference static route for the
domain domain-spec
Specifies the routing domain. Only domain 1 is supported.
source
Indicates that a source address based route is being added. The interface
is the name of the outbound (egress) interface for this route (minus the /ip
suffix).
destination-address netmask
Adds a static route with the specified destination and network mask.
nexthop-address
IP address of the next hop.
145
Commands
nexthop-interface
Interface for the next hop. This is valid only when the next-hop address is
0.0.0.0. Otherwise, this should be 0 (zero). This option is currently
unsupported.
metric
A numeric value specifying the metric for the route. Lower metrics
indicate more preferred routes.
nexthop2
IP address of the fallback or redundantnext hop.
ping-interval
The ping interval with a minimum of 500 milliseconds to a maximum of
60000 milliseconds (1 minute).
ping-fail-max
The minimum retry count is 2 and maximum retry count is 10.
maxretry
The max retry (fail) count for the pings. When this limit is reached, the
fallback nexthop is used.
Syntax The following command deletes a static route from the system routing table.
The word default may be substituded for a 0.0.0.0 destination and mask. The
fallback and nexthop2 options must be specified to delete routes configured
with fallback routes.
route [ domain domain-spec ] delete [source]
destination-address netmask nexthop-address
nexthop-interface [fallback nexthop2 ping-interval
ping-fail-max]
domain domain-spec
Specifies the routing domain. Only domain 1 is supported.
source
Specifies that a source address based route is being removed. The
interface is the name of the outbound (egress) interface for this route
(without the /ip suffix).
destination-address netmask
Deletes the destination address and netmask from the routing table.
nexthop-address
IP address of the next hop address.
nexthop-interface
Interface for the next hop. This is valid only when the next-hop address is
0.0.0.0. Otherwise, this should be 0 (zero). This option is currently
unsupported.
nexthop2
IP address of the fallback or redundantnext hop.
ping-interval
146
147
Commands
Dest
Nexthop
Cost
Owner
Interface
--------------------------------------------------------------------------Destination Routing Table
Dest
Nexthop
Cost
Owner
Fallback
--------------------------------------------------------------------------0.0.0.0/0
192.168.34.254
1
STATICLOW
10.10.1.0/24
192.168.34.254
1
STATIC
192.168.34.201
192.168.34.0/24
1/1/1/0/ip
1
LOCAL
zSH> route delete source 198.168.1.1 255.255.255.255 198.168.1.101
uplink1-0-36
zSH>
zSH> route delete 10.10.1.0 255.255.255.0 192.168.34.254 fallback \
192.168.34.201
Access Level admin
Products BAN, MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723, Sechtor
100A, Z-Edge 64
See Also rip
rpr
Displays information about the resilient packet ring (RPR) configuration. This
command is available only when an GigE uplink card with RPR support is
installed.
Syntax rpr show topo | stats | config | status
Options topo
148
1
2
3
4
00:01:47:59:1f:ea
00:01:47:5d:b0:f1
00:01:47:59:1f:f3
00:01:47:5c:34:59
tt
tt
tt
tt
ff
ff
ff
ff
IDL
IDL
IDL
IDL
IDL
IDL
IDL
IDL
0x00
0x00
0x00
0x00
0x04
0x0a
0x0c
0x0d
00:01:47:59:1f:f3
00:01:47:5d:b0:f1
00:01:47:59:1f:ea
00:01:47:5c:34:59
tt
tt
tt
tt
ff
ff
ff
ff
IDL
IDL
IDL
IDL
IDL
IDL
IDL
IDL
0x00
0x00
0x00
0x00
0x0c
0x0a
0x04
0x0d
The output of the rpr show topo command displays the information for each
ringlet (MacAddress_0 for ringlet 0; and MacAddress_1 for ringlet 1). The
fields are described in the table below.
Field
Description
total number of ring nodes The total number of nodes on the ring. On an unbroken
ring, the number of nodes on each ringlet will be equal.
ring protection
ring topology
hops
MacAddress_x
PSW/PSE
149
Commands
Field
Description
prot/pref
Example 2 This example shows that east span is broken on the current node:
zSH> rpr show topo
total number of ring nodes= 3 (ringlet 0= 2, ringlet 1= 0)
ring protection= STEERING, ring topology= OPEN ring
V=valid; R=reachable; E=ringlet edge states; PSW/PSE=protect state; prot/pref=raw
values
hop ----macAddr_0---- VR EE PSW PSE prot pref ----macAddr_1--- VR EE PSW PSE prot/pref
0 00:01:47:5a:aa:1a tt ft IDL SF 0x44 0x09
1 00:01:47:5a:aa:22 tt ff IDL IDL 0x00 0x05
2 00:01:47:5a:aa:2a tt tf SF IDL 0xa0 0x06
Notice the PSE (protection span east) for the current node (hop 0) is SF
(signal failure) and its neighbor across the broken span (hop 2) agrees since its
PSW (protection state west) is also SF.
Example 3 This example shows that span is broken between the other 2 nodes in the ring:
zSH> rpr show topo
total number of ring nodes= 3 (ringlet 0= 1, ringlet 1= 1)
ring protection= STEERING, ring topology= OPEN ring
V=valid;R=reachable;E=ringlet edge states;PSW/PSE=protect state; prot/pref=raw values
hop ----macAddr_0-- VR EE PSW PSE prot pref ----macAddr_1-----VR EE PSW PSE prot/ pref
0 00:01:47:5a:aa:1a tt ff IDL IDL 0x00 0x0d
1 00:01:47:5a:aa:22 tt tf SF IDL 0xa0 0x06 00:01:47:5a:aa:2a tt ft IDL SF 0x44 0x09
Notice the PSW (protection span west) and the PSE (protection span east) for
the current node is IDL (link up), but that the PSW for the upstream node
(hop 1) is SF (signal failure) and its neighbor agrees since its PSE (protection
state east) is also SF.
Access Level user
Products MALC, Raptor
S
sar8260
The sar8260 command shows operational and status information about the
Sechtor 100A ATM 8260 driver. This command can be used only after the
ATM driver is added to the system log list.
For more information about system logging, see the log show, log level and
showtask command descriptions.
150
Note: The Sechtor 100A can only perform sar8260 ping when
connected to IADs that support OAM F5 loopbacks.
Syntax sar8260
startLog
This option entered after the sar8260 command will enable log messages.
Once enabled, the log level can be set with the log level command.
stopLog
This option used with the sar8260 command will disable log messages.
Syntax log level sar8260 log level
sar8260
Use sar8260 as a modifier with the log level command to set the level of
logging for the Sechtor 100A ATM driver. Log level NOTICE will log
AAL2 control packets. Log level INFO will log AAL2 voice packet
headers. Log level DEBUG will log AAL2 voice packet payloads.See the
example, below.
Syntax sar8260
stats
This level of ATM driver logging shows high-level information about the
Sechtor 100A ATM driver.
stats vpi vci
Using the VPI and VCI address with the sar8260 command displays
statistics only for the Virtual Circuit (VC) with this address.
stats vpi vci cid
Using the sar8260 command with the VPI VCI and CID numbers gives
information about the ATM driver at the CID level.
Syntax sar8260 ping vpi vci
vpi
VPI to ping.
vci
VCI to ping.
Example 1 This is an example of a sar8260 ping:
zSH> sar8260 ping 0 501
Pinging vpi 0, vci 501 ..
zSH> Ping response received from vpi 0, vci 501
Example 2 This example shows the sar8260 command with the startLog option.
zSH> sar8260 startLog
Example 3 This example shows the log level options.
151
Commands
emergency
alert
critical
error
warning
notice
information
debug
|
|
|
|
|
|
|
|
1
2
3
4
5
6
7
8
>
>
>
>
>
>
>
>
Example 4 The following example sets the log level for the 8260 ATM driver at the
notice level
zSH> log level sar8260 notice
Module: sar8260 at level: notice
Example 5 This example shows the result of using the stats modifier with the sar8260
CPS Rx........ 0
SAR Rx........ 11313
OAM Rx........ 0
Inv. Vc....... 0
txInt......... 46164
swWarnCount... 0
59
0
0
33033
0
13136
7825
0
0
0
Open CIDs..........
Cumulative Calls...
Voice Rx...........
CAS Rx.............
Alarm Rx...........
I3661 Rx...........
314
0
0
0
0
11130
Errors............. 13
RP CFs............. 0
TxVoiceDrop.........0
Example 6 This example shows the statistics displayed when a VPI of 0 (zero) and a VCI
152
CC...... 258
PCR.......
DelyPcr. 182
pcrTick...
Tx...... 9112780
Tx Err....
CPS Rx.. 9103499
SAR Rx....
CPS Errs 1
RxPAR... 0
RxSEQ.....
RxHEC... 0
RxLEN.....
RxOVL... 0
RxSPL.....
SAR Errs 10
RxRTE... 0
RxSDU.....
RxLast.. 1769
RxNotL....
noBuf... 0
badLength.
OAM State: ENABLED
Tx OAM.. 10775
Rx OAM....
ATM AAL2 VC Statistics
Open CIDs.......... 13
Active Calls....... 0
Voice Tx........... 9111039
Voice Tx Errors.... 0
CAS Tx Requests.... 0
CAS Tx Redundant... 0
CAS Tx Refresh..... 0
CAS Tx Errors...... 0
Alarm Tx........... 0
Alarm Tx Errors.... 0
I3661 Tx........... 1741
I3661 Tx Errors.... 0
Type 3 CRC Errors.. 0
IllegalUUI......... 0
182
0
0
1769
Rx Errs.. 0
1
0
0
RxOSF.... 0
RxBusy... 0
0
0
0
RxOS..... 0
299
Faults... 4
Pending Events.....
Cumulative Calls...
Voice Rx...........
Voice Rx Errors....
CAS Rx Delivered...
CAS Rx Redundant...
CAS Rx Refresh.....
CAS Rx Errors......
Alarm Rx...........
Alarm Rx Errors....
I3661 Rx...........
I3661 Rx Errors....
OOS Conditions.....
IllegalCID.........
0
5
9103499
0
0
0
0
0
0
0
1769
(n/a)
0
0
The OAM State field in the response details the status of VCL fault detection.
Possible values for the OAM State field include:
Example 7 Using the sar8260 command with the VPI, VCI, and CID numbers gives
153
Commands
Channel Type.......
Active.............
Voice Tx...........
Voice Tx Errors....
CAS Tx Requests....
CAS Tx Refresh.....
CAS Tx Redundant...
CAS Tx Errors......
Alarm Tx...........
Alarm Tx Errors....
Type 3 CRC Errors..
POTS
0
0
0
1
115
3
0
0
0
0
Status.............
Cumulative Calls...
Voice Rx...........
Voice Rx Errors....
CAS Rx Delivered...
CAS Rx Refresh.....
CAS Rx Redundant...
CAS Rx Errors......
Alarm Rx...........
Alarm Rx Errors....
OK
0
0
0
0
0
0
0
0
0
Example 8 Issue the sar8260 command with the dchannelcids option to view CIDs
selftest
Runs diagnostics on the device.
Caution: Running a diagnostics test can interrupt traffic on the card.
index
The user-defined index number of the test to run.
repetition
Number of times to repeat the test.
type
Type of test to run. The possible tests are:
Table 8: Supported diagnostics
154
Test
Devices supported
Back Plane Test verifies the card can access the back
plane by verifying the back plane EEPROM checksum.
All
Devices supported
Fhrame Bus Test verifies the card can access the fhrame
bus by executing a loopback test.
Flash Test verifies the card can access the PCMCIA flash
card I/O by creating, writing, and reading a 4000-byte file.
155
Commands
Devices supported
All
start
Starts the specified test.
Syntax selftest stop index repetition type
stop
Stops the specified test.
Syntax selftest del index repetition type
del
Deletes the specified test.
Syntax selftest list
list
Lists test results.
Example 1 To display the tests on a MALC:
zSH> selftest list
Name
Id FuncPtr
Record Time Status
Details
------------------------------------------------------------Flash-1 5 0x075760 0x2f8fae8
30
PASS Flash:1 shelf:1 slot:1
Shelf Mon 9 0x180bdc 0x2a54070
15
PASS Shelf:1 slot:1.
Supv Lpbk 2 0x1807e4 0x2b24000
15
PASS Wr:0x5aa5 rd:0x00a5 shelf:1 sl
Fan Tray 8 0x1809dc 0x2b24090
15
PASS FANTRAY EEPROM checksum shelf:
Lamp Test 6 0x1805e0 0x27f7700
10
PASS Shelf:1 slot:1.
Card EEprom 3 0x226cd4 0x27f7670
5
PASS CARD EEPROM checksum slot:1.
Daughter-1 13 0x226cd4 0x2b42f20
5
PASS 1DAUGHTER EEPROM checksum slot
Back Plane 12 0x226cd4 0x27f75e0
5
PASS BACKPLANE EEPROM checksum slot
RT Clock 7 0x226cd4 0x27ef590
5
PASS RTC POST slot:1
List memory allocated: 972 bytes.
Example 2 To display the tests on a BAN:
zSH> selftest list
156
Name
Id FuncPtr
Record Time Status
Details
------------------------------------------------------------Flash-1 5
0x212118 0x7dcfad0
30
PASS Flash:1 shelf:1 slot:3
Flash-2 5 0x21229c 0x7dcfa40
30
FAIL Flash:2 card absent.
Shelf Mon 9 0x22d8f8 0x7b92350
15
PASS Shelf:1 slot:3.
Supv Lpbk 2 0x22d4cc 0x7babb80
15
PASS Wr:0x5aa5 rd:0x00a5 shelf:1 sl
Fan Tray 8 0x22d6dc 0x7bac5f0
15
PASS FANTRAY EEPROM checksum shelf:
Lamp Test 6 0x22d2b0 0x7bac090
10
PASS Shelf:1 slot:3.
frbus-1 4 0x2a1a70 0x7b14d70
30
PASS Fhramelpbk> shelf:1 slot:3 frb
frbus-2 4 0x2a1a70 0x7b1dba0
30
PASS Fhramelpbk> shelf:1 slot:3 frb
frbus-3 4 0x2a1a70 0x7b14980
30
PASS Fhramelpbk> shelf:1 slot:3 frb
Card EEprom 3 0x358170 0x7b1dcc0
5
PASS CARD EEPROM checksum slot:3.
Mid-Plane 13 0x358170 0x7b04030
5
FAIL MIDPLANE EEPROM checksum slot:
RT Clock 7 0x358170 0x7b12b30
5
PASS RTC POST slot:3
Back Plane 12 0x358170 0x7b040c0
5
PASS BACKPLANE EEPROM checksum slot
List memory allocated: 1404 bytes.
Example 3 To start all the tests and run them one time (this example is from a MALC):
zSH> selftest start 1 1 1
selt
The MALC supports the SELT commands for Single-End Loop Tests.
Syntax selt start interface
selt abort interface
selt clear interface
selt set units awg | metric | japan
selt set max-duration interface num-seconds
selt show status interface
selt show noise interface [start-index [num-vals]]
157
Commands
interface
The interface can be in the form of ifIndex (432), name/type (1-4-1-0/
adsl) or shelf/slot/port/subport/type (1/4/1/0/adsl0.
num-seconds
The maximum amount of time, in seconds, that a SELT test is allowed to
run on an ADSL interface. If a selt test runs for more than
<num-seconds> it will be aborted. Setting max-duration to zero disables
SELT timeout on an interface. Note that, in order to get valid results, a
SELT test must be allowed to run to completion, and this may take several
minutes, depending on the speed of the processor used to do the
computation.
start-index
(0..511) is the tone index with which to start. 0 is 4.3125 kHz, 1 is 8.625
kHz, up to 511 which is 2208.0000 kHz. The noise command displays the
loop noise floor results of a selt test. There is one noise measurement per
ADSL tone. Each noise value has units of dBm/Hz.
num-val
The number of tones to display.
wire-guage
Sets the expected diameter of the wire connected to an interface. The
diameter may be set using any units, regardless of the display units set
with the selt set units command. The wire-gauge option must use one of
these settings:
unknown - unknown wire gauge
awg19 - 19 gauge
awg22 - 22 gauge
awg24 - 24 gauge
awg26 - 26 gauge
32mm - 0.32 millimeters
40mm - 0.40 millimeters
50mm - 0.50 millimeters
63mm - 0.63 millimeters
65mm - 0.65 millimeters
90mm - 0.90 millimeters
The chip used to implement the selt test may restrict which values can be
configured. The Conexant-g24 chip accepts these settings:
awg24
awg26
40mm (as an alias for awg26)
50mm (as an alias for awg24)
cable-type
158
Sets the type of cable being tested, real or simulated. The real setting
indicates that an actual physical cable is connected to the interface. In a
lab or test environment , the cable may be simulated and use the dsl90 or
dsl400 setting.
real: indicates a physical cable is connected to the interface.
dsl90: a Consultronics/Spirent DLS90 is simulating the cable.
dsl400: a Consultronics/Spirent DLS400 is simulating the cable.
Notes Note that it may take some time (perhaps as much as a minute) for the SELT
test to abort.
set
This command is used only by the configuration restore process.
Syntax N/A
Products BAN, MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723, Sechtor
100A, Z-Edge 64
set2default
Erases the system configuration and restores the factory default settings.
Caution: This command erases your system configuration, reboots
the system, and causes all connections and subscriber traffic to drop.
Note: This command is not available on standby uplink cards in a
protection group
Syntax set2default
Example
175.5> set2default
Ok to reset to default (system will reboot) ? [yes] or [no]: yes
Do you want to exit from this request? (yes or no) [yes] no
Are you sure? (yes or no) [no] yes
Products BAN, MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723, Sechtor
100A, Z-Edge 64
See Also systemreboot
setcliprov
Enables or disables provisioning from a CLI session. If CLI provisioning
cannot be re-enabled using this command, use the resetcliprov command.
Syntax setcliprov [ enable | disable ] [ index | all ] [ -d ]
159
Commands
provisioning:
zSH> setcliprov -d
Note: Provisioning is
CLI session = 0: Flag
CLI session = 1: Flag
CLI session = 2: Flag
CLI session = 3: Flag
CLI session = 4: Flag
CLI session = 5: Flag
CLI session = 6: Flag
CLI session = 7: Flag
CLI session = 8: Flag
CLI session = 9: Flag
100A, Z-Edge 64
See Also resetcliprov
setdatetime
Sets the date and time.
Syntax setdatetime [ month day yr hr min sec ]
Options month
160
sec
Seconds in the format ss.
Access Level admin
Notes If Network Time Protocol (NTP) is enabled, the setdatetime command is
disabled.
Products BAN, MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723, Sechtor
100A, Z-Edge 64
See Also showdatetime
setline
Specifies the maximum number of lines to be displayed at once.
Syntax setline [ number-of-lines ]
Options
100A, Z-Edge 64
setprompt
Sets the system prompt.
Syntax setprompt [ session | user ] prompt
Options session
Changes the system prompt to the specified string for the current session.
user
Changes the system prompt for the user to the specified string. This
prompt appears every time the user logs in.
prompt
A string of up to 20 characters for the prompt
Example The following example sets the system prompt to Zhone> for the current
session:
zSH> setprompt session Zhone>
Prompt set to Zhone>
Access Level user
161
Commands
Products BAN, MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723, Sechtor
100A, Z-Edge 64
shelfctrl
Displays overall status of the system.
Syntax sheflctrl [ monitor | show
| stats ]
Options monitor
162
mode:
163
Commands
100A, Z-Edge 64
See Also slots
shelfreboot
Resets the shelf. When you reset a shelf, all connections are dropped.
164
show
The show command displays the default contents of profile and its parameter
value ranges. The command uses the following syntax:
Syntax show profile-type
Options profile-type
Shows the parameters in the specified profile with the parameter value
ranges.
Example To view the options available for a profile, use the show command and
165
Commands
mcastcontrollist:-->
{264}
vlanid:------------>
{0 - 4095}
maxVideoStreams:--->
{0 - 6}
NOTE: Supported VPI/VCI ranges vary based on card type.
See documentation for the exact range of supported VPI/
VCI values.
Access Level admin
Products BAN, MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723, Sechtor
100A, Z-Edge 64
See Also get, list
showactivecards
Displays information about the active cards in a redundant card group.
Syntax showactivecards
Example zSH> showactivecards
Shelf/Slot Group Id
Card Type
__________________________________
1:
1/21 2
MALC MTAC
2:
1/1
1
MALC DS3
Products BAN, MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723
See Also showredundancy
showdatetime
Displays the date and time.
Syntax showdatetime
Access Level admin
Products BAN, MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723, Sechtor
100A
See Also setdatetime
showhostname
Displays a list of remote hosts, along with their Internet addresses and aliases.
Syntax showhostname
Access Level user
Notes This command is persistent across reboots.
Products BAN, MALC, Raptor 319, Raptor 719, Raptor 723, Sechtor 100A, Z-Edge 64
166
showinetstat
Displays information about the active IP sockets.
Syntax showinetstat
Example
zSH> showinetstat
Active Internet connections (including servers)
PCB
Proto Recv-Q Send-Q Local Address
Foreign Address
(state)
-------- ----- ------ ------ ------------------ ------------------ ------382806c TCP
0
214 192.24.94.223.23
192.16.41.183.5169 ESTABLISHED
3827cd0 TCP
0
0 0.0.0.0.23
0.0.0.0.0
LISTEN
3827dd8 UDP
0
0 0.0.0.0.162
0.0.0.0.0
3827d54 UDP
0
0 0.0.0.0.161
0.0.0.0.0
Access Level admin
Products BAN, MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723, Sechtor
100A, Z-Edge 64
showipstat
Displays IP statistics.
Syntax showipstat [ -r ]
Options
81601
0
0
0
0
0
0
0
0
11141
4303
0
2
0
0
0
0
6447695
0
0
167
Commands
nointerface
0
c2ctotal 6447695
c2cbadptr
0
c2cnopkt
0
c2cnoipktmem
0
c2cttlexp
0
c2clastchance
0
flingnoipkt
0
flingerror
0
flung
0
rawflung
0
rawnofling
0
fwdloopdrop
0
localfastpath 55532
pendingarpoverflow
835
Access Level admin
Products BAN, MALC, Raptor 319, Raptor 719, Raptor 723, Sechtor 100A, Z-Edge 64
showline
Displays information on registered lines in line resource registry's database.
Syntax showline [ shelf | slot| -c number of columns]
Options shelf
168
showlinestatus
Displays information about all the lines in the system.
Syntax showlinestatus [ shelf slot port subport ]
Options
169
Commands
zSH> showlinestatus 1 7
Search in progress .........
.................
Line Type-------> DS3 (1)
GroupId --------> 260
Status ---------> OOS (3)
Redundancy -----> ACTIVE (3)
TxClk ----------> LOOP (4)
RefClkSrc ------> NO
If_index -------> 259
Shelf ----------> 1
Slot -----------> 7
Port -----------> 1
SubPort --------> 0
.................
Line Type-------> DS3 (1)
GroupId --------> 262
Status ---------> OOS (3)
Redundancy -----> ACTIVE (3)
TxClk ----------> THROUGH (5)
RefClkSrc ------> NO
<SPACE> for next page, <CR> for next line, A for all, Q to
quit
For each connection, the system lists the line type (such as an Ethernet, DS3,
SONET, or T1/E1 line), the number of registered lines, their group ID, the line
status, the ifindex (interface line number), the peer ifindex (the peer line
number), and the shelf, slot, and port where the interface resides.
A value of ACTIVE in the Status field indicates that the physical circuit is
detected. OSS (Out of Service) means that the physical interface is not active.
Example 2 The next example displays the line status of the line in shelf 1, slot 9, port 1
100A, Z-Edge 64
170
showmem
Displays system memory partition blocks and statistics.
Syntax showmem [ -a ]
Options
Total
Blocks
7540
5780
5988
664
372
1532
184
65
107
34
88
13
2
Free
Blocks
59
2705
85
33
105
3
4
1
2
1
2
0
0
Pool Totals:
Number of Total Blocks in all Pools: 22369
Number of Free Blocks in all Pools: 3000
Total Bytes in all Pools: 9739152
171
Commands
100A, Z-Edge 64
showredundancy
Displays system redundancy information.
Syntax showredundancy
Options
172
Standby Addr
============
01:02:03
01:02:02
01:02:26
01:02:1036
01:02:25
01:02:1035
01:02:58
01:02:08
01:02:67
01:02:1030
01:02:1033
01:02:1031
01:02:1038
01:02:64
01:02:1044
01:02:1045
01:02:1046
01:02:1041
01:02:1039
01:02:63
Stdby Ready?
============
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
tDS1RP
01:01:1061
01:02:1062
_RedSpawnSvrTask
01:01:1050
01:02:1050
connmgr
01:01:16
01:02:16
Safe, all services have redundant peers
01:01 is active storage
01:02 is standby storage
Yes
Yes
Yes
showresolver
Displays information about the Domain Name System (DNS) resolver on the
device. The DNS resolver is configured in the resolver profile.
Syntax showresolver [ -d domain-ID ]
Options
100A, Z-Edge 64
showsonetrp
Reports detailed status for an OC3-c/STM1 interface resource provider,
including the following line conditions: This command is available only when
a SONET interface is configured.
173
Commands
Example The following example shows the showsonetrp command output for line 1:
zSH> showsonetrp 1
************
SONET RP Debug Information
name:
address:
lineRRLeaseId:
sonetXlatProfLeaseId:
sonetCfgProfLeaseId:
sonetLineRRNotifyLeaseId:
_sonetRpCardGroupId:
iamRedundantCard:
iamActiveCard:
Redundancy Mode
PeerCardInfoAvailable
PeerCardShelf
PeerCardSlot
PeerCardAlive
numUnits:
Attached units:
1 2
************ Debug Information for Line 1
iamRedundantLine:
iamActiveLine:
state:
ifIndex:
LineGroup ifIndex:
primaryClock:
shelf:
slot:
port:
subPort:
xlatProf.ifIndex:
xlatProf.ifType:
xlatProf.adminStatus:
sectionAlarms
lineAlarms
pathAlarms
mediumType
mediumLineCoding
mediumLineType
mediumCircuitIdentifier
mediumLoopbackConfig
pathCurrentWidth
clockExternalRecovery
clockTransmitSource
mediumScrambleConfig
mediumLineScrmConfig
Send APS stats
************
tSONETRP
01:01:1085
0x02070000_0000004f
0x02070000_00000050
0x02070000_00000050
0x00000000_00000000
1
TRUE
TRUE
CARD
TRUE
1
2
TRUE
2
************
TRUE
TRUE
4 ( OOS )
4
5
FALSE
1
1
1
0
4
39
1
6 ( LOS LOF )
2 ( AIS )
1 ( NODEFECT )
sonet
sonetmediumnrz
sonetshortsinglemode
sonetnoloop
sts3cstm1
enabled
looptiming
TRUE
TRUE
FALSE
Products BAN, MALC, Raptor 319, Raptor 719, Raptor 723, Sechtor 100A
174
showuser
Displays information about all users on the system, or for a specific user.
Syntax showuser [ username ]
Options
100A, Z-Edge 64
See Also adduser, deleteuser, updateuser
showzhonecpe
Displays the Zhone Customer Premises Equipment (CPE) connected to the
system, including the virtual routing domain, IP address, and current
connection status.
Syntax showzhonecpe
Example zSH> showzhonecpe
1: Zhone CPE at vrd:0 ip:192.168.199.205 status:UP
failures:0
Total Zhone CPE devices: 1 (1 up) (0 down)
Access Level admin
Products BAN
See Also pollzhonecpe
slotreboot
Resets the specified slot card. When you reset a system, all connections are
dropped.
Syntax slotreboot slot
175
Commands
Options slot
BAN, MALC
slots
Displays the type of cards installed in the chassis.
The slots command displays an asterisk (*) as a visual indicator for active
cards in a redundant configuration.
The slots command also now displays the ROM and software versions.
176
:
:
:
:
:
:
:
:
:
:
:
:
:
:
INFOSERVICES
1
1
4010042
No CLEI
1/3/3
1
3
RUNNING
FUNCTIONAL
enabled
180
enabled
2 hours, 45 minutes
: MALC ULCS
177
Commands
Sub-Type
Card Version
EEPROM Version
Serial #
CLEI Code
Card-Profile ID
Shelf
Slot
State
Mode
Heartbeat check
Longest hbeat
Fault reset
Uptime
Start time
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
ISDN 2B1Q
1
1
210003
No CLEI
1/5/5049
1
5
RUNNING
FUNCTIONAL
enabled
4543
enabled
3 hours, 40 minutes
1124907219
Example 4 This example shows active cards with redundant configurations in slots 1 and
17.
zSH> slots
1:*MALC RPR GIGE (RUNNING)
2: MALC RPR GIGE (RUNNING)
5: MALC XDSL 48 (RUNNING)
8: MALC POTS 48/with Packet Voice (RUNNING)
17:*MALC MTAC (RUNNING)
17: MALC MTAC (RUNNING)
Example 5 zSH> slots 1
Type
:*MALC UPLINK T1/E1 TDMF
Card Version
: 12740102
EEPROM Version : 1
Serial #
: 4340666
CLEI Code
: No CLEI
Card-Profile ID : 1/1/5114
Shelf
: 1
Slot
: 1
ROM Version
: MALC 1.9.0.1
Software Version: MALC 1.12.0.102
State
: RUNNING
Mode
: FUNCTIONAL
Heartbeat check : enabled
Longest hbeat
: 50
Fault reset
: enabled
Uptime
: 1 hour, 8 minutes
Start time
: 1131462988
zSH>
Access Level user
Products BAN, MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723
See Also bootstate
178
snmp
Provides access to standard SNMP commands.
Syntax snmp [get|set|next|walk|xlate] ipAddr Community OID
[type] [value]
Options get
an SDSL interface.
First, find the ifIndex for the interface you want to get the information for:
zSH> ifxlate 1-7-1-0/hdsl2
ifIndex: ----------> {868} use this value in the SNMP get command
shelf: ------------> {1}
slot: -------------> {7}
port: -------------> {1}
subport: ----------> {0}
type: -------------> {hdsl2}
adminstatus: ------> {up}
physical-flag: ----> {true}
iftype-extension: -> {none}
ifName: -----------> {1-7-1-0}
179
Commands
an ADSL interface.
First, find the ifIndex for the interface you want to get the information for:
zSH> ifxlate 1-3-1-0/adsl
ifIndex: ----------> {58} use this value in the SNMP get command
shelf: ------------> {1}
slot: -------------> {3}
port: -------------> {1}
subport: ----------> {0}
type: -------------> {adsl}
adminstatus: ------> {up}
physical-flag: ----> {true}
iftype-extension: -> {none}
ifName: -----------> {1-3-1-0}
SHDSL interface.
First, find the ifIndex for the interface you want to get the information for:
zSH> ifxlate 1-3-1-0/shdsl
ifIndex: ----------> {364} use this value in the SNMP get command
shelf: ------------> {1}
slot: -------------> {3}
port: -------------> {1}
subport: ----------> {0}
type: -------------> {shdsl}
adminstatus: ------> {up}
physical-flag: ----> {true}
iftype-extension: -> {none}
ifName: -----------> {1-3-1-0}
180
Example 5 The following example displays information about an ATM T1/E1 interface.
First, find the ifIndex for the interface you want to get the information for:
zSH> ifxlate 1-16-1-0/ds1
ifIndex: ----------> {8} use this value in the SNMP get command
shelf: ------------> {1}
slot: -------------> {16}
port: -------------> {1}
subport: ----------> {0}
type: -------------> {ds1}
adminstatus: ------> {up}
physical-flag: ----> {true}
iftype-extension: -> {none}
ifName: -----------> {1-16-1-0}
Then use the ifIndex in the SNMP get command. The following two
commands get the valid intervals for the DS1 interface and the current
number of severely errored seconds:
zSH> snmp get 192.240.200.111 ZhonePrivate zhoneValidIntervals.8
zhoneDs1Entry.zhoneValidIntervals.8 Value: 26 (0x1a)
zSH> snmp get 192.240.200.111 ZhonePrivate zhoneCurrentSESs.8
zhoneDs1CurrentEntry.zhoneCurrentSESs.8 Value: 0 (0x0)
Products BAN, MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723, Sechtor
100A, Z-Edge 64
sonetStatsShow
Displays performance monitoring statistics for the current SONET
connections. his command is available only when a SONET interface is
configured.
Syntax sonetStatsShow ifIndex
Options ifIndex
****************
RxCell
HECCor
HECUncor
FifoOv
Locd
73817
0
0
0
0
LineBIP
SectBIP
PathBIP LineFEBE PathFEBE OOF
0
0
0
426
73387
0
______________________Near-End Current Stats_______________________
181
Commands
182
sonetstatusshow
Displays performance monitoring statistics for the current SONET
connections. his command is available only when a SONET interface is
configured.
Syntax sonetstatusshow ifIndex
Options ifIndex
stack
Binds, unbinds, and shows the logical protocol stacks used in the system.
Note: Ethernet interfaces can be addressed as either eth or
ethernetcsmacd. The eth abbreviation is used in command output.
Syntax stack bind
[ upperlayer lowerlayer ]
183
Commands
100A, Z-Edge 64
su
Logs in the specified user.
Syntax su username
184
Options username
100A, Z-Edge 64
See Also logout
swact
Following the swupgrade command, this command switches the active
device after software upgrade is complete.
Syntax swact [abort]
Options abort
This optional parameter terminates the software upgrade and reboots the
standy device.
Access Level admin
Products MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723
See Also swupgrade
swupgrade
Initiates the software upgrade process. This command reboots the standby
device, informing it of upgrade. This command must be followed by the
swact command, unless the autoswact option is used.
Syntax swupgrade
Options autoswact
swversion
Displays the current system software version.
Syntax swversion
Example zSH> swversion
Zhone malcOc12 software version release 1.13
Access Level user
Products BAN, MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723, Sechtor
100A, Z-Edge 64
185
Commands
syslog
Configures logging levels for messages on the system. The system sends log
messages to a management session (either on the console or over a telnet
session), a log file on the device, and, optionally, a syslog server.
The log command configures the type of information sent in these messages.
By default, the system sends the same type of information to all log message
destinations, and logging is disabled on both the serial craft port and over
telnet sessions.
If the messages sent to the syslog server are configured the same as the log
messages sent to the console or the persistent storage (the default) the log
command also configures the syslog message contents. If the syslog messages
have been modified (using the log-module profile or the syslog command),
use the syslog command to modify syslog levels.
Syntax syslog help
help
Displays the help menu.
Syntax syslog show
show
Displays the currently configured logging levels for each software
module.
Syntax syslog level module level
module
The system module to set the level for. Use the syslog show command to
display all the system modules.
level
Sets the logging level for the specified module. Logging levels are:
1 emergency
2 alert
3 critical
4 error
5 warning
6 notice
7 information
8 debug
You can specify either the name of the level or the number.
Syntax syslog option type [ on | off ]
186
enable module
Enables logging for the specified module. Use the syslog show command
to display all the system modules and whether they are enabled or not.
disable module
Disables logging for the specified module.
Syntax syslog session [on | off]
on
Enables logging for the current session only.
off
Disables logging for the current session.
Syntax syslog serial [on | off]
on
Enables logging on the serial craft port. This setting persists across
reboots.
off
Disables logging on the serial craft port. This setting persists across
reboots.
Syntax syslog display
Note: The cache option is only supported on the BAN and MALC.
syslog cache
Displays the syslog cache.
syslog cache max length
Sets the maximum number of syslog messages to store. The maximum
syslog cache size is 2147483647, depending in the amount of memory
available.
187
Commands
system modules:
zSH> syslog show
MODULE
message
taskclock
card
bds_client
alarm_mgr
tnsxmgt
leaseapi
vcs-client
dirserclient
rebootserver
pcmciadiag
...
...
...
LEVEL
error
error
error
error
error
error
error
error
error
error
error
STATUS
enabled
enabled
enabled
enabled
enabled
enabled
enabled
enabled
enabled
enabled
enabled
Example 2 The following example sets the logging level for the card module to
information:
zSH> syslog level card info
Module: card at level: information
Example 3 The following example shows how to configure what information to include
in syslog messages.
zSH> syslog option all on
time:date:level:address:log:taskname:taskid:file:function
:line:(0xff)
Example 4 To return the log messages to their default format, enter the following
command:
zSH> syslog option default on
time: date: level: address: log: taskname:
(0xf)
188
Example 6 following example searches through the log cache for the word IMA:
zSH> syslog cache grep IMA
Searching for: "IMA"
[1]: JAN 06 20:36:10: alert : 1/2/50 : alarm_mgr:
tLineAlarm: 01:02:02 Critical IMA Down Line
[2]: JAN 06 20:36:46: alert : 1/2/50 : alarm_mgr:
tLineAlarm: 01:02:02 Critical IMA Up Line
Access Level user
Products BAN, MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723, Sechtor
100A, Z-Edge 64
See Also log
systemreboot
Resets the system.
Caution: When you reset a system, all connections are dropped.
Syntax systemreboot
A warning appears when a restore file exists in the system Flash to prevent
unintentional deletions of the restore file with a new restore file.
Example
zSH> systemreboot
>> A restore file (/card1/onreboot/restore) is present.
>> A system reboot will result in a database restore.
>> Continue? (yes or no) [no]: yes
>>
>> Do you want to reboot the system? (yes or no) [no] yes
>>
>> Do you want to exit from this request? (yes or no) [yes] no
>>
>> Are you sure? (yes or no) [no] yes
Access Level admin
Products BAN, MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723, Sechtor
100A, Z-Edge 64
See Also shelfreboot, slotreboot
systemrpshow
Displays general information about the system resource provider, including
memory and flash usage.
Syntax systemrpshow
189
Commands
Example
zSH> systemrpshow
System RP Info:
RP Address.........................01:02:98
% Memory used......................87.16
% Flash used.......................10.04
Access Level admin
Products BAN, MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723
T
telnet
Initiates an outbound telnet session.
Syntax telnet host
Options host
thermoshow
The thermoshow command returns temperature information about the
system. The system has two thermometers. From the front of the unit,
thermometer 1 is located to the right of the MPC750 microprocessor, and
thermometer 2 is located on the right side of the system circuit board.
Syntax thermoshow
Example The example below shows the system response to the command.
zSH> thermoshow
THERMO1:
Temperature
High Threshold
Low Threshold
THERMO2:
Temperature
High Threshold
Low Threshold
Products Sechtor 100A
190
: 24 C
: 65
: -5
: 29 C
: 60
: -5
timeout
Specifies a the period of inactivity after which administrative telnet sessions
will be automatically disconnected. The default time out is set to 10 minutes.
Syntax timeout [ -d | off | minutes ]
Options off
100A, Z-Edge 64
See Also logout
traceroute
The traceroute command uses Internet Control Message Protocol (ICMP)
echo and User Datagram Protocol (UDP) to determine the path between two
network hosts.
The value of the Time To Live (TTL) field in the IP header is set when the IP
packet is sent. Each router that processes the datagram reduces the TTL value
by one. When a router receives a TTL with a 0 (zero) or one (1) value, it
discards the datagram and sends a time exceeded message to the originating
host.
The traceroute command sends an IP datagram with a TTL value of one (1)
to the destination host. The first router discards the datagram and sends the
time exceeded message back to the originator. This identifies the first router
along the route. This process is repeated using incrementally higher TTL
values until all of the routers are identified. When the datagram reaches the
destination host, the host recognizes that the packet is for an unused port, and
generates a port unreachable error.
Syntax traceroute [-I] [-f first_ttl] [-m max_ttl] [-p port] [-q
nqueries] [-s src_addr] [-w waittime] [ -z pausemsecs]
host [packetlen] [-l ip address]
Options -I
191
Commands
-m max_ttl
Sets the maximum time-to-live (number of hops) to be used in outgoing
probe packets. The default is 30 hops.
-p port
Sets the base UDP port number used in probes. The default is 33434.
-q nqueries
The number of probes sent to each ttl setting.
-s src_addr
Tells the system to use the following IP address (which usually is given as
an IP number, not a hostname) as the source address in outgoing probe
packets. This option is used with hosts that have more than one IP address
to force the source address to be other than the IP address of the interface
that the probe packet is sent on.
-w waittime
Sets the time, in seconds, to wait for a response to a probe. The default is
5 seconds.
-z pausemsecs
Sets the time, in milliseconds, to pause between probes. The default is 0
(zero).
host
The destination host name or IP address in dotted quad format.
packetlen
The packet length, in bytes, of the probe datagram. The default is 40
bytes.
-l
Specifies the use of source based routing to determine the interface on
which to probe packets.
Example The following example traces a route to a host with an IP address of
192
100A, Z-Edge 64
See Also ping, telnet
U
update
The update command changes an existing record.
Syntax update profile-type index
Options profile-type
193
Commands
100A, Z-Edge 64
See Also del, get, list, new, show
updateuser
Updates access levels for a user.
Syntax updateuser username
Example zSH> updateuser jjsmith
Updating access levels for user (jjsmith)
Please provide the following: [q]uit.
admin: -------> {yes}: no
zhonedebug: --> {no}:
voice: -------> {no}:
data: --------> {no}:
manuf: -------> {no}:
database: ----> {no}:
systems: -----> {no}:
tool: --------> {no}:
useradmin: ---> {yes}:
Save changes? [s]ave, [c]hange or [q]uit: s
User record updated.
Access Level useradmin
Products BAN, MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723, Sechtor
100A, Z-Edge 64
See Also showuser
upgrade
Displays upgrade status and enables control of the upgrade process.
Syntax upgrade[show] [set slot boot|noboot] [stop] [continue]
[log]
Options show
194
continue
Restarts the upgrade task after termination.
log
Displays contents of the upgrade log file.
Example 1 zSH> upgrade show
Upgrade task is running
Status is waiting for peer
Example 2 zSH> upgrade show
Upgrade task is running
Status is rebooting slot cards
Status of slot 3 is reboot not required
Status of slot 4 is reboot not required
Status of slot 5 is reboot not required
Status of slot 6 is reboot complete
Status of slot 7 is reboot not required
Status of slot 8 is reboot not required
Status of slot 9 is reboot not required
Status of slot 10 is reboot not required
Status of slot 11 is reboot not required
Status of slot 12 is reboot not required
Status of slot 13 is reboot not required
Status of slot 14 is reboot not required
Status of slot 15 is reboot not required
Status of slot 16 is reboot not required
Status of slot 17 is reboot not required
Status of slot 18 is reboot not required
Status of slot 19 is rebooting
Status of slot 20 is reboot not required
Status of slot 21 is reboot not required
Example 3 zSH> upgrade show
Upgrade task is not running
Status is completed successfully
Message is:
Software upgrade completed successfully!
Status of slot 3 is reboot not required
Status of slot 4 is reboot not required
Status of slot 5 is reboot not required
Status of slot 6 is reboot complete
Status of slot 7 is reboot not required
Status of slot 8 is reboot not required
Status of slot 9 is reboot not required
Status of slot 10 is reboot not required
Status of slot 11 is reboot not required
Status of slot 12 is reboot not required
Status of slot 13 is reboot not required
Status of slot 14 is reboot not required
Status of slot 15 is reboot not required
Status of slot 16 is reboot not required
Status of slot 17 is reboot not required
Status of slot 18 is reboot not required
195
Commands
user
The user command enables the command line feature to add, modify, show,
or delete users and user settings.
Syntax user add <user-name> [password password] [prompt prompt]
[admin] [zhonedebug] [voice] [data] [manuf] [dbase]
[systems] [tools] [useradmin] [all]
Options add
Adds a new user profile with the specified settings.
username
Name of the user.
password password
Specifies the password assigned to this user.
prompt prompt
Specifies the system prompt to display for this user. If no password is
entered, the system assigns a random password. Enclosing an argument
in quotes allows the entry of special characters.
196
access level
Specifies the access levels assigned to the user. The all option sets all
access levels. Individual access levels can be specified by added the
keyword true or false after an access level. For example, manuf false all
true sets all access levels except manuf level access.
Example 1
zSH> user add steve password pass prompt "zSH >" admin voice systems dbase
User record saved.
..................................
User name:(Steve) User prompt:(zSH >)
Access Levels:
(admin)(voice)(system)(dbase)
Example 2
zSH> user modify joe password pass all false admin true
OK to modify this account? [yes] or [no]: yes
User record updated.
..................................
User name:(newaccount2) User prompt:(zSH>)
Access Levels:
(admin)(useradmin)
Example 3
zSH> user show
..................................
User name:(admin) User prompt:(zSH>)
Access Levels:
(admin)(voice)(data)(manuf)(database)(systems)(tool)(useradmin)
..................................
User name:(steve) User prompt:(zSH>)
Access Levels:
(admin)(voice)(systems)(dbase)
..................................
User name:(joe) User prompt:(test >)
Access Levels:
(admin)
..................................
User name:(kathy) User prompt:(test4 >)
Access Levels:
(admin)(zhonedebug)(voice)(data)(manuf)(database)(systems)(tool)(useradmin)
zSH> user show steve
..................................
User name:(steve) User prompt:(zSH>)
Access Levels:
(admin)(voice)(systems)(dbase)
Example 4
zSH> user delete kathy
OK to delete this account? [yes] or [no]: yes
197
Commands
V
verbose-restore-off
This command is only used by the configuration restore process.
Syntax N/A
Products BAN, MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723
verbose-restore-on
This command is only used by the configuration restore process.
Syntax N/A
Products BAN, MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723
videosource
The videosource command is used to add, show, and delete interfaces for
video signals.
Syntax videosource add [domain routing-domain] multicast-address
interface [vpi/vci]
routing-domain
Optional domain used for routing.
multicast-address
Address of the multicast interface.
interface
Interface used as the video source.
Syntax videosource show [multicast-address] [interface]
multicast-address
Address of the multicast interface.
interface
Interface used as the video source.
Syntax videosource delete [domain routing-domain]
multicast-address interface [vpi/vci]
routing-domain
Optional domain used for routing.
multicast-address
198
224.1.1.1
224.1.1.2
224.1.1.3
224.1.1.4
IfName:
IfName:
IfName:
IfName:
1-1-1-0/ip
1-1-1-0/ip
1-1-1-0/ip
1-1-1-0/ip
voice
The voice command can add, delete, or show voice connections. The
following types of voice connections are supported:
add
Add a voice connection between subscriber-endpoint and
remote-endpoint.
subscriber-endpoint
Name and type of the physical interface on the subscribers side of the
voice connection. Values:
pots interface [alaw | mulaw]
isdn interface
aal2 interface vp|vc VPI/VCI [td Tx/Rx] cid CID [alaw | mulaw] [aud
audio-prf-id] [ap preferred-ap-id]
elcp interface vp|vc VPI/VCI [td Tx/Rx] port port [alaw|mulaw] [aud
audio-prf-id] [ap preferred-ap-id]
voip IPinterface dn directory-number [name username] [pw password]
[plar dest-ipaddr] [codec] [t38fax t38-fax]
interface is the physical interface in format name/type.
IPinterface is the IP interface name with the type ip.
For GR-303, the interface group must already exist.
199
Commands
200
delete
Delete the voice connection from subscriber subscr-info.
subscriber-endpoint
Name and type of the physical voice connection.
Syntax voice show [-l POTSPhysicalIf] | [endpoint] [-v]
-l POTSPhysicalIf
Displays the voice connections for the specified POTS physical interface.
endpoint
Displays the voice connections on the system. For V5.2 voice
connections, also displays POTS or ISDN connection type. For AAL2
voice connections, also displays VP for VP-switched or VC for
VC-switched.
201
Commands
This command can also be used to display voice connection data for a
specific endpoint.
-v
Displays verboise out for voice connections.
Example 1 This example adds a voice connection from subscribers POTS line to a
system and displays the voice connections for a specified POTS interface.
zSH> voice show
Subscriber end-point
Remote end-point
------------------------------ -----------------------------1-1-1-0/voicefxs
1-1-1-0/fast VC 0/38 CID 16
1-1-2-0/voicefxs
1-1-1-0/fast VC 0/38 CID 17
Total number of voice connections : 2
STA
--ENA
ENA
202
2:
zSH> voice add pots 1-8-1-0/voicefxs gr303 1/2
Created subscriber 1/13
Created subscriber-voice 1/13/1
Created subscriber-voice-pots 20
Created gr303-ig-crv 1/2
Created subscriber-voice-gr303 21
Example 8 This example creates an AAL2 to GR303 VP-switched connection between
203
Commands
INPUT:
profile type: subscriber-voice-pots
logical address: LGId: 330 PotsNumber: 1
profile address: 39
subscriber-voice INFO:
voice-connection-type
= VOIPTOPOTS
voice-endpoint1-addr-index = 40
voice-endpoint2-addr-index = 39
voice-admin-status
= Enabled
subscriber-voice addr: subId: 1 LGId: 3
subVoiceId: 5
MATCHING:
profile type: subscriber-voice-voip
logical address: LGId: 72 EndPtIdx: 40
profile address: 40
zSH> voice show elcp 1-1-1-0/sonet VP 0/331 port 1 type pots
INPUT:
profile type: subscriber-voice-elcp-aal2
logical address: LGID: 93 VPI: 16 VCI: 331 PortId:1 PortType:1
isdnChannelId:0
profile address: 1
subscriber-voice INFO:
voice-connection-type
= ELCPAAL2TOV52
voice-endpoint1-addr-index = 1
voice-endpoint2-addr-index = 2
voice-admin-status
= Enabled
subscriber-voice addr: subId: 1 LGId: 25 subVoiceId: 1
MATCHING:
profile type: subscriber-voice-v52
logical address: IfName: IG-107 UserId: 20 IsdnBChannelId: 0
profile address: 2
zSH> voice show v52 1/20 type pots
INPUT:
profile type: subscriber-voice-v52
logical address: IfName: IG-107 UserId: 20 IsdnBChannelId: 0
profile address: 2
subscriber-voice INFO:
voice-connection-type
= ELCPAAL2TOV52
voice-endpoint1-addr-index = 1
voice-endpoint2-addr-index = 2
voice-admin-status
= Enabled
subscriber-voice addr: subId: 1 LGId: 25
subVoiceId: 1
MATCHING:
profile type: subscriber-voice-elcp-aal2
logical address: LGID: 93 VPI: 16 VCI: 331 PortId:1
PortType:1 isdnChannelId:0
profile address: 1
zSH> voice show elcp 1-1-1-0/sonet VP 1/2020 port 1 type isdn
INPUT:
profile type: subscriber-voice-elcp-aal2
204
205
Commands
206
voice ring
Verify voice connection without placing a call. The voice status command
can be used to verify the phones ring status if the ringing cannot be heard.
Syntax voice ring pots-intfc [ring-cadence] [time]
time is the number of seconds to ring the phone. This number must be
greater than 0. The default time is 15 seconds.
Options pots-intfc
voice status
Display runtime status of voice ports. Only status for POTS connections is
currently supported.
Syntax voice status [-t] [type] [shelf [slot [port]]] [endpoint]
207
Commands
Options t
destination
call state
-------------------provisioned
provisioned
provisioned
provisioned
provisioned
provisioned
provisioned
provisioned
provisioned
provisioned
provisioned
provisioned
provisioned
provisioned
provisioned
provisioned
provisioned
to continue, Q<CR> to stop:
hook ring
---- ---ON
Ring
ON NoRing
ON NoRing
ON NoRing
ON NoRing
ON NoRing
ON NoRing
ON NoRing
ON NoRing
ON NoRing
ON NoRing
ON NoRing
ON NoRing
ON NoRing
ON NoRing
ON NoRing
ON NoRing
208
call state
----------
hook
---ON
ring
---RING
call state
hook
ring
-------------------------------1-6-1-0/voicefxs
Inact Not provisioned
1-6-2-0/voicefxs
Inact Not provisioned
1-6-3-0/voicefxs
Inact Not provisioned
1-6-4-0/voicefxs
Inact Not provisioned
1-6-5-0/voicefxs
Inact Not provisioned
1-6-6-0/voicefxs
Inact Not provisioned
1-6-7-0/voicefxs
Inact Not provisioned
1-6-8-0/voicefxs
Inact Not provisioned
1-6-9-0/voicefxs
Inact Not provisioned
1-6-10-0/voicefxs
Inact Not provisioned
1-6-11-0/voicefxs
Inact Not provisioned
1-6-12-0/voicefxs
Inact Not provisioned
1-6-13-0/voicefxs
Inact Not provisioned
1-6-14-0/voicefxs
Inact Not provisioned
1-6-15-0/voicefxs
Inact Not provisioned
1-6-16-0/voicefxs
Inact Not provisioned
1-6-17-0/voicefxs
Inact Not provisioned
Type A<CR> to print all, <CR> to continue, Q<CR> to stop: q
Totals: ports: 576, admin-state up: 4, active calls: 0
voice status ig
Display real-time status of voice ports.
Syntax voice ig gr303|v52 igName
Options ig
Displays voice status for the specified GR303 or V5.2 interface group.
Example zSH> voice status ig gr303 test
Status for gr303 interface group test:
Admin status = in service
Oper status = inoperable
Active calls = 0
Switch type = norteldms100
TMC primary state = out of service
TMC secondary state = out of service
EOC primary state = out of service
EOC secondary state = out of service
zSH> voice status ig v52 one
Status for v52 interface group one:
Admin status = in service
Oper status = inoperable
Oper status cause = local disable
Active calls = 0
Switch vendor = ericsson
LinkId 0 TS 15 Channel status failed
LinkId 0 TS 16 Channel status failed
LinkId 1 TS 15 Channel status failed
LinkId 1 TS 16 Channel status failed
CPath 1
Oper status down
CPath 2
Oper status down
209
Commands
CPath 3
CPath 4
CPath 5
zSH>
voice vpdelete
The voice vpdelete command deletes the specified VP tunnel between the
uplink interface and the voice gateway card.
Syntax voice vpdelete interface vpi
interface
Specifies the uplink card interface.
vpi
Specifies the VPI to be deleted.
Example This command deletes the VP tunnel for VP 0 between the uplink interface
voice vpiadd
The voice vpiadd command builds the ATM VPI between the uplink card and
the voice gateway card aal2proxy on the specified VP. This command is used
for VP-switched connections
Syntax voice vpiadd interface vpi gr303|v52 ig MaximumVcis
interface
Specifies the uplink card interface.
vpi
The VPI to be used for this connection.
gr303 | v52
Indicates whether the voice connection connects to a GR-303 or V5.2
protocol switch.
ig
Specifies the interface group (IG) to be used for this connection.
For V5.2 and GR-303, the IG must already exist.
MaximumVcis
Specifies the maximum number of VCIs to be used for this VP-switched
connection.
Example This example uses the uplink interface uplink/atm with VP 0. The voice call
210
voice vpladd
The voice vpladd command builds the VPLs and cross connects for
VP-switched connections. This command applies to the voice gateway card
only.
Syntax voice vpladd interface vpi td rx/rx gr303|v52 ig
interface
Specifies the uplink card interface.
vpi
The VPI to be used for this connection.
td rx/tx
The receive and transmit traffic descriptors to be used for this connection.
gr303 | v52
Indicates whether the voice connection connects to a GR-303 or V5.2
protocol switch:
ig
Specifies the interface group (IG) to be used for this connection.
The IG must already exist.
Example This command builds atm-vpl uplink1/atm/0 on the uplink card using traffic
voicegateway
The voicegateway command can add, show or delete voicegateway
connections. The following types of voice connections are supported:
211
Commands
add
Add a voicegateway connection for the specified AAL5 proxy physical
interface or slot number of the voicegateway card, traffic descriptor, and
IP address. This command also automatically creates the
voip-server-entry 255/255 for multiple SIP server support if it does not
already exist.
interface
A valid AAL5 proxy physical interface or slot number of the
voicegateway card.
traffic-descriptor
The desired traffic descriptor.
ip-address
The IP address that is part of the configured ip-unnumbered-record.
Syntax voicegateway delete interface
interface
A valid AAL5 proxy physical interface or slot number of the
voicegateway card.
Syntax voicegateway show interface
interface
A valid AAL5 proxy physical interface or slot number of the
voicegateway card.
Example 1 These examples add a host on the voicegateway line card in slot 8 and assign
T Host Address
S 10.10.10.2
T Host Address
S 10.10.10.2
Example 3 This example adds an ATM voice interface on the uplink card in slot 1, port 1
and assigns the virtual connection vpi 0, vci 139 and cid 48. The TDM
connection uses GR303 protocol and interface group 1 with crv 131.
212
interface:
zSH> voicegateway show aal2 1-1-1-0/ds1
Subscriber end-point
Remote end-point
-----------------------------------------.......................
1-1-1-0/ds1 VC 0/139 CID 48 GR303 one/131
Voice Prof Id
-----------1/266/6
STA
--ENA
Example 5 These examples delete the voicegateway connection for the configured
voice stat
The voice stat command displays the following statistics for voice
connections.:
POTS port
Active Calls
SIP UA/MGCP
Active Calls
213
Commands
Active Calls
Type
Specifies voice statistics to be displayed for system, card, or subscriber.
Shelf
For card type, enter the shelf number of the card.
Slot
For card type, enter the slot number of the card.
Subscriber endpoint index
End point index for a subscriber. The subscriber endpoint index can be
displayed using the list subscriber-voice command.
Endpt-info
Endpoint of a voice connection. For example, gr303 1/92 for a GR-303
voice endpoint or pots 1-7-3-0/voicefxs for a POTS voice endpoint.
Example 1 This example displays voice statistics for the current system.
zSH> voicestat system
zSH> ******* Voice stats ********
Incoming blocked
0
Incoming completed
0
Outgoing blocked
0
Outgoing completed
0
Active calls
5
Example 2 This example displays voice statistics for the card in shelf 1 and slot 8.
zSH> voicestat card 1 8
zSH> ******* Voice stats ********
Incoming blocked
0
Incoming completed
0
Outgoing blocked
0
Outgoing completed
0
Active calls
5
Example 3 This example displays voice statistics for specified POTS subscriber with
index 3. Use the list subscriber-voice commands to list the current POTS
voice subscribers and the subscriber index numbers.
zSH> list subscriber-voice-pots
subscriber-voice-pots 1
subscriber-voice-pots 3
subscriber-voice-pots 5
214
subscriber-voice-pots
4 entries found.
********
0
2
0
0
0
W
who
Displays the names of all users currently logged into the system.
Syntax who
Access Level user
Products BAN, MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723, Sechtor
100A, Z-Edge 64
See Also logout
whoami
Displays the username of the current session.
Syntax whoami
Access Level user
Products BAN, MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723, Sechtor
100A, Z-Edge 64
See Also logout, su
Z
zrgconfig
For the ZRG 800 series devices, you must assign the VPI to be used for the
ATM connections. If you are connecting to a MALC PON OLT card, each
ZRG connected must have a unique VPI/VCI pair. (ZRG devices connected to
different PON OLT cards can use the same VPI/VCI.) You can assign a VPI
from 1 to 32.
215
Commands
Optionally, you can use this command to provision the ZRG to support VOIP
calls.
Syntax zrgcfg pon vpi [voatm | voip]
Options voatm
216
atmVplTransmitTrafficDescrIndex................239
audio-profile-identifier ...................................240
audio-service ..................................................240
audio-service ..................................................307
auth-key..........................................................364
auth-type.........................................................364
auto-learn........................................................349
autoNegCap....................................................310
autonegstatus ..................................................311
bcastaddr ........................................................335
bcastenabled ...................................................335
betaValue........................................................333
block (V5.2 link) ............................................391
block (V5.2 user port) ....................................390
bootfile ...........................................................272
boot-server......................................................272
bridgeConfigType ..........................................255
bridgeConfigValue .........................................255
bridgeIfConfigGroupIndex ............................255
bridgeIfCustomDHCP....................................256
buf-max-size...................................................267
cac-divider......................................................241
callback-dial-string.........................................350
callback-enable...............................................351
callback-type ..................................................351
call-mode........................................................351
capable-line-rate-limit ....................................384
card-atm-configuration...................................260
card-group-id..................................................260
card-line-type .................................................262
cas...................................................................241
cas...................................................................267
cc-index ..........................................................241
cell-loss-integration-period ............................268
cell-scramble ..................................................287
channelization ................................................288
channelization ................................................295
channel-number..............................................321
chap-enable ....................................................352
chap-name ......................................................352
chap-secret......................................................352
check-id ..........................................................391
circuit-id .........................................................288
circuit-id .........................................................296
client-hostname ..............................................272
217
218
ds0-channel-id ................................................403
ds1-for-remote-loop .......................................296
ds1-group-number ..........................................289
ds1-line-group ................................................403
ds1LM:array[1..28] ........................................322
ds1-mode ........................................................289
dsn-lg-id .........................................................392
dsx-line-length................................................290
echo-cancellation-type ...................................403
echo-return-loss..............................................404
egressfilterid ...................................................336
enable .............................................................336
enableauthtraps...............................................386
ends ................................................................276
expires-invite-value........................................414
expires-register-method..................................415
expires-register-value .....................................414
external-server................................................276
farendaddr ......................................................337
far-end-equip-code .........................................296
far-end-fac-id-code.........................................296
far-end-frame-id-code ....................................297
far-end-loc-id-code.........................................297
far-end-unit-code............................................297
fastMaxTxRate ...............................................229
fastMinTxRate................................................229
fault-detection-type ........................................241
fcs-alt-enable ..................................................353
fcs-size............................................................353
fdl ...................................................................290
features ...........................................................404
filterBroadcast ................................................256
first-nameserver..............................................286
fix-bit-rate ......................................................303
flags ................................................................276
forwardToDefault...........................................257
forwardToMulticast........................................257
forwardToUnicast ..........................................257
frame-mode-data ............................................242
framer-type .....................................................303
frames-per-packet...........................................415
frame-sync-word ............................................303
frame-type ......................................................353
fxo-cfg-signal-type .........................................315
g711-fallback..................................................415
g726-byte-order..............................................415
gammaValue ..................................................333
groupSymmetry..............................................330
guaranteed-bw ................................................349
hardware-address............................................277
ip-ifindex ........................................................354
ip-interface-index ...........................................416
ip-tos...............................................................416
ipUnnumberedinterface..................................338
isdn-channel-id ...............................................307
isdnds-cpath-id ...............................................343
isdnds-cpath-id ...............................................393
isdn-env-func-start-address ............................343
isdn-env-func-start-address ............................392
isdnf-cpath-id .................................................393
isdnp-cpath-id.................................................393
jitter-buffer-size..............................................406
jitter-buffer-type .............................................406
keep-alive-timer .............................................416
learnIP ............................................................257
learnMulticast.................................................258
learnUnicast....................................................258
lease-time .......................................................278
lgid..................................................................355
line-code .........................................................291
line-coding......................................................297
line-group-id...................................................308
line-group-id...................................................343
line-group-id...................................................384
line-length-meters ..........................................298
line-power ......................................................291
line-rate-limit..................................................385
line-status-change-trap-enable .......................291
line-status-trap-enable ....................................298
line-status-trap-enable ....................................304
line-type..........................................................292
line-type..........................................................298
line-type..........................................................304
link-is-timer....................................................393
link-oos-timer .................................................394
link-type .........................................................355
link-valid-flag.................................................394
local-admin-state ............................................322
local-interface-id ............................................394
local-ipaddr ....................................................338
local-port ........................................................338
local-prov-variant ...........................................394
local-timezone ................................................347
logical-channel-id (C-channel).......................395
logical-channel-id (C-path) ............................394
logical-id ........................................................322
loopback-config..............................................292
loopback-config..............................................299
low-if-index....................................................242
low-vci............................................................243
219
low-vpi........................................................... 243
lqr-period ....................................................... 355
lqr-status ........................................................ 355
magic-number ................................................ 356
magic-number-enable .................................... 356
malicious-caller-uri........................................ 407
manuf-access.................................................. 386
match-string ................................................... 417
mauType ........................................................ 313
max-cid-for-aal2-user-channels..................... 243
max-config-retries.......................................... 356
max-cps-sdu-size ........................................... 243
max-fail-retries .............................................. 357
max-failure-retries ......................................... 357
maximum-bw................................................. 349
maxInterleaveDelay....................................... 230
max-lease-time............................................... 278
max-length-frame .......................................... 243
max-length-frame .......................................... 308
max-number-multiplex-channels................... 243
max-outstanding-frames ................................ 395
max-pad ......................................................... 357
max-sdu-length .............................................. 244
max-sdu-length .............................................. 308
max-slot-id..................................................... 357
maxSnrMgn ................................................... 231
max-terminate-retries..................................... 358
max-term-retries ............................................ 358
maxUnicast .................................................... 258
max-uui .......................................................... 278
maxVideoStreams.......................................... 338
mcastcontrollist.............................................. 338
mcastenabled.................................................. 338
mcastfwdenabled ........................................... 339
medium-atmframe-config .............................. 299
medium-cell-scramble-config........................ 381
medium-cell-scramble-config........................ 383
medium-circuit-identifier............................... 382
medium-frame-config .................................... 299
medium-line-coding....................................... 382
medium-line-scramble-config........................ 382
medium-line-type........................................... 382
medium-loopback-config............................... 383
medium-scramble-config............................... 300
medium-type .................................................. 383
metric ............................................................. 339
min-cid-for-aal2-user-channels...................... 244
minDownshiftSnrMgn ................................... 231
minDownshiftTime........................................ 231
minLease........................................................ 279
220
min-lease-time................................................279
minNumRxLinks............................................331
minNumTxLinks ............................................331
minSnrMgn ....................................................232
minUpshiftSnrMgn ........................................232
min-uui ...........................................................279
mode ...............................................................402
mru .................................................................339
mru-enable......................................................358
multicastAgingPeriod.....................................339
n200................................................................395
n201................................................................395
name ...............................................................264
name ...............................................................279
name ...............................................................385
name-group-id ................................................385
name-id...........................................................323
natenabled ......................................................340
national-pstn-region .......................................396
netmask ..........................................................280
netmask ..........................................................340
network...........................................................280
ntr ...................................................................305
number-of-digits.............................................417
numcards ........................................................387
num-channels .................................................358
num-mode-enable...........................................359
numshelves .....................................................387
numunits .........................................................329
olt-onu-password............................................349
olt-onu-serial-num..........................................350
outgoingCOSOption.......................................340
outgoingCOSValue ........................................340
pap-enable ......................................................356
pap-password..................................................359
pap-peer-id .....................................................359
partial-fill........................................................268
path-current-width..........................................384
pcm-encoding .................................................244
pcm-encoding .................................................308
permissions.....................................................387
pfc-enable .......................................................360
physical-flag ...................................................329
pkts-lost-threshold..........................................407
pkt-time ..........................................................244
pointtopoint ....................................................305
poison .............................................................364
port .................................................................329
port-alignment-request ...................................396
port-id .............................................................308
port-type......................................................... 308
portType......................................................... 340
power-scale .................................................... 305
preferred-ap-index ......................................... 244
preferred-ap-index ......................................... 309
preferred-codec .............................................. 417
prefix-add....................................................... 417
prefix-strip ..................................................... 417
primaryclocksource........................................ 270
primaryclocksource........................................ 387
primary-name-server...................................... 280
primary-ntp-server-ip-address ....................... 346
protection-fast-timer ...................................... 314
protection-group ............................................ 396
protection-slow-timer .................................... 314
protection-wtr ................................................ 314
protocol .......................................................... 418
protocol-emulation......................................... 293
protocol-spec.................................................. 397
prov-variant-request....................................... 397
pstn-layer-3-start-address .............................. 397
public-ipaddr.................................................. 341
public-port...................................................... 341
quality-protocol.............................................. 360
query-order .................................................... 287
range1-end ..................................................... 280
range1-start .................................................... 281
range2-end ..................................................... 281
range2-start .................................................... 281
range3-end ..................................................... 281
range3-start .................................................... 281
range4-end ..................................................... 282
range4-start .................................................... 282
ras-timer......................................................... 245
rateChanRatio ................................................ 232
rateMode ........................................................ 232
rdindex ........................................................... 341
rdt-admin-state............................................... 323
reachExtendedAdsl2 ...................................... 233
reasmmaxsize................................................. 341
receive_traffic_descr_index........................... 245
receive-auth-enable........................................ 360
receive-auth-protocol..................................... 361
receive-type.................................................... 365
redundancy-over-subscription-type ............... 407
redundancy-param1 ....................................... 329
reg-or-lease-user ............................................ 398
reject-enabled................................................. 408
remote-admin-state ........................................ 323
remotefault..................................................... 314
remotefault .....................................................365
resendseqno ....................................................422
reserve-end .....................................................282
reserve-start ....................................................282
restart..............................................................283
restart..............................................................314
restart-timer ....................................................360
restart-timer ....................................................362
reversion-mode...............................................315
revertiveclocksource ......................................270
revertiveclocksource ......................................388
ring-back ........................................................319
ring-frequency ................................................319
ringSource ......................................................345
ringsource .......................................................388
role..................................................................323
role..................................................................398
rs232AsyncPortAutobaud ..............................369
rs232AsyncPortBits........................................369
rs232AsyncPortParity ....................................369
rs232AsyncPortStopBits ................................369
rs232PortInFlowType ....................................368
rs232PortInSpeed ...........................................368
rs232PortOutFlowType..................................368
rs232PortOutSpeed ........................................368
rtcp-enabled....................................................418
rtcp-packet-interval ........................................418
rx-acc-map......................................................361
rxTimingRefLink ...........................................335
sapi-0-max-outstanding-frames......................324
sapi-0-n-200 ...................................................324
sapi-0-pps-mode .............................................324
sapi-0-t-200 ....................................................324
sapi-0-t-203 ....................................................325
sapi-1-max-outstanding-frames......................325
sapi-1-n-200 ...................................................325
sapi-1-pps-mode .............................................325
sapi-1-t-200 ....................................................326
sapi-1-t-203 ....................................................326
sdp-enable ......................................................361
sdu-multiples ..................................................245
secondary-name-server ..................................283
secondary-ntp-server-ip-address ....................346
second-nameserver .........................................287
send-auth-enable ............................................362
send-auth-identity...........................................361
send-auth-protocol..........................................362
send-call-proceeding-tone ..............................418
send-code........................................................293
send-code........................................................300
221
send-type........................................................ 366
sent-updates ................................................... 366
server-max-timer............................................ 419
service-provider-id......................................... 385
setserialno ...................................................... 388
shdsl-clock-offset........................................... 370
shdsl-config-line-rate (2-wire G.SHDSL card)370
shdsl-config-line-rate (4-wire G.SHDSL card)371
shdsl-decoder-coeffA/shdsl-decoder-coeffB . 371
shdsl-dsp-version ........................................... 371
shdsl-firmware-version .................................. 372
shdsl-fix-bit-rate ............................................ 372
shdsl-frame-sync............................................ 372
shdsl-ntr ......................................................... 372
shdsl-power-scale .......................................... 373
shdsl-repeater-id ............................................ 374
shdsl-standard ................................................ 374
shdsl-startup-margin ...................................... 374
shdsl-transmit-power-back-off-mode ............ 374
shdsl-wire-mode ............................................ 375
shelf................................................................ 330
shelf................................................................ 398
shelvesarray ................................................... 388
signal-mode.................................................... 294
signal-type...................................................... 295
signal-type...................................................... 319
signal-type...................................................... 326
silence-suppression-type................................ 408
sip-ip-address................................................. 419
slot.................................................................. 330
source-ip-address ........................................... 269
source-port ..................................................... 269
src-address ..................................................... 366
sroute-advertise.............................................. 367
sscs-type......................................................... 246
starts............................................................... 283
startup-check-link-id...................................... 399
startup-unblock-user-ports............................. 399
state ................................................................ 284
status .............................................................. 362
stickyaddr....................................................... 283
StripAndInsert................................................ 258
stuff-bits......................................................... 306
subnetgroup.................................................... 284
subnetgroup.................................................... 341
subport ........................................................... 330
sw-enable ....................................................... 264
sw-file-name .................................................. 265
switch-type..................................................... 327
switch-vendor ................................................ 399
222
sw-pri-load-server ..........................................265
sw-upgrade-admin..........................................265
syscontact .......................................................389
syslocation......................................................389
sysname ..........................................................389
system-access .................................................389
system-clock-eligibility .................................271
system-clock-weight ......................................271
system-domain-name .....................................419
t200.................................................................400
t203.................................................................400
targetSnrMgn..................................................233
td_frame_discard............................................246
td_index..........................................................246
td_param1.......................................................247
td_param2.......................................................247
td_param3.......................................................247
td_param4.......................................................247
td_param5.......................................................247
td_service_category........................................248
td_type............................................................248
test_mode .......................................................345
testLinkIfIndex ...............................................333
testPattern .......................................................334
testProcStatus .................................................334
tftp ..................................................................284
thermo-a-lower-threshold...............................375
thermo-a-upper-threshold...............................376
thermo-b-lower-threshold ..............................375
thermo-b-upper-threshold ..............................376
third-nameserver ............................................287
thresh15min-badseq .......................................377
thresh15min-congestion .................................377
thresh15MinESs .............................................234
thresh15MinLofs ............................................234
thresh15MinLols ............................................234
thresh15MinLoss............................................235
thresh15MinLprs ............................................235
threshFastRateDown ......................................233
threshFastRateUp ...........................................235
threshInterleaveRateDown .............................236
threshInterleaveRateUp..................................236
threshold-15min-lofs ......................................306
threshold-15min-lols ......................................306
threshold-15min-loss......................................306
timer-cu ..........................................................249
time-slot-index ...............................................400
tools-access ....................................................385
traffic-container-index....................................249
transmit_traffic_descr_index..........................249
223
zhoneAtmVpiMaxVci.................................... 254
zhoneAtmVpiSwitched.................................. 255
zhoneVoipServerAddr ................................... 421
zhoneVoipServerAddrType........................... 421
zhoneVoipServerUdpPortNumber................. 421
zmsconnectionstatus ...................................... 422
zmsexists........................................................ 422
zmsipaddress.................................................. 423
224
PARAMETERS
This chapter provides a reference to the Zhone CLI parameters.
ADSL
adslAlarmConfProfile
This parameter is used internally by the system.
Access This parameter is read-only.
Location adsl-profile
adslChannelMode
Specifies the channelization of the ADSL modem.
Values fastonly
adslLineDTMConfMode
Discrete Multi-Tone parameter that selects whether there is overlap
(echoCancel) or no overlap (freqDivMux) of bins.
Access This parameter is read-write.
225
Parameters
Location adsl-profile
adslMaxDownstreamToneIndex
Specifies the maximum downstream active tone.
Values 32 (128KHz) to 511 (2044KHz)
adslMaxUpstreamToneIndex
Specifies the maximum upstream active tone.
Values 6 (24KHz) to 30 (120KHz)
adslMinDownstreamToneIndex
Specifies the minimum downstream active tone.
Values 32 (128KHz) to 255 (1020KHz)
adslMinUpstreamToneIndex
Specifies the minimum upstream active tone.
Values 6 (24KHz) to 30 (120KHz)
226
ADSL
Notes
adslNTRModeEnabled
Enables or disables network timing recovery (NTR) mode.
Values true
adslPotsBypassRelayMaxDuration
The maximum duration in seconds that an ADSL POTS low-pass filter bypass
relay will remain active (closed). The relay will automatically return a line
back to normal (open) mode when this timer has expired.
Values 1 to 300
Default 60
Access This parameter is read-write.
Location adsl-profile
Notes This object is only valid for MALC ADSL-SPLTR-32 cards.
AdslTrellisModeEnabled
Enables or disables trellis mode on the ADSL interface.
Values true
false
Default true
Access This parameter is read-write.
Location adsl-profile
AdslTransmissionMode
Specifies the line transmission mode for each ADSL line.
227
Parameters
Values autonegotiatemode
downshiftSnrMgn
The configured signal-to-noise margin for rate downshift. If the noise margin
falls below this level, the modem attempts to decrease its transmit rate.
Values 0 to 310 (in tenths dBs)
Default 0
Access This parameter is read-write.
Location adsl-co-profile, adsl-cpe-profile
Notes If rate adaption is not enabled on the interface, this parameter is 0 (zero).
228
ADSL
fastMaxTxRate
Configured maximum transmit rate (bps) for ADSL Fast channels.
Values 8160Kbps (1536Kbps for G.Lite) downstream 896Kbps (512Kbps for
fastMinTxRate
Minimum transmit rate (bps) for channels configured for fast transmission
mode.
Values 32Kbps to 8160Kbps (1536Kbps for G.Lite) downstream 32Kbps to
initFailureTrapEnable
Enables and disables the InitFailureTrap.This trap controls whether line up or
line down traps are sent while the system is booting up.
Values enable
disable
Default disable
Access This parameter is read-write.
Location adsl-co-profile
interleaveMaxTxRate
Maximum transmit rate (bps) for channels configured for interleaved
transmission mode.
229
Parameters
interleaveMinTxRate
Minimum transmit rate (bps) for channels configured for interleaved
transmission mode.
Values 32Kbps to 8160Kbps (1536Kbps for G.Lite) downstream 32Kbps to
maxInterleaveDelay
Maximum interleave delay for this channel. Interleave delay applies only to
the interleave channel and defines the mapping (relative spacing) between
subsequent input bytes at the interleaver input and their placement in the bit
stream at the interleaver output. Larger numbers provide greater separation
between consecutive input bytes in the output bit stream allowing for
improved impulse noise immunity, but at the expense of payload latency.
Values 0
0.5 ms
1
1 ms
2
2 ms
4
4 ms
8
8 ms
230
ADSL
16
16 ms
32
32 ms
63
63 ms
Default 0
Access This parameter is read-write.
Location adsl-co-profile, adsl-cpe-profile
maxSnrMgn
Maximum acceptable signal to noise margin. If the noise margin rises above
this level, the modem reduces its power output to optimize its operation.
Values 0 to 310 (in tenths dBs)
Default 310
Access This parameter is read-write.
Location adsl-co-profile, adsl-cpe-profile
minDownshiftSnrMgn
Minimum time that the current signal to noise margin is below
DownshiftSnrMgn before a rate downshift occurs.
Values 0 to 16383 seconds
Default 0
Access This parameter is read-write.
Location
adsl-cpe-profile
Notes If rate adaption is not enabled on the interface, this parameter is 0 (zero).
Unsupported.
minDownshiftTime
Minimum time that the current margin is below DownshiftSnrMgn before a
downshift occurs.
Values 0 to 16383 seconds
Default 0
Access This parameter is read-write.
Location adsl-co-profile, adsl-cpe-profile
Notes If rate adaption is not enabled on the interface, this parameter is 0 (zero).
231
Parameters
minSnrMgn
Minimum acceptable signal-to-noise margin. If the noise margin falls below
this level, the modem attempts to increase its power output. If that is not
possible, the modem will attempt to reinitialize or shut down.
Values 0 to 310 tenths of dBs
Default 0
Access This parameter is read-write.
Location adsl-cpe-profile
minUpshiftSnrMgn
Minimum time that the current margin is above UpshiftSnrMgn before an
upshift occurs.
Values 0 to 16383 seconds
Default 0
Access This parameter is read-write.
Location adsl-co-profile, adsl-cpe-profile
Notes If rate adaption is not enabled on the interface, this parameter is 0 (zero).
rateChanRatio
The percentage of excess bit rate that the ADSL modem will distribute to the
fast channel. The ratio is defined by the following formula:
[fastMinTxRate / (fastMinTxRate + interleaveMinTxRate)] x 100.
For example, a ratio of 50 percent means that 50 percent of the additional bit
rate (in excess of the fast minimum plus the interleaved minimum bit rate)
will be assigned to the fast channel, and 50 percent to the interleaved channel.
Values 50
Default 50
Access This parameter is read-write.
Location adsl-co-profile, adsl-cpe-profile
Notes See ADSL Forum TR-005 [3] for more information.
rateMode
The transmit rate adaptation configured on this modem.
232
ADSL
Values fixed
reachExtendedAdsl2
Enables and disables extended reach for ADSL2 long loops.
Access This parameter is read-write.
Location adsl-co-profile, adsl-cpe-profile
targetSnrMgn
Target signal to noise margin. This is the noise margin the modem must
achieve with a Bit Error Rate (BER) of 10-7 or better to successfully complete
initialization.
Values 0 to 310 tenths of dBs
Default 0
Access This parameter is read-write.
Location adsl-co-profile, adsl-cpe-profile
threshFastRateDown
Applies to Fast channels only. The change in the configured rate that causes
the system to send an adslAturRateChangeTrap.
The system sends a trap whenever:
ChanCurrTxRate <= ChanPrevTxRate minus the value of this parameter.
Default 0
233
Parameters
thresh15MinESs
The number of Errored seconds encountered by an ADSL interface within any
given 15 minutes performance data collection period that will cause the
SNMP agent to send an adslAtucPerfESsThreshTrap (CO) or
adslAturPerfESsThreshTrap (CPE) trap. One trap is sent per interval per
interface.
Values 0 to 900 seconds
thresh15MinLofs
The number of Loss of Frame Seconds encountered by an ADSL interface
within any given 15 minutes performance data collection period that will
cause the SNMP agent to send an adslAtucPerfLofsThreshTrap (CO) or
adslAturPerfLofsThreshTrap (CPE) trap. One trap is sent per interval per
interface.
Values 0 to 900 seconds
thresh15MinLols
The number of Loss of Link seconds encountered by an ADSL interface
within any given 15 minutes performance data collection period that will
cause the SNMP agent to send an adslAtucPerfLolsThreshTrap (CO) or
adslAturPerfLolsThreshTrap (CPE) trap. One trap is sent per interval per
interface.
Values 0 to 900 seconds
234
ADSL
thresh15MinLoss
The number of Loss of Signal seconds encountered by an ADSL interface
within any given 15 minutes performance data collection period that will
cause the SNMP agent to send an adslAtucPerfLossThreshTrap (CO) or
adslAturPerfLossThreshTrap (CPE) trap. One trap is sent per interval per
interface.
Values 0 to 900 seconds
thresh15MinLprs
The number of Loss of Power seconds encountered by an ADSL interface
within any given 15 minutes performance data collection period that will
cause the SNMP agent to send an adslAtucPerfLprsThreshTrap (CO) or
adslAturPerfLprsThreshTrap (CPE) trap. One trap is sent per interval per
interface.
Values 0 to 900 seconds
threshFastRateUp
Applies to Fast channels only. The change in the configured rate that causes
the system to send an adslAtucRateChangeTrap.
The system sends a trap whenever:
ChanCurrTxRate <= ChanPrevTxRate minus the value of this object.
Values 0
235
Parameters
threshInterleaveRateDown
Applies to Interleave channels only. The change in the configured rate that
causes the system to send an adslAtucRateChangeTrap.
The system sends a trap whenever:
ChanCurrTxRate <= ChanPrevTxRate minus the value of this object.
Values 0
threshInterleaveRateUp
Applies to Interleave channels only. The change in the configured rate that
causes the system to send an adslAturRateChangeTrap. The system sends a
trap whenever: ChanCurrTxRate >= ChanPrevTxRate plus the value of this
object.
Values 0
upshiftSnrMgn
The configured signal to noise margin for rate upshift. If the noise margin
rises above this level, the modem attempts to increase its transmit rate.
Values 0 to 310 tenths of dBs
Default 0
Access This parameter is read-write.
Location adsl-co-profile, adsl-cpe-profile
Notes If rate adaption is not enabled on the interface, this parameter is 0 (zero).
236
ATM
ATM
admin_status
Specifies the desired administrative state of the virtual channel link (VCL).
Values up
down
Default down
Location atm-vcl
Notes This parameter should be set to tell the system whether or not to establish the
connection.
The admin status must be set to down before changing or deleting VCLs.
admin-status
Administrative status of the link.
Values up
down
Default down
Location aal2-cid-profile, atm-cc
algorithm
The AAL2 encoding algorithm.
Values
G.711
Pulse Code Modulation (PCM). Two encoding laws are recommended,
referred to as A-law and Mu-law.
G.722
Sub-Band Adaptive Pulse Code Modulation (SB-ADPCM).
G.723.1
Not currently supported.
G.726
Adaptive Pulse Code Modulation (ADPCM).
G.727
Embedded Adaptive Pulse Code Modulation (EADPCM).
G.728
Low Delay Code Excited Linear Prediction (LD-CELP).
G.729-8
EDU format.
237
Parameters
G.729
Silence Insertion Descriptor (SID) packet format.
G.729-6.4
Encoding data unit format.
G.729-12
Encoding data unit format for the forward adaptive mode.
Generic SID
Generic SID packet format.
Default G.711
Location aal2-audio-profile
Notes Refer to STR-VMOA-LES-01-00 Annex A, I.366.1 7.7.1, and I.366.2 Annex
app-id
Application Identifier. It specifies the protocol used between the IAD and the
ATM switch.
Values caspotsonlynoelcp
atmVplAdminStatus
Administrative status of the VPL.
Values up
down
Default down
Location atm-vpl
Notes This parameter should be set to tell the system whether or not to establish the
connection.
238
ATM
The admin status must be set to down before changing or deleting VPLs.
atmVplCastType
Type of connection.
Values p2p
Point-to-point.
p2mproot
Point-to-multipoint root. Currently not supported.
p2mpleaf
Point-to-multipoint leaf. Supported for IP video connections only.
Location atm-vpl
atmVplConnKind
The type of VCL.
Values pvc
Location atm-vpl
atmVplReceiveTrafficDescrIndex
Specifies the ATM traffic descriptor which applies to the receive direction of
this VPL.
Values The index value of an existing atm-traf-descr.
Location atm-vpl
Notes Currently this value must be set equal to the value used for the
atmVplTransmitTrafficDescrIndex.
Traffic descriptors used in active VPLs cannot be modified. You must bring
down the VPL before you can modify the traffic descriptor.
See Also atmVplTransmitTrafficDescrIndex
atmVplTransmitTrafficDescrIndex
Specifies the ATM traffic descriptor which applies to the transmit direction of
this VPL.
Values The index value of an existing atm-traf-descr.
Location atm-vpl
Notes Currently this value must be set equal to the value used for the
atmVplReceiveTrafficDescrIndex.
Traffic descriptors used in active VPLs cannot be modified. You must bring
down the VPL before you can modify the traffic descriptor.
239
Parameters
audio-profile-identifier
An index number that refers to the type of audio service provided.
Values 7
For pre-defined audio profiles, the range of valid identifier values is 1 to 255,
inclusive. If the audio profile is user-defined, the range of valid identifiers is
256 to 512.
audio-service
The audio-service setting is inherited by the CIDs attached to the AAL2 VCL.
Values enabled
240
ATM
cas
Channel Associated Signaling (CAS). This setting is inherited by the CIDs
attached to the AAL2 VCL.
Values enabled
disabled
Default enabled
Location aal2-vcl-profile, aal2-cid-profile
cac-divider
Enables oversubscription for an ATM VCL. During CAC calculations, the
system divides the SCR (for nrt-VBR or rt-VBR VCLs) bandwidth by the
value specified in the cac-divider. It then uses that value to determine if the
VCL can be created.
For example, to configure a 4:1 oversubscription, set cac-divider to 4.
Default 1
Location atm-traf-descr
cc-index
A unique value used to identify the cross connect.
Location atm-cc
fault-detection-type
Used to determine faults on the VCL.
Values disabled
241
Parameters
frame-mode-data
The transport of data units as specified in the transmission error detection
service of Recommendation I.366.1. This setting is inherited by the CIDs
attached to the AAL2 VCL.
Values enabled
disabled
Default disabled
Location aal2-vcl-profile, aal2-cid-profile
high-if-index
The index (in the form shelf-slot-port-subport-interface/atm or a user-defined
string) of the ATM interface for this cross connect. The high-if-index is
arbitrary, but by convention it indicates the ATM interface with a numerically
higher ifIndex value than the other ATM interface identified in the same cross
connect.
Location atm-cc
Notes The low-if-index and the high-if-index cannot be equal.
high-vci
The VCI value associated with the interface specified in the high-if-index.
For VP switched connections, specify 0.
Location atm-cc
high-vpi
The VPI value associated with the interface specified in the high-if-index.
Location atm-cc
low-if-index
The index (in the form shelf-slot-port-subport-interface/atm or a user-defined
string) of the ATM interface for this cross connect. The low-if-index is
arbitrary, but by convention it indicates the ATM interface with a numerically
lower ifIndex value than the other ATM interface identified in the same cross
connect.
Location atm-cc
Notes The low-if-index and the high-if-index cannot be equal.
242
ATM
low-vci
The VCI value associated with the interface specified in the low-if-index. For
VP switched connections, specify 0.
Location atm-cc
low-vpi
The VPI value associated with the interface specified in the low-if-index.
Location atm-cc
max-cid-for-aal2-user-channels
Maximum Channel Identifier (max-cid) value for AAL2 user channels as
defined by the ATM Forum.
Values For an app-id values of caspotsonlynoelcp and dss1brionlynoelcp, the
max-cps-sdu-size
Specifies the AAL2 payload in octets that can be sent and received.
Values 64 octets
45 octets
Default 45
Location aal2-vcl-profile
max-length-frame
The maximum length of the frame that this channel will accept.
Values This setting is inherited by the CIDs attached to the AAL2 VCL.
Location aal2-vcl-profile, aal2-cid-profile
max-number-multiplex-channels
The maximum number of channels that can be multiplexed within the VCL.
243
Parameters
max-sdu-length
The maximum size of the SDU, in octets, that is allowed to be reassembled.
Values 1 to 65568, inclusive
Location aal2-vcl-profile, aal2-cid-profile
min-cid-for-aal2-user-channels
The minimum number of Channel Identifiers (CID) allowed for AAL2 user
channels.
Values For an app-id values of caspotsonlynoelcp and dss1brionlynoelcp, the
pcm-encoding
The type of Pulse Code Modulation encoding used.
Values muLaw
aLaw
Location aal2-vcl-profile, aal2-cid-profile
pkt-time
Packet time in tenths of milliseconds.
Values 50 to 110, inclusive
Default 55
Location aal2-audio-profile
preferred-ap-index
Defines the preferred audio encoding format.
244
ATM
Values 1
ras-timer
The maximum time allowed for ReASsembly of a SSSAR-SDU.
Values milliseconds
Location aal2-vcl-profile, aal2-cid-profile
receive_traffic_descr_index
Specifies the ATM traffic descriptor which applies to the receive direction of
this VCL.
Values The index value of an existing atm-traf-descr.
Location atm-vcl
Notes Currently this value must be set equal to the value used for the
transmit_traffic_descr_index.
Traffic descriptors used in active VCLs cannot be modified. You must bring
down the VCL before you can modify the traffic descriptor.
See Also transmit_traffic_descr_index
sdu-multiples
Indicates the multiples of the service data unit (SDU) for each algorithm that
occurs. SDUs for audio are defined in relation to the profile of encoding
formats adopted on an AAL type 2 connection. Each algorithm that occurs in
a given profile may appear in multiple entries corresponding to packets of
different lengths. These packet lengths align in a simple sequence, where each
is an integral multiple of the smallest packet length that occurs for the
algorithm (at a given bit rate). The smallest packet length is the SDU of the
algorithm, in relation to the given profile.
Values 1 to 8
Default 1
Location aal2-audio-profile
See Also algorithm
245
Parameters
sscs-type
The Service Specific Convergence Sublayer (SSCS) is the portion of the
convergence sublayer that is dependent upon the type of traffic that is being
converted.
Values i3661
For channels that carry control and management plane traffic (such as
CCS, ELCP, ISDN D channels, and LES-EOC).
i3662
For channels carry media streams (such as POTS or ISDN B channels).
Default i3662
Location aal2-cid-profile
td_index
This parameter is used by the atm-vcl profile to identify a traffic descriptor.
Location atm-traf-descr
td_frame_discard
Enables and disable early-packet-discard (EPD) and partial-packet-discard
(PPD). This allows selective discarding of all cells in a frame if one cell is lost
or discarded.
In EPD, the ATM interface monitors the AAL5 traffic and discards an entire
data frame if its output buffers do not have the space to process it. In PPD, the
ATM interface drops the remaining cells of the packet if other cells of the
packet have already been dropped. Both of these techniques increase the
efficiency of the data transfer by dropping frames that have already been
determined to be errored and will have to be retransmitted.
Values true
Indicates that the network is requested to treat data for this connection, in
the given direction, as frames (that is, AAL5 CPCS PDUs) rather than as
individual cells. While the precise implementation is network-specific,
this treatment may involve discarding entire frames during congestion,
rather than a few cells from many frames.
false
This is the recommended setting for voice connections.
Default false
Location atm-traf-descr
246
ATM
td_param1
The peak cell rate (PCR) of the interface. Once the peak cell rate (PCR) has
been set, traffic policing ensures that the PCR limitations are enforced. The
system will discard cells of incoming (ingress) traffic that exceed the PCR.
Location atm-traf-descr
Notes
Refer to the documentation that came with your device for information
about supported traffic parameters.
td_param2
Sustained cell rate (SCR) of the interface. Refer to the documentation that
came with your device for information about supported traffic parameters.
Location atm-traf-descr
Notes The td_param1 and td_param2 parameters in the atm-traf-descr profile
td_param3
Maximum burst size (MBS) of the interface. Refer to the documentation that
came with your device for information about supported traffic parameters.
Location atm-traf-descr
td_param4
Cell delay variation tolerance (CDVT) of the interface. Refer to the
documentation that came with your device for information about supported
traffic parameters.
Location atm-traf-descr
td_param5
Currently not supported.
Location atm-traf-descr
247
Parameters
td_service_category
The ATM service category. Zhone devices support currently support the
following classes of traffic:
Unspecified bit rate (UBR) for data. Supported on the BAN, MALC,
Raptor, Z-Edge.
Constant bit rate (CBR) for voice. Supported on the MALC, Raptor,
Sechtor 100A, Z-Edge.
Real time variable bit rate (rt-VBR) for voice or data, depending on the
application. Supported on the BAN, MALC, Raptor, Sechtor 100A.
Non-real time variable bit rate (nrt-VBR) for voice or data, depending on
the application. Supported on the MALC.
Location atm-traf-descr
td_type
Traffic descriptor type. Note that not all products support all traffic types.
Refer to the documentation that came with your device for information about
supported traffic categories.
Values atmNoClpNoScr
(OID 1.3.6.1.2.1.37.1.1.2)
No CLP and no Sustained Cell Rate.
atmClpTaggingNoScr
(OID 1.3.6.1.2.1.37.1.1.4)
CLP with tagging and no Sustained Cell Rate.
atmClpNoTaggingScr
(OID 1.3.6.1.2.1.37.1.1.6)
CLP with no tagging and Sustained Cell Rate.
atmClpTaggingScr
(OID 1.3.6.1.2.1.37.1.1.7)
CLP with tagging and Sustained Cell Rate.
atmClpTransparentNoScr
(OID 1.3.6.1.2.1.37.1.1.9)
CLP transparent and no Sustained Cell Rate.
atmClpTransparentScr
(OID 1.3.6.1.2.1.37.1.1.10)
CLP transparent and Sustained Cell Rate.
atmNoClpNoScrCdvt
(OID 1.3.6.1.2.1.37.1.1.12)
No CLP and no Sustained Cell Rate.
248
ATM
atmClpNoTaggingScrCdvt
(OID 1.3.6.1.2.1.37.1.1.14)
CLP with no tagging, Sustained Cell Rate.
atmClpTaggingScrCdvt
(OID 1.3.6.1.2.1.37.1.1.15)
CLP with tagging, Sustained Cell Rate.
Location atm-traf-descr
timer-cu
The timer-cu is always set to 0. Each transmitted ATM contains one AAL2
packet.
Values 0
Location aal2-vcl-profile
traffic-container-index
This parameter associates a VCL with a traffic container, and is used to
retrieve PON channel provisioning information.
Location atm-vcl
transmit_traffic_descr_index
Specifies the ATM traffic descriptor which applies to the transmit direction of
this VCL.
Values The index value of an existing atm-traf-descr.
Location atm-vcl
Notes Currently this value must be set equal to the value used for the
receive_traffic_descr_index.
Traffic descriptors used in active VCLs cannot be modified. You must bring
down the VCL before you can modify the traffic descriptor.
See Also transmit_traffic_descr_index
trnk-vcl-rate
This parameter is used to describe the minimum guaranteed rate for a VCL
which is bound to this traffic descriptor for BAN ATM Trunk cards. It is
applicable only for the rt-VBR service category.
Access This parameter is read-write.
Location atm-traf-descr
Notes The trnk-rate-vcl parameter in atm-traf-descr profiles is only used on BAN
249
Parameters
trunk-type
Specifies supervisory line states, for example, on-hook, off-hook, idle, and
ringing. The trunk-type used for the IAD (Z-Edge) must match the ATM
switch trunk type. This parameter is used only for app-id values of
caspotsonlynoelcp.
Values unknown
loopstart
groundstart
loopreversebattery
Default loopstart
Location aal2-vcl-profile
usage-parameter-control
UPC is the process of monitoring and controlling the ATM traffic by
enforcing the traffic parameters. By using this parameter, you can disable on a
per-traffic descriptor basis. This is typically only done during debugging.
Values true
vcc_aal5_encaps_type
This parameter applies only when the local VCL end-point is also the VCC
end-point, and AAL5 is in use. The type of data encapsulation used over the
AAL5 SSCS layer. The definitions reference RFC 1483 Multiprotocol
Encapsulation over ATM AAL5 and to the ATM Forum LAN Emulation
specification.
Values llcencapsulation
250
ATM
Location atm-vcl
vcc_aal_type
The type of AAL used on this VCC. This parameter applies only when the
local VCL end-point is also the VCC end-point, and AAL is in use.
Values aal5
vcc-i
The VCC Identifier. It is used to differentiate aal2-vcl-profiles and is used to
match profiles between IADs and ATM switches.
Values integer
Location aal2-vcl-profile
vci
The VCI value for this virtual channel link (VCL). This must match the
remote end of the connection.
Location atm-vcl
Notes The maximum VCI value cannot exceed the value allowable by
vcl_cast_type
The connection topology type.
Default p2p
Location atm-vcl
vcl_conn_kind
The use of call control.
Default pvc
251
Parameters
Location atm-vcl
The SCR for rt-VBR traffic descriptors must use one of the first 16 rates.
The PCR for CBR traffic descriptors can use any of the 32 rates.
Rates must be in ascending order within the first 16 rates and also within
the second 16 rates.
Location atm-vcl-param
Notes
252
Application
38
1 to 2 DS0s
at 5:1 to 10:1 oversubscription
76
2 to 4 DS0s
at 5:1 to 10:1 oversubscription
151
4 to 8 DS0s
at 5:1 to 10:1 oversubscription
ATM
Application
189
1 DS0
no oversubscription
302
8 to 16 DS0s
at 5:1 to 10:1 oversubscription
378
2 DS0
no oversubscription
604
16 to 32 DS0s
at 5:1 to 10:1 oversubscription
755
4 DS0
no oversubscription
1208
32 to 64 DS0s
at 5:1 to 10:1 oversubscription
1510
8 DS0
no oversubscription
3661
Full T1
4825
Full E1
28302
8 T1s
37736
8 E1s
106133
DS3
365567
OC3-c/STM1
voicebandwidthcheck
Enables or disables ATM bandwidth checking for voice calls. The system will
reject a call if there is not enough bandwidth. On a MALC or a Z-Edge, if a
call is rejected, the device sends a fast busy to the caller. On the BAN or the
Sechtor 100A, if a call is rejected, the switch sends a busy signal to the caller.
Note: Bandwidth calculations are enabled or disabled for the entire
system.
The bandwidth check is based on the configuration of the transmit and receive
ATM traffic descriptors for the ATM VC/CID used by the call. The system
uses the following parameters to calculate the required bandwidth:
All other traffic types: calls are always accepted, there are no voice
quality guarantees.
253
Parameters
false
Default false
Location system profile
vpi
The VPI value for a VPL or VCL. This must match the remote end of the
connection.
Values
Valid values differ depending on the type of device and its revision level.
Refer to the configuration guide for your device for valid ranges.
Location atm-vcl
Notes The maximum VPI value cannot exceed the value allowable by
zhoneAtmMaxVciPerVp
Specifies the maximum number of VCIs supported in a VP-switched VPI on
the MALC Voice Gateway card.
Default 0
Location atm-vpi
Notes Refer to the release notes for the maximum values for a particular device.
zhoneAtmVpiMaxVci
For the selected VPI, this value specifies the maximum VCI. For VP switched
VPIs, this value must be zero.For VC switched VPIs, this value must be a
power of 2.
Default 0
Location atm-vpi
Notes Refer to the release notes for the maximum values for a particular device.
254
Bridging
zhoneAtmVpiSwitched
Indicates whether the VPI is VP or VC switched.
Values vp
vc
Default vp
Location atm-vpi
Bridging
bridgeConfigType
Specifies the type of filter to be applied to packets on the interface.
Values bridgeinsertoption82
bridgeConfigValue
If the bridgeConfigType is set to bridgeforbidoui, this parameter specifies
the OUI or first 3-bytes of the MAC address in the format nn:nn:nn, where nn
represents a hex number designating a byte. If the bridgeConfigType is set to
bridgeinsertoption82, this parameter contains a text string that is inserted
into the DHCP packet.
Values A string in the form nn:nn:nn, where nn represents a hexadecimal
bridgeIfConfigGroupIndex
Index used for bridge groups.
Default 0
Access This parameter is read-write.
255
Parameters
Location bridge-interface-record
Products MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723
bridgeIfCustomDHCP
Determines the handling of DHCP offer messages from remote DHCP
servers.
Values true
customARP
Determines how the BAN treats ARP packets. When a BAN receives a ARP
packet, it compares and filters the requested IP address with the current
forwarding table. If a match is found, the ARP broadcast is forwarded out the
interface that has the appropriate host. This host will then reply to the ARP
with a standard response. If a match is not found, then the ARP is filtered and
it gets dropped as if it were a non-ARP broadcast.
Values true
filterBroadcast
Determines how the BAN handles non-ARP broadcast packets.
Values true
256
Bridging
false
Non-ARP broadcast packets are forwarded.
Default false
Access This parameter is read-write.
Location bridge-interface-record
Products MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723
forwardToDefault
If true, attempt to forward via VLAN default paths.
Default false
Access This parameter is read-write.
Location bridge-interface-record
Products MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723
forwardToMulticast
If true, attempt to forward via multicast MAC paths.
Default false
Access This parameter is read-write.
Location bridge-interface-group
Products MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723
forwardToUnicast
If true, attempt to forward via unicast MAC paths.
Default false
Access This parameter is read-write.
Location bridge-interface-record
Products MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723
learnIP
If true, snoop unicast packets to build ARP table.
Default false
Access This parameter is read-write.
Location bridge-interface-record
Products MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723
257
Parameters
learnMulticast
If true, snoop multicast packets for IGMP joins/leaves.
Default false
Access This parameter is read-write.
Location bridge-interface-record
Products MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723
learnUnicast
If true, snoop unicast packets to build MAC paths.
Default false
Access This parameter is read-write.
Location bridge-interface-record
Products MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723
maxUnicast
Maximum number of unicast addresses for I/F.
Access This parameter is read-write.
Location bridge-interface-record
Products MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723
StripAndInsert
If true, enable VLAN Tagging.
Default false
Access This parameter is read-write.
Location bridge-interface-record
Products MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723
vci
If this bridge interface is on an ATM VCL, this is the ATM VCI. If the bridge
interface is not an ATM VCL, (for example an Ethernet interface), this
parameter is 0.
Access This parameter is read-write.
Location bridge-interface-record
Products MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723
258
Card
vlanId
The Virtual LAN Id for VLAN tag insertion.
Default 0
Access This parameter is read-write.
Location bridge-interface-record
Products MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723
vpi
The VPI value for a VPL or VCL. The VPI value of 0 is only allowed for a
VCL.
Default 0
Access This parameter is read-write.
Location bridge-interface-group
Products MALC, Raptor 100, Raptor 319, Raptor 719, Raptor 723
Card
admin-status
Specifies the administrative status of the unit or card.
Values operational
The unit or card enters the operational state if it is able. In the operational
state the unit or card is able to accept requests from other devices; or, if it
is a stand-alone device, it is able to process requests from the wide area
network (WAN) or local interfaces.
disable
The unit or card ceases to accept requests from other devices. If the unit
or card is operational and receives this command it completes processing
of open requests if able.
maintenance
Enter a special maintenance state if available. If not available enter the
disabled state and set admin-status to disabled.
warm reset
Perform a warm reset of system software that does not reinitialize or reset
hardware resources.
reset
Perform an immediate full reset. Following a successful reset the unit or
card should enter the operational state.
259
Parameters
Location card-profile
See Also sw-status
admin-status-enable
Enables the collection and forwarding of historical statistics on the unit or
card.
Note: This value should be combined with the system statistics to
determine if the collection and forwarding of statistics should be
enabled.
Values enabled
disabled
Default disabled
Location card-profile
card-group-id
The unique redundancy group to which the card is assigned. A card group can
contain at most two cards and redundant card pairs must be in the same card
group.
Values 0 to 65535
Default 0 (indicates no redundancy group configured)
Notes Redundancy group IDs must be non-zero.
A non-zero card-group-id cannot be changed. You must delete the cardprofile and recreate it.
card-atm-configuration
Specifies bandwidth allocation for rt-VBR and UBR traffic and used by
Connection Admission Control (CAC). This parameter only applies to ATM
trunking interfaces, such as MALC and Raptor Uplink cards, as well as BAN
ATM trunking cards.
Note: The Raptor 100 does not support CBR.
Values notapplicable
260
Card
261
Parameters
card-line-type
Specifies the line type of the card and the signaling that runs over it. Does not
apply to MALC OC3-c/STM1 Uplink cards.
262
Card
Values unknowntype
Unknown mode. Used for cards that do not support this parameter.
e1
E1 UNI mode.
ds1
DS1 UNI mode
e1-ima
E1 ATM IMA mode (MALC T1/E1 IMA Uplink card)
ds1-ima
DS1 ATM IMA mode (MALC T1/E1 IMA Uplink card)
e3
E3 UNI mode
ds3
DS3 UNI mode
t1-uni-gr303
T1 UNI mode of ATM and GR-303 TDM signaling (MALC T1/E1 TDM
Uplink card)
t1-ima-gr303
T1 IMA mode of ATM and GR-303 TDM signaling (MALC T1/E1 TDM
Uplink card)
e1-uni-v52
E1 UNI mode of ATM and V5.2 TDM signaling (MALC T1/E1 TDM
Uplink card)
e1-ima-v52
E1 IMA mode of ATM and V5.2 TDM signaling (MALC T1/E1 TDM
Uplink card)
gshdsl
SHDSL (Raptor 100 SHDSL Uplink model).
t1-uni-t1cas
Used for POTS to DS1 connections on the T1/E1 TDM card or OC12-c/
STM4 Uplink cards.
t1-ima-t1cas
Used for POTS to E1 connections on the T1/E1 TDM card or OC12-c/
STM4 Uplink cards.
rpr
RPR data-only mode (the default for the 2 port GigE RPR card).
rpr-t1-gr303
RPR with data and GR-303 voice.
rpr-e1-v52
RPR with data and V5.2 voice
rpr-t1cas
RPR with data and T1 CAS voice
263
Parameters
adsl-pots
ADSL and TDM POTS. Supported on ADSL 48 port cards only.
adsl-pots-pv
ADSL and packet voice. Supported on ADSL 48 port cards only.
adsl-splitter
ADSL with splitter. Supported on ADSL 48 port cards only.
pots
TDM POTS. Supported on the POTS 48 port card only.
pots-pv
Packet voice. Supported on the POTS 48 port card only.
Location card-profile
Notes Does not apply to DSL card, the MALC ULC card, or POTS cards.
hold-active
When set to true, this indicates that the card, when Active, should remain in
the Active state regardless of any system events. This effectively disables
redundancy for the card group.
Location card-profile
name
Name of the software image to load for the card. If the name is not specified,
the slot card loads the image specified in the card-profile for the slot.
Location card-profile
sw-enable
Specifies whether a software download for the slot card is enabled.
Values true
Enables the system to download the binary for that slot card when the
card is reset.
false
Software is not downloaded to the slot card. This effectively disables the
slot card.
Default false
Location card-profile
Notes The slot card loads the software binary specified in the type-module record
for the card if it is not specified in the card-profile record for that slot.
See Also name, upgrade-sw-file-name
264
Card
sw-file-name
The file or code image name of the software version that should be loaded by
the unit or card for operation.
The operation of this parameter varies depending on the type of device.
BAN. MALC, and Raptor: The card will load the specified software
image. If the sw-file-name is not specified, the card will load the image
specified in the type-module for the slot card.
Location card-profile
Notes If a failure occurs when loading an upgrade version, the system automatically
sw-pri-load-server
The IP address of the primary software load server. This parameter is not used
by BAN, MALC, or Raptor cards. If the value of this parameter is set to
0.0.0.0 then no primary load server is available.
Location card-profile
Notes If the system is unable to load the software file from the primary load server,
the system attempts to load the software from the secondary load server.
sw-upgrade-admin
How the unit should be upgraded.
Values loadupgradesw
The device requests a load of the upgrade software from the image
previously downloaded to the system. If an upgrade version of the
software is not available or the upgrade server is unable to respond to the
load request, the card will set sw-status to upgradeloadFailed.
upgradenow
The device upgrades to the already loaded upgrade software if warm
upgrade is supported or it will reboot and load the upgrade software if
warm upgrade is not supported. If the upgrade software has not been
loaded or there is no grade software load available, the device will set
265
Parameters
type
This parameter definition differs depending on its location:
Location card-profile
upgrade-sw-file-name
The file name of the software image that should be loaded by the unit or card
at the next upgrade. If this is not specified, the name of the image specified in
the type-module record for the slot card is downloaded instead.
Location card-profile
See Also name
upgrade-vers
The software version that is loaded into the unit or card memory that can be
loaded after a warm reboot of the system.
Location card-profile
weight
A weight given to this card that determines whether this card should become
the active card after both cards are reset. Cards in a card group negotiate
which cards are active and standby by comparing weights. Cards with higher
preferences become active. If multiple cards have the same weight, the card in
the lower numbered slot becomes active.
Values noPreference
No preference.
266
neveractive
The card never becomes active.
slightpreference
mediumpreference
highpreference
Default noPreference
cas
Specifies which AAL1 Format should be used. This applies to structured
interfaces only.
For unstructured interfaces this value, if present, must be set to the default of
basic.
Values basic
No CAS bits with a single 125 usec frame. Default. Required for
unstructured channels.
e1cas
CAS bits used in E1 multiframe structure.
ds1esfcas
CAS bits used in DS1 ESF multiframe structure.
ds1sfcas
CAS bits used in DS1 SF multiframe structure.
Default basic
Access This parameter is read-write.
Location ces-config
Products MALC
267
Parameters
cell-loss-integration-period
The time in milliseconds for the cell loss integration period.
Default 2500
Access This parameter is read-write.
Location ces-config
Products MALC
destination-ip-address
Shows the configured destination IP address of the CES over IP connection.
Access This parameter is read-only.
Location ces-config
Products MALC
destination-port
Shows the configured destination UPD port number of the CES over IP
connection.
Access This parameter is read-only.
Location ces-config
Products MALC
ds0-bundle
Lists the specified DS0 bundles.
Access This parameter is read-only.
Location ces-config
Products MALC
partial-fill
Specifies the number of user octets per cells. Setting this parameter to zero
disables partial cell fill, and causes all cells to be completely filled before they
are sent.
Default 0
Access This parameter is read-write.
Location ces-config
Products MALC
268
Clocking
source-ip-address
Shows the configured source IP address of the CES over IP connection.
Access This parameter is read-only.
Location ces-config
Products MALC
source-port
Shows the configured source UPD port number of the CES over IP
connection.
Access This parameter is read-only.
Location ces-config
Products MALC
vci
The VCI used by the ATM VCL mapped through this CES IWF to a CBR
interface. Zero indicates that no ATM VCL has been specified.
Default 0
Access This parameter is read-write.
Location ces-config
Products MALC
vpi
The VPI used by the ATM VCL mapped through this CES IWF to a CBR
interface.
Default 0
Access This parameter is read-write.
Location ces-config
Products MALC
Clocking
clock-transmit-source
Specifies the OC3-c/STM1 or OC12-c/STM4 clocking mode. The default is
looptiming.
269
Parameters
Values looptiming
The recovered receive clock from the interface is used as the transmit
clock.
localtiming
A local (to the interface) clock source is used on the transmit signal.
throughtiming
The transmit clock is derived from the recovered receive clock of another
interface. Interfaces that are designated as eligible clock sources cannot
be set to through timing.
Default looptiming
Location sonet-profile
Products
primaryclocksource
The shelf-slot-port-subport/type of an interface to provide clocking for the
system.
Note: system-clock-profiles (if supported on the device) are the
preferred method of configuring clock sources.
Values A valid interface on the system.
For the BITS clock on the MALC MTAC/Ring card, specify the address
in the form shelf-slot-1-0/ds1.
Location system
Notes If configured, the setting in the primaryclocksource parameter overrides
revertiveclocksource
If a standby clock source becomes active after the failure of a primary clock
source, the system will revert to the primary clock source after that clock
source becomes active again. Note that the clock source must be active for 30
seconds before the system will revert back to the primary clock source.
Values true
270
Clocking
transmit-clock-source
Specifies the DS1/DS3 clocking mode.
Values looptiming
The recovered receive clock from the DS1/DS3 is used as the transmit
clock.
localtiming
A local (to the DS1/DS3 interface) clock source is used on the DS1/DS3
transmit signal.
throughtiming
The transmit DS1/DS3 clock is derived from the recovered receive clock
of another DS1/DS3 interface. Interfaces that are designated as eligible
clock sources cannot be set to through timing.
Default looptiming (DS3) throughtiming (DS1)
Location ds1-profile, ds3-profile
Products
system-clock-eligibility
Specifies whether the interface is eligible to provide clocking for the system.
The source must be active in order to provide clock. The following types of
interfaces can provide clock:
T1/E1
DS3/E3
OC3-c
OC12-c
Values true
false
Default false
Location system-clock-profile
Products BAN, MALC, Raptor, Sechtor 100A
system-clock-weight
Assigns a weight to the clock source. If you assign weight to a clock source
that is higher than the currently active clock source, the system will switch
over to that clock source.
Values 1 to 10
271
Parameters
Location system-clock-profile
Notes If you assign weight to a clock source that is higher than the currently active
clock source, or if you assign a clock source in the system profile, the system
will switch over to the new clock source.
Products BAN, MALC, Raptor, Sechtor 100A
DHCP
bootfile
The name of the initial boot file loaded by the client. The filename should be
recognizable to the file transfer protocol that the client will be using to load
the file.
Default
An empty string
boot-server
The IP address of the server from which the initial boot file (specified in the
bootfile parameter) is to be loaded. If this IP address is specified as 0.0.0.0
then the primary interface address of the DHCP server is used.
Default An empty string
Location dhcp-server-subnet, dhcp-server-host, dhcp-server-group
Products BAN, MALC, Raptor, Z-Edge, ZRG
client-hostname
Client host name (if any) that the client used to acquire its address.
Default An empty string
Location dhcp-server-lease
Products BAN, MALC, Raptor, Z-Edge, ZRG
client-identifier
The DHCP client identifier.
Default An empty string
Access This parameter is read-write.
Location dhcp-server-host
Products BAN, MALC, Raptor, Z-Edge, ZRG
272
DHCP
client-match-length
The length of the client identifier substring to match.
Default -1
Specifies that the entire string beginning at the match offset value should
be matched.
Access This parameter is read-write.
Location dhcp-server-group
Products BAN, MALC, Raptor, Z-Edge, ZRG
client-match-offset
The offset into the client passed client identifier string where the string match
should start.
Default 0 (zero)
Access This parameter is read-write
Location dhcp-server-group
Products BAN, MALC, Raptor, Z-Edge, ZRG
client-match-string
Client identifier match string that determines which clients should be placed
in this group.
Access This parameter is read-write
Location dhcp-server-group
Products BAN, MALC, Raptor, Z-Edge, ZRG
defaultLease
The default requested lease length, in seconds.
Values From 100 to 604800 (1 week).
Default 604800
Location dhcp-client-resource
Notes This value should be greater than or equal to the minLease.
Products BAN, MALC, Raptor, Z-Edge, ZRG
273
Parameters
default-lease-time
The default time, in seconds assigned to a lease if the client requesting the
lease does not request a specific expiration time.
Values From -1 - 2147483647
Default -1
default-router
The IP address of the client default gateway.
Default 0.0.0.0
Access This parameter is read-write.
Location dhcp-server-subnet, dhcp-server-group, dhcp-server-host
Products BAN, MALC, Raptor, Z-Edge, ZRG
dhcp
Specifies whether the IP interface is a DHCP client or server.
Values none
dhcpClientErrors
The number of errors that the DHCP client has encountered.
Access This parameter is read-only.
274
DHCP
Location dhcp-client-resource
Products BAN, MALC, Raptor, Z-Edge, ZRG
dhcpClientId
The DHCP client ID.
Location dhcp-client-lease-resource
Products BAN, MALC, Raptor, Z-Edge, ZRG
dns
A list of the DNS server and router IP addresses that the system will use.
Location dhcp-client-lease-resource
Products BAN, MALC, Raptor, Z-Edge, ZRG
dns-fwd-name
Dynamic DNS forward host name. Not currently used.
Location dhcp-server-lease
Products BAN, MALC, Raptor, Z-Edge, ZRG
dns-rev-name
Dynamic DNS reverse host name. Not currently used.
Location dhcp-server-lease
Products BAN, MALC, Raptor, Z-Edge, ZRG
domain
The routing domain to which this subnet, group, or host parameter applies.
Values 0 to 2147483647, inclusive
Access This parameter is read-write.
Location dhcp-server-subnet, dhcp-server-group, dhcp-server-host
Products BAN, MALC, Raptor, Z-Edge, ZRG
domainName
The name of the DHCP domain.
Access This parameter is read-only.
Location dhcp-client-lease-resource
275
Parameters
domain-name
The default domain name that the client should use when resolving host
names using DNS. The default is an empty string.
Default The default is an empty string.
Access This parameter is read-write.
Location dhcp-server-subnet, dhcp-server-group, dhcp-server-host
Products BAN, MALC, Raptor, Z-Edge, ZRG
ends
The time in Greenwich Mean Time (GMT) that the DHCP lease will expire.
Values 0 to 2147483647, inclusive.
Location dhcp-server-lease
Products BAN, MALC, Raptor, Z-Edge, ZRG
external-server
Non-null IP address value indicates use of external DHCP server instead of
internal DHCP for this subnet.
Default 00000000
Location dhcp-server-subnet
Products MALC
flags
Indicates how the DHCP host acquired its lease.
Values Static
The lease is static. Static leases typically should not appear in the lease
database.
bootp
The lease was allocated using the BOOTP protocol. BOOTP leases are
unsupported.
abandonedlease
A client appears to exist (for example, the device responds to a ping
command) on the network even though the DHCP server has not allocated
the lease address to the client. In this case, the server abandons that lease
and tries to reuse it only when it runs out of available addresses.
276
DHCP
zhonecpe
The client that was allocated a lease identified itself as a Zhone CPE
device (such as a Z-Edge).
Location dhcp-server-lease
Products BAN, MALC, Raptor, Z-Edge, ZRG
hardware-address
In the dhcp-server-lease profile, this parameter is the MAC address of the
network interface that was used to acquire the lease.
In the dhcp-server-host profile, this parameter is the hardware address of the
client that matches this host parameter. If the client-identifier parameter is
specified, the hardware address is ignored.
Default 0 (zero)
Access This parameter is read-write
Location dhcp-server-lease, dhcp-server-host
Notes Configure either the hardware-address or client-identifier for host
parameters.
Products BAN, MALC, Raptor, Z-Edge, ZRG
hostName
Name of the DHCP host. This will not be a fully-qualified host name.
Access This parameter is read-only.
Location dhcp-client-lease-resource
Products BAN, MALC, Raptor, Z-Edge, ZRG
ipaddr1
The fixed IP address that should be assigned to this client.
Default 0.0.0.0
Location dhcp-server-host
Products BAN, MALC, Raptor, Z-Edge, ZRG
ipaddr2
The fixed IP address that should be assigned to this client.
Default 0.0.0.0
Location dhcp-server-host
Products BAN, MALC, Raptor, Z-Edge, ZRG
277
Parameters
ipaddr3
The fixed IP address that should be assigned to this client.
Default 0.0.0.0
Location dhcp-server-host
Products BAN, MALC, Raptor, Z-Edge, ZRG
ipaddr4
The fixed IP address that should be assigned to this client.
Default 0.0.0.0
Location dhcp-server-host
Products BAN, MALC, Raptor, Z-Edge, ZRG
lease-time
The global default time in seconds that will be assigned to a DHCP lease if the
client requesting the lease does not request a specific expiration time.
Values 0 to 21474836471
Default 43200 seconds (12 hours).
Location dhcp-server-options
Products BAN, MALC, Raptor, Z-Edge, ZRG
max-lease-time
The maximum time in seconds that will be assigned to a lease regardless of
the value specified by a client.
Values
-1 to 2147483647
-1 indicates that this parameter is ignored.
dhcp-server-host
Products BAN, MALC, Raptor, Z-Edge, ZRG
max-uui
Maximum user to user indicator.
278
DHCP
Values 0 to 15
min-uui
Minimum user to user indicator.
Values 0 to 15
minLease
The minimum acceptable lease length.
Values 1 to 604800 (one week)
Default 300
Location dhcp-client-resource
Notes This value should not be greater than the defaultLease.
Products BAN, MALC, Raptor, Z-Edge, ZRG
min-lease-time
The minimum expiration time in seconds that will be assigned to a DHCP
lease by the server, regardless of the value specified by a client.
Values -1 to 2147483647
Default -1, which indicates that the parameter is ignored.
Location dhcp-server-options, dhcp-server-subnet, dhcp-server-group,
dhcp-server-host
Notes This value should not exceed the default-lease-time setting.
Products BAN, MALC, Raptor, Z-Edge, ZRG
name
In a dhcp-server-host record this indicates the host name for the client. This
may be fully qualified with the local domain name but it is recommended that
you use the domain-name parameter to specify the domain name.
279
Parameters
netmask
The subnet mask associated with the IP interface. The value of the mask is an
IP address with all the network bits set to 1 and all the hosts bits set to 0.
Access This parameter is read-write.
Location dhcp-server-subnet, ip-interface-record
Products BAN, MALC, Raptor, Z-Edge, ZRG
network
The IP network address of this subnet parameter.
Access This parameter is read-write.
Location dhcp-server-subnet
Products BAN, MALC, Raptor, Z-Edge, ZRG
primary-name-server
The IP address of the primary domain name server that the client should use
for DNS resolution.
Default 0.0.0.0.
Access This parameter is read-write.
Location dhcp-server-subnet, dhcp-server-group, dhcp-server-host
Products BAN, MALC, Raptor, Z-Edge, ZRG
range1-end
The last IP address of the first address pool in this subnet. If either the start or
end range has a value of 0, then the entire address pool is ignored.
Default 0.0.0.0
Location dhcp-server-subnet
Products BAN, MALC, Raptor, Z-Edge, ZRG
280
DHCP
range1-start
The starting IP address of the first address pool in this subnet. If either the
start or end range has a value of 0 then the entire address pool is ignored.
Default 0.0.0.0
Location dhcp-server-subnet
Products BAN, MALC, Raptor, Z-Edge, ZRG
range2-end
The last IP address of the second address pool in this subnet. If either the start
or end range has a value of 0, then the entire address pool is ignored.
Default 0.0.0.0
Location dhcp-server-subnet
Products BAN, MALC, Raptor, Z-Edge, ZRG
range2-start
The starting IP address of the second address pool in this subnet. If either the
start or end range has a value of 0, then the entire address pool is ignored.
Default 0.0.0.0
Location dhcp-server-subnet
Products BAN, MALC, Raptor, Z-Edge, ZRG
range3-end
The last IP address of the third address pool in this subnet. If either the start or
end range has a value of 0, then the entire address pool is ignored.
Default 0.0.0.0
Location dhcp-server-subnet
Products BAN, MALC, Raptor, Z-Edge, ZRG
range3-start
The starting IP address of the third address pool in this subnet. If either the
start or end range has a value of 0, then the entire address pool is ignored.
Default 0.0.0.0
Location dhcp-server-subnet
Products BAN, MALC, Raptor, Z-Edge, ZRG
281
Parameters
range4-end
The last IP address of the fourth address pool in this subnet. If either the start
or end range has a value of 0, then the entire address pool is ignored.
Default 0.0.0.0
Location dhcp-server-subnet
Products BAN, MALC, Raptor, Z-Edge, ZRG
range4-start
The starting IP address of the fourth address pool in this subnet. If either the
start or end range has a value of 0, then the entire address pool is ignored.
Default 0.0.0.0
Location dhcp-server-subnet
Products BAN, MALC, Raptor, Z-Edge, ZRG
reserve-end
The default number of IP addresses at the end of a subnet IP address space
that are reserved by the DHCP server. To override this default, create a
specific subnet rule for each subnet that needs to be handled differently.
Values 0 to 255
Default 5
Access This parameter is read-write.
Location dhcp-server-options
Products BAN, MALC, Raptor, Z-Edge, ZRG
reserve-start
The default number of IP addresses at the start of a subnet IP address space
that are reserved by the DHCP server. To override this default, create a
specific subnet rule for each subnet that needs to be handled differently.
Values 0 to 255
Default 5
Access This parameter is read-write.
Location dhcp-server-options
Products BAN, MALC, Raptor, Z-Edge, ZRG
See Also send-type
282
DHCP
restart
Restarts the DHCP server. A restart should only be done after making manual
changes to the DHCP server lease table. All other configuration changes done
using SNMP are automatically loaded by the server.
Values true
secondary-name-server
The IP address of the secondary domain name server that the client should use
for DNS resolution.
Default 0.0.0.0.
Access This parameter is read-write.
Location dhcp-server-subnet, dhcp-server-group, dhcp-server-host
Products BAN, MALC, Raptor, Z-Edge, ZRG
stickyaddr
Specifies that the DHCP server attempts to hand out the same IP address to
the same host, whenever possible, based on hardware address.
Values disable
enable
Default enable
Location dhcp-server-subnet
Products BAN, MALC, Raptor, Z-Edge, ZRG
starts
The time in GMT that the lease was assigned.
Values 0 to 2147483647
Location dhcp-server-lease
283
Parameters
state
The current state of the lease.
Values init
reboot
bound
verify
release
invalid
bind
Location dhcp-client-lease-resource
Notes Only init, verify and release can be changed.
Products BAN, MALC, Raptor, Z-Edge, ZRG
subnetgroup
The DHCP Subnet group ID used to indicate which address pool grouping
may be used for the CPE subnet.
Default 0 (zero)
Location dhcp-server-subnet
Products MALC
tftp
The tftp address for the current interface.
Access This parameter is read-only
Location dhcp-client-lease-resource
Products BAN, MALC, Raptor, Z-Edge, ZRG
vendor-match-length
The length of the vendor class identifier substring to match.
Default -1, which indicates that the entire string starting at the match offset value
should be matched.
Location dhcp-server-group
Products BAN, MALC, Raptor, Z-Edge, ZRG
284
DNS
vendor-match-offset
The offset into the client passed vendor class identifier string where the string
match should start.
Default 0 (zero)
Location dhcp-server-group
Products BAN, MALC, Raptor, Z-Edge, ZRG
vendor-match-string
The vendor class identifier match string that is used to determine which
clients should be placed in the group.
Default An empty string.
Location dhcp-server-group
Products BAN, MALC, Raptor, Z-Edge, ZRG
version
The version number of the current DHCP server configuration. If this value
changes, the server will reload all of its configuration rules and reinitialize
itself. Any configuration rules modified before this field is changed will not
affect the DHCP server configuration once it is reset.
Values 0 (zero) to 2147483647
Default 0 (zero)
Location dhcp-server-options
Products BAN, MALC, Raptor, Z-Edge, ZRG
DNS
domain
The routing domain to which this host parameter applies.
Values A string, maximum length 255 characters.
Default The default is an empty string.
Access This parameter is read-write.
Location resolver
285
Parameters
first-nameserver
The IP address of the first or primary name server for this routing domain.
Default The default is an empty string.
Access This parameter is read-write.
Location resolver
hostalias1
Host name alias for specified host. The host name can be qualified or
hostname only. The maximum length for this name is 255 characters.
Location host-name
hostalias2
Host name alias for specified host. The host name can be either fully-qualified
or hostname only. The maximum length for this name is 255 characters.
Location host-name
hostalias3
Host name alias for specified host. The host name can be either fully-qualified
or hostname only. The maximum length for this name is 255 characters.
Location host-name
hostalias4
Host name alias for specified host. The host name can be either fully-qualified
or hostname only. The maximum length for this name is 255 characters.
Location host-name
hostname
Client host name (if any) that the client used to acquire its address.
Default The default is an empty string.
Location host-name
ipaddress
The IP address of this system or interface on the indicated subnet. For
unnumbered interfaces, a unique internal identifier is used.
Location host-name
286
DS1
query-order
The type of resolver query for this routing domain.
Values hosts-first
Searches the local hosts table first, then the list of nameservers.
dns-first
Searches the list of nameservers first, then the local hosts table
dns-only
Searches only the list of nameservers.
Default hosts-first
Access This parameter is read-write.
Location resolver
second-nameserver
The IP address of the secondary name server for this routing domain. This
nameserver is queried if the first nameserver cannot resolve the query. If a
secondary name server has not been defined, this field is set to 0.0.0.0
Access This parameter is read-write.
Location resolver
third-nameserver
The IP address of the third name server for this routing domain. This
nameserver is queried if the first nameserver and the secondary nameserver
cannot resolve the query. If a third name server has not been defined, this field
is set to 0.0.0.0
Access This parameter is read-write.
Location resolver
DS1
cell-scramble
Indicates whether ATM cell scrambling is enabled for this interface. Both
sides of the connection must agree on whether scrambling is enabled.
Values true
287
Parameters
Default true
Products BAN, MALC, Raptor, Sechtor 100A
channelization
Indicates whether this DS1/E1 is channelized.
Values disabled
circuit-id
The transmission vendor circuit identification number.
Values integer
Access This parameter is read-write.
Location ds1-profile
Products BAN, MALC, Raptor, Sechtor 100A
clock-source-eligible
Whether the clock source is eligible to become the transmit clock source.
Values not-eligible
288
DS1
coset-polynomial
Indicates whether the coset polynomial is used to calculate the ATM header
error control (HEC) value. Both sides of the connection must agree on the
method of calculating the HEC value.
Values true
csu-line-length
The length of the CSU WAN interface in feet. This objects provides
information for line build out circuitry.
Values csu00
ds1-group-number
The group index to which this DS1 belongs.
Default 0
Access This parameter is read-write.
Location ds1-profile
Products BAN, MALC, Raptor, Sechtor 100A
ds1-mode
The type of T1 interface to which the system connects.
289
Parameters
Values other
dsx-line-length
The physical length of the T1 line. This setting is used to compensate for the
attenuation of the line due to its length.
Values dsx0
fdl
Specifies the facilities data link protocol in use.
Values other
290
DS1
att54016
ESF FDL exchanges.
fdlnone
The device does not use the FDL.
Default fdlnone
Access This parameter is read-write.
Location ds1-profile
Notes Not supported on E1.
Products BAN, MALC, Raptor, Sechtor 100A
line-code
The type of Zero Code Suppression used on the interface.
Values b8zs
b8zs for T1
hdb3 for E1
Location ds1-profile
Products BAN, MALC, Raptor, Sechtor 100A
line-power
Enables and disables line power for the DS1 interface.
Default Disabled
Location ds1-profile
Products BAN, MALC, Raptor, Sechtor 100A
line-status-change-trap-enable
Whether zhoneLineStatusChange traps should be generated for this interface.
291
Parameters
Values enabled
disabled
Default disabled
Access This parameter is read-write.
Location ds1-profile
Products BAN, MALC, Raptor, Sechtor 100A
line-type
The type of DS1 line used on this circuit. The type of circuit affects the
number of bits per second that the circuit can reasonably carry, as well as the
interpretation of the usage and error statistics.
Values esf
e1CrcMf for E1
Location ds1-profile
Notes
loopback-config
The loopback configuration of the DS1 interface.
Values noloop
292
DS1
lineloop
The received signal on this interface does not go through the device
(minimum penetration) but is looped back out.
localloop
The transmitted signal on this interface is looped back and received by the
same interface. What is transmitted onto the line is product dependent.
payloadloop
The received signal on this interface does not go through the device
(minimum penetration) but is looped back out.
Default noloop
Access This parameter is read-write.
Location ds1-profile
Products BAN, MALC, Raptor, Sechtor 100A
protocol-emulation
Indicates whether the device is acting as a network-side device or CPE with
respect to this DS1 connection.
Values network
cpe
Default network
Access This parameter is read-write.
Location ds1-profile
Notes Z-Edge 6200 only.
send-code
Indicates what type of code is being sent across the DS1 interface by the
device.
Values sendnocode
Sending looped or normal data. This is the only supported option for E1
interfaces.
sendlinecode
Sending a request for a line loopback.
sendpayloadcode
Sending a request for a payload loopback.T1 only.
sendresetcode
Sending a loopback termination request. T1 only.
sendqrsspattern
Sending a Quasi-Random Signal (QRS) test pattern. T1 only.
293
Parameters
send511pattern
Sending a 511 bit fixed test pattern. T1 only.
send3in24pattern
Sending a fixed test pattern of 3 bits set in 24. T1 only.
sendothertestpattern
Sending a test pattern other than those described by this parameter. T1
only.
send2047pattern
Sending 2047 test pattern. T1 only.
send1in2pattern
Sending alternate one, zero pattern. T1 only.
sendinbandcode
Sending inband loopback command. T1 only.
sendinbandcodeoff
Sending inband loopback off command. T1 only.
sendlinecodeoff
Sending line loopback command. T1 only.
sendpayloadcodeoff
Sending payload loopback command. T1 only.
Default sendnocode
Access This parameter is read-write.
Location ds1-profile
Products BAN, MALC, Raptor, Sechtor 100A
signal-mode
The DS1 signaling mode.
Values None
294
DS3
signal-type
The signaling type of the FXS interfaces within this DS1 connection.
Values loopstart
groundstart
Default loopstart
Access This parameter is read-write.
Location ds1-profile
Notes Z-Edge 6200 only.
transmit-clock-source
Specifies the DS1/DS3 clocking mode.
Values looptiming
The recovered receive clock from the DS1/DS3 is used as the transmit
clock.
localtiming
A local (to the DS1/DS3 interface) clock source is used on the DS1/DS3
transmit signal.
throughtiming
The transmit DS1/DS3 clock is derived from the recovered receive clock
of another DS1/DS3 interface. Interfaces that are designated as eligible
clock sources cannot be set to through timing.
Default looptiming (DS3) throughtiming (DS1)
Location ds1-profile, ds3-profile
Products BAN, MALC, Raptor, Sechtor 100A
DS3
channelization
Whether this DS3/E3 is channelized or unchannelized. Setting this object will
cause the creation or deletion of DS2 or DS1 entries in the ifTable.
Values disabled
295
Parameters
circuit-id
The transmission vendors circuit identification number
Values string of up to 255 characters
Access This parameter is read-write.
Location ds3-profile
Products BAN, MALC, Raptor, Sechtor 100A
ds1-for-remote-loop
Which DS1/E1 on this DS3/E3 will be indicated in the remote DS1 loopback
request. The type of loopback is configured in the loopback-config
parameter.
Values From 0 (zero) to 29, inclusive.
far-end-equip-code
The Far End Equipment Identification code that describes the specific piece
of equipment at the other end of the link. It is sent inside the Path
Identification Message.
Values A string of 0 (zero) to ten (10) characters, inclusive.
Access This parameter is read-write.
Location ds3-profile
Products BAN, MALC, Raptor, Sechtor 100A
far-end-fac-id-code
This code identifies a specific Far End DS3 path. It is sent inside the Path
Identification Message.
Values A string of 0 (zero) to ten (10) characters, inclusive.
Access This parameter is read-write.
296
DS3
Location ds3-profile
Products BAN, MALC, Raptor, Sechtor 100A
far-end-frame-id-code
The Far End Frame Identification code that identifies where the remote
equipment is located within a building at a given location. It is sent inside the
Path Identification Message.
Values A string of 0 (zero) to 38 characters, inclusive.
Access This parameter is read-write.
Location ds3-profile
Products BAN, MALC, Raptor, Sechtor 100A
far-end-loc-id-code
The Far End Location Identification code that describes the location of the
specific piece of equipment at the other end of the link. It is sent inside the
Path Identification Message.
Values A string of 0 (zero) to eleven (11) characters, inclusive.
Access This parameter is read-write.
Location ds3-profile
Products BAN, MALC, Raptor, Sechtor 100A
far-end-unit-code
The Far End code that identifies the equipment location within a bay. It is sent
inside the Path Identification Message.
Values A string of 0 (zero) to six (6) characters, inclusive.
Access This parameter is read-write.
Location ds3-profile
Products BAN, MALC, Raptor, Sechtor 100A
line-coding
This variable describes the variety of Zero Code Suppression used on this
interface, which in turn affects a number of interface characteristics.
Values dsx3other
dsx3b3zs
Refers to the use of specified patterns of normal bits and bipolar
violations which are used to replace sequences of zero bits of a specified
length.
297
Parameters
e3hdb3
High Density Bipolar of order 3. Refers to the use of specified patterns of
normal bits and bipolar violations which are used to replace sequences of
zero bits of a specified length. Used for E1 and E3.
Access This parameter is read-write.
Location ds3-profile
Products BAN, MALC, Raptor, Sechtor 100A
line-length-meters
The length of the DS3 line in meters. This parameter provides information for
line build out circuitry (if it exists) and is used to adjust the line build out.
Values From 0 to 6400 meters.
Access This parameter is read-write.
Location ds3-profile
Products BAN, MALC, Raptor, Sechtor 100A
line-status-trap-enable
Indicates whether line-status-trap-enable traps should be generated for this
interface.
Values enabled
disabled
Access This parameter is read-write.
Location ds3-profile
Products BAN, MALC, Raptor, Sechtor 100A
line-type
The DS3 C-bit or E3 application used on this interface. The type of interface
affects the interpretation of the usage and error statistics. DS3 transmits at a
speed of 44.736 Mbps and E3 transmits at 34.368 Mbps.
Values dsx3m23
298
DS3
loopback-config
The loopback configuration of the DS3/E3 interface.
Values
dsx3NoLoop
Not in the loopback state. A device that is not capable of performing a
loopback on the interface will always return this value.
dsx3PayloadLoop
The received signal at this interface is looped through the device.
Typically the received signal is looped back for retransmission after it has
passed through the device's framing function.
dsx3LineLoop
The received signal at this interface does not go through the device
(minimum penetration) but is looped back out.
dsx3InwardLoop
The sent signal at this interface is looped back through the device.
medium-atmframe-config
The ATM framing mode.
Values dsx3AtmFramingOther
The ATM framing format is other than PLCP or direct cell mapped.
dsx3AtmFramingPLCP
The ATM framing format is PLCP.
dsx3AtmFramingDirectCellMapped
The ATM framing format is direct cell mapped.
Default
dsx3AtmFramingDirectCellMapped
medium-frame-config
The E3 framing mode.
Values e3FrameOther
299
Parameters
e3FrameG751
E3 framing format will be G751.
Default
e3FrameG832
medium-scramble-config
Whether the DS3 scramble mode is enabled.
Values true
send-code
Indicates what type of code is being sent across the DS3 interface by the
device.
Values dsx3SendNoCode
300
DSL
transmit-clock-source
Specifies the DS1/DS3 clocking mode.
Values looptiming
The recovered receive clock from the DS1/DS3 is used as the transmit
clock.
localtiming
A local (to the DS1/DS3 interface) clock source is used on the DS1/DS3
transmit signal.
throughtiming
The transmit DS1/DS3 clock is derived from the recovered receive clock
of another DS1/DS3 interface. Interfaces that are designated as eligible
clock sources cannot be set to through timing.
Default looptiming (DS3) throughtiming (DS1)
Location ds1-profile, ds3-profile
Products BAN, MALC, Raptor, Sechtor 100A
unit-mode
Specifies whether the unit is configured as a CO or CPE device.
Default For a BAN, the default is CO. For a Z-Edge, the default is CPE.
Access This parameter is read-write.
Location ds3-profile
Products BAN, MALC, Raptor, Sechtor 100A
See Also config-line-rate, fix-bit-enabled
DSL
config-line-rate
The SDSL line rate.
Values line-rate-144kbps, line-rate-160kbps, line-rate-192kbps,
301
Parameters
connect-mode
The connection mode compatibility.
Values basic-2b1q-mode
decoder-coeffA
The 21 bit value corresponding to the decoder coefficient A.
Default The ANSI HDSL2 default
302
DSL
Access read-write
Location hds12-config
decoder-coeffB
A 21 bit value corresponding to the decoder coefficient B.
Default The ANSI HDSL2 default
Location hds12-config
fix-bit-rate
Normally, if the central office (CO) and CPE select different line rates at
startup, the lower of the two rates is selected. The fix-bit-rate parameter
enables a CO unit to override the default procedure and require startup at the
rate specified in config-line-rate.
Values fix-bit-disable
This value enables automatic baud rate adaption. If the CO and CPE
devices have different line rates at startup, the lower of the two rates will
be selected.
fix-bit-enable
This value is used for static (set) baud rates.
Default fix-bit-disable
Access This parameter is read-write.
Location sdsl-config profile
Notes This setting applies only if the unit is configured as a CO device.
See Also config-line-rate, unit-mode
frame-sync-word
A 10-bit number indicating the frame sync word used.
Default The HDSL2 standard.
Location hdsl2-config
framer-type
Specifies the type of framer used.
Values atm-clear-channel
303
Parameters
atm-g991-1
Uses framing specified in G.991.1
Default atm-clear-channel
Access This parameter is read-write.
Location sdsl-config
line-status-trap-enable
Specifies whether a line status trap should be sent whenever the DSL line
goes up or down. Note that this setting does not apply to line status traps sent
during system bootup. During bootup, line status traps are not sent.
A DSL link down trap has a moderate severity level and a link up trap has a
low severity.
Values enabled
DSL line status change traps should be generated for this interface.
disabled
DSL line status change traps will not be generated for this interface.
auto
For ADSL, a trap is generated on a line status change which is not due to
a dying gasp.
Default enabled
line-type
The DSL type supported on this interface.
Values shdsl
304
DSL
ntr
Network timing recovery (NTR) specifies that the system synchronizes with
an external (network) clocking source.
Values ntr-enable
pointtopoint
Specifies whether the interface is point-to-point.
Values true
false
Default false
Access This parameter is read-write.
Location ip-interface-record
Notes Configure DSL interfaces as pointtopoint.
power-scale
Adjusts transmit power in small increments to compensate for minor
differences in power between units. The formula for the adjustment is:
Power scale = 29952 * 10([adjustment in dB]/ 20)
The following values are recommended for different loop lengths.
Values 17664
305
Parameters
stuff-bits
A four bit number for the stuff bits. The default is the HDSL2 standard,
1111'b.
Default The HDSL2 standard, 1111'b.
Location hdsl2-config, hdsl2-status
threshold-15min-lofs
The number of Loss of Framing seconds on a DSL interface within any given
15 minutes performance data collection period, which causes the SNMP agent
to send a trap. Entering 0 will disable the trap.
Default 0
Access This parameter is read-write.
Location dsl-alarm
threshold-15min-lols
The number of Loss of link seconds on a DSL interface within any given 15
minutes performance data collection period, which causes the SNMP agent to
send a trap. Entering 0 will disable the trap.
Default 0
Access This parameter is read-write.
Location dsl-alarm
threshold-15min-loss
The number of Loss of signal seconds on a DSL interface within any given 15
minutes performance data collection period, which causes the SNMP agent to
send a trap. Entering 0 will disable the trap.
Default 0
Access This parameter is read-write.
Location dsl-alarm
transmit-power-back-off-mode
Whether the transmit power backoff defined in the HDSL2 standard is used.
306
ELCP
Values backoffdisable
backoffenable
nochangebackoff
Default backoffdisable
Location hdsl2-config
unit-mode
Specifies whether the unit is configured as a Central Office (CO) or Customer
Premise Equipment (CPE) device.
Values co
cpe
Default cpe
Location dsl-config
up-line-rate
The upstream DSL rate in bps on the interface.
Access This parameter is read-only
Location dsl-status-profile
See Also down-rate
ELCP
audio-service
Defines a number of services for transporting audio traffic and signaling over
an AAL2 CID.
Values enabled
disabled
Default enabled
Location aal2-elcp-port
isdn-channel-id
ISDN BRI ports.
Values 0
307
Parameters
1
First B channel
2
Second B channel
Location subscriber-voice-aal2-elcp
line-group-id
The line group ID for this ELCP AAL2 connection.
Location subscriber-voice-aal2-elcp
max-length-frame
Maximum length for frame mode data.
Location aal2-elcp-port
max-sdu-length
Indicates the maximum size of the SSSAR-SDU, in octets, that is allowed to
be reassembled.
Location aal2-elcp-port
pcm-encoding
Voice encoding algorithm.
Values mulaw
alaw
Default alaw
Location aal2-elcp-port
port-id
Identifies a port on the IAD side for this ELCP AAL2 connection.
Location subscriber-voice-aal2-elcp
port-type
The port type for the IAD port for the current connection.
Location subscriber-voice-aal2-elcp
308
ELCP
preferred-ap-index
Index for the preferred audio encoding format within the Audio Profile.
Values 1
voice-connection-type
This describes the connection type between the two voice endpoints. Where
applicable the first endpoint refers to the line or premise side of the
connection and the second endpoint refers to the central office side of the
connection.
Values aal2togr303
309
Parameters
Ethernet
adminstatus
The administrative status of the Ethernet physical and logical interface.
Values Up
The interface is enabled and up, and the status of the interface should
become standby or operational
Down
The interface is disabled and down, and the status of the interface should
become shutdown.
Location ether
autoNegCap
The capabilities of the Ethernet interface that are advertised by this port. Note
that multiple options can be specified by adding a plus (+) sign between
entries.
This parameter also controls flow control, which is used to regulate the flow
of traffic between endpoints. Flow control cause the transmitter to stop
sending traffic if it receives a pause message from an overwhelmed far end.
For more information on flow control refer to IEEE 802.3-2000.
Values bOther
Other or unknown
b100baseT4
Advertise 100BASE-T4
b100baseT2
Advertise 100BASE-T2 half duplex mode
b100baseT2FD
Advertise 100BASE-T2 full duplex mode
b10baseT
Advertise speed 10Mbps, duplex half and full
b10baseTFD
Advertise speed 10Mbps, duplex full
b100baseTX
Advertise 100BASE-TX half duplex mode
b100baseX
Advertise 100BaseX
b100baseT
Advertise speed 100Mbps, duplex half and full
310
Ethernet
b100baseTXFD
Advertise 100BASE-TX full duplex
b100baseXFD
Advertise 100BaseX full duplex
b100baseTFD
Advertise speed 100Mbps, duplex full
b1000baseX
Advertise 1000BaseX full duplex
b1000baseT
Advertise 1000Mbps, duplex full
b1000baseXFD
1000BaseX full duplex
b1000baseTFD
Advertise speed 1000Mbps, duplex full
bFdxPause
Advertise pause for full duplex links
bFdxBPause
Advertise Full (symmetric and asymmetric) flow control
bFdxAPause
Advertise Asymmetric flow control
bFdxSPause
Advertise Symmetric flow control
autonegstatus
Enables autonegotiation. When enabled, the interface will negotiate the
options specified in the autoNegCap parameter.
Values enabled
Negotiate link attributes with remote partner. Final link rate, duplex, and
flow control, are determined by the advertised capabilities on each end.
The link will settle on a speed/duplex based on the hierarchy described in
the IEEE 802.3-2000 document.
disabled
Do not negotiate. Link speed and duplex will be forced to the parameters
indicated in the 'mauType' field. If the other end does not advertise those
parameters (when in autonegotiate mode), or if the other end wants to
force the link to a different speed/duplex combination, there will no link.
Default enabled
Location ether
Notes If set to disabled, the interface is the same as specified in the ifType
parameter.
311
Parameters
clksrc
Determines which side of the link will provide clocking for the link.
If both sides are configured for automatic, both ends of the link negotiate
which will be the master and which will be the slave based on the rules in
IEEE 802.3-2000. If both sides are configured the same (either as master or as
slave) the link will not be established.
Values automatic
The clock source is selected based on the rules in the IEEE 802.3-2000.
This is the recommended setting.
master
The local side will attempt to provide clock for the link.
slave
The local will attempt to recover clock from the clock generated by the far
end of the link.
Default automatic
Location ether
Notes Applies to Gigabit Ethernet ports only.
ifType
The type of Ethernet. Should be set to the same value as the mauType.
Values mauOther
Supported on UTP
mau10Baset
Supported on UTP
mau10Basethd
Supported on UTP
mau10Basetfd
Supported on UTP
mau100Basetxhd
Supported on UTP
mau100Basetxfd
Supported on UTP
mau1000basethd
Supported on UTP
mau1000basetfd
Supported on UTP
mau1000baselxhd
Supported on fiber
312
Ethernet
mau1000baselxfd
Supported on fiber
mau1000basesxhd
Not supported
mau1000basesxfd
Not supported
Location ether
mauType
Ethernet physical interface type.
Values mauOther
Supported on UTP
mau10Baset
Supported on UTP
mau10Basethd
Supported on UTP
mau10Basetfd
Supported on UTP
mau100Basetxhd
Supported on UTP
mau100Basetxfd
Supported on UTP
mau1000basethd
Supported on UTP
mau1000basetfd
Supported on UTP
mau1000baselxhd
Supported on fiber
mau1000baselxfd
Supported on fiber
mau1000basesxhd
Not supported
mau1000basesxfd
Not supported
Default mau100basetxfd (for all Ethernet interfaces except Gigabit)
313
Parameters
protection-fast-timer
The protection messages fast timer. The fast timer is used for protection
protocols.
Values 1 to 20 milliseconds
Default 10 milliseconds
protection-slow-timer
This timer indicates how often the node sends out slow status messages when
a protection event occurs. This value is in 50 millisecond (ms) intervals. For
example, a value of 100 equals 5 seconds.
Values 1 to 200 (in 50 millisecond units)
Default 20 (1 second)
protection-wtr
The length of time in seconds, to remain in the protection state, after the cause
for the switch to protection is removed. This prevents protection switch
oscillations.
Values 0 to 1440 seconds
Default 10 seconds
remotefault
Indicates the state of the remote end of the Ethernet link.
Values noerror
restart
Forces auto-negotiation to begin link renegotiation. If auto-negotiation
signaling is disabled, this parameter has no effect.
314
FXS/FXO
Values restart
reversion-mode
The reversion mode determines if traffic resumes processing in the normal
direction after a protection event is cleared.
Values true
false
wrap-config
Indicates the configured protection mode, steering or wrapping, in a MAC
that supports both modes.
If the node detects another station on the ring that has a protection
configuration that conflicts with its own, the station will generate a defect to
higher layers.
Values true
The ring is configured for wrapping. The station will perform wrap
protection during ring failures. In a wrapping configuration, the two
nodes on either end of the disrupted link will wrap the traffic back away
from the broken link.
false
The ring is configured for steering. In a steering configuration, each node
of the ring is responsible for determining how to route traffic around the
disrupted link. For large networks, traffic could be slower to recover if
steering is used.
FXS/FXO
fxo-cfg-signal-type
The signaling type of foreign exchange office (FXO) interface.
Values fxoloopstart
Loop start.
fxogroundstart
Ground start.
315
Parameters
fxodpt
Dial Pulse Terminating. This option allows the unit to attach to incoming
one way trunks from a PBX, key system, or a telephone set.
Default fxoloopstart
Location analog-fxo-cfg-profile
if-cfg-impedence
Specifies the terminating impedance of analog voice interfaces.
Values
ohms600complex
600 Ohms + 2.16uF
ohms900complex
900 Ohms + 2.16uF
Default ohms900complex
Location analog-if-cfg-profile
if-cfg-trunk-conditioning
Specifies whether the FXS/FXO port should send the idle pattern to the
network upon declaration of a Carrier Group Alarm (CGA) on the WAN link
to which the port is assigned.
Values off
idle
busy
Default idle
Location analog-if-cfg-profile
if-maintenance-mode
Indicates the maintenance modes of the analog voice interface.
Values
off
ifdigitalloopback
ifanalogloopback
Default off
Location analog-if-cfg-profile
if-cfg-pcm-encoding
Line encoding.
316
FXS/FXO
Values alaw
For E1.
mulaw
For T1.
Default mulaw
Location analog-if-cfg-profile
Notes This parameter can also be set with the voice add command when the voice
connection is created.
if-cfg-receive-tlp
The receive TLP is the signal level TO the customer premises equipment
(CPE). The receive signal range is +3 dB to -9 dB. A positive number adds
gain, a negative number adds loss to the analog signal after decoding from
PCM. For example, a receive TLP setting of -6 dB will generate a voice signal
at -6 dB level.
Values fxsrtlpn9db
fxsrtlpn8db
fxsrtlpn7db
fxsrtlpn6db
fxsrtlpn5db
fxsrtlpn4db
fxsrtlpn3db
(not supported on the POTS 900 card)
fxsrtlpn2db
(not supported on the POTS 900 card)
fxsrtlpn1db
fxsrtlp0db
fxsrtlp1db
fxsrtlp2db
fxsrtlp3db
rtlpnummeric
Default fxsrtlpn6db
Location analog-if-cfg-profile
317
Parameters
if-cfg-receive-tlpNum
Receive Transmission Level Point (RTLP) settings control the amount gain or
loss added to the incoming signal after it is decoded to analog. To increase the
signal level set the RTLP setting to higher values. The default is 0 dB.
Values -160 to 85 (in tenths of dB)
Default
0 dB
Location analog-if-cfg-profile
if-cfg-transmit-tlp
The transmit TLP is the signal level from the customer premises equipment
(CPE). The transmit signal range is +9 dB to -3 dB. A positive number adds
loss, a negative number adds gain to the analog signal before encoding to
PCM. For example, a transmit TLP setting of +3 dB will set a loss of 3 dB to
generate a 0 dB PCM signal.
Values fxsTtlp9db
if-cfg-transmit-tlpNum
Transmit Transmission Level Point (TTLP) controls the amount of gain or
loss added to a voice signal before it is encoded to digital PCM. To increase
the signal level, reduce the TTLP setting to lower value.
318
FXS/FXO
ring-back
Specifies whether ring back is requested.
Values on
off
Default off
Location analog-fxs-cfg-profile
ring-frequency
The ring frequency used in the FXS interface.
Values ringFrequency25
signal-type
The signaling of the FXS interface.
Values fxsLoopStartsloop
Loop start.
fxsGroundStart
Ground start.
fxsLoopStartFd
fxsGroundStartAutomatic
Used with equipment requiring fast response time to the Central Office
(CO).
fxsGroundStartImmediate
Used with equipment requiring fast response time to the station or private
branch exchange (PBX).
319
Parameters
fxsdnLoopStart
Loop start in FXSDN mode.
fxsdnLoopStartFd
fxsdnGroundStart
Ground start in FXSDN mode
fxsdnGroundStartImmediate
Ground start immediate in FXSDN mode
fxsdnwinkLoopStart
Loop start in fxsdnwink (Foreign Exchange Subscriber Defined Wink
start). This is the same type of signaling as FXSDN. It provides 150
millisecond delay, then a 200 ms wink acknowledgement to the central
office when the FXS port sees an off-hook condition from central office.
The system requires a ringing generator for this option.
fxsdnwinkLoopStartFd
fxsdnwinkGroundStart
Ground start in FXSDNWINK mode
fxsdnwinkGroundStartImmediate
Ground start immediate in FXSDNWINK mode.
fxstr08SingleParty
TR08 is Frame format signaling and data link as defined in
TR-TSY-00008 Mode 1 for circuits using AT & T SLC-96 facilities. This
option is for single-party service. This option connects the port to one
way outgoing trunks from a PBX, CENTEREX, key system, or telephone
set to an SLC channel. The SLC96 mode also must be active on the
associated WAN interface.
fxstr08UniversalVoiceGrade
Toll-quality voice for SLC-96.
fxstr08UniversalVoiceGradeAutomatic
Used with some non-Bell switches for SLC-96.
Default fxsLoopStartsloop
Access This parameter is read-write
Location analog-fxs-cfg-profile
voice-pots-line-group-id
The line group identifier for the POTS line, equal to the ifIndex of the line.
Access This parameter is read-write.
Location subscriber-voice-pots
320
GR303
GR303
adminStatus
A value that is received from a remote management system (Zhone
Management System) to place the unit in service or out of service.
Values inService
outOfService
Default outOfService
Access This parameter is read-write.
Location gr303-interface-group
channel-number
The channel number for this array.
Values 1 to16, inclusive
control-channel-t303
The time that the Integrated Digital Terminal (IDT) and the Remote Digital
Terminal (RDT) will wait for a reply to a SETUP message. This value
depends upon the IDT.
Values 700, 1200, 1700, 2200, 2700, 3200, 3700, 4200, or 4700 ms.
Default 700
Access This parameter is read-write.
Location gr303-ig-control-channel
control-channel-t396
The time that the RDT will wait for a reply to a SETUP message after the
expiration of the T303 timer.
Values 700, 1700, 2700, 3700, 4700, 5700, 6700, 7700, 8700, 9700, 10700, 11700,
321
Parameters
ctrlChannel
The GR-303 IG control channel array. This array includes the
control-channel-t303, control-channel-t396,
sapi-0-max-outstanding-frames, sapi-1-max-outstanding-frames,
sapi-0-n-200, sapi-1-n-200, sapi-0-t-200, sapi-1-t-200, sapi-0-t-203,
sapi-1-t-203, sapi-0-pps-mode, and sapi-1-pps-mode parameters.
Location gr303-interface-group
ds1LM:array[1..28]
The array for T1/DS1 circuits. The maximum number of DS1 trunks allowed
per IG is 28. This array includes the dsn-lg-id, channel-number, and role
parameters.
Location gr303-interface-group
idt-admin-state
The administrative state of the IDT on the remote side of the GR-303
interface.
Values inService
local-admin-state
The administrative state of the CRV on the local (RDT) side.
Values inService
outOfService
Default outOfService
Access This parameter is read-write.
Location gr303-ig-crv
logical-id
This is an unique number to identify each physical DS1 within an Interface
Group between RDT and IDT.
322
GR303
Values
1 to 28, inclusive.
reserved for the primary DS1 and cannot be used by any other DS1s.
name-id
A name assigned by the installer. It must be unique to the system. This value
is a string.
rdt-admin-state
The administrative state of the RDT on the local side of the GR-303 interface.
Values inService
outOfService
Default outOfService
Access This parameter is read-write.
Location gr303-ig-crv
remote-admin-state
The administrative state of the CRV on the remote (IDT) side.
Values inService
role
The role the DS1 line assumes.
Values payload
secondary
primary
Default payload
Access This parameter is read-write.
Location gr303-interface-group
323
Parameters
sapi-0-max-outstanding-frames
For SAPI=1 and SAPI=2, for both the active and standby data links, per IG,
the maximum number of outstanding EOC information frames at layer 2. This
LAPD parameter facilitates remote provisioning of the layer 2 connection.
Values 1 to 10, inclusive.
Default 7
Access This parameter is read-write.
Location gr303-ig-control-channel
sapi-0-n-200
For SAPI=1 and SAPI=2, for both the active and standby data links, per IG,
the maximum number of retransmissions for a frame at layer 2. This LAPD
parameter facilitates remote provisioning of the layer 2 connection.
Values 1 to 10, inclusive.
Default 3
Access This parameter is read-write.
Location gr303-ig-control-channel
sapi-0-pps-mode
The DS1 protection switching option.Facility protection switching enables
traffic on a failed DS1 to be moved to one or more alternate DS1 facilities.
Values inhibit
notInhibited
notApplicable
Default notInhibited
Access This parameter is read-write.
Location gr303-ig-control-channel
sapi-0-t-200
For SAPI=1 and SAPI=2, for both the active and standby data links, per IG,
the maximum layer 2 wait time for an acknowledgement of a transmitted
frame in milliseconds. This LAPD parameter facilitates remote provisioning
of the layer 2 connection.
Values 100, 150, 200, 250, 300, or 350.
Default 150
Access This parameter is read-write.
324
GR303
Location gr303-ig-control-channel
sapi-0-t-203
For SAPI=1 and SAPI=2, for both the active and standby data links, per IG,
the maximum layer 2 idle time, in seconds, before connection verification is
necessary. This LAPD parameter facilitates remote provisioning of the layer 2
connection.
Values 10, 20, 30, 40, 50, 60, 70, 80, 90, 100, 110, 120, 130, 140, 150, 160, 170, 180,
190, 200, 210, 220, 230, 240, 250, 260, 270, 280, 290, or 300.
Default 30
Access This parameter is read-write.
Location gr303-ig-control-channel
sapi-1-max-outstanding-frames
For SAPI=1 and SAPI=2, for both the active and standby data links, per IG,
the maximum number of outstanding TMC information frames at layer 2.
This LAPD parameter facilitates remote provisioning of the layer 2
connection. (This parameter is not supported.)
Values 1 to 7, inclusive.
Default 7
Access This parameter is read-write.
Location gr303-ig-control-channel
sapi-1-n-200
For SAPI=1 and SAPI=2, for both the active and standby data links, per IG,
the maximum number of retransmissions for a frame at layer 2. This LAPD
parameter facilitates remote provisioning of the layer 2 connection. (This
parameter is not supported)
Values 1 to 10, inclusive
Default 3
Access This parameter is read-write.
Location gr303-ig-control-channel
sapi-1-pps-mode
The DS1 protection switching option. Facility protection switching enables
traffic on a failed DS1 to be moved to one or more alternate DS1 facilities.
325
Parameters
Values inhibit
notInhibited
notApplicable
Default notInhibited
Access This parameter is read-write.
Location gr303-ig-control-channel
sapi-1-t-200
For SAPI=1 and SAPI=2, for both the active and standby data links, per IG,
the maximum layer 2 wait time for an acknowledgement of a transmitted
frame in milliseconds. This LAPD parameter facilitates remote provisioning
of the layer 2 connection.
Values 100, 150, 200, 250, 300, or 350.
Default 150
Access This parameter is read-write.
Location gr303-ig-control-channel
Notes Unsupported
sapi-1-t-203
For SAPI=1 and SAPI=2, for both the active and standby data links, per IG,
the maximum layer 2 idle time, in seconds, before connection verification is
necessary. This LAPD parameter facilitates remote provisioning of the layer 2
connection.
Values 10, 20, 30, 40, 50, 60, 70, 80, 90, 100, 110, 120, 130, 140, 150, 160, 170, 180,
190, 200, 210, 220, 230, 240, 250, 260, 270, 280, 290, or 300.
Default 30
Access This parameter is read-write.
Location gr303-ig-control-channel
Notes Unsupported
signal-type
The signaling method used by the CRV. This value is set by the voice switch
through the EOC or it is set in the gr303-ig-crv profile.
326
IfIndex
Values unknown
loopstart
groundstart
loopreversebattery
electronicbesinessset
Default loopstart
Access This parameter is read-write.
Location gr303-ig-crv
switch-type
The switch vendor for the Interface Group (IG).
Values unknown
lucent5Ess
nortelDms100
Default unknown
Access This parameter is read-write.
Location gr303-interface-group
working-mode
Indicates whether the Integrated Digital Terminal (IDT) can configure the
Remote Digital Terminal (RDT) for Call Reference Values (CRV) using
common management information service (CMIS) over the Embedded
Operations Channel (EOC).
Values active
The IDT can configure the RDT for CRV over the EOC channel.
passive
CRVs can only be configured locally.
Default passive
Access This parameter is read-write.
Location gr303-interface-group
IfIndex
adminStatus
The default value for the upper ifIndex associated with the upperiftype.
327
Parameters
Values up
down
testing
Default down
Access This parameter is read-write.
Location if-default
ifindex
The interface number of the port or port/subport that uniquely identifies the
interface across the system.
Access This parameter is read-only.
Location physical-to-ifindex, if-translate
ifname
Name of the interface.
Allowable characters are:
0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUV
WXYZ:.- and _.
.Do not begin if-name with a ".".
If an invalid character is used, it will be replaced with the "-" character. If the
repaired if-name is not unique, the ifIndex value is appended to the if-name to
make the name unique.
Access This parameter is read-only.
Location if-translate
iftype-extension
The Zhone-proprietary interface type.
Values ianaiftype_other
zhoneiftype_linegroup
zhoneiftype_none
Default zhoneiftype_none
Access This parameter is read-only.
Location if-translate
328
IfIndex
numunits
Number of units for this association. This indicates the number of ifIndexes
created for this particular upper and lower interface pair on the card type. For
example, 48 for the SDSL/SHDSL card.
Values 0 to 2147483647, inclusive
Access This parameter is read-only.
Location if-default
physical-flag
Indicates whether the interface is a physical layer.
Values true
port
The port number defines the physical port number at the shelf-slot location for
the line profile. Port numbers begin with 1 and are numbered sequentially.
Values 1 to 262143, inclusive
Access This parameter is read-only
Location if-translate
Notes 0 (zero) is invalid.
redundancy-param1
For physicals, this parameter is a weight value indicating which physical will
be the active and which physical will be the standby for redundancy. For
linegroups and pathgroups, this parameter indicates how to perform reversion.
Values -1
329
Parameters
shelf
The physical address or number of the shelf where the desired line is located.
A Zhone system is limited to a maximum of 255 shelves. The first shelf in a
system is shelf 1.
Access This parameter is read-only.
Location if-translate
slot
The physical slot on the system.
Values 1 to 17, inclusive
Location if-translate
subport
Used to identify multiple logical subports on a physical port.
Access This parameter is read-only.
Location if-translate
Notes A value of 0 (zero) indicates that there is no subport.
IMA
groupSymmetry
The symmetry of the Inverse Multiplexing over ATM (IMA) group.
Symmetry determines whether the transmit and receive sides of the IMA link
must be configured and how traffic is sent over the links.
Values symmetricOperation
Both transmit and receive IMA links must be configured and the system
can transmit and receive traffic only if both sides of the connection are
active.
asymmetricOperation
Both transmit and receive IMA links must be configured, but the system
can transmit and receive traffic even if both sides of the connection are
not active.
330
IMA
asymmetricConfiguration
Transmit and receive links do not have to be configured and the system
can transmit and receive traffic even if both sides of the connection are
not active.
Default symmetricOperation
Access This parameter is read-write.
Location ima-group-profile
Notes Refer to ATM Forum IMA v1.1, Section 5.2.2.7.
minNumTxLinks
Minimum number of transmit links required to be Active for the IMA group
to be in the Operational state. If the number of active links falls below this
value, the link drops and the redundant link (if any) takes over.
Values 1 to 32
Access This parameter is read-write.
Location ima-group-profile
Notes Refer to ATM Forum IMA v1.1, Section 10.2.1.1.
Products MALC
minNumRxLinks
Minimum number of receive links required to be active for the IMA group to
be in the operational state. If the number of active links falls below this value,
the link drops and the redundant link (if any) takes over.
Values 1 to 32
Access This parameter is read-write.
Location ima-group-profile
Notes
txClkMode
Transmit clocking mode used by the near-end IMA group.
Values itc
Independent Transmit Clock. Indicates that IMA links do not all use the
same transmit clock. Each IMA link derives clock from its associated T1
interface.
ctc
Common Transmit Clock. Indicates the transmit clock of all IMA links
are derived from the same source. When set to ctc, the MALC derives the
IMA clocking from the system clock.
331
Parameters
Default itc
Access This parameter is read-write.
Location ima-group-profile
Notes
txImaId
The IMA ID currently in use by the near-end IMA function.
Values 0 to 255
Access This parameter is read-write.
Location ima-group-profile
Notes
txFramLength
The frame length to be used by the IMA group in the transmit direction. Can
only be set when the IMA group is startup.
Values m32
32 cells.
m64
64 cells.
m128
128 cells.
m256
256 cells.
Default m128
Access This parameter is read-write.
Location ima-group-profile
Notes
diffDelayMax
The maximum number of milliseconds of differential delay among the links
that can be tolerated on this interface.
Values 0 to 100
Default 25
Access This parameter is read-write.
Location ima-group-profile
Notes
332
IMA
alphaValue
The number of consecutive invalid ICP cells allowed before the system
changes from a Sync state to a Hunt state.
Values 1 or 2
Default 2
Access This parameter is read-write.
Location ima-group-profile
Notes
betaValue
The number of consecutive ICP cells with errors allowed before the system
changes from a Sync state to a Hunt state.
Values 1 to 5
Default 2
Access This parameter is read-write.
Location ima-group-profile
Notes
gammaValue
The number of consecutive valid ICP cells allowed before the system changes
from a PreSync state to the Sync state.
Values 1 to 5
Default 1
Access This parameter is read-write.
Location ima-group-profile
Notes
testLinkIfIndex
Indicates the interface used to transmit the test pattern. The test pattern is
looped back from the far end device over each active link in the IMA group.
Note that this value is not the same as the txImaId value.
Values A valid interface on the system in the form shelf-slot-port-subport/type
This is the link whose link identifier (LID) value is inserted in the Tx LID
field of the transmitted ICP cells.
Default 0
333
Parameters
testPattern
Specifies the transmit Test Pattern in an IMA group loopback operation. A
value in the range 0 to 254 designates a specific pattern.
Values -1 to 254
testProcStatus
Enables or disables the Test Pattern Procedure.
Values disabled
txTimingRefLink
The ifIndex of the receive timing reference link to be used by near-end for
IMA data cell clock recovery toward the ATM layer. A value of 0 (zero)
indicates no link has been configured in the IMA group, or the receive timing
reference link has not yet been detected.
Values 0
Default 0
Location ima-group-profile
Notes This parameter is not supported.
334
IP
rxTimingRefLink
The ifIndex of the transmit timing reference link to be used by near-end for
IMA data cell clock recovery toward the ATM layer. A value of 0 (zero)
indicates no link has been configured in the IMA group, or the receive timing
reference link has not yet been detected.
Values 0
Default 0
Location ima-group-profile
Notes This parameter is not supported.
IP
addr
The address of the IP interface.
Location ip-interface-record
alternateipaddress
A second IP address for this device that can be used by managers to address
the device. This address may be an IP address of an existing IP interface.
Location system
Notes A manager can communicate with the device using any of the configured IP
interface addresses. However, if the physical line fails or the card is inactive,
communication with the manager may time-out.
bcastaddr
The IP broadcast address used for sending data grams on the (logical)
interface associated with the IP interface. The broadcast address is determined
by the IP address and the netmask. It should always be set to an IP address
which is the network address of the interface that has all ones in the host
portion of the address.
Location ip-interface-record
bcastenabled
Specifies whether broadcasts are enabled on this interface.
335
Parameters
Values yes
no
Default yes
Location ip-interface-record
destaddr
The destination address for point-to-point IP interfaces.
Location ip-interface-record
Notes This parameter is ignored if the IP interface is not point-to-point.
dhcpserverenable
Enables or disables DHCP server functionality.
Values true
false
Default false
Access This parameter is read-write.
Location ip-interface-record
Notes If this parameter is set to true, then ipaddrdynamic parameter has to be set to
egressfilterid
The index of the egress filter spec provisioned for this interface.
Values 0 to 2147483647, inclusive
A value of 0 (zero) means that there is no egress filter provisioned for this
interface.
Default 0
Access This parameter is read-write
Location ip-interface-record
enable
Specifies the administrative state of the static route.
Values enabled
336
IP
disabled
The static route is not used by the system to make forwarding decisions.
Default enabled
Location static-route
farendaddr
The IP address of the interface on the far end, or receiving end, of this
interface. This information is used for Zhone Automatic Provisioning (ZAP).
Access This parameter is read-write
Location ip-interface-record
ipaddrdynamic
The mode by which the IP address is discovered by the system.
Values static
ipfwdenabled
Specifies whether IP forwarding is enabled on this interface.
Values true
false
Default true
Access This parameter is read-write
Location ip-interface-record
ingressfilterid
The index of the ingress filter spec provisioned for this interface.
337
Parameters
ipUnnumberedinterface
This value specifies where to borrow the local IP address of the
point-to-multipoint link.
Location ip-unnumbered-record
local-ipaddr
A local (or private) address of a host behind the Z-Edge 64, which is the real
destination.
Location pat-bind
local-port
The port number on the local host where packets should be forwarded.
Location pat-bind
maxVideoStreams
The maximum number of unique multicast (video) streams to which this
interface has subscribed.
Default 0
Access This parameter is read-write.
Location ip-interface-record
mcastcontrollist
List of Mcast-control-ids this IP Interface record is associated with.
Access This parameter is read-write.
Location ip-interface-record
mcastenabled
Specifies whether multicast is enabled on this interface.
338
IP
Values true
false
Default true
Access This parameter is read-write.
Location ip-interface-record
mcastfwdenabled
Specifies whether multicast forwarding is enabled on this interface.
Values true
false
Default true
Access This parameter is read-write.
Location ip-interface-record
metric
Metric for the route. The meaning of this value when static routes are
redistributed to other protocols is protocol-dependent, and the resulting value
after redistribution is determined by the route-maps in use for that protocol.
Lower numeric values for this number indicate more preferred routes.
Default 2147483647
Access This parameter is read-write.
Location static-route
mru
The size, in octets, of the largest packet which can be received on the IP
interface. For interfaces used for network data grams, this is the size of the
largest network datagram that can be received on the interface.
The default value depends on the type of interface and is the same as the
default MTU for the interface.
Access This parameter is read-write.
Location ip-interface-record
multicastAgingPeriod
Multicast aging period (in tenths of seconds) for the specified VLAN. After
the specified aging period is met, the VLAN address is deleted from the
routing table.
339
Parameters
natenabled
Specifies whether NAT is enabled on this interface.
Values true
false
Default false
Access This parameter is read-write.
Location ip-interface-record
netmask
The subnet mask associated with the IP interface. The value of the mask is an
IP address with all the network bits set to 1 and all the hosts bits set to 0.
Access This parameter is read-write.
Location dhcp-server-subnet, ip-interface-record
outgoingCOSOption
Specifies whether to overwrite the VLAN priority bits on packets bridged out
this interface with the value specified in the outgoingCOSValue parameter.
Values are disable and all. Disable indicates the VLAN priority bit is
untouched. All overwrites all the VLAN priority bits on packets bridged out
this interface with the value specified in the outgoingCOSValue parameter.
The default is disable.
outgoingCOSValue
For tagged packets, specifies the value loaded into the priority field of the
VLAN header. Values are 0 to 7 with 0 the lowest priority and 7 the highest.
The default value is 0.
portType
The type of payload.
Values tcp
340
IP
udp
User datagram protocol.
Default tcp
Location pat-bind
public-ipaddr
The IP address that will be used in the Internet. (This should be the IP address
of the DSL connection.)
Location pat-bind
public-port
The port on the Internet side that the public sees.
Location pat-bind
rdindex
The routing domain to which the IP interface belongs. An IP address is unique
to a routing domain.
Location ip-interface-record
reasmmaxsize
The size of the largest IP datagram that this interface can reassemble from
fragmented IP datagrams this interface receives.
Values 0 (zero) to 65535, inclusive
Default 65535
Access This parameter is read-write.
Location ip-interface-record
subnetgroup
The DHCP subnet group ID. It indicates which address pool grouping may be
used for the CPE subnet.
Location ip-interface-record, dhcp-server-subnet
type
Defines the video stream type.
Values normal
341
Parameters
always on
Always joined. Meant for Emergency Broadcast System (EBS) channel.
Not meant for video.
periodic
Join and leave after task complete. For example, used to download the tv
guide. Not meant for video.
Default normal
Access This parameter is read-write.
Location mcast-control-entry
unnumberedindex
The index of the ip-unnumbered-record used to obtain the local-side
unnumbered address.
Location ip-interface-record
upperiftype
The value of ifType corresponding to the higher sublayer of the relationship,
that is, the sublayer that runs on top of the sublayer identified by the
corresponding instance of loweriftype.
Location if-default
upperlayer
The shelf-slot-port-subport/type of the upper layer in the interface stack.
Location if-stack
vlanId
The Virtual LAN Identifier for the IP Interface. If the VLAN ID specified is
non-zero, all traffic destined to this interface should be configured with this
VLAN ID.
Default 0
Access This parameter is read-write.
Location ip-interface-record
Products MALC
vlanIDCOS
Specifies the value loaded into the priority field of the VLAN header when an
untagged packet received on this interface is tagged (VLAN ID inserted) for
342
ISDN
bridging. Values are 0 to 7 with 0 the lowest priority and 7 the highest. The
default value is 0.
ISDN
isdn-env-func-start-address
The envelope function starting address that the ISDN primary rate access is
assigned to.
Values 0 to 8175, inclusive.
Access This parameter is read-write.
Location v52-interface-group
isdnds-cpath-id
If the user port is configured for ISDN, this parameter is equal to the
associated C-path ID that carries Ds-type data. A value of 0 (zero) indicates
that the user port is not configured to carry Ds-type data.
Values 0 to 48, inclusive.
Access This parameter is read-write.
Location v52-user-port
line-group-id
Identifies the physical line or line group (primary and redundant secondary)
used for data and voice traffic. This is a unique number that is assigned when
a line redundancy group is provisioned. This enables administrators to locate
the physical lines (defined by the line group entry ID) used by the subscriber.
The line-group-id is used to associate a subscriber with data and voice
subscriber profiles.
Location subscriber-voice-isdn
ulc-port-type
Identifies the ULC port provisioning. There is one entry per ULC port.
Values pots
isdn
ebs
Default isdn
Location ulc-config
343
Parameters
ulc-trap-enable
Enables the sending of line-level traps from the device to SNMP managers.
Values enabled
disabled
Default disabled
Location ulc-config
Products MALC
voice-isdn-channel-id
The channel identifier for the connection.
Values 0
voice-isdn-line-group-id
The line group identifier for the ISDN line, equal to the ifIndex of the line.
Use the linegroup command to find the line group ID for an interface.
Location subscriber-voice-isdn
voice-isdn-port-type
Defines the type of ISDN channel: D channel or B channel.
Values isdndchannel
isdnbchannel
Location subscriber-voice-isdn
344
MTAC/Ring
MTAC/Ring
ifIndex
Specifies the ifindex of the physical line to be tested. If no line is being tested,
this value is 0.
Values A physical interface on the system.
The ability of a physical line to support a metallic test may vary depending on
the cards installed and the external test equipment.
Products MALC
ringSource
The ifIndex of the interface from which clock can be derived. Only OC3,
DS1, and DS3 interfaces can be used for this interface.
This interface will be used to drive the 8Khz backplane signal. The interface
must be set to loop or local timing in order for it to be considered as the
primary clock source. It must also be administratively turned on and be in an
operational state.
Only one interface in the system can be the primary clock source at any given
time.
Values externalRingSourceLabel
internalRingSourceLabel
Default internalRingSourceLabel
Access This parameter is read-write.
Location system
test_mode
Specifies metallic test mode for a given line. The test mode can be changed
only if the ifIndex parameter is set to a nonzero value.
Values mtacModeBridge
The subscriber line is metallically connected to the MTAC test access port
while the subscriber is in service. To avoid service interruption, the test
head must be in high impedance (bridge) mode.
345
Parameters
mtacModeLookIn
The subscriber line is disconnected and the service port is metallically
routed to the MTAC test access port. This allows the testing of the device
service port using a external test head or where the test head represents
the subscriber terminal.
mtacModeLookOut
The device service port is disconnected and the subscriber line is
metallically routed to the MTAC test access port. This allows the testing
of line with or without a subscriber terminal.
mtacModeNone
No MTAC test is in progress.
Default mtacModeNone
Access This parameter is read-write.
Location mtac-profile
Products MALC
secondary-ntp-server-ip-address
The IP address of the secondary NTP server. If the primary NTP server is not
available, the BAN will use the secondary server.
Values A valid IP address
346
Location ntp-client-config
Products BAN, MALC, Raptor, Sechtor 100A
local-timezone
The time zone the device is operating in.
Values
internationalDateLineWest
GMT-12:00 hours
nome
GMT-11:00
hawaii
GMT-10:00
yukon
GMT-9:00
pacific
GMT-8:00
mountain
GMT-7:00
central
GMT-6:00
eastern
GMT-5:00
atlantic
GMT-4:00
newfoundland
GMT-3:30
brasilia
GMT-3:00
azores
GMT-2:00
westAfrica
GMT-1:00
gmt
GMT/UTC
centralEuropean
GMT+1:00
easternEurope
GMT+2:00
baghdad
GMT+3:00
347
Parameters
tehran
GMT+3:30
uae
GMT+4:00
afghanistan
GMT+4:30
islamabad
GMT+5:00
india
GMT+5:30
kathmandu
GMT+5:45
dhaka
GMT+6:00
rangoon
GMT+6:30
bangkok
GMT+7:00
chinaCoast
GMT+8:00
japan
GMT+9:00
australia
GMT+9:30
guam
GMT+10:00
magadan
GMT+11:00
newZealand
GMT+12:00
rawakiIslands
GMT+13:00
lineIslands
GMT+14:00
Default gmt
Location ntp-client-config
Products BAN, MALC, Raptor, Sechtor 100A
348
PON
PON
auto-learn
Auto-learn enable flag. This sets up password-protection on the connection
between OLT and ONU.
Values oltautolearndisable
You must set a password for the connection between OLT and ONU.
oltautolearnenable
The OLT automatically learns the password for the connection between
OLT and ONU.
Default oltautolearndisable
Location olt-config
guaranteed-bw
The sum of the guaranteed-bw and maximum-bw parameter values for all
the ports should be less than or equal to the upstream bit rate (155 Mb/second)
of the PON OLT card.
Location olt-traf-cont
Notes The guaranteed-bw and maximum-bw parameter values in the olt-traf-cont
maximum-bw
The sum of the guaranteed-bw and maximum-bw parameter values for all
the ports should be less than or equal to the upstream bit rate (155 Mb/second)
of the PON OLT card.
Location olt-traf-cont
Notes The guaranteed-bw and maximum-bw parameter values in the olt-traf-cont
olt-onu-password
ONU remote-device password.
Location olt-onu-config
349
Parameters
olt-onu-serial-num
ONU remote-device serial number. Usually the ZRG.
Location olt-onu-config
PPPoA
accm-enable
Enable or disable Asynchronous Control Character Map (ACCM)
negotiation.
Values enabled
disabled
Default disabled
Access This parameter is read-write.
Location ppp-lcp
acfc-enable
Enable or disable Address and Control Field Compression (ACFC)
negotiation.
Values enabled
disabled
Default disabled
Access This parameter is read-write.
Location ppp-lcp
callback-dial-string
The dialing string used for a callback. The format of this string is determined
by callback-type.
Values 0 to 0
Default empty string
Access This parameter is read-write.
Location ppp-lcp
Notes This object only applies when callback negotiation is enabled using
callback-enable.
350
PPPoA
callback-enable
Enable or disable callback negotiation. Provides a method for an
implementation to request a dial-up peer to call back.
Values enabled
disabled
Default disabled
Access This parameter is read-write.
Location ppp-lcp
callback-type
The method of determining the location to callback.
Values byauth
callback-enable.
call-mode
Indicates where the PPP call is initiated.
Values nocall
No call is initiated.
incall
Call is initiated remotely.
outcall
Call is initiated locally.
Default nocall
351
Parameters
chap-enable
Enables or disables Challenge Handshake Authentication Protocol (CHAP).
Values enabled
disabled
Default disabled
Access This parameter is read-write.
Location ppp-auth
chap-name
The username for authenticating with the CHAP protocol.
Default empty string
Access This parameter is read-write.
Location ppp-auth
chap-secret
The password for authenticating with the CHAP protocol.
Default empty string
Access This parameter is read-write.
Location ppp-aut
comp-slot-id
Indicates whether the slot identifier field may be compressed.
Values enabled
352
PPPoA
fcs-alt-enable
Enable or disable Frame Check Sequence (FCS) alternative negotiation. The
negotiated FCS values take effect only during Authentication and
Network-Layer Protocol phases.
Values enabled
disabled
Default disabled
Access This parameter is read-write.
Location ppp-lcp
fcs-size
The size of the Frame Check Sequence (FCS) in bits, the local node will
attempt to negotiate for use with the remote node.
Values 16
Default 16
Access This parameter is read-write.
Location ppp-lcp
Notes Regardless of the value of this object, the local node will comply with any
FCS size negotiations initiated by the remote node, per the PPP specification.
Changing this parameter will take effect when the link is next restarted.
frame-type
Indicates which type of framing is used.
Values atmllc
atmvc
Default atmllc
Access This parameter is read-write.
Location ppp-interface
initial-mru
The initial Maximum Receive Unit (MRU) that the local PPP entity will
advertise to the remote entity.
Values 128 to 65535
Default 1500
Access This parameter is read-write.
353
Parameters
Location ppp-lcp
Notes If set to 0 the local PPP entity will not advertise any MRU to the remote entity
ip-addr-enable
Enable or disable IP Address Negotiation.
Values enabled
disabled
Default disabled
Access This parameter is read-write.
Location ppp-ncp
ip-comp-protocol
Sets the IP compression option.
Values none
Changing this parameter will take effect when the link is next restarted.
ip-ifindex
The index value of the ip-interface-record associated with this PPP
authentication record.
Values 0 to 2147483647
Default 0
Access This parameter is read-write.
Location ppp-auth
Notes If this entry is to be used for incoming authentication, this object must be set
to a non-zero value.
354
PPPoA
lgid
The unique identifier of the line group which uses this authentication data.
Values 0 to 2147483647
Default 0
Access This parameter is read-write.
Location ppp-auth, ppp-interface
link-type
Indicates which type of connection is used.
Values atm
isdn
asynch
virtual
Default atm
Access This parameter is read-write.
Location ppp-interface
lqr-period
The Link Quality Reporting period that the local PPP entity will attempt to
negotiate with the remote entity, in units of hundredths of a second.
Values 1000 to 99999
Default 0
Access This parameter is read-write.
Location ppp-lcp
Notes Changing this parameter will take effect when the link is next restarted.
lqr-status
Enable or disable Link Quality Report (LQR) status.
Values enabled
The local node will attempt to perform LQR negotiation with the remote
node.
disabled
LQR negotiation is not performed.
Default disabled
Access This parameter is read-write.
355
Parameters
Location ppp-lcp
Notes Changing this parameter will take effect when the link is next restarted.
pap-enable
Enables or disables Password Authentication Protocol (PAP).
Values enabled
disabled
Default disabled
Access This parameter is read-write.
Location ppp-auth
magic-number
The number used in magic number negotiation. When set to zero, a random
number will be used for the magic number. This allows us to better prevent
having two devices with the same magic number.
Default 0
Access This parameter is read-write.
Location ppp-lcp
magic-number-enable
Enable or disable magic number negotiation.
Values false
max-config-retries
Number of Link Control Protocol (LCP) configuration retries without
response before the link is brought down.
356
PPPoA
Values 1 to 999
Default 10
Access This parameter is read-write.
Location ppp-lcp
max-failure-retries
Number of times a Configuration Negative Acknowledgment is sent before a
Configuration Reject is sent
Values 1 to 999
Default 10
Access This parameter is read-write.
Location ppp-ncp
max-pad
The number of padded bytes at the end of data. This is used for
Self-Describing Padding, a method for placing unambiguous padding octets at
the end of the PPP Information field in order to cause messages to fall on a
natural boundary.
Values 1 to 255
Default 4
Access This parameter is read-write.
Location ppp-lcp
Notes See Self-Describing Padding in RFC 1570.
max-fail-retries
Number of times a Configuration Negative Acknowledgment is sent before a
Configuration Reject is sent.
Values 1 to 999
Default 10
Access This parameter is read-write.
Location ppp-lcp
max-slot-id
The maximum slot ID for Van Jacobson TCP/IP header compression.
357
Parameters
Values 3 to 16
Default 3
Access This parameter is read-write.
Location ppp-ncp
Notes The ip-comp-protocol parameter must be set to vj-tcp to enable Van
Jacobson TCP/IP header compression. See RFC 1332 for more information
on Van Jacobson compression.
max-term-retries
Number of Link Control Protocol (LCP) termination retries without response
before the link is brought down.
Values 1 to 999
Default 2
Access This parameter is read-write.
Location ppp-lcp
max-terminate-retries
Number of IP termination retries without response before the session is
brought down.
Values 1 to 999
Default 2
Access This parameter is read-write.
Location ppp-ncp
mru-enable
Enable or disable Maximum Receive Unit (MRU) negotiation.
Values enabled
disabled
Default enabled
Access This parameter is read-write.
Location ppp-lcp
num-channels
The maximum number of channels allowed on this interface.
358
PPPoA
Values 1
Default 1
Access This parameter is read-write.
Location ppp-interface
Notes Only one channel is supported.
num-mode-enable
Enable or disable Numbered Mode negotiation.
Values enabled
disabled
Default disabled
Access This parameter is read-write.
Location ppp-lcp
Notes From RFC 1663: The Link Control Protocol (LCP) Numbered-Mode
pap-password
The password used for authenticating with the PAP protocol.
Default empty string
Access This parameter is read-write.
Location ppp-auth
Notes The pap-peer-id and pap-password values must be entered as strings with
single quotes. After the ppp-auth record is saved, the pap-peer-id and
pap-password values will be converted to hexadecimal values. For example,
the string test will be returned as 74:65:73:74.
pap-peer-id
The username for authenticating with the PAP protocol.
Default empty string
Access This parameter is read-write.
Location ppp-auth
Notes The pap-peer-id value must be entered as a string with single quotes. After
359
Parameters
pfc-enable
Enable or disable Protocol Field Compression (PFC) negotiation.
Values enabled
disabled
Default disabled
Access This parameter is read-write.
Location ppp-lcp
quality-protocol
The link Quality Protocol used.
Values lqr
Default lqr
Access This parameter is read-write.
Location ppp-lcp
Notes The only valid quality protocol is LQR.
receive-auth-enable
Enable or disable incoming authentication.
Values enabled
disabled
Default enabled
Access This parameter is read-write.
Location ppp-lcp
Notes This parameter provides a method to negotiate the use of a specific protocol
for authentication.
restart-timer
Number of seconds before retransmission of an Link Control Protocol (LCP)
packet.
Values 1 to 999
Default 3
Access This parameter is read-write.
Location ppp-lcp
360
PPPoA
rx-acc-map
The Asynchronous Control Character (ACC) map that the local PPP entity
requires for use on its receive side. In effect, this is the ACC map that is
required in order to ensure that the local modem will successfully receive all
characters.
Access This parameter is read-write.
Location ppp-lcp
Notes Changing this parameter will take effect when the link is next restarted.
sdp-enable
Enable or disable Self-Describing Padding (SDP) negotiation.
Values enabled
disabled
Default disabled
Access This parameter is read-write.
Location ppp-lcp
send-auth-identity
The identity (PAP peer ID or CHAP name) used with send-auth-protocol to
look up the outgoing authentication information.
Default empty string
Access This parameter is read-write.
Location ppp-lcp
receive-auth-protocol
The preferred protocol used for incoming authentication.
Values pap
chap
Default pap
Access This parameter is read-write.
Location ppp-lcp
Notes If receive-auth-enable is enabled, the authentication protocol will be
361
Parameters
restart-timer
Number of seconds before retransmission of an IP packet.
Values 1 to 999
Default 3
Access This parameter is read-write.
Location ppp-ncp
send-auth-enable
Enable or disable outgoing authentication.
Values enabled
disabled
Default disabled
Access This parameter is read-write.
Location ppp-lcp
send-auth-protocol
The protocol used with send-auth-identity to look up the outgoing
authentication information.
Values pap
chap
Default pap
Access This parameter is read-write.
Location ppp-lcp
status
Indicates whether the authentication is valid or invalid.
Values valid
invalid
Default valid
Access This parameter is read-write.
Location ppp-auth
Notes Setting this parameter to invalid causes the information for that record to
362
RIP
tx-acc-map
The Asynchronous Control Character (ACC) map that the local PPP entity
requires for use on its transmit side. In effect, this is the ACC map that is
required in order to ensure that all characters can be successfully transmitted
through the local modem.
Access This parameter is read-write.
Location ppp-lcp
Notes Changing this parameter will take effect when the link is next restarted.
vci
The Virtual Channel Identifier (VCI) value for the PPP VCL.
Values 0 to 65535
Default 0
Access This parameter is read-write.
Location ppp-interface
Notes See RFC 2515 for more information.
vpi
The Virtual Path Identifier (VPI) value for the PPP VCL.
Values 0 to 4095
Default 0
Access This parameter is read-write.
Location ppp-interface
Notes See RFC 2515 for more information.
RIP
admin-state
Operational state of Routing Information Protocol (RIP) for all routing
domains on the system.
Values disabled
enabled
Default enabled
Access This parameter is read-write.
363
Parameters
Location rip-global-config
Notes This parameter can also be set using the rip enable command.
auth-key
The RIP 2 authentication key. The key is in hexadecimal, and must be less
than 16 octets (32 hex digits). If a string shorter than 16 octets is supplied, it
will be left- justified and padded to 16 octets, on the right, with null characters
(0x00).
Access This parameter is read-write.
Location rip-if-config
Notes auth-key is not valid if auth-type is set to none.
auth-type
The type of authentication that is used when receiving RIP packets on this
interface.
Values md5
default-metric
The metric for the default route entry in RIP updates that is transmitted from
this interface. A value of 0 (zero) indicates that the system does not originate a
default route. In this case, a default route from another router can be
propagated. The default is set using the metric in the received update.
Access This parameter is read-write.
Location rip-if-config
poison
This variable specifies whether to send poison reverse updates on this
interface. Poison reverse updates are used to prevent larger loops within the
364
RIP
network by setting the metric (cost) of neighboring routes to infinity. This will
prevent two-hop loops.
Values disabled
and allow smaller update packets. Split horizon specifies that when a RIP
update is sent out to a particular network interface, it should not include
routing information acquired over that same interface. Poison Reverse is a
variation of the split horizon technique that specifies that all routes are
included in an update out a particular interface, but that the metric is set to
infinity for routes acquired over that interface. One drawback is that routing
update packet sizes are increased when using poison reverse.
receive-type
Which version of RIP updates the system accepts.
Values ripv1
Only RIP version 1 updates compliant with RFC 1058 are accepted.
ripv2
Only RIP version 2 updates compliant with RFC 1388 are accepted. This
setting implies acceptance of multicast packets.
ripv1orripv2
Either RIP version 1 or version 2 updates are accepted. This setting
implies acceptance of multicast packets.
donotreceive
No RIP updates are accepted.
Default ripv1orripv2
Access This parameter is read-write.
Location rip-if-config
See Also send-type
remotefault
Identifies any local fault indications that this media access unit (MAU) has
detected and will advertise at the next auto-negotiation interaction for
1000Mbps MAUs.
365
Parameters
Values noerror
offline
linkfailure
autonegerror
Location rip-if-config
send-type
The type of RIP updates the system sends on this interface.
Values donotsend
sent-updates
The number of triggered RIP updates actually sent on this interface. This
number does not include full updates sent containing new information.
Location rip-if-config
src-address
The IP address that the system will use as a source address on this interface. If
it is a numbered interface, this must be the interface IP address. On
unnumbered interfaces, it must be the IP address for some interface on the
system.
This must be the same value as ipIfAddr (from ZHONE-IP-REC-MIB).
366
RS232
sroute-advertise
Specifies whether to advertise static routes.
Values none
update-time
The time in seconds between transmissions of RIP updates on all interfaces
within a routing domain.
Default 30 seconds, which follows RFC 1058 and subsequent RIP RFCs.
Access This parameter is read-write.
Location rip-global-config
version
The RIP version number in the header of the last RIP packet received from a
peer.
Values 0 to 255, inclusive
Access This parameter is read-only.
Location rip-peer
RS232
This section describes the RS232 parameters. These parameters are used to
configure the serial craft port settings.
367
Parameters
rs232PortInSpeed
The serial craft port input speed in bits per second (bps).
Values 9600, 19200, 38400, 57600
Access This parameter is read-write.
Location rs232-profile
Notes rs232PortInSpeed must match rs232PortOutSpeed.
Products BAN, MALC
rs232PortOutSpeed
The serial craft port output speed in bits per second (bps).
Values 9600, 19200, 38400, 57600
Access This parameter is read-write.
Location rs232-profile
Notes rs232PortOutSpeed must match rs232PortInSpeed.
Products BAN, MALC
rs232PortInFlowType
The serial craft port type of input flow control.
Values ctsRts
dsrDtr
none
Access This parameter is read-write.
Location rs232-profile
Products BAN, MALC
rs232PortOutFlowType
The serial craft port type of output flow control.
Values ctsRts
dsrDtr
none
Access This parameter is read-write.
Location rs232-profile
Products BAN, MALC
368
RS232
rs232AsyncPortBits
The serial craft port number of bits in a character.
Access This parameter is read-write.
Location rs232-profile
Products BAN, MALC
rs232AsyncPortStopBits
The serial craft port number of stop bits.
Values dynamic
one
oneAndHalf
two
Access This parameter is read-write.
Location rs232-profile
rs232AsyncPortParity
The serial craft port sense of a character parity bit.
Values even
mark
none
odd
space
Access This parameter is read-write.
Location rs232-profile
Products BAN, MALC
rs232AsyncPortAutobaud
Specifies whether the port automatically senses input speed.
Values disabled
enabled
Access This parameter is read-write.
Location rs232-profile
Notes Only disabled is supported.
369
Parameters
SHDSL
shdsl-clock-offset
This parameter is used to help achieve a low frequency wander and jitter
between network and DSL system clock. This value can only be set on
devices configured as CO in the dsl-config profile.
Values -100 to 100 (in parts per million)
Default 0
Access This parameter is read-write.
Location shdsl-config
370
SHDSL
line-rate-4w-768kbps
line-rate-4w-1152kbps
line-rate-4w-1536kbps
line-rate-4w-1920kbps
line-rate-4w-2304kbps
line-rate-4w-2688kbps
line-rate-4w-3072kbps
line-rate-4w-3456kbps
line-rate-4w-3840kbps
line-rate-4w-4224kbps
line-rate-4w-4608kbps
line-rate-4w-512kbps
line-rate-4w-896kbps
line-rate-4w-1280kbps
line-rate-4w-1664kbps
line-rate-4w-2048kbps
line-rate-4w-2432kbps
line-rate-4w-2816kbps
line-rate-4w-3200kbps
line-rate-4w-3584kbps
line-rate-4w-3968kbps
line-rate-4w-4352kbps
line-rate-4w-640kbps
line-rate-4w-1024kbps
line-rate-4w-1408kbps
line-rate-4w-1792kbps
line-rate-4w-2176kbps
line-rate-4w-2560kbps
line-rate-4w-2944kbps
line-rate-4w-3328kbps
line-rate-4w-3712kbps
line-rate-4w-4096kbps
line-rate-4w-4480kbps
Default line-rate-2320kbps
Access This parameter is read-write.
Location shdsl-config
shdsl-decoder-coeffA/shdsl-decoder-coeffB
21 bit value corresponding to the decoder coefficient A or B, as defined in the
G.991.2 standard. Note that the default value is bit-reversed, when compared
against the recommended polynomials in the G.991.2 standard. Thus when
you enter the 21-bit value, it should be written bit-reversed also.
Values 0 to 2097151
Default 366 (for shdsl-decoder-coeffA)
shdsl-dsp-version
The version of the DSP/Framer VLSI in the transceiver.
371
Parameters
shdsl-firmware-version
The firmware release number.
Access This parameter is read-only.
Location shdsl-status
shdsl-fix-bit-rate
Normally, if the CO side and CPE side select different line rates at startup, the
lower of the two rates will be selected. By using the fix bit rate the CO side
can override the default procedure and require startup at the rate specified in
the shdsl-config-line-rate.
Values fix-bit-disable
This value enables automatic baud rate adaption, where the DSL modem
will train at the best achievable rate. If the CO and CPE devices have
different line rates at startup, the line will train up to the highest rate
supported by both devices.
fix-bit-enable
This value is used for static (set) baud rates. With this option, the line will
attempt to connect at the rate configured in the shdsl-config-line-rate.
Default fix-bit-disable
Access This parameter is read-write.
Location shdsl-config
Notes This parameter is applicable only if unit-mode is co.
shdsl-frame-sync
The 14 bit frame sync word (FSW).
Values From 0 to 65535
Default 45
Access This parameter is read-write.
Location shdsl-config
Notes Not currently supported.
shdsl-ntr
Determines the clocking on the SHDSL line.
372
SHDSL
Values ntr-local-osc
The line uses the systems internal clock. Also known as local timing.
ntr-refck-8KHz
The line uses an 8KHZ clock derived from a timing source such as a T1
interface.
Default ntr-local-osc
Access This parameter is read-write.
Location shdsl-config
Notes Circuit Emulation Service (CES) transports TDM circuits over ATM
{false}: true
system-clock-weight: ------>
{5}:
....................
Save changes? [s]ave, [c]hange or [q]uit: s
Record updated.
shdsl-power-scale
Reduces the transmit power in small increments to compensate for minor
differences in power between units. The formula for the adjustment is:
Power scale = 26112 * 10([adjustment in dB]/ 20)
The following values are recommended for different loop lengths.
Values 17664
373
Parameters
shdsl-repeater-id
This value identifies if the STU is being used as a repeater.
Values noChangeRepeater
repeaterDisable
repeaterEnable
Default repeaterDisable
Access This parameter is read-write.
Location shdsl-config
shdsl-standard
Determines the SHDSL standards.
Values annex-a
shdsl-startup-margin
Specifies the minimum desired target margin in dB for the local line
conditions during startup. Used to negotiate the bit rate during startup.
Values 0 to 10
Default 6
Access This parameter is read-write.
Location shdsl-config
shdsl-transmit-power-back-off-mode
Indicates if transmit power backoff is used on the other end of the loop. When
enabled, the transmit power is reduced in steps of 1dB from 0 to 6 dB
according to the received power.
Values backoffDisable
backoffEnable
Default backoffEnable
Access This parameter is read-write.
374
Location shdsl-config
shdsl-wire-mode
This setting disables or enables 4-wire-framing.
Values four-wire-disable
Four wire framing is disabled. Use this setting for the 2 wire SHDSL card.
four-wire-enable-bit-interleave
Sends one bit on channel 1, then one bit on channel 2, as described in the
ITU-T G.991.2, section E.2.
four-wire-enable-byte-interleave
sends one byte on channel 1, and then one byte on channel 2, as described
in ITU-T G.991.2, section E.7
four-wire-enable-non-interleave
Sends 12 bytes on channel 1, 12 bytes on second channel 2.
Default four-wire-disable
Access This parameter is read-write.
Location shdsl-config
thermo-b-lower-threshold
The lower threshold for thermometer B in degrees Celsius. When
thermo-b-temperature is below this value, thermo-b-operational-status is
below the lower threshold, and a trap is generated.
Values Valid range is -10 to 5 degrees Celsius
Default -5 degrees Celsius
Access This parameter is read-write.
Location s100-environment-profile
375
Parameters
thermo-a-upper-threshold
The upper threshold for thermometer A in degrees Celsius. When
thermo-a-temperature is above this value, thermo-a-operational-status is
greater than the upper threshold and a trap is generated.
Values Valid range is 45 to 80 degrees Celsius
Default 65 degrees Celsius
Access This parameter is read-write.
Location s100-environment-profile
thermo-b-upper-threshold
The upper threshold for thermometer B in degrees Celsius. When
thermo-b-temperature is above this value, thermo-b-operational-status is
greater than the upper threshold and a trap is generated.
Values Valid range is 45 to 80 degrees Celsius.
Default 60 degrees Celsius
Access This parameter is read-write.
Location s100-environment-profile
SNMP
access-table-index
Displays the access list associated with the community name, indicating
which IP addresses are allowed to use this community name.
The value 0 indicates that no address checking is performed; all SNMP
requests are allowed with the access right specified by the permissions
parameter.
Location community-access-profile, community-profile
community-name
Community name to be sent in all traps sent to this destination.
Location community-profile
ip-address
The IP address from which a management connection to the device can be
established.
376
SNMP
thresh15min-badseq
The number of sequence errors within any given 15-minute performance data
collection period, which causes the SNMP agent to send an
aal2PerfCellLossThreshTrap. One trap will be sent per interval per interface.
Values 0 to 900
Default 0 (will disable the trap)
Location aal2-vcl-profile
Products Sechtor 100A
thresh15min-congestion
The number of congestion events within any given 15-minute performance
data collection period, which causes the SNMP agent to send an
aal2PerfCongestionThreshTrap. One trap will be sent per interval per
interface.
Values 0 to 900
Default 0 (will disable the trap)
Location aal2-vcl-profile
Products Sechtor 100A
trapadminstatus
Specifies whether the device reports traps to the trap destination.
Values enabled
disabled
Default enabled
Location trap-destination
trapdestination
The IP address destination for traps.
Location trap-destination
traplevel
The lowest-level severity level of the traps reported to the trapdestination.
377
Parameters
Values critical
severe
moderate
low
Default low
Location trap-destination
traptype
The type of trap to be sent to this trapdestination. This parameter is currently
unsupported.
Values catAdmin
catLine
catVoice
catIP
catRip
canRadio
Location trap-destination
SONET
apsChanConfigAdminStatus
Administrative status of the APS object.
Values inService (1)
outOfService (2)
Default outOfService (2)
Access This parameter is read-create.
Location aps-channel
apsChanConfigGroupName
The configured name of the APS group.
Access This parameter is read-write.
Location aps-channel
378
SONET
apsChanConfigNumber
A unique channel number within an APS group. The value 0 indicates the null
channel. The values 1-14 define a working channel. If the SONET LTE is not
part of an APS group this value is set to -1
Access This parameter is read-only.
Location aps-channel
apsChanConfigPriority
Determines whether high or low priority SD and SF codes are used in K1
requests. This field is only applicable if the channel is to be included in a
group using the 1:n architecture. It is not applicable if the channel is to be
included in a group using the 1+1 architecture and is ignored in that case.
Default low
Access This parameter is read-create.
Location aps-channel
apsConfigCreationTime
The value of sysUpTime at the time APS was configured.
Access This parameter is read-only.
Location aps-group
apsConfigDirection
The directional mode of the APS group.
Values unidirectional
directions.
Default unidirectional
Access This parameter is read-create.
Location aps-group
apsConfigExtraTraffic
Enables or disables the transfer of extra traffic on the protection channel in a
1:n architecture. This object must be set to disabled if the architecture is 1+1.
Default disabled
Access This parameter is read-only.
379
Parameters
Location aps-group
apsConfigMode
The protection architecture of the APS group.
Values onePlusOne (1)
Access This parameter is read-only.
Location aps-group
apsConfigRevert
The revertive mode of the APS group.
Values nonrevertive)
apsConfigsdBerThreshold
The Signal Degrade Bit Error Rate. The negated value of this number is used
as the exponent of 10 for computing the threshold value for the Bit Error Rate
(BER). For example, a value of 5 indicates a BER threshold of 10^-5.
Default 6
Access This parameter is read-create.
Location aps-group
apsConfigsfBerThreshold
The Signal Failure Bit Error Rate. The negated value of this number is used as
the exponent of 10 for computing the threshold value for the Bit Error Rate
(BER). For example, a value of 5 indicates a BER threshold of 10^-5.
Default 3
Access This parameter is read-create.
Location aps-group
380
SONET
apsConfigWaitToRestore
The Wait To Restore period in seconds. After clearing a condition that
necessitated an automatic switch, the wait to restore period must elapse before
reverting.
Default 300
Access This parameter is read-create.
Location aps-group
clock-external-recovery
Whether internal clocking can be recovered from an external source.
Values enabled
disabled
Access This parameter is read-write.
Location sonet-profile
clock-transmit-source
The clocking source.
Values external155mhz
medium-cell-scramble-config
The SONET scramble mode at the cell level.
Values true
381
Parameters
Default true
Access This parameter is read-write.
Location sonet-profile
medium-circuit-identifier
The SONET circuit identifier, determined by the system installer.
Values string of up to 260 characters
Access This parameter is read-write.
Location sonet-profile
medium-line-coding
The line coding for the SONET interface.
Values sonetMediumOther
sonetMediumB3ZS
Used for STS-1 and STS-3 electrical SONET/SDH signalling.
sonetMediumCMI
Used for STS-1 and STS-3 electrical SONET/SDH signalling.
sonetMediumNRZ
Non-Return to Zero. Used for optical SONET/SDH signals.
sonetMediumRZ
Return to Zero. Used for optical SONET/SDH signals.
Access This parameter is read-write.
Location sonet-profile
medium-line-scramble-config
The SONET scramble mode at the line level.
Values true
medium-line-type
The line type for the SONET interface.
382
SONET
Values sonetShortSingleMode
medium-loopback-config
How the SONET loopback is configured.
Values sonetnoloop
medium-cell-scramble-config
Whether the SONET cell scramble mode is enabled.
Values true
medium-type
The type of SONET signaling.
383
Parameters
Values sonet
path-current-width
The type of SONET/SDH path.
Values sts1
sts3cSTM1
sts12cSTM4
Access This parameter is read-write.
Location sonet-profile
Subscriber
capable-line-rate-limit
The maximum line rate that can be supported by the subscriber line. This rate
is determined by several factors including the distance the subscriber is from
the CO, the copper facilities to the subscriber, and the type of IAD installed.
This value is determined by the service provider.
Values 0 to 2147483647, inclusive.
Access This parameter is read-write
Location subscriber
iad-type
Identifies the type of IAD used by the subscriber.
Values zedge64s
Access This parameter is read-write.
Location subscriber
line-group-id
The line group identifier. Use the lineGroup command to find this value.
384
Subscriber
line-rate-limit
The maximum line rate (in bits per second) that the subscriber is provisioned
to receive from the service provider. This value is the total line rate or
bandwidth of the subscriber connection, including voice and data.
Values 0 to 2147483647, inclusive.
Access This parameter is read-write.
Location subscriber
name
Subscriber name.
Location subscriber
name-group-id
An administratively defined name used to aid operators identify subscribers in
the system. The name is not used by the system, it is only for operator
reference.
Access This parameter is read-write.
Location subscriber
service-provider-id
Unique service provider ID. This value is used throughout the management
system to link parameters with customers or service providers.
Access This parameter is read-write.
Location subscriber
tools-access
Indicates whether the specified user has tools privileges.
Access This parameter is read-only.
Notes Use the adduser and updateuser commands to configure user accounts.
voice-admin-status
The administrative state of this connection.
Values enabled
disabled
Default disabled
385
Parameters
Location subscriber-voice
System
countryregion
The country or region this system is operating in. This parameter sets A-Law
Mu-Law companding and sets the ring frequency for the trunk side interface
of the device. These settings are in accordance with ITU-T E.180 and ITU-T
E.180 Supplement 2.
Values australia, brazil, canada, chile, china, czechrepublic, egypt, etsi, finland,
enableauthtraps
Indicates whether the system is permitted to generate authenticationFailure
traps. The value of this parameter overrides any configuration information
and provides a means to disable all authentication Failure traps.
Access This parameter is read-write
Location system
ipaddress
The IP address of this system. Independent of the different IP interfaces
configured and what is active, a manager uses this address to communicate
with the system.
Access This parameter is read-write.
Location system
manuf-access
Indicates whether the specified user has manuf(acturing) privileges.
Access This parameter is read-only.
Notes Use the adduser and updateuser commands to configure user accounts.
386
System
numcards
The total number of cards in the system.
Access This parameter is read-only.
Location system
numshelves
The number of shelves in the system.
Access This parameter is read-only.
Location system
permissions
The access level associated with the community name:
Values noAccess
primaryclocksource
The address of the interface from which the system 8khz backplane clock can
be derived. Only active DS1, DS3, and OC-3 interfaces can provide system
clock.
Values Any active DS1, DS3, or OC3 interface.
Default 0/0/0/0/0
387
Parameters
The interface that provides the clock source must be set to loop timing or local
timing (DS3 interface).
Products BAN, MALC, Raptor, Sechtor 100A
revertiveclocksource
Redundant clock sources are revertive by default. If a standby clock source
becomes active after the failure of a primary clock source, the system will
revert to the primary clock source after that clock source becomes active
again. Note that the clock source must be active for 30 seconds before the
system will revert back to the primary clock source.
Values true
false
Default true
Access read-write
Location system
Products BAN, MALC, Raptor, Sechtor 100A
ringsource
Ring voltage source selection (internal or external).
Values internalRingSourceLabel
Select internal ring generator (located within MTAC) as source for ring
voltage to line cards.
externalRingSourceLabel
Select external ring generator (input connector located on MTAC) as
source for ring voltage to line cards.
Default internalRingSourceLabel
Location system
setserialno
An advisory lock used to allow several cooperating SNMPv2 entities, all
acting in a manager role, to coordinate their use of the SNMPv2 set
operation.This parameter is used for coarse-grain coordination.
Access This parameter is read-write.
Location system
shelvesarray
Bit array from 0-255 (32 8-bit bytes) that are present in the system.
388
V5.2
syscontact
The textual identification of the contact person for this managed node,
together with information on how to contact this person.
Values If no contact information is known, the value is a zero-length string.
Access This parameter is read-write.
Location system
syslocation
The physical location of the device.
Values If the location is unknown, the value is a zero-length string.
Access This parameter is read-write.
Location system
sysname
An administratively-assigned name for this managed node. By convention,
this is the node's fully-qualified domain name.
Values If the name is unknown, the value is the zero-length string.
Access This parameter is read-write.
Location system
system-access
Specifies user access level.
Location user-profile
V5.2
admin-status
The administrative status of the V5.2 interface group, user port or link.
389
Parameters
Values inservice
outofservice
deferredoutofservice
Takes the group, port, or link out of service, but not until all calls are
completed.
restart
Causes the v52 interface to shut down for a period of time, then go
through the startup procedure. When restart is complete, the V5.2
interface should go back to the previously configured admin status before
it was set to restart.
According to ETSI EN 300 347-1 V2.2.2, a system must be shut down for
95 seconds before it can be returned to service.
Default outOfService
Access This parameter is read-write.
Location v52-user-port, v52-interface-group, v52-link
390
V5.2
check-id
This parameter is set to activated to request that the V5.2 link ID on the AN
side be checked with the LE side link ID. When the check- id is finished, this
value is notActivated.
A link identification check can only be started when the V5.2 link is
operational, and can be initiated from either the AN or LE side. (The LE
request has priority over any AN initiated requests to avoid request collision.)
Values activated
notActivated
Default notActivated
Access This parameter is read-write.
Location v52-link
c-path-valid-flag
When this parameter is set to valid, the C-path is active.
391
Parameters
Values valid
invalid
Location v52-interface-group
dsn-lg-id
Describes the line group ID associated with the E1 link. Use the lineGroup
command to find the line group ID.
Values 1 to 16, inclusive
Location v52-interface-group
id (V5.2 link)
The V5.2 link identifier. Assigned by the Local Exchange (LE).
Values 0 to 255, inclusive
Access This parameter is read-write.
Location v52-link
id (V5.2 path)
The ID number of the communications path.
Values 0 to 255
Location v52-path
inbound-calls
The number of inbound calls completed over the V5.2 IG.
Access This parameter is read-only.
Location v52-stats-current, v52-stats-interval, v52-stats-total
Notes PerfCurrentCount
isdn-env-func-start-address
The start address for ISDN users. When ISDN users are added, they must
have an address greater or equal to this one. This value must match the value
on the switch.
Values 0 to 8175, inclusive
Access This parameter is read-write.
Location v52-interface-group
392
V5.2
isdnds-cpath-id
If the user port is configured for ISDN, this parameter is equal to the
associated C-path ID that carries Ds-type data. A value of 0 (zero) indicates
that the user port is not configured to carry Ds-type data.
Values 0 to 48, inclusive
Access This parameter is read-write.
Location v52-user-port
isdnf-cpath-id
If the user port is configured for ISDN, this parameter is equal to the
associated C-path ID that carries f-type data. A value of 0 (zero) indicates that
the user port is not configured to carry f-type data.
Values 0 to 48, inclusive.
Access This parameter is read-write.
Location v52-user-port
isdnp-cpath-id
If the user port is configured for ISDN, this parameter is equal to the
associated C-path ID that carries p-type data. A value of 0 (zero) indicates that
the user port is not configured to carry p-type data.
Values 0 to 48, inclusive.
Access This parameter is read-write.
Location v52-user-port
link-is-timer
Specifies the length of time that a V5.2 link must be in a framed state before
the interface declares that the link is in service. This value should be less than
the equivalent value that is provisioned in the LE.
Values 50 to 10000, inclusive.
Default 200
Access This parameter is read-write.
Location v52-interface-group
393
Parameters
link-oos-timer
Specifies the length of time that a V5.2 link must be in a failed state before the
interface declares that the link has failed. This value should always exceed the
equivalent value that is provisioned in the LE.
Values 50..10000
Default 2500
Access This parameter is read-write.
Location v52-interface-group
link-valid-flag
Activates the E1 circuit.
Values valid
invalid
Location v52-interface-group
local-interface-id
The interface ID of the IG. Must be unique across the system. This value must
match the value on the switch.
Values 1 to 16777215, inclusive.
Default 0
Access This parameter is read-write.
Location v52-interface-group
local-prov-variant
The prov(isioning) variant describes a type of provisioning. This value must
match the value on the switch.
Values 0 to 127, inclusive
Default 0
Access This parameter is read-write.
Location v52-interface-group
logical-channel-id (C-path)
The logical C-channel ID that the C-path is using. This number must match
the logical-channel-id value of the C-channel that the C-path is running over.
394
V5.2
logical-channel-id (C-channel)
The C-channel logical channel ID. C-channels carry one or more C-paths. A
V.52 interface may contain up to 44 logical C-channels and each logical
C-channel on an interface is uniquely identified with a 16 bit logical
C-channel identifier. C-channels that are provisioned as standby channels in a
protection group do not have a logical C-channel identifier.
Values 0 to 65535, inclusive.
Access This parameter is read-write.
Location v52-cchannel
max-outstanding-frames
The maximum number of outstanding information frames at layer two.
Values 1 to 7, inclusive
Default 7
Access This parameter is read-write.
Location v52-interface-group-lapv
n200
The maximum number of retransmissions for a frame allowed at layer two.
Values 1 to 10, inclusive.
Default 3
Access This parameter is read-write
Location v52-interface-group-lapv
n201
The maximum number of octets in the information field of an I frame.
Values 0 to 256, inclusive.
Default 256
Access This parameter is read-write.
Location v52-interface-group-lapv
395
Parameters
national-pstn-region
The regional and country-specific setting for V5.2 PSTN service. The PSTN
region dictates regional signaling differences like ring cadence.
Values australia, brazil, egypt, estonia, finland, france, germany, hongkong,
ireland, italy, japan, korea, malaysia, mexico, spain, sweden, taiwan, uk,
unitedarabemirates, us
Default unknown
Access This parameter is read-write.
Location v52-interface-group
port-alignment-request
A request to block or unblock all the user ports associated with the current IG
by port type.
Values noRequest
blockAll
Block all user ports associated with this IG.
blockIsdn
Block all of the isdnBa and isdnPra user ports associated with this IG.
blockPstn
Block all of the PSTN user ports associated with this IG.
unblockAll
Unblock all user ports associated with this IG.
unblockIsdn
Unblock all of the isdnBa and isdnPra user ports associated with this IG.
unblockPstn
Unblock all the pstn user ports associated with this IG.
Default noRequest
Access This parameter is read-write.
Location v52-interface-group
protection-group
The C-channel protection group.
396
V5.2
Values none
group1
oneToOneGroup2
mToNgroup2
Access This parameter is read-write.
Location v52-cchannel
protocol-spec
This variable specifies which variation of the v5.2 protocol is used by this
V5.2 IG.
Values edition1
The V5.2 specification defined in ETSI ETS 300 347-1 ed.1 (1994-09).
edition2
The V5.2 specification defined in ETSI EN 300 347-1 V2.2.2 (1999-12).
Default edition2
Access This parameter is read-write.
Location v52-interface-group
prov-variant-request
A request by the user regarding the provisioning variant.
Values noRequest
pstn-layer-3-start-address
The start address for PSTN users. When PSTN users are added, they must
have an address greater or equal to this one. This value must match the value
on the switch.
397
Parameters
reg-or-lease-user
What kind of lease the user carries.
Values regular
permanentLease
semiPermanentLease
Default regular
Access This parameter is read-write.
Location v52-user-port
role
The C-channel role. This value must match the value on the switch.
Values active
shelf
The system shelf. Zero (0) is an invalid value.
Values 1 to 255, inclusive.
Access This parameter is read-only.
Location v52-interface-group-stats
398
V5.2
startup-unblock-user-ports
Indicates whether or not user ports will be unblocked when the V5.2 interface
is starting up.
Values true
false
Default true
Access This parameter is read-write.
Location v52-interface-group
startup-check-link-id
Indicates whether or not a Link ID check will be performed when the V5.2
interface is starting up.
Values true
false
Default true
Access This parameter is read-write.
Location v52-interface-group
switch-vendor
The switch vendor for this V5.2 IG.
Values unknown
lucent
nortel
alcatel
ericsson
nokia
siemens
samsung
Default unknown
Access This parameter is read-write.
Location v52-interface-group
399
Parameters
t200
The maximum layer two wait time for an acknowledgment of a transmitted
frame. Units are in milliseconds, in increments of 50.
Values 100 to 1000, inclusive.
Default 150
Access This parameter is read-write.
Location v52-interface-group-lapv
t203
Maximum layer two idle time before connection verification is necessary.
Units are in seconds, in increments of ten.
Values 1 to 300, inclusive.
Default 30
Access This parameter is read-write.
Location v52-interface-group-lapv
time-slot-index
The channel that the C-channel is running over.
Values 15
16
31
Location v52-interface-group
type
The type of communications path. This tells the system how the management
information is communicated.
Values unknown
pstn
POTS
ctrl
control protocol
bcc
bearer channel connection
lctl
link control protocol
400
V5.2
isdnds
BRI voice data
Default unknown
Access This parameter is read-write.
Location V52_CPath
v52-c-channel:array[1..3]
This array describes up to three control channels per link (E1). There can be
up to three control channels on each of the 16 links for a maximum of 48.
C-channels are used to pass management information between then LE and
the Zhone device system. It includes the time-slot-index, logical-channel-id,
protection-group, role, and c-channel-valid-flag parameters.
Location v52-interface-group
v52-c-path:arrary[1..48]
This array describes communications paths. C-paths are used to specify the
type of information running between the Zhone device and the LE. C-paths
run inside C-channels. There can be up to 48 C-paths inside each C-channel.
This array includes the id, type, logical-channel-id, and c-path-valid-flag
parameters.
Values Use the logical-channel-id numbers created for the C-channels.
Location v52-interface-group
v52-ig-lapv
An array of V5.2 Lapv timer parameters. These configure retries and other
functions over the management links. This array includes the parameters
max-outstanding frames, n200, n201, t200, and t203.
Location v52-interface-group
v52-link[1..16]
This array is used to provision the E1circuits between the LE and the Zhone
device. There can be up to sixteen links. Each E1 link has 32 channels. This
array includes the dsn-lg-id, ds1-channel-number, id, check-id,
check-id-status, and block parameters.
Location v52-interface-group
voice-V52-interface-name
The name of the V5.2 interface group. This is the same as the name-id from
the v52-interface-group profile.
401
Parameters
Location subscriber-voice-v52
voice-V52-isdn-channel-id
The ISDN B or D channel used for the connection.
Location subscriber-voice-v52
voice-V52-user-port-id
A port ID for the V5.2 user port. This is the same as the local-interface-id in
the v52-interface-group profile.
Location subscriber-voice-v52
voice-V52-user-type
The type of V5.2 user port.
Values POTS
isdndchannel
isdnbchannel
Location subscriber-voice-v52
VDSL
mode
Type of VDSL equipment.
Values vtu-r
us-max-const
Restrict upstream quadrature amplitude modulation (QAM) constellations to
use those that do not exceed this maximum.
402
Voice
Values QAM-4
QAM-8
QAM-16
QAM-32
QAM-64
QAM-128
QAM-256
Default QAM-128
Location vdsl-config
Voice
ds0-channel-id
The DS0 assigned to this subscriber.
Access This parameter is read-write.
Location subscriber-voice-ds1
ds1-line-group
The line group Interface Index of the DS1 interface.
Access This parameter is read-write.
Location subscriber-voice-ds1
echo-cancellation-type
Which echo cancellation algorithm is used for a particular channel.
G.168 has stricter technical specs and defines how the tests are performed
better than G.165. If an echo canceller meets the G.168 specification, it is
G.168 and G.165 compliant.
The number following the designation describes the echo tail length in
milliseconds. The echo tail length that is required depends on several factors,
including the network configuration, local loop length, and line frequency
response. Generally, 16ms is adequate for local loop and 32ms is a good
minimum for network equipment.
Values g165EchoTL16
G.165 echo cancellation with echo tail length of 16ms (MALC only)
403
Parameters
g168EchoTL48
G.168 echo cancellation with echo tail length of 48ms (BAN, Sechtor
100A, Z-Edge)
off
Echo cancellation is off.
Default g165Echotl16 (MALC)
echo-return-loss
The amount of loss between the transmitted signal and the reflected echo back
from the hybrid where the 4-to-2 wire conversion takes place.
Values 0 dB, 6 dB
MALC
0dB, 3dB, 6dB
BAN, Sechtor 100A, Z-Edge
Default 6 (MALC)
features
Enables voice features on a per subscriber basis.
Values hookflash
hookflash detection.
onhooksignaling
onhook signaling.
alwaysoffhook
call is established as soon as incoming call initiation is made.
+
This allows multiple settings. For example, hookflash+onhooksignaling.
Default hookflash+onhooksignaling
Access This parameter is read-write.
Location subscriber-voice
404
Voice
hookflash-max-timer
Specifies the maximum timer that qualifies for a hookflash. Any loopopen
more than this timer will be considered as a onhook.
Access This parameter is read-write.
Location voice-system
Products MALC
hookflash-min-timer
Specifies the minimum timer that qualifies for a hookflash. Any loopopen
below this time will be ignored.
Access This parameter is read-write.
Location voice-system
Products MALC
huntgroup
Determines if this connection is part of a huntgroup.
Default false
Access This parameter is read-write.
Location subscriber-voice
Products MALC
hunt-group-index
The hunt group this subscriber is part of. Each subscriber can be part of 3 hunt
groups.
Access This parameter is read-write.
Location subscriber-voice-ds1, subscriber-voice-pots
Products MALC
inter-arriv-jit-threshold
The inter-arrival jitter threshold in milliseconds per channel that is used as a
trigger value to generate a trap when its value is passed. If the value is 0, the
threshold monitoring is disabled for inter-arrival jitter.
405
Parameters
jitter-buffer-size
The voice DSP jitter buffer size in milliseconds. It refers to the amount of
memory usage that can store certain milliseconds of voice.
For the BAN and Sechtor 100A, changes to the jitter buffer take effect on the
next call.
For the Z-Edge, changes to the jitter buffer require the CID or the VCL to be
brought down and up again, or the system rebooted.
Values 1 to 160
Note that changes to the jitter buffer are based on 5 ms frame sizes. For
example:
1 to 5 = 5 ms
6 to 10 = 10 ms
11 to 15 = 15 ms
16 to 20 = 20 ms
21 to 25 = 25 ms
26 to 30 = 30 ms
.....
146 to 150 = 150 ms
151 to 155 = 155 ms
156 to 160 = 160 ms
Default 10 (BAN, Sechtor 100A, Z-Edge)
Location voice-dsp-default-profile
jitter-buffer-type
The voice DSP channel jitter buffer defaults. The jitter buffer accommodates
the cells/packets received, so that the inter-arrival jitter of the cells/packets
received dont degrade the voice quality. Without a jitter buffer, some cells as
inter-arrival jitter changes would be late, which would have the same effect as
lost cells. The jitter buffer also reorders the out-of-order cells/packets
received.
Values static
A static jitter buffer does not allow the jitter buffer to grow and shrink in
response to changes in jitter.
406
Voice
Default static
Access This parameter is read-write.
Location voice-dsp-default-profile
malicious-caller-uri
Incoming call from this URI will be rejected.
Access This parameter is read-create.
Location malicious-caller
pkts-lost-threshold
How many voice DSP channel packets are lost per minute threshold. A trap is
generated when this value is exceeded. If this value is 0, threshold monitoring
is disabled for lost packets.
Values 0 to 10000 packets per minute.
Default 600
Access This parameter is read-write.
Location voice-dsp-default-profile
redundancy-over-subscription-type
The voice DSP redundancy oversubscription method.
A resource is called active if it is in use and is called standby if it is in reserve
in case the active resource fails. The standby resources in redundant
configurations can be oversubscribed. The active resource is not used when
standby resources are allocated, however, if the active resources are at
maximum capacity, there will be no standby resources available to take over
in case of failure.
Values high
407
Parameters
Products BAN
reject-enabled
Indicates whether the incoming call reject is enabled.
Default true
Access This is a read-create parameter.
Location malicious-caller
Products MALC
silence-suppression-type
Which silence suppression algorithm the voice DSP should use on a channel.
Silence suppression stops voice packet generation during periods of silence.
The SID (silence descriptor) frame is generated at the start of a silence period,
then periodically, and is used to characterize the power level of the
background noise during the silence period on the encode side of the voice
path. The SID frame is passed to the decode side through a packet encoding
medium (AAL2 or RTP). The decode side then generates comfort noise at an
equivalent power level dictated by the SID frame values.
Values silSupOff
voice-aal2-cid
The ATM Adaption Layer 2 channel identifier (AAL2 CID) for the
connection.
Location subscriber-voice
voice-aal2-line-group-id
The line group ID for this AAL2 connection.
Location subscriber-voice
voice-aal2-vci
The AAL2 VCI for this connection.
408
Voice
Location subscriber-voice
voice-aal2-vpi
The AAL2 VPI for this connection.
Location subscriber-voice
voice-access
Indicates whether the specified user has voice privileges.
Access This parameter is read-only.
Location user-profile
Notes Use the adduser and updateuser commands to configure user accounts.
voice-connection-description
A text string describing this voice call entry.
A common use is to define the external or public phone number for this voice
line as assigned by the class 5 switch.
Default none
Access This parameter is read-write.
Location subscriber-voice
Products MALC
voice-connection-type
This describes the connection type between the two voice endpoints. Where
applicable the first endpoint refers to the line or premise side of the
connection and the second endpoint refers to the central office side of the
connection.
Voice connections are created with the voice add command.
Values aal2togr303
409
Parameters
isdntoaal2
ISDN to ATM AAL2.
isdntov52
ISDN to V5.2 interface/user port
potstogr303
POTS to GR-303.
potstov5
POTS to V5.2.
voiptods1
VOIP to DS1.
siptogr303
SIP to GR-303. Requires the MALC Voice Gateway card.
voiptov52
VOIP to V5.2. Requires the MALC Voice Gateway card.
elcpaal2tov52
ELCP to V5.2. Requires the MALC Voice Gateway card.
isdntov52
ISDN to V5.2.
ebstogr303
Electronic business system (EBS) to GR-303.
voiptopots
VOIP to POTS.
isdnsigtovoip
ISDN PRI to VOIP. Supported on the Z-Edge 6200 only.
potstods1
POTS to DS1.
potstoclass5
POTS to a class 5 switch.
Location subscriber-voice
voice-ebs-line-group-id
The line group ID for the associated connection.
Default none
Access This parameter is read-write.
Location subscriber-voice-ebs
Products 6200
410
Voice
voice-endpoint1-addr-index
The index into the associated address table for this end point. EndPoint1
should describe the line or premise side of the connection where applicable.
Default none
Access This parameter is read-write.
Location subscriber-voice
Products MALC
voice-endpoint2-addr-index
The index into the associated address table for this end point. EndPoint2
should describe the central office side of the connection where applicable.
Default none
Access This parameter is read-write.
Location subscriber-voice
Products MALC
voice-ext-type
The external or public phone number for this voice line as assigned by the
Class 5 switch. This value is not used by the system and is provided only for
operator reference.
voice-GR303-ig-crv
The crv for the associated connection.
Default none
Access This parameter is read-write.
Location subscriber-voice-gr303
Products MALC
voice-GR303-ig-name
The IG name for the associated connection.
Default none
Access This parameter is read-write.
Location subscriber-voice-gr303
Products MALC
411
Parameters
voice-pots-line-group-id
The line group ID for the associated connection.
Location subscriber-voice-pots
User
data-access
Indicates whether the specified user has data privileges.
Access This parameter is read-only.
Location user-profile
Notes Use the adduser and updateuser commands to configure user accounts.
database-access
Indicates whether the specified user has database privileges.
Access This parameter is read-only.
Location user-profile
Notes Use the adduser and updateuser commands to configure user accounts.
debug access
Indicates whether the specified user has debug privileges. This parameter is
read-only.
Access This parameter is read-only.
Location user-profile
Notes Use the adduser and updateuser commands to configure user accounts.
user-admin-access
Indicates whether the specified user has user-admin privileges that enable the
user to create user accounts.
Access This parameter is read-only.
Location user-profile
Notes Use the adduser and updateuser commands to configure user accounts.
412
User
user-id
Specifies the user ID for this user.
Access This parameter is read-only.
Location user-profile
Notes Use the adduser and updateuser commands to configure user accounts.
user-name
Specifies the user name.
Access This parameter is read-only.
Location user-profile
Notes Use the adduser and updateuser commands to configure user accounts.
user-pass
Specifies the password for this user.
Access This parameter is read-only.
Location user-profile
Notes Use the changepass or resetpass commands to change user account
passwords.
user-prompt
Specifies the user-prompt for this user.
Access This parameter is read-only.
Location user-profile
Notes Use the adduser and updateuser commands to configure user accounts.
zhone-access
Indicates whether the specified user has Zhone privileges.
Access This parameter is read-only.
Location user-profile
Notes Use the adduser and updateuser commands to configure user accounts.
413
Parameters
VOIP
destination-name
The name of the destination of the specified dial string.
Access This parameter is read-write.
Location sip-dialplan
dialplan-type
Indicates the type of dialplan used.
Values normal
directory-number
The directory number (phone number) assigned to this endpoint. Contains
only digits.
Access This parameter is read-write.
Location subscriber-voice-voip
expires-invite-value
For user agent clients, this value in seconds is inserted into the Expires header.
For proxy servers, if a received request contained an Expires header, then the
value in the header takes precedence.
Access This parameter is read-write.
Location sip-expires-timer-cfg
expires-register-value
For user agent clients, this value in seconds is inserted into the Expires header.
For proxy servers, if a received request contained an Expires header, then the
value in the header takes precedence.
Access This parameter is read-write.
414
VOIP
Location sip-expires-timer-cfg
expires-register-method
This convention is a bit map. Each bit represents a SIP method where the
Expires header should be included. If a bit has value 1, then the requests
corresponding to that SIP method must include an Expires header line. If a bit
has value 0, then the Expires header line will not be added. Combinations of
bits can be set when the Expires header line is required in multiple SIP
methods.
Values bit 0
INVITE method
bit 1
REGISTER method
Access This parameter is read-write.
Location sip-expires-timer-cfg
frames-per-packet
Indicates the number of voice frames per IP packet.
Default 4
Access This parameter is read-write.
Location subscriber-voice-voip
g711-fallback
Indicates whether a subscriber may consume bandwidth by switching to g711,
when a fax, modem, b-channel data session is detected.
Default true
Access This parameter is read-write.
Location subscriber-voice-voip
Products MALC
g726-byte-order
Indicates the byte order to be used when g.726 voice coding is in use. Cisco
uses little endian byte order, whereas the g.726 standard calls for big endian
byte order.
Default bigEndian
Access This parameter is read-write.
Location subscriber-voice-voip
415
Parameters
Products MALC
interdigit-timeout
Indicates the duration, in seconds, that the device will wait after each digit is
entered before assuming the user has finished entering digits.
Default 10
Access This parameter is read-write.
Location voip-system
Products MALC
ip-interface-index
Interface Index of the LP Interface through which the SIP signalling and RTP
traffic flow.
Access This parameter is read-write.
Location subscriber-voice-voip
ip-tos
The type of service (TOS) value that is set in the IP header for voice over IP
traffic.
Default 0
Location voip-system
Products MALC
keep-alive-timer
Specifies a timeout value in seconds for sending a keep alive message to
MGCP servers.
Values 0 to 65535 seconds
This parameter should be set to the same value as the MGCP servers
Audit Endpoint (AUEP) interval.
Products MALC
416
VOIP
match-string
A dialstring against which collected digits are matched.
Access This parameter is read-write.
Location sip-dialplan
number-of-digits
The number of digits to wait for before initiating the call.
Access This parameter is read-write.
Location sip-dialplan
preferred-codec
Defines the preferred voice codec to be used for this subscriber.
Values g711a
g711mu
g723
g726
g729a
Default g711mu
Location subscriber-voice-voip
Products MALC
prefix-add
Specifies the string that is added to the beginning of the dialed digits before
the call is initiated.
Access This parameter is read-write.
Location sip-dialplan
Products MALC
prefix-strip
Specifies the number of prefix digits to strip from the dialed digits.
Access This parameter is read-write.
Location sip-dialplan
Products MALC
417
Parameters
protocol
The signalling protocol used for VOIP. Choices are SIP (Session Initiation
Protocol) and MGCP (Media Gateway Control Protocol.
Default SIP
Access This parameter is read-write.
Location voip-system
Products MALC
rtcp-enabled
Indicates whether the Real-Time Control Protocol is enabled for the device.
Default false
Access This is a read-write parameter.
Location voip-system
Products MALC
rtcp-packet-interval
RTCP packet interval, in milleseconds. Range is 2500 to 10000 ms.
This object's value is only pertinent if RTCP has been enabled.
Default 5000
Access This parameter is read-write.
Location voip-system
Products MALC
send-call-proceeding-tone
Indicates whether, on call originations destined to the PSTN, the device
should play a call proceeding tone while waiting for ring-back tone from the
switch.
Default false
Access This parameter is read-write.
Location voip-system
Products MALC
418
VOIP
server-max-timer
Specifies the period between RSIP retry messages. For redundant MGCP
servers, this the interval between RSIP messages to each server.
Values 0 to 65535 seconds
sip-ip-address
When a match is detected between the collected digits and the dial string in
this SIP dialplan, this IP address is used for SIP negoitations to initiate the
call.
Access This parameter is read-write.
Location sip-dialplan
Products MALC
system-domain-name
The Universal Resource Identifier (URI) of the system.
Default none
Access This parameter is read-write.
Location voip-system
Products MALC
voip-password
Authentication string needed for call originations through a SIP/MGCP
Server.
Access This parameter is read-write.
Location subscriber-voice-voip
Products MALC
voip-plar
The subscriber PLAR (private line automatic ringdown) subscriber. If true we
immediately send a INVITE instead of play dial tone.
Default false
Access This parameter is read-write.
419
Parameters
Location subscriber-voice-voip
Notes This parameter applies to only SIP signaling.
Products MALC
voip-plar-dest-ipaddr
The destination IP address or domain name of the device to send INVITE to
in case the subscriber is PLAR (private line automatic ringdown).
Access This parameter is read-write.
Location subscriber-voice-voip
Notes This parameter applies to only SIP signaling. To use this setting, the voip-plar
voip-plar-dest-ipaddrtype
The type of address contained in the associated instance of
VoipPlarDestIpAddr.
Default ipv4
Access This parameter is read-write.
Location subscriber-voice-voip
Products MALC
voip-server-entry-index
Specfied in the SIP dialplan and when the viop-server-entry index is created,
this number is used to associate dialplans and VOIP registration servers.
Access This parameter is read-write.
Location sip-dialplan
voip-udp-port
Specifies the UDP Port number for the VOIP Setup messages. 5060 is the
IANA Registered SIP port.
Default 5060
Access This parameter is read-write.
Location subscriber-voice-voip
Products MALC
420
VOIP
voip-username
A unique string that identifies the VOIP user in the system.
Default none
Access This parameter is read-write.
Location subscriber-voice-voip
Products MALC
zhoneVoipServerAddr
The address of a VOIP server this user agent will use to proxy/redirect calls.
Default none
Access This parameter is read-write.
Location voip-system
Products MALC
zhoneVoipServerAddrType
The type of address
Default ipv4
Access This parameter is read-write.
Location voip-system
Products MALC
zhoneVoipServerUdpPortNumber
Specifies the UDP Port number for the MGCP Gateway. 2427 is the IANA
Registered MGCP Gateway port.
Default 2427
Access This parameter is read-write.
Location voip-system
Products MALC
421
Parameters
ZMS
ackedseqno
Acknowledged trap sequence number. This field is set by the ZMS in order to
acknowledge a trap sent by the device. There will be only one trap
outstanding on the acknowledged flow at one time so this is the last sequence
number sent. If not, it is ignored.
Location trap-destination
resendseqno
This is set by the ZMS in order to have the device resend saved traps because
one or more were lost in transmission. The device will resend traps starting at
this sequence number.
This is used only on the unacknowledged trap flow. This is the only indication
of whether any traps have been acknowledged.
Location trap-destination
Notes Due to resource constraints not all traps may be available to be resent. The
first trap that the device resends indicates whether or not any traps were
deleted or lost.
zmsconnectionstatus
The status of the connection between this device and the Zhone Management
System, if one exists. This value can either be set directly by ZMS or by the
device internally when a SNMP request is processed from the ZMS. Devices
not being proxied by another entity, since they are not being polled by ZMS,
will set this state according to the communication channel state between this
device and the connected entity.
Values active
inactive
Default inactive
Location system
zmsexists
Indicates whether or not this device is being managed by the Zhone
Management System. This is can be set only by the ZMS.
Management operations depend on this setting. For example, if this device is
not managed by ZMS, no configuration synchronization processing is
performed on behalf of the device.
422
ZMS
Values true
zmsipaddress
The ZMS IP address for which configuration synchronization messages and
any other special handling is performed. This can be set either via CLI or
ZMS.
Location system
423
Parameters
424
INDEX
Numerics
B
basic control commands, description of 24
betaValue parameter 333
bootstate command 35
bridge command 36
bridge-path command 45
425
Index
426
ata 28
atmping 29
atmvclshow 30
basic control 24
bootstate 35
bridge 36
bridge-path 45
card change 48, 50, 51
ccshow 52
cd 56
changepass 56, 57
clkmgrshow 57
command completion 22
commit 56, 58
control commands 21
copy 59
create 59
crossconnect 60
datastorestats 65
del 66
delete 14, 18, 21, 26, 66
deleteuser 68
description 27
dir 70
ds1relay 70
ds1rpshow 71, 72
dslstat 74
dump 78
eeset 79
eeshow 70, 79
featurebitdisplay 82
featurebitset 82
fhrameping 83
file 84
filter 85
find 17, 87
find-matching-data 89
find-matching-subvoice 89
get 14, 96
gr303showcrv 99
help 100
help with 16
history 101
host 101
icmpstat 116, 120
ifstat 116
ifsum 117
ifxlate 105
image 106
imalink 107
imarpshow 109
imatppshow 111
inetstat 118
initiateconfigsync 59, 112
insert and change 25
interface 112
ip 116, 117, 118, 120, 121, 122
ipstat 118
linegroup 123
list 27, 124
load 126
log 127
logout 131
mcast 133
mkdir 133
movement and search 24
msg 133
mtac-linetest 134
new 18, 136
ping 137
pollzhonecpe 138
powermon 139
profiles and records 22
put and undo 26
pwd 139
resetcliprov 140
resetpass 141
restore 139, 141
rip 142
rmdir 144
romversion 144
route 145
sar8260 150
set 159
set2default 159, 165
setcliprov 159
setdatetime 160
setline 161
setprompt 161
shelfctrl 162
shelfreboot 164
shortcuts 21
show 165
showactivecards 166
showdatetime 166
showhostname 166
showinetstat 167
showline 168
showlinestatus 169
showmem 171
showredundancy 172
showresolver 173
showsonetrp 173
showuser 175
showzhonecpe 175
slotreboot 175
slots 177
snmp 179
sonetstatsshow 181
sonetstatusshow 183
stack 183
su 184
swact 185
swupgrade 185
swversion 185
syslog 186
systemreboot 189
systemrpshow 189
telnet 190
thermoshow 190
timeout 191
traceroute 191
udpstat 121
update 18, 20, 193
updateuser 194
upgrade 194
verbose-restore-off 198
verbose-restore-on 198
voice 199, 210, 211
voicestat 213
who 215
whoami 215
commit command 56, 58
Config sync, initiating 59, 112
configuration
specifying VPI for auto-created profiles 216
conventions
style and notation 7
typographical 7
copy command 59
create command 59
creating ip-interface profile, example of 18
crossconnect command 60
D
datastorestats command 65
del command 66
delete command 14, 18, 21, 26, 66
427
Index
deleteuser command 68
DHCP parameters 272
diagnostics
type of tests to run 154
diffDelayMax parameter 332
dir command 70
DNS parameters 285
documents, ordering additional 9
documents, related 9
DS1 parameters 288
ds1relay command 70
ds1rpshow command 71, 72
DS3 parameters 295
DSL parameters 301
dslstat command 74
dump command 78
E
eeset command 79
eeshow command 70, 79
ELCP parameters 307
Ethernet parameters 310
F
featurebitdisplay command 82
featurebitset command 82
fhrameping command 83
file command 84
filter command 85
find command 17, 87
finding a command 17
find-matching-data command 89
find-matching-subvoice command 89
FXS/FXO parameters 315
G
gammaValue parameter 333
get command 14, 96
Global Service and Support, See GSS
GR303 parameters 321
gr303showcrv command 99
groupSymmetry parameter 330
GSS, contacting 9
428
H
help command 100
help with commands
description 16
finding a command 17
help command 16
history command 101
host command 101
I
icmpstat command 116, 120
ifindex parameter 345
If-index parameters 329
ifstat command 116
ifsum command 117
ifTypes, list of 21
ifxlate command 105
IMA
alphaValue 333
betaValue 333
diffDelayMax 332
displaying group status 109
displaying test pattern procedure status 111
gammaValue 333
groupSymmetry 330
imaGroupDiffDelayMaxObs 332
imaGroupFeTxClkMode 331
imaGroupLeastDelayLink 332
imaGroupRxFrameLength 332
imaGroupTxTimingRefLink 331
minNumRxLinks 331
minNumTxLinks 330
parameters 330
testLinkIfindex 333
txClkMode 331
image command 106
imaGroupDiffDelayMaxObs 332
imaGroupFeTxTimingRefLink parameter 331
imaGroupLeastDelayLink parameter 332
imaGroupRxFrameLength parameter 332
imalink command 107
imarpshow command 109
imatppshow command 111
inetstat command 118
initiateconfigsync command 59, 112
insert and change commands 25
interface command 112
introduction to CLI 11
Inverse Multiplexing over ATM, See IMA
IP
statistics 167
ip commands 116, 117, 118, 120, 121, 122
IP parameters 335
ip-interface profile, creation 18
ip-interface-record, updating 20
ipstat command 118
ISDN parameters 343
L
line group
displaying 123
linegroup command 123
list command 124
load command 126
log command 127
logging
enabling/disabling for session 127, 186
enabling/disabling over the serial craft port
127, 186
logging into CLI 12
logical indexes, description of 13
logout command 131
M
mcast command 133
minNumRxLinks parameter 331
minNumTxLinks parameter 330
mkdir command 133
modifying records
delete command 18, 21
new command 18
update command 18, 20
movement and search commands 24
msg command 133
MTAC card
ifindex 345
parameters 345
test_mode 345
mtac-linetest command 134
N
network time protocol parameters 346
new command 18, 136
notes, description of 7
O
overview of the CLI 13
P
parameters
ADSL 225
alphabetical list 225
alphaValue 333
ATM 237
betaValue 333
bridging 255
card 259
CES 267
clocking 270
DHCP 272
diffDelayMax 332
displaying valid values 19
DNS 285
DS1 288
DS3 295
DSL 301
ELCP 307
Ethernet 310
FXS/FXO 315
gammaValue 333
GR303 321
If-index 329
IMA 330
imaGroupDiffDelayMaxObs 332
imaGroupLeastDelayLink 332
imaGroupRxFrameLength 332
IP 335
ISDN 343
MTAC card 345
network time protocol 346
PON 349
PPPoA 350
RIP 363
RS232 367
Sechtor 100A environmental 375
SHDSL 370
SNMP 376
SONET 378
subscriber 384
system 386
429
Index
testLinkIfindex 333
user 412
V5.2 389
VDSL 402
voice 403
ZMS 422
physical addresses, description of 13
ping command 137
pollzhonecpe command 138
PON parameters 349
powermon command 139
PPPoA parameters 350
profile addresses and indexes 15
profiles and records
addresses and indexes 15
commands 22
delete command 14, 21
get command 14
modifying 18
update command 20
viewing 16
put and undo commands 26
pwd command 139
R
record addresses and indexes
logical indexes 13
physical indexes 13
system indexes 13
types of records 13
records, modifying 18
resetcliprov command 140
resetpass command 141
restore command 139, 141
rip command 142
RIP parameters 363
rmdir command 144
romversion command 144
route command 145
RS232 parameters 367
S
sar8260 command 150
Sechtor 100A environmental parameters 375
serial number, displaying 79
set command 159
set2default command 159, 165
430
T
telnet command 190
temperature, displaying 162
terminology used in document 11
test_mode parameter 345
U
UBR
modem train rates and 252
udpstat command 121
update command 18, 20, 193
updateuser command 194
updating ip-interface-record, example of 20
upgrade command 194
user command 196
user parameters 412
users
updating accounts 194
V
V5.2 parameters 389
values
displaying valid 19
VDSL parameters 402
verbose-restore-off command 198
verbose-restore-on command 198
viewing profiles and records 16
voice command 199, 210, 211
voice parameters 403
voicestat command 213
W
warnings, description of 7
who command 215
whoami command 215
Z
ZMS
synchronizing with device 59, 112
ZMS parameters 422
431