openUTM is supplied with the standard administration program KDCADM in which some of the functions at the program interface for administration (KDCADMI) are implemented. The command interface for administration supports some of the functions of the program interface for administration (KDCADMI).
KDCADM provides the basic administration functions which you need in order to ensure that the application is available continuously, and to check the performance of the application. KDCADM is not able to add new objects dynamically or to delete objects from the configuration.
In order to call up individual KDCADM functions, you must assign specified transaction codes to the program KDCADM. These transaction codes are referred to as administration codes.
There is a dialog transaction code (dialog command) for each KDCADM function and an asynchronous transaction code (asynchronous command). You can therefore call the KDCADM administration functions synchronously in dialog mode or asynchronously by means of message queuing.
When you call a command you can specify operands. With these operands, you can define the type of action which is to be executed and specify the objects in the application to which the action must relate. The operands are identical for the respective dialog and asynchronous commands.
The KDCADM administration commands and their operands are described in chapter "Administration commands - KDCADM". |
Administration commands can only be entered in line mode. Similarly, administration commands are also output in line mode. It is not possible to use formats.
You will find information about the layout of output for administration in message queuing mode in chapter "Administration using commands". |
You will need to use KDCDEF to generate both the administration commands you wish to use at runtime and the administration program KDCADM. Alternatively, you can use the KDCADMI program interface to include them dynamically. You must always enter the KDCSHUT command used for terminating the application normally in the configuration for your application.
The following table contains a summary of KDCADM functions and the commands which you use to call up these functions.
KDCADM administration function | Dialog | Asynchronous |
Adjust the settings for application parameters and timers,define current number of processes for the application, establish connections to the printers for which print jobs exist, replace the entire application program | KDCAPPL | KDCAPPLA |
Exchange master LTERMs of two LTERM bundles | KDCBNDL | KDCBNDLA |
Producing diagnostic documentation, e.g. request a UTM diagnosis dump | KDCDIAG | KDCDIAGA |
Query properties of objects and the current settings of application parameters, request statistical information | KDCINF | KDCINFA |
Switch the user log file to the next file generation | KDCLOG | KDCLOGA |
Disable/enable LTERM partners, set up and shut down connections | KDCLTERM | KDCLTRMA |
Change the number of clients approved for an LTERM pool | KDCPOOL | KDCPOOLA |
Exchange load modules/shared objects/DLLs in the application | KDCPROG | KDCPROGA |
Disable/enable clients/printers, set up and shut down connections | KDCPTERM | KDCPTRMA |
Terminate the UTM application run | KDCSHUT | KDCSHUTA |
Switch the system log file (SYSLOG) of the application, activate/deactivate size monitoring, modify the control value for size monitoring, query information via the SYSLOG | KDCSLOG | KDCSLOGA |
Change the assignment of clients/printers to LTERM partners | KDCSWTCH | KDCSWCHA |
Disable/enable transaction codes (local services) | KDCTAC | KDCTACA |
Modify the maximum number of processes entitled to process jobs for a TAC class simultaneously | KDCTCL | KDCTCLA |
Disable/enable user IDs, change passwords | KDCUSER | KDCUSERA |
Only on BS2000 systems: | ||
Exchange sections of the application marked in the common memory pool for exchange. | KDCAPPL | KDCAPPLA |
Disable/enable multiplex connections, set up and shut down connections | KDCMUX | KDCMUXA |
Send a message to one or more dialog terminals | KDCSEND | KDCSENDA |
The following functions are available for the administration of server-server communication via LU6.1 and OSI TP: | ||
Set up and shut down logical connections to partner applications, switch replacement connections to OSI TP partners, disable/enable LPAP or OSI-LPAP partners, change timers for monitoring sessions and associations. | KDCLPAP | KDCLPAPA |
Set up and shut down logical connections for a session | KDCLSES | KDCLSESA |
Disable/enable a remote service (LTAC) for the local application, and adjust timer settings for monitoring the establishment of sessions/associations and their response times. | KDCLTAC | KDCLTACA |