TSK ( bank-num )

Bank Task Data

This string function returns the memory parameters of the active task located within a specified memory bank.

Syntax

TSK ( bank-num [,ERR=line-ref|,ERC=error-code])

bank-num: is the integer number of the memory bank. The only valid value is 1.
line-ref: is the program line number or label to branch to if an error is produced by this function.
error-code: is a programmer-defined error code. Valid values are positive or negative whole numbers.

Bank-num of 0 is a special case of TSK. Please refer to TSK (0) for more information.

Bank-num of 2 is a special case of TSK. Please refer to TSK (2) for more information.

Bank-num of 3 is a special case of TSK. Please refer to TSK (3) for more information.

This string is dynamic. It changes as program size changes and/or new programs are
LOADed or RUN.

If bank-num is negative or greater than the number of memory banks configured on this system, an ERR=41 results.

Each task occupies its own memory bank, which is always referred to as memory bank 1 and is the only bank that the task can access.

This function returns a 6-byte hexadecimal string for each task in the following form:

Byte(s): Description
1 - 2: Always binary zero.
3 - 4: The approximate number of 256-byte pages, in binary, of program space currently used by the task specified in bytes 5 and 6.
5 - 6: A two-character task name.

PRINT DEC($00$ + X$(3,2))

prints the number of 256-byte pages of memory occupied by this task.