getProfileString

getProfileString(fileName: String;
                 section:  String;
                 keyName:  String;
                 default:  String): String;

The getProfileString method of the Node class retrieves a parameter (key name) string from the specified section of the Jade initialization file on the application server workstation when the application is running in Jade thin client mode.

The key name string is returned on the specified node instance, which does not have to be the current node. If you require the key name on the current node, use the node environmental object (system variable).

If the application is not running in Jade thin client mode, this method functions like the Application class getProfileStringAppServer method or process.getProfileString; that is, it returns the specified profile string from the workstation in which the application or process is running.

The setProfileString method copies the string into the specified section of an initialization file on the node.

Use the Application class getProfileString method or Process class getProfileString method to obtain the file from the application server.

The parameters for the getProfileString method are listed in the following table.

Parameter Specifies the…
fileName Initialization file. If you set this parameter to windows, the win.ini file on the application server workstation is used. If it does not contain a full path to the file, Windows searches for the file in the Windows directory on the application server.
section Initialization file section containing the key (parameter) name.
keyName Name of the key (parameter) whose associated string is to be retrieved.
default Default value for the specified key if the key cannot be found in the initialization file.

You can return all initialization file sections or all parameters in a section, by using the JadeProfileString category global constants listed in the following table.

Global Constant Specified in the… Returns all…
ProfileAllKeys keyName parameter Key (parameter) strings in the initialization file section, separated by spaces
ProfileAllSections section parameter Initialization file sections, separated by spaces

You can use this method to retrieve a string from a two‑level section name (prefixed with a unique identifier) within a Jade initialization file shared by multiple programs on the same application server host. For details, see "Two‑Level Section Names" under "Format of the Jade Initialization File", in the Jade Initialization File Reference.