DEC ATM Chassis MIB

This module defines a portion of the management information base (MIB) for DEC ATM switches, including GIGAswitch/ATM.

System Group
Slot Scalars
Slot Table
Slot Management Table
Port Table
LED Interesting Changes
Slot LED Table
Port LED Table
Clock Card
Power System Controllers
Maximum Power Supplies
Power Supply Table
Battery
Temperature
Fan Speed
Fan Table
FPPN Table
Load Group
Chassis Trap Table
Help URL

System Group 

UP_ARROW138B.GIF (883 bytes)
This group is mandatory.

Field Descriptions

decAtmSysType Indicates the overall type of chassis.
decAtmKeyswitchPosition Indicates the position of the keyswitch. The keyswitch position determines the type of access allowed to network management and to out-of-band management.

For SNMP access, 'secure' means no SNMP access. 'Local' means read-only SNMP access. Other values allow read-write SNMP access. Access is still subject to community string, IP address, and privileged port restrictions.

Now that I think about it, the 'secure' value (which was copied from GIGAswitch/FDDI) is silly. If the keyswitch is in that position, you will not be able to read <this> object (unless SNMP makes a special exception).

 

Slot Scalars

UP_ARROW138B.GIF (883 bytes)
This group is mandatory. It provides information about the line cards that are currently installed in the chassis.

DEChub 900 modules such as the ATMswitch900F and ATMswitch900T do not have card slots, but will be treated as one-slot switches for MIB purposes.

Field Descriptions

decAtmSlotNumber The number of slots in the box.
decAtmMasterLinecardSlot Identifies the slot that the master line card occupies. A value of 0 will be returned if a master has not been chosen, or if the concept of a master line card has no meaning for the chassis.
decAtmStandbyLinecardSlot Identifies the slot which the standby master occupies. A value of 0 will be returned if a standby master has not been chosen, or if the concept of a standby master has no meaning for the chassis.

 

Slot Table

UP_ARROW138B.GIF (883 bytes)
The Slot Table describes the current configuration of the box. Each entry contains the description and status of one Line card.

Field Descriptions

decAtmSlotIndex The slot number. Varies from 1 to decAtmSlotNumber.
decAtmCardStatus The status of the card. If the value is read as 'notPresent(1)', then the entire entry  should be considered invalid.

Writing a value of 'powerDown(2)' will cause the switch to power down the card. Writing a value of 'powerUp(3)' will cause the switch to power up the card. Writing a value of 'powerDownThenUp(4)' will cause the switch to power cycle the line card. Attempts to set any other values will result in a badValue error.

Cards which are fundamental to switch operation cannot be powered up or down through this object.

Unpopulated slots will either be 'notPresent(1)' or missing from the table, and cannot be powered up or down.

decAtmCardType The type of the card.
decAtmCardHasModPhys Indicates whether the line card has modular physical connectors.
decAtmCardHwRev The hardware revision of the card.
decAtmCardFwRev The firmware revision of the card.
decAtmCardFault Contains a diagnostic code which may aid in troubleshooting faulty cards. Meaningless if decAtmCardStatus is not equal to 'fault'.

 

Slot Management Table

UP_ARROW138B.GIF (883 bytes)
The Slot Management Table provides a place to store network management information for cards with their own agents -- such as the GIGAswitch/2000.

Each entry contains management information for one line card.

Field Descriptions

decAtmSlotMgmtIndex The slot number. Varies from 1 to decAtmSlotNumber.
decAtmSlotMgmtAddress The IP address of the line card's SNMP agent. This field should be set to zero if the value is not applicable or not known.

 

Port Table

UP_ARROW138B.GIF (883 bytes)
This group is mandatory. It provides information about the ports that are currently installed.

Field Descriptions

decAtmPortIndex The port number. Varies from 1 to the number of ATM ports on the line card.
decAtmPortConnector The type of physical layer hardware currently in use by this ATM port.

 

LED Interesting Changes

UP_ARROW138B.GIF (883 bytes)

Field Descriptions

decAtmLedInterestingChanges This counter may be polled to determine if any interesting changes in the decAtmSlotLedTable or decAtmPortLedTable have occurred.

 

Slot LED Table

UP_ARROW138B.GIF (883 bytes)
A list of LED entries, one for each module LED.  Each entry describes the state of one module LED.

Field Descriptions

decAtmSlotLedIndex Secondary index which allows us to model cards with more than one module LED. The mapping between 'decAtmSlotLedIndex' and physical LEDs will be consistent for each 'decAtmCardType'.
decAtmSlotLedDescr A textual description of the information which the LED is meant to convey. i.e.:
  • +5 Volt Power, DC Okay
  • ATM port activity
  • Diagnostic status
decAtmSlotLedProgram The decAtmSlotLedProgram string is a sequence of instructions for the LED state. The LED constantly repeats the program. Each LED state is represented by a two octet sequence where the value of the first octet of the pair indicates the color of the LED, and the value of the second octet of the pair indicates the duration in which that color will be present.

+-------+----------+ --/ /-- +-------+-------------+ |Color |Duration|           |Color |Duration  | +-------+----------+ --/ /-- +-------+-------------+

The 'color' octet may have one of the following values:

  • 0 - off
  • 1 - other
  • 2 - red
  • 3 - yellow
  • 4 - green
  • 5 - blue
  • 6 - red-blinking
  • 7 - yellow-blinking
  • 8 - blue-blinking
  • 9 - green-blinking

The value 'off' indicates that the LED is off.

The value 'other' indicates a color not covered by any others in the list.

The value of the second octet in each pair indicates the duration in which that color will be present. A value of zero indicates that the LED is off. A value of 0xff indicates that the LED is always on. Values in between 0 and 0xff indicate the duration in 10 ms ticks.

A zero length string may be returned if the LED is 'not present'. This indicates that the LED is currently not visible.

Activity LEDs are a special case. Activity LEDs are defined as LEDs which blink whenever data is received on the line. They are typically on solid under heavy activity. Since these LEDs can change rapidly, the following rules apply:

  • The initial state of activity LEDs is off.
  • If the line shows activity any time in a 10 second period, then the LED is shown as on.
  • If the line shown inactivity any time in a 10 second period, then the LED is shown as off.

See the 'pcomLedProgram' object in the DECHUB900-COMMON MIB for examples.

 

Port LED Table

UP_ARROW138B.GIF (883 bytes)
This group is mandatory. It provides information about LEDs on currently-installed line cards. LEDs are arranged into two tables:
  1. The 'decAtmPortLedTable' describes LEDs which are associated with a particular port.
  2. The 'decAtmSlotLedTable' describes LEDs which are associated with the line card as a whole.

For convenience, the LED objects use the same scheme as the pcomLedProgram object in the DECHUB900-COMMON MIB.

Field Descriptions

decAtmPortLedIndex Secondary index which lets us model ports with multiple LEDs.
decAtmPortLedDescr A textual description of the information which the LED is meant to convey. i.e.:
  • +5 Volt Power, DC Okay
  • ATM port activity
  • Diagnostic status
decAtmPortLedProgram The decAtmLedProgram string is a sequence of instructions for the LED state. The LED constantly repeats the program. Each LED state is represented by a two octet sequence where the value of the first octet of the pair indicates the color of the LED, and the value of the second octet of the pair indicates the duration in which that color will be present.

+-------+----------+ --/ /-- +-------+-----------+ |Color |Duration|           |Color |Duration| +-------+----------+ --/ /-- +-------+-----------+

The 'color' octet may have one of the following values:

  • 0 - off
  • 1 - other
  • 2 - red
  • 3 - yellow
  • 4 - green
  • 5 - blue
  • 6 - red-blinking
  • 7 - yellow-blinking
  • 8 - blue-blinking
  • 9 - green-blinking

The value 'off' indicates that the LED is off.

The value 'other' indicates a color not covered by any others in the list.

The value of the second octet in each pair indicates the duration in which that color will be present. A value of zero indicates that the LED is off. A value of 0xff indicates that the LED is always on. Values in between 0 and 0xff indicate the duration in 10 ms ticks.

A zero length string may be returned if the LED is 'not present'. This indicates that the LED is currently not visible.

Activity LEDs are a special case. Activity LEDs are defined as LEDs which blink whenever data is received on the line. They are typically on solid under heavy activity. Since these LEDs can change rapidly, the following rules apply:

  • The initial state of activity LEDs is off.
  • If the line shows activity any time in a 10 second period, then the LED is shown as on.
  • If the line shown inactivity any time in a 10 second period, then the LED is shown as off.

See the 'pcomLedProgram' object in the DECHUB900-COMMON MIB for examples.

 

Clock Card

UP_ARROW138B.GIF (883 bytes)
This group is mandatory for GIGAswitch/ATM systems. It is not necessarily applicable to other DEC ATM switches, and so is optional for them.

Note: Because clock card firmware and hardware revisions can be retrieved from the slotTable, they are not included here.

Field Descriptions

decAtmMgmtMemoryAvail The number of unused bytes of management memory available on the clock card. The management memory is used for storing management parameters.
decAtmMgmtMemoryAction This object, when read, returns a value of other(1) unless the switch is in the middle of rewriting management memory. At such times, it will return rewriting(3). The state will revert to other(1) when the action is completed.

Setting this variable to rewrite(2) will cause the switch to attempt to rewrite the management memory on the clock-card. Attempts to set this variable to all other values will result in an error.

Rewriting the management memory gets rid of duplicate duplicate entries, and thus may increase the available space. This action should be allowed to complete before you intentionally remove power from the switch.

decGigaAtmIntEthPktsSent The number of packets which the clock card has transmitted over the internal Ethernet.
decGigaAtmIntEthPktsRcvd The number of packets which the clock card has received from the internal Ethernet.
decGigaAtmExtEthPktsSent The number of packets which the clock card has transmitted over the external Ethernet.
decGigaAtmExtEthPktsRcvd The number of packets which the clock card has received from the external Ethernet.

 

Power System Controllers

UP_ARROW138B.GIF (883 bytes)
This group is mandatory for GIGAswitch/ATM systems which have Power System Controllers. It is not necessarily applicable to other DEC ATM switches and so is optional for them.

Field Descriptions

decAtmPscStatus The status of the Power System Controller (PSC).
decAtmPscFwRev The firmware revision of the Power System Controller (PSC). This is only meaningful if the PSC is present.
decAtmPscHwRev The hardware revision of the Power System Controller (PSC). This is only meaningful if the PSC is present.
decAtmPscFwImageStatus The status of the PSC firmware image. If the value of this object is downloadRequired(2), the manager should download a new firmware image to the PSC. This can be done by using objects in the gigaUpgradeSoftware group.
decAtmPscBackplaneStatus The status of the GIGAswitch backplane.
decAtmPscFaultLedProgram The decAtmPscFaultLedProgram string is a sequence of instructions for the power supply controller fault LED state.

The coding rules are as described for decAtmSlotLedProgram.

A zero-length string may be returned if the LED is 'not present', or if the state of the LED is unknown.

 

Maximum Power Supplies

UP_ARROW138B.GIF (883 bytes)
This group is mandatory for GIGAswitch/ATM systems. It is not necessarily applicable to other DEC ATM switches, and so is optional for them.  In particular, ATM switch modules designed to fit into the DEChub 900 will normally report power supply status via appropriate DEChub 900 MIBs.

Field Descriptions

decAtmMaxPowerSupplies The maximum number of entries in the decAtmPowerSupplyTable for this chassis. This may be useful in telling the difference between boxes like the single-supply and dual-supply variants of the 5-slot GS/ATM.

 

Power Supply Table

UP_ARROW138B.GIF (883 bytes)
This group is mandatory for GIGAswitch/ATM systems. It is not necessarily applicable to other DEC ATM switches, and so is optional for them.  In particular, ATM switch modules designed to fit into the DEChub 900 will normally report power supply status via appropriate DEChub 900 MIBs.

Field Descriptions

decAtmPowerIndex A unique index identifying each power supply.

For a GIGAswitch/ATM chassis, the left power supply unit always has index 1, and the right power supply unit always has index 2.

decAtmPowerStatus The status of the power supply unit.
decAtmPowerInputSource The input source of the power supply.

A value of acLine(1) is returned if the power supply is connected to an AC line.

A value of dc48V(2) is returned if the power supply is connected to a 48 volt DC (telecommunications) line.

A value of decHub(3) is returned if the module's power is being provided by a DEChub900.

A value of none(4) is returned if the power unit is not present or not powered on.

See the battery Using object to see if the battery or this power source is being used.

decAtmPowerVoltage Voltage of power supply.
decAtmPowerOutputInWatts Output power of power supply, in watts.

This is normally read-only. However, the full-sized GIGAswitch/ATM accepts both 15 and 20 amp supplies - and has no way of automatically determining which is installed.

The agent may optionally permit write access to this object, in which case the following rules apply:

  • To inform a GIGAswitch/ATM that it has a 20 amp power supply, write 1300 to this object.
    Warning: Don't do this until the new power supply is installed. Otherwise, the switch may crash and reboot.
  • To inform a GIGAswitch/ATM that it has a 15 amp power supply, write 950 to this object.
    Warning: Note that this may cause line cards to be shut down, as the switch readjusts to the lower power budget.
decAtmPowerFaultLedProgram The decAtmPowerFaultLedProgram string is a sequence of instructions for the power supply fault LED state.

The coding rules are as described for decAtmSlotLedProgram. A zero-length string may be returned if the LED is 'not present', or if the state of the LED is unknown.

decAtmPowerOkLedProgram The decAtmPowerOkLedProgram string is a sequence of instructions for the power supply OK LED state.

The coding rules are as described for decAtmSlotLedProgram. A zero-length string may be returned if the LED is 'not present', or if the state of the LED is unknown.

 

Battery

UP_ARROW138B.GIF (883 bytes)
This group is mandatory for GIGAswitch/ATM systems. It is not necessarily applicable to other DEC ATM switches, and so is optional for them.

Field Descriptions

decAtmBatteryStatus The status of the backup battery.
decAtmBatteryUsing The source of power being used for the box. The value batteryPower(2) indicates that the backup battery unit is being used to power the switch. The external power line can be any standard power supply (e.g., either AC or 48V DC telecommunications power for GIGAswitch/ATM).
decAtmBatteryCharge The charge-level of the backup battery. Meaningful only if the battery is present.
decAtmBatteryTest This shows the result of the last battery test performed. Testing the battery is risky -- the system is temporarily switched to run off the battery, so if the battery backup subsystem is not working, the system fails and restarts.

Only the value test(3) can be written. Writes of other values are erroneous.

This object is meaningful only if the battery is present.

 

Temperature

UP_ARROW138B.GIF (883 bytes)
This group is mandatory for GIGAswitch/ATM systems. It is not necessarily applicable to other DEC ATM switches, and so is optional for them.

In particular, ATM switch modules designed to fit into the DEChub 900 will normally report environmental status via appropriate DEChub 900.

Field Descriptions

decAtmCabinetTemperature The cabinet temperature. Chassis types which do not have temperature sensors will always return 'noSensor(6)'.
decAtmTemperatureWarning The value of this variable determines how the switch will respond to a condition of too high or too low cabinet temperature, or a condition of all fans being inoperative. If the value is 'heedWarning(1)', the system will be shut down when the temperature goes outside the designed limits or when too many of its fans become inoperative. If the value is 'ignoreWarning(2)', the system will continue to operate when either of these conditions occur.

Setting this variable to 'ignoreWarning(2)' lets a manager cause a system that is too hot or too cold to continue to run. This setting will also allow the system to run while no fans are operative. Managers should note that this may be detrimental to the equipment.

This object has a default value of 'heedWarning(1)'. Note that some switches may lack auto-shutdown capability; they will have a value of 'noWarningFeature(3) for this object.

decAtmTemperatureLedProgram The decAtmTemperatureLedProgram string is a sequence of instructions for the temperature LED state.

The coding rules are as described for decAtmSlotLedProgram.

A zero-length string may be returned if the LED is 'not present', or if the state of the LED is unknown.

 

Fan Speed

UP_ARROW138B.GIF (883 bytes)
This group is mandatory for GIGAswitch/ATM systems. It is not necessarily applicable to other DEC ATM switches, and so is optional for them.

In particular, ATM switch modules designed to fit into the DEChub 900 will normally report environmental status via appropriate DEChub 900 MIBs.

Field Descriptions

decAtmFanSpeed The speed of the fans. Set this variable to 'maximum(1)' for maximum cooling where noise does not matter. Set this variable to normal(2) to cause fan speeds to be under temperature control.

 

Fan Table

UP_ARROW138B.GIF (883 bytes)
A  table describing all of the fans for this chassis.

Field Descriptions

decAtmFanIndex A unique index identifying each fan.

For a GIGAswitch/ATM chassis, the left fan tray always has an index of 1, while the right fan tray always has an index of 2.

decAtmFanStatus The status of the fan.
decAtmFanFaultLedProgram The decAtmFanFaultLedProgram string is a sequence of instructions for the fan tray fault LED state. The coding rules are as described for decAtmSlotLedProgram. A zero-length string may be returned if the LED is 'not present', or if the state of the LED is unknown.

 

FPPN Table

UP_ARROW138B.GIF (883 bytes)
The Front Panel Port Number group is mandatory. It is a list of front panel port number to MIB-II interface number mappings.

Field Descriptions

decAtmFppnSlotNumber The 1-based slot number of the module.
decAtmFppnPortOfThatSlot The 1-based media connection to the module.
decAtmFppnIfIndex The assigned MIB-II ifIndex. For an ATM port, this is the ifIndex of the 'atm' interface, as opposed to the index of the AAL5 entity or the physical (SONET, DS3) interface.

 

Load Group

UP_ARROW138B.GIF (883 bytes)
This group is optional.

Field Descriptions

decAtmLoadAdminStatus This object is used to control the program load process of a device. When read, the value other(1) is returned.

When set to start-reboot (2) the device reloads the stored firmware.

When set to start-read-BootP(3) the device clears the address and host configuration file location in NVRAM and initiates a BootP read operation to find and read a new  program image.

When set to start-read-TFTP(4) the device saves the local host  address and host configuration file location in NVRAM and initiates a TFTP read operation to read a new program image. 

A device always resets during a successful load attempt. It may not reset upon unsuccessful completion of the load attempt.

decAtmLoadOperStatus The final state of the last load attempt. none(1) indicates  that no load has been attempted, ever.

This object is non-volatile. It's default value is none(1).

decAtmLoadFilename The name of the file in which to load. When the device is reading, this is the name of the file to be read. If the device can not check the file name then this object is ignored. 

The initial and default value is set by the 'bootp' operation.

decAtmLoadIpHostAddr The IP address of the host from which to load. When the device is reading, this is the IP address of the host in which the read will be directed. When the device is being written, this  is the IP address of the only host in which writes will be accepted. This object is non-volatile. The initial and default value  of this object is set by the 'bootp' operation.
decAtmLoadDevSpecific A device specific parameter which may be used to indicate detailed error information about the last attempted load.

This object is non-volatile.

decAtmConfigIpHostAddr The IP address of the host from which to load. When the device is reading, this is the IP address of the host in which the read will be directed. When the device is being written, this is the IP address of the only host in which writes will be accepted.

This object is non-volatile. The initial and default value of this object is set by the 'bootp' operation.

decAtmConfigDefaultGateway IP address of default gateway (router) to use if file IP address is off LAN. If this value is NOT set, no default will be used.

This object is non-volatile. The initial and default value of this object is set by the 'bootp' operation.

decAtmConfigFilename The name of the file to read or write. When the device is reading, this is the name of the file to be read. When the device is being written, this is the only name of the file in which a write will be accepted - provided the device can check that the file does not exist. It is the duty of the NMS triggering the device to load this object.
decAtmConfigStatus This object is used to control the reading and writing of NVRAM. When read, the value (1) is returned if no  decAtmConfigStatus action has been initiated since the last reboot. If a 'start-read' operation has been initiated, then a 'start-read-inprogress' will be returned until the start-read is complete, then a 'start-read-complete' will be returned. If a 'start-write' operation has been initiated, then a 'start-write-inprogress' will be returned until the start-write is complete, then a 'start-write-complete' will be returned.

When set to start-read(2) the device initiates a TFTP read operation to read the saved NVRAM image. When set to start-write(3) the device checks to ensure that the file name that the NVRAM image will be saved in does not exist. If this test is successful, a TFTP write operation will save the configuration.

 

Chassis Trap Table

UP_ARROW138B.GIF (883 bytes)
This table is mandatory for any agent which implements one or more of the 'decAtmChassisMIB' TRAP-TYPEs.

Write access is optional.

Field Descriptions

decAtmChassisTrapIndex The trap number. See the TRAP-TYPE definitions elsewhere in this MIB for the list of possible values. The table should only list traps which the agent implements.
decAtmChassisTrapEnabled Indicates whether the agent is allowed to send traps of this type.

 

Help URL

UP_ARROW138B.GIF (883 bytes)

Field Descriptions

decAtmChassisHelpURL This object provides a place to store the URL for the top a set of help pages.

Values written to this object may or may not be saved to flash memory; this is left up to the discretion of the implementer.