Within the currently active session sesshdl, this function sets the attribute attr to the value value.

If the specified attr is a repeating attribute, you can supply a string with the attribute name and array index (for example, attrname[idx]) to set the desired entry in the array.

To set an attribute value, attr should have a format of IO_ATTR_NAME, where NAME is different for a specific attribute. The session 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 sess attribute types and will not accept dobj attribute types.

If the operation fails, the function writes error data to $main::ioerr and returns a zero (0). If successful, the function returns a one (1).