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.