dobj_get_attr
dobj_get_attr (dobj, attr[, idx])
Returns the value of metadata attribute attr for the object with the ACL document object handle of dobj. If the desired metadata attribute contains an array, use the optional idx to access the desired entry in the array.
To obtain a Repository API attribute, the attr parameter should have one of two formats:
• The ACL abstraction of the attribute. ACL attribute names have the format IO_ATTR_NAME, where NAME is different for a specific attribute. The attributes that can be used with this function are listed in the ACL Attribute Name column of the Attributes names for developers section of your adapter documentation. This function can accept dobj attribute names but will not accept sess attribute names.
• The repository's name for the attribute. If you supply an attribute name that does not have the IO_ATTR_NAME format, the function will pass the literal name through to the repository. Using this method, you can access attributes in the repository that are not abstracted in ACL.
If either the dobj or attr values are invalid, or the operation fails, the function places error data in $main::ioerr and returns a NULL.