PLBWIN Keywords

The following keywords may be added to [environment] section of the program information file (PLBWIN.INI) to alter the behavior of the PLBWIN, PLBCON or PLBCE runtime. The runtimes accept existing keywords defined using the obsolete keyword prefixes of SUNDB or SDBWIN. All new keywords require the use the PLB prefix. The keywords may be placed in the user environment table using the SET utility or in the PLBWIN.INI file.

The .ini file name processing occurs as follows:

The runtime qualifies and uses an INI file when the file contains any section header. A section header is an INI file record that starts with '[' and is terminated with a ']'.
The runtime looks for and uses an INI filename found in three possible directories. The runtime always processes the INI files in the same order giving the user the ability to override globally defined parameters. The file name searching is as follows:

First, the runtime looks for an INI filename in the current working directory. This allows someone doing very specific and local program execution using keyword controls that override default keyword controls specified in (b) or (c) below.
Second, the runtime looks for an INI filename in the current user Windows directory. If the INI filename is found, it becomes the local keyword controls for the runtime. This allows someone to define workstation INI file controls. The local INI file controls can override (c) below.
Third, the runtime looks for an INI filename in the directory where PLBWIN.EXE is found. If the INI filename is found, it becomes the global (default) keyword controls for the runtime.

If the runtime is started without using the '-i' option, the runtime looks for the default INI file named 'PLBWIN.INI' in the three possible areas. Any PLBWIN.INI files found in the three directories are then used to locate requested INI file keywords in the order as described in (B) above.
If the runtime is started with the '-i' option being specified and the INI file name does not have a path specified, the runtime looks for the INI file name in the three possible directories defined in (B) above. The runtime only processes the user named INI file from the three directories defined in (b.) above. This means the 'PLBWIN.INI' is not used in this case.
If the runtime is started with the '-i' option being specified and the INI file name does have a path specified, the runtime looks for and uses the single specified INI file if found. This case disables the runtime from processing multiple INI files as described in (B) above.

It important to note that when modifying the INI files, unpredictable results can occur if the file is compressed by the process of editing it. If the user is using the Sunbelt Editor to change the file, the '-E' option should be specified to output a non-compressed file.

Keyword	Purpose
PLB_AAMCANCELCHAR	Specify the AAM read cancel key. (9.6)
PLB_AAMCHECKTIME	Define the time between checks for the AAM read cancel key. (9.6)
PLB_AAMUPPER	Specify the AAM uppercase translation file.
PLB_ADVSPOOLFILE95A	Controls advanced printing.
PLBWIN_ALLOWXPSDETECTION	Controls XPS Printer detection for SPLOPEN operations.
PLB_ANSI	Execute in ANSI compatible mode.
PLB_ANSIIO	Execute in ANSI compatible mode for IO operations.
PLB_ANSI_OEM	Control Windows character translation.
PLB_AUTH	Allow specification of the software authorization number in lieu of the DBSERIAL file.
PLB_AUTOFOCUS	Automatically set the focus to a defined EDITTEXT object.
PLB_AUTOISICOMPACT	Control the automatic ISI compaction behavior.
PLB_BGFG	Define the default foreground and background screen colors.
PLB_CASE	Enable external label case sensitivity.
PLB_CDFDELMDEFAULT	Define the default CDF delimiter.
PLB_CGI_DIR	Define the directory for the CGI temporary files.
PLB_CHECKFILE2GB	Disables the 2GB file size limit checking by Windows runtimes.
PLB_CHKDRN	Enables ISI data record validation for ISAM WRITE operations.
PLB_CLOCKDATE	Specify the format of the date returned by the CLOCK DATE instruction.
PLB_CLOCKERROR	Modify the behavior of the CLOCK ERROR instruction.
PLB_CLOCKUSEIP	Retrieve time and date values from the Sunbelt Data Manager.
PLB_COMPRESSION	Enable or disable data manager message compression.
PLB_COPYFILEBUFFERSZ	Specify the buffer size for the COPYFILE instruction.
PLB_CURRENCY	Redefine the currency symbol.
PLB_CURDIR	Define the current working directory.
PLBWIN_DEADLOCKTIMEOUT	Define a new deadlock timeout value.
PLB_DEBUG	Enable internal runtime debugging.
PLB_DECIMAL	Define the decimal point symbol.
PLBAS_DEFAULTCWD	Allow specification of the automation server's working directory.
PLBWIN_DISPFLUSH	Force immediate output of KEYIN or DISPLAY characters.
PLB_DMALTIP	Specifies Data Manager alternate IP addresses.
PLB_DMCHILDRECOVERY	Controls child task recovery operations.
PLB_DMKEEPACTIVE	Keep data manager connections active.
PLB_DMKEEPALIVE	Controls Data Manager keep-alive processing.
PLBWIN_DOSCOLORS	Enable use of MS-DOS style colors.
PLB_DOSCMDLN	Enable storage of complete command line.
PLBWIN_DOSFONT	Enable embedded dos font.
PLB_DPT	Execute in Datapoint compatible mode.
PLB_DPTFILENAME	Disable Datapoint file name processing.
PLB_DYNAMICLOADMOD	Defines LOADMOD memory usage.
PLBWIN_EDIT	Redefine the Edit menu item name.
PLBENV	Define a file name or path alias.
PLB_EOR	Redefine the logical end of record mark.
PLBWIN_ERRLOCKTIMEOUT	Redefine the lock timeout.
PLB_ERRORLOG	Specifies a path and filename of a file where untrapped PL/B program errors are to be logged.
PLB_EXTEND_OPENUSEIP	Extends PLB_OPENUSEIP to include AAMDEX, INDEX, SORT, FINDDIR, and COPYFILE.
PLB_EXTENDEDSEL	Creates DATALIST objects with extended styles.
PLB_EXTLIB32	Specifies the name of the DLL accessed during EXTCALL instructions.
PLB_F10	Allow the F10 to be a PL/B function key.
PLB_F31	Disable F31 key when a GUI event terminates a KEYIN.
PLB_FIXED	Use 8.1 style disk writes.
PLBWIN_FILE	Redefine the File menu item name.
PLBWIN_FBOLD	Set the bold attribute for the default main window font.
PLB_FNC	Convert file names to lower case.
PLBWIN_FONT	Redefine the default font.
PLBWIN_FSIZE	Redefine the default font size.
PLB_GLOBALSIZE	Define the Global Memory size.
PLBWIN_HELP	Redefine the Help menu item name.
PLBWIN_ICON	Replace the default application icon.
PLB_IOCANCELCHAR	Specify the AAM or ISAM read cancel key. (9.6A)
PLB_IOCHECKTIME	Define the time between checks for the FILE, AFILE, or IFILE read cancel key. (9.6A)
PLB_ISI_CACHE	Control ISAM file caching.
PLB_ISIRECOVER	Modify ISAM recovery handling.
PLB_LOADLIBSSL_FIRST	Attempts to load SSL 1.1.x libraries first.
PLB_LOCALE	Modify Windows locale settings.
PLB_LOCALIP	Define the local IP address of the data manager.
PLB_LOCKIO	Special record locking control.
PLB_LOGON	Specify the data manager logon key.
PLB_DBGLOGON	Specify the GUI debugger logon IP address and port number.
PLB_MAXDMRECVTIME	Maximum data manager receive time.
PLB_MONDECIMAL	Redefine the monetary decimal symbol.
PLB_MONTHOUSAND	Redefine the monetary thousand separator symbol.
PLB_NDUP	Disallow duplicate keys in ISAM files.
PLB_NET	Alter CLOCK SYSPORT behavior.
PLB_NL	Ignore new line characters in KEYIN instructions.
PLB_NOFKEYSTR	Disable placement of the function key string mnemonics in the S$ERROR$ common variable.
PLBWIN_NOHELP	Create the main window without the Help menu item.
PLB_NOINT	Disable interruption of *W and PAUSE instructions.
PLB_NOPATH	Disable storage of path information in AFILEs or IFILEs by PREPARE.
PLB_OPENABS	Restrict file opens to one mode.
PLB_OPENUSEIP	Specify default ip address used for all non-redirected file OPENs.
PLB_OPENUSESQL	Specify default sql tag for all OPENs without a tag.
PLB_OSIDLETIME	Return unused time to OS after a file lock fails.
PLB_PATH	Define the initial search path for files and programs.
PLBWIN_PDFDEFPRTMETRICS	Define the default state that enables or disables the default printer used for rendering fonts for PDF generation.
PLB_PORT	Specify the port number returned in a CLOCK PORT instruction.
PLB_PREP	Define the default directory for files created with PREPARE.
PLB_PREP87	Control the format of ISAM and AAM files created by the PREPARE instruction.
PLB_PREPBYMFD	Control detection of MFD by the PREPARE instruction.
PLB_PREPUSEIP	Specify default ip address used for all non-redirected file PREPAREs.
PLB_PREPUSESQL	Specify default sql tag used for all PREPAREs with a tage definition.
PLB_PRTDEBUG	Enable LPT port print debugging.
PLBWIN_PRTPAGELOCALE	Define the decimal format for FORM variables output via PRTPAGE.
PLBWIN_PRTPREV	Define Print Preview window captions.
PLB_PRTRETRY	Define the print retry count.
PLBWIN_PRTSCR	Add a print screen menu item to the main window's menu.
PLB_PRTTIME	Redefine the Windows printer wait time.
PLB_PUBLIC	Specify the data manager public key.
PLBWIN_QNAME	Employs special name qualification procedures.
PLB_QUIET	Control the runtime banner display.
PLB_RDCLR	Clear variables upon unsuccessful ISAM or AAM read.
PLB_READMODE	Allows file opens in READ mode to actually open a file in SHARE mode.
PLB_RECORDLOCK	Define the record locking mode.
PLB_RETRYEXECUTE	Control EXECUTE retry logic.
PLB_RETURNUNCNAME	Control the value returned while drive substitution is active.
PLBWIN_RMSRASXLATE	Specify the RMS RAS translation file.
PLB_ROUND	Round numbers according to ANSI specification.
PLB_SAVECHARSIZE	Control the character attribute size.
PLB_SCHEMA	Declares the default database file.
PLB_SHARE	Disable notification of SHARE load failure.
PLB_SHAREFLUSH	Disable automatic flushing of data to files opened in SHARE mode.
PLB_SHIFTAZ	Control keyboard shift inversion.
PLB_SKIPFOCUS	Ignore gain for event when returning to window.
PLB_SPLEXT	Enable use of the user defined spool file extension.
PLB_SPLUSEIP	Define the IP address of the Sunbelt Data Manager for print spooling.
PLB_SSL_VERSION	Control the version of SSL libraries used.
PLB_SUBTABFORENTER	Control the tab key substitution.
PLBWIN_SYSPORT	Define a string returned to the CLOCK SYSPORT instruction.
PLB_SYSTEM	Define the location of the runtime authorization file.
PLBWIN_TABCTLUPDATE	Control updating of objects on a TABCONTROL.
PLB_TERM	Define an alternate screen definition file.
PLBWIN_TERMINAL	Allow scaling of the size and font for the Main Window.
PLBWIN_TERMINAL_DEBUG	Allow scaling of the size and font for the Debug Window.
PLB_THOUSAND	Redefine the numeric one thousand separator symbol.
PLB_U10_PROGNAME	Define a program name is to be output when a U10 error occurs.
PLB USEDBCTYPE	Enable SWDBC TYPE instruction support.
PLB USERUNEXT	Control default utility file name extensions.
PLBVOL	Define Datapoint drive or environment alias.
PLBWIN_W33RETRY	Allows read retries.
PLBWIN_WINHIDE	Primary window is initially hidden.
PLB_WRTERROR	Generate an error if data written to a fixed length
PLBWIN_XPIO	Reset EOF before disk writes.

PLB Service Execution Keywords

Keyword	Purpose
PLB_SERVICE_AUTOSTART	Controls the service autostart feature.
PLB_SERVICE_CMDLINE	Specifies a runtime command line without the module name.
PLB_SERVICE_DELAY	Defines the time to wait before taking a failure action.
PLB_SERVICE_DESC	Specifies a descriptive string for the runtime NT service.
PLB_SERVICE_FAIL	Defines the action to take upon a runtime NT service failure.
PLB_SERVICE_RESTART	Controls the restarting of the NT service.

Automation Sever Administrative Keywords

Keyword	Purpose
ADMIN_DATACLR	Clears data items kept by the main server task.
ADMIN_DATASET	Sets data items kept by the main server task.
ADMIN_HOSTNAME	Specifies the admin host address.
ADMIN_HOSTNAME6	Specifies the admin host address in Internet Protocol Version 6 format.
ADMIN_IPFILE	Enables IP Filtering.
ADMIN_KEYFILE	Defines the LOGON key file.
ADMIN_LOGCHILD	Control logging of child tasks.
ADMIN_LOGLEVEL	Define the initial logging level for all tasks.
ADMIN_LOGON	Specifies a user provided logon encryption key.
ADMIN_LOG_RECSIZE	Specifies the maximum admin log record length.
ADMIN_LOG_RECVAR	Specifies that admin log records are variable length.
ADMIN_PORTNUM	Defines the port number of the admin task.
ADMIN_PUBLIC	Specifies a user provided public encryption key.
ADMIN_SUPPORT	Controls the creation of the admin task.

SQLIO Access Keywords

Keyword	Purpose
PLB_SQLIO_CONN	Define addition login information for SQLIO connections.
PLB_SQLIO_DEBUG_LOG	Identifies the debug log file for SQLIO.
PLB_SQLIO_DRIVER	Identifies the type of SQL connection for SQLIO.
PLB_SQLIO_EXT	Define the optional extension data for SQLIO connections.
PLB_SQLIO_FLAGS	Define any special settings for SQLIO connections.
PLB_SQLIO_HOST	Define the default host name for SQLIO connections.
PLB_SQLIO_INIT	Define a database initialization command.
PLB_SQLIO_PASS	Define the default password for SQLIO connections.
PLB_SQLIO_SCOPEID	Controls the SQLIO use of the IDENITY value.
PLB_SQLIO_SQLTYPE	Define the SQL syntax for SQLIO connections.
PLB_SQLIO_USER	Define the default user name for SQLIO connections.
PLB_SQLSCHEMADB	Define the schema database name for SQLIO.
PLB_SQLTABLEDB	Define the schema database tables name for SQLIO.

WEBMODE Keywords

Keyword	Purpose
PLBWIN_WEBMODEHTMLCTRL	Controls the WebMode processing used when an HTMLCONTROL object is created.
PLBWIN_WEBMODEPLF	Sets WebMode processing for PLF Forms.
PLBWIN_WEBMODEPWF	Sets WebMode processing for PLF Forms.