Table Of Contents
cnfabr
cnfabrtparmdft
cnfaddrreg
cnfainihopcount
cnfalm
cnfapsln
cnfatmimagrp
cnfatmln
cnfautocnf
cnfbert
cnfcbclk
cnfcdmode
cnfcdstat
cnfcdvtdft
cnfcli
cnfclkparms
cnfclksrc
cnfcmdabbr
cnfcon
cnfconpref
cnfconsegep
cnfdate
cnfdiag
cnfdiagall
cnfe164justify
cnfenhiisp
cnfetherif
cnffltset
cnfilmi
cnfilmienable
cnfilmiproto
cnfimagrp
cnfimalnktst
cnfintfcongth
cnfintfvsvd
cnflink
cnfln
cnfloginmsg
cnfmbsdft
cnfname
cnfncdp
cnfncdpclksrc
cnfncdpport
cnfndparms
cnfnodalcongth
cnfnodalfd
cnfoamsegep
cnfpart
cnfpasswd
cnfpasswdreset
cnfabr
Configure ABR—PXM1E
In general, the cnfabr command configures the VS/VD-specific parameters for an existing ABR connection. The connection must be of service type ABR (in the addcon command, service type=10).
Note
In the current release, the PXM1E UNI/NNI back card does not support VS/VD. The only ABR parameters that the PXM1E supports are MCR and PCR.
Note
With ABR VS/VD, you can specify parameters but leave the VS/VD service disabled. You can later enable the service and thus activate the previously configured parameters. You can enable VS/VD at the PNNI port level by using the cnfintfvsvd command on the PXM45 or PXM1E.
Syntax
cnfabr <ifNum> <vpi <vci> -icr <Initial cell rate>] -adtf <ACR decr. factor>] -rdf <Rate decr. factor>] -rif <Rate incr. factor>] -nrm <Cells per fwd RM>] -trm <Time between fwd RMs>] -cdf <cutoff decrease factor>] -frtt <fix round trip delay>] -tbe <transient buffer exposure>] -intvsvd <internal vsvd config>] -extvsvd <external vsvd config>]
Syntax Description
ifNum
|
The port number of the connection.
|
vpi
|
The VPI range for a UNI port endpoint is 0-255. The VPI range for an NNI or VNNI port endpoint is 0-4095.
|
vci
|
The VCI range for a UNI port endpoint is 1-4095. The VCI range for a NNI port endpoint is 1-65535. For MPLS, the recommended minimum VCI is 35.
|
-icr
|
Initial Cell Rate (ICR) in cells per second. This is the rate at which the source should begin transmitting, and is also the rate at which the source should resume transmitting after an idle period. The range is 0-4294967295 cells per second.
|
-adtf
|
ACR Decrease Time Factor (ADTF). This is the time permitted to decrease the cell rate from the RM-cell rate to the Allowed Cell Rate (ACR) for normal traffic. The range is 1-1023 milliseconds.
|
-rdf
|
Rate Decrease Factor (RDF). This is the factor by which to decrease the Allowed Cell Rate (ACR). RDF is a power of 2 in the range 1/32768 to 1.
|
-rif
|
Rate Increase Factor (RIF). This is the factor by which to increase the Allowed Cell Rate (ACR). RIF is a power of 2 in the range 1/32768 to 1.
|
-nrm
|
Maximum number of cells that the source can send for each forward RM-cell. Nrm is a power of 2 in the range 2-256.
|
-trm
|
The maximum number of milliseconds for one RM-cell to travel from source to endpoint. The range is 100 x 2-7 to 100 x 20 milliseconds.
|
-cdf
|
Cutoff Decrease Factor (CDF). This controls the decrease in Allowed Cell Rate (ACR) associated with Missing RM-cell count (CRM). CDF can be either or the following:
• Zero
• A power of 2 in the range 1/64 to 1
CRM limits the number of forward RM-cells that may be sent in the absence of received backward RM-cells. CRM is an integer. Its size is implementation specific.
|
-frtt
|
Fixed Round-Trip Time (FRTT). This is the sum of the fixed delays plus the propagation delays from the source to the destination and back. The range is 0- 16.7 seconds.
|
-tbe
|
Transient Buffer Exposure (TBE). This is the negotiated number of cells that the network would like to limit the source to sending during startup periods, before the first RM-cell returns. The range is 0-16,777,215 cells.
|
-intvsvd
|
Enable or disable for VS/VD on the internal loop.
• 1=Off
• 2=On
• 3=Unspecified (Unspecified means that the connection takes the on or off status of VS/VD from the VS/VD specification in the SCT file.) See description of the cnfintfvsvd command to enable VS/VD at the PNNI port level.
Default: off
|
-extvsvd
|
Enable or disable for VS/VD on the external loop.
• 1=Off
• 2=On
• 3=Unspecified (Unspecified means that the connection takes the on or off status of VS/VD from the VS/VD specification in the SCT file.) See description of the cnfintfvsvd command to enable VS/VD at the PNNI port level.
Default: off
|
Related Commands
addcon, cnfabrtparmdft, dspabrtparmdft, cnfintfvsvd
Attributes
Log: yes
|
State: active
|
Privilege: GROUP1
|
cnfabrtparmdft
Configure ABR Traffic Parameter Defaults—PXM45, PXM1E
The cnfabrtparmdft command lets you configure default, ABR-specific parameters for all ABR SPVCs on a PNNI port. These parameters apply to SPVCs only.
Note
In the current release, the PXM1E does not support ABR VS/VD.
When you add an ABR connection, the controller provides the default ABR traffic parameters before the connection is committed. The default ABR traffic parameters are used in the SETUP message at the source when an SPVC with ABR service is set up. (Note also that you can change VS/VD-specific parameters for an individual ABR connection by using the cnfabr command on the AXSM-E.)
Syntax
cnfabrtparmdft <portid> [-rif RIF-value] [-rdf RDF-value] [-tbe TBE-value] [-nrm NRM-value] [-trm TRM-value] [-adtf ADTF-value] [-cdf CDF-value] [-fsd FSD-value]
Syntax Description
portid
|
The format of the PNNI physical port identifier can vary, as follows:
• On a PXM45: slot:subslot.port:subport
• On a PXM1E for UNI/NNI back card: slot:subslot.port:subport. On the UNI/NNI back card, the subslot is always 2, but the slot depends on the chassis, as follows:
– In an MGX 8850 chassis, slot is always the logical slot 7.
– In an MGX 8830 chassis, slot is always the logical slot 1.
• On a PXM1E for a narrowband service module (NBSM): slot.port.
For more details, see the section, "PNNI Format," in "Introduction."
|
-rif
|
Keyword that specifies the Rate Increase Factor (RIF). This is the factor by which to increase the Allowed Cell Rate (ACR). RIF is a power of 2 in the range 1/32768 to 1.
Default: 7
|
-rdf
|
Keyword that specifies the Rate Decrease Factor (RDF). This is the factor by which to decrease the Allowed Cell Rate (ACR). RDF is a power of 2 in the range 1/32768 to 1.
Default: 4
|
-tbe
|
Keyword that specifies the Transient Buffer Exposure (TBE). This is the negotiated number of cells that the network would like to limit the source to sending during startup periods, before the first RM-cell returns. The range is 0-16,777,215 cells.
Default: 1048320
|
-nrm
|
Keyword that specifies the maximum number of cells that the source can send for each forward RM-cell. Nrm is a power of 2 in the range 2-256.
Default: 5
|
-trm
|
Keyword that specifies the maximum number of milliseconds for one RM-cell to travel from source to endpoint. The range is 100 x 2-7 to 100 x 20 milliseconds.
Default: 8
|
-adtf
|
Keyword that specifies the ACR Decrease Time Factor (ADTF). This is the time permitted to decrease the cell rate from the RM-cell rate to the Allowed Cell Rate (ACR) for normal traffic. The range is 1 to 1023 milliseconds.
Default: 50
|
-cdf
|
Keyword that specifies the Cutoff Decrease Factor (CDF). This controls the decrease in Allowed Cell Rate (ACR) associated with Missing RM-cell count (CRM). CDF can be either or the following:
• Zero
• A power of 2 in the range 1/64 to 1
CRM limits the number of forward RM-cells that may be sent in the absence of received backward RM-cells. CRM is an integer. Its size is implementation-specific.
Default: 7
|
-fsd
|
Keyword that specifies the Fixed-source-delay.
Default: 0
|
Related Commands
addcon, cnfabr, dspabrtparmdft, cnfintfvsvd
Attributes
Log: no
|
State: active
|
Privilege: GROUP1
|
cnfaddrreg
Configure Address Registration—PXM45, PXM1E
This command lets you enable or disable ILMI address registration for a port. Before you can run cnfaddrreg, the following must have occurred:
1.
The applicable port must have been created by executing addpnport.
2.
The port must be downed by executing dnpnport.
The cnfaddrreg command can also enable (or disable) the address registration for backward compatibility.
The peer must support address registration table and procedure, so you must confirm that address registration is enabled on all three places.
Syntax
cnfaddrreg <portid> [{yes | no}]
Syntax Description
In addition to typing a port ID, you must also type either "yes" pr "no."
portid
|
The format of the PNNI physical port identifier can vary, as follows:
• On a PXM45: slot:subslot.port:subport
• On a PXM1E for UNI/NNI back card: slot:subslot.port:subport. On the UNI/NNI back card, the subslot is always 2, but the slot depends on the chassis, as follows:
– In an MGX 8850 chassis, slot is always the logical slot 7.
– In an MGX 8830 chassis, slot is always the logical slot 1.
• On a PXM1E for a narrowband service module (NBSM): slot.port.
For more details, see the section, "PNNI Format," in "Introduction."
|
yes
|
Enable ILMI address registration on the port. The default is "yes" (enabled).
|
no
|
Disable ILMI address registration on the port.
|
Related Commands
None
Attributes
Log: yes
|
State: active
|
Privilege: GROUP1
|
Example
Disable ILMI address registration on port 4:1.1:11.
Geneva.7.PXM45.a > cnfaddrreg 4:1.1:11 no
cnfainihopcount
Configure AINI Hop Count—PXM45, PXM1E
The cnfainihopcount command lets you determine the maximum number of AINI links that a call can traverse. The specification applies to any call originating on the local node, and the area to which the setting applies is the entire network. With cnfainihopcount, you can:
•
Enable or disable the counter. This counter generates the Hop Counter Information Element (IE).
•
Specify the maximum number of AINI hops. The hop counter (IE) is initialized to this value in the setup message. With each AINI link that the setup message traverses, the counter is decremented. This hop count applies to only AINI interfaces (see also the description of cnfpnportsig.)
Note
To enable AINI hop count, you must also enable it at each port that should have it by using the cnfpnportsig command and typing "enable" for the -hopcntgen parameter.
Syntax
cnfainihopcount [-hopcntgen {enable | disable}] [-maxhops <value>]
Syntax Description
-hopcntgen
|
The enable for counting AINI hops. Type the entire word "enable" or "disable." Enabling hop count generation initializes the counter to the value for maxhops.
Default: enable
|
-maxhops
|
The maximum number of AINI hops that a connection can take. The range is 1-31.
Default: 31
|
Related Commands
dspainihopcount
Attributes
Log: yes
|
State: active, standby
|
Privilege: SUPER_GP
|
Example
Enable AINI hop counting and specify a maximum of 20 hops. No response appears unless an error occurs, so follow up by displaying the configuration.
8850_NY.8.PXM.a > cnfainihopcount -hopcntgen enable -maxhops 20
8850_NY.8.PXM.a > dspainihopcount
AINI Hop Counter Generation: enable
cnfalm
Configure Alarm—PXM45, PXM1E
Configures statistical alarm thresholds for a line. The configurable items for SONET and PLCP are defined in RFC 2258. The configurable items for DS3 and E3 are defined in RFC 2496. The items that constitute a configuration are:
•
Line type: SONET, DS3, E3, or PLCP
•
Tested layer: section, line, or path (for example, SONET line)
•
Test periods of 15 minutes and 24 hours
•
Degrees of error-time: errored seconds and severely errored seconds
•
Types of errors, including framing errors, code violations, and unavailable
•
Severity of alarm triggered when a threshold is crossed: minor or major
A keyword identifies the alarm criteria. Each keyword identifies the tested layer (line, and so on), the type of threshold (errored seconds, and so on), and the test period of 15 minutes or 24 hours. For example, -lnes15 indicates the number of errored seconds on the line layer during any 15 minute period. See the Syntax Description for a list and definitions of all keywords.
Note
For information about the cnfalm command on the AXSM cards, see the AXSM documentation.
Syntax
Due to the variety of line types and formats for line identifiers, the information is presented as generic syntax information and details for specific line types.
The required parameters are as follows:
•
Line type
•
Line identifier
•
Severity of the alarm (minor or major).
Other parameters are optional and must be preceded by the keyword that identifies the type of parameter.
Generic Syntax Description
The generic syntax is.
cnfalm <line type> <X.line> <alarm severity> <thresholds>
The meaning of the generic syntax appears in the following list. Refer to subsequent lists for the descriptions of alarm severities and thresholds for each line type.
lineType
|
The possible line types depend on what X.line identifies, as follows:
• For X = 2, possible line types for PXM1E back card are as follows:
-sonetsec - Displays the section alarms for the given sonet line.
-sonetline - Displays the line alarms for the given sonet line.
-sonetpath -Displays the path alarms for the given sonet line.
-ds3 - Displays the statistical alarms for the given DS3 line.
-plcp - Displays alarms for Physical Layer Convergence Procedure (PLCP).
• For X = 7, 15, or 31, possible line types for SRMs are as follows:
-sonetsec - Displays the section alarms for the given SONET line.
-sonetline - Displays the line alarms for the given SONET line.
-sonetpath -Displays the path alarms for the given SONET line.
-ds3 - Displays the statistical alarms for the given DS3 line.
|
X.line
|
The X field identifies either of the following:
• The UNI/NNI back card in bay 2 of the PXM1E
• The logical slot of the SRM under the control of a PXM1E
The value for X can be one of the following:
• X=2 identifies the UNI/NNI back card attached to a PXM1E.
• X=15 or 31 in an MGX 8850 chassis identifies the logical slot number of the active SRM (regardless of physical slot number).
• X=7 in an MGX 8830 chassis identifies the logical slot number of the active SRM (regardless of physical slot number).
The values for line depends on the type of card. Possible values are as follows:
• SRME: 1
• SRM-3T3: 1-3
• PXM1E back card: 1-16 (whatever is the highest line number on the card)
|
alarm severity
|
A keyword and number to identify the severity of the alarm that is triggered when any of the specified thresholds is crossed: 1 = minor alarm, and 2 = major alarm. Precede the alarm severity with the appropriate keyword. For the alarm severity keyword for each line type, see the first item in each of the lists follows. (For example, -secsev refers to the severity of the section alarm on a SONET line.)
|
thresholds
|
The number of instances of whatever the keyword identifies. The range for each threshold is 1 to 2^32-1. The keyword precedes each threshold. For example, -lnsesf15 10 means 10 instances of severely errored framing seconds on a line during a 15-minute period.
|
Thresholds for SONET Section
-secsev Severity
|
Severity of the alarm (1 = minor, 2 = major) for SONET section.
|
-seces15 ES15min
|
Errored seconds during a 15-minute period.
|
-seces24 ES24Hr
|
Errored seconds during a 24-hour period.
|
-secses15 SES15min
|
Severely errored seconds during a 15-minute period.
|
-secses24 SES24Hr
|
Severely errored seconds during a 24-hour period.
|
-secsefs15 SEFS15min
|
Severely errored frame seconds during a 15-minute period.
|
-secsefs24 SEFS24Hr
|
Severely errored frame seconds during a 24-hour period.
|
-seccv15 UAS15min
|
Unavailable seconds during a 15-minute period.
|
-seccv24 UAS24Hr
|
Unavailable seconds during a 24-hour period.
|
Thresholds for SONET Line
-lnsev Severity
|
Severity of the alarm (1 = minor, 2 = major) for SONET line.
|
-lnes15 ES15min
|
Errored seconds during a 15-minute period.
|
-lnes24 ES24Hr
|
Errored seconds during a 24-hour period.
|
-lnses15 SES15min
|
Severely errored seconds during a 15-minute period.
|
-lnses24 SES24Hr
|
Severely errored seconds during a 24-hour period.
|
-lncv15 CV15min
|
Code violations during a 15-minute period.
|
-lncv24 CV24Hr
|
Code violations seconds during a 24-hour period.
|
-lnuas15 UAS15min
|
Unavailable seconds during a 15-minute period.
|
-lnuas24 UAS24Hr
|
Unavailable seconds during a 24-hour period.
|
Thresholds for SONET Path
-sev
|
Severity of the alarm (1 = minor, 2 = major) for SONET path.
|
-es15 ES15min
|
Errored seconds during a 15-minute period.
|
-es24 ES24Hr
|
Errored seconds during a 24-hour period.
|
-ses15 SES15min
|
Severely errored seconds during a 15-minute period.
|
-ses24 SES24Hr
|
Severely errored seconds during a 24-hour period.
|
-cv15 CV15min
|
Code violations during a 15-minute period.
|
-cv24 CV24Hr
|
Code violations seconds during a 24-hour period.
|
-uas15 UAS15min
|
Unavailable seconds during a 15-minute period.
|
-uas24 UAS24Hr
|
Unavailable seconds during a 24-hour period.
|
Thresholds for DS3
-dsev severity
|
Severity of the alarm (1 = minor, 2 = major) for DS3.
|
-lcv15 LCV15min
|
Code violations for a line during a 15-minute period.
|
-lcv24 LCV24Hr
|
Code violations for a line seconds during a 24-hour period.
|
-les15 LES15min
|
Line errored seconds during a 15-minute period.
|
-les24 LES24Hr
|
Line errored seconds during a 24-hour period.
|
-pcv15 PCV15min
|
P-bit coding violations for a line during a 15-minute period.
|
-pcv24 PCV24Hr
|
P-bit coding violations for a line during a 24-hour period.
|
-pes15 PES15min
|
P-bit errored seconds during a 15-minute period.
|
-pes24 PES24Hr
|
P-bit errored seconds during a 24-hour period.
|
-pses15 PSES15min
|
P-bit severely errored seconds during a 15-minute period.
|
-pses24 PSES24Hr
|
P-bit severely errored seconds during a 24-hour period.
|
-sefs15 SEFS15min
|
Severely errored frame seconds during a 15-minute period.
|
-sefs24 SEFS24Hr
|
Severely errored frame seconds during a 24-hour period.
|
-uas15 UAS15min
|
Unavailable seconds during a 15-minute period.
|
-uas24 UAS24Hr
|
Unavailable seconds during a 24-hour period.
|
Thresholds for E3
-dsev severity
|
Severity of the alarm (1 = minor, 2 = major) for DS3.
|
-lcv15 LCV15min
|
Code violations for a line during a 15-minute period.
|
-lcv24 LCV24Hr
|
Code violations for a line seconds during a 24-hour period.
|
-les15 LES15min
|
Line errored seconds during a 15-minute period.
|
-les24 LES24Hr
|
Line errored seconds during a 24-hour period.
|
-sefs15 SEFS15min
|
Severely errored frame seconds during a 15-minute period.
|
-efs24 SEFS24Hr
|
Severely errored frame seconds during a 24-hour period.
|
-duas15 UAS15min
|
Unavailable seconds during a 15-minute period.
|
-duast24 UAS24Hr
|
Unavailable seconds during a 24-hour period.
|
Thresholds for PLCP
-psev severity
|
Severity of the alarm (1 = minor, 2 = major) for PLCP.
|
-bcv15 CV15min
|
Bipolar violation code violations during a 15-minute period.
|
-bcv24 CV24Hr
|
Bipolar violation code violations during a 24-hour period.
|
-bes15 ES15min
|
Bipolar violation errored seconds during a 15-minute period.
|
-bes24 ES24Hr
|
Bipolar violation errored seconds during a 24-hour period.
|
-bses15 SES15min
|
Bipolar violation severely errored seconds during a 15-minute period.
|
-bses24 SES24Hr
|
Bipolar violation severely errored seconds during a 24-hour period.
|
-psefs15 SEFS15min
|
PLCP severely errored frame seconds during a 15-minute period.
|
-psefs24 SEFS24Hr
|
PLCP severely errored frame seconds during a 24-hour period.
|
-puas15 UAS15min
|
PLCP unavailable seconds during a 15-minute period.
|
-puas24 UAS24Hr
|
PLCP unavailable seconds during a 24-hour period.
|
Related Commands
dspalmcnf
Attributes
Log: yes
|
State: active
|
Privilege: GROUP1
|
Example
Configure the following thresholds for triggering a major line-level alarm on line 9 in bay 2:
•
The line type is SONET line.
•
The bay is 2, and the line number is 9.
•
The severity of the triggered alarm is major.
•
The errored seconds for a 15-minutes period and a 24-hour period are 60 and 600, respectively.
•
The severely errored seconds for a 15-minutes period and a 24-hour period are 3 and 7, respectively.
•
The code violations for a 15-minutes period and a 24-hour period are 75 and 750, respectively.
•
The unavailable seconds for a 15-minutes period and a 24-hour period are 10 and 10, respectively
node4.7.PXM1E.a > cnfalm -sonetline 2.9 -lnsev 2 -lnes15 60 -lnes24 600 -lnses15 3
-lnses24 7 -lncv15 75 -lncv24 750 -lnuas15 10 -lnuas24 10
Check the configuration by running dspalmcnf for the line number and line type in this example.
node4.7.PXM1E.a > dspalmcnf -sonetline 2.9
Line Stat Alarm Severity: No Alarm
15min Threshold 24hr Threshold
cnfapsln
Configure APS Line—PXM1E
Configures the APS parameters for a line (working line). Use the cnfapsln command after you add the line. See the description for the addapsln command for a detailed explanation of adding Automatic Protection Switching (APS).
Syntax
Note
1+1 Annex B operational mode is bi-directional, non-revertive, ITU protocol only.
Note
On an AXSM, if the ArchMode configured by the addapsln command is 1+1 Annex B, only WTR (-wtr), SF BER (-sf), and SD BER (-sd) are configurable with the cnfapsln command.
cnfapsln -w <working line> -sf <SignalFaultBER> -sd <SignalDegradeBER> -wtr <Wait To Restore> -dr <direction> -rv <revertive> -proto <protocol>
Syntax Description
workingLine
|
Slot number, bay number, and line number of the active line to configure, in the format:
slot.bay.line
Example: -w 1.1.1
|
SignalFaultBER
|
A number between 3 and 5 indicating the Signal Fault Bit Error Rate (BER), in negative powers of ten:
• 3 = 10-3
• 4 = 10-4
• 5 = 10-5
Example: -sf 3
|
SignalDegradeBER
|
A negative power of 10 in the range 5-9 that indicates the Signal Degrade Bit Error Rate (BER):
• 5 = 10-5
• 6 = 10-6
• 7 = 10-7
• 8 = 10-8
• 9 = 10-9
Example: -sd 5
|
Wait To Restore
|
The number of minutes to wait after the working line has become functional again, before switching back to the working line from the protection line. The range is 5-12.
Example: -wtr 5
|
direction
|
Specifies the direction: 1: unidirectional, 2: bidirectional
Example: -dr 2
Bidirectional means that both the receiving and transmitting paths are switched. Unidirectional means that only the affected path, receiving or transmitting, is switched.
|
revertive
|
Enables revertive behavior. 1: non-revertive, 2: revertive
Example: -rv 1
|
-proto
|
You can specify either Bellcore or ITU protocol by following -proto with either a "1" or a "2" to signify the following standard:
• 1: Bellcore
• 2: ITU
|
Related Commands
addapsln, delapsln, dspapsln, dspapslns, switchapsln, dspapsbkplane, dspbecnt
Attributes
Log: yes
|
State: active
|
Privilege: SUPER_GP
|
Example
cnfapsln -w 1.1.1 -sf 3 -sd 5 -wtr 5 -dr 2 -rv 1
cnfatmimagrp
Configure ATM IMA Group—PXM1E
The cnfatmimagrp command lets you enable or disable payload scrambling for an IMA group. The default is enabled.
Syntax
cnfatmimagrp -grp <group> -sps <PayloadScramble>
Syntax Description
-grp group
|
The group has the format bay.group and the following possible values:
• bay: always 2 on the PXM1E
• group: 1-16
|
-sps
|
Enable of disable payload scrambling. Enter a 1 or a 2.
• 1 = enable
• 2 = disable
Default: enabled
|
Related Commands
dspatmimagrp
Attributes
Log: yes
|
State: active
|
Privilege: GROUP1
|
Example
Disable payload scrambling in IMA group 2.
PXM1E.7.PXM.a > cnfatmimagrp 2.2
cnfatmln
Configure ATM Line—PXM1E
The cnfatmln command lets you configure the ATM layer cell header for a line.
You must configure the ATM layer cell header for a line before you activate the line using upln or before you add a logical port to the line using addport.
Syntax
cnfatmln -ln <bay.line> -sps <PayloadScramble> -nch <cellhdr> -ncp <NullCell payload>
-hcs <hcs>
Syntax Description
-ln
|
This parameter specifies the bay and line number. The format for this value slightly differs on the PXM1E and AXSMs.
• On the PXM1E, the format X.line applies to an SRM or the UNI/NNI back card.
– For the UNI/NNI back card, X is always 2.
– For an SRM in an MGX 8850 chassis, X can be 15 or 31.
– For an SRM in an MGX 8830 chassis, X is always 7.
• On any AXSM model, the format is bay.line. On an AXSM, bay is 1 or 2.
In all cases, line can be from 1 to the highest numbered line on the back card.
|
-hcs
|
Specifies the number to disable (1) or enable (2) HCS coset. The default is enabled.
|
-sps
|
Specifies the number that enables (1) or disables (2) payload scrambling. The default value for PayloadScramble is enabled. The setting must be the same at both ends of the line and throughout the path.
|
-nch
|
Specifies the four-byte hexadecimal number to serve as the null cell header (cellhdr). The range for cellhdr is all 0s through ffffffff.
|
-ncp
|
Specifies a 8-bit hexadecimal byte to serve as the null cell header. The range for cellpayload is 1-ff. The default is 6a.
|
Related Commands
dspatmln
Attributes
Log: yes
|
State: active
|
Privilege: GROUP1
|
Example
For line 1 disable payload scrambling and specify a null cell header.
MGX8850.7.PXM1E.a > cnfatmln -ln 2.1 -sps 2 -nch ab12abab
For line 1, enable payload scrambling and specify null cell headers.
MGX8850.1.PXM1E.a > cnfatmln -ln 2.1 -sps 1 -nch 1a1a1a1a -ncp aa
For line 1, disable payload scrambling and specify a null cell header.
MGX8850.1.9.PXM1E.a > cnfatmln -ln 2.1 -sps 2 -nch ab12abab
cnfautocnf
Configure Auto Configuration—PXM45, PXM1E
The cnfautocnf command enables or disables ILMI auto configuration for a port. To use this command, the port must be added but administratively down (via dnpnnport).
With auto-configuration enabled, the ILMI slave side starts ILMI auto configuration to negotiate the ATM layer parameters with its peer while ports come up. With auto-configuration disabled, the ILMI slave does not start ATM layer parameter-negotiation while ports come up. Instead, the ILMI slave uses the local configuration parameters. The default state for auto-configuration is enabled.
Syntax
cnfautocnf <portid> [yes | no]
Syntax Description
portid
|
The format of the PNNI physical port identifier can vary, as follows:
• On a PXM45: slot:subslot.port:subport
• On a PXM1E for UNI/NNI back card: slot:subslot.port:subport. On the UNI/NNI back card, the subslot is always 2, but the slot depends on the chassis, as follows:
– In an MGX 8850 chassis, slot is always the logical slot 7.
– In an MGX 8830 chassis, slot is always the logical slot 1.
• On a PXM1E for a narrowband service module (NBSM): slot.port.
For more details, see the section, "PNNI Format," in "Introduction."
|
yes | no
|
Enable of disable ILMI automatic configuration on the port by typing "yes" or "no."
Default: yes
|
Attributes
Log: yes
|
State: active
|
Privilege: GROUP1
|
Examples
Enable ILMI auto-configuration on port 7:2.1:11.
Geneva.7.PXM1E.a > cnfautocnf 7:2.1:1 yes
cnfbert
Configure Bit Error Rate Testing—PXM45, PXM1E
The cnfbert command lets you configure, start, or stop a bit error rate test (BERT) on a legacy service module. This BERT requires a Service Resource Module (SRM-3T3/C or SRME). The SRME does not support all patterns or all loopbacks on all service module lines, so use the dspbertcap command to see the capability for a specific service module.
Note
The current release does not support DDS patterns, nor does it support BERT on a PXM45.
One BERT session at a time can run in a bay. If you attempt to configure a session while one is running, the controller blocks the second test.
Note
Configure error bit injection with a second iteration of the cnfbert command—after you complete the initial BERT or loopback configuration.
Syntax
cnfbert -cbif <LSMNum> -pat <bertPattern> -lpbk <loopback> -sbe <singleBitErr>
-cir <dropIteration> -en <enable>
Syntax Description
The mandatory parameters are -cbif <LSMNum> -pat <bertPattern> -lpbk <loopback> -en <enable>. Also, you can terminate the BERT session by either using the delbert command or using the cnfbert mandatory parameters and specifying the enable as -en 6.
-cbif
|
This parameter identifies the line or port to receive BERT or a loopback. The format is:
LSMslot.Line.Port
• LSMslot has one of the following ranges: 1-6, 9-14, 17-22, or 25-30
• Line as a range of 1 through the maximum number of lines on the service module.
• Port has a range of 1 through the maximum number of ports on the service module or 0 to select no port and have only a line test.
|
-pat
|
Type a number in the range 1-32 to select a pattern (see also dspbertcap):
1 = all-zeros: All 0s (Continuous spaces).
2 = all-ones: All 1s (Continuous Marks).
3 = alt-One-Zero: Alternate 1/0 pattern (..1010..).
4 = doubleAltOnesZeros: Double alternate 1/0 (..1100..).
5 = oneIn4: Standard loop up remote code.
6 = oneIn8: An eight-bit pattern which contains single 1.
7 = oneIn16: N repetitive pattern, 1 in 16.
8 = threeIn24: A 24-bit pattern that contains three 1s.
9 = inbandLoopup: D4/SF Loopback activate.
10 = inbandLoopdown: D4/SF Loopback deactivate.
11 = twoE3MinusOne: This is a 23-1 pattern (7 bits in length).
12 = twoE4MinusOne: This is a 24-1 pattern (15 bits in length).
13 = twoE5MinusOne: This is a 25-1 pattern (31 bits in length).
14 = twoE6MinusOne: This is a 26-1 pattern (63 bits in length).
15 = twoE7MinusOne: This is a 27-1 pattern (127 bits in length).
16 = twoE7MinusOneFT1Loopup: 27-1 Fractional T1 Loop Back Activate.
18 = twoE9MinusOne: 29-1 (511 bits in length). It has the maximum of 8 (non-inverted) sequential 0s and 9 sequential 1s.
19 = twoE10MinusOne: 210-1 (1023 bits in length).
20 = twoE11MinusOne: 211-1 (2047 bits). Maximum of 15 (inverted) sequential 0s.
21 = twoE15MinusOne: 215-1 (32767 bits long). Max. of 15 (inverted) sequential 0s.
22 = twoE17MinusOne: 217-1 (131071 bits in length).
23 = twoE18MinusOne: 2 18-1 (262144 bits in length).
24 = twoE20MinusOne: 220-1 (1048575 bits long). Max. 19 (non-inverted), sequential 0s.
25 = twoE20MinusOneQRSS: 220-1 (1048575 bits). This pattern has zero-suppression (Quasi-random Signal Source).
26 = twoE21MinusOne: 221-1 (2097151-bit length).
27 = twoE22MinusOne: 222-1 (4194303-bit length).
28 = twoE23MinusOne: 223-1 (8388607-bit length). Highest stress, pseudo-random pattern, with a maximum of 23 (inverted) sequential 0s and 23 sequential 1s.
29 = twoE25MinusOne: 221-1 (33554431 bits long).
30 = twoE28MinusOne: 228-1 (268435455 bits long).
31 = twoE29MinusOne: Highest stress pseudo-random pattern, with a maximum of 29 (inverted) sequential 0s.
32 = twoE31MinusOne: Maximum 31 sequential 0s.
|
-lpbk
|
Type a number to select a loopback (use dspbertcap as needed for supported loopbacks):
|
-sbe
|
The single-bit error insertion should be selected after initial configuration with the cnfbert command. Enter one of the following numbers:
• 1: No error
• 2: Insert a single-bit error
|
-cir
|
The drop iteration applies only if the loopback is 5:latchDS0Drop.
Range for drop iteration is: 1-32
|
-en
|
To start or stop a BERT session, type one of the following:
• 4: Create (start) BERT
• 6: Destroy (stop) BERT
You can start a BERT session when you configure all the parameters. To stop a session, you need to enter only cnfbert -cbif <LSMNum> and the string -en 6.
|
Related Commands
dspbert, delbert, dspbertcap
Attributes
Log: yes
|
State: active
|
Privilege: GROUP1
|
Example
Configure a BERT session, as follows (after using the dspbertcap command, as needed), then display the test after about a half hour by using the dspbert command:
•
Card: FRSM
•
Slot: 25 (lower bay, so an SRM must reside in the lower bay)
•
Line: 1
•
Pattern: all zeroes
•
Loopback: local
•
Enable: (start the test)
JANUS1.7.PXM.a > dspbertcap 25.1 1
1: allZeros, 2: allOnes, 3: altOneZero,
4: doubleAltOnesZeros 6: oneIn8, 8: threeIn24,
18: twoE9MinusOne, 20: twoE11MinusOne 21: twoE15MinusOne,
24: twoE20MinusOne, 25: twoE20MinusOneQRSS 28: twoE23MinusOne
Device to loop options supported:
---------------------------------
FarEnd Loopback: All listed patterns supported
12: lineInband, 13: lineLoopbackESF
18: smartJackInband -Supported only on SRME
Local Loopback: All listed patterns supported
No Loopback: All listed patterns supported
Use cnfbert and delbert cli to configure and delete bert
JANUS1.7.PXM.a > cnfbert -cbif 25.1.0 -pat 1 -lpbk 14 -en 4
JANUS1.7.PXM.a > dspbert 1
Current Date : 05/07/2002
Physical Slot Number : 25
Line Number : 1 (Line test)
Device To Loop : Local Loopback
BERT Pattern : All Zeroes Pattern
Bit Count Received : 3107466159
BERT is in sync.
cnfcbclk
Configure Cellbus Clock—PXM45, PXM1E
The cnfcbclk command lets you specify whether a Cellbus runs at the default of 21 MHz or the double-speed rate of 42 MHz. Not every Cellbus (and the card slots it supports) can receive the double-speed clock, so use the dspcbclk to see whether a particular Cellbus can run at 42 MHz. The application of dspcbclk and cnfcbclk is the clocking for the Route Processor Module (RPM). The RPM runs much more efficiently at 42 Mhz.
The backplane has 8 Cellbuses: 6 Cellbuses support 2 card slots and can support 21 MHz or 42 MHz clocking. Two of the Cellbuses (CB4 and CB8) support 6 cards slots and can receive only the 21 MHz clock. See the dspcbclk output in the Example section.
Note
If you use the cnfndparms command to enable automatic setting of the Cellbus clock rate, the switch blocks you from setting it with the cnfcbclk command.
Syntax
cnfcbclk <cellBus> <clockRate>
Syntax Description
cellBus
|
Specifies the Cellbus. Enter a string in the range CB1-CB8. The string is not case-sensitive.
|
clockRate
|
Specifies a clock rate of 21 MHz or 42 MHz. Enter either "21" or "42."
|
Related Commands
dspcbclk
Attributes
Log: yes
|
State: active
|
Privilege: SUPER_GP
|
Example
To determine which slots can run at a higher rate, display the current Cellbus clock configuration. The display shows that all Cellbuses currently have the default speed of 21 Mhz.
pop20two.8.PXM.a > dspcbclk
CellBus Rate (MHz) Slots Allowable Rates (MHz)
----------------------------------------------------------
Configure a double-speed clock for Cellbus 5, then check the configuration.
pop20two.8.PXM.a > cnfcbclk cb5 42
pop20two.8.PXM.a > dspcbclk
CellBus Rate (MHz) Slots Allowable Rates (MHz)
----------------------------------------------------------
CB8 21 25 - 30 21
cnfcdmode
Configure Card Mode—PXM1E
The cnfcdmode command lets you specify the mode of the lower-speed lines on the PXM1E UNI/NNI back card. (It does not apply to the OC3c/SDH or higher speed lines.)
Note
Use this command only before the applicable card is provisioned.
On the combination back card (FRU-8T3E3-4OC3), you can specify whether all lower-bandwidth lines operate as one of the following:
•
T3
•
E3
On the T1/E1 back card (RBBN-16-T1E1), you can specify whether all lower-bandwidth lines operate as one of the following:
•
T1 (the default)
•
E1
Note
To see the back card type, use the dspcd or dspcds command. To see the current line type, use the dsplns command.
Syntax
cnfcdmode <mode>
Syntax Description
mode
|
The mode is a number in the range 1-4.
• 1 for T1
• 2 for E1
• 3 for T3 (PXM-1E only)
• 4 for E3 (PXM-1E only)
|
Related Commands
dsplns, dspcd, dspcds
Attributes
Log: yes
|
State: active, standby
|
Privilege: GROUP1
|
cnfcdstat
Configure Card Statistics—PXM1E
The cnfcdstat command lets you configure the TFTP bucket statistics for the entire UNI/NNI back card. Parts of the configuration control the bucket interval and the collection interval. These parameters affect the generation of the files that contain statistics and that are transferred to the Cisco WAN Manager (CWM) via FTP.
The card statistics level (stats level) cannot be set if a configuration exists on the lines, such as logical ports. You must set the stats level before you can add any logical ports. However, you can set the bucket interval and the collection interval after you have added logical ports.
Enabling statistics effects performance. Statistical counters use up bandwidth, which reduces the amount of bandwidth available for connections. The PXM1E provides statistical alarms to help control the amount of bandwidth used for statistics.
Statistical alarms are different than integrated alarms. An integrated alarm indicates a persistent traffic loss at either the local end, such as the LOS and LOF alarms, or at the remote end, such as the RDI alarm.
A statistical alarm indicates that a statistical counter has exceeded the threshold for alarm indication. For instance, the Severely Errored Seconds (SES) counter might exceed the corresponding 15-minute threshold. For this condition, a statistical alarm is raised, which indicates a degraded performance that is not due to persistent traffic loss.
Statistical alarms are based on fixed statistics collection intervals. There are two types of fixed statistics collection intervals:
•
15-minute
•
24-hour
The start of an interval is aligned to the time of day. For instance, 11:15, 11:30, 11:45, etc. At the end of the interval, the corresponding statistical alarms are cleared. An alarm is raised again if a counter exceeds the threshold during the new interval.
Types of Card Statistics
The types of card statistics that are reported, and at which levels, are shown in the following tables.
Table 2-7 Statistics Port To Backplane Ingress Per Connection
Statistic
|
Level 2
|
Level 3
|
All Cells from the port (before policer)
|
yes
|
yes
|
CLP0 cells from port (before policer)
|
yes
|
yes
|
CLP1 cells from port (before policer)
|
yes
|
yes
|
CLP0 non compliant cells
|
yes
|
yes
|
CLP1 non compliant cells
|
yes
|
yes
|
Total non compliant cells
|
yes
|
yes
|
VC queue depth (scheduled conns only)
|
yes
|
yes
|
VS/VD ACR (scheduled conns only)
|
yes
|
yes
|
EFCI=1 cells from the port
|
yes
|
yes
|
EOF=1 cells from the port
|
yes
|
yes
|
Rm cells from the port (RM cells after the policer stats level3, RM cells queued for stats level2)
|
yes
|
yes
|
OAM cells from port
|
no
|
yes
|
All cells to the backplane
|
yes
|
yes
|
CLP0 cells to the backplane
|
yes
|
yes
|
CLP1 cells to the backplane
|
yes
|
yes
|
EFCI=1 cells to the backplane
|
yes
|
yes
|
Rm cells to the backplane
|
no
|
yes
|
OAM cells to the backplane
|
no
|
yes
|
All cells discarded due to queue overflow
|
yes
|
yes
|
CLP0 cells discarded due to queue overflow
|
yes
|
yes
|
CLP1 cells discarded due to queue overflow
|
yes
|
yes
|
EOF=1 cells discarded due to queue overflow
|
yes
|
yes
|
EFCI=1 cells discarded due to queue overflow
|
yes
|
yes
|
RM cells discarded due to queue overflow
|
no
|
yes
|
OAM cells discarded due to queue overflow
|
no
|
yes
|
Table 2-8 Statistics Backplane To Port Egress Per Connection
Statistic
|
Level 2
|
Level 3
|
All cells to the port
|
yes
|
yes
|
CLP0 Cells to Port
|
yes
|
yes
|
CLP1 Cells to Port
|
yes
|
yes
|
VC queue depth (scheduled conns only)
|
yes
|
yes
|
VS/VD ACR (scheduled conns only)
|
yes
|
yes
|
EFCI=1 cells to the port
|
yes
|
yes
|
EOF=1 cells to the port
|
yes
|
yes
|
Rm cells to the port
|
yes
|
yes
|
OAM cells to the port
|
no
|
yes
|
All cells from the bus
|
yes
|
yes
|
CLP0 cells from the bus
|
yes
|
yes
|
CLP1 cells from the bus
|
yes
|
yes
|
EFCI=1 cells from the bus
|
yes
|
yes
|
Rm cells from the bus
|
no
|
yes
|
OAM cells from the bus
|
no
|
yes
|
All cells discarded due to queue overflow
|
yes
|
yes
|
CLP0 cells discarded due to queue overflow
|
yes
|
yes
|
CLP1 cells discarded due to queue overflow
|
yes
|
yes
|
EOF=1 cells discarded due to queue overflow
|
no
|
no
|
EFCI=1 cells discarded due to queue overflow
|
yes
|
yes
|
RM cells discarded due to queue overflow
|
no
|
yes
|
OAM cells discarded due to queue overflow
|
no
|
yes
|
Syntax
cnfcdstat -i <bucket interval> -ci <collection interval> -sl <stats level> -ed <1 | 2>
Syntax Description
-i
|
For the bucket interval, type the whole word "five," "ten," and so on to select the number of minutes to wait before starting the next bucket.
• five: 5 minutes
• ten:10 minutes
• fifteen: 15 minutes
• twenty: 20 minutes
• thirty: 30 minutes
• sixty: 60 minutes
|
-ci
|
For the collection interval, type the entire word "one" or "five."
• one: 1 minute
• five: 5 minutes
Default: 0
|
-sl
|
For card stats level, type a "1," "2," or "3."
|
enable/disable
|
Type the entire word "enable" or "disable."
Default: disable
|
Related Commands
dspcdstatcnf
Attributes
Log: yes
|
State: active
|
Privilege: GROUP1
|
Example
PXM1E_SJ.7.PXM.a > cnfcdstat -i ten -ci one -sl 1 -ed enable
cnfcdvtdft
Configure Cell Delay Variation Tolerance Default—PXM45, PXM1E
For all connections of a particular service type on a PNNI logical port, cnfcdvtdft configures the default number of microseconds for the cell delay variation tolerance (CDVT). The direction is ingress. The new configuration applies to new incoming calls but not existing calls. You can execute cnfcdvtdft whether the port is in the provisioning state (prior to addport on the service module) or administratively up.
Syntax
cnfcdvtdft <portid> <service_category> [microseconds]
Syntax Description
portid
|
The format of the PNNI physical port identifier can vary, as follows:
• On a PXM45: slot:subslot.port:subport
• On a PXM1E for UNI/NNI back card: slot:subslot.port:subport. On the UNI/NNI back card, the subslot is always 2, but the slot depends on the chassis, as follows:
– In an MGX 8850 chassis, slot is always the logical slot 7.
– In an MGX 8830 chassis, slot is always the logical slot 1.
• On a PXM1E for a narrowband service module (NBSM): slot.port.
For more details, see the section, "PNNI Format," in "Introduction."
|
service_category
|
Service type: cbr, rtvbr, nrtvbr, ubr, or abr.
|
micro seconds
|
The number of microseconds for CDVT.
Range: 0-2147483647
Default: 250,000
|
Related Commands
dspcdvtdft
Attributes
Log: yes
|
State: active
|
Privilege: GROUP1
|
Examples
Specify a CDVT of 125000 microseconds for ABR connections on port 4:1.1:11. Check the results by executing dspcdvtdft for the port.
Geneva.7.PXM.a > cnfcdvtdft 4:1.1:11 abr 125000
Geneva.7.PXM.a > dspcdvtdft 4:1.1:11
cbr: rt-vbr: nrt-vbr: ubr: abr:
CDVT: 250000 250000 250000 250000 125000
Geneva.7.PXM.a >
cnfcli
Configure CLI—PXM45. PXM1E
The cnfcli command is the CLI portion of a feature that lets you modify the user privilege (or access) level of one or more commands. The other portions of the feature involve text file creation on a workstation and transferring that file to the switch. For a significant number of commands, you cannot modify the privilege. A list of these commands appears in the section, "Restrictions."
The cnfcli command converts an ASCII text file containing privilege changes to a binary file and applies it to the commands whose privilege you have changed. The ASCII file is created on a workstation by using "vi" or any other text editor. Subsequently, you FTP the file to a TEMP directory on the node.
On the active PXM, the cnfcli command can do one of the following tasks according to the parameters:
•
It can convert the ASCII file to a binary file then install the new access levels on that PXM.
•
It can cause all changed privilege levels to revert to the default privilege levels.
•
It can uninstall modified privileges from all slots in the switch.
Note
Although the cnfcli command runs on the AXSM, it does so for debugging purposes only. Therefore, only its operation on the PXM is documented.
Feature Details
The following list describes details for this feature.
•
The feature supports one ASCII file per switch. This file contains commands for the whole node and all card types and any changed privileges. Use FTP to copy this file to the switch.
•
When you modify a command privilege, commands of the same name across all card types receive the same access level.
•
For all standby cards redundant pairs, the privilege changes apply.
•
The binary file is protected by an authentication signature generated from the binary file through a 64-bit key DES authentication encryption algorithm.
•
The installed changes are persistent. The binary file is saved on the active PXM hard disk and replicated on the standby hard disk during installation.
•
If you cause privileges to revert to the original, default privileges, this change is not persistent.
•
If you add a PXM or service module after modifying command privileges, the installed card automatically takes the privileges from the binary file on disk when the card comes up.
•
For privilege changes to become effective when a card comes up, the binary modification file must reside on disk. If the file does not exist on the disk or the computed authentication signature does not match that of the file when you run cnfcli, the switch uses the default command access levels.
•
The dspcli command shows privilege changes for commands on the card where you run dspcli. For example, using the dspcli command on a PXM shows only the affected commands that are available on the PXM. To see affected commands on an AXSM, use dspcli on that AXSM.
•
The following commands are also relevant to this feature:
–
The saveallcnf command saves the binary file.
–
The restoreallcnf command restores the saved binary file.
–
The clrallcnf command deletes the binary file.
Restrictions
This section lists the restrictions on the use of the cnfcli command.
•
You cannot change a command's privilege level to CISCO_GP.
•
Only the switch software can generate the binary file. Any manual changes invalidate the file.
•
If the binary file becomes corrupt, the command access levels revert back to the defaults during card bring-up. To recover, repeat the installation process.
•
The switch verifies command names in the ASCII file against the unchangeable commands listed in this section, but an invalid command name you enter in the ASCII file could be parsed and added to the binary file. The switch would ignore this invalid name.
•
If replication to the hard drive on the standby PXM fails, the whole installation process fails.
The following list shows the commands whose privilege you cannot change.
?
|
clrdisk
|
cnfuser
|
dbgswover
|
dsplmilink
|
loadrev
|
abortoffline- diag
|
clrlmitrace
|
commitrev
|
dbxclierrcode
|
dsplmitrace
|
logout
|
abortrev
|
clrlncnt
|
copychans
|
delallcon
|
dspmempart
|
memShow
|
addtrapmgr
|
clrsmcnf
|
copycons
|
delallusers
|
dspmsgq
|
offdiagcstat
|
adduser
|
clrsmcnf
|
core
|
delcons
|
dspmsgqs
|
offdiagstat
|
bootChange
|
cnfatlasln- diagstat
|
dbgaddilmi- addr
|
delsigdiag
|
dspportdbgcnf
|
ondiagcstat
|
burnboot
|
cnfcli
|
dbgcon
|
deltrapmgr
|
dspportdbgcnt
|
ondiagstat
|
bye
|
cnfcmdabbr
|
dbgdelilmi- addr
|
deluser
|
dspsem
|
resetcsrsem
|
cc
|
cnfcosbdbg
|
dbgfailspvc
|
diagdebug
|
dspsems
|
resetevtlogsem
|
ccc
|
cnfdiag
|
dbgfa
|
downloadflash
|
dspsnmp
|
restoreallcnf
|
clidbxlevel
|
cnfdiagall
|
dbgifm
|
dspatlasdiag- cnfcstat
|
dsptask
|
runrev
|
clrallcnf
|
cnflmitrace
|
dbgilmi
|
dspatlasdiag- statcnf
|
dsptasks
|
saveallcnf
|
clrbucketcstat
|
cnfpasswd
|
dbgpncli
|
dspchandbgcnf
|
dspudpdiag- cstat
|
setipconn- debug
|
clrchandbgcnt
|
cnfportdbg
|
dbgpnni
|
dspchandbgcnt
|
dspudpdiag- stat
|
setrev
|
clrcnf
|
cnfpswdreset
|
dbgpnsnmp
|
dspcosbdbg
|
exit
|
verifydiskdb
|
clrcosbdbgcnt
|
cnfsigdiag
|
dbgredman
|
dspcosbdbgcnf
|
help
|
|
clrdiagerr
|
cnfsnmp
|
dbgsig
|
dspcosbdbgcnt
|
lkAddr
|
|
clrdiagstat
|
cnftrapip
|
dbgsscop
|
dspdiagcnf
|
lkup
|
|
ASCII File Format
You can use any text editor to create the ASCII file. The format is one command followed by the group access level name on a line, as the following indicates:
<command name><space(s)><group access level name><carriage return>
<command name><space(s)><group access level name><carriage return>
...
<command name><space(s)><group access level name><carriage return>
The requirements and characteristics of the ASCII file are as follows:
•
A line must be less than 80 characters long. otherwise that command is ignored.
•
The access level for a command in the list of unchangeable commands does not change.
•
Command names and group access level names are case sensitive.
•
The valid access level names are SERVICE_GP, SUPER_GP, GROUP1, and ANYUSER. Commands with invalid group names are rejected.
•
Lines that contain a pound (#) character are processed as comments and are ignored.
•
The number of comments configured is logged.
•
The maximum number of commands in a file is 1000.
Activating This Feature
The steps for using this feature are as follows:
1.
Create an ASCII text file on a workstation.
2.
FTP the ASCII file (filename.txt) to the node to a temporary directory (for example, C:/TMP).
3.
On the CLI of the active PXM, enter the following:
cnfcli accesslevel install C:/TMP/filename.txt
The following events occur:
•
The system parses and converts file filename.txt to binary file F:/CLI/CNF/clicnf.bin, for example. (The location and name of the binary file is subject to change.)
•
The binary file is replicated on the standby PXM, if it exists. If no standby PXM initially exists in the switch, the file is synchronized from the active PXM when a new standby is installed.
•
The command access level changes go into effect on the active PXM.
•
The command access level changes go into effect on the standby PXM.
•
The command access level changes go into effect on the active and standby service modules.
4.
Verify that the installation process was successful by doing the following:
•
The binary file exists on the active PXM disk and is replicated on the standby PXM disk.
•
Display the changes on each slot by entering the following at the CLI prompt:
cnfcli accesslevel display
•
The event log shows the number of command access levels changed for a slot.
File Locations
The binary file resides in a directory named F:/CLI/CNF/ after the installation finishes. If you do not create a binary file through the cnfcli command, no file resides in this directory.
Errors and Failure Conditions
This section lists possible errors, failures, and solutions.
•
If a card is unable to read the file from the disk while the card comes up, it uses the default access levels. Use the sequence cnfcli accesslevel install on the PXM to recover.
•
If a file has a command name that is not recognized by the run-time image, the command is ignored, and the installation continues.
•
If a service module does not respond back to the active PXM within a certain amount of time during the installation, the PXM logs it as a failure or time-out. In the latter case, use the sequence dspcli accesslevel to check the installation outcome and cnfcli accesslevel install to recover.
•
An event of minor severity is logged if installation fails during card bring-up.
•
CLI is a low-priority application. Thus, during the installation process initiated by the active PXM, some service modules may fail the installation. An example is when the standby PXM is coming up, where much of the CPU is used for synchronization between the active and standby PXMs.
•
If the binary file becomes corrupt, the command access levels revert back to the defaults during card bring-up. To recover, repeat the installation process.
Syntax
With a single iteration of the cnfcli command, you can either install the file with modified privilege levels or direct the switch to revert to the default privilege levels. The possible sequences of this command and its parameters are as follows:
cnfcli <accesslevel> <install> [full path file name]
cnfcli <accesslevel> <default>
Syntax Description
accesslevel
|
The string "accesslevel" is a subcommand,
|
install
|
The keyword install is followed by the full path to the ASCII file.
|
uninstall
|
To uninstall the ASCII file, type the keyword uninstall.
|
full path file name
|
The full path file name follows the keyword.
|
default
|
The string "default" is a keyword that causes the system to revert to the default access levels. Do not enter default with the install keyword or the path name.
|
Related Commands
ftp, dspcli
Attributes
Log: yes
|
State: active
|
Privilege: CISCO_GP
|
Example
This example consists of the following tasks:
1.
Create an ASCII file named "clicnf.txt" with the privilege changes shown in the example, below. Note that some commands have associated garbage characters or no privilege, and some commands cannot take a change of privilege. The system flags these problems during cnfcli operation.
2.
FTP the file to C:/TMP on the switch.
3.
Apply the changed privileges by using the cnfcli command.
4.
On the PXM, use the dspcli command to see the commands with modified privileges.
5.
On the AXSM, use the dspcli command to see the commands with modified privileges.
6.
Return to the PXM CLI and uninstall the modified privileges.
7.
Go to the AXSM and run dspcli accesslevel.
cnfsct SERVICE_GP adfjafkd
cnfsvcoverride SERVICE_GP
***************************
FTP the file to C:/TMP, for example, then use that whole path name with the cnfcli command.
jeff.8.PXM.a > cnfcli accesslevel install C:/TMP/clicnf.txt
Reading input file C:/TMP/clicnf.txt...
Total of 35 lines in file:
- 5 commands found not allowed
- 6 commands with invalid access level name
Converting input file to binary file...done
Writing binary file to disk...done
Updating command access levels for this slot...done
Send request to slot 7 to install...done
Send request to slot 2 to install...done
Send request to slot 6 to install...done
Send request to slot 9 to install...done
Send request to slot 10 to install...done
jeff.8.PXM.a > dspcli accesslevel
Command Name Current Default
-----------------------------------------------------------
addapsln SERVICE_GP GROUP1
addlnloop SERVICE_GP GROUP1
arpFlush SERVICE_GP SUPER_GP
arpShow SERVICE_GP ANYUSER
cnfserialif SERVICE_GP SUPER_GP
cnfsntprmtsvr SERVICE_GP GROUP1
cnfspvcprfx SERVICE_GP SUPER_GP
cnfsscop SERVICE_GP GROUP1
cnfsvcoverride SERVICE_GP SUPER_GP
cnftmzn SERVICE_GP SUPER_GP
12 command access levels changed.
jeff.2.AXSM.a > dspcli accesslevel
Command Name Current Default
-----------------------------------------------------------
addapsln SERVICE_GP GROUP1
addlnloop SERVICE_GP GROUP1
addpart SERVICE_GP GROUP1
addport SERVICE_GP GROUP1
addrscprtn SERVICE_GP GROUP1
arpFlush SERVICE_GP SUPER_GP
arpShow SERVICE_GP ANYUSER
10 command access levels changed.
jeff.8.PXM.a > cnfcli accesslevel uninstall
Uninstall command access levels for this slot...done
Send request to slot 7 to uninstall...done
Send request to slot 2 to uninstall...done
Send request to slot 6 to uninstall...done
Send request to slot 9 to uninstall...done
Send request to slot 10 to uninstall...done
jeff.2.AXSM.a > dspcli accesslevel
Command Name Current Default
-----------------------------------------------------------
0 command access levels changed.
cnfclkparms
Configure Clock Parameters—PXM45, PXM1E
The cnfclkparms command lets you configure the signal type and cable type for E1 BITS sources. The configuration applies to both (upper and lower) lines. This command applies to manual clock distribution but not Network Clock Distribution Protocol (NCDP—see cnfncdp description).
Note
In the current release, you can specify only the cable type.
Syntax
cnfclkparms <signal type> <cable type>
Syntax Description
signal type
|
Specifies whether the signal type for the clock is data or a synchronization signal. Enter a 1 for data or a 2 for synchronization.
Note In the current release, the synchronization type is not supported.
|
cable type
|
Specifies whether the cable is a twisted pair or a coaxial cable. Enter a 1 for twisted pair or 2 for coaxial.
Default: 1 (twisted pair)
|
Related Commands
None
Attributes
Log: no
|
State: active
|
Privilege: ANYUSER
|
Example
Set the cable type to coaxial then check it.
Unknown.8.PXM.a > cnfclkparms 1 2
Unknown.8.PXM.a > dspclkparms
BITS Signal Type: Data Mode
cnfclksrc
Configure Clock Source—PXM45, PXM1E
The cnfclksrc command lets you configure a primary or secondary clock source for the node. This command supports the manual clock distribution mode—where the mechanism for propagating a primary clock throughout the network must be configured at each switch. To enable the automatic clock distribution provided by the Network Clock Distribution Protocol (NCDP), use the cnfncdp command.
A clock source can be:
•
An external device that connects to the PXM-UI S3 card
•
An NNI port on the PXM1E UNI/NNI back card
•
An NNI port on an active service module
Clock Operation
When a switch first powers up, the internal oscillator on the PXM provides the clock to the node. Thereafter, you can configure the clock sources at each node according to a well-designed plan for network synchronization.
A typical configuration for a network starts with a Building Integrated Timing System (BITS) clock source of stratum 3 or higher on one of the switches. Therefore, the node with the BITS clock becomes the master clock source for the network. The active clock drives the clock line on the backplane, and each service module takes its clock from this line. Thereafter, the clock goes out through every line to other switches in the network. At the other switches, you can configure one of the lines to be the primary or secondary clock source for that switch.
(For a description of line-level looped timing, refer to the cnfln description. With looped timing, a clock arrives on a line and is redirected to become the transmit clock for only that line.)
Prerequisites to Clock Configuration
Whether it uses BITS or an NNI line for a clock source, the node first must have a network controller. See the addcontroller description. For an NNI-sourced clock, the additional prerequisites are:
•
Activating the applicable line through upln
•
Creating logical ports through addport
•
Creating resource partitions through addrscprtn
Database Updates and Clock Configuration
If the node has a redundant PXM, it automatically receives changes you make to the clock configuration as well as automated clock changes that occur under node management. For example, if you delete a clock source (delclksrc), the standby card automatically implements this configuration change. Also, any switch from primary to secondary source is recorded by the standby PXM.
Syntax
The syntax for cnfclksrc depends on the clock source.
For the external BITS clock:
cnfclksrc <priority> <portid>
portid has the format [shelf.]slot.port -bits e1 | t1 [-revertive <enable | disable>]
For AXSM-sourced clock (note the positions of the periods and colons):
cnfclksrc <priority> <portid>
portid has the format [shelf.]slot:subslot.port:subport or slot.port on a PXM1E
Syntax Description
priority
|
The priority of the clock source is either primary or secondary. The default is primary.
|
portid for BITS
|
• shelf is always 1 and is purely optional.
• slot is the logical slot number 7 for a BITS circuit on the PXM UI S3 (regardless of where the active PXM resides).
• port is a logical number that indicates the upper or lower external clock connector on the UI S3 back card. The logical port number for the upper connector is 35. The lower connector is 36.
• bits This keyword is required once you specify slot number 7 (or 1 in an MGX 8830 chassis) and a port number of 35 or 36 because you have identified a BITS clock source. Type the string "-bits" followed by a space then either "e1" or "t1." See "Usage Guidelines" for details.
• revertive—an option that applies to only the BITS clock. Type the string "-revertive" followed by the complete word "enable" or "disable." The default is disable. See "Usage Guidelines for cnfclksrc" for important details.
|
portid on service module or PXM1E UNI or NNI
|
• shelf is always 1 and is purely optional.
• slot is the slot number of the service module or active PXM1E (if an NNI port on the back card is used).
• subslot identifies the upper or lower bay of the back card—either a 1 for the upper bay or 2 for the lower bay (default is 1).
• port is the line number on the AXSM or PXM1E UNI/NNI back card. (The specified line must already be active (see upln).
• subport is the logical port number. This value is the logical port (or ifNum) that you must have assigned through addport. Also, the logical port must be known to PNNI (see dsppnports). The ranges depend on the card and model, as follows:
• PXM1E: 1-31
• AXSM: 1-60
• AXSM-E: 1-32
• For other service modules, see individual card descriptions
|
Usage Guidelines for cnfclksrc
The following sections contain relevant information for cnfclksrc and details about its parameters.
Specifying Primary and Secondary Clock Sources
Before using the cnfclksrc command, note the following:
•
The controller must have been specified by using addcontoller.
•
Line-sourced clocks require that the lines, ports, and resource partitioning have been configured.
•
A switch can have one primary source and one secondary source.
•
For each execution of cnfclksrc, you can specify only one clock source (either but not both primary and secondary). Therefore, you must repeat cnfclksrc to specify the other clock source.
•
If you do not specify a secondary source, the internal oscillator serves as the secondary source.
•
For clock sources on the PXM1E UNI/NNI back card or AXSM, Cisco recommends that primary and secondary sources be on separate cards or at least on separate lines. (On the PXM1E, separate cards are not possible, but separate lines are possible.)
•
Revertive mode applies to only a primary BITS clock. For more details on the revertive option, see the section, "Configuring a BITS Clock."
•
The switch constantly monitors the state of the clocks. For information on clock alarms, see the dspclkalms description.
Changing the Priority of a Clock Source
To change the priority of a clock source, the command sequence depends on the priority of the sources:
•
To change the priority of a clock from primary to secondary or secondary to primary, you must first execute delclksrc to de-configure each source.
To change from one primary source to another primary source, you need to execute only cnfclksrc To change the priority of a clock source, the command sequence depends on the priority of the sources:
•
To change the priority of a clock from primary to secondary or secondary to primary, you must first use the delclksrc command to de-configure each source.
•
To change from one primary source to another primary source, you need to execute only cnfclksrc for the new primary source—the system automatically de-configures the existing primary source.
Responses to Clock Failures
If the current clock is the primary or secondary source and that source fails, the clock circuitry goes into holdover mode. Holdover is a standards-based response to a failed clock. In holdover, the UI-S3 card maintains the clock based on the clock signal's parameters as recorded in hardware. Even for a stratum 1 source, the UI-S3 card maintains the frequency and stability of the failed clock source for up to 24 hours. If the source does not return to use in 24 hours, the node switches to the internal oscillator.
Configuring a BITS Clock
You can configure a node to obtain its primary and secondary clocks from a BITS device connected to the PXM-UI S3. The PXM-UI S3 can support stratum levels 1-3 and has two connectors to receive these highly stable clocks from an external device. If the primary and secondary clocks are externally-sourced, they must be the same rate. For example, you cannot specify a T1 for primary and an E1 for secondary.
Note
Whenever the internal oscillator becomes the primary or secondary source due to a failure, a minor alarm is triggered on the local node.
You can enable a revertive mode for the primary BITS clock. The revertive function on the PXM applies when the primary clock source fails. A failure is a loss of the primary clock source after the node has locked to that clock source. If a primary clock recovers from a failure and revertive mode is enabled, the node automatically reverts to the primary source. The restored primary clock must be available for 12 seconds before it again becomes the active clock source.
If the primary clock source fails and revertive mode is disabled, you must re-configure the primary source after the failure has been corrected.
To change the mode from revertive to non-revertive, use cnfclksrc. Follow the portID and priority with "-revertive disable."
Note
For an E1 BITS clock, the current product is automatically limited to two parameters of an E1 line that is used as a BITS source: twisted pair cabling and date-type signaling.
Related Commands
dspclksrcs, delclksrc, dspclkalms, cnfclkparms
Attributes
Log: yes
|
State: active
|
Privilege: GROUP1
|
Examples
Configure the E1 clock at the upper connector of the PXM-UI S3 as the primary source. Configure subport (logical port) 10 on the line of the AXSM-1-2488 in slot 3 as the secondary. For the secondary source on the AXSM, note the locations of the periods and colons. Upon successful execution, the system displays a confirmation message.
pinnacle.7.PXM.a> cnfclksrc primary 7.35 -bits e1
Clock Manager has been successfully executed.
pinnacle.7.PXM.a> cnfclksrc secondary 3:1.1:10
Clock Manager has been successfully executed.
Configure a primary network clock to revert to the highest priority E1 clock source after recuperation from a failure. Upon successful execution, the system displays a confirmation message.
pinnacle.7.PXM.a> cnfclksrc primary 7.36 -bits e1 -revertive enable
Clock Manager has been successfully executed.
cnfcmdabbr
Configure Command Abbreviation—PXM45, PXM1E
The cnfcmdabbr command lets you specify whether the CLI requires the entire name of a command or accepts the first unique string of characters that identifies a command. For example, "loa" is enough to identify loadrev if command abbreviation is enabled. (The string "lo" is not enough to identify a particular command because of the logout command.)
Syntax
cnfcmdabbr <flag>
Syntax Description
flag
|
A Boolean expression to enable or disable command abbreviation: enter "on" to enable or "off" to disable command abbreviation.
|
Related Commands
dspcmdabbr
Attributes
Log: yes
|
State: active
|
Privilege: SERVICE_GP
|
Example
Enable command abbreviation, then check its status by executing dspcmdabbr.
excel.1.3.PXM.a > cnfcmdabbr on
Command Abbreviation feature being enabled
pop20one.7.PXM.a > dspcmdabbr
Command Abbreviation feature currently enabled
Test the functionality of command abbreviation by entering "loa" (for loadrev) without parameters.
ERR: Syntax: loadrev <slot> <revision>
revision - revision number. E.g.,
cnfcon
Configure Connection—PXM1E
The cnfcon command lets you modify the bandwidth, policing, and routing parameters of an existing endpoint. On the PXM1E, this command applies to only an SPVC or an SPVP with an endpoint that exists on the UNI/NNI back card.The command parameters consist of:
•
A logical port, VPI, and VCI to identify the connection
•
Bandwidth parameters for the local (master) end then the remote (slave) end
•
Policing parameters for the connection as a whole
After you specify the mandatory connection identifier, all other parameters are optional.
Usage Guidelines for the cnfcon Command
The following sections discuss the application of certain cnfcon parameters.
Note
On DAX connections, using cnfcon at the slave end has no effect. For DAX connections, use cnfcon at the master end only, and the parameters will take effect on the controller as well.
Traffic Parameters
Traffic parameters such as PCR, SCR, MBS are entered at both the master and slave endpoints for both the forward and reverse directions. Be sure that the value entered as "local" on one end is equal to the value entered as "remote" on the other end. For example, the lpcr on the slave endpoint should be same as the rpcr on the master endpoint and vice versa when you provision the connection at the other end. If you modify traffic parameters after creating an SPVC, you just modify them at either the master endpoint or the slave endpoint.
Traffic parameters such as CDV, CTD are entered at both the master and slave endpoints for both the forward and reverse directions. However, the values of these parameters entered at the slave end are ignored during call setup. Therefore, you can specify the lcdv, rcdv, lctd and rctd options at the master end only.
Routing Parameters
Routing parameter, such as maximum route cost (-mc maxcost) or the routing priority (-rtngprio routingPriority) need to be entered at the master endpoint only. The values of the parameters entered at the slave end are ignored during call setup.
You can assign a priority at the master end of an SPVC or SPVP. The PNNI controller routes higher priority connections before lower priority connections. The user-configurable range for a connection is, in descending order of priority, 1-15. The default is 8. See cnfpri-routing for a detailed description of the Priority Routing feature. Also, the cnfpri-routing command lets you configure groups of bandwidth so that the order of routing also reflects the bandwidth requirements of the connection.
If you use the cnfcon command to modify only the routing priority of a connection, PNNI does not immediately re-route the connection. Nevertheless, if you run dspcon for such a changed connection at the master endpoint, it immediately shows the changed priority even before PNNI re-routes the connection. You can also use the dsppncon command to see the priority of the SVC portion that is associated with master and slave endpoints. Note that the dsppncon command shows the new priority only after PNNI re-routes the connection.
Frame Discard
The current release supports two types of frame discard for VCCs carrying AAL5 cells. These frame discard mechanisms are policing-based and congestion-based. Policing-based discard depends on the -frame option in the addcon or cnfcon command (specified only at the master end). Congestion-based policing for all cell streams is governed by settings in the current port SCT. The two types of frame discard are independent of each other and may or may not coexist.
When policing-based frame discard is enabled, the policer discards all cells of an AAL5 frame that follow a non-compliant cell. Specific actions for PCR and SCR non-compliance are detailed in the section, "Policer Settings and Consequences."
When congestion based frame discard is enabled by the current port-level SCT, if the arriving cells exceed an EPD threshold, the whole frame is discarded.
The table below shows the action applied to a connection according to the frame discard setting. The following information clarifies the table contents:
•
Frame-based policing is represented by the letter "A." This policing is specified by the -frame option in the addcon or cnfcon command.
–
A value of 0 for "A" means frame-based policing is disabled. It also implies that regular, cell-based policing will be in effect.
–
A value of 1 means frame-based policing is enabled.
•
Frame-based congestion management is represented by the letter "B." This congestion management is specified by the port SCT in use. (To see the SCT thresholds and SCT ID for a port, use the dspportsct command.)
–
A value of 0 for "B" means that the CLP Lo/Hi thresholds take effect during congestion and that discards would occur on a cell-by-cell basis.
–
A value of 1 implies that the EPD0/1 thresholds would take effect during congestion and that discards would occur on an AAL5 frame-basis.
Frame Discard Setting
|
Policer Behavior (frame discard in addcon)
|
Congestion Thresholds (SCT setting)
|
A = 0, B = 0
|
Cell-based policing
|
CLP lo/hi thresholds
|
A = 0, B = 1
|
Cell-based policing
|
EPD thresholds
|
A = 1, B = 0
|
Frame-based policing
|
CLP lo/hi thresholds
|
A = 1, B = 1
|
Frame-based policing
|
EPD thresholds
|
Restrictions
Frame discard applies to connections that use ATM AAL5 adaptation (ITU-T I.363.5). Although enabling frame discard on an AAL5 cell stream is not mandatory, it helps improve the useful throughput on a VC by discarding complete frames during times of congestion on the switch. Without frame discard enabled on an AA5 cell stream, corrupted AAL5 frames (containing dropped cells) can reach upper layers and trigger numerous re-sends. Conversely, enabling frame discard on other (non-AAL5) types of cell streams can bring uncertain results. In a worst case, total discard of end-to-end traffic of a non-AAL5 stream can occur in either direction.
The hardware does not support frame-based discard on VPCs. Only VCCs support frame-based discard.
Note
An important caveat exists for VPCs that were added with frame discard enabled prior to version 3.0.23 (the release where the two types of frame discard became available). The switch lets you enable frame discard on a VPC even though hardware does not support it. If such a VPC (with frame discard enabled) already exists on the node when you upgrade to 3.0.23, 4.0.10, or later, you cannot subsequently modify the VPC unless you delete it then re-add it with frame discard disabled. To avoid the need to delete a VPC, you must disable frame discard on any such VPCs before upgrading to 3.0.23 or later releases.
Policer Settings and Consequences
This section describes two types of conformance tests that occur when you enable frame discard through this frame discard parameter. The tests are PCR and SCR conformance tests.
The PCR conformance test is performed using GCRA1 in exactly the same manner as normal cell policing. For this test, the Action should be set to discard. If the PCR conformance test is deemed to be non-compliant, the action will be to discard of the cells in the current frame. In other words, a "partial packet action" can be taken when cells in the current frame fail this conformance test. The PCR conformance test implements a partial packet discard (PPD). The policer does a complete frame discard if the first cell of the packet was discarded as a result of PCR failure
The SCR conformance test is performed using GCRA2, although it differs slightly from the normal cell policing.The SCR conformance test is performed only at the start of a frame. If the first cell of a frame is a conforming CLP=0 cell, then all remaining cells will be as if they are conforming to the SCR conformance test. The SCR conformance test can be programmed to tag non-conforming CLP=0 cells. If the first cell of a frame is a non-conforming CLP=0, then that cell and all other cells in that frame (including the EOM) will be tagged. In other words, the tagged action taken by this conformance test is determined at frame boundaries only. If the SCR conformance test is programmed to discard, the policer can discard at any point in the frame and is not restricted by frame boundaries.
Local-Only Parameters
The parameters CDVT, stats enable, cc enable (specified using -cdvt, -stat, -cc) are significant only at the endpoint where you enter them. Therefore, they can be different at each end of the connection.
Syntax
cnfcon <ifNum> <vpi> <vci>
[-lpcr <local to remote PCR>] [-rpcr <remote to local PCR>] [-lscr <local to remote SCR>] [-rscr <remote to local SCR>] [-lmbs <local to remote MBS>] [-rmbs <remote to local MBS>] [-lcdv <local to remote maxCDV>] [-rcdv <remote to local maxCDV>] [-lctd <local to remote maxCTD>] [-rctd <remote to local maxCTD>] [-lmcr <local to remote MCR>] [-rmcr <remote to local MCR>] [-cdvt <local CDVT>] [-cc <OAM CC Cnfg>] [-stat <Stats Cnfg>] [-frame <frame discard>] [-mc <Max Cost>] [-segep <OAM segment endpoint>]
[-lputil <local -> remote PUtil>] [-rputil <remote -> local PUtil>] [-rtngprio <routingPriority>]
Syntax Description
Note
Although the help data shows that this command has a parameter for OAM continuity check (OAM CC), the PXM1E does not support this parameter.
ifNum
|
The logical interface (or port) number. This ifNum corresponds to the ifNum added through the addport command. The range is 1-31.
Note When you add an endpoint on an NNI, make sure that PNNI signaling is disabled on the PXM (cnfpnportsig <portid> -nniver none).
|
vpi
|
Virtual path identifier value in the range 0-255 (UNI) or 0-4095 (NNI or VNNI). For VNNI, specify one VPI per port.
|
vci
|
Virtual connection identifier (VCI):
• For a VCC on a UNI, the range is 1-4095. On an NNI or VNNI, the VCI range is 1-65535. For MPLS, the recommended minimum VCI is 35.
• For a VPC, the vci is 0.
|
service type
|
Type a number in the range 1-12 to specify one of the following service types:
• 1=CBR1 (Constant Bit Rate 1)
• 2=VBR1RT (Variable Bit Rate 1, Real Time)
• 3=VBR2RT (Variable Bit Rate 2, Real Time)
• 4=VBR3RT (Variable Bit Rate 3, Real Time)
• 5=VBR1NRT (Variable Bit Rate 1, Non-Real Time)
• 6=VBR2NRT (Variable Bit Rate 2, Non-Real Time)
• 7=VBR3NRT (Variable Bit Rate 3, Non-Real Time)
• 8=UBR1 (Unspecified Bit Rate 1)
• 9=UBR2 (Unspecified Bit Rate 2)
• 10=ABRSTD (Standard ABR—see cnfabr) PXM1E does not support VS/VD
• 11=CBR2 (Constant Bit Rate 2)
• 12=CBR3 (Constant Bit Rate 3)
|
mastership
|
Value to specify the endpoint as master or slave:
• 1 or `m' specifies the master end.
• 2 or `s' specifies the slave end.
|
-slave
|
Keyword for the slave-end identifier, an item you enter at the master end. This keyword is mandatory when you are adding a master endpoint (mastership=m or 1).
|
-lpcr
|
Local peak cell rate (PCR). Specifies the PCR from a local endpoint to a remote endpoint (3-5651328 cells per second). PCR is the maximum cell rate for the connection at any time.
|
-rpcr
|
Remote peak cell rate (PCR). Specifies the PCR from a remote endpoint to a local endpoint (3-5651328 cells per second). PCR is the maximum cell rate for the connection at any time.
|
-lscr
|
Local sustained cell rate (SCR). Specifies the SCR from a local endpoint to a remote endpoint (3-5651328 cells per second). SCR is the maximum cell rate that a connection can sustain for long periods.
|
-rscr
|
Remote sustained cell rate (SCR). Specifies the SCR from a remote endpoint to a local endpoint (3-5651328 cells per second). SCR is the maximum cell rate that a connection can sustain for long periods.
|
-lmbs
|
Local maximum burst size (MBS). Specifies the MBS from a local endpoint to a remote endpoint (1-5000000 cells). MBS is the maximum number of cells that can burst at the PCR and still be compliant.
|
-rmbs
|
Remote maximum burst size (MBS). Specifies the MBS from a remote endpoint to a local endpoint (1-5000000 cells). MBS is the maximum number of cells that can burst at the PCR and still be compliant.
|
-cdvt
|
Local cell delay variation tolerance (CDVT). Specifies the CDVT from a local endpoint to a remote endpoint (1-5000000 microseconds). Cell Delay Variation Tolerance controls the time scale over which the PCR is policed.
Note that no remote CDVT is necessary.
|
-lcdv
|
The local cell delay variation (CDV) parameter specifies the peak to peak CDV from the local endpoint to the remote endpoint. The range is 1-16777215 microseconds.
To revert to the default value for this parameter, type "-1."
|
-rcdv
|
The remote cell delay variation (CDV) parameter specifies the peak to peak CDV from the remote endpoint to the local endpoint. The range is 1-16777215 microseconds.
To revert to the default value for this parameter, type "-1."
|
-lctd
|
Local cell transfer delay (CTD). This parameter specifies the CTD from a local endpoint to a remote endpoint. The range is 0-65535 microseconds.
To revert to the default value for this parameter, type "-1."
|
-rctd
|
Remote cell transfer delay (CTD). This parameter specifies the CTD from the remote endpoint to the local endpoint. The range is 0-65535 microseconds.
To revert to the default value for this parameter, type "-1."
|
-cc
|
Operations, administration, and maintenance continuity check (OAM CC): enter 1 to enable or 0 to disable.
To provision continuity checking, enable this function at both ends of the connection, otherwise a connection alarm results. (As you create a connection with this parameter, the connection goes into alarm until both ends of the connection are added.)
Default: 0 (disabled)
|
-stat
|
Statistics collection: enter 1 to enable or 0 to disable. The default is 0.
The Cisco WAN Manager tool collects statistics for a connection if you enable it here. Statistics collection is disabled for all connections by default. Statistics collection has an impact (which may not be significant) on the real-time response, especially for SVCs (which can be affected even though you do not add SVCs). Therefore, you should enable statistics collection for only the subset of connections that really warrants such a feature.
|
-frame
|
This option lets you enable or disable frame-based policing and discard for the VCC (no VPCs). See the section, "Frame Discard," for important details on frame discard.
Note This -frame parameter is specified only at the master end.
Possible values:
• 1 to enable
• 0 to disable
Default: 0 (disabled)
|
-mc
|
Maximum cost (maxcost): a value that creates a priority for the connection route. The switch can select a route if the cost does not exceed maxcost. The range for maxcost is 0-4294967295. If you do not specify maxcost, the connection has the highest routing priority by default. Therefore, the maxcost parameter lets you lower the routing priority of a connection. Note the following effects of values in the maxcost range:
• To assign the highest priority to an SPVC based on cost (any path is acceptable), use the default of 4294967295. If you do not specify maxcost, the cost appears as a -1 in the dspcon output. (You cannot enter a -1 for maxcost in the addcon command, but display commands generally can show unspecified values as -1.).
• Enter a 0 for optimal (or least expensive) path.
• For any non-zero maxcost, PNNI allows a path if the total cost for all links does not exceed maxcost.
Although maxcost applies to an individual connection, routing costs substantially depend on a cost-per-link that you specify at every PNNI logical port in the network. The applicable PNNI command is cnfpnni-intf.
The cost of a route is as follows:
routing cost=sum of all costs-per-link
where:
• The cost-per-link has been specified through cnfpnni-intf at the egress of each logical port under PNNI control throughout the network. The impact of cost-per-link is cumulative, not just local.
• Each link has two egress points: one going to the far endpoint, and one in the return direction. The cost-per-link can differ in each direction, so the switch adds the cost-per-link in each egress instead multiplying cost by two.
The cost-per-link applies to all connections of a particular service type on a port. For example, the cost-per-link is the same for all VBR.1 connections that PNNI controls on a port, and this cost can differ from all UBR.1 connections on the same port. Alternatively, you can use cnfpnni-intf to make the cost-per-link the same for all service types.
To illustrate by examining a four-link route:
1. You specify a maxcost of 100000.
2. A route under consideration has four links for a total of eight egress points.
3. The cost-per-link at 6 ports is 5040 (the default) and 10000 at 2 ports.
The route is usable because the cost of 50240 is less than the maxcost of 100000.
Default: 4294967295 The default makes maxcost meaningless for the connection, so PNNI does not use it as a routing metric.
Note To return maxcost to the default, use the cnfcon command with the parameter -mc 4294967295.
|
-lputil
|
Local Percentage Utilization: Range 1-100. The default is 100.
|
-rputil
|
Remote Percentage Utilization: Range 1-100. The default is 100.
|
-rtngprio
|
You can modify the priority of this connection. The descending range of priorities is 1-15. The default is 8. See the cnfpri-routing description for details on this feature.
|
Related Commands
addcon, delcon, dspcon, dspcons, dspconstats
Attributes
Log: yes
|
State: active
|
Privilege: GROUP1
|
Example
Enable OAM CC in the connection with a VPI and VCI of 10 40 on interface 1.
MGX8850.7.PXM1E.a > cnfcon 1 10 40 -cc 1
Assign a routing priority of 3 to the connection with a VPI and VCI of 102 and 102, respectively, on interface number 1. Check the result by using the dspcon command.
M8850_LA.7.PXM1E.a > cnfcon 1 102 102 -rtngprio 3
M8850_LA.7.PXM1E.a > dspcon 3:1.1:1 102 102
Port Vpi Vci Owner State Persistency
----------------------------------------------------------------------------
Local 3:1.1:1 102.102 MASTER FAIL Persistent
Address: 47.00918100000100001a531c2a.000001031801.00
Remote Routed 102.102 SLAVE -- Persistent
Address: 47.00918100000200036b5e30cd.000001011802.00
-------------------- Provisioning Parameters --------------------
Connection Type: VCC Cast Type: Point-to-Point
Service Category: CBR Conformance: CBR.1
Last Fail Cause: unallocated (unassigned) number Attempts: 20055
Continuity Check: Disabled Frame Discard: Disabled
L-Utils: 100 R-Utils: 100 Max Cost: -1 Routing Cost: 0
cnfconpref
Configure Preferred Route for a Connection—PXM45, PXM1E, PXM1
The cnfconpref commands lets you associate a preferred route with an SPVC or SPVP. A connection can have only one preferred route. If a connection already has a preferred route associated with it, you can replace that route with a new one. See the addpref description for more details on preferred routes.
The preferred route must already exist for you to associate it with a connection. The steps can be two or possibly all three of the following:
1.
Create the preferred route by using the addpref command.
2.
If not already done, create the SPVC by using the addcon command.
3.
Associate the preferred route with the SPVC by using the pref command.
Note
An SPVC can be associated with one preferred route. For the preferred routes feature, you specify only the master endpoint of the connection. For an XPVC, you can associate the preferred route with only the SPVC portion of the XPVC.
Syntax
cnfconpref <portid> <vpi> <vci> <rteID> [-assoc {set | clr}] [-direct {set | clr}]
[-onPrefRte {yes | no}]
Syntax Description
portid
|
The format of the PNNI physical port identifier can vary, as follows:
• On a PXM45: slot:subslot.port:subport
• On a PXM1E for UNI/NNI back card: slot:subslot.port:subport. On the UNI/NNI back card, the subslot is always 2, but the slot depends on the chassis, as follows:
– In an MGX 8850 chassis, slot is always the logical slot 7.
– In an MGX 8830 chassis, slot is always the logical slot 1.
• On a PXM1E for a narrowband service module (NBSM): slot.port.
For more details, see the section, "PNNI Format," in "Introduction."
|
vpi
|
VPI of the connection.
Range: 0-255 on a UNI, 0-4095 on an NNI
Default: none
|
vci
|
VCI of the connection. If the VCI is 0, the connection is an SPVP.
Range: 1-65535
Default: none
|
rteID
|
The route identifier.
Range: 1-5000
Default: none
|
-assoc
|
The -assoc option either associates (-assoc set) or disassociates (-assoc clr) the specified route to the specified connection. If you type -assoc set to associate a route, the command entry must include the route ID. If you disassociate the route by typing -assoc clr, the route ID is unnecessary. Because set is the default, if you type a route ID but do not include -assoc set, the protocol interprets the command as an attempt to associate the specified route to the specified connection.
Possible entries: set or clr (for clear)
Default: set
|
-direct
|
Change the directed route status. A directed route means the preferred route associated with the connection is the only route the connection can take. If the preferred route is not available, the connection is failed. Type -direct yes to make the route identified by rteID a directed route for the associated connection. The connection is identified by portid vpi vci.
Possible entries: yes or no
Default: no
|
-onPrefRte
|
This parameter lets you inform the node that the connection is routed on its associated, preferred route. The purpose is to prevent rerouting of the connection during grooming.
Possible entries: yes or no
Default: no
|
Usage Guidelines
Before associating a preferred route to an SPVC, consider the following
•
Make sure that the route-set is complete, with contiguous hops from h(1) though h(n)—without holes. If the route has holes (non-contiguous hop numbers), the controller rejects the association.
•
If the preferred route does not contain a destination hop (in the format persNodeIdx/# or persNodeName/#), the controller rejects the association.
•
If you specify the option -onPrefRte yes, make sure that the current route is the same as the preferred route to which the connection is being associated. The protocol does not check for errors.
Related Commands
addpref, modpref, delpref, dsppref, dspprefs, dsptopondlist
Attributes
Log: yes
|
State: active
|
Privilege: GROUP1
|
cnfconsegep
Configure Connection Segment Endpoint—PXM45, PXM1E
The cnfconsegep command lets you configure a segment endpoint for an SVC or SVP on a via node. Its purpose is to support a particular troubleshooting scheme. After you create an endpoint, you can use the tstdelay command and specify the endpoint created with the cnfconsegep command. The Example section shows how to use tstdelay and conntrace in conjunction with the cnfconsegep command.
You can specify more than one endpoint as long as each one complies with the requirements of the cnfconsegep command, as follows:
•
Before using the cnfconsegep command, be sure continuity checking is de-activated. If you leave checking on, a continuity failure occurs for the connection.
•
When both the VPI and the VCI are present, the segment endpoint is an F5 flow endpoint (for VCCs). When the optional VCI is not present, the segment endpoint is an F4 flow endpoint (for VPCs). Use the cnfconsegep command only for established calls.
•
The endpoints must be part of an SVC or SVP. For an SPVC, you can specify only the SVC endpoints within the SPVC. The controller determines if either side (from its perspective) is an SPVC or SPVP and rejects the command if either endpoint belongs to an SPVC or SPVP. For an SPVC, you can use the cnfconsegep command if one or more via nodes exist in the connection path. (See Figure 2-5.)
In Figure 2-5, an SPVC has endpoints at UNI1 and UNI2. You can use cnfconsegep to configure segment endpoints at NNI2, NNI3, NNI4, and NNI5. You cannot configure segment endpoints at UNI1, UNI2, NNI1, and NNI6. After you configure any of these endpoints, you could verify the electrical integrity by using the tstdelay command from UNI1 or UNI2 to each of NNI2, NNI3, NNI4, or NNI5. After you finish troubleshooting, remove all segment endpoints by using delconsegep for each endpoint.
Figure 2-5 Configurable Endpoints for the cnfconsegep Command
Syntax
cnfconsegep <portid> <vpi> [vci]
Syntax Description
portid
|
The format of the PNNI physical port identifier can vary, as follows:
• On a PXM45: slot:subslot.port:subport
• On a PXM1E for UNI/NNI back card: slot:subslot.port:subport. On the UNI/NNI back card, the subslot is always 2, but the slot depends on the chassis, as follows:
– In an MGX 8850 chassis, slot is always the logical slot 7.
– In an MGX 8830 chassis, slot is always the logical slot 1.
• On a PXM1E for a narrowband service module (NBSM): slot.port.
For more details, see the section, "PNNI Format," in "Introduction."
|
vpi
|
VPI of the connection.
|
vci
|
VCI of the connection.
|
Related Commands
cnfoamsegep, dspoamsegep, delconsegep, dspconsegep
Attributes
Log: yes
|
State: active
|
Privilege: GROUP1
|
Example
This example shows how the cnfconsegep, conntrace, and tstdelay commands can work to show a point of failure.
•
9:1.1:1 on "tokyo"
•
9:1.1:1 on "fiorano"
•
9:1.2:2 on "tokyo"
•
9:1.2:2 on "auckland"
•
9:1.3:3 on "auckland"
•
9:1.1:3 on "fiorano"
In this network, the following have also been established:
•
UNI port 9:1.8:8 on "tokyo"
•
UNI port 9:1.8:8 on "auckland"
•
A connection between these two ports has a VPI/VCI of 66/66.
Check the connection path by using the conntrace command then displaying the trace results with the dspconntracebuffer command. Note that the dspconntracebuffer command does not use keywords. As expected, it traverses the direct link (PhysPortId=9:1.2:2 as shown in the output display), as follows:
tokyo.8.PXM.a > conntrace 9:1.8:8 -vpi 66 -vci 66
tokyo.8.PXM.a > dspconntracebuffer 9:1.8:8 66 66
Result:SUCCESS Reason: N/
Originating Interface VPI : 66
Originating Interface VCI : 66
Originating Interface Call Ref : 1
NodeId EgressPort VPI VCI CallRef
56:160:47.00918100000000107b65f448.00107b65f448.01 17373186 0 35 1
PhysPortId=9:1.2:2
56:160:47.00918100000000309409f3bb.00309409f3bb.01 0
Terminating Interface VPI : 66
Terminating Interface VCI : 66
Terminating Interface Call Ref : 1
To continue this example, the following tasks are performed:
1.
To force the connection to take the longer route (using node "fiorano"), use the dnpnport command to administratively down PNNI port 9:1.2:2.
2.
Repeat the connection trace for 66/66 on UNI port 9:1.8:8 on node "tokyo." The physical port ID now is 9:1.1:1. Note that 66/66 mapped to 0/36 on 9:1.1:1.
3.
Use the uppnport command to bring the port back into service.
tokyo.8.PXM.a > dnpnport 9:1.2:2
tokyo.8.PXM.a > conntrace 9:1.8:8 -vpi 66 -vci 66
Result:SUCCESS Reason: N/A
Originating Interface VPI : 66
Originating Interface VCI : 66
Originating Interface Call Ref : 2
NodeId EgressPort VPI VCI CallRef
56:160:47.00918100000000107b65f448.00107b65f448.01 17373185 0 36 2
PhysPortId=9:1.1:1
56:160:47.00918100000000309409f3b8.00309409f3b8.01 17373187 0 41 1
PhysPortId=9:1.3:3
56:160:47.00918100000000309409f3bb.00309409f3bb.01 0
Terminating Interface VPI : 66
Terminating Interface VCI : 66
Terminating Interface Call Ref : 2
tokyo.8.PXM.a > uppnport 9:1.2:2
Configure a connection segment endpoint by using the following values on node "fiorano:"
•
The PNNI port ID is 9:1.1:1.
•
The VPI/VCI is 0/35—the mapped value observed in the last display of the conntrace command.
fiorano.7.PXM.a > cnfconsegep 9:1.1:1 0 36
PortId: 0.9:1.1:1 Vpi: 0 Vci: 36
The connection is configured as a segment end point.
On the CLI of the AXSM in slot 9, use the tstdelay command to measure the required time for sending OAM cells to the far-end and back. From the PNNI physical port ID 9:1.8:8, you know to cc to slot 9 and specify ifNum 8. (Note that Cisco does not recommend using the tstdelay command for acquiring an accurate measurement of the round trip delay. Its function is better suited to confirming the existence of the connection path.)
tokyo.9.AXSM.a > tstdelay 8 66 66
tstdelay is in progress ..
Connection Id Test Type Direction Result Round Trip Delay
============= ========= ========= ======= ================
08.0066.00066: OAM Lpbk ingress Success 128 microsec
Delete the configuration of the segment endpoint then measure the round trip delay.
fiorano.7.PXM.a > delconsegep 9:1.1:1 0 36
PortId: 0.9:1.1:1 Vpi: 0 Vci: 36
The connection is configured as NOT a segment end point.
tokyo.9.AXSM.a > tstdelay 8 66 66
tstdelay is in progress ..
Connection Id Test Type Direction Result Round Trip Delay
============= ========= ========= ======= ================
08.0066.00066: OAM Lpbk ingress Success 194 microsec
Note that the round trip delay is significantly longer (194 microseconds compared to 128 microseconds in the first instance). If the OAM cells did not return to the near end, the segment where traffic was being lost would have been identified.
Also note that the configuration of segment endpoints can occur on many via nodes.
cnfdate
Configure Date—PXM45, PXM1E
Configure the system date. The system does not return a message unless an error occurred. To see the date, use the dspdate command.
Note
The RPM requires local specification of the date on each card. Use the appropriate IOS command.
Syntax
cnfdate <mm/dd/yyyy>
Syntax Description
mm/dd/yyyy
|
• mm is the month in the range 01-12.
• dd is the day in the range 01-31.
• yyyy is the year in the range 0000-9999.
|
Related Commands
dspdate
Attributes
Log: yes
|
State: active
|
Privilege: SUPER_GP
|
Example
Set date to June 26, 2000.
excel.7.PXM.a > cnfdate 06/26/2000
cnfdiag
Configure Diagnostics—PXM45, PXM1E
Enables the online or offline diagnostics. The cnfdiag command also configures the time settings for the start time and coverage for running the offline diagnostics. When you enter cnfdiag with no parameters, it displays the current configuration and status of the diagnostics.
The cnfdiagall command is the same as cnfdiag except that it configures all slots on the card at once.
Note
Do not remove the active PXM while the offline diagnostic is running on the redundant PXM. If you remove it, the redundant PXM reboots but will not be able to become active unless its hard disk drive was previously synchronized to the hard disk on the previously active PXM.
The Purpose of the Diagnostics
These diagnostics were implemented to test and validate the communication paths on the PXM and the AXSMs before and during operation. The diagnostics are always scheduled from the PXM controller card whether they run on the PXM or a service module.
For backward compatibility, the current switches have two buses on the backplane:
•
A 1.2 Gbps Cellbus
•
A 45 Gbps bus
Because of the difference between bus speeds on the backplane, the Reliability Availability Serviceability (RAS) requirements demand that diagnostics periodically run on the communications paths. Therefore, diagnostics should periodically run on both active and standby cards—especially on standby cards. Frequent testing of standby cards through diagnostics helps to ensure that when an active card fails, the standby card is ready to assume the active card state immediately.
Online Diagnostics
Online diagnostics are nondestructive tests (that do not interfere with live traffic) and run on either an active card or a standby card. The MGX 8950, MGX 8850, and MGX 8830 switches support various online diagnostics tests. The sections that follow describe the tests that run on a PXM45, PXM1E, and the AXSMs.
PXM45 Online Diagnostics
Active State
When you enable online diagnostics on an active PXM45, the following test runs:
•
Crossbar loopback test on QE1210, Humvee, and crossbar paths
Standby State
When you enable online diagnostics on a standby PXM45, the following tests run:
•
Framer loopback test on QE1210, ATLAS, and OC3 framer paths
•
Crossbar loopback walk test on QE1210, Humvee, and crossbar paths
PXM1E On-line Diagnostics
For on-line diagnostics, either an active or a standby PXM1E can run a loopback test. Cells originate on the Atlas, loop at the QE1210, then terminate at the Atlas.
AXSM Online Diagnostics
Active State
When you enable online diagnostics for an active AXSM card, the following test runs:
•
Crossbar loopback test on QE, Humvee, and Crossbar paths
Standby State
When you enable online diagnostics on a standby AXSM card, the following tests run:
•
Framer loopback test on QE48, UDP, ATLAS, and Framer paths (AXSM-E only)
•
Crossbar loopback walk test on QE, Humvee, and Crossbar paths
•
Back card loopback test on T3/E3 lines
Offline Diagnostics
Offline diagnostics are destructive (interfere with traffic) and therefore run only on standby cards.
Offline diagnostics are scheduled by using the offline start (offStart) and offline day-of-week (offDow) parameters. The coverage (offCover) parameter specifies the length of time that the diagnostics run.
Note
When an active card fails, the shelf manager must immediately stop the diagnostics on the standby card, reset, and allow normal operation to occur.
The offline diagnostics that can be enabled and scheduled depend on the circuitry. The sections that follow list the offline diagnostic by card.
PXM45 Offline Diagnostics
The PXM45 runs the following off-line diagnostics:
1.
Processor Subsystem Test
•
Flash EPROM
•
SDRAM
•
SCC
•
PCI Bridge
2.
Component Level Test
•
PIO
•
FPGA
•
LEDs
•
Fan / Power Supply
•
BRAM / RTC
•
SEEPROM / NovRAM Checksum Test
3.
ASIC Tests
•
QE1210 Register and DMA RAM Test
•
CBC Register Test
•
Humvee Register Test
•
Switch ASIC Register Test
•
Atlas Register and RAM Test
•
Framer Register and RAM Test
4.
UI S3/S4 Back card test
•
NovRAM Checksum Test
5.
Cell Path Test
•
CBC Cell Path Test - Backplane Side
•
Framer Cell Path Test - Port Side
•
Humvee / Transceiver / Crossbar Switch Cell Path Test
PXM1E Off-line Diagnostics
The PXM1E runs off-line diagnostics in the following areas:
1.
Processor subsystem: NVRAM and BRAM
2.
ASIC tests: Atlas (register test, ingress memory, egress memory) and framer (register test)
3.
UI S3 back card: UIS3 BC register test
AXSM Offline Diagnostics
1.
I/O PLD data bus test
2.
Skystone Framer register & RAM test.
3.
Humvee ASIC register test
4.
CBC register test
5.
ATMizer RAM test
6.
QE48 register and RAM test
7.
NovRAM checksum test
8.
Flash EPROM checksum test
Syntax
cnfdiag <slot> <onEnb> <offEnb> [<offCover> <offStart> <offDow>]
Syntax Description
slot
|
The slot of the card for which to configure the diagnostics.
|
onEnb
|
Enable or disable online diagnostics. The default is disable.
|
offEnb
|
Enable or disable offline diagnostics. The default is disable.
|
offCover
|
Set the offline diagnostics coverage time to light, medium, or full.
• light = 5 minutes or less
• medium = 30 minutes or less
• full = any number of minutes-no limit
|
offStart
|
Set the time for the offline diagnostics to begin using 24 hour time. The format is: hh:mm. For example: 03:45 or 22:30.
|
offDow
|
Sets the day of the week for the offline diagnostics to run. The format is SMTWTFS. For example: -M-W--- is Mondays and Wednesdays only.
|
Related Commands
cnfdiagall, dspdiagcnf, abortofflinediag
Attributes
Log: no
|
State: active
|
Privilege: SERVICE_GP
|
Example
cnfdiag 7 enable disable light 22:30 -M-W-F-
cnfdiagall
Configure Diagnostics All—PXM45, PXM1E
This command enables and configures online or offline diagnostics for all card slots. (This command is the same as cnfdiag except that it effects all slots instead of just one.)
When you enter this command with no parameters, it displays the current configuration and status of the diagnostics.
Note
See the cnfdiag command for a detailed description of MGX 8850 diagnostics.
Note
Do not remove the active PXM while the offline diagnostic is running on the redundant PXM. If you remove it, the redundant PXM reboots but will not be able to become active unless its hard disk drive was previously synchronized to the hard disk on the previously active PXM.
Syntax
cnfdiagall <onEnb> <offEnb> [<offCover> <offStart> <offDow>]
Syntax Description
onEnb
|
Enables online diagnostics.
|
offEnb
|
Enables offline diagnostics.
|
offCover
|
Sets the offline diagnostics coverage time to light, medium, or full.
• light = 5 minutes or less
• medium = 30 minutes or less
• full = unlimited
|
offStart
|
Sets the time for the offline diagnostics to begin using 24 hour time. The format is:
hh:mm
|
offDow
|
Sets the day of the week for the offline diagnostics to run. The format is SMTWTFS. Enter a dash (-) for days on which you do not want diagnostics to run.
|
Related Commands
cnfdiag, dspdiagcnf
Attributes
Log: no
|
State: active, standby
|
Privilege: SERVICE_GP
|
Example
cnfdiagall enable disable light 22:30 -M-W-F-
cnfe164justify
Configure E.164 Justification—PXM45, PXM1E
Specifies whether the E.164 AESAs with the E.164 AFI are converted to the left or right-justified encoding format. For PNNI to search the address correctly, all nodes in the PNNI network must use the same justification.
Syntax
cnfe164justify left | right
Syntax Description
left or right
|
Justification of E164 addresses. Type the entire word "left" or "right."
Default: left
|
Related Commands
dspsvcparm
Attributes
Log: yes
|
State: active
|
Privilege: SUPER_GP
|
Examples
Configure right-hand justification for the E.164 AESAs.
Geneva.7.PXM.a > cnfe164justify right
cnfenhiisp
Configure Enhanced IISP—PXM45, PXM1E
The cnfenhiisp command enables or disables the enhanced IISP feature on the port. This command applies to only IISP ports. When you change the operational state of enhanced IISP, the change does not affect existing calls.
The items that enhanced IISP include are:
•
Generic identifier transport (GIT)
•
Virtual path service over the IISP
•
Added support or nrt-VBR and rt-VBR
•
Transport of frame discard specification
Syntax
cnfenhiisp <portid> {yes | no}
Syntax Description
portid
|
The format of the PNNI physical port identifier can vary, as follows:
• On a PXM45: slot:subslot.port:subport
• On a PXM1E for UNI/NNI back card: slot:subslot.port:subport. On the UNI/NNI back card, the subslot is always 2, but the slot depends on the chassis, as follows:
– In an MGX 8850 chassis, slot is always the logical slot 7.
– In an MGX 8830 chassis, slot is always the logical slot 1.
• On a PXM1E for a narrowband service module (NBSM): slot.port.
For more details, see the section, "PNNI Format," in "Introduction."
|
yes | no
|
Enter "yes" to enable enhanced IISP or "no" to disable enhanced IISP.
Default: no
|
Related Commands
dspenhiisp
Attributes
Log: yes
|
State: active
|
Privilege: SUPER_GP
|
Examples
Enable enhanced IISP on port 11:2.1:1.
Geneva.7.PXM.a > cnfenhiisp 11:2.1:1 yes
cnfetherif
Configure Ethernet Interface—PXM45, PXM1E (init state only)
The cnfetherif command lets you configure an Ethernet interface while the PXM is in the init state. The dspetherif command displays the configuration. Both of these commands are available only when the PXM is in the init state.
Syntax
cnfetherif <ip_address> [ net_mask ]
ip_address
|
The IP address has the format a.b.c.d. See the Example section.
|
net_mask
|
The optional net mask has the format a.b.c.d. See Example for a typical netmask.
|
Syntax Description
This command has no parameters.
Related Commands
dspetherif
Attributes
Log: no
|
State: init
|
Privilege: ANYUSER
|
Example
Configure an init-state Ethernet interface to have Ethernet address 177.19.21.66 and a netmask of 255.255.0.0. Display the new Ethernet interface.
scott.8.PXM.if > cnfetherif 177.19.21.66 255.255.0.0
scott.8.PXM.if > dspetherif
scott System Rev:03.00 Sep. 20, 2002 12:49:26 PST
ETHERNET IP INTERFACE CONFIGURATION
--------------------------------------------------------------------
Flags:(0x63) UP BROADCAST ARP RUNNING
Internet address:177.19.21.66
Broadcast address:177.19.21.255
Netmask 0xffff0000 Subnetmask 0xffffff00
Ethernet address is 00:30:94:09:f3:ab
Maximum Transfer Unit size is 1500
342500 packets received; 281994 packets sent
60401 multicast packets received
282 multicast packets sent
0 input errors; 0 output errors
DISK IP address:177.19.21.66
cnffltset
Configure Filter Set—PXM45, PXM1E
Use cnffltset to modify an existing filter set. This command can:
•
Add more addresses to the filter set.
•
Change the access mode or address field of a filter set entry.
After a filter is modified for a specific port, associate the filter to that port by using cnf-pnportacc.
Syntax
cnffltset <name> [-address atm-address -length address-length [-plan {nsap | e164}] [-list {calling | called}]] [-index number] [-accessMode {permit | deny}]
Syntax Description
name
|
A name for the filter set: the maximum is 30 characters.
|
address
|
The 1-40 digit NSAP or 1-15 digit E.164 address. You can add the address to a filter set. The default is modifying the accessMode field of a filter element using the index only: in this case, the you need not specify the address field.
|
length
|
If the address is specified, the length must be specified.
• For NSAP, the length is in bits.
• For E164, the length is in bytes.
|
plan
|
Address Plan: e.164 or nsap. You may specify this field only if you also specify the address field.
Default: nsap
|
list
|
Address List: calling or called. You may specify this field only if you also specify the address field.
Default: calling
|
index
|
Order in which filters are set.
Range: 1-65535 Default: 1
|
AccessMode
|
Specify the access mode (permit or deny) to whether accept or deny the call on the port if the address pattern-matching succeeds.
Default: permit.
|
Related Commands
addfltset, delfltset, dspfltset
Attributes
Log: yes
|
State: active
|
Privilege: SUPER_GP
|
cnfilmi
Configure ILMI—PXM1E
Configures the card-level interim local management interface (ILMI) for the PXM1E UNI/NNI back card (for the VSI slave side). Activating the card-level ILMI through cnfilmi requires a pre-existing logical port (see addport) and resource partition (see addrscprtn or addpart). No response appears unless an error occurs.
Note
For network-level ILMI in relation to PNNI, run the PNNI-specific ILMI commands on the PXM45. The PNNI-specific ILMI commands also apply to the VSI master on the PXM1E.
Syntax
cnfilmi <ifNum> -id <partitionID> -ilmi <ilmiEnable> -vpi <vpi> -vci <vci> -trap <ilmiTrapEnable> -s <keepAliveInt> -t <pollingIntervalT491> -k <pollInctFact>
Syntax Description
ifNum
|
Logical port number in the range is 1-31
|
-id
|
Partition ID in the range 1-20. (See description of addpart or addrscprtn for information regarding resource partition ID.)
|
-ilmi
|
Enable or disable ILMI. 1=enable. 2=disable.
|
-vpi
|
VPI for the ILMI signaling connection. The range is 0-255.
|
-vci
|
VPI for the ILMI signaling connection. The range is 0-65535.
|
-trap
|
Enable or disable ILMI trap. 1=enable. 2=disable.
|
-s
|
Keep alive interval. The range is 1-65535 seconds.
|
-t
|
Polling interval for T491 in the range 0-65535 seconds.
|
-k
|
Polling interval K in the range 0-65535 seconds.
|
Related Commands
dspilmi, dspilmis, dspilmicnt, clrilmicnt, dnilmi, upilmi
Attributes
Log: yes
|
State: active
|
Privilege: GROUP1
|
Examples
Unknown.7.PXM1E.a > cnfilmi 1 1 -ilmi 1 -vpi 40 -vci 99 -s 10 -t 10 -k
cnfilmienable
Configure ILMI Enable—PXM45, PXM1E
Enables ILMI on a PNNI port. Prior to cnfilmienable, the port must be administratively down. Use the dnpnport command to down the port and uppnport to up it.
Syntax
cnfilmienable <portid> [yes | no]
Syntax Description
portid
|
The format of the PNNI physical port identifier can vary, as follows:
• On a PXM45: slot:subslot.port:subport
• On a PXM1E for UNI/NNI back card: slot:subslot.port:subport. On the UNI/NNI back card, the subslot is always 2, but the slot depends on the chassis, as follows:
– In an MGX 8850 chassis, slot is always the logical slot 7.
– In an MGX 8830 chassis, slot is always the logical slot 1.
• On a PXM1E for a narrowband service module (NBSM): slot.port.
For more details, see the section, "PNNI Format," in "Introduction."
|
yes or no
|
Type "yes" to enable ILMI or "no" to disable ILMI on the specified PNNI port.
Default: disabled
|
Related Commands
dnpnport, uppnport, dsppnilmi
Attributes
Log: yes
|
State: active
|
Privilege: GROUP1
|
Examples
Enable ILMI on a PNNI port 4:1.1:11. First, disable the port by using dnpnport.
Geneva.1.PXM.a > dspilmi 4:1.1:11
INFO: No ilmi address registered
Geneva.7.PXM.a > dnpnport 4:1.1:11
Geneva.7.PXM.a > cnfilmienable 4:1.1:1
Geneva.7.PXM.a > uppnport 4:1.1:11
Geneva.7.PXM.a >
cnfilmiproto
Configure ILMI Protocol—PXM45, PXM1E
The cnfilmiproto command lets you configure how PNNI reacts to ILMI events that occur on the VSI slave (a service module). Use the dsppnilmi command to confirm changes to the configuration.
Syntax
cnfilmiproto <portid> [-securelink {yes | no}] [-attachmentpoint {yes | no] [-modlocalattrstd {yes | no]
Syntax Description
portid
|
The format of the PNNI physical port identifier can vary, as follows:
• On a PXM45: slot:subslot.port:subport
• On a PXM1E for UNI/NNI back card: slot:subslot.port:subport. On the UNI/NNI back card, the subslot is always 2, but the slot depends on the chassis, as follows:
– In an MGX 8850 chassis, slot is always the logical slot 7.
– In an MGX 8830 chassis, slot is always the logical slot 1.
• On a PXM1E for a narrowband service module (NBSM): slot.port.
For more details, see the section, "PNNI Format," in "Introduction."
|
-securelink
|
Sets the flag securelink to make PNNI release the call if it loses connection to the ILMI slave.
no: do not enable the ILMI Secure link protocol. yes: disable the ILMI Secure link protocol.
Default: yes
|
-attachmentpoint
|
Sets the flag attachmentpoint to make PNNI release the call if the slave ILMI session sees changes in peer information, such as the system name or system ID.
no: do not enable the detection of loss of attachmentpoint protocol. yes: Enable the detection of loss of attachmentpoint.
Default: yes
|
-modlocalattrstd
|
Sets the flag modlocalattrstd to make PNNI release the call if the slave ILMI sees ATM layer (partition resource) changes, such as the VPI or VCI.
no: disable the ILMI standard procedure for modification of local ATM param. yes: enable the ILMI standard procedure for modification of local ATM param.
Default: yes
|
Related Commands
dsppnilmi
Attributes
Log: yes
|
State: active
|
Privilege: GROUP1
|
Example
Jose.7.PXM.a > cnfilmiproto 11:2.1.1 -securelink no -attachmentpoint no -modlocalattrstd
yes
cnfimagrp
Configure IMA Group—PXM1E
This command modifies one or more attributes of an IMA group. Modifying any IMA attribute causes the IMA group to restart. See the addimagrp and addimaport descriptions for details on IMA groups.
Syntax
cnfimagrp <-grp group> [-ver <version>] [-txm <minLinks>] [-txid <txImaId>] [-txfl <txFrameLen>] [-dd <diffDelayMax>] [-uptim <groupUpTime>] [-dntim <groupDownTime>]
Syntax Description
-grp group
|
The group has the format bay.group and the following possible values:
• bay: always 2 on the PXM1E
• group: 1-16
|
-ver version
|
The protocol version of the IMA group.
• 1 = IMA version 1.0
• 2 = IMA version 1.1
|
-txm minLinks
|
The minimum number of links that allows the IMA group to be operational.
Range: 1-16
For IMA version 1.0, the minLinks value is always 128.
|
-txid txImaId
|
The IMA ID number transmitted in the IMA ID field of the ICP cell.
Range: 0-255
|
-txfl txFrameLen
|
The length of a transmitted IMA frame is specified in megabytes.
• For version 1.0 IMA, txImaFrameLength is always 128.
• For version 1.1 IMA, txImaFrameLength can be 32, 64, 128, or 256.
|
-dd diffDelayMax
|
The maximum differential delay is specified in milliseconds. The ranges depend on the line type, as follows:
• T1: 1-275
• E1: 1-220
Defaults: T1 = 275, E1 = 220
|
-uptim groupUpTime
|
The group up time has a range of 0-400,000 milliseconds.
Default: 10000
|
-dntim groupDownTime
|
The group down time has a range of 0-100,000 milliseconds.
Default: 2500
|
Related Commands
addimagrp, delimagrp, dspimagrp, dspimagrps, rstimagrp, dspimalnk
Attributes
Log: yes
|
State: active
|
Privilege: GROUP1
|
Example
For IMA group 16, specify a differential delay of 200 milliseconds.
MGX8850.7.PXM1E.a > cnfimagrp -grp 2.16 -dd 200
cnfimalnktst
Configure IMA Link Test—PXM1E
The cnfimalnktst command lets you specify a pattern test to confirm the integrity of an individual link. To start and end the test, use the startimalnktst and stopimalnktst commands, respectively.
The test pattern is a number in the range 0-254. A 0 causes the system to select a number for the pattern. If the transmitted number is the same as the number that arrives at the receiving end of the link, the link is valid. If the test pattern is different or does not arrive at all, the link is invalid.
Note
Link test works for version 1.0 only.
Syntax
cnfimalnktst <-grp group> <-lnk link> <-pat test Pattern>
Syntax Description
-grp
|
The group identifier consists of a bay number as well as a group number in the format bay.group, as follows:
• bay: always 2 on the PXM1E
• group: 1-16
|
-lnk
|
The link identifier consists of a bay number as well as a link number in the format bay.link, as follows:
• bay: always 2 on the PXM1E
• link: 1-16
|
-pat
|
The test Pattern is a number in the range 0-254. A 0 causes the system to select a number for the test pattern.
Default: 0
|
Related Commands
startimalnktst, stopimalnktst
Attributes
Log: yes
|
State: active
|
Privilege: GROUP1
|
Example
For group 1 and link 1, specify a test pattern of 77.
MGX8850.7.PXM1E.a> cnfimalnktst -grp 2.1 -lnk 2.1 -pat 77
cnfintfcongth
Configure Interface Congestion Threshold—PXM45, PXM1E
The cnfintfcongth command lets you configure congestion thresholds for a logical port. The thresholds apply to incoming calls and status enquiries. When the upper congestion limit is reached, the port may block incoming calls and adjust the pace of status enquiries.
You must specify at least one keyword.
Syntax
cnfintfcongth <portid> [-setuphi {setuphival [-unackedstatenqlo {unackedstatenqloval} ]
[ -unackedstatenqhi {unackedstatenqloval} ]
Syntax Description
portid
|
The format of the PNNI physical port identifier can vary, as follows:
• On a PXM45: slot:subslot.port:subport
• On a PXM1E for UNI/NNI back card: slot:subslot.port:subport. On the UNI/NNI back card, the subslot is always 2, but the slot depends on the chassis, as follows:
– In an MGX 8850 chassis, slot is always the logical slot 7.
– In an MGX 8830 chassis, slot is always the logical slot 1.
• On a PXM1E for a narrowband service module (NBSM): slot.port.
For details, see the section, "PNNI Format," in "Introduction."
|
-setuphi
|
The number of connection set-up messages per second. Above this number, the condition of set-up messages on the interface is congested.
Range: 1-260 calls per second Default: 180
|
-unackedStatEnqLo
|
The number of status enquires yet to be acknowledged by peer-to-peer interface. Below this value, the congestion condition for status enquiries at the interface level is dropped.
Range: 1-500 messages Default: 40
|
-unackedStatEnqHi
|
The number of status enquires yet to be acknowledged by peer-to-peer interface. The interface is considered to be congested with status enquiries when this thresholds is reached.
Range: 1-500 messages Default: 100
|
Related Commands
dspintfcongth, dspnodalcongth
Attributes
Log: yes
|
State: active
|
Privilege: GROUP1
|
Example
Configure a congestion threshold of 200 for set-up messages on 6:1.1:1. Check the results by using the dspintfcongth command.
M8850_NY.7.PXM.a > cnfintfcongth 6:1.1:1 -setuphi 200
M8850_NY.7.PXM.a > dspintfcongth 6:1.1:1
Congestion Thresholds for port : 6:1.1:1
unackedStatEnqLo 40 messages
unackedStatEnqHi 200 messages
cnfintfvsvd
Configure Interface for VS/VD—PXM45, PXM1E
The cnfintfvsvd command lets you enable internal or external virtual source/virtual destination (VS/VD) on a PNNI port. If VS/VD is disabled on a port, you can enable VS/VD for individual ABR connections by using the cnfabr command. As described in Syntax Description, the cnfintfvsvd command also lets the service class template determine whether VS/VD is enabled.
Note
In the current release, the PXM1E does not support VS/VD.
Before using the cnfintfvsvd command, note the following.
•
The command applies to ports configured for UNI 4.0 or higher.
•
The port must be administratively down (see dnpnport).
•
The port must exist on an AXSM-E because it alone supports ABR VS/VD.
Syntax
cnfintfvsvd <portid> [-internal {off | on | unspecified}] [-external {off| on | unspecified}]L
Syntax Description
portid
|
The format of the PNNI physical port identifier can vary, as follows:
• On a PXM45: slot:subslot.port:subport
• On a PXM1E for UNI/NNI back card: slot:subslot.port:subport. On the UNI/NNI back card, the subslot is always 2, but the slot depends on the chassis, as follows:
– In an MGX 8850 chassis, slot is always the logical slot 7.
– In an MGX 8830 chassis, slot is always the logical slot 1.
• On a PXM1E for a narrowband service module (NBSM): slot.port.
For more details, see the section, "PNNI Format," in "Introduction."
|
internal
|
Indicates the internal loop for VS/VD. The choices are as follows:
off: at the port level, VS/VD service for ABR connections is disabled. Therefore, for an ABR connection to have VS/VD support, you must use the cnfabr command to enable it.
on: at the port level, VS/VD service for ABR connections is enabled. Therefore, all ABR connections on the port have VS/VD support. If you do not want a particular ABR connection to have VS/VD, use the cnfabr command to disable it for that connection.
unspecified: the port defaults to the VS/VD capability that the port-level SCT specifies.
Default: unspecified
|
external
|
Indicates the external loop for VS/VD. The choices are as follows:
off: at the port level, VS/VD service for ABR connections is disabled. Therefore, for an ABR connection to have VS/VD support, you must use the cnfabr command to enable it.
on: at the port level, VS/VD service for ABR connections is enabled. Therefore, all ABR connections on the port have VS/VD support. If you do not want a particular ABR connection to have VS/VD, use the cnfabr command to disable it for that connection.
unspecified: the port defaults to the VS/VD capability that the port-level SCT specifies.
Default: unspecified
|
Related Commands
dsppnport, cnfabr
Attributes
Log: yes
|
State: active
|
Privilege: GROUP1
|
Example
This example starts with the assumption that port 5:1.1:1 is administratively down and is configured for an interface type other than UNI 4.0. Do the following:
Step 1
Specify UNI 4.0 for port 5:1.1:1 by using the cnfpnportsig command.
Step 2
Enable internal and external VS/VD.
Step 3
Up the port by using the uppnport command.
Step 4
Confirm that internal and external VS/VD is enabled on the port. Note that, for UNI 4.0 or higher, the dsppnport shows VS/VD status. For earlier UNI versions, the dsppnport display does not show VS/VD.
M8850_NY.7.PXM.a > cnfpnportsig 5:1.1:1 -univer uni40
M8850_NY.7.PXM.a > cnfintfvsvd 5:1.1:1 -internal on -external on
M8850_NY.7.PXM.a > uppnport 5:1.1:1
M8850_NY.7.PXM.a > dsppnport 5:1.1:1
Port: 5:1.1:1 Logical ID: 17111041
IF status: down Admin Status: up
Auto-config: enable Addrs-reg: enable
IF-side: network IF-type: uni
UniType: private Version: uni4.0
Input filter: 0 Output filter: 0
minSvccVpi: 0 maxSvccVpi: 255
minSvccVci: 35 maxSvccVci: 65535
minSvpcVpi: 1 maxSvpcVpi: 255
#SpvcCfg: #SpvcActive: #SpvpCfg: #SpvpActive:
cnflink
Configure Link—PXM45, PXM1E
The cnflink command lets you change the framing for a T1 tributary. The command applies to the Service Resource Module-Enhanced (SRME). The upln and cnfln commands that you use on the PXM result in a line framing for all tributaries. For an individual link, you can configure the framing by using the cnflink command.
Note
In the current release, only the PXM1E supports the SRM.
Syntax
cnflink <SrmStartLinkIf> <FramingType>
Syntax Description
SrmStartLinkIf
|
The format for SrmStartLinkIf is slot.line.link. The SrmStartLinkIf parameter identifies physical and logical elements of the SRM. The slot is logical and refers to the standby SRM slots as well as the primary slots.
Possible entries are as follows:
• The slot in an MGX 8850 chassis can be 15 or 31. For an MGX 8830 chassis, slot is 7.
• The physical line (for the SRME) is 1).
• The link is the targeted T1 tributary and has a range of 1-84.
|
FramingType
|
The framing type is either superframe (SF) or extended superframe (ESF).
Possible entries are:
• 2: SF
• 3: ESF
|
Related Commands
addlink, dellink, dsplink, dspslotlink
Attributes
Log: yes
|
State: active
|
Privilege: GROUP1
|
Example
cnfln
Configure Line—PXM1E
On a PXM, the cnfln command lets you configure a line on the UNI/NNI (network interface) back card of a PXM1E or a Service Resource Module (SRME or SRM-3T3/C). (The UNI/NNI back card is also known as the uplink card or uplink bay.)
Note
In the current release, the PXM45 does not support cnfln even though the CLI help shows it.
Note the following before you use the cnfln command on a PXM:
•
You must first activate the line by using the upln command.
•
You cannot configure a line that has virtual interfaces (see addport description).
•
If you do not know the line type (required by cnfln), use the dsplns or dspcd command to check.
•
The SRMs have a "no back card" capability. This capability lets the SRM operate without a back card if the SRM in a bay is intended to operate without bulk mode distribution. If no back card is present, no need exists to configure lines.
(If the switch is already powered on and the SRMs installed, you can pull the back card from the primary SRM and, if present, the back card from the secondary SRM. If the cards are out of the backplane and power is off, just install the front cards. An SRM with no back card appears in card displays as "SRM_NO-BC.)
Generic Syntax
This section introduces general information about the syntax. The syntax varies according to the line type, so each line type has its own description.
Your entries for line type and slot number determine the option list for cnfln on a PXM. The options for line type depend on whether the line is SONET, SDH, T3, E3, T1, or E1. The slot indicates to the controller whether the card is an SRM or the PXM1E NNI/UNI back card. The generic syntax follows:
cnfln -<lineType> slot.line <optionList>
If you enter only the line type, slot number, and line number, the Help feature displays appropriate syntax with option list. In the sections that follow, the Syntax and Syntax Description heading shows the line type.
To help you enter the correct line type and to locate the SRMs, use some of the high-level commands. To see all cards in the switch, use the dspcds command. The display shows where and what type of SRMs are present. To see the type of PXM1E back card, use the dspcd command on the PXM1E CLI. To see the types for all lines, use the dsplns command.
Syntax for PXM1E SONET or SDH Line
cnfln -sonet <X.line> -slt <LineType> -clk <clockSource>
Syntax Description for PXM1E SONET or SDH Line
-sonet
|
The sonet keyword identifies the line as a SONET line and enables the choices that follow.
|
X.line
|
X is a logical slot number regardless of where the card actually resides. Also, X can refer to ether the UNI/NNI back card or an SRM, as follows:
• For the UNI/NNI back card, X is always 2.
• For an SRM, X depends on the chassis, as follows:
– For MGX 8850 chassis, X can be 15 or 31.
– For MGX 8830 chassis, X can be 7.
The range for the line parameter reflects the combination back card. The combo card has four OC3c/STM1 lines and eight T3 or E3 lines. (The latter group of eight is configurable though the cnfcdmode command). The range for line:
• 1-4 on straight OC-3c card
• 9-12 on the combo card
|
-slt
|
Type one of the following numbers to specify SONET or SDH:
• 1: SONET
• 2: SDH
|
-clk
|
The clock can come from the backplane (local timing) or the receive line (loop timing). Type "1" or "2," as needed:
• 1: Loop timing
• 2: Local timing
Default: Local timing
|
Syntax for PXM1E T3 Line
cnfln -ds3 <X.line> -lt <LineType> -len <LineLength> -oof <OOFCriteria> -cb <A>
-clk <clockSource> -rfeac <RcvFEACValidation>
Syntax Description for PXM1E T3 Line
-ds3
|
Typing -ds3 as the first parameter enables the applicable options.
|
X.line
|
X is a logical slot number regardless of where the card actually resides. Also, X can refer to ether the UNI/NNI back card or an SRM, as follows:
• For the UNI/NNI back card, X is always 2.
• For an SRM, X depends on the chassis, as follows:
– For MGX 8850 chassis, X can be 15 or 31.
– For MGX 8830 chassis, X can be 7.
The range for the line parameter reflects the combination back card. The combo card has four OC3c/STM1 lines and eight T3 or E3 lines. (The latter group of eight is configurable though the cnfcdmode command).
Range: 1-8 on the combo card or T3/E3 card
|
-lt
|
Enter one of the following numbers for the appropriate DS3 line type:
• 1: ds3cbitadm
• 2: ds3cbitplcp
|
-len
|
The length has a range of 0-64000 meters.
|
-oof
|
For the out of frame criteria, type one of the following numbers to select criteria:
• 1: 3 out of 8
• 2: 3 out of 16
|
-cb
|
For check bit handling, enter one of the following numbers:
• 1: Check the C-bit
• 2: Ignore the C-bit
|
-clk
|
With loop timing, the clock for the transmit direction is generated by redirecting the receive clock to the transmit clock line. With local timing, the clock comes from the backplane.
• 1: Loop timing
• 2 Local timing
Default: Local timing
|
-rfeac
|
For receive FEAC validation, enter one of the following numbers:
• 1: 4 out of 5
• 2: 8 out of 10
• 3: disable
|
Syntax for PXM1E E3 Line
cnfln -e3 <X.line> -len <LineLength> -clk <clockSource>
-e3
|
Typing -e3 as the first parameter enables the applicable list of options.
|
X.line
|
X is a logical slot number regardless of where the card actually resides. Also, X can refer to ether the UNI/NNI back card or an SRM, as follows:
• For the UNI/NNI back card, X is always 2.
• For an SRM, X depends on the chassis, as follows:
– For MGX 8850 chassis, X can be 15 or 31.
– For MGX 8830 chassis, X can be 7.
The range for the line parameter reflects the combination back card. The combo card has four OC3c/STM1 lines and eight T3 or E3 lines. (The latter group of eight is configurable though the cnfcdmode command).
Range: 1-8 on the combo card or T3/E3 card
|
-len
|
The length has a range of 0-64000 meters.
|
-clk
|
With loop timing, the clock for the transmit direction is generated by redirecting the receive clock to the transmit clock line. With local timing, the clock comes from the backplane.
• 1: Loop timing
• 2 Local timing
Default: Local timing
|
Syntax for PXM1E DS1 Line
-ds1
|
Typing -ds1 as the first parameter enables the applicable options.
|
X.line
|
X is a logical slot number regardless of where the card actually resides. For the UNI/NNI back card, X is always 2.
Range for line: 1-16
|
-len
|
The length has a range of 0-64000 meters.
|
-clk
|
With loop timing, the clock for the transmit direction is generated by redirecting the receive clock to the transmit clock line. With local timing, the clock comes from the backplane.
• 1: Loop timing
• 2 Local timing
Default: Local timing
|
Syntax for PXM1E E1 Line
-e1
|
Typing -e1 as the first parameter enables the applicable options.
|
X.line
|
X is a logical slot number regardless of where the card actually resides. For the UNI/NNI back card, X is always 2.
Range for line: 1-16
|
-clk
|
With loop timing, the clock for the transmit direction is generated by redirecting the receive clock to the transmit clock line. With local timing, the clock comes from the backplane.
• 1: Loop timing
• 2 Local timing
Default: Local timing
|
Syntax for SRME Line
cnfln -sonet <slot.line> -slt <LineType> -clk <clockSource> -lpb <loopback> -sfs <FrameScramble> -rdiv <RDI-V Type> -rdip <RDI-P Type> -tt <Tributary Type> -tm <TributaryMappingType>
-tf <TributaryFramingType> -st <SignallingTranportMode> -tg <TributaryGroupingType>
Syntax Description for SRME Line
If you are planning bulk distribution to T1 lines in Japan, specify a SDH (STM1) line type (see the -slt parameter). For bulk distribution to E1 lines, you must also specify the SDH line type.
-sonet
|
The sonet keyword identifies the line as a SONET line and enables the choices that follow.
|
slot.line
|
The slot is a logical slot number regardless of where the SRME actually resides. For example, if the switch has an SRME in only 16 but not 15—not a likely situation—you would still enter "15." On the SRME, only one line exists on the back card, so line is always "1." The slot numbers vary with the chassis model, as follows:
• MGX 8850: 15, 31
• MGX 8830: 7
|
-slt
|
The line type is either SONET or SDH. Type one of the following choices for LineType:
• 1: SONET
• 2: SDH
|
-clk
|
The clock can come from the backplane (local timing) or the receive line (loop timing). Type "1" or "2," as needed:
• 1: Loop timing
• 2: Local timing
Default: Local timing
|
-lpb
|
Enables one of two loopback types or disables an active loopback, as follows:
• 1: No loopback
• 2: Local loopback
• 3: Remote loopback
Default: no loopback
|
-sfs
|
The frame scramble enable
• 1 = enable
• 2 = disable
|
-rdiv
|
Specifies the number of RDI V bits. Follow the keyword with either a "1" for 1 bit or a "3" for 3 bits.
|
-rdip
|
Specifies the number of RDI P bits. Follow the keyword with either a "1" for 1 bit or a "3" for 3 bits.
|
-tt
|
The TributaryType selects a tributary type based on whether the line is SONET or SDH. For SONET, type "1." For SDH, type "2." This choice results in the following standard for virtual tributary (VT) and virtual container (VC).
• 1: VT1.5/VC11
• 2: VT2/VC12
Note In the current release, only VT1.5 and VC 11 for T1 applications are supported.
|
-tm
|
The tributary mapping type is either asynchronous or byte-synchronous. Type a "1" or "2."
• 1: Asynchronous
• 2: Byte-synchronous
Default: asynchronous
Note In the current release, tributary mapping applies to only T1 tributaries.
|
-tf
|
The tributary framing type is either superframe or extended superframe. This option applies only if the tributary mapping is byte-synchronous (-tm 2). Type a "2" or "3."
• 2: Superframe
• 3: Extended superframe
|
-st
|
The signaling transport mode applies only if you have selected byte-synchronous tributary mapping (-tm 2). The transport mode is either transfer mode or clear mode:
• With transfer mode, the framing bit is transferred to the VT header.
• With clear mode, the signaling bit is transferred to the VT header.
Follow the keyword with either a "2" or a "3."
• 2: Transfer Mode
• 3: Clear Mode
|
-tg
|
The tributary grouping type applies to SDH. Type a "2" or a "3."
• 2: AU3
• 3: AU4
|
Syntax for SRM-3T3
cnfln -ds3 <X.line> -lt <LineType> -len <LineLength> -oof <OOFCriteria> -cb <A>
-rfeac <RcvFEACValidation> -clk <clockSource>
Syntax Description for SRM-3T3/C
-ds3
|
Typing -ds3 as the first parameter enables the applicable list of options.
|
X.line
|
X is a logical slot number regardless of physical slot. X also depends on the chassis type:
• MGX 8850: 15 or 31
• MGX 8830: 7
Range for line: SRM-3T3/C: 1-3
|
-lt
|
Enter one of the following numbers according to the DS3 line type:
• 1: ds3cbitadm
• 2: ds3cbitplcp
|
-len
|
The length has a range of 0-64000 meters.
|
-oof
|
For the out of frame criteria, type one of the following numbers to select criteria:
• 1: 3 out of 8
• 2: 3 out of 16
|
-cb
|
For check bit handling, enter one of the following numbers:
• 1: Check the C-bit
• 2: Ignore the C-bit
|
-rfeac
|
For receive FEAC validation, enter one of the following numbers:
• 1: 4 out of 5
• 2: 8 out of 10
|
-clk
|
With loop timing, the transmit clock is generated by redirecting the receive clock to the transmit clock line. With local timing, the clock comes from the backplane.
• 1: Loop timing
• 2 Local timing
Default: Local timing
|
Related Commands
upln, dnln, dspln, dsplns, cnfcdmode
Attributes
Log: yes
|
State: active
|
Privilege: GROUP1
|
Example PXM1E T3 Line
Configure T3 line 2.4 to have ds3cbitadm coding, be 10 meters, oof=2, clock local, and rfeac=2.
MGX8850.7.PXM1E.a > cnfln -ds3 2.4 -lt 1 -len 10 -oof 2 -cb 1 -clk 2 -rfeac 1
Examples for SRME
Check the tributary mapping on the SRME SONET line in slot 15 and change it to byte-synchronous if the current configuration is asynchronous.
Unknown.7.PXM.a > dspln -sonet 15.1
Loopback : NoLoop APS enabled : Disable
Frame Scrambling : Enable RDI-V Type : one bit
Xmt Clock source : loopTiming RDI-P Type : one bit
Line Type : sonetSts3 VT Type : vt15/vc11
Medium Type(SONET/SDH) : SONET VT Mapping Type : asynchronous
Medium Time Elapsed : 11985 VT Framing Type : N/A
Medium Valid Intervals : 13 VT Signalling Mode : N/A
Medium Line Type : ShortSMF VT Grouping Type : N/A
The VT Mapping Type field shows asynchronous, so configure the line for byte-synchronous. The command is rejected because of existing links. List the links then delete them.
Unknown.7.PXM.a > cnfln -sonet 15.1 -tm 2
ERROR: There are links on the line, remove links first
Unknown.7.PXM.a > dsplink 15.1
Line Num VtNum RowStatus TargetSlot TargetSlotLine FramingType
======== ====== ========== ========== ============== ===========
Unknown.7.PXM.a > delslotlink 11 0
Proceed with configuring the line for byte-synchronous tributary mapping and check the configuration. Note that Framing Type and Signaling Mode take on the default values now that the tributary mapping has become byte-synchronous.
Unknown.7.PXM.a > cnfln -sonet 15.1 -tm 2
Unknown.7.PXM.a > dspln -sonet 15.1
Loopback : NoLoop APS enabled : Disable
Frame Scrambling : Enable RDI-V Type : one bit
Xmt Clock source : loopTiming RDI-P Type : one bit
Line Type : sonetSts3 VT Type : vt15/vc11
Medium Type(SONET/SDH) : SONET VT Mapping Type : byteSynchrons
Medium Time Elapsed : 12034 VT Framing Type : ESF
Medium Valid Intervals : 13 VT Signalling Mode : Transfer Mode
Medium Line Type : ShortSMF VT Grouping Type : N/A
Configure the line on the SRME in slot 15 for a SDH line type. Check the configuration and note the default values for SDH.
Unknown.7.PXM.a > cnfln -sonet 15.1 -slt 2
Unknown.7.PXM.a > dspln -sonet 15.1
Loopback : NoLoop APS enabled : Disable
Frame Scrambling : Enable RDI-V Type : one bit
Xmt Clock source : loopTiming RDI-P Type : one bit
Line Type : sonetStm1 VT Type : vt15/vc11
Medium Type(SONET/SDH) : SDH VT Mapping Type : byteSynchrons
Medium Time Elapsed : 12099 VT Framing Type : ESF
Medium Valid Intervals : 13 VT Signalling Mode : Transfer Mode
Medium Line Type : ShortSMF VT Grouping Type : Au3
cnfloginmsg
Configure Login Message—PXM45, PXM1E
The cnfloginmsg command lets you create a message that appears when any user logs into the switch.
Syntax
cnfloginmsg
Syntax Description
The interface prompts for a login message. The maximum length is 500 characters. The interface also instructs you to terminate message creation by putting a period on a line with no other characters on that line. See Example.
Related Commands
dsploginmsg, clrloginmsg
Attributes
Log: yes
|
State: active, standby, init
|
Privilege: ANYUSER
|
Example
Create a login message that says, "Call system administrator before using this switch." Complete the message by typing a period on a line. Check the message by using the dsploginmsg command.
M8950_DC.7.PXM.a > cnfloginmsg
Enter new Login Message (Less than 500 characters)
To complete message enter a line with only a "."
Call system administrator before using this switch
Following message will be displayed when user logs in:
Call system administrator before using this switch
Confirm entry of new message Y/N:(N) y
Storing changed Login message
M8950_DC.7.PXM.a > dsploginmsg
Call system administrator before using this switch
cnfmbsdft
Configure Maximum Burst Size Default—PXM45, PXM1E
Configures the default maximum burst size (MBS) for SPVCs on a port. The applicable service types are real-time and non real-time variable bit rate (rt-VBR and nrt-VBR).
The most likely connection type for which you would use cnfmbsdft is SVC. You can also rely on the value set with this command as a default for SPVCs if you do not specify an MBS through addcon for each SPVC of service type VBR.
The new configuration applies to new incoming calls, not existing calls. You can use cnfmbsdft whether the port is active or in the provisioning state.
Syntax
cnfmbsdft <portid> <service_category> [num-of-cell]:
Syntax Description
portid
|
The format of the PNNI physical port identifier can vary, as follows:
• On a PXM45: slot:subslot.port:subport
• On a PXM1E for UNI/NNI back card: slot:subslot.port:subport. On the UNI/NNI back card, the subslot is always 2, but the slot depends on the chassis, as follows:
– In an MGX 8850 chassis, slot is always the logical slot 7.
– In an MGX 8830 chassis, slot is always the logical slot 1.
• On a PXM1E for a narrowband service module (NBSM): slot.port.
For more details, see the section, "PNNI Format," in "Introduction."
|
service_category
|
ATM 4.0 service category—either rt-VBR or nrt-VBR.
|
num-of-cell
|
The units of measure for MBS are cells.
Range: 0-2147483647 cells Default: set by the platform to 1024 cells.
|
Related Commands
dspmbsdft
Attributes
Log: yes
|
State: active
|
Privilege: GROUP1
|
Examples
Configure a default MBS of 10000 cells for nrt-VBR.
cnfmbsdft 11:2.1:1 nrtvbr 10000
cnfname
Configure Name—PXM45, PXM1E
The case-sensitive node name must begin with a letter. It can include:
•
Up to 32 letters or numbers
•
Two special characters ("_" and "-")
•
No spaces
After you enter the name, the system prompts for confirmation. To see the name, use dspcds (or many of the other node-level display commands): the node name is the first item in the display.
Note
Although 32 characters is the maximum, Cisco recommends that you not exceed 20 characters. A node name greater than 20 characters causes the configuration save and restore features to fail.
Syntax
cnfname <node name>
Syntax Description
node name
|
The node name can contain up to 32 alpha-numeric characters.
|
Related Commands
None
Attributes
Log: yes
|
State: active
|
Privilege: SUPER_GP
|
Example
Configure the node name to be "MGX8850." The system requests you to confirm the name. The CLI prompt returns with the new name. In this example, however, the name as it appears in the prompt is truncated to eight characters because of space limitations for information displayed in the prompt.
NODENAME.7.PXM.a > cnfname MGX8850
This node name will be changed to MGX8850. Please Confirm
Do you want to proceed (Yes/No)?
cnfncdp
Configure NCDP—PXM45, PXM1E
The cnfncdp command lets you change the clock distribution mode at the switch level. The choices are manual mode and Network Clock Distribution Protocol (NCDP). At every switch that you plan to use NCDP, you must enable it through the cnfncdp command. (See Syntax and Syntax Description for the optional parameters.) A switch can use only one distribution mode, and the default mode is manual. The unused mode is disabled. Normally, if you enter a command that applies to the mode that is disabled, the controller rejects the command. Although the two modes are mutually exclusive, the configuration for each mode is saved. If you return a switch to its previous distribution mode, the previous configuration is operational.
Note
NCDP does not apply to the transmit clock for the lines on a Service Resource Module (if the SRM if configured with physical lines). Use the cnfsrmclksrc command for SRM lines,
For manual clock distribution, use cnfclksrc and related commands to modify, view, or delete clock sources. If you upgrade from Release 2.1 to Release 3 or later software, the switch comes up in manual clock distribution mode and has the previous configuration for manual distribution.
Note
You can pre-configure NCDP clock sources. You can set up a BITS by using the cnfncdpclksrc command before changing from manual mode to NCDP. This pre-configuration helps prevent loss of reliable, network-wide synchronization when you cut over to NCDP.
The manual and NCDP modes require some configuration at each switch. Regardless of the mode, a switch can synchronize to any of the following:
•
The free-running oscillator on a PXM
•
A Building Integrated Timing Source (BITS) connected to a PXM
•
A PNNI port or an interface that supports synchronous clock recovery
If you select NCDP, the optional cnfncdp parameters let you configure as needed the following values:
•
The greatest number of hops between any two nodes in the clocking domain
•
The number of milliseconds between transmission of configuration PDUs
•
The number of milliseconds to wait before sending the next configuration PDU
•
The interval for which the topology change notification bit is sent in the configuration PDUs
Note
An NCDP clocking domain crosses peer group boundaries.
NCDP synchronizes each switch to a single root (or master) clock reference. When you first enable NCDP on more than one switch, it automatically selects the oscillator on one of the switches to be the root of a network clock spanning tree. (On the other hand, if you have pre-configured an external source, NCDP becomes enabled with that source.) When you further configure clock source priorities and a possible BITS device, NCDP again identifies the best source according to your parameter entries.
With each change in NCDP clock state—such as node reset or introduction of a BITS device—it uses the values in the following hierarchy to select a root.
1.
Clock priority
2.
Stratum level
3.
ID of external source or internal oscillator (external is ranked higher priority)
4.
ATM address serves as a tie-breaker if all others are equal, with lowest address winning (assuming this ATM address is unique—a unique address prevents serious problems)
After NCDP determines the default root clock source, it identifies that root to every node in the network.
NCDP ensures that all nodes have a record of the entire spanning clock tree. Thus, each node has a record of the node with the root (or "best") clock source and gets its root source from that node. The maximum number of hops to that master clock node is configurable.
The default clock source under NCDP—a free-running, internal oscillator—is sufficient for a small network. However, the concept of the "best" clock source actually becomes meaningful when you connect a BITS clock or define clocking domains.
Note
If you run the switchcc command, the clock manager momentarily does not have not information about the best clock source. Therefore, the active PXM uses the internal oscillator as a clock source for about one second.
To create clocking domains or to configure a BITS clock, NCDP provides the following commands:
•
Use cnfncdp to specify the size of the clocking domain and set various PNNI-related timers.
•
Use cnfncdpclksrc to specify a BITS source (or other external clock), a priority for that clock source, and a stratum number for the external source.
•
Use cnfncdpport to do any of the following:
–
Specify characteristics of an NCDP signaling channel
–
Modify the administrative cost of a port to influence route selection
–
Disable NCDP on an NNI port to form a boundary for the clocking domain
Syntax
cnfncdp [ -distributionMode {ncdp | manual] [-maxNetworkDiameter hopcount]
[-hello milliseconds] [-holdtime milliseconds] [-topoChangeTimer milliseconds]
Syntax Description
If the distribution mode is manual, only the -distributionMode parameter is meaningful. If you enable NCDP, all other parameters become meaningful.
-distributionMode
|
Specify the distribution mode as NCDP or manual. If manual, use the cnfclksrc command and related commands for network synchronization. When you specify NCDP mode, it is enabled at all nodes and all ports. To disable NCDP at a specific port, use the cndncdpport command.
Possible entries:
• 1 for NCDP or just "ncdp"
• 2 for manual clocking or just "manual"
Default: manual
|
-maxNetworkDiameter
|
The network diameter is the maximum number of hops between any two nodes in a clocking domain.
Range: 3-200
Default: 20
|
-hello
|
NCDP informs each network node of the clock characteristics of all other nodes through the exchange of Hello packets. The hello parameter lets you modify the number of milliseconds between transmission of Hello packets.
Range: 75-60000 milliseconds
Default: 500 milliseconds
|
-holdtime
|
The holdtime parameter lets you specify the number of milliseconds the switch waits before it transmits the next configuration PDU.
Range: 75-60000 milliseconds
Default: 500 milliseconds
|
-topoChangeTimer
|
The holdtime parameter lets you specify the number of milliseconds the switch waits before it transmits a topology change notification bit in the next configuration PDU.
Range: 75-60000 milliseconds
Default: 500 milliseconds
|
Related Commands
cnfncdpclksrc, cnfncdpport, delncdpclksrc, dspncdp, dspncdpclksrc, dspncdpclksrcs, dspncdpport, dspncdpports
Attributes
Log: yes
|
State: active
|
Privilege: SUPER_GP
|
Example
Configure the current switch to be in NCDP mode and set the maximum network diameter to 50.
M8850_LA.8.PXM.a > cnfncdp -distributionMode 1 -maxNetworkDiameter 50
cnfncdpclksrc
Configure NCDP Clock Source—PXM45, PXM1E
The cnfncdpclksrc command lets you configure clock sources so that NCDP selects the clock source you want to serve as the best (or root or master) source. The primary use of this command is for specifying external clock sources. To do so, you indicate a high priority and stratum level for the external source. NCDP uses these values to determine the best clock source in the network and build the spanning clock tree. An external source can be a Building Integrated Timing Source (BITS) device connected to a PXM or—much less commonly—a UNI port somewhere on the switch.
Note
If no external sources exist, the only reason to use the cnfncdpclksrc command is to identify the internal oscillator of a particular node as the best source. You can also identify other back-up nodes.
External Clock Sources
Even with external sources, you do not need to use the cnfncdpclksrc command at each node (although you must enable NCDP at each node by using the cnfncdp command). You can specify a small number of external sources and, if desired, one or two internal sources as backup for unlikely failure scenarios and leave it to NCDP to utilize the priorities as needed. If every configured source were to fail—leaving all internal oscillators in the network with the same priority—NCDP would use the ATM address of each node as a tie-breaker to select and propagate a root clock.
Internal Clock Sources
You can direct NCDP to select the internal oscillator of a particular node as the root for the following reasons:
•
No BITS devices exist in the network.
•
All external sources fail.
NCDP chooses a node as the best source whether or not you assign a priority to an internal clock. NCDP uses its usual hierarchy of values in the following list to pick a node as the root. In the case of an internal source, the pertinent values are priority and nodal ATM address, as the annotations in the list state:
1.
Priority, which you can configure through the cnfncdpclksrc command
2.
St