Terminating a UTM application normally via administration

The UTM administrator terminates a UTM application normally by entering the following UTM administration command at a terminal, for example:

KDCSHUT GRACE,TIME=time

or

KDCSHUT WARN,TIME=time

or

KDCSHUT NORMAL

Applications that use distributed transaction processing should always be terminated with KDCSHUT GRACE or WARN because this allows open distributed transactions to end properly.

When the application is terminated, openUTM performs the following actions:

• All jobs still in the UTM queue are processed.

• The connections to all communication partners of the application are shut down.

• The connection to the database system is shut down.

• The KDCFILE, system log file, and user log file are brought to a consistent state and closed properly.

• All processes of the application are terminated.

You can use the corresponding WinAdmin/WebAdmin function or administration program interface function instead of the KDCSHUT command to terminate a UTM application normally.

If BCAM is terminated with BCEND, any UTM application loaded at this time will be terminated normally.

If the UTM application is being monitored by a job variable (see "Restarting after an abnormal application termination"), the first position of the job variable is set to “T” and the second to “N”.

A UTM task can only be terminated with the /CANCEL-JOB command if it is running in the non-privileged mode (TU). A program unit in an endless loop can be terminated, for example, with this command.