GDSX Manual

Service Routines
Extended General Device Support (GDSX) Manual–134303
8-74
^SETMYTERM
^SETMYTERM
This procedure allows a task to change the object name of its corresponding SU or
LINE. If the task is converted, the DCB or LINE name and name length is updated in
the control block. If the task is not converted, only the DCB or LINE name is updated.
object-name input
INT:ref:16
is the SCF object name (not the access name). This SU or LINE name is assigned to
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.
length input
is the length in bytes of the SCF object name to be set. If the task is converted, the
16-word buffer must contain a name in external format. If the name is less than 32
characters, the remaining buffer space must be filled with spaces.
If the task is unconverted, this parameter is not supplied. The length of the object
name is always assumed to be 24 bytes.
The following condition code settings are valid:
CALL ^SETMYTERM ( object-name !
i
,[ filenum ] !
o
,length ] ); !
i
INT:value (Use when the task is converted)
= CCE indicates that the operation was successful.
< CCL indicates that the object name cannot be changed, or the proposed name is
invalid. This code is returned if the task is converted and the length parameter is
not supplied, or is less than 1 or greater than 32. (If the task is unconverted, this
parameter is not supplied.)
> CCG does not return from this procedure.