skip to main content
OpenEdge Development: AppBuilder
Multiple Layouts : Running character applications
Running character applications
Use the AppBuilder’s Character Run Window to run character applications.
To run character-mode procedures and view them in actual character-mode format:
1. Start the broker process for all necessary application databases. For example:
2. Start the OpenEdge session and connect to the application database in multi‑user mode.
3. When you are ready to run your character procedure, choose LayoutAlternate Layout from the AppBuilder main window.
4. On the Alternate Layout box, select Standard Character from the Layout combo box.
5. Choose CompileRun from the main window.
AppBuilder disables itself and opens the AppBuilder Character Run Window, which starts a AVM character client session. The Character client first connects to all the databases to which the AppBuilder is connected, then runs your character application.
6. To return to design mode in AppBuilder, exit the layout in the manner you designed for that layout; for example, by pressing the ESC key in the Character Run Window.
The AppBuilder Character Run Window clears the running layout and displays a status message of “Procedure complete. Waiting for next run.” The AppBuilder enables itself so that you can make further changes to the character layout. Note that the character client session is still running and remains connected to the application databases, so that you can run the procedure again to test your changes.
7. To close the Character Run Window, choose CompileClose Character Run Window in the AppBuilder Main window.
The character client session exits and the Character Run Window closes.
Note: If the Character Run Window does not close, you might have to delete the file that the AppBuilder uses to communicate with the Character Run Window. This file has the form pnnnnnm.tty and is located in the OpenEdge temporary file directory (by default, your current directory). When you delete this file, the character session ends and the Character Run window closes.
Character client connection issues
If the application databases with which you are testing a character layout require connection parameters in addition to the database names, specify the database names and additional connection parameters in the default OpenEdge file.
If you want to specify different connection parameters for the AppBuilder client and the Character Run client, create a parameter file for the character client, then set the AVM WinChar PROSTARTUP registry setting to the new parameter file. For example, if the AppBuilder client session has different code page settings than the character client, you can specify appropriate code page startup parameters in the character parameter file.
If you connect to additional databases during the AppBuilder session, you must specify only the database name and multi‑user mode. The Character Run Window client will not recognize any additional connection options you specify, and running the character layout might fail to connect to the database.
Double-byte characters
The Character Run window does not support the display of double‑byte characters. For more information about double‑byte characters, see OpenEdge Development: Internationalizing Applications.