Advanced Region Properties

You can use this page to specify region-specific COBOL Application Server (CAS) properties.

The properties are split into feature groups that are displayed irrespective of the region's configured features.

Click Apply to save the modified properties and apply the changes to the startup configuration.

Click Show Dynamic to toggle the display of dynamic properties.

Click Install to apply the modified properties to the running region. Only dynamic properties can be modified and installed for a running region.
Note: These changes will not be applied to the startup configuration.
NAME
The name of the property.
VALUE
The specified value for the property, this field can be modified by double-clicking it and typing a new value or checking, depending on the data type.
ACTIVE VALUE
The specified active value for the property, the active value is the value currently being used for the started enterprise server region. This can be dynamically changed for some properties.
Note: The VALUE is the value that will be used the next time the enterprise server region starts.
METADATA
dynamic
This identifies whether a property can be dynamically updated or not. That is, it identifies if the variable can be viewed and updated whilst the region is running.
pac-wide
This identifies if a property is synchronized across the PAC for PAC or PFORCE updates. See ES Control for more information on the scope of values.
legacy-env
This specifies the legacy environment variable name of the property which will be overridden if applied to the startup configuration or installed. See Environment variables in alphabetical order for more information.
no-env-expansion
If set, this prevents the expansion of environment variables for a string type property, for example, $TXRFDIR.
DEFAULT VALUE
This is the default value of the property.
VALIDATION RULES
This indicates the valid value(s) or value range that can be specified for the property.
DATA TYPES
The property can be one of the following data types:
  • boolean
  • enum
  • integer
  • string
Note: There is an order of precedence for initial property values, ranked from highest to lowest:
  1. PAC-wide configuration provided by the PSOR.
  2. Any specified legacy environment variables.
  3. Data from MFDS used in the startup configuration.

The configuration for the CAS properties are stored in the cas.json file, located at %ProgramFiles(x86)%\Documents\Micro Focus\Enterprise Developer\etc\configdefinitions (Windows), or $COBDIR/etc/configdefinitions (UNIX). Micro Focus recommends that you do not modify the cas.json file directly.

Remember: PAC members must be configured consistently. When considering an upgrade to the product version, Micro Focus recommends that you run the caspac -aCheckCompat command to validate that PSOR recovery will take place. See Performing a Product Upgrade to a PAC Environment for more information.