Empress Software 4GL Administrator's Guide
Empress v8.62
May 2006

(Unix only)

© 1983, 2006 Empress Software Inc.

All rights reserved. Reproduction of this document in whole or part, by electronic or any other means, is prohibited without written consent from Empress Software Inc.

RESTRICTED RIGHTS LEGEND

Use, duplication, or disclosure by the Government is subject to restrictions as set forth in
subparagraph (c) (1) (ii) of the Rights in Technical Data and Computer Software clause at 52.227-7013.

05/06

This manual describes the areas of 4GL that can be customized. It also explains the internals of Empress 4GL.

Table of Contents

CHAPTER 1: System Tables

1.1 Introduction
1.2 sys_4gl_application
1.3 sys_4gl_compile
1.4 sys_4gl_domain
1.5 sys_4gl_field
1.6 sys_4gl_form
1.7 sys_4gl_key
1.8 sys_4gl_link
1.9 sys_4gl_script
1.10 sys_4gl_window
1.11 sys_ag_definition

CHAPTER 2: System Variables

2.1 Introduction
2.2 Description of System Variables

CHAPTER 3: Utilities

3.1 Initializing a 4GL Database
3.2 The Terminal Definition
3.3 Using 4GL with X Windows (UNIX only)
3.4 Printing an Application
3.5 Resetting Locks on Applications
3.6 Building an Executable 4GL Application

CHAPTER 4: Terminal Definition

4.1 Introduction
4.2 The termdb Database

4.2.1 The "sys_terminal" menu
4.2.2 Terminal Configuration Tables

4.3 Compiling a Terminal Definition
4.4 The "terminal" Table

4.4.1 The "name" Attribute
4.4.2 The "rows" and "columns" Attributes
4.4.3 The "videotype" Attribute
4.4.4 The "wraparound" Attribute
4.4.5 The "key_set_1" and "key_set_2" Attributes
4.4.6 The "output_set_1" and "output_set_2" Attributes
4.4.7 The "video_set_1" and "video_set_2" Attributes
4.4.8 The "comment" Attribute

4.5 The "term_key" Table

4.5.1 The "key_set" Attribute
4.5.2 The "key_name" Attribute
4.5.3 The "key_seq" Attribute

4.6 The "term_output" Table

4.6.1 The "output_set" Attribute
4.6.2 The "output_name" Attribute

4.6.2.1 The "init" Function
4.6.2.2 The "done" Function
4.6.2.3 The "window" Function
4.6.2.4 The "region" Function
4.6.2.5 The "index" Function
4.6.2.6 The "rev index" Function
4.6.2.7 The "clr eow" Function
4.6.2.8 The "clr eol" Function
4.6.2.9 The "del line" Function
4.6.2.10 The "del char" Function
4.6.2.11 The "ins line" Function
4.6.2.12 The "ins char" Function
4.6.2.13 The "ins on" Function
4.6.2.14 The "ins off" Function
4.6.2.15 The "graph on" Function
4.6.2.16 The "graph off" Function
4.6.2.17 The "graph set" Function
4.6.2.18 The "cursor" Function
4.6.2.19 The "left" Function
4.6.2.20 The "right" Function
4.6.2.21 The "up" Function
4.6.2.22 The "down" Function
4.6.2.23 The "bell" Function

4.6.3 The "output_seq" Attribute

4.6.3.1 The Character String Class
4.6.3.2 The Number Class
4.6.3.3 The Synonym Class
4.6.3.4 The Parameter Class
4.6.3.5 The Operator Class
4.6.3.6 The Special Operator Class
4.6.3.7 Termcap Cursor cm/sr Notation

4.7 The "term_video" Table

4.7.1 The "video_set" Attribute
4.7.2 The "video_name" Attribute
4.7.3 The "video_seq" Attribute
4.7.4 The "colormap"

4.8 The "term_ap_key" Table

4.8.1 The "term_key_set" Attribute
4.8.2 The "key_label" Attribute
4.8.3 The "key_name" Attribute

4.9 The "term_ap_video" Table

4.9.1 The "term_video_set" Attribute
4.9.2 The "video_label" Attribute
4.9.3 The "low_video_name" and "hi_video_name" Attributes
4.9.4 The "low_fill" and "hi_fill" Attributes

4.10 The "term_form_edit" Table
4.10.1 The "term_video_set" and "term_key_set" Attributes
4.10.2 The "object" Attribute
4.10.3 The "video_label" Attribute
4.10.4 The "key_name" Attribute

4.11 Complete Example for DEC VT100
4.12 Complete Example for 386/ix running X Windows
4.13 Print Terminal Definition

CHAPTER 5: Running Empress 4GL in X Windows (UNIX only)

5.1 Background
5.2 Running Empress 4GL under xterm

5.2.1 Create an X resource file for VT100 key emulation

5.3 Running Empress 4GL Under a Shelltool
5.4 Modifying the 4GL Cursors in X Windows (UNIX only)

5.4.1 Text Cursor
5.4.2 Pointer Cursor

CHAPTER 6: User Defined Functions

6.1 Introduction
6.2 Function Precedence
6.3 Relevant Elements of File "aptabs.c"
6.4 Function Accessibility
6.5 Function Incorporation

CHAPTER 7: Manual Pages