DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 
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.
Next topic: Execution procedure data structures
Previous topic: During validation stage

© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 27 April 2004