OSA reference

During application stage

When an OSA invocation includes a list of object instances, Server API breaks it down in the application stage and processes each object instance individually. Each execution procedure should perform its intended application as a whole or not at all.

Those that are run per attribute should just be concerned whether there will be any errors effecting the modification of that one attribute. If there are none, then the application of the attribute's change can be completed. Otherwise the application of the attribute's change should not be attempted.

Those that are run per object should be concerned whether they can complete the entire operation without error or not. If the entire operation can be completed, only then should it be done. If any error would occur then the entire application should be aborted and the error returned.

The execution procedures should return one of the following errors at the top of the error stack (other messages can be placed lower on the stack):

SCO_OSA_ERR_ACCESS_DENIED: The invoker does not have permission to run the specified operation.
SCO_OSA_ERR_DUPLICATE_MANAGED_OBJECT_INSTANCE: The class is asked to create an object that already exists.
SCO_OSA_ERR_GET_LIST_ERR: The class encounters an otherwise unspecified error in a get operation.
SCO_OSA_ERR_SET_LIST_ERR: The class encounters an otherwise unspecified error in a set, replace, replaceWithDefault, add, or remove operation.
SCO_OSA_ERR_INVALID_ARGUMENT_VALUE: The value passed to an action in a argument is illegal or out of bounds.
SCO_OSA_ERR_INVALID_ATTRIBUTE_VALUE: The value passed to an operation or filter in an attribute is illegal or out of bounds.
SCO_OSA_ERR_NO_SUCH_ARGUMENT: The value passed to an action does not exist, or has no meaning.
SCO_OSA_ERR_NO_SUCH_ACTION: The value action type passed to an action is unrecognized.
SCO_OSA_ERR_INVALID_FILTER: The filter function is unrecognized, a value is out of bounds, or otherwise meaningless.
SCO_OSA_ERR_INVALID_OBJECT_INSTANCE: The named object instance violates the naming rules.
SCO_OSA_ERR_NO_SUCH_OBJECT_INSTANCE: An operation (not create) asked to run on a non-existent object.
SCO_OSA_ERR_NO_SUCH_OBJECT_REFERENCE A create: operation asked to base new object instance on a non-existent object.
SCO_OSA_ERR_RESOURCE_LIMITATION: A failure occurs because of a resource limitation.

These can be generated by these commands:

   ErrorPush errStackVar throw messageId [argList]		Tcl
   ErrorPush(errStatus_cl *, const intlMsg_t *, ...)	C/C++

Any execution procedure returning and error stack without one of the previous errors at the top of the error stack will have the default message: SCO_OSA_ERR_PROCESSING_FAILURE placed on the top of the stack. See Error(3tlib) or Error(3sadm) for more information.