QPR Knowledge Base 2017.1

Appendix A: QPR .ini Files

Appendix A: QPR .ini Files

Previous topic Next topic No directory for this topic  

Appendix A: QPR .ini Files

Previous topic Next topic Topic directory requires JavaScript Mail us feedback on this topic!  

This chapter describes the contents of the qpr .ini settings files.

 

The QPR .ini files can be found in the following locations:

QPR_Clients.ini located in the C:\ProgramData\QPR Software\QPR 2017\2017.1\Clients\Settings folder.

QPR_Servers.ini located in the C:\ProgramData\QPR Software\QPR 2017\2017.1\Servers\Settings\<possible instance folder> folder.

QPR_Shared.ini located in the C:\ProgramData\QPR Software\QPR 2017\2017.1\Shared\Settings\<possible instance folder> folder.

QPR_Servers.ini and QPR_Shared.ini located in the QPR 2017 Servers installation folder contains only certain read-only settings. This is used only in the case the files under the ProgramData cannot be found. This file is read-only, so for instance QPR Configuration Manager does not modify this one.

 

Abbreviations used in the files:

UMS = QPR User Management System

SCS = QPR Metrics Server

SCC = QPR Metrics Client

PGS = QPR BizArchitecture Server

PGC = QPR Modeling Client

WAS = QPR Web Application Server

SCP = QPR Metrics Plugin (i.e. the Web  Client)

PGP = QPR Modeling Plugin (i.e. the Web Client)

 

Settings in QPR_Clients.ini

[UMS Communication] Section

Field

Field Type

Description

Connections

String

A semicolon-separated list of configured server connections. Each connection entry is a comma-separated list of the following values: Order number in the list, flag indicating whether the connection is the default connection (0/1), connection's name, server's host, and port.

 

[PGS Communication] Section

Field

Field Type

Description

Connections

String

A semicolon-separated list of configured server connections. Each connection entry is a comma-separated list of the following values: Order number in the list, flag indicating whether the connection is the default connection (0/1), connection's name, server's host, and port.

 

[SCS Communication] Section

Field

Field Type

Description

Connections

String

A semicolon-separated list of configured server connections. Each connection entry is a comma-separated list of the following values: Order number in the list, flag indicating whether the connection is the default connection (0/1), connection's name, server's host, and port.

 

[SCC Settings] Section

Field

Field Type

Description

DefaultReportFolder

String

Folder where reports are located.

DefaultReportWWWServer

String

URL where published reports will appear.

HideSplashScreen

Integer

Defines whether the splash screen is hidden on QPR Metrics client startup. 0 = splash screen is shown (default), 1 = splash screen is hidden.

EnableLanguageSpecificContent

Boolean

Defines whether multilingual modeling is in use in QPR Metrics client. 0 = multilingual modeling is not in use (default), 1 = multilingual content is in use.

LoadAllElements

Boolean

Defines when Metrics model elements are loaded from the Metrics server. 0 = each element is loaded as needed (default), 1 = all elements are loaded at once when the model is opened.

 

[XML Integration] Section

Field

Field Type

Description

SettingsFile

String

The full path and the file name of the last selected task file in XML integration.

ExportFile

String

The full path and the file name of the last selected export file.

XSLTFile

String

The full path and the file name of the last selected XSLT file.

 

[PGC Settings] Section

Field

Field Type

Description

ModelCheckLevel

Integer

Flag used in model validation. 0 = no, 1 = yes.

DefaultTemplate

String

Name and location of the default file model template, if used.

 

[Settings] Section

Field

Field Type

Description

TasksDir

String

The name of the directory where predefined integration settings files are stored (if this is missing,  the application uses the default directory, which is C:\ProgramData\QPR Software\QPR 2017\2017.1\Clients\PGIntegrationTasks.

DefaultModelingWorkDirectory

String

Defines the folder that is opened by default with Open and Save As operations for models. This setting is used until the user uses some other directory for a successful model operation. The new folder will be the default folder for the rest of the client session. In the case this setting is empty, the pgmodels folder under C:\ProgramData\QPR Software\QPR 2017\2017.1\Clients is used by default.

DefaultModelingScriptDirectory

String

Defines the folder that is opened by default when the Run command for scripts is used and populates the Run Script menu by scripts in the folder. This setting is used until the user uses some other folder for opening a script successfully. The new folder will be the default folder for the rest of the client session. In the case this setting is empty, the pgscripts folder under C:\ProgramData\QPR Software\QPR 2017\2017.1\Clients is used by default.

DefaultMetricsWorkDirectory

String

Defines the folder that is opened by default with Import and Export operations for models in QPR Metrics. This setting is used until the user uses some other directory for a successful import or export operation. The new folder will be the default folder for the rest of the client session.

DefaultMetricsScriptDirectory

String

Defines the folder that is opened by default when the Run command for scripts is used in QPR Metrics. This setting is used until the user uses some other folder for opening a script successfully. The new folder will be the default folder for the rest of the client session. In the case this setting is empty, the scscripts folder under C:\ProgramData\QPR Software\QPR 2017\2017.1\Clients is used by default .

SharePointSiteURLs

String

Defines the URL(s) of SharePoint site(s). If multiple sites are defined, the URLs need to be separated with semicolons. If this string is empty, SharePoint actions are disabled.

CMISServers

String

Defines the URL(s) of Content Management Interoperability Services AtomPub endpoint(s) used by various content management systems supporting the CMIS standard. If multiple endpoints are defined, the URLs need to be separated with semicolons. If this string is empty, CMIS actions are disabled.

Folder

String

Defines the folder where all the client logs are stored.

CacheFolder

String

Defines the folder in which cache files created by QPR client components are stored.

EnableIPv6

Integer

Defines whether Internet Protocol version 6 (IPv6) is used for opening a connection to the server. 0 = IPv6 is not enabled and IPv4 is used to open the connection (the default value), 1 = IPv6 is enabled and the client tries to open the connection to the server with IPv6.

 

[ScriptSettings] Section

Field

Field Type

Description

ScriptTimeout

Integer

Defines the default timeout value for QPR scripts that do not contain the setting in the scripts themselves. The value is the interval (in seconds) for displaying a notification about a time-consuming script being executed. Setting this to 0 disables the notification.

ClientSecurity

Integer

Defines how QPR Scripts can be executed. 0 = scripts are not allowed to run, 1 = in clients only, a confirmation is asked, 2 = in clients only, no confirmation, 3 = running scripts is allowed both in clients and in Windows Explorer, 4 = as with 3, in addition Integrated Windows Authentication is allowed.

SingleInstanceScriptAPI

Integer

Defines whether only a single SCApplication COM object (QPR Metrics client instance) should be created. If this is 0 or missing, a new client instance is created for each CreateObject call. If this is 1, an existing instance is used if it exists.

 

[SCC Log], [PGC Log], and [UMC Log] Section

Field

Field Type

Description

Threshold

Integer

Defines the log trace mode. 255 = normal trace mode, 6577 = full trace mode.

MaxSize

Integer

The maximum size of the log file in kilobytes. After the maximum size is searched, the old entries are overwritten starting from the oldest entry.

Enabled

Integer

Defines whether logging is on. 0 = no, 1 = yes.

 

[Flow Chart Print Settings] Section

Field

Field Type

Description

BlackAndWhite

Integer

Flag indicating whether the diagram is printed in black and white. 0 = no, 1 = yes.

OrganizationsOnEveryPage

Integer

Flag indicating whether organization item headers are reprinted on each page. 0= no, 1 = yes.

CheckpointsOnEveryPage

Integer

Flag indicating whether checkpoint headers are reprinted on each page. 0= no, 1 = yes.

SeparateSettings

Integer

Flag indicating whether the first page uses a separate settings. 0 = no, 1 = yes.

FixedSize

Integer

Flag indicating whether the diagram print is done in fixed size. 0 = no, 1 = yes.

FitToOnePage

Integer

Flag indicating whether the diagram print is fitted to one page. 0 = no, 1 = yes.

FitToPages

Integer

Flag indicating whether the diagram print is fitted to multiple pages. 0 = no, 1 = yes.

PrintSubprocesses

Integer

Flag indicating whether all the child diagrams are printed as well. 0 = no, 1 = yes.

LeftMargin

Decimal

Left margin used in diagram print.

RightMargin

Decimal

Right margin used in diagram print.

TopMargin

Decimal

Top margin used in diagram print.

BottomMargin

Decimal

Bottom margin used in diagram print.

ZoomTo

Integer

Value for fixed size used in diagram print.

PagesHigh

Integer

Number of vertical pages used in diagram print.

PagesWide

Integer

Number of horizontal pages used in diagram print.

Orientation

Integer

Flag indicating default printer orientation. 0 = Landscape, 1 = Portrait.

 

[Page1 / Page N Header and Footer Items 0...n] Section

Field

Field Type

Description

ItemLocation

Integer

Location of item, 0 = left, 1 = center, 2= right

PageItem

Integer

Type of the item, 0 = model name, 1 = diagram version, 2 = printing time, 3 = created, 4 = last saved, 5 = page number, 7 = file name, 8 = free text (see below), 9 = status, 10 = subprocess name

FreeText

String

Free text

FontName

String

Font name

FontSize

Integer

Font size

FontBold

Integer

Flag indicating whether the item is bolded. 0 = no, 1  = yes.

FontItalic

Integer

Flag indicating whether the item's is in italic. 0 = no, 1  = yes.

FontUnderline

Integer

Flag indicating whether the item is underlined. 0 = no, 1  = yes.

FontStrikeout

Integer

Flag indicating whether the item is struck out. 0 = no, 1  = yes.

FontColor

Integer

Color number for the item

FontCharset

String

Character set for the page header item font.

 

[QPR Custom Colors] Section

Field

Field Type

Description

Color<A-P>

String

User-defined custom colors.

 

 

Settings in QPR_Shared.ini

 

[CustomerInfo] Section

Field

Field Type

Description

FirstName

String

Customer's first name

LastName

String

Customer's last name

EntitlementID

String

Customer's Product Activation Code

Organization

String

Customer's organization

JobTitle  

String

Customer's job title

Email

String

Customer's e-mail address

Phone

String

Customer's phone number                              

AddressLine1

String

First line of the customer's address                        

AddressLine2

String

Second line of the customer's address

ZipCode

String

Customer's zip/postal code          

City                

String

Name of the city the customer lives in

Region

String

Region the customer lives in

Country

String

Name of the country the customer lives in

Comments                        

String

Customer's comments

 

[Proxy] Section

Field

Field Type

Description

UseProxy

Integer

Defines whether proxy server is used in QPR Product Activation.

Server

String

IP address of the proxy server

Port

Integer

Socket port of the proxy

 

[Activation] Section

Field

Field Type

Description

URL

String

QPR Activation server URL

EMail

String

QPR's Customer Care e-mail address for manual product activation instructions

LicencingModes

String

Supported licensing modes.

Helpdesk

String

QPR Customer Care contact information.

SilentFirstActivation

Boolean

Defines whether the first product activation is done in a silent mode.

UseSilentForTransient

Boolean

Defines whether transient product activation is done in a silent mode.

ShowTransientExpirationWarning

Integer

Defines how many days before expiration the warning is shown. Default value is 0 meaning no warnings.

 

[Servers] Section

Field

Field Type

Description

Standalone

Integer

Defines whether a standalone version is installed. 1 = yes, 0 = no. This setting controls if the corresponding server components are launched when QPR Modeling Client or QPR Metrics  client is launched. This option does not affect QPR Web Application Server or QPR Web Services Foundation.

 

[Common] Section

Field

Field Type

Description

EnableGDIPlusGraphs

Integer

Defines whether Microsoft Windows GDI+ is used in drawing charts. 1 = yes (default) 0 = no. Disable this setting if you encounter troubles in drawing charts.

GeneralLogMode

Integer

If set, defines the logging mode for all products. 0 = force normal trace mode, 1 = force full trace mode, 2 = custom mode

EnableGDIPlusBitmapGraphs

Integer

Defines whether Microsoft Windows GDI+ is used in drawing charts if UseBitmapTextInGraphicalViews is 1 or the charts have background pictures. 1 = yes (default) 0 = no. Disable this setting if you encounter troubles in drawing charts.

ClientSocketKeepaliveTimeout

Integer

Time in minutes between the sent keepalive messages when client is connected to server. This is necessary in situations where network connections are dropped after some time of inactivity. Default value is 1 minute (Windows default is 120 minutes).

ClientSocketKeepaliveInterval

Integer

Time in seconds between resends in case keepalive messages are not being acknowledged. Default value is 1 second.

ClientServerCompression

Integer

Defines whether compression is used in client - server communication. The possible values are: 0 = no compression is used except for model exports. 1 = if network connection is slower than 10Mb/s, compression is used for packets larger than 512 bytes. 2 = compression is always used for all packets larger than 512 bytes. In the case this key is missing or the value has not been defined, 1 is used by default. This setting is a client-side setting, i.e. the client computer defines the use of compression.

ForceClearTypeFontSmoothing

Integer

Defines whether clear type font smoothing is used in QPR Modeling Client diagrams even if clear type font smoothing has not been enabled in display settings, 0 = off (default), 1 = on.

 

[Fonts] Section

Field

Field Type

Description

UnicodeFontName

String

The font used in Unicode user interface controls (currently only translation dialogs for multilingual modeling) of QPR Modeling Client.

UnicodeFontSize

Integer

Size of the Unicode font.

NavigatorFontName

String

Font used in all tree navigator controls in QPR Metrics and QPR Modeling clients. This setting is useful in the case the default font for example does not support all symbols in the language used in the model.

NavigatorFontSize

Integer

Size of the navigator font.

ChartTitleFontName

String

Font used in the history chart title in QPR Metrics. This setting is useful in the case the default font for example does not support all symbols in the language used in the model.

ChartTitleFontSize

Integer

Size of the chart title font.

LegendFontName

String

Font used in the legend of the history chart view in QPR Metrics. This setting is useful in the case the default font for example does not support all symbols in the language used in the model.

LegendFontSize

Integer

Size of the legend font.

GraphFont

String

The font used in Analysis and Simulation graph views. If this setting is not defined, Tahoma is used by default. This setting can be used to correct font problems in some environments such as Thai, where for instance MS Sans Serif works fine.

GraphFontSize

Integer

Size of the graph fonts.

 

 

Settings in QPR_Servers.ini

 

[QPR Database] Section

Field

Field Type

Description

DBAlias

String

The database alias that is used by all QPR products.

DBLogin

String

QPR database's login information.

DBPassword

String

QPR database's password (encrypted).

ReconnectInterval

Integer

The amount of seconds to wait before trying to re-establish a broken database connection.

ReconnectRetryTimes

Integer

The amount of times the database connection is tried to be restored.

MassOperationRecordCount

Integer

Defines the maximum amount of records that are stored with one SQL query. By default the value is 20. All positive integers from 0 upwards are valid values for this key. This setting can be used only with Microsoft SQL Server and Oracle databases.

MassOperationMaxBlobSize

Integer

Defines the maximum size of blob fields that are stored with mass database operations. By default the value is 10000. All positive integers from 0 upwards are valid values for this key. This setting can be used only with Microsoft SQL Server and Oracle databases.

TransactionQueueWarningTime

Integer

Defines the time (in minutes) after which a warning message is inserted in the relevant log file(s). The warning is triggered in the case a transaction has been in a QPR server component's transaction queue longer than the value defined here. In the case no value has been provided or the key is missing, 120 is used as the default value.

TransactionQueueMaxTime

Integer

Defines the time (in minutes) after which an error message is inserted in the relevant log file(s). The error is triggered in the case a transaction has been in a QPR server component's transaction queue longer than the value defined here. Other database requests receive an error message telling that the database is overloaded until the transaction that triggered the warning is processed.  In the case no value has been provided or the key is missing, 600 is used as the default value.

TransactionQueueMaxTransactions

Integer

Defines the maximum amount of transactions in the transaction queue. The default value is 100, but this can be increased to allow very large modeling operations to be done within a short time period with a slow database. The limit for the amount of transactions is meant to restrict loss of data in case the server is terminated before transactions have been committed to the database.

DBConnectionKeepAlive

Integer

This setting defines the interval (in minutes) between simple read operations that are performed to keep the database connection alive. This value is 0 by default (keepalive operations are not performed), but in the case you encounter problems with servers losing database connection after a certain amount of idle time, use this key with a value that's smaller than the idle time limit in your database.

 

[WAS Settings] Section

Field

Field Type

Description

MaximumNumberOfClients

Integer

The maximum number of requests that are handled simultaneously by QPR WAS. If the amount of requests exceeds the value defined here, new requests will not be processed until the old ones have been completed.

 

If you are having problems with a multiprocessor machine, try lowering this value to 1.

MaximumNumberOfClients_PGPLUGIN

Integer

The maximum number of requests that are handled simultaneously by QPR Modeling Plugin (i.e. the Web Client). If the amount of requests exceeds the value defined here, new requests will not be processed until the old ones have been completed.

MaximumNumberOfClients_QPRPORTAL

Integer

The maximum number of requests that are handled simultaneously by QPR Portal. If the amount of requests exceeds the value defined here, new requests will not be processed until the old ones have been completed.

MaximumNumberOfClients_SCPLUGIN

Integer

The maximum number of requests that are handled simultaneously by QPR Metrics Plugin (i.e. the Web Client). If the amount of requests exceeds the value defined here, new requests will not be processed until the old ones have been completed.

MaximumNumberOfClients_QPRWAS

Integer

The maximum number of internal (for example Login procedures and error messages) requests that are handled simultaneously by QPR WAS. If the amount of requests exceeds the value defined here, new requests will not be processed until the old ones have been completed.

WebContentRoot

String

The URL for the Web Contents on the Web server. Note that http://127.0.0.1 cannot be used here if the QPR Web Application Server is accessed from other computers or the web server is installed on some other computer. This must be the IP address or the web server's server name (for example "myserver.com").

HostScriptLocation

String

The URL for the CGI-binary on the Web server. Note that a localhost address like http://127.0.0.1/cgi-bin/qpr.exe cannot be used here if the QPR Web Application Server is accessed from other computers or the web server is installed on some other computer. This must be the IP address or the web server's server name (for example "myserver.com").

SessionExpirationTimeout

Integer

The maximum idle time in seconds before the session expires and user is forced to log in again.

SessionLogoutExpirationTimeout

Integer

The time in seconds that a user's session remains active after logout. Used in demo portals, where all users use the same User information. If some user logs out, the session still remains valid for the given expiration time. Setting this value to 0 (default) makes the user's session to expire immediately after logout.

UseDefaultLoginView

Integer

Show the default or customized view in the login view. 1 = default, 0 = custom.

CustomLoginURL

String

URL of the view shown in the login view if the default login view is not used.

TemplateRoot

String

Root folder for all the template folders. If this setting has not been defined, the C:\ProgramData\QPR Software\QPR 2017\2017.1\Servers\Templates\WAS folder is used by default.

ReadOnlyMode

Integer

Defines whether Portal is in read-only mode. 0 = no, 1 = yes.

MaxMemoryUsage

Integer

Defines the maximum amount of memory in megabytes QPR Web Application Server is allowed to consume. This setting affects e.g. the amount of models cached in the memory and therefore also for instance searches. The minimum value is 128 and the maximum value is 65536.

MemoryUsageLimit

Integer

Defines the per cent value of the threshold for the MaxMemoryUsage when the memory limit has been exceeded, so that WAS will drop models from memory until memory usage is <value>% under the specified MaxMemoryUsage. The default value is 20.

IWAEnable

Integer

Defines whether Integrated Windows Authentication (IWA) is enabled for QPR Portal. 0 = false, 1 = true.

IWACGIBinaryIP

String

Obsolete. Use IWACGIBinaryHost instead.

CGIBinaryIP

String

Obsolete. Use CGIBinaryHost instead.

CachePages

Integer

Defines whether HTML pages generated by QPR Portal are cached in the browser cache. The following values can be used: 0 = never cache pages, 1 = disabled by default, i.e. pages are not cached unless explicitly requested to do so. 2 = enabled by default, i.e. pages are cached unless explicitly requested not to do so. By default the value is 1.

ForcePlainTextURLs

Integer

Defines whether QPR Portal URLs are encrypted (user account data is always encrypted regardless of this setting). 1 = plain text URLs are used, 0 = URLs are encrypted. By default the value is 1.

EnableTemplateCaching

Integer

Defines whether Portal templates are cached in QPR Web Application Server. Disabling this is helpful when customizing templates, as the templates are refreshed without restarting QPR Web Application Server. 1 = yes, 0 = no. By default the value is 1.

UIYearOffset

Integer

With this key you can define an offset (positive or negative) to be applied to the year values displayed in QPR Portal to accommodate for different calendars. Note that this setting affects only how the values are displayed, so calculations are not affected and two QPR Web Application Servers can utilize the same database with different offsets. However, negative offsets large enough to cause negative year values to be displayed in QPR Portal should not be used.

 

Note that this setting affects also situations where action attribute values of the type date are inputted. In those cases a reverse offset is applied to the values before inputting them to the database in order to maintain database consistency.

WebContentPath

String

Path where the QPR web contents are installed.

DefaultPortalMode

Integer

Defines the QPR Portal mode that is used for a user that hasn't previously logged into QPR Portal. 0 (default) = Standard Portal, 1 = Mini Portal.

HidePortalModeChange

Integer

Defines whether a button is shown in QPR Portal for changing the Portal mode between Mini Portal and Standard Portal. 0 (default) = button is shown, 1 = button is hidden.

DefaultDetailsPaneMode

Integer

Defines the default mode of the Details Pane in QPR Portal. 0 = disabled, 1 (default) = minimized, 2 = open. Note that this setting is overridden if user-specific Details Pane mode is set in QPR Portal Settings page.

HideDetailsPaneModeChange

Integer

Defines whether it is possible to change the Details Pane mode in QPR Portal or not. 0 (default) = Details Pane mode change is allowed, 1 = Details Pane mode change is not allowed.

EnableReportingView

Integer

Defines whether the Reports tab is available in QPR Portal. 0 = Reports tab not available, 1 (default) = Reports tab is available.

ReportingFileType

Integer

Defines the file types for the reports in QPR Portal. 0 (default) = Word, 1 = PDF.

StoreSessionIdToCookie

Integer

Defines whether session ID is stored in a cookie instead of URL. 0 = session ID not stored in cookie, 1 = session ID stored in cookie (default).

IWACGIBinaryHost

String

Deprecated. CGIBinaryHost is now used, but in the case this key has a value and CGIBinaryHost is undefined, the value of this key is read into the CGIBinaryHost key.

CGIBinaryHost

String

Defines the IP or hostname of the computer where QPR.isapi.dll or QPR.CGI.exe is located. This option needs to be set only when IWAEnable or EnableSSOForPortal (in UMS Settings section) is set to 1.

AuthenticationService_<1...10>

String

Defines the type and the URL of the authentication service to use with Common QPR Authentication. The value is a combination of a service type and the URL to be used, separated by a comma. For the service type, use either "WAS" (QPR Web Application Server) or "WS" (QPR Web Services Server). Example usage:

AuthenticationService_1=WAS,https://127.0.0.1/QPR2017-1/Portal/qpr.isapi.dll. Must not point to the WAS URL of the WAS whose .ini file this resides in.

EnableHtmlEmailNotification

Boolean

Defines if notification email templates for QPR Portal use HTML formatting. 0 = HTML formatting not used (default), 1 = HTML formatting used.

 

[SCP Reports] Section

Field

Field Type

Description

WebReportPath

String

Path where the published reports are stored.

WebReportURL

String

URL where the published reports are found.

ReportCommands

Integer

The amount of report commands

ReportCommand<0...N>

String

Report command's name

ReportCommandValue<0...N>

String

Report command's value.

FileExtension

String

File extension for the report files.

WebReportCGI

String

Path for an external report viewing application.

UseCGI

Integer

Defines whether an external report application is used. 0 = no, 1 = yes.

RemoveExtraFiles

Integer

Defines whether extra files are removed from the web file publishing directory at startup. 0 = no, 1 = yes

 

[UMS Communication] Section

Field

Field Type

Description

ServerName

String

Hostname or the IP address of the QPR Foundation Server.

ServerPort

Integer

Socket port of the QPR Foundation Server.

Password

String

QPR User Management System's password (encrypted).

UseEncryption

Integer

Defines whether encryption is used in communication between the QPR Foundation Server and the ser Management Client as well as between the QPR Foundation Server and other QPR server components. 0 = no, 1 = yes.

 

[SCS Communication] Section

Field

Field Type

Description

ServerName

String

Hostname or the IP address of the QPR Metrics Server.

ServerPort

Integer

Socket port of the QPR Metrics Server.

UseEncryption

Integer

Defines whether encrypted communication is used. 1 = yes, 0 = no.

 

[PGS Communication] Section

Field

Field Type

Description

ServerName

String

Hostname or the IP address of the QPR BizArchitecture Server.

ServerPort

Integer

Socket port of the QPR BizArchitecture Server.

UseEncryption

Integer

Defines whether encrypted communication is used. 1 = yes, 0 = no.

 

[WAS Communication] Section

Field

Field Type

Description

ServerName

String

Hostname or the IP address of the QPR WAS.

ServerPort

Integer

Socket port of the QPR WAS.

 

[WS Communication] Section

Field

Field Type

Description

ServerName

String

Hostname or the IP address of the QPR Web Service Server.

ServerPort

Integer

Socket port of the QPR Web Service Server.

 

[QPR Settings] Section

Field

Field Type

Description

DefaultLanguage

Integer

Default language used by all QPR products.

DefaultSubLanguage

Integer

Default sublanguage used by all QPR products. Used for distinguishing between e.g. Chinese Traditional and Chinese Simplified, which both have the same DefaultLanguage entry.

QueryResultExpirationTime

Integer

Defines the time (in minutes) for how long views with lots of list information (such as Analysis views and actions fields with lots of result rows) are cached. Updated information is guaranteed to appear in QPR Portal only after the time defined in this key has passed after the update. Note that lowering the caching time reduces performance. Setting this to 0 (default) disables the caching of query results.

QueryExpirationCheckInterval

Integer

Defines the maximum interval (in minutes) between checking whether there are query results which have expired as a result of reaching the time defined in QueryResultExpirationTime. If such results are found, they are dropped from the memory. The default value is 5.

CacheFolder

String

Defines the folder in which cache files created by QPR server components are stored.

EnableIPv6

Integer

Defines whether Internet Protocol version 6 (IPv6) is used for opening a connection to the server. 0 = IPv6 is not enabled and IPv4 is used to open the connection (the default value), 1 = IPv6 is enabled and the client tries to open the connection to the server with IPv6.

 

[WAS Blob Cache] Section

Field

Field Type

Description

OnDisk

Integer

Defines whether embedded attachments exceeding the size defined in the Threshold setting are stored in disk instead of memory. 1 = yes, 0 = no.

Threshold

Integer

The maximum size for embedded attachments (in kilobytes) that are stored in the memory. If the size is exceeded, the attachments are stored in hard disk.

 

[QPR Service] Section

Field

Field Type

Description

ServiceInstalled

Integer

Defines whether service is installed. 1 = yes, 0 = no.

WSServiceInstalled

Integer

Defines whether web services service is installed. 1 = yes, 0 = no.

StartupTime

Integer

The maximum number of seconds to wait for startup (control semaphore) before terminating the server process.

StatusCheckInterval

Integer

Number of seconds to wait between successive server responsivity checks.

ResponseTimeoutInterval

Integer

Number of seconds to wait for server process to respond to the control message.

ServerKillTimeout

Integer

Number of seconds to wait for the server process to shut down (when the service is being shut down) before terminating the process (if EnableForceKill=1).

EnableForceKill

Integer

Determines whether the server process can be terminated by force if it does not shut down in ServerKillTimeout seconds after the shutdown message has been sent (0 = false, 1 = true).

ApplicationTitle

String

Defines the name that is displayed for the application in the service list.

MaximumNumberOfStarts

Integer

Defines how many times the service tries to start in case of critical error at startup.

ExternalName

String

Name of the service used in dialogs and other user interface objects. Do not modify this value unless instructed to.

InternalName

String

Used for controlling the service. Do not modify this value unless instructed to.

InternalBaseName

String

Used for controlling the service. Do not modify this value unless instructed to.

 

[UMS Service, PGS Service, SCS Service, WAS Service, and WS Service] Sections

Field

Field Type

Description

Enabled

Integer

Defines whether service is enabled. 1 = yes, 0 = no.

ShutDownSemaphore

String

Used for controlling the service. Do not modify this value.

ShutDownMessage

String

Used for controlling the service. Do not modify this value.

ControlSemaphore

String

Used for controlling the service. Do not modify this value.

ControlMessage

String

Used for controlling the service. Do not modify this value.

CloseMessage

String

Used for controlling the service. Do not modify this value.

 

[PGS Service] Section

See UMS Service

 

[SCS Service] Section

See UMS Service

 

[WAS Service] Section

See UMS Service

 

[WS Service] Section

See UMS Service

 

[QPR Log] Section

Field

Field Type

Description

Folder

String

Defines the folder where all the server logs are stored.

AuditFolder

String

Defines the folder where all the server audit logs are stored.

 

[QPR E-Mail] Section

Field

Field Type

Description

ReplyAddress

String

E-mail address that will be used as the reply address in e-mail notifications.

AdminAddress

String

Administrator's e-mail address. This address will receive alerts and notifications about server functionality.

SMTPServer

String

Name of the SMTP server used for sending the e-mail notifications.

SMTPServerPort

Integer

The SMTP server port number used for sending the e-mail notifications. The default port number is 25.

SMTPLogin

String

Login name for the SMTP server. Used in the case SMTPAuthentication is 1.

SMTPPassword

String

Password for the SMTP server in an encrypted format. Used in the case SMTPAuthentication is 1.

SMTPAuthentication

Integer

Defines whether SMTP server authentication is used. 0 = no, 1 = yes.

EMailAlertsEnabled

Integer

Defines whether e-mail alerts are enabled. 0 = no, 1 = yes.

AlertCategories

Integer

Defines what kinds of events are alerted by e-mail. 1 = System notifications, 2 = Critical errors, 3 = both.

 

[UMS Settings] Section

Field

Field Type

Description

MaximumNumberOfClients

Integer

Used internally by UMS. Do not modify.

AuthenticationMethod

Integer

QPR Foundation Server's authentication method. 1 = QPR, 2 = NT, 4 = LDAP, or any combination of the values above. For example QPR + NT = 3

AllowProfileChangesForViewers

Integer

Defines whether Portal viewer users can change their profile information (e-mail, password, language) in QPR Portal. 0 = no (default), 1 = yes.

UserGroupManagementMethod

Integer

Defines the user group management method. 1 = Synchronized with NT/LDAP, 0 = UMS only

DefaultUserGroup

String

Name of a valid user group in UMS. This group is used as a default group in NT/LDAP syncronization. For more information, refer to the NT & LDAP Authentication chapter.

UserGroupManagementWithSSO

Integer

Defines whether users authenticated via Generic Single Sign-On are added to the default user group in UMS or not. 0 = users are not added (default), 1 = users are added. See also Using Single Sign-On with QPR Products.

PreviousAlertMsg

String

Used internally by UMS. Do not modify.

AlertCount

Integer

Used internally by QPR Foundation Server. Do not modify.

ExternalObjectCacheExpirationTime

Integer

Defines how long user rights for PG and SC model elements are cached for faster opening of action lists  under the Actions tab in QPR Portal. Note that changes done to user rights within the expiration time are not applied to QPR Portal until the cache expiration time is reached. The default value is 900 (seconds, i.e. 15 minutes).

PortalAutoLogin

Integer

Defines whether login information is stored to cookies to enable automatic relogin to QPR Portal. 0 = autologin enabled and option at login view selected by default, 1 = autologin enabled, 2 = autologin disabled.

LimitedUserVisibilityInPortal

Integer

This setting affects the users shown in the User Selection dialog in QPR Portal. In the case this is enabled, users without administrative rights to QPR User Management System see only those users who belong to at least one group the user him/herself also belongs to. 0 = disabled (default), 1 = enabled.

EnableActionChangeLog

Integer

Defines whether the change log is enabled for QPR Portal actions. 0 = disabled (default), 1 = enabled. Enabling or disabling the change log for specific action types is done in actiontypes.ini.

EnableSSOForPortal

Integer

Defines whether Single Sign On is enabled for QPR Portal. 0 = no, 1 = yes.

UpdateUserInfoAtUserSynchronization

Integer

Defines whether user information in QPR UMS is updated when a user logs in with an NT or LDAP account. When using LDAP and this setting is enabled, the information is updated also during the next synchronization if the user information has changed on LDAP. The following information is updated in the case this setting is enabled:

Full name

E-mail (LDAP only)

Telephone number (LDAP only)

Description

 

0 = disabled (default), 1 = enabled.

SynchronizationMethod

Integer

Defines how UMS synchronizes users and groups with LDAP. 0 = no synchronization (default), 1 = users in groups found in both LDAP and UMS are synchronized with a schedule defined in SynchronizationScheduleStartDate and SyncronizationSchedulerInterval keys, 2 = users in groups found in both LDAP and UMS are synchronized similarly as with SyncronizationMethod=1, but obsolete users (i.e. users not found in LDAP anymore) are moved to a group defined by SynchronizationDeletedUsersGroup setting, and in the case the group is not defined, those users are deleted, 3 = users in groups found in both LDAP and UMS are synchronized similarly as with SyncronizationMethod=1, but obsolete users that are re-added in LDAP are moved from the group defined by SynchronizationDeletedUsersGroup setting to a normal group.

 

WARNING: In the case synchronization is used, changing groups in LDAP may result in users and related data (actions, element owners) being removed from QPR UMS.

SynchronizationScheduleStartDate

Datetime (yyyy-MM-dd hh:mm)

Defines the initial start time of group synchronization which takes place if SynchronizationMethod=1 or SynchronizationMethod=2.

SynchronizationScheduleInterval

String (dd:hh:mm)

Defines the interval between group synchronization operations starting from the time defined in SynchronizationScheduleStartDate. The correct format for this setting is a colon-separated list of days, hours and minutes. For example, if SynchronizationScheduleStartDate=2008-15-01 01:15 and SynchronizationScheduleInterval=01:00:00, the first synchronization takes place on 2008-15-01 01:15 and subsequent synchronizations are done every day at 01:15.

SynchronizationExcludedGroups

String

A comma-separated list of groups which are excluded from synchronization which takes place if SynchronizationMethod=1 or SynchronizationMethod=2. In the case a user belongs to any of the groups listed in this setting, the synchronization does not affect that user. Note that the group name must be contained in double quotes in the case the name contains spaces.

SynchronizationDeletedUsersGroup

String

Name of the group where users not found in LDAP are moved during synchronization (occurs if SynchronizationMethod=2). If this is empty, the affected users are deleted from QPR UMS. By default this is "#Deleted users#".

EnableClientAuthenticationUsingAccessToken

Integer

Defines whether QPR Client application can be opened from QPR Portal for the current QPR Portal user.

0 = disabled (default), 1 = enabled.

 

[UMS Log, PGS Log, PGP Log, SCS Log, SCP Log, WAS Log, WS Log, and Portal Log] Sections

Field

Field Type

Description

Threshold

Integer

Defines the log trace mode. 255 = normal trace mode, 6577 = full trace mode.

MaxSize

Integer

The maximum size of the log file in kilobytes. After the maximum size is searched, the old entries are overwritten starting from the oldest entry.

Enabled

Integer

Defines whether logging is on. 0 = no, 1 = yes.

ThreadPriority

Integer

Defines the thread priority for the log writing process. If you wish to fine-tune your Web Application Server performance, you can modify this value. Valid values are 0-6, 0 being normal and 6 is the highest value.

AuditTrailTrace

Integer

This option can be used only in the SCS Log section. Defines whether audit logging is enabled. 0 = no, 1 = yes.

PerformanceLog

Integer

Defines whether a log file about the server's performance is maintained. This option can be used only in the UMS Log, the PGS Log, the SCS Log, and the WAS Log (even though the field is available in the other log sections too). The possible values are: 0 = no performance logging, 1 = performance logging enabled, ending of client operations are logged, and 2 = performance logging enabled, starting and ending of client operations are logged. The performance logs are stored under the Logs folder with the following file names depending on for which servers the logging is enabled: WASPerfLog.txt,BizArchServerPerformanceLog.txt, MetricsServerPerformanceLog.txt, and FoundationServerPerformanceLog.txt.

 

The logs write also information about the duration of the operation. There are labels for different timeframes to make monitoring of log files easier. The labels are as follows:

 

TIME_0T = the execution time was 0 ms

TIME_1T = the execution time was 1-9 ms

TIME_10T = the execution time was 10-99 ms

TIME_100T = the execution time was 100-999 ms

TIME_1000T = the execution time was 1.000-9.999 ms

TIME_10000T = the execution time was 10.000-99.999 ms

TIME_100000T = the execution time was 100.000-999.999 ms

TIME_1000000T = the execution time was 1.000.000-9.999.999 ms (about 20 minutes - 3 hours)

TIME_10000000T = the execution time was 10.000.000-99.999.999 ms (about 3 -30 hours)

TIME_100000000T = the execution time was 100.000.000-999.999.999 ms (about more than 30 hours)

TIME_NA= execution time could not be determined, error occurred or time was greater than 999.999.999 ms.

UserRightAuditTrailTrace

Integer

This option can be used in the SCS Log, WAS Log, PGS Log, and UMS Log sections (even though the field is available in the other log sections too). Defines whether server user audit logging is enabled for each server separately. 0 = logging is disabled, 1 = basic logging is enabled, 2 = full logging is enabled (the full logging option is available only for UMS Log section).

DeadlockLog

Integer

This option can be used in the UMS Log section. Defines whether browsing the Analysis and Navigator views in QPR Portal causes certain action transaction related entries to be written into the log when full trace logging has been enabled. 0 = action transaction related entries are not written (default), 1 = action transaction related entries are written.

 

[UMS LDAP] Section

Field

Field Type

Description

ServerAddress

String

Address of the LDAP server.

SearchBase

String

The distinguished name of the entry under which the search is performed on. If left blank, the search starts from the top entry.

UserName

String

The distinguished name of the person entry used if the LDAP component logs in to the LDAP server with a username/password combination. If left blank, an anonymous login is used.

Password

String

The userPassword attribute of the person entry used if the LDAP component logs in to the LDAP server with a username/password combination. Leave this blank if an anonymous login is used. The user password is stored encrypted.

AlwaysUseSecureConnection

Integer

If this is 0, then an insecure connection is used between the LDAP component and LDAP server for all other functions than Authenticate.

AuthenticateViaSecureConnection

Integer

If both this and AlwaysUseSecureConnection are 0, then Authentication is done with insecure connection. If AlwaysUseSecureConnection is 1, then this setting has no effect (i.e. then it automatically defaults to 1).

ActiveSettingGroup

Integer

Identification of the currently active setting group. Each setting group contains technical settings to be adjusted to the LDAP directory used.

AllowConcurrentCalls

Integer

This setting defines whether LDAP calls can be performed concurrently instead of being serialized. 0 = serialized calls, 1 = concurrent calls. In the case this key is missing, 0 is used as a default value.

 

[UMS LDAP Setting Groups] Section

Field

Field Type

Description

<1...N>

String

Name of the settings group, numbered in a consecutive order. The settings of the setting groups can be defined in [UMS LDAP <MyNewSetting>] sections similarly as in [UMS LDAP Standard] and [UMS LDAP Active Directory] sections.

 

[UMS LDAP Standard] and [UMS LDAP Active Directory] Sections

Field

Field Type

Description

DistinguishedNameAttribute

String

Attribute name of an LDAP directory entry, which identifies the DN of the entry.

CommonNameAttribute

String

Attribute name of an LDAP directory entry, which identifies the full user name of the entry. When importing users, this is mapped as the user name of the user.

EmailAttribute

String

Attribute name of an LDAP directory entry, which identifies the email address of the entry. When importing users, this is mapped as the email address of the user.

MemberAttribute

String

Attribute name of an LDAP directory entry. This attribute identifies one group member. An entry having this attribute represents some kind of group. The entry has one (MemberAttribute, DN of the member) pair for each of its members.

DescriptionAttribute

String

Attribute name of an LDAP directory entry, which identifies the description of the entry. When importing users, this is mapped as the description of the user.

PersonFullNameAttribute

String

Attribute name of an LDAP directory entry, which identifies the full name of the user. If the value is not defined explicitly, the default value is used, i.e. the value set to CommonNameAttribute. If the value is defined, it overrides the default value.

UIDAttributeName

String

Attribute name of an LDAP directory entry, which identifies the user id (login name) of the entry. It is mapped as such when importing users.

UseADGlobalCatalog

Integer

Defines whether Global Catalog searching for Active Directory objects in any domain in the forest is enabled. 1 = enabled, 0 = disabled (default).

FilterForSearchingGroups

String

Groups are retrieved from the LDAP directory using this search filter.

FilterForSearchingPersons

String

Users are retrieved from the LDAP directory using this search filter.

GroupSearchBase

String

The distinguished name of the entry under which

the search is performed on. Used when searching for groups in LDAP. If set to <Default>, the value in SearchBase is used.

 

[WAS Messages] Section

Field

Field Type

Description

HTMLErrorTemplate

String

Template for a WAS error message.

HTMLCannotReadRequest

String

Template for WAS error message shown when a request cannot be read.

HTMLCannotProcessRequest

String

Template for WAS error message shown when a request cannot be processed.

HTMLTooManyConnections

String

Template for WAS error message shown if there are too many connections to WAS open at the moment.

HTMLStartupNotComplete

String

Template for WAS error message shown if the startup process has not been completed yet.

 

[SCS Settings] Section

Field

Field Type

Description

IWAEnable

Integer

Defines whether Integrated Windows Authentication (IWA) is enabled for QPR Metrics client. 0 = false, 1 = true.

MaxMemoryUsage

Integer

Defines the maximum amount of memory in megabytes that QPR Metrics Server and Plugin are allowed to use before non-critical caches are cleared and all measure values in all models are written to QPR EMS (Extended Memory Storage). QPR EMS is used by QPR Metrics Server and QPR Metrics Plugin as an extension to the memory for storing information such as measure values and calculation rules. Setting this to 0 (default) disables the limit. Otherwise the minimum value is 128 and the maximum value is 65536. This setting should be used only if you are experiencing problems with memory consumption.

SchedulerEnable

Integer

Defines whether scheduled integration tasks are enabled. 0 = scheduled integration tasks are disabled, 1 = scheduled integration tasks are enabled (default).

 

[SCS Reports] Section

Field

Field Type

Description

MaintainHierarchies

Integer

Enabling this property will accelerate report generating, but it will also slow QPR Metrics Server  down a little bit. 0 = no, 1 = yes.

MaintainHierarchiesRecent

Integer

Enabling this property will accelerate report generating, but it will also slow QPR Metrics Server down a little bit. 0 = no, 1 = yes.

 

[SCS Thread Priorities] Section

Field

Field Type

Description

ClientManagerThreadPriority

Integer

Thread priority of the Client Manager for Windows.

DBManagerThreadPriority

Integer

Thread priority of the Database Manager for Windows.

SchedulerThreadPriority

Integer

Thread priority of the Scheduler for Windows.

SocketAcceptThreadPriority

Integer

Thread priority of the Socket Accept for Windows.

 

[SCS Intermodel References] Section

Field

Field Type

Description

RefreshStartDate

String

Starting date for refreshing intermodel references. Accepted date format is "<d>.<m>.<yyyy>", where <d> is day, <m> month, and <yyyy> year with four digits.

RefreshStartTime

String

Starting time for refreshing intermodel references. Accepted time format is "<hh>:<mm>:<ss>", where <hh> is hours with two digits, <mm> minutes with two digits, and <ss> seconds with two digits.

RefreshInterval

Integer

Determines the refreshing interval in the precision of 5 minutes. The length (in minutes) of the actual interval can be calculated using the following formula: Refresh interval * 5.

RemoveUnusedReplicaSchemaObjectsRegularly

Integer

Defines whether unused replica model objects are scanned and removed regularly. Unused replica model objects are for instance replica element's value settings, which have been duplicated to the target model with earlier versions of QPR ScoreCard but which are unused now. 0 = disabled (default), 1 = enabled.

 

[SCS Remote Model Export] Section

Field

Field Type

Description

RepeatAttempts

Integer

Controls remote model updating. 0 = disable updating remote model. 1 = enable updating remote model.

RepeatInterval

Integer

Determines how often model will be updated. The value is in seconds.

RepeatTime

Integer

Determines for how long the QPR Metrics Server will try to update model. The value is in minutes.

 

[SCS Value in Range] Section

Field

Field Type

Description

Title

String

Title of the e-mail notification sent when a value enters a certain range in QPR Metrics.

Text

String

Notification text. In the case you need to add linefeeds, use the <NL> tag.

 

[SCS Value Missing] Section

Field

Field Type

Description

Title

String

Title of the e-mail notification about a value missing in QPR Metrics.

Text

String

Notification text. In the case you need to add linefeeds, use the <NL> tag.

 

[SCS Value Changed] Section

Field

Field Type

Description

Title

String

Title of the e-mail notification sent when a certain value is changed in QPR Metrics.

Text

String

Notification text. In the case you need to add linefeeds, use the <NL> tag.

 

[SCS Calculation] Section

Field

Field Type

Description

CalculationEnabledByDefault

Integer

Defines whether calculation is enabled for models by default. In the case calculation is disabled, values can still be input, but formulas are not calculated automatically. 0 = no, 1 = yes (default).

CalculationEnabledFor

String

A comma-separated list of names or IDs of models for which calculation should be enabled in the case calculation is disabled by default. Model names in the list must be in double quotes, and in the case any model name contains double quotes, the quotes inside the name must be preceded by another double quotes. It is also advisable to put the whole list inside double quotes to ensure that the quotes are parsed properly.

CalculationDisabledFor

String

A comma-separated list of names or IDs of models for which calculation should be disabled in the case calculation is enabled by default. Model names in the list must be in double quotes, and in the case any model name contains double quotes, the quotes inside the name must be preceded by another double quotes. It is also advisable to put the whole list inside double quotes to ensure that the quotes are parsed properly.

CalculatorThreads

Integer

Defines how many threads are used for QPR Metrics model calculation. If this value is changed, calculations which are not dependent on the results of other calculations are done in parallel in the defined amount of threads. The default value is 0, and in this case computers with a single processor use one thread for the calculation and computers with multiple processors use two threads. In the case there are less than 100 values to calculate, only one thread is used regardless of this setting.

ModelRecalculationPeriodChunkSize

Integer

Defines how many values (every single value under every period and series in a measure counts as a separate value) are included in one calculation transaction during model recalculation. The default value is 1200000, and reducing this value consumes less memory during recalculation, but makes the calculation slower and vice versa. Note that modifying this value is usually unnecessary unless models are extensively large.

ThresholdForFullModelRecalculation

Integer

Defines a threshold for triggering full model recalculation. The threshold is the amount of invalidated measure values after which instant invalidation of measure values is stopped and full model recalculation is automatically done after the operation which caused the measure value invalidation is completed. This option can be used to address situations where the amount of invalidated measure values causes memory consumption issues on the server. By default this is 0, which makes the option to use the value of the ModelRecalculationPeriodChunkSize key as the threshold.

TimeDependentFormulaRecalculationMode

Integer

Defines the way QPR Metrics Server recalculates time dependent formulas (i.e. formulas whose value depends on the current time, for example formulas that use the Date function) in models. Possible values are: 0 = Time dependent formulas are never calculated automatically, 1 = Time dependent formulas are calculated automatically only when the date is changed, 2 = Time dependent formulas are calculated automatically when the date changes and when QPR Metrics Server loads the model into memory during server startup (default).

 

[SCS Scheduler] Section

Field

Field Type

Description

DeletedObjectsTimeout

Integer

The amount of seconds after which deleted objects are finally removed from the server. This should always be several minutes to avoid errors.

 

[PGS Model] Section

Field

Field Type

Description

DaysInCache

Integer

Defines the amount of days unused models are stored in cache memory before they are removed.

OnDisk

Integer

Defines whether embedded information items exceeding the size defined in the Threshold setting are cached on disk (1, true) or on memory (0, false). 1 = true, 0 = false.

Threshold

Integer

The maximum size for embedded information items (in kilobytes) that are stored in the memory. If the size is exceeded, the attachments are stored in hard disk.

MaxMemoryUsage

Integer

Maximum memory usage in megabytes. The minimum value is 128, maximum is 65536. Note that this value can be exceeded temporarily.

ClearDiskCacheAtStartup

Integer

Defines whether model cache on disk is cleared at startup. In the case this is 0 (false), old cached files are utilized in the case their contents are up to date, thus resulting in a faster startup. 0 = false (default), 1 = true.

LoadModelsAtStartup

Integer

Defines how models are loaded into the QPR Web Application Server at startup.

 

0 = Base models and published models that do not have an existing cache file are loaded from database and written to cache. After this models are dropped from the memory.

 

1 = Base models and published models that do not have an existing cache file are loaded from database and written to cache. Models are dropped from the memory in the case the memory limit is exceeded.

 

2 = Base models that do not have an existing cache file are loaded from database and written to cache.

 

3 = No models are loaded from the database.

 

[PGS Settings] Section

Field

Field Type

Description

AuditTrailTrace

Integer

Defines whether audit logging is enabled. 0 = no, 1 = yes.

IWAEnable

Integer

Defines whether Integrated Windows Authentication (IWA) is enabled for QPR Modeling Client. 0 = false, 1 = true.

PortalUpdateMethod

Integer

Defines the update method between QPR BizArchitecture Server and QPR Portal. 0 = Immediate, 1 = Scheduled. Default value is 0. If scheduling is used, PortalUpdateScheduleInterval must be defined. Scheduling applies to the following model operations: Save (not Save As), Replace, Rename, and Move (to another folder). However, in the case a new published model is created, models in Portal are updated at the moment the new model is saved. This setting can be used for example to schedule model update operations to occur outside the peak hours in environments with large models.

PortalUpdateScheduleStartDate

Datetime (dd.MM.yyyy hh:mm:ss)

Defines the initial start time of the updating between QPR BizArchitecture Server and QPR Portal if PortalUpdateMethod = 1. If PortalUpdateScheduleStartDate is not defined, the server start date/time is used.

PortalUpdateScheduleInterval

String (dd:hh:mm)

Defines the interval between the updating of QPR BizArchitecture Server and QPR Portal starting from the time defined in PortalUpdateScheduleStartDate. Only one interval is supported. The correct format for this setting is a colon-separated list of days, hours and minutes. For example, if PortalUpdateScheduleStartDate = 12.12.2008 01:30:00 and PortalUpdateScheduleInterval = 01:00:00, the first update takes place on 12.12.2008 01:30 and subsequent updates are done every day at 01:30.

 

[PGP Settings] Section

Field

Field Type

Description

ModelsInMemory

String

A comma-separated list of model IDs of models that are loaded to memory when QPR Web Application Server is started. The list is maintained by QPR Web Application Server and contains the models that were in memory when QPR Web Application Server was last shut down.

LoadModelsToMemory

String

A comma-separated list of model IDs of models that are loaded to memory when QPR Web Application Server is started. This setting is maintained only manually, and if the value is empty or missing, the list is considered to be empty.

LoadAllModelsAtStartup

Integer

Defines whether all models are loaded into memory when QPR Web Application Server is started as well as right after the model has changed. With different options this setting either overrides or utilizes the ModelsInMemory and LoadModelsToMemory keys. The options are as follows: 0 = No models are read into memory at startup. 1 = All models are read into memory at startup. 2 = Models listed in the ModelsInMemory key are read into memory at startup, 3= Models listed in the LoadModelsToMemory key are read into memory, 4 = Models listed in ModelsInMemory AND LoadModelsToMemory key are read into memory at startup. For standalone installation the default value is 1, but for other installations the default value is 4.

LoadModelsFromCacheFiles

Integer

Defines whether models in file cache are used during QPR Web Application Server startup in the case the model exists in cache and it is up to date. If the model is not cached or it is not up to date, the model is read from the QPR BizArchitecture Server. 0 = no, 1 = yes.

HorizontalAttributeList

Integer

Defines whether custom attribute types are displayed in the diagram as a horizontal attribute list. This setting is useful for flow charts created in QPR 7.5 since the visualization mode has changed to vertical after that. 1 = show horizontal attribute list, 0 = show vertical attribute list (default). Note that in contrast to the similarly named key in [PGC Settings] section, this is a global key affecting all users of the corresponding instance of QPR Web Application Server, and therefore this should reside in QPR_Servers.ini located in the C:\ProgramData\QPR Software\QPR 2017\2017.1\Servers\Settings\<possible instance folder> folder.

NoInfoIconForDefaultInfoItem

Integer

Defines whether the information item icon is shown in the middle of an information flow, when only one information item is linked to the flow. 0 = icon is shown (default), 1 = icon is not shown.

 

[WAS PG Publishing] Section

Field

Field Type

Description

DaysInRecentList

Integer

The maximum number of days for which an event is displayed in the "What's New" page in QPR Portal

DefaultZoomSize

String

Default zoom size used for diagrams. The value should be included also in the ZoomSizes entry.

ElementTypes

Binary

Binary entry that is used to save element type specific web publishing options.

FlowchartPictureGeneration

Integer

Tells when the diagram images are generated (0 = on model load, 1 = when diagram is needed for the first time).

FlowchartPictureStorage

Integer

The storage place of diagram images (0 = memory, 1 = hard disk)

FooterItemCount

Integer

Number of footer items added into generated diagram pictures.

GraphicsLocation

String

The location of the web contents when HTML export is used from ProcessGuide.

HeaderItemCount

Integer

Number of header items added into generated diagram pictures.

MaxFCSize

Integer

Defines the maximum size of diagrams in pixels. Default value is 500000. If the value is 0, the maximum size will not be used. If the maximum size is exceeded, the diagram will be zoomed to the defined maximum size. Note that this setting has an effect on the image size in QPR Portal Process Maps view printing.

MinRecentEntries

Integer

Minimum amount of entries to show at the "What's New" page in QPR Portal.

MaxRecentEntries

Integer

Maximum amount of entries to show at the "What's New" page in QPR Portal.

MeasureHotSpot

Integer

Show measure value hot spot (0 = no, 1 = yes)

ModelElements

Binary

Binary entry that tells what model element information is shown in details window. See discussion below.

OldModelUsage

Integer

Allow the usage of old model version when loading the new version. (0 = no, 1 = yes)

ShowHierarchy

Integer

The hierarchies shown in navigator. Bit 5: diagram hierarchy, bit 4: Organization hierarchy, bit 3: notes hierarchy, bit 2: resource groups hierarchy, bit 1: resource pools hierarchy, bit 0: information hierarchy

ShowFlowchartLinkInDetailsLinks

Integer

Show link to diagram after every diagram object shown in any detail view (0 = no, 1 = yes).

ShowTransferTypeIcons

Integer

Show transfer type icons in the diagram (0 = no, 1 = yes).

Version

String

Version of the PG whose initialization file specifications this file uses.

ViewTemplateDirectory

String

The directory from which the layouts are fetched

WebPageNameAttribute

String

The name of the custom attribute that will be used as filename for generated HTML export pages and name of the view in dynamic web publishing. If WebPageNameAttribute=Name, then object's name will be used.

ZoomSizes

String

List of comma separated zoom sizes shown in the published web pages (numbers should be between 10 and 200).

 

[SCP Settings] Section

Field

Field Type

Description

Cache

Integer

Defines whether browser cache is in use. 0 = no, 1 = yes.

MinRecent

Integer

Minimum amount of entries to show in the What's New page in Portal.

MaxRecent

Integer

Maximum amount of entries to show in the What's New page in Portal.

RecentDays

Integer

The maximum amount of days included in the What's New page listing.

EnableGraphicalViews

Integer

Defines whether graphical Scorecard views are enabled. 0 = no, 1 = yes. The element graph layout of the element view is also hidden when this is set to 0.

RemoveGeneratedGraphicsFiles

Integer

Defines whether old *.svg files are removed at startup. 0 = no, 1 = yes.

GraphicalViewer

Integer

Defines which technology is used for graphical views. 0 = SVG (default) 3, 3 = Microsoft Silverlight.

UseBufferedValueInput

Integer

Defines whether value input is allowed when the model is reserved e.g. for recalculation. In the case buffered input is allowed, values can be input when the model is reserved, but the new values are stored  in a temporary buffer and applied to the model once the reservation is freed. 0 = disabled (default), 1 = enabled.

WaitForValueUpdate

Integer

Defines the maximum amount of seconds to wait for a buffered value update to finish in QPR Portal. Default is 6 seconds.

UseBitmapTextInGraphicalViews

Integer

Defines whether SVG/Silverlight views display text as bitmap graphics instead of using text capabilities of SVG and Silverlight. This setting is useful e.g. in situations where some language-specific features such as joining characters based on their context doesn't work properly. 0 = disabled (default), 1 = enabled. Note that if this setting is enabled, charts in Element Views are always drawn as PNG images.

ScorecardHierarchyMode

Integer

Defines which scorecards are hidden in the scorecard hierarchy view in QPR Portal when a user doesn't have enough rights. 0 = No scorecards are hidden (default), 1 = Scorecards for which the user has no rights are hidden from the hierarchy, after which the hierarchy is flattened, 2 = If a scorecard for which the user has no rights doesn't have any child scorecards or the user doesn't have rights for all of its children, that scorecard and its children are hidden from the hierarchy. All other scorecards are visible, even if the user had no rights for them, 3 = Scorecards for which the user has no rights and all its children are hidden from the hierarchy, no matter if the user had rights for some of the children, 4 = Scorecards for which the user has no rights are hidden from the hierarchy and their children are attached under the deepest prevailing parent. If a user has no rights for the parents, the children are moved to the top level.

ScorecardNameMode

Integer

Defines how those scorecards for which the user has no rights but still remain visible in the scorecard hierarchy in QPR Portal after ScorecardHierarchyMode is applied are handled. 0 = The names of the scorecards for which the user has no rights are shown, but the links are not clickable (default), 1 = The names of the scorecards for which the user has no rights are not shown. Instead, their names are displayed as "Access Denied".

EnableHyperlinksForTextValues

Integer

Defines whether hyperlinks are created automatically in QPR Portal from URLs entered as text type measure values. 0 = Hyperlinks are not created automatically (default), 1 = Hyperlinks are created automatically.

RetainViewSettings

Integer

Defines whether the selected view settings name is stored when browsing in QPR Portal. When the name is stored and a new dashboard/hierarchy view is opened, a check is made if view settings with the same name as the stored one exists in the opened view. If they exist, then those view settings are selected, otherwise the default view settings are used. 0 = View settings name is not stored (default), 1 = View settings name is stored.

EnableLanguageSpecificContent

Boolean

Defines whether multilingual modeling is in use in QPR Metrics content in QPR Portal. 0 = multilingual modeling is not in use (default), 1 = multilingual content is in use.

 

[Portal Settings] Section

Field

Field Type

Description

PwdChanging

Integer

Allow password changing in Portal. 0 = no, 1 = yes.

UseDefaultHomeView

Integer

Defines whether the default home view is used. 0 = custom, 1 = default.

CustomHomeURL

String

Defines the URL of the custom home view if the default view is not used.

AllowUsersToChangeHomeView

Integer

Allow users to customize the view shown in my contents/home. 0 = no, 1 = yes.

DefaultView

String

The tab that is selected by default when logging into the Portal.

AllowUsersToChangeDefaultTab

Integer

Allow users to customize the default tab selected when user logs into the QPR Portal. 0 = no, 1 = yes.

AllowUsersToChangeDefaultPages

Integer

Allow user to customize the default views opened when some tab has been selected.

CustomCategoryLabelText

String

If not empty, determines the text used as label for category attributes in actions.

ShowViewTitles

Integer

Defines whether the Portal windows display the view titles (e.g. Add Action) in the browser window's title bar. 0 = no, 1 = yes.

PublicBookmarkPositioning

Integer

Defines whether public bookmarks are shown after or before the user's own bookmarks. 0 = own - public, 1 = public - own.

DefaultActionType

String

Defines the default type of action. The default type is the type that is initially selected in the action editor when creating a new action.

DefaultPublishTo

String

Defines the default option that is selected in the "Publish to" section when creating a new action. Possible values are: Users of linked elements, Me only, Everyone, and Selected users.

DefaultNotifyViaEmail

Integer

Defines whether the "Notify via e-mail" option is checked by default in the action editor. 0 = no, 1 = yes.

DefaultAttachmentType

Integer

Defines the default type of attachments in the attachment editor. 0 = linked attachments, 1 = embedded attachments.

EnableBookmarksForViewUsers

Integer

Defines whether users with view rights only can create bookmarks in QPR Portal. 0 = disabled, 1 = enabled.

 

[WS Settings] Section

Field

Field Type

Description

SearchServerLocation

String

URL of the MS SharePoint Site that contains QPR Search Central (a separate add-on) pages.

AllowPasswordChanges

Integer

Defines whether changing passwords via the QPR Web Service is allowed. 0 = password changing isn't allowed, 1 = password changing is allowed.

 

[SCS Log] Section

See UMS Log

 

[SCP Log] Section

See UMS Log

 

[PGS Log] Section

See UMS Log

 

[PGP Log] Section

See UMS Log

 

[WAS Log] Section

See UMS Log

 

[WS Log] Section

See UMS Log

 

[WAS Plugins] Section

Field

Field Type

Description

ModelingPlugin

Integer

Defines whether the Modeling plugin is enabled, i.e. if the "Processes" tab is available in QPR Portal. 0 = disabled, 1 = enabled.

MetricsPlugin

Integer

Defines whether the Metrics plugin is enabled, i.e. if the "Scorecards" tab is available in QPR Portal. 0 = disabled, 1 = enabled.

 

[Portal Default Views]

Field

Field Type

Description

scorecards

String

The default view for the Scorecards tab.

actions

String

The default view for the Actions tab.

processes

String

The default view for the Processes tab.

mycontents

String

The default view for the My Contents tab.