The SETAPLUS.exe utility program is used to enable and disable various ANSIPLUS features while the system is running. SETAPLUS.exe can also be used to set the video display mode, character height, video page and graphics mode text treatment options, to define or list key reassignments, or to define the Ctrl+G beep tone. Changes made with SETAPLUS.exe are in effect only as long as your system is running. To change ANSIPLUS features for system startup, use the NEWAPLUS.exe program. SETAPLUS.exe is executed by a command of the form:
SETAPLUS <keyword> [<keyword> ... ]
where each <keyword> selects an ANSIPLUS feature or other option. As for the SETCOLOR.exe utility, if no <keyword> is supplied, you are presented with a menu of choices:
|
From the SETAPLUS command line, you control each ANSIPLUS feature with its own selection keyword:
|
|
When used in combination with the following keywords, each controllable feature can be enabled and disabled easily:
ON, YES, or TRUE | Enables the preceding feature |
ENABLE | Enables all following listed features |
OFF, NO, or FALSE | Disables the preceding feature |
DISABLE | Disables all following listed features |
RESET | Sets all features to their default values |
The following examples illustrate use of the SETAPLUS command line to control ANSIPLUS features:
SETAPLUS bright off | Disable bright key echo |
SETAPLUS enable capsunlock saver | Enable screen saver and Caps reset on Shift +alphabetic key |
SETAPLUS reset | Reset all features to their default status |
Other command line options include:
MODE <decimal mode number> | Set the video display mode |
HEIGHT <height> | Set the text character height |
PAGE <page> | Set the video page |
KEYDEF | Enter key reassignment definitions from the keyboard |
LISTKEYS | List all current key reassignments |
SAVEKEYS | Save the current key reassignments in a file |
LOADKEYS <file name> | Load key reassignment definitions from a file |
KEYSTACK <text> | Add keys or delays to the keyboard buffer |
RATE <char/sec> | Set the keyboard typematic repeat rate |
DELAY <quartersecs> | Set the keyboard typematic delay |
SAVESCROLLTEXT <file name> | Save scrollback to a file (text only) |
SAVESCROLLANSI <file name> | Save scrollback with ANSI color control |
SAVECLIP <file name> | Save the clipboard to a file |
LOADCLIP <file name> | Load the clipboard from a file |
BLANKTIME <minutes> | Set the screen saver blanking time |
SMOOTHRATE <rate> | Set the smooth scrolling rate |
TONE <frequency, duration list> | Set the Ctrl+G beep tone |
TEXT or TREATMENT | Reset graphics mode text treatments |
SHADOW, BOLD, ITALICS, UNDERLINE or OUTLINE | Enable text treatments |
STATUS | Report the current video mode, number of colors, etc. |
FEATURES | Report the settings of all ANSIPLUS features |
REPORT | Show both STATUS and FEATURES |
HELP | Show all keyword options |
Two keyword options are provided for managing the interrupt vectors used by ANSIPLUS:
INTERRUPT <list of selectors> | Displays, to the extent possible, the chain of programs attached to each selected interrupt |
LINK <list of selectors> | Relinks ANSIPLUS to the selected interrupt(s) |
You may specify interrupt selectors as either hexadecimal numbers or special keywords:
KEYEVENT | Interrupt 09h Key Event |
VIDEO | Interrupt 10h Video |
SYSTEMSERVICE | Interrupt 15h System Services |
KEYREQUEST | Interrupt 16h Keyboard Request |
KEYBREAK | Interrupt 1Bh Keyboard Break |
TIMERTICK | Interrupt 1Ch User Timer Tick |
DOSCALL | Interrupt 21h DOS Call |
DOSIDLE | Interrupt 28h DOS Idle |
DOSTTY | Interrupt 29h DOS Fast TTY Output |
MULTIPLEX | Interrupt 2Fh Multiplex |
MSMOUSE | Interrupt 33h Mouse |
PS2MOUSE | Interrupt 74h PS/2 Mouse Event |
For example, SETAPLUS INTERRUPT 2F will list the programs attached to the DOS Int 2Fh Multiplex interrupt.
All the features controlled by SETAPLUS are described in the Configuring ANSIPLUS page, except for three:
To reassign keys, use the KEYDEF keyword. You will be prompted for the key to reassign; after that, you type in the corresponding key reassignment, and terminate it with the End key.
To add keys to the keyboard buffer, use the keyword KEYSTACK, followed by any number of quoted text strings, key scan and character codes (scan code times 256 plus ASCII character code), or time delay directives ( /Wnnn for timer ticks, or /Dnnn for milliseconds). The following example enters "Dir", waits one second, then enters " *.*" and a carriage return:
SETAPLUS KEYSTACK " Dir " /W18 " *.* " 13
To define the beep sound from the command line, follow the keyword TONE with zero, one or more frequencies in Hertz and durations in milliseconds. For example,
SETAPLUS TONE installs the default 880hz 385ms tone
SETAPLUS TONE 1397,110,1047,165 defines a two-tone Ctrl+G beep.
© Copyright 2000-2007, Kristofer Sweger. All rights reserved. |
Rev. 10/16/07 |