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:

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:

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

}

SEE ALSO

port, stream