Component:

S_Update_Process_Knowledge

part of C_WissDB_DL_API

Abstract:

This is the function to update the B_WissDB_Database with respect to process knowledge.

Parameters:

§      In: Process

        Is ASCII text of type B_Process_Update.

§      In: Request

        Must be CREATE, or REPLACE, or FORGET.

        Value CREATE means: Return with RC_seeAppErrors if at least one of the locators in Process is in use already.

§      Out: AppErrors

        If the value of B_WissDB_Database did not change, users should find a description here telling them why.

        Describe an AppError here if Request = CREATE though Process is containing lines with a minus sign in column 1.

        Describe an AppError here if Request = FORGET though Process is containing lines with a plus sign in column 1.

        Create a warning whenever an object to be deleted does not exist.

§      Out: ReturnCode is one of the following values:

–      RC_ok

–      RC_syserror

–      RC_seeAppErrors

–      RC_seeWarnings

Has to:

Implement the required update of the B_WissDB_Database, i.e.

§      Delete in B_WissDB_Database all objects X of type E_Process such that some preLocator of X is listed in Process with a minus sign.

§      For each object Z in B_WissDB_Database.E_Result reduce Z.a_of to the effect that the new value of Z.a_of is the longest preLocator of the old Z.a_of value that is still in use. Set Z.a_of to NULL if this preLocator is not a role locator.

§      Then, for each line listed in Process with a plus sign, create the corresponding E_Process object. Return with an AppError is the given Role Locator is currently not in use.

RC_ok is allowed only if the Update requested could be implemented fully. If the ReturnCode is different from RC_ok, the value of the knowledge base did not change.

Because of:

Applications of C_WissDB_DL_API need a way to update the B_WissDB_Database with respect to process knowlege described therein.