IB Statements/kill

From CometWiki

KILL statement

Syntax: KILL partition [,EXCP=statement-label]

Discussion: The KILL statement terminates a partition. The program running in the specified partition is stopped and the partition is forced to run the QMONITOR program.

The partition parameter is a string value (constant or variable) in the form "Pnn" (where "nn" is a value from 00 to 99).

The KILL statement is similar to the TERMINATE statement, but overrides all exception handling for the partition. In this sense, KILL is more powerful than TERMINATE.

KILL closes all files for the named partition, but offers no graceful way to control shutdown.

Also see ACTIVATE.

Example 1: KILL "P05",EXCP=9000

In the above example, partition P05 is terminated with the KILL statement. The program running in partition P05, if any, is terminated and the partition is forced to run the QMONITOR program. All exception handling routines in the program running in partition P05 are overridden. Example 2:

 INPUT (0) "ENTER PARTITION TO KILL:";PART$
 KILL PART$,EXCP=9999

In this example, the user-supplied partition name is terminated. In other words, the value entered by the user in response to the INPUT prompt will be substituted into the KILL statement and the program running in that partition (if any) will be terminated