CANCEL

When a CANCEL verb is executed, the following steps are performed:

  1. If a CANCEL ALL statement is executed, all loaded programs that are inactive are set to the not loaded state.
    Note: The CANCEL_ALL_DLLS configuration variable can be used to exclude DLLs and shared object libraries from the results of a CANCEL ALL statement. See Appendix H. Configuration Variables for more information.
  2. Otherwise, the list of active programs is searched for a matching call name. If found, an active program is being canceled and the CANCEL is ignored.
  3. Next the list of loaded but inactive programs is searched for a matching call name. If found, this program is set to the not loaded state.
  4. If no matching programs are found, the CANCEL verb has no effect. This is not considered an error.

By default, placing the canceled program in the not loaded state (initial state) includes removing the program from memory. However, if the logical cancel mechanism is enabled, the canceled program is cached in memory. For more information, see Memory Management.