Progress
Client Deployment
Guide
Maintaining the progress.ini File
The
progress.ini
file specifies environment variable settings for the Windows environment. It contains sections and settings for the following types of options:Figure 5–2 shows excerpts from a sample
progress.ini
file.Figure 5–2: Sample Progress Initialization File in Windows
![]()
When installed, the
progress.ini
file contains the following sections:The
progress.ini
file can also contain the following optional sections:You can edit the
progress.ini
file to customize environments at different sites. Theprogress.ini
file is located in the$DLC/probuild/eucapp
directory, by default.The following sections describe each of these
progress.ini
file sections.Startup Section
The Startup section of the
progress.ini
file contains options that specify the following environment characteristics for graphical user interface clients:The Startup section also contains Progress environment variables that you can set for use with graphical user interface clients. See Table 5–5 in the "Specifying Environment Variables" section later in this chapter for a list of environment variables you can set in the Startup section.
The Startup section contains the following options:
AlignFrameTitles
Lets you specify the alignment of frame titles in a graphical user interface. Valid settings include the following: 0 (left justified), 1 (centered), and 2 (right justified). The default is centered.
AS/400_AppcDllName
Lets you specify a dynamic link library for AS/400 communications.
For Version 7.3B and later, you can specify the name of the DLL that you want to use for AS/400 communications. Table 5–1 lists the available DLLs depending on the AS/400 communication protocol and the type of network support you use.
Table 5–1: DLL Files for AS/400 Communications AS/400 Communication Protocol
Type of
Network Support
DLL Filename SNA Rumba for APPC SNA Client Access/Netsoft SNA Microsoft SNA Server
CarefulPaint
Lets you set the accuracy with which Progress repaints overlapping 3D widgets and frames. Set to YES for Progress to repaint overlapping 3D widgets and frames slowly and carefully. Set to NO for Progress to repaint overlapping 3D widgets and frames quickly (which might reduce the quality of the graphic). The default value is YES.
This option applies only when UseNative3D=NO.
ClientTimeOut
Lets you specify the number of minutes a client session can remain inactive before the server disconnects the session.
The server process determines whether a client has been inactive for a specified period of time, and if so, the server disconnects the client and backs out any related active transactions.
DefaultFixedFont
Lets you specify the default fixed display font.
typeface
A valid typeface name, such as Times or Courier.
point-size
The size of the font, in points. If you omit the point size, Progress uses the default point size as defined by the typeface.
keyword
You can specify the following keywords: bold, italic, underline, or strikeout.
scriptname
By default, Progress uses the script (character set) of the Windows FixedSys font for all fonts specified in the environment. If you select a different script when editing a font using the font common dialog, Progress writes the specified script name to the font entry.
DefaultFont
Lets you specify the default display font.
typeface
A valid typeface name, such as Times or Courier.
point-size
The size of the font, in points. If you omit the point size, Progress uses the default point size as defined by the typeface.
keyword
You can specify the following keywords: bold, italic, underline, or strikeout.
scriptname
By default, Progress uses the script (character set) of the Windows FixedSys font for all fonts specified in the environment. If you select a different script when editing a font using the font common dialog, Progress writes the specified script name to the font entry.
DefaultV6UpdateFont
Lets you specify the Version 6 update font.
typeface
A valid typeface name, such as Times or Courier.
point-size
The size of the font, in points. If you omit the point size, Progress uses the default point size as defined by the typeface.
keyword
You can specify the following keywords: bold, italic, underline, or strikeout.
scriptname
By default, Progress uses the script (character set) of the Windows FixedSys font for all fonts specified in the environment. If you select a different script when editing a font using the font common dialog, Progress writes the specified script name to the font entry.
When V6Display=YES, the font specified by the DefaultV6UpdateFont setting is used when a fill-in is in update mode. The default value for DefaultV6UpdateFont is a version of the system default fixed font with underlines (
fixedsys
,underline
).The DefaultFixedFont and the DefaultV6UpdateFont should be the same base font. If you change them, make sure that the font is fixed and that the DefaultV6UpdateFont has the underline attribute. Progress does not automatically add the underline attribute to the DefaultV6UpdateFont setting.
EndMsgTitle
EndMsgText
Lets you specify the title and text for the Windows shutdown message box.
When Windows shuts down, a dialog box prompts the user to verify the shutdown. If the user answers YES, Progress closes and the Windows Exit procedure continues. If the user answers NO, the Windows Exit procedure terminates and Windows remains active.
EndMsgTitle can be up to 80 characters long. Its default value is “Progress”. EndMsgText can be up to 80 characters long. Its default value is “Windows is exiting. Is this OK?”.
FrameSpacing
Lets you specify how the Progress layout processor spaces frames.
Setting the value to -1 places the frame at the next character unit boundary. Setting the value to 0 places frames one half of a character unit apart. Setting the value greater than 0 spaces the frames by the specified number of pixels.
ImmediateDisplay
Lets you redisplay the screen at predefined intervals.
If you do not set this option, some Version 6 applications will not draw the screen correctly. Set this option for applications with existing code that you do not want to modify. The default setting is NO.
You can also use the IMMEDIATE-DISPLAY attribute with the SESSION system handle to surround the offending code. This is the preferred technique.
For more information about the IMMEDIATE-DISPLAY attribute and the SESSION system handle, see the Progress Language Reference.
Keep3DfillinBorder
Set to YES to display a disabled fill-in field with a border. Set to NO to display a disabled fill-in field without a border. The default value is NO.
MultitaskingInterval
Lets you specify how the Progress session interacts with a Windows cooperative multi-tasking environment. Its value determines how often Progress filters events or messages between itself and other Windows applications. As Progress filters these events more often, it executes procedures less efficiently but allows other Windows applications more opportunity to execute. Adjusting the internal event filter is particularly useful during background processing, such as report generation.
To maximize performance during batch-mode processing, set the value to 9999 (the maximum value allowed). If you want to run another application while you run Progress in batch mode, set the value to 1000. If you set the value to 0 (the default), the internal loop never executes. Although this results in high performance, interoperability with other Windows applications is poor. The lower the number, the more often the loop executes, resulting in better interoperability. Set this option for applications with existing code that you do not want to modify.
You can also use the MULTITASKING-INTERVAL attribute with the SESSION system handle to control how Progress interacts with Windows cooperative multi-tasking by surrounding long 4GL processing loops with this attribute.
See the Progress Language Reference for more information about the MULTITASKING-INTERVAL attribute and the SESSION system handle.
Opsys
Lets you specify the value used by the OPSYS preprocessor directive or the value returned by the OPSYS function. Valid settings include any character string.
PopupAppOverridesSys
Set to YES to display the system-default pop-up menu only if a user-defined pop-up menu is not available. Set to NO to display the system-default pop-up menu regardless of a user-defined pop-up menu. If a user-defined pop-up menu is available, it is displayed after the system pop-up menu is closed. The default value is YES.
NOTE: The system-default pop-up menu is displayed when you click the right mouse button on a fill-in field or an editor widget and a user-defined pop-up menu is not available.PopupNoSysDefault
Set to YES to suppress the system-default pop-up menu. Only the user-defined pop-up menu is displayed. The default value is NO.
NOTE: The system-default pop-up menu is displayed when you click the right mouse button on a fill-in field or an editor widget and a user-defined pop-up menu is not available.PopupOnMouseDown
Set to YES to display a pop-up menu when the right mouse button is depressed. Set to NO to display a pop-up menu when the right mouse button is released. The default value is NO.
NOTE: This option applies only to pop-up menus that are displayed with the right mouse button (that is, MENU-MOUSE = 3). Menus that are displayed with the left or middle mouse button are always displayed when the buttons are depressed.PrinterFont
Lets you specify the printer fonts Progress uses with the OUTPUT TO PRINTER statement.
PrinterFontn
Lets you specify the printer font Progress uses with the OUTPUT TO LPTn statement.
UseNative3D
Set to YES to use the 3D drawing capabilities in Windows 95/NT 4.0. Set to NO to use the 3D drawing capabilities in Progress. The default value is YES.
Use-3D-Size
Lets you specify how Progress calculates the height of a character unit.
If you set the value to YES, Progress uses the height of a three-dimensional fill-in. If you set the value to NO, Progress uses the height of a non-three-dimensional fill-in. The default setting is YES.
V6Display
Lets you specify Progress Version 6 behavior.
When you compile a procedure in Windows, Progress compiles the borders and fonts associated with user interface widgets into the screen layout by default. As a result, you might encounter compilation problems when you try to run a Version 6 application in Progress Version 7 for Windows. There might not be enough space on the display to accommodate the borders and default fonts that are automatically associated with user interface widgets of the Version 6 application.
To avoid this problem, set V6Display to YES to specify that you are running Version 6 code.
You can also set a session attribute to control the run-time setting of the V6Display state. The attribute is V6DISPLAY and has a Boolean value. Setting this attribute has the same effect as specifying the setting at startup. However, you must hide all existing windows.
When you set the V6Display option or session attribute:
- The character unit height is recalculated to the height of the font specified by the DefaultV6UpdateFont option.
- The character unit width is recalculated to the width of an average character in the font specified by the DefaultV6UpdateFont option.
- The default font is automatically changed to use the font specified by the DefaultFixedFont option.
- All Progress fill-ins are created without a border.
- Progress fill-ins keep any trailing spaces.
- All Progress fill-ins that are enabled for update use the font specified by the DefaultV6UpdateFont option (by default, the default fixed font with underlines). This means that updateable fill-ins are drawn with underlines.
- Frame titles are drawn so that the frame title height measures exactly one character unit.
The V6Display option or attribute does not enable support for PUT SCREEN. In addition, if you set the V6Display option, Version 7 applications that have not been compiled with the V6Display option set to YES will draw screens incorrectly.
NOTE: The V6Display option is intended for use with applications, not with the Progress ADE. The ADE is not supported when V6Display is set to YES.If you plan to use Version 6 user interface code with Version 7 tools (or your own Version 7 interface), Progress Software recommends that you use the V6Frame option instead of V6Display.
V6FontNumber
Lets you specify the font for Version 6 frames.
By default, this option points to the font defined as font3 in the [Fonts] section. Font3 is the ADE character-mode font. If you change the V6FontNumber value, make sure you define the new font number in the [Fonts] section.
NOTE: Do not change the definition of font3 in the [Fonts] section. Progress relies on that font definition for other purposes.V6FrameBGC
Lets you specify the default background color for all frames that use the V6FRAME option. Valid settings include any number that corresponds to a color in the Progress color table.
WindowSystem
Lets you specify the value used by the WINDOW-SYSTEM preprocessor directive. Valid settings include any character string.
Colors Section
The Colors section of the
progress.ini
file contains options that specify the colors that make up the color table for use with graphical user interface clients. There are 16 colors available to an application for use as either foreground or background colors. You can specify up to 256 colors.NOTE: Do not change the first 16 colors. These colors are reserved for the Application Development Environment (ADE) tools. Changing them could cause the Progress ADE tools to malfunction.Each entry in the Colors section performs two semantic functions: it defines a color, and it maps that color to an integer in the range 0 to 255. An application specifies this integer when making a color assignment to a widget.
Specify a color entry using the following syntax:
n
An integer from 0 to 255 that specifies the color table entry.
R
An integer that specifies the amount of red present in the color.
G
An integer that specifies the amount of green present in the color.
B
An integer that specifies the amount of blue present in the color.
colorname
Any of the following color names, mapped to the colors defined in the Windows Control Panel:
Any entries you add to the color table must be sequential. For example, since the installed
progress.ini
file defines color0 to color15, the next color you add must be color16. If you add an entry for color17, Progress ignores it if color16 is undefined.For backward compatibility, color0 to color15, as installed, are the same as the colors supported in Version 6. See the chapter about colors and fonts in the Progress Programming Handbook for a listing of these colors.
For backward compatibility, the
progress.ini
file specifies the following color pairs for Version 6 applications:NORMAL, INPUT, and MESSAGES each take a pair of integer values from 0 to 255. The integers represent color table entries. For example, in the default
progress.ini
file, NORMAL is defined as foreground equal to color table entry 0 (RGB value 0,0,0) and background equal to color table entry 15 (RGB value 255,255,255).The following example shows how to redefine NORMAL as foreground equal to color table entry 3 and background equal to color table entry 12:
Default Window Section
The Default Window section of the
progress.ini
file specifies the following options for a graphical user interface client’s default window:Following is a sample Default Window section:
Fonts Section
The
progress.ini
file as installed contains font table entries for the Progress ADE tools. Progress uses the default system fonts defined in the Startup section, unless you add additional fonts to the existing font table in the Fonts section.NOTE: You can add site-specific fonts to the file. Do not change the first 8 fonts. These fonts are reserved for the Application Development Environment (ADE) tools. Changing them could cause the Progress ADE tools to malfunction.Determine which screen fonts exist in your environment. The fonts you choose should be graphically compatible. One way to choose fonts is to use the font common dialog box.
The font table can contain up to 256 entries. Each entry in the table performs two semantic functions: it names a font that exists in your environment and it maps that font to an integer from 0 to 255. An application specifies this integer when making a font assignment to a widget.
NOTE: You cannot enter extra spaces in the font definition section. Extra spaces will cause the error 4499.Specify a font entry using the following syntax:
n
An integer that specifies the font table entry.
typeface
A valid typeface name, such as Times or Courier.
point-size
The size of the font, in points. If you omit the point size, Progress uses the default point size as defined by the typeface.
keyword
You can specify the following keywords: bold, italic, underline, or strikeout.
scriptname
By default, Progress uses the script (character set) of the Windows FixedSys font for all fonts specified in the environment. If you select a different script when editing a font using the font common dialog, Progress writes the specified script name to the font entry.
WinChar Startup Section
The WinChar Startup section of the
progress.ini
file contains options that specify the following environment characteristics for character clients:The WinChar Startup section also contains Progress environment variables that you can set for use with character clients. See Table 5–5 in the "Specifying Environment Variables" section later in this chapter for a list of environment variables you can set in the WinChar Startup section.
The WinChar Startup section contains the following options:
BrowseRowMarker
Lets you specify a character to represent a browse row marker. Valid settings include any number that corresponds to a character in the CPSTREAM character set.
CursorHeight
Lets you specify the height of a cursor as a percentage. Valid settings include any number between 0 and 100. This option overrides the UseDosCursor setting.
EnableMouse
Set to YES to enable mouse input. Set to NO to disable mouse input. The default value is YES.
MenuMnemonicColor
Lets you specify the color of mnemonic characters in menu items. Valid settings include any number that corresponds to a color in the Progress color table.
SingleLineBorder
Lets you specify the characters used to draw borders and lines (such as frame borders, rectangles, submenu and pop-up menu borders, and horizontal and vertical lines). Valid settings include any eight numbers that correspond to characters in the CPSTREAM character set, separated by commas.
These eight numbers represent the corners and sides of a rectangle and must be specified in the following order: top, bottom, left, right, top-left corner, top-right corner, bottom-right corner, and bottom-left corner.
SysCheckmark
Lets you specify a character to represent a selection marker in widgets (such as a selection list, menu, or browser). Valid settings include any number that corresponds to a character in the CPSTREAM character set.
UseDosCursor
Set to YES to change the cursor from an underscore to a solid block when switching from insert mode to over-strike mode in a fill-in field or editor widget. Set to NO to use an underscore as the cursor in either mode. The default value is NO.
V6Keys
Set to YES to use a set of key bindings that are Version 6 compatible by default. The default value is NO.
V6FKeys
Set to YES to use the bindings for the CTRL, ALT, SHIFT, and F13 to F39 keys that are Version 6 compatible by default. The default value is NO.
WinChar Colors Section
The WinChar Colors section of the
progress.ini
file contains options that specify the colors that make up the color table for use with character clients.Each entry in the WinChar Colors section performs two semantic functions: it defines a color, and it maps that color to an entry in the color table by specifying an integer from 0 to 255. An application specifies this integer when making a color assignment to a widget.
Specify a color entry using the following syntax:
keyword | colorn
You can also specify color0, color1, and color2 using the NORMAL, INPUT, and MESSAGES keywords, respectively. The keyword overrides the colorn specification. That is, if you specify both colorn and its corresponding keyword, Progress displays the colors you specified with the keyword.
fgnd-color
The color to use for the screen foreground.
bgnd-color
The color to use for the screen background.
For information about color definitions for the WinChar Colors section, see the Color Phrase reference entry in the Progress Language Reference.
WinChar Default Window Section
The WinChar Default Window section of the
progress.ini
file specifies the line mode for a character client. You can specify 50 rows if your hardware supports 50-line mode. Specify 25 rows if you want the application to be compatible with Progress Version 6 or if you want to port the application to a character terminal.The following is an example WinChar Default Window section:
WinChar Keys Section
The WinChar Keys section of the
progress.ini
file defines the customized key bindings for use with character clients. Table 5–2 lists the user-definable key bindings in the Windows environment. For a complete listing of the Windows key function and key label mappings for handling user input, see the Progress Programming Handbook.
Specify a key-binding entry using the following syntax:
Use a single entry to specify a key binding; additional entries for the same key function are ignored.
If you specify more than one key label, Progress uses the first when it needs to display a key label given a key function, as in “Enter data or press Escape to end.”
For example, the following entry maps the Help key function to the F2 key label, and the Go key function to the F1 key label:
You can use any combination of CTRL, SHIFT, and ALT keys. However, SHIFT only has an effect when used with ASCII keys. If an entry contains nonexistent key labels, the entry is ignored.
NOTE: Set the V6Keys option in the [WinChar Startup] section to enable Progress to use a set of key bindings that are Version 6 compatible by default.Debug-Init Section
Do not modify information in the Debug-Init section.
Debug-Macros Section
The Debug-Macros section of the
progress.ini
file contains a list of parameters that define initial macros used by the Debugger. You can also define your own macros. For more information, see the Progress Debugger Guide.Debug-Buttons Section
The Debug-Buttons section of the
progress.ini
file contains a list of parameters that define initial buttons used by the Debugger. You can also define your own buttons. For more information, see the Progress Debugger Guide.Keys Section
The Keys section is an optional section you can create in the
progress.ini
file to customize key bindings for the Windows environment.Table 5–3 lists the static key bindings in the Windows environment.
Table 5–4 lists the user-definable key bindings in the Windows environment.
Keymap Section
The Keymap section is an optional section you can create in the
progress.ini
file to define mappings between standard ASCII (7-bit) characters and extended (8-bit) characters. Extended characters are typically non-English alphabetical characters. Progress uses these keymap entries to build a translation table for processing characters in the input and output streams.NOTE: Using the Keymap section is the Version 6 technique for mapping characters. Using conversion tables is a better technique for processing characters. For information about defining conversion tables, see the Progress Internationalization Guide.Use the IN statement, in a keymap entry, to map an ASCII character to an extended character using the following syntax:
language
An identifier that appears with the MAP option.
ascii-char
The 7-bit character, in octal (\nnn) format. You must specify all three digits.
extended-char
The 8-bit character, in octal (\nnn) format. You must specify all three digits.
Use the OUT statement, in a keymap entry, to map an extended character to an ASCII character using the following syntax:
You can use multiple IN and OUT statements in a single keymap entry.
If you use extended character sets, you must specify character mappings for each character set on a per-terminal basis. For example, the following code fragment demonstrates how to map characters to German language characters:
The IN statements in the preceding example map ASCII characters (B, A, a, O, o, U, and u) to German characters (ß, Ä, ä, Ö, ö, Ü, and ü). When Progress sees the character A (\101) on input, it converts the character to Ä (\216). Likewise, when Progress needs to send an Ä to the terminal, it sends [ (\101). The terminal sees A and displays Ä.
Suppose the terminal cannot display an Ä. You can use the OUT statement to specify an appropriate character to display for Ä, such as capital A. For example:
You can also specify keymap entries for the input and output streams using the MAP option with each of the following Progress language elements:
For more information about these language elements, see the Progress Language Reference.
Specifying Environment Variables
Table 5–5 lists the environment variables you can set in either the Startup section or WinChar Startup section of the
progress.ini
file.
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |