Kernel 8.0 APIs Banner [skip navigation]
Office of Information & Technology (OIT) Banner

KILL^%ZTLOAD: Delete a Task

Reference Type: Supported, Category: TaskMan, Integration Agreement: 10063


This API deletes a task. When a task is deleted by KILL^%ZTLOAD, the task referenced by ZTSK will not be defined in the volume set's task file. If the task was pending, it will not start, but if it had already started running, the effects of deleting its record are unpredictable.

NOTE: Tasks can delete their own records through the use of the ZTREQ output variable.



Make sure to perform the following steps before calling this API:

  1. NEW all non-namespaced variables.

  2. Set all input variables.

  3. Call the API.

Input Variables


(required) Task number of the TaskMan task to delete.

Output Variables



  • 1—Successful deletion of the task.

  • 0—Requested task number is invalid.


VA (Internet) / VA(Intranet) / OI / PD / Site Map / Terms of Use / VA Privacy Policy / Accessibility

Reviewed/Updated: August 26, 2011

If you have questions, need more information, or are having accessibility problems with this website, please contact us by E-Mail: Webmasters, Phone: 510-768-6800, or FAX: 510-768-6850.