The Predefined Attribute Extended (PdAtXtd) object class is used to supplement existing device's attributes represented in the Predefined Attribute (PdAt) object class with information that can be used by Device Management User Interface. For AIX release 4.3.0, the WebSM Device application will be the first user interface application to take advantage of this object class.
Not all existing device's attributes in PdAt need to be represented in the PdAtXtd object class. Non-displayable attributes (i.e with a null string in the 'generic' field of the PdAt object class) should not have a corresponding PdAtXtd entry, otherwise, it will become displayable.
The PdAtXtd object class can also be used to override the current value or possible values of an attribute.
The Predefined Attribute Extended object class contains the following descriptors:
ODM Type | Descriptor Name | Description | Required? |
ODM_CHAR | uniquetype | Unique Type | Yes |
ODM_CHAR | attribute | Attribute Name | No |
ODM_CHAR | classification | AttributeClassification | No |
ODM_CHAR | sequence | Sequence number | No |
ODM_VCHAR | operation | Operation Name | No |
ODM_VCHAR | operation_value | Operation Value | No |
ODM_VCHAR | description | Attribute Description | No |
ODM_VCHAR | list_cmd | Command to list Attribute value | No |
ODM_VCHAR | list_values_cmd | Command to list Attribute values | No |
ODM_VCHAR | change_cmd | Command to change Attribute value | No |
ODM_VCHAR | help | Help text | NO |
ODM_VCHAR | nls_values | Translated Attribute values | No |
These descriptors are described as follows:
Unique Type | Identifies the class-subclass-type name of the device to which this attribute is associated. This descriptor is the same as the Unique Type descriptor in the PdAt object class. | ||||||||||
Attribute Name | Identifies the device attribute. This is the name that can be passed to mkdev and chdev configuration commands and device methods in the attribute-name and attribute-value pairs. | ||||||||||
Classification | Identifies the device atttribute's classification. The followings characters are valid values:
| ||||||||||
Sequence | Identifies the number used to position the attribute in relation to others on a panel/menu. This field is identical to the 'id_seq_num' currently in the sm_cmd_opt (SMIT Dialog/Selector Command Option) object class. | ||||||||||
Operation | Identifies the type of operation associated with the unique device type. Operation and attribute name fields are mutually exclusive. The following operation names are used by WebSM Device application:
| ||||||||||
Operation Value | Identifies the value associated with the Operation field. For WebSM Device Application, when the operation is 'assign_icon', the value in operation_value will be the name of the icon associated with the unique device type. The icon name is the first extension of the icon file name under /usr/websm/codebase/images directory.
When the operation is 'add_<device>', the operation_value field may contain the command used to make the device, if the 'mkdev' command cannot be used. However, WebSM Device Application will invoke the command stored in this field with the same arguments normally passed to the 'mkdev' command. | ||||||||||
Description | Identifies the attribute's description. WebSM Device Application expects this field to be of the following format: message file,set id,msg id,default text | ||||||||||
List Cmd | Identifies the command to issue to override the attribute's current value, except when operation field is set, then it will be the command to issue to return information associated with the operation. For example:
In the case of 'add_tty' operation, the list_cmd field contains the following value: lsdev -P -c tty -s rs232 -Fdescription The string returned from executing this command will be put on the WebSM device selection panel. | ||||||||||
List Values Cmd | Identifies the command to issue in order to obtain the possible values of an attribute. The values returned will override the values field in the Predefined Attribute object class. | ||||||||||
Change Cmd | Commands used to change the attribute value if'chdev' cannot be used.
NOTE: When commands (stored in <field>_cmd) are executed to obtain information for an attribute, WebSM Device Application will always pass the device name as an argument to the command. Therefore, it is essential that the command stored in these <field>_cmd, handle this fact. Otherwise, a script can be stored in thesefields in the following manner: list_cmd = "x()\n\ {\n\ <run some command>\n\ }\n\ x " In the case of the change_cmd field, WebSM Device Application will also pass in the attribute=value pair after the first argument. | ||||||||||
Help | Help text associated with the attribute. This could be of the form:
message file,set id,msg id,default text OR a numeric string equal to a SMIT identifier tag. | ||||||||||
Nls Values | Identifies the text associated with the attribute's values. These values will be displayed in place of the values stored in the Predefined Attribute object class. This field should be of the form:
message file,set id,msg id,default text The ordering of values should match the ordering in the Predefined Attribute values field. |