Cloudscape Properties
Page 10 of 47

cloudscape.database.defaultConnectionMode

Function

One of the user authorization properties.

Defines the default connection mode for users of the database or system for which this property is set. The possible values (which are case-insensitive) are:

  • noAccess

    Disallows connections.

  • readOnlyAccess

    Grants read-only connections.

  • fullAccess

    Grants full access.

If the property is set to an invalid value, an exception is raised.

NOTE: It is possible to configure a database so that it cannot be changed (or even accessed) using this property. If you set this property to noAccess or readOnlyAccess, be sure to allow at least one user full access. See cloudscape.database.fullAccessUsers and cloudscape.database.readOnlyAccessUsers.

For more information about user authorization, see User Authorization of the Cloudscape Developer's Guide.

CALL PropertyInfo.setDatabaseProperty(
    'cloudscape.database.defaultConnectionMode',
    '{ noAccess | readOnlyAccess | fullAccess}')

Example

-- database-wide property
CALL PropertyInfo.setDatabaseProperty(
    'cloudscape.database.defaultConnectionMode', 'noAccess')

-- system-wide property
cloudscape.database.defaultConnectionMode=noAccess

-- publishing a database-wide property
CREATE PUBLICATION APub
ADD TARGET DATABASE PROPERTY
cloudscape.database.defaultConnectionMode=
    'fullAccess'

Default

fullAccess

Scope

system-wide

database-wide (publishable)

Dynamic or Static

Dynamic. Current connections are not affected, but all future connections are affected. For information about dynamic changes to properties, see Dynamic or Static Changes to Properties.