Working with Device Interface Specifications

Logical devices often provide device interfaces. A device interface represents an access point into the device. These device interfaces may be for connectivity, power, timing, or any other means of interaction with the device.

You use Logical Device and Device Interface specifications to define the various types of logical devices and interfaces in your inventory.

You create Device Interface specifications in the same manner as you create other types of specifications. See "Creating New Specifications" for more information.

You relate Logical Device specifications to Device Interface specifications on the Related Specifications tab in the Logical Device Specification editor.

When working with Device Interface specifications, see the following topics:

About Rate Codes

A rate code is an industry-recognized form of identification for transmission signals, or the speed at with data flows from one point to another, through some type of logical or physical medium. For example, a DS1 rate code refers to a transmission rate of 1.544 megabits per second (Mb/s) for T-Carrier technology.

You can associate a device interface specification with a rate code; the rate code will be applied to all new device interfaces created from the specification. The rate code on a device interface determines the technology and transmission rate the interface can support to terminate connectivity.

There are two types of validations associated with rate codes. First, Design Studio creates a problem marker if you attempt to associate a device interface specification with an incompatible rate code when parent-child relationships between the device interface specifications are defined.

The bit rate defined for a rate code associated with a child-level device interface cannot exceed a bit rate of the rate code defined at the parent level. For example, you cannot define a parent entity with a DS1 rate code (1.544 Mb/s) and define the child entity with a DS3 rate code (44.736 Mb/s) because the rate code associated with the child device interface has a bit rate that is higher than the bit rate for the rate code associated with the parent.

Additionally, Design Studio ensures that the sum of the bit rates defined for all child entities does not exceed the bit rate of the parent. For example, you cannot define a parent entity with a DS3 rate code (44.736 Mb/s) and define more than 28 child entities with DS1 rate codes (1.544 Mb/s), as the product of 29 and 1.544 exceeds 44.736, the M/bs defined for DS3.

Second, if you change the rate code associated with a device interface specification in a previously deployed cartridge in which device interface instances have been created in UIM, UIM generates a deployment error upon subsequent deployments if:

  • You changed the rate code from an existing value to a different value. For example, you cannot change the rate code value from DS3 to DS1.

  • You deleted an existing value and left the Rate Code field blank. For example, you cannot delete the DS3 value and leave the Rate Code field blank.

The error message appears in the Environment perspective Console view.

Related Topics

Device Interface Specification Editor Properties Tab

Device Interface Specification Editor

Use the Device Interface Specification editor to model Device Interface specifications.

When working with the Device Interface Specification editor, see the following topics:

Device Interface Specification Editor Properties Tab

Use the Device Interface Specification editor Properties tab to associate a rate code to the device interface.

Note:

You must import the ora_uim_basetechnologies base cartridge and add the ora_uim_basetechnologies base cartridge as a dependency to your cartridge project to have access to the delivered set of rate codes.
Field Use
Display Name Enter the name that appears in Design Studio editors and in UIM.

Design Studio supports multiple languages for this field. The field adjacent to Display Name displays your list of languages. You can define a display name for any language you select from the list.

If your preferences are set up to work in one language only, the system displays only the [default] option. See ”Defining Language Preferences” for more information.

Rate Code Displays the rate code of the device interface. Click Select to access a set of available rate codes.

If this field is populated, you can click the Rate Code link to review the attributes of the rate code.

Clear Click to remove the selection in the Rate Code field.
Select Click to select a rate code to associate with the device interface specification. Rate codes are available only if you have imported the ora_uim_basetechnologies base cartridge and added the ora_uim_basetechnologies base cartridge as a dependency to the project in which the device interface specification is saved.

Related Topics

About Rate Codes

Device Interface Specification Editor Related Specifications Tab

Use the Related Specifications tab to define and review specification relationships. Only relationships with the entity types listed in this tab are meaningful by default in UIM. If you add specifications to the Others section, you must define custom rulesets that trigger actions or behavior based on those relationships.

Section Use
Device Interfaces Lists the specifications of device interfaces that can be sub-device interfaces of device interfaces based on this specification.
Roles Lists roles to which entities based on this Device Interface specification can be assigned.
Logical Devices Lists specifications of logical devices that can provide device interfaces based on this specification.
Network Nodes Lists specifications of network nodes that can represent device interfaces based on this specification.
Others Lists specifications of entities that have a customized relationship with entities based on this specification.

Related Topics

Defining Specification Relationships

Specification Editor Related Specifications Tab