INI Contents |
|
Sections and parameters supported for use in a PxPlus INI file are listed below.
ActivationKey=path |
Path name to the directory that contains the PxPlus activation file, ACTIVATE.PVX (e.g. ".. \LIB\KEYS"). | ||||||||||||||||||||||||||||||
AutoConvertUTF8=xxx |
Enables the automatic conversion of high-order ASCII keyboard input to UTF8 if xxx is set to "Y", "y" or "1". See the 'OPTION' mnemonic AutoConvertUTF8 setting. | ||||||||||||||||||||||||||||||
AutoEnablePDF=0 | 1 |
Controls the default setting of the 'AP' system parameter. | ||||||||||||||||||||||||||||||
BlinkTime=nnn |
Number of milliseconds between blinks for blinking text on graphical windows devices. (Default is 500ms.) | ||||||||||||||||||||||||||||||
Controls whether or not the browser developer console will display in a popup window for any subsequently created *BROWSER controls. See the 'OPTION' mnemonic BrowserDebug setting. (This functionality was added in PxPlus 2021.) | |||||||||||||||||||||||||||||||
Forces the embedded Chromium browser language to be language code. See Language Codes for a list of supported languages and codes. Defaults to user OS language unless PRINT 'OPTION'("BrowserLang") is used to override. See the 'OPTION' mnemonic BrowserLang setting. (This functionality was added in PxPlus 2019.) | |||||||||||||||||||||||||||||||
ButtonCursor=n |
Cursor number to be used when the pointer is over a button. | ||||||||||||||||||||||||||||||
ButtonDisableCursor=n |
Cursor number to be used when the pointer is over a disabled button. | ||||||||||||||||||||||||||||||
Certificates=IGNORE | VALIDATE | TRUSTREQD |
(Applicable to Client Connections Only) Defines the default certificate validation rules:
(This functionality was added in PxPlus 2017.) | ||||||||||||||||||||||||||||||
CertStore=pathname |
Defines the location of the trusted certificate store file or directory. The default certificate store is the ca-bundle.crt file in the PxPlus install directory. The latest version of this file is downloaded from the following location: https://raw.githubusercontent.com/bagder/ca-bundle/master/ca-bundle.crt. If directory, the last character must be a directory delimiter (/ or \). See the OpenSSL documentation on the SSL_CTX_load_verify_locations function for contents at the following link: https://www.openssl.org/docs/manmaster/man3/SSL_CTX_load_verify_locations.html (This functionality was added in PxPlus 2017.) | ||||||||||||||||||||||||||||||
CommandLine=text -prm -prm …. |
Optional argument used to define the Command line to be used when running PxPlus. This argument is used only when an INI file is specified. Its contents replace the INI file name in the original command sequence. Warning! | ||||||||||||||||||||||||||||||
Cursorn=text |
Overrides settings for the graphic display of the mouse pointer (as controlled via the 'CURSOR' mnemonic). Where: n identifies a cursor number to override and text specifies the pointer to use. text value can be the name of a valid resource within an associated resource library or an * (asterisk) followed by a standard system cursor name. These are represented as follows:
The IDC value, shown in parenthesis, represents the corresponding Windows LoadCursor API resource identifier. | ||||||||||||||||||||||||||||||
Debug=n |
Enables access to the debugging environment windows. Values are:
| ||||||||||||||||||||||||||||||
DebugPlus |
Deprecated -- No Longer in Use | ||||||||||||||||||||||||||||||
DebugPlusOpt=n |
Set by the system to store the various options enabled in the Trace window. | ||||||||||||||||||||||||||||||
DefaultCommandLine=xxx |
Defines the OS Command line parameters if NO Command line parameters are provided. System will ignore this option if any Command line parameters are present on the OS Command line that launched PxPlus. | ||||||||||||||||||||||||||||||
Directory=text |
Starting directory name. | ||||||||||||||||||||||||||||||
Disabled3Detch=n |
Controls the use of 3D etching on disabled objects, where 0 is Off and 1 is On. By default, n=0. | ||||||||||||||||||||||||||||||
Drag=xxx |
Defines the pathname of the Image file (ICON) that is to be used when initiating the internal Drag/Drop logic. | ||||||||||||||||||||||||||||||
Fid0=text |
Override setting of FID(0). | ||||||||||||||||||||||||||||||
ForceMessageBoxOnTop= -1 | 1 |
When set to 1, this forces a message box to display on the desktop when running as a service. A -1 does not display the message box and automatically selects the OK button. Note: | ||||||||||||||||||||||||||||||
GetFileDelim=hh |
Defines the character to be used between each file name passed in a GET_FILE_BOX. See 'GS' system parameter. Value is the Hex code for the character to use. | ||||||||||||||||||||||||||||||
GrayMapping=n |
When set to 1, PxPlus substitutes the light and dark gray with the colours in the Windows desktop. When set to 0, then light and dark gray are used. By default, n =1. | ||||||||||||||||||||||||||||||
HideTips=0 | 1 |
If set to 1, the system will not display tips for any graphical controls. This is controlled by the system menu (ALT - Space, Hide Tips option). | ||||||||||||||||||||||||||||||
Icon=text |
Name of the icon to be used by PxPlus. This can be the name of an icon contained in a specified ResourceLib file or it can be an icon file name; e.g. path/myicon.ico. | ||||||||||||||||||||||||||||||
IgnoreTempKeyWarning=0 | 1 |
If set to 1, the system will not display a 7-day advance warning that a temporary installation key is about to run out. | ||||||||||||||||||||||||||||||
Library=path |
Path name to PxPlus library location (e.g. ".. PXPLUS\LIB"). | ||||||||||||||||||||||||||||||
Defines the text file to receive the internal system error log. The log file must already exist, as the INI file will not create it. When specifying, include the full absolute pathname of the log file (without quotes). When defining the log file, you can specify the maximum file size (in megabytes) that you want the log file to grow. See PxPlus Log File. | |||||||||||||||||||||||||||||||
PDFEmbed=x |
Controls whether PDF fonts are to be embedded in system-generated PDF documents. Options are:
| ||||||||||||||||||||||||||||||
PDFFontDir=xxx |
Defines the pathname to the directory where PDF fonts are stored. See the 'OPTION' mnemonic PDFFontDir setting. | ||||||||||||||||||||||||||||||
PDFMargin=n |
Defines the standard margins (top, bottom, left and right) in inches to use for all PDF output. (Default is 0.25.) | ||||||||||||||||||||||||||||||
PrinterCPI=n |
Defines the default printer CPI for graphical printers. | ||||||||||||||||||||||||||||||
PrinterFont=xxx |
Allows the setting of the default printer font to use when outputting to a graphical printer (Windows spooler or PDF). | ||||||||||||||||||||||||||||||
PrinterLPI=n |
Defines the default printer LPI for graphical printers. | ||||||||||||||||||||||||||||||
DLL file that contains bitmaps and icons that extend the internal bitmaps {!name} available in your PxPlus session. | |||||||||||||||||||||||||||||||
RetryDeviceError=n |
Controls what happens on a timeout from a physical device such as an LPT port. System parameters 'DT' (Device Timeout) and 'WT' (Number of Retries) also affect the behaviour of device timeouts. When n is set to 0, then an err=0 is reported immediately after a DT time has occurred. When n is set to 1 or 2, then a Device Timed Out message box appears and asks the user to retry or abort. If the user aborts, then an err=0 is reported immediately. When set to 2, then a BREAK is also issued. By default, n =0. | ||||||||||||||||||||||||||||||
ShutdownMsg=text |
Three possible options for this parameter are:
| ||||||||||||||||||||||||||||||
Allows up to 10 custom items to be added to the drop down menu that appears when you click on the icon in the upper left corner of the base PxPlus launch window. Where:
Examples: | |||||||||||||||||||||||||||||||
SystemPalette=n |
When set to 1, PxPlus uses the Windows colour palette. When set to 0, PxPlus does not use the Windows colour palette. (By default, n =1.) | ||||||||||||||||||||||||||||||
Used to define the color for non-HTML tips. Valid formats for defining a color include predefined system color names (e.g. LightRed), RGB values, HSL values, Hex color codes, color blending, and dynamic color lightening. For information on these formats, see Color Properties. Setting this option sets the 'TC' system parameter to -3. If 'TC' is set to -3 but the TipColor (or TipColour) setting is not defined, the default Windows color will be used. (added in PxPlus 2021) | |||||||||||||||||||||||||||||||
WindowAutoSize=xxx |
Enables the system automatic Command window resizing if xxx is set to "Y", "y" or "1". | ||||||||||||||||||||||||||||||
AllowedCiphers=list |
Can be set to restrict SSL ciphers to use when performing SSL secured network transmissions. | ||||||||||||||||||||||||||||||
IPV4Only=1 |
When set to 1, disables support for IPv6 addressing and assures all addresses are IPv4 compatible. | ||||||||||||||||||||||||||||||
NoSSLv2=1 |
When set to 1, disables support for SSLv2 protocol, which is considered untrustworthy. | ||||||||||||||||||||||||||||||
NoSSLv3=1 |
When set to 1, disables support for SSLv3 protocol, which is considered untrustworthy. | ||||||||||||||||||||||||||||||
NoTLSv1=1 |
When set to 1, disables support for TLS V1 protocol. This protocol is considered secure, but the option to disable it is available in case this changes. | ||||||||||||||||||||||||||||||
NoTLSv1.1=1 |
Disables TLSv1.1 support. (This functionality was added in PxPlus 2017.) | ||||||||||||||||||||||||||||||
NoTLSv1.2=1 |
Disables TLSv1.2 support. (This functionality was added in PxPlus 2017.) | ||||||||||||||||||||||||||||||
NoTLSv1.3=1 |
Disables TLSv1.3 support. (This functionality was added in PxPlus 2020.) |
TypeSizeLoc=1,649,467,66,66 |
Defines the screen mode, size and position. It is updated automatically by PxPlus when the session terminates. The first value represents screen mode: 1 (normal), 2 (minimized), or 3 (maximized). The second and third values represent window width and height in graphical units. The fourth and fifth values represent the window position, X and Y coordinates for the upper left corner in graphical units. |
Caption=text |
Default caption line to appear on the PxPlus main window. |
ToolBar=nnn |
Toolbar size. By default, the toolbar is set to the same size as the windows caption boxes. |
MessageBar=nnn |
Message bar size. By default, the message bar is set to the same size as the windows caption boxes plus a few pixels to allow for the 3D effect. |
Bold=0 | 1 |
Bold toggle. When set to 1, all foreground data is displayed as Bold. |
Charset=0 |
Character set (0=ANSI) -- DO NOT CHANGE! |
LockFont=0 | 1 |
Font locking. When set to 1, the user may not change the fixed-width font from the system menu (button in top left corner of the screen). |
Name=text |
Name of the default fixed-width font (e.g. Courier New). The fixed-width font name and size are used by PxPlus to determine the size of a column or row in a Window. |
Points=12 |
Default fixed-width font size. The fixed-width font name and size are used by PxPlus to determine the size of a column or row in a Window. |
SystemFontName=text |
Name of the default graphical font to use (e.g. Times New Roman). If this entry is omitted, then the system uses the Windows default system font. |
SystemFontPoints=12 |
Default graphical font size. |
TipFontName=text |
Name of the font to use in floating tips (e.g. Courier New). Default is 'MS Sans Serif'. |
TipFontPoints=10 |
Tip font size. Default is 10. |
Each of these section headings can be inserted into the PXPLUS.ini file to manually override specific defaults. The [ODBC], [OCI] and [DB2] INI parameters and settings are described along with corresponding SQL keywords (if available).
ACCESS=READ | WRITE | ||||||
AUTOCOMMIT=ON | OFF | ||||||
CHECK_DATES=Y | N Note: | ||||||
CONCURRENCY=READONLY | LOCK | OPT_VERSION | OPT_VALUE LOCK applies low-level record locking. OPT_VERSION causes optimistic locking with the database version control to be used. OPT_VALUE causes optimistic locking with comparing record/column values to be used. SQL keywords: SQL_CONCURRENCY, SQL_CONCUR_READ_ONLY, SQL_CONCUR_LOCK, SQL_CONCUR_ROWVER, SQL_CONCUR_VALUES | ||||||
CURSOR_TYPE=FORWARD | STATIC | KEYSET | DYNAMIC FORWARD indicates that any result sets can be read in a forward only direction. STATIC indicates that the result set is static. KEYSET forces the cursor to use/maintain record keys in a keyset. DYNAMIC indicates that the cursor is effective in the current row set only. SQL keywords: SQL_CURSOR_TYPE, SQL_CURSOR_FORWARD_ONLY, SQL_CURSOR_STATIC, SQL_CURSOR_KEYSET_DRIVEN, SQL_CURSOR_DYNAMIC | ||||||
CURSOR_USE=DRIVER | ODBC | IF_NEEDED DRIVER (Default) assumes the specific driver's own cursors. ODBC causes the ODBC interface to use the "Driver Managers" cursor library that may provide additional functionality not available within the database driver. IF_NEEDED tells the system to use the specific database driver's own cursor functionality unless the additional functionality is requested specifically. SQL keywords: SQL_ODBC_CURSORS, SQL_CUR_USE_DRIVER, SQL_CUR_USE_ODBC, SQL_CUR_USE_IF_NEEDED | ||||||
DATEFMT=text | ||||||
DB=dbname or QUALIFIER=dbname | ||||||
DEBUGIT=text | ||||||
EXTROPT=text | ||||||
ISOLATION=UNCOMMITED | COMMITED | REPEATABLE | SERIAL | VERSIONING Settings include: | ||||||
KEYSET_SIZE=n | ||||||
MAXROWS=n | ||||||
NULLPADKEY=x | ||||||
ORACLE=Y | N Defaults: ORACLE=Y (under [OCI]), ORACLE=N (under [ODBC]). | ||||||
POSUPDATE=x ODBC & DB2 - Use one of the following:
| ||||||
PREPARE=x | ||||||
PSWD=text Warning! | ||||||
ROWSET_SIZE=n | ||||||
TEXTMAX=n | ||||||
TIMEOUT=n | ||||||
TOP=n If n > 0, then PVX issues SELECT TOP n to reduce the data transferred. TOP= -1 indicates the driver supports TOP; however normal reading should not use it. Default is 0 (zero) - TOP not supported. | ||||||
UNIQUE=x | ||||||
USER=text |
Debug windows and their respective settings from PxPlus' Windows Debug Environment are saved in the INI file under the following section headings:
[TraceWindow]
[WatchWindow]
[BreakWindow]
[CommandWindow]