dcc
dcc - configure the dcc parameters on a port.
SYNOPSIS
dcc sub-command options
DESCRIPTION
The dcc command is used to configure the DCC (Data Communications Channel) parameters associated with a SONET port. The selection of where the DCC bytes are written (SOH or LOH), the type of CRC and the time fill byte to be used are controlled.
STANDARD OPTIONS
crc
Selects the type of CRC generated in the DCC data. Available option values are:
Option |
Value |
Usage |
---|---|---|
dccCrc16 |
0 |
(default) 16-bit CRC |
dccCrc32 |
1 |
32-bit CRC |
overheadBytes
Selects the placement of DCC bytes in the SONET overhead. Available option values are:
Option |
Value |
Usage |
---|---|---|
dccSoh |
0 |
(default) Data is placed in the section overhead. |
dccLoh |
1 |
Data is placed in the line overhead. |
timeFill
Selects the type of fill byte to use. Available option values are:
Option |
Value |
Usage |
---|---|---|
dccTimeFillFlag7E |
0 |
(default) Fill blank time with 0x7E bytes. |
dccTimeFillMarkIdle |
1 |
Fill blank time with 0xFF bytes. |
COMMANDS
The dcc command is invoked with the following sub-commands. If no sub-command is specified, returns a list of all sub-commands available.
dcc cget option
Returns the current value of the configuration option given by option. Option may have any of the values accepted by the dcc command.
dcc config option value
Modify the configuration options of the dcc. If no option is specified, returns a list describing all of the available options (see STANDARD OPTIONS) for dcc.
dcc get chasID cardID portID
Gets the current configuration of the dcc for port with id portID on card cardID, chassis chasID. from its hardware. Call this command before calling dcc cget option value to get the value of the configuration option.In order for this command to succeed, the port must either be unowned, or you must be logged in as the owner of the port. Specific errors are:
- No connection to a chassis
- Invalid port number
dcc set chasID cardID portID
Sets the configuration of the dcc in IxHAL for port with id portID on card cardID, chassis chasID by reading the configuration option values set by the dcc config option value command. Specific errors are:
- No connection to a chassis
- Invalid port number
- The port is being used by another user
- Configured parameters are not valid for this setting
dcc setDefault
Sets to IxTclHal default values for all configuration options.
EXAMPLES
package require IxTclHal
set host localhost
set username user
# Check if we're running on UNIX - connect to the TCL Server
# which must be running on the chassis
if [isUNIX] {
if [ixConnectToTclServer $host] {
ixPuts "Could not connect to $host"
return 1
}
}
# Now connect to the chassis
if [ixConnectToChassis $host] {
ixPuts $::ixErrorInfo
return 1
}
# Get the chassis ID to use in port lists
set chas [ixGetChassisID $host]
set card 27
set port 1
set portList [list [list $chas $card $port]]
# Login before taking ownership
if [ixLogin $username] {
ixPuts $::ixErrorInfo
return 1
}
# Take ownership of the ports we'll use
if [ixTakeOwnership $portList] {
ixPuts $::ixErrorInfo
return 1
}
# Need to be in a DCC mode via port
port setFactoryDefaults $chas $card $port
port config -transmitMode portTxModeDccStreams
if [port set $chas $card $port] {
ixPuts "Could not port set $chas $card $port"
}
# Set to 32-bit CRC and use of Line Overhead
dcc setDefault
dcc config -crc dccCrc32
dcc config -overheadBytes dccLoh
if [dcc set $chas $card $port] {
ixPuts "Could not dcc set $chas $card $port"
}
ixWriteConfigToHardware portList
# Let go of the ports that we reserved
ixClearOwnership $portList
# Disconnect from the chassis we're using
ixDisconnectFromChassis $host
# If we're running on UNIX, disconnect from the TCL Server
if [isUNIX] {
ixDisconnectTclServer $host
}