Variables - jedimatt42/fcmd GitHub Wiki

Force Command Environment Variables

System Variables

CLOCK

Set the device for reading date and time.

CLOCK may be set to one of the following values:

  • PI.CLOCK - TIPI network time
  • CLOCK - Corcomp compatible clock
  • IDE.TIME - IDE controller running Fred Kaal's DSR
  • MBP - MBP and MBPII real time clock boards

An attempt is made to auto-detect the clock on startup. If it succeeds, the CLOCK variable will be set. If you have more than one clock, this may still be overridden by setting the variable.

Note: MBP/MBPII is limited, and does not track current year.

FONT

Set FONT to the pathname of a FONT file to load. These should be PROGRAM image files with no header, starting at character ascii code 0.

When the screen display mode is setup, such as when changing widths or running a program like VIRGIL99 that forces 80 column mode, then the font in the specified file is loaded. If there is an error loading that font, then the default ForceCommand font from ROM is loaded. If the FONT environment variable isn't specified, the default pathname of TIPI.FC.FCFONT is used.

example:

FONT=TIPI.FC.MDOSANSI

Force Command includes 2 font files, and the built in font. You can load XB256 type fonts with the executable FC.BIN.FONT /w option, and then save back out as a file for use with the FONT environment varialbe using the FC.BIN.FONT /s option.

PATH

Define the search path for scripts and executables used when the given command is not a built-in command.

Path entries are separated by a semicolon ; and should be full devicename and directory paths ending in a period. Force Command paths with crubase prefix is also supported.

(Update: the trailing . period is now optional.)

PATH=DSK5.;TIPI.BIN.;TIPI.FC.BIN;1000.DSK4.;

PROMPT

Allows customization of interactive command prompt. Various escape codes allow substitution of specific values.

Code Description
\c crubase followed by a '.'
\p drive and directory (includes trailing '.')
\b backspace
\g greater than symbol '>' (this is escaped in MS-DOS cause they support redirects... maybe someday I will too)
\n new line
\r pipe `
\s space ' '
\t 12 hour clock with am/pm (hint if you don't want the AM PM, use 2 backspaces)

Example:

PROMPT=\p\g

produces a prompt like:

DSK1.>

If not set, the prompt behaves like it is set to [\c\p]\n$\s, which looks like:

[1100.DSK1.]
$

XBMOD

Control module loaded by XB command. See XB for usage details.

XBADDR

Control module entry point for XB command. See XB for usage details.