home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / mskermit / msvp98.txt < prev    next >
Text File  |  2020-01-01  |  18KB  |  460 lines
  1. Kermit-MS 2.32/A for NEC PC-9801
  2.  
  3. Program for machine-dependent part:
  4.  
  5.                 Hirofumi Fujii
  6.                 (National Laboratory for High Energy Physics, KEK)
  7.                      and
  8.                 Akihiro Shirahashi (University of Tokyo)
  9.  
  10.                 (The main program and many other machine-independent
  11.                 routines are programmed by Joe R. Doupnik)
  12.  
  13. Language:       Microsoft Macro Assembler (MASM) V4.0 or above
  14.  
  15. Version:        Kermit-MS 2.32/A (Machine dependent part: KEK v1.15)
  16.  
  17. Released:       Apr 25, 1989
  18.  
  19. Documentation:  Hirofumi Fujii
  20.                 (National Laborartory for High Energy Physics, KEK)
  21.  
  22.  
  23. Machine-dependent capabilities at a glance:
  24.  
  25.    Terminal emulation:             VT102, Tektronix 4014
  26.    Communication settings:         Speed, Parity, Flow Control, Echo
  27.    Transmit BREAK:                 Yes (and Long BREAK)
  28.    Local area networks:            Yes (only for Ungerman-Bass NETCI interface)
  29.    MS-Windows compatibility:       No
  30.  
  31.    Kana-Kanji handling
  32.      in connect mode:              Yes (DEC-code, JIS-7/8 and Shift-JIS code)
  33.      in session logging:           Yes
  34.      in file transfer mode:        No (can be sent only as a binary file)
  35.    Japanese Front end processor
  36.      compatibility:                Yes
  37.  
  38.    Terminal emulation:
  39.      Rollback capability           Yes
  40.      Modeline                      Yes
  41.      Printer control               Yes
  42.      Key redefinition              Yes
  43.      Screen Dump                   Yes (adapting Kana-Kanji)
  44.  
  45. MS-DOS Kermit for NEC PC-9801 is one of the "Kermit-MS" family.
  46. The basic usage is the same as "Kermit-MS" for IBM/PC.
  47. Therefore, this document describes only the diffrences from the
  48. IBM/PC.
  49.  
  50. 1. Terminal emulation options
  51.  
  52.    Summary of the default values:
  53.      Communication port          1 (COM1)
  54.      Terminal emulation          VT102
  55.      EscChar                     ^]
  56.      Display                     Regular, 8-bit
  57.      Keyinput                    BIOS
  58.      Keyclick                    off
  59.      Kanji-code                  DECcode (see note below)
  60.      Foreground Color            White
  61.      Background Color            Black
  62.      Highlight Color             Yellow
  63.      Modeline Color              White
  64.    (Note on Kanji display)
  65.      More precisely, the default character code is assigned as follows;
  66.        GL character set = G0 character set = JIS Roman (almost ASCII)
  67.                           G1 character set = DEC special graphics
  68.                           G2 character set = JIS Katakana
  69.        GR character set = G3 character set = JIS C6226 (2-byte Kanji).
  70.      Therefore, a SO invokes DEC special graphics and sending the JIS
  71.      X 0208 code with 8th bit on (DEC Kanji code) results the the Kanji
  72.      displayed.
  73.      These assignments can be changed by sending the
  74.      'invoke' or 'designate' escape sequence from the host. In this
  75.      case, DEC-Kanji may not be displayed.
  76.  
  77. The following options are diffrent from IBM/PC
  78.  
  79. SET BAUD baud-rate
  80.            The useful baud rates supported range from 300 to 9600 for CPU
  81.            clock 8MHz, and from 300 to 19200 for 10MHz clock.
  82.  
  83. SET PORT {number, COMn, Device [devicename], UB-NETCI}
  84.            The available ports are 1, 2, 3, or their equivalents COM1, COM2,
  85.            COM3.  However, current program only works on COM1.
  86.  
  87.            In the case of device, the communication port is controlled by
  88.            MS-DOS device-driver. The default device name is AUX. The
  89.            device-driver for AUX is RSDRV.SYS.  The CONFIG.SYS must
  90.            include
  91.  
  92.                            DEVICE = RSDRV.SYS
  93.  
  94.            To set-up the AUX device, you must invoke the SPEED command
  95.            before using this device.  For example,
  96.  
  97.            SPEED RS232C-0 1200 BITS-8 PARITY-NONE STOP-1 XON
  98.  
  99.            ( or SPEED R0 B8 PN S1 XON ).
  100.  
  101.            If Ungermann-Bass PC-NIU N98 board is installed, UB-NETCI port
  102.            is also available.  Note that the port name and the usage is
  103.            diffrent from IBM/PC.  See section 2 for more details.
  104.  
  105. SET TERMINAL {VT102, TEK4014, NONE}
  106.            Kermit-MS for NEC PC-9801 emulates two types of terminals,
  107.            DEC VT102 and Tektronix 4014.  Heath/Zenith-19 and VT52 are not
  108.            supported.
  109.  
  110. The set-up related SET TERMINAL commands:
  111.  
  112. CHARACTER-SET {UK, US}
  113.            Not implemented. See KANJI-CODE command for Japanese character sets.
  114.  
  115. COLOR
  116.            See FOREGROUND.
  117.  
  118. COOKED-LOG {ON, OFF}
  119.            If it is ON, logging is made just before putting the character
  120.            on the screen.  All control characters are eliminated except for
  121.            CR, LF, HT(TAB), VT . (i.e., Kanji code is converted to Shift-JIS).
  122.            All ESC sequences are eliminated.
  123.  
  124. CURSOR-STYLE
  125.            Not implemented.
  126.  
  127. FOREGROUND {WHITE, YELLOW, CYAN, GREEN, RED, BLUE, MAGENTA, BLACK}
  128.            Specify color for normal attribute characters. This color is used
  129.            in VT102 and TEK4014 emulation modes and not affected to the dumb
  130.            terminal screen.
  131.  
  132. HIGHLIGHT {WHITE, YELLOW, CYAN, GREEN, RED, BLUE, MAGENTA, BLACK}
  133.            The bold characters are displayed in diffrent color in VT102
  134.            emulation mode. This command specifyes the color for bold
  135.            characters.
  136.  
  137. KANJI-CODE {DEC-code, Shift-JIS, JIS-7, NONE}
  138.            Set the Kanji-Kana code to be used in connect mode.  The Kanji-
  139.            Kana characters from keyboard are translated to the specified code
  140.            before sending to the communication port and characters received
  141.            from communication port are translated from specified code to the
  142.            NEC-PC9801 internal Kanji-Kana code before displaying or printing.
  143.  
  144. KEYINPUT {BIOS, CON}
  145.            Specifies keyinput mode.  In BIOS mode, keyboard is read via
  146.            NEC-PC9801 bios.  In this mode, almost all the keys have their
  147.            own scan codes. However, Japanese front end processors except for
  148.            ATOK6 are not compatible with this mode.
  149.              To adapt many kind of Japanese front end processors, keyinput via
  150.            standard MS-DOS console (CON) i/o is also available.  The function
  151.            keys, arrow keys etc., are programmed to return the same scan-code
  152.            as in DIRECT mode.
  153.            See section 2 for keymap.
  154.  
  155. MODELINE-COLOR {WHITE, YELLOW, CYAN, GREEN, RED, BLUE, MAGENTA, BLACK}
  156.            Specify color for mode line.
  157.  
  158. GRAPHICS
  159.            Not necessary. The graphic VRAM of the NEC-PC9801 has 640x400
  160.            pixels.
  161.  
  162. MARGIN-BELL
  163.            Not implemented.
  164.  
  165.  
  166. ROLL
  167.            Not implemented.
  168.  
  169. SCREEN-BACKGROUND
  170.            See BACKGROUND.
  171.  
  172. TAB
  173.            Not implemented. Tabs are set at every 8th column and can be
  174.            changed only by host commands.
  175.  
  176.  
  177. 2. Keyboard mapping
  178.  
  179.    Unfortunately, many of the Japanese front end processors are not compatible
  180. with NEC keyboard bios. Therefore, this program has two modes for keyboard
  181. inputs, direct mode (read via bios) and CON mode (read using standard MS-DOS
  182. console i/o). The latter is compatible with all the Japanese front end
  183. processors. Special keys are programmed to return the same code as
  184. in direct mode. However, the keypad keys except for HOME-CLR and HELP are not
  185. programable, so that keypad keys cannot be distinguished from normal alpah-
  186. numeric keys in a standard way.
  187.  
  188.   The following table shows the diffrences of the scan codes between two modes.
  189.  
  190.                         BIOS mode                        CON mode
  191.                 ------ pressed with ------      ------ pressed with ------
  192.                 normal  SHIFT  CTRL   GRPH      normal  SHIFT  CTRL   GRPH
  193.  
  194.     STOP         \352   \384   \400   \352       \352   \384   \400   \352
  195.     COPY         \353   \385   \401   \353       \353   \385   \401   \353
  196.  
  197.       f1         \354   \386   \402   ----       \354   \386   ----   ----
  198.       f2         \355   \387   \403   ----       \355   \387   ----   ----
  199.       f3         \356   \388   \404   ----       \356   \388   ----   ----
  200.       f4         \357   \389   \405   ----       \357   \389   ----   ----
  201.       f5         \358   \390   \406   ----       \358   \390   ----   ----
  202.       f6         \359   \391   \407   ----       \359   \391   ----   ----
  203.       f7         \360   \392   \408   ----       \360   \392   ----   ----
  204.       f8         \361   \393   \409   ----       \361   \393   ----   ----
  205.       f9         \362   \394   \410   ----       \362   \394   ----   ----
  206.      f10         \363   \395   \411   ----       \363   \395   ----   ----
  207.  
  208.     ROLL UP      \310   \422   \438   \310       \310   \422   \438   \310
  209.     ROLL DOWN    \311   \423   \439   \311       \311   \423   \439   \311
  210.  
  211.       INS        \312   \424   \440   \312       \312   \424   \440   \312
  212.       DEL        \313   \425   \441   \313       \313   \425   \441   \313
  213.  
  214.     up    arrow  \314   \426   \442   \314       \314   \426   \442   \314
  215.     left  arrow  \315   \427   \443   \315       \315   \427   \443   \315
  216.     right arrow  \316   \428   \444   \316       \316   \428   \444   \316
  217.     down  arrow  \317   \429   \445   \317       \317   \429   \445   \317
  218.  
  219.     HOME CLR     \318   \430   ----   ----       \318   \430   ----   ----
  220.     HELP         \319   \319   \319   \319       \319   \319   \319   \319
  221.     keypad -     \320   \320   \320   \320       \320   \320   \320    \45
  222.     keypad /     \321   \321   \321   \321       \321   \321   \321
  223.     keypad *     \325   \325   \325   \149       \325   \325   \325   ----
  224.     keypad +     \329   \329   \329   \224       \329   \329   \329   ----
  225.     keypad =     \333   \333   \333   \150       \333   \333   \333   ----
  226.     keypad CR     \13    \13    \13    \13        \13    \13    \13    \13
  227.  
  228.     keypad ,     \335   \335   \335   \144       \335   \335   \335   ----
  229.     keypad .     \336   \336   \336   \155       \336   \336   \336   ----
  230.  
  231.     keypad 0     \334   \334   \334   \154       \334   \334   \334   ----
  232.     keypad 1     \330   \330   \330   \147       \330   \330   \330   ----
  233.     keypad 2     \331   \331   \331   \143       \331   \331   \331   ----
  234.     keypad 3     \332   \332   \332   \146       \332   \332   \332   ----
  235.     keypad 4     \326   \326   \326   \225       \326   \326   \326   ----
  236.     keypad 5     \327   \327   \327   \226       \327   \327   \327   ----
  237.     keypad 6     \328   \328   \328   \227       \328   \328   \328   ----
  238.     keypad 7     \322   \322   \322   \152       \322   \322   \322   ----
  239.     keypad 8     \323   \323   \323   \145       \323   \323   \323   ----
  240.     keypad 9     \324   \324   \324   \153       \324   \324   \324   ----
  241.  
  242. The default key assignments are
  243.  
  244.     PC-9801 Key     Scan code  Verb/code   VT100 equivalent
  245.    -------------    ---------  ---------   ----------------
  246.      ESC               \256       \27        ESC
  247.      BS                \270      \127        DEL
  248.      TAB               \271        \9        TAB
  249.      DEL               \313        \8        BS
  250.  
  251.      ROLL UP           \310     \Kupscn
  252.      ROLL DOWN         \311     \Kdnscn
  253.      CTRL + ROLL UP    \438     \Kupone
  254.      CTRL + ROLL DOWN  \439     \Kdnone
  255.  
  256.      STOP              \352     \Kexit
  257.      SHIFT + STOP      \384     \Kbreak      BREAK
  258.  
  259.      COPY              \353     \Kprtscn
  260.      SHIFT + COPY      \385     \Ktrnprs
  261.  
  262.      up    arrow       \314     \Kuparr      up    arrow
  263.      left  arrow       \315     \Klfarr      left  arrow
  264.      right arrow       \316     \Krtarr      right arrow
  265.      down  arrow       \317     \Kdnarr      down  arrow
  266.  
  267.      HOME CLR          \318     \Kpf1        PF1
  268.      HELP              \319     \Kpf2        PF2
  269.      keypad -          \320     \Kpf3        PF3
  270.      keypad /          \321     \Kpf4        PF4
  271.  
  272.      keypad *          \325     \Kkpminus    keypad -
  273.      keypad +          \329     \Kkpcoma     keypad ,
  274.      keypad =          \333     \Kkpenter    keypad ENTER
  275.      keypad ,          \335     \Kkp0        keypad 0
  276.      keypad .          \336     \Kkpdot      keypad .
  277.  
  278.      keypad 0          \334     \Kkp0        keypad 0
  279.      keypad 1          \330     \Kkp1        keypad 1
  280.      keypad 2          \331     \Kkp2        keypad 2
  281.      keypad 3          \332     \Kkp3        keypad 3
  282.      keypad 4          \326     \Kkp4        keypad 4
  283.      keypad 5          \327     \Kkp5        keypad 5
  284.      keypad 6          \328     \Kkp6        keypad 6
  285.      keypad 7          \322     \Kkp7        keypad 7
  286.      keypad 8          \323     \Kkp8        keypad 8
  287.      keypad 9          \324     \Kkp9        keypad 9
  288.  
  289. 3. Network interface
  290.  
  291.   In this program, only supported network interface is Ungermann-Bass
  292. PC-NIU N98.  This interface board is programable, and Ungermann-Bass supplies
  293. two kinds of network protocol software, XNS (Net/One) and TCP/IP. User must
  294. load the appropriate program before using this interface.
  295.  
  296. 3.1 XNS (Net/One)
  297.  
  298.    The loading procedure to use this protocol is
  299.  
  300.    A> NET START urdr <local computer name>
  301.  
  302.    Then start Kermit,
  303.    A> KERMIT
  304.  
  305.    Kermit-MS> SET PORT UB-NETCI
  306.    Kermit-MS> connect
  307.  
  308.    Then you get the prompt
  309.  
  310.    You may now enter Net/One commands
  311.    >>
  312.  
  313.  3.2 TCP/IP
  314.  
  315.    Before using this protocol, you must load the protocol program by typing
  316.  
  317.    A> etws
  318.  
  319.    The Kermit-MS works under the 'tn' program which is supplied by Ungermann-
  320.    Bass.  The procedure is
  321.  
  322.    A> tn -e Kermit
  323.  
  324.    Kermit-MS> SET PORT UB-NETCI
  325.    Kermit-MS> connect
  326.  
  327.    Then you get the prompt
  328.  
  329.    TELNET>
  330.  
  331.    Because that the 'telnet' is the terminal emulation porgram, there are a few
  332.    problems for file transfer.  As a default, 'telnet' has escape sequences to
  333.    hold or disconnect session without logout procedure.  This means that the
  334.    'telnet' always checks incoming characters and causes sending file to be
  335.    extreamly slow. (On the other hand, receiving file is fast because of no
  336.    checking for receiving characters.)  It is possible to set the 'telnet' in
  337.    transparent mode,
  338.  
  339.    TELNET> set binary on                  .
  340.  
  341.    After setting this mode, the speed of the send-file is almost the same as
  342.    that of the receive-file.
  343.    However, this is very dangerous.  After that, you cannot control the session
  344.    from the PC side.
  345.  
  346.    For these reasons, it is strongly recomended to use the FTP program for
  347.    file transfer.
  348.  
  349.  
  350. 4. Kana-Kanji display
  351.  
  352.    Kana-Kanji is the Japanese character set. The characters are mapped to
  353. 2-byte codes.  Officially, these codes and the procedure to interchange
  354. the codes are defined in the following Japanese Industrial Standards (JIS);
  355.  
  356.    JIS X 0208:
  357.      Code of the Japanese Graphic Character Set
  358.      for Information Intercahnge
  359.  
  360.    JIS X 0202:
  361.      Code Extension Techniques for Use with the Code
  362.      for Information Interchange .
  363.  
  364.  
  365. Unfortunatly, these standards are NOT widly used.  Many computers use their
  366. original procedures to handle X 0208 character set not only for internal code
  367. but also for comunications.  MS-DOS machine uses so called 'Shift-JIS' code
  368. (the name is not appropriate because Shift-JIS is not JIS).  Therefore, this
  369. program has Kanji-code parameter as terminal set-up parameters.
  370.  
  371. 4-1.JIS and DEC Kanji
  372.  
  373.   This VT102 is programmed as a JIS Kanji terminal. This terminal has the
  374. following graphic sets:
  375.     o JIS roman graphics
  376.     o JIS katakana graphics
  377.     o JIS X 0208 2-byte Kanji graphics
  378.     o DEC special graphic
  379. In general, to display the code in some graphic set, you must "designate"
  380. the graphic set as one of G0, G1, G2 or G3.  Then you must "invoke" one of
  381. the G0 through G3 into GL or GR.  To display the GR character set,
  382. you must send the code with 8th bit on.
  383.   As a default setting, the character sets are assigned as follows;
  384.  
  385.        GL <- G0 <- JIS roman (X 0201)
  386.              G1 <- DEC special graphics
  387.              G2 <- JIS katakana (X 0201)
  388.        GR <- G3 <- JIS kanji (X 0208)     .
  389.  
  390. A SO code (0/14) invokes G1 character set to GL. Therefore, after receiving
  391. SO code, terminal displayes DEC special graphics for D0 characters (2/0 -
  392. 7/E) in this case. The 2-byte Kanji-code can be displayed by sending the
  393. JIS X 0208 code with 8th bit on (i.e., DEC Kanji code) because it is assigned
  394. to GR character set.
  395.  
  396. 4-2. Invocation and designation of the graphic set
  397.  
  398.   The following escape sequences and C0 characters can be used to invoke
  399. or to designate the graphic set:
  400.  
  401.   To designate the single byte graphic set:
  402.     ESC 02/08 F or ESC 02/12 F  designates the graphic set to G0
  403.     ESC 02/09 F or ESC 02/13 F  designates the graphic set to G1
  404.     ESC 02/10 F or ESC 02/14 F  designates the graphic set to G2
  405.     ESC 02/11 F or ESC 02/15 F  designates the graphic set to G3
  406.  
  407.     where
  408.       F is 04/10   for JIS roman
  409.            03/00   for DEC special graphics
  410.            04/09   for JIS katakana
  411.       any other code in the range 03/00 to 07/14 designates the JIS roman
  412.       graphics.
  413.  
  414.   To designate the multi-byte graphic set:
  415.     ESC 02/04 02/12 F or ESC 02/04 F         designates to G0
  416.     ESC 02/04 02/13 F or ESC 02/04 02/09 F   designates to G1
  417.     ESC 02/04 02/14 F or ESC 02/04 02/10 F   designates to G2
  418.     ESC 02/04 02/15 F or ESC 02/04 02/11 F   designates to G3
  419.  
  420.     where
  421.       F is 04/02   for JIS kanji (X 0208)
  422.     any other code in the range 03/00 to 07/14 designates the JIS X 0208
  423.  
  424.   To invoke the graphic set:
  425.     SI (00/15)  invokes the G0 to GL
  426.     SO (00/14)  invokes the G1 to GL
  427.     ESC 07/14   invokes the G1 to GR
  428.     ESC 06/14   invokes the G2 to GL
  429.     ESC 07/13   invokes the G2 to GR
  430.     ESC 06/15   invokes the G3 to GL
  431.     ESC 07/12   invokes the G3 to GR
  432.  
  433. Therefore, the default setting is equivalent to the following escape sequences;
  434.  
  435.    ESC 02/08 04/10
  436.    ESC 02/09 03/00
  437.    ESC 02/10 04/09
  438.    ESC 02/04 02/15 04/02
  439.    SI
  440.    ESC 07/12
  441.  
  442. 4-3. Shift-JIS
  443.  
  444.   Shift-JIS is not an industrial standard, but widly used on many Japanese
  445. MS-DOS machines.
  446.  
  447.  
  448. 5. Sending Kana-Kanji codes
  449.  
  450.   This program is designed to be able to send Kana-Kanji characters in the
  451. following codes;
  452.  
  453.     - DEC code (almost equivalent to Extended Unix Code)
  454.     - JIS code in 7-bit environment
  455.     - Shift-JIS code.
  456.  
  457. To select the code system,
  458.  
  459.     Kermit-MS>set terminal kanji-code <code specification>
  460.