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