ENVVARS

PSIONICS FILE - ENVVARS
=======================
Environment variables
Last modified 1998-11-06
========================

Psion system software always places a dollar sign ($) in the names of the
environment variable it uses. Other applications should use names without a
dollar sign in them.

Psion issues environment variable name prefixes to registered developers;
these prefixes will contain dollar signs, but names based on them should
have no further dollar signs.


The following environment variables are known:

"$WS_FL": initial value of the window server settings (changeable using
the wSystem call). Only applies to window server version 4.
  Offset  0 (word): initial settings

"$WS_FNTS": fonts used by the window server (version 4):
  Offset  0 (word): general system purposes
  Offset  2 (word): notifer and alerts
  Offset  4 (word): status window
  Offset  6 (word): special font holding the diamond symbol
  Offset  8 (word): medium digital clock
  Offset 10 (word): medium date
  Offset 12 (word): notifier/alert buttons
  Offset 14 (word): small status window clock

"$WS_PW": owner information: up to 218 bytes:
  Offset  3 (byte): length of first line
  Offset  4 (byte): offset of start of first line (always 18)
  Offset  7 (byte): length of second line
  Offset  8 (byte): offset of start of second line
  Offset 11 (byte): length of third line
  Offset 12 (byte): offset of start of third line
  Offset 15 (byte): length of fourth line
  Offset 16 (byte): offset of start of fourth line
  Offset 18 onward: text of the information
@The remaining bytes appear to be zero, except 2,6,10,14, which are $6. Why ?

"C$P#": parameters used by Link. [Workabout only]

"C$P$": current keyboard setting. [Workabout only]
  Offset  0 (byte): setting (0 = standard, 1 = special)

"C$P@": current drive last time the command processor was exited.
[Workabout only]
  Offset  0 (byte): drive letter (e.g. $4D or %M for the internal drive)

"C$PA": current path on drive A last time the command processor was exited.
[Workabout only]
  Offset  0 (cstr): current path
If the variable is unset, then the path is the root directory. Variables
"C$PB" to "C$PZ" can also exist.

"D$X": @@@ alleged to be something to do with dialling settings

"EM$": full pathname of the 8087 emulator software.
  Offset  0 (cstr): pathname

"P$D": printer device: 1 byte:
  Offset  0 (byte):
    48 = print device is a parallel port
    49 = print device is a serial port
    50 = print device is a file

"P$F": print to file name: up to 128 bytes:
  Offset  0 (cstr): last file used for printing to file

"P$M": printer driver: up to 129 bytes:
  Offset  0 (byte): printer driver model number
  Offset  1 (cstr): printer driver library
A printer driver library can support several similar printers; the model
number specifies which is selected.

"P$S": serial port setup: 12 bytes:
  @Unknown, but includes fields called tbaud, rbaud, frame, parity, hand,
  xoff, xon, flags, tmask@@something called P_SRCHAR format@

"S$SVER": system screen version number. [Workabout only]
  Offset  0 (cstr): version number as text

"WP$SPEL": used by the word processor @in some way when constructing its
menus, probably to indicate that the spell checker is available.

"WP$THES": used by the word processor @in some way when constructing its
menus, probably to indicate that the thesaurus is available.