home *** CD-ROM | disk | FTP | other *** search
/ Loadstar 128 #27 / q27.d81 / ................ next >
Encoding:
Text File  |  1991-01-01  |  15.8 KB  |  421 lines

  1.  
  2.  
  3.  Modules
  4.  -------
  5.  
  6.     DT128 has specialized functions that are not part of the main program.
  7. The features are called modules.  Modules are loaded from the DT128 system
  8. disk.  If you select a module that is not in memory you will be asked to
  9. insert your system disk and press RETURN.  If you decide not to load the
  10. module you can abort by pressing ESCape.
  11.  
  12. **  System modules are version specific.  Each module name ends with the
  13. version they work with.  Do not try to rename modules to get them to work
  14. with future versions of DT128 - they won't work.
  15.  
  16.  
  17.  Block Availability Map (BAM) Editor
  18.  -----------------------------------
  19.  
  20. Disk Directory:
  21.  
  22.     Shows the directory of the default device and drive.
  23.  
  24. Device/Drive:
  25.  
  26.     Selects the device and drive to be used.  This setting uses the system
  27. device and drive (changing this is the same as changing the device and
  28. drive in the disk functions menu).
  29.  
  30. Edit BAM:
  31.  
  32.     This function allows you to edit the BAM (block availability map) of a
  33. disk.  Used sectors will be represented by "+" plus symbols.  Follow the
  34. prompts given.  To allocate a sector use the cursor keys to position the
  35. cursor on the desired sector and type a plus.  To free a sector do the same
  36. except type a space.  When you are sure you've made the proper changes you
  37. must re-write the BAM in order for the changes to be recorded on disk.
  38. Press a capital "W" to write the new BAM to disk.  To exit without updating
  39. the BAM press the escape key.
  40.  
  41.  Notes:
  42.  
  43.     You can edit the BAM of a subdirectory.  You must first select the
  44. subdirectory and then select the "Edit BAM" option.  You can select a
  45. subdirectory by selecting the directory option.  When the directory prompt
  46. appears type an "*" on the line and press return.  This gives you the DOS
  47. command line.  Here you can select the subdirectory you want, i.e.
  48. "/subdirectory".  This applies to only the 1581.  Note, however, that if
  49. you re-write the BAM of a subdirectory you will be taken back to the root
  50. directory.
  51.  
  52.  
  53.  Calculator
  54.  ----------
  55.  
  56.     This module has 2 functions.  The main function is as a calculator
  57. which can be accessed in 3 different ways.  The first is through the main
  58. menu.  The second is in the buffer editor with the "F1-6" command (see
  59. BUFFER).  The third way to access the calculator is from within terminal
  60. mode with the long ALT-C command in 80 column screens (see TERM MODE).  The
  61. second function this module provides is for calculating upload transfer
  62. times.
  63.  
  64. The Calculator:
  65.  
  66. The calculator works very similar to the way BASIC direct mode works.  If
  67. you wanted to multiply 41 by 16, you would enter the following:
  68.  
  69. print41*6 <return>
  70.  
  71. The calculator works with the same syntax except that you do not need to
  72. enter "print" each time as it is implied.  All of the BASIC math operators
  73. are supported including, "+-*/^<=>()" as well as the following basic
  74. functions:
  75.  
  76. INT ABS SQR LOG EXP COS SIN TAN ATN AND OR
  77.  
  78. (Although calculation results may be in scientific notation you may not
  79. enter numbers in this format)
  80.  
  81. Any errors that occur in a calculation are displayed.  No variables are
  82. allowed at any time.
  83.  
  84. The following commands are available for input:
  85.  
  86.  ESCape - aborts calculator
  87.  RETURN - evaluates current expression
  88.  DELete - deletes 1 character to the left
  89.  CRSR or ARROW right/left move the solid block cursor left or right
  90.  HOME - moves cursor back to the beginning of the input line
  91.  CLR - clears the input line
  92.  " - recalls the previous input line
  93.  # - recalls the previous result
  94.  
  95. You can perform calculations while online.  Try this.  Load the calculator
  96. from the main menu, then call a computer system.  While receiving a stream
  97. of characters (perhaps a message thread) enter the calculator in terminal
  98. mode with the long ALT-C command (you must be in 80 columns).  While typing
  99. in a calculation you will discover that the terminal screen doesn't
  100. "freeze!" Amazing...
  101.  
  102.  Transfer Delays
  103.  ---------------
  104.  
  105.     This function allows you to customize the calculation for upload
  106. transfer times.  When this module or the remote module is in memory a
  107. "delay time per transfer block" is automatically added to the upload
  108. transfer time calculation. When you enter the calculator from the main menu
  109. you will see a table of values that represent the amount of time, in
  110. hundredths of a second, to be added for each transfer block.  Each protocol
  111. has its own delay factor for both disk and buffer transfers.
  112.  
  113.     When Ymodem Batch or Multi-Punter is used this module will total the
  114. transfer blocks, disk blocks (only if the terminal type is C/G), and the
  115. transfer time. The totals are displayed only if the send prompt option in
  116. the upload menu is "Yes" or you are in remote mode and a caller is
  117. downloading from you.
  118.  
  119.  
  120. Configuration
  121. -------------
  122.  
  123. This module is entered from the "Display Parameters" menu.
  124.  
  125. Main Character:
  126.  
  127.      Selects the character color for menu screens.
  128.  
  129. Background:
  130.  
  131.      Selects the background color for menu screens.
  132.  
  133. Reverse:
  134.  
  135.      This option reverses the character and background colors for each
  136. character on menu screens.  By setting this option to "Yes" you can create
  137. a border.
  138.  
  139. Clock:
  140.  
  141.      Selects the clock color.
  142.  
  143. Highlight:
  144.  
  145.      Selects the color for the highlight bar and menu header lines.
  146.  
  147. Cursor Form:
  148.  
  149.      Selects the cursor type that you prefer, block or underline, flash or
  150. steady, fast flash or slow flash.
  151.  
  152. Semi-Graphic Mode:
  153.  
  154.      For normal text display this option should be set to "No."  If "Yes"
  155. screens will be displayed in "Semi-Graphic" mode, creating a digital 3-D
  156. character effect.  The display will only enter this mode if the terminal
  157. screen width is 80 columns.
  158.  
  159. 40 Horiz:
  160.  
  161.      Use this setting to align the terminal screen horizontally for 40
  162. column mode.  A value of 55 usually works well with RGB monitors such as
  163. the 1084, while 53 works well with the 1802 in monochrome mode.
  164.  
  165. Monochrome Mode
  166.  
  167.      If you have a color monitor this should be set to "No".  When this
  168. option is set to "Yes" color changes in terminal mode are ignored.  This is
  169. useful if you have a monochrome monitor.
  170.  
  171. Ansi Background:
  172.  
  173.      "No"  means that Ansi escape sequences which change the background
  174.            color of characters will be ignored.
  175.      "Yes" means that Ansi escape sequences which change the background
  176.            color of characters will be interpreted.
  177.  
  178.      Since the VDC does not support independent background colors for each
  179. character position Ansi background color changes cannot be interpreted
  180. correctly.  Instead of changing the background color for individual
  181. characters the background color of the entire terminal screen will be
  182. changed.  This can cause the background color to flicker annoyingly if many
  183. background color changes are made in succession.  Because of this you will
  184. usually want to set this option to "No".  Occasionally an Ansi system may
  185. change the character color to the same color as the background color that
  186. you are using (usually black) while changing the background color.  For
  187. example, a system may change the color to black characters on a blue
  188. background.  Because you are ignoring the background color change, the text
  189. will be "invisible" (black text on a black background).
  190.  
  191.     If this happens you can press ALT-N to change the character color, or
  192. you can set this to "Yes" to avoid this problem (it's a tradeoff between
  193. this and flickering).  For an Ansi Terminal that can handle color correctly
  194. see VANSI (on LS 128 #28).
  195.  
  196. Absorb Escape Strings:
  197.  
  198.      When "No" unrecognized escape strings (VT-52, VT-100, DataMedia 1500,
  199.          Proterm, and Ansi) are printed on the screen.
  200.  
  201.      When "Yes" unrecognized escape strings are not displayed.
  202.  
  203. Logon Delay
  204.  
  205.      This is the speed at which characters are sent to the modem from logon
  206. macros.  A zero value is full speed, while a value of 255 is the slowest.
  207. A value of around 128 gives good results.
  208.  
  209. Disable Call Waiting String:
  210.  
  211.      Type in the string you need to defeat call waiting.  This number will
  212. automatically be dialed whenever you dial a number from the phone directory
  213. with the cancel call waiting option on (see PHONE DIRECTORY on LS 128
  214. #26).
  215.  
  216. Character Height:
  217.  
  218.      Can be "Tall" or "Short".
  219.  
  220. Attribute Flash Rate:
  221.  
  222.      This determines the flashing rate of flashing characters.  It can be
  223. fast or slow.
  224.  
  225. Create Configuration File:
  226.  
  227.      This option will create a configuration file named 'usr2.0'  This
  228. file, if it exists, will automatically load when you boot the main program.
  229. Many system settings and strings are saved.  If the default settings are
  230. not to your liking, or if the system must have some settings changed in
  231. order to work with your system, change the settings and select this
  232. option.
  233.  
  234. Next Page:
  235.  
  236.      Select this to see the default remote settings.
  237.  
  238. Command/Access:
  239.  
  240.      Shows the minimum access level required to use each remote command
  241. from a remote (the sysop can access all commands regardless of these
  242. settings).
  243.  
  244. VDC Memory:
  245.  
  246.      Selects 16k or 64k.  Do not select 64k unless you have the 64k
  247. version.
  248.  
  249. Modules in Subdirectory:
  250.  
  251.      If this option is set to Yes, DT128 will expect to find system modules
  252. in the subdirectory "modules".
  253.  
  254.  
  255.  Fast Disk I/O
  256.  -------------
  257.  
  258.     This module is for 1541 users and is accessed from the buffer menu.  It
  259. allows you to load, append to, and save the capture buffer using high speed
  260. DOS routines which are must faster than the normal DOS speed.  If you
  261. attempt to access a device other than a 1541 you will get a "Device not
  262. present" error.
  263.  
  264. Disk Directory:
  265.  
  266.     Shows the directory of the device used by this utility.
  267.  
  268. Load Buffer:
  269.  
  270.     You are prompted to enter a file name.  If the file exists the buffer
  271. is cleared and then the file is loaded at high speed.
  272.  
  273. Append to Buffer:
  274.  
  275.     You are prompted to enter a file name.  If the file exists the file is
  276. added to the contents of the buffer.
  277.  
  278. Save Buffer:
  279.  
  280.     You are prompted for a file name.  Be sure to enter valid file names
  281. only (no asterisks, commas, or question marks).  Before the buffer is saved
  282. this option checks to make sure that there is enough room on the disk.  If
  283. not, you will get an error message and you must place another disk in the
  284. drive to continue, or press escape to abort.
  285.  
  286. Device:
  287.  
  288.     This is the device accessed by this module.
  289.  
  290. Save Skew:
  291.  
  292.     The save skew is directly related to the speed at which data is
  293. transfer between the computer and device.  The normal skew rate for a 1541
  294. is 10.  This results in the shortest load time.  Because the data transfer
  295. rate of the high speed DOS routines in this module are much faster than the
  296. normal DOS, the skew can be lowered to maximize efficiency to produce the
  297. shortest possible access time.  The save skew can be any value from 1 to
  298. 16.  The lowest recommended skew value is 6 or 7, the highest value 10 for
  299. these routines.  You should use a value of 10 for any file that you may
  300. need to load at normal speed later or the load time may increase
  301. significantly.
  302.  
  303.  Notes:
  304.  
  305. Do not use any device/drive overrides in file names.
  306.  
  307. Do not use wild cards or commas in save file names.
  308.  
  309.  
  310.  ML File Editor
  311.  --------------
  312.  
  313. This utility is a machine language file editor.  It allows you to modify a
  314. file on disk, similar to a disk editor, but with extra features.  To use
  315. the editor select the "Edit File" option in the "Special Disk Functions"
  316. menu.  Enter a file name, or press ESCape to abort.  The disk directory is
  317. then searched.  If the file is found the screen will change to show a
  318. sector map that shows all of the sectors used by the file.  Once the map
  319. has been plotted the following commands are available:
  320.  
  321.      Arrow/Crsr Down - Move towards beginning of file
  322.      Arrow/Crsr Up   - Move towards end of file
  323.      SPACE/RETURN    - Selects current sector for edit mode
  324.      ESCape          - Exits
  325.  
  326. When you select a sector you enter edit mode.  The sector is read from disk
  327. and a disassembled listing appears.  All numbers are hexadecimal values.
  328. Commands available in edit mode are:
  329.  
  330.      Arrow/Crsr Down  - move cursor down 1 line
  331.      Arrow/Crsr Up    - move cursor up 1 line
  332.      Arrow/Crsr Right - move cursor down 8 lines
  333.      Arrow/Crsr Left  - move cursor up 8 lines
  334.      SPACE            - allows you to change the byte value(s) on the
  335.                         current line.  Enter hexadecimal values only (do
  336.                         not enter $ as hex values are assumed).
  337.      RETURN           - enters assembly mode which operates the same as
  338.                         the monitor.  Press ESCape or press RETURN on a
  339.                         blank input line to exit assemble mode (exits
  340.                         automatically on last line).
  341.      W                - Shift-W can be used to re-write the current
  342.                         sector(s) (See below)
  343.      ESCape           - exits
  344.  
  345.     The disassembled code represents the current sector only.  The only
  346. bytes displayed are "data" bytes.  Track links are not displayed and are
  347. not editable.  Also, the first 2 data bytes of the first sector are used as
  348. a load address by the DOS.  These bytes too are not editable.  At the upper
  349. right of the screen you will see a constant readout that indicates the
  350. address of the first data byte for the current sector.  For the last sector
  351. of a file you will see a flashing address.  This is the address of the last
  352. byte of the file.  Bytes following this address can be ignored.  This
  353. editor does handle machine language codes which span from the current
  354. sector to the next.  For example, if the last byte of the current sector is
  355. the opcode for a "jump" command, the 2 address bytes for the jump are the
  356. first 2 data bytes of the next sector.  You can freely edit the last
  357. command in the window.  If you modify either of the 2 bytes that are
  358. actually in the next sector that sector will also be rewritten with the
  359. modifications.  This generally operates in the background so you don't have
  360. to think about it.  It works.
  361.  
  362.     If any disk errors should occur you should abort the edit and re-read
  363. the current sector.
  364.  
  365. Notes: This module supports the 1541, 1571, and 1581 disk drives.
  366.  
  367. Partitions and sub-directories are not presently supported.
  368.  
  369.  
  370.  Joystick Module
  371.  ---------------
  372.  
  373.     This module allows you to use a joystick throughout the program.  The
  374. four main directions of the joystick are translated to the four cursor
  375. movements while the fire button is a RETURN.
  376.  
  377.     This module also can be used when playing online games.  When you call
  378. someone who is using DT128 you can use your joystick instead of the key
  379. commands for the game.  Be sure you set the joystick type to the game you
  380. are going to play.
  381.  
  382.  
  383.  Scroll Back
  384.  -----------
  385.  
  386.     This module extends the 25 row terminal screen into a 425 row screen.
  387. To use this module select "Scroll Back" from the Miscellaneous Menu.  To
  388. use the module press Alt-V from terminal mode.  The module will become
  389. active under the following conditions:
  390.  
  391.     1). you are NOT in C/G mode
  392.     2). the buffer is closed
  393.     3). the buffer is empty
  394.  
  395. If the above conditions are satisfied the module becomes active.  While the
  396. module is active you will see a "B" indicator immediately to the right of
  397. the bytes free display.  While the module is active there are 2 keys that
  398. become active.  The CRSR Down key scrolls the screen "backward" 1 line each
  399. time it is pressed allowing you to review the previous screen contents.
  400. The CRSR Right key scrolls the screen forward.  After you have pressed CRSR
  401. Down to go back the terminal "freezes" until you have pressed CRSR Right
  402. until you have returned to the current screen.  This means you should not
  403. scroll back unless you are certain that the remote will not be transmitting
  404. data to you or you risk a receive buffer overrun.
  405.  
  406. The module is disabled in several ways:
  407.  
  408.     1). You press Alt-V
  409.     2). You open the buffer
  410.     3). You load a file into the buffer
  411.     4). You enter a character in the buffer editor
  412.     5). You switch to C/G term emulation
  413.     6). You select another module
  414.  
  415. This module has a second function.  After you have used this module you may
  416. wish to save the text that was contained in the screens that have been
  417. saved. Select "Convert Buffer" from the module's menu.
  418.  
  419. Notes:  This module uses the entire capture buffer.
  420.  
  421.