MIB Smithy

Setting Variation Properties

Syntax:

% dbcmd set variation option value ?option value ...?

Returns:

• Nothing.

Properties:

-access access

Specifies the value of the ACCESS or MIN-ACCESS field for the variation. Accepted values are not-accessible, accessible-for-notify, read-only, read-write, write-only and read-create.

-comments text

Specifies the body of comment text that is to be associated with the record. Character sequences that start end end the comment should be omitted: these depend on the output format, and it is the responsibility of the converter to insert the appropriate sequences.

-creation-requires list

Applicable only for AGENT-CAPABILITIES and variations on OBJECT-TYPEs defining conceptual rows, this property specifies a list of references to column OBJECT-TYPE definitions in the row that must be explicitly set by a management application in order for row creation to succeed. Each reference may take any of the forms for a value reference (e.g. lowercase identifier or object identifier value), but for compatibility should always be an identifier.

-defval list

Applicable only for AGENT-CAPABILITIES variations on OBJECT-TYPE definitions, this property specifies the format and value for the variation's DEFVAL parameter. This parameter is used to specify the default value implemented by the agent for that particular object.

-description text

Specifies the body of text corresponding to the DESCRIPTION field of the variation record.

-enumdecl list

Specifies a list of name+value+comment triplets defining the set of named-number enumerations allowed by the variation's SYNTAX clause.

-enums list

Equivalent to -enumdecl for set operations.

-min-access access

Equivalent to -access for this record type.

-name valueref

Specifies a reference to the OBJECT-TYPE or NOTIFICATION-TYPE that the variation record pertains to. For MODULE-COMPLIANCE variations, this is used to specify a minimum subset of the object's semantics that must be implemented for conformance. For AGENT-CAPABILITIES statements, this is used to indicate to users and management applications exactly how the specific implementation differs from the specification.

-oid valueref

Equivalent to -name for this record type.

-range list

Equivalent to -rangedecl for set operations.

-rangedecl list

Specifies a list of min/max value pairs defining the set of discrete subranges allowed by the variation's SYNTAX clause.

-size list

Equivalent to -sizedecl for set operations.

-sizedecl list

Specifies a list of min/max value pairs defining the set of octet lengths allowed by the variation's SYNTAX clause.

-syntax typeref

Specifies only the base or derived type used in the variation's SYNTAX clause. Any existing range, size or enumeration refinements are preserved. The reference may be specified as an empty string to indicate that no SYNTAX clause should be declared for the variation.

-syntaxdecl list

Specifies the full SYNTAX information for the variation record as a list of name+value pairs suitable for use with Tcl's array set command (or as returned by array get). The format is the same as that returned for querying and setting the property of the same name for Type Assignments/TEXTUAL-CONVENTIONs. It may be an empty string to "undefine" the SYNTAX field.

-value valueref

Equivalent to -name for this record type.

-valuedecl valueref

Equivalent to -name for this record type.

-write-enumdecl list

Specifies a list of name+value+comment triplets defining the set of named-number enumerations allowed by the variation's WRITE-SYNTAX clause.

-write-enums list

Equivalent to -write-enumdecl for set operations.

-write-range list

Equivalent to -write-rangedecl for set operations.

-write-rangedecl list

Specifies a list of min/max value pairs defining the set of discrete subranges allowed by the variation's WRITE-SYNTAX clause.

-write-size list

Equivalent to -write-sizedecl for set operations.

-write-sizedecl list

Specifies a list of min/max value pairs defining the set of octet lengths allowed by the variation's WRITE-SYNTAX clause.

-write-syntax typeref

Specifies only the base or derived type used in the variation's WRITE-SYNTAX clause. Any existing range, size or enumeration refinements are preserved. The reference may be specified as an empty string to indicate that no WRITE-SYNTAX clause should be declared for the variation.

-write-syntaxdecl list

Specifies the full WRITE-SYNTAX information for the variation record as a list of name+value pairs suitable for use with Tcl's array set command (or as returned by array get). The format is the same as that returned for querying and setting the property of the same name for Type Assignments/TEXTUAL-CONVENTIONs. It may be an empty string to "undefine" the WRITE-SYNTAX field.