You can use the KDCADMI program interface provided by openUTM to create your own administration programs specially tailored to your application. Since the administration program interface provides powerful functions which can be used individually to program your own administration programs, user-defined administration programs offer more options than the basic administration functions:
Practically all generation information is available.
On this basis, you can query, analyze and further process the information that is of practical interest to you.
Dynamic configuration calls can be used in user-defined administration programs (see below).
Formats can be used for administration dialogs.
The program interface calls are independent of the platform on which the administration program is running. It is thus possible, for example, to administer one or more UTM applications running on Unix or Linux systems or BS2000 systems from a UTM application on a Windows system, and vice versa. Since compatibility with future openUTM versions is also guaranteed, user-defined administration programs need not be adapted if you decide to switch to another platform or upgrade to new openUTM versions.
The effort involved in creating your own administration programs is minimal:
the program interface calls can be integrated into C ,C++ or COBOL program units. Both dialog and asynchronous programs are supported, and a program can contain an unlimited number of administration calls. The data structures required are already predefined and are provided in the form of header files/COPY elements.
Dynamic configuration
The KDCADMI program interface offers calls for modifying the application configuration “on-the-fly”. Clients, printers, user IDs, services, et cetera, can be added to or removed from the configuration during operation, without affecting system availability.
Corresponding KDCDEF statements can be created - online or offline - for all dynamically configurable objects (inverse KDCDEF). These statements are then provided as input for the KDCDEF generation tool, which means that all dynamic changes to the configuration can be incorporated without any problems during regeneration.
Overview: Administration functions of the KDCADMI program interface
Operation code | Function |
KC_CHANGE_APPLICATION | Replace the entire application program during operation |
KC_CREATE_DUMP | Create a UTM dump |
KC_CREATE_OBJECT | Add new objects (program units, terminals, users, etc.) to the configuration dynamically |
KC_CREATE_STATEMENTS | Create a KDCDEF control statement for dynamically configurable objects during operation (online) |
KC_DELETE_OBJECT | Delete application objects, i.e. remove them from the application configuration |
KC_ENCRYPT | Create, delete or read an RSA key pair |
KC_GET_OBJECT | Request information on the objects and parameters of the application |
KC_LOCK_MGMT | Remove cluster user file lock |
KC_MODIFY_OBJECT | Modify the properties of objects or application parameters |
KC_ONLINE_IMPORT | Import application data online |
KC_PTC_TA | Roll back transaction in state PTC |
KC_SHUTDOWN | Terminate the application |
KC_SPOOLOUT | Automatically establish a connection to printers for which messages are available |
KC_SYSLOG | Administer the SYSLOG system log file |
KC_UPDATE_IPADDR | Update the IP address |
KC_USLOG | Switch the user log file(s) to the next file generation during operation |
The following operation code is only available on BS2000 systems: | |
KC_SEND_MESSAGE | Send a system line message to one or more dialog terminals |
Sample programs
openUTM supplies the following C sample programs which demonstrate how to use the KDCADMI interface:
SUSRMAX (show Users and MAX parameter)
ENCRADM (encryption administration)
ADJTCLT (adjust tacclass tasks)
- HNDLUSR (handle user data, on BS2000 systems only)
For COBOL openUTM supplies the sample program COBUSER. Since these sample programs are provided also in the form of source code, they can be individually adapted or used as templates for your own administration programs. Alternatively, they can be used without modification, e.g. to query information on user IDs and maximum values, to change current settings, or to dynamically configure user IDs.
| For Unix, Linux and Windows systems the sample programs ENCRADM, SUSRMAX and ADJTCLT are integrated in the sample application or the Quick Start Kit, the sample program COBUSER is supplied in the utmpath under sample/src or sample\src. For BS2000 systems all sample programs are included in the library SYSLIB.UTM.070.EXAMPLE. You will find further information regarding the sample programs at the beginning of the respective source code. |
