General Variables


APPXPATH

Denotes the default location of the APPX system administration files, applications and database files. You can override the location of the system administration files using the APPX_0SA_PATH variable. Additionally, you can override the location of any files by using FMS groups.

Valid values: path of the APPX data files directory on your system

Default value: {appx engine location}/data in Unix, {appx engine location}\data in Windows

 

APPX_0SA_PATH

Directs a PC network node to look at a server’s disk drive for its APPX system administration files. One situation in which you may want to do this is when running several copies of APPX on networked PC’s while sharing a single set of system administration settings like Users, Printers, Forms, etc.

To tell a PC network node to store its application design files on a server’s disk drive but keep EMs on the local PC drive (for performance), define an FMS group as follows:

     FMS Path: R:\APPX\data

     FMS Controls: EM=C:\APPX\local_data

 

In this arrangement, FMS Path is the path to the APPX applications stored on the server’s disk and the “EM=” value is a path to an existing directory on the local PC into which EMs can be cached. Then, assign the application design files to this FMS group for any application whose EMs you would like cached in this fashion.

Valid values: path to a server’s disk drive in which the 0SA data directory is found, such as “R:\APPX\data”

Default value: APPXPATH directory

 

APPX_ALLOW_MISALIGNS

Converts ERROR messages to WARNING messages when the Data Dictionary is processed. In APPX releases prior to 4.1, numeric fields specified as BINARY in the field’s Additional Attributes must reside on a byte boundary that is an even multiple of four. APPX generates an ERROR condition when processing the Data Dictionary if this condition is not met. Setting this variable to a non-blank value generates WARNING messages, which allows the Data Dictionary to be processed normally.

Valid values: 1

Default value: not set

 

APPX_DYNAKEY_PROMPT

Sets a threshold of records processed during Dynamic Key creation. When this threshold is reached, APPX displays a warning message and asks the user if they want to continue building the Dynamic Key, or if they want to cancel the Dynamic Key creation process. The default is 1000 records. To change the default, set this variable to the number of records at which you want the warning to appear. Note that this is an absolute value, not an interval; if you set this to 2000, you will not receive the warning every 2000 records. The warning and cancel opportunity will be displayed just once, after the 2000th record is processed.

Valid values: integers

Default value: 1000

 

APPX_END_PARAGRAPH

This environment variable tells APPX to use hex(0A) as an end-of-paragraph character within text fields instead of hex(B6). Databases such as Oracle expect to find hex(0A) within text fields and so does UniCode which is needed for entering and displaying Chinese, Japanese, and a few other languages.

This will also tell the server to notify the client on handshake to stop switching end of line characters when moving text data between the client and the server.

Export and Import also take notice of this flag and, if set, Export will switch the override character (0x0A in this case) with 0xB6 for text field data going into the portable file and Import will do the opposite conversion bringing the text data back in.

Valid values: 0x0A

Default value: 0xB6

 

APPX_KEYMAP

Sets the name of the default keymap. This is the same as using the “-m=” Command Line Option. See Appendix C of this manual for more information on Command Line Options.

Valid values: any valid keymap name for your APPX installation

Default value: not set

 

APPX_MSG

Centers the value of this variable on the bottom line of the screen. Setting this variable to `hostname` (Unix only) and/or $APPXPATH is useful. (Warning: if you want to use `hostname`, it must be set at the shell level in .profile or a similar place, not in appx.env. Only the shell can interpret `backticks`.)

Valid values: any text string, or `command` (where the output of command is the display text)

Default value: none

 

APPX_SHOW_PROGRESS

Activates a running status message during Query and related Output and Update processes. This message will keep you informed about the progress of the batch process. It shows the number of records processed, the number of records selected, etc. The message is updated every record until it reaches 10, then it is updated every 10 records until it reaches 100, then it is updated every 100 records, etc.

Valid values: 1

Default value: not set

 

APPX_STD_PGH_MASK

Sets the date mask for dates displayed in page headings. Setting APPX_STD_PGH_MASK to “06/05/0807 - 04:03 02.01” causes your page heading dates to look like “03/25/1999 - 00:18 13.82”.

Valid values: valid APPX date mask

Default value: system or application date mask, if set

 

APPX_ZERO_MALLOC

Fixes a bug in APPX version 2.x (sort of). This variable should no longer be set for sites running APPX 3.0 or later; the bug was fixed in version 3.0. Since there is a slight performance impact to the workaround, if you do not need this variable (i.e., you are not running a pre-3.0 version of APPX), don't set it. This is included only for completeness.

Valid values: 1 (set only if running a pre-3.0 version of APPX)

Default value: not set