Rules Engine properties

Previous Next

You can influence certain aspects of the behaviour of a USoft Rules Engine dynamically, that is, as part of a transaction. These aspects are referred to as Rules Engine properties.

Rules Engine properties are different from Rules Engine parameters, which alter the overall default behaviour of a Rules Engine.

They are also different from Deployment Configuration parameters set in USoft Authorizer, which are Rules Engine aspects associated with an authorised user or usergroup.

Rules Engine properties are listed in the table below. Many have an equivalent Deployment Configuration parameter.

For detailed information about each property, go to topics on the RulesEngine internal component in Definer Help (Model and Rules Guide).

Rules Engine property

Description

AllowSetManipulations

Determines whether manipulations are handled in a set-oriented fashion or not.

Application

Returns the name of the USoft application that the Rules Engine is associated with.

BatchLogLevel

Determines the log level of batch jobs.

BinDir

Returns the \BIN subdirectory of the USoft installation directory.

ConceptualFile

Returns a filepath leading to the "application.CON" file used by the Rules Engine if it is running from flat file.

ConstraintsActive

Determines whether or not table constraints, domain constraints and relationship attributes declared for the Rules Engine are applied.

Database

Returns the connect string used by the Rules Engine to connect to the database.

DefaultDateFormat

Returns a pattern representing the string format that the Rules Engine uses as a default when converting a date value to a string.

DeferRestrictiveRelationalChecks

Determines whether or not restrictive relational checks are deferred until commit time.

EndUserMsgs

Determines whether the end user message mode is to be enabled or disabled.

Env

Returns the value of one of the environment variables listed when you type the set command in a Windows command-line box.

LockForeignKeys

Determines whether or not the parent record must be locked when foreign keys are checked.

LockParentOnSeqno

Determines whether or not parent records must be locked whilst child records are being entered or edited.

MaxConstraintDepth

Determines the maximum number of recursions allowed to occur when constraints execute.

MaxDriverConditions

Determines whether or not extra conditions must be added to the main query.

NumberOfUpdateColumns

Determines what the UPDATE statements generated by USoft will look like.

OsUserHomeDir

Returns the filepath to the local home directory of the user currently logged on to the Windows operating system.

OsUserName

Returns the name of the user currently logged in on the Windows operating system.

OsUserTempDir

Returns the filepath to the local temporary directory of the user currently logged on to the Windows operating system.

Rdbms

Returns the name of the database platform that the Rules Engine runs on.

RdbmsVersion

Returns the version number of the database platform that the Rules Engine runs on.

RecordFactsCacheSize

Resets the default value given by the RecordFactsCacheSize deployment configuration property.

RowsCommitted

Returns the number of records manipulated as part of the most recent commit performed by the Rules Engine.

ShowComponentErrors

Determines whether or not component error messages are displayed.

ShowMiddlewareErrors

Determines whether or not middleware error messages are displayed.

ShowRdbmsErrors

Determines whether or not RDBMS error messages are displayed.

SystemDir

Returns the USoft installation directory.

TempTablesAtOwner

Determines whether or not temporary tables are created in the owner's schema.

UniqueKeyCheck

Determines whether or not the Rules Engine must perform unique key check in the case of non-manual data entry.

UpdateSupertypeOnInsert

Determines whether or not inserting a subtype for an existing supertype must be considered as an UPDATE on the whole constellation.

USoftLogDir

Returns the \USoft_logs subdirectory of the USoft Log Folder selected during Setup of the USoft installation.

USoftTempDir

Returns the \USoft_temp subdirectory of the USoft Log Folder selected during Setup of the USoft installation.

Version

Returns the patch version number of the USoft product used to run the Rules Service.

WaitForLock

Determines the behaviour of the Rules Engine when lock statements are sent to the database.

 

See also

Rules Engine parameters