Kernel V. 8.0 APIs Banner [skip navigation]
VHA Office of Information - Health Systems Design and Development (HSD&D) Banner

ISQED^%ZTLOAD: Return Task Status

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

Description

This API returns whether a task is currently pending. Pending means that the task is scheduled, waiting for an I/O device, waiting for a volume set link, or waiting for a partition in memory. It also returns the DUZ of the task's creator and the time the task was scheduled to start.

Format

  ISQED^%ZTLOAD

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

  1. NEW all of the following variables.

  2. Set the input variables you want changed.

  3. Call the API.

If you do not follow these steps, the variables could unintentionally assume the values of the variables of the current running task.

Input Variables

ZTSK:

(required) Task number of the task to look up. The task must be currently defined on the volume set to be searched, or the lookup fails.
ZTCPU:

(optional) The volume set TaskMan should search for the task being looked up. If not passed, TaskMan searches the current volume set. Unlike ^%ZTLOAD's ZTCPU input variable, this one doesn't accept a second :-piece specifying the CPU. It only specifies a volume set to search.

Output Variables

ZTSK(0):

ZTSK(0) is returned as follows:

  • 1—Task ZTSK is currently scheduled or waiting on volume set ZTCPU.

  • 0—Task ZTSK is not currently scheduled or waiting on volume set ZTCPU.

  • NULL ("")—The lookup was unsuccessful.
ZTSK("E"):

(sometimes returned) The error code, returned when some error condition prevented a successful lookup. The codes and their values are:

  • IT—The task number was not valid (0, negative, or non numeric).

  • I—The task does not exist on the specified volume set.

  • IS—The volume set is not listed in the VOLUME SET file (#14.5).

  • LS—The link to that volume set is not available.

  • U—An unexpected error arose (e.g., disk full, protection, etc.).
ZTSK("D"):

(sometimes returned) The date and time the task was scheduled to start, in $HOROLOG format. It is returned only if ZTSK(0) equals zero (0) or 1.
ZTSK("DUZ"):

(sometimes returned) Holds the DUZ of the user who created the task. It is returned only if ZTSK(0) equals zero (0) or 1.

Example

 
	 
 
 
 
	 
 
		
 
		  
			 

			 

				VA 
                (Internet) /
				 
				VA 
                (Intranet) /
				 
				OI /
				 
				
				 HSD&D /

				Site Map /

				Terms of Use /

				VA Privacy Policy
			    /

				
                Accessibility
 
  
 Reviewed/Updated: 
             November 14, 2006
				

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.