EnableAppRestrictions

Boolean

<default>

Purpose

When the EnableAppRestrictions parameter is not specified or set to the default value (false), there are no restrictions on applications that can be run on a client node. When the EnableAppRestrictions parameter is set to true, only applications specified in a [JadeClientAppRestrictions.network‑identifier] or [JadeClientAppRestrictions] section can be run, where network‑identifier relates to a NetworkSpecification parameter in the [JadeServer] section.

The following steps construct a network‑identifier from a NetworkSpecification parameter.

  1. Begin with the transport-type (TcpIp or JadeLocal).

  2. Append an underscore character (_).

  3. Append the listener-port for the TcpIp transport or the base‑name for the JadeLocal transport.

  4. For the TcpIp transport, if the host‑name or IP‑address is specified, append an underscore character followed by the host‑name or IP‑address.

Characters other than alphanumeric characters, the hyphen (-), or period (.) are ignored.

The following table shows examples of network‑identifiers constructed from NetworkSpecification parameters.

NetworkSpecification Parameter Corresponding network-identifier
TcpIp,Enabled,63001 TcpIp_63001
JadeLocal,Enabled,Jade99-SHM JadeLocal_Jade99-SHM
TcpIp,Enabled,63003,172.16.1.1 TcpIp_63003_172.16.1.1
TcpIp,Enabled,63003,a.company.com TcpIp_63003_a.company.com

When a client node attempts to run an application and the parameter is set to true, the database server searches the [JadeClientAppRestrictions.network‑identifier] section for the application name and schema name. If the application name and schema name are not listed, an exception is raised.

If the [JadeClientAppRestrictions.network‑identifier] section does not exist, the database server searches the common [JadeClientAppRestrictions] section instead. If neither section exists, the application cannot be started from the client node and an exception is raised.

For details about specifying allowed applications, see the [JadeClientAppRestrictions] section.

Parameter is read when …

The database server node is next initialized.