TSK( ) |
Returns Entry from Task List |
TSK( { num | EVENT } [,ERR=stmtref])
Where:
num |
Desired index entry in the internal task table. Numeric expression, range 0 to n. |
EVENT |
Keyword to indicate that the return value should be a list of active event handlers. |
stmtref |
Program line number or statement label to which to transfer control. |
(The EVENT option was added in PxPlus v11.00.)
String, value of task internal task table.
The TSK( ) function returns a string value from the internal task table. The returned table entry is determined by the task number specified, num, or the presence of the keyword EVENT.
If the EVENT keyword is used, the system will return a list of all events that currently have actions associated with them. Each entry will consist of the event name followed by a TAB ($09$) and the action followed by another TAB ($09$) and a line feed ($0A$).
If the format specifying a value n is used, an error will be generated if the entry has not been set up in the task table (using a SETDEV TSK( ) directive).
SETDEV TSK( ) Add to TSK( ) List
setdev tsk()"this is table entry 0"
setdev tsk()"this is table entry 1"
print tsk(1)
->run
this is table entry 1