Piper's Pit BBS/FTP: ibm 0010

home *** CD-ROM | disk | FTP | other *** search

/ Piper's Pit BBS/FTP: ibm 0010 - 0019 / ibm0010-0019 / ibm0010.tar / ibm0010 / REFLECT.ZIP / WHATSNEW.DOC < prev next >

Wrap

Text File | 1990-05-18 | 54.5 KB | 1,427 lines

WHATSNEW FOR VERSION 3.4 * Indicates new features as of Version 3.43 ** Represents changes to R4 only *** Indicates new features as of Version 3.47 API (Application Program Interface) support API capability, when loaded with /W, is in all Reflection products at the Version 3.40 level. The API disk with additional documentation (API.DOC) and libraries is shipped with PLUS versions only. The PLUS manual contains an introduction to API. Command Language Checking for specific features Command files now have the extension .RCL Better support provided for macro-replacement of null variables New string operator: ENV New boolean: TSR New set commands: SET CONTINUE-REPORT SET HOST-INITIATED-COMMANDS SET PRINTER-FILE <"filespec"> SET PRINTER-INTERFACE FILE SET PRINTER-PASSTHRU-CONV SET SUSPEND-DATACOMM SET XMODEM-CRC New keywords: COLUMN DISCONNECT RESETCOMM ROW SCOLUMN SROW Syntax changes to existing keywords: ACCEPT KGET Set-Up Screen Changes: Basic Set-Up Screen (previously only in R1 / R7) Text Mode Color Set-Up (TxtColor) was previously Display Enhancements ** Graphics Mode Color Set-Up (GrfColor) ** ColorMap Set-Up added to R4 DA Response: VT320 choice added "LA50" on the Printer Set-Up screen is now "DEC" "Command" now Softkey choice on Softkey Set-Up Screen ** Sixel Set-Up added to R4 Tabs Set-Up now accessed via Terminal Set-Up key Terminal Set-Up, Page 3 added to R2 and R4 Terminal Type: VT300-7 and VT300-8 have been added VT300-7 is now the default for R2 ** Video Set-Up added to R4 ** Crystal Clear Support (available with the Crystal Clear Complement) Datacomm Additions: Added COM3/4 support for IRQ2/5 CTERM DESQVIEW Support - See "Using Reflection with other Software" below. Escape Sequence Additions/Changes: Add CSI>99h and CSI>99l to enter/exit alphgraf mode, respectively. DEC Tektronix drawing mode escape sequence support VT320 escape sequences File Changes on Disk: A1MAIL.RCL - New program to alert when mail is received via ALL-IN-1 CHARTRAN.COM - This new program replaces DEC2IBM and IBM2DEC. CTERMCI.EXE added for CTERM datacomm choice support *** UPDATED KEYMON.COM *** VAXLINK.EXE is now version 6.02 VFONT.FT is no longer needed for R2 and R4. ** R4FONT.FT replaces VFONT.FT in Reflection 4. The PC2PC*.* files have been removed. These files are available on Walker Richer & Quinn's Bulletin Board. (Use KERMIT instead). R2386.PIF/R4386.PIF files are now provided for Windows 386 support. ** RESOLVE.DAT - Diagnostic ReGIS file to test video resolution. WRQINQ.IMG is a new file that requests the Reflection serial number in a way that can easily be used from DCL. Keyboard Remapping: Backarrow-key Printing Print-To-Disk capability * R304.COM - Zenith Z-304/404 driver available on request ** Resolution/Adapter support increased (see Video Set-Up for more information) ** Sixel Support (see Sixel Set-Up for more information) Switches added: Spaces are now allowed before the "=" in an environment switch setting. *** /K0-3 Additional Keyboard functions /Y Disable int 21 function 0AH handling. Provides compatibility with DOSEDIT/CED/NDE DOS command line editors. /W Enables API support VT320 emulation configuration of status line type backarrow key definition compose key definition LATIN-1 character set support Windows 386, Reflection now assumes /J/I and no background. See "Using Reflection with other Software" below. ------------------------------------------------------------------------------ *** KEYBOARD SWITCHES The following switch settings have been added with Version 3.47: You may want to run the diagnostic program KEYMON.COM to determine if your hardware has interrupt 15 support. See below for more details. NOTE: In some cases, it could be necessary to use both /K0 /K2 or /K0 /K3. Those switch settings do not conflict and may be used in combination with each other. /K0 Some PCs and memory-resident programs are incompatible with the use of Enhanced keyboard interrupt 16 calls, and this can make Reflection hang when it is started. /K0 forces Reflection to use its default mapping and assume that your PC is equipped with a pre-enhanced keyboard BIOS. Your keyboard is treated as though it were an older PC-style keyboard. /K0 is equivalent to /K in prior versions of Reflection. /K1 Forces Reflection to handle keyboard interrupts via interrupt 9 and do PC/XT-style keyboard enable. (This is the default.) /K2 Forces Reflection to handle keyboard interrupts via interrupt 9 and do AT-style scan code locking if the machine is an AT or compatible. Use this switch if both of the following are true: - You are using an AT or compatible machine that DOESN'T have interrupt 15 support for handling keyboard interrupts (e.g., an older Vectra). - You are a DECnet/PCSA user and you find that the cursor pad arrow keys on your Enhanced keyboard occasionally generate numbers instead of cursor movement (as if the SHIFT key were being held down.) NOTE: Some older TSRs running with Reflection in this mode may hang your machine. /K3 Forces Reflection to use interrupt 15 if available (on PS/2s and most ATs). Use this switch if both of the following are true: - You are using an AT or compatible machine that DOES have interrupt 15 support for handling keyboard interrupts. - You are a DECnet/PCSA user and you find that the cursor pad arrow keys on your Enhanced keyboard occasionally generate numbers instead of cursor movement (as if the SHIFT key were being held down.) UPDATED KEYMON.COM The keyboard diagnostic program KEYMON.COM has been updated. Type KEYMON from the DOS prompt to display the value of the hardware flag and determine if the support for the interrupt 15 Function 4F for hooking keyboard interrupts is available. ------------------------------------------------------------------------------ APPLICATION PROGRAM INTERFACE (API) With the arrival of the background multitasking feature, it made sense to provide a way for foreground programs to 'hook' into Reflection so that they could initiate file transfers, log on to a host computer, dial a modem or perform some other communication functions. Reflection's API provides that service, allowing DOS programs to control a background copy of Reflection and make the background copy do anything that a user could do. Now your programs can simulate a user typing on the keyboard, issuing commands, filling in data entry screens, even pressing the hot-key which would pop Reflection into the foreground. See the PLUS Manual and the file API.DOC for further information. All standard versions of Reflection will be shipped with the API support starting with Version 3.40. The code will not be loaded into memory, however, unless Reflection is invoked with the /W switch from the DOS command line: R2 /W or R4 /W ------------------------------------------------------------------------------ COMMAND LANGUAGE PLEASE NOTE: All Reflection command files previously had the extension .CMD As of Version 3.40, these files have the extension .RCL CHECKING FOR SPECIFIC FEATURES As features are added to Reflection command language, there is an increasing need to test for those features when writing command files that may be run on different versions of Reflection. The following technique is recommended: CONTINUE LET V1 = ROW IF ERROR DISPLAY "Please upgrade your copy of Reflection^M" STOP ENDIF This is a better approach than testing for a specific version number, because a particular feature may be added at different version numbers in PC and Macintosh versions of Reflection. ______________________________________________________________________________ Better support is provided for macro-replacement of null variables. If a variable contains a null, and you macro-replace the variable into a command (e.g DISPLAY "$1..."), then the null will be replaced by '^@'. ______________________________________________________________________________ The following error codes were inadvertantly omitted from the 3.4 Command Language Reference Manual: 97 Encryption version mismatch 101 No files were found to back up 103 Backup terminated by user 104 Backup terminated due to error ______________________________________________________________________________ NEW STRING OPERATOR: ENV ENV looks up a string in the DOS environment area. If it is not found, then the returned string is null length. Syntax is LET V1 = ENV(<string>) or DISPLAY ENV("Reflect2"). NEW BOOLEAN: TSR Some commands work differently once Reflection has been placed in background (notably SHELL). The TSR function may be tested to see if this has taken place. IF TSR DISPLAY "Can't SHELL after you use the hot-key^m^j" ELSE SHELL ENDIF NEW SET COMMANDS: SET CONTINUE-REPORT YES/NO CONTINUE-REPORT YES allows command files to have CONTINUE ON set so that errors do not abort processing, and yet display error messages to users when an error occurs. Pressing RETURN clears the error state and continues with the next command. NO is the default. EXAMPLE: SET CONTINUE-REPORT YES CONTINUE ON SEND myfile1 SEND myfile2 SEND myfile3 If any of the transfers fails, pressing Return would attempt to send the next file. SET HOST-INITIATED-COMMANDS YES/NO Reflection provides a means for a host to initiate commands via three escape sequences. They differ only in whether a completion code is returned to the host: ESC &oC<command>CR returns a comp. code if DISABLE-COMP-CODES is NO. ESC &oB<command>CR returns a comp. code regardless of how DISABLE-COMP-CODES is set. ESC &oF<command>CR never returns a completion code regardless of how DISABLE-COMP-CODES is set. If a command or command file is originated from the host, then error messages (such as "Invalid syntax") will not be generated. The error will be noted internally, and if not "continued", command file execution would stop and a "F" completion code would be sent. This change means that host- originated commands will not need "CONTINUE ON" for protection, which is a somewhat dangerous approach. Host-initiated commands are processed by Reflection except for the following conditions: - HOST-INITIATED-COMMANDS is set to NO. The escape sequences listed above are ignored, and serial number requests are treated as terminal ID requests. - The command line is up. If a command or command file is currently executing, many host-initiated commands can still be used. However, the following are NOT allowed: ACCEPT HELP TYPE DIR HOLD VERIFY DISPLAY READHOST WAIT SET PRINTER-FILE "<filespec>" This parameter specifies the name of the file that printer output should be sent to. The value of this SET parameter must be set before PRINTER-INTERFACE is set to FILE. If the PRINTER-FILE name used already exists, output is appended to the existing file. SET PRINTER-INTERFACE FILE The option FILE has been added to the choices for the SET PRINTER-INTERFACE command. SET PRINTER-PASSTHRU-CONV YES/NO The PRINTER-PASSTHRU-CONV parameter controls whether or not Reflection translates data in printer passthrough (printer controller) mode. If your host software understands PC printers, PRINTER-PASSTHRU-CONV should be set to NO. When configured to YES, escape sequences are stripped and the setting of PRINTER-CONTROL-CODES affects the translation of data as follows: DEC Data is unaltered. All other 8-bit characters are converted from MCS to IBM-8. selections SET SUSPEND-DATACOMM YES/NO This SET parameter functions programmatically just like the Hold Screen key. Unlike the Hold key function, the DISPLAY, DIR, and ACCEPT commands still function normally. SET XMODEM-CRC YES/NO/ONLY This command sets whether XMODEM attempts CRC error-checking. If set to NO, and the host XMODEM does not support CRC error-checking, the start of file transfers are faster due to the lack of negotiating with the other end of the transfer. NEW KEYWORDS COLUMN The COLUMN function returns the number of the current column in display memory. EXAMPLE: DISPLAY COLUMN The result of this display is the current column. COLUMN can be used as an integer value directly to perform arithmetic operations. LET V3 = COLUMN + 4 DISCONNECT This command forces a disconnect from the PC side. DISCONNECT functions differently depending on the type of host connection. If you are connected via a serial port, Reflection lowers the Data Terminal Ready (DTR) signal for 200 milliseconds. This function disconnects a properly configured modem. If you are connected via LAN, the appropriate LAN disconnect signal is transmitted. The following keystroke can also be used to DISCONNECT: CTRL-F4 RESETCOMM RESETCOMM resets a Hayes Smartmodem 1200B to its power-on state. RESETCOMM will also suspend the current LAN session or negotiate for an MNP connection. The following keystroke can also be used to RESETCOMM: CTRL-F5 ROW The ROW function returns the number of the current row in display memory. EXAMPLE: DISPLAY ROW The result of this display is the current row. ROW can be used as an integer value directly to perform arithmetic operations. LET V3 = ROW + 4 SCOLUMN The SCOLUMN function returns the number of the current column in Reflection's screen. EXAMPLE: DISPLAY SCOLUMN The result of this display is the current screen column. SCOLUMN can be used as an integer value directly to perform arithmetic operations. LET V3 = SCOLUMN + 4 SROW The SROW function returns the number of the current row in Reflection's screen. EXAMPLE: DISPLAY SROW The result of this display is the current row. SROW can be used as an integer value directly to perform arithmetic operations. LET V3 = SROW + 4 SYNTAX CHANGES TO EXISTING KEYWORDS ACCEPT ACCEPT [<time>] V{0-9} [UNTIL {<text> | FULL}] [LIMIT <number>] [TERMINATOR V{0-9}] [NOECHO] This command accepts a value from the keyboard into a command variable. UNTIL "^M" is the default, and terminates the string upon receipt of any one of the characters specified. UNTIL FULL causes termination of the string when the limit is reached. TERMINATOR, as in READHOST, stores the character that terminated the string. A timeout similar to READHOST's allows the use of IF FOUND in conjunction with ACCEPT. NOECHO prevents input from appearing on the screen as it is typed. This is primarily for password ACCEPTS. KGET The syntax for KGET has been changed to: KGET <string> [FROM <string>] [APPEND|DELETE] [ASCII|BINARY] This command receives a file from a remote KERMIT running in Server mode. The filename may be a string expression, but <string> must result in a filespec. Without the FROM clause, DELETE is assumed. ----------------------------------------------------------------------------- New TEXT MODE COLOR SET-UP A new, easier to use, color configuration screen is provided in this version. This screen allows configuration of foreground and background used on "text" (as opposed to graphics) screens. See the Quick Start Guide for further information. ___________________________________________________________________________ New GRAPHICS MODE COLOR SET-UP Graphics Mode Color Set-Up Reflection 4 lets you set up two different color configurations: 1) Text mode color 2) Graphics mode color There is a separate Color Map Set-Up that you get to from the Graphics Mode Color Set-Up screen. It is equivalent to the VT340 terminal's color set-up. Use the following steps to get to the Graphics Mode Color Set-Up screen: 1. Press Alt-S to get to the Set-Up keys. 2. Press F3, Graphics, to display the graphics Set-Up labels. 3. Press F5, GrfColor, to display the Graphics Mode Color Set-Up screen. Configuring Color There are three major items you can configure: Screen Function Key Labels Host Attributes Screen and Function Key Labels For each item, you can configure the foreground (text) and background (screen) colors. You can also determine if it should blink, be underlined, or both. By default, R4 assigns VT340 values to each of the items. Changing the Colors of the Screen and Function Keys To change the foreground color, make sure that Screen is highlighted, and then use Tab or the right arrow to highlight the number in the Fgd column. Use the Next or Previous Choice keys to change the color. Position the cursor under "Fgd" (foreground) or "Bgd" (background). Then press Next or Previous Choice keys (F1 or F2) to select the next or previous color. As you select different colors, you will see the colors on the SAMPLE SCREEN and SAMPLE change. The available colors can be seen at the bottom of the screen. Press F5 (Activate) to make your selection. To change the colors of the function key labels, make sure that Function Keys is highlighted, and then use the same steps as above to select a background and foreground color. Changing the Colors of Host Attributes DEC terminals support 16 combinations of display enhancements, namely blinking, inverse video, underline, and bold intensity. In graphics mode, R4 is capable of displaying all 16 display enhancement combinations. From the Graphics Mode Color Set-Up screen, press the down or up arrow until Host Attributes is highlighted. The display then changes to show a list of 14 host attributes. Set foreground, background, blink, and underline attributes as described above. Current ┌─────────────────┬─────┬─────┬─────┬─────┐ Colors │Item to Configure│ Fgd │ Bgd │Blink│Undln│ ├─────────────────┼─────┼─────┼─────┼─────┤ Graphics Mode Text SAMPLE │Screen │ 7 │ 0 │ NO │ NO │ Color Selection SAMPLE │Function Keys │ 0 │ 7 │ NO │ NO │ │Host Attributes │ │ │ │ │ └─────────────────┴─────┴─────┴─────┴─────┘ ┌──────────────────────────┐ │ │ Move the cursor up and down to │Username: USER │ select the item to configure. │Password: │ Then move the cursor right and │ Last interactive login │ use F1 and F2 to select │$ _ │ background and foreground │ │ color numbers. Use F7 to │ │ change the colors associated │ │ with the color numbers │ FKEY1 FKEY2 FKEY3 │ └──────────────────────────┘ Sample Screen Colors Numbers 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 For Fgd and Bgd ___________________________________________________________________________ Color Map Set-up Press F7 to go to the ColorMap Setup screen from the Graphics Mode Color Setup screen. Use the left or right arrows to select a color (from 0 to 15), and the up or down arrows to select the red, green, or blue component. Then press F1 or F2 to increase or decrease the amount of red, green or blue in the selected color. You will see the color change in the sample color bar. Press F5, activate color, to make your selection. You will then be back at the Graphics Mode Color Set-Up screen. Colormap Set-up ┌─────────────┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┐ │ Color Number│ 0 │ 1 │ 2 │ 3 │ 4 │ 5 │ 6 │ 7 │ 8 │ 9 │ 10│ 11│ 12│ 13│ 14│ 15│ ├─────────────┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤ │ Red │ 0│ 0│ 99│ 0│ 99│ 0│ 99│ 66│ 33│ 33│ 66│ 33│ 66│ 33│ 66│ 99│ │ Green │ 0│ 0│ 0│ 99│ 0│ 99│ 99│ 66│ 33│ 33│ 33│ 66│ 33│ 66│ 66│ 99│ │ Blue │ 0│ 99│ 0│ 0│ 99│ 99│ 0│ 66│ 33│ 66│ 33│ 33│ 66│ 66│ 33│ 99│ ├─────────────┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤ │ Hue │ 0│ 0│120│240│ 60│300│180│ 0│ 0│ 0│120│240│ 60│300│180│ 0│ │ Lightness │ 0│ 50│ 50│ 50│ 50│ 50│ 50│ 66│ 33│ 50│ 50│ 50│ 50│ 50│ 50│ 99│ │ Saturation │ 0│ 99│ 99│ 99│ 99│ 99│ 99│ 0│ 0│ 33│ 33│ 33│ 33│ 33│ 33│ 0│ └─────────────┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┘ _______________________________________________________________________________ SOFTKEY ADDITION The define softkeys screen how has an additional key type: "command" The strings for keys defined as "command" are interpreted as Reflection commands. To support this two new values for attr have been added to Esc&F<attr>a... : 0 normal old 1 local old 2 normal CR new Treated as normal except that the definition is stored with a CR appended to the end. This is for Posthaste compatibility. 3 command new The definition is stored as type "command" as described above. _______________________________________________________________________________ SIXEL SUPPORT Sixel Set-Up In sixel graphics the screen image is received from the host, or shipped to the host or DEC printer, 6 pixels at a time (a column 1 pixel wide and 6 pixels high). Reflection 4, like the VT340, lets you draw monochrome or color images with sixel data. The Sixel Set-Up menu only needs to be changed when you are generating sixels, not receiving them. The VT340 implementation is supported even if you are set up as another terminal in the Terminal type field on Terminal Set-Up, Page 1. Default values are indicated by an asterisk in the descriptions below. Sixel graphics level Each sixel graphics level has a sixel aspect ratio and a horizontal grid size. Most DEC printers can operate at Level 2. This means that they can also operate at LEVEL 1. LEVEL1 Selects a sixel aspect ratio of 2:1 and a horizontal grid size of about 188 x .025 mm (7.5 x .001 inches). LEVEL2 Selects a sixel aspect ratio of 1:1 with a variable grid size. LA210 Selects a sixel aspect ratio of 1.02:1 and a horizontal grid size of about 338 x .025 mm (13. x .001 inches). Some printers only understand a certain level of graphics. The LA50, for instance, is a Level 1 printer and cannot operate at Level 2. If you are using an LA210, you can select either LA210 or LEVEL 1. Values: LEVEL 1* LEVEL 2 LA210 Sixel print option The COMPRESS option prints an image pixel for pixel. EXPAND prints each pixel twice as wide and twice as high. ROTATE rotates the image 90 degrees (from a portrait orientation to landscape). Values: COMPRESS* EXPAND ROTATE Color printing Select monochrome or color printing depending on your printer. Values: MONO* COLOR Color specification This field selects the color coding method for the printer. It is relevant only if Color printing is set to COLOR. Values: HLS* RGB Sixel destination The sixel image can be sent to the printer or the host. Choose HOST, for instance, if you want to include a sixel image inside an ALL-IN-1 mail message. Values: PRINTER* HOST Enable graphics printing When this field is set to YES, Alt-PrtSc can do one of two things, depending on the setting of Control codes on the Printer Set-Up: - If Control codes is set to DEC, a sixel image is sent to the printer. - If Control codes is set to a value other than DEC, a graphics dump is sent to the printer. When set to NO, only a text version of the image on the screen is sent to the printer. Values: YES* NO ___________________________________________________________________________ Terminal Set-Up, Page 3 This Set-Up screen introduces the VT320 features that Reflection now supports including: Configuration of status line type Backarrow key definition Compose key definition LATIN-1 character set support These features can be controlled from a set-up screen as well as via escape sequences. Default values are indicated by an asterisk. Status line type The VT320 display has a 25th line at the bottom of the screen called the status line. When this field is set to INDICATR, the status line is shown in inverse-video and displays the cursor position (row, column). When set to HOST, the status line serves as a one-line window of display memory that the host can write to. Values: NONE* INDICATR HOST An escape sequence allows the host application to select which display the primary display (the top 24 lines) or the status line display is active. Cursor style The cursor may appear as a blinking underline or a blinking box. Values: ULINE* BLOCK Cursor visible This field determines whether or not the cursor is visible. Values: YES* NO Backarrow key On the VT300 series keyboard the backarrow key (<x) is configurable: it can be set up to send either a delete (ASCII 127) or a backspace (ASCII 8). Pressing Ctrl -<x sends a cancel. In Reflection, you can configure Backspace to send either delete or backspace, but Ctrl-Backspace sends the opposite of what Backarrow key is configured to. So if this field is configured to send backspace, then Ctrl-Backspace will send a delete. Values: DELETE* BKSPACE Compose key The compose key (Alt-F8) can be enabled or disabled. Values: ENABLED* DISABLED User-preferred set The user-preferred supplemental set (UPSS) is a character set that supplements the ASCII set. The combination of the ASCII and DEC Supplemental Graphics character sets is called the Multinational character set (choose MCS). The combination of the ASCII and Latin-1 sets is called the ISO Latin-1 character set. Values: MCS* LATIN-1 ______________________________________________________________________________ Video Set-Up (Reflection 4 only) Blink characters in graphics mode The setting of this field overrides the Blink column on the graphics mode Color Set-Up screen. If you select NO, you will not get any blinking characters. Values: YES* NO Maintain unscaled image The VT terminal's display is 800 x 480 pixels, while the PC's is normally 640 x 350. By default, Reflection scales graphics images down so that the entire image will fit on the PC display. Set this field to YES if you want to see the image exactly as it would appear on a terminal display. Values: NO* YES Enable hardware scrolling This field should be set to YES if you are using a resolution of 640 x 350 and you want to be able to do smooth scrolling. This may also be used to speed up jump scrolling. (See the Technical Reference manual for a discussion of Scrolling speed on the Terminal Set-Up, Page 1 menu.) The YES setting allows two pages of EGA memory to be saved and thus makes scrolling faster. If you are using a higher resolution (over 640 x 350) you may see some interference on the screen when you scroll. This is because the EGA is unable to store more than one complete page in its memory. Values: YES* NO Resolution choice Reflection 4 supports a number of resolutions for graphics images within the limits imposed by your PC hardware. Unless the manufacturer or model is specified, EGA means an IBM Enhanced Graphics Adapter or compatible with an Enhanced Color Display. VGA means an IBM Video Graphics Adapter or compatible with an analog display. A multi-frequency monitor can handle any of the resolution choices. The default resolution is supported by all adapters. Adapter Resolution Monitor Type ------------------ ----------- ------------ + EGA/VGA 640 x 350 ECD/ANL, or MF * EGA with Crystal Clear(I) 800 x 350 ECD or MF ? EGA with Crystal Clear(II) 640 x 480 MF ? EGA with Crystal Clear(II) 800 x 500 MF + VGA 640 x 480 ANL or MF Paradise 480 EGA 640 x 480 MF Genoa SuperEGA 640 x 480 MF TECMAR VGA/AD 800 x 500 MF AST VGA 800 x 500 MF Video 7 VEGA VGA 800 x 500 MF STB VGA Extra/EM 800 x 500 MF Genoa SuperEGA or VGA 800 x 500 MF Allstar Peacock VGA 800 x 500 MF HP D1180A VGA 800 x 500 MF Tatung VGA or FastWrite VGA 800 x 500 MF Western Digital Paradise VGA 800 x 500 MF # Other VGA 800 x 500 MF Legend: + Standard resolution supported by the indicated adapter. No possibility of anything going wrong, although we have seen some multi-frequency monitors locate the screen off center or squish it vertically. Solution is to twist some knobs on the MF monitor and re-center the image. * EGA's in 800x350 mode with 20Mhz Crystal Clear should also always work on all monitors. ? EGA's in 640x480 or 800x500 mode with 26.56Mhz Crystal Clear may not work if the EGA is an older one, built with slow memory chips. The adapter just can't drive the display fast enough. This is fairly rare. # IBM VGA (and other VGAs without a built-in 800x600 mode) at 800x500 resolution may or may not work well. This setting seems to work OK on NEC Multisync II, and is knob-able on the Sony Trinitron. ----------------------------------------------------------------------------- CRYSTAL CLEAR SUPPORT Crystal Clear is a device that attaches to the feature connector of any IBM-compatible EGA card. It provides high-quality, 132-column mode display with any monitor. With a multi-frequency monitor, it can provide graphics resolution of 640 X 480 and 800 X 500. EGA adapters with Crystal Clear should note the following: If you are using 20Mhz, the 800 x 350 resolution works on all EGA and multifrequency monitors. If you are using 26.56Mhz, you must use a multifrequency monitor. The higher resolution choices of 640 x 480 and 800 x 500 may not work with an older EGA card. ______________________________________________________________________________ DATACOMM CHOICE ADDITIONS VERSION 3.40 HAS ADDED COM3/4 SUPPORT FOR IRQ2/5 The defaults for ATs and PS/2s are as follows: IRQ Line Defaults COM Port AT: IRQ Default COM1 IRQ4 COM2 IRQ3 COM3 IRQ10 (Configurable to IRQ2 or IRQ5) COM4 IRQ11 (Configurable to IRQ2 or IRQ5) COM5-8 Not Applicable The following applies only to users with an AT or compatible machine. This will not be possible on PS/2 machines since COM1 uses IRQ4 and COM ports 2-8 default to IRQ3. The Reflection IRQ defaults for COM3 and COM4 work with an HP241B card; if you have this card, you should use the default IRQs for COM3 and COM4. If you have a COM3 or COM4 serial card on which you can select either IRQ2 or IRQ5, Reflection offers a way to use the card. This is done on the Basic or Datacomm Set-Up screen. Make sure that no two devices are using the same IRQ line. Use the COMCHECK utility to check what communications ports and IRQ lines are being used. ______________________________________________________________________________ MULTI-SESSION CTERM INTERFACE Reflection's CTERM Command Interpreter lets you create and maintain multiple sessions to one or more DECnet hosts on your DECnet network with a single copy of Reflection. It will also allow you to maintain your sessions while Reflection is not installed. For instance, you could log onto the VAX using CTERM, start a process on the host, uninstall Reflection (Alt-X), and then later restart Reflection and resume the same session. Commands are similar to those used by the DECserver 200. A short explanation of the terminology used to describe Reflection's multi-session CTERM interface follows. The Command Interpreter session is the control and data path between Reflection and the CTERM Command Interpreter (or CI). This path is established when the CTERM datacomm choice is first activated in Reflection and remains in effect until Reflection is terminated (Alt-X). The CTERM session, on the other hand, is the control and data path between the CTERM Command Interpreter and a DECnet host. A CTERM session is created when a user connects to a node using the CONNECT command and remains until the user does one of the following: Logs off of the host node. Disconnects the CTERM session using the DISCONNECT command. The host terminates the session. The CTERM Command Interpreter is uninstalled using the /U switch. You can switch from your current session to the Command Interpreter, and switch among existing CTERM sessions. Installation To run Reflection over an Ethernet network using the CTERM protocol, you must first install the Ethernet hardware and SCH.EXE, DLL.EXE, DNP.EXE and CTERM.EXE drivers as explained in your DECnet-DOS or PCSA/PC installation guide (Version 2.0 or greater of either product is required). To use the CTERM Command Interpreter, it must be installed before running Reflection. The command is entered at the DOS prompt; its syntax follows. CTERMCI [/C:<n>] [/L:<n>] [/U] By default, the CTERM CI will support four CTERM sessions and two CI sessions. These parameters can be changed with the following switches: /C:<n> Sets the maximum number of command interpreter sessions to 1 through 4. The default is 2. /L:<n> Sets the maximum number of CTERM sessions to 1 through 8. The default is 4. /U Uninstalls LATCI if it is installed. The commands to load SCH.EXE, DLL.EXE, DNP.EXE, CTERM.EXE and CTERMCI.EXE can be included in your AUTOEXEC.BAT file. SCH DLL [<drive>] [<path>] DNP [<drive>] [<path>] CTERM CTERMCI [/C:<n>] [/L:<n>] After Reflection is run, go to the Datacomm Configuration menu, and select 'CTERM' as the Datacomm port. Activate or save this change to your configuration file and press Return. The CTERM command interpreter prompt should appear: cterm> Using the Multi-Session CTERM Interface Once the CTERM CI has been activated you can create as many CTERM sessions as the CTERM CI was configured to support at installation by using the CONNECT command. After a session has been created you can return to the CTERM CI by either logging off the node you are connected to, or by entering Ctrl-F5 ; this way the session you just created will remain active. To view the available nodes use the SHOW NODES command. To view active sessions use the SHOW SESSIONS command. To continue an active session use the RESUME command. To terminate an active session from the CTERM CI use the DISCONNECT command. To move between active sessions without returning to the CTERM CI, use the keystroke Alt-N. The keystrokes for moving among active sessions and returning the user to the CTERM Command Interpreter are remappable. The following table shows the default keystroke, its remapping label, and the equivalent escape sequence: CTERM Command Interpreter Keystrokes Keystroke Remapping label Escape sequence Alt-N next-session Esc&bN Ctrl-F5 ci-mode Esc&bR See the Keyboard Remapping appendix. Uninstalling CTERM CI To uninstall the CTERM CI enter the following command: CTERMCI /U The CTERM CI cannot be uninstalled until all CI sessions have been terminated. All CTERM sessions are terminated when the CTERM CI is uninstalled. If CTERM CI is installed as a separate module, but you want your sessions to be terminated when you terminate Reflection, set DISCONNECT-ON-EXIT to YES at the Reflection command line. See the Command Language appendix for more information on this SET command. This is the equivalent of the CI command DISCONNECT ALL. CTERM CI Command Summary The format and description of each command is listed below. You can abbreviate all of the commands to the fewest number of characters that makes the command unique, in most cases one character. The following syntax error messages are common to all commands: Invalid command verb Ambiguous command verb Ambiguous keyword Invalid keyword Invalid parameter Too many parameters Additional parameter(s) required The symbol which caused the error is displayed between forward slash characters (/) when applicable. CONNECT CONNECT creates a new session to the node specified. Format: CONNECT {<node>} [<description>] <node> is the name a valid phase IV DECnet host; to determine valid nodes use SHOW NODES. <description> a string containing no spaces or tabs that will be displayed in SHOW NODES output; can be used to differentiate between multiple sessions to the same node (18 characters maximum). DISCONNECT This command lets you disconnect either a specific session, or all of them. Format: DISCONNECT {<session number> | ALL} <session number> is the session number of an existing session; see SHOW SESSIONS. DISCONNECT will terminate the CTERM session corresponding to <session number>. If ALL is specified, all CTERM sessions not in use by another CI session will be terminated. FORWARDS FORWARDS resumes the session with the next highest session number as shown in the session list. Format: FORWARDS If your current session has the highest session number or you have no current session, FORWARDS resumes the first session in the session list. If the session resumed is in the stopped state (see SHOW SESSIONS), the reason for the stop is displayed and Reflection returns to CI mode. HELP HELP will display documentation on the topic requested. If no topic is specified a list of valid topics will be displayed. Format: HELP [<topic>] Valid topics follow: CONNECT INSTALL DISCONNECT RESUME FORWARDS SHOW SESSIONS HELP SHOW NODES RESUME RESUME will resume the current session if no <session number> is specified. If the session resumed is in the stopped state (see SHOW SESSIONS), the reason for the stop is displayed and Reflection returns to CI mode. Format: RESUME [<session number>] <session number> is the number an existing CTERM session to be resumed. SHOW NODES SHOW NODES lists the names of the nodes in the local PC DECnet database. To add nodes to this database use the DECnet/DOS NCP.EXE utility program. Format: SHOW NODES SHOW SESSIONS SHOW SESSIONS displays the following information about each active session: Session number Node name Description entered in connect command Session status The session status returns one of the following messages: Connected The connection to the host is active Stopped Connection to the host has been terminated; resuming a stopped session will display the reason the session stopped. Current This session is your current session. In use This LAT session is the current session of another CI user. Format: SHOW SESSIONS RESTRICTIONS: The following restrictions are due to limitations in the DECnet/DOS CTERM implementation. The are several problems with file transfers using the CTERM interface. 1. Only seven bit file transfers are supported. (This is the default file transfer mode.) 2. A small block size (128 bytes or less) should be used for file transfers. File transfers (to the host) with larger blocksizes will work correctly but after the transfer is completed characters entered in terminal mode will not be echoed on the screen. 3. File transfers to the host are slow. Executing local DOS commands from the Reflection command line while a CTERM session is active will be slower than usual due to processing overhead caused by CTERM.EXE. ______________________________________________________________________________ FILE CHANGES ON DISK A1MAIL.RCL A1MAIL.RCL is a sample Reflection command file that can be used to receive ALL-IN-1 mail messages on your PC while you are running another PC application program in foreground. To use A1MAIL.RCL: 1) Run Reflection. 2) Log in to your VAX/VMS system. 3) Press Alt-F10 to bring up the command line. 4) Enter A1MAIL.RCL and press RETURN. Reflection places itself in background and returns you to the DOS command prompt. When Reflection detects that you have received mail, it invokes ALL-IN-1 and switches to the foreground. Reflection returns to background when you exit ALL-IN-1. To terminate A1MAIL.RCL, put Reflection in the foreground with the hot-key (usually Alt-(right)Shift) and enter Ctrl-C. CHARTRAN.COM CHARTRAN is a translation utility program which converts the characters in a file from the DEC MCS or Latin-1 character sets to IBM code page 437 or 850 and vice versa. It has a number of pre-defined translation tables. The type of table is specified by a switch added to the CHARTRAN command. Type CHARTRAN at the DOS prompt with no parameters to see a summary of the options. RESOLVE.DAT (R4 / R4 PLUS only) This file is designed to be a diagnostic tool for testing the video resolution once Crystal Clear has been installed. Crystal Clear is a Reflection Complement sold separately. Enter TYPE RESOLVE.DAT from the Reflection command line to run this file. See the Crystal Clear documentation for further information. WRQINQ.IMG This file is an executable program which, when run from the VAX, requests the Reflection serial number in a way that can easily be used from a DCL command procedure. To install, upload this file to your VAX host using Reflection with the IMAGE option. Rename the file on the VAX so that it has an .EXE extension. This program queues an asynchronous read to the terminal, then locks the keyboard and sends the Reflection serial number request sequence, CSI0;1234c. The pending read is set to terminate on a "c" or <cr>, or to timeout after 5 seconds. The received string is assigned to the symbol REFLECTION_ID (symbol_name). When the read terminates (it receives a terminator or it times out), the keyboard is unlocked. Three different values may be returned in REFLECTION_ID: Reflection Returns the Reflection serial number EXAMPLE: I04+340L123456 VT200 or VT300 series Returns the terminal primary device attribute terminal response EXAMPLE: CSI?62;1;2;6;7;8;9c Neither of the above Returns the string "NO RESPONSE" ______________________________________________________________________________ Escape Sequence Changes/Additions The following escape sequences are now supported with Version 3.40: Escape Sequence Mnemonic Description [Sorted by sequence] CSI 1$u DECRQTSR Request terminal state report CSI 1$w DECRQPSR Request cursor presentation state CSI 1$} DECSASD Status line = active display CSI 1$~ DECSSDT Status line: indicator CSI 2$u DECRQTSR Request color table report (VT300) CSI 2$w DECRQPSR Request tab stop report CSI 2$~ DECSSDT Status line: host writable CSI 3n DSR Report device malfunction CSI 5n DSR Request device status CSI 63"p VT300 emulation 8-bit controls CSI 63;0"p VT300 emulation 8-bit controls CSI 63;1"p VT300 emulation 7-bit controls CSI 63;2"p VT300 emulation 8-bit controls CSI !p DECSTR Reset to defaults (VT300) CSI &u DECRQUPSS Request UPSS CSI ?0i MC Send sixel graphics to printer CSI ?2i MC Send sixel graphics to host CSI ?10n DSR Report printer ready CSI ?13n DSR Reports no printer CSI ?15n DSR Request printer status CSI ?26n DSR Request keyboard dialect CSI ?27;<n>n DSR Report keyboard dialect CSI ?38h Enter Tek mode CSI ?38l Exit Tek mode CSI ?43h DECGEPM Expanded print mode CSI ?43l DECGEPM Compressed print mode CSI ?44h DECGPCM Print color mode CSI ?44l DECGPCM Print monochrome mode CSI ?45h DECGPCS Print color syntax = RGB CSI ?45l DECGPCS Print color syntax = HLS CSI ?46h DECGPBM Print background CSI ?46l DECGPBM Do not print background CSI ?47h DECGRPM Print rotated mode CSI ?47l DECGRPM Print compressed mode CSI ?55n DSR Request status of locator device CSI ?50n DSR A locator device is detected CSI ?53n DSR No locator device is detected CSI ?56n DSR Request info on locator device type CSI ?57;0n DSR No locator device connected CSI ?57;1n DSR Locator device is a mouse CSI ?66h DECNKM Keypad = application CSI ?66l DECNKM Keypad = numeric CSI ?67h DECBKM Backarrow key = BS (ASCII 8) CSI ?67l DECBKM Backarrow key = US (ASCII 127) CSI ?<n>;...<n>h SM Set DEC private modes CSI ?<n>;...<n>l RM Reset DEC private modes CSI ?i MC Send graphics to printer CSI ?0i MC Send graphics to printer CSI 0$} DECSASD Top 24 lines = active display CSI 0$~ DECSSDT Status line: none CSI 0;1234c Serial number request CSI 0n DSR Report no device malfunction CSI<n>;<n>$y DECRPM Report mode setting CSI>99h Enter graphics mode CSI>99l Exit graphics mode CSI?<n>$p DECRQM Request private mode setting DCS 0!u%5ST DECAUPSS Report/Select DEC supplemental UPSS DCS 1!uAST DECAUPSS Report/Select Latin-1 supplemental UPSS DCS 1$p....ST DECRSTS Restore terminal state DCS 1$s....ST DECTSR Report terminal state DCS 1$t....ST DECRSPS Restore cursor from DECCIR DCS 2$p....ST DECRSTS Restore color table DCS 2$s....ST DECCTR Report color table DCS 2$t....ST DECRSPS Restore tab from DECTABSR DCS 2$u....ST DECTABSR Report tab stop DCS <0-9>;<0-2>;P3;qs...sST Sixels DCS$q...ST DECRQSS Request control function setting DCS<n>$r...ST DECRPSS Report control function setting DSC 1$u....ST DECCIR Report cursor information ESC &oF<cmd>CR Reflection command/no completion code ESC &oR Display softkey labels ESC &oS Display main menu labels ESC &oT Display PK key labels ESC &oU Display status line (VT320) ESC /0d Tek drawing mode: dots on ESC /1d Tek drawing mode: dots off ESC /2d Tek drawing mode: complement dots ______________________________________________________________________________ Printing to Disk You can configure Reflection to route all printing to disk. Either the Printer menu or Reflection's command language can be used to set up for using this feature. The explanation below covers using the menu. The following steps send a screen dump to an ASCII text file: 1. Press Alt-S to get to the configuration keys. Press F5, Printer. 2. Change the Printer interface to FILE. 3. Enter a name in the File name field. Use SCREEN.DSK for this example. 4. Press F5 to activate the changes. The file SCREEN.DSK is now open. If you save this set-up to a configuration file, SCREEN.DSK is closed when you exit the program and re-opened when you run Reflection again. All printing is appended to SCREEN.DSK 5. Select a screen you want to print to disk. To see the help screen, for instance, press Alt-H. 6. Press Alt-PrtSc. You have saved the screen to SCREEN.DSK. By default, a form feed is appended to the end of the file, unless you set Form Feed after PrtSc to NO on the Printer menu. Subsequent printing will be appended to the same file until you reconfigure Printer interface to something other than FILE or enter a new name in File name. If you print to disk using Reflection's other printing functions, like COPY, you will need to close the file before you can view or edit it. The file is closed when you do any of the following: - Go to the "to" devices and toggle TO PRT off. - Enter a different name in the File name field. - Set the Printer interface to something other than FILE. - Exit Reflection (Alt-X). - Type CLOSE PRINTER on the command line. As is the case with other Reflection disk operations, characters are stored in the IBM character set unless DISABLE-TRANSLATION has been set to YES. ______________________________________________________________________________ R304.COM Version 3.43 -- Zenith Z-304/Z-404 driver R304.COM is a terminate-and-stay-resident program (TSR) that allows Reflection to work with the RS-232 serial port on Zenith Z-304 and Z-404 cards. This program is available upon request. Contact Walker Richer & Quinn for availability. ______________________________________________________________________________ SWITCHES It has always been necessary to set an environment switch via the DOS SET command with NO SPACES before the "=". This will no longer be necessary in Version 3.40 of R2 and R4. The following switch settings have been added: /W Enables API support Load Reflection with the /W switch to enable the Application Program Interface capability. /Y Reflection can work with most DOS command line editors once it is loaded using the /Y switch. Type R2 /Y or R4 /Y at the DOS prompt to make Reflection compatible with such editors as CED, DOSEDIT, and NDE. ______________________________________________________________________________ Using Reflection with Other Software Running Reflection Beneath Windows 286 With some set-up changes (discussed below), it is possible to run Reflection 2 beneath Windows 286. When Reflection 2 is installed before Windows and has been correctly configured it can multitask: you can hot-key between the two and Reflection will continue to work in the background. Use the following steps to reconfigure Reflection: 1. Run Reflection using the /P<n> and /S switches. (NOTE: /S is only available with Reflection 2). 2. Before Reflection has been installed in the background, change Display memory (K bytes) on the Terminal Set-Up, Page 1 menu from 20K (the default) to 8K. Activate or save this change. 3. Install Reflection in the background by using the hot-key (press Alt-(right) Shift). 4. Install Windows. 5. You can further reduce Reflection's memory requirements by adding /E and /I to the switches used in Step 1. /E indicates that expanded memory, if present, can be used. The /I switch indicates that different fonts will be used: characters that can be displayed are limited to those available on the PC. This saves about 8K. Operating beneath Windows 286 has a few drawbacks: The Windows screen can sometimes get garbled when Reflection's hot-key is used. This happens if you hot-key into Reflection when a Windows Dialog Box is on the screen, hot-key back to Windows, and then OK or cancel the dialog box. The Windows screen underneath the dialog box area will be garbled. It can be cleaned up by re-sizing the Windows screen slightly and forcing a re-draw. Reflection 4 cannot save and restore the Windows screen. Running with Windows 386 You can run Reflection in a window with Windows 386. Cut and paste can be used to move text to and from the Reflection window, and Reflection will multitask even when it is just an icon on the screen. Reflection cannot be placed in background with Windows 386. The hot-key is automatically disabled. You may experience problems with datacomm when it is running, and seems to have problems with some machines. Using .PIF Files Two .PIF files have been provided on your disks. R2.PIF and R4.PIF are designed to work with Windows 286. These .PIF files may also be used with Windows 386. R2386.PIF and R4386.PIF are designed to work with Windows 386 only. DESQview DESQview is a PC program that lets you run a number of applications simultaneously, each in its own window. Reflection can also be run inside a DESQview window in TEXT mode, therefore graphics are disabled. How to configure Reflection to run with DESQview is explained below. In order for DESQview to install Reflection correctly, it needs to know a few things about it. From the first menu, go to Open a Window and select Add a Program. In the Memory size (in K) field, enter: 170 for Reflection 2 250 for Reflection 4 In Parameters, enter /A (ignore the graphics adapter). The following options should all be set to NO : Writes directly to screen Displays graphics information Can be swapped out of memory Once all of this program information is saved, these settings are used when you run Reflection from within DESQview.