About Region Properties

Owing to the scale-out nature of Enterprise Server for .NET, using machine environment variables to store information for use within a running region is not possible as, normally, the execution of an application cannot be guaranteed to be carried out on a specific machine.

In order for this sort of customization to be possible, Enterprise Server for .NET allows name-value pairs to be stored in a region property file.

To create and maintain these name-value pairs, you use the region property editor.

• Open the Enterprise Server for .NET Administration UI.
• Navigate to Configuration Editors.
• To create a new file, click File > New.
• To edit an existing file, click File > Open and select the file you want to edit.
• To edit a name-value pair, double-click in the name or value column and enter or change the text.
• When you have finished editing, click File > Save.

To associate a property file with a region, select the region and enter the file path and name in the Property file location field in the Properties pane.

You can then enter the editor directly, using the Edit Property File in the Actions tab on the right hand side.

At region startup, the Region Property file is read and the information is available to the running region. Changes to the properties are not dynamic, so you need to restart the region for them to come into effect.

To access the information from within a running region, you can use the MicroFocus.SEE.SEP.Public.SEPInfo.GetPropertyValue() method to retrieve a value from the region properties.

Assuming:

• a name-value pair with a name of "mykey" and a value of "myvalue" is configured in the region property file
• the property file is associated with the region
• the MicroFocus.SEE.SEP.Public assembly is referenced in the project

declare myValue as string
set myValue to type SEPInfo::GetPropertyValue("mykey")