GDSX (Extended General Device Support) Manual

Service Routines

Extended General Device Support (GDSX) Manual—529931-001

8-49

^MYTERM

processhandle output

INT .EXT:ref:10

is a pointer to the buffer to be set to the value of a null process handle (-1 in each

word).

^MYTERM

This procedure provides a task with the object name of its corresponding SU or LINE.

Use the GET^TASK^NAME procedure to get the object name of another task’s SU or

LINE.

To get the name of the home terminal for the GDSX process, call the Guardian

MYTERM procedure. MYTERM does not suspend the calling task.

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.

object-name output

INT:ref:12

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

by 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 the dcb^template or the lcb^template, depending on whether the

calling task is a DEVICE^HANDLER task or LINE^HANDLER task, respectively.

filenum output

INT:ref

is the number of the file to which the calling task is associated. This is drawn from

the variable term in tcb^template, and is the same as the terminal file number or

the LINE file number for a DEVICE^HANDLER task or LINE^HANDLER task,

respectively.

^NEWPROCESS

This procedure is used by any GDSX task to create a new process, and optionally, to

assign a symbolic process name to the process. Having USCODE call the TSCODE-

length := ^MYTERM ( [ object-name ] !

,[ filenum ] ); !