The UTM administration functions provided by the program interface for administration purposes are called using the KDCADMI function. You can pass pointers to four different data areas to UTM when calling KDCADMI. They are:
the parameter area (parameter_area)
In the parameter area you can tell UTM which operation it is to execute. This means, for example, that you can instruct UTM to return information on objects or operation parameters of the application, add an object to the configuration, change the properties of objects or delete an object.
If the operation is to be carried out on a certain object or group of objects, then you must specify the object type of the object(s) in the parameter area.
Once it has executed or initiated a task to carry out the operation, UTM stores the return code and the length of the data returned in the parameter area. The return code informs you whether the call was successful or unsuccessful.the identification area (identification_area)
You require the identification area to specify the object names if, for example, an object is to be deleted from the configuration, an object’s properties are to be changed or object properties are to be output. In this case, you will, in the identification area, need to pass all data required by UTM to uniquely identify the objects to be administered.
the selection area (selection_area)
In the selection area, you can pass selection criteria to UTM when querying information (see the KC_GET_OBJECT operation). UTM will then only return information on those objects meeting the selection criteria.
Example: information on all users currently signed onto the application.the data area (data_area)
In the data area you can pass to UTM the information that it needs, for example the names and properties of new objects if you are adding new objects to the configuration.
UTM then returns the requested information to the program in the data area, e.g. when outputting object properties.