NET/MASTER Network Control Language (NCL) Reference Manual

SSIDTOTEXT
Built-in Functions
4–76 106126 Tandem Computers Incorporated
SSIDTOTEXT The SSIDTOTEXT built-in function translates an internal format SSID to an external
format string.
SSIDTOTEXT( string [, option ] )
string
specifies the string to be translated.
option
specifies a parameter that indicates the type of action to be performed. The
following options are available:
L
specifies that the long form of the translation is carried out.
S
specifies that the short form of the translation is carried out.
Considerations
See also TEXTTOSSID, which does the reverse of SSIDTOTEXT.
An error results if an invalid or null string is supplied.
Example
In the following example, both long and short external SSIDs are defined. The
complementary built-in function TEXTTOSSID is used to create both long and short
forms of the corresponding internal forms of these SSIDs. Finally, the SSIDTOTEXT
built-in function is coded to translate these internal SSIDs to both the short and long
form of external strings respectively. All the resulting strings and SSIDs are displayed:
SSID_TO_TEXT: PROCEDURE
&LONG_EXT_SSID = "TANDEM.NNM.D30"
&INT_SSID = TEXTTOSSID(&LONG_EXT_SSID,L)
&SHORT_EXT_SSID = SSIDTOTEXT(&INT_SSID,S)
SAY "&LONG_EXT_SSID = " &LONG_EXT_SSID
SAY "&INT_SSID = " &INT_SSID
SAY "&SHORT_EXT_SSID = " &SHORT_EXT_SSID
&SHORT_EXT_SSID = "PWY"
&INT_SSID = TEXTTOSSID(&SHORT_EXT_SSID,S)
&LONG_EXT_SSID = SSIDTOTEXT(&INT_SSID,L)
SAY "&LONG_EXT_SSID = " &LONG_EXT_SSID
SAY "&INT_SSID = " &INT_SSID
SAY "&SHORT_EXT_SSID = " &SHORT_EXT_SSID
END SSID_TO_TEXT