GDSX Manual

Service Routines

Extended General Device Support (GDSX) Manual–134303

8-39

GET^TASK^NAME

indicates the outcome of the operation. If a valid node number is found in the

process handle, the number is returned in node; otherwise -1D is returned.

processhandle input

INT .EXT:ref:10

is a pointer to a process handle.

GET^TASK^NAME

This procedure provides the calling task with the object name of another task’s SU or

LINE. The name is taken from the variable name (SCF object name) in the

dcb^template. Use the ^MYTERM procedure to get the object name of the calling

task’s SU or LINE.

name-length returned value

INT:value

is the length in bytes of the SCF object name. If the SU or LINE is unconverted, the

value returned is always 24 bytes. If SU or LINE is converted, the value returned is

always the length of the object name, with a maximum of 32 bytes.

tcb input

INT .EXT:ref

is a pointer to a task’s TCB. The TCB pool can be scanned for the TCB addresses.

See the example for the TCBADDR procedure.

name output

INT:ref:12

is the SCF object name (not the access name), whether the object was configured by

means of SCF, or the object was not configured explicitly and the object name was

derived by TSCODE from a device name. This SU or LINE name is taken from the

variable name in either the dcb^template or the line^template, depending on whether

the calling task is a DEVICE^HANDLER task or LINE^HANDLER task,

respectively.

GIVEBREAK

A task calls this procedure to give up the break ownership of the terminal it controls.

name-length := GET^TASK^NAME ( tcb !

,name ); !

CALL GIVEBREAK