skip to main content

Compiler and Runtime : Configuration : Configuration Properties

Configuration Properties
The following tables list all the available configuration properties.
Licenses Configuration
Licenses properties cannot be set by SET ENVIRONMENT within the program. They must appear in the external configuration.
Compiler Configuration
Compiler properties cannot be set by SET ENVIRONMENT within the program. They must appear in the external configuration.
True = field names that begin with a number are registered as they are in the EFD/ISS dictionaries.
False = field names that begin with a number are registered with a leading underscore in the EFD/ISS dictionaries.
If omitted, False is assumed.
0 = Do not show
1 = Show as Informational
2 = Show as Warning
3 = Show as Error
4 = Show as Severe Error
Lists compiler options. Refer to the Compiler Options section for further details. These options are used along with the ones specified on the command-line. Multiple options must be separated by space.
Properties for the EasyLinkage feature
True = The EasyLinkage feature is turned on and it generates bridge classes for each compiled COBOL program.
False = The EasyLinkage feature is turned off. No bridge classes are generated.
For example: if a data item is named "lnk-p1" and this property is set to "lnk-", then the item will be considered as "p1".
True = Linkage Section data items name is capitalized according to Java rules in order to build the name of the corresponding Java object in the bridge program.
False = Linkage Section data items name is normalized according to COBOL rules (it’s made uppercase replacing hyphens with underscores) in order to build the name of the corresponding Java object in the bridge program.
Database Bridge (EasyDB) Configuration
True = The Compiler generates bridge classes that allow the COBOL programs to access RDBMS in the same way as they do with ISAM indexed files.
False = No bridge class is generated.
True = Generate EDBI routines suitable for IBM DB2.
False = Don’t generate EDBI routines suitable for IBM DB2.
True = Generate EDBI routines suitable for IBM DB2 on AS/400.
False = Don’t generate EDBI routines suitable for IBM DB2 on AS/400.
True = Generate generic EDBI routines.
False = Don’t generate generic EDBI routines.
The default value is False, however generic EDBI routines are generated by default if compiler.easydb is true and all the easydb.<rdbms> properties are false.
True = Generate EDBI routines suitable for Informix
False = Don’t generate EDBI routines suitable for Informix.
True = Generate EDBI routines suitable for MySQL.
False = Don’t generate EDBI routines suitable for MySQL.
True = Generate EDBI routines suitable for Oracle.
False = Don’t generate EDBI routines suitable for Oracle.
True = Generate EDBI routines suitable for PostgreSQL.
False = Don’t generate EDBI routines suitable for PostgreSQL.
True = Generate EDBI routines suitable for Microsoft SQL Server.
False = Don’t generate EDBI routines suitable for Microsoft SQL Server.
0 = No pagination
1 = Pagination only when using a UNIQUE index
2 = Pagination for every index
This property specifies the name of the OID column generated when easydb.light_cursors=2. It’s considered only for MySQL.
True = Map alphanumeric COBOL fields to CHAR on the database.
False = Map alphanumeric COBOL fields to VARCHAR on the database.
True = Use ISAM positioning rules on end of file.
False = Don’t use ISAM positioning rules on end of file.
0 = No action
1 = Write zero instead of non-numeric values
2 = Same as "1", but with trace. The trace is stored in the file pointed by the iscobol.edbi.notnum.tracefile runtime setting.
0 = Don’t use the latin1_general_bin collating sequence
1 = Use latin1_general_bin during CREATE TABLE
2 = Use latin1_general_bin during ORDER BY
True = Every field with EFD DATE directive becomes a DATETIME, regardless of the date format string.
False = Fields with EFD DATE directive become DATE, TIME or DATETIME according to the date format string.
True = Use the string representation to deal with dates.
False = Use conversion functions to deal with dates.
True = Return records with duplicate key values in the primary key order.
False = Return records with duplicate key values as you read them from the database.
True = Use leading zeroes in OCCURS item names.
False = Don’t use leading zeroes in OCCURS item names.
True = Replace high-values with the maximum value allowed by the field.
False = Don’t replace high-values in the fields.
0 = Don’t use hints.
1 = Use hints but keep the ORDER BY in they query
2 = Use hints and discard the ORDER BY in the query, assuming that records will be sorted according to the index set by the hint.
0 = Never wait for locks and return an error instead
1 = Always wait for locks
2 = Wait for locks or return an error depending on the iscobol.easydb.wait_for_lock (boolean) runtime setting
True = Enable the support for UNLOCK ALL statement.
False = It’s not possible to perform UNLOCK ALL.
True = Don’t check for table existence during OPEN.
False = Check for table existence during OPEN.
Note - disabling the check of table existence may improve performance, especially if your programs use the OPEN statement a lot. However, there are also few side effects, for example, since the OPEN will never fail with ‘file not found’ you will not be able to create with I$IO having io_creates=1 in the configuration. Also, if the table doesn’t exist but the OPEN doesn’t fail, you might have odd errors in the next operations.
True = Generate entry-points in the EDBI routine where the user can inject customized code.
False = Don’t generate entry-points.
Service Bridge Configuration
True = The Compiler generates bridge classes that allow the COBOL programs to be used as a Web Service.
False = No bridge class is generated.
SOAP = Generate beans for SOAP Web Services
REST = Generate beans for REST Web Services
SOAP = SOAP Web Service
REST = REST Web Service
Document = use Document style
RPC = use RPC style
General Runtime Configuration
(*) The asterisk after the property name means that the property is static, it’s inquired only once by the Framework and then changing it using the SET ENVIRONMENT statement has no effect.
True = Array boundaries are checked at Runtime in order to provide more details in case of "out of bounds" errors. If a program addresses an item that is outside the valid range, an error message is shown and the program exits. The error message informs about the data item name and the problematic index value.
False = Array boundaries are not checked. If a program addresses an item that is outside the valid range, a generic "out of bounds" error message is shown and the program exits. The -m1 option may avoid the crash and make the program access the area of the next Working-Storage item instead.
True = an exception is thrown for USAGE DISPLAY numeric and numeric-edited variables that don’t contain a number.
False = no exceptions are thrown for USAGE DISPLAY numeric and numeric-edited variables that don’t contain a number.
0 = Results are undefined.
1 = The program aborts with the error message "Attempt to divide by zero".
2 = The result is zero.
3 = The result is the dividend, as if the division was by 1 instead of by zero.
CALL STATEMENT
isrun and iscrun commands
All classes loaded from code_prefix are loaded into memory each time they are called, if the program cancels these classes from memory (see CANCEL STATEMENT). A class is reloaded from disk only if the disk file last modification timestamp is different from the last modification timestamp of the class loaded in memory.
the configuration variable jver will have the value “1.7.0_65” (assuming that you’re working with this JVM) and the configuration variable hello will have the value “Hello, World!”
Refer to the table in C$GETENV documentation for a list of Java properties that you can include between delimiters.
0 = MM/DD/YY is used.
1 = DD/MM/YY is used.
0 = C convention.
1 = PASCAL (or WINAPI) convention.
0 = All messages are shown in a message box.
1 = All messages are sent to sysout. In a thin client environment, runtime error messages are sent to the server sysout while messages displayed by the program are sent to the client sysout.
2 = All messages are sent to syserr. In a thin client environment, runtime error messages are sent to the server syserr while messages displayed by the program are sent to the client syserr.
3 = Runtime error messages are printed to a file named <program_name><number>.ads.log, while messages displayed by the program are sent to the syserr (client syserr in thin client).
True = Produces "Abend Diagnostic Snapshot" (ADS) in addition to Java exceptions
False = No ADS is produced in addition to Java exceptions
True = Internal java methods are traced in exception messages. There’s no point in compiling with -g option in this case.
False = COBOL paragraph names are traced in exception messages.
0 = Messages are shown in a message box.
1 = Messages are sent to sysout. In a thin client environment, they’re sent to the server sysout.
2 = Messages are sent to syserr. In a thin client environment, they’re sent to the server syserr.
3 = Messages are printed to a file named <program_name><number>.ads.log
For example, setting iscobol.exception.prefix=/tmp/ will create the file under the /tmp directory, while setting iscobol.exception.prefix=xx will create the file under the current directory and its name will start with 'xx'.
iscobol.hot_key.ProgramName
when iscobol.as.multitasking is set to a value greater than 0 in the configuration.
True = all the computations involving a number with a fractional part are performed using a precision of 36 decimal digits.
False = all the computations involving a number with a fractional part are performed using a precision of 18 decimal digits.
True = literals are treated as USAGE COMP in LENGTH OF functions and other integer functions.
False = literals are treated as USAGE DISPLAY in LENGTH OF functions and other integer functions.
True = Native numeric data items are stored in Little Endian format.
False = Native numeric data items are stored in Big Endian format.
True = Append content to the existing log file, if it exists
False = Overwrite the existing log file, if it exists
This property specifies how many log files can be kept on disk when iscobol.logfile.maxlen is set. The name of these log files is a concatenation between the value of iscobol.logfile and a progressive number starting from zero. It’s good practice to set this property to a value not less than 2 in order to preserve a bit of history of the program activity.
True = Activates Acucobol-GT compatibility on configuration, that means:
OPENSAVE-BROWSE-FOLDER starts from Computer rather than the current directory if opnsav-default-dir isn’t set
False = Doesn’t activate Acucobol-GT compatibility on configuration
True = Working-Storage and FD data are shared between programs called in recursion.
False = Each recursive program has its own Working-Storage and FD.
If the called programs were compiled with -cp, then the iscp protocol must be used instead of isc, e.g.
True = Activates the RM/COBOL development mode.
False = Disables the RM/COBOL development mode.
Note - this setting has currently no effect.
0 = The program starts in run mode and the Remote Debugger is not active.
1 = The program starts in run mode and the Runtime Framework listens for connections from the Remote Debugger.
2 = The program starts in debug mode and the Runtime Framework waits for connections from the Remote Debugger.
True = Every program compiled with the -sddp option shows the comma as the decimal separator and the dot as the thousand separator, regardless of the DECIMAL-POINT clause in the Special Names.
False = Every program compiled with the -sddp option shows the dot as the decimal separator and the comma as the thousand separator, regardless of the DECIMAL-POINT clause in the Special Names.
True = No errors are returned if the dyncall native library cannot be loaded during startup.
False = An error is returned if the dyncall native library cannot be loaded during startup.
True = No errors are returned if the stacall native library cannot be loaded during startup.
False = An error is returned if the stacall native library cannot be loaded during startup.
True = String boundaries are checked at Runtime in order to provide more details in case of "out of bounds" errors. If a program addresses an invalid character position, an error message is shown and the program exits. The error message informs about the data item name and the problematic character position.
False = String boundaries are not checked. If a program addresses an item that is outside the valid range, a generic "out of bounds" error message is shown and the program exits. The -m1 option may avoid the crash and make the program access the area of the next Working-Storage item instead.
True = a reference modifier with length = 0 behaves as if length was omitted (e.g. src-item(2:0) behaves like src-item(2:), so that the content of src-item from byte 2 to the end is returned).
False = a reference modifier with length = 0 returns a variable whose length is 0 (e.g. src-item(2:0) returns "").
True = inquire the system to obtain the screen resolution each time TERMINAL-INFO is accepted from TERMINAL-ABILITIES.
False = inquire the system to obtain the screen resolution only the first time TERMINAL-INFO is accepted from TERMINAL-ABILITIES. Return the stored values to the next ACCEPT statements.
1 = Settings of environment variables. Configuration properties set in the command line or in the external environment are not traced in the logfile. Only the properties found in the configuration file and the properties set by the program are traced. The list of processed configuration files is also traced.
2 = Program starts and program ends.
4 = Paragraph starts and paragraph ends as well as method starts and method ends (program must be compiled with -d or -dx).
8 = File I/O activities.
16 = Content of keys (works only in conjunction with 8).
32 = Content of record (works only in conjunction with 8).
64 = Client / Server activity in terms of connection and disconnection (isCOBOL Server environment).
128 = RPC calls for communication between client and server (isCOBOL Server environment).
256 = SQL activity.
512 = Complementary information to the one shown by pressing the Alt+Pause keyboard combination.
1024 = Library routine starts and library routine ends. It works only in conjunction with the value 2.
The log file name is controlled by the property iscobol.logfile. If the property is not set, then a file named “iscobol0.log” is created in the temp folder.
True = The content of PIC N items is stored in UTF-16 Little Endian encoding.
False = The content of PIC N items is stored in UTF-16 Big Endian encoding.
Remote Compiler Configuration
Remote Compiler properties cannot be set by SET ENVIRONMENT within the program. They must appear in the external configuration.
True = After precompiling, the Remote Compiler compiles the translated cbl to class on the server and sends the resulting class along with the translated cbl to the client.
False = After precompiling, the Remote Compiler sends the translated cbl to the client.
True = The Remote Compiler will ask preprocessors to create error files.
False = No error files will be created by preprocessors.
True = The Remote Compiler will ask preprocessors to create listing files.
False = No listing files will be created by preprocessors.
Web Direct 2.0 Configuration
Web Direct 2.0 properties cannot be set by SET ENVIRONMENT within the program. They must appear in the external configuration.
bs = Bootstrap styling (see http://getbootstrap.com/ for details)
default = default styling
os = OS styling
trendy = Trendy styling
HTTPHandler Configuration
(*) The asterisk after the property name means that the property is static, it’s inquired only once by the Framework and then changing it using the SET ENVIRONMENT statement has no effect.
True = Set the value of numeric data items to zero and non-numeric data items to spaces if a CGI variable is empty or does not exist.
False = Don’t clear the value of data items if a CGI variable is empty or does not exist.
True = "Pragma: no-cache" is added to the HTTP response header.
False = "Pragma: no-cache" is not added to the HTTP response header.
True = All the cookies can be read through the accept() method as if they were input fields. The cookie name is case sensitive.
False = Cookies can’t be read through the accept() method.
This property lists the paths which HTML files are searched by HTTPHandler:>processHtmlFile(). Multiple values must be separated by the line feed character or by the current operating system path separator.
This property specifies the prefix to put before the program name in the URL in order to build the name of the actual COBOL program. For example, given the following URL: http://localhost:8080/myservlet/servlet/isCobol(PROG) , if iscobol.http.servlet.prefix=soap, the framework will run the program SOAPPROG instead of PROG.
True = Programs are automatically cancelled from memory when the main program returns (stateless).
False = Programs remain in memory unless explicitly cancelled by a CANCEL statement (stateful)
True = Embedded values in the HTML code are expected to be prefixed by colon, E.g. <html>hello :myvar world</html>.
False = Embedded values in the HTML code are expected to be enclosed by double percent sign, E.g. <html>hello %%myvar%% world</html>.
True = Enables logging of the REST activity at global level.
False = No log of the REST activity is performed at global level.
True = Enables logging of the REST activity for the specified method name .
False = No log of the REST activity is performed the specified method name .
True = Enables logging of the SOAP activity at global level.
False = No log of the SOAP activity is performed at global level.
True = Enables logging of the SOAP activity for the specified method name .
False = No log of the SOAP activity is performed the specified method name .
User Interface Configuration
(*) The asterisk after the property name means that the property is static, it’s inquired only once by the Framework and then changing it using the SET ENVIRONMENT statement has no effect.
Graphical User Ingerface (GUI)
0 = The background color is high intensity.
1 = The background color is forced to low intensity.
2 = The background color is forced to high intensity.
For example if you want a blue foreground on a white background, set iscobol.colormap.default=258 where 258 is the result of the sum between bckgrnd-white (256) and blue (2).
For example if you want a bright blue foreground on a white background, set iscobol.colormap.high=266 where 266 is the result of the sum between bckgrnd-white (256) and bright-blue (10).
For example if you want a blue foreground on a white background, set iscobol.colormap.low=258 where 258 is the result of the sum between bckgrnd-white (256) and blue (2).
The value format is: FontName-FontStyle-FontDim
FontName is the name of the font. The default value is Sans Serif.
FontStyle is the style of the font such as bold, italic, or bolditalic.
FontDim is the dimension of the font.
If FontName cannot be found, then FontStyle and FontDim are applied to the standard default font (Sans Serif); no error is raised.
This property specifies a custom cell size for the default font. The value format is x,y where x and y are the width and height of the cell in pixels.
The value format is: FontName-FontStyle-FontDim
FontName is the name of the font. The default value is Monospaced.
FontStyle is the style of the font such as bold, italic or bolditalic.
FontDim is the dimension of the font.
If FontName cannot be found, then FontStyle and FontDim are applied to the standard fixed font (Monospaced); no error is raised.
This property specifies a custom cell size for the fixed font. The value format is x,y where x and y are the width and height of the cell in pixels.
0: VALUE_ANTIALIAS_DEFAULT is used for all controls
1: VALUE_ANTIALIAS_ON is used for all controls
2: VALUE_ANTIALIAS_OFF is used for all controls
3: VALUE_ANTIALIAS_OFF is used for Frame, List-Box and Grid controls, as it happened in version 2013 R2 and previous.
The value format is: FontName-FontStyle-FontDim
FontName is the name of the font. The default value is SansSerif.
FontStyle is the style of the font such as bold, italic or bolditalic.
FontDim is the dimension of the font.
If FontName cannot be found, then FontStyle and FontDim are applied to the standard large font (Sans Serif); no error is raised.
This property specifies a custom cell size for the large font. The value format is x,y where x and y are the width and height of the cell in pixels.
The value format is: FontName-FontStyle-FontDim
FontName is the name of the font. The default value is SansSerif.
FontStyle is the style of the font such as bold, italic or bolditalic.
FontDim is the dimension of the font.
If FontName cannot be found, then FontStyle and FontDim are applied to the standard medium font (Sans Serif); no error is raised.
This property specifies a custom cell size for the medium font. The value format is x,y where x and y are the width and height of the cell in pixels.
The value format is: FontName-FontStyle-FontDim
FontName is the name of the font. The default value is SansSerif.
FontStyle is the style of the font such as bold, italic or bolditalic.
FontDim is the dimension of the font.
If FontName cannot be found, then FontStyle and FontDim are applied to the standard small font (Sans Serif); no error is raised.
This property specifies a custom cell size for the small font. The value format is x,y where x and y are the width and height of the cell in pixels.
The value format is: FontName-FontStyle-FontDim
FontName is the name of the font. The default value is Monospaced.
FontStyle is the style of the font such as bold, italic or bolditalic.
FontDim is the dimension of the font.
If FontName cannot be found, then FontStyle and FontDim are applied to the standard traditional font (Monospaced); no error is raised.
This property specifies a custom cell size for the traditional font. The value format is x,y where x and y are the width and height of the cell in pixels.
True = The Accept timer is reset after each time the user inputs a new digit.
False = The Accept timer stops as soon as the user inputs the first digit.
True = Control whose colors are not specified by the program inherit colors from the parent window.
False = Control whose colors are not specified by the program inherit colors from the Look And Feel.
iscobol.gui.Control.event
This property specifies the value of EVENT-LIST property for all controls of class Control which EVENT-LIST property is not specified in Web Direct 2.0 environment.
Control can be one of the following:
MODFIY window-handle VISIBLE|ENABLED
when iscobol.gui.cstimeout * has expired or when the buffer size reaches the value specified by iscobol.gui.csmaxbuffersize *.
0 = no compression
1 = best compression
2 = fastest compression
MODIFY window-handle VISIBLE|ENABLED
when iscobol.gui.cstimeout * has expired or when the buffer is full.
MODFIY window-handle VISIBLE|ENABLED
when the buffer size reaches the value specified by iscobol.gui.csmaxbuffersize * or when the timeout specified by this property has expired.
For example, if you want a bright blue background on the current field, set iscobol.gui.curr_bcolor=9, or, if you prefer to use RGB values, set iscobol.gui.curr_bcolor=-255
iscobol.gui.curr_ef_bcolor is supported for backward compatibility and it affects only EntryFields.
For example, if you want a bright blue foreground on the current field, set iscobol.gui.curr_fcolor=9, or, if you prefer to use RGB values, set iscobol.gui.curr_fcolor=-255
iscobol.gui.curr_ef_fcolor is supported for backward compatibility and it affects only EntryFields.
True = A date validation is automatically performed when the user leaves a DateEntry field. If the date is not valid, an error message is shown and the focus is kept on the field. You can configure the message text by setting iscobol.gui.date_entry.errormessage.
False = No validation is automatically performed when the user leaves a DateEntry field.
0...the color specified by this property is always applied. This is the default behavior.
1...the color specified by this property is applied only if the COLOR property was not used on the Entry-Field.
True = An error message is shown when the user puts an alphabetic value into a numeric entry-field.
False = A beep is played when the user puts an alphabetic value into a numeric entry-field.
For example, if you wish to force the Windows line separator set iscobol.gui.ef_lineseparator=\r\n in the configuration file or use SET ENVIRONMENT "gui.ef_lineseparator" TO x"0d0a" in the COBOL program.
0...the color specified by this property is always applied. This is the default behavior.
1...the color specified by this property is applied only if the COLOR property was not used on the Entry-Field.
True = Moving the mouse over a read-only field, the mouse shape remains an arrow
False = Moving the mouse over a read-only field, the mouse shape changes to a vertical bar
True = All controls for which the EXCLUDE-EVENT-LIST property is not specified assume EXCLUDE-EVENT-LIST=1
False = All controls for which the EXCLUDE-EVENT-LIST property is not specified assume EXCLUDE-EVENT-LIST=0
True = Pressing F4 when the focus is on a ComboBox causes the list of values to be expanded.
False = Pressing F4 when the focus is on a ComboBox causes the Accept to be interrupted with a value of 4 in the crt status.
True = Entry field controls that do not have boxed style or 3-D style set use no-box style by default.
False = Entry fields controls that do not have boxed style or 3-D style set use box style by default.
True = During Accept the runtime has to refresh the values of the variables defined in SCREEN SECTION.
False = During Accept the runtime doesn’t refresh the values of the variables defined in SCREEN SECTION.
True = Additional Finish-Reason values are returned by the MSG-FINISH-ENTRY event in Grid.
False = Standard Finish-Reason values are returned by the MSG-FINISH-ENTRY event in Grid.
True = Grid columns of grids with the Adjustable-Columns style are automatically resized when the window is resized and a layout manager is involved.
False = Grid columns are not affected by layout managers.
The Grid property Lm-On-Columns has priority over this setting.
True = Grids don’t fire drag events.
False = Grids fire drag events.
The Grid style No-Cell-Drag has priority over this setting.
-1 = no limit on buffering
0 = disable keyboard buffering
>0 = specifies the number of keyboard events that must be bufferized
iscobol.gui.icon (boolean) *
True = The isCOBOL logo is displayed on the windows of the program.
False = The Java logo (coffee cup) is displayed on the windows of the program.
This property doesn’t affect independent windows unless iscobol.gui.independent.icon is set to true.
True = No error is returned.
False = An "Invalid handle" message is shown and the program terminates.
True = You can show a custom icon on INDEPENDENT, DOCKING and MDI-PARENT windows by setting their Icon property. Alternatively you can show the isCOBOL logo on independent windows by setting iscobol.gui.icon=true.
False = You can’t show a custom icon on INDEPENDENT, DOCKING and MDI-PARENT windows by setting their Icon property. The Java logo (coffee cup) is used.
True = Numeric and edited fields are automatically right-aligned.
False = Numeric and edited fields are left-aligned, unless otherwise specified.
True = Spaces on the right side of the title label are trimmed away.
False = Spaces to the right of the title label are not removed.
True = lists dropped by menu bar and combo-boxes as well as tool-tips are in the background and can be covered by a web-browser control on the screen.
False = lists dropped by menu bar and combo-boxes as well as tool-tips are in the foreground and cannot be covered by any control.
True = ListBox columns are automatically resized when the window is resized and a layout manager is involved.
False = ListBox columns are not affected by layout managers.
The ListBox property Lm-On-Columns has priority over this setting.
True = menu bar items with no subitems require two steps in order to be selected by keyboard: press Alt+keyletter to activate the item and press Enter to select it (Java Swing behavior).
False = menu bar items with no subitems are selected by keyboard by just pressing Alt+keyletter.
True = the Screen Section name of controls is shown in the message box produced by pressing Alt+Pause.
False = the internal name of controls is shown in the message box produced by pressing Alt+Pause.
True = a LAF dependent border is applied to all controls with a BOXED style (e.g. EntryFields, ComboBoxes, Grids...). It doesn’t work on controls with the 3-D style.
False = a standard black border is applied to all controls with a BOXED style unless the Border-Color property is set for them.
True = Push-Buttons can always be activated by pressing Enter when they have the focus.
False = Push-Buttons can be activated by pressing Enter when they have the focus only if the iscobol.key.enter setting includes "termination=13".
True = click on Push-Button is always intercepted even if the focus was forced on an input field by setting Screen-Control items in the field After Procedure.
False = click on Push-Button is not intercepted if the focus was forced on an input field by setting Screen-Control items in the field After Procedure.
-2 = Clicking on the close button has no effect.
0 = Clicking on the close button closes the window and the program terminates.
>0 = Clicking on the close button raises an exception on the current ACCEPT. The CRT STATUS variable is set to the value of quit_mode.
True = stuff is displayed after the last item on line line-number.
False = stuff is displayed at line line-number column 1.
True = leading zeroes are shown when displaying numeric data
False = leading zeroes are not shown when displaying numeric data
True = all graphical controls are TEMPORARY by default
False = all graphical controls are PERMANENT by default
The default value is http://www.veryant.com.
Setting the property to com.iscobol.gui.client.swing.JDICWebBrowser requires that you install JDIC separately, since this component is no longer distributed along with isCOBOL.
Setting the property to com.iscobol.fx.JFXWebBrowser requires Java7 or higher. With this implementation the MSG-BEFORE-NAVIGATE event is never fired.
Note - JavaFX is not a real web-browser, it's a web-view component that interpretes html, dom, css and javascript content. Therefore there are some limitations if you compare it with a real web-browser, for example:
mailto: and ftp: protocols are not supported
The default value is: com.iscobol.dj.DJWebBrowser
True = No-Msg-Before-Navigate style is implicitly defined for all Web-Browser controls.
False = No-Msg-Before-Navigate style is not implicitly defined for all Web-Browser controls.
True = a window with the AUTO-RESIZE style can be resized only to a smaller dimension; it cannot be increased
False = a window with the AUTO-RESIZE style can resized freely
Character Based Interface
True = clear the area as soon as the user inputs a digit.
False = don't clear the area where the ACCEPT is performed. Keep the value on video and allow to overwrite the single digits.
True = antialiasing is applied to fonts on video.
False = fonts on video are shown as they are.
True = DISPLAY statements longer than one line will wrap around on a character-based display.
False = DISPLAY statements longer than one line will be truncated on a character-based display.
True = The field is filled with spaces from the cursor position until the end. If the AUTO clause was used or the program is compiled with the -va option, this causes the cursor to be automatically moved to the next input field or the termination of the accept if no more fields are available.
False = The field is filled with spaces from the cursor position until the end, but the cursor position is unchanged.
See Keyboard Configuration in order to know how to assign the cl2end function to a key.
0 = invisible
1 = underscore shape
2 = block shape
3 = underscore shape, becomes block while in insert mode
4 = vertical bar
This property allows to filter characters accepted in a character-based screen. The value format is minVal[,maxVal], where minVal and maxVal are integer numbers representing the ASCII value of the character. If a character is not inside the range specified by the property, it is replaced with a space.
True = on character-based screens, the SIZE clause (either implicit or explicit) in the ACCEPT specifies the number of positions on the screen, not the number of characters. For example, an ACCEPT with SIZE 10 can accept 10 latin characters or 5 chinese characters.
False = on character-based screens, the SIZE clause specifies the number of characters.
True = the user can select an area in the window by dragging the mouse. On character-based screens the highlighted text is copied to the clipboard.
False = dragging the mouse in the window doesn’t produce a selection.
True = numeric edited fields are not cleared when the first valid character is imputed and the editing characters are automatically skipped, except for the B editing character. Only the fields whose edited picture contains characters different from '9', 'Z', '+', and '-' are affected.
False = numeric edited fields are cleared when the first valid character is imputed. The editing characters are removed as well during the cleaning.
True = lines and boxes whose color is black as rendered with a 3D effect.
False = lines and boxes are rendered normally.
True = don't clear the area where the ACCEPT is performed.
False = clear the area where the ACCEPT is performed.
True = clear the area as soon as the user inputs a digit.
False = don't clear the area where the ACCEPT is performed. Keep the numeric value on video and allow to overwrite the single digits.
True = read content from screen during ACCEPT.
False = don’t read content from screen during ACCEPT.
Debugger Configuration
Debugger properties cannot be set by SET ENVIRONMENT within the program. They must appear in the external configuration.
By default settings are saved in a file named isdebugger.properties under the user home directory.
True = The stdin, stdout and stderr streams are redirected to the Debugger Output Window.
False = The stdin, stdout and stderr streams are not redirected.
The property affects only the remote debugging of a stand-alone program launched with a command like java -Discobol.rundebug=2 -Discobol.redirect_streams=0 PROGRAM_NAME.
True = The Debugger will download source files from the server if it cannot find them locally.
False =The Debugger will not download source files from the server if it cannot find them locally.
True = The runtime on the server will send source files to the client, if a Remote Debugger asks for them.
False = The runtime on the server will not send source files to the client.
File Handling Configuration
(*) The asterisk after the property name means that the property is static, it’s inquired only once by the Framework and then changing it using the SET ENVIRONMENT statement has no effect.
True = c-tree works in stand-alone mode. This mode supports one client process only, so it is suggested that it is used only in an Application Server environment or single-user installations.
False = c-tree works in client/server mode.
True = The Runtime Framework searches for the c-tree configuration between Framework Properties. See Configuring the client through Framework properties for the list of available properties.
False = The Runtime Framework searches for the c-tree configuration in CTREE_CONF.
True = "EXTFH input" does not use the "isCOBOL FileManager chooser" but rather uses the "Default isCOBOL File manager"
False = "EXTFH input" uses the "isCOBOL FileManager chooser"
True = The file_prefix is also used for files whose name begins with "/" or "\".
False = The file_prefix is used only for files with a relative path name.
U / u = Data file names are converted to upper case. Conversion occurs before applying file prefix and file suffix.
L / l = Data file names are converted to lower case. Conversion occurs before applying file prefix and file suffix.
True = All open files are automatically closed when the program exits.
False = Open files are not closed when the program exits.
True = The Runtime Framework searches for the name of the file among the environment variables. If found, its value is used in place of the file name:
False = The Runtime Framework searches for the name of the file among the environment variables only if it is preceded by "-E":
For example, if you set: iscobol.file.env_naming_prefix=dd_
True = All files opened in EXTEND mode are treated as if they were declared OPTIONAL. If the file does not exist, it is created.
False = Standard rules are applied. Opening non-existing files when in EXTEND mode causes an error.
True = Does not return errors when opening an indexed file that contains more keys than are described by the program.
False = Returns a mismatch error when opening an indexed file that contains more keys than are described by the program.
ClassName can be either
This property affects the lock behavior in the same run unit when locks are managed by the InternalLockManager class in a thin client or file server environment. It affects locks between a caller program and a called program as well as locks on multiple records acquired by a single program.
True = More locks on the same record can be acquired in the same run unit.
False = Only one lock on the same record can be acquired in the same run unit.
True = check keys structure on OPEN and return error on mismatch.
False = don’t check keys structure on OPEN.
FileName must match the physical file name declared in the COBOL program with hyphens replaced by underscores and must be lower-case regardless of the case used in the program. Here are some examples:
for “F-CUST” set iscobol.file.index.f_cust=...
for “f_cust” set iscobol.file.index.f_cust=...
for “F_cust.dat” set iscobol.file.index.f_cust.dat=...
Note: The names of the properties that are dynamically set inside the program using SET ENVIRONMENT are normalized by the runtime and therefore the above rules can be ignored.
ClassName can be either
True = The record data is returned to the program even if the record is locked.
False = The record data is not returned to the program if a lock condition occurs.
True = Wait for the record to become unlocked if a lock condition occurs.
False = Return the lock condition to the program.
True = A READ WITH NO LOCK returns a lock condition if the record is locked.
False = A READ WITH NO LOCK reads the record even if it’s locked.
True = The file extension is removed from the file name before opening the file.
False = The file extension is not removed from the file name before opening the file.
True = READ WITH LOCK, either explicit or implicit, doesn’t lock the record if the file is open in INPUT mode.
False = READ WITH LOCK, either explicit or implicit, locks the record even if the file is open in INPUT mode.
True = All files opened in I-O mode are treated as if they were declared OPTIONAL. If the file does not exist, it is created.
False = Standard rules are applied. Opening non-existing files in I-O mode causes an error.
ClassName can be either
FileName must match the physical file name declared in the COBOL program with hyphens replaced by underscores and must be lower-case regardless of the case used in the program. Here are some examples:
ClassName can be either
True = Use the com.iscobol.io.DynamicLSeqMF_N class as the default for line sequential files.
False = Use the com.iscobol.io.Dynamic=DynamicLSeq8bit as the default for line sequential files.
True = If a relative or sequential file is opened by a process even without using any kind of lock, no other process can lock it in exclusive mode. The Java property sun.nio.ch.disableSystemWideOverlappingFileLockCheck should be set to true as well.
False = If a relative or sequential file is opened by a process without any locking, another process can lock it in exclusive mode.
True = Print files print a page advance record when the file is closed, unless the close contains the NO REWIND phrase.
False = Print files don’t print a page advance record when the file is closed.
ClassName can be either
FileName must match the physical file name declared in the COBOL program with hyphens replaced by underscores and must be lower-case regardless of the case used in the program. Here are some examples:
ClassName can be either
True = spaces are removed from physical file names before looking for the files on disk (e.g. "C:\t m p \ file1" is treated as "C:\tmp\file1").
False = spaces are not removed from physical file names before looking for the files on disk.
Note - spaces are removed only from the name used by the COBOL program, not from file.prefix and current directory.
ClassName can be either
FileName must match the physical file name declared in the COBOL program with hyphens replaced by underscores and must be lower-case regardless of the case used in the program. Here are some examples:
ClassName can be either
com.iscobol.io.FileStatusDefault (for 2002 file status codes)
For example, for RM/COBOL-85 (ANSI 85) codes set iscobol.file.status=com.iscobol.io.FileStatus85
True = Trailing spaces are automatically removed before writing a line sequential file. When reading, the destination item is automatically filled with spaces before the line is read.
False = Trailing spaces are not removed before writing a line sequential file. When reading, the destination item is not cleared before the line is read.
Example: opening a file whose physical name is "arc" having iscobol.file.suffix=dat will open "arc.dat".
2 = Use extended EXTFH2 32 bit
3 = Use extended EXTFH3 64 bit
True = More locks on the same record can be acquired in the same run unit.
False = Only one lock on the same record can be acquired in the same run unit.
A = Acucobol-GT convention
D = Data General convention
I = IBM convention
M = Micro Focus convention
N = NCR COBOL convention
R = Realia COBOL convention
V = VAX COBOL convention
0 = no permission, access denied to other users
1 = public permission with full access to other users
2 = public permission with read-only access to other users
True = The c-tree indexed file is automatically linked into isCOBOL SQL Server during the OPEN OUTPUT.
False = The c-tree indexed file is created as a standard c-tree file during the OPEN OUTPUT.
This property creates a mapping between one or more physical file names and an iss file. filename is the name of the physical file, wildcards are supported (e.g. customers*). The value for this property is the basename (no extension) of the iss file to be used for all file names that match the pattern specified by filename.
This property configures the replacements performed by the runtime on the physical file name before linking it as a table when iscobol.sqlserver.iss is set to true. The value is the combination between one or more of the following values:
0 = . and - become _
1 = . is omitted and - becomes _
2 = - is omitted and . becomes _
4 = the file extension (from the last . to the end of the name) is omitted
For example, in order to omit . and _ set iscobol.sqlserver.iss.replacement_rules=3
Database Bridge and JDBC/ESQL Configuration
(*) The asterisk after the property name means that the property is static, it’s inquired only once by the Framework and then changing it using the SET ENVIRONMENT statement has no effect.
Common JDBC/ESQL Configuration
True = warnings are returned through SQLCA if the ESQL statement produces them.
False = warnings are never returned through SQLCA.
True = SQLCODE values different from 0 and 100 are returned as negative values.
False = SQLCODE values are always positive.
True = The JDBC driver is forced to automatically commit every SQL Statement performed by the ESQL module.
False = SQL Statements are not automatically committed. It’s program duty to COMMIT or ROLLBACK the issued statements.
This property specifies the timeout in seconds before returning a connection refused error to the CONNECT statement. If this property is not set, the connection timeout depends on database settings.
1 = FORWARD_ONLY allows the cursor to move forward, but not backward, through the data.
2 = SCROLL_INSENSITIVE allows the cursor to move forward and backward through the data. Changes made while the cursor is open are ignored. It provides a static view of the underlying data to which the cursor refers.
3 = SCROLL_SENSITIVE allows the cursor to move forward and backwards through the data. Changes made while the cursor is open are immediately available. It provides a dynamic view of the underlying data to which the cursor refers.
iscobol.jdbc.driver.ConnectionName
-1 = Trailing spaces are maintained.
0 = Trailing spaces are removed.
1 = Trailing spaces are removed and the first character of the string is always maintained, regardless of whether it is a space or not.
Note - this property affects only the comparison between SQL values and host variables. The comparison between SQL values and constant strings (including The EDBI-WHERE-CONSTRAINT external variable) is not affected.
commit = Executes a COMMIT statement, then a DISCONNECT statement.
rollback = Executes a ROLLBACK statement, then a DISCONNECT statement. Note that the ROLLBACK will have effect only if you’re not working in autocommit mode, e.g. iscobol.jdbc.autocommit (boolean) must be set to false.
none = Executes only a DISCONNECT statement. A COMMIT or ROLLBACK is performed depending on the database defaults.
Note - Due to JDBC rules, options are evaluated only if user and password are not specified in the CONNECT statement.
True = Each thread created by PERFORM THREAD or CALL THREAD uses a separate database connection. The thread code is responsible to create the connection. When working with the Database Bridge, EDBI subroutines take care of managing the multiple thread connections.
False = All threads created by PERFORM THREAD or CALL THREAD share the same database connection.
iscobol.jdbc.url.ConnectionName
 
Database Bridge (EasyDB) Runtime Configuration
iscobol.jdbc.autocommit (boolean) must be set to false in the configuration, otherwise all the operations are automatically committed.
Note - routines generated by the EDBIIS command consider this setting only if the -cc option was used.
iscobol.jdbc.autocommit (boolean) must be set to false in the configuration, otherwise all the operations are automatically committed.
Note - routines generated by the EDBIIS command consider this setting only if the -cc option was used.
iscobol.easydb_date_cutoff is supported for backward compatibility.
"/usr/temp/users/invoice", if easydb.dirlevel=0, the EDBI routine will reference a table named "invoice"; if easydb.dirlevel=1, the EDBI routine will reference a table named "usersinvoice"; if easydb.dirlevel=2, the EDBI routine will reference a table named "tempusersinvoice"; and so on...
iscobol.easydb_inv_date is supported for backward compatibility.
iscobol.easydb_julian_base_date is supported for backward compatibility.
If no matches are found in iscobol.easydb.mapping, the Dynamic Filesystem Interface will look for matches in the deprecated iscobol.filename.mapping configuration property. This property is still supported for backward compatibility.
iscobol.easydb_max_date is supported for backward compatibility.
iscobol.easydb_min_date is supported for backward compatibility.
Note - routines generated by the EDBIIS command consider this setting only if the -dmld or -dmlu options were used.
Note - routines generated by the EDBIIS command consider this setting only if the -dpld or -dplu options were used.
0 = . and - become _
1 = . is omitted and - becomes _
2 = - is omitted and . becomes _
4 = the file extension (from the last . to the end of the name) is omitted
For example, in order to omit . and _ set iscobol.easydb.replacement_rules=3
True = When a START is performed on a multi-record FD, only the table related to the current record type is used.
False = When a START is performed on a multi-record FD, all the tables related to the FD are used.
Note - routines generated by the EDBIIS command consider this setting only if the -esst option was used.
True = EDBI routines wait for the lock to be released. The EDBI routine must have been generated with easydb.oracle.wait_for_locks=1.
False = EDBI routines return the lock condition.
Note - routines generated by the EDBIIS command consider this setting only if the -Owfl option was used.
Note - routines generated by the EDBIIS command consider this setting only if the -t option was used.
isCOBOL Server (thin client) Configuration
isCOBOL Server properties listed below cannot be set by SET ENVIRONMENT within the program. They must appear in the configuration passed to the isCOBOL Server at startup.
(*) The asterisk after the property name means that the property is read every time a Client connects. Other properties instead are read only at server startup.
True = Start the Class Server along with isCOBOL Server.
False = Don’t start the Class Server along with isCOBOL Server.
This property is evaluated only if iscobol.as.fileserver is set to true, otherwise the Class Server is always started.
0 = No password required.
1 = A password is required only for admin functions.
2 = A password is always required.
This property specifies the name of a swupdater.properties file that the server should send to the client during the automatic update process. This is useful to instruct the client to download additional items (e.g. custom items like programs that will be called via CALL CLIENT) in addition to the isCOBOL libraries.
LEGACY = Use the same hash method used by isCOBOL 2012 R2 and previous releases
MD5 = Use MD5
SHA-1 = Use SHA-1
The file password.properties generated with a specific algorithm is not compatible with an isCOBOL Server that uses a different algorithm.
True = Start File Server services along with isCOBOL Server .
False = Don’t start File Server services along with isCOBOL Server .
True = Start the HTTP Server feature.
False = Don’t start the HTTP Server feature.
1 = Program starting
0 = Program exiting
True = Application Server activities are traced and logged.
False = Tracing is disabled.
0 = Create a new thread for every client.
1 = Create a separate process for every client.
2 = Create a new thread for clients launched without -d option and create a separate process for clients launched with -d option.
True = The name of the program specified in the Client command line is searched among aliases defined in the server configuration file.
False = The name of the program specified in the Client command line is actually the program to start.
See TSL/SSL support for details.
See TSL/SSL support for details.
The following properties are considered by both isCOBOL Server and Client
In the Client configuration it is possible to specify multiple values separated by comma. It’s good practice to have the same number of values in iscobol.port. The client will attempt to connect to the fist available hostname and port pair. Hostnames and ports are paired from the first in the list to the last, such as hostname1:port1, hostname2:port2 and so on.
In the Client configuration it is possible to specify multiple values separated by comma. It’s good practice to have the same number of values in iscobol.hostname. The client will attempt to connect to the fist available hostname and port pair. Hostnames and ports are paired from the first in the list to the last, such as hostname1:port1, hostname2:port2 and so on.
The following properties are to be used client side only:
See TSL/SSL support for details.
See TSL/SSL support for details.
Load Balancer Configuration
Load Balancer properties can be set exclusively in the configuration file passed as parameter on the iscblancer command-line.
True = Load Balancer activities are traced and logged.
False = Tracing is disabled.
Print Configuration
True = Print jobs are stored in memory. As a result, the process is faster but more memory is occupied.
False = Print jobs are stored on the hard disk.
True = The Choose Printer dialog is shown each time the program opens a print file on a pipe. If the user doesn’t choose a printer, then the OPEN fails.
False = The Choose Printer dialog is never automatically shown by the runtime.
The following properties specify the default attributes for PDF prints. They affect PDF created by writing on a file assigned to "-P PDF" or by using the Save As function in the print preview dialog.
Note that these values are read on the side where the printing takes place, e.g. on the client side if the PDF is written by the client, on the server side otherwise.
The print attributes can be changed at runtime by calling the WINPRINT-SET-ATTRIBUTE function.
78 pdfcrypt-no value 0.
78 pdfcrypt-std-40 value 1.
78 pdfcrypt-std-128 value 2.
78 pdfcrypt-aes-128 value 3.
78 pdfcrypt-no-metadata value x#08.
78 pdfcrypt-embedded-files-only value x#10.
78 pdfcrypt-allow-printing value x#0100.
78 pdfcrypt-allow-modify-content value x#0200.
78 pdfcrypt-allow-copy value x#0400.
78 pdfcrypt-allow-modify-annotations value x#0800.
78 pdfcrypt-allow-fill-in value x#1000.
78 pdfcrypt-allow-screenreaders value x#2000.
78 pdfcrypt-allow-assembly value x#4000.
78 pdfcrypt-allow-degraded-printing value x#8000.
78 pdfcrypt-all-permissions value x#FF00.
IDE Reports and Export to Excel feature Configuration
Export to Excel feature
True = Ignores the background color of the cell.
False = Replicates the background color of the cell.
True = Ignores the border style of the cell.
False = Replicates the border style of the cell.
True = Protects spreadsheet cells from editing.
False = Spreadsheet cells can be edited.
True = Long text wraps in the cell.
False = Long text is truncated.
True = Collapse row span and avoid merging cells across rows. It implies iscobol.export.excel.remove_rows_space=true.
False = Don’t collapse row span and allow merging cells across rows.
True = Preserve the type of the original Report field expressions and use it for the cell data type.
False = Don’t preserve the type of the original Report field expressions and don’t use it for the cell data type.
True = Create page breaks in the Excel sheet.
False = Don’t create page breaks in the Excel sheet.
True = The Report page header is shown only on the top of the spreadsheet and is freezed during scrolling. When the content of the header changes, a new sheet is created.
False = The Report page header is shown for each Report page exported in the spreadsheet.
True = Ignore graphics and export only the text.
False = Export both text and graphics.
0 = Empty spaces that could appear between columns should not be removed.
1 = Empty spaces that could appear between columns should be removed.
2 = Empty spaces that could appear between columns should be removed. In the resulting output, useless columns are then removed as well.
True = Empty spaces that could appear between rows should be removed.
False = Empty spaces that could appear between rows should not be removed.
True = Force cell white background.
False = Don’t force cell white background.
Report print
If not set, then iscobol.font.default * is used also during Report print and preview.
If not set, then iscobol.font.fixed * is used also during Report print and preview.
If not set, then iscobol.font.large * is used also during Report print and preview.
If not set, then iscobol.font.medium * is used also during Report print and preview.
If not set, then iscobol.font.small * is used also during Report print and preview.
If not set, then iscobol.font.traditional * is used also during Report print and preview.
Update Facility Configuration
Server Configuration (swupdater.properties)
swupdater.zipfile.<packageName> is supported for backward compatibility.
os is optional and it can be any of the following values: win, linux, mac, solaris.
swupdater.zipfile.<os>.<packageName> is supported for backward compatibility.
os is optional and it can be any of the following values: win, linux, mac, solaris.
arch is optional and can be either 32 or 64.
swupdater.zipfile.<os>.<arch>.<packageName> is supported for backward compatibility.
Client Configuration (isupdater.properties)
True = Trace the isUpdater activity into the log file pointed by swupdater.logfile.
False = Don’t trace the isUpdater activity.
Library Routines and Utilities Configuration
C$COPY
True = In thin client, for client-side files, use the user TEMP folder as base directory for relative file paths.
False = In thin client, for client-side files, use the client working directory as base directory for relative file paths.
C$EASYOPEN
JDIC = use the JDIC component
JAVA = use the Desktop class available from Java 1.6
WINAPI = call the ShellExecuteA Windows function.
C$MYFILE
True = only the class name (without path) is returned by C$MYFILE.
False = a full file name (path and file name) is returned by C$MYFILE.
C$SOCKET
True =The attribute SO_KEEPALIVE is turned on for sockets managed by the C$SOCKET routine.
False = The attribute SO_KEEPALIVE is turned off for sockets managed by the C$SOCKET routine.
True =The attribute SO_REUSEADDR is turned on for sockets managed by C$SOCKET routine.
False = The attribute SO_REUSEADDR is turned off for sockets managed by C$SOCKET routine.
True =socket packets are sent immediately.
False = socket packets are delayed using the Nagle algorithm.
COBFILEIO
number_too_large=Number Too Large. Field
max_number=Max Number
current_number=Current Number
string_too_long=String Too Long. Field
max_length=Max Length
current_length=Current Length
wrong_scale=Wrong Scale. Field
max_scale=Max Scale
current_scale=Current Scale
GIFE
True = GIFE opens the file for i/o as default
False = GIFE opens the file for input as default
n can be any positive number.
conv can be any of the following:
KEISEN
ISL
True = The "-d" check-box will be checked in the ISL GUI.
False =The "-d" check-box will not be checked in the ISL GUI.
True = The "-nodisconnecterr" check-box will be checked in the ISL GUI.
False =The "-nodisconnecterr" check-box will not be checked in the ISL GUI.
ISMIGRATE
True = Continue the data migration even if write errors occur.
False = Stop if a write error occurs.
Note: If you set this property to "vision", then ISMIGRATE requires the runcbl dynamic library to read Vision files. Set it to "com.iscobol.io.ScanVision" to have ISMIGRATE read Vision files natively.
True = The ISMIGRATE activity is traced into a log file
False = The ISMIGRATE activity isn’t traced
True = The output file is created with the encrypted flag. Note that some file handlers ignore such flag.
False = The encryption flag is not used to create the output file.
True = Don’t pass the collating sequence to the output file handler. This is useful when migrating to file systems like Dci, which do not support collating sequences.
False = Pass the collating sequence to the output file handler.
True = Consider the first parameter (InputFile) as the name of the source file, and the second parameter (OutputDir) as the name of the destination file. Useful to migrate one file at a time.
False = Consider the first parameter (InputFile) as a list of files, and the second parameter (OutputDir) as the name of the destination folder. Useful to migrate multiple files at a time.
True =Don’t perform the build of the output file. This is useful when optimizing the migration of file systems like EasyDB, which create a table when opening a file.
False = Build the output file.
True =Ignore the second parameter. This is useful when migrating to databases.
False = Consider the second parameter.
True = Remove the extension from the input file name and use the resulting name as output file name.
False = Use the input file name as output file name without changes.
SYSTEM
XMLSTREAM
This property specifies the number of columns for the indentation of items in XML files generated by the XMLStream Class (com.iscobol.rts.XMLStream). When this property is set to a value of 0 or grater, each XML element is generated on a separate line, that means your XML stream will include CRLF.
True = empty elements are not generated by the XMLStream Class (com.iscobol.rts.XMLStream)
False = empty elements are generated by the XMLStream Class (com.iscobol.rts.XMLStream)
Only PIC X ANY LENGTH items are affected; fixed length items are never empty because spaces are valid data.
True = resolve href/id references in the read XML stream
False = don’t resolve href/id references in the read XML stream
True = remove trailing spaces from XML values
False = keep trailing spaces in XML values
JSONSTREAM
This property specifies the number of columns for the indentation of items in JSON files generated by the JSONStream Class (com.iscobol.rts.JSONStream). When this property is set to a value of 0 or grater, each element is generated on a separate line, that means your stream will include CRLF.
True = empty elements are not generated by the JSONStream Class (com.iscobol.rts.JSONStream)
False = empty elements are generated by the JSONStream Class (com.iscobol.rts.JSONStream)
Only PIC X ANY LENGTH items are affected; fixed length items are never empty because spaces are valid data.
True = remove trailing spaces from JSON items value
False = keep trailing spaces in JSON items value
Keyboard Configuration
(*) The asterisk after the property name means that the property is static, it’s inquired only once by the Framework and then changing it using the SET ENVIRONMENT statement has no effect.
True = The keystroke ALT+F4 is not intercepted by the isCOBOL Framework and affect the COBOL window directly.
False = The keystroke ALT+F4 is intercepted by the isCOBOL Framework and don’t affect the COBOL window, but it can be handled by the COBOL program.
True = The keystroke CTRL+F1 is not intercepted by the isCOBOL Framework and affect the COBOL window directly.
False = The keystroke CTRL+F1 is intercepted by the isCOBOL Framework and don’t affect the COBOL window, but it can be handled by the COBOL program.
True = The key F10 is not intercepted by the isCOBOL Framework and affect the COBOL window directly.
False = The key F10 is intercepted by the isCOBOL Framework and don’t affect the COBOL window, but it can be handled by the COBOL program.
True = Keystrokes that produce a specific effect on the window (e.g. ALT+F4 closes the window and F10 shows the system menu) are not intercepted by the isCOBOL Framework and affect the COBOL window directly.
False = Keystrokes that produce a specific effect on the window are intercepted by the isCOBOL Framework and don’t affect the COBOL window, but they can be handled by the COBOL program.
Upper = All characters are converted uppercase
Lower = All characters are converted to lowercase
Both = All characters are entered as typed by user
True = edit=first and edit=last allow to move the cursor to the first or last field of the screen respectively.
False = edit=first and edit=last have no effect.
True = edit=up has the same effect of edit=previous and edit=down has the same effect of edit=next in key settings. Every RADIO-BUTTON behaves as No-Group-Tab.
False = key settings preserve their behavior.
Function and special keys can be configured using the corresponding property.
The characters "^", "*" and "@" represent the [Shift], [Ctrl] and [Alt] key, respectively. Put one or more of them after the key name to define key combinations.
For example, [F1] is iscobol.key.f1, [Shift+F1] is iscobol.key.^f1, [Ctrl+F1] is iscobol.key.*f1 and [Alt+F1] is iscobol.key.@f1. Any combination of "^", "*" and "@" is valid, [Shift+Ctrl+Alt+F1] is iscobol.key.^*@f1.
Pressing the "Ctrl" key in conjunction with a key letter (A-Z) causes an exception whose number varies from 1 (ctrl+A) to 26 (ctrl+Z). The behavior of these ctrl+letter combinations can be redefined using the properties iscobol.key.*a through iscobol.key.*z. Pressing the "Ctrl" key in conjunction with a key digit (0-9) does not produce any exception by default, you can change this behavior by setting the properties iscobol.key.*0 through iscobol.key.*9.
iscobol.key.KeyName can be set to one or more of the following values:
data=Value
Value represents the character sent to the program.
Value is a numeric value from 1 to 65536 representing the exception value generated for the program.
Value is a numeric value from 1 to 65536 representing the termination value generated for the program.
hotkey=Value
Value is the program to be called.
edit=Value
Value represents how the cursor is moved within controls belonging to the same Screen Section. Possible values are:
next = the cursor goes to the next control
previous = the cursor goes to the previous control
first = the cursor goes to the first control [A]
last = the cursor goes to the last control [A]
up = the cursor goes to the previous control
down = the cursor goes to the next control
pageup = the cursor moves as if Page-Up was pressed
pagedown = the cursor moves as if Page-Down was pressed
backspace = the cursor moves back by one digit deleting the character
delete = the digit next to the cursor is deleted
insert = the insert mode is changed
clear = the field content is erased and the cursor is placed at the beginning of the field.
cl2end = the content from the current cursor position to the end of the field is erased
[A] Supported only if iscobol.keystroke.firstlast_on_screen (boolean)* is set to true.
Note - Function and special keys cannot be configured to send characters to the program, the data= setting has no effect for them.
Note - On graphical screens, if the active graphical control intercepts some keys for its own functionality, these keys are not returned to the COBOL program and therefore they don’t raise any exception. This is the reason why for example F5 and ESC are not intercepted by the COBOL program while the focus is on a web-browser.
Default Keyboard Configuration
[A]With the default configuration key.up and key.down behaves as follows: if there are fields below the current cursor location, the cursor moves to the one on the closest lower line. If there is more than one field on that line, the cursor moves to the one closest to its current horizontal location. The cursor will try to stay in the same column. If there are no fields below the current line, then no action is taken unless an EXCEPTION or TERMINATION value has been assigned, in this case key.up and key.down act as termination keys.
[B] The F10 key doesn’t raise any exception by default. If you want it to interrupt the ACCEPT with a value of 10 in the crt status in order to be consistent with the other function keys, set iscobol.key.f10=exception=10. If iscobol.key.system (boolean) is set to true, then F10 never produces an exception.
 
Acucobol-GT KEYSTROKE configuration property is supported for compatibility.
The following key codes are supported:
 
 

Copyright (c) 2017 Veryant
Contact us
Please share your comments on this manual or on any
Veryant product documentation with the email button at the top left