TT_NUMBER_TO_NAME
Convert a terminal number to its name
|
|
VSupported on OpenVMS
|
|
xcall TT_NUMBER_TO_NAME(number, name)
Arguments
number
An expression that contains the Synergy DBL terminal number. (n)
name
Returned with the OpenVMS terminal name. (a)
Discussion
The TT_NUMBER_TO_NAME subroutine converts a Synergy DBL terminal number to its equivalent OpenVMS terminal name.
The conversion algorithm used by TT_NUMBER_TO_NAME is the inverse of that used by the deprecated %TNMBR routine and the TT_NAME_TO_NUMBER routine. Therefore, it is possible to convert an OpenVMS terminal name to a Synergy DBL terminal number using either of those subroutines, and then to convert back to the terminal name using the TT_NUMBER_TO_NAME subroutine. However, the terminal device name produced by this subroutine is not necessarily identical to the original device name, although the terminal device name uniquely identifies the same device.
Name must be at least 10 characters long, to hold the complete string returned by this subroutine.