home *** CD-ROM | disk | FTP | other *** search
/ Piper's Pit BBS/FTP: ibm 0010 - 0019 / ibm0010-0019 / ibm0010.tar / ibm0010 / MAGICM20.ZIP / MAGICM20.TD0 / READ_ME.1ST < prev    next >
Encoding:
Text File  |  1990-04-03  |  13.8 KB  |  324 lines
  1.  
  2.                     Magic Mirror Upgrade Information
  3.                         for Software Version 2.0
  4.                     --------------------------------
  5.  
  6. The following information describes changes and additions to the Magic
  7. Mirror manual and software version 2.0 which are not contained in the
  8. documentation, due to printing production schedules, late changes, etc. 
  9. Should you have any difficulties with these instructions, or if you have
  10. technical questions of any type, please call our Technical Service
  11. Department.  They may be reached Monday through Friday, 9AM to 5:30PM
  12. EST at (603) 644-5555.
  13.  
  14. Installing and Starting the Magic Mirror Upgrade
  15. ------------------------------------------------
  16.  
  17. The first step in using the Magic Mirror upgrade is to INSTALL the
  18. programs onto your diskette or hard disk.  You should install the new
  19. programs into the directory you were using for your existing Magic
  20. Mirror programs.  For example, if your programs are currently installed
  21. in the \MM directory on drive C, 
  22.  
  23. 1)   Place the upgrade diskette in drive A.
  24.  
  25. 2)   Make drive A the current drive by typing:
  26.  
  27.           A:
  28.  
  29.      and pressing the <Enter> key.
  30.  
  31. 3)   Type:
  32.  
  33.           INSTALL  A:  C:\MM
  34.  
  35.      and press the <Enter> key.
  36.  
  37. For further information on installation, please refer to the
  38. Installation section of the Magic Mirror manual.
  39.  
  40. Starting Magic Mirror
  41. ---------------------
  42. The easiest way to start the Magic Mirror program is to change the
  43. current directory (CHDIR or CD) to the one in which it is installed. 
  44. For example, if Magic Mirror is installed in the \MM directory on drive
  45. C, type the following commands:
  46.  
  47.      C: <Enter>
  48.      CD \MM <Enter>
  49.      MM <Enter>
  50.  
  51. Magic Mirror is now running.  For more information, refer to the manual
  52. and to the upgrade information which follows.
  53. Memory Use
  54. ----------
  55.  
  56. Magic Mirror can be used on any system with at least 128K of RAM.  Magic
  57. Mirror itself consumes from 25K to 65K of lower RAM based on two
  58. factors:
  59.  
  60.      1)   If Expanded RAM is used
  61.      2)   If context-sensitive help is enabled
  62.  
  63. In the default configuration, Magic Mirror is set to use Expanded RAM if
  64. it is available, and On-line Help is enabled.  In this configuration,
  65. Magic Mirror uses 37K.  The following chart lists the different
  66. available configurations for Magic Mirror, and the RAM used for each
  67. configuration.
  68.  
  69. Using 
  70. Expanded          Help               Lower          Expanded
  71. RAM               enabled          RAM Use          RAM Use
  72.  
  73. Yes               Yes               37K               48K
  74. Yes               No                25K               48K
  75. No                Yes               65K               zeroK
  76. No                No                53K               zeroK
  77.  
  78. Magic Mirror can use Expanded RAM which conforms to the
  79. Lotus/Intel/Microsoft Expanded Memory Specification (EMS) version 3.2 or
  80. greater.  This type of RAM can be assigned for use by Magic Mirror to
  81. minimize the amount of lower RAM (640K) used.
  82.  
  83. Magic Mirror can use Extended RAM for Image Buffer overflow only.  See
  84. para. 6.11 in the Operating Instructions for more information on
  85. Extended RAM use.
  86.  
  87. Using Magic Mirror's On-line, Context-sensitive Help
  88. ----------------------------------------------------
  89.  
  90. Magic Mirror version 2 is equipped with on-line, context-sensitive help. 
  91. Additional information is always available about the particular function
  92. you are performing. Simply press the <F1> key at any point within Magic
  93. Mirror, and a screen of information pops up to explain the current
  94. function you are using, or the current menu option which is highlighted.
  95.  
  96. The Help features uses 12K of memory.  If you wish to conserve RAM you
  97. may disable help.  Type HELP OFF before starting Magic Mirror.  The HELP
  98. OFF and HELP ON commands are described in described in step (7) below.
  99.  
  100. To use Help:
  101.  
  102. 1)   Magic Mirror must be loaded into RAM (using the MM command) and
  103.      invoked by pressing one of its Hot Key combinations (<Alt-M> for
  104.      the Main menu, <Alt-C> for the Capture Pattern menu. or <Alt-I> for
  105.      the Image Control menu). 
  106.  
  107. 2)   Press <F1> at any point within Magic Mirror.  Information displays
  108.      about the function you are using, or the current menu item which is
  109.      highlighted.
  110.  
  111. 3)   Each Help topic consists of one or more pages of information.  If
  112.      more than one page is supplied for a selected topic,  "Next Page"
  113.      displays at the bottom of the Help screen. To view the next page,
  114.      use the arrow keys to highlight "Next Page" and press <Enter>, or
  115.      press the <Pg Dn> key.
  116.  
  117. 4)   There are three ways to back up through the screens within Help:
  118.  
  119.      A)   If you have viewed more than one page, press the <Pg Up> key
  120.           to move back a page.
  121.  
  122.      B)   If you have viewed more than one topic, press the <Backspace>
  123.           key to go back to the beginning of a previous topic.
  124.  
  125.      C)   Press the <Esc> key to quit Help and return to where you were
  126.           in Magic Mirror. 
  127.  
  128. 5)   Embedded and Related topics provide access to supplemental or
  129.      related information from within some Help screens.
  130.  
  131.      ---  Embedded topics are shown in bold type within the text of a
  132.           Help screen. For information on an embedded topic, use the
  133.           arrow keys to highlight the topic and press <Enter>.
  134.  
  135.      ---  Related topics are listed in the box at the bottom of some
  136.           Help screens.  If there are two lines of topics in the box at
  137.           the bottom of the Help screen, the first line lists the
  138.           related topic(s).  (The second line lists the Help Index
  139.           option and the End Help option.)  For information on a related
  140.           topic, use the arrow keys to highlight a topic and press
  141.           <Enter>.
  142.  
  143. 6)   A General Help Index is available which contains information on all
  144.      of Magic Mirror's functions:
  145.  
  146.      Use the arrow keys to highlight the "Help Index" topic, which
  147.      appears in the box at the bottom of every Help screen.  If there
  148.      are two lines of topics in the box, the Help Index option displays
  149.      on the second line.
  150.  
  151.                                   NOTE
  152.      The Help Index also includes information on how to use Magic
  153.      Mirror's "MMCONFIG" and "MMLIB" programs.  For information on using
  154.      these programs, use the arrow keys to highlight "Starting MMCONFIG" 
  155.      or "Starting MMLIB".  These two topics are found on the third page
  156.      of the Help Index. 
  157.  
  158. 7)   The Help feature of Magic Mirror requires 12K of RAM.  If you wish
  159.      to use Magic Mirror without on-line Help, type HELP OFF before
  160.      starting Magic Mirror.
  161.  
  162.      For example, to start Magic Mirror with on-line Help disabled, type
  163.      the following commands:
  164.  
  165.           HELP OFF   <Enter>
  166.           MM        <Enter>
  167.  
  168.      Magic Mirror's Help feature is disabled.  It will remain disabled
  169.      until you reactivate it by typing the HELP ON command, and then
  170.      restart the Magic Mirror software.
  171.  
  172.      To start Magic Mirror and reactivate Help, type the following
  173.      commands:
  174.  
  175.           HELP ON   <Enter>
  176.           MM       <Enter>
  177.  
  178. Using Keyboard Macro Programs to Operate Magic Mirror 
  179. -----------------------------------------------------
  180.  
  181. Magic Mirror version 2 can be operated entirely with key sequences sent
  182. from macro programs such as Keyworks, Superkey, Prokey, and others.  The
  183. macro program should be loaded before Magic Mirror.
  184.  
  185. This allows you to use a macro program to invoke Magic Mirror and
  186. capture or transfer data, operating your application program between
  187. each step, as needed.
  188.  
  189. Examples:
  190.  
  191. The following examples of macro use assume that (1) the Magic Mirror Hot
  192. key is defined as the <Alt> key, (2) the Capture key is defined as the
  193. <C> key, and (3) the Image Control key is defined as the <I> key.
  194.  
  195. Information on Hot key definitions and their effect on macro control is
  196. contained later in this file.
  197.  
  198. 1)   The following key sequence may be defined as one macro command and
  199.      used to invoke Magic Mirror, select a pre-defined Capture Pattern,
  200.      and capture data:
  201.  
  202.      <Alt-C>        Invoke Magic Mirror to capture screen data.
  203.      <down arrow>
  204.      <down arrow>
  205.      <down arrow>
  206.      <Enter>        Select the third Capture Pattern in the list.
  207.      <Enter>        Capture the data from the screen and return control
  208.                     to the applications program.
  209.  
  210. 2)   The following key sequence may be defined as one macro command and
  211.      used to invoke Magic Mirror, select a pre-defined Image Style
  212.      Control, and begin transferring data:
  213.  
  214.      <Alt-I>        Invoke Magic Mirror to transfer previously captured
  215.                     data.
  216.      <down arrow>
  217.      <Enter>         Select Choose Image Style Control.
  218.      <down arrow>
  219.      <down arrow>
  220.      <down arrow>
  221.      <down arrow>
  222.      <down arrow>
  223.      <Enter>        Select the fifth Image Style Control record in the
  224.                     list.
  225.      <Enter>        Select Begin Transfer to initiate transfer of data
  226.                     from Magic Mirror's buffer to the current
  227.                     application program.
  228. Limitations:
  229.  
  230. The Magic Mirror activation keys (i.e., <ALT-M>, <CTRL-I>, etc.) cannot
  231. be automatically 'learned' by your macro program while Magic Mirror is
  232. loaded and active, as Magic Mirror does not pass these keys through to
  233. the macro program.  After your macro definition is complete, you must
  234. edit the macro (using the Editing function of your macro program) and
  235. insert the appropriate activation key combination.
  236.  
  237. To pass keystrokes to Magic Mirror from a macro program, the Hot key for
  238. Magic Mirror MUST be defined as one of the following three selections: 
  239. No Hot Key, the <Alt> key, or the <Ctrl> key.  In addition, the four
  240. control keys defined for use with the Hot key (the Menu key, Capture
  241. key, Image Control key and the Transfer key) MUST be within the
  242. boundaries specified in the following chart:
  243.  
  244. +-------------------------------+-------------------------------+
  245. |                               | THE CORRESPONDING CONTROL     |
  246. | IF THE HOT KEY IS DEFINED AS: | KEYS MAY BE DEFINED AS:       |
  247. +-------------------------------+-------------------------------+
  248. | No Hot key                    | any key on the keyboard.      |
  249. +-------------------------------+-------------------------------+
  250. | <Alt>                         | <F1> through <F10>            |
  251. |                               |  (and <F11>, <F12> if the     |
  252. |                               |   application program uses    |
  253. |                               |   enhanced keyboard calls)    |
  254. |                               | <A> - <Z>                     |
  255. |                               | <1> - <0> (top row)           |
  256. |                               | <->       (top row)           |
  257. |                               | <=>       (top row)           |
  258. |                               | <space bar>                   |
  259. +-------------------------------+-------------------------------+
  260. | <Ctrl>                        | <A> - <Z>                     |
  261. +-------------------------------+-------------------------------+
  262.  
  263.  
  264. A Change to Magic Mirror's Default Capture Settings
  265. ---------------------------------------------------
  266.  
  267. When data is captured, Magic Mirror automatically assigns an Image Style
  268. Control (ISC) based upon the settings specified in the MMCONFIG program. 
  269. Formerly, Magic Mirror was supplied configured NEVER to allow an
  270. override to this automatic ISC at the time of the capture.  This has
  271. been changed to ALWAYS allow an override to the automatically assigned
  272. ISC at capture time.  This means that the OPTIONS Menu always displays
  273. when you capture a block of data, unless you change the setting for the
  274. "When to allow ISC Override for CAPTURE" option in the MMCONFIG program.
  275. Using Magic Mirror with Software Carousel
  276. -----------------------------------------
  277.  
  278. The Magic Mirror software has been specifically designed to work with
  279. the Software Carousel, so that you may freely capture and transfer
  280. information from among many programs loaded in Carousel partitions.
  281.  
  282. To accomplish the above, load the Magic Mirror software BEFORE loading
  283. Software Carousel.  This provides the functioning of the Magic Mirror to
  284. all of the Carousel's individual partitions.
  285.  
  286. Alternately, you may load the Magic Mirror software into one of the
  287. Carousel's partitions, AFTER you have started the Software Carousel. 
  288. This only allows Magic Mirror to capture and transfer information from
  289. programs running in the same partition as it is loaded.  This is of
  290. limited use and therefore is not recommended.
  291.  
  292. Using Magic Mirror with DoubleDOS
  293. ---------------------------------
  294.  
  295. If you are using DoubleDOS version 4.2 or higher, Magic Mirror should be
  296. loaded before starting DoubleDOS.  This allows you to access Magic
  297. Mirror from either DoubleDOS memory section.
  298.  
  299. If you are using a version of DoubleDOS prior to 4.2, you must load
  300. Magic Mirror AFTER DoubleDOS in only ONE of the memory sections.  You
  301. will be able to use Magic Mirror only from within that memory section.
  302. If you wish to upgrade your DoubleDOS software, so that you may run
  303. Magic Mirror before DoubleDOS, please call our Sales Department at
  304. 800/272-9900 (603/627-9900 from outside of the United States or within
  305. New Hampshire).
  306.  
  307. Using Magic Mirror with Resident Cubit (CUBITR) 
  308. -----------------------------------------------
  309.  
  310. If you use SoftLogic Solutions' data compression program, CUBIT, in its'
  311. resident mode (CUBITR), you must load Magic Mirror (using the MM
  312. command) BEFORE you load Resident Cubit (using the CUBITR command) for
  313. proper functioning.  The following is a sample AUTOEXEC.BAT file with
  314. Magic Mirror and CUBITR loaded in the correct order:
  315.  
  316. +-----------------+
  317. |  AUTOEXEC.BAT   |
  318. +-----------------+
  319. | DATE            |
  320. | TIME            |
  321. | PATH=C:\;C:\DOS |
  322. | MM              |
  323. | CUBITR          |
  324. +-----------------+