Global properties are properties that you set at design time on the Configuration tab of the Project painter, or after deployment in the generated Web.Config file for your application.
You cannot set global properties in script.
| Property | Default value | Description |
|---|---|---|
| PBAutoTriggerMenuSelectedEvents | False | Indicates whether to trigger the menu Selected event for all menu items before Web Forms are rendered in the browser. The Selected event can be handled on the server only for simple tasks related to the appearance of the menu items. The Selected event is always disabled on the client side to prevent unnecessary postbacks when a menu item is highlighted. |
| PBCachedAndSharedDDDWs | — | A comma-delimited set of names for DataWindow objects that you want to use in DropDownDataWindow edit style controls for sharing across application sessions. See Sharing Data Across Sessions. |
| PBCachedAndSharedDWs | — | A comma-delimited set of names for DataWindow objects that you want to share across application sessions. See Sharing Data Across Sessions. |
| PBCommandParm | — | Sets command line parameters for your application. Users can override the default by setting this property in a URL. |
| PBCultureSource | Server | Enumeration that specifies the source of regional settings for data formats. Values are Server or Client. See Use regional formats based on client or server settings . |
| PBDataWindowEnableDDDW | False | Indicates whether to render a DropDownDataWindow (DDDW) or a DropDownListBox control for a column using the DDDW edit style. Values are true to render the drop-down object as a DDDW, or false to render it as a list box. The value you set applies to all DDDW objects in the application, although if you set this value to true, you can still render a specific DDDW object as a list box by setting its HTMLGen.GenerateDDDWFrames property (the "Generate DDDW Frames" field on the Web Generation page of the DataWindow painter Properties view) to false. |
| PBDataWindowGoToButtonText | Go | Sets the label for a navigation bar button that takes a user to a designated DataWindow page. |
| PBDataWindowGoToDescription | Go To: | Sets the label for the navigation control that takes a user to a designated DataWindow page. |
| PBDataWindowNavigationBarPosition | PBDWBottom | Sets the position where the page navigation controls appear. Values are PBDWBottom to show them at the bottom of the DataWindow, PBDWTop to show them at the top of the DataWindow, or PBDWTopAndBottom to show them at the top and bottom of the DataWindow. |
| PBDataWindowPageCountPerGroup | 10 | Sets a limit to the number of pages that can appear for the Numeric or NumericWithQuickGo style navigation bars. |
| PBDataWindowPageNavigatorType | NextPrev | Values are NextPrev, Numeric, QuickGo, NextPrevWithQuickGo, or NumericWithQuickGo. See Take Advantage of Global Configuration Properties. |
| PBDataWindowQuickGoPageNavigatorType | DropDownList | Sets the type of control to use for the Quick Go navigation bar. Values are DropDownList or Edit. |
| PBDataWindowRowsPerPage | 20 | Sets the number of DataWindow rows to show in Web Forms when the HTMLGen.PageSize property of the DataWindow object is not set. HTMLGen.PageSize and PBDataWindowRowsPerPage have no effect on DataWindow objects with the Label presentation style. Composite and Crosstab presentation styles do not support pagination. |
| PBDataWindowScriptCallbackDDDW | False | Set this to true to load a DropDownDataWindow on demand using ASP.NET script callbacks when PBDataWindowEnableDDDW is also set to true. |
| PBDataWindowStatusInfoFormat | Page {C} of {T} | Sets the text for the DataWindow page count {C} and the total number of pages {T}. The other variables you can use are placeholders for the starting {S} and ending {E} page of a group range, which you can set in the PBDataWindowPageCountPerGroup global property. |
| PBDBFetchBuffers | 1 | The default value causes values to be entered in the database trace log for each fetch request when tracing is enabled. Set to 0 to disable tracing on each fetch request. |
| PBDBLogFileName | c:\dbtrace.log | The name of the database log file when tracing is enabled. The log file is saved under the application root directory in the virtual file system on the IIS server. You can use PowerBuilder file functions to open and read the log file. |
| PBDBShowBindings | 1 | The default value causes metadata from the database result set columns to be entered in the database trace log when tracing is enabled. Set to 0 to disable these entries. |
| PBDBShowDBINames | 0 | If you set this value to 1, the original database interface command names are included in a database trace log file when tracing is enabled. By default, these names are not included in the log file. |
| PBDBSqlTraceFile | c:\pbtrsql.log | The name of the database log file when SQL command tracing is enabled. The log file is saved under the application root directory in the virtual file system on the IIS server. You can use PowerBuilder file functions to open and read the log file. |
| PBDBSumTiming | 1 | The default value causes the cumulative total of timings since the database connection began to be entered in the database trace log file when tracing is enabled. Set to 0 to disable these entries. |
| PBDBTiming | 1 | The default value causes the time required to process database interface commands to be entered in the database trace log file when tracing is enabled. Set to 0 to disable these entries. |
| PBDefaultTheme | Auto | The default theme selection causes controls in the Web Forms application to
appear with Windows Classic themes for Windows 2000 operating systems, and
Windows XP themes for all other operating systems.
Select "XP" to show controls with Windows XP themes regardless of the client operating system. Select "Classic" to show controls in all client browsers with a Windows Classic appearance. |
| PBDeleteTempFileInterval | 600 (minutes) | Sets the number of minutes before temporary files created by composite DataWindows are deleted. A value of 0 prevents the temporary files from being deleted. |
| PBDenyDownloadFolders | c:\~pl_ | A semicolon-delimited string of directory names. Application users are not able to use the Web Forms File Manager to download files in any of the directories listed in this string. |
| PBEventLogID | 1100 | The event ID if exceptions are logged to the EventLog. |
| PBFileManager | False | Set to true if you want to render the File Manager icon in a Web Forms application. |
| PBFormExitMessage | "If there is any unsaved data, it will be lost." | Use to set custom message when users exit the current form. The custom message is sandwiched between two default sentences in the same message box: "Are you sure you want to navigate away from this page?" and "Press OK to continue, or Cancel to stay on the current page." |
| PBIdleInterval | 0 (seconds) | Factor that adjusts the interval for the Idle event in a Web Forms application. The actual interval is determined by the application idle interval multiplied by the PBIdleInterval value. A value of 0 prevents the Idle event from being triggered. |
| PBJVMLogFileName | vm.out | Name of the file that logs information about the JVM for applications using a JDBC connection. By default, this file is saved to the applicationName_root\Log directory under the virtual root directory of the Web server. |
| PBLibDir | c:\~pl_ | The directory on the server where dynamic libraries are generated. |
| PBMailManager | False | Set to true if you want to render the Mail Manager icon in a Web Forms application. |
| PBMailTimeout | 1200000 (milliseconds) | Time in milliseconds before an SMTP session expires. The default value is equivalent to 20 minutes, which is also the HTTP session timeout period. It should be set higher if the mail includes file or data attachments. The SMTP session also expires after an e-mail is sent from the Web Forms application. |
| PBMaxSession | 0 | Sets the maximum number of Web Forms sessions that can be open at the same time. The default value of 0 places no limitation on the number of sessions that can be open simultaneously. |
| PBShowDenyDownloadFolders | False | Set to true to allow application users to see the server-side folders to which you restrict download access by listing them in the PBDenyDownloadFolders global property. By default, these folders are not visible in the File Manager |
| PBShowFormExitMessage | True | Set to false to prevent a message box from displaying when application users exit the current form. If you set this to true, you can add a custom message to the message box by setting the PBFormExitMessage global property. |
| PBTempDir | c:\temp | A temporary directory under the virtual file root on the server. |
| PBThemeManager | False | Set to true if you want to render the Theme Manager icon in a Web Forms application. |
| PBTimerInterval | 0 (seconds) | Factor that adjusts the interval for the window Timer event in a Web Forms application. The actual interval is determined by the window’s Timer interval multiplied by the PBTimerInterval value. A value of 0 prevents the Timer event from being triggered. |
| PBTrace | Enabled | Indicates whether to log exceptions thrown by the Web Forms application. Values are Enabled or Disabled. |
| PBTraceFileName | PBTrace.log | Name of the file that logs exceptions thrown by the Web Forms application. By default, this file is saved to the applicationName_root\Log directory under the virtual root directory on the Web Forms server. |
| PBTraceLevel | Critical | By default, the .NET runtime logs critical exceptions only. However, if you set this property to SystemFunction, the .NET runtime logs all exceptions caught by system functions. |
| PBTraceTarget | File | Defines where to log exceptions thrown by the Web Forms application. Values are File or EventLog. |
| PBWebFileProcessMode | Share | Share mode maintains files in a read-only state when a write file operation is not explicitly coded. If an application requires multiple file operations, you might want to change this property setting to Copy mode. See File process mode. |
| PBWindowDefaultHeight | 600 (pixels) | Specifies the default height of the client area of the Web browser when MDI, MDIHelp, and main type windows are opened as maximized for the first time. |
| PBWindowDefaultWidth | 1003 (pixels) | Specifies the default width of the client area of the Web browser when MDI, MDIHelp, and main type windows are opened as maximized for the first time. |
| PBYieldTimeout | 10000 (milliseconds) | Time in milliseconds before the Yield function causes a postback to the server. Yield calls are ignored if you set this value to 0. When you set this value to 0, however, you must make sure your application does not call Yield inside a loop, as in the following example:
do while flag
yield()
loop
|
The default global properties and their values appear only when the “System defined configuration settings” option is selected on the Configuration tab. (This is the default selection):
| Property | Default value | Description |
|---|---|---|
| FileFolder | WebAppDir..\appName_root\file | Base directory for the virtual file manager. It contains the File\Common directory structure and files that mirror paths for the application resource files on the development computer. If you switch to Copy mode, a sessionID directory is created under the File\Session directory that mirrors the File\Common directory structure and file contents. |
| MailFolder | WebAppDir..\appName_root\mail | Base directory for the mail manager. |
| PrintFolder | WebAppDir..\appName_root\print | Base directory for files that your application prints in PDF format. |
| LogFolder | WebAppDir..\appName_root\log | Folder that contains the PBTrace.log file. |
For information on modifying global properties in the Web.config file (after you deploy a Web Forms application), see Viewing and Modifying Global Properties in the IIS Manager.
You can also create custom global properties. When you select a global property from the Key and Value list and click the Edit button, the Set Configuration Value dialog box appears. You can use this dialog box to change the values of system or custom global properties.