NET/MASTER Network Control Language (NCL) Reference Manual

TEXTTOSSID
Built-in Functions
106126 Tandem Computers Incorporated 4–83
TEXTTOSSID The TEXTTOSSID built-in function translates an external format string to an internal
format SSID.
TEXTTOSSID( 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 SSIDTOTEXT, which does the reverse of TEXTTOSSID.
An error results if an invalid or null string is supplied.
Examples
In the following example, both long and short external SSIDs are defined. The built-in
function TEXTTOSSID is used to create both long and short forms of the
corresponding internal forms of these SSIDs. Finally, the complementary built-in
function SSIDTOTEXT is coded to translate these internal SSIDs to both the short and
long forms of external strings respectively. All the resulting strings and SSIDs are
displayed:
TEXT_TO_SSID: 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 TEXT_TO_SSID