home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 3 Comm / 03-Comm.zip / XKOKER.ZIP / CKOPM.DOC < prev    next >
Text File  |  1990-04-18  |  12KB  |  225 lines
  1. Suppliment to the OS/2 Kermit manual.
  2.  
  3.  
  4. C-Kermit for the OS/2 Presentation Manager
  5.  
  6. Files
  7.  
  8.     The latest version of C-kermit for PM consists of two files. The
  9. Kermit executable and a .DLL file.  The .DLL file is not a dynamic
  10. link library as the extension might suggest.  Rather it is a font
  11. file.  This file sould be placed in a place referenced by the
  12. config.sys "libpath" parameter.  The executable should be place
  13. somewhere in "PATH", or added to the program list.
  14.     Due to an idiosyncracy in the PM font loading procedure "libpath"
  15. is only used to search for the font file if no pathname and extension
  16. are supplied.  In this case the supplied extension is .DLL, not .FON
  17. as would seem sensible. Using a .FON extension causes the font not to
  18. be loaded.
  19.     The .DLL file contains a custom font used in displaying Tektronix
  20. graphics text.  It is much smaller than the usual system font to make
  21. it legible even when a smaller than full screen window is used.  The
  22. normal sized system font characters tend to overlap.  The Tektronix
  23. font was designed to be legible on a VGA screen, the spacings etc.
  24. still may not be correct on lower resolution devices.  (Anyone caring
  25. to submit a font for use with lower resolution devices should send
  26. the .FNT file to <ARMSTRONG@E11.PHY.BNL.GOV> - if anyone knows how to
  27. make a vector font file please let me know).  A vector font is not
  28. used as character drawing is EXTREMELY slow and to date I have not
  29. managed to plot to a PM window from a non-queue thread (if anyone
  30. knows how.....).
  31.     Since the original "kernel" mode OS/2 Kermit a number of new
  32. features have been added to the generic C-Kermit.  These include
  33. macros and a take file command language similar to that of MS-DOS
  34. Kermit.  These features will not be described in this suppliment.
  35.     Some new commands specific to OS/2 Kermit are the "SET TERMINAL
  36. TYPE" command and a number of "SET FLOW" commands. The syntax for
  37. these is shown below.
  38.  
  39.  
  40.                         New Commands
  41.         
  42.         SET TERMINAL TYPE    VT100   - VT100 emulation
  43.                              TEK4014 - Tektronix emulation
  44.         
  45.         SET FLOW ODSR ON             - Turn output DSR handshake ON 
  46.                       OFF            - Turn output DSR handshake OFF
  47.         SET FLOW IDSR ON             - Turn input DSR handshake ON
  48.                       OFF            - Turn input DSR handshake OFF
  49.         SET FLOW OCTS ON             - Turn output CTS handshake ON
  50.                       OFF            - Turn output CTS handshake OFF
  51.         (These commands correspond to the MODE ODSR, IDSR and OCTS
  52.         options)
  53.         
  54. A number of commands have been implimented as menu items.  At present
  55. there are more menu items displayed than implimented.  The
  56. "Terminal.." and "Communications..." menu items are implimented.  All
  57. of the "Log" menu items are implimented and the "Copy", "Paste",
  58. "Append" and "Copy and Paste" items in the "Edit" menu are
  59. implimented.
  60.  
  61. "Terminal..."
  62.  
  63. This displays a dialog which allows various terminal emulation
  64. characteristics to be modified.  This can be done at any time, i.e.
  65. in "Command line" mode, during "Connect" mode or during file
  66. transfer. Non of the terminal dialog parameters should affect file
  67. transfer.  The "Tektronix plot file format" refers to a dump file
  68. which is made while receiveing Tektronix graphics commands.  At
  69. present only the HPGL format is supported.  The dump file can be sent
  70. to a printer using the Shift-PrintScreen key combination.  This
  71. simply spawns a "PRINT" command, so it'll only do what "PRINT" does
  72. at the command line.  This happens to work for me, with 1.2 S.E., and
  73. an HP Laserjet with Plotter-in-a-Cartridge.  Tektronix output can be
  74. produced by logging the terminal session, editting out the garbage
  75. and printing the session log.  Selecting the WordPerfect or Tektronix
  76. file format will prevent the dump file from being made.
  77.  
  78. "Communications..."
  79.  
  80. This displays a dialog which allows various communications line
  81. parameters to be modified.  This can be done at any time, i.e.
  82. in "Command line" mode, during "Connect" mode or during file
  83. transfer.  
  84. ***** NOTE this will affect file transfer at present so must be *****
  85. ***** used with caution.                                        *****
  86.  
  87. The "Flow Control" options refer to the standard C-Kermit flow
  88. control options.  The ODSR, IDSR and OCTS options are referred to as
  89. "Handshake" as this is how the OS/2 manual refers to them.
  90.  
  91. "Log"
  92.  
  93. The "Log" menu items are fairly obvious.  I've no idea whether there
  94. is a convention for the various log extensions.  The ones shown are
  95. the ones I use.  Eventually there will be a listbox in the log dialog
  96. which will show files with the extensions shown - with the option to
  97. change it.  I will be using a similar dialog to run "Take files"
  98. eventually, these will have the default extension ".KER".
  99.     
  100. "Remote" and "Transfer" not implimented yet.
  101.  
  102. "Edit"
  103.  
  104. An area of the text screen i.e. the command line/VT100 window can be
  105. selected by positioning the mouse over the start of the region,
  106. pressing button 1 (usually the left button) and moving the mouse
  107. cursor to the end of the block.  The selected region will be
  108. highlighted.  Only the visible region can be selected.  The selected
  109. region can then be copied to the "clipboard" by selecting one of the
  110. "Edit" menu items.  Text in the clipboard can be transferred into
  111. Kermit by selecting the "Paste" item.  The function of the "Edit"
  112. copy items are;
  113.     "Copy"   Clears any text present in the clipboard and copies
  114.              the selected region into the clipboard.
  115.     "Append" Does not delete text already in the clipboard.  The
  116.              selected region is copied into the clipboard after any
  117.              text already present.
  118.     "Paste"  Enters any text in the clipboard into Kermit as if it
  119.              had been entered from the keyboard.  Carriage returns
  120.              are sent but not linefeeds (these cause problems with
  121.              Vax VMS editors!).  At low line speeds pasteing large
  122.              block of text can cause the error message "Keyboard
  123.              buffer not being emptied" to be displayed - at which
  124.              point the keyboard buffer starts to empty.  This is
  125.              because of a bug in the way the semaphore system works,
  126.              I think.  Anyway text does not seem to be lost.
  127.              NOTE There is no attempt made to truncate lines, at
  128.              present. Lines longer than 80 can lead to problems with
  129.              certain operating systems.  If pasting from the 1.2
  130.              System Editor ensure that the WordWrap mode was OFF
  131.              before  copying.  In WordWrap mode the System Editor
  132.              does not insert CRs or LFs at what appear to be the end
  133.              of lines.  This has caused me many problems.  It is not
  134.              a bug in the Kermit routines.
  135.     "Copy and Paste" 
  136.              Performs a "Copy" immediately followed by a "Paste"
  137.              
  138.     "Print graphics"
  139.              In theory this should use the PM device independant
  140.              mechanism for printing, i.e. using whatever printer is
  141.              defined for the default spooler.  With my system alot of
  142.              disc activity takes place and the print job appears in
  143.              the Print Manager queue, however it never gets printed
  144.              out.  I don't know why.  All the things described in the
  145.              reference manual are done, and do not return errors, but
  146.              still the job wont print.  With my system this is not
  147.              just a problem specific to kermit.  Trying to print from
  148.              the help screens generally causes the Print Manager to
  149.              crash and vanish - it can only be restarted by restarting
  150.              the system.  The Kermit symptoms are not as severe.  If
  151.              anyone tries this option and it works PLEASE let me
  152.              know!!
  153.              
  154.     "Meta graphics"
  155.              In theory this should produce a disk metafile of the
  156.              Tektronix screen, suitable for reading into the PIC
  157.              programs supplied with 1.2 S.E.  However this routine
  158.              fails at the first hurdle, i.e. it fails to open the
  159.              metafile device context.  Since the PIC programs seem to
  160.              crash when they are asked to do anything I suspect that
  161.              the metafile system is still not ready for use!
  162.              
  163.              
  164. Miscellaneous
  165.  
  166.     Undocumented features....
  167.         The marking system sometimes leaves highlighted sections
  168.         floating around.
  169.         No official means of aborting transfer, or a hung connection.
  170.         A hung connection can be broken by selecting the
  171.         "Communications..." menu item and clicking on "Enter" having
  172.         selected a different port.  This closes the current port and
  173.         tries to connect to the new port.
  174.         
  175.         DO NOT USE the "!" command to invoke the OS/2 1.2 command
  176.         interpreter i.e "! CMD".  This causes a horrible bleeping
  177.         sound which does not go away until the system is rebooted.
  178.         Using the "!" command seems to work okay for other kernel
  179.         mode commands e.g. "! dir", "! mode" etc..  I've no idea why
  180.         this happens.  If anyone out there is still running v1.1
  181.         perhaps they could see if it happens for them too.
  182.         
  183.     Special keys.
  184.         The VT100 keypad is emulated by the PC numeric keypad as one
  185.         might expect.  The exceptions to this are PF1 and VT100
  186.         comma.  There is no equivalent to the comma and PF1 would be
  187.         the NumLock key.  I have experimented with using the NumLock
  188.         key but have found no way of controlling the NumLock state
  189.         from with in PM.  It is possible in kernel mode to turn
  190.         NumLock on and off (as shown by the NumLock light).  The
  191.         closest to success under PM is to do it once, thereafter
  192.         keyboard input to ALL PM programs is disabled!  So PF1 maps
  193.         to F2 and comma to F3.  F1 is used for help.  It doesn't even
  194.         generate a normal PM character press message.
  195.             
  196.             VT100 numeric keypad            PC Key
  197.             PF1                             F2
  198.             PF2                             Keypad /
  199.             PF3                             Keypad *
  200.             PF4                             Keypad -
  201.               1                             1
  202.               2                             2
  203.               3                             3
  204.               4                             4
  205.               5                             5 
  206.               6                             6
  207.               7                             7
  208.               8                             8
  209.               9                             9
  210.               0                             0
  211.               -                             Keypad +
  212.               ,                             F3
  213.               .                             Keypad .
  214.               Enter                         Enter
  215.               
  216.         With NumLock ON the numric keys generate the numeric
  217.         characters displayed on them.
  218.         
  219.         Shift-PrintScreen  Send the Tektronix dump file to the
  220.                            printer.
  221.         PrintScreen        Send a dump of the VT100 screen to the
  222.                            printer.
  223.                            
  224. Chris Armstrong 16-Apr-90
  225.